@specverse/engines 6.33.0 → 6.34.0

package/dist/realize/resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/realize/resolver/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AA8HrC,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGhC;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,UAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAU;QAGpC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAwBD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,KAAK,UAAU,sBAAsB,CACnC,IAAY,EACZ,QAAgB;IAEhB,uEAAuE;IACvE,sCAAsC;IACtC,+CAA+C;IAC/C,gDAAgD;IAChD,KAAK,IAAI,CAAC;IACV,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,oBAAoB,CACjC,WAAmB;IAEnB,uEAAuE;IACvE,oEAAoE;IACpE,4BAA4B;IAC5B,kDAAkD;IAClD,KAAK,WAAW,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,eAAe,GAAG,SAAS,CAAC;AAElC;;GAEG;AACH,SAAS,eAAe,CAAC,OAAuB;IAC9C,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACpD,OAAO,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,OAAuB;IACpD,IAAI,OAAO,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,KAAK,GAAG,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,QAAgB,EAAE,GAAW,EAAE,OAAgB;IAChE,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,QAAgB,EAAE,GAAW,EAAE,KAAiB;IAClE,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;QAC/C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,sBAAsB;IAC1B,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,OAAgB,EAChB,UAA0B,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE;QAEtF,MAAM,gBAAgB,GAAG,OAAO,IAAI,eAAe,CAAC;QACpD,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,2EAA2E;QAC3E,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CACtD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CACvB,CAAC;QACF,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE;gBACtF,YAAY,EAAE,UAAU,CAAC,IAAI;gBAC7B,eAAe,EAAE,UAAU,CAAC,OAAO;aACpC,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/B,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC9E,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAA4B,CAAC;gBAC1F,MAAM,OAAO,GAAI,OAAO,CAAC,MAAM,CAAY,IAAI,IAAI,CAAC;gBACpD,MAAM,UAAU,GAAI,OAAO,CAAC,SAAS,CAAY,IAAI,gBAAgB,CAAC;gBACtE,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE;oBAC5C,YAAY,EAAE,OAAO;oBACrB,eAAe,EAAE,UAAU;oBAC3B,gBAAgB,EAAE,OAAO;iBAC1B,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,yBAAyB,CACjC,mBAAmB,IAAI,oDAAoD;gBACzE,8CAA8C;gBAC9C,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACrC,IAAI,EACJ,UAAU,CACX,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE3B,4EAA4E;QAC5E,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACtC,MAAM,eAAe,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,oBAAoB,EAAE,CAAC;YACvE,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,oBAAoB;gBAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;gBACtE,YAAY,EAAE,eAAe,CAAC,IAAI;gBAClC,eAAe,EAAE,eAAe,CAAC,OAAO;gBACxC,gBAAgB,EAAE,eAAe,CAAC,IAAI;gBACtC,WAAW,EAAE,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;aAC9E,CAAC;QACJ,CAAC;QAED,MAAM,uBAAuB,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACrF,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAe;gBACxB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,MAAM,EAAE,oBAAoB;gBAC5B,IAAI,EAAE,uBAAuB,CAAC,IAAI;gBAClC,OAAO,EAAE,uBAAuB,CAAC,OAAO;gBACxC,IAAI,EAAE,uBAA6D;aACpE,CAAC;YACF,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,oBAAoB;gBAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,uBAAuB,CAAC,OAAO,EAAE;gBACtF,YAAY,EAAE,uBAAuB,CAAC,IAAI;gBAC1C,eAAe,EAAE,uBAAuB,CAAC,OAAO;gBAChD,gBAAgB,EAAE,uBAAuB,CAAC,IAAI;gBAC9C,WAAW,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,uBAAuB,CAAC,OAAO,EAAE;aAC9F,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,YAAY,GAAG,EAAE,CAAC;QACrC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YACjE,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE;gBAClE,YAAY,EAAE,aAAa,CAAC,IAAI;gBAChC,eAAe,EAAE,aAAa,CAAC,OAAO;gBACtC,gBAAgB,EAAE,aAAa,CAAC,IAAI;gBACpC,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE;aAC1E,CAAC;QACJ,CAAC;QAED,MAAM,qBAAqB,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,qBAAqB,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAe;gBACxB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,OAAO,EAAE,qBAAqB,CAAC,OAAO;gBACtC,IAAI,EAAE,qBAA2D;aAClE,CAAC;YACF,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YACxC,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE;gBAClF,YAAY,EAAE,qBAAqB,CAAC,IAAI;gBACxC,eAAe,EAAE,qBAAqB,CAAC,OAAO;gBAC9C,gBAAgB,EAAE,qBAAqB,CAAC,IAAI;gBAC5C,WAAW,EAAE,EAAE,IAAI,EAAE,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE;aAC1F,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,MAAM,IAAI,yBAAyB,CACjC,mBAAmB,IAAI,gBAAgB,gBAAgB,MAAM;YAC3D,+CAA+C;YAC/C,YAAY,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;YACtC,8EAA8E,IAAI,IAAI,EACxF,IAAI,EACJ,UAAU,CACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,UAAkB,EAClB,UAA0B,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE;QAEtF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,uEAAuE;YACvE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,eAAe,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAElD,qBAAqB;QACrB,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YACnD,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,MAAM,CAAC,IAA+B;aACjD,CAAC;QACJ,CAAC;QAED,oDAAoD;QACpD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAe;gBACxB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAA4C;aACnD,CAAC;YACF,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACjC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnF,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,sBAAsB,EAAE,CAAC;AACtC,CAAC"}

