@manehorizons/cadence-core 1.1.1

package/dist/gates/types.d.ts

@@ -0,0 +1,202 @@
+import type { AnomalyEvent, CadenceConfig, CadenceState, DeepVerdict, Draft, Finding, GateSet } from '@manehorizons/cadence-types';
+import type { VerifyInput, VerifyResult, VerifyTestRef } from '../verify/verifier.js';
+import type { InteractiveVerdict } from '../verify/interactive.js';
+import type { Prompter } from '../verify/prompter.js';
+import type { CodeReviewInput, CodeReviewResult, Finding as CodeReviewFinding } from '../verify/code-review.js';
+import type { SecurityAuditInput, SecurityAuditResult } from '../verify/security-audit.js';
+/** Canonical PROGRESS.json shape settle reads. settle.ts imports this (and
+ *  AcResult below) rather than redefining them locally. */
+export interface ProgressJson {
+    draftId: string;
+    tasks: Record<string, {
+        status: string;
+        notes: string;
+        touchedFiles: string[];
+        updatedAt: string;
+    }>;
+}
+/** An AC verdict row destined for SUMMARY.acResults. */
+export interface AcResult {
+    id: string;
+    pass: boolean;
+    note?: string;
+}
+/** Stderr seam. Defaults to process.stderr.write; tests inject a capture. */
+export interface IoPort {
+    err(s: string): void;
+}
+/**
+ * Injected verifier collaborators. Phase 40.1 consolidates behind this; gates
+ * never import a *-factory directly. 39.1 defines ONLY `deep` (what it
+ * exercises); 39.4/39.5 add members when those gates are extracted.
+ */
+export interface VerifierPorts {
+    readonly deep: {
+        verify(input: VerifyInput): Promise<VerifyResult>;
+    };
+    /** Code-review verifier (Phase 39.4), lazily `selectCodeReviewVerifier`. */
+    readonly codeReview: {
+        verify(input: CodeReviewInput): Promise<CodeReviewResult>;
+    };
+    /** Security-audit verifier (Phase 39.5), lazily `selectSecurityAuditVerifier`. */
+    readonly securityAudit: {
+        verify(input: SecurityAuditInput): Promise<SecurityAuditResult>;
+    };
+}
+/**
+ * Notification collaborator. Phase 42.1 consolidates the emitUnconverged spine
+ * behind this. 39.1 defines only the `anomalies` finalizer hook it needs;
+ * 39.4/39.7 add `codeReviewHigh`/`unconverged` members when those gates land.
+ */
+export interface EmitPort {
+    anomalies(events: AnomalyEvent[]): Promise<void>;
+    /** code-review-high anomalies (Phase 39.4). Wraps emitCodeReviewHigh over the
+     *  selected notifier; the anomaly-notify membership guard is the gate's. */
+    codeReviewHigh(findings: Record<string, CodeReviewFinding[]>, info: {
+        provider: string;
+        bypassed: boolean;
+    }): Promise<void>;
+    /** code-review unconverged escalation anomaly (Phase 39.4). */
+    codeReviewUnconverged(info: {
+        draftId: string;
+        attempts: number;
+        maxAttempts: number;
+        findings: number;
+        provider: string;
+        model?: string;
+        bypassed?: boolean;
+    }): Promise<void>;
+    /** skill-audit-miss anomaly (Phase 39.6 — checks/skill-audit). Wraps
+     *  emitSkillAuditMiss over the selected notifier. UNCONDITIONAL — NOT under the
+     *  anomaly-notify guard (a strict phase failing the requirement must still
+     *  leave an audit trail). */
+    skillAuditMiss(payload: {
+        required: string[];
+        invoked: string[];
+        missing: string[];
+        severity: 'warn' | 'error';
+        bypassed?: boolean;
+        unenforceable?: boolean;
+    }): Promise<void>;
+}
+/**
+ * Convergence sidecar collaborator (Phase 39.4). The gate owns the JSON byte
+ * layout; the settle adapter owns the path + atomic write. `read()` yields the
+ * prior failing-attempt count + history (absent/corrupt/legacy → {0, []}).
+ * Reused by the 39.5 security-audit gate.
+ */
+export interface ConvergenceSidecar {
+    read(): Promise<{
+        attemptsSoFar: number;
+        history: unknown[];
+    }>;
+    write(text: string): Promise<void>;
+}
+/**
+ * Result of the build-test-must-pass runner (Phase 39.2). `ran:false` means no
+ * `verification.testCommand` is configured — the gate passes with a note rather
+ * than guessing a command. `ok` is meaningful only when `ran === true`.
+ */
+export interface TestRunResult {
+    readonly ran: boolean;
+    readonly ok: boolean;
+    readonly exitCode?: number;
+    readonly command?: string;
+}
+/**
+ * Subprocess collaborator for the build-test-must-pass gate (Phase 39.2).
+ * Injected so the gate (and its tests) never spawn a real process; settle
+ * builds it from `config.verification.testCommand`.
+ */
+export interface RunnerPort {
+    test(): Promise<TestRunResult>;
+}
+/**
+ * Prompter collaborator for the interactive-verdict gate (Phase 39.3).
+ * `create()` builds the prompter (scripted via CADENCE_PROMPTER_SCRIPT, else
+ * StdinPrompter) and may throw on a non-TTY — the gate turns that throw into a
+ * refusal. The env/TTY construction policy lives in the settle-side adapter.
+ */
+export interface PrompterPort {
+    create(): Prompter;
+}
+/** The subset of `settle run` flags gates read. Grows as gates are extracted. */
+export interface SettleOpts {
+    readonly force?: boolean;
+    readonly auto?: boolean;
+    readonly deep?: boolean;
+    readonly allowMissingCoverage?: boolean;
+    readonly allowVerifierFailure?: boolean;
+    readonly allowStaleDraft?: boolean;
+    readonly allowOpenTasks?: boolean;
+    readonly allowFailingBuild?: boolean;
+    readonly interactive?: boolean;
+    readonly allowCodeReviewFailure?: boolean;
+    readonly allowSecurityAuditFailure?: boolean;
+    /** --allow-skill-audit-miss (Phase 39.6, skill-audit check). */
+    readonly allowSkillAuditMiss?: boolean;
+}
+/** Everything a gate may read. Built once, before the gate loop. Readonly. */
+export interface SettleContext {
+    readonly cwd: string;
+    readonly state: CadenceState;
+    readonly draft: Draft;
+    readonly progress: ProgressJson;
+    readonly config: CadenceConfig | null;
+    readonly gateSet: GateSet;
+    readonly opts: SettleOpts;
+    readonly explicitIds: ReadonlySet<string>;
+    readonly touchedFiles: readonly string[];
+    /** Shared, lazily-evaluated test-coverage scan; memoized so it runs at most
+     *  once per settle (the inline gates scan it independently today). */
+    coverage(): Promise<Map<string, VerifyTestRef[]>>;
+    /** Memoized DRAFT.md mtime in ms (Phase 39.2, for the draft-read gate);
+     *  `null` when there is no DRAFT or the stat fails. */
+    draftMtimeMs(): Promise<number | null>;
+    /** Memoized `git diff --no-color HEAD -- <touchedFiles>` (Phase 39.4);
+     *  empty string on any error. Shared by code-review + security-audit gates. */
+    diff(): string;
+    readonly verifiers: VerifierPorts;
+    readonly emit: EmitPort;
+    readonly runner: RunnerPort;
+    readonly prompter: PrompterPort;
+    /** Code-review convergence sidecar (Phase 39.4). */
+    readonly codeReviewSidecar: ConvergenceSidecar;
+    readonly io: IoPort;
+}
+/** Cross-cutting flags a gate sets for the finalizers to read. */
+export interface GateFlags {
+    coverageBypassed?: boolean;
+    verifierFailure?: {
+        message: string;
+        provider?: string;
+    };
+}
+/**
+ * The shared bag the driver owns: gate `summaryPatch`es merge here; finalizers
+ * read + write it too. `acResults` is finalizer-built, not a gate contribution.
+ */
+export interface SettleAccumulator {
+    deepVerify?: Record<string, DeepVerdict>;
+    interactiveVerify?: Record<string, InteractiveVerdict>;
+    codeReview?: Record<string, Finding[]>;
+    securityAudit?: Finding[];
+    acResults?: AcResult[];
+    flags: GateFlags;
+}
+/**
+ * A gate's entire contribution. No shared mutable state. `P` is the producer
+ * accumulator the `summaryPatch` targets — defaults to `SettleAccumulator` so
+ * settle gates and `mergeInto` are unchanged. The draft/build surfaces (Phase
+ * 39.7) parameterize `P` with their own product type (e.g. `BuildProducts`)
+ * while keeping the shared `{ outcome, summaryPatch?, flags? }` shape.
+ */
+export interface GateResult<P = SettleAccumulator> {
+    readonly outcome: 'pass' | 'refuse';
+    readonly summaryPatch?: Partial<P>;
+    readonly flags?: GateFlags;
+}
+export type GateImpl = (ctx: SettleContext) => Promise<GateResult>;
+/** Shallow-merge a GateResult's contribution into the accumulator. */
+export declare function mergeInto(acc: SettleAccumulator, res: GateResult): void;
+//# sourceMappingURL=types.d.ts.map

