From 515dda592ec848f526cc9f1b48a135685c3ee323 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 17:53:26 +0100 Subject: [PATCH 01/19] docs(harness): plan bounded child and service process shutdown --- .../context-pack.md | 3 +++ .../drift.md | 5 +++++ .../plan.md | 22 +++++++++++++++++++ .../research.md | 9 ++++++++ .../supervisor.md | 6 +++++ .../worklog.md | 14 ++++++++++++ 6 files changed, 59 insertions(+) create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/research.md create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/supervisor.md create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md new file mode 100644 index 0000000000..130c6412f8 --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -0,0 +1,3 @@ +# Context pack + +Issues #2630/#2631, main b0eb07957, branch fix/runtime-child-drain. Research/plan drafted, real Redis subprocess reproduction in progress, PLAN-EVAL required before implementation. Generated glue changes require one full scaffold.runtime smoke at the end. Do not merge or publish. No modifications under plugin-sagas-core/src/transports. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md new file mode 100644 index 0000000000..f31fdce11d --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -0,0 +1,5 @@ +# Drift + +- Owner-selected existing implementation session uses Sol xhigh. All subsequent eval routes follow the pinned matrix with session/family independence. +- Current main exposes explicit service hostname options, not the environment convention claimed by #2631. Reuse native hostname option and document this evidence. +- Deno KV alone is not a process-retaining handle in this environment; use real Redis sockets to test the reported lifecycle failure. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md new file mode 100644 index 0000000000..f0310ceb58 --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md @@ -0,0 +1,22 @@ +# Plan + +## Locked scope and contracts + +Resolve #2630 and #2631 together. No merge/publication, no saga transport modifications, no Redis Streams dependency. + +1. ChildHealthProcessOptions gains hostname (default loopback, explicit override), drainTimeoutMs (30 s drain), bounded onShutdown hooks, and exitOnShutdown (default true for process ownership; false for embedded/tests). Preserve the one-second observable fatal-health grace. Exit 0 clean, 1 fatal/cleanup failure, 2 drain timeout. Drain and cleanup deadlines and the maximum total must be documented. +2. Service signal shutdown ends the process with the same exit-code vocabulary after drain and resource cleanup. Manual stop and external cancellation remain embeddable; an explicit exitOnSignal option lets a host retain process ownership. Shutdown hook failures are nonzero. Hooks are attempted on timeout rather than skipped; a separately bounded cleanup phase prevents one hook from hanging process termination. Existing LIFO ordering and idempotency remain. +3. Close process-owned shared KV (and its Redis client/subscriber) on executable-role signal shutdown. Add explicit cleanup callbacks to generated background glue. Generated host bootstrap tracks only DB clients it actually acquired and provides an idempotent disposal callback; never resolve an unused DB merely to close it. Add optional disposal to PluginServiceContext so generated service entrypoints can register owner-provided cleanup. Native caller-owned contexts stay untouched unless their host explicitly supplies disposal. +4. Prisma cleanup covers every acquired client, deduplicated by identity, not only the health-check client. Standard sagas background wiring must dispose its acquired host DB context as well as shared KV. Implement at composition roots; do not close opaque caller resources from generic library stop methods. +5. OTel's SIGTERM flush must not Deno.exit ahead of the runtime drain. Its shutdown remains bounded and listener removal is retained. + +## Design and slices + +S1: subprocess regressions with real Redis proving retained handles and distinct clean/timeout exits; child bind address tests. S2: process contracts/lifecycle and service signal ownership, scoped gates. S3: generated role cleanup/ownership and docs, generator tests. S4: one full scaffold.runtime smoke with cleanup, gate/evaluation handoff. +No speculative lifecycle registry or new dependency; prefer callback contracts and existing shutdown hooks, Promise.withResolvers/AbortSignal/AsyncDisposableStack where useful. + +## Gates and risks + +Structured focused test/check/lint/fmt, affected package tests, quality:gate, JSR audits/doc-lint with baseline comparison, release:preflight, docs:accuracy. Full one-pass CLI scaffold.runtime E2E at the end because generated runtime glue changes. Leak-check and teardown preview before owned cleanup; preserve all foreign resources. +Risk: closing embedded shared resources -> process ownership and explicit disposal callbacks. Risk: hanging cleanup -> bounded cleanup, nonzero exit. Risk: fatal health disappearing -> retain existing grace before cleanup. Risk: losing in-flight work -> close stores after runtime drain, not at signal receipt. Cleanup budget and any ownership refinements must be settled by PLAN-EVAL before implementation. +No existing debt deepened; no broad refactor. Deferred: workers pause/delivery-budget feature, saga SSE log, all other milestone fixes. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/research.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/research.md new file mode 100644 index 0000000000..d2d3aa5b28 --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/research.md @@ -0,0 +1,9 @@ +# Research + +Read both issues in full and fetched origin/main before product inspection. Main is still the evidence baseline b0eb07957. +Child health uses Deno.serve({port}) and a signal abort followed by unbounded completion; only fatal paths set exitCode. Service shutdown bounds HTTP/hooks but does not terminate on signals. KV close has no process integration. Prisma cleanup in defineService covers only the health client. OTel has its own SIGTERM handler that exits early. +Plugin service factories support explicit native ServeOptions.hostname; contrary to the issue's historical wording, current main has no hostname environment fallback. Reuse explicit hostname on child options, default 127.0.0.1; add an explicit environment fallback only if generated container wiring needs it. +Deno KV alone does not retain the process: an eval with getKv(:memory:) exits normally. Redis/ioredis sockets are the concrete suspected retained handle. A real, isolated Redis test resource owned by this lane is used for subprocess reproduction; no foreign resources are touched. +Generated background glue lives in each plugin's adapter resources. Generated host service context lazily resolves KV and DB clients through project-owned accessors. Native factories also support host-owned embedded dependencies; manual stop must not dispose those globally. +Archetype 3 runtime with plugin/CLI and service overlays; existing service/workers doctrine Refactor verdicts do not authorize unrelated restructuring. No saga transport changes. +JSR plan audit: explicit option types and documented fields, no upstream re-exports or new external dependencies. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/supervisor.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/supervisor.md new file mode 100644 index 0000000000..03b3530e3f --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/supervisor.md @@ -0,0 +1,6 @@ +# Implementation lane + +Issues #2630 and #2631; branch `fix/runtime-child-drain`; base origin/main b0eb079575968e843b781579673c9fe2ae250e07. +Generator: existing owner-selected Codex Sol xhigh session. Workload tier: feature, role implementation. Combined because both issues modify the child process edge; release/runtime and ownership decisions require PLAN-EVAL. +Pinned matrix PLAN-EVAL: glm_5_3/provider_default, fallback fable_5_1/low. IMPL-EVAL: muse_spark_1_3/xhigh, fallback opus_5/xhigh. All evaluation sessions must differ from the generator's vendor family. +Operator paths/session IDs omitted under the owner's public repository restrictions. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md new file mode 100644 index 0000000000..26b7851ddd --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -0,0 +1,14 @@ +# Worklog + +## Design + +Public surface: ChildHealthProcessOptions process/hostname/cleanup options; ServeOptions process-signal ownership; optional PluginServiceContext disposal callback at owner composition edges. Domain states: existing child health and shutdown report; process exit constants clean=0/fatal=1/timeout=2. Existing ports retained, no new generic registry. +Lifecycle: signal -> stop intake/drain -> bounded owned resource cleanup -> remove signal listeners/health server -> defined process exit. Library manual stop remains callable and does not terminate an embedding host. +Contributor path: child presentation edge, service shutdown coordinator/listener, generated host bootstrap and per-plugin glue. Tests colocated at lifecycle seams with subprocess boundary assertions. +S1-S4 and gates are enumerated in plan.md. PLAN-EVAL selected: runtime exit semantics and generated ownership cross package boundaries. + +## Evidence + +- Current base confirmed after fetch. +- Deno KV alone exits without explicit close; real Redis subprocess regressions are being run before product modification. +- rtk/rg unavailable; commands run directly as node. No operator environment values retained. From 5c671c562d59cae1d453f72f0024a7c16b3d6e89 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 17:56:55 +0100 Subject: [PATCH 02/19] docs(harness): record Redis-backed process exit reproduction --- .../context-pack.md | 2 ++ .../leak-report.md | 3 +++ .../fix-runtime-child-drain--issues-2630-2631/worklog.md | 8 ++++++++ 3 files changed, 13 insertions(+) create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index 130c6412f8..118e56d248 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -1,3 +1,5 @@ # Context pack Issues #2630/#2631, main b0eb07957, branch fix/runtime-child-drain. Research/plan drafted, real Redis subprocess reproduction in progress, PLAN-EVAL required before implementation. Generated glue changes require one full scaffold.runtime smoke at the end. Do not merge or publish. No modifications under plugin-sagas-core/src/transports. + +Confirmed baseline: real Redis child clean/timeout tests fail the exit watchdog (2/2); service clean/timeout likewise (2/2). These are genuine runtime failures after readiness, not startup failures. No production changes yet. PLAN-EVAL next. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md new file mode 100644 index 0000000000..6d94853fa9 --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md @@ -0,0 +1,3 @@ +# Resource inspection + +Ran the repository teardown preview without --apply. No commands were planned and no foreign or unknown-owner resource was mutated. The reporter found unrelated resources; their operator identities and paths are omitted under the public-repository restriction. The lane owns its Redis test container through the creation receipt, exact container identity, run label and repository bind mount; cleanup verifies those proofs immediately before removal. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 26b7851ddd..2ee6628868 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -12,3 +12,11 @@ S1-S4 and gates are enumerated in plan.md. PLAN-EVAL selected: runtime exit sema - Current base confirmed after fetch. - Deno KV alone exits without explicit close; real Redis subprocess regressions are being run before product modification. - rtk/rg unavailable; commands run directly as node. No operator environment values retained. + +## Baseline reproduction + +The first probe could not connect because the Docker daemon is in a different network namespace; that harness failure is not counted as a reproduction. Fixed endpoint discovery and made the watchdog tolerate an already-exited child. No product code changed. + +With the isolated Redis endpoint reachable, both child cases (clean and hung drain) reach PROBE_READY, receive SIGTERM and fail the 5 s subprocess watchdog: structured tests exit 1, 0 pass / 2 fail. Both service cases likewise reach readiness and fail the 5 s exit watchdog: 0 pass / 2 fail. The retained concrete handle is the ioredis primary connection opened through getKv(). Deno KV alone was a negative control and exited normally. Child cleanup callbacks are deliberately ignored by current main, producing the expected red baseline. + +Teardown preview planned no mutations; unrelated resources were left alone. Owned Redis cleanup uses exact creation identity plus run label and repository bind-mount verification. From 2913e2a51c160dfe191e0ec524f921cd349d9321 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 17:58:00 +0100 Subject: [PATCH 03/19] docs(harness): bound cleanup within process shutdown deadlines --- .llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md index f0310ceb58..369c701f28 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md @@ -4,8 +4,8 @@ Resolve #2630 and #2631 together. No merge/publication, no saga transport modifications, no Redis Streams dependency. -1. ChildHealthProcessOptions gains hostname (default loopback, explicit override), drainTimeoutMs (30 s drain), bounded onShutdown hooks, and exitOnShutdown (default true for process ownership; false for embedded/tests). Preserve the one-second observable fatal-health grace. Exit 0 clean, 1 fatal/cleanup failure, 2 drain timeout. Drain and cleanup deadlines and the maximum total must be documented. -2. Service signal shutdown ends the process with the same exit-code vocabulary after drain and resource cleanup. Manual stop and external cancellation remain embeddable; an explicit exitOnSignal option lets a host retain process ownership. Shutdown hook failures are nonzero. Hooks are attempted on timeout rather than skipped; a separately bounded cleanup phase prevents one hook from hanging process termination. Existing LIFO ordering and idempotency remain. +1. ChildHealthProcessOptions gains hostname (default loopback, explicit override), drainTimeoutMs (35 s total including up to 5 s reserved for cleanup), bounded onShutdown hooks, and exitOnShutdown (default true for process ownership; false for embedded/tests). Preserve the one-second observable fatal-health grace. Exit 0 clean, 1 fatal/cleanup failure, 2 drain timeout. The default work drain is 30 s; cleanupTimeoutMs defaults to min(5 s, one fifth of the total). The total bound includes closing the health listener; the pre-existing one-second fatal-observation grace precedes this bound. +2. Service signal shutdown ends the process with the same exit-code vocabulary after drain and resource cleanup. Manual stop and external cancellation remain embeddable; an explicit exitOnSignal option lets a host retain process ownership. Shutdown hook failures are nonzero. Hooks are attempted on timeout rather than skipped; a cleanup phase reserved within the existing 30 s total (default min(5 s, one fifth of total)) prevents one hook from hanging process termination. A timed-out work-drain hook cannot prevent remaining resource cleanups from being invoked. Existing LIFO ordering and idempotency remain. 3. Close process-owned shared KV (and its Redis client/subscriber) on executable-role signal shutdown. Add explicit cleanup callbacks to generated background glue. Generated host bootstrap tracks only DB clients it actually acquired and provides an idempotent disposal callback; never resolve an unused DB merely to close it. Add optional disposal to PluginServiceContext so generated service entrypoints can register owner-provided cleanup. Native caller-owned contexts stay untouched unless their host explicitly supplies disposal. 4. Prisma cleanup covers every acquired client, deduplicated by identity, not only the health-check client. Standard sagas background wiring must dispose its acquired host DB context as well as shared KV. Implement at composition roots; do not close opaque caller resources from generic library stop methods. 5. OTel's SIGTERM flush must not Deno.exit ahead of the runtime drain. Its shutdown remains bounded and listener removal is retained. @@ -18,5 +18,5 @@ No speculative lifecycle registry or new dependency; prefer callback contracts a ## Gates and risks Structured focused test/check/lint/fmt, affected package tests, quality:gate, JSR audits/doc-lint with baseline comparison, release:preflight, docs:accuracy. Full one-pass CLI scaffold.runtime E2E at the end because generated runtime glue changes. Leak-check and teardown preview before owned cleanup; preserve all foreign resources. -Risk: closing embedded shared resources -> process ownership and explicit disposal callbacks. Risk: hanging cleanup -> bounded cleanup, nonzero exit. Risk: fatal health disappearing -> retain existing grace before cleanup. Risk: losing in-flight work -> close stores after runtime drain, not at signal receipt. Cleanup budget and any ownership refinements must be settled by PLAN-EVAL before implementation. +Risk: closing embedded shared resources -> process ownership and explicit disposal callbacks. Risk: hanging cleanup -> bounded cleanup, nonzero exit. Risk: fatal health disappearing -> retain existing grace before cleanup. Risk: losing in-flight work -> close stores after runtime drain, not at signal receipt. The deadline is measured monotonically from shutdown admission; no cleanup may reset it. A timed-out cleanup yields exit 2 rather than claiming handles closed. No existing debt deepened; no broad refactor. Deferred: workers pause/delivery-budget feature, saga SSE log, all other milestone fixes. From f86b8891b52953569c5070a49bbc382c5aea38fd Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 18:12:16 +0100 Subject: [PATCH 04/19] docs(harness): lock signal termination and resource disposal contracts --- .../context-pack.md | 4 + .../plan-eval.md | 159 ++++++++++++++++++ .../plan.md | 27 ++- .../worklog.md | 4 + 4 files changed, 188 insertions(+), 6 deletions(-) create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index 118e56d248..be800d4c8c 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -3,3 +3,7 @@ Issues #2630/#2631, main b0eb07957, branch fix/runtime-child-drain. Research/plan drafted, real Redis subprocess reproduction in progress, PLAN-EVAL required before implementation. Generated glue changes require one full scaffold.runtime smoke at the end. Do not merge or publish. No modifications under plugin-sagas-core/src/transports. Confirmed baseline: real Redis child clean/timeout tests fail the exit watchdog (2/2); service clean/timeout likewise (2/2). These are genuine runtime failures after readiness, not startup failures. No production changes yet. PLAN-EVAL next. + +## PLAN-EVAL cycle-one repairs + +Evaluator accepted reproduction and coverage but returned FAIL_PLAN for five underspecified decisions. Plan now explicitly locks Deno.exit on clean and failed process-owned paths; Prisma dedup/disposal in raw withDatabase, inherited by presets; closeKv() rather than lazy context KV close(); bounded OTel flush without process termination and documented standalone behavior; and per-slice file groups (all below 30 files). Service's default 30 s total includes 25 s work and 5 s reserved cleanup; manual stop/external abort remain embeddable. No production code has changed. Cycle-two PLAN-EVAL is required before implementation. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md new file mode 100644 index 0000000000..9d20ed70d8 --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md @@ -0,0 +1,159 @@ +# PLAN-EVAL — fix-runtime-child-drain--issues-2630-2631 + +- Plan evaluator session: separate OpenCode session, 2026-11-16. Requested and observed route: + `glm_5_3/provider_default` on the OpenCode Go transport (feature-tier PLAN-EVAL primary, pinned + matrix). No substitution, no fallback. Generator is the owner-selected Codex Sol xhigh session — + different vendor family, different session. Machine identities omitted under the owner's public + repository restrictions. +- Run: `fix-runtime-child-drain--issues-2630-2631`; branch `fix/runtime-child-drain`. +- Exact head evaluated: 2913e2a51c160dfe191e0ec524f921cd349d9321 (base origin/main + b0eb079575968e843b781579673c9fe2ae250e07). Head contains run-dir documentation only; the two + untracked research test files are not part of the head and were read as proposed S1 content. +- Surface / archetype: Archetype 3 (runtime/behavior) primary — `packages/plugin` child-health edge, + `packages/service` shutdown/listener, `packages/telemetry` OTel adapter — with plugin/CLI and + service overlays for the generated glue and composition work. +- Scope overlays: `SCOPE-service.md`; release-gate class triggered by generated runtime glue + (full `scaffold.runtime` smoke required, planned in S4). + +## Verification performed + +- Read `gates/plan-gate.md`, `evaluator/verdict-definitions.md`, the archetype profile, gate matrix, + scope overlay, and the open debt registry (no open entry covers process shutdown/exit semantics; + nothing in this plan deepens `packages/kv` or workers Refactor debt — the plan calls `closeKv()` + from composition roots and does not modify the KV package). +- Read both issues in full and the draft PR body/labels/commit list. +- Spot-checked every load-bearing research finding against the tree at the head: + - `packages/plugin/src/presentation/run-child-health-process.ts:59-60` binds with no `hostname`; + `:135` awaits run completion unbounded; only the fatal path sets an exit code; the one-second + fatal grace (`:108`) precedes any bound. + - `packages/service/src/builder/service-shutdown.ts` bounds the 30 s drain, `break`s the LIFO hook + loop on a timed-out hook, and nothing in `packages/service` exits the process. + - `packages/kv/application/shared.ts:187` `closeKv()` has no runtime caller outside the KV + package; `defineService` disconnects only the health-check client + (`packages/service/src/presets/define-service.ts:335-339`). + - The opt-in OTel SDK provider is the only runtime `Deno.exit` + (`packages/telemetry/src/adapters/otel/otel-sdk.ts:315-319`) and can exit 0 before drain ends. + - Generated-role survey: workers/sagas/triggers background glue + (`plugins/*/src/adapter/resources/glue/runtime.stub.ts`), workers/sagas/auth API services load + the host bootstrap via `NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE` and open the shared KV + (`plugins/auth/services/src/backend-registry.ts`, `plugins/workers/services/src/service.ts`), + the sagas runner acquires host DB clients through its bootstrap-loaded context + (`plugins/sagas/src/runtime/saga-runner.ts:277,301`), streams is a proxy with no KV/DB handles, + and scaffold app services acquire DB through `defineService` + (`packages/cli/src/kernel/assets/service/main.ts.template`). +- Read the two untracked research tests. They pin the planned API (`drainTimeoutMs`, + `onShutdown` on the child; exit codes 0/2; `PROBE_CLOSED`/`PROBE_DB_CLOSED` asserted in both the + clean and timed-out cases) and are genuine failing-on-main reproductions per the recorded + Redis-backed baseline (2/2 child, 2/2 service; KV-alone negative control). The corrected + Docker-network harness failure is properly excluded from reproduction evidence. + +## Checklist results + +| Plan-Gate item | Result | Evidence / location | +| --------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Research present and current | PASS | `research.md` re-baselined against main b0eb0795; #2631's historical env-fallback claim corrected in `drift.md`; all findings spot-checked against the tree (above). | +| Decisions locked | FAIL (4 gaps) | Exit vocabulary, deadline math, ownership options, no-registry, composition-root disposal, OTel constraint, and loopback default are locked with rationale — but the final-termination mechanism, the Prisma-dedup implementation point, the shared-KV disposal route, and the standalone-OTel behavior change are unstated (see sweep). | +| Open-decision sweep | FAIL (4 unstated) | The conditional hostname env fallback is flagged and safe to defer (S4 smoke decides). Four unstated decisions could force rework (below). | +| Commit slices (< 30, gate + files each) | FAIL (files) | S1–S4 are enumerated, ordered, and each names what it proves and its proving gate; per-slice file groups are not enumerated, so the <30-file bound is asserted, not shown (`plan.md` "Design and slices"; `worklog.md` "Contributor path" names areas only). | +| Risk register | PASS | `plan.md` "Gates and risks": embedded shared resources, hanging cleanup, fatal-grace retention, in-flight work; mitigations named. | +| Gate set selected | PASS | Structured focused test/check/lint/fmt, affected package tests, `quality:gate`, JSR audits + doc-lint with baseline comparison, `release:preflight`, `docs:accuracy`, and the full one-pass `scaffold.runtime` E2E — matches Archetype 3 (runtime + consumer gates) and the release-gate class for generated-glue changes. | +| Deferred scope explicit | PASS | Workers pause/delivery-budget, saga SSE log, other milestone fixes deferred; no saga transport changes; no Redis Streams dependency. | +| jsr-audit surface scan (pkg/plugin) | PASS | `research.md`: additive optional fields (`ChildHealthProcessOptions`, `ServeOptions`, `PluginServiceContext` disposal), documented fields, no upstream re-exports, no new external dependencies; slow-type risk named for the SDK surface. | + +## Open-decision sweep (evaluator-run) + +Unstated decisions that could force rework: + +1. **Clean-path process termination is not locked.** The exit-2 case can only terminate explicitly + (a hung run promise retains the event loop), but the plan does not state whether the clean path + exits explicitly or relies on natural event-loop drain after cleanup. Natural drain is + nondeterministic under foreign retainers — including an OTel periodic metric reader that this + same PR's OTel fix may leave running when it stops exiting early. Deferred, this forces rework + inside S2 and can make the acceptance watchdogs flaky. +2. **The identity-deduplicated Prisma disposal point is ambiguous and the committed S1 test pins + the other reading.** `plan.md` item 4 says "implement at composition roots", which reads as the + `defineService`/`createPluginService` presets; the S1 service test pins the raw builder + (`createService(...).withDatabase({ first: client, alias: client })` expecting exactly-once + `$disconnect`). Preset-only disposal leaves that test permanently red — forced rework in S2. +3. **The shared-KV disposal route is not named.** `closeKv()` is singleton-aware and a safe no-op + when never initialized; the lazy `PluginServiceContext` KV wrapper's `close()` + (`packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts`) resolves the underlying + adapter on first call — closing an unused context KV would open a Redis connection merely to + close it (violating the plan's own "never resolve an unused client" principle) and would leave + the shared singleton pointing at a closed adapter for embedded hosts on manual-stop paths. + Deferred, this forces rework in S3. +4. **The standalone-OTel behavior change is not named.** After removing the ahead-of-drain + `Deno.exit(0)`, a process using the opt-in SDK provider without a NetScript runtime no longer + exits from OTel's own SIGTERM handler. This is acceptable (process ownership belongs to the + composing runtime) but must be stated and documented, or S3 docs and `docs:accuracy` miss it. + +Flagged and accepted as safe to defer: the conditional hostname environment fallback (S4 +`scaffold.runtime` smoke decides whether generated container wiring needs it). + +## Acceptance and role coverage confirmation + +All seven acceptance boxes across #2630 and #2631 are meetable by this plan after the repairs +below: + +- #2630 child SIGTERM exit within budget (S1 red subprocess tests → S2), service exit after clean + and timed-out drains with distinct codes (S1 → S2), role-level KV/Prisma/Redis closure + (S2 core + S3 generated glue, host bootstrap, sagas DB disposal), exit codes documented (S3). +- #2631 loopback-by-default child health (S1 bind tests → S2), explicit override reusing the native + `hostname` convention (S2), generated container/Aspire health checks (S4 full smoke). + +No missing roles: workers/sagas/triggers background children, workers/sagas/auth plugin API +services, the sagas background runner's bootstrap-context DB clients, streams (no KV/DB handles; +exits via the generic service signal semantics), and scaffold app services via `defineService`. +The web frontend and the Aspire host are correctly out of scope. No generic global lifecycle +registry is proposed; no changes under `packages/plugin-sagas-core/src/transports/`; no Redis +Streams dependency. Manual stop and external abort remain embeddable; disposal is signal-path +scoped, which the plan states as "on executable-role signal shutdown". + +## Verdict + +`FAIL_PLAN` + +The plan is sound in scope, root cause, deadline accounting, ownership model, and coverage; the +failures are unstated decisions and slice-contract detail, all repairable by editing `plan.md` +without re-planning. Feature-tier policy: maximum two cycles; the evaluator repairs a fixable plan +on cycle two. + +### If FAIL_PLAN — required fixes (exact, minimal) + +1. **Lock final termination.** Add to `plan.md` item 1/2: after the drain/cleanup budget completes + or expires, the child and service runtimes explicitly terminate the process with the computed + exit code; the clean path must not rely on natural event-loop drain. (Timeout exit 2 already + requires explicit termination; state the clean path symmetrically.) +2. **Name the Prisma disposal point to match the S1 test.** Implement the identity-deduplicated + `$disconnect` in the service builder's database registration (`withDatabase`, inherited by + `defineService` and `createPluginService`), running in the reserved cleanup phase — not only in + the `defineService` preset. Keep the S1 service test as written. +3. **Name the KV disposal route.** Executable-role cleanup calls `closeKv()`; it must not use the + lazy `PluginServiceContext` KV wrapper's `close()` (resolve-on-close trap; singleton poisoning + for embedded manual-stop hosts). Either make the lazy wrapper's `close()` a no-op when unresolved + or document it as not a disposal path. +4. **Name the OTel standalone behavior change.** State in `plan.md` item 5 that the SDK provider's + SIGTERM handler keeps its bounded flush and listener removal, drops the exit, and that + standalone embedders compose a runtime or own signals themselves; carry it into the S3 docs + slice (`docs:accuracy` scope). +5. **Complete the slice contract.** Add per-slice file groups to `plan.md` (S1 tests; S2 + `packages/plugin` child edge, `packages/service` builder/coordinator/listener, + `packages/telemetry` OTel adapter; S3 the three plugin glue stubs, CLI service-context + template, first-party service entrypoints, docs; S4 evidence only) and confirm each slice stays + under 30 files. + +### Advisory (non-blocking) + +- The service `drainTimeoutMs` semantic narrows from "work-drain budget" to "total budget including + the reserved cleanup" (default 30 s → 25 s work + 5 s cleanup). Deliberate per the plan; document + it in the option docstring/README so `docs:accuracy` covers the change. +- Carry "signal-path-only disposal" into the implementation as an explicit reason/ownership check + so a manual stop of an embedded service never closes host-shared KV. +- Keep the reproduction evidence conventions: pinned Deno, real isolated Redis, KV-alone negative + control, watchdog-tolerant harness — they are the right shape for S1. + +## Notes + +No implementation was performed or is permitted before a `PASS`. The evaluator did not run +resources; the reproduction container was already removed by the lane. All citations are +repo-relative. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md index 369c701f28..97994018f7 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md @@ -4,15 +4,30 @@ Resolve #2630 and #2631 together. No merge/publication, no saga transport modifications, no Redis Streams dependency. -1. ChildHealthProcessOptions gains hostname (default loopback, explicit override), drainTimeoutMs (35 s total including up to 5 s reserved for cleanup), bounded onShutdown hooks, and exitOnShutdown (default true for process ownership; false for embedded/tests). Preserve the one-second observable fatal-health grace. Exit 0 clean, 1 fatal/cleanup failure, 2 drain timeout. The default work drain is 30 s; cleanupTimeoutMs defaults to min(5 s, one fifth of the total). The total bound includes closing the health listener; the pre-existing one-second fatal-observation grace precedes this bound. -2. Service signal shutdown ends the process with the same exit-code vocabulary after drain and resource cleanup. Manual stop and external cancellation remain embeddable; an explicit exitOnSignal option lets a host retain process ownership. Shutdown hook failures are nonzero. Hooks are attempted on timeout rather than skipped; a cleanup phase reserved within the existing 30 s total (default min(5 s, one fifth of total)) prevents one hook from hanging process termination. A timed-out work-drain hook cannot prevent remaining resource cleanups from being invoked. Existing LIFO ordering and idempotency remain. -3. Close process-owned shared KV (and its Redis client/subscriber) on executable-role signal shutdown. Add explicit cleanup callbacks to generated background glue. Generated host bootstrap tracks only DB clients it actually acquired and provides an idempotent disposal callback; never resolve an unused DB merely to close it. Add optional disposal to PluginServiceContext so generated service entrypoints can register owner-provided cleanup. Native caller-owned contexts stay untouched unless their host explicitly supplies disposal. -4. Prisma cleanup covers every acquired client, deduplicated by identity, not only the health-check client. Standard sagas background wiring must dispose its acquired host DB context as well as shared KV. Implement at composition roots; do not close opaque caller resources from generic library stop methods. -5. OTel's SIGTERM flush must not Deno.exit ahead of the runtime drain. Its shutdown remains bounded and listener removal is retained. +1. **Final termination is explicit on every process-owned path.** After drain/cleanup completes or expires, invoke Deno.exit with the computed code on clean, fatal and timed-out paths; never rely on natural event-loop drain. ChildHealthProcessOptions gains hostname (default loopback, explicit override), drainTimeoutMs (35 s total including up to 5 s reserved for cleanup), bounded onShutdown hooks, and exitOnShutdown (default true for process ownership; false for embedded/tests). Preserve the one-second observable fatal-health grace. Exit 0 clean, 1 fatal/cleanup failure, 2 drain timeout. The default work drain is 30 s; cleanupTimeoutMs defaults to min(5 s, one fifth of the total). The total bound includes closing the health listener; the pre-existing one-second fatal-observation grace precedes this bound. +2. Service signal shutdown explicitly invokes Deno.exit with the computed code after drain and resource cleanup, on clean and failed paths symmetrically. It uses the same exit-code vocabulary. Manual stop and external cancellation remain embeddable; an explicit exitOnSignal option lets a host retain process ownership. Shutdown hook failures are nonzero. Hooks are attempted on timeout rather than skipped; a cleanup phase reserved within the existing 30 s total (default min(5 s, one fifth of total)) prevents one hook from hanging process termination. A timed-out work-drain hook cannot prevent remaining resource cleanups from being invoked. Existing LIFO ordering and idempotency remain. +3. Close process-owned shared KV (and its Redis client/subscriber) on executable-role signal shutdown by calling the singleton-aware closeKv(), a no-op when unused. Never use the lazy PluginServiceContext KV wrapper close() for process disposal: it resolves-on-close and is not a disposal path for these roles. Add explicit cleanup callbacks to generated background glue. Generated host bootstrap tracks only DB clients it actually acquired and provides an idempotent disposal callback; never resolve an unused DB merely to close it. Add optional disposal to PluginServiceContext so generated service entrypoints can register owner-provided cleanup. Native caller-owned contexts stay untouched unless their host explicitly supplies disposal. +4. Register identity-deduplicated Prisma $disconnect cleanup at the raw service builder withDatabase boundary, inherited by defineService and createPluginService. Run it in the reserved, signal-path-only cleanup phase so the raw-builder S1 subprocess test passes and aliases disconnect exactly once. Remove the redundant preset-only health-client hook. Prisma cleanup covers every acquired client, not only the health-check client. Standard sagas background wiring must dispose its acquired host DB context as well as shared KV. The builder records already-supplied DB client identities; generated composition supplies disposal for separately acquired host DB clients. No cleanup resolves a new database. Manual stop/external cancellation do not invoke process-owned KV/DB disposal; opaque embedded caller resources remain host-owned. +5. OTel's SIGTERM handler retains bounded flush and listener removal but drops Deno.exit entirely. This deliberately changes standalone SDK behavior: embedders without a NetScript runtime compose a runtime or own signal termination themselves. Document this in the S3 telemetry documentation and include it in docs:accuracy scope; the composing runtime owns all exit codes. ## Design and slices -S1: subprocess regressions with real Redis proving retained handles and distinct clean/timeout exits; child bind address tests. S2: process contracts/lifecycle and service signal ownership, scoped gates. S3: generated role cleanup/ownership and docs, generator tests. S4: one full scaffold.runtime smoke with cleanup, gate/evaluation handoff. +Each slice is below 30 files, including its run-artifact updates. Product tests remain red until the production slice; no implementation commit is made before PLAN-EVAL PASS. + +| Slice | Proves / gate | Files (maximum) | +| --- | --- | --- | +| S1 (8 files) | Real Redis subprocess regressions, child bind default/override, database aliases, timeout cleanup and OTel signal non-exit; structured tests demonstrate the main baseline and control cases | `packages/plugin/src/presentation/run-child-health-process_exit_test.ts`; `packages/plugin/src/presentation/run-child-health-process_test.ts`; `packages/service/tests/signal-exit_test.ts`; `packages/service/tests/shutdown-coordinator_test.ts`; new `packages/service/tests/service-resources_test.ts`; `packages/telemetry/tests/adapters/otel_provider_test.ts`; run `worklog.md`, `context-pack.md` | +| S2 (12 files) | Explicit process exit, bounded work/cleanup deadlines, signal-only deduplicated resource disposal; focused S1 tests and structured check/lint/fmt | `packages/plugin/src/presentation/run-child-health-process.ts`; `packages/service/src/types.ts`; `packages/service/src/builder/service-builder-impl.ts`; `packages/service/src/builder/service-listener.ts`; `packages/service/src/builder/service-shutdown.ts`; new `packages/service/src/builder/service-resources.ts` (database identity enumeration/disposal, consumed by builder cleanup); `packages/service/src/presets/define-service.ts`; `packages/telemetry/src/adapters/otel/otel-sdk.ts`; run `plan.md`, `worklog.md`, `context-pack.md`, `drift.md` | +| S3a (16 files) | Generated role cleanup closes only acquired handles, including saga bootstrap DB; generator/role tests and scoped gates | workers/sagas/triggers `plugins//src/adapter/resources/glue/runtime.stub.ts` (3); `packages/plugin/src/sdk/runtime/plugin-service-context.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts`; `packages/cli/src/kernel/assets/plugins/service-context.ts.template`; workers/sagas/auth `plugins//services/src/main.ts` (3); `plugins/sagas/src/runtime/saga-runner.ts`; `packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts`; workers/sagas/triggers `plugins//src/adapter/resources/resources.test.ts` (3); run `worklog.md` | +| S3b (15 files) | Public shutdown/hostname/budget/OTel semantics and generated assets agree; docs:accuracy, corpus freshness, release:preflight and JSR audits | `packages/plugin/README.md`; `packages/service/README.md`; `packages/telemetry/README.md`; `docs/site/orchestration-runtime/child-health.md`; `docs/site/observability/telemetry.md`; `docs/site/reference/plugin/index.md`; `docs/site/reference/service/index.md`; `docs/site/reference/telemetry/index.md`; generated CLI `embedded.generated.ts` and plugin `embedded.generated.ts` under their `src/kernel/assets/`; `packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts`; generated MCP export-surface corpus; run `worklog.md`, `context-pack.md`, `drift.md` | +| S4 (4 run files) | One-pass `deno task e2e:cli run scaffold.runtime --cleanup --format pretty`, health checks including hostname overrides, all scoped/static gates, independent IMPL-EVAL | run `worklog.md`, `context-pack.md`, `drift.md`, `evaluate.md`; no production files | + +New files trace to the database identity-disposal seam and subprocess/control tests; no speculative port or folder. Any needed source repair discovered during S4 belongs to a recorded S2/S3 follow-up, not an evidence-only sign-off. + +## Open-decision sweep + +Final termination, raw-builder DB disposal, singleton KV disposal, standalone OTel behavior and slice file boundaries are locked above. No must-resolve decision remains. Conditional hostname environment delivery is safe to defer to S4: explicit native hostname is the required public override; add environment delivery only if the generated launch smoke proves a need, and record that evidence in drift.md. + No speculative lifecycle registry or new dependency; prefer callback contracts and existing shutdown hooks, Promise.withResolvers/AbortSignal/AsyncDisposableStack where useful. ## Gates and risks diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 2ee6628868..98312e7895 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -20,3 +20,7 @@ The first probe could not connect because the Docker daemon is in a different ne With the isolated Redis endpoint reachable, both child cases (clean and hung drain) reach PROBE_READY, receive SIGTERM and fail the 5 s subprocess watchdog: structured tests exit 1, 0 pass / 2 fail. Both service cases likewise reach readiness and fail the 5 s exit watchdog: 0 pass / 2 fail. The retained concrete handle is the ioredis primary connection opened through getKv(). Deno KV alone was a negative control and exited normally. Child cleanup callbacks are deliberately ignored by current main, producing the expected red baseline. Teardown preview planned no mutations; unrelated resources were left alone. Owned Redis cleanup uses exact creation identity plus run label and repository bind-mount verification. + +## PLAN-EVAL cycle-one repairs + +Evaluator accepted reproduction and coverage but returned FAIL_PLAN for five underspecified decisions. Plan now explicitly locks Deno.exit on clean and failed process-owned paths; Prisma dedup/disposal in raw withDatabase, inherited by presets; closeKv() rather than lazy context KV close(); bounded OTel flush without process termination and documented standalone behavior; and per-slice file groups (all below 30 files). Service's default 30 s total includes 25 s work and 5 s reserved cleanup; manual stop/external abort remain embeddable. No production code has changed. Cycle-two PLAN-EVAL is required before implementation. From a7c343920d506cea1f0da6bf7fe6bdf850c89c36 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 18:26:18 +0100 Subject: [PATCH 05/19] test(runtime): reproduce retained Redis handles and early telemetry exit --- .../context-pack.md | 5 + .../plan-eval.md | 288 +++++++++--------- .../worklog.md | 5 + .../run-child-health-process_exit_test.ts | 86 ++++++ .../run-child-health-process_test.ts | 35 +++ packages/service/tests/signal-exit_test.ts | 89 ++++++ .../tests/adapters/otel_provider_test.ts | 32 ++ 7 files changed, 400 insertions(+), 140 deletions(-) create mode 100644 packages/plugin/src/presentation/run-child-health-process_exit_test.ts create mode 100644 packages/service/tests/signal-exit_test.ts diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index be800d4c8c..d7a05cb87c 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -7,3 +7,8 @@ Confirmed baseline: real Redis child clean/timeout tests fail the exit watchdog ## PLAN-EVAL cycle-one repairs Evaluator accepted reproduction and coverage but returned FAIL_PLAN for five underspecified decisions. Plan now explicitly locks Deno.exit on clean and failed process-owned paths; Prisma dedup/disposal in raw withDatabase, inherited by presets; closeKv() rather than lazy context KV close(); bounded OTel flush without process termination and documented standalone behavior; and per-slice file groups (all below 30 files). Service's default 30 s total includes 25 s work and 5 s reserved cleanup; manual stop/external abort remain embeddable. No production code has changed. Cycle-two PLAN-EVAL is required before implementation. + +## S1 regression baseline and plan approval + +PLAN-EVAL cycle two PASS: https://github.com/rickylabs/netscript/pull/2641#issuecomment-6923762411. All five requested plan repairs accepted; no product implementation preceded approval. New focused regression run at unchanged main source: 9 pass, 2 fail. Child default bind reports 0.0.0.0 instead of 127.0.0.1; OTel exits 0 before the composing runtime's drain/exit 7. Real Redis subprocess baseline already records four watchdog failures. Signal subprocess cases explicitly skip Windows (SIGTERM-specific acceptance). +S1 commits the red oracles and accepted plan; S2 will make these regressions pass. Tests requiring new cleanup contracts are added after those contracts exist. No resources remain from reproduction. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md index 9d20ed70d8..b84cd0584b 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md @@ -1,14 +1,19 @@ # PLAN-EVAL — fix-runtime-child-drain--issues-2630-2631 -- Plan evaluator session: separate OpenCode session, 2026-11-16. Requested and observed route: - `glm_5_3/provider_default` on the OpenCode Go transport (feature-tier PLAN-EVAL primary, pinned - matrix). No substitution, no fallback. Generator is the owner-selected Codex Sol xhigh session — - different vendor family, different session. Machine identities omitted under the owner's public - repository restrictions. +## Cycle two — current verdict (2026-11-16) + +- Plan evaluator session: separate OpenCode session, 2026-11-16, cycle two (fresh session, same pinned + route). Requested and observed route: `glm_5_3/provider_default` on the OpenCode Go transport + (feature-tier PLAN-EVAL primary, pinned matrix). No substitution, no fallback. Generator is the + owner-selected Codex Sol xhigh session — different vendor family, different session. Machine + identities omitted under the owner's public repository restrictions. - Run: `fix-runtime-child-drain--issues-2630-2631`; branch `fix/runtime-child-drain`. -- Exact head evaluated: 2913e2a51c160dfe191e0ec524f921cd349d9321 (base origin/main - b0eb079575968e843b781579673c9fe2ae250e07). Head contains run-dir documentation only; the two - untracked research test files are not part of the head and were read as proposed S1 content. +- Exact head evaluated: f86b8891b52953569c5070a49bbc382c5aea38fd (base origin/main + b0eb079575968e843b781579673c9fe2ae250e07). The head advances the cycle-one evaluated head + (2913e2a51) with run-dir documentation only (cycle-one verdict plus plan repairs); production + sources are identical to main, so the cycle-one tree spot-checks remain valid and were re-verified + at this head. The two untracked research tests are not part of the head and were read as proposed + S1 content. - Surface / archetype: Archetype 3 (runtime/behavior) primary — `packages/plugin` child-health edge, `packages/service` shutdown/listener, `packages/telemetry` OTel adapter — with plugin/CLI and service overlays for the generated glue and composition work. @@ -19,141 +24,144 @@ - Read `gates/plan-gate.md`, `evaluator/verdict-definitions.md`, the archetype profile, gate matrix, scope overlay, and the open debt registry (no open entry covers process shutdown/exit semantics; - nothing in this plan deepens `packages/kv` or workers Refactor debt — the plan calls `closeKv()` - from composition roots and does not modify the KV package). -- Read both issues in full and the draft PR body/labels/commit list. -- Spot-checked every load-bearing research finding against the tree at the head: - - `packages/plugin/src/presentation/run-child-health-process.ts:59-60` binds with no `hostname`; - `:135` awaits run completion unbounded; only the fatal path sets an exit code; the one-second - fatal grace (`:108`) precedes any bound. - - `packages/service/src/builder/service-shutdown.ts` bounds the 30 s drain, `break`s the LIFO hook - loop on a timed-out hook, and nothing in `packages/service` exits the process. - - `packages/kv/application/shared.ts:187` `closeKv()` has no runtime caller outside the KV - package; `defineService` disconnects only the health-check client - (`packages/service/src/presets/define-service.ts:335-339`). - - The opt-in OTel SDK provider is the only runtime `Deno.exit` - (`packages/telemetry/src/adapters/otel/otel-sdk.ts:315-319`) and can exit 0 before drain ends. - - Generated-role survey: workers/sagas/triggers background glue - (`plugins/*/src/adapter/resources/glue/runtime.stub.ts`), workers/sagas/auth API services load - the host bootstrap via `NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE` and open the shared KV - (`plugins/auth/services/src/backend-registry.ts`, `plugins/workers/services/src/service.ts`), - the sagas runner acquires host DB clients through its bootstrap-loaded context - (`plugins/sagas/src/runtime/saga-runner.ts:277,301`), streams is a proxy with no KV/DB handles, - and scaffold app services acquire DB through `defineService` - (`packages/cli/src/kernel/assets/service/main.ts.template`). -- Read the two untracked research tests. They pin the planned API (`drainTimeoutMs`, - `onShutdown` on the child; exit codes 0/2; `PROBE_CLOSED`/`PROBE_DB_CLOSED` asserted in both the - clean and timed-out cases) and are genuine failing-on-main reproductions per the recorded - Redis-backed baseline (2/2 child, 2/2 service; KV-alone negative control). The corrected - Docker-network harness failure is properly excluded from reproduction evidence. - -## Checklist results - -| Plan-Gate item | Result | Evidence / location | -| --------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Research present and current | PASS | `research.md` re-baselined against main b0eb0795; #2631's historical env-fallback claim corrected in `drift.md`; all findings spot-checked against the tree (above). | -| Decisions locked | FAIL (4 gaps) | Exit vocabulary, deadline math, ownership options, no-registry, composition-root disposal, OTel constraint, and loopback default are locked with rationale — but the final-termination mechanism, the Prisma-dedup implementation point, the shared-KV disposal route, and the standalone-OTel behavior change are unstated (see sweep). | -| Open-decision sweep | FAIL (4 unstated) | The conditional hostname env fallback is flagged and safe to defer (S4 smoke decides). Four unstated decisions could force rework (below). | -| Commit slices (< 30, gate + files each) | FAIL (files) | S1–S4 are enumerated, ordered, and each names what it proves and its proving gate; per-slice file groups are not enumerated, so the <30-file bound is asserted, not shown (`plan.md` "Design and slices"; `worklog.md` "Contributor path" names areas only). | -| Risk register | PASS | `plan.md` "Gates and risks": embedded shared resources, hanging cleanup, fatal-grace retention, in-flight work; mitigations named. | -| Gate set selected | PASS | Structured focused test/check/lint/fmt, affected package tests, `quality:gate`, JSR audits + doc-lint with baseline comparison, `release:preflight`, `docs:accuracy`, and the full one-pass `scaffold.runtime` E2E — matches Archetype 3 (runtime + consumer gates) and the release-gate class for generated-glue changes. | -| Deferred scope explicit | PASS | Workers pause/delivery-budget, saga SSE log, other milestone fixes deferred; no saga transport changes; no Redis Streams dependency. | -| jsr-audit surface scan (pkg/plugin) | PASS | `research.md`: additive optional fields (`ChildHealthProcessOptions`, `ServeOptions`, `PluginServiceContext` disposal), documented fields, no upstream re-exports, no new external dependencies; slow-type risk named for the SDK surface. | - -## Open-decision sweep (evaluator-run) - -Unstated decisions that could force rework: - -1. **Clean-path process termination is not locked.** The exit-2 case can only terminate explicitly - (a hung run promise retains the event loop), but the plan does not state whether the clean path - exits explicitly or relies on natural event-loop drain after cleanup. Natural drain is - nondeterministic under foreign retainers — including an OTel periodic metric reader that this - same PR's OTel fix may leave running when it stops exiting early. Deferred, this forces rework - inside S2 and can make the acceptance watchdogs flaky. -2. **The identity-deduplicated Prisma disposal point is ambiguous and the committed S1 test pins - the other reading.** `plan.md` item 4 says "implement at composition roots", which reads as the - `defineService`/`createPluginService` presets; the S1 service test pins the raw builder - (`createService(...).withDatabase({ first: client, alias: client })` expecting exactly-once - `$disconnect`). Preset-only disposal leaves that test permanently red — forced rework in S2. -3. **The shared-KV disposal route is not named.** `closeKv()` is singleton-aware and a safe no-op - when never initialized; the lazy `PluginServiceContext` KV wrapper's `close()` - (`packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts`) resolves the underlying - adapter on first call — closing an unused context KV would open a Redis connection merely to - close it (violating the plan's own "never resolve an unused client" principle) and would leave - the shared singleton pointing at a closed adapter for embedded hosts on manual-stop paths. - Deferred, this forces rework in S3. -4. **The standalone-OTel behavior change is not named.** After removing the ahead-of-drain - `Deno.exit(0)`, a process using the opt-in SDK provider without a NetScript runtime no longer - exits from OTel's own SIGTERM handler. This is acceptable (process ownership belongs to the - composing runtime) but must be stated and documented, or S3 docs and `docs:accuracy` miss it. - -Flagged and accepted as safe to defer: the conditional hostname environment fallback (S4 -`scaffold.runtime` smoke decides whether generated container wiring needs it). + the `packages/kv` god-test debt is untouched because the plan only calls `closeKv()` from + composition roots and does not modify the KV package; the `packages/telemetry` entry is closed and + its resolution — layering and subpath exports — is unaffected by the bounded-flush edit). +- Read both issues in full, the draft PR body/labels/commit list and phase comments, and the complete + cycle-one verdict (history section below; full text also preserved in git history at the head and + in the cycle-one PR comment). +- Confirmed all five cycle-one required fixes are present in `plan.md` at the head, cross-checked + against the pinned S1 test API (below). +- Re-verified the load-bearing research findings against the tree at the head: + - `packages/plugin/src/presentation/run-child-health-process.ts:59-60` binds with no `hostname` + (`Deno.serve({ port })`); `:135` awaits run completion unbounded; only the fatal path sets an + exit code (`:90`); the one-second fatal grace (`:108`) precedes any bound. + - `packages/service/src/builder/service-shutdown.ts:19` `DEFAULT_DRAIN_TIMEOUT_MS = 30_000`; + nothing in `packages/service` exits the process (no `Deno.exit` anywhere in its `src/`). + - `packages/kv/application/shared.ts:187` `closeKv()` exists as the singleton-aware process route. + - The opt-in OTel SDK provider holds the only runtime `Deno.exit` + (`packages/telemetry/src/adapters/otel/otel-sdk.ts:316-317`), exiting 0 ahead of drain. + - `packages/service/src/presets/define-service.ts:337` disconnects only the health-check client. +- Read both untracked research tests as proposed S1 content: they pin `drainTimeoutMs` and bounded + `onShutdown` on the child (exit 0 clean / 2 timed-out, `PROBE_CLOSED`), the raw-builder + `withDatabase({ first: client, alias: client })` boundary with exactly-once `PROBE_DB_CLOSED` on + the signal path, `serve({ port: 0, drainTimeoutMs: 100 })`, a hanging drain hook that cannot + prevent remaining disposal, and the 5 s exit watchdog — every assertion matches the repaired plan + contracts, and the recorded Redis-backed baseline (child 2/2, service 2/2, KV-alone negative + control, Docker-network harness failure excluded, container removed) stands. +- Counted every per-slice file group in the plan's slice table: S1 = 8, S2 = 12, S3a = 16, S3b = 15, + S4 = 4 run files; all below 30, ordered, each naming what it proves, its proving gate, and its + files. + +## Checklist results (cycle two) + +| Plan-Gate item | Result | Evidence / location | +| --------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Research present and current | PASS | `research.md` re-baselined against main b0eb0795; the #2631 drift correction (no hostname environment fallback in current main; native explicit `hostname` option) recorded in `drift.md`; all findings re-verified at the head. | +| Decisions locked | PASS | All five cycle-one gaps repaired in `plan.md` items 1-5: explicit `Deno.exit` with the computed code on clean, fatal and timed-out process-owned paths (never natural event-loop drain); identity-deduplicated Prisma `$disconnect` at the raw builder `withDatabase` boundary inherited by both presets, run in the reserved signal-path-only cleanup, redundant preset-only health hook removed; `closeKv()` as the singleton-aware process route with the lazy context-KV wrapper `close()` explicitly excluded from process disposal; standalone-OTel bounded-flush/no-exit behavior change stated and carried into `docs:accuracy`; per-slice file groups enumerated. | +| Open-decision sweep | PASS | Only the conditional hostname environment delivery remains open, explicitly safe to defer with the S4 `scaffold.runtime` trigger (explicit native hostname override is locked). No unstated decision that would force rework remains. | +| Commit slices (< 30, gate + files each) | PASS | S1 (8) tests/red baseline; S2 (12) child edge + service builder/listener/shutdown + OTel adapter; S3a (16) generated glue and role ownership; S3b (15) docs and generated assets; S4 (4 run files) one-pass full smoke + independent IMPL-EVAL — counts verified, all below 30. | +| Risk register | PASS | `plan.md` "Gates and risks": embedded shared resources, hanging cleanup, fatal-grace retention, in-flight work, each with mitigation; monotonic total deadline, no cleanup may reset it, timed-out cleanup yields exit 2 rather than claiming handles closed. | +| Gate set selected | PASS | Structured focused test/check/lint/fmt, affected package tests, `quality:gate`, JSR audits + doc-lint with baseline comparison, `release:preflight`, `docs:accuracy`, plus the full one-pass `scaffold.runtime` E2E — matches Archetype 3 (runtime + consumer gates) and the release-gate class for generated-glue changes. | +| Deferred scope explicit | PASS | Workers pause/delivery-budget feature, saga SSE log, other milestone fixes deferred; no saga transport changes; no Redis Streams dependency; conditional hostname environment delivery deferred with trigger. | +| jsr-audit surface scan (pkg/plugin) | PASS | `research.md`: additive optional fields (`ChildHealthProcessOptions` hostname/drainTimeoutMs/bounded onShutdown/exitOnShutdown, `ServeOptions` exitOnSignal and total-budget drainTimeoutMs semantics, `PluginServiceContext` disposal), documented fields, no upstream re-exports, no new external dependencies; slow-type risk named for the SDK surface. | + +## Open-decision sweep (evaluator-run, cycle two) + +None. The five decisions the cycle-one sweep required to be locked (final termination, Prisma +disposal point, KV disposal route, standalone-OTel behavior, slice file boundaries) are all locked in +`plan.md` items 1-5 and the slice table. Flagged and accepted as safe to defer: the conditional +hostname environment delivery — the explicit native `hostname` option is the locked public override; +add environment delivery only if the S4 generated-launch smoke proves a need, recording that evidence +in `drift.md`. ## Acceptance and role coverage confirmation -All seven acceptance boxes across #2630 and #2631 are meetable by this plan after the repairs -below: - -- #2630 child SIGTERM exit within budget (S1 red subprocess tests → S2), service exit after clean - and timed-out drains with distinct codes (S1 → S2), role-level KV/Prisma/Redis closure - (S2 core + S3 generated glue, host bootstrap, sagas DB disposal), exit codes documented (S3). -- #2631 loopback-by-default child health (S1 bind tests → S2), explicit override reusing the native - `hostname` convention (S2), generated container/Aspire health checks (S4 full smoke). - -No missing roles: workers/sagas/triggers background children, workers/sagas/auth plugin API -services, the sagas background runner's bootstrap-context DB clients, streams (no KV/DB handles; -exits via the generic service signal semantics), and scaffold app services via `defineService`. -The web frontend and the Aspire host are correctly out of scope. No generic global lifecycle -registry is proposed; no changes under `packages/plugin-sagas-core/src/transports/`; no Redis -Streams dependency. Manual stop and external abort remain embeddable; disposal is signal-path -scoped, which the plan states as "on executable-role signal shutdown". +All seven acceptance boxes across #2630 and #2631 are meetable by the repaired plan: + +- #2630 child SIGTERM exit within the drain budget, subprocess test failing on main (S1 red + subprocess tests → S2 explicit exit on `packages/plugin/src/presentation/run-child-health-process.ts`). +- #2630 service exits after clean and timed-out drains with distinct codes via subprocess test + (S1 `packages/service/tests/signal-exit_test.ts` red baseline → S2 listener/shutdown explicit exit; + 0 clean, 2 timeout, 1 fatal/cleanup failure). +- #2630 each role closes the KV, Prisma and Redis handles it opened (S2 core: `closeKv()` and its + Redis client/subscriber on the executable-role signal path; raw-builder identity-deduplicated + `$disconnect` covering every acquired client; S3a generated glue cleanup callbacks, host bootstrap + acquired-only idempotent DB disposal, sagas runner DB-context disposal). +- #2630 exit codes documented (S3b `docs/site` pages and READMEs under `docs:accuracy`). +- #2631 loopback-by-default child health (S1 bind tests → S2 default `127.0.0.1`). +- #2631 explicit override reusing the native plugin-service `hostname` convention (S2; the drift + record documents that current main exposes the explicit option, not the environment convention). +- #2631 generated container/Aspire health checks still pass (S4 full one-pass `scaffold.runtime` + smoke including hostname-override health checks). + +No missing roles: workers/sagas/triggers background children (glue stubs in S3a), workers/sagas/auth +plugin API services (entrypoints in S3a), the sagas background runner's bootstrap-context DB clients +(`plugins/sagas/src/runtime/saga-runner.ts` in S3a), streams (no KV/DB handles; exits via the generic +service signal semantics), and scaffold app services via `defineService`. The web frontend and the +Aspire host are correctly out of scope. No generic global lifecycle registry is proposed (callback +contracts and existing hooks preferred); no changes under `packages/plugin-sagas-core/src/transports/`; +no Redis Streams dependency. Manual stop and external abort remain embeddable; disposal stays +signal-path scoped ("on executable-role signal shutdown"; manual stop/external cancellation do not +invoke process-owned KV/DB disposal). ## Verdict -`FAIL_PLAN` - -The plan is sound in scope, root cause, deadline accounting, ownership model, and coverage; the -failures are unstated decisions and slice-contract detail, all repairable by editing `plan.md` -without re-planning. Feature-tier policy: maximum two cycles; the evaluator repairs a fixable plan -on cycle two. - -### If FAIL_PLAN — required fixes (exact, minimal) - -1. **Lock final termination.** Add to `plan.md` item 1/2: after the drain/cleanup budget completes - or expires, the child and service runtimes explicitly terminate the process with the computed - exit code; the clean path must not rely on natural event-loop drain. (Timeout exit 2 already - requires explicit termination; state the clean path symmetrically.) -2. **Name the Prisma disposal point to match the S1 test.** Implement the identity-deduplicated - `$disconnect` in the service builder's database registration (`withDatabase`, inherited by - `defineService` and `createPluginService`), running in the reserved cleanup phase — not only in - the `defineService` preset. Keep the S1 service test as written. -3. **Name the KV disposal route.** Executable-role cleanup calls `closeKv()`; it must not use the - lazy `PluginServiceContext` KV wrapper's `close()` (resolve-on-close trap; singleton poisoning - for embedded manual-stop hosts). Either make the lazy wrapper's `close()` a no-op when unresolved - or document it as not a disposal path. -4. **Name the OTel standalone behavior change.** State in `plan.md` item 5 that the SDK provider's - SIGTERM handler keeps its bounded flush and listener removal, drops the exit, and that - standalone embedders compose a runtime or own signals themselves; carry it into the S3 docs - slice (`docs:accuracy` scope). -5. **Complete the slice contract.** Add per-slice file groups to `plan.md` (S1 tests; S2 - `packages/plugin` child edge, `packages/service` builder/coordinator/listener, - `packages/telemetry` OTel adapter; S3 the three plugin glue stubs, CLI service-context - template, first-party service entrypoints, docs; S4 evidence only) and confirm each slice stays - under 30 files. - -### Advisory (non-blocking) - -- The service `drainTimeoutMs` semantic narrows from "work-drain budget" to "total budget including - the reserved cleanup" (default 30 s → 25 s work + 5 s cleanup). Deliberate per the plan; document - it in the option docstring/README so `docs:accuracy` covers the change. -- Carry "signal-path-only disposal" into the implementation as an explicit reason/ownership check - so a manual stop of an embedded service never closes host-shared KV. -- Keep the reproduction evidence conventions: pinned Deno, real isolated Redis, KV-alone negative - control, watchdog-tolerant harness — they are the right shape for S1. - -## Notes - -No implementation was performed or is permitted before a `PASS`. The evaluator did not run -resources; the reproduction container was already removed by the lane. All citations are -repo-relative. +`PASS` + +Every `gates/plan-gate.md` box is satisfied at head f86b8891; implementation may begin. Cycle-two +policy authorizes the evaluator to repair fixable plan wording directly before issuing PASS: no +repair was needed — the plan as committed satisfies every box without further edit. Feature-tier +cycle budget: cycle one FAIL_PLAN (five gaps), cycle two PASS — within the maximum of two cycles. + +### Conditions on implementation (advisory, non-blocking) + +- Keep the S1 tests as written; they are the pinned contract for the raw-builder disposal and the + exit-code semantics. +- Document the `drainTimeoutMs` semantic narrowing (total budget including the reserved cleanup; + service default 30 s = 25 s work + 5 s cleanup) in the option docstrings/READMEs so `docs:accuracy` + covers the change. +- Carry the signal-path-only disposal ownership check into implementation as an explicit reason + check so a manual stop of an embedded service never closes host-shared KV or a host-owned DB + client. +- Record the S4 hostname-environment decision (evidence of need or explicit non-need) in `drift.md`. +- Keep the reproduction evidence conventions (pinned Deno, real isolated Redis, KV-alone negative + control, watchdog-tolerant harness) for the S1 gate run. + +## History — cycle one (2026-11-16, superseded by the PASS above) + +Cycle one evaluated head 2913e2a51 (base origin/main b0eb0795) in a separate OpenCode session on the +same pinned route (`glm_5_3/provider_default`, OpenCode Go transport; generator the Codex Sol xhigh +session — different session and vendor family). It read `gates/plan-gate.md`, +`evaluator/verdict-definitions.md`, the archetype profile, gate matrix, scope overlay, debt registry, +both issues, the draft PR, the two untracked research tests, and spot-checked every load-bearing +research finding against the tree. + +Cycle-one checklist: research current PASS; decisions locked FAIL (4 gaps); open-decision sweep FAIL +(4 unstated); commit slices FAIL (per-slice file groups not enumerated); risk register PASS; gate set +PASS; deferred scope PASS; jsr-audit PASS. Verdict: `FAIL_PLAN` — the plan was sound in scope, root +cause, deadline accounting, ownership model and coverage; the failures were unstated decisions and +slice-contract detail, all repairable by editing `plan.md`. Required fixes (all applied at f86b8891): + +1. Lock final termination — explicit termination with the computed exit code after the drain/cleanup + budget completes or expires, clean path symmetric with the timed-out path, for both child and + service. +2. Name the Prisma disposal point to match the committed S1 test — identity-deduplicated + `$disconnect` in the service builder's `withDatabase` registration, inherited by `defineService` + and `createPluginService`, run in the reserved cleanup phase. +3. Name the KV disposal route — `closeKv()` (singleton-aware, safe no-op when unused); never the + lazy `PluginServiceContext` KV wrapper `close()` (resolve-on-close trap; singleton poisoning for + embedded manual-stop hosts). +4. Name the OTel standalone behavior change — SIGTERM handler keeps bounded flush and listener + removal, drops the exit; standalone embedders compose a runtime or own signals; carried into the + S3 docs slice and `docs:accuracy`. +5. Complete the slice contract — per-slice file groups with the <30-file bound shown, not asserted. + +Cycle-one advisory (carried above): document the `drainTimeoutMs` total-budget narrowing; carry the +signal-path-only disposal check into implementation; keep the reproduction evidence conventions. The +conditional hostname environment fallback was flagged and accepted as safe to defer to the S4 smoke +decision. + +The complete cycle-one text is preserved verbatim in git history (the run-dir file as committed at +f86b8891) and in the cycle-one PR comment; the parent applied all five repairs in f86b8891 (run-dir +documentation only, no production changes). diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 98312e7895..26bb4217cf 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -24,3 +24,8 @@ Teardown preview planned no mutations; unrelated resources were left alone. Owne ## PLAN-EVAL cycle-one repairs Evaluator accepted reproduction and coverage but returned FAIL_PLAN for five underspecified decisions. Plan now explicitly locks Deno.exit on clean and failed process-owned paths; Prisma dedup/disposal in raw withDatabase, inherited by presets; closeKv() rather than lazy context KV close(); bounded OTel flush without process termination and documented standalone behavior; and per-slice file groups (all below 30 files). Service's default 30 s total includes 25 s work and 5 s reserved cleanup; manual stop/external abort remain embeddable. No production code has changed. Cycle-two PLAN-EVAL is required before implementation. + +## S1 regression baseline and plan approval + +PLAN-EVAL cycle two PASS: https://github.com/rickylabs/netscript/pull/2641#issuecomment-6923762411. All five requested plan repairs accepted; no product implementation preceded approval. New focused regression run at unchanged main source: 9 pass, 2 fail. Child default bind reports 0.0.0.0 instead of 127.0.0.1; OTel exits 0 before the composing runtime's drain/exit 7. Real Redis subprocess baseline already records four watchdog failures. Signal subprocess cases explicitly skip Windows (SIGTERM-specific acceptance). +S1 commits the red oracles and accepted plan; S2 will make these regressions pass. Tests requiring new cleanup contracts are added after those contracts exist. No resources remain from reproduction. diff --git a/packages/plugin/src/presentation/run-child-health-process_exit_test.ts b/packages/plugin/src/presentation/run-child-health-process_exit_test.ts new file mode 100644 index 0000000000..d9fafb6520 --- /dev/null +++ b/packages/plugin/src/presentation/run-child-health-process_exit_test.ts @@ -0,0 +1,86 @@ +import { assertEquals } from '@std/assert'; + +const redisUrl = Deno.env.get('NETSCRIPT_TEST_REDIS_URL'); + +for (const hangs of [false, true]) { + Deno.test({ + name: `child SIGTERM closes Redis and exits after ${hangs ? 'timed-out' : 'clean'} drain`, + ignore: !redisUrl || Deno.build.os === 'windows', + async fn() { + const child = new Deno.Command(Deno.execPath(), { + args: [ + 'eval', + '--unstable-kv', + ` + import '@netscript/kv/redis'; + import { getKv, closeKv } from '@netscript/kv'; + import { runChildHealthProcess } from '@netscript/plugin/health'; + await runChildHealthProcess(async (health, signal) => { + await (await getKv({ provider: 'redis', redisUrl: Deno.env.get('NETSCRIPT_TEST_REDIS_URL'), skipServiceDiscovery: true })).get(['shutdown-probe']); + health.registryLoaded(); health.dependenciesReady(); health.running(); + console.log('PROBE_READY'); + await new Promise(resolve => signal.addEventListener('abort', resolve, { once: true })); + if (${hangs}) await new Promise(() => {}); + }, undefined, { + drainTimeoutMs: 100, + onShutdown: [async () => { await closeKv(); console.log('PROBE_CLOSED'); }], + }); + `, + ], + env: { PORT: '0' }, + stdout: 'piped', + stderr: 'piped', + }).spawn(); + let output = ''; + const reading = (async () => { + const decoder = new TextDecoder(); + for await (const chunk of child.stdout) output += decoder.decode(chunk, { stream: true }); + })(); + let killed = false; + let exited = false; + const statusPromise = child.status.then((status) => { + exited = true; + return status; + }); + const stderr = child.stderr.pipeThrough(new TextDecoderStream()).getReader(); + const errors = (async () => { + let text = ''; + for (;;) { + const result = await stderr.read(); + if (result.done) return text; + text += result.value; + } + })(); + const timer = setTimeout(() => { + killed = true; + try { + child.kill('SIGKILL'); + } catch { /* Already exited. */ } + }, 5_000); + try { + while (!output.includes('PROBE_READY') && !killed && !exited) { + await new Promise((resolve) => setTimeout(resolve, 10)); + } + assertEquals( + output.includes('PROBE_READY'), + true, + await (exited ? errors : Promise.resolve('child did not become ready')), + ); + if (!killed && !exited) child.kill('SIGTERM'); + const status = await statusPromise; + await reading; + assertEquals(killed, false, 'child exceeded its shutdown deadline'); + assertEquals(status.code, hangs ? 2 : 0); + assertEquals(output.includes('PROBE_CLOSED'), true, 'owned Redis connection was closed'); + } finally { + clearTimeout(timer); + try { + child.kill('SIGKILL'); + } catch { /* Already exited. */ } + await child.status; + await reading; + await errors; + } + }, + }); +} diff --git a/packages/plugin/src/presentation/run-child-health-process_test.ts b/packages/plugin/src/presentation/run-child-health-process_test.ts index d502c7304d..7acb025358 100644 --- a/packages/plugin/src/presentation/run-child-health-process_test.ts +++ b/packages/plugin/src/presentation/run-child-health-process_test.ts @@ -119,3 +119,38 @@ async function bounded(promise: Promise): Promise { clearTimeout(timer); } } + +for (const hostname of [undefined, '0.0.0.0']) { + Deno.test({ + name: `child health binds ${hostname ?? 'loopback by default'}`, + ignore: Deno.build.os === 'windows', + async fn() { + const result = await new Deno.Command(Deno.execPath(), { + args: [ + 'eval', + ` + import { runChildHealthProcess } from '@netscript/plugin/health'; + const serve = Deno.serve; + let address; + Deno.serve = (...args) => { const server = serve(...args); address = server.addr; return server; }; + await runChildHealthProcess(async (health, signal) => { + health.registryLoaded(); health.dependenciesReady(); health.running(); + const response = await fetch('http://127.0.0.1:' + address.port + '/health'); + console.log('HEALTH:' + response.status + ':' + (await response.json()).state); + console.log('BIND:' + address.hostname); + setTimeout(() => Deno.kill(Deno.pid, 'SIGTERM'), 0); + await new Promise(resolve => signal.addEventListener('abort', resolve, {once: true})); + }, undefined, ${JSON.stringify(hostname === undefined ? {} : { hostname })}); + `, + ], + env: { PORT: '0' }, + stdout: 'piped', + stderr: 'piped', + }).output(); + assertEquals(result.code, 0, new TextDecoder().decode(result.stderr)); + const stdout = new TextDecoder().decode(result.stdout); + assert(stdout.includes(`BIND:${hostname ?? '127.0.0.1'}`), stdout); + assert(stdout.includes('HEALTH:200:ready'), stdout); + }, + }); +} diff --git a/packages/service/tests/signal-exit_test.ts b/packages/service/tests/signal-exit_test.ts new file mode 100644 index 0000000000..466f38422e --- /dev/null +++ b/packages/service/tests/signal-exit_test.ts @@ -0,0 +1,89 @@ +import { assertEquals } from '@std/assert'; + +const redisUrl = Deno.env.get('NETSCRIPT_TEST_REDIS_URL'); + +for (const hangs of [false, true]) { + Deno.test({ + name: `service SIGTERM closes Redis and Prisma clients and exits after ${ + hangs ? 'timed-out' : 'clean' + } drain`, + ignore: !redisUrl || Deno.build.os === 'windows', + async fn() { + const child = new Deno.Command(Deno.execPath(), { + args: [ + 'eval', + '--unstable-kv', + ` + import '@netscript/kv/redis'; + import { getKv, closeKv } from '@netscript/kv'; + import { createService } from '@netscript/service'; + await (await getKv({ provider: 'redis', redisUrl: Deno.env.get('NETSCRIPT_TEST_REDIS_URL'), skipServiceDiscovery: true })).get(['shutdown-probe']); + const client = { $queryRaw: async () => [], $disconnect: async () => { console.log('PROBE_DB_CLOSED'); } }; + await createService({}, { name: 'shutdown-probe' }) + .withDatabase({ first: client, alias: client }) + .onShutdown(async () => { if (${hangs}) await new Promise(() => {}); }) + .serve({ port: 0, drainTimeoutMs: 100 }); + console.log('PROBE_READY'); + `, + ], + env: { PORT: '0' }, + stdout: 'piped', + stderr: 'piped', + }).spawn(); + let output = ''; + const reading = (async () => { + const decoder = new TextDecoder(); + for await (const chunk of child.stdout) output += decoder.decode(chunk, { stream: true }); + })(); + let killed = false; + let exited = false; + const statusPromise = child.status.then((status) => { + exited = true; + return status; + }); + const stderr = child.stderr.pipeThrough(new TextDecoderStream()).getReader(); + const errors = (async () => { + let text = ''; + for (;;) { + const result = await stderr.read(); + if (result.done) return text; + text += result.value; + } + })(); + const timer = setTimeout(() => { + killed = true; + try { + child.kill('SIGKILL'); + } catch { /* Already exited. */ } + }, 5_000); + try { + while (!output.includes('PROBE_READY') && !killed && !exited) { + await new Promise((resolve) => setTimeout(resolve, 10)); + } + assertEquals( + output.includes('PROBE_READY'), + true, + await (exited ? errors : Promise.resolve('child did not become ready')), + ); + if (!killed && !exited) child.kill('SIGTERM'); + const status = await statusPromise; + await reading; + assertEquals(killed, false, 'child exceeded its shutdown deadline'); + assertEquals(status.code, hangs ? 2 : 0); + assertEquals( + output.split('PROBE_DB_CLOSED').length - 1, + 1, + 'acquired Prisma client closed once despite aliases', + ); + } finally { + clearTimeout(timer); + try { + child.kill('SIGKILL'); + } catch { /* Already exited. */ } + await child.status; + await reading; + await errors; + } + }, + }); +} diff --git a/packages/telemetry/tests/adapters/otel_provider_test.ts b/packages/telemetry/tests/adapters/otel_provider_test.ts index 3c66d9e0e6..1132a3f052 100644 --- a/packages/telemetry/tests/adapters/otel_provider_test.ts +++ b/packages/telemetry/tests/adapters/otel_provider_test.ts @@ -120,3 +120,35 @@ Deno.test('SDK span links preserve attributes; Deno span links drop them', () => assertEquals(dropped.droppedAttributesCount, 1); assert(dropped.context.traceId === 'a'.repeat(32)); }); + +Deno.test({ + name: 'SDK signal flush leaves process termination and exit code to the runtime', + ignore: Deno.build.os === 'windows', + async fn() { + const child = await new Deno.Command(Deno.execPath(), { + args: [ + 'eval', + ` + import { createOtelSdkProvider } from ${ + JSON.stringify(new URL('../../src/adapters/otel/mod.ts', import.meta.url).href) + }; + const sdk = { + tracerProvider: { register() {}, async forceFlush() {}, async shutdown() {} }, + meterProvider: { async forceFlush() {}, async shutdown() {} }, + }; + const provider = createOtelSdkProvider({}, async () => sdk); + await provider.register(); + Deno.addSignalListener('SIGTERM', () => { + setTimeout(() => { console.log('OWNER_DRAINED'); Deno.exit(7); }, 100); + }); + setTimeout(() => Deno.kill(Deno.pid, 'SIGTERM'), 0); + await new Promise(() => {}); + `, + ], + stdout: 'piped', + stderr: 'piped', + }).output(); + assertEquals(child.code, 7, new TextDecoder().decode(child.stderr)); + assert(new TextDecoder().decode(child.stdout).includes('OWNER_DRAINED')); + }, +}); From 029b9e6b3285323ef908c3d3f4d77ae2cd85a207 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 18:33:57 +0100 Subject: [PATCH 06/19] fix(runtime): bound process shutdown and close signal-owned dependencies --- .../context-pack.md | 17 ++++ .../drift.md | 3 + .../leak-report.md | 2 +- .../plan.md | 2 +- .../worklog.md | 17 ++++ .../presentation/run-child-health-process.ts | 86 ++++++++++++++++--- .../run-child-health-process_test.ts | 4 +- .../src/builder/service-builder-impl.ts | 8 ++ .../service/src/builder/service-listener.ts | 19 +++- .../service/src/builder/service-resources.ts | 41 +++++++++ .../service/src/builder/service-shutdown.ts | 49 +++++++++-- .../service/src/presets/define-service.ts | 14 --- packages/service/src/types.ts | 14 ++- .../service/tests/listener-hostname_test.ts | 2 +- .../service/tests/service-builder_test.ts | 2 +- .../service/tests/service-resources_test.ts | 53 ++++++++++++ .../tests/shutdown-coordinator_test.ts | 43 ++++++++++ .../telemetry/src/adapters/otel/otel-sdk.ts | 14 ++- 18 files changed, 347 insertions(+), 43 deletions(-) create mode 100644 packages/service/src/builder/service-resources.ts create mode 100644 packages/service/tests/service-resources_test.ts diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index d7a05cb87c..dd116f478b 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -12,3 +12,20 @@ Evaluator accepted reproduction and coverage but returned FAIL_PLAN for five und PLAN-EVAL cycle two PASS: https://github.com/rickylabs/netscript/pull/2641#issuecomment-6923762411. All five requested plan repairs accepted; no product implementation preceded approval. New focused regression run at unchanged main source: 9 pass, 2 fail. Child default bind reports 0.0.0.0 instead of 127.0.0.1; OTel exits 0 before the composing runtime's drain/exit 7. Real Redis subprocess baseline already records four watchdog failures. Signal subprocess cases explicitly skip Windows (SIGTERM-specific acceptance). S1 commits the red oracles and accepted plan; S2 will make these regressions pass. Tests requiring new cleanup contracts are added after those contracts exist. No resources remain from reproduction. + +## S2 core lifecycle implementation + +Added explicit child shutdown ownership, loopback hostname override, monotonic total work/cleanup deadlines, and exit codes 0/1/2. Service signal paths reserve cleanup within the total deadline, call singleton-aware closeKv(), disconnect every registered raw-builder DB identity once, and terminate explicitly. Manual stop/external abort and exitOnSignal:false leave process-owned resources to their host. Cleanup invokes all registered resource callbacks even if work or another cleanup hangs. OTel's bounded signal shutdown no longer exits the process. + +| Gate | Result | +| --- | --- | +| Real Redis child/service clean and timeout subprocess tests | exit 0, 4/4 pass; formerly four watchdog failures | +| Child bind/fatal snapshot, service coordinator, OTel focused tests | exit 0, 15/15 pass | +| Expanded cleanup/coordinator tests | exit 0, 8/8 pass | +| Existing listener/builder/runtime embedding tests | exit 0, 34/34 pass | +| Structured targeted type-check | exit 0, no diagnostics | +| Structured lint / format | exit 0 / exit 0 after correcting require-await in test stubs | +| quality:gate (quality:scan + arch:check) | exit 0 | + +Resource teardown preview remained read-only. Owned Redis was removed after exact identity, run-label and bind-mount proof; no foreign or unknown-owner resources changed. S2 adds explicit exitOnSignal:false to two existing embedded signal tests; their hook/listener assertions are retained. Plan file groups updated to 17 (<30) to include these necessary test adaptations and post-contract cleanup tests. +Reconcile: PR remains a draft, status progresses to implementation, source for excluded saga transports is unchanged. S3 composition/docs and the one-pass runtime smoke remain pending; no supervisor sign-off is claimed. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index f31fdce11d..5ce144a614 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -3,3 +3,6 @@ - Owner-selected existing implementation session uses Sol xhigh. All subsequent eval routes follow the pinned matrix with session/family independence. - Current main exposes explicit service hostname options, not the environment convention claimed by #2631. Reuse native hostname option and document this evidence. - Deno KV alone is not a process-retaining handle in this environment; use real Redis sockets to test the reported lifecycle failure. + +- S2 file scope expands from 12 to 17 (<30): embedded signal tests must opt out of process termination, and new cleanup contract tests follow type definition. No acceptance weakened. +- T3 requires a new delegate for each review/re-check; cycle two used the same selected model/route with the full prior verdict carried in its brief instead of re-steering the prior session. Session/family independence remained intact. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md index 6d94853fa9..34c8021b5e 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md @@ -1,3 +1,3 @@ # Resource inspection -Ran the repository teardown preview without --apply. No commands were planned and no foreign or unknown-owner resource was mutated. The reporter found unrelated resources; their operator identities and paths are omitted under the public-repository restriction. The lane owns its Redis test container through the creation receipt, exact container identity, run label and repository bind mount; cleanup verifies those proofs immediately before removal. +Teardown preview was read-only and planned no mutations. Foreign and unknown-owner resources were reviewed and left alone; operator identities and unrelated paths are omitted under the public-repository restriction. The lane Redis test container is removed only after verifying its exact creation identity, run label and repository bind mount. No test subprocess or container remains after S2 validation. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md index 97994018f7..01835cda0a 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md @@ -17,7 +17,7 @@ Each slice is below 30 files, including its run-artifact updates. Product tests | Slice | Proves / gate | Files (maximum) | | --- | --- | --- | | S1 (8 files) | Real Redis subprocess regressions, child bind default/override, database aliases, timeout cleanup and OTel signal non-exit; structured tests demonstrate the main baseline and control cases | `packages/plugin/src/presentation/run-child-health-process_exit_test.ts`; `packages/plugin/src/presentation/run-child-health-process_test.ts`; `packages/service/tests/signal-exit_test.ts`; `packages/service/tests/shutdown-coordinator_test.ts`; new `packages/service/tests/service-resources_test.ts`; `packages/telemetry/tests/adapters/otel_provider_test.ts`; run `worklog.md`, `context-pack.md` | -| S2 (12 files) | Explicit process exit, bounded work/cleanup deadlines, signal-only deduplicated resource disposal; focused S1 tests and structured check/lint/fmt | `packages/plugin/src/presentation/run-child-health-process.ts`; `packages/service/src/types.ts`; `packages/service/src/builder/service-builder-impl.ts`; `packages/service/src/builder/service-listener.ts`; `packages/service/src/builder/service-shutdown.ts`; new `packages/service/src/builder/service-resources.ts` (database identity enumeration/disposal, consumed by builder cleanup); `packages/service/src/presets/define-service.ts`; `packages/telemetry/src/adapters/otel/otel-sdk.ts`; run `plan.md`, `worklog.md`, `context-pack.md`, `drift.md` | +| S2 (17 files) | Explicit process exit, bounded work/cleanup deadlines, signal-only deduplicated resource disposal; focused S1 tests and structured check/lint/fmt | `packages/plugin/src/presentation/run-child-health-process.ts`; `packages/service/src/types.ts`; `packages/service/src/builder/service-builder-impl.ts`; `packages/service/src/builder/service-listener.ts`; `packages/service/src/builder/service-shutdown.ts`; new `packages/service/src/builder/service-resources.ts` (database identity enumeration/disposal, consumed by builder cleanup); `packages/service/src/presets/define-service.ts`; `packages/telemetry/src/adapters/otel/otel-sdk.ts`; `packages/plugin/src/presentation/run-child-health-process_test.ts`; `packages/service/tests/service-builder_test.ts`; `packages/service/tests/listener-hostname_test.ts`; `packages/service/tests/shutdown-coordinator_test.ts`; `packages/service/tests/service-resources_test.ts`; run `plan.md`, `worklog.md`, `context-pack.md`, `drift.md` | | S3a (16 files) | Generated role cleanup closes only acquired handles, including saga bootstrap DB; generator/role tests and scoped gates | workers/sagas/triggers `plugins//src/adapter/resources/glue/runtime.stub.ts` (3); `packages/plugin/src/sdk/runtime/plugin-service-context.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts`; `packages/cli/src/kernel/assets/plugins/service-context.ts.template`; workers/sagas/auth `plugins//services/src/main.ts` (3); `plugins/sagas/src/runtime/saga-runner.ts`; `packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts`; workers/sagas/triggers `plugins//src/adapter/resources/resources.test.ts` (3); run `worklog.md` | | S3b (15 files) | Public shutdown/hostname/budget/OTel semantics and generated assets agree; docs:accuracy, corpus freshness, release:preflight and JSR audits | `packages/plugin/README.md`; `packages/service/README.md`; `packages/telemetry/README.md`; `docs/site/orchestration-runtime/child-health.md`; `docs/site/observability/telemetry.md`; `docs/site/reference/plugin/index.md`; `docs/site/reference/service/index.md`; `docs/site/reference/telemetry/index.md`; generated CLI `embedded.generated.ts` and plugin `embedded.generated.ts` under their `src/kernel/assets/`; `packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts`; generated MCP export-surface corpus; run `worklog.md`, `context-pack.md`, `drift.md` | | S4 (4 run files) | One-pass `deno task e2e:cli run scaffold.runtime --cleanup --format pretty`, health checks including hostname overrides, all scoped/static gates, independent IMPL-EVAL | run `worklog.md`, `context-pack.md`, `drift.md`, `evaluate.md`; no production files | diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 26bb4217cf..2970a1904d 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -29,3 +29,20 @@ Evaluator accepted reproduction and coverage but returned FAIL_PLAN for five und PLAN-EVAL cycle two PASS: https://github.com/rickylabs/netscript/pull/2641#issuecomment-6923762411. All five requested plan repairs accepted; no product implementation preceded approval. New focused regression run at unchanged main source: 9 pass, 2 fail. Child default bind reports 0.0.0.0 instead of 127.0.0.1; OTel exits 0 before the composing runtime's drain/exit 7. Real Redis subprocess baseline already records four watchdog failures. Signal subprocess cases explicitly skip Windows (SIGTERM-specific acceptance). S1 commits the red oracles and accepted plan; S2 will make these regressions pass. Tests requiring new cleanup contracts are added after those contracts exist. No resources remain from reproduction. + +## S2 core lifecycle implementation + +Added explicit child shutdown ownership, loopback hostname override, monotonic total work/cleanup deadlines, and exit codes 0/1/2. Service signal paths reserve cleanup within the total deadline, call singleton-aware closeKv(), disconnect every registered raw-builder DB identity once, and terminate explicitly. Manual stop/external abort and exitOnSignal:false leave process-owned resources to their host. Cleanup invokes all registered resource callbacks even if work or another cleanup hangs. OTel's bounded signal shutdown no longer exits the process. + +| Gate | Result | +| --- | --- | +| Real Redis child/service clean and timeout subprocess tests | exit 0, 4/4 pass; formerly four watchdog failures | +| Child bind/fatal snapshot, service coordinator, OTel focused tests | exit 0, 15/15 pass | +| Expanded cleanup/coordinator tests | exit 0, 8/8 pass | +| Existing listener/builder/runtime embedding tests | exit 0, 34/34 pass | +| Structured targeted type-check | exit 0, no diagnostics | +| Structured lint / format | exit 0 / exit 0 after correcting require-await in test stubs | +| quality:gate (quality:scan + arch:check) | exit 0 | + +Resource teardown preview remained read-only. Owned Redis was removed after exact identity, run-label and bind-mount proof; no foreign or unknown-owner resources changed. S2 adds explicit exitOnSignal:false to two existing embedded signal tests; their hook/listener assertions are retained. Plan file groups updated to 17 (<30) to include these necessary test adaptations and post-contract cleanup tests. +Reconcile: PR remains a draft, status progresses to implementation, source for excluded saga transports is unchanged. S3 composition/docs and the one-pass runtime smoke remain pending; no supervisor sign-off is claimed. diff --git a/packages/plugin/src/presentation/run-child-health-process.ts b/packages/plugin/src/presentation/run-child-health-process.ts index 0ba0f1a81f..7b95d09c0c 100644 --- a/packages/plugin/src/presentation/run-child-health-process.ts +++ b/packages/plugin/src/presentation/run-child-health-process.ts @@ -18,6 +18,16 @@ import { FileChildRestartHistory } from '../adapters/file-child-restart-history. export type ChildHealthProcessOptions = Readonly<{ /** Use the runtime's monitor for both process failure and extended snapshot diagnostics. */ health?: ChildHealthMonitor; + /** Bind address; defaults to loopback. Pass '0.0.0.0' for container ingress. */ + hostname?: string; + /** Total shutdown budget, including cleanup; defaults to 35_000 ms (30 s work + 5 s cleanup). */ + drainTimeoutMs?: number; + /** Reserved portion of the total budget; defaults to min(5_000, drainTimeoutMs / 5). */ + cleanupTimeoutMs?: number; + /** Owned resource cleanups, invoked after drain, including when drain times out. */ + onShutdown?: readonly (() => void | Promise)[]; + /** Explicitly exit 0 clean, 1 failed or 2 timed out; defaults to true. False supports embedding. */ + exitOnShutdown?: boolean; /** Persistent file owned by exactly one background resource; relative to its working directory. */ restartHistoryPath?: string; }>; @@ -28,7 +38,8 @@ export type ChildHealthProcessOptions = Readonly<{ * Signal handlers and the health listener are owned by this process, independent * of a frontend session. Fatal causes remain in server logs, never in the payload, * and set the process exit code to one. The child must drain when its signal is aborted. - * After the fatal grace period, rejects with PluginError for the executable's crash boundary. + * Work drains before owned cleanups within the total budget. With exitOnShutdown false, + * failures reject with PluginError instead of terminating the embedding process. * * @example * ```ts @@ -46,6 +57,11 @@ export async function runChildHealthProcess( snapshot?: () => ChildHealthSnapshot | undefined | Promise, options: ChildHealthProcessOptions = {}, ): Promise { + const totalMs = shutdownMilliseconds(options.drainTimeoutMs, 35_000); + const cleanupMs = Math.min( + totalMs, + shutdownMilliseconds(options.cleanupTimeoutMs, Math.min(5_000, totalMs / 5)), + ); const port = Number(Deno.env.get('PORT') ?? '0'); if (!Number.isSafeInteger(port) || port < 0 || port > 65_535) { throw new Error('Invalid background child health port.'); @@ -55,9 +71,10 @@ export async function runChildHealthProcess( const healthReads = new AbortController(); let latest: ChildHealthSnapshot | undefined; let terminal: ChildHealthSnapshot | undefined; + let shutdownStarted: number | undefined; let failureTimer: ReturnType | undefined; const server = Deno.serve( - { port }, + { port, hostname: options.hostname ?? '127.0.0.1' }, async (request) => { if (terminal) return childHealthResponse(request, terminal); const interrupted = Promise.withResolvers(); @@ -80,6 +97,7 @@ export async function runChildHealthProcess( ? ['SIGINT', 'SIGBREAK'] : ['SIGINT', 'SIGTERM']; const stop = (): void => { + shutdownStarted ??= performance.now(); controller.abort(); healthReads.abort(); }; @@ -128,17 +146,65 @@ export async function runChildHealthProcess( }, failed, ); + await new Promise((resolve) => { + if (controller.signal.aborted) resolve(); + else controller.signal.addEventListener('abort', () => resolve(), { once: true }); + }); + const deadline = (shutdownStarted ?? performance.now()) + totalMs; + let timedOut = false; + let cleanupFailed = false; try { - await new Promise((resolve) => - controller.signal.addEventListener('abort', () => resolve(), { once: true }) - ); - await completion; - if (!terminal) health.stopped(); + timedOut = !await withinShutdownDeadline(completion, deadline - cleanupMs); + if (!terminal && !timedOut) health.stopped(); + } catch (cause) { + cleanupFailed = true; + console.error('Background child drain failed:', cause); } finally { clearTimeout(failureTimer); for (const signal of signals) Deno.removeSignalListener(signal, stop); - await server.shutdown(); + // Start every cleanup, even if another cleanup hangs or the work budget expired. + const cleanups = [...(options.onShutdown ?? [])].reverse(); + cleanups.push(() => server.shutdown()); + const cleanup = Promise.all(cleanups.map(async (close) => { + try { + await close(); + } catch (cause) { + cleanupFailed = true; + console.error('Background child cleanup failed:', cause); + } + })).then(() => undefined); + timedOut = !await withinShutdownDeadline(cleanup, deadline) || timedOut; + } + const exitCode = timedOut ? 2 : terminal || cleanupFailed ? 1 : 0; + if (options.exitOnShutdown !== false) Deno.exit(exitCode); + if (terminal || cleanupFailed || timedOut) { + throw new PluginError( + timedOut + ? 'Background child shutdown timed out.' + : 'Background child failed (details redacted).', + ); + } +} + +function shutdownMilliseconds(value: number | undefined, fallback: number): number { + if (value === undefined) return fallback; + if (!Number.isFinite(value) || value < 0) throw new RangeError('Invalid child shutdown budget.'); + return value; +} + +async function withinShutdownDeadline( + operation: Promise, + deadline: number, +): Promise { + let timer: ReturnType | undefined; + try { + return await Promise.race([ + operation.then(() => true), + new Promise((resolve) => { + timer = setTimeout(() => resolve(false), Math.max(0, deadline - performance.now())); + }), + ]); + } finally { + clearTimeout(timer); } - // Bootstrap may leave dependency handles alive; a fatal process must still terminate. - if (terminal) throw new PluginError('Background child failed (details redacted).'); } diff --git a/packages/plugin/src/presentation/run-child-health-process_test.ts b/packages/plugin/src/presentation/run-child-health-process_test.ts index 7acb025358..58ed838a70 100644 --- a/packages/plugin/src/presentation/run-child-health-process_test.ts +++ b/packages/plugin/src/presentation/run-child-health-process_test.ts @@ -34,7 +34,7 @@ Deno.test('child health HTTP transport awaits asynchronous durable snapshot read await Promise.resolve(); assert(monitor); return { ...monitor.snapshot(), deadLetters: { available: true, depth: 7 } }; - }); + }, { exitOnShutdown: false }); void running.catch(() => undefined); try { const addr = await listening.promise; @@ -79,7 +79,7 @@ Deno.test('fatal child failure drains even when a health snapshot never settles' }, () => { reading.resolve(); return blockedSnapshot.promise; - }); + }, { exitOnShutdown: false }); void running.catch(() => undefined); let request: Promise | undefined; try { diff --git a/packages/service/src/builder/service-builder-impl.ts b/packages/service/src/builder/service-builder-impl.ts index e88177bbbc..2fbcac7098 100644 --- a/packages/service/src/builder/service-builder-impl.ts +++ b/packages/service/src/builder/service-builder-impl.ts @@ -59,6 +59,11 @@ import type { ServiceRateLimitOptions } from '../rate-limit/middleware/options.t import type { ServiceBuilder, ServiceConfig } from './service-builder.ts'; import { resolveRpcWiringPaths, type RpcWiringOptions, wireRpc } from './service-rpc.ts'; import { startServiceListener } from './service-listener.ts'; +import { + disconnectServiceDatabases, + registerServiceDatabases, + type ServiceDatabaseResource, +} from './service-resources.ts'; interface DeferredRoute { readonly method: ServiceRouteMethod; @@ -92,6 +97,7 @@ export class ServiceBuilderImpl< private shutdownHooks: ShutdownHook[] = []; private contextFactory: ContextFactory = () => ({}) as TCustom; private database: DbContext | null = null; + private readonly databaseResources = new Set(); private authnOptions: AuthnOptions | null = null; private authzOptions: AuthzOptions | null = null; private authInstalled = false; @@ -169,6 +175,7 @@ export class ServiceBuilderImpl< ): ServiceBuilder { // Store database reference for context injection this.database = db; + registerServiceDatabases(this.databaseResources, db); // Wire up health + readiness checks only when a $queryRaw-capable client is supplied. // For single-db usage pass `db` directly; for multi-db pass the primary client separately. @@ -622,6 +629,7 @@ export class ServiceBuilderImpl< this.config.port ?? 3000, options, this.shutdownHooks, + [() => disconnectServiceDatabases(this.databaseResources)], ); } } diff --git a/packages/service/src/builder/service-listener.ts b/packages/service/src/builder/service-listener.ts index 5280dd294e..aa45455907 100644 --- a/packages/service/src/builder/service-listener.ts +++ b/packages/service/src/builder/service-listener.ts @@ -19,6 +19,7 @@ */ import { createServiceLogger } from '@netscript/logger'; +import { closeKv } from '@netscript/kv'; import type { RunningService, RunningServiceAddress, @@ -87,6 +88,7 @@ export function startServiceListener( defaultPort: number, options?: ServeOptions, shutdownHooks: readonly ShutdownHook[] = [], + processCleanupHooks: readonly ShutdownHook[] = [], ): RunningService { const serviceLogger = createServiceLogger(serviceName); const port = options?.port ?? defaultPort; @@ -137,6 +139,12 @@ export function startServiceListener( }, hooks: shutdownHooks, drainTimeoutMs: options?.drainTimeoutMs, + cleanupTimeoutMs: options?.cleanupTimeoutMs, + cleanups: options?.exitOnSignal === false ? [] : [ + ...processCleanupHooks, + ...(options?.onCleanup ?? []), + () => closeKv(), + ], }); const stopWithReport = async ( @@ -152,9 +160,13 @@ export function startServiceListener( const stopAndLog = async (reason: 'manual' | 'signal', signal?: Deno.Signal): Promise => { const report = await stopWithReport(reason, signal); - if (shutdownLogged) return; - shutdownLogged = true; - logShutdownReport(serviceLogger, serviceName, report); + if (!shutdownLogged) { + shutdownLogged = true; + logShutdownReport(serviceLogger, serviceName, report); + } + if (reason === 'signal' && options?.exitOnSignal !== false) { + Deno.exit(report.timedOut ? 2 : report.hooks.some((hook) => !hook.ok) ? 1 : 0); + } }; if (options?.signal?.aborted) { @@ -184,6 +196,7 @@ export function startServiceListener( signal, error, }); + if (options?.exitOnSignal !== false) Deno.exit(1); }); }; Deno.addSignalListener(signal, handler); diff --git a/packages/service/src/builder/service-resources.ts b/packages/service/src/builder/service-resources.ts new file mode 100644 index 0000000000..cf5391244d --- /dev/null +++ b/packages/service/src/builder/service-resources.ts @@ -0,0 +1,41 @@ +/** Signal-owned database disposal for the service builder. @module */ +import type { DbContext } from '../types.ts'; + +/** Minimal Prisma lifecycle contract, independent of a particular provider. */ +export interface ServiceDatabaseResource { + /** Disconnect this already-acquired client. */ + $disconnect(): Promise; +} + +/** Record already-acquired clients, deduplicating multi-database aliases by identity. */ +export function registerServiceDatabases( + resources: Set, + database: DbContext, +): void { + if (isDatabaseResource(database)) resources.add(database); + else {for (const value of Object.values(database)) { + if (isDatabaseResource(value)) resources.add(value); + }} +} + +/** Attempt every registered disconnect exactly once, including when another fails. */ +export async function disconnectServiceDatabases( + resources: Set, +): Promise { + const clients = [...resources]; + resources.clear(); + const results = await Promise.allSettled( + clients.map(async (client) => await client.$disconnect()), + ); + const failures = results.filter((result): result is PromiseRejectedResult => + result.status === 'rejected' + ); + if (failures.length) { + throw new AggregateError(failures.map((result) => result.reason), 'Database cleanup failed.'); + } +} + +function isDatabaseResource(value: unknown): value is ServiceDatabaseResource { + return typeof value === 'object' && value !== null && + typeof Reflect.get(value, '$disconnect') === 'function'; +} diff --git a/packages/service/src/builder/service-shutdown.ts b/packages/service/src/builder/service-shutdown.ts index a7460f043a..b0436b4805 100644 --- a/packages/service/src/builder/service-shutdown.ts +++ b/packages/service/src/builder/service-shutdown.ts @@ -23,6 +23,8 @@ interface ServiceShutdownCoordinatorOptions { readonly shutdownServer: () => Promise; readonly awaitServerFinished: () => Promise; readonly hooks?: readonly ShutdownHook[]; + readonly cleanups?: readonly ShutdownHook[]; + readonly cleanupTimeoutMs?: number; readonly drainTimeoutMs?: number; } @@ -47,6 +49,8 @@ export class ServiceShutdownCoordinator { readonly #awaitServerFinished: () => Promise; readonly #hooks: readonly ShutdownHook[]; readonly #drainTimeoutMs: number; + readonly #cleanups: readonly ShutdownHook[]; + readonly #cleanupTimeoutMs: number; #shutdownPromise: Promise | undefined; constructor(options: ServiceShutdownCoordinatorOptions) { @@ -55,6 +59,11 @@ export class ServiceShutdownCoordinator { this.#awaitServerFinished = options.awaitServerFinished; this.#hooks = [...(options.hooks ?? [])]; this.#drainTimeoutMs = normalizeDrainTimeout(options.drainTimeoutMs); + this.#cleanups = [...(options.cleanups ?? [])]; + const reserve = options.cleanupTimeoutMs ?? Math.min(5_000, this.#drainTimeoutMs / 5); + this.#cleanupTimeoutMs = Number.isFinite(reserve) + ? Math.max(0, Math.min(reserve, this.#drainTimeoutMs)) + : Math.min(5_000, this.#drainTimeoutMs / 5); } /** @@ -72,10 +81,15 @@ export class ServiceShutdownCoordinator { reason: ShutdownReason, signal?: Deno.Signal, ): Promise { - const budget: ShutdownBudget = { + const cleanup = reason === 'signal' ? this.#cleanups : []; + const totalBudget: ShutdownBudget = { startedAt: performance.now(), timeoutMs: this.#drainTimeoutMs, }; + const budget = { + ...totalBudget, + timeoutMs: this.#drainTimeoutMs - (cleanup.length ? this.#cleanupTimeoutMs : 0), + }; const hooks: ShutdownHookOutcome[] = []; let timedOut = false; @@ -88,6 +102,9 @@ export class ServiceShutdownCoordinator { budget, ); timedOut = timedOut || shutdownResult.status === 'timed-out'; + if (shutdownResult.status === 'failed') { + hooks.push({ ok: false, error: normalizeErrorMessage(shutdownResult.error) }); + } if (!timedOut) { for (let index = this.#hooks.length - 1; index >= 0; index -= 1) { @@ -124,13 +141,33 @@ export class ServiceShutdownCoordinator { budget, ); timedOut = timedOut || finishedResult.status === 'timed-out'; + if (finishedResult.status === 'failed') { + hooks.push({ ok: false, error: normalizeErrorMessage(finishedResult.error) }); + } } - return { - reason, - timedOut, - hooks, - }; + // Invoke all owned cleanups in reverse registration order, independently of + // work-drain success. A hung or failed cleanup cannot suppress another. + const outcomes: ShutdownHookOutcome[] = cleanup.map(() => ({ + ok: false, + error: 'resource cleanup timed out', + })); + const pending = [...cleanup].reverse().map((hook, index) => + Promise.resolve().then(() => hook({ reason, signal })).then( + () => { + outcomes[index] = { ok: true }; + }, + (error: unknown) => { + outcomes[index] = { ok: false, error: normalizeErrorMessage(error) }; + }, + ) + ); + if (pending.length) { + const result = await runWithinRemainingBudget(() => Promise.all(pending), totalBudget); + timedOut = timedOut || result.status === 'timed-out'; + hooks.push(...outcomes); + } + return { reason, timedOut, hooks }; } } diff --git a/packages/service/src/presets/define-service.ts b/packages/service/src/presets/define-service.ts index 2256d0b3c6..f64217ec18 100644 --- a/packages/service/src/presets/define-service.ts +++ b/packages/service/src/presets/define-service.ts @@ -48,10 +48,6 @@ import type { ServiceTlsOptions, } from '../types.ts'; -interface DisconnectCapableDatabase extends Database { - $disconnect(): Promise; -} - interface DatabaseHealthCandidate { readonly name: string; readonly database: Database; @@ -114,10 +110,6 @@ function isDatabase(value: unknown): value is Database { typeof (value as { $queryRaw?: unknown }).$queryRaw === 'function'; } -function isDisconnectCapableDatabase(value: Database): value is DisconnectCapableDatabase { - return typeof (value as { $disconnect?: unknown }).$disconnect === 'function'; -} - /** * Options for defineService preset. */ @@ -331,12 +323,6 @@ export async function defineService( database: healthCheckDb, }), ); - - if (isDisconnectCapableDatabase(healthCheckDb)) { - builder.onShutdown(async () => { - await healthCheckDb.$disconnect(); - }); - } } } diff --git a/packages/service/src/types.ts b/packages/service/src/types.ts index 1c7a5a313a..386d9adb13 100644 --- a/packages/service/src/types.ts +++ b/packages/service/src/types.ts @@ -202,9 +202,21 @@ export interface ServeOptions { /** External signal that stops the listener when aborted. */ signal?: AbortSignal; - /** Max time to wait for in-flight requests and shutdown hooks. Defaults to `30_000`. */ + /** + * Total shutdown budget. Defaults to 30_000 ms; process-owned signal shutdown + * reserves min(5_000, one fifth) for resource cleanup (25 s work + 5 s cleanup). + */ drainTimeoutMs?: number; + /** Reserved process cleanup budget within drainTimeoutMs; defaults to min(5_000, one fifth). */ + cleanupTimeoutMs?: number; + + /** Owned resource cleanup hooks, run on process-owned signals even when work drain times out. */ + onCleanup?: readonly ShutdownHook[]; + + /** Exit 0 clean, 1 failed, 2 timed out after a signal. False leaves ownership to the host. */ + exitOnSignal?: boolean; + /** Install SIGINT/SIGTERM or SIGBREAK handlers. Defaults to `true`. */ handleSignals?: boolean; diff --git a/packages/service/tests/listener-hostname_test.ts b/packages/service/tests/listener-hostname_test.ts index 07ba6c8ca9..973e0cb2b5 100644 --- a/packages/service/tests/listener-hostname_test.ts +++ b/packages/service/tests/listener-hostname_test.ts @@ -339,7 +339,7 @@ Deno.test('a loopback listener installs, runs, and removes its OS signal handler .onShutdown((context) => { contexts.push(context); }) - .serve({ hostname: LOOPBACK, port: 0 }); + .serve({ hostname: LOOPBACK, port: 0, exitOnSignal: false }); const origin = `http://${LOOPBACK}:${running.addr.port}`; const platformSignals = [...shutdownSignalsForCurrentPlatform()]; diff --git a/packages/service/tests/service-builder_test.ts b/packages/service/tests/service-builder_test.ts index be83d9dfeb..bfc765c405 100644 --- a/packages/service/tests/service-builder_test.ts +++ b/packages/service/tests/service-builder_test.ts @@ -156,7 +156,7 @@ Deno.test('onShutdown hooks run when a handled signal fires', async () => { .onShutdown(() => { hookCalls += 1; }) - .serve({ port: 0 }); + .serve({ port: 0, exitOnSignal: false }); capturedHandler?.(); await running.stop(); diff --git a/packages/service/tests/service-resources_test.ts b/packages/service/tests/service-resources_test.ts new file mode 100644 index 0000000000..8e532b7a6a --- /dev/null +++ b/packages/service/tests/service-resources_test.ts @@ -0,0 +1,53 @@ +import { assertEquals, assertRejects } from '@std/assert'; +import { + disconnectServiceDatabases, + registerServiceDatabases, + type ServiceDatabaseResource, +} from '../src/builder/service-resources.ts'; + +Deno.test('database resource cleanup deduplicates aliases and repeated registration', async () => { + const calls: string[] = []; + const one = { + $disconnect() { + calls.push('one'); + return Promise.resolve(); + }, + }; + const two = { + $disconnect() { + calls.push('two'); + return Promise.resolve(); + }, + }; + const resources = new Set(); + registerServiceDatabases(resources, { first: one, alias: one, second: two }); + registerServiceDatabases(resources, one); + await disconnectServiceDatabases(resources); + await disconnectServiceDatabases(resources); + assertEquals(calls, ['one', 'two']); +}); + +Deno.test('database cleanup attempts every client after a failure and never resolves lazy accessors', async () => { + let resolved = 0; + let closed = 0; + const resources = new Set(); + registerServiceDatabases(resources, { + getClient: () => { + resolved++; + }, + failed: { + $disconnect() { + return Promise.reject(new Error('disconnect failed')); + }, + }, + healthy: { + $disconnect() { + closed++; + return Promise.resolve(); + }, + }, + }); + await assertRejects(() => disconnectServiceDatabases(resources), AggregateError); + assertEquals(resolved, 0); + assertEquals(closed, 1); +}); diff --git a/packages/service/tests/shutdown-coordinator_test.ts b/packages/service/tests/shutdown-coordinator_test.ts index 90968db718..2408c9335e 100644 --- a/packages/service/tests/shutdown-coordinator_test.ts +++ b/packages/service/tests/shutdown-coordinator_test.ts @@ -108,3 +108,46 @@ Deno.test('shutdown coordinator reports hook timeout without hanging', async () assertEquals(report.timedOut, true); assertEquals(report.hooks, [{ ok: false, error: 'shutdown hook timed out' }]); }); + +Deno.test('signal shutdown reserves cleanup after a hung work hook and attempts every cleanup', async () => { + const calls: string[] = []; + const coordinator = new ServiceShutdownCoordinator({ + controller: new AbortController(), + shutdownServer: () => Promise.resolve(), + awaitServerFinished: () => Promise.resolve(), + hooks: [() => new Promise(() => {})], + cleanups: [ + () => { + calls.push('first'); + }, + () => { + calls.push('hung'); + return new Promise(() => {}); + }, + () => { + calls.push('failed'); + throw new Error('cleanup failure'); + }, + ], + drainTimeoutMs: 100, + cleanupTimeoutMs: 50, + }); + const report = await coordinator.runShutdown('signal', 'SIGTERM'); + assertEquals(calls, ['failed', 'hung', 'first']); + assertEquals(report.timedOut, true); + assertEquals(report.hooks.filter((hook) => !hook.ok).length, 3); +}); + +Deno.test('manual shutdown leaves process-owned cleanup to its embedding host', async () => { + let cleaned = false; + const coordinator = new ServiceShutdownCoordinator({ + controller: new AbortController(), + shutdownServer: () => Promise.resolve(), + awaitServerFinished: () => Promise.resolve(), + cleanups: [() => { + cleaned = true; + }], + }); + await coordinator.runShutdown('manual'); + assertEquals(cleaned, false); +}); diff --git a/packages/telemetry/src/adapters/otel/otel-sdk.ts b/packages/telemetry/src/adapters/otel/otel-sdk.ts index d1cd42c7cb..c1d4217103 100644 --- a/packages/telemetry/src/adapters/otel/otel-sdk.ts +++ b/packages/telemetry/src/adapters/otel/otel-sdk.ts @@ -313,9 +313,17 @@ export class OtelSdkTracerProvider implements TracerProviderPort { }; readonly #onSigterm = (): void => { - void this.shutdown().finally(() => { - Deno.exit(0); - }); + // The composing runtime owns termination and the exit code after its drain. + // SDK shutdown removes listeners before awaiting exporters; a stalled exporter + // cannot retain this signal flush indefinitely. + let timer: ReturnType | undefined; + void Promise.race([ + this.shutdown(), + new Promise((resolve) => { + timer = setTimeout(resolve, 5_000); + Deno.unrefTimer(timer); + }), + ]).catch(() => undefined).finally(() => clearTimeout(timer)); }; /** From eab4bc2ba797dca5dfab6036497fe40673375dde Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 18:42:34 +0100 Subject: [PATCH 07/19] fix(runtime): dispose generated role resources without acquiring unused clients --- .../context-pack.md | 7 +++ .../drift.md | 4 ++ .../plan.md | 6 +-- .../worklog.md | 7 +++ .../src/kernel/assets/embedded.generated.ts | 2 +- .../plugins/service-context.ts.template | 44 ++++++++++++++++++- .../plugins/generate-plugin-service_test.ts | 33 ++++++++++++++ .../runtime/plugin-service-context-factory.ts | 4 ++ .../plugin-service-context-factory_test.ts | 26 +++++++++++ .../src/sdk/runtime/plugin-service-context.ts | 2 + .../src/builder/service-builder-impl.ts | 4 +- packages/service/src/types.ts | 3 ++ .../service/tests/service-resources_test.ts | 30 +++++++++++++ .../auth/services/src/auth-service-runtime.ts | 2 +- plugins/sagas/services/src/main.ts | 2 +- .../adapter/resources/glue/runtime.stub.ts | 15 ++++++- .../adapter/resources/glue/runtime.stub.ts | 11 +++++ plugins/workers/services/src/main.ts | 1 + .../adapter/resources/glue/runtime.stub.ts | 11 +++++ 19 files changed, 205 insertions(+), 9 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index dd116f478b..dbca289ea7 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -29,3 +29,10 @@ Added explicit child shutdown ownership, loopback hostname override, monotonic t Resource teardown preview remained read-only. Owned Redis was removed after exact identity, run-label and bind-mount proof; no foreign or unknown-owner resources changed. S2 adds explicit exitOnSignal:false to two existing embedded signal tests; their hook/listener assertions are retained. Plan file groups updated to 17 (<30) to include these necessary test adaptations and post-contract cleanup tests. Reconcile: PR remains a draft, status progresses to implementation, source for excluded saga transports is unchanged. S3 composition/docs and the one-pass runtime smoke remain pending; no supervisor sign-off is claimed. + +## S3a generated resource ownership + +Added optional, idempotent owner disposal to PluginServiceContext without resolving unused adapters. Generated host bootstrap tracks only acquired Prisma identities; its callback attempts every disconnect once. Workers/sagas/auth service composition invokes it in reserved signal cleanup; workers/sagas/triggers child glue calls singleton closeKv and the generated host callback. Saga DB acquisitions are covered through their existing host resolver. Native embedded hosts retain ownership on manual stop. Explicit host DB disposal disables duplicate automatic raw-builder disposal. + +Generated-owner tests first failed 2/37 with missing disposal against the old embedded template. After canonical gen:assets-barrel, the suite passes 37/37, including all three installed runtime artifacts, acquired/unused generated DB cases, lazy owner disposal and a real signal proving exactly one disconnect. Structured changed-source check passes (14 files); non-CLI lint/fmt passes with no findings. CLI files require the repository's explicit CLI quality config because the root config excludes them; separate wrappers validate them. No lock changes or new dependencies. +Reconcile: #2630/#2631 acceptance implementation is progressing; generated runtime smoke, documentation/assets and independent IMPL-EVAL remain. No foreign resources are running for this slice. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index 5ce144a614..ab98953ae5 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -6,3 +6,7 @@ - S2 file scope expands from 12 to 17 (<30): embedded signal tests must opt out of process termination, and new cleanup contract tests follow type definition. No acceptance weakened. - T3 requires a new delegate for each review/re-check; cycle two used the same selected model/route with the full prior verdict carried in its brief instead of re-steering the prior session. Session/family independence remained intact. + +- S3 composition revealed the same DB client can be both raw-builder registered and owned by the host disposal callback. Added disposeDatabaseOnSignal (default true); generated service composition sets false when its explicit context disposer owns DB cleanup. A real signal subprocess proves exactly one disconnect. This keeps the accepted ownership rule without a global registry. +- Auth serve wiring lives in auth-service-runtime.ts, so that sibling composition file changes instead of main.ts. Sagas runner DB acquisition is already tracked by the generated host resolver; no runner implementation edit is needed. Generated host disposal handles DB only; process edges call closeKv once. +- S2 touched 18 files including its scrubbed resource evidence, still below 30. S3a expands to at most 22 to include the ownership refinement and tests. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md index 01835cda0a..a0f68ca708 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md @@ -6,7 +6,7 @@ Resolve #2630 and #2631 together. No merge/publication, no saga transport modifi 1. **Final termination is explicit on every process-owned path.** After drain/cleanup completes or expires, invoke Deno.exit with the computed code on clean, fatal and timed-out paths; never rely on natural event-loop drain. ChildHealthProcessOptions gains hostname (default loopback, explicit override), drainTimeoutMs (35 s total including up to 5 s reserved for cleanup), bounded onShutdown hooks, and exitOnShutdown (default true for process ownership; false for embedded/tests). Preserve the one-second observable fatal-health grace. Exit 0 clean, 1 fatal/cleanup failure, 2 drain timeout. The default work drain is 30 s; cleanupTimeoutMs defaults to min(5 s, one fifth of the total). The total bound includes closing the health listener; the pre-existing one-second fatal-observation grace precedes this bound. 2. Service signal shutdown explicitly invokes Deno.exit with the computed code after drain and resource cleanup, on clean and failed paths symmetrically. It uses the same exit-code vocabulary. Manual stop and external cancellation remain embeddable; an explicit exitOnSignal option lets a host retain process ownership. Shutdown hook failures are nonzero. Hooks are attempted on timeout rather than skipped; a cleanup phase reserved within the existing 30 s total (default min(5 s, one fifth of total)) prevents one hook from hanging process termination. A timed-out work-drain hook cannot prevent remaining resource cleanups from being invoked. Existing LIFO ordering and idempotency remain. -3. Close process-owned shared KV (and its Redis client/subscriber) on executable-role signal shutdown by calling the singleton-aware closeKv(), a no-op when unused. Never use the lazy PluginServiceContext KV wrapper close() for process disposal: it resolves-on-close and is not a disposal path for these roles. Add explicit cleanup callbacks to generated background glue. Generated host bootstrap tracks only DB clients it actually acquired and provides an idempotent disposal callback; never resolve an unused DB merely to close it. Add optional disposal to PluginServiceContext so generated service entrypoints can register owner-provided cleanup. Native caller-owned contexts stay untouched unless their host explicitly supplies disposal. +3. Close process-owned shared KV (and its Redis client/subscriber) on executable-role signal shutdown by calling the singleton-aware closeKv(), a no-op when unused. Never use the lazy PluginServiceContext KV wrapper close() for process disposal: it resolves-on-close and is not a disposal path for these roles. Add explicit cleanup callbacks to generated background glue. Generated host bootstrap tracks only DB clients it actually acquired and provides an idempotent disposal callback; never resolve an unused DB merely to close it. Add optional disposal to PluginServiceContext so generated service entrypoints can register owner-provided cleanup. Native caller-owned contexts stay untouched unless their host explicitly supplies disposal. When that callback owns database disposal, ServeOptions.disposeDatabaseOnSignal:false disables automatic raw-builder database disposal to avoid double-disconnecting the same client; default remains true. KV is disposed once by the process edge, not by the generated database callback. 4. Register identity-deduplicated Prisma $disconnect cleanup at the raw service builder withDatabase boundary, inherited by defineService and createPluginService. Run it in the reserved, signal-path-only cleanup phase so the raw-builder S1 subprocess test passes and aliases disconnect exactly once. Remove the redundant preset-only health-client hook. Prisma cleanup covers every acquired client, not only the health-check client. Standard sagas background wiring must dispose its acquired host DB context as well as shared KV. The builder records already-supplied DB client identities; generated composition supplies disposal for separately acquired host DB clients. No cleanup resolves a new database. Manual stop/external cancellation do not invoke process-owned KV/DB disposal; opaque embedded caller resources remain host-owned. 5. OTel's SIGTERM handler retains bounded flush and listener removal but drops Deno.exit entirely. This deliberately changes standalone SDK behavior: embedders without a NetScript runtime compose a runtime or own signal termination themselves. Document this in the S3 telemetry documentation and include it in docs:accuracy scope; the composing runtime owns all exit codes. @@ -17,8 +17,8 @@ Each slice is below 30 files, including its run-artifact updates. Product tests | Slice | Proves / gate | Files (maximum) | | --- | --- | --- | | S1 (8 files) | Real Redis subprocess regressions, child bind default/override, database aliases, timeout cleanup and OTel signal non-exit; structured tests demonstrate the main baseline and control cases | `packages/plugin/src/presentation/run-child-health-process_exit_test.ts`; `packages/plugin/src/presentation/run-child-health-process_test.ts`; `packages/service/tests/signal-exit_test.ts`; `packages/service/tests/shutdown-coordinator_test.ts`; new `packages/service/tests/service-resources_test.ts`; `packages/telemetry/tests/adapters/otel_provider_test.ts`; run `worklog.md`, `context-pack.md` | -| S2 (17 files) | Explicit process exit, bounded work/cleanup deadlines, signal-only deduplicated resource disposal; focused S1 tests and structured check/lint/fmt | `packages/plugin/src/presentation/run-child-health-process.ts`; `packages/service/src/types.ts`; `packages/service/src/builder/service-builder-impl.ts`; `packages/service/src/builder/service-listener.ts`; `packages/service/src/builder/service-shutdown.ts`; new `packages/service/src/builder/service-resources.ts` (database identity enumeration/disposal, consumed by builder cleanup); `packages/service/src/presets/define-service.ts`; `packages/telemetry/src/adapters/otel/otel-sdk.ts`; `packages/plugin/src/presentation/run-child-health-process_test.ts`; `packages/service/tests/service-builder_test.ts`; `packages/service/tests/listener-hostname_test.ts`; `packages/service/tests/shutdown-coordinator_test.ts`; `packages/service/tests/service-resources_test.ts`; run `plan.md`, `worklog.md`, `context-pack.md`, `drift.md` | -| S3a (16 files) | Generated role cleanup closes only acquired handles, including saga bootstrap DB; generator/role tests and scoped gates | workers/sagas/triggers `plugins//src/adapter/resources/glue/runtime.stub.ts` (3); `packages/plugin/src/sdk/runtime/plugin-service-context.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts`; `packages/cli/src/kernel/assets/plugins/service-context.ts.template`; workers/sagas/auth `plugins//services/src/main.ts` (3); `plugins/sagas/src/runtime/saga-runner.ts`; `packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts`; workers/sagas/triggers `plugins//src/adapter/resources/resources.test.ts` (3); run `worklog.md` | +| S2 (18 files including resource evidence) | Explicit process exit, bounded work/cleanup deadlines, signal-only deduplicated resource disposal; focused S1 tests and structured check/lint/fmt | `packages/plugin/src/presentation/run-child-health-process.ts`; `packages/service/src/types.ts`; `packages/service/src/builder/service-builder-impl.ts`; `packages/service/src/builder/service-listener.ts`; `packages/service/src/builder/service-shutdown.ts`; new `packages/service/src/builder/service-resources.ts` (database identity enumeration/disposal, consumed by builder cleanup); `packages/service/src/presets/define-service.ts`; `packages/telemetry/src/adapters/otel/otel-sdk.ts`; `packages/plugin/src/presentation/run-child-health-process_test.ts`; `packages/service/tests/service-builder_test.ts`; `packages/service/tests/listener-hostname_test.ts`; `packages/service/tests/shutdown-coordinator_test.ts`; `packages/service/tests/service-resources_test.ts`; run `plan.md`, `worklog.md`, `context-pack.md`, `drift.md` | +| S3a (22 files maximum) | Generated role cleanup closes only acquired handles, including saga bootstrap DB; generator/role tests and scoped gates | workers/sagas/triggers `plugins//src/adapter/resources/glue/runtime.stub.ts` (3); `packages/plugin/src/sdk/runtime/plugin-service-context.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts`; `packages/cli/src/kernel/assets/plugins/service-context.ts.template`; workers/sagas `plugins//services/src/main.ts` (2), `plugins/auth/services/src/auth-service-runtime.ts`; sagas runner acquisitions are covered by the generated host resolver; no runner edit is needed; `packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts`; workers/sagas/triggers `plugins//src/adapter/resources/resources.test.ts` (3); `packages/service/src/types.ts`, `packages/service/src/builder/service-builder-impl.ts`, `packages/service/tests/service-resources_test.ts` (explicit host database ownership override); run `worklog.md`, `context-pack.md`, `drift.md` | | S3b (15 files) | Public shutdown/hostname/budget/OTel semantics and generated assets agree; docs:accuracy, corpus freshness, release:preflight and JSR audits | `packages/plugin/README.md`; `packages/service/README.md`; `packages/telemetry/README.md`; `docs/site/orchestration-runtime/child-health.md`; `docs/site/observability/telemetry.md`; `docs/site/reference/plugin/index.md`; `docs/site/reference/service/index.md`; `docs/site/reference/telemetry/index.md`; generated CLI `embedded.generated.ts` and plugin `embedded.generated.ts` under their `src/kernel/assets/`; `packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts`; generated MCP export-surface corpus; run `worklog.md`, `context-pack.md`, `drift.md` | | S4 (4 run files) | One-pass `deno task e2e:cli run scaffold.runtime --cleanup --format pretty`, health checks including hostname overrides, all scoped/static gates, independent IMPL-EVAL | run `worklog.md`, `context-pack.md`, `drift.md`, `evaluate.md`; no production files | diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 2970a1904d..831fb428b3 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -46,3 +46,10 @@ Added explicit child shutdown ownership, loopback hostname override, monotonic t Resource teardown preview remained read-only. Owned Redis was removed after exact identity, run-label and bind-mount proof; no foreign or unknown-owner resources changed. S2 adds explicit exitOnSignal:false to two existing embedded signal tests; their hook/listener assertions are retained. Plan file groups updated to 17 (<30) to include these necessary test adaptations and post-contract cleanup tests. Reconcile: PR remains a draft, status progresses to implementation, source for excluded saga transports is unchanged. S3 composition/docs and the one-pass runtime smoke remain pending; no supervisor sign-off is claimed. + +## S3a generated resource ownership + +Added optional, idempotent owner disposal to PluginServiceContext without resolving unused adapters. Generated host bootstrap tracks only acquired Prisma identities; its callback attempts every disconnect once. Workers/sagas/auth service composition invokes it in reserved signal cleanup; workers/sagas/triggers child glue calls singleton closeKv and the generated host callback. Saga DB acquisitions are covered through their existing host resolver. Native embedded hosts retain ownership on manual stop. Explicit host DB disposal disables duplicate automatic raw-builder disposal. + +Generated-owner tests first failed 2/37 with missing disposal against the old embedded template. After canonical gen:assets-barrel, the suite passes 37/37, including all three installed runtime artifacts, acquired/unused generated DB cases, lazy owner disposal and a real signal proving exactly one disconnect. Structured changed-source check passes (14 files); non-CLI lint/fmt passes with no findings. CLI files require the repository's explicit CLI quality config because the root config excludes them; separate wrappers validate them. No lock changes or new dependencies. +Reconcile: #2630/#2631 acceptance implementation is progressing; generated runtime smoke, documentation/assets and independent IMPL-EVAL remain. No foreign resources are running for this slice. diff --git a/packages/cli/src/kernel/assets/embedded.generated.ts b/packages/cli/src/kernel/assets/embedded.generated.ts index 0e9a7573aa..7e71fe195a 100644 --- a/packages/cli/src/kernel/assets/embedded.generated.ts +++ b/packages/cli/src/kernel/assets/embedded.generated.ts @@ -295,7 +295,7 @@ const template_144 = const template_145 = "import { useSignal } from '@preact/signals';\nimport { useEffect } from 'preact/hooks';\nimport { createNetScriptStreamEventSourceV1 } from '@netscript/fresh/streams';\n\nexport default function {{resourcePascalCase}}Stream() {\n const status = useSignal('Connecting to {{resource}}…');\n\n useEffect(() => {\n const stream = createNetScriptStreamEventSourceV1({\n streamPath: '{{route}}',\n offset: '-1',\n onEvent: (event) => {\n status.value = `{{resourcePascalCase}} stream: ${event.event}`;\n },\n });\n return () => stream.dispose();\n }, []);\n\n return (\n
\n \n {status.value}\n \n
\n );\n}\n"; const template_146 = - "/**\n * Host-owned plugin service context bootstrap.\n *\n * Generated plugin services load this module through\n * NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE so plugin packages stay free of\n * static workspace imports.\n */\n\nimport {\n createPluginServiceContext as createHostPluginServiceContext,\n type PluginServiceContext,\n} from '@netscript/plugin/sdk';\nimport { getKv } from '@netscript/kv';\n\ntype DatabaseModule = {\n readonly db?: {\n getClient(): Promise;\n };\n};\n\nasync function getDatabaseClient(): Promise {\n const databaseModule = await import('../../database/mod.ts') as DatabaseModule;\n if (!databaseModule.db?.getClient) {\n throw new Error('database/mod.ts does not export a db.getClient() accessor.');\n }\n return databaseModule.db.getClient();\n}\n\nexport function createPluginServiceContext(\n pluginName: string,\n): Promise {\n return createHostPluginServiceContext(pluginName, {\n getDatabaseClient,\n getKv,\n });\n}\n"; + "/**\n * Host-owned plugin service context bootstrap.\n *\n * Generated plugin services load this module through\n * NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE so plugin packages stay free of\n * static workspace imports.\n */\n\nimport {\n createPluginServiceContext as createHostPluginServiceContext,\n type PluginServiceContext,\n} from '@netscript/plugin/sdk';\nimport { getKv } from '@netscript/kv';\n\ntype DatabaseModule = {\n readonly db?: {\n getClient(): Promise;\n };\n};\n\ntype OwnedDatabaseClient = { $disconnect(): Promise };\nconst databaseClients = new Set();\nlet disposal: Promise | undefined;\n\nfunction isOwnedDatabaseClient(value: unknown): value is OwnedDatabaseClient {\n return typeof value === 'object' && value !== null &&\n typeof Reflect.get(value, '$disconnect') === 'function';\n}\n\n/** Dispose only clients acquired by this executable's host resolvers. */\nexport function disposePluginServiceContext(): Promise {\n return disposal ??= (async () => {\n const clients = [...databaseClients];\n databaseClients.clear();\n const results = await Promise.allSettled([\n ...clients.map(async (client) => await client.$disconnect()),\n ]);\n const failures = results.filter((result): result is PromiseRejectedResult =>\n result.status === 'rejected'\n );\n if (failures.length) {\n throw new AggregateError(\n failures.map((result) => result.reason),\n 'Plugin resource cleanup failed.',\n );\n }\n })();\n}\n\nasync function getDatabaseClient(): Promise {\n if (disposal) throw new Error('Plugin host resources are shutting down.');\n const databaseModule = await import('../../database/mod.ts') as DatabaseModule;\n if (!databaseModule.db?.getClient) {\n throw new Error('database/mod.ts does not export a db.getClient() accessor.');\n }\n const client = await databaseModule.db.getClient();\n const clients = isOwnedDatabaseClient(client)\n ? [client]\n : typeof client === 'object' && client !== null\n ? Object.values(client).filter(isOwnedDatabaseClient)\n : [];\n if (disposal) {\n await Promise.all(clients.map(async (value) => await value.$disconnect()));\n throw new Error('Plugin host resources shut down during database acquisition.');\n }\n for (const value of clients) databaseClients.add(value);\n return client;\n}\n\nexport function createPluginServiceContext(\n pluginName: string,\n): Promise {\n return createHostPluginServiceContext(pluginName, {\n getDatabaseClient,\n getKv,\n dispose: disposePluginServiceContext,\n });\n}\n"; const template_147 = "import type { {{serviceName | pascalCase}}{{modelName}}V1 as Entity } from '@{{projectName}}/contracts';\n\n/** Pure {{modelName}} list policy; no persistence or transport dependencies. */\nexport interface ListInput {\n readonly page: number;\n readonly limit: number;\n readonly sortBy?: string;\n readonly search?: string;\n readonly status?: Entity['status'];\n readonly sortOrder: 'asc' | 'desc';\n}\n\nconst SORTABLE_FIELDS = new Set(['id', 'reference', 'name', 'ownerName', 'status', 'amount', 'currency', 'createdAt', 'updatedAt']);\n\nexport function listQuery(input: ListInput) {\n const field = input.sortBy && SORTABLE_FIELDS.has(input.sortBy) ? input.sortBy : 'id';\n const search = input.search?.trim();\n const textFilter = search ? { contains: search{{searchMode}} } : undefined;\n return {\n skip: (input.page - 1) * input.limit,\n take: input.limit,\n orderBy: field === 'id' ? [{ id: input.sortOrder }] : [{ [field]: input.sortOrder }, { id: input.sortOrder }],\n where: { ...(input.status ? { status: input.status } : {}), ...(textFilter ? { OR: [{ reference: textFilter }, { name: textFilter }, { ownerName: textFilter }, { ownerEmail: textFilter }] } : {}) },\n };\n}\n\nexport function pagination(input: ListInput, total: number) {\n const totalPages = Math.ceil(total / input.limit);\n return {\n page: input.page,\n limit: input.limit,\n total,\n totalPages,\n hasNext: input.page < totalPages,\n hasPrev: input.page > 1,\n };\n}\n"; const template_148 = diff --git a/packages/cli/src/kernel/assets/plugins/service-context.ts.template b/packages/cli/src/kernel/assets/plugins/service-context.ts.template index 6f963c956d..1a2a829985 100644 --- a/packages/cli/src/kernel/assets/plugins/service-context.ts.template +++ b/packages/cli/src/kernel/assets/plugins/service-context.ts.template @@ -18,12 +18,53 @@ type DatabaseModule = { }; }; +type OwnedDatabaseClient = { $disconnect(): Promise }; +const databaseClients = new Set(); +let disposal: Promise | undefined; + +function isOwnedDatabaseClient(value: unknown): value is OwnedDatabaseClient { + return typeof value === 'object' && value !== null && + typeof Reflect.get(value, '$disconnect') === 'function'; +} + +/** Dispose only clients acquired by this executable's host resolvers. */ +export function disposePluginServiceContext(): Promise { + return disposal ??= (async () => { + const clients = [...databaseClients]; + databaseClients.clear(); + const results = await Promise.allSettled([ + ...clients.map(async (client) => await client.$disconnect()), + ]); + const failures = results.filter((result): result is PromiseRejectedResult => + result.status === 'rejected' + ); + if (failures.length) { + throw new AggregateError( + failures.map((result) => result.reason), + 'Plugin resource cleanup failed.', + ); + } + })(); +} + async function getDatabaseClient(): Promise { + if (disposal) throw new Error('Plugin host resources are shutting down.'); const databaseModule = await import('../../database/mod.ts') as DatabaseModule; if (!databaseModule.db?.getClient) { throw new Error('database/mod.ts does not export a db.getClient() accessor.'); } - return databaseModule.db.getClient(); + const client = await databaseModule.db.getClient(); + const clients = isOwnedDatabaseClient(client) + ? [client] + : typeof client === 'object' && client !== null + ? Object.values(client).filter(isOwnedDatabaseClient) + : []; + if (disposal) { + await Promise.all(clients.map(async (value) => await value.$disconnect())); + throw new Error('Plugin host resources shut down during database acquisition.'); + } + for (const value of clients) databaseClients.add(value); + return client; } export function createPluginServiceContext( @@ -32,5 +73,6 @@ export function createPluginServiceContext( return createHostPluginServiceContext(pluginName, { getDatabaseClient, getKv, + dispose: disposePluginServiceContext, }); } diff --git a/packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts b/packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts index c2e51058b4..d47163467c 100644 --- a/packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts +++ b/packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts @@ -91,3 +91,36 @@ Deno.test('generatePluginServiceContext emits package-resident safe imports', () assertFalse(output.includes('return Promise.resolve({')); assertFalse(output.includes('export async function createPluginServiceContext(')); }); + +for (const acquire of [false, true]) { + Deno.test(`generated host disposal closes acquired clients once (acquire=${acquire})`, async () => { + const fakeDatabase = ` + export let requests = 0; + export let disconnects = 0; + const first = { async $disconnect() { disconnects++; } }; + const second = { async $disconnect() { disconnects++; } }; + export const db = { async getClient() { requests++; return { first, alias: first, second }; } }; + `; + const databaseUrl = `data:application/typescript,${encodeURIComponent(fakeDatabase)}`; + const source = generatePluginServiceContext().replace( + "'../../database/mod.ts'", + JSON.stringify(databaseUrl), + ) + ` + const probe = await createPluginServiceContext('cleanup-probe'); + const state = await import(${JSON.stringify(databaseUrl)}); + if (state.requests !== 0) throw new Error('eager database resolution'); + if (${acquire}) { await probe.db.getClient(); await probe.db.getClient(); } + if (!probe.dispose) throw new Error('missing owner disposal'); + await probe.dispose(); await probe.dispose(); + if (state.requests !== ${acquire ? 1 : 0} || state.disconnects !== ${acquire ? 2 : 0}) { + throw new Error('client acquisition or disposal was not deduplicated'); + } + `; + const result = await new Deno.Command(Deno.execPath(), { + args: ['eval', '--unstable-kv', source], + stdout: 'piped', + stderr: 'piped', + }).output(); + assert(result.success, new TextDecoder().decode(result.stderr)); + }); +} diff --git a/packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts b/packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts index 3ab200b0b4..fc82545e0a 100644 --- a/packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts +++ b/packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts @@ -109,6 +109,8 @@ class LazyPluginServiceKv implements PluginServiceKv { export async function createPluginServiceContext( pluginName: string, resolvers: { + /** Dispose dependencies owned by this host; never implicitly closes lazy adapters. */ + readonly dispose?: () => Promise; /** Resolve the project-owned database client. */ readonly getDatabaseClient: () => Promise; /** Resolve the host-selected key-value adapter. */ @@ -120,12 +122,14 @@ export async function createPluginServiceContext( }, ): Promise { const getDatabaseClient = memoizeAsyncResolver(resolvers.getDatabaseClient); + const dispose = resolvers.dispose ? memoizeAsyncResolver(resolvers.dispose) : undefined; const [appsettings, env] = await Promise.all([ resolvers.getAppsettings?.(), resolvers.getEnvironment?.() ?? Promise.resolve(Deno.env.toObject()), ]); return { + ...(dispose ? { dispose } : {}), db: { getClient: getDatabaseClient, }, diff --git a/packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts b/packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts index 955984ff97..ba200a2f89 100644 --- a/packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts +++ b/packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts @@ -134,3 +134,29 @@ function createTestKv(): object { }, }; } + +Deno.test('owner disposal is idempotent and does not resolve unused KV or database clients', async () => { + let resolved = 0; + let disposed = 0; + const context = await createPluginServiceContext('cleanup-owner', { + getDatabaseClient: () => { + resolved++; + return Promise.resolve({}); + }, + getKv: () => { + resolved++; + return Promise.resolve(createTestKv()); + }, + dispose: () => { + disposed++; + return Promise.resolve(); + }, + }); + assert(context.dispose); + const first = context.dispose(); + const second = context.dispose(); + assertStrictEquals(first, second); + await first; + assertEquals(resolved, 0); + assertEquals(disposed, 1); +}); diff --git a/packages/plugin/src/sdk/runtime/plugin-service-context.ts b/packages/plugin/src/sdk/runtime/plugin-service-context.ts index ec020369f8..dab42f3257 100644 --- a/packages/plugin/src/sdk/runtime/plugin-service-context.ts +++ b/packages/plugin/src/sdk/runtime/plugin-service-context.ts @@ -4,6 +4,8 @@ export interface PluginServiceContext { readonly serviceName?: string; /** Optional project root when supplied by the host runtime. */ readonly projectRoot?: string; + /** Owner-supplied, idempotent process cleanup; never resolves unused dependencies. */ + readonly dispose?: () => Promise; /** Host database accessor for plugin-owned services. */ readonly db: { /** Resolve the active database client. */ diff --git a/packages/service/src/builder/service-builder-impl.ts b/packages/service/src/builder/service-builder-impl.ts index 2fbcac7098..4490e61956 100644 --- a/packages/service/src/builder/service-builder-impl.ts +++ b/packages/service/src/builder/service-builder-impl.ts @@ -629,7 +629,9 @@ export class ServiceBuilderImpl< this.config.port ?? 3000, options, this.shutdownHooks, - [() => disconnectServiceDatabases(this.databaseResources)], + options?.disposeDatabaseOnSignal === false + ? [] + : [() => disconnectServiceDatabases(this.databaseResources)], ); } } diff --git a/packages/service/src/types.ts b/packages/service/src/types.ts index 386d9adb13..829245b559 100644 --- a/packages/service/src/types.ts +++ b/packages/service/src/types.ts @@ -214,6 +214,9 @@ export interface ServeOptions { /** Owned resource cleanup hooks, run on process-owned signals even when work drain times out. */ onCleanup?: readonly ShutdownHook[]; + /** Set false when onCleanup already owns database disposal; defaults to true. */ + disposeDatabaseOnSignal?: boolean; + /** Exit 0 clean, 1 failed, 2 timed out after a signal. False leaves ownership to the host. */ exitOnSignal?: boolean; diff --git a/packages/service/tests/service-resources_test.ts b/packages/service/tests/service-resources_test.ts index 8e532b7a6a..720fd11c35 100644 --- a/packages/service/tests/service-resources_test.ts +++ b/packages/service/tests/service-resources_test.ts @@ -51,3 +51,33 @@ Deno.test('database cleanup attempts every client after a failure and never reso assertEquals(resolved, 0); assertEquals(closed, 1); }); + +Deno.test({ + name: 'a host disposal callback replaces automatic database disposal on a process signal', + ignore: Deno.build.os === 'windows', + async fn() { + const result = await new Deno.Command(Deno.execPath(), { + args: [ + 'eval', + ` + import { createService } from '@netscript/service'; + const db = { $disconnect: async () => { console.log('DATABASE_DISCONNECTED'); } }; + await createService({}, { name: 'host-disposal' }).withDatabase(db).serve({ + port: 0, + disposeDatabaseOnSignal: false, + onCleanup: [() => db.$disconnect()], + }); + setTimeout(() => Deno.kill(Deno.pid, 'SIGTERM'), 0); + await new Promise(() => {}); + `, + ], + stdout: 'piped', + stderr: 'piped', + }).output(); + assertEquals(result.code, 0, new TextDecoder().decode(result.stderr)); + assertEquals( + new TextDecoder().decode(result.stdout).split('DATABASE_DISCONNECTED').length - 1, + 1, + ); + }, +}); diff --git a/plugins/auth/services/src/auth-service-runtime.ts b/plugins/auth/services/src/auth-service-runtime.ts index 09fc7885ad..399510ba1c 100644 --- a/plugins/auth/services/src/auth-service-runtime.ts +++ b/plugins/auth/services/src/auth-service-runtime.ts @@ -14,7 +14,7 @@ export async function serveAuthService( ): Promise { const service = await createPluginService(router, config).onShutdown(async () => { await registry.background?.stop(); - }).serve(); + }).serve({ onCleanup: ctx.dispose ? [ctx.dispose] : [], disposeDatabaseOnSignal: !ctx.dispose }); // Service identity owns cleanup; the supervisor retries without caller credentials. void registry.background?.start(createWorkosWorkerObserver(ctx.logger)); return service; diff --git a/plugins/sagas/services/src/main.ts b/plugins/sagas/services/src/main.ts index 4d28203e5c..d4078e8b1a 100644 --- a/plugins/sagas/services/src/main.ts +++ b/plugins/sagas/services/src/main.ts @@ -85,7 +85,7 @@ export default async function createSagasService( }, context: () => ({ ...query.context, sagaRuntime: sagaPublisher }), onShutdown: [() => sagaPublisher.stop()], - }).serve(); + }).serve({ onCleanup: ctx.dispose ? [ctx.dispose] : [], disposeDatabaseOnSignal: !ctx.dispose }); queueMicrotask(async () => { try { diff --git a/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts b/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts index 5a05661298..de67008668 100644 --- a/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts +++ b/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts @@ -5,10 +5,20 @@ import { defineStub, type StubSource } from '@netscript/plugin/adapter'; export const runtimeGlueStub: StubSource = defineStub({ source: [ '/** Sagas background child health and runtime glue. @module */', + "import { closeKv } from '@netscript/kv';", "import '@netscript/kv/redis';", "import { runChildHealthProcess } from '@netscript/plugin/health';", "import { type SagaRuntimeSupervisor, startSagaRunner } from '@netscript/plugin-sagas/runtime';", '', + 'async function disposeHostResources(): Promise {', + " const specifier = Deno.env.get('NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE');", + ' if (!specifier) return;', + ' const bootstrap: unknown = await import(specifier);', + " if (typeof bootstrap !== 'object' || bootstrap === null) return;", + " const dispose: unknown = Reflect.get(bootstrap, 'disposePluginServiceContext');", + " if (typeof dispose === 'function') await dispose();", + '}', + '', 'if (import.meta.main) {', ' let supervisor: SagaRuntimeSupervisor | undefined;', ' await runChildHealthProcess(', @@ -27,7 +37,10 @@ export const runtimeGlueStub: StubSource = defineStub({ ' }', ' },', ' () => supervisor?.snapshot().childHealth,', - " { restartHistoryPath: '.data/child-health/sagas.json' },", + ' {', + " restartHistoryPath: '.data/child-health/sagas.json',", + ' onShutdown: [closeKv, disposeHostResources],', + ' },', ' );', '}', '', diff --git a/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts b/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts index 0ad58aaf8a..397fcbbf5e 100644 --- a/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts +++ b/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts @@ -5,10 +5,20 @@ import { defineStub, type StubSource } from '@netscript/plugin/adapter'; export const runtimeGlueStub: StubSource = defineStub({ source: [ '/** Triggers background child health and runtime glue. @module */', + "import { closeKv } from '@netscript/kv';", "import '@netscript/kv/redis';", "import { runChildHealthProcess } from '@netscript/plugin/health';", "import { startCombinedProcess, TriggerHealthMonitor } from '@netscript/plugin-triggers/runtime';", '', + 'async function disposeHostResources(): Promise {', + " const specifier = Deno.env.get('NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE');", + ' if (!specifier) return;', + ' const bootstrap: unknown = await import(specifier);', + " if (typeof bootstrap !== 'object' || bootstrap === null) return;", + " const dispose: unknown = Reflect.get(bootstrap, 'disposePluginServiceContext');", + " if (typeof dispose === 'function') await dispose();", + '}', + '', 'if (import.meta.main) {', ' const health = new TriggerHealthMonitor();', ' await runChildHealthProcess(', @@ -19,6 +29,7 @@ export const runtimeGlueStub: StubSource = defineStub({ ' {', ' health,', " restartHistoryPath: '.data/child-health/triggers.json',", + ' onShutdown: [closeKv, disposeHostResources],', ' },', ' );', '}', diff --git a/plugins/workers/services/src/main.ts b/plugins/workers/services/src/main.ts index 1ad748f718..2561cc4f1c 100644 --- a/plugins/workers/services/src/main.ts +++ b/plugins/workers/services/src/main.ts @@ -47,6 +47,7 @@ export default async function createWorkersService( ): Promise { return await startWorkersService(ctx, { auth: { public: true, reason: LEGACY_WORKERS_PUBLIC_REASON }, + serve: { onCleanup: ctx.dispose ? [ctx.dispose] : [], disposeDatabaseOnSignal: !ctx.dispose }, requestLevel: options.requestLevel, responseLevel: options.responseLevel, }); diff --git a/plugins/workers/src/adapter/resources/glue/runtime.stub.ts b/plugins/workers/src/adapter/resources/glue/runtime.stub.ts index 8d2782bc04..a6b63a028a 100644 --- a/plugins/workers/src/adapter/resources/glue/runtime.stub.ts +++ b/plugins/workers/src/adapter/resources/glue/runtime.stub.ts @@ -9,9 +9,19 @@ export const runtimeGlueStub: StubSource = defineStub({ ' * Do not re-resolve its path here: a second resolver can hide compiled jobs at dispatch.', ' * @module', ' */', + "import { closeKv } from '@netscript/kv';", "import { type ChildHealthSnapshot, runChildHealthProcess } from '@netscript/plugin/health';", "import { startCombinedProcess } from '@netscript/plugin-workers/runtime';", '', + 'async function disposeHostResources(): Promise {', + " const specifier = Deno.env.get('NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE');", + ' if (!specifier) return;', + ' const bootstrap: unknown = await import(specifier);', + " if (typeof bootstrap !== 'object' || bootstrap === null) return;", + " const dispose: unknown = Reflect.get(bootstrap, 'disposePluginServiceContext');", + " if (typeof dispose === 'function') await dispose();", + '}', + '', 'if (import.meta.main) {', ' let snapshot: (() => ChildHealthSnapshot | Promise) | undefined;', ' await runChildHealthProcess(', @@ -26,6 +36,7 @@ export const runtimeGlueStub: StubSource = defineStub({ ' });', ' },', ' () => snapshot?.(),', + ' { onShutdown: [closeKv, disposeHostResources] },', ' );', '}', '', From 16fae6992566972f3d0128e06d4255db104445b1 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 18:47:11 +0100 Subject: [PATCH 08/19] docs(runtime): explain shutdown budgets cleanup ownership and exit codes --- .../context-pack.md | 6 + .../drift.md | 2 + .../worklog.md | 6 + .llm/tools/docs/generate-child-health-docs.ts | 4 +- docs/site/observability/telemetry.md | 434 ++++++----- .../orchestration-runtime/child-health.md | 45 +- docs/site/reference/plugin/index.md | 425 +++++------ docs/site/reference/service/index.md | 674 +++++++++--------- docs/site/reference/telemetry/index.md | 354 ++++----- packages/plugin/README.md | 30 +- .../presentation/run-child-health-process.ts | 7 + .../run-child-health-process_exit_test.ts | 4 +- .../run-child-health-process_test.ts | 4 +- packages/service/README.md | 72 +- packages/telemetry/README.md | 48 +- 15 files changed, 1146 insertions(+), 969 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index dbca289ea7..aad7e2b2a9 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -36,3 +36,9 @@ Added optional, idempotent owner disposal to PluginServiceContext without resolv Generated-owner tests first failed 2/37 with missing disposal against the old embedded template. After canonical gen:assets-barrel, the suite passes 37/37, including all three installed runtime artifacts, acquired/unused generated DB cases, lazy owner disposal and a real signal proving exactly one disconnect. Structured changed-source check passes (14 files); non-CLI lint/fmt passes with no findings. CLI files require the repository's explicit CLI quality config because the root config excludes them; separate wrappers validate them. No lock changes or new dependencies. Reconcile: #2630/#2631 acceptance implementation is progressing; generated runtime smoke, documentation/assets and independent IMPL-EVAL remain. No foreign resources are running for this slice. + +## S3b public behavior documentation + +Documented child loopback/hostname overrides, total and reserved cleanup budgets, explicit exit codes 0/1/2, manual/external embedding semantics, host database ownership override and OTel standalone signal behavior. Expanded the generated child-health page from the public option/function JSDoc, so its operational text stays source-derived. Public prose contains no run/evaluator/finding identities. + +Docs:accuracy passes. Release:preflight initially detected package self-imports inside the new subprocess test strings; tests now resolve their local source module explicitly, and preflight passes. Child seam tests still pass 4/4. This is a test import correction, not a gate exclusion. Source remains within approved runtime scope. Documentation generator carriers are refreshed after committing the read set, then the full one-pass runtime smoke runs. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index ab98953ae5..0d25058d12 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -10,3 +10,5 @@ - S3 composition revealed the same DB client can be both raw-builder registered and owned by the host disposal callback. Added disposeDatabaseOnSignal (default true); generated service composition sets false when its explicit context disposer owns DB cleanup. A real signal subprocess proves exactly one disconnect. This keeps the accepted ownership rule without a global registry. - Auth serve wiring lives in auth-service-runtime.ts, so that sibling composition file changes instead of main.ts. Sagas runner DB acquisition is already tracked by the generated host resolver; no runner implementation edit is needed. Generated host disposal handles DB only; process edges call closeKv once. - S2 touched 18 files including its scrubbed resource evidence, still below 30. S3a expands to at most 22 to include the ownership refinement and tests. + +- S3b source-derived child-health documentation requires updating its existing generator symbol list; it now includes the public process options/function. Subprocess self-imports are corrected to local module URLs to satisfy release:preflight. This adds three scoped files to the prose slice and remains below 30. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 831fb428b3..9a18f9d47e 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -53,3 +53,9 @@ Added optional, idempotent owner disposal to PluginServiceContext without resolv Generated-owner tests first failed 2/37 with missing disposal against the old embedded template. After canonical gen:assets-barrel, the suite passes 37/37, including all three installed runtime artifacts, acquired/unused generated DB cases, lazy owner disposal and a real signal proving exactly one disconnect. Structured changed-source check passes (14 files); non-CLI lint/fmt passes with no findings. CLI files require the repository's explicit CLI quality config because the root config excludes them; separate wrappers validate them. No lock changes or new dependencies. Reconcile: #2630/#2631 acceptance implementation is progressing; generated runtime smoke, documentation/assets and independent IMPL-EVAL remain. No foreign resources are running for this slice. + +## S3b public behavior documentation + +Documented child loopback/hostname overrides, total and reserved cleanup budgets, explicit exit codes 0/1/2, manual/external embedding semantics, host database ownership override and OTel standalone signal behavior. Expanded the generated child-health page from the public option/function JSDoc, so its operational text stays source-derived. Public prose contains no run/evaluator/finding identities. + +Docs:accuracy passes. Release:preflight initially detected package self-imports inside the new subprocess test strings; tests now resolve their local source module explicitly, and preflight passes. Child seam tests still pass 4/4. This is a test import correction, not a gate exclusion. Source remains within approved runtime scope. Documentation generator carriers are refreshed after committing the read set, then the full one-pass runtime smoke runs. diff --git a/.llm/tools/docs/generate-child-health-docs.ts b/.llm/tools/docs/generate-child-health-docs.ts index bcbe3d9f04..18412cd606 100644 --- a/.llm/tools/docs/generate-child-health-docs.ts +++ b/.llm/tools/docs/generate-child-health-docs.ts @@ -14,6 +14,8 @@ const SYMBOLS = [ 'ChildHealthSnapshot', 'ChildFatalError', 'CHILD_CRASH_LOOP_THRESHOLD', + 'ChildHealthProcessOptions', + 'runChildHealthProcess', ] as const; const StateDeclaration = z.object({ @@ -83,7 +85,7 @@ templateEngine: [vento, md] order: 3 --- - # Background child health diff --git a/docs/site/observability/telemetry.md b/docs/site/observability/telemetry.md index 483ed6a8e2..f87bc48f05 100644 --- a/docs/site/observability/telemetry.md +++ b/docs/site/observability/telemetry.md @@ -7,23 +7,24 @@ order: 1 # Telemetry & logging -This page covers what NetScript traces and logs for you, the `@netscript/telemetry` surface for adding -your own spans, and the two places to read the results: the Aspire dashboard and a typed query port. +This page covers what NetScript traces and logs for you, the `@netscript/telemetry` surface for +adding your own spans, and the two places to read the results: the Aspire dashboard and a typed +query port. Every service and plugin runtime is wired for **OpenTelemetry**. Services serve their RPC handlers with trace-context propagation (first-party oRPC and Hono instrumentation), the worker runtime wraps job dispatch, execution, scheduling, subprocess hand-off and task execution in spans, and structured -logs flow through the framework `logger`. A single W3C `traceparent` groups a cross-process flow into -**one distributed trace**. The Aspire dashboard collects OTLP traces, metrics and structured logs from -every resource in the app graph as soon as you run `aspire start`; you don't stand up Jaeger, Grafana -or a log shipper. "Did the change work?" becomes a trace you open, or query from code, instead of four -console logs you correlate by eye. - -{{ comp.diagram({ - src: "/assets/diagrams/otel-traceparent.svg", - alt: "A W3C traceparent header propagates from a service request through the worker runtime into a subprocess and across a saga boundary, keeping every span under one trace id.", - caption: "Trace-context propagation: a single traceparent (W3C) flows service → worker → subprocess → saga, so spans from every runtime join one distributed trace in Aspire." -}) }} +logs flow through the framework `logger`. A single W3C `traceparent` groups a cross-process flow +into **one distributed trace**. The Aspire dashboard collects OTLP traces, metrics and structured +logs from every resource in the app graph as soon as you run `aspire start`; you don't stand up +Jaeger, Grafana or a log shipper. "Did the change work?" becomes a trace you open, or query from +code, instead of four console logs you correlate by eye. + +{{ comp.diagram({ src: "/assets/diagrams/otel-traceparent.svg", alt: "A W3C traceparent header +propagates from a service request through the worker runtime into a subprocess and across a saga +boundary, keeping every span under one trace id.", caption: "Trace-context propagation: a single +traceparent (W3C) flows service → worker → subprocess → saga, so spans from every runtime join one +distributed trace in Aspire." }) }} > [!IMPORTANT] > The dashboard and the OTLP collector come up with the orchestrator. Run @@ -43,8 +44,8 @@ Where many producers feed one consumer, such as a fan-in into a durable-streams consumer span shows exactly which upstream flows fed it. AI workloads use the same spine. Spans follow the upstream `gen_ai.*` semantic conventions (through -`createGenAiAttributes` in `@netscript/telemetry/attributes`), so a traced agent turn shows the model -call, the tool calls and the durable write it produced, step by step, on one tree. +`createGenAiAttributes` in `@netscript/telemetry/attributes`), so a traced agent turn shows the +model call, the tool calls and the durable write it produced, step by step, on one tree. ## Ports, adapters and attributes @@ -52,10 +53,16 @@ call, the tool calls and the durable write it produced, step by step, on one tre connection stats) and logs, all over the same OTLP export. Application and runtime code program against the port contracts in `@netscript/telemetry/otel`: `TracerProviderPort`, `MeterPort`, `PropagatorPort`, `SpanLinkPort` and `TelemetryQueryPort`. The zero-dependency default adapter, -`OtelDenoTracerProvider`, binds to Deno's built-in OTLP exporter through `OTEL_DENO=true`. The opt-in -`OtelSdkTracerProvider` serves apps that bring the OpenTelemetry JS SDK and also enables +`OtelDenoTracerProvider`, binds to Deno's built-in OTLP exporter through `OTEL_DENO=true`. The +opt-in `OtelSdkTracerProvider` serves apps that bring the OpenTelemetry JS SDK and also enables attribute-preserving span links. +The opt-in `OtelSdkTracerProvider` observes SIGTERM to start bounded SDK shutdown and removes its +signal listeners before awaiting exporters. It does not terminate the process or select an exit +code. NetScript service and child runtimes own termination after their work and resource drains. +Standalone SDK embedders must compose a runtime or install their own signal/exit policy; explicit +`await provider.shutdown()` remains the reliable awaited shutdown path. + Attribute names follow one convention: upstream semconv keys (`rpc.*`, `messaging.*`, `gen_ai.*`, `server.*`) wherever OpenTelemetry defines them, and NetScript-owned keys under the single proprietary root `netscript.*`. Correlated spans share `netscript.correlation.id`. The @@ -65,27 +72,27 @@ framework emits from what is a scaffold stub. ## What you get out of the box -| Signal | What you get | -| --- | --- | -| Structured logging | `@netscript/logger` gives every service and plugin a level-aware structured logger. Declare it in `netscript.config.ts` (`logging: { level: 'info', format: 'text' }`); output is text or JSON and filterable in the dashboard. | -| Traces | Service request paths propagate W3C trace context, and the worker runtime traces the job lifecycle (see the next section). | -| OTLP export and dashboard | The generated AppHost configures an OTLP endpoint and the Aspire dashboard, so traces, metrics and logs from every resource land in one place with no collector to deploy. | -| Browser console logs | Generated app resources call `withBrowserLogs()` (the AppHost pins `Aspire.Hosting.Browsers`). A Fresh/Vite app's browser console output, including a client-side `TypeError` an island throws, appears in that resource's **Console logs** in the dashboard, correlated with the server-side spans of the same request. | +| Signal | What you get | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Structured logging | `@netscript/logger` gives every service and plugin a level-aware structured logger. Declare it in `netscript.config.ts` (`logging: { level: 'info', format: 'text' }`); output is text or JSON and filterable in the dashboard. | +| Traces | Service request paths propagate W3C trace context, and the worker runtime traces the job lifecycle (see the next section). | +| OTLP export and dashboard | The generated AppHost configures an OTLP endpoint and the Aspire dashboard, so traces, metrics and logs from every resource land in one place with no collector to deploy. | +| Browser console logs | Generated app resources call `withBrowserLogs()` (the AppHost pins `Aspire.Hosting.Browsers`). A Fresh/Vite app's browser console output, including a client-side `TypeError` an island throws, appears in that resource's **Console logs** in the dashboard, correlated with the server-side spans of the same request. | ## Plugin HTTP request logging First-party plugin API services (workers, streams, auth, sagas and triggers) emit routine `HTTP request started` and successful `HTTP request completed` records at **Debug** by default. -Internal service traffic is frequent; keeping these pairs below Information leaves application -logs easier to scan. Each factory accepts optional `requestLevel` and `responseLevel` fields, -with the same `'debug' | 'info'` values as the native `@netscript/service` logger middleware. -Each omitted field independently defaults to `'debug'`. +Internal service traffic is frequent; keeping these pairs below Information leaves application logs +easier to scan. Each factory accepts optional `requestLevel` and `responseLevel` fields, with the +same `'debug' | 'info'` values as the native `@netscript/service` logger middleware. Each omitted +field independently defaults to `'debug'`. Pass these fields in the existing options argument to `startWorkersService(context, options)`, `startStreamsService(options)`, `createTriggersService(context, options)` or -`startTriggersService(options)`. The legacy workers, auth and sagas default factories accept -an optional second options argument after their host context. Legacy streams startup uses the -Debug defaults; use `startStreamsService` when the host needs to configure them. +`startTriggersService(options)`. The legacy workers, auth and sagas default factories accept an +optional second options argument after their host context. Legacy streams startup uses the Debug +defaults; use `startStreamsService` when the host needs to configure them. ```ts import { startStreamsService } from '@netscript/plugin-streams/service'; @@ -98,11 +105,11 @@ await startStreamsService({ ``` These options forward through `createPluginService`'s existing `logger` configuration into -`ServiceBuilder.withLogger()`. They select record severity; the process logging threshold -still decides which records are retained. Configure the plugin process at Debug to see its -Debug records. The native middleware continues skipping health probe paths and logging 4xx/5xx -responses at Warning; failures are not quieted by the new defaults. Ordinary service builder -logging retains its Information defaults unless the caller supplies levels to `.withLogger()`. +`ServiceBuilder.withLogger()`. They select record severity; the process logging threshold still +decides which records are retained. Configure the plugin process at Debug to see its Debug records. +The native middleware continues skipping health probe paths and logging 4xx/5xx responses at +Warning; failures are not quieted by the new defaults. Ordinary service builder logging retains its +Information defaults unless the caller supplies levels to `.withLogger()`. ## What is traced automatically @@ -110,25 +117,27 @@ The `@netscript/telemetry` instrumentation is wired into the worker dispatcher, scheduler, so every job run produces spans with attributes, durations, status and lifecycle events without scaffold changes. -{{ comp.apiTable({ - caption: "Automatic worker traces (emitted by the runtime — see /reference/telemetry/)", - rows: [ - { name: "traceJobExecution", type: "span", desc: "Wraps each job's execution with attributes, duration, status, and job.started / job.completed / job.failed / job.exception events. Emitted by the dispatcher." }, - { name: "recordJobProgress", type: "event", desc: "job.progress events carrying current / total / unit — the runtime records real progress as the job advances." }, - { name: "addJobStepEvent", type: "event", desc: "job.step.* events for each step the runtime walks through." }, - { name: "scheduler spans", type: "span", desc: "createSchedulerStartSpan / createScheduleJobSpan / startSchedulerTickSpan / recordCronJobRun — cron and schedule dispatch are traced end to end." }, - { name: "subprocess traceparent", type: "context", desc: "The dispatcher injects W3C traceparent / tracestate into the subprocess env so out-of-process job runs continue the same trace (initJobTracing / runTracedJob / createJobSubprocessEnv)." }, - { name: "task.execute", type: "span", desc: "The multi-runtime task executor wraps each task run in a task.execute span — polyglot and TS tasks alike show up in the trace tree." } - ] -}) }} +{{ comp.apiTable({ caption: "Automatic worker traces (emitted by the runtime — see +/reference/telemetry/)", rows: [ { name: "traceJobExecution", type: "span", desc: "Wraps each job's +execution with attributes, duration, status, and job.started / job.completed / job.failed / +job.exception events. Emitted by the dispatcher." }, { name: "recordJobProgress", type: "event", +desc: "job.progress events carrying current / total / unit — the runtime records real progress as +the job advances." }, { name: "addJobStepEvent", type: "event", desc: "job.step.* events for each +step the runtime walks through." }, { name: "scheduler spans", type: "span", desc: +"createSchedulerStartSpan / createScheduleJobSpan / startSchedulerTickSpan / recordCronJobRun — cron +and schedule dispatch are traced end to end." }, { name: "subprocess traceparent", type: "context", +desc: "The dispatcher injects W3C traceparent / tracestate into the subprocess env so out-of-process +job runs continue the same trace (initJobTracing / runTracedJob / createJobSubprocessEnv)." }, { +name: "task.execute", type: "span", desc: "The multi-runtime task executor wraps each task run in a +task.execute span — polyglot and TS tasks alike show up in the trace tree." } ] }) }} ## Enable tracing & see a span Tracing turns on from the **environment**: `@netscript/telemetry/config` resolves a -`TelemetryConfig` from the standard `OTEL_*` variables, and the Aspire AppHost sets them for you. Run -`aspire start`, trigger any job, and open **Traces** in the dashboard: you see the dispatch span, the -execution span, progress and step events and, for subprocess or polyglot tasks, the trace continued -across the process boundary. +`TelemetryConfig` from the standard `OTEL_*` variables, and the Aspire AppHost sets them for you. +Run `aspire start`, trigger any job, and open **Traces** in the dashboard: you see the dispatch +span, the execution span, progress and step events and, for subprocess or polyglot tasks, the trace +continued across the process boundary. > [!NOTE] > Locally, Aspire provisions the OTLP collector and the dashboard and injects the `OTEL_*` variables @@ -136,15 +145,34 @@ across the process boundary. > profile uses `localhost:0`), so use the URL Aspire prints. The AppHost injects the allocated > collector endpoint into resources; no fixed dashboard or OTLP port is required. -`netscript.config.ts` declares the logging contract; there is no `defineTelemetry()` call. At runtime -you can print what telemetry resolved: +`netscript.config.ts` declares the logging contract; there is no `defineTelemetry()` call. At +runtime you can print what telemetry resolved: -{{ comp.codeBlock({ lang: "ts", code: "// netscript.config.ts — declare the structured-logging contract for the workspace.\n// Tracing itself is enabled by OTEL_* env vars (the Aspire AppHost sets these); the\n// config package reads them — there is no defineTelemetry() call to make.\nimport { defineConfig } from '@netscript/config';\n\nexport default defineConfig({\n name: 'my-app',\n version: '1.0.0',\n logging: { level: 'info', format: 'text' }, // level: debug|info|warn|error\n plugins: ['./plugins/workers/mod.ts'],\n});\n\n// Anywhere in app code you can inspect what telemetry resolved (log-safe, redacted):\nimport { describeTelemetryConfig, isTelemetryEnabled } from '@netscript/telemetry/config';\nif (isTelemetryEnabled()) console.log(describeTelemetryConfig());\n// → { enabled: true, endpoint: '', protocol, serviceName, sampler }" }) }} +{{ comp.codeBlock({ lang: "ts", code: "// netscript.config.ts — declare the structured-logging +contract for the workspace.\n// Tracing itself is enabled by OTEL_* env vars (the Aspire AppHost +sets these); the\n// config package reads them — there is no defineTelemetry() call to make.\nimport +{ defineConfig } from '@netscript/config';\n\nexport default defineConfig({\n name: 'my-app',\n +version: '1.0.0',\n logging: { level: 'info', format: 'text' }, // level: debug|info|warn|error\n +plugins: ['./plugins/workers/mod.ts'],\n});\n\n// Anywhere in app code you can inspect what +telemetry resolved (log-safe, redacted):\nimport { describeTelemetryConfig, isTelemetryEnabled } +from '@netscript/telemetry/config';\nif (isTelemetryEnabled()) +console.log(describeTelemetryConfig());\n// → { enabled: true, endpoint: '', +protocol, serviceName, sampler }" }) }} To add a custom span inside a job handler, open a child span under the job span the dispatcher already created: -{{ comp.codeBlock({ lang: "ts", code: "// plugins/workers/jobs/health-check.ts — a real child span inside a handler.\n// The dispatcher already wraps this job in traceJobExecution automatically;\n// withChildSpan opens a child span under that parent. recordJobProgress's 3rd arg\n// is a UNIT label (e.g. 'steps'), not a free-text message.\nimport { createSuccessResult, defineJobHandler } from '@netscript/plugin-workers-core';\nimport { withChildSpan, recordJobProgress } from '@netscript/telemetry/instrumentation';\n\nconst handler = defineJobHandler(async (ctx) => {\n recordJobProgress(1, 2, 'steps'); // → job.progress event on the trace\n\n const envCheck = await withChildSpan('check.environment', async (span) => {\n span.setAttribute('check.name', 'environment');\n return { ok: true };\n });\n\n recordJobProgress(2, 2, 'steps');\n return createSuccessResult({ healthy: envCheck.ok });\n});\n\nexport default Object.assign(handler, { id: 'workers-plugin-health-check' as const });" }) }} +{{ comp.codeBlock({ lang: "ts", code: "// plugins/workers/jobs/health-check.ts — a real child span +inside a handler.\n// The dispatcher already wraps this job in traceJobExecution automatically;\n// +withChildSpan opens a child span under that parent. recordJobProgress's 3rd arg\n// is a UNIT label +(e.g. 'steps'), not a free-text message.\nimport { createSuccessResult, defineJobHandler } from +'@netscript/plugin-workers-core';\nimport { withChildSpan, recordJobProgress } from +'@netscript/telemetry/instrumentation';\n\nconst handler = defineJobHandler(async (ctx) => {\n +recordJobProgress(1, 2, 'steps'); // → job.progress event on the trace\n\n const envCheck = await +withChildSpan('check.environment', async (span) => {\n span.setAttribute('check.name', +'environment');\n return { ok: true };\n });\n\n recordJobProgress(2, 2, 'steps');\n return +createSuccessResult({ healthy: envCheck.ok });\n});\n\nexport default Object.assign(handler, { id: +'workers-plugin-health-check' as const });" }) }} [Add OpenTelemetry](/observability/how-to/add-opentelemetry/#step-3-add-your-own-spans-in-a-job-handler) shows the same handler written with the scaffold's `createJobTools(ctx)`. @@ -154,175 +182,197 @@ shows the same handler written with the scaffold's `createJobTools(ctx)`. `@netscript/telemetry/config` reads configuration from the environment and caches the resolved `TelemetryConfig`; you don't construct it. -{{ comp.apiTable({ - caption: "TelemetryConfig (@netscript/telemetry/config — resolved from OTEL_* env vars)", - rows: [ - { name: "enabled", type: "boolean", desc: "Whether OpenTelemetry instrumentation is active (driven by OTEL_DENO / endpoint presence). Mirror it with isTelemetryEnabled()." }, - { name: "endpoint", type: "string | undefined", desc: "OTLP exporter endpoint URL (e.g. the OTLP URL Aspire prints). Read directly via getOtlpEndpoint()." }, - { name: "protocol", type: "string", desc: "OTLP exporter protocol (e.g. http/protobuf), from OTEL_EXPORTER_OTLP_PROTOCOL." }, - { name: "serviceName", type: "string", desc: "Service name reported to backends, from OTEL_SERVICE_NAME (or the default). Read via getServiceName()." }, - { name: "serviceVersion", type: "string", desc: "Service version reported to backends." }, - { name: "resourceAttributes", type: "Record", desc: "Resource attributes parsed from OTEL_RESOURCE_ATTRIBUTES." }, - { name: "sampler", type: "string", desc: "Trace sampler name, from OTEL_TRACES_SAMPLER (e.g. parentbased_always_on, traceidratio)." }, - { name: "debug", type: "boolean", desc: "Whether debug-level telemetry logging is on (OTEL_LOG_LEVEL)." } - ] -}) }} - -{{ comp.apiTable({ - caption: "Config helpers (@netscript/telemetry/config)", - rows: [ - { name: "getTelemetryConfig()", type: "→ TelemetryConfig", desc: "Resolve telemetry config from the OTEL_* environment variables." }, - { name: "getConfig()", type: "→ TelemetryConfig", desc: "Return the process-cached config (resetConfig() clears the cache, mainly for tests)." }, - { name: "isTelemetryEnabled()", type: "→ boolean", desc: "Whether instrumentation is enabled for this process." }, - { name: "getOtlpEndpoint()", type: "→ string | undefined", desc: "The configured OTLP endpoint, when present." }, - { name: "getServiceName()", type: "→ string", desc: "The configured service name, or the default." }, - { name: "describeTelemetryConfig()", type: "→ TelemetryConfigDescription", desc: "A redacted, log-safe summary of the resolved config — safe to print in diagnostics." }, - { name: "OTEL_ENV_VARS", type: "const record", desc: "The OTEL_* variable NAMES NetScript reads: OTEL_DENO, OTEL_EXPORTER_OTLP_ENDPOINT/_PROTOCOL, OTEL_SERVICE_NAME, OTEL_RESOURCE_ATTRIBUTES, OTEL_TRACES_SAMPLER, OTEL_LOG_LEVEL, the BSP/BLRP schedule delays, and OTEL_METRIC_EXPORT_INTERVAL." } - ] -}) }} +{{ comp.apiTable({ caption: "TelemetryConfig (@netscript/telemetry/config — resolved from OTEL_* env +vars)", rows: [ { name: "enabled", type: "boolean", desc: "Whether OpenTelemetry instrumentation is +active (driven by OTEL_DENO / endpoint presence). Mirror it with isTelemetryEnabled()." }, { name: +"endpoint", type: "string | undefined", desc: "OTLP exporter endpoint URL (e.g. the OTLP URL Aspire +prints). Read directly via getOtlpEndpoint()." }, { name: "protocol", type: "string", desc: "OTLP +exporter protocol (e.g. http/protobuf), from OTEL_EXPORTER_OTLP_PROTOCOL." }, { name: "serviceName", +type: "string", desc: "Service name reported to backends, from OTEL_SERVICE_NAME (or the default). +Read via getServiceName()." }, { name: "serviceVersion", type: "string", desc: "Service version +reported to backends." }, { name: "resourceAttributes", type: "Record", desc: +"Resource attributes parsed from OTEL_RESOURCE_ATTRIBUTES." }, { name: "sampler", type: "string", +desc: "Trace sampler name, from OTEL_TRACES_SAMPLER (e.g. parentbased_always_on, traceidratio)." }, +{ name: "debug", type: "boolean", desc: "Whether debug-level telemetry logging is on +(OTEL_LOG_LEVEL)." } ] }) }} + +{{ comp.apiTable({ caption: "Config helpers (@netscript/telemetry/config)", rows: [ { name: +"getTelemetryConfig()", type: "→ TelemetryConfig", desc: "Resolve telemetry config from the OTEL_* +environment variables." }, { name: "getConfig()", type: "→ TelemetryConfig", desc: "Return the +process-cached config (resetConfig() clears the cache, mainly for tests)." }, { name: +"isTelemetryEnabled()", type: "→ boolean", desc: "Whether instrumentation is enabled for this +process." }, { name: "getOtlpEndpoint()", type: "→ string | undefined", desc: "The configured OTLP +endpoint, when present." }, { name: "getServiceName()", type: "→ string", desc: "The configured +service name, or the default." }, { name: "describeTelemetryConfig()", type: "→ +TelemetryConfigDescription", desc: "A redacted, log-safe summary of the resolved config — safe to +print in diagnostics." }, { name: "OTEL_ENV_VARS", type: "const record", desc: "The OTEL_* variable +NAMES NetScript reads: OTEL_DENO, OTEL_EXPORTER_OTLP_ENDPOINT/_PROTOCOL, OTEL_SERVICE_NAME, +OTEL_RESOURCE_ATTRIBUTES, OTEL_TRACES_SAMPLER, OTEL_LOG_LEVEL, the BSP/BLRP schedule delays, and +OTEL_METRIC_EXPORT_INTERVAL." } ] }) }} ## Span & instrumentation helpers -Two subpaths cover hand-written instrumentation. `@netscript/telemetry/tracer` is the low-level facade -over `@opentelemetry/api`: get a tracer, open a span, run a callback inside one. -`@netscript/telemetry/instrumentation` is the NetScript-domain layer the runtimes use themselves, with -job, scheduler, queue and SSE spans that carry the right attributes. The `/context` subpath holds the -**`traceparent`** propagation helpers behind the cross-process trace in the diagram above. - -{{ comp.apiTable({ - caption: "Tracer facade (@netscript/telemetry/tracer)", - rows: [ - { name: "getTracer(name, version)", type: "→ Tracer", desc: "Cached tracer for an instrumentation name/version. Domain shortcuts exist: getJobTracer/getQueueTracer/getWorkerTracer/getSchedulerTracer/getSagaTracer/getSSETracer/getKVTracer." }, - { name: "withSpan(tracer, name, fn, options)", type: "→ Promise", desc: "Run an async callback inside a span and close it on completion. withSpanSync is the synchronous form." }, - { name: "createSpan(tracer, name, options)", type: "→ Span", desc: "Create a span from a tracer + CreateSpanOptions (kind, attributes, parentContext, links). You end() it yourself." }, - { name: "setSpanAttributes / setSpanError / setSpanOk", type: "(span, …) → void", desc: "Bulk-set attributes, mark a span failed (with an optional Error), or mark it OK. addSpanEvent(span, name, attrs?) adds an event." }, - { name: "getActiveSpan() / getActiveContext()", type: "→ Span? / Context", desc: "Read the span / OTel context active on the current async path. isTracingEnabled() gates work." }, - { name: "SpanKind / SpanStatusCode / TracerNames", type: "const", desc: "Span-kind (INTERNAL/SERVER/CLIENT/PRODUCER/CONSUMER), status (UNSET/OK/ERROR), and the standard domain tracer-name strings." } - ] -}) }} - -{{ comp.apiTable({ - caption: "NetScript instrumentation helpers (@netscript/telemetry/instrumentation)", - rows: [ - { name: "traceJobExecution(options, fn)", type: "→ Promise", desc: "Wrap a job run in a span with job.started/completed/failed events. Emitted automatically by the dispatcher; the supported entry point for tracing a job by hand." }, - { name: "withChildSpan(name, fn, attributes?)", type: "→ Promise", desc: "Open a child span under the active span and run fn inside it. The go-to for custom spans in a handler." }, - { name: "recordJobProgress(current, total, unit)", type: "→ void", desc: "Emit a job.progress event. The 3rd arg is a UNIT label (e.g. 'steps'), NOT a description. addJobStepEvent(stepName, attrs?) records job.step.* events." }, - { name: "startJobDispatchSpan / traceJobDispatch", type: "span / → Promise", desc: "Open the dispatch span and return PropagationHeaders to carry traceparent to the executor. createJobSubprocessEnv injects traceparent/tracestate into a subprocess env." }, - { name: "scheduler & cron spans", type: "span / event", desc: "createSchedulerStartSpan, createScheduleJobSpan, startSchedulerTickSpan, traceSchedulerTick, recordCronJobRun — cron/schedule dispatch traced end to end." }, - { name: "traceQueue(queue, options) / TracedQueue", type: "→ TracedQueue", desc: "Wrap a MessageQueue so enqueue/consume carry trace context. SSE helpers (startSSEConnection, createSSEEventSpan, traceSSEEvent) trace Server-Sent-Event streams." } - ] -}) }} - -{{ comp.apiTable({ - caption: "Traceparent / context propagation (@netscript/telemetry/context)", - rows: [ - { name: "formatTraceparent(spanContext)", type: "→ string", desc: "Serialize a span context to a W3C traceparent header value. parseTraceparent(value) parses one back to a ParsedTraceparent | null." }, - { name: "injectContext(headers, ctx?) / extractContext(headers)", type: "→ headers / → Context", desc: "Inject the active trace context into outbound PropagationHeaders, or extract a remote one from inbound headers — the core of cross-service propagation." }, - { name: "withContext(ctx, fn) / withContextAsync(ctx, fn)", type: "→ T / → Promise", desc: "Run a callback with a given OTel context active so spans created inside attach to the right parent." }, - { name: "createMessageHeaders / resolveParentContextFromHeaders", type: "→ headers / → Context", desc: "Build propagation headers for a queue message, and resolve the parent context back out on the consumer side." }, - { name: "getTraceId(ctx?) / getSpanId(ctx?)", type: "→ string?", desc: "Read the current trace/span ids — handy for correlating structured log lines with a trace." } - ] -}) }} +Two subpaths cover hand-written instrumentation. `@netscript/telemetry/tracer` is the low-level +facade over `@opentelemetry/api`: get a tracer, open a span, run a callback inside one. +`@netscript/telemetry/instrumentation` is the NetScript-domain layer the runtimes use themselves, +with job, scheduler, queue and SSE spans that carry the right attributes. The `/context` subpath +holds the **`traceparent`** propagation helpers behind the cross-process trace in the diagram above. + +{{ comp.apiTable({ caption: "Tracer facade (@netscript/telemetry/tracer)", rows: [ { name: +"getTracer(name, version)", type: "→ Tracer", desc: "Cached tracer for an instrumentation +name/version. Domain shortcuts exist: +getJobTracer/getQueueTracer/getWorkerTracer/getSchedulerTracer/getSagaTracer/getSSETracer/getKVTracer." +}, { name: "withSpan(tracer, name, fn, options)", type: "→ Promise", desc: "Run an async callback +inside a span and close it on completion. withSpanSync is the synchronous form." }, { name: +"createSpan(tracer, name, options)", type: "→ Span", desc: "Create a span from a tracer + +CreateSpanOptions (kind, attributes, parentContext, links). You end() it yourself." }, { name: +"setSpanAttributes / setSpanError / setSpanOk", type: "(span, …) → void", desc: "Bulk-set +attributes, mark a span failed (with an optional Error), or mark it OK. addSpanEvent(span, name, +attrs?) adds an event." }, { name: "getActiveSpan() / getActiveContext()", type: "→ Span? / +Context", desc: "Read the span / OTel context active on the current async path. isTracingEnabled() +gates work." }, { name: "SpanKind / SpanStatusCode / TracerNames", type: "const", desc: "Span-kind +(INTERNAL/SERVER/CLIENT/PRODUCER/CONSUMER), status (UNSET/OK/ERROR), and the standard domain +tracer-name strings." } ] }) }} + +{{ comp.apiTable({ caption: "NetScript instrumentation helpers +(@netscript/telemetry/instrumentation)", rows: [ { name: "traceJobExecution(options, fn)", type: "→ +Promise", desc: "Wrap a job run in a span with job.started/completed/failed events. Emitted +automatically by the dispatcher; the supported entry point for tracing a job by hand." }, { name: +"withChildSpan(name, fn, attributes?)", type: "→ Promise", desc: "Open a child span under the +active span and run fn inside it. The go-to for custom spans in a handler." }, { name: +"recordJobProgress(current, total, unit)", type: "→ void", desc: "Emit a job.progress event. The 3rd +arg is a UNIT label (e.g. 'steps'), NOT a description. addJobStepEvent(stepName, attrs?) records +job.step.* events." }, { name: "startJobDispatchSpan / traceJobDispatch", type: "span / → +Promise", desc: "Open the dispatch span and return PropagationHeaders to carry traceparent to +the executor. createJobSubprocessEnv injects traceparent/tracestate into a subprocess env." }, { +name: "scheduler & cron spans", type: "span / event", desc: "createSchedulerStartSpan, +createScheduleJobSpan, startSchedulerTickSpan, traceSchedulerTick, recordCronJobRun — cron/schedule +dispatch traced end to end." }, { name: "traceQueue(queue, options) / TracedQueue", type: "→ +TracedQueue", desc: "Wrap a MessageQueue so enqueue/consume carry trace context. SSE helpers +(startSSEConnection, createSSEEventSpan, traceSSEEvent) trace Server-Sent-Event streams." } ] }) }} + +{{ comp.apiTable({ caption: "Traceparent / context propagation (@netscript/telemetry/context)", +rows: [ { name: "formatTraceparent(spanContext)", type: "→ string", desc: "Serialize a span context +to a W3C traceparent header value. parseTraceparent(value) parses one back to a ParsedTraceparent | +null." }, { name: "injectContext(headers, ctx?) / extractContext(headers)", type: "→ headers / → +Context", desc: "Inject the active trace context into outbound PropagationHeaders, or extract a +remote one from inbound headers — the core of cross-service propagation." }, { name: +"withContext(ctx, fn) / withContextAsync(ctx, fn)", type: "→ T / → Promise", desc: "Run a +callback with a given OTel context active so spans created inside attach to the right parent." }, { +name: "createMessageHeaders / resolveParentContextFromHeaders", type: "→ headers / → Context", desc: +"Build propagation headers for a queue message, and resolve the parent context back out on the +consumer side." }, { name: "getTraceId(ctx?) / getSpanId(ctx?)", type: "→ string?", desc: "Read the +current trace/span ids — handy for correlating structured log lines with a trace." } ] }) }} ## Service, RPC & HTTP tracing Services get trace propagation from **first-party instrumentation** that wraps the upstream OTel packages. The `@netscript/telemetry/orpc` subpath ships an oRPC **tracing plugin**, backed by the upstream `@orpc/otel` instrumentation, that opens a SERVER span per RPC and continues any inbound -`traceparent`, plus an error-handling plugin that classifies failures. The `@netscript/telemetry/hono` -subpath does the same for plain HTTP: `createHonoTracingMiddleware` wraps Hono's first-party -`@hono/otel` middleware and adds NetScript service naming and W3C propagation, and the service builder -registers it outermost for you. On the service builder, the RPC side is the -`.withRPC({ traceContext: true })` toggle (see [Services](/services-sdk/services/)); the factories -below are the underlying surface if you mount oRPC or Hono yourself. - -{{ comp.apiTable({ - caption: "oRPC + Hono tracing surface (@netscript/telemetry/orpc, @netscript/telemetry/hono)", - rows: [ - { name: "createTracingPlugin(options?)", type: "→ TracingPlugin", desc: "oRPC plugin that opens a SERVER span per call and continues an inbound traceparent, following upstream rpc.* semconv. Options are TracingPluginOptions." }, - { name: "registerORPCInstrumentation(config?)", type: "→ void", desc: "Registers the upstream @orpc/otel ORPCInstrumentation the tracing plugin is backed by — wrap-don't-reinvent, applied to oRPC." }, - { name: "createErrorHandlingPlugin(options?)", type: "→ ErrorHandlingPlugin", desc: "Classifies errors as client | server | transient and records them on the span; takes an optional ErrorClassifier and ErrorLogger." }, - { name: "createTraceContext()", type: "→ TraceContext", desc: "Build the per-call trace context the plugin threads through. addEvent / setAttributes / getTraceId / getSpanId operate on the active span." }, - { name: "createHonoTracingMiddleware(options)", type: "→ HonoTracingMiddleware", desc: "Hono middleware wrapping @hono/otel's httpInstrumentationMiddleware with NetScript service naming + W3C propagation. app.use('*', createHonoTracingMiddleware({ serviceName: 'users' }))." } - ] -}) }} - -Prisma query spans are covered in -[Database & Prisma](/data-persistence/database/#query-tracing), and the worker job spans in -[What is traced automatically](#what-is-traced-automatically). +`traceparent`, plus an error-handling plugin that classifies failures. The +`@netscript/telemetry/hono` subpath does the same for plain HTTP: `createHonoTracingMiddleware` +wraps Hono's first-party `@hono/otel` middleware and adds NetScript service naming and W3C +propagation, and the service builder registers it outermost for you. On the service builder, the RPC +side is the `.withRPC({ traceContext: true })` toggle (see [Services](/services-sdk/services/)); the +factories below are the underlying surface if you mount oRPC or Hono yourself. + +{{ comp.apiTable({ caption: "oRPC + Hono tracing surface (@netscript/telemetry/orpc, +@netscript/telemetry/hono)", rows: [ { name: "createTracingPlugin(options?)", type: "→ +TracingPlugin", desc: "oRPC plugin that opens a SERVER span per call and continues an inbound +traceparent, following upstream rpc.* semconv. Options are TracingPluginOptions." }, { name: +"registerORPCInstrumentation(config?)", type: "→ void", desc: "Registers the upstream @orpc/otel +ORPCInstrumentation the tracing plugin is backed by — wrap-don't-reinvent, applied to oRPC." }, { +name: "createErrorHandlingPlugin(options?)", type: "→ ErrorHandlingPlugin", desc: "Classifies errors +as client | server | transient and records them on the span; takes an optional ErrorClassifier and +ErrorLogger." }, { name: "createTraceContext()", type: "→ TraceContext", desc: "Build the per-call +trace context the plugin threads through. addEvent / setAttributes / getTraceId / getSpanId operate +on the active span." }, { name: "createHonoTracingMiddleware(options)", type: "→ +HonoTracingMiddleware", desc: "Hono middleware wrapping @hono/otel's httpInstrumentationMiddleware +with NetScript service naming + W3C propagation. app.use('*', createHonoTracingMiddleware({ +serviceName: 'users' }))." } ] }) }} + +Prisma query spans are covered in [Database & Prisma](/data-persistence/database/#query-tracing), +and the worker job spans in [What is traced automatically](#what-is-traced-automatically). ## Endpoints & ports Telemetry has no service of its own: every runtime emits it and Aspire aggregates it. These are the addresses you interact with. -{{ comp.apiTable({ - caption: "Observability surfaces (link to /reference/telemetry/ and /reference/logger/ for the full APIs)", - rows: [ - { name: "the URL Aspire prints", type: "dashboard", desc: "Aspire dashboard — traces, structured logs, metrics, and resource state for the whole app graph. The generated local profile allows anonymous dashboard access." }, - { name: "the OTLP URL Aspire prints", type: "OTLP/HTTP", desc: "OTLP ingest endpoint the AppHost configures (aspire.config.json profile). Runtimes export spans and logs here; the dashboard reads them back. This is the seam you point at a hosted backend." }, - { name: "GET /health", type: "Workers API", desc: "Workers API health probe — reported as resource health in the dashboard (on its assigned port)." }, - { name: "GET /health/live", type: "Sagas API", desc: "Sagas API liveness route (on its assigned port)." }, - { name: "GET /health", type: "liveness", desc: "Triggers API health probe (Hono service)." }, - { name: "auth-api", type: "service", desc: "Auth API (auth-api) — its request spans propagate trace context like any other service." } - ] -}) }} +{{ comp.apiTable({ caption: "Observability surfaces (link to /reference/telemetry/ and +/reference/logger/ for the full APIs)", rows: [ { name: "the URL Aspire prints", type: "dashboard", +desc: "Aspire dashboard — traces, structured logs, metrics, and resource state for the whole app +graph. The generated local profile allows anonymous dashboard access." }, { name: "the OTLP URL +Aspire prints", type: "OTLP/HTTP", desc: "OTLP ingest endpoint the AppHost configures +(aspire.config.json profile). Runtimes export spans and logs here; the dashboard reads them back. +This is the seam you point at a hosted backend." }, { name: "GET /health", type: "Workers API", +desc: "Workers API health probe — reported as resource health in the dashboard (on its assigned +port)." }, { name: "GET /health/live", type: "Sagas API", desc: "Sagas API liveness route (on its +assigned port)." }, { name: "GET /health", type: "liveness", desc: "Triggers API health probe (Hono +service)." }, { name: "auth-api", type: "service", desc: "Auth API (auth-api) — its request spans +propagate trace context like any other service." } ] }) }} ## View it in Aspire With `aspire start` up, the dashboard gives you four views over the same telemetry stream: -{{ comp.apiTable({ - caption: "Aspire dashboard views (the URL Aspire prints)", - rows: [ - { name: "Resources", type: "graph", desc: "Live state of every app-graph resource: postgres, redis, workers-api, workers, sagas-api, sagas, triggers-api, triggers, auth-api. Health probes drive the status colour." }, - { name: "Console logs", type: "stream", desc: "Per-resource stdout/stderr — the framework logger's text/JSON output lands here in real time." }, - { name: "Structured logs", type: "OTLP", desc: "Structured log records exported over OTLP, filterable by resource, level, and attributes." }, - { name: "Traces", type: "OTLP", desc: "Distributed traces collected from the OTLP endpoint (the OTLP URL Aspire prints) — job dispatch/execution/scheduler/task spans and cross-service request spans as trace context propagates." } - ] -}) }} +{{ comp.apiTable({ caption: "Aspire dashboard views (the URL Aspire prints)", rows: [ { name: +"Resources", type: "graph", desc: "Live state of every app-graph resource: postgres, redis, +workers-api, workers, sagas-api, sagas, triggers-api, triggers, auth-api. Health probes drive the +status colour." }, { name: "Console logs", type: "stream", desc: "Per-resource stdout/stderr — the +framework logger's text/JSON output lands here in real time." }, { name: "Structured logs", type: +"OTLP", desc: "Structured log records exported over OTLP, filterable by resource, level, and +attributes." }, { name: "Traces", type: "OTLP", desc: "Distributed traces collected from the OTLP +endpoint (the OTLP URL Aspire prints) — job dispatch/execution/scheduler/task spans and +cross-service request spans as trace context propagates." } ] }) }} ## Close the loop: read the trace back in code -The dashboard answers *what happened and where* for a person. Programs, and AI agents verifying their -own change without a browser, use the **typed read side**. `@netscript/telemetry/query` publishes a -`TelemetryQueryPort` contract with an Aspire-backed reader: `createAspireTelemetryQuery(...)`, or -`createTelemetryQuery(...)` for the port type, reads the Aspire `/api/telemetry/*` surface into -package-owned read models: `TelemetryTrace`, `TelemetrySpan` (with its `events` and `links`), -`TelemetryLog`, `TelemetryResource` and `TelemetryMetric`. Verification becomes an assertion: fetch -the trace by id and check that the span you expected is present with the status you expected. - -{{ comp.apiTable({ - caption: "Telemetry query read side (@netscript/telemetry/query)", - rows: [ - { name: "createAspireTelemetryQuery(options) / createTelemetryQuery(options)", type: "→ AspireTelemetryQuery / TelemetryQueryPort", desc: "Build the Aspire-backed reader over the dashboard's /api/telemetry/* surface. The first returns the concrete adapter; the second returns it typed as the port contract." }, - { name: "queryTraces(filter?) / getTrace(traceId)", type: "→ Promise / Promise", desc: "List traces matching a TraceQueryFilter, or fetch a single trace by id — the assertion primitive for 'did my flow produce the span I expected'." }, - { name: "querySpans / queryLogs / queryMetrics / queryResources", type: "→ Promise", desc: "Read spans, structured logs, metrics, and resource records back as package-owned models (TelemetrySpan / TelemetryLog / TelemetryMetric / TelemetryResource)." }, - { name: "validateTraceQueryFilter / validateMetricQueryFilter / validateResourceQueryFilter", type: "(filter) → filter", desc: "Standard Schema validators for the query filters — a malformed query fails in-process rather than returning silently-wrong rows." } - ] -}) }} - -Encore exposes its local traces to an AI agent through an MCP server. NetScript makes the read side a -typed in-language port that the app, a test or an agent's own tool calls directly, and it returns the -same package-owned read models the runtimes emit. +The dashboard answers _what happened and where_ for a person. Programs, and AI agents verifying +their own change without a browser, use the **typed read side**. `@netscript/telemetry/query` +publishes a `TelemetryQueryPort` contract with an Aspire-backed reader: +`createAspireTelemetryQuery(...)`, or `createTelemetryQuery(...)` for the port type, reads the +Aspire `/api/telemetry/*` surface into package-owned read models: `TelemetryTrace`, `TelemetrySpan` +(with its `events` and `links`), `TelemetryLog`, `TelemetryResource` and `TelemetryMetric`. +Verification becomes an assertion: fetch the trace by id and check that the span you expected is +present with the status you expected. + +{{ comp.apiTable({ caption: "Telemetry query read side (@netscript/telemetry/query)", rows: [ { +name: "createAspireTelemetryQuery(options) / createTelemetryQuery(options)", type: "→ +AspireTelemetryQuery / TelemetryQueryPort", desc: "Build the Aspire-backed reader over the +dashboard's /api/telemetry/* surface. The first returns the concrete adapter; the second returns it +typed as the port contract." }, { name: "queryTraces(filter?) / getTrace(traceId)", type: "→ +Promise / Promise", desc: "List traces matching a +TraceQueryFilter, or fetch a single trace by id — the assertion primitive for 'did my flow produce +the span I expected'." }, { name: "querySpans / queryLogs / queryMetrics / queryResources", type: "→ +Promise", desc: "Read spans, structured logs, metrics, and resource records back as +package-owned models (TelemetrySpan / TelemetryLog / TelemetryMetric / TelemetryResource)." }, { +name: "validateTraceQueryFilter / validateMetricQueryFilter / validateResourceQueryFilter", type: +"(filter) → filter", desc: "Standard Schema validators for the query filters — a malformed query +fails in-process rather than returning silently-wrong rows." } ] }) }} + +Encore exposes its local traces to an AI agent through an MCP server. NetScript makes the read side +a typed in-language port that the app, a test or an agent's own tool calls directly, and it returns +the same package-owned read models the runtimes emit. ## Production notes -| Avoid | Do instead | -| --- | --- | +| Avoid | Do instead | +| --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Tracing 100% of traffic in production. The local Aspire default samples everything, which is fine for development and ruinous at scale. | Set a ratio sampler in the environment: `OTEL_TRACES_SAMPLER` (surfaced as `TelemetryConfig.sampler`) to `traceidratio` with a rate. Keep always-on sampling for low-volume services or a targeted debugging window. | -| Editing instrumentation to point at Grafana or Honeycomb; you redo that churn on every upgrade. | Point the exporter. `OTEL_EXPORTER_OTLP_ENDPOINT` (injected by Aspire locally) is the single seam: change endpoint and protocol in the environment and the instrumentation code stays the same. | -| Unbounded values such as user ids, raw URLs or full payloads in `span.setAttribute`; they explode index cardinality on the backend. | Use stable, low-cardinality keys. To correlate a specific record, log `getTraceId()` in a structured log line instead of widening the span. | -| A message as `recordJobProgress`'s third argument; free text there inflates cardinality and misreads the API. | Pass a stable unit label such as `'steps'` or `'items'`. | -| Treating `progress(percent, message)` as only a log line. | Use it for both telemetry and runtime progress: it emits a `job.progress` event and forwards the percentage and message to the workers channel. | +| Editing instrumentation to point at Grafana or Honeycomb; you redo that churn on every upgrade. | Point the exporter. `OTEL_EXPORTER_OTLP_ENDPOINT` (injected by Aspire locally) is the single seam: change endpoint and protocol in the environment and the instrumentation code stays the same. | +| Unbounded values such as user ids, raw URLs or full payloads in `span.setAttribute`; they explode index cardinality on the backend. | Use stable, low-cardinality keys. To correlate a specific record, log `getTraceId()` in a structured log line instead of widening the span. | +| A message as `recordJobProgress`'s third argument; free text there inflates cardinality and misreads the API. | Pass a stable unit label such as `'steps'` or `'items'`. | +| Treating `progress(percent, message)` as only a log line. | Use it for both telemetry and runtime progress: it emits a `job.progress` event and forwards the percentage and message to the workers channel. | ## Next steps -Follow [Add OpenTelemetry](/observability/how-to/add-opentelemetry/) to trigger a trace, add your own -spans and read them in the dashboard. +Follow [Add OpenTelemetry](/observability/how-to/add-opentelemetry/) to trigger a trace, add your +own spans and read them in the dashboard. -- [Observability model](/explanation/observability/): how automatic framework spans, `createJobTools(ctx)` - handler telemetry, console logs, health endpoints and Aspire traces fit together. +- [Observability model](/explanation/observability/): how automatic framework spans, + `createJobTools(ctx)` handler telemetry, console logs, health endpoints and Aspire traces fit + together. - {{ comp.xref({ key: "ref:telemetry" }) }} and [logger](/reference/logger/) references: the full APIs. - [Telemetry conventions](/reference/telemetry/convention/): span naming, SpanKind and the diff --git a/docs/site/orchestration-runtime/child-health.md b/docs/site/orchestration-runtime/child-health.md index b6f39abecf..51624f2e89 100644 --- a/docs/site/orchestration-runtime/child-health.md +++ b/docs/site/orchestration-runtime/child-health.md @@ -6,7 +6,7 @@ templateEngine: [vento, md] order: 3 --- - # Background child health @@ -92,6 +92,49 @@ import { CHILD_CRASH_LOOP_THRESHOLD } from '@netscript/plugin/health'; console.log(CHILD_CRASH_LOOP_THRESHOLD.restarts); // 3 ``` +## `ChildHealthProcessOptions` + +Process health composition, including optional single-owner restart history. + +The listener binds 127.0.0.1 by default; hostname overrides the bind address. Shutdown allows 35 +seconds total by default: 30 seconds for work, with five seconds reserved for resource cleanup and +the health listener. Cleanup callbacks run even when work times out. Fatal health remains visible +for one second before this budget starts. Exit codes are 0 for a clean drain, 1 for failure and 2 +for any shutdown deadline. Set exitOnShutdown to false when a host owns termination. + +Example: + +```ts +import type { ChildHealthProcessOptions } from '@netscript/plugin/health'; +const options: ChildHealthProcessOptions = { + restartHistoryPath: '.data/child-health/custom.json', +}; +``` + +## `runChildHealthProcess` + +Start health before bootstrap and expose failure for one second before exiting. + +Signal handlers and the health listener are owned by this process, independent of a frontend +session. Fatal causes remain in server logs, never in the payload, and set the process exit code to +one. The child must drain when its signal is aborted. Work drains before owned cleanups within the +total budget. With exitOnShutdown false, failures reject with PluginError instead of terminating the +embedding process. + +Example: + +```ts +import { runChildHealthProcess } from '@netscript/plugin/health'; +if (import.meta.main) { + await runChildHealthProcess(async (health, signal) => { + health.registryLoaded(); + health.dependenciesReady(); + health.running(); + await new Promise((resolve) => signal.addEventListener('abort', () => resolve())); + }); +} +``` + The current threshold is **3 restarts within 60 seconds**. The window includes its boundary. Only `ready` with both readiness flags true returns HTTP 200 from `/health`; other states return HTTP 503. A healthy API with a stopped or crash-looping child yields `degraded` in plugin doctor and diff --git a/docs/site/reference/plugin/index.md b/docs/site/reference/plugin/index.md index df1d6cc7f3..dcefcc741e 100644 --- a/docs/site/reference/plugin/index.md +++ b/docs/site/reference/plugin/index.md @@ -11,40 +11,40 @@ health surfaces a plugin contributes. ## Sub-path exports -| Export | Entrypoint | Purpose | -| --- | --- | --- | -| `@netscript/plugin` | `./mod.ts` | Plugin authoring contract: [definition](#plugin-definition), [diagnostics](#diagnostics), [errors](#errors), [contributions](#contributions) and manifest types. | -| `@netscript/plugin/health` | `./src/health/mod.ts` | [Background child health contract and process transport](#netscriptpluginhealth). | -| `@netscript/plugin/config` | `./src/config/mod.ts` | [Builder, manifest schema, and contribution type contracts](#netscriptpluginconfig). | -| `@netscript/plugin/abstracts` | `./src/abstracts/mod.ts` | [Abstract contribution base classes per axis](#netscriptpluginabstracts). | -| `@netscript/plugin/adapter` | `./src/adapter/mod.ts` | [Local host command adapters](#netscriptpluginadapter). | -| `@netscript/plugin/cli` | `./src/cli/mod.ts` | [Plugin CLI base classes, command mounting, and doctor reports](#netscriptplugincli). | -| `@netscript/plugin/sdk` | `./src/sdk/mod.ts` | [Discovery ports, alpha adapters, and runtime host stubs](#netscriptpluginsdk). | -| `@netscript/plugin/loader` | `./loader.ts` | [Host-side plugin service bootstrap helpers](#netscriptpluginloader). | -| `@netscript/plugin/protocol` | `./src/protocol/mod.ts` | [Plugin manifest schemas and installer protocol definitions](#netscriptpluginprotocol). | -| `@netscript/plugin/scaffold` | `./src/scaffold/mod.ts` | [Template generators and registry emitters](#netscriptpluginscaffold). | -| `@netscript/plugin/testing` | `./src/testing/mod.ts` | [In-memory adapters, fixtures, and the CLI contract harness](#netscriptplugintesting). | -| `@netscript/plugin/templates` | `./src/templates/mod.ts` | [Plugin skeleton template asset paths](#netscriptplugintemplates). | -| `@netscript/plugin/contract-base` | `./src/contract-base/mod.ts` | [Standard plugin capability checks](#netscriptplugincontract-base). | -| `@netscript/plugin/service` | `./src/service/mod.ts` | [Out-of-process plugin service binders](#netscriptpluginservice). | +| Export | Entrypoint | Purpose | +| --------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `@netscript/plugin` | `./mod.ts` | Plugin authoring contract: [definition](#plugin-definition), [diagnostics](#diagnostics), [errors](#errors), [contributions](#contributions) and manifest types. | +| `@netscript/plugin/health` | `./src/health/mod.ts` | [Background child health contract and process transport](#netscriptpluginhealth). | +| `@netscript/plugin/config` | `./src/config/mod.ts` | [Builder, manifest schema, and contribution type contracts](#netscriptpluginconfig). | +| `@netscript/plugin/abstracts` | `./src/abstracts/mod.ts` | [Abstract contribution base classes per axis](#netscriptpluginabstracts). | +| `@netscript/plugin/adapter` | `./src/adapter/mod.ts` | [Local host command adapters](#netscriptpluginadapter). | +| `@netscript/plugin/cli` | `./src/cli/mod.ts` | [Plugin CLI base classes, command mounting, and doctor reports](#netscriptplugincli). | +| `@netscript/plugin/sdk` | `./src/sdk/mod.ts` | [Discovery ports, alpha adapters, and runtime host stubs](#netscriptpluginsdk). | +| `@netscript/plugin/loader` | `./loader.ts` | [Host-side plugin service bootstrap helpers](#netscriptpluginloader). | +| `@netscript/plugin/protocol` | `./src/protocol/mod.ts` | [Plugin manifest schemas and installer protocol definitions](#netscriptpluginprotocol). | +| `@netscript/plugin/scaffold` | `./src/scaffold/mod.ts` | [Template generators and registry emitters](#netscriptpluginscaffold). | +| `@netscript/plugin/testing` | `./src/testing/mod.ts` | [In-memory adapters, fixtures, and the CLI contract harness](#netscriptplugintesting). | +| `@netscript/plugin/templates` | `./src/templates/mod.ts` | [Plugin skeleton template asset paths](#netscriptplugintemplates). | +| `@netscript/plugin/contract-base` | `./src/contract-base/mod.ts` | [Standard plugin capability checks](#netscriptplugincontract-base). | +| `@netscript/plugin/service` | `./src/service/mod.ts` | [Out-of-process plugin service binders](#netscriptpluginservice). | ## Plugin definition -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `definePlugin` | function | `function definePlugin(name: TName, version: TVersion): PluginBuilder` | Start a new plugin manifest builder chain. | -| `PluginBuilder` | class | `class PluginBuilder` | Fluent builder for assembling plugin manifests. | -| `PluginBuilderState` | interface | `interface PluginBuilderState` | Immutable state accumulated by the plugin builder chain. | -| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | +| Symbol | Kind | Signature | Description | +| -------------------- | --------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------- | +| `definePlugin` | function | `function definePlugin(name: TName, version: TVersion): PluginBuilder` | Start a new plugin manifest builder chain. | +| `PluginBuilder` | class | `class PluginBuilder` | Fluent builder for assembling plugin manifests. | +| `PluginBuilderState` | interface | `interface PluginBuilderState` | Immutable state accumulated by the plugin builder chain. | +| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | ## Diagnostics -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `inspectPlugin` | function | `function inspectPlugin(target): InspectionReport` | Inspect a plugin manifest, registry, or path-like target. | -| `InspectionReport` | interface | `interface InspectionReport` | JSON-stable diagnostic report returned by plugin inspectors. | -| `InspectablePluginManifest` | interface | `interface InspectablePluginManifest` | Minimal plugin manifest shape accepted by the plugin inspector. | -| `InspectablePluginRegistry` | interface | `interface InspectablePluginRegistry` | Minimal registry shape accepted by the plugin inspector. | +| Symbol | Kind | Signature | Description | +| --------------------------- | --------- | -------------------------------------------------- | --------------------------------------------------------------- | +| `inspectPlugin` | function | `function inspectPlugin(target): InspectionReport` | Inspect a plugin manifest, registry, or path-like target. | +| `InspectionReport` | interface | `interface InspectionReport` | JSON-stable diagnostic report returned by plugin inspectors. | +| `InspectablePluginManifest` | interface | `interface InspectablePluginManifest` | Minimal plugin manifest shape accepted by the plugin inspector. | +| `InspectablePluginRegistry` | interface | `interface InspectablePluginRegistry` | Minimal registry shape accepted by the plugin inspector. | ## Errors @@ -121,9 +121,9 @@ version matches only itself. Library packages that are not plugins belong in `de not in a manifest's `dependencies`. > [!IMPORTANT] -> **Breaking change.** `PluginManifestSchema`, `definePlugin(...).build()`, and the composition check -> reject unknown contribution keys. A misspelled key such as `servces`, previously ignored, fails with -> the plugin name and the key. Rename it to the documented key, or remove it. +> **Breaking change.** `PluginManifestSchema`, `definePlugin(...).build()`, and the composition +> check reject unknown contribution keys. A misspelled key such as `servces`, previously ignored, +> fails with the plugin name and the key. Rename it to the documented key, or remove it. ## Manifest types @@ -147,17 +147,17 @@ not in a manifest's `dependencies`. ## `@netscript/plugin/config` -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `definePlugin` | function | `function definePlugin(name, version): PluginBuilder` | Start a new plugin manifest builder chain. | +| Symbol | Kind | Signature | Description | +| --------------------------- | -------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | +| `definePlugin` | function | `function definePlugin(name, version): PluginBuilder` | Start a new plugin manifest builder chain. | | `validatePluginComposition` | function | `function validatePluginComposition(plugins): PluginCompositionResult` | Validate that plugin manifests compose into one root host. See [Root composition validation](#root-composition-validation). | -| `mergeContributions` | function | `function mergeContributions(base, overrides): PluginContributions` | Merge plugin contribution groups without mutating inputs; throws when both set `aspire` or `doctor`. | -| `isContributionAxis` | function | `function isContributionAxis(value: string): boolean` | Check whether a value is a supported contribution axis. | -| `isReservedPluginName` | function | `function isReservedPluginName(name: string): boolean` | Return true when a plugin name is reserved by NetScript. | -| `PluginManifestSchema` | const | `variable PluginManifestSchema` | Zod schema for plugin manifests; contribution keys are closed. | -| `PluginCompositionError` | class | class | Error thrown when manifests cannot be composed into one root host. | -| `CONTRIBUTION_AXES` | const | `variable CONTRIBUTION_AXES` | Supported plugin contribution axes. | -| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | +| `mergeContributions` | function | `function mergeContributions(base, overrides): PluginContributions` | Merge plugin contribution groups without mutating inputs; throws when both set `aspire` or `doctor`. | +| `isContributionAxis` | function | `function isContributionAxis(value: string): boolean` | Check whether a value is a supported contribution axis. | +| `isReservedPluginName` | function | `function isReservedPluginName(name: string): boolean` | Return true when a plugin name is reserved by NetScript. | +| `PluginManifestSchema` | const | `variable PluginManifestSchema` | Zod schema for plugin manifests; contribution keys are closed. | +| `PluginCompositionError` | class | class | Error thrown when manifests cannot be composed into one root host. | +| `CONTRIBUTION_AXES` | const | `variable CONTRIBUTION_AXES` | Supported plugin contribution axes. | +| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | This entrypoint also re-exports `PluginBuilder`, `ContributionInput`, `DependencyContext`, `PluginBuilderState`, `BackgroundProcessorContribution`, `ContractVersionContribution`, @@ -191,121 +191,121 @@ This entrypoint also re-exports `PluginBuilder`, `ContributionInput`, `Dependenc ## `@netscript/plugin/adapter` -| Symbol | Kind | Description | -| --- | --- | --- | -| `DoctorCheckSpec` | interface | Extra doctor check supplied by a plugin seam. | -| `DoctorSpec` | interface | Seam data consumed by the mandatory doctor algorithm. | -| `InfoSpec` | interface | Static capability summary returned by the mandatory info command. | -| `InstallSpec` | interface | Seam data consumed by the mandatory install algorithm. | -| `InstallStarterResource` | interface | Starter resource emitted by the mandatory install command. | -| `InstallStarterSamplesPolicy` | type alias | Behavior for an install starter when the host excludes samples. | -| `NetScriptPlugin` | interface | Plugin adapter contract consumed by core command logic. | -| `PluginAdapter` | interface | Adapter object produced by the plugin adapter factory. | -| `PluginCliEntrypoint` | type alias | CLI entrypoint produced by `createPluginAdapter(plugin).toCli()`. | -| `PluginCommandConfig` | type alias | Readonly command configuration supplied by the host. | -| `PluginCommandContext` | interface | Context shared by adapter command algorithms. | -| `PluginCommandSpec` | interface | Optional plugin-owned command handler. | -| `PluginCommandValue` | type alias | Primitive value accepted in plugin command configuration. | -| `PluginResource` | interface | Optional plugin-owned resource command. | -| `RemoveSpec` | interface | Seam data consumed by the mandatory remove algorithm. | -| `UpdateSpec` | interface | Seam data consumed by the mandatory update algorithm. | -| `createDenoFileSystem` | function | Create the default Deno-backed file-system port for adapter commands. | -| `DEFAULT_PLUGIN_HEALTH_ENDPOINT` | const | Default health endpoint used by plugin doctor commands. | -| `DEFAULT_PLUGIN_WORKSPACE_ROOT` | const | Default workspace root used when no explicit root is supplied. | -| `resolveWorkspacePath` | function | Resolve a workspace-relative path against a workspace root. | -| `createPluginAdapter` | function | Create the core adapter for a plugin contract object. | -| `RunInstallCommandOptions` | interface | Input consumed by the mandatory install command. | -| `collectInstallArtifacts` | function | Emit starter artifacts from the plugin's install seams. | -| `createInstallScaffoldEntrypoint` | function | Create a scaffolder protocol entrypoint from the install command. | -| `runInstallCommand` | function | Run the core-owned plugin install algorithm. | -| `RunDoctorCommandOptions` | interface | Input consumed by the mandatory doctor command. | -| `runDoctorCommand` | function | Run the core-owned plugin doctor algorithm. | -| `PluginInfoReport` | interface | Structured report returned by the mandatory info command. | -| `RunInfoCommandOptions` | interface | Input consumed by the mandatory info command. | -| `runInfoCommand` | function | Run the core-owned plugin info algorithm. | -| `RunUpdateCommandOptions` | interface | Input consumed by the mandatory update command. | -| `runUpdateCommand` | function | Run the core-owned plugin update algorithm. | -| `RunRemoveCommandOptions` | interface | Input consumed by the mandatory remove command. | -| `runRemoveCommand` | function | Run the core-owned plugin remove algorithm. | -| `RunPluginCliCommandOptions` | interface | Input consumed by the plugin CLI runner. | -| `runPluginCliCommand` | function | Route a plugin CLI verb to mandatory logic or a plugin-owned handler. | -| `runPluginScaffoldCli` | function | Run a plugin scaffold entrypoint from the host CLI subprocess protocol. | +| Symbol | Kind | Description | +| --------------------------------- | ---------- | ----------------------------------------------------------------------- | +| `DoctorCheckSpec` | interface | Extra doctor check supplied by a plugin seam. | +| `DoctorSpec` | interface | Seam data consumed by the mandatory doctor algorithm. | +| `InfoSpec` | interface | Static capability summary returned by the mandatory info command. | +| `InstallSpec` | interface | Seam data consumed by the mandatory install algorithm. | +| `InstallStarterResource` | interface | Starter resource emitted by the mandatory install command. | +| `InstallStarterSamplesPolicy` | type alias | Behavior for an install starter when the host excludes samples. | +| `NetScriptPlugin` | interface | Plugin adapter contract consumed by core command logic. | +| `PluginAdapter` | interface | Adapter object produced by the plugin adapter factory. | +| `PluginCliEntrypoint` | type alias | CLI entrypoint produced by `createPluginAdapter(plugin).toCli()`. | +| `PluginCommandConfig` | type alias | Readonly command configuration supplied by the host. | +| `PluginCommandContext` | interface | Context shared by adapter command algorithms. | +| `PluginCommandSpec` | interface | Optional plugin-owned command handler. | +| `PluginCommandValue` | type alias | Primitive value accepted in plugin command configuration. | +| `PluginResource` | interface | Optional plugin-owned resource command. | +| `RemoveSpec` | interface | Seam data consumed by the mandatory remove algorithm. | +| `UpdateSpec` | interface | Seam data consumed by the mandatory update algorithm. | +| `createDenoFileSystem` | function | Create the default Deno-backed file-system port for adapter commands. | +| `DEFAULT_PLUGIN_HEALTH_ENDPOINT` | const | Default health endpoint used by plugin doctor commands. | +| `DEFAULT_PLUGIN_WORKSPACE_ROOT` | const | Default workspace root used when no explicit root is supplied. | +| `resolveWorkspacePath` | function | Resolve a workspace-relative path against a workspace root. | +| `createPluginAdapter` | function | Create the core adapter for a plugin contract object. | +| `RunInstallCommandOptions` | interface | Input consumed by the mandatory install command. | +| `collectInstallArtifacts` | function | Emit starter artifacts from the plugin's install seams. | +| `createInstallScaffoldEntrypoint` | function | Create a scaffolder protocol entrypoint from the install command. | +| `runInstallCommand` | function | Run the core-owned plugin install algorithm. | +| `RunDoctorCommandOptions` | interface | Input consumed by the mandatory doctor command. | +| `runDoctorCommand` | function | Run the core-owned plugin doctor algorithm. | +| `PluginInfoReport` | interface | Structured report returned by the mandatory info command. | +| `RunInfoCommandOptions` | interface | Input consumed by the mandatory info command. | +| `runInfoCommand` | function | Run the core-owned plugin info algorithm. | +| `RunUpdateCommandOptions` | interface | Input consumed by the mandatory update command. | +| `runUpdateCommand` | function | Run the core-owned plugin update algorithm. | +| `RunRemoveCommandOptions` | interface | Input consumed by the mandatory remove command. | +| `runRemoveCommand` | function | Run the core-owned plugin remove algorithm. | +| `RunPluginCliCommandOptions` | interface | Input consumed by the plugin CLI runner. | +| `runPluginCliCommand` | function | Route a plugin CLI verb to mandatory logic or a plugin-owned handler. | +| `runPluginScaffoldCli` | function | Run a plugin scaffold entrypoint from the host CLI subprocess protocol. | This entrypoint also re-exports the root and CLI symbols `DoctorCheck`, `DoctorReport`, `PluginCliArgs`, `PluginCliCommand`, `PluginCliResult`, `PluginLogger`, and `FileSystemPort`; the protocol symbols `PluginScaffoldEntrypoint`, `ScaffolderContext`, and `ScaffoldResult`; and the scaffold symbols `ItemScaffolder`, `ScaffoldArtifact`, `ScaffoldArtifactBody`, `artifactText`, -`textArtifact`, `StubSource`, `TokenValues`, `defineStub`, and `substituteTokens`, documented in their owning -sections. +`textArtifact`, `StubSource`, `TokenValues`, `defineStub`, and `substituteTokens`, documented in +their owning sections. ## `@netscript/plugin/cli` -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `PluginCli` | class | `class PluginCli` | Abstract base class for plugin-owned CLI command groups. | -| `PluginRuntimeConfigCli` | class | `class PluginRuntimeConfigCli` | Abstract base for plugin runtime configuration commands. | -| `mountPluginCli` | function | `function mountPluginCli(clis)` | Mount plugin CLI command groups into a flat command list. | -| `runMountedCommand` | function | `async function runMountedCommand(commands, args: PluginCliArgs): Promise` | Run a mounted command list without depending on Cliffy at package level. | -| `routeVerb` | function | `async function routeVerb(commands, args: PluginCliArgs): Promise` | Route a command by verb name. | -| `formatPluginHelp` | function | `function formatPluginHelp(commands): string` | Format command help text for a mounted plugin CLI. | -| `isDoctorReportPassing` | function | `function isDoctorReportPassing(report: DoctorReport): boolean` | Return true when every doctor check is passing. | -| `PluginCliArgs` | interface | `interface PluginCliArgs` | Command arguments passed to plugin CLI handlers. | -| `PluginCliCommand` | interface | `interface PluginCliCommand` | A mounted CLI command handler. | -| `PluginCliResult` | interface | `interface PluginCliResult` | Result returned by plugin CLI handlers. | -| `DoctorCheck` | interface | `interface DoctorCheck` | Diagnostic entry produced by plugin doctor commands. | -| `DoctorReport` | interface | `interface DoctorReport` | Aggregate doctor report for a plugin CLI. | -| `LocalProjectFiles` | class | class | Deno-backed project file adapter for local plugin CLI execution. | -| `resolveProjectRoot` | function | function | Resolve a URL or path to a local project root. | -| `ProjectFileEntry` | interface | interface | File entry discovered by a plugin CLI filesystem scan. | -| `ProjectFiles` | interface | interface | Project file operations used by plugin CLI commands. | -| `renderRegistryModule` | function | function | Render a static-registry module from discovered items and plugin specifics. | -| `toRegistryImportSpecifier` | function | function | Resolve an item's import specifier relative to a generated registry. | -| `RegistryEmitItem` | interface | interface | Discovered registry item with its project-relative source path. | -| `RegistryModuleSpec` | interface | interface | Plugin-supplied details used to render a registry module. | -| `normalizePluginArgv` | function | function | Normalize raw argv tokens into positional values and simple long flags. | -| `parsePluginCliArgs` | function | function | Parse plugin command argv into the shared `PluginCliArgs` contract. | -| `NormalizedPluginArgv` | interface | interface | Normalized argv tokens after the caller removes its runtime wrapper. | -| `applyScaffoldPlan` | function | function | Plan scaffold files and persist them only for a real run. | -| `ScaffoldPlanResult` | interface | interface | Result of planning or applying a plugin-owned scaffold operation. | -| `createBaseMetaCommands` | function | function | Create the shared `status`, `health`, and `info` command set. | -| `PluginBaseMeta` | interface | interface | Data returned by the shared plugin metadata commands. | -| `findGeneratedProjectRoot` | function | function | Find a project root through a project file adapter. | -| `loadGeneratedProjectRegistry` | function | function | Load and validate a generated project registry export. | -| `DefinitionGuard` | type alias | type alias | Runtime guard for a generated definition value. | -| `GeneratedProjectRegistryOptions` | interface | interface | Options for loading a generated registry from a project. | +| Symbol | Kind | Signature | Description | +| --------------------------------- | ---------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------- | +| `PluginCli` | class | `class PluginCli` | Abstract base class for plugin-owned CLI command groups. | +| `PluginRuntimeConfigCli` | class | `class PluginRuntimeConfigCli` | Abstract base for plugin runtime configuration commands. | +| `mountPluginCli` | function | `function mountPluginCli(clis)` | Mount plugin CLI command groups into a flat command list. | +| `runMountedCommand` | function | `async function runMountedCommand(commands, args: PluginCliArgs): Promise` | Run a mounted command list without depending on Cliffy at package level. | +| `routeVerb` | function | `async function routeVerb(commands, args: PluginCliArgs): Promise` | Route a command by verb name. | +| `formatPluginHelp` | function | `function formatPluginHelp(commands): string` | Format command help text for a mounted plugin CLI. | +| `isDoctorReportPassing` | function | `function isDoctorReportPassing(report: DoctorReport): boolean` | Return true when every doctor check is passing. | +| `PluginCliArgs` | interface | `interface PluginCliArgs` | Command arguments passed to plugin CLI handlers. | +| `PluginCliCommand` | interface | `interface PluginCliCommand` | A mounted CLI command handler. | +| `PluginCliResult` | interface | `interface PluginCliResult` | Result returned by plugin CLI handlers. | +| `DoctorCheck` | interface | `interface DoctorCheck` | Diagnostic entry produced by plugin doctor commands. | +| `DoctorReport` | interface | `interface DoctorReport` | Aggregate doctor report for a plugin CLI. | +| `LocalProjectFiles` | class | class | Deno-backed project file adapter for local plugin CLI execution. | +| `resolveProjectRoot` | function | function | Resolve a URL or path to a local project root. | +| `ProjectFileEntry` | interface | interface | File entry discovered by a plugin CLI filesystem scan. | +| `ProjectFiles` | interface | interface | Project file operations used by plugin CLI commands. | +| `renderRegistryModule` | function | function | Render a static-registry module from discovered items and plugin specifics. | +| `toRegistryImportSpecifier` | function | function | Resolve an item's import specifier relative to a generated registry. | +| `RegistryEmitItem` | interface | interface | Discovered registry item with its project-relative source path. | +| `RegistryModuleSpec` | interface | interface | Plugin-supplied details used to render a registry module. | +| `normalizePluginArgv` | function | function | Normalize raw argv tokens into positional values and simple long flags. | +| `parsePluginCliArgs` | function | function | Parse plugin command argv into the shared `PluginCliArgs` contract. | +| `NormalizedPluginArgv` | interface | interface | Normalized argv tokens after the caller removes its runtime wrapper. | +| `applyScaffoldPlan` | function | function | Plan scaffold files and persist them only for a real run. | +| `ScaffoldPlanResult` | interface | interface | Result of planning or applying a plugin-owned scaffold operation. | +| `createBaseMetaCommands` | function | function | Create the shared `status`, `health`, and `info` command set. | +| `PluginBaseMeta` | interface | interface | Data returned by the shared plugin metadata commands. | +| `findGeneratedProjectRoot` | function | function | Find a project root through a project file adapter. | +| `loadGeneratedProjectRegistry` | function | function | Load and validate a generated project registry export. | +| `DefinitionGuard` | type alias | type alias | Runtime guard for a generated definition value. | +| `GeneratedProjectRegistryOptions` | interface | interface | Options for loading a generated registry from a project. | ## `@netscript/plugin/sdk` -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `runWalkerPipeline` | function | `async function runWalkerPipeline(options: RunWalkerPipelineOptions): Promise` | Run the plugin SDK discovery pipeline. | -| `startWalker` | function | `function startWalker(root: string): Promise` | Start a one-shot SDK walker with default alpha adapters. | -| `startWatcher` | function | `function startWatcher(): WatcherHandle` | Start a no-op alpha watcher for plugin SDK discovery. | -| `createSourceGraph` | function | `function createSourceGraph(files, contributions): SourceGraph` | Create a source graph snapshot from walked files and extracted contributions. | -| `createWatcherHandle` | function | `function createWatcherHandle(): WatcherHandle` | Create a no-op watcher handle for alpha SDK discovery. | -| `createInstrumentationBridge` | function | `function createInstrumentationBridge()` | Create a recording instrumentation bridge. | -| `createPluginContext` | function | `function createPluginContext(projectRoot: string): PluginContext` | Create a minimal plugin context for SDK runtime helpers. | -| `createPluginHostBootstrap` | function | `function createPluginHostBootstrap(plugins): PluginHostBootstrap` | Create a plugin host bootstrap snapshot from a validated composition; throws `PluginCompositionError`. | -| `runDoctorReport` | function | `function runDoctorReport(plugin: string, checks): DoctorReport` | Run plugin doctor checks and return an aggregate report. | -| `AstExtractor` | class | class | Extractor for exported plugin contribution builder call sites. | -| `FilesystemWalker` | class | class | Filesystem walker for plugin source discovery. | -| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | -| `ModuleManifestResolver` | class | class | Manifest resolver backed by dynamic imports. | -| `RegistryEmitter` | class | class | Registry emitter that writes one generated TypeScript module per contribution axis. | -| `EmitterPort` | interface | interface | Port for emitting generated plugin registry files. | -| `ExtractorPort` | interface | interface | Port for extracting plugin contributions from walked files. | -| `ManifestResolverPort` | interface | interface | Port for resolving a plugin manifest from a package or module specifier. | -| `WalkerPort` | interface | interface | Port for discovering plugin source files. | -| `WalkedFile` | interface | interface | File discovered by a plugin source walker. | -| `SourceGraph` | interface | interface | Source graph snapshot produced by discovery. | -| `RegistryEmission` | interface | interface | Output emitted by the registry emitter. | -| `ExtractedContribution` | interface | interface | Extracted contribution candidate from source. | -| `WatcherHandle` | interface | interface | Watcher handle returned by SDK watch presets. | -| `ModuleManifestResolverOptions` | interface | interface | Options for resolving manifests from importable module specifiers. | -| `RunWalkerPipelineOptions` | interface | interface | Options for running the SDK walker pipeline. | -| `InstrumentationBridge` | interface | interface | Bridge between plugin runtime and telemetry instrumentation. | -| `PluginHostBootstrap` | interface | interface | Result of bootstrapping plugin host state. | -| `PluginServiceContext` | interface | interface | Context supplied to a plugin service at runtime. | +| Symbol | Kind | Signature | Description | +| ------------------------------- | --------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | +| `runWalkerPipeline` | function | `async function runWalkerPipeline(options: RunWalkerPipelineOptions): Promise` | Run the plugin SDK discovery pipeline. | +| `startWalker` | function | `function startWalker(root: string): Promise` | Start a one-shot SDK walker with default alpha adapters. | +| `startWatcher` | function | `function startWatcher(): WatcherHandle` | Start a no-op alpha watcher for plugin SDK discovery. | +| `createSourceGraph` | function | `function createSourceGraph(files, contributions): SourceGraph` | Create a source graph snapshot from walked files and extracted contributions. | +| `createWatcherHandle` | function | `function createWatcherHandle(): WatcherHandle` | Create a no-op watcher handle for alpha SDK discovery. | +| `createInstrumentationBridge` | function | `function createInstrumentationBridge()` | Create a recording instrumentation bridge. | +| `createPluginContext` | function | `function createPluginContext(projectRoot: string): PluginContext` | Create a minimal plugin context for SDK runtime helpers. | +| `createPluginHostBootstrap` | function | `function createPluginHostBootstrap(plugins): PluginHostBootstrap` | Create a plugin host bootstrap snapshot from a validated composition; throws `PluginCompositionError`. | +| `runDoctorReport` | function | `function runDoctorReport(plugin: string, checks): DoctorReport` | Run plugin doctor checks and return an aggregate report. | +| `AstExtractor` | class | class | Extractor for exported plugin contribution builder call sites. | +| `FilesystemWalker` | class | class | Filesystem walker for plugin source discovery. | +| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | +| `ModuleManifestResolver` | class | class | Manifest resolver backed by dynamic imports. | +| `RegistryEmitter` | class | class | Registry emitter that writes one generated TypeScript module per contribution axis. | +| `EmitterPort` | interface | interface | Port for emitting generated plugin registry files. | +| `ExtractorPort` | interface | interface | Port for extracting plugin contributions from walked files. | +| `ManifestResolverPort` | interface | interface | Port for resolving a plugin manifest from a package or module specifier. | +| `WalkerPort` | interface | interface | Port for discovering plugin source files. | +| `WalkedFile` | interface | interface | File discovered by a plugin source walker. | +| `SourceGraph` | interface | interface | Source graph snapshot produced by discovery. | +| `RegistryEmission` | interface | interface | Output emitted by the registry emitter. | +| `ExtractedContribution` | interface | interface | Extracted contribution candidate from source. | +| `WatcherHandle` | interface | interface | Watcher handle returned by SDK watch presets. | +| `ModuleManifestResolverOptions` | interface | interface | Options for resolving manifests from importable module specifiers. | +| `RunWalkerPipelineOptions` | interface | interface | Options for running the SDK walker pipeline. | +| `InstrumentationBridge` | interface | interface | Bridge between plugin runtime and telemetry instrumentation. | +| `PluginHostBootstrap` | interface | interface | Result of bootstrapping plugin host state. | +| `PluginServiceContext` | interface | interface | Context supplied to a plugin service at runtime. | This entrypoint also re-exports `BackgroundProcessorContribution`, `ContractVersionContribution`, `DbSchemaContribution`, `E2eContribution`, `MigrationContribution`, `PluginContributions`, @@ -316,35 +316,35 @@ root/config surface, plus `DoctorCheck` and `DoctorReport` from the CLI surface. ## `@netscript/plugin/loader` -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createPluginLogger` | function | `function createPluginLogger(pluginName: string): PluginLogger` | Create a logger scoped to a plugin service process. | -| `PluginLogger` | interface | `interface PluginLogger` | Minimal logger shape supplied to plugin service contexts. | +| Symbol | Kind | Signature | Description | +| -------------------- | --------- | --------------------------------------------------------------- | --------------------------------------------------------- | +| `createPluginLogger` | function | `function createPluginLogger(pluginName: string): PluginLogger` | Create a logger scoped to a plugin service process. | +| `PluginLogger` | interface | `interface PluginLogger` | Minimal logger shape supplied to plugin service contexts. | ## `@netscript/plugin/protocol` -| Symbol | Kind | Description | -| --- | --- | --- | -| `parsePluginManifest` | function | Parse and validate a plugin manifest without executing plugin code. | -| `PLUGIN_MANIFEST_SCHEMA_VERSION` | const | Current published schema version for `scaffold.plugin.json`. | -| `PluginInstallerManifestSchema` | const | Validator for the published plugin installer manifest. | -| `PluginInstallerManifest` | interface | Published `scaffold.plugin.json` contract consumed by installers. | -| `PluginInstallerManifestSchemaIssue` | interface | Validation issue exposed by the installer manifest schema. | -| `PluginInstallerManifestValidator` | interface | Stable validation surface for the installer manifest schema. | -| `PluginManifestCapabilities` | interface | Capability summary statically declared by a plugin manifest. | -| `PluginManifestLinking` | interface | Declarative resource-linking contract for plugins. | -| `PluginManifestLinkingConsumers` | interface | Named host resources that consume a plugin producer. | -| `PluginManifestOfficialSource` | interface | Compatibility metadata for first-party source-copy discovery. | -| `PluginManifestParseError` | interface | Validation failure returned when a manifest cannot be parsed. | -| `PluginManifestParseIssue` | interface | One validation issue returned by manifest parsing. | -| `PluginManifestParseResult` | type alias | Result returned by static plugin manifest parsing. | -| `PluginManifestPostScript` | interface | Script export executed after a plugin-owned scaffold succeeds. | -| `PluginManifestProvider` | interface | Compatibility metadata for plugin-kind provider registration. | -| `PluginManifestScaffolder` | interface | Plugin-owned scaffold entrypoint declared by the manifest. | -| `PluginScaffolderRequiredPermissions` | interface | Deno permissions required by a plugin-owned scaffolder. | -| `PluginScaffoldEntrypoint` | type alias | Signature implemented by plugin-owned `./scaffold` exports. | -| `ScaffolderContext` | interface | Context supplied by an installer to a plugin-owned scaffolder. | -| `ScaffoldResult` | interface | Result returned by a plugin-owned scaffolder. | +| Symbol | Kind | Description | +| ------------------------------------- | ---------- | ------------------------------------------------------------------- | +| `parsePluginManifest` | function | Parse and validate a plugin manifest without executing plugin code. | +| `PLUGIN_MANIFEST_SCHEMA_VERSION` | const | Current published schema version for `scaffold.plugin.json`. | +| `PluginInstallerManifestSchema` | const | Validator for the published plugin installer manifest. | +| `PluginInstallerManifest` | interface | Published `scaffold.plugin.json` contract consumed by installers. | +| `PluginInstallerManifestSchemaIssue` | interface | Validation issue exposed by the installer manifest schema. | +| `PluginInstallerManifestValidator` | interface | Stable validation surface for the installer manifest schema. | +| `PluginManifestCapabilities` | interface | Capability summary statically declared by a plugin manifest. | +| `PluginManifestLinking` | interface | Declarative resource-linking contract for plugins. | +| `PluginManifestLinkingConsumers` | interface | Named host resources that consume a plugin producer. | +| `PluginManifestOfficialSource` | interface | Compatibility metadata for first-party source-copy discovery. | +| `PluginManifestParseError` | interface | Validation failure returned when a manifest cannot be parsed. | +| `PluginManifestParseIssue` | interface | One validation issue returned by manifest parsing. | +| `PluginManifestParseResult` | type alias | Result returned by static plugin manifest parsing. | +| `PluginManifestPostScript` | interface | Script export executed after a plugin-owned scaffold succeeds. | +| `PluginManifestProvider` | interface | Compatibility metadata for plugin-kind provider registration. | +| `PluginManifestScaffolder` | interface | Plugin-owned scaffold entrypoint declared by the manifest. | +| `PluginScaffolderRequiredPermissions` | interface | Deno permissions required by a plugin-owned scaffolder. | +| `PluginScaffoldEntrypoint` | type alias | Signature implemented by plugin-owned `./scaffold` exports. | +| `ScaffolderContext` | interface | Context supplied by an installer to a plugin-owned scaffolder. | +| `ScaffoldResult` | interface | Result returned by a plugin-owned scaffolder. | This entrypoint also re-exports the root `PluginLogger` type. @@ -371,16 +371,16 @@ This entrypoint also re-exports the root `PluginLogger` type. ## `@netscript/plugin/testing` -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createPluginManifestFixture` | function | `function createPluginManifestFixture(overrides?): PluginManifest` | Example plugin manifest fixture. | -| `createWalkedFileFixture` | function | `function createWalkedFileFixture(overrides?): WalkedFile` | Example walked file fixture. | -| `runPluginCliContract` | function | `function runPluginCliContract(cli: PluginCli): boolean` | Run the shared plugin CLI contract against a CLI instance. | -| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | -| `MemoryWalker` | class | class | In-memory walker for plugin source discovery. | -| `MemoryEmitter` | class | class | In-memory registry emitter for plugin tests. | -| `MemoryFileSystemAdapter` | class | class | In-memory file system adapter for plugin tests. | -| `FileSystemPort` | interface | interface | Minimal file system port used by plugin scaffolding. | +| Symbol | Kind | Signature | Description | +| ----------------------------- | --------- | ------------------------------------------------------------------ | -------------------------------------------------------------- | +| `createPluginManifestFixture` | function | `function createPluginManifestFixture(overrides?): PluginManifest` | Example plugin manifest fixture. | +| `createWalkedFileFixture` | function | `function createWalkedFileFixture(overrides?): WalkedFile` | Example walked file fixture. | +| `runPluginCliContract` | function | `function runPluginCliContract(cli: PluginCli): boolean` | Run the shared plugin CLI contract against a CLI instance. | +| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | +| `MemoryWalker` | class | class | In-memory walker for plugin source discovery. | +| `MemoryEmitter` | class | class | In-memory registry emitter for plugin tests. | +| `MemoryFileSystemAdapter` | class | class | In-memory file system adapter for plugin tests. | +| `FileSystemPort` | interface | interface | Minimal file system port used by plugin scaffolding. | This entrypoint also re-exports the root/config symbols `BackgroundProcessorContribution`, `ContractVersionContribution`, `DbSchemaContribution`, `E2eContribution`, `MigrationContribution`, @@ -393,27 +393,27 @@ This entrypoint also re-exports the root/config symbols `BackgroundProcessorCont ## `@netscript/plugin/templates` -| Symbol | Kind | Description | -| --- | --- | --- | -| `PLUGIN_SKELETON_TEMPLATE_CONTENT` | const | Embedded text for every default plugin skeleton template asset. | -| `PLUGIN_SKELETON_TEMPLATES` | const | Paths for plugin skeleton template assets. | -| `PluginSkeletonTemplatePath` | type alias | Plugin skeleton template path. | +| Symbol | Kind | Description | +| ---------------------------------- | ---------- | --------------------------------------------------------------- | +| `PLUGIN_SKELETON_TEMPLATE_CONTENT` | const | Embedded text for every default plugin skeleton template asset. | +| `PLUGIN_SKELETON_TEMPLATES` | const | Paths for plugin skeleton template assets. | +| `PluginSkeletonTemplatePath` | type alias | Plugin skeleton template path. | ## `@netscript/plugin/contract-base` -| Symbol | Kind | Description | -| --- | --- | --- | -| `BASE_PLUGIN_ERRORS` | const | Base oRPC error-map fragment shared by plugin contracts. | -| `BasePluginErrorCode` | type alias | Literal error codes guaranteed by `BASE_PLUGIN_ERRORS`. | -| `BasePluginErrorDefinition` | interface | One entry in a plugin contract's oRPC error map. | -| `InternalErrorData` | interface | Error payload reported for unexpected internal failures. | -| `PluginCapabilities` | interface | Marketplace-discoverable description of a running plugin. | -| `PluginCapabilitiesSchema` | const | Output schema for the mandatory plugin `describe` route. | -| `PluginCapabilitiesValidator` | interface | Structural validator for plugin capability documents. | -| `BASE_PLUGIN_CONTRACT_ROUTES` | const | Mandatory route fragment shared by feature plugin contracts. | -| `BasePluginContract` | interface | Minimum route surface every plugin contract must satisfy. | -| `BasePluginDescribeProcedure` | type alias | Mandatory `describe` procedure shape for plugin contracts. | -| `BasePluginDescribeRoute` | type alias | Explicit type of the base contract's `describe` route. | +| Symbol | Kind | Description | +| ----------------------------- | ---------- | ------------------------------------------------------------ | +| `BASE_PLUGIN_ERRORS` | const | Base oRPC error-map fragment shared by plugin contracts. | +| `BasePluginErrorCode` | type alias | Literal error codes guaranteed by `BASE_PLUGIN_ERRORS`. | +| `BasePluginErrorDefinition` | interface | One entry in a plugin contract's oRPC error map. | +| `InternalErrorData` | interface | Error payload reported for unexpected internal failures. | +| `PluginCapabilities` | interface | Marketplace-discoverable description of a running plugin. | +| `PluginCapabilitiesSchema` | const | Output schema for the mandatory plugin `describe` route. | +| `PluginCapabilitiesValidator` | interface | Structural validator for plugin capability documents. | +| `BASE_PLUGIN_CONTRACT_ROUTES` | const | Mandatory route fragment shared by feature plugin contracts. | +| `BasePluginContract` | interface | Minimum route surface every plugin contract must satisfy. | +| `BasePluginDescribeProcedure` | type alias | Mandatory `describe` procedure shape for plugin contracts. | +| `BasePluginDescribeRoute` | type alias | Explicit type of the base contract's `describe` route. | ## `@netscript/plugin/service` @@ -462,22 +462,23 @@ default; the factory does not merge another policy into it. ## `@netscript/plugin/health` -| Symbol | Kind | Description | -| --- | --- | --- | -| `ChildHealthState` | type alias | Closed child state vocabulary: starting, ready, degraded, crash-looping, stopped, failed. | -| `ChildHealthSnapshot` | type alias | State, registry/dependency readiness, restart count, and redacted fatal incident. | -| `ChildFatalError` | type alias | Fixed redacted message and epoch-millisecond capture timestamp. | -| `CHILD_CRASH_LOOP_THRESHOLD` | const | Three restarts in 60 seconds; recovery requires a clean running minute. | -| `summarizePluginHealth` | function | Shared cross-plugin precedence: unhealthy, degraded, unknown, then healthy; an empty set is unknown. | -| `aggregatePluginHealth` | function | Shared API/child aggregation: healthy, degraded, unhealthy, or unknown; missing children cannot be green. | -| `PluginHealthSummary` | interface | Plugin identity, declared names, per-resource states, and one canonical verdict. | -| `ChildHealthMonitor` | class | Tracks readiness and bounded restart history with an injectable clock. | -| `childHealthResponse` | function | Returns HTTP 200 only for ready with both readiness checks complete; otherwise 503. | -| `runChildHealthProcess` | function | Starts health before bootstrap; fatal errors log and exit nonzero after a one-second red health grace. | +| Symbol | Kind | Description | +| ---------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------- | +| `ChildHealthState` | type alias | Closed child state vocabulary: starting, ready, degraded, crash-looping, stopped, failed. | +| `ChildHealthSnapshot` | type alias | State, registry/dependency readiness, restart count, and redacted fatal incident. | +| `ChildFatalError` | type alias | Fixed redacted message and epoch-millisecond capture timestamp. | +| `CHILD_CRASH_LOOP_THRESHOLD` | const | Three restarts in 60 seconds; recovery requires a clean running minute. | +| `summarizePluginHealth` | function | Shared cross-plugin precedence: unhealthy, degraded, unknown, then healthy; an empty set is unknown. | +| `aggregatePluginHealth` | function | Shared API/child aggregation: healthy, degraded, unhealthy, or unknown; missing children cannot be green. | +| `PluginHealthSummary` | interface | Plugin identity, declared names, per-resource states, and one canonical verdict. | +| `ChildHealthMonitor` | class | Tracks readiness and bounded restart history with an injectable clock. | +| `childHealthResponse` | function | Returns HTTP 200 only for ready with both readiness checks complete; otherwise 503. | +| `runChildHealthProcess` | function | Starts loopback health before bootstrap; drains owned resources and exits 0 clean, 1 failed or 2 timed out. | Workers, triggers, and sagas runtime entrypoints also re-export the shared health types. The child health payload is bounded and excludes raw exception messages and stacks. Dependency readiness -records startup checks and listener failures. Generated AppHost probes and doctor/MCP aggregation consume the same child contract. +records startup checks and listener failures. Generated AppHost probes and doctor/MCP aggregation +consume the same child contract. Registry readiness records loaded and validated definitions; runtime registration belongs to dependency readiness. Crash-loop recovery requires a full 60 seconds of uninterrupted running with diff --git a/docs/site/reference/service/index.md b/docs/site/reference/service/index.md index bcd001bff7..5af0f81697 100644 --- a/docs/site/reference/service/index.md +++ b/docs/site/reference/service/index.md @@ -1,6 +1,6 @@ --- layout: layouts/base.vto -title: "@netscript/service" +title: '@netscript/service' --- # `@netscript/service` @@ -11,16 +11,16 @@ authentication and command execution. ## Sub-path exports -| Export | Entrypoint | Purpose | -| --- | --- | --- | -| `@netscript/service` | `./mod.ts` | Full service surface: [builder and presets](#builder-and-presets), [health](#health-primitives), [handlers](#rpc-openapi-and-docs-handlers), [limits](#request-body-limit) and types. | -| `@netscript/service/auth` | `./src/auth/mod.ts` | [Service authentication and authorization handlers](#netscriptserviceauth-surface). | -| `@netscript/service/rate-limit` | `./src/rate-limit/mod.ts` | [Route quotas, atomic stores, and trusted client-address resolution](#rate-limits-and-client-addresses). | -| `@netscript/service/rpc-path` | `./src/primitives/rpc-path.ts` | Type-safe RPC route mapping utilities. | -| `@netscript/service/internal-credential` | `./src/auth/internal-credential/mod.ts` | [Dependency-free installation secret loading and internal credential derivation](#internal-procedures-and-the-internal-service-credential). | -| `@netscript/service/commands` | `./commands.ts` | [Opaque command definitions, once-only executor and codecs](#command-definitions-and-codecs). | -| `@netscript/service/commands/relay` | `./commands-relay.ts` | [Decoded bounded relay and checked sink lifecycle](#command-outbox-relay). | -| `@netscript/service/commands/testing` | `./commands-testing.ts` | [Atomic memory store and explicit test controls](#command-testing). | +| Export | Entrypoint | Purpose | +| ---------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `@netscript/service` | `./mod.ts` | Full service surface: [builder and presets](#builder-and-presets), [health](#health-primitives), [handlers](#rpc-openapi-and-docs-handlers), [limits](#request-body-limit) and types. | +| `@netscript/service/auth` | `./src/auth/mod.ts` | [Service authentication and authorization handlers](#netscriptserviceauth-surface). | +| `@netscript/service/rate-limit` | `./src/rate-limit/mod.ts` | [Route quotas, atomic stores, and trusted client-address resolution](#rate-limits-and-client-addresses). | +| `@netscript/service/rpc-path` | `./src/primitives/rpc-path.ts` | Type-safe RPC route mapping utilities. | +| `@netscript/service/internal-credential` | `./src/auth/internal-credential/mod.ts` | [Dependency-free installation secret loading and internal credential derivation](#internal-procedures-and-the-internal-service-credential). | +| `@netscript/service/commands` | `./commands.ts` | [Opaque command definitions, once-only executor and codecs](#command-definitions-and-codecs). | +| `@netscript/service/commands/relay` | `./commands-relay.ts` | [Decoded bounded relay and checked sink lifecycle](#command-outbox-relay). | +| `@netscript/service/commands/testing` | `./commands-testing.ts` | [Atomic memory store and explicit test controls](#command-testing). | The package has three layers: @@ -40,57 +40,57 @@ describe a service surface; the runtime still uses the real Hono app and oRPC ha ## Builder and presets -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createService` | function | `function createService(router: T, config: ServiceConfig): ServiceBuilder` | Factory function to create a new service builder. | +| Symbol | Kind | Signature | Description | +| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | +| `createService` | function | `function createService(router: T, config: ServiceConfig): ServiceBuilder` | Factory function to create a new service builder. | | `defineService` | function | `async function defineService(router: T, options: DefineServiceOptions): Promise` | One-liner preset for creating a fully-configured service. | ## Health primitives -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createHealthHandler` | function | `function createHealthHandler(options?: HealthHandlerOptions): ServiceHandler` | Creates a comprehensive health check handler that runs all checks in parallel. | -| `createLivenessHandler` | function | `function createLivenessHandler(): ServiceHandler` | Creates a simple liveness check handler. | -| `createReadinessHandler` | function | `function createReadinessHandler(checks: Array<() => Promise>): ServiceHandler` | Creates a readiness check handler that runs multiple async checks. | -| `healthChecks` | const | `const healthChecks: { database; kv; service; custom }` | Pre-built health checks for common dependencies (`database`, `kv`, `service`, `custom`). | -| `HEALTH_STATUS` | const | `const HEALTH_STATUS: { healthy; degraded; unhealthy }` | Health status values emitted by service health handlers. | +| Symbol | Kind | Signature | Description | +| ------------------------ | -------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | +| `createHealthHandler` | function | `function createHealthHandler(options?: HealthHandlerOptions): ServiceHandler` | Creates a comprehensive health check handler that runs all checks in parallel. | +| `createLivenessHandler` | function | `function createLivenessHandler(): ServiceHandler` | Creates a simple liveness check handler. | +| `createReadinessHandler` | function | `function createReadinessHandler(checks: Array<() => Promise>): ServiceHandler` | Creates a readiness check handler that runs multiple async checks. | +| `healthChecks` | const | `const healthChecks: { database; kv; service; custom }` | Pre-built health checks for common dependencies (`database`, `kv`, `service`, `custom`). | +| `HEALTH_STATUS` | const | `const HEALTH_STATUS: { healthy; degraded; unhealthy }` | Health status values emitted by service health handlers. | ## RPC, OpenAPI, and docs handlers -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createRPCHandler` | function | `function createRPCHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC RPC handler for type-safe client communication. | -| `createRPCPlugins` | function | `function createRPCPlugins(config: RPCHandlerConfig): ServiceHandlerPlugin[]` | Creates the standard set of oRPC plugins. | -| `createOpenAPIHandler` | function | `function createOpenAPIHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC OpenAPI handler for REST-style API access. | -| `createOpenAPISpec` | function | `function createOpenAPISpec(router: T, config: OpenAPIConfig): ServiceHandler` | Creates an OpenAPI specification endpoint handler. | -| `createScalarDocs` | function | `function createScalarDocs(options: ScalarDocsOptions): ServiceHandler` | Creates a Scalar API documentation UI handler. | -| `createScalarJs` | function | `function createScalarJs(): ServiceHandler` | Creates a handler to serve the bundled Scalar JS file. | +| Symbol | Kind | Signature | Description | +| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | +| `createRPCHandler` | function | `function createRPCHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC RPC handler for type-safe client communication. | +| `createRPCPlugins` | function | `function createRPCPlugins(config: RPCHandlerConfig): ServiceHandlerPlugin[]` | Creates the standard set of oRPC plugins. | +| `createOpenAPIHandler` | function | `function createOpenAPIHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC OpenAPI handler for REST-style API access. | +| `createOpenAPISpec` | function | `function createOpenAPISpec(router: T, config: OpenAPIConfig): ServiceHandler` | Creates an OpenAPI specification endpoint handler. | +| `createScalarDocs` | function | `function createScalarDocs(options: ScalarDocsOptions): ServiceHandler` | Creates a Scalar API documentation UI handler. | +| `createScalarJs` | function | `function createScalarJs(): ServiceHandler` | Creates a handler to serve the bundled Scalar JS file. | When a procedure declares `NetScriptProcedureMeta.access`, `createOpenAPISpec()` preserves the operation and projects access as follows: -| Contract declaration | OpenAPI operation | -| --- | --- | -| `authentication: 'none'` | `security: []` | -| `authentication: 'required'` | `security: [{ bearerAuth: scopes }]` | -| Required `authorization.roles` | `x-netscript-roles: roles` | -| `authentication: 'optional'` | `security: [{}, { bearerAuth: [] }]` | -| No authentication declaration | No generated operation-level `security` field | +| Contract declaration | OpenAPI operation | +| ------------------------------ | --------------------------------------------- | +| `authentication: 'none'` | `security: []` | +| `authentication: 'required'` | `security: [{ bearerAuth: scopes }]` | +| Required `authorization.roles` | `x-netscript-roles: roles` | +| `authentication: 'optional'` | `security: [{}, { bearerAuth: [] }]` | +| No authentication declaration | No generated operation-level `security` field | The generated `bearerAuth` component uses HTTP bearer authentication. Optional access stays visible in the generated specification even though the contract authorizer rejects it at construction. ## Request-body limit -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | +| Symbol | Kind | Signature | Description | +| --------------------------- | -------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `createBodyLimitMiddleware` | function | `function createBodyLimitMiddleware(options: ServiceBodyLimitOptions): ServiceMiddleware` | Creates middleware that rejects request bodies larger than `maxBytes` with a typed JSON `413` before any handler parses them. Throws `RangeError` unless `maxBytes` is a positive safe integer. | -| `PAYLOAD_TOO_LARGE_ERROR` | const | `const PAYLOAD_TOO_LARGE_ERROR: 'PAYLOAD_TOO_LARGE'` | Error code carried by the JSON body of a `413` body-limit rejection. | +| `PAYLOAD_TOO_LARGE_ERROR` | const | `const PAYLOAD_TOO_LARGE_ERROR: 'PAYLOAD_TOO_LARGE'` | Error code carried by the JSON body of a `413` body-limit rejection. | The builder form is `createService(...).withBodyLimit({ maxBytes })` and the preset form is `defineService(router, { bodyLimit: { maxBytes } })`. A request that declares `Content-Length` is -rejected from the header. A chunked request is counted as it streams and rejected once it passes -the limit, so at most `maxBytes` plus one chunk is buffered. The rejection body is a +rejected from the header. A chunked request is counted as it streams and rejected once it passes the +limit, so at most `maxBytes` plus one chunk is buffered. The rejection body is a `PayloadTooLargeResponse`: `{ error: 'PAYLOAD_TOO_LARGE', message, maxBytes }`. There is no read timeout. @@ -98,16 +98,16 @@ timeout. `defineService` and a builder chain installed in the same order produce this request pipeline: -| Order | Stage | Installed by | -| --- | --- | --- | -| 1 | Tracing | always, at construction | -| 2 | CORS | `withCors()` | -| 3 | Request logging | `withLogger()` | -| 4 | Caller middleware, in order | `use()` / `DefineServiceOptions.middleware` | -| 5 | Authentication, then authorization | `withAuthn()` / `withAuthz()`, installed by `build()` | -| 6 | Request-body limit | `withBodyLimit()` / `DefineServiceOptions.bodyLimit`, installed by `build()` | -| 7 | Health, liveness and readiness routes | `withHealth()`, installed by `build()` | -| 8 | OpenAPI spec, docs, RPC and OpenAPI projections, custom routes | `build()` | +| Order | Stage | Installed by | +| ----- | -------------------------------------------------------------- | ---------------------------------------------------------------------------- | +| 1 | Tracing | always, at construction | +| 2 | CORS | `withCors()` | +| 3 | Request logging | `withLogger()` | +| 4 | Caller middleware, in order | `use()` / `DefineServiceOptions.middleware` | +| 5 | Authentication, then authorization | `withAuthn()` / `withAuthz()`, installed by `build()` | +| 6 | Request-body limit | `withBodyLimit()` / `DefineServiceOptions.bodyLimit`, installed by `build()` | +| 7 | Health, liveness and readiness routes | `withHealth()`, installed by `build()` | +| 8 | OpenAPI spec, docs, RPC and OpenAPI projections, custom routes | `build()` | `use()` registers middleware immediately, so builder middleware runs in call order relative to `withCors()` and `withLogger()`. It always runs before the stages that `build()` installs. A @@ -117,33 +117,33 @@ rejection returned at stage 4 or 6 keeps the CORS headers and is logged. `createService(...).withRateLimit(options)` adds middleware through `use()`. It runs in call order, before deferred health routes and both RPC/REST projections, including when added after -`withHealth()`. Install it before `withServiceInfo()` if the immediate service-info route should -be limited. Repeated calls add stages. Configure health checks before building. +`withHealth()`. Install it before `withServiceInfo()` if the immediate service-info route should be +limited. Repeated calls add stages. Configure health checks before building. The root also exports `ServiceRateLimitOptions`, `ServiceProxyTrust`, `RateLimitStore`, `RateLimitRequest`, and `RateLimitDecision` for builder/port contracts. The `@netscript/service/rate-limit` subpath exposes: -| Symbol | Kind | Description | -| --- | --- | --- | -| `createRateLimitMiddleware` | function | Creates route-scoped quota middleware returning JSON 429 and whole-second Retry-After. | -| `createKvRateLimitStore` | function | Uses KV atomic compare-and-set plus TTL in a dedicated prefix, with a bounded retry budget. | -| `createMemoryRateLimitStore` | function | Creates a synchronous, capped development store with bounded TTL eviction. | -| `resolveServiceClientAddress` | function | Resolves the socket peer or explicitly trusted XFF hops, walking right to left. | -| `ServiceRateLimitOptions` | interface | `routes`, `limit`, `windowMs`, `store`, and optional `key`, `trustProxy`, `ipv6Prefix`, `now`. | -| `ServiceProxyTrust` | type alias | `false` or an address predicate identifying trusted proxy hops; default off. | -| `RateLimitStore` | interface | Port reserving one slot atomically with `consume(request)`. | -| `RateLimitRequest` | interface | Key, quota, window, epoch milliseconds, and optional request cancellation signal. | -| `RateLimitDecision` | interface | Whether a slot was reserved and the epoch-millisecond window end. | -| `KvRateLimitStoreOptions` | interface | Dedicated `prefix` and optional `maxAttempts` (default 8, maximum 32). | -| `MemoryRateLimitStoreOptions` | interface | Optional retained-key cap `maxKeys` (default 10,000). | +| Symbol | Kind | Description | +| ----------------------------- | ---------- | ---------------------------------------------------------------------------------------------- | +| `createRateLimitMiddleware` | function | Creates route-scoped quota middleware returning JSON 429 and whole-second Retry-After. | +| `createKvRateLimitStore` | function | Uses KV atomic compare-and-set plus TTL in a dedicated prefix, with a bounded retry budget. | +| `createMemoryRateLimitStore` | function | Creates a synchronous, capped development store with bounded TTL eviction. | +| `resolveServiceClientAddress` | function | Resolves the socket peer or explicitly trusted XFF hops, walking right to left. | +| `ServiceRateLimitOptions` | interface | `routes`, `limit`, `windowMs`, `store`, and optional `key`, `trustProxy`, `ipv6Prefix`, `now`. | +| `ServiceProxyTrust` | type alias | `false` or an address predicate identifying trusted proxy hops; default off. | +| `RateLimitStore` | interface | Port reserving one slot atomically with `consume(request)`. | +| `RateLimitRequest` | interface | Key, quota, window, epoch milliseconds, and optional request cancellation signal. | +| `RateLimitDecision` | interface | Whether a slot was reserved and the epoch-millisecond window end. | +| `KvRateLimitStoreOptions` | interface | Dedicated `prefix` and optional `maxAttempts` (default 8, maximum 32). | +| `MemoryRateLimitStoreOptions` | interface | Optional retained-key cap `maxKeys` (default 10,000). | The subpath also re-exports the first-party integration types `ServiceContext`, `ServiceEnvironment`, `ServiceMiddleware`, `KvStore`, `KvKey`, `KvEntry`, `KvListOptions`, -`KvSetOptions`, `AtomicCheck`, `AtomicMutation`, and `AtomicResult` used by these signatures. -The `KvStore` port references the six KV types through its public methods, so they are re-exported -with it rather than duplicated. +`KvSetOptions`, `AtomicCheck`, `AtomicMutation`, and `AtomicResult` used by these signatures. The +`KvStore` port references the six KV types through its public methods, so they are re-exported with +it rather than duplicated. Selected routes share one quota per key and epoch-aligned window. Paths are exact or end in `/*` for a subtree (including its root). Rejections return `{ error: 'RATE_LIMITED' }` with `429` and @@ -154,12 +154,12 @@ retry exhaustion or memory capacity pressure rejects conservatively; store failu `ServiceEnvironment` is exported from the root entrypoint. `ServiceApp.fetch(request, env)` and `ServiceApp.request(input, init, env)` accept it. The listener supplies `remoteAddr` on plain and TLS requests so Hono's Deno `getConnInfo` works. The default limiter key is the resolved client -address; IPv6 keys are canonicalized and grouped by /64, with `ipv6Prefix` (0–128) selecting -another prefix. IPv4-mapped IPv6 peers use their corresponding dotted IPv4 bucket before prefix -masking, so distinct IPv4 clients retain independent quotas on dual-stack listeners. Native IPv4 -and custom keys stay unchanged. This grouping affects quota keys only, not -socket metadata or proxy trust. A mounted app without metadata uses a shared `unknown` bucket and -logs a warning once per stage through the request logger or service package logger. +address; IPv6 keys are canonicalized and grouped by /64, with `ipv6Prefix` (0–128) selecting another +prefix. IPv4-mapped IPv6 peers use their corresponding dotted IPv4 bucket before prefix masking, so +distinct IPv4 clients retain independent quotas on dual-stack listeners. Native IPv4 and custom keys +stay unchanged. This grouping affects quota keys only, not socket metadata or proxy trust. A mounted +app without metadata uses a shared `unknown` bucket and logs a warning once per stage through the +request logger or service package logger. > [!CAUTION] > KV counter TTL bounds each key's lifetime, not total live cardinality. Distinct attacker-chosen @@ -176,51 +176,51 @@ examples and storage/performance guarantees. ## Error and routing handlers -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createErrorHandler` | function | `function createErrorHandler(serviceName: string): ServiceErrorHandler` | Creates a global error handler for uncaught exceptions. | -| `createNotFoundHandler` | function | `function createNotFoundHandler(serviceName: string): ServiceHandler` | Creates a 404 Not Found handler for unmatched routes. | +| Symbol | Kind | Signature | Description | +| ----------------------- | -------- | ----------------------------------------------------------------------- | ------------------------------------------------------- | +| `createErrorHandler` | function | `function createErrorHandler(serviceName: string): ServiceErrorHandler` | Creates a global error handler for uncaught exceptions. | +| `createNotFoundHandler` | function | `function createNotFoundHandler(serviceName: string): ServiceHandler` | Creates a 404 Not Found handler for unmatched routes. | ## Configuration and option types -| Symbol | Kind | Description | -| --- | --- | --- | -| `ServiceConfig` | interface | Service configuration options (input to `createService`). | -| `DefineServiceOptions` | interface | Options for the `defineService` preset, including `cors` (explicit origins or the `NETSCRIPT_CORS_ORIGINS` workspace allowlist), `middleware` (caller middleware after CORS and logging, before auth) and the opt-in `bodyLimit`. | -| `ServiceBodyLimitOptions` | interface | `{ maxBytes }` request-body limit accepted by `withBodyLimit()` and `DefineServiceOptions.bodyLimit`. | -| `PayloadTooLargeResponse` | interface | JSON body of a `413` body-limit rejection: `{ error: 'PAYLOAD_TOO_LARGE', message, maxBytes }`. | -| `ServeOptions` | interface | Options for starting a service listener. | -| `CorsOptions` | interface | CORS options supported by `withCors()`. Omitted `origin` reads comma-separated exact HTTP(S) origins from `NETSCRIPT_CORS_ORIGINS`; unset/blank denies cross-origin access. Explicit origins override the environment; wildcard with credentials fails `build()`. | -| `OpenAPIConfig` | interface | Configuration for OpenAPI spec generation. | -| `RPCHandlerConfig` | interface | Configuration options for RPC handlers. | -| `ScalarDocsOptions` | interface | Configuration for the Scalar docs UI. | -| `HealthHandlerOptions` | interface | Options for `createHealthHandler`. | -| `LoggerMiddlewareOptions` | interface | Options for the logger middleware (re-exported from `@netscript/logger/middleware`). | +| Symbol | Kind | Description | +| ------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ServiceConfig` | interface | Service configuration options (input to `createService`). | +| `DefineServiceOptions` | interface | Options for the `defineService` preset, including `cors` (explicit origins or the `NETSCRIPT_CORS_ORIGINS` workspace allowlist), `middleware` (caller middleware after CORS and logging, before auth) and the opt-in `bodyLimit`. | +| `ServiceBodyLimitOptions` | interface | `{ maxBytes }` request-body limit accepted by `withBodyLimit()` and `DefineServiceOptions.bodyLimit`. | +| `PayloadTooLargeResponse` | interface | JSON body of a `413` body-limit rejection: `{ error: 'PAYLOAD_TOO_LARGE', message, maxBytes }`. | +| `ServeOptions` | interface | Options for starting a service listener. | +| `CorsOptions` | interface | CORS options supported by `withCors()`. Omitted `origin` reads comma-separated exact HTTP(S) origins from `NETSCRIPT_CORS_ORIGINS`; unset/blank denies cross-origin access. Explicit origins override the environment; wildcard with credentials fails `build()`. | +| `OpenAPIConfig` | interface | Configuration for OpenAPI spec generation. | +| `RPCHandlerConfig` | interface | Configuration options for RPC handlers. | +| `ScalarDocsOptions` | interface | Configuration for the Scalar docs UI. | +| `HealthHandlerOptions` | interface | Options for `createHealthHandler`. | +| `LoggerMiddlewareOptions` | interface | Options for the logger middleware (re-exported from `@netscript/logger/middleware`). | ### CORS origins -`DefineServiceOptions.cors` configures the same policy as `withCors()`. If `origin` is omitted, -the builder snapshots `NETSCRIPT_CORS_ORIGINS`: comma-separated exact HTTP(S) origins, without -paths or trailing slashes. Unset or blank means no cross-origin browser access. For example, -`NETSCRIPT_CORS_ORIGINS='https://app.example,https://admin.example'` permits those two origins. -An explicit `cors: { origin: ['https://app.example'] }` overrides the environment; `origin: []` -denies all cross-origin access. Invalid environment entries fail configuration. Wildcard origins -with `credentials: true` fail before the listener starts. +`DefineServiceOptions.cors` configures the same policy as `withCors()`. If `origin` is omitted, the +builder snapshots `NETSCRIPT_CORS_ORIGINS`: comma-separated exact HTTP(S) origins, without paths or +trailing slashes. Unset or blank means no cross-origin browser access. For example, +`NETSCRIPT_CORS_ORIGINS='https://app.example,https://admin.example'` permits those two origins. An +explicit `cors: { origin: ['https://app.example'] }` overrides the environment; `origin: []` denies +all cross-origin access. Invalid environment entries fail configuration. Wildcard origins with +`credentials: true` fail before the listener starts. Generated CLI/Aspire helpers supply the enabled web apps' allocated HTTP endpoint origins to every service and plugin service resource. This generated value overrides a declared resource environment value; a workspace without enabled web apps supplies an empty allowlist. Independent services must configure their launch environment themselves. Origins outside the allowlist receive no -`Access-Control-Allow-Origin` header. CORS controls browser response access; it does not authenticate -callers. +`Access-Control-Allow-Origin` header. CORS controls browser response access; it does not +authenticate callers. ### Listener bind address `ServeOptions.hostname` and `DefineServiceOptions.hostname` choose the interface the listener binds. The value is forwarded unchanged to `Deno.serve` on both the plain and the TLS listener, and -`RunningService.addr.hostname` reports the address that was bound. Omitting it keeps Deno's -default, so the listener binds every IPv4 interface (`0.0.0.0`). Pass `'127.0.0.1'` to keep an -endpoint, such as an unauthenticated local control surface, reachable only from the same machine. +`RunningService.addr.hostname` reports the address that was bound. Omitting it keeps Deno's default, +so the listener binds every IPv4 interface (`0.0.0.0`). Pass `'127.0.0.1'` to keep an endpoint, such +as an unauthenticated local control surface, reachable only from the same machine. ```ts import { createService } from '@netscript/service'; @@ -237,42 +237,56 @@ Generated service scaffolds leave `hostname` unset. Inside a container, a loopba the service unreachable through its published ports, so narrow the bind per service, where you know who must reach it. +### Shutdown and process ownership + +OS-signal shutdown through `serve()` exits with `0` after a clean drain, `1` after a runtime or +cleanup failure, and `2` after a deadline. `drainTimeoutMs` defaults to `30_000` ms total, including +`min(5_000, drainTimeoutMs / 5)` reserved for resource cleanup. At defaults this is 25 seconds of +work drain and five seconds of cleanup; `cleanupTimeoutMs` adjusts that reservation within the same +total. `onCleanup` callbacks are attempted even if a work-drain hook times out. + +The process edge calls `closeKv()` and disconnects each already-acquired database identity +registered by `withDatabase()` once. If an explicit host cleanup already owns the database, set +`disposeDatabaseOnSignal: false`. Manual `stop()` and external cancellation preserve the embedding +process and its shared resources. Use `handleSignals: false` for one host-owned signal coordinator, +or `exitOnSignal: false` when the host owns termination and resource disposal. + ## Service surface types -| Symbol | Kind | Description | -| --- | --- | --- | -| `ServiceBuilder` | interface | Fluent builder for configuring and materializing a NetScript service. | -| `ServiceApp` | interface | Minimal mountable service application returned by `build()`. | -| `RunningService` | interface | Running service handle returned by `serve()` and `defineService()`. | -| `RunningServiceAddress` | interface | Network address assigned to a running service listener. | -| `ServiceContext` | interface | Minimal context shape exposed to service middleware and handlers. | -| `ServiceRequest` | interface | Minimal request shape exposed to service middleware and handlers. | -| `ServiceMiddleware` | interface | Middleware function accepted by the service builder. | -| `ServiceHandler` | interface | Service route handler accepted by the builder route API. | +| Symbol | Kind | Description | +| -------------------------------- | ---------- | --------------------------------------------------------------------------------------------------- | +| `ServiceBuilder` | interface | Fluent builder for configuring and materializing a NetScript service. | +| `ServiceApp` | interface | Minimal mountable service application returned by `build()`. | +| `RunningService` | interface | Running service handle returned by `serve()` and `defineService()`. | +| `RunningServiceAddress` | interface | Network address assigned to a running service listener. | +| `ServiceContext` | interface | Minimal context shape exposed to service middleware and handlers. | +| `ServiceRequest` | interface | Minimal request shape exposed to service middleware and handlers. | +| `ServiceMiddleware` | interface | Middleware function accepted by the service builder. | +| `ServiceHandler` | interface | Service route handler accepted by the builder route API. | | `ServiceHandlerContext` | type alias | Readonly custom context plus optional framework-owned `db`, `traceHeaders`, and `principal` fields. | -| `Principal` | interface | Authenticated identity with subject, readonly scopes/roles, scheme, and verified claims. | -| `ServiceHandlerPlugin` | interface | Structural oRPC plugin accepted by service handler factories. | -| `ServiceErrorHandler` | interface | Error handler used by service applications. | -| `FetchHandler` | interface | Structural fetch handler used by RPC and OpenAPI service adapters. | -| `FetchHandlerResult` | interface | Result returned by oRPC-compatible fetch handlers. | +| `Principal` | interface | Authenticated identity with subject, readonly scopes/roles, scheme, and verified claims. | +| `ServiceHandlerPlugin` | interface | Structural oRPC plugin accepted by service handler factories. | +| `ServiceErrorHandler` | interface | Error handler used by service applications. | +| `FetchHandler` | interface | Structural fetch handler used by RPC and OpenAPI service adapters. | +| `FetchHandlerResult` | interface | Result returned by oRPC-compatible fetch handlers. | ## Health types -| Symbol | Kind | Description | -| --- | --- | --- | -| `HealthCheck` | interface | A single health check definition. | -| `HealthResponse` | interface | Response format for the health endpoint. | -| `Database` | interface | Database client capable of a health-check query. | -| `HealthStatus` | type alias | Health status emitted by the service health endpoint (`typeof HEALTH_STATUS[keyof typeof HEALTH_STATUS]`). | +| Symbol | Kind | Description | +| ---------------- | ---------- | ---------------------------------------------------------------------------------------------------------- | +| `HealthCheck` | interface | A single health check definition. | +| `HealthResponse` | interface | Response format for the health endpoint. | +| `Database` | interface | Database client capable of a health-check query. | +| `HealthStatus` | type alias | Health status emitted by the service health endpoint (`typeof HEALTH_STATUS[keyof typeof HEALTH_STATUS]`). | ## Router and context type aliases -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `ServiceRouter` | type alias | `type ServiceRouter = Record` | Router definition accepted by the service builder and handler factories. | -| `ContextFactory` | type alias | `type ContextFactory> = (context: ServiceContext) => TCustom` | Creates the custom part of each service handler context. | +| Symbol | Kind | Signature | Description | +| -------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | +| `ServiceRouter` | type alias | `type ServiceRouter = Record` | Router definition accepted by the service builder and handler factories. | +| `ContextFactory` | type alias | `type ContextFactory> = (context: ServiceContext) => TCustom` | Creates the custom part of each service handler context. | | `ServiceHandlerContext` | type alias | `type ServiceHandlerContext> = Readonly & { db?; traceHeaders?; principal?; }` | Context visible after framework fields are composed. `principal` is optional and must be narrowed by handlers that require identity. | -| `DbContext` | type alias | `type DbContext = Record` | Database context injected into service handler context. | +| `DbContext` | type alias | `type DbContext = Record` | Database context injected into service handler context. | ## Contract-declared authentication and authorization @@ -309,14 +323,14 @@ const app = createService(router, { name: 'orders' }) Contract enforcement is opt-in: existing unguarded services, scaffolds, and standalone `createScopeAuthorizer()` consumers are unchanged. It activates only when an application passes a -`createContractAuthorizer(contract, { fallback?, rawRoutes?, retiredPaths? })` result to `.withAuthz()`. +`createContractAuthorizer(contract, { fallback?, rawRoutes?, retiredPaths? })` result to +`.withAuthz()`. -Contract metadata wins on disagreement. A match-aware fallback, including -`createScopeAuthorizer()`, is consulted only when a matched procedure has no access metadata. No -metadata and no matching fallback rule denies, regardless of the fallback's standalone -`denyByDefault` option. The builder binds one resolver to the actual REST and RPC paths and their -aliases and shares it between authn and authz, so a declared public procedure is not rejected by an -earlier authentication stage. +Contract metadata wins on disagreement. A match-aware fallback, including `createScopeAuthorizer()`, +is consulted only when a matched procedure has no access metadata. No metadata and no matching +fallback rule denies, regardless of the fallback's standalone `denyByDefault` option. The builder +binds one resolver to the actual REST and RPC paths and their aliases and shares it between authn +and authz, so a declared public procedure is not rejected by an earlier authentication stage. `createScopeAuthorizer()` is a supported standalone path-prefix authorizer and a match-aware migration fallback; it is not deprecated. @@ -349,11 +363,11 @@ These paths return **410** after authentication: ``` Missing or invalid credentials retain the existing 401 `UNAUTHORIZED` response without a procedure -code. Retirement requires authentication even outside `protect` or inside `allowAnonymous`. -Active REST/RPC procedures (including aliases), internal audience guards and declared raw routes -win over retirement. Their scope/role denials remain 403; public procedures stay public. A fallback -cannot turn a missing or retired path into an allowed request. Undeclared paths outside protected -coverage keep their previous behavior. +code. Retirement requires authentication even outside `protect` or inside `allowAnonymous`. Active +REST/RPC procedures (including aliases), internal audience guards and declared raw routes win over +retirement. Their scope/role denials remain 403; public procedures stay public. A fallback cannot +turn a missing or retired path into an allowed request. Undeclared paths outside protected coverage +keep their previous behavior. `retiredPaths` contains exact, case-sensitive, canonical mounted absolute paths for all methods, with query strings ignored. Declare REST/RPC/alias paths separately. No trailing slash, percent @@ -363,18 +377,19 @@ construction. Encoded requests, slash variants, siblings and descendants do not Parameterized retirement is unsupported; unmatched concrete paths under guard still return 404. Clients inspecting HTTP responses can map `procedure_retired` to “client too old” and offer an -upgrade without treating it as a permission denial. These are pre-dispatch middleware errors, -not contract-defined oRPC errors. Use the response JSON `code`, not its human-readable message. -`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are available at the root and -`./auth`; `AuthzDecision.code` is optional so existing authorizers preserve their 403 responses. -The matched branch of `ProcedurePolicyResolution` has an optional `retired?: true` marker; -contract-overlay authorizers never set it and retain their current fallback semantics. +upgrade without treating it as a permission denial. These are pre-dispatch middleware errors, not +contract-defined oRPC errors. Use the response JSON `code`, not its human-readable message. +`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are available at the root and `./auth`; +`AuthzDecision.code` is optional so existing authorizers preserve their 403 responses. The matched +branch of `ProcedurePolicyResolution` has an optional `retired?: true` marker; contract-overlay +authorizers never set it and retain their current fallback semantics. ### Raw routes beside a contract router -A request under the guarded prefix that matches no contract procedure returns 404 `procedure_not_found` after authentication, with message -`authz.no-contract-procedure`, including raw routes added with `.route(method, path, handler)`. -Declare each raw route that should be served through the `rawRoutes` option: +A request under the guarded prefix that matches no contract procedure returns 404 +`procedure_not_found` after authentication, with message `authz.no-contract-procedure`, including +raw routes added with `.route(method, path, handler)`. Declare each raw route that should be served +through the `rawRoutes` option: ```ts const authorizer = createContractAuthorizer(OrdersContractV1, { @@ -389,12 +404,12 @@ const app = createService(router, { name: 'orders' }) .build(); ``` -A declared raw route requires a successfully authenticated principal. This applies even when its path -is outside `protect` or inside `allowAnonymous`, so a declaration never makes a path public. An -optional `authorization: { scopes?, roles? }` is enforced like a procedure's declared -authorization. Matching is exact and case-sensitive, and ignores only a trailing slash. Declaring -`/api/tools/mcp` covers neither `/api/tools/mcp-admin` nor `/api/tools/mcp/nested`, and every -undeclared guarded sibling returns 404 `procedure_not_found` after authentication. +A declared raw route requires a successfully authenticated principal. This applies even when its +path is outside `protect` or inside `allowAnonymous`, so a declaration never makes a path public. An +optional `authorization: { scopes?, roles? }` is enforced like a procedure's declared authorization. +Matching is exact and case-sensitive, and ignores only a trailing slash. Declaring `/api/tools/mcp` +covers neither `/api/tools/mcp-admin` nor `/api/tools/mcp/nested`, and every undeclared guarded +sibling returns 404 `procedure_not_found` after authentication. Declarations are validated before any request. Construction throws `[netscript.service.contract-policy] invalid raw route: ...` for a path that is not absolute, @@ -406,36 +421,36 @@ path falls under an RPC mount or alias or matches a REST procedure path. Binding ### Internal procedures and the internal service credential -`.meta({ access: { audience: 'internal' } })` restricts a procedure to service-to-service callers -of the same installation: workers, sagas and triggers presenting the internal service credential. -Both contract authorizers enforce it on the RPC projection and on the OpenAPI projection, including +`.meta({ access: { audience: 'internal' } })` restricts a procedure to service-to-service callers of +the same installation: workers, sagas and triggers presenting the internal service credential. Both +contract authorizers enforce it on the RPC projection and on the OpenAPI projection, including oRPC's default OpenAPI path (`POST //`) when the contract declares no `route.path`. Requests resolve to the procedure oRPC executes: the undecoded pathname is matched -with oRPC's own route patterns and `rou3` precedence (static before parameter before wildcard), -not contract declaration order. A request using a method no procedure declares on an internal +with oRPC's own route patterns and `rou3` precedence (static before parameter before wildcard), not +contract declaration order. A request using a method no procedure declares on an internal procedure's OpenAPI path fails closed toward that procedure. A user session never satisfies the -audience, and the check uses the principal's identity, not its claims or roles. Construction -throws for an `'internal'` audience combined with `authentication: 'none'`, for any other audience -value, and for procedures with different access that share one OpenAPI route. +audience, and the check uses the principal's identity, not its claims or roles. Construction throws +for an `'internal'` audience combined with `authentication: 'none'`, for any other audience value, +and for procedures with different access that share one OpenAPI route. `createContractOverlayAuthorizer(contract, { fallback?, isInternalCaller? })` governs only procedures that declare `meta.access`. Every other request keeps the service's own policy: the -`protect`/`allowAnonymous` path guard, plus the optional fallback authorizer. Marking a few -internal procedures never forces authentication onto public ones. To keep an otherwise -public service public, set `allowAnonymous: ['/api', '/health']`; access-marked procedures are -resolved before the path guard. `createContractAuthorizer` also enforces the audience, but it -still governs every procedure in the contract. +`protect`/`allowAnonymous` path guard, plus the optional fallback authorizer. Marking a few internal +procedures never forces authentication onto public ones. To keep an otherwise public service public, +set `allowAnonymous: ['/api', '/health']`; access-marked procedures are resolved before the path +guard. `createContractAuthorizer` also enforces the audience, but it still governs every procedure +in the contract. The credential is derived from one per-installation secret. Carriers deliver `NETSCRIPT_INSTALLATION_SECRET_FILE`, a file reference, never the value. `loadInstallationSecret()` reads it once at startup. The file holds a textual secret, such as base64 or hex, with surrounding whitespace trimmed (4 KiB maximum, 32 bytes minimum). In-memory `Uint8Array` material passed to -`createInstallationSecret()` is used verbatim. Each service accepts only the bearer -derived for its own name (HKDF-SHA-256), so a credential cannot be replayed across services. A -credential expires by rotation: once the secret changes, every credential derived from the old one -is rejected. `createCompositeAuthenticator([...])` lets one guarded service accept the internal -credential alongside user sessions over the single `AuthenticatorPort`. Callers send the -credential with the SDK's `createInternalCredentialSdkClientContribution({ service })`. +`createInstallationSecret()` is used verbatim. Each service accepts only the bearer derived for its +own name (HKDF-SHA-256), so a credential cannot be replayed across services. A credential expires by +rotation: once the secret changes, every credential derived from the old one is rejected. +`createCompositeAuthenticator([...])` lets one guarded service accept the internal credential +alongside user sessions over the single `AuthenticatorPort`. Callers send the credential with the +SDK's `createInternalCredentialSdkClientContribution({ service })`. ```ts import { createService } from '@netscript/service'; @@ -464,24 +479,23 @@ const app = createService(router, { name: 'orders' }) ### Explicit service posture -`ServiceAuthPolicy` records either native guards (`{ authn, authz? }`) or a deliberate -public opt-out (`{ public: true, reason }`). `ServiceGuardedAuthPolicy` and -`ServicePublicAuthPolicy` are mutually exclusive; a public reason must be nonblank. -`assertServiceAuthPolicy(value)` rejects absent or ambiguous postures and malformed callable -ports with a redacted `TypeError`. It preserves the original options: a custom -`allowAnonymous` list replaces the native default; the assertion does not add `/health`. -It validates configuration only and does not authenticate requests or install middleware. -`DefineServiceOptions.auth` requires this policy. `defineService()` runs the shared assertion -before builder configuration, database startup, or listener creation, so JavaScript callers receive -an actionable `TypeError` as well as TypeScript callers receiving a missing-field error. -Guarded policies install the existing native stages unchanged; public policies deliberately skip -them. `/api` is guarded and `/health` stays anonymous with native defaults. +`ServiceAuthPolicy` records either native guards (`{ authn, authz? }`) or a deliberate public +opt-out (`{ public: true, reason }`). `ServiceGuardedAuthPolicy` and `ServicePublicAuthPolicy` are +mutually exclusive; a public reason must be nonblank. `assertServiceAuthPolicy(value)` rejects +absent or ambiguous postures and malformed callable ports with a redacted `TypeError`. It preserves +the original options: a custom `allowAnonymous` list replaces the native default; the assertion does +not add `/health`. It validates configuration only and does not authenticate requests or install +middleware. `DefineServiceOptions.auth` requires this policy. `defineService()` runs the shared +assertion before builder configuration, database startup, or listener creation, so JavaScript +callers receive an actionable `TypeError` as well as TypeScript callers receiving a missing-field +error. Guarded policies install the existing native stages unchanged; public policies deliberately +skip them. `/api` is guarded and `/health` stays anonymous with native defaults. > [!IMPORTANT] > **Changed in 0.0.8** > -> Search existing entrypoints for `defineService(` and either choose native -> guards or record a public service's reason. The public opt-out looks like this: +> Search existing entrypoints for `defineService(` and either choose native guards or record a +> public service's reason. The public opt-out looks like this: ```diff -await defineService(router, { name: 'status' }); @@ -500,13 +514,12 @@ records a greppable public opt-out with a reason explaining how to protect it. L reconcile scaffold-owned opt-outs; authored policies remain authoritative, and `generate aspire` leaves authored inputs unchanged. -Generated contracts include a `session` identity probe with `authentication: 'required'`. -That metadata describes the guarded posture and remains visible in OpenAPI/discovery even when -auth is not installed. An explicit service-wide public opt-out skips authentication and -authorization, including this contract requirement: anonymous `session` calls then return -200 with `{ authenticated: false }`. The metadata alone does not install guards. Install auth -or configure a guarded service policy to enforce it; the probe reports whether the runtime -provided a principal. +Generated contracts include a `session` identity probe with `authentication: 'required'`. That +metadata describes the guarded posture and remains visible in OpenAPI/discovery even when auth is +not installed. An explicit service-wide public opt-out skips authentication and authorization, +including this contract requirement: anonymous `session` calls then return 200 with +`{ authenticated: false }`. The metadata alone does not install guards. Install auth or configure a +guarded service policy to enforce it; the probe reports whether the runtime provided a principal. This policy requirement applies to the preset; lower-level `createService()` callers compose their middleware explicitly. @@ -523,29 +536,29 @@ assertServiceAuthPolicy(policy); ### `@netscript/service/auth` surface -| Symbol | Kind | Description | -| --- | --- | --- | -| `ServiceAuthPolicy` | type alias | Native guarded posture or an explicit public opt-out. | -| `ServiceGuardedAuthPolicy` | interface | Native authentication with optional authorization; excludes public fields. | -| `ServicePublicAuthPolicy` | interface | Literal public opt-out with a nonblank reason; excludes guard fields. | -| `assertServiceAuthPolicy` | function | Validates an explicit posture and required callable ports without changing options. | -| `createContractAuthorizer` | function | Traverses a metadata-bearing contract and returns an opt-in authorizer bound by the service builder. | -| `createContractOverlayAuthorizer` | function | Enforces only access-marked procedures and leaves every other request to the service's own policy. | -| `createInternalCredentialAuthenticator` | function | Accepts the internal bearer derived for this service and mints internal service principals. | -| `isInternalServicePrincipal` | function | Default `InternalCallerPredicate`; true only for principals minted by the internal-credential authenticator. | -| `createCompositeAuthenticator` | function | Tries authenticators in order over one `AuthenticatorPort` and returns the first success. | -| `loadInstallationSecret` / `createInstallationSecret` | function | Import the per-installation secret from its file reference or from memory. | -| `deriveInternalCredential` | function | Derives the per-service internal bearer from the installation secret. | -| `createScopeAuthorizer` | function | Ordered scope/role rules usable standalone or as a match-aware legacy fallback. | -| `createStaticCredentialAuthenticator` | function | Maps configured credentials to principals. | -| `createTrustedHeaderAuthenticator` | function | Maps trusted upstream identity headers to principals. | -| `Principal` | interface | Service-owned identity contract. | -| `PROCEDURE_ERROR_CODES` | constant | Stable `NOT_FOUND` (`procedure_not_found`) and `RETIRED` (`procedure_retired`) HTTP error codes. | -| `ProcedureErrorCode` | type alias | Union of the stable unknown/retired procedure codes. | -| `AuthzDecision` | type alias | Allow or deny, with an optional procedure failure code selecting 404/410. | -| `ProcedurePolicyResolution` | type alias | Shared matched policy or miss; `retired?: true` marks authenticated retirement. | -| `ContractPolicyAuthorizerPort` | interface | Authorizer that binds to the builder's REST/RPC projection paths. | -| `ContractAuthorizerRawRoute` | interface | Exact, authentication-required raw route declared through `createContractAuthorizer(contract, { rawRoutes })`. | +| Symbol | Kind | Description | +| ----------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- | +| `ServiceAuthPolicy` | type alias | Native guarded posture or an explicit public opt-out. | +| `ServiceGuardedAuthPolicy` | interface | Native authentication with optional authorization; excludes public fields. | +| `ServicePublicAuthPolicy` | interface | Literal public opt-out with a nonblank reason; excludes guard fields. | +| `assertServiceAuthPolicy` | function | Validates an explicit posture and required callable ports without changing options. | +| `createContractAuthorizer` | function | Traverses a metadata-bearing contract and returns an opt-in authorizer bound by the service builder. | +| `createContractOverlayAuthorizer` | function | Enforces only access-marked procedures and leaves every other request to the service's own policy. | +| `createInternalCredentialAuthenticator` | function | Accepts the internal bearer derived for this service and mints internal service principals. | +| `isInternalServicePrincipal` | function | Default `InternalCallerPredicate`; true only for principals minted by the internal-credential authenticator. | +| `createCompositeAuthenticator` | function | Tries authenticators in order over one `AuthenticatorPort` and returns the first success. | +| `loadInstallationSecret` / `createInstallationSecret` | function | Import the per-installation secret from its file reference or from memory. | +| `deriveInternalCredential` | function | Derives the per-service internal bearer from the installation secret. | +| `createScopeAuthorizer` | function | Ordered scope/role rules usable standalone or as a match-aware legacy fallback. | +| `createStaticCredentialAuthenticator` | function | Maps configured credentials to principals. | +| `createTrustedHeaderAuthenticator` | function | Maps trusted upstream identity headers to principals. | +| `Principal` | interface | Service-owned identity contract. | +| `PROCEDURE_ERROR_CODES` | constant | Stable `NOT_FOUND` (`procedure_not_found`) and `RETIRED` (`procedure_retired`) HTTP error codes. | +| `ProcedureErrorCode` | type alias | Union of the stable unknown/retired procedure codes. | +| `AuthzDecision` | type alias | Allow or deny, with an optional procedure failure code selecting 404/410. | +| `ProcedurePolicyResolution` | type alias | Shared matched policy or miss; `retired?: true` marks authenticated retirement. | +| `ContractPolicyAuthorizerPort` | interface | Authorizer that binds to the builder's REST/RPC projection paths. | +| `ContractAuthorizerRawRoute` | interface | Exact, authentication-required raw route declared through `createContractAuthorizer(contract, { rawRoutes })`. | ## Command definitions and codecs @@ -554,42 +567,41 @@ recovery, trust boundaries and durable-format changes are covered by [Operations](/services-sdk/command-operations/), [Security](/services-sdk/command-security/) and [Compatibility](/services-sdk/command-compatibility/). - `@netscript/service/commands` defines immutable command policies and bounded canonical codecs -without executing handlers. Importing, defining and encoding require no permissions; execution -uses the explicitly supplied store/business operations and their permissions. JSON uses `jcs-v1` -with RFC 8785 ordering and numeric/string serialization. Default limits are depth 64, 10,000 -aggregate values/keys and 1 MiB UTF-8 bytes; options may only tighten these bounds. Stored text must -match canonical serialization exactly. Synchronous schema validation must preserve canonical JSON -identity to keep replay stable. - -| Symbol | Kind | Description | -| --------------------------- | ---------------- | ----------------------------------------------------------------- | -| `defineCommand` | function | Validates durable identity and freezes an opaque definition. | -| `jsonCodec` | function | Synchronous Standard Schema validation with stable bounded JSON. | -| `canonicalCommandJson` | function | Produces bounded canonical JSON text. | -| `commandTraceContext` | function | Reuses strict W3C parent/state validation at producer boundaries. | -| `parseCanonicalCommandJson` | function | Accepts only bounded canonical stored text. | -| `CommandCodec` | type alias | Typed response/payload encoding and decoding boundary. | -| `CommandJsonLimits` | type alias | Tighten-only depth, item and byte safeguards. | -| `CommandJson` | type alias | Readonly recursive I-JSON values. | -| `CommandActor` | type alias | Principal or system identity, excluding roles and claims. | -| `CommandEnvelope` | type alias | Input, actor and transport fields with string version tokens. | -| `CommandTraceContext` | type alias | Validated W3C traceparent and optional tracestate. | -| `CommandAuditInput` | type alias | Redacted audit intent. | -| `CommandContext` | interface | Transaction handle and synchronous side-record operations. | -| `CommandDefinition` | interface | Opaque immutable identity, replay policy and record requirements. | -| `CommandDefinitionSpec` | type alias | Construction specification with privately bound handler. | -| `commandDefinitionBinding` | type-only symbol | Opaque marker; unavailable as a runtime export. | -| `commandExecutorCapability` | type-only symbol | Private binding capability; unavailable as a runtime export. | -| `CommandIdempotency` | type alias | Frozen semantic scope, fingerprint and replay codec. | -| `CommandIdempotencyMode` | type alias | Required or optional key policy. | -| `CommandIdempotencySpec` | type alias | Construction policy defaulting to required keys. | -| `CommandOutboxInput` | type alias | Delivery intent with typed codec. | -| `CommandRecordRequirement` | type alias | Required, optional or forbidden side-record policy. | -| `CommandError` | class | Frozen redacted failure with a trusted nonserialized cause. | -| `CommandFailure` | type alias | Bounded discriminated failure and retry vocabulary. | -| `IsolationLevel` | type alias | Database-owned transaction isolation vocabulary, re-exported as a type. | +without executing handlers. Importing, defining and encoding require no permissions; execution uses +the explicitly supplied store/business operations and their permissions. JSON uses `jcs-v1` with RFC +8785 ordering and numeric/string serialization. Default limits are depth 64, 10,000 aggregate +values/keys and 1 MiB UTF-8 bytes; options may only tighten these bounds. Stored text must match +canonical serialization exactly. Synchronous schema validation must preserve canonical JSON identity +to keep replay stable. + +| Symbol | Kind | Description | +| --------------------------- | ---------------- | ----------------------------------------------------------------------- | +| `defineCommand` | function | Validates durable identity and freezes an opaque definition. | +| `jsonCodec` | function | Synchronous Standard Schema validation with stable bounded JSON. | +| `canonicalCommandJson` | function | Produces bounded canonical JSON text. | +| `commandTraceContext` | function | Reuses strict W3C parent/state validation at producer boundaries. | +| `parseCanonicalCommandJson` | function | Accepts only bounded canonical stored text. | +| `CommandCodec` | type alias | Typed response/payload encoding and decoding boundary. | +| `CommandJsonLimits` | type alias | Tighten-only depth, item and byte safeguards. | +| `CommandJson` | type alias | Readonly recursive I-JSON values. | +| `CommandActor` | type alias | Principal or system identity, excluding roles and claims. | +| `CommandEnvelope` | type alias | Input, actor and transport fields with string version tokens. | +| `CommandTraceContext` | type alias | Validated W3C traceparent and optional tracestate. | +| `CommandAuditInput` | type alias | Redacted audit intent. | +| `CommandContext` | interface | Transaction handle and synchronous side-record operations. | +| `CommandDefinition` | interface | Opaque immutable identity, replay policy and record requirements. | +| `CommandDefinitionSpec` | type alias | Construction specification with privately bound handler. | +| `commandDefinitionBinding` | type-only symbol | Opaque marker; unavailable as a runtime export. | +| `commandExecutorCapability` | type-only symbol | Private binding capability; unavailable as a runtime export. | +| `CommandIdempotency` | type alias | Frozen semantic scope, fingerprint and replay codec. | +| `CommandIdempotencyMode` | type alias | Required or optional key policy. | +| `CommandIdempotencySpec` | type alias | Construction policy defaulting to required keys. | +| `CommandOutboxInput` | type alias | Delivery intent with typed codec. | +| `CommandRecordRequirement` | type alias | Required, optional or forbidden side-record policy. | +| `CommandError` | class | Frozen redacted failure with a trusted nonserialized cause. | +| `CommandFailure` | type alias | Bounded discriminated failure and retry vocabulary. | +| `IsolationLevel` | type alias | Database-owned transaction isolation vocabulary, re-exported as a type. | ## Command testing @@ -604,19 +616,19 @@ callback attempt; it may reject disjoint concurrent drafts because it uses a glo ## Command executor -| Symbol | Kind | Description | -| --- | --- | --- | -| `createCommandExecutor` | function | Compose once-only execution over a bound same-commit store. | -| `CommandExecutor` | interface | Execute a genuine definition and await the store boundary. | -| `CommandExecution` | type alias | Decoded value, applied/replayed outcome, idempotency state and original correlation. | -| `CommandExecutorOptions` | type alias | Store, optional clock/IDs/telemetry, claim wait and tighten-only record limits. | -| `CommandRecordLimits` | type alias | 64 audit/64 outbox defaults; aggregate canonical side-row byte default 64 KiB. | -| `CommandClock` | interface | Injected valid Date source, detached by the executor. | -| `CommandIdSource` | interface | Fresh bounded identifiers. | -| `CommandTelemetryPort` | interface | Once-only tracing extension preserving values and errors. | -| `CommandTelemetrySpan` | interface | Finish with finite outcome/count vocabulary after the boundary. | -| `CommandTelemetryStart` | type alias | Name/version, requested or default isolation, provider and keyed state. | -| `CommandTelemetryResult` | type alias | Finite outcome/idempotency/counts and optional bounded failure kind. | +| Symbol | Kind | Description | +| ------------------------ | ---------- | ------------------------------------------------------------------------------------ | +| `createCommandExecutor` | function | Compose once-only execution over a bound same-commit store. | +| `CommandExecutor` | interface | Execute a genuine definition and await the store boundary. | +| `CommandExecution` | type alias | Decoded value, applied/replayed outcome, idempotency state and original correlation. | +| `CommandExecutorOptions` | type alias | Store, optional clock/IDs/telemetry, claim wait and tighten-only record limits. | +| `CommandRecordLimits` | type alias | 64 audit/64 outbox defaults; aggregate canonical side-row byte default 64 KiB. | +| `CommandClock` | interface | Injected valid Date source, detached by the executor. | +| `CommandIdSource` | interface | Fresh bounded identifiers. | +| `CommandTelemetryPort` | interface | Once-only tracing extension preserving values and errors. | +| `CommandTelemetrySpan` | interface | Finish with finite outcome/count vocabulary after the boundary. | +| `CommandTelemetryStart` | type alias | Name/version, requested or default isolation, provider and keyed state. | +| `CommandTelemetryResult` | type alias | Finite outcome/idempotency/counts and optional bounded failure kind. | The executor freezes detached bounded I-JSON input before the two identity callbacks, each called once. Required keys are 16–256 UTF-8 bytes; scope and other identity/header strings are bounded to @@ -632,17 +644,17 @@ flush in that order. Optional unkeyed attempts skip receipts. Telemetry goes thr ### Command conformance fixtures -`@netscript/service/commands/testing` also provides an instance-bound -`CommandFaultController`, `createTestingCommandExecutor()` and a generic -`CommandConformanceFixture`. Production executor options contain no fault controls. The testing -factory uses the production algorithm and the exact seven command boundaries, including a -postcommit response-loss boundary whose same-key retry must replay the original receipt. +`@netscript/service/commands/testing` also provides an instance-bound `CommandFaultController`, +`createTestingCommandExecutor()` and a generic `CommandConformanceFixture`. Production executor +options contain no fault controls. The testing factory uses the production algorithm and the exact +seven command boundaries, including a postcommit response-loss boundary whose same-key retry must +replay the original receipt. `runCommandConformance(createFixture)` checks atomic rollback and recovery, ordered side writes, replay/mismatch and namespace/version changes, corrupt replay, CAS, cancellation, busy, callback -counts and retry refusal. `createMemoryCommandConformanceFixture()` supplies a simulated fixture. -An outside-transaction business write is an explicit negative control: the shared suite must detect -its surviving effect after rollback. Database-owned store/row types and the generic business handle +counts and retry refusal. `createMemoryCommandConformanceFixture()` supplies a simulated fixture. An +outside-transaction business write is an explicit negative control: the shared suite must detect its +surviving effect after rollback. Database-owned store/row types and the generic business handle allow provider adapters to supply their own inspection and fixture operations. This finite suite certifies no real driver, locking strategy or pooled session settings. @@ -654,69 +666,67 @@ not. Future traceparent fields remain opaque after known W3C prefix validation, with a bounded HTTP field-value guard rejecting CR, LF, NUL and other ASCII control bytes except HTAB. SP, HTAB and -obs-text remain accepted in the opaque suffix; empty tracestate positives are preserved. This follows -[RFC9110 field values](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5) and +obs-text remain accepted in the opaque suffix; empty tracestate positives are preserved. This +follows [RFC9110 field values](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5) and [W3C traceparent versioning](https://www.w3.org/TR/trace-context/#versioning-of-traceparent). ## Command outbox relay [Relay committed command intents](/services-sdk/command-relay/) composes the shipped PostgreSQL -adapter and checked worker sink. [Outbound webhooks](/orchestration-runtime/how-to/outbound-webhooks/) -adds signed outbound delivery; inbound trigger verification is a separate direction. - +adapter and checked worker sink. +[Outbound webhooks](/orchestration-runtime/how-to/outbound-webhooks/) adds signed outbound delivery; +inbound trigger verification is a separate direction. `createCommandOutboxRelay` starts no resource: existing scheduling calls `drainOnce` and shutdown awaits `stop`. It decodes canonical bounded payload and W3C fields, snapshots sink registration, -publishes before settlement and preserves stable identities across retries/crashes. All drains -share one bounded concurrency ceiling; stopping prevents claims and awaits every active/queued -drain. Invalid classifier/backoff cannot write arbitrary failure text or lose leases. Worker -acceptance is checked and normalized before the database writes it together with publication. -Uncertain settlement errors surface without a speculative release. Optional C4-compatible tracing -selects finite command attributes and preserves deferred/producer propagation without raw identity -attributes. The database owns leases; no second relay, queue or runtime DDL is introduced. - -The sagas plugin contributes the Prisma command outbox model and its reviewed SQL constraints. -Apply the normal application migration after installation. For bounded maintenance, the PostgreSQL -relay store exposes `pruneSettled`; the composed saga API also prunes atomic replay keys according -to terminal completion and the saga group's completed-retention window (default seven days). -Pending work, leases and active saga markers survive; eligibility is rechecked at deletion. -See [outbox retention](../database/index.md#bounded-outbox-retention) and the +publishes before settlement and preserves stable identities across retries/crashes. All drains share +one bounded concurrency ceiling; stopping prevents claims and awaits every active/queued drain. +Invalid classifier/backoff cannot write arbitrary failure text or lose leases. Worker acceptance is +checked and normalized before the database writes it together with publication. Uncertain settlement +errors surface without a speculative release. Optional C4-compatible tracing selects finite command +attributes and preserves deferred/producer propagation without raw identity attributes. The database +owns leases; no second relay, queue or runtime DDL is introduced. + +The sagas plugin contributes the Prisma command outbox model and its reviewed SQL constraints. Apply +the normal application migration after installation. For bounded maintenance, the PostgreSQL relay +store exposes `pruneSettled`; the composed saga API also prunes atomic replay keys according to +terminal completion and the saga group's completed-retention window (default seven days). Pending +work, leases and active saga markers survive; eligibility is rechecked at deletion. See +[outbox retention](../database/index.md#bounded-outbox-retention) and the [Prisma saga retention recipe](../plugin-sagas-core/index.md#installed-outbox-schema-and-postgresql-retention) for migration, policies and persisted cursor examples. - -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createCommandOutboxRelay` | function | `function createCommandOutboxRelay(options): RunningCommandOutboxRelay` | Compose the one bounded decoded relay. | -| `CommandOutboxDelivery` | type alias | `type CommandOutboxDelivery` | Frozen decoded delivery and transport context. | -| `CommandOutboxRelayOptions` | type alias | `type CommandOutboxRelayOptions` | Explicit finite lifecycle/retry policy and supplied ports. | -| `CommandOutboxSink` | interface | `interface CommandOutboxSink` | Documented acceptance boundary. | -| `CommandRelayTelemetryPort` | interface | `interface CommandRelayTelemetryPort` | Privacy-safe structural C4 observer extension. | -| `RunningCommandOutboxRelay` | interface | `interface RunningCommandOutboxRelay` | Drain/stop lifecycle. | -| `CommandRelayError` | class | `class CommandRelayError` | Closed sink/decode diagnostic. | -| `COMMAND_RELAY_FAILURE_CLASSES` | const | `readonly tuple` | Closed persisted relay failure vocabulary. | -| `CommandRelayFailureClass` | type alias | `type CommandRelayFailureClass` | One of six finite failures. | -| `ClaimedCommandOutboxRow` | type alias | `type ClaimedCommandOutboxRow` | Database-owned raw leased row. | -| `CommandOutboxAcceptance` | type alias | `type CommandOutboxAcceptance` | Checked normalized receipt identity/time. | -| `CommandOutboxClaim` | type alias | `type CommandOutboxClaim` | Bounded clock/generation request. | -| `CommandOutboxPublication` | type alias | `type CommandOutboxPublication` | One publication/acceptance settlement. | -| `CommandOutboxRelayStore` | interface | `interface CommandOutboxRelayStore` | Raw claim/mark/release port. | -| `CommandOutboxRelease` | type alias | `type CommandOutboxRelease` | Retried or retained terminal row. | - +| Symbol | Kind | Signature | Description | +| ------------------------------- | ---------- | ----------------------------------------------------------------------- | ---------------------------------------------------------- | +| `createCommandOutboxRelay` | function | `function createCommandOutboxRelay(options): RunningCommandOutboxRelay` | Compose the one bounded decoded relay. | +| `CommandOutboxDelivery` | type alias | `type CommandOutboxDelivery` | Frozen decoded delivery and transport context. | +| `CommandOutboxRelayOptions` | type alias | `type CommandOutboxRelayOptions` | Explicit finite lifecycle/retry policy and supplied ports. | +| `CommandOutboxSink` | interface | `interface CommandOutboxSink` | Documented acceptance boundary. | +| `CommandRelayTelemetryPort` | interface | `interface CommandRelayTelemetryPort` | Privacy-safe structural C4 observer extension. | +| `RunningCommandOutboxRelay` | interface | `interface RunningCommandOutboxRelay` | Drain/stop lifecycle. | +| `CommandRelayError` | class | `class CommandRelayError` | Closed sink/decode diagnostic. | +| `COMMAND_RELAY_FAILURE_CLASSES` | const | `readonly tuple` | Closed persisted relay failure vocabulary. | +| `CommandRelayFailureClass` | type alias | `type CommandRelayFailureClass` | One of six finite failures. | +| `ClaimedCommandOutboxRow` | type alias | `type ClaimedCommandOutboxRow` | Database-owned raw leased row. | +| `CommandOutboxAcceptance` | type alias | `type CommandOutboxAcceptance` | Checked normalized receipt identity/time. | +| `CommandOutboxClaim` | type alias | `type CommandOutboxClaim` | Bounded clock/generation request. | +| `CommandOutboxPublication` | type alias | `type CommandOutboxPublication` | One publication/acceptance settlement. | +| `CommandOutboxRelayStore` | interface | `interface CommandOutboxRelayStore` | Raw claim/mark/release port. | +| `CommandOutboxRelease` | type alias | `type CommandOutboxRelease` | Retried or retained terminal row. | ### Envelope and record policies -| Field or policy | Contract | -| --- | --- | -| `input` | Detached, deeply frozen bounded I-JSON. Contract/input schema validation belongs to the service adapter. | -| `actor` | Trusted principal/system origin; actor kind/subject participates in request identity, scheme does not. | -| `correlationId` | Bounded transport identity; successful replay returns the original correlation. | -| `idempotencyKey` | Required by default, 16–256 UTF-8 bytes; stored as a digest. Optional unkeyed execution has no receipt. | -| `expectedVersion` | Optional normalized string included in request identity. The handler must implement atomic comparison/update. | -| `trace` | Validated W3C propagation fields, excluded from request identity. | -| `records.audit` / `records.outbox` | `required`, `optional` or `forbidden`; policy/codec failures roll back. | -| `CommandRecordLimits` | Defaults: 64 audit rows, 64 outbox rows, 64 KiB shared canonical side-row bytes including metadata; tighten only. | -| `CommandJsonLimits` | Defaults: depth 64, aggregate items 10,000, canonical bytes 1 MiB; tighten only. | +| Field or policy | Contract | +| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| `input` | Detached, deeply frozen bounded I-JSON. Contract/input schema validation belongs to the service adapter. | +| `actor` | Trusted principal/system origin; actor kind/subject participates in request identity, scheme does not. | +| `correlationId` | Bounded transport identity; successful replay returns the original correlation. | +| `idempotencyKey` | Required by default, 16–256 UTF-8 bytes; stored as a digest. Optional unkeyed execution has no receipt. | +| `expectedVersion` | Optional normalized string included in request identity. The handler must implement atomic comparison/update. | +| `trace` | Validated W3C propagation fields, excluded from request identity. | +| `records.audit` / `records.outbox` | `required`, `optional` or `forbidden`; policy/codec failures roll back. | +| `CommandRecordLimits` | Defaults: 64 audit rows, 64 outbox rows, 64 KiB shared canonical side-row bytes including metadata; tighten only. | +| `CommandJsonLimits` | Defaults: depth 64, aggregate items 10,000, canonical bytes 1 MiB; tighten only. | ### Relay policy bounds @@ -724,13 +734,13 @@ All five numerical policy options are required positive safe integers. `concurre `batchSize`. Sink registry keys must equal the sink's bounded nonblank `id`; at most 64 sinks are allowed. The relay snapshots registrations at construction. -| Option | Maximum | Meaning | -| --- | --- | --- | -| `batchSize` | 64 | Rows claimed by one drain. | -| `concurrency` | 64 | Active publications within the serialized drains. | -| `leaseMs` | 60,000 | Claim lifetime; the store fences both token and expiry. | -| `maxAttempts` | 10,000 | Failed claims below this count can be rescheduled; exhaustion is retained terminal. | -| `maxRetryDelayMs` | 86,400,000 | Upper bound on a strictly future `retryAt` result. | +| Option | Maximum | Meaning | +| ----------------- | ---------- | ----------------------------------------------------------------------------------- | +| `batchSize` | 64 | Rows claimed by one drain. | +| `concurrency` | 64 | Active publications within the serialized drains. | +| `leaseMs` | 60,000 | Claim lifetime; the store fences both token and expiry. | +| `maxAttempts` | 10,000 | Failed claims below this count can be rescheduled; exhaustion is retained terminal. | +| `maxRetryDelayMs` | 86,400,000 | Upper bound on a strictly future `retryAt` result. | `clock.now` and `ids.next` are explicit ports. `classify` returns one of the six `COMMAND_RELAY_FAILURE_CLASSES`; `CommandRelayError` already carries its class. Invalid classifier diff --git a/docs/site/reference/telemetry/index.md b/docs/site/reference/telemetry/index.md index 764924b46f..3c7a7bbc03 100644 --- a/docs/site/reference/telemetry/index.md +++ b/docs/site/reference/telemetry/index.md @@ -11,22 +11,22 @@ need; the root entrypoint holds only diagnostics and the instrumentation registr ## Sub-path exports -| Export | Entrypoint | Purpose | -| --- | --- | --- | -| `@netscript/telemetry` | `./mod.ts` | [Diagnostics and the instrumentation registry contract](#root-entrypoint). | -| `@netscript/telemetry/config` | `./config.ts` | [Telemetry configuration and OTEL env resolution](#configuration-netscripttelemetryconfig). | -| `@netscript/telemetry/tracer` | `./tracer.ts` | [Tracer accessors and span helpers](#tracer-netscripttelemetrytracer). | -| `@netscript/telemetry/context` | `./context.ts` | [W3C trace-context propagation](#context-netscripttelemetrycontext). | -| `@netscript/telemetry/commands` | `./commands.ts` | [Privacy-first command adapter and native relationship wrappers](#command-telemetry). | -| `@netscript/telemetry/attributes` | `./attributes.ts` | [Semantic attribute and span-name constants](#attributes-netscripttelemetryattributes). | -| `@netscript/telemetry/instrumentation` | `./instrumentation.ts` | [Worker/queue/scheduler/SSE instrumentation](#instrumentation-netscripttelemetryinstrumentation). | -| `@netscript/telemetry/registry` | `./registry.ts` | [Instrumentation lifecycle registry](#registry-netscripttelemetryregistry). | -| `@netscript/telemetry/orpc` | `./orpc.ts` | [oRPC tracing and error-handling plugins](#orpc-netscripttelemetryorpc). | -| `@netscript/telemetry/hono` | `./hono.ts` | Hono request and response tracing middleware. | -| `@netscript/telemetry/ai` | `./ai.ts` | GenAI request, token, and chat-client metrics and tracing. | -| `@netscript/telemetry/otel` | `./src/adapters/otel/mod.ts` | OpenTelemetry Deno provider adapters. | -| `@netscript/telemetry/query` | `./query.ts` | Telemetry query capabilities and filters. | -| `@netscript/telemetry/testing` | `./src/testing/mod.ts` | In-memory span recorder for test verification. | +| Export | Entrypoint | Purpose | +| -------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------- | +| `@netscript/telemetry` | `./mod.ts` | [Diagnostics and the instrumentation registry contract](#root-entrypoint). | +| `@netscript/telemetry/config` | `./config.ts` | [Telemetry configuration and OTEL env resolution](#configuration-netscripttelemetryconfig). | +| `@netscript/telemetry/tracer` | `./tracer.ts` | [Tracer accessors and span helpers](#tracer-netscripttelemetrytracer). | +| `@netscript/telemetry/context` | `./context.ts` | [W3C trace-context propagation](#context-netscripttelemetrycontext). | +| `@netscript/telemetry/commands` | `./commands.ts` | [Privacy-first command adapter and native relationship wrappers](#command-telemetry). | +| `@netscript/telemetry/attributes` | `./attributes.ts` | [Semantic attribute and span-name constants](#attributes-netscripttelemetryattributes). | +| `@netscript/telemetry/instrumentation` | `./instrumentation.ts` | [Worker/queue/scheduler/SSE instrumentation](#instrumentation-netscripttelemetryinstrumentation). | +| `@netscript/telemetry/registry` | `./registry.ts` | [Instrumentation lifecycle registry](#registry-netscripttelemetryregistry). | +| `@netscript/telemetry/orpc` | `./orpc.ts` | [oRPC tracing and error-handling plugins](#orpc-netscripttelemetryorpc). | +| `@netscript/telemetry/hono` | `./hono.ts` | Hono request and response tracing middleware. | +| `@netscript/telemetry/ai` | `./ai.ts` | GenAI request, token, and chat-client metrics and tracing. | +| `@netscript/telemetry/otel` | `./src/adapters/otel/mod.ts` | OpenTelemetry Deno provider adapters. | +| `@netscript/telemetry/query` | `./query.ts` | Telemetry query capabilities and filters. | +| `@netscript/telemetry/testing` | `./src/testing/mod.ts` | In-memory span recorder for test verification. | ## Root entrypoint @@ -34,18 +34,18 @@ Diagnostics, traced-job helpers, and the instrumentation registry contract. ### Functions -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `inspectTelemetry` | function | `function inspectTelemetry(target): InspectionReport` | Inspect a telemetry target and return a JSON-stable diagnostic report. | -| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess, continuing the trace from the worker. | -| `runTracedJob` | function | `async function runTracedJob(jobId: string, fn): Promise` | Wrap a job main function with context extraction and span creation. | +| Symbol | Kind | Signature | Description | +| ------------------ | -------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------- | +| `inspectTelemetry` | function | `function inspectTelemetry(target): InspectionReport` | Inspect a telemetry target and return a JSON-stable diagnostic report. | +| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess, continuing the trace from the worker. | +| `runTracedJob` | function | `async function runTracedJob(jobId: string, fn): Promise` | Wrap a job main function with context extraction and span creation. | ### Classes -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `InstrumentationRegistry` | class | `class InstrumentationRegistry` | Registry for telemetry instrumentation lifecycle hooks (`register`, `resolve`, `list`, `setupAll`, `teardownAll`). | -| `DuplicateInstrumentationError` | class | `class DuplicateInstrumentationError extends Error` | Error thrown when an instrumentation registration name is duplicated. | +| Symbol | Kind | Signature | Description | +| ------------------------------- | ----- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | +| `InstrumentationRegistry` | class | `class InstrumentationRegistry` | Registry for telemetry instrumentation lifecycle hooks (`register`, `resolve`, `list`, `setupAll`, `teardownAll`). | +| `DuplicateInstrumentationError` | class | `class DuplicateInstrumentationError extends Error` | Error thrown when an instrumentation registration name is duplicated. | ### Types @@ -58,111 +58,111 @@ Diagnostics, traced-job helpers, and the instrumentation registry contract. ## Configuration (`@netscript/telemetry/config`) -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `getTelemetryConfig` | function | `function getTelemetryConfig(): TelemetryConfig` | Resolve the telemetry configuration from the environment. | -| `getConfig` | function | `function getConfig(): TelemetryConfig` | Get the cached singleton telemetry configuration. | -| `resetConfig` | function | `function resetConfig(): void` | Reset the cached singleton configuration. | -| `describeTelemetryConfig` | function | `function describeTelemetryConfig(): TelemetryConfigDescription` | Describe the effective configuration for diagnostics. | -| `isTelemetryEnabled` | function | `function isTelemetryEnabled(): boolean` | Whether telemetry is enabled in the current environment. | -| `getServiceName` | function | `function getServiceName(): string` | Resolve the configured OTEL service name. | -| `getOtlpEndpoint` | function | `function getOtlpEndpoint(): string \| undefined` | Resolve the OTLP exporter endpoint, if set. | -| `getOtelEnvVars` | function | `function getOtelEnvVars(): Record` | Collect the resolved OTEL environment variables. | -| `OTEL_ENV_VARS` | const | `const OTEL_ENV_VARS` | Map of the supported OTEL environment variable names. | -| `TelemetryConfig` | interface | interface | Resolved telemetry configuration shape. | -| `TelemetryConfigDescription` | interface | interface | Human-readable configuration description. | +| Symbol | Kind | Signature | Description | +| ---------------------------- | --------- | ---------------------------------------------------------------- | --------------------------------------------------------- | +| `getTelemetryConfig` | function | `function getTelemetryConfig(): TelemetryConfig` | Resolve the telemetry configuration from the environment. | +| `getConfig` | function | `function getConfig(): TelemetryConfig` | Get the cached singleton telemetry configuration. | +| `resetConfig` | function | `function resetConfig(): void` | Reset the cached singleton configuration. | +| `describeTelemetryConfig` | function | `function describeTelemetryConfig(): TelemetryConfigDescription` | Describe the effective configuration for diagnostics. | +| `isTelemetryEnabled` | function | `function isTelemetryEnabled(): boolean` | Whether telemetry is enabled in the current environment. | +| `getServiceName` | function | `function getServiceName(): string` | Resolve the configured OTEL service name. | +| `getOtlpEndpoint` | function | `function getOtlpEndpoint(): string \| undefined` | Resolve the OTLP exporter endpoint, if set. | +| `getOtelEnvVars` | function | `function getOtelEnvVars(): Record` | Collect the resolved OTEL environment variables. | +| `OTEL_ENV_VARS` | const | `const OTEL_ENV_VARS` | Map of the supported OTEL environment variable names. | +| `TelemetryConfig` | interface | interface | Resolved telemetry configuration shape. | +| `TelemetryConfigDescription` | interface | interface | Human-readable configuration description. | ## Tracer (`@netscript/telemetry/tracer`) -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `getTracer` | function | `function getTracer(name: string, version: string): Tracer` | Get a named tracer at a version. | -| `getQueueTracer` | function | `function getQueueTracer(): Tracer` | Tracer for queue operations. | -| `getWorkerTracer` | function | `function getWorkerTracer(): Tracer` | Tracer for worker operations. | -| `getSchedulerTracer` | function | `function getSchedulerTracer(): Tracer` | Tracer for scheduler operations. | -| `getJobTracer` | function | `function getJobTracer(): Tracer` | Tracer for job operations. | -| `getSagaTracer` | function | `function getSagaTracer(): Tracer` | Tracer for saga operations. | -| `getSSETracer` | function | `function getSSETracer(): Tracer` | Tracer for SSE operations. | -| `getKVTracer` | function | `function getKVTracer(): Tracer` | Tracer for KV operations. | -| `createSpan` | function | `function createSpan(tracer, name, options): Span` | Create a span on the given tracer. | -| `withSpan` | function | `async function withSpan(tracer, name, fn, options): Promise` | Run an async function inside a span. | -| `withSpanSync` | function | `function withSpanSync(tracer, name, fn, options): T` | Run a sync function inside a span. | -| `getActiveSpan` | function | `function getActiveSpan(): Span \| undefined` | Get the currently active span. | -| `getActiveContext` | function | `function getActiveContext(): Context` | Get the currently active context. | -| `addSpanEvent` | function | `function addSpanEvent(span, name, attributes?): void` | Add an event to a span. | -| `setSpanAttributes` | function | `function setSpanAttributes(span, attributes): void` | Set attributes on a span. | -| `setSpanError` | function | `function setSpanError(span, message, error?): void` | Mark a span as errored. | -| `setSpanOk` | function | `function setSpanOk(span): void` | Mark a span status as OK. | -| `isTracingEnabled` | function | `function isTracingEnabled(): boolean` | Whether tracing is currently enabled. | -| `TracerNames` | const | `const TracerNames` | Canonical tracer names: QUEUE, WORKER, SCHEDULER, JOB, SAGA, SSE, KV, DEFAULT. | -| `SpanKind` | const / type alias | `const SpanKind` / `type SpanKind` | Span kind enum: INTERNAL, SERVER, CLIENT, PRODUCER, CONSUMER. | -| `SpanStatusCode` | const / type alias | `const SpanStatusCode` / `type SpanStatusCode` | Span status code enum: UNSET, OK, ERROR. | -| `Context`, `Span`, `Tracer`, `CreateSpanOptions`, `Link`, `Attributes` | interface / type alias | type aliases / interfaces | Core OpenTelemetry-compatible span and context types. | +| Symbol | Kind | Signature | Description | +| ---------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------ | +| `getTracer` | function | `function getTracer(name: string, version: string): Tracer` | Get a named tracer at a version. | +| `getQueueTracer` | function | `function getQueueTracer(): Tracer` | Tracer for queue operations. | +| `getWorkerTracer` | function | `function getWorkerTracer(): Tracer` | Tracer for worker operations. | +| `getSchedulerTracer` | function | `function getSchedulerTracer(): Tracer` | Tracer for scheduler operations. | +| `getJobTracer` | function | `function getJobTracer(): Tracer` | Tracer for job operations. | +| `getSagaTracer` | function | `function getSagaTracer(): Tracer` | Tracer for saga operations. | +| `getSSETracer` | function | `function getSSETracer(): Tracer` | Tracer for SSE operations. | +| `getKVTracer` | function | `function getKVTracer(): Tracer` | Tracer for KV operations. | +| `createSpan` | function | `function createSpan(tracer, name, options): Span` | Create a span on the given tracer. | +| `withSpan` | function | `async function withSpan(tracer, name, fn, options): Promise` | Run an async function inside a span. | +| `withSpanSync` | function | `function withSpanSync(tracer, name, fn, options): T` | Run a sync function inside a span. | +| `getActiveSpan` | function | `function getActiveSpan(): Span \| undefined` | Get the currently active span. | +| `getActiveContext` | function | `function getActiveContext(): Context` | Get the currently active context. | +| `addSpanEvent` | function | `function addSpanEvent(span, name, attributes?): void` | Add an event to a span. | +| `setSpanAttributes` | function | `function setSpanAttributes(span, attributes): void` | Set attributes on a span. | +| `setSpanError` | function | `function setSpanError(span, message, error?): void` | Mark a span as errored. | +| `setSpanOk` | function | `function setSpanOk(span): void` | Mark a span status as OK. | +| `isTracingEnabled` | function | `function isTracingEnabled(): boolean` | Whether tracing is currently enabled. | +| `TracerNames` | const | `const TracerNames` | Canonical tracer names: QUEUE, WORKER, SCHEDULER, JOB, SAGA, SSE, KV, DEFAULT. | +| `SpanKind` | const / type alias | `const SpanKind` / `type SpanKind` | Span kind enum: INTERNAL, SERVER, CLIENT, PRODUCER, CONSUMER. | +| `SpanStatusCode` | const / type alias | `const SpanStatusCode` / `type SpanStatusCode` | Span status code enum: UNSET, OK, ERROR. | +| `Context`, `Span`, `Tracer`, `CreateSpanOptions`, `Link`, `Attributes` | interface / type alias | type aliases / interfaces | Core OpenTelemetry-compatible span and context types. | ## Context (`@netscript/telemetry/context`) W3C trace-context propagation across job subprocesses and message headers. -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `withContext` | function | `function withContext(ctx, fn): T` | Run a sync function with the given context active. | -| `withContextAsync` | function | `async function withContextAsync(ctx, fn): Promise` | Run an async function with the given context active. | -| `contextWithSpan` | function | `function contextWithSpan(span, parentContext?): Context` | Build a context carrying the given span. | -| `getSpanFromContext` | function | `function getSpanFromContext(ctx): Span \| undefined` | Extract the span from a context. | -| `getTraceId` | function | `function getTraceId(ctx?): string \| undefined` | Get the trace id from a context. | -| `getSpanId` | function | `function getSpanId(ctx?): string \| undefined` | Get the span id from a context. | -| `hasActiveSpan` | function | `function hasActiveSpan(ctx?): boolean` | Whether a context carries an active span. | -| `injectContext` | function | `function injectContext(headers, ctx?): PropagationHeaders` | Inject context into propagation headers. | -| `extractContext` | function | `function extractContext(headers): Context` | Extract a context from propagation headers. | -| `createMessageHeaders` | function | `function createMessageHeaders(additionalHeaders): PropagationHeaders` | Build message headers with trace context. | -| `formatTraceparent` | function | `function formatTraceparent(spanContext): string` | Format a `traceparent` header value. | -| `parseTraceparent` | function | `function parseTraceparent(traceparent): ParsedTraceparent \| null` | Parse a `traceparent` header value. | -| `resolveParentContextFromHeaders` | function | `function resolveParentContextFromHeaders(headers?): Context` | Resolve a parent context from headers. | -| `resolveTraceContext` | function | `function resolveTraceContext(ctx?): SerializedTraceContext \| null` | Serialize the active trace context. | -| `resolveTraceContextFromSpan` | function | `function resolveTraceContextFromSpan(span): SerializedTraceContext` | Serialize trace context from a span. | -| `extractFromTraceContext` | function | `function extractFromTraceContext(traceContext): Context` | Rehydrate a context from a serialized payload. | -| `createJobTraceEnv` | function | `function createJobTraceEnv(ctx?): JobTraceEnv` | Build job subprocess env carrying trace context. | -| `extractJobTraceContext` | function | `function extractJobTraceContext(): Context \| null` | Extract trace context from the job subprocess env. | -| `JobTraceEnv`, `ParsedTraceparent`, `SerializedTraceContext` | interface | interfaces | Context-propagation payload shapes. | +| Symbol | Kind | Signature | Description | +| ------------------------------------------------------------ | --------- | ---------------------------------------------------------------------- | ---------------------------------------------------- | +| `withContext` | function | `function withContext(ctx, fn): T` | Run a sync function with the given context active. | +| `withContextAsync` | function | `async function withContextAsync(ctx, fn): Promise` | Run an async function with the given context active. | +| `contextWithSpan` | function | `function contextWithSpan(span, parentContext?): Context` | Build a context carrying the given span. | +| `getSpanFromContext` | function | `function getSpanFromContext(ctx): Span \| undefined` | Extract the span from a context. | +| `getTraceId` | function | `function getTraceId(ctx?): string \| undefined` | Get the trace id from a context. | +| `getSpanId` | function | `function getSpanId(ctx?): string \| undefined` | Get the span id from a context. | +| `hasActiveSpan` | function | `function hasActiveSpan(ctx?): boolean` | Whether a context carries an active span. | +| `injectContext` | function | `function injectContext(headers, ctx?): PropagationHeaders` | Inject context into propagation headers. | +| `extractContext` | function | `function extractContext(headers): Context` | Extract a context from propagation headers. | +| `createMessageHeaders` | function | `function createMessageHeaders(additionalHeaders): PropagationHeaders` | Build message headers with trace context. | +| `formatTraceparent` | function | `function formatTraceparent(spanContext): string` | Format a `traceparent` header value. | +| `parseTraceparent` | function | `function parseTraceparent(traceparent): ParsedTraceparent \| null` | Parse a `traceparent` header value. | +| `resolveParentContextFromHeaders` | function | `function resolveParentContextFromHeaders(headers?): Context` | Resolve a parent context from headers. | +| `resolveTraceContext` | function | `function resolveTraceContext(ctx?): SerializedTraceContext \| null` | Serialize the active trace context. | +| `resolveTraceContextFromSpan` | function | `function resolveTraceContextFromSpan(span): SerializedTraceContext` | Serialize trace context from a span. | +| `extractFromTraceContext` | function | `function extractFromTraceContext(traceContext): Context` | Rehydrate a context from a serialized payload. | +| `createJobTraceEnv` | function | `function createJobTraceEnv(ctx?): JobTraceEnv` | Build job subprocess env carrying trace context. | +| `extractJobTraceContext` | function | `function extractJobTraceContext(): Context \| null` | Extract trace context from the job subprocess env. | +| `JobTraceEnv`, `ParsedTraceparent`, `SerializedTraceContext` | interface | interfaces | Context-propagation payload shapes. | ## Attributes (`@netscript/telemetry/attributes`) Semantic attribute keys, span-name constants, and attribute builders. The TC-1..TC-14 checklist is in the [telemetry conventions](./convention/). -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `spanName` | function | `function spanName(base: string, suffix?: string): string` | Compose a namespaced span name. | -| `createJobAttributes` | function | `function createJobAttributes(job): Record` | Build job span attributes with deprecated bare aliases. | -| `createMessagingAttributes` | function | `function createMessagingAttributes(options): Record` | Build messaging span attributes. | -| `createSagaAttributes` | function | `function createSagaAttributes(saga): Record` | Build saga span attributes with deprecated bare aliases. | -| `createExecutionAttributes` | function | `function createExecutionAttributes(execution): Record` | Build execution lifecycle span attributes. | -| `createGenAiAttributes` | function | `function createGenAiAttributes(genai): Record` | Build GenAI semantic-convention attributes. | -| `createTriggerAttributes` | function | `function createTriggerAttributes(trigger): Record` | Build trigger span attributes. | -| `createTriggerFileAttributes` | function | `function createTriggerFileAttributes(payload): Record` | Build file-trigger span attributes. | -| `CacheAttributes` | const | `const CacheAttributes` | Cache-topology attribute-name constants for the published `netscript.cache.*` compatibility surface; the operation key is the shared `netscript.operation`. | -| `CacheOperations` | const | `const CacheOperations` | Logical span-name verbs: `cache.read`, `cache.write`, and `cache.invalidate`; promotion is a `cache.promote` event, not a fourth operation verb. | -| `CacheOperation` | type alias | `type CacheOperation` | Union of the logical cache-operation verbs in `CacheOperations`. | -| `CacheTiers` | const | `const CacheTiers` | Runtime-validated cache tiers: `l1`, `l2`, and `durable`. | -| `CacheTier` | type alias | `type CacheTier = 'l1' \| 'l2' \| 'durable'` | Bounded cache-tier identifier accepted by cache-topology attributes. | -| `CacheOutcomes` | const | `const CacheOutcomes` | Bounded results: `hit`, `miss`, `stale`, and `error`. An unknowable successful provider chain sets `topology_complete=false` and omits `outcome`; `error` is emitted only when the operation throws. | -| `CacheOutcome` | type alias | `type CacheOutcome = 'hit' \| 'miss' \| 'stale' \| 'error'` | Union of the bounded lookup and mutation outcomes in `CacheOutcomes`. | -| `CacheAttributeOptions` | type alias | `type CacheAttributeOptions` | Bounded operation, provider, namespace, tier, outcome, timing, loader, and topology facts accepted by the cache attribute builder; it has no cache-key field. | -| `createCacheAttributes` | function | `function createCacheAttributes(options: CacheAttributeOptions): TelemetryAttributeBuilderMap` | Build bounded cache-topology attributes. The API accepts no cache key, making raw-key leakage structurally impossible. | -| `TelemetryConventionChecklist` | const | `const TelemetryConventionChecklist` | TC-1..TC-14 conformance checklist. | -| `SpanNames` | const | `const SpanNames` | Canonical span-name constants for scheduler, queue, worker, job, saga, execution, RPC, GenAI, SSE, KV, and trigger spans. | -| `NetScriptAttributeDomains` | const | `const NetScriptAttributeDomains` | Single-root `netscript.*` proprietary attribute domains. | -| `NetScriptCorrelationAttributes` | const | `const NetScriptCorrelationAttributes` | Shared `netscript.correlation.id` attribute floor. | -| `ExecutionAttributes` / `NetScriptExecutionAttributes` | const | `const` | Deprecated execution aliases and canonical execution lifecycle attribute keys. | -| `JobAttributes` / `NetScriptJobAttributes` / `JobStatuses` / `JobTriggers` | const | const | Deprecated job aliases, canonical job keys, and enumerated status/trigger values. | -| `WorkerAttributes` | const | `const WorkerAttributes` | Worker attribute keys. | -| `SchedulerAttributes` | const | `const SchedulerAttributes` | Scheduler attribute keys. | -| `MessagingAttributes` / `MessagingOperations` / `MessagingSystems` | const | const | Messaging attribute keys and enumerated operations/systems. | -| `SagaAttributes` | const | `const SagaAttributes` | Saga attribute keys. | -| `GenAiAttributes` | const | `const GenAiAttributes` | GenAI semantic-convention attribute keys. | -| `KVAttributes` / `KVOperations` | const | const | KV attribute keys and operation values. | -| `SSEAttributes` | const | `const SSEAttributes` | SSE attribute keys. | -| `TriggerAttributes` | const | `const TriggerAttributes` | Trigger attribute keys. | +| Symbol | Kind | Signature | Description | +| -------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `spanName` | function | `function spanName(base: string, suffix?: string): string` | Compose a namespaced span name. | +| `createJobAttributes` | function | `function createJobAttributes(job): Record` | Build job span attributes with deprecated bare aliases. | +| `createMessagingAttributes` | function | `function createMessagingAttributes(options): Record` | Build messaging span attributes. | +| `createSagaAttributes` | function | `function createSagaAttributes(saga): Record` | Build saga span attributes with deprecated bare aliases. | +| `createExecutionAttributes` | function | `function createExecutionAttributes(execution): Record` | Build execution lifecycle span attributes. | +| `createGenAiAttributes` | function | `function createGenAiAttributes(genai): Record` | Build GenAI semantic-convention attributes. | +| `createTriggerAttributes` | function | `function createTriggerAttributes(trigger): Record` | Build trigger span attributes. | +| `createTriggerFileAttributes` | function | `function createTriggerFileAttributes(payload): Record` | Build file-trigger span attributes. | +| `CacheAttributes` | const | `const CacheAttributes` | Cache-topology attribute-name constants for the published `netscript.cache.*` compatibility surface; the operation key is the shared `netscript.operation`. | +| `CacheOperations` | const | `const CacheOperations` | Logical span-name verbs: `cache.read`, `cache.write`, and `cache.invalidate`; promotion is a `cache.promote` event, not a fourth operation verb. | +| `CacheOperation` | type alias | `type CacheOperation` | Union of the logical cache-operation verbs in `CacheOperations`. | +| `CacheTiers` | const | `const CacheTiers` | Runtime-validated cache tiers: `l1`, `l2`, and `durable`. | +| `CacheTier` | type alias | `type CacheTier = 'l1' \| 'l2' \| 'durable'` | Bounded cache-tier identifier accepted by cache-topology attributes. | +| `CacheOutcomes` | const | `const CacheOutcomes` | Bounded results: `hit`, `miss`, `stale`, and `error`. An unknowable successful provider chain sets `topology_complete=false` and omits `outcome`; `error` is emitted only when the operation throws. | +| `CacheOutcome` | type alias | `type CacheOutcome = 'hit' \| 'miss' \| 'stale' \| 'error'` | Union of the bounded lookup and mutation outcomes in `CacheOutcomes`. | +| `CacheAttributeOptions` | type alias | `type CacheAttributeOptions` | Bounded operation, provider, namespace, tier, outcome, timing, loader, and topology facts accepted by the cache attribute builder; it has no cache-key field. | +| `createCacheAttributes` | function | `function createCacheAttributes(options: CacheAttributeOptions): TelemetryAttributeBuilderMap` | Build bounded cache-topology attributes. The API accepts no cache key, making raw-key leakage structurally impossible. | +| `TelemetryConventionChecklist` | const | `const TelemetryConventionChecklist` | TC-1..TC-14 conformance checklist. | +| `SpanNames` | const | `const SpanNames` | Canonical span-name constants for scheduler, queue, worker, job, saga, execution, RPC, GenAI, SSE, KV, and trigger spans. | +| `NetScriptAttributeDomains` | const | `const NetScriptAttributeDomains` | Single-root `netscript.*` proprietary attribute domains. | +| `NetScriptCorrelationAttributes` | const | `const NetScriptCorrelationAttributes` | Shared `netscript.correlation.id` attribute floor. | +| `ExecutionAttributes` / `NetScriptExecutionAttributes` | const | `const` | Deprecated execution aliases and canonical execution lifecycle attribute keys. | +| `JobAttributes` / `NetScriptJobAttributes` / `JobStatuses` / `JobTriggers` | const | const | Deprecated job aliases, canonical job keys, and enumerated status/trigger values. | +| `WorkerAttributes` | const | `const WorkerAttributes` | Worker attribute keys. | +| `SchedulerAttributes` | const | `const SchedulerAttributes` | Scheduler attribute keys. | +| `MessagingAttributes` / `MessagingOperations` / `MessagingSystems` | const | const | Messaging attribute keys and enumerated operations/systems. | +| `SagaAttributes` | const | `const SagaAttributes` | Saga attribute keys. | +| `GenAiAttributes` | const | `const GenAiAttributes` | GenAI semantic-convention attribute keys. | +| `KVAttributes` / `KVOperations` | const | const | KV attribute keys and operation values. | +| `SSEAttributes` | const | `const SSEAttributes` | SSE attribute keys. | +| `TriggerAttributes` | const | `const TriggerAttributes` | Trigger attribute keys. | ## Instrumentation (`@netscript/telemetry/instrumentation`) @@ -173,27 +173,27 @@ with a required consumer `span`. Call `ctx.span.setAttribute('job.id', message.j callback to annotate that active span. Plain `MessageQueue` handlers stay compatible, and the shared `TracedMessageContext` keeps its optional span for other consumers. -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `startWorkerSpan` | function | `function startWorkerSpan(config): Span` | Start a worker span. | -| `createWorkerStopSpan` | function | `function createWorkerStopSpan(workerId, activeJobs): Span` | Span for worker shutdown. | -| `recordWorkerMetrics` | function | `function recordWorkerMetrics(span, metrics): void` | Record worker metrics on a span. | -| `traceJobExecution` | function | `async function traceJobExecution(options, fn): Promise` | Trace a job execution. | -| `createJobSpawnSpan` | function | `function createJobSpawnSpan(job, executionId): Span` | Span for spawning a job subprocess. | -| `createJobSubprocessEnv` | function | `function createJobSubprocessEnv(additionalEnv): Record` | Build the traced subprocess env. | -| `getJobTraceContext` | function | `function getJobTraceContext(): SerializedTraceContext \| null` | Read serialized trace context in a job. | -| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess. | -| `runTracedJob` | function | `async function runTracedJob(jobId, fn): Promise` | Wrap a job main with tracing. | -| `addJobStepEvent` | function | `function addJobStepEvent(stepName, attributes?): void` | Add a step event to the active job span. | -| `recordJobProgress` | function | `function recordJobProgress(current, total, unit): void` | Record job progress on the active span. | -| `startJobDispatchSpan` | function | `function startJobDispatchSpan(context, options)` | Start a job-dispatch span and propagation headers. | -| `traceJobDispatch` | function | `async function traceJobDispatch(context, fn, options): Promise` | Trace a job dispatch. | -| `isTracedQueue` | function | `function isTracedQueue(queue): queue is TracedQueue` | Type guard for a traced queue. | -| `TracedQueueMessageContext` | interface | interface | Consumer context with a guaranteed span, delivered by TracedQueue.listen. | -| `startSchedulerTickSpan` | function | `function startSchedulerTickSpan(context): Span` | Span for a scheduler tick. | -| `createSchedulerStartSpan`, `createSchedulerStopSpan` | function | functions returning `Span` | Spans for scheduler start/stop. | -| `createScheduleJobSpan`, `createUnscheduleJobSpan` | function | functions returning `Span` | Root spans for scheduling/unscheduling a job. | -| `recordCronJobRun`, `recordSchedulerReload` | function | functions returning `void` | Record scheduler run/reload outcomes. | +| Symbol | Kind | Signature | Description | +| ----------------------------------------------------- | --------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- | +| `startWorkerSpan` | function | `function startWorkerSpan(config): Span` | Start a worker span. | +| `createWorkerStopSpan` | function | `function createWorkerStopSpan(workerId, activeJobs): Span` | Span for worker shutdown. | +| `recordWorkerMetrics` | function | `function recordWorkerMetrics(span, metrics): void` | Record worker metrics on a span. | +| `traceJobExecution` | function | `async function traceJobExecution(options, fn): Promise` | Trace a job execution. | +| `createJobSpawnSpan` | function | `function createJobSpawnSpan(job, executionId): Span` | Span for spawning a job subprocess. | +| `createJobSubprocessEnv` | function | `function createJobSubprocessEnv(additionalEnv): Record` | Build the traced subprocess env. | +| `getJobTraceContext` | function | `function getJobTraceContext(): SerializedTraceContext \| null` | Read serialized trace context in a job. | +| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess. | +| `runTracedJob` | function | `async function runTracedJob(jobId, fn): Promise` | Wrap a job main with tracing. | +| `addJobStepEvent` | function | `function addJobStepEvent(stepName, attributes?): void` | Add a step event to the active job span. | +| `recordJobProgress` | function | `function recordJobProgress(current, total, unit): void` | Record job progress on the active span. | +| `startJobDispatchSpan` | function | `function startJobDispatchSpan(context, options)` | Start a job-dispatch span and propagation headers. | +| `traceJobDispatch` | function | `async function traceJobDispatch(context, fn, options): Promise` | Trace a job dispatch. | +| `isTracedQueue` | function | `function isTracedQueue(queue): queue is TracedQueue` | Type guard for a traced queue. | +| `TracedQueueMessageContext` | interface | interface | Consumer context with a guaranteed span, delivered by TracedQueue.listen. | +| `startSchedulerTickSpan` | function | `function startSchedulerTickSpan(context): Span` | Span for a scheduler tick. | +| `createSchedulerStartSpan`, `createSchedulerStopSpan` | function | functions returning `Span` | Spans for scheduler start/stop. | +| `createScheduleJobSpan`, `createUnscheduleJobSpan` | function | functions returning `Span` | Root spans for scheduling/unscheduling a job. | +| `recordCronJobRun`, `recordSchedulerReload` | function | functions returning `void` | Record scheduler run/reload outcomes. | ## Registry (`@netscript/telemetry/registry`) @@ -211,19 +211,19 @@ Instrumentation lifecycle registry, also re-exported from the root entrypoint. Tracing and error-handling plugins for the NetScript oRPC handler. -| Symbol | Kind | Signature | Description | -| --- | --- | --- | --- | -| `createTracingPlugin` | function | `function createTracingPlugin(options?): TracingPlugin` | Create the oRPC tracing plugin. | -| `TracingPlugin` | class | `class TracingPlugin` | oRPC tracing plugin. | -| `createErrorHandlingPlugin` | function | `function createErrorHandlingPlugin(options?): ErrorHandlingPlugin` | Create the oRPC error-handling plugin. | -| `ErrorHandlingPlugin` | class | `class ErrorHandlingPlugin` | oRPC error-handling plugin. | -| `createTraceContext` | function | `function createTraceContext(): TraceContext` | Create a handler-scoped trace context. | -| `addEvent` | function | `function addEvent(name, attributes?): void` | Add an event to the active handler span. | -| `setAttributes` | function | `function setAttributes(attributes): void` | Set attributes on the active handler span. | -| `getTraceId`, `getSpanId` | function | functions returning `string \| undefined` | Read the active handler trace/span id. | -| `TraceContext` | interface | interface | Handler-scoped trace context contract. | -| `TracingPluginOptions`, `ErrorHandlingPluginOptions` | interface | interfaces | Plugin options. | -| `ErrorContext`, `ErrorLogger` | interface | interfaces | Error plugin payload and logger contracts. | +| Symbol | Kind | Signature | Description | +| ---------------------------------------------------- | --------- | ------------------------------------------------------------------- | ------------------------------------------ | +| `createTracingPlugin` | function | `function createTracingPlugin(options?): TracingPlugin` | Create the oRPC tracing plugin. | +| `TracingPlugin` | class | `class TracingPlugin` | oRPC tracing plugin. | +| `createErrorHandlingPlugin` | function | `function createErrorHandlingPlugin(options?): ErrorHandlingPlugin` | Create the oRPC error-handling plugin. | +| `ErrorHandlingPlugin` | class | `class ErrorHandlingPlugin` | oRPC error-handling plugin. | +| `createTraceContext` | function | `function createTraceContext(): TraceContext` | Create a handler-scoped trace context. | +| `addEvent` | function | `function addEvent(name, attributes?): void` | Add an event to the active handler span. | +| `setAttributes` | function | `function setAttributes(attributes): void` | Set attributes on the active handler span. | +| `getTraceId`, `getSpanId` | function | functions returning `string \| undefined` | Read the active handler trace/span id. | +| `TraceContext` | interface | interface | Handler-scoped trace context contract. | +| `TracingPluginOptions`, `ErrorHandlingPluginOptions` | interface | interfaces | Plugin options. | +| `ErrorContext`, `ErrorLogger` | interface | interfaces | Error plugin payload and logger contracts. | ## Command telemetry @@ -232,11 +232,11 @@ a privacy-first adapter structurally compatible with `CommandTelemetryPort`. Reg name/version metadata (1–1024 unique pairs, names at most 120 characters) and pass it to the command executor. The attribute builders and closed vocabularies live in `@netscript/telemetry/attributes`. -| Span | Span kind | -| --- | --- | -| `command.execute` | INTERNAL | -| `command.outbox.relay` | INTERNAL | -| `command.outbox.publish` | PRODUCER | +| Span | Span kind | +| ------------------------ | --------- | +| `command.execute` | INTERNAL | +| `command.outbox.relay` | INTERNAL | +| `command.outbox.publish` | PRODUCER | - Publication makes native context active, so W3C injection can parent the consumer or create a deferred link. @@ -247,21 +247,29 @@ executor. The attribute builders and closed vocabularies live in `@netscript/tel - Messaging and saga identifier conventions keep their separate ownership; the command privacy policy supersedes their general correlation/exception floor. -| Symbol | Kind | Description | -| --- | --- | --- | -| `CommandSpanNames` | const | Fixed execute, relay lifecycle and publication names. | -| `CommandAttributes` | const | The eight identifier-free RFC command attribute keys. | -| `CommandOutcomes` | const | Closed applied/replayed/conflict/rejected/failed/cancelled values. | -| `CommandIdempotencyStates` | const | Closed claimed/replayed/not_requested/missing/mismatch/busy values. | -| `CommandIsolationLevels` | const | Store isolation enums plus default. | -| `CommandStoreProviders` | const | Bounded postgres/mssql/mysql/sqlite values. | -| `CommandErrorTypes` | const | Nine stable command failure kinds, excluding exception text. | -| `CommandTelemetryDefinition` | type alias | Static registered name/version pair. | -| `OtelCommandTelemetryStart` | type alias | Finite definition/provider/isolation/idempotency observation. | -| `OtelCommandTelemetryResult` | type alias | Finite outcome, counts and optional stable failure kind. | -| `commandStartAttributes` | function | Validate configured definition membership and select initial attributes. | -| `commandResultAttributes` | function | Validate completion and emit counts only for successful outcomes. | -| `createOtelCommandTelemetryPort` | function | Copy registrations and compose the structural executor adapter. | -| `CreateOtelCommandTelemetryPortOptions` | type alias | Construction-time registrations and optional native tracer. | -| `OtelCommandTelemetryPort` | interface | Execute, relay and publication wrappers invoking operations once. | -| `OtelCommandTelemetrySpan` | interface | Once-only finite completion observer. | +| Symbol | Kind | Description | +| --------------------------------------- | ---------- | ------------------------------------------------------------------------ | +| `CommandSpanNames` | const | Fixed execute, relay lifecycle and publication names. | +| `CommandAttributes` | const | The eight identifier-free RFC command attribute keys. | +| `CommandOutcomes` | const | Closed applied/replayed/conflict/rejected/failed/cancelled values. | +| `CommandIdempotencyStates` | const | Closed claimed/replayed/not_requested/missing/mismatch/busy values. | +| `CommandIsolationLevels` | const | Store isolation enums plus default. | +| `CommandStoreProviders` | const | Bounded postgres/mssql/mysql/sqlite values. | +| `CommandErrorTypes` | const | Nine stable command failure kinds, excluding exception text. | +| `CommandTelemetryDefinition` | type alias | Static registered name/version pair. | +| `OtelCommandTelemetryStart` | type alias | Finite definition/provider/isolation/idempotency observation. | +| `OtelCommandTelemetryResult` | type alias | Finite outcome, counts and optional stable failure kind. | +| `commandStartAttributes` | function | Validate configured definition membership and select initial attributes. | +| `commandResultAttributes` | function | Validate completion and emit counts only for successful outcomes. | +| `createOtelCommandTelemetryPort` | function | Copy registrations and compose the structural executor adapter. | +| `CreateOtelCommandTelemetryPortOptions` | type alias | Construction-time registrations and optional native tracer. | +| `OtelCommandTelemetryPort` | interface | Execute, relay and publication wrappers invoking operations once. | +| `OtelCommandTelemetrySpan` | interface | Once-only finite completion observer. | + +## SDK process ownership + +The opt-in `OtelSdkTracerProvider` observes SIGTERM to start bounded SDK shutdown and removes its +signal listeners before awaiting exporters. It does not terminate the process or select an exit +code. NetScript service and child runtimes own termination after their work and resource drains. +Standalone SDK embedders must compose a runtime or install their own signal/exit policy; explicit +`await provider.shutdown()` remains the reliable awaited shutdown path. diff --git a/packages/plugin/README.md b/packages/plugin/README.md index 9ffe75d288..3e65931bf1 100644 --- a/packages/plugin/README.md +++ b/packages/plugin/README.md @@ -178,15 +178,27 @@ To extend storage, implement the synchronous `ChildRestartHistoryPort` and call termination cannot skip a pending accounting write. Read this section as the contributor entry point, then run the generated-process regressions in `tests/health/generated-crash-loop_test.ts`. -Generated workers, triggers, and sagas glue starts the health listener before bootstrap and keeps a -failed child observable during a one-second grace period before exiting nonzero. These processes run -under their service identity without an app or owner session. AppHost probe generation and -doctor/MCP aggregation consume this contract in subsequent slices of #1366. - -Fatal bootstrap causes are logged to server stderr and set exit code 1. The process retains a red -health response for one second, then closes its listener and exits; it does not require an operator -signal. PORT selects the health listener port; without it, Deno binds an ephemeral port on its -default interface. Rule-based AppHost port wiring and probes remain a subsequent slice of #1366. +Generated workers, triggers, and sagas glue starts the health listener before bootstrap. The +listener binds `127.0.0.1` by default. `PORT` selects the port; without it, the operating system +assigns an ephemeral port. Pass `ChildHealthProcessOptions.hostname: '0.0.0.0'` when container +health checks must reach the listener from another network namespace. + +On a stop signal, `runChildHealthProcess` gives work 30 seconds to drain and reserves five more +seconds for `onShutdown` resource callbacks and the health listener. `drainTimeoutMs` bounds the +whole shutdown (default `35_000`); `cleanupTimeoutMs` reserves part of that total (default +`min(5_000, drainTimeoutMs / 5)`). Every cleanup is attempted even if work or another cleanup hangs. +Generated roles close the shared KV/Redis connection with `closeKv()` and dispose database clients +actually acquired by the host bootstrap, without opening unused clients during shutdown. + +Exit codes are `0` for a clean drain, `1` for a fatal runtime or cleanup failure, and `2` when work +or cleanup exceeds its deadline. Fatal bootstrap causes are logged to stderr and remain visible as +red health for one second before shutdown begins. `exitOnShutdown: false` leaves termination to an +embedding host: clean shutdown returns and failures reject with `PluginError`. + +The optional `PluginServiceContext.dispose` callback belongs to the host. The context factory +memoizes it but never closes lazy KV or database accessors implicitly. A service signal runs that +callback in the reserved cleanup phase. Manual service stop and external cancellation leave +process-owned disposal to the embedding host. ## Public surface diff --git a/packages/plugin/src/presentation/run-child-health-process.ts b/packages/plugin/src/presentation/run-child-health-process.ts index 7b95d09c0c..5de4e1f56f 100644 --- a/packages/plugin/src/presentation/run-child-health-process.ts +++ b/packages/plugin/src/presentation/run-child-health-process.ts @@ -7,6 +7,13 @@ import { FileChildRestartHistory } from '../adapters/file-child-restart-history. /** * Process health composition, including optional single-owner restart history. * + * The listener binds 127.0.0.1 by default; hostname overrides the bind address. + * Shutdown allows 35 seconds total by default: 30 seconds for work, with five + * seconds reserved for resource cleanup and the health listener. Cleanup callbacks + * run even when work times out. Fatal health remains visible for one second before + * this budget starts. Exit codes are 0 for a clean drain, 1 for failure and 2 for + * any shutdown deadline. Set exitOnShutdown to false when a host owns termination. + * * @example * ```ts * import type { ChildHealthProcessOptions } from '@netscript/plugin/health'; diff --git a/packages/plugin/src/presentation/run-child-health-process_exit_test.ts b/packages/plugin/src/presentation/run-child-health-process_exit_test.ts index d9fafb6520..a30cbc4603 100644 --- a/packages/plugin/src/presentation/run-child-health-process_exit_test.ts +++ b/packages/plugin/src/presentation/run-child-health-process_exit_test.ts @@ -14,7 +14,9 @@ for (const hangs of [false, true]) { ` import '@netscript/kv/redis'; import { getKv, closeKv } from '@netscript/kv'; - import { runChildHealthProcess } from '@netscript/plugin/health'; + import { runChildHealthProcess } from ${ + JSON.stringify(new URL('./run-child-health-process.ts', import.meta.url).href) + }; await runChildHealthProcess(async (health, signal) => { await (await getKv({ provider: 'redis', redisUrl: Deno.env.get('NETSCRIPT_TEST_REDIS_URL'), skipServiceDiscovery: true })).get(['shutdown-probe']); health.registryLoaded(); health.dependenciesReady(); health.running(); diff --git a/packages/plugin/src/presentation/run-child-health-process_test.ts b/packages/plugin/src/presentation/run-child-health-process_test.ts index 58ed838a70..4df994cc52 100644 --- a/packages/plugin/src/presentation/run-child-health-process_test.ts +++ b/packages/plugin/src/presentation/run-child-health-process_test.ts @@ -129,7 +129,9 @@ for (const hostname of [undefined, '0.0.0.0']) { args: [ 'eval', ` - import { runChildHealthProcess } from '@netscript/plugin/health'; + import { runChildHealthProcess } from ${ + JSON.stringify(new URL('./run-child-health-process.ts', import.meta.url).href) + }; const serve = Deno.serve; let address; Deno.serve = (...args) => { const server = serve(...args); address = server.addr; return server; }; diff --git a/packages/service/README.md b/packages/service/README.md index c9e862663a..382fdbac9a 100644 --- a/packages/service/README.md +++ b/packages/service/README.md @@ -154,12 +154,13 @@ replaces that default; matched contract access declarations still take precedenc entries throw `TypeError` when middleware is constructed, before requests or a listener. `OPTIONS` is not an exact anonymous method; configure `withCors()` for native preflight handling. -Health is now installed during `build()`, after authentication and body limits. -Middleware registered with `use()` also runs before health, even when added after `withHealth()`. A custom nonempty legacy list excluding `/health` -previously let health GET/HEAD return 200 by registration order; a rejecting authenticator now -returns 401. Add `'/health'` to retain the prefix capability, or use the six exact entries above. -Omitted, empty and `['/health']` lists preserve public health. Configure health checks before -`build()`; health checks snapshot when installed, while readiness checks retain their live array. +Health is now installed during `build()`, after authentication and body limits. Middleware +registered with `use()` also runs before health, even when added after `withHealth()`. A custom +nonempty legacy list excluding `/health` previously let health GET/HEAD return 200 by registration +order; a rejecting authenticator now returns 401. Add `'/health'` to retain the prefix capability, +or use the six exact entries above. Omitted, empty and `['/health']` lists preserve public health. +Configure health checks before `build()`; health checks snapshot when installed, while readiness +checks retain their live array. ## CORS migration (breaking in 0.0.8) @@ -218,6 +219,24 @@ and a real browser session round trip are follow-up scope of ## Runtime shutdown +A service started through `serve()` owns its installed OS signal handlers by default. After a signal +it drains requests and shutdown hooks, closes shared KV/Redis and the database clients registered by +`withDatabase()`, then exits explicitly: `0` clean, `1` failed, `2` timed out. Database aliases are +deduplicated by object identity. `defineService()` and `createPluginService()` inherit this behavior +from the raw builder. + +`drainTimeoutMs` is the total shutdown budget (default `30_000` ms). Process-owned signals reserve +`min(5_000, drainTimeoutMs / 5)` for resource cleanup, leaving 25 seconds of work drain and five +seconds of cleanup at the defaults. `cleanupTimeoutMs` changes that reserved portion without +extending the total. `onCleanup` supplies additional resource callbacks that are attempted even if a +work-drain hook hangs. When a callback already disposes the database, set +`disposeDatabaseOnSignal: false` to avoid also invoking the automatic database disposer. + +`running.stop()` and an external `signal` stop the listener without terminating the host or closing +process-owned shared resources. For multiple embedded runtimes, use `handleSignals: false` and one +host-owned signal handler, or `exitOnSignal: false` to retain process ownership. Register any +host-owned manual-stop teardown explicitly. + Compose every in-process runtime behind one bounded shutdown handle without replacing its own drain: ```ts @@ -334,8 +353,7 @@ is raised while the contract is traversed, not on the first request. A raw route added with `.route(method, path, handler)` under the guarded prefix matches no procedure, so an authenticated caller receives 404 `procedure_not_found` with message -`authz.no-contract-procedure` until it is declared. Declare it with -`rawRoutes`: +`authz.no-contract-procedure` until it is declared. Declare it with `rawRoutes`: ```ts import { createContractAuthorizer } from '@netscript/service/auth'; @@ -356,9 +374,9 @@ that overlaps the REST or RPC projection. ### Unknown and retired procedures -With `createContractAuthorizer()`, an authenticated request under a guarded prefix that matches -no served procedure returns HTTP 404 with a stable machine-readable `code`. Apps can declare -removed endpoints through `retiredPaths` to return HTTP 410 instead: +With `createContractAuthorizer()`, an authenticated request under a guarded prefix that matches no +served procedure returns HTTP 404 with a stable machine-readable `code`. Apps can declare removed +endpoints through `retiredPaths` to return HTTP 410 instead: ```ts import { createContractAuthorizer, PROCEDURE_ERROR_CODES } from '@netscript/service/auth'; @@ -372,33 +390,33 @@ const authorizer = createContractAuthorizer(OrdersContractV1, { const upgradeCode = PROCEDURE_ERROR_CODES.RETIRED; // 'procedure_retired' ``` -| Authenticated request | HTTP status | JSON body | -| --- | --- | --- | -| Unknown guarded procedure | 404 | `{ "error": "NOT_FOUND", "message": "authz.no-contract-procedure", "code": "procedure_not_found" }` | -| Declared retired path | 410 | `{ "error": "GONE", "message": "authz.procedure-retired", "code": "procedure_retired" }` | -| Existing procedure with insufficient permission | 403 | Existing `{ "error": "FORBIDDEN", "message": "authz.missing-scope:…" }` shape | +| Authenticated request | HTTP status | JSON body | +| ----------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------- | +| Unknown guarded procedure | 404 | `{ "error": "NOT_FOUND", "message": "authz.no-contract-procedure", "code": "procedure_not_found" }` | +| Declared retired path | 410 | `{ "error": "GONE", "message": "authz.procedure-retired", "code": "procedure_retired" }` | +| Existing procedure with insufficient permission | 403 | Existing `{ "error": "FORBIDDEN", "message": "authz.missing-scope:…" }` shape | Missing or invalid credentials still receive the existing 401 `UNAUTHORIZED` response, with no procedure code. Availability is disclosed only after authentication. Retired declarations require authentication even outside `protect` and inside `allowAnonymous`; they never bypass authentication. -Existing public contract procedures remain public. Existing procedures, internal audience guards -and declared raw routes take precedence over retired declarations, so retirement cannot mask a +Existing public contract procedures remain public. Existing procedures, internal audience guards and +declared raw routes take precedence over retired declarations, so retirement cannot mask a permission check. Fallback authorizers cannot revive missing or retired procedures. Each declaration is a canonical, case-sensitive, mounted absolute path, matched for every method. Query strings are ignored. Trailing slashes, encoded spellings, siblings and descendants do not match. Parameters, wildcards, percent encoding, dot segments, repeated separators, backslashes, -whitespace, query/fragment syntax and duplicates are rejected during construction. Declare REST, -RPC and alias paths separately. For a parameterized removed route, undeclared concrete paths still -get 404 under guarded coverage; parameterized retirement is not supported. Undeclared paths outside +whitespace, query/fragment syntax and duplicates are rejected during construction. Declare REST, RPC +and alias paths separately. For a parameterized removed route, undeclared concrete paths still get +404 under guarded coverage; parameterized retirement is not supported. Undeclared paths outside protected coverage retain their existing behavior. -HTTP clients can branch on the JSON `code`: `procedure_retired` is the application's signal to -show “client too old” or request an upgrade; `procedure_not_found` means no procedure is served at -that guarded path. These pre-dispatch middleware errors are not contract-defined oRPC errors; -clients reading raw HTTP responses should inspect the JSON code rather than parse `message`. -`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are exported from both the package -root and `@netscript/service/auth`. `AuthzDecision.code` carries the optional typed failure, and +HTTP clients can branch on the JSON `code`: `procedure_retired` is the application's signal to show +“client too old” or request an upgrade; `procedure_not_found` means no procedure is served at that +guarded path. These pre-dispatch middleware errors are not contract-defined oRPC errors; clients +reading raw HTTP responses should inspect the JSON code rather than parse `message`. +`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are exported from both the package root +and `@netscript/service/auth`. `AuthzDecision.code` carries the optional typed failure, and `ProcedurePolicyResolution.retired` marks a matched retired declaration for the shared auth stages. Overlay authorizers never set that marker and retain their existing fallback behavior. diff --git a/packages/telemetry/README.md b/packages/telemetry/README.md index 215347ee25..c5ef3a7612 100644 --- a/packages/telemetry/README.md +++ b/packages/telemetry/README.md @@ -84,12 +84,12 @@ console.log(total, snapshot?.name, snapshot?.attributes['netscript.job.source']) ``` Incoming queue messages and trigger deliveries follow their own `traceparent` and `tracestate`. -Without a valid carrier, each delivery starts a fresh trace instead of inheriting the shared worker's -active span. `extractContext` and `resolveParentContextFromHeaders` apply this rule; nested local -operations use the active context so their spans stay beneath the current job. +Without a valid carrier, each delivery starts a fresh trace instead of inheriting the shared +worker's active span. `extractContext` and `resolveParentContextFromHeaders` apply this rule; nested +local operations use the active context so their spans stay beneath the current job. -To continue a job execution's trace inside a spawned job subprocess, extract the propagated context at -the start of the job script: +To continue a job execution's trace inside a spawned job subprocess, extract the propagated context +at the start of the job script: ```typescript import { initJobTracing } from '@netscript/telemetry'; @@ -144,8 +144,8 @@ One logical operation uses one INTERNAL span. `cache.lookup`, `cache.write`, `ca `write_through` distinguishes propagation/promotion; `inflight_joined` identifies a trace that awaited work owned elsewhere; and `topology_complete=false` makes missing provider evidence visible. For an unowned provider, a successful operation has `topology_complete=false` with no `outcome`; -`outcome=error` appears only when the operation throws. -Stale background completion may use one captured-context `cache.write` follow-up span. +`outcome=error` appears only when the operation throws. Stale background completion may use one +captured-context `cache.write` follow-up span. ## Public surface @@ -198,8 +198,8 @@ JSR with cryptographically verified provenance. ### Privacy-first command tracing -Import `createOtelCommandTelemetryPort` from `@netscript/telemetry/commands` and pass the -result as the executor's `telemetry` option. Supply the static command definitions at construction: +Import `createOtelCommandTelemetryPort` from `@netscript/telemetry/commands` and pass the result as +the executor's `telemetry` option. Supply the static command definitions at construction: ```ts import { createOtelCommandTelemetryPort } from '@netscript/telemetry/commands'; @@ -208,13 +208,13 @@ const telemetry = createOtelCommandTelemetryPort({ }); ``` -The adapter copies 1–1024 unique name/version pairs. Names follow command definition syntax and -are at most 120 characters; versions are positive safe integers. `CommandSpanNames`, +The adapter copies 1–1024 unique name/version pairs. Names follow command definition syntax and are +at most 120 characters; versions are positive safe integers. `CommandSpanNames`, `CommandAttributes`, `commandStartAttributes`, and `commandResultAttributes` are exported by -`@netscript/telemetry/attributes`. Closed provider/isolation/outcome/idempotency/failure vocabularies -are validated at runtime. Audit/outbox counts range from zero to 64 and appear only for applied or -replayed completions. Malformed observations and throwing telemetry observers preserve operation -result/error identity and never retry an operation. +`@netscript/telemetry/attributes`. Closed provider/isolation/outcome/idempotency/failure +vocabularies are validated at runtime. Audit/outbox counts range from zero to 64 and appear only for +applied or replayed completions. Malformed observations and throwing telemetry observers preserve +operation result/error identity and never retry an operation. `command.execute` is INTERNAL beneath the active request. `traceRelay` records the fixed INTERNAL `command.outbox.relay` lifecycle; `tracePublish` records PRODUCER `command.outbox.publish` and makes @@ -222,15 +222,23 @@ that span active for the existing W3C propagation helpers. The consumer owns its span or a deferred/batch root span linked to the publication. These wrappers perform no relay or queue work. -Command spans expose only the eight RFC command attributes plus optional stable `error.type`. -There are no exception events, error messages/stacks, metric instruments, or arbitrary attribute -spreads. Raw actors, scope, keys/digests, hashes, row identities, payloads/responses, version tokens, +Command spans expose only the eight RFC command attributes plus optional stable `error.type`. There +are no exception events, error messages/stacks, metric instruments, or arbitrary attribute spreads. +Raw actors, scope, keys/digests, hashes, row identities, payloads/responses, version tokens, correlation IDs, and topic/destination strings are excluded. Configured static definition versions are distinct from private optimistic version tokens. This deliberate RFC 0003 ownership decision is stricter than neighboring messaging and saga conventions. Existing `netscript.correlation.id` and `netscript.idempotency.key` remain owned by -those domains. Their presence does not authorize command emission; command traces join through -span context. Command policy also overrides the general correlation-floor and exception-recording +those domains. Their presence does not authorize command emission; command traces join through span +context. Command policy also overrides the general correlation-floor and exception-recording checklist for this domain. No additional permissions are needed by the adapter; the selected exporter retains its own documented requirements. + +## SDK signal ownership + +The opt-in `OtelSdkTracerProvider` observes SIGTERM to start bounded SDK shutdown and removes its +signal listeners before awaiting exporters. It does not terminate the process or select an exit +code. NetScript service and child runtimes own termination after their work and resource drains. +Standalone SDK embedders must compose a runtime or install their own signal/exit policy; explicit +`await provider.shutdown()` remains the reliable awaited shutdown path. From 20229b884bf737e733d0cca7a7cf2e7edaf368b1 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 18:47:48 +0100 Subject: [PATCH 09/19] docs(runtime): retain existing reference layout around shutdown additions --- docs/site/observability/telemetry.md | 429 ++++++++-------- docs/site/reference/plugin/index.md | 425 ++++++++-------- docs/site/reference/service/index.md | 660 +++++++++++++------------ docs/site/reference/telemetry/index.md | 346 ++++++------- packages/service/README.md | 55 ++- packages/telemetry/README.md | 40 +- 6 files changed, 958 insertions(+), 997 deletions(-) diff --git a/docs/site/observability/telemetry.md b/docs/site/observability/telemetry.md index f87bc48f05..ba4d711e4d 100644 --- a/docs/site/observability/telemetry.md +++ b/docs/site/observability/telemetry.md @@ -7,24 +7,23 @@ order: 1 # Telemetry & logging -This page covers what NetScript traces and logs for you, the `@netscript/telemetry` surface for -adding your own spans, and the two places to read the results: the Aspire dashboard and a typed -query port. +This page covers what NetScript traces and logs for you, the `@netscript/telemetry` surface for adding +your own spans, and the two places to read the results: the Aspire dashboard and a typed query port. Every service and plugin runtime is wired for **OpenTelemetry**. Services serve their RPC handlers with trace-context propagation (first-party oRPC and Hono instrumentation), the worker runtime wraps job dispatch, execution, scheduling, subprocess hand-off and task execution in spans, and structured -logs flow through the framework `logger`. A single W3C `traceparent` groups a cross-process flow -into **one distributed trace**. The Aspire dashboard collects OTLP traces, metrics and structured -logs from every resource in the app graph as soon as you run `aspire start`; you don't stand up -Jaeger, Grafana or a log shipper. "Did the change work?" becomes a trace you open, or query from -code, instead of four console logs you correlate by eye. - -{{ comp.diagram({ src: "/assets/diagrams/otel-traceparent.svg", alt: "A W3C traceparent header -propagates from a service request through the worker runtime into a subprocess and across a saga -boundary, keeping every span under one trace id.", caption: "Trace-context propagation: a single -traceparent (W3C) flows service → worker → subprocess → saga, so spans from every runtime join one -distributed trace in Aspire." }) }} +logs flow through the framework `logger`. A single W3C `traceparent` groups a cross-process flow into +**one distributed trace**. The Aspire dashboard collects OTLP traces, metrics and structured logs from +every resource in the app graph as soon as you run `aspire start`; you don't stand up Jaeger, Grafana +or a log shipper. "Did the change work?" becomes a trace you open, or query from code, instead of four +console logs you correlate by eye. + +{{ comp.diagram({ + src: "/assets/diagrams/otel-traceparent.svg", + alt: "A W3C traceparent header propagates from a service request through the worker runtime into a subprocess and across a saga boundary, keeping every span under one trace id.", + caption: "Trace-context propagation: a single traceparent (W3C) flows service → worker → subprocess → saga, so spans from every runtime join one distributed trace in Aspire." +}) }} > [!IMPORTANT] > The dashboard and the OTLP collector come up with the orchestrator. Run @@ -44,8 +43,8 @@ Where many producers feed one consumer, such as a fan-in into a durable-streams consumer span shows exactly which upstream flows fed it. AI workloads use the same spine. Spans follow the upstream `gen_ai.*` semantic conventions (through -`createGenAiAttributes` in `@netscript/telemetry/attributes`), so a traced agent turn shows the -model call, the tool calls and the durable write it produced, step by step, on one tree. +`createGenAiAttributes` in `@netscript/telemetry/attributes`), so a traced agent turn shows the model +call, the tool calls and the durable write it produced, step by step, on one tree. ## Ports, adapters and attributes @@ -53,8 +52,8 @@ model call, the tool calls and the durable write it produced, step by step, on o connection stats) and logs, all over the same OTLP export. Application and runtime code program against the port contracts in `@netscript/telemetry/otel`: `TracerProviderPort`, `MeterPort`, `PropagatorPort`, `SpanLinkPort` and `TelemetryQueryPort`. The zero-dependency default adapter, -`OtelDenoTracerProvider`, binds to Deno's built-in OTLP exporter through `OTEL_DENO=true`. The -opt-in `OtelSdkTracerProvider` serves apps that bring the OpenTelemetry JS SDK and also enables +`OtelDenoTracerProvider`, binds to Deno's built-in OTLP exporter through `OTEL_DENO=true`. The opt-in +`OtelSdkTracerProvider` serves apps that bring the OpenTelemetry JS SDK and also enables attribute-preserving span links. The opt-in `OtelSdkTracerProvider` observes SIGTERM to start bounded SDK shutdown and removes its @@ -63,6 +62,7 @@ code. NetScript service and child runtimes own termination after their work and Standalone SDK embedders must compose a runtime or install their own signal/exit policy; explicit `await provider.shutdown()` remains the reliable awaited shutdown path. + Attribute names follow one convention: upstream semconv keys (`rpc.*`, `messaging.*`, `gen_ai.*`, `server.*`) wherever OpenTelemetry defines them, and NetScript-owned keys under the single proprietary root `netscript.*`. Correlated spans share `netscript.correlation.id`. The @@ -72,27 +72,27 @@ framework emits from what is a scaffold stub. ## What you get out of the box -| Signal | What you get | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Structured logging | `@netscript/logger` gives every service and plugin a level-aware structured logger. Declare it in `netscript.config.ts` (`logging: { level: 'info', format: 'text' }`); output is text or JSON and filterable in the dashboard. | -| Traces | Service request paths propagate W3C trace context, and the worker runtime traces the job lifecycle (see the next section). | -| OTLP export and dashboard | The generated AppHost configures an OTLP endpoint and the Aspire dashboard, so traces, metrics and logs from every resource land in one place with no collector to deploy. | -| Browser console logs | Generated app resources call `withBrowserLogs()` (the AppHost pins `Aspire.Hosting.Browsers`). A Fresh/Vite app's browser console output, including a client-side `TypeError` an island throws, appears in that resource's **Console logs** in the dashboard, correlated with the server-side spans of the same request. | +| Signal | What you get | +| --- | --- | +| Structured logging | `@netscript/logger` gives every service and plugin a level-aware structured logger. Declare it in `netscript.config.ts` (`logging: { level: 'info', format: 'text' }`); output is text or JSON and filterable in the dashboard. | +| Traces | Service request paths propagate W3C trace context, and the worker runtime traces the job lifecycle (see the next section). | +| OTLP export and dashboard | The generated AppHost configures an OTLP endpoint and the Aspire dashboard, so traces, metrics and logs from every resource land in one place with no collector to deploy. | +| Browser console logs | Generated app resources call `withBrowserLogs()` (the AppHost pins `Aspire.Hosting.Browsers`). A Fresh/Vite app's browser console output, including a client-side `TypeError` an island throws, appears in that resource's **Console logs** in the dashboard, correlated with the server-side spans of the same request. | ## Plugin HTTP request logging First-party plugin API services (workers, streams, auth, sagas and triggers) emit routine `HTTP request started` and successful `HTTP request completed` records at **Debug** by default. -Internal service traffic is frequent; keeping these pairs below Information leaves application logs -easier to scan. Each factory accepts optional `requestLevel` and `responseLevel` fields, with the -same `'debug' | 'info'` values as the native `@netscript/service` logger middleware. Each omitted -field independently defaults to `'debug'`. +Internal service traffic is frequent; keeping these pairs below Information leaves application +logs easier to scan. Each factory accepts optional `requestLevel` and `responseLevel` fields, +with the same `'debug' | 'info'` values as the native `@netscript/service` logger middleware. +Each omitted field independently defaults to `'debug'`. Pass these fields in the existing options argument to `startWorkersService(context, options)`, `startStreamsService(options)`, `createTriggersService(context, options)` or -`startTriggersService(options)`. The legacy workers, auth and sagas default factories accept an -optional second options argument after their host context. Legacy streams startup uses the Debug -defaults; use `startStreamsService` when the host needs to configure them. +`startTriggersService(options)`. The legacy workers, auth and sagas default factories accept +an optional second options argument after their host context. Legacy streams startup uses the +Debug defaults; use `startStreamsService` when the host needs to configure them. ```ts import { startStreamsService } from '@netscript/plugin-streams/service'; @@ -105,11 +105,11 @@ await startStreamsService({ ``` These options forward through `createPluginService`'s existing `logger` configuration into -`ServiceBuilder.withLogger()`. They select record severity; the process logging threshold still -decides which records are retained. Configure the plugin process at Debug to see its Debug records. -The native middleware continues skipping health probe paths and logging 4xx/5xx responses at -Warning; failures are not quieted by the new defaults. Ordinary service builder logging retains its -Information defaults unless the caller supplies levels to `.withLogger()`. +`ServiceBuilder.withLogger()`. They select record severity; the process logging threshold +still decides which records are retained. Configure the plugin process at Debug to see its +Debug records. The native middleware continues skipping health probe paths and logging 4xx/5xx +responses at Warning; failures are not quieted by the new defaults. Ordinary service builder +logging retains its Information defaults unless the caller supplies levels to `.withLogger()`. ## What is traced automatically @@ -117,27 +117,25 @@ The `@netscript/telemetry` instrumentation is wired into the worker dispatcher, scheduler, so every job run produces spans with attributes, durations, status and lifecycle events without scaffold changes. -{{ comp.apiTable({ caption: "Automatic worker traces (emitted by the runtime — see -/reference/telemetry/)", rows: [ { name: "traceJobExecution", type: "span", desc: "Wraps each job's -execution with attributes, duration, status, and job.started / job.completed / job.failed / -job.exception events. Emitted by the dispatcher." }, { name: "recordJobProgress", type: "event", -desc: "job.progress events carrying current / total / unit — the runtime records real progress as -the job advances." }, { name: "addJobStepEvent", type: "event", desc: "job.step.* events for each -step the runtime walks through." }, { name: "scheduler spans", type: "span", desc: -"createSchedulerStartSpan / createScheduleJobSpan / startSchedulerTickSpan / recordCronJobRun — cron -and schedule dispatch are traced end to end." }, { name: "subprocess traceparent", type: "context", -desc: "The dispatcher injects W3C traceparent / tracestate into the subprocess env so out-of-process -job runs continue the same trace (initJobTracing / runTracedJob / createJobSubprocessEnv)." }, { -name: "task.execute", type: "span", desc: "The multi-runtime task executor wraps each task run in a -task.execute span — polyglot and TS tasks alike show up in the trace tree." } ] }) }} +{{ comp.apiTable({ + caption: "Automatic worker traces (emitted by the runtime — see /reference/telemetry/)", + rows: [ + { name: "traceJobExecution", type: "span", desc: "Wraps each job's execution with attributes, duration, status, and job.started / job.completed / job.failed / job.exception events. Emitted by the dispatcher." }, + { name: "recordJobProgress", type: "event", desc: "job.progress events carrying current / total / unit — the runtime records real progress as the job advances." }, + { name: "addJobStepEvent", type: "event", desc: "job.step.* events for each step the runtime walks through." }, + { name: "scheduler spans", type: "span", desc: "createSchedulerStartSpan / createScheduleJobSpan / startSchedulerTickSpan / recordCronJobRun — cron and schedule dispatch are traced end to end." }, + { name: "subprocess traceparent", type: "context", desc: "The dispatcher injects W3C traceparent / tracestate into the subprocess env so out-of-process job runs continue the same trace (initJobTracing / runTracedJob / createJobSubprocessEnv)." }, + { name: "task.execute", type: "span", desc: "The multi-runtime task executor wraps each task run in a task.execute span — polyglot and TS tasks alike show up in the trace tree." } + ] +}) }} ## Enable tracing & see a span Tracing turns on from the **environment**: `@netscript/telemetry/config` resolves a -`TelemetryConfig` from the standard `OTEL_*` variables, and the Aspire AppHost sets them for you. -Run `aspire start`, trigger any job, and open **Traces** in the dashboard: you see the dispatch -span, the execution span, progress and step events and, for subprocess or polyglot tasks, the trace -continued across the process boundary. +`TelemetryConfig` from the standard `OTEL_*` variables, and the Aspire AppHost sets them for you. Run +`aspire start`, trigger any job, and open **Traces** in the dashboard: you see the dispatch span, the +execution span, progress and step events and, for subprocess or polyglot tasks, the trace continued +across the process boundary. > [!NOTE] > Locally, Aspire provisions the OTLP collector and the dashboard and injects the `OTEL_*` variables @@ -145,34 +143,15 @@ continued across the process boundary. > profile uses `localhost:0`), so use the URL Aspire prints. The AppHost injects the allocated > collector endpoint into resources; no fixed dashboard or OTLP port is required. -`netscript.config.ts` declares the logging contract; there is no `defineTelemetry()` call. At -runtime you can print what telemetry resolved: +`netscript.config.ts` declares the logging contract; there is no `defineTelemetry()` call. At runtime +you can print what telemetry resolved: -{{ comp.codeBlock({ lang: "ts", code: "// netscript.config.ts — declare the structured-logging -contract for the workspace.\n// Tracing itself is enabled by OTEL_* env vars (the Aspire AppHost -sets these); the\n// config package reads them — there is no defineTelemetry() call to make.\nimport -{ defineConfig } from '@netscript/config';\n\nexport default defineConfig({\n name: 'my-app',\n -version: '1.0.0',\n logging: { level: 'info', format: 'text' }, // level: debug|info|warn|error\n -plugins: ['./plugins/workers/mod.ts'],\n});\n\n// Anywhere in app code you can inspect what -telemetry resolved (log-safe, redacted):\nimport { describeTelemetryConfig, isTelemetryEnabled } -from '@netscript/telemetry/config';\nif (isTelemetryEnabled()) -console.log(describeTelemetryConfig());\n// → { enabled: true, endpoint: '', -protocol, serviceName, sampler }" }) }} +{{ comp.codeBlock({ lang: "ts", code: "// netscript.config.ts — declare the structured-logging contract for the workspace.\n// Tracing itself is enabled by OTEL_* env vars (the Aspire AppHost sets these); the\n// config package reads them — there is no defineTelemetry() call to make.\nimport { defineConfig } from '@netscript/config';\n\nexport default defineConfig({\n name: 'my-app',\n version: '1.0.0',\n logging: { level: 'info', format: 'text' }, // level: debug|info|warn|error\n plugins: ['./plugins/workers/mod.ts'],\n});\n\n// Anywhere in app code you can inspect what telemetry resolved (log-safe, redacted):\nimport { describeTelemetryConfig, isTelemetryEnabled } from '@netscript/telemetry/config';\nif (isTelemetryEnabled()) console.log(describeTelemetryConfig());\n// → { enabled: true, endpoint: '', protocol, serviceName, sampler }" }) }} To add a custom span inside a job handler, open a child span under the job span the dispatcher already created: -{{ comp.codeBlock({ lang: "ts", code: "// plugins/workers/jobs/health-check.ts — a real child span -inside a handler.\n// The dispatcher already wraps this job in traceJobExecution automatically;\n// -withChildSpan opens a child span under that parent. recordJobProgress's 3rd arg\n// is a UNIT label -(e.g. 'steps'), not a free-text message.\nimport { createSuccessResult, defineJobHandler } from -'@netscript/plugin-workers-core';\nimport { withChildSpan, recordJobProgress } from -'@netscript/telemetry/instrumentation';\n\nconst handler = defineJobHandler(async (ctx) => {\n -recordJobProgress(1, 2, 'steps'); // → job.progress event on the trace\n\n const envCheck = await -withChildSpan('check.environment', async (span) => {\n span.setAttribute('check.name', -'environment');\n return { ok: true };\n });\n\n recordJobProgress(2, 2, 'steps');\n return -createSuccessResult({ healthy: envCheck.ok });\n});\n\nexport default Object.assign(handler, { id: -'workers-plugin-health-check' as const });" }) }} +{{ comp.codeBlock({ lang: "ts", code: "// plugins/workers/jobs/health-check.ts — a real child span inside a handler.\n// The dispatcher already wraps this job in traceJobExecution automatically;\n// withChildSpan opens a child span under that parent. recordJobProgress's 3rd arg\n// is a UNIT label (e.g. 'steps'), not a free-text message.\nimport { createSuccessResult, defineJobHandler } from '@netscript/plugin-workers-core';\nimport { withChildSpan, recordJobProgress } from '@netscript/telemetry/instrumentation';\n\nconst handler = defineJobHandler(async (ctx) => {\n recordJobProgress(1, 2, 'steps'); // → job.progress event on the trace\n\n const envCheck = await withChildSpan('check.environment', async (span) => {\n span.setAttribute('check.name', 'environment');\n return { ok: true };\n });\n\n recordJobProgress(2, 2, 'steps');\n return createSuccessResult({ healthy: envCheck.ok });\n});\n\nexport default Object.assign(handler, { id: 'workers-plugin-health-check' as const });" }) }} [Add OpenTelemetry](/observability/how-to/add-opentelemetry/#step-3-add-your-own-spans-in-a-job-handler) shows the same handler written with the scaffold's `createJobTools(ctx)`. @@ -182,197 +161,175 @@ shows the same handler written with the scaffold's `createJobTools(ctx)`. `@netscript/telemetry/config` reads configuration from the environment and caches the resolved `TelemetryConfig`; you don't construct it. -{{ comp.apiTable({ caption: "TelemetryConfig (@netscript/telemetry/config — resolved from OTEL_* env -vars)", rows: [ { name: "enabled", type: "boolean", desc: "Whether OpenTelemetry instrumentation is -active (driven by OTEL_DENO / endpoint presence). Mirror it with isTelemetryEnabled()." }, { name: -"endpoint", type: "string | undefined", desc: "OTLP exporter endpoint URL (e.g. the OTLP URL Aspire -prints). Read directly via getOtlpEndpoint()." }, { name: "protocol", type: "string", desc: "OTLP -exporter protocol (e.g. http/protobuf), from OTEL_EXPORTER_OTLP_PROTOCOL." }, { name: "serviceName", -type: "string", desc: "Service name reported to backends, from OTEL_SERVICE_NAME (or the default). -Read via getServiceName()." }, { name: "serviceVersion", type: "string", desc: "Service version -reported to backends." }, { name: "resourceAttributes", type: "Record", desc: -"Resource attributes parsed from OTEL_RESOURCE_ATTRIBUTES." }, { name: "sampler", type: "string", -desc: "Trace sampler name, from OTEL_TRACES_SAMPLER (e.g. parentbased_always_on, traceidratio)." }, -{ name: "debug", type: "boolean", desc: "Whether debug-level telemetry logging is on -(OTEL_LOG_LEVEL)." } ] }) }} - -{{ comp.apiTable({ caption: "Config helpers (@netscript/telemetry/config)", rows: [ { name: -"getTelemetryConfig()", type: "→ TelemetryConfig", desc: "Resolve telemetry config from the OTEL_* -environment variables." }, { name: "getConfig()", type: "→ TelemetryConfig", desc: "Return the -process-cached config (resetConfig() clears the cache, mainly for tests)." }, { name: -"isTelemetryEnabled()", type: "→ boolean", desc: "Whether instrumentation is enabled for this -process." }, { name: "getOtlpEndpoint()", type: "→ string | undefined", desc: "The configured OTLP -endpoint, when present." }, { name: "getServiceName()", type: "→ string", desc: "The configured -service name, or the default." }, { name: "describeTelemetryConfig()", type: "→ -TelemetryConfigDescription", desc: "A redacted, log-safe summary of the resolved config — safe to -print in diagnostics." }, { name: "OTEL_ENV_VARS", type: "const record", desc: "The OTEL_* variable -NAMES NetScript reads: OTEL_DENO, OTEL_EXPORTER_OTLP_ENDPOINT/_PROTOCOL, OTEL_SERVICE_NAME, -OTEL_RESOURCE_ATTRIBUTES, OTEL_TRACES_SAMPLER, OTEL_LOG_LEVEL, the BSP/BLRP schedule delays, and -OTEL_METRIC_EXPORT_INTERVAL." } ] }) }} +{{ comp.apiTable({ + caption: "TelemetryConfig (@netscript/telemetry/config — resolved from OTEL_* env vars)", + rows: [ + { name: "enabled", type: "boolean", desc: "Whether OpenTelemetry instrumentation is active (driven by OTEL_DENO / endpoint presence). Mirror it with isTelemetryEnabled()." }, + { name: "endpoint", type: "string | undefined", desc: "OTLP exporter endpoint URL (e.g. the OTLP URL Aspire prints). Read directly via getOtlpEndpoint()." }, + { name: "protocol", type: "string", desc: "OTLP exporter protocol (e.g. http/protobuf), from OTEL_EXPORTER_OTLP_PROTOCOL." }, + { name: "serviceName", type: "string", desc: "Service name reported to backends, from OTEL_SERVICE_NAME (or the default). Read via getServiceName()." }, + { name: "serviceVersion", type: "string", desc: "Service version reported to backends." }, + { name: "resourceAttributes", type: "Record", desc: "Resource attributes parsed from OTEL_RESOURCE_ATTRIBUTES." }, + { name: "sampler", type: "string", desc: "Trace sampler name, from OTEL_TRACES_SAMPLER (e.g. parentbased_always_on, traceidratio)." }, + { name: "debug", type: "boolean", desc: "Whether debug-level telemetry logging is on (OTEL_LOG_LEVEL)." } + ] +}) }} + +{{ comp.apiTable({ + caption: "Config helpers (@netscript/telemetry/config)", + rows: [ + { name: "getTelemetryConfig()", type: "→ TelemetryConfig", desc: "Resolve telemetry config from the OTEL_* environment variables." }, + { name: "getConfig()", type: "→ TelemetryConfig", desc: "Return the process-cached config (resetConfig() clears the cache, mainly for tests)." }, + { name: "isTelemetryEnabled()", type: "→ boolean", desc: "Whether instrumentation is enabled for this process." }, + { name: "getOtlpEndpoint()", type: "→ string | undefined", desc: "The configured OTLP endpoint, when present." }, + { name: "getServiceName()", type: "→ string", desc: "The configured service name, or the default." }, + { name: "describeTelemetryConfig()", type: "→ TelemetryConfigDescription", desc: "A redacted, log-safe summary of the resolved config — safe to print in diagnostics." }, + { name: "OTEL_ENV_VARS", type: "const record", desc: "The OTEL_* variable NAMES NetScript reads: OTEL_DENO, OTEL_EXPORTER_OTLP_ENDPOINT/_PROTOCOL, OTEL_SERVICE_NAME, OTEL_RESOURCE_ATTRIBUTES, OTEL_TRACES_SAMPLER, OTEL_LOG_LEVEL, the BSP/BLRP schedule delays, and OTEL_METRIC_EXPORT_INTERVAL." } + ] +}) }} ## Span & instrumentation helpers -Two subpaths cover hand-written instrumentation. `@netscript/telemetry/tracer` is the low-level -facade over `@opentelemetry/api`: get a tracer, open a span, run a callback inside one. -`@netscript/telemetry/instrumentation` is the NetScript-domain layer the runtimes use themselves, -with job, scheduler, queue and SSE spans that carry the right attributes. The `/context` subpath -holds the **`traceparent`** propagation helpers behind the cross-process trace in the diagram above. - -{{ comp.apiTable({ caption: "Tracer facade (@netscript/telemetry/tracer)", rows: [ { name: -"getTracer(name, version)", type: "→ Tracer", desc: "Cached tracer for an instrumentation -name/version. Domain shortcuts exist: -getJobTracer/getQueueTracer/getWorkerTracer/getSchedulerTracer/getSagaTracer/getSSETracer/getKVTracer." -}, { name: "withSpan(tracer, name, fn, options)", type: "→ Promise", desc: "Run an async callback -inside a span and close it on completion. withSpanSync is the synchronous form." }, { name: -"createSpan(tracer, name, options)", type: "→ Span", desc: "Create a span from a tracer + -CreateSpanOptions (kind, attributes, parentContext, links). You end() it yourself." }, { name: -"setSpanAttributes / setSpanError / setSpanOk", type: "(span, …) → void", desc: "Bulk-set -attributes, mark a span failed (with an optional Error), or mark it OK. addSpanEvent(span, name, -attrs?) adds an event." }, { name: "getActiveSpan() / getActiveContext()", type: "→ Span? / -Context", desc: "Read the span / OTel context active on the current async path. isTracingEnabled() -gates work." }, { name: "SpanKind / SpanStatusCode / TracerNames", type: "const", desc: "Span-kind -(INTERNAL/SERVER/CLIENT/PRODUCER/CONSUMER), status (UNSET/OK/ERROR), and the standard domain -tracer-name strings." } ] }) }} - -{{ comp.apiTable({ caption: "NetScript instrumentation helpers -(@netscript/telemetry/instrumentation)", rows: [ { name: "traceJobExecution(options, fn)", type: "→ -Promise", desc: "Wrap a job run in a span with job.started/completed/failed events. Emitted -automatically by the dispatcher; the supported entry point for tracing a job by hand." }, { name: -"withChildSpan(name, fn, attributes?)", type: "→ Promise", desc: "Open a child span under the -active span and run fn inside it. The go-to for custom spans in a handler." }, { name: -"recordJobProgress(current, total, unit)", type: "→ void", desc: "Emit a job.progress event. The 3rd -arg is a UNIT label (e.g. 'steps'), NOT a description. addJobStepEvent(stepName, attrs?) records -job.step.* events." }, { name: "startJobDispatchSpan / traceJobDispatch", type: "span / → -Promise", desc: "Open the dispatch span and return PropagationHeaders to carry traceparent to -the executor. createJobSubprocessEnv injects traceparent/tracestate into a subprocess env." }, { -name: "scheduler & cron spans", type: "span / event", desc: "createSchedulerStartSpan, -createScheduleJobSpan, startSchedulerTickSpan, traceSchedulerTick, recordCronJobRun — cron/schedule -dispatch traced end to end." }, { name: "traceQueue(queue, options) / TracedQueue", type: "→ -TracedQueue", desc: "Wrap a MessageQueue so enqueue/consume carry trace context. SSE helpers -(startSSEConnection, createSSEEventSpan, traceSSEEvent) trace Server-Sent-Event streams." } ] }) }} - -{{ comp.apiTable({ caption: "Traceparent / context propagation (@netscript/telemetry/context)", -rows: [ { name: "formatTraceparent(spanContext)", type: "→ string", desc: "Serialize a span context -to a W3C traceparent header value. parseTraceparent(value) parses one back to a ParsedTraceparent | -null." }, { name: "injectContext(headers, ctx?) / extractContext(headers)", type: "→ headers / → -Context", desc: "Inject the active trace context into outbound PropagationHeaders, or extract a -remote one from inbound headers — the core of cross-service propagation." }, { name: -"withContext(ctx, fn) / withContextAsync(ctx, fn)", type: "→ T / → Promise", desc: "Run a -callback with a given OTel context active so spans created inside attach to the right parent." }, { -name: "createMessageHeaders / resolveParentContextFromHeaders", type: "→ headers / → Context", desc: -"Build propagation headers for a queue message, and resolve the parent context back out on the -consumer side." }, { name: "getTraceId(ctx?) / getSpanId(ctx?)", type: "→ string?", desc: "Read the -current trace/span ids — handy for correlating structured log lines with a trace." } ] }) }} +Two subpaths cover hand-written instrumentation. `@netscript/telemetry/tracer` is the low-level facade +over `@opentelemetry/api`: get a tracer, open a span, run a callback inside one. +`@netscript/telemetry/instrumentation` is the NetScript-domain layer the runtimes use themselves, with +job, scheduler, queue and SSE spans that carry the right attributes. The `/context` subpath holds the +**`traceparent`** propagation helpers behind the cross-process trace in the diagram above. + +{{ comp.apiTable({ + caption: "Tracer facade (@netscript/telemetry/tracer)", + rows: [ + { name: "getTracer(name, version)", type: "→ Tracer", desc: "Cached tracer for an instrumentation name/version. Domain shortcuts exist: getJobTracer/getQueueTracer/getWorkerTracer/getSchedulerTracer/getSagaTracer/getSSETracer/getKVTracer." }, + { name: "withSpan(tracer, name, fn, options)", type: "→ Promise", desc: "Run an async callback inside a span and close it on completion. withSpanSync is the synchronous form." }, + { name: "createSpan(tracer, name, options)", type: "→ Span", desc: "Create a span from a tracer + CreateSpanOptions (kind, attributes, parentContext, links). You end() it yourself." }, + { name: "setSpanAttributes / setSpanError / setSpanOk", type: "(span, …) → void", desc: "Bulk-set attributes, mark a span failed (with an optional Error), or mark it OK. addSpanEvent(span, name, attrs?) adds an event." }, + { name: "getActiveSpan() / getActiveContext()", type: "→ Span? / Context", desc: "Read the span / OTel context active on the current async path. isTracingEnabled() gates work." }, + { name: "SpanKind / SpanStatusCode / TracerNames", type: "const", desc: "Span-kind (INTERNAL/SERVER/CLIENT/PRODUCER/CONSUMER), status (UNSET/OK/ERROR), and the standard domain tracer-name strings." } + ] +}) }} + +{{ comp.apiTable({ + caption: "NetScript instrumentation helpers (@netscript/telemetry/instrumentation)", + rows: [ + { name: "traceJobExecution(options, fn)", type: "→ Promise", desc: "Wrap a job run in a span with job.started/completed/failed events. Emitted automatically by the dispatcher; the supported entry point for tracing a job by hand." }, + { name: "withChildSpan(name, fn, attributes?)", type: "→ Promise", desc: "Open a child span under the active span and run fn inside it. The go-to for custom spans in a handler." }, + { name: "recordJobProgress(current, total, unit)", type: "→ void", desc: "Emit a job.progress event. The 3rd arg is a UNIT label (e.g. 'steps'), NOT a description. addJobStepEvent(stepName, attrs?) records job.step.* events." }, + { name: "startJobDispatchSpan / traceJobDispatch", type: "span / → Promise", desc: "Open the dispatch span and return PropagationHeaders to carry traceparent to the executor. createJobSubprocessEnv injects traceparent/tracestate into a subprocess env." }, + { name: "scheduler & cron spans", type: "span / event", desc: "createSchedulerStartSpan, createScheduleJobSpan, startSchedulerTickSpan, traceSchedulerTick, recordCronJobRun — cron/schedule dispatch traced end to end." }, + { name: "traceQueue(queue, options) / TracedQueue", type: "→ TracedQueue", desc: "Wrap a MessageQueue so enqueue/consume carry trace context. SSE helpers (startSSEConnection, createSSEEventSpan, traceSSEEvent) trace Server-Sent-Event streams." } + ] +}) }} + +{{ comp.apiTable({ + caption: "Traceparent / context propagation (@netscript/telemetry/context)", + rows: [ + { name: "formatTraceparent(spanContext)", type: "→ string", desc: "Serialize a span context to a W3C traceparent header value. parseTraceparent(value) parses one back to a ParsedTraceparent | null." }, + { name: "injectContext(headers, ctx?) / extractContext(headers)", type: "→ headers / → Context", desc: "Inject the active trace context into outbound PropagationHeaders, or extract a remote one from inbound headers — the core of cross-service propagation." }, + { name: "withContext(ctx, fn) / withContextAsync(ctx, fn)", type: "→ T / → Promise", desc: "Run a callback with a given OTel context active so spans created inside attach to the right parent." }, + { name: "createMessageHeaders / resolveParentContextFromHeaders", type: "→ headers / → Context", desc: "Build propagation headers for a queue message, and resolve the parent context back out on the consumer side." }, + { name: "getTraceId(ctx?) / getSpanId(ctx?)", type: "→ string?", desc: "Read the current trace/span ids — handy for correlating structured log lines with a trace." } + ] +}) }} ## Service, RPC & HTTP tracing Services get trace propagation from **first-party instrumentation** that wraps the upstream OTel packages. The `@netscript/telemetry/orpc` subpath ships an oRPC **tracing plugin**, backed by the upstream `@orpc/otel` instrumentation, that opens a SERVER span per RPC and continues any inbound -`traceparent`, plus an error-handling plugin that classifies failures. The -`@netscript/telemetry/hono` subpath does the same for plain HTTP: `createHonoTracingMiddleware` -wraps Hono's first-party `@hono/otel` middleware and adds NetScript service naming and W3C -propagation, and the service builder registers it outermost for you. On the service builder, the RPC -side is the `.withRPC({ traceContext: true })` toggle (see [Services](/services-sdk/services/)); the -factories below are the underlying surface if you mount oRPC or Hono yourself. - -{{ comp.apiTable({ caption: "oRPC + Hono tracing surface (@netscript/telemetry/orpc, -@netscript/telemetry/hono)", rows: [ { name: "createTracingPlugin(options?)", type: "→ -TracingPlugin", desc: "oRPC plugin that opens a SERVER span per call and continues an inbound -traceparent, following upstream rpc.* semconv. Options are TracingPluginOptions." }, { name: -"registerORPCInstrumentation(config?)", type: "→ void", desc: "Registers the upstream @orpc/otel -ORPCInstrumentation the tracing plugin is backed by — wrap-don't-reinvent, applied to oRPC." }, { -name: "createErrorHandlingPlugin(options?)", type: "→ ErrorHandlingPlugin", desc: "Classifies errors -as client | server | transient and records them on the span; takes an optional ErrorClassifier and -ErrorLogger." }, { name: "createTraceContext()", type: "→ TraceContext", desc: "Build the per-call -trace context the plugin threads through. addEvent / setAttributes / getTraceId / getSpanId operate -on the active span." }, { name: "createHonoTracingMiddleware(options)", type: "→ -HonoTracingMiddleware", desc: "Hono middleware wrapping @hono/otel's httpInstrumentationMiddleware -with NetScript service naming + W3C propagation. app.use('*', createHonoTracingMiddleware({ -serviceName: 'users' }))." } ] }) }} - -Prisma query spans are covered in [Database & Prisma](/data-persistence/database/#query-tracing), -and the worker job spans in [What is traced automatically](#what-is-traced-automatically). +`traceparent`, plus an error-handling plugin that classifies failures. The `@netscript/telemetry/hono` +subpath does the same for plain HTTP: `createHonoTracingMiddleware` wraps Hono's first-party +`@hono/otel` middleware and adds NetScript service naming and W3C propagation, and the service builder +registers it outermost for you. On the service builder, the RPC side is the +`.withRPC({ traceContext: true })` toggle (see [Services](/services-sdk/services/)); the factories +below are the underlying surface if you mount oRPC or Hono yourself. + +{{ comp.apiTable({ + caption: "oRPC + Hono tracing surface (@netscript/telemetry/orpc, @netscript/telemetry/hono)", + rows: [ + { name: "createTracingPlugin(options?)", type: "→ TracingPlugin", desc: "oRPC plugin that opens a SERVER span per call and continues an inbound traceparent, following upstream rpc.* semconv. Options are TracingPluginOptions." }, + { name: "registerORPCInstrumentation(config?)", type: "→ void", desc: "Registers the upstream @orpc/otel ORPCInstrumentation the tracing plugin is backed by — wrap-don't-reinvent, applied to oRPC." }, + { name: "createErrorHandlingPlugin(options?)", type: "→ ErrorHandlingPlugin", desc: "Classifies errors as client | server | transient and records them on the span; takes an optional ErrorClassifier and ErrorLogger." }, + { name: "createTraceContext()", type: "→ TraceContext", desc: "Build the per-call trace context the plugin threads through. addEvent / setAttributes / getTraceId / getSpanId operate on the active span." }, + { name: "createHonoTracingMiddleware(options)", type: "→ HonoTracingMiddleware", desc: "Hono middleware wrapping @hono/otel's httpInstrumentationMiddleware with NetScript service naming + W3C propagation. app.use('*', createHonoTracingMiddleware({ serviceName: 'users' }))." } + ] +}) }} + +Prisma query spans are covered in +[Database & Prisma](/data-persistence/database/#query-tracing), and the worker job spans in +[What is traced automatically](#what-is-traced-automatically). ## Endpoints & ports Telemetry has no service of its own: every runtime emits it and Aspire aggregates it. These are the addresses you interact with. -{{ comp.apiTable({ caption: "Observability surfaces (link to /reference/telemetry/ and -/reference/logger/ for the full APIs)", rows: [ { name: "the URL Aspire prints", type: "dashboard", -desc: "Aspire dashboard — traces, structured logs, metrics, and resource state for the whole app -graph. The generated local profile allows anonymous dashboard access." }, { name: "the OTLP URL -Aspire prints", type: "OTLP/HTTP", desc: "OTLP ingest endpoint the AppHost configures -(aspire.config.json profile). Runtimes export spans and logs here; the dashboard reads them back. -This is the seam you point at a hosted backend." }, { name: "GET /health", type: "Workers API", -desc: "Workers API health probe — reported as resource health in the dashboard (on its assigned -port)." }, { name: "GET /health/live", type: "Sagas API", desc: "Sagas API liveness route (on its -assigned port)." }, { name: "GET /health", type: "liveness", desc: "Triggers API health probe (Hono -service)." }, { name: "auth-api", type: "service", desc: "Auth API (auth-api) — its request spans -propagate trace context like any other service." } ] }) }} +{{ comp.apiTable({ + caption: "Observability surfaces (link to /reference/telemetry/ and /reference/logger/ for the full APIs)", + rows: [ + { name: "the URL Aspire prints", type: "dashboard", desc: "Aspire dashboard — traces, structured logs, metrics, and resource state for the whole app graph. The generated local profile allows anonymous dashboard access." }, + { name: "the OTLP URL Aspire prints", type: "OTLP/HTTP", desc: "OTLP ingest endpoint the AppHost configures (aspire.config.json profile). Runtimes export spans and logs here; the dashboard reads them back. This is the seam you point at a hosted backend." }, + { name: "GET /health", type: "Workers API", desc: "Workers API health probe — reported as resource health in the dashboard (on its assigned port)." }, + { name: "GET /health/live", type: "Sagas API", desc: "Sagas API liveness route (on its assigned port)." }, + { name: "GET /health", type: "liveness", desc: "Triggers API health probe (Hono service)." }, + { name: "auth-api", type: "service", desc: "Auth API (auth-api) — its request spans propagate trace context like any other service." } + ] +}) }} ## View it in Aspire With `aspire start` up, the dashboard gives you four views over the same telemetry stream: -{{ comp.apiTable({ caption: "Aspire dashboard views (the URL Aspire prints)", rows: [ { name: -"Resources", type: "graph", desc: "Live state of every app-graph resource: postgres, redis, -workers-api, workers, sagas-api, sagas, triggers-api, triggers, auth-api. Health probes drive the -status colour." }, { name: "Console logs", type: "stream", desc: "Per-resource stdout/stderr — the -framework logger's text/JSON output lands here in real time." }, { name: "Structured logs", type: -"OTLP", desc: "Structured log records exported over OTLP, filterable by resource, level, and -attributes." }, { name: "Traces", type: "OTLP", desc: "Distributed traces collected from the OTLP -endpoint (the OTLP URL Aspire prints) — job dispatch/execution/scheduler/task spans and -cross-service request spans as trace context propagates." } ] }) }} +{{ comp.apiTable({ + caption: "Aspire dashboard views (the URL Aspire prints)", + rows: [ + { name: "Resources", type: "graph", desc: "Live state of every app-graph resource: postgres, redis, workers-api, workers, sagas-api, sagas, triggers-api, triggers, auth-api. Health probes drive the status colour." }, + { name: "Console logs", type: "stream", desc: "Per-resource stdout/stderr — the framework logger's text/JSON output lands here in real time." }, + { name: "Structured logs", type: "OTLP", desc: "Structured log records exported over OTLP, filterable by resource, level, and attributes." }, + { name: "Traces", type: "OTLP", desc: "Distributed traces collected from the OTLP endpoint (the OTLP URL Aspire prints) — job dispatch/execution/scheduler/task spans and cross-service request spans as trace context propagates." } + ] +}) }} ## Close the loop: read the trace back in code -The dashboard answers _what happened and where_ for a person. Programs, and AI agents verifying -their own change without a browser, use the **typed read side**. `@netscript/telemetry/query` -publishes a `TelemetryQueryPort` contract with an Aspire-backed reader: -`createAspireTelemetryQuery(...)`, or `createTelemetryQuery(...)` for the port type, reads the -Aspire `/api/telemetry/*` surface into package-owned read models: `TelemetryTrace`, `TelemetrySpan` -(with its `events` and `links`), `TelemetryLog`, `TelemetryResource` and `TelemetryMetric`. -Verification becomes an assertion: fetch the trace by id and check that the span you expected is -present with the status you expected. - -{{ comp.apiTable({ caption: "Telemetry query read side (@netscript/telemetry/query)", rows: [ { -name: "createAspireTelemetryQuery(options) / createTelemetryQuery(options)", type: "→ -AspireTelemetryQuery / TelemetryQueryPort", desc: "Build the Aspire-backed reader over the -dashboard's /api/telemetry/* surface. The first returns the concrete adapter; the second returns it -typed as the port contract." }, { name: "queryTraces(filter?) / getTrace(traceId)", type: "→ -Promise / Promise", desc: "List traces matching a -TraceQueryFilter, or fetch a single trace by id — the assertion primitive for 'did my flow produce -the span I expected'." }, { name: "querySpans / queryLogs / queryMetrics / queryResources", type: "→ -Promise", desc: "Read spans, structured logs, metrics, and resource records back as -package-owned models (TelemetrySpan / TelemetryLog / TelemetryMetric / TelemetryResource)." }, { -name: "validateTraceQueryFilter / validateMetricQueryFilter / validateResourceQueryFilter", type: -"(filter) → filter", desc: "Standard Schema validators for the query filters — a malformed query -fails in-process rather than returning silently-wrong rows." } ] }) }} - -Encore exposes its local traces to an AI agent through an MCP server. NetScript makes the read side -a typed in-language port that the app, a test or an agent's own tool calls directly, and it returns -the same package-owned read models the runtimes emit. +The dashboard answers *what happened and where* for a person. Programs, and AI agents verifying their +own change without a browser, use the **typed read side**. `@netscript/telemetry/query` publishes a +`TelemetryQueryPort` contract with an Aspire-backed reader: `createAspireTelemetryQuery(...)`, or +`createTelemetryQuery(...)` for the port type, reads the Aspire `/api/telemetry/*` surface into +package-owned read models: `TelemetryTrace`, `TelemetrySpan` (with its `events` and `links`), +`TelemetryLog`, `TelemetryResource` and `TelemetryMetric`. Verification becomes an assertion: fetch +the trace by id and check that the span you expected is present with the status you expected. + +{{ comp.apiTable({ + caption: "Telemetry query read side (@netscript/telemetry/query)", + rows: [ + { name: "createAspireTelemetryQuery(options) / createTelemetryQuery(options)", type: "→ AspireTelemetryQuery / TelemetryQueryPort", desc: "Build the Aspire-backed reader over the dashboard's /api/telemetry/* surface. The first returns the concrete adapter; the second returns it typed as the port contract." }, + { name: "queryTraces(filter?) / getTrace(traceId)", type: "→ Promise / Promise", desc: "List traces matching a TraceQueryFilter, or fetch a single trace by id — the assertion primitive for 'did my flow produce the span I expected'." }, + { name: "querySpans / queryLogs / queryMetrics / queryResources", type: "→ Promise", desc: "Read spans, structured logs, metrics, and resource records back as package-owned models (TelemetrySpan / TelemetryLog / TelemetryMetric / TelemetryResource)." }, + { name: "validateTraceQueryFilter / validateMetricQueryFilter / validateResourceQueryFilter", type: "(filter) → filter", desc: "Standard Schema validators for the query filters — a malformed query fails in-process rather than returning silently-wrong rows." } + ] +}) }} + +Encore exposes its local traces to an AI agent through an MCP server. NetScript makes the read side a +typed in-language port that the app, a test or an agent's own tool calls directly, and it returns the +same package-owned read models the runtimes emit. ## Production notes -| Avoid | Do instead | -| --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Avoid | Do instead | +| --- | --- | | Tracing 100% of traffic in production. The local Aspire default samples everything, which is fine for development and ruinous at scale. | Set a ratio sampler in the environment: `OTEL_TRACES_SAMPLER` (surfaced as `TelemetryConfig.sampler`) to `traceidratio` with a rate. Keep always-on sampling for low-volume services or a targeted debugging window. | -| Editing instrumentation to point at Grafana or Honeycomb; you redo that churn on every upgrade. | Point the exporter. `OTEL_EXPORTER_OTLP_ENDPOINT` (injected by Aspire locally) is the single seam: change endpoint and protocol in the environment and the instrumentation code stays the same. | -| Unbounded values such as user ids, raw URLs or full payloads in `span.setAttribute`; they explode index cardinality on the backend. | Use stable, low-cardinality keys. To correlate a specific record, log `getTraceId()` in a structured log line instead of widening the span. | -| A message as `recordJobProgress`'s third argument; free text there inflates cardinality and misreads the API. | Pass a stable unit label such as `'steps'` or `'items'`. | -| Treating `progress(percent, message)` as only a log line. | Use it for both telemetry and runtime progress: it emits a `job.progress` event and forwards the percentage and message to the workers channel. | +| Editing instrumentation to point at Grafana or Honeycomb; you redo that churn on every upgrade. | Point the exporter. `OTEL_EXPORTER_OTLP_ENDPOINT` (injected by Aspire locally) is the single seam: change endpoint and protocol in the environment and the instrumentation code stays the same. | +| Unbounded values such as user ids, raw URLs or full payloads in `span.setAttribute`; they explode index cardinality on the backend. | Use stable, low-cardinality keys. To correlate a specific record, log `getTraceId()` in a structured log line instead of widening the span. | +| A message as `recordJobProgress`'s third argument; free text there inflates cardinality and misreads the API. | Pass a stable unit label such as `'steps'` or `'items'`. | +| Treating `progress(percent, message)` as only a log line. | Use it for both telemetry and runtime progress: it emits a `job.progress` event and forwards the percentage and message to the workers channel. | ## Next steps -Follow [Add OpenTelemetry](/observability/how-to/add-opentelemetry/) to trigger a trace, add your -own spans and read them in the dashboard. +Follow [Add OpenTelemetry](/observability/how-to/add-opentelemetry/) to trigger a trace, add your own +spans and read them in the dashboard. -- [Observability model](/explanation/observability/): how automatic framework spans, - `createJobTools(ctx)` handler telemetry, console logs, health endpoints and Aspire traces fit - together. +- [Observability model](/explanation/observability/): how automatic framework spans, `createJobTools(ctx)` + handler telemetry, console logs, health endpoints and Aspire traces fit together. - {{ comp.xref({ key: "ref:telemetry" }) }} and [logger](/reference/logger/) references: the full APIs. - [Telemetry conventions](/reference/telemetry/convention/): span naming, SpanKind and the diff --git a/docs/site/reference/plugin/index.md b/docs/site/reference/plugin/index.md index dcefcc741e..b97f42c124 100644 --- a/docs/site/reference/plugin/index.md +++ b/docs/site/reference/plugin/index.md @@ -11,40 +11,40 @@ health surfaces a plugin contributes. ## Sub-path exports -| Export | Entrypoint | Purpose | -| --------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `@netscript/plugin` | `./mod.ts` | Plugin authoring contract: [definition](#plugin-definition), [diagnostics](#diagnostics), [errors](#errors), [contributions](#contributions) and manifest types. | -| `@netscript/plugin/health` | `./src/health/mod.ts` | [Background child health contract and process transport](#netscriptpluginhealth). | -| `@netscript/plugin/config` | `./src/config/mod.ts` | [Builder, manifest schema, and contribution type contracts](#netscriptpluginconfig). | -| `@netscript/plugin/abstracts` | `./src/abstracts/mod.ts` | [Abstract contribution base classes per axis](#netscriptpluginabstracts). | -| `@netscript/plugin/adapter` | `./src/adapter/mod.ts` | [Local host command adapters](#netscriptpluginadapter). | -| `@netscript/plugin/cli` | `./src/cli/mod.ts` | [Plugin CLI base classes, command mounting, and doctor reports](#netscriptplugincli). | -| `@netscript/plugin/sdk` | `./src/sdk/mod.ts` | [Discovery ports, alpha adapters, and runtime host stubs](#netscriptpluginsdk). | -| `@netscript/plugin/loader` | `./loader.ts` | [Host-side plugin service bootstrap helpers](#netscriptpluginloader). | -| `@netscript/plugin/protocol` | `./src/protocol/mod.ts` | [Plugin manifest schemas and installer protocol definitions](#netscriptpluginprotocol). | -| `@netscript/plugin/scaffold` | `./src/scaffold/mod.ts` | [Template generators and registry emitters](#netscriptpluginscaffold). | -| `@netscript/plugin/testing` | `./src/testing/mod.ts` | [In-memory adapters, fixtures, and the CLI contract harness](#netscriptplugintesting). | -| `@netscript/plugin/templates` | `./src/templates/mod.ts` | [Plugin skeleton template asset paths](#netscriptplugintemplates). | -| `@netscript/plugin/contract-base` | `./src/contract-base/mod.ts` | [Standard plugin capability checks](#netscriptplugincontract-base). | -| `@netscript/plugin/service` | `./src/service/mod.ts` | [Out-of-process plugin service binders](#netscriptpluginservice). | +| Export | Entrypoint | Purpose | +| --- | --- | --- | +| `@netscript/plugin` | `./mod.ts` | Plugin authoring contract: [definition](#plugin-definition), [diagnostics](#diagnostics), [errors](#errors), [contributions](#contributions) and manifest types. | +| `@netscript/plugin/health` | `./src/health/mod.ts` | [Background child health contract and process transport](#netscriptpluginhealth). | +| `@netscript/plugin/config` | `./src/config/mod.ts` | [Builder, manifest schema, and contribution type contracts](#netscriptpluginconfig). | +| `@netscript/plugin/abstracts` | `./src/abstracts/mod.ts` | [Abstract contribution base classes per axis](#netscriptpluginabstracts). | +| `@netscript/plugin/adapter` | `./src/adapter/mod.ts` | [Local host command adapters](#netscriptpluginadapter). | +| `@netscript/plugin/cli` | `./src/cli/mod.ts` | [Plugin CLI base classes, command mounting, and doctor reports](#netscriptplugincli). | +| `@netscript/plugin/sdk` | `./src/sdk/mod.ts` | [Discovery ports, alpha adapters, and runtime host stubs](#netscriptpluginsdk). | +| `@netscript/plugin/loader` | `./loader.ts` | [Host-side plugin service bootstrap helpers](#netscriptpluginloader). | +| `@netscript/plugin/protocol` | `./src/protocol/mod.ts` | [Plugin manifest schemas and installer protocol definitions](#netscriptpluginprotocol). | +| `@netscript/plugin/scaffold` | `./src/scaffold/mod.ts` | [Template generators and registry emitters](#netscriptpluginscaffold). | +| `@netscript/plugin/testing` | `./src/testing/mod.ts` | [In-memory adapters, fixtures, and the CLI contract harness](#netscriptplugintesting). | +| `@netscript/plugin/templates` | `./src/templates/mod.ts` | [Plugin skeleton template asset paths](#netscriptplugintemplates). | +| `@netscript/plugin/contract-base` | `./src/contract-base/mod.ts` | [Standard plugin capability checks](#netscriptplugincontract-base). | +| `@netscript/plugin/service` | `./src/service/mod.ts` | [Out-of-process plugin service binders](#netscriptpluginservice). | ## Plugin definition -| Symbol | Kind | Signature | Description | -| -------------------- | --------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------- | -| `definePlugin` | function | `function definePlugin(name: TName, version: TVersion): PluginBuilder` | Start a new plugin manifest builder chain. | -| `PluginBuilder` | class | `class PluginBuilder` | Fluent builder for assembling plugin manifests. | -| `PluginBuilderState` | interface | `interface PluginBuilderState` | Immutable state accumulated by the plugin builder chain. | -| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `definePlugin` | function | `function definePlugin(name: TName, version: TVersion): PluginBuilder` | Start a new plugin manifest builder chain. | +| `PluginBuilder` | class | `class PluginBuilder` | Fluent builder for assembling plugin manifests. | +| `PluginBuilderState` | interface | `interface PluginBuilderState` | Immutable state accumulated by the plugin builder chain. | +| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | ## Diagnostics -| Symbol | Kind | Signature | Description | -| --------------------------- | --------- | -------------------------------------------------- | --------------------------------------------------------------- | -| `inspectPlugin` | function | `function inspectPlugin(target): InspectionReport` | Inspect a plugin manifest, registry, or path-like target. | -| `InspectionReport` | interface | `interface InspectionReport` | JSON-stable diagnostic report returned by plugin inspectors. | -| `InspectablePluginManifest` | interface | `interface InspectablePluginManifest` | Minimal plugin manifest shape accepted by the plugin inspector. | -| `InspectablePluginRegistry` | interface | `interface InspectablePluginRegistry` | Minimal registry shape accepted by the plugin inspector. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `inspectPlugin` | function | `function inspectPlugin(target): InspectionReport` | Inspect a plugin manifest, registry, or path-like target. | +| `InspectionReport` | interface | `interface InspectionReport` | JSON-stable diagnostic report returned by plugin inspectors. | +| `InspectablePluginManifest` | interface | `interface InspectablePluginManifest` | Minimal plugin manifest shape accepted by the plugin inspector. | +| `InspectablePluginRegistry` | interface | `interface InspectablePluginRegistry` | Minimal registry shape accepted by the plugin inspector. | ## Errors @@ -121,9 +121,9 @@ version matches only itself. Library packages that are not plugins belong in `de not in a manifest's `dependencies`. > [!IMPORTANT] -> **Breaking change.** `PluginManifestSchema`, `definePlugin(...).build()`, and the composition -> check reject unknown contribution keys. A misspelled key such as `servces`, previously ignored, -> fails with the plugin name and the key. Rename it to the documented key, or remove it. +> **Breaking change.** `PluginManifestSchema`, `definePlugin(...).build()`, and the composition check +> reject unknown contribution keys. A misspelled key such as `servces`, previously ignored, fails with +> the plugin name and the key. Rename it to the documented key, or remove it. ## Manifest types @@ -147,17 +147,17 @@ not in a manifest's `dependencies`. ## `@netscript/plugin/config` -| Symbol | Kind | Signature | Description | -| --------------------------- | -------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -| `definePlugin` | function | `function definePlugin(name, version): PluginBuilder` | Start a new plugin manifest builder chain. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `definePlugin` | function | `function definePlugin(name, version): PluginBuilder` | Start a new plugin manifest builder chain. | | `validatePluginComposition` | function | `function validatePluginComposition(plugins): PluginCompositionResult` | Validate that plugin manifests compose into one root host. See [Root composition validation](#root-composition-validation). | -| `mergeContributions` | function | `function mergeContributions(base, overrides): PluginContributions` | Merge plugin contribution groups without mutating inputs; throws when both set `aspire` or `doctor`. | -| `isContributionAxis` | function | `function isContributionAxis(value: string): boolean` | Check whether a value is a supported contribution axis. | -| `isReservedPluginName` | function | `function isReservedPluginName(name: string): boolean` | Return true when a plugin name is reserved by NetScript. | -| `PluginManifestSchema` | const | `variable PluginManifestSchema` | Zod schema for plugin manifests; contribution keys are closed. | -| `PluginCompositionError` | class | class | Error thrown when manifests cannot be composed into one root host. | -| `CONTRIBUTION_AXES` | const | `variable CONTRIBUTION_AXES` | Supported plugin contribution axes. | -| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | +| `mergeContributions` | function | `function mergeContributions(base, overrides): PluginContributions` | Merge plugin contribution groups without mutating inputs; throws when both set `aspire` or `doctor`. | +| `isContributionAxis` | function | `function isContributionAxis(value: string): boolean` | Check whether a value is a supported contribution axis. | +| `isReservedPluginName` | function | `function isReservedPluginName(name: string): boolean` | Return true when a plugin name is reserved by NetScript. | +| `PluginManifestSchema` | const | `variable PluginManifestSchema` | Zod schema for plugin manifests; contribution keys are closed. | +| `PluginCompositionError` | class | class | Error thrown when manifests cannot be composed into one root host. | +| `CONTRIBUTION_AXES` | const | `variable CONTRIBUTION_AXES` | Supported plugin contribution axes. | +| `PLUGIN_TYPES` | const | `variable PLUGIN_TYPES` | Supported plugin categories. | This entrypoint also re-exports `PluginBuilder`, `ContributionInput`, `DependencyContext`, `PluginBuilderState`, `BackgroundProcessorContribution`, `ContractVersionContribution`, @@ -191,121 +191,121 @@ This entrypoint also re-exports `PluginBuilder`, `ContributionInput`, `Dependenc ## `@netscript/plugin/adapter` -| Symbol | Kind | Description | -| --------------------------------- | ---------- | ----------------------------------------------------------------------- | -| `DoctorCheckSpec` | interface | Extra doctor check supplied by a plugin seam. | -| `DoctorSpec` | interface | Seam data consumed by the mandatory doctor algorithm. | -| `InfoSpec` | interface | Static capability summary returned by the mandatory info command. | -| `InstallSpec` | interface | Seam data consumed by the mandatory install algorithm. | -| `InstallStarterResource` | interface | Starter resource emitted by the mandatory install command. | -| `InstallStarterSamplesPolicy` | type alias | Behavior for an install starter when the host excludes samples. | -| `NetScriptPlugin` | interface | Plugin adapter contract consumed by core command logic. | -| `PluginAdapter` | interface | Adapter object produced by the plugin adapter factory. | -| `PluginCliEntrypoint` | type alias | CLI entrypoint produced by `createPluginAdapter(plugin).toCli()`. | -| `PluginCommandConfig` | type alias | Readonly command configuration supplied by the host. | -| `PluginCommandContext` | interface | Context shared by adapter command algorithms. | -| `PluginCommandSpec` | interface | Optional plugin-owned command handler. | -| `PluginCommandValue` | type alias | Primitive value accepted in plugin command configuration. | -| `PluginResource` | interface | Optional plugin-owned resource command. | -| `RemoveSpec` | interface | Seam data consumed by the mandatory remove algorithm. | -| `UpdateSpec` | interface | Seam data consumed by the mandatory update algorithm. | -| `createDenoFileSystem` | function | Create the default Deno-backed file-system port for adapter commands. | -| `DEFAULT_PLUGIN_HEALTH_ENDPOINT` | const | Default health endpoint used by plugin doctor commands. | -| `DEFAULT_PLUGIN_WORKSPACE_ROOT` | const | Default workspace root used when no explicit root is supplied. | -| `resolveWorkspacePath` | function | Resolve a workspace-relative path against a workspace root. | -| `createPluginAdapter` | function | Create the core adapter for a plugin contract object. | -| `RunInstallCommandOptions` | interface | Input consumed by the mandatory install command. | -| `collectInstallArtifacts` | function | Emit starter artifacts from the plugin's install seams. | -| `createInstallScaffoldEntrypoint` | function | Create a scaffolder protocol entrypoint from the install command. | -| `runInstallCommand` | function | Run the core-owned plugin install algorithm. | -| `RunDoctorCommandOptions` | interface | Input consumed by the mandatory doctor command. | -| `runDoctorCommand` | function | Run the core-owned plugin doctor algorithm. | -| `PluginInfoReport` | interface | Structured report returned by the mandatory info command. | -| `RunInfoCommandOptions` | interface | Input consumed by the mandatory info command. | -| `runInfoCommand` | function | Run the core-owned plugin info algorithm. | -| `RunUpdateCommandOptions` | interface | Input consumed by the mandatory update command. | -| `runUpdateCommand` | function | Run the core-owned plugin update algorithm. | -| `RunRemoveCommandOptions` | interface | Input consumed by the mandatory remove command. | -| `runRemoveCommand` | function | Run the core-owned plugin remove algorithm. | -| `RunPluginCliCommandOptions` | interface | Input consumed by the plugin CLI runner. | -| `runPluginCliCommand` | function | Route a plugin CLI verb to mandatory logic or a plugin-owned handler. | -| `runPluginScaffoldCli` | function | Run a plugin scaffold entrypoint from the host CLI subprocess protocol. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `DoctorCheckSpec` | interface | Extra doctor check supplied by a plugin seam. | +| `DoctorSpec` | interface | Seam data consumed by the mandatory doctor algorithm. | +| `InfoSpec` | interface | Static capability summary returned by the mandatory info command. | +| `InstallSpec` | interface | Seam data consumed by the mandatory install algorithm. | +| `InstallStarterResource` | interface | Starter resource emitted by the mandatory install command. | +| `InstallStarterSamplesPolicy` | type alias | Behavior for an install starter when the host excludes samples. | +| `NetScriptPlugin` | interface | Plugin adapter contract consumed by core command logic. | +| `PluginAdapter` | interface | Adapter object produced by the plugin adapter factory. | +| `PluginCliEntrypoint` | type alias | CLI entrypoint produced by `createPluginAdapter(plugin).toCli()`. | +| `PluginCommandConfig` | type alias | Readonly command configuration supplied by the host. | +| `PluginCommandContext` | interface | Context shared by adapter command algorithms. | +| `PluginCommandSpec` | interface | Optional plugin-owned command handler. | +| `PluginCommandValue` | type alias | Primitive value accepted in plugin command configuration. | +| `PluginResource` | interface | Optional plugin-owned resource command. | +| `RemoveSpec` | interface | Seam data consumed by the mandatory remove algorithm. | +| `UpdateSpec` | interface | Seam data consumed by the mandatory update algorithm. | +| `createDenoFileSystem` | function | Create the default Deno-backed file-system port for adapter commands. | +| `DEFAULT_PLUGIN_HEALTH_ENDPOINT` | const | Default health endpoint used by plugin doctor commands. | +| `DEFAULT_PLUGIN_WORKSPACE_ROOT` | const | Default workspace root used when no explicit root is supplied. | +| `resolveWorkspacePath` | function | Resolve a workspace-relative path against a workspace root. | +| `createPluginAdapter` | function | Create the core adapter for a plugin contract object. | +| `RunInstallCommandOptions` | interface | Input consumed by the mandatory install command. | +| `collectInstallArtifacts` | function | Emit starter artifacts from the plugin's install seams. | +| `createInstallScaffoldEntrypoint` | function | Create a scaffolder protocol entrypoint from the install command. | +| `runInstallCommand` | function | Run the core-owned plugin install algorithm. | +| `RunDoctorCommandOptions` | interface | Input consumed by the mandatory doctor command. | +| `runDoctorCommand` | function | Run the core-owned plugin doctor algorithm. | +| `PluginInfoReport` | interface | Structured report returned by the mandatory info command. | +| `RunInfoCommandOptions` | interface | Input consumed by the mandatory info command. | +| `runInfoCommand` | function | Run the core-owned plugin info algorithm. | +| `RunUpdateCommandOptions` | interface | Input consumed by the mandatory update command. | +| `runUpdateCommand` | function | Run the core-owned plugin update algorithm. | +| `RunRemoveCommandOptions` | interface | Input consumed by the mandatory remove command. | +| `runRemoveCommand` | function | Run the core-owned plugin remove algorithm. | +| `RunPluginCliCommandOptions` | interface | Input consumed by the plugin CLI runner. | +| `runPluginCliCommand` | function | Route a plugin CLI verb to mandatory logic or a plugin-owned handler. | +| `runPluginScaffoldCli` | function | Run a plugin scaffold entrypoint from the host CLI subprocess protocol. | This entrypoint also re-exports the root and CLI symbols `DoctorCheck`, `DoctorReport`, `PluginCliArgs`, `PluginCliCommand`, `PluginCliResult`, `PluginLogger`, and `FileSystemPort`; the protocol symbols `PluginScaffoldEntrypoint`, `ScaffolderContext`, and `ScaffoldResult`; and the scaffold symbols `ItemScaffolder`, `ScaffoldArtifact`, `ScaffoldArtifactBody`, `artifactText`, -`textArtifact`, `StubSource`, `TokenValues`, `defineStub`, and `substituteTokens`, documented in -their owning sections. +`textArtifact`, `StubSource`, `TokenValues`, `defineStub`, and `substituteTokens`, documented in their owning +sections. ## `@netscript/plugin/cli` -| Symbol | Kind | Signature | Description | -| --------------------------------- | ---------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------- | -| `PluginCli` | class | `class PluginCli` | Abstract base class for plugin-owned CLI command groups. | -| `PluginRuntimeConfigCli` | class | `class PluginRuntimeConfigCli` | Abstract base for plugin runtime configuration commands. | -| `mountPluginCli` | function | `function mountPluginCli(clis)` | Mount plugin CLI command groups into a flat command list. | -| `runMountedCommand` | function | `async function runMountedCommand(commands, args: PluginCliArgs): Promise` | Run a mounted command list without depending on Cliffy at package level. | -| `routeVerb` | function | `async function routeVerb(commands, args: PluginCliArgs): Promise` | Route a command by verb name. | -| `formatPluginHelp` | function | `function formatPluginHelp(commands): string` | Format command help text for a mounted plugin CLI. | -| `isDoctorReportPassing` | function | `function isDoctorReportPassing(report: DoctorReport): boolean` | Return true when every doctor check is passing. | -| `PluginCliArgs` | interface | `interface PluginCliArgs` | Command arguments passed to plugin CLI handlers. | -| `PluginCliCommand` | interface | `interface PluginCliCommand` | A mounted CLI command handler. | -| `PluginCliResult` | interface | `interface PluginCliResult` | Result returned by plugin CLI handlers. | -| `DoctorCheck` | interface | `interface DoctorCheck` | Diagnostic entry produced by plugin doctor commands. | -| `DoctorReport` | interface | `interface DoctorReport` | Aggregate doctor report for a plugin CLI. | -| `LocalProjectFiles` | class | class | Deno-backed project file adapter for local plugin CLI execution. | -| `resolveProjectRoot` | function | function | Resolve a URL or path to a local project root. | -| `ProjectFileEntry` | interface | interface | File entry discovered by a plugin CLI filesystem scan. | -| `ProjectFiles` | interface | interface | Project file operations used by plugin CLI commands. | -| `renderRegistryModule` | function | function | Render a static-registry module from discovered items and plugin specifics. | -| `toRegistryImportSpecifier` | function | function | Resolve an item's import specifier relative to a generated registry. | -| `RegistryEmitItem` | interface | interface | Discovered registry item with its project-relative source path. | -| `RegistryModuleSpec` | interface | interface | Plugin-supplied details used to render a registry module. | -| `normalizePluginArgv` | function | function | Normalize raw argv tokens into positional values and simple long flags. | -| `parsePluginCliArgs` | function | function | Parse plugin command argv into the shared `PluginCliArgs` contract. | -| `NormalizedPluginArgv` | interface | interface | Normalized argv tokens after the caller removes its runtime wrapper. | -| `applyScaffoldPlan` | function | function | Plan scaffold files and persist them only for a real run. | -| `ScaffoldPlanResult` | interface | interface | Result of planning or applying a plugin-owned scaffold operation. | -| `createBaseMetaCommands` | function | function | Create the shared `status`, `health`, and `info` command set. | -| `PluginBaseMeta` | interface | interface | Data returned by the shared plugin metadata commands. | -| `findGeneratedProjectRoot` | function | function | Find a project root through a project file adapter. | -| `loadGeneratedProjectRegistry` | function | function | Load and validate a generated project registry export. | -| `DefinitionGuard` | type alias | type alias | Runtime guard for a generated definition value. | -| `GeneratedProjectRegistryOptions` | interface | interface | Options for loading a generated registry from a project. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `PluginCli` | class | `class PluginCli` | Abstract base class for plugin-owned CLI command groups. | +| `PluginRuntimeConfigCli` | class | `class PluginRuntimeConfigCli` | Abstract base for plugin runtime configuration commands. | +| `mountPluginCli` | function | `function mountPluginCli(clis)` | Mount plugin CLI command groups into a flat command list. | +| `runMountedCommand` | function | `async function runMountedCommand(commands, args: PluginCliArgs): Promise` | Run a mounted command list without depending on Cliffy at package level. | +| `routeVerb` | function | `async function routeVerb(commands, args: PluginCliArgs): Promise` | Route a command by verb name. | +| `formatPluginHelp` | function | `function formatPluginHelp(commands): string` | Format command help text for a mounted plugin CLI. | +| `isDoctorReportPassing` | function | `function isDoctorReportPassing(report: DoctorReport): boolean` | Return true when every doctor check is passing. | +| `PluginCliArgs` | interface | `interface PluginCliArgs` | Command arguments passed to plugin CLI handlers. | +| `PluginCliCommand` | interface | `interface PluginCliCommand` | A mounted CLI command handler. | +| `PluginCliResult` | interface | `interface PluginCliResult` | Result returned by plugin CLI handlers. | +| `DoctorCheck` | interface | `interface DoctorCheck` | Diagnostic entry produced by plugin doctor commands. | +| `DoctorReport` | interface | `interface DoctorReport` | Aggregate doctor report for a plugin CLI. | +| `LocalProjectFiles` | class | class | Deno-backed project file adapter for local plugin CLI execution. | +| `resolveProjectRoot` | function | function | Resolve a URL or path to a local project root. | +| `ProjectFileEntry` | interface | interface | File entry discovered by a plugin CLI filesystem scan. | +| `ProjectFiles` | interface | interface | Project file operations used by plugin CLI commands. | +| `renderRegistryModule` | function | function | Render a static-registry module from discovered items and plugin specifics. | +| `toRegistryImportSpecifier` | function | function | Resolve an item's import specifier relative to a generated registry. | +| `RegistryEmitItem` | interface | interface | Discovered registry item with its project-relative source path. | +| `RegistryModuleSpec` | interface | interface | Plugin-supplied details used to render a registry module. | +| `normalizePluginArgv` | function | function | Normalize raw argv tokens into positional values and simple long flags. | +| `parsePluginCliArgs` | function | function | Parse plugin command argv into the shared `PluginCliArgs` contract. | +| `NormalizedPluginArgv` | interface | interface | Normalized argv tokens after the caller removes its runtime wrapper. | +| `applyScaffoldPlan` | function | function | Plan scaffold files and persist them only for a real run. | +| `ScaffoldPlanResult` | interface | interface | Result of planning or applying a plugin-owned scaffold operation. | +| `createBaseMetaCommands` | function | function | Create the shared `status`, `health`, and `info` command set. | +| `PluginBaseMeta` | interface | interface | Data returned by the shared plugin metadata commands. | +| `findGeneratedProjectRoot` | function | function | Find a project root through a project file adapter. | +| `loadGeneratedProjectRegistry` | function | function | Load and validate a generated project registry export. | +| `DefinitionGuard` | type alias | type alias | Runtime guard for a generated definition value. | +| `GeneratedProjectRegistryOptions` | interface | interface | Options for loading a generated registry from a project. | ## `@netscript/plugin/sdk` -| Symbol | Kind | Signature | Description | -| ------------------------------- | --------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | -| `runWalkerPipeline` | function | `async function runWalkerPipeline(options: RunWalkerPipelineOptions): Promise` | Run the plugin SDK discovery pipeline. | -| `startWalker` | function | `function startWalker(root: string): Promise` | Start a one-shot SDK walker with default alpha adapters. | -| `startWatcher` | function | `function startWatcher(): WatcherHandle` | Start a no-op alpha watcher for plugin SDK discovery. | -| `createSourceGraph` | function | `function createSourceGraph(files, contributions): SourceGraph` | Create a source graph snapshot from walked files and extracted contributions. | -| `createWatcherHandle` | function | `function createWatcherHandle(): WatcherHandle` | Create a no-op watcher handle for alpha SDK discovery. | -| `createInstrumentationBridge` | function | `function createInstrumentationBridge()` | Create a recording instrumentation bridge. | -| `createPluginContext` | function | `function createPluginContext(projectRoot: string): PluginContext` | Create a minimal plugin context for SDK runtime helpers. | -| `createPluginHostBootstrap` | function | `function createPluginHostBootstrap(plugins): PluginHostBootstrap` | Create a plugin host bootstrap snapshot from a validated composition; throws `PluginCompositionError`. | -| `runDoctorReport` | function | `function runDoctorReport(plugin: string, checks): DoctorReport` | Run plugin doctor checks and return an aggregate report. | -| `AstExtractor` | class | class | Extractor for exported plugin contribution builder call sites. | -| `FilesystemWalker` | class | class | Filesystem walker for plugin source discovery. | -| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | -| `ModuleManifestResolver` | class | class | Manifest resolver backed by dynamic imports. | -| `RegistryEmitter` | class | class | Registry emitter that writes one generated TypeScript module per contribution axis. | -| `EmitterPort` | interface | interface | Port for emitting generated plugin registry files. | -| `ExtractorPort` | interface | interface | Port for extracting plugin contributions from walked files. | -| `ManifestResolverPort` | interface | interface | Port for resolving a plugin manifest from a package or module specifier. | -| `WalkerPort` | interface | interface | Port for discovering plugin source files. | -| `WalkedFile` | interface | interface | File discovered by a plugin source walker. | -| `SourceGraph` | interface | interface | Source graph snapshot produced by discovery. | -| `RegistryEmission` | interface | interface | Output emitted by the registry emitter. | -| `ExtractedContribution` | interface | interface | Extracted contribution candidate from source. | -| `WatcherHandle` | interface | interface | Watcher handle returned by SDK watch presets. | -| `ModuleManifestResolverOptions` | interface | interface | Options for resolving manifests from importable module specifiers. | -| `RunWalkerPipelineOptions` | interface | interface | Options for running the SDK walker pipeline. | -| `InstrumentationBridge` | interface | interface | Bridge between plugin runtime and telemetry instrumentation. | -| `PluginHostBootstrap` | interface | interface | Result of bootstrapping plugin host state. | -| `PluginServiceContext` | interface | interface | Context supplied to a plugin service at runtime. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `runWalkerPipeline` | function | `async function runWalkerPipeline(options: RunWalkerPipelineOptions): Promise` | Run the plugin SDK discovery pipeline. | +| `startWalker` | function | `function startWalker(root: string): Promise` | Start a one-shot SDK walker with default alpha adapters. | +| `startWatcher` | function | `function startWatcher(): WatcherHandle` | Start a no-op alpha watcher for plugin SDK discovery. | +| `createSourceGraph` | function | `function createSourceGraph(files, contributions): SourceGraph` | Create a source graph snapshot from walked files and extracted contributions. | +| `createWatcherHandle` | function | `function createWatcherHandle(): WatcherHandle` | Create a no-op watcher handle for alpha SDK discovery. | +| `createInstrumentationBridge` | function | `function createInstrumentationBridge()` | Create a recording instrumentation bridge. | +| `createPluginContext` | function | `function createPluginContext(projectRoot: string): PluginContext` | Create a minimal plugin context for SDK runtime helpers. | +| `createPluginHostBootstrap` | function | `function createPluginHostBootstrap(plugins): PluginHostBootstrap` | Create a plugin host bootstrap snapshot from a validated composition; throws `PluginCompositionError`. | +| `runDoctorReport` | function | `function runDoctorReport(plugin: string, checks): DoctorReport` | Run plugin doctor checks and return an aggregate report. | +| `AstExtractor` | class | class | Extractor for exported plugin contribution builder call sites. | +| `FilesystemWalker` | class | class | Filesystem walker for plugin source discovery. | +| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | +| `ModuleManifestResolver` | class | class | Manifest resolver backed by dynamic imports. | +| `RegistryEmitter` | class | class | Registry emitter that writes one generated TypeScript module per contribution axis. | +| `EmitterPort` | interface | interface | Port for emitting generated plugin registry files. | +| `ExtractorPort` | interface | interface | Port for extracting plugin contributions from walked files. | +| `ManifestResolverPort` | interface | interface | Port for resolving a plugin manifest from a package or module specifier. | +| `WalkerPort` | interface | interface | Port for discovering plugin source files. | +| `WalkedFile` | interface | interface | File discovered by a plugin source walker. | +| `SourceGraph` | interface | interface | Source graph snapshot produced by discovery. | +| `RegistryEmission` | interface | interface | Output emitted by the registry emitter. | +| `ExtractedContribution` | interface | interface | Extracted contribution candidate from source. | +| `WatcherHandle` | interface | interface | Watcher handle returned by SDK watch presets. | +| `ModuleManifestResolverOptions` | interface | interface | Options for resolving manifests from importable module specifiers. | +| `RunWalkerPipelineOptions` | interface | interface | Options for running the SDK walker pipeline. | +| `InstrumentationBridge` | interface | interface | Bridge between plugin runtime and telemetry instrumentation. | +| `PluginHostBootstrap` | interface | interface | Result of bootstrapping plugin host state. | +| `PluginServiceContext` | interface | interface | Context supplied to a plugin service at runtime. | This entrypoint also re-exports `BackgroundProcessorContribution`, `ContractVersionContribution`, `DbSchemaContribution`, `E2eContribution`, `MigrationContribution`, `PluginContributions`, @@ -316,35 +316,35 @@ root/config surface, plus `DoctorCheck` and `DoctorReport` from the CLI surface. ## `@netscript/plugin/loader` -| Symbol | Kind | Signature | Description | -| -------------------- | --------- | --------------------------------------------------------------- | --------------------------------------------------------- | -| `createPluginLogger` | function | `function createPluginLogger(pluginName: string): PluginLogger` | Create a logger scoped to a plugin service process. | -| `PluginLogger` | interface | `interface PluginLogger` | Minimal logger shape supplied to plugin service contexts. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createPluginLogger` | function | `function createPluginLogger(pluginName: string): PluginLogger` | Create a logger scoped to a plugin service process. | +| `PluginLogger` | interface | `interface PluginLogger` | Minimal logger shape supplied to plugin service contexts. | ## `@netscript/plugin/protocol` -| Symbol | Kind | Description | -| ------------------------------------- | ---------- | ------------------------------------------------------------------- | -| `parsePluginManifest` | function | Parse and validate a plugin manifest without executing plugin code. | -| `PLUGIN_MANIFEST_SCHEMA_VERSION` | const | Current published schema version for `scaffold.plugin.json`. | -| `PluginInstallerManifestSchema` | const | Validator for the published plugin installer manifest. | -| `PluginInstallerManifest` | interface | Published `scaffold.plugin.json` contract consumed by installers. | -| `PluginInstallerManifestSchemaIssue` | interface | Validation issue exposed by the installer manifest schema. | -| `PluginInstallerManifestValidator` | interface | Stable validation surface for the installer manifest schema. | -| `PluginManifestCapabilities` | interface | Capability summary statically declared by a plugin manifest. | -| `PluginManifestLinking` | interface | Declarative resource-linking contract for plugins. | -| `PluginManifestLinkingConsumers` | interface | Named host resources that consume a plugin producer. | -| `PluginManifestOfficialSource` | interface | Compatibility metadata for first-party source-copy discovery. | -| `PluginManifestParseError` | interface | Validation failure returned when a manifest cannot be parsed. | -| `PluginManifestParseIssue` | interface | One validation issue returned by manifest parsing. | -| `PluginManifestParseResult` | type alias | Result returned by static plugin manifest parsing. | -| `PluginManifestPostScript` | interface | Script export executed after a plugin-owned scaffold succeeds. | -| `PluginManifestProvider` | interface | Compatibility metadata for plugin-kind provider registration. | -| `PluginManifestScaffolder` | interface | Plugin-owned scaffold entrypoint declared by the manifest. | -| `PluginScaffolderRequiredPermissions` | interface | Deno permissions required by a plugin-owned scaffolder. | -| `PluginScaffoldEntrypoint` | type alias | Signature implemented by plugin-owned `./scaffold` exports. | -| `ScaffolderContext` | interface | Context supplied by an installer to a plugin-owned scaffolder. | -| `ScaffoldResult` | interface | Result returned by a plugin-owned scaffolder. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `parsePluginManifest` | function | Parse and validate a plugin manifest without executing plugin code. | +| `PLUGIN_MANIFEST_SCHEMA_VERSION` | const | Current published schema version for `scaffold.plugin.json`. | +| `PluginInstallerManifestSchema` | const | Validator for the published plugin installer manifest. | +| `PluginInstallerManifest` | interface | Published `scaffold.plugin.json` contract consumed by installers. | +| `PluginInstallerManifestSchemaIssue` | interface | Validation issue exposed by the installer manifest schema. | +| `PluginInstallerManifestValidator` | interface | Stable validation surface for the installer manifest schema. | +| `PluginManifestCapabilities` | interface | Capability summary statically declared by a plugin manifest. | +| `PluginManifestLinking` | interface | Declarative resource-linking contract for plugins. | +| `PluginManifestLinkingConsumers` | interface | Named host resources that consume a plugin producer. | +| `PluginManifestOfficialSource` | interface | Compatibility metadata for first-party source-copy discovery. | +| `PluginManifestParseError` | interface | Validation failure returned when a manifest cannot be parsed. | +| `PluginManifestParseIssue` | interface | One validation issue returned by manifest parsing. | +| `PluginManifestParseResult` | type alias | Result returned by static plugin manifest parsing. | +| `PluginManifestPostScript` | interface | Script export executed after a plugin-owned scaffold succeeds. | +| `PluginManifestProvider` | interface | Compatibility metadata for plugin-kind provider registration. | +| `PluginManifestScaffolder` | interface | Plugin-owned scaffold entrypoint declared by the manifest. | +| `PluginScaffolderRequiredPermissions` | interface | Deno permissions required by a plugin-owned scaffolder. | +| `PluginScaffoldEntrypoint` | type alias | Signature implemented by plugin-owned `./scaffold` exports. | +| `ScaffolderContext` | interface | Context supplied by an installer to a plugin-owned scaffolder. | +| `ScaffoldResult` | interface | Result returned by a plugin-owned scaffolder. | This entrypoint also re-exports the root `PluginLogger` type. @@ -371,16 +371,16 @@ This entrypoint also re-exports the root `PluginLogger` type. ## `@netscript/plugin/testing` -| Symbol | Kind | Signature | Description | -| ----------------------------- | --------- | ------------------------------------------------------------------ | -------------------------------------------------------------- | -| `createPluginManifestFixture` | function | `function createPluginManifestFixture(overrides?): PluginManifest` | Example plugin manifest fixture. | -| `createWalkedFileFixture` | function | `function createWalkedFileFixture(overrides?): WalkedFile` | Example walked file fixture. | -| `runPluginCliContract` | function | `function runPluginCliContract(cli: PluginCli): boolean` | Run the shared plugin CLI contract against a CLI instance. | -| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | -| `MemoryWalker` | class | class | In-memory walker for plugin source discovery. | -| `MemoryEmitter` | class | class | In-memory registry emitter for plugin tests. | -| `MemoryFileSystemAdapter` | class | class | In-memory file system adapter for plugin tests. | -| `FileSystemPort` | interface | interface | Minimal file system port used by plugin scaffolding. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createPluginManifestFixture` | function | `function createPluginManifestFixture(overrides?): PluginManifest` | Example plugin manifest fixture. | +| `createWalkedFileFixture` | function | `function createWalkedFileFixture(overrides?): WalkedFile` | Example walked file fixture. | +| `runPluginCliContract` | function | `function runPluginCliContract(cli: PluginCli): boolean` | Run the shared plugin CLI contract against a CLI instance. | +| `MemoryManifestResolver` | class | class | In-memory manifest resolver used by tests and alpha SDK stubs. | +| `MemoryWalker` | class | class | In-memory walker for plugin source discovery. | +| `MemoryEmitter` | class | class | In-memory registry emitter for plugin tests. | +| `MemoryFileSystemAdapter` | class | class | In-memory file system adapter for plugin tests. | +| `FileSystemPort` | interface | interface | Minimal file system port used by plugin scaffolding. | This entrypoint also re-exports the root/config symbols `BackgroundProcessorContribution`, `ContractVersionContribution`, `DbSchemaContribution`, `E2eContribution`, `MigrationContribution`, @@ -393,27 +393,27 @@ This entrypoint also re-exports the root/config symbols `BackgroundProcessorCont ## `@netscript/plugin/templates` -| Symbol | Kind | Description | -| ---------------------------------- | ---------- | --------------------------------------------------------------- | -| `PLUGIN_SKELETON_TEMPLATE_CONTENT` | const | Embedded text for every default plugin skeleton template asset. | -| `PLUGIN_SKELETON_TEMPLATES` | const | Paths for plugin skeleton template assets. | -| `PluginSkeletonTemplatePath` | type alias | Plugin skeleton template path. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `PLUGIN_SKELETON_TEMPLATE_CONTENT` | const | Embedded text for every default plugin skeleton template asset. | +| `PLUGIN_SKELETON_TEMPLATES` | const | Paths for plugin skeleton template assets. | +| `PluginSkeletonTemplatePath` | type alias | Plugin skeleton template path. | ## `@netscript/plugin/contract-base` -| Symbol | Kind | Description | -| ----------------------------- | ---------- | ------------------------------------------------------------ | -| `BASE_PLUGIN_ERRORS` | const | Base oRPC error-map fragment shared by plugin contracts. | -| `BasePluginErrorCode` | type alias | Literal error codes guaranteed by `BASE_PLUGIN_ERRORS`. | -| `BasePluginErrorDefinition` | interface | One entry in a plugin contract's oRPC error map. | -| `InternalErrorData` | interface | Error payload reported for unexpected internal failures. | -| `PluginCapabilities` | interface | Marketplace-discoverable description of a running plugin. | -| `PluginCapabilitiesSchema` | const | Output schema for the mandatory plugin `describe` route. | -| `PluginCapabilitiesValidator` | interface | Structural validator for plugin capability documents. | -| `BASE_PLUGIN_CONTRACT_ROUTES` | const | Mandatory route fragment shared by feature plugin contracts. | -| `BasePluginContract` | interface | Minimum route surface every plugin contract must satisfy. | -| `BasePluginDescribeProcedure` | type alias | Mandatory `describe` procedure shape for plugin contracts. | -| `BasePluginDescribeRoute` | type alias | Explicit type of the base contract's `describe` route. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `BASE_PLUGIN_ERRORS` | const | Base oRPC error-map fragment shared by plugin contracts. | +| `BasePluginErrorCode` | type alias | Literal error codes guaranteed by `BASE_PLUGIN_ERRORS`. | +| `BasePluginErrorDefinition` | interface | One entry in a plugin contract's oRPC error map. | +| `InternalErrorData` | interface | Error payload reported for unexpected internal failures. | +| `PluginCapabilities` | interface | Marketplace-discoverable description of a running plugin. | +| `PluginCapabilitiesSchema` | const | Output schema for the mandatory plugin `describe` route. | +| `PluginCapabilitiesValidator` | interface | Structural validator for plugin capability documents. | +| `BASE_PLUGIN_CONTRACT_ROUTES` | const | Mandatory route fragment shared by feature plugin contracts. | +| `BasePluginContract` | interface | Minimum route surface every plugin contract must satisfy. | +| `BasePluginDescribeProcedure` | type alias | Mandatory `describe` procedure shape for plugin contracts. | +| `BasePluginDescribeRoute` | type alias | Explicit type of the base contract's `describe` route. | ## `@netscript/plugin/service` @@ -462,23 +462,22 @@ default; the factory does not merge another policy into it. ## `@netscript/plugin/health` -| Symbol | Kind | Description | -| ---------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------- | -| `ChildHealthState` | type alias | Closed child state vocabulary: starting, ready, degraded, crash-looping, stopped, failed. | -| `ChildHealthSnapshot` | type alias | State, registry/dependency readiness, restart count, and redacted fatal incident. | -| `ChildFatalError` | type alias | Fixed redacted message and epoch-millisecond capture timestamp. | -| `CHILD_CRASH_LOOP_THRESHOLD` | const | Three restarts in 60 seconds; recovery requires a clean running minute. | -| `summarizePluginHealth` | function | Shared cross-plugin precedence: unhealthy, degraded, unknown, then healthy; an empty set is unknown. | -| `aggregatePluginHealth` | function | Shared API/child aggregation: healthy, degraded, unhealthy, or unknown; missing children cannot be green. | -| `PluginHealthSummary` | interface | Plugin identity, declared names, per-resource states, and one canonical verdict. | -| `ChildHealthMonitor` | class | Tracks readiness and bounded restart history with an injectable clock. | -| `childHealthResponse` | function | Returns HTTP 200 only for ready with both readiness checks complete; otherwise 503. | -| `runChildHealthProcess` | function | Starts loopback health before bootstrap; drains owned resources and exits 0 clean, 1 failed or 2 timed out. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `ChildHealthState` | type alias | Closed child state vocabulary: starting, ready, degraded, crash-looping, stopped, failed. | +| `ChildHealthSnapshot` | type alias | State, registry/dependency readiness, restart count, and redacted fatal incident. | +| `ChildFatalError` | type alias | Fixed redacted message and epoch-millisecond capture timestamp. | +| `CHILD_CRASH_LOOP_THRESHOLD` | const | Three restarts in 60 seconds; recovery requires a clean running minute. | +| `summarizePluginHealth` | function | Shared cross-plugin precedence: unhealthy, degraded, unknown, then healthy; an empty set is unknown. | +| `aggregatePluginHealth` | function | Shared API/child aggregation: healthy, degraded, unhealthy, or unknown; missing children cannot be green. | +| `PluginHealthSummary` | interface | Plugin identity, declared names, per-resource states, and one canonical verdict. | +| `ChildHealthMonitor` | class | Tracks readiness and bounded restart history with an injectable clock. | +| `childHealthResponse` | function | Returns HTTP 200 only for ready with both readiness checks complete; otherwise 503. | +| `runChildHealthProcess` | function | Starts loopback health before bootstrap; drains owned resources and exits 0 clean, 1 failed or 2 timed out. | Workers, triggers, and sagas runtime entrypoints also re-export the shared health types. The child health payload is bounded and excludes raw exception messages and stacks. Dependency readiness -records startup checks and listener failures. Generated AppHost probes and doctor/MCP aggregation -consume the same child contract. +records startup checks and listener failures. Generated AppHost probes and doctor/MCP aggregation consume the same child contract. Registry readiness records loaded and validated definitions; runtime registration belongs to dependency readiness. Crash-loop recovery requires a full 60 seconds of uninterrupted running with diff --git a/docs/site/reference/service/index.md b/docs/site/reference/service/index.md index 5af0f81697..793288cf07 100644 --- a/docs/site/reference/service/index.md +++ b/docs/site/reference/service/index.md @@ -1,6 +1,6 @@ --- layout: layouts/base.vto -title: '@netscript/service' +title: "@netscript/service" --- # `@netscript/service` @@ -11,16 +11,16 @@ authentication and command execution. ## Sub-path exports -| Export | Entrypoint | Purpose | -| ---------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `@netscript/service` | `./mod.ts` | Full service surface: [builder and presets](#builder-and-presets), [health](#health-primitives), [handlers](#rpc-openapi-and-docs-handlers), [limits](#request-body-limit) and types. | -| `@netscript/service/auth` | `./src/auth/mod.ts` | [Service authentication and authorization handlers](#netscriptserviceauth-surface). | -| `@netscript/service/rate-limit` | `./src/rate-limit/mod.ts` | [Route quotas, atomic stores, and trusted client-address resolution](#rate-limits-and-client-addresses). | -| `@netscript/service/rpc-path` | `./src/primitives/rpc-path.ts` | Type-safe RPC route mapping utilities. | -| `@netscript/service/internal-credential` | `./src/auth/internal-credential/mod.ts` | [Dependency-free installation secret loading and internal credential derivation](#internal-procedures-and-the-internal-service-credential). | -| `@netscript/service/commands` | `./commands.ts` | [Opaque command definitions, once-only executor and codecs](#command-definitions-and-codecs). | -| `@netscript/service/commands/relay` | `./commands-relay.ts` | [Decoded bounded relay and checked sink lifecycle](#command-outbox-relay). | -| `@netscript/service/commands/testing` | `./commands-testing.ts` | [Atomic memory store and explicit test controls](#command-testing). | +| Export | Entrypoint | Purpose | +| --- | --- | --- | +| `@netscript/service` | `./mod.ts` | Full service surface: [builder and presets](#builder-and-presets), [health](#health-primitives), [handlers](#rpc-openapi-and-docs-handlers), [limits](#request-body-limit) and types. | +| `@netscript/service/auth` | `./src/auth/mod.ts` | [Service authentication and authorization handlers](#netscriptserviceauth-surface). | +| `@netscript/service/rate-limit` | `./src/rate-limit/mod.ts` | [Route quotas, atomic stores, and trusted client-address resolution](#rate-limits-and-client-addresses). | +| `@netscript/service/rpc-path` | `./src/primitives/rpc-path.ts` | Type-safe RPC route mapping utilities. | +| `@netscript/service/internal-credential` | `./src/auth/internal-credential/mod.ts` | [Dependency-free installation secret loading and internal credential derivation](#internal-procedures-and-the-internal-service-credential). | +| `@netscript/service/commands` | `./commands.ts` | [Opaque command definitions, once-only executor and codecs](#command-definitions-and-codecs). | +| `@netscript/service/commands/relay` | `./commands-relay.ts` | [Decoded bounded relay and checked sink lifecycle](#command-outbox-relay). | +| `@netscript/service/commands/testing` | `./commands-testing.ts` | [Atomic memory store and explicit test controls](#command-testing). | The package has three layers: @@ -40,57 +40,57 @@ describe a service surface; the runtime still uses the real Hono app and oRPC ha ## Builder and presets -| Symbol | Kind | Signature | Description | -| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -| `createService` | function | `function createService(router: T, config: ServiceConfig): ServiceBuilder` | Factory function to create a new service builder. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createService` | function | `function createService(router: T, config: ServiceConfig): ServiceBuilder` | Factory function to create a new service builder. | | `defineService` | function | `async function defineService(router: T, options: DefineServiceOptions): Promise` | One-liner preset for creating a fully-configured service. | ## Health primitives -| Symbol | Kind | Signature | Description | -| ------------------------ | -------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | -| `createHealthHandler` | function | `function createHealthHandler(options?: HealthHandlerOptions): ServiceHandler` | Creates a comprehensive health check handler that runs all checks in parallel. | -| `createLivenessHandler` | function | `function createLivenessHandler(): ServiceHandler` | Creates a simple liveness check handler. | -| `createReadinessHandler` | function | `function createReadinessHandler(checks: Array<() => Promise>): ServiceHandler` | Creates a readiness check handler that runs multiple async checks. | -| `healthChecks` | const | `const healthChecks: { database; kv; service; custom }` | Pre-built health checks for common dependencies (`database`, `kv`, `service`, `custom`). | -| `HEALTH_STATUS` | const | `const HEALTH_STATUS: { healthy; degraded; unhealthy }` | Health status values emitted by service health handlers. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createHealthHandler` | function | `function createHealthHandler(options?: HealthHandlerOptions): ServiceHandler` | Creates a comprehensive health check handler that runs all checks in parallel. | +| `createLivenessHandler` | function | `function createLivenessHandler(): ServiceHandler` | Creates a simple liveness check handler. | +| `createReadinessHandler` | function | `function createReadinessHandler(checks: Array<() => Promise>): ServiceHandler` | Creates a readiness check handler that runs multiple async checks. | +| `healthChecks` | const | `const healthChecks: { database; kv; service; custom }` | Pre-built health checks for common dependencies (`database`, `kv`, `service`, `custom`). | +| `HEALTH_STATUS` | const | `const HEALTH_STATUS: { healthy; degraded; unhealthy }` | Health status values emitted by service health handlers. | ## RPC, OpenAPI, and docs handlers -| Symbol | Kind | Signature | Description | -| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | -| `createRPCHandler` | function | `function createRPCHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC RPC handler for type-safe client communication. | -| `createRPCPlugins` | function | `function createRPCPlugins(config: RPCHandlerConfig): ServiceHandlerPlugin[]` | Creates the standard set of oRPC plugins. | -| `createOpenAPIHandler` | function | `function createOpenAPIHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC OpenAPI handler for REST-style API access. | -| `createOpenAPISpec` | function | `function createOpenAPISpec(router: T, config: OpenAPIConfig): ServiceHandler` | Creates an OpenAPI specification endpoint handler. | -| `createScalarDocs` | function | `function createScalarDocs(options: ScalarDocsOptions): ServiceHandler` | Creates a Scalar API documentation UI handler. | -| `createScalarJs` | function | `function createScalarJs(): ServiceHandler` | Creates a handler to serve the bundled Scalar JS file. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createRPCHandler` | function | `function createRPCHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC RPC handler for type-safe client communication. | +| `createRPCPlugins` | function | `function createRPCPlugins(config: RPCHandlerConfig): ServiceHandlerPlugin[]` | Creates the standard set of oRPC plugins. | +| `createOpenAPIHandler` | function | `function createOpenAPIHandler(router: T, config?: RPCHandlerConfig): FetchHandler` | Creates an oRPC OpenAPI handler for REST-style API access. | +| `createOpenAPISpec` | function | `function createOpenAPISpec(router: T, config: OpenAPIConfig): ServiceHandler` | Creates an OpenAPI specification endpoint handler. | +| `createScalarDocs` | function | `function createScalarDocs(options: ScalarDocsOptions): ServiceHandler` | Creates a Scalar API documentation UI handler. | +| `createScalarJs` | function | `function createScalarJs(): ServiceHandler` | Creates a handler to serve the bundled Scalar JS file. | When a procedure declares `NetScriptProcedureMeta.access`, `createOpenAPISpec()` preserves the operation and projects access as follows: -| Contract declaration | OpenAPI operation | -| ------------------------------ | --------------------------------------------- | -| `authentication: 'none'` | `security: []` | -| `authentication: 'required'` | `security: [{ bearerAuth: scopes }]` | -| Required `authorization.roles` | `x-netscript-roles: roles` | -| `authentication: 'optional'` | `security: [{}, { bearerAuth: [] }]` | -| No authentication declaration | No generated operation-level `security` field | +| Contract declaration | OpenAPI operation | +| --- | --- | +| `authentication: 'none'` | `security: []` | +| `authentication: 'required'` | `security: [{ bearerAuth: scopes }]` | +| Required `authorization.roles` | `x-netscript-roles: roles` | +| `authentication: 'optional'` | `security: [{}, { bearerAuth: [] }]` | +| No authentication declaration | No generated operation-level `security` field | The generated `bearerAuth` component uses HTTP bearer authentication. Optional access stays visible in the generated specification even though the contract authorizer rejects it at construction. ## Request-body limit -| Symbol | Kind | Signature | Description | -| --------------------------- | -------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | | `createBodyLimitMiddleware` | function | `function createBodyLimitMiddleware(options: ServiceBodyLimitOptions): ServiceMiddleware` | Creates middleware that rejects request bodies larger than `maxBytes` with a typed JSON `413` before any handler parses them. Throws `RangeError` unless `maxBytes` is a positive safe integer. | -| `PAYLOAD_TOO_LARGE_ERROR` | const | `const PAYLOAD_TOO_LARGE_ERROR: 'PAYLOAD_TOO_LARGE'` | Error code carried by the JSON body of a `413` body-limit rejection. | +| `PAYLOAD_TOO_LARGE_ERROR` | const | `const PAYLOAD_TOO_LARGE_ERROR: 'PAYLOAD_TOO_LARGE'` | Error code carried by the JSON body of a `413` body-limit rejection. | The builder form is `createService(...).withBodyLimit({ maxBytes })` and the preset form is `defineService(router, { bodyLimit: { maxBytes } })`. A request that declares `Content-Length` is -rejected from the header. A chunked request is counted as it streams and rejected once it passes the -limit, so at most `maxBytes` plus one chunk is buffered. The rejection body is a +rejected from the header. A chunked request is counted as it streams and rejected once it passes +the limit, so at most `maxBytes` plus one chunk is buffered. The rejection body is a `PayloadTooLargeResponse`: `{ error: 'PAYLOAD_TOO_LARGE', message, maxBytes }`. There is no read timeout. @@ -98,16 +98,16 @@ timeout. `defineService` and a builder chain installed in the same order produce this request pipeline: -| Order | Stage | Installed by | -| ----- | -------------------------------------------------------------- | ---------------------------------------------------------------------------- | -| 1 | Tracing | always, at construction | -| 2 | CORS | `withCors()` | -| 3 | Request logging | `withLogger()` | -| 4 | Caller middleware, in order | `use()` / `DefineServiceOptions.middleware` | -| 5 | Authentication, then authorization | `withAuthn()` / `withAuthz()`, installed by `build()` | -| 6 | Request-body limit | `withBodyLimit()` / `DefineServiceOptions.bodyLimit`, installed by `build()` | -| 7 | Health, liveness and readiness routes | `withHealth()`, installed by `build()` | -| 8 | OpenAPI spec, docs, RPC and OpenAPI projections, custom routes | `build()` | +| Order | Stage | Installed by | +| --- | --- | --- | +| 1 | Tracing | always, at construction | +| 2 | CORS | `withCors()` | +| 3 | Request logging | `withLogger()` | +| 4 | Caller middleware, in order | `use()` / `DefineServiceOptions.middleware` | +| 5 | Authentication, then authorization | `withAuthn()` / `withAuthz()`, installed by `build()` | +| 6 | Request-body limit | `withBodyLimit()` / `DefineServiceOptions.bodyLimit`, installed by `build()` | +| 7 | Health, liveness and readiness routes | `withHealth()`, installed by `build()` | +| 8 | OpenAPI spec, docs, RPC and OpenAPI projections, custom routes | `build()` | `use()` registers middleware immediately, so builder middleware runs in call order relative to `withCors()` and `withLogger()`. It always runs before the stages that `build()` installs. A @@ -117,33 +117,33 @@ rejection returned at stage 4 or 6 keeps the CORS headers and is logged. `createService(...).withRateLimit(options)` adds middleware through `use()`. It runs in call order, before deferred health routes and both RPC/REST projections, including when added after -`withHealth()`. Install it before `withServiceInfo()` if the immediate service-info route should be -limited. Repeated calls add stages. Configure health checks before building. +`withHealth()`. Install it before `withServiceInfo()` if the immediate service-info route should +be limited. Repeated calls add stages. Configure health checks before building. The root also exports `ServiceRateLimitOptions`, `ServiceProxyTrust`, `RateLimitStore`, `RateLimitRequest`, and `RateLimitDecision` for builder/port contracts. The `@netscript/service/rate-limit` subpath exposes: -| Symbol | Kind | Description | -| ----------------------------- | ---------- | ---------------------------------------------------------------------------------------------- | -| `createRateLimitMiddleware` | function | Creates route-scoped quota middleware returning JSON 429 and whole-second Retry-After. | -| `createKvRateLimitStore` | function | Uses KV atomic compare-and-set plus TTL in a dedicated prefix, with a bounded retry budget. | -| `createMemoryRateLimitStore` | function | Creates a synchronous, capped development store with bounded TTL eviction. | -| `resolveServiceClientAddress` | function | Resolves the socket peer or explicitly trusted XFF hops, walking right to left. | -| `ServiceRateLimitOptions` | interface | `routes`, `limit`, `windowMs`, `store`, and optional `key`, `trustProxy`, `ipv6Prefix`, `now`. | -| `ServiceProxyTrust` | type alias | `false` or an address predicate identifying trusted proxy hops; default off. | -| `RateLimitStore` | interface | Port reserving one slot atomically with `consume(request)`. | -| `RateLimitRequest` | interface | Key, quota, window, epoch milliseconds, and optional request cancellation signal. | -| `RateLimitDecision` | interface | Whether a slot was reserved and the epoch-millisecond window end. | -| `KvRateLimitStoreOptions` | interface | Dedicated `prefix` and optional `maxAttempts` (default 8, maximum 32). | -| `MemoryRateLimitStoreOptions` | interface | Optional retained-key cap `maxKeys` (default 10,000). | +| Symbol | Kind | Description | +| --- | --- | --- | +| `createRateLimitMiddleware` | function | Creates route-scoped quota middleware returning JSON 429 and whole-second Retry-After. | +| `createKvRateLimitStore` | function | Uses KV atomic compare-and-set plus TTL in a dedicated prefix, with a bounded retry budget. | +| `createMemoryRateLimitStore` | function | Creates a synchronous, capped development store with bounded TTL eviction. | +| `resolveServiceClientAddress` | function | Resolves the socket peer or explicitly trusted XFF hops, walking right to left. | +| `ServiceRateLimitOptions` | interface | `routes`, `limit`, `windowMs`, `store`, and optional `key`, `trustProxy`, `ipv6Prefix`, `now`. | +| `ServiceProxyTrust` | type alias | `false` or an address predicate identifying trusted proxy hops; default off. | +| `RateLimitStore` | interface | Port reserving one slot atomically with `consume(request)`. | +| `RateLimitRequest` | interface | Key, quota, window, epoch milliseconds, and optional request cancellation signal. | +| `RateLimitDecision` | interface | Whether a slot was reserved and the epoch-millisecond window end. | +| `KvRateLimitStoreOptions` | interface | Dedicated `prefix` and optional `maxAttempts` (default 8, maximum 32). | +| `MemoryRateLimitStoreOptions` | interface | Optional retained-key cap `maxKeys` (default 10,000). | The subpath also re-exports the first-party integration types `ServiceContext`, `ServiceEnvironment`, `ServiceMiddleware`, `KvStore`, `KvKey`, `KvEntry`, `KvListOptions`, -`KvSetOptions`, `AtomicCheck`, `AtomicMutation`, and `AtomicResult` used by these signatures. The -`KvStore` port references the six KV types through its public methods, so they are re-exported with -it rather than duplicated. +`KvSetOptions`, `AtomicCheck`, `AtomicMutation`, and `AtomicResult` used by these signatures. +The `KvStore` port references the six KV types through its public methods, so they are re-exported +with it rather than duplicated. Selected routes share one quota per key and epoch-aligned window. Paths are exact or end in `/*` for a subtree (including its root). Rejections return `{ error: 'RATE_LIMITED' }` with `429` and @@ -154,12 +154,12 @@ retry exhaustion or memory capacity pressure rejects conservatively; store failu `ServiceEnvironment` is exported from the root entrypoint. `ServiceApp.fetch(request, env)` and `ServiceApp.request(input, init, env)` accept it. The listener supplies `remoteAddr` on plain and TLS requests so Hono's Deno `getConnInfo` works. The default limiter key is the resolved client -address; IPv6 keys are canonicalized and grouped by /64, with `ipv6Prefix` (0–128) selecting another -prefix. IPv4-mapped IPv6 peers use their corresponding dotted IPv4 bucket before prefix masking, so -distinct IPv4 clients retain independent quotas on dual-stack listeners. Native IPv4 and custom keys -stay unchanged. This grouping affects quota keys only, not socket metadata or proxy trust. A mounted -app without metadata uses a shared `unknown` bucket and logs a warning once per stage through the -request logger or service package logger. +address; IPv6 keys are canonicalized and grouped by /64, with `ipv6Prefix` (0–128) selecting +another prefix. IPv4-mapped IPv6 peers use their corresponding dotted IPv4 bucket before prefix +masking, so distinct IPv4 clients retain independent quotas on dual-stack listeners. Native IPv4 +and custom keys stay unchanged. This grouping affects quota keys only, not +socket metadata or proxy trust. A mounted app without metadata uses a shared `unknown` bucket and +logs a warning once per stage through the request logger or service package logger. > [!CAUTION] > KV counter TTL bounds each key's lifetime, not total live cardinality. Distinct attacker-chosen @@ -176,51 +176,51 @@ examples and storage/performance guarantees. ## Error and routing handlers -| Symbol | Kind | Signature | Description | -| ----------------------- | -------- | ----------------------------------------------------------------------- | ------------------------------------------------------- | -| `createErrorHandler` | function | `function createErrorHandler(serviceName: string): ServiceErrorHandler` | Creates a global error handler for uncaught exceptions. | -| `createNotFoundHandler` | function | `function createNotFoundHandler(serviceName: string): ServiceHandler` | Creates a 404 Not Found handler for unmatched routes. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createErrorHandler` | function | `function createErrorHandler(serviceName: string): ServiceErrorHandler` | Creates a global error handler for uncaught exceptions. | +| `createNotFoundHandler` | function | `function createNotFoundHandler(serviceName: string): ServiceHandler` | Creates a 404 Not Found handler for unmatched routes. | ## Configuration and option types -| Symbol | Kind | Description | -| ------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ServiceConfig` | interface | Service configuration options (input to `createService`). | -| `DefineServiceOptions` | interface | Options for the `defineService` preset, including `cors` (explicit origins or the `NETSCRIPT_CORS_ORIGINS` workspace allowlist), `middleware` (caller middleware after CORS and logging, before auth) and the opt-in `bodyLimit`. | -| `ServiceBodyLimitOptions` | interface | `{ maxBytes }` request-body limit accepted by `withBodyLimit()` and `DefineServiceOptions.bodyLimit`. | -| `PayloadTooLargeResponse` | interface | JSON body of a `413` body-limit rejection: `{ error: 'PAYLOAD_TOO_LARGE', message, maxBytes }`. | -| `ServeOptions` | interface | Options for starting a service listener. | -| `CorsOptions` | interface | CORS options supported by `withCors()`. Omitted `origin` reads comma-separated exact HTTP(S) origins from `NETSCRIPT_CORS_ORIGINS`; unset/blank denies cross-origin access. Explicit origins override the environment; wildcard with credentials fails `build()`. | -| `OpenAPIConfig` | interface | Configuration for OpenAPI spec generation. | -| `RPCHandlerConfig` | interface | Configuration options for RPC handlers. | -| `ScalarDocsOptions` | interface | Configuration for the Scalar docs UI. | -| `HealthHandlerOptions` | interface | Options for `createHealthHandler`. | -| `LoggerMiddlewareOptions` | interface | Options for the logger middleware (re-exported from `@netscript/logger/middleware`). | +| Symbol | Kind | Description | +| --- | --- | --- | +| `ServiceConfig` | interface | Service configuration options (input to `createService`). | +| `DefineServiceOptions` | interface | Options for the `defineService` preset, including `cors` (explicit origins or the `NETSCRIPT_CORS_ORIGINS` workspace allowlist), `middleware` (caller middleware after CORS and logging, before auth) and the opt-in `bodyLimit`. | +| `ServiceBodyLimitOptions` | interface | `{ maxBytes }` request-body limit accepted by `withBodyLimit()` and `DefineServiceOptions.bodyLimit`. | +| `PayloadTooLargeResponse` | interface | JSON body of a `413` body-limit rejection: `{ error: 'PAYLOAD_TOO_LARGE', message, maxBytes }`. | +| `ServeOptions` | interface | Options for starting a service listener. | +| `CorsOptions` | interface | CORS options supported by `withCors()`. Omitted `origin` reads comma-separated exact HTTP(S) origins from `NETSCRIPT_CORS_ORIGINS`; unset/blank denies cross-origin access. Explicit origins override the environment; wildcard with credentials fails `build()`. | +| `OpenAPIConfig` | interface | Configuration for OpenAPI spec generation. | +| `RPCHandlerConfig` | interface | Configuration options for RPC handlers. | +| `ScalarDocsOptions` | interface | Configuration for the Scalar docs UI. | +| `HealthHandlerOptions` | interface | Options for `createHealthHandler`. | +| `LoggerMiddlewareOptions` | interface | Options for the logger middleware (re-exported from `@netscript/logger/middleware`). | ### CORS origins -`DefineServiceOptions.cors` configures the same policy as `withCors()`. If `origin` is omitted, the -builder snapshots `NETSCRIPT_CORS_ORIGINS`: comma-separated exact HTTP(S) origins, without paths or -trailing slashes. Unset or blank means no cross-origin browser access. For example, -`NETSCRIPT_CORS_ORIGINS='https://app.example,https://admin.example'` permits those two origins. An -explicit `cors: { origin: ['https://app.example'] }` overrides the environment; `origin: []` denies -all cross-origin access. Invalid environment entries fail configuration. Wildcard origins with -`credentials: true` fail before the listener starts. +`DefineServiceOptions.cors` configures the same policy as `withCors()`. If `origin` is omitted, +the builder snapshots `NETSCRIPT_CORS_ORIGINS`: comma-separated exact HTTP(S) origins, without +paths or trailing slashes. Unset or blank means no cross-origin browser access. For example, +`NETSCRIPT_CORS_ORIGINS='https://app.example,https://admin.example'` permits those two origins. +An explicit `cors: { origin: ['https://app.example'] }` overrides the environment; `origin: []` +denies all cross-origin access. Invalid environment entries fail configuration. Wildcard origins +with `credentials: true` fail before the listener starts. Generated CLI/Aspire helpers supply the enabled web apps' allocated HTTP endpoint origins to every service and plugin service resource. This generated value overrides a declared resource environment value; a workspace without enabled web apps supplies an empty allowlist. Independent services must configure their launch environment themselves. Origins outside the allowlist receive no -`Access-Control-Allow-Origin` header. CORS controls browser response access; it does not -authenticate callers. +`Access-Control-Allow-Origin` header. CORS controls browser response access; it does not authenticate +callers. ### Listener bind address `ServeOptions.hostname` and `DefineServiceOptions.hostname` choose the interface the listener binds. The value is forwarded unchanged to `Deno.serve` on both the plain and the TLS listener, and -`RunningService.addr.hostname` reports the address that was bound. Omitting it keeps Deno's default, -so the listener binds every IPv4 interface (`0.0.0.0`). Pass `'127.0.0.1'` to keep an endpoint, such -as an unauthenticated local control surface, reachable only from the same machine. +`RunningService.addr.hostname` reports the address that was bound. Omitting it keeps Deno's +default, so the listener binds every IPv4 interface (`0.0.0.0`). Pass `'127.0.0.1'` to keep an +endpoint, such as an unauthenticated local control surface, reachable only from the same machine. ```ts import { createService } from '@netscript/service'; @@ -253,40 +253,40 @@ or `exitOnSignal: false` when the host owns termination and resource disposal. ## Service surface types -| Symbol | Kind | Description | -| -------------------------------- | ---------- | --------------------------------------------------------------------------------------------------- | -| `ServiceBuilder` | interface | Fluent builder for configuring and materializing a NetScript service. | -| `ServiceApp` | interface | Minimal mountable service application returned by `build()`. | -| `RunningService` | interface | Running service handle returned by `serve()` and `defineService()`. | -| `RunningServiceAddress` | interface | Network address assigned to a running service listener. | -| `ServiceContext` | interface | Minimal context shape exposed to service middleware and handlers. | -| `ServiceRequest` | interface | Minimal request shape exposed to service middleware and handlers. | -| `ServiceMiddleware` | interface | Middleware function accepted by the service builder. | -| `ServiceHandler` | interface | Service route handler accepted by the builder route API. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `ServiceBuilder` | interface | Fluent builder for configuring and materializing a NetScript service. | +| `ServiceApp` | interface | Minimal mountable service application returned by `build()`. | +| `RunningService` | interface | Running service handle returned by `serve()` and `defineService()`. | +| `RunningServiceAddress` | interface | Network address assigned to a running service listener. | +| `ServiceContext` | interface | Minimal context shape exposed to service middleware and handlers. | +| `ServiceRequest` | interface | Minimal request shape exposed to service middleware and handlers. | +| `ServiceMiddleware` | interface | Middleware function accepted by the service builder. | +| `ServiceHandler` | interface | Service route handler accepted by the builder route API. | | `ServiceHandlerContext` | type alias | Readonly custom context plus optional framework-owned `db`, `traceHeaders`, and `principal` fields. | -| `Principal` | interface | Authenticated identity with subject, readonly scopes/roles, scheme, and verified claims. | -| `ServiceHandlerPlugin` | interface | Structural oRPC plugin accepted by service handler factories. | -| `ServiceErrorHandler` | interface | Error handler used by service applications. | -| `FetchHandler` | interface | Structural fetch handler used by RPC and OpenAPI service adapters. | -| `FetchHandlerResult` | interface | Result returned by oRPC-compatible fetch handlers. | +| `Principal` | interface | Authenticated identity with subject, readonly scopes/roles, scheme, and verified claims. | +| `ServiceHandlerPlugin` | interface | Structural oRPC plugin accepted by service handler factories. | +| `ServiceErrorHandler` | interface | Error handler used by service applications. | +| `FetchHandler` | interface | Structural fetch handler used by RPC and OpenAPI service adapters. | +| `FetchHandlerResult` | interface | Result returned by oRPC-compatible fetch handlers. | ## Health types -| Symbol | Kind | Description | -| ---------------- | ---------- | ---------------------------------------------------------------------------------------------------------- | -| `HealthCheck` | interface | A single health check definition. | -| `HealthResponse` | interface | Response format for the health endpoint. | -| `Database` | interface | Database client capable of a health-check query. | -| `HealthStatus` | type alias | Health status emitted by the service health endpoint (`typeof HEALTH_STATUS[keyof typeof HEALTH_STATUS]`). | +| Symbol | Kind | Description | +| --- | --- | --- | +| `HealthCheck` | interface | A single health check definition. | +| `HealthResponse` | interface | Response format for the health endpoint. | +| `Database` | interface | Database client capable of a health-check query. | +| `HealthStatus` | type alias | Health status emitted by the service health endpoint (`typeof HEALTH_STATUS[keyof typeof HEALTH_STATUS]`). | ## Router and context type aliases -| Symbol | Kind | Signature | Description | -| -------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| `ServiceRouter` | type alias | `type ServiceRouter = Record` | Router definition accepted by the service builder and handler factories. | -| `ContextFactory` | type alias | `type ContextFactory> = (context: ServiceContext) => TCustom` | Creates the custom part of each service handler context. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `ServiceRouter` | type alias | `type ServiceRouter = Record` | Router definition accepted by the service builder and handler factories. | +| `ContextFactory` | type alias | `type ContextFactory> = (context: ServiceContext) => TCustom` | Creates the custom part of each service handler context. | | `ServiceHandlerContext` | type alias | `type ServiceHandlerContext> = Readonly & { db?; traceHeaders?; principal?; }` | Context visible after framework fields are composed. `principal` is optional and must be narrowed by handlers that require identity. | -| `DbContext` | type alias | `type DbContext = Record` | Database context injected into service handler context. | +| `DbContext` | type alias | `type DbContext = Record` | Database context injected into service handler context. | ## Contract-declared authentication and authorization @@ -323,14 +323,14 @@ const app = createService(router, { name: 'orders' }) Contract enforcement is opt-in: existing unguarded services, scaffolds, and standalone `createScopeAuthorizer()` consumers are unchanged. It activates only when an application passes a -`createContractAuthorizer(contract, { fallback?, rawRoutes?, retiredPaths? })` result to -`.withAuthz()`. +`createContractAuthorizer(contract, { fallback?, rawRoutes?, retiredPaths? })` result to `.withAuthz()`. -Contract metadata wins on disagreement. A match-aware fallback, including `createScopeAuthorizer()`, -is consulted only when a matched procedure has no access metadata. No metadata and no matching -fallback rule denies, regardless of the fallback's standalone `denyByDefault` option. The builder -binds one resolver to the actual REST and RPC paths and their aliases and shares it between authn -and authz, so a declared public procedure is not rejected by an earlier authentication stage. +Contract metadata wins on disagreement. A match-aware fallback, including +`createScopeAuthorizer()`, is consulted only when a matched procedure has no access metadata. No +metadata and no matching fallback rule denies, regardless of the fallback's standalone +`denyByDefault` option. The builder binds one resolver to the actual REST and RPC paths and their +aliases and shares it between authn and authz, so a declared public procedure is not rejected by an +earlier authentication stage. `createScopeAuthorizer()` is a supported standalone path-prefix authorizer and a match-aware migration fallback; it is not deprecated. @@ -363,11 +363,11 @@ These paths return **410** after authentication: ``` Missing or invalid credentials retain the existing 401 `UNAUTHORIZED` response without a procedure -code. Retirement requires authentication even outside `protect` or inside `allowAnonymous`. Active -REST/RPC procedures (including aliases), internal audience guards and declared raw routes win over -retirement. Their scope/role denials remain 403; public procedures stay public. A fallback cannot -turn a missing or retired path into an allowed request. Undeclared paths outside protected coverage -keep their previous behavior. +code. Retirement requires authentication even outside `protect` or inside `allowAnonymous`. +Active REST/RPC procedures (including aliases), internal audience guards and declared raw routes +win over retirement. Their scope/role denials remain 403; public procedures stay public. A fallback +cannot turn a missing or retired path into an allowed request. Undeclared paths outside protected +coverage keep their previous behavior. `retiredPaths` contains exact, case-sensitive, canonical mounted absolute paths for all methods, with query strings ignored. Declare REST/RPC/alias paths separately. No trailing slash, percent @@ -377,19 +377,18 @@ construction. Encoded requests, slash variants, siblings and descendants do not Parameterized retirement is unsupported; unmatched concrete paths under guard still return 404. Clients inspecting HTTP responses can map `procedure_retired` to “client too old” and offer an -upgrade without treating it as a permission denial. These are pre-dispatch middleware errors, not -contract-defined oRPC errors. Use the response JSON `code`, not its human-readable message. -`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are available at the root and `./auth`; -`AuthzDecision.code` is optional so existing authorizers preserve their 403 responses. The matched -branch of `ProcedurePolicyResolution` has an optional `retired?: true` marker; contract-overlay -authorizers never set it and retain their current fallback semantics. +upgrade without treating it as a permission denial. These are pre-dispatch middleware errors, +not contract-defined oRPC errors. Use the response JSON `code`, not its human-readable message. +`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are available at the root and +`./auth`; `AuthzDecision.code` is optional so existing authorizers preserve their 403 responses. +The matched branch of `ProcedurePolicyResolution` has an optional `retired?: true` marker; +contract-overlay authorizers never set it and retain their current fallback semantics. ### Raw routes beside a contract router -A request under the guarded prefix that matches no contract procedure returns 404 -`procedure_not_found` after authentication, with message `authz.no-contract-procedure`, including -raw routes added with `.route(method, path, handler)`. Declare each raw route that should be served -through the `rawRoutes` option: +A request under the guarded prefix that matches no contract procedure returns 404 `procedure_not_found` after authentication, with message +`authz.no-contract-procedure`, including raw routes added with `.route(method, path, handler)`. +Declare each raw route that should be served through the `rawRoutes` option: ```ts const authorizer = createContractAuthorizer(OrdersContractV1, { @@ -404,12 +403,12 @@ const app = createService(router, { name: 'orders' }) .build(); ``` -A declared raw route requires a successfully authenticated principal. This applies even when its -path is outside `protect` or inside `allowAnonymous`, so a declaration never makes a path public. An -optional `authorization: { scopes?, roles? }` is enforced like a procedure's declared authorization. -Matching is exact and case-sensitive, and ignores only a trailing slash. Declaring `/api/tools/mcp` -covers neither `/api/tools/mcp-admin` nor `/api/tools/mcp/nested`, and every undeclared guarded -sibling returns 404 `procedure_not_found` after authentication. +A declared raw route requires a successfully authenticated principal. This applies even when its path +is outside `protect` or inside `allowAnonymous`, so a declaration never makes a path public. An +optional `authorization: { scopes?, roles? }` is enforced like a procedure's declared +authorization. Matching is exact and case-sensitive, and ignores only a trailing slash. Declaring +`/api/tools/mcp` covers neither `/api/tools/mcp-admin` nor `/api/tools/mcp/nested`, and every +undeclared guarded sibling returns 404 `procedure_not_found` after authentication. Declarations are validated before any request. Construction throws `[netscript.service.contract-policy] invalid raw route: ...` for a path that is not absolute, @@ -421,36 +420,36 @@ path falls under an RPC mount or alias or matches a REST procedure path. Binding ### Internal procedures and the internal service credential -`.meta({ access: { audience: 'internal' } })` restricts a procedure to service-to-service callers of -the same installation: workers, sagas and triggers presenting the internal service credential. Both -contract authorizers enforce it on the RPC projection and on the OpenAPI projection, including +`.meta({ access: { audience: 'internal' } })` restricts a procedure to service-to-service callers +of the same installation: workers, sagas and triggers presenting the internal service credential. +Both contract authorizers enforce it on the RPC projection and on the OpenAPI projection, including oRPC's default OpenAPI path (`POST //`) when the contract declares no `route.path`. Requests resolve to the procedure oRPC executes: the undecoded pathname is matched -with oRPC's own route patterns and `rou3` precedence (static before parameter before wildcard), not -contract declaration order. A request using a method no procedure declares on an internal +with oRPC's own route patterns and `rou3` precedence (static before parameter before wildcard), +not contract declaration order. A request using a method no procedure declares on an internal procedure's OpenAPI path fails closed toward that procedure. A user session never satisfies the -audience, and the check uses the principal's identity, not its claims or roles. Construction throws -for an `'internal'` audience combined with `authentication: 'none'`, for any other audience value, -and for procedures with different access that share one OpenAPI route. +audience, and the check uses the principal's identity, not its claims or roles. Construction +throws for an `'internal'` audience combined with `authentication: 'none'`, for any other audience +value, and for procedures with different access that share one OpenAPI route. `createContractOverlayAuthorizer(contract, { fallback?, isInternalCaller? })` governs only procedures that declare `meta.access`. Every other request keeps the service's own policy: the -`protect`/`allowAnonymous` path guard, plus the optional fallback authorizer. Marking a few internal -procedures never forces authentication onto public ones. To keep an otherwise public service public, -set `allowAnonymous: ['/api', '/health']`; access-marked procedures are resolved before the path -guard. `createContractAuthorizer` also enforces the audience, but it still governs every procedure -in the contract. +`protect`/`allowAnonymous` path guard, plus the optional fallback authorizer. Marking a few +internal procedures never forces authentication onto public ones. To keep an otherwise +public service public, set `allowAnonymous: ['/api', '/health']`; access-marked procedures are +resolved before the path guard. `createContractAuthorizer` also enforces the audience, but it +still governs every procedure in the contract. The credential is derived from one per-installation secret. Carriers deliver `NETSCRIPT_INSTALLATION_SECRET_FILE`, a file reference, never the value. `loadInstallationSecret()` reads it once at startup. The file holds a textual secret, such as base64 or hex, with surrounding whitespace trimmed (4 KiB maximum, 32 bytes minimum). In-memory `Uint8Array` material passed to -`createInstallationSecret()` is used verbatim. Each service accepts only the bearer derived for its -own name (HKDF-SHA-256), so a credential cannot be replayed across services. A credential expires by -rotation: once the secret changes, every credential derived from the old one is rejected. -`createCompositeAuthenticator([...])` lets one guarded service accept the internal credential -alongside user sessions over the single `AuthenticatorPort`. Callers send the credential with the -SDK's `createInternalCredentialSdkClientContribution({ service })`. +`createInstallationSecret()` is used verbatim. Each service accepts only the bearer +derived for its own name (HKDF-SHA-256), so a credential cannot be replayed across services. A +credential expires by rotation: once the secret changes, every credential derived from the old one +is rejected. `createCompositeAuthenticator([...])` lets one guarded service accept the internal +credential alongside user sessions over the single `AuthenticatorPort`. Callers send the +credential with the SDK's `createInternalCredentialSdkClientContribution({ service })`. ```ts import { createService } from '@netscript/service'; @@ -479,23 +478,24 @@ const app = createService(router, { name: 'orders' }) ### Explicit service posture -`ServiceAuthPolicy` records either native guards (`{ authn, authz? }`) or a deliberate public -opt-out (`{ public: true, reason }`). `ServiceGuardedAuthPolicy` and `ServicePublicAuthPolicy` are -mutually exclusive; a public reason must be nonblank. `assertServiceAuthPolicy(value)` rejects -absent or ambiguous postures and malformed callable ports with a redacted `TypeError`. It preserves -the original options: a custom `allowAnonymous` list replaces the native default; the assertion does -not add `/health`. It validates configuration only and does not authenticate requests or install -middleware. `DefineServiceOptions.auth` requires this policy. `defineService()` runs the shared -assertion before builder configuration, database startup, or listener creation, so JavaScript -callers receive an actionable `TypeError` as well as TypeScript callers receiving a missing-field -error. Guarded policies install the existing native stages unchanged; public policies deliberately -skip them. `/api` is guarded and `/health` stays anonymous with native defaults. +`ServiceAuthPolicy` records either native guards (`{ authn, authz? }`) or a deliberate +public opt-out (`{ public: true, reason }`). `ServiceGuardedAuthPolicy` and +`ServicePublicAuthPolicy` are mutually exclusive; a public reason must be nonblank. +`assertServiceAuthPolicy(value)` rejects absent or ambiguous postures and malformed callable +ports with a redacted `TypeError`. It preserves the original options: a custom +`allowAnonymous` list replaces the native default; the assertion does not add `/health`. +It validates configuration only and does not authenticate requests or install middleware. +`DefineServiceOptions.auth` requires this policy. `defineService()` runs the shared assertion +before builder configuration, database startup, or listener creation, so JavaScript callers receive +an actionable `TypeError` as well as TypeScript callers receiving a missing-field error. +Guarded policies install the existing native stages unchanged; public policies deliberately skip +them. `/api` is guarded and `/health` stays anonymous with native defaults. > [!IMPORTANT] > **Changed in 0.0.8** > -> Search existing entrypoints for `defineService(` and either choose native guards or record a -> public service's reason. The public opt-out looks like this: +> Search existing entrypoints for `defineService(` and either choose native +> guards or record a public service's reason. The public opt-out looks like this: ```diff -await defineService(router, { name: 'status' }); @@ -514,12 +514,13 @@ records a greppable public opt-out with a reason explaining how to protect it. L reconcile scaffold-owned opt-outs; authored policies remain authoritative, and `generate aspire` leaves authored inputs unchanged. -Generated contracts include a `session` identity probe with `authentication: 'required'`. That -metadata describes the guarded posture and remains visible in OpenAPI/discovery even when auth is -not installed. An explicit service-wide public opt-out skips authentication and authorization, -including this contract requirement: anonymous `session` calls then return 200 with -`{ authenticated: false }`. The metadata alone does not install guards. Install auth or configure a -guarded service policy to enforce it; the probe reports whether the runtime provided a principal. +Generated contracts include a `session` identity probe with `authentication: 'required'`. +That metadata describes the guarded posture and remains visible in OpenAPI/discovery even when +auth is not installed. An explicit service-wide public opt-out skips authentication and +authorization, including this contract requirement: anonymous `session` calls then return +200 with `{ authenticated: false }`. The metadata alone does not install guards. Install auth +or configure a guarded service policy to enforce it; the probe reports whether the runtime +provided a principal. This policy requirement applies to the preset; lower-level `createService()` callers compose their middleware explicitly. @@ -536,29 +537,29 @@ assertServiceAuthPolicy(policy); ### `@netscript/service/auth` surface -| Symbol | Kind | Description | -| ----------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- | -| `ServiceAuthPolicy` | type alias | Native guarded posture or an explicit public opt-out. | -| `ServiceGuardedAuthPolicy` | interface | Native authentication with optional authorization; excludes public fields. | -| `ServicePublicAuthPolicy` | interface | Literal public opt-out with a nonblank reason; excludes guard fields. | -| `assertServiceAuthPolicy` | function | Validates an explicit posture and required callable ports without changing options. | -| `createContractAuthorizer` | function | Traverses a metadata-bearing contract and returns an opt-in authorizer bound by the service builder. | -| `createContractOverlayAuthorizer` | function | Enforces only access-marked procedures and leaves every other request to the service's own policy. | -| `createInternalCredentialAuthenticator` | function | Accepts the internal bearer derived for this service and mints internal service principals. | -| `isInternalServicePrincipal` | function | Default `InternalCallerPredicate`; true only for principals minted by the internal-credential authenticator. | -| `createCompositeAuthenticator` | function | Tries authenticators in order over one `AuthenticatorPort` and returns the first success. | -| `loadInstallationSecret` / `createInstallationSecret` | function | Import the per-installation secret from its file reference or from memory. | -| `deriveInternalCredential` | function | Derives the per-service internal bearer from the installation secret. | -| `createScopeAuthorizer` | function | Ordered scope/role rules usable standalone or as a match-aware legacy fallback. | -| `createStaticCredentialAuthenticator` | function | Maps configured credentials to principals. | -| `createTrustedHeaderAuthenticator` | function | Maps trusted upstream identity headers to principals. | -| `Principal` | interface | Service-owned identity contract. | -| `PROCEDURE_ERROR_CODES` | constant | Stable `NOT_FOUND` (`procedure_not_found`) and `RETIRED` (`procedure_retired`) HTTP error codes. | -| `ProcedureErrorCode` | type alias | Union of the stable unknown/retired procedure codes. | -| `AuthzDecision` | type alias | Allow or deny, with an optional procedure failure code selecting 404/410. | -| `ProcedurePolicyResolution` | type alias | Shared matched policy or miss; `retired?: true` marks authenticated retirement. | -| `ContractPolicyAuthorizerPort` | interface | Authorizer that binds to the builder's REST/RPC projection paths. | -| `ContractAuthorizerRawRoute` | interface | Exact, authentication-required raw route declared through `createContractAuthorizer(contract, { rawRoutes })`. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `ServiceAuthPolicy` | type alias | Native guarded posture or an explicit public opt-out. | +| `ServiceGuardedAuthPolicy` | interface | Native authentication with optional authorization; excludes public fields. | +| `ServicePublicAuthPolicy` | interface | Literal public opt-out with a nonblank reason; excludes guard fields. | +| `assertServiceAuthPolicy` | function | Validates an explicit posture and required callable ports without changing options. | +| `createContractAuthorizer` | function | Traverses a metadata-bearing contract and returns an opt-in authorizer bound by the service builder. | +| `createContractOverlayAuthorizer` | function | Enforces only access-marked procedures and leaves every other request to the service's own policy. | +| `createInternalCredentialAuthenticator` | function | Accepts the internal bearer derived for this service and mints internal service principals. | +| `isInternalServicePrincipal` | function | Default `InternalCallerPredicate`; true only for principals minted by the internal-credential authenticator. | +| `createCompositeAuthenticator` | function | Tries authenticators in order over one `AuthenticatorPort` and returns the first success. | +| `loadInstallationSecret` / `createInstallationSecret` | function | Import the per-installation secret from its file reference or from memory. | +| `deriveInternalCredential` | function | Derives the per-service internal bearer from the installation secret. | +| `createScopeAuthorizer` | function | Ordered scope/role rules usable standalone or as a match-aware legacy fallback. | +| `createStaticCredentialAuthenticator` | function | Maps configured credentials to principals. | +| `createTrustedHeaderAuthenticator` | function | Maps trusted upstream identity headers to principals. | +| `Principal` | interface | Service-owned identity contract. | +| `PROCEDURE_ERROR_CODES` | constant | Stable `NOT_FOUND` (`procedure_not_found`) and `RETIRED` (`procedure_retired`) HTTP error codes. | +| `ProcedureErrorCode` | type alias | Union of the stable unknown/retired procedure codes. | +| `AuthzDecision` | type alias | Allow or deny, with an optional procedure failure code selecting 404/410. | +| `ProcedurePolicyResolution` | type alias | Shared matched policy or miss; `retired?: true` marks authenticated retirement. | +| `ContractPolicyAuthorizerPort` | interface | Authorizer that binds to the builder's REST/RPC projection paths. | +| `ContractAuthorizerRawRoute` | interface | Exact, authentication-required raw route declared through `createContractAuthorizer(contract, { rawRoutes })`. | ## Command definitions and codecs @@ -567,41 +568,42 @@ recovery, trust boundaries and durable-format changes are covered by [Operations](/services-sdk/command-operations/), [Security](/services-sdk/command-security/) and [Compatibility](/services-sdk/command-compatibility/). + `@netscript/service/commands` defines immutable command policies and bounded canonical codecs -without executing handlers. Importing, defining and encoding require no permissions; execution uses -the explicitly supplied store/business operations and their permissions. JSON uses `jcs-v1` with RFC -8785 ordering and numeric/string serialization. Default limits are depth 64, 10,000 aggregate -values/keys and 1 MiB UTF-8 bytes; options may only tighten these bounds. Stored text must match -canonical serialization exactly. Synchronous schema validation must preserve canonical JSON identity -to keep replay stable. - -| Symbol | Kind | Description | -| --------------------------- | ---------------- | ----------------------------------------------------------------------- | -| `defineCommand` | function | Validates durable identity and freezes an opaque definition. | -| `jsonCodec` | function | Synchronous Standard Schema validation with stable bounded JSON. | -| `canonicalCommandJson` | function | Produces bounded canonical JSON text. | -| `commandTraceContext` | function | Reuses strict W3C parent/state validation at producer boundaries. | -| `parseCanonicalCommandJson` | function | Accepts only bounded canonical stored text. | -| `CommandCodec` | type alias | Typed response/payload encoding and decoding boundary. | -| `CommandJsonLimits` | type alias | Tighten-only depth, item and byte safeguards. | -| `CommandJson` | type alias | Readonly recursive I-JSON values. | -| `CommandActor` | type alias | Principal or system identity, excluding roles and claims. | -| `CommandEnvelope` | type alias | Input, actor and transport fields with string version tokens. | -| `CommandTraceContext` | type alias | Validated W3C traceparent and optional tracestate. | -| `CommandAuditInput` | type alias | Redacted audit intent. | -| `CommandContext` | interface | Transaction handle and synchronous side-record operations. | -| `CommandDefinition` | interface | Opaque immutable identity, replay policy and record requirements. | -| `CommandDefinitionSpec` | type alias | Construction specification with privately bound handler. | -| `commandDefinitionBinding` | type-only symbol | Opaque marker; unavailable as a runtime export. | -| `commandExecutorCapability` | type-only symbol | Private binding capability; unavailable as a runtime export. | -| `CommandIdempotency` | type alias | Frozen semantic scope, fingerprint and replay codec. | -| `CommandIdempotencyMode` | type alias | Required or optional key policy. | -| `CommandIdempotencySpec` | type alias | Construction policy defaulting to required keys. | -| `CommandOutboxInput` | type alias | Delivery intent with typed codec. | -| `CommandRecordRequirement` | type alias | Required, optional or forbidden side-record policy. | -| `CommandError` | class | Frozen redacted failure with a trusted nonserialized cause. | -| `CommandFailure` | type alias | Bounded discriminated failure and retry vocabulary. | -| `IsolationLevel` | type alias | Database-owned transaction isolation vocabulary, re-exported as a type. | +without executing handlers. Importing, defining and encoding require no permissions; execution +uses the explicitly supplied store/business operations and their permissions. JSON uses `jcs-v1` +with RFC 8785 ordering and numeric/string serialization. Default limits are depth 64, 10,000 +aggregate values/keys and 1 MiB UTF-8 bytes; options may only tighten these bounds. Stored text must +match canonical serialization exactly. Synchronous schema validation must preserve canonical JSON +identity to keep replay stable. + +| Symbol | Kind | Description | +| --------------------------- | ---------------- | ----------------------------------------------------------------- | +| `defineCommand` | function | Validates durable identity and freezes an opaque definition. | +| `jsonCodec` | function | Synchronous Standard Schema validation with stable bounded JSON. | +| `canonicalCommandJson` | function | Produces bounded canonical JSON text. | +| `commandTraceContext` | function | Reuses strict W3C parent/state validation at producer boundaries. | +| `parseCanonicalCommandJson` | function | Accepts only bounded canonical stored text. | +| `CommandCodec` | type alias | Typed response/payload encoding and decoding boundary. | +| `CommandJsonLimits` | type alias | Tighten-only depth, item and byte safeguards. | +| `CommandJson` | type alias | Readonly recursive I-JSON values. | +| `CommandActor` | type alias | Principal or system identity, excluding roles and claims. | +| `CommandEnvelope` | type alias | Input, actor and transport fields with string version tokens. | +| `CommandTraceContext` | type alias | Validated W3C traceparent and optional tracestate. | +| `CommandAuditInput` | type alias | Redacted audit intent. | +| `CommandContext` | interface | Transaction handle and synchronous side-record operations. | +| `CommandDefinition` | interface | Opaque immutable identity, replay policy and record requirements. | +| `CommandDefinitionSpec` | type alias | Construction specification with privately bound handler. | +| `commandDefinitionBinding` | type-only symbol | Opaque marker; unavailable as a runtime export. | +| `commandExecutorCapability` | type-only symbol | Private binding capability; unavailable as a runtime export. | +| `CommandIdempotency` | type alias | Frozen semantic scope, fingerprint and replay codec. | +| `CommandIdempotencyMode` | type alias | Required or optional key policy. | +| `CommandIdempotencySpec` | type alias | Construction policy defaulting to required keys. | +| `CommandOutboxInput` | type alias | Delivery intent with typed codec. | +| `CommandRecordRequirement` | type alias | Required, optional or forbidden side-record policy. | +| `CommandError` | class | Frozen redacted failure with a trusted nonserialized cause. | +| `CommandFailure` | type alias | Bounded discriminated failure and retry vocabulary. | +| `IsolationLevel` | type alias | Database-owned transaction isolation vocabulary, re-exported as a type. | ## Command testing @@ -616,19 +618,19 @@ callback attempt; it may reject disjoint concurrent drafts because it uses a glo ## Command executor -| Symbol | Kind | Description | -| ------------------------ | ---------- | ------------------------------------------------------------------------------------ | -| `createCommandExecutor` | function | Compose once-only execution over a bound same-commit store. | -| `CommandExecutor` | interface | Execute a genuine definition and await the store boundary. | -| `CommandExecution` | type alias | Decoded value, applied/replayed outcome, idempotency state and original correlation. | -| `CommandExecutorOptions` | type alias | Store, optional clock/IDs/telemetry, claim wait and tighten-only record limits. | -| `CommandRecordLimits` | type alias | 64 audit/64 outbox defaults; aggregate canonical side-row byte default 64 KiB. | -| `CommandClock` | interface | Injected valid Date source, detached by the executor. | -| `CommandIdSource` | interface | Fresh bounded identifiers. | -| `CommandTelemetryPort` | interface | Once-only tracing extension preserving values and errors. | -| `CommandTelemetrySpan` | interface | Finish with finite outcome/count vocabulary after the boundary. | -| `CommandTelemetryStart` | type alias | Name/version, requested or default isolation, provider and keyed state. | -| `CommandTelemetryResult` | type alias | Finite outcome/idempotency/counts and optional bounded failure kind. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `createCommandExecutor` | function | Compose once-only execution over a bound same-commit store. | +| `CommandExecutor` | interface | Execute a genuine definition and await the store boundary. | +| `CommandExecution` | type alias | Decoded value, applied/replayed outcome, idempotency state and original correlation. | +| `CommandExecutorOptions` | type alias | Store, optional clock/IDs/telemetry, claim wait and tighten-only record limits. | +| `CommandRecordLimits` | type alias | 64 audit/64 outbox defaults; aggregate canonical side-row byte default 64 KiB. | +| `CommandClock` | interface | Injected valid Date source, detached by the executor. | +| `CommandIdSource` | interface | Fresh bounded identifiers. | +| `CommandTelemetryPort` | interface | Once-only tracing extension preserving values and errors. | +| `CommandTelemetrySpan` | interface | Finish with finite outcome/count vocabulary after the boundary. | +| `CommandTelemetryStart` | type alias | Name/version, requested or default isolation, provider and keyed state. | +| `CommandTelemetryResult` | type alias | Finite outcome/idempotency/counts and optional bounded failure kind. | The executor freezes detached bounded I-JSON input before the two identity callbacks, each called once. Required keys are 16–256 UTF-8 bytes; scope and other identity/header strings are bounded to @@ -644,17 +646,17 @@ flush in that order. Optional unkeyed attempts skip receipts. Telemetry goes thr ### Command conformance fixtures -`@netscript/service/commands/testing` also provides an instance-bound `CommandFaultController`, -`createTestingCommandExecutor()` and a generic `CommandConformanceFixture`. Production executor -options contain no fault controls. The testing factory uses the production algorithm and the exact -seven command boundaries, including a postcommit response-loss boundary whose same-key retry must -replay the original receipt. +`@netscript/service/commands/testing` also provides an instance-bound +`CommandFaultController`, `createTestingCommandExecutor()` and a generic +`CommandConformanceFixture`. Production executor options contain no fault controls. The testing +factory uses the production algorithm and the exact seven command boundaries, including a +postcommit response-loss boundary whose same-key retry must replay the original receipt. `runCommandConformance(createFixture)` checks atomic rollback and recovery, ordered side writes, replay/mismatch and namespace/version changes, corrupt replay, CAS, cancellation, busy, callback -counts and retry refusal. `createMemoryCommandConformanceFixture()` supplies a simulated fixture. An -outside-transaction business write is an explicit negative control: the shared suite must detect its -surviving effect after rollback. Database-owned store/row types and the generic business handle +counts and retry refusal. `createMemoryCommandConformanceFixture()` supplies a simulated fixture. +An outside-transaction business write is an explicit negative control: the shared suite must detect +its surviving effect after rollback. Database-owned store/row types and the generic business handle allow provider adapters to supply their own inspection and fixture operations. This finite suite certifies no real driver, locking strategy or pooled session settings. @@ -666,67 +668,69 @@ not. Future traceparent fields remain opaque after known W3C prefix validation, with a bounded HTTP field-value guard rejecting CR, LF, NUL and other ASCII control bytes except HTAB. SP, HTAB and -obs-text remain accepted in the opaque suffix; empty tracestate positives are preserved. This -follows [RFC9110 field values](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5) and +obs-text remain accepted in the opaque suffix; empty tracestate positives are preserved. This follows +[RFC9110 field values](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5) and [W3C traceparent versioning](https://www.w3.org/TR/trace-context/#versioning-of-traceparent). ## Command outbox relay [Relay committed command intents](/services-sdk/command-relay/) composes the shipped PostgreSQL -adapter and checked worker sink. -[Outbound webhooks](/orchestration-runtime/how-to/outbound-webhooks/) adds signed outbound delivery; -inbound trigger verification is a separate direction. +adapter and checked worker sink. [Outbound webhooks](/orchestration-runtime/how-to/outbound-webhooks/) +adds signed outbound delivery; inbound trigger verification is a separate direction. + `createCommandOutboxRelay` starts no resource: existing scheduling calls `drainOnce` and shutdown awaits `stop`. It decodes canonical bounded payload and W3C fields, snapshots sink registration, -publishes before settlement and preserves stable identities across retries/crashes. All drains share -one bounded concurrency ceiling; stopping prevents claims and awaits every active/queued drain. -Invalid classifier/backoff cannot write arbitrary failure text or lose leases. Worker acceptance is -checked and normalized before the database writes it together with publication. Uncertain settlement -errors surface without a speculative release. Optional C4-compatible tracing selects finite command -attributes and preserves deferred/producer propagation without raw identity attributes. The database -owns leases; no second relay, queue or runtime DDL is introduced. - -The sagas plugin contributes the Prisma command outbox model and its reviewed SQL constraints. Apply -the normal application migration after installation. For bounded maintenance, the PostgreSQL relay -store exposes `pruneSettled`; the composed saga API also prunes atomic replay keys according to -terminal completion and the saga group's completed-retention window (default seven days). Pending -work, leases and active saga markers survive; eligibility is rechecked at deletion. See -[outbox retention](../database/index.md#bounded-outbox-retention) and the +publishes before settlement and preserves stable identities across retries/crashes. All drains +share one bounded concurrency ceiling; stopping prevents claims and awaits every active/queued +drain. Invalid classifier/backoff cannot write arbitrary failure text or lose leases. Worker +acceptance is checked and normalized before the database writes it together with publication. +Uncertain settlement errors surface without a speculative release. Optional C4-compatible tracing +selects finite command attributes and preserves deferred/producer propagation without raw identity +attributes. The database owns leases; no second relay, queue or runtime DDL is introduced. + +The sagas plugin contributes the Prisma command outbox model and its reviewed SQL constraints. +Apply the normal application migration after installation. For bounded maintenance, the PostgreSQL +relay store exposes `pruneSettled`; the composed saga API also prunes atomic replay keys according +to terminal completion and the saga group's completed-retention window (default seven days). +Pending work, leases and active saga markers survive; eligibility is rechecked at deletion. +See [outbox retention](../database/index.md#bounded-outbox-retention) and the [Prisma saga retention recipe](../plugin-sagas-core/index.md#installed-outbox-schema-and-postgresql-retention) for migration, policies and persisted cursor examples. -| Symbol | Kind | Signature | Description | -| ------------------------------- | ---------- | ----------------------------------------------------------------------- | ---------------------------------------------------------- | -| `createCommandOutboxRelay` | function | `function createCommandOutboxRelay(options): RunningCommandOutboxRelay` | Compose the one bounded decoded relay. | -| `CommandOutboxDelivery` | type alias | `type CommandOutboxDelivery` | Frozen decoded delivery and transport context. | -| `CommandOutboxRelayOptions` | type alias | `type CommandOutboxRelayOptions` | Explicit finite lifecycle/retry policy and supplied ports. | -| `CommandOutboxSink` | interface | `interface CommandOutboxSink` | Documented acceptance boundary. | -| `CommandRelayTelemetryPort` | interface | `interface CommandRelayTelemetryPort` | Privacy-safe structural C4 observer extension. | -| `RunningCommandOutboxRelay` | interface | `interface RunningCommandOutboxRelay` | Drain/stop lifecycle. | -| `CommandRelayError` | class | `class CommandRelayError` | Closed sink/decode diagnostic. | -| `COMMAND_RELAY_FAILURE_CLASSES` | const | `readonly tuple` | Closed persisted relay failure vocabulary. | -| `CommandRelayFailureClass` | type alias | `type CommandRelayFailureClass` | One of six finite failures. | -| `ClaimedCommandOutboxRow` | type alias | `type ClaimedCommandOutboxRow` | Database-owned raw leased row. | -| `CommandOutboxAcceptance` | type alias | `type CommandOutboxAcceptance` | Checked normalized receipt identity/time. | -| `CommandOutboxClaim` | type alias | `type CommandOutboxClaim` | Bounded clock/generation request. | -| `CommandOutboxPublication` | type alias | `type CommandOutboxPublication` | One publication/acceptance settlement. | -| `CommandOutboxRelayStore` | interface | `interface CommandOutboxRelayStore` | Raw claim/mark/release port. | -| `CommandOutboxRelease` | type alias | `type CommandOutboxRelease` | Retried or retained terminal row. | + +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createCommandOutboxRelay` | function | `function createCommandOutboxRelay(options): RunningCommandOutboxRelay` | Compose the one bounded decoded relay. | +| `CommandOutboxDelivery` | type alias | `type CommandOutboxDelivery` | Frozen decoded delivery and transport context. | +| `CommandOutboxRelayOptions` | type alias | `type CommandOutboxRelayOptions` | Explicit finite lifecycle/retry policy and supplied ports. | +| `CommandOutboxSink` | interface | `interface CommandOutboxSink` | Documented acceptance boundary. | +| `CommandRelayTelemetryPort` | interface | `interface CommandRelayTelemetryPort` | Privacy-safe structural C4 observer extension. | +| `RunningCommandOutboxRelay` | interface | `interface RunningCommandOutboxRelay` | Drain/stop lifecycle. | +| `CommandRelayError` | class | `class CommandRelayError` | Closed sink/decode diagnostic. | +| `COMMAND_RELAY_FAILURE_CLASSES` | const | `readonly tuple` | Closed persisted relay failure vocabulary. | +| `CommandRelayFailureClass` | type alias | `type CommandRelayFailureClass` | One of six finite failures. | +| `ClaimedCommandOutboxRow` | type alias | `type ClaimedCommandOutboxRow` | Database-owned raw leased row. | +| `CommandOutboxAcceptance` | type alias | `type CommandOutboxAcceptance` | Checked normalized receipt identity/time. | +| `CommandOutboxClaim` | type alias | `type CommandOutboxClaim` | Bounded clock/generation request. | +| `CommandOutboxPublication` | type alias | `type CommandOutboxPublication` | One publication/acceptance settlement. | +| `CommandOutboxRelayStore` | interface | `interface CommandOutboxRelayStore` | Raw claim/mark/release port. | +| `CommandOutboxRelease` | type alias | `type CommandOutboxRelease` | Retried or retained terminal row. | + ### Envelope and record policies -| Field or policy | Contract | -| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| `input` | Detached, deeply frozen bounded I-JSON. Contract/input schema validation belongs to the service adapter. | -| `actor` | Trusted principal/system origin; actor kind/subject participates in request identity, scheme does not. | -| `correlationId` | Bounded transport identity; successful replay returns the original correlation. | -| `idempotencyKey` | Required by default, 16–256 UTF-8 bytes; stored as a digest. Optional unkeyed execution has no receipt. | -| `expectedVersion` | Optional normalized string included in request identity. The handler must implement atomic comparison/update. | -| `trace` | Validated W3C propagation fields, excluded from request identity. | -| `records.audit` / `records.outbox` | `required`, `optional` or `forbidden`; policy/codec failures roll back. | -| `CommandRecordLimits` | Defaults: 64 audit rows, 64 outbox rows, 64 KiB shared canonical side-row bytes including metadata; tighten only. | -| `CommandJsonLimits` | Defaults: depth 64, aggregate items 10,000, canonical bytes 1 MiB; tighten only. | +| Field or policy | Contract | +| --- | --- | +| `input` | Detached, deeply frozen bounded I-JSON. Contract/input schema validation belongs to the service adapter. | +| `actor` | Trusted principal/system origin; actor kind/subject participates in request identity, scheme does not. | +| `correlationId` | Bounded transport identity; successful replay returns the original correlation. | +| `idempotencyKey` | Required by default, 16–256 UTF-8 bytes; stored as a digest. Optional unkeyed execution has no receipt. | +| `expectedVersion` | Optional normalized string included in request identity. The handler must implement atomic comparison/update. | +| `trace` | Validated W3C propagation fields, excluded from request identity. | +| `records.audit` / `records.outbox` | `required`, `optional` or `forbidden`; policy/codec failures roll back. | +| `CommandRecordLimits` | Defaults: 64 audit rows, 64 outbox rows, 64 KiB shared canonical side-row bytes including metadata; tighten only. | +| `CommandJsonLimits` | Defaults: depth 64, aggregate items 10,000, canonical bytes 1 MiB; tighten only. | ### Relay policy bounds @@ -734,13 +738,13 @@ All five numerical policy options are required positive safe integers. `concurre `batchSize`. Sink registry keys must equal the sink's bounded nonblank `id`; at most 64 sinks are allowed. The relay snapshots registrations at construction. -| Option | Maximum | Meaning | -| ----------------- | ---------- | ----------------------------------------------------------------------------------- | -| `batchSize` | 64 | Rows claimed by one drain. | -| `concurrency` | 64 | Active publications within the serialized drains. | -| `leaseMs` | 60,000 | Claim lifetime; the store fences both token and expiry. | -| `maxAttempts` | 10,000 | Failed claims below this count can be rescheduled; exhaustion is retained terminal. | -| `maxRetryDelayMs` | 86,400,000 | Upper bound on a strictly future `retryAt` result. | +| Option | Maximum | Meaning | +| --- | --- | --- | +| `batchSize` | 64 | Rows claimed by one drain. | +| `concurrency` | 64 | Active publications within the serialized drains. | +| `leaseMs` | 60,000 | Claim lifetime; the store fences both token and expiry. | +| `maxAttempts` | 10,000 | Failed claims below this count can be rescheduled; exhaustion is retained terminal. | +| `maxRetryDelayMs` | 86,400,000 | Upper bound on a strictly future `retryAt` result. | `clock.now` and `ids.next` are explicit ports. `classify` returns one of the six `COMMAND_RELAY_FAILURE_CLASSES`; `CommandRelayError` already carries its class. Invalid classifier diff --git a/docs/site/reference/telemetry/index.md b/docs/site/reference/telemetry/index.md index 3c7a7bbc03..0f429a662a 100644 --- a/docs/site/reference/telemetry/index.md +++ b/docs/site/reference/telemetry/index.md @@ -11,22 +11,22 @@ need; the root entrypoint holds only diagnostics and the instrumentation registr ## Sub-path exports -| Export | Entrypoint | Purpose | -| -------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------- | -| `@netscript/telemetry` | `./mod.ts` | [Diagnostics and the instrumentation registry contract](#root-entrypoint). | -| `@netscript/telemetry/config` | `./config.ts` | [Telemetry configuration and OTEL env resolution](#configuration-netscripttelemetryconfig). | -| `@netscript/telemetry/tracer` | `./tracer.ts` | [Tracer accessors and span helpers](#tracer-netscripttelemetrytracer). | -| `@netscript/telemetry/context` | `./context.ts` | [W3C trace-context propagation](#context-netscripttelemetrycontext). | -| `@netscript/telemetry/commands` | `./commands.ts` | [Privacy-first command adapter and native relationship wrappers](#command-telemetry). | -| `@netscript/telemetry/attributes` | `./attributes.ts` | [Semantic attribute and span-name constants](#attributes-netscripttelemetryattributes). | -| `@netscript/telemetry/instrumentation` | `./instrumentation.ts` | [Worker/queue/scheduler/SSE instrumentation](#instrumentation-netscripttelemetryinstrumentation). | -| `@netscript/telemetry/registry` | `./registry.ts` | [Instrumentation lifecycle registry](#registry-netscripttelemetryregistry). | -| `@netscript/telemetry/orpc` | `./orpc.ts` | [oRPC tracing and error-handling plugins](#orpc-netscripttelemetryorpc). | -| `@netscript/telemetry/hono` | `./hono.ts` | Hono request and response tracing middleware. | -| `@netscript/telemetry/ai` | `./ai.ts` | GenAI request, token, and chat-client metrics and tracing. | -| `@netscript/telemetry/otel` | `./src/adapters/otel/mod.ts` | OpenTelemetry Deno provider adapters. | -| `@netscript/telemetry/query` | `./query.ts` | Telemetry query capabilities and filters. | -| `@netscript/telemetry/testing` | `./src/testing/mod.ts` | In-memory span recorder for test verification. | +| Export | Entrypoint | Purpose | +| --- | --- | --- | +| `@netscript/telemetry` | `./mod.ts` | [Diagnostics and the instrumentation registry contract](#root-entrypoint). | +| `@netscript/telemetry/config` | `./config.ts` | [Telemetry configuration and OTEL env resolution](#configuration-netscripttelemetryconfig). | +| `@netscript/telemetry/tracer` | `./tracer.ts` | [Tracer accessors and span helpers](#tracer-netscripttelemetrytracer). | +| `@netscript/telemetry/context` | `./context.ts` | [W3C trace-context propagation](#context-netscripttelemetrycontext). | +| `@netscript/telemetry/commands` | `./commands.ts` | [Privacy-first command adapter and native relationship wrappers](#command-telemetry). | +| `@netscript/telemetry/attributes` | `./attributes.ts` | [Semantic attribute and span-name constants](#attributes-netscripttelemetryattributes). | +| `@netscript/telemetry/instrumentation` | `./instrumentation.ts` | [Worker/queue/scheduler/SSE instrumentation](#instrumentation-netscripttelemetryinstrumentation). | +| `@netscript/telemetry/registry` | `./registry.ts` | [Instrumentation lifecycle registry](#registry-netscripttelemetryregistry). | +| `@netscript/telemetry/orpc` | `./orpc.ts` | [oRPC tracing and error-handling plugins](#orpc-netscripttelemetryorpc). | +| `@netscript/telemetry/hono` | `./hono.ts` | Hono request and response tracing middleware. | +| `@netscript/telemetry/ai` | `./ai.ts` | GenAI request, token, and chat-client metrics and tracing. | +| `@netscript/telemetry/otel` | `./src/adapters/otel/mod.ts` | OpenTelemetry Deno provider adapters. | +| `@netscript/telemetry/query` | `./query.ts` | Telemetry query capabilities and filters. | +| `@netscript/telemetry/testing` | `./src/testing/mod.ts` | In-memory span recorder for test verification. | ## Root entrypoint @@ -34,18 +34,18 @@ Diagnostics, traced-job helpers, and the instrumentation registry contract. ### Functions -| Symbol | Kind | Signature | Description | -| ------------------ | -------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------- | -| `inspectTelemetry` | function | `function inspectTelemetry(target): InspectionReport` | Inspect a telemetry target and return a JSON-stable diagnostic report. | -| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess, continuing the trace from the worker. | -| `runTracedJob` | function | `async function runTracedJob(jobId: string, fn): Promise` | Wrap a job main function with context extraction and span creation. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `inspectTelemetry` | function | `function inspectTelemetry(target): InspectionReport` | Inspect a telemetry target and return a JSON-stable diagnostic report. | +| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess, continuing the trace from the worker. | +| `runTracedJob` | function | `async function runTracedJob(jobId: string, fn): Promise` | Wrap a job main function with context extraction and span creation. | ### Classes -| Symbol | Kind | Signature | Description | -| ------------------------------- | ----- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| `InstrumentationRegistry` | class | `class InstrumentationRegistry` | Registry for telemetry instrumentation lifecycle hooks (`register`, `resolve`, `list`, `setupAll`, `teardownAll`). | -| `DuplicateInstrumentationError` | class | `class DuplicateInstrumentationError extends Error` | Error thrown when an instrumentation registration name is duplicated. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `InstrumentationRegistry` | class | `class InstrumentationRegistry` | Registry for telemetry instrumentation lifecycle hooks (`register`, `resolve`, `list`, `setupAll`, `teardownAll`). | +| `DuplicateInstrumentationError` | class | `class DuplicateInstrumentationError extends Error` | Error thrown when an instrumentation registration name is duplicated. | ### Types @@ -58,111 +58,111 @@ Diagnostics, traced-job helpers, and the instrumentation registry contract. ## Configuration (`@netscript/telemetry/config`) -| Symbol | Kind | Signature | Description | -| ---------------------------- | --------- | ---------------------------------------------------------------- | --------------------------------------------------------- | -| `getTelemetryConfig` | function | `function getTelemetryConfig(): TelemetryConfig` | Resolve the telemetry configuration from the environment. | -| `getConfig` | function | `function getConfig(): TelemetryConfig` | Get the cached singleton telemetry configuration. | -| `resetConfig` | function | `function resetConfig(): void` | Reset the cached singleton configuration. | -| `describeTelemetryConfig` | function | `function describeTelemetryConfig(): TelemetryConfigDescription` | Describe the effective configuration for diagnostics. | -| `isTelemetryEnabled` | function | `function isTelemetryEnabled(): boolean` | Whether telemetry is enabled in the current environment. | -| `getServiceName` | function | `function getServiceName(): string` | Resolve the configured OTEL service name. | -| `getOtlpEndpoint` | function | `function getOtlpEndpoint(): string \| undefined` | Resolve the OTLP exporter endpoint, if set. | -| `getOtelEnvVars` | function | `function getOtelEnvVars(): Record` | Collect the resolved OTEL environment variables. | -| `OTEL_ENV_VARS` | const | `const OTEL_ENV_VARS` | Map of the supported OTEL environment variable names. | -| `TelemetryConfig` | interface | interface | Resolved telemetry configuration shape. | -| `TelemetryConfigDescription` | interface | interface | Human-readable configuration description. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `getTelemetryConfig` | function | `function getTelemetryConfig(): TelemetryConfig` | Resolve the telemetry configuration from the environment. | +| `getConfig` | function | `function getConfig(): TelemetryConfig` | Get the cached singleton telemetry configuration. | +| `resetConfig` | function | `function resetConfig(): void` | Reset the cached singleton configuration. | +| `describeTelemetryConfig` | function | `function describeTelemetryConfig(): TelemetryConfigDescription` | Describe the effective configuration for diagnostics. | +| `isTelemetryEnabled` | function | `function isTelemetryEnabled(): boolean` | Whether telemetry is enabled in the current environment. | +| `getServiceName` | function | `function getServiceName(): string` | Resolve the configured OTEL service name. | +| `getOtlpEndpoint` | function | `function getOtlpEndpoint(): string \| undefined` | Resolve the OTLP exporter endpoint, if set. | +| `getOtelEnvVars` | function | `function getOtelEnvVars(): Record` | Collect the resolved OTEL environment variables. | +| `OTEL_ENV_VARS` | const | `const OTEL_ENV_VARS` | Map of the supported OTEL environment variable names. | +| `TelemetryConfig` | interface | interface | Resolved telemetry configuration shape. | +| `TelemetryConfigDescription` | interface | interface | Human-readable configuration description. | ## Tracer (`@netscript/telemetry/tracer`) -| Symbol | Kind | Signature | Description | -| ---------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------ | -| `getTracer` | function | `function getTracer(name: string, version: string): Tracer` | Get a named tracer at a version. | -| `getQueueTracer` | function | `function getQueueTracer(): Tracer` | Tracer for queue operations. | -| `getWorkerTracer` | function | `function getWorkerTracer(): Tracer` | Tracer for worker operations. | -| `getSchedulerTracer` | function | `function getSchedulerTracer(): Tracer` | Tracer for scheduler operations. | -| `getJobTracer` | function | `function getJobTracer(): Tracer` | Tracer for job operations. | -| `getSagaTracer` | function | `function getSagaTracer(): Tracer` | Tracer for saga operations. | -| `getSSETracer` | function | `function getSSETracer(): Tracer` | Tracer for SSE operations. | -| `getKVTracer` | function | `function getKVTracer(): Tracer` | Tracer for KV operations. | -| `createSpan` | function | `function createSpan(tracer, name, options): Span` | Create a span on the given tracer. | -| `withSpan` | function | `async function withSpan(tracer, name, fn, options): Promise` | Run an async function inside a span. | -| `withSpanSync` | function | `function withSpanSync(tracer, name, fn, options): T` | Run a sync function inside a span. | -| `getActiveSpan` | function | `function getActiveSpan(): Span \| undefined` | Get the currently active span. | -| `getActiveContext` | function | `function getActiveContext(): Context` | Get the currently active context. | -| `addSpanEvent` | function | `function addSpanEvent(span, name, attributes?): void` | Add an event to a span. | -| `setSpanAttributes` | function | `function setSpanAttributes(span, attributes): void` | Set attributes on a span. | -| `setSpanError` | function | `function setSpanError(span, message, error?): void` | Mark a span as errored. | -| `setSpanOk` | function | `function setSpanOk(span): void` | Mark a span status as OK. | -| `isTracingEnabled` | function | `function isTracingEnabled(): boolean` | Whether tracing is currently enabled. | -| `TracerNames` | const | `const TracerNames` | Canonical tracer names: QUEUE, WORKER, SCHEDULER, JOB, SAGA, SSE, KV, DEFAULT. | -| `SpanKind` | const / type alias | `const SpanKind` / `type SpanKind` | Span kind enum: INTERNAL, SERVER, CLIENT, PRODUCER, CONSUMER. | -| `SpanStatusCode` | const / type alias | `const SpanStatusCode` / `type SpanStatusCode` | Span status code enum: UNSET, OK, ERROR. | -| `Context`, `Span`, `Tracer`, `CreateSpanOptions`, `Link`, `Attributes` | interface / type alias | type aliases / interfaces | Core OpenTelemetry-compatible span and context types. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `getTracer` | function | `function getTracer(name: string, version: string): Tracer` | Get a named tracer at a version. | +| `getQueueTracer` | function | `function getQueueTracer(): Tracer` | Tracer for queue operations. | +| `getWorkerTracer` | function | `function getWorkerTracer(): Tracer` | Tracer for worker operations. | +| `getSchedulerTracer` | function | `function getSchedulerTracer(): Tracer` | Tracer for scheduler operations. | +| `getJobTracer` | function | `function getJobTracer(): Tracer` | Tracer for job operations. | +| `getSagaTracer` | function | `function getSagaTracer(): Tracer` | Tracer for saga operations. | +| `getSSETracer` | function | `function getSSETracer(): Tracer` | Tracer for SSE operations. | +| `getKVTracer` | function | `function getKVTracer(): Tracer` | Tracer for KV operations. | +| `createSpan` | function | `function createSpan(tracer, name, options): Span` | Create a span on the given tracer. | +| `withSpan` | function | `async function withSpan(tracer, name, fn, options): Promise` | Run an async function inside a span. | +| `withSpanSync` | function | `function withSpanSync(tracer, name, fn, options): T` | Run a sync function inside a span. | +| `getActiveSpan` | function | `function getActiveSpan(): Span \| undefined` | Get the currently active span. | +| `getActiveContext` | function | `function getActiveContext(): Context` | Get the currently active context. | +| `addSpanEvent` | function | `function addSpanEvent(span, name, attributes?): void` | Add an event to a span. | +| `setSpanAttributes` | function | `function setSpanAttributes(span, attributes): void` | Set attributes on a span. | +| `setSpanError` | function | `function setSpanError(span, message, error?): void` | Mark a span as errored. | +| `setSpanOk` | function | `function setSpanOk(span): void` | Mark a span status as OK. | +| `isTracingEnabled` | function | `function isTracingEnabled(): boolean` | Whether tracing is currently enabled. | +| `TracerNames` | const | `const TracerNames` | Canonical tracer names: QUEUE, WORKER, SCHEDULER, JOB, SAGA, SSE, KV, DEFAULT. | +| `SpanKind` | const / type alias | `const SpanKind` / `type SpanKind` | Span kind enum: INTERNAL, SERVER, CLIENT, PRODUCER, CONSUMER. | +| `SpanStatusCode` | const / type alias | `const SpanStatusCode` / `type SpanStatusCode` | Span status code enum: UNSET, OK, ERROR. | +| `Context`, `Span`, `Tracer`, `CreateSpanOptions`, `Link`, `Attributes` | interface / type alias | type aliases / interfaces | Core OpenTelemetry-compatible span and context types. | ## Context (`@netscript/telemetry/context`) W3C trace-context propagation across job subprocesses and message headers. -| Symbol | Kind | Signature | Description | -| ------------------------------------------------------------ | --------- | ---------------------------------------------------------------------- | ---------------------------------------------------- | -| `withContext` | function | `function withContext(ctx, fn): T` | Run a sync function with the given context active. | -| `withContextAsync` | function | `async function withContextAsync(ctx, fn): Promise` | Run an async function with the given context active. | -| `contextWithSpan` | function | `function contextWithSpan(span, parentContext?): Context` | Build a context carrying the given span. | -| `getSpanFromContext` | function | `function getSpanFromContext(ctx): Span \| undefined` | Extract the span from a context. | -| `getTraceId` | function | `function getTraceId(ctx?): string \| undefined` | Get the trace id from a context. | -| `getSpanId` | function | `function getSpanId(ctx?): string \| undefined` | Get the span id from a context. | -| `hasActiveSpan` | function | `function hasActiveSpan(ctx?): boolean` | Whether a context carries an active span. | -| `injectContext` | function | `function injectContext(headers, ctx?): PropagationHeaders` | Inject context into propagation headers. | -| `extractContext` | function | `function extractContext(headers): Context` | Extract a context from propagation headers. | -| `createMessageHeaders` | function | `function createMessageHeaders(additionalHeaders): PropagationHeaders` | Build message headers with trace context. | -| `formatTraceparent` | function | `function formatTraceparent(spanContext): string` | Format a `traceparent` header value. | -| `parseTraceparent` | function | `function parseTraceparent(traceparent): ParsedTraceparent \| null` | Parse a `traceparent` header value. | -| `resolveParentContextFromHeaders` | function | `function resolveParentContextFromHeaders(headers?): Context` | Resolve a parent context from headers. | -| `resolveTraceContext` | function | `function resolveTraceContext(ctx?): SerializedTraceContext \| null` | Serialize the active trace context. | -| `resolveTraceContextFromSpan` | function | `function resolveTraceContextFromSpan(span): SerializedTraceContext` | Serialize trace context from a span. | -| `extractFromTraceContext` | function | `function extractFromTraceContext(traceContext): Context` | Rehydrate a context from a serialized payload. | -| `createJobTraceEnv` | function | `function createJobTraceEnv(ctx?): JobTraceEnv` | Build job subprocess env carrying trace context. | -| `extractJobTraceContext` | function | `function extractJobTraceContext(): Context \| null` | Extract trace context from the job subprocess env. | -| `JobTraceEnv`, `ParsedTraceparent`, `SerializedTraceContext` | interface | interfaces | Context-propagation payload shapes. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `withContext` | function | `function withContext(ctx, fn): T` | Run a sync function with the given context active. | +| `withContextAsync` | function | `async function withContextAsync(ctx, fn): Promise` | Run an async function with the given context active. | +| `contextWithSpan` | function | `function contextWithSpan(span, parentContext?): Context` | Build a context carrying the given span. | +| `getSpanFromContext` | function | `function getSpanFromContext(ctx): Span \| undefined` | Extract the span from a context. | +| `getTraceId` | function | `function getTraceId(ctx?): string \| undefined` | Get the trace id from a context. | +| `getSpanId` | function | `function getSpanId(ctx?): string \| undefined` | Get the span id from a context. | +| `hasActiveSpan` | function | `function hasActiveSpan(ctx?): boolean` | Whether a context carries an active span. | +| `injectContext` | function | `function injectContext(headers, ctx?): PropagationHeaders` | Inject context into propagation headers. | +| `extractContext` | function | `function extractContext(headers): Context` | Extract a context from propagation headers. | +| `createMessageHeaders` | function | `function createMessageHeaders(additionalHeaders): PropagationHeaders` | Build message headers with trace context. | +| `formatTraceparent` | function | `function formatTraceparent(spanContext): string` | Format a `traceparent` header value. | +| `parseTraceparent` | function | `function parseTraceparent(traceparent): ParsedTraceparent \| null` | Parse a `traceparent` header value. | +| `resolveParentContextFromHeaders` | function | `function resolveParentContextFromHeaders(headers?): Context` | Resolve a parent context from headers. | +| `resolveTraceContext` | function | `function resolveTraceContext(ctx?): SerializedTraceContext \| null` | Serialize the active trace context. | +| `resolveTraceContextFromSpan` | function | `function resolveTraceContextFromSpan(span): SerializedTraceContext` | Serialize trace context from a span. | +| `extractFromTraceContext` | function | `function extractFromTraceContext(traceContext): Context` | Rehydrate a context from a serialized payload. | +| `createJobTraceEnv` | function | `function createJobTraceEnv(ctx?): JobTraceEnv` | Build job subprocess env carrying trace context. | +| `extractJobTraceContext` | function | `function extractJobTraceContext(): Context \| null` | Extract trace context from the job subprocess env. | +| `JobTraceEnv`, `ParsedTraceparent`, `SerializedTraceContext` | interface | interfaces | Context-propagation payload shapes. | ## Attributes (`@netscript/telemetry/attributes`) Semantic attribute keys, span-name constants, and attribute builders. The TC-1..TC-14 checklist is in the [telemetry conventions](./convention/). -| Symbol | Kind | Signature | Description | -| -------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `spanName` | function | `function spanName(base: string, suffix?: string): string` | Compose a namespaced span name. | -| `createJobAttributes` | function | `function createJobAttributes(job): Record` | Build job span attributes with deprecated bare aliases. | -| `createMessagingAttributes` | function | `function createMessagingAttributes(options): Record` | Build messaging span attributes. | -| `createSagaAttributes` | function | `function createSagaAttributes(saga): Record` | Build saga span attributes with deprecated bare aliases. | -| `createExecutionAttributes` | function | `function createExecutionAttributes(execution): Record` | Build execution lifecycle span attributes. | -| `createGenAiAttributes` | function | `function createGenAiAttributes(genai): Record` | Build GenAI semantic-convention attributes. | -| `createTriggerAttributes` | function | `function createTriggerAttributes(trigger): Record` | Build trigger span attributes. | -| `createTriggerFileAttributes` | function | `function createTriggerFileAttributes(payload): Record` | Build file-trigger span attributes. | -| `CacheAttributes` | const | `const CacheAttributes` | Cache-topology attribute-name constants for the published `netscript.cache.*` compatibility surface; the operation key is the shared `netscript.operation`. | -| `CacheOperations` | const | `const CacheOperations` | Logical span-name verbs: `cache.read`, `cache.write`, and `cache.invalidate`; promotion is a `cache.promote` event, not a fourth operation verb. | -| `CacheOperation` | type alias | `type CacheOperation` | Union of the logical cache-operation verbs in `CacheOperations`. | -| `CacheTiers` | const | `const CacheTiers` | Runtime-validated cache tiers: `l1`, `l2`, and `durable`. | -| `CacheTier` | type alias | `type CacheTier = 'l1' \| 'l2' \| 'durable'` | Bounded cache-tier identifier accepted by cache-topology attributes. | -| `CacheOutcomes` | const | `const CacheOutcomes` | Bounded results: `hit`, `miss`, `stale`, and `error`. An unknowable successful provider chain sets `topology_complete=false` and omits `outcome`; `error` is emitted only when the operation throws. | -| `CacheOutcome` | type alias | `type CacheOutcome = 'hit' \| 'miss' \| 'stale' \| 'error'` | Union of the bounded lookup and mutation outcomes in `CacheOutcomes`. | -| `CacheAttributeOptions` | type alias | `type CacheAttributeOptions` | Bounded operation, provider, namespace, tier, outcome, timing, loader, and topology facts accepted by the cache attribute builder; it has no cache-key field. | -| `createCacheAttributes` | function | `function createCacheAttributes(options: CacheAttributeOptions): TelemetryAttributeBuilderMap` | Build bounded cache-topology attributes. The API accepts no cache key, making raw-key leakage structurally impossible. | -| `TelemetryConventionChecklist` | const | `const TelemetryConventionChecklist` | TC-1..TC-14 conformance checklist. | -| `SpanNames` | const | `const SpanNames` | Canonical span-name constants for scheduler, queue, worker, job, saga, execution, RPC, GenAI, SSE, KV, and trigger spans. | -| `NetScriptAttributeDomains` | const | `const NetScriptAttributeDomains` | Single-root `netscript.*` proprietary attribute domains. | -| `NetScriptCorrelationAttributes` | const | `const NetScriptCorrelationAttributes` | Shared `netscript.correlation.id` attribute floor. | -| `ExecutionAttributes` / `NetScriptExecutionAttributes` | const | `const` | Deprecated execution aliases and canonical execution lifecycle attribute keys. | -| `JobAttributes` / `NetScriptJobAttributes` / `JobStatuses` / `JobTriggers` | const | const | Deprecated job aliases, canonical job keys, and enumerated status/trigger values. | -| `WorkerAttributes` | const | `const WorkerAttributes` | Worker attribute keys. | -| `SchedulerAttributes` | const | `const SchedulerAttributes` | Scheduler attribute keys. | -| `MessagingAttributes` / `MessagingOperations` / `MessagingSystems` | const | const | Messaging attribute keys and enumerated operations/systems. | -| `SagaAttributes` | const | `const SagaAttributes` | Saga attribute keys. | -| `GenAiAttributes` | const | `const GenAiAttributes` | GenAI semantic-convention attribute keys. | -| `KVAttributes` / `KVOperations` | const | const | KV attribute keys and operation values. | -| `SSEAttributes` | const | `const SSEAttributes` | SSE attribute keys. | -| `TriggerAttributes` | const | `const TriggerAttributes` | Trigger attribute keys. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `spanName` | function | `function spanName(base: string, suffix?: string): string` | Compose a namespaced span name. | +| `createJobAttributes` | function | `function createJobAttributes(job): Record` | Build job span attributes with deprecated bare aliases. | +| `createMessagingAttributes` | function | `function createMessagingAttributes(options): Record` | Build messaging span attributes. | +| `createSagaAttributes` | function | `function createSagaAttributes(saga): Record` | Build saga span attributes with deprecated bare aliases. | +| `createExecutionAttributes` | function | `function createExecutionAttributes(execution): Record` | Build execution lifecycle span attributes. | +| `createGenAiAttributes` | function | `function createGenAiAttributes(genai): Record` | Build GenAI semantic-convention attributes. | +| `createTriggerAttributes` | function | `function createTriggerAttributes(trigger): Record` | Build trigger span attributes. | +| `createTriggerFileAttributes` | function | `function createTriggerFileAttributes(payload): Record` | Build file-trigger span attributes. | +| `CacheAttributes` | const | `const CacheAttributes` | Cache-topology attribute-name constants for the published `netscript.cache.*` compatibility surface; the operation key is the shared `netscript.operation`. | +| `CacheOperations` | const | `const CacheOperations` | Logical span-name verbs: `cache.read`, `cache.write`, and `cache.invalidate`; promotion is a `cache.promote` event, not a fourth operation verb. | +| `CacheOperation` | type alias | `type CacheOperation` | Union of the logical cache-operation verbs in `CacheOperations`. | +| `CacheTiers` | const | `const CacheTiers` | Runtime-validated cache tiers: `l1`, `l2`, and `durable`. | +| `CacheTier` | type alias | `type CacheTier = 'l1' \| 'l2' \| 'durable'` | Bounded cache-tier identifier accepted by cache-topology attributes. | +| `CacheOutcomes` | const | `const CacheOutcomes` | Bounded results: `hit`, `miss`, `stale`, and `error`. An unknowable successful provider chain sets `topology_complete=false` and omits `outcome`; `error` is emitted only when the operation throws. | +| `CacheOutcome` | type alias | `type CacheOutcome = 'hit' \| 'miss' \| 'stale' \| 'error'` | Union of the bounded lookup and mutation outcomes in `CacheOutcomes`. | +| `CacheAttributeOptions` | type alias | `type CacheAttributeOptions` | Bounded operation, provider, namespace, tier, outcome, timing, loader, and topology facts accepted by the cache attribute builder; it has no cache-key field. | +| `createCacheAttributes` | function | `function createCacheAttributes(options: CacheAttributeOptions): TelemetryAttributeBuilderMap` | Build bounded cache-topology attributes. The API accepts no cache key, making raw-key leakage structurally impossible. | +| `TelemetryConventionChecklist` | const | `const TelemetryConventionChecklist` | TC-1..TC-14 conformance checklist. | +| `SpanNames` | const | `const SpanNames` | Canonical span-name constants for scheduler, queue, worker, job, saga, execution, RPC, GenAI, SSE, KV, and trigger spans. | +| `NetScriptAttributeDomains` | const | `const NetScriptAttributeDomains` | Single-root `netscript.*` proprietary attribute domains. | +| `NetScriptCorrelationAttributes` | const | `const NetScriptCorrelationAttributes` | Shared `netscript.correlation.id` attribute floor. | +| `ExecutionAttributes` / `NetScriptExecutionAttributes` | const | `const` | Deprecated execution aliases and canonical execution lifecycle attribute keys. | +| `JobAttributes` / `NetScriptJobAttributes` / `JobStatuses` / `JobTriggers` | const | const | Deprecated job aliases, canonical job keys, and enumerated status/trigger values. | +| `WorkerAttributes` | const | `const WorkerAttributes` | Worker attribute keys. | +| `SchedulerAttributes` | const | `const SchedulerAttributes` | Scheduler attribute keys. | +| `MessagingAttributes` / `MessagingOperations` / `MessagingSystems` | const | const | Messaging attribute keys and enumerated operations/systems. | +| `SagaAttributes` | const | `const SagaAttributes` | Saga attribute keys. | +| `GenAiAttributes` | const | `const GenAiAttributes` | GenAI semantic-convention attribute keys. | +| `KVAttributes` / `KVOperations` | const | const | KV attribute keys and operation values. | +| `SSEAttributes` | const | `const SSEAttributes` | SSE attribute keys. | +| `TriggerAttributes` | const | `const TriggerAttributes` | Trigger attribute keys. | ## Instrumentation (`@netscript/telemetry/instrumentation`) @@ -173,27 +173,27 @@ with a required consumer `span`. Call `ctx.span.setAttribute('job.id', message.j callback to annotate that active span. Plain `MessageQueue` handlers stay compatible, and the shared `TracedMessageContext` keeps its optional span for other consumers. -| Symbol | Kind | Signature | Description | -| ----------------------------------------------------- | --------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- | -| `startWorkerSpan` | function | `function startWorkerSpan(config): Span` | Start a worker span. | -| `createWorkerStopSpan` | function | `function createWorkerStopSpan(workerId, activeJobs): Span` | Span for worker shutdown. | -| `recordWorkerMetrics` | function | `function recordWorkerMetrics(span, metrics): void` | Record worker metrics on a span. | -| `traceJobExecution` | function | `async function traceJobExecution(options, fn): Promise` | Trace a job execution. | -| `createJobSpawnSpan` | function | `function createJobSpawnSpan(job, executionId): Span` | Span for spawning a job subprocess. | -| `createJobSubprocessEnv` | function | `function createJobSubprocessEnv(additionalEnv): Record` | Build the traced subprocess env. | -| `getJobTraceContext` | function | `function getJobTraceContext(): SerializedTraceContext \| null` | Read serialized trace context in a job. | -| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess. | -| `runTracedJob` | function | `async function runTracedJob(jobId, fn): Promise` | Wrap a job main with tracing. | -| `addJobStepEvent` | function | `function addJobStepEvent(stepName, attributes?): void` | Add a step event to the active job span. | -| `recordJobProgress` | function | `function recordJobProgress(current, total, unit): void` | Record job progress on the active span. | -| `startJobDispatchSpan` | function | `function startJobDispatchSpan(context, options)` | Start a job-dispatch span and propagation headers. | -| `traceJobDispatch` | function | `async function traceJobDispatch(context, fn, options): Promise` | Trace a job dispatch. | -| `isTracedQueue` | function | `function isTracedQueue(queue): queue is TracedQueue` | Type guard for a traced queue. | -| `TracedQueueMessageContext` | interface | interface | Consumer context with a guaranteed span, delivered by TracedQueue.listen. | -| `startSchedulerTickSpan` | function | `function startSchedulerTickSpan(context): Span` | Span for a scheduler tick. | -| `createSchedulerStartSpan`, `createSchedulerStopSpan` | function | functions returning `Span` | Spans for scheduler start/stop. | -| `createScheduleJobSpan`, `createUnscheduleJobSpan` | function | functions returning `Span` | Root spans for scheduling/unscheduling a job. | -| `recordCronJobRun`, `recordSchedulerReload` | function | functions returning `void` | Record scheduler run/reload outcomes. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `startWorkerSpan` | function | `function startWorkerSpan(config): Span` | Start a worker span. | +| `createWorkerStopSpan` | function | `function createWorkerStopSpan(workerId, activeJobs): Span` | Span for worker shutdown. | +| `recordWorkerMetrics` | function | `function recordWorkerMetrics(span, metrics): void` | Record worker metrics on a span. | +| `traceJobExecution` | function | `async function traceJobExecution(options, fn): Promise` | Trace a job execution. | +| `createJobSpawnSpan` | function | `function createJobSpawnSpan(job, executionId): Span` | Span for spawning a job subprocess. | +| `createJobSubprocessEnv` | function | `function createJobSubprocessEnv(additionalEnv): Record` | Build the traced subprocess env. | +| `getJobTraceContext` | function | `function getJobTraceContext(): SerializedTraceContext \| null` | Read serialized trace context in a job. | +| `initJobTracing` | function | `function initJobTracing(): Context \| null` | Initialize tracing in a job subprocess. | +| `runTracedJob` | function | `async function runTracedJob(jobId, fn): Promise` | Wrap a job main with tracing. | +| `addJobStepEvent` | function | `function addJobStepEvent(stepName, attributes?): void` | Add a step event to the active job span. | +| `recordJobProgress` | function | `function recordJobProgress(current, total, unit): void` | Record job progress on the active span. | +| `startJobDispatchSpan` | function | `function startJobDispatchSpan(context, options)` | Start a job-dispatch span and propagation headers. | +| `traceJobDispatch` | function | `async function traceJobDispatch(context, fn, options): Promise` | Trace a job dispatch. | +| `isTracedQueue` | function | `function isTracedQueue(queue): queue is TracedQueue` | Type guard for a traced queue. | +| `TracedQueueMessageContext` | interface | interface | Consumer context with a guaranteed span, delivered by TracedQueue.listen. | +| `startSchedulerTickSpan` | function | `function startSchedulerTickSpan(context): Span` | Span for a scheduler tick. | +| `createSchedulerStartSpan`, `createSchedulerStopSpan` | function | functions returning `Span` | Spans for scheduler start/stop. | +| `createScheduleJobSpan`, `createUnscheduleJobSpan` | function | functions returning `Span` | Root spans for scheduling/unscheduling a job. | +| `recordCronJobRun`, `recordSchedulerReload` | function | functions returning `void` | Record scheduler run/reload outcomes. | ## Registry (`@netscript/telemetry/registry`) @@ -211,19 +211,19 @@ Instrumentation lifecycle registry, also re-exported from the root entrypoint. Tracing and error-handling plugins for the NetScript oRPC handler. -| Symbol | Kind | Signature | Description | -| ---------------------------------------------------- | --------- | ------------------------------------------------------------------- | ------------------------------------------ | -| `createTracingPlugin` | function | `function createTracingPlugin(options?): TracingPlugin` | Create the oRPC tracing plugin. | -| `TracingPlugin` | class | `class TracingPlugin` | oRPC tracing plugin. | -| `createErrorHandlingPlugin` | function | `function createErrorHandlingPlugin(options?): ErrorHandlingPlugin` | Create the oRPC error-handling plugin. | -| `ErrorHandlingPlugin` | class | `class ErrorHandlingPlugin` | oRPC error-handling plugin. | -| `createTraceContext` | function | `function createTraceContext(): TraceContext` | Create a handler-scoped trace context. | -| `addEvent` | function | `function addEvent(name, attributes?): void` | Add an event to the active handler span. | -| `setAttributes` | function | `function setAttributes(attributes): void` | Set attributes on the active handler span. | -| `getTraceId`, `getSpanId` | function | functions returning `string \| undefined` | Read the active handler trace/span id. | -| `TraceContext` | interface | interface | Handler-scoped trace context contract. | -| `TracingPluginOptions`, `ErrorHandlingPluginOptions` | interface | interfaces | Plugin options. | -| `ErrorContext`, `ErrorLogger` | interface | interfaces | Error plugin payload and logger contracts. | +| Symbol | Kind | Signature | Description | +| --- | --- | --- | --- | +| `createTracingPlugin` | function | `function createTracingPlugin(options?): TracingPlugin` | Create the oRPC tracing plugin. | +| `TracingPlugin` | class | `class TracingPlugin` | oRPC tracing plugin. | +| `createErrorHandlingPlugin` | function | `function createErrorHandlingPlugin(options?): ErrorHandlingPlugin` | Create the oRPC error-handling plugin. | +| `ErrorHandlingPlugin` | class | `class ErrorHandlingPlugin` | oRPC error-handling plugin. | +| `createTraceContext` | function | `function createTraceContext(): TraceContext` | Create a handler-scoped trace context. | +| `addEvent` | function | `function addEvent(name, attributes?): void` | Add an event to the active handler span. | +| `setAttributes` | function | `function setAttributes(attributes): void` | Set attributes on the active handler span. | +| `getTraceId`, `getSpanId` | function | functions returning `string \| undefined` | Read the active handler trace/span id. | +| `TraceContext` | interface | interface | Handler-scoped trace context contract. | +| `TracingPluginOptions`, `ErrorHandlingPluginOptions` | interface | interfaces | Plugin options. | +| `ErrorContext`, `ErrorLogger` | interface | interfaces | Error plugin payload and logger contracts. | ## Command telemetry @@ -232,11 +232,11 @@ a privacy-first adapter structurally compatible with `CommandTelemetryPort`. Reg name/version metadata (1–1024 unique pairs, names at most 120 characters) and pass it to the command executor. The attribute builders and closed vocabularies live in `@netscript/telemetry/attributes`. -| Span | Span kind | -| ------------------------ | --------- | -| `command.execute` | INTERNAL | -| `command.outbox.relay` | INTERNAL | -| `command.outbox.publish` | PRODUCER | +| Span | Span kind | +| --- | --- | +| `command.execute` | INTERNAL | +| `command.outbox.relay` | INTERNAL | +| `command.outbox.publish` | PRODUCER | - Publication makes native context active, so W3C injection can parent the consumer or create a deferred link. @@ -247,24 +247,24 @@ executor. The attribute builders and closed vocabularies live in `@netscript/tel - Messaging and saga identifier conventions keep their separate ownership; the command privacy policy supersedes their general correlation/exception floor. -| Symbol | Kind | Description | -| --------------------------------------- | ---------- | ------------------------------------------------------------------------ | -| `CommandSpanNames` | const | Fixed execute, relay lifecycle and publication names. | -| `CommandAttributes` | const | The eight identifier-free RFC command attribute keys. | -| `CommandOutcomes` | const | Closed applied/replayed/conflict/rejected/failed/cancelled values. | -| `CommandIdempotencyStates` | const | Closed claimed/replayed/not_requested/missing/mismatch/busy values. | -| `CommandIsolationLevels` | const | Store isolation enums plus default. | -| `CommandStoreProviders` | const | Bounded postgres/mssql/mysql/sqlite values. | -| `CommandErrorTypes` | const | Nine stable command failure kinds, excluding exception text. | -| `CommandTelemetryDefinition` | type alias | Static registered name/version pair. | -| `OtelCommandTelemetryStart` | type alias | Finite definition/provider/isolation/idempotency observation. | -| `OtelCommandTelemetryResult` | type alias | Finite outcome, counts and optional stable failure kind. | -| `commandStartAttributes` | function | Validate configured definition membership and select initial attributes. | -| `commandResultAttributes` | function | Validate completion and emit counts only for successful outcomes. | -| `createOtelCommandTelemetryPort` | function | Copy registrations and compose the structural executor adapter. | -| `CreateOtelCommandTelemetryPortOptions` | type alias | Construction-time registrations and optional native tracer. | -| `OtelCommandTelemetryPort` | interface | Execute, relay and publication wrappers invoking operations once. | -| `OtelCommandTelemetrySpan` | interface | Once-only finite completion observer. | +| Symbol | Kind | Description | +| --- | --- | --- | +| `CommandSpanNames` | const | Fixed execute, relay lifecycle and publication names. | +| `CommandAttributes` | const | The eight identifier-free RFC command attribute keys. | +| `CommandOutcomes` | const | Closed applied/replayed/conflict/rejected/failed/cancelled values. | +| `CommandIdempotencyStates` | const | Closed claimed/replayed/not_requested/missing/mismatch/busy values. | +| `CommandIsolationLevels` | const | Store isolation enums plus default. | +| `CommandStoreProviders` | const | Bounded postgres/mssql/mysql/sqlite values. | +| `CommandErrorTypes` | const | Nine stable command failure kinds, excluding exception text. | +| `CommandTelemetryDefinition` | type alias | Static registered name/version pair. | +| `OtelCommandTelemetryStart` | type alias | Finite definition/provider/isolation/idempotency observation. | +| `OtelCommandTelemetryResult` | type alias | Finite outcome, counts and optional stable failure kind. | +| `commandStartAttributes` | function | Validate configured definition membership and select initial attributes. | +| `commandResultAttributes` | function | Validate completion and emit counts only for successful outcomes. | +| `createOtelCommandTelemetryPort` | function | Copy registrations and compose the structural executor adapter. | +| `CreateOtelCommandTelemetryPortOptions` | type alias | Construction-time registrations and optional native tracer. | +| `OtelCommandTelemetryPort` | interface | Execute, relay and publication wrappers invoking operations once. | +| `OtelCommandTelemetrySpan` | interface | Once-only finite completion observer. | ## SDK process ownership diff --git a/packages/service/README.md b/packages/service/README.md index 382fdbac9a..888e3767f4 100644 --- a/packages/service/README.md +++ b/packages/service/README.md @@ -154,13 +154,12 @@ replaces that default; matched contract access declarations still take precedenc entries throw `TypeError` when middleware is constructed, before requests or a listener. `OPTIONS` is not an exact anonymous method; configure `withCors()` for native preflight handling. -Health is now installed during `build()`, after authentication and body limits. Middleware -registered with `use()` also runs before health, even when added after `withHealth()`. A custom -nonempty legacy list excluding `/health` previously let health GET/HEAD return 200 by registration -order; a rejecting authenticator now returns 401. Add `'/health'` to retain the prefix capability, -or use the six exact entries above. Omitted, empty and `['/health']` lists preserve public health. -Configure health checks before `build()`; health checks snapshot when installed, while readiness -checks retain their live array. +Health is now installed during `build()`, after authentication and body limits. +Middleware registered with `use()` also runs before health, even when added after `withHealth()`. A custom nonempty legacy list excluding `/health` +previously let health GET/HEAD return 200 by registration order; a rejecting authenticator now +returns 401. Add `'/health'` to retain the prefix capability, or use the six exact entries above. +Omitted, empty and `['/health']` lists preserve public health. Configure health checks before +`build()`; health checks snapshot when installed, while readiness checks retain their live array. ## CORS migration (breaking in 0.0.8) @@ -237,6 +236,7 @@ process-owned shared resources. For multiple embedded runtimes, use `handleSigna host-owned signal handler, or `exitOnSignal: false` to retain process ownership. Register any host-owned manual-stop teardown explicitly. + Compose every in-process runtime behind one bounded shutdown handle without replacing its own drain: ```ts @@ -353,7 +353,8 @@ is raised while the contract is traversed, not on the first request. A raw route added with `.route(method, path, handler)` under the guarded prefix matches no procedure, so an authenticated caller receives 404 `procedure_not_found` with message -`authz.no-contract-procedure` until it is declared. Declare it with `rawRoutes`: +`authz.no-contract-procedure` until it is declared. Declare it with +`rawRoutes`: ```ts import { createContractAuthorizer } from '@netscript/service/auth'; @@ -374,9 +375,9 @@ that overlaps the REST or RPC projection. ### Unknown and retired procedures -With `createContractAuthorizer()`, an authenticated request under a guarded prefix that matches no -served procedure returns HTTP 404 with a stable machine-readable `code`. Apps can declare removed -endpoints through `retiredPaths` to return HTTP 410 instead: +With `createContractAuthorizer()`, an authenticated request under a guarded prefix that matches +no served procedure returns HTTP 404 with a stable machine-readable `code`. Apps can declare +removed endpoints through `retiredPaths` to return HTTP 410 instead: ```ts import { createContractAuthorizer, PROCEDURE_ERROR_CODES } from '@netscript/service/auth'; @@ -390,33 +391,33 @@ const authorizer = createContractAuthorizer(OrdersContractV1, { const upgradeCode = PROCEDURE_ERROR_CODES.RETIRED; // 'procedure_retired' ``` -| Authenticated request | HTTP status | JSON body | -| ----------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------- | -| Unknown guarded procedure | 404 | `{ "error": "NOT_FOUND", "message": "authz.no-contract-procedure", "code": "procedure_not_found" }` | -| Declared retired path | 410 | `{ "error": "GONE", "message": "authz.procedure-retired", "code": "procedure_retired" }` | -| Existing procedure with insufficient permission | 403 | Existing `{ "error": "FORBIDDEN", "message": "authz.missing-scope:…" }` shape | +| Authenticated request | HTTP status | JSON body | +| --- | --- | --- | +| Unknown guarded procedure | 404 | `{ "error": "NOT_FOUND", "message": "authz.no-contract-procedure", "code": "procedure_not_found" }` | +| Declared retired path | 410 | `{ "error": "GONE", "message": "authz.procedure-retired", "code": "procedure_retired" }` | +| Existing procedure with insufficient permission | 403 | Existing `{ "error": "FORBIDDEN", "message": "authz.missing-scope:…" }` shape | Missing or invalid credentials still receive the existing 401 `UNAUTHORIZED` response, with no procedure code. Availability is disclosed only after authentication. Retired declarations require authentication even outside `protect` and inside `allowAnonymous`; they never bypass authentication. -Existing public contract procedures remain public. Existing procedures, internal audience guards and -declared raw routes take precedence over retired declarations, so retirement cannot mask a +Existing public contract procedures remain public. Existing procedures, internal audience guards +and declared raw routes take precedence over retired declarations, so retirement cannot mask a permission check. Fallback authorizers cannot revive missing or retired procedures. Each declaration is a canonical, case-sensitive, mounted absolute path, matched for every method. Query strings are ignored. Trailing slashes, encoded spellings, siblings and descendants do not match. Parameters, wildcards, percent encoding, dot segments, repeated separators, backslashes, -whitespace, query/fragment syntax and duplicates are rejected during construction. Declare REST, RPC -and alias paths separately. For a parameterized removed route, undeclared concrete paths still get -404 under guarded coverage; parameterized retirement is not supported. Undeclared paths outside +whitespace, query/fragment syntax and duplicates are rejected during construction. Declare REST, +RPC and alias paths separately. For a parameterized removed route, undeclared concrete paths still +get 404 under guarded coverage; parameterized retirement is not supported. Undeclared paths outside protected coverage retain their existing behavior. -HTTP clients can branch on the JSON `code`: `procedure_retired` is the application's signal to show -“client too old” or request an upgrade; `procedure_not_found` means no procedure is served at that -guarded path. These pre-dispatch middleware errors are not contract-defined oRPC errors; clients -reading raw HTTP responses should inspect the JSON code rather than parse `message`. -`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are exported from both the package root -and `@netscript/service/auth`. `AuthzDecision.code` carries the optional typed failure, and +HTTP clients can branch on the JSON `code`: `procedure_retired` is the application's signal to +show “client too old” or request an upgrade; `procedure_not_found` means no procedure is served at +that guarded path. These pre-dispatch middleware errors are not contract-defined oRPC errors; +clients reading raw HTTP responses should inspect the JSON code rather than parse `message`. +`PROCEDURE_ERROR_CODES` and the `ProcedureErrorCode` union are exported from both the package +root and `@netscript/service/auth`. `AuthzDecision.code` carries the optional typed failure, and `ProcedurePolicyResolution.retired` marks a matched retired declaration for the shared auth stages. Overlay authorizers never set that marker and retain their existing fallback behavior. diff --git a/packages/telemetry/README.md b/packages/telemetry/README.md index c5ef3a7612..d25e078731 100644 --- a/packages/telemetry/README.md +++ b/packages/telemetry/README.md @@ -84,12 +84,12 @@ console.log(total, snapshot?.name, snapshot?.attributes['netscript.job.source']) ``` Incoming queue messages and trigger deliveries follow their own `traceparent` and `tracestate`. -Without a valid carrier, each delivery starts a fresh trace instead of inheriting the shared -worker's active span. `extractContext` and `resolveParentContextFromHeaders` apply this rule; nested -local operations use the active context so their spans stay beneath the current job. +Without a valid carrier, each delivery starts a fresh trace instead of inheriting the shared worker's +active span. `extractContext` and `resolveParentContextFromHeaders` apply this rule; nested local +operations use the active context so their spans stay beneath the current job. -To continue a job execution's trace inside a spawned job subprocess, extract the propagated context -at the start of the job script: +To continue a job execution's trace inside a spawned job subprocess, extract the propagated context at +the start of the job script: ```typescript import { initJobTracing } from '@netscript/telemetry'; @@ -144,8 +144,8 @@ One logical operation uses one INTERNAL span. `cache.lookup`, `cache.write`, `ca `write_through` distinguishes propagation/promotion; `inflight_joined` identifies a trace that awaited work owned elsewhere; and `topology_complete=false` makes missing provider evidence visible. For an unowned provider, a successful operation has `topology_complete=false` with no `outcome`; -`outcome=error` appears only when the operation throws. Stale background completion may use one -captured-context `cache.write` follow-up span. +`outcome=error` appears only when the operation throws. +Stale background completion may use one captured-context `cache.write` follow-up span. ## Public surface @@ -198,8 +198,8 @@ JSR with cryptographically verified provenance. ### Privacy-first command tracing -Import `createOtelCommandTelemetryPort` from `@netscript/telemetry/commands` and pass the result as -the executor's `telemetry` option. Supply the static command definitions at construction: +Import `createOtelCommandTelemetryPort` from `@netscript/telemetry/commands` and pass the +result as the executor's `telemetry` option. Supply the static command definitions at construction: ```ts import { createOtelCommandTelemetryPort } from '@netscript/telemetry/commands'; @@ -208,13 +208,13 @@ const telemetry = createOtelCommandTelemetryPort({ }); ``` -The adapter copies 1–1024 unique name/version pairs. Names follow command definition syntax and are -at most 120 characters; versions are positive safe integers. `CommandSpanNames`, +The adapter copies 1–1024 unique name/version pairs. Names follow command definition syntax and +are at most 120 characters; versions are positive safe integers. `CommandSpanNames`, `CommandAttributes`, `commandStartAttributes`, and `commandResultAttributes` are exported by -`@netscript/telemetry/attributes`. Closed provider/isolation/outcome/idempotency/failure -vocabularies are validated at runtime. Audit/outbox counts range from zero to 64 and appear only for -applied or replayed completions. Malformed observations and throwing telemetry observers preserve -operation result/error identity and never retry an operation. +`@netscript/telemetry/attributes`. Closed provider/isolation/outcome/idempotency/failure vocabularies +are validated at runtime. Audit/outbox counts range from zero to 64 and appear only for applied or +replayed completions. Malformed observations and throwing telemetry observers preserve operation +result/error identity and never retry an operation. `command.execute` is INTERNAL beneath the active request. `traceRelay` records the fixed INTERNAL `command.outbox.relay` lifecycle; `tracePublish` records PRODUCER `command.outbox.publish` and makes @@ -222,16 +222,16 @@ that span active for the existing W3C propagation helpers. The consumer owns its span or a deferred/batch root span linked to the publication. These wrappers perform no relay or queue work. -Command spans expose only the eight RFC command attributes plus optional stable `error.type`. There -are no exception events, error messages/stacks, metric instruments, or arbitrary attribute spreads. -Raw actors, scope, keys/digests, hashes, row identities, payloads/responses, version tokens, +Command spans expose only the eight RFC command attributes plus optional stable `error.type`. +There are no exception events, error messages/stacks, metric instruments, or arbitrary attribute +spreads. Raw actors, scope, keys/digests, hashes, row identities, payloads/responses, version tokens, correlation IDs, and topic/destination strings are excluded. Configured static definition versions are distinct from private optimistic version tokens. This deliberate RFC 0003 ownership decision is stricter than neighboring messaging and saga conventions. Existing `netscript.correlation.id` and `netscript.idempotency.key` remain owned by -those domains. Their presence does not authorize command emission; command traces join through span -context. Command policy also overrides the general correlation-floor and exception-recording +those domains. Their presence does not authorize command emission; command traces join through +span context. Command policy also overrides the general correlation-floor and exception-recording checklist for this domain. No additional permissions are needed by the adapter; the selected exporter retains its own documented requirements. From bd33beba2959ee32fc67007948eea59296ad12f1 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 18:51:40 +0100 Subject: [PATCH 10/19] docs(runtime): refresh shipped shutdown documentation and record static gates --- .../context-pack.md | 8 ++++++++ .../drift.md | 2 ++ .../worklog.md | 8 ++++++++ .../docs/agent-docs-prose.generated.ts | 10 +++++----- .../export-surface-corpus.generated.ts | 14 +++++++------- packages/mcp/src/publish-assets.generated.ts | 4 ++-- 6 files changed, 32 insertions(+), 14 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index aad7e2b2a9..acf7924715 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -42,3 +42,11 @@ Reconcile: #2630/#2631 acceptance implementation is progressing; generated runti Documented child loopback/hostname overrides, total and reserved cleanup budgets, explicit exit codes 0/1/2, manual/external embedding semantics, host database ownership override and OTel standalone signal behavior. Expanded the generated child-health page from the public option/function JSDoc, so its operational text stays source-derived. Public prose contains no run/evaluator/finding identities. Docs:accuracy passes. Release:preflight initially detected package self-imports inside the new subprocess test strings; tests now resolve their local source module explicitly, and preflight passes. Child seam tests still pass 4/4. This is a test import correction, not a gate exclusion. Source remains within approved runtime scope. Documentation generator carriers are refreshed after committing the read set, then the full one-pass runtime smoke runs. + +## S3b generated consumers and final static gates + +Canonical agent prose/site generation passes. Refreshed MCP export-surface corpus, CLI assets and publish assets; both corpus and publish freshness checks pass. Export generation used its documented --allow-dirty option only for the already-generated prose carrier; all hand-authored inputs were committed and the warning named that sole derived input. No lock changes. Reference layouts were restored after the Markdown formatter caused broad table churn, leaving only semantic shutdown additions in the PR diff. + +Final quality:gate, docs:accuracy and release:preflight pass. Service full export-map doc lint passes with zero diagnostics. Plugin doc lint has 18 pre-existing private-type diagnostics; telemetry has 7 (6 private-type, 1 missing JSDoc). Measured the identical command and per-entrypoint/file distributions at base b0eb07957 in a detached baseline checkout. Changed plugin health/SDK entrypoints are clean. JSR audits: service, telemetry and CLI exit 0 (existing warnings); plugin dry-run succeeds but audit exits 1 for three pre-existing missing @module tags in untouched abstracts/config/testing entrypoints. Git diff of those three entrypoints against the base is empty. These unrelated baseline findings are not hidden or fixed in this runtime slice. + +Next: one full scaffold.runtime smoke with cleanup, resource ownership audit, final independent IMPL-EVAL and head checks. #2632 is ready for review separately at head deb6b21cfcfc6b9d94e7291eb21def7072b4539b with required checks PASS/SKIPPED and no unanswered threads. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index 0d25058d12..b81eaf9ee1 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -12,3 +12,5 @@ - S2 touched 18 files including its scrubbed resource evidence, still below 30. S3a expands to at most 22 to include the ownership refinement and tests. - S3b source-derived child-health documentation requires updating its existing generator symbol list; it now includes the public process options/function. Subprocess self-imports are corrected to local module URLs to satisfy release:preflight. This adds three scoped files to the prose slice and remains below 30. + +- Baseline-only doc/JSR findings were measured rather than assumed: plugin doc-lint 18 and telemetry 7 match base distribution exactly; plugin module-tag audit fails on three untouched entrypoints. Service doc-lint is clean. No unrelated publishability repair is folded into runtime lifecycle work. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 9a18f9d47e..5e013da495 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -59,3 +59,11 @@ Reconcile: #2630/#2631 acceptance implementation is progressing; generated runti Documented child loopback/hostname overrides, total and reserved cleanup budgets, explicit exit codes 0/1/2, manual/external embedding semantics, host database ownership override and OTel standalone signal behavior. Expanded the generated child-health page from the public option/function JSDoc, so its operational text stays source-derived. Public prose contains no run/evaluator/finding identities. Docs:accuracy passes. Release:preflight initially detected package self-imports inside the new subprocess test strings; tests now resolve their local source module explicitly, and preflight passes. Child seam tests still pass 4/4. This is a test import correction, not a gate exclusion. Source remains within approved runtime scope. Documentation generator carriers are refreshed after committing the read set, then the full one-pass runtime smoke runs. + +## S3b generated consumers and final static gates + +Canonical agent prose/site generation passes. Refreshed MCP export-surface corpus, CLI assets and publish assets; both corpus and publish freshness checks pass. Export generation used its documented --allow-dirty option only for the already-generated prose carrier; all hand-authored inputs were committed and the warning named that sole derived input. No lock changes. Reference layouts were restored after the Markdown formatter caused broad table churn, leaving only semantic shutdown additions in the PR diff. + +Final quality:gate, docs:accuracy and release:preflight pass. Service full export-map doc lint passes with zero diagnostics. Plugin doc lint has 18 pre-existing private-type diagnostics; telemetry has 7 (6 private-type, 1 missing JSDoc). Measured the identical command and per-entrypoint/file distributions at base b0eb07957 in a detached baseline checkout. Changed plugin health/SDK entrypoints are clean. JSR audits: service, telemetry and CLI exit 0 (existing warnings); plugin dry-run succeeds but audit exits 1 for three pre-existing missing @module tags in untouched abstracts/config/testing entrypoints. Git diff of those three entrypoints against the base is empty. These unrelated baseline findings are not hidden or fixed in this runtime slice. + +Next: one full scaffold.runtime smoke with cleanup, resource ownership audit, final independent IMPL-EVAL and head checks. #2632 is ready for review separately at head deb6b21cfcfc6b9d94e7291eb21def7072b4539b with required checks PASS/SKIPPED and no unanswered threads. diff --git a/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts b/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts index c1796f10d8..6b75cea640 100644 --- a/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts +++ b/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts @@ -311,9 +311,9 @@ export const EMBEDDED_AGENT_DOCS_PAGES: readonly AgentDocsPage[] = [ ["pages/observability/index.md","H4sIAAAAAAAA/52UT2vbQBDF7/4UA4XSgP8ceuupprS0UJrQGnIIBY92x9qtpZ3NzMiOvn1ZqZFj00DITUi7M7/35o3ewHWlJAesYhOtn802ISooOYucwPGBRMEEXUz1HBqu65hqwORBCH15NmqoJZMeKnR7QCesCnQg6SELO1KFmADhB9kvJzEbYM7L0olAumSxJQVqo8F1prSZymnGpHNA0JjqhuD2/SfYFhTKKJRsC7VwlxUQhp6Lx267ho8QkzFwIvBRTWLVGflBCM0HfDXpnHVCvqhSkOgJLBAotgTXm+83QA+ZxZZQQNeaoxB41FAxih9qIFifycN9N4hlMajYwmANRBsMmYMy9NwVIUZqwAKYAGtKBg4TuEBuDxbQipCAqSY4suzJP+OlgXHnAvnlbHb3iZOjbHCy7e00pXVn3KJF92hlkbf9mMh0mMNqGt0WAjWZROdQCR+VZDBlvHHSfIh01EF5eX+pffn7XTDL+mG1kuj2fYOVLutooauWkVentvw0cSeI1dVsdveVjwtjWHt/kYaNxLomKS7+G6L3xVcBPqZR4BTLgteW0J3hv5IvDEQr9H7BmdI57ueH3GDCYVnOFgluy0Cjwk6wpTLPhRA2UPapK5FVh7sdNyWIXTVGMvBxFAeOk9GDjbkmnWZfcZc8SiR9sRg6EV4Iu3oan6FtsUvovisxbdlTA1+4KctU9ujxgwXhrg5QSkVHOoc/XI3eqwlhO6x7KbWLB1o02JOM1V7FXCh/0o6Ekns2veubbyDToR3LGNApPBndHmt6McBU6yKd/wcp+0byHMX5j6YmeQXFeHF1NfsLJMuanq8FAAA=","348a780c878fa4bb559bcd98b2bacabe4a9ecb704bb982f495116bb99758948e",1455], - ["pages/observability/telemetry/index.md","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",26129], + ["pages/observability/telemetry/index.md","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","a4373ffa9451fa3eeae9a3b7550ee1c57218ecfd262c670524461f5b1f65e503",26591], - ["pages/orchestration-runtime/child-health/index.md","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","3d7454f7b1737e9421c9dae6ed49964cc9f45fcd6f3ed001cedeac3f346d0708",4444], + ["pages/orchestration-runtime/child-health/index.md","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","c981dc61711a84174a6690fe9000893102006500bff5308e8b1fdfeb03d3e5d8",6107], ["pages/orchestration-runtime/cli-scaffold/index.md","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","178b545a17f3128b70d570fd0aafb32e92ce4538e525a7b674fa9fffe7e293d2",6795], @@ -395,7 +395,7 @@ export const EMBEDDED_AGENT_DOCS_PAGES: readonly AgentDocsPage[] = [ ["pages/reference/plugin-workers-core/index.md","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",14510], - ["pages/reference/plugin/index.md","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","6a93d1c0c4d53fc2b66c4d293efbc790b424cfb65a5ff63f22303f93afa5334b",41368], + ["pages/reference/plugin/index.md","H4sIAAAAAAAA/91923IbR7LgO7+iNhwTpiYAyDMbuw/SidmlKGrEY0lkkJS9uw6HUOguAHXY6Oqp6ibFGc2/b+Slbn0BYFlnY2JfbArdnVmXrLxn1ndi+T9r1brC6qZ93lTdRtfLk5Nr/EPsZK3XyrUz8SArXcpWm3omSu0K86Ds00zIuhRb49p5YepWfW4F/N/KonVibaz4oNpbhLwQH50SuhWtEbJrt8YKKQibeNTtVixLtda1IrzLgE8JKawxAHfXGKdpAIB11emqFO1WifN3lzPhCrlem6qcCafsgy4UDU3Jqt0K19m1LJSLOHGYetW1yi1OTr77Ttx2q3kj261QnxtjW3dy8kVc4J/ii7ioW/vUGF3DP6472xinxJeTL2I+n4vsvydfxtZTfBHLxfOdKRetg3/w6tJC6HoTVu2F+AXXAef56+l39P08/vZsJn4ptdzUxrW6cL+efpf8Cx4qa42F3+kP+CnMVZsanmT/fobr5PdZtE+NcouJeTyn5eTpOFvwD8nMfnkli/uNNV1dimILO8Rb4GeI6BprCuWcaK2sHazxr6ffBWSEiz57NjmUwtRrvUmGQj9kQwEKUXYWZ+eKrdpJop90FXDakXSHoyHg06ORK0efJgMKv6VjOuMfc/Qr6ZQoKumccqJRVsjPemQUAeKegZSyaZVNh0G/pIN4ZwpZ4bGFY7WD1eC3xpDSkz07Uel0GyqdomJKP393mU1yFhDvTFe3ut7QppSmaI0VVuEZHNmHSk8PxJX3yUBceZ8O5LXnWQJBz4Ssmq0M8yb0FsayU7Q0ru1WI0Nw5f30ECojy7D69A8/gLfAJZ0ulWdBnk+tjGlhXxuxVVUzugcEaRptY01rClMl0/c/jWxG7zg4nLquXSurSlnhvxSR64wMyb+1ZzuYI6d7wj+lg7pTu6YCRr9RtbKyNZYGZNVGu9Y+CbXT7ThpenDTY2iVA+JKhsC/pCO4rOc7tTP2KaGGtf7cdhYIFcbCUiYysa20tXIjQ2Lw+0ZE0005RfhtZLPcvapUCyzKrxMcoFaArBrFz6D2ck6cxBwOZM5A4+/pSG5bWZfSlkF2ykaudKXbJ1FsVXE/zi8jrD0kQkcgpRD6JUV/1bVzs557mdE/Pboux4mDXkDkIOB5PSNRg4S/fdqtTCW+iB91XYov4lZvagkbL76I14rAAYMelfVR4me6i/gi1l1d0HdiGf5OX/q3uw9yp2bi7idlnTb1X05ruVMvBP/8QL++CM+fveDxs0wDJLettK2QolaPflHCyUblSFlRbKWuefkHAJAXwxDpj8HzN1Wn6ggL9Dmgvd2qApWlh9IrDRmU21a2uLtAmKiCAbr4j/GXL3e7rpWrSgkHPwlZFN2uA6ouxeoJDyMjH53mu49/vfzw6e5/X1/c4ixN7UBtWz5IqxFq/43brgGZoBICb9XGWE2aEBDP66hkfUOy0bVrVNEeoJvsrdNW2o1qn70Ql/SzNvUNSktcOfotqrlRf/fsdCaMReYxr/S9EgSOl24M5MTOjb3677dXH+aOdi5qpSzMhVVtZ2vaQh4dz8xYTzwMFSDQdN/z+A+PZPyb97rWO1kNzofbygYJSzVDqgrDmhrVDa/lbxlV+o0fVRBxxw8HiPECNfsxOjxIe/GEIpCUC7wC9QyNBjzpjLyRxb3cKLGWugJ5mJ3yn4JNOICGP4h2a81jLR63qo40GTmw0E7oGi29DO55tPWOABw4kChkXZtWrECVBwgK1JrWCFMrMiJBr3spCmnhbAvX2q6AU1uKZWJFLafGEplAf+OvapVCS2xVv3AvxLIwpVrOxJJtwplY7pRzcgM/gpJhcN9kJZag/cNzXaq61e0T/A0WSKWL1v2s2+0RQzwHbOILWTay0hIW75YO58j4BIzO7+7rrqk0MMEJUtmzuSDGYFuJtBWsxs5YJdqtrIWpC+WJ+Dw1Qn8nLaewBiRN/0hIOrO81OdW1SBhhfwc5p/CO4O9GKzjQGKkMCcgXdZN1w5ApW+A06NTwKALWVUrWdwLq5ypHqYEX48MkhXtU2iGBuzzxgkXZhFZcl+cR3P+mvQvY/urnaJJrH/W12AywdeCmDytpEski5Y1nX3Q/atePzoA+fXqFg2cfSBfy1aiYUq2kFhrPB/7wF78We2DeFGX89bMFZgNIGpS0mAI7/XGIts8NDIgBR7Yzn8zBvCG7NZz9FLcmQaO/zRkfhsArfVGtPD+gTnfkjK9Dyq/cghQa5XcHRwivXbU0O5UpXaqtU/74IWX0M613U7V7fhqAm+66TkcE+fnycnSeyYHzPeUDY9nS3G6tma3x231DHgknGcQTWhEeT8nuh5sVzsB3gqhWzdyNC+9OuXE8h/C3L8Qre3ULBvzP5dAPfx4LSunwHEbpBw8JzMb/SFCoW/ESwMNzFqJRjq3EMvCqjBfcGO88h6L5SyYxjhu8lPMxBL+uAkigL4EkQYYl2zogyXbaKuWQlYVcjyh25lwJrhhomcEvuPPkMNurFILkBpR4LGABfpW/6EKIBYUTT3Zgeaal2/z6J+9ezSJJuG20oLreQnyzEvbrr6vzWM9T0lmfq9QpQP5nHLfralKcDffK+Dbsp1g0qVRToDOQsYhI2KdKEMESM4EDiCXNoDBY2P5scZdebSm3pBquejPewC5Fl7ZAIpQsnXolvd0gGNH00EW1gQr3AnYDCTcuXkE5R5UF8a2087pejMvVaPqUtUFLtSZKFVRSVAM4gM4DbAKXm3z4w0vzJnjz3fa7WRboA/6bpsoegkwLx3C4jrZarcmARqwO7WDA2ZlvemvOwOg4fLp80CNTVHh1370+DHDRVZyIYvtyGZJWDYVFxyI2xWmUS+Aon9UT2DJ+YdfxC08mlaB2M9B/iQkV/GFWAk9Lu/PK61qdk3rMn+8Gsr3SUiRdU+9YgdyaOpN9Wc18aT1rHriObubFaztkvzF5+iFWgoFYZr85Vy5oNEk28ubS9TGqgApDfQqGMr994IkzueWvsKMbeYHiFrfVomdKbsK2Gq7FV/oZIHD1X95AoJnjqRQevIAQ2XXgUtHia7Wf+uUP4J4xrcm1+cX7FMZgWLq6knUSpUQg4vQ+Ji3W6X9UJAJk0AIHpFU2Yp+UH8qlg9/Wi6SA4lj+d6JnbIbMK9GuSNhKExVkScBTsdMgJO/K8HDBFu9yHYYnuKyVbpW0nr5FOQISBe/4q6VT8CekFBoGjCg4BDBl3F8PZ6Mdg0Ypq5VsgRu6nSl6rZ6EvdKNTAyWPpKOjzysIQgZ1am3QoNOr4T4KCFYRIn3i1OTi5wrmOsz29u5H2XrUuIFI0pWQrw02dMC3dJggmT7gRyR7/bunWqWi/EO72yEnaTrHmgHdkKEHHAtzwvX6kKJIaugfPWZvEfDvHvOGACr0LQMqzh9y5h0Vq55eLk5C/il/9y+f766ubu7MPdryd/EX/84yur5D0GObfIa//4Ry8MvaeGThwel8RHerpYLJ4t0NI5fca6Ayx8quSQ6mRR4AuWzwOO6xbiTIA0alRVqRKZsOuKLSwpsk/gnjPRWPWgTedg3Ta1saqcoT5EkjC1vtDI9cO5V08LcaPI8MX4NooZU6CSSehQclq1Mw/wDgWc32ch199pAU/5yfoRH3CGdjvSo0NsHnU3Crq0xoBzdzEG+1paR47hFEPwsOFT9mSBtR1wsr4McR2IrTtvzGrn6TFHp1oJrHhgKfsHQratLLbEx/Z6of0XP8EpHcBjM2ju5FqJnQeOJzoHc/fUjLhS9juNw8ev0wPSBwKQA4BUrVCFsUg5tFigHCs7L7bGgbMFvo7OmvAZ8DH1eehiiG8In6UBpn+laQmz4xIcD8TJvEX0Tq9V8VRURPYM5XfSbID51hiQ3jldRYxbeDzqrEgClANPCC9E333QnzxDqnJsGbR3ZrMZ0j39yvR+HERYyGmT8F8vHBXiUN8i+jRpNU8O8LCd7YeVPLtRrqtw59k5ja5HL+NSXzGJ2xEH8ULcKiV+2eME+PX0OzR5kqfz+NSHO8d0i4mpDl89BU10hj4Aq0uVzrUH8D18O+qHZDcfSC/TtQKCahCb5qP90is6UXsBtSUoU+A8YF3Km0duzDE6HrMavHqKjPUFuMkhPv4CjPtKSdx+1O5gHO0Wcl9Yq9Ko8IRj33OxBjNTuxsFQty7GYCS94xr+DKHXscGdoNOFnSuTPq5CVwmUEfFJys54xHJiTf/jymDYzI6sAMRvxyqOqjUFVViRB8OqXyz0Ir36F59uLu5fPXx7vLqw6ez/zUVhh197WjP+rcP896BRqJipp+swBWl5pwQ2A+gz8a8+7MxeTwbjYrPDjvXZ/u947MJF/ds6KOeTTmdw9hyvjIbVV9mE6K7txTIGTLA2SqwPJ1l6tVsoMnOBgrhbFyvm00oqskIorAZ+5Flxmx/yG92ONwWXqEjNpuKk84Oeuxn4y732bQDnQ3acW/4LLVHyNinU+vI8nZCrswDeFTHVZSY3vgvFqkjqGcoso6ETS/nsPWugWXjmEAvleVwBGwC02pvMOwQ3gNxsQmcA8/M0fimomUTiLy3zMuno/GMhM8mUKgYSTsa+mRobQLHeFhtL4rDwbYJXHZv3O0Q2okQ3AQunx53PPjpwNwUitEY3SE8k+G6CSzBHXw8imv5BPGnqEaN+StCUiO9hrq8bDVmnQ2yccb4UcgWz5cRoV06Rw6HFHOUAkLDcw69MQbyhHAUJT1TEyiioZPZ+gkSi2/keVfHYPlG2Q9TooQT1L9akLyODuHbRg1ScS4+t1b6PHJyDwbrPAkeC6fkzntQ8OUxYLdA4OgWSh1n6MkH6mkhZ5hRyQpUyXbrgV7WazMKEii2SHNoXbfbgXM23agcha7XxifMx5w0SNf+2kFztvfIqAksGPfK3ihnOkv5ub05wGNMToHnnKK9B8/44AnMrYSz7K5NpSlEmBHbK7WVD5qT0mQdIDoeA9opgBQD0OozBA8gt4uAMsJgmUWfyIiXlEkzytB0/QrIYvJFC5XZ6CJXQWLdRQqZfxZmhR7qxpqyKwbZPB7xWgIpPeVqQKVj9dEwe+jdZWqypPCzqD2Pgz0nzxatOa/06bNBHhnMjgTb0F2qZIlBBb8IJMY6Fp/pIfPbMQF9r28OAu90UsNucIWKJ9W+moSPxw7ClU+o4yoq4noe3lbWZTVIocJn4/7ia6t3utUPiv0TQUBAmqRnhCNLkysPE0dqfKzhgOXn5wYjCV979jkO0T/6Hxvwln0t0A6/HgAlGnytavNGV+r2ybVq13POnOMrHJtfSxBZ8P4ctGdVYkLW3OGHWLlDfCCnjeAKv3hz9vHd3Se2/N9enL27e/vp4sPr66vLD3epl+A1Y+LiNFWXdIA6lzuYWYzsRfPz1c2Pt9dn5xefbq6uRrE8GnvvGlhMNLoQCfKt2kBIpNKFbumRduEgMTJOAPzZg7jmiHSygkBTFexoRDS3qpJIqxhrlhsJfDN9A/FluzRgZOObhIwwcKy0jjPwTeJ2MTeN+T2fLiL1gcMfHShHiKz8KHD0mDGc2VYDE+07Ji92ug0SQ/qXBCZpRT78vYvSRcnAZ2h1vMzikqOcJw9XSoaC1LSiKmHVAff4vGx/1fp73tVhN5hZxHTxUdF+09WsOv2ubciPRBxtBvvowU4oT0SKoEKNFyLcxlzrkeqCg8oTkuTa/F56HMC1GdzfsGNrM7ZdxJF/3yiZLw/GmcE+eqQTXP6mq0kk/b6xsmAajDWDffRYJ8TcTVcHxeprhsvQQfGyXV0HBcIO4faHaiB1RqYQHpRdQcwwrgFqlphnl2sCubYSkHl2dE5JUb2FicYOvzbKgFBxhtG4bhWK7JhjHeUYD95EUH0QENp1LrPV0FuN/+QjHf2plT6zm9RjHFcw/a3vpg1+ZHR8Rv3iGqBDdEtFxhtGlC9bwsXBtRo4dvRZI2z/gEfwMuR+hHUN8C9btYtwUqheNo399sqUWOThRdMdO8xhENl3bbe6Jf1xJpZ35l6Bb7kj1zwFdOEVP27XrVyr265V+Kob8wNrK8xjDWFB7wue9AJD5t03jFKHjZ2sReRnoWZ+NeYl5gNC5bmkflPgc9pptw/n2Iv5ABIHde7R86ZQT13ECvdsQuMx4Oy106LSkEj+RbyH31Omkc+SwnBSrCsZq/krHYwv29UIQZXjXGkp3VNdxF8G75/66cyEtBsX4tB0aiEubc1OUyUxMR2cSWJpwWhCFJqyXIDeTC3OK71ePwmIz3OdWaUeVOWHDgzzJ2VXh4bs3/tNQ2Vu7Ae5wrzhFQZ2Gf/a2J3kLXmrqmZy6/ovhnE882Fl+PQNvhXtT1U1Am1eUqL9qsWdDgHulG9eS8yq3hPhHnn7lLSkFyJ9diDUTdmZmSMNM7YQYN9FgQz8UJ1v8h7TFmwTsiMCnCXQYFEBSb2exZ8J2EMYk1fPwhqnx2jUDxCkzREY4pv011il68hkUtk4jaX3VlLuQMnOqcdnv9Gayt5D+OJrZ5uNVRtQ+rLWHLnhF2kVO4tcWwP2H0hkN5ZnkJr3Db1LdVepVVlhj5Jk+dRnVaQ1T2wYMzLI1umdiVEL+ePNO18Aja2IPB4eRmIUJ7NANaG/aOnf8BJviO+N1HM3wwxgjuzJcIUMfqHeak3huE5XyjRcCuP6LouEtP3WW4jgW1+A/B5z0PetFbwNBix6quehSJmT11FvTGapW7Wj5FGvbDaq0GtdePSt8agvMZUYXEx6rQc+hrH9qhE8GOb4qYeNvmd2cOAu+pKi2DYkuMron+ABAN1s3wr7FjEJFERP+b9YiUV7EL0r7J4DcuohpGUec6cNPc/z4DwtVYsZx7ipLWjZvBm9XWBkNYiUSv/d+27s5mF6UT/4l4WVj8B5H0SLaiGpED6nQVacA0t1KRhoE5gYvq7kxm8qpvsO2Po4YszH6LtIET8iRkWa3L59geI9St6N72dQ5vOdWt34fjZduQYmg1YjdbwhU9HhFnuV7tHKpgliQTZN9eS19uuKRObEbCuZGFx45ul0QEAe0r23akfZ+cRDrYJOAF0okEyQjMugrJSTJI5Zi6aSNarxABRGC3/3jMgwqsA+MhcXRF4htYZF5p4dTdyBfueAW3Roh3CTMLZBwLmxDLvuQq8Jn1xBKPceS/A89/07jNZnxPns7R7nW+u6/KtnDUdJijdg0shMHmBGXLfZJj+n0opRQcR5gCrp+TCO7p2Byo66TNvdRV4WRhFaIaHFHRK/ffbzXztpy0G8YizZXWzgVaa8iChpyYBnnzFMzWfCYTKMZ5CdBktD1Dhk0yROwsruCRxDd69vaH3arv5ZVvfKXutGQTnRYbsof/+U+jW4F7C2+SOe/NA2ShxIt69/jH0URcNf8sKjq5pgTir6yTunQKZJBmuC1adpm1rN3da0iPcRvyKx5mMueTu0fBxQUXRwIPjS6bMXgv98i+pulipu5qZhRI/0UmpMZyuSMSZyefzVymY7OYrBm6fIeqEmOu12+EL0gEV/PYnyDTwQrpYNLheSJ65XyssVJBlgiXEGPRv0YBn2DDt7d3QNwzBpEf3ykU1B5xnXdXoRL/PC91dWl5tD4xr95vRZNiCqVaG88ry0foWvj8SYkhjwHuTZu6dN5N4ppffhhWHt8s4/vvAFVgrWKHT6o5Z7I4PMC92PGWr2xaBIYQAvDJWHiH7YWPKek6AMEiJrLxOS+KfSvPsBmmjZjU6n9x5Pwi/4jPu9PcsdCZ679exPfJV7DKBvQULhvjcnyY7k4Z25FvN2fK3sIDPdP6S8wM970o9C7QmG8TT0dyUcb4L1FRlrH098x/PIhD8xg+ifrvfYOtDnHrPlMgo99hkMlTJsxNpgxUHLEFq0eJ6xEaXHhur/MdjeD3Cwyb16EuVTLXe68LWdI7ZSOw70pteUkYprHi2sM9YCRAkPad1cX+jLnn1uzUgVB+NE3/0+e8n7HhA/MJ1EW/JxH69ZwGZ68J6AjkdAXySd7jJWPxQMfoN6W3M0QtqmVGuPZOKVJHaSQt4qLWmwhxk76yHH4vS0nMySqTydEgIt4Wwc9IFMeD8YKJ0pb+jkcngK7O2oWE7dXv0DmZCx83X+k2pq10KQr5e/1m89mhMReManO80MchEHagLU0pSk7OO+0uKEte4J/inYP+caQGofkYrXQtk7lCe1+3nHb1TmI5nG4iCcBvESrLzpE2dgMBOK8tG4OzJxYY8SPbanPE8qOlMo6A2xUu2jUkGMeQ0BY31T7YMyY3Yg4Q9b7UHcY1uBVBHA1pdTCeAjCXSHCl2TxFduj976KR5X/fT/UbHS76408iVL/wlVPJMVPINyKnSv5CXKIaYPBiEXFvvm9zMggF5MnmDkulyAQSkB+O1kSJj7XX9DuzxVqGPl9UHdm15lfRWqOgdGQgQWFO+Ka7ipVcrYIeF8iCPqwQeRofiaLzmoDpSMpzUb6nMsvt/X8Pur0+gTB27aPGLgtu05p/qaiQ/rcnQm1ZbKwL4oT/L92YfLNxe3d59uz99evD/79NPFze3l1Yc0YfK8sxZaDjfdqtJuG2sUfDUTSIGld2MuuA8c9inpZY5xM/Pp4lsulGCTAh0zAWmeSadiL4v9SAZp5QHg+JDHE80DVnfMlI6rNMn6bqiRifE678cYlmykHgDEfiyB93wjrO1xGD2ic18cwT0zMtk2LJygQJWsqqTBTqp9ju6ex/VO19Ccpo/mNQKiII/Pwp5X9G7ct2gdun3Az2l7qbNWFqCQsOnU8o+RcG8epog4CdZ47Sieq/VaF1pWnBs0UAeotIlWLfjKYfBrbV07b6SF5aRJFqYZ6tQjBbahjHyC8nwrwaCZcgF97EUTSsqRF5XTqEaJHHruPgxLqqIaHBAB+L1NbSZqqUbC+URqAy64F4OBswr8eHBsyDomDYs5KISqMDw1FbpxXVEoFSIcPVzWPGhu0HEkBTCWexAdDX/uDaChihuZT0hxG49o9kadKJbpEeX8z+HpjPBv1N86DT0klWV7bnCKIJ8AnAv+ubD8TcoFeiPqHaTxtO686i3oM6H2MA28M3y4xiDce8G6cy+yF9MLD6ntMPxUDCUaytR0eqmK44ZHStF7AR6f+tnTjWDlJpXGsEBfrbz0six7s/xYg9UZGoamVdGDtMHOKVvh/SeQxtBbxJB62UfgP8I4YOI8CNwa0wYC/gmwmPU5aFT7GZzA5RNkZXqg4Rj5/FAflU7TRfsZFJJSVNsAkJ1IU8CyXNOJmgYizwkASXJqf1JPjZqjPxgojBw64NT0EShmCJB6V3KQnmGmKa6D5lnwzOcq5Ec+NvkELJmDJcmSzSdJEh9nOTFcHxTrZ9XmcG7DY57Q8g9/uLv68eLDH/6wFDtp75WFjItslAMcecbMIDOdkmHoexJ/ngg5G3Qk0JoljgyTgSbKK8rkOJr1MZDJJP4mCNgDM46INnJvVtM1d+cZ5s+kEW8kwkq3yspKrLWCW+WSW9AYz9S0JtD1h348vjxbKx6osRStUrUg9mrNF22MZGol1xKAzM+R5JP6TbjG92YS54Qo8Pcz/Sc5ELy68oZuczrKk9D75jS04PofwZWQGnwXn7HSeOiyp897IWHvSD9uQIP388Hkfnk/kCQm0RtEXqJCEnFfJHDwMiSlJ0nVvQRizm/IM3OyW7NiGSL8jHoN3wjx/z6OhgCmI4ERx28MBO4JnkWY/QBDCh1HnoGMpS1JceY0cNx5jmKmGbUj8HtFM3tcyt6HlQJHIdRLP/XKAVtDRyuQwVnpC2n+1dzNWQurb+J/7vfB+tf0R+/pKkU1Vniy/K6lYdzZVMRsNhElnY3E7mZZ+JGHk0Q5Yy1WVngWy22OLDNLnOkxpX/SgomX+H19Pyxyit7+ePHu4u7qw6e7i/fX787uLj5BW7yLvFr9YrdSZQm6sU9h4eIMzt1q9l4VuNiPMOueB9XlWQuuCZi9jjT8kr/K0deo5+0TpgD65Onp9qjJdYVfvd6vzm4vfMX+xc3N1U02b2w6ZG6uz+kGrPlONmJt5Qas/KQnRa/QPV6S413p6BQbvXrpHSt8dMMW3raEyZiybhU37BgZ4jiCmPk55hSjOgS0MHrj/d4lcxQ72YSIaatsLSsCzr2Xs0A2ftBQX6XYtwjopKvVZ7iejGwPBDN+Wdg+p+57MIvapoLOBV6s0jVyfevAh4CzK2CGCIb+fo70J9008+JjXqolYVypJZWVTWLY4wwn5Zfy6JMYQ+g6GRzYvhgz0FFCANgd8+z87tPN1cfeIX0fK6axiG2EUNeKNOeDBJvqgQN53+0Yg3fn53cCeLUOO9jzHRsDBHQ4V1CnU6iSdd68r3eYTrL4jX896Sh+cDIeF9b2DfBc+E4b+CtfkkIlpfF8jO3/lBuLLy/9apaUWh0sl3vqODYMHUYlQz96Il+4Y02XZaUe0X8BCXe4a9h+GXJA5jJrKcKLxQ38YrufibSLR2lR9nClhr93lfLsvnexE+CerjfyMexJ5o+Uj+Lt3d01D9iX55XaqgLuW8DbZfLJT6REjEwBJjjHQosBF8lBvvTeIydqivhgljy44rt2y8X4EMsr4I6+OYQ7cQcgGbdeVbKGGwikC3N+hVrr3uPFGuV8RRel+5PE2ah5Hye44bYHLedK/OsZ3c36NL0a0UsGPQewrliK3hA6NPeXzx8+PP83Wqa/jKN7hRfvjk2MSqXxMZsHag1NY5zCiz4www1G4m9HU5/7naIIBiVBUdQsO8n8ACSYKJXV0H+ZvZtFtrAo7cLUkMhG7syTRXsZXPrTM4puf057hClCj+rC1IVVmNN6eFJ4Dn6kS6PyaBMeAezh/Ah9/r1nk2K3OJXvnS8inb4A0KOwEwjSWWRxgLq3Wj5jGmYZY1t8AbCawpgwL6ZHNdiVbbJ9RG4hwM9eYOxQxBhHyL/HJLFkJ2kJ6fPt0OUAl8ojieBiBOTsG0ho4nAGFB/aN9SljSxQ63wOG1qciaX4FsugQu+LnFXFH5iWk1/eB16e/Igr/F61WxOslfSJz/1JxZSXT2jFhPuvQ/pX127haqCC/MeNcaAwnJwcvjA8rEfasSB4iPiPGfGXZ5RiBIKjR6TYZIADRXhxEPEj+B6cRMBa52rXtE/JVTg47UAfS+EU6j2xxb2rpNsq99LfKhvfwDR5sQRD2SfGQxvLiqvJoJs7DYB6u0HpJa6rv/GabulikR04btdujdV/V/b0mLWAdnsw03DskuvknaiVA8rlyT4P0xRwKqm1O4Zo1Vp/VqW4ubi9o0vgxeMWnDKY62kxMzMqTyHUi1UreG8wjSH0lfPMzYmupgt6yoU4l7WpIaUCkRMWq3agThT+0Uto5WAVNFEvqfsEvdc5KgxUn8FTjNkSWfCZch0XJydj+s8prfpM/AP5wIwk8D+fLaOIxhuPWJNjqn0hlvDeC/EPfL/2fzB9Gyv+SZD+7p/Qrol/wi2IHF/Nhb+b8bIGyKQB+JsWSeC/EN9jkk+BiQGdE2fXl98DTCqKAeFQqkqv6LpD1iGCIoPXZYWV9ucZiIp7YcbjjxV+qkyeZTyABpE+xYgCLL2aZAzPYWYEB/TGwOlY7ZhWeBfiPV3tNxM7WUHzC1CVatBCgTJ5U/yZC8I/JLdReAB1RLhpA4jll5QtCavWyqq6UL+ebtu2cS+eP7e6uH+q5MotNrrddquFNs/jAMMHYW7feRqZ8y9zHtazYPslySMol6R9WoAUgMuukcNTT4pAF6QMsl4cDgtOPJAQFvdSAgfLvJlfgJvrc9pyX6ESPkLAiQbPH5QwKVDWbq7PZ3TeUbeXj8Sb8B5Qh+DaOaQNUy9DegZMRoYOPzwDJsAVt1SFa7GKzrVmB9yWmC2Q49POdG5OnIaat1iFtjm5a9nrRN4/v1ThrkW8ygTA4F0eDZIjRSX9xVcjlMUlw19tSZ1vdVWSwKXLFQZ9UvFGDFHAe5RaLR5MIVddJe0TpIpCLBsIGq5ae5qJUm2sLOEGsMJKt51XxgDXmgnXmqbxN4MFiyrFzyUKw/wRwAoIyMP5PLvuCQpklXPwGMciCpAYJOitKqmIYC1bWcH9eHipX4r6DTwJCVkZ2jd4JgMMvnKc5EFjiu18p6tKO1UYsAJkg24DcCK7Vu68g+j87eW715/Ob85u3356d3V1/enu7c3F7durd69Tv8Td1irlZ4Ax7v/+A3SVMnXpwMbiWtfIyUUBwaPg09npOnpcKLkvtDagxe2H2snfgdch8lWuIAYLBcuqXoiuJsLKNpRvicOba/2heQI3sqATAJfgoDTE17za6+vWDo/m7PryOdGZ/0iDoBgdSfgRHWmI8CXeVEfX5emqtKpOEuXg2ttezQERHWVCjudihYtGZ3mqhZtB0tQ89JjFYwGtk8BwqlPR9KBsqUOeR0Ls702teyV7d1ZC2V8gaQSH/JX62SJ1b7VDrkFmNKQ4QW0n3U1fmeLeR00jphvlGlO7YXSabkFGJ8Kff/ghNlbAg0wI8G6jOCAuTAS1pFKteimQVT1qp8R/++G/xlhpMk8OQfU3nOgceANemcYMmNl3KO14KUqLKm3e09dXEkPTiR/oJMzEn5ivAEH8GY9hKUxHZfHQAlZZNxOt1RA54q1yciNj24pov7ieAZMGZ3mknHaAeghSLP/uHb3ahZ2jsXJzbRBB6jN0P8bGZcRSuF9IC9u/SO+ciyvvtSIkgq5JS0RBzEDiR+I7Dt0HxFnTQG0N6LUrxkNFps/fn1+nxyykzQalnuYV+oicnIQKxuGwsJghb8eQtkYAHpZnPbDygNdmOrAZxnj6QpwHETLKBNddVSWcEjxUXY3H2HbYX9rzxzFixvwRh0rpQqAYEIXsQGthfZ1NPqg7aEtlrddrWRfw0gQ35SnIiZQoiEQROYQtxJ9Chio2FSDJ4bN9NxZYT6OsNuVC/Mx2GdwHOsP2KmGfcYzAdJut2mFkBInU1JjOCW5FDm4FhvYy0MGjxopFBBFYWujFlzjpMWOyJPsz9HgmmeoXEGmKFBNml7E0HA9DQl4nJ1OCYOq6d1Zs/G3vfPyYn0ZegmUN4eO8kDpa0EDs4Xpbvkm9/SSb5hM3XwkqINdWxxMEDWycwopZx8UHvHBos9CtjrjbQRygiFiEpkhPtNwwDt6G750nIoo4UWjF4bW0rNvSAcmM0EbX2KQVXQig7ZJGLauFuKhBApSj9+YwAfoI9wsBN9TyKnCKsPvxgayzZbBBeb0z5tZaWTtAD9ZLW2x9QaEnrpC1+b1LYzUWM89ea0djDMK5NHSHLiiQhW6gaI+MiJi2C4e+LrB5BF5GjN9CrIGd4954gbuHQU1GSQHDgp3Boi10N4JtCfQecwzS3YFWN7w915fsQYR73IJphIqN+lsnyUwJowgvOFTAIrKUBwSqgLtzkTK4UBbi5EnVD/akfAlfk+ede1TyfmiLg0uBARLEmZaOQ5NylG8k25D+WeYhrem+fYO3/vod8c4g6FS4wXVM2PLZ9SVyhRYXyDcKxet74c0onNmdEibqVxFqQBbiLHFC+OssVPnGmt2Sgha0bMbidsKkQ+YWzRUQs4vDj5dEAl58HSByastyIc52K73pTEdqhHVb3WD2EEiQR2lxniSAdVUxB0g2WjjVQK6oqsDIveBFhPMXRR04eh902UElDU7Re9EUH0ycB9/CQU8INlJM4CeYjg9D+fGn9AD5wVJSrB8yN5aMd22X2kHjLYkL4S/eXoiPdbwJkgrXD59Dccmj/Pfbqw8zLD3x3op4Iwh4EZEJoxIOXkd/V0eotOObu8JdabTEHKPhDH0IgSdVLwtukIHrAHybvfjtVjmVT9699M6jxlRw+TLeMu6SmmMSWOx0hW+XEIithV7DBQI0xUz/Y9kPnXy/8Inz4i7kOUd+Hx+xAPTiacrcJqH3BC5+6Fvvd4CNGcgi5D+Xvdc/RoMnWtzBou5Z2sFOw1u6yCTCdFwynwj2B5NMQEHxCpzRBNPeryfeOqtxEsE824/KTy+acPQx/hk+hV0Iqsr0+IY4ex8eteJj+GhkcQZI7BFUPuSTM7af2JAFQ6KGqqOYuUiBlTF198xLbSZamJpfpMjrBivJVm6hoKogA8hHCX5hCRpmxhqqV+04LLvWD0ExLZUsoTkAdh8Jd/9xD8LENGVOpnfKdO1ztoBeiq6WD1JXaJpizoznIPxGuBl1J+/xBg5qG+gtdXL3o2ZLUjMqAL4zDpqGy4z4lwvxFi1ktL5bK6G8L7rw52vws7hG1gG7ly7ocJY8G7DCiNwTw4XYCI4279cDaj7wv78rawLbYp3JQeIHMPEl8Lfly6HmiSRCTI6kDtc+EIBb/xaoa02mOfOI0BcJgya9wXdCgLiIgfSTB42RDSBrtLNwXqhqpjPGeUEfx+hbWUy6ksxjzQIy9R9ZU1Xzrgl5rWhhAq0EMgD80m1XBjrpscEJYZVLZMf9lcZejLOEm/stB2nInHYGZljVYRMtyIkuZQUOGI+6NtG5hU2wQGNhNInoofBOkKVegclu0Ovq1j0vDUoHmlYJUVB2OoDXA/NHUS4tUacMhme2leBbI24BRJZbYD5+7RVquMd55SA/CVlkXEikmQkxSpjRx/yEagpQOSSpYoUkUMVgTVDthop18J3HPsnINhYCvTmeM3llCfaASTwYprarOSpN+UHBFvEhiuhOgxQH4oCYrIKZJVtTq5lYQVMuiGMZVE7B+ga0EPJ4HWinkbWqwBEVfRa5AXfyfwGkrcNtnaEAAA==","6a6d034d4257083704b0e3c90859775bc4d46e0528503f9c7439ea84dd4f045b",41373], ["pages/reference/prisma-adapter-mysql/index.md","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","65cd32f9699847026bceecbca7560ef2ebc3f27ee7944f18581c50d65e23916c",5973], @@ -407,13 +407,13 @@ export const EMBEDDED_AGENT_DOCS_PAGES: readonly AgentDocsPage[] = [ ["pages/reference/sdk/index.md","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",33913], - ["pages/reference/service/index.md","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",50069], + ["pages/reference/service/index.md","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","d61d237f031e18e0a538ef545f6afcd6f1ad5460b34275aaceea45d1752d58dc",51047], ["pages/reference/streams/index.md","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","4e8c62ef0bd09e9844c6c58a02bb12f7754b811988348c159f679b4aa6e8fb30",10167], ["pages/reference/telemetry/convention/index.md","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","9ffc165f90b944d17b42dc8eee72f368bd5cf4842591fa4cf327c46f4b1479f2",3757], - ["pages/reference/telemetry/index.md","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","fe75549276a7c582db5ac9755d2ea89b9714fcaa30de1b74f8fac5681e512262",23315], + ["pages/reference/telemetry/index.md","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","9cb21ffe6ee00bfbf69e6959315dbe9c29539489c355280d1ef96786df94a4cd",23803], ["pages/reference/triggers/index.md","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",9432], diff --git a/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts b/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts index 416930b1b3..47cc01279c 100644 --- a/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts +++ b/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts @@ -221,7 +221,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["plugin","./contract-base","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",6010,13], - ["plugin","./health","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",11020,19], + ["plugin","./health","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",11579,19], ["plugin","./loader","pJDBSsRADIZfJcxpF8o+QBU9eFVZvJYe4kw6BttkyMzsCuK7Cy0Wuh57DD/fF/i6znkjLHQea2R51hjJXOM2Z990bqjiC6u4xrEUsgE9bQb47zmk+XjFiVrIxVjisYWbT6ttM8A3sAx6mChnjCvewEQFAxZ8bOGNvFq4/1uqfIpe5eHYwkU53MEVTXYJyExtlyHQe407DPAzN36a0wLCuMTJXhMFKAoIS2PIZBf2BMnUU84n17gXFp5wXKEPTAS5pjTyAt+gXqXQV8kn1/e/AAAA//8DAA==","Dt2mE832ZjsNzaQMKjAwzd2j3Zn6xvlv6nk346B8wA4=",536,2], @@ -229,7 +229,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["plugin","./scaffold","rFTbitswEP2VQU9dMPsBaekN9mEfWkoS+pLmQbHGiVhbMqNRN6H034vlmxwryQYKBg9zOXPmotlshCTWhcx5jUcWmVBYaINL3GvHdPpmlS9xVHvDurpkXbHfiUw8M1arXBaFLRWSyETv/lzVlpocs3hCo5B69cp6yiP1NOlgvUSmz/2lKyyh+mrVqVGz3w1wzu8ca/aMa/uCxolMMB45Qgn6n7L06MQ22wjCAglNiC68yVlbMxVjj1jWhpEKOZPTKLHHJcT75Al7ONuAPjOkVuHDuv0DHhmNcjA1f3xXhf8COr+HQUogpwY4T5Dyup5nLG2ymKN6tqJDi2G6rPAHCKWypjyBLLV0C3BM2uzfj3pXY64LjdTb4G8SsasrQtQhh1uANy/GvpoIFI+N6busMJERDZPGZNwBpUL6NJgCl6HvqXc2dHLK86HPm4hPPcgRJjWvGC3qTMr1wmbFfaM27ulaj6iLfjrWhM5paybjGXchcS4uG7vDETnEJ2RUJ47JaDw7K6Ph/MCITPwgdEi/EeRQEbSdbndbh7m8aj5AqRlJllBoLBXwqUb3+Mt8riXJqo9ZMfmcPaG6AtdEEbInA+sDgpNVbM0CtALp5pwezxi3c/rvzG/C3lNBGqyppP26Q6AwLyXJQBorzYwKtGELEvZokGSjSIBEvBW6nHQdIGxxK3AZ3hpIUMhIlTbasc5nRRdkq2ax+yTtTQFpVDgTJ1CS5aybyze17lTjKjAGF1YcCkvAB0wQv8bYp8d1zrzLkeZ718jfwvsM8I5R3VqY8dtu/wEAAP//AwA=","tAXuKFkJ1Im97IOgFSs1puQvxv3GziY3pWueAifyHW4=",2400,16], - ["plugin","./sdk","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",8120,52], + ["plugin","./sdk","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",8160,52], ["plugin","./service","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",10427,35], @@ -269,7 +269,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["plugin-auth","./scaffold","rZPRa9swEMb/lcNPLXjdu5dmhNHBYBslfQyBytbZEZF14nRaakb+92HHTpQ2LYP2zT7pfnefv8+rVaaxVtFKlmf3NjbG/aSmQT6+PlSqrsnqOyfceTKuvzkVkb+RE3xKa0sMPW6dr7I6ukoMuSzPjBPkWlWY5Zl0HhfWqPCsfnpOm2Fc8Ko6jCoguq2jnbsu4J6pNQFn57PnKQtSVfAXGJUmZzvQWMamgKsWQ1ANFhCEjWtyqA1aHb4WsMSKWM+m+jh2fg23c/hDRn85wYyr6aNYO8Xuo1jITPwuGOxHx+C1PMAtnLx5kYwB9D8+vehMzdoRb4NXFS6JZFKR6CTfRyX0cg6V2Su65kmT5m4ZXQElkUXlkhM7pKU4z87+4roHKemuQZTEcIxpgq0YlaD+bixePG9Jm9q8cUErUaUK+Ms0rAbFC61RX5IQzRIbE4S7H4Jt7/SIg/3wey2ibEBp5QUZwigG8OjqTZZno/CwUR4hRO+tQQ1C4IfvAtbUWHWVRdgQbUPfksQimMYpiYxgWm+xRSeooezG7k+0c6jh8ebzNP0R8MkTywCaQnAcW3YgG4TfKA8VGy9gXBBlLXK/kTqnTkjknjV6xCiR+9Oye+v+ev0P","DFQYDd4END48+W/Ya+NJCY23zqBWMzVj63DlT/PhoWs=",1302,5], - ["plugin-auth","./services","jVTLbtswEPyVBU8OoBroVXVtGG0POTQw3GMQIGtqLbOWliq5dGIE+feC1MMyrKC9UfuYnRku9fio1kEO28BsuPxF7mQ0qWwiuC4KR953uT7YNCpTBe0xVKIytalCabhLfrMs9BrDV9Xdxw8+GWe5Jhb1lD0qOTe0rgzGCR+d94G1GMsqU4aF3B4T2elzDwq3WuArbAkLy9V5EfjI9oWX3Sj4UPm/mi4ix5WXaCxGf2YNvQzojJtpec1hyrsM0JWfc+jm3eWwcbY2nha3NJdj9ZNo8Aau4wW+zTxgTascvDjD5ZdLunH2N2nZWitT6WI3cBpFtWVxqMVPJY+nqWhly5LcVIb4lF9s3JK2rli0RLKO0HI5qsem8SRiuPSrAQ/er0wZXdEb7En0YeboTyAvcVQ6ZHHwKofbLb27YpmKZ4abIEM8A8Mm+tVh3bP5L7xplqPS8cU5qq2knVzl8J3YzuMZ3tO+bwOLqQkOyEVF4EiCYyoA90IO5ECAQQ795YMXdOLnKlMPJC/WHQG7XUfvTRk7xaY2167adXtlvBCTiwA/bWDBXUWtr+BDK2aH+hgbPwKZxz9CopFK4lrDenM/zAg+dhysl0+NsydTUAGG9w69uKAluITQL7gPTVOZljZCk97AAIUSGUR/EmHDpsYK6oH4UBcxNKYXOji4O8PzLpiqmN09J85WH0niyjO1j7kmwQIFLyR256SptwmsA2zn9Zrm6unpLw==","TZNL7ra/gFnqj6I+Gn9DGS+U65NKOYGcshomLQ2k3tA=",1411,7], + ["plugin-auth","./services","jVRNb9swDP0rhE8J4AXY1WsTBN0OPawosmNRoIzEOFpsypOotEHR/z5I/oiDuNhuND8eH59IPz1l6yD7TWA2XP4idzSKsnzCudbakfddrHc2TZZnmnYYKsny7LEKpeEueGdZ6C26L7K7jx98NM5yTSzZc/6UyamhdWUwdvjM3gVWYixneWZYyO0wkZ22e1C4ngVuYUOoLVenm8AHtq+87FrBp5P/q+g85Djz7I3J6E+soB8DOuFmSt4KmNIuB3Tl1wK6fvMCHp2tjaeba5rL8fSTaPAOruMFvo08YE2rArw4w+W3c7hx9jcp2VgrU2FtfGN9rJzN4XY5sDpao5fjvO3AfeRVlsWhEj8VPBynvJUtS3JTEeJjcZZ7Q8o6fdMSzjviyzElbBpPIoZLvxrw4ONCvNFTvsOORO1njv4E8hJbJSOPjVcFXG/z/IJlSp4ZboIM/hwMm6hrh3XP5r/wplmOUscP7Ki2knZ3VcB3YruINnyku9gEFlMT7JF1ReBIgmPSgDshB7InwCD7fknACzrxiyzPHkherTsAdjeB3psyVopNZa5dycvyynghJhcBftrAgtuKWl3Bh3aYLapDLPwMZBH/HIlGSonrD+vH+6FH8LFib718aZw9Gk0aDO8cenFBSXAJoT8EH5qmMi1thCbdygCFEhlEfRJhw6bGCuqB+JAXMRSmSx4U3J7gZRtMpWfzl8TZqgNJXHmm9uhrEtQoeCaxPaWZepnAOsC2Xz/TInt+/gs=","FA9jClMeO9XMJCm4P8regien1tZe2nZGBgnWHSlqyG4=",1451,7], ["plugin-auth","./streams","lFdbbxo5FP4rR3kJSEC6rxDYpk1WrfaWJnSlVYg6xj6ANzP21PYkRVH+++rYnitDm75hz/F3bt/5bO7uTi4+Lz98uV3eXF38+eXqn6u/ll+W/15f3Z6MTi4Kt7tFa6VW7dWtYw7LLWeQZZfv2kvcSCVd46DfvnpE5Q53bvkOM3a4v9zn5IVVuz2GR7du0BZp21kZfXnkvU5T5BRlK95620fxAdMcjT0ZnXCDzGEnaV+LCjJ8qBGqrct3vzHutNlXO/5gw/H96O7kkRnJ1ill7fY5XqSS2c5vqRyaDePfszkC8wr0hknTUfP3plBlaj/ln/LjWlkHRxg3hUI9KP1UIkODcTCHG2RCq3R/Hq0WPWa+pjBvAFWRB7PYC3gGE+GAV82yVQQzyA2mmonBcArXRmfS4vmjlmIxA55qi7RPa3hpRdEh/w+jrrl+xDQWrG9epo3tsHPesTvmi+aqVaTgpTtnU2hw+7wvvx4H0Xr5d+HywtVeRrD8qFo7C5iHc60Tpd1R6DDXpfmiJ48jA3+sXsFm0eJKnzKcL5uxNwhkq2rFsVaCGVGmtZjVlpTQFKwzUm0b27mRGTP733FffvS06gunqUjdgKSyaNwgZ4ZldnpIp2GD3kUumMPX2r4eV2CKr8P1KZZaAofSOmBm+6ayHja753XXk6NJ0OUlbgC/OVTCQq/EtskSAdp6fb6sIPT6P+S9BOso+oFu9Tr3A861EeehxaNeki28TFKqgF4WFMvQAmbSORSw3oPboZ9UyNNiKxURBlkGudGi4Ggm8cYDG4UTlZOOOKYpHRQgldMeRRSGRLpEIDpCpgWmBxiWUrF9GIkXjWCWlEjBJaFUeiuVdUxxBIOuMKqTSmW2CRWlo5ft6MKQgajrudEmnG5lKtHW4cdwfCFztidBB7tjpnZfFhHNo+QITAmwxdpyI9doPFJgV8NbD2jtsm7aT/bsytdsvGYWRbczMfduwt7rNeMPbItj/URFtc4U3BWGpeUhWwQJ6cb/yFIpGBWSUIKotprT9t02P6hJxZO6/2UjwEq1TbFxzTabKJWVAoH1p0wAQewgQ7fTwgJzjvEdCnC6eXNTxMnbCDIOIPbM8zYhlPdeX4DBktEjgT/A5bvxmvEHFA32HWXUSr3FbyzLU4QkSZxdKZnl2jh47lEueIGN0RmcvlXoiEq5OwuNHxP6WYzudNZAKSz+IR/xU4FmX593jMaGP5wZZNyNxZrOrJRAnjJDJSU1inC3gcKfTVrdMGRbX+2Xa5j36ewzEOnKc20oeBl6lLMzeM/StG7XDQUEXGe5VsR4bYAX1ukMdlo/TFaqUvbCenc3+skOhvC8UhDjNoFz81bug8HXIcwX8HVCJRg8g3SYTWP8k0bDJw3hgZchhVkCB/nx8mthHv1MBHNskrF8MCBI74R+TDxHwvFAf7ra9ZOdNg+OggRWe34VNovaMixH7QBeZiv1slL+sdioxWylkiSpZyljeWv8Ej8k2HyueCJTpWoSN4Zqx5RIw5zHYT0Ukh/z2d9fzwfX4ncoHTkz5tpgLz2jWE0P79pnkKJ+DsUKlw+gxawkbzmN81r4tugGp3E1/uV0GG11ipNUbwfxy691c0Ot6eE7Dm82uVXMFQZBb7w8F3msUadk1H2aj+pqogw/xmLtpAW7z9Y6hSfpdpA0qpj4y6SwCAkt9ab7bEjgaYe+XP66oaRJrvM8lSgqd/DRwY5ZUBpMoZyki+Wbd6INSOpghsp5ZaY0uzVOKAIL0lnYokIjecly32mnacmkqih1Sq4yqVhKJa36z7Vyhkae8tSFA7r2KORW7XgqSQzczuhiuwv1ybQoUnwl46ri/BThHEGUB+ce8bDcsy4xY4Wn5ckDA53HP4XX9JpFR0/uaLu4e3Nf8VOQsEa0QTzUZaRoiVfNyPCfiIafcY55fC/0D//9/f8AAAD//wMA","MhXtTMBhMGakifVTIC2TNQj64Jo7BC3vSuuUu8hM/7c=",4526,19], @@ -319,7 +319,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["plugin-sagas","./scaffold","rFPBattAEP2VQacU3PSuOi6htFBoS7CPxpCRdiQPXu2I2VEcUfzvRbLkyI3jS3Nbzex7M2/f03qdOCqw8ZbMkgfflBx+SlmSnj5XORaFePctmLa1cOhujkXSrxKMnqe1JcWObjNbJ0+ojJmnZJZwMNIC8+5sbU33njH+U385d+BcQjQYtkvhyjYnHEwVwB9QQifBt+Aoa8oUbiqKEUtKIZpyKGdQMHkXv6SwpFzUzcd6E3ZB9mHxAe4W8CTsPr+QcSjkvbj2qOG9uEhV9L/I4DC48+Zrwx3c5EfLU3iVgp7oQaXiSPPzPCzOfHqFnJq1F93FGnNaitioYqJTamMJsZNzrMzf0LWYgJy2yyakkIl4wjDp+D4t6Xl2DhfXPUqZ7hoNrYnpOHJCmyuhkfvOni72K3Fc8JULDg0zjPSLS8Ve8b1z5C5JaHhJJUfT9odR1Tk90MGh/5VWWGIEdFgbKcRBDdDJ1ttklgzK4xZrgtjUtWdyYAJ1/zDguaC8zT3BVmQXO8gkF5HLgNYoAVe1p4qCkYOsHdAfZR/IwePtp3H6I9BzLWo90ZiC09isBdsS/CZb5cq1AYdo6D1ptxGes46UpB3XYJKSNdp1s/ba/c3mLwAAAP//AwA=","sdXCgsrU6CmsVU1zi9zWzKxkGVyYqEQ26THBOvg80qI=",1283,5], - ["plugin-sagas","./services","bZJBT8MwDIX/ipUTSAWJa5k2EBe4oKk7jh1M6mZhrRM5TtmE+O9oWzcG6tH+np6fnrxcmpoazK2awszb7DwvSHpv6Smw0lbNqliaJrNVH9gUxrOSNGjpADDt2MIJw2B1ZXVbwphbASjuroTMGw6ffF3CXELnE02qzOzZDfLp5aVRJ/gCIawDtztIR/KKHc1KSCqe3f0vjhI+yGoVgo7h+v2c52JrA6ug1TQGN/3Ytg3OkYwR4r6EapgmFdkg9eQYpBgCTacXeowxkapnl2ZnP/g+VL5QFE2ga4IFOkzwOH85NQA5eXawDklvooTe11SD50YwqWSrWej2jR8iCnZgdQvPf5Tx0PPZbF/B/gMKc+o85RhbTzVoAPwvRwXJrL6jW7Na/QA=","lPLrVRmPOAdE16S50Zi8h0yZdK3Mg+2dSWKbG0qOVXM=",601,2], + ["plugin-sagas","./services","bZLBTsMwEER/ZeVTK4VKXENJQVzggqr0WHowzsY1TdbWeh1aIf4dtU1LQDl633g82vF6rSqsdWpEZWrZJOtohdw5g0+eBPeiNtla1YmMOE8qU44EudYGT0DHAxm4YOitJkb2OYy5ZaDZ3uaQaEf+k6Y5LNm3LuK8TESObC8vhi+NOsEXMOrKU3OAeCavusVFDlHYkb37xYH9BxopvZcxXLkYfDzenEzhvrgm6ryriqHu/Zp7MDWehLWROAZ33di08dYijxGkLoeyP81LNJ6r+Tlw1gcvhpF0CBFFHNm4uPrB96malWiWCLJFWGmrIzwuXy6bghQdWdj6KDeBfecqrMBRzToKJyOJcfZGD0GzbsHIHp7/KMOpj6vZcQXHn5KpSzcxhdA4rEA86P9yLcCJxLU4U5vNDw==","z1RJaTL/YLEXUsxFKwgA8TCcy7WBeSVcP0YvZJb6pbE=",641,2], ["plugin-sagas","./streams","lFfbcho5EP2VrnkxVAHOvgJm4xjvrmu3sokhT8YVmpkGtJ6RJpLGDkX537damouGS+K8IanV6j4654x4eIhuVJpSbIWSU1oLKfhX1Aumb59J2r8ozUmbqBfFmtDSDDdoZlYTZtMPUS+aXf95/fXu42x+/fHm9utsfj3/Mrud8QJu8E4aizKmg+Es3lKG5WQrWTAOazLNfLPXcjXNiBeb2uup6Yc/MLZK7+qZgz1+eE+mSG0zycmDEh57D5GQlvQaXTfh73UhqyM1rUmTb9jucrpOBTJ0z6gFrtLDnWdCwulfDGl+tyqGU3c9nsMVFPJJqhc5gT1owkTJdAfGITKEGgqZoE48TuP5ZNRE8nFDMFYLuQmmcy0y1Lu/aVctwmvYOpzm2GFBQhrStpOjxswM4b5MP65CusMqegRFnqClt8a+PW9CKb0tr2ux4gKcEEsH9eZdHd4dwiH7a/bAWVEx4BBKCa6Oa2KtKmlsK3DWvlR/mWFAr4a+dVWtIkOWxPUdmgCvXFOqMOl0h/BJq0wYGj8rkUxGEKfKEM/z2IFVN3Mk+R92dWQG3FTtBeOTCSf1cUHkfEproO+WZGLgpO4nDSGbBG2jGc/rFGr1H8W2vae8iLYVDU8nrcr6t7B5YZs0PZjfST9Trp2tKzSz8U+D28060GOlk7HXbO+ka0ycs1yDEXKTUsACSJpMQhqRECAkhWbHYhcgzEpnGUS9yEseMrJblRhAazHeUgJWhcSC1Q6W78skfZ/EXBque8lZbpzKAGGOcmYxfoLph/4K4ydKasxhrbTjDFflNUPSCivIDBbyPX3HLE8JlsulNQspslxpC/tTAoZXWGuVwcV7SdbEWuT2Mk+LjZB9x8nLssCLUZCnMPSPeKbPBeldk8Ai1xI/XWrC2PaTFe9ZyITiFDWj6oju081IP4uYvui0tlqODcQwXcHVScfZwwpNvbOdDF67Ls/lJdxgmjZ3ds8lQayyXEmSFpSGuDBWZbBV6mmwkLXJFcafd69eTKcL+4WEsnTtGMjEC9rvdL514WoC3waMQmcPwlI2rFoYBPc+MKHFvXa50iq1u7yd466Bq/KkQYIWBxnmnQ4ndcfwjwFzpTB+vyZbaMkepl7MMNzZA8epes6N/GTRRPphr13B62ghXxfSmVqIx2ghl8tl1IvKZ80B+3ZgrNKUgJBgt3QgFOZ29d0Fr+k+Xwha4YLczDGxjd9XsrU+0PdNCauJz3KAB/rwpsR7p6fkGgr7B1qKetGt66zPnEtOS/9czX4xw7xV7NKdTKG1OdkzoxrJBxa0RZmk5A55xlTwk+CokJ+L31nk/sjpfyR/L65+rDSdVDIZ4z+UR5+PPYikeUKVNKweTZNRrXOfAa7qXIMN2c5FOer/dtEtY1VKg1RtOuXK757M3ZqP811Off/OExuJttAEau2IUeQlRgeQsUT4UmuqcId3JVhbYcDsspVK4UXYLSwDFJeA0skCljxU68Mv4RJetuTgYkBX3DSCKfI8FZTUx8GdhS0akAp0Ia3ICOi7O0RpEHyDGUmLjCe3eYjxkiswIKyBDUnSIq6swN20VTxEIWtKXfBRmZCYMqT1/cdKWs3eyH2qwgK/dLjkFnZxKtg17VarYrP1+GQqKVJ6I+NqcH6JcC5FtfEKTsM9OiRmifAQzgWovHzhfeIXMFl+ppexk4d3jzU/E/4Eldk65aZDRiYtj28Y+QnjJ9xQX72w7o3VRWwLjWnlGabwT1GW9TkxR73Iv3paBoKtuOqfDeSoDfGbg7Lc8lb/vGL7wTimnF3jrP08Pv4PAAD//wMA","xjpneh9VoxsN3dDf/eBHFnEUsVq+FyxH8GnHh4OzTWU=",3900,15], @@ -381,7 +381,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["plugin-streams","./scaffold","fFLBbtswDP0VQqcN8Lq7l2Yohg0YsA2FcwwClLZoT6gsChS11Bj674OdOHXaLDeK5Ht8j9R2ayy1mL2awtz73Lnwg7uO5PTcNNi27O3XoDJEdmHsnJMkXzgoPS1zFaWRbldszR8Uh7UnUxihloRCM8Y6RLrzDpMpjAtK0uKUf4lHcMMhKRzVlXBFzYkbXjkYB/0XCLfwrjmoL+GNofdwu4Z74d4lWp1bWy+lvkXCXxBCy8EPsGd5TBEbqpi1hKTiQvfppc5RHYdUQnXMrCpqWOzq0FlADo+B92G9XoCsDFUOJdTMnjAsKn4yXp6tAZ4vyj1YWWpNippTOY9c0DZCqGS/OU8X6z1b17orDRYVa0z003WCk+M7a8lespBdRZ1LKsN3pT59PtHB8/QrNiqEfQK0GJUE0tEP0OmwN6YwpjCLSyfXBdQsBK6PnnoKShbqAeK0qA+8D2Th4ebjzPYA9BRZNI1c811TjtG7A1B/E/wi3TTiooILSdF7ElAGPGedKUlGruPahTTLWK2Ha/273T8AAAD//wMA","uy5v+Yuq6UV/gjo/VPb4lUbxE/KR/c1BMn6ZJkyQJ0Y=",928,5], - ["plugin-streams","./service","rVjbbhs5Ev2VQl4kL2TZng2wgJTE40myM8EmjmEJ2AcriCiypOaaTfaQbMmK4X9fFMm+WS1vBti3bl6qinU5dci7u1dXpc9Qe8mZN/bGWP9qFMb018JLo131e4t/lujq2Vt0par+jJU/sL35xwfk0kmjq/+usB+NsPfGumbyxkrNZcFU+DYcRWnxo7XGvjcCX41e3ZZaS72Zod1KfjhwJYRFR5JoABvB1XxRtH5Kn90YJfm+Gfuot9IanaP2zeDvJbMCRd/6m3KlJO+bmavWuZxn1s+8RZa7xvbuQLX62+juldQe7ZqFVce+/b7AKyWZ+8nx/9fevyrzZ77XpeZ0+s5wxxFwkKfwCKwZw6GNOTWBdrqeTKDU99rsNDy1hcdFyeXwCBaZMFrt2yKNnRxqnTZLC2s8cn9Zq2jNMaXM7kobvc9N6S5ftCKZ2rYiR58ZMQHnrdSbtk7ms2Y4QybQDjXLsRpsDlxNu+HJBP6In1PgxtxLPLIlWEdxhFaNw9tq+sD0pu5TMMJANxJVrR/TUkPFC3p+HAlU1D95ZkvLXQL1/rf9B1yzUlGgVsYoZH1RqMxsqygqNJpADUzTvxyketiy3Q3z2WU11fihBYJHvFDrb9vnytV/kPseVY6bAl1fYlqj+iccz5By4nCGKyZzN4HbNPDmFrmx4k3UOqp2vHvXHOgQu4+cqwvflEVFMYEGrafAhLAT6IX5KThvCkrvG2ty6fDN1kgRzTimIm2FR8iM8+0ymEJhrJ+ALvMV2il4y7SLQ/3F224x8Bh2XzbbK/F1uKfg5EYzdTmBq5Wxfhb+piAsk3ouczSl/+LaEpgWCuMy1yTvFHz4PegzPeZFJ8IjrNHzrCnMlOwjQL1tRLWaXxtG0q6h1EXZOGMEUks6cJL1ScufktckyUEbPpIjh9LaRWAxNz6E9XICH1CbMX33++KgkT8HFJ26R/JoG9AJIyh0LThql3zgARQ83FLsWuYxZ3Q10W/WcxLRwaAwNwFvSzwQ21P54RQ9dlT2v2BGK5NaBnCkCjjQc4/7Do4xt9ccqj4OPYRnaKLwCfTynlYVdyv2XdfWvr3dfAjp+Bm3SKXWg4DoCqMdHl9BvmpAqA5LGxKNpRJs4XYbSQkXUhXUFj4FOtOiE+SllSm1YHYPPmMefGm1A1adAKT2BljThcDYMEuYL40eJzLdkpdLIRTumEVIzoa1sbDcSZ+FvB6eLIFpAUuBa6mxikxs3vB0siShn6jOA/qgADJBd1kRrUnUwKyfzZIVzHvMC1/ZR42577gCuRToYJehz9B2TpqzQK84ojgUIxJhmMYl1GYAqc+40A9ASFcwzzNga48WXMk5Orcu1TNDDyX/L//9+Cn/9VsLAT5p/v3X21kt35UFNQ4UsNpHRZRUw5PleKEXemms3Ei9BMY5Ft6Rt/GBcQ9xYhTcT1xTSeeBWcv2o5AnGsrChVqhhDdqi3a80P/OUIPJpfcoRrC8/jifvb/9dDP/TjZ9/3r76fdP17NlMEpJpGTkJs/ZqcOCWUZW1sqmC01KtEMyBlaK6XvYMlUisS7azK1x7jQaGg7g3Bi+hgKjUxRKcunrM05g8LfBkvziYubvpBKcWZG20lEFSA+caW08oGYrhcAtCgopU2680L/iA8sLhbBcLr1baJmTcyG0m8cOzXqCtTU5DH7V6B23svBnVLeS42C60Nxo50OVd4oc3sJj8vwE7gaZ94WbnJ2xohgnxYNv8DRd6OVySYUULPN7QOfZSkmXoQgJ1a0ZFFXJU3YExgScKJMM+9d7wtjg69hAh6/PX5+QzysfBlDz0qKA4euL85OmLsYL/S8sCEoEFqhJHtWsLbWXOUI4JtPegTPBSacJ3bQrc7SOfA0WT/EhujELW7xlPJiacDoAHrG3SFjIltLqlNEBDI+UTSyXa/Q7Y+8D0SNmxhzxpAQ9ZGpHB6UeagwgVEWFXBoaTnDU4dJnebEvMEa8zo9HSiPmK8NGMWHS360pCUZeTpiFFsgVAUdMHRs2Tboywro0n471FtiOUVK39Q/j7hE8QiSog9KhdQN4OllogDGhxB/IlM+GcSA6+ZG+IbHYv5+fn4/iQEN0Bxe//GN8Pj4fXwxGcHYGyphixfh9CPs0AAN5fSV1KHSo266LkrpUdQIX599batp0NRKWMPN0Es4dz5nOPY7Eva6UL1LLnHDflJpKBesgMkKi1Fg6ibUqpRIpha7q5XlJdZsZ4xBQhr6imZdbhA1xP1f1ULrAoEjsikDn1ERwnhl+j1T6Wsc2S9c8JphnFSoG9VQKVX5FmcF0Cim5OxRyqs7atsI4T72qdLSMJCTTnvdP8n6nhzjPNuhI6AdUcoUExZXtz6VTckSAETK4cgTa6AjPkTWSnPnnGeTMo5VMRUjqK5vUMKqDj7rHDlnn4I/5/GYWjCb2TZabnNFhlNqDxo3xknnKIFp49ks0kCuJhDuBCaQeSOBuiJ1efb65hmFYfjG+IIbPJDGjLZMqJAdzwBZ6zZSi7D0ZwzxDWEtUwkEuA4Auw1UgmLgcOFgSjV2eLe9xv4Sbj19iN3YvQEOsU0+pfMiP30IotsiNY2YHfcQB5/jg/ykVDgc0PS4wH5yEQgiU+ejie9zXa5sWMiNYc+1kiU3dEcY/7FNPdLBm3Bu7PzU7qo+69Yfzx0gSKwEZ4BUj38C1sQhM7+nWVl2tRsShLNsgZXUd6qp7ByGkMwgGE94f3IiogACKOFoI9CYwETeikmVSp07m96n/JwYSXtAMNyotp7pEOiM3BdWZiO82FKV544AKOlO3CZgUPbS2RvuW0WSnN0WcrH3iM2vKTRbc5rLSC7PTC50Zcz+G36JPQlYm+fggnXfkFmZ9WcCaSUV1lliuq8xqfE4clHQXFlOJ+AwXOvqAM0U8NycaHEgr4BY1yDVwutyXRSL4bgzXBkptUQWGYCxslFkxFehcaTmxM2o3yjgUlMfE0PKaV9KtPDCCFsbUGEHWxYVMhXiNul6j0gNlNqDojhSqJGIvHI3DNPqzOnvKhfjiAaWrd4VwgcOckTOCaArIzkGAmkAxwt6B69osiRZumZLi+R5taiYUmh/5ikAYbr7ezs9m89uPV19m3+kn8VPZwpI2AqTngbrEKkQMmAxY0AOZZapum0FbqNQW16y5hCcQfF/T085L8gts4oxOTZSiltdzl+7bX6hyI/VpMr5LTiKYdW5x8PZnDI2kokWyJ/AIynB6E31sHiAHSdskaR+M6ifIu2+j6tHxrlpGLBmeCOiIAvQzItfzghCMibfzeOXS1Udt8Kh6lid1Z7UiiIhFy4/QoUibzrtmGYVjZTbDirYQRx3TSlrwIqO5jume6qCI7zrUaI1uMLxKMBloOMfxq2/f/gs=","jIrmAI1ACieRfwR5Ru39RHIwXPoD+Px9tdzlvHlrQYQ=",7059,22], + ["plugin-streams","./service","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",7166,22], ["plugin-streams","./services","io6O1YGhWAAAAAD//wMA","5R1flNqzmPfzvYhJRc14a7asP8Z5vLR/wq8dioc9fx4=",13,0], @@ -465,7 +465,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["plugin-workers","./scaffold","fFLBbtswDP0VQqcN8Lq7l2Yohg0YsA2Fe9ghCFDaoj0hsihQ1FJj6L8PduLUWbPcKJLv8T1Sm42x1GL2agpz73PnwjfuOpLT86HBtmVvPweVIbILY+ecJPnEQelpmasojXTbYmN+ozisPZnCCLUkFJox1iHSnXeYTGFcUJIWp/xLPIIbDknhqK6EK2pO3PCPg3HQf4FwC2+ag/oSXhl6C7druBfuXaLVubX1UuprJPwBIbQc/AB7ll2K2FDFrCUkFRe6Dy91juo4pBKqY2ZVUcNiV4fOAnLYBd6H9XoBsjJUOZRQM3vCsKj4yXh5tgZ4vij3YGWpNSlqTuU8ckHbCKGS/eI8Xaz3bF3rrjRYVKwx0XfXCU6O76wle8lCdhV1LqkMX5X69PFEB8/Tr/jJsiNJgBajkkA6+gE6HfbGFMYUZnHp5LqAmoXA9dFTT0HJQj1AnBb1jveBLDzevJ/ZHoGeIoumkWu+a8oxencA6i+CH6QPjbio4EJS9J4ElAHPWWdKkpHruHYhzTJW6+Fa/3b7FwAA//8DAA==","lVuTUiHONNOAx6tvx05C897CK0YDKdHVFwwrW16lMb8=",928,5], - ["plugin-workers","./service","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",7933,23], + ["plugin-workers","./service","tVnbbhs5Ev2VQl4kL2TZmR1gASmX8TrZSZCZ2LCNnYcoSFPNkpojNtlLsmUrhv99Ubz0RWp5sw/zpua1WHXq1CH15cuLi9oVqJzImdPmWhv3YuLb1FXlhFY2fd7gf2q0Te8N2lqmL23Ed+xO/v4Oc2GFVum7v9j3drFLbWzbeS3rtVC3aLYix0utHD7QoGsjVC4qJv1vnSOvDb43RptLzfHF5MVNrZRQ6zjxoOGCc4OWNqAGbPdL/VXV+ahdca2lyHdt23u1FUarEpVrG3+tmeHIh8Zf10sp8qGeO9k5rnXMuD+02aCxre39hjT66+TLC6EcmhXzo479drsKL6Rg9gfb/4oxf8XcVa1y8kSvuecUOIAyPAJr23BsAuxm0EX0yQxqtVH6XsFTd/EwKLofHsEg41rJXXdJbWaHu87boZXRDnP3ttmi08ek1PcXSqtdqWv79lkroqldK0p0heYzsM4Ite7uyVzRNhfIOJqxYiWmxvbAqduOT2bwIfycQ671RuCRKd46iiN0aABep+4D01tqiMHwDf1IJDo4tkvDJs/s8/1IoML+sz1bOu7iqHb/3L3DFaslBWqptUQ2FIVkZneLKjHTDBqSmv/fQWqaDbu/Zq54m7paP3R48ogXhriza6oNPZ9Zic36faj+ibm70doNdXNhK21p5vgEXr+Ba6NLYfHVVgv+pjtuOYT1XCtnWO7sUOdmO9Qq9XpNgTvsQbWdwU38enWDuTb8VTB4Eg1/0zWJVZVF54RaH8+yJng9j9VLcsmAN2yuKxw8jNFyuMPmBVJCDThHMlHa40eKM968adFwWASPgKJfBykFq2oGbdmbA+PczGCwXs7BOl0RN/Sivee6wanwCIW2rsshc6i0cTNQdblEMwdnmLKhaTgm3VoNj37223Z6Wr4DVivWism3M7hYauNu/dccuGFC3YkSde1+t50Vcsrzuhrq0uoydHaZO6bAO+bYklm8UmGHljPmgA/CDbUXTHGJod12O5z/PNAGA54I8YJHWKHLi5ZAIylNKC3apTqCpUv3cdZYqKpu/T4BoQT5Nq71UYkfWq/F44F0OgLHw9W6+Waw1M4j6O0M3qHSU/o97IsD8bVP/CpW+ejRLh8QlxNKOmWjS4ReuxEYcEtY6JjHrFapY9isfeHXqxW+bwbO1Hiw7ADJ+FMM2JHsf8aMDpI6BuRIyXawzwZ3vXrD7E7lkPQWDIjUMfE5PrjZYNGZgA57z2BQynb4pM8db3pHGZzbh4tH62+4RUq2AS5GW2ll8fgIcmVLh03UepXLUIZ2ym+X04mhYpI0Fj55VdpRheTEpa4VZ2YHrmAOXG2UBZZOAEI5DawVE6CN76XqI7SaxmtTZ71ScC7xnhlMzoaVNpDdC1d42I9PMmCKQ8ZxJRSmwAUNBk8nGS36kWjAkxNyIBNUX9zSmKjw9Gqvl6xgzmFZuWQf6auh43LMBUcL9wW6Ak3vpCXz0iNH5IfL8Kj75mEIFTxAqnjWVybPyMzlBbCVQwO2znO0dlXLPUMPV/5f/vv+Q/4bthY8u1L/5dXNbbO+rSsqYchhuQsbEajGJ9l0oRYq00ashcqA5TlWzpK38YHlDkLHxLufrgxSWAfMGLabeJwoqCvrDLKSAK/lFs10of4oUIEuhXPIJ5B9fn93e3nz8fruG9n07erm468fP99m3igpkMCY67JkpxYrZhhZ2Ww2XyjaRFkkY2ApmdrAlskaSTzT5Nxoa0+Dof4A1k7hyicYnaKSIheuOeMMRn8bZeQXG5B/LyTPmeFxKh2Vg3CQM6W0A1RsKRFyg5xCyqSdLtQv+MDKSiJkWebsQomSnAu+Gj321PITrIwuYfSLQmdzIyp3FqXwaL5QuVbW+SzvJTm8hsfo+Rl8GRXOVXZ2dsaqaho3Hn2Fp/lCZVnmXzGC3I7uDMkElSfHJLyBOTC1cqJEn3v+MG4HaB1bSmEL5B6D/TRDnliCJnm5BznpPeHnr3bE2j48oSSPfz7/+YTClNzuedAJgxzGP788P2lTabpQn7Ai9uFYoaL1KM2jjaTZrWPKWbDa+/U0SXlbl2gshQcMnuJD8HyBjcz3vBGovTl9kEBkS21UTALPn0cyLWTYZ3T32my8SiVZySyJvORgs7cHoRUVet5KgSSX+hLmHXU4dA9KuwoDSBpIPRLymEuGTQLG4teNrol5nsfYQnHMJXFNQJvxk2b9Nfy42B+P9RrYPaM86O4/DrMn8AhBXY9qi8aO4OlkoQCmRCwfkElXjENDcPIj/YYowf9+fn4+CQ2tSh+9/Okf0/Pp+fTlaAJnZyC1rpYs3/iwzz2XkNeXQnlugKZS27BSX2fP4OX5t842XQEcJJDveTrx5w7njOeehltHk1y/CyVKKhW6VpQq2GYUZVusRT1gLWsheYTQRTO8rCnVC60tAgpfihRzYouwJjVpU9ml2xfyqNeIp0514PNbnW+Q2EKpUJnpgs84c6zN/CUVvRZfYU1vOoWU3O0TOWZnY1ulraPyVlsaRitE0/ZLLnm/V3asY2u0tOg7lGKJxN7J9v3VCRyBYLjwrpyA0iowetChtM7db7dQModGMBkoaShtYo1JB5/0j+1RZ+HD3d31rTea9DxZrktGh5FyBwrX2gnmCEE08OynYGAuBRLvePEQyybVA0169+K3688w9sNfTl/SnYEJElNbJqQHB7PAFmrFpCT0nkzhrkBYCZTcQik8gWb+cuFNzEYWMhLG2Vm2wV0G1+9/DwXcPkMNIU8dQflQcb8Gn2xBbQdk+/1INt7hg/uXkDgeUfe0wnJ04hPBi/Cjgze4a8a2VeeWaI3c1IhluLj+2MTKu4s6CXSnldFbQbCO2t1H8MpwIiKvaZi1aOgEE88SQUzUoSHXZaWt8HiTmvFJUyUotH/qJRhcC+uMh+RkoRqcQBb1z5Q2ySbtN9XcyPypKUQEiCkrMoeDK4yu1wVllcEVGlQ5zhckCwrKE2Eh1xWlnTagtCmZFN+RTyGLp8xoCPkSfPEiMHuY4prlu2bUFNV2en11c5eBRVaS3uE0kdTHSpt7f9Uk8qO50b0BV8kNUXmFYCRSkXrJJGRrdJ+2VOWoRixU1ikSm20GQlnBEVxBh2FSTny9jWGLfqXQChKFnFVUb5a40gaJVOd+6IrlTpvdQoU7YS61RZpBECY9V6aow4ceFvYUShxE7x9yB1nrlejEdrkkakkBN+xSydrGHiaBhOakJQRyKWWtf9ij2Em6lfkkC9Sd/Nmt6HPIQjHIQnkJ/u3WbgLIvQVPRX2opQAy0qqCd/k0Wby/gIpVoQ/IKaVDRvACBllwSJC/osM7XbaIjxNtJhJvA1b0AmiYbEqrT7RJyM8UaOTw6d8p0D7TO/K2KzA22zODXNjRnKp1ixPyUMKJayE6shCBCBYl5p1VH0PPkIrZbEnA7CmhwZfmgckBXWeWbwYWuXVUBy4bUd/7G+UZQXVGAeytN/BAcdyaU5KTaOxz+kxXqNIr36WvRfuv3ulJtiPaUoL1RduQq8ajaMNoEirFGt3wdoeGjEO18PFKo2JYqTSQaArm9O7x8PpHnB40YueaNQvmAUid0z8cj+2L+Ci6b9YeJb2Jf0nHmxFljL5O0pv4lzSJrk5B/SWbjylfe/ztKfouvOCEa7lKP7o4Cjv5RKbuI3o36OLz1iKyR0ucSr0eJ11KlxBPBjTgWcl6yaREc6rvSZBW4SWQao9WCNE7DTkIf83Kcfri69f/Ag==","pck4B3y/mrUjGRd/xSDojqdenHvex36Xn1AWcDHqDQ8=",8080,23], ["plugin-workers","./services","lVHBjtNADP0Vay6AlK3EtUKIFUICcalYBIemB3fiJlYTz2B70vL3KG13S7bLAWkOM89+z35v1uvQ0A5L76EKq760LA+kI0f6mMTpOMHfighLe8FvgPumUTILVXgEcr4+PsnImmQg8bCp1mFXJDonCVVQ2pGSnCT/7z4Jof2WCI9ycHHxOvpxCS8ZqQC1fbuEIntJB3mzhJWmgY3eze28/3vSi0qzhptw/lW6xnTtmAV2Az+P7sFR3cA7gp9J96QG96svYOduKMbSQpfM77KmkRtqgGWnaK4lelFa1FLL944gn1w9MZUi8Uh2JqeDUANaxHkgiGfPcGDvUnHgISf1aZJ3VMvEAMy554jTP7wyaNBxi0aQMe6xpcXTtpqKk4F5UprorDAUx21PYI5OtbDA1x93W4z7aQVq2VyZrAJLJ98p469C1xGxZxIHNpDkoGSpH6mBJOfteh5JyAwyereo5UNGxQGiH+HzLKdngVxMhyrMzmbzBw==","NxhjvDt0uiRGSy3lTiub+AZRUCOdL4LYTJWYoeok9xY=",815,6], @@ -575,7 +575,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["sdk","./telemetry","io5W8s1MSclJLU8sSvVIzEvJSS1S0kES80utKFHSUcovSc1BCCrF6kQrFaWmpRal5iWnKungYKOoUsBmDzZZqI0IKSx2K+mAUWwsAAAA//8DAA==","VZUlq+u4Nqn+E0SewaN3c4YwvdwLnKjzzNlRTLKBuBo=",192,3], - ["service",".","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",36447,111], + ["service",".","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",36554,111], ["service","./auth","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",11451,55], diff --git a/packages/mcp/src/publish-assets.generated.ts b/packages/mcp/src/publish-assets.generated.ts index b9067f6d4a..6126123d20 100644 --- a/packages/mcp/src/publish-assets.generated.ts +++ b/packages/mcp/src/publish-assets.generated.ts @@ -307,7 +307,7 @@ export const MCP_EMBEDDED_DOCS_PROVENANCE: 'pages/web-layer/vite/index.md', 'pages/why/index.md', ], - sourceBytes: 3255674, + sourceBytes: 3259270, documentCount: 286, - sha256: 'fac2e9ae8649238e745dba7653ae153741b6a78ccc5a8ac767e50ff3e8f40467', + sha256: '298ec92d46795f20a9d10cd7362a3f5c2822d6bccfc3d77e8e0ddfa5acfa46c3', }; From ae7c1595fffeafd15b3ef350419aab11d3dc2d44 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 19:13:34 +0100 Subject: [PATCH 11/19] test(runtime): preserve embedding and watch lifecycle assertions --- .../fix-runtime-child-drain--issues-2630-2631/drift.md | 3 +++ .../leak-report.md | 4 +++- .../fix-runtime-child-drain--issues-2630-2631/plan.md | 2 +- .../fix-runtime-child-drain--issues-2630-2631/worklog.md | 9 +++++++++ .../plugin/tests/health/generated-crash-loop_test.ts | 2 +- packages/service/tests/define-service_test.ts | 9 ++++++++- 6 files changed, 25 insertions(+), 4 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index b81eaf9ee1..a78cb100c8 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -14,3 +14,6 @@ - S3b source-derived child-health documentation requires updating its existing generator symbol list; it now includes the public process options/function. Subprocess self-imports are corrected to local module URLs to satisfy release:preflight. This adds three scoped files to the prose slice and remains below 30. - Baseline-only doc/JSR findings were measured rather than assumed: plugin doc-lint 18 and telemetry 7 match base distribution exactly; plugin module-tag audit fails on three untouched entrypoints. Service doc-lint is clean. No unrelated publishability repair is folded into runtime lifecycle work. + +- The required runtime smoke was repeated only after diagnosing a concrete environment failure: container loopback endpoints were in the Docker daemon's namespace. A temporary, owned-only port bridge supplies local reachability without changing generated output or weakening gates. Native PostgreSQL readiness passed through it. +- S4 includes two pre-existing test expectation updates: manual-stop host DB ownership and Deno-watch's explicit-exit diagnostic. Both retain their behavioral assertions; the slice remains below 30 files. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md index 34c8021b5e..abbf5c4fb0 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md @@ -1,3 +1,5 @@ # Resource inspection -Teardown preview was read-only and planned no mutations. Foreign and unknown-owner resources were reviewed and left alone; operator identities and unrelated paths are omitted under the public-repository restriction. The lane Redis test container is removed only after verifying its exact creation identity, run label and repository bind mount. No test subprocess or container remains after S2 validation. +The first full scaffold.runtime attempt failed at PostgreSQL readiness in the documented scaffold control; cleanup.aspire-stop passed. A targeted restart proved the database was accepting connections while local health checks could not reach Docker's separate network namespace. A temporary bridge scoped to this run's container identities made the native PostgreSQL health check pass. The exact diagnostic AppHost was stopped. + +A corrected one-pass smoke is running with the same temporary environment bridge. The bridge is not product source and removes only proxies it creates, after checking their unique ownership label. Foreign and unknown-owner resources are left untouched. Final owned-resource cleanup follows the corrected smoke. Operator paths, hostnames, ports and process identities are excluded from public evidence. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md index a0f68ca708..88413d9e18 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan.md @@ -20,7 +20,7 @@ Each slice is below 30 files, including its run-artifact updates. Product tests | S2 (18 files including resource evidence) | Explicit process exit, bounded work/cleanup deadlines, signal-only deduplicated resource disposal; focused S1 tests and structured check/lint/fmt | `packages/plugin/src/presentation/run-child-health-process.ts`; `packages/service/src/types.ts`; `packages/service/src/builder/service-builder-impl.ts`; `packages/service/src/builder/service-listener.ts`; `packages/service/src/builder/service-shutdown.ts`; new `packages/service/src/builder/service-resources.ts` (database identity enumeration/disposal, consumed by builder cleanup); `packages/service/src/presets/define-service.ts`; `packages/telemetry/src/adapters/otel/otel-sdk.ts`; `packages/plugin/src/presentation/run-child-health-process_test.ts`; `packages/service/tests/service-builder_test.ts`; `packages/service/tests/listener-hostname_test.ts`; `packages/service/tests/shutdown-coordinator_test.ts`; `packages/service/tests/service-resources_test.ts`; run `plan.md`, `worklog.md`, `context-pack.md`, `drift.md` | | S3a (22 files maximum) | Generated role cleanup closes only acquired handles, including saga bootstrap DB; generator/role tests and scoped gates | workers/sagas/triggers `plugins//src/adapter/resources/glue/runtime.stub.ts` (3); `packages/plugin/src/sdk/runtime/plugin-service-context.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory.ts`; `packages/plugin/src/sdk/runtime/plugin-service-context-factory_test.ts`; `packages/cli/src/kernel/assets/plugins/service-context.ts.template`; workers/sagas `plugins//services/src/main.ts` (2), `plugins/auth/services/src/auth-service-runtime.ts`; sagas runner acquisitions are covered by the generated host resolver; no runner edit is needed; `packages/cli/src/kernel/templates/plugins/generate-plugin-service_test.ts`; workers/sagas/triggers `plugins//src/adapter/resources/resources.test.ts` (3); `packages/service/src/types.ts`, `packages/service/src/builder/service-builder-impl.ts`, `packages/service/tests/service-resources_test.ts` (explicit host database ownership override); run `worklog.md`, `context-pack.md`, `drift.md` | | S3b (15 files) | Public shutdown/hostname/budget/OTel semantics and generated assets agree; docs:accuracy, corpus freshness, release:preflight and JSR audits | `packages/plugin/README.md`; `packages/service/README.md`; `packages/telemetry/README.md`; `docs/site/orchestration-runtime/child-health.md`; `docs/site/observability/telemetry.md`; `docs/site/reference/plugin/index.md`; `docs/site/reference/service/index.md`; `docs/site/reference/telemetry/index.md`; generated CLI `embedded.generated.ts` and plugin `embedded.generated.ts` under their `src/kernel/assets/`; `packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts`; generated MCP export-surface corpus; run `worklog.md`, `context-pack.md`, `drift.md` | -| S4 (4 run files) | One-pass `deno task e2e:cli run scaffold.runtime --cleanup --format pretty`, health checks including hostname overrides, all scoped/static gates, independent IMPL-EVAL | run `worklog.md`, `context-pack.md`, `drift.md`, `evaluate.md`; no production files | +| S4 (7 files including test follow-up) | One-pass `deno task e2e:cli run scaffold.runtime --cleanup --format pretty`, health checks including hostname overrides, all scoped/static gates, independent IMPL-EVAL | run `worklog.md`, `context-pack.md`, `drift.md`, `leak-report.md`, `evaluate.md`; `packages/service/tests/define-service_test.ts`, `packages/plugin/tests/health/generated-crash-loop_test.ts` expectation updates; no production implementation files | New files trace to the database identity-disposal seam and subprocess/control tests; no speculative port or folder. Any needed source repair discovered during S4 belongs to a recorded S2/S3 follow-up, not an evidence-only sign-off. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 5e013da495..63b45cbd76 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -67,3 +67,12 @@ Canonical agent prose/site generation passes. Refreshed MCP export-surface corpu Final quality:gate, docs:accuracy and release:preflight pass. Service full export-map doc lint passes with zero diagnostics. Plugin doc lint has 18 pre-existing private-type diagnostics; telemetry has 7 (6 private-type, 1 missing JSDoc). Measured the identical command and per-entrypoint/file distributions at base b0eb07957 in a detached baseline checkout. Changed plugin health/SDK entrypoints are clean. JSR audits: service, telemetry and CLI exit 0 (existing warnings); plugin dry-run succeeds but audit exits 1 for three pre-existing missing @module tags in untouched abstracts/config/testing entrypoints. Git diff of those three entrypoints against the base is empty. These unrelated baseline findings are not hidden or fixed in this runtime slice. Next: one full scaffold.runtime smoke with cleanup, resource ownership audit, final independent IMPL-EVAL and head checks. #2632 is ready for review separately at head deb6b21cfcfc6b9d94e7291eb21def7072b4539b with required checks PASS/SKIPPED and no unanswered threads. + + +## S4 runtime validation follow-up + +First full scaffold.runtime attempt exited 1 before changed runtime roles: preflight.deno, preflight.aspire, scaffold.init and cleanup.aspire-stop passed; behavior.documented-scaffold timed out waiting for PostgreSQL readiness. Native diagnostics showed PostgreSQL accepting connections but local health checks unable to reach the remote Docker namespace. An owned-only temporary bridge made the native readiness check pass without product changes; the diagnostic AppHost was stopped. The corrected one-pass smoke is running. + +The broader service/plugin tests exposed two legacy expectations: manual defineService.stop must preserve the host database under the approved contract; Deno watch reports explicit exit 1 as "Process finished with exit code 1" rather than "Process failed". Updated those assertions while retaining database usability/explicit owner disposal and watch failure/restart-history assertions. Targeted format/lint pass. No production behavior changed in this follow-up. + +Broader package regression suite after the expectation updates: structured service/plugin tests exit 0, 820 passed / 0 failed / 4 ignored (824 results). Both updated test files pass structured format and lint with zero findings. diff --git a/packages/plugin/tests/health/generated-crash-loop_test.ts b/packages/plugin/tests/health/generated-crash-loop_test.ts index 0aca0d5f65..fd4efb21c5 100644 --- a/packages/plugin/tests/health/generated-crash-loop_test.ts +++ b/packages/plugin/tests/health/generated-crash-loop_test.ts @@ -243,7 +243,7 @@ for (const plugin of Object.keys(PLUGINS) as (keyof typeof PLUGINS)[]) { ); assertEquals(history.processId, processId); if (reload === CHILD_CRASH_LOOP_THRESHOLD.restarts) break; - if (failing) await child.diagnostic(/Process failed/); + if (failing) await child.diagnostic(/Process (?:failed|finished with exit code 1)/); child.resetDiagnostics(); await registry(root, failing, reload + 1); } diff --git a/packages/service/tests/define-service_test.ts b/packages/service/tests/define-service_test.ts index 6a3dc1bfba..827533b04e 100644 --- a/packages/service/tests/define-service_test.ts +++ b/packages/service/tests/define-service_test.ts @@ -41,17 +41,20 @@ function restoreEnv(name: string, value: string | undefined): void { Deno.env.set(name, value); } -Deno.test('defineService disconnects a capable database client on stop', async () => { +Deno.test('defineService leaves database cleanup to the host on manual stop', async () => { await withReachableDatabaseEndpoint(async () => { let queryCount = 0; let disconnectCount = 0; + let disconnected = false; const db = { $queryRaw(_query: TemplateStringsArray): Promise { + if (disconnected) throw new Error('Host database was closed prematurely'); queryCount += 1; return Promise.resolve(1); }, $disconnect(): Promise { disconnectCount += 1; + disconnected = true; return Promise.resolve(); }, }; @@ -66,6 +69,10 @@ Deno.test('defineService disconnects a capable database client on stop', async ( await running.stop(); assertEquals(queryCount, 1); + assertEquals(disconnectCount, 0); + assertEquals(await db.$queryRaw`SELECT 1`, 1); + assertEquals(queryCount, 2); + await db.$disconnect(); assertEquals(disconnectCount, 1); }); }); From 26e945e9f3b710a1f18e2452bb4d524ed217e09b Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 19:16:42 +0100 Subject: [PATCH 12/19] docs(harness): record runtime evidence and clean owned resources --- .../context-pack.md | 51 +++---------------- .../leak-report.md | 4 +- .../worklog.md | 7 +++ 3 files changed, 16 insertions(+), 46 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index acf7924715..a2e5af3c39 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -1,52 +1,15 @@ # Context pack -Issues #2630/#2631, main b0eb07957, branch fix/runtime-child-drain. Research/plan drafted, real Redis subprocess reproduction in progress, PLAN-EVAL required before implementation. Generated glue changes require one full scaffold.runtime smoke at the end. Do not merge or publish. No modifications under plugin-sagas-core/src/transports. +Issues #2630/#2631 share PR #2641, branch fix/runtime-child-drain from origin/main b0eb07957. Implementation and documentation are complete; independent IMPL-EVAL and a full supported-runner runtime verdict remain. Do not merge, publish, rebase, force-push or mark ready-merge. No excluded saga transport was modified and no Redis Streams command was added. -Confirmed baseline: real Redis child clean/timeout tests fail the exit watchdog (2/2); service clean/timeout likewise (2/2). These are genuine runtime failures after readiness, not startup failures. No production changes yet. PLAN-EVAL next. +PLAN-EVAL cycle two passed before source implementation: https://github.com/rickylabs/netscript/pull/2641#issuecomment-6923762411. The accepted plan locks explicit clean/fatal/timeout process exit 0/1/2; child loopback plus native hostname override; monotonic total budgets with reserved cleanup; signal-only singleton closeKv and identity-deduplicated raw-builder/host Prisma disposal; standalone OTel bounded flush without exit. Manual stop/external abort retain host resource ownership. No generic lifecycle registry. -## PLAN-EVAL cycle-one repairs +Real Redis reproductions failed on the base for all four child/service clean/timeout subprocess cases, then passed 4/4 after the fix. Child bind and OTel order regressions also failed before and passed after. Generated acquired/unused owner disposal tests and all three installed runtime artifact checks pass 37/37. Full service/plugin structured tests pass 820/820 with four optional Redis cases skipped in that broader run; those four were separately executed successfully against isolated real Redis. The two old assertions updated at the end retain database usability/owner disposal and Deno-watch crash-loop/reload behavior. -Evaluator accepted reproduction and coverage but returned FAIL_PLAN for five underspecified decisions. Plan now explicitly locks Deno.exit on clean and failed process-owned paths; Prisma dedup/disposal in raw withDatabase, inherited by presets; closeKv() rather than lazy context KV close(); bounded OTel flush without process termination and documented standalone behavior; and per-slice file groups (all below 30 files). Service's default 30 s total includes 25 s work and 5 s reserved cleanup; manual stop/external abort remain embeddable. No production code has changed. Cycle-two PLAN-EVAL is required before implementation. +Structured changed-source check/lint/fmt, quality:gate, docs:accuracy, release:preflight and generated-carrier freshness pass. Service doc lint is clean. Plugin doc-lint 18 and telemetry 7 match measured base distributions; plugin JSR audit fails only for missing module tags in three untouched entrypoints, while dry-run succeeds. Service/telemetry/CLI JSR audits pass with pre-existing warnings. Worklog has the detailed gate trail; no lock changes. -## S1 regression baseline and plan approval +Local one-pass scaffold.runtime was attempted twice. First stopped at PostgreSQL loopback readiness because Docker is remote. An owned-only temporary bridge made native PostgreSQL readiness and infrastructure/service/worker health pass. The second stopped at plugin doctor's explicit unsupported remote-Docker guard; no guard was disabled. The bridge also interfered with one persistent-network cleanup, recorded as a harness failure. Full local smoke is not green: the supported CI runner must supply that verdict. -PLAN-EVAL cycle two PASS: https://github.com/rickylabs/netscript/pull/2641#issuecomment-6923762411. All five requested plan repairs accepted; no product implementation preceded approval. New focused regression run at unchanged main source: 9 pass, 2 fail. Child default bind reports 0.0.0.0 instead of 127.0.0.1; OTel exits 0 before the composing runtime's drain/exit 7. Real Redis subprocess baseline already records four watchdog failures. Signal subprocess cases explicitly skip Windows (SIGTERM-specific acceptance). -S1 commits the red oracles and accepted plan; S2 will make these regressions pass. Tests requiring new cleanup contracts are added after those contracts exist. No resources remain from reproduction. +All temporary bridges and the exact diagnostic AppHost are stopped. Teardown preview/apply removed one positively attributed diagnostic PostgreSQL container; zero containers remain with this worktree's mounts or the bridge ownership label. Foreign/unknown resources remain untouched; raw ownership receipts are outside the public run. -## S2 core lifecycle implementation - -Added explicit child shutdown ownership, loopback hostname override, monotonic total work/cleanup deadlines, and exit codes 0/1/2. Service signal paths reserve cleanup within the total deadline, call singleton-aware closeKv(), disconnect every registered raw-builder DB identity once, and terminate explicitly. Manual stop/external abort and exitOnSignal:false leave process-owned resources to their host. Cleanup invokes all registered resource callbacks even if work or another cleanup hangs. OTel's bounded signal shutdown no longer exits the process. - -| Gate | Result | -| --- | --- | -| Real Redis child/service clean and timeout subprocess tests | exit 0, 4/4 pass; formerly four watchdog failures | -| Child bind/fatal snapshot, service coordinator, OTel focused tests | exit 0, 15/15 pass | -| Expanded cleanup/coordinator tests | exit 0, 8/8 pass | -| Existing listener/builder/runtime embedding tests | exit 0, 34/34 pass | -| Structured targeted type-check | exit 0, no diagnostics | -| Structured lint / format | exit 0 / exit 0 after correcting require-await in test stubs | -| quality:gate (quality:scan + arch:check) | exit 0 | - -Resource teardown preview remained read-only. Owned Redis was removed after exact identity, run-label and bind-mount proof; no foreign or unknown-owner resources changed. S2 adds explicit exitOnSignal:false to two existing embedded signal tests; their hook/listener assertions are retained. Plan file groups updated to 17 (<30) to include these necessary test adaptations and post-contract cleanup tests. -Reconcile: PR remains a draft, status progresses to implementation, source for excluded saga transports is unchanged. S3 composition/docs and the one-pass runtime smoke remain pending; no supervisor sign-off is claimed. - -## S3a generated resource ownership - -Added optional, idempotent owner disposal to PluginServiceContext without resolving unused adapters. Generated host bootstrap tracks only acquired Prisma identities; its callback attempts every disconnect once. Workers/sagas/auth service composition invokes it in reserved signal cleanup; workers/sagas/triggers child glue calls singleton closeKv and the generated host callback. Saga DB acquisitions are covered through their existing host resolver. Native embedded hosts retain ownership on manual stop. Explicit host DB disposal disables duplicate automatic raw-builder disposal. - -Generated-owner tests first failed 2/37 with missing disposal against the old embedded template. After canonical gen:assets-barrel, the suite passes 37/37, including all three installed runtime artifacts, acquired/unused generated DB cases, lazy owner disposal and a real signal proving exactly one disconnect. Structured changed-source check passes (14 files); non-CLI lint/fmt passes with no findings. CLI files require the repository's explicit CLI quality config because the root config excludes them; separate wrappers validate them. No lock changes or new dependencies. -Reconcile: #2630/#2631 acceptance implementation is progressing; generated runtime smoke, documentation/assets and independent IMPL-EVAL remain. No foreign resources are running for this slice. - -## S3b public behavior documentation - -Documented child loopback/hostname overrides, total and reserved cleanup budgets, explicit exit codes 0/1/2, manual/external embedding semantics, host database ownership override and OTel standalone signal behavior. Expanded the generated child-health page from the public option/function JSDoc, so its operational text stays source-derived. Public prose contains no run/evaluator/finding identities. - -Docs:accuracy passes. Release:preflight initially detected package self-imports inside the new subprocess test strings; tests now resolve their local source module explicitly, and preflight passes. Child seam tests still pass 4/4. This is a test import correction, not a gate exclusion. Source remains within approved runtime scope. Documentation generator carriers are refreshed after committing the read set, then the full one-pass runtime smoke runs. - -## S3b generated consumers and final static gates - -Canonical agent prose/site generation passes. Refreshed MCP export-surface corpus, CLI assets and publish assets; both corpus and publish freshness checks pass. Export generation used its documented --allow-dirty option only for the already-generated prose carrier; all hand-authored inputs were committed and the warning named that sole derived input. No lock changes. Reference layouts were restored after the Markdown formatter caused broad table churn, leaving only semantic shutdown additions in the PR diff. - -Final quality:gate, docs:accuracy and release:preflight pass. Service full export-map doc lint passes with zero diagnostics. Plugin doc lint has 18 pre-existing private-type diagnostics; telemetry has 7 (6 private-type, 1 missing JSDoc). Measured the identical command and per-entrypoint/file distributions at base b0eb07957 in a detached baseline checkout. Changed plugin health/SDK entrypoints are clean. JSR audits: service, telemetry and CLI exit 0 (existing warnings); plugin dry-run succeeds but audit exits 1 for three pre-existing missing @module tags in untouched abstracts/config/testing entrypoints. Git diff of those three entrypoints against the base is empty. These unrelated baseline findings are not hidden or fixed in this runtime slice. - -Next: one full scaffold.runtime smoke with cleanup, resource ownership audit, final independent IMPL-EVAL and head checks. #2632 is ready for review separately at head deb6b21cfcfc6b9d94e7291eb21def7072b4539b with required checks PASS/SKIPPED and no unanswered threads. +Next: dispatch supported CI runtime on this branch, independent feature-tier IMPL-EVAL (pinned Muse Spark 1.3 xhigh, separate vendor family/session), address findings, then truthful issue evidence/closing keywords, ready-for-review transition and required head checks/thread gate. Do not watch PRs from this delegated lane. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md index abbf5c4fb0..466efbf0bb 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/leak-report.md @@ -1,5 +1,5 @@ # Resource inspection -The first full scaffold.runtime attempt failed at PostgreSQL readiness in the documented scaffold control; cleanup.aspire-stop passed. A targeted restart proved the database was accepting connections while local health checks could not reach Docker's separate network namespace. A temporary bridge scoped to this run's container identities made the native PostgreSQL health check pass. The exact diagnostic AppHost was stopped. +Two full scaffold.runtime attempts were made. First: PostgreSQL loopback reachability failed, cleanup.aspire-stop passed. Second: an owned-only temporary bridge proved PostgreSQL, Redis, Garnet and affected service/worker health, but plugin doctor explicitly rejected remote Docker. That is partial evidence, not a full smoke PASS. The bridge attachment also prevented one persistent-network cleanup, so its failure remains recorded. -A corrected one-pass smoke is running with the same temporary environment bridge. The bridge is not product source and removes only proxies it creates, after checking their unique ownership label. Foreign and unknown-owner resources are left untouched. Final owned-resource cleanup follows the corrected smoke. Operator paths, hostnames, ports and process identities are excluded from public evidence. +The bridge and exact diagnostic AppHost are stopped. Read-only leak reporting and teardown preview were repeated with the absolute worktree root, storing raw operational receipts outside the public run. Preview planned one positively attributed diagnostic PostgreSQL container removal; apply removed exactly that container and no processes/AppHosts. Exit 4 reflects 40 foreign or unknown-owner entries left untouched. Subsequent Docker identity scans found zero containers with owned-root mounts and zero uniquely labelled bridge containers. No operator paths, hostnames, ports or process identities are retained here. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 63b45cbd76..a8d377ba4b 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -76,3 +76,10 @@ First full scaffold.runtime attempt exited 1 before changed runtime roles: prefl The broader service/plugin tests exposed two legacy expectations: manual defineService.stop must preserve the host database under the approved contract; Deno watch reports explicit exit 1 as "Process finished with exit code 1" rather than "Process failed". Updated those assertions while retaining database usability/explicit owner disposal and watch failure/restart-history assertions. Targeted format/lint pass. No production behavior changed in this follow-up. Broader package regression suite after the expectation updates: structured service/plugin tests exit 0, 820 passed / 0 failed / 4 ignored (824 results). Both updated test files pass structured format and lint with zero findings. + + +Corrected full scaffold.runtime exited 1 at plugin doctor: the maintained Docker topology contract explicitly rejects remote Docker for generated AppHosts. Native describe proved PostgreSQL, Redis, Garnet, users, workers API and workers healthy through the temporary bridge. This is partial runtime evidence, not a full smoke PASS. The temporary bridge also attached to the owned Aspire network and caused persistent-network cleanup to fail; the bridge is stopped and its residual ownership is audited separately before final cleanup. Further full local reruns are not useful on this unsupported topology; the supported CI runner must supply the complete runtime verdict. No doctor or test guard is disabled. + +Final quality:gate exits 0 after both expectation updates. Baseline-only diagnostics remain disclosed above. + +Resource reconciliation: teardown preview with an absolute worktree root planned one owned diagnostic PostgreSQL container removal. Apply removed that one container and no AppHosts/processes; exit 4 reports 40 foreign/unknown entries left untouched. Docker identity scans afterward found zero containers with owned-root mounts and zero uniquely labelled temporary bridge containers. The script's best-effort cleanup encountered a proxy already removed by Aspire; the error is retained, with the zero-survivor scan supplying final cleanup evidence. From 0cea5852e85baa7473dde77d08e6a39f8da5f66f Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 19:28:33 +0100 Subject: [PATCH 13/19] fix(plugins): forward child health bind address in generated launches --- .../context-pack.md | 3 + .../drift.md | 3 + .../evaluate.md | 118 ++++++++++++++++++ .../worklog.md | 11 ++ .../orchestration-runtime/child-health.md | 12 +- packages/plugin/README.md | 5 +- .../presentation/run-child-health-process.ts | 2 + .../tests/health/generated-hostname_test.ts | 98 +++++++++++++++ .../adapter/resources/glue/runtime.stub.ts | 1 + .../adapter/resources/glue/runtime.stub.ts | 1 + .../adapter/resources/glue/runtime.stub.ts | 5 +- 11 files changed, 252 insertions(+), 7 deletions(-) create mode 100644 .llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md create mode 100644 packages/plugin/tests/health/generated-hostname_test.ts diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index a2e5af3c39..6efc9235e4 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -13,3 +13,6 @@ Local one-pass scaffold.runtime was attempted twice. First stopped at PostgreSQL All temporary bridges and the exact diagnostic AppHost are stopped. Teardown preview/apply removed one positively attributed diagnostic PostgreSQL container; zero containers remain with this worktree's mounts or the bridge ownership label. Foreign/unknown resources remain untouched; raw ownership receipts are outside the public run. Next: dispatch supported CI runtime on this branch, independent feature-tier IMPL-EVAL (pinned Muse Spark 1.3 xhigh, separate vendor family/session), address findings, then truthful issue evidence/closing keywords, ready-for-review transition and required head checks/thread gate. Do not watch PRs from this delegated lane. + + +IMPL-EVAL cycle one FAIL_FIX (evaluate.md): F1 full supported-runner runtime verdict pending; F2 generated hostname delivery missing. F2 repaired by forwarding NETSCRIPT_CHILD_HEALTH_HOSTNAME from all three generated launchers to the native option. Regression: base 3/6 fails on defaults; pre-repair PR 3/6 fails on ignored override; repaired 6/6 pass with real native bind and non-loopback HTTP. Combined installed artifact suite31/31. New source/docs/carriers must be pushed, then supported CI run at final head and cycle-two independent evaluation. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index a78cb100c8..4fb3b88776 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -17,3 +17,6 @@ - The required runtime smoke was repeated only after diagnosing a concrete environment failure: container loopback endpoints were in the Docker daemon's namespace. A temporary, owned-only port bridge supplies local reachability without changing generated output or weakening gates. Native PostgreSQL readiness passed through it. - S4 includes two pre-existing test expectation updates: manual-stop host DB ownership and Deno-watch's explicit-exit diagnostic. Both retain their behavioral assertions; the slice remains below 30 files. + +- S4 hostname decision is now resolved after IMPL-EVAL F2: generated workers/sagas/triggers forward NETSCRIPT_CHILD_HEALTH_HOSTNAME as the existing native hostname option. Unset retains loopback, including generated Aspire host executables. Containers explicitly request 0.0.0.0. No generic HOSTNAME fallback and no new service hostname behavior. All three generated artifacts have a native bind plus non-loopback HTTP regression. +- Cycle one IMPL-EVAL FAIL_FIX is preserved. F1 waits on supported-runner runtime evidence; the hostname repair requires a new final-head CI run and a new evaluator session under T3 re-check policy. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md new file mode 100644 index 0000000000..549b21843d --- /dev/null +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md @@ -0,0 +1,118 @@ +# Evaluation: fix-runtime-child-drain--issues-2630-2631 + +## Metadata + +| Field | Value | +| --- | --- | +| Run ID | `fix-runtime-child-drain--issues-2630-2631` | +| Target | PR 2641, issues #2630/#2631 | +| Archetype | 3 runtime/behavior primary, plugin/CLI and service overlays | +| Scope overlays | `SCOPE-service.md`, `SCOPE-docs.md` | +| Evaluator | Separate session from generator; requested `muse_spark_1_3/xhigh`, observed `opencode-go/muse-spark-1.3-contributor`; generator is the owner-selected Codex `gpt-6.1-sol/xhigh` session; different session and different vendor family; no substitution; fallback `opus_5/xhigh` not used | +| Branch | `fix/runtime-child-drain` | +| Exact head evaluated | `26e945e9f3b710a1f18e2452bb4d524ed217e09b` | +| Base | `origin/main b0eb079575968e843b781579673c9fe2ae250e07` | +| Date | 2026-11-16 | + +## Process Verification + +| Check | Result | Evidence | +| --- | --- | --- | +| Plan-Gate passed before implementation | PASS | `.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md` cycle two `PASS`; PR comment `6923762411` `[PHASE: PLAN-EVAL] [VERDICT: APPROVED]` at head `f86b8891` | +| Design section exists in worklog | PASS | `.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md` `## Design` names public surface, lifecycle, contributor path, and gate plan | +| Commit slices match design plan | PASS | Plan S1/S2/S3a/S3b/S4 order preserved in worklog and PR slice checklist; S1 red oracles, S2 core lifecycle, S3a generated ownership, S3b docs/carriers, S4 validation follow-up with two recorded expectation updates | +| Each slice has a passing gate | PASS | Worklog records per-slice gates: S1 9 pass/2 fail red baseline; S2 Redis 4/4 plus 15/15 plus 8/8 plus 34/34; S3a generated 37/37; S3b docs/accuracy, release preflight, carrier freshness; S4 structured 820 pass/0 fail/4 ignored with the 4 Redis cases executed separately | +| No speculative seams | PASS | New files trace to the database identity-disposal seam and subprocess/control tests; no generic lifecycle registry; no saga transport changes; no Redis Streams dependency | +| Constants used for finite vocabularies | PASS | Exit codes 0/1/2 computed in one place per edge (`packages/plugin/src/presentation/run-child-health-process.ts`, `packages/service/src/builder/service-listener.ts`); no stringly exit-code spread | + +## Static Gates + +| Gate | Command or check | Result | Evidence | Notes | +| --- | --- | --- | --- | --- | +| Narrow typecheck | structured check wrapper, service root | PASS | Independent run: service selection 131 files, 0 diagnostics | Uses pinned Deno 2.9.7 with unstable-kv | +| Slice typecheck | structured check wrapper, child presentation root | PASS | Independent run: 4 files, 0 diagnostics | Same toolchain | +| Format | structured fmt wrapper, service root | PASS | Independent run: 131 files, 0 findings | Scoped TS only, not raw root noise | +| Lint | structured lint wrapper, service root | PASS | Independent run: 131 files, 0 findings | Scoped TS only | +| Focused tests | structured test wrapper | PASS | Independent runs: service resources plus coordinator 9/9; child health plus OTel provider 11/11 | Smallest meaningful independent evidence; Redis subprocess regressions not rerun here | +| Quality gate | `deno task quality:gate` | PASS | Independent run exit 0; A13 `Deno.exit` warnings present on the intentional process edges | Warnings are the planned process-ownership exits, not a failure | +| Architecture fitness | `deno task arch:check` | PASS | Independent run exit 0 | Same warning set as quality gate | +| Service doc lint | structured doc-lint wrapper, service full export map | PASS | Independent run: combined 0 diagnostics across all entrypoints | Matches reported clean claim | +| Plugin/telemetry doc lint | reported only | PENDING | Reported plugin 18 and telemetry 7 match measured base distributions; changed health/SDK entrypoints reported clean | Not independently re-measured at base in this pass; accepted as disclosed pre-existing baseline, not new debt | +| JSR audit | reported only | PENDING | Reported service/telemetry/CLI pass with existing warnings; plugin dry-run succeeds but audit reports 3 missing module tags in untouched abstracts/config/testing entrypoints | Matches the disclosed pre-existing pattern; not independently rerun here | +| Docs accuracy / release preflight / carriers | reported only | PASS (reported) | Worklog records docs:accuracy, release:preflight, and generated-carrier freshness passing after the test import correction | Import correction described as resolving package self-imports to local module URLs, not a gate exclusion | + +## Fitness Gates + +| Gate | Function | Result | Evidence | Violations | +| --- | --- | --- | --- | --- | +| F-1 | File-size lint | PASS | quality:gate exit 0 | None introduced | +| F-2 | Helper-reinvention scan | PASS | quality:gate exit 0 | Callback contracts and existing hooks preferred; no new registry | +| F-3 | Layering check | PASS | quality:gate and arch:check exit 0 | Builder/listener/coordinator split retained | +| F-4 | Inheritance audit | PASS | quality:gate exit 0 | No new base-class coupling | +| F-5/F-6 | Public surface / JSR | PENDING | Plugin 3 missing module tags reported in untouched entrypoints | Pre-existing; no new export-shape violation found in changed options (`ChildHealthProcessOptions`, `ServeOptions`, `PluginServiceContext.dispose`) | +| F-13 | Saga and runtime invariants | PASS | No changes under `packages/plugin-sagas-core/src/transports/`; saga DB covered through the existing host resolver; no Redis Streams dependency added | Hard restriction honored | + +Remaining fitness rows inherit the quality:gate/arch:check PASS; no new `any`, no new blanket lint ignores, and no host-side hardcoded plugin coupling were introduced in the reviewed diff. + +## Runtime Gates + +| Gate | Validation | Result | Evidence | +| --- | --- | --- | --- | +| Child/service Redis subprocess regressions | Real Redis clean plus hung work, child and service | PASS (generator-reported) | Worklog: 4 watchdog failures on base, 4/4 pass at head; KV-alone negative control exits; this pass did not rerun live Redis subprocesses and does not re-certify them | +| Child bind plus OTel order | Focused snapshot tests | PASS (generator-reported, partially independent) | Worklog: bind default reports loopback vs base ephemeral-interface behavior; OTel no longer exits before runtime drain; child plus OTel focused tests independently rerun here 11/11 | +| Generated owner disposal | Acquired/unused/alias identity plus installed artifacts | PASS (generator-reported) | Worklog: 37/37 including acquired/unused cases and one real-signal exactly-once disconnect | +| Full service plus plugin suite | Structured suite | PASS (generator-reported) | Worklog: 820 passed, 0 failed, 4 ignored; the 4 ignored are the Redis cases executed separately above | +| Full one-pass scaffold runtime | `deno task e2e:cli run scaffold.runtime --cleanup --format pretty` on a supported runner | NOT_RUN | Local attempts correctly stopped: first at PostgreSQL loopback readiness on remote-Docker topology, second at the maintained explicit remote-Docker rejection in plugin doctor; temporary owned-only bridge plus diagnostic AppHost are stopped with zero owned survivors; supported-runner `e2e-cli` workflow dispatch is in progress and, at read time, has not produced a terminal verdict; draft PR checks show that lane skipped with one conformance lane still running | + +## Consumer Gates + +| Consumer | Validation | Result | Evidence | +| --- | --- | --- | --- | +| Generated container/Aspire health | Non-loopback child health reachability on a supported runner | NOT_RUN | Explicit native `hostname` override exists and defaults to loopback, but generated workers/sagas/triggers glue stubs do not forward any hostname override and no environment fallback was added; the S4 hostname-environment decision was deferred to the smoke that has not completed, so there is no supported-runner proof that generated launches needing non-loopback probes still pass | +| Docs consumers | Source-derived child health docs plus MCP/CLI carriers | PASS (reported) | Worklog: generation passes, carrier freshness passes, reference layout churn reverted leaving only semantic shutdown additions | + +## Anti-Pattern Check + +Only rows the run scope touches are marked `CLEAR`; the rest are `N/A`. + +| AP | Status | Evidence | Notes | +| --- | --- | --- | --- | +| AP-1 | CLEAR | Small focused modules; no generic utils folder added | — | +| AP-5 | CLEAR | No new inheritance; composition via callbacks and existing hooks | — | +| AP-13 | CLEAR | `Deno.exit` confined to process-owned signal paths with documented 0/1/2 codes; `exitOnShutdown`/`exitOnSignal` false paths leave hosts alone | A13 scanner warns, quality gate still exits 0; intentional per approved plan | +| AP-20 | CLEAR | No Redis Streams dependency; transport directory untouched | Hard restriction honored | +| Others in scope | CLEAR/N/A | No new registry, no lazy-resolve-on-close in disposal paths, manual stop and external abort retain host ownership | — | + +## Arch-Debt Delta + +| Metric | Count | Evidence | +| --- | --- | --- | +| New entries | 0 | No new doctrine violation found requiring registration | +| Resolved entries | 0 | No entry claimed closed | +| Deepened violations | 0 | KV god-test debt untouched; only `closeKv()` called from composition roots, KV package unmodified | +| Unrecorded violations | 0 | OTel standalone behavior change is documented and carried in docs scope | + +## Findings + +| Severity | Finding | Evidence | Required action | +| --- | --- | --- | --- | +| high | Full supported-runner `scaffold.runtime` has no green verdict | PR Definition of Done leaves generated-launch smoke unchecked; `e2e-cli` workflow dispatch is in progress with no terminal conclusion at read time; local evidence is explicitly partial by topology, with no guard disabled | Obtain the green supported-runner one-pass smoke with cleanup on this exact head; link the run and its exit code; then re-run IMPL-EVAL currency checks before any ready-merge move. Do not rerun full local smoke on the unsupported remote-Docker topology and do not weaken plugin doctor. | +| high | Generated child-health hostname override has no container evidence | `packages/plugin/src/presentation/run-child-health-process.ts` defaults to `127.0.0.1` with an explicit `hostname` option; workers/sagas/triggers `plugins/*/src/adapter/resources/glue/runtime.stub.ts` pass only `onShutdown` and restart history, with no hostname forwarding; issue #2631 requires generated container/Aspire launches needing non-loopback probes to still pass, and the deferred hostname-environment decision is not recorded in `.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md` | Either wire the override through generated glue (option or documented environment delivery) with a test, or supply supported-runner evidence that loopback suffices for the generated probes, and record the S4 hostname decision in drift. Generator to resolve while CI runs. | +| medium | Close-gate is correctly red | Both issues carry unchecked acceptance boxes; PR Definition of Done leaves the smoke and independent evaluation unchecked; PR carries no closing keywords and must not gain them until the two high findings are resolved | Keep the PR draft without closing keywords; verify every acceptance and gate checkbox with linked evidence before any `status:ready-merge` transition. | +| low | Baseline doc/JSR deltas rely on measured comparison | Plugin 18 plus telemetry 7 doc-lint and 3 plugin JSR module-tag findings are reported as identical to base with empty diff on those entrypoints | No code action; retain the base-measurement note in the final ready-merge evidence so a closer does not mistake them for new debt. | + +No implementation logic defect was found in the reviewed edges: monotonic total budgets with reserved cleanup, cleanup attempted despite hung work, signal-only identity-deduplicated Prisma disposal, singleton-aware KV disposal, explicit owner-disposal opt-out, idempotent host disposal tracking only acquired clients, and bounded OTel flush with listener removal and no process exit all match the approved contracts. + +## Lessons for Promotion + +| Lesson | Pattern | Applies to | Confidence | +| --- | --- | --- | --- | +| Remote-Docker loopback is not a green smoke | Temporary bridges can prove native readiness yet still fail maintained topology guards | release-gate runs | high | +| Explicit hostname without generated wiring leaves container coverage open | Child default change needs glue forwarding or probe evidence in the same slice | runtime edges | medium | + +## Verdict + +| Field | Value | +| --- | --- | +| Verdict | `FAIL_FIX` | +| Rationale | Plan remains valid and the reviewed lifecycle, ownership, and OTel changes match the approved contracts with static and focused gates green, but the release-gate class has no supported-runner green verdict and generated non-loopback health coverage has no evidence; both are required remedies, not a plan or debt failure. PR phase comment is therefore `CHANGES_REQUESTED`. | diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index a8d377ba4b..ed5c857f56 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -83,3 +83,14 @@ Corrected full scaffold.runtime exited 1 at plugin doctor: the maintained Docker Final quality:gate exits 0 after both expectation updates. Baseline-only diagnostics remain disclosed above. Resource reconciliation: teardown preview with an absolute worktree root planned one owned diagnostic PostgreSQL container removal. Apply removed that one container and no AppHosts/processes; exit 4 reports 40 foreign/unknown entries left untouched. Docker identity scans afterward found zero containers with owned-root mounts and zero uniquely labelled temporary bridge containers. The script's best-effort cleanup encountered a proxy already removed by Aspire; the error is retained, with the zero-survivor scan supplying final cleanup evidence. + + +## IMPL-EVAL cycle one and hostname delivery repair + +Independent Muse Spark 1.3 xhigh evaluation returned FAIL_FIX: no complete supported runtime verdict yet (F1), and generated glue did not deliver the native hostname override (F2). Implementation lifecycle logic otherwise matched the accepted plan. Full verdict preserved in evaluate.md and https://github.com/rickylabs/netscript/pull/2641#issuecomment-6925186816. + +Resolved the deferred S4 hostname decision with a dedicated generated-launch environment variable: workers/sagas/triggers pass NETSCRIPT_CHILD_HEALTH_HOSTNAME to the existing native hostname option. Unset preserves loopback. Custom API callers still set the explicit option; no shared-library environment fallback or generic HOSTNAME convention was added. Aspire's generated children run as host executables and retain loopback probes; containers can explicitly widen their listener. + +Added generated-hostname subprocess tests executing all three emitted entrypoints and probing native HTTP through a non-loopback IPv4 interface for the widened case. At base b0eb07957: 3 pass/3 fail (defaults incorrectly bind all interfaces). At pre-repair PR source: 3 pass/3 fail (environment override ignored, non-loopback connection refused). After forwarding: 6/6 pass. Combined with installed-artifact tests: 31/31 pass. The preload observes the native bound address and HTTP response before database/job bootstrap; it does not replace application handlers. All subprocesses exit and temporary fixtures are removed. One initial probe also checked an unrelated bootstrap state; corrected that oracle to verify bind/HTTP reachability only before counting the genuine red result. + +Hostname repair gates: structured changed-file check/lint/fmt pass with zero diagnostics/findings; release:preflight and docs:accuracy pass. Source-derived child health page regenerated. diff --git a/docs/site/orchestration-runtime/child-health.md b/docs/site/orchestration-runtime/child-health.md index 51624f2e89..08e4609092 100644 --- a/docs/site/orchestration-runtime/child-health.md +++ b/docs/site/orchestration-runtime/child-health.md @@ -96,11 +96,13 @@ console.log(CHILD_CRASH_LOOP_THRESHOLD.restarts); // 3 Process health composition, including optional single-owner restart history. -The listener binds 127.0.0.1 by default; hostname overrides the bind address. Shutdown allows 35 -seconds total by default: 30 seconds for work, with five seconds reserved for resource cleanup and -the health listener. Cleanup callbacks run even when work times out. Fatal health remains visible -for one second before this budget starts. Exit codes are 0 for a clean drain, 1 for failure and 2 -for any shutdown deadline. Set exitOnShutdown to false when a host owns termination. +The listener binds 127.0.0.1 by default; hostname overrides the bind address. Generated workers, +sagas and triggers pass NETSCRIPT_CHILD_HEALTH_HOSTNAME to this option so container launches can +widen the bind without editing glue. Shutdown allows 35 seconds total by default: 30 seconds for +work, with five seconds reserved for resource cleanup and the health listener. Cleanup callbacks run +even when work times out. Fatal health remains visible for one second before this budget starts. +Exit codes are 0 for a clean drain, 1 for failure and 2 for any shutdown deadline. Set +exitOnShutdown to false when a host owns termination. Example: diff --git a/packages/plugin/README.md b/packages/plugin/README.md index 3e65931bf1..fcdbd25db1 100644 --- a/packages/plugin/README.md +++ b/packages/plugin/README.md @@ -181,7 +181,10 @@ point, then run the generated-process regressions in `tests/health/generated-cra Generated workers, triggers, and sagas glue starts the health listener before bootstrap. The listener binds `127.0.0.1` by default. `PORT` selects the port; without it, the operating system assigns an ephemeral port. Pass `ChildHealthProcessOptions.hostname: '0.0.0.0'` when container -health checks must reach the listener from another network namespace. +health checks must reach the listener from another network namespace. Generated workers, sagas and +triggers forward `NETSCRIPT_CHILD_HEALTH_HOSTNAME` to that option, so a container launch can set it +to `0.0.0.0` without editing generated glue. Leave it unset for loopback probes, including the +generated Aspire executable launches. On a stop signal, `runChildHealthProcess` gives work 30 seconds to drain and reserves five more seconds for `onShutdown` resource callbacks and the health listener. `drainTimeoutMs` bounds the diff --git a/packages/plugin/src/presentation/run-child-health-process.ts b/packages/plugin/src/presentation/run-child-health-process.ts index 5de4e1f56f..5623941feb 100644 --- a/packages/plugin/src/presentation/run-child-health-process.ts +++ b/packages/plugin/src/presentation/run-child-health-process.ts @@ -8,6 +8,8 @@ import { FileChildRestartHistory } from '../adapters/file-child-restart-history. * Process health composition, including optional single-owner restart history. * * The listener binds 127.0.0.1 by default; hostname overrides the bind address. + * Generated workers, sagas and triggers pass NETSCRIPT_CHILD_HEALTH_HOSTNAME to + * this option so container launches can widen the bind without editing glue. * Shutdown allows 35 seconds total by default: 30 seconds for work, with five * seconds reserved for resource cleanup and the health listener. Cleanup callbacks * run even when work times out. Fatal health remains visible for one second before diff --git a/packages/plugin/tests/health/generated-hostname_test.ts b/packages/plugin/tests/health/generated-hostname_test.ts new file mode 100644 index 0000000000..60aa838b88 --- /dev/null +++ b/packages/plugin/tests/health/generated-hostname_test.ts @@ -0,0 +1,98 @@ +import { assertEquals } from '@std/assert'; +import { fromFileUrl } from '@std/path'; +import { runtimeGlueStub as workers } from '../../../../plugins/workers/src/adapter/resources/glue/runtime.stub.ts'; +import { runtimeGlueStub as sagas } from '../../../../plugins/sagas/src/adapter/resources/glue/runtime.stub.ts'; +import { runtimeGlueStub as triggers } from '../../../../plugins/triggers/src/adapter/resources/glue/runtime.stub.ts'; + +const CONFIG = fromFileUrl(new URL('../../../../deno.json', import.meta.url)); + +for (const [plugin, runtime] of Object.entries({ workers, sagas, triggers })) { + for (const hostname of [undefined, '0.0.0.0']) { + const expectedHostname = hostname ?? '127.0.0.1'; + Deno.test({ + name: `generated ${plugin} health binds ${ + hostname ?? 'loopback by default' + } and serves its probe`, + ignore: Deno.build.os === 'windows', + async fn() { + const root = await Deno.makeTempDir(); + const probe = `${root}/probe.ts`; + await Deno.writeTextFile(`${root}/runtime.ts`, runtime.source); + await Deno.writeTextFile( + `${root}/registry.ts`, + "throw new Error('Bind probe bootstrap');\n", + ); + // Intercept only the native HTTP boundary. Execute the actual generated + // entrypoint; readiness of its job/database bootstrap is outside this bind test. + await Deno.writeTextFile( + probe, + `const serve = Deno.serve; +Deno.serve = (...args) => { + const server = serve(...args); + void (async () => { + const target = ${JSON.stringify(expectedHostname)} === '0.0.0.0' + ? Deno.networkInterfaces().find((entry) => entry.family === 'IPv4' && !entry.address.startsWith('127.'))?.address + : '127.0.0.1'; + if (!target) throw new Error('A non-loopback IPv4 interface is required for this probe.'); + const response = await fetch('http://' + target + ':' + server.addr.port + '/health'); + await response.json(); + console.log('HEALTH_BIND:' + JSON.stringify({ hostname: server.addr.hostname, status: response.status })); + Deno.exit(0); + })().catch((error) => { console.error(error); Deno.exit(1); }); + return server; +}; +`, + ); + const env: Record = { + ...Deno.env.toObject(), + PORT: '0', + CACHE_PROVIDER: 'denokv', + DENO_KV_URL: `${root}/runtime.kv`, + NETSCRIPT_PLUGIN_SERVICE_BOOTSTRAP_MODULE: '', + NETSCRIPT_WORKERS_REGISTRY_MODULE: `${root}/registry.ts`, + SAGAS_REGISTRY_MODULE: `${root}/registry.ts`, + NETSCRIPT_TRIGGER_REGISTRY_MODULE: `${root}/registry.ts`, + }; + delete env.NETSCRIPT_CHILD_HEALTH_HOSTNAME; + if (hostname !== undefined) env.NETSCRIPT_CHILD_HEALTH_HOSTNAME = hostname; + const child = new Deno.Command(Deno.execPath(), { + args: [ + 'run', + '--no-check', + '--allow-all', + '--unstable-kv', + '--preload', + probe, + '--config', + CONFIG, + `${root}/runtime.ts`, + ], + cwd: root, + clearEnv: true, + env, + stdout: 'piped', + stderr: 'piped', + }).spawn(); + const timer = setTimeout(() => { + try { + child.kill('SIGKILL'); + } catch { /* The owned child already exited. */ } + }, 15_000); + try { + const result = await child.output(); + assertEquals(result.code, 0, new TextDecoder().decode(result.stderr)); + const report = new TextDecoder().decode(result.stdout).split('\n').find((line) => + line.startsWith('HEALTH_BIND:') + ); + assertEquals(JSON.parse(report?.slice('HEALTH_BIND:'.length) ?? 'null'), { + hostname: expectedHostname, + status: 503, + }); + } finally { + clearTimeout(timer); + await Deno.remove(root, { recursive: true }); + } + }, + }); + } +} diff --git a/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts b/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts index de67008668..672ac3df47 100644 --- a/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts +++ b/plugins/sagas/src/adapter/resources/glue/runtime.stub.ts @@ -38,6 +38,7 @@ export const runtimeGlueStub: StubSource = defineStub({ ' },', ' () => supervisor?.snapshot().childHealth,', ' {', + " hostname: Deno.env.get('NETSCRIPT_CHILD_HEALTH_HOSTNAME'),", " restartHistoryPath: '.data/child-health/sagas.json',", ' onShutdown: [closeKv, disposeHostResources],', ' },', diff --git a/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts b/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts index 397fcbbf5e..ca8b76cec8 100644 --- a/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts +++ b/plugins/triggers/src/adapter/resources/glue/runtime.stub.ts @@ -28,6 +28,7 @@ export const runtimeGlueStub: StubSource = defineStub({ ' () => health.snapshot(),', ' {', ' health,', + " hostname: Deno.env.get('NETSCRIPT_CHILD_HEALTH_HOSTNAME'),", " restartHistoryPath: '.data/child-health/triggers.json',", ' onShutdown: [closeKv, disposeHostResources],', ' },', diff --git a/plugins/workers/src/adapter/resources/glue/runtime.stub.ts b/plugins/workers/src/adapter/resources/glue/runtime.stub.ts index a6b63a028a..01e849ca72 100644 --- a/plugins/workers/src/adapter/resources/glue/runtime.stub.ts +++ b/plugins/workers/src/adapter/resources/glue/runtime.stub.ts @@ -36,7 +36,10 @@ export const runtimeGlueStub: StubSource = defineStub({ ' });', ' },', ' () => snapshot?.(),', - ' { onShutdown: [closeKv, disposeHostResources] },', + ' {', + " hostname: Deno.env.get('NETSCRIPT_CHILD_HEALTH_HOSTNAME'),", + ' onShutdown: [closeKv, disposeHostResources],', + ' },', ' );', '}', '', From a142ac6324419496e58481d274a3ed9b356fb7bd Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 19:30:29 +0100 Subject: [PATCH 14/19] chore(docs): refresh generated child hostname consumers --- .../runs/fix-runtime-child-drain--issues-2630-2631/worklog.md | 2 ++ .../mcp/src/infrastructure/docs/agent-docs-prose.generated.ts | 2 +- .../export-surfaces/export-surface-corpus.generated.ts | 2 +- packages/mcp/src/publish-assets.generated.ts | 4 ++-- 4 files changed, 6 insertions(+), 4 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index ed5c857f56..1b00433017 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -94,3 +94,5 @@ Resolved the deferred S4 hostname decision with a dedicated generated-launch env Added generated-hostname subprocess tests executing all three emitted entrypoints and probing native HTTP through a non-loopback IPv4 interface for the widened case. At base b0eb07957: 3 pass/3 fail (defaults incorrectly bind all interfaces). At pre-repair PR source: 3 pass/3 fail (environment override ignored, non-loopback connection refused). After forwarding: 6/6 pass. Combined with installed-artifact tests: 31/31 pass. The preload observes the native bound address and HTTP response before database/job bootstrap; it does not replace application handlers. All subprocesses exit and temporary fixtures are removed. One initial probe also checked an unrelated bootstrap state; corrected that oracle to verify bind/HTTP reachability only before counting the genuine red result. Hostname repair gates: structured changed-file check/lint/fmt pass with zero diagnostics/findings; release:preflight and docs:accuracy pass. Source-derived child health page regenerated. + +Hostname repair consumer refresh: canonical agent-docs prose/site build, export corpus (documented --allow-dirty for the sole regenerated prose carrier), CLI assets and publish assets completed. Export and publish freshness checks pass. No lock changes or additional CLI embedded diff. Final-head supported runtime CI is requested after this consumer commit. diff --git a/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts b/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts index 6b75cea640..aaef4fa2f9 100644 --- a/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts +++ b/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts @@ -313,7 +313,7 @@ export const EMBEDDED_AGENT_DOCS_PAGES: readonly AgentDocsPage[] = [ ["pages/observability/telemetry/index.md","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","a4373ffa9451fa3eeae9a3b7550ee1c57218ecfd262c670524461f5b1f65e503",26591], - ["pages/orchestration-runtime/child-health/index.md","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","c981dc61711a84174a6690fe9000893102006500bff5308e8b1fdfeb03d3e5d8",6107], + ["pages/orchestration-runtime/child-health/index.md","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","a478e49af6d4950e5637fe37709c95ec1650b6e9b821cf094e7ec3c4475ba4f3",6260], ["pages/orchestration-runtime/cli-scaffold/index.md","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","178b545a17f3128b70d570fd0aafb32e92ce4538e525a7b674fa9fffe7e293d2",6795], diff --git a/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts b/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts index 47cc01279c..74491e65a7 100644 --- a/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts +++ b/packages/mcp/src/infrastructure/export-surfaces/export-surface-corpus.generated.ts @@ -221,7 +221,7 @@ export const EXPORT_SURFACE_ROWS: readonly (readonly [string, string, string, st ["plugin","./contract-base","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",6010,13], - ["plugin","./health","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",11579,19], + ["plugin","./health","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",11734,19], ["plugin","./loader","pJDBSsRADIZfJcxpF8o+QBU9eFVZvJYe4kw6BttkyMzsCuK7Cy0Wuh57DD/fF/i6znkjLHQea2R51hjJXOM2Z990bqjiC6u4xrEUsgE9bQb47zmk+XjFiVrIxVjisYWbT6ttM8A3sAx6mChnjCvewEQFAxZ8bOGNvFq4/1uqfIpe5eHYwkU53MEVTXYJyExtlyHQe407DPAzN36a0wLCuMTJXhMFKAoIS2PIZBf2BMnUU84n17gXFp5wXKEPTAS5pjTyAt+gXqXQV8kn1/e/AAAA//8DAA==","Dt2mE832ZjsNzaQMKjAwzd2j3Zn6xvlv6nk346B8wA4=",536,2], diff --git a/packages/mcp/src/publish-assets.generated.ts b/packages/mcp/src/publish-assets.generated.ts index 6126123d20..dd72f243ed 100644 --- a/packages/mcp/src/publish-assets.generated.ts +++ b/packages/mcp/src/publish-assets.generated.ts @@ -307,7 +307,7 @@ export const MCP_EMBEDDED_DOCS_PROVENANCE: 'pages/web-layer/vite/index.md', 'pages/why/index.md', ], - sourceBytes: 3259270, + sourceBytes: 3259423, documentCount: 286, - sha256: '298ec92d46795f20a9d10cd7362a3f5c2822d6bccfc3d77e8e0ddfa5acfa46c3', + sha256: 'ba39478642e858dd3fc404538c865e1cdbd9286b02452de06798a3dbbc4e53fb', }; From d6ef1fa71d164281b0c324240c5c0f287db70132 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 21:38:24 +0100 Subject: [PATCH 15/19] fix(cli): preserve native resource restart failure diagnostics --- .../drift.md | 5 ++++ .../worklog.md | 17 +++++++++++ .../refresh-generated-client-consumers.ts | 7 ++++- ...refresh-generated-client-consumers_test.ts | 29 +++++++++++++++++++ 4 files changed, 57 insertions(+), 1 deletion(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index 4fb3b88776..833f789603 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -20,3 +20,8 @@ - S4 hostname decision is now resolved after IMPL-EVAL F2: generated workers/sagas/triggers forward NETSCRIPT_CHILD_HEALTH_HOSTNAME as the existing native hostname option. Unset retains loopback, including generated Aspire host executables. Containers explicitly request 0.0.0.0. No generic HOSTNAME fallback and no new service hostname behavior. All three generated artifacts have a native bind plus non-loopback HTTP regression. - Cycle one IMPL-EVAL FAIL_FIX is preserved. F1 waits on supported-runner runtime evidence; the hostname repair requires a new final-head CI run and a new evaluator session under T3 re-check policy. + + +## Native supported-runner restart evidence + +Full S4 gate remains unresolved at a native web-resource restart. To stop discarding the only decisive diagnostic, minimally include native exit code plus stderr/stdout fallback in the existing CLI refresh error, with two red-before/green-after tests. No retry/bypass/resource-target changes, no new command/API. This is bounded S4 failure diagnosis within the required full-runtime gate, not a new lifecycle design. Two CLI files plus run evidence, below30files. No new local smoke attempt on the unsupported Docker host. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 1b00433017..f671e6b5ef 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -96,3 +96,20 @@ Added generated-hostname subprocess tests executing all three emitted entrypoint Hostname repair gates: structured changed-file check/lint/fmt pass with zero diagnostics/findings; release:preflight and docs:accuracy pass. Source-derived child health page regenerated. Hostname repair consumer refresh: canonical agent-docs prose/site build, export corpus (documented --allow-dirty for the sole regenerated prose carrier), CLI assets and publish assets completed. Export and publish freshness checks pass. No lock changes or additional CLI embedded diff. Final-head supported runtime CI is requested after this consumer commit. + + +## Supported runtime CI failure and targeted cleanup control + +Supported-runner head a142ac632 dispatch https://github.com/rickylabs/netscript/actions/runs/43929577301 passed the documented skip-seed-handoff behavior control with resident worker preserved, then failed in native Aspire persistent-resource cleanup (one persistent resource reported failed). Post-stop owned-survivor assertion did not fail; terminal native stop exit remained nonzero, so the gate correctly stayed red. This is not counted as a runtime PASS. + +A targeted native cleanup control on the already-generated owned diagnostic AppHost reproduced the same normal-stop plus forced exact-AppHost-stop sequence without a port bridge: both native commands exit0, no owned containers in the final probe. Teardown preview preceded it and all commands target the exact owned AppHost. This does not reproduce the CI cleanup error and does not justify weakening cleanup assertions or forcing a product change. Requested one failed-job re-run with native workflow debug logging at the same head to obtain a terminal verdict and more diagnostics if it recurs. No full local scaffold.runtime repeated. + + +## Supported-runner baseline comparison + +Unchanged main comparison [43936107382](https://github.com/rickylabs/netscript/actions/runs/43936107382) passes the Postgres runtime suite but fails SQLite at the same database.generate web-resource restart as the candidate's Postgres retry. Both generate the client and refresh the users consumer before native Aspire resource restart returns nonzero. The candidate's SQLite suite passes. This establishes that the restart symptom also occurs without the lifecycle changes; no unrelated product change or weakened gate is justified. Cleanup passes on both comparison runs. One additional failed-job run at unchanged final candidate head is justified by this crossed baseline result; a complete supported Postgres verdict remains mandatory. + + +## S4 native restart diagnostic control + +Supported candidate Postgres run continues to fail database.generate at web-resource restart after55passing gates; cleanup passes. Main SQLite comparison reproduces the same symptom, while main/Garnet Postgres passes. No product cause is inferred from this crossed evidence. The refresh command discards the native restart exit code/stdout/stderr, preventing diagnosis. Add two genuine red tests on the unchanged-main CLI error path (stderr and stdout fallback); both fail because the native detail is lost. Minimal repair preserves Aspire exit code and diagnostic, retaining the scoped manual remedy. Full adjacent refresh suite14/14 passes, scoped typecheck/quality:cli/release:preflight/docs:accuracy pass. This changes failure observability only; lifecycle/drain contract and runtime gates intact. One new supported final-head smoke is required to obtain the decisive native error or a complete pass; no blind rerun or weakened gate. diff --git a/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers.ts b/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers.ts index a07274ef78..2aac7bcdee 100644 --- a/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers.ts +++ b/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers.ts @@ -108,7 +108,12 @@ async function refreshConsumers(options: RefreshGeneratedClientConsumersOptions) commandOptions, ); if (restarted.code !== 0) { - throw new Error(`Database client generated, but ${name} restart failed. Run: ${remedy}`); + const diagnostic = restarted.stderr.trim() || restarted.stdout.trim(); + throw new Error( + `Database client generated, but ${name} restart failed (Aspire exit ${restarted.code}). ${ + diagnostic ? `${diagnostic}\n` : '' + }Run: ${remedy}`, + ); } options.refreshed.add(name); const healthy = await options.executor.output([ diff --git a/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers_test.ts b/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers_test.ts index e4abe88e24..efad6c77f0 100644 --- a/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers_test.ts +++ b/packages/cli/src/kernel/adapters/database/operations/refresh-generated-client-consumers_test.ts @@ -409,3 +409,32 @@ Deno.test('app restart and health failures propagate the exact scoped remedy', a } } }); + +for (const diagnosticStream of ['stderr', 'stdout'] as const) { + Deno.test(`consumer restart failure retains Aspire exit code and ${diagnosticStream}`, async () => { + const f = await fixture(); + const diagnostic = 'Native restart detail: child stop exceeded its process timeout.'; + const executor: RefreshGeneratedClientConsumersOptions['executor'] = { + ...f.options.executor, + output: (args, command) => + args[2] === 'restart' + ? Promise.resolve({ + code: 17, + stdout: diagnosticStream === 'stdout' ? diagnostic : '', + stderr: diagnosticStream === 'stderr' ? diagnostic : '', + }) + : f.options.executor.output(args, command), + }; + try { + const error = await assertRejects( + () => refreshGeneratedClientConsumers({ ...f.options, executor }), + Error, + diagnostic, + ); + assertEquals(error.message.includes('exit 17'), true); + assertEquals(error.message.includes('aspire resource orders restart --apphost'), true); + } finally { + await Deno.remove(f.root, { recursive: true }); + } + }); +} From 582372c4a3f160ea6b944c1ace574ab9a5c6ba67 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 22:12:00 +0100 Subject: [PATCH 16/19] docs(harness): record complete supported shutdown runtime verdict --- .../context-pack.md | 2 ++ .../fix-runtime-child-drain--issues-2630-2631/worklog.md | 5 +++++ 2 files changed, 7 insertions(+) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index 6efc9235e4..c746db6048 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -16,3 +16,5 @@ Next: dispatch supported CI runtime on this branch, independent feature-tier IMP IMPL-EVAL cycle one FAIL_FIX (evaluate.md): F1 full supported-runner runtime verdict pending; F2 generated hostname delivery missing. F2 repaired by forwarding NETSCRIPT_CHILD_HEALTH_HOSTNAME from all three generated launchers to the native option. Regression: base 3/6 fails on defaults; pre-repair PR 3/6 fails on ignored override; repaired 6/6 pass with real native bind and non-loopback HTTP. Combined installed artifact suite31/31. New source/docs/carriers must be pushed, then supported CI run at final head and cycle-two independent evaluation. + +S4FULLPASS: supported workflow43951994678 SUCCESS atd6ef1fa71: PG124/124, SQLite116/116+showcase8/8, static/native/cleanupallpass. F1resolved. F2alreadyfixed6/6generatedbind plusinstalled31/31, actualnonloopbackHTTPoverride and fullAspirehealthready200. Native restart error diagnostic2red->green, fulladjacent14/14, allsmallgatespass. No unproven product fix for the intermittent native restart symptom. Final proof comment6929449167. Evidence-only commit before cycle2 independent IMPL-EVAL required; preserve oldFAIL_FIX history. No source change after greenfullsmoke. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index f671e6b5ef..48f00ea34e 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -113,3 +113,8 @@ Unchanged main comparison [43936107382](https://github.com/rickylabs/netscript/a ## S4 native restart diagnostic control Supported candidate Postgres run continues to fail database.generate at web-resource restart after55passing gates; cleanup passes. Main SQLite comparison reproduces the same symptom, while main/Garnet Postgres passes. No product cause is inferred from this crossed evidence. The refresh command discards the native restart exit code/stdout/stderr, preventing diagnosis. Add two genuine red tests on the unchanged-main CLI error path (stderr and stdout fallback); both fail because the native detail is lost. Minimal repair preserves Aspire exit code and diagnostic, retaining the scoped manual remedy. Full adjacent refresh suite14/14 passes, scoped typecheck/quality:cli/release:preflight/docs:accuracy pass. This changes failure observability only; lifecycle/drain contract and runtime gates intact. One new supported final-head smoke is required to obtain the decisive native error or a complete pass; no blind rerun or weakened gate. + + +## S4 supported runtime complete + +[Workflow43951994678](https://github.com/rickylabs/netscript/actions/runs/43951994678) SUCCESS at sourceheadd6ef1fa71. Postgres124/124, SQLite116/116 plus showcase8/8, scaffold-static and desktop-native all succeed with cleanup assertions intact. Earlier native web-restart symptom also reproduced on main's SQLite lane; no new runtime root cause was established and no retry/bypass added. Native exit/detail preservation remains covered by two genuine red->green tests and adjacent14/14refresh cases. Both cycle-one evaluator findings now repaired: F1full supported smoke green; F2generated hostname forwarding6/6, installed31/31 plus full generated-health readiness200. All7issue acceptance boxes have final linked proof. Next independent feature IMPL-EVAL cycle2 at evidence-only followup head; production unchanged from green sourced6ef1fa71. From faeb05b976aa5b67bb3a86d9ddc817b292be973a Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 22:29:46 +0100 Subject: [PATCH 17/19] docs(harness): retain independent bounded shutdown approval --- .../context-pack.md | 2 + .../evaluate.md | 118 ++++++++++++++++++ .../worklog.md | 5 + 3 files changed, 125 insertions(+) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md index c746db6048..f773702e7b 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/context-pack.md @@ -18,3 +18,5 @@ Next: dispatch supported CI runtime on this branch, independent feature-tier IMP IMPL-EVAL cycle one FAIL_FIX (evaluate.md): F1 full supported-runner runtime verdict pending; F2 generated hostname delivery missing. F2 repaired by forwarding NETSCRIPT_CHILD_HEALTH_HOSTNAME from all three generated launchers to the native option. Regression: base 3/6 fails on defaults; pre-repair PR 3/6 fails on ignored override; repaired 6/6 pass with real native bind and non-loopback HTTP. Combined installed artifact suite31/31. New source/docs/carriers must be pushed, then supported CI run at final head and cycle-two independent evaluation. S4FULLPASS: supported workflow43951994678 SUCCESS atd6ef1fa71: PG124/124, SQLite116/116+showcase8/8, static/native/cleanupallpass. F1resolved. F2alreadyfixed6/6generatedbind plusinstalled31/31, actualnonloopbackHTTPoverride and fullAspirehealthready200. Native restart error diagnostic2red->green, fulladjacent14/14, allsmallgatespass. No unproven product fix for the intermittent native restart symptom. Final proof comment6929449167. Evidence-only commit before cycle2 independent IMPL-EVAL required; preserve oldFAIL_FIX history. No source change after greenfullsmoke. + +Cycle2IMPL-EVAL PASS582372c4a, comment6929922874, all7acceptance verified and both earlierfindings resolved. Independent6/6bind+4/4realRedis, fullsupported124/116+8, static/fitness/docsbaseline allgreen. CurrentdraftrequiredpolicySkip/threads0. Verdict-retention commit onlyrunartifacts; ready transition and final head checks next. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md index 549b21843d..ff11305c1f 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md @@ -116,3 +116,121 @@ No implementation logic defect was found in the reviewed edges: monotonic total | --- | --- | | Verdict | `FAIL_FIX` | | Rationale | Plan remains valid and the reviewed lifecycle, ownership, and OTel changes match the approved contracts with static and focused gates green, but the release-gate class has no supported-runner green verdict and generated non-loopback health coverage has no evidence; both are required remedies, not a plan or debt failure. PR phase comment is therefore `CHANGES_REQUESTED`. | + +## Cycle two — current verdict (2026-11-16) + +Cycle-one `FAIL_FIX` history above is preserved. This cycle independently re-evaluates the current head after both F1/F2 repairs. + +### Metadata (cycle two) + +| Field | Value | +| --- | --- | +| Run ID | `fix-runtime-child-drain--issues-2630-2631` | +| Target | PR 2641, issues #2630/#2631 | +| Archetype | 3 runtime/behavior primary, plugin/CLI and service overlays | +| Scope overlays | `SCOPE-service.md`, `SCOPE-docs.md` | +| Evaluator | Separate session from generator; requested `muse_spark_1_3/xhigh`, observed `opencode-go/muse-spark-1.3-contributor`; generator is the owner-selected Codex `gpt-6.1-sol/xhigh` session; different session and different vendor family; no substitution; fallback `opus_5/xhigh` not used | +| Branch | `fix/runtime-child-drain` | +| Exact head evaluated | `582372c4a3f160ea6b944c1ace574ab9a5c6ba67` | +| Base | `origin/main b0eb079575968e843b781579673c9fe2ae250e07` | +| Green-smoke source head | `d6ef1fa71` (workflow 43951994678 SUCCESS); `git diff d6ef1fa71..HEAD -- packages plugins docs` exits 0, current head changes only 2 run files | +| Date | 2026-11-16 | + +### Process Verification (cycle two) + +| Check | Result | Evidence | +| --- | --- | --- | +| Plan-Gate passed before implementation | PASS | `.llm/runs/fix-runtime-child-drain--issues-2630-2631/plan-eval.md` cycle two `PASS`; PR comment `6923762411` | +| Design section exists in worklog | PASS | `.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md` `## Design` names public surface, lifecycle, contributor path, gate plan | +| Commit slices match design plan | PASS | Plan S1/S2/S3a/S3b/S4 order preserved; S4 native restart diagnostic control and supported-runtime complete recorded in worklog | +| Each slice has a passing gate | PASS | Worklog per-slice gates plus cycle-two independent reruns below | +| No speculative seams | PASS | New files trace to database identity-disposal seam and subprocess/control tests; no generic lifecycle registry; no saga transport changes; no Redis Streams dependency | +| Constants used for finite vocabularies | PASS | Exit codes 0/1/2 computed in one place per edge (`packages/plugin/src/presentation/run-child-health-process.ts`, `packages/service/src/builder/service-listener.ts`); no stringly exit-code spread | + +### Static Gates (cycle two, independent) + +| Gate | Command or check | Result | Evidence | Notes | +| --- | --- | --- | --- | --- | +| Narrow typecheck | structured check wrapper, service root | PASS | Independent run: 131 files selected, 0 diagnostics | Pinned Deno 2.9.7 with unstable-kv | +| Slice typecheck | structured check wrapper, child presentation root | PASS | Independent run: 4 files, 0 diagnostics | Same toolchain | +| Format | structured fmt wrapper, service root | PASS | Independent run: 131 files, 0 findings | Scoped TS only | +| Lint | structured lint wrapper, service root | PASS | Independent run: 131 files, 0 findings | Scoped TS only | +| Quality gate | `deno task quality:gate` | PASS | Independent run exit 0; A13 `Deno.exit` warnings present on intentional process edges | Same warning set as cycle one; intentional per approved plan | +| Architecture fitness | `deno task arch:check` | PASS | Independent run exit 0 | Same warning set as quality gate | +| Service doc lint | structured doc-lint wrapper, service full export map | PASS | Independent run: combined 0 diagnostics across entrypoints | Matches reported clean claim | +| Plugin/telemetry doc lint | structured doc-lint wrapper | PASS (pre-existing baseline) | Independent run: plugin 18 private-type, telemetry 7 (6 private-type + 1 missing JSDoc); changed health/SDK entrypoints clean | Matches disclosed base distributions; untouched entrypoints diff empty vs base; not new debt | +| Docs accuracy | `deno task docs:accuracy` | PASS | Independent run PASS | — | +| Release preflight | `deno task release:preflight` | PASS | Independent run: text-imports, import-attributes, file-url-import-meta, self-imports all PASS | — | +| JSR audit | reported only | PASS (reported, baseline unchanged) | Service/telemetry/CLI pass with existing warnings; plugin dry-run succeeds with 3 missing module tags in untouched entrypoints | Prior evaluator accepted these baselines; retained as disclosed, not hidden or broadened | + +### Fitness Gates (cycle two) + +| Gate | Function | Result | Evidence | Violations | +| --- | --- | --- | --- | --- | +| F-1 | File-size lint | PASS | quality:gate exit 0 | None introduced | +| F-2 | Helper-reinvention scan | PASS | quality:gate exit 0 | Callback contracts and existing hooks preferred; no new registry | +| F-3 | Layering check | PASS | quality:gate and arch:check exit 0 | Builder/listener/coordinator split retained | +| F-4 | Inheritance audit | PASS | quality:gate exit 0 | No new base-class coupling | +| F-5/F-6 | Public surface / JSR | PASS (pre-existing baseline) | Plugin 3 missing module tags in untouched entrypoints, diff empty vs base | No new export-shape violation in changed options (`ChildHealthProcessOptions`, `ServeOptions`, `PluginServiceContext.dispose`) | +| F-13 | Saga and runtime invariants | PASS | No changes under `packages/plugin-sagas-core/src/transports/` (`git diff --exit-code` clean); no Redis Streams dependency | Hard restriction honored | + +Remaining fitness rows inherit the quality:gate/arch:check PASS; no new `any`, no new blanket lint ignores, and no host-side hardcoded plugin coupling were introduced in the reviewed diff. + +### Runtime Gates (cycle two, independent) + +| Gate | Validation | Result | Evidence | +| --- | --- | --- | --- | +| Generated hostname forwarding (F2 repair) | Actual generated workers/sagas/triggers entrypoints with native Deno preload observing `server.addr` and real HTTP | PASS (independent) | Structured wrapper exit 0, 6/6 pass (`packages/plugin/tests/health/generated-hostname_test.ts`); all 3 stubs forward `NETSCRIPT_CHILD_HEALTH_HOSTNAME` to native `hostname` option; default retains loopback; explicit override probes a real non-loopback interface; 503 in this isolated bind test is intentional (bootstrap deliberately invalid) and proves bind/reachability | +| Child/service Redis subprocess regressions (F1-related lifecycle) | Real isolated Redis clean plus hung work, child and service | PASS (independent) | Structured wrapper exit 0, 4/4 pass (`packages/plugin/src/presentation/run-child-health-process_exit_test.ts`, `packages/service/tests/signal-exit_test.ts` with `NETSCRIPT_TEST_REDIS_URL` against owned isolated Redis; exit 0 clean / 2 timeout observed); owned container created with unique label, verified by immutable ID before stop/remove, zero own survivors, foreign resources untouched | +| Full supported one-pass scaffold.runtime (F1 repair) | `deno task e2e:cli run scaffold.runtime --cleanup --format pretty` on a supported runner | PASS (verified, same production source) | Workflow 43951994678 SUCCESS at source `d6ef1fa71`; Postgres 124/124, SQLite 116/116 plus showcase 8/8, scaffold-static and desktop-native success, cleanup assertions intact; current head production/tests/docs identical to that source (`git diff` exits 0, only 2 run files differ); no guard bypass, retry, target, cleanup or lifecycle-gate change; no new unproven runtime root-cause fix | +| Full structured service/plugin suite | Reported full suite | PASS (reported, currency preserved) | 820 pass / 0 fail / 4 optional Redis separately 4/4 pass with owned real Redis; generated acquired/unused/duplicate owner 37/37; installed hostname 31/31; native restart error-path 2 red->green plus adjacent refresh 14/14; no evidence of generated behavior change after green source head, so no expensive full rerun required | + +### Consumer Gates (cycle two) + +| Consumer | Validation | Result | Evidence | +| --- | --- | --- | --- | +| Generated container/Aspire health | Non-loopback child health reachability plus full Aspire generated-role health | PASS | F2 6/6 live bind/HTTP plus complete supported smoke confirming actual generated role health/readiness 200; Aspire host executables retain loopback by default, containers explicitly widen via environment | +| Docs consumers | Source-derived child-health docs plus MCP/CLI carriers | PASS | `docs/site/orchestration-runtime/child-health.md` regenerated from public JSDoc with loopback/hostname, budgets, exit codes; agent prose/site, export corpus, publish assets freshness passes reported plus docs:accuracy/preflight independent PASS above | + +### Anti-Pattern Check (cycle two) + +Only rows the run scope touches are marked `CLEAR`; the rest are `N/A`. + +| AP | Status | Evidence | Notes | +| --- | --- | --- | --- | +| AP-1 | CLEAR | Small focused modules; no generic utils folder added | — | +| AP-5 | CLEAR | No new inheritance; composition via callbacks and existing hooks | — | +| AP-13 | CLEAR | `Deno.exit` confined to process-owned signal paths with documented 0/1/2 codes; `exitOnShutdown`/`exitOnSignal:false` paths leave hosts alone | A13 scanner warns, quality gate still exits 0; intentional per approved plan | +| AP-20 | CLEAR | No Redis Streams dependency; transport directory untouched | Hard restriction honored | +| Others in scope | CLEAR/N/A | No new registry, no lazy-resolve-on-close in disposal paths, manual stop and external abort retain host ownership | — | + +### Arch-Debt Delta (cycle two) + +| Metric | Count | Evidence | +| --- | --- | --- | +| New entries | 0 | No new doctrine violation requiring registration | +| Resolved entries | 0 | No entry claimed closed | +| Deepened violations | 0 | KV god-test debt untouched; only `closeKv()` called from composition roots, KV package unmodified | +| Unrecorded violations | 0 | OTel standalone behavior change documented and carried in docs scope | + +### Findings (cycle two) + +| Severity | Finding | Evidence | Required action | +| --- | --- | --- | --- | +| low | Draft-head CI lanes show skipping with only docs/build lanes green | Draft `status:impl-eval` head shows expected skipping; decisive green is the supported workflow at identical production source | No code action; parent transitions readiness after this verdict; do not change labels/readiness in this lane | + +No high/medium findings remain. Both cycle-one findings are repaired and independently verified rather than trusted. + +### Lessons for Promotion (cycle two retained) + +| Lesson | Pattern | Applies to | Confidence | +| --- | --- | --- | --- | +| Remote-Docker loopback is not a green smoke | Temporary bridges can prove native readiness yet still fail maintained topology guards | release-gate runs | high | +| Explicit hostname without generated wiring leaves container coverage open | Child default change needs glue forwarding or probe evidence in the same slice | runtime edges | medium | + +### Verdict (cycle two) + +| Field | Value | +| --- | --- | +| Verdict | `PASS` | +| Rationale | Approved scope complete; static/fitness gates pass with pre-existing doc/JSR baselines disclosed; runtime and consumer gates have independent plus supported-runner evidence (F1 full smoke green on identical production source, F2 generated forwarding 6/6 live plus full Aspire health 200); no unrecorded doctrine violation; docs and run artifacts sufficient for resume. Final current-head/threads Definition-of-Done intentionally awaits parent transition after this verdict. | diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 48f00ea34e..25c147ab33 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -118,3 +118,8 @@ Supported candidate Postgres run continues to fail database.generate at web-reso ## S4 supported runtime complete [Workflow43951994678](https://github.com/rickylabs/netscript/actions/runs/43951994678) SUCCESS at sourceheadd6ef1fa71. Postgres124/124, SQLite116/116 plus showcase8/8, scaffold-static and desktop-native all succeed with cleanup assertions intact. Earlier native web-restart symptom also reproduced on main's SQLite lane; no new runtime root cause was established and no retry/bypass added. Native exit/detail preservation remains covered by two genuine red->green tests and adjacent14/14refresh cases. Both cycle-one evaluator findings now repaired: F1full supported smoke green; F2generated hostname forwarding6/6, installed31/31 plus full generated-health readiness200. All7issue acceptance boxes have final linked proof. Next independent feature IMPL-EVAL cycle2 at evidence-only followup head; production unchanged from green sourced6ef1fa71. + + +## Independent cycle-two implementation approval + +[MuseSpark1.3/xhigh IMPL-EVAL PASS](https://github.com/rickylabs/netscript/pull/2641#issuecomment-6929922874) at582372c4a, observed requested OpenCode Go primary route, separate family/session from OpenAI generator. F1/F2 both independently verified: supported full124/116+8smoke, generatedhostname6/6 and owned realRedis subprocess4/4. Independent service131filecheck/child4filecheck/lint/fmt/quality/architecture/preflight/accuracy pass; service doclint0/plugin18/telemetry7 baseline unchanged. All7acceptance boxes and4+3evidence mapping verified. Current draft required checks policy-skipped; threadgate0/0. Retain verdict and transition ready, then confirm current head required gates. No production change after green source d6ef1fa71, no merge/ready-merge/publication. From 212a8d39463b89a11551dff7e8b8f036a899e302 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 22:45:40 +0100 Subject: [PATCH 18/19] fix(service): keep signal disposers independent of work hook types --- .../fix-runtime-child-drain--issues-2630-2631/drift.md | 5 +++++ .../fix-runtime-child-drain--issues-2630-2631/worklog.md | 5 +++++ packages/service/src/types.ts | 8 ++++++-- 3 files changed, 16 insertions(+), 2 deletions(-) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md index 833f789603..f96ce65d11 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/drift.md @@ -25,3 +25,8 @@ ## Native supported-runner restart evidence Full S4 gate remains unresolved at a native web-resource restart. To stop discarding the only decisive diagnostic, minimally include native exit code plus stderr/stdout fallback in the existing CLI refresh error, with two red-before/green-after tests. No retry/bypass/resource-target changes, no new command/API. This is bounded S4 failure diagnosis within the required full-runtime gate, not a new lifecycle design. Two CLI files plus run evidence, below30files. No new local smoke attempt on the unsupported Docker host. + + +## Ready-transition public type closure repair + +Current CI shard1 receipt (workflow43960706867, job133627460342) reports786pass/1fail/9ignored: the existing workers non-contract doc-lint test exposes ServeOptions.onCleanup reaching private ShutdownHook through the worker facade. Reproduced that existing test locally red before fixing. Cleanup is always the process-owned signal disposal phase and needs no reason argument: narrow the new onCleanup contract to zero-argument disposers, leaving reason-aware work hooks on onShutdown. This avoids increasing the separately bounded workers/streams native type closure debt. No executable control flow, generated launch or budget changes. Existing worker public contract suite plus service resource ownership tests7/7green; scoped type check/lint/fmt0; release:preflight/docs:accuracyPASS. Supported full smoke and independent cycle2 remain behavior evidence because the delta is type/JSDoc only. Refresh generated documentation carriers before final head CI confirmation. diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 25c147ab33..84ac9d9ee2 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -123,3 +123,8 @@ Supported candidate Postgres run continues to fail database.generate at web-reso ## Independent cycle-two implementation approval [MuseSpark1.3/xhigh IMPL-EVAL PASS](https://github.com/rickylabs/netscript/pull/2641#issuecomment-6929922874) at582372c4a, observed requested OpenCode Go primary route, separate family/session from OpenAI generator. F1/F2 both independently verified: supported full124/116+8smoke, generatedhostname6/6 and owned realRedis subprocess4/4. Independent service131filecheck/child4filecheck/lint/fmt/quality/architecture/preflight/accuracy pass; service doclint0/plugin18/telemetry7 baseline unchanged. All7acceptance boxes and4+3evidence mapping verified. Current draft required checks policy-skipped; threadgate0/0. Retain verdict and transition ready, then confirm current head required gates. No production change after green source d6ef1fa71, no merge/ready-merge/publication. + + +## Ready-transition public type closure repair + +Current CI shard1 receipt (workflow43960706867, job133627460342) reports786pass/1fail/9ignored: the existing workers non-contract doc-lint test exposes ServeOptions.onCleanup reaching private ShutdownHook through the worker facade. Reproduced that existing test locally red before fixing. Cleanup is always the process-owned signal disposal phase and needs no reason argument: narrow the new onCleanup contract to zero-argument disposers, leaving reason-aware work hooks on onShutdown. This avoids increasing the separately bounded workers/streams native type closure debt. No executable control flow, generated launch or budget changes. Existing worker public contract suite plus service resource ownership tests7/7green; scoped type check/lint/fmt0; release:preflight/docs:accuracyPASS. Supported full smoke and independent cycle2 remain behavior evidence because the delta is type/JSDoc only. Refresh generated documentation carriers before final head CI confirmation. diff --git a/packages/service/src/types.ts b/packages/service/src/types.ts index 829245b559..f582f2e611 100644 --- a/packages/service/src/types.ts +++ b/packages/service/src/types.ts @@ -211,8 +211,12 @@ export interface ServeOptions { /** Reserved process cleanup budget within drainTimeoutMs; defaults to min(5_000, one fifth). */ cleanupTimeoutMs?: number; - /** Owned resource cleanup hooks, run on process-owned signals even when work drain times out. */ - onCleanup?: readonly ShutdownHook[]; + /** + * Owned resource disposers, run on process-owned signals even when work drain times out. + * These zero-argument callbacks always run in the signal cleanup phase; use onShutdown + * for work hooks that need a shutdown reason. + */ + onCleanup?: readonly (() => Promise | void)[]; /** Set false when onCleanup already owns database disposal; defaults to true. */ disposeDatabaseOnSignal?: boolean; From 02711c97ff88c79d408e21f780d7c0b5530c8c2c Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 23:08:10 +0100 Subject: [PATCH 19/19] docs(harness): retain final runtime type-closure approval --- .../evaluate.md | 52 +++++++++++++++++++ .../worklog.md | 5 ++ 2 files changed, 57 insertions(+) diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md index ff11305c1f..9887eb84f7 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/evaluate.md @@ -234,3 +234,55 @@ No high/medium findings remain. Both cycle-one findings are repaired and indepen | --- | --- | | Verdict | `PASS` | | Rationale | Approved scope complete; static/fitness gates pass with pre-existing doc/JSR baselines disclosed; runtime and consumer gates have independent plus supported-runner evidence (F1 full smoke green on identical production source, F2 generated forwarding 6/6 live plus full Aspire health 200); no unrecorded doctrine violation; docs and run artifacts sufficient for resume. Final current-head/threads Definition-of-Done intentionally awaits parent transition after this verdict. | + +## Cycle three — narrow ready-transition type-closure follow-up (2026-11-16) + +Prior cycles preserved above. Cycle two PASS at `582372c4a` remains authoritative for all unchanged +runtime behavior. This cycle evaluates only the delta `582372c4..212a8d39`. + +### Metadata (cycle three) + +| Field | Value | +| --- | --- | +| Run ID | `fix-runtime-child-drain--issues-2630-2631` | +| Target | PR 2641, issues #2630/#2631 | +| Tier / role | `feature` / `IMPL-EVAL` | +| Requested route | `muse_spark_1_3/xhigh` via OpenCode Go, no substitution | +| Observed evaluator identity | `opencode-go/muse-spark-1.3-contributor` (T3 Code OpenCode harness); separate session from generator; no subagents launched | +| Generator | Owner-selected Codex `gpt-6.1-sol/xhigh` session; different vendor family from evaluator; fallback `opus_5/xhigh` not used | +| Matrix authority | `.llm/harness/workflow/lane-policy.md` feature row: IMPL-EVAL `Muse Spark 1.3 xhigh` primary, `Opus 5 xhigh` fallback; verified via `deno task agentic:matrix --tier feature --impl-evaluator` | +| Branch | `fix/runtime-child-drain` | +| Exact head evaluated | `212a8d39463b89a11551dff7e8b8f036a899e302` | +| Delta scope | `582372c4a3f160ea6b944c1ace574ab9a5c6ba67..212a8d39463b89a11551dff7e8b8f036a899e302`: production change is `packages/service/src/types.ts` only (8 lines: `ServeOptions.onCleanup` narrowed with clarifying JSDoc); plus run-only `context-pack.md`/`drift.md`/`worklog.md` notes; `git diff d6ef1fa71..HEAD -- packages plugins docs` shows only that `types.ts` hunk | +| Green-smoke source head | `d6ef1fa71` (workflow 43951994678 SUCCESS) remains the executable behavior evidence; production source identical except the type/JSDoc hunk; no expensive scaffold rerun per scope | +| Date | 2026-11-16 | + +### Delta verification (cycle three) + +| Check | Result | Independent evidence | +| --- | --- | --- | +| Contract justification | PASS | Ready-transition shard1 (workflow 43960706867 job 133627460342, 786 pass / 1 fail / 9 ignored) exposed the existing workers non-contract doc-lint test (`plugins/workers/tests/public/type-refs_test.ts`) reaching private `ShutdownHook` through the worker `./service` facade, which re-exports `ServeOptions` as part of its 23-symbol accepted F-5 closure. Narrowing new `onCleanup` to `readonly (() => Promise \| void)[]` removes the named private-type reach without adding facade exports or growing the bounded debt. `ShutdownHook` remains exported and still serves reason-aware `onShutdown` work hooks. | +| Caller compatibility | PASS | Repo-wide `onCleanup` producers are all zero-arg: `plugins/workers/services/src/main.ts`, `plugins/sagas/services/src/main.ts`, `plugins/auth/services/src/auth-service-runtime.ts` pass `ctx.dispose` (`() => Promise`), and `packages/service/tests/service-resources_test.ts` passes `() => db.$disconnect()`. Internal `service-listener.ts` spreads `options?.onCleanup` into `ShutdownHook[]` cleanups (zero-arg assignable to one-arg) and invokes via `hook({reason, signal})`, which is a runtime no-op extra arg; `service-shutdown.ts` cleanup path unchanged. No control-flow, launch, budget, or drain change. | +| Focused tests | PASS | Structured wrapper `run-deno-test.ts -- --allow-all plugins/workers/tests/public/type-refs_test.ts packages/service/tests/service-resources_test.ts`: exit 0, 7 passed / 0 failed (matches generator 7/7) | +| Scoped typecheck / lint / fmt | PASS | `run-deno-check.ts --root packages/service/src --ext ts,tsx`: 74 files, 0 diagnostics; `run-deno-lint.ts`: 74 files, 0 findings; `run-deno-fmt.ts`: 74 files, 0 findings; pinned `deno 2.9.7` via `mise exec deno@2.9.7` | +| Doc lint | PASS | `run-deno-doc-lint.ts --root packages/service`: combined 0; `--root plugins/workers`: `./service` (`services/mod.ts`) and `./services` (`services/src/main.ts`) both 0 — the previously failing facade is now clean. Remaining 2 `privateTypeRef` sit in `plugin-workers-core` contracts, which the public test explicitly excludes per #1655; not new debt. | +| Release / docs accuracy | PASS | `deno task docs:accuracy` PASS; `deno task release:preflight` text-imports / import-attributes / file-url-import-meta / self-imports all PASS; no `packages`/`plugins`/`docs` carrier diff beyond `types.ts`, so no regeneration churn | +| Current head CI / threads / acceptance | PASS (verified) | `gh pr checks 2641`: 22 pass / 13 skipping / 0 fail (35 rows); `check:review-threads --pr 2641`: `threads=0 unanswered=0`; issues #2630 (4 boxes) and #2631 (3 boxes) all checked; PR body carries fenced `acceptance-evidence` for all 7 boxes; prior cycle-two PASS comment 6929922874, repair proof 6930509981, head report 6930661054 present | + +### Findings (cycle three) + +| Severity | Finding | Evidence | Required action | +| --- | --- | --- | --- | +| none | No blocking finding in this type-only delta | All narrow gates above green; no facade export added; no F-5 growth; no runtime change | None; parent may proceed with ready transition on this head | + +No new doctrine violation, no new `any`, no new blanket lint ignore, no layering change, and no +host-side hardcoded coupling were introduced. The `docs/site/reference/service/index.md` and +`packages/service/README.md` `onCleanup` prose remains accurate (cleanup attempted even when work +drain times out); the refined JSDoc correctly directs reason-aware hooks to `onShutdown`. + +### Verdict (cycle three) + +| Field | Value | +| --- | --- | +| Verdict | `PASS` | +| Rationale | Narrow, justified new-option contract fix: it closes the one CI-exposed public doc-lint diagnostic without widening the bounded worker type closure, preserves all owned-resource cleanup contracts and library integration for existing zero-arg disposers, and introduces no runtime, consumer, or type error. Cycle-two PASS remains the executable behavior authority; this delta needs no new scaffold smoke or Redis lifecycle rerun. | diff --git a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md index 84ac9d9ee2..8ec997251a 100644 --- a/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md +++ b/.llm/runs/fix-runtime-child-drain--issues-2630-2631/worklog.md @@ -128,3 +128,8 @@ Supported candidate Postgres run continues to fail database.generate at web-reso ## Ready-transition public type closure repair Current CI shard1 receipt (workflow43960706867, job133627460342) reports786pass/1fail/9ignored: the existing workers non-contract doc-lint test exposes ServeOptions.onCleanup reaching private ShutdownHook through the worker facade. Reproduced that existing test locally red before fixing. Cleanup is always the process-owned signal disposal phase and needs no reason argument: narrow the new onCleanup contract to zero-argument disposers, leaving reason-aware work hooks on onShutdown. This avoids increasing the separately bounded workers/streams native type closure debt. No executable control flow, generated launch or budget changes. Existing worker public contract suite plus service resource ownership tests7/7green; scoped type check/lint/fmt0; release:preflight/docs:accuracyPASS. Supported full smoke and independent cycle2 remain behavior evidence because the delta is type/JSDoc only. Refresh generated documentation carriers before final head CI confirmation. + + +## Final type closure independently approved + +Fresh separate-session [MuseSpark1.3/xhigh narrow IMPL-EVAL PASS](https://github.com/rickylabs/netscript/pull/2641#issuecomment-6930828469) at source212a8d39463b89a11551dff7e8b8f036a899e302. Independent public/resource7/7, service74file check/lint/fmt0, service doclint0 and worker service facade0, preflight/accuracyPASS. Prior full supported scaffold smoke and cycle2 remain authority for unchanged executable behavior. Current source head22SUCCESS/13SKIPPED, required checks pass/policy-skip, threadgate0/0. Retain cycle3 verdict with this evidence-only commit; production source unchanged. No merge, ready-merge or publication.