sdlc-agent-4-enterprise-server 1.23.0 → 1.26.0

package/README.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-1.23.0-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/version-1.26.0-blue?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/tools-66+-teal?style=for-the-badge" alt="Tools">
   <img src="https://img.shields.io/badge/node-%3E%3D18-green?style=for-the-badge" alt="Node">
 </p>
@@ -233,6 +233,7 @@ The embedding model is expected at `.code-intel/models/model.onnx`. Download it:
 
 | Version | Date | Ticket | Changes |
 |---------|------|--------|---------|
+| 1.26.0 | 2026-08-14 | SA4E-155 | On-demand KB entry enrichment: priority queue (HIGH/NORMAL column), configurable polling timeout (15s default), 3-tier fallback, COALESCE first-write-wins, ConfigService (Admin UI > ENV > Default), PendingTaskRepository priority-aware claimBatch(). |
 | 1.19.1 | 2026-07-31 | SA4E-81 | Version alignment with extension release. No backend code changes in this release. |
 | 1.18.0 | 2026-07-31 | SA4E-79 | Client-Side LLM Knowledge Enrichment hardening: `handleIngestFile`/`handleIngest` always mark `pending` + enqueue TAG_ENRICHMENT (NEW-01/NEW-06/NEW-10), TaskWorker tags/structured_map conditional updates as race guards (NEW-03), USER-scoped entries enrichable without projectId (NEW-07), pending section LIMIT 3→10 (NEW-09). FTS fix: `knowledge_fts` auto-rebuild at startup when empty — restores `mem_search` for pre-existing entries. |
 | 1.17.0 | 2026-07-30 | SA4E-77 | Pega Knowledge Graph: categorized node types (PROCESS, DECISION, DATA_MODEL, UI, etc.), config-driven mapping (`pega-categories.json`), Pega-mode color switching in graph legend. Code/KB split uses entry_id prefix. Dashboard includes Pega rules in codeSymbols. isPega flag in /positions API. |

package/analyze-perf.cjs

@@ -0,0 +1,75 @@
+const { Pool } = require('pg');
+const pool = new Pool({ host:'localhost', user:'sa4e_user', password:'sa4e_local_dev_password', database:'sa4e_db' });
+async function run() {
+  const client = await pool.connect();
+  try {
+    // 1. Pending tasks breakdown
+    const taskStats = await client.query(`
+      SELECT task_type, status, count(*) as cnt 
+      FROM pending_tasks 
+      GROUP BY task_type, status 
+      ORDER BY task_type, status
+    `);
+    console.log('=== PENDING TASKS BREAKDOWN ===');
+    taskStats.rows.forEach(r => console.log('  ' + r.task_type + ' | ' + r.status + ' | ' + r.cnt));
+
+    // 2. Task completion rate (last 5 completed tasks timing)
+    const recent = await client.query(`
+      SELECT task_type, status, created_at, started_at, completed_at, error
+      FROM pending_tasks 
+      WHERE completed_at IS NOT NULL 
+      ORDER BY completed_at DESC LIMIT 5
+    `);
+    console.log('\n=== LAST 5 COMPLETED TASKS ===');
+    recent.rows.forEach(r => {
+      const dur = r.started_at && r.completed_at ? 
+        ((new Date(r.completed_at) - new Date(r.started_at))/1000).toFixed(1) + 's' : 'N/A';
+      console.log('  ' + r.task_type + ' | ' + r.status + ' | duration: ' + dur + (r.error ? ' | ERR: ' + r.error.substring(0, 80) : ''));
+    });
+
+    // 3. Failed tasks
+    const failed = await client.query(`
+      SELECT task_type, error, count(*) as cnt 
+      FROM pending_tasks 
+      WHERE status = 'FAILED' 
+      GROUP BY task_type, error 
+      ORDER BY cnt DESC LIMIT 10
+    `);
+    console.log('\n=== FAILED TASKS (grouped by error) ===');
+    if (failed.rows.length === 0) console.log('  None');
+    failed.rows.forEach(r => console.log('  ' + r.task_type + ' (' + r.cnt + 'x): ' + (r.error || 'no error').substring(0, 100)));
+
+    // 4. Queue depth and oldest pending
+    const queue = await client.query(`
+      SELECT count(*) as total, min(created_at) as oldest, max(created_at) as newest
+      FROM pending_tasks WHERE status = 'PENDING'
+    `);
+    console.log('\n=== QUEUE STATUS ===');
+    const q = queue.rows[0];
+    console.log('  Pending: ' + q.total + ' tasks');
+    console.log('  Oldest: ' + q.oldest);
+    console.log('  Newest: ' + q.newest);
+
+    // 5. Currently processing (IN_PROGRESS)
+    const inprog = await client.query(`
+      SELECT task_type, started_at, entry_id 
+      FROM pending_tasks WHERE status = 'IN_PROGRESS'
+    `);
+    console.log('\n=== IN PROGRESS ===');
+    if (inprog.rows.length === 0) console.log('  None (worker idle or between tasks)');
+    inprog.rows.forEach(r => console.log('  ' + r.task_type + ' | started: ' + r.started_at + ' | entry: ' + r.entry_id));
+
+    // 6. DB table sizes for context
+    const sizes = await client.query(`
+      SELECT 'files' as t, count(*) as c FROM files
+      UNION ALL SELECT 'symbols', count(*) FROM symbols
+      UNION ALL SELECT 'knowledge_entries', count(*) FROM knowledge_entries
+      UNION ALL SELECT 'graph_nodes', count(*) FROM graph_nodes
+      UNION ALL SELECT 'body_embeddings', count(*) FROM body_embeddings
+    `);
+    console.log('\n=== TABLE COUNTS ===');
+    sizes.rows.forEach(r => console.log('  ' + r.t + ': ' + r.c));
+
+  } finally { client.release(); await pool.end(); }
+}
+run().catch(e => console.error(e.message));

