opencode-swarm 7.141.2 → 7.142.1

package/dist/cli/{knowledge-link-x86ebng8.js → knowledge-link-fn5j3r4q.js}

@@ -12,14 +12,14 @@ import {
   resolveLinkDir,
   sanitizeLinkId,
   writeLinkPointer
-} from "./index-kq5p3nm3.js";
-import"./index-c2hczjhp.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
+} from "./index-w7x7qxz2.js";
+import"./index-erfnw81g.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{knowledge-store-vt059r81.js → knowledge-store-d0xj6wht.js}

@@ -41,19 +41,19 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-hwxcdrv9.js";
+} from "./index-j02ez59y.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";
-import"./index-kq5p3nm3.js";
-import"./index-c2hczjhp.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
+import"./index-w7x7qxz2.js";
+import"./index-erfnw81g.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
 import"./index-bk5tah7q.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{knowledge-validator-jr5694jb.js → knowledge-validator-ewfj679a.js}

@@ -23,20 +23,20 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-6bp1jecx.js";
-import"./index-v250345n.js";
+} from "./index-9kf3mj08.js";
+import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-hwxcdrv9.js";
+import"./index-j02ez59y.js";
 import"./index-ae75rja9.js";
-import"./index-kq5p3nm3.js";
-import"./index-c2hczjhp.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
+import"./index-w7x7qxz2.js";
+import"./index-erfnw81g.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
 import"./index-bk5tah7q.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{pending-delegations-7xsagjy5.js → pending-delegations-0hb97ps1.js}

@@ -41,16 +41,16 @@ import {
   sweepStaleDelegations,
   updateCoderSettlement,
   writeDelegationFallback
-} from "./index-nse60anv.js";
+} from "./index-7c4bxgdh.js";
 import"./index-k46me75h.js";
 import"./index-ee3x66a5.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
 import"./index-zjygnfay.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{pr-subscriptions-r6cdsa3t.js → pr-subscriptions-b63t252j.js}

@@ -9,16 +9,16 @@ import {
   sweepStale,
   unsubscribe,
   updateSnapshot
-} from "./index-qskz8j2z.js";
+} from "./index-82m5kwtd.js";
 import"./index-k46me75h.js";
 import"./index-ee3x66a5.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
 import"./index-zjygnfay.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{runner-nm3baddf.js → runner-hrg7h2h4.js}

@@ -3,16 +3,16 @@ import {
   _internals,
   createModelEvaluationExecutor,
   runEvaluation
-} from "./index-f1hsrgw1.js";
-import"./index-q4vaar2b.js";
+} from "./index-y9h2vqf6.js";
+import"./index-k92cagmt.js";
 import"./index-y8552snf.js";
-import"./index-c2hczjhp.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
+import"./index-erfnw81g.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{scan-cursor-6nrkcfbr.js → scan-cursor-hfyz7zpw.js}

@@ -4,18 +4,18 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-bxjhn3t3.js";
-import"./index-hwxcdrv9.js";
+} from "./index-vy11zjvh.js";
+import"./index-j02ez59y.js";
 import"./index-ae75rja9.js";
-import"./index-kq5p3nm3.js";
-import"./index-c2hczjhp.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
+import"./index-w7x7qxz2.js";
+import"./index-erfnw81g.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
 import"./index-bk5tah7q.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{schema-f6pt0zjy.js → schema-ney3c685.js}

@@ -96,7 +96,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-mqqmant3.js";
+} from "./index-we279je2.js";
 import"./index-jqsfsqbx.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{scope-persistence-jc0mtp7g.js → scope-persistence-dbfgs7gh.js}

@@ -23,20 +23,20 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-szrcxvr7.js";
+} from "./index-9wmx9ca8.js";
+import"./index-myav90y6.js";
 import"./index-556ja8an.js";
-import"./index-mxtt4x8r.js";
-import"./index-zbj3yrrd.js";
+import"./index-k31en0ja.js";
 import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import"./index-4nt52yr9.js";
-import"./index-y6k6x197.js";
+import"./index-sdqtecsd.js";
 import"./index-4rhhvd1a.js";
 import"./index-zgwm4ryv.js";
