@jmanuelcorral/openteam 0.17.5 → 0.18.0

package/dist/opencodeArtifacts/orchestratorAgent.d.ts

@@ -1,4 +1,4 @@
-import type { FrontierChoice } from "../commands/setup";
+import type { ModelRef } from "../config/schema";
 /**
  * Relative path (from cwd) to the primary agent that `openteam setup` generates. The
  * filename (`openteam`) is the agent name in opencode.
@@ -18,12 +18,17 @@ export declare const OPENTEAM_ROSTER_PATH = ".opencode/openteam/roster.md";
  * casts the team, and creates subagents on demand (including the standard roles
  * scribe, ralph and guardian). Pure: no I/O.
  *
- * `frontier` sets the orchestrator's `model` (baseline cheapest-capable), a
- * real and resolvable `provider/model`; the openteam plugin continues routing per
- * message, so subagents it creates can inherit the default and be
- * routed local-first.
+ * `model` sets the orchestrator's `model:` frontmatter field to an **already
+ * resolved**, real and resolvable `provider/model`. This value is load-bearing —
+ * opencode resolves the primary agent against it directly — so the caller is
+ * responsible for choosing a reference whose provider it actually configured:
+ * the cheapest-capable frontier baseline in normal mode, or the local runtime's
+ * thinking model in local-only mode. Never pass the inert `baseline.hardDefault`
+ * placeholder here; that value is only correct as a baseline, not as an agent
+ * `model:`. The openteam plugin still routes per message, so subagents this one
+ * creates can inherit the default and be routed local-first.
  */
