create-principles-disciple 1.94.0 → 1.96.0

package/core/dist/runtime-v2/intent/intent-decision-record.d.ts

@@ -0,0 +1,125 @@
+/**
+ * IntentDecisionRecord — durable audit record of Owner decisions on surfaced
+ * intentTension (PRI-470, SPEC §21.7).
+ *
+ * Owner decisions on intentTension MUST form an auditable record. This module
+ * defines the pure types and the store interface; the SQLite implementation
+ * lives in `runtime-v2/store/intent/`.
+ *
+ * Persistence boundary (SPEC §21.7):
+ * - Records are durable (state.db `intent_decisions` table), never transient.
+ * - Same `painId + intentDocHash + ownerAction` resubmission is idempotent.
+ * - Records are refresh-safe: read side can query by painId / taskId.
+ * - Write failure fails loud with reason + nextAction.
+ *
+ * ERR checklist:
+ * - EP-01 / ERR-001, ERR-005: enum fields validated via type guards, never `as`
+ * - EP-03 / ERR-002: store failures surface reason, never silent
+ * - EP-09: pure types — independently usable without I/O mocks
+ */
+import type { IntentTensionSource, EvidenceStrength, IntentRelatedField, SuggestedOwnerAction } from '../diagnostician/diag-rootcause-output.js';
+/**
+ * Durable record of an Owner decision on a surfaced intentTension.
+ *
+ * Per SPEC §21.7, this is the minimal auditable field set. `evidenceRefs`
+ * MUST point to Pain Evidence, trace, Owner correction, or an INTENT field.
+ */
+export interface IntentDecisionRecord {
+    id: string;
+    painId?: string;
+    taskId?: string;
+    runId?: string;
+    intentDocHash?: string;
+    source: IntentTensionSource;
+    evidenceStrength: EvidenceStrength;
+    relatedIntentFields: IntentRelatedField[];
+    ownerAction: SuggestedOwnerAction;
+    evidenceRefs: string[];
+    resultingCandidateId?: string;
+    resultingRuleCandidateId?: string;
+    patchProposalId?: string;
+    createdAt: string;
+}
+/**
+ * Input for creating an IntentDecisionRecord.
+ *
+ * `id` is caller-supplied so the Console API can return the canonical id
+ * before persistence completes. `note` is an optional Owner free-text note
+ * that the store persists alongside the decision.
+ */
+export interface IntentDecisionInput {
+    id: string;
+    painId?: string;
+    taskId?: string;
+    runId?: string;
+    intentDocHash?: string;
+    source: IntentTensionSource;
+    evidenceStrength: EvidenceStrength;
+    relatedIntentFields: IntentRelatedField[];
+    ownerAction: SuggestedOwnerAction;
+    evidenceRefs: string[];
+    note?: string;
+}
+/**
+ * Result of recording a decision.
+ *
+ * `created=false` means an idempotent hit — the same decision already exists
+ * and `record` is the pre-existing record. Callers SHOULD return 200 (not 201)
+ * in this case so clients can distinguish a fresh write from a replay.
+ */
+export interface IntentDecisionRecordResult {
+    record: IntentDecisionRecord;
+    created: boolean;
+}
+/**
+ * Lightweight audit summary derived from IntentDecisionRecord (SPEC §22.1.1).
+ *
+ * `counts` holds a tally per SuggestedOwnerAction (every key is present,
+ * defaulting to 0). `lastDecisionAt` is the most recent `createdAt` across
+ * all records, or null when no records exist.
+ */
+export interface IntentDecisionSummary {
+    counts: Record<SuggestedOwnerAction, number>;
+    lastDecisionAt: string | null;
+}
+/**
+ * Patch for updating follow-up action fields on an existing IntentDecisionRecord.
+ * Used by PRI-471 to record which follow-up action was dispatched after the
+ * Owner decision was persisted (SPEC §22.1.4).
+ *
+ * Only one field should be set per call — each follow-up type is independent.
+ * Setting a field to `undefined` leaves it unchanged; the store only updates
+ * fields that are explicitly provided.
+ */
+export interface FollowUpPatch {
+    resultingCandidateId?: string;
+    resultingRuleCandidateId?: string;
+    patchProposalId?: string;
+}
+/**
+ * Durable store contract for IntentDecisionRecord (SPEC §21.7 persistence).
+ *
+ * Implementations MUST:
+ * - Be idempotent on (painId + intentDocHash + ownerAction) when painId is
+ *   non-null; fall back to (taskId + intentDocHash + ownerAction) when painId
+ *   is null.
+ * - Store immutable snapshots of source / evidenceStrength /
+ *   relatedIntentFields / evidenceRefs so the audit trail stays accurate even
+ *   if the underlying artifact is later modified.
+ * - Truncate evidence to max 3 items before storing.
+ * - Fail loud (throw) on write failure — never return a silent "success".
+ */
+export interface IntentDecisionStore {
+    record(input: IntentDecisionInput): Promise<IntentDecisionRecordResult>;
+    getById(id: string): Promise<IntentDecisionRecord | null>;
+    listByPainId(painId: string): Promise<IntentDecisionRecord[]>;
+    listByTaskId(taskId: string): Promise<IntentDecisionRecord[]>;
+    getSummary(): Promise<IntentDecisionSummary>;
+    /**
+     * Update follow-up action fields on an existing record (PRI-471, SPEC §22.1.4).
+     * Returns the updated record, or null if the record does not exist.
+     * Only fields present in `patch` are updated; others remain unchanged.
+     */
+    updateFollowUp(id: string, patch: FollowUpPatch): Promise<IntentDecisionRecord | null>;
+}
+//# sourceMappingURL=intent-decision-record.d.ts.map

