opencode-swarm 7.181.1 → 7.181.2

package/dist/session/restart-reconciliation.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Owner-named restart reconciliation (issue #2668).
+ *
+ * At the rehydrate boundary, ephemeral execution authority expires by design
+ * (`delegationActive` and friends are reset in
+ * `TRANSIENT_SESSION_FIELDS`) — but the expiry must not be silent. When a
+ * serialized session arrives with in-flight authority, the boundary records a
+ * bounded, owner-named reconciliation outcome so an operator (and the
+ * resumed session) can tell "interrupted mid-execution, outcome UNKNOWN"
+ * from "was idle": absence must never read as success.
+ *
+ * Two surfaces, written together inside the rehydrate populate loop (after
+ * the transient reset, before the caller proceeds to the projection write):
+ *
+ * 1. The durable artifact `.swarm/session/restart-reconciliation.json` — a
+ *    bounded list (cap {@link MAX_RESTART_RECONCILIATION_ENTRIES}, FIFO
+ *    overflow) deduped by `(sessionId, taskId)` so a repeated restart
+ *    refreshes the entry instead of duplicating it.
+ * 2. A one-shot advisory string pushed into the rehydrated session's
+ *    `pendingAdvisoryMessages` (per-restart; the next rehydrate re-derives
+ *    it).
+ *
+ * The record deliberately COMPOSES the shipped recovery surfaces instead of
+ * duplicating them: guidance points operators at `/swarm recover` (stale
+ * coder-settlement WALs) and `/swarm status` (uncertain provider effects),
+ * and the #2665 `stale`/`ambiguous`/`live_wedge` classification for
+ * coder settlements remains owned by those stores.
+ */
+/** Relative to the project root's `.swarm/` directory. */
+export declare const RESTART_RECONCILIATION_FILE = "session/restart-reconciliation.json";
+export declare const MAX_RESTART_RECONCILIATION_ENTRIES = 50;
+export type RestartReconciliationClassification = 'interrupted';
+export interface RestartReconciliationEntry {
+    sessionId: string;
+    agentName: string;
+    /** The task the interrupted execution was driving ('(unknown)' when the snapshot carried none). */
+    taskId: string;
+    classification: RestartReconciliationClassification;
+    observedAt: string;
+    guidance: string;
+}
+export interface RestartReconciliationFile {
+    version: 1;
+    entries: RestartReconciliationEntry[];
+}
+export declare const RESTART_RECONCILIATION_GUIDANCE = "outcome UNKNOWN \u2014 do not assume success; inspect /swarm status for uncertain provider effects; /swarm recover settles stale coder-settlement WALs; a human must resolve external effects (pushed commits, published PRs) manually";
+/**
+ * Read the reconciliation artifact fail-closed: absent, corrupt, partial, or
+ * oversized files read as an empty list — the boundary then re-records what
+ * it observes and the artifact heals on the next append.
+ */
+export declare function readRestartReconciliation(directory: string): RestartReconciliationFile;
+/**
+ * Append (or refresh, keyed by `(sessionId, taskId)`) a reconciliation entry
+ * and persist the bounded list atomically. Fail-open: a write error is
+ * logged and swallowed — the reconciliation record must never fail the
+ * rehydrate that produces it.
+ */
+export declare function recordInterruptedExecution(directory: string, entry: {
+    sessionId: string;
+    agentName: string;
+    taskId: string;
+    observedAt?: string;
+    guidance?: string;
+}): Promise<RestartReconciliationEntry>;
+/**
+ * The one-shot session advisory naming the owner of the interrupted effect.
+ * Pushed into `pendingAdvisoryMessages` AFTER the transient-field reset so
+ * it survives the rehydrate that produced it.
+ */
+export declare function buildInterruptedAdvisoryDedupeKey(entry: Pick<RestartReconciliationEntry, 'sessionId' | 'taskId'>): string;
+export declare function buildInterruptedAdvisoryMessage(entry: Pick<RestartReconciliationEntry, 'sessionId' | 'agentName' | 'taskId'> & {
+    guidance?: string;
+}): string;

package/dist/state.d.ts

@@ -417,9 +417,12 @@ export interface AgentSessionState {
     autoProceedNudgeDone?: boolean;
     /** Session-level QA gate overrides layered on top of the spec-level profile.
      *  Overrides can only enable gates (true); false values are ignored by
-     *  getEffectiveGates. Cleared on session reset. Optional for backwards
-     *  compatibility with pre-existing session state fixtures; consumers
-     *  should read via `session.qaGateSessionOverrides ?? {}`. */
+     *  getEffectiveGates. Durable runtime policy (#2668): the authoritative copy
+     *  lives in the project DB (qa_gate_session_override), written durable-first
+     *  by `/swarm qa-gates override`, restored by rehydrateState, and deleted in
+     *  lockstep with the session (end/stale-eviction/reset). Optional for
+     *  backwards compatibility with pre-existing session state fixtures;
+     *  consumers should read via `session.qaGateSessionOverrides ?? {}`. */
     qaGateSessionOverrides?: Partial<QaGates>;
     /** Session-scoped Full Auto flag for autonomous multi-agent oversight */
     fullAutoMode: boolean;

package/dist/tools/get-qa-gate-profile.d.ts

@@ -3,12 +3,15 @@
  *
  * Read-only: uses plan.json identity when available or an explicit exact
  * swarm/title pair before plan creation, then looks up the profile in the
- * per-project DB. Returns the spec-level profile gates, lock state, and profile
- * hash. Callers layering session overrides should combine with
- * `getEffectiveGates` themselves — this tool intentionally returns the
- * persisted/locked spec-level view.
+ * per-project DB. Returns the spec-level profile gates, lock state, and
+ * profile hash, plus — when the caller carries a session context (#2668) —
+ * the session's ratchet-tighter overrides and the EFFECTIVE gates (profile
+ * merged with those overrides) so an agent can inspect the effective
+ * runtime policy after a restart. The live session's override cache is
+ * authoritative when present; the durable `qa_gate_session_override` row is
+ * the restart authority consulted when the live session is absent.
  */
-import type { tool } from '@opencode-ai/plugin';
+import type { ToolContext, tool } from '@opencode-ai/plugin';
 import { type QaGatePlanIdentityArgs } from './qa-gate-plan-identity.js';
 export type GetQaGateProfileArgs = QaGatePlanIdentityArgs;
 interface GetQaGateProfileResult {
@@ -25,7 +28,11 @@ interface GetQaGateProfileResult {
         created_at: string;
         profile_hash: string;
     };
+    /** Calling session's ratchet-tighter overrides (empty when no session context or none set). */
+    session_overrides?: Record<string, boolean>;
+    /** Effective gates: profile merged with the calling session's overrides (#2668). */
+    effective_gates?: Record<string, boolean>;
 }
-export declare function executeGetQaGateProfile(args: GetQaGateProfileArgs, directory: string): Promise<GetQaGateProfileResult>;
+export declare function executeGetQaGateProfile(args: GetQaGateProfileArgs, directory: string, ctx?: ToolContext): Promise<GetQaGateProfileResult>;
 export declare const get_qa_gate_profile: ReturnType<typeof tool>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.181.1",
+	"version": "7.181.2",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",