package/btest-tmp.mjs

@@ -0,0 +1,16 @@
+import Database from 'better-sqlite3';
+const db = new Database(':memory:');
+db.exec('CREATE TABLE t (project_id TEXT)');
+db.prepare('INSERT INTO t VALUES (?)').run('p1');
+const s = db.prepare('SELECT COUNT(*) cnt FROM t WHERE project_id = $1');
+console.log('named scalar bind:', JSON.stringify(s.get('p1')));
+try {
+  console.log('array bind:', JSON.stringify(s.get(['p1'])));
+} catch (e) {
+  console.log('array bind ERROR:', e.message);
+}
+try {
+  console.log('raw get() bind:', JSON.stringify(s.get()));
+} catch (e) {
+  console.log('no-param bind ERROR:', e.message);
+}

package/check-api.cjs

@@ -0,0 +1,5 @@
+async function main() {
+  const res = await fetch("http://127.0.0.1:48721/api/admin/database/tables", { headers: { "Cookie": "" } });
+  console.log(res.status, await res.text().then(t => t.substring(0, 500)));
+}
+main();

package/check-db.cjs

@@ -0,0 +1,15 @@
+const Database = require("better-sqlite3");
+const path = require("path");
+const base = "c:/projects/kiro/SDLC-Agents-4-Enterprise/backend/.code-intel";
+for (const dbFile of ["admin.db", "index.db", "knowledge.db"]) {
+  try {
+    const db = new Database(path.join(base, dbFile), { readonly: true });
+    const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name").all();
+    console.log("\n=== " + dbFile + " (" + tables.length + " tables) ===");
+    for (const t of tables) {
+      const count = db.prepare("SELECT COUNT(*) as c FROM \"" + t.name + "\"").get();
+      console.log("  " + t.name + ": " + count.c);
+    }
+    db.close();
+  } catch(e) { console.log(dbFile + ": " + e.message); }
+}

package/check-db.js

@@ -0,0 +1,15 @@
+const Database = require("better-sqlite3");
+const path = require("path");
+const base = "c:/projects/kiro/SDLC-Agents-4-Enterprise/backend/.code-intel";
+for (const dbFile of ["admin.db", "index.db", "knowledge.db"]) {
+  try {
+    const db = new Database(path.join(base, dbFile), { readonly: true });
+    const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name").all();
+    console.log("\n=== " + dbFile + " (" + tables.length + " tables) ===");
+    for (const t of tables) {
+      const count = db.prepare("SELECT COUNT(*) as c FROM \"" + t.name + "\"").get();
+      console.log("  " + t.name + ": " + count.c);
+    }
+    db.close();
+  } catch(e) { console.log(dbFile + ": " + e.message); }
+}

package/check-llm-tasks.cjs

