@specverse/engines 6.33.0 → 6.34.0

package/dist/realize/per-action-runner.js

@@ -66,6 +66,7 @@ export async function runPerActionEmission(opts) {
     for (const [ownerName, actions] of ownerGroups) {
         const bodies = new Map();
         const specs = new Map();
+        const availableClients = opts.availableClientsByOwner?.get(ownerName);
         for (const collectedAction of actions) {
             const realizeCtx = {
                 componentName: ownerName,
@@ -75,6 +76,7 @@ export async function runPerActionEmission(opts) {
                 aiArgsExpr: opts.aiArgsExpr,
                 llmEmit: opts.llmEmit,
                 canCallLLM: opts.canCallLLM,
+                availableClients,
             };
             const body = await emitActionBody(collectedAction.spec, realizeCtx);
             bodies.set(collectedAction.actionName, body);
@@ -266,4 +268,134 @@ ${body}
 }
 `;
 }
+// ─── V2 imports → availableClients string (Round 3 follow-up) ────────
+/**
+ * Convert a V2 `import: from:` provider name to the client identifier
+ * the runtime aggregator (`clients/index.ts`) exposes via `v2Clients`.
+ *
+ * Mirrors the `toClientName` logic in
+ * `engines/src/realize/runtime-emitters/library.ts` so the prompt's
+ * advertised name matches the actual client constant the consumer
+ * spreads into `deps`. Kept local (rather than imported) because the
+ * library emitter's helper is private and the conversion is a tiny
+ * pure function — duplication is cheaper than a public re-export.
+ */
+function toClientName(fromName) {
+    // Mirrors the library emitter's toWords: scope-strip, slash → dash,
+    // split on camelCase boundary AND non-alphanumeric runs, lowercase.
+    const normalised = fromName.replace(/^@/, '').replace(/\//g, '-');
+    const words = normalised
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(' ')
+        .filter(Boolean)
+        .map((w) => w.toLowerCase());
+    if (words.length === 0)
+        return 'unknownClient';
+    return (words[0] +
+        words
+            .slice(1)
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join(''));
+}
+/**
+ * Build a single component's `availableClients` prompt string from its
+ * V2 `import:` block.
+ *
+ * Output shape (one line per importable operation):
+ *   - deps.<clientName>.<operation>(input)  // from <fromName> (<topology>)
+ *   - deps.<clientName>  // bare entity export from <fromName> (<topology>)
+ *
+ * Topology is included when known (caller can pass a resolver-result
+ * lookup); when unknown, we omit the parenthetical. The Round-3 wire-up
+ * in `realize/index.ts` runs BEFORE the V2 imports loop has resolved
+ * factories, so most calls today omit topology — fine. The slot is
+ * forward-compatible: a future revision can pass topology by name and
+ * we'll surface it.
+ *
+ * Returns `null` when the component has no imports (caller should not
+ * set `availableClients` at all in that case so the LLM hook falls
+ * back to its "(none)" default).
+ */
+export function buildAvailableClientsForComponent(component, topologyByFrom) {
+    const imports = Array.isArray(component?.import) ? component.import : [];
+    if (imports.length === 0)
+        return null;
+    const lines = [];
+    for (const entry of imports) {
+        const fromName = entry?.from ?? entry?.package ?? entry?.file ?? '';
+        if (!fromName)
+            continue;
+        const select = Array.isArray(entry?.select) ? entry.select : [];
+        if (select.length === 0)
+            continue;
+        const clientName = toClientName(fromName);
+        const topology = topologyByFrom?.get(fromName);
+        const topoSuffix = topology ? ` (${topology})` : '';
+        for (const sel of select) {
+            const dotIndex = sel.indexOf('.');
+            if (dotIndex === -1) {
+                // Bare entity export: full interface, LLM picks the operation.
+                lines.push(`  - deps.${clientName}  // bare entity export ${sel} from ${fromName}${topoSuffix}`);
+            }
+            else {
+                // Dotted: <Entity>.<operation> — surface the operation directly.
+                const operation = sel.slice(dotIndex + 1);
+                lines.push(`  - deps.${clientName}.${operation}(input)  // from ${fromName}${topoSuffix}`);
+            }
+        }
+    }
+    if (lines.length === 0)
+        return null;
+    return ['Available imported clients (V2 imports):', ...lines].join('\n');
+}
+/**
+ * Walk a parsed spec and build the per-owner `availableClients` map the
+ * per-action runner threads into `RealizeContext.availableClients`.
+ *
+ * Resolution: each `spec.components[i]` carries an `import:` block AND
+ * a set of contained controllers + services. Every controller / service
+ * inside the component sees the same `availableClients` string (V2
+ * imports are component-scoped; per-action filtering via `Action.uses`
+ * is a future refinement).
+ *
+ * Components-without-imports do not contribute entries — owners in
+ * those components won't have `availableClients` set, and the LLM hook
+ * falls back to its "(none)" default. This keeps the prompt clean for
+ * specs that don't use V2 imports at all.
+ */
+export function buildAvailableClientsByOwner(spec, topologyByFrom) {
+    const out = new Map();
+    const components = Array.isArray(spec?.components)
+        ? spec.components
+        : Object.values(spec?.components ?? {});
+    for (const component of components) {
+        const clientsString = buildAvailableClientsForComponent(component, topologyByFrom);
+        if (!clientsString)
+            continue;
+        // Each contained controller and service shares this component's
+        // imports. Controllers are shaped `{ Name: { ... } }` or
+        // `[{ name, ... }]`; same for services.
+        const controllerEntries = Array.isArray(component?.controllers)
+            ? component.controllers.map((c) => [c?.name ?? '', c])
+            : Object.entries(component?.controllers ?? {});
+        for (const [keyName, c] of controllerEntries) {
+            const ownerName = c?.name || keyName;
+            if (!ownerName)
+                continue;
+            out.set(ownerName, clientsString);
+        }
+        const serviceEntries = Array.isArray(component?.services)
+            ? component.services.map((s) => [s?.name ?? '', s])
+            : Object.entries(component?.services ?? {});
+        for (const [keyName, s] of serviceEntries) {
+            const ownerName = s?.name || keyName;
+            if (!ownerName)
+                continue;
+            out.set(ownerName, clientsString);
+        }
+    }
+    return out;
+}
 //# sourceMappingURL=per-action-runner.js.map

