@letsrunit/store 0.7.0 → 0.8.0

package/README.md

@@ -0,0 +1,58 @@
+![letsrunit](https://cdn.jsdelivr.net/gh/letsrunit-hq/letsrunit@main/docs/.gitbook/assets/logo-light.svg)
+
+# Store
+
+## Installation
+
+```bash
+npm install @letsrunit/store
+# or
+yarn add @letsrunit/store
+```
+
+SQLite-backed persistence layer for letsrunit run history and artifacts. It manages the database schema and provides write functions for recording test sessions, features, scenarios, steps, runs, and file artifacts.
+
+## Schema
+
+The store maintains six tables:
+
+| Table | Purpose |
+|---|---|
+| `sessions` | One row per test run invocation, keyed by UUID with optional git commit |
+| `features` | Gherkin feature files, keyed by a content hash of the file |
+| `scenarios` | Gherkin scenarios, linked to their feature |
+| `steps` | Individual steps within a scenario, ordered by index |
+| `runs` | One row per scenario execution within a session; status is `running`, `passed`, or `failed` |
+| `artifacts` | Files (screenshots, HTML snapshots) produced during a step |
+
+## API
+
+### `openStore(path?)`
+
+Opens (or creates) the SQLite database at the given path. Defaults to `.letsrunit/letsrunit.db`. Enables WAL mode and foreign key enforcement, and runs the schema migration.
+
+```ts
+import { openStore } from '@letsrunit/store';
+
+const db = openStore(); // .letsrunit/letsrunit.db
+```
+
+### Write functions
+
+All write functions take a `db` instance as their first argument.
+
+| Function | Description |
+|---|---|
+| `insertSession(db, id, gitCommit, startedAt)` | Records a new test session |
+| `upsertFeature(db, id, path, name)` | Inserts or replaces a feature file record |
+| `upsertScenario(db, id, featureId, name)` | Inserts or replaces a scenario record |
+| `upsertStep(db, id, scenarioId, idx, text)` | Inserts or replaces a step record |
+| `insertRun(db, id, sessionId, scenarioId, startedAt)` | Starts a new run with status `running` |
+| `finaliseRun(db, id, status, failedStepId?, error?)` | Updates a run's final status and optional failure details |
+| `insertArtifact(db, id, runId, stepId, filename)` | Links a saved file to a specific step in a run |
+
+## Testing
+
+```bash
+yarn test --project @letsrunit/store
+```

package/dist/index.d.ts

@@ -1,13 +1,28 @@
-import Database from 'better-sqlite3';
+import nodeWasm from 'node-sqlite3-wasm';
 
-declare function openStore(path?: string): Database.Database;
+type Database = InstanceType<typeof nodeWasm.Database>;
+declare function openStore(path?: string): Database;
 
-declare function insertSession(db: Database.Database, id: string, gitCommit: string | null, startedAt: number): void;
-declare function upsertFeature(db: Database.Database, id: string, path: string, name: string): void;
-declare function upsertScenario(db: Database.Database, id: string, featureId: string, name: string): void;
-declare function upsertStep(db: Database.Database, id: string, scenarioId: string, idx: number, text: string): void;
-declare function insertRun(db: Database.Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void;
-declare function finaliseRun(db: Database.Database, id: string, status: string, failedStepId?: string, error?: string): void;
-declare function insertArtifact(db: Database.Database, id: string, runId: string, stepId: string, filename: string): void;
+declare function insertSession(db: Database, id: string, gitCommit: string | null, startedAt: number): void;
+declare function upsertFeature(db: Database, id: string, path: string, name: string): void;
+declare function upsertScenario(db: Database, id: string, featureId: string, name: string): void;
+declare function upsertStep(db: Database, id: string, scenarioId: string, idx: number, text: string): void;
+declare function insertRun(db: Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void;
+declare function finaliseRun(db: Database, id: string, status: string, failedStepId?: string, error?: string): void;
+declare function insertArtifact(db: Database, id: string, runId: string, stepId: string, filename: string): void;
 
-export { finaliseRun, insertArtifact, insertRun, insertSession, openStore, upsertFeature, upsertScenario, upsertStep };
+declare function computeStepId(normalizedText: string): string;
+declare function computeScenarioId(stepIds: string[]): string;
+declare function computeFeatureId(uri: string): string;
+
+declare function findLastRun(db: Database, scenarioId: string, status?: string, allowedCommits?: string[]): {
+    id: string;
+    gitCommit: string | null;
+} | null;
+declare function findArtifacts(db: Database, runId: string, stepId?: string): Array<{
+    filename: string;
+    stepId: string;
+    stepIdx: number;
+}>;
+
+export { computeFeatureId, computeScenarioId, computeStepId, finaliseRun, findArtifacts, findLastRun, insertArtifact, insertRun, insertSession, openStore, upsertFeature, upsertScenario, upsertStep };

package/dist/index.js

@@ -1,6 +1,8 @@
-import Database from 'better-sqlite3';
+import nodeWasm from 'node-sqlite3-wasm';
+import { v5 } from 'uuid';
 
 // src/db.ts
+var { Database } = nodeWasm;
 var SCHEMA = `
 CREATE TABLE IF NOT EXISTS sessions (
   id          TEXT PRIMARY KEY,
@@ -41,35 +43,87 @@ CREATE TABLE IF NOT EXISTS artifacts (
 `;
 function openStore(path = ".letsrunit/letsrunit.db") {
   const db = new Database(path);
-  db.pragma("journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
+  db.run("PRAGMA journal_mode = WAL");
+  db.run("PRAGMA foreign_keys = ON");
   db.exec(SCHEMA);
   return db;
 }
 
 // src/write.ts
 function insertSession(db, id, gitCommit, startedAt) {
-  db.prepare("INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)").run(id, startedAt, gitCommit);
+  db.run("INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)", [id, startedAt, gitCommit]);
 }
 function upsertFeature(db, id, path, name) {
-  db.prepare("INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)").run(id, path, name);
+  db.run("INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)", [id, path, name]);
 }
 function upsertScenario(db, id, featureId, name) {
-  db.prepare("INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)").run(id, featureId, name);
+  db.run("INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)", [id, featureId, name]);
 }
 function upsertStep(db, id, scenarioId, idx, text) {
-  db.prepare("INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)").run(id, scenarioId, idx, text);
+  db.run("INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)", [id, scenarioId, idx, text]);
 }
 function insertRun(db, id, sessionId, scenarioId, startedAt) {
-  db.prepare("INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)").run(id, sessionId, scenarioId, startedAt);
+  db.run("INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)", [id, sessionId, scenarioId, startedAt]);
 }
 function finaliseRun(db, id, status, failedStepId, error) {
-  db.prepare("UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?").run(status, failedStepId ?? null, error ?? null, id);
+  db.run("UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?", [status, failedStepId ?? null, error ?? null, id]);
 }
 function insertArtifact(db, id, runId, stepId, filename) {
-  db.prepare("INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)").run(id, runId, stepId, filename);
+  db.run("INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)", [id, runId, stepId, filename]);
+}
+var UUID_NAMESPACE = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
+function computeStepId(normalizedText) {
+  return v5(normalizedText, UUID_NAMESPACE);
+}
+function computeScenarioId(stepIds) {
+  return v5(stepIds.join(":"), UUID_NAMESPACE);
+}
+function computeFeatureId(uri) {
+  return v5(uri, UUID_NAMESPACE);
+}
+
+// src/read.ts
+function findLastRun(db, scenarioId, status, allowedCommits) {
+  const conditions = ["r.scenario_id = ?"];
+  const params = [scenarioId];
+  if (status !== void 0) {
+    conditions.push("r.status = ?");
+    params.push(status);
+  }
+  if (allowedCommits !== void 0) {
+    conditions.push("s.git_commit IN (SELECT value FROM json_each(?))");
+    params.push(JSON.stringify(allowedCommits));
+  }
+  const sql = `
+    SELECT r.id, s.git_commit
+    FROM runs r
+    JOIN sessions s ON r.session_id = s.id
+    WHERE ${conditions.join(" AND ")}
+    ORDER BY r.started_at DESC
+    LIMIT 1
+  `;
+  const row = db.get(sql, params);
+  if (!row) return null;
+  return { id: row.id, gitCommit: row.git_commit };
+}
+function findArtifacts(db, runId, stepId) {
+  const conditions = ["a.run_id = ?"];
+  const params = [runId];
+  if (stepId !== void 0) {
+    conditions.push("a.step_id = ?");
+    params.push(stepId);
+  }
+  const sql = `
+    SELECT a.filename, a.step_id, st.idx
+    FROM artifacts a
+    JOIN steps st ON a.step_id = st.id
+    WHERE ${conditions.join(" AND ")}
+    ORDER BY st.idx ASC
+  `;
+  const rows = db.all(sql, params);
+  return rows.map((r) => ({ filename: r.filename, stepId: r.step_id, stepIdx: r.idx }));
 }
 
-export { finaliseRun, insertArtifact, insertRun, insertSession, openStore, upsertFeature, upsertScenario, upsertStep };
+export { computeFeatureId, computeScenarioId, computeStepId, finaliseRun, findArtifacts, findLastRun, insertArtifact, insertRun, insertSession, openStore, upsertFeature, upsertScenario, upsertStep };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/db.ts","../src/write.ts"],"names":[],"mappings":";;;AAEA,IAAM,MAAA,GAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAuCR,SAAS,SAAA,CAAU,OAAO,yBAAA,EAA8C;AAC7E,EAAA,MAAM,EAAA,GAAK,IAAI,QAAA,CAAS,IAAI,CAAA;AAC5B,EAAA,EAAA,CAAG,OAAO,oBAAoB,CAAA;AAC9B,EAAA,EAAA,CAAG,OAAO,mBAAmB,CAAA;AAC7B,EAAA,EAAA,CAAG,KAAK,MAAM,CAAA;AACd,EAAA,OAAO,EAAA;AACT;;;AC7CO,SAAS,aAAA,CAAc,EAAA,EAAuB,EAAA,EAAY,SAAA,EAA0B,SAAA,EAAyB;AAClH,EAAA,EAAA,CAAG,QAAQ,8EAA8E,CAAA,CAAE,GAAA,CAAI,EAAA,EAAI,WAAW,SAAS,CAAA;AACzH;AAEO,SAAS,aAAA,CAAc,EAAA,EAAuB,EAAA,EAAY,IAAA,EAAc,IAAA,EAAoB;AACjG,EAAA,EAAA,CAAG,QAAQ,mEAAmE,CAAA,CAAE,GAAA,CAAI,EAAA,EAAI,MAAM,IAAI,CAAA;AACpG;AAEO,SAAS,cAAA,CAAe,EAAA,EAAuB,EAAA,EAAY,SAAA,EAAmB,IAAA,EAAoB;AACvG,EAAA,EAAA,CAAG,QAAQ,0EAA0E,CAAA,CAAE,GAAA,CAAI,EAAA,EAAI,WAAW,IAAI,CAAA;AAChH;AAEO,SAAS,UAAA,CAAW,EAAA,EAAuB,EAAA,EAAY,UAAA,EAAoB,KAAa,IAAA,EAAoB;AACjH,EAAA,EAAA,CAAG,QAAQ,+EAA+E,CAAA,CAAE,IAAI,EAAA,EAAI,UAAA,EAAY,KAAK,IAAI,CAAA;AAC3H;AAEO,SAAS,SAAA,CAAU,EAAA,EAAuB,EAAA,EAAY,SAAA,EAAmB,YAAoB,SAAA,EAAyB;AAC3H,EAAA,EAAA,CAAG,QAAQ,gFAAgF,CAAA,CAAE,IAAI,EAAA,EAAI,SAAA,EAAW,YAAY,SAAS,CAAA;AACvI;AAEO,SAAS,WAAA,CAAY,EAAA,EAAuB,EAAA,EAAY,MAAA,EAAgB,cAAuB,KAAA,EAAsB;AAC1H,EAAA,EAAA,CAAG,OAAA,CAAQ,wEAAwE,CAAA,CAAE,GAAA,CAAI,QAAQ,YAAA,IAAgB,IAAA,EAAM,KAAA,IAAS,IAAA,EAAM,EAAE,CAAA;AAC1I;AAEO,SAAS,cAAA,CAAe,EAAA,EAAuB,EAAA,EAAY,KAAA,EAAe,QAAgB,QAAA,EAAwB;AACvH,EAAA,EAAA,CAAG,QAAQ,2EAA2E,CAAA,CAAE,IAAI,EAAA,EAAI,KAAA,EAAO,QAAQ,QAAQ,CAAA;AACzH","file":"index.js","sourcesContent":["import Database from 'better-sqlite3';\n\nconst SCHEMA = `\nCREATE TABLE IF NOT EXISTS sessions (\n  id          TEXT PRIMARY KEY,\n  started_at  INTEGER NOT NULL,\n  git_commit  TEXT\n);\nCREATE TABLE IF NOT EXISTS features (\n  id    TEXT PRIMARY KEY,\n  path  TEXT NOT NULL,\n  name  TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS scenarios (\n  id          TEXT PRIMARY KEY,\n  feature_id  TEXT NOT NULL REFERENCES features(id),\n  name        TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS steps (\n  id          TEXT PRIMARY KEY,\n  scenario_id TEXT NOT NULL REFERENCES scenarios(id),\n  idx         INTEGER NOT NULL,\n  text        TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS runs (\n  id              TEXT PRIMARY KEY,\n  session_id      TEXT NOT NULL REFERENCES sessions(id),\n  scenario_id     TEXT NOT NULL REFERENCES scenarios(id),\n  status          TEXT NOT NULL DEFAULT 'running',\n  failed_step_id  TEXT REFERENCES steps(id),\n  error           TEXT,\n  started_at      INTEGER NOT NULL\n);\nCREATE TABLE IF NOT EXISTS artifacts (\n  id        TEXT PRIMARY KEY,\n  run_id    TEXT NOT NULL REFERENCES runs(id),\n  step_id   TEXT NOT NULL REFERENCES steps(id),\n  filename  TEXT NOT NULL\n);\n`;\n\nexport function openStore(path = '.letsrunit/letsrunit.db'): Database.Database {\n  const db = new Database(path);\n  db.pragma('journal_mode = WAL');\n  db.pragma('foreign_keys = ON');\n  db.exec(SCHEMA);\n  return db;\n}\n","import type Database from 'better-sqlite3';\n\nexport function insertSession(db: Database.Database, id: string, gitCommit: string | null, startedAt: number): void {\n  db.prepare('INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)').run(id, startedAt, gitCommit);\n}\n\nexport function upsertFeature(db: Database.Database, id: string, path: string, name: string): void {\n  db.prepare('INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)').run(id, path, name);\n}\n\nexport function upsertScenario(db: Database.Database, id: string, featureId: string, name: string): void {\n  db.prepare('INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)').run(id, featureId, name);\n}\n\nexport function upsertStep(db: Database.Database, id: string, scenarioId: string, idx: number, text: string): void {\n  db.prepare('INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)').run(id, scenarioId, idx, text);\n}\n\nexport function insertRun(db: Database.Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void {\n  db.prepare('INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)').run(id, sessionId, scenarioId, startedAt);\n}\n\nexport function finaliseRun(db: Database.Database, id: string, status: string, failedStepId?: string, error?: string): void {\n  db.prepare('UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?').run(status, failedStepId ?? null, error ?? null, id);\n}\n\nexport function insertArtifact(db: Database.Database, id: string, runId: string, stepId: string, filename: string): void {\n  db.prepare('INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)').run(id, runId, stepId, filename);\n}\n"]}
+{"version":3,"sources":["../src/db.ts","../src/write.ts","../src/ids.ts","../src/read.ts"],"names":["uuidv5"],"mappings":"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","file":"index.js","sourcesContent":["import nodeWasm from 'node-sqlite3-wasm';\nconst { Database } = nodeWasm;\nexport type Database = InstanceType<typeof nodeWasm.Database>;\n\nconst SCHEMA = `\nCREATE TABLE IF NOT EXISTS sessions (\n  id          TEXT PRIMARY KEY,\n  started_at  INTEGER NOT NULL,\n  git_commit  TEXT\n);\nCREATE TABLE IF NOT EXISTS features (\n  id    TEXT PRIMARY KEY,\n  path  TEXT NOT NULL,\n  name  TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS scenarios (\n  id          TEXT PRIMARY KEY,\n  feature_id  TEXT NOT NULL REFERENCES features(id),\n  name        TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS steps (\n  id          TEXT PRIMARY KEY,\n  scenario_id TEXT NOT NULL REFERENCES scenarios(id),\n  idx         INTEGER NOT NULL,\n  text        TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS runs (\n  id              TEXT PRIMARY KEY,\n  session_id      TEXT NOT NULL REFERENCES sessions(id),\n  scenario_id     TEXT NOT NULL REFERENCES scenarios(id),\n  status          TEXT NOT NULL DEFAULT 'running',\n  failed_step_id  TEXT REFERENCES steps(id),\n  error           TEXT,\n  started_at      INTEGER NOT NULL\n);\nCREATE TABLE IF NOT EXISTS artifacts (\n  id        TEXT PRIMARY KEY,\n  run_id    TEXT NOT NULL REFERENCES runs(id),\n  step_id   TEXT NOT NULL REFERENCES steps(id),\n  filename  TEXT NOT NULL\n);\n`;\n\nexport function openStore(path = '.letsrunit/letsrunit.db'): Database {\n  const db = new Database(path);\n  db.run('PRAGMA journal_mode = WAL');\n  db.run('PRAGMA foreign_keys = ON');\n  db.exec(SCHEMA);\n  return db;\n}\n","import type { Database } from './db';\n\nexport function insertSession(db: Database, id: string, gitCommit: string | null, startedAt: number): void {\n  db.run('INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)', [id, startedAt, gitCommit]);\n}\n\nexport function upsertFeature(db: Database, id: string, path: string, name: string): void {\n  db.run('INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)', [id, path, name]);\n}\n\nexport function upsertScenario(db: Database, id: string, featureId: string, name: string): void {\n  db.run('INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)', [id, featureId, name]);\n}\n\nexport function upsertStep(db: Database, id: string, scenarioId: string, idx: number, text: string): void {\n  db.run('INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)', [id, scenarioId, idx, text]);\n}\n\nexport function insertRun(db: Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void {\n  db.run('INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)', [id, sessionId, scenarioId, startedAt]);\n}\n\nexport function finaliseRun(db: Database, id: string, status: string, failedStepId?: string, error?: string): void {\n  db.run('UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?', [status, failedStepId ?? null, error ?? null, id]);\n}\n\nexport function insertArtifact(db: Database, id: string, runId: string, stepId: string, filename: string): void {\n  db.run('INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)', [id, runId, stepId, filename]);\n}\n","import { v5 as uuidv5 } from 'uuid';\n\nconst UUID_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';\n\nexport function computeStepId(normalizedText: string): string {\n  return uuidv5(normalizedText, UUID_NAMESPACE);\n}\n\nexport function computeScenarioId(stepIds: string[]): string {\n  return uuidv5(stepIds.join(':'), UUID_NAMESPACE);\n}\n\nexport function computeFeatureId(uri: string): string {\n  return uuidv5(uri, UUID_NAMESPACE);\n}\n","import type { Database } from './db';\n\nexport function findLastRun(\n  db: Database,\n  scenarioId: string,\n  status?: string,\n  allowedCommits?: string[],\n): { id: string; gitCommit: string | null } | null {\n  const conditions: string[] = ['r.scenario_id = ?'];\n  const params: (string | number | null)[] = [scenarioId];\n\n  if (status !== undefined) {\n    conditions.push('r.status = ?');\n    params.push(status);\n  }\n\n  if (allowedCommits !== undefined) {\n    conditions.push('s.git_commit IN (SELECT value FROM json_each(?))');\n    params.push(JSON.stringify(allowedCommits));\n  }\n\n  const sql = `\n    SELECT r.id, s.git_commit\n    FROM runs r\n    JOIN sessions s ON r.session_id = s.id\n    WHERE ${conditions.join(' AND ')}\n    ORDER BY r.started_at DESC\n    LIMIT 1\n  `;\n\n  const row = db.get(sql, params) as { id: string; git_commit: string | null } | undefined;\n  if (!row) return null;\n  return { id: row.id, gitCommit: row.git_commit };\n}\n\nexport function findArtifacts(\n  db: Database,\n  runId: string,\n  stepId?: string,\n): Array<{ filename: string; stepId: string; stepIdx: number }> {\n  const conditions: string[] = ['a.run_id = ?'];\n  const params: (string | number | null)[] = [runId];\n\n  if (stepId !== undefined) {\n    conditions.push('a.step_id = ?');\n    params.push(stepId);\n  }\n\n  const sql = `\n    SELECT a.filename, a.step_id, st.idx\n    FROM artifacts a\n    JOIN steps st ON a.step_id = st.id\n    WHERE ${conditions.join(' AND ')}\n    ORDER BY st.idx ASC\n  `;\n\n  const rows = db.all(sql, params) as Array<{ filename: string; step_id: string; idx: number }>;\n  return rows.map((r) => ({ filename: r.filename, stepId: r.step_id, stepIdx: r.idx }));\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letsrunit/store",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "SQLite-backed artifact store for letsrunit",
   "keywords": [
     "testing",
@@ -51,10 +51,7 @@
   },
   "packageManager": "yarn@4.10.3",
   "dependencies": {
-    "better-sqlite3": "^12.8.0",
+    "node-sqlite3-wasm": "^0.8.55",
     "uuid": "^13.0.0"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13"
   }
 }

package/src/db.ts

@@ -1,4 +1,6 @@
-import Database from 'better-sqlite3';
+import nodeWasm from 'node-sqlite3-wasm';
+const { Database } = nodeWasm;
+export type Database = InstanceType<typeof nodeWasm.Database>;
 
 const SCHEMA = `
 CREATE TABLE IF NOT EXISTS sessions (
@@ -39,10 +41,10 @@ CREATE TABLE IF NOT EXISTS artifacts (
 );
 `;
 
-export function openStore(path = '.letsrunit/letsrunit.db'): Database.Database {
+export function openStore(path = '.letsrunit/letsrunit.db'): Database {
   const db = new Database(path);
-  db.pragma('journal_mode = WAL');
-  db.pragma('foreign_keys = ON');
+  db.run('PRAGMA journal_mode = WAL');
+  db.run('PRAGMA foreign_keys = ON');
   db.exec(SCHEMA);
   return db;
 }

package/src/ids.ts

@@ -0,0 +1,15 @@
+import { v5 as uuidv5 } from 'uuid';
+
+const UUID_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
+
+export function computeStepId(normalizedText: string): string {
+  return uuidv5(normalizedText, UUID_NAMESPACE);
+}
+
+export function computeScenarioId(stepIds: string[]): string {
+  return uuidv5(stepIds.join(':'), UUID_NAMESPACE);
+}
+
+export function computeFeatureId(uri: string): string {
+  return uuidv5(uri, UUID_NAMESPACE);
+}

package/src/index.ts

@@ -1,2 +1,4 @@
 export { openStore } from './db.js';
 export { insertSession, upsertFeature, upsertScenario, upsertStep, insertRun, finaliseRun, insertArtifact } from './write.js';
+export { computeStepId, computeScenarioId, computeFeatureId } from './ids.js';
+export { findLastRun, findArtifacts } from './read.js';

package/src/read.ts

@@ -1,2 +1,59 @@
-// Read queries will be added when CLI/MCP integration is implemented.
-export {};
+import type { Database } from './db';
+
+export function findLastRun(
+  db: Database,
+  scenarioId: string,
+  status?: string,
+  allowedCommits?: string[],
+): { id: string; gitCommit: string | null } | null {
+  const conditions: string[] = ['r.scenario_id = ?'];
+  const params: (string | number | null)[] = [scenarioId];
+
+  if (status !== undefined) {
+    conditions.push('r.status = ?');
+    params.push(status);
+  }
+
+  if (allowedCommits !== undefined) {
+    conditions.push('s.git_commit IN (SELECT value FROM json_each(?))');
+    params.push(JSON.stringify(allowedCommits));
+  }
+
+  const sql = `
+    SELECT r.id, s.git_commit
+    FROM runs r
+    JOIN sessions s ON r.session_id = s.id
+    WHERE ${conditions.join(' AND ')}
+    ORDER BY r.started_at DESC
+    LIMIT 1
+  `;
+
+  const row = db.get(sql, params) as { id: string; git_commit: string | null } | undefined;
+  if (!row) return null;
+  return { id: row.id, gitCommit: row.git_commit };
+}
+
+export function findArtifacts(
+  db: Database,
+  runId: string,
+  stepId?: string,
+): Array<{ filename: string; stepId: string; stepIdx: number }> {
+  const conditions: string[] = ['a.run_id = ?'];
+  const params: (string | number | null)[] = [runId];
+
+  if (stepId !== undefined) {
+    conditions.push('a.step_id = ?');
+    params.push(stepId);
+  }
+
+  const sql = `
+    SELECT a.filename, a.step_id, st.idx
+    FROM artifacts a
+    JOIN steps st ON a.step_id = st.id
+    WHERE ${conditions.join(' AND ')}
+    ORDER BY st.idx ASC
+  `;
+
+  const rows = db.all(sql, params) as Array<{ filename: string; step_id: string; idx: number }>;
+  return rows.map((r) => ({ filename: r.filename, stepId: r.step_id, stepIdx: r.idx }));
+}

package/src/write.ts

@@ -1,29 +1,29 @@
-import type Database from 'better-sqlite3';
+import type { Database } from './db';
 
-export function insertSession(db: Database.Database, id: string, gitCommit: string | null, startedAt: number): void {
-  db.prepare('INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)').run(id, startedAt, gitCommit);
+export function insertSession(db: Database, id: string, gitCommit: string | null, startedAt: number): void {
+  db.run('INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)', [id, startedAt, gitCommit]);
 }
 
-export function upsertFeature(db: Database.Database, id: string, path: string, name: string): void {
-  db.prepare('INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)').run(id, path, name);
+export function upsertFeature(db: Database, id: string, path: string, name: string): void {
+  db.run('INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)', [id, path, name]);
 }
 
-export function upsertScenario(db: Database.Database, id: string, featureId: string, name: string): void {
-  db.prepare('INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)').run(id, featureId, name);
+export function upsertScenario(db: Database, id: string, featureId: string, name: string): void {
+  db.run('INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)', [id, featureId, name]);
 }
 
-export function upsertStep(db: Database.Database, id: string, scenarioId: string, idx: number, text: string): void {
-  db.prepare('INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)').run(id, scenarioId, idx, text);
+export function upsertStep(db: Database, id: string, scenarioId: string, idx: number, text: string): void {
+  db.run('INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)', [id, scenarioId, idx, text]);
 }
 
-export function insertRun(db: Database.Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void {
-  db.prepare('INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)').run(id, sessionId, scenarioId, startedAt);
+export function insertRun(db: Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void {
+  db.run('INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)', [id, sessionId, scenarioId, startedAt]);
 }
 
-export function finaliseRun(db: Database.Database, id: string, status: string, failedStepId?: string, error?: string): void {
-  db.prepare('UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?').run(status, failedStepId ?? null, error ?? null, id);
+export function finaliseRun(db: Database, id: string, status: string, failedStepId?: string, error?: string): void {
+  db.run('UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?', [status, failedStepId ?? null, error ?? null, id]);
 }
 
-export function insertArtifact(db: Database.Database, id: string, runId: string, stepId: string, filename: string): void {
-  db.prepare('INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)').run(id, runId, stepId, filename);
+export function insertArtifact(db: Database, id: string, runId: string, stepId: string, filename: string): void {
+  db.run('INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)', [id, runId, stepId, filename]);
 }