package/core/dist/runtime-v2/intent/intent-decision-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-decision-record.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-decision-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,2CAA2C,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,WAAW,EAAE,oBAAoB,CAAC;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,WAAW,EAAE,oBAAoB,CAAC;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC1D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC9D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC9D,UAAU,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7C;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACxF"}

package/core/dist/runtime-v2/intent/intent-decision-record.js

@@ -0,0 +1,21 @@
+/**
+ * IntentDecisionRecord — durable audit record of Owner decisions on surfaced
+ * intentTension (PRI-470, SPEC §21.7).
+ *
+ * Owner decisions on intentTension MUST form an auditable record. This module
+ * defines the pure types and the store interface; the SQLite implementation
+ * lives in `runtime-v2/store/intent/`.
+ *
+ * Persistence boundary (SPEC §21.7):
+ * - Records are durable (state.db `intent_decisions` table), never transient.
+ * - Same `painId + intentDocHash + ownerAction` resubmission is idempotent.
+ * - Records are refresh-safe: read side can query by painId / taskId.
+ * - Write failure fails loud with reason + nextAction.
+ *
+ * ERR checklist:
+ * - EP-01 / ERR-001, ERR-005: enum fields validated via type guards, never `as`
+ * - EP-03 / ERR-002: store failures surface reason, never silent
+ * - EP-09: pure types — independently usable without I/O mocks
+ */
+export {};
+//# sourceMappingURL=intent-decision-record.js.map

package/core/dist/runtime-v2/intent/intent-decision-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-decision-record.js","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-decision-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/core/dist/runtime-v2/intent/intent-doc-reader-port.d.ts

