kevlar-4u 1.6.8 → 1.6.10

package/dist/__tests__/observations.test.d.ts

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

package/dist/__tests__/observations.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observations.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/observations.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/observations.test.js

@@ -0,0 +1,357 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { setObservationCacheDir, recordHostStructuredObservation, recordCapabilityObservation, getHostStructuredObservation, listObservations, clearObservations, inferTaskClass, } from "../execution/observations.js";
+let tmpDir;
+let origForceEnv;
+beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "kevlar-obs-test-"));
+    setObservationCacheDir(tmpDir);
+    origForceEnv = process.env.KEVLAR_FORCE_HOST_STRUCTURED;
+    delete process.env.KEVLAR_FORCE_HOST_STRUCTURED;
+});
+afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+    if (origForceEnv !== undefined) {
+        process.env.KEVLAR_FORCE_HOST_STRUCTURED = origForceEnv;
+    }
+    else {
+        delete process.env.KEVLAR_FORCE_HOST_STRUCTURED;
+    }
+});
+// ── Helpers ──────────────────────────────────────────────────────────────────
+const FP_A = { name: "Claude", version: "1.0", transport: "stdio" };
+const FP_B = { name: "Cursor", version: "0.5", transport: "stdio" };
+function makeKey(fp, taskClass = "short", opts) {
+    return {
+        fingerprint: fp,
+        model: opts?.model,
+        protocolVersion: "kevlar-host-guided/v1",
+        taskClass,
+        locale: opts?.locale,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// inferTaskClass
+// ─────────────────────────────────────────────────────────────────────────────
+describe("inferTaskClass", () => {
+    it("returns 'short' for empty/undefined content", () => {
+        assert.equal(inferTaskClass(undefined), "short");
+        assert.equal(inferTaskClass(""), "short");
+    });
+    it("returns 'short' for content < 800 chars", () => {
+        assert.equal(inferTaskClass("a".repeat(100)), "short");
+        assert.equal(inferTaskClass("a".repeat(799)), "short");
+    });
+    it("returns 'medium' for 800-2999 chars", () => {
+        assert.equal(inferTaskClass("a".repeat(800)), "medium");
+        assert.equal(inferTaskClass("a".repeat(2999)), "medium");
+    });
+    it("returns 'long' for >= 3000 chars", () => {
+        assert.equal(inferTaskClass("a".repeat(3000)), "long");
+        assert.equal(inferTaskClass("a".repeat(10000)), "long");
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Basic Record + Lookup
+// ─────────────────────────────────────────────────────────────────────────────
+describe("recordHostStructuredObservation + getHostStructuredObservation", () => {
+    it("returns undefined when cache is empty", () => {
+        const result = getHostStructuredObservation(makeKey(FP_A));
+        assert.equal(result, undefined);
+    });
+    it("round-trips a positive observation", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A));
+        assert.ok(result);
+        assert.equal(result.status, "format_verified");
+        assert.equal(result.reason, "kevlar_result_schema_matched");
+        assert.ok(result.observedAt > 0);
+        assert.ok(result.expiresAt > result.observedAt);
+    });
+    it("round-trips a negative observation", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "medium"),
+            status: "unsupported",
+            reason: "host_rejected",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A, "medium"));
+        assert.ok(result);
+        assert.equal(result.status, "unsupported");
+        assert.equal(result.reason, "host_rejected");
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// TTL Expiry
+// ─────────────────────────────────────────────────────────────────────────────
+describe("TTL expiry", () => {
+    it("does not return expired observations", () => {
+        // Record an observation with 1h TTL (likely_output_truncated)
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "failed",
+            reason: "likely_output_truncated",
+        });
+        // Manually backdate the observation in the cache file
+        const cachePath = path.join(tmpDir, "kevlar-observations.json");
+        const raw = JSON.parse(fs.readFileSync(cachePath, "utf-8"));
+        raw.observations[0].expiresAt = Date.now() - 1000; // expired 1s ago
+        fs.writeFileSync(cachePath, JSON.stringify(raw));
+        const result = getHostStructuredObservation(makeKey(FP_A));
+        assert.equal(result, undefined);
+    });
+    it("format_verified has 7-day TTL", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const cachePath = path.join(tmpDir, "kevlar-observations.json");
+        const raw = JSON.parse(fs.readFileSync(cachePath, "utf-8"));
+        const obs = raw.observations[0];
+        const ttl = obs.expiresAt - obs.observedAt;
+        assert.equal(ttl, 7 * 24 * 60 * 60 * 1000);
+    });
+    it("unsupported has 24h TTL", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "unsupported",
+            reason: "host_rejected",
+        });
+        const cachePath = path.join(tmpDir, "kevlar-observations.json");
+        const raw = JSON.parse(fs.readFileSync(cachePath, "utf-8"));
+        const obs = raw.observations[0];
+        const ttl = obs.expiresAt - obs.observedAt;
+        assert.equal(ttl, 24 * 60 * 60 * 1000);
+    });
+    it("likely_output_truncated has 1h TTL", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "failed",
+            reason: "likely_output_truncated",
+        });
+        const cachePath = path.join(tmpDir, "kevlar-observations.json");
+        const raw = JSON.parse(fs.readFileSync(cachePath, "utf-8"));
+        const obs = raw.observations[0];
+        const ttl = obs.expiresAt - obs.observedAt;
+        assert.equal(ttl, 1 * 60 * 60 * 1000);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Fingerprint Matching
+// ─────────────────────────────────────────────────────────────────────────────
+describe("fingerprint matching", () => {
+    it("does not match different fingerprints", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_B));
+        assert.equal(result, undefined);
+    });
+    it("does not match different protocol versions", () => {
+        recordHostStructuredObservation({
+            key: { ...makeKey(FP_A), protocolVersion: "kevlar-host-guided/v1" },
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation({
+            ...makeKey(FP_A),
+            protocolVersion: "kevlar-host-guided/v2",
+        });
+        assert.equal(result, undefined);
+    });
+    it("does not match when models differ", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "short", { model: "gpt-4" }),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A, "short", { model: "claude-3" }));
+        assert.equal(result, undefined);
+    });
+    it("matches when model is absent in both", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A), // no model
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A)); // no model
+        assert.ok(result);
+        assert.equal(result.status, "format_verified");
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// TaskClass Fuzzy Matching
+// ─────────────────────────────────────────────────────────────────────────────
+describe("taskClass matching", () => {
+    it("exact match: short matches short", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "short"),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A, "short"));
+        assert.ok(result);
+        assert.equal(result.status, "format_verified");
+    });
+    it("heavier task observation satisfies lighter query (long → medium)", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "long"),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A, "medium"));
+        assert.ok(result);
+        assert.equal(result.status, "format_verified");
+    });
+    it("heavier task observation satisfies lighter query (long → short)", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "long"),
+            status: "unsupported",
+            reason: "host_rejected",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A, "short"));
+        assert.ok(result);
+        assert.equal(result.status, "unsupported");
+    });
+    it("lighter task observation returns with isLighter flag (short → long)", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "short"),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        const result = getHostStructuredObservation(makeKey(FP_A, "long"));
+        assert.ok(result);
+        assert.equal(result.status, "format_verified");
+        assert.equal(result.isLighter, true);
+    });
+    it("prefers exact match over lighter match", () => {
+        // Record both a short (lighter) and a medium (exact) observation
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "short"),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "medium"),
+            status: "unsupported",
+            reason: "host_rejected",
+        });
+        // Query for medium → should get the exact medium match (unsupported), not the lighter short one
+        const result = getHostStructuredObservation(makeKey(FP_A, "medium"));
+        assert.ok(result);
+        assert.equal(result.status, "unsupported");
+        assert.equal(result.reason, "host_rejected");
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// KEVLAR_FORCE_HOST_STRUCTURED bypass
+// ─────────────────────────────────────────────────────────────────────────────
+describe("KEVLAR_FORCE_HOST_STRUCTURED bypass", () => {
+    it("getHostStructuredObservation returns undefined when env is set", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        process.env.KEVLAR_FORCE_HOST_STRUCTURED = "true";
+        const result = getHostStructuredObservation(makeKey(FP_A));
+        assert.equal(result, undefined);
+    });
+    it("recordHostStructuredObservation does not persist when env is set", () => {
+        process.env.KEVLAR_FORCE_HOST_STRUCTURED = "true";
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        // Remove env and check — cache should still be empty
+        delete process.env.KEVLAR_FORCE_HOST_STRUCTURED;
+        const result = getHostStructuredObservation(makeKey(FP_A));
+        assert.equal(result, undefined);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// recordCapabilityObservation convenience wrapper
+// ─────────────────────────────────────────────────────────────────────────────
+describe("recordCapabilityObservation", () => {
+    it("creates a properly keyed observation", () => {
+        recordCapabilityObservation(FP_A, "medium", "format_verified", "kevlar_result_schema_matched", { model: "gpt-4", locale: "zh-CN" });
+        const result = getHostStructuredObservation(makeKey(FP_A, "medium", { model: "gpt-4", locale: "zh-CN" }));
+        assert.ok(result);
+        assert.equal(result.status, "format_verified");
+    });
+    it("records negative observation", () => {
+        recordCapabilityObservation(FP_B, "long", "unsupported", "host_rejected");
+        const result = getHostStructuredObservation(makeKey(FP_B, "long"));
+        assert.ok(result);
+        assert.equal(result.status, "unsupported");
+        assert.equal(result.reason, "host_rejected");
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// listObservations + clearObservations
+// ─────────────────────────────────────────────────────────────────────────────
+describe("listObservations + clearObservations", () => {
+    it("listObservations returns all non-expired entries", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A, "short"),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        recordHostStructuredObservation({
+            key: makeKey(FP_B, "long"),
+            status: "unsupported",
+            reason: "host_rejected",
+        });
+        const all = listObservations();
+        assert.equal(all.length, 2);
+    });
+    it("clearObservations removes all entries", () => {
+        recordHostStructuredObservation({
+            key: makeKey(FP_A),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        clearObservations();
+        const all = listObservations();
+        assert.equal(all.length, 0);
+        const result = getHostStructuredObservation(makeKey(FP_A));
+        assert.equal(result, undefined);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Purge on record (same fingerprint, different version)
+// ─────────────────────────────────────────────────────────────────────────────
+describe("purge on record", () => {
+    it("purges old version entries for same fingerprint when recording new version", () => {
+        const fpV1 = { name: "Claude", version: "1.0", transport: "stdio" };
+        const fpV2 = { name: "Claude", version: "2.0", transport: "stdio" };
+        recordHostStructuredObservation({
+            key: makeKey(fpV1),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        // Record new version — old one should be purged
+        recordHostStructuredObservation({
+            key: makeKey(fpV2),
+            status: "format_verified",
+            reason: "kevlar_result_schema_matched",
+        });
+        // Old version should not be found
+        const oldResult = getHostStructuredObservation(makeKey(fpV1));
+        assert.equal(oldResult, undefined);
+        // New version should be found
+        const newResult = getHostStructuredObservation(makeKey(fpV2));
+        assert.ok(newResult);
+    });
+});
+//# sourceMappingURL=observations.test.js.map

package/dist/__tests__/observations.test.js.map

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

package/dist/execution/base.d.ts

@@ -3,6 +3,8 @@
  */
 import type { Persona } from "../utils/parser.js";
 import type { DimensionsConfig } from "./dimensions.js";
+export type { ExecutionBackend, ExecutionPlan, HostOrchestrationStrategy, HostStructuredCapabilityStatus, DispatchFailureReason, PreAuditContext, ClientFingerprint, TaskClass, StructuredObservationKey, HostStructuredObservation, SamplingExecutionPolicy, } from "./plan.js";
+export { DEFAULT_SAMPLING_POLICY } from "./plan.js";
 export type ExecutionMode = "orchestration" | "mcp_sampling" | "direct_api" | "mcp_subagent";
 export type ResolveableMode = ExecutionMode | "auto";
 export interface BudgetPolicy {
@@ -91,6 +93,8 @@ export interface ExecutionHandler {
     mode: ExecutionMode;
     /** Check if current environment supports this mode */
     canExecute(): boolean;
+    /** Get specific reason why it cannot be executed */
+    getReason?: () => string;
     /** Execute the review */
     execute(ctx: ExecutionContext): Promise<ExecutionResult>;
     /** Default priority (lower number = higher priority) */

package/dist/execution/base.d.ts.map

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

package/dist/execution/base.js

@@ -1,6 +1,7 @@
 /**
  * Base types and interfaces for Kevlar-4u execution modes
  */
+export { DEFAULT_SAMPLING_POLICY } from "./plan.js";
 /** Build a MECP-compliant Frame envelope. */
 export function toFrame(source, destination, correlationId, type, payload, traceId) {
     return {

package/dist/execution/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/execution/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2FH,6CAA6C;AAC7C,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,WAAmB,EACnB,aAAqB,EACrB,IAAmB,EACnB,OAAU,EACV,OAAgB;IAEhB,OAAO;QACL,MAAM;QACN,WAAW;QACX,aAAa;QACb,OAAO;QACP,IAAI;QACJ,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/execution/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAwFpD,6CAA6C;AAC7C,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,WAAmB,EACnB,aAAqB,EACrB,IAAmB,EACnB,OAAU,EACV,OAAgB;IAEhB,OAAO;QACL,MAAM;QACN,WAAW;QACX,aAAa;QACb,OAAO;QACP,IAAI;QACJ,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/execution/checkpoint.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Checkpoint & Execution Transition System (v3)
+ *
+ * Defines the audit state machine checkpoints and the ExecutionTransition
+ * record that captures downgrade events when a structured collaboration
+ * attempt fails and Kevlar falls back to standard host orchestration.
+ */
+import type { ExecutionPlan, DispatchFailureReason, ClientFingerprint, HostStructuredCapabilityStatus } from "./plan.js";
+/**
+ * Key milestones in the review wizard state machine.
+ *
+ * Structured collaboration is initiated after `step0_completed`.
+ * If it fails, the state machine resumes from `step0_completed`
+ * with `strategy: "standard"`.
+ */
+export type AuditCheckpoint = "initiated" | "step0_completed" | "preaudit_started" | "preaudit_completed" | "persona_inventory_completed";
+/**
+ * Immutable record of a downgrade event.
+ *
+ * Created when a structured collaboration attempt fails and Kevlar
+ * switches to standard host orchestration. Appended to the
+ * executionTransitions log for observability.
+ */
+export interface ExecutionTransition {
+    /** The ExecutionPlan before the downgrade. */
+    from: ExecutionPlan;
+    /** The ExecutionPlan after the downgrade. */
+    to: ExecutionPlan;
+    /** What caused the structured attempt to fail. */
+    reason: DispatchFailureReason;
+    /** Unix timestamp (ms) when the transition occurred. */
+    at: number;
+    /** Which checkpoint the state machine will resume from. */
+    checkpoint: AuditCheckpoint;
+    /** Fingerprint of the Host that was being used (for telemetry). */
+    clientFingerprint?: ClientFingerprint;
+}
+/**
+ * Minimal wizard state shape required by resumeFromStructuredFailure().
+ *
+ * This avoids circular imports by not depending on the full ReviewWizardState
+ * from the tools layer. Any wizard state that satisfies this interface
+ * can be passed to the resume function.
+ */
+export interface StructuredFailureResumeState {
+    executionPlan?: ExecutionPlan;
+    checkpoint?: AuditCheckpoint;
+    structuredDowngraded?: boolean;
+    capabilityStatus?: HostStructuredCapabilityStatus;
+    executionTransitions?: ExecutionTransition[];
+}
+/**
+ * Recover from a failed structured collaboration attempt.
+ *
+ * - Switches executionPlan to `host_orchestration + standard`
+ * - Marks `structuredDowngraded = true` to prevent repeated attempts
+ * - Resets checkpoint to `step0_completed`
+ * - Sets capabilityStatus based on the failure reason
+ * - Appends an ExecutionTransition for observability
+ *
+ * The caller must separately handle:
+ * - Preserving Step 0 artifacts (preAuditContext, content, tier, etc.)
+ * - Cleaning structured attempt scratch fields
+ * - Restarting the audit pipeline from step0_completed
+ */
+export declare function resumeFromStructuredFailure(state: StructuredFailureResumeState, reason: DispatchFailureReason): {
+    executionPlan: ExecutionPlan;
+    checkpoint: AuditCheckpoint;
+    structuredDowngraded: true;
+    capabilityStatus: HostStructuredCapabilityStatus;
+    executionTransitions: ExecutionTransition[];
+};
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/execution/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/execution/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AAKzH;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,6BAA6B,CAAC;AAIlC;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,6CAA6C;IAC7C,EAAE,EAAE,aAAa,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,qBAAqB,CAAC;IAC9B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,UAAU,EAAE,eAAe,CAAC;IAC5B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAID;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,8BAA8B,CAAC;IAClD,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,4BAA4B,EACnC,MAAM,EAAE,qBAAqB,GAC5B;IACD,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,eAAe,CAAC;IAC5B,oBAAoB,EAAE,IAAI,CAAC;IAC3B,gBAAgB,EAAE,8BAA8B,CAAC;IACjD,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C,CA+BA"}

package/dist/execution/checkpoint.js

@@ -0,0 +1,51 @@
+/**
+ * Checkpoint & Execution Transition System (v3)
+ *
+ * Defines the audit state machine checkpoints and the ExecutionTransition
+ * record that captures downgrade events when a structured collaboration
+ * attempt fails and Kevlar falls back to standard host orchestration.
+ */
+import { getClientFingerprint } from "./client.js";
+/**
+ * Recover from a failed structured collaboration attempt.
+ *
+ * - Switches executionPlan to `host_orchestration + standard`
+ * - Marks `structuredDowngraded = true` to prevent repeated attempts
+ * - Resets checkpoint to `step0_completed`
+ * - Sets capabilityStatus based on the failure reason
+ * - Appends an ExecutionTransition for observability
+ *
+ * The caller must separately handle:
+ * - Preserving Step 0 artifacts (preAuditContext, content, tier, etc.)
+ * - Cleaning structured attempt scratch fields
+ * - Restarting the audit pipeline from step0_completed
+ */
+export function resumeFromStructuredFailure(state, reason) {
+    const from = state.executionPlan ?? {
+        backend: "host_orchestration",
+        strategy: "structured",
+    };
+    const to = {
+        backend: "host_orchestration",
+        strategy: "standard",
+    };
+    const transition = {
+        from,
+        to,
+        reason,
+        at: Date.now(),
+        checkpoint: "step0_completed",
+        clientFingerprint: getClientFingerprint(),
+    };
+    return {
+        executionPlan: to,
+        checkpoint: "step0_completed",
+        structuredDowngraded: true,
+        capabilityStatus: reason === "host_rejected" ? "unsupported" : "failed",
+        executionTransitions: [
+            ...(state.executionTransitions ?? []),
+            transition,
+        ],
+    };
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/execution/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/execution/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA2DnD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAmC,EACnC,MAA6B;IAQ7B,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,IAAI;QAClC,OAAO,EAAE,oBAA6B;QACtC,QAAQ,EAAE,YAAqB;KAChC,CAAC;IAEF,MAAM,EAAE,GAAkB;QACxB,OAAO,EAAE,oBAA6B;QACtC,QAAQ,EAAE,UAAmB;KAC9B,CAAC;IAEF,MAAM,UAAU,GAAwB;QACtC,IAAI;QACJ,EAAE;QACF,MAAM;QACN,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,UAAU,EAAE,iBAAiB;QAC7B,iBAAiB,EAAE,oBAAoB,EAAE;KAC1C,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE,iBAAiB;QAC7B,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EACd,MAAM,KAAK,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ;QACvD,oBAAoB,EAAE;YACpB,GAAG,CAAC,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC;YACrC,UAAU;SACX;KACF,CAAC;AACJ,CAAC"}