-import"./index-mqqmant3.js";
+import"./index-we279je2.js";
 import"./index-jqsfsqbx.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{skill-generator-4vp33gjb.js → skill-generator-p651jex5.js}

@@ -33,32 +33,32 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-h3vk67wp.js";
-import"./index-76651erq.js";
+} from "./index-k1xsjzm3.js";
+import"./index-ajfa2wmj.js";
 import"./index-k46me75h.js";
 import"./index-ee3x66a5.js";
-import"./index-6bp1jecx.js";
-import"./index-v250345n.js";
+import"./index-9kf3mj08.js";
+import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-hwxcdrv9.js";
+import"./index-j02ez59y.js";
 import"./index-ae75rja9.js";
-import"./index-kq5p3nm3.js";
-import"./index-c2hczjhp.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
+import"./index-w7x7qxz2.js";
+import"./index-erfnw81g.js";
 import"./index-ed5ykebp.js";
-import"./index-4nt52yr9.js";
-import"./index-r6pdts5c.js";
+import"./index-ktazgjqw.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-y6k6x197.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
+import"./index-4nt52yr9.js";
+import"./index-sdqtecsd.js";
 import"./index-4rhhvd1a.js";
 import"./index-zgwm4ryv.js";
-import"./index-mqqmant3.js";
+import"./index-we279je2.js";
 import"./index-jqsfsqbx.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{telemetry-zex3zv3v.js → telemetry-xyfb5vm8.js}

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

package/dist/cli/{worktree-collision-ownership-n41qw3n8.js → worktree-collision-ownership-ymdxetnn.js}

@@ -10,18 +10,18 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-nse60anv.js";
+} from "./index-7c4bxgdh.js";
 import"./index-k46me75h.js";
 import"./index-ee3x66a5.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
 import"./index-ed5ykebp.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
 import {
   bunSpawn
 } from "./index-4nt52yr9.js";
 import"./index-zgwm4ryv.js";
 import"./index-zjygnfay.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 

package/dist/cli/{worktree-isolation-a3hkz665.js → worktree-isolation-513vx61s.js}

@@ -20,61 +20,61 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-73sxchez.js";
+} from "./index-h7ye3bzp.js";
 import"./index-4905hd2m.js";
 import"./index-ebwznsfy.js";
-import"./index-f1hsrgw1.js";
-import"./index-kkn2jxda.js";
+import"./index-y9h2vqf6.js";
+import"./index-rthq1a6w.js";
 import"./index-c8s9a3zh.js";
-import"./index-xx0q37xb.js";
-import"./index-why8n7cr.js";
+import"./index-xah70t2t.js";
+import"./index-gtkk5rx7.js";
 import"./index-134d35c1.js";
-import"./index-q4vaar2b.js";
+import"./index-k92cagmt.js";
 import"./index-y8552snf.js";
 import"./index-9ss2m4rs.js";
 import"./index-74hpm6sh.js";
-import"./index-h3vk67wp.js";
-import"./index-aqzvjhb7.js";
-import"./index-bxjhn3t3.js";
+import"./index-k1xsjzm3.js";
+import"./index-xfhe29z3.js";
+import"./index-vy11zjvh.js";
 import"./index-xmzmeknp.js";
-import"./index-qskz8j2z.js";
-import"./index-szrcxvr7.js";
-import"./index-556ja8an.js";
-import"./index-mxtt4x8r.js";
+import"./index-82m5kwtd.js";
 import"./index-zsrtt42s.js";
-import"./index-qa50yyeh.js";
 import"./index-qwm6vdyv.js";
-import"./index-3d13jkzq.js";
-import"./index-nse60anv.js";
+import"./index-2mb5y2w1.js";
+import"./index-bkkxxwcd.js";
+import"./index-7c4bxgdh.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
-import"./index-76651erq.js";
+import"./index-ajfa2wmj.js";
 import"./index-k46me75h.js";
 import"./index-ee3x66a5.js";
-import"./index-6bp1jecx.js";
-import"./index-v250345n.js";
+import"./index-9kf3mj08.js";
+import"./index-tq5s07ta.js";
 import"./index-rtry5xyf.js";
-import"./index-hwxcdrv9.js";
+import"./index-j02ez59y.js";
 import"./index-ae75rja9.js";
