qualia-framework 6.1.0 → 6.2.9

package/skills/qualia-report/SKILL.md

@@ -126,7 +126,7 @@ fi
 ### Step 6 — Upload to ERP
 
 The full payload-builder + 3-attempt-retry logic lives unchanged from v4 — see the **ERP Upload** section below for the canonical implementation. Behavior summary:
-- ERP disabled in config → skip silently, note local commit
+- ERP disabled in config → skip upload with an info line, note local commit
 - API key missing → warn with self-service fix instructions, skip upload
 - 401/422 → permanent failure, no retry, tell employee to ask Fawzi
 - Transient (timeout/5xx) → 3 attempts with 1s/3s/9s backoff
@@ -149,7 +149,7 @@ node ~/.claude/bin/qualia-ui.js info "Shift report submitted. You can clock out
 | Symptom | Likely cause | Self-service fix |
 |---|---|---|
 | "Could not allocate report ID" | tracking.json missing/corrupt | `cat .planning/tracking.json` to inspect, or restore from `git checkout HEAD -- .planning/tracking.json` |
-| "ERP API key missing" | `~/.claude/.erp-api-key` empty | `qualia-framework set-erp-key <key>` (ask Fawzi for the key) |
+| "ERP API key missing" | `~/.claude/.erp-api-key` empty | `printf '%s' "$QUALIA_ERP_KEY" \| qualia-framework set-erp-key` (ask Fawzi for the key) |
 | "ERP auth failed (401)" | Key revoked or wrong | Ask Fawzi for a fresh key |
 | "ERP upload failed after 3 attempts" | ERP down or network issue | Local commit is safe. Re-run `/qualia-report` later. |
 | "git push failed" | Auth or network or upstream issue | `git push` manually, see the error, fix, re-run |
