@toolbaux/guardian 0.1.22 → 0.2.0

package/dist/db/index.js

@@ -0,0 +1,55 @@
+/**
+ * Public API for the specs store module.
+ *
+ * Usage:
+ *   import { openSpecsStore } from "./db/index.js";
+ *   const store = await openSpecsStore(layout);
+ *   const entry = await store.readSpec("codebase-intelligence");
+ *   await store.close();
+ *
+ * The adapter is chosen automatically:
+ *   - If guardian.db exists in the specs root → SqliteSpecsStore
+ *   - Otherwise → FileSpecsStore (current behavior, fully backward-compatible)
+ *
+ * To force SQLite (e.g. during `guardian extract --backend sqlite`):
+ *   const store = await openSpecsStore(layout, { backend: "sqlite" });
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { FileSpecsStore } from "./file-specs-store.js";
+import { SqliteSpecsStore, DB_FILENAME } from "./sqlite-specs-store.js";
+export { FileSpecsStore } from "./file-specs-store.js";
+export { SqliteSpecsStore, DB_FILENAME } from "./sqlite-specs-store.js";
+/**
+ * Open the appropriate SpecsStore for the given output layout.
+ * Always calls store.init() before returning.
+ *
+ * backend "auto" (default): use SQLite if guardian.db exists, else file
+ * backend "sqlite":         require SQLite (caller must handle missing db)
+ * backend "file":           always use file store
+ */
+export async function openSpecsStore(layout, options = {}) {
+    // "auto" and undefined both probe for guardian.db
+    const requested = options.backend ?? "auto";
+    const resolved = requested === "auto" || requested === undefined
+        ? await detectBackend(layout.rootDir)
+        : requested;
+    let store;
+    if (resolved === "sqlite") {
+        store = new SqliteSpecsStore(layout.rootDir);
+    }
+    else {
+        store = new FileSpecsStore(layout.machineDir, layout.humanDir);
+    }
+    await store.init();
+    return store;
+}
+async function detectBackend(rootDir) {
+    try {
+        await fs.stat(path.join(rootDir, DB_FILENAME));
+        return "sqlite";
+    }
+    catch {
+        return "file";
+    }
+}

package/dist/db/specs-store.js

@@ -0,0 +1,13 @@
+/**
+ * SpecsStore — IO adapter interface for guardian spec files.
+ *
+ * All reads and writes of .specs content flow through this interface.
+ * Two implementations exist:
+ *   - FileSpecsStore  (default today) — reads/writes individual files on disk
+ *   - SqliteSpecsStore               — reads/writes a single guardian.db
+ *
+ * Callers never reference the filesystem or SQLite directly; they use
+ * this interface. Switching storage backends requires zero changes outside
+ * this module.
+ */
+export {};