-import"./index-kq5p3nm3.js";
-import"./index-c2hczjhp.js";
-import"./index-zbj3yrrd.js";
-import"./index-7g4c7s5r.js";
+import"./index-w7x7qxz2.js";
+import"./index-erfnw81g.js";
 import"./index-ed5ykebp.js";
-import"./index-4nt52yr9.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-r6pdts5c.js";
+} from "./index-ktazgjqw.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
-import"./index-y6k6x197.js";
+import"./index-9wmx9ca8.js";
+import"./index-myav90y6.js";
+import"./index-556ja8an.js";
+import"./index-k31en0ja.js";
+import"./index-7g4c7s5r.js";
+import"./index-s2rcz51a.js";
+import"./index-4nt52yr9.js";
+import"./index-sdqtecsd.js";
 import"./index-4rhhvd1a.js";
 import"./index-zgwm4ryv.js";
-import"./index-mqqmant3.js";
+import"./index-we279je2.js";
 import"./index-jqsfsqbx.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
-import"./index-9d4gck4e.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/commands/close.d.ts

@@ -1,4 +1,5 @@
 import { loadPluginConfigWithMeta } from '../config';
+import type { Plan } from '../config/plan-schema';
 import { type KnowledgeConfig, type PluginConfig } from '../config/schema';
 import { archiveEvidence } from '../evidence/manager';
 import { getGitRepositoryStatus, resetToMainAfterMerge, resetToRemoteBranch } from '../git/branch';
@@ -15,9 +16,9 @@ export declare const closeReceiptLifecycleInternals: {
     reconcilePhaseClose: typeof reconcilePhaseClose;
 };
 import { runFinalizeRewardSweep } from '../memory/finalize-reward-sweep';
-import { closePlanTerminalState } from '../plan/manager';
 import { type SessionReflectionResult } from '../services/session-reflection';
 import { endAgentSession, resetSwarmStatePreservingSingletons } from '../state';
