qualia-framework 6.1.0 → 6.2.9

package/tests/bin.test.sh

@@ -454,6 +454,7 @@ if [ "$EXIT" -eq 0 ] \
    && [ -f "$TMP/.claude/bin/state.js" ] \
    && [ -f "$TMP/.claude/bin/qualia-ui.js" ] \
    && [ -f "$TMP/.claude/bin/statusline.js" ] \
+   && [ -f "$TMP/.claude/bin/project-snapshot.js" ] \
    && [ -f "$TMP/.claude/.qualia-config.json" ]; then
   pass "QS-FAWZI-01 → installs skills, hooks, bin/, config"
 else
@@ -477,12 +478,13 @@ else
   fail_case "CLAUDE.md role substitution"
 fi
 
-# 31. All 12 hooks installed (block-env-edit removed in v3.2.0;
+# 31. All 11 hooks installed (block-env-edit removed in v3.2.0;
 # git-guardrails + stop-session-log added in v4.2.0;
-# vercel-account-guard + env-empty-guard + supabase-destructive-guard added in v5.0.0)
+# vercel-account-guard + env-empty-guard + supabase-destructive-guard added in v5.0.0;
+# pre-compact removed in v6.2.0)
 HOOK_COUNT=$(ls "$TMP/.claude/hooks/"*.js 2>/dev/null | wc -l)
-if [ "$HOOK_COUNT" -eq 12 ]; then
-  pass "12 hooks installed in hooks/"
+if [ "$HOOK_COUNT" -eq 11 ]; then
+  pass "11 hooks installed in hooks/"
 else
   fail_case "hook count" "got $HOOK_COUNT"
 fi
@@ -498,22 +500,23 @@ else
   fail_case "settings.json contents"
 fi
 
-# 33. settings.json contains all 12 hooks wired correctly
+# 33. settings.json contains all 11 hooks wired correctly
+#     pre-compact.js was removed in v6.2.0 — verify it's NOT in settings.json.
 if grep -q 'branch-guard.js' "$TMP/.claude/settings.json" \
    && grep -q 'migration-guard.js' "$TMP/.claude/settings.json" \
    && grep -q 'pre-push.js' "$TMP/.claude/settings.json" \
    && grep -q 'pre-deploy-gate.js' "$TMP/.claude/settings.json" \
    && grep -q 'auto-update.js' "$TMP/.claude/settings.json" \
    && grep -q 'session-start.js' "$TMP/.claude/settings.json" \
-   && grep -q 'pre-compact.js' "$TMP/.claude/settings.json" \
    && grep -q 'git-guardrails.js' "$TMP/.claude/settings.json" \
    && grep -q 'stop-session-log.js' "$TMP/.claude/settings.json" \
    && grep -q 'vercel-account-guard.js' "$TMP/.claude/settings.json" \
    && grep -q 'env-empty-guard.js' "$TMP/.claude/settings.json" \
-   && grep -q 'supabase-destructive-guard.js' "$TMP/.claude/settings.json"; then
-  pass "settings.json has all 12 hooks wired"
+   && grep -q 'supabase-destructive-guard.js' "$TMP/.claude/settings.json" \
+   && ! grep -q 'pre-compact.js' "$TMP/.claude/settings.json"; then
+  pass "settings.json has all 11 hooks wired (no pre-compact)"
 else
-  fail_case "settings.json missing hooks"
+  fail_case "settings.json hooks misconfigured (check for stale pre-compact entry)"
 fi
 
 # 34. Lowercase code works (resolveTeamCode normalizes)
@@ -1340,20 +1343,49 @@ else
   fail_case "target=1 Claude-only" "exit=$EXIT codex_exists=$(test -d "$TMP/.codex" && echo yes || echo no)"
 fi
 
-# 119. Target=2 (Codex only) writes ~/.codex/AGENTS.md, skips ~/.claude/
+# 119. Target=2 (Codex only) writes native Codex runtime files, skips ~/.claude/
 TMP=$(mktmp)
 printf 'QS-FAWZI-01\n2\n' | HOME="$TMP" $NODE "$INSTALL_JS" > "$TMP/log.txt" 2>&1
 EXIT=$?
 if [ "$EXIT" -eq 0 ] \
    && [ -f "$TMP/.codex/AGENTS.md" ] \
