scai 0.1.178 → 1.0.0

package/dist/scripts/dbScriptSupport.js

@@ -0,0 +1,172 @@
+/**
+ * Shared helpers for DB health and DB overview scripts.
+ *
+ * Why this file exists:
+ * - `db check` and `db overview` need the same active-repo DB lookup
+ * - table inventory output should stay consistent across both commands
+ * - overview should reflect the real runtime shape without copying SQL in many places
+ */
+import Database from "better-sqlite3";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { Config } from "../config.js";
+const RUNTIME_TABLES = new Set([
+    "global_state",
+    "projects",
+    "sessions",
+    "tasks",
+    "steps",
+    "evaluations",
+    "action_ledger",
+    "task_plans",
+    "task_progress_snapshots",
+]);
+const INDEX_TABLES = new Set([
+    "files",
+    "files_fts",
+    "folder_capsules",
+    "functions",
+    "graph_classes",
+    "graph_edges",
+]);
+function quoteIdentifier(name) {
+    return `"${name.replace(/"/g, `""`)}"`;
+}
+function isSuppressedTable(name) {
+    return (name.startsWith("sqlite_") ||
+        /_fts_(data|idx|content|docsize|config)$/.test(name));
+}
+function classifyTable(name) {
+    if (RUNTIME_TABLES.has(name))
+        return "runtime";
+    if (INDEX_TABLES.has(name))
+        return "index";
+    return "other";
+}
+export function resolveActiveRepoDb() {
+    const cfg = Config.getRaw();
+    const repoKey = cfg.activeRepo;
+    if (!repoKey) {
+        console.error("❌ No active repo found. Use `scai set-index`.");
+        process.exit(1);
+    }
+    const repoName = path.basename(repoKey);
+    const scaiRepoRoot = path.join(os.homedir(), ".scai", "repos", repoName);
+    const dbPath = path.join(scaiRepoRoot, "db.sqlite");
+    if (!fs.existsSync(dbPath)) {
+        console.error(`❌ DB not found: ${dbPath}`);
+        process.exit(1);
+    }
+    return {
+        db: new Database(dbPath),
+        dbPath,
+        scaiRepoRoot,
+        repoName,
+    };
+}
+export function tableExists(db, table) {
+    return !!db
+        .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name = ?`)
+        .get(table);
+}
+export function tableCount(db, table) {
+    return db.prepare(`SELECT COUNT(*) AS c FROM ${quoteIdentifier(table)}`).get().c;
+}
+export function tableColumns(db, table) {
+    const rows = db
+        .prepare(`PRAGMA table_info(${quoteIdentifier(table)})`)
+        .all();
+    return rows.map((row) => row.name);
+}
+export function getUserTableNames(db) {
+    const rows = db
+        .prepare(`
+      SELECT name
+      FROM sqlite_master
+      WHERE type = 'table'
+      ORDER BY name
+    `)
+        .all();
+    return rows.map((row) => row.name).filter((name) => !isSuppressedTable(name));
+}
+export function getTableSampleRows(db, table, limit = 3) {
+    return db
+        .prepare(`SELECT * FROM ${quoteIdentifier(table)} LIMIT ?`)
+        .all(limit);
+}
+export function buildTableInventory(db, sampleLimit = 3) {
+    return getUserTableNames(db).map((name) => ({
+        name,
+        category: classifyTable(name),
+        columns: tableColumns(db, name),
+        rowCount: tableCount(db, name),
+        sampleRows: getTableSampleRows(db, name, sampleLimit),
+    }));
+}
+export function buildRuntimeOverview(db, limits = {}) {
+    const sessionLimit = limits.sessions ?? 5;
+    const taskLimit = limits.tasksPerSession ?? 5;
+    const stepLimit = limits.stepsPerTask ?? 5;
+    const actionLimit = limits.actionsPerTask ?? 5;
+    const sessions = db.prepare(`
+    SELECT id, status, created_at, updated_at, repo_root_path, execution_path
+    FROM sessions
+    ORDER BY id DESC
+    LIMIT ?
+  `).all(sessionLimit);
+    return sessions.map((session) => {
+        const tasks = db.prepare(`
+      SELECT id, status, initial_query, created_at
+      FROM tasks
+      WHERE session_id = ?
+      ORDER BY id DESC
+      LIMIT ?
+    `).all(session.id, taskLimit);
+        return {
+            ...session,
+            tasks: tasks.map((task) => ({
+                ...task,
+                steps: db.prepare(`
+          SELECT id, file_path, action, status, step_index, created_at
+          FROM steps
+          WHERE task_id = ?
+          ORDER BY COALESCE(step_index, id) ASC, id ASC
+          LIMIT ?
+        `).all(task.id, stepLimit),
+                actions: db.prepare(`
+          SELECT id, action_kind, target, outcome, summary, created_at
+          FROM action_ledger
+          WHERE task_id = ?
+          ORDER BY id DESC
+          LIMIT ?
+        `).all(task.id, actionLimit),
+            })),
+        };
+    });
+}
+export function formatInlineValue(value, max = 72) {
+    if (value == null)
+        return "null";
+    if (typeof value === "string") {
+        const compact = value.replace(/\s+/g, " ").trim();
+        return compact.length <= max ? compact : `${compact.slice(0, max - 1)}…`;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    try {
+        const text = JSON.stringify(value);
+        return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+    }
+    catch {
+        return String(value);
+    }
+}
+export function formatRowPreview(row, maxColumns = 4) {
+    const entries = Object.entries(row).slice(0, maxColumns);
+    return entries
+        .map(([key, value]) => `${key}=${formatInlineValue(value, 48)}`)
+        .join(" | ");
+}
+//# sourceMappingURL=dbScriptSupport.js.map

package/dist/scripts/dbScriptSupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbScriptSupport.js","sourceRoot":"","sources":["../../src/scripts/dbScriptSupport.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared helpers for DB health and DB overview scripts.\n *\n * Why this file exists:\n * - `db check` and `db overview` need the same active-repo DB lookup\n * - table inventory output should stay consistent across both commands\n * - overview should reflect the real runtime shape without copying SQL in many places\n */\nimport Database from \"better-sqlite3\";\nimport type { Database as DatabaseType } from \"better-sqlite3\";\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport { Config } from \"../config.js\";\n\nexport type RuntimeOverviewSession = {\n  id: number;\n  status: string;\n  created_at: string;\n  updated_at: string;\n  repo_root_path?: string | null;\n  execution_path?: string | null;\n  tasks: RuntimeOverviewTask[];\n};\n\nexport type RuntimeOverviewTask = {\n  id: number;\n  status: string;\n  initial_query: string;\n  created_at: string;\n  steps: RuntimeOverviewStep[];\n  actions: RuntimeOverviewAction[];\n};\n\nexport type RuntimeOverviewStep = {\n  id: number;\n  file_path: string;\n  action?: string | null;\n  status: string;\n  step_index?: number | null;\n  created_at: string;\n};\n\nexport type RuntimeOverviewAction = {\n  id: number;\n  action_kind: string;\n  target: string;\n  outcome: string;\n  summary: string;\n  created_at: string;\n};\n\nexport type TableInventoryEntry = {\n  name: string;\n  category: \"runtime\" | \"index\" | \"other\";\n  columns: string[];\n  rowCount: number;\n  sampleRows: Record<string, unknown>[];\n};\n\nconst RUNTIME_TABLES = new Set([\n  \"global_state\",\n  \"projects\",\n  \"sessions\",\n  \"tasks\",\n  \"steps\",\n  \"evaluations\",\n  \"action_ledger\",\n  \"task_plans\",\n  \"task_progress_snapshots\",\n]);\n\nconst INDEX_TABLES = new Set([\n  \"files\",\n  \"files_fts\",\n  \"folder_capsules\",\n  \"functions\",\n  \"graph_classes\",\n  \"graph_edges\",\n]);\n\nfunction quoteIdentifier(name: string): string {\n  return `\"${name.replace(/\"/g, `\"\"`)}\"`;\n}\n\nfunction isSuppressedTable(name: string): boolean {\n  return (\n    name.startsWith(\"sqlite_\") ||\n    /_fts_(data|idx|content|docsize|config)$/.test(name)\n  );\n}\n\nfunction classifyTable(name: string): \"runtime\" | \"index\" | \"other\" {\n  if (RUNTIME_TABLES.has(name)) return \"runtime\";\n  if (INDEX_TABLES.has(name)) return \"index\";\n  return \"other\";\n}\n\nexport function resolveActiveRepoDb(): {\n  db: DatabaseType;\n  dbPath: string;\n  scaiRepoRoot: string;\n  repoName: string;\n} {\n  const cfg = Config.getRaw();\n  const repoKey = cfg.activeRepo;\n\n  if (!repoKey) {\n    console.error(\"❌ No active repo found. Use `scai set-index`.\");\n    process.exit(1);\n  }\n\n  const repoName = path.basename(repoKey);\n  const scaiRepoRoot = path.join(os.homedir(), \".scai\", \"repos\", repoName);\n  const dbPath = path.join(scaiRepoRoot, \"db.sqlite\");\n\n  if (!fs.existsSync(dbPath)) {\n    console.error(`❌ DB not found: ${dbPath}`);\n    process.exit(1);\n  }\n\n  return {\n    db: new Database(dbPath),\n    dbPath,\n    scaiRepoRoot,\n    repoName,\n  };\n}\n\nexport function tableExists(db: DatabaseType, table: string): boolean {\n  return !!db\n    .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name = ?`)\n    .get(table);\n}\n\nexport function tableCount(db: DatabaseType, table: string): number {\n  return (\n    db.prepare(`SELECT COUNT(*) AS c FROM ${quoteIdentifier(table)}`).get() as {\n      c: number;\n    }\n  ).c;\n}\n\nexport function tableColumns(db: DatabaseType, table: string): string[] {\n  const rows = db\n    .prepare(`PRAGMA table_info(${quoteIdentifier(table)})`)\n    .all() as Array<{ name: string }>;\n  return rows.map((row) => row.name);\n}\n\nexport function getUserTableNames(db: DatabaseType): string[] {\n  const rows = db\n    .prepare(`\n      SELECT name\n      FROM sqlite_master\n      WHERE type = 'table'\n      ORDER BY name\n    `)\n    .all() as Array<{ name: string }>;\n\n  return rows.map((row) => row.name).filter((name) => !isSuppressedTable(name));\n}\n\nexport function getTableSampleRows(\n  db: DatabaseType,\n  table: string,\n  limit = 3\n): Record<string, unknown>[] {\n  return db\n    .prepare(`SELECT * FROM ${quoteIdentifier(table)} LIMIT ?`)\n    .all(limit) as Record<string, unknown>[];\n}\n\nexport function buildTableInventory(\n  db: DatabaseType,\n  sampleLimit = 3\n): TableInventoryEntry[] {\n  return getUserTableNames(db).map((name) => ({\n    name,\n    category: classifyTable(name),\n    columns: tableColumns(db, name),\n    rowCount: tableCount(db, name),\n    sampleRows: getTableSampleRows(db, name, sampleLimit),\n  }));\n}\n\nexport function buildRuntimeOverview(\n  db: DatabaseType,\n  limits: {\n    sessions?: number;\n    tasksPerSession?: number;\n    stepsPerTask?: number;\n    actionsPerTask?: number;\n  } = {}\n): RuntimeOverviewSession[] {\n  const sessionLimit = limits.sessions ?? 5;\n  const taskLimit = limits.tasksPerSession ?? 5;\n  const stepLimit = limits.stepsPerTask ?? 5;\n  const actionLimit = limits.actionsPerTask ?? 5;\n\n  const sessions = db.prepare(`\n    SELECT id, status, created_at, updated_at, repo_root_path, execution_path\n    FROM sessions\n    ORDER BY id DESC\n    LIMIT ?\n  `).all(sessionLimit) as Array<{\n    id: number;\n    status: string;\n    created_at: string;\n    updated_at: string;\n    repo_root_path?: string | null;\n    execution_path?: string | null;\n  }>;\n\n  return sessions.map((session) => {\n    const tasks = db.prepare(`\n      SELECT id, status, initial_query, created_at\n      FROM tasks\n      WHERE session_id = ?\n      ORDER BY id DESC\n      LIMIT ?\n    `).all(session.id, taskLimit) as Array<{\n      id: number;\n      status: string;\n      initial_query: string;\n      created_at: string;\n    }>;\n\n    return {\n      ...session,\n      tasks: tasks.map((task) => ({\n        ...task,\n        steps: db.prepare(`\n          SELECT id, file_path, action, status, step_index, created_at\n          FROM steps\n          WHERE task_id = ?\n          ORDER BY COALESCE(step_index, id) ASC, id ASC\n          LIMIT ?\n        `).all(task.id, stepLimit) as RuntimeOverviewStep[],\n        actions: db.prepare(`\n          SELECT id, action_kind, target, outcome, summary, created_at\n          FROM action_ledger\n          WHERE task_id = ?\n          ORDER BY id DESC\n          LIMIT ?\n        `).all(task.id, actionLimit) as RuntimeOverviewAction[],\n      })),\n    };\n  });\n}\n\nexport function formatInlineValue(value: unknown, max = 72): string {\n  if (value == null) return \"null\";\n  if (typeof value === \"string\") {\n    const compact = value.replace(/\\s+/g, \" \").trim();\n    return compact.length <= max ? compact : `${compact.slice(0, max - 1)}…`;\n  }\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  try {\n    const text = JSON.stringify(value);\n    return text.length <= max ? text : `${text.slice(0, max - 1)}…`;\n  } catch {\n    return String(value);\n  }\n}\n\nexport function formatRowPreview(\n  row: Record<string, unknown>,\n  maxColumns = 4\n): string {\n  const entries = Object.entries(row).slice(0, maxColumns);\n  return entries\n    .map(([key, value]) => `${key}=${formatInlineValue(value, 48)}`)\n    .join(\" | \");\n}\n"]}

