qualia-framework 6.14.0 → 7.0.0

package/tests/last-report.test.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+# last-report.test.sh — bin/last-report.js (surface the latest session report)
+# Run: bash tests/last-report.test.sh
+
+PASS=0
+FAIL=0
+BIN_DIR="$(cd "$(dirname "$0")/../bin" && pwd)"
+NODE="${NODE:-node}"
+LR="$BIN_DIR/last-report.js"
+
+assert_exit() {
+  local name="$1" expected="$2" actual="$3"
+  if [ "$expected" = "$actual" ]; then echo "  ✓ $name"; PASS=$((PASS+1));
+  else echo "  ✗ $name (expected exit $expected, got $actual)"; FAIL=$((FAIL+1)); fi
+}
+assert_contains() {
+  local name="$1" hay="$2" needle="$3"
+  if echo "$hay" | grep -qF "$needle"; then echo "  ✓ $name"; PASS=$((PASS+1));
+  else echo "  ✗ $name (missing '$needle' in: $hay)"; FAIL=$((FAIL+1)); fi
+}
+assert_not_contains() {
+  local name="$1" hay="$2" needle="$3"
+  if echo "$hay" | grep -qF "$needle"; then echo "  ✗ $name (unexpected '$needle' in: $hay)"; FAIL=$((FAIL+1));
+  else echo "  ✓ $name"; PASS=$((PASS+1)); fi
+}
+
+# Write a well-formed report at $1/.planning/reports/report-$2.md with summary $3, next $4
+write_report() {
+  local root="$1" datepart="$2" summary="$3" next="$4" date="$5"
+  mkdir -p "$root/.planning/reports"
+  cat > "$root/.planning/reports/report-$datepart.md" <<EOF
+# Session Report — $date
+
+**Project:** demo
+**Employee:** T
+**Branch:** main
+**Date:** $date
+
+## What Was Done
+- $summary
+
+## Blockers
+None.
+
+## Next Steps
+1. $next
+
+## Commits (1)
+- abc123 seed
+EOF
+}
+
+echo "last-report.test.sh — bin/last-report.js"
+echo ""
+
+$NODE -c "$LR" 2>/dev/null && { echo "  ✓ syntax valid"; PASS=$((PASS+1)); } || { echo "  ✗ syntax invalid"; FAIL=$((FAIL+1)); }
+
+# --- no reports dir → exit 1, found:false ---
+TMP=$(mktemp -d)
+(cd "$TMP" && $NODE "$LR" >/dev/null 2>&1)
+assert_exit "no reports dir → exit 1" 1 $?
+OUT=$(cd "$TMP" && $NODE "$LR" --json 2>&1)
+assert_contains "json found:false when none" "$OUT" '"found": false'
+OUT=$(cd "$TMP" && $NODE "$LR" 2>&1)
+assert_contains "human: nothing to surface" "$OUT" "No session reports"
+rm -rf "$TMP"
+
+# --- single report → extracts date + summary + next, exit 0 ---
+TMP=$(mktemp -d)
+write_report "$TMP" "2026-05-28" "Built the login flow" "Wire the dashboard" "2026-05-28"
+(cd "$TMP" && $NODE "$LR" >/dev/null 2>&1)
+assert_exit "single report → exit 0" 0 $?
+OUT=$(cd "$TMP" && $NODE "$LR" 2>&1)
+assert_contains "human shows date" "$OUT" "2026-05-28"
+assert_contains "human shows summary" "$OUT" "Built the login flow"
+assert_contains "human shows next" "$OUT" "Wire the dashboard"
+assert_contains "human has 'Last session' prefix" "$OUT" "Last session"
+rm -rf "$TMP"
+
+# --- json shape ---
+TMP=$(mktemp -d)
+write_report "$TMP" "2026-05-28" "Built the login flow" "Wire the dashboard" "2026-05-28"
+OUT=$(cd "$TMP" && $NODE "$LR" --json 2>&1)
+assert_contains "json found:true" "$OUT" '"found": true'
+assert_contains "json file field" "$OUT" '"file": "report-2026-05-28.md"'
+assert_contains "json date field" "$OUT" '"date": "2026-05-28"'
+assert_contains "json summary field" "$OUT" '"summary": "Built the login flow"'
+assert_contains "json next field" "$OUT" '"next": "Wire the dashboard"'
+rm -rf "$TMP"
+
+# --- multiple reports → picks the newest BY DATE (not file order) ---
+TMP=$(mktemp -d)
+write_report "$TMP" "2026-05-28" "Older work" "Old next" "2026-05-28"
+write_report "$TMP" "2026-06-15" "Newest work" "New next" "2026-06-15"
+write_report "$TMP" "2026-06-01" "Middle work" "Mid next" "2026-06-01"
+OUT=$(cd "$TMP" && $NODE "$LR" --json 2>&1)
+assert_contains "picks newest date file" "$OUT" '"file": "report-2026-06-15.md"'
+assert_contains "picks newest summary" "$OUT" "Newest work"
+assert_not_contains "does not pick older summary" "$OUT" "Older work"
+rm -rf "$TMP"
+
+# --- dated suffix filenames (report-2026-06-20-session2.md) parse correctly ---
+TMP=$(mktemp -d)
+write_report "$TMP" "2026-06-10" "Earlier" "e" "2026-06-10"
+write_report "$TMP" "2026-06-20-session2" "Suffixed newest" "s" "2026-06-20"
+OUT=$(cd "$TMP" && $NODE "$LR" --json 2>&1)
+assert_contains "suffixed filename wins by date" "$OUT" "Suffixed newest"
+assert_contains "suffixed date extracted" "$OUT" '"date": "2026-06-20"'
+rm -rf "$TMP"
+
+# --- --now makes age_days deterministic ---
+TMP=$(mktemp -d)
+write_report "$TMP" "2026-06-01" "Work" "Next" "2026-06-01"
+OUT=$(cd "$TMP" && $NODE "$LR" --json --now 2026-06-11T00:00:00Z 2>&1)
+assert_contains "age_days deterministic (10)" "$OUT" '"age_days": 10'
+OUT=$(cd "$TMP" && $NODE "$LR" --now 2026-06-11T00:00:00Z 2>&1)
+assert_contains "human age uses --now" "$OUT" "10d ago"
+rm -rf "$TMP"
+
+# --- library: latestReport() returns structured object ---
+TMP=$(mktemp -d)
+write_report "$TMP" "2026-06-01" "Lib work" "Lib next" "2026-06-01"
+RES=$($NODE -e "console.log(require('$LR').latestReport('$TMP').summary)" 2>&1)
+assert_contains "latestReport() returns summary" "$RES" "Lib work"
+RES=$($NODE -e "console.log(require('$LR').latestReport('$TMP',{now:'2026-06-06T00:00:00Z'}).age_days)" 2>&1)
+assert_contains "latestReport() honors now opt (5)" "$RES" "5"
+rm -rf "$TMP"
+
+# --- malformed / empty report handled gracefully (no crash, still exit 0) ---
+TMP=$(mktemp -d)
+mkdir -p "$TMP/.planning/reports"
+: > "$TMP/.planning/reports/report-2026-06-02.md"   # completely empty
+(cd "$TMP" && $NODE "$LR" >/dev/null 2>&1)
+assert_exit "empty report → exit 0 (found by filename)" 0 $?
+OUT=$(cd "$TMP" && $NODE "$LR" --json 2>&1)
+assert_contains "empty report found:true" "$OUT" '"found": true'
+assert_contains "empty report date from filename" "$OUT" '"date": "2026-06-02"'
+rm -rf "$TMP"
+
+# --- malformed report (no headings, just prose) still yields a summary ---
+TMP=$(mktemp -d)
+mkdir -p "$TMP/.planning/reports"
+printf 'just some freeform notes about the day\n' > "$TMP/.planning/reports/report-2026-06-03.md"
+OUT=$(cd "$TMP" && $NODE "$LR" --json 2>&1)
+assert_contains "malformed report falls back to first line" "$OUT" "just some freeform notes"
+rm -rf "$TMP"
+
+# --- bad argument → exit 2 ---
+TMP=$(mktemp -d)
+(cd "$TMP" && $NODE "$LR" --bogus >/dev/null 2>&1)
+assert_exit "unknown flag → exit 2" 2 $?
+rm -rf "$TMP"
+
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+[ "$FAIL" -eq 0 ] && exit 0 || exit 1

