openlore 2.0.7 → 2.0.9

package/dist/core/provenance/git-provenance.js.map

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

package/dist/core/provenance/project.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Projection: per-file provenance → typed `authored_by` / `changed_in_pr` graph
+ * edges (spec-18). The decisions/IaC analogue: git history is the authored source;
+ * this projection is derived and regenerable. Edges hang off existing file nodes —
+ * no person/PR nodes are added to the call graph, keeping it un-bloated (the cap is
+ * applied upstream in the extractor).
+ *
+ * Edge direction is code → context: a file is `authored_by` a person and
+ * `changed_in_pr` a pull request.
+ */
+import type { FileProvenance } from './git-provenance.js';
+/** file → person. `role: 'last'` marks the last-touch author. */
+export interface AuthoredByEdge {
+    kind: 'authored_by';
+    filePath: string;
+    name: string;
+    email: string;
+    /** Author date of the last-touch commit (only meaningful for role 'last'). */
+    lastDate?: string;
+    role: 'last' | 'recent';
+}
+/** file → pull request. `title`/`state` present only when `gh` enrichment succeeded. */
+export interface ChangedInPrEdge {
+    kind: 'changed_in_pr';
+    filePath: string;
+    pr: number;
+    title?: string;
+    state?: string;
+}
+export interface ProjectedProvenance {
+    authoredBy: AuthoredByEdge[];
+    changedInPr: ChangedInPrEdge[];
+}
+/** "Name <email>" display key for a person (stable identity). */
+export declare function personKey(name: string, email: string): string;
+export declare function projectProvenance(records: FileProvenance[]): ProjectedProvenance;
+//# sourceMappingURL=project.d.ts.map

package/dist/core/provenance/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/core/provenance/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB;AAED,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,mBAAmB,CAgChF"}

package/dist/core/provenance/project.js

@@ -0,0 +1,46 @@
+/**
+ * Projection: per-file provenance → typed `authored_by` / `changed_in_pr` graph
+ * edges (spec-18). The decisions/IaC analogue: git history is the authored source;
+ * this projection is derived and regenerable. Edges hang off existing file nodes —
+ * no person/PR nodes are added to the call graph, keeping it un-bloated (the cap is
+ * applied upstream in the extractor).
+ *
+ * Edge direction is code → context: a file is `authored_by` a person and
+ * `changed_in_pr` a pull request.
+ */
+/** "Name <email>" display key for a person (stable identity). */
+export function personKey(name, email) {
+    return email ? `${name} <${email}>` : name;
+}
+export function projectProvenance(records) {
+    const authoredBy = [];
+    const changedInPr = [];
+    for (const r of [...records].sort((a, b) => a.filePath.localeCompare(b.filePath))) {
+        // Last-touch author first, then the remaining recent authors (deduped).
+        authoredBy.push({
+            kind: 'authored_by',
+            filePath: r.filePath,
+            name: r.lastAuthor.name,
+            email: r.lastAuthor.email,
+            lastDate: r.lastDate,
+            role: 'last',
+        });
+        const lastKey = personKey(r.lastAuthor.name, r.lastAuthor.email);
+        for (const a of r.recentAuthors) {
+            if (personKey(a.name, a.email) === lastKey)
+                continue;
+            authoredBy.push({ kind: 'authored_by', filePath: r.filePath, name: a.name, email: a.email, role: 'recent' });
+        }
+        for (const pr of r.prs) {
+            changedInPr.push({
+                kind: 'changed_in_pr',
+                filePath: r.filePath,
+                pr: pr.number,
+                ...(pr.title ? { title: pr.title } : {}),
+                ...(pr.state ? { state: pr.state } : {}),
+            });
+        }
+    }
+    return { authoredBy, changedInPr };
+}
+//# sourceMappingURL=project.js.map

