opencode-swarm 7.145.0 → 7.145.2

package/dist/cli/{scope-persistence-dv6z7n08.js → scope-persistence-mj1w3hqw.js}

@@ -23,19 +23,22 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-4zwjc9sb.js";
-import"./index-apjdytwx.js";
+} from "./index-vav705md.js";
+import"./index-673axbjx.js";
 import"./index-556ja8an.js";
-import"./index-0pcq32y2.js";
-import"./index-zfhe7vbb.js";
-import"./index-v3y3qg48.js";
+import"./index-2vefr1f8.js";
+import"./index-gpnv14kq.js";
+import"./index-cpg98bh1.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
+import"./index-w8pgjr75.js";
+import"./index-z6xqpmqg.js";
+import"./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-pa86tpgt.js";
-import"./index-zz5qsjd1.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-drscnzq9.js → skill-generator-gsa6qwwt.js}

@@ -33,31 +33,31 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-mkks7jwg.js";
-import"./index-h4hasck4.js";
-import"./index-fp464as8.js";
+} from "./index-jgb7mq2y.js";
+import"./index-jpppcckq.js";
+import"./index-4p3qfb05.js";
 import"./index-rtry5xyf.js";
-import"./index-qfawexc8.js";
-import"./index-c13ttmak.js";
-import"./index-7g276m9m.js";
+import"./index-6wf75rcm.js";
+import"./index-cxn95n7q.js";
+import"./index-czde45km.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
+import"./index-2vefr1f8.js";
+import"./index-gpnv14kq.js";
+import"./index-cpg98bh1.js";
+import"./index-9e6fdz2h.js";
+import"./index-4rhhvd1a.js";
 import"./index-w8pgjr75.js";
 import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
-import"./index-0pcq32y2.js";
-import"./index-zfhe7vbb.js";
-import"./index-v3y3qg48.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-s72naw1j.js";
-import"./index-6q3agdmr.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-pa86tpgt.js";
-import"./index-zz5qsjd1.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-z54dgdrh.js → telemetry-t109dhv7.js}

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

package/dist/cli/{workspace-snapshot-q21mgbsh.js → workspace-snapshot-kznz5e13.js}

@@ -6,6 +6,7 @@ import {
   compareWorkspaceSnapshot,
   compareWorkspaceSnapshots,
   digest,
+  isSwarmRuntimePath,
   parsePorcelainPaths,
   parsePorcelainV2Snapshot,
   readGitTextAtRevision,
@@ -37,10 +38,10 @@ import {
   resolveRemoteRefsContainingHeadAsync,
   switchPrFeedbackTrackingCandidateAsync,
   workspaceSnapshotMatches
-} from "./index-b30x236n.js";
-import"./index-zj6t9zgx.js";
+} from "./index-z9yhhk6q.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
+import"./index-zj6t9zgx.js";
 import"./index-zgwm4ryv.js";
 import"./index-a76rekgs.js";
 export {
@@ -75,6 +76,7 @@ export {
   readGitTextAtRevision,
   parsePorcelainV2Snapshot,
   parsePorcelainPaths,
+  isSwarmRuntimePath,
   digest,
   compareWorkspaceSnapshots,
   compareWorkspaceSnapshot,

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

@@ -5,25 +5,25 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-ffdwj1an.js";
+} from "./index-97psh79d.js";
 import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
   scanWorktreeProvisioningOwnersForRecovery
 } from "./index-e1pxav9g.js";
-import"./index-w8pgjr75.js";
-import"./index-z6xqpmqg.js";
-import {
-  bunSpawn
-} from "./index-zj6t9zgx.js";
 import {
   init_git_executable,
   resolveGitExecutable
 } from "./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
+import"./index-w8pgjr75.js";
+import"./index-z6xqpmqg.js";
+import {
+  bunSpawn
+} from "./index-zj6t9zgx.js";
 import"./index-zjygnfay.js";
-import"./index-pa86tpgt.js";
-import"./index-zz5qsjd1.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-4tehtym5.js → worktree-isolation-ajzyp2gm.js}

@@ -8,6 +8,7 @@ import {
   cleanupStandardWorktreeForCallId,
   computeLaneRuntimeProfile,
   finishStandardWorktreeDispatch,
+  getStandardWorktreeDegradationReason,
   isLaneOwnedByCurrentSession,
   parseLeanLaneIndex,
   preProvisionCollisionCheck,
@@ -20,61 +21,61 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-6ezbzd5e.js";
-import"./index-2dnqazyr.js";
-import"./index-0jr9zn34.js";
-import"./index-v64kjqvg.js";
+} from "./index-cb2qtetk.js";
+import"./index-0a0asz2s.js";
+import"./index-1g87esfp.js";
+import"./index-612rr70a.js";
+import"./index-917z76qr.js";
+import"./index-nsr5b69r.js";
 import"./index-134d35c1.js";
 import"./index-abtrcs16.js";