package/tests/lib.test.sh

@@ -365,6 +365,31 @@ console.log(c.includes(".codex/bin/state.js") && c.includes(".codex/agents/plann
 ')
 [ "$RES" = "HOST-RENDER-OK" ] && ok "host-adapters renders Qualia path tokens per host" || fail "host-adapters render: $RES"
 
+RES=$($NODE -e '
+const { adapter, hostForHome } = require("'"$HA"'");
+const c = adapter("claude"), x = adapter("codex");
+const ok =
+  c.agentCli === "claude" && JSON.stringify(c.agentExec("P")) === JSON.stringify(["-p","P"]) &&
+  x.agentCli === "codex"  && JSON.stringify(x.agentExec("P")) === JSON.stringify(["exec","P"]) &&
+  hostForHome("/x/.codex") === "codex" && hostForHome("/x/.claude") === "claude";
+console.log(ok ? "ADAPTER-EXEC-OK" : JSON.stringify({c:c.agentExec("P"),x:x.agentExec("P")}));
+')
+[ "$RES" = "ADAPTER-EXEC-OK" ] && ok "host-adapters owns agent-CLI invocation (agentCli/agentExec) + hostForHome" || fail "host-adapters agent-exec: $RES"
+
+# ─── R9 design dials: the 3 dials exist in the reference AND the DESIGN template ─
+DIALS="$FRAMEWORK_DIR/qualia-design/design-dials.md"
+DTMPL="$FRAMEWORK_DIR/templates/DESIGN.md"
+RES=$($NODE -e '
+const fs = require("fs");
+const ref = fs.readFileSync("'"$DIALS"'", "utf8");
+const tpl = fs.readFileSync("'"$DTMPL"'", "utf8");
+const dials = ["DESIGN_VARIANCE", "MOTION_INTENSITY", "VISUAL_DENSITY"];
+const refOk = dials.every(d => ref.includes(d)) && /ban\b/i.test(ref) && /do instead/i.test(ref);
+const tplOk = dials.every(d => tpl.includes(d));
+console.log(refOk && tplOk ? "DIALS-OK" : "FAIL ref="+refOk+" tpl="+tplOk);
+')
+[ "$RES" = "DIALS-OK" ] && ok "design dials + ban→do-instead present in design-dials.md AND DESIGN.md template" || fail "design dials: $RES"
+
 CS="$FRAMEWORK_DIR/bin/command-surface.js"
 $NODE --check "$CS" >/dev/null 2>&1 && ok "command-surface.js parses" || fail "command-surface.js parse"
 RES=$($NODE -e '
@@ -507,14 +532,14 @@ TMP=$(mktmp)
 mkdir -p "$TMP/home/.claude/bin" "$TMP/home/.claude/hooks" "$TMP/home/.claude/knowledge/daily-log" "$TMP/home/.claude/qualia-design" "$TMP/home/.claude/agents" "$TMP/home/.claude/qualia-templates" "$TMP/project"
 echo '{"installed_by":"Test","role":"OWNER","version":"6.3.0","erp":{"enabled":false}}' > "$TMP/home/.claude/.qualia-config.json"
 touch "$TMP/home/.claude/CLAUDE.md" "$TMP/home/.claude/settings.json"
-for f in runtime-manifest.js command-surface.js host-adapters.js state.js qualia-ui.js statusline.js knowledge.js knowledge-flush.js state-ledger.js plan-contract.js contract-runner.js agent-status.js analyze-gate.js harness-eval.js trust-score.js agent-runs.js slop-detect.mjs erp-retry.js work-packet.js report-payload.js project-snapshot.js codex-goal.js planning-hygiene.js prune-deprecated.js learning-candidates.js status-snapshot.js security-scan.js auto-report.js; do
+for f in runtime-manifest.js command-surface.js host-adapters.js state.js qualia-ui.js statusline.js knowledge.js knowledge-flush.js recall.js vault-access.js repo-map.js design-tokens.js batch-plan.js state-ledger.js plan-contract.js contract-runner.js agent-status.js analyze-gate.js verify-panel.js wave-plan.js eval-runner.js branch-hygiene.js last-report.js harness-eval.js trust-score.js agent-runs.js slop-detect.mjs erp-retry.js erp-event.js work-packet.js report-payload.js project-snapshot.js project-sync.js codex-goal.js planning-hygiene.js prune-deprecated.js learning-candidates.js status-snapshot.js security-scan.js auto-report.js; do
   touch "$TMP/home/.claude/bin/$f"
 done
 for h in session-start.js auto-update.js branch-guard.js pre-push.js pre-deploy-gate.js migration-guard.js git-guardrails.js stop-session-log.js fawzi-approval-guard.js vercel-account-guard.js env-empty-guard.js supabase-destructive-guard.js; do
   touch "$TMP/home/.claude/hooks/$h"
 done
 touch "$TMP/home/.claude/knowledge/index.md" "$TMP/home/.claude/knowledge/agents.md" "$TMP/home/.claude/agents/visual-evaluator.md" "$TMP/home/.claude/qualia-guide.md" "$TMP/home/.claude/qualia-templates/help.html"
-for f in design-laws.md design-rubric.md design-brand.md design-product.md design-reference.md frontend.md graphics.md; do
+for f in design-laws.md design-rubric.md design-brand.md design-product.md design-reference.md design-dials.md frontend.md graphics.md; do
   touch "$TMP/home/.claude/qualia-design/$f"
 done
 for s in $($NODE -e 'console.log(require(process.argv[1]).ACTIVE_SKILLS.join(" "))' "$CS"); do
@@ -622,14 +647,14 @@ TMP=$(mktmp)
 mkdir -p "$TMP/.claude/bin" "$TMP/.claude/hooks" "$TMP/.claude/knowledge/daily-log" "$TMP/.claude/qualia-design" "$TMP/.claude/agents" "$TMP/.claude/qualia-templates" "$TMP/project/.planning"
 echo '{"installed_by":"Test","role":"OWNER","erp":{"enabled":false}}' > "$TMP/.claude/.qualia-config.json"
 touch "$TMP/.claude/CLAUDE.md" "$TMP/.claude/settings.json"
-for f in runtime-manifest.js command-surface.js host-adapters.js state.js qualia-ui.js statusline.js knowledge.js knowledge-flush.js state-ledger.js plan-contract.js contract-runner.js agent-status.js analyze-gate.js harness-eval.js trust-score.js agent-runs.js slop-detect.mjs erp-retry.js work-packet.js report-payload.js project-snapshot.js codex-goal.js planning-hygiene.js prune-deprecated.js learning-candidates.js status-snapshot.js security-scan.js auto-report.js; do
+for f in runtime-manifest.js command-surface.js host-adapters.js state.js qualia-ui.js statusline.js knowledge.js knowledge-flush.js recall.js vault-access.js repo-map.js design-tokens.js batch-plan.js state-ledger.js plan-contract.js contract-runner.js agent-status.js analyze-gate.js verify-panel.js wave-plan.js eval-runner.js branch-hygiene.js last-report.js harness-eval.js trust-score.js agent-runs.js slop-detect.mjs erp-retry.js erp-event.js work-packet.js report-payload.js project-snapshot.js project-sync.js codex-goal.js planning-hygiene.js prune-deprecated.js learning-candidates.js status-snapshot.js security-scan.js auto-report.js; do
   touch "$TMP/.claude/bin/$f"
 done
 for h in session-start.js auto-update.js branch-guard.js pre-push.js pre-deploy-gate.js migration-guard.js git-guardrails.js stop-session-log.js fawzi-approval-guard.js vercel-account-guard.js env-empty-guard.js supabase-destructive-guard.js; do
   touch "$TMP/.claude/hooks/$h"
 done
 touch "$TMP/.claude/knowledge/index.md" "$TMP/.claude/knowledge/agents.md"
-for f in design-laws.md design-rubric.md design-brand.md design-product.md design-reference.md frontend.md graphics.md; do
+for f in design-laws.md design-rubric.md design-brand.md design-product.md design-reference.md design-dials.md frontend.md graphics.md; do
   touch "$TMP/.claude/qualia-design/$f"
 done
 for s in $($NODE -e 'console.log(require(process.argv[1]).ACTIVE_SKILLS.join(" "))' "$CS"); do

package/tests/project-sync.test.sh

@@ -0,0 +1,175 @@
+#!/bin/bash
+# project-sync.test.sh — bin/project-sync.js (Framework→ERP project-sync payload)
+# Run: bash tests/project-sync.test.sh
+
+PASS=0
+FAIL=0
+BIN_DIR="$(cd "$(dirname "$0")/../bin" && pwd)"
+NODE="${NODE:-node}"
+PS="$BIN_DIR/project-sync.js"
+
+assert_exit() {
+  local name="$1" expected="$2" actual="$3"
+  if [ "$expected" = "$actual" ]; then echo "  ✓ $name"; PASS=$((PASS+1));
+  else echo "  ✗ $name (expected exit $expected, got $actual)"; FAIL=$((FAIL+1)); fi
+}
+assert_contains() {
+  local name="$1" hay="$2" needle="$3"
+  if echo "$hay" | grep -qF "$needle"; then echo "  ✓ $name"; PASS=$((PASS+1));
+  else echo "  ✗ $name (missing '$needle' in output)"; FAIL=$((FAIL+1)); fi
+}
+assert_not_contains() {
+  local name="$1" hay="$2" needle="$3"
+  if echo "$hay" | grep -qF "$needle"; then echo "  ✗ $name (unexpected '$needle')"; FAIL=$((FAIL+1));
+  else echo "  ✓ $name"; PASS=$((PASS+1)); fi
+}
+
+# A fully-populated .planning fixture: milestones, REQ-IDs, offroad, lifetime.
+setup_full() {
+  local tmp
+  tmp=$(mktemp -d)
+  mkdir -p "$tmp/.planning"
+  cat > "$tmp/.planning/tracking.json" <<'EOF'
+{
+  "project": "acme-portal",
+  "project_id": "qs-acme-portal",
+  "client": "Acme",
+  "milestone": 2,
+  "milestone_name": "Product",
+  "milestones": [
+    { "num": 1, "name": "Foundation", "closed_at": "2026-04-10T18:00:00Z", "phases_completed": 3, "tasks_completed": 12, "deployed_url": "https://m1.vercel.app" }
+  ],
+  "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,
+  "deployed_url": "https://client.vercel.app",
+  "lifecycle": "build",
+  "lifetime": { "tasks_completed": 15, "phases_completed": 4, "milestones_completed": 1, "total_phases": 7, "offroad_count": 2 },
+  "offroad": [
+    { "at": "2026-06-01T10:00:00Z", "milestone": 2, "ref": "BUG-7", "note": "hotfix login" },
+    { "at": "2026-06-02T10:00:00Z", "milestone": 2, "ref": null, "note": "tweak" }
+  ]
+}
+EOF
+  cat > "$tmp/.planning/JOURNEY.md" <<'EOF'
+## Milestone 1 · Foundation
+## Milestone 2 · Product [CURRENT]
+## Milestone 3 · Handoff [FINAL]
+EOF
+  cat > "$tmp/.planning/REQUIREMENTS.md" <<'EOF'
+| ID | Milestone | Phase | Status |
+|----|-----------|-------|--------|
+| CORE-01 | M1: Foundation | Phase 1 | Complete |
+| CORE-02 | M2: Product | Phase 2 | Complete |
+| CORE-03 | M2: Product | Phase 3 | Incomplete |
+EOF
+  echo "$tmp"
+}
+
+echo "project-sync.test.sh — bin/project-sync.js"
+echo ""
+
+# --- syntax ---
+$NODE -c "$PS" 2>/dev/null && { echo "  ✓ syntax valid"; PASS=$((PASS+1)); } || { echo "  ✗ syntax invalid"; FAIL=$((FAIL+1)); }
+
+NOW="2026-06-21T00:00:00.000Z"
+
+# --- no .planning → exit 2 ---
+TMP=$(mktemp -d)
+(cd "$TMP" && $NODE "$PS" >/dev/null 2>&1)
+assert_exit "no .planning → exit 2" 2 $?
+rm -rf "$TMP"
+
+# --- full fixture → exit 0 + valid JSON ---
+TMP=$(setup_full)
+OUT=$($NODE "$PS" --cwd "$TMP" --json --now "$NOW" 2>&1)
+(cd "$TMP" && $NODE "$PS" --json --now "$NOW" >/dev/null 2>&1)
+assert_exit "full fixture → exit 0" 0 $?
+echo "$OUT" | $NODE -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>{JSON.parse(s);process.exit(0)})" 2>/dev/null \
+  && { echo "  ✓ --json emits valid JSON"; PASS=$((PASS+1)); } \
+  || { echo "  ✗ --json invalid JSON"; FAIL=$((FAIL+1)); }
+
+# --- schema_version + payload marker ---
+assert_contains "carries schema_version" "$OUT" '"schema_version": 1'
+assert_contains "payload marker is project-sync" "$OUT" '"payload": "project-sync"'
+
+# --- lifecycle + launched_at handling ---
+assert_contains "lifecycle present (build)" "$OUT" '"lifecycle": "build"'
+
+# --- milestones[] with status + REQ completion ---
+assert_contains "milestone 1 closed" "$OUT" '"status": "closed"'
+assert_contains "milestone 2 current" "$OUT" '"status": "current"'
+assert_contains "milestone 3 future" "$OUT" '"status": "future"'
+assert_contains "closed milestone phases count" "$OUT" '"phases": 3'
+assert_contains "closed milestone tasks_completed" "$OUT" '"tasks_completed": 12'
+assert_contains "REQ total tracked for M2" "$OUT" '"total": 2'
+assert_contains "REQ complete count" "$OUT" '"complete": 1'
+assert_contains "incomplete REQ id surfaced" "$OUT" '"id": "CORE-03"'
+assert_contains "future milestone REQ untracked" "$OUT" '"tracked": false'
+assert_contains "per-milestone deployed_url" "$OUT" '"deployed_url": "https://m1.vercel.app"'
+assert_contains "total_milestones from journey" "$OUT" '"total_milestones": 3'
+
+# --- current position ---
+assert_contains "current phase" "$OUT" '"phase": 2'
+assert_contains "current verification" "$OUT" '"verification": "pending"'
+
+# --- task rollup ---
+assert_contains "rollup tasks_completed" "$OUT" '"tasks_completed": 15'
+assert_contains "rollup build_count" "$OUT" '"build_count": 4'
+assert_contains "rollup deploy_count" "$OUT" '"deploy_count": 1'
+assert_contains "rollup gap_cycles (flattened to number)" "$OUT" '"current_phase_gap_cycles": 1'
+
+# --- accountability / offroad ---
+assert_contains "offroad_count" "$OUT" '"offroad_count": 2'
+assert_contains "recent offroad entry" "$OUT" '"ref": "BUG-7"'
+
+# --- integration / merge model ---
+assert_contains "trunk integration model" "$OUT" '"model": "trunk"'
+assert_contains "integrates at ship" "$OUT" '"integrates_at": "/qualia-ship"'
+assert_contains "main-push event type" "$OUT" '"main_push_event_type": "employee_main_push"'
+
+rm -rf "$TMP"
+
+# --- graceful when fields absent: minimal tracking.json, no JOURNEY/REQUIREMENTS ---
+TMP=$(mktemp -d)
+mkdir -p "$TMP/.planning"
+echo '{ "project": "bare", "milestone": 1, "phase": 1 }' > "$TMP/.planning/tracking.json"
+OUT=$($NODE "$PS" --cwd "$TMP" --json --now "$NOW" 2>&1)
+(cd "$TMP" && $NODE "$PS" --json --now "$NOW" >/dev/null 2>&1)
+assert_exit "bare fixture → exit 0" 0 $?
+assert_contains "bare still has schema_version" "$OUT" '"schema_version": 1'
+assert_contains "bare offroad_count defaults to 0" "$OUT" '"offroad_count": 0'
+assert_contains "bare emits a current milestone" "$OUT" '"status": "current"'
+assert_contains "bare REQ untracked (no REQUIREMENTS.md)" "$OUT" '"tracked": false'
+rm -rf "$TMP"
+
+# --- library: buildProjectSync() returns the object ---
+TMP=$(setup_full)
+RES=$($NODE -e "const {buildProjectSync}=require('$PS');const o=buildProjectSync({cwd:'$TMP',now:'$NOW'});console.log(o.schema_version, o.milestones.length, o.milestones[1].requirements.incomplete[0].id)" 2>&1)
+assert_contains "buildProjectSync() returns enriched object" "$RES" "1 3 CORE-03"
+rm -rf "$TMP"
+
+# --- library: milestoneRequirements() parses a fixture dir ---
+TMP=$(setup_full)
+RES=$($NODE -e "const {milestoneRequirements}=require('$PS');const r=milestoneRequirements('$TMP/.planning',2);console.log(r.tracked, r.total, r.complete, r.incomplete.length)" 2>&1)
+assert_contains "milestoneRequirements() counts REQ completion" "$RES" "true 2 1 1"
+rm -rf "$TMP"
+
+# --- --write persists a snapshot file ---
+TMP=$(setup_full)
+FILE=$($NODE "$PS" --cwd "$TMP" --write --now "$NOW" 2>&1)
+if [ -f "$FILE" ]; then echo "  ✓ --write persists a file"; PASS=$((PASS+1));
+else echo "  ✗ --write did not persist ($FILE)"; FAIL=$((FAIL+1)); fi
+assert_contains "written file is project-sync-*" "$FILE" "project-sync-"
+rm -rf "$TMP"
+
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+[ "$FAIL" -eq 0 ] && exit 0 || exit 1

package/tests/recall.test.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# recall.test.sh — bin/recall.js (read-side memory recall, role-filtered vault)
+# Run: bash tests/recall.test.sh
+
+PASS=0
+FAIL=0
+BIN_DIR="$(cd "$(dirname "$0")/../bin" && pwd)"
+NODE="${NODE:-node}"
+RECALL="$BIN_DIR/recall.js"
+
+assert_exit()     { if [ "$2" = "$3" ]; then echo "  ✓ $1"; PASS=$((PASS+1)); else echo "  ✗ $1 (expected exit $2, got $3)"; FAIL=$((FAIL+1)); fi; }
+assert_contains() { if echo "$2" | grep -qF "$3"; then echo "  ✓ $1"; PASS=$((PASS+1)); else echo "  ✗ $1 (missing '$3')"; FAIL=$((FAIL+1)); fi; }
+assert_absent()   { if echo "$2" | grep -qF "$3"; then echo "  ✗ $1 (LEAK: found '$3')"; FAIL=$((FAIL+1)); else echo "  ✓ $1"; PASS=$((PASS+1)); fi; }
+
+echo "recall.test.sh — bin/recall.js"
+echo ""
+
+$NODE -c "$RECALL" 2>/dev/null && { echo "  ✓ syntax valid"; PASS=$((PASS+1)); } || { echo "  ✗ syntax invalid"; FAIL=$((FAIL+1)); }
+
+# ── Fixture: a temp knowledge home + a temp vault with an access manifest ──
+HOME_DIR=$(mktemp -d)
+VAULT=$(mktemp -d)
+mkdir -p "$HOME_DIR/knowledge" "$VAULT/wiki/concepts" "$VAULT/wiki/_meta"
+
+# knowledge layer hit
+cat > "$HOME_DIR/knowledge/learned-patterns.md" <<'EOF'
+# Patterns
+- The zebrafish pattern: batch writes before fanout.
+EOF
+# vault ALL_ROLES hit
+cat > "$VAULT/wiki/concepts/notes.md" <<'EOF'
+A lesson about the zebrafish approach to retries.
+EOF
+# vault OWNER_ONLY hit (the access manifest itself names wiki/_meta/access.md)
+cat > "$VAULT/wiki/_meta/access.md" <<'EOF'
+# Vault Access Manifest
+## OWNER_ONLY
+| Path | Why |
+|---|---|
+| `Clients/*.md` | commercial |
+| `wiki/_meta/access.md` | this file (zebrafish marker) |
+## ALL_ROLES
+| `wiki/concepts/` | lessons |
+EOF
+
+export QUALIA_MEMORY_ROOT="$VAULT"
+RUN() { QUALIA_HOME="$HOME_DIR" "$@"; }
+
+# ── Invocation guards ──
+RUN $NODE "$RECALL" >/dev/null 2>&1; assert_exit "no query → exit 2" 2 $?
+RUN $NODE "$RECALL" zebrafish --scope bogus >/dev/null 2>&1; assert_exit "bad scope → exit 2" 2 $?
+
+# ── Hits across both stores ──
+OUT=$(QUALIA_ROLE=OWNER RUN $NODE "$RECALL" zebrafish 2>&1); assert_exit "valid query → exit 0" 0 $?
+assert_contains "knowledge-layer hit"    "$OUT" "learned-patterns.md"
+assert_contains "vault ALL_ROLES hit"    "$OUT" "concepts/notes.md"
+
+# ── Role enforcement (the security boundary) ──
+OWNER_OUT=$(QUALIA_ROLE=OWNER RUN $NODE "$RECALL" zebrafish --scope vault 2>&1)
+assert_contains "OWNER sees OWNER_ONLY path"  "$OWNER_OUT" "_meta/access.md"
+EMP_OUT=$(QUALIA_ROLE=EMPLOYEE RUN $NODE "$RECALL" zebrafish --scope vault 2>&1)
+assert_contains "EMPLOYEE still sees ALL_ROLES" "$EMP_OUT" "concepts/notes.md"
+assert_absent   "EMPLOYEE blocked from OWNER_ONLY" "$EMP_OUT" "_meta/access.md"
+# fail-closed: no role config + no QUALIA_ROLE → RESTRICTED
+NOROLE_OUT=$(QUALIA_HOME="$VAULT" env -u QUALIA_ROLE $NODE "$RECALL" zebrafish --scope vault 2>&1)
+assert_absent   "RESTRICTED (fail-closed) blocked from OWNER_ONLY" "$NOROLE_OUT" "_meta/access.md"
+
+# ── JSON shape ──
+JSON=$(QUALIA_ROLE=OWNER RUN $NODE "$RECALL" zebrafish --json 2>&1)
+echo "$JSON" | $NODE -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>{const j=JSON.parse(s);if(j.role&&j.scope==='all'&&typeof j.total==='number'&&Array.isArray(j.knowledge)&&Array.isArray(j.vault))process.exit(0);process.exit(1)})" \
+  && { echo "  ✓ --json valid shape (role/scope/total/knowledge/vault)"; PASS=$((PASS+1)); } \
+  || { echo "  ✗ --json shape"; FAIL=$((FAIL+1)); }
+
+# ── Scope isolation ──
+KONLY=$(QUALIA_ROLE=OWNER RUN $NODE "$RECALL" zebrafish --scope knowledge 2>&1)
+assert_contains "scope=knowledge includes knowledge" "$KONLY" "learned-patterns.md"
+assert_absent   "scope=knowledge excludes vault"     "$KONLY" "concepts/notes.md"
+VONLY=$(QUALIA_ROLE=OWNER RUN $NODE "$RECALL" zebrafish --scope vault 2>&1)
+assert_absent   "scope=vault excludes knowledge"     "$VONLY" "learned-patterns.md"
+
+# ── Graceful degradation ──
+NOVAULT=$(QUALIA_HOME="$HOME_DIR" QUALIA_MEMORY_ROOT="/tmp/qualia-no-such-vault-$$" QUALIA_ROLE=OWNER $NODE "$RECALL" zebrafish 2>&1); RC=$?
+assert_exit     "missing vault → still exit 0" 0 $RC
+assert_contains "missing vault → knowledge still searched" "$NOVAULT" "learned-patterns.md"
+ZERO=$(QUALIA_ROLE=OWNER RUN $NODE "$RECALL" "noyzzqxmatch" 2>&1); assert_exit "zero hits → exit 0" 0 $?
+assert_contains "zero hits → friendly message" "$ZERO" "no matches"
+
+rm -rf "$HOME_DIR" "$VAULT"
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+[ "$FAIL" -eq 0 ]

package/tests/repo-map.test.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# repo-map.test.sh — bin/repo-map.js (zero-dep symbol map for /qualia-map)
+# Run: bash tests/repo-map.test.sh
+
+PASS=0
+FAIL=0
+BIN_DIR="$(cd "$(dirname "$0")/../bin" && pwd)"
+NODE="${NODE:-node}"
+RM="$BIN_DIR/repo-map.js"
+
+assert_exit()     { if [ "$2" = "$3" ]; then echo "  ✓ $1"; PASS=$((PASS+1)); else echo "  ✗ $1 (expected exit $2, got $3)"; FAIL=$((FAIL+1)); fi; }
+assert_contains() { if echo "$2" | grep -qF "$3"; then echo "  ✓ $1"; PASS=$((PASS+1)); else echo "  ✗ $1 (missing '$3')"; FAIL=$((FAIL+1)); fi; }
+assert_absent()   { if echo "$2" | grep -qF "$3"; then echo "  ✗ $1 (unexpected '$3')"; FAIL=$((FAIL+1)); else echo "  ✓ $1"; PASS=$((PASS+1)); fi; }
+
+echo "repo-map.test.sh — bin/repo-map.js"
+echo ""
+
+$NODE -c "$RM" 2>/dev/null && { echo "  ✓ syntax valid"; PASS=$((PASS+1)); } || { echo "  ✗ syntax invalid"; FAIL=$((FAIL+1)); }
+
+# ── Fixture repo ──
+REPO=$(mktemp -d)
+mkdir -p "$REPO/src" "$REPO/node_modules/pkg" "$REPO/api"
+cat > "$REPO/src/widget.ts" <<'EOF'
+export function makeWidget() {}
+export class WidgetStore {}
+export const WIDGET_LIMIT = 5;
+export type WidgetId = string;
+function internalHelper() {}
+EOF
+cat > "$REPO/api/handler.py" <<'EOF'
+class Handler:
+    pass
+def serve():
+    pass
+async def serve_async():
+    pass
+EOF
+cat > "$REPO/node_modules/pkg/index.js" <<'EOF'
+export function shouldBeIgnored() {}
+EOF
+
+# ── Symbol extraction ──
+OUT=$($NODE "$RM" "$REPO" 2>&1); assert_exit "valid dir → exit 0" 0 $?
+assert_contains "extracts JS export function" "$OUT" "makeWidget"
+assert_contains "extracts JS export class"    "$OUT" "WidgetStore"
+assert_contains "extracts JS export const"    "$OUT" "WIDGET_LIMIT"
+assert_contains "extracts JS export type"     "$OUT" "WidgetId"
+assert_contains "extracts Python def"         "$OUT" "serve"
+assert_contains "extracts Python class"       "$OUT" "Handler"
+assert_absent   "ignores node_modules"        "$OUT" "shouldBeIgnored"
+
+# ── JSON shape ──
+JSON=$($NODE "$RM" "$REPO" --json 2>&1)
+echo "$JSON" | $NODE -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>{const j=JSON.parse(s);if(typeof j.total_files==='number'&&typeof j.total_symbols==='number'&&Array.isArray(j.files)&&j.files[0].symbols)process.exit(0);process.exit(1)})" \
+  && { echo "  ✓ --json valid shape (total_files/total_symbols/files[].symbols)"; PASS=$((PASS+1)); } \
+  || { echo "  ✗ --json shape"; FAIL=$((FAIL+1)); }
+# densest file first (widget.ts has 5 symbols, handler.py has 3)
+FIRST=$(echo "$JSON" | $NODE -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>{console.log(JSON.parse(s).files[0].file)})")
+[ "$FIRST" = "src/widget.ts" ] && { echo "  ✓ ranks densest file first"; PASS=$((PASS+1)); } || { echo "  ✗ ranking (got '$FIRST')"; FAIL=$((FAIL+1)); }
+
+# ── Edge cases ──
+$NODE "$RM" /no/such/dir-xyz >/dev/null 2>&1; assert_exit "missing dir → exit 2" 2 $?
+EMPTY=$(mktemp -d)
+EOUT=$($NODE "$RM" "$EMPTY" 2>&1); assert_exit "empty dir → exit 0" 0 $?
+assert_contains "empty dir → 0 source files" "$EOUT" "0 source files"
+
+rm -rf "$REPO" "$EMPTY"
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+[ "$FAIL" -eq 0 ]

package/tests/run-all.sh

@@ -20,6 +20,18 @@ SUITES=(
   "slop-detect"
   "agent-status"
   "analyze-gate"
+  "instructions"
+  "verify-panel"
+  "wave-plan"
+  "eval-runner"
+  "branch-hygiene"
+  "last-report"
+  "project-sync"
+  "erp-event"
+  "recall"
+  "repo-map"
+  "design-tokens"
+  "batch-plan"
 )
 
 FAILED=()