opencode-swarm 7.145.1 → 7.146.0

package/dist/cli/{knowledge-events-jprkz49t.js → knowledge-events-d201414m.js}

@@ -29,13 +29,13 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-ff66fbjt.js";
-import"./index-neh8azwc.js";
+} from "./index-zd1mfygt.js";
+import"./index-jfcgnvg6.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-17e73wac.js";
-import"./index-7axx11dt.js";
-import"./index-v3y3qg48.js";
+import"./index-5qwmpamg.js";
+import"./index-fay8h6v8.js";
+import"./index-cpg98bh1.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-w8pgjr75.js";
@@ -43,12 +43,12 @@ import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-dzan8czb.js";
-import"./index-mpf01swm.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{knowledge-link-zvtmj756.js → knowledge-link-82ew2yc4.js}

@@ -12,11 +12,11 @@ import {
   resolveLinkDir,
   sanitizeLinkId,
   writeLinkPointer
-} from "./index-dzan8czb.js";
-import"./index-mpf01swm.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+} from "./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{knowledge-store-mc4awds4.js → knowledge-store-ds45k9th.js}

@@ -41,16 +41,16 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-qpke2x5h.js";
+} from "./index-kfmee1cr.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";
-import"./index-dzan8czb.js";
-import"./index-mpf01swm.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{knowledge-validator-pe4ncrvj.js → knowledge-validator-707vsncy.js}

@@ -23,17 +23,17 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-8ef23wex.js";
-import"./index-2qrd8mfa.js";
+} from "./index-q2mvacjr.js";
+import"./index-4p3qfb05.js";
 import"./index-rtry5xyf.js";
-import"./index-qpke2x5h.js";
+import"./index-kfmee1cr.js";
 import"./index-ae75rja9.js";
-import"./index-dzan8czb.js";
-import"./index-mpf01swm.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{model-preflight-77dwxfv5.js → model-preflight-7ea00h34.js}

@@ -2,7 +2,7 @@
 import {
   DEFAULT_MODELS,
   init_constants
-} from "./index-v3y3qg48.js";
+} from "./index-cpg98bh1.js";
 import"./index-zjygnfay.js";
 import"./index-a76rekgs.js";
 

package/dist/cli/{pending-delegations-epzht3d7.js → pending-delegations-kkrczqv7.js}

@@ -54,13 +54,13 @@ import {
   sweepStaleDelegations,
   updateCoderSettlement,
   writeDelegationFallback
-} from "./index-rtkttser.js";
+} from "./index-97psh79d.js";
 import"./index-w8pgjr75.js";
 import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{pr-subscriptions-2ahy8g87.js → pr-subscriptions-2xn238xt.js}

@@ -9,13 +9,13 @@ import {
   sweepStale,
   unsubscribe,
   updateSnapshot
-} from "./index-gey2257h.js";
+} from "./index-5e5a1y2r.js";
 import"./index-w8pgjr75.js";
 import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{runner-ra9pjhp2.js → runner-pqsf809k.js}

@@ -3,14 +3,14 @@ import {
   _internals,
   createModelEvaluationExecutor,
   runEvaluation
-} from "./index-34tawmyx.js";
-import"./index-fwnhh6s7.js";
+} from "./index-0a0asz2s.js";
+import"./index-nsr5b69r.js";
 import"./index-y8552snf.js";
 import"./index-zj6t9zgx.js";
-import"./index-mpf01swm.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-j20fzn0w.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{scan-cursor-hdzhqwzj.js → scan-cursor-znhqb8xa.js}

@@ -4,17 +4,17 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-evpgszmp.js";
-import"./index-qpke2x5h.js";
+} from "./index-gxbhp7sx.js";
+import"./index-kfmee1cr.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-dzan8czb.js";
-import"./index-mpf01swm.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{schema-pg85z06v.js → schema-dnnm0p40.js}

@@ -97,8 +97,8 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-7axx11dt.js";
-import"./index-v3y3qg48.js";
+} from "./index-fay8h6v8.js";
+import"./index-cpg98bh1.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{scope-persistence-v8we8ja7.js → scope-persistence-4n24a1e2.js}

