qualia-framework 6.2.9 → 6.3.0

package/bin/trust-score.js

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+// Qualia trust score — compact harness health summary.
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const pc = require("./plan-contract.js");
+const ledger = require("./state-ledger.js");
+const { binFiles } = require("./runtime-manifest.js");
+const { ACTIVE_SKILLS } = require("./command-surface.js");
+
+const HOMES = [
+  { name: "Claude", dir: path.join(os.homedir(), ".claude") },
+  { name: "Codex", dir: path.join(os.homedir(), ".codex") },
+];
+
+const REQUIRED_BIN = binFiles();
+
+const REQUIRED_HOOKS = [
+  "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",
+];
+
+const REQUIRED_DESIGN_FILES = [
+  "design-laws.md",
+  "design-rubric.md",
+  "design-brand.md",
+  "design-product.md",
+  "design-reference.md",
+  "frontend.md",
+  "graphics.md",
+];
+
+const REQUIRED_EMPLOYEE_SKILLS = ACTIVE_SKILLS;
+
+function exists(p) {
+  try { return fs.existsSync(p); } catch { return false; }
+}
+function readJson(p) {
+  try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch { return null; }
+}
+function readText(p) {
+  try { return fs.readFileSync(p, "utf8"); } catch { return ""; }
+}
+
+function installedHomes() {
+  return HOMES.filter((h) => exists(path.join(h.dir, ".qualia-config.json")));
+}
+
+function inspectInstall(homes) {
+  if (homes.length === 0) {
+    return { status: "fail", score: 0, issues: ["no Qualia install config found"], targets: [] };
+  }
+  const issues = [];
+  for (const home of homes) {
+    for (const f of REQUIRED_BIN) {
+      if (!exists(path.join(home.dir, "bin", f))) issues.push(`${home.name}: missing bin/${f}`);
+    }
+    if (home.name === "Claude") {
+      if (!exists(path.join(home.dir, "CLAUDE.md"))) issues.push("Claude: missing CLAUDE.md");
+      if (!exists(path.join(home.dir, "settings.json"))) issues.push("Claude: missing settings.json");
+    } else {
+      if (!exists(path.join(home.dir, "AGENTS.md"))) issues.push("Codex: missing AGENTS.md");
+      if (!exists(path.join(home.dir, "hooks.json"))) issues.push("Codex: missing hooks.json");
+      if (!exists(path.join(home.dir, "config.toml"))) issues.push("Codex: missing config.toml");
+    }
+  }
+  return {
+    status: issues.length ? "degraded" : "pass",
+    score: issues.length ? Math.max(6, 20 - issues.length * 2) : 20,
+    issues,
+    targets: homes.map((h) => h.name),
+  };
+}
+
+function inspectHooks(homes) {
+  if (homes.length === 0) return { status: "fail", score: 0, issues: ["no install targets"] };
+  const issues = [];
+  for (const home of homes) {
+    for (const h of REQUIRED_HOOKS) {
+      if (!exists(path.join(home.dir, "hooks", h))) issues.push(`${home.name}: missing hooks/${h}`);
+    }
+  }
+  return {
+    status: issues.length ? "degraded" : "pass",
+    score: issues.length ? Math.max(4, 12 - issues.length) : 12,
+    issues,
+  };
+}
+
+function inspectProject(cwd) {
+  const planning = path.join(cwd, ".planning");
+  if (!exists(planning)) return { status: "not_applicable", score: 12, issues: [], phase: null };
+  const tracking = readJson(path.join(planning, "tracking.json"));
+  const stateText = readText(path.join(planning, "STATE.md"));
+  const issues = [];
+  if (!tracking) issues.push("tracking.json missing or invalid");
+  if (!stateText) issues.push("STATE.md missing");
+  const phaseMatch = stateText.match(/^Phase:\s*(\d+)/m);
+  const statusMatch = stateText.match(/^Status:\s*(.+)$/m);
+  const phase = phaseMatch ? Number(phaseMatch[1]) : (tracking && Number(tracking.phase)) || 1;
+  if (!phaseMatch && stateText) issues.push("STATE.md phase header missing");
+  if (!statusMatch && stateText) issues.push("STATE.md status missing");
+  return {
+    status: issues.length ? "degraded" : "pass",
+    score: issues.length ? Math.max(4, 12 - issues.length * 4) : 12,
+    issues,
+    phase,
+    project_status: statusMatch ? statusMatch[1].trim() : tracking?.status || "",
+  };
+}
+
+function inspectContracts(cwd, phase) {
+  const planning = path.join(cwd, ".planning");
+  if (!exists(planning) || !phase) return { status: "not_applicable", score: 18, issues: [] };
+  const planPath = path.join(planning, `phase-${phase}-plan.md`);
+  const contractPath = path.join(planning, `phase-${phase}-contract.json`);
+  if (!exists(planPath)) return { status: "not_applicable", score: 18, issues: [] };
+  if (!exists(contractPath)) return { status: "degraded", score: 6, issues: [`phase ${phase}: JSON contract missing`] };
+  const loaded = pc.readContractFile(contractPath);
+  if (!loaded.ok) return { status: "fail", score: 0, issues: [`phase ${phase}: contract unreadable (${loaded.message || loaded.error})`] };
+  const errors = pc.validate(loaded.contract);
+  if (errors.length) return { status: "fail", score: 0, issues: [`phase ${phase}: contract invalid (${errors.length} issue(s))`] };
+  const drift = pc.checkDrift(contractPath, planPath);
+  if (drift.ok && drift.drift) return { status: "fail", score: 0, issues: [`phase ${phase}: contract drifted from plan`] };
+  return { status: "pass", score: 18, issues: [], contract: path.relative(cwd, contractPath) };
+}
+
+function inspectLedger(cwd) {
+  const planning = path.join(cwd, ".planning");
+  if (!exists(planning)) return { status: "not_applicable", score: 10, issues: [] };
+  const file = ledger.ledgerPath(cwd);
+  if (!exists(file)) return { status: "degraded", score: 4, issues: ["state ledger missing"] };
+  const result = ledger.validate(cwd);
+  if (!result.ok) return { status: "fail", score: 0, issues: result.errors };
+  if (result.count === 0) return { status: "degraded", score: 4, issues: ["state ledger empty"] };
+  return { status: "pass", score: 10, issues: [], events: result.count };
+}
+
+function inspectMemory(homes) {
+  if (homes.length === 0) return { status: "fail", score: 0, issues: ["no install targets"] };
+  const issues = [];
+  for (const home of homes) {
+    if (!exists(path.join(home.dir, "knowledge", "index.md"))) issues.push(`${home.name}: missing knowledge/index.md`);
+    if (!exists(path.join(home.dir, "knowledge", "agents.md"))) issues.push(`${home.name}: missing knowledge/agents.md`);
+    if (!exists(path.join(home.dir, "knowledge", "daily-log"))) issues.push(`${home.name}: missing knowledge/daily-log`);
+  }
+  return {
+    status: issues.length ? "degraded" : "pass",
+    score: issues.length ? Math.max(2, 5 - issues.length) : 5,
+    issues,
+  };
+}
+
+function inspectDesign(homes) {
+  if (homes.length === 0) return { status: "fail", score: 0, issues: ["no install targets"] };
+  const issues = [];
+  for (const home of homes) {
+    for (const f of REQUIRED_DESIGN_FILES) {
+      if (!exists(path.join(home.dir, "qualia-design", f))) issues.push(`${home.name}: missing qualia-design/${f}`);
+    }
+    if (!exists(path.join(home.dir, "skills", "qualia-polish", "SKILL.md"))) {
+      issues.push(`${home.name}: missing qualia-polish skill`);
+    }
+    if (!exists(path.join(home.dir, "agents", home.name === "Codex" ? "visual-evaluator.toml" : "visual-evaluator.md"))) {
+      issues.push(`${home.name}: missing visual-evaluator agent`);
+    }
+    if (!exists(path.join(home.dir, "bin", "slop-detect.mjs"))) {
+      issues.push(`${home.name}: missing slop-detect.mjs`);
+    }
+  }
+  return {
+    status: issues.length ? "degraded" : "pass",
+    score: issues.length ? Math.max(2, 8 - issues.length) : 8,
+    issues,
+  };
+}
+
+function inspectEmployeeExperience(homes) {
+  if (homes.length === 0) return { status: "fail", score: 0, issues: ["no install targets"] };
+  const issues = [];
+  for (const home of homes) {
+    for (const skill of REQUIRED_EMPLOYEE_SKILLS) {
+      if (!exists(path.join(home.dir, "skills", skill, "SKILL.md"))) issues.push(`${home.name}: missing ${skill} skill`);
+    }
+    if (!exists(path.join(home.dir, "qualia-guide.md"))) issues.push(`${home.name}: missing qualia-guide.md`);
+    if (!exists(path.join(home.dir, "qualia-templates", "help.html"))) issues.push(`${home.name}: missing help.html`);
+  }
+  return {
+    status: issues.length ? "degraded" : "pass",
+    score: issues.length ? Math.max(1, 5 - issues.length) : 5,
+    issues,
+  };
+}
+
+function inspectErp(homes) {
+  if (homes.length === 0) return { status: "not_applicable", score: 10, issues: [] };
+  const issues = [];
+  let enabled = false;
+  let queueCount = 0;
+  for (const home of homes) {
+    const cfg = readJson(path.join(home.dir, ".qualia-config.json")) || {};
+    if (cfg.erp && cfg.erp.enabled !== false) {
+      enabled = true;
+      const keyFile = path.join(home.dir, cfg.erp.api_key_file || ".erp-api-key");
+      if (!exists(keyFile)) issues.push(`${home.name}: ERP enabled but API key missing`);
+    }
+    const queue = readJson(path.join(home.dir, ".erp-retry-queue.json"));
+    if (Array.isArray(queue)) queueCount += queue.length;
+  }
+  if (!enabled) return { status: "not_applicable", score: 10, issues: [], queue_count: queueCount };
+  if (queueCount > 0) issues.push(`ERP retry queue has ${queueCount} item(s)`);
+  return {
+    status: issues.length ? "degraded" : "pass",
+    score: issues.length ? Math.max(3, 10 - issues.length * 3) : 10,
+    issues,
+    queue_count: queueCount,
+  };
+}
+
+function buildTrustScore(cwd = process.cwd()) {
+  const homes = installedHomes();
+  const install = inspectInstall(homes);
+  const hooks = inspectHooks(homes);
+  const project = inspectProject(cwd);
+  const contracts = inspectContracts(cwd, project.phase);
+  const state_ledger = inspectLedger(cwd);
+  const memory = inspectMemory(homes);
+  const erp = inspectErp(homes);
+  const design = inspectDesign(homes);
+  const employee_experience = inspectEmployeeExperience(homes);
+  const checks = { install, hooks, project, contracts, state_ledger, memory, erp, design, employee_experience };
+  const score = Math.max(0, Math.min(100, Object.values(checks).reduce((n, c) => n + (c.score || 0), 0)));
+  const failCount = Object.values(checks).filter((c) => c.status === "fail").length;
+  const degradedCount = Object.values(checks).filter((c) => c.status === "degraded").length;
+  const status = failCount ? "FAIL" : degradedCount ? "DEGRADED" : "PASS";
+  return { ok: failCount === 0, status, score, generated_at: new Date().toISOString(), checks };
+}
+
+function printHuman(result) {
+  console.log(`Trust score: ${result.score}/100 (${result.status})`);
+  for (const [name, check] of Object.entries(result.checks)) {
+    const label = `${name[0].toUpperCase()}${name.slice(1)}`;
+    console.log(`${label}: ${check.status} (${check.score})`);
+    for (const issue of check.issues || []) console.log(`  - ${issue}`);
+  }
+}
+
+function main(argv) {
+  const result = buildTrustScore(process.cwd());
+  if (argv.includes("--json")) console.log(JSON.stringify(result, null, 2));
+  else printHuman(result);
+  return result.status === "FAIL" ? 1 : 0;
+}
+
+module.exports = {
+  buildTrustScore,
+  inspectInstall,
+  inspectProject,
+  inspectContracts,
+  inspectLedger,
+  inspectDesign,
+  inspectEmployeeExperience,
+};
+
+if (require.main === module) process.exit(main(process.argv));