@@ -0,0 +1,95 @@
+/**
+ * IntentDocReader — port interface for reading INTENT.md from the plugin layer.
+ *
+ * PRI-468 / SPEC §12 — the diagnostician Stage A runner needs INTENT.md
+ * content to optionally produce `intentTension`. Core cannot do I/O, so it
+ * defines this port; the plugin provides a concrete implementation that
+ * wraps `safeReadIntentDoc()` with feature-flag checking.
+ *
+ * Contract (SPEC §12):
+ *   - When `intent_engineering` flag is off, implementations MUST return
+ *     `{ ok: false, flagEnabled: false, reason: 'flag_disabled' }` WITHOUT
+ *     any filesystem access.
+ *   - Implementations MUST NOT throw — all error paths return a structured
+ *     `reason` + `nextAction` (EP-03 / ERR-002: no silent fallback).
+ *   - `doc.raw` is unescaped; the caller is responsible for escaping when
+ *     injecting into a prompt (SPEC §12.2 trust boundary).
+ *
+ * This interface is intentionally minimal — it returns only the fields the
+ * diagnostician runner needs: `raw` (for prompt injection) and
+ * `contentHash` (for `intentTension.intentDocHash` lineage). Validation
+ * warnings are NOT surfaced here because the diagnostician does not act on
+ * them; they remain visible via `pd intent show`.
+ */
+/**
+ * A successfully read INTENT.md reference.
+ *
+ * `raw` is the unescaped file content. `contentHash` is the SHA-256 hash
+ * used for `intentTension.intentDocHash` lineage (SPEC §16.2).
+ */
+export interface IntentDocReference {
+    /** Raw INTENT.md content (unescaped — caller escapes for prompt injection). */
+    readonly raw: string;
+    /** SHA-256 content hash for deduplication and audit (e.g. "sha256:abc..."). */
+    readonly contentHash: string;
+    /** Absolute path to the INTENT.md file (for telemetry only — never read by core). */
+    readonly path: string;
+}
+/**
+ * Structured reason for a degraded read path.
+ *
+ * Mirrors `SafeReadIntentDocReason` from the plugin layer (PRI-467), but
+ * defined here so core has no plugin-layer import.
+ */
+export type IntentDocReadReason = 'flag_disabled' | 'not_found' | 'oversized' | 'read_error';
+/**
+ * Result of reading INTENT.md.
+ *
+ * When `ok === true`, `doc` is present. When `ok === false`, `reason` and
+ * `nextAction` are present (EP-03 / ERR-002: no silent fallback).
+ */
+export interface IntentDocReadResult {
+    /** True when the doc was successfully read and parsed. */
+    readonly ok: boolean;
+    /** True when the INTENT.md file exists on disk (false when not_found). */
+    readonly found: boolean;
+    /** True when the intent_engineering flag is enabled. */
+    readonly flagEnabled: boolean;
+    /** The parsed IntentDoc, present only when ok=true. */
+    readonly doc?: IntentDocReference;
+    /** Structured reason for a degraded path (present when ok=false). */
+    readonly reason?: IntentDocReadReason;
+    /** Next action for the operator (present when ok=false). */
+    readonly nextAction?: string;
+}
+/**
+ * Port interface for reading INTENT.md.
+ *
+ * Core defines this interface; the plugin provides a concrete implementation
+ * that wraps `safeReadIntentDoc(workspaceDir)` with feature-flag checking.
+ *
+ * The implementation is expected to be a closure bound to a specific
+ * workspaceDir (created in `pain-signal-runtime-factory.ts`), so this
+ * method takes no arguments.
+ */
+export interface IntentDocReader {
+    /**
+     * Read INTENT.md for the bound workspace.
+     *
+     * NEVER throws — all error paths return a structured result.
+     * When `intent_engineering` flag is off, returns `flag_disabled` WITHOUT
+     * any filesystem access (SPEC §12).
+     */
+    readIntentDoc(): IntentDocReadResult;
+}
+/**
+ * No-op IntentDocReader for backward compatibility.
+ *
+ * Used when no reader is provided (e.g., in unit tests that don't care
+ * about INTENT). Always returns `flag_disabled` — ensuring the runner
+ * behaves as if the flag is off, producing byte-identical prompts.
+ */
+export declare class NullIntentDocReader implements IntentDocReader {
+    readIntentDoc(): IntentDocReadResult;
+}
+//# sourceMappingURL=intent-doc-reader-port.d.ts.map

package/core/dist/runtime-v2/intent/intent-doc-reader-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-doc-reader-port.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-doc-reader-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC;IAClC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,aAAa,IAAI,mBAAmB,CAAC;CACtC;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IAEzD,aAAa,IAAI,mBAAmB;CASrC"}

package/core/dist/runtime-v2/intent/intent-doc-reader-port.js

