@mysten-incubation/devstack 0.0.1 → 0.1.1

package/dist/substrate/runtime/probes.mjs

@@ -5,6 +5,7 @@ var probes_exports = /* @__PURE__ */ __exportAll({
 	ProbeAttemptTimeoutError: () => ProbeAttemptTimeoutError,
 	ProbeTimeoutError: () => ProbeTimeoutError,
 	exitCodeProbeResult: () => exitCodeProbeResult,
+	probeManyLenient: () => probeManyLenient,
 	waitForProbe: () => waitForProbe
 });
 var ProbeAttemptTimeoutError = class extends Data.TaggedError("ProbeAttemptTimeoutError") {};
@@ -78,7 +79,8 @@ const exitCodeProbeResult = (result) => {
 		}
 	};
 };
+const probeManyLenient = (probes, options) => Effect.forEach(probes, (probe) => probe, { concurrency: options?.concurrency ?? "unbounded" });
 //#endregion
-export { ProbeTimeoutError, exitCodeProbeResult, probes_exports, waitForProbe };
+export { ProbeTimeoutError, exitCodeProbeResult, probeManyLenient, probes_exports, waitForProbe };
 
 //# sourceMappingURL=probes.mjs.map

package/dist/substrate/runtime/probes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"probes.mjs","names":[],"sources":["../../../src/substrate/runtime/probes.ts"],"sourcesContent":["import { Data, Duration, Effect } from 'effect';\n\nexport type ProbeAttemptResult =\n\t| void\n\t| boolean\n\t| {\n\t\t\treadonly ready: boolean;\n\t\t\treadonly detail?: unknown;\n\t  };\n\nexport interface ProbeOptions<E = unknown, R = never> {\n\treadonly label: string;\n\treadonly timeoutMs: number;\n\treadonly intervalMs?: number;\n\treadonly attemptTimeoutMs?: number;\n\treadonly probe: () => Effect.Effect<ProbeAttemptResult, E, R>;\n\treadonly isRetryableError?: (error: E) => boolean;\n}\n\nexport class ProbeAttemptTimeoutError extends Data.TaggedError('ProbeAttemptTimeoutError')<{\n\treadonly label: string;\n\treadonly attemptTimeoutMs: number;\n\treadonly message: string;\n}> {}\n\nexport class ProbeTimeoutError extends Data.TaggedError('ProbeTimeoutError')<{\n\treadonly label: string;\n\treadonly timeoutMs: number;\n\treadonly intervalMs: number;\n\treadonly attemptTimeoutMs?: number;\n\treadonly attempts: number;\n\treadonly message: string;\n\treadonly lastError?: unknown;\n\treadonly lastNotReady?: unknown;\n}> {}\n\nconst DEFAULT_INTERVAL_MS = 250;\n\nconst normalizeAttempt = (\n\tresult: ProbeAttemptResult,\n): { readonly ready: boolean; readonly detail?: unknown } => {\n\tif (result === undefined || result === true) return { ready: true };\n\tif (result === false) return { ready: false };\n\treturn result;\n};\n\nconst withAttemptTimeout = <A, E, R>(\n\teffect: Effect.Effect<A, E, R>,\n\toptions: {\n\t\treadonly label: string;\n\t\treadonly attemptTimeoutMs?: number;\n\t\treadonly remainingMs: number;\n\t},\n): Effect.Effect<A, E | ProbeAttemptTimeoutError, R> => {\n\tif (options.attemptTimeoutMs === undefined) return effect;\n\tconst timeoutMs = Math.max(1, Math.min(options.attemptTimeoutMs, options.remainingMs));\n\treturn effect.pipe(\n\t\tEffect.timeoutOrElse({\n\t\t\tduration: Duration.millis(timeoutMs),\n\t\t\torElse: () =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew ProbeAttemptTimeoutError({\n\t\t\t\t\t\tlabel: options.label,\n\t\t\t\t\t\tattemptTimeoutMs: timeoutMs,\n\t\t\t\t\t\tmessage: `Probe ${options.label} attempt did not complete within ${timeoutMs}ms`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t}),\n\t);\n};\n\nexport const waitForProbe = <E, R = never>(\n\toptions: ProbeOptions<E, R>,\n): Effect.Effect<void, E | ProbeTimeoutError, R> =>\n\tEffect.gen(function* () {\n\t\tconst timeoutMs = options.timeoutMs;\n\t\tconst intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;\n\t\tconst started = Date.now();\n\t\tconst deadline = started + timeoutMs;\n\t\tlet attempts = 0;\n\t\tlet lastError: unknown;\n\t\tlet lastNotReady: unknown;\n\n\t\tfor (;;) {\n\t\t\tconst remainingMs = deadline - Date.now();\n\t\t\tif (remainingMs <= 0) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew ProbeTimeoutError({\n\t\t\t\t\t\tlabel: options.label,\n\t\t\t\t\t\ttimeoutMs,\n\t\t\t\t\t\tintervalMs,\n\t\t\t\t\t\t...(options.attemptTimeoutMs === undefined\n\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t: { attemptTimeoutMs: options.attemptTimeoutMs }),\n\t\t\t\t\t\tattempts,\n\t\t\t\t\t\tmessage: `Probe ${options.label} did not become ready within ${timeoutMs}ms`,\n\t\t\t\t\t\t...(lastError === undefined ? {} : { lastError }),\n\t\t\t\t\t\t...(lastNotReady === undefined ? {} : { lastNotReady }),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tattempts += 1;\n\t\t\tconst ready = yield* withAttemptTimeout(options.probe(), {\n\t\t\t\tlabel: options.label,\n\t\t\t\tattemptTimeoutMs: options.attemptTimeoutMs,\n\t\t\t\tremainingMs,\n\t\t\t}).pipe(\n\t\t\t\tEffect.matchEffect({\n\t\t\t\t\tonFailure: (error) => {\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t!(error instanceof ProbeAttemptTimeoutError) &&\n\t\t\t\t\t\t\toptions.isRetryableError?.(error as E) === false\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\treturn Effect.fail(error as E);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tlastError = error;\n\t\t\t\t\t\treturn Effect.succeed(false);\n\t\t\t\t\t},\n\t\t\t\t\tonSuccess: (result) => {\n\t\t\t\t\t\tconst normalized = normalizeAttempt(result);\n\t\t\t\t\t\tif (!normalized.ready) lastNotReady = normalized.detail ?? false;\n\t\t\t\t\t\treturn Effect.succeed(normalized.ready);\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t);\n\t\t\tif (ready) return;\n\n\t\t\tconst sleepMs = Math.min(intervalMs, Math.max(1, deadline - Date.now()));\n\t\t\tyield* Effect.sleep(Duration.millis(sleepMs));\n\t\t}\n\t});\n\nexport interface ExitCodeProbeResult {\n\treadonly exitCode: number;\n\treadonly stdout?: string;\n\treadonly stderr?: string;\n}\n\nexport const exitCodeProbeResult = (result: ExitCodeProbeResult): ProbeAttemptResult => {\n\tif (result.exitCode === 0) return true;\n\treturn {\n\t\tready: false,\n\t\tdetail: {\n\t\t\texitCode: result.exitCode,\n\t\t\t...(result.stdout === undefined ? {} : { stdout: result.stdout }),\n\t\t\t...(result.stderr === undefined ? {} : { stderr: result.stderr }),\n\t\t},\n\t};\n};\n"],"mappings":";;;;;;;;;AAmBA,IAAa,2BAAb,cAA8C,KAAK,YAAY,2BAA2B,CAIvF;AAEH,IAAa,oBAAb,cAAuC,KAAK,YAAY,oBAAoB,CASzE;AAEH,MAAM,sBAAsB;AAE5B,MAAM,oBACL,WAC4D;AAC5D,KAAI,WAAW,KAAA,KAAa,WAAW,KAAM,QAAO,EAAE,OAAO,MAAM;AACnE,KAAI,WAAW,MAAO,QAAO,EAAE,OAAO,OAAO;AAC7C,QAAO;;AAGR,MAAM,sBACL,QACA,YAKuD;AACvD,KAAI,QAAQ,qBAAqB,KAAA,EAAW,QAAO;CACnD,MAAM,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,kBAAkB,QAAQ,YAAY,CAAC;AACtF,QAAO,OAAO,KACb,OAAO,cAAc;EACpB,UAAU,SAAS,OAAO,UAAU;EACpC,cACC,OAAO,KACN,IAAI,yBAAyB;GAC5B,OAAO,QAAQ;GACf,kBAAkB;GAClB,SAAS,SAAS,QAAQ,MAAM,mCAAmC,UAAU;GAC7E,CAAC,CACF;EACF,CAAC,CACF;;AAGF,MAAa,gBACZ,YAEA,OAAO,IAAI,aAAa;CACvB,MAAM,YAAY,QAAQ;CAC1B,MAAM,aAAa,QAAQ,cAAc;CAEzC,MAAM,WADU,KAAK,KACG,GAAG;CAC3B,IAAI,WAAW;CACf,IAAI;CACJ,IAAI;AAEJ,UAAS;EACR,MAAM,cAAc,WAAW,KAAK,KAAK;AACzC,MAAI,eAAe,EAClB,QAAO,OAAO,OAAO,KACpB,IAAI,kBAAkB;GACrB,OAAO,QAAQ;GACf;GACA;GACA,GAAI,QAAQ,qBAAqB,KAAA,IAC9B,EAAE,GACF,EAAE,kBAAkB,QAAQ,kBAAkB;GACjD;GACA,SAAS,SAAS,QAAQ,MAAM,+BAA+B,UAAU;GACzE,GAAI,cAAc,KAAA,IAAY,EAAE,GAAG,EAAE,WAAW;GAChD,GAAI,iBAAiB,KAAA,IAAY,EAAE,GAAG,EAAE,cAAc;GACtD,CAAC,CACF;AAGF,cAAY;AAwBZ,MAAI,OAvBiB,mBAAmB,QAAQ,OAAO,EAAE;GACxD,OAAO,QAAQ;GACf,kBAAkB,QAAQ;GAC1B;GACA,CAAC,CAAC,KACF,OAAO,YAAY;GAClB,YAAY,UAAU;AACrB,QACC,EAAE,iBAAiB,6BACnB,QAAQ,mBAAmB,MAAW,KAAK,MAE3C,QAAO,OAAO,KAAK,MAAW;AAE/B,gBAAY;AACZ,WAAO,OAAO,QAAQ,MAAM;;GAE7B,YAAY,WAAW;IACtB,MAAM,aAAa,iBAAiB,OAAO;AAC3C,QAAI,CAAC,WAAW,MAAO,gBAAe,WAAW,UAAU;AAC3D,WAAO,OAAO,QAAQ,WAAW,MAAM;;GAExC,CAAC,CACF,CACU;EAEX,MAAM,UAAU,KAAK,IAAI,YAAY,KAAK,IAAI,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC;AACxE,SAAO,OAAO,MAAM,SAAS,OAAO,QAAQ,CAAC;;EAE7C;AAQH,MAAa,uBAAuB,WAAoD;AACvF,KAAI,OAAO,aAAa,EAAG,QAAO;AAClC,QAAO;EACN,OAAO;EACP,QAAQ;GACP,UAAU,OAAO;GACjB,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,GAAG,EAAE,QAAQ,OAAO,QAAQ;GAChE,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,GAAG,EAAE,QAAQ,OAAO,QAAQ;GAChE;EACD"}
+{"version":3,"file":"probes.mjs","names":[],"sources":["../../../src/substrate/runtime/probes.ts"],"sourcesContent":["import { Data, Duration, Effect, Types } from 'effect';\n\nexport type ProbeAttemptResult =\n\t| void\n\t| boolean\n\t| {\n\t\t\treadonly ready: boolean;\n\t\t\treadonly detail?: unknown;\n\t  };\n\nexport interface ProbeOptions<E = unknown, R = never> {\n\treadonly label: string;\n\treadonly timeoutMs: number;\n\treadonly intervalMs?: number;\n\treadonly attemptTimeoutMs?: number;\n\treadonly probe: () => Effect.Effect<ProbeAttemptResult, E, R>;\n\treadonly isRetryableError?: (error: E) => boolean;\n}\n\nexport class ProbeAttemptTimeoutError extends Data.TaggedError('ProbeAttemptTimeoutError')<{\n\treadonly label: string;\n\treadonly attemptTimeoutMs: number;\n\treadonly message: string;\n}> {}\n\nexport class ProbeTimeoutError extends Data.TaggedError('ProbeTimeoutError')<{\n\treadonly label: string;\n\treadonly timeoutMs: number;\n\treadonly intervalMs: number;\n\treadonly attemptTimeoutMs?: number;\n\treadonly attempts: number;\n\treadonly message: string;\n\treadonly lastError?: unknown;\n\treadonly lastNotReady?: unknown;\n}> {}\n\nconst DEFAULT_INTERVAL_MS = 250;\n\nconst normalizeAttempt = (\n\tresult: ProbeAttemptResult,\n): { readonly ready: boolean; readonly detail?: unknown } => {\n\tif (result === undefined || result === true) return { ready: true };\n\tif (result === false) return { ready: false };\n\treturn result;\n};\n\nconst withAttemptTimeout = <A, E, R>(\n\teffect: Effect.Effect<A, E, R>,\n\toptions: {\n\t\treadonly label: string;\n\t\treadonly attemptTimeoutMs?: number;\n\t\treadonly remainingMs: number;\n\t},\n): Effect.Effect<A, E | ProbeAttemptTimeoutError, R> => {\n\tif (options.attemptTimeoutMs === undefined) return effect;\n\tconst timeoutMs = Math.max(1, Math.min(options.attemptTimeoutMs, options.remainingMs));\n\treturn effect.pipe(\n\t\tEffect.timeoutOrElse({\n\t\t\tduration: Duration.millis(timeoutMs),\n\t\t\torElse: () =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\tnew ProbeAttemptTimeoutError({\n\t\t\t\t\t\tlabel: options.label,\n\t\t\t\t\t\tattemptTimeoutMs: timeoutMs,\n\t\t\t\t\t\tmessage: `Probe ${options.label} attempt did not complete within ${timeoutMs}ms`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t}),\n\t);\n};\n\nexport const waitForProbe = <E, R = never>(\n\toptions: ProbeOptions<E, R>,\n): Effect.Effect<void, E | ProbeTimeoutError, R> =>\n\tEffect.gen(function* () {\n\t\tconst timeoutMs = options.timeoutMs;\n\t\tconst intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;\n\t\tconst started = Date.now();\n\t\tconst deadline = started + timeoutMs;\n\t\tlet attempts = 0;\n\t\tlet lastError: unknown;\n\t\tlet lastNotReady: unknown;\n\n\t\tfor (;;) {\n\t\t\tconst remainingMs = deadline - Date.now();\n\t\t\tif (remainingMs <= 0) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tnew ProbeTimeoutError({\n\t\t\t\t\t\tlabel: options.label,\n\t\t\t\t\t\ttimeoutMs,\n\t\t\t\t\t\tintervalMs,\n\t\t\t\t\t\t...(options.attemptTimeoutMs === undefined\n\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t: { attemptTimeoutMs: options.attemptTimeoutMs }),\n\t\t\t\t\t\tattempts,\n\t\t\t\t\t\tmessage: `Probe ${options.label} did not become ready within ${timeoutMs}ms`,\n\t\t\t\t\t\t...(lastError === undefined ? {} : { lastError }),\n\t\t\t\t\t\t...(lastNotReady === undefined ? {} : { lastNotReady }),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tattempts += 1;\n\t\t\tconst ready = yield* withAttemptTimeout(options.probe(), {\n\t\t\t\tlabel: options.label,\n\t\t\t\tattemptTimeoutMs: options.attemptTimeoutMs,\n\t\t\t\tremainingMs,\n\t\t\t}).pipe(\n\t\t\t\tEffect.matchEffect({\n\t\t\t\t\tonFailure: (error) => {\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t!(error instanceof ProbeAttemptTimeoutError) &&\n\t\t\t\t\t\t\toptions.isRetryableError?.(error as E) === false\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\treturn Effect.fail(error as E);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tlastError = error;\n\t\t\t\t\t\treturn Effect.succeed(false);\n\t\t\t\t\t},\n\t\t\t\t\tonSuccess: (result) => {\n\t\t\t\t\t\tconst normalized = normalizeAttempt(result);\n\t\t\t\t\t\tif (!normalized.ready) lastNotReady = normalized.detail ?? false;\n\t\t\t\t\t\treturn Effect.succeed(normalized.ready);\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t);\n\t\t\tif (ready) return;\n\n\t\t\tconst sleepMs = Math.min(intervalMs, Math.max(1, deadline - Date.now()));\n\t\t\tyield* Effect.sleep(Duration.millis(sleepMs));\n\t\t}\n\t});\n\nexport interface ExitCodeProbeResult {\n\treadonly exitCode: number;\n\treadonly stdout?: string;\n\treadonly stderr?: string;\n}\n\nexport const exitCodeProbeResult = (result: ExitCodeProbeResult): ProbeAttemptResult => {\n\tif (result.exitCode === 0) return true;\n\treturn {\n\t\tready: false,\n\t\tdetail: {\n\t\t\texitCode: result.exitCode,\n\t\t\t...(result.stdout === undefined ? {} : { stdout: result.stdout }),\n\t\t\t...(result.stderr === undefined ? {} : { stderr: result.stderr }),\n\t\t},\n\t};\n};\n\n// ---------------------------------------------------------------------------\n// probeManyLenient — run a set of lenient `T | null` probes and surface\n// each probe's verdict so the caller can fold the array however it likes.\n// ---------------------------------------------------------------------------\n//\n// Lenient probes (per `ChainProbe`'s `'lenient'` contract) return `T | null`\n// where `null` is a non-authoritative \"not yet\" signal. Several plugins\n// (walrus deploy, deepbook deploy, pyth init) hand-roll a sequential loop\n// that early-returns `null` on the first non-ready probe. This helper\n// centralizes the iteration so the call sites collapse to a `.every()`\n// or `.find()` against the returned array.\n//\n// Concurrency defaults to `'unbounded'`. Callers that need sequential\n// short-circuit semantics (e.g. RPC backoff politeness) can pass\n// `concurrency: 1`. The return shape is the full array even when concurrency\n// is 1 — callers that want \"any null aborts and returns null\" should fold\n// with `.every((x) => x !== null) ? array : null` themselves.\n\nexport const probeManyLenient = <T, E, R>(\n\tprobes: ReadonlyArray<Effect.Effect<T | null, E, R>>,\n\toptions?: { readonly concurrency?: Types.Concurrency },\n): Effect.Effect<ReadonlyArray<T | null>, E, R> =>\n\tEffect.forEach(probes, (probe) => probe, {\n\t\tconcurrency: options?.concurrency ?? 'unbounded',\n\t});\n"],"mappings":";;;;;;;;;;AAmBA,IAAa,2BAAb,cAA8C,KAAK,YAAY,2BAA2B,CAIvF;AAEH,IAAa,oBAAb,cAAuC,KAAK,YAAY,oBAAoB,CASzE;AAEH,MAAM,sBAAsB;AAE5B,MAAM,oBACL,WAC4D;AAC5D,KAAI,WAAW,KAAA,KAAa,WAAW,KAAM,QAAO,EAAE,OAAO,MAAM;AACnE,KAAI,WAAW,MAAO,QAAO,EAAE,OAAO,OAAO;AAC7C,QAAO;;AAGR,MAAM,sBACL,QACA,YAKuD;AACvD,KAAI,QAAQ,qBAAqB,KAAA,EAAW,QAAO;CACnD,MAAM,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,kBAAkB,QAAQ,YAAY,CAAC;AACtF,QAAO,OAAO,KACb,OAAO,cAAc;EACpB,UAAU,SAAS,OAAO,UAAU;EACpC,cACC,OAAO,KACN,IAAI,yBAAyB;GAC5B,OAAO,QAAQ;GACf,kBAAkB;GAClB,SAAS,SAAS,QAAQ,MAAM,mCAAmC,UAAU;GAC7E,CAAC,CACF;EACF,CAAC,CACF;;AAGF,MAAa,gBACZ,YAEA,OAAO,IAAI,aAAa;CACvB,MAAM,YAAY,QAAQ;CAC1B,MAAM,aAAa,QAAQ,cAAc;CAEzC,MAAM,WADU,KAAK,KACG,GAAG;CAC3B,IAAI,WAAW;CACf,IAAI;CACJ,IAAI;AAEJ,UAAS;EACR,MAAM,cAAc,WAAW,KAAK,KAAK;AACzC,MAAI,eAAe,EAClB,QAAO,OAAO,OAAO,KACpB,IAAI,kBAAkB;GACrB,OAAO,QAAQ;GACf;GACA;GACA,GAAI,QAAQ,qBAAqB,KAAA,IAC9B,EAAE,GACF,EAAE,kBAAkB,QAAQ,kBAAkB;GACjD;GACA,SAAS,SAAS,QAAQ,MAAM,+BAA+B,UAAU;GACzE,GAAI,cAAc,KAAA,IAAY,EAAE,GAAG,EAAE,WAAW;GAChD,GAAI,iBAAiB,KAAA,IAAY,EAAE,GAAG,EAAE,cAAc;GACtD,CAAC,CACF;AAGF,cAAY;AAwBZ,MAAI,OAvBiB,mBAAmB,QAAQ,OAAO,EAAE;GACxD,OAAO,QAAQ;GACf,kBAAkB,QAAQ;GAC1B;GACA,CAAC,CAAC,KACF,OAAO,YAAY;GAClB,YAAY,UAAU;AACrB,QACC,EAAE,iBAAiB,6BACnB,QAAQ,mBAAmB,MAAW,KAAK,MAE3C,QAAO,OAAO,KAAK,MAAW;AAE/B,gBAAY;AACZ,WAAO,OAAO,QAAQ,MAAM;;GAE7B,YAAY,WAAW;IACtB,MAAM,aAAa,iBAAiB,OAAO;AAC3C,QAAI,CAAC,WAAW,MAAO,gBAAe,WAAW,UAAU;AAC3D,WAAO,OAAO,QAAQ,WAAW,MAAM;;GAExC,CAAC,CACF,CACU;EAEX,MAAM,UAAU,KAAK,IAAI,YAAY,KAAK,IAAI,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC;AACxE,SAAO,OAAO,MAAM,SAAS,OAAO,QAAQ,CAAC;;EAE7C;AAQH,MAAa,uBAAuB,WAAoD;AACvF,KAAI,OAAO,aAAa,EAAG,QAAO;AAClC,QAAO;EACN,OAAO;EACP,QAAQ;GACP,UAAU,OAAO;GACjB,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,GAAG,EAAE,QAAQ,OAAO,QAAQ;GAChE,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,GAAG,EAAE,QAAQ,OAAO,QAAQ;GAChE;EACD;;AAqBF,MAAa,oBACZ,QACA,YAEA,OAAO,QAAQ,SAAS,UAAU,OAAO,EACxC,aAAa,SAAS,eAAe,aACrC,CAAC"}