package/dist/core/provenance/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/core/provenance/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6BH,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,MAAM,WAAW,GAAsB,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClF,wEAAwE;QACxE,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI;YACvB,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;YACzB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACjE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;YAChC,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,OAAO;gBAAE,SAAS;YACrD,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/G,CAAC;QAED,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACvB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,EAAE,EAAE,EAAE,CAAC,MAAM;gBACb,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC"}

package/dist/core/services/config-manager.d.ts

@@ -54,6 +54,23 @@ export declare function openspecConfigExists(openspecPath: string): Promise<bool
  * Create minimal OpenSpec directory structure
  */
 export declare function createOpenSpecStructure(openspecPath: string): Promise<void>;
+/** A spec directory discovered on disk before `init` decides where to point. */
+export interface DetectedSpecDir {
+    /** openspec-root, relative to the project root (config `openspecPath`). */
+    root: string;
+    /** The `<root>/specs` directory, relative to the project root. */
+    specsRel: string;
+    /** Count of `*.md` files found beneath the specs dir. */
+    count: number;
+}
+/**
+ * Detect an existing specs directory so `init` does not create an empty
+ * `openspec/` blind to specs that already live in `docs/specs/` or `specs/`
+ * (Spec 26 B5). Candidate openspec-roots are scanned in priority order; the
+ * first whose `<root>/specs` contains at least one `*.md` wins. Returns null
+ * when nothing is found.
+ */
+export declare function detectExistingSpecDir(rootPath: string): Promise<DetectedSpecDir | null>;
 /**
  * Merge existing OpenSpec config with openlore metadata
  */

package/dist/core/services/config-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../../src/core/services/config-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,CAiB/F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAezF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAc7F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,GACvC,cAAc,CAgBhB"}
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../../src/core/services/config-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,CAiB/F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAezF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAc7F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAsB7F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,GACvC,cAAc,CAgBhB"}

package/dist/core/services/config-manager.js

@@ -3,7 +3,7 @@
  *
  * Handles reading/writing .openlore/config.json and openspec/config.yaml
  */
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, writeFile, readdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import YAML from 'yaml';
 import { logger } from '../../utils/logger.js';
@@ -127,6 +127,40 @@ export async function createOpenSpecStructure(openspecPath) {
     await ensureDir(openspecPath);
     await ensureDir(join(openspecPath, 'specs'));
 }
+/**
+ * Detect an existing specs directory so `init` does not create an empty
+ * `openspec/` blind to specs that already live in `docs/specs/` or `specs/`
+ * (Spec 26 B5). Candidate openspec-roots are scanned in priority order; the
+ * first whose `<root>/specs` contains at least one `*.md` wins. Returns null
+ * when nothing is found.
+ */
+export async function detectExistingSpecDir(rootPath) {
+    // root (relative) → specs live at `<root>/specs`. '.' covers a bare `specs/`.
+    const candidateRoots = ['openspec', 'docs', '.'];
+    for (const root of candidateRoots) {
+        const specsRel = root === '.' ? 'specs' : `${root}/specs`;
+        const specsDir = join(rootPath, specsRel);
+        let count = 0;
+        try {
+            const stack = [specsDir];
+            while (stack.length) {
+                const dir = stack.pop();
+                for (const d of await readdir(dir, { withFileTypes: true })) {
+                    if (d.isDirectory())
+                        stack.push(join(dir, d.name));
+                    else if (d.name.endsWith('.md'))
+                        count++;
+                }
+            }
+        }
+        catch {
+            continue; // specs dir doesn't exist — try the next candidate
+        }
+        if (count > 0)
+            return { root, specsRel, count };
+    }
+    return null;
+}
 /**
  * Merge existing OpenSpec config with openlore metadata
  */

package/dist/core/services/config-manager.js.map

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

package/dist/core/services/edge-store.d.ts

@@ -1,6 +1,17 @@
 import type { CallEdge, FunctionNode, ClassNode, InheritanceEdge } from '../analyzer/call-graph.js';
