feat: preflight - prerequisites checked and tool paths recorded before wikitool runs; launcher refuses without it (#151, POSIX half)

Files changed:
- .claude/settings.json
- .gitea/workflows/ci.yml
- .gitea/workflows/nightly.yml
- .gitea/workflows/release.yml
- .gitea/workflows/tracker-live.yml
- .github/hooks/wiki-trace.json
- .gitignore
- .vibe/hooks.toml
- AGENTS.md
- CHANGES.md
- EVALS.md
- INSTALL.md
- README.md
- VERSION
- instructions/bootstrap.md
- instructions/preflight.md
- instructions/setup-instance.md
- instructions/upgrade-instance.md
- tools/CONTRACT.md
- tools/README.md
- tools/chemenu/cli.py
- tools/chemenu/commands/dist_cmd.py
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/commands/doctor.py
- tools/chemenu/commands/git_publish.py
- tools/chemenu/commands/migrate_cmd.py
- tools/chemenu/config.py
- tools/chemenu/corpus_cache.py
- tools/chemenu/prerequisites.py
- tools/chemenu/search/ripgrep.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_dist_upgrade.py
- tools/chemenu/tests/test_doctor.py
- tools/chemenu/tests/test_preflight.py
- tools/chemenu/toolpaths.py
- tools/preflight.sh
- tools/prerequisites.txt
- tools/run_wikitool.py
- tools/trace-hook
- tools/wikitool

.github/hooks/wiki-trace.json

@@ -4,8 +4,8 @@
     "sessionStart": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event session.start 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event session.start 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event session.start 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event session.start 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -13,8 +13,8 @@
     "sessionEnd": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event session.end 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event session.end 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event session.end 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event session.end 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -22,8 +22,8 @@
     "userPromptSubmitted": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event prompt.submitted 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event prompt.submitted 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event prompt.submitted 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event prompt.submitted 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -31,8 +31,8 @@
     "preToolUse": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event tool.pre 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event tool.pre 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event tool.pre 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event tool.pre 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -40,8 +40,8 @@
     "postToolUse": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event tool.post 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event tool.post 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event tool.post 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event tool.post 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -49,8 +49,8 @@
     "postToolUseFailure": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event tool.error 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event tool.error 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event tool.error 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event tool.error 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -58,8 +58,8 @@
     "errorOccurred": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event session.error 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event session.error 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event session.error 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event session.error 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -67,8 +67,8 @@
     "subagentStart": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event subagent.start 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event subagent.start 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event subagent.start 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event subagent.start 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -76,8 +76,8 @@
     "subagentStop": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event subagent.stop 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event subagent.stop 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event subagent.stop 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event subagent.stop 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -85,8 +85,8 @@
     "preCompact": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event compaction 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event compaction 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event compaction 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event compaction 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }
@@ -94,8 +94,8 @@
     "agentStop": [
       {
         "type": "command",
-        "bash": "./tools/trace_ingest.py --source copilot-cli --event turn.end 2>/dev/null || true",
-        "powershell": "python tools/trace_ingest.py --source copilot-cli --event turn.end 2>$null; exit 0",
+        "bash": "./tools/trace-hook --source copilot-cli --event turn.end 2>/dev/null || true",
+        "powershell": ".\\tools\\.venv\\Scripts\\python.exe tools\\trace_ingest.py --source copilot-cli --event turn.end 2>$null; exit 0",
         "cwd": ".",
         "timeoutSec": 5
       }