package/dist/substrate/runtime/projection/index.mjs

@@ -0,0 +1,4 @@
+import "./state-ref.mjs";
+import "./persisted.mjs";
+import "./update.mjs";
+export {};

package/dist/substrate/runtime/projection/operational-endpoints.mjs

@@ -6,20 +6,19 @@ const SAFE_URL_FIELDS = {
 	faucetUrl: "faucet",
 	graphqlUrl: "graphql"
 };
-const SENSITIVE_URL_FIELD = /pair|token|secret|password|private|bearer/i;
 const operationalEndpointEventsFromResolvedValue = (pluginKey, value, registeredAt, options = {}) => {
 	if (options.routablesPresent === true) return [];
 	if (value === null || typeof value !== "object") return [];
 	const record = value;
 	const events = [];
 	for (const [field, name] of Object.entries(SAFE_URL_FIELDS)) {
-		if (SENSITIVE_URL_FIELD.test(field)) continue;
 		const raw = record[field];
 		if (typeof raw !== "string" || !isHttpUrl(raw)) continue;
 		events.push({
 			tag: "endpoint.registered",
 			endpoint: {
 				endpointKey: endpointKey(`${pluginKey}:${field}`),
+				pluginKey,
 				name,
 				url: raw,
 				displayUrl: null,

package/dist/substrate/runtime/projection/operational-endpoints.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"operational-endpoints.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/operational-endpoints.ts"],"sourcesContent":["import { endpointKey, type PluginKey } from '../../brand.ts';\nimport type { EngineEvent } from '../../events.ts';\n\ntype EndpointRegisteredEvent = Extract<EngineEvent, { readonly tag: 'endpoint.registered' }>;\n\nconst SAFE_URL_FIELDS = {\n\turl: 'http',\n\trpcUrl: 'rpc',\n\tfaucetUrl: 'faucet',\n\tgraphqlUrl: 'graphql',\n} as const;\n\nconst SENSITIVE_URL_FIELD = /pair|token|secret|password|private|bearer/i;\n\nexport interface OperationalEndpointProjectionOptions {\n\t/** Routable capabilities are the authoritative public endpoint\n\t * source. Resolved-value URL scraping is only a fallback for\n\t * plugins with no router contribution, such as live/local-rpc\n\t * network modes. */\n\treadonly routablesPresent?: boolean;\n}\n\nexport const operationalEndpointEventsFromResolvedValue = (\n\tpluginKey: PluginKey,\n\tvalue: unknown,\n\tregisteredAt: number,\n\toptions: OperationalEndpointProjectionOptions = {},\n): ReadonlyArray<EndpointRegisteredEvent> => {\n\tif (options.routablesPresent === true) return [];\n\tif (value === null || typeof value !== 'object') return [];\n\tconst record = value as Readonly<Record<string, unknown>>;\n\tconst events: Array<EndpointRegisteredEvent> = [];\n\tfor (const [field, name] of Object.entries(SAFE_URL_FIELDS)) {\n\t\tif (SENSITIVE_URL_FIELD.test(field)) continue;\n\t\tconst raw = record[field];\n\t\tif (typeof raw !== 'string' || !isHttpUrl(raw)) continue;\n\t\tevents.push({\n\t\t\ttag: 'endpoint.registered',\n\t\t\tendpoint: {\n\t\t\t\tendpointKey: endpointKey(`${pluginKey}:${field}`),\n\t\t\t\tname,\n\t\t\t\turl: raw,\n\t\t\t\tdisplayUrl: null,\n\t\t\t\twireProtocol: 'http',\n\t\t\t\tregisteredAt,\n\t\t\t},\n\t\t});\n\t}\n\treturn events;\n};\n\nconst isHttpUrl = (value: string): boolean => {\n\ttry {\n\t\tconst parsed = new URL(value);\n\t\treturn parsed.protocol === 'http:' || parsed.protocol === 'https:';\n\t} catch {\n\t\treturn false;\n\t}\n};\n"],"mappings":";;AAKA,MAAM,kBAAkB;CACvB,KAAK;CACL,QAAQ;CACR,WAAW;CACX,YAAY;CACZ;AAED,MAAM,sBAAsB;AAU5B,MAAa,8CACZ,WACA,OACA,cACA,UAAgD,EAAE,KACN;AAC5C,KAAI,QAAQ,qBAAqB,KAAM,QAAO,EAAE;AAChD,KAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO,EAAE;CAC1D,MAAM,SAAS;CACf,MAAM,SAAyC,EAAE;AACjD,MAAK,MAAM,CAAC,OAAO,SAAS,OAAO,QAAQ,gBAAgB,EAAE;AAC5D,MAAI,oBAAoB,KAAK,MAAM,CAAE;EACrC,MAAM,MAAM,OAAO;AACnB,MAAI,OAAO,QAAQ,YAAY,CAAC,UAAU,IAAI,CAAE;AAChD,SAAO,KAAK;GACX,KAAK;GACL,UAAU;IACT,aAAa,YAAY,GAAG,UAAU,GAAG,QAAQ;IACjD;IACA,KAAK;IACL,YAAY;IACZ,cAAc;IACd;IACA;GACD,CAAC;;AAEH,QAAO;;AAGR,MAAM,aAAa,UAA2B;AAC7C,KAAI;EACH,MAAM,SAAS,IAAI,IAAI,MAAM;AAC7B,SAAO,OAAO,aAAa,WAAW,OAAO,aAAa;SACnD;AACP,SAAO"}
+{"version":3,"file":"operational-endpoints.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/operational-endpoints.ts"],"sourcesContent":["import { endpointKey, type PluginKey } from '../../brand.ts';\nimport type { EngineEvent } from '../../events.ts';\n\ntype EndpointRegisteredEvent = Extract<EngineEvent, { readonly tag: 'endpoint.registered' }>;\n\n// Endpoint-projection policy is closed-allowlist:\n// only the fields enumerated below are projected as operational\n// endpoints. Anything else — including legitimate sensitive URLs\n// (`pairUrl`, `walletPairingToken`, OAuth `tokenUrl`, etc.) and any\n// future field a plugin adds — is ignored by default. A plugin that\n// wants a new field projected must extend this list AND ship a\n// projection test pinning its display name. The previous loose\n// \"skip-if-matches-sensitive-regex\" check dropped legitimate OAuth\n// fields like `tokenUrl` and missed novel sensitive names; the\n// allowlist removes that whole class of false-negative/false-positive\n// pair.\nconst SAFE_URL_FIELDS = {\n\turl: 'http',\n\trpcUrl: 'rpc',\n\tfaucetUrl: 'faucet',\n\tgraphqlUrl: 'graphql',\n} as const;\n\nexport interface OperationalEndpointProjectionOptions {\n\t/** Routable capabilities are the authoritative public endpoint\n\t * source. Resolved-value URL scraping is only a fallback for\n\t * plugins with no router contribution, such as live/local-rpc\n\t * network modes. */\n\treadonly routablesPresent?: boolean;\n}\n\nexport const operationalEndpointEventsFromResolvedValue = (\n\tpluginKey: PluginKey,\n\tvalue: unknown,\n\tregisteredAt: number,\n\toptions: OperationalEndpointProjectionOptions = {},\n): ReadonlyArray<EndpointRegisteredEvent> => {\n\tif (options.routablesPresent === true) return [];\n\tif (value === null || typeof value !== 'object') return [];\n\tconst record = value as Readonly<Record<string, unknown>>;\n\tconst events: Array<EndpointRegisteredEvent> = [];\n\tfor (const [field, name] of Object.entries(SAFE_URL_FIELDS)) {\n\t\tconst raw = record[field];\n\t\tif (typeof raw !== 'string' || !isHttpUrl(raw)) continue;\n\t\tevents.push({\n\t\t\ttag: 'endpoint.registered',\n\t\t\tendpoint: {\n\t\t\t\tendpointKey: endpointKey(`${pluginKey}:${field}`),\n\t\t\t\tpluginKey,\n\t\t\t\tname,\n\t\t\t\turl: raw,\n\t\t\t\tdisplayUrl: null,\n\t\t\t\twireProtocol: 'http',\n\t\t\t\tregisteredAt,\n\t\t\t},\n\t\t});\n\t}\n\treturn events;\n};\n\nconst isHttpUrl = (value: string): boolean => {\n\ttry {\n\t\tconst parsed = new URL(value);\n\t\treturn parsed.protocol === 'http:' || parsed.protocol === 'https:';\n\t} catch {\n\t\treturn false;\n\t}\n};\n"],"mappings":";;AAgBA,MAAM,kBAAkB;CACvB,KAAK;CACL,QAAQ;CACR,WAAW;CACX,YAAY;CACZ;AAUD,MAAa,8CACZ,WACA,OACA,cACA,UAAgD,EAAE,KACN;AAC5C,KAAI,QAAQ,qBAAqB,KAAM,QAAO,EAAE;AAChD,KAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO,EAAE;CAC1D,MAAM,SAAS;CACf,MAAM,SAAyC,EAAE;AACjD,MAAK,MAAM,CAAC,OAAO,SAAS,OAAO,QAAQ,gBAAgB,EAAE;EAC5D,MAAM,MAAM,OAAO;AACnB,MAAI,OAAO,QAAQ,YAAY,CAAC,UAAU,IAAI,CAAE;AAChD,SAAO,KAAK;GACX,KAAK;GACL,UAAU;IACT,aAAa,YAAY,GAAG,UAAU,GAAG,QAAQ;IACjD;IACA;IACA,KAAK;IACL,YAAY;IACZ,cAAc;IACd;IACA;GACD,CAAC;;AAEH,QAAO;;AAGR,MAAM,aAAa,UAA2B;AAC7C,KAAI;EACH,MAAM,SAAS,IAAI,IAAI,MAAM;AAC7B,SAAO,OAAO,aAAa,WAAW,OAAO,aAAa;SACnD;AACP,SAAO"}

package/dist/substrate/runtime/projection/persisted.mjs

@@ -1,11 +1,13 @@
-import { decodeJsonTextSync } from "../runtime-decode.mjs";
 import { endpointKey, pluginKey } from "../../brand.mjs";
+import { versionedDocSchema } from "../../versioned-doc-schema.mjs";
 import { atomicWriteJson } from "../atomic-write.mjs";
+import { logWarningAndIgnore } from "../observability/ignore-with-log.mjs";
+import { decodeJsonTextSync } from "../runtime-decode.mjs";
 import { Effect, Schema, Stream, SubscriptionRef } from "effect";
 import { existsSync, readFileSync } from "node:fs";
 import * as NodeFileSystem from "@effect/platform-node/NodeFileSystem";
 //#region src/substrate/runtime/projection/persisted.ts
-const PROJECTION_SNAPSHOT_FILE_NAME = "projection.v3.json";
+const PROJECTION_SNAPSHOT_FILE_NAME = "projection.v4.json";
 const projectionSnapshotPath = (stackRoot) => `${stackRoot}/${PROJECTION_SNAPSHOT_FILE_NAME}`;
 const SeveritySchema = Schema.Literals([
 	"warn",
@@ -33,6 +35,14 @@ const CyclePhaseSchema = Schema.Literals([
 	"restarting",
 	"shutting-down"
 ]);
+const RowSectionSchema = Schema.Literals([
+	"service",
+	"package",
+	"account",
+	"action",
+	"app",
+	"other"
+]);
 const StructuredErrorSchema = Schema.Struct({
 	at: Schema.Number,
 	pluginKey: Schema.NullOr(Schema.String),
@@ -43,10 +53,15 @@ const StructuredErrorSchema = Schema.Struct({
 });
 const EndpointSchema = Schema.Struct({
 	endpointKey: Schema.String,
+	pluginKey: Schema.String,
 	name: Schema.String,
 	url: Schema.String,
 	displayUrl: Schema.NullOr(Schema.String),
-	wireProtocol: Schema.String,
+	wireProtocol: Schema.Literals([
+		"http",
+		"h2c",
+		"tcp"
+	]),
 	registeredAt: Schema.Number
 });
 const AccountProjectionSchema = Schema.Struct({
@@ -74,7 +89,11 @@ const AccountProjectionSchema = Schema.Struct({
 			coin: Schema.String,
 			fullCoinType: Schema.String,
 			amount: Schema.String,
-			status: Schema.Literals(["funded", "skipped"])
+			status: Schema.Literals([
+				"funded",
+				"already-satisfied",
+				"skipped"
+			])
 		})))
 	}),
 	walletVisible: Schema.Boolean,
@@ -103,7 +122,9 @@ const RowSchema = Schema.Struct({
 		truncated: Schema.Boolean
 	}),
 	endpoints: Schema.Array(Schema.String),
-	selectiveRestartHighlight: Schema.Boolean
+	selectiveRestartHighlight: Schema.Boolean,
+	section: RowSectionSchema,
+	endpointSection: RowSectionSchema
 });
 const BuildEntrySchema = Schema.Struct({
 	pluginKey: Schema.NullOr(Schema.String),
@@ -111,7 +132,7 @@ const BuildEntrySchema = Schema.Struct({
 	progress: Schema.String,
 	startedAt: Schema.Number
 });
-const SubscribableStateSchema = Schema.Struct({
+const ProjectionSnapshotSchema = versionedDocSchema(4, { state: Schema.Struct({
 	identity: Schema.Struct({
 		app: Schema.String,
 		stack: Schema.String,
@@ -132,11 +153,7 @@ const SubscribableStateSchema = Schema.Struct({
 		at: Schema.Number
 	}),
 	stackBuild: Schema.Array(BuildEntrySchema)
-});
-const ProjectionSnapshotSchema = Schema.Struct({
-	version: Schema.Literal(3),
-	state: SubscribableStateSchema
-});
+}) });
 const rebrandStructuredError = (error) => ({
 	...error,
 	pluginKey: error.pluginKey === null ? null : pluginKey(error.pluginKey)
@@ -151,7 +168,8 @@ const rebrandPersistedState = (state) => ({
 	})),
 	endpoints: state.endpoints.map((endpoint) => ({
 		...endpoint,
-		endpointKey: endpointKey(endpoint.endpointKey)
+		endpointKey: endpointKey(endpoint.endpointKey),
+		pluginKey: pluginKey(endpoint.pluginKey)
 	})),
 	accounts: state.accounts.map((account) => ({
 		...account,
@@ -170,9 +188,9 @@ const rebrandPersistedState = (state) => ({
 	}))
 });
 const writeProjectionSnapshot = (stackRoot, state) => atomicWriteJson(projectionSnapshotPath(stackRoot), ProjectionSnapshotSchema, {
-	version: 3,
+	version: 4,
 	state
-}).pipe(Effect.provide(NodeFileSystem.layer), Effect.catch(() => Effect.void));
+}).pipe(Effect.provide(NodeFileSystem.layer), logWarningAndIgnore("projection snapshot write failed", { path: projectionSnapshotPath(stackRoot) }));
 const persistProjectionChanges = (stackRoot, ref) => Effect.gen(function* () {
 	yield* writeProjectionSnapshot(stackRoot, yield* SubscriptionRef.get(ref));
 	yield* Stream.runForEach(SubscriptionRef.changes(ref), (state) => writeProjectionSnapshot(stackRoot, state));
@@ -190,6 +208,6 @@ const readProjectionSnapshot = (stackRoot) => {
 	}
 };
 //#endregion
-export { persistProjectionChanges, readProjectionSnapshot, writeProjectionSnapshot };
+export { AccountProjectionSchema, PROJECTION_SNAPSHOT_FILE_NAME, PackageProjectionSchema, ProjectionSnapshotSchema, persistProjectionChanges, projectionSnapshotPath, readProjectionSnapshot, writeProjectionSnapshot };
 
 //# sourceMappingURL=persisted.mjs.map

package/dist/substrate/runtime/projection/persisted.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persisted.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/persisted.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\n\nimport { Effect, Schema, Stream, SubscriptionRef } from 'effect';\nimport * as NodeFileSystem from '@effect/platform-node/NodeFileSystem';\n\nimport type { SubscribableState } from '../../projection.ts';\nimport { endpointKey, pluginKey } from '../../brand.ts';\nimport { atomicWriteJson } from '../atomic-write.ts';\nimport { decodeJsonTextSync } from '../runtime-decode.ts';\n\nexport const PROJECTION_SNAPSHOT_FILE_NAME = 'projection.v3.json';\n\nexport const projectionSnapshotPath = (stackRoot: string): string =>\n\t`${stackRoot}/${PROJECTION_SNAPSHOT_FILE_NAME}`;\n\nconst SeveritySchema = Schema.Literals(['warn', 'error', 'fatal']);\nconst LogLevelSchema = Schema.Literals(['info', 'warn', 'error']);\nconst LifecycleStatusSchema = Schema.Literals([\n\t'pending',\n\t'acquiring',\n\t'ready',\n\t'failed',\n\t'stopping',\n\t'stopped',\n\t'done',\n]);\nconst PluginRoleSchema = Schema.Literals(['service', 'task']);\nconst CyclePhaseSchema = Schema.Literals(['booting', 'running', 'restarting', 'shutting-down']);\n\nconst StructuredErrorSchema = Schema.Struct({\n\tat: Schema.Number,\n\tpluginKey: Schema.NullOr(Schema.String),\n\ttag: Schema.String,\n\tsummary: Schema.String,\n\tchain: Schema.Array(Schema.String),\n\tseverity: SeveritySchema,\n});\n\nconst EndpointSchema = Schema.Struct({\n\tendpointKey: Schema.String,\n\tname: Schema.String,\n\turl: Schema.String,\n\tdisplayUrl: Schema.NullOr(Schema.String),\n\twireProtocol: Schema.String,\n\tregisteredAt: Schema.Number,\n});\n\nconst AccountProjectionSchema = Schema.Struct({\n\tkey: Schema.String,\n\trowKey: Schema.NullOr(Schema.String),\n\tname: Schema.String,\n\taddress: Schema.NullOr(Schema.String),\n\tscheme: Schema.NullOr(Schema.Literals(['ed25519', 'secp256k1', 'secp256r1'])),\n\tsource: Schema.NullOr(Schema.Literals(['real', 'impersonate'])),\n\tfunding: Schema.Struct({\n\t\tstatus: Schema.Literals(['pending', 'funded', 'skipped', 'failed', 'unknown']),\n\t\tbalanceMist: Schema.NullOr(Schema.String),\n\t\trequestedMist: Schema.NullOr(Schema.String),\n\t\tentries: Schema.optional(\n\t\t\tSchema.Array(\n\t\t\t\tSchema.Struct({\n\t\t\t\t\tcoin: Schema.String,\n\t\t\t\t\tfullCoinType: Schema.String,\n\t\t\t\t\tamount: Schema.String,\n\t\t\t\t\tstatus: Schema.Literals(['funded', 'skipped']),\n\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t}),\n\twalletVisible: Schema.Boolean,\n\tupdatedAt: Schema.Number,\n});\n\nconst PackageProjectionSchema = Schema.Struct({\n\tkey: Schema.String,\n\trowKey: Schema.NullOr(Schema.String),\n\tname: Schema.String,\n\tkind: Schema.Literals(['local', 'known']),\n\tpackageId: Schema.String,\n\tupgradeCapId: Schema.NullOr(Schema.String),\n\tmvrPlaceholder: Schema.String,\n\tsourcePath: Schema.NullOr(Schema.String),\n\tupdatedAt: Schema.Number,\n});\n\nconst RowSchema = Schema.Struct({\n\tkey: Schema.String,\n\trole: PluginRoleSchema,\n\tstatus: LifecycleStatusSchema,\n\tphase: Schema.NullOr(Schema.String),\n\tlastError: Schema.NullOr(StructuredErrorSchema),\n\tlogTail: Schema.Struct({\n\t\tlines: Schema.Array(Schema.String),\n\t\tlevel: LogLevelSchema,\n\t\ttruncated: Schema.Boolean,\n\t}),\n\tendpoints: Schema.Array(Schema.String),\n\tselectiveRestartHighlight: Schema.Boolean,\n});\n\nconst BuildEntrySchema = Schema.Struct({\n\tpluginKey: Schema.NullOr(Schema.String),\n\tphase: Schema.String,\n\tprogress: Schema.String,\n\tstartedAt: Schema.Number,\n});\n\nconst SubscribableStateSchema = Schema.Struct({\n\tidentity: Schema.Struct({\n\t\tapp: Schema.String,\n\t\tstack: Schema.String,\n\t\tnetwork: Schema.String,\n\t}),\n\tcycle: Schema.Struct({\n\t\tid: Schema.Number,\n\t\tstartedAt: Schema.Number,\n\t\tphase: CyclePhaseSchema,\n\t}),\n\trows: Schema.Array(RowSchema),\n\tendpoints: Schema.Array(EndpointSchema),\n\taccounts: Schema.Array(AccountProjectionSchema),\n\tpackages: Schema.Array(PackageProjectionSchema),\n\terrors: Schema.Array(StructuredErrorSchema),\n\tlastEvent: Schema.Struct({\n\t\tseq: Schema.Number,\n\t\tat: Schema.Number,\n\t}),\n\tstackBuild: Schema.Array(BuildEntrySchema),\n});\n\nexport const ProjectionSnapshotSchema = Schema.Struct({\n\tversion: Schema.Literal(3),\n\tstate: SubscribableStateSchema,\n});\n\ntype PersistedSubscribableState = Schema.Schema.Type<typeof SubscribableStateSchema>;\ntype PersistedStructuredError = PersistedSubscribableState['errors'][number];\n\nconst rebrandStructuredError = (error: PersistedStructuredError) => ({\n\t...error,\n\tpluginKey: error.pluginKey === null ? null : pluginKey(error.pluginKey),\n});\n\nconst rebrandPersistedState = (state: PersistedSubscribableState): SubscribableState => ({\n\t...state,\n\trows: state.rows.map((row) => ({\n\t\t...row,\n\t\tkey: pluginKey(row.key),\n\t\tlastError: row.lastError === null ? null : rebrandStructuredError(row.lastError),\n\t\tendpoints: row.endpoints.map(endpointKey),\n\t})),\n\tendpoints: state.endpoints.map((endpoint) => ({\n\t\t...endpoint,\n\t\tendpointKey: endpointKey(endpoint.endpointKey),\n\t})),\n\taccounts: state.accounts.map((account) => ({\n\t\t...account,\n\t\tkey: account.key as `account/${string}`,\n\t\trowKey: account.rowKey === null ? null : pluginKey(account.rowKey),\n\t})),\n\tpackages: state.packages.map((pkg) => ({\n\t\t...pkg,\n\t\tkey: pkg.key as `package/${string}`,\n\t\trowKey: pkg.rowKey === null ? null : pluginKey(pkg.rowKey),\n\t})),\n\terrors: state.errors.map(rebrandStructuredError),\n\tstackBuild: state.stackBuild.map((entry) => ({\n\t\t...entry,\n\t\tpluginKey: entry.pluginKey === null ? null : pluginKey(entry.pluginKey),\n\t})),\n});\n\nexport const writeProjectionSnapshot = (\n\tstackRoot: string,\n\tstate: SubscribableState,\n): Effect.Effect<void> =>\n\tatomicWriteJson(projectionSnapshotPath(stackRoot), ProjectionSnapshotSchema, {\n\t\tversion: 3 as const,\n\t\tstate,\n\t}).pipe(\n\t\tEffect.provide(NodeFileSystem.layer),\n\t\tEffect.catch(() => Effect.void),\n\t);\n\nexport const persistProjectionChanges = (\n\tstackRoot: string,\n\tref: SubscriptionRef.SubscriptionRef<SubscribableState>,\n): Effect.Effect<void> =>\n\tEffect.gen(function* () {\n\t\tyield* writeProjectionSnapshot(stackRoot, yield* SubscriptionRef.get(ref));\n\t\tyield* Stream.runForEach(SubscriptionRef.changes(ref), (state) =>\n\t\t\twriteProjectionSnapshot(stackRoot, state),\n\t\t);\n\t});\n\nexport const readProjectionSnapshot = (stackRoot: string): SubscribableState | null => {\n\tconst path = projectionSnapshotPath(stackRoot);\n\tif (!existsSync(path)) return null;\n\ttry {\n\t\tconst snapshot = decodeJsonTextSync(ProjectionSnapshotSchema, readFileSync(path, 'utf8'), {\n\t\t\tsource: path,\n\t\t\tmkError: (issue) => issue,\n\t\t});\n\t\treturn rebrandPersistedState(snapshot.state);\n\t} catch {\n\t\treturn null;\n\t}\n};\n"],"mappings":"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"}
+{"version":3,"file":"persisted.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/persisted.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\n\nimport { Effect, Schema, Stream, SubscriptionRef } from 'effect';\nimport * as NodeFileSystem from '@effect/platform-node/NodeFileSystem';\n\nimport type { SubscribableState } from '../../projection.ts';\nimport { endpointKey, pluginKey } from '../../brand.ts';\nimport { versionedDocSchema } from '../../versioned-doc-schema.ts';\nimport { atomicWriteJson } from '../atomic-write.ts';\nimport { logWarningAndIgnore } from '../observability/ignore-with-log.ts';\nimport { decodeJsonTextSync } from '../runtime-decode.ts';\n\nexport const PROJECTION_SNAPSHOT_FILE_NAME = 'projection.v4.json';\n\nexport const projectionSnapshotPath = (stackRoot: string): string =>\n\t`${stackRoot}/${PROJECTION_SNAPSHOT_FILE_NAME}`;\n\nconst SeveritySchema = Schema.Literals(['warn', 'error', 'fatal']);\nconst LogLevelSchema = Schema.Literals(['info', 'warn', 'error']);\nconst LifecycleStatusSchema = Schema.Literals([\n\t'pending',\n\t'acquiring',\n\t'ready',\n\t'failed',\n\t'stopping',\n\t'stopped',\n\t'done',\n]);\nconst PluginRoleSchema = Schema.Literals(['service', 'task']);\nconst CyclePhaseSchema = Schema.Literals(['booting', 'running', 'restarting', 'shutting-down']);\nconst RowSectionSchema = Schema.Literals([\n\t'service',\n\t'package',\n\t'account',\n\t'action',\n\t'app',\n\t'other',\n]);\n\nconst StructuredErrorSchema = Schema.Struct({\n\tat: Schema.Number,\n\tpluginKey: Schema.NullOr(Schema.String),\n\ttag: Schema.String,\n\tsummary: Schema.String,\n\tchain: Schema.Array(Schema.String),\n\tseverity: SeveritySchema,\n});\n\nconst EndpointSchema = Schema.Struct({\n\tendpointKey: Schema.String,\n\tpluginKey: Schema.String,\n\tname: Schema.String,\n\turl: Schema.String,\n\tdisplayUrl: Schema.NullOr(Schema.String),\n\twireProtocol: Schema.Literals(['http', 'h2c', 'tcp']),\n\tregisteredAt: Schema.Number,\n});\n\nexport const AccountProjectionSchema = Schema.Struct({\n\tkey: Schema.String,\n\trowKey: Schema.NullOr(Schema.String),\n\tname: Schema.String,\n\taddress: Schema.NullOr(Schema.String),\n\tscheme: Schema.NullOr(Schema.Literals(['ed25519', 'secp256k1', 'secp256r1'])),\n\tsource: Schema.NullOr(Schema.Literals(['real', 'impersonate'])),\n\tfunding: Schema.Struct({\n\t\tstatus: Schema.Literals(['pending', 'funded', 'skipped', 'failed', 'unknown']),\n\t\tbalanceMist: Schema.NullOr(Schema.String),\n\t\trequestedMist: Schema.NullOr(Schema.String),\n\t\tentries: Schema.optional(\n\t\t\tSchema.Array(\n\t\t\t\tSchema.Struct({\n\t\t\t\t\tcoin: Schema.String,\n\t\t\t\t\tfullCoinType: Schema.String,\n\t\t\t\t\tamount: Schema.String,\n\t\t\t\t\t// Mirrors `AccountProjection.funding.entries[].status` in\n\t\t\t\t\t// `substrate/projection.ts`. `'already-satisfied'` is\n\t\t\t\t\t// the pre-existing-balance short-circuit emitted by the\n\t\t\t\t\t// account funding pass — semantically a success, kept\n\t\t\t\t\t// distinct from `'funded'` so renderers can surface the\n\t\t\t\t\t// cached-vs-fresh distinction.\n\t\t\t\t\tstatus: Schema.Literals(['funded', 'already-satisfied', 'skipped']),\n\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t}),\n\twalletVisible: Schema.Boolean,\n\tupdatedAt: Schema.Number,\n});\n\nexport const PackageProjectionSchema = Schema.Struct({\n\tkey: Schema.String,\n\trowKey: Schema.NullOr(Schema.String),\n\tname: Schema.String,\n\tkind: Schema.Literals(['local', 'known']),\n\tpackageId: Schema.String,\n\tupgradeCapId: Schema.NullOr(Schema.String),\n\tmvrPlaceholder: Schema.String,\n\tsourcePath: Schema.NullOr(Schema.String),\n\tupdatedAt: Schema.Number,\n});\n\nconst RowSchema = Schema.Struct({\n\tkey: Schema.String,\n\trole: PluginRoleSchema,\n\tstatus: LifecycleStatusSchema,\n\tphase: Schema.NullOr(Schema.String),\n\tlastError: Schema.NullOr(StructuredErrorSchema),\n\tlogTail: Schema.Struct({\n\t\tlines: Schema.Array(Schema.String),\n\t\tlevel: LogLevelSchema,\n\t\ttruncated: Schema.Boolean,\n\t}),\n\tendpoints: Schema.Array(Schema.String),\n\tselectiveRestartHighlight: Schema.Boolean,\n\tsection: RowSectionSchema,\n\tendpointSection: RowSectionSchema,\n});\n\nconst BuildEntrySchema = Schema.Struct({\n\tpluginKey: Schema.NullOr(Schema.String),\n\tphase: Schema.String,\n\tprogress: Schema.String,\n\tstartedAt: Schema.Number,\n});\n\nconst SubscribableStateSchema = Schema.Struct({\n\tidentity: Schema.Struct({\n\t\tapp: Schema.String,\n\t\tstack: Schema.String,\n\t\tnetwork: Schema.String,\n\t}),\n\tcycle: Schema.Struct({\n\t\tid: Schema.Number,\n\t\tstartedAt: Schema.Number,\n\t\tphase: CyclePhaseSchema,\n\t}),\n\trows: Schema.Array(RowSchema),\n\tendpoints: Schema.Array(EndpointSchema),\n\taccounts: Schema.Array(AccountProjectionSchema),\n\tpackages: Schema.Array(PackageProjectionSchema),\n\terrors: Schema.Array(StructuredErrorSchema),\n\tlastEvent: Schema.Struct({\n\t\tseq: Schema.Number,\n\t\tat: Schema.Number,\n\t}),\n\tstackBuild: Schema.Array(BuildEntrySchema),\n});\n\nexport const ProjectionSnapshotSchema = versionedDocSchema(4, {\n\tstate: SubscribableStateSchema,\n});\n\ntype PersistedSubscribableState = Schema.Schema.Type<typeof SubscribableStateSchema>;\ntype PersistedStructuredError = PersistedSubscribableState['errors'][number];\n\nconst rebrandStructuredError = (error: PersistedStructuredError) => ({\n\t...error,\n\tpluginKey: error.pluginKey === null ? null : pluginKey(error.pluginKey),\n});\n\nconst rebrandPersistedState = (state: PersistedSubscribableState): SubscribableState => ({\n\t...state,\n\trows: state.rows.map((row) => ({\n\t\t...row,\n\t\tkey: pluginKey(row.key),\n\t\tlastError: row.lastError === null ? null : rebrandStructuredError(row.lastError),\n\t\tendpoints: row.endpoints.map(endpointKey),\n\t})),\n\tendpoints: state.endpoints.map((endpoint) => ({\n\t\t...endpoint,\n\t\tendpointKey: endpointKey(endpoint.endpointKey),\n\t\tpluginKey: pluginKey(endpoint.pluginKey),\n\t})),\n\taccounts: state.accounts.map((account) => ({\n\t\t...account,\n\t\tkey: account.key as `account/${string}`,\n\t\trowKey: account.rowKey === null ? null : pluginKey(account.rowKey),\n\t})),\n\tpackages: state.packages.map((pkg) => ({\n\t\t...pkg,\n\t\tkey: pkg.key as `package/${string}`,\n\t\trowKey: pkg.rowKey === null ? null : pluginKey(pkg.rowKey),\n\t})),\n\terrors: state.errors.map(rebrandStructuredError),\n\tstackBuild: state.stackBuild.map((entry) => ({\n\t\t...entry,\n\t\tpluginKey: entry.pluginKey === null ? null : pluginKey(entry.pluginKey),\n\t})),\n});\n\nexport const writeProjectionSnapshot = (\n\tstackRoot: string,\n\tstate: SubscribableState,\n): Effect.Effect<void> =>\n\tatomicWriteJson(projectionSnapshotPath(stackRoot), ProjectionSnapshotSchema, {\n\t\tversion: 4 as const,\n\t\tstate,\n\t}).pipe(\n\t\tEffect.provide(NodeFileSystem.layer),\n\t\t// Best-effort: a snapshot write failure must not fail the caller\n\t\t// (the projection is a re-derivable read model). But a bare\n\t\t// `Effect.catch(() => Effect.void)` hid disk-full / permission\n\t\t// faults entirely — leave the cause in the log stream (§18) so a\n\t\t// persistently-failing snapshot is diagnosable.\n\t\tlogWarningAndIgnore('projection snapshot write failed', {\n\t\t\tpath: projectionSnapshotPath(stackRoot),\n\t\t}),\n\t);\n\nexport const persistProjectionChanges = (\n\tstackRoot: string,\n\tref: SubscriptionRef.SubscriptionRef<SubscribableState>,\n): Effect.Effect<void> =>\n\tEffect.gen(function* () {\n\t\tyield* writeProjectionSnapshot(stackRoot, yield* SubscriptionRef.get(ref));\n\t\tyield* Stream.runForEach(SubscriptionRef.changes(ref), (state) =>\n\t\t\twriteProjectionSnapshot(stackRoot, state),\n\t\t);\n\t});\n\nexport const readProjectionSnapshot = (stackRoot: string): SubscribableState | null => {\n\tconst path = projectionSnapshotPath(stackRoot);\n\tif (!existsSync(path)) return null;\n\ttry {\n\t\tconst snapshot = decodeJsonTextSync(ProjectionSnapshotSchema, readFileSync(path, 'utf8'), {\n\t\t\tsource: path,\n\t\t\tmkError: (issue) => issue,\n\t\t});\n\t\treturn rebrandPersistedState(snapshot.state);\n\t} catch {\n\t\treturn null;\n\t}\n};\n"],"mappings":"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"}

package/dist/substrate/runtime/projection/state-ref.mjs

@@ -1,4 +1,4 @@
-import { SubscriptionRef } from "effect";
+import { Effect, SubscriptionRef } from "effect";
 //#region src/substrate/runtime/projection/state-ref.ts
 /**
 * Empty initial projection. Cycle starts at `id: 0`, `phase:
@@ -42,7 +42,31 @@ const emptyProjection = () => ({
 * lifetime from engine cycle.
 */
 const makeProjectionRef = () => SubscriptionRef.make(emptyProjection());
+/**
+* Sync-only constructor for the subscribable projection ref. The
+* `runStack(...)` API allocates the ref BEFORE the supervised
+* Effect runs so callers can subscribe to `state.changes` ahead of
+* boot — that allocation path has no Effect runtime to run under and
+* must complete synchronously.
+*
+* Callers that already live inside an Effect should use the
+* Effect-wrapped `makeProjectionRef()` so future changes to the
+* constructor stay Effect-correct without breaking those call
+* sites. This sync variant is pinned at the substrate boundary: any
+* future refactor of `makeProjectionRef` (e.g. layering a `withSpan`
+* or annotation) MUST keep `makeProjectionRefSync` synchronous — if
+* that ever becomes impossible the boot-time call site needs a
+* different signaling strategy (Deferred-handoff), not a silent
+* `Effect.runSync` crash on an async effect.
+*
+* `SubscriptionRef.make` is sync-effect today (no async, no
+* side-effects beyond an `unbounded` `PubSub.unbounded({ replay:
+* 1 })`), so `Effect.runSync` is safe right now; the indirection
+* exists so the constraint is documented at the constructor, not
+* inferred from the caller.
+*/
+const makeProjectionRefSync = () => Effect.runSync(makeProjectionRef());
 //#endregion
-export { makeProjectionRef };
+export { emptyProjection, makeProjectionRef, makeProjectionRefSync };
 
 //# sourceMappingURL=state-ref.mjs.map

package/dist/substrate/runtime/projection/state-ref.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"state-ref.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/state-ref.ts"],"sourcesContent":["// Subscribable projection state-ref.\n//\n// Architecture § Renderer § \"Subscribable projection — exact field\n// enumeration\" (G2) + § \"Renderer mount lifetime vs engine cycle\n// lifetime\" (decision #8). The state-ref is process-scoped (mounted\n// once); the engine cycle re-runs many times and never re-creates the\n// ref. The renderer subscribes once at mount; the engine updates\n// in-place across cycles.\n//\n// The projection's TypeScript shape is enforced closed by\n// `__ProjectionFieldsClosed` in `../../projection.ts`. Adding a\n// display-vocabulary field (`title`, `primary`, `extras`) at this\n// layer would fail to assign into `SubscribableState` — renderers\n// derive those from `rows[*].kind` + display rules.\n\nimport { Effect, SubscriptionRef } from 'effect';\n\nimport type {\n\tBuildEntry,\n\tAccountProjection,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n\tSubscribableState,\n} from '../../projection.ts';\n\n/**\n * Empty initial projection. Cycle starts at `id: 0`, `phase:\n * 'booting'`. Identity fields are placeholder; the engine MUST\n * replace via `update.ts::setIdentity` before any renderer is\n * notified of anything user-visible.\n *\n * The shape here is the entire contract the renderer sees — no\n * service names, no display vocabulary. If a future field needs\n * adding, the architecture-revision discipline kicks in via\n * `__ProjectionFieldsClosed`.\n */\nexport const emptyProjection = (): SubscribableState => ({\n\tidentity: { app: '', stack: '', network: '' },\n\tcycle: { id: 0, startedAt: 0, phase: 'booting' },\n\trows: [],\n\tendpoints: [],\n\taccounts: [],\n\tpackages: [],\n\terrors: [],\n\tlastEvent: { seq: 0, at: 0 },\n\tstackBuild: [],\n});\n\n/**\n * Create the subscribable projection ref. One per process.\n *\n * Engine cycle: the ref outlives the engine cycle. Stop-and-restart\n * keeps the same ref; only `cycle.id` increments. Renderers see a\n * continuous stream — that's the whole point of decoupling renderer\n * lifetime from engine cycle.\n */\nexport const makeProjectionRef = (): Effect.Effect<\n\tSubscriptionRef.SubscriptionRef<SubscribableState>\n> => SubscriptionRef.make(emptyProjection());\n\n/**\n * Compile-time guard: the projection shape MUST NOT contain display\n * vocabulary. These conditional types resolve to `never` (and would\n * fail to assign anywhere they're used) if `title`/`primary`/\n * `extras` were ever added to `SubscribableState` or `Row`.\n *\n * The architecture's invariant becomes a TS error at the boundary\n * — the projection layer can't be wired up if a renderer-display\n * concept leaks into the engine's data model.\n */\ntype _NoDisplayVocabAtTop = 'title' extends keyof SubscribableState\n\t? never\n\t: 'primary' extends keyof SubscribableState\n\t\t? never\n\t\t: 'extras' extends keyof SubscribableState\n\t\t\t? never\n\t\t\t: true;\ntype _NoDisplayVocabInRow = 'title' extends keyof Row\n\t? never\n\t: 'primary' extends keyof Row\n\t\t? never\n\t\t: 'extras' extends keyof Row\n\t\t\t? never\n\t\t\t: true;\nexport type __NoDisplayVocab = _NoDisplayVocabAtTop & _NoDisplayVocabInRow extends true\n\t? true\n\t: never;\n\n// Re-export the sub-types renderers reach for so they don't import\n// across the substrate boundary directly — `state-ref.ts` is the\n// renderer-facing entry point.\nexport type {\n\tAccountProjection,\n\tBuildEntry,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n\tSubscribableState,\n};\n"],"mappings":";;;;;;;;;;;;;AAsCA,MAAa,yBAA4C;CACxD,UAAU;EAAE,KAAK;EAAI,OAAO;EAAI,SAAS;EAAI;CAC7C,OAAO;EAAE,IAAI;EAAG,WAAW;EAAG,OAAO;EAAW;CAChD,MAAM,EAAE;CACR,WAAW,EAAE;CACb,UAAU,EAAE;CACZ,UAAU,EAAE;CACZ,QAAQ,EAAE;CACV,WAAW;EAAE,KAAK;EAAG,IAAI;EAAG;CAC5B,YAAY,EAAE;CACd;;;;;;;;;AAUD,MAAa,0BAER,gBAAgB,KAAK,iBAAiB,CAAC"}
+{"version":3,"file":"state-ref.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/state-ref.ts"],"sourcesContent":["// Subscribable projection state-ref.\n//\n// Architecture § Renderer § \"Subscribable projection — exact field\n// enumeration\" (G2) + § \"Renderer mount lifetime vs engine cycle\n// lifetime\" (decision #8). The state-ref is process-scoped (mounted\n// once); the engine cycle re-runs many times and never re-creates the\n// ref. The renderer subscribes once at mount; the engine updates\n// in-place across cycles.\n//\n// The projection's TypeScript shape is enforced closed by\n// `__ProjectionFieldsClosed` in `../../projection.ts`. Adding a\n// display-vocabulary field (`title`, `primary`, `extras`) at this\n// layer would fail to assign into `SubscribableState` — renderers\n// derive those from `rows[*].kind` + display rules.\n\nimport { Effect, SubscriptionRef } from 'effect';\n\nimport type {\n\tBuildEntry,\n\tAccountProjection,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n\tSubscribableState,\n} from '../../projection.ts';\n\n/**\n * Empty initial projection. Cycle starts at `id: 0`, `phase:\n * 'booting'`. Identity fields are placeholder; the engine MUST\n * replace via `update.ts::setIdentity` before any renderer is\n * notified of anything user-visible.\n *\n * The shape here is the entire contract the renderer sees — no\n * service names, no display vocabulary. If a future field needs\n * adding, the architecture-revision discipline kicks in via\n * `__ProjectionFieldsClosed`.\n */\nexport const emptyProjection = (): SubscribableState => ({\n\tidentity: { app: '', stack: '', network: '' },\n\tcycle: { id: 0, startedAt: 0, phase: 'booting' },\n\trows: [],\n\tendpoints: [],\n\taccounts: [],\n\tpackages: [],\n\terrors: [],\n\tlastEvent: { seq: 0, at: 0 },\n\tstackBuild: [],\n});\n\n/**\n * Create the subscribable projection ref. One per process.\n *\n * Engine cycle: the ref outlives the engine cycle. Stop-and-restart\n * keeps the same ref; only `cycle.id` increments. Renderers see a\n * continuous stream — that's the whole point of decoupling renderer\n * lifetime from engine cycle.\n */\nexport const makeProjectionRef = (): Effect.Effect<\n\tSubscriptionRef.SubscriptionRef<SubscribableState>\n> => SubscriptionRef.make(emptyProjection());\n\n/**\n * Sync-only constructor for the subscribable projection ref. The\n * `runStack(...)` API allocates the ref BEFORE the supervised\n * Effect runs so callers can subscribe to `state.changes` ahead of\n * boot — that allocation path has no Effect runtime to run under and\n * must complete synchronously.\n *\n * Callers that already live inside an Effect should use the\n * Effect-wrapped `makeProjectionRef()` so future changes to the\n * constructor stay Effect-correct without breaking those call\n * sites. This sync variant is pinned at the substrate boundary: any\n * future refactor of `makeProjectionRef` (e.g. layering a `withSpan`\n * or annotation) MUST keep `makeProjectionRefSync` synchronous — if\n * that ever becomes impossible the boot-time call site needs a\n * different signaling strategy (Deferred-handoff), not a silent\n * `Effect.runSync` crash on an async effect.\n *\n * `SubscriptionRef.make` is sync-effect today (no async, no\n * side-effects beyond an `unbounded` `PubSub.unbounded({ replay:\n * 1 })`), so `Effect.runSync` is safe right now; the indirection\n * exists so the constraint is documented at the constructor, not\n * inferred from the caller.\n */\nexport const makeProjectionRefSync = (): SubscriptionRef.SubscriptionRef<SubscribableState> =>\n\tEffect.runSync(makeProjectionRef());\n\n/**\n * Compile-time guard: the projection shape MUST NOT contain display\n * vocabulary. These conditional types resolve to `never` (and would\n * fail to assign anywhere they're used) if `title`/`primary`/\n * `extras` were ever added to `SubscribableState` or `Row`.\n *\n * The architecture's invariant becomes a TS error at the boundary\n * — the projection layer can't be wired up if a renderer-display\n * concept leaks into the engine's data model.\n */\ntype _NoDisplayVocabAtTop = 'title' extends keyof SubscribableState\n\t? never\n\t: 'primary' extends keyof SubscribableState\n\t\t? never\n\t\t: 'extras' extends keyof SubscribableState\n\t\t\t? never\n\t\t\t: true;\ntype _NoDisplayVocabInRow = 'title' extends keyof Row\n\t? never\n\t: 'primary' extends keyof Row\n\t\t? never\n\t\t: 'extras' extends keyof Row\n\t\t\t? never\n\t\t\t: true;\nexport type __NoDisplayVocab = _NoDisplayVocabAtTop & _NoDisplayVocabInRow extends true\n\t? true\n\t: never;\n\n// Re-export the sub-types renderers reach for so they don't import\n// across the substrate boundary directly — `state-ref.ts` is the\n// renderer-facing entry point.\nexport type {\n\tAccountProjection,\n\tBuildEntry,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n\tSubscribableState,\n};\n"],"mappings":";;;;;;;;;;;;;AAsCA,MAAa,yBAA4C;CACxD,UAAU;EAAE,KAAK;EAAI,OAAO;EAAI,SAAS;EAAI;CAC7C,OAAO;EAAE,IAAI;EAAG,WAAW;EAAG,OAAO;EAAW;CAChD,MAAM,EAAE;CACR,WAAW,EAAE;CACb,UAAU,EAAE;CACZ,UAAU,EAAE;CACZ,QAAQ,EAAE;CACV,WAAW;EAAE,KAAK;EAAG,IAAI;EAAG;CAC5B,YAAY,EAAE;CACd;;;;;;;;;AAUD,MAAa,0BAER,gBAAgB,KAAK,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AAyB5C,MAAa,8BACZ,OAAO,QAAQ,mBAAmB,CAAC"}

package/dist/substrate/runtime/projection/update.mjs

@@ -1,5 +1,8 @@
+import { SpanAttr } from "../observability/spans.mjs";
+import { AccountProjectionSchema, PackageProjectionSchema } from "./persisted.mjs";
+import { eventAtOrNull } from "../../event-time.mjs";
 import { applyLifecycleFact, factFromEvent } from "../lifecycle/lifecycle-fact.mjs";
-import { SubscriptionRef } from "effect";
+import { Effect, Schema, SubscriptionRef } from "effect";
 //#region src/substrate/runtime/projection/update.ts
 /** Bounded buffer for the top-level errors list. */
 const MAX_ERRORS_KEPT = 100;
@@ -15,14 +18,24 @@ const MAX_ROW_LOG_LINES = 100;
 * The `tag` switch is exhaustive against `EngineEvent['tag']`; the
 * trailing `_exhaustive: never` causes TS to flag any new tag that
 * isn't handled here.
+*
+* @param prevalidated - Optional pre-flight decode result for
+*   `projection.updated` payloads. When the Effect-aware `updateRef`
+*   seam has already decoded the payload (to drive the warning
+*   emission inside the fiber's logger Layer), it threads the result
+*   here so the reducer doesn't decode the same payload twice on
+*   the hot path. Direct `applyEvent` callers (tests, in-process
+*   projection consumers) leave this undefined and the reducer
+*   re-decodes — the schema is sync + deterministic so the cached
+*   result and a fresh decode agree.
 */
-const applyEvent = (state, event) => {
+const applyEvent = (state, event, prevalidated) => {
 	const withTouched = (next) => ({
 		...state,
 		...next,
 		lastEvent: {
 			seq: state.lastEvent.seq,
-			at: eventAt(event) ?? state.lastEvent.at
+			at: eventAtOrNull(event) ?? state.lastEvent.at
 		}
 	});
 	const fact = factFromEvent(event);
@@ -35,8 +48,10 @@ const applyEvent = (state, event) => {
 			endpoints: upsertEndpoint(state.endpoints, event.endpoint),
 			rows: attachEndpoint(state.rows, event.endpoint)
 		});
-		case "account.updated": return withTouched({ accounts: upsertAccount(state.accounts, event.account) });
-		case "package.updated": return withTouched({ packages: upsertPackage(state.packages, event.package) });
+		case "projection.updated":
+			if (event.kind === "account") return (prevalidated ?? tryDecodeProjectionPayload(AccountProjectionSchema, event.payload)).ok ? withTouched({ accounts: upsertAccount(state.accounts, event.payload) }) : withTouched({});
+			if (event.kind === "package") return (prevalidated ?? tryDecodeProjectionPayload(PackageProjectionSchema, event.payload)).ok ? withTouched({ packages: upsertPackage(state.packages, event.payload) }) : withTouched({});
+			return withTouched({});
 		case "endpoint.released": return withTouched({});
 		case "strategy.registered":
 		case "strategy.unregistered":
@@ -83,6 +98,7 @@ const applyEvent = (state, event) => {
 				selectiveRestartHighlight: false
 			}))
 		});
+		case "engine.orchestrator.dispatchFailed": return withTouched({});
 		default: return state;
 	}
 };
@@ -104,26 +120,75 @@ const declareAccount = (state, account) => ({
 * boundaries.
 *
 * Uses `state.lastEvent.seq + 1` for monotonic per-process counts.
+*
+* Side-channel: when the event is a `projection.updated` with a
+* malformed payload, the reducer drops the slice and we emit a
+* structured warning here, inside the surrounding fiber, so it lands
+* on the fiber's structured-logging path (`Effect.logWarning`). This
+* is the only place in the reducer where a warning is emitted; the
+* pure `applyEvent` reducer never touches the logger.
 */
-const updateRef = (ref, event) => SubscriptionRef.update(ref, (state) => {
-	const next = applyEvent(state, event);
-	return {
-		...next,
-		lastEvent: {
-			seq: state.lastEvent.seq + 1,
-			at: next.lastEvent.at
+const updateRef = (ref, event) => Effect.gen(function* () {
+	let prevalidated;
+	if (event.tag === "projection.updated") {
+		if (event.kind === "account" || event.kind === "package") {
+			prevalidated = tryDecodeProjectionPayload(event.kind === "account" ? AccountProjectionSchema : PackageProjectionSchema, event.payload);
+			if (!prevalidated.ok) yield* Effect.logWarning(`projection.updated: dropping malformed ${event.kind} payload for key=${event.key}`).pipe(Effect.annotateLogs({ [SpanAttr.errorMessage]: formatDecodeIssue(prevalidated.cause) }));
 		}
-	};
+	}
+	yield* SubscriptionRef.update(ref, (state) => {
+		const next = applyEvent(state, event, prevalidated);
+		return {
+			...next,
+			lastEvent: {
+				seq: state.lastEvent.seq + 1,
+				at: next.lastEvent.at
+			}
+		};
+	});
 });
-const eventAt = (event) => {
-	if ("at" in event) return event.at;
-	switch (event.tag) {
-		case "endpoint.registered": return event.endpoint.registeredAt;
-		case "error.reported": return event.error.at;
-		case "build.statusChanged": return event.entry.startedAt;
-		default: return null;
+/**
+* Sync per-kind validator for `projection.updated` payloads. Returns
+* an `ok` decode result on success or a non-`ok` one on decode
+* failure. Pure-data sync: no logger access, no `Effect.runSync` —
+* the reducer is documented as pure, and earlier versions of this
+* seam called `Effect.runSync(Effect.logWarning(...))` outside any
+* fiber context, which logged off-fiber (bypassing the supervisor's
+* structured-logging context). The Effect-aware `updateRef` wrapper
+* now emits the warning inside the fiber so the warning is captured
+* consistently with the rest of the supervisor's logs.
+*
+* On success callers still pass `event.payload` to the upsert (not the
+* decoded copy) — the runtime brand types (`account/${string}`,
+* `package/${string}`) are TS-only and the decoded copy would strip
+* them. The schema acts as a structural guard only.
+*/
+const tryDecodeProjectionPayload = (schema, payload) => {
+	try {
+		return {
+			ok: true,
+			value: Schema.decodeUnknownSync(schema)(payload)
+		};
+	} catch (cause) {
+		return {
+			ok: false,
+			cause
+		};
 	}
 };
+/**
+* Render a `Schema.decodeUnknownSync` throw into a human-readable
+* string for the warn annotation. `SchemaError` in Effect v4 stores
+* the parse issue and exposes `.message` (= `issue.toString()`); using
+* that surfaces the actual decode-issue path/expectation. Fallback to
+* `String(cause)` for non-SchemaError throws (defensive — the schema's
+* sync decoder should always throw `SchemaError`).
+*/
+const formatDecodeIssue = (cause) => {
+	if (Schema.isSchemaError(cause)) return cause.message;
+	if (cause instanceof Error) return cause.message;
+	return String(cause);
+};
 const upsertRow = (rows, key, update) => {
 	const idx = rows.findIndex((r) => r.key === key);
 	if (idx === -1) return rows;
@@ -184,10 +249,9 @@ const upsertPackage = (packages, pkg) => {
 	return next;
 };
 const attachEndpoint = (rows, endpoint) => {
-	const probableKey = endpoint.endpointKey;
-	return rows.map((row) => probableKey.startsWith(row.key) ? row.endpoints.includes(probableKey) ? row : {
+	return rows.map((row) => endpoint.pluginKey === row.key ? row.endpoints.includes(endpoint.endpointKey) ? row : {
 		...row,
-		endpoints: [...row.endpoints, probableKey]
+		endpoints: [...row.endpoints, endpoint.endpointKey]
 	} : row);
 };
 const pushBounded = (xs, value, max) => {
@@ -195,6 +259,6 @@ const pushBounded = (xs, value, max) => {
 	return next.length > max ? next.slice(-max) : next;
 };
 //#endregion
-export { declareAccount, setIdentity, updateRef };
+export { applyEvent, declareAccount, setIdentity, updateRef };
 
 //# sourceMappingURL=update.mjs.map

package/dist/substrate/runtime/projection/update.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"update.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/update.ts"],"sourcesContent":["// Projection updater.\n//\n// Architecture § Renderer § \"Subscribable projection — exact field\n// enumeration\" (G2). The updater is a typed event-handler: each\n// `EngineEvent` produces a structurally-typed projection mutation.\n// Renderers never see the event taxonomy here; they only see the\n// resulting state.\n//\n// The updater is *pure data*: it takes the old state + an event,\n// returns the new state. Atomicity comes from\n// `SubscriptionRef.update` at the call site.\n//\n// Discipline:\n//   - No display vocabulary (`title`, `primary`, `extras`) anywhere\n//     in the produced state.\n//   - All fields the architecture enumerates are reachable; new\n//     event tags are picked up via exhaustive `tag` match (the\n//     `_exhaustive: never` line will fail to type-check if a new\n//     tag is added without a handler here).\n\nimport { Effect, SubscriptionRef } from 'effect';\n\nimport type { PluginKey } from '../../brand.ts';\nimport type { EngineEvent } from '../../events.ts';\nimport type { LifecycleStatus } from '../../lifecycle.ts';\nimport type {\n\tAccountProjection,\n\tBuildEntry,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n\tSubscribableState,\n} from '../../projection.ts';\nimport { applyLifecycleFact, factFromEvent } from '../lifecycle/lifecycle-fact.ts';\n\n// -----------------------------------------------------------------------------\n// Capacity policy\n// -----------------------------------------------------------------------------\n\n/** Bounded buffer for the top-level errors list. */\nconst MAX_ERRORS_KEPT = 100;\n/** Bounded buffer for the top-level build-entries list. */\nconst MAX_BUILD_ENTRIES_KEPT = 200;\n/** Per-row bounded log-tail length. Architecture: default 100 lines. */\nconst MAX_ROW_LOG_LINES = 100;\n\n// -----------------------------------------------------------------------------\n// Pure reducer\n// -----------------------------------------------------------------------------\n\n/**\n * Pure projection reducer. One event in, one new state out. All field\n * writes preserve `readonly` invariants by constructing fresh\n * objects/arrays rather than mutating.\n *\n * The `tag` switch is exhaustive against `EngineEvent['tag']`; the\n * trailing `_exhaustive: never` causes TS to flag any new tag that\n * isn't handled here.\n */\nexport const applyEvent = (state: SubscribableState, event: EngineEvent): SubscribableState => {\n\t// Every event advances `lastEvent.at`. `lastEvent.seq` is bumped at\n\t// the `updateRef` wrapper, not here — this reducer is pure data.\n\tconst withTouched = (next: Partial<SubscribableState>): SubscribableState => ({\n\t\t...state,\n\t\t...next,\n\t\tlastEvent: { seq: state.lastEvent.seq, at: eventAt(event) ?? state.lastEvent.at },\n\t});\n\n\t// Lifecycle-shaped events flow through the typed `LifecycleFact`\n\t// bridge — the projection consumes the merge-not-replace fact\n\t// instead of writing each lifecycle field independently. Non-\n\t// lifecycle events take their original specialised paths below.\n\tconst fact = factFromEvent(event);\n\tif (fact !== null) {\n\t\treturn withTouched({\n\t\t\trows: upsertRow(state.rows, fact.pluginKey as PluginKey, (row) =>\n\t\t\t\tapplyLifecycleFact(row, fact.delta),\n\t\t\t),\n\t\t});\n\t}\n\n\tswitch (event.tag) {\n\t\tcase 'lifecycle.statusChanged':\n\t\tcase 'lifecycle.phaseSet':\n\t\t\t// Handled above via `factFromEvent` — kept in the switch for\n\t\t\t// `_exhaustive` discipline.\n\t\t\treturn withTouched({});\n\n\t\tcase 'log.appended':\n\t\t\treturn withTouched({\n\t\t\t\trows: upsertRow(state.rows, event.pluginKey, (row) =>\n\t\t\t\t\tappendLogLine(row, event.line, event.level),\n\t\t\t\t),\n\t\t\t});\n\n\t\tcase 'endpoint.registered':\n\t\t\treturn withTouched({\n\t\t\t\tendpoints: upsertEndpoint(state.endpoints, event.endpoint),\n\t\t\t\trows: attachEndpoint(state.rows, event.endpoint),\n\t\t\t});\n\n\t\tcase 'account.updated':\n\t\t\treturn withTouched({\n\t\t\t\taccounts: upsertAccount(state.accounts, event.account),\n\t\t\t});\n\n\t\tcase 'package.updated':\n\t\t\treturn withTouched({\n\t\t\t\tpackages: upsertPackage(state.packages, event.package),\n\t\t\t});\n\n\t\tcase 'endpoint.released':\n\t\t\t// Renderer projection keeps endpoint history as last-known\n\t\t\t// operator affordance. A released service may no longer be\n\t\t\t// reachable, but hiding the URL during shutdown/restart makes\n\t\t\t// the TUI lose the most useful debugging handle.\n\t\t\treturn withTouched({});\n\n\t\tcase 'strategy.registered':\n\t\tcase 'strategy.unregistered':\n\t\tcase 'manifest.flushed':\n\t\tcase 'codegen.emitted':\n\t\tcase 'snapshot.captureStarted':\n\t\tcase 'snapshot.captureProgress':\n\t\tcase 'snapshot.captureSkipped':\n\t\tcase 'snapshot.captureFailed':\n\t\tcase 'snapshot.captured':\n\t\tcase 'snapshot.restored':\n\t\t\t// Engine-internal events that don't carry a projection slice\n\t\t\t// — surfaced on the live event stream for renderers that care,\n\t\t\t// but contribute no field to the subscribable state. (Adding\n\t\t\t// a projection field for any of these requires an architecture\n\t\t\t// revision per G2.)\n\t\t\treturn withTouched({});\n\n\t\tcase 'shutdown.escalated':\n\t\t\treturn withTouched({\n\t\t\t\tcycle: { ...state.cycle, phase: 'shutting-down' },\n\t\t\t});\n\n\t\tcase 'error.reported':\n\t\t\treturn withTouched({\n\t\t\t\terrors: pushBounded(state.errors, event.error, MAX_ERRORS_KEPT),\n\t\t\t\trows: event.error.pluginKey\n\t\t\t\t\t? upsertRow(state.rows, event.error.pluginKey, (row) => ({\n\t\t\t\t\t\t\t...row,\n\t\t\t\t\t\t\tlastError: event.error,\n\t\t\t\t\t\t}))\n\t\t\t\t\t: state.rows,\n\t\t\t});\n\n\t\tcase 'build.statusChanged':\n\t\t\treturn withTouched({\n\t\t\t\tstackBuild: pushBounded(state.stackBuild, event.entry, MAX_BUILD_ENTRIES_KEPT),\n\t\t\t});\n\n\t\tcase 'restart.requested':\n\t\t\treturn withTouched({\n\t\t\t\tcycle: { ...state.cycle, phase: 'restarting' },\n\t\t\t\trows:\n\t\t\t\t\tevent.target === 'stack'\n\t\t\t\t\t\t? state.rows.map((r) => ({ ...r, selectiveRestartHighlight: false }))\n\t\t\t\t\t\t: state.rows.map((r) =>\n\t\t\t\t\t\t\t\tr.key === (event.target as { pluginKey: PluginKey }).pluginKey\n\t\t\t\t\t\t\t\t\t? { ...r, selectiveRestartHighlight: true }\n\t\t\t\t\t\t\t\t\t: r,\n\t\t\t\t\t\t\t),\n\t\t\t});\n\n\t\tcase 'restart.completed':\n\t\t\treturn withTouched({\n\t\t\t\tcycle: { ...state.cycle, phase: 'running' },\n\t\t\t\trows: state.rows.map((r) => ({ ...r, selectiveRestartHighlight: false })),\n\t\t\t});\n\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn state;\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Engine-side mutators (not driven by EngineEvent)\n// -----------------------------------------------------------------------------\n\n/**\n * Replace `identity` on the projection. Called once at boot per cycle;\n * does NOT change on hot-restart.\n */\nexport const setIdentity = (\n\tstate: SubscribableState,\n\tidentity: SubscribableState['identity'],\n): SubscribableState => ({ ...state, identity });\n\n/**\n * Bump the cycle counter. Called at the start of each engine cycle.\n * Resets only fields the architecture says are per-cycle:\n *   - `cycle.id`, `cycle.startedAt`, `cycle.phase`\n *   - per-row `selectiveRestartHighlight`\n * The error log, endpoints, build log, and `lastEvent.seq` are\n * intentionally preserved across cycles so the renderer sees\n * continuous history.\n */\nexport const bumpCycle = (\n\tstate: SubscribableState,\n\tnow: number,\n\tphase: SubscribableState['cycle']['phase'] = 'booting',\n): SubscribableState => ({\n\t...state,\n\tcycle: { id: state.cycle.id + 1, startedAt: now, phase },\n\trows: state.rows.map((r) => ({ ...r, selectiveRestartHighlight: false })),\n});\n\n/**\n * Register (or replace) a row in the projection. The supervisor wires\n * the call in.\n */\nexport const declareRow = (state: SubscribableState, row: Row): SubscribableState => {\n\tconst idx = state.rows.findIndex((r) => r.key === row.key);\n\tif (idx === -1) return { ...state, rows: [...state.rows, row] };\n\tconst next = state.rows.slice();\n\tnext[idx] = row;\n\treturn { ...state, rows: next };\n};\n\n/**\n * Drop a row. Used during selective-restart when a plugin is being\n * removed (rare; most restarts replay the same row).\n */\nexport const dropRow = (state: SubscribableState, key: PluginKey): SubscribableState => ({\n\t...state,\n\trows: state.rows.filter((r) => r.key !== key),\n});\n\nexport const declareAccount = (\n\tstate: SubscribableState,\n\taccount: AccountProjection,\n): SubscribableState => ({\n\t...state,\n\taccounts: upsertAccount(state.accounts, account),\n});\n\nexport const declarePackage = (\n\tstate: SubscribableState,\n\tpkg: PackageProjection,\n): SubscribableState => ({\n\t...state,\n\tpackages: upsertPackage(state.packages, pkg),\n});\n\n// -----------------------------------------------------------------------------\n// SubscriptionRef-driven updaters\n// -----------------------------------------------------------------------------\n\n/**\n * Apply an `EngineEvent` to the ref, bumping the sequence number\n * atomically. The seq is monotonic per process and survives cycle\n * boundaries.\n *\n * Uses `state.lastEvent.seq + 1` for monotonic per-process counts.\n */\nexport const updateRef = (\n\tref: SubscriptionRef.SubscriptionRef<SubscribableState>,\n\tevent: EngineEvent,\n): Effect.Effect<void> =>\n\tSubscriptionRef.update(ref, (state) => {\n\t\tconst next = applyEvent(state, event);\n\t\treturn {\n\t\t\t...next,\n\t\t\tlastEvent: { seq: state.lastEvent.seq + 1, at: next.lastEvent.at },\n\t\t};\n\t});\n\n// -----------------------------------------------------------------------------\n// Internals\n// -----------------------------------------------------------------------------\n\nconst eventAt = (event: EngineEvent): number | null => {\n\tif ('at' in event) return event.at;\n\t// Events whose payload nests `at` (endpoint, error, build): pull it\n\t// up. Discriminating purely on `tag` keeps this exhaustive.\n\tswitch (event.tag) {\n\t\tcase 'endpoint.registered':\n\t\t\treturn event.endpoint.registeredAt;\n\t\tcase 'error.reported':\n\t\t\treturn event.error.at;\n\t\tcase 'build.statusChanged':\n\t\t\treturn event.entry.startedAt;\n\t\tdefault:\n\t\t\treturn null;\n\t}\n};\n\nconst upsertRow = (\n\trows: ReadonlyArray<Row>,\n\tkey: PluginKey,\n\tupdate: (row: Row) => Row,\n): ReadonlyArray<Row> => {\n\tconst idx = rows.findIndex((r) => r.key === key);\n\tif (idx === -1) {\n\t\t// Row was never declared. We do NOT auto-create — declaration is\n\t\t// the plugin's job. Drop the event silently; the renderer can't\n\t\t// render a row it doesn't know about.\n\t\treturn rows;\n\t}\n\tconst next = rows.slice();\n\tnext[idx] = update(rows[idx]!);\n\treturn next;\n};\n\nconst appendLogLine = (row: Row, line: string, level: 'info' | 'warn' | 'error'): Row => {\n\tconst nextLines = [...row.logTail.lines, line];\n\tconst truncated = nextLines.length > MAX_ROW_LOG_LINES;\n\tconst trimmed = truncated ? nextLines.slice(-MAX_ROW_LOG_LINES) : nextLines;\n\treturn {\n\t\t...row,\n\t\tlogTail: {\n\t\t\tlines: trimmed,\n\t\t\tlevel: maxLevel(row.logTail.level, level),\n\t\t\ttruncated: row.logTail.truncated || truncated,\n\t\t},\n\t};\n};\n\nconst maxLevel = (\n\ta: 'info' | 'warn' | 'error',\n\tb: 'info' | 'warn' | 'error',\n): 'info' | 'warn' | 'error' => {\n\tconst rank = { info: 0, warn: 1, error: 2 } as const;\n\treturn rank[a] >= rank[b] ? a : b;\n};\n\nconst upsertEndpoint = (\n\tendpoints: ReadonlyArray<Endpoint>,\n\tendpoint: Endpoint,\n): ReadonlyArray<Endpoint> => {\n\tconst idx = endpoints.findIndex((e) => e.endpointKey === endpoint.endpointKey);\n\tif (idx === -1) return [...endpoints, endpoint];\n\tconst next = endpoints.slice();\n\tnext[idx] = endpoint;\n\treturn next;\n};\n\nconst upsertAccount = (\n\taccounts: ReadonlyArray<AccountProjection>,\n\taccount: AccountProjection,\n): ReadonlyArray<AccountProjection> => {\n\tconst idx = accounts.findIndex((entry) => entry.key === account.key);\n\tif (idx === -1) return [...accounts, account];\n\tconst next = accounts.slice();\n\tnext[idx] = {\n\t\t...accounts[idx]!,\n\t\t...account,\n\t\tfunding: {\n\t\t\t...accounts[idx]!.funding,\n\t\t\t...account.funding,\n\t\t},\n\t};\n\treturn next;\n};\n\nconst upsertPackage = (\n\tpackages: ReadonlyArray<PackageProjection>,\n\tpkg: PackageProjection,\n): ReadonlyArray<PackageProjection> => {\n\tconst idx = packages.findIndex((entry) => entry.key === pkg.key);\n\tif (idx === -1) return [...packages, pkg];\n\tconst next = packages.slice();\n\tnext[idx] = {\n\t\t...packages[idx]!,\n\t\t...pkg,\n\t};\n\treturn next;\n};\n\nconst attachEndpoint = (rows: ReadonlyArray<Row>, endpoint: Endpoint): ReadonlyArray<Row> => {\n\t// Endpoint -> Row link is `endpointKey` derived from `pluginKey` + dispatchId.\n\t// The plugin that owns the endpoint must have a row; we look it up by\n\t// the endpoint's pluginKey via a structured field. The current\n\t// `Endpoint` shape (from projection.ts) doesn't carry pluginKey in\n\t// the projection slice — it's derivable from `endpointKey` (prefix match).\n\tconst probableKey = endpoint.endpointKey;\n\treturn rows.map((row) =>\n\t\tprobableKey.startsWith(row.key)\n\t\t\t? row.endpoints.includes(probableKey)\n\t\t\t\t? row\n\t\t\t\t: { ...row, endpoints: [...row.endpoints, probableKey] }\n\t\t\t: row,\n\t);\n};\n\nconst pushBounded = <T>(xs: ReadonlyArray<T>, value: T, max: number): ReadonlyArray<T> => {\n\tconst next = [...xs, value];\n\treturn next.length > max ? next.slice(-max) : next;\n};\n\n// Re-export the bounded-capacity constants for tests / docs.\nexport const __capacities = {\n\tMAX_ERRORS_KEPT,\n\tMAX_BUILD_ENTRIES_KEPT,\n\tMAX_ROW_LOG_LINES,\n} as const;\n\n// Re-export referenced sub-types for downstream consumers (tests,\n// renderer-side wrappers) so they don't reach into substrate/\n// directly.\nexport type {\n\tAccountProjection,\n\tBuildEntry,\n\tEndpoint,\n\tLifecycleStatus,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n};\n"],"mappings":"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"}
+{"version":3,"file":"update.mjs","names":[],"sources":["../../../../src/substrate/runtime/projection/update.ts"],"sourcesContent":["// Projection updater.\n//\n// Architecture § Renderer § \"Subscribable projection — exact field\n// enumeration\" (G2). The updater is a typed event-handler: each\n// `EngineEvent` produces a structurally-typed projection mutation.\n// Renderers never see the event taxonomy here; they only see the\n// resulting state.\n//\n// The updater is *pure data*: it takes the old state + an event,\n// returns the new state. Atomicity comes from\n// `SubscriptionRef.update` at the call site.\n//\n// Discipline:\n//   - No display vocabulary (`title`, `primary`, `extras`) anywhere\n//     in the produced state.\n//   - All fields the architecture enumerates are reachable; new\n//     event tags are picked up via exhaustive `tag` match (the\n//     `_exhaustive: never` line will fail to type-check if a new\n//     tag is added without a handler here).\n\nimport { Effect, Schema, SubscriptionRef } from 'effect';\n\nimport type { PluginKey } from '../../brand.ts';\nimport type { EngineEvent } from '../../events.ts';\nimport { eventAtOrNull } from '../../event-time.ts';\nimport type { LifecycleStatus } from '../../lifecycle.ts';\nimport type {\n\tAccountProjection,\n\tBuildEntry,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n\tSubscribableState,\n} from '../../projection.ts';\nimport { applyLifecycleFact, factFromEvent } from '../lifecycle/lifecycle-fact.ts';\nimport { SpanAttr } from '../observability/spans.ts';\nimport { AccountProjectionSchema, PackageProjectionSchema } from './persisted.ts';\n\n// -----------------------------------------------------------------------------\n// Capacity policy\n// -----------------------------------------------------------------------------\n\n/** Bounded buffer for the top-level errors list. */\nconst MAX_ERRORS_KEPT = 100;\n/** Bounded buffer for the top-level build-entries list. */\nconst MAX_BUILD_ENTRIES_KEPT = 200;\n/** Per-row bounded log-tail length. Architecture: default 100 lines. */\nconst MAX_ROW_LOG_LINES = 100;\n\n// -----------------------------------------------------------------------------\n// Decode-result type — shared between the reducer's optional pre-flight\n// cache and the `tryDecodeProjectionPayload` helper. Hoisted above the\n// reducer so the optional `prevalidated` parameter can reference it.\n// -----------------------------------------------------------------------------\n\ntype DecodeResult<T> =\n\t| { readonly ok: true; readonly value: T }\n\t| { readonly ok: false; readonly cause: unknown };\n\n// -----------------------------------------------------------------------------\n// Pure reducer\n// -----------------------------------------------------------------------------\n\n/**\n * Pure projection reducer. One event in, one new state out. All field\n * writes preserve `readonly` invariants by constructing fresh\n * objects/arrays rather than mutating.\n *\n * The `tag` switch is exhaustive against `EngineEvent['tag']`; the\n * trailing `_exhaustive: never` causes TS to flag any new tag that\n * isn't handled here.\n *\n * @param prevalidated - Optional pre-flight decode result for\n *   `projection.updated` payloads. When the Effect-aware `updateRef`\n *   seam has already decoded the payload (to drive the warning\n *   emission inside the fiber's logger Layer), it threads the result\n *   here so the reducer doesn't decode the same payload twice on\n *   the hot path. Direct `applyEvent` callers (tests, in-process\n *   projection consumers) leave this undefined and the reducer\n *   re-decodes — the schema is sync + deterministic so the cached\n *   result and a fresh decode agree.\n */\nexport const applyEvent = (\n\tstate: SubscribableState,\n\tevent: EngineEvent,\n\tprevalidated?: DecodeResult<unknown>,\n): SubscribableState => {\n\t// Every event advances `lastEvent.at`. `lastEvent.seq` is bumped at\n\t// the `updateRef` wrapper, not here — this reducer is pure data.\n\tconst withTouched = (next: Partial<SubscribableState>): SubscribableState => ({\n\t\t...state,\n\t\t...next,\n\t\tlastEvent: { seq: state.lastEvent.seq, at: eventAtOrNull(event) ?? state.lastEvent.at },\n\t});\n\n\t// Lifecycle-shaped events flow through the typed `LifecycleFact`\n\t// bridge — the projection consumes the merge-not-replace fact\n\t// instead of writing each lifecycle field independently. Non-\n\t// lifecycle events take their original specialised paths below.\n\tconst fact = factFromEvent(event);\n\tif (fact !== null) {\n\t\treturn withTouched({\n\t\t\trows: upsertRow(state.rows, fact.pluginKey, (row) => applyLifecycleFact(row, fact.delta)),\n\t\t});\n\t}\n\n\tswitch (event.tag) {\n\t\tcase 'lifecycle.statusChanged':\n\t\tcase 'lifecycle.phaseSet':\n\t\t\t// Handled above via `factFromEvent` — kept in the switch for\n\t\t\t// `_exhaustive` discipline.\n\t\t\treturn withTouched({});\n\n\t\tcase 'log.appended':\n\t\t\treturn withTouched({\n\t\t\t\trows: upsertRow(state.rows, event.pluginKey, (row) =>\n\t\t\t\t\tappendLogLine(row, event.line, event.level),\n\t\t\t\t),\n\t\t\t});\n\n\t\tcase 'endpoint.registered':\n\t\t\treturn withTouched({\n\t\t\t\tendpoints: upsertEndpoint(state.endpoints, event.endpoint),\n\t\t\t\trows: attachEndpoint(state.rows, event.endpoint),\n\t\t\t});\n\n\t\tcase 'projection.updated':\n\t\t\t// Substrate stays name-blind on the event vocabulary; the\n\t\t\t// reducer is the projection orchestrator and owns the per-\n\t\t\t// `kind` decode. New plugin-author projection kinds slot in\n\t\t\t// here without a new event variant — extending this switch\n\t\t\t// is the load-bearing knob.\n\t\t\t//\n\t\t\t// Per STYLE_GUIDE §20: a misbehaving plugin emitting a\n\t\t\t// malformed payload must NOT crash the reducer or the\n\t\t\t// surrounding projection stream. Decode per-kind via the\n\t\t\t// canonical Schema; on failure, drop the slice update\n\t\t\t// (`lastEvent.at` still advances so the renderer sees the\n\t\t\t// event was observed). Warning emission is handled by the\n\t\t\t// Effect-aware seam at the `updateRef` call site so it runs\n\t\t\t// inside the fiber's structured-logging context — the\n\t\t\t// reducer itself stays pure-data sync (no logger access),\n\t\t\t// just signaling a decode failure via a non-`ok` decode\n\t\t\t// result.\n\t\t\tif (event.kind === 'account') {\n\t\t\t\tconst decoded =\n\t\t\t\t\tprevalidated ?? tryDecodeProjectionPayload(AccountProjectionSchema, event.payload);\n\t\t\t\t// `event.payload` (not `decoded.value`) is forwarded once the\n\t\t\t\t// schema has confirmed the structural shape — the runtime brand\n\t\t\t\t// (`account/${string}`) is TS-only and Schema can't express\n\t\t\t\t// it. The cast is justified by the preceding decode, not a\n\t\t\t\t// `Schema.decodeUnknownSync(...) as A` bare-cast (§20).\n\t\t\t\treturn decoded.ok\n\t\t\t\t\t? withTouched({\n\t\t\t\t\t\t\taccounts: upsertAccount(state.accounts, event.payload as AccountProjection),\n\t\t\t\t\t\t})\n\t\t\t\t\t: withTouched({});\n\t\t\t}\n\t\t\tif (event.kind === 'package') {\n\t\t\t\tconst decoded =\n\t\t\t\t\tprevalidated ?? tryDecodeProjectionPayload(PackageProjectionSchema, event.payload);\n\t\t\t\treturn decoded.ok\n\t\t\t\t\t? withTouched({\n\t\t\t\t\t\t\tpackages: upsertPackage(state.packages, event.payload as PackageProjection),\n\t\t\t\t\t\t})\n\t\t\t\t\t: withTouched({});\n\t\t\t}\n\t\t\treturn withTouched({});\n\n\t\tcase 'endpoint.released':\n\t\t\t// Renderer projection keeps endpoint history as last-known\n\t\t\t// operator affordance. A released service may no longer be\n\t\t\t// reachable, but hiding the URL during shutdown/restart makes\n\t\t\t// the TUI lose the most useful debugging handle.\n\t\t\treturn withTouched({});\n\n\t\tcase 'strategy.registered':\n\t\tcase 'strategy.unregistered':\n\t\tcase 'manifest.flushed':\n\t\tcase 'codegen.emitted':\n\t\tcase 'snapshot.captureStarted':\n\t\tcase 'snapshot.captureProgress':\n\t\tcase 'snapshot.captureSkipped':\n\t\tcase 'snapshot.captureFailed':\n\t\tcase 'snapshot.captured':\n\t\tcase 'snapshot.restored':\n\t\t\t// Engine-internal events that don't carry a projection slice\n\t\t\t// — surfaced on the live event stream for renderers that care,\n\t\t\t// but contribute no field to the subscribable state. (Adding\n\t\t\t// a projection field for any of these requires an architecture\n\t\t\t// revision per G2.)\n\t\t\treturn withTouched({});\n\n\t\tcase 'shutdown.escalated':\n\t\t\treturn withTouched({\n\t\t\t\tcycle: { ...state.cycle, phase: 'shutting-down' },\n\t\t\t});\n\n\t\tcase 'error.reported':\n\t\t\treturn withTouched({\n\t\t\t\terrors: pushBounded(state.errors, event.error, MAX_ERRORS_KEPT),\n\t\t\t\trows: event.error.pluginKey\n\t\t\t\t\t? upsertRow(state.rows, event.error.pluginKey, (row) => ({\n\t\t\t\t\t\t\t...row,\n\t\t\t\t\t\t\tlastError: event.error,\n\t\t\t\t\t\t}))\n\t\t\t\t\t: state.rows,\n\t\t\t});\n\n\t\tcase 'build.statusChanged':\n\t\t\treturn withTouched({\n\t\t\t\tstackBuild: pushBounded(state.stackBuild, event.entry, MAX_BUILD_ENTRIES_KEPT),\n\t\t\t});\n\n\t\tcase 'restart.requested':\n\t\t\treturn withTouched({\n\t\t\t\tcycle: { ...state.cycle, phase: 'restarting' },\n\t\t\t\trows:\n\t\t\t\t\tevent.target === 'stack'\n\t\t\t\t\t\t? state.rows.map((r) => ({ ...r, selectiveRestartHighlight: false }))\n\t\t\t\t\t\t: state.rows.map((r) =>\n\t\t\t\t\t\t\t\tr.key === (event.target as { pluginKey: PluginKey }).pluginKey\n\t\t\t\t\t\t\t\t\t? { ...r, selectiveRestartHighlight: true }\n\t\t\t\t\t\t\t\t\t: r,\n\t\t\t\t\t\t\t),\n\t\t\t});\n\n\t\tcase 'restart.completed':\n\t\t\treturn withTouched({\n\t\t\t\tcycle: { ...state.cycle, phase: 'running' },\n\t\t\t\trows: state.rows.map((r) => ({ ...r, selectiveRestartHighlight: false })),\n\t\t\t});\n\n\t\tcase 'engine.orchestrator.dispatchFailed':\n\t\t\t// Orchestrator-side dispatch failure surfaced for renderers /\n\t\t\t// log consumers; carries no projection slice (the originating\n\t\t\t// plugin remains in its current lifecycle state — sink failure\n\t\t\t// is orchestrator-fault, not plugin-fault).\n\t\t\treturn withTouched({});\n\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn state;\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Engine-side mutators (not driven by EngineEvent)\n// -----------------------------------------------------------------------------\n\n/**\n * Replace `identity` on the projection. Called once at boot per cycle;\n * does NOT change on hot-restart.\n */\nexport const setIdentity = (\n\tstate: SubscribableState,\n\tidentity: SubscribableState['identity'],\n): SubscribableState => ({ ...state, identity });\n\n/**\n * Bump the cycle counter. Called at the start of each engine cycle.\n * Resets only fields the architecture says are per-cycle:\n *   - `cycle.id`, `cycle.startedAt`, `cycle.phase`\n *   - per-row `selectiveRestartHighlight`\n * The error log, endpoints, build log, and `lastEvent.seq` are\n * intentionally preserved across cycles so the renderer sees\n * continuous history.\n */\nexport const bumpCycle = (\n\tstate: SubscribableState,\n\tnow: number,\n\tphase: SubscribableState['cycle']['phase'] = 'booting',\n): SubscribableState => ({\n\t...state,\n\tcycle: { id: state.cycle.id + 1, startedAt: now, phase },\n\trows: state.rows.map((r) => ({ ...r, selectiveRestartHighlight: false })),\n});\n\n/**\n * Register (or replace) a row in the projection. The supervisor wires\n * the call in.\n */\nexport const declareRow = (state: SubscribableState, row: Row): SubscribableState => {\n\tconst idx = state.rows.findIndex((r) => r.key === row.key);\n\tif (idx === -1) return { ...state, rows: [...state.rows, row] };\n\tconst next = state.rows.slice();\n\tnext[idx] = row;\n\treturn { ...state, rows: next };\n};\n\n/**\n * Drop a row. Used during selective-restart when a plugin is being\n * removed (rare; most restarts replay the same row).\n */\nexport const dropRow = (state: SubscribableState, key: PluginKey): SubscribableState => ({\n\t...state,\n\trows: state.rows.filter((r) => r.key !== key),\n});\n\nexport const declareAccount = (\n\tstate: SubscribableState,\n\taccount: AccountProjection,\n): SubscribableState => ({\n\t...state,\n\taccounts: upsertAccount(state.accounts, account),\n});\n\nexport const declarePackage = (\n\tstate: SubscribableState,\n\tpkg: PackageProjection,\n): SubscribableState => ({\n\t...state,\n\tpackages: upsertPackage(state.packages, pkg),\n});\n\n// -----------------------------------------------------------------------------\n// SubscriptionRef-driven updaters\n// -----------------------------------------------------------------------------\n\n/**\n * Apply an `EngineEvent` to the ref, bumping the sequence number\n * atomically. The seq is monotonic per process and survives cycle\n * boundaries.\n *\n * Uses `state.lastEvent.seq + 1` for monotonic per-process counts.\n *\n * Side-channel: when the event is a `projection.updated` with a\n * malformed payload, the reducer drops the slice and we emit a\n * structured warning here, inside the surrounding fiber, so it lands\n * on the fiber's structured-logging path (`Effect.logWarning`). This\n * is the only place in the reducer where a warning is emitted; the\n * pure `applyEvent` reducer never touches the logger.\n */\nexport const updateRef = (\n\tref: SubscriptionRef.SubscriptionRef<SubscribableState>,\n\tevent: EngineEvent,\n): Effect.Effect<void> =>\n\tEffect.gen(function* () {\n\t\t// Pre-flight: detect malformed projection-updated payloads so the\n\t\t// warning runs inside the fiber's logger context. We thread the\n\t\t// decode result into the reducer below so the hot path decodes\n\t\t// the payload exactly once per event — the previous shape ran\n\t\t// the same `Schema.decodeUnknownSync` pass twice (once here,\n\t\t// once inside `applyEvent`) on every projection.updated event.\n\t\tlet prevalidated: DecodeResult<unknown> | undefined;\n\t\tif (event.tag === 'projection.updated') {\n\t\t\tif (event.kind === 'account' || event.kind === 'package') {\n\t\t\t\tconst schema = event.kind === 'account' ? AccountProjectionSchema : PackageProjectionSchema;\n\t\t\t\tprevalidated = tryDecodeProjectionPayload(schema, event.payload);\n\t\t\t\tif (!prevalidated.ok) {\n\t\t\t\t\tyield* Effect.logWarning(\n\t\t\t\t\t\t`projection.updated: dropping malformed ${event.kind} payload for key=${event.key}`,\n\t\t\t\t\t).pipe(\n\t\t\t\t\t\tEffect.annotateLogs({\n\t\t\t\t\t\t\t[SpanAttr.errorMessage]: formatDecodeIssue(prevalidated.cause),\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tyield* SubscriptionRef.update(ref, (state) => {\n\t\t\tconst next = applyEvent(state, event, prevalidated);\n\t\t\treturn {\n\t\t\t\t...next,\n\t\t\t\tlastEvent: { seq: state.lastEvent.seq + 1, at: next.lastEvent.at },\n\t\t\t};\n\t\t});\n\t});\n\n// -----------------------------------------------------------------------------\n// Internals\n// -----------------------------------------------------------------------------\n\n/**\n * Sync per-kind validator for `projection.updated` payloads. Returns\n * an `ok` decode result on success or a non-`ok` one on decode\n * failure. Pure-data sync: no logger access, no `Effect.runSync` —\n * the reducer is documented as pure, and earlier versions of this\n * seam called `Effect.runSync(Effect.logWarning(...))` outside any\n * fiber context, which logged off-fiber (bypassing the supervisor's\n * structured-logging context). The Effect-aware `updateRef` wrapper\n * now emits the warning inside the fiber so the warning is captured\n * consistently with the rest of the supervisor's logs.\n *\n * On success callers still pass `event.payload` to the upsert (not the\n * decoded copy) — the runtime brand types (`account/${string}`,\n * `package/${string}`) are TS-only and the decoded copy would strip\n * them. The schema acts as a structural guard only.\n */\nconst tryDecodeProjectionPayload = <S extends Schema.Decoder<unknown>>(\n\tschema: S,\n\tpayload: unknown,\n): DecodeResult<S['Type']> => {\n\ttry {\n\t\treturn { ok: true, value: Schema.decodeUnknownSync(schema)(payload) };\n\t} catch (cause) {\n\t\treturn { ok: false, cause };\n\t}\n};\n\n/**\n * Render a `Schema.decodeUnknownSync` throw into a human-readable\n * string for the warn annotation. `SchemaError` in Effect v4 stores\n * the parse issue and exposes `.message` (= `issue.toString()`); using\n * that surfaces the actual decode-issue path/expectation. Fallback to\n * `String(cause)` for non-SchemaError throws (defensive — the schema's\n * sync decoder should always throw `SchemaError`).\n */\nconst formatDecodeIssue = (cause: unknown): string => {\n\tif (Schema.isSchemaError(cause)) {\n\t\treturn cause.message;\n\t}\n\tif (cause instanceof Error) {\n\t\treturn cause.message;\n\t}\n\treturn String(cause);\n};\n\nconst upsertRow = (\n\trows: ReadonlyArray<Row>,\n\tkey: PluginKey,\n\tupdate: (row: Row) => Row,\n): ReadonlyArray<Row> => {\n\tconst idx = rows.findIndex((r) => r.key === key);\n\tif (idx === -1) {\n\t\t// Row was never declared. We do NOT auto-create — declaration is\n\t\t// the plugin's job. Drop the event silently; the renderer can't\n\t\t// render a row it doesn't know about.\n\t\treturn rows;\n\t}\n\tconst next = rows.slice();\n\tnext[idx] = update(rows[idx]!);\n\treturn next;\n};\n\nconst appendLogLine = (row: Row, line: string, level: 'info' | 'warn' | 'error'): Row => {\n\tconst nextLines = [...row.logTail.lines, line];\n\tconst truncated = nextLines.length > MAX_ROW_LOG_LINES;\n\tconst trimmed = truncated ? nextLines.slice(-MAX_ROW_LOG_LINES) : nextLines;\n\treturn {\n\t\t...row,\n\t\tlogTail: {\n\t\t\tlines: trimmed,\n\t\t\tlevel: maxLevel(row.logTail.level, level),\n\t\t\ttruncated: row.logTail.truncated || truncated,\n\t\t},\n\t};\n};\n\nconst maxLevel = (\n\ta: 'info' | 'warn' | 'error',\n\tb: 'info' | 'warn' | 'error',\n): 'info' | 'warn' | 'error' => {\n\tconst rank = { info: 0, warn: 1, error: 2 } as const;\n\treturn rank[a] >= rank[b] ? a : b;\n};\n\nconst upsertEndpoint = (\n\tendpoints: ReadonlyArray<Endpoint>,\n\tendpoint: Endpoint,\n): ReadonlyArray<Endpoint> => {\n\tconst idx = endpoints.findIndex((e) => e.endpointKey === endpoint.endpointKey);\n\tif (idx === -1) return [...endpoints, endpoint];\n\tconst next = endpoints.slice();\n\tnext[idx] = endpoint;\n\treturn next;\n};\n\nconst upsertAccount = (\n\taccounts: ReadonlyArray<AccountProjection>,\n\taccount: AccountProjection,\n): ReadonlyArray<AccountProjection> => {\n\tconst idx = accounts.findIndex((entry) => entry.key === account.key);\n\tif (idx === -1) return [...accounts, account];\n\tconst next = accounts.slice();\n\tnext[idx] = {\n\t\t...accounts[idx]!,\n\t\t...account,\n\t\tfunding: {\n\t\t\t...accounts[idx]!.funding,\n\t\t\t...account.funding,\n\t\t},\n\t};\n\treturn next;\n};\n\nconst upsertPackage = (\n\tpackages: ReadonlyArray<PackageProjection>,\n\tpkg: PackageProjection,\n): ReadonlyArray<PackageProjection> => {\n\tconst idx = packages.findIndex((entry) => entry.key === pkg.key);\n\tif (idx === -1) return [...packages, pkg];\n\tconst next = packages.slice();\n\tnext[idx] = {\n\t\t...packages[idx]!,\n\t\t...pkg,\n\t};\n\treturn next;\n};\n\nconst attachEndpoint = (rows: ReadonlyArray<Row>, endpoint: Endpoint): ReadonlyArray<Row> => {\n\treturn rows.map((row) =>\n\t\tendpoint.pluginKey === row.key\n\t\t\t? row.endpoints.includes(endpoint.endpointKey)\n\t\t\t\t? row\n\t\t\t\t: { ...row, endpoints: [...row.endpoints, endpoint.endpointKey] }\n\t\t\t: row,\n\t);\n};\n\nconst pushBounded = <T>(xs: ReadonlyArray<T>, value: T, max: number): ReadonlyArray<T> => {\n\tconst next = [...xs, value];\n\treturn next.length > max ? next.slice(-max) : next;\n};\n\n// Re-export the bounded-capacity constants for tests / docs.\nexport const __capacities = {\n\tMAX_ERRORS_KEPT,\n\tMAX_BUILD_ENTRIES_KEPT,\n\tMAX_ROW_LOG_LINES,\n} as const;\n\n// Re-export referenced sub-types for downstream consumers (tests,\n// renderer-side wrappers) so they don't reach into substrate/\n// directly.\nexport type {\n\tAccountProjection,\n\tBuildEntry,\n\tEndpoint,\n\tLifecycleStatus,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n};\n"],"mappings":"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"}