@mysten-incubation/devstack 0.0.1 → 0.1.1

package/dist/substrate/event-time.mjs

@@ -0,0 +1,33 @@
+//#region src/substrate/event-time.ts
+const eventAtOrNull = (event) => {
+	switch (event.tag) {
+		case "endpoint.registered": return event.endpoint.registeredAt;
+		case "error.reported": return event.error.at;
+		case "build.statusChanged": return event.entry.startedAt;
+		case "lifecycle.statusChanged":
+		case "lifecycle.phaseSet":
+		case "log.appended":
+		case "projection.updated":
+		case "endpoint.released":
+		case "strategy.registered":
+		case "strategy.unregistered":
+		case "manifest.flushed":
+		case "codegen.emitted":
+		case "restart.requested":
+		case "restart.completed":
+		case "shutdown.escalated":
+		case "snapshot.captureStarted":
+		case "snapshot.captureProgress":
+		case "snapshot.captureSkipped":
+		case "snapshot.captureFailed":
+		case "snapshot.captured":
+		case "snapshot.restored":
+		case "engine.orchestrator.dispatchFailed": return event.at;
+		default: return null;
+	}
+};
+const eventAt = (event) => eventAtOrNull(event) ?? Date.now();
+//#endregion
+export { eventAt, eventAtOrNull };
+
+//# sourceMappingURL=event-time.mjs.map

package/dist/substrate/event-time.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-time.mjs","names":[],"sources":["../../src/substrate/event-time.ts"],"sourcesContent":["// Producer-time projection for `EngineEvent`.\n//\n// Every event variant carries an authoritative timestamp either at the\n// top level (`event.at`) or in a domain-specific nested field\n// (`endpoint.registered.endpoint.registeredAt`, `error.reported.error.at`,\n// `build.statusChanged.entry.startedAt`). The switch is intentionally\n// exhaustive so a newly-added variant must declare where its timestamp\n// lives — the compiler enforces it via the `never`-assignment default.\n//\n// Two shapes:\n//   - `eventAtOrNull` (substrate-layer consumers): returns `null` when\n//     the variant has no inherent timestamp, letting the caller fall\n//     back to whatever stale value preserves invariants (e.g. the\n//     projection update reducer keeps `state.lastEvent.at` on miss).\n//   - `eventAt` (UI consumers): wraps `eventAtOrNull` with a `Date.now()`\n//     fallback so log rendering always gets a number. Removing the\n//     historical dequeue-time fallback was load-bearing — under\n//     back-pressure (a queued event flushed late from the dispatcher)\n//     it back-dated or forward-dated the log entry, producing apparent\n//     event-time reordering in the rendered log. Pinning to the\n//     producer's record preserves the ordering tests assert.\n\nimport type { EngineEvent } from './events.ts';\n\nexport const eventAtOrNull = (event: EngineEvent): number | null => {\n\tswitch (event.tag) {\n\t\tcase 'endpoint.registered':\n\t\t\treturn event.endpoint.registeredAt;\n\t\tcase 'error.reported':\n\t\t\treturn event.error.at;\n\t\tcase 'build.statusChanged':\n\t\t\treturn event.entry.startedAt;\n\t\tcase 'lifecycle.statusChanged':\n\t\tcase 'lifecycle.phaseSet':\n\t\tcase 'log.appended':\n\t\tcase 'projection.updated':\n\t\tcase 'endpoint.released':\n\t\tcase 'strategy.registered':\n\t\tcase 'strategy.unregistered':\n\t\tcase 'manifest.flushed':\n\t\tcase 'codegen.emitted':\n\t\tcase 'restart.requested':\n\t\tcase 'restart.completed':\n\t\tcase 'shutdown.escalated':\n\t\tcase 'snapshot.captureStarted':\n\t\tcase 'snapshot.captureProgress':\n\t\tcase 'snapshot.captureSkipped':\n\t\tcase 'snapshot.captureFailed':\n\t\tcase 'snapshot.captured':\n\t\tcase 'snapshot.restored':\n\t\tcase 'engine.orchestrator.dispatchFailed':\n\t\t\treturn event.at;\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn null;\n\t\t}\n\t}\n};\n\nexport const eventAt = (event: EngineEvent): number => eventAtOrNull(event) ?? Date.now();\n"],"mappings":";AAwBA,MAAa,iBAAiB,UAAsC;AACnE,SAAQ,MAAM,KAAd;EACC,KAAK,sBACJ,QAAO,MAAM,SAAS;EACvB,KAAK,iBACJ,QAAO,MAAM,MAAM;EACpB,KAAK,sBACJ,QAAO,MAAM,MAAM;EACpB,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,qCACJ,QAAO,MAAM;EACd,QAGC,QAAO;;;AAKV,MAAa,WAAW,UAA+B,cAAc,MAAM,IAAI,KAAK,KAAK"}

package/dist/substrate/events.d.mts

@@ -1,6 +1,6 @@
 import { EndpointKey, PluginKey } from "./brand.mjs";
 import { LifecycleStatus, PhaseNarration } from "./lifecycle.mjs";
-import { AccountProjection, BuildEntry, Endpoint, PackageProjection, StructuredError } from "./projection.mjs";
+import { BuildEntry, Endpoint, StructuredError } from "./projection.mjs";
 
 //#region src/substrate/events.d.ts
 type ShutdownSignal = 'SIGINT' | 'SIGTERM';