@@ -0,0 +1,43 @@
+/**
+ * IntentDocReader — port interface for reading INTENT.md from the plugin layer.
+ *
+ * PRI-468 / SPEC §12 — the diagnostician Stage A runner needs INTENT.md
+ * content to optionally produce `intentTension`. Core cannot do I/O, so it
+ * defines this port; the plugin provides a concrete implementation that
+ * wraps `safeReadIntentDoc()` with feature-flag checking.
+ *
+ * Contract (SPEC §12):
+ *   - When `intent_engineering` flag is off, implementations MUST return
+ *     `{ ok: false, flagEnabled: false, reason: 'flag_disabled' }` WITHOUT
+ *     any filesystem access.
+ *   - Implementations MUST NOT throw — all error paths return a structured
+ *     `reason` + `nextAction` (EP-03 / ERR-002: no silent fallback).
+ *   - `doc.raw` is unescaped; the caller is responsible for escaping when
+ *     injecting into a prompt (SPEC §12.2 trust boundary).
+ *
+ * This interface is intentionally minimal — it returns only the fields the
+ * diagnostician runner needs: `raw` (for prompt injection) and
+ * `contentHash` (for `intentTension.intentDocHash` lineage). Validation
+ * warnings are NOT surfaced here because the diagnostician does not act on
+ * them; they remain visible via `pd intent show`.
+ */
+/**
+ * No-op IntentDocReader for backward compatibility.
+ *
+ * Used when no reader is provided (e.g., in unit tests that don't care
+ * about INTENT). Always returns `flag_disabled` — ensuring the runner
+ * behaves as if the flag is off, producing byte-identical prompts.
+ */
+export class NullIntentDocReader {
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    readIntentDoc() {
+        return {
+            ok: false,
+            found: false,
+            flagEnabled: false,
+            reason: 'flag_disabled',
+            nextAction: 'No IntentDocReader configured — intent_engineering is effectively off.',
+        };
+    }
+}
+//# sourceMappingURL=intent-doc-reader-port.js.map

package/core/dist/runtime-v2/intent/intent-doc-reader-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-doc-reader-port.js","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-doc-reader-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAuEH;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAC9B,qEAAqE;IACrE,aAAa;QACX,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,eAAe;YACvB,UAAU,EAAE,wEAAwE;SACrF,CAAC;IACJ,CAAC;CACF"}

package/core/dist/runtime-v2/intent/intent-doc-version.d.ts

@@ -0,0 +1,28 @@
+import { type IntentLang } from './intent-doc.js';
+export interface IntentDocVersion {
+    id: string;
+    lang: IntentLang;
+    contentHash: string;
+    contentSnapshot: string;
+    reason: string | null;
+    createdAt: string;
+}
+export interface IntentDocVersionStore {
+    saveVersion(input: {
+        lang: IntentLang;
+        content: string;
+        reason?: string;
+    }): Promise<IntentDocVersion>;
+    listVersions(lang: IntentLang, limit?: number): Promise<IntentDocVersion[]>;
+    getVersion(id: string): Promise<IntentDocVersion | null>;
+    getLatest(lang: IntentLang): Promise<IntentDocVersion | null>;
+}
+export declare function computeVersionDiff(oldContent: string, newContent: string): {
+    section: string;
+    changed: boolean;
+}[];
+export declare function formatVersionSummary(version: IntentDocVersion, index: number): {
+    label: string;
+    preview: string;
+};
+//# sourceMappingURL=intent-doc-version.d.ts.map

package/core/dist/runtime-v2/intent/intent-doc-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-doc-version.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-doc-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtG,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC5E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACzD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC/D;AAID,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,CAOzC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CASpC"}

package/core/dist/runtime-v2/intent/intent-doc-version.js

