@geraldmaron/construct 1.0.6 → 1.0.7

package/bin/construct

@@ -292,7 +292,7 @@ async function cmdList() {
 async function cmdDoctor() {
   const args = process.argv.slice(3);
 
-  const DAEMON_SUBS = new Set(['status', 'watch', 'stop', 'logs', 'tick', 'report']);
+  const DAEMON_SUBS = new Set(['status', 'watch', 'stop', 'logs', 'tick', 'report', 'consistency']);
   if (args.length > 0 && DAEMON_SUBS.has(args[0])) {
     const { runCli } = await import('../lib/doctor/cli.mjs');
     const code = await runCli(args);
@@ -1053,6 +1053,59 @@ async function cmdVersion() {
   println(`construct v${pkg.version}`);
 }
 
+async function cmdMigrate(args) {
+  const dryRun = args.includes('--dry-run');
+  const pathArg = args.find((a) => a.startsWith('--path='))?.split('=')[1];
+  const fromArg = args.find((a) => a.startsWith('--from='))?.split('=')[1];
+  const { runMigrations, planMigrations, CURRENT_SCHEMA_VERSION } = await import('../lib/migrations/index.mjs');
+
+  const candidates = pathArg
+    ? [pathArg]
+    : [
+        path.join(ROOT_DIR, 'agents', 'registry.json'),
+        path.join(ROOT_DIR, 'agents', 'contracts.json'),
+        path.join(ROOT_DIR, 'agents', 'role-manifests.json'),
+        path.join(process.cwd(), '.cx', 'config.json'),
+      ];
+
+  let anyFailed = false;
+  for (const artifactPath of candidates) {
+    if (!fs.existsSync(artifactPath)) continue;
+    let from;
+    try {
+      const data = JSON.parse(fs.readFileSync(artifactPath, 'utf8'));
+      from = typeof data?.version === 'number' ? data.version : Number(fromArg) || 0;
+    } catch {
+      println(`  ⚠  ${artifactPath}: parse error, skipping`);
+      continue;
+    }
+
+    const plan = planMigrations(from, CURRENT_SCHEMA_VERSION);
+    if (plan === null) {
+      println(`  ✗  ${artifactPath}: no migration path from v${from} to v${CURRENT_SCHEMA_VERSION}`);
+      anyFailed = true;
+      continue;
+    }
+    if (plan.length === 0) {
+      println(`  ✓  ${artifactPath}: already at v${CURRENT_SCHEMA_VERSION}`);
+      continue;
+    }
+
+    println(`  ${dryRun ? '·' : '→'}  ${artifactPath}: ${plan.length} step(s) (v${from} → v${CURRENT_SCHEMA_VERSION})`);
+    const result = await runMigrations({ artifactPath, fromVersion: from, dryRun });
+    for (const step of result.applied) {
+      println(`     v${step.from}→v${step.to}: ${step.summary}`);
+    }
+    if (!result.ok) {
+      println(`  ✗  ${result.error}`);
+      anyFailed = true;
+    }
+  }
+
+  if (dryRun) println(`\n(dry-run — no files were written)`);
+  if (anyFailed) process.exit(1);
+}
+
 async function cmdReview(args) {
   fs.mkdirSync(path.join(HOME, '.cx', 'performance-reviews'), { recursive: true });
   const sub = args[0];
@@ -1550,13 +1603,16 @@ function printActiveConfig() {
   println(`Persisted at: ${getUserEnvPath(HOME)} (${DEPLOYMENT_MODE_ENV_KEY})`);
 }
 
-function printIntakeHelp() {
-  println('Construct intake — inspect and process the R&D intake queue.');
+async function printIntakeHelp() {
+  const { getRebrand } = await import('../lib/profiles/rebrand.mjs');
+  const { intakeQueueLabel, signalNoun } = getRebrand(process.cwd());
+  println(`Construct intake — inspect and process the ${intakeQueueLabel}.`);
   println('');
   println('Usage:');
-  println('  construct intake list                List pending intake packets (ID, type, stage, owner, action).');
+  println(`  construct intake list                List pending ${signalNoun}s (ID, type, stage, owner, action).`);
   println('  construct intake show <id>           Show a single packet: triage, source, excerpt, related docs.');
-  println('  construct intake done <id> [--notes=…]    Mark a pending packet processed.');
+  println('  construct intake done <id> [--notes=…] [--output=<path>] [--no-output=<rejected|deferred|merged>]');
+  println('                                       Mark a pending packet processed. --output stamps intake_id + confidence into the artifact frontmatter (provenance).');
   println('  construct intake skip <id> [--reason=…]   Mark a pending packet skipped (preserves audit trail).');
   println('  construct intake reopen <id>         Move a processed or skipped packet back to pending.');
   println('  construct intake metrics               Show pipeline volume, velocity, and processing stats.');
@@ -1580,11 +1636,12 @@ function parseKvFlags(args, keys) {
   return out;
 }
 
-function formatIntakeTable(rows) {
+function formatIntakeTable(rows, { intakeQueueLabel, signalNoun } = { intakeQueueLabel: 'Intake queue', signalNoun: 'signal' }) {
   if (rows.length === 0) {
-    println('No pending intake packets.');
+    println(`No pending ${signalNoun}s.`);
     return;
   }
+  println(`${intakeQueueLabel} (${rows.length} pending):`);
   const headers = ['ID', 'Type', 'Stage', 'Owner', 'Action'];
   const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => String(r[i] || '').length)));
   const fmt = (cells) => cells.map((c, i) => String(c || '').padEnd(widths[i])).join('  ');
@@ -1597,12 +1654,14 @@ async function cmdIntake(args) {
   const sub = args[0];
 
   if (!sub || sub === '--help' || sub === '-h') {
-    printIntakeHelp();
+    await printIntakeHelp();
     return;
   }
 
   const { createIntakeQueue } = await import('../lib/intake/queue.mjs');
+  const { getRebrand } = await import('../lib/profiles/rebrand.mjs');
   const cwd = process.cwd();
+  const rebrand = getRebrand(cwd);
   const queue = createIntakeQueue(cwd, process.env);
 
   if (sub === 'list') {
@@ -1611,7 +1670,7 @@ async function cmdIntake(args) {
       const t = p.triage || {};
       return [p.id, t.intakeType || 'unknown', t.rdStage || 'unknown', t.primaryOwner || '—', t.recommendedAction || '—'];
     });
-    formatIntakeTable(rows);
+    formatIntakeTable(rows, rebrand);
     return;
   }
 
@@ -1619,8 +1678,9 @@ async function cmdIntake(args) {
   if (sub === 'show') {
     if (!id) { errorln('Usage: construct intake show <id>'); process.exit(1); }
     const entry = queue.read(id);
-    if (!entry) { errorln(`No intake packet with id: ${id}`); process.exit(1); }
+    if (!entry) { errorln(`No ${rebrand.signalNoun} with id: ${id}`); process.exit(1); }
     const t = entry.triage || {};
+    println(`${rebrand.signalNoun.charAt(0).toUpperCase() + rebrand.signalNoun.slice(1)} ${entry.id}`);
     println(`ID:        ${entry.id}`);
     println(`Status:    ${entry.status}`);
     println(`Source:    ${entry.intake?.sourcePath || '(none)'}`);
@@ -1712,11 +1772,59 @@ async function cmdIntake(args) {
   }
 
   if (sub === 'done') {
-    if (!id) { errorln('Usage: construct intake done <id> [--notes=…]'); process.exit(1); }
-    const flags = parseKvFlags(args.slice(2), ['notes']);
+    if (!id) {
+      errorln('Usage: construct intake done <id> [--notes=…] [--output=<path>] [--no-output=<rejected|deferred|merged>]');
+      process.exit(1);
+    }
+    const flags = parseKvFlags(args.slice(2), ['notes', 'output', 'no-output']);
+    const outputPath = flags.output || null;
+    const noOutputOutcome = flags['no-output'] || null;
+
+    if (outputPath && noOutputOutcome) {
+      errorln('--output and --no-output are mutually exclusive');
+      process.exit(1);
+    }
+    if (noOutputOutcome && !['rejected', 'deferred', 'merged'].includes(noOutputOutcome)) {
+      errorln(`--no-output value must be one of: rejected, deferred, merged (got "${noOutputOutcome}")`);
+      process.exit(1);
+    }
+
+    let stamped = null;
+    if (outputPath) {
+      const packet = queue.read(id);
+      if (!packet) {
+        errorln(`No intake packet found: ${id}`);
+        process.exit(1);
+      }
+      const triage = packet.triage || {};
+      try {
+        const { stampIntakeProvenance } = await import('../lib/intake/traceability.mjs');
+        const path = (await import('node:path')).default;
+        const absPath = path.isAbsolute(outputPath) ? outputPath : path.join(cwd, outputPath);
+        stamped = stampIntakeProvenance(absPath, {
+          intakeId: id,
+          confidence: triage.confidence,
+          rationale: triage.rationale,
+        });
+      } catch (err) {
+        errorln(err.message || 'intake stamping failed');
+        process.exit(1);
+      }
+    }
+
+    const notes = flags.notes
+      || (noOutputOutcome ? `intake_outcome: ${noOutputOutcome}` : '')
+      || (outputPath ? `output: ${outputPath}` : '');
+
     try {
-      const r = queue.markProcessed(id, { processedBy: 'construct-intake-cli', notes: flags.notes || '' });
-      info(`Marked ${r.id} processed.`);
+      const r = queue.markProcessed(id, { processedBy: 'construct-intake-cli', notes });
+      if (stamped) {
+        info(`Marked ${r.id} processed. Stamped ${outputPath} with intake_id=${id} (confidence=${stamped.intake_confidence ?? 'n/a'}).`);
+      } else if (noOutputOutcome) {
+        info(`Marked ${r.id} processed (intake_outcome: ${noOutputOutcome}).`);
+      } else {
+        info(`Marked ${r.id} processed.`);
+      }
     } catch (err) {
       errorln(err.message || 'mark processed failed');
       process.exit(1);
@@ -2741,27 +2849,55 @@ async function cmdSeedTraces(args) {
 async function cmdCleanup() {
   const force = restArgsCache.includes('--pressure-release');
   const quiet = restArgsCache.includes('--quiet');
-  const report = runPressureRelease({ env: process.env, force });
-
-  if (!quiet) {
-    const swap = report.swapUsage
-      ? `${(report.swapUsage.usedBytes / (1024 ** 3)).toFixed(1)} GiB used`
-      : 'swap unavailable';
-    println(`Pressure guard: ${report.pressureTriggered ? 'triggered' : 'standby'} · ${swap}`);
-    for (const entry of report.warnings ?? []) {
-      const grace = entry.graceMinutes ? `; will terminate after ${entry.graceMinutes}m if still matched` : '';
-      println(`Warning pid ${entry.pid} (${entry.reason})${grace}`);
+  const dryRun = restArgsCache.includes('--dry-run');
+  const pressureOnly = restArgsCache.includes('--pressure-only');
+  const diskOnly = restArgsCache.includes('--disk-only');
+
+  // Process pressure release: kill stale dev-agent processes.
+  if (!diskOnly) {
+    const report = runPressureRelease({ env: process.env, force });
+    if (!quiet) {
+      const swap = report.swapUsage
+        ? `${(report.swapUsage.usedBytes / (1024 ** 3)).toFixed(1)} GiB used`
+        : 'swap unavailable';
+      println(`Pressure guard: ${report.pressureTriggered ? 'triggered' : 'standby'} · ${swap}`);
+      for (const entry of report.warnings ?? []) {
+        const grace = entry.graceMinutes ? `; will terminate after ${entry.graceMinutes}m if still matched` : '';
+        println(`Warning pid ${entry.pid} (${entry.reason})${grace}`);
+      }
+      if (report.killed.length) {
+        for (const entry of report.killed) {
+          println(`Stopped pid ${entry.pid} (${entry.reason})`);
+        }
+      } else {
+        println('No stale dev-agent processes needed cleanup.');
+      }
     }
   }
 
-  if (!report.killed.length) {
-    if (!quiet) println('No stale dev-agent processes needed cleanup.');
-    return;
-  }
-
-  if (!quiet) {
-    for (const entry of report.killed) {
-      println(`Stopped pid ${entry.pid} (${entry.reason})`);
+  // Disk maintenance: rotate oversized logs, prune stale cache entries.
+  if (!pressureOnly) {
+    const { runFullCleanup, formatBytes } = await import('../lib/maintenance/cleanup.mjs');
+    const summary = runFullCleanup({ homeDir: HOME, env: process.env, dryRun });
+    if (!quiet) {
+      const verb = dryRun ? 'Would free' : 'Freed';
+      println(`Disk maintenance${dryRun ? ' (dry-run)' : ''}: ${verb} ${formatBytes(summary.freedBytes)} in ${summary.durationMs}ms`);
+      const log = summary.embedLog;
+      if (log?.truncated?.length) {
+        for (const t of log.truncated) println(`  truncated ${path.relative(HOME, t.path)} (was ${formatBytes(t.sizeWas)})`);
+      }
+      if (log?.removed?.length) {
+        for (const r of log.removed) println(`  removed   ${path.relative(HOME, r.path)} (${formatBytes(r.size)})`);
+      }
+      if (summary.jsonlLogs?.truncated?.length) {
+        for (const t of summary.jsonlLogs.truncated) println(`  truncated ${path.relative(HOME, t.path)} (was ${formatBytes(t.sizeWas)} → ${formatBytes(t.sizeNow)})`);
+      }
+      if (summary.cacheDir?.removed?.length) {
+        println(`  pruned    ${summary.cacheDir.removed.length} stale cache file(s)`);
+      }
+      for (const err of summary.errors ?? []) {
+        println(`  ! ${err.step}: ${err.error}`);
+      }
     }
   }
 }
@@ -2970,6 +3106,12 @@ async function cmdMemory(args) {
 async function cmdLintComments(args) {
   const fix = args.includes('--fix');
   const staged = args.includes('--staged');
+  // CLI invocation enforces block severity for artifact-prose lint (see
+  // lib/comment-lint.mjs#checkArtifactBanned). Operators may opt back into
+  // warn-only by exporting CONSTRUCT_ARTIFACT_LINT_MODE=warn explicitly.
+  if (!process.env.CONSTRUCT_ARTIFACT_LINT_MODE) {
+    process.env.CONSTRUCT_ARTIFACT_LINT_MODE = 'block';
+  }
   const { lintRepo: lint, lintFile, formatResults: fmt } = await import('../lib/comment-lint.mjs');
 
   let results;
@@ -3053,6 +3195,18 @@ async function cmdLintAgents() {
   process.exit(1);
 }
 
+async function cmdLintContracts() {
+  const { validateContractsFile } = await import('../lib/contracts/validate.mjs');
+  const result = validateContractsFile({ repoRoot: ROOT_DIR });
+  if (result.ok) {
+    console.log('agents/contracts.json: 0 errors');
+    return;
+  }
+  console.error(`agents/contracts.json: ${result.errors.length} error(s)`);
+  for (const err of result.errors) console.error(`  ${err}`);
+  process.exit(1);
+}
+
 async function cmdBackup(args) {
   const sub = args[0];
 
@@ -3426,6 +3580,7 @@ const handlers = new Map([
   ['evals', cmdEvals],
   ['cleanup', cmdCleanup],
   ['version', cmdVersion],
+  ['migrate', cmdMigrate],
   ['docs:update', cmdDocsUpdate],
   ['docs:check', cmdDocsCheck],
   ['docs:site', cmdDocsSite],
@@ -3440,6 +3595,7 @@ const handlers = new Map([
   ['provider', cmdProvider],
   ['lint:research', cmdLintResearch],
   ['lint:agents', cmdLintAgents],
+  ['lint:contracts', cmdLintContracts],
   ['audit', async (args) => {
     const sub = args[0];
     if (sub === 'skills') return runAuditSkillsCli(args.slice(1));
@@ -4331,6 +4487,27 @@ if (!handler) {
   process.exit(1);
 }
 
+// Self-maintenance on version change. Skipped for high-frequency hook calls
+// (the harness invokes `construct hook <name>` many times per session and
+// must stay fast). When the installed version differs from the stamp at
+// ~/.construct/.cleanup-stamp, we run a single bounded cleanup pass and
+// update the stamp. Subsequent invocations are a single file read.
+if (command !== 'hook') {
+  try {
+    const { maybeRunCleanupOnUpgrade, formatBytes } = await import('../lib/maintenance/cleanup.mjs');
+    const pkg = JSON.parse(fs.readFileSync(path.join(ROOT_DIR, 'package.json'), 'utf8'));
+    const result = maybeRunCleanupOnUpgrade({ homeDir: HOME, env: process.env, currentVersion: pkg.version });
+    if (result.ran && result.summary?.freedBytes > 1024 * 1024) {
+      const previous = result.previousVersion ? ` from v${result.previousVersion}` : '';
+      process.stderr.write(`[construct] Maintenance after upgrade${previous} to v${pkg.version}: freed ${formatBytes(result.summary.freedBytes)}.\n`);
+    }
+  } catch (err) {
+    // Maintenance must never block the actual command. Surface the failure
+    // but continue. The next invocation will retry.
+    process.stderr.write(`[construct] startup maintenance skipped: ${err.message}\n`);
+  }
+}
+
 // First-invocation resource probe — skipped for hooks, setup, uninstall,
 // doctor, and once BOOTSTRAP_CHECKED=1 is cached in ~/.construct/config.env.
 // On TTY: if anything's missing, prints the status table and offers to run

package/commands/build/feature.md

@@ -4,7 +4,7 @@ commands/build/feature.md (Build a feature) implement it end to end, tested and
 Build a feature: implement it end to end, tested and ready to ship
 -->
 ---
-description: Build a feature: implement it end to end, tested and ready to ship
+description: "Build a feature: implement it end to end, tested and ready to ship"
 ---
 
 You are Construct. Build the following: $ARGUMENTS

package/commands/build/fix.md

@@ -4,7 +4,7 @@ commands/build/fix.md (Fix something broken) reproduce, find the root cause, app
 Fix something broken: reproduce, find the root cause, apply the smallest safe change
 -->
 ---
-description: Fix something broken: reproduce, find the root cause, apply the smallest safe change
+description: "Fix something broken: reproduce, find the root cause, apply the smallest safe change"
 ---
 
 You are Construct.

package/commands/design/access.md

@@ -4,7 +4,7 @@ commands/design/access.md (Accessibility audit) WCAG 2.1 AA, keyboard, screen re
 Accessibility audit: WCAG 2.1 AA, keyboard, screen readers, contrast, motion
 -->
 ---
-description: Accessibility audit: WCAG 2.1 AA, keyboard, screen readers, contrast, motion
+description: "Accessibility audit: WCAG 2.1 AA, keyboard, screen readers, contrast, motion"
 ---
 
 You are Construct. Audit: $ARGUMENTS

package/commands/design/flow.md

@@ -4,7 +4,7 @@ commands/design/flow.md (Map the user flow) entry to success, friction points, j
 Map the user flow: entry to success, friction points, jobs-to-be-done
 -->
 ---
-description: Map the user flow: entry to success, friction points, jobs-to-be-done
+description: "Map the user flow: entry to success, friction points, jobs-to-be-done"
 ---
 
 You are Construct. Map the user flow for: $ARGUMENTS

package/commands/design/ui.md

@@ -4,7 +4,7 @@ commands/design/ui.md (Design or review UI) visual hierarchy, states, interactio
 Design or review UI: visual hierarchy, states, interaction model, accessibility baseline
 -->
 ---
-description: Design or review UI: visual hierarchy, states, interaction model, accessibility baseline
+description: "Design or review UI: visual hierarchy, states, interaction model, accessibility baseline"
 ---
 
 You are Construct. Design or review the UI for: $ARGUMENTS

package/commands/measure/experiment.md

@@ -4,7 +4,7 @@ commands/measure/experiment.md (Design an experiment) hypothesis, test, evidence
 Design an experiment: hypothesis, test, evidence threshold, go/no-go decision
 -->
 ---
-description: Design an experiment: hypothesis, test, evidence threshold, go/no-go decision
+description: "Design an experiment: hypothesis, test, evidence threshold, go/no-go decision"
 ---
 
 You are Construct. Design an experiment for: $ARGUMENTS

package/commands/measure/metrics.md

@@ -4,7 +4,7 @@ commands/measure/metrics.md (Define metrics) what to measure, baselines, success
 Define metrics: what to measure, baselines, success thresholds, instrumentation needed
 -->
 ---
-description: Define metrics: what to measure, baselines, success thresholds, instrumentation needed
+description: "Define metrics: what to measure, baselines, success thresholds, instrumentation needed"
 ---
 
 You are Construct. Define metrics for: $ARGUMENTS

package/commands/measure/results.md

@@ -4,7 +4,7 @@ commands/measure/results.md (Analyze results) interpret data, separate signal fr
 Analyze results: interpret data, separate signal from noise, produce a recommendation
 -->
 ---
-description: Analyze results: interpret data, separate signal from noise, produce a recommendation
+description: "Analyze results: interpret data, separate signal from noise, produce a recommendation"
 ---
 
 You are Construct. Analyze: $ARGUMENTS

package/commands/plan/api.md

@@ -4,7 +4,7 @@ commands/plan/api.md (Design an API) contracts, endpoints, error model, data sch
 Design an API: contracts, endpoints, error model, data schema
 -->
 ---
-description: Design an API: contracts, endpoints, error model, data schema
+description: "Design an API: contracts, endpoints, error model, data schema"
 ---
 
 You are Construct. Design the API for: $ARGUMENTS

package/commands/plan/challenge.md

@@ -4,7 +4,7 @@ commands/plan/challenge.md (Challenge a plan) stress-test assumptions, surface f
 Challenge a plan: stress-test assumptions, surface failure modes and risks
 -->
 ---
-description: Challenge a plan: stress-test assumptions, surface failure modes and risks
+description: "Challenge a plan: stress-test assumptions, surface failure modes and risks"
 ---
 
 You are Construct. Challenge the following: $ARGUMENTS

package/commands/plan/decide.md

@@ -4,7 +4,7 @@ commands/plan/decide.md (Record a decision) context, options considered, consequ
 Record a decision: context, options considered, consequences, what it locks in
 -->
 ---
-description: Record a decision: context, options considered, consequences, what it locks in
+description: "Record a decision: context, options considered, consequences, what it locks in"
 ---
 
 You are Construct. Document the decision about: $ARGUMENTS

package/commands/plan/feature.md

@@ -5,7 +5,7 @@ Produces a structured spec using the canonical Construct plan format, saves it
 to .cx/plans/ as a durable planning artifact linked to the active tracker slice.
 -->
 ---
-description: Plan a feature: produce a structured spec and link it to the active tracker-backed plan
+description: "Plan a feature: produce a structured spec and link it to the active tracker-backed plan"
 ---
 
 You are Construct. Plan the following: $ARGUMENTS

package/commands/plan/requirements.md

@@ -4,7 +4,7 @@ commands/plan/requirements.md (Define requirements) what needs to be true for th
 Define requirements: what needs to be true for this to be done
 -->
 ---
-description: Define requirements: what needs to be true for this to be done
+description: "Define requirements: what needs to be true for this to be done"
 ---
 
 You are Construct. Define requirements for: $ARGUMENTS

package/commands/remember/context.md

@@ -4,7 +4,7 @@ commands/remember/context.md (Save project context) update .cx/context.md so the
 Save project context: update .cx/context.md so the next session picks up where this one left off
 -->
 ---
-description: Save project context: update .cx/context.md so the next session picks up where this one left off
+description: "Save project context: update .cx/context.md so the next session picks up where this one left off"
 ---
 
 You are Construct. Save context for: $ARGUMENTS

package/commands/remember/handoff.md

@@ -4,7 +4,7 @@ commands/remember/handoff.md (Write a handoff) transfer context so the next sess
 Write a handoff: transfer context so the next session or person can continue without loss
 -->
 ---
-description: Write a handoff: transfer context so the next session or person can continue without loss
+description: "Write a handoff: transfer context so the next session or person can continue without loss"
 ---
 
 You are Construct. Write a handoff for: $ARGUMENTS

package/commands/remember/runbook.md

@@ -4,7 +4,7 @@ commands/remember/runbook.md (Write a runbook) step-by-step procedure for a recu
 Write a runbook: step-by-step procedure for a recurring task or incident
 -->
 ---
-description: Write a runbook: step-by-step procedure for a recurring task or incident
+description: "Write a runbook: step-by-step procedure for a recurring task or incident"
 ---
 
 You are Construct. Write a runbook for: $ARGUMENTS

package/commands/review/code.md

@@ -4,7 +4,7 @@ commands/review/code.md (Code review) correctness, regressions, security, test c
 Code review: correctness, regressions, security, test coverage
 -->
 ---
-description: Code review: correctness, regressions, security, test coverage
+description: "Code review: correctness, regressions, security, test coverage"
 ---
 
 You are Construct. Review: $ARGUMENTS

package/commands/review/quality.md

@@ -4,7 +4,7 @@ commands/review/quality.md (Quality audit) complexity, naming, duplication, dead
 Quality audit: complexity, naming, duplication, dead code, maintainability
 -->
 ---
-description: Quality audit: complexity, naming, duplication, dead code, maintainability
+description: "Quality audit: complexity, naming, duplication, dead code, maintainability"
 ---
 
 You are Construct. Audit quality for: $ARGUMENTS

package/commands/review/security.md

@@ -4,7 +4,7 @@ commands/review/security.md (Security scan) secrets, auth, injection, data expos
 Security scan: secrets, auth, injection, data exposure, dependency risk
 -->
 ---
-description: Security scan: secrets, auth, injection, data exposure, dependency risk
+description: "Security scan: secrets, auth, injection, data exposure, dependency risk"
 ---
 
 You are Construct. Scan: $ARGUMENTS

package/commands/ship/ready.md

@@ -4,7 +4,7 @@ commands/ship/ready.md (Pre-release check) is this ready to ship?
 Pre-release check: is this ready to ship?
 -->
 ---
-description: Pre-release check: is this ready to ship?
+description: "Pre-release check: is this ready to ship?"
 ---
 
 You are Construct. Check if the following is ready: $ARGUMENTS

package/commands/ship/release.md

@@ -4,7 +4,7 @@ commands/ship/release.md (Release) plan rollout, changelog, rollback, and post-r
 Release: plan rollout, changelog, rollback, and post-release verification
 -->
 ---
-description: Release: plan rollout, changelog, rollback, and post-release verification
+description: "Release: plan rollout, changelog, rollback, and post-release verification"
 ---
 
 You are Construct. Release the following: $ARGUMENTS

package/commands/ship/status.md

@@ -4,7 +4,7 @@ commands/ship/status.md (Status) current project state, workflow, uncommitted ch
 Status: current project state, workflow, uncommitted changes, recent activity
 -->
 ---
-description: Status: current project state, workflow, uncommitted changes, recent activity
+description: "Status: current project state, workflow, uncommitted changes, recent activity"
 ---
 
 You are Construct. Report status for: $ARGUMENTS

package/commands/understand/docs.md

@@ -4,7 +4,7 @@ commands/understand/docs.md (Look up documentation) current behavior from primar
 Look up documentation: current behavior from primary sources, not training memory
 -->
 ---
-description: Look up documentation: current behavior from primary sources, not training memory
+description: "Look up documentation: current behavior from primary sources, not training memory"
 ---
 
 You are Construct. Look up: $ARGUMENTS

package/commands/understand/this.md

@@ -4,7 +4,7 @@ commands/understand/this.md (Explore and understand something) trace execution p
 Explore and understand something: trace execution paths, map structure, gather evidence
 -->
 ---
-description: Explore and understand something: trace execution paths, map structure, gather evidence
+description: "Explore and understand something: trace execution paths, map structure, gather evidence"
 ---
 
 You are Construct. Explore and explain: $ARGUMENTS

package/commands/understand/why.md

@@ -4,7 +4,7 @@ commands/understand/why.md (Investigate a failure) why is this broken, what is t
 Investigate a failure: why is this broken, what is the root cause
 -->
 ---
-description: Investigate a failure: why is this broken, what is the root cause
+description: "Investigate a failure: why is this broken, what is the root cause"
 ---
 
 You are Construct. Investigate: $ARGUMENTS

package/commands/work/clean.md

@@ -4,7 +4,7 @@ commands/work/clean.md (Remove AI-generated code smells) verbosity, hedging, dea
 Remove AI-generated code smells: verbosity, hedging, dead comments, generic names
 -->
 ---
-description: Remove AI-generated code smells: verbosity, hedging, dead comments, generic names
+description: "Remove AI-generated code smells: verbosity, hedging, dead comments, generic names"
 ---
 
 You are cx-reviewer identifying AI slop in: $ARGUMENTS

package/commands/work/drive.md

@@ -4,7 +4,7 @@ commands/work/drive.md (Full autonomous execution) explore, plan, implement, ver
 Full autonomous execution: explore, plan, implement, verify, loop until done
 -->
 ---
-description: Full autonomous execution: explore, plan, implement, verify, loop until done
+description: "Full autonomous execution: explore, plan, implement, verify, loop until done"
 ---
 
 You are Construct in drive mode. Execute $ARGUMENTS fully and autonomously without stopping for confirmation.

package/commands/work/optimize-prompts.md

@@ -4,7 +4,7 @@ commands/work/optimize-prompts.md: Prompt optimization command.
 Runs the closed-loop prompt optimization workflow using telemetry trace data.
 -->
 ---
-description: Closed-loop prompt optimization: read telemetry traces, diagnose failures, push improved version to staging
+description: "Closed-loop prompt optimization: read telemetry traces, diagnose failures, push improved version to staging"
 ---
 
 You are cx-trace-reviewer running a prompt optimization cycle for: $ARGUMENTS

package/commands/work/parallel-review.md

@@ -4,7 +4,7 @@ commands/work/parallel-review.md (Adversarial parallel review) 5 reviewers must
 Adversarial parallel review: 5 reviewers must agree before output ships
 -->
 ---
-description: Adversarial parallel review: 5 reviewers must agree before output ships
+description: "Adversarial parallel review: 5 reviewers must agree before output ships"
 ---
 
 You are Construct running a parallel adversarial review of: $ARGUMENTS