@esneiderbravo/speclaw 0.1.5 → 0.1.7

package/dist/cli/commands/init.js

@@ -8,6 +8,7 @@ import { AGENTS, agentById } from "../../shared/agents.js";
 import { loadPacks } from "../../modules/tools/packs.js";
 import { list } from "../lib/args.js";
 import { ui, c, banner, renderProgress, clearProgress } from "../lib/ui.js";
+import { checkForUpdates } from "../lib/update-check.js";
 const PACK_LABELS = {
     agents: "dev-agents (backend · frontend · product)",
 };
@@ -36,6 +37,15 @@ export async function runInit(flags) {
     let agents;
     let packs;
     banner();
+    // Scaffolding with a stale version writes yesterday's foundation, so recommend
+    // upgrading first — prominently, before any prompts, so there's time to cancel.
+    // Best-effort and cache-backed (no added latency); the command still proceeds.
+    const upd = await checkForUpdates();
+    if (upd.updateAvailable && upd.latest) {
+        ui.warn(`You're on ${c.muted(upd.current)} — latest is ${c.bold(c.cyan(upd.latest))}.`);
+        ui.info(`Recommended: run ${ui.code("speclaw update")} first, then ${ui.code("speclaw init")} again.`);
+        ui.plain();
+    }
     if (interactive) {
         const answers = await clack.group({
             agents: () => clack.multiselect({

package/dist/cli/lib/update-check.js

@@ -105,7 +105,9 @@ export async function maybeNotifyUpdate(cmd) {
             return;
         if (!process.stderr.isTTY)
             return;
-        if (!cmd || ["mcp", "update", "help", "--help", "-h"].includes(cmd))
+        // `init` shows its own prominent up-front warning and ends on the clean
+        // copy-paste prompt — don't append a second notice after it.
+        if (!cmd || ["mcp", "update", "init", "help", "--help", "-h"].includes(cmd))
             return;
         const { current, latest, updateAvailable } = await checkForUpdates();
         if (!updateAvailable || !latest)

package/dist/modules/compass/db.js

@@ -49,13 +49,53 @@ CREATE TABLE IF NOT EXISTS node_embeddings (
 );
 `;
 /** Schema version stamped into the `meta` table on first creation. */
-export const SCHEMA_VERSION = "2";
+export const SCHEMA_VERSION = "3";
+/** The stamped schema version, or null if the db predates versioning / has no meta table. */
+function readSchemaVersion(db) {
+    try {
+        const row = db.prepare("SELECT value FROM meta WHERE key = 'schema_version'").get();
+        return row ? String(row.value) : null;
+    }
+    catch {
+        return null; // meta table doesn't exist yet
+    }
+}
+/**
+ * Decide whether an existing database is from an incompatible schema and must be
+ * rebuilt. A fresh database (no tables) needs no reset — the schema will create
+ * them. An existing one is stale if its stamped version differs from the current
+ * one, or if the `edges` table is missing a column the current code writes to
+ * (guards against past schema changes that weren't version-bumped).
+ */
+function isStale(db) {
+    const hasEdges = db
+        .prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'edges'")
+        .get();
+    if (!hasEdges)
+        return false;
+    if (readSchemaVersion(db) !== SCHEMA_VERSION)
+        return true;
+    const cols = db.prepare("PRAGMA table_info(edges)").all().map((c) => c.name);
+    return !cols.includes("src_node_id") || !cols.includes("dst_node_id");
+}
+/** Drop every table (children first) so the current schema can be recreated cleanly. */
+function resetSchema(db) {
+    db.exec(`
+    DROP TABLE IF EXISTS node_embeddings;
+    DROP TABLE IF EXISTS edges;
+    DROP TABLE IF EXISTS nodes;
+    DROP TABLE IF EXISTS files;
+    DROP TABLE IF EXISTS meta;
+  `);
+}
 /**
  * Open (creating if needed) the index database at `<projectPath>/.speclaw/index.db`.
  *
- * Ensures the `.speclaw` directory exists, applies the schema (idempotently),
- * enables WAL journaling and foreign keys, and stamps the schema version on a
- * fresh database.
+ * Ensures the `.speclaw` directory exists, enables WAL journaling and foreign
+ * keys, and applies the schema. If an existing database is from an incompatible
+ * schema (e.g. after a speclaw upgrade), it is dropped and rebuilt — `.speclaw`
+ * is fully regenerable, so the next index just repopulates it. The schema
+ * version is stamped on a fresh (or freshly reset) database.
  *
  * @param projectPath - Absolute path to the project root.
  * @returns An open connection to the index database.
@@ -65,6 +105,8 @@ export function openDb(projectPath) {
     fs.mkdirSync(dir, { recursive: true });
     const db = new DatabaseSync(path.join(dir, "index.db"));
     db.exec("PRAGMA journal_mode = WAL; PRAGMA foreign_keys = ON;");
+    if (isStale(db))
+        resetSchema(db);
     db.exec(SCHEMA);
     const row = db
         .prepare("SELECT value FROM meta WHERE key = 'schema_version'")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esneiderbravo/speclaw",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "publishConfig": {
     "access": "public"
   },