-export declare function buildOrchestratorAgent(frontier: FrontierChoice, options?: {
+export declare function buildOrchestratorAgent(model: ModelRef, options?: {
     yolo?: boolean;
 }): string;
 //# sourceMappingURL=orchestratorAgent.d.ts.map

package/dist/opencodeArtifacts/orchestratorAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestratorAgent.d.ts","sourceRoot":"","sources":["../../src/opencodeArtifacts/orchestratorAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAInE;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,MAAM,CAwRR"}
+{"version":3,"file":"orchestratorAgent.d.ts","sourceRoot":"","sources":["../../src/opencodeArtifacts/orchestratorAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAInE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,EACf,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,MAAM,CAmTR"}

package/dist/orchestrator/coordinator.d.ts

@@ -106,6 +106,25 @@ export type CoordinatorDeps = {
      * the exact pre-#217 single-pool behaviour when it is absent.
      */
     reportedModelSlots?: (runtimeId: LocalRuntimeId) => Readonly<Record<string, number>> | undefined;
+    /**
+     * Report reader for the per-node done-signal (unify dispatch paths). Injected
+     * I/O port — reading the report file is filesystem access, so it lives at the
+     * composition root, not here. Given a resolved report path it returns the
+     * file's text, or `undefined` on any error (missing/unreadable). The
+     * coordinator parses only a bounded status token from the text
+     * (`parseReportStatus`); the report BODY never crosses `assertReferenceOnly`.
+     *
+     * REQUIRED, not optional. Iteration is governed by the configured bound
+     * (`orchestrator.maxRetries`), NOT by whether this port happens to be wired:
+     * `maxRetries: 0` means one pass, any higher value re-dispatches a node until
+     * it declares `openteam-status: done` or its pass budget is exhausted. Making
+     * the port required means dropping the forwarding from the plugin boundary to
+     * the coordinator is a COMPILE error, not a silent regression to never-iterate
+     * — mirroring the same guarantee `reportArtifactExists` already has. The port
+     * is read only when the budget permits a re-dispatch, so a single-pass node
+     * never calls it.
+     */
+    readReportArtifact: (reportPath: string) => Promise<string | undefined>;
 };
 export type CorrelatedCostRecord = CostRecord & {
     decisionID: string;
@@ -120,6 +139,13 @@ export type RoleTaskResult = {
     decision: RoutingDecision;
     subsession: SubsessionResult;
     record: CorrelatedCostRecord;
+    /**
+     * Reference-only path the role was instructed to write its findings to
+     * (`composeSubsessionPrompt`). A plain string path — never content — so it
+     * survives `assertReferenceOnly` when projected to the coordinator. The
+     * coordinator reads this file to synthesise the actual findings for the user.
+     */
+    reportPath: string;
 };
 /**
  * Emits an observable warning the first time an unknown worker roleID is

package/dist/orchestrator/coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/coordinator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/coordinator.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/nodeIteration.d.ts

@@ -0,0 +1,36 @@
+/**
+ * **Per-node iteration primitives** — the pure, deterministic helpers that bound
+ * how many times an orchestrated graph node may run before it must declare
+ * itself done.
+ *
+ * ## Why this exists (unify the two dispatch paths)
+ * openteam used to have two dispatch paths: `openteam-orchestrate` ran each
+ * graph node exactly once, while a separate `runRalphLoop` engine implemented
+ * iterate-until-done for a single hardcoded `ralph` role on its own entry point.
+ * Iteration is now a property of the graph itself: every node runs through the
+ * one orchestrate path and keeps working until it declares completion (via the
+ * output contract's status token) or this bound is hit. These helpers carry the
+ * arithmetic so the bound's meaning is unambiguous to a reader and testable in
+ * isolation.
+ *
+ * Pure: no I/O, clock, randomness, or env access. The retry budget is derived
+ * from injected config, never read from the environment here.
+ */
+/**
+ * Default number of RETRIES per node when the orchestrator config does not pin
+ * one. A retry is an ADDITIONAL pass after the initial attempt, so the default
+ * of 2 means **three total passes** per node (one initial + two retries). Kept
+ * as the single source of truth for both the config schema default and the
+ * runtime fallback so the two can never drift.
+ */
+export declare const DEFAULT_MAX_RETRIES = 2;
+/**
+ * Total passes a node may run, from its retry budget. Pure.
+ *
+ * `maxRetries` counts RETRIES (additional passes after the first), so the pass
+ * budget is `1 + maxRetries`: `maxRetries = 2` → 3 passes, `maxRetries = 0` → a
+ * single pass (iteration effectively disabled). When `maxRetries` is undefined
+ * (no orchestrator config), {@link DEFAULT_MAX_RETRIES} applies.
+ */
+export declare function nodePassBudget(maxRetries: number | undefined): number;
+//# sourceMappingURL=nodeIteration.d.ts.map

package/dist/orchestrator/nodeIteration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeIteration.d.ts","sourceRoot":"","sources":["../../src/orchestrator/nodeIteration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAErE"}

package/dist/orchestrator/outputContract.d.ts

@@ -0,0 +1,91 @@
+/**
+ * **Subsession output contract** — the deterministic instruction appended to
+ * every orchestrated role's prompt, plus the reference-only report path that
+ * carries a role's findings back to the coordinator.
+ *
+ * ## Why this exists (GE — orchestrate findings are discarded)
+ * `openteam-orchestrate` spawns a real subsession, the role does real work, and
+ * the subsession succeeds — but the coordinator only ever receives a
+ * reference-only `RoleResultSummary` (roleID, model, success, sessionID). The
+ * role's actual output never leaves its session, so a coordinator with nothing
+ * to report was observed inventing an `in_progress` narrative for work that had
+ * already finished. This module closes that gap **without** weakening the
+ * privacy boundary: the role is told to persist its findings to a file, and the
+ * coordinator is handed the file **path** — a reference, never content. The
+ * path passes `assertReferenceOnly` because it is a plain string on a
+ * non-forbidden key.
+ *
+ * Pure: no I/O, clock, randomness, or env access. The batch identifier is
+ * injected by the caller (`runRoleTasks` derives it from `deps.newDecisionID`),
+ * never generated here, so composition stays deterministic and unit-testable.
+ */
+/**
+ * Machine-local root (repo-relative) for per-batch role report artifacts.
+ *
+ * Lives under `.opencode/openteam-local/` — the P15b machine-local, git-ignored
+ * side of the portability boundary — **by deliberate decision**, not accident.
+ * A role report is per-run runtime output (keyed by an ephemeral batch id), not
+ * portable team-state, so it belongs where telemetry and session logs live.
+ * `.opencode/.gitignore`'s `openteam-local/` rule ignores this whole directory,
+ * so reports never appear in `git status` and never get committed; the user can
+ * still open them locally. Placing them under the tracked `.opencode/openteam/`
+ * directory instead would leak an unbounded stream of per-batch files into the
+ * repository.
+ */
+export declare const ROLE_REPORTS_ROOT = ".opencode/openteam-local/reports";
+/**
+ * Bounded completion status a role declares in its report artifact, parsed by
+ * code from a fixed vocabulary. This — not a free-text `DONE` substring match —
+ * is the done-signal that ends per-node iteration. `"unknown"` covers an absent
+ * or unparseable declaration and is deliberately NOT `"done"`: a node that
+ * cannot prove completion must be assumed to have more work, never assumed
+ * finished.
+ *
+ * Only this small enum ever influences control flow. The report BODY is never
+ * carried across the `assertReferenceOnly` boundary — reading a bounded status
+ * token from a file is not a content leak.
+ */
+export type ReportStatus = "done" | "continue" | "unknown";
+/**
+ * The exact marker a role writes to declare its status, e.g.
+ * `openteam-status: done`. A specific, unambiguous token (unlike a bare `DONE`
+ * substring, which matched incidental prose such as "not done yet") so the
+ * parse is deterministic and cannot be tripped by ordinary report content.
+ */
+export declare const REPORT_STATUS_MARKER = "openteam-status";
+/**
+ * Parses the bounded completion status from a role's report text. Pure.
+ *
+ * The LAST declaration wins: a role updates its report across iterations, so its
+ * final `openteam-status:` line is authoritative. An absent, empty, or
+ * unrecognised declaration returns `"unknown"` — treated by the caller as
+ * not-done, never as done.
+ */
+export declare function parseReportStatus(text: string | undefined): ReportStatus;
+/**
+ * Deterministic, per-role report artifact path within a batch. Pure.
+ *
+ * Shape: `<ROLE_REPORTS_ROOT>/<batchID>/<roleID>.md`. Same inputs always
+ * produce the same path, so the coordinator can predict where each role writes.
+ */
+export declare function roleReportPath(batchID: string, roleID: string): string;
+/** Result of composing a role's base prompt with its output contract. */
+export type SubsessionPromptComposition = {
+    /** Base prompt with the standing output contract appended. */
+    readonly prompt: string;
+    /** Reference-only path the role is instructed to write its findings to. */
+    readonly reportPath: string;
+};
+/**
+ * Appends the standing output contract to a role's base prompt and returns the
+ * augmented prompt together with the report path the role is told to write.
+ *
+ * Pure and deterministic: `batchID` is injected by the caller, never generated
+ * here. Reference-only: it emits a file path, never content.
+ */
+export declare function composeSubsessionPrompt(input: {
+    readonly prompt: string;
+    readonly roleID: string;
+    readonly batchID: string;
+}): SubsessionPromptComposition;
+//# sourceMappingURL=outputContract.d.ts.map

package/dist/orchestrator/outputContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputContract.d.ts","sourceRoot":"","sources":["../../src/orchestrator/outputContract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAItD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAUxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,yEAAyE;AACzE,MAAM,MAAM,2BAA2B,GAAG;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAwCF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG,2BAA2B,CAM9B"}

package/dist/orchestrator/reportArtifactProbe.d.ts

@@ -0,0 +1,40 @@
+/**
+ * **Report artifact probe** — the concrete filesystem adapter behind the
+ * `ReportArtifactProbe` port consumed by the durability gate
+ * (`reportDurability.ts`).
+ *
+ * ## Why this is its own named, exported unit
+ * The durability gate is the entire point of the orchestrate durability work:
+ * it downgrades a subsession that reported success but wrote no usable report.
+ * That guarantee is only as strong as the real probe wired at the composition
+ * root. When the probe lived inline in `src/index.ts` it was never driven by
+ * any test — every test injects a fake port — so the adapter could be mutated
+ * to fail permanently open (`return true`: every role reported durable, no
+ * report ever required) and the whole suite stayed green. This is exactly the
+ * failure shape this repo has been bitten by before: a green suite over a
+ * composition root whose real adapter is never exercised.
+ *
+ * Extracting it here makes it a separately-testable unit driven against the
+ * REAL filesystem (a genuinely missing path, an empty file, a non-empty file,
+ * and a directory), so breaking its predicate now fails a named test. Testing
+ * it against a mocked `fs` would recreate the same hole one layer up, so the
+ * unit calls `node:fs/promises` directly rather than injecting `stat`.
+ *
+ * ## Fail-safe
+ * The probe never throws: any error (a missing path raises `ENOENT`, a
+ * permission error, etc.) resolves to `false`. Durability is only ever asserted
+ * on positive evidence — a file that exists AND is non-empty. It is handed a
+ * path and returns a boolean; no content ever crosses the `assertReferenceOnly`
+ * privacy boundary.
+ */
+import type { ReportArtifactProbe } from "./reportDurability";
+/**
+ * Real filesystem implementation of {@link ReportArtifactProbe}. Resolves
+ * `true` iff `reportPath` names a regular file that exists AND is non-empty;
+ * resolves `false` otherwise, including for a missing path, an empty file, a
+ * directory (`isFile()` is what excludes it), or any thrown filesystem error.
+ * Wired at the composition root (`src/index.ts`); every other layer consumes
+ * the injected port.
+ */
+export declare const reportArtifactExists: ReportArtifactProbe;
+//# sourceMappingURL=reportArtifactProbe.d.ts.map

package/dist/orchestrator/reportArtifactProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportArtifactProbe.d.ts","sourceRoot":"","sources":["../../src/orchestrator/reportArtifactProbe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBAOlC,CAAC"}

package/dist/orchestrator/reportArtifactReader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * **Report artifact reader** — the concrete filesystem adapter behind the report
+ * READER port consumed by per-node iterate-until-done in the coordinator
+ * (`coordinator.ts`) and injected as `readReportArtifact` on `OrchestrateDeps`.
+ *
+ * ## Why this is its own named, exported unit
+ * The done-signal that ends per-node iteration is a bounded status token the
+ * role writes into its report artifact; the coordinator must READ that file to
+ * parse the token. Reading a file is I/O, so it cannot live in the pure
+ * `router/` or coordinator logic — it is an injected port. Extracting the real
+ * adapter here (rather than inlining it at the composition root) keeps
+ * `src/index.ts` as wiring and makes the adapter a separately-testable unit
+ * driven against the REAL filesystem. That matters for the same reason the
+ * existence probe (`reportArtifactProbe.ts`) was extracted: an adapter that no
+ * test drives can be mutated to misbehave while the suite stays green. Testing
+ * it against a mocked `fs` would recreate that hole one layer up, so the unit
+ * calls `node:fs/promises` directly.
+ *
+ * ## Fail-safe
+ * The reader never throws: any error (a missing path raises `ENOENT`, a
+ * permission error, a path that is a directory, etc.) resolves to `undefined`.
+ * `undefined` is treated by the caller as "no proof of completion", so a node
+ * whose report cannot be read is retried rather than assumed done — the failure
+ * mode is safe. It returns the file text so the caller can parse a bounded
+ * status token from it; the report BODY is reduced to a small enum before it can
+ * influence control flow and never crosses the `assertReferenceOnly` boundary.
+ */
+/**
+ * Real filesystem implementation of the report reader port. Resolves the UTF-8
+ * text of the file at `reportPath`, or `undefined` on any error (a missing
+ * path, a directory, a permission error, or any thrown filesystem error).
+ * Wired at the composition root (`src/index.ts`); every other layer consumes the
+ * injected port.
+ */
+export declare const readReportArtifact: (reportPath: string) => Promise<string | undefined>;
+//# sourceMappingURL=reportArtifactReader.d.ts.map

package/dist/orchestrator/reportArtifactReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportArtifactReader.d.ts","sourceRoot":"","sources":["../../src/orchestrator/reportArtifactReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,eACjB,MAAM,KACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAM5B,CAAC"}

package/dist/orchestrator/reportDurability.d.ts

@@ -0,0 +1,70 @@
+/**
+ * **Report durability gate** — the deterministic, code-enforced check that a
+ * dispatched role actually persisted its findings, downgrading a subsession
+ * that reported success but wrote no usable report to a bounded failure.
+ *
+ * ## Why this exists (GE — orchestrate findings are discarded)
+ * The output contract (`outputContract.ts`) *instructs* each role to write its
+ * findings to a report file, but an instruction in a prompt is a request, not a
+ * guarantee: a model can ignore it and still return `success: true`. That
+ * silently re-opens the exact defect — work discarded, reported as success. A
+ * prompt cannot fix a prompt; only code can. This module verifies durability in
+ * code via an injected filesystem probe.
+ *
+ * ## Reusable across every dispatch pass — by deliberate decision
+ * Iteration is now a property of the orchestration graph: every graph node runs
+ * through the single `openteam-orchestrate` path and may be dispatched several
+ * times until it declares itself done or its retry bound is hit (see
+ * `nodeIteration.ts`). The gate lives HERE, in the orchestrator layer, as a
+ * small separately-testable unit — NOT welded into the `openteam-orchestrate`
+ * tool handler — so every dispatch pass consumes it and none can silently
+ * discard work. (The former standalone Ralph loop entry points — the `openteam
+ * loop` CLI command and the `openteam-loop` tool — were retired when the two
+ * dispatch paths were unified.)
+ *
+ * ## Purity / boundaries
+ * The gate does no I/O itself: the filesystem existence probe is an injected
+ * port (`ReportArtifactProbe`), exactly like every other I/O boundary in this
+ * codebase. It is handed a path and returns a boolean — no content ever crosses
+ * the `assertReferenceOnly` privacy boundary. Path resolution
+ * (`resolveReportProbePath`) is a pure string join.
+ */
+import type { RoleTaskResult } from "./coordinator";
+/**
+ * Bounded, content-free failure reason recorded when a role's subsession
+ * reported success but the promised report artifact was not durably written
+ * (absent or empty). A fixed machine-readable literal — never free text, never
+ * content — so any consumer can branch on it deterministically.
+ */
+export declare const REPORT_NOT_DURABLE_REASON = "report-missing-or-empty";
+/**
+ * Injected durability probe. Resolves `true` iff `reportPath` names a file that
+ * exists AND is non-empty, and `false` otherwise (including any error). The
+ * concrete adapter lives at the composition root (`stat` → `isFile() && size >
+ * 0`); the gate only consumes this port. Reference-only: it is handed a path
+ * and returns a boolean, never content.
+ */
+export type ReportArtifactProbe = (reportPath: string) => Promise<boolean>;
+/**
+ * Resolves the on-disk path to probe for a role's report. The report path is
+ * relative to the working directory the subsession ran under; when a dispatch
+ * supplies a `directory` override, the probe must look there, not at the
+ * process cwd. Pure string join — no I/O — so it is shared by every dispatch
+ * path instead of each re-deriving (and subtly diverging on) the join.
+ */
+export declare function resolveReportProbePath(baseDirectory: string | undefined, reportPath: string): string;
+/**
+ * Deterministic durability gate, reusable by ANY dispatch path. For every role
+ * whose subsession reported success, it verifies IN CODE — via the injected
+ * `probe` — that the promised report artifact exists and is non-empty. A
+ * success with no usable report is downgraded to a bounded failure
+ * (`success: false`, `failureStage: "report"`,
+ * `failureReason: REPORT_NOT_DURABLE_REASON`) so discarded work can never be
+ * surfaced to a coordinator as a plain success. Failed subsessions are passed
+ * through untouched (there is nothing to preserve).
+ *
+ * Reference-only: the probe is handed a path and returns a boolean; no content
+ * crosses the `assertReferenceOnly` boundary.
+ */
+export declare function applyReportDurabilityGate(results: readonly RoleTaskResult[], probe: ReportArtifactProbe): Promise<RoleTaskResult[]>;
+//# sourceMappingURL=reportDurability.d.ts.map

package/dist/orchestrator/reportDurability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportDurability.d.ts","sourceRoot":"","sources":["../../src/orchestrator/reportDurability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB3B"}

package/dist/orchestrator/subsessions.d.ts

@@ -53,7 +53,7 @@ export type SubsessionResult = {
     model: ModelSelection;
     response?: unknown;
     failureReason?: string;
-    failureStage?: "create" | "prompt";
+    failureStage?: "create" | "prompt" | "report";
 };
 export type SubsessionDeps = {
     timeoutMs?: number;

package/dist/orchestrator/subsessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subsessions.d.ts","sourceRoot":"","sources":["../../src/orchestrator/subsessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE;QACP,MAAM,EAAE,CACN,IAAI,EAAE,yBAAyB,KAC5B,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACzD,MAAM,EAAE,CACN,IAAI,EAAE,yBAAyB,KAC5B,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KACnD,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAiQF,wBAAsB,aAAa,CACjC,MAAM,EAAE,qBAAqB,EAC7B,GAAG,EAAE,iBAAiB,EACtB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAuE3B"}
+{"version":3,"file":"subsessions.d.ts","sourceRoot":"","sources":["../../src/orchestrator/subsessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE;QACP,MAAM,EAAE,CACN,IAAI,EAAE,yBAAyB,KAC5B,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACzD,MAAM,EAAE,CACN,IAAI,EAAE,yBAAyB,KAC5B,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KACnD,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAiQF,wBAAsB,aAAa,CACjC,MAAM,EAAE,qBAAqB,EAC7B,GAAG,EAAE,iBAAiB,EACtB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAuE3B"}

package/dist/plugin/orchestrateTool.d.ts

@@ -5,6 +5,7 @@ import type { GraphEventV1, GraphSpecV1 } from "../graph/schema";
 import type { RuntimeConcurrencyLimiter } from "../local/concurrency";
 import type { LocalRuntimeId } from "../local/types";
 import { type CoordinatorDeps, type RoleTaskResult } from "../orchestrator/coordinator";
+import { type ReportArtifactProbe } from "../orchestrator/reportDurability";
 import type { OpencodeSessionClient } from "../orchestrator/subsessions";
 import type { GraphJournal } from "../storage/graph/provider";
 import type { EventSink } from "../telemetry/eventLog";
@@ -52,7 +53,14 @@ export type RoleResultSummary = {
     };
     success: boolean;
     sessionID?: string;
-    failureStage?: "create" | "prompt";
+    /**
+     * Reference-only path the role was instructed to write its findings to. A
+     * plain string path (never content), so it survives `assertReferenceOnly`.
+     * The coordinator READS this file to synthesise the actual findings; the
+     * `reportPath` key is intentionally NOT in `FORBIDDEN_RAW_KEYS`.
+     */
+    reportPath?: string;
+    failureStage?: "create" | "prompt" | "report";
     failureReason?: string;
 };
 export type OrchestrateResult = {
@@ -196,6 +204,38 @@ export type OrchestrateDeps = {
      * must never throw.
      */
     readonly rosterRoleIDs: () => Promise<ReadonlySet<string>>;
+    /**
+     * Durability probe (#report-durability). A REQUIRED injected I/O port that
+     * answers, in code, whether a role's promised report artifact was actually
+     * written: it resolves `true` iff the given path names a file that exists AND
+     * is non-empty, and `false` otherwise (including any error). The tool applies
+     * it as a deterministic gate after each subsession finishes so a role that
+     * succeeded but wrote no findings is downgraded to a bounded failure instead
+     * of being reported to the coordinator as a plain success — closing the
+     * "work silently discarded" hole a prompt instruction alone cannot. Reference
+     * only: it is handed a path and returns a boolean; it never reads content
+     * across the `assertReferenceOnly` boundary. Required (not optional) so that
+     * dropping the composition-root wiring is a compile error rather than a silent
+     * fail-open that would re-open the exact defect this gate exists to close. The
+     * adapter MUST be fail-safe: on a missing/unreadable path it returns `false`
+     * and must never throw. Typed as the shared `ReportArtifactProbe` so the gate
+     * unit and every dispatch path that reuses it agree on one port shape.
+     */
+    readonly reportArtifactExists: ReportArtifactProbe;
+    /**
+     * Report READER for the per-node iterate-until-done done-signal (unify
+     * dispatch paths). Given a resolved report path it resolves the file's text,
+     * or `undefined` on any error (missing/unreadable). The coordinator reduces
+     * that text to a bounded status token (`parseReportStatus`) to decide whether
+     * a node has declared itself done; the report BODY never crosses the
+     * `assertReferenceOnly` boundary — this port returns text that is collapsed to
+     * a small enum before it can influence control flow. Required (not optional),
+     * mirroring `reportArtifactExists`, so dropping the composition-root wiring is
+     * a compile error rather than a silent regression to never-iterate. The
+     * adapter MUST be fail-safe: on a missing/unreadable path it returns
+     * `undefined` and must never throw.
+     */
+    readonly readReportArtifact: (reportPath: string) => Promise<string | undefined>;
 };
 /**
  * Builds a `GraphSpecV1` from orchestrate payload assignments. Each assignment

package/dist/plugin/orchestrateTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrateTool.d.ts","sourceRoot":"","sources":["../../src/plugin/orchestrateTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrateTool.d.ts","sourceRoot":"","sources":["../../src/plugin/orchestrateTool.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmanuelcorral/openteam",
-  "version": "0.17.5",
+  "version": "0.18.0",
   "packageManager": "bun@1.3.14",
   "description": "Cost-aware, local-first routing plugin for opencode with cheapest-capable frontier fallback and multi-agent orchestration.",
   "license": "MIT",

package/dist/orchestrator/ralphLoop.d.ts

@@ -1,57 +0,0 @@
-import type { OpenTeamConfig } from "../config/schema";
-import type { RoutingDecision, TaskSignals } from "../router/types";
-import { type CoordinatorDeps, type RoleTaskResult } from "./coordinator";
-/**
- * W3 ralph loop (#174).
- *
- * Makes the guaranteed `ralph` role a real behaviour rather than an unreachable
- * profile: a bounded iterate-until-done cycle. Each pass dispatches the `ralph`
- * role through the real coordinator ({@link runRoleTask}), so the loop inherits
- * two guarantees for free — the mandatory-local gate (#143), which refuses to run
- * BEFORE the first iteration when no local runtime is reachable and never falls
- * through to a frontier provider, and local-first routing, which keeps every
- * iteration on a local runtime.
- *
- * This module is only loop CONTROL: model/runtime work is the injected coordinator
- * deps, and the done-signal is an injected predicate. Deterministic given its
- * ports — no clock, randomness or direct I/O.
- */
-/** Canonical roleID of the guaranteed ralph role. */
-export declare const RALPH_ROLE_ID = "ralph";
-/** Default iteration cap so the loop can never spin unbounded. */
-export declare const DEFAULT_RALPH_MAX_ITERATIONS = 10;
-export type RalphLoopInput = {
-    readonly task: TaskSignals;
-    readonly prompt: string;
-    readonly config: OpenTeamConfig;
-    readonly parentSessionID?: string;
-    /** Iteration cap; defaults to {@link DEFAULT_RALPH_MAX_ITERATIONS}. */
-    readonly maxIterations?: number;
-};
-/** Why the loop stopped: the done-signal fired, or the iteration cap was hit. */
-export type RalphLoopTermination = "done" | "cap";
-export type RalphLoopResult = {
-    readonly iterations: number;
-    readonly termination: RalphLoopTermination;
-    readonly decision: RoutingDecision | undefined;
-    readonly results: readonly RoleTaskResult[];
-};
-export type RalphLoopDeps = CoordinatorDeps & {
-    /**
-     * The done-signal predicate (#174). Reads the iteration's subsession result and
-     * decides whether the task is finished. Injected so the "fake runtime" that
-     * reports done/not-done stays outside the loop control under test.
-     */
-    readonly isDone: (result: RoleTaskResult) => boolean;
-};
-/**
- * Runs the ralph loop (#174): dispatches the `ralph` role repeatedly until the
- * injected done-signal fires or the iteration cap is reached.
- *
- * On the first pass, {@link runRoleTask} enforces the mandatory-local gate: when
- * no local runtime is reachable it throws before any dispatch, so the loop fails
- * before the first iteration and no model is contacted — the caller sees the
- * thrown, actionable error.
- */
-export declare function runRalphLoop(input: RalphLoopInput, deps: RalphLoopDeps): Promise<RalphLoopResult>;
-//# sourceMappingURL=ralphLoop.d.ts.map

package/dist/orchestrator/ralphLoop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ralphLoop.d.ts","sourceRoot":"","sources":["../../src/orchestrator/ralphLoop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;GAcG;AAEH,qDAAqD;AACrD,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,kEAAkE;AAClE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,KAAK,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC;CACtD,CAAC;AAeF;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,eAAe,CAAC,CA+B1B"}