+import type { DecisionNode, DecisionAffectsEdge } from '../decisions/project.js';
+import type { FileProvenance } from '../provenance/git-provenance.js';
+import type { FileChangeCoupling, ChangeCouplingResult } from '../provenance/change-coupling.js';
 export declare class EdgeStore {
     private readonly db;
+    /**
+     * True when opening this DB found a stale SCHEMA_VERSION and wiped it (rebuild-on-bump).
+     * The data is gone until the next analyze repopulates it — callers that READ
+     * (vs. analyze, which repopulates) should treat the store as unavailable so they
+     * can tell the user to re-run analyze instead of serving an empty graph.
+     */
+    private _wasReset;
+    get wasReset(): boolean;
     private constructor();
     private initSchema;
     /** All distinct files that call into calleeFile (reverse lookup before delete). */
@@ -49,6 +60,36 @@ export declare class EdgeStore {
     getClassesForFile(file: string): ClassNode[];
     deleteClassesForFile(file: string): void;
     insertClasses(classes: ClassNode[]): void;
+    /** Replace the projected decision graph wholesale (idempotent re-projection). */
+    insertDecisions(nodes: DecisionNode[], edges: DecisionAffectsEdge[]): void;
+    /** Every projected decision node (deterministic order). */
+    getAllDecisions(): DecisionNode[];
+    countDecisions(): number;
+    /**
+     * Governing decisions for a set of files — the deterministic graph join that
+     * replaces orient's runtime affectedFiles set-membership filter (spec-16).
+     *
+     * Path forms differ across callers (edge-store nodes are repo-relative; some
+     * callers pass absolute paths), and decisions are few, so we match in JS with a
+     * tolerant suffix comparator rather than relying on exact SQL equality.
+     */
+    getDecisionsForFiles(files: string[]): DecisionNode[];
+    /** Replace the per-file provenance wholesale (idempotent re-extraction). */
+    insertProvenance(records: FileProvenance[]): void;
+    countProvenance(): number;
+    /**
+     * Provenance for a set of files. Path forms differ across callers (edge-store
+     * nodes are repo-relative; some callers pass absolute paths), so match with the
+     * same tolerant comparator used for decisions (spec-18).
+     */
+    getProvenanceForFiles(files: string[]): FileProvenance[];
+    /** Replace the per-file change-coupling snapshot wholesale (idempotent re-mine). */
+    insertChangeCoupling(result: ChangeCouplingResult): void;
+    countChangeCoupling(): number;
+    /** Change-coupling records for a set of files (tolerant path match, spec-22). */
+    getChangeCouplingForFiles(files: string[]): FileChangeCoupling[];
+    /** Top-churn (most volatile) files, descending. */
+    getTopVolatile(limit?: number): FileChangeCoupling[];
     getFileHash(filePath: string): string | null;
     setFileHash(filePath: string, hash: string): void;
     /** Drop all graph data — used by full analyze rebuild. */

package/dist/core/services/edge-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge-store.d.ts","sourceRoot":"","sources":["../../../src/core/services/edge-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA6CpG,qBAAa,SAAS;IACA,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAvC,OAAO;IAIP,OAAO,CAAC,UAAU;IA4FlB,mFAAmF;IACnF,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAO5C,qDAAqD;IACrD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAAC,QAAQ,EAAE,QAAQ,EAAE,CAAA;KAAE;IAU7E,0DAA0D;IAC1D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMtC,wDAAwD;IACxD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE;IAMtC,8EAA8E;IAC9E,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE;IAQjD,8EAA8E;IAC9E,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE;IAUjD,4DAA4D;IAC5D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC,yEAAyE;IACzE,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9C,iDAAiD;IACjD,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAwBpC,6DAA6D;IAC7D,sBAAsB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,IAAI;IAatD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKxC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAM7C;;;;OAIG;IACH,mBAAmB,IAAI,YAAY,EAAE;IAMrC,0GAA0G;IAC1G,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE;IAoBxD,OAAO,CAAC,KAAK,SAAK,GAAG,YAAY,EAAE;IAQnC,cAAc,CAAC,KAAK,SAAK,GAAG,YAAY,EAAE;IAQ1C,UAAU,IAAI,MAAM;IAOpB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWtC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAqCtF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKtC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAQ5C,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI;IA2BzC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO5C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQjD,0DAA0D;IAC1D,QAAQ,IAAI,IAAI;IAIhB,iDAAiD;IACjD,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAIjC,KAAK,IAAI,IAAI;IAMb,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAItC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIzC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAGzC"}
+{"version":3,"file":"edge-store.d.ts","sourceRoot":"","sources":["../../../src/core/services/edge-store.ts"],"names":[],"mappings":"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"}

package/dist/core/services/edge-store.js

@@ -43,9 +43,17 @@ function runTransaction(db, fn) {
     }
 }
 /** Bump when schema changes. Old DBs are dropped and rebuilt on next analyze --force. */
-const SCHEMA_VERSION = 2;
+const SCHEMA_VERSION = 5;
 export class EdgeStore {
     db;
+    /**
+     * True when opening this DB found a stale SCHEMA_VERSION and wiped it (rebuild-on-bump).
+     * The data is gone until the next analyze repopulates it — callers that READ
+     * (vs. analyze, which repopulates) should treat the store as unavailable so they
+     * can tell the user to re-run analyze instead of serving an empty graph.
+     */
+    _wasReset = false;
+    get wasReset() { return this._wasReset; }
     constructor(db) {
         this.db = db;
         this.initSchema();
@@ -58,12 +66,17 @@ export class EdgeStore {
             this.db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(SCHEMA_VERSION);
         }
         else if (row.version !== SCHEMA_VERSION) {
+            this._wasReset = true;
             this.db.exec(`
         DROP TABLE IF EXISTS edges;
         DROP TABLE IF EXISTS inheritance_edges;
         DROP TABLE IF EXISTS nodes;
         DROP TABLE IF EXISTS classes;
         DROP TABLE IF EXISTS file_hashes;
+        DROP TABLE IF EXISTS decisions;
+        DROP TABLE IF EXISTS decision_edges;
+        DROP TABLE IF EXISTS provenance;
+        DROP TABLE IF EXISTS change_coupling;
         DROP TABLE IF EXISTS schema_version;
         CREATE TABLE schema_version (version INTEGER NOT NULL);
       `);
@@ -137,6 +150,51 @@ export class EdgeStore {
       );
 
       CREATE VIRTUAL TABLE IF NOT EXISTS nodes_fts USING fts5(node_id UNINDEXED, name, tokenize='trigram');
+
+      -- Architectural decisions projected as first-class graph nodes (spec-16).
+      -- Derived from .openlore/decisions/pending.json; the JSON store stays
+      -- authoritative. Held in dedicated tables so code-node stats (hubs,
+      -- entry points, countNodes) and call-edge BFS are untouched.
+      CREATE TABLE IF NOT EXISTS decisions (
+        id               TEXT PRIMARY KEY,  -- graph node id "decision::<id>"
+        decision_id      TEXT NOT NULL,     -- original 8-char store id
+        title            TEXT NOT NULL,
+        status           TEXT NOT NULL,
+        rationale        TEXT NOT NULL DEFAULT '',
+        consequences     TEXT NOT NULL DEFAULT '',
+        affected_domains TEXT NOT NULL DEFAULT '[]',
+        affected_files   TEXT NOT NULL DEFAULT '[]',
+        confidence       TEXT,
+        supersedes       TEXT
+      );
+
+      -- affects edges: decision node -> governed file path.
+      CREATE TABLE IF NOT EXISTS decision_edges (
+        decision_id TEXT NOT NULL,  -- graph node id "decision::<id>"
+        file_path   TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_decision_edge_file ON decision_edges(file_path);
+      CREATE INDEX IF NOT EXISTS idx_decision_edge_dec  ON decision_edges(decision_id);
+
+      -- Local provenance (spec-18): per-file last-author + recent authors + PRs,
+      -- derived from local git/gh. Capped upstream; one row per file, no graph bloat.
+      CREATE TABLE IF NOT EXISTS provenance (
+        file_path      TEXT PRIMARY KEY,
+        last_author    TEXT NOT NULL,           -- JSON {name,email}
+        last_date      TEXT,
+        last_commit    TEXT,
+        last_subject   TEXT,
+        recent_authors TEXT NOT NULL DEFAULT '[]', -- JSON Author[]
+        prs            TEXT NOT NULL DEFAULT '[]'   -- JSON PullRequest[]
+      );
+
+      -- Change coupling & volatility (spec-22): per-file churn + co-change pairs,
+      -- mined from local git history. One row per file; advisory caution signals.
+      CREATE TABLE IF NOT EXISTS change_coupling (
+        file_path    TEXT PRIMARY KEY,
+        churn        INTEGER NOT NULL DEFAULT 0,
+        coupled_with TEXT NOT NULL DEFAULT '[]'  -- JSON CoupledFile[]
+      );
     `);
     }
     // ── Edge queries ──────────────────────────────────────────────────────────────
@@ -236,6 +294,10 @@ export class EdgeStore {
     /** Case-insensitive substring search on node name. FTS5 trigram for ≥3 chars, LIKE fallback otherwise. */
     searchNodes(pattern, limit = 50) {
         if (pattern.length >= 3) {
+            // Wrap as an FTS5 phrase so special characters in the symbol are literal —
+            // IaC resource names contain ':' (e.g. "Bucket:logs") and '.' which FTS5
+            // would otherwise read as column filters / operators (spec-17).
+            const phrase = `"${pattern.replace(/"/g, '""')}"`;
             return this.db
                 .prepare(`
             SELECT n.* FROM nodes_fts f
@@ -243,7 +305,7 @@ export class EdgeStore {
             WHERE nodes_fts MATCH ? AND n.is_external = 0
             LIMIT ?
           `)
-                .all(pattern, limit).map(rawToFunctionNode);
+                .all(phrase, limit).map(rawToFunctionNode);
         }
         return this.db
             .prepare('SELECT * FROM nodes WHERE name LIKE ? AND is_external = 0 LIMIT ?')
@@ -347,6 +409,149 @@ export class EdgeStore {
             }
         });
     }