package/dist/gates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/gates/types.ts"],"names":[],"mappings":"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"}

package/dist/gates/types.js

@@ -0,0 +1,12 @@
+/** Shallow-merge a GateResult's contribution into the accumulator. */
+export function mergeInto(acc, res) {
+    if (res.summaryPatch) {
+        const rest = { ...res.summaryPatch };
+        delete rest.flags;
+        Object.assign(acc, rest);
+    }
+    if (res.flags) {
+        Object.assign(acc.flags, res.flags);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/gates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gates/types.ts"],"names":[],"mappings":"AA4NA,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,GAAsB,EAAE,GAAe;IAC/D,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,MAAM,IAAI,GAA+B,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/hooks/dispatcher.d.ts

@@ -0,0 +1,8 @@
+import type { AbstractEvent, HookContext } from '@manehorizons/cadence-types';
+import { type HookResult } from './handlers.js';
+export declare class HookDispatcher {
+    private readonly repoRoot;
+    constructor(repoRoot: string);
+    dispatch(event: AbstractEvent, ctx: HookContext): Promise<HookResult>;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/hooks/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/hooks/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG9E,OAAO,EAQL,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AAEvB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAqB5E"}

package/dist/hooks/dispatcher.js

@@ -0,0 +1,31 @@
+import { SimpleStateBackend } from '../state/simple.js';
+import { loadConfig } from '../config/loader.js';
+import { handleSessionStart, handleUserPrompt, handlePreToolEdit, handlePostToolEdit, handleSessionStop, handleSubagentResult, handleSkillInvoke, } from './handlers.js';
+export class HookDispatcher {
+    repoRoot;
+    constructor(repoRoot) {
+        this.repoRoot = repoRoot;
+    }
+    async dispatch(event, ctx) {
+        const backend = new SimpleStateBackend(this.repoRoot);
+        const state = await backend.readState();
+        const config = await loadConfig(this.repoRoot);
+        switch (event) {
+            case 'session-start':
+                return handleSessionStart(ctx, state);
+            case 'user-prompt':
+                return handleUserPrompt(ctx, state, config, backend);
+            case 'pre-tool-edit':
+                return handlePreToolEdit(ctx, state, config);
+            case 'post-tool-edit':
+                return handlePostToolEdit(ctx, state, config, backend);
+            case 'session-stop':
+                return handleSessionStop(ctx, state, config);
+            case 'subagent-result':
+                return handleSubagentResult(ctx, state, config, backend);
+            case 'skill-invoke':
+                return handleSkillInvoke(ctx, state, config, backend);
+        }
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/hooks/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/hooks/dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,eAAe,CAAC;AAEvB,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,KAAK,CAAC,QAAQ,CAAC,KAAoB,EAAE,GAAgB;QACnD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,eAAe;gBAClB,OAAO,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxC,KAAK,aAAa;gBAChB,OAAO,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACvD,KAAK,eAAe;gBAClB,OAAO,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,KAAK,gBAAgB;gBACnB,OAAO,kBAAkB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACzD,KAAK,cAAc;gBACjB,OAAO,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,KAAK,iBAAiB;gBACpB,OAAO,oBAAoB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC3D,KAAK,cAAc;gBACjB,OAAO,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF"}

package/dist/hooks/handlers.d.ts

@@ -0,0 +1,21 @@
+import type { HookContext, CadenceConfig, CadenceState } from '@manehorizons/cadence-types';
+import type { SimpleStateBackend } from '../state/simple.js';
+export interface HookResult {
+    ok: boolean;
+    blockMessage?: string;
+    contextPayload?: string;
+}
+export declare function handleSessionStart(_ctx: HookContext, state: CadenceState): Promise<HookResult>;
+export declare function handleUserPrompt(_ctx: HookContext, state: CadenceState, config: CadenceConfig, backend: SimpleStateBackend): Promise<HookResult>;
+export declare function handlePreToolEdit(ctx: HookContext, state: CadenceState, config: CadenceConfig): Promise<HookResult>;
+export declare function handlePostToolEdit(ctx: HookContext, state: CadenceState, _config: CadenceConfig, backend: SimpleStateBackend): Promise<HookResult>;
+export declare function handleSessionStop(_ctx: HookContext, state: CadenceState, config: CadenceConfig): Promise<HookResult>;
+export declare function handleSubagentResult(_ctx: HookContext, state: CadenceState, _config: CadenceConfig, backend: SimpleStateBackend): Promise<HookResult>;
+/**
+ * Phase 23.4 — skillAudit wiring. Records the skill name from `ctx.raw.skill`
+ * into `state.skillAudit.invoked` when `config.telemetry.skillInvocations` is
+ * enabled. Dedups (set-like) and caps the array at 100 entries with FIFO
+ * eviction. Best-effort: missing skill or telemetry disabled → no-op.
+ */
+export declare function handleSkillInvoke(ctx: HookContext, state: CadenceState, config: CadenceConfig, backend: SimpleStateBackend): Promise<HookResult>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/hooks/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/hooks/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAS7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAWpG;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,UAAU,CAAC,CAkDrB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,UAAU,CAAC,CASrB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAIrB;AAID;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/dist/hooks/handlers.js

@@ -0,0 +1,121 @@
+import { join } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { parseDraftMd } from '../parse/draft-parser.js';
+import { effectiveGateSet } from '../gates/engine.js';
+import { selectNotifier } from '../notify/factory.js';
+import { runBoundaryCheck } from '../checks/boundary.js';
+export async function handleSessionStart(_ctx, state) {
+    const lines = [
+        'CADENCE session resumed.',
+        `Project: ${state.project.name}`,
+        `Loop position: ${state.loopPosition}`,
+        `Active phase: ${state.activePhase ?? '(none)'}`,
+        `Active draft: ${state.activeDraft ?? '(none)'}`,
+    ];
+    if (state.openDrafts.length > 0)
+        lines.push(`Open drafts: ${state.openDrafts.map((d) => d.id).join(', ')}`);
+    return { ok: true, contextPayload: lines.join('\n') };
+}
+export async function handleUserPrompt(_ctx, state, config, backend) {
+    if (config.telemetry.tokenUtilization) {
+        state.session.tokenUtilization = Math.min(1, state.session.tokenUtilization + 0.01);
+        await backend.commit(state);
+    }
+    return { ok: true };
+}
+export async function handlePreToolEdit(ctx, state, config) {
+    // Phase 17.2: hook-side files-outside-boundary detection. Fires only when an
+    // active draft exists, the host passed file paths in ctx.raw, and the gate
+    // set includes anomaly-notify. Detection-only — never refuses the edit.
+    if (state.activeDraft && state.activePhase) {
+        const rawFiles = ctx.raw?.files;
+        if (rawFiles && rawFiles.length > 0) {
+            const draftPath = join(ctx.cwd, '.cadence/phases', state.activePhase, `${state.activeDraft}-DRAFT.md`);
+            if (existsSync(draftPath)) {
+                try {
+                    const draft = parseDraftMd(await readFile(draftPath, 'utf8'));
+                    const now = new Date().toISOString();
+                    const events = runBoundaryCheck({
+                        declaredFiles: draft.tasks.flatMap((t) => t.files),
+                        touchedFiles: rawFiles,
+                        stamp: () => now,
+                        extraContext: { source: 'hook.preToolEdit' },
+                    });
+                    if (events.length > 0) {
+                        const gateSet = effectiveGateSet(state, config, draft);
+                        if (gateSet.gates.includes('anomaly-notify')) {
+                            const notifier = selectNotifier(config);
+                            try {
+                                await notifier.notify(events);
+                            }
+                            catch (err) {
+                                const msg = err instanceof Error ? err.message : String(err);
+                                process.stderr.write(`notify: ${notifier.name} transport failed — ${msg} (continuing)\n`);
+                            }
+                        }
+                    }
+                }
+                catch {
+                    /* malformed draft must not break the hook */
+                }
+            }
+        }
+    }
+    if (config.hooks.preToolUseBuildGate && state.loopPosition !== 'BUILD') {
+        return {
+            ok: false,
+            blockMessage: `preToolUseBuildGate is enabled and loopPosition=${state.loopPosition}. Run 'cadence draft approve' to enter BUILD phase before editing.`,
+        };
+    }
+    return { ok: true };
+}
+export async function handlePostToolEdit(ctx, state, _config, backend) {
+    if (state.activeTask) {
+        const raw = ctx.raw;
+        if (raw?.files) {
+            state.activeTask.touchedFiles = Array.from(new Set([...state.activeTask.touchedFiles, ...raw.files]));
+            await backend.commit(state);
+        }
+    }
+    return { ok: true };
+}
+export async function handleSessionStop(_ctx, state, config) {
+    if (config.loopEnforcement !== 'strict')
+        return { ok: true };
+    if (state.openDrafts.length > 0) {
+        return {
+            ok: false,
+            blockMessage: `loopEnforcement=strict and ${state.openDrafts.length} unclosed draft(s). Run 'cadence settle' before ending session.`,
+        };
+    }
+    return { ok: true };
+}
+export async function handleSubagentResult(_ctx, state, _config, backend) {
+    state.session.subagentSpawns += 1;
+    await backend.commit(state);
+    return { ok: true };
+}
+const SKILL_AUDIT_CAP = 100;
+/**
+ * Phase 23.4 — skillAudit wiring. Records the skill name from `ctx.raw.skill`
+ * into `state.skillAudit.invoked` when `config.telemetry.skillInvocations` is
+ * enabled. Dedups (set-like) and caps the array at 100 entries with FIFO
+ * eviction. Best-effort: missing skill or telemetry disabled → no-op.
+ */
+export async function handleSkillInvoke(ctx, state, config, backend) {
+    if (!config.telemetry.skillInvocations)
+        return { ok: true };
+    const skill = ctx.raw?.skill;
+    if (typeof skill !== 'string' || skill.length === 0)
+        return { ok: true };
+    if (state.skillAudit.invoked.includes(skill))
+        return { ok: true };
+    state.skillAudit.invoked.push(skill);
+    while (state.skillAudit.invoked.length > SKILL_AUDIT_CAP) {
+        state.skillAudit.invoked.shift();
+    }
+    await backend.commit(state);
+    return { ok: true };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/hooks/handlers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/init/claude-md-template.d.ts

@@ -0,0 +1,34 @@
+import type { Profile } from '@manehorizons/cadence-types';
+/**
+ * Phase 26.2 — CLAUDE.md scaffold. `cadence init` writes a CLAUDE.md at the
+ * repo root with a managed region delimited by these markers. `cadence init
+ * --claude-md` regenerates ONLY the managed region, preserving any content
+ * the user added outside it. A CLAUDE.md with no markers is treated as
+ * fully user-owned and left untouched.
+ */
+export declare const MANAGED_START = "<!-- cadence:managed:start -->";
+export declare const MANAGED_END = "<!-- cadence:managed:end -->";
+export interface ClaudeMdOptions {
+    projectName: string;
+    gateProfile: Profile;
+    preset: string;
+}
+/** The managed block (markers inclusive). Regenerated verbatim by `--claude-md`. */
+export declare function renderManagedBlock(opts: ClaudeMdOptions): string;
+/** Full default file when no CLAUDE.md exists yet. */
+export declare function renderClaudeMd(opts: ClaudeMdOptions): string;
+export type MergeMode = 'created' | 'regenerated' | 'preserved';
+export interface MergeResult {
+    content: string;
+    mode: MergeMode;
+}
+/**
+ * Merge a fresh managed block into an existing CLAUDE.md.
+ *
+ * - no existing file (empty/whitespace) → full render (`created`)
+ * - both markers present → replace the inclusive span, keep prefix/suffix
+ *   byte-for-byte (`regenerated`)
+ * - content present but markers absent → return unchanged (`preserved`)
+ */
+export declare function mergeManagedBlock(existing: string | null, opts: ClaudeMdOptions): MergeResult;
+//# sourceMappingURL=claude-md-template.d.ts.map

package/dist/init/claude-md-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-template.d.ts","sourceRoot":"","sources":["../../src/init/claude-md-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;;;;;GAMG;AAEH,eAAO,MAAM,aAAa,mCAAmC,CAAC;AAC9D,eAAO,MAAM,WAAW,iCAAiC,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CA6BhE;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAK5D;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,IAAI,EAAE,eAAe,GACpB,WAAW,CAiBb"}

package/dist/init/claude-md-template.js

@@ -0,0 +1,72 @@
+/**
+ * Phase 26.2 — CLAUDE.md scaffold. `cadence init` writes a CLAUDE.md at the
+ * repo root with a managed region delimited by these markers. `cadence init
+ * --claude-md` regenerates ONLY the managed region, preserving any content
+ * the user added outside it. A CLAUDE.md with no markers is treated as
+ * fully user-owned and left untouched.
+ */
+export const MANAGED_START = '<!-- cadence:managed:start -->';
+export const MANAGED_END = '<!-- cadence:managed:end -->';
+/** The managed block (markers inclusive). Regenerated verbatim by `--claude-md`. */
+export function renderManagedBlock(opts) {
+    return `${MANAGED_START}
+## CADENCE
+
+This project uses **CADENCE** — a disciplined draft → approve → build → settle
+loop. Do not freelance multi-step work; run it through the loop.
+
+- **Project:** ${opts.projectName}
+- **Config preset:** ${opts.preset}
+- **Gate profile:** ${opts.gateProfile} (gates scale with profile × tier — see DESIGN.md §4)
+
+### Where state lives
+
+- \`.cadence/ROADMAP.md\` — phases and milestones
+- \`.cadence/STATE.md\` — current loop position, active draft/phase (derived; do not hand-edit)
+- \`.cadence/phases/<phase>/\` — per-phase DRAFT / PROGRESS / SUMMARY
+- \`DESIGN.md\` — architecture + the gate universe; project \`README.md\` — usage
+
+### The loop
+
+1. \`cadence draft new <phase> <num> --title=…\` — scaffold a DRAFT
+2. edit the DRAFT (Objective, Acceptance Criteria, Tasks, Boundaries)
+3. \`cadence draft approve <phase> <num>\` — coherence + gate checks, enter BUILD
+4. \`cadence build task <id> --status=DONE\` — record each task
+5. \`cadence settle run --auto\` — derive AC verdicts, write SUMMARY, return to IDLE
+
+Run \`cadence progress\` anytime for the next suggested step. Regenerate this
+block with \`cadence init --claude-md\`; edits outside the markers are kept.
+${MANAGED_END}`;
+}
+/** Full default file when no CLAUDE.md exists yet. */
+export function renderClaudeMd(opts) {
+    return `# ${opts.projectName}
+
+${renderManagedBlock(opts)}
+`;
+}
+/**
+ * Merge a fresh managed block into an existing CLAUDE.md.
+ *
+ * - no existing file (empty/whitespace) → full render (`created`)
+ * - both markers present → replace the inclusive span, keep prefix/suffix
+ *   byte-for-byte (`regenerated`)
+ * - content present but markers absent → return unchanged (`preserved`)
+ */
+export function mergeManagedBlock(existing, opts) {
+    if (existing === null || existing.trim().length === 0) {
+        return { content: renderClaudeMd(opts), mode: 'created' };
+    }
+    const startIdx = existing.indexOf(MANAGED_START);
+    const endIdx = existing.indexOf(MANAGED_END);
+    if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+        return { content: existing, mode: 'preserved' };
+    }
+    const prefix = existing.slice(0, startIdx);
+    const suffix = existing.slice(endIdx + MANAGED_END.length);
+    return {
+        content: `${prefix}${renderManagedBlock(opts)}${suffix}`,
+        mode: 'regenerated',
+    };
+}
+//# sourceMappingURL=claude-md-template.js.map

package/dist/init/claude-md-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/init/claude-md-template.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,8BAA8B,CAAC;AAQ1D,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,OAAO,GAAG,aAAa;;;;;;iBAMR,IAAI,CAAC,WAAW;uBACV,IAAI,CAAC,MAAM;sBACZ,IAAI,CAAC,WAAW;;;;;;;;;;;;;;;;;;;EAmBpC,WAAW,EAAE,CAAC;AAChB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,OAAO,KAAK,IAAI,CAAC,WAAW;;EAE5B,kBAAkB,CAAC,IAAI,CAAC;CACzB,CAAC;AACF,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAuB,EACvB,IAAqB;IAErB,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO;QACL,OAAO,EAAE,GAAG,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE;QACxD,IAAI,EAAE,aAAa;KACpB,CAAC;AACJ,CAAC"}

package/dist/intelligence/backend/cadence.d.ts

@@ -0,0 +1,21 @@
+import type { BackendStatus, IntelligenceMilestone, Recommendation } from '@manehorizons/cadence-types';
+export type BackendDetection = {
+    present: boolean;
+    kind: 'cadence' | null;
+};
+export type BackendArtifacts = {
+    phaseCount: number;
+    roadmap: boolean;
+    state: boolean;
+    milestones: boolean;
+};
+export interface PraxisBackend {
+    id: string;
+    detect(root: string): Promise<BackendDetection>;
+    readStatus(root: string): Promise<BackendStatus>;
+    readArtifacts(root: string): Promise<BackendArtifacts>;
+    listLegalActions(root: string): Promise<string[]>;
+    renderSpecDraft(milestone: IntelligenceMilestone, recs: ReadonlyArray<Pick<Recommendation, 'id' | 'title'>>): string;
+}
+export declare const cadenceBackend: PraxisBackend;
+//# sourceMappingURL=cadence.d.ts.map

package/dist/intelligence/backend/cadence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.d.ts","sourceRoot":"","sources":["../../../src/intelligence/backend/cadence.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,cAAc,EACf,MAAM,6BAA6B,CAAC;AAIrC,MAAM,MAAM,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,CAAC;AAC5E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,eAAe,CACb,SAAS,EAAE,qBAAqB,EAChC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,GACxD,MAAM,CAAC;CACX;AAYD,eAAO,MAAM,cAAc,EAAE,aAiH5B,CAAC"}