@pellux/goodvibes-sdk 0.38.0 → 1.1.0

package/dist/platform/runtime/daemon-version-compat.js

@@ -0,0 +1,75 @@
+/**
+ * daemon-version-compat.ts
+ *
+ * The adopt-or-start path (bootstrap-services.ts) verifies that a daemon found
+ * on the configured port is a GoodVibes daemon via its `/status` identity probe,
+ * which reports the daemon's SDK `version`. Verifying identity is NOT the same as
+ * verifying that the daemon speaks the SAME wire shape this surface expects:
+ * adopting a daemon built from an incompatible SDK band produces silent
+ * wire-shape failures (a session method the surface calls that the daemon does
+ * not serve, a payload field that moved). This module answers the one question
+ * the probe leaves open — "may this surface safely adopt a daemon reporting
+ * version X?" — so the adopt path can refuse an incompatible occupant honestly
+ * instead of adopting it and failing later, and without ever starting a second
+ * competing daemon on an occupied port.
+ *
+ * Compatibility band policy (semver, https://semver.org/#spec-item-4):
+ *   - `0.y.z` releases treat the MINOR position as the breaking axis, so two
+ *     `0.y` versions are compatible only when `y` matches (0.38.x adopts 0.38.*
+ *     but not 0.37.*).
+ *   - `>=1.0.0` releases treat MAJOR as the breaking axis, so major must match
+ *     (1.4.x adopts any 1.*.* but not 2.*.*).
+ *   - A version string that cannot be parsed is treated as INCOMPATIBLE — the
+ *     conservative, honest default. An empty/absent remote version is likewise
+ *     incompatible: the surface must not adopt something it cannot band-check.
+ * Prerelease and build metadata (`-rc.1`, `+sha`) are ignored for banding.
+ */
+/**
+ * Parse the leading `major.minor` of a semver string, ignoring patch,
+ * prerelease, and build metadata. Returns null when the leading two numeric
+ * positions cannot be read.
+ */
+function parseVersionBand(version) {
+    if (typeof version !== 'string')
+        return null;
+    const trimmed = version.trim();
+    if (!trimmed)
+        return null;
+    // Strip a leading `v`, then take the core before any `-` (prerelease) or `+` (build).
+    const core = trimmed.replace(/^v/i, '').split(/[-+]/, 1)[0] ?? '';
+    const parts = core.split('.');
+    if (parts.length < 2)
+        return null;
+    const major = Number(parts[0]);
+    const minor = Number(parts[1]);
+    if (!Number.isInteger(major) || !Number.isInteger(minor) || major < 0 || minor < 0)
+        return null;
+    return { major, minor };
+}
+/**
+ * True when a surface reporting `localVersion` may safely adopt a daemon
+ * reporting `remoteVersion` — see the band policy in the file header.
+ * Unparseable or absent versions are never compatible.
+ */
+export function isDaemonVersionCompatible(localVersion, remoteVersion) {
+    const local = parseVersionBand(localVersion);
+    const remote = parseVersionBand(remoteVersion);
+    if (local === null || remote === null)
+        return false;
+    if (local.major !== remote.major)
+        return false;
+    // For the 0.y band the minor position is the breaking axis; for >=1 it is not.
+    if (local.major === 0)
+        return local.minor === remote.minor;
+    return true;
+}
+/**
+ * Human-readable reason string for an incompatible adoption refusal, naming
+ * both the occupied endpoint's version and this surface's version so the
+ * operator can see the skew without guessing.
+ */
+export function describeVersionIncompatibility(host, port, localVersion, remoteVersion) {
+    const found = (typeof remoteVersion === 'string' && remoteVersion.trim()) ? remoteVersion.trim() : 'unknown';
+    const mine = (typeof localVersion === 'string' && localVersion.trim()) ? localVersion.trim() : 'unknown';
+    return `A GoodVibes daemon (version ${found}) is running on ${host}:${port}, but this surface (version ${mine}) speaks an incompatible wire version — not adopting, and not starting a second daemon on the occupied port.`;
+}