+   && [ -f "$TMP/.codex/.qualia-config.json" ] \
+   && [ -f "$TMP/.codex/config.toml" ] \
+   && [ -f "$TMP/.codex/hooks.json" ] \
+   && [ -f "$TMP/.codex/bin/statusline.js" ] \
+   && [ -f "$TMP/.codex/bin/project-snapshot.js" ] \
+   && [ -f "$TMP/.codex/agents/planner.toml" ] \
+   && [ -f "$TMP/.codex/skills/qualia-new/SKILL.md" ] \
+   && [ -f "$TMP/.codex/qualia-references/questioning.md" ] \
    && [ ! -d "$TMP/.claude" ] \
    && grep -q "Role: OWNER" "$TMP/.codex/AGENTS.md" \
-   && ! grep -q "{{ROLE}}" "$TMP/.codex/AGENTS.md"; then
-  pass "target=2 → ~/.codex/AGENTS.md with Role: OWNER, ~/.claude/ skipped"
+   && ! grep -q "{{ROLE}}" "$TMP/.codex/AGENTS.md" \
+   && grep -q "pre-deploy-gate.js" "$TMP/.codex/hooks.json" \
+   && grep -q "developer_instructions" "$TMP/.codex/agents/planner.toml" \
+   && ! grep -R "\.claude/bin" "$TMP/.codex/skills" >/dev/null 2>&1; then
+  pass "target=2 → Codex runtime files with Role: OWNER, ~/.claude/ skipped"
 else
   fail_case "target=2 Codex-only" "exit=$EXIT claude_exists=$(test -d "$TMP/.claude" && echo yes || echo no)"
 fi
 
+EXIT=0; HOME="$TMP" $NODE "$CLI_JS" doctor > "$TMP/doctor.log" 2>&1 || EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && grep -q "Codex hooks.json PreToolUse" "$TMP/doctor.log" \
+   && grep -q "All checks passed" "$TMP/doctor.log"; then
+  pass "doctor passes for Codex-only install"
+else
+  fail_case "doctor Codex-only" "exit=$EXIT log=$(tail -20 "$TMP/doctor.log" 2>/dev/null)"
+fi
+
+EXIT=0; HOME="$TMP" $NODE "$CLI_JS" migrate > "$TMP/migrate.log" 2>&1 || EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && grep -q "Codex install uses" "$TMP/migrate.log" \
+   && grep -q "hooks.json" "$TMP/migrate.log"; then
+  pass "migrate is Codex-aware on Codex-only install"
+else
+  fail_case "migrate Codex-only" "exit=$EXIT log=$(cat "$TMP/migrate.log" 2>/dev/null)"
+fi
+
 # 120. Target=3 (Both) populates both directories with the right artifacts
 TMP=$(mktmp)
 printf 'QS-FAWZI-01\n3\n' | HOME="$TMP" $NODE "$INSTALL_JS" > "$TMP/log.txt" 2>&1
@@ -1361,8 +1393,13 @@ EXIT=$?
 if [ "$EXIT" -eq 0 ] \
    && [ -f "$TMP/.claude/.qualia-config.json" ] \
    && [ -f "$TMP/.codex/AGENTS.md" ] \
+   && [ -f "$TMP/.codex/config.toml" ] \
+   && [ -f "$TMP/.codex/hooks.json" ] \
+   && [ -f "$TMP/.codex/bin/knowledge.js" ] \
+   && [ -f "$TMP/.codex/agents/builder.toml" ] \
+   && [ -f "$TMP/.codex/qualia-references/questioning.md" ] \
    && grep -q "Role: OWNER" "$TMP/.codex/AGENTS.md"; then
-  pass "target=3 → both ~/.claude/ and ~/.codex/AGENTS.md populated"
+  pass "target=3 → both ~/.claude/ and Codex runtime populated"
 else
   fail_case "target=3 Both" "exit=$EXIT"
 fi
@@ -1410,6 +1447,80 @@ else
   fail_case "Codex backup over-zealous" "bak_count=$BAK_COUNT"
 fi
 
