@shanyucoder/flowgrid 0.1.0

package/dist/graph/db/index-store.js

@@ -0,0 +1,179 @@
+/**
+ * Local index store (SQLite via node:sqlite — Node 22+).
+ *
+ * Purpose:
+ * - Cache registry entries + last analyze gaps for fast MCP tool responses
+ * - Store "confirm memory" (member chose mark B for entity X) so next bullet
+ *   analyze can raise confidence WITHOUT sending chat history to the cloud
+ *
+ * NOT a SSOT — registries/*.json and specs in git remain source of truth.
+ * Rebuild anytime from disk.
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { INDEX_DIR } from '../config/load-config.js';
+export class IndexStore {
+    db;
+    /**
+     * @param repoRoot Absolute path to the product repo that owns .artifactgraph/
+     */
+    constructor(repoRoot) {
+        const dir = path.join(repoRoot, INDEX_DIR);
+        mkdirSync(dir, { recursive: true });
+        this.db = new DatabaseSync(path.join(dir, 'index.db'));
+        this.migrate();
+    }
+    /** Create tables if missing — keep schema tiny for v0.1. */
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS registry_entry (
+        registry TEXT NOT NULL,
+        entry_id TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        PRIMARY KEY (registry, entry_id)
+      );
+      CREATE TABLE IF NOT EXISTS decision (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        kind TEXT NOT NULL,
+        subject TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS gap_snapshot (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        spec_path TEXT,
+        payload TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS api_route (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        route_path TEXT NOT NULL,
+        method TEXT NOT NULL,
+        action TEXT NOT NULL DEFAULT '',
+        source_file TEXT NOT NULL,
+        surface TEXT NOT NULL DEFAULT '',
+        created_at TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_api_route_path ON api_route(route_path);
+    `);
+    }
+    /** Upsert one registry row (e.g. design shell DataListPage). */
+    upsertRegistryEntry(registry, entryId, payload) {
+        this.db
+            .prepare(`INSERT INTO registry_entry(registry, entry_id, payload)
+         VALUES (?, ?, ?)
+         ON CONFLICT(registry, entry_id) DO UPDATE SET payload = excluded.payload`)
+            .run(registry, entryId, JSON.stringify(payload));
+    }
+    /** Clear one registry namespace before full rebuild. */
+    clearRegistry(registry) {
+        this.db.prepare(`DELETE FROM registry_entry WHERE registry = ?`).run(registry);
+    }
+    /** Run a rebuild atomically so parse/index failures cannot leave partial state. */
+    transaction(work) {
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const result = work();
+            this.db.exec('COMMIT');
+            return result;
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
+    listRegistryEntries(registry) {
+        const rows = this.db
+            .prepare(`SELECT entry_id, payload FROM registry_entry WHERE registry = ?`)
+            .all(registry);
+        return rows.map((r) => ({ entryId: r.entry_id, payload: JSON.parse(r.payload) }));
+    }
+    /**
+     * Remember a grill confirm so later bullet-analyze can reuse it.
+     * Example subject: "entity:hotel|column:status" → needs-component MoStatusChip
+     */
+    rememberDecision(kind, subject, payload) {
+        this.db
+            .prepare(`INSERT INTO decision(kind, subject, payload, created_at) VALUES (?, ?, ?, ?)`)
+            .run(kind, subject, JSON.stringify(payload), new Date().toISOString());
+    }
+    findDecisions(subjectPrefix) {
+        const rows = this.db
+            .prepare(`SELECT kind, subject, payload FROM decision WHERE subject LIKE ? ORDER BY id DESC LIMIT 50`)
+            .all(`${subjectPrefix}%`);
+        return rows.map((r) => ({ kind: r.kind, subject: r.subject, payload: JSON.parse(r.payload) }));
+    }
+    findDecisionsByKind(kind) {
+        const rows = this.db
+            .prepare(`SELECT kind, subject, payload FROM decision WHERE kind = ? ORDER BY id DESC LIMIT 200`)
+            .all(kind);
+        return rows.map((r) => ({ kind: r.kind, subject: r.subject, payload: JSON.parse(r.payload) }));
+    }
+    saveGapSnapshot(specPath, gaps) {
+        this.db
+            .prepare(`INSERT INTO gap_snapshot(spec_path, payload, created_at) VALUES (?, ?, ?)`)
+            .run(specPath ?? null, JSON.stringify(gaps), new Date().toISOString());
+    }
+    setMeta(key, value) {
+        this.db
+            .prepare(`INSERT INTO meta(key, value) VALUES (?, ?)
+         ON CONFLICT(key) DO UPDATE SET value = excluded.value`)
+            .run(key, value);
+    }
+    getMeta(key) {
+        const row = this.db.prepare(`SELECT value FROM meta WHERE key = ?`).get(key);
+        return row?.value;
+    }
+    close() {
+        this.db.close();
+    }
+    // ---------------------------------------------------------------------------
+    // API Route index
+    // ---------------------------------------------------------------------------
+    /** Replace all API routes (call before re-indexing). */
+    clearApiRoutes() {
+        this.db.exec('DELETE FROM api_route');
+    }
+    /** Upsert one API route row (path+method = logical key; duplicates are kept for cross-file comparison). */
+    insertApiRoute(entry) {
+        this.db
+            .prepare(`INSERT INTO api_route(route_path, method, action, source_file, surface, created_at)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(entry.route_path, entry.method.toUpperCase(), entry.action, entry.source_file, entry.surface, new Date().toISOString());
+    }
+    /** Find routes by path prefix/exact and optional method filter. */
+    findApiRoutes(pathPattern, method) {
+        const isPrefix = pathPattern.endsWith('%');
+        if (method) {
+            const rows = this.db
+                .prepare(isPrefix
+                ? `SELECT route_path, method, action, source_file, surface FROM api_route WHERE route_path LIKE ? AND method = ?`
+                : `SELECT route_path, method, action, source_file, surface FROM api_route WHERE route_path = ? AND method = ?`)
+                .all(pathPattern, method.toUpperCase());
+            return rows;
+        }
+        const rows = this.db
+            .prepare(isPrefix
+            ? `SELECT route_path, method, action, source_file, surface FROM api_route WHERE route_path LIKE ?`
+            : `SELECT route_path, method, action, source_file, surface FROM api_route WHERE route_path = ?`)
+            .all(pathPattern);
+        return rows;
+    }
+    /** Load all indexed routes (for duplicate detection). */
+    listAllApiRoutes() {
+        return this.db
+            .prepare('SELECT route_path, method, action, source_file, surface FROM api_route ORDER BY route_path, method')
+            .all();
+    }
+    /** Count of indexed API routes (for rebuild summary). */
+    countApiRoutes() {
+        const row = this.db.prepare('SELECT COUNT(*) as n FROM api_route').get();
+        return row.n;
+    }
+}
+//# sourceMappingURL=index-store.js.map

package/dist/graph/db/index-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-store.js","sourceRoot":"","sources":["../../../src/graph/db/index-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAWpD,MAAM,OAAO,UAAU;IACb,EAAE,CAAc;IAExB;;OAEG;IACH,YAAY,QAAgB;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAC1C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;IAED,4DAA4D;IACpD,OAAO;QACb,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkCZ,CAAC,CAAA;IACJ,CAAC;IAED,gEAAgE;IAChE,mBAAmB,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAgB;QACrE,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;kFAE0E,CAC3E;aACA,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,wDAAwD;IACxD,aAAa,CAAC,QAAgB;QAC5B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAChF,CAAC;IAED,mFAAmF;IACnF,WAAW,CAAI,IAAa;QAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,EAAE,CAAA;YACrB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACtB,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACxB,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,QAAgB;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,iEAAiE,CAAC;aAC1E,GAAG,CAAC,QAAQ,CAAiD,CAAA;QAChE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;IACnF,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,IAAY,EAAE,OAAe,EAAE,OAAgB;QAC9D,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,8EAA8E,CAC/E;aACA,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED,aAAa,CAAC,aAAqB;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,4FAA4F,CAAC;aACrG,GAAG,CAAC,GAAG,aAAa,GAAG,CAA8D,CAAA;QACxF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;IAChG,CAAC;IAED,mBAAmB,CAAC,IAAY;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN,uFAAuF,CACxF;aACA,GAAG,CAAC,IAAI,CAA8D,CAAA;QACzE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;IAChG,CAAC;IAED,eAAe,CAAC,QAA4B,EAAE,IAAW;QACvD,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,2EAA2E,CAAC;aACpF,GAAG,CAAC,QAAQ,IAAI,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,KAAa;QAChC,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;+DACuD,CACxD;aACA,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpB,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,CAAC,GAAG,CAE9D,CAAA;QACb,OAAO,GAAG,EAAE,KAAK,CAAA;IACnB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAA;IACjB,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E,wDAAwD;IACxD,cAAc;QACZ,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACvC,CAAC;IAED,2GAA2G;IAC3G,cAAc,CAAC,KAAkB;QAC/B,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;mCAC2B,CAC5B;aACA,GAAG,CACF,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,EAC1B,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,OAAO,EACb,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CACzB,CAAA;IACL,CAAC;IAED,mEAAmE;IACnE,aAAa,CAAC,WAAmB,EAAE,MAAe;QAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;iBACjB,OAAO,CACN,QAAQ;gBACN,CAAC,CAAC,+GAA+G;gBACjH,CAAC,CAAC,4GAA4G,CACjH;iBACA,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAA6B,CAAA;YACrE,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN,QAAQ;YACN,CAAC,CAAC,gGAAgG;YAClG,CAAC,CAAC,6FAA6F,CAClG;aACA,GAAG,CAAC,WAAW,CAA6B,CAAA;QAC/C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,yDAAyD;IACzD,gBAAgB;QACd,OAAO,IAAI,CAAC,EAAE;aACX,OAAO,CAAC,oGAAoG,CAAC;aAC7G,GAAG,EAA8B,CAAA;IACtC,CAAC;IAED,yDAAyD;IACzD,cAAc;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,EAAmB,CAAA;QACzF,OAAO,GAAG,CAAC,CAAC,CAAA;IACd,CAAC;CACF"}

package/dist/graph/gen/run-command.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Spawn only allowlisted commands from artifactgraph.json.
+ *
+ * Security / token goal:
+ * - Agent must NOT invent shell commands
+ * - MCP substitutes {spec} etc., rejects legacy external paths, then runs fixed argv
+ */
+import type { ArtifactgraphConfig } from '../types.js';
+export interface RunCommandResult {
+    commandKey: string;
+    argv: string[];
+    cwd: string;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface InspectCommandResult {
+    ok: boolean;
+    commandKey: string;
+    allowlisted: boolean;
+    knownKeys: string[];
+    argv?: string[];
+    cwd: string;
+    executableOwner: 'product-repo' | 'flowgrid-code' | 'flowgrid-test' | 'flowgrid-docs' | 'unknown';
+    recommendation: string;
+}
+/**
+ * Inspect/materialize one product-owned allowlisted command without executing it.
+ * ArtifactGraph recommends; the owning kit/product runner executes.
+ */
+export declare function inspectAllowlistedCommand(repoRoot: string, cfg: ArtifactgraphConfig, commandKey: string, vars?: Record<string, string>): InspectCommandResult;
+/**
+ * Replace `{spec}` (and future placeholders) in the argv template.
+ */
+export declare function materializeArgv(template: string[], vars: Record<string, string>): string[];
+/**
+ * Run one named command from config.commands.
+ * @throws if commandKey is not in the allowlist
+ */
+export declare function runAllowlistedCommand(repoRoot: string, cfg: ArtifactgraphConfig, commandKey: string, vars?: Record<string, string>): RunCommandResult;

package/dist/graph/gen/run-command.js

@@ -0,0 +1,110 @@
+/**
+ * Spawn only allowlisted commands from artifactgraph.json.
+ *
+ * Security / token goal:
+ * - Agent must NOT invent shell commands
+ * - MCP substitutes {spec} etc., rejects legacy external paths, then runs fixed argv
+ */
+import { spawnSync } from 'node:child_process';
+import { expandArgvPaths } from '../config/resolve-paths.js';
+function commandOwner(commandKey) {
+    if (['docsRender', 'specSplit', 'specMerge', 'legacyValidate'].includes(commandKey)) {
+        return 'flowgrid-docs';
+    }
+    if (['testcaseGen', 'testcaseGenDry', 'casesRender', 'testE2e', 'e2eRegistry'].includes(commandKey)) {
+        return 'flowgrid-test';
+    }
+    if ([
+        'gen',
+        'genDry',
+        'unitGen',
+        'unitGenDry',
+        'registryValidate',
+        'unitRegistry',
+        'commonRegistry',
+        'contractGen',
+        'contractGenDry',
+        'contractRegistry',
+        'nestGen',
+        'nestGenDry',
+        'nestRegistry',
+    ].includes(commandKey)) {
+        return 'flowgrid-code';
+    }
+    return 'unknown';
+}
+/**
+ * Inspect/materialize one product-owned allowlisted command without executing it.
+ * ArtifactGraph recommends; the owning kit/product runner executes.
+ */
+export function inspectAllowlistedCommand(repoRoot, cfg, commandKey, vars = {}) {
+    const knownKeys = Object.keys(cfg.commands).sort();
+    const template = cfg.commands[commandKey];
+    const owner = commandOwner(commandKey);
+    if (!template) {
+        return {
+            ok: false,
+            commandKey,
+            allowlisted: false,
+            knownKeys,
+            cwd: repoRoot,
+            executableOwner: owner,
+            recommendation: `Command "${commandKey}" is not allowlisted in artifactgraph.json.`,
+        };
+    }
+    const argv = expandArgvPaths(repoRoot, materializeArgv(template, vars));
+    return {
+        ok: true,
+        commandKey,
+        allowlisted: true,
+        knownKeys,
+        argv,
+        cwd: repoRoot,
+        executableOwner: owner,
+        recommendation: owner === 'unknown'
+            ? 'Run with the product-owned command runner after review.'
+            : `Execute with ${owner}; ArtifactGraph does not own this generator.`,
+    };
+}
+/**
+ * Replace `{spec}` (and future placeholders) in the argv template.
+ */
+export function materializeArgv(template, vars) {
+    return template.map((part) => {
+        let out = part;
+        for (const [k, v] of Object.entries(vars)) {
+            out = out.split(`{${k}}`).join(v);
+        }
+        return out;
+    });
+}
+/**
+ * Run one named command from config.commands.
+ * @throws if commandKey is not in the allowlist
+ */
+export function runAllowlistedCommand(repoRoot, cfg, commandKey, vars = {}) {
+    const inspected = inspectAllowlistedCommand(repoRoot, cfg, commandKey, vars);
+    if (!inspected.allowlisted || !inspected.argv) {
+        throw new Error(`Command "${commandKey}" not allowlisted. Known: ${inspected.knownKeys.join(', ')}`);
+    }
+    const argv = inspected.argv;
+    const bin = argv[0];
+    if (!bin)
+        throw new Error(`Empty argv for command "${commandKey}"`);
+    const args = argv.slice(1);
+    const result = spawnSync(bin, args, {
+        cwd: repoRoot,
+        encoding: 'utf8',
+        shell: false,
+        env: process.env,
+    });
+    return {
+        commandKey,
+        argv,
+        cwd: repoRoot,
+        exitCode: result.status,
+        stdout: result.stdout ?? '',
+        stderr: result.stderr ?? '',
+    };
+}
+//# sourceMappingURL=run-command.js.map

package/dist/graph/gen/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../../src/graph/gen/run-command.ts"],"names":[],"mappings":"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"}

package/dist/graph/lexicon/infer-lane.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Infer suggest/analyze lane from artifactgraph.json stack + dsl.lanes.
+ */
+import type { ArtifactgraphConfig } from '../types.js';
+import type { SuggestLane } from './load-lexicon.js';
+/** Product repo primarily FE (design/common registries). */
+export declare function isFeStack(cfg: ArtifactgraphConfig): boolean;
+/** Product repo primarily BE (codegen registry). True if dsl.lanes.be present (incl. fullstack). */
+export declare function isBeStack(cfg: ArtifactgraphConfig): boolean;
+/** Default suggest_tags lane — fullstack (fe+be) defaults to fe; pass lane=be explicitly for API. */
+export declare function inferSuggestLane(cfg: ArtifactgraphConfig): SuggestLane;

package/dist/graph/lexicon/infer-lane.js

@@ -0,0 +1,28 @@
+/**
+ * Infer suggest/analyze lane from artifactgraph.json stack + dsl.lanes.
+ */
+const FE_STACKS = new Set(['nuxt4', 'nextjs', 'nuxt4-nest', 'nextjs-nest', 'dotnet-line']);
+const BE_STACKS = new Set(['laravel', 'fastapi', 'dotnet-integration']);
+/** Product repo primarily FE (design/common registries). */
+export function isFeStack(cfg) {
+    if (cfg.dsl?.lanes?.fe)
+        return true;
+    if (cfg.dsl?.lanes?.be && !cfg.dsl?.lanes?.fe)
+        return false;
+    return FE_STACKS.has(cfg.stack);
+}
+/** Product repo primarily BE (codegen registry). True if dsl.lanes.be present (incl. fullstack). */
+export function isBeStack(cfg) {
+    if (cfg.dsl?.lanes?.be)
+        return true;
+    if (cfg.dsl?.lanes?.fe && !cfg.dsl?.lanes?.be)
+        return false;
+    return BE_STACKS.has(cfg.stack);
+}
+/** Default suggest_tags lane — fullstack (fe+be) defaults to fe; pass lane=be explicitly for API. */
+export function inferSuggestLane(cfg) {
+    if (isBeStack(cfg) && !isFeStack(cfg))
+        return 'be';
+    return 'fe';
+}
+//# sourceMappingURL=infer-lane.js.map

package/dist/graph/lexicon/infer-lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-lane.js","sourceRoot":"","sources":["../../../src/graph/lexicon/infer-lane.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAA;AAC1F,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAA;AAEvE,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,GAAwB;IAChD,IAAI,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAAE,OAAO,IAAI,CAAA;IACnC,IAAI,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAAE,OAAO,KAAK,CAAA;IAC3D,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,SAAS,CAAC,GAAwB;IAChD,IAAI,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAAE,OAAO,IAAI,CAAA;IACnC,IAAI,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAAE,OAAO,KAAK,CAAA;IAC3D,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,gBAAgB,CAAC,GAAwB;IACvD,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAClD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/graph/lexicon/load-lexicon.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Parse project-local or packaged lexicon files.
+ * Local index only — never dump full file into cloudPromptSlice.
+ */
+import type { ArtifactgraphConfig } from '../types.js';
+import type { IndexStore } from '../db/index-store.js';
+export type SuggestLane = 'fe' | 'docs' | 'plans' | 'be';
+export interface RegistryTagsLexicon {
+    kind: 'registryTags';
+    path: string;
+    prefixes: string[];
+    shellIds: string[];
+    /** Lowercase keyword → suggested draft tag (subset). */
+    keywordHints: Record<string, string>;
+    terms: string[];
+}
+export interface TestTaxonomyLexicon {
+    kind: 'testTaxonomy';
+    path: string;
+    types: string[];
+    scenarios: string[];
+    dimensions: {
+        business: string[];
+        technical: string[];
+        quality: string[];
+    };
+    terms: string[];
+}
+export type LoadedLexicon = RegistryTagsLexicon | TestTaxonomyLexicon;
+export interface SuggestTagsResult {
+    lane: SuggestLane;
+    draftTags: string[];
+    enums?: Record<string, string[]>;
+    matches: Array<{
+        term: string;
+        tag?: string;
+        score: number;
+    }>;
+    sourcePaths: string[];
+    /** Tiny slice for cloud — matches only, not full lexicon */
+    cloudPromptSlice: string;
+}
+/** Parse R2.1 registry-tags.en.txt */
+export declare function parseRegistryTagsLexicon(absPath: string): RegistryTagsLexicon;
+/** Parse R3.1 testcase-taxonomy.en.txt */
+export declare function parseTestTaxonomyLexicon(absPath: string): TestTaxonomyLexicon;
+export declare function loadRegistryTagsLexicon(repoRoot: string, cfg: ArtifactgraphConfig): RegistryTagsLexicon | null;
+export declare function loadTestTaxonomyLexicon(repoRoot: string, cfg: ArtifactgraphConfig): TestTaxonomyLexicon | null;
+/** Index lexicons into SQLite under registry namespaces lexicon:*. */
+export declare function indexLexicons(store: IndexStore, repoRoot: string, cfg: ArtifactgraphConfig): Record<string, number>;
+/**
+ * Suggest draft tags / taxonomy enums for a lane (local-first).
+ */
+export declare function suggestTags(opts: {
+    repoRoot: string;
+    cfg: ArtifactgraphConfig;
+    lane: SuggestLane;
+    bullets?: string;
+    limit?: number;
+}): SuggestTagsResult;