@@ -0,0 +1,27 @@
+const { Pool } = require('pg');
+const pool = new Pool({ host:'localhost', user:'sa4e_user', password:'sa4e_local_dev_password', database:'sa4e_db' });
+async function run() {
+  const client = await pool.connect();
+  try {
+    // CODE_SUMMARY tasks
+    const cs = await client.query("SELECT status, count(*) as cnt FROM pending_tasks WHERE task_type='CODE_SUMMARY' GROUP BY status");
+    console.log('=== CODE_SUMMARY tasks ===');
+    if (cs.rows.length === 0) console.log('  NONE QUEUED — code symbols NOT being sent to LLM');
+    cs.rows.forEach(r => console.log('  ' + r.status + ': ' + r.cnt));
+
+    // All tasks by type
+    const all = await client.query('SELECT task_type, status, count(*) as cnt FROM pending_tasks GROUP BY task_type, status ORDER BY task_type, status');
+    console.log('\n=== ALL TASKS ===');
+    all.rows.forEach(r => console.log('  ' + r.task_type + ' | ' + r.status + ' | ' + r.cnt));
+
+    // body_embeddings (GraphSyncService reads this to queue CODE_SUMMARY)
+    const be = await client.query('SELECT count(*) as c FROM body_embeddings');
+    console.log('\n=== body_embeddings: ' + be.rows[0].c + ' rows ===');
+    if (parseInt(be.rows[0].c) === 0) {
+      console.log('  ROOT CAUSE: body_embeddings is EMPTY');
+      console.log('  GraphSyncService.queueCodeSummaryTasks() needs body_embeddings data');
+      console.log('  No body stored → no CODE_SUMMARY tasks → LLM not called for code symbols');
+    }
+  } finally { client.release(); await pool.end(); }
+}
+run().catch(e => console.error(e.message));

package/check-pg.cjs

@@ -0,0 +1,15 @@
+const { Client } = require("pg");
+async function main() {
+  const client = new Client({ host: "localhost", port: 5432, user: "sa4e_user", password: "sa4e_pass", database: "sa4e_db" });
+  await client.connect();
+  const tables = await client.query("SELECT tablename FROM pg_tables WHERE schemaname='public' ORDER BY tablename");
+  console.log(`\n=== sa4e_db (${tables.rows.length} tables) ===\n`);
+  for (const row of tables.rows) {
+    const count = await client.query(`SELECT COUNT(*) as c FROM public."${row.tablename}"`);
+    const n = parseInt(count.rows[0].c);
+    if (n > 0) console.log(`  ${row.tablename}: ${n}`);
+    else console.log(`  ${row.tablename}: 0`);
+  }
+  await client.end();
+}
+main().catch(e => { console.error(e.message); process.exit(1); });

package/check-pg2.cjs

@@ -0,0 +1,21 @@
+const path = require("path");
+const { DatabaseConfigService } = require("./dist/database/config/DatabaseConfigService.js");
+const svc = new DatabaseConfigService(path.resolve(".code-intel"));
+const config = svc.load();
+const pg = config.engines.postgresql;
+console.log("Host:", pg.host, "Port:", pg.port, "DB:", pg.database, "User:", pg.username);
+console.log("Pass (decrypted):", pg.password ? pg.password.substring(0,3) + "..." : "null");
+
+const { Client } = require("pg");
+async function main() {
+  const client = new Client({ host: pg.host, port: pg.port, user: pg.username, password: pg.password, database: pg.database });
+  await client.connect();
+  const tables = await client.query("SELECT tablename FROM pg_tables WHERE schemaname='public' ORDER BY tablename");
+  console.log(`\n=== ${pg.database} (${tables.rows.length} tables) ===`);
+  for (const row of tables.rows) {
+    const count = await client.query(`SELECT COUNT(*) as c FROM public."${row.tablename}"`);
+    console.log(`  ${row.tablename}: ${count.rows[0].c}`);
+  }
+  await client.end();
+}
+main().catch(e => console.error("DB Error:", e.message));

package/check-project-ids.cjs