@@ -23,12 +23,12 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-90w06fqr.js";
-import"./index-cqfp05jb.js";
+} from "./index-kwxp0z0n.js";
+import"./index-fzqhn96z.js";
 import"./index-556ja8an.js";
-import"./index-17e73wac.js";
-import"./index-7axx11dt.js";
-import"./index-v3y3qg48.js";
+import"./index-5qwmpamg.js";
+import"./index-fay8h6v8.js";
+import"./index-cpg98bh1.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-w8pgjr75.js";
@@ -36,9 +36,9 @@ import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{skill-generator-ctskfct2.js → skill-generator-5s0p3y8k.js}

@@ -33,18 +33,18 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-mrkgxfeh.js";
-import"./index-8ef23wex.js";
-import"./index-2qrd8mfa.js";
+} from "./index-g3xt1d16.js";
+import"./index-q2mvacjr.js";
+import"./index-4p3qfb05.js";
 import"./index-rtry5xyf.js";
-import"./index-qpke2x5h.js";
-import"./index-ff66fbjt.js";
-import"./index-neh8azwc.js";
+import"./index-kfmee1cr.js";
+import"./index-zd1mfygt.js";
+import"./index-jfcgnvg6.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-17e73wac.js";
-import"./index-7axx11dt.js";
-import"./index-v3y3qg48.js";
+import"./index-5qwmpamg.js";
+import"./index-fay8h6v8.js";
+import"./index-cpg98bh1.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-w8pgjr75.js";
@@ -52,12 +52,12 @@ import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-dzan8czb.js";
-import"./index-mpf01swm.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{telemetry-c21dgffc.js → telemetry-t109dhv7.js}

@@ -13,7 +13,7 @@ import {
   startHeartbeatTracking,
   stopHeartbeatTracking,
   telemetry
-} from "./index-dppzthm9.js";
+} from "./index-qyvjp0bq.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{worktree-collision-ownership-f7se4wbf.js → worktree-collision-ownership-2jtg2my1.js}

@@ -5,7 +5,7 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-rtkttser.js";
+} from "./index-97psh79d.js";
 import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
@@ -22,8 +22,8 @@ import {
   bunSpawn
 } from "./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/cli/{worktree-isolation-j4qb7mgb.js → worktree-isolation-1v2mythh.js}

@@ -21,48 +21,48 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-bst6epnr.js";
-import"./index-34tawmyx.js";
-import"./index-ymyke19q.js";
-import"./index-tw8ck794.js";
-import"./index-kxzgnz2h.js";
-import"./index-fwnhh6s7.js";
+} from "./index-pz2py5v7.js";
+import"./index-0a0asz2s.js";
+import"./index-vk15nbh4.js";
+import"./index-bma2wrqx.js";
+import"./index-d4e6wpkg.js";
+import"./index-nsr5b69r.js";
 import"./index-134d35c1.js";
 import"./index-abtrcs16.js";
 import"./index-y8552snf.js";
-import"./index-sfemjcb8.js";
-import"./index-evpgszmp.js";
+import"./index-f17j50dx.js";
+import"./index-gxbhp7sx.js";
 import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-z9yhhk6q.js";
-import"./index-gey2257h.js";
-import"./index-mrkgxfeh.js";
-import"./index-8ef23wex.js";
-import"./index-2qrd8mfa.js";
+import"./index-5e5a1y2r.js";
+import"./index-g3xt1d16.js";
+import"./index-q2mvacjr.js";
+import"./index-4p3qfb05.js";
 import"./index-rtry5xyf.js";
 import"./index-zsrtt42s.js";
-import"./index-rtkttser.js";
+import"./index-97psh79d.js";
 import"./index-e1pxav9g.js";
-import"./index-41t3hgaa.js";
-import"./index-zpp507z0.js";
-import"./index-90w06fqr.js";
-import"./index-cqfp05jb.js";
+import"./index-92cxd0r1.js";
+import"./index-zsmsy1dh.js";
+import"./index-kwxp0z0n.js";
+import"./index-fzqhn96z.js";
 import"./index-556ja8an.js";
 import"./index-7sy3aa9m.js";
 import"./index-wx8zdh4a.js";
 import"./index-3g0xk6tk.js";
 import"./index-85gkedsf.js";
