@specverse/engines 6.32.0 → 6.33.0

package/dist/ai/manifest-emitter.d.ts

@@ -22,16 +22,25 @@
  *
  * The mapping IS a lookup table. This module IS that lookup table.
  *
- * V1 covers the common cases observed in the corpus:
- *   - Express routing → ExpressAPI
- *   - NestJS decorators → NestJSAPI
- *   - Prisma schema → PrismaDriver
- *   - Mongoose / mongodb-native → MongoDBDriver
- *   - React Native screens → ReactNativeApp
- *   - React DOM → ReactRuntime
- * Edge cases (drizzle, knex, raw pg without prisma, vue, svelte, etc.)
- * fall through to defaults that the user hand-edits. Better than
- * an LLM hallucinating a nonexistent factory name.
+ * V2 (engines 6.32.2+) — every emitted factory name MUST resolve in
+ * the registered InstanceFactoryLibrary. The previous hand-curated
+ * mapping referenced names that don't exist (`ExpressAPI`, `NestJSAPI`,
+ * `MongoDBDriver`, `ReactRuntime`, `ReactNativeApp`) — realize then
+ * left every model with `factory: unknown` and produced no code.
+ *
+ * Current mapping (registered factory names only — see
+ * `libs/instance-factories/<category>/<name>.yaml`):
+ *   - api.rest          → FastifyAPI                  (only HTTP factory shipped)
+ *   - storage.database  → PostgreSQL15 | MongoDBNativeDriver
+ *   - orm.schema/client → PrismaORM                   (when prisma signal present)
+ *   - service.controller/business/crud → PrismaServices
+ *   - app.frontend      → ReactAppRuntime             (no RN factory exists yet)
+ *   - messaging.events  → EventEmitter
+ *   - validation.runtime → ZodValidation
+ *   - app.entrypoint    → GenericApp
+ *   - project.scaffold  → GenericScaffold
+ * Edge cases (drizzle, knex, vue, svelte, react-native, etc.) fall
+ * through to the closest valid default and the user hand-edits.
  */
 import type { SpecVerseFacts } from '../analyse-prepass/index.js';
 export interface ManifestEmissionInput {
@@ -56,5 +65,21 @@ export interface ManifestEmissionResult {
  * complete top-level YAML document (with specVersion) suitable for
  * writing to `manifests/implementation.yaml`.
  */
+/**
+ * Engines 6.32.2+ — registry of factory names actually present in the
+ * shipped instance-factory library (`engines/libs/instance-factories/`).
+ * Source: `find libs/instance-factories -name '*.yaml' | xargs grep '^name:'`.
+ *
+ * Manifest emission MUST pick from this set; emitting a non-existent
+ * name leaves every realize-time model with `factory: unknown` and
+ * produces no code. The previous emitter referenced ExpressAPI /
+ * NestJSAPI / MongoDBDriver / ReactNativeApp / ReactRuntime — none of
+ * which exist — and bored-stiff realize would silently emit nothing.
+ *
+ * Hand-edit consumers can still write any factory name they like in
+ * the manifest; this guard only protects auto-emitted manifests from
+ * the analyse pipeline.
+ */
+export declare const KNOWN_FACTORIES: ReadonlySet<string>;
 export declare function emitManifest(input: ManifestEmissionInput): ManifestEmissionResult;
 //# sourceMappingURL=manifest-emitter.d.ts.map

package/dist/ai/manifest-emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-emitter.d.ts","sourceRoot":"","sources":["../../src/ai/manifest-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,KAAK,EAAE,cAAc,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAwFjF"}
+{"version":3,"file":"manifest-emitter.d.ts","sourceRoot":"","sources":["../../src/ai/manifest-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,KAAK,EAAE,cAAc,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAO9C,CAAC;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAqJjF"}

package/dist/ai/manifest-emitter.js

@@ -22,22 +22,54 @@
  *
  * The mapping IS a lookup table. This module IS that lookup table.
  *
- * V1 covers the common cases observed in the corpus:
- *   - Express routing → ExpressAPI
- *   - NestJS decorators → NestJSAPI
- *   - Prisma schema → PrismaDriver
- *   - Mongoose / mongodb-native → MongoDBDriver
- *   - React Native screens → ReactNativeApp
- *   - React DOM → ReactRuntime
- * Edge cases (drizzle, knex, raw pg without prisma, vue, svelte, etc.)
- * fall through to defaults that the user hand-edits. Better than
- * an LLM hallucinating a nonexistent factory name.
+ * V2 (engines 6.32.2+) — every emitted factory name MUST resolve in
+ * the registered InstanceFactoryLibrary. The previous hand-curated
+ * mapping referenced names that don't exist (`ExpressAPI`, `NestJSAPI`,
+ * `MongoDBDriver`, `ReactRuntime`, `ReactNativeApp`) — realize then
+ * left every model with `factory: unknown` and produced no code.
+ *
+ * Current mapping (registered factory names only — see
+ * `libs/instance-factories/<category>/<name>.yaml`):
+ *   - api.rest          → FastifyAPI                  (only HTTP factory shipped)
+ *   - storage.database  → PostgreSQL15 | MongoDBNativeDriver
+ *   - orm.schema/client → PrismaORM                   (when prisma signal present)
+ *   - service.controller/business/crud → PrismaServices
+ *   - app.frontend      → ReactAppRuntime             (no RN factory exists yet)
+ *   - messaging.events  → EventEmitter
+ *   - validation.runtime → ZodValidation
+ *   - app.entrypoint    → GenericApp
+ *   - project.scaffold  → GenericScaffold
+ * Edge cases (drizzle, knex, vue, svelte, react-native, etc.) fall
+ * through to the closest valid default and the user hand-edits.
  */
 /**
  * Emit a deterministic manifest from prepass facts. The output is a
  * complete top-level YAML document (with specVersion) suitable for
  * writing to `manifests/implementation.yaml`.
  */
+/**
+ * Engines 6.32.2+ — registry of factory names actually present in the
+ * shipped instance-factory library (`engines/libs/instance-factories/`).
+ * Source: `find libs/instance-factories -name '*.yaml' | xargs grep '^name:'`.
+ *
+ * Manifest emission MUST pick from this set; emitting a non-existent
+ * name leaves every realize-time model with `factory: unknown` and
+ * produces no code. The previous emitter referenced ExpressAPI /
+ * NestJSAPI / MongoDBDriver / ReactNativeApp / ReactRuntime — none of
+ * which exist — and bored-stiff realize would silently emit nothing.
+ *
+ * Hand-edit consumers can still write any factory name they like in
+ * the manifest; this guard only protects auto-emitted manifests from
+ * the analyse pipeline.
+ */
+export const KNOWN_FACTORIES = new Set([
+    'CommanderJS', 'DockerKubernetes', 'EventEmitter', 'FastifyAPI',
+    'GenericApp', 'GenericScaffold', 'MCPServer', 'MongoDB6',
+    'MongoDBNativeDriver', 'PostgresNativeDriver', 'PostgreSQL15',
+    'PrismaORM', 'PrismaServices', 'PythonSDK', 'RabbitMQEvents',
+    'ReactAppRuntime', 'ReactAppStarter', 'Redis7', 'TypeScriptSDK',
+    'VitestTests', 'VSCodeExtension', 'ZodValidation',
+]);
 export function emitManifest(input) {
     const adapters = new Set(input.facts.meta?.adaptersRun ?? []);
     const entities = input.facts.entities ?? [];
@@ -45,76 +77,130 @@ export function emitManifest(input) {
     const choices = {};
     const rationale = {};
     // ── api.rest — HTTP framework ─────────────────────────────────────
+    // Only FastifyAPI exists in the registry today. Express / Nest signals
+    // are recorded in rationale so a human knows the framework the source
+    // actually uses, but the auto-emitted choice is FastifyAPI either way.
     if (adapters.has('express-routes')) {
-        choices['api.rest'] = 'ExpressAPI';
-        rationale['api.rest'] = 'express-routes adapter detected Router() + verb calls';
+        choices['api.rest'] = 'FastifyAPI';
+        rationale['api.rest'] = 'source uses express; auto-mapped to FastifyAPI (only HTTP factory in registry — hand-edit to a real ExpressAPI factory once added)';
     }
     else if (adapters.has('typescript-decorators')) {
-        // Decorator-rich codebases are most likely NestJS in our corpus.
-        // (TypeORM-only entities with no controller decorators wouldn't run
-        // this path, but if they did, NestJSAPI is still a reasonable default
-        // since it ships off NestJS conventions.)
-        choices['api.rest'] = 'NestJSAPI';
-        rationale['api.rest'] = 'typescript-decorators adapter — NestJS is the dominant decorator-based REST framework in the corpus';
+        choices['api.rest'] = 'FastifyAPI';
+        rationale['api.rest'] = 'source uses NestJS-style decorators; auto-mapped to FastifyAPI (only HTTP factory in registry)';
     }
     else {
-        // Default — most analyse targets are HTTP services. Express is the
-        // most common low-friction choice.
-        choices['api.rest'] = 'ExpressAPI';
-        rationale['api.rest'] = 'no framework signal detected; defaulting to ExpressAPI (most common in the corpus)';
+        choices['api.rest'] = 'FastifyAPI';
+        rationale['api.rest'] = 'no specific framework signal; FastifyAPI is the registry default for HTTP';
     }
-    // ── storage — relational vs document ──────────────────────────────
+    // ── storage.database — relational vs document ─────────────────────
+    // Choose between PostgreSQL15 (relational) and MongoDBNativeDriver
+    // (document) based on prisma signal. Both are real registered
+    // factories. Storage.relational and storage.documents capabilities
+    // are NOT what the realize engine asks for — it wants
+    // `storage.database` plus an optional `orm.schema` / `orm.client`
+    // pair when the source uses an ORM.
     if (adapters.has('typescript-prisma')) {
-        choices['storage.relational'] = 'PrismaDriver';
-        rationale['storage.relational'] = 'typescript-prisma adapter detected schema.prisma';
+        choices['storage.database'] = 'PostgreSQL15';
+        rationale['storage.database'] = 'typescript-prisma adapter detected schema.prisma — pairing with PostgreSQL15';
+        choices['orm.schema'] = 'PrismaORM';
+        choices['orm.client'] = 'PrismaORM';
+        rationale['orm.schema'] = 'prisma signal — PrismaORM for schema + client';
     }
     else {
-        // Without a Prisma signal, document storage is the analyse-time
-        // default. Codebases extracted via TS interfaces typically use
-        // mongoose / mongodb-native. The user can hand-edit to PostgresNativeDriver
-        // or others if the actual storage differs.
-        choices['storage.documents'] = 'MongoDBDriver';
-        rationale['storage.documents'] = 'no prisma schema detected; defaulting to document-store (MongoDBDriver)';
+        choices['storage.database'] = 'MongoDBNativeDriver';
+        rationale['storage.database'] = 'no prisma signal — defaulting to MongoDBNativeDriver (document store)';
+    }
+    // ── service.controller / business / crud ──────────────────────────
+    // The only services factory shipped today is PrismaServices, which
+    // works against PostgreSQL15 + PrismaORM. For document-store paths
+    // there's currently no equivalent — the user must hand-edit. Emit
+    // PrismaServices as the default; rationale notes the gap.
+    const servicesFactory = 'PrismaServices';
+    for (const cap of ['service.controller', 'service.business', 'service.crud']) {
+        choices[cap] = servicesFactory;
     }
-    // ── ui.framework — React vs React Native vs none ──────────────────
+    rationale['service.*'] = adapters.has('typescript-prisma')
+        ? 'PrismaServices — paired with the PrismaORM stack'
+        : 'PrismaServices is the only services factory in the registry today; non-prisma stacks need hand-editing';
+    // ── messaging.events ─────────────────────────────────────────────
+    choices['messaging.events'] = 'EventEmitter';
+    rationale['messaging.events'] = 'in-process EventEmitter is the simplest default — swap for RabbitMQEvents when distribution required';
+    // ── validation.runtime ───────────────────────────────────────────
+    // Always emit ZodValidation when a `const-schemas` adapter ran (Zod
+    // const schemas detected) OR as a low-friction default.
+    choices['validation.runtime'] = 'ZodValidation';
+    rationale['validation.runtime'] = adapters.has('zod-schemas') || adapters.has('backend-schemas')
+        ? 'zod schemas detected in source'
+        : 'ZodValidation as low-friction validator default';
+    // ── app.entrypoint + project.scaffold (always emit) ──────────────
+    choices['app.entrypoint'] = 'GenericApp';
+    choices['project.scaffold'] = 'GenericScaffold';
+    rationale['app.entrypoint'] = 'GenericApp — single entry-point shell';
+    rationale['project.scaffold'] = 'GenericScaffold — root-level project files';
+    // ── app.frontend (when React detected) ───────────────────────────
     if (adapters.has('react-views')) {
-        // RN signal: any view file path contains `react-native` or has
-        // `Screen` in the name (the screen convention).
         const isReactNative = views.some((v) => v.filePath.includes('react-native') || v.filePath.includes('-mobile') || v.isScreen);
-        if (isReactNative) {
-            choices['ui.framework'] = 'ReactNativeApp';
-            rationale['ui.framework'] = 'react-views adapter detected RN screens or mobile-app structure';
-        }
-        else {
-            choices['ui.framework'] = 'ReactRuntime';
-            rationale['ui.framework'] = 'react-views adapter detected JSX components without RN signals';
-        }
+        choices['app.frontend'] = 'ReactAppRuntime';
+        rationale['app.frontend'] = isReactNative
+            ? 'react-views adapter detected RN screens — auto-mapped to ReactAppRuntime (no RN factory in registry yet; emits a web SPA shell instead)'
+            : 'react-views adapter detected JSX components — using ReactAppRuntime';
     }
-    // ── auth.jwt — JWT auth presence ──────────────────────────────────
-    // Heuristic: any RefreshToken or AuthService entity → JWT path.
-    // This is a weak signal but better than asking an LLM to guess.
+    // ── auth.jwt ─────────────────────────────────────────────────────
+    // Reuses the api.rest factory — Fastify ships JWT plugin support.
     const entityNames = new Set(entities.map((e) => e.name.toLowerCase()));
     const hasJwtSignal = entityNames.has('refreshtoken')
         || entityNames.has('authsession')
         || entityNames.has('authservice')
         || entityNames.has('apitoken');
     if (hasJwtSignal) {
-        // JWT auth in idle-meta-style monorepos uses jsonwebtoken with
-        // express middleware. The api.rest factory (ExpressAPI / NestJSAPI)
-        // also handles auth.jwt by default. We still emit the mapping so
-        // the realize engine doesn't have to guess.
-        choices['auth.jwt'] = choices['api.rest'] ?? 'ExpressAPI';
-        rationale['auth.jwt'] = 'detected RefreshToken/AuthSession entity — using api.rest factory for JWT path';
+        choices['auth.jwt'] = choices['api.rest'];
+        rationale['auth.jwt'] = 'detected RefreshToken/AuthSession/AuthService entity — JWT path handled by the api.rest factory';
     }
-    // Build the yaml document.
+    // ── Final guard: drop any choice that isn't a registered factory ─
+    // Belt-and-braces — if a future code path emits a name we forgot to
+    // register, log + drop instead of silently shipping a manifest that
+    // realize will refuse to use.
+    for (const cap of Object.keys(choices)) {
+        const name = choices[cap];
+        if (!KNOWN_FACTORIES.has(name)) {
+            rationale[cap] = `${rationale[cap] ?? ''} — DROPPED: factory "${name}" not in registry`;
+            delete choices[cap];
+        }
+    }
+    // Build the yaml document. Engines 6.32.4+ — emit the array form
+    // `capabilityMappings: [{ capability, instanceFactory }, …]` and a
+    // `defaultMappings` block. The realize-engine loader (manifest-loader.ts)
+    // expects the array form; the previous hashmap form parsed cleanly
+    // but resolveCapability() then never matched any factory, leaving
+    // every model with `factory: unknown` and no code emitted.
+    const specName = input.specName ?? 'AnalysedSpec';
     const lines = [];
     lines.push('specVersion: "1.0"');
-    lines.push(`name: ${input.specName ?? 'AnalysedSpec'}`);
+    lines.push(`name: ${specName}`);
     lines.push('');
+    // defaultMappings — quick fallback the realize engine consults when
+    // a capability has no explicit row. Pull from the choice set when we
+    // emitted one for the canonical capability.
+    const defaultMappings = [
+        ['storage', choices['storage.database']],
+        ['controller', choices['service.controller']],
+        ['service', choices['service.business']],
+        ['routing', choices['api.rest']],
+        ['orm', choices['orm.schema']],
+        ['communication', choices['messaging.events']],
+    ];
+    const defaults = defaultMappings.filter(([, v]) => v !== undefined);
+    if (defaults.length > 0) {
+        lines.push('defaultMappings:');
+        for (const [k, v] of defaults)
+            lines.push(`  ${k}: "${v}"`);
+        lines.push('');
+    }
     lines.push('capabilityMappings:');
     // Stable ordering — sort keys for reproducibility.
     for (const cap of Object.keys(choices).sort()) {
-        lines.push(`  ${cap}: ${choices[cap]}`);
+        lines.push(`  - capability: "${cap}"`);
+        lines.push(`    instanceFactory: "${choices[cap]}"`);
     }
     lines.push('');
     return {

package/dist/ai/manifest-emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-emitter.js","sourceRoot":"","sources":["../../src/ai/manifest-emitter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest-emitter.js","sourceRoot":"","sources":["../../src/ai/manifest-emitter.ts"],"names":[],"mappings":"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"}

package/dist/ai/skeleton-emitter.d.ts

@@ -34,7 +34,7 @@ export interface SkeletonEmissionDecision {
     /** Free-form note for human readers. */
     note?: string;
 }
-export type SkeletonEmissionRule = 'header-component-from-suggested' | 'header-component-default-when-none-suggested' | 'model-from-detected-entity' | 'model-attribute-from-detected-attribute' | 'model-relationship-from-detected-relationship' | 'model-lifecycle-from-detected-lifecycle' | 'model-lifecycle-transition-from-detected-transition' | 'controller-from-walked-class' | 'service-from-walked-class' | 'cured-op-from-level1-curved-method' | 'action-stub-from-business-method' | 'event-from-detected-emit' | 'view-from-react-component' | 'view-description-from-react-kind' | 'view-description-from-source-docstring' | 'view-description-from-humanized-name' | 'view-type-from-jsx-classifier' | 'view-uses-from-jsx-composition' | 'view-action-from-jsx-handler' | 'view-empty-state-from-jsx-conditional' | 'comment-skeleton-marker';
+export type SkeletonEmissionRule = 'header-component-from-suggested' | 'header-component-default-when-none-suggested' | 'model-from-detected-entity' | 'model-attribute-from-detected-attribute' | 'model-relationship-from-detected-relationship' | 'model-lifecycle-from-detected-lifecycle' | 'model-lifecycle-transition-from-detected-transition' | 'controller-from-walked-class' | 'service-from-walked-class' | 'cured-op-from-level1-curved-method' | 'action-stub-from-business-method' | 'event-from-detected-emit' | 'view-from-react-component' | 'view-description-from-react-kind' | 'view-description-from-source-docstring' | 'view-description-from-humanized-name' | 'view-type-from-jsx-classifier' | 'view-uses-from-jsx-composition' | 'view-action-from-jsx-handler' | 'view-empty-state-from-jsx-conditional' | 'import-from-component-imports-graph' | 'import-from-non-library-subprocess' | 'import-from-non-library-service-client' | 'import-from-non-library-messaging' | 'import-from-non-library-managed-sdk' | 'comment-skeleton-marker';
 export interface SkeletonProvenance {
     schemaVersion: '1.0';
     /** When the skeleton was emitted (ISO timestamp). */

package/dist/ai/skeleton-emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skeleton-emitter.d.ts","sourceRoot":"","sources":["../../src/ai/skeleton-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,cAAc,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACnE,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAC5B,iCAAiC,GACjC,8CAA8C,GAC9C,4BAA4B,GAC5B,yCAAyC,GACzC,+CAA+C,GAC/C,yCAAyC,GACzC,qDAAqD,GACrD,8BAA8B,GAC9B,2BAA2B,GAC3B,oCAAoC,GACpC,kCAAkC,GAClC,0BAA0B,GAC1B,2BAA2B,GAC3B,kCAAkC,GAClC,wCAAwC,GACxC,sCAAsC,GACtC,+BAA+B,GAC/B,gCAAgC,GAChC,8BAA8B,GAC9B,uCAAuC,GACvC,yBAAyB,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,KAAK,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mDAAmD;IACnD,SAAS,EAAE,wBAAwB,EAAE,CAAC;IACtC;;sDAEkD;IAClD,WAAW,EAAE,KAAK,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;QAClE,sEAAsE;QACtE,kBAAkB,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/D,4EAA4E;QAC5E,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,mBAAmB,GAAG,UAAU,CAAC;QACzC,6BAA6B,CAAC,EAAE,MAAM,CAAC;KACxC,CAAC,CAAC;CACJ;AAmID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAkHA"}
+{"version":3,"file":"skeleton-emitter.d.ts","sourceRoot":"","sources":["../../src/ai/skeleton-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,cAAc,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACnE,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAC5B,iCAAiC,GACjC,8CAA8C,GAC9C,4BAA4B,GAC5B,yCAAyC,GACzC,+CAA+C,GAC/C,yCAAyC,GACzC,qDAAqD,GACrD,8BAA8B,GAC9B,2BAA2B,GAC3B,oCAAoC,GACpC,kCAAkC,GAClC,0BAA0B,GAC1B,2BAA2B,GAC3B,kCAAkC,GAClC,wCAAwC,GACxC,sCAAsC,GACtC,+BAA+B,GAC/B,gCAAgC,GAChC,8BAA8B,GAC9B,uCAAuC,GACvC,qCAAqC,GACrC,oCAAoC,GACpC,wCAAwC,GACxC,mCAAmC,GACnC,qCAAqC,GACrC,yBAAyB,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,KAAK,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mDAAmD;IACnD,SAAS,EAAE,wBAAwB,EAAE,CAAC;IACtC;;sDAEkD;IAClD,WAAW,EAAE,KAAK,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;QAClE,sEAAsE;QACtE,kBAAkB,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/D,4EAA4E;QAC5E,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,mBAAmB,GAAG,UAAU,CAAC;QACzC,6BAA6B,CAAC,EAAE,MAAM,CAAC;KACxC,CAAC,CAAC;CACJ;AAqLD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAkHA"}

package/dist/ai/skeleton-emitter.js

@@ -76,7 +76,41 @@ function buildContext(facts) {
             matchedComponentSuggestedName: matchedComp?.suggestedName,
         });
     }
-    return { facts, classByName, classesByComponent, entityHome, entityHomeAssignments };
+    // Engines 6.32.2+ — global single-home for service classes. Walk
+    // components in iteration order; first bucket to claim a className
+    // owns it. Duplicates in later buckets get skipped at emit time.
+    const serviceHome = new Map();
+    for (const comp of components) {
+        const bucket = classesByComponent.get(comp.suggestedName) ?? [];
+        for (const cm of bucket) {
+            if (!serviceHome.has(cm.entityName)) {
+                serviceHome.set(cm.entityName, comp.suggestedName);
+            }
+        }
+    }
+    for (const cm of classesByComponent.get('_unassigned') ?? []) {
+        if (!serviceHome.has(cm.entityName)) {
+            serviceHome.set(cm.entityName, '_unassigned');
+        }
+    }
+    // Engines 6.32.2+ — global single-home for views. First component
+    // whose sourceDir prefixes the view's filePath owns it; duplicates
+    // in later components get skipped.
+    const viewHome = new Map();
+    for (const v of facts.views ?? []) {
+        if (viewHome.has(v.name))
+            continue;
+        let assigned = null;
+        for (const comp of components) {
+            const sd = comp.structural?.sourceDir;
+            if (sd && v.filePath.startsWith(sd)) {
+                assigned = comp.suggestedName;
+                break;
+            }
+        }
+        viewHome.set(v.name, assigned ?? '_unassigned');
+    }
+    return { facts, classByName, classesByComponent, entityHome, serviceHome, viewHome, entityHomeAssignments };
 }
 /**
  * Stateful builder collecting yaml lines + provenance entries in step.
@@ -239,6 +273,99 @@ export function emitFaithfulSkeleton(facts) {
     };
 }
 function emitComponentBody(b, ctx, specName, bucketKey, _comp) {
+    // ── import: (engines 6.32.6+) ─────────────────────────────────────
+    // Cross-component `import:` blocks emitted from facts.importsByComponent
+    // (built by analyse-prepass/imports-graph.ts). For each consumer-target
+    // pair, emit one entry under `import:` with the symbols pulled in.
+    // Target-component name is the post-strip spec name; symbols are
+    // sorted for stable diffs.
+    //
+    // V2 Phase 2 (2026-05-08): also emit entries for detected non-library
+    // dependencies — subprocess executables, service clients, messaging
+    // brokers, managed-SDK clients. These come from
+    // facts.nonLibraryImportsByComponent and live in the same `import:`
+    // block as in-tree component refs (V2's principle: one place for all
+    // dependency declarations on the consumer side).
+    const importsForThis = ctx.facts.importsByComponent?.[bucketKey];
+    const nonLibraryHints = ctx.facts.nonLibraryImportsByComponent?.[bucketKey];
+    const hasInTreeImports = importsForThis && Object.keys(importsForThis).length > 0;
+    const hasNonLibraryImports = nonLibraryHints && nonLibraryHints.length > 0;
+    if (hasInTreeImports || hasNonLibraryImports) {
+        b.emit(`    import:\n`, {
+            yamlPath: `components.${specName}.import`,
+            rule: 'comment-skeleton-marker',
+        });
+        if (hasInTreeImports) {
+            for (const targetSuggestedName of Object.keys(importsForThis).sort()) {
+                const targetSpecName = targetSuggestedName.replace(/Component$/, '') || targetSuggestedName;
+                const symbols = importsForThis[targetSuggestedName] ?? [];
+                b.emit(`      - from: "${targetSpecName}"\n`, {
+                    yamlPath: `components.${specName}.import[${targetSpecName}]`,
+                    rule: 'import-from-component-imports-graph',
+                });
+                if (symbols.length > 0) {
+                    // Engines 6.32.10+: block-array form when the symbol list is
+                    // long. Single-line flow-arrays are valid YAML but unreadable
+                    // when dozens of symbols pile up (mythology-mobile imports 28
+                    // symbols from Ui).
+                    const useBlockForm = symbols.length > 4 || symbols.join(', ').length > 70;
+                    if (useBlockForm) {
+                        b.emit(`        select:\n`, {
+                            yamlPath: `components.${specName}.import[${targetSpecName}].select`,
+                            rule: 'import-from-component-imports-graph',
+                        });
+                        for (const sym of symbols) {
+                            b.emit(`          - ${sym}\n`, {
+                                yamlPath: `components.${specName}.import[${targetSpecName}].select.${sym}`,
+                                rule: 'import-from-component-imports-graph',
+                            });
+                        }
+                    }
+                    else {
+                        b.emit(`        select: [${symbols.join(', ')}]\n`, {
+                            yamlPath: `components.${specName}.import[${targetSpecName}].select`,
+                            rule: 'import-from-component-imports-graph',
+                        });
+                    }
+                }
+            }
+        }
+        if (hasNonLibraryImports) {
+            for (const hint of nonLibraryHints) {
+                b.emit(`      - from: "${hint.from}"\n`, {
+                    yamlPath: `components.${specName}.import[${hint.from}]`,
+                    rule: `import-from-non-library-${hint.pattern}`,
+                });
+                if (hint.version) {
+                    b.emit(`        version: "${hint.version}"\n`, {
+                        yamlPath: `components.${specName}.import[${hint.from}].version`,
+                        rule: `import-from-non-library-${hint.pattern}`,
+                    });
+                }
+                if (hint.select && hint.select.length > 0) {
+                    const useBlockForm = hint.select.length > 4 || hint.select.join(', ').length > 70;
+                    if (useBlockForm) {
+                        b.emit(`        select:\n`, {
+                            yamlPath: `components.${specName}.import[${hint.from}].select`,
+                            rule: `import-from-non-library-${hint.pattern}`,
+                        });
+                        for (const op of hint.select) {
+                            b.emit(`          - ${op}\n`, {
+                                yamlPath: `components.${specName}.import[${hint.from}].select.${op}`,
+                                rule: `import-from-non-library-${hint.pattern}`,
+                            });
+                        }
+                    }
+                    else {
+                        b.emit(`        select: [${hint.select.join(', ')}]\n`, {
+                            yamlPath: `components.${specName}.import[${hint.from}].select`,
+                            rule: `import-from-non-library-${hint.pattern}`,
+                        });
+                    }
+                }
+            }
+        }
+    }
     // ── Models (only when adapters detected entities) ─────────────────
     // Single-home entity mapping (Option A, 2026-05-04): every detected
     // entity maps to EXACTLY ONE component via ctx.entityHome. Eliminates
@@ -443,23 +570,26 @@ function emitComponentBody(b, ctx, specName, bucketKey, _comp) {
         }
     }
     // ── Controllers + services from walker ────────────────────────────
-    // Dedupe by class name within the bucket — the walker may capture two
-    // classes with the same name in different source files (e.g. an
-    // `apps/.../FormulaEvaluator.ts` AND `shared/.../FormulaEvaluator.ts`),
-    // both falling into this component. Emitting twice produces a yaml
-    // duplicate-mapping-key error. First-wins keeps the spec valid.
-    //
-    // Plus: a class name that's ALSO an entity (already emitted in models:)
-    // should NOT be re-emitted as a service. The TS-interfaces walker
-    // surfaces classes with fields as entities; the method-walker surfaces
-    // those same classes for behaviour analysis. They're the SAME thing,
-    // and only the model emission should win in the spec.
+    // Three-stage dedup:
+    //   1. Skip if this class name is ALSO an entity — TS-interfaces and
+    //      method walker can both surface the same class; only the model
+    //      emission should win.
+    //   2. Engines 6.32.2+ — skip if a different component owns this name
+    //      via ctx.serviceHome (single-home across components). Without
+    //      this, idle_meta produces `services.GameService` in both
+    //      IdleApiService AND Editor since both source dirs contain a
+    //      file by that name; realize then errors on the collision.
+    //   3. Local first-wins inside this component's bucket as a defense
+    //      against a single bucket containing the same name twice.
     const allEntityNames = new Set((ctx.facts.entities ?? []).map((e) => e.name));
     const rawClasses = ctx.classesByComponent.get(bucketKey) ?? [];
     const seenOwnerNames = new Set();
     const classes = rawClasses.filter((c) => {
         if (allEntityNames.has(c.entityName))
-            return false; // emitted as a model already
+            return false;
+        const home = ctx.serviceHome.get(c.entityName);
+        if (home !== undefined && home !== bucketKey)
+            return false;
         if (seenOwnerNames.has(c.entityName))
             return false;
         seenOwnerNames.add(c.entityName);
@@ -473,15 +603,23 @@ function emitComponentBody(b, ctx, specName, bucketKey, _comp) {
     // sourceDir to land here. Falls through silently when no structural
     // info exists (community-detection-only suggestion) — those views
     // wind up in the `Unassigned` / `Application` catch-all.
+    //
+    // Engines 6.32.2+ — single-home check (ctx.viewHome) drops duplicate
+    // names that already landed in another component. idle_meta has
+    // `LoginScreen` in two RN apps and `ToastProvider` in two `contexts/`
+    // dirs; without the global home, both components emit the same view
+    // and realize errors.
     const componentViews = (ctx.facts.views ?? []).filter((v) => {
         const sd = _comp?.structural?.sourceDir;
         if (!sd)
             return bucketKey === '_unassigned'; // catch-all only
         return v.filePath.startsWith(sd);
     });
-    // Per-name dedup within this component.
     const seenViewNames = new Set();
     const dedupViews = componentViews.filter((v) => {
+        const home = ctx.viewHome.get(v.name);
+        if (home !== undefined && home !== bucketKey)
+            return false;
         if (seenViewNames.has(v.name))
             return false;
         seenViewNames.add(v.name);