+# 123b. Codex hooks.json merge preserves non-Qualia hook commands.
+TMP=$(mktmp)
+mkdir -p "$TMP/.codex"
+cat > "$TMP/.codex/hooks.json" <<'JSON'
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          { "type": "command", "command": "node /tmp/custom-session-hook.js", "timeout": 1 }
+        ]
+      }
+    ]
+  }
+}
+JSON
+printf 'QS-FAWZI-01\n2\n' | HOME="$TMP" $NODE "$INSTALL_JS" > "$TMP/log.txt" 2>&1
+if grep -q "custom-session-hook.js" "$TMP/.codex/hooks.json" \
+   && grep -q "session-start.js" "$TMP/.codex/hooks.json"; then
+  pass "Codex hooks.json merge preserves non-Qualia hooks"
+else
+  fail_case "Codex hooks.json merge dropped custom hooks"
+fi
+
+# 123c. Codex uninstall removes Qualia runtime files while preserving user-owned
+# AGENTS.md, config.toml, knowledge, and non-Qualia hooks.json entries.
+TMP=$(mktmp)
+mkdir -p "$TMP/.codex"
+cat > "$TMP/.codex/hooks.json" <<'JSON'
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          { "type": "command", "command": "node /tmp/custom-session-hook.js", "timeout": 1 }
+        ]
+      }
+    ]
+  }
+}
+JSON
+printf 'QS-FAWZI-01\n2\n' | HOME="$TMP" $NODE "$INSTALL_JS" > "$TMP/log.txt" 2>&1
+EXIT=0; HOME="$TMP" $NODE "$CLI_JS" uninstall --yes > "$TMP/uninstall.log" 2>&1 || EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && [ -f "$TMP/.codex/AGENTS.md" ] \
+   && [ -f "$TMP/.codex/config.toml" ] \
+   && [ -d "$TMP/.codex/knowledge" ] \
+   && [ ! -f "$TMP/.codex/.qualia-config.json" ] \
+   && [ ! -f "$TMP/.codex/bin/statusline.js" ] \
+   && [ ! -f "$TMP/.codex/hooks/session-start.js" ] \
+   && [ ! -f "$TMP/.codex/agents/planner.toml" ] \
+   && [ ! -d "$TMP/.codex/skills/qualia-new" ] \
+   && grep -q "custom-session-hook.js" "$TMP/.codex/hooks.json" \
+   && ! grep -q "session-start.js" "$TMP/.codex/hooks.json"; then
+  pass "Codex uninstall removes Qualia runtime and preserves user-owned files"
+else
+  fail_case "Codex uninstall cleanup" "exit=$EXIT log=$(tail -20 "$TMP/uninstall.log" 2>/dev/null)"
+fi
+
+# 123d. Team management writes to Codex-only installs without creating ~/.claude.
+TMP=$(mktmp)
+printf 'QS-FAWZI-01\n2\n' | HOME="$TMP" $NODE "$INSTALL_JS" > "$TMP/log.txt" 2>&1
+EXIT=0; HOME="$TMP" $NODE "$CLI_JS" team add --code QS-TEST-99 --name "Test User" > "$TMP/team.log" 2>&1 || EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && [ -f "$TMP/.codex/.qualia-team.json" ] \
+   && [ ! -d "$TMP/.claude" ] \
+   && grep -q "QS-TEST-99" "$TMP/.codex/.qualia-team.json"; then
+  pass "team add writes to Codex-only install home"
+else
+  fail_case "Codex team management" "exit=$EXIT log=$(cat "$TMP/team.log" 2>/dev/null)"
+fi
+
 # 124. Non-TTY install log is free of cursor-control / line-clear escape
 # sequences (\r, \x1b[?25l/h hide-cursor, \x1b[2K clear-line). Spinner +
 # overwrite primitives must degrade cleanly when output is piped.
@@ -1643,6 +1754,293 @@ else
   fail_case "CONTEXT template missing framework-task vs ERP-workflow distinction"
 fi
 