@@ -0,0 +1,21 @@
+import { parseIntentDocSections } from './intent-doc.js';
+const SECTION_KEYS = ['why', 'desiredOutcome', 'nonNegotiables', 'stopEscalation', 'currentStrategicFocus'];
+export function computeVersionDiff(oldContent, newContent) {
+    const oldSections = parseIntentDocSections(oldContent);
+    const newSections = parseIntentDocSections(newContent);
+    return SECTION_KEYS.map(key => ({
+        section: key,
+        changed: (oldSections[key] ?? '') !== (newSections[key] ?? ''),
+    }));
+}
+export function formatVersionSummary(version, index) {
+    const versionNumber = `v${index + 1}`;
+    // Language-aware fallback for missing reason (CodeRabbit review):
+    // English versions should not show Chinese default text.
+    const reason = version.reason ?? (version.lang === 'en' ? '(no note)' : '无备注');
+    const label = `${versionNumber} · ${reason}`;
+    const previewText = version.contentSnapshot.replace(/##\s*\d+\.\s*[^\n]*/g, '').trim();
+    const preview = previewText.length > 80 ? previewText.slice(0, 77) + '...' : previewText;
+    return { label, preview };
+}
+//# sourceMappingURL=intent-doc-version.js.map

package/core/dist/runtime-v2/intent/intent-doc-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-doc-version.js","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-doc-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAmB,MAAM,iBAAiB,CAAC;AAkB1E,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,CAAU,CAAC;AAErH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,UAAkB;IAElB,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACvD,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;KAC/D,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAyB,EACzB,KAAa;IAEb,MAAM,aAAa,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IACtC,kEAAkE;IAClE,yDAAyD;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,GAAG,aAAa,MAAM,MAAM,EAAE,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvF,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;IACzF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/core/dist/runtime-v2/intent/intent-doc.d.ts

@@ -0,0 +1,35 @@
+export interface IntentDocSections {
+    why?: string;
+    desiredOutcome?: string;
+    nonNegotiables?: string;
+    stopEscalation?: string;
+    currentStrategicFocus?: string;
+}
+export type IntentDocWarningCode = 'missing_section' | 'empty_section' | 'too_vague' | 'oversized' | 'parse_failed';
+export interface IntentDocWarning {
+    code: IntentDocWarningCode;
+    message: string;
+    section?: string;
+}
+export declare const INTENT_MAX_BYTES: number;
+export declare function parseIntentDocSections(raw: string): IntentDocSections;
+/**
+ * Assemble a complete INTENT.md document from individual sections.
+ *
+ * Symmetric to `parseIntentDocSections`: round-trip
+ * `parseIntentDocSections(assembleIntentDoc(sections))` returns the same
+ * sections (for non-empty content). Missing sections still emit their header
+ * with empty content, so the assembled doc always has all 5 headers in order.
+ *
+ * Used by the wizard and the section editor to save user input without
+ * hand-written string concatenation in the UI layer.
+ */
+export declare function assembleIntentDoc(sections: IntentDocSections): string;
+export declare function validateIntentDocSections(sections: IntentDocSections): IntentDocWarning[];
+export declare const INTENT_DOC_TEMPLATE = "# INTENT.md\n\n## 1. Why\n\nWhy does this project matter?\n\n## 2. Desired Outcome\n\nWhat observable change should happen?\n\n## 3. Non-negotiables\n\nWhat cannot be sacrificed?\n\n## 4. Stop / Escalation\n\nWhen must the Agent stop and ask?\n\n## 5. Current Strategic Focus\n\nWhat is the current strategic trade-off?\n";
+export type IntentLang = 'zh-CN' | 'en';
+export declare function getIntentFilename(lang: IntentLang): string;
+export declare const INTENT_DOC_TEMPLATE_ZH = "# INTENT.md\n\n## 1. Why\n\n\u8FD9\u4E2A\u9879\u76EE / \u9636\u6BB5\u4E3A\u4EC0\u4E48\u91CD\u8981\uFF1F\n\u5B83\u670D\u52A1\u4E8E\u4EC0\u4E48\u957F\u671F\u76EE\u6807\uFF1F\n\u5B83\u4E0D\u53EA\u662F\u8981\u5B8C\u6210\u4EC0\u4E48\u4EFB\u52A1\uFF0C\u800C\u662F\u8981\u89E3\u51B3\u4EC0\u4E48\u771F\u5B9E\u95EE\u9898\uFF1F\n\n## 2. Desired Outcome\n\n\u5B8C\u6210\u540E\uFF0C\u4E16\u754C\u5E94\u8BE5\u53D1\u751F\u4EC0\u4E48\u53EF\u89C2\u5BDF\u7684\u53D8\u5316\uFF1F\n\u4EC0\u4E48\u7ED3\u679C\u80FD\u8BF4\u660E\u6211\u4EEC\u66F4\u63A5\u8FD1\u76EE\u6807\uFF1F\n\u907F\u514D\u5199\"\u8BA9\u4EA7\u54C1\u66F4\u597D\"\u8FD9\u79CD\u4E0D\u53EF\u6BD4\u8F83\u63CF\u8FF0\u3002\n\n## 3. Non-negotiables\n\n\u4E3A\u4E86\u8FBE\u6210\u76EE\u6807\uFF0C\u54EA\u4E9B\u4E1C\u897F\u4E0D\u80FD\u88AB\u727A\u7272\uFF1F\n\u4F8B\u5982\uFF1AOwner \u6CE8\u610F\u529B\u3001\u7528\u6237\u4FE1\u4EFB\u3001MVP \u901F\u5EA6\u3001\u5B89\u5168\u8FB9\u754C\u3001\u53EF\u7EF4\u62A4\u6027\u3001\u54C1\u724C\u8C03\u6027\u3002\n\n## 4. Stop / Escalation\n\n\u4EC0\u4E48\u60C5\u51B5\u4E0B Agent \u5FC5\u987B\u505C\u4E0B\u3001\u8BE2\u95EE\u6216\u5347\u7EA7\u7ED9 Owner\uFF1F\n\n\u6CE8\u610F\uFF1A\u8FD9\u4E9B\u662F\u8F6F\u5347\u7EA7\u6761\u4EF6\uFF1B\u9664\u975E\u53E6\u884C\u7F16\u7801\u8FDB RuleHost\uFF0C\u5426\u5219\u4E0D\u6784\u6210\u786C\u62E6\u622A\u3002\n\n## 5. Current Strategic Focus\n\n\u5F53\u524D\u9636\u6BB5\u6700\u91CD\u8981\u7684\u6218\u7565\u53D6\u820D\u662F\u4EC0\u4E48\uFF1F\n\u4F8B\u5982\uFF1A\u9A8C\u8BC1\u75DB\u70B9\u4F18\u5148\u4E8E\u67B6\u6784\u5B8C\u7F8E\uFF1B\u53D1\u5E03 MVP \u4F18\u5148\u4E8E\u529F\u80FD\u5B8C\u6574\uFF1B\u4FDD\u62A4 Owner \u6CE8\u610F\u529B\u4F18\u5148\u4E8E\u81EA\u52A8\u5316\u8986\u76D6\u7387\u3002\n";
+export declare const INTENT_DOC_TEMPLATE_EN = "# INTENT.md\n\n## 1. Why\n\nWhy does this project matter?\nWhat long-term goal does it serve?\nWhat real problem does it solve \u2014 beyond just completing tasks?\n\n## 2. Desired Outcome\n\nAfter completion, what observable change should happen in the world?\nWhat result would indicate we are closer to the goal?\nAvoid non-comparable descriptions like \"make the product better\".\n\n## 3. Non-negotiables\n\nTo achieve the goal, what cannot be sacrificed?\nExamples: Owner attention, user trust, MVP speed, security boundaries, maintainability, brand voice.\n\n## 4. Stop / Escalation\n\nUnder what circumstances must the Agent stop, ask, or escalate to Owner?\n\nNote: These are soft escalation conditions; unless separately encoded into RuleHost, they do not constitute hard blocks.\n\n## 5. Current Strategic Focus\n\nWhat is the most important strategic trade-off for the current phase?\nExamples: Validating pain points over architectural perfection; Shipping MVP over feature completeness; Protecting Owner attention over automation coverage.\n";
+export declare function createIntentTemplate(lang: IntentLang): string;
+//# sourceMappingURL=intent-doc.d.ts.map

package/core/dist/runtime-v2/intent/intent-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-doc.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-doc.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAAG,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAAE;AAC/J,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;AACpH,MAAM,WAAW,gBAAgB;IAAG,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAAE;AACpG,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAU1C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAYrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAQrE;AACD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,CAWzF;AACD,eAAO,MAAM,mBAAmB,sUAqB/B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;AAExC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAE1D;AAED,eAAO,MAAM,sBAAsB,8qDA6BlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,oiCA6BlC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAG7D"}

package/core/dist/runtime-v2/intent/intent-doc.js

@@ -0,0 +1,158 @@
+export const INTENT_MAX_BYTES = 32 * 1024;
+const MIN_SECTION_LENGTH = 10;
+const SECTION_DEFS = [
+    { key: 'why', headerRegex: /^##\s+1\.\s*Why\s*$/im, label: 'why', header: '## 1. Why' },
+    { key: 'desiredOutcome', headerRegex: /^##\s+2\.\s*Desired Outcome\s*$/im, label: 'desiredOutcome', header: '## 2. Desired Outcome' },
+    { key: 'nonNegotiables', headerRegex: /^##\s+3\.\s*Non-negotiables\s*$/im, label: 'nonNegotiables', header: '## 3. Non-negotiables' },
+    { key: 'stopEscalation', headerRegex: /^##\s+4\.\s*Stop\s*\/\s*Escalation\s*$/im, label: 'stopEscalation', header: '## 4. Stop / Escalation' },
+    { key: 'currentStrategicFocus', headerRegex: /^##\s+5\.\s*Current Strategic Focus\s*$/im, label: 'currentStrategicFocus', header: '## 5. Current Strategic Focus' },
+];
+export function parseIntentDocSections(raw) {
+    const sections = {};
+    for (const def of SECTION_DEFS) {
+        const match = def.headerRegex.exec(raw);
+        if (match === null) {
+            continue;
+        }
+        const rest = raw.slice(match.index + match[0].length);
+        const next = /^##\s+/m.exec(rest);
+        // Direct assignment is type-safe: def.key is keyof IntentDocSections,
+        // all fields are `string | undefined`, and we assign a string.
+        sections[def.key] = rest.slice(0, next !== null ? next.index : rest.length).trim();
+    }
+    return sections;
+}
+/**
+ * Assemble a complete INTENT.md document from individual sections.
+ *
+ * Symmetric to `parseIntentDocSections`: round-trip
+ * `parseIntentDocSections(assembleIntentDoc(sections))` returns the same
+ * sections (for non-empty content). Missing sections still emit their header
+ * with empty content, so the assembled doc always has all 5 headers in order.
+ *
+ * Used by the wizard and the section editor to save user input without
+ * hand-written string concatenation in the UI layer.
+ */
+export function assembleIntentDoc(sections) {
+    const parts = ['# INTENT.md', ''];
+    for (const def of SECTION_DEFS) {
+        const value = sections[def.key];
+        const content = typeof value === 'string' ? value : '';
+        parts.push(def.header, '', content, '');
+    }
+    return parts.join('\n');
+}
+export function validateIntentDocSections(sections) {
+    const warnings = [];
+    for (const def of SECTION_DEFS) {
+        const hasKey = Object.hasOwn(sections, def.key);
+        const value = hasKey ? sections[def.key] : undefined;
+        if (value === undefined) {
+            warnings.push({ code: 'missing_section', message: `Section "${def.label}" is missing from INTENT.md.`, section: def.label });
+            continue;
+        }
+        if (typeof value !== 'string') {
+            warnings.push({ code: 'parse_failed', message: `Section "${def.label}" has a non-string value.`, section: def.label });
+            continue;
+        }
+        if (value.trim().length === 0) {
+            warnings.push({ code: 'empty_section', message: `Section "${def.label}" is empty.`, section: def.label });
+            continue;
+        }
+        if (value.length < MIN_SECTION_LENGTH) {
+            warnings.push({ code: 'too_vague', message: `Section "${def.label}" is too short.`, section: def.label });
+        }
+    }
+    return warnings;
+}
+export const INTENT_DOC_TEMPLATE = `# INTENT.md
+
+## 1. Why
+
+Why does this project matter?
+
+## 2. Desired Outcome
+
+What observable change should happen?
+
+## 3. Non-negotiables
+
+What cannot be sacrificed?
+
+## 4. Stop / Escalation
+
+When must the Agent stop and ask?
+
+## 5. Current Strategic Focus
+
+What is the current strategic trade-off?
+`;
+export function getIntentFilename(lang) {
+    return `INTENT.${lang}.md`;
+}
+export const INTENT_DOC_TEMPLATE_ZH = `# INTENT.md
+
+## 1. Why
+
+这个项目 / 阶段为什么重要？
+它服务于什么长期目标？
+它不只是要完成什么任务，而是要解决什么真实问题？
+
+## 2. Desired Outcome
+
+完成后，世界应该发生什么可观察的变化？
+什么结果能说明我们更接近目标？
+避免写"让产品更好"这种不可比较描述。
+
+## 3. Non-negotiables
+
+为了达成目标，哪些东西不能被牺牲？
+例如：Owner 注意力、用户信任、MVP 速度、安全边界、可维护性、品牌调性。
+
+## 4. Stop / Escalation
+
+什么情况下 Agent 必须停下、询问或升级给 Owner？
+
+注意：这些是软升级条件；除非另行编码进 RuleHost，否则不构成硬拦截。
+
+## 5. Current Strategic Focus
+
+当前阶段最重要的战略取舍是什么？
+例如：验证痛点优先于架构完美；发布 MVP 优先于功能完整；保护 Owner 注意力优先于自动化覆盖率。
+`;
+export const INTENT_DOC_TEMPLATE_EN = `# INTENT.md
+
+## 1. Why
+
+Why does this project matter?
+What long-term goal does it serve?
+What real problem does it solve — beyond just completing tasks?
+
+## 2. Desired Outcome
+
+After completion, what observable change should happen in the world?
+What result would indicate we are closer to the goal?
+Avoid non-comparable descriptions like "make the product better".
+
+## 3. Non-negotiables
+
+To achieve the goal, what cannot be sacrificed?
+Examples: Owner attention, user trust, MVP speed, security boundaries, maintainability, brand voice.
+
+## 4. Stop / Escalation
+
+Under what circumstances must the Agent stop, ask, or escalate to Owner?
+
+Note: These are soft escalation conditions; unless separately encoded into RuleHost, they do not constitute hard blocks.
+
+## 5. Current Strategic Focus
+
+What is the most important strategic trade-off for the current phase?
+Examples: Validating pain points over architectural perfection; Shipping MVP over feature completeness; Protecting Owner attention over automation coverage.
+`;
+export function createIntentTemplate(lang) {
+    if (lang === 'zh-CN')
+        return INTENT_DOC_TEMPLATE_ZH;
+    return INTENT_DOC_TEMPLATE_EN;
+}
+//# sourceMappingURL=intent-doc.js.map

package/core/dist/runtime-v2/intent/intent-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-doc.js","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-doc.ts"],"names":[],"mappings":"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"}

package/core/dist/runtime-v2/intent/intent-friction-block.d.ts

@@ -0,0 +1,63 @@
+/**
+ * PRI-467 — Pure builder for the Intent Friction Prompt Block.
+ *
+ * Produces a bounded, escaped `<intent_anchor>` + `<intent_doc>` +
+ * `<intent_friction>` block per SPEC §13.2 and §13.3.
+ *
+ * Trust boundary (SPEC §12.2):
+ * - INTENT.md is treated as quoted reference data, never as executable
+ *   system/tool instructions.
+ * - Raw content is XML-escaped before embedding so it cannot break the
+ *   surrounding prompt block structure or inject live XML tags.
+ * - Content is bounded to INTENT_INJECT_MAX_CHARS to avoid prompt budget
+ *   explosion; oversized content is truncated with a visible marker.
+ *
+ * Pure logic — no I/O, no side effects, never throws. Callers that have
+ * no intent doc (flag off, missing file, read error) should pass `undefined`
+ * and receive an empty string.
+ *
+ * ERR checklist:
+ * EP-01 / ERR-001, ERR-005, ERR-009: input validated with typeof, never `as`
+ * EP-03 / ERR-002: missing/invalid input returns empty string, never throws
+ * EP-09: pure function — independently unit-testable without mocks
+ */
+/**
+ * Maximum number of characters of raw INTENT.md content injected into the
+ * prompt. Oversized content is truncated with a visible marker so the Agent
+ * still knows the doc was bounded.
+ *
+ * SPEC §12.2 requires bounded injection. 4000 chars is well within the
+ * prompt hook size guard budget (9000 chars total) and leaves room for
+ * other appendSystemContext blocks.
+ */
+export declare const INTENT_INJECT_MAX_CHARS = 4000;
+/**
+ * Input to buildIntentFrictionBlock. `rawIntentMd` is the raw, unescaped
+ * INTENT.md file content. The builder escapes and bounds it.
+ */
+export interface IntentFrictionBlockInput {
+    rawIntentMd: string;
+}
+/**
+ * Truncation marker appended when raw intent content exceeds the budget.
+ * Kept as a constant so tests can match it exactly.
+ */
+export declare const INTENT_TRUNCATION_MARKER = "\n...[truncated: intent doc exceeds injection budget]";
+/**
+ * Build the Intent Friction Prompt Block (SPEC §13.2 + §13.3).
+ *
+ * Returns an empty string when:
+ * - input is undefined (flag-off / no-doc path)
+ * - rawIntentMd is not a string
+ * - rawIntentMd is empty or whitespace-only
+ *
+ * Otherwise returns a string containing three XML blocks:
+ * 1. `<intent_anchor>` — declares INTENT as Owner-owned quoted reference
+ * 2. `<intent_doc>` — bounded + XML-escaped raw intent content
+ * 3. `<intent_friction>` — instructions for the optional intent_check format
+ *
+ * The function never throws. Callers can safely pipe the result into
+ * appendSystemContext assembly.
+ */
+export declare function buildIntentFrictionBlock(input: IntentFrictionBlockInput | undefined): string;
+//# sourceMappingURL=intent-friction-block.d.ts.map

package/core/dist/runtime-v2/intent/intent-friction-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-friction-block.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/intent/intent-friction-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,0DACoB,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,wBAAwB,GAAG,SAAS,GAC1C,MAAM,CA8ER"}