@specverse/engines 6.0.8 → 6.0.10

package/dist/analyse-prepass/backends/gitnexus.d.ts

@@ -0,0 +1,109 @@
+import type { StructuralPrepass, Symbol, Import, FileFilter, ClassFilter, MethodFilter, InterfaceFilter, IndexResult, MethodFactSheet } from '../interface.js';
+export interface GitNexusBackendOptions {
+    /** Path to the gitnexus binary. Auto-detected via PATH if omitted. */
+    gitnexusPath?: string;
+    /** Skip running `gitnexus analyze` if .gitnexus/ already exists. */
+    reuseExistingIndex?: boolean;
+}
+export declare class GitNexusBackend implements StructuralPrepass {
+    private sourceDir;
+    /**
+     * Canonical repo name as registered in `~/.gitnexus/registry.json`.
+     * Resolved by `init()` from the registry; passed as `--repo <name>`
+     * to every `gitnexus cypher` call so multi-repo registries don't
+     * cross-contaminate query results.
+     */
+    private repoName;
+    private gitnexusPath;
+    private reuseExistingIndex;
+    capabilities: {
+        callGraph: boolean;
+        crossFileResolution: boolean;
+        componentClustering: boolean;
+        fullTextSearch: boolean;
+        fileWatching: boolean;
+    };
+    constructor(options?: GitNexusBackendOptions);
+    static isAvailable(): boolean;
+    init(sourceDir: string): Promise<void>;
+    /**
+     * Resolve a sourceDir to its canonical gitnexus repo name by reading
+     * `~/.gitnexus/registry.json`. Falls back to the dir's basename if the
+     * registry isn't readable or has no matching entry — but a basename
+     * fallback is unsafe in multi-repo registries (it can collide with
+     * another project that happens to have the same dir name), so we log
+     * a warning to stderr in that case.
+     */
+    private resolveRepoName;
+    index(): Promise<IndexResult>;
+    listFiles(filter?: FileFilter): Promise<string[]>;
+    listClasses(filter?: ClassFilter): Promise<Symbol[]>;
+    listMethods(filter?: MethodFilter): Promise<Symbol[]>;
+    listInterfaces(filter?: InterfaceFilter): Promise<Symbol[]>;
+    listImports(file: string): Promise<Import[]>;
+    fileSourceText(file: string): Promise<string>;
+    callers(symbol: string): Promise<Symbol[]>;
+    callees(symbol: string): Promise<Symbol[]>;
+    /**
+     * Cluster files via GitNexus's Leiden community detection.
+     * This is the distinguishing feature vs CodeGraph — surfaces natural
+     * component boundaries for SpecVerse `components:` inference.
+     *
+     * GitNexus's edge model: a single `CodeRelation` table with a `type`
+     * property — relationship discrimination happens via WHERE on that
+     * property, not by edge label. Community membership is `MEMBER_OF`.
+     *
+     * Note: GitNexus's MEMBER_OF connects symbols (not files directly) to
+     * communities. We aggregate per-community by filePath of the member symbols.
+     */
+    clusterFiles(): Promise<Array<{
+        id: string;
+        files: string[];
+    }>>;
+    /**
+     * GitNexus's call graph traversal — same `CodeRelation` table pattern
+     * as MEMBER_OF, with `type='CALLS'` as the discriminating property.
+     * (Override the default callers/callees from the parent class above
+     * because the relation type isn't `:CALLS` — it's `:CodeRelation` with
+     * a property filter.)
+     */
+    getMethodDetails(qualifiedName: string): Promise<MethodFactSheet | null>;
+    /**
+     * Run a Cypher query via the `gitnexus cypher` CLI and parse the
+     * markdown-table output into a row array. Each row is a map of
+     * column name → value (string, number, or array depending on Cypher).
+     *
+     * Passes `--repo <name>` to disambiguate when multiple repos are
+     * registered globally. The name comes from `~/.gitnexus/registry.json`
+     * (resolved by `init()`), NOT the basename of sourceDir — the basename
+     * is unsafe because gitnexus derives the registered name from the git
+     * remote / package.json, which usually differs from the dir name
+     * (e.g. clones into `./source/` register as `nestjs-realworld-example-app`).
+     */
+    private cypher;
+    private rowToSymbol;
+    private mapLabel;
+    private toRelativePath;
+    private escape;
+    private detectBinary;
+}
+/**
+ * Extract the basename of a sourceDir for fallback-naming. `/foo/bar/source/`
+ * → `source`. Empty path → `source` (the gitnexus default for unnamed dirs).
+ */
+export declare function basenameOrSource(sourceDir: string): string;
+/**
+ * Pure-function version of the registry-lookup logic — takes the registry
+ * file content + the sourceDir and returns the canonical name (or null if
+ * not found, plus an optional warning). Exported for unit testing without
+ * needing gitnexus installed or a real ~/.gitnexus directory.
+ *
+ * Match order:
+ *   1. Exact `path === sourceDir`
+ *   2. `storagePath` is inside sourceDir (handles symlink-resolved paths)
+ */
+export declare function resolveRepoNameFromRegistry(registryContent: string, sourceDir: string): {
+    name: string | null;
+    warning: string | null;
+};
+//# sourceMappingURL=gitnexus.d.ts.map

package/dist/analyse-prepass/backends/gitnexus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/gitnexus.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAYzB,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,OAAO,CAAC,SAAS,CAAM;IACvB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,kBAAkB,CAAU;IAEpC,YAAY;;;;;;MAMV;gBAEU,OAAO,GAAE,sBAA2B;IAKhD,MAAM,CAAC,WAAW,IAAI,OAAO;IASvB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB5C;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAkBjB,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAqB7B,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAcjD,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYpD,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BrD,cAAc,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY3D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY5C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAM1C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMhD;;;;;;;;;;;OAWG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IASrE;;;;;;OAMG;IAEG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0C9E;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM;IA2Bd,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,YAAY;CASrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAuBjD"}

package/dist/analyse-prepass/backends/gitnexus.js

