cclaw-cli 0.51.30 → 1.0.0

package/dist/tdd-cycle.d.ts

@@ -30,13 +30,13 @@ export interface TddCycleParseIssue {
 export interface ParseTddCycleLogOptions {
     /**
      * Collect one issue per dropped/malformed line. Callers that care
-     * (doctor, red-evidence) can surface them; hooks keep soft-fail.
+     * (sync/runtime checks, red-evidence) can surface them; hooks keep soft-fail.
      */
     issues?: TddCycleParseIssue[];
     /**
      * When true, reject lines that omit required fields instead of
      * back-filling them with defaults. Used by validation paths
-     * (`validateTddCycleOrder`, `cclaw doctor`) to avoid silently
+     * (`validateTddCycleOrder`, `npx cclaw-cli sync` fail-fast) to avoid silently
      * bucketing unscoped rows into "runId=active, stage=tdd". Soft paths
      * (generated hooks) keep the legacy defaults so a half-written file
      * never takes the session down.
@@ -92,7 +92,7 @@ export interface RalphLoopStatus {
  * Derive a lightweight Ralph Loop summary from parsed tdd-cycle-log entries.
  * The goal is to give the model a single source of truth for "am I done
  * iterating?" — it collapses per-slice progress and distinct closed AC IDs
- * (from GREEN rows) into a single artifact the next-command contract reads.
+ * (from GREEN rows) into a single artifact the progression contract reads.
  */
 export declare function computeRalphLoopStatus(entries: TddCycleEntry[], options?: {
     runId?: string;

package/dist/tdd-cycle.js

@@ -201,7 +201,7 @@ export function pathMatchesTarget(candidate, target) {
  * Derive a lightweight Ralph Loop summary from parsed tdd-cycle-log entries.
  * The goal is to give the model a single source of truth for "am I done
  * iterating?" — it collapses per-slice progress and distinct closed AC IDs
- * (from GREEN rows) into a single artifact the next-command contract reads.
+ * (from GREEN rows) into a single artifact the progression contract reads.
  */
 export function computeRalphLoopStatus(entries, options = {}) {
     const runId = options.runId ?? "active";

package/dist/types.d.ts

@@ -71,8 +71,7 @@ export interface TrackHeuristicsConfig {
  * when the harness supports native dispatch, otherwise fulfilled via
  * an explicit in-session role switch with evidence).
  *
- * Track gating: `enforceOnTracks` lists the tracks where the doctor
- * check escalates to a warning. Tracks outside this list still see
+ * Track gating: `enforceOnTracks` lists the tracks where the sync/runtime check escalates to a warning. Tracks outside this list still see
  * the skill prose but leave the decision to the user.
  *
  * All fields optional; sensible defaults: disabled, threshold 5, no
@@ -85,7 +84,7 @@ export interface SliceReviewConfig {
     filesChangedThreshold?: number;
     /** Glob hints; any plan-task touchPath match triggers review. */
     touchTriggers?: string[];
-    /** Tracks on which missed reviews escalate to a doctor warning. */
+    /** Tracks on which missed reviews escalate to a sync/runtime warning. */
     enforceOnTracks?: FlowTrack[];
 }
 /**
@@ -116,6 +115,17 @@ export interface TddPathConfig {
 export interface CompoundConfig {
     recurrenceThreshold?: number;
 }
+/**
+ * Early-stage Ralph loop policy for brainstorm/scope/design.
+ *
+ * - enabled: when false, skip early-loop gate/diagnostics and hook writes.
+ * - maxIterations: capped producer/critic iterations before convergence
+ *   escalation. Defaults to 3.
+ */
+export interface EarlyLoopConfig {
+    enabled?: boolean;
+    maxIterations?: number;
+}
 export interface IronLawsConfig {
     /**
      * Per-law escape hatch: list the iron-law ids that must always be strict,
@@ -128,13 +138,13 @@ export interface IronLawsConfig {
 /**
  * Optional opt-in audit toggles for additional stage lint gates.
  *
- * Disabled by default so existing projects are not forced into stricter
- * checks until they explicitly enable them in config.
+ * `scopePreAudit` stays opt-in (disabled by default). `staleDiagramAudit` is
+ * default-on and can be explicitly disabled when teams intentionally skip it.
  */
 export interface OptInAuditsConfig {
     /** When true, scope lint requires a filled `Pre-Scope System Audit` section. */
     scopePreAudit?: boolean;
-    /** When true, design lint runs stale diagram drift checks against blast radius files. */
+    /** Default true; when enabled, design lint runs stale diagram drift checks against blast radius files. */
     staleDiagramAudit?: boolean;
 }
 export interface ReviewLoopExternalSecondOpinionConfig {
@@ -176,6 +186,8 @@ export interface CclawConfig {
     tdd?: TddPathConfig;
     /** Compound-stage recurrence policy overrides. */
     compound?: CompoundConfig;
+    /** Early-stage producer/critic loop policy overrides. */
+    earlyLoop?: EarlyLoopConfig;
     /** When true, cclaw installs managed git pre-commit/pre-push wrappers. */
     gitHookGuards?: boolean;
     /** Default flow track for new runs (quick = shortened path, standard = full pipeline). */
@@ -208,10 +220,6 @@ export interface CclawConfig {
     /** Optional runtime knobs for outside-voice review loops. */
     reviewLoop?: ReviewLoopConfig;
 }
-/**
- * @deprecated Use `CclawConfig` instead.
- */
-export type VibyConfig = CclawConfig;
 export interface TransitionRule {
     from: FlowStage;
     to: FlowStage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cclaw-cli",
-  "version": "0.51.30",
+  "version": "1.0.0",
   "description": "Installer-first flow toolkit for coding agents",
   "type": "module",
   "bin": {
@@ -17,7 +17,8 @@
   },
   "scripts": {
     "clean:dist": "node -e \"import('node:fs/promises').then((fs) => fs.rm('dist', { recursive: true, force: true }))\"",
-    "build": "npm run clean:dist && tsc -p tsconfig.json && node scripts/chmod-bin.mjs",
+    "build": "npm run clean:dist && tsc -p tsconfig.json && npm run build:hook-bundle && node scripts/chmod-bin.mjs",
+    "build:hook-bundle": "esbuild src/runtime/run-hook.entry.ts --bundle --platform=node --format=esm --outfile=dist/runtime/run-hook.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
@@ -47,6 +48,7 @@
     "@stryker-mutator/vitest-runner": "^9.6.1",
     "@types/node": "^24.7.2",
     "@vitest/coverage-v8": "^3.2.4",
+    "esbuild": "^0.28.0",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   }

package/dist/content/hook-inline-snippets.d.ts

@@ -1,83 +0,0 @@
-/**
- * hook-inline-snippets.ts
- *
- * Runtime `.cclaw/hooks/run-hook.mjs` is a **standalone Node script** that
- * cannot import from `cclaw-cli` — it must work inside the end-user's
- * project even when the CLI is not installed. Two derived computations,
- * though, must remain 1:1 with the canonical TS implementations:
- *
- * 1. `computeCompoundReadinessInline` mirrors
- *    `src/knowledge-store.ts::computeCompoundReadiness`.
- * 2. `computeRalphLoopStatusInline` mirrors
- *    `src/tdd-cycle.ts::computeRalphLoopStatus`.
- *
- * Previously those bodies lived inline in `src/content/node-hooks.ts` — a
- * ~2000-line file — next to unrelated hook-handler code. Any silent drift
- * only surfaced when someone remembered to update both sides.
- *
- * This module centralizes the inline JavaScript snippets so:
- *
- * - There is exactly **one place** (this file) that holds each inline
- *   JS body.
- * - Each snippet carries an explicit "mirrors X, parity enforced by Y"
- *   header comment and is emitted into `run-hook.mjs` verbatim.
- * - `src/content/node-hooks.ts` only interpolates the snippets, it no
- *   longer owns their source code.
- *
- * Parity with the TypeScript canonical implementations is enforced by
- * `tests/unit/ralph-loop-parity.test.ts`. Any structural change to the
- * canonical TS code MUST:
- *
- * 1. Update the matching snippet below.
- * 2. Re-run `npm test tests/unit/ralph-loop-parity.test.ts`.
- *
- * DO NOT inline tests here — keep the parity check in its dedicated test
- * file.
- */
-/**
- * Inline JS helpers used by both compound-readiness and ralph-loop
- * snippets. Kept small and locked: they are shared across the two inline
- * routines and must not grow into a hidden utility namespace.
- *
- * - `normalizeCompoundLastUpdatedAt` produces a stable ISO-8601 UTC
- *   timestamp so the hook-written `compound-readiness.json` is byte-equal
- *   to the CLI-written version for the same input.
- * - `countArchivedRunsInline` counts immediate subdirectories of
- *   `<root>/.cclaw/runs/` so both the hook and the CLI see the same
- *   `archivedRunsCount` for the small-project relaxation.
- * - `formatCompoundReadinessLineInline` mirrors the one-line summary shape
- *   used by `src/internal/compound-readiness.ts::formatCompoundReadinessLine`
- *   so session-start and internal CLI command stay wording-compatible.
- */
-export declare const HOOK_INLINE_SHARED_HELPERS = "\nfunction normalizeCompoundLastUpdatedAt(date) {\n  return date.toISOString().replace(/\\.\\d{3}Z$/u, \"Z\");\n}\n\n// Count archived runs as sub-directories under `.cclaw/runs/`. Missing\n// dir returns 0; unexpected errors return undefined so the caller can\n// skip the small-project relaxation rather than guess.\nasync function countArchivedRunsInline(root) {\n  const dir = path.join(root, RUNTIME_ROOT, \"runs\");\n  try {\n    const entries = await fs.readdir(dir, { withFileTypes: true });\n    return entries.filter((entry) => entry.isDirectory()).length;\n  } catch (error) {\n    const code = error && typeof error === \"object\" && \"code\" in error ? error.code : null;\n    if (code === \"ENOENT\") return 0;\n    return undefined;\n  }\n}\n\nfunction formatCompoundReadinessLineInline(readiness) {\n  if (!readiness || typeof readiness !== \"object\") {\n    return \"\";\n  }\n  const ready = Array.isArray(readiness.ready) ? readiness.ready : [];\n  const readyCount =\n    typeof readiness.readyCount === \"number\" && Number.isFinite(readiness.readyCount)\n      ? Math.trunc(readiness.readyCount)\n      : ready.length;\n  const clusterCount =\n    typeof readiness.clusterCount === \"number\" && Number.isFinite(readiness.clusterCount)\n      ? Math.trunc(readiness.clusterCount)\n      : 0;\n  const threshold =\n    typeof readiness.threshold === \"number\" && Number.isFinite(readiness.threshold)\n      ? Math.trunc(readiness.threshold)\n      : COMPOUND_RECURRENCE_THRESHOLD;\n  if (readyCount === 0) {\n    return \"Compound readiness: no candidates (clusters=\" +\n      String(clusterCount) + \", threshold=\" + String(threshold) + \")\";\n  }\n  const critical = ready.filter(\n    (entry) => entry && typeof entry === \"object\" && entry.severity === \"critical\"\n  ).length;\n  const criticalSuffix = critical > 0 ? \" (critical=\" + String(critical) + \")\" : \"\";\n  return \"Compound readiness: clusters=\" + String(clusterCount) +\n    \", ready=\" + String(readyCount) + criticalSuffix;\n}\n";
-/**
- * Inline mirror of `src/knowledge-store.ts::computeCompoundReadiness`.
- *
- * Parity enforced by
- * `tests/unit/ralph-loop-parity.test.ts::compound-readiness parity`.
- *
- * Signature contract:
- *   async function computeCompoundReadinessInline(root, options) -> CompoundReadiness
- *
- * Accepted options (all optional):
- * - prereadRaw: string | undefined — pre-read `knowledge.jsonl` contents.
- * - threshold: integer >= 1 — default recurrence threshold.
- * - archivedRunsCount: integer >= 0 — enables small-project relaxation.
- * - maxReady: integer >= 1 — cap on returned `ready` cluster count
- *   (default 10).
- *
- * Depends on: `SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD`,
- * `SMALL_PROJECT_RECURRENCE_THRESHOLD`, `COMPOUND_RECURRENCE_THRESHOLD`,
- * and `HOOK_INLINE_SHARED_HELPERS` being in the same runtime scope.
- */
-export declare const COMPOUND_READINESS_INLINE_SOURCE = "\nasync function computeCompoundReadinessInline(root, options) {\n  const filePath = path.join(root, RUNTIME_ROOT, \"knowledge.jsonl\");\n  // Caller may supply pre-read raw to avoid double-reading knowledge.jsonl.\n  const raw = typeof (options && options.prereadRaw) === \"string\"\n    ? options.prereadRaw\n    : await readTextFile(filePath, \"\");\n  const baseThresholdRaw = options && options.threshold;\n  const baseThreshold = Number.isInteger(baseThresholdRaw) && baseThresholdRaw >= 1\n    ? baseThresholdRaw\n    : COMPOUND_RECURRENCE_THRESHOLD;\n  const archivedRunsCount =\n    typeof (options && options.archivedRunsCount) === \"number\" &&\n    Number.isFinite(options.archivedRunsCount) &&\n    options.archivedRunsCount >= 0\n      ? Math.floor(options.archivedRunsCount)\n      : undefined;\n  const smallProjectRelaxationApplied =\n    archivedRunsCount !== undefined &&\n    archivedRunsCount < SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD &&\n    baseThreshold > SMALL_PROJECT_RECURRENCE_THRESHOLD;\n  const threshold = smallProjectRelaxationApplied\n    ? SMALL_PROJECT_RECURRENCE_THRESHOLD\n    : baseThreshold;\n  const maxReady = Number.isInteger(options && options.maxReady) && options.maxReady >= 1\n    ? options.maxReady\n    : 10;\n  const normalize = (value) => String(value == null ? \"\" : value).trim().replace(/\\s+/gu, \" \").toLowerCase();\n  const severityWeight = (sev) => {\n    if (sev === \"critical\") return 3;\n    if (sev === \"important\") return 2;\n    if (sev === \"suggestion\") return 1;\n    return 0;\n  };\n  const buckets = new Map();\n  for (const rawLine of raw.split(/\\r?\\n/gu)) {\n    const line = rawLine.trim();\n    if (line.length === 0) continue;\n    let row;\n    try { row = JSON.parse(line); } catch { continue; }\n    if (!row || typeof row !== \"object\" || Array.isArray(row)) continue;\n    if (row.maturity === \"lifted-to-enforcement\" || typeof row.superseded_by === \"string\") continue;\n    const type = typeof row.type === \"string\" ? row.type : \"\";\n    const trigger = typeof row.trigger === \"string\" ? row.trigger : \"\";\n    const action = typeof row.action === \"string\" ? row.action : \"\";\n    if (type.length === 0 || trigger.length === 0 || action.length === 0) continue;\n    const key = type + \"||\" + normalize(trigger) + \"||\" + normalize(action);\n    const frequency = Number.isInteger(row.frequency) && row.frequency > 0 ? Math.floor(row.frequency) : 1;\n    const lastSeen = typeof row.last_seen_ts === \"string\" ? row.last_seen_ts : \"\";\n    let bucket = buckets.get(key);\n    if (!bucket) {\n      bucket = {\n        trigger,\n        action,\n        recurrence: frequency,\n        entryCount: 1,\n        severity: typeof row.severity === \"string\" ? row.severity : undefined,\n        lastSeenTs: lastSeen,\n        types: new Set([type]),\n        maturity: new Set([typeof row.maturity === \"string\" ? row.maturity : \"raw\"])\n      };\n      buckets.set(key, bucket);\n      continue;\n    }\n    bucket.recurrence += frequency;\n    bucket.entryCount += 1;\n    bucket.types.add(type);\n    bucket.maturity.add(typeof row.maturity === \"string\" ? row.maturity : \"raw\");\n    if (row.severity === \"critical\") {\n      bucket.severity = \"critical\";\n    } else if (row.severity === \"important\" && bucket.severity !== \"critical\") {\n      bucket.severity = \"important\";\n    }\n    if (lastSeen && Date.parse(lastSeen) > Date.parse(bucket.lastSeenTs || \"0\")) {\n      bucket.lastSeenTs = lastSeen;\n    }\n  }\n  const ready = [];\n  for (const bucket of buckets.values()) {\n    const criticalOverride = bucket.severity === \"critical\";\n    const meetsRecurrence = bucket.recurrence >= threshold;\n    if (!criticalOverride && !meetsRecurrence) continue;\n    ready.push({\n      trigger: bucket.trigger,\n      action: bucket.action,\n      recurrence: bucket.recurrence,\n      entryCount: bucket.entryCount,\n      qualification: criticalOverride && !meetsRecurrence ? \"critical_override\" : \"recurrence\",\n      ...(bucket.severity ? { severity: bucket.severity } : {}),\n      lastSeenTs: bucket.lastSeenTs,\n      types: Array.from(bucket.types).sort(),\n      maturity: Array.from(bucket.maturity).sort()\n    });\n  }\n  ready.sort((a, b) => {\n    const sevDiff = severityWeight(b.severity) - severityWeight(a.severity);\n    if (sevDiff !== 0) return sevDiff;\n    if (b.recurrence !== a.recurrence) return b.recurrence - a.recurrence;\n    const recencyDiff = Date.parse(b.lastSeenTs || \"0\") - Date.parse(a.lastSeenTs || \"0\");\n    if (!Number.isNaN(recencyDiff) && recencyDiff !== 0) return recencyDiff;\n    return String(a.trigger).localeCompare(String(b.trigger));\n  });\n  return {\n    schemaVersion: 2,\n    threshold,\n    baseThreshold,\n    ...(archivedRunsCount !== undefined ? { archivedRunsCount } : {}),\n    smallProjectRelaxationApplied,\n    clusterCount: buckets.size,\n    readyCount: ready.length,\n    ready: ready.slice(0, maxReady),\n    lastUpdatedAt: normalizeCompoundLastUpdatedAt(new Date())\n  };\n}\n";
-/**
- * Inline mirror of `src/tdd-cycle.ts::computeRalphLoopStatus`.
- *
- * Parity enforced by
- * `tests/unit/ralph-loop-parity.test.ts::ralph-loop parity`.
- *
- * Signature contract:
- *   async function computeRalphLoopStatusInline(stateDir, runId) -> RalphLoopStatus
- */
-export declare const RALPH_LOOP_INLINE_SOURCE = "\nasync function computeRalphLoopStatusInline(stateDir, runId) {\n  const filePath = path.join(stateDir, \"tdd-cycle-log.jsonl\");\n  const raw = await readTextFile(filePath, \"\");\n  const sliceMap = new Map();\n  const acClosed = new Set();\n  const redOpenSlices = [];\n  let loopIteration = 0;\n  for (const rawLine of raw.split(/\\r?\\n/gu)) {\n    const line = rawLine.trim();\n    if (line.length === 0) continue;\n    let row;\n    try { row = JSON.parse(line); } catch { continue; }\n    if (!row || typeof row !== \"object\" || Array.isArray(row)) continue;\n    const rowRun = typeof row.runId === \"string\" && row.runId.length > 0 ? row.runId : runId;\n    if (rowRun !== runId) continue;\n    const slice = typeof row.slice === \"string\" && row.slice.length > 0 ? row.slice : \"S-unknown\";\n    let state = sliceMap.get(slice);\n    if (!state) {\n      state = { slice, redCount: 0, greenCount: 0, refactorCount: 0, redOpen: false, acIds: [] };\n      sliceMap.set(slice, state);\n    }\n    const exitCode = typeof row.exitCode === \"number\" ? row.exitCode : undefined;\n    if (row.phase === \"red\") {\n      state.redCount += 1;\n      if (exitCode !== undefined && exitCode !== 0) state.redOpen = true;\n    } else if (row.phase === \"green\") {\n      state.greenCount += 1;\n      state.redOpen = false;\n      loopIteration += 1;\n      if (Array.isArray(row.acIds)) {\n        for (const acId of row.acIds) {\n          if (typeof acId !== \"string\" || acId.length === 0) continue;\n          acClosed.add(acId);\n          if (!state.acIds.includes(acId)) state.acIds.push(acId);\n        }\n      }\n    } else if (row.phase === \"refactor\") {\n      state.refactorCount += 1;\n    }\n  }\n  for (const state of sliceMap.values()) {\n    if (state.redOpen) redOpenSlices.push(state.slice);\n  }\n  const slices = Array.from(sliceMap.values()).sort((a, b) => a.slice.localeCompare(b.slice, \"en\"));\n  return {\n    schemaVersion: 1,\n    runId,\n    loopIteration,\n    redOpen: redOpenSlices.length > 0,\n    redOpenSlices,\n    acClosed: Array.from(acClosed).sort(),\n    sliceCount: slices.length,\n    slices,\n    lastUpdatedAt: new Date().toISOString()\n  };\n}\n";

package/dist/content/hook-inline-snippets.js

@@ -1,302 +0,0 @@
-/**
- * hook-inline-snippets.ts
- *
- * Runtime `.cclaw/hooks/run-hook.mjs` is a **standalone Node script** that
- * cannot import from `cclaw-cli` — it must work inside the end-user's
- * project even when the CLI is not installed. Two derived computations,
- * though, must remain 1:1 with the canonical TS implementations:
- *
- * 1. `computeCompoundReadinessInline` mirrors
- *    `src/knowledge-store.ts::computeCompoundReadiness`.
- * 2. `computeRalphLoopStatusInline` mirrors
- *    `src/tdd-cycle.ts::computeRalphLoopStatus`.
- *
- * Previously those bodies lived inline in `src/content/node-hooks.ts` — a
- * ~2000-line file — next to unrelated hook-handler code. Any silent drift
- * only surfaced when someone remembered to update both sides.
- *
- * This module centralizes the inline JavaScript snippets so:
- *
- * - There is exactly **one place** (this file) that holds each inline
- *   JS body.
- * - Each snippet carries an explicit "mirrors X, parity enforced by Y"
- *   header comment and is emitted into `run-hook.mjs` verbatim.
- * - `src/content/node-hooks.ts` only interpolates the snippets, it no
- *   longer owns their source code.
- *
- * Parity with the TypeScript canonical implementations is enforced by
- * `tests/unit/ralph-loop-parity.test.ts`. Any structural change to the
- * canonical TS code MUST:
- *
- * 1. Update the matching snippet below.
- * 2. Re-run `npm test tests/unit/ralph-loop-parity.test.ts`.
- *
- * DO NOT inline tests here — keep the parity check in its dedicated test
- * file.
- */
-/**
- * Inline JS helpers used by both compound-readiness and ralph-loop
- * snippets. Kept small and locked: they are shared across the two inline
- * routines and must not grow into a hidden utility namespace.
- *
- * - `normalizeCompoundLastUpdatedAt` produces a stable ISO-8601 UTC
- *   timestamp so the hook-written `compound-readiness.json` is byte-equal
- *   to the CLI-written version for the same input.
- * - `countArchivedRunsInline` counts immediate subdirectories of
- *   `<root>/.cclaw/runs/` so both the hook and the CLI see the same
- *   `archivedRunsCount` for the small-project relaxation.
- * - `formatCompoundReadinessLineInline` mirrors the one-line summary shape
- *   used by `src/internal/compound-readiness.ts::formatCompoundReadinessLine`
- *   so session-start and internal CLI command stay wording-compatible.
- */
-export const HOOK_INLINE_SHARED_HELPERS = `
-function normalizeCompoundLastUpdatedAt(date) {
-  return date.toISOString().replace(/\\.\\d{3}Z$/u, "Z");
-}
-
-// Count archived runs as sub-directories under \`.cclaw/runs/\`. Missing
-// dir returns 0; unexpected errors return undefined so the caller can
-// skip the small-project relaxation rather than guess.
-async function countArchivedRunsInline(root) {
-  const dir = path.join(root, RUNTIME_ROOT, "runs");
-  try {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    return entries.filter((entry) => entry.isDirectory()).length;
-  } catch (error) {
-    const code = error && typeof error === "object" && "code" in error ? error.code : null;
-    if (code === "ENOENT") return 0;
-    return undefined;
-  }
-}
-
-function formatCompoundReadinessLineInline(readiness) {
-  if (!readiness || typeof readiness !== "object") {
-    return "";
-  }
-  const ready = Array.isArray(readiness.ready) ? readiness.ready : [];
-  const readyCount =
-    typeof readiness.readyCount === "number" && Number.isFinite(readiness.readyCount)
-      ? Math.trunc(readiness.readyCount)
-      : ready.length;
-  const clusterCount =
-    typeof readiness.clusterCount === "number" && Number.isFinite(readiness.clusterCount)
-      ? Math.trunc(readiness.clusterCount)
-      : 0;
-  const threshold =
-    typeof readiness.threshold === "number" && Number.isFinite(readiness.threshold)
-      ? Math.trunc(readiness.threshold)
-      : COMPOUND_RECURRENCE_THRESHOLD;
-  if (readyCount === 0) {
-    return "Compound readiness: no candidates (clusters=" +
-      String(clusterCount) + ", threshold=" + String(threshold) + ")";
-  }
-  const critical = ready.filter(
-    (entry) => entry && typeof entry === "object" && entry.severity === "critical"
-  ).length;
-  const criticalSuffix = critical > 0 ? " (critical=" + String(critical) + ")" : "";
-  return "Compound readiness: clusters=" + String(clusterCount) +
-    ", ready=" + String(readyCount) + criticalSuffix;
-}
-`;
-/**
- * Inline mirror of `src/knowledge-store.ts::computeCompoundReadiness`.
- *
- * Parity enforced by
- * `tests/unit/ralph-loop-parity.test.ts::compound-readiness parity`.
- *
- * Signature contract:
- *   async function computeCompoundReadinessInline(root, options) -> CompoundReadiness
- *
- * Accepted options (all optional):
- * - prereadRaw: string | undefined — pre-read `knowledge.jsonl` contents.
- * - threshold: integer >= 1 — default recurrence threshold.
- * - archivedRunsCount: integer >= 0 — enables small-project relaxation.
- * - maxReady: integer >= 1 — cap on returned `ready` cluster count
- *   (default 10).
- *
- * Depends on: `SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD`,
- * `SMALL_PROJECT_RECURRENCE_THRESHOLD`, `COMPOUND_RECURRENCE_THRESHOLD`,
- * and `HOOK_INLINE_SHARED_HELPERS` being in the same runtime scope.
- */
-export const COMPOUND_READINESS_INLINE_SOURCE = `
-async function computeCompoundReadinessInline(root, options) {
-  const filePath = path.join(root, RUNTIME_ROOT, "knowledge.jsonl");
-  // Caller may supply pre-read raw to avoid double-reading knowledge.jsonl.
-  const raw = typeof (options && options.prereadRaw) === "string"
-    ? options.prereadRaw
-    : await readTextFile(filePath, "");
-  const baseThresholdRaw = options && options.threshold;
-  const baseThreshold = Number.isInteger(baseThresholdRaw) && baseThresholdRaw >= 1
-    ? baseThresholdRaw
-    : COMPOUND_RECURRENCE_THRESHOLD;
-  const archivedRunsCount =
-    typeof (options && options.archivedRunsCount) === "number" &&
-    Number.isFinite(options.archivedRunsCount) &&
-    options.archivedRunsCount >= 0
-      ? Math.floor(options.archivedRunsCount)
-      : undefined;
-  const smallProjectRelaxationApplied =
-    archivedRunsCount !== undefined &&
-    archivedRunsCount < SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD &&
-    baseThreshold > SMALL_PROJECT_RECURRENCE_THRESHOLD;
-  const threshold = smallProjectRelaxationApplied
-    ? SMALL_PROJECT_RECURRENCE_THRESHOLD
-    : baseThreshold;
-  const maxReady = Number.isInteger(options && options.maxReady) && options.maxReady >= 1
-    ? options.maxReady
-    : 10;
-  const normalize = (value) => String(value == null ? "" : value).trim().replace(/\\s+/gu, " ").toLowerCase();
-  const severityWeight = (sev) => {
-    if (sev === "critical") return 3;
-    if (sev === "important") return 2;
-    if (sev === "suggestion") return 1;
-    return 0;
-  };
-  const buckets = new Map();
-  for (const rawLine of raw.split(/\\r?\\n/gu)) {
-    const line = rawLine.trim();
-    if (line.length === 0) continue;
-    let row;
-    try { row = JSON.parse(line); } catch { continue; }
-    if (!row || typeof row !== "object" || Array.isArray(row)) continue;
-    if (row.maturity === "lifted-to-enforcement" || typeof row.superseded_by === "string") continue;
-    const type = typeof row.type === "string" ? row.type : "";
-    const trigger = typeof row.trigger === "string" ? row.trigger : "";
-    const action = typeof row.action === "string" ? row.action : "";
-    if (type.length === 0 || trigger.length === 0 || action.length === 0) continue;
-    const key = type + "||" + normalize(trigger) + "||" + normalize(action);
-    const frequency = Number.isInteger(row.frequency) && row.frequency > 0 ? Math.floor(row.frequency) : 1;
-    const lastSeen = typeof row.last_seen_ts === "string" ? row.last_seen_ts : "";
-    let bucket = buckets.get(key);
-    if (!bucket) {
-      bucket = {
-        trigger,
-        action,
-        recurrence: frequency,
-        entryCount: 1,
-        severity: typeof row.severity === "string" ? row.severity : undefined,
-        lastSeenTs: lastSeen,
-        types: new Set([type]),
-        maturity: new Set([typeof row.maturity === "string" ? row.maturity : "raw"])
-      };
-      buckets.set(key, bucket);
-      continue;
-    }
-    bucket.recurrence += frequency;
-    bucket.entryCount += 1;
-    bucket.types.add(type);
-    bucket.maturity.add(typeof row.maturity === "string" ? row.maturity : "raw");
-    if (row.severity === "critical") {
-      bucket.severity = "critical";
-    } else if (row.severity === "important" && bucket.severity !== "critical") {
-      bucket.severity = "important";
-    }
-    if (lastSeen && Date.parse(lastSeen) > Date.parse(bucket.lastSeenTs || "0")) {
-      bucket.lastSeenTs = lastSeen;
-    }
-  }
-  const ready = [];
-  for (const bucket of buckets.values()) {
-    const criticalOverride = bucket.severity === "critical";
-    const meetsRecurrence = bucket.recurrence >= threshold;
-    if (!criticalOverride && !meetsRecurrence) continue;
-    ready.push({
-      trigger: bucket.trigger,
-      action: bucket.action,
-      recurrence: bucket.recurrence,
-      entryCount: bucket.entryCount,
-      qualification: criticalOverride && !meetsRecurrence ? "critical_override" : "recurrence",
-      ...(bucket.severity ? { severity: bucket.severity } : {}),
-      lastSeenTs: bucket.lastSeenTs,
-      types: Array.from(bucket.types).sort(),
-      maturity: Array.from(bucket.maturity).sort()
-    });
-  }
-  ready.sort((a, b) => {
-    const sevDiff = severityWeight(b.severity) - severityWeight(a.severity);
-    if (sevDiff !== 0) return sevDiff;
-    if (b.recurrence !== a.recurrence) return b.recurrence - a.recurrence;
-    const recencyDiff = Date.parse(b.lastSeenTs || "0") - Date.parse(a.lastSeenTs || "0");
-    if (!Number.isNaN(recencyDiff) && recencyDiff !== 0) return recencyDiff;
-    return String(a.trigger).localeCompare(String(b.trigger));
-  });
-  return {
-    schemaVersion: 2,
-    threshold,
-    baseThreshold,
-    ...(archivedRunsCount !== undefined ? { archivedRunsCount } : {}),
-    smallProjectRelaxationApplied,
-    clusterCount: buckets.size,
-    readyCount: ready.length,
-    ready: ready.slice(0, maxReady),
-    lastUpdatedAt: normalizeCompoundLastUpdatedAt(new Date())
-  };
-}
-`;
-/**
- * Inline mirror of `src/tdd-cycle.ts::computeRalphLoopStatus`.
- *
- * Parity enforced by
- * `tests/unit/ralph-loop-parity.test.ts::ralph-loop parity`.
- *
- * Signature contract:
- *   async function computeRalphLoopStatusInline(stateDir, runId) -> RalphLoopStatus
- */
-export const RALPH_LOOP_INLINE_SOURCE = `
-async function computeRalphLoopStatusInline(stateDir, runId) {
-  const filePath = path.join(stateDir, "tdd-cycle-log.jsonl");
-  const raw = await readTextFile(filePath, "");
-  const sliceMap = new Map();
-  const acClosed = new Set();
-  const redOpenSlices = [];
-  let loopIteration = 0;
-  for (const rawLine of raw.split(/\\r?\\n/gu)) {
-    const line = rawLine.trim();
-    if (line.length === 0) continue;
-    let row;
-    try { row = JSON.parse(line); } catch { continue; }
-    if (!row || typeof row !== "object" || Array.isArray(row)) continue;
-    const rowRun = typeof row.runId === "string" && row.runId.length > 0 ? row.runId : runId;
-    if (rowRun !== runId) continue;
-    const slice = typeof row.slice === "string" && row.slice.length > 0 ? row.slice : "S-unknown";
-    let state = sliceMap.get(slice);
-    if (!state) {
-      state = { slice, redCount: 0, greenCount: 0, refactorCount: 0, redOpen: false, acIds: [] };
-      sliceMap.set(slice, state);
-    }
-    const exitCode = typeof row.exitCode === "number" ? row.exitCode : undefined;
-    if (row.phase === "red") {
-      state.redCount += 1;
-      if (exitCode !== undefined && exitCode !== 0) state.redOpen = true;
-    } else if (row.phase === "green") {
-      state.greenCount += 1;
-      state.redOpen = false;
-      loopIteration += 1;
-      if (Array.isArray(row.acIds)) {
-        for (const acId of row.acIds) {
-          if (typeof acId !== "string" || acId.length === 0) continue;
-          acClosed.add(acId);
-          if (!state.acIds.includes(acId)) state.acIds.push(acId);
-        }
-      }
-    } else if (row.phase === "refactor") {
-      state.refactorCount += 1;
-    }
-  }
-  for (const state of sliceMap.values()) {
-    if (state.redOpen) redOpenSlices.push(state.slice);
-  }
-  const slices = Array.from(sliceMap.values()).sort((a, b) => a.slice.localeCompare(b.slice, "en"));
-  return {
-    schemaVersion: 1,
-    runId,
-    loopIteration,
-    redOpen: redOpenSlices.length > 0,
-    redOpenSlices,
-    acClosed: Array.from(acClosed).sort(),
-    sliceCount: slices.length,
-    slices,
-    lastUpdatedAt: new Date().toISOString()
-  };
-}
-`;

package/dist/content/ideate-command.d.ts

@@ -1,8 +0,0 @@
-import { type IdeateFrameId } from "./ideate-frames.js";
-export interface IdeateCommandOptions {
-    frameIds?: readonly IdeateFrameId[];
-    mode?: "repo-grounded" | "elsewhere-software" | "elsewhere-non-software" | "narrow";
-}
-export declare function minimumDistinctIdeateFrames(frameCount: number, mode?: IdeateCommandOptions["mode"]): number;
-export declare function ideateCommandContract(options?: IdeateCommandOptions): string;
-export declare function ideateCommandSkillMarkdown(options?: IdeateCommandOptions): string;