package/dist/realize/per-action-runner.js.map

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

package/dist/realize/resolver/index.d.ts

@@ -0,0 +1,157 @@
+/**
+ * V2 Dependency Resolver — Phase 3 (Round 1)
+ *
+ * 4-step lookup chain for `import[].from` references:
+ *   1. Local component in same spec
+ *   2. Local npm package (node_modules/<name>/package.json)
+ *   3. Registry library (Library.type: component) — HTTP stubbed for Round 1
+ *   4. Registry factory (Library.type: factory) — HTTP stubbed for Round 1
+ *
+ * Decision points applied:
+ *   D1: version defaults to ^latest (per-realize-run cache)
+ *   Offline mode: skips steps 3 + 4, fails loudly if unresolvable
+ *   Cache: <cacheDir>/registry-cache/ (default .specverse/registry-cache/)
+ *   Fail-loud: throws DependencyResolutionError when nothing resolves
+ *
+ * @see docs/proposals/2026-05-08-COMPONENT-DEPENDENCIES-V2.md — "Realize bridge — Resolver"
+ */
+import type { SpecVerseAST, ComponentSpec } from '@specverse/types';
+/**
+ * A spec that has been resolved from a `from:` reference.
+ * For Round 1 registry paths, `spec` is a minimal stub generated from
+ * the registry Library record.
+ */
+export interface ResolvedComponent {
+    /** The original `from:` value from the import entry that produced this. */
+    fromName: string;
+    /** Which step of the 4-step chain produced this result. */
+    source: 'local' | 'npm' | 'registry-component' | 'registry-factory';
+    /**
+     * The resolved SpecVerse spec.  For local + npm sources this is the full
+     * parsed spec.  For registry sources (stubs in Round 1) this is a minimal
+     * object bearing at least the component's `name` and `version`.
+     */
+    spec: PartialSpec;
+    /**
+     * The resolved provider name (component name for local, npm package name
+     * for npm, registry library/factory name for registry-*).
+     */
+    resolvedName: string;
+    /**
+     * Pinned version after ^latest expansion (or the version from the local
+     * spec / npm package.json). Optional because some local components may
+     * not declare a version field.
+     */
+    resolvedVersion?: string;
+    /**
+     * For source = 'npm' or 'registry-*': the package specifier to use in
+     * generated `import` statements (e.g. '@stripe/stripe-js' or 'profit-calc').
+     * For source = 'local': not populated; callers compute relative paths
+     * from outputDir + resolvedName.
+     */
+    packageSpecifier?: string;
+    /**
+     * For source = 'local': relative path from the consumer's outputDir to
+     * the provider's emitted module. Optional — when absent, callers fall
+     * back to `../{resolvedName}` or similar convention.
+     */
+    localRelativePath?: string;
+    /**
+     * Registry coordinates when source is 'registry-component' or 'registry-factory'.
+     */
+    registryRef?: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * A factory reference returned when the registry resolves a capability match
+ * (step 4).
+ */
+export interface FactoryReference {
+    name: string;
+    version: string;
+    /** Factory metadata from registry — partial in Round 1 (HTTP is stubbed). */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options passed to each `resolve()` call.  The full spec + workspace context
+ * allow the local-component and npm-package steps to work without extra
+ * configuration.
+ */
+export interface ResolveOptions {
+    /** The spec being realized — used for local-component lookup (step 1). */
+    spec: SpecVerseAST;
+    /**
+     * Absolute path to the workspace root.  Used to locate node_modules for
+     * step 2.  Defaults to `process.cwd()`.
+     */
+    workspaceRoot?: string;
+    /**
+     * When true, steps 3 and 4 (registry) are skipped.  If a `from:` reference
+     * cannot be resolved via steps 1–2, throws `DependencyResolutionError`.
+     */
+    offline?: boolean;
+    /**
+     * Directory where registry responses are cached.
+     * Defaults to `.specverse/registry-cache/` inside `workspaceRoot`.
+     */
+    cacheDir?: string;
+    /**
+     * When true, treats the registry cache as stale and re-fetches even if a
+     * cached entry exists.  Equivalent to the `--refresh-registry` flag.
+     * Can also be set via the `SPECVERSE_REFRESH_REGISTRY=1` environment variable.
+     */
+    refreshRegistry?: boolean;
+}
+export interface DependencyResolver {
+    /**
+     * Resolve a `from:` reference to a component spec.
+     *
+     * Steps (in order):
+     *   1. Local component in spec.components
+     *   2. node_modules/<from>/package.json
+     *   3. GET /api/libraries/<from> (Registry, Library.type: component) — STUBBED
+     *   4. GET /api/libraries?type=factory&capability=<from> — STUBBED
+     *
+     * @param from    The `from:` value from the import entry.
+     * @param version Semver range or pin.  Defaults to `^latest` (D1).
+     * @param options Resolve-time context.
+     * @returns ResolvedComponent or null when offline + not locally found.
+     * @throws DependencyResolutionError when nothing resolves (not offline) or
+     *         when offline and no local resolution is possible.
+     */
+    resolve(from: string, version?: string, options?: ResolveOptions): Promise<ResolvedComponent | null>;
+    /**
+     * Resolve a capability tag to a factory reference.
+     * Used by realize emitters that need to find which factory covers a given
+     * capability string.
+     *
+     * Delegates to step 4 of the chain.
+     *
+     * @throws DependencyResolutionError when no factory matches and not offline.
+     */
+    resolveCapability(capability: string, options?: ResolveOptions): Promise<FactoryReference | null>;
+}
+export declare class DependencyResolutionError extends Error {
+    readonly from: string;
+    readonly triedSteps: string[];
+    constructor(message: string, from: string, triedSteps: string[]);
+}
+/** Minimal spec shape accepted from all resolution sources. */
+export interface PartialSpec {
+    name?: string;
+    version?: string;
+    components?: ComponentSpec[];
+    [key: string]: unknown;
+}
+/**
+ * Create a `DependencyResolver` instance.
+ *
+ * The resolver is stateless between realize runs.  A new instance should be
+ * created per-run (or per test) to avoid cross-run cache pollution in memory.
+ * On-disk cache in `<cacheDir>/registry-cache/` persists across runs and is
+ * shared across instances that use the same directory.
+ */
+export declare function createDependencyResolver(): DependencyResolver;
+//# sourceMappingURL=index.d.ts.map

package/dist/realize/resolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/realize/resolver/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMpE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;IACpE;;;;OAIG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAErG;;;;;;;;OAQG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACnG;AAMD,qBAAa,yBAA0B,SAAQ,KAAK;aAGhC,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM,EAAE;gBAFpC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE;CAKvC;AAMD,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA4TD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}

package/dist/realize/resolver/index.js

@@ -0,0 +1,307 @@
+/**
+ * V2 Dependency Resolver — Phase 3 (Round 1)
+ *
+ * 4-step lookup chain for `import[].from` references:
+ *   1. Local component in same spec
+ *   2. Local npm package (node_modules/<name>/package.json)
+ *   3. Registry library (Library.type: component) — HTTP stubbed for Round 1
+ *   4. Registry factory (Library.type: factory) — HTTP stubbed for Round 1
+ *
+ * Decision points applied:
+ *   D1: version defaults to ^latest (per-realize-run cache)
+ *   Offline mode: skips steps 3 + 4, fails loudly if unresolvable
+ *   Cache: <cacheDir>/registry-cache/ (default .specverse/registry-cache/)
+ *   Fail-loud: throws DependencyResolutionError when nothing resolves
+ *
+ * @see docs/proposals/2026-05-08-COMPONENT-DEPENDENCIES-V2.md — "Realize bridge — Resolver"
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, resolve } from 'path';
+// ============================================================================
+// Error
+// ============================================================================
+export class DependencyResolutionError extends Error {
+    from;
+    triedSteps;
+    constructor(message, from, triedSteps) {
+        super(message);
+        this.from = from;
+        this.triedSteps = triedSteps;
+        this.name = 'DependencyResolutionError';
+    }
+}
+// ============================================================================
+// Registry HTTP stub
+// ============================================================================
+/**
+ * Round-1 stub for registry component lookup.
+ *
+ * TODO: Replace with real HTTP fetch:
+ *   GET <registryBase>/api/libraries/<name>
+ * Expected response shape (Library.type: component):
+ *   { name, version, type: 'component', specContent: '<yaml>' }
+ *
+ * @returns null — no registry data in Round 1 (real HTTP not yet wired).
+ */
+async function fetchRegistryComponent(name, _version) {
+    // TODO(v2-p3-round2): implement real HTTP fetch to specverse registry.
+    // Endpoint: GET /api/libraries/<name>
+    // Auth:     anonymous reads; OAuth for publish
+    // Filtering: check Library.type === 'component'
+    void name;
+    return null;
+}
+/**
+ * Round-1 stub for registry factory lookup by capability.
+ *
+ * TODO: Replace with real HTTP fetch:
+ *   GET <registryBase>/api/libraries?type=factory&capability=<capability>
+ * Expected response shape (array of Library.type: factory records):
+ *   [{ name, version, type: 'factory', metadata: { topology, protocol, ... } }]
+ *
+ * @returns null — no registry data in Round 1.
+ */
+async function fetchRegistryFactory(_capability) {
+    // TODO(v2-p3-round2): implement real HTTP fetch to specverse registry.
+    // Endpoint: GET /api/libraries?type=factory&capability=<capability>
+    // Auth:     anonymous reads
+    // Selection: pick highest semver-matching version
+    void _capability;
+    return null;
+}
+// ============================================================================
+// Resolver implementation
+// ============================================================================
+/**
+ * Default semver range when the spec author omits `version:` (D1).
+ */
+const DEFAULT_VERSION = '^latest';
+/**
+ * Resolve an effective cache directory from options + environment.
+ */
+function resolveCacheDir(options) {
+    if (options.cacheDir)
+        return options.cacheDir;
+    const root = options.workspaceRoot ?? process.cwd();
+    return join(root, '.specverse', 'registry-cache');
+}
+/**
+ * Determine whether the registry cache should be refreshed.
+ * Checks:
+ *   1. `options.refreshRegistry` flag
+ *   2. `SPECVERSE_REFRESH_REGISTRY` environment variable
+ */
+function shouldRefreshRegistry(options) {
+    if (options.refreshRegistry)
+        return true;
+    return process.env['SPECVERSE_REFRESH_REGISTRY'] === '1';
+}
+/**
+ * Read a cache entry if it exists (and we are not refreshing).
+ */
+function readCache(cacheDir, key, refresh) {
+    if (refresh)
+        return null;
+    const filePath = join(cacheDir, `${key}.json`);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write a cache entry.  Creates the cache directory if it doesn't exist.
+ */
+function writeCache(cacheDir, key, entry) {
+    try {
+        if (!existsSync(cacheDir)) {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        const filePath = join(cacheDir, `${key}.json`);
+        writeFileSync(filePath, JSON.stringify(entry, null, 2), 'utf-8');
+    }
+    catch {
+        // Cache write failure is non-fatal — resolution can continue without it.
+    }
+}
+/**
+ * Sanitise a `from:` value so it's safe as a filesystem key.
+ * Converts `@scope/pkg` → `scope__pkg`, slashes → `__`.
+ */
+function cacheKey(from) {
+    return from.replace(/^@/, '').replace(/\//g, '__');
+}
+class DependencyResolverImpl {
+    async resolve(from, version, options = { spec: { components: [], deployments: [], manifests: [] } }) {
+        const effectiveVersion = version ?? DEFAULT_VERSION;
+        const triedSteps = [];
+        // ── Step 1: Local component in same spec ────────────────────────────────
+        triedSteps.push('local-component');
+        const localMatch = (options.spec?.components ?? []).find((c) => c.name === from);
+        if (localMatch) {
+            return {
+                fromName: from,
+                source: 'local',
+                spec: { name: localMatch.name, version: localMatch.version, components: [localMatch] },
+                resolvedName: localMatch.name,
+                resolvedVersion: localMatch.version,
+            };
+        }
+        // ── Step 2: Local npm package ────────────────────────────────────────────
+        triedSteps.push('npm-package');
+        const workspaceRoot = resolve(options.workspaceRoot ?? process.cwd());
+        const pkgJsonPath = join(workspaceRoot, 'node_modules', from, 'package.json');
+        if (existsSync(pkgJsonPath)) {
+            try {
+                const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+                const pkgName = pkgJson['name'] ?? from;
+                const pkgVersion = pkgJson['version'] ?? effectiveVersion;
+                return {
+                    fromName: from,
+                    source: 'npm',
+                    spec: { name: pkgName, version: pkgVersion },
+                    resolvedName: pkgName,
+                    resolvedVersion: pkgVersion,
+                    packageSpecifier: pkgName,
+                };
+            }
+            catch {
+                // Malformed package.json — fall through to registry steps.
+            }
+        }
+        // ── Offline fence ────────────────────────────────────────────────────────
+        if (options.offline) {
+            throw new DependencyResolutionError(`Cannot resolve "${from}": not found as a local component or npm package, ` +
+                `and offline mode prevents registry lookup.\n` +
+                `  Tried: ${triedSteps.join(', ')}`, from, triedSteps);
+        }
+        const cacheDir = resolveCacheDir(options);
+        const refresh = shouldRefreshRegistry(options);
+        const key = cacheKey(from);
+        // ── Step 3: Registry library (Library.type: component) ───────────────────
+        triedSteps.push('registry-component');
+        const cachedComponent = readCache(cacheDir, key, refresh);
+        if (cachedComponent && cachedComponent.source === 'registry-component') {
+            return {
+                fromName: from,
+                source: 'registry-component',
+                spec: { name: cachedComponent.name, version: cachedComponent.version },
+                resolvedName: cachedComponent.name,
+                resolvedVersion: cachedComponent.version,
+                packageSpecifier: cachedComponent.name,
+                registryRef: { name: cachedComponent.name, version: cachedComponent.version },
+            };
+        }
+        const registryComponentResult = await fetchRegistryComponent(from, effectiveVersion);
+        if (registryComponentResult) {
+            const entry = {
+                cachedAt: new Date().toISOString(),
+                source: 'registry-component',
+                name: registryComponentResult.name,
+                version: registryComponentResult.version,
+                data: registryComponentResult,
+            };
+            writeCache(cacheDir, key, entry);
+            return {
+                fromName: from,
+                source: 'registry-component',
+                spec: { name: registryComponentResult.name, version: registryComponentResult.version },
+                resolvedName: registryComponentResult.name,
+                resolvedVersion: registryComponentResult.version,
+                packageSpecifier: registryComponentResult.name,
+                registryRef: { name: registryComponentResult.name, version: registryComponentResult.version },
+            };
+        }
+        // ── Step 4: Registry factory (Library.type: factory) ─────────────────────
+        triedSteps.push('registry-factory');
+        const factoryKey = `factory__${key}`;
+        const cachedFactory = readCache(cacheDir, factoryKey, refresh);
+        if (cachedFactory && cachedFactory.source === 'registry-factory') {
+            return {
+                fromName: from,
+                source: 'registry-factory',
+                spec: { name: cachedFactory.name, version: cachedFactory.version },
+                resolvedName: cachedFactory.name,
+                resolvedVersion: cachedFactory.version,
+                packageSpecifier: cachedFactory.name,
+                registryRef: { name: cachedFactory.name, version: cachedFactory.version },
+            };
+        }
+        const registryFactoryResult = await fetchRegistryFactory(from);
+        if (registryFactoryResult) {
+            const entry = {
+                cachedAt: new Date().toISOString(),
+                source: 'registry-factory',
+                name: registryFactoryResult.name,
+                version: registryFactoryResult.version,
+                data: registryFactoryResult,
+            };
+            writeCache(cacheDir, factoryKey, entry);
+            return {
+                fromName: from,
+                source: 'registry-factory',
+                spec: { name: registryFactoryResult.name, version: registryFactoryResult.version },
+                resolvedName: registryFactoryResult.name,
+                resolvedVersion: registryFactoryResult.version,
+                packageSpecifier: registryFactoryResult.name,
+                registryRef: { name: registryFactoryResult.name, version: registryFactoryResult.version },
+            };
+        }
+        // ── Nothing resolved ─────────────────────────────────────────────────────
+        throw new DependencyResolutionError(`Cannot resolve "${from}" (version: "${effectiveVersion}"): ` +
+            `exhausted all 4 lookup steps with no match.\n` +
+            `  Tried: ${triedSteps.join(' → ')}\n` +
+            `  Hint: check the component name, npm package name, or registry entry for "${from}".`, from, triedSteps);
+    }
+    async resolveCapability(capability, options = { spec: { components: [], deployments: [], manifests: [] } }) {
+        if (options.offline) {
+            // In offline mode we cannot query the registry for capability matches.
+            return null;
+        }
+        const cacheDir = resolveCacheDir(options);
+        const refresh = shouldRefreshRegistry(options);
+        const key = `capability__${cacheKey(capability)}`;
+        // Check cache first.
+        const cached = readCache(cacheDir, key, refresh);
+        if (cached && cached.source === 'registry-factory') {
+            return {
+                name: cached.name,
+                version: cached.version,
+                metadata: cached.data,
+            };
+        }
+        // TODO(v2-p3-round2): real HTTP call stubbed below.
+        const result = await fetchRegistryFactory(capability);
+        if (result) {
+            const entry = {
+                cachedAt: new Date().toISOString(),
+                source: 'registry-factory',
+                name: result.name,
+                version: result.version,
+                data: result,
+            };
+            writeCache(cacheDir, key, entry);
+            return { name: result.name, version: result.version, metadata: result.metadata };
+        }
+        return null;
+    }
+}
+// ============================================================================
+// Factory function (public API)
+// ============================================================================
+/**
+ * Create a `DependencyResolver` instance.
+ *
+ * The resolver is stateless between realize runs.  A new instance should be
+ * created per-run (or per test) to avoid cross-run cache pollution in memory.
+ * On-disk cache in `<cacheDir>/registry-cache/` persists across runs and is
+ * shared across instances that use the same directory.
+ */
+export function createDependencyResolver() {
+    return new DependencyResolverImpl();
+}
+//# sourceMappingURL=index.js.map