+# 147. report-payload omits slug-like ERP UUID fields before POST
+TMP_PAYLOAD=$(mktmp)
+OUT=$(FRAMEWORK_DIR="$FRAMEWORK_DIR" TMP_PAYLOAD="$TMP_PAYLOAD" $NODE <<'NODE' 2>&1
+const assert = require("assert/strict");
+const fs = require("fs");
+const path = require("path");
+const { buildPayload } = require(path.join(process.env.FRAMEWORK_DIR, "bin", "report-payload.js"));
+
+const root = process.env.TMP_PAYLOAD;
+const cwd = path.join(root, "project");
+const home = path.join(root, "home");
+fs.mkdirSync(path.join(cwd, ".planning"), { recursive: true });
+fs.mkdirSync(path.join(home, ".claude"), { recursive: true });
+fs.writeFileSync(path.join(home, ".claude", ".qualia-config.json"), JSON.stringify({ version: "test-version" }));
+fs.writeFileSync(path.join(cwd, ".planning", "tracking.json"), JSON.stringify({
+  project: "acme-portal",
+  project_id: "qs-acme-portal",
+  team_id: "qualia-solutions",
+  git_remote: "github.com/QualiasolutionsCY/acme-portal",
+  erp_project_id: "project-slug",
+  client_id: "acme",
+  workspace_id: "qualia-solutions",
+  phase: 2,
+  phase_name: "ERP reporting",
+  total_phases: 4,
+  status: "built",
+  gap_cycles: { "2": 1 },
+  session_started_at: "2026-05-21T00:00:00Z"
+}));
+const reportFile = path.join(root, "report.md");
+fs.writeFileSync(reportFile, "Shift notes");
+
+const payload = buildPayload({
+  cwd,
+  home,
+  reportFile,
+  env: {
+    CLIENT_REPORT_ID: "QS-REPORT-01",
+    SUBMITTED_BY: "Fawzi Goussous",
+    SUBMITTED_AT: "2026-05-21T01:30:00Z",
+  },
+});
+assert.equal(payload.project_id, "qs-acme-portal");
+assert.equal(payload.team_id, "qualia-solutions");
+assert.equal(payload.framework_version, "test-version");
+assert.equal(payload.gap_cycles, 1);
+assert.equal(payload.session_duration_minutes, 90);
+assert.equal(payload.notes, "Shift notes");
+assert.equal(Object.prototype.hasOwnProperty.call(payload, "erp_project_id"), false);
+assert.equal(Object.prototype.hasOwnProperty.call(payload, "client_id"), false);
+assert.equal(Object.prototype.hasOwnProperty.call(payload, "workspace_id"), false);
+NODE
+)
+EXIT=$?
+if [ "$EXIT" -eq 0 ]; then
+  pass "report-payload omits slug-like ERP UUID fields"
+else
+  fail_case "report-payload slug guard failed" "$OUT"
+fi
+
+# 148. report-payload sends canonical ERP UUID fields when present
+TMP_PAYLOAD=$(mktmp)
+OUT=$(FRAMEWORK_DIR="$FRAMEWORK_DIR" TMP_PAYLOAD="$TMP_PAYLOAD" $NODE <<'NODE' 2>&1
+const assert = require("assert/strict");
+const fs = require("fs");
+const path = require("path");
+const { buildPayload } = require(path.join(process.env.FRAMEWORK_DIR, "bin", "report-payload.js"));
+
+const root = process.env.TMP_PAYLOAD;
+const cwd = path.join(root, "project");
+const home = path.join(root, "home");
+fs.mkdirSync(path.join(cwd, ".planning"), { recursive: true });
+fs.mkdirSync(path.join(home, ".claude"), { recursive: true });
+fs.writeFileSync(path.join(home, ".claude", ".qualia-config.json"), JSON.stringify({ version: "test-version" }));
+fs.writeFileSync(path.join(cwd, ".planning", "tracking.json"), JSON.stringify({
+  project: "acme-portal",
+  project_id: "qs-acme-portal",
+  team_id: "qualia-solutions",
+  erp_project_id: "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef",
+  client_id: "5f5a8d8e-8c58-4c30-9b76-13a08f0d0d8a",
+  workspace_id: "2af02a2d-6f1f-4d43-a6cb-6a1e7e09ac43",
+  phase: 1,
+  status: "verified"
+}));
+const payload = buildPayload({
+  cwd,
+  home,
+  reportFile: path.join(root, "missing-report.md"),
+  env: {
+    CLIENT_REPORT_ID: "QS-REPORT-02",
+    SUBMITTED_BY: "Fawzi Goussous",
+    SUBMITTED_AT: "2026-05-21T01:30:00Z",
+  },
+});
+assert.equal(payload.erp_project_id, "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef");
+assert.equal(payload.client_id, "5f5a8d8e-8c58-4c30-9b76-13a08f0d0d8a");
+assert.equal(payload.workspace_id, "2af02a2d-6f1f-4d43-a6cb-6a1e7e09ac43");
+assert.equal(payload.client_report_id, "QS-REPORT-02");
+assert.equal(payload.notes, "");
+NODE
+)
+EXIT=$?
+if [ "$EXIT" -eq 0 ]; then
+  pass "report-payload sends canonical ERP UUID fields"
+else
+  fail_case "report-payload UUID pass-through failed" "$OUT"
+fi
+
+# 149. Installer ships the payload builder used by /qualia-report
+TMP_INSTALL=$(mktmp)
+echo "QS-FAWZI-01" | HOME="$TMP_INSTALL" $NODE "$INSTALL_JS" > "$TMP_INSTALL/out.log" 2>&1
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && [ -f "$TMP_INSTALL/.claude/bin/report-payload.js" ] \
+   && [ -f "$TMP_INSTALL/.claude/bin/project-snapshot.js" ] \
+   && grep -q "report-payload.js" "$TMP_INSTALL/.claude/skills/qualia-report/SKILL.md"; then
+  pass "installer ships ERP report/snapshot helpers"
+else
+  fail_case "installer missing ERP report/snapshot helpers" "exit=$EXIT"
+fi
+
+# 150. project-snapshot exports a 0-to-100 admin progress object
+TMP_SNAPSHOT=$(mktmp)
+OUT=$(FRAMEWORK_DIR="$FRAMEWORK_DIR" TMP_SNAPSHOT="$TMP_SNAPSHOT" $NODE <<'NODE' 2>&1
+const assert = require("assert/strict");
+const fs = require("fs");
+const path = require("path");
+const { buildSnapshot, writeSnapshot } = require(path.join(process.env.FRAMEWORK_DIR, "bin", "project-snapshot.js"));
+
+const root = process.env.TMP_SNAPSHOT;
+const cwd = path.join(root, "project");
+const home = path.join(root, "home");
+fs.mkdirSync(path.join(cwd, ".planning"), { recursive: true });
+fs.mkdirSync(path.join(home, ".claude"), { recursive: true });
+fs.writeFileSync(path.join(home, ".claude", ".qualia-config.json"), JSON.stringify({ version: "test-version" }));
+fs.writeFileSync(path.join(cwd, ".planning", "JOURNEY.md"), [
+  "# Journey",
+  "## Milestone 1 · Foundation",
+  "## Milestone 2 · Product",
+  "## Milestone 3 · Handoff",
+].join("\n"));
+fs.writeFileSync(path.join(cwd, ".planning", "tracking.json"), JSON.stringify({
+  project: "acme-portal",
+  project_id: "qs-acme-portal",
+  erp_project_id: "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef",
+  client_id: "5f5a8d8e-8c58-4c30-9b76-13a08f0d0d8a",
+  team_id: "qualia-solutions",
+  git_remote: "github.com/QualiasolutionsCY/acme-portal",
+  client: "Acme",
+  milestone: 2,
+  milestone_name: "Product",
+  phase: 2,
+  phase_name: "Dashboard",
+  total_phases: 4,
+  status: "built",
+  tasks_done: 3,
+  tasks_total: 5,
+  verification: "pending",
+  gap_cycles: { "2": 1 },
+  build_count: 4,
+  deploy_count: 1,
+  milestones: [{ num: 1, name: "Foundation", closed_at: "2026-05-01T00:00:00Z" }],
+  lifetime: {
+    tasks_completed: 12,
+    phases_completed: 4,
+    milestones_completed: 1,
+    total_phases: 4,
+    last_closed_milestone: 1
+  }
+}));
+
+const snapshot = buildSnapshot({ cwd, home, now: "2026-05-21T00:00:00.000Z" });
+assert.equal(snapshot.snapshot_version, 1);
+assert.equal(snapshot.framework_version, "test-version");
+assert.equal(snapshot.identifiers.project_id, "qs-acme-portal");
+assert.equal(snapshot.identifiers.erp_project_id, "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef");
+assert.equal(snapshot.project.progress_percent, 42);
+assert.equal(snapshot.current.gap_cycles, 1);
+assert.equal(snapshot.journey.total_milestones, 3);
+assert.deepEqual(snapshot.journey.milestones.map((m) => m.status), ["closed", "active", "pending"]);
+assert.equal(snapshot.lifetime.tasks_completed, 12);
+
+const file = writeSnapshot(snapshot, { cwd });
+assert.ok(file.endsWith(".planning/snapshots/project-snapshot-2026-05-21T00-00-00-000Z.json"));
+assert.equal(JSON.parse(fs.readFileSync(file, "utf8")).project.progress_percent, 42);
+NODE
+)
+EXIT=$?
+if [ "$EXIT" -eq 0 ]; then
+  pass "project-snapshot exports ERP/admin progress object"
+else
+  fail_case "project-snapshot progress export failed" "$OUT"
+fi
+
+# 151. project-snapshot uploads the progress object to ERP intake
+TMP_SNAPSHOT_UPLOAD=$(mktmp)
+OUT=$(FRAMEWORK_DIR="$FRAMEWORK_DIR" TMP_SNAPSHOT_UPLOAD="$TMP_SNAPSHOT_UPLOAD" $NODE <<'NODE' 2>&1
+const assert = require("assert/strict");
+const { EventEmitter } = require("events");
+const fs = require("fs");
+const http = require("http");
+const path = require("path");
+const { buildSnapshot, uploadSnapshot } = require(path.join(process.env.FRAMEWORK_DIR, "bin", "project-snapshot.js"));
+
+const root = process.env.TMP_SNAPSHOT_UPLOAD;
+const cwd = path.join(root, "project");
+const home = path.join(root, "home");
+fs.mkdirSync(path.join(cwd, ".planning"), { recursive: true });
+fs.mkdirSync(path.join(home, ".claude"), { recursive: true });
+fs.writeFileSync(path.join(home, ".claude", ".qualia-config.json"), JSON.stringify({ version: "test-version" }));
+fs.writeFileSync(path.join(cwd, ".planning", "JOURNEY.md"), [
+  "# Journey",
+  "## Milestone 1 · Foundation",
+  "## Milestone 2 · Product",
+  "## Milestone 3 · Handoff",
+].join("\n"));
+fs.writeFileSync(path.join(cwd, ".planning", "tracking.json"), JSON.stringify({
+  project: "acme-portal",
+  project_id: "qs-acme-portal",
+  erp_project_id: "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef",
+  client_id: "5f5a8d8e-8c58-4c30-9b76-13a08f0d0d8a",
+  milestone: 2,
+  phase: 2,
+  total_phases: 4,
+  milestones: [{ num: 1, name: "Foundation" }]
+}));
+
+let seen = null;
+const originalRequest = http.request;
+http.request = (endpoint, options, callback) => {
+  let raw = "";
+  const req = new EventEmitter();
+  req.write = (chunk) => { raw += chunk; };
+  req.end = () => {
+    seen = {
+      method: options.method,
+      url: endpoint.pathname,
+      authorization: options.headers.Authorization,
+      body: JSON.parse(raw)
+    };
+    const res = new EventEmitter();
+    res.statusCode = 200;
+    res.setEncoding = () => {};
+    callback(res);
+    process.nextTick(() => {
+      res.emit("data", JSON.stringify({
+        ok: true,
+        project_id: "erp-project",
+        progress_percent: seen.body.project.progress_percent
+      }));
+      res.emit("end");
+    });
+  };
+  req.destroy = (error) => req.emit("error", error);
+  return req;
+};
+
+(async () => {
+  try {
+    const snapshot = buildSnapshot({ cwd, home, now: "2026-05-21T00:00:00.000Z" });
+    const response = await uploadSnapshot(snapshot, {
+      erp: { enabled: true, url: "http://erp.local", key: "qlt_test" }
+    });
+    assert.equal(response.status, 200);
+    assert.equal(response.body.ok, true);
+    assert.equal(seen.method, "POST");
+    assert.equal(seen.url, "/api/v1/project-snapshots");
+    assert.equal(seen.authorization, "Bearer qlt_test");
+    assert.equal(seen.body.snapshot_version, 1);
+    assert.equal(seen.body.project.progress_percent, 42);
+    assert.equal(seen.body.identifiers.erp_project_id, "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef");
+  } finally {
+    http.request = originalRequest;
+  }
+})().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
+NODE
+)
+EXIT=$?
+if [ "$EXIT" -eq 0 ]; then
+  pass "project-snapshot uploads ERP/admin progress object"
+else
+  fail_case "project-snapshot upload failed" "$OUT"
+fi
+
 echo ""
 echo "=== Results: $PASS passed, $FAIL failed ==="
 [ "$FAIL" -eq 0 ] && exit 0 || exit 1