+import { type CloseTerminalResult } from '../workflow/close-terminal.js';
 import { type SqliteRowCounts } from './archive-sqlite';
 interface PlanPhase {
     id: number;
@@ -33,6 +34,22 @@ interface PlanData {
     title: string;
     phases: PlanPhase[];
 }
+/**
+ * Close-command wrapper around the exact-task terminal reconciliation service.
+ *
+ * Deliberately NOT named `closePlanTerminalState`: `src/plan/manager.ts` exports a
+ * distinct function by that name (ledger-first phase/projection persistence), which
+ * `reconcileCloseTerminalState` itself calls downstream. Keeping the two identifiers
+ * distinct avoids a same-name collision across close.ts / close-terminal.ts /
+ * plan/manager.ts. The `_internals` key below stays `closePlanTerminalState` so the
+ * existing test seam is unchanged.
+ */
+declare function reconcileCloseTerminalStateForPlan(directory: string, targetPlan: Plan, options: {
+    actor: string;
+    requestedClosedTaskIds: string[];
+    closedPhaseIds: number[];
+    originalStatuses?: Map<string, string>;
+}): Promise<CloseTerminalResult | undefined>;
 interface CloseCommandOptions {
     sessionID?: string;
     skillReviewTimeoutMs?: number;
@@ -113,6 +130,7 @@ export interface CloseStageContext {
         closedPhaseIds: number[];
         closedTaskIds: string[];
     };
+    terminalizationError?: string;
     archiveResult: string;
     archivedFileCount: number;
     archivedActiveStateFiles: Set<string>;
@@ -274,7 +292,7 @@ export declare const _internals: {
     runAlignStage: typeof runAlignStage;
     runFinalizeDryRun: typeof runFinalizeDryRun;
     archiveEvidence: typeof archiveEvidence;
-    closePlanTerminalState: typeof closePlanTerminalState;
+    closePlanTerminalState: typeof reconcileCloseTerminalStateForPlan;
     endAgentSession: typeof endAgentSession;
     flushAndDrainTelemetry: () => Promise<void>;
 };

package/dist/commands/hive-quarantine.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `/swarm knowledge hive-quarantine` — human-only knowledge maintenance for the
+ * machine-global hive store (issue #2033).
+ *
+ * Flow (operator-driven; no `--yes`/`--force` flag exists — the only
+ * non-interactive escape is the explicit SWARM_ALLOW_HUMAN_ONLY_CLI=1 opt-in):
+ *   preview  <id>[,<id>…]            read-only snapshot + confirmation token
+ *   commit   --token <t> [--reason r] validated backup → exact-ID quarantine → verify
+ *   rollback --token <t12> | --latest  idempotent byte-exact restore from the manifest
+ *   status                            read-only list of quarantine backups
+ *
+ * Layered gates (PR #2200 review): `toolPolicy: 'human-only'` refuses agents at
+ * `swarm_command` classification and the chat-fallback policy blocks agent-typed
+ * usage; the shell guardrail blocks direct, quoted, path-qualified, and
+ * shell-variable-indirected CLI invocations from agent shells; the CLI entry
+ * itself refuses human-only commands from non-interactive shells (aliases
+ * resolved to their canonical policy). The confirmation token is HMAC-bound to
+ * a per-install secret, so it cannot be minted from public store contents
+ * alone. These layers are defense-in-depth with an honest audit trail — local
+ * single-user tooling cannot be tamper-proof against the owning user, and the
+ * docs make no absolute claim otherwise.
+ */
+export declare function handleKnowledgeHiveQuarantineCommand(_directory: string, args: string[]): Promise<string>;

package/dist/commands/registry.d.ts

@@ -910,6 +910,15 @@ export declare const COMMAND_REGISTRY: {
         readonly args: "<entry-id>";
         readonly category: "utility";
     };
+    readonly 'knowledge hive-quarantine': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Human-only exact-ID quarantine of hive-store entries with backup and rollback";
+        readonly subcommandOf: "knowledge";
+        readonly details: string;
+        readonly args: "<preview|commit|rollback|status> ...";
+        readonly category: "utility";
+        readonly toolPolicy: "human-only";
+    };
     readonly 'knowledge unactionable': {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "List unactionable knowledge entries pending hardening";

package/dist/gate-evidence.d.ts

@@ -22,7 +22,7 @@ export interface GateEvidence {
     agent: string;
 }
 export declare const TASK_WORKFLOW_SCHEMA_MARKER: "exact-task-v1";
-declare const TASK_WORKFLOW_OUTCOMES: readonly ["none", "dispatch_attempted", "dispatch_no_mutation", "accepted_mutation", "accepted_mutation_failed", "stage_a_passed", "stage_a_failed", "stage_b_completed", "stage_b_failed", "gate_recorded", "task_completed", "task_blocked", "repair_idle"];
+declare const TASK_WORKFLOW_OUTCOMES: readonly ["none", "dispatch_attempted", "dispatch_no_mutation", "accepted_mutation", "accepted_mutation_failed", "stage_a_passed", "stage_a_failed", "stage_b_completed", "stage_b_failed", "gate_recorded", "task_completed", "task_blocked", "task_closed", "repair_idle"];
 export type TaskWorkflowTransitionOutcome = (typeof TASK_WORKFLOW_OUTCOMES)[number];
 export interface TaskWorkflowMetadata {
     schema: typeof TASK_WORKFLOW_SCHEMA_MARKER;
@@ -35,6 +35,18 @@ export interface TaskWorkflowMetadata {
     lastOutcome: TaskWorkflowTransitionOutcome;
     lastTransitionId: string | null;
     updatedAt: string;
+    /**
+     * True when this task reached `complete` via a QA-exempt forced completion
+     * (`/swarm close` reconciling a task that plan.json already marked completed but
+     * for which no authoritative workflow evidence existed) rather than by passing
+     * the normal Stage B gates.
+     *
+     * Without this the durable evidence file is byte-identical for a genuinely
+     * QA'd completion and a forced one, so no consumer can tell them apart. Absent
+     * on evidence written before this field existed, which reads as "not forced" —
+     * the same answer those files would have given anyway.
+     */
+    forcedCompletion?: boolean;
 }
 export interface TaskWorkflowSnapshot extends TaskWorkflowMetadata {
     authoritative: boolean;
@@ -113,6 +125,10 @@ export type TaskWorkflowTransitionEvent = {
     type: 'task_blocked';
     expectedGeneration: number;
     transitionId?: string;
+} | {
+    type: 'task_closed';
+    expectedGeneration: number;
+    transitionId?: string;
 } | {
     type: 'repair_idle';
     expectedGeneration: number;
@@ -176,6 +192,13 @@ export declare function recordAgentDispatch(directory: string, taskId: string, a
 /**
  * Returns the TaskEvidence for a task, or null if file missing or parse error.
  * Never throws.
+ *
+ * Note this collapses "no evidence file" and "evidence file is unreadable" into the
+ * same `null`, which degrades two delegation-gate checks when an older build reads
+ * evidence carrying a `workflow.state` it does not recognise. Tracked in #2199 — do
+ * not "fix" this by rethrowing here: two call sites iterate every task in the plan,
+ * so one corrupt file would block dispatch for all of them. The fix is a separate
+ * discriminated reader used at the two affected sites.
  */
 export declare function readTaskEvidence(directory: string, taskId: string): Promise<TaskEvidence | null>;
 /**

package/dist/hooks/hive-transaction.d.ts

@@ -34,6 +34,7 @@
  * This module holds NO module-level mutable state (invariant 8) and is NOT
  * imported on the plugin-init path (invariant 1).
  */
+import { appendFile } from 'node:fs/promises';
 import * as path from 'node:path';
 import lockfile from 'proper-lockfile';
 import { atomicWriteFile } from '../evidence/task-file.js';
@@ -53,6 +54,29 @@ export interface HiveTxContext {
 export interface HiveAuditEntry {
     line: string;
 }
+/**
+ * A staged raw append to a JSONL file inside the hive data dir, performed under the
+ * held directory lock AFTER the atomic store write (issue #2033). Used by the
+ * human-only hive-quarantine flow to append quarantine records to the
+ * `shared-learnings-quarantined.jsonl` sidecar with the same atomicity guarantees as
+ * the audit log — never via `appendKnowledge`, which would re-enter the lock.
+ */
+export interface HiveStagedAppend {
+    /** Absolute path of an existing-or-new .jsonl file inside the hive data dir. */
+    path: string;
+    /** Pre-serialized JSONL block (newline-terminated lines). */
+    block: string;
+}
+/**
+ * Thrown when a staged append fails AFTER the atomic store rewrite (issue #2033). The
+ * store mutation already happened, so callers must compensate (the hive-quarantine flow
+ * restores from its just-written backup) rather than treating this as a clean abort.
+ */
+export declare class HiveStagedAppendError extends Error {
+    readonly stagedPath: string;
+    readonly cause: unknown;
+    constructor(stagedPath: string, cause: unknown);
+}
 /** The result a mutation closure returns. */
 export type HiveMutationOutcome<T> = {
     kind: 'commit';
@@ -63,6 +87,22 @@ export type HiveMutationOutcome<T> = {
     rejects?: RejectedLesson[];
     /** Audit lines to append to the hive events log under the lock. */
     audit?: HiveAuditEntry[];
+    /**
+     * Additional staged raw JSONL appends under the same lock (issue #2033).
+     * Each path is validated (before the atomic write) to resolve inside the
+     * hive data dir, end in `.jsonl`, and NOT sit under `quarantine-backups/`
+     * (reparse/junction defense). These appends are NEVER FIFO-trimmed.
+     */
+    extraStagedAppends?: HiveStagedAppend[];
+    /**
+     * Exact raw line bytes to persist for specific entry ids (issue #2033),
+     * overriding the `JSON.stringify(entry)` serialization. Used by the
+     * hive-quarantine rollback so restored legacy-shaped entries are written
+     * byte-exactly instead of re-serialized through the normalize-on-read
+     * pipeline. A Map by contract (PR review CC-9): plain-object maps
+     * silently corrupt prototype-key ids like '__proto__'.
+     */
+    rawLineOverrides?: ReadonlyMap<string, string>;
     /** Caller return value surfaced back through HiveTransactionResult. */
     return: T;
 } | {
@@ -109,5 +149,6 @@ export declare const _internals: {
     resolveHiveKnowledgePath: typeof resolveHiveKnowledgePath;
     resolveHiveRejectedPath: typeof resolveHiveRejectedPath;
     resolveHiveEventsPath: typeof resolveHiveEventsPath;
+    appendFile: typeof appendFile;
     path: typeof path;
 };