@@ -0,0 +1,27 @@
+const { Pool } = require('pg');
+const pool = new Pool({ host:'localhost', user:'sa4e_user', password:'sa4e_local_dev_password', database:'sa4e_db' });
+async function run() {
+  const client = await pool.connect();
+  try {
+    // What project_ids exist in symbols?
+    const symPids = await client.query("SELECT DISTINCT project_id, count(*) as cnt FROM symbols GROUP BY project_id");
+    console.log('=== SYMBOLS project_ids ===');
+    symPids.rows.forEach(r => console.log('  "' + r.project_id + '" → ' + r.cnt + ' symbols'));
+
+    // What project_ids exist in files?
+    const filePids = await client.query("SELECT DISTINCT project_id, count(*) as cnt FROM files GROUP BY project_id");
+    console.log('\n=== FILES project_ids ===');
+    filePids.rows.forEach(r => console.log('  "' + r.project_id + '" → ' + r.cnt + ' files'));
+
+    // What project_ids exist in knowledge_entries?
+    const kePids = await client.query("SELECT DISTINCT project_id, count(*) as cnt FROM knowledge_entries GROUP BY project_id");
+    console.log('\n=== KNOWLEDGE_ENTRIES project_ids ===');
+    kePids.rows.forEach(r => console.log('  "' + (r.project_id || 'NULL') + '" → ' + r.cnt + ' entries'));
+
+    // What project_ids exist in graph_nodes?
+    const gnPids = await client.query("SELECT DISTINCT project_id, count(*) as cnt FROM graph_nodes GROUP BY project_id");
+    console.log('\n=== GRAPH_NODES project_ids ===');
+    gnPids.rows.forEach(r => console.log('  "' + r.project_id + '" → ' + r.cnt + ' nodes'));
+  } finally { client.release(); await pool.end(); }
+}
+run().catch(e => console.error(e.message));

package/check-structure.cjs

@@ -0,0 +1,43 @@
+const { Pool } = require('pg');
+const pool = new Pool({ host:'localhost', user:'sa4e_user', password:'sa4e_local_dev_password', database:'sa4e_db' });
+async function run() {
+  const client = await pool.connect();
+  try {
+    // Check if there are any errors logged
+    const ops = await client.query("SELECT * FROM pending_tasks WHERE status != 'COMPLETED' LIMIT 5");
+    console.log('pending_tasks non-completed:', ops.rows.length);
+    ops.rows.forEach(t => console.log('  id:' + t.id + ' type:' + t.task_type + ' status:' + t.status + ' error:' + (t.error||'none')));
+
+    // Test INSERT into files table
+    console.log('\nTest INSERT into files:');
+    try {
+      const r = await client.query("INSERT INTO files (relative_path, language, module, hash, project_id) VALUES ('test.ts', 'typescript', 'test', 'abc123', 'test-proj') RETURNING id");
+      console.log('  OK! id:', r.rows[0].id);
+      await client.query("DELETE FROM files WHERE relative_path = 'test.ts'");
+    } catch (e) {
+      console.log('  FAILED:', e.message);
+    }
+
+    // Test INSERT into symbols table
+    console.log('\nTest INSERT into symbols:');
+    try {
+      // Need a file first
+      const f = await client.query("INSERT INTO files (relative_path, language, module, hash, project_id) VALUES ('test2.ts', 'typescript', 'test', 'xyz', 'test-proj') RETURNING id");
+      const fid = f.rows[0].id;
+      const s = await client.query("INSERT INTO symbols (project_id, file_id, name, kind, signature, start_line, end_line) VALUES ('test-proj', " + fid + ", 'TestClass', 'class', 'class TestClass', 1, 10) RETURNING id");
+      console.log('  OK! symbol id:', s.rows[0].id);
+      await client.query("DELETE FROM symbols WHERE name = 'TestClass'");
+      await client.query("DELETE FROM files WHERE relative_path = 'test2.ts'");
+    } catch (e) {
+      console.log('  FAILED:', e.message);
+    }
+
+    // Check what counts look like now
+    const counts = ['files', 'symbols', 'knowledge_entries', 'graph_nodes'];
+    for (const t of counts) {
+      const r = await client.query('SELECT count(*) as c FROM ' + t);
+      console.log(t + ':', r.rows[0].c);
+    }
+  } finally { client.release(); await pool.end(); }
+}
+run().catch(e => console.error(e.message));

package/check-tasks-quick.cjs

@@ -0,0 +1,16 @@
+const { Pool } = require('pg');
+const pool = new Pool({
+  host: 'localhost', port: 5432,
+  user: 'sa4e_user', password: 'sa4e_dev_2024',
+  database: 'sa4e_db'
+});
+async function main() {
+  try {
+    const r = await pool.query('SELECT status, COUNT(*) as cnt FROM pending_tasks GROUP BY status ORDER BY cnt DESC');
+    console.log('PENDING TASKS:', JSON.stringify(r.rows));
+    const r2 = await pool.query("SELECT task_type, status, COUNT(*) as cnt FROM pending_tasks GROUP BY task_type, status ORDER BY cnt DESC LIMIT 10");
+    console.log('BY TYPE:', JSON.stringify(r2.rows));
+  } catch(e) { console.error(e.message); }
+  await pool.end();
+}
+main();