+    // ── Decision queries / mutations (spec-16) ─────────────────────────────────────
+    /** Replace the projected decision graph wholesale (idempotent re-projection). */
+    insertDecisions(nodes, edges) {
+        const nodeStmt = this.db.prepare(`
+      INSERT OR REPLACE INTO decisions
+        (id, decision_id, title, status, rationale, consequences, affected_domains, affected_files, confidence, supersedes)
+      VALUES
+        (@id, @decisionId, @title, @status, @rationale, @consequences, @affectedDomains, @affectedFiles, @confidence, @supersedes)
+    `);
+        const edgeStmt = this.db.prepare('INSERT INTO decision_edges (decision_id, file_path) VALUES (?, ?)');
+        runTransaction(this.db, () => {
+            this.db.exec('DELETE FROM decisions; DELETE FROM decision_edges;');
+            for (const n of nodes) {
+                nodeStmt.run({
+                    '@id': n.id,
+                    '@decisionId': n.decisionId,
+                    '@title': n.title,
+                    '@status': n.status,
+                    '@rationale': n.rationale,
+                    '@consequences': n.consequences,
+                    '@affectedDomains': JSON.stringify(n.affectedDomains),
+                    '@affectedFiles': JSON.stringify(n.affectedFiles),
+                    '@confidence': n.confidence ?? null,
+                    '@supersedes': n.supersedes ?? null,
+                });
+            }
+            for (const e of edges)
+                edgeStmt.run(e.decisionNodeId, e.filePath);
+        });
+    }
+    /** Every projected decision node (deterministic order). */
+    getAllDecisions() {
+        return this.db.prepare('SELECT * FROM decisions ORDER BY id').all().map(rawToDecisionNode);
+    }
+    countDecisions() {
+        const row = this.db.prepare('SELECT COUNT(*) as n FROM decisions').get();
+        return row.n;
+    }
+    /**
+     * Governing decisions for a set of files — the deterministic graph join that
+     * replaces orient's runtime affectedFiles set-membership filter (spec-16).
+     *
+     * Path forms differ across callers (edge-store nodes are repo-relative; some
+     * callers pass absolute paths), and decisions are few, so we match in JS with a
+     * tolerant suffix comparator rather than relying on exact SQL equality.
+     */
+    getDecisionsForFiles(files) {
+        if (files.length === 0)
+            return [];
+        const edgeRows = this.db
+            .prepare('SELECT decision_id, file_path FROM decision_edges')
+            .all();
+        if (edgeRows.length === 0)
+            return [];
+        const wanted = files.filter(Boolean);
+        const matchedIds = new Set();
+        for (const row of edgeRows) {
+            if (wanted.some(f => pathsMatch(f, row.file_path)))
+                matchedIds.add(row.decision_id);
+        }
+        if (matchedIds.size === 0)
+            return [];
+        return this.getAllDecisions().filter(d => matchedIds.has(d.id));
+    }
+    // ── Provenance queries / mutations (spec-18) ───────────────────────────────────
+    /** Replace the per-file provenance wholesale (idempotent re-extraction). */
+    insertProvenance(records) {
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO provenance
+        (file_path, last_author, last_date, last_commit, last_subject, recent_authors, prs)
+      VALUES
+        (@filePath, @lastAuthor, @lastDate, @lastCommit, @lastSubject, @recentAuthors, @prs)
+    `);
+        runTransaction(this.db, () => {
+            this.db.exec('DELETE FROM provenance;');
+            for (const r of records) {
+                stmt.run({
+                    '@filePath': r.filePath,
+                    '@lastAuthor': JSON.stringify(r.lastAuthor),
+                    '@lastDate': r.lastDate ?? null,
+                    '@lastCommit': r.lastCommit ?? null,
+                    '@lastSubject': r.lastSubject ?? null,
+                    '@recentAuthors': JSON.stringify(r.recentAuthors),
+                    '@prs': JSON.stringify(r.prs),
+                });
+            }
+        });
+    }
+    countProvenance() {
+        const row = this.db.prepare('SELECT COUNT(*) as n FROM provenance').get();
+        return row.n;
+    }
+    /**
+     * Provenance for a set of files. Path forms differ across callers (edge-store
+     * nodes are repo-relative; some callers pass absolute paths), so match with the
+     * same tolerant comparator used for decisions (spec-18).
+     */
+    getProvenanceForFiles(files) {
+        if (files.length === 0)
+            return [];
+        const rows = this.db.prepare('SELECT * FROM provenance').all();
+        if (rows.length === 0)
+            return [];
+        const wanted = files.filter(Boolean);
+        return rows
+            .filter(r => wanted.some(f => pathsMatch(f, r.file_path)))
+            .map(rawToProvenance);
+    }
+    // ── Change coupling & volatility (spec-22) ─────────────────────────────────────
+    /** Replace the per-file change-coupling snapshot wholesale (idempotent re-mine). */
+    insertChangeCoupling(result) {
+        const stmt = this.db.prepare('INSERT OR REPLACE INTO change_coupling (file_path, churn, coupled_with) VALUES (@filePath, @churn, @coupledWith)');
+        runTransaction(this.db, () => {
+            this.db.exec('DELETE FROM change_coupling;');
+            // Persist every file that has churn (coupling may be empty for some).
+            for (const [filePath, churn] of result.churn) {
+                stmt.run({
+                    '@filePath': filePath,
+                    '@churn': churn,
+                    '@coupledWith': JSON.stringify(result.coupling.get(filePath) ?? []),
+                });
+            }
+        });
+    }
+    countChangeCoupling() {
+        const row = this.db.prepare('SELECT COUNT(*) as n FROM change_coupling').get();
+        return row.n;
+    }
+    /** Change-coupling records for a set of files (tolerant path match, spec-22). */
+    getChangeCouplingForFiles(files) {
+        if (files.length === 0)
+            return [];
+        const rows = this.db.prepare('SELECT * FROM change_coupling').all();
+        if (rows.length === 0)
+            return [];
+        const wanted = files.filter(Boolean);
+        return rows.filter(r => wanted.some(f => pathsMatch(f, r.file_path))).map(rawToCoupling);
+    }
+    /** Top-churn (most volatile) files, descending. */
+    getTopVolatile(limit = 20) {
+        return this.db.prepare('SELECT * FROM change_coupling ORDER BY churn DESC, file_path ASC LIMIT ?')
+            .all(limit).map(rawToCoupling);
+    }
     // ── Content-hash cache ────────────────────────────────────────────────────────
     getFileHash(filePath) {
         const row = this.db
@@ -361,7 +566,7 @@ export class EdgeStore {
     }
     /** Drop all graph data — used by full analyze rebuild. */
     clearAll() {
-        this.db.exec('DELETE FROM edges; DELETE FROM inheritance_edges; DELETE FROM nodes; DELETE FROM classes; DELETE FROM nodes_fts; DELETE FROM file_hashes;');
+        this.db.exec('DELETE FROM edges; DELETE FROM inheritance_edges; DELETE FROM nodes; DELETE FROM classes; DELETE FROM nodes_fts; DELETE FROM file_hashes; DELETE FROM decisions; DELETE FROM decision_edges; DELETE FROM provenance; DELETE FROM change_coupling;');
     }
     /** Run fn inside a single SQLite transaction. */
     transaction(fn) {
@@ -381,6 +586,49 @@ export class EdgeStore {
         return join(outputDir, ARTIFACT_CALL_GRAPH_DB);
     }
 }
+function rawToCoupling(r) {
+    return {
+        filePath: r.file_path,
+        churn: r.churn,
+        coupledWith: JSON.parse(r.coupled_with),
+    };
+}
+function rawToProvenance(r) {
+    return {
+        filePath: r.file_path,
+        lastAuthor: JSON.parse(r.last_author),
+        lastDate: r.last_date ?? '',
+        lastCommit: r.last_commit ?? '',
+        lastSubject: r.last_subject ?? '',
+        recentAuthors: JSON.parse(r.recent_authors),
+        prs: JSON.parse(r.prs),
+    };
+}
+/** Tolerant path equality: exact, or one path is a suffix of the other. */
+function pathsMatch(a, b) {
+    if (a === b)
+        return true;
+    const na = a.replace(/^\/+/, '');
+    const nb = b.replace(/^\/+/, '');
+    if (na === nb)
+        return true;
+    return na.endsWith('/' + nb) || nb.endsWith('/' + na);
+}
+function rawToDecisionNode(r) {
+    return {
+        id: r.id,
+        decisionId: r.decision_id,
+        kind: 'decision',
+        title: r.title,
+        status: r.status,
+        rationale: r.rationale,
+        consequences: r.consequences,
+        affectedDomains: JSON.parse(r.affected_domains),
+        affectedFiles: JSON.parse(r.affected_files),
+        confidence: (r.confidence ?? 'medium'),
+        ...(r.supersedes ? { supersedes: r.supersedes } : {}),
+    };
+}
 function rawToCallEdge(r) {
     return {
         callerId: r.caller_id,