-import"./index-qpke2x5h.js";
-import"./index-ff66fbjt.js";
+import"./index-kfmee1cr.js";
+import"./index-zd1mfygt.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-neh8azwc.js";
+} from "./index-jfcgnvg6.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-17e73wac.js";
-import"./index-7axx11dt.js";
-import"./index-v3y3qg48.js";
+import"./index-5qwmpamg.js";
+import"./index-fay8h6v8.js";
+import"./index-cpg98bh1.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-w8pgjr75.js";
@@ -70,12 +70,12 @@ import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-dzan8czb.js";
-import"./index-mpf01swm.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-gf03198s.js";
-import"./index-dppzthm9.js";
+import"./index-kggqpefz.js";
+import"./index-bghwrr59.js";
+import"./index-qyvjp0bq.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-ed5ykebp.js";

package/dist/commands/memory.d.ts

@@ -10,3 +10,11 @@ export declare function handleMemoryMigrateCommand(directory: string, _args: str
 export declare function handleMemoryImportCommand(directory: string, _args: string[]): Promise<string>;
 export declare function handleMemoryExportCommand(directory: string, _args: string[]): Promise<string>;
 export declare function handleMemoryEvaluateCommand(directory: string, args: string[]): Promise<string>;
+/**
+ * #1466: `/swarm memory audit-verify` — lazily verify the memory_events
+ * hash chain (migration v13) and the _meta chain head. Tampering with any
+ * chained row, deleting a middle row, or editing the last row breaks the
+ * verification. Non-SQLite providers report the gap explicitly instead of
+ * pretending to verify.
+ */
+export declare function handleMemoryAuditVerifyCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/registry.d.ts

@@ -1021,6 +1021,14 @@ export declare const COMMAND_REGISTRY: {
         readonly category: "diagnostics";
         readonly toolPolicy: "agent";
     };
+    readonly 'memory audit-verify': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Verify the memory audit-log hash chain (tamper detection)";
+        readonly subcommandOf: "memory";
+        readonly args: "--json";
+        readonly category: "diagnostics";
+        readonly toolPolicy: "agent";
+    };
     readonly 'memory import': {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Import legacy JSONL memory into SQLite";

package/dist/config/schema.d.ts

@@ -358,8 +358,8 @@ export type PipelineConfig = z.infer<typeof PipelineConfigSchema>;
 export declare const PhaseCompleteConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     required_agents: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-        reviewer: "reviewer";
         coder: "coder";
+        reviewer: "reviewer";
         test_engineer: "test_engineer";
     }>>>;
     require_docs: z.ZodDefault<z.ZodBoolean>;
