opencode-swarm 7.181.4 → 7.183.0

package/dist/cli/{worktree-isolation-9fyj85tc.js → worktree-isolation-5kw6jnej.js}

@@ -21,69 +21,69 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-9eg8f4zm.js";
-import"./index-gtpq64q7.js";
+} from "./index-c6zrffwn.js";
+import"./index-fqc1a1vj.js";
 import"./index-hamqvzqn.js";
-import"./index-01r2wrwa.js";
-import"./index-y03jadcy.js";
-import"./index-dkprb20b.js";
-import"./index-0ea0c676.js";
-import"./index-sf51gh68.js";
+import"./index-wjqc2mnc.js";
+import"./index-a6np52p4.js";
+import"./index-9gehw4xb.js";
+import"./index-nmfnggaa.js";
+import"./index-ht88g5mc.js";
 import"./index-txdagbh7.js";
-import"./index-rgfz80gt.js";
+import"./index-mewsqwbq.js";
 import"./index-6b295cas.js";
-import"./index-x4am0jxt.js";
-import"./index-54sd9bbn.js";
-import"./index-1epynxc4.js";
+import"./index-1ex9ecf5.js";
+import"./index-w670pfv4.js";
+import"./index-29f69hzd.js";
 import"./index-rdec0y3z.js";
-import"./index-nw3z614g.js";
+import"./index-30pz2xvj.js";
 import"./index-cjapb4hy.js";
 import"./index-zsrtt42s.js";
-import"./index-r4vve32m.js";
-import"./index-jrxrjz89.js";
-import"./index-by9wfeja.js";
+import"./index-pvtf7cjg.js";
+import"./index-v8ja5zcr.js";
+import"./index-1kpa3an2.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-epq8am78.js";
-import"./index-j97nc02q.js";
-import"./index-v4h99xhr.js";
-import"./index-1msszzg2.js";
-import"./index-hqa71xfm.js";
-import"./index-a2hvmc3a.js";
+import"./index-yv5fmjcf.js";
+import"./index-jf9cvkzr.js";
+import"./index-4aggsva0.js";
+import"./index-wqg2j647.js";
+import"./index-6f7tfq3m.js";
+import"./index-25m6rekr.js";
 import"./index-2s7dvzff.js";
-import"./index-4qpz7mpn.js";
-import"./index-s34y6gbh.js";
+import"./index-94pwd45k.js";
+import"./index-r7dqevkc.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-9s2rp2j5.js";
+} from "./index-qws72zbs.js";
 import"./index-frcemc0b.js";
 import"./index-0725jpp7.js";
-import"./index-y28np6j9.js";
-import"./index-fsye9ygy.js";
-import"./index-427x3j6p.js";
-import"./index-ved1325w.js";
-import"./index-w1ydvzef.js";
-import"./index-vvgpgcyn.js";
+import"./index-k88thqa0.js";
+import"./index-kv0k3b60.js";
+import"./index-rfggc332.js";
+import"./index-820e6w22.js";
+import"./index-wnkx6gs0.js";
+import"./index-5cvm6ykc.js";
 import"./index-rdm3px0g.js";
 import"./index-ry16d01s.js";
-import"./index-kkrbybgt.js";
-import"./index-dwc1wztn.js";
+import"./index-w6hrms7j.js";
+import"./index-0n24h4zb.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-23mdeh2a.js";
-import"./index-ap6hs8fj.js";
-import"./index-mkpdcbye.js";
+import"./index-3bcmw8pc.js";
+import"./index-v2rbpcqy.js";
+import"./index-tt705bap.js";
 import"./index-1xnse449.js";
 import"./index-c1ggtmpm.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-989v83pb.js";
+import"./index-s1y70y0w.js";
 import"./index-gx2vp8gx.js";
-import"./index-6jrn46zy.js";
+import"./index-r65yxdv7.js";
 import"./index-zxdawwc7.js";
-import"./index-3ga3ts3h.js";
-import"./index-2t21pv2v.js";
+import"./index-fb0v3e71.js";
+import"./index-wzec3c4g.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/commands/registry.d.ts

@@ -549,7 +549,7 @@ export declare const COMMAND_REGISTRY: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Report swarm observability events from the SQLite query authority [--task <id>] [--session <id>] [--trace <id>] [--run <batchId>] [--since <ISO-8601>] [--json]";
         readonly args: "--task <id>, --session <id>, --trace <id>, --run <batchId>, --since <ISO-8601>, --json";