package/bin/work-packet.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+const fs = require("fs");
+const http = require("http");
+const https = require("https");
+const os = require("os");
+const path = require("path");
+
+const WORK_PACKET_FILE = path.join(".planning", "work-packet.json");
+
+function readJson(file, fallback = {}) {
+  try {
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+  } catch {
+    return fallback;
+  }
+}
+
+function readText(file, fallback = "") {
+  try {
+    return fs.readFileSync(file, "utf8");
+  } catch {
+    return fallback;
+  }
+}
+
+function qualiaHome(home = os.homedir()) {
+  if (process.env.QUALIA_HOME) return process.env.QUALIA_HOME;
+  const parent = path.basename(path.dirname(__dirname));
+  if (parent === ".codex" || parent === ".claude") return path.dirname(__dirname);
+  const claude = path.join(home, ".claude");
+  if (fs.existsSync(path.join(claude, ".qualia-config.json"))) return claude;
+  return claude;
+}
+
+function uuid(value) {
+  if (typeof value !== "string") return "";
+  const trimmed = value.trim();
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(trimmed)
+    ? trimmed
+    : "";
+}
+
+function localWorkPacketPath(cwd = process.cwd()) {
+  return path.join(cwd, WORK_PACKET_FILE);
+}
+
+function normalizePacket(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
+  const packet = raw.work_packet && typeof raw.work_packet === "object" ? raw.work_packet : raw;
+  if (!packet || typeof packet !== "object" || Array.isArray(packet)) return null;
+  const id = uuid(packet.id || packet.work_packet_id);
+  const projectId = uuid(packet.project_id || packet.erp_project_id);
+  if (!id || !projectId) return null;
+  return {
+    id,
+    project_id: projectId,
+    assignment_id: uuid(packet.assignment_id) || null,
+    employee_id: uuid(packet.employee_id) || null,
+    deadline_date: typeof packet.deadline_date === "string" ? packet.deadline_date : null,
+    current_milestone: Number.isFinite(packet.current_milestone) ? packet.current_milestone : null,
+    current_milestone_name:
+      typeof packet.current_milestone_name === "string" ? packet.current_milestone_name : null,
+    current_phase: Number.isFinite(packet.current_phase) ? packet.current_phase : null,
+    current_phase_name: typeof packet.current_phase_name === "string" ? packet.current_phase_name : null,
+    next_command: typeof packet.next_command === "string" ? packet.next_command : "/qualia",
+    definition_of_done:
+      typeof packet.definition_of_done === "string" ? packet.definition_of_done : null,
+    blockers: Array.isArray(packet.blockers) ? packet.blockers.filter((b) => typeof b === "string") : [],
+    repo_url: typeof packet.repo_url === "string" ? packet.repo_url : null,
+    vercel_url: typeof packet.vercel_url === "string" ? packet.vercel_url : null,
+    framework_status:
+      typeof packet.framework_status === "string" ? packet.framework_status : null,
+    verification: typeof packet.verification === "string" ? packet.verification : null,
+    snapshot_generated_at:
+      typeof packet.snapshot_generated_at === "string" ? packet.snapshot_generated_at : null,
+    last_report_at: typeof packet.last_report_at === "string" ? packet.last_report_at : null,
+    status: typeof packet.status === "string" ? packet.status : "active",
+    updated_at: typeof packet.updated_at === "string" ? packet.updated_at : null,
+    employee: packet.employee && typeof packet.employee === "object" ? packet.employee : null,
+    project: packet.project && typeof packet.project === "object" ? packet.project : null,
+    mission_url: typeof packet.mission_url === "string" ? packet.mission_url : null,
+  };
+}
+
+function readLocalWorkPacket(cwd = process.cwd()) {
+  return normalizePacket(readJson(localWorkPacketPath(cwd), null));
+}
+
+function writeLocalWorkPacket(packet, options = {}) {
+  const cwd = options.cwd || process.cwd();
+  const file = options.file || localWorkPacketPath(cwd);
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, `${JSON.stringify(packet, null, 2)}\n`);
+  return file;
+}
+
+function erpConfig(options = {}) {
+  const home = options.home || os.homedir();
+  const installHome = options.qualiaHome || qualiaHome(home);
+  const config = readJson(path.join(installHome, ".qualia-config.json"), {});
+  const erp = config.erp || {};
+  const url = (erp.url || "https://portal.qualiasolutions.net").replace(/\/+$/, "");
+  const keyFile = path.join(installHome, erp.api_key_file || ".erp-api-key");
+  const key = readText(keyFile, "").trim();
+  return {
+    enabled: erp.enabled !== false,
+    url,
+    key,
+  };
+}
+
+function trackingProjectId(cwd = process.cwd()) {
+  const tracking = readJson(path.join(cwd, ".planning", "tracking.json"), {});
+  return uuid(tracking.erp_project_id);
+}
+
+function fetchJson(url, key, options = {}) {
+  const endpoint = new URL(url);
+  const transport = endpoint.protocol === "http:" ? http : https;
+  return new Promise((resolve, reject) => {
+    const req = transport.request(
+      endpoint,
+      {
+        method: "GET",
+        headers: {
+          Authorization: `Bearer ${key}`,
+          Accept: "application/json",
+          "User-Agent": "qualia-framework-work-packet",
+        },
+        timeout: options.timeout || 15000,
+      },
+      (res) => {
+        let body = "";
+        res.setEncoding("utf8");
+        res.on("data", (chunk) => {
+          body += chunk;
+        });
+        res.on("end", () => {
+          let parsed = null;
+          try {
+            parsed = body ? JSON.parse(body) : null;
+          } catch {
+            parsed = body;
+          }
+          if (res.statusCode >= 200 && res.statusCode < 300) {
+            resolve(parsed);
+          } else {
+            const message =
+              parsed && typeof parsed === "object" && parsed.message
+                ? parsed.message
+                : body || `HTTP ${res.statusCode}`;
+            reject(new Error(`ERP work packet pull failed (${res.statusCode}): ${message}`));
+          }
+        });
+      }
+    );
+    req.on("timeout", () => req.destroy(new Error("ERP work packet pull timed out")));
+    req.on("error", reject);
+    req.end();
+  });
+}
+
+async function pullWorkPacket(options = {}) {
+  const cwd = options.cwd || process.cwd();
+  const cfg = options.erp || erpConfig(options);
+  if (!cfg.enabled) throw new Error("ERP disabled in Qualia config");
+  if (!cfg.key) throw new Error("ERP API key missing in Qualia install");
+  const projectId = uuid(options.projectId) || trackingProjectId(cwd);
+  if (!projectId) {
+    throw new Error("ERP project UUID required. Pass --project <uuid> or set tracking.erp_project_id");
+  }
+  const endpoint = new URL("/api/v1/work-packets", cfg.url);
+  endpoint.searchParams.set("project_id", projectId);
+  const response = await fetchJson(endpoint.toString(), cfg.key, options);
+  const packet = normalizePacket(response);
+  if (!packet) throw new Error("ERP returned an invalid work packet");
+  return packet;
+}
+
+function parseArgs(argv) {
+  const args = {
+    action: "show",
+    projectId: "",
+    write: false,
+    pretty: false,
+    output: "",
+  };
+  const rest = [...argv];
+  if (rest[0] && !rest[0].startsWith("-")) args.action = rest.shift();
+  for (let i = 0; i < rest.length; i += 1) {
+    const arg = rest[i];
+    if (arg === "--project" || arg === "-p") args.projectId = rest[++i] || "";
+    else if (arg === "--write") args.write = true;
+    else if (arg === "--pretty") args.pretty = true;
+    else if (arg === "--output" || arg === "-o") args.output = rest[++i] || "";
+  }
+  return args;
+}
+
+if (require.main === module) {
+  (async () => {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.action === "pull") {
+      const packet = await pullWorkPacket({ projectId: args.projectId });
+      const file = writeLocalWorkPacket(packet, { file: args.output || undefined });
+      process.stdout.write(args.pretty ? `${JSON.stringify(packet, null, 2)}\n` : `${file}\n`);
+      return;
+    }
+    const packet = readLocalWorkPacket();
+    if (!packet) throw new Error("No local .planning/work-packet.json found");
+    process.stdout.write(`${JSON.stringify(packet, null, args.pretty ? 2 : 0)}\n`);
+  })().catch((error) => {
+    console.error(`work-packet failed: ${error.message}`);
+    process.exit(1);
+  });
+}
+
+module.exports = {
+  WORK_PACKET_FILE,
+  erpConfig,
+  localWorkPacketPath,
+  normalizePacket,
+  pullWorkPacket,
+  readLocalWorkPacket,
+  trackingProjectId,
+  uuid,
+  writeLocalWorkPacket,
+};