package/tests/hooks.test.sh

@@ -340,14 +340,7 @@ EOF
 assert_exit "exits 0 with STATE.md" 0 $?
 rm -rf "$TMP"
 
-# --- pre-compact.js ---
-echo ""
-echo "pre-compact:"
-
-TMP=$(mktemp -d)
-(cd "$TMP" && $NODE "$HOOKS_DIR/pre-compact.js" >/dev/null 2>&1)
-assert_exit "exits 0 with no STATE.md" 0 $?
-rm -rf "$TMP"
+# pre-compact.js removed in v6.2.0 — state.js journal provides crash safety.
 
 # --- auto-update.js ---
 echo ""

package/tests/install-smoke.test.sh

@@ -0,0 +1,137 @@
+#!/usr/bin/env bash
+# install-smoke.test.sh — package-level install smoke test.
+# Builds the npm tarball, extracts it, and runs the packaged installer into an
+# isolated HOME for the Claude + Codex target. This catches files that pass
+# source-tree tests but are missing from the published package.
+
+set -u
+
+PASS=0
+FAIL=0
+
+pass() {
+  echo "  ✓ $1"
+  PASS=$((PASS + 1))
+}
+
+fail_case() {
+  echo "  ✗ $1"
+  [ -n "${2:-}" ] && echo "    $2"
+  FAIL=$((FAIL + 1))
+}
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+NODE="${NODE:-node}"
+TMP="$(mktemp -d 2>/dev/null || mktemp -d -t qualia-install-smoke)"
+HOME_DIR="$TMP/home"
+PACK_DIR="$TMP/pack"
+CACHE_DIR="$TMP/npm-cache"
+LOGS_DIR="$TMP/npm-logs"
+USERCONFIG="$TMP/npmrc"
+mkdir -p "$HOME_DIR" "$PACK_DIR" "$CACHE_DIR" "$LOGS_DIR"
+: >"$USERCONFIG"
+
+cleanup() {
+  rm -rf "$TMP"
+}
+trap cleanup EXIT
+
+echo "install-smoke.test.sh — packaged Claude + Codex install"
+echo ""
+
+PACK_OUT="$TMP/npm-pack.out"
+PACK_ERR="$TMP/npm-pack.err"
+(cd "$ROOT" && env \
+  NPM_CONFIG_CACHE="$CACHE_DIR" \
+  NPM_CONFIG_LOGS_DIR="$LOGS_DIR" \
+  NPM_CONFIG_USERCONFIG="$USERCONFIG" \
+  npm pack --silent --pack-destination "$PACK_DIR" >"$PACK_OUT" 2>"$PACK_ERR")
+PACK_EXIT=$?
+TARBALL=$(tail -1 "$PACK_OUT" 2>/dev/null | tr -d '[:space:]')
+TARBALL_PATH="$PACK_DIR/$TARBALL"
+
+if [ -f "$TARBALL_PATH" ]; then
+  pass "npm pack produced $TARBALL"
+else
+  fail_case "npm pack tarball missing" "exit=$PACK_EXIT expected=$TARBALL_PATH stderr=$(cat "$PACK_ERR" 2>/dev/null)"
+  echo ""
+  echo "Results: $PASS passed, $FAIL failed"
+  exit 1
+fi
+
+tar -xzf "$TARBALL_PATH" -C "$TMP" 2>"$TMP/tar.err"
+if [ -f "$TMP/package/bin/install.js" ] \
+  && [ -f "$TMP/package/bin/report-payload.js" ] \
+  && [ -f "$TMP/package/bin/project-snapshot.js" ] \
+  && [ -f "$TMP/package/AGENTS.md" ] \
+  && [ -f "$TMP/package/CLAUDE.md" ]; then
+  pass "tarball contains installer + Claude/Codex instruction roots"
+else
+  fail_case "tarball missing install surfaces" "$(cat "$TMP/tar.err" 2>/dev/null)"
+fi
+
+printf 'QS-FAWZI-01\n3\n' | HOME="$HOME_DIR" "$NODE" "$TMP/package/bin/install.js" >"$TMP/install.log" 2>&1
+EXIT=$?
+if [ "$EXIT" -eq 0 ]; then
+  pass "packaged installer exits 0 for target=Both"
+else
+  fail_case "packaged installer failed" "exit=$EXIT log=$(tail -20 "$TMP/install.log" 2>/dev/null)"
+fi
+
+if [ -f "$HOME_DIR/.claude/CLAUDE.md" ] \
+  && grep -q "Role: OWNER" "$HOME_DIR/.claude/CLAUDE.md" \
+  && ! grep -q "{{ROLE}}" "$HOME_DIR/.claude/CLAUDE.md"; then
+  pass "Claude CLAUDE.md installed with OWNER role"
+else
+  fail_case "Claude CLAUDE.md role substitution failed"
+fi
+
+if [ -f "$HOME_DIR/.codex/AGENTS.md" ] \
+  && [ -f "$HOME_DIR/.codex/hooks.json" ] \
+  && [ -f "$HOME_DIR/.codex/config.toml" ] \
+  && [ -f "$HOME_DIR/.codex/bin/statusline.js" ] \
+  && [ -f "$HOME_DIR/.codex/bin/project-snapshot.js" ] \
+  && [ -f "$HOME_DIR/.codex/agents/planner.toml" ] \
+  && [ -f "$HOME_DIR/.codex/skills/qualia-new/SKILL.md" ] \
+  && [ -f "$HOME_DIR/.codex/qualia-references/questioning.md" ] \
+  && grep -q "Role: OWNER" "$HOME_DIR/.codex/AGENTS.md" \
+  && ! grep -q "{{ROLE}}" "$HOME_DIR/.codex/AGENTS.md" \
+  && grep -q "pre-deploy-gate.js" "$HOME_DIR/.codex/hooks.json" \
+  && ! grep -R "\.claude/bin" "$HOME_DIR/.codex/skills" >/dev/null 2>&1; then
+  pass "Codex runtime installed with OWNER role"
+else
+  fail_case "Codex runtime install failed"
+fi
+
+if [ -d "$HOME_DIR/.claude/hooks" ] \
+  && [ "$(find "$HOME_DIR/.claude/hooks" -maxdepth 1 -name '*.js' | wc -l | tr -d ' ')" = "11" ] \
+  && [ ! -f "$HOME_DIR/.claude/hooks/pre-compact.js" ]; then
+  pass "packaged install has 11 hooks and no pre-compact"
+else
+  fail_case "packaged hook set mismatch"
+fi
+
+if [ -f "$HOME_DIR/.claude/bin/report-payload.js" ] \
+  && [ -f "$HOME_DIR/.claude/bin/project-snapshot.js" ] \
+  && grep -q "report-payload.js" "$HOME_DIR/.claude/skills/qualia-report/SKILL.md"; then
+  pass "packaged install includes ERP report/snapshot helpers"
+else
+  fail_case "packaged install missing ERP report/snapshot helpers"
+fi
+
+PKG_VERSION=$("$NODE" -e "console.log(require(process.argv[1]).version)" "$TMP/package/package.json")
+CONFIG_VERSION=$("$NODE" -e "console.log(require(process.argv[1]).version)" "$HOME_DIR/.claude/.qualia-config.json" 2>/dev/null || echo "")
+if [ "$PKG_VERSION" = "$CONFIG_VERSION" ]; then
+  pass "installed config version matches package ($PKG_VERSION)"
+else
+  fail_case "installed config version mismatch" "package=$PKG_VERSION config=$CONFIG_VERSION"
+fi
+
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+
+if [ "$FAIL" -gt 0 ]; then
+  exit 1
+fi
+
+exit 0