-import"./index-wk54ey3h.js";
-import"./index-jy9bwa9k.js";
 import"./index-y8552snf.js";
-import"./index-e00wbqw5.js";
+import"./index-ncfjxz9n.js";
+import"./index-np4ytvvv.js";
 import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
-import"./index-b30x236n.js";
-import"./index-77ef8gye.js";
-import"./index-mkks7jwg.js";
-import"./index-b3xret0a.js";
-import"./index-h4hasck4.js";
-import"./index-fp464as8.js";
+import"./index-z9yhhk6q.js";
+import"./index-5e5a1y2r.js";
+import"./index-jgb7mq2y.js";
+import"./index-jpppcckq.js";
+import"./index-4p3qfb05.js";
 import"./index-rtry5xyf.js";
 import"./index-zsrtt42s.js";
-import"./index-ffdwj1an.js";
+import"./index-97psh79d.js";
 import"./index-e1pxav9g.js";
-import"./index-s6cwsnrw.js";
-import"./index-6hqhyb0f.js";
-import"./index-4zwjc9sb.js";
-import"./index-apjdytwx.js";
+import"./index-n55a28zr.js";
+import"./index-rk80jhef.js";
+import"./index-vav705md.js";
+import"./index-673axbjx.js";
 import"./index-556ja8an.js";
 import"./index-7sy3aa9m.js";
 import"./index-wx8zdh4a.js";
 import"./index-3g0xk6tk.js";
 import"./index-85gkedsf.js";
-import"./index-qfawexc8.js";
-import"./index-c13ttmak.js";
+import"./index-6wf75rcm.js";
+import"./index-cxn95n7q.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-7g276m9m.js";
+} from "./index-czde45km.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
+import"./index-2vefr1f8.js";
+import"./index-gpnv14kq.js";
+import"./index-cpg98bh1.js";
+import"./index-9e6fdz2h.js";
+import"./index-4rhhvd1a.js";
 import"./index-w8pgjr75.js";
 import"./index-z6xqpmqg.js";
 import"./index-zj6t9zgx.js";
-import"./index-0pcq32y2.js";
-import"./index-zfhe7vbb.js";
-import"./index-v3y3qg48.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-s72naw1j.js";
-import"./index-6q3agdmr.js";
+import"./index-x8pm918t.js";
+import"./index-j20fzn0w.js";
 import"./index-bk5tah7q.js";
-import"./index-4evasm2b.js";
-import"./index-pa86tpgt.js";
-import"./index-zz5qsjd1.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";
@@ -94,6 +95,7 @@ export {
   preProvisionCollisionCheck,
   parseLeanLaneIndex,
   isLaneOwnedByCurrentSession,
+  getStandardWorktreeDegradationReason,
   finishStandardWorktreeDispatch,
   computeLaneRuntimeProfile,
   cleanupStandardWorktreeForCallId,

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

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/delegation-gate/worktree-isolation.d.ts

@@ -125,6 +125,10 @@ interface SessionSerializationState {
      */
     successfulDispatchesSince: number;
 }
+export declare function getStandardWorktreeDegradationReason(sessionID: string): {
+    reason: string;
+    at: number;
+} | undefined;
 export declare function resetStandardWorktreeIsolationState(): void;
 /**
  * FR-104 SC-111/SC-112: Check whether a serialized session has met its release conditions

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>;

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

@@ -1,4 +1,4 @@
-import { atomicWriteFsynced, type ReceiptLedgerPaths, type ReceiptStoreErrorCode } from './knowledge-receipt-ledger-storage.js';
+import { appendFsynced, atomicWriteFsynced, type ReceiptLedgerPaths, type ReceiptStoreErrorCode } from './knowledge-receipt-ledger-storage.js';
 import { type KnowledgeReceiptTransitionObservation } from './knowledge-receipt-observability.js';
 /**
  * Canonical terminal-outcome vocabulary for the authoritative receipt ledger
@@ -27,7 +27,7 @@ export declare const RECEIPT_TERMINAL_OUTCOMES: ReadonlySet<ReceiptOutcome>;
  * preserved as `'unknown'` and is never coerced to delegate, ignored, or any
  * other class. New producers must stamp one of the closed values below.
  */
-export type ReceiptSourceCode = 'delegate' | 'reviewer' | 'architect' | 'architect_marker' | 'test_engineer' | 'phase_override' | 'application_gate_staleness_clear' | 'application_gate_denial_limit_clear' | 'manual' | 'migration' | 'unknown';
+export type ReceiptSourceCode = 'delegate' | 'reviewer' | 'architect' | 'architect_marker' | 'test_engineer' | 'phase_override' | 'application_gate_staleness_release' | 'application_gate_denial_limit_release' | 'manual' | 'migration' | 'unknown';
 /** Closed set form of {@link ReceiptSourceCode}. */
 export declare const CANONICAL_RECEIPT_SOURCES: ReadonlySet<string>;
 /**
@@ -65,6 +65,13 @@ export interface ReceiptApplicationMarker {
     event_id: string;
     committed_at: string;
 }
+export interface ReceiptGateRelease {
+    source: string;
+    reason?: string;
+    event_id: string;
+    committed_at: string;
+    membership_event_id: string;
+}
 export interface ReceiptMembership {
     trace_id: string;
     entry_id: string;
@@ -84,11 +91,24 @@ export interface ReceiptMembership {
     /** Append-only audited terminal transitions; `terminal` is the current gate state. */
     terminal_history?: ReceiptTerminal[];
     application_marker?: ReceiptApplicationMarker;
+    gate_release?: ReceiptGateRelease;
     cohort_id?: string;
     source_link_id?: string;
     exposure_kind: ReceiptExposureKind;
     origin: 'v2' | 'legacy';
 }
