qualia-framework 6.2.9 → 6.2.10

package/skills/qualia-verify/SKILL.md

@@ -28,30 +28,44 @@ Spawn verifier to check phase goal. Does NOT trust build summaries; greps codeba
 ```bash
 echo "---PLAN---"
 cat .planning/phase-{N}-plan.md 2>/dev/null
+echo "---CONTRACT---"
+cat .planning/phase-{N}-contract.json 2>/dev/null || echo "NO_JSON_CONTRACT"
 echo "---PREVIOUS---"
 cat .planning/phase-{N}-verification.md 2>/dev/null || echo "NONE"
 ```
 
-### 2. Spawn Verifier (Fresh Context)
+### 2. Run Machine Contract First
+
+If `.planning/phase-{N}-contract.json` exists, run:
+
+```bash
+node ${QUALIA_BIN}/contract-runner.js .planning/phase-{N}-contract.json
+```
+
+If it fails, the phase cannot PASS. Still spawn the verifier to explain the failure and identify the smallest gap-closure tasks. If it passes, pass the evidence file into the verifier prompt.
+
+### 3. Spawn Verifier (Fresh Context)
 
 ```bash
-node ~/.claude/bin/qualia-ui.js banner verify {N} "{phase name}"
-node ~/.claude/bin/qualia-ui.js spawn verifier "Goal-backward check..."
+node ${QUALIA_BIN}/qualia-ui.js banner verify {N} "{phase name}"
+node ${QUALIA_BIN}/qualia-ui.js spawn verifier "Goal-backward check..."
 ```
 
 ```
 Agent(prompt="
-Role: @~/.claude/agents/verifier.md
+Role: @${QUALIA_AGENTS}/verifier.md
 
 Project: @.planning/PROJECT.md
 Plan + AC + validation: @.planning/phase-{N}-plan.md
+Machine contract: @.planning/phase-{N}-contract.json
+Contract evidence: @.planning/evidence/phase-{N}-contract-run.json
 {Re-verify → previous gaps: @.planning/phase-{N}-verification.md}
 
 Verify phase. Every finding needs file:line evidence. Severity Rubric for all labels. Output: .planning/phase-{N}-verification.md
 ", subagent_type="qualia-verifier", description="Verify phase {N}")
 ```
 
-### 2b. Browser QA (if phase touched frontend)
+### 3b. Browser QA (if phase touched frontend)
 
 If plan Files include `.tsx`/`.jsx`/`.css`/`.scss` or `app/`/`pages/`/`components/` paths, spawn browser QA parallel:
 
@@ -64,7 +78,7 @@ If frontend:
 
 ```
 Agent(prompt="
-Role: @~/.claude/agents/qa-browser.md
+Role: @${QUALIA_AGENTS}/qa-browser.md
 
 Plan: @.planning/phase-{N}-plan.md
 Verification: @.planning/phase-{N}-verification.md
@@ -75,17 +89,17 @@ Drive dev server, test routes phase touched. Append '## Browser QA' to verificat
 
 Wait for both verifier + QA before step 3. Playwright MCP unavailable → QA returns BLOCKED (note, not phase failure).
 
-### 2c. Adversarial Second Opinion (--adversarial flag, optional)
+### 3c. Adversarial Second Opinion (--adversarial flag, optional)
 
 `--adversarial` in args, OR milestone is `Handoff`, OR plan touches `auth|payment|migration|rls|service_role` → spawn SECOND verifier in fresh context. Mitigates self-grading bias (~70% fewer findings without adversarial pass).
 
 ```bash