package/docs/erp-contract.md

@@ -31,6 +31,29 @@ The API key is read from `.erp-api-key` in the same install home (file mode 0600
 
 ## Endpoints
 
+### POST /api/v1/policy-events
+
+Silently record framework policy violations that should not interrupt the
+employee's active session, such as proxy owner-approval claims ("Fawzi said OK").
+
+**Request Body:**
+```json
+{
+  "type": "proxy_owner_approval_claim",
+  "actor_code": "QS-HASAN-02",
+  "actor_name": "Hasan",
+  "actor_role": "EMPLOYEE",
+  "count": 3,
+  "sample": "Fawzi said ok",
+  "project": "client-project",
+  "cwd": "/path/to/client-project",
+  "recorded_at": "2026-05-23T10:00:00.000Z"
+}
+```
+
+The ERP should increment or store by `(type, actor_code)` so Fawzi can see how
+many times each employee attempted to use proxy approval.
+
 ### POST /api/v1/reports
 
 Upload a session report.
@@ -59,6 +82,9 @@ below).
   "team_id": "qualia-solutions",
   "workspace_id": "2af02a2d-6f1f-4d43-a6cb-6a1e7e09ac43",
   "git_remote": "github.com/QualiasolutionsCY/acme-portal",
+  "work_packet_id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
+  "assignment_id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
+  "assignment_deadline": "2026-06-01",
   "client": "Client Name",
   "client_report_id": "QS-REPORT-03",
   "milestone": 2,