@@ -0,0 +1,453 @@
+/**
+ * GitNexus backend — `StructuralPrepass` against `gitnexus` CLI.
+ *
+ * GitNexus indexes a codebase into a graph (LadybugDB) with tree-sitter
+ * symbol extraction + cross-file resolution + Leiden community detection.
+ * It exposes Cypher queries via the `gitnexus cypher <query>` CLI command,
+ * which returns JSON with a markdown-table inner format. We shell out to
+ * the CLI and parse the markdown table.
+ *
+ * The distinguishing capability vs CodeGraph is `clusterFiles()` — GitNexus
+ * tracks `Community` nodes (via Leiden community detection on the call graph)
+ * which give natural component-boundary suggestions for SpecVerse `components:`.
+ *
+ * Storage: GitNexus stores per-repo data in `.gitnexus/` and a global
+ * registry pointer at `~/.gitnexus/`. Like CodeGraph, indexing happens once;
+ * subsequent queries hit the persistent index.
+ */
+import { execSync, execFileSync } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { walkSourceTree, detectLanguage, globToRegex } from './walk.js';
+import { extractEmits, extractDbWrites, extractExternalCalls, extractThrows, extractAsyncBoundaries, countBranchPoints, sliceBody, } from './method-patterns.js';
+export class GitNexusBackend {
+    sourceDir = '';
+    /**
+     * Canonical repo name as registered in `~/.gitnexus/registry.json`.
+     * Resolved by `init()` from the registry; passed as `--repo <name>`
+     * to every `gitnexus cypher` call so multi-repo registries don't
+     * cross-contaminate query results.
+     */
+    repoName = '';
+    gitnexusPath;
+    reuseExistingIndex;
+    capabilities = {
+        callGraph: true,
+        crossFileResolution: true,
+        componentClustering: true, // Leiden community detection (the differentiator)
+        fullTextSearch: true, // hybrid BM25 + semantic + RRF
+        fileWatching: false, // GitNexus doesn't auto-sync; needs explicit re-analyze
+    };
+    constructor(options = {}) {
+        this.gitnexusPath = options.gitnexusPath ?? this.detectBinary('gitnexus');
+        this.reuseExistingIndex = options.reuseExistingIndex ?? false;
+    }
+    static isAvailable() {
+        try {
+            execSync('gitnexus --version', { stdio: 'ignore', timeout: 5000 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async init(sourceDir) {
+        this.sourceDir = sourceDir;
+        const gitnexusDir = join(sourceDir, '.gitnexus');
+        if (!this.reuseExistingIndex || !existsSync(gitnexusDir)) {
+            // Run `gitnexus analyze` to build the index. --skip-git lets us index
+            // arbitrary directories (like our realized backends in /private/tmp).
+            if (!existsSync(gitnexusDir)) {
+                execSync(`${this.gitnexusPath} analyze --skip-git .`, {
+                    cwd: sourceDir,
+                    stdio: 'ignore',
+                    timeout: 600_000,
+                });
+            }
+        }
+        // Resolve the canonical repo name from the gitnexus registry. The
+        // registry is the authoritative mapping of source paths → repo names
+        // (gitnexus derives `name` from the git remote, the `package.json`,
+        // or the dir basename — we don't replicate that logic, just look it up).
+        this.repoName = this.resolveRepoName(sourceDir);
+    }
+    /**
+     * Resolve a sourceDir to its canonical gitnexus repo name by reading
+     * `~/.gitnexus/registry.json`. Falls back to the dir's basename if the
+     * registry isn't readable or has no matching entry — but a basename
+     * fallback is unsafe in multi-repo registries (it can collide with
+     * another project that happens to have the same dir name), so we log
+     * a warning to stderr in that case.
+     */
+    resolveRepoName(sourceDir) {
+        const registryPath = join(homedir(), '.gitnexus', 'registry.json');
+        const fallback = basenameOrSource(sourceDir);
+        if (!existsSync(registryPath))
+            return fallback;
+        let registryContent;
+        try {
+            registryContent = readFileSync(registryPath, 'utf8');
+        }
+        catch (err) {
+            process.stderr.write(`[gitnexus-backend] failed to read registry: ${err.message}; using basename fallback "${fallback}".\n`);
+            return fallback;
+        }
+        const result = resolveRepoNameFromRegistry(registryContent, sourceDir);
+        if (result.warning)
+            process.stderr.write(`[gitnexus-backend] ${result.warning}\n`);
+        return result.name ?? fallback;
+    }
+    async index() {
+        const start = Date.now();
+        if (!existsSync(join(this.sourceDir, '.gitnexus'))) {
+            execSync(`${this.gitnexusPath} analyze --skip-git .`, {
+                cwd: this.sourceDir,
+                stdio: 'ignore',
+                timeout: 600_000,
+            });
+        }
+        // GitNexus prints stats during analyze; query for them via Cypher
+        const rows = this.cypher('MATCH (n) RETURN count(*) AS c');
+        const totalNodes = rows.length > 0 ? Number(rows[0].c) : 0;
+        const fileRows = this.cypher('MATCH (n:File) RETURN count(*) AS c');
+        const fileCount = fileRows.length > 0 ? Number(fileRows[0].c) : 0;
+        return {
+            files: fileCount,
+            symbols: totalNodes - fileCount,
+            durationMs: Date.now() - start,
+        };
+    }
+    async listFiles(filter) {
+        // Same pattern as CodeGraph backend — FS walk, not the index, so adapters
+        // can find arbitrary file types (schema.prisma, package.json, etc.) the
+        // tree-sitter indexer doesn't track.
+        let result = walkSourceTree(this.sourceDir);
+        if (filter?.dir)
+            result = result.filter((f) => f.startsWith(filter.dir));
+        if (filter?.lang)
+            result = result.filter((f) => detectLanguage(f) === filter.lang);
+        if (filter?.glob) {
+            const re = globToRegex(filter.glob);
+            result = result.filter((f) => re.test(f));
+        }
+        return result;
+    }
+    async listClasses(filter) {
+        let cypher = `MATCH (n:Class) RETURN n.name AS name, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine, n.isExported AS isExported`;
+        if (filter?.dir) {
+            const rel = this.toRelativePath(filter.dir);
+            cypher = `MATCH (n:Class) WHERE n.filePath STARTS WITH '${this.escape(rel)}' RETURN n.name AS name, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine, n.isExported AS isExported`;
+        }
+        const rows = this.cypher(cypher);
+        return rows
+            .filter((r) => !filter?.namePattern || filter.namePattern.test(r.name))
+            .map((r) => this.rowToSymbol(r, 'class'));
+    }
+    async listMethods(filter) {
+        // GitNexus doesn't store class membership as a property; we derive it
+        // from the Method node's `name` plus filePath. For the `class` filter,
+        // we scope by the class's file path range.
+        let cypher = `MATCH (n:Method) RETURN n.name AS name, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine, n.isExported AS isExported`;
+        if (filter?.class) {
+            // Find the class's file + line range first, then filter methods by it.
+            const classRows = this.cypher(`MATCH (c:Class {name: '${this.escape(filter.class)}'}) RETURN c.filePath AS filePath, c.startLine AS startLine, c.endLine AS endLine LIMIT 1`);
+            if (classRows.length === 0)
+                return [];
+            const cls = classRows[0];
+            cypher = `MATCH (n:Method) WHERE n.filePath = '${this.escape(cls.filePath)}' AND n.startLine >= ${Number(cls.startLine)} AND n.startLine <= ${Number(cls.endLine)} RETURN n.name AS name, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine, n.isExported AS isExported`;
+        }
+        const rows = this.cypher(cypher);
+        let methods = rows.map((r) => {
+            const sym = this.rowToSymbol(r, 'method');
+            // Approximate qualifiedName: ClassName.methodName when class context is known
+            if (filter?.class)
+                sym.qualifiedName = `${filter.class}.${sym.name}`;
+            return sym;
+        });
+        if (filter?.nameIn && filter.nameIn.length > 0) {
+            const allowedNames = new Set(filter.nameIn);
+            methods = methods.filter((m) => allowedNames.has(m.name));
+        }
+        return methods;
+    }
+    async listInterfaces(filter) {
+        let cypher = `MATCH (n:Interface) RETURN n.name AS name, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine, n.isExported AS isExported`;
+        if (filter?.dir) {
+            const rel = this.toRelativePath(filter.dir);
+            cypher = `MATCH (n:Interface) WHERE n.filePath STARTS WITH '${this.escape(rel)}' RETURN n.name AS name, n.filePath AS filePath, n.startLine AS startLine, n.endLine AS endLine, n.isExported AS isExported`;
+        }
+        const rows = this.cypher(cypher);
+        return rows
+            .filter((r) => !filter?.namePattern || filter.namePattern.test(r.name))
+            .map((r) => this.rowToSymbol(r, 'interface'));
+    }
+    async listImports(file) {
+        // GitNexus tracks imports via CodeRelation edges with type='IMPORTS'.
+        const rel = this.toRelativePath(file);
+        const cypher = `MATCH (f:File {filePath: '${this.escape(rel)}'})-[:CodeRelation {type: "IMPORTS"}]->(target) RETURN target.name AS name, target.filePath AS targetPath`;
+        const rows = this.cypher(cypher);
+        return rows.map((r) => ({
+            fromFile: file,
+            toModule: r.targetPath || r.name,
+            symbols: [r.name],
+        }));
+    }
+    async fileSourceText(file) {
+        return readFileSync(file, 'utf8');
+    }
+    async callers(symbol) {
+        const cypher = `MATCH (caller)-[:CodeRelation {type: "CALLS"}]->(callee) WHERE callee.name = '${this.escape(symbol)}' RETURN caller.name AS name, caller.filePath AS filePath, caller.startLine AS startLine, caller.endLine AS endLine, labels(caller)[0] AS kind LIMIT 100`;
+        const rows = this.cypher(cypher);
+        return rows.map((r) => this.rowToSymbol(r, this.mapLabel(r.kind)));
+    }
+    async callees(symbol) {
+        const cypher = `MATCH (caller)-[:CodeRelation {type: "CALLS"}]->(callee) WHERE caller.name = '${this.escape(symbol)}' RETURN callee.name AS name, callee.filePath AS filePath, callee.startLine AS startLine, callee.endLine AS endLine, labels(callee)[0] AS kind LIMIT 100`;
+        const rows = this.cypher(cypher);
+        return rows.map((r) => this.rowToSymbol(r, this.mapLabel(r.kind)));
+    }
+    /**
+     * Cluster files via GitNexus's Leiden community detection.
+     * This is the distinguishing feature vs CodeGraph — surfaces natural
+     * component boundaries for SpecVerse `components:` inference.
+     *
+     * GitNexus's edge model: a single `CodeRelation` table with a `type`
+     * property — relationship discrimination happens via WHERE on that
+     * property, not by edge label. Community membership is `MEMBER_OF`.
+     *
+     * Note: GitNexus's MEMBER_OF connects symbols (not files directly) to
+     * communities. We aggregate per-community by filePath of the member symbols.
+     */
+    async clusterFiles() {
+        const cypher = `MATCH (member)-[:CodeRelation {type: "MEMBER_OF"}]->(c:Community) RETURN c.id AS id, c.heuristicLabel AS label, collect(DISTINCT member.filePath) AS files`;
+        const rows = this.cypher(cypher);
+        return rows.map((r) => ({
+            id: String(r.label || r.id || 'unnamed'),
+            files: Array.isArray(r.files) ? r.files.filter(Boolean) : [],
+        }));
+    }
+    /**
+     * GitNexus's call graph traversal — same `CodeRelation` table pattern
+     * as MEMBER_OF, with `type='CALLS'` as the discriminating property.
+     * (Override the default callers/callees from the parent class above
+     * because the relation type isn't `:CALLS` — it's `:CodeRelation` with
+     * a property filter.)
+     */
+    async getMethodDetails(qualifiedName) {
+        const lastDot = qualifiedName.lastIndexOf('.');
+        if (lastDot < 0)
+            return null;
+        const className = qualifiedName.slice(0, lastDot);
+        const methodName = qualifiedName.slice(lastDot + 1);
+        // Find the method via class-scoped query
+        const methods = await this.listMethods({ class: className, nameIn: [methodName] });
+        if (methods.length === 0)
+            return null;
+        const method = methods[0];
+        const fileText = readFileSync(method.filePath, 'utf8');
+        const fileLines = fileText.split('\n');
+        const bodyLines = fileLines.slice(method.startLine - 1, method.endLine);
+        const body = bodyLines.join('\n');
+        // Calls — use the call graph (GitNexus's strength like CodeGraph's)
+        const calls = await this.callees(qualifiedName);
+        return {
+            qualifiedName,
+            signature: method.signature ?? '',
+            body,
+            filePath: method.filePath,
+            startLine: method.startLine,
+            endLine: method.endLine,
+            language: method.language,
+            calls,
+            emits: extractEmits(body),
+            dbWrites: extractDbWrites(body),
+            externalCalls: extractExternalCalls(body),
+            throws: extractThrows(body),
+            asyncBoundaries: extractAsyncBoundaries(body),
+            branchPoints: countBranchPoints(body),
+            bodyTextSliced: sliceBody(body),
+        };
+    }
+    // ────────────────────────────────────────────────────────────────────
+    // Internals
+    // ────────────────────────────────────────────────────────────────────
+    /**
+     * Run a Cypher query via the `gitnexus cypher` CLI and parse the
+     * markdown-table output into a row array. Each row is a map of
+     * column name → value (string, number, or array depending on Cypher).
+     *
+     * Passes `--repo <name>` to disambiguate when multiple repos are
+     * registered globally. The name comes from `~/.gitnexus/registry.json`
+     * (resolved by `init()`), NOT the basename of sourceDir — the basename
+     * is unsafe because gitnexus derives the registered name from the git
+     * remote / package.json, which usually differs from the dir name
+     * (e.g. clones into `./source/` register as `nestjs-realworld-example-app`).
+     */
+    cypher(query) {
+        if (!this.repoName) {
+            throw new Error('[gitnexus-backend] repoName not set — did you call init() before querying? ' +
+                'init() resolves the canonical repo name from ~/.gitnexus/registry.json.');
+        }
+        const stdout = execFileSync(this.gitnexusPath, ['cypher', '--repo', this.repoName, query], {
+            cwd: this.sourceDir,
+            encoding: 'utf8',
+            timeout: 60_000,
+            maxBuffer: 50 * 1024 * 1024,
+        });
+        if (!stdout.trim())
+            return [];
+        let payload;
+        try {
+            payload = JSON.parse(stdout);
+        }
+        catch {
+            throw new Error(`gitnexus cypher: failed to parse JSON output:\n${stdout.slice(0, 500)}`);
+        }
+        if (payload.error) {
+            throw new Error(`gitnexus cypher error: ${payload.error}`);
+        }
+        if (!payload.markdown)
+            return [];
+        return parseMarkdownTable(payload.markdown);
+    }
+    rowToSymbol(row, kind) {
+        const filePath = String(row.filePath || '');
+        const absPath = filePath.startsWith('/') ? filePath : join(this.sourceDir, filePath);
+        return {
+            kind,
+            name: String(row.name),
+            qualifiedName: String(row.name), // GitNexus's qualified IDs are colon-separated; we use plain name for now
+            filePath: absPath,
+            startLine: Number(row.startLine ?? 0),
+            endLine: Number(row.endLine ?? 0),
+            signature: row.signature ?? undefined,
+            docstring: row.docstring ?? undefined,
+            isExported: row.isExported === 'true' || row.isExported === true,
+            language: detectLanguage(absPath) || 'unknown',
+        };
+    }
+    mapLabel(label) {
+        switch (label) {
+            case 'Class': return 'class';
+            case 'Method': return 'method';
+            case 'Function': return 'function';
+            case 'Interface': return 'interface';
+            case 'Const': return 'constant';
+            default: return 'function';
+        }
+    }
+    toRelativePath(p) {
+        return p.startsWith(this.sourceDir)
+            ? p.slice(this.sourceDir.length).replace(/^\//, '')
+            : p;
+    }
+    escape(s) {
+        return s.replace(/'/g, "\\'");
+    }
+    detectBinary(name) {
+        try {
+            const path = execSync(`which ${name}`, { encoding: 'utf8', timeout: 3000 }).trim();
+            if (path)
+                return path;
+        }
+        catch {
+            // Fall through
+        }
+        return name;
+    }
+}
+/**
+ * Extract the basename of a sourceDir for fallback-naming. `/foo/bar/source/`
+ * → `source`. Empty path → `source` (the gitnexus default for unnamed dirs).
+ */
+export function basenameOrSource(sourceDir) {
+    return sourceDir.split('/').filter(Boolean).pop() || 'source';
+}
+/**
+ * Pure-function version of the registry-lookup logic — takes the registry
+ * file content + the sourceDir and returns the canonical name (or null if
+ * not found, plus an optional warning). Exported for unit testing without
+ * needing gitnexus installed or a real ~/.gitnexus directory.
+ *
+ * Match order:
+ *   1. Exact `path === sourceDir`
+ *   2. `storagePath` is inside sourceDir (handles symlink-resolved paths)
+ */
+export function resolveRepoNameFromRegistry(registryContent, sourceDir) {
+    let entries;
+    try {
+        entries = JSON.parse(registryContent);
+    }
+    catch (err) {
+        return {
+            name: null,
+            warning: `failed to parse registry JSON: ${err.message}`,
+        };
+    }
+    if (!Array.isArray(entries)) {
+        return { name: null, warning: 'registry is not an array' };
+    }
+    const match = entries.find((e) => e.path === sourceDir) ??
+        entries.find((e) => e.storagePath?.startsWith(sourceDir + '/'));
+    if (match)
+        return { name: match.name, warning: null };
+    return {
+        name: null,
+        warning: `no registry entry for ${sourceDir}; using basename fallback. ` +
+            `Multi-repo queries may cross-contaminate.`,
+    };
+}
+/**
+ * Parse a GitHub-flavored markdown table into a row array.
+ *
+ * Input shape:
+ *   | col1 | col2 |
+ *   | --- | --- |
+ *   | val1 | val2 |
+ *
+ * Returns: [ { col1: 'val1', col2: 'val2' }, ... ]
+ *
+ * Cell values are strings; callers can convert to number/boolean/JSON
+ * as needed. Cells starting with `[` are parsed as JSON arrays
+ * (GitNexus's `collect()` returns arrays in markdown form).
+ */
+function parseMarkdownTable(md) {
+    const lines = md.split('\n').filter((l) => l.trim().length > 0);
+    if (lines.length < 2)
+        return [];
+    const headerLine = lines[0];
+    const headers = headerLine
+        .split('|')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    // Skip the separator row (---|---|---)
+    const rows = [];
+    for (let i = 2; i < lines.length; i++) {
+        const cells = lines[i]
+            .split('|')
+            .map((s) => s.trim())
+            .filter((_, idx, arr) => idx > 0 && idx < arr.length - 1 || arr.length === headers.length);
+        // Sometimes the leading/trailing | are missing — fall back to a permissive split.
+        const rawCells = lines[i].split('|');
+        const cleaned = rawCells.length === headers.length + 2
+            ? rawCells.slice(1, -1).map((s) => s.trim())
+            : rawCells.map((s) => s.trim()).filter(Boolean);
+        const row = {};
+        for (let j = 0; j < headers.length; j++) {
+            let val = cleaned[j] ?? '';
+            // Try to parse JSON arrays (collect() output)
+            if (typeof val === 'string' && val.startsWith('[') && val.endsWith(']')) {
+                try {
+                    val = JSON.parse(val);
+                }
+                catch {
+                    // leave as string
+                }
+            }
+            row[headers[j]] = val;
+        }
+        rows.push(row);
+    }
+    return rows;
+}
+//# sourceMappingURL=gitnexus.js.map

package/dist/analyse-prepass/backends/gitnexus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus.js","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/gitnexus.ts"],"names":[],"mappings":"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"}

package/dist/analyse-prepass/backends/index.d.ts

@@ -1,20 +1,28 @@
 /**
  * Backend selector — picks the best available `StructuralPrepass`.
  *
- * Order: codegraph (if available) → grep-only (always works).
- * GitNexus to be added later.
+ * Order: gitnexus (if available + opted-in) → codegraph (if available)
+ *        → grep-only (always works).
+ *
+ * GitNexus is more invasive (heavier stack, longer index time) but provides
+ * Leiden community detection (clusterFiles capability) which can help with
+ * multi-component codebases. Default `auto` prefers CodeGraph for the
+ * smaller-footprint case; explicitly request `gitnexus` for clustering.
  */
 import type { StructuralPrepass } from '../interface.js';
 import { GrepOnlyBackend } from './grep-only.js';
 import { CodeGraphBackend } from './codegraph.js';
-export { GrepOnlyBackend, CodeGraphBackend };
-export type BackendName = 'codegraph' | 'grep-only' | 'auto';
+import { GitNexusBackend } from './gitnexus.js';
+export { GrepOnlyBackend, CodeGraphBackend, GitNexusBackend };
+export type BackendName = 'codegraph' | 'gitnexus' | 'grep-only' | 'auto';
 /**
- * Select a backend by name, or auto-pick the richest available.
+ * Select a backend by name, or auto-pick a sensible default.
  *
  * `auto` semantics:
- *   - CodeGraph + sqlite3 both available → CodeGraph (richer, has call graph)
+ *   - CodeGraph + sqlite3 both available → CodeGraph (lighter; richest baseline)
  *   - Otherwise → grep-only (always works, no external tools)
+ *   - Note: GitNexus is NOT auto-selected even when available, because its
+ *     index overhead is significant. Explicit opt-in via name='gitnexus'.
  */
 export declare function selectBackend(name?: BackendName): StructuralPrepass;
 //# sourceMappingURL=index.d.ts.map

package/dist/analyse-prepass/backends/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAoB,GAAG,iBAAiB,CAiB3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAoB,GAAG,iBAAiB,CAyB3E"}

package/dist/analyse-prepass/backends/index.js

@@ -1,12 +1,15 @@
 import { GrepOnlyBackend } from './grep-only.js';
 import { CodeGraphBackend } from './codegraph.js';
-export { GrepOnlyBackend, CodeGraphBackend };
+import { GitNexusBackend } from './gitnexus.js';
+export { GrepOnlyBackend, CodeGraphBackend, GitNexusBackend };
 /**
- * Select a backend by name, or auto-pick the richest available.
+ * Select a backend by name, or auto-pick a sensible default.
  *
  * `auto` semantics:
- *   - CodeGraph + sqlite3 both available → CodeGraph (richer, has call graph)
+ *   - CodeGraph + sqlite3 both available → CodeGraph (lighter; richest baseline)
  *   - Otherwise → grep-only (always works, no external tools)
+ *   - Note: GitNexus is NOT auto-selected even when available, because its
+ *     index overhead is significant. Explicit opt-in via name='gitnexus'.
  */
 export function selectBackend(name = 'auto') {
     if (name === 'codegraph') {
@@ -15,10 +18,16 @@ export function selectBackend(name = 'auto') {
         }
         return new CodeGraphBackend();
     }
+    if (name === 'gitnexus') {
+        if (!GitNexusBackend.isAvailable()) {
+            throw new Error('GitNexus backend requested but not available. Install with `npm i -g gitnexus`.');
+        }
+        return new GitNexusBackend();
+    }
     if (name === 'grep-only') {
         return new GrepOnlyBackend();
     }
-    // auto
+    // auto — prefer CodeGraph (lighter, fast); GitNexus stays opt-in.
     if (CodeGraphBackend.isAvailable()) {
         return new CodeGraphBackend();
     }

package/dist/analyse-prepass/backends/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAI7C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAoB,MAAM;IACtD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+HAA+H,CAChI,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO;IACP,IAAI,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;QACnC,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAI9D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAAoB,MAAM;IACtD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+HAA+H,CAChI,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,kEAAkE;IAClE,IAAI,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;QACnC,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/analyse-prepass/index.d.ts

@@ -14,7 +14,7 @@
  *   // facts.entities, facts.relationships, facts.lifecycles, ...
  */
 export type { StructuralPrepass, Symbol, Import, Capabilities, FileFilter, ClassFilter, MethodFilter, InterfaceFilter, IndexResult, MethodFactSheet, } from './interface.js';
-export { GrepOnlyBackend, CodeGraphBackend, selectBackend, type BackendName, } from './backends/index.js';
+export { GrepOnlyBackend, CodeGraphBackend, GitNexusBackend, selectBackend, type BackendName, } from './backends/index.js';
 export { extractTypeScriptPrisma, type PrismaFacts, type PrismaEntity, type PrismaField, type PrismaRelation, } from './adapters/index.js';
 import { type BackendName } from './backends/index.js';
 import type { StructuralPrepass } from './interface.js';

package/dist/analyse-prepass/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyse-prepass/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,YAAY,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,+CAA+C;IAC/C,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;QACzC,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,kFAAkF;IAClF,UAAU,EAAE,KAAK,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,+DAA+D;IAC/D,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyD5G;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA2CnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyse-prepass/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,YAAY,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,+CAA+C;IAC/C,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;QACzC,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,kFAAkF;IAClF,UAAU,EAAE,KAAK,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,+DAA+D;IAC/D,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyD5G;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA2CnE"}

package/dist/analyse-prepass/index.js

@@ -1,4 +1,4 @@
-export { GrepOnlyBackend, CodeGraphBackend, selectBackend, } from './backends/index.js';
+export { GrepOnlyBackend, CodeGraphBackend, GitNexusBackend, selectBackend, } from './backends/index.js';
 export { extractTypeScriptPrisma, } from './adapters/index.js';
 import { selectBackend } from './backends/index.js';
 import { extractTypeScriptPrisma } from './adapters/index.js';

package/dist/analyse-prepass/index.js.map

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

package/dist/libs/instance-factories/cli/templates/commander/command-generator.js

@@ -374,6 +374,110 @@ import type { ParserEngine, InferenceEngine, RealizeEngine } from '@specverse/ty
         }
         const inferredSpec = { ...componentData, componentName, components: inferredYaml?.components || {} };
 
+        // --estimate: report what realize WOULD do, broken down by layer.
+        // Skip the actual realizeAll call (no manifest needed, no LLM cost).
+        // The three layers:
+        //   L1 \u2014 Instance factory (templates, no LLM)
+        //   L2 \u2014 Convention pattern matching (CURVED ops + default events, no LLM)
+        //   L3 \u2014 AI from steps (one LLM call per declared step)
+        if (options.estimate) {
+          const components = inferredSpec.components || {};
+          const compNames = Object.keys(components);
+          let entityCount = 0, controllerCount = 0, serviceCount = 0, eventCount = 0, viewCount = 0;
+          let modelBehaviorSteps = 0, controllerActionSteps = 0, serviceOpSteps = 0;
+          let modelBehaviorsWithSteps = 0, controllerActionsWithSteps = 0, serviceOpsWithSteps = 0;
+          let curvedOpCount = 0;
+          const sumSteps = (block: any) => {
+            if (!block || typeof block !== 'object') return { ops: 0, opsWithSteps: 0, totalSteps: 0 };
+            let ops = 0, opsWithSteps = 0, totalSteps = 0;
+            for (const def of Object.values(block)) {
+              ops++;
+              const steps = (def as any)?.steps;
+              if (Array.isArray(steps) && steps.length > 0) {
+                opsWithSteps++;
+                totalSteps += steps.length;
+              }
+            }
+            return { ops, opsWithSteps, totalSteps };
+          };
+          for (const compName of compNames) {
+            const comp = components[compName] || {};
+            const models = comp.models || {};
+            const controllers = comp.controllers || {};
+            const services = comp.services || {};
+            const events = comp.events || {};
+            const views = comp.views || {};
+            entityCount += Object.keys(models).length;
+            controllerCount += Object.keys(controllers).length;
+            serviceCount += Object.keys(services).length;
+            eventCount += Object.keys(events).length;
+            viewCount += Object.keys(views).length;
+            for (const m of Object.values(models)) {
+              const r = sumSteps((m as any)?.behaviors);
+              modelBehaviorsWithSteps += r.opsWithSteps;
+              modelBehaviorSteps += r.totalSteps;
+            }
+            for (const c of Object.values(controllers)) {
+              const r = sumSteps((c as any)?.actions);
+              controllerActionsWithSteps += r.opsWithSteps;
+              controllerActionSteps += r.totalSteps;
+              const cured = (c as any)?.cured || (c as any)?.curved;
+              if (cured && typeof cured === 'object') curvedOpCount += Object.keys(cured).length;
+            }
+            for (const s of Object.values(services)) {
+              const r = sumSteps((s as any)?.operations);
+              serviceOpsWithSteps += r.opsWithSteps;
+              serviceOpSteps += r.totalSteps;
+            }
+          }
+          const totalLlmCalls = modelBehaviorSteps + controllerActionSteps + serviceOpSteps;
+          const fileEstimate = entityCount * 7 + controllerCount + serviceCount * 2 + viewCount + 15;
+          console.log('');
+          console.log('\u2554\u2550\u2550 spv realize --estimate \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550');
+          console.log('\u2551');
+          console.log('\u2551  Type: ' + type);
+          console.log('\u2551  Components: ' + compNames.length + (compNames.length > 0 ? ' (' + compNames.join(', ') + ')' : ''));
+          console.log('\u2551');
+          console.log('\u2551  \u2500\u2500 Spec inventory (post-inference) \u2500\u2500');
+          console.log('\u2551    Entities (models):    ' + entityCount);
+          console.log('\u2551    Controllers:          ' + controllerCount);
+          console.log('\u2551    Services:             ' + serviceCount);
+          console.log('\u2551    Events:               ' + eventCount);
+          console.log('\u2551    Views:                ' + viewCount);
+          console.log('\u2551');
+          console.log('\u2551  \u2500\u2500 Output by realize layer \u2500\u2500');
+          console.log('\u2551');
+          console.log('\u2551  L1 \u2014 Instance factory (file scaffolding, no LLM):');
+          console.log('\u2551    File scaffolding for each entity / controller / service / view');
+          console.log('\u2551    + framework boilerplate (Fastify routes, Prisma schema, React shell)');
+          console.log('\u2551    Estimate: ~' + fileEstimate + ' files');
+          console.log('\u2551');
+          console.log('\u2551  L2 \u2014 Convention pattern matching (bodies, no LLM):');
+          console.log('\u2551    CURVED ops auto-implemented:    ' + curvedOpCount);
+          console.log('\u2551    Default events on lifecycles:   ' + eventCount + ' (declared) + auto-derived');
+          console.log('\u2551    Default validation patterns:    ~' + (entityCount * 2));
+          console.log('\u2551');
+          console.log('\u2551  L3 \u2014 AI from steps (LLM, 1 call per step):');
+          console.log('\u2551    Model behaviors with steps:    ' + modelBehaviorsWithSteps + ' behaviors \u2192 ' + modelBehaviorSteps + ' steps');
+          console.log('\u2551    Controller actions with steps: ' + controllerActionsWithSteps + ' actions \u2192 ' + controllerActionSteps + ' steps');
+          console.log('\u2551    Service ops with steps:        ' + serviceOpsWithSteps + ' operations \u2192 ' + serviceOpSteps + ' steps');
+          console.log('\u2551    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500');
+          console.log('\u2551    Total LLM calls:               ' + totalLlmCalls);
+          console.log('\u2551');
+          if (totalLlmCalls > 0) {
+            console.log('\u2551  \u2500\u2500 Estimated wall time + cost (L3 only) \u2500\u2500');
+            console.log('\u2551    On Opus 4.7 / Max:    ~' + Math.ceil(totalLlmCalls * 0.2) + ' min wall (free, claude-cli session-cached)');
+            console.log('\u2551    On Sonnet 4.6:        ~' + Math.ceil(totalLlmCalls * 0.1) + ' min wall (free)');
+            console.log('\u2551    On Anthropic API:     ~' + Math.ceil(totalLlmCalls * 0.1) + ' min wall, ~$' + (totalLlmCalls * 0.015).toFixed(2) + ' (Sonnet rates)');
+            console.log('\u2551    On DeepSeek/Together: ~' + Math.ceil(totalLlmCalls * 0.08) + ' min wall, ~$' + (totalLlmCalls * 0.0008).toFixed(3) + ' (10-30\xD7 cheaper)');
+          } else {
+            console.log('\u2551  No LLM cost \u2014 all output is L1 + L2 (templates + conventions only).');
+          }
+          console.log('\u2551');
+          console.log('\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550');
+          return;
+        }
+
         // Realize \u2014 let the realize engine handle its own library.
         // Locate the nearest implementation manifest by walking up from the
         // spec file, then falling back to the user's cwd. This lets the same

package/libs/instance-factories/cli/templates/commander/command-generator.ts

@@ -429,6 +429,110 @@ import type { ParserEngine, InferenceEngine, RealizeEngine } from '@specverse/ty
         }
         const inferredSpec = { ...componentData, componentName, components: inferredYaml?.components || {} };
 
+        // --estimate: report what realize WOULD do, broken down by layer.
+        // Skip the actual realizeAll call (no manifest needed, no LLM cost).
+        // The three layers:
+        //   L1 — Instance factory (templates, no LLM)
+        //   L2 — Convention pattern matching (CURVED ops + default events, no LLM)
+        //   L3 — AI from steps (one LLM call per declared step)
+        if (options.estimate) {
+          const components = inferredSpec.components || {};
+          const compNames = Object.keys(components);
+          let entityCount = 0, controllerCount = 0, serviceCount = 0, eventCount = 0, viewCount = 0;
+          let modelBehaviorSteps = 0, controllerActionSteps = 0, serviceOpSteps = 0;
+          let modelBehaviorsWithSteps = 0, controllerActionsWithSteps = 0, serviceOpsWithSteps = 0;
+          let curvedOpCount = 0;
+          const sumSteps = (block: any) => {
+            if (!block || typeof block !== 'object') return { ops: 0, opsWithSteps: 0, totalSteps: 0 };
+            let ops = 0, opsWithSteps = 0, totalSteps = 0;
+            for (const def of Object.values(block)) {
+              ops++;
+              const steps = (def as any)?.steps;
+              if (Array.isArray(steps) && steps.length > 0) {
+                opsWithSteps++;
+                totalSteps += steps.length;
+              }
+            }
+            return { ops, opsWithSteps, totalSteps };
+          };
+          for (const compName of compNames) {
+            const comp = components[compName] || {};
+            const models = comp.models || {};
+            const controllers = comp.controllers || {};
+            const services = comp.services || {};
+            const events = comp.events || {};
+            const views = comp.views || {};
+            entityCount += Object.keys(models).length;
+            controllerCount += Object.keys(controllers).length;
+            serviceCount += Object.keys(services).length;
+            eventCount += Object.keys(events).length;
+            viewCount += Object.keys(views).length;
+            for (const m of Object.values(models)) {
+              const r = sumSteps((m as any)?.behaviors);
+              modelBehaviorsWithSteps += r.opsWithSteps;
+              modelBehaviorSteps += r.totalSteps;
+            }
+            for (const c of Object.values(controllers)) {
+              const r = sumSteps((c as any)?.actions);
+              controllerActionsWithSteps += r.opsWithSteps;
+              controllerActionSteps += r.totalSteps;
+              const cured = (c as any)?.cured || (c as any)?.curved;
+              if (cured && typeof cured === 'object') curvedOpCount += Object.keys(cured).length;
+            }
+            for (const s of Object.values(services)) {
+              const r = sumSteps((s as any)?.operations);
+              serviceOpsWithSteps += r.opsWithSteps;
+              serviceOpSteps += r.totalSteps;
+            }
+          }
+          const totalLlmCalls = modelBehaviorSteps + controllerActionSteps + serviceOpSteps;
+          const fileEstimate = entityCount * 7 + controllerCount + serviceCount * 2 + viewCount + 15;
+          console.log('');
+          console.log('╔══ spv realize --estimate ══════════════════════════════════════════');
+          console.log('║');
+          console.log('║  Type: ' + type);
+          console.log('║  Components: ' + compNames.length + (compNames.length > 0 ? ' (' + compNames.join(', ') + ')' : ''));
+          console.log('║');
+          console.log('║  ── Spec inventory (post-inference) ──');
+          console.log('║    Entities (models):    ' + entityCount);
+          console.log('║    Controllers:          ' + controllerCount);
+          console.log('║    Services:             ' + serviceCount);
+          console.log('║    Events:               ' + eventCount);
+          console.log('║    Views:                ' + viewCount);
+          console.log('║');
+          console.log('║  ── Output by realize layer ──');
+          console.log('║');
+          console.log('║  L1 — Instance factory (file scaffolding, no LLM):');
+          console.log('║    File scaffolding for each entity / controller / service / view');
+          console.log('║    + framework boilerplate (Fastify routes, Prisma schema, React shell)');
+          console.log('║    Estimate: ~' + fileEstimate + ' files');
+          console.log('║');
+          console.log('║  L2 — Convention pattern matching (bodies, no LLM):');
+          console.log('║    CURVED ops auto-implemented:    ' + curvedOpCount);
+          console.log('║    Default events on lifecycles:   ' + eventCount + ' (declared) + auto-derived');
+          console.log('║    Default validation patterns:    ~' + (entityCount * 2));
+          console.log('║');
+          console.log('║  L3 — AI from steps (LLM, 1 call per step):');
+          console.log('║    Model behaviors with steps:    ' + modelBehaviorsWithSteps + ' behaviors → ' + modelBehaviorSteps + ' steps');
+          console.log('║    Controller actions with steps: ' + controllerActionsWithSteps + ' actions → ' + controllerActionSteps + ' steps');
+          console.log('║    Service ops with steps:        ' + serviceOpsWithSteps + ' operations → ' + serviceOpSteps + ' steps');
+          console.log('║    ────────────────────────────────────────────────────────');
+          console.log('║    Total LLM calls:               ' + totalLlmCalls);
+          console.log('║');
+          if (totalLlmCalls > 0) {
+            console.log('║  ── Estimated wall time + cost (L3 only) ──');
+            console.log('║    On Opus 4.7 / Max:    ~' + Math.ceil(totalLlmCalls * 0.2) + ' min wall (free, claude-cli session-cached)');
+            console.log('║    On Sonnet 4.6:        ~' + Math.ceil(totalLlmCalls * 0.1) + ' min wall (free)');
+            console.log('║    On Anthropic API:     ~' + Math.ceil(totalLlmCalls * 0.1) + ' min wall, ~$' + (totalLlmCalls * 0.015).toFixed(2) + ' (Sonnet rates)');
+            console.log('║    On DeepSeek/Together: ~' + Math.ceil(totalLlmCalls * 0.08) + ' min wall, ~$' + (totalLlmCalls * 0.0008).toFixed(3) + ' (10-30× cheaper)');
+          } else {
+            console.log('║  No LLM cost — all output is L1 + L2 (templates + conventions only).');
+          }
+          console.log('║');
+          console.log('╚════════════════════════════════════════════════════════════════════');
+          return;
+        }
+
         // Realize — let the realize engine handle its own library.
         // Locate the nearest implementation manifest by walking up from the
         // spec file, then falling back to the user's cwd. This lets the same

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specverse/engines",
-  "version": "6.0.8",
+  "version": "6.0.10",
   "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry, bundles",
   "type": "module",
   "main": "dist/index.js",

package/libs/instance-factories/cli/templates/commander/command-generator.d.ts

@@ -1,14 +0,0 @@
-/**
- * Command Generator
- *
- * Generates individual command files from command specifications.
- * Each command registers itself on a Commander program and wires
- * to its corresponding service for business logic delegation.
- */
-import type { TemplateContext } from '@specverse/types';
-/**
- * Generate a single command file.
- * Called once per command in the spec.
- */
-export default function generateCommand(context: TemplateContext): string;
-//# sourceMappingURL=command-generator.d.ts.map

package/libs/instance-factories/cli/templates/commander/command-generator.js

@@ -1,182 +0,0 @@
-/**
- * Command Generator
- *
- * Generates individual command files from command specifications.
- * Each command registers itself on a Commander program and wires
- * to its corresponding service for business logic delegation.
- */
-/**
- * Generate a single command file.
- * Called once per command in the spec.
- */
-export default function generateCommand(context) {
-    const { command } = context;
-    if (!command) {
-        throw new Error('Command is required in template context');
-    }
-    const name = command.name;
-    const description = command.description || '';
-    const args = command.arguments || {};
-    const flags = command.flags || {};
-    const exitCodes = command.exitCodes || {};
-    const subcommands = command.subcommands || {};
-    const serviceRef = command.serviceRef;
-    // Build positional argument string for Commander
-    const positionalArgs = Object.entries(args)
-        .filter(([_, arg]) => arg.positional)
-        .sort((a, b) => (a[1].position || 0) - (b[1].position || 0))
-        .map(([argName, arg]) => {
-        const required = arg.required;
-        return required ? `<${argName}>` : `[${argName}]`;
-    })
-        .join(' ');
-    const commandStr = positionalArgs ? `${name} ${positionalArgs}` : name;
-    // Build options
-    const optionDefs = Object.entries(flags).map(([flagName, flag]) => {
-        const alias = flag.alias ? `${flag.alias}, ` : '';
-        const flagType = flag.type?.toLowerCase();
-        const valuePart = flagType === 'boolean' ? '' : ` <${flagName.replace(/^--/, '')}>`;
-        const defaultVal = flag.default !== undefined ? `, ${JSON.stringify(flag.default)}` : '';
-        const desc = flag.description || `${flagName} option`;
-        return `    .option('${alias}${flagName}${valuePart}', '${desc}'${defaultVal})`;
-    });
-    // Build type interface for options
-    const optionTypes = Object.entries(flags).map(([flagName, flag]) => {
-        const tsType = mapFlagTypeToTS(flag.type);
-        const key = flagName.replace(/^--/, '').replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-        return `  ${key}${flag.required ? '' : '?'}: ${tsType};`;
-    });
-    // Build positional arg types
-    const argTypes = Object.entries(args)
-        .filter(([_, arg]) => arg.positional)
-        .map(([argName, arg]) => {
-        const tsType = mapArgTypeToTS(arg.type);
-        return `${argName}: ${tsType}`;
-    });
-    // Generate action handler
-    const actionParams = argTypes.length > 0
-        ? argTypes.join(', ') + ', options: CommandOptions'
-        : 'options: CommandOptions';
-    // Generate exit code comments
-    const exitCodeComments = Object.entries(exitCodes).length > 0
-        ? Object.entries(exitCodes).map(([code, meaning]) => `  //   ${code}: ${meaning}`).join('\n')
-        : '';
-    // Handle subcommands
-    const hasSubcommands = Object.keys(subcommands).length > 0;
-    const subcommandRegistrations = hasSubcommands
-        ? generateSubcommandRegistrations(name, subcommands)
-        : '';
-    // Service import
-    const serviceImport = serviceRef
-        ? `import { ${serviceRef} } from '../services/${serviceRef}.js';`
-        : '';
-    return `/**
- * ${name} command
- * ${description}
- * Generated from SpecVerse specification
- */
-
-import { Command } from 'commander';
-${serviceImport}
-
-interface CommandOptions {
-${optionTypes.length > 0 ? optionTypes.join('\n') : '  [key: string]: any;'}
-}
-
-${exitCodeComments ? `/**\n * Exit codes:\n${exitCodeComments}\n */` : ''}
-
-/**
- * Register the ${name} command on the program.
- */
-export function register${capitalize(name)}Command(program: Command): void {
-  ${hasSubcommands ? generateCommandWithSubcommands(name, description, subcommands, optionDefs) : generateLeafCommand(name, description, commandStr, optionDefs, actionParams, serviceRef, exitCodes)}
-}
-${subcommandRegistrations}
-`;
-}
-function generateLeafCommand(name, description, commandStr, optionDefs, actionParams, serviceRef, exitCodes) {
-    const handler = serviceRef
-        ? `const service = new ${serviceRef}();
-      const result = await service.execute(${actionParams.includes(':') ? '{ ' + actionParams.split(',').map(p => p.trim().split(':')[0].trim()).join(', ') + ', ...options }' : 'options'});
-      console.log(result);`
-        : `console.log('Executing ${name}...');
-      // TODO: Wire to service`;
-    return `const cmd = program
-    .command('${commandStr}')
-    .description('${description}')
-${optionDefs.join('\n')}
-    .action(async (${actionParams}) => {
-      try {
-        ${handler}
-      } catch (error: any) {
-        console.error('Error:', error.message);
-        process.exit(${Object.keys(exitCodes).find(k => k !== '0') || '1'});
-      }
-    });`;
-}
-function generateCommandWithSubcommands(name, description, subcommands, optionDefs) {
-    const subcmdRegistrations = Object.entries(subcommands).map(([subName, subDef]) => {
-        const subDesc = subDef.description || '';
-        const subArgs = subDef.arguments || {};
-        const subFlags = subDef.flags || {};
-        const positionalStr = Object.entries(subArgs)
-            .filter(([_, a]) => a.positional)
-            .map(([n, a]) => a.required ? `<${n}>` : `[${n}]`)
-            .join(' ');
-        const subCmdStr = positionalStr ? `${subName} ${positionalStr}` : subName;
-        const subOptionDefs = Object.entries(subFlags).map(([flagName, flag]) => {
-            const alias = flag.alias ? `${flag.alias}, ` : '';
-            const flagType = flag.type?.toLowerCase();
-            const valuePart = flagType === 'boolean' ? '' : ` <${flagName.replace(/^--/, '')}>`;
-            const defaultVal = flag.default !== undefined ? `, ${JSON.stringify(flag.default)}` : '';
-            return `    .option('${alias}${flagName}${valuePart}', '${flag.description || flagName}'${defaultVal})`;
-        });
-        return `
-  cmd
-    .command('${subCmdStr}')
-    .description('${subDesc}')
-${subOptionDefs.join('\n')}
-    .action(async (...args: any[]) => {
-      try {
-        console.log('Executing ${name} ${subName}...');
-        // TODO: Wire to service
-      } catch (error: any) {
-        console.error('Error:', error.message);
-        process.exit(1);
-      }
-    });`;
-    });
-    return `const cmd = program
-    .command('${name}')
-    .description('${description}');
-${subcmdRegistrations.join('\n')}`;
-}
-function generateSubcommandRegistrations(_parentName, _subcommands) {
-    return ''; // Subcommands are registered inline
-}
-function mapFlagTypeToTS(type) {
-    if (!type)
-        return 'string';
-    const lower = type.toLowerCase();
-    if (lower === 'boolean')
-        return 'boolean';
-    if (lower === 'number' || lower === 'integer')
-        return 'number';
-    return 'string';
-}
-function mapArgTypeToTS(type) {
-    if (!type)
-        return 'string';
-    const lower = type.toLowerCase();
-    if (lower === 'filepath' || lower === 'string')
-        return 'string';
-    if (lower === 'number' || lower === 'integer')
-        return 'number';
-    if (lower === 'boolean')
-        return 'boolean';
-    return 'string';
-}
-function capitalize(str) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
-}
-//# sourceMappingURL=command-generator.js.map