package/dist/platform/runtime/detached-daemon-runtime.d.ts

@@ -0,0 +1,26 @@
+/**
+ * D7a Layer 2 — pid/port discovery for the detached daemon.
+ *
+ * When a surface spawns the daemon as a detached, standalone process, it records
+ * the pid/host/port to a small JSON file under the daemon home so a later surface
+ * (or a `GET /api/service/status` call against the daemon HTTP API) can discover and adopt it without a fresh
+ * spawn. This is deliberately a plain record — not a lock — since the daemon's own
+ * identity probe is the source of truth for "is it actually alive and mine".
+ */
+/** File name of the detached-daemon runtime record within the daemon home dir. */
+export declare const DETACHED_DAEMON_RUNTIME_FILE = "detached-daemon.json";
+export interface DetachedDaemonRuntimeRecord {
+    readonly pid: number | undefined;
+    readonly host: string;
+    readonly port: number;
+    readonly command: string;
+    readonly startedAt: string;
+    readonly logFilePath?: string | undefined;
+}
+/** Absolute path of the runtime record file for a given daemon runtime dir. */
+export declare function detachedDaemonRuntimePath(runtimeDir: string): string;
+/** Write (or overwrite) the detached-daemon runtime record. Best-effort; never throws. */
+export declare function recordDetachedDaemonRuntime(runtimeDir: string, record: DetachedDaemonRuntimeRecord): string | null;
+/** Read the detached-daemon runtime record, or null if missing/unparseable. */
+export declare function readDetachedDaemonRuntime(runtimeDir: string): DetachedDaemonRuntimeRecord | null;
+//# sourceMappingURL=detached-daemon-runtime.d.ts.map

package/dist/platform/runtime/detached-daemon-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detached-daemon-runtime.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/detached-daemon-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,yBAAyB,CAAC;AAEnE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,0FAA0F;AAC1F,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,2BAA2B,GAClC,MAAM,GAAG,IAAI,CASf;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI,CAgBhG"}

package/dist/platform/runtime/detached-daemon-runtime.js