@@ -841,6 +841,13 @@ export declare const MemoryConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     redaction: z.ZodDefault<z.ZodObject<{
         rejectDurableSecrets: z.ZodDefault<z.ZodBoolean>;
+        detectPii: z.ZodDefault<z.ZodBoolean>;
+        piiDetector: z.ZodDefault<z.ZodEnum<{
+            regex: "regex";
+            ner: "ner";
+        }>>;
+        rejectDurablePii: z.ZodDefault<z.ZodBoolean>;
+        piiThreshold: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     maintenance: z.ZodDefault<z.ZodObject<{
         lowUtilityMaxConfidence: z.ZodDefault<z.ZodNumber>;
@@ -1778,8 +1785,8 @@ export declare const PluginConfigSchema: z.ZodObject<{
     phase_complete: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         required_agents: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-            reviewer: "reviewer";
             coder: "coder";
+            reviewer: "reviewer";
             test_engineer: "test_engineer";
         }>>>;
         require_docs: z.ZodDefault<z.ZodBoolean>;
@@ -2232,6 +2239,13 @@ export declare const PluginConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
         redaction: z.ZodDefault<z.ZodObject<{
             rejectDurableSecrets: z.ZodDefault<z.ZodBoolean>;
+            detectPii: z.ZodDefault<z.ZodBoolean>;
+            piiDetector: z.ZodDefault<z.ZodEnum<{
+                regex: "regex";
+                ner: "ner";
+            }>>;
+            rejectDurablePii: z.ZodDefault<z.ZodBoolean>;
+            piiThreshold: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
         maintenance: z.ZodDefault<z.ZodObject<{
             lowUtilityMaxConfidence: z.ZodDefault<z.ZodNumber>;

package/dist/evidence/task-gate-repair.d.ts

@@ -0,0 +1,26 @@
+export declare const TASK_GATE_REQUIREMENTS_RECONSTRUCTION_SENTINEL = "requirements_reconstruction";
+export interface RepairGateEvidenceArgs {
+    task_id: string;
+    reason: string;
+    expected_sha256?: string;
+    expected_generation?: number;
+}
+export interface RepairGateEvidenceContext {
+    sessionID?: string;
+    messageID?: string;
+}
+export interface RepairGateEvidenceResult {
+    success: boolean;
+    message: string;
+    errors?: string[];
+    repaired?: boolean;
+    task_id?: string;
+    required_gates?: string[];
+    requirements_state?: 'known' | 'unknown';
+    quarantine_digest?: string;
+    quarantine_path?: string;
+    repaired_generation?: number;
+    next_actions?: string[];
+}
+export declare function taskGateEvidenceQuarantinePath(directory: string, taskId: string, digest: string): string;
+export declare function repairTaskGateEvidence(args: RepairGateEvidenceArgs, directory: string, context?: RepairGateEvidenceContext): Promise<RepairGateEvidenceResult>;

package/dist/evidence/task-gate-requirements.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import type { TaskEvidence, TaskWorkflowTransitionEvent } from '../gate-evidence.js';
+declare const TaskGateRequirementsReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    generation: z.ZodNumber;
+    normalizedRole: z.ZodString;
+    testEngineerExempt: z.ZodNullable<z.ZodBoolean>;
+    requiredGates: z.ZodArray<z.ZodString>;
+    sourceEvent: z.ZodString;
+    sourceTransitionId: z.ZodNullable<z.ZodString>;
+    recordedAt: z.ZodString;
+    previousChainHash: z.ZodNullable<z.ZodString>;
+    chainHash: z.ZodString;
+}, z.core.$strict>;
+export type TaskGateRequirementsReceipt = z.infer<typeof TaskGateRequirementsReceiptSchema>;
+export declare function taskGateRequirementsReceiptPath(directory: string, taskId: string): string;
+export declare function readTaskGateRequirementsReceipts(directory: string, taskId: string): Promise<TaskGateRequirementsReceipt[]>;
+export declare function appendTaskGateRequirementsReceiptIfNeeded(directory: string, taskId: string, current: TaskEvidence | null, next: TaskEvidence, event: TaskWorkflowTransitionEvent): Promise<void>;
+export {};

package/dist/gate-evidence.d.ts

@@ -56,10 +56,17 @@ export interface TaskEvidence {
     required_gates: string[];
     gates: Record<string, GateEvidence>;
     turbo?: boolean;
+    requirements_state?: 'known' | 'unknown';
     /** Durable proof that the coder dispatch was classified as exact Markdown-only. */
     test_engineer_exempt?: boolean;
     /** Exact-task workflow metadata. Missing on legacy evidence written before #2098. */
     workflow?: TaskWorkflowMetadata;
+    /** Immutable source identity for an idempotent fail-closed evidence repair. */
+    repair_provenance?: {
+        source_sha256: string | null;
+        source_generation: number | null;
+        requirements_receipt_hash: string | null;
+    };
 }
 /**
  * Fence ordinary evidence writers while a terminal or repair plan/evidence

package/dist/hooks/knowledge-receipt-ledger-storage.d.ts

@@ -31,6 +31,8 @@ declare function recoverLockIfSafe(paths: ReceiptLedgerPaths): Promise<void>;
 export declare function withReceiptLedgerLock<T>(directory: string, action: (paths: ReceiptLedgerPaths) => Promise<T>): Promise<T>;
 export declare function receiptRecordHash(value: unknown): string;
 export declare function readUtf8IfPresent(filePath: string, maxBytes?: number): Promise<string | null>;
+/** Read an authoritative receipt artifact without lossy text decoding. */
+export declare function readBytesIfPresent(filePath: string, maxBytes?: number): Promise<Buffer | null>;
 export declare function appendFsynced(filePath: string, line: string): Promise<void>;
 export declare function atomicWriteFsynced(targetPath: string, content: string): Promise<void>;
 export declare function fileMtimeMs(filePath: string): Promise<number | null>;