package/dist/realize/runtime-emitters/dispatcher.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Per-runtime emitter dispatcher — V2 Phase 3, Round 1.
+ *
+ * Proposal: 2026-05-08-COMPONENT-DEPENDENCIES-V2.md, "Realize bridge" section.
+ *
+ * The dispatcher is a small registry + lookup framework. The real work lives in
+ * each topology-specific emitter implementation (library.ts, and future
+ * service.ts / managed.ts / executable.ts / messaging.ts files).
+ *
+ * Round 1 ships: dispatcher framework + library topology emitter (this file +
+ * library.ts). The two cross-branch types — `ResolvedComponent` (Agent A) and
+ * `FactoryV2Metadata` / `InstanceFactory` (Agent B) — are imported from their
+ * canonical locations: Round 1d (this commit) reconciled the local stubs with
+ * the merged real types.
+ *
+ * Round 2 will add: service, managed, executable, messaging emitters + CLI wiring.
+ */
+import type { ComponentSpec, SpecVerseAST, InstanceFactory, FactoryTopology } from '@specverse/types';
+import type { ResolvedComponent } from '../resolver/index.js';
+export type { ResolvedComponent } from '../resolver/index.js';
+export type { FactoryTopology, InstanceFactory } from '@specverse/types';
+/** Alias kept for back-compat with the Round-1 stub naming. */
+export type FactoryMetadata = InstanceFactory;
+/**
+ * A single entry in a component's `import:` block.
+ * Mirrors the V2 Phase 1 schema additions (commit bb4b99b):
+ *   - from: provider name (resolved via 4-step lookup)
+ *   - version?: semver range (optional, defaults to ^latest)
+ *   - select: array of bare or dotted operation names
+ */
+export interface ImportEntry {
+    from: string;
+    version?: string;
+    select: string[];
+}
+/**
+ * Context passed to every runtime emitter.
+ * Carries the consumer-side view (component + import entry) alongside
+ * the resolved provider (Agent A) and the factory metadata (Agent B).
+ */
+export interface RuntimeEmitterContext {
+    /** The component that contains the `import:` block. */
+    consumerComponent: ComponentSpec;
+    /** The specific {from, version?, select} entry being emitted. */
+    importEntry: ImportEntry;
+    /**
+     * Resolver result for this import entry.
+     * Round 1 stub: callers construct this manually; Agent A's resolver will
+     * produce it automatically when integrated in Round 2.
+     */
+    resolved: ResolvedComponent;
+    /**
+     * Factory metadata from the manifest's capabilityMappings.
+     * Round 1 stub: callers construct this manually; Agent B's schema +
+     * the registry-aware manifest-emitter will produce it when integrated.
+     */
+    factory: FactoryMetadata;
+    /**
+     * Absolute path to the consumer component's realize output directory.
+     * Generated clients land at `<outputDir>/clients/<provider-name>.ts`.
+     */
+    outputDir: string;
+    /**
+     * The full parsed spec, for cross-component type lookups.
+     * Optional in Round 1 — the library emitter doesn't need cross-spec
+     * lookups yet; future emitters may need it for server-bind code.
+     */
+    spec?: SpecVerseAST;
+}
+/**
+ * Structured deployment-instance suggestion an emitter produces alongside
+ * its files/imports. The realize pipeline collects every emitter's
+ * suggestions into `<outputDir>/v2-deployment-suggestions.yaml` (V2 P3
+ * Round 3 follow-up), which the user merges into their deployment block
+ * manually. Auto-merge isn't safe — deployment shape is user-controlled
+ * (env-specific values, secrets, scaling parameters).
+ *
+ * Library-topology emitters do NOT produce suggestions (libraries are
+ * in-process imports, not deployment instances).
+ */
+export interface DeploymentInstanceSuggestion {
+    /** Provider name (importEntry.from) — anchors the suggestion to its import. */
+    provider: string;
+    /** Component that declared the import — for cross-checking which
+     *  deployment-instance scope the suggestion belongs to. */
+    consumerComponent?: string;
+    /**
+     * Which deployment-instance category this provider lands in. Mirrors
+     * the schema's InstancesSection keys (services, communications,
+     * infrastructure, …). Out-of-band categories should not be used.
+     */
+    category: 'services' | 'communications' | 'infrastructure' | 'storage' | 'security' | 'monitoring';
+    /** Instance key under the category (lower-camelCase client name). */
+    key: string;
+    /** Pre-built config block — placeholder values use `<...>` markers. */
+    config: Record<string, unknown>;
+    /** Factory name driving the choice (manifest.capabilityMappings). */
+    factory: string;
+    /** Topology that emitted this suggestion. */
+    topology: FactoryTopology;
+    /** Optional review-time hints (TODOs, OAuth flows, etc.). */
+    reviewNotes?: string[];
+}
+/**
+ * What a runtime emitter produces.
+ */
+export interface RuntimeEmitterResult {
+    /**
+     * Files to write into the consumer's output directory.
+     * Paths are relative to `outputDir`.
+     */
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    /**
+     * Import statements the consumer's main module (SalesReportController.ts)
+     * should add to wire up the generated client.
+     */
+    imports: Array<{
+        from: string;
+        specifier: string;
+    }>;
+    /**
+     * Optional realize-time hints or warnings.
+     */
+    notes?: string[];
+    /**
+     * V2 P3 R3 follow-up: structured deployment-instance suggestion. The
+     * free-text equivalent is in `notes` for human review; this field is
+     * the machine-readable version that the realize pipeline aggregates
+     * into v2-deployment-suggestions.yaml. Library-topology emissions
+     * omit this field.
+     */
+    deploymentSuggestion?: DeploymentInstanceSuggestion;
+}
+/**
+ * Contract every topology-specific emitter must satisfy.
+ */
+export interface RuntimeEmitter {
+    /** The topology this emitter handles. Drives dispatch lookup. */
+    topology: FactoryTopology;
+    /** Emit files for one import entry. */
+    emit(ctx: RuntimeEmitterContext): Promise<RuntimeEmitterResult>;
+}
+/**
+ * Look up the correct emitter for the factory's topology.
+ *
+ * The emitters map is injected by the caller, making the dispatcher
+ * extensible without engine changes: register new emitters by adding
+ * entries to the map.
+ *
+ * @param factory - The resolved factory metadata (drives the topology lookup).
+ * @param emitters - Registry of topology → RuntimeEmitter. Typically built
+ *   once per realize run by `buildDefaultEmitters()`.
+ * @returns The matching RuntimeEmitter.
+ * @throws Error if no emitter is registered for the factory's topology.
+ */
+export declare function dispatchRuntimeEmitter(factory: FactoryMetadata, emitters: Map<string, RuntimeEmitter>): RuntimeEmitter;
+/**
+ * Build the default emitter registry for a realize run.
+ *
+ * Round 1 shipped library; Round 2 added service / managed / executable /
+ * messaging. All 5 are registered here so the realize-side dispatcher can
+ * pick whichever the factory's v2metadata.topology selects.
+ *
+ * The 'external' topology is intentionally NOT registered — V2's design
+ * defines it as a passthrough requiring manual wiring (no auto-emission).
+ * Specs that bind a factory with topology: 'external' will trip a clear
+ * "No runtime emitter registered" error, which is the desired behavior.
+ *
+ * Imports are deferred to avoid circular deps — each emitter file imports
+ * only from dispatcher.ts, not vice versa.
+ */
+export declare function buildDefaultEmitters(): Promise<Map<string, RuntimeEmitter>>;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/realize/runtime-emitters/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/realize/runtime-emitters/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzE,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAI9C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,iBAAiB,EAAE,aAAa,CAAC;IACjC,iEAAiE;IACjE,WAAW,EAAE,WAAW,CAAC;IACzB;;;;OAIG;IACH,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB;+DAC2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,UAAU,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;IACnG,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,eAAe,CAAC;IAC1B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD;;;OAGG;IACH,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,4BAA4B,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,EAAE,eAAe,CAAC;IAC1B,uCAAuC;IACvC,IAAI,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACjE;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GACpC,cAAc,CAchB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAsBjF"}