package/dist/scripts/dbcheck.js

@@ -1,285 +1,191 @@
-import Database from "better-sqlite3";
-import path from "path";
-import os from "os";
-import fs from "fs";
-import { execSync } from "child_process";
-import { Config } from "../config.js";
-/* ───────────────────────── bootstrap ───────────────────────── */
-const cfg = Config.getRaw();
-const repoKey = cfg.activeRepo;
-if (!repoKey) {
-    console.error("❌ No active repo found. Use `scai set-index`.");
-    process.exit(1);
-}
-const repoName = path.basename(repoKey);
-const scaiRepoRoot = path.join(os.homedir(), ".scai", "repos", repoName);
-const dbPath = path.join(scaiRepoRoot, "db.sqlite");
-if (!fs.existsSync(dbPath)) {
-    console.error(`❌ DB not found: ${dbPath}`);
-    process.exit(1);
-}
-const db = new Database(dbPath);
-/* ───────────────────────── helpers ───────────────────────── */
-function tableCount(table) {
-    return db.prepare(`SELECT COUNT(*) AS c FROM ${table}`).get().c;
-}
-function nonEmptyCount(table, col) {
-    return db.prepare(`SELECT COUNT(*) AS c FROM ${table} WHERE ${col} IS NOT NULL AND ${col} != ''`).get().c;
-}
-function header(title) {
-    console.log(`\n${title}`);
-}
-/* ───────────────────────── global / project / task sanity ───────────────────────── */
-header("🌐 global_state / projects / tasks sanity");
-// --- global_state ---
-const globalExists = db
-    .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='global_state'`)
-    .get();
-if (!globalExists) {
-    console.log("❌ global_state table missing — run initSchema");
-}
-else {
-    const globalRow = db.prepare(`SELECT * FROM global_state WHERE id=1`).get();
-    if (!globalRow) {
-        console.log("⚠️ global_state row missing (id=1) — should be auto-created");
-    }
-    else {
-        console.log("✅ global_state row exists");
+import { resolveActiveRepoDb, tableColumns, tableCount, tableExists, } from "./dbScriptSupport.js";
+const findings = [];
+function addFinding(severity, message) {
+    findings.push({ severity, message });
+    const icon = severity === "pass" ? "✅" :
+        severity === "warn" ? "⚠️" :
+            "❌";
+    console.log(`${icon} ${message}`);
+}
+function checkRequiredTables(db) {
+    console.log("\nSchema");
+    const requiredTables = [
+        "global_state",
+        "projects",
+        "sessions",
+        "tasks",
+        "steps",
+        "evaluations",
+        "action_ledger",
+        "task_plans",
+        "task_progress_snapshots",
+        "files",
+        "files_fts",
+        "folder_capsules",
+        "functions",
+        "graph_classes",
+        "graph_edges",
+    ];
+    for (const table of requiredTables) {
+        if (tableExists(db, table)) {
+            addFinding("pass", `${table} table exists`);
+        }
+        else {
+            addFinding("fail", `${table} table is missing`);
+        }
     }
 }
-// --- projects ---
-const projectsExists = db
-    .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='projects'`)
-    .get();
-if (!projectsExists) {
-    console.log("❌ projects table missing — run initSchema");
-}
-else {
-    const totalProjects = tableCount("projects");
-    if (totalProjects === 0) {
-        console.log("⚠️ no projects found — should be at least one default project");
+function checkSingletons(db) {
+    console.log("\nSingletons");
+    if (!tableExists(db, "global_state"))
+        return;
+    const globalRow = db.prepare(`SELECT id FROM global_state WHERE id = 1`).get();
+    if (globalRow) {
+        addFinding("pass", "global_state row id=1 exists");
     }
     else {
-        console.log(`✅ total projects: ${totalProjects}`);
+        addFinding("warn", "global_state row id=1 is missing");
     }
 }
-// --- tasks ---
-header("📝 tasks");
-const tasksExists = db
-    .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='tasks'`)
-    .get();
-if (!tasksExists) {
-    console.log("❌ tasks table missing — you need to run initSchema with tasks");
-}
-else {
-    const totalTasks = tableCount("tasks");
-    const tasksWithQuery = nonEmptyCount("tasks", "initial_query");
-    console.log(`📊 total tasks: ${totalTasks}`);
-    console.log(`✏️ tasks with initial_query: ${tasksWithQuery}`);
-    const sampleTasks = db.prepare(`
-    SELECT id, initial_query, status, created_at
-    FROM tasks
-    ORDER BY created_at DESC
-    LIMIT 3
-  `).all();
-    if (sampleTasks.length === 0) {
-        console.log("⚠️ no tasks yet");
+function checkExpectedContent(db) {
+    console.log("\nExpected Content");
+    if (tableExists(db, "projects")) {
+        const count = tableCount(db, "projects");
+        addFinding(count > 0 ? "pass" : "warn", count > 0 ? `projects has ${count} row(s)` : "projects has no rows");
     }
-    else {
-        console.log("✅ sample tasks:");
-        sampleTasks.forEach(t => console.log(`   [${t.id}] "${t.initial_query}" (status=${t.status}, created=${t.created_at})`));
+    if (tableExists(db, "files")) {
+        const count = tableCount(db, "files");
+        addFinding(count > 0 ? "pass" : "warn", count > 0 ? `files has ${count} row(s)` : "files has no rows");
     }
-}
-/* ───────────────────────── task_steps sanity ───────────────────────── */
-header("🦾 task_steps");
-const taskStepsExists = db
-    .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='task_steps'`)
-    .get();
-if (!taskStepsExists) {
-    console.log("❌ task_steps table missing — you need to run initSchema with task_steps");
-}
-else {
-    const totalTaskSteps = tableCount("task_steps");
-    const pendingSteps = nonEmptyCount("task_steps", "status"); // all steps have status
-    console.log(`📊 total task_steps: ${totalTaskSteps}`);
-    console.log(`📝 task_steps with status: ${pendingSteps}`);
-    const sampleSteps = db.prepare(`
-    SELECT id, task_id, file_path, status, step_index, created_at
-    FROM task_steps
-    ORDER BY created_at DESC
-    LIMIT 3
-  `).all();
-    if (sampleSteps.length === 0) {
-        console.log("⚠️ no task_steps yet");
-    }
-    else {
-        console.log("✅ sample task_steps:");
-        sampleSteps.forEach(s => console.log(`   [${s.id}] task ${s.task_id} - file "${s.file_path}" (status=${s.status}, index=${s.step_index}, created=${s.created_at})`));
-    }
-    // Check for steps referencing missing tasks
-    const danglingSteps = db.prepare(`
-    SELECT ts.id, ts.task_id
-    FROM task_steps ts
-    LEFT JOIN tasks t ON ts.task_id = t.id
-    WHERE t.id IS NULL
-  `).all();
-    if (danglingSteps.length > 0) {
-        console.log(`❌ ${danglingSteps.length} task_steps reference missing tasks`);
-    }
-    else {
-        console.log("✅ all task_steps reference valid tasks");
-    }
-}
-/* ───────────────────────── files ───────────────────────── */
-header("🗂 files");
-const totalFiles = tableCount("files");
-const filesWithContent = nonEmptyCount("files", "content_text");
-console.log(`📊 total files: ${totalFiles}`);
-console.log(`📄 files with content: ${filesWithContent}`);
-header("⚙️ processing_status");
-const statuses = db.prepare(`
-  SELECT processing_status, COUNT(*) AS count
-  FROM files
-  GROUP BY processing_status
-  ORDER BY count DESC
-`).all();
-statuses.forEach(s => console.log(`   ${s.processing_status ?? "NULL"}: ${s.count}`));
-/* ───────────────────────── FTS ───────────────────────── */
-header("🔍 files_fts");
-const ftsExists = db
-    .prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='files_fts'`)
-    .get();
-if (!ftsExists) {
-    console.log("❌ files_fts missing — search is broken");
-}
-else {
-    const cols = db.prepare(`PRAGMA table_info(files_fts)`).all();
-    const hasContentText = cols.some(c => c.name === "content_text");
-    if (!hasContentText) {
-        console.log("❌ files_fts.content_text missing");
-    }
-    else {
-        const indexed = nonEmptyCount("files_fts", "content_text");
-        console.log(`📦 indexed rows with content_text: ${indexed}`);
-        const sample = db.prepare(`
-      SELECT filename, substr(content_text,1,80) AS preview
-      FROM files_fts
-      WHERE files_fts MATCH 'function'
-      LIMIT 3
-    `).all();
-        if (sample.length === 0) {
-            console.log("⚠️ no FTS hits for 'function'");
+    if (tableExists(db, "files_fts")) {
+        const columns = tableColumns(db, "files_fts");
+        if (columns.includes("content_text")) {
+            addFinding("pass", "files_fts has content_text");
         }
         else {
-            console.log("✅ FTS sample:");
-            sample.forEach(r => console.log(`   ${r.filename} | "${r.preview}"`));
+            addFinding("fail", "files_fts is missing content_text");
         }
     }
 }
-/* ───────────────────────── folder capsules ───────────────────────── */
-header("📁 folder_capsules");
-console.log(`📊 total capsules: ${tableCount("folder_capsules")}`);
-const emptyCapsules = db.prepare(`
-  SELECT COUNT(*) AS c
-  FROM folder_capsules
-  WHERE capsule_json IS NULL OR capsule_json = ''
-`).get();
-if (emptyCapsules.c > 0) {
-    console.log(`⚠️ ${emptyCapsules.c} capsules have empty JSON`);
-}
-const sampleCaps = db.prepare(`
-  SELECT path, depth, confidence, source_file_count, capsule_json
-  FROM folder_capsules
-  ORDER BY RANDOM()
-  LIMIT 5
-`).all();
-sampleCaps.forEach(c => {
-    let parsed = null;
-    try {
-        parsed = JSON.parse(c.capsule_json);
+function countBrokenRelation(db, sql, message) {
+    const row = db.prepare(sql).get();
+    if (row.c === 0) {
+        addFinding("pass", message);
     }
-    catch { }
-    console.log(`   ${c.path}`);
-    console.log(`      depth=${c.depth} confidence=${c.confidence} files=${c.source_file_count}`);
-    if (parsed) {
-        console.log(`      roles=${parsed.roles?.length ?? 0} ` +
-            `concerns=${parsed.concerns?.length ?? 0} ` +
-            `keyFiles=${parsed.keyFiles?.length ?? 0}`);
+    else {
+        addFinding("fail", `${message} (${row.c} broken row(s))`);
     }
-});
-/* ───────────────────────── functions ───────────────────────── */
-header("🧑‍💻 functions");
-console.log(`📊 total functions: ${tableCount("functions")}`);
-const funcSamples = db.prepare(`
-  SELECT id, name, file_id, substr(content,1,60) AS preview
-  FROM functions
-  ORDER BY RANDOM()
-  LIMIT 5
-`).all();
-funcSamples.forEach(f => console.log(`   [${f.id}] ${f.name} (file ${f.file_id}) "${f.preview}"`));
-/* ───────────────────────── graph (KG) ───────────────────────── */
-header("🏷 graph_classes");
-console.log(`📊 total classes: ${tableCount("graph_classes")}`);
-header("🔗 graph_edges");
-console.log(`📊 total edges: ${tableCount("graph_edges")}`);
-const danglingFuncs = db.prepare(`
-  SELECT e.id
-  FROM graph_edges e
-  WHERE e.source_type='function'
-    AND NOT EXISTS (SELECT 1 FROM functions f WHERE f.unique_id = e.source_unique_id)
-  UNION
-  SELECT e.id
-  FROM graph_edges e
-  WHERE e.target_type='function'
-    AND NOT EXISTS (SELECT 1 FROM functions f WHERE f.unique_id = e.target_unique_id)
-  LIMIT 10
-`).all();
-if (danglingFuncs.length === 0) {
-    console.log("✅ no dangling function edges");
-}
-else {
-    console.log(`❌ dangling function edges: ${danglingFuncs.length}`);
 }
-/* ───────────────────────── Graphviz ───────────────────────── */
-header("🧩 graphviz");
-try {
-    const edges = db.prepare(`
-    SELECT source_type, source_unique_id, target_type, target_unique_id, relation
-    FROM graph_edges
-    LIMIT 300
-  `).all();
-    if (edges.length === 0) {
-        console.log("⚠️ no edges — skipping export");
+function countWeakHealthSignal(db, sql, message) {
+    const row = db.prepare(sql).get();
+    if (row.c === 0) {
+        addFinding("pass", message);
     }
     else {
-        const lines = [
-            "digraph G {",
-            "  rankdir=LR;",
-            '  node [shape=box, style=filled, color="#eaeaea"];'
-        ];
-        for (const e of edges) {
-            const s = `${e.source_type}_${e.source_unique_id}`.replace(/[^a-zA-Z0-9_]/g, "_");
-            const t = `${e.target_type}_${e.target_unique_id}`.replace(/[^a-zA-Z0-9_]/g, "_");
-            const label = (e.relation ?? "").replace(/"/g, "'");
-            lines.push(`  ${s} -> ${t} [label="${label}"];`);
-        }
-        lines.push("}");
-        const outDir = path.join(scaiRepoRoot, "graphs");
-        fs.mkdirSync(outDir, { recursive: true });
-        const dot = path.join(outDir, "graph-overview.dot");
-        const png = path.join(outDir, "graph-overview.png");
-        fs.writeFileSync(dot, lines.join("\n"));
-        console.log(`✅ dot written: ${dot}`);
-        try {
-            execSync(`dot -Tpng "${dot}" -o "${png}"`);
-            console.log(`✅ png written: ${png}`);
-        }
-        catch {
-            console.log("⚠️ graphviz not installed — png skipped");
-        }
-    }
-}
-catch (err) {
-    console.error("❌ graphviz export failed", err);
-}
-console.log("\n✅ DB check complete\n");
+        addFinding("warn", `${message} (${row.c} row(s))`);
+    }
+}
+function checkRelations(db) {
+    console.log("\nRelations");
+    if (tableExists(db, "tasks") && tableExists(db, "sessions")) {
+        countBrokenRelation(db, `
+        SELECT COUNT(*) AS c
+        FROM tasks t
+        LEFT JOIN sessions s ON s.id = t.session_id
+        WHERE s.id IS NULL
+      `, "all tasks point to a valid session");
+    }
+    if (tableExists(db, "tasks") && tableExists(db, "projects")) {
+        countBrokenRelation(db, `
+        SELECT COUNT(*) AS c
+        FROM tasks t
+        LEFT JOIN projects p ON p.id = t.project_id
+        WHERE p.id IS NULL
+      `, "all tasks point to a valid project");
+    }
+    if (tableExists(db, "steps") && tableExists(db, "tasks")) {
+        countBrokenRelation(db, `
+        SELECT COUNT(*) AS c
+        FROM steps s
+        LEFT JOIN tasks t ON t.id = s.task_id
+        WHERE t.id IS NULL
+      `, "all steps point to a valid task");
+    }
+    if (tableExists(db, "evaluations") && tableExists(db, "tasks")) {
+        countBrokenRelation(db, `
+        SELECT COUNT(*) AS c
+        FROM evaluations e
+        LEFT JOIN tasks t ON t.id = e.task_id
+        WHERE t.id IS NULL
+      `, "all evaluations point to a valid task");
+    }
+    if (tableExists(db, "action_ledger") && tableExists(db, "tasks")) {
+        countBrokenRelation(db, `
+        SELECT COUNT(*) AS c
+        FROM action_ledger a
+        LEFT JOIN tasks t ON t.id = a.task_id
+        WHERE t.id IS NULL
+      `, "all action_ledger rows point to a valid task");
+    }
+    if (tableExists(db, "task_plans") && tableExists(db, "tasks")) {
+        countBrokenRelation(db, `
+        SELECT COUNT(*) AS c
+        FROM task_plans p
+        LEFT JOIN tasks t ON t.id = p.task_id
+        WHERE t.id IS NULL
+      `, "all task_plans rows point to a valid task");
+    }
+    if (tableExists(db, "task_progress_snapshots") && tableExists(db, "tasks")) {
+        countBrokenRelation(db, `
+        SELECT COUNT(*) AS c
+        FROM task_progress_snapshots s
+        LEFT JOIN tasks t ON t.id = s.task_id
+        WHERE t.id IS NULL
+      `, "all task_progress_snapshots rows point to a valid task");
+    }
+    if (tableExists(db, "task_progress_snapshots") && tableExists(db, "task_plans")) {
+        countWeakHealthSignal(db, `
+        SELECT COUNT(*) AS c
+        FROM task_progress_snapshots s
+        LEFT JOIN task_plans p ON p.id = s.plan_id
+        WHERE s.plan_id IS NOT NULL
+          AND p.id IS NULL
+      `, "task_progress_snapshots plan links look valid");
+    }
+}
+function checkSoftSignals(db) {
+    console.log("\nSoft Signals");
+    if (tableExists(db, "folder_capsules")) {
+        countWeakHealthSignal(db, `
+        SELECT COUNT(*) AS c
+        FROM folder_capsules
+        WHERE capsule_json IS NULL OR capsule_json = ''
+      `, "folder_capsules rows have capsule_json");
+    }
+}
+function printSummary() {
+    const passCount = findings.filter((finding) => finding.severity === "pass").length;
+    const warnCount = findings.filter((finding) => finding.severity === "warn").length;
+    const failCount = findings.filter((finding) => finding.severity === "fail").length;
+    console.log("\nSummary");
+    console.log(`passes=${passCount} warnings=${warnCount} failures=${failCount}`);
+    if (failCount > 0) {
+        console.log("Health check result: FAIL");
+        process.exitCode = 1;
+        return;
+    }
+    if (warnCount > 0) {
+        console.log("Health check result: WARN");
+        return;
+    }
+    console.log("Health check result: PASS");
+}
+const { db, dbPath } = resolveActiveRepoDb();
+console.log(`DB: ${dbPath}`);
+checkRequiredTables(db);
+checkSingletons(db);
+checkExpectedContent(db);
+checkRelations(db);
+checkSoftSignals(db);
+printSummary();
+//# sourceMappingURL=dbcheck.js.map