qualia-framework-v2 2.9.0 → 3.0.0

package/bin/install.js

@@ -13,8 +13,11 @@ const YELLOW = "\x1b[38;2;234;179;8m";
 const RED = "\x1b[38;2;239;68;68m";
 const RESET = "\x1b[0m";
 
+const CLAUDE_DIR = path.join(require("os").homedir(), ".claude");
+const FRAMEWORK_DIR = path.resolve(__dirname, "..");
+
 // ─── Team codes ──────────────────────────────────────────
-const TEAM = {
+const DEFAULT_TEAM = {
   "QS-FAWZI-01": {
     name: "Fawzi Goussous",
     role: "OWNER",
@@ -42,8 +45,21 @@ const TEAM = {
   },
 };
 
-const CLAUDE_DIR = path.join(require("os").homedir(), ".claude");
-const FRAMEWORK_DIR = path.resolve(__dirname, "..");
+// Load team from external file, fall back to embedded defaults.
+function loadTeam() {
+  const teamFile = path.join(CLAUDE_DIR, ".qualia-team.json");
+  try {
+    if (fs.existsSync(teamFile)) {
+      const external = JSON.parse(fs.readFileSync(teamFile, "utf8"));
+      if (external && typeof external === "object" && Object.keys(external).length > 0) {
+        return external;
+      }
+    }
+  } catch {}
+  return DEFAULT_TEAM;
+}
+
+const TEAM = loadTeam();
 
 let installed = 0;
 let errors = 0;
@@ -70,7 +86,7 @@ function askCode() {
   return new Promise((resolve) => {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     console.log("");
-    console.log(`${TEAL}  ◆ Qualia Framework v2${RESET}`);
+    console.log(`${TEAL}  ⬢ Qualia Framework v2${RESET}`);
     console.log(`${DIM}  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}`);
     console.log("");
     rl.question(`  ${WHITE}Enter install code:${RESET} `, (answer) => {
@@ -185,16 +201,6 @@ async function main() {
     }
   }
 
-  // ─── Status line ───────────────────────────────────────
-  log(`${WHITE}Status line${RESET}`);
-  try {
-    const slDest = path.join(CLAUDE_DIR, "bin", "statusline.js");
-    copy(path.join(FRAMEWORK_DIR, "bin", "statusline.js"), slDest);
-    ok("statusline.js");
-  } catch (e) {
-    warn(`statusline.js — ${e.message}`);
-  }
-
   // ─── Templates ─────────────────────────────────────────
   log(`${WHITE}Templates${RESET}`);
   const tmplDir = path.join(FRAMEWORK_DIR, "templates");
@@ -363,6 +369,11 @@ Client-specific preferences, design choices, and requirements. Loaded by \`/qual
     role: member.role,
     version: require("../package.json").version,
     installed_at: new Date().toISOString().split("T")[0],
+    erp: {
+      enabled: true,
+      url: "https://portal.qualiasolutions.net",
+      api_key_file: ".erp-api-key",
+    },
   };
   fs.writeFileSync(configFile, JSON.stringify(config, null, 2) + "\n");
 
@@ -425,16 +436,16 @@ Client-specific preferences, design choices, and requirements. Loaded by \`/qual
   settings.spinnerTipsOverride = {
     excludeDefault: true,
     tips: [
-      "◆ Lost? Type /qualia for the next step",
-      "◆ Small fix? Use /qualia-quick to skip planning",
-      "◆ End of day? /qualia-report before you clock out",
-      "◆ Context isolation: every task gets a fresh AI brain",
-      "◆ The verifier doesn't trust claims — it greps the code",
-      "◆ Plans are prompts — the plan IS what the builder reads",
-      "◆ Feature branches only — never push to main",
-      "◆ Read before write — no exceptions",
-      "◆ MVP first — build what's asked, nothing extra",
-      "◆ tracking.json syncs to ERP on every push",
+      "⬢ Lost? Type /qualia for the next step",
+      "⬢ Small fix? Use /qualia-quick to skip planning",
+      "⬢ End of day? /qualia-report before you clock out",
+      "⬢ Context isolation: every task gets a fresh AI brain",
+      "⬢ The verifier doesn't trust claims — it greps the code",
+      "⬢ Plans are prompts — the plan IS what the builder reads",
+      "⬢ Feature branches only — never push to main",
+      "⬢ Read before write — no exceptions",
+      "⬢ MVP first — build what's asked, nothing extra",
+      "⬢ tracking.json syncs to ERP on every push",
     ],
   };
 
@@ -469,22 +480,22 @@ Client-specific preferences, design choices, and requirements. Loaded by \`/qual
             type: "command",
             if: "Bash(git push*)",
             command: nodeCmd("branch-guard.js"),
-            timeout: 10,
-            statusMessage: "◆ Checking branch permissions...",
+            timeout: 5,
+            statusMessage: "⬢ Checking branch permissions...",
           },
           {
             type: "command",
             if: "Bash(git push*)",
             command: nodeCmd("pre-push.js"),
             timeout: 15,
-            statusMessage: "◆ Syncing tracking...",
+            statusMessage: "⬢ Syncing tracking...",
           },
           {
             type: "command",
             if: "Bash(vercel --prod*)",
             command: nodeCmd("pre-deploy-gate.js"),
             timeout: 180,
-            statusMessage: "◆ Running quality gates...",
+            statusMessage: "⬢ Running quality gates...",
           },
         ],
       },
@@ -493,17 +504,16 @@ Client-specific preferences, design choices, and requirements. Loaded by \`/qual
         hooks: [
           {
             type: "command",
-            if: "Edit(*.env*)|Write(*.env*)",
             command: nodeCmd("block-env-edit.js"),
             timeout: 5,
-            statusMessage: "◆ Checking file permissions...",
+            statusMessage: "⬢ Checking file permissions...",
           },
           {
             type: "command",
             if: "Edit(*migration*)|Write(*migration*)|Edit(*.sql)|Write(*.sql)",
             command: nodeCmd("migration-guard.js"),
             timeout: 10,
-            statusMessage: "◆ Checking migration safety...",
+            statusMessage: "⬢ Checking migration safety...",
           },
         ],
       },
@@ -516,39 +526,34 @@ Client-specific preferences, design choices, and requirements. Loaded by \`/qual
             type: "command",
             command: nodeCmd("pre-compact.js"),
             timeout: 15,
-            statusMessage: "◆ Saving state...",
+            statusMessage: "⬢ Saving state...",
           },
         ],
       },
     ],
   };
 
-  // Permissions
+  // Permissions — no restrictions on env files or branches.
+  // Everyone can read/write .env, push to main.
   if (!settings.permissions) settings.permissions = {};
   if (!settings.permissions.allow) settings.permissions.allow = [];
-  if (!settings.permissions.deny) {
-    settings.permissions.deny = [
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Read(./secrets/**)",
-    ];
-  }
+  if (!settings.permissions.deny) settings.permissions.deny = [];
 
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
 
-  ok("Hooks: session-start, auto-update, branch-guard, pre-push, env-block, migration-guard, deploy-gate, pre-compact");
+  ok("Hooks: session-start, auto-update, branch-guard, pre-push, block-env-edit, migration-guard, deploy-gate, pre-compact");
   ok("Status line + spinner configured");
   ok("Environment variables + permissions");
 
   // ─── Summary ───────────────────────────────────────────
   console.log("");
-  console.log(`${TEAL}  ◆ Installed ✓${RESET}`);
+  console.log(`${TEAL}  ⬢ Installed ✓${RESET}`);
   console.log(`${DIM}  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}`);
   console.log(`  ${WHITE}${member.name}${RESET} ${DIM}(${member.role})${RESET}`);
   console.log(`  Skills:       ${WHITE}${skills.length}${RESET}`);
   const agentCount = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md')).length;
   console.log(`  Agents:       ${WHITE}${agentCount}${RESET} ${DIM}(planner, builder, verifier, qa-browser)${RESET}`);
-  console.log(`  Hooks:        ${WHITE}8${RESET} ${DIM}(session-start, auto-update, branch-guard, pre-push, env-block, migration-guard, deploy-gate, pre-compact)${RESET}`);
+  console.log(`  Hooks:        ${WHITE}8${RESET} ${DIM}(session-start, auto-update, branch-guard, pre-push, block-env-edit, migration-guard, deploy-gate, pre-compact)${RESET}`);
   console.log(`  Rules:        ${WHITE}${fs.readdirSync(rulesDir).length}${RESET} ${DIM}(security, frontend, design-reference, deployment)${RESET}`);
   console.log(`  Scripts:      ${WHITE}3${RESET} ${DIM}(state.js, qualia-ui.js, statusline.js)${RESET}`);
   console.log(`  Knowledge:    ${WHITE}3${RESET} ${DIM}(patterns, fixes, client prefs)${RESET}`);

package/bin/qualia-ui.js

@@ -40,25 +40,25 @@ const RULE_DIM = `${DIM2}${RULE}${RESET}`;
 
 // ─── Action Labels ───────────────────────────────────────
 const ACTIONS = {
-  router:     { label: "SMART ROUTER",     glyph: "◆" },
-  new:        { label: "NEW PROJECT",      glyph: "◆" },
-  plan:       { label: "PLANNING",         glyph: "◇" },
-  build:      { label: "BUILDING",         glyph: "◈" },
-  verify:     { label: "VERIFYING",        glyph: "◉" },
-  polish:     { label: "POLISHING",        glyph: "◆" },
-  ship:       { label: "SHIPPING",         glyph: "▲" },
-  handoff:    { label: "HANDING OFF",      glyph: "▶" },
-  report:     { label: "SESSION REPORT",   glyph: "◆" },
-  debug:      { label: "DEBUGGING",        glyph: "◊" },
-  learn:      { label: "LEARNING",         glyph: "◆" },
-  pause:      { label: "PAUSING",          glyph: "◆" },
-  resume:     { label: "RESUMING",         glyph: "◆" },
-  review:     { label: "REVIEW",           glyph: "◆" },
-  design:     { label: "DESIGN PASS",      glyph: "◆" },
-  quick:      { label: "QUICK FIX",        glyph: "◆" },
-  task:       { label: "TASK",             glyph: "◆" },
-  "skill-new": { label: "NEW SKILL",       glyph: "◆" },
-  gaps:       { label: "GAP CLOSURE",      glyph: "◇" },
+  router:     { label: "SMART ROUTER",     glyph: "⬢" },
+  new:        { label: "NEW PROJECT",      glyph: "✦" },
+  plan:       { label: "PLANNING",         glyph: "▣" },
+  build:      { label: "BUILDING",         glyph: "⚙" },
+  verify:     { label: "VERIFYING",        glyph: "◎" },
+  polish:     { label: "POLISHING",        glyph: "✧" },
+  ship:       { label: "SHIPPING",         glyph: "△" },
+  handoff:    { label: "HANDING OFF",      glyph: "⇢" },
+  report:     { label: "SESSION REPORT",   glyph: "▤" },
+  debug:      { label: "DEBUGGING",        glyph: "⊘" },
+  learn:      { label: "LEARNING",         glyph: "⊙" },
+  pause:      { label: "PAUSING",          glyph: "⏸" },
+  resume:     { label: "RESUMING",         glyph: "▶" },
+  review:     { label: "REVIEW",           glyph: "⊛" },
+  design:     { label: "DESIGN PASS",      glyph: "◈" },
+  quick:      { label: "QUICK FIX",        glyph: "⚡" },
+  task:       { label: "TASK",             glyph: "▪" },
+  "skill-new": { label: "NEW SKILL",       glyph: "✦" },
+  gaps:       { label: "GAP CLOSURE",      glyph: "⟐" },
 };
 
 // ─── State Reading ───────────────────────────────────────
@@ -126,7 +126,7 @@ function pad(str, width) {
 
 // ─── Commands ────────────────────────────────────────────
 function cmdBanner(action, phase, subtitle) {
-  const spec = ACTIONS[action] || { label: (action || "qualia").toUpperCase(), glyph: "◆" };
+  const spec = ACTIONS[action] || { label: (action || "qualia").toUpperCase(), glyph: "⬢" };
   const state = readState();
   const config = readConfig();
   const project = projectName();
@@ -136,7 +136,7 @@ function cmdBanner(action, phase, subtitle) {
     : spec.label;
 
   console.log("");
-  console.log(`  ${TEAL}${BOLD}${spec.glyph}${RESET} ${WHITE}${BOLD}QUALIA${RESET} ${DIM}►${RESET} ${WHITE}${title}${RESET}`);
+  console.log(`  ${TEAL}${BOLD}${spec.glyph}${RESET} ${WHITE}${BOLD}QUALIA${RESET} ${DIM}▸${RESET} ${WHITE}${title}${RESET}`);
   console.log(`  ${RULE_DIM}`);
 
   // Context panel
@@ -159,7 +159,7 @@ function cmdBanner(action, phase, subtitle) {
     const bar = progressBar(state.phase, state.total_phases);
     if (bar) console.log(`  ${pad(DIM + "Progress" + RESET, 20)}${bar}`);
     if (state.gap_cycles > 0) {
-      console.log(`  ${pad(DIM + "Gap cycles" + RESET, 20)}${YELLOW}${state.gap_cycles}/2${RESET}`);
+      console.log(`  ${pad(DIM + "Gap cycles" + RESET, 20)}${YELLOW}${state.gap_cycles}/${state.gap_cycle_limit || 2}${RESET}`);
     }
   }
 
@@ -218,7 +218,7 @@ function cmdInfo(msg) {
 function cmdSpawn(agent, desc) {
   const name = agent || "agent";
   const d = desc ? ` ${DIM}— ${desc}${RESET}` : "";
-  console.log(`  ${TEAL}⟐${RESET} ${WHITE}Spawning${RESET} ${TEAL}${name}${RESET}${d}`);
+  console.log(`  ${TEAL}⬡${RESET} ${WHITE}Spawning${RESET} ${TEAL}${name}${RESET}${d}`);
 }
 
 function cmdWave(num, total, taskCount) {
@@ -226,7 +226,7 @@ function cmdWave(num, total, taskCount) {
   const n = parseInt(num) || 0;
   const t = parseInt(total) || 0;
   const c = parseInt(taskCount) || 0;
-  console.log(`  ${TEAL}▸${RESET} ${WHITE}${BOLD}Wave ${n}/${t}${RESET} ${DIM}(${c} ${c === 1 ? "task" : "tasks"}, parallel)${RESET}`);
+  console.log(`  ${TEAL}»${RESET} ${WHITE}${BOLD}Wave ${n}/${t}${RESET} ${DIM}(${c} ${c === 1 ? "task" : "tasks"}, parallel)${RESET}`);
 }
 
 function cmdTask(num, title) {
@@ -241,16 +241,16 @@ function cmdDone(num, title, commit) {
 function cmdNext(cmd) {
   if (!cmd) return;
   console.log("");
-  console.log(`  ${TEAL}→${RESET} ${WHITE}Next:${RESET}  ${TEAL}${BOLD}${cmd}${RESET}`);
+  console.log(`  ${TEAL}⟶${RESET} ${WHITE}Next:${RESET}  ${TEAL}${BOLD}${cmd}${RESET}`);
   console.log("");
 }
 
 function cmdEnd(status, nextCmd) {
   console.log("");
-  console.log(`  ${TEAL}${BOLD}◆${RESET} ${WHITE}${BOLD}${status || "DONE"}${RESET}`);
+  console.log(`  ${TEAL}${BOLD}⬢${RESET} ${WHITE}${BOLD}${status || "DONE"}${RESET}`);
   console.log(`  ${RULE_DIM}`);
   if (nextCmd) {
-    console.log(`  ${TEAL}→${RESET} ${WHITE}Next:${RESET}  ${TEAL}${BOLD}${nextCmd}${RESET}`);
+    console.log(`  ${TEAL}⟶${RESET} ${WHITE}Next:${RESET}  ${TEAL}${BOLD}${nextCmd}${RESET}`);
   }
   console.log("");
 }

package/bin/state.js

@@ -186,6 +186,25 @@ const VALID_FROM = {
   done: ["handed_off"],
 };
 
+// ─── Configurable Gap Cycle Limit ────────────────────────
+function getGapCycleLimit() {
+  // Priority: tracking.json.gap_cycle_limit > PROJECT.md > default (2)
+  try {
+    const t = readTracking();
+    if (t && typeof t.gap_cycle_limit === "number" && t.gap_cycle_limit > 0) {
+      return t.gap_cycle_limit;
+    }
+  } catch {}
+
+  try {
+    const projectMd = fs.readFileSync(path.join(PLANNING, "PROJECT.md"), "utf8");
+    const match = projectMd.match(/^gap_cycle_limit:\s*(\d+)/m);
+    if (match) return parseInt(match[1]);
+  } catch {}
+
+  return 2; // default
+}
+
 function checkPreconditions(current, target, opts) {
   const phase = parseInt(opts.phase) || current.phase;
 
@@ -207,6 +226,14 @@ function checkPreconditions(current, target, opts) {
     const planFile = path.join(PLANNING, `phase-${phase}-plan.md`);
     if (!fs.existsSync(planFile))
       return fail("MISSING_FILE", `Plan file not found: ${planFile}`);
+    // Validate plan content (not just existence)
+    const planContent = fs.readFileSync(planFile, "utf8");
+    const taskHeaders = planContent.match(/^## Task \d+/gm);
+    if (!taskHeaders || taskHeaders.length === 0)
+      return fail("INVALID_PLAN", "Plan file has no task headers (expected '## Task N')");
+    const doneWhenCount = (planContent.match(/\*\*Done when:\*\*/g) || []).length;
+    if (doneWhenCount < taskHeaders.length)
+      return fail("INVALID_PLAN", `${taskHeaders.length} tasks but only ${doneWhenCount} 'Done when:' entries`);
   }
 
   if (target === "verified") {
@@ -228,14 +255,15 @@ function checkPreconditions(current, target, opts) {
       return fail("MISSING_FILE", `Handoff file not found: ${hFile}`);
   }
 
-  // Gap-closure circuit breaker
+  // Gap-closure circuit breaker (configurable limit)
   if (target === "planned" && current.status === "verified") {
     const t = readTracking() || {};
     const cycles = (t.gap_cycles || {})[String(phase)] || 0;
-    if (cycles >= 2) {
+    const limit = getGapCycleLimit();
+    if (cycles >= limit) {
       return fail(
         "GAP_CYCLE_LIMIT",
-        `Phase ${phase} has failed verification ${cycles} times. Escalate to Fawzi or re-plan from scratch.`
+        `Phase ${phase} has failed verification ${cycles} times (limit: ${limit}). Escalate to Fawzi or re-plan from scratch.`
       );
     }
   }
@@ -294,6 +322,7 @@ function cmdCheck(opts) {
     assigned_to: s.assigned_to,
     verification: t.verification || "pending",
     gap_cycles: (t.gap_cycles || {})[String(s.phase)] || 0,
+    gap_cycle_limit: getGapCycleLimit(),
     tasks_done: t.tasks_done || 0,
     tasks_total: t.tasks_total || 0,
     deployed_url: t.deployed_url || "",
@@ -331,7 +360,6 @@ function cmdTransition(opts) {
 
   // Special: note/activity (no status change)
   if (target === "note" || target === "activity") {
-    const now = new Date().toISOString().split("T")[0];
     if (opts.notes) t.notes = opts.notes;
     t.last_updated = new Date().toISOString();
     writeTracking(t);
@@ -353,7 +381,16 @@ function cmdTransition(opts) {
     target,
     { ...opts, phase }
   );
-  if (!check.ok) return output(check);
+  if (!check.ok) {
+    // Force only bypasses status-ordering errors (PRECONDITION_FAILED, GAP_CYCLE_LIMIT).
+    // Never bypass MISSING_FILE, MISSING_ARG, INVALID_PLAN — those cause broken state.
+    const forceableErrors = ["PRECONDITION_FAILED", "GAP_CYCLE_LIMIT"];
+    if (opts.force && forceableErrors.includes(check.error)) {
+      console.error(`WARNING: Forcing transition despite: ${check.message}`);
+    } else {
+      return output(check);
+    }
+  }
 
   const prevStatus = s.status;
 
@@ -597,6 +634,66 @@ function cmdFix(opts) {
   });
 }
 
+function cmdValidatePlan(opts) {
+  const phase = parseInt(opts.phase) || 1;
+  const planFile = path.join(PLANNING, `phase-${phase}-plan.md`);
+
+  if (!fs.existsSync(planFile)) {
+    return output(fail("MISSING_FILE", `Plan file not found: ${planFile}`));
+  }
+
+  const content = fs.readFileSync(planFile, "utf8");
+  const errors = [];
+
+  // Check frontmatter exists
+  if (!/^---\n/.test(content)) {
+    errors.push("Missing frontmatter (---) at start of file");
+  }
+
+  // Check task count > 0
+  const taskHeaders = content.match(/^## Task \d+/gm);
+  if (!taskHeaders || taskHeaders.length === 0) {
+    errors.push("No task headers found (expected '## Task N — title')");
+  }
+
+  // Check "Done when" exists for each task
+  const taskCount = taskHeaders ? taskHeaders.length : 0;
+  const doneWhenCount = (content.match(/\*\*Done when:\*\*/g) || []).length;
+  if (doneWhenCount < taskCount) {
+    errors.push(
+      `${taskCount} tasks but only ${doneWhenCount} 'Done when:' entries`
+    );
+  }
+
+  // Check Success Criteria section exists
+  if (!/## Success Criteria/m.test(content)) {
+    errors.push("Missing '## Success Criteria' section");
+  }
+
+  // Check goal in frontmatter
+  if (!/^goal:/m.test(content)) {
+    errors.push("Missing 'goal:' in frontmatter");
+  }
+
+  if (errors.length > 0) {
+    return output({
+      ok: false,
+      error: "PLAN_VALIDATION_FAILED",
+      phase,
+      errors,
+      message: `Plan file has ${errors.length} issue(s)`,
+    });
+  }
+
+  output({
+    ok: true,
+    action: "validate-plan",
+    phase,
+    task_count: taskCount,
+    done_when_count: doneWhenCount,
+  });
+}
+
 // ─── Output ──────────────────────────────────────────────
 function output(obj) {
   console.log(JSON.stringify(obj, null, 2));
@@ -620,11 +717,14 @@ switch (cmd) {
   case "fix":
     cmdFix(opts);
     break;
+  case "validate-plan":
+    cmdValidatePlan(opts);
+    break;
   default:
     output(
       fail(
         "UNKNOWN_COMMAND",
-        `Usage: state.js <check|transition|init|fix> [--options]`
+        `Usage: state.js <check|transition|init|fix|validate-plan> [--options]`
       )
     );
 }

package/bin/statusline.js

@@ -11,6 +11,7 @@ const fs = require("fs");
 const os = require("os");
 const path = require("path");
 const { spawnSync } = require("child_process");
+const HOME = os.homedir();
 
 // ─── Colors (matches bin/qualia-ui.js palette) ───────────
 const TEAL = "\x1b[38;2;0;206;209m";
@@ -151,6 +152,47 @@ try {
   }
 } catch {}
 
+// ─── Memory count ────────────────────────────────────────
+let MEMORY_COUNT = 0;
+try {
+  const dirKey = DIR.replace(/\//g, "-");
+  const memDir = path.join(HOME, ".claude", "projects", dirKey, "memory");
+  if (fs.existsSync(memDir)) {
+    const files = fs.readdirSync(memDir).filter(f => f.endsWith(".md") && f !== "MEMORY.md");
+    MEMORY_COUNT = files.length;
+  }
+} catch {}
+
+// ─── Hooks count ─────────────────────────────────────────
+let HOOKS_COUNT = 0;
+try {
+  const settingsPath = path.join(HOME, ".claude", "settings.json");
+  if (fs.existsSync(settingsPath)) {
+    const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    if (settings.hooks) {
+      for (const event of Object.values(settings.hooks)) {
+        if (Array.isArray(event)) {
+          for (const matcher of event) {
+            if (matcher.hooks && Array.isArray(matcher.hooks)) {
+              HOOKS_COUNT += matcher.hooks.length;
+            }
+          }
+        }
+      }
+    }
+  }
+} catch {}
+
+// ─── Skills count ────────────────────────────────────────
+let SKILLS_COUNT = 0;
+try {
+  const skillsDir = path.join(HOME, ".claude", "skills");
+  if (fs.existsSync(skillsDir)) {
+    const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    SKILLS_COUNT = entries.filter(e => e.isDirectory() || e.name.endsWith(".md")).length;
+  }
+} catch {}
+
 // ─── Duration ────────────────────────────────────────────
 let DUR = "0s";
 try {
@@ -167,11 +209,11 @@ try {
   COST_FMT = `$${COST.toFixed(2)}`;
 } catch {}
 
-// ─── Line 1: Project + Git + Agent + Worktree + Phase ────
+// ─── Line 1: Project + Git + Agent + Worktree + Phase + Memory + Hooks ──
 let LINE1 = "";
 try {
   const dirBase = path.basename(DIR) || DIR;
-  LINE1 = `${TEAL}◆${RESET} ${WHITE}${dirBase}${RESET}`;
+  LINE1 = `${TEAL}⬢${RESET} ${WHITE}${dirBase}${RESET}`;
   if (BRANCH) {
     if (CHANGES > 0) {
       LINE1 += ` ${DIM}on${RESET} ${TEAL_GLOW}${BRANCH}${RESET} ${YELLOW}~${CHANGES}${RESET}`;
@@ -182,8 +224,16 @@ try {
   if (AGENT) LINE1 += ` ${DIM}│${RESET} ${TEAL}⚡${AGENT}${RESET}`;
   if (WORKTREE) LINE1 += ` ${DIM}│${RESET} ${TEAL_DIM}⎇ ${WORKTREE}${RESET}`;
   if (PHASE_INFO) LINE1 += ` ${DIM}│${RESET} ${PHASE_INFO}`;
+  // Memory, hooks, skills — context indicators
+  const contextParts = [];
+  if (MEMORY_COUNT > 0) contextParts.push(`${TEAL}⊙${RESET}${DIM}${MEMORY_COUNT}${RESET}`);
+  if (HOOKS_COUNT > 0) contextParts.push(`${TEAL_GLOW}⚙${RESET}${DIM}${HOOKS_COUNT}${RESET}`);
+  if (SKILLS_COUNT > 0) contextParts.push(`${TEAL_DIM}✦${RESET}${DIM}${SKILLS_COUNT}${RESET}`);
+  if (contextParts.length > 0) {
+    LINE1 += ` ${DIM}│${RESET} ${contextParts.join(` ${DIM}·${RESET} `)}`;
+  }
 } catch {
-  LINE1 = `${TEAL}◆${RESET} ${WHITE}qualia${RESET}`;
+  LINE1 = `${TEAL}⬢${RESET} ${WHITE}qualia${RESET}`;
 }
 
 // ─── Line 2: Context bar + Cost + Duration + Model ───────

package/hooks/auto-update.js

@@ -8,23 +8,43 @@ const path = require("path");
 const os = require("os");
 const { spawn, spawnSync } = require("child_process");
 
+const _traceStart = Date.now();
+
 const CLAUDE_DIR = path.join(os.homedir(), ".claude");
 const CACHE_FILE = path.join(CLAUDE_DIR, ".qualia-last-update-check");
 const CONFIG_FILE = path.join(CLAUDE_DIR, ".qualia-config.json");
 const LOCK_FILE = path.join(CLAUDE_DIR, ".qualia-updating");
 const MAX_AGE_MS = 24 * 60 * 60 * 1000;
 
+function _trace(hookName, result, extra) {
+  try {
+    const traceDir = path.join(os.homedir(), ".claude", ".qualia-traces");
+    if (!fs.existsSync(traceDir)) fs.mkdirSync(traceDir, { recursive: true });
+    const entry = {
+      hook: hookName,
+      result,
+      timestamp: new Date().toISOString(),
+      duration_ms: Date.now() - _traceStart,
+      ...extra,
+    };
+    const traceFile = path.join(traceDir, `${new Date().toISOString().split("T")[0]}.jsonl`);
+    fs.appendFileSync(traceFile, JSON.stringify(entry) + "\n");
+  } catch {}
+}
+
 try {
   // Fast path: recently checked
   if (fs.existsSync(CACHE_FILE)) {
     const last = Number(fs.readFileSync(CACHE_FILE, "utf8")) || 0;
     if (Date.now() - last * 1000 < MAX_AGE_MS) {
+      _trace("auto-update", "allow", { reason: "recently-checked" });
       process.exit(0);
     }
   }
 
   // Already updating
   if (fs.existsSync(LOCK_FILE)) {
+    _trace("auto-update", "allow", { reason: "already-updating" });
     process.exit(0);
   }
 
@@ -36,9 +56,13 @@ try {
   try {
     cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
   } catch {
+    _trace("auto-update", "allow", { reason: "config-unreadable" });
+    process.exit(0);
+  }
+  if (!cfg.code || !cfg.version) {
+    _trace("auto-update", "allow", { reason: "config-incomplete" });
     process.exit(0);
   }
-  if (!cfg.code || !cfg.version) process.exit(0);
 
   // Fork the check-and-update into a detached background process so the hook
   // returns immediately and Claude Code is never blocked.
@@ -58,7 +82,7 @@ try {
         shell: process.platform === "win32",
       });
       const latest = ((r.stdout || "").trim());
-      if (!latest) { fs.unlinkSync(LOCK_FILE); return; }
+      if (!latest) { fs.unlinkSync(LOCK_FILE); process.exit(0); }
       const cmp = (a, b) => {
         const pa = a.split(".").map(Number), pb = b.split(".").map(Number);
         for (let i = 0; i < 3; i++) {
@@ -89,4 +113,5 @@ try {
   // Silent — never block the tool call
 }
 
+_trace("auto-update", "allow", { reason: "check-spawned" });
 process.exit(0);

package/hooks/block-env-edit.js

@@ -6,6 +6,8 @@
 
 const fs = require("fs");
 
+const _traceStart = Date.now();
+
 function readInput() {
   try {
     const raw = fs.readFileSync(0, "utf8");
@@ -22,9 +24,29 @@ const file = (input.tool_input && (input.tool_input.file_path || input.tool_inpu
 // Normalize separators so Windows paths (C:\project\.env.local) also match.
 const normalized = String(file).replace(/\\/g, "/");
 
+function _trace(hookName, result, extra) {
+  try {
+    const os = require("os");
+    const path = require("path");
+    const traceDir = path.join(os.homedir(), ".claude", ".qualia-traces");
+    if (!fs.existsSync(traceDir)) fs.mkdirSync(traceDir, { recursive: true });
+    const entry = {
+      hook: hookName,
+      result,
+      timestamp: new Date().toISOString(),
+      duration_ms: Date.now() - _traceStart,
+      ...extra,
+    };
+    const file = path.join(traceDir, `${new Date().toISOString().split("T")[0]}.jsonl`);
+    fs.appendFileSync(file, JSON.stringify(entry) + "\n");
+  } catch {}
+}
+
 if (/\.env(\.|$)/.test(normalized)) {
   console.log("BLOCKED: Cannot edit environment files. Ask Fawzi to update secrets.");
+  _trace("block-env-edit", "block", { file: normalized });
   process.exit(2);
 }
 
+_trace("block-env-edit", "allow");
 process.exit(0);