package/dist/realize/runtime-emitters/dispatcher.js

@@ -0,0 +1,76 @@
+/**
+ * Per-runtime emitter dispatcher — V2 Phase 3, Round 1.
+ *
+ * Proposal: 2026-05-08-COMPONENT-DEPENDENCIES-V2.md, "Realize bridge" section.
+ *
+ * The dispatcher is a small registry + lookup framework. The real work lives in
+ * each topology-specific emitter implementation (library.ts, and future
+ * service.ts / managed.ts / executable.ts / messaging.ts files).
+ *
+ * Round 1 ships: dispatcher framework + library topology emitter (this file +
+ * library.ts). The two cross-branch types — `ResolvedComponent` (Agent A) and
+ * `FactoryV2Metadata` / `InstanceFactory` (Agent B) — are imported from their
+ * canonical locations: Round 1d (this commit) reconciled the local stubs with
+ * the merged real types.
+ *
+ * Round 2 will add: service, managed, executable, messaging emitters + CLI wiring.
+ */
+// ─── Dispatcher ───────────────────────────────────────────────────────────────
+/**
+ * Look up the correct emitter for the factory's topology.
+ *
+ * The emitters map is injected by the caller, making the dispatcher
+ * extensible without engine changes: register new emitters by adding
+ * entries to the map.
+ *
+ * @param factory - The resolved factory metadata (drives the topology lookup).
+ * @param emitters - Registry of topology → RuntimeEmitter. Typically built
+ *   once per realize run by `buildDefaultEmitters()`.
+ * @returns The matching RuntimeEmitter.
+ * @throws Error if no emitter is registered for the factory's topology.
+ */
+export function dispatchRuntimeEmitter(factory, emitters) {
+    // V2 P3 R1d reconciliation: Agent B's loader populates factory.v2metadata
+    // (with topology defaulted from factory.category). Pre-V2 factories
+    // without v2metadata fall back to 'library' — the only emitter Round 1
+    // registers, so dispatch is deterministic.
+    const topology = factory.v2metadata?.topology ?? 'library';
+    const emitter = emitters.get(topology);
+    if (!emitter) {
+        const available = Array.from(emitters.keys()).sort().join(', ');
+        throw new Error(`No runtime emitter registered for topology '${topology}'. Available: ${available || '(none)'}`);
+    }
+    return emitter;
+}
+/**
+ * Build the default emitter registry for a realize run.
+ *
+ * Round 1 shipped library; Round 2 added service / managed / executable /
+ * messaging. All 5 are registered here so the realize-side dispatcher can
+ * pick whichever the factory's v2metadata.topology selects.
+ *
+ * The 'external' topology is intentionally NOT registered — V2's design
+ * defines it as a passthrough requiring manual wiring (no auto-emission).
+ * Specs that bind a factory with topology: 'external' will trip a clear
+ * "No runtime emitter registered" error, which is the desired behavior.
+ *
+ * Imports are deferred to avoid circular deps — each emitter file imports
+ * only from dispatcher.ts, not vice versa.
+ */
+export async function buildDefaultEmitters() {
+    const [{ LibraryRuntimeEmitter }, { ServiceRuntimeEmitter }, { ManagedRuntimeEmitter }, { ExecutableRuntimeEmitter }, { MessagingRuntimeEmitter },] = await Promise.all([
+        import('./library.js'),
+        import('./service.js'),
+        import('./managed.js'),
+        import('./executable.js'),
+        import('./messaging.js'),
+    ]);
+    const map = new Map();
+    map.set('library', new LibraryRuntimeEmitter());
+    map.set('service', new ServiceRuntimeEmitter());
+    map.set('managed', new ManagedRuntimeEmitter());
+    map.set('executable', new ExecutableRuntimeEmitter());
+    map.set('messaging', new MessagingRuntimeEmitter());
+    return map;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/realize/runtime-emitters/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../../src/realize/runtime-emitters/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyIH,iFAAiF;AAEjF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAwB,EACxB,QAAqC;IAErC,0EAA0E;IAC1E,oEAAoE;IACpE,uEAAuE;IACvE,2CAA2C;IAC3C,MAAM,QAAQ,GAAoB,OAAO,CAAC,UAAU,EAAE,QAAQ,IAAI,SAAS,CAAC;IAC5E,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,+CAA+C,QAAQ,iBAAiB,SAAS,IAAI,QAAQ,EAAE,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,CACJ,EAAE,qBAAqB,EAAE,EACzB,EAAE,qBAAqB,EAAE,EACzB,EAAE,qBAAqB,EAAE,EACzB,EAAE,wBAAwB,EAAE,EAC5B,EAAE,uBAAuB,EAAE,EAC5B,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,cAAc,CAAC;QACtB,MAAM,CAAC,cAAc,CAAC;QACtB,MAAM,CAAC,cAAc,CAAC;QACtB,MAAM,CAAC,iBAAiB,CAAC;QACzB,MAAM,CAAC,gBAAgB,CAAC;KACzB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,wBAAwB,EAAE,CAAC,CAAC;IACtD,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,uBAAuB,EAAE,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/realize/runtime-emitters/executable.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Executable-runtime emitter — V2 Phase 3, Round 2.
+ *
+ * Handles `topology: 'executable'` factories: providers reached via
+ * `spawnSync` / `execSync` — local CLI binaries such as gitnexus, ffmpeg,
+ * or custom binaries.
+ *
+ * For each `import:` entry the consumer declares, this emitter produces:
+ *   clients/<kebab-provider>.ts   — spawnSync wrapper with typed interface
+ *
+ * The generated client module:
+ *   - Emits an `assertBinaryAvailable()` function called at module load
+ *     that runs `spawnSync('which', [binary])` (or `spawnSync(binary, ['--version'])`
+ *     as fallback) to fail loud at boot if the binary isn't on PATH.
+ *   - Exports a `<ProviderName>Client` TypeScript interface matching the
+ *     selected operations from `import.select`.
+ *   - Exports a `<providerName>Client` constant that implements the interface
+ *     by dispatching to `spawnSync`:
+ *       * Dotted op `Subcommand.action`: runs `spawnSync(binary, ['subcommand', 'action', ...args])`.
+ *       * Bare entity: runs `spawnSync(binary, [entity.toLowerCase(), ...args])`.
+ *     stdout is parsed as JSON; non-zero exit throws a clear Error.
+ *
+ * --- Binary name resolution ---
+ *
+ * The binary name is read from:
+ *   1. `factory.v2metadata.config?.binary` (explicit override)
+ *   2. `factory.name` lowercased (e.g. 'Gitnexus' → 'gitnexus')
+ *
+ * --- Select grammar ---
+ *
+ * Follows V2 D2 resolution (same as library.ts):
+ *   - Dotted: `Subcommand.action` → dispatches `spawnSync(binary, ['subcommand', 'action', ...])`.
+ *   - Bare:   `EntityName`        → dispatches `spawnSync(binary, [entityname, ...])`.
+ *
+ * --- No server file ---
+ *
+ * Subprocess providers don't have a server-bind file.
+ *
+ * --- Deployment instance hint ---
+ *
+ * Emitter notes include a hint to add the provider to
+ * `deployments.<env>.instances.infrastructure.<provider>` with
+ * `config: { binary: <name> }`.
+ */
+import type { RuntimeEmitter, RuntimeEmitterContext, RuntimeEmitterResult } from './dispatcher.js';
+/**
+ * Executable-runtime emitter implementation.
+ *
+ * One call to `emit()` processes a single `import:` entry and produces
+ * one client file under `clients/<provider-filename>.ts`.
+ * No server-bind file is emitted (subprocess providers have no server).
+ */
+export declare class ExecutableRuntimeEmitter implements RuntimeEmitter {
+    readonly topology: "executable";
+    emit(ctx: RuntimeEmitterContext): Promise<RuntimeEmitterResult>;
+}
+//# sourceMappingURL=executable.d.ts.map

package/dist/realize/runtime-emitters/executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executable.d.ts","sourceRoot":"","sources":["../../../src/realize/runtime-emitters/executable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAuOzB;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,QAAQ,CAAC,QAAQ,EAAG,YAAY,CAAU;IAEpC,IAAI,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAsFtE"}

package/dist/realize/runtime-emitters/executable.js

@@ -0,0 +1,316 @@
+/**
+ * Executable-runtime emitter — V2 Phase 3, Round 2.
+ *
+ * Handles `topology: 'executable'` factories: providers reached via
+ * `spawnSync` / `execSync` — local CLI binaries such as gitnexus, ffmpeg,
+ * or custom binaries.
+ *
+ * For each `import:` entry the consumer declares, this emitter produces:
+ *   clients/<kebab-provider>.ts   — spawnSync wrapper with typed interface
+ *
+ * The generated client module:
+ *   - Emits an `assertBinaryAvailable()` function called at module load
+ *     that runs `spawnSync('which', [binary])` (or `spawnSync(binary, ['--version'])`
+ *     as fallback) to fail loud at boot if the binary isn't on PATH.
+ *   - Exports a `<ProviderName>Client` TypeScript interface matching the
+ *     selected operations from `import.select`.
+ *   - Exports a `<providerName>Client` constant that implements the interface
+ *     by dispatching to `spawnSync`:
+ *       * Dotted op `Subcommand.action`: runs `spawnSync(binary, ['subcommand', 'action', ...args])`.
+ *       * Bare entity: runs `spawnSync(binary, [entity.toLowerCase(), ...args])`.
+ *     stdout is parsed as JSON; non-zero exit throws a clear Error.
+ *
+ * --- Binary name resolution ---
+ *
+ * The binary name is read from:
+ *   1. `factory.v2metadata.config?.binary` (explicit override)
+ *   2. `factory.name` lowercased (e.g. 'Gitnexus' → 'gitnexus')
+ *
+ * --- Select grammar ---
+ *
+ * Follows V2 D2 resolution (same as library.ts):
+ *   - Dotted: `Subcommand.action` → dispatches `spawnSync(binary, ['subcommand', 'action', ...])`.
+ *   - Bare:   `EntityName`        → dispatches `spawnSync(binary, [entityname, ...])`.
+ *
+ * --- No server file ---
+ *
+ * Subprocess providers don't have a server-bind file.
+ *
+ * --- Deployment instance hint ---
+ *
+ * Emitter notes include a hint to add the provider to
+ * `deployments.<env>.instances.infrastructure.<provider>` with
+ * `config: { binary: <name> }`.
+ */
+// ─── Naming helpers (mirrors library.ts) ─────────────────────────────────────
+/**
+ * Parse a select entry into head + optional tail.
+ * Dotted: `Subcommand.action` → { head: 'Subcommand', tail: 'action' }
+ * Bare:   `EntityName`        → { head: 'EntityName', tail: undefined }
+ */
+function parseSelectEntry(entry) {
+    const dotIndex = entry.indexOf('.');
+    if (dotIndex === -1) {
+        return { head: entry, tail: undefined };
+    }
+    return {
+        head: entry.slice(0, dotIndex),
+        tail: entry.slice(dotIndex + 1),
+    };
+}
+/**
+ * Normalise a `from:` name into an array of words for identifier generation.
+ * Same implementation as library.ts — handles camelCase, scoped packages, hyphens.
+ */
+function toWords(fromName) {
+    const normalised = fromName.replace(/^@/, '').replace(/\//g, '-');
+    return normalised
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(' ')
+        .filter(Boolean)
+        .map((w) => w.toLowerCase());
+}
+/**
+ * Convert a from-name to a lower-camelCase client constant name.
+ * 'Gitnexus' → 'gitnexus', 'GitNexus' → 'gitNexus', '@ffmpeg/core' → 'ffmpegCore'
+ */
+function toClientName(fromName) {
+    const words = toWords(fromName);
+    if (words.length === 0)
+        return 'unknownClient';
+    return (words[0] +
+        words
+            .slice(1)
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join(''));
+}
+/**
+ * Convert a from-name to a PascalCase interface name suffix.
+ * 'Gitnexus' → 'Gitnexus', 'GitNexus' → 'Gitnexus', '@ffmpeg/core' → 'FfmpegCore'
+ */
+function toInterfaceName(fromName) {
+    const words = toWords(fromName);
+    return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+}
+/**
+ * Convert a from-name to a filesystem-safe kebab-case filename.
+ * 'Gitnexus' → 'gitnexus', 'GitNexus' → 'git-nexus', '@ffmpeg/core' → 'ffmpeg-core'
+ */
+function toFileName(fromName) {
+    return toWords(fromName).join('-');
+}
+// ─── Binary name resolution ───────────────────────────────────────────────────
+/**
+ * Resolve the binary name for spawnSync.
+ *
+ * Priority:
+ *   1. `factory.v2metadata.config?.binary` (explicit override)
+ *   2. `factory.name` lowercased (e.g. 'Gitnexus' → 'gitnexus',
+ *      'SubprocessCLIAdapter' → 'subprocesscliadapter' — callers should
+ *      prefer explicit `config.binary` for multi-word names)
+ */
+function resolveBinaryName(factory) {
+    const configBinary = factory.v2metadata
+        ?.config?.binary;
+    if (configBinary && typeof configBinary === 'string' && configBinary.length > 0) {
+        return configBinary;
+    }
+    return factory.name.toLowerCase();
+}
+// ─── Code-generation helpers ──────────────────────────────────────────────────
+/**
+ * Generate the `assertBinaryAvailable()` function that runs at module load.
+ *
+ * Uses `spawnSync('which', [binary])` as primary check (POSIX); on non-zero
+ * exit falls back to `spawnSync(binary, ['--version'])`. If both fail, throws
+ * a descriptive error pointing at the env-var escape hatch.
+ *
+ * The env-var name is SPECVERSE_<BINARY_UPPER>_PATH (e.g. SPECVERSE_PROFIT_CALC_PATH).
+ */
+function generateBinaryAvailabilityCheck(binary) {
+    const envVar = `SPECVERSE_${binary.toUpperCase().replace(/[^A-Z0-9]/g, '_')}_PATH`;
+    const lines = [];
+    lines.push(`import { spawnSync } from 'child_process';`);
+    lines.push('');
+    lines.push(`const BINARY = '${binary}';`);
+    lines.push(`const ENV_OVERRIDE = process.env['${envVar}'];`);
+    lines.push(`const EFFECTIVE_BINARY = ENV_OVERRIDE ?? BINARY;`);
+    lines.push('');
+    lines.push(`/** Assert the required binary is available on PATH before any calls are made. */`);
+    lines.push(`function assertBinaryAvailable(): void {`);
+    lines.push(`  const check = spawnSync('which', [EFFECTIVE_BINARY], { encoding: 'utf-8' });`);
+    lines.push(`  if (check.status !== 0) {`);
+    lines.push(`    // Fallback: try --version directly (useful when 'which' itself is absent)`);
+    lines.push(`    const direct = spawnSync(EFFECTIVE_BINARY, ['--version'], { encoding: 'utf-8' });`);
+    lines.push(`    if (direct.status !== 0 && direct.error) {`);
+    lines.push(`      throw new Error(\`Required binary \${EFFECTIVE_BINARY} not found on PATH. ` +
+        `Install it or update ${envVar} env var.\`);`);
+    lines.push(`    }`);
+    lines.push(`  }`);
+    lines.push(`}`);
+    lines.push('');
+    lines.push(`// Run at module load — catches missing-binary errors at app boot.`);
+    lines.push(`assertBinaryAvailable();`);
+    return lines.join('\n');
+}
+/**
+ * Generate the TypeScript interface for the executable client type.
+ *
+ * Dotted entries (`Subcommand.action`) → typed `(...args: unknown[]) => unknown` method.
+ * Bare entries (`EntityName`) → typed `(...args: unknown[]) => unknown` method (passthrough).
+ *
+ * Unlike the library emitter, subprocess calls are synchronous (`spawnSync`), so
+ * the return type is `unknown` (not `Promise<unknown>`). Callers may wrap in a
+ * Promise if they need async composition; the underlying I/O is blocking.
+ */
+function generateInterface(interfaceName, selectEntries) {
+    const lines = [];
+    lines.push(`export type ${interfaceName}Client = {`);
+    const seen = new Set();
+    for (const entry of selectEntries) {
+        if (seen.has(entry))
+            continue;
+        seen.add(entry);
+        const { head, tail } = parseSelectEntry(entry);
+        if (tail === undefined) {
+            // Bare entity — passthrough all args as JSON-encoded CLI arguments.
+            lines.push(`  /** Invokes: spawnSync(binary, ['${head.toLowerCase()}', ...JSON-encoded args]) */`);
+            lines.push(`  ${head}(...args: unknown[]): unknown;`);
+        }
+        else {
+            // Dotted operation — subcommand + action dispatch.
+            lines.push(`  /** Invokes: spawnSync(binary, ['${head.toLowerCase()}', '${tail}', ...JSON-encoded args]) */`);
+            lines.push(`  ${tail}(...args: unknown[]): unknown;`);
+        }
+    }
+    lines.push('};');
+    return lines.join('\n');
+}
+/**
+ * Generate the client constant — spawnSync-backed implementation.
+ *
+ * Each method:
+ *   1. JSON-encodes each argument via JSON.stringify.
+ *   2. Calls spawnSync with [subcommand, action, ...encodedArgs] (dotted) or
+ *      [entityname, ...encodedArgs] (bare).
+ *   3. On non-zero exit, throws Error('<binary> <subcommand>: <stderr>').
+ *   4. Parses stdout as JSON and returns the result.
+ */
+function generateClientConstant(clientName, interfaceName, selectEntries) {
+    const lines = [];
+    lines.push(`export const ${clientName}Client: ${interfaceName}Client = {`);
+    const seen = new Set();
+    for (const entry of selectEntries) {
+        if (seen.has(entry))
+            continue;
+        seen.add(entry);
+        const { head, tail } = parseSelectEntry(entry);
+        if (tail === undefined) {
+            // Bare entity passthrough — proxy all args as JSON-encoded CLI arguments.
+            const subcommand = head.toLowerCase();
+            lines.push(`  ${head}(...args: unknown[]): unknown {`);
+            lines.push(`    const encodedArgs = args.map((a) => JSON.stringify(a));`);
+            lines.push(`    const result = spawnSync(EFFECTIVE_BINARY, ['${subcommand}', ...encodedArgs], { encoding: 'utf-8' });`);
+            lines.push(`    if (result.status !== 0) {`);
+            lines.push(`      throw new Error(\`\${EFFECTIVE_BINARY} ${subcommand}: \${result.stderr}\`);`);
+            lines.push(`    }`);
+            lines.push(`    return JSON.parse(result.stdout);`);
+            lines.push(`  },`);
+        }
+        else {
+            // Dotted operation — subcommand (head) + action (tail) dispatch.
+            const subcommand = head.toLowerCase();
+            lines.push(`  ${tail}(...args: unknown[]): unknown {`);
+            lines.push(`    const encodedArgs = args.map((a) => JSON.stringify(a));`);
+            lines.push(`    const result = spawnSync(EFFECTIVE_BINARY, ['${subcommand}', '${tail}', ...encodedArgs], { encoding: 'utf-8' });`);
+            lines.push(`    if (result.status !== 0) {`);
+            lines.push(`      throw new Error(\`\${EFFECTIVE_BINARY} ${subcommand}: \${result.stderr}\`);`);
+            lines.push(`    }`);
+            lines.push(`    return JSON.parse(result.stdout);`);
+            lines.push(`  },`);
+        }
+    }
+    lines.push('};');
+    return lines.join('\n');
+}
+// ─── Executable emitter ───────────────────────────────────────────────────────
+/**
+ * Executable-runtime emitter implementation.
+ *
+ * One call to `emit()` processes a single `import:` entry and produces
+ * one client file under `clients/<provider-filename>.ts`.
+ * No server-bind file is emitted (subprocess providers have no server).
+ */
+export class ExecutableRuntimeEmitter {
+    topology = 'executable';
+    async emit(ctx) {
+        const { importEntry, resolved, factory } = ctx;
+        const selectEntries = importEntry.select ?? [];
+        // Resolve binary name: config?.binary → factory.name.toLowerCase()
+        const binary = resolveBinaryName(factory);
+        // Derive naming from the import's `from:` field.
+        const fileName = toFileName(importEntry.from);
+        const clientName = toClientName(importEntry.from);
+        const interfaceName = toInterfaceName(importEntry.from);
+        // File path relative to outputDir.
+        const relFilePath = `clients/${fileName}.ts`;
+        // Build file header.
+        const headerLines = [
+            '// FACTORY-EMITTED — DO NOT EDIT (R8)',
+            `// Generated by executable-runtime emitter — V2 Phase 3`,
+            `// Provider: ${importEntry.from} (${resolved.source}) via factory: ${factory.name}`,
+            `// Binary: ${binary}`,
+            '',
+        ];
+        // Build availability check block (includes `import { spawnSync }` and constant declaration).
+        const availabilityBlock = generateBinaryAvailabilityCheck(binary);
+        // Build interface.
+        const interfaceBlock = generateInterface(interfaceName, selectEntries);
+        // Build client constant.
+        const constantBlock = generateClientConstant(clientName, interfaceName, selectEntries);
+        // Assemble file.
+        const parts = [
+            ...headerLines,
+            availabilityBlock,
+            '',
+            interfaceBlock,
+            '',
+            constantBlock,
+            '',
+        ];
+        const content = parts.join('\n');
+        // Build the import entry for the consumer's controller file.
+        const consumerImport = {
+            from: `./clients/${fileName}`,
+            specifier: `${clientName}Client`,
+        };
+        // Notes: warnings + deployment instance hint.
+        const notes = [];
+        if (selectEntries.length === 0) {
+            notes.push(`Warning: import entry from '${importEntry.from}' has empty select: — no client members emitted.`);
+        }
+        // Deployment instance hint — provider lands in infrastructure category.
+        notes.push(`Deployment hint: add '${importEntry.from}' to deployments.<env>.instances.infrastructure` +
+            ` with config: { binary: '${binary}' }. No process lifecycle; just a binary path requirement.`);
+        const deploymentSuggestion = {
+            provider: importEntry.from,
+            consumerComponent: ctx.consumerComponent?.name,
+            category: 'infrastructure',
+            key: clientName,
+            config: {
+                binary,
+            },
+            factory: factory.name,
+            topology: 'executable',
+        };
+        return {
+            files: [{ path: relFilePath, content }],
+            imports: [consumerImport],
+            notes,
+            deploymentSuggestion,
+        };
+    }
+}
+//# sourceMappingURL=executable.js.map