@specferret/core 0.1.0

package/dist/store/factory.js

@@ -0,0 +1,52 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { SqliteStore } from "./sqlite.js";
+import { PostgresStore } from "./postgres.js";
+import { loadConfig } from "../config.js";
+import { findProjectRoot } from "../utils/paths.js";
+/**
+ * Evaluates the current environment and configuration (handling overrides from the CI pipeline, S005)
+ * and returns the correct initialized database engine.
+ */
+export async function getStore() {
+    // S005: If FERRET_DATABASE_URL is set in the environment, use PostgreSQL without prompts.
+    const envUrl = process.env.FERRET_DATABASE_URL;
+    if (envUrl) {
+        const store = new PostgresStore(envUrl);
+        // In production we should ensure init() was run by `ferret init`, but we do it gracefully here
+        // or rely on the user to run init. If this was just the runner, it shouldn't recreate tables.
+        // For now we assume the caller handles init if necessary, or we just return the instantiated store.
+        return store;
+    }
+    // At this point FERRET_DATABASE_URL is NOT set in the environment (we returned early above if it was).
+    // If the config explicitly opts into postgres, that means the user ran `ferret upgrade --postgres`
+    // which writes FERRET_DATABASE_URL to .env, but that .env has not been loaded into the environment.
+    // Fail fast with a clear error rather than silently falling through to SQLite.
+    try {
+        const config = await loadConfig();
+        if (config.store === "postgres") {
+            console.error("FATAL: ferret.config.json sets store to postgres but FERRET_DATABASE_URL is not set. Source your .env file or set the variable in your environment.");
+            process.exit(1);
+        }
+    }
+    catch {
+        // Suppress config missing errors and fallback to logic
+    }
+    // S005: If FERRET_DATABASE_URL is not set, and config is missing / local, fall back to SQLite
+    // Check if .ferret/graph.db exists relative to the discovered project root
+    const dbPath = path.join(findProjectRoot(), ".ferret", "graph.db");
+    try {
+        await fs.access(dbPath);
+        return new SqliteStore(); // Implicit fallback to SQLite
+    }
+    catch (err) {
+        // CI Mode checking: 
+        if (process.env.FERRET_CI === "true") {
+            console.error("FATAL: FERRET_CI is true, but no database configuration found.");
+            process.exit(1);
+        }
+        // SQLite by default
+        return new SqliteStore();
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/store/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/store/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,0FAA0F;IAC1F,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACxC,+FAA+F;QAC/F,8FAA8F;QAC9F,oGAAoG;QACpG,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uGAAuG;IACvG,mGAAmG;IACnG,oGAAoG;IACpG,+EAA+E;IAC/E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,qJAAqJ,CAAC,CAAC;YACrK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;IAED,8FAA8F;IAC9F,2EAA2E;IAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,WAAW,EAAE,CAAC,CAAC,8BAA8B;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qBAAqB;QACrB,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,oBAAoB;QACpB,OAAO,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/store/postgres.d.ts

@@ -0,0 +1,25 @@
+import type { DBStore, FerretNode, FerretContract, FerretDependency, FerretReconciliationLog, FerretPlacementDecision, NodeStatus } from "./types.js";
+export declare class PostgresStore implements DBStore {
+    private connectionString;
+    constructor(connectionString: string);
+    private notImplemented;
+    init(): Promise<void>;
+    close(): Promise<void>;
+    getNodeByFilePath(_filePath: string): Promise<FerretNode | null>;
+    upsertNode(_node: FerretNode): Promise<void>;
+    getAllContractIds(): Promise<string[]>;
+    upsertContract(_contract: FerretContract): Promise<void>;
+    upsertDependency(_dependency: FerretDependency): Promise<void>;
+    replaceDependenciesForSourceNode(_sourceNodeId: string, _targetNodeIds: string[]): Promise<void>;
+    getNodes(): Promise<FerretNode[]>;
+    getNodesByStatus(_status: NodeStatus): Promise<FerretNode[]>;
+    getContracts(): Promise<FerretContract[]>;
+    getContract(_id: string): Promise<FerretContract | null>;
+    getDependencies(): Promise<FerretDependency[]>;
+    updateNodeStatus(_nodeId: string, _status: NodeStatus): Promise<void>;
+    insertReconciliationLog(_log: FerretReconciliationLog): Promise<void>;
+    getReconciliationLogs(): Promise<FerretReconciliationLog[]>;
+    insertPlacementDecision(_decision: FerretPlacementDecision): Promise<void>;
+    getPlacementDecisions(): Promise<FerretPlacementDecision[]>;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/store/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/store/postgres.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAc,YAAW,OAAO;IAC/B,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,MAAM;IAE5C,OAAO,CAAC,cAAc;IAOhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAGrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAGtB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAGhE,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAG5C,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAGtC,cAAc,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAGxD,gBAAgB,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAG9D,gCAAgC,CACpC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC;IAGV,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAGjC,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAG5D,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAGzC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAGxD,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAG9C,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAGrE,uBAAuB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAGrE,qBAAqB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAG3D,uBAAuB,CAC3B,SAAS,EAAE,uBAAuB,GACjC,OAAO,CAAC,IAAI,CAAC;IAGV,qBAAqB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAGlE"}

package/dist/store/postgres.js

@@ -0,0 +1,68 @@
+// Sprint 2 roadmap — Postgres support not yet implemented.
+// This stub exists so factory.ts compiles.
+// Do not use this in production until Sprint 2 is complete.
+export class PostgresStore {
+    connectionString;
+    constructor(connectionString) {
+        this.connectionString = connectionString;
+    }
+    notImplemented() {
+        throw new Error("PostgresStore: Postgres support is Sprint 2 roadmap. " +
+            'Set FERRET_DATABASE_URL to use Postgres, or remove the store: "postgres" config to use SQLite.');
+    }
+    async init() {
+        this.notImplemented();
+    }
+    async close() {
+        this.notImplemented();
+    }
+    async getNodeByFilePath(_filePath) {
+        this.notImplemented();
+    }
+    async upsertNode(_node) {
+        this.notImplemented();
+    }
+    async getAllContractIds() {
+        this.notImplemented();
+    }
+    async upsertContract(_contract) {
+        this.notImplemented();
+    }
+    async upsertDependency(_dependency) {
+        this.notImplemented();
+    }
+    async replaceDependenciesForSourceNode(_sourceNodeId, _targetNodeIds) {
+        this.notImplemented();
+    }
+    async getNodes() {
+        this.notImplemented();
+    }
+    async getNodesByStatus(_status) {
+        this.notImplemented();
+    }
+    async getContracts() {
+        this.notImplemented();
+    }
+    async getContract(_id) {
+        this.notImplemented();
+    }
+    async getDependencies() {
+        this.notImplemented();
+    }
+    async updateNodeStatus(_nodeId, _status) {
+        this.notImplemented();
+    }
+    async insertReconciliationLog(_log) {
+        this.notImplemented();
+    }
+    async getReconciliationLogs() {
+        this.notImplemented();
+    }
+    async insertPlacementDecision(_decision) {
+        this.notImplemented();
+    }
+    async getPlacementDecisions() {
+        this.notImplemented();
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/store/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/store/postgres.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,2CAA2C;AAC3C,4DAA4D;AAY5D,MAAM,OAAO,aAAa;IACJ;IAApB,YAAoB,gBAAwB;QAAxB,qBAAgB,GAAhB,gBAAgB,CAAQ;IAAG,CAAC;IAExC,cAAc;QACpB,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,gGAAgG,CACnG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACvC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,KAAiB;QAChC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,iBAAiB;QACrB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,SAAyB;QAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,gBAAgB,CAAC,WAA6B;QAClD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,gCAAgC,CACpC,aAAqB,EACrB,cAAwB;QAExB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,gBAAgB,CAAC,OAAmB;QACxC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,gBAAgB,CAAC,OAAe,EAAE,OAAmB;QACzD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,uBAAuB,CAAC,IAA6B;QACzD,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,uBAAuB,CAC3B,SAAkC;QAElC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IACD,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/store/sqlite.d.ts

@@ -0,0 +1,25 @@
+import type { DBStore, FerretNode, FerretContract, FerretDependency, FerretReconciliationLog, FerretPlacementDecision, NodeStatus } from "./types.js";
+export declare class SqliteStore implements DBStore {
+    private db;
+    private dbPath;
+    constructor(customPath?: string);
+    init(): Promise<void>;
+    close(): Promise<void>;
+    getNodeByFilePath(filePath: string): Promise<FerretNode | null>;
+    upsertNode(node: FerretNode): Promise<void>;
+    getAllContractIds(): Promise<string[]>;
+    upsertContract(contract: FerretContract): Promise<void>;
+    upsertDependency(dependency: FerretDependency): Promise<void>;
+    replaceDependenciesForSourceNode(sourceNodeId: string, targetContractIds: string[]): Promise<void>;
+    getNodes(): Promise<FerretNode[]>;
+    getNodesByStatus(status: NodeStatus): Promise<FerretNode[]>;
+    getContracts(): Promise<FerretContract[]>;
+    getContract(id: string): Promise<FerretContract | null>;
+    getDependencies(): Promise<FerretDependency[]>;
+    updateNodeStatus(nodeId: string, status: NodeStatus): Promise<void>;
+    insertReconciliationLog(log: FerretReconciliationLog): Promise<void>;
+    getReconciliationLogs(): Promise<FerretReconciliationLog[]>;
+    insertPlacementDecision(decision: FerretPlacementDecision): Promise<void>;
+    getPlacementDecisions(): Promise<FerretPlacementDecision[]>;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/store/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/store/sqlite.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAY,YAAW,OAAO;IACzC,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAS;gBAEX,UAAU,CAAC,EAAE,MAAM;IAWzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyErB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAO/D,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMtC,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvD,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7D,gCAAgC,CACpC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;IAsBV,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAMjC,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAM3D,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAMzC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAOvD,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAM9C,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE,uBAAuB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAepE,qBAAqB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAM3D,uBAAuB,CAC3B,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC;IAcV,qBAAqB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAKlE"}

package/dist/store/sqlite.js

@@ -0,0 +1,180 @@
+import { Database } from "bun:sqlite";
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { randomUUID } from "node:crypto";
+import { findProjectRoot } from "../utils/paths.js";
+export class SqliteStore {
+    db = null;
+    dbPath;
+    constructor(customPath) {
+        const root = findProjectRoot();
+        const defaultPath = path.join(root, ".ferret", "graph.db");
+        this.dbPath =
+            customPath === ":memory:"
+                ? ":memory:"
+                : customPath
+                    ? path.resolve(root, customPath)
+                    : defaultPath;
+    }
+    async init() {
+        if (this.db)
+            return;
+        if (this.dbPath !== ":memory:") {
+            const ferretDir = path.dirname(this.dbPath);
+            if (!fs.existsSync(ferretDir)) {
+                fs.mkdirSync(ferretDir, { recursive: true });
+            }
+            const gitignorePath = path.join(ferretDir, ".gitignore");
+            try {
+                fs.writeFileSync(gitignorePath, "*\n!.gitignore\n!context.json\n", "utf-8");
+            }
+            catch { }
+        }
+        this.db = new Database(this.dbPath);
+        this.db.exec("PRAGMA journal_mode = WAL;");
+        this.db.exec("PRAGMA foreign_keys = ON;");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ferret_nodes (
+        id TEXT PRIMARY KEY,
+        file_path TEXT NOT NULL,
+        hash TEXT NOT NULL,
+        status TEXT NOT NULL,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE TABLE IF NOT EXISTS ferret_contracts (
+        id TEXT PRIMARY KEY,
+        node_id TEXT NOT NULL,
+        shape_hash TEXT NOT NULL,
+        shape_schema TEXT NOT NULL DEFAULT '{}',
+        type TEXT NOT NULL,
+        status TEXT NOT NULL,
+        FOREIGN KEY (node_id) REFERENCES ferret_nodes(id)
+      );
+
+      CREATE TABLE IF NOT EXISTS ferret_dependencies (
+        id TEXT PRIMARY KEY,
+        source_node_id TEXT NOT NULL,
+        target_contract_id TEXT NOT NULL,
+        FOREIGN KEY (source_node_id) REFERENCES ferret_nodes(id)
+      );
+
+      CREATE TABLE IF NOT EXISTS ferret_reconciliation_log (
+        id TEXT PRIMARY KEY,
+        node_id TEXT NOT NULL,
+        triggered_by TEXT NOT NULL,
+        resolved_by TEXT,
+        resolution_notes TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE TABLE IF NOT EXISTS ferret_placement_decisions (
+        id TEXT PRIMARY KEY,
+        node_id TEXT NOT NULL,
+        placed_by TEXT NOT NULL,
+        reasoning TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+    `);
+        try {
+            this.db.exec(`ALTER TABLE ferret_contracts ADD COLUMN shape_schema TEXT NOT NULL DEFAULT '{}';`);
+        }
+        catch { }
+    }
+    async close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    async getNodeByFilePath(filePath) {
+        const row = this.db.prepare("SELECT * FROM ferret_nodes WHERE file_path = ?").get(filePath);
+        return row ?? null;
+    }
+    async upsertNode(node) {
+        this.db.prepare(`
+      INSERT INTO ferret_nodes (id, file_path, hash, status)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        file_path = excluded.file_path,
+        hash = excluded.hash,
+        status = excluded.status,
+        updated_at = CURRENT_TIMESTAMP
+    `).run(node.id, node.file_path, node.hash, node.status);
+    }
+    async getAllContractIds() {
+        return this.db.prepare("SELECT id FROM ferret_contracts").all().map((r) => r.id);
+    }
+    async upsertContract(contract) {
+        this.db.prepare(`
+      INSERT INTO ferret_contracts (id, node_id, shape_hash, shape_schema, type, status)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        node_id = excluded.node_id,
+        shape_hash = excluded.shape_hash,
+        shape_schema = excluded.shape_schema,
+        type = excluded.type,
+        status = excluded.status
+    `).run(contract.id, contract.node_id, contract.shape_hash, contract.shape_schema, contract.type, contract.status);
+    }
+    async upsertDependency(dependency) {
+        this.db.prepare(`
+      INSERT INTO ferret_dependencies (id, source_node_id, target_contract_id)
+      VALUES (?, ?, ?)
+      ON CONFLICT(id) DO NOTHING
+    `).run(dependency.id, dependency.source_node_id, dependency.target_contract_id);
+    }
+    async replaceDependenciesForSourceNode(sourceNodeId, targetContractIds) {
+        const uniqueTargets = [...new Set(targetContractIds)].sort();
+        const deleteStatement = this.db.prepare("DELETE FROM ferret_dependencies WHERE source_node_id = ?");
+        const insertStatement = this.db.prepare(`
+      INSERT INTO ferret_dependencies (id, source_node_id, target_contract_id)
+      VALUES (?, ?, ?)
+    `);
+        const transaction = this.db.transaction((sourceId) => {
+            deleteStatement.run(sourceId);
+            for (const targetId of uniqueTargets) {
+                insertStatement.run(randomUUID(), sourceId, targetId);
+            }
+        });
+        transaction(sourceNodeId);
+    }
+    async getNodes() {
+        return this.db.prepare("SELECT * FROM ferret_nodes").all();
+    }
+    async getNodesByStatus(status) {
+        return this.db.prepare("SELECT * FROM ferret_nodes WHERE status = ?").all(status);
+    }
+    async getContracts() {
+        return this.db.prepare("SELECT * FROM ferret_contracts").all();
+    }
+    async getContract(id) {
+        const row = this.db.prepare("SELECT * FROM ferret_contracts WHERE id = ?").get(id);
+        return row ?? null;
+    }
+    async getDependencies() {
+        return this.db.prepare("SELECT * FROM ferret_dependencies").all();
+    }
+    async updateNodeStatus(nodeId, status) {
+        this.db.prepare("UPDATE ferret_nodes SET status = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?").run(status, nodeId);
+    }
+    async insertReconciliationLog(log) {
+        this.db.prepare(`
+      INSERT INTO ferret_reconciliation_log (id, node_id, triggered_by, resolved_by, resolution_notes)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(log.id, log.node_id, log.triggered_by, log.resolved_by ?? null, log.resolution_notes ?? null);
+    }
+    async getReconciliationLogs() {
+        return this.db.prepare("SELECT id, node_id, triggered_by, resolved_by, resolution_notes FROM ferret_reconciliation_log").all();
+    }
+    async insertPlacementDecision(decision) {
+        this.db.prepare(`
+      INSERT INTO ferret_placement_decisions (id, node_id, placed_by, reasoning)
+      VALUES (?, ?, ?, ?)
+    `).run(decision.id, decision.node_id, decision.placed_by, decision.reasoning ?? null);
+    }
+    async getPlacementDecisions() {
+        return this.db.prepare("SELECT id, node_id, placed_by, reasoning FROM ferret_placement_decisions").all();
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/store/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/store/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,OAAO,WAAW;IACd,EAAE,GAAoB,IAAI,CAAC;IAC3B,MAAM,CAAS;IAEvB,YAAY,UAAmB;QAC7B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM;YACT,UAAU,KAAK,UAAU;gBACvB,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,UAAU;oBACV,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;oBAChC,CAAC,CAAC,WAAW,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO;QAEpB,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YACzD,IAAI,CAAC;gBACH,EAAE,CAAC,aAAa,CACd,aAAa,EACb,iCAAiC,EACjC,OAAO,CACR,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC3C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAE1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0CZ,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,IAAI,CACV,kFAAkF,CACnF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAG,CAAC,OAAO,CAC1B,gDAAgD,CACjD,CAAC,GAAG,CAAC,QAAQ,CAAQ,CAAC;QACvB,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAgB;QAC/B,IAAI,CAAC,EAAG,CAAC,OAAO,CACd;;;;;;;;KAQD,CACA,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OACE,IAAI,CAAC,EAAG,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EACxD,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAwB;QAC3C,IAAI,CAAC,EAAG,CAAC,OAAO,CACd;;;;;;;;;KASD,CACA,CAAC,GAAG,CACH,QAAQ,CAAC,EAAE,EACX,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,YAAY,EACrB,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAA4B;QACjD,IAAI,CAAC,EAAG,CAAC,OAAO,CACd;;;;KAID,CACA,CAAC,GAAG,CACH,UAAU,CAAC,EAAE,EACb,UAAU,CAAC,cAAc,EACzB,UAAU,CAAC,kBAAkB,CAC9B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gCAAgC,CACpC,YAAoB,EACpB,iBAA2B;QAE3B,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,MAAM,eAAe,GAAG,IAAI,CAAC,EAAG,CAAC,OAAO,CACtC,0DAA0D,CAC3D,CAAC;QACF,MAAM,eAAe,GAAG,IAAI,CAAC,EAAG,CAAC,OAAO,CACtC;;;KAGD,CACA,CAAC;QAEF,MAAM,WAAW,GAAG,IAAI,CAAC,EAAG,CAAC,WAAW,CAAC,CAAC,QAAgB,EAAE,EAAE;YAC5D,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9B,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;gBACrC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACxD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,EAAG,CAAC,OAAO,CACrB,4BAA4B,CAC7B,CAAC,GAAG,EAA6B,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAkB;QACvC,OAAO,IAAI,CAAC,EAAG,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,GAAG,CACxE,MAAM,CACoB,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,EAAG,CAAC,OAAO,CACrB,gCAAgC,CACjC,CAAC,GAAG,EAAiC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAG,CAAC,OAAO,CAC1B,6CAA6C,CAC9C,CAAC,GAAG,CAAC,EAAE,CAAQ,CAAC;QACjB,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,EAAG,CAAC,OAAO,CACrB,mCAAmC,CACpC,CAAC,GAAG,EAAmC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,MAAkB;QACvD,IAAI,CAAC,EAAG,CAAC,OAAO,CACd,iFAAiF,CAClF,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,GAA4B;QACxD,IAAI,CAAC,EAAG,CAAC,OAAO,CACd;;;KAGD,CACA,CAAC,GAAG,CACH,GAAG,CAAC,EAAE,EACN,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,WAAW,IAAI,IAAI,EACvB,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAC7B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,OAAO,IAAI,CAAC,EAAG,CAAC,OAAO,CACrB,gGAAgG,CACjG,CAAC,GAAG,EAA0C,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,QAAiC;QAEjC,IAAI,CAAC,EAAG,CAAC,OAAO,CACd;;;KAGD,CACA,CAAC,GAAG,CACH,QAAQ,CAAC,EAAE,EACX,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,SAAS,IAAI,IAAI,CAC3B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,OAAO,IAAI,CAAC,EAAG,CAAC,OAAO,CACrB,0EAA0E,CAC3E,CAAC,GAAG,EAA0C,CAAC;IAClD,CAAC;CACF"}

package/dist/store/types.d.ts

@@ -0,0 +1,79 @@
+export type NodeStatus = "stable" | "needs-review" | "roadmap" | "blocked";
+export type ContractStatus = "stable" | "roadmap" | "needs-review";
+export interface FerretNode {
+    id: string;
+    file_path: string;
+    hash: string;
+    status: NodeStatus;
+    updated_at?: string | Date;
+}
+export interface FerretContract {
+    id: string;
+    node_id: string;
+    shape_hash: string;
+    shape_schema: string;
+    type: string;
+    status: ContractStatus;
+}
+export interface FerretDependency {
+    id: string;
+    source_node_id: string;
+    target_contract_id: string;
+}
+export interface FerretReconciliationLog {
+    id: string;
+    node_id: string;
+    triggered_by: string;
+    resolved_by?: string;
+    resolution_notes?: string;
+}
+export interface FerretPlacementDecision {
+    id: string;
+    node_id: string;
+    placed_by: string;
+    reasoning?: string;
+}
+export interface FerretMigrationSnapshot {
+    nodes: FerretNode[];
+    contracts: FerretContract[];
+    dependencies: FerretDependency[];
+    reconciliationLogs: FerretReconciliationLog[];
+    placementDecisions: FerretPlacementDecision[];
+}
+/**
+ * The standard contract for our Data Access Layer (DAL).
+ * All implementers (SQLite, Postgres) MUST satisfy this completely so the CLI
+ * can remain ignorant to the underlying storage type.
+ */
+export interface DBStore {
+    /** Core initialisation & teardown */
+    init(): Promise<void>;
+    close(): Promise<void>;
+    /** Retrieves a node based on its unique file path relative to specDir */
+    getNodeByFilePath(filePath: string): Promise<FerretNode | null>;
+    /** Upserts a node based on its ID */
+    upsertNode(node: FerretNode): Promise<void>;
+    /** Retrieves all existing contract IDs for LLM context injection */
+    getAllContractIds(): Promise<string[]>;
+    /** Upserts an extracted contract */
+    upsertContract(contract: FerretContract): Promise<void>;
+    /** Creates a dependency edge between a Node and a Contract */
+    upsertDependency(dependency: FerretDependency): Promise<void>;
+    /** Replaces all dependency edges for a source node with the provided targets */
+    replaceDependenciesForSourceNode(sourceNodeId: string, targetContractIds: string[]): Promise<void>;
+    /** Full graph retrieval methods for the Reconciler engine */
+    getNodes(): Promise<FerretNode[]>;
+    getNodesByStatus(status: NodeStatus): Promise<FerretNode[]>;
+    getContracts(): Promise<FerretContract[]>;
+    getContract(id: string): Promise<FerretContract | null>;
+    getDependencies(): Promise<FerretDependency[]>;
+    /** Update helper for the Reconciler to safely flag nodes */
+    updateNodeStatus(nodeId: string, status: NodeStatus): Promise<void>;
+    /** Records review actions against flagged nodes S013 */
+    insertReconciliationLog(log: FerretReconciliationLog): Promise<void>;
+    getReconciliationLogs(): Promise<FerretReconciliationLog[]>;
+    /** Tracks feature placement decisions S016 */
+    insertPlacementDecision(decision: FerretPlacementDecision): Promise<void>;
+    getPlacementDecisions(): Promise<FerretPlacementDecision[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/store/types.d.ts.map

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

package/dist/store/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":""}

package/dist/utils/paths.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Walks up from cwd looking for .ferret/ or ferret.config.json.
+ * Falls back to cwd if neither is found.
+ */
+export declare function findProjectRoot(startDir?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAgBxE"}

package/dist/utils/paths.js

@@ -0,0 +1,21 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Walks up from cwd looking for .ferret/ or ferret.config.json.
+ * Falls back to cwd if neither is found.
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let current = path.resolve(startDir);
+    for (let i = 0; i < 20; i++) {
+        if (fs.existsSync(path.join(current, '.ferret')) ||
+            fs.existsSync(path.join(current, 'ferret.config.json'))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break; // filesystem root
+        current = parent;
+    }
+    return path.resolve(startDir);
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC5C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,EACvD,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM,CAAC,kBAAkB;QACjD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@specferret/core",
+  "version": "0.1.0",
+  "description": "SpecFerret core engine — spec drift detection.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun ../../scripts/clean-dist.ts dist && tsc --project tsconfig.build.json",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "ajv": "^8.12.0",
+    "ajv-formats": "^2.1.1",
+    "glob": "^13.0.6",
+    "gray-matter": "^4.0.3",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.11",
+    "typescript": "^6.0.2"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BenGardiner123/spec-ferret.git"
+  },
+  "homepage": "https://specferret.dev"
+}