+export interface ReceiptRepairUncertainty {
+    phase: string;
+    session_id: string;
+    task_id?: string;
+    reason: string;
+    repair_id: string;
+    installed_at: string;
+    raw_journal_sha256: string;
+    raw_journal_bytes: number;
+    salvage_through_seq: number;
+    salvage_through_hash: string;
+}
 export type ReceiptExposureKind = 'architect_directive' | 'delegate_directive' | 'manual_recall' | 'legacy_unknown';
 interface EmptyTrace {
     trace_id: string;
@@ -122,7 +142,7 @@ interface ReceiptAuditSummary {
     entry_ids?: string[];
     reason_codes?: string[];
 }
-export type ReceiptTransitionKind = 'membership_committed' | 'empty_retrieval_committed' | 'terminal_committed' | 'terminal_attempt_rejected' | 'terminal_attempt_idempotent' | 'authorized_transition_committed' | 'application_marker_committed' | 'phase_close_intent' | 'phase_closed' | 'legacy_imported' | 'legacy_unverifiable' | 'cutover_completed' | 'checkpoint';
+export type ReceiptTransitionKind = 'membership_committed' | 'empty_retrieval_committed' | 'terminal_committed' | 'terminal_attempt_rejected' | 'terminal_attempt_idempotent' | 'authorized_transition_committed' | 'application_marker_committed' | 'gate_release_committed' | 'phase_close_intent' | 'phase_closed' | 'repair_uncertainty_installed' | 'repair_uncertainty_cleared' | 'legacy_imported' | 'legacy_unverifiable' | 'cutover_completed' | 'checkpoint';
 interface LedgerState {
     memberships: Map<string, ReceiptMembership>;
     traceIds: Set<string>;
@@ -132,6 +152,7 @@ interface LedgerState {
     legacyTraceRegistry: Set<string>;
     legacyUnverifiableTraceIds: Set<string>;
     phaseLifecycle: Map<string, PhaseLifecycle>;
+    repairUncertainties: Map<string, ReceiptRepairUncertainty>;
     auditTail: ReceiptAuditSummary[];
     lastSeq: number;
     lastHash: string;
@@ -149,6 +170,25 @@ export type ReceiptLedgerResult<T> = ({
     ok: true;
 } & T) | ReceiptUnavailable;
 declare function writeSnapshot(paths: ReceiptLedgerPaths, state: LedgerState): Promise<void>;
+export interface RepairKnowledgeReceiptLedgerInput {
+    phase: string;
+    session_id: string;
+    task_id?: string;
+    reason: string;
+    grace_days?: number;
+}
+export interface ReceiptRepairReevaluationProof {
+    repair_id: string;
+    /** Exact producer assertion that this retrieval covered the full repaired scope. */
+    scope_complete: boolean;
+}
+export declare function repairKnowledgeReceiptLedger(directory: string, input: RepairKnowledgeReceiptLedgerInput): Promise<ReceiptLedgerResult<{
+    status: 'validated_projection' | 'repaired_authority' | 'pending_re_evaluation';
+    pending_re_evaluation: boolean;
+    repair_id?: string;
+    salvage_through_seq: number;
+    salvage_through_hash: string;
+}>>;
 export interface CommitDisplayedMembershipInput {
     trace_id: string;
     session_id: string;
@@ -166,6 +206,8 @@ export interface CommitDisplayedMembershipInput {
     source_link_id?: string;
     /** Producer provenance used by application gates; omitted callers fail closed. */
     exposure_kind?: ReceiptExposureKind;
+    /** Explicit repair-bound proof; ordinary retrievals intentionally omit this. */
+    repair_re_evaluation?: ReceiptRepairReevaluationProof;
 }
 export declare function commitDisplayedMembership(directory: string, input: CommitDisplayedMembershipInput): Promise<ReceiptLedgerResult<{
     event_id: string;
@@ -261,6 +303,31 @@ declare function commitApplicationMarkerBatch(directory: string, input: Applicat
         reason: string;
     }>;
 }>>;
+export interface GateReleaseBatchInput {
+    trace_id: string;
+    session_id: string;
+    grace_days?: number;
+    items: Array<{
+        entry_id: string;
+        source?: string;
+        reason?: string;
+    }>;
+}
+export declare function commitGateReleaseBatch(directory: string, input: GateReleaseBatchInput): Promise<ReceiptLedgerResult<{
+    committed: Array<{
+        entry_id: string;
+        event_id: string;
+        membership_event_id: string;
+    }>;
+    idempotent: Array<{
+        entry_id: string;
+        event_id: string;
+    }>;
+    rejected: Array<{
+        entry_id: string;
+        reason: string;
+    }>;
+}>>;
 export interface ApplicationOutcomeBatchInput {
     trace_id: string;
     session_id: string;
@@ -334,10 +401,12 @@ export declare const _internals: {
     nowMs: () => number;
     writeSnapshot: typeof writeSnapshot;
     atomicWriteFsynced: typeof atomicWriteFsynced;
+    appendFsynced: typeof appendFsynced;
     /** Test-only migration fixture for pre-atomic marker-only state. */
     commitApplicationMarkerBatch: typeof commitApplicationMarkerBatch;
     maxJournalRecords: number;
     maxArchiveRecords: number;
     maxArchiveBytes: number;
+    maxRepairQuarantineRecords: number;
 };
 export {};

package/dist/hooks/knowledge-receipt-observability.d.ts

@@ -21,7 +21,7 @@ export declare const RECEIPT_SEMANTICS_VERSION = 2;
  * `no_relevant` tombstone that closes an empty retrieval (not a terminal).
  */
 export type ReceiptObservationOutcome = ReceiptOutcome | 'no_relevant';
-export type KnowledgeReceiptObservedTransition = 'membership_committed' | 'empty_retrieval_committed' | 'terminal_committed' | 'terminal_attempt_rejected' | 'terminal_attempt_idempotent' | 'authorized_transition_committed' | 'application_marker_committed' | 'phase_close_intent' | 'phase_closed' | 'legacy_imported' | 'legacy_unverifiable' | 'cutover_completed' | 'checkpoint';
+export type KnowledgeReceiptObservedTransition = 'membership_committed' | 'empty_retrieval_committed' | 'terminal_committed' | 'terminal_attempt_rejected' | 'terminal_attempt_idempotent' | 'authorized_transition_committed' | 'application_marker_committed' | 'gate_release_committed' | 'phase_close_intent' | 'phase_closed' | 'repair_uncertainty_installed' | 'repair_uncertainty_cleared' | 'legacy_imported' | 'legacy_unverifiable' | 'cutover_completed' | 'checkpoint';
 export type KnowledgeReceiptObservationReasonCode = 'committed' | 'idempotent' | 'trace_not_found' | 'id_not_in_trace' | 'wrong_session' | 'wrong_phase' | 'wrong_task' | 'duplicate_conflicting_terminal' | 'event_id_conflict' | 'invalid_outcome' | 'empty_receipt' | 'lock_timeout' | 'store_unavailable' | 'store_corrupt' | 'legacy_unverifiable' | 'unauthorized_transition';
 export interface KnowledgeReceiptTransitionObservation {
     transition: KnowledgeReceiptObservedTransition;

package/dist/hooks/phase-complete-directive-gate.d.ts

@@ -17,6 +17,7 @@
  * surfaces as a block, never a silent pass.
  */
 export type DirectiveBlockReason = 'no_verdict' | 'unremediated_violation';
+export type DirectiveGateFailureCode = 'RECEIPT_MISSING' | 'RECEIPT_CORRUPT' | 'RECEIPT_LOCK_TIMEOUT' | 'RECEIPT_WRONG_ROOT' | 'RECEIPT_PERMISSION' | 'RECEIPT_TRANSIENT' | 'RECEIPT_STORE_UNAVAILABLE';
 export interface DirectiveGateResult {
     blocked: boolean;
     unresolved: Array<{
@@ -27,6 +28,14 @@ export interface DirectiveGateResult {
     overridden: string[];
     /** True when the gate could not read its inputs (fail-closed → blocked). */
     failedClosed: boolean;
+    failure?: {
+        code: DirectiveGateFailureCode;
+        action_id: 'knowledge_receipt' | 'phase_complete' | 'repair_knowledge_receipt_ledger';
+    };
+    recovery?: {
+        kind: 'tool' | 'retry';
+        action: 'knowledge_receipt' | 'phase_complete' | 'repair_knowledge_receipt_ledger';
+    };
 }
 /**
  * Evaluate all critical directives shown during the phase. Fail-closed.