-        readonly details: "Bounded, deterministic query over the observability events store in .swarm/swarm.db (the first run performs a bounded, idempotent legacy-import into the local sink). --run filters the lane/dispatch batch axis (workflow.batchId). Unmatched delegation begins are disclosed, never fabricated into ends. --json emits a schemaVersion-tagged block.";
+        readonly details: "Bounded, deterministic query over the observability events store in .swarm/swarm.db (the first run performs a bounded, idempotent legacy-import into the local sink). --run filters the lane/dispatch batch axis (workflow.batchId). Unmatched delegation begins are disclosed, never fabricated into ends. Includes a Task attempts (cohort) section (issue #2676): execution-attempt records folded through a snapshot-qualified cohort with per-class counts, known/unavailable cost split, uncertainty, and an explicit causal-rate qualification line. --json emits a schemaVersion-tagged block (schema v2 adds the taskAttempts cohort field).";
         readonly category: "diagnostics";
         readonly toolPolicy: "agent";
     };

package/dist/commands/report.d.ts

@@ -2,7 +2,7 @@
  * `/swarm report` — bounded, deterministic observability report over the
  * SQLite-native query authority (issue #2482 / D3, absorbing #2048).
  *
- * - Read-only. Queries `.swarm/swarm.db` `observability_event` via the
+ * - Read-only over the stores it queries: queries `.swarm/swarm.db` `observability_event` via the
  *   bounded store queries (`src/db/observability-event-store.ts`); lazily
  *   syncs the rebuildable legacy import (`syncObservabilityImport`) FIRST so
  *   the report covers the bounded `telemetry.jsonl(.1)` window too.
@@ -13,17 +13,33 @@
  *   `--json` emits a versioned JSON block. Each value flag may appear at
  *   most once with a non-empty value; any subset is valid.
  * - Bounded: row cap + truncated flag (`MAX_REPORT_ROWS`), ordering is
- *   `occurred_at, rowid` (code-unit string compare — no locale collation),
- *   so the same query window yields byte-identical output (proven by test).
+ *   `occurred_at, rowid` (code-unit string compare — no locale collation).
+ *   Determinism: the markdown report is byte-identical for the same query
+ *   window (proven by test); the `--json` block additionally carries the
+ *   cohort snapshot's wall-clock `capturedAt`, which the determinism test
+ *   normalizes.
  * - Honest coverage: live vs imported row counts, quarantined rows (excluded
  *   from the timeline), the sink's own health counters, and the delegation
  *   begin/end pairing delta — unmatched begins are DISCLOSED, never
  *   fabricated into ends.
+ * - Task-attempts cohort (issue #2676): `execution_attempt_recorded` rows are
+ *   folded through a SNAPSHOT (denominator cannot drift with the live
+ *   stores) with per-class counts, known/unavailable cost split, uncertainty,
+ *   and an explicit causal-rate qualification line. The report stays
+ *   read-only over the observability stores it queries; the snapshot
+ *   persists its own provenance manifest under
+ *   `.swarm/observability/cohorts/` (the report's evidentiary boundary).
  * - Fail-open: a missing/unopenable store yields an explicit empty report
  *   with `coverage.unavailable`, never an error.
  */
 import { type ObservabilityEventFilter } from '../db/observability-event-store.js';
-export declare const REPORT_JSON_SCHEMA_VERSION = 1;
+/**
+ * v2 (issue #2676): additive `taskAttempts` cohort section — per-class counts,
+ * known/unavailable cost split, uncertainty, and the qualification line, built
+ * from a population snapshot whose denominator cannot drift with the live
+ * stores.
+ */
+export declare const REPORT_JSON_SCHEMA_VERSION = 2;
 interface ParsedReportArgs {
     filter: ObservabilityEventFilter;
     json: boolean;

package/dist/hooks/guardrails/stage-a-route.d.ts

@@ -1,4 +1,5 @@
 import { appendCoreEventSync } from '../../events/core-events.js';
+import { type ExecutionAttemptClass } from '../../services/execution-attempt.js';
 /**
  * Stage A attribution route events (issue #2664).
  *
@@ -27,8 +28,23 @@ export interface StageAGateRouteEventInput {
     /** Attributed task, or null when no single task is attributable. */
     taskId: string | null;
     guardrailsEnabled: boolean;
+    /**
+     * The correlation's workflow generation cursor, when the caller holds one
+     * (the guardrails pending-gate-task map carries it). Required for the
+     * `late` attempt class to be recordable; absent leaves the recorder's
+     * fail-open refusal in force.
+     */
+    generation?: number;
 }
 declare function buildEvent(input: StageAGateRouteEventInput): Record<string, unknown>;
+/**
+ * Route → execution-attempt class (issue #2676). Stage A route events fire at
+ * gate-tool-call COMPLETION (toolAfter), so `valid_pass` is the completed
+ * call's outcome record (`result`, success); the four refusal routes are
+ * `denial` (outcome unknown — the gate refused before a task outcome
+ * existed); `late_result` is `late`; `duplicate_result` is `duplicate`.
+ */
+export declare function stageARouteAttemptClass(route: StageAGateRoute): ExecutionAttemptClass;
 /**
  * Record one Stage A route event. Fail-open for the hook: append failures
  * (typed CORE_EVENT_LOCKED / CORE_EVENT_LINE_TOO_LARGE) are logged warn-only

package/dist/hooks/issue-trace-reducer.d.ts

@@ -37,9 +37,14 @@ export interface IssueReference {
  * - `publication_handoff`: all phases complete; the engine has emitted the
  *   commit-pr directive and stopped driving. This is NOT "issue resolved" —
  *   publication is owned by commit-pr and has not yet been confirmed.
- * - `published`: a verifiable publication receipt was observed. Terminal.
+ * - `published`: a verifiable publication receipt was observed.
+ * - `merge_approval_recorded`: a PR-head-bound merge-approval receipt was
+ *   observed after publication (issue #2564). TERMINAL. The plugin RECORDS the
+ *   human approval for audit; it never certifies, drives, or green-lights the
+ *   merge itself — the merge is human-enforced (mirrors trace-check.sh's
+ *   merge gate posture).
  */
-export type TraceStatus = 'in_progress' | 'publication_handoff' | 'published';
+export type TraceStatus = 'in_progress' | 'publication_handoff' | 'published' | 'merge_approval_recorded';
 export interface TraceState {
     issueNumber: number;
     lastTransition: string | null;
@@ -53,12 +58,26 @@ export interface WorkflowArtifacts {
     allPhasesComplete: boolean;
     /** Reproduction evidence OR a typed waiver is present (issue #2131 2.6). */
     reproductionPermitted: boolean;
+    /**
+     * Phase 0 branch-freshness receipt permits the trace: `synced`, or a
+     * fail-closed fetch failure carrying a recorded user override (issue #2564,
+     * mirroring trace-check.sh phase0). A `behind` result never permits.
+     */
+    freshnessPermitted: boolean;
     /** A verifiable publication receipt has been observed (issue #2131 2.4). */
     publicationObserved: boolean;
     /** A valid recurrence-sweep receipt exists (issue #2131 residual B). */
     recurrenceSweepVerified: boolean;
     /** Fresh reviewer + critic APPROVE verdicts recorded (issue #2131 residual B). */
     implementationReviewVerified: boolean;
+    /**
+     * Every recorded per-phase `trace-check.sh` validation for this issue is a
+     * pass bound to a 40-hex reviewed-commit + tree-id (issue #2564). A fail
+     * entry fails closed until that phase is re-recorded as a pass.
+     */
+    traceValidationVerified: boolean;
+    /** A PR-head-bound merge-approval receipt has been observed (issue #2564). */
+    mergeApprovalObserved: boolean;
 }
 export interface TransitionResult {
     nextMode: string | null;
@@ -77,18 +96,22 @@ export interface ComputeNextModeParams {
  *
  * Decision table (top-to-bottom, first match wins):
  *   (a) No issue reference or trace not requested        → no-op
- *   (b) Trace already published (terminal)               → no-op
+ *   (b) merge_approval_recorded (truly terminal)         → no-op
+ *   (b') published + merge-approval receipt observed     → merge_approval_recorded (RECORDED, never certified)
  *   (c) publication_handoff: observe publication → PUBLISHED; else no-op
  *   (d) Cross-issue guard (spec issue ≠ current issue)   → no-op
  *   (e) Spec does not exist                              → no-op
- *   (f) Spec exists, no plan, reproduction permitted,
+ *   (f-0) Spec exists, no plan, branch-freshness NOT
+ *       permitted                                        → one-shot FRESHNESS_GATE directive
+ *   (f) Spec exists, no plan, freshness permitted, reproduction permitted,
  *       never transitioned (or re-entrant idempotency)   → PLAN
- *   (f-block) Spec exists, no plan, reproduction NOT permitted → no-op
+ *   (f-block) Spec exists, no plan, reproduction NOT permitted → one-shot REPRO_GATE directive
  *   (g) Plan exists but critic not approved              → no-op
  *   (h) Critic approved, phases incomplete, not yet PLAN_TO_EXECUTE → EXECUTE
  *   (i-pre1) Phases complete, impl-review receipt missing → one-shot REVIEW_GATE directive
  *   (i-pre2) Impl-review ok, recurrence-sweep receipt missing → one-shot RECURRENCE_GATE directive
- *   (i) All phases complete + both gates verified, not yet EXECUTE_TO_COMMIT → publication_handoff + COMMIT directive
+ *   (i-pre3) Both ok, trace-validation receipts missing/failing → one-shot TRACE_VALIDATION_GATE directive
+ *   (i) All phases complete + all gates verified, not yet EXECUTE_TO_COMMIT → publication_handoff + COMMIT directive
  *
  * Idempotency: rows (f), (h), (i) return no-op when
  * `traceState.lastTransition` already equals the target transition value.

package/dist/hooks/issue-trace-state.d.ts

@@ -19,6 +19,9 @@ declare function _defaultReproductionReceiptExists(directory: string, issueNumbe
 declare function _defaultPublicationReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
 declare function _defaultRecurrenceSweepReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
 declare function _defaultImplementationReviewReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+declare function _defaultBranchFreshnessReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+declare function _defaultTraceValidationReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+declare function _defaultMergeApprovalReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
 export declare const _internals: {
     readFileSync: typeof readFileSync;
     writeFileSync: typeof writeFileSync;
@@ -31,6 +34,9 @@ export declare const _internals: {
     publicationReceiptExists: typeof _defaultPublicationReceiptExists;
     recurrenceSweepReceiptExists: typeof _defaultRecurrenceSweepReceiptExists;
     implementationReviewReceiptExists: typeof _defaultImplementationReviewReceiptExists;
+    branchFreshnessReceiptExists: typeof _defaultBranchFreshnessReceiptExists;
+    traceValidationReceiptExists: typeof _defaultTraceValidationReceiptExists;
+    mergeApprovalReceiptExists: typeof _defaultMergeApprovalReceiptExists;
 };
 /**
  * Reads `.swarm/issue-reference.json` and returns the parsed object,
@@ -108,4 +114,27 @@ export declare function recurrenceSweepReceiptExists(directory: string, issueNum
  * contexts both recorded APPROVE verdicts for the implementation diff.
  */
 export declare function implementationReviewReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+/**
+ * Returns whether a Phase 0 branch-freshness receipt permits the trace for the
+ * given issue (issue #2564, mirroring trace-check.sh phase0): `synced` permits;
+ * `behind:<n>` never permits; `fetch-failed:<reason>` permits only with a
+ * recorded non-empty user override.
+ */
+export declare function branchFreshnessReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+/**
+ * Returns whether the per-phase trace-check.sh validator receipts for the given
+ * issue are green (issue #2564): at least one recorded validation exists and
+ * every entry (one per phase, upserted by the writer) is a `pass` bound to a
+ * 40-hex reviewedCommit + treeId. Any `fail` entry fails closed until that
+ * phase is re-recorded as a pass.
+ */
+export declare function traceValidationReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+/**
+ * Returns whether a PR-head-bound merge-approval receipt exists for the given
+ * issue (issue #2564): both SHAs are 40-hex and prHeadSha equals
+ * finalCriticReviewedCommit, mirroring trace-check.sh merge_check's binding.
+ * Presence-and-binding only — the approval itself is human-enforced and is
+ * never certified by the plugin.
+ */
+export declare function mergeApprovalReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
 export {};

package/dist/hooks/issue-trace.d.ts

@@ -18,7 +18,7 @@
 import { getPlanLedgerStateReadOnly } from '../plan/ledger-sqlite';
 import { error as _logErrorImpl } from '../utils/logger.js';
 import { isPlanCriticApproved } from './delegation-gate';
-import { implementationReviewReceiptExists, publicationReceiptExists, readIssueReference, readPlanPhaseStatus, readSpecIssueNumber, readTraceState, recurrenceSweepReceiptExists, reproductionReceiptExists, specExists, writeTraceState } from './issue-trace-state';
+import { branchFreshnessReceiptExists, implementationReviewReceiptExists, mergeApprovalReceiptExists, publicationReceiptExists, readIssueReference, readPlanPhaseStatus, readSpecIssueNumber, readTraceState, recurrenceSweepReceiptExists, reproductionReceiptExists, specExists, traceValidationReceiptExists, writeTraceState } from './issue-trace-state';
 export declare const _internals: {
     readIssueReference: typeof readIssueReference;
     readTraceState: typeof readTraceState;
@@ -30,6 +30,9 @@ export declare const _internals: {
     publicationReceiptExists: typeof publicationReceiptExists;
     recurrenceSweepReceiptExists: typeof recurrenceSweepReceiptExists;
     implementationReviewReceiptExists: typeof implementationReviewReceiptExists;
+    branchFreshnessReceiptExists: typeof branchFreshnessReceiptExists;
+    traceValidationReceiptExists: typeof traceValidationReceiptExists;
+    mergeApprovalReceiptExists: typeof mergeApprovalReceiptExists;
     isPlanCriticApproved: typeof isPlanCriticApproved;
     getPlanLedgerState: typeof getPlanLedgerStateReadOnly;
     logError: typeof _logErrorImpl;