@@ -27,12 +27,16 @@ type EngineEvent = {
   readonly tag: 'endpoint.registered';
   readonly endpoint: Endpoint;
 } | {
-  readonly tag: 'account.updated';
-  readonly account: AccountProjection;
-  readonly at: number;
-} | {
-  readonly tag: 'package.updated';
-  readonly package: PackageProjection;
+  /** Name-blind projection update. Plugins emit this with a
+   *  `kind` discriminator the L3 projection orchestrator (today:
+   *  the reducer in `runtime/projection/update.ts`) decodes
+   *  per-kind. Substrate stays unaware of which plugins produce
+   *  which projection shapes — the kind→decoder mapping is owned
+   *  by the consuming orchestrator. */
+  readonly tag: 'projection.updated';
+  readonly kind: string;
+  readonly key: string;
+  readonly payload: unknown;
   readonly at: number;
 } | {
   readonly tag: 'endpoint.released';
@@ -95,10 +99,12 @@ type EngineEvent = {
 } | {
   readonly tag: 'snapshot.captureSkipped';
   readonly reason: 'already-running';
+  readonly snapshotId: string;
+  readonly name?: string;
   readonly at: number;
 } | {
   readonly tag: 'snapshot.captureFailed';
-  readonly snapshotId?: string;
+  readonly snapshotId: string;
   readonly name?: string;
   readonly summary: string;
   readonly at: number;
@@ -111,6 +117,20 @@ type EngineEvent = {
   readonly tag: 'snapshot.restored';
   readonly snapshotId: string;
   readonly at: number;
+} | {
+  readonly tag: 'engine.orchestrator.dispatchFailed';
+  readonly pluginKey: PluginKey;
+  readonly kind: string;
+  readonly message: string;
+  /** Underlying-cause discriminator (the failing sink error's
+   *  `_tag`, e.g. `RouterBootFailed`) when one is recoverable
+   *  from the wrapped cause. Optional + additive: omitted when
+   *  the cause carries no tag, so the closed-sum vocabulary is
+   *  unchanged for consumers that ignore it. Surfaced so an
+   *  operator can tell WHICH orchestrator sink broke (dead RPC
+   *  routing vs codegen collision) without parsing the message. */
+  readonly causeType?: string;
+  readonly at: number;
 };
 //#endregion
 export { EngineEvent };

package/dist/substrate/identity.d.mts

@@ -5,7 +5,8 @@ import { AppName, ChainId, StackName } from "./brand.mjs";
 interface Identity {
   readonly app: AppName;
   readonly stack: StackName;
-  /** Resolved chain identifier from NetworkResolver. */
+  /** Resolved chain identifier — threaded through Context from the
+   *  Sui plugin's resolved mode + `DevstackOptions.network`. */
   readonly chain: ChainId;
 }
 //#endregion

package/dist/substrate/manifest.d.mts

@@ -1,7 +1,44 @@
-import { EndpointKey, PluginKey } from "./brand.mjs";
 import { Effect, Schema } from "effect";
+import * as _$effect_Cause0 from "effect/Cause";
 
 //#region src/substrate/manifest.d.ts
+declare const ManifestExtrasInvalid_base: Schema.Class<ManifestExtrasInvalid, Schema.TaggedStruct<"ManifestExtrasInvalid", {
+  readonly detail: Schema.String;
+}>, _$effect_Cause0.YieldableError>;
+/** Tagged failure when a plugin's manifest-extras contribution does
+ *  not resolve to a plain record. STYLE_GUIDE §2.2 — substrate (L0)
+ *  errors use `Schema.TaggedErrorClass`; downstream classifiers
+ *  `catchTag('ManifestExtrasInvalid', ...)` instead of sniffing the
+ *  message. */
+declare class ManifestExtrasInvalid extends ManifestExtrasInvalid_base {}
+declare const ManifestExtrasLookupError_base: Schema.Class<ManifestExtrasLookupError, Schema.TaggedStruct<"ManifestExtrasLookupError", {
+  readonly kind: Schema.Literals<readonly ["unknown-resource", "unresolved-resource"]>;
+  readonly resourceId: Schema.String;
+}>, _$effect_Cause0.YieldableError>;
+/** Tagged failure when a plugin's `extras` factory references a
+ *  resource the host cannot resolve — either the resource id is not
+ *  registered with the supervisor, or it has not produced a value
+ *  yet at the point the factory ran. Thrown synchronously from the
+ *  user-supplied `ctx.value(...)` closure; `resolveManifestExtras`
+ *  catches the throw and surfaces it as a typed failure so callers
+ *  classify via `catchTag('ManifestExtrasLookupError', ...)` rather
+ *  than die-cause inspection. */
+declare class ManifestExtrasLookupError extends ManifestExtrasLookupError_base {}
+/** Codegen metadata recorded per stack. The supervisor writes the
+ *  resolved absolute output dir here at manifest-flush time so the
+ *  read-side build integrations (the Vite plugin) point an `@generated`
+ *  alias at the EXACT dir codegen emitted into for THIS stack — read
+ *  and write share one decision (see
+ *  `orchestrators/codegen/output-location.ts`). Optional + additive:
+ *  manifests written before this field existed (and stacks that somehow
+ *  flush without it) still decode; consumers fall back to
+ *  `src/generated/`. */
+interface ManifestCodegen {
+  /** Absolute path to the directory codegen emitted into for this
+   *  stack (primary → `<appRoot>/src/generated`; secondary →
+   *  `<appRoot>/.devstack/stacks/<stack>/generated`). */
+  readonly generatedDir: string;
+}
 /** Manifest envelope. The `services` slot is open (`unknown`) at
  *  the envelope level; each plugin's Codegenable contribution
  *  emits a typed file the consumer imports for the typed shape.
@@ -16,6 +53,9 @@ interface ManifestEnvelope {
   readonly services: Readonly<Record<string, unknown>>;
   readonly endpoints: Readonly<Record<string, EndpointEntry>>;
   readonly extras: Readonly<Record<string, unknown>>;
+  /** Per-stack codegen metadata. Optional — absent in older
+   *  manifests; the reader falls back to `src/generated/`. */
+  readonly codegen?: ManifestCodegen;
 }
 type ManifestExtras = Readonly<Record<string, unknown>>;
 interface ManifestExtrasContext {
@@ -30,10 +70,33 @@ interface EndpointEntry {
   readonly name: string;
   readonly url: string;
   readonly displayUrl: string | null;
-  readonly wireProtocol: 'http' | 'h2c' | string;
-  readonly pluginKey: PluginKey;
-  readonly endpointKey: EndpointKey;
+  readonly wireProtocol: 'http' | 'h2c' | 'tcp';
+  readonly pluginKey: string;
+  readonly endpointKey: string;
 }
+/** Schema for runtime validation of an on-disk manifest. Build
+ *  integrations decode through this on read. */
+declare const ManifestEnvelopeSchema: Schema.Struct<{
+  readonly identity: Schema.Struct<{
+    readonly app: Schema.String;
+    readonly stack: Schema.String;
+    readonly chain: Schema.String;
+  }>;
+  readonly manifestVersion: Schema.Number;
+  readonly services: Schema.$Record<Schema.String, Schema.Unknown>;
+  readonly endpoints: Schema.$Record<Schema.String, Schema.Struct<{
+    readonly name: Schema.String;
+    readonly url: Schema.String;
+    readonly displayUrl: Schema.NullOr<Schema.String>;
+    readonly wireProtocol: Schema.Literals<readonly ["http", "h2c", "tcp"]>;
+    readonly pluginKey: Schema.String;
+    readonly endpointKey: Schema.String;
+  }>>;
+  readonly extras: Schema.$Record<Schema.String, Schema.Unknown>;
+  readonly codegen: Schema.optional<Schema.Struct<{
+    readonly generatedDir: Schema.String;
+  }>>;
+}>;
 //#endregion
-export { EndpointEntry, ManifestEnvelope, ManifestExtras, ManifestExtrasContext, ManifestExtrasInput };
+export { EndpointEntry, ManifestEnvelope, ManifestEnvelopeSchema, ManifestExtras, ManifestExtrasContext, ManifestExtrasInput, ManifestExtrasInvalid, ManifestExtrasLookupError };
 //# sourceMappingURL=manifest.d.mts.map

package/dist/substrate/manifest.mjs

@@ -1,10 +1,34 @@
 import { Effect, Schema } from "effect";
 //#region src/substrate/manifest.ts
+/** Tagged failure when a plugin's manifest-extras contribution does
+*  not resolve to a plain record. STYLE_GUIDE §2.2 — substrate (L0)
+*  errors use `Schema.TaggedErrorClass`; downstream classifiers
+*  `catchTag('ManifestExtrasInvalid', ...)` instead of sniffing the
+*  message. */
+var ManifestExtrasInvalid = class extends Schema.TaggedErrorClass()("ManifestExtrasInvalid", { detail: Schema.String }) {};
+/** Tagged failure when a plugin's `extras` factory references a
+*  resource the host cannot resolve — either the resource id is not
+*  registered with the supervisor, or it has not produced a value
+*  yet at the point the factory ran. Thrown synchronously from the
+*  user-supplied `ctx.value(...)` closure; `resolveManifestExtras`
+*  catches the throw and surfaces it as a typed failure so callers
+*  classify via `catchTag('ManifestExtrasLookupError', ...)` rather
+*  than die-cause inspection. */
+var ManifestExtrasLookupError = class extends Schema.TaggedErrorClass()("ManifestExtrasLookupError", {
+	kind: Schema.Literals(["unknown-resource", "unresolved-resource"]),
+	resourceId: Schema.String
+}) {};
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const resolveManifestExtras = (input, ctx) => Effect.gen(function* () {
 	if (input === void 0) return {};
-	const resolved = yield* Effect.isEffect(input) ? input : typeof input === "function" ? Effect.sync(() => input(ctx)).pipe(Effect.flatMap((value) => Effect.isEffect(value) ? value : Effect.succeed(value))) : Effect.succeed(input);
-	if (!isRecord(resolved)) return yield* Effect.fail(/* @__PURE__ */ new Error("manifest extras must resolve to a plain record"));
+	const resolved = yield* Effect.isEffect(input) ? input : typeof input === "function" ? Effect.try({
+		try: () => input(ctx),
+		catch: (cause) => {
+			if (cause instanceof ManifestExtrasLookupError) return cause;
+			throw cause;
+		}
+	}).pipe(Effect.flatMap((value) => Effect.isEffect(value) ? value : Effect.succeed(value))) : Effect.succeed(input);
+	if (!isRecord(resolved)) return yield* Effect.fail(new ManifestExtrasInvalid({ detail: "manifest extras must resolve to a plain record" }));
 	return resolved;
 });
 /** Schema for runtime validation of an on-disk manifest. Build
@@ -21,13 +45,18 @@ const ManifestEnvelopeSchema = Schema.Struct({
 		name: Schema.String,
 		url: Schema.String,
 		displayUrl: Schema.NullOr(Schema.String),
-		wireProtocol: Schema.String,
+		wireProtocol: Schema.Literals([
+			"http",
+			"h2c",
+			"tcp"
+		]),
 		pluginKey: Schema.String,
 		endpointKey: Schema.String
 	})),
-	extras: Schema.Record(Schema.String, Schema.Unknown)
+	extras: Schema.Record(Schema.String, Schema.Unknown),
+	codegen: Schema.optional(Schema.Struct({ generatedDir: Schema.String }))
 });
 //#endregion
-export { ManifestEnvelopeSchema, resolveManifestExtras };
+export { ManifestEnvelopeSchema, ManifestExtrasInvalid, ManifestExtrasLookupError, resolveManifestExtras };
 
 //# sourceMappingURL=manifest.mjs.map

package/dist/substrate/manifest.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.mjs","names":[],"sources":["../../src/substrate/manifest.ts"],"sourcesContent":["// Manifest envelope schema.\n//\n// Architecture § Manifest data model: envelope shape is fixed at L0,\n// per-service projection is each plugin's responsibility (lives in\n// the Codegenable contribution). Build integrations read the\n// envelope; codegen output carries the typed per-service slice.\n//\n// L0 owns:\n//   - the envelope (identity tuple, manifestVersion, services slot,\n//     endpoints lookup, opaque extras),\n//   - the endpoint-declaration shape (decl emitted by Routable; the\n//     manifest writer at L3 walks them).\n\nimport { Effect, Schema } from 'effect';\n\nimport type { EndpointKey, PluginKey } from './brand.ts';\n\n/** Manifest envelope. The `services` slot is open (`unknown`) at\n *  the envelope level; each plugin's Codegenable contribution\n *  emits a typed file the consumer imports for the typed shape.\n */\nexport interface ManifestEnvelope {\n\treadonly identity: {\n\t\treadonly app: string;\n\t\treadonly stack: string;\n\t\treadonly chain: string;\n\t};\n\treadonly manifestVersion: number;\n\treadonly services: Readonly<Record<string, unknown>>;\n\treadonly endpoints: Readonly<Record<string, EndpointEntry>>;\n\treadonly extras: Readonly<Record<string, unknown>>;\n}\n\nexport type ManifestExtras = Readonly<Record<string, unknown>>;\n\nexport interface ManifestExtrasContext {\n\treadonly value: (resource: { readonly id: string }) => unknown;\n}\n\nexport type ManifestExtrasInput =\n\t| ManifestExtras\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t| Effect.Effect<ManifestExtras, any, never>\n\t| ((\n\t\t\tctx: ManifestExtrasContext,\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t  ) => ManifestExtras | Effect.Effect<ManifestExtras, any, never>);\n\nconst isRecord = (value: unknown): value is ManifestExtras =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const resolveManifestExtras = (\n\tinput: ManifestExtrasInput | undefined,\n\tctx: ManifestExtrasContext,\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Effect.Effect<ManifestExtras, Error, never> =>\n\tEffect.gen(function* () {\n\t\tif (input === undefined) return {};\n\t\tconst resolvedEffect = Effect.isEffect(input)\n\t\t\t? input\n\t\t\t: typeof input === 'function'\n\t\t\t\t? Effect.sync(() => input(ctx)).pipe(\n\t\t\t\t\t\tEffect.flatMap((value) => (Effect.isEffect(value) ? value : Effect.succeed(value))),\n\t\t\t\t\t)\n\t\t\t\t: Effect.succeed(input);\n\t\tconst resolved = yield* resolvedEffect;\n\t\tif (!isRecord(resolved)) {\n\t\t\treturn yield* Effect.fail(new Error('manifest extras must resolve to a plain record'));\n\t\t}\n\t\treturn resolved;\n\t});\n\n/** Flat endpoint entry — the manifest's load-bearing surface for\n *  build integrations. */\nexport interface EndpointEntry {\n\treadonly name: string;\n\treadonly url: string;\n\treadonly displayUrl: string | null;\n\treadonly wireProtocol: 'http' | 'h2c' | string;\n\treadonly pluginKey: PluginKey;\n\treadonly endpointKey: EndpointKey;\n}\n\n/** Schema for runtime validation of an on-disk manifest. Build\n *  integrations decode through this on read. */\nexport const ManifestEnvelopeSchema = Schema.Struct({\n\tidentity: Schema.Struct({\n\t\tapp: Schema.String,\n\t\tstack: Schema.String,\n\t\tchain: Schema.String,\n\t}),\n\tmanifestVersion: Schema.Number,\n\tservices: Schema.Record(Schema.String, Schema.Unknown),\n\tendpoints: Schema.Record(\n\t\tSchema.String,\n\t\tSchema.Struct({\n\t\t\tname: Schema.String,\n\t\t\turl: Schema.String,\n\t\t\tdisplayUrl: Schema.NullOr(Schema.String),\n\t\t\twireProtocol: Schema.String,\n\t\t\tpluginKey: Schema.String,\n\t\t\tendpointKey: Schema.String,\n\t\t}),\n\t),\n\textras: Schema.Record(Schema.String, Schema.Unknown),\n});\n"],"mappings":";;AAgDA,MAAM,YAAY,UACjB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;AAErE,MAAa,yBACZ,OACA,QAGA,OAAO,IAAI,aAAa;AACvB,KAAI,UAAU,KAAA,EAAW,QAAO,EAAE;CAQlC,MAAM,WAAW,OAPM,OAAO,SAAS,MAAM,GAC1C,QACA,OAAO,UAAU,aAChB,OAAO,WAAW,MAAM,IAAI,CAAC,CAAC,KAC9B,OAAO,SAAS,UAAW,OAAO,SAAS,MAAM,GAAG,QAAQ,OAAO,QAAQ,MAAM,CAAE,CACnF,GACA,OAAO,QAAQ,MAAM;AAEzB,KAAI,CAAC,SAAS,SAAS,CACtB,QAAO,OAAO,OAAO,qBAAK,IAAI,MAAM,iDAAiD,CAAC;AAEvF,QAAO;EACN;;;AAeH,MAAa,yBAAyB,OAAO,OAAO;CACnD,UAAU,OAAO,OAAO;EACvB,KAAK,OAAO;EACZ,OAAO,OAAO;EACd,OAAO,OAAO;EACd,CAAC;CACF,iBAAiB,OAAO;CACxB,UAAU,OAAO,OAAO,OAAO,QAAQ,OAAO,QAAQ;CACtD,WAAW,OAAO,OACjB,OAAO,QACP,OAAO,OAAO;EACb,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,YAAY,OAAO,OAAO,OAAO,OAAO;EACxC,cAAc,OAAO;EACrB,WAAW,OAAO;EAClB,aAAa,OAAO;EACpB,CAAC,CACF;CACD,QAAQ,OAAO,OAAO,OAAO,QAAQ,OAAO,QAAQ;CACpD,CAAC"}
+{"version":3,"file":"manifest.mjs","names":[],"sources":["../../src/substrate/manifest.ts"],"sourcesContent":["// Manifest envelope schema.\n//\n// Architecture § Manifest data model: envelope shape is fixed at L0,\n// per-service projection is each plugin's responsibility (lives in\n// the Codegenable contribution). Build integrations read the\n// envelope; codegen output carries the typed per-service slice.\n//\n// L0 owns:\n//   - the envelope (identity tuple, manifestVersion, services slot,\n//     endpoints lookup, opaque extras),\n//   - the endpoint-declaration shape (decl emitted by Routable; the\n//     manifest writer at L3 walks them).\n\nimport { Effect, Schema } from 'effect';\n\n/** Tagged failure when a plugin's manifest-extras contribution does\n *  not resolve to a plain record. STYLE_GUIDE §2.2 — substrate (L0)\n *  errors use `Schema.TaggedErrorClass`; downstream classifiers\n *  `catchTag('ManifestExtrasInvalid', ...)` instead of sniffing the\n *  message. */\nexport class ManifestExtrasInvalid extends Schema.TaggedErrorClass<ManifestExtrasInvalid>()(\n\t'ManifestExtrasInvalid',\n\t{\n\t\tdetail: Schema.String,\n\t},\n) {}\n\n/** Tagged failure when a plugin's `extras` factory references a\n *  resource the host cannot resolve — either the resource id is not\n *  registered with the supervisor, or it has not produced a value\n *  yet at the point the factory ran. Thrown synchronously from the\n *  user-supplied `ctx.value(...)` closure; `resolveManifestExtras`\n *  catches the throw and surfaces it as a typed failure so callers\n *  classify via `catchTag('ManifestExtrasLookupError', ...)` rather\n *  than die-cause inspection. */\nexport class ManifestExtrasLookupError extends Schema.TaggedErrorClass<ManifestExtrasLookupError>()(\n\t'ManifestExtrasLookupError',\n\t{\n\t\tkind: Schema.Literals(['unknown-resource', 'unresolved-resource']),\n\t\tresourceId: Schema.String,\n\t},\n) {}\n\n/** Codegen metadata recorded per stack. The supervisor writes the\n *  resolved absolute output dir here at manifest-flush time so the\n *  read-side build integrations (the Vite plugin) point an `@generated`\n *  alias at the EXACT dir codegen emitted into for THIS stack — read\n *  and write share one decision (see\n *  `orchestrators/codegen/output-location.ts`). Optional + additive:\n *  manifests written before this field existed (and stacks that somehow\n *  flush without it) still decode; consumers fall back to\n *  `src/generated/`. */\nexport interface ManifestCodegen {\n\t/** Absolute path to the directory codegen emitted into for this\n\t *  stack (primary → `<appRoot>/src/generated`; secondary →\n\t *  `<appRoot>/.devstack/stacks/<stack>/generated`). */\n\treadonly generatedDir: string;\n}\n\n/** Manifest envelope. The `services` slot is open (`unknown`) at\n *  the envelope level; each plugin's Codegenable contribution\n *  emits a typed file the consumer imports for the typed shape.\n */\nexport interface ManifestEnvelope {\n\treadonly identity: {\n\t\treadonly app: string;\n\t\treadonly stack: string;\n\t\treadonly chain: string;\n\t};\n\treadonly manifestVersion: number;\n\treadonly services: Readonly<Record<string, unknown>>;\n\treadonly endpoints: Readonly<Record<string, EndpointEntry>>;\n\treadonly extras: Readonly<Record<string, unknown>>;\n\t/** Per-stack codegen metadata. Optional — absent in older\n\t *  manifests; the reader falls back to `src/generated/`. */\n\treadonly codegen?: ManifestCodegen;\n}\n\nexport type ManifestExtras = Readonly<Record<string, unknown>>;\n\nexport interface ManifestExtrasContext {\n\treadonly value: (resource: { readonly id: string }) => unknown;\n}\n\nexport type ManifestExtrasInput =\n\t| ManifestExtras\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t| Effect.Effect<ManifestExtras, any, never>\n\t| ((\n\t\t\tctx: ManifestExtrasContext,\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t  ) => ManifestExtras | Effect.Effect<ManifestExtras, any, never>);\n\nconst isRecord = (value: unknown): value is ManifestExtras =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const resolveManifestExtras = (\n\tinput: ManifestExtrasInput | undefined,\n\tctx: ManifestExtrasContext,\n): Effect.Effect<ManifestExtras, ManifestExtrasInvalid | ManifestExtrasLookupError, never> =>\n\tEffect.gen(function* () {\n\t\tif (input === undefined) return {};\n\t\t// The user-supplied `extras` factory invokes `ctx.value(...)`\n\t\t// synchronously; a missing/unresolved resource throws a\n\t\t// `ManifestExtrasLookupError`. `Effect.try` with a typed\n\t\t// `catch` mapper promotes that throw into the typed failure\n\t\t// channel so callers `catchTag` it instead of having to inspect\n\t\t// the die-cause. Any non-tagged throw is rethrown to preserve\n\t\t// the existing defect semantics for genuine programmer errors\n\t\t// inside the factory body.\n\t\tconst resolvedEffect = Effect.isEffect(input)\n\t\t\t? input\n\t\t\t: typeof input === 'function'\n\t\t\t\t? Effect.try({\n\t\t\t\t\t\ttry: () => input(ctx),\n\t\t\t\t\t\tcatch: (cause) => {\n\t\t\t\t\t\t\tif (cause instanceof ManifestExtrasLookupError) return cause;\n\t\t\t\t\t\t\tthrow cause;\n\t\t\t\t\t\t},\n\t\t\t\t\t}).pipe(\n\t\t\t\t\t\tEffect.flatMap((value) => (Effect.isEffect(value) ? value : Effect.succeed(value))),\n\t\t\t\t\t)\n\t\t\t\t: Effect.succeed(input);\n\t\tconst resolved = yield* resolvedEffect;\n\t\tif (!isRecord(resolved)) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tnew ManifestExtrasInvalid({\n\t\t\t\t\tdetail: 'manifest extras must resolve to a plain record',\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t\treturn resolved;\n\t});\n\n/** Flat endpoint entry — the manifest's load-bearing surface for\n *  build integrations. */\nexport interface EndpointEntry {\n\treadonly name: string;\n\treadonly url: string;\n\treadonly displayUrl: string | null;\n\treadonly wireProtocol: 'http' | 'h2c' | 'tcp';\n\treadonly pluginKey: string;\n\treadonly endpointKey: string;\n}\n\n/** Schema for runtime validation of an on-disk manifest. Build\n *  integrations decode through this on read. */\nexport const ManifestEnvelopeSchema = Schema.Struct({\n\tidentity: Schema.Struct({\n\t\tapp: Schema.String,\n\t\tstack: Schema.String,\n\t\tchain: Schema.String,\n\t}),\n\tmanifestVersion: Schema.Number,\n\tservices: Schema.Record(Schema.String, Schema.Unknown),\n\tendpoints: Schema.Record(\n\t\tSchema.String,\n\t\tSchema.Struct({\n\t\t\tname: Schema.String,\n\t\t\turl: Schema.String,\n\t\t\tdisplayUrl: Schema.NullOr(Schema.String),\n\t\t\twireProtocol: Schema.Literals(['http', 'h2c', 'tcp']),\n\t\t\tpluginKey: Schema.String,\n\t\t\tendpointKey: Schema.String,\n\t\t}),\n\t),\n\textras: Schema.Record(Schema.String, Schema.Unknown),\n\t// Optional + additive — a manifest written before this field\n\t// existed still decodes (the key is simply absent). The Vite plugin\n\t// reads `codegen.generatedDir` to point its `@generated` alias; on a\n\t// miss it falls back to `src/generated/`.\n\tcodegen: Schema.optional(\n\t\tSchema.Struct({\n\t\t\tgeneratedDir: Schema.String,\n\t\t}),\n\t),\n});\n"],"mappings":";;;;;;;AAoBA,IAAa,wBAAb,cAA2C,OAAO,kBAAyC,CAC1F,yBACA,EACC,QAAQ,OAAO,QACf,CACD,CAAC;;;;;;;;;AAUF,IAAa,4BAAb,cAA+C,OAAO,kBAA6C,CAClG,6BACA;CACC,MAAM,OAAO,SAAS,CAAC,oBAAoB,sBAAsB,CAAC;CAClE,YAAY,OAAO;CACnB,CACD,CAAC;AAoDF,MAAM,YAAY,UACjB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;AAErE,MAAa,yBACZ,OACA,QAEA,OAAO,IAAI,aAAa;AACvB,KAAI,UAAU,KAAA,EAAW,QAAO,EAAE;CAsBlC,MAAM,WAAW,OAbM,OAAO,SAAS,MAAM,GAC1C,QACA,OAAO,UAAU,aAChB,OAAO,IAAI;EACX,WAAW,MAAM,IAAI;EACrB,QAAQ,UAAU;AACjB,OAAI,iBAAiB,0BAA2B,QAAO;AACvD,SAAM;;EAEP,CAAC,CAAC,KACF,OAAO,SAAS,UAAW,OAAO,SAAS,MAAM,GAAG,QAAQ,OAAO,QAAQ,MAAM,CAAE,CACnF,GACA,OAAO,QAAQ,MAAM;AAEzB,KAAI,CAAC,SAAS,SAAS,CACtB,QAAO,OAAO,OAAO,KACpB,IAAI,sBAAsB,EACzB,QAAQ,kDACR,CAAC,CACF;AAEF,QAAO;EACN;;;AAeH,MAAa,yBAAyB,OAAO,OAAO;CACnD,UAAU,OAAO,OAAO;EACvB,KAAK,OAAO;EACZ,OAAO,OAAO;EACd,OAAO,OAAO;EACd,CAAC;CACF,iBAAiB,OAAO;CACxB,UAAU,OAAO,OAAO,OAAO,QAAQ,OAAO,QAAQ;CACtD,WAAW,OAAO,OACjB,OAAO,QACP,OAAO,OAAO;EACb,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,YAAY,OAAO,OAAO,OAAO,OAAO;EACxC,cAAc,OAAO,SAAS;GAAC;GAAQ;GAAO;GAAM,CAAC;EACrD,WAAW,OAAO;EAClB,aAAa,OAAO;EACpB,CAAC,CACF;CACD,QAAQ,OAAO,OAAO,OAAO,QAAQ,OAAO,QAAQ;CAKpD,SAAS,OAAO,SACf,OAAO,OAAO,EACb,cAAc,OAAO,QACrB,CAAC,CACF;CACD,CAAC"}

package/dist/substrate/network.d.mts

@@ -17,8 +17,8 @@ interface DevstackNetworkModeRegistry {
   };
 }
 type NetworkMode = keyof DevstackNetworkModeRegistry & string;
-/** Substrate-level network record. Plugins consult the resolver once
- *  per acquire and get this back. */
+/** Substrate-level network record. Plugins read this from the
+ *  `IdentityContext` projection — one value per acquire. */
 type NetworkConfig<Mode extends NetworkMode = NetworkMode> = Readonly<{
   readonly mode: Mode;
   /** Chain identity the plugin uses for cache-key folding, ChainProbe
@@ -27,8 +27,6 @@ type NetworkConfig<Mode extends NetworkMode = NetworkMode> = Readonly<{
   readonly chain: ChainId; /** Source provenance for renderer display. */
   readonly source?: 'cli' | 'env' | 'config' | 'default';
 } & DevstackNetworkModeRegistry[Mode]>;
-/** Default network shape used when nothing is pinned. */
-type DefaultNetwork = NetworkConfig<'local'>;
 //#endregion
-export { DefaultNetwork, DevstackNetworkModeRegistry, NetworkConfig, NetworkMode };
+export { DevstackNetworkModeRegistry, NetworkConfig, NetworkMode };
 //# sourceMappingURL=network.d.mts.map

package/dist/substrate/options.d.mts

@@ -8,13 +8,11 @@ import { NetworkConfig } from "./network.mjs";
 interface DevstackOptions {
   readonly stackName?: string;
   readonly network?: NetworkConfig;
-  readonly watchPaths?: ReadonlyArray<string>;
   readonly stateDir?: string;
   readonly codegen?: {
     readonly outputDir?: string;
     readonly stackSubdir?: string | null;
   };
-  readonly hotRestart?: boolean;
   readonly renderer?: 'tui' | 'plain' | 'silent';
   readonly extras?: ManifestExtrasInput;
 }

package/dist/substrate/plugin.d.mts

@@ -1,5 +1,6 @@
 import { ChainId, PluginKey } from "./brand.mjs";
 import { PluginRole } from "./lifecycle.mjs";
+import { RowSection } from "./projection.mjs";
 import { CapabilityDecl } from "../contracts/capability-decl.mjs";
 import { Identity } from "./identity.mjs";
 import { Effect } from "effect";
@@ -56,6 +57,16 @@ interface PluginSpecBase<Id extends string, Start extends AnyPluginStart, Caps e
   readonly start: Start;
   readonly capabilities?: CapabilitySource<StartValue<Start>, Caps>;
   readonly errorContributions?: ReadonlyArray<PluginErrorContribution>;
+  /** Dashboard section bucket the plugin's rows belong to. Required so
+   *  the renderer never has to pattern-match on plugin name substrings
+   *  to compute it. The supervisor stamps this onto every row at
+   *  acquire-time. */
+  readonly section: RowSection;
+  /** Optional override for rows that own a routed endpoint. When set
+   *  and the row carries an endpoint, the renderer groups it under
+   *  `endpointSection` instead of `section`. Use sparingly — the
+   *  default is for the plugin's normal `section` to apply uniformly. */
+  readonly endpointSection?: RowSection;
 }
 type PluginSpec<Id extends string, DependsOn extends DependencyInput | undefined, Start extends AnyPluginStart, Caps extends ReadonlyArray<CapabilityDecl>> = PluginSpecBase<Id, Start, Caps> & {
   readonly dependsOn?: DependsOn;
@@ -70,6 +81,8 @@ interface Plugin<Id extends string, Value, Needs extends readonly AnyResourceRef
   readonly start: (deps: ResolvedDependencies<DependencyInput | undefined>) => Effect.Effect<Value, unknown, unknown>;
   readonly capabilities?: Caps | CapabilitiesFactory<Caps, Value>;
   readonly errorContributions?: ReadonlyArray<PluginErrorContribution>;
+  readonly section: RowSection;
+  readonly endpointSection?: RowSection;
 }
 type AnyPlugin = Plugin<string, any, readonly AnyResourceRef[], ReadonlyArray<CapabilityDecl>>;
 declare function definePlugin<const Id extends string, const DependsOn extends readonly AnyResourceRef[], const Start extends PluginStart<ResolvedDependencyList<DependsOn>> = PluginStart<ResolvedDependencyList<DependsOn>>, const Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>>(spec: PluginSpecBase<Id, Start, Caps> & {

package/dist/substrate/plugin.mjs

@@ -48,14 +48,16 @@ function definePlugin(spec) {
 		id: spec.id,
 		dependsOn,
 		role: spec.role,
+		section: spec.section,
 		start: spec.start,
 		...spec.pluginKey === void 0 ? {} : { pluginKey: spec.pluginKey },
 		...spec.watch === void 0 ? {} : { watch: spec.watch },
 		...capabilities === void 0 ? {} : { capabilities },
-		...spec.errorContributions === void 0 ? {} : { errorContributions: spec.errorContributions }
+		...spec.errorContributions === void 0 ? {} : { errorContributions: spec.errorContributions },
+		...spec.endpointSection === void 0 ? {} : { endpointSection: spec.endpointSection }
 	};
 }
 //#endregion
-export { defineId, definePlugin, dependencyList, isPlugin, pluginDependencyRefs, resolveDependencyValues, resolvePluginDependencies, resource, uniqueResourceRefs };
+export { defineId, definePlugin, dependencyList, isPlugin, isResourceRef, pluginDependencyRefs, resolveDependencyValues, resolvePluginDependencies, resource, uniqueResourceRefs };
 
 //# sourceMappingURL=plugin.mjs.map

package/dist/substrate/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/substrate/plugin.ts"],"sourcesContent":["// Resource-native plugin contract.\n//\n// Public plugin authors use `definePlugin({ id, dependsOn, start })`.\n// The substrate now consumes that same shape directly: resource ids\n// drive scheduling, resolved dependency values are constructed by the\n// supervisor, and plugin bodies run through `start(...)`.\n\nimport type { Effect } from 'effect';\n\nimport type { CapabilityDecl } from '../contracts/capability-decl.ts';\nimport type { ChainId, PluginKey } from './brand.ts';\nimport type { Identity } from './identity.ts';\nimport type { PluginRole } from './lifecycle.ts';\n\nconst resourceBrand: unique symbol = Symbol.for('devstack.resource') as never;\nconst pluginBrand: unique symbol = Symbol.for('devstack.plugin') as never;\nconst resourceValue: unique symbol = Symbol.for('devstack.resource.value') as never;\nconst dependencyInputBrand: unique symbol = Symbol.for('devstack.plugin.dependency-input') as never;\n\nexport interface ResourceRef<Id extends string, Value = unknown> {\n\treadonly id: Id;\n\treadonly [resourceBrand]: true;\n\treadonly [resourceValue]?: () => Value;\n}\n\nexport type AnyResourceRef = ResourceRef<string, unknown>;\n\nexport type ResourceIdOf<R extends AnyResourceRef> = R['id'];\n\nexport type ResourceValueOf<R extends AnyResourceRef> =\n\tR extends ResourceRef<string, infer Value> ? Value : never;\n\nexport const defineId = <const Id extends string>(id: Id): Id => id;\n\nexport const resource = <const Id extends string, Value = unknown>(\n\tid: Id,\n): ResourceRef<Id, Value> =>\n\t({\n\t\tid,\n\t\t[resourceBrand]: true,\n\t}) as ResourceRef<Id, Value>;\n\nexport const isResourceRef = (value: unknown): value is AnyResourceRef =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\t(value as { readonly [resourceBrand]?: true })[resourceBrand] === true;\n\nexport type DependencyInput =\n\t| AnyResourceRef\n\t| readonly AnyResourceRef[]\n\t| Readonly<Record<string, AnyResourceRef>>;\n\nexport type DependencyList<Input> = Input extends readonly AnyResourceRef[]\n\t? Input\n\t: Input extends AnyResourceRef\n\t\t? readonly [Input]\n\t\t: Input extends Readonly<Record<string, AnyResourceRef>>\n\t\t\t? ReadonlyArray<Input[keyof Input]>\n\t\t\t: readonly [];\n\nexport type ResolvedDependencyList<Dependencies extends readonly AnyResourceRef[]> = readonly [\n\t...{\n\t\treadonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef\n\t\t\t? ResourceValueOf<Dependencies[K]>\n\t\t\t: never;\n\t},\n];\n\nexport type ResolvedDependencyObject<\n\tDependencies extends Readonly<Record<string, AnyResourceRef>>,\n> = {\n\treadonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef\n\t\t? ResourceValueOf<Dependencies[K]>\n\t\t: never;\n};\n\nexport type ResolvedDependencies<Input> = Input extends undefined\n\t? undefined\n\t: Input extends readonly AnyResourceRef[]\n\t\t? ResolvedDependencyList<Input>\n\t\t: Input extends AnyResourceRef\n\t\t\t? ResourceValueOf<Input>\n\t\t\t: Input extends Readonly<Record<string, AnyResourceRef>>\n\t\t\t\t? ResolvedDependencyObject<Input>\n\t\t\t\t: never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyPluginStart = (...args: any[]) => Effect.Effect<unknown, unknown, unknown>;\n\ntype PluginStart<Deps> = [Deps] extends [undefined]\n\t? () => Effect.Effect<unknown, unknown, unknown>\n\t: (deps: Deps) => Effect.Effect<unknown, unknown, unknown>;\n\ntype StartValue<Start> = Start extends (\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t...args: any[]\n) => Effect.Effect<infer Value, unknown, unknown>\n\t? Value\n\t: never;\n\nexport interface PluginErrorContribution {\n\treadonly _tag: 'PluginErrorContribution';\n\treadonly errorTags: ReadonlyArray<string>;\n\treadonly formatter?: (\n\t\tvalue: { readonly _tag: string } & Readonly<Record<string, unknown>>,\n\t\trecurse: (inner: unknown) => string,\n\t) => string | null;\n}\n\nexport interface WatchDecl {\n\treadonly paths: ReadonlyArray<string>;\n\treadonly cascade?: boolean;\n}\n\nexport interface AcquireContext {\n\treadonly identity: Identity;\n\treadonly chain: ChainId;\n\treadonly runtimeRoot: string;\n}\n\nexport type CapabilitiesFactory<Caps extends ReadonlyArray<CapabilityDecl>, Resolved> = (\n\tresolved: Resolved,\n\tctx: AcquireContext,\n) => Caps;\n\nexport type CapabilitySource<Value, Caps extends ReadonlyArray<CapabilityDecl>> =\n\t| Caps\n\t| ((ctx: { readonly value: Value; readonly runtime: AcquireContext }) => Caps);\n\ninterface PluginSpecBase<\n\tId extends string,\n\tStart extends AnyPluginStart,\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> {\n\treadonly id: Id;\n\treadonly role: PluginRole;\n\treadonly pluginKey?: PluginKey | string;\n\treadonly watch?: WatchDecl;\n\treadonly start: Start;\n\treadonly capabilities?: CapabilitySource<StartValue<Start>, Caps>;\n\treadonly errorContributions?: ReadonlyArray<PluginErrorContribution>;\n}\n\nexport type PluginSpec<\n\tId extends string,\n\tDependsOn extends DependencyInput | undefined,\n\tStart extends AnyPluginStart,\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> = PluginSpecBase<Id, Start, Caps> & {\n\treadonly dependsOn?: DependsOn;\n};\n\nexport interface Plugin<\n\tId extends string,\n\tValue,\n\tNeeds extends readonly AnyResourceRef[],\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> extends ResourceRef<Id, Value> {\n\treadonly [pluginBrand]: true;\n\treadonly [dependencyInputBrand]: DependencyInput | undefined;\n\treadonly dependsOn: Needs;\n\treadonly role: PluginRole;\n\treadonly pluginKey?: PluginKey | string;\n\treadonly watch?: WatchDecl;\n\treadonly start: (\n\t\tdeps: ResolvedDependencies<DependencyInput | undefined>,\n\t) => Effect.Effect<Value, unknown, unknown>;\n\treadonly capabilities?: Caps | CapabilitiesFactory<Caps, Value>;\n\treadonly errorContributions?: ReadonlyArray<PluginErrorContribution>;\n}\n\nexport type AnyPlugin = Plugin<\n\tstring,\n\t// Erased runtime plugin values must be `any` rather than `unknown`\n\t// so concrete dynamic capability factories remain assignable under\n\t// strict function parameter variance. Precise value types stay on\n\t// concrete `Plugin<Id, Value, ...>` instances.\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tany,\n\treadonly AnyResourceRef[],\n\tReadonlyArray<CapabilityDecl>\n>;\n\nexport const isPlugin = (value: unknown): value is AnyPlugin =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\t(value as { readonly [pluginBrand]?: true })[pluginBrand] === true;\n\nexport const dependencyList = <Input extends DependencyInput | undefined>(\n\tdependsOn: Input,\n): DependencyList<Input> => {\n\tif (dependsOn === undefined) {\n\t\treturn [] as unknown as DependencyList<Input>;\n\t}\n\tif (Array.isArray(dependsOn)) {\n\t\treturn dependsOn as unknown as DependencyList<Input>;\n\t}\n\tif (isResourceRef(dependsOn)) {\n\t\treturn [dependsOn] as unknown as DependencyList<Input>;\n\t}\n\treturn Object.values(dependsOn) as unknown as DependencyList<Input>;\n};\n\nexport const uniqueResourceRefs = (refs: readonly AnyResourceRef[]): readonly AnyResourceRef[] => {\n\tconst seen = new Set<string>();\n\tconst unique: AnyResourceRef[] = [];\n\tfor (const ref of refs) {\n\t\tif (seen.has(ref.id)) continue;\n\t\tseen.add(ref.id);\n\t\tunique.push(ref);\n\t}\n\treturn unique;\n};\n\nexport const resolveDependencyValues = <Input extends DependencyInput | undefined>(\n\tdependsOn: Input,\n\tread: (resource: DependencyList<Input>[number]) => unknown,\n): ResolvedDependencies<Input> => {\n\tconst readAny = (resourceRef: AnyResourceRef) =>\n\t\tread(resourceRef as DependencyList<Input>[number]);\n\n\tif (dependsOn === undefined) {\n\t\treturn undefined as ResolvedDependencies<Input>;\n\t}\n\tif (Array.isArray(dependsOn)) {\n\t\treturn dependsOn.map((resourceRef) => readAny(resourceRef)) as ResolvedDependencies<Input>;\n\t}\n\tif (isResourceRef(dependsOn)) {\n\t\treturn readAny(dependsOn) as ResolvedDependencies<Input>;\n\t}\n\treturn Object.fromEntries(\n\t\tObject.entries(dependsOn).map(([key, resourceRef]) => [key, readAny(resourceRef)]),\n\t) as ResolvedDependencies<Input>;\n};\n\nexport const resolvePluginDependencies = (\n\tplugin: AnyPlugin,\n\tread: (resource: AnyResourceRef) => unknown,\n): ResolvedDependencies<DependencyInput | undefined> =>\n\tresolveDependencyValues(plugin[dependencyInputBrand], (resourceRef) =>\n\t\tread(resourceRef as AnyResourceRef),\n\t);\n\nexport const pluginDependencyRefs = (plugin: AnyPlugin): readonly AnyResourceRef[] =>\n\tdependencyList(plugin[dependencyInputBrand]) as readonly AnyResourceRef[];\n\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends readonly AnyResourceRef[],\n\tconst Start extends PluginStart<ResolvedDependencyList<DependsOn>> = PluginStart<\n\t\tResolvedDependencyList<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, DependsOn, Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends Readonly<Record<string, AnyResourceRef>>,\n\tconst Start extends PluginStart<ResolvedDependencyObject<DependsOn>> = PluginStart<\n\t\tResolvedDependencyObject<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, DependencyList<DependsOn>, Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends AnyResourceRef,\n\tconst Start extends PluginStart<ResourceValueOf<DependsOn>> = PluginStart<\n\t\tResourceValueOf<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, readonly [DependsOn], Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst Start extends PluginStart<undefined> = PluginStart<undefined>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn?: undefined;\n\t},\n): Plugin<Id, StartValue<Start>, readonly [], Caps>;\nexport function definePlugin(\n\tspec: PluginSpecBase<string, AnyPluginStart, ReadonlyArray<CapabilityDecl>> & {\n\t\treadonly dependsOn?: DependencyInput;\n\t},\n): AnyPlugin {\n\tconst dependsOn = uniqueResourceRefs(dependencyList(spec.dependsOn));\n\tconst capabilitiesField = spec.capabilities;\n\tconst capabilities =\n\t\ttypeof capabilitiesField === 'function'\n\t\t\t? (value: unknown, runtime: AcquireContext) => capabilitiesField({ value, runtime })\n\t\t\t: capabilitiesField;\n\n\treturn {\n\t\t[resourceBrand]: true,\n\t\t[pluginBrand]: true,\n\t\t[dependencyInputBrand]: spec.dependsOn,\n\t\tid: spec.id,\n\t\tdependsOn,\n\t\trole: spec.role,\n\t\tstart: spec.start as AnyPlugin['start'],\n\t\t...(spec.pluginKey === undefined ? {} : { pluginKey: spec.pluginKey }),\n\t\t...(spec.watch === undefined ? {} : { watch: spec.watch }),\n\t\t...(capabilities === undefined ? {} : { capabilities }),\n\t\t...(spec.errorContributions === undefined\n\t\t\t? {}\n\t\t\t: { errorContributions: spec.errorContributions }),\n\t} as AnyPlugin;\n}\n\nexport type ProvidedIdsOf<Members> =\n\tMembers extends ReadonlyArray<unknown>\n\t\t? Members[number] extends { readonly id: infer Id extends string }\n\t\t\t? Id\n\t\t\t: never\n\t\t: never;\n\nexport type ConsumedIdsOf<Members> =\n\tMembers extends ReadonlyArray<unknown>\n\t\t? Members[number] extends { readonly dependsOn: infer Dependencies }\n\t\t\t? Dependencies extends ReadonlyArray<infer Dependency>\n\t\t\t\t? Dependency extends { readonly id: infer Id extends string }\n\t\t\t\t\t? Id\n\t\t\t\t\t: never\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\nexport type MissingProviders<Members> = Exclude<ConsumedIdsOf<Members>, ProvidedIdsOf<Members>>;\n\nexport interface __MissingProvidersError<Missing extends string> {\n\treadonly __missing_providers: Missing;\n}\n"],"mappings":";AAcA,MAAM,gBAA+B,OAAO,IAAI,oBAAoB;AACpE,MAAM,cAA6B,OAAO,IAAI,kBAAkB;AAEhE,MAAM,uBAAsC,OAAO,IAAI,mCAAmC;AAe1F,MAAa,YAAqC,OAAe;AAEjE,MAAa,YACZ,QAEC;CACA;EACC,gBAAgB;CACjB;AAEF,MAAa,iBAAiB,UAC7B,OAAO,UAAU,YACjB,UAAU,QACT,MAA8C,mBAAmB;AA0InE,MAAa,YAAY,UACxB,OAAO,UAAU,YACjB,UAAU,QACT,MAA4C,iBAAiB;AAE/D,MAAa,kBACZ,cAC2B;AAC3B,KAAI,cAAc,KAAA,EACjB,QAAO,EAAE;AAEV,KAAI,MAAM,QAAQ,UAAU,CAC3B,QAAO;AAER,KAAI,cAAc,UAAU,CAC3B,QAAO,CAAC,UAAU;AAEnB,QAAO,OAAO,OAAO,UAAU;;AAGhC,MAAa,sBAAsB,SAA+D;CACjG,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAA2B,EAAE;AACnC,MAAK,MAAM,OAAO,MAAM;AACvB,MAAI,KAAK,IAAI,IAAI,GAAG,CAAE;AACtB,OAAK,IAAI,IAAI,GAAG;AAChB,SAAO,KAAK,IAAI;;AAEjB,QAAO;;AAGR,MAAa,2BACZ,WACA,SACiC;CACjC,MAAM,WAAW,gBAChB,KAAK,YAA6C;AAEnD,KAAI,cAAc,KAAA,EACjB;AAED,KAAI,MAAM,QAAQ,UAAU,CAC3B,QAAO,UAAU,KAAK,gBAAgB,QAAQ,YAAY,CAAC;AAE5D,KAAI,cAAc,UAAU,CAC3B,QAAO,QAAQ,UAAU;AAE1B,QAAO,OAAO,YACb,OAAO,QAAQ,UAAU,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAAC,KAAK,QAAQ,YAAY,CAAC,CAAC,CAClF;;AAGF,MAAa,6BACZ,QACA,SAEA,wBAAwB,OAAO,wBAAwB,gBACtD,KAAK,YAA8B,CACnC;AAEF,MAAa,wBAAwB,WACpC,eAAe,OAAO,sBAAsB;AA+C7C,SAAgB,aACf,MAGY;CACZ,MAAM,YAAY,mBAAmB,eAAe,KAAK,UAAU,CAAC;CACpE,MAAM,oBAAoB,KAAK;CAC/B,MAAM,eACL,OAAO,sBAAsB,cACzB,OAAgB,YAA4B,kBAAkB;EAAE;EAAO;EAAS,CAAC,GAClF;AAEJ,QAAO;GACL,gBAAgB;GAChB,cAAc;GACd,uBAAuB,KAAK;EAC7B,IAAI,KAAK;EACT;EACA,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,GAAG,EAAE,WAAW,KAAK,WAAW;EACrE,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO;EACzD,GAAI,iBAAiB,KAAA,IAAY,EAAE,GAAG,EAAE,cAAc;EACtD,GAAI,KAAK,uBAAuB,KAAA,IAC7B,EAAE,GACF,EAAE,oBAAoB,KAAK,oBAAoB;EAClD"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/substrate/plugin.ts"],"sourcesContent":["// Resource-native plugin contract.\n//\n// Public plugin authors use `definePlugin({ id, dependsOn, start })`.\n// The substrate now consumes that same shape directly: resource ids\n// drive scheduling, resolved dependency values are constructed by the\n// supervisor, and plugin bodies run through `start(...)`.\n\nimport type { Effect } from 'effect';\n\nimport type { CapabilityDecl } from '../contracts/capability-decl.ts';\nimport type { ChainId, PluginKey } from './brand.ts';\nimport type { Identity } from './identity.ts';\nimport type { PluginRole } from './lifecycle.ts';\nimport type { RowSection } from './projection.ts';\n\nconst resourceBrand: unique symbol = Symbol.for('devstack.resource') as never;\nconst pluginBrand: unique symbol = Symbol.for('devstack.plugin') as never;\nconst resourceValue: unique symbol = Symbol.for('devstack.resource.value') as never;\nconst dependencyInputBrand: unique symbol = Symbol.for('devstack.plugin.dependency-input') as never;\n\nexport interface ResourceRef<Id extends string, Value = unknown> {\n\treadonly id: Id;\n\treadonly [resourceBrand]: true;\n\treadonly [resourceValue]?: () => Value;\n}\n\nexport type AnyResourceRef = ResourceRef<string, unknown>;\n\nexport type ResourceIdOf<R extends AnyResourceRef> = R['id'];\n\nexport type ResourceValueOf<R extends AnyResourceRef> =\n\tR extends ResourceRef<string, infer Value> ? Value : never;\n\nexport const defineId = <const Id extends string>(id: Id): Id => id;\n\nexport const resource = <const Id extends string, Value = unknown>(\n\tid: Id,\n): ResourceRef<Id, Value> =>\n\t({\n\t\tid,\n\t\t[resourceBrand]: true,\n\t}) as ResourceRef<Id, Value>;\n\nexport const isResourceRef = (value: unknown): value is AnyResourceRef =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\t(value as { readonly [resourceBrand]?: true })[resourceBrand] === true;\n\nexport type DependencyInput =\n\t| AnyResourceRef\n\t| readonly AnyResourceRef[]\n\t| Readonly<Record<string, AnyResourceRef>>;\n\nexport type DependencyList<Input> = Input extends readonly AnyResourceRef[]\n\t? Input\n\t: Input extends AnyResourceRef\n\t\t? readonly [Input]\n\t\t: Input extends Readonly<Record<string, AnyResourceRef>>\n\t\t\t? ReadonlyArray<Input[keyof Input]>\n\t\t\t: readonly [];\n\nexport type ResolvedDependencyList<Dependencies extends readonly AnyResourceRef[]> = readonly [\n\t...{\n\t\treadonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef\n\t\t\t? ResourceValueOf<Dependencies[K]>\n\t\t\t: never;\n\t},\n];\n\nexport type ResolvedDependencyObject<\n\tDependencies extends Readonly<Record<string, AnyResourceRef>>,\n> = {\n\treadonly [K in keyof Dependencies]: Dependencies[K] extends AnyResourceRef\n\t\t? ResourceValueOf<Dependencies[K]>\n\t\t: never;\n};\n\nexport type ResolvedDependencies<Input> = Input extends undefined\n\t? undefined\n\t: Input extends readonly AnyResourceRef[]\n\t\t? ResolvedDependencyList<Input>\n\t\t: Input extends AnyResourceRef\n\t\t\t? ResourceValueOf<Input>\n\t\t\t: Input extends Readonly<Record<string, AnyResourceRef>>\n\t\t\t\t? ResolvedDependencyObject<Input>\n\t\t\t\t: never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyPluginStart = (...args: any[]) => Effect.Effect<unknown, unknown, unknown>;\n\ntype PluginStart<Deps> = [Deps] extends [undefined]\n\t? () => Effect.Effect<unknown, unknown, unknown>\n\t: (deps: Deps) => Effect.Effect<unknown, unknown, unknown>;\n\ntype StartValue<Start> = Start extends (\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t...args: any[]\n) => Effect.Effect<infer Value, unknown, unknown>\n\t? Value\n\t: never;\n\nexport interface PluginErrorContribution {\n\treadonly _tag: 'PluginErrorContribution';\n\treadonly errorTags: ReadonlyArray<string>;\n\treadonly formatter?: (\n\t\tvalue: { readonly _tag: string } & Readonly<Record<string, unknown>>,\n\t\trecurse: (inner: unknown) => string,\n\t) => string | null;\n}\n\nexport interface WatchDecl {\n\treadonly paths: ReadonlyArray<string>;\n\treadonly cascade?: boolean;\n}\n\nexport interface AcquireContext {\n\treadonly identity: Identity;\n\treadonly chain: ChainId;\n\treadonly runtimeRoot: string;\n}\n\nexport type CapabilitiesFactory<Caps extends ReadonlyArray<CapabilityDecl>, Resolved> = (\n\tresolved: Resolved,\n\tctx: AcquireContext,\n) => Caps;\n\nexport type CapabilitySource<Value, Caps extends ReadonlyArray<CapabilityDecl>> =\n\t| Caps\n\t| ((ctx: { readonly value: Value; readonly runtime: AcquireContext }) => Caps);\n\ninterface PluginSpecBase<\n\tId extends string,\n\tStart extends AnyPluginStart,\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> {\n\treadonly id: Id;\n\treadonly role: PluginRole;\n\treadonly pluginKey?: PluginKey | string;\n\treadonly watch?: WatchDecl;\n\treadonly start: Start;\n\treadonly capabilities?: CapabilitySource<StartValue<Start>, Caps>;\n\treadonly errorContributions?: ReadonlyArray<PluginErrorContribution>;\n\t/** Dashboard section bucket the plugin's rows belong to. Required so\n\t *  the renderer never has to pattern-match on plugin name substrings\n\t *  to compute it. The supervisor stamps this onto every row at\n\t *  acquire-time. */\n\treadonly section: RowSection;\n\t/** Optional override for rows that own a routed endpoint. When set\n\t *  and the row carries an endpoint, the renderer groups it under\n\t *  `endpointSection` instead of `section`. Use sparingly — the\n\t *  default is for the plugin's normal `section` to apply uniformly. */\n\treadonly endpointSection?: RowSection;\n}\n\nexport type PluginSpec<\n\tId extends string,\n\tDependsOn extends DependencyInput | undefined,\n\tStart extends AnyPluginStart,\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> = PluginSpecBase<Id, Start, Caps> & {\n\treadonly dependsOn?: DependsOn;\n};\n\nexport interface Plugin<\n\tId extends string,\n\tValue,\n\tNeeds extends readonly AnyResourceRef[],\n\tCaps extends ReadonlyArray<CapabilityDecl>,\n> extends ResourceRef<Id, Value> {\n\treadonly [pluginBrand]: true;\n\treadonly [dependencyInputBrand]: DependencyInput | undefined;\n\treadonly dependsOn: Needs;\n\treadonly role: PluginRole;\n\treadonly pluginKey?: PluginKey | string;\n\treadonly watch?: WatchDecl;\n\treadonly start: (\n\t\tdeps: ResolvedDependencies<DependencyInput | undefined>,\n\t) => Effect.Effect<Value, unknown, unknown>;\n\treadonly capabilities?: Caps | CapabilitiesFactory<Caps, Value>;\n\treadonly errorContributions?: ReadonlyArray<PluginErrorContribution>;\n\treadonly section: RowSection;\n\treadonly endpointSection?: RowSection;\n}\n\nexport type AnyPlugin = Plugin<\n\tstring,\n\t// Erased runtime plugin values must be `any` rather than `unknown`\n\t// so concrete dynamic capability factories remain assignable under\n\t// strict function parameter variance. Precise value types stay on\n\t// concrete `Plugin<Id, Value, ...>` instances.\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tany,\n\treadonly AnyResourceRef[],\n\tReadonlyArray<CapabilityDecl>\n>;\n\nexport const isPlugin = (value: unknown): value is AnyPlugin =>\n\ttypeof value === 'object' &&\n\tvalue !== null &&\n\t(value as { readonly [pluginBrand]?: true })[pluginBrand] === true;\n\nexport const dependencyList = <Input extends DependencyInput | undefined>(\n\tdependsOn: Input,\n): DependencyList<Input> => {\n\tif (dependsOn === undefined) {\n\t\treturn [] as unknown as DependencyList<Input>;\n\t}\n\tif (Array.isArray(dependsOn)) {\n\t\treturn dependsOn as unknown as DependencyList<Input>;\n\t}\n\tif (isResourceRef(dependsOn)) {\n\t\treturn [dependsOn] as unknown as DependencyList<Input>;\n\t}\n\treturn Object.values(dependsOn) as unknown as DependencyList<Input>;\n};\n\nexport const uniqueResourceRefs = (refs: readonly AnyResourceRef[]): readonly AnyResourceRef[] => {\n\tconst seen = new Set<string>();\n\tconst unique: AnyResourceRef[] = [];\n\tfor (const ref of refs) {\n\t\tif (seen.has(ref.id)) continue;\n\t\tseen.add(ref.id);\n\t\tunique.push(ref);\n\t}\n\treturn unique;\n};\n\nexport const resolveDependencyValues = <Input extends DependencyInput | undefined>(\n\tdependsOn: Input,\n\tread: (resource: DependencyList<Input>[number]) => unknown,\n): ResolvedDependencies<Input> => {\n\tconst readAny = (resourceRef: AnyResourceRef) =>\n\t\tread(resourceRef as DependencyList<Input>[number]);\n\n\tif (dependsOn === undefined) {\n\t\treturn undefined as ResolvedDependencies<Input>;\n\t}\n\tif (Array.isArray(dependsOn)) {\n\t\treturn dependsOn.map((resourceRef) => readAny(resourceRef)) as ResolvedDependencies<Input>;\n\t}\n\tif (isResourceRef(dependsOn)) {\n\t\treturn readAny(dependsOn) as ResolvedDependencies<Input>;\n\t}\n\treturn Object.fromEntries(\n\t\tObject.entries(dependsOn).map(([key, resourceRef]) => [key, readAny(resourceRef)]),\n\t) as ResolvedDependencies<Input>;\n};\n\nexport const resolvePluginDependencies = (\n\tplugin: AnyPlugin,\n\tread: (resource: AnyResourceRef) => unknown,\n): ResolvedDependencies<DependencyInput | undefined> =>\n\tresolveDependencyValues(plugin[dependencyInputBrand], (resourceRef) =>\n\t\tread(resourceRef as AnyResourceRef),\n\t);\n\nexport const pluginDependencyRefs = (plugin: AnyPlugin): readonly AnyResourceRef[] =>\n\tdependencyList(plugin[dependencyInputBrand]) as readonly AnyResourceRef[];\n\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends readonly AnyResourceRef[],\n\tconst Start extends PluginStart<ResolvedDependencyList<DependsOn>> = PluginStart<\n\t\tResolvedDependencyList<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, DependsOn, Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends Readonly<Record<string, AnyResourceRef>>,\n\tconst Start extends PluginStart<ResolvedDependencyObject<DependsOn>> = PluginStart<\n\t\tResolvedDependencyObject<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, DependencyList<DependsOn>, Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst DependsOn extends AnyResourceRef,\n\tconst Start extends PluginStart<ResourceValueOf<DependsOn>> = PluginStart<\n\t\tResourceValueOf<DependsOn>\n\t>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn: DependsOn;\n\t},\n): Plugin<Id, StartValue<Start>, readonly [DependsOn], Caps>;\nexport function definePlugin<\n\tconst Id extends string,\n\tconst Start extends PluginStart<undefined> = PluginStart<undefined>,\n\tconst Caps extends ReadonlyArray<CapabilityDecl> = ReadonlyArray<CapabilityDecl>,\n>(\n\tspec: PluginSpecBase<Id, Start, Caps> & {\n\t\treadonly dependsOn?: undefined;\n\t},\n): Plugin<Id, StartValue<Start>, readonly [], Caps>;\nexport function definePlugin(\n\tspec: PluginSpecBase<string, AnyPluginStart, ReadonlyArray<CapabilityDecl>> & {\n\t\treadonly dependsOn?: DependencyInput;\n\t},\n): AnyPlugin {\n\tconst dependsOn = uniqueResourceRefs(dependencyList(spec.dependsOn));\n\tconst capabilitiesField = spec.capabilities;\n\tconst capabilities =\n\t\ttypeof capabilitiesField === 'function'\n\t\t\t? (value: unknown, runtime: AcquireContext) => capabilitiesField({ value, runtime })\n\t\t\t: capabilitiesField;\n\n\treturn {\n\t\t[resourceBrand]: true,\n\t\t[pluginBrand]: true,\n\t\t[dependencyInputBrand]: spec.dependsOn,\n\t\tid: spec.id,\n\t\tdependsOn,\n\t\trole: spec.role,\n\t\tsection: spec.section,\n\t\tstart: spec.start as AnyPlugin['start'],\n\t\t...(spec.pluginKey === undefined ? {} : { pluginKey: spec.pluginKey }),\n\t\t...(spec.watch === undefined ? {} : { watch: spec.watch }),\n\t\t...(capabilities === undefined ? {} : { capabilities }),\n\t\t...(spec.errorContributions === undefined\n\t\t\t? {}\n\t\t\t: { errorContributions: spec.errorContributions }),\n\t\t...(spec.endpointSection === undefined ? {} : { endpointSection: spec.endpointSection }),\n\t} as AnyPlugin;\n}\n\nexport type ProvidedIdsOf<Members> =\n\tMembers extends ReadonlyArray<unknown>\n\t\t? Members[number] extends { readonly id: infer Id extends string }\n\t\t\t? Id\n\t\t\t: never\n\t\t: never;\n\nexport type ConsumedIdsOf<Members> =\n\tMembers extends ReadonlyArray<unknown>\n\t\t? Members[number] extends { readonly dependsOn: infer Dependencies }\n\t\t\t? Dependencies extends ReadonlyArray<infer Dependency>\n\t\t\t\t? Dependency extends { readonly id: infer Id extends string }\n\t\t\t\t\t? Id\n\t\t\t\t\t: never\n\t\t\t\t: never\n\t\t\t: never\n\t\t: never;\n\nexport type MissingProviders<Members> = Exclude<ConsumedIdsOf<Members>, ProvidedIdsOf<Members>>;\n\nexport interface __MissingProvidersError<Missing extends string> {\n\treadonly __missing_providers: Missing;\n}\n"],"mappings":";AAeA,MAAM,gBAA+B,OAAO,IAAI,oBAAoB;AACpE,MAAM,cAA6B,OAAO,IAAI,kBAAkB;AAEhE,MAAM,uBAAsC,OAAO,IAAI,mCAAmC;AAe1F,MAAa,YAAqC,OAAe;AAEjE,MAAa,YACZ,QAEC;CACA;EACC,gBAAgB;CACjB;AAEF,MAAa,iBAAiB,UAC7B,OAAO,UAAU,YACjB,UAAU,QACT,MAA8C,mBAAmB;AAsJnE,MAAa,YAAY,UACxB,OAAO,UAAU,YACjB,UAAU,QACT,MAA4C,iBAAiB;AAE/D,MAAa,kBACZ,cAC2B;AAC3B,KAAI,cAAc,KAAA,EACjB,QAAO,EAAE;AAEV,KAAI,MAAM,QAAQ,UAAU,CAC3B,QAAO;AAER,KAAI,cAAc,UAAU,CAC3B,QAAO,CAAC,UAAU;AAEnB,QAAO,OAAO,OAAO,UAAU;;AAGhC,MAAa,sBAAsB,SAA+D;CACjG,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAA2B,EAAE;AACnC,MAAK,MAAM,OAAO,MAAM;AACvB,MAAI,KAAK,IAAI,IAAI,GAAG,CAAE;AACtB,OAAK,IAAI,IAAI,GAAG;AAChB,SAAO,KAAK,IAAI;;AAEjB,QAAO;;AAGR,MAAa,2BACZ,WACA,SACiC;CACjC,MAAM,WAAW,gBAChB,KAAK,YAA6C;AAEnD,KAAI,cAAc,KAAA,EACjB;AAED,KAAI,MAAM,QAAQ,UAAU,CAC3B,QAAO,UAAU,KAAK,gBAAgB,QAAQ,YAAY,CAAC;AAE5D,KAAI,cAAc,UAAU,CAC3B,QAAO,QAAQ,UAAU;AAE1B,QAAO,OAAO,YACb,OAAO,QAAQ,UAAU,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAAC,KAAK,QAAQ,YAAY,CAAC,CAAC,CAClF;;AAGF,MAAa,6BACZ,QACA,SAEA,wBAAwB,OAAO,wBAAwB,gBACtD,KAAK,YAA8B,CACnC;AAEF,MAAa,wBAAwB,WACpC,eAAe,OAAO,sBAAsB;AA+C7C,SAAgB,aACf,MAGY;CACZ,MAAM,YAAY,mBAAmB,eAAe,KAAK,UAAU,CAAC;CACpE,MAAM,oBAAoB,KAAK;CAC/B,MAAM,eACL,OAAO,sBAAsB,cACzB,OAAgB,YAA4B,kBAAkB;EAAE;EAAO;EAAS,CAAC,GAClF;AAEJ,QAAO;GACL,gBAAgB;GAChB,cAAc;GACd,uBAAuB,KAAK;EAC7B,IAAI,KAAK;EACT;EACA,MAAM,KAAK;EACX,SAAS,KAAK;EACd,OAAO,KAAK;EACZ,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,GAAG,EAAE,WAAW,KAAK,WAAW;EACrE,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO;EACzD,GAAI,iBAAiB,KAAA,IAAY,EAAE,GAAG,EAAE,cAAc;EACtD,GAAI,KAAK,uBAAuB,KAAA,IAC7B,EAAE,GACF,EAAE,oBAAoB,KAAK,oBAAoB;EAClD,GAAI,KAAK,oBAAoB,KAAA,IAAY,EAAE,GAAG,EAAE,iBAAiB,KAAK,iBAAiB;EACvF"}

package/dist/substrate/projection.d.mts

@@ -25,6 +25,19 @@ interface SubscribableState {
   };
   readonly stackBuild: ReadonlyArray<BuildEntry>;
 }
+/** Closed vocabulary of dashboard section buckets a row belongs to.
+ *
+ *  The renderer groups rows by `Row.section` and the event log colors
+ *  scope chips by it. The vocabulary is intentionally small and
+ *  plugin-domain-agnostic — each plugin declares its section ONCE at
+ *  `definePlugin({ ..., section })` time and the supervisor stamps it
+ *  onto every row it constructs.
+ *
+ *  Adding a section is a substrate revision: the closed list lives
+ *  here so the TUI's `sectionLabel` / `sectionColor` cases stay
+ *  exhaustive.
+ */
+type RowSection = 'service' | 'package' | 'account' | 'action' | 'app' | 'other';
 /** One row per visible plugin instance. */
 interface Row {
   readonly key: PluginKey;
@@ -35,6 +48,17 @@ interface Row {
   readonly logTail: LogTail;
   readonly endpoints: ReadonlyArray<EndpointKey>;
   readonly selectiveRestartHighlight: boolean;
+  /** Dashboard section bucket the row belongs to. Plugin-declared at
+   *  `definePlugin({ section })` time; the supervisor stamps the
+   *  declaration onto the row at acquire. Renderers consume this
+   *  field directly — they MUST NOT pattern-match on `key` substrings
+   *  to derive a section. */
+  readonly section: RowSection;
+  /** Section bucket the row should render in once it owns a routed
+   *  endpoint. Defaults to `section` (i.e. no override). Plugins set
+   *  `endpointSection` when an "app"-style row should re-bucket to
+   *  the services list as soon as its URL is up. */
+  readonly endpointSection: RowSection;
 }
 interface LogTail {
   readonly lines: ReadonlyArray<string>;
@@ -43,10 +67,11 @@ interface LogTail {
 }
 interface Endpoint {
   readonly endpointKey: EndpointKey;
+  readonly pluginKey: PluginKey;
   readonly name: string;
   readonly url: string;
   readonly displayUrl: string | null;
-  readonly wireProtocol: 'http' | 'h2c' | string;
+  readonly wireProtocol: 'http' | 'h2c' | 'tcp';
   readonly registeredAt: number;
 }
 interface AccountProjection {
@@ -64,7 +89,14 @@ interface AccountProjection {
       readonly coin: string;
       readonly fullCoinType: string;
       readonly amount: string;
-      readonly status: 'funded' | 'skipped';
+      /** `'funded'` — a faucet call satisfied the request.
+       *  `'already-satisfied'` — the pre-existing balance covered
+       *  the request (no faucet call needed); semantically a
+       *  success, surfaced distinctly so renderers can show
+       *  "✓ cached" vs "✓ funded" if they want to.
+       *  `'skipped'` — zero-amount no-op, or the funding pass
+       *  never reached the entry. */
+      readonly status: 'funded' | 'already-satisfied' | 'skipped';
     }>;
   };
   readonly walletVisible: boolean;
@@ -96,5 +128,5 @@ interface BuildEntry {
   readonly startedAt: number;
 }
 //#endregion
-export { AccountProjection, BuildEntry, Endpoint, PackageProjection, StructuredError, SubscribableState };
+export { BuildEntry, Endpoint, RowSection, StructuredError, SubscribableState };
 //# sourceMappingURL=projection.d.mts.map

package/dist/substrate/runtime/artifact-publisher/index.mjs

@@ -1,5 +1,8 @@
+import { SpanAttr } from "../observability/spans.mjs";
 import { parseJsonTextSync } from "../runtime-decode.mjs";
 import { CacheService } from "../cache/service.mjs";
+import "../cache/index.mjs";
+import { setCurrentPluginPhase } from "../current-plugin.mjs";
 import { Context, Effect, Layer } from "effect";
 //#region src/substrate/runtime/artifact-publisher/index.ts
 /**
@@ -12,7 +15,7 @@ import { Context, Effect, Layer } from "effect";
 * stacks isolate by construction — each stack's Layer build is
 * independent.
 */
-var ArtifactPublisherService = class extends Context.Service()("@devstack-rewrite/substrate/ArtifactPublisher") {};
+var ArtifactPublisherService = class extends Context.Service()("@devstack/substrate/ArtifactPublisher") {};
 const encode = (value) => new TextEncoder().encode(JSON.stringify(value));
 const decode = (bytes) => {
 	try {
@@ -26,9 +29,9 @@ const decode = (bytes) => {
 };
 const makePublisher = (cache) => ({ publish: (spec) => Effect.gen(function* () {
 	yield* Effect.annotateCurrentSpan({
-		"artifactPublisher.namespace": spec.namespace,
-		"artifactPublisher.chain": spec.chain,
-		"artifactPublisher.contentHash": spec.contentHash
+		[SpanAttr.artifactPublisherNamespace]: spec.namespace,
+		[SpanAttr.artifactPublisherChain]: spec.chain,
+		[SpanAttr.artifactPublisherContentHash]: spec.contentHash
 	});
 	const hit = yield* cache.lookup({
 		namespace: spec.namespace,
@@ -39,14 +42,21 @@ const makePublisher = (cache) => ({ publish: (spec) => Effect.gen(function* () {
 		const cached = decode(hit.bytes);
 		if (cached !== null) {
 			if ((yield* spec.verify(cached)) !== null) {
-				const payload = cached;
-				yield* spec.register(payload);
-				yield* Effect.annotateCurrentSpan({ "artifactPublisher.path": "hit" });
-				return payload;
+				yield* spec.register(cached);
+				yield* Effect.annotateCurrentSpan({ [SpanAttr.artifactPublisherPath]: "hit" });
+				yield* Effect.logDebug(`artifact-publisher: reusing cached '${spec.namespace}' on chain ${spec.chain} (cache hit; no re-deploy).`);
+				return cached;
 			}
 		}
 	}
-	yield* Effect.annotateCurrentSpan({ "artifactPublisher.path": hit === null ? "miss" : "verify-failed" });
+	if (hit === null) {
+		yield* Effect.annotateCurrentSpan({ [SpanAttr.artifactPublisherPath]: "miss" });
+		yield* Effect.logInfo(`artifact-publisher: producing '${spec.namespace}' on chain ${spec.chain} — no cached artifact for this chain + content hash (first deploy on this chain, fresh genesis after a restart, or changed inputs).`);
+	} else {
+		yield* Effect.annotateCurrentSpan({ [SpanAttr.artifactPublisherPath]: "verify-failed" });
+		yield* Effect.logWarning(`artifact-publisher: re-deploying '${spec.namespace}' on chain ${spec.chain} — a cached artifact existed but failed on-chain verification (object missing, or RPC unavailable during restart); a new id will replace the prior deployment.`);
+		yield* setCurrentPluginPhase(`re-deploying ${spec.namespace} (cached artifact failed verification on restart)`);
+	}
 	const produced = yield* spec.produce;
 	yield* cache.write({
 		namespace: spec.namespace,