@@ -90,6 +116,13 @@ below).
     "total_phases": 8,
     "last_closed_milestone": 1
   },
+  "harness_eval": {
+    "status": "PASS",
+    "score": 92,
+    "phase": 2,
+    "generated_at": "2026-05-23T10:15:00.000Z",
+    "artifact": ".planning/evals/harness-eval-2026-05-23T10-15-00-000Z.json"
+  },
   "session_started_at": "2026-04-12T13:45:00Z",
   "session_duration_minutes": 45,
   "last_pushed_at": "2026-04-12T14:25:00Z",
@@ -173,6 +206,37 @@ Authorization: Bearer <api-key>
 }
 ```
 
+## Work Packet Pull
+
+`qualia-framework work-packet pull --project <erp_project_id>` reads the active
+ERP mission packet and writes it to:
+
+```text
+.planning/work-packet.json
+```
+
+The Framework treats this as session context, not as a new source of business
+truth. ERP owns the employee, deadline, assignment, review state, and owner
+approval. Framework owns build, verification, snapshot, and report proof.
+
+Local packet shape:
+
+```json
+{
+  "id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
+  "project_id": "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef",
+  "assignment_id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
+  "deadline_date": "2026-06-01",
+  "next_command": "/qualia-verify",
+  "mission_url": "https://portal.qualiasolutions.net/projects/7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef/mission"
+}
+```
+
+Session start reads this file and shows the ERP deadline + next Framework
+command. `/qualia-report` sends `work_packet_id`, `assignment_id`, and
+`assignment_deadline`; project snapshots include the same fields under
+`identifiers`.
+
 ## Project Snapshot Export
 
 `qualia-framework project-snapshot --write` creates a local project-level rollup at:
@@ -206,7 +270,10 @@ Snapshot shape:
     "team_id": "qualia-solutions",
     "git_remote": "github.com/QualiasolutionsCY/acme-portal",
     "erp_project_id": "7b5d3b4e-2b8a-4de4-91a1-9b2f3182f5ef",
-    "client_id": "5f5a8d8e-8c58-4c30-9b76-13a08f0d0d8a"
+    "client_id": "5f5a8d8e-8c58-4c30-9b76-13a08f0d0d8a",
+    "work_packet_id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
+    "assignment_id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
+    "assignment_deadline": "2026-06-01"
   },
   "project": {
     "name": "acme-portal",
@@ -226,6 +293,15 @@ Snapshot shape:
     "verification": "pending",
     "gap_cycles": 1
   },
+  "quality": {
+    "harness_eval": {
+      "status": "PASS",
+      "score": 92,
+      "phase": 2,
+      "generated_at": "2026-05-23T10:15:00.000Z",
+      "artifact": ".planning/evals/harness-eval-2026-05-23T10-15-00-000Z.json"
+    }
+  },
   "journey": {
     "total_milestones": 3,
     "milestones": [
@@ -287,11 +363,15 @@ Snapshot shape:
 | milestone_name | string | recommended (v4+) | Human name of the current milestone — from JOURNEY.md / tracking.json |
 | milestones | array | recommended (v4+) | Array of closed milestone summaries: `{num, name, closed_at, phases_completed, tasks_completed}`. Renders the journey tree on the ERP. |
 | lifetime | object | recommended | Cumulative counters — tasks_completed, phases_completed, milestones_completed, total_phases, last_closed_milestone |
+| harness_eval | object | recommended (v6.3+) | Latest deterministic harness eval summary: status, score, phase, generated_at, and local artifact path. |
 | project_id | string | recommended (v3.6+) | Stable per-project identifier — preferred dedupe key over `project` slug. Survives directory renames. |
 | team_id | string | recommended (v3.6+) | Installation's team identifier. Composite `(team_id, project_id)` is the canonical project key. |
 | erp_project_id | UUID string | optional | ERP's canonical project UUID when known. Strongest direct link for admin dashboards; `/qualia-report` only sends UUID-shaped values. |
 | client_id | UUID string | optional | ERP/client canonical UUID when known. Lets reports attach to the client without guessing from a display name; slug-like values are omitted to avoid ERP validation failures. |
 | workspace_id | UUID string | optional | Workspace/tenant scope for multi-company or multi-team installs; only UUID-shaped values are sent. |
+| work_packet_id | UUID string | optional (v6.3+) | ERP `project_work_packets.id` read from `.planning/work-packet.json`. Links the report to the exact employee mission packet. |
+| assignment_id | UUID string | optional (v6.3+) | ERP `project_assignments.id` read from `.planning/work-packet.json`. Links the report to the assignment/deadline owner. |
+| assignment_deadline | date string | optional (v6.3+) | ERP-owned assignment deadline (`YYYY-MM-DD`) active when the report was submitted. |
 | git_remote | string | optional (v3.6+) | e.g. `github.com/QualiasolutionsCY/foo`. Lets the ERP correlate tracking with the source repo. |
 | session_started_at | string | optional (v3.6+) | ISO 8601 — when the current Claude Code session began. |
 | last_pushed_at | string | optional (v3.6+) | ISO 8601 — distinct from `last_updated` (which fires on local writes too). |