-node ~/.claude/bin/qualia-ui.js spawn verifier "Adversarial pass — find what's wrong"
+node ${QUALIA_BIN}/qualia-ui.js spawn verifier "Adversarial pass — find what's wrong"
 ```
 
 ```
 Agent(prompt="
-Role: @~/.claude/agents/verifier.md
+Role: @${QUALIA_AGENTS}/verifier.md
 
 ADVERSARIAL reviewer. Find what's WRONG. Assume cooperative verifier missed something. Same Severity Rubric + evidence-citation req. Bias toward edge cases:
   - Untested error paths?
@@ -104,14 +118,14 @@ Append '## Adversarial Findings' to verification file. Empty section fine if not
 
 Findings merge into main report. Union PASS/FAIL: either pass found CRITICAL/HIGH → phase FAIL.
 
-### 2d. INSUFFICIENT EVIDENCE downgrade (mandatory)
+### 3d. INSUFFICIENT EVIDENCE downgrade (mandatory)
 
 The verifier marks criteria it could not check (budget exhaustion, missing context) as `INSUFFICIENT EVIDENCE`. The orchestrator must treat those as FAIL before declaring PASS. Grep the verification file and downgrade immediately:
 
 ```bash
 IE_COUNT=$(grep -c "INSUFFICIENT EVIDENCE" .planning/phase-{N}-verification.md 2>/dev/null || echo 0)
 if [ "$IE_COUNT" -gt 0 ]; then
-  node ~/.claude/bin/qualia-ui.js warn "${IE_COUNT} criteria marked INSUFFICIENT EVIDENCE — downgrading verdict to FAIL"
+  node ${QUALIA_BIN}/qualia-ui.js warn "${IE_COUNT} criteria marked INSUFFICIENT EVIDENCE — downgrading verdict to FAIL"
   # Rewrite the verdict line in-place
   sed -i 's/^result: PASS$/result: FAIL/' .planning/phase-{N}-verification.md
   sed -i 's/^## Verdict$/## Verdict\n\n**Downgraded to FAIL:** '"${IE_COUNT}"' criteria left unchecked. Re-run with larger budget (`max(25, tasks*5)` already applied) or simplify the phase plan./' .planning/phase-{N}-verification.md
@@ -126,20 +140,20 @@ Read verification report. Present:
 
 **PASS:**
 ```bash
-node ~/.claude/bin/qualia-ui.js ok "All {count} criteria passed"
-node ~/.claude/bin/qualia-ui.js end "PHASE {N} VERIFIED" "/qualia-plan {N+1}"
+node ${QUALIA_BIN}/qualia-ui.js ok "All {count} criteria passed"
+node ${QUALIA_BIN}/qualia-ui.js end "PHASE {N} VERIFIED" "/qualia-plan {N+1}"
 ```
 (Last phase → `/qualia-polish` as next command.)
 
 **FAIL:**
 ```bash
-node ~/.claude/bin/qualia-ui.js ok "Passed: {pass_count}"
-node ~/.claude/bin/qualia-ui.js fail "Failed: {fail_count}"
+node ${QUALIA_BIN}/qualia-ui.js ok "Passed: {pass_count}"
+node ${QUALIA_BIN}/qualia-ui.js fail "Failed: {fail_count}"
 ```
 
 Per gap:
 ```bash
-node ~/.claude/bin/qualia-ui.js fail "{gap description}"
+node ${QUALIA_BIN}/qualia-ui.js fail "{gap description}"
 ```
 
 **Self-healing:** before re-planning gaps, run postmortem so the framework learns from the miss. Writes `.planning/phase-{N}-postmortem.md`. Does NOT auto-apply deltas unless user runs `/qualia-postmortem --apply`.
@@ -150,13 +164,13 @@ node ~/.claude/bin/qualia-ui.js fail "{gap description}"
 
 End:
 ```bash
-node ~/.claude/bin/qualia-ui.js end "PHASE {N} GAPS FOUND" "/qualia-plan {N} --gaps"
+node ${QUALIA_BIN}/qualia-ui.js end "PHASE {N} GAPS FOUND" "/qualia-plan {N} --gaps"
 ```
 
 ### 4. Update State
 
 ```bash
-node ~/.claude/bin/state.js transition --to verified --phase {N} --verification {pass|fail}
+node ${QUALIA_BIN}/state.js transition --to verified --phase {N} --verification {pass|fail}
 ```
 PASS + more phases → state.js auto-advances.
 FAIL + gap_cycles >= limit → GAP_CYCLE_LIMIT, escalate.
@@ -166,7 +180,7 @@ Do NOT edit STATE.md or tracking.json manually; state.js handles both.
 Capture new state for auto-chain routing:
 
 ```bash
-NEW_STATE=$(node ~/.claude/bin/state.js check)
+NEW_STATE=$(node ${QUALIA_BIN}/state.js check)
 # Parse: .phase, .total_phases, .status, .verification
 # Read .planning/JOURNEY.md to check if last phase of milestone
 ```
@@ -189,8 +203,8 @@ Handoff: milestone name == "Handoff" AND last phase.
 **Halt (gap cycle limit):**
 
 ```bash
-node ~/.claude/bin/qualia-ui.js fail "Phase {N} failed verification {cycles} times -- gap limit reached"
-node ~/.claude/bin/qualia-ui.js warn "Human intervention required. Options:"
+node ${QUALIA_BIN}/qualia-ui.js fail "Phase {N} failed verification {cycles} times -- gap limit reached"
+node ${QUALIA_BIN}/qualia-ui.js warn "Human intervention required. Options:"
 echo "  1. Re-plan from scratch: /qualia-plan {N}"
 echo "  2. Adjust roadmap (scope wrong)"
 echo "  3. Escalate to Fawzi (EMPLOYEE role)"
@@ -200,9 +214,9 @@ echo "  3. Escalate to Fawzi (EMPLOYEE role)"
 
 ```bash
 # PASS (or "/qualia-milestone" if last phase, "/qualia-polish" if overall last)
-node ~/.claude/bin/qualia-ui.js end "PHASE {N} VERIFIED" "/qualia-plan {N+1}"
+node ${QUALIA_BIN}/qualia-ui.js end "PHASE {N} VERIFIED" "/qualia-plan {N+1}"
 # FAIL
-node ~/.claude/bin/qualia-ui.js end "PHASE {N} GAPS FOUND" "/qualia-plan {N} --gaps"
+node ${QUALIA_BIN}/qualia-ui.js end "PHASE {N} GAPS FOUND" "/qualia-plan {N} --gaps"
 ```
 
 ### 5. Passive Knowledge Capture (on FAIL)

package/skills/qualia-vibe/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qualia-vibe
-description: "Fast aesthetic pivot — swap the design vibe (tokens: color, typography, motion, depth) without touching component structure or layout. Default mode proposes ONE direction (per rules/one-opinion.md). Sub-modes: --variants for A/B/C menu (only when user explicitly asked), --extract URL to reverse-engineer DESIGN.md from a reference site, --sync to back-sync code → DESIGN.md when tokens drifted in code. Triggers: 'different vibe', 'change the look', 'swap the aesthetic', 'try something bolder', 'redesign the look', 'match this site', 'sync the design file'."
+description: "Fast aesthetic-token pivot — swap the design vibe (color, typography, motion, depth) without touching component structure, layout, routes, or behavior. Default mode proposes ONE direction (per rules/one-opinion.md). Sub-modes: --variants for A/B/C menu, --extract URL to reverse-engineer DESIGN.md, --sync to back-sync code → DESIGN.md. Triggers: 'different vibe', 'change the look', 'swap the aesthetic', 'try something bolder', 'match this site', 'sync the design file'. Route structural redesign to /qualia-polish --redesign and broken UI behavior to /qualia-fix."
 disable-model-invocation: false
 allowed-tools:
   - Bash
@@ -26,7 +26,8 @@ Swap the **vibe** without redoing the **app**. Tokens only: color, typography, d
 
 ## When NOT to use
 
-- The complaint is "this component is broken" or "the spacing is wrong" → `/qualia-polish` (component or section scope).
+- The complaint is "this component is broken" as behavior → `/qualia-fix`.
+- The complaint is "the spacing is wrong" or "this looks rough" → `/qualia-polish` (component or section scope).
 - The site has no DESIGN.md yet → run `/qualia-new` first; vibe is a PIVOT, not a cold start.
 - You want a structural redesign (layout, navigation, information architecture) → `/qualia-polish --redesign` (~30 min ground-up).
 
@@ -72,7 +73,7 @@ Back-sync. Reads the codebase's actual CSS vars, Tailwind config, and font impor
 ### 0. Pre-flight gates
 
 ```bash
-node ~/.claude/bin/qualia-ui.js banner vibe 2>/dev/null
+node ${QUALIA_BIN}/qualia-ui.js banner vibe 2>/dev/null
 
 # DESIGN.md must exist
 test -f .planning/DESIGN.md || {
@@ -127,12 +128,13 @@ Once user approves a direction:
    - CSS vars in `app/globals.css` or `src/styles/globals.css` (whichever exists)
    - `tailwind.config.{ts,js,mjs}` colors / fonts / spacing extensions
    - Font imports (`@import url(...)` in CSS, or `<link>` in `app/layout.tsx`, or `next/font/google` calls)
-7. Run `node ~/.claude/bin/slop-detect.mjs` on changed files. Block on critical findings (no banned fonts in the new vibe).
+7. Run `node ${QUALIA_BIN}/slop-detect.mjs` on changed files. Block on critical findings (no banned fonts in the new vibe).
 8. Capture one screenshot at desktop (1440) for visual diff:
    ```bash
-   node ~/.claude/skills/qualia-polish/scripts/playwright-capture.mjs \
+   mkdir -p .planning/assets/vibe
+   node ${QUALIA_SKILLS}/qualia-polish/scripts/playwright-capture.mjs \
      --url ${URL:-http://localhost:3000} \
-     --out .planning/vibe-after.png \
+     --out .planning/assets/vibe/vibe-after.png \
      --width 1440
    ```
 9. Commit:
@@ -146,7 +148,7 @@ If the commit fails (no dev server, no slop-detect, network error), surface the
 ### 4. Variants flow
 
 ```bash
-node ~/.claude/skills/qualia-vibe/scripts/tokens.mjs propose-variants \
+node ${QUALIA_SKILLS}/qualia-vibe/scripts/tokens.mjs propose-variants \
   --product .planning/PRODUCT.md \
   --design  .planning/DESIGN.md \
   --count   ${N:-3}
@@ -157,9 +159,10 @@ Output N briefs side-by-side. `AskUserQuestion` with N options (one per variant)
 ### 5. Extract flow
 
 ```bash
-node ~/.claude/skills/qualia-vibe/scripts/extract.mjs \
+mkdir -p .planning/design
+node ${QUALIA_SKILLS}/qualia-vibe/scripts/extract.mjs \
   --source ${URL_OR_IMAGE} \
-  --out    .planning/DESIGN-extracted.md
+  --out    .planning/design/DESIGN-extracted.md
 ```
 
 The script:
@@ -173,7 +176,7 @@ Present the draft. Diff against current DESIGN.md. User can: `Apply as new vibe`
 ### 6. Sync flow
 
 ```bash
-node ~/.claude/skills/qualia-vibe/scripts/tokens.mjs sync \
+node ${QUALIA_SKILLS}/qualia-vibe/scripts/tokens.mjs sync \
   --design .planning/DESIGN.md \
   ${WRITE:+--write}
 ```

package/skills/qualia-vibe/scripts/extract.mjs

@@ -35,7 +35,7 @@ function flag(name, fallback) {
 }
 
 const source = flag("--source");
-const outDraft = flag("--out", ".planning/DESIGN-extracted.md");
+const outDraft = flag("--out", ".planning/design/DESIGN-extracted.md");
 
 if (!source) {
   console.error("--source required (URL or local image path)");

package/skills/zoho-workflow/SKILL.md

@@ -43,7 +43,7 @@ The full handoff runbook lives in the qualia-erp repo: `docs/finance-runbook.md`
 ## Email Formatting Rules (MANDATORY)
 
 - Always append Fawzi's signature at the bottom of every email
-- Read signature HTML from `~/.claude/knowledge/email-signature.html`
+- Read signature HTML from `${QUALIA_KNOWLEDGE}/email-signature.html`
 - Never use dashes (---) or horizontal separators
 - Never use emojis
 - Professional, direct tone

package/templates/help.html

@@ -297,7 +297,7 @@
   <div class="header-content">
     <h1><span>Qualia</span> Framework</h1>
     <p>Plan, build, verify, ship. The AI-powered workflow for Qualia Solutions.</p>
-    <div class="version">{{VERSION}} &middot; 33 skills</div>
+    <div class="version">{{VERSION}} &middot; 35 skills</div>
   </div>
 </div>
 
@@ -328,7 +328,7 @@
 
   <!-- Skills -->
   <section>
-    <h2>Skills (28)</h2>
+    <h2>Skills</h2>
 
     <!-- Road (core flow) -->
     <div class="cmd-group">
@@ -360,11 +360,13 @@
     <!-- Quality -->
     <div class="cmd-group">
       <h3>Quality</h3>
-      <p class="cmd-group-note">Diagnose, audit, optimize, polish, test.</p>
+      <p class="cmd-group-note">Fix, diagnose, audit, optimize, polish, test.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-debug</span><span class="cmd-desc">Structured debugging &mdash; symptom gathering, diagnosis confirmation, root cause analysis. Trigger on 'debug', 'find bug', 'fix error', 'something is broken'.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-review</span><span class="cmd-desc">Production audit with scored diagnostics. Runs real commands, scores findings by severity. Trigger on 'review', 'audit', 'code review', 'security check'.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-optimize</span><span class="cmd-desc">Deep optimization pass &mdash; reads .planning/ AND codebase to find performance, design, UI, backend, and frontend issues. Spawns parallel specialist agents. Supports --perf, --ui, --backend, --alignment, --fix flags.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-doctor</span><span class="cmd-desc">Framework health check &mdash; install, state, contracts, memory, hooks, and ERP queue. Use when Qualia itself feels broken or Codex/Claude is not picking it up.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-fix</span><span class="cmd-desc">Repair broken existing behavior &mdash; build a feedback loop, find root cause, patch minimally, verify, write a fix report. Trigger on 'fix this', 'bug', 'broken', 'failing test', 'regression'.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-debug</span><span class="cmd-desc">Structured investigation &mdash; symptom gathering, diagnosis confirmation, root cause analysis. Use when the failure is unclear and you need evidence before repair.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-review</span><span class="cmd-desc">Read-only production audit with scored diagnostics. Runs real commands, scores findings by severity, then routes repairs to /qualia-fix, /qualia-polish, or /qualia-optimize.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-optimize</span><span class="cmd-desc">Deep improvement discovery &mdash; reads .planning/ AND codebase to find performance, design, UI, backend, alignment, and architecture opportunities. Writes OPTIMIZE.md/RFCs; specific repairs route through /qualia-fix.</span></div>
         <div class="cmd"><span class="cmd-name">/qualia-test</span><span class="cmd-desc">Generate or run tests for client projects. Trigger on 'write tests', 'add tests', 'test this', 'test coverage'.</span></div>
         <div class="cmd"><span class="cmd-name">/qualia-zoom</span><span class="cmd-desc">Focus on a single file or function with full context (glossary terms, depending callers, ADRs touched). Use when a fresh agent needs surgical context for a tricky area.</span></div>
         <div class="cmd"><span class="cmd-name">/qualia-issues</span><span class="cmd-desc">Break a phase plan into independent vertical-slice GitHub issues with needs-triage label. Externalizes work to the open queue so other sessions or contributors can pull from it.</span></div>
@@ -377,9 +379,9 @@
       <h3>Quick Paths</h3>
       <p class="cmd-group-note">Lightweight alternatives when the full road is overkill.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-feature</span><span class="cmd-desc">Auto-scoped single-feature build. Inline for trivia (typo, config), fresh builder spawn for 1-5 file features. Refuses and routes to /qualia-plan for phase-sized work. Flags: --force-spawn, --force-inline.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-polish</span><span class="cmd-desc">Design pass, scope-adaptive &mdash; component, route, full app, redesign, critique, quick. Add --loop for the autonomous screenshot &rarr; score &rarr; fix loop.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-vibe</span><span class="cmd-desc">Fast aesthetic pivot (~3 min) &mdash; swap design tokens (color, type, depth, motion), keep layout untouched. Default proposes ONE direction. Modes: --variants for A/B/C, --extract URL to reverse-engineer DESIGN.md from a reference site, --sync for code &harr; DESIGN.md back-sync.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-feature</span><span class="cmd-desc">Auto-scoped new-feature build. Inline for trivia (copy, config), fresh builder spawn for 1-5 file features. Broken existing behavior routes to /qualia-fix. Flags: --force-spawn, --force-inline.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-polish</span><span class="cmd-desc">Visual quality pass, scope-adaptive &mdash; component, route, full app, redesign, critique, quick. It fixes style/layout/accessibility only; functional bugs route to /qualia-fix.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-vibe</span><span class="cmd-desc">Fast aesthetic-token pivot (~3 min) &mdash; swap color, type, depth, and motion, keep layout untouched. Structural redesign routes to /qualia-polish --redesign.</span></div>
       </div>
     </div>
 
@@ -548,7 +550,7 @@
 <div class="footer">
   <strong>Welcome to the future with Qualia.</strong><br>
   Qualia Solutions &mdash; Nicosia, Cyprus
-  <span class="footer-version">qualia-framework {{VERSION}} &middot; 33 skills</span>
+  <span class="footer-version">qualia-framework {{VERSION}} &middot; 35 skills</span>
 </div>
 
 </body>

package/tests/bin.test.sh

@@ -452,9 +452,15 @@ if [ "$EXIT" -eq 0 ] \
    && [ -f "$TMP/.claude/skills/qualia/SKILL.md" ] \
    && [ -f "$TMP/.claude/hooks/session-start.js" ] \
    && [ -f "$TMP/.claude/bin/state.js" ] \
+   && [ -f "$TMP/.claude/bin/runtime-manifest.js" ] \
+   && [ -f "$TMP/.claude/bin/host-adapters.js" ] \
    && [ -f "$TMP/.claude/bin/qualia-ui.js" ] \
    && [ -f "$TMP/.claude/bin/statusline.js" ] \
+   && [ -f "$TMP/.claude/bin/state-ledger.js" ] \
+   && [ -f "$TMP/.claude/bin/contract-runner.js" ] \
+   && [ -f "$TMP/.claude/bin/trust-score.js" ] \
    && [ -f "$TMP/.claude/bin/project-snapshot.js" ] \
+   && [ -f "$TMP/.claude/bin/planning-hygiene.js" ] \
    && [ -f "$TMP/.claude/.qualia-config.json" ]; then
   pass "QS-FAWZI-01 → installs skills, hooks, bin/, config"
 else
@@ -689,6 +695,20 @@ else
   fail_case "rules copied" "count=$RULE_COUNT"
 fi
 
+# 46b. Command output transparency rule installs
+if [ -f "$TMP/.claude/rules/command-output.md" ] && grep -q "alwaysApply: true" "$TMP/.claude/rules/command-output.md"; then
+  pass "command-output rule installs"
+else
+  fail_case "command-output rule missing or not always-on after install"
+fi
+
+# 46c. Complex graphics design substrate installs
+if [ -f "$TMP/.claude/qualia-design/graphics.md" ]; then
+  pass "graphics design substrate installs"
+else
+  fail_case "graphics.md missing after install"
+fi
+
 # 47. Config version matches package.json version
 if grep -q "\"version\": \"$PKG_VERSION\"" "$TMP/.claude/.qualia-config.json"; then
   pass "config version matches package.json ($PKG_VERSION)"
@@ -1204,16 +1224,16 @@ else
 fi
 
 # 105. score.mjs computes pass correctly (all dims >= 3)
-SCORE_OUT=$(echo '{"typography":3,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/score.mjs" 2>&1)
+SCORE_OUT=$(echo '{"typography":3,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3,"graphics":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/score.mjs" 2>&1)
 EXIT=$?
-if [ "$EXIT" -eq 0 ] && echo "$SCORE_OUT" | grep -q '"pass": true'; then
+if [ "$EXIT" -eq 0 ] && echo "$SCORE_OUT" | grep -q '"pass": true' && echo "$SCORE_OUT" | grep -q '"max": 45'; then
   pass "score.mjs pass on all-3 scores"
 else
   fail_case "score.mjs pass computation" "exit=$EXIT"
 fi
 
 # 106. score.mjs computes fail correctly (one dim < 3)
-SCORE_OUT=$(echo '{"typography":2,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/score.mjs" 2>&1)
+SCORE_OUT=$(echo '{"typography":2,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3,"graphics":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/score.mjs" 2>&1)
 EXIT=$?
 if [ "$EXIT" -eq 1 ] && echo "$SCORE_OUT" | grep -q '"pass": false'; then
   pass "score.mjs fail on dim < 3"
@@ -1305,7 +1325,7 @@ for ITER in 1 2 3; do
   "iteration": $ITER,
   "tokens_used": 100,
   "viewport_results": [],
-  "aggregate_scores": {"typography":1,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3},
+  "aggregate_scores": {"typography":1,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3,"graphics":3},
   "top_issues": [{"dim":"typography","severity":"critical","description":"banned font Inter visible","likely_file":"src/styles.css","fix":"replace"}],
   "pass": false
 }
@@ -1352,14 +1372,23 @@ if [ "$EXIT" -eq 0 ] \
    && [ -f "$TMP/.codex/.qualia-config.json" ] \
    && [ -f "$TMP/.codex/config.toml" ] \
    && [ -f "$TMP/.codex/hooks.json" ] \
+   && [ -f "$TMP/.codex/bin/runtime-manifest.js" ] \
+   && [ -f "$TMP/.codex/bin/host-adapters.js" ] \
    && [ -f "$TMP/.codex/bin/statusline.js" ] \
+   && [ -f "$TMP/.codex/bin/state-ledger.js" ] \
+   && [ -f "$TMP/.codex/bin/contract-runner.js" ] \
+   && [ -f "$TMP/.codex/bin/trust-score.js" ] \
    && [ -f "$TMP/.codex/bin/project-snapshot.js" ] \
+   && [ -f "$TMP/.codex/bin/planning-hygiene.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" \
+   && grep -q "status_line" "$TMP/.codex/config.toml" \
+   && grep -q "model-with-reasoning" "$TMP/.codex/config.toml" \
+   && grep -q "task-progress" "$TMP/.codex/config.toml" \
    && 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
@@ -1371,6 +1400,7 @@ 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 "Codex config.toml TUI status_line" "$TMP/doctor.log" \
    && grep -q "All checks passed" "$TMP/doctor.log"; then
   pass "doctor passes for Codex-only install"
 else

package/tests/install-smoke.test.sh

@@ -61,8 +61,12 @@ fi
 
 tar -xzf "$TARBALL_PATH" -C "$TMP" 2>"$TMP/tar.err"
 if [ -f "$TMP/package/bin/install.js" ] \
+  && [ -f "$TMP/package/bin/runtime-manifest.js" ] \
+  && [ -f "$TMP/package/bin/host-adapters.js" ] \
   && [ -f "$TMP/package/bin/report-payload.js" ] \
   && [ -f "$TMP/package/bin/project-snapshot.js" ] \
+  && [ -f "$TMP/package/bin/planning-hygiene.js" ] \
+  && [ -f "$TMP/package/bin/state-ledger.js" ] \
   && [ -f "$TMP/package/AGENTS.md" ] \
   && [ -f "$TMP/package/CLAUDE.md" ]; then
   pass "tarball contains installer + Claude/Codex instruction roots"
@@ -89,14 +93,24 @@ 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/runtime-manifest.js" ] \
+  && [ -f "$HOME_DIR/.codex/bin/host-adapters.js" ] \
   && [ -f "$HOME_DIR/.codex/bin/statusline.js" ] \
+  && [ -f "$HOME_DIR/.codex/bin/state-ledger.js" ] \
+  && [ -f "$HOME_DIR/.codex/bin/contract-runner.js" ] \
+  && [ -f "$HOME_DIR/.codex/bin/trust-score.js" ] \
   && [ -f "$HOME_DIR/.codex/bin/project-snapshot.js" ] \
+  && [ -f "$HOME_DIR/.codex/bin/planning-hygiene.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 "status_line" "$HOME_DIR/.codex/config.toml" \
+  && grep -q "model-with-reasoning" "$HOME_DIR/.codex/config.toml" \
+  && grep -q "task-progress" "$HOME_DIR/.codex/config.toml" \
   && grep -q "pre-deploy-gate.js" "$HOME_DIR/.codex/hooks.json" \
+  && ! grep -R "\${QUALIA_BIN}" "$HOME_DIR/.codex/skills" >/dev/null 2>&1 \
   && ! grep -R "\.claude/bin" "$HOME_DIR/.codex/skills" >/dev/null 2>&1; then
   pass "Codex runtime installed with OWNER role"
 else
@@ -113,10 +127,16 @@ fi
 
 if [ -f "$HOME_DIR/.claude/bin/report-payload.js" ] \
   && [ -f "$HOME_DIR/.claude/bin/project-snapshot.js" ] \
+  && [ -f "$HOME_DIR/.claude/bin/runtime-manifest.js" ] \
+  && [ -f "$HOME_DIR/.claude/bin/host-adapters.js" ] \
+  && [ -f "$HOME_DIR/.claude/bin/state-ledger.js" ] \
+  && [ -f "$HOME_DIR/.claude/bin/contract-runner.js" ] \
+  && [ -f "$HOME_DIR/.claude/bin/trust-score.js" ] \
+  && [ -f "$HOME_DIR/.claude/bin/planning-hygiene.js" ] \
   && grep -q "report-payload.js" "$HOME_DIR/.claude/skills/qualia-report/SKILL.md"; then
-  pass "packaged install includes ERP report/snapshot helpers"
+  pass "packaged install includes ERP report/snapshot + contract helpers"
 else
-  fail_case "packaged install missing ERP report/snapshot helpers"
+  fail_case "packaged install missing ERP report/snapshot/contract helpers"
 fi
 
 PKG_VERSION=$("$NODE" -e "console.log(require(process.argv[1]).version)" "$TMP/package/package.json")