@@ -0,0 +1,49 @@
+/**
+ * D7a Layer 2 — pid/port discovery for the detached daemon.
+ *
+ * When a surface spawns the daemon as a detached, standalone process, it records
+ * the pid/host/port to a small JSON file under the daemon home so a later surface
+ * (or a `GET /api/service/status` call against the daemon HTTP API) can discover and adopt it without a fresh
+ * spawn. This is deliberately a plain record — not a lock — since the daemon's own
+ * identity probe is the source of truth for "is it actually alive and mine".
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** File name of the detached-daemon runtime record within the daemon home dir. */
+export const DETACHED_DAEMON_RUNTIME_FILE = 'detached-daemon.json';
+/** Absolute path of the runtime record file for a given daemon runtime dir. */
+export function detachedDaemonRuntimePath(runtimeDir) {
+    return join(runtimeDir, DETACHED_DAEMON_RUNTIME_FILE);
+}
+/** Write (or overwrite) the detached-daemon runtime record. Best-effort; never throws. */
+export function recordDetachedDaemonRuntime(runtimeDir, record) {
+    const path = detachedDaemonRuntimePath(runtimeDir);
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(record, null, 2)}\n`, 'utf-8');
+        return path;
+    }
+    catch {
+        return null;
+    }
+}
+/** Read the detached-daemon runtime record, or null if missing/unparseable. */
+export function readDetachedDaemonRuntime(runtimeDir) {
+    try {
+        const raw = readFileSync(detachedDaemonRuntimePath(runtimeDir), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.port !== 'number' || typeof parsed.host !== 'string')
+            return null;
+        return {
+            pid: typeof parsed.pid === 'number' ? parsed.pid : undefined,
+            host: parsed.host,
+            port: parsed.port,
+            command: typeof parsed.command === 'string' ? parsed.command : '',
+            startedAt: typeof parsed.startedAt === 'string' ? parsed.startedAt : '',
+            logFilePath: typeof parsed.logFilePath === 'string' ? parsed.logFilePath : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}

package/dist/platform/runtime/emitters/workflows.d.ts

@@ -36,7 +36,7 @@ export declare function emitWorkflowChainPassed(bus: RuntimeEventBus, ctx: Emitt
 export declare function emitWorkflowChainFailed(bus: RuntimeEventBus, ctx: EmitterContext, data: {
     chainId: string;
     reason: string;
-    failureKind?: 'transport' | 'other' | undefined;
+    failureKind?: 'transport' | 'other' | 'cancelled' | undefined;
 }): void;
 export declare function emitWorkflowAutoCommitted(bus: RuntimeEventBus, ctx: EmitterContext, data: {
     chainId: string;

package/dist/platform/runtime/emitters/workflows.d.ts.map

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

package/dist/platform/runtime/events/index.d.ts

@@ -69,6 +69,19 @@ export interface RuntimeEventBusOptions {
  * sessionId, timestamps, and source context.
  *
  * This is the authoritative event transport for runtime domain signaling.
+ *
+ * DISPATCH ORDERING GUARANTEE (contract — pinned by
+ * test/runtime-event-bus-dispatch-contract.test.ts): {@link emit} NEVER invokes
+ * a subscriber synchronously. Each matching handler is deferred to its own
+ * `queueMicrotask`, so emit() always returns to its caller — and the caller's
+ * remaining synchronous statements run — BEFORE any listener fires. A component
+ * may therefore emit an event from the MIDDLE of a state mutation without risk
+ * that a subscriber observes the half-applied state: by the time a listener
+ * runs, the mutating call has already completed and the state has settled. This
+ * asynchronous-dispatch ordering is load-bearing for event-ordering safety
+ * across the runtime (e.g. the orchestration zombie-reap path relies on
+ * listeners never seeing a mutation mid-flight) — do NOT replace queueMicrotask
+ * with synchronous invocation.
  */
 export declare class RuntimeEventBus {
     /** Per-event-type listener sets. Keyed by the exact event type string. */

package/dist/platform/runtime/events/index.d.ts.map

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

package/dist/platform/runtime/events/index.js

@@ -46,6 +46,19 @@ function extractErrorMessage(err) {
  * sessionId, timestamps, and source context.
  *
  * This is the authoritative event transport for runtime domain signaling.
+ *
+ * DISPATCH ORDERING GUARANTEE (contract — pinned by
+ * test/runtime-event-bus-dispatch-contract.test.ts): {@link emit} NEVER invokes
+ * a subscriber synchronously. Each matching handler is deferred to its own
+ * `queueMicrotask`, so emit() always returns to its caller — and the caller's
+ * remaining synchronous statements run — BEFORE any listener fires. A component
+ * may therefore emit an event from the MIDDLE of a state mutation without risk
+ * that a subscriber observes the half-applied state: by the time a listener
+ * runs, the mutating call has already completed and the state has settled. This
+ * asynchronous-dispatch ordering is load-bearing for event-ordering safety
+ * across the runtime (e.g. the orchestration zombie-reap path relies on
+ * listeners never seeing a mutation mid-flight) — do NOT replace queueMicrotask
+ * with synchronous invocation.
  */
 export class RuntimeEventBus {
     /** Per-event-type listener sets. Keyed by the exact event type string. */

package/dist/platform/runtime/feature-flags/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/feature-flags/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EA4dtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAE7D,CAAC"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/feature-flags/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EAogBtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAE7D,CAAC"}

package/dist/platform/runtime/feature-flags/flags.js

@@ -207,6 +207,26 @@ export const FEATURE_FLAGS = [
         tier: 9,
         runtimeToggleable: true,
     },
+    {
+        id: 'agent-passive-code-injection',
+        name: 'Agent Passive Code Injection',
+        description: 'Enables per-turn passive retrieval from the repo SOURCE-TREE CODE INDEX (CodeIndexStore) '
+            + 'alongside project-memory knowledge, sharing the SAME token budget and relevance floor. '
+            + 'When the query would benefit and the index is built, similarity-ranked code chunks are '
+            + 'injected as untrusted reference pointers, each recorded on the turn injection record with '
+            + 'source=code-index and its honest match label (semantic/lexical). Never injects from an '
+            + 'empty or provider-mismatched index, or from a hashed-only (no real semantic) provider — '
+            + 'the store exposes each of those and the turn record states which. '
+            + 'DEFAULT OFF (unlike agent-passive-knowledge-injection, which defaults on): code injection '
+            + 'is a newer, higher-variance signal than reviewed project memory — code chunks carry no '
+            + 'review/trust provenance and a weak similarity match can pull in a plausibly-worded but '
+            + 'wrong chunk — so this first landing is opt-in, earned on by the same hard-budget + '
+            + 'honest-record discipline before it becomes a default. Also respects the embedder’s '
+            + 'storage.codeIndexEnabled setting; disable either to revert to memory-only injection.',
+        defaultState: 'disabled',
+        tier: 9,
+        runtimeToggleable: true,
+    },
     {
         id: 'output-schema-fingerprint',
         name: 'Output Schema Fingerprints',
@@ -323,11 +343,29 @@ export const FEATURE_FLAGS = [
         runtimeToggleable: true,
     },
     {
+        // NOTE: control-plane-gateway is the ONE tier-10 flag that defaults ON (One-Platform).
+        // A stock daemon (no config) must be able to stream companion chat over SSE;
+        // leaving this OFF made a fresh daemon return 503 on the live-stream path (the
+        // "stock daemon is dead" bug).
+        //
+        // HONEST SURFACE STATEMENT: flipping this default ON DOES expose surface — just not
+        // an UNAUTHENTICATED one. Concretely it turns on: (1) the auth-gated streaming surface
+        // — SSE `/api/control-plane/events`, the companion-chat `.../events` stream, and the WS
+        // control channel — every one of which returns 401 before any principal is resolved
+        // (daemon-sdk/control-routes.ts), and per-channel scopes are enforced on the fan-out
+        // (e.g. read:sessions on session-update); and (2) the inert pre-auth login shell — the
+        // handful of unauthenticated bootstrap endpoints that carry NO session/runtime data and
+        // exist only to establish auth. The default bind stays loopback and the 60/min + 5/min
+        // rate limiters are unchanged. It remains runtimeToggleable, so an operator who wants a
+        // request/response-only daemon can turn it back off via config
+        // (`flags: { 'control-plane-gateway': 'disabled' }`), which the manager honours over
+        // this default. Do NOT generalise this to the other tier-10 siblings (slack/discord/web
+        // surfaces, delivery-engine, etc.) — they stay OFF until individually validated.
         id: 'control-plane-gateway',
         name: 'Control-Plane Gateway',
         description: 'Enables the shared gateway/control-plane host that serves state snapshots, live streams, '
             + 'and authenticated automation control APIs to terminal hosts and remote clients.',
-        defaultState: 'disabled',
+        defaultState: 'enabled',
         tier: 10,
         runtimeToggleable: true,
     },

package/dist/platform/runtime/fleet/adapters/agent.d.ts

@@ -5,7 +5,7 @@ import type { ProcessActivity, ProcessNode, ProcessState, ProcessUsage } from '.
 export declare function chainNodeId(chainId: string): string;
 /** Subtask node ids are namespaced to avoid colliding with agent/process ids. */
 export declare function subtaskNodeId(subtaskId: string): string;
-/** Work-item node ids are namespaced to avoid colliding with agent/process ids (Wave 4, wo701). */
+/** Work-item node ids are namespaced to avoid colliding with agent/process ids. */
 export declare function workItemNodeId(workItemId: string): string;
 /**
  * One activity side-table entry. Registry-owned; populated from the EXISTING
@@ -35,7 +35,7 @@ export interface AgentAdapterContext {
     readonly chainIds: ReadonlySet<string>;
     /** Raw WrfcSubtask ids present in this snapshot. */
     readonly subtaskIds: ReadonlySet<string>;
-    /** Raw orchestration-engine WorkItem ids present in this snapshot (Wave 4, wo701). */
+    /** Raw orchestration-engine WorkItem ids present in this snapshot. */
     readonly workItemIds: ReadonlySet<string>;
     /** orchestrationNodeId → owning agentId, for parentNodeId edge resolution. */
     readonly agentIdByOrchestrationNodeId: ReadonlyMap<string, string>;

package/dist/platform/runtime/fleet/adapters/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/fleet/adapters/agent.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/H,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAChD,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3D,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtD,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,4BAA4B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnE,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACtG;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAYlF;AA8ED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,mBAAmB,GAAG,WAAW,CA6CrF"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/fleet/adapters/agent.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/H,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAChD,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3D,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtD,gFAAgF;IAChF,QAAQ,CAAC,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,4BAA4B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnE,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACtG;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAYlF;AA8ED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,mBAAmB,GAAG,WAAW,CA6CrF"}

package/dist/platform/runtime/fleet/adapters/agent.js

@@ -7,7 +7,7 @@ export function chainNodeId(chainId) {
 export function subtaskNodeId(subtaskId) {
     return `subtask:${subtaskId}`;
 }
-/** Work-item node ids are namespaced to avoid colliding with agent/process ids (Wave 4, wo701). */
+/** Work-item node ids are namespaced to avoid colliding with agent/process ids. */
 export function workItemNodeId(workItemId) {
     return `work-item:${workItemId}`;
 }
@@ -27,9 +27,9 @@ export function usageFromAgentRecord(record) {
     };
 }
 /**
- * parentId precedence (brief-mandated, Wave-4 stable):
+ * parentId precedence (brief-mandated, stable):
  * wrfcSubtaskId → `subtask:<id>` else wrfcId → `chain:<id>` else
- * workItemId → `work-item:<id>` (Wave 4, wo701 — orchestration-engine phase
+ * workItemId → `work-item:<id>` (orchestration-engine phase
  * agents, a separate track from WRFC so the two systems' agents are never
  * conflated) else orchestrationNodeId/parentNodeId (resolved to the owning
  * agent) else parentAgentId. Every step falls through when the referenced
@@ -64,7 +64,7 @@ function deriveAgentState(record, entry, sessionId, ctx) {
             return 'failed';
         case 'cancelled':
             // terminationKind distinguishes a graceful interrupt request from a hard
-            // kill for display purposes (Wave-3 verb formalization). Records
+            // kill for display purposes. Records
             // persisted before this field existed have no terminationKind and
             // default to 'killed' — the historical behavior.
             return record.terminationKind === 'interrupt' ? 'interrupted' : 'killed';

package/dist/platform/runtime/fleet/adapters/automation.d.ts

@@ -17,7 +17,7 @@ export interface AutomationJobRaw {
 /** Type guard for AutomationJobRaw, used by registry.ts to distinguish an automation-job 'schedule' node's `raw` from a workflow-tool ScheduleEntry's `raw` — both share the 'schedule' kind. */
 export declare function isAutomationJobRaw(raw: unknown): raw is AutomationJobRaw;
 /**
- * AutomationJob → ProcessNode (Wave 6, wo-F item d4). Reuses the 'schedule'
+ * AutomationJob → ProcessNode. Reuses the 'schedule'
  * kind rather than inventing a new one — a job created via `/schedule` IS a
  * schedule from the user's viewpoint, even though it lives in a completely
  * separate subsystem (platform/automation) from the workflow-tool's

package/dist/platform/runtime/fleet/adapters/automation.js

@@ -14,7 +14,7 @@ export function isAutomationJobRaw(raw) {
     return raw !== null && typeof raw === 'object' && raw.source === 'automation-manager';
 }
 /**
- * AutomationJob → ProcessNode (Wave 6, wo-F item d4). Reuses the 'schedule'
+ * AutomationJob → ProcessNode. Reuses the 'schedule'
  * kind rather than inventing a new one — a job created via `/schedule` IS a
  * schedule from the user's viewpoint, even though it lives in a completely
  * separate subsystem (platform/automation) from the workflow-tool's

package/dist/platform/runtime/fleet/adapters/code-index.d.ts

@@ -15,7 +15,7 @@ export declare function codeIndexNodeId(): string;
  * background-process): liveness rides the registry tick. An index build has
  * no pid, so it is NOT a 'background-process' node (ProcessManager is
  * shell/OS-process-only) — it gets its own ProcessKind, mirroring the
- * Wave-4 orchestrationEngine-dep precedent.
+ * orchestrationEngine-dep precedent.
  */
 export declare function adaptCodeIndex(service: CodeIndexProcessSource, now: number): ProcessNode;
 //# sourceMappingURL=code-index.d.ts.map

package/dist/platform/runtime/fleet/adapters/code-index.js

@@ -8,7 +8,7 @@ export function codeIndexNodeId() {
  * background-process): liveness rides the registry tick. An index build has
  * no pid, so it is NOT a 'background-process' node (ProcessManager is
  * shell/OS-process-only) — it gets its own ProcessKind, mirroring the
- * Wave-4 orchestrationEngine-dep precedent.
+ * orchestrationEngine-dep precedent.
  */
 export function adaptCodeIndex(service, now) {
     const building = service.isBuilding();

package/dist/platform/runtime/fleet/adapters/orchestration.d.ts

@@ -1,19 +1,30 @@
 /** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import type { Phase, WorkItem, WorkItemUsage, Workstream } from '../../../orchestration/types.js';
+import type { ProcessCostState, ProcessNode, ProcessUsage } from '../types.js';
+import { workItemNodeId } from './agent.js';
 /**
- * Orchestration-engine fleet adapters (Wave 4, wo701) — Workstream/Phase/
- * WorkItem -> ProcessNode, mirroring adapters/wrfc.ts's chain/subtask
- * pattern: a workstream is a root node (no native cancel of its own, so kill
- * is DERIVED — cascades AgentManager.cancel over every agent any item ever
- * spawned, same shape as adaptChain/cancelAgents), a phase is a pure grouping
- * node (no lifecycle, no usage — same "report nothing" choice adaptSubtask
- * makes, since attributing a work-item's CUMULATIVE usage to whichever phase
- * it currently sits in would double-count across phases), and a work-item is
- * the WRFC-subtask analogue: it delegates interrupt/kill/steer to its
- * current live agent when it has one.
+ * Live in-flight usage of a work-item's currently-active agent, read from that
+ * agent's fleet node at snapshot time (DEBT-4 item 2). Overlaid onto the
+ * item's phase-boundary-committed `item.usage` so a RUNNING phase shows real,
+ * growing numbers instead of n/a until it completes.
  */
-import type { Phase, WorkItem, Workstream } from '../../../orchestration/types.js';
-import type { ProcessNode } from '../types.js';
-import { workItemNodeId } from './agent.js';
+export interface LiveItemUsage {
+    readonly usage?: ProcessUsage | undefined;
+    readonly costUsd?: number | null | undefined;
+    readonly costState?: ProcessCostState | undefined;
+}
+/**
+ * The usage the fleet DISPLAYS for a work-item: its committed phase-boundary
+ * total, plus — only while it is actively 'in-phase' — the live in-flight
+ * usage of its current agent. The overlay is applied ONLY for an 'in-phase'
+ * item, which is exactly the window in which `item.usage` does NOT yet include
+ * the running phase (the engine folds that in at completion — see
+ * runItemPhase), so committed + live never double-counts and the two hand off
+ * atomically at the phase boundary. Because both operands only ever grow and
+ * merge through {@link mergeWorkItemUsage}, presence is MONOTONE: once usage
+ * has appeared for an item it never blinks back to n/a (DEBT-4 item 2).
+ */
+export declare function displayWorkItemUsage(item: WorkItem, live: LiveItemUsage | undefined): WorkItemUsage;
 /** Workstream node ids are namespaced to avoid colliding with agent/process ids. */
 export declare function workstreamNodeId(workstreamId: string): string;
 /**
@@ -25,9 +36,16 @@ export declare function phaseNodeId(workstreamId: string, phaseId: string): stri
 export { workItemNodeId };
 /** The work-item's currently-active agent, i.e. the one driving its live phase run. Undefined once terminal or between phases. */
 export declare function activeWorkItemAgentId(item: WorkItem): string | undefined;
-/** WorkItem -> ProcessNode. Delegates interruptible/killable/steerable to its currently-active agent, mirroring adaptSubtask. */
+/**
+ * WorkItem -> ProcessNode. Delegates interruptible/killable/steerable to its
+ * currently-active agent, mirroring adaptSubtask. `opts.live` supplies the
+ * currently-active agent's in-flight usage so a running phase shows real,
+ * growing numbers instead of n/a until it completes (DEBT-4 item 2); omit it
+ * (or pass undefined) for the committed-only view.
+ */
 export declare function adaptWorkItem(item: WorkItem, workstreamId: string, parentId: string, opts: {
     steerable: boolean;
+    live?: LiveItemUsage | undefined;
 }): ProcessNode;
 /**
  * Phase -> ProcessNode. Deliberately reports NO usage/cost (mirrors
@@ -39,9 +57,13 @@ export declare function adaptWorkItem(item: WorkItem, workstreamId: string, pare
  */
 export declare function adaptPhase(phase: Phase, workstream: Workstream): ProcessNode;
 /**
- * Workstream -> ProcessNode. Root node (no parentId). Sums every item's
- * usage/cost exactly once (never through an intermediate phase bucket — see
- * adaptPhase) so this total can never double-count.
+ * Workstream -> ProcessNode. Root node (no parentId). Sums every item's DISPLAY
+ * usage/cost (committed total + any live in-flight overlay, resolved once per
+ * item) exactly once — never through an intermediate phase bucket (see
+ * adaptPhase) — so this total can never double-count and never shows n/a while
+ * an item is actively producing usage (DEBT-4 item 2). `liveByItemId` supplies
+ * the active agents' in-flight usage keyed by item id; omit it for the
+ * committed-only view.
  */
-export declare function adaptWorkstream(workstream: Workstream, now: number): ProcessNode;
+export declare function adaptWorkstream(workstream: Workstream, now: number, liveByItemId?: ReadonlyMap<string, LiveItemUsage>): ProcessNode;
 //# sourceMappingURL=orchestration.d.ts.map

package/dist/platform/runtime/fleet/adapters/orchestration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/fleet/adapters/orchestration.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC;AAI1B,kIAAkI;AAClI,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AA6FD,iIAAiI;AACjI,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CA6C/H;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,GAAG,WAAW,CAuB5E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CA+BhF"}
+{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/fleet/adapters/orchestration.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAerF,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAgB,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACnD;AA2CD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAOnG;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC;AAI1B,kIAAkI;AAClI,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AA0GD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,GAAG,WAAW,CAqDjK;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,GAAG,WAAW,CAuB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,WAAW,CAgCnI"}