package/dist/admin/db/core.d.ts

@@ -1,10 +1,9 @@
 /**
  * admin/db/core.ts — Central database access layer (unified single DB).
  * SA4E-45: getIndexAdapter() / getAdminAdapter() enable PostgreSQL/MySQL support.
- * SA4E-49: Consolidated into single unified DB file (index.db) — admin tables
- *          (users, graph_nodes) live alongside index tables (knowledge_entries, symbols).
+ * SA4E-49: Consolidated into single unified DB file (index.db).
+ * SA4E-53: Removed raw better-sqlite3 import; uses SqliteAdapter for creation.
  */
-import Database from 'better-sqlite3';
 import pino from 'pino';
 import { hashPassword, verifyPassword, generateToken } from './password.js';
 import type { DatabaseAdapter } from '../../database/adapters/DatabaseAdapter.js';
@@ -16,11 +15,10 @@ export declare function getIndexDbPath(): string;
 export declare function getActiveEngine(): string;
 /** Get connection config for the active engine */
 export declare function getActiveDbConfig(): any;
-export declare function getAdminDb(): Database.Database;
 /**
  * Get DatabaseAdapter for index data (knowledge_entries, files, symbols, etc.).
  * SA4E-49: Now shares the same unified DB as admin tables.
- * When engine=sqlite: wraps the unified DB via SqliteDbAdapter.
+ * When engine=sqlite: wraps the unified DB via SqliteAdapter.
  * When engine=postgresql/mysql: connects to the configured remote DB.
  */
 export declare function getIndexAdapter(): DatabaseAdapter;
@@ -34,3 +32,8 @@ export declare function getAdminAdapter(): DatabaseAdapter;
 export declare function initAdapters(): Promise<void>;
 /** Reset cached DB instance and adapters (used after DB switch/migration) */
 export declare function resetAdminDb(): void;
+/**
+ * Get the raw better-sqlite3 Database instance.
+ * @deprecated Use getAdminAdapter() for new code. Kept for backward compat with tests.
+ */
+export declare function getAdminDb(): import('better-sqlite3').Database;

package/dist/admin/db/core.js

@@ -1,24 +1,20 @@
 /**
  * admin/db/core.ts — Central database access layer (unified single DB).
  * SA4E-45: getIndexAdapter() / getAdminAdapter() enable PostgreSQL/MySQL support.
- * SA4E-49: Consolidated into single unified DB file (index.db) — admin tables
- *          (users, graph_nodes) live alongside index tables (knowledge_entries, symbols).
+ * SA4E-49: Consolidated into single unified DB file (index.db).
+ * SA4E-53: Removed raw better-sqlite3 import; uses SqliteAdapter for creation.
  */
-import Database from 'better-sqlite3';
 import * as path from 'path';
 import * as fs from 'fs';
-import { fileURLToPath } from 'url';
 import pino from 'pino';
 import { loadConfig, getWorkspacePath } from '../../config/index.js';
 import { initSchema, seedDefaults } from './schema.js';
 import { hashPassword, verifyPassword, generateToken } from './password.js';
-import { SqliteDbAdapter } from '../../modules/memory/task-queue/SqliteDbAdapter.js';
+import { SqliteAdapter } from '../../database/adapters/SqliteAdapter.js';
 import { DatabaseAdapterFactory } from '../../database/factory/DatabaseAdapterFactory.js';
 import { DatabaseConfigService } from '../../database/config/DatabaseConfigService.js';
 export { hashPassword, verifyPassword, generateToken };
 export const logger = pino({ name: 'admin-db' });
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
 const config = loadConfig();
 const DATA_DIR = path.resolve(getWorkspacePath(), config.dataDir);
 // SA4E-49: Single unified DB path — all tables in one file.
@@ -47,27 +43,30 @@ export function getActiveDbConfig() {
         if (!fs.existsSync(configPath))
             return { engine: 'sqlite', dbPath: DB_PATH };
         const raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-        if (raw.activeEngine === 'sqlite' || !raw.activeEngine)
+        if (raw.activeEngine === 'sqlite' || !raw.activeEngine) {
             return { engine: 'sqlite', dbPath: DB_PATH };
+        }
         return { engine: raw.activeEngine, ...raw.engines[raw.activeEngine] };
     }
     catch {
         return { engine: 'sqlite', dbPath: DB_PATH };
     }
 }
