cclaw-cli 0.49.0 → 0.51.1

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

@@ -45,6 +45,9 @@
  * - `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) {
@@ -65,6 +68,35 @@ async function countArchivedRunsInline(root) {
     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`.
@@ -127,7 +159,7 @@ async function computeCompoundReadinessInline(root, options) {
     let row;
     try { row = JSON.parse(line); } catch { continue; }
     if (!row || typeof row !== "object" || Array.isArray(row)) continue;
-    if (row.maturity === "lifted-to-enforcement") 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 : "";

package/dist/content/hook-manifest.d.ts

@@ -21,7 +21,7 @@
  */
 export declare const HOOK_MANIFEST_HARNESSES: readonly ["claude", "cursor", "codex"];
 export type HookManifestHarness = (typeof HOOK_MANIFEST_HARNESSES)[number];
-export declare const HOOK_HANDLERS: readonly ["session-start", "prompt-guard", "workflow-guard", "context-monitor", "stop-checkpoint", "pre-compact", "verify-current-state"];
+export declare const HOOK_HANDLERS: readonly ["session-start", "prompt-guard", "workflow-guard", "context-monitor", "stop-handoff", "pre-compact", "verify-current-state"];
 export type HookHandlerId = (typeof HOOK_HANDLERS)[number];
 export interface HookBinding {
     /**
@@ -52,7 +52,7 @@ export interface HookHandlerSpec {
     semantic: HookSemanticEvent | null;
     bindings: Partial<Record<HookManifestHarness, HookBinding[]>>;
 }
-export declare const HOOK_SEMANTIC_EVENTS: readonly ["session_rehydrate", "pre_tool_prompt_guard", "pre_tool_workflow_guard", "post_tool_context_monitor", "stop_checkpoint", "precompact_digest"];
+export declare const HOOK_SEMANTIC_EVENTS: readonly ["session_rehydrate", "pre_tool_prompt_guard", "pre_tool_workflow_guard", "post_tool_context_monitor", "stop_handoff", "precompact_compat"];
 export type HookSemanticEvent = (typeof HOOK_SEMANTIC_EVENTS)[number];
 export declare const HOOK_MANIFEST: readonly HookHandlerSpec[];
 export interface EventGroup {
@@ -76,7 +76,6 @@ export declare function groupBindingsByEvent(harness: HookManifestHarness): Even
 /** Distinct harness-native event names covered by the manifest. */
 export declare function requiredEventsFor(harness: HookManifestHarness): string[];
 /**
- * Human-readable per-harness semantic coverage used by docs and by
- * the doctor's `harness-gaps.json` synthesis.
+ * Human-readable per-harness semantic coverage used by docs and doctor output.
  */
 export declare function semanticEventCoverage(harness: HookManifestHarness): Partial<Record<HookSemanticEvent, string>>;

package/dist/content/hook-manifest.js

@@ -25,7 +25,7 @@ export const HOOK_HANDLERS = [
     "prompt-guard",
     "workflow-guard",
     "context-monitor",
-    "stop-checkpoint",
+    "stop-handoff",
     "pre-compact",
     "verify-current-state"
 ];
@@ -34,8 +34,8 @@ export const HOOK_SEMANTIC_EVENTS = [
     "pre_tool_prompt_guard",
     "pre_tool_workflow_guard",
     "post_tool_context_monitor",
-    "stop_checkpoint",
-    "precompact_digest"
+    "stop_handoff",
+    "precompact_compat"
 ];
 export const HOOK_MANIFEST = [
     {
@@ -90,9 +90,9 @@ export const HOOK_MANIFEST = [
         }
     },
     {
-        handler: "stop-checkpoint",
-        description: "Persist checkpoint with stage + run context on session stop.",
-        semantic: "stop_checkpoint",
+        handler: "stop-handoff",
+        description: "Remind about clean handoff with stage + run context on session stop.",
+        semantic: "stop_handoff",
         bindings: {
             claude: [{ event: "Stop", timeout: 10 }],
             cursor: [{ event: "stop", timeout: 10 }],
@@ -101,12 +101,12 @@ export const HOOK_MANIFEST = [
     },
     {
         handler: "pre-compact",
-        description: "Write pre-compact digest (Claude+Cursor have a native event; Codex has no PreCompact — covered by `/cc-ops retro`).",
-        semantic: "precompact_digest",
+        description: "No-op compatibility hook for harness pre-compact events; session-start rehydrates from flow-state, artifacts, and knowledge.",
+        semantic: "precompact_compat",
         bindings: {
             claude: [{ event: "PreCompact", matcher: "manual|auto", timeout: 10 }],
-            // pre-compact must capture the digest BEFORE session-start
-            // rehydrates on cursor `sessionCompact`.
+            // Keep this before session-start on cursor `sessionCompact` so the
+            // compatibility handler runs before rehydration.
             cursor: [{ event: "sessionCompact", priority: -10 }]
         }
     },
@@ -179,8 +179,7 @@ export function requiredEventsFor(harness) {
     return ordered;
 }
 /**
- * Human-readable per-harness semantic coverage used by docs and by
- * the doctor's `harness-gaps.json` synthesis.
+ * Human-readable per-harness semantic coverage used by docs and doctor output.
  */
 export function semanticEventCoverage(harness) {
     const out = {};

package/dist/content/hooks.js

@@ -1,12 +1,31 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { RUNTIME_ROOT } from "../constants.js";
+function resolveCliEntrypointForGeneratedHook() {
+    const here = fileURLToPath(import.meta.url);
+    const candidates = [
+        path.resolve(path.dirname(here), "..", "cli.js"),
+        path.resolve(path.dirname(here), "..", "..", "dist", "cli.js")
+    ];
+    for (const candidate of candidates) {
+        // Synchronous probe runs only during cclaw-cli init/sync generation.
+        // The generated hook receives a concrete path and does not need a global bin.
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
 export function stageCompleteScript() {
+    const cliEntrypoint = resolveCliEntrypointForGeneratedHook();
     return `#!/usr/bin/env node
 import fs from "node:fs/promises";
 import path from "node:path";
 import process from "node:process";
-import { spawn, spawnSync } from "node:child_process";
+import { spawn } from "node:child_process";
 
 const RUNTIME_ROOT = ${JSON.stringify(RUNTIME_ROOT)};
+const CCLAW_CLI_ENTRYPOINT = ${JSON.stringify(cliEntrypoint)};
 
 async function detectRoot() {
   const candidates = [
@@ -58,27 +77,29 @@ async function main() {
     return;
   }
 
-  if (process.platform === "win32") {
-    const probe = spawnSync("where", ["cclaw"], {
-      cwd: root,
-      env: process.env,
-      stdio: "ignore"
-    });
-    if ((probe.status ?? 1) !== 0) {
-      process.stderr.write(
-        "[cclaw] stage-complete: cclaw binary not found in PATH. Install cclaw CLI and rerun stage completion.\\n"
-      );
-      process.exitCode = 1;
-      return;
-    }
+  const cliEntrypoint = process.env.CCLAW_CLI_JS || CCLAW_CLI_ENTRYPOINT;
+  if (!cliEntrypoint || cliEntrypoint.trim().length === 0) {
+    process.stderr.write(
+      "[cclaw] stage-complete: local Node runtime entrypoint is missing. Re-run npx cclaw-cli sync or npx cclaw-cli upgrade to regenerate hooks.\\n"
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  try {
+    const stat = await fs.stat(cliEntrypoint);
+    if (!stat.isFile()) throw new Error("not-file");
+  } catch {
+    process.stderr.write(
+      "[cclaw] stage-complete: local Node runtime entrypoint not found at " + cliEntrypoint + ". Re-run npx cclaw-cli sync or npx cclaw-cli upgrade to regenerate hooks.\\n"
+    );
+    process.exitCode = 1;
+    return;
   }
 
-  const isWindows = process.platform === "win32";
   const child = spawn(
-    isWindows ? "cmd.exe" : "cclaw",
-    isWindows
-      ? ["/d", "/s", "/c", "cclaw", "internal", "advance-stage", stage, ...flags]
-      : ["internal", "advance-stage", stage, ...flags],
+    process.execPath,
+    [cliEntrypoint, "internal", "advance-stage", stage, ...flags],
     {
     cwd: root,
     env: process.env,
@@ -92,11 +113,11 @@ async function main() {
     const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
     if (code === "ENOENT") {
       process.stderr.write(
-        "[cclaw] stage-complete: cclaw binary not found in PATH. Install cclaw CLI and rerun stage completion.\\n"
+        "[cclaw] stage-complete: node executable not found while invoking local runtime. Re-run npx cclaw-cli doctor.\\n"
       );
     } else {
       process.stderr.write(
-        "[cclaw] stage-complete: failed to invoke cclaw internal advance-stage (" +
+        "[cclaw] stage-complete: failed to invoke local Node advance-stage runtime (" +
           (error instanceof Error ? error.message : String(error)) +
           ").\\n"
       );
@@ -134,6 +155,7 @@ set "RUNTIME=%HOOK_DIR%run-hook.mjs"
 where node >nul 2>nul
 if %ERRORLEVEL% neq 0 (
   REM Best-effort: missing node should not block harness execution loops.
+  echo [cclaw] run-hook.cmd: node not found; cclaw hook skipped. Run npx cclaw-cli doctor. >&2
   exit /b 0
 )
 node "%RUNTIME%" %*
@@ -145,6 +167,7 @@ if [ "$#" -lt 1 ]; then
   exit 1
 fi
 if ! command -v node >/dev/null 2>&1; then
+  echo "[cclaw] run-hook.cmd: node not found; cclaw hook skipped. Run npx cclaw-cli doctor." >&2
   exit 0
 fi
 exec node "\${SCRIPT_DIR}/run-hook.mjs" "$@"

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

@@ -1,6 +1,8 @@
 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;

package/dist/content/ideate-command.js

@@ -1,5 +1,7 @@
 import { RUNTIME_ROOT } from "../constants.js";
 import { resolveIdeateFrames } from "./ideate-frames.js";
+import { ideateStructuredAskToolsWithFallback } from "./decision-protocol.js";
+import { conversationLanguagePolicyMarkdown } from "./language-policy.js";
 const IDEATE_SKILL_FOLDER = "flow-ideate";
 const IDEATE_SKILL_NAME = "flow-ideate";
 /**
@@ -10,15 +12,13 @@ const IDEATE_SKILL_NAME = "flow-ideate";
 const IDEATE_ARTIFACT_GLOB = ".cclaw/artifacts/ideate-*.md";
 const IDEATE_ARTIFACT_PATTERN = ".cclaw/artifacts/ideate-<YYYY-MM-DD-slug>.md";
 const IDEATE_RESUME_WINDOW_DAYS = 30;
-/**
- * Structured-ask tool list reused across cclaw skills. Kept inline here (small
- * enough) to avoid cross-module coupling; larger stage skills cite the shared
- * protocol file instead.
- */
-const STRUCTURED_ASK_TOOLS = "`AskUserQuestion` on Claude, `AskQuestion` on Cursor, " +
-    "`question` on OpenCode when `permission.question: \"allow\"` is set, " +
-    "`request_user_input` on Codex in Plan / Collaboration mode; " +
-    "fall back to a plain-text lettered list when the tool is hidden or errors";
+const STRUCTURED_ASK_TOOLS = ideateStructuredAskToolsWithFallback();
+export function minimumDistinctIdeateFrames(frameCount, mode = "repo-grounded") {
+    if (frameCount <= 0)
+        return 0;
+    const cap = mode === "repo-grounded" ? 4 : 2;
+    return Math.min(cap, frameCount);
+}
 function renderFrameBullets(frameIds) {
     return resolveIdeateFrames(frameIds)
         .map((frame) => `   - ${frame.label} (\`${frame.id}\`)`)
@@ -32,7 +32,7 @@ function renderFrameNames(frameIds) {
 export function ideateCommandContract(options = {}) {
     const frames = resolveIdeateFrames(options.frameIds);
     const frameBullets = renderFrameBullets(options.frameIds);
-    const minimumDistinctFrames = Math.min(4, frames.length);
+    const minimumDistinctFrames = minimumDistinctIdeateFrames(frames.length, options.mode);
     return `# /cc-ideate
 
 ## Purpose
@@ -44,6 +44,7 @@ same session, or save/discard the backlog.
 
 ## HARD-GATE
 
+${conversationLanguagePolicyMarkdown()}
 - Ideate mode only. Never mutate \`.cclaw/state/flow-state.json\`.
 - Every recommendation cites evidence from the current repository
   (file path, command output, or knowledge-store entry id).
@@ -58,8 +59,10 @@ same session, or save/discard the backlog.
    has been modified within the last ${IDEATE_RESUME_WINDOW_DAYS} days,
    offer the user: continue that backlog, start fresh, or cancel.
 2. **Mode classification.** Explicitly classify subject:
-   \`repo-grounded\` / \`elsewhere-software\` / \`elsewhere-non-software\`.
-   Do not assume repo-grounded by default.
+   \`repo-grounded\` / \`elsewhere-software\` / \`elsewhere-non-software\` / \`narrow\`.
+   Do not assume repo-grounded by default. Repo-grounded scans keep the
+   broadest frame minimum; narrow and non-repo modes use the smaller minimum
+   shown below.
 3. **Mode-aware grounding (parallel).**
    - Repo-grounded: repo signal scan + \`${RUNTIME_ROOT}/knowledge.jsonl\`
      repetition scan.
@@ -68,7 +71,9 @@ same session, or save/discard the backlog.
 4. **Divergent ideation frames (parallel).** Generate candidates with
    configured frames (${frames.length} total):
 ${frameBullets}
-   Keep at least ${minimumDistinctFrames} distinct frame outputs in every run.
+   Keep at least ${minimumDistinctFrames} distinct frame outputs in this rendered mode.
+   Deterministic minimum: repo-grounded = 4, narrow/non-repo = 2, always capped
+   by configured frame count.
 5. **Adversarial critique pass.** For each candidate, write the strongest
    counter-argument, kill weak ideas, and keep survivors only.
 6. **Produce 5-10 survivors** with impact (High/Medium/Low),
@@ -91,7 +96,7 @@ ${frameBullets}
 For skill-to-skill invocation, emit exactly one JSON envelope:
 
 \`\`\`json
-{"version":"1","kind":"stage-output","stage":"brainstorm","payload":{"command":"/cc-ideate","artifact":".cclaw/artifacts/ideate-<date>-<slug>.md","recommendation":"I-1"},"emittedAt":"<ISO-8601>"}
+{"version":"1","kind":"stage-output","stage":"non-flow","payload":{"command":"/cc-ideate","artifact":".cclaw/artifacts/ideate-<date>-<slug>.md","recommendation":"I-1"},"emittedAt":"<ISO-8601>"}
 \`\`\`
 
 Validate envelopes with:
@@ -105,7 +110,7 @@ Validate envelopes with:
 export function ideateCommandSkillMarkdown(options = {}) {
     const frames = resolveIdeateFrames(options.frameIds);
     const frameBullets = renderFrameBullets(options.frameIds);
-    const minimumDistinctFrames = Math.min(4, frames.length);
+    const minimumDistinctFrames = minimumDistinctIdeateFrames(frames.length, options.mode);
     const frameNames = renderFrameNames(options.frameIds);
     return `---
 name: ${IDEATE_SKILL_NAME}
@@ -122,6 +127,7 @@ repository. Will persist a ranked backlog to
 
 ## HARD-GATE
 
+${conversationLanguagePolicyMarkdown()}
 - Do not start coding in ideate mode.
 - Do not mutate \`.cclaw/state/flow-state.json\` — ideate mode sits outside
   the critical-path flow.
@@ -148,6 +154,7 @@ repository. Will persist a ranked backlog to
    - \`repo-grounded\` — explicitly tied to this repository.
    - \`elsewhere-software\` — software problem not tied to this repository.
    - \`elsewhere-non-software\` — process/business/non-software problem.
+   - \`narrow\` — a focused prompt where broad frame coverage would be performative.
 6. Record the chosen mode in the artifact.
 
 ### Phase 1 — Mode-aware grounding
@@ -161,8 +168,7 @@ Run grounding in parallel where available:
   - Module size outliers (\`wc -l\` or \`du\`) with weak direct test coverage.
   - Docs drift: check that \`README.md\` / \`docs/\` reference files that still
     exist and flags/APIs that still match \`src/\`.
-  - \`${RUNTIME_ROOT}/knowledge.jsonl\` entries with \`type: "heuristic"\`
-    or repeated \`subject:\` values.
+  - \`${RUNTIME_ROOT}/knowledge.jsonl\` entries with recurring \`type\` in \`rule | pattern | lesson | compound\` and repeated \`trigger/action\` pairs; prefer clusters that already show stable \`origin_run\` history.
 - For \`elsewhere-software\`:
   - Gather current framework/library docs first.
   - Add one comparison scan for established solutions.
@@ -177,8 +183,11 @@ Generate candidate ideas by frame, in parallel when possible:
 
 ${frameBullets}
 
-Require at least ${minimumDistinctFrames} distinct frames in every run. Avoid frame-collapse
-(same idea rewritten 6 times). Keep raw outputs for auditability.
+Require at least ${minimumDistinctFrames} distinct frames in this rendered mode. The
+runtime rule is deterministic: repo-grounded scans require 4 distinct frames;
+narrow, elsewhere-software, and elsewhere-non-software runs require 2; all modes
+are capped by the configured frame count. Avoid frame-collapse (same idea
+rewritten many times). Keep raw outputs for auditability.
 
 ### Phase 3 — Critique all, keep survivors
 
@@ -217,7 +226,7 @@ Only survivors advance to ranking.
    # Ideation — <date>
 
    **Focus:** <user-supplied focus or "open-ended scan">
-   **Mode:** <repo-grounded | elsewhere-software | elsewhere-non-software>
+   **Mode:** <repo-grounded | elsewhere-software | elsewhere-non-software | narrow>
    **Generated:** <ISO-8601 timestamp>
    **Frames used:** <comma-separated list>
    **Raw candidates:** <N>
@@ -239,15 +248,15 @@ Only survivors advance to ranking.
 
    | ID | Improvement | Impact | Effort | Confidence | Evidence |
    |---|---|---|---|---|---|
-   | I-1 | Fix feature-worktree test timeouts | High | S | High | tests/unit/feature-system.test.ts:31 |
+| I-1 | Simplify a confusing generated prompt surface | High | S | High | <path-to-generated-surface> |
    | …   | …                                  | …    | … | …    | …                                     |
 
    ## Candidate detail
 
-   ### I-1 — Fix feature-worktree test timeouts
-   - **Evidence:** \`npm test\` hangs 40s on tests/unit/feature-system.test.ts:31.
-   - **Counter-argument:** Fix may hide deeper orchestration race.
-   - **Handoff:** \`/cc Fix feature-worktree test timeouts on macOS\`
+### I-1 — Simplify a confusing generated prompt surface
+- **Evidence:** \`<path>\` contains repeated or stale guidance that a user would see.
+- **Counter-argument:** Trimming too hard can remove useful orientation for new users.
+- **Handoff:** \`/cc Simplify the confusing generated prompt surface while preserving behavior\`
 
    ### I-2 — …
    \`\`\`

package/dist/content/iron-laws.d.ts

@@ -79,8 +79,8 @@ export declare const IRON_LAWS: readonly [{
     readonly title: "Review layers are sequential";
     readonly rule: "Review stage must complete Layer 1 spec compliance before Layer 2 quality/security passes.";
     readonly rationale: "Stops premature quality discussion when acceptance criteria are not yet satisfied.";
-    readonly enforcement: "advisory";
-    readonly severity: "soft-gate";
+    readonly enforcement: "PreToolUse";
+    readonly severity: "hard-gate";
     readonly appliesTo: ["review"];
 }, {
     readonly id: "review-criticals-close-before-ship";
@@ -123,9 +123,9 @@ export declare const IRON_LAWS: readonly [{
     readonly severity: "hard-gate";
     readonly appliesTo: "all";
 }, {
-    readonly id: "stop-clean-or-checkpointed";
-    readonly title: "Stop only from clean checkpoint";
-    readonly rule: "Do not end a session with dirty state unless checkpoint explicitly records unresolved work and blockers.";
+    readonly id: "stop-clean-or-handoff";
+    readonly title: "Stop only from clean handoff";
+    readonly rule: "Do not end a session with dirty state unless the current artifact records unresolved work and blockers.";
     readonly rationale: "Protects continuity and prevents silent half-finished sessions.";
     readonly enforcement: "Stop";
     readonly severity: "hard-gate";

package/dist/content/iron-laws.js

@@ -49,8 +49,8 @@ export const IRON_LAWS = [
         title: "Review layers are sequential",
         rule: "Review stage must complete Layer 1 spec compliance before Layer 2 quality/security passes.",
         rationale: "Stops premature quality discussion when acceptance criteria are not yet satisfied.",
-        enforcement: "advisory",
-        severity: "soft-gate",
+        enforcement: "PreToolUse",
+        severity: "hard-gate",
         appliesTo: ["review"]
     },
     {
@@ -99,9 +99,9 @@ export const IRON_LAWS = [
         appliesTo: "all"
     },
     {
-        id: "stop-clean-or-checkpointed",
-        title: "Stop only from clean checkpoint",
-        rule: "Do not end a session with dirty state unless checkpoint explicitly records unresolved work and blockers.",
+        id: "stop-clean-or-handoff",
+        title: "Stop only from clean handoff",
+        rule: "Do not end a session with dirty state unless the current artifact records unresolved work and blockers.",
         rationale: "Protects continuity and prevents silent half-finished sessions.",
         enforcement: "Stop",
         severity: "hard-gate",

package/dist/content/language-policy.d.ts

@@ -0,0 +1,2 @@
+export declare function conversationLanguagePolicyMarkdown(): string;
+export declare function conversationLanguagePolicyBullets(): string;

package/dist/content/language-policy.js

@@ -0,0 +1,13 @@
+export function conversationLanguagePolicyMarkdown() {
+    return `## Conversation Language Policy
+
+- Infer the user-facing language from the latest substantive user message.
+- Write user-facing prose, summaries, recommendations, and structured question text/options in that language unless the user asks otherwise.
+- Do not translate stable machine surfaces: commands, file paths, stage ids, gate ids, JSON keys, enum/status values, artifact headings/frontmatter, logs, code identifiers, and quoted source text.
+- If the request mixes languages, use the language of the actual ask sentence for narrative output.
+`;
+}
+export function conversationLanguagePolicyBullets() {
+    return `- User-facing narrative follows the latest substantive user message language.
+- Do not translate commands, paths, ids, JSON keys/enums, artifact headings, logs, code identifiers, or quoted source.`;
+}

package/dist/content/learnings.d.ts

@@ -1,9 +1,8 @@
 /**
  * Canonical required JSONL field order (matches strict validator keys).
- * Optional keys (for now: `source`, `severity`) may be appended after these
- * required fields.
+ * Optional keys (`source`, `severity`, `supersedes`, `superseded_by`) may
+ * be appended after these required fields.
  * Exported for tests and any programmatic writer that wants a stable base shape.
  */
-export declare const KNOWLEDGE_JSONL_FIELDS: readonly ["type", "trigger", "action", "confidence", "domain", "stage", "origin_stage", "origin_feature", "frequency", "universality", "maturity", "created", "first_seen_ts", "last_seen_ts", "project"];
+export declare const KNOWLEDGE_JSONL_FIELDS: readonly ["type", "trigger", "action", "confidence", "domain", "stage", "origin_stage", "origin_run", "frequency", "universality", "maturity", "created", "first_seen_ts", "last_seen_ts", "project"];
 export declare function learnSkillMarkdown(): string;
-export declare function learnCommandContract(): string;