@davesheffer/hunch 0.40.0 → 1.0.0

package/README.md

@@ -4,7 +4,7 @@
 [![npm version](https://img.shields.io/npm/v/@davesheffer/hunch?color=2742ff&label=npm)](https://www.npmjs.com/package/@davesheffer/hunch)
 [![npm downloads](https://img.shields.io/npm/dw/@davesheffer/hunch?color=2742ff)](https://www.npmjs.com/package/@davesheffer/hunch)
 [![license](https://img.shields.io/npm/l/@davesheffer/hunch?color=2742ff)](LICENSE)
-[![node](https://img.shields.io/badge/node-%E2%89%A520-2742ff)](https://nodejs.org)
+[![node](https://img.shields.io/badge/node-%E2%89%A522.13-2742ff)](https://nodejs.org)
 [![MCP](https://img.shields.io/badge/MCP-native-2742ff)](https://modelcontextprotocol.io)
 
 > **A linter checks whether code matches a *pattern*. Hunch checks whether code still matches your *architecture*** —
@@ -140,7 +140,7 @@ unchanged.
 ## Getting started
 
 ```bash
-npm install -g @davesheffer/hunch   # Node ≥ 20; puts `hunch` on your PATH
+npm install -g @davesheffer/hunch   # Node ≥ 22.13; puts `hunch` on your PATH
 cd your-repo
 hunch init                          # scaffold .hunch/, index, install hooks, wire up assistants
 hunch backfill --since 90d          # cold start: seed decisions from recent git history
@@ -320,5 +320,5 @@ memory. → [the docs](https://hunch-pi.vercel.app/docs) for the conceptual mode
 
 ## Develop
 
-Hunch is open source — pure TypeScript ESM, Node ≥ 20, licensed **Apache-2.0**. Contributions
+Hunch is open source — pure TypeScript ESM, Node ≥ 22.13, licensed **Apache-2.0**. Contributions
 welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) and the [repo](https://github.com/davesheffer/hunch).

package/dist/store/db.js

@@ -1,19 +1,57 @@
-/** Thin wrapper around better-sqlite3 for the derived index. */
-import Database from "better-sqlite3";
+/** Thin wrapper around node:sqlite for the derived index. */
+import { createRequire } from "node:module";
 import { mkdirSync } from "node:fs";
 import { dirname } from "node:path";
 import { SCHEMA_SQL } from "./schema.js";
+/** Load node:sqlite while swallowing ONLY its ExperimentalWarning (Node 22–24 still
+ *  emits it on module load). Hunch's stderr reaches humans, hooks, and MCP clients on
+ *  every invocation, so the noise would land everywhere; all other warnings pass through. */
+function loadSqlite() {
+    const require = createRequire(import.meta.url);
+    const realEmit = process.emitWarning.bind(process);
+    process.emitWarning = ((warning, ...rest) => {
+        if (String(warning).includes("SQLite is an experimental feature"))
+            return;
+        realEmit(warning, ...rest);
+    });
+    try {
+        return require("node:sqlite");
+    }
+    finally {
+        process.emitWarning = realEmit;
+    }
+}
+const sqlite = loadSqlite();
 export function openDb(sqlitePath) {
     mkdirSync(dirname(sqlitePath), { recursive: true });
-    const db = new Database(sqlitePath);
-    db.pragma("busy_timeout = 5000");
+    const db = new sqlite.DatabaseSync(sqlitePath);
+    db.exec("PRAGMA busy_timeout = 5000");
     db.exec(SCHEMA_SQL);
     return db;
 }
 /** In-memory db (tests / ephemeral queries). */
 export function openMemoryDb() {
-    const db = new Database(":memory:");
+    const db = new sqlite.DatabaseSync(":memory:");
     db.exec(SCHEMA_SQL);
     return db;
 }
+/** Run `fn` inside one transaction: BEGIN → fn → COMMIT, ROLLBACK on throw.
+ *  (node:sqlite has no better-sqlite3-style transaction() helper.) */
+export function withTx(db, fn) {
+    db.exec("BEGIN");
+    try {
+        const out = fn();
+        db.exec("COMMIT");
+        return out;
+    }
+    catch (err) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            /* connection already rolled back */
+        }
+        throw err;
+    }
+}
 //# sourceMappingURL=db.js.map

package/dist/store/hunchStore.js

@@ -14,7 +14,7 @@ import { resolve, join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { toPosixTarget, hunchPathsForDir } from "../core/paths.js";
 import { ENTITY_KINDS } from "../core/types.js";
-import { openDb } from "./db.js";
+import { openDb, withTx } from "./db.js";
 import { RESET_SQL, embedHash } from "./schema.js";
 import { selectEmbedder } from "./embedder.js";
 import { JsonStore } from "./jsonStore.js";
@@ -188,7 +188,7 @@ export class HunchStore {
     reindex() {
         const db = this.db;
         const counts = {};
-        const tx = db.transaction(() => {
+        withTx(db, () => {
             db.exec(RESET_SQL);
             const j = (s) => s; // readability marker for JSON-encoded columns
             // Prepare the FTS insert ONCE (after RESET created the table), not per row.
@@ -263,7 +263,6 @@ export class HunchStore {
             counts.runbooks = runbooks.length;
             void j;
         });
-        tx();
         // Reconcile embeddings AFTER the FTS rebuild (model-free): drop vectors whose
         // source doc vanished or whose text changed. Embeddings are NOT in RESET_SQL,
         // so this is what keeps them coherent across the many reindex() call sites.
@@ -317,14 +316,13 @@ export class HunchStore {
         const rows = this.db.prepare(`SELECT ref, doc_hash FROM embeddings`).all();
         const del = this.db.prepare(`DELETE FROM embeddings WHERE ref = ?`);
         let pruned = 0;
-        const tx = this.db.transaction(() => {
+        withTx(this.db, () => {
             for (const r of rows)
                 if (live.get(r.ref) !== r.doc_hash) {
                     del.run(r.ref);
                     pruned++;
                 }
         });
-        tx();
         return pruned;
     }
     /** Embedding coverage for a model: up-to-date vectors vs total docs (doctor). */
@@ -357,7 +355,7 @@ export class HunchStore {
         for (let i = 0; i < todo.length; i += batchSize) {
             const slice = todo.slice(i, i + batchSize);
             const vecs = await embedder.embed(slice.map((d) => `${d.title}\n${d.body}`));
-            const tx = this.db.transaction(() => {
+            withTx(this.db, () => {
                 slice.forEach((d, j) => {
                     const v = vecs[j];
                     if (v) {
@@ -366,7 +364,6 @@ export class HunchStore {
                     }
                 });
             });
-            tx();
             attempted += slice.length;
             opts.onProgress?.(attempted, todo.length);
         }
@@ -1167,7 +1164,7 @@ function numEnv(name, dflt) {
 }
 /** Pack a vector's exact bytes for SQLite. Explicit offset+length so a SUBARRAY
  *  view (byteOffset != 0) writes only its slice, not the whole backing buffer.
- *  better-sqlite3 copies on bind, so the returned view never aliases the row. */
+ *  node:sqlite copies on bind, so the returned view never aliases the row. */
 function vecToBlob(v) {
     return Buffer.from(v.buffer, v.byteOffset, v.byteLength);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davesheffer/hunch",
-  "version": "0.40.0",
+  "version": "1.0.0",
   "license": "Apache-2.0",
   "author": "Dave Sheffer <dave.sheffer1@gmail.com>",
   "description": "Architectural Conformance for AI-generated code: a git-native graph that deterministically blocks AI changes which break your architecture — the semantic invariants (layering, must-reach, dependency direction) pattern-SAST can't express — grounded in the decisions and bugs behind each rule, across any MCP assistant (Claude Code, Cursor, Copilot, Windsurf, Codex).",
@@ -35,7 +35,7 @@
     "developer-tools"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.13.0"
   },
   "scripts": {
     "clean": "node --input-type=commonjs -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
@@ -48,15 +48,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "better-sqlite3": "12.9.0",
     "commander": "^15.0.0",
     "tree-sitter": "0.21.1",
     "tree-sitter-typescript": "^0.23.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^20.19.0",
+    "@types/node": "^22.13.0",
     "tsx": "^4.22.4",
     "typescript": "^5.9.3"
   },