-let db = null;
-export function getAdminDb() {
-    if (!db) {
-        const dir = path.dirname(DB_PATH);
-        if (!fs.existsSync(dir))
-            fs.mkdirSync(dir, { recursive: true });
-        db = new Database(DB_PATH);
-        db.pragma('journal_mode = WAL');
-        db.pragma('foreign_keys = ON');
-        initSchema(db);
-        seedDefaults(db);
+let sqliteAdapter = null;
+/**
+ * Get or create the unified SQLite adapter (singleton).
+ * Handles directory creation, WAL mode, and schema initialization.
+ * Note: SqliteAdapter.connect() is synchronous internally (just wraps sync calls).
+ */
+function getUnifiedSqliteAdapter() {
+    if (!sqliteAdapter) {
+        sqliteAdapter = new SqliteAdapter(DB_PATH);
+        // SqliteAdapter.connect() is sync internally — safe to call eagerly
+        void sqliteAdapter.connect();
+        initSchema(sqliteAdapter);
+        seedDefaults(sqliteAdapter);
     }
-    return db;
+    return sqliteAdapter;
 }
 // --- DatabaseAdapter layer (multi-DB support) ---
 let indexAdapter = null;
@@ -75,14 +74,14 @@ let adminAdapter = null;
 /**
  * Get DatabaseAdapter for index data (knowledge_entries, files, symbols, etc.).
  * SA4E-49: Now shares the same unified DB as admin tables.
- * When engine=sqlite: wraps the unified DB via SqliteDbAdapter.
+ * When engine=sqlite: wraps the unified DB via SqliteAdapter.
  * When engine=postgresql/mysql: connects to the configured remote DB.
  */
 export function getIndexAdapter() {
     if (!indexAdapter) {
         const engine = getActiveEngine();
         if (engine === 'sqlite') {
-            indexAdapter = new SqliteDbAdapter(getAdminDb());
+            indexAdapter = getUnifiedSqliteAdapter();
         }
         else {
             const configService = new DatabaseConfigService(DATA_DIR);
@@ -99,7 +98,7 @@ export function getAdminAdapter() {
     if (!adminAdapter) {
         const engine = getActiveEngine();
         if (engine === 'sqlite') {
-            adminAdapter = new SqliteDbAdapter(getAdminDb());
+            adminAdapter = getUnifiedSqliteAdapter();
         }
         else {
             const configService = new DatabaseConfigService(DATA_DIR);
@@ -139,12 +138,19 @@ export async function initAdapters() {
 }
 /** Reset cached DB instance and adapters (used after DB switch/migration) */
 export function resetAdminDb() {
-    // SA4E-49: indexAdapter shares the same DB handle, clear references first.
     indexAdapter = null;
     adminAdapter = null;
-    if (db) {
-        db.close();
-        db = null;
+    if (sqliteAdapter) {
+        void sqliteAdapter.disconnect();
+        sqliteAdapter = null;
     }
 }
+/**
+ * Get the raw better-sqlite3 Database instance.
+ * @deprecated Use getAdminAdapter() for new code. Kept for backward compat with tests.
+ */
+export function getAdminDb() {
+    const adapter = getUnifiedSqliteAdapter();
+    return adapter.getRawDb();
+}
 //# sourceMappingURL=core.js.map

package/dist/admin/db/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/admin/db/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/admin/db/core.ts"],"names":[],"mappings":"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"}

package/dist/admin/db/schema.d.ts

@@ -1,3 +1,9 @@
-import Database from 'better-sqlite3';
-export declare function initSchema(db: Database.Database): void;
-export declare function seedDefaults(db: Database.Database): void;
+/**
+ * admin/db/schema.ts — Admin schema initialization and seed data.
+ * SA4E-53: Accepts DatabaseAdapter (sync interface) instead of raw better-sqlite3.
+ */
+import type { SyncDatabaseAdapter } from '../../database/adapters/DatabaseAdapter.js';
+/** Initialize admin schema tables (idempotent CREATE IF NOT EXISTS). */
+export declare function initSchema(db: SyncDatabaseAdapter): void;
+/** Seed default access groups and admin user. */
+export declare function seedDefaults(db: SyncDatabaseAdapter): void;