@@ -181,53 +181,16 @@ IDEMPOTENCY_KEY=$(node -e "
 
 # Guard: API key required for upload (otherwise curl posts an empty bearer)
 if [ "$ERP_ENABLED" = "true" ] && [ -z "$API_KEY" ] && [ "$DRY_RUN" != "true" ]; then
-  node ~/.claude/bin/qualia-ui.js warn "ERP API key missing (~/.claude/.erp-api-key). Run: qualia-framework set-erp-key <key>"
+  node ~/.claude/bin/qualia-ui.js warn "ERP API key missing (~/.claude/.erp-api-key). Run: printf '%s' \"\$QUALIA_ERP_KEY\" | qualia-framework set-erp-key"
   ERP_ENABLED="false"
 fi
 
-# Build payload (env-var-passed user values to dodge shell escaping)
+# Build payload (env-var-passed user values to dodge shell escaping).
+# `report-payload.js` is the canonical, tested Framework -> ERP payload builder.
 PAYLOAD=$(
   SUBMITTED_BY="$SUBMITTED_BY" SUBMITTED_AT="$SUBMITTED_AT" \
   CLIENT_REPORT_ID="$CLIENT_REPORT_ID" REPORT_FILE="$REPORT_FILE" \
-  node -e "
-    const fs=require('fs'),path=require('path'),os=require('os');
-    const {spawnSync}=require('child_process');
-    const git=(a)=>{const r=spawnSync('git',a,{encoding:'utf8',timeout:3000});return r.status===0?r.stdout.trim():'';};
-    const repoSlug=(r)=>(r||'').replace(/^git@github\\.com:/,'github.com/').replace(/^https?:\\/\\//,'').replace(/\\.git$/,'').split('/').filter(Boolean).pop();
-    let config={};try{config=JSON.parse(fs.readFileSync(path.join(os.homedir(),'.claude/.qualia-config.json'),'utf8'));}catch{}
-    const t=JSON.parse(fs.readFileSync('.planning/tracking.json','utf8'));
-    const notes=fs.readFileSync(process.env.REPORT_FILE,'utf8').substring(0,60000);
-    const commits=[];try{const r=spawnSync('git',['log','--oneline','--since=8 hours ago','--format=%h'],{encoding:'utf8',timeout:3000});if(r.stdout)commits.push(...r.stdout.trim().split('\n').filter(Boolean));}catch{}
-    const gitRemote=t.git_remote||git(['config','--get','remote.origin.url']);
-    const projectKey=t.project_id||repoSlug(gitRemote)||require('path').basename(process.cwd());
-    // Session duration: minutes from session_started_at to submitted_at. The ERP's
-    // example payload (docs/erp-contract.md:93) includes this; without it the ERP
-    // can't compute shift-length analytics without parsing notes.
-    let sessionDurationMinutes=0;
-    if(t.session_started_at){
-      const startMs=Date.parse(t.session_started_at);
-      const endMs=Date.parse(process.env.SUBMITTED_AT)||Date.now();
-      if(!Number.isNaN(startMs)&&endMs>startMs){
-        sessionDurationMinutes=Math.round((endMs-startMs)/60000);
-      }
-    }
-    console.log(JSON.stringify({
-      project:t.project||require('path').basename(process.cwd()),
-      project_id:projectKey,team_id:t.team_id||'qualia-solutions',git_remote:gitRemote,
-      client:t.client||'',client_report_id:process.env.CLIENT_REPORT_ID,
-      framework_version:config.version||'',milestone:t.milestone||1,
-      milestone_name:t.milestone_name||'',milestones:Array.isArray(t.milestones)?t.milestones:[],
-      phase:t.phase,phase_name:t.phase_name,total_phases:t.total_phases,status:t.status,
-      tasks_done:t.tasks_done||0,tasks_total:t.tasks_total||0,verification:t.verification||'pending',
-      gap_cycles:(t.gap_cycles||{})[String(t.phase)]||0,build_count:t.build_count||0,
-      deploy_count:t.deploy_count||0,deployed_url:t.deployed_url||'',
-      ...(t.session_started_at?{session_started_at:t.session_started_at}:{}),
-      ...(t.last_pushed_at?{last_pushed_at:t.last_pushed_at}:{}),
-      session_duration_minutes:sessionDurationMinutes,
-      lifetime:t.lifetime||{},commits:commits,notes:notes,
-      submitted_by:process.env.SUBMITTED_BY||'unknown',submitted_at:process.env.SUBMITTED_AT
-    }));
-  "
+  node ~/.claude/bin/report-payload.js
 )
 
 # --dry-run: print and stop

package/skills/qualia-road/SKILL.md

@@ -117,7 +117,7 @@ No accumulated garbage. No context rot.
 - **Intent verification** — Confirm before modifying 3+ files (OWNER role: just do it)
 
 ## Tracking
-`.planning/tracking.json` is updated on every push. The ERP reads it via git.
+`.planning/tracking.json` is updated locally on every push. It feeds statusline, stop-session-log, and `/qualia-report`; the ERP receives explicit report uploads and does not read this file from git.
 Never edit tracking.json manually — hooks update it from STATE.md.
 
 ## Compaction — ALWAYS preserve

package/skills/qualia-verify/SKILL.md

@@ -106,7 +106,7 @@ Findings merge into main report. Union PASS/FAIL: either pass found CRITICAL/HIG
 
 ### 2d. INSUFFICIENT EVIDENCE downgrade (mandatory)
 
-The verifier marks criteria it could not check (budget exhaustion, missing context) as `INSUFFICIENT EVIDENCE`. The orchestrator treats those as silent PASS unless explicitly downgraded — that's the #1 false-pass vector. Grep the verification file before declaring PASS:
+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)

package/templates/help.html

@@ -437,7 +437,7 @@
         <div class="cmd"><span class="cmd-name">qualia-framework install</span><span class="cmd-desc">Install or reinstall the framework.</span></div>
         <div class="cmd"><span class="cmd-name">qualia-framework update</span><span class="cmd-desc">Update to the latest version.</span></div>
         <div class="cmd"><span class="cmd-name">qualia-framework version</span><span class="cmd-desc">Show installed version + check for updates.</span></div>
-        <div class="cmd"><span class="cmd-name">qualia-framework uninstall</span><span class="cmd-desc">Clean removal from ~/.claude/ while preserving user-owned settings.</span></div>
+        <div class="cmd"><span class="cmd-name">qualia-framework uninstall</span><span class="cmd-desc">Clean removal from installed Claude/Codex homes while preserving user-owned settings.</span></div>
         <div class="cmd"><span class="cmd-name">qualia-framework migrate</span><span class="cmd-desc">Upgrade legacy settings.json to the current hook layout.</span></div>
         <div class="cmd"><span class="cmd-name">qualia-framework analytics</span><span class="cmd-desc">Hook telemetry, verification pass rates, gap cycles.</span></div>
         <div class="cmd"><span class="cmd-name">qualia-framework set-erp-key</span><span class="cmd-desc">Save and enable the ERP API key.</span></div>

package/templates/knowledge/agents.md

@@ -6,11 +6,11 @@ once at session start.
 
 ## What's here
 
-`~/.claude/knowledge/` is the project-spanning memory tier. It holds three
+The installed `knowledge/` directory is the project-spanning memory tier. It holds three
 kinds of files, each with a clear purpose. Treat the structure as a contract.
 
 ```
-~/.claude/knowledge/
+knowledge/
 ├── agents.md              ← this file (system overview)
 ├── index.md               ← entry point — start here when answering questions
 ├── daily-log/
@@ -43,7 +43,7 @@ kinds of files, each with a clear purpose. Treat the structure as a contract.
 **Do not pretend something is in memory if it is not.** Better to say
 "INSUFFICIENT EVIDENCE: searched index.md and learned-patterns.md, no entry
 matches" than to hallucinate a recalled pattern. The grounding protocol
-(`~/.claude/rules/grounding.md`) applies here too.
+(`rules/grounding.md`) applies here too.
 
 ## Tiers
 

package/templates/knowledge/index.md

@@ -1,6 +1,6 @@
 # Knowledge Index
 
-Entry point for `~/.claude/knowledge/`. When answering a question, **read this
+Entry point for the installed `knowledge/` directory. When answering a question, **read this
 file first**, then jump to the specific file(s) that match.
 
 > Auto-maintained by `/qualia-learn`. Do not hand-edit unless the file is out

package/templates/tracking.json

@@ -5,6 +5,9 @@
   "assigned_to": "",
   "team_id": "",
   "project_id": "",
+  "erp_project_id": "",
+  "client_id": "",
+  "workspace_id": "",
   "git_remote": "",
   "milestone": 1,
   "milestone_name": "",

package/templates/work-packet.md

@@ -0,0 +1,46 @@
+# Work Packet — {{PROJECT_NAME}}
+
+Purpose: ERP-approved context for the next Framework session. This is the handoff from operations/control into Claude Code or Codex execution.
+
+## Source
+
+- ERP project:
+- ERP project ID (UUID):
+- Client:
+- Client ID (UUID):
+- Workspace ID (UUID):
+- Git remote:
+- Assigned to:
+- Prepared by:
+- Prepared at:
+
+## Current Truth
+
+- Current milestone:
+- Current phase:
+- Open blocker:
+- Latest report:
+- Deadline:
+- Client-visible status:
+
+## Approved Work
+
+1. 
+2. 
+3. 
+
+## Guardrails
+
+- Do not change deadlines, project status, or client-visible updates without approval.
+- Do not treat chat transcripts as final truth unless the ERP record confirms them.
+- Use Framework `.planning/` for execution state; use ERP as the operational source of truth.
+
+## Memory Context
+
+- Relevant client preferences:
+- Reusable lessons:
+- Known mistakes to avoid:
+
+## Next Framework Command
+
+`/qualia`