archondev 2.19.0 → 2.19.2

package/README.md

@@ -32,7 +32,7 @@ Copy governance files into any project. Works with your existing AI tools: **Cur
 [Download Lite Packages →](https://archondev.io/download)
 
 **What you get:**
-- ARCHITECTURE.md template with best practices
+- .archon/active/architecture.md template with best practices
 - **Quality Level / Posture** — Tell AI if it's prototype, production, or enterprise-grade
 - IDE-specific rule files (.cursorrules, CLAUDE.md, GEMINI.md, etc.)
 - Progress tracking templates
@@ -45,6 +45,15 @@ Copy governance files into any project. Works with your existing AI tools: **Cur
 - **Pre-Deploy Accessibility** — WCAG 2.2 AA check before going live, legal liability warnings
 - Works with any AI coding assistant
 
+### Local Governance SQLite (Dev Only)
+
+Governance data for this repo lives in `.archon/governance.db` and is local-only. It is never synced to Supabase.  
+To initialize or refresh it:
+
+```bash
+pnpm exec tsx scripts/init-governance-db.ts
+```
+
 ---
 
 ## Commands
@@ -84,14 +93,16 @@ Copy governance files into any project. Works with your existing AI tools: **Cur
 | `archon seo fix` | Apply recommended SEO fixes |
 | `archon geo identity` | Generate brand identity phrases for AI citation |
 | `archon geo schema` | Generate JSON-LD schemas |
+| `archon governance status` | Show governance status (AGD) |
+| `archon governance architecture update` | Update architecture with change reason |
+| `archon governance task update` | Update governance tasks |
+| `archon governance handoff` | Log handoff + current context |
+| `archon governance migrate` | Migrate legacy governance files |
+| `archon governance sqlite-init` | Initialize or refresh local governance SQLite DB |
 | `archon github connect` | Link GitHub account for cloud execution |
 | `archon github status` | Check GitHub connection status |
 | `archon session save [name]` | Save current session to cloud |
 | `archon session resume [id]` | Resume session on another device |
-
-**Notes:**  
-- Credits tier shows your balance and per‑model usage on startup; use `archon credits` for full details and history.  
-- You can paste multi‑line requests into interactive prompts; Archon captures them as a single response.
 | `archon execute ATOM --cloud` | Execute in cloud (creates PR when done) |
 | `archon cloud status` | List cloud executions |
 | `archon parallel cloud ATOM-001 ATOM-002` | Queue multiple atoms for cloud execution (Credits tier) |
@@ -104,6 +115,10 @@ Copy governance files into any project. Works with your existing AI tools: **Cur
 | `archon cleanup run` | Execute cleanup tasks |
 | `archon cleanup auto [enable\|disable]` | Enable/disable auto cleanup on start |
 
+**Notes:**  
+- Credits tier shows your balance and per‑model usage on startup; use `archon credits` for full details and history.  
+- You can paste multi‑line requests into interactive prompts; Archon captures them as a single response.
+
 **Tip:** Use `archon plan --edit` to adjust title and acceptance criteria before planning.
 **Web Checks:** If Archon detects a web project, it prompts to run A11y/SEO/GEO checks and stores your preference in `.archon/config.yaml`.
 
@@ -118,6 +133,13 @@ Copy governance files into any project. Works with your existing AI tools: **Cur
 
 No subscriptions. No commitments. Start free, upgrade anytime with `archon upgrade`.
 
+### BYOK Key Security
+
+- Your API keys are stored locally in `~/.archon/keys.json` (never uploaded to ArchonDev servers).
+- Keys are encrypted at rest with AES-256-GCM and the file is set to owner-only permissions (`0600`).
+- BYOK runs locally; cloud execution is Credits-only.
+- If your device is compromised, an attacker could access local files. Treat keys as sensitive secrets.
+
 ### Claude Pro/Max Subscription Support (Coming Soon)
 
 If you have an existing Claude subscription, you'll soon be able to use it with ArchonDev instead of API keys:

package/dist/{auth-HQBAG4CR.js → auth-7DNVC6UX.js}

@@ -2,9 +2,9 @@ import {
   login,
   logout,
   status
-} from "./chunk-CZCY63EY.js";
+} from "./chunk-F4OUCZPN.js";
 import "./chunk-M4LGRTLC.js";
-import "./chunk-LBBHM4I5.js";
+import "./chunk-GBYW3YAY.js";
 import "./chunk-SVU7MLG6.js";
 import "./chunk-4VNS5WPM.js";
 export {

package/dist/{chunk-ZJXIOETW.js → chunk-CTWVQ6F3.js}

@@ -14,7 +14,7 @@ import {
 } from "./chunk-RDG5BUED.js";
 import {
   login
-} from "./chunk-CZCY63EY.js";
+} from "./chunk-F4OUCZPN.js";
 import {
   getApiUrl,
   getAuthToken,
@@ -1071,7 +1071,7 @@ async function manageApiKeys() {
     if (removeIndex >= 0 && removeIndex < providers.length) {
       const providerToRemove = providers[removeIndex];
       if (providerToRemove) {
-        const { removeKey } = await import("./keys-U4QZE5YB.js");
+        const { removeKey } = await import("./keys-T2VPHE7Z.js");
         await removeKey(providerToRemove);
       }
     }
@@ -1079,7 +1079,7 @@ async function manageApiKeys() {
   }
   const provider = providerMap[choice];
   if (provider) {
-    const { addKey } = await import("./keys-U4QZE5YB.js");
+    const { addKey } = await import("./keys-T2VPHE7Z.js");
     await addKey(provider);
   }
 }

package/dist/{chunk-CZCY63EY.js → chunk-F4OUCZPN.js}

@@ -6,7 +6,7 @@ import {
   handleTierSetup,
   promptTierSelection,
   updateUserTier
-} from "./chunk-LBBHM4I5.js";
+} from "./chunk-GBYW3YAY.js";
 import {
   clearConfig,
   loadConfig,

package/dist/{chunk-LBBHM4I5.js → chunk-GBYW3YAY.js}

@@ -43,7 +43,7 @@ async function offerReauthentication(reason) {
     return false;
   }
   console.log();
-  const { login } = await import("./auth-HQBAG4CR.js");
+  const { login } = await import("./auth-7DNVC6UX.js");
   await login({ skipTierSelection: true });
   const { loadConfig: reload } = await import("./config-JBPM2YAB.js");
   const config = await reload();
@@ -207,7 +207,7 @@ async function promptForApiKey() {
       return;
   }
   if (provider) {
-    const { addKey } = await import("./keys-U4QZE5YB.js");
+    const { addKey } = await import("./keys-T2VPHE7Z.js");
     await addKey(provider, {});
     console.log();
     const addAnother = await promptYesNo("Would you like to add another API key?", false);
@@ -455,7 +455,7 @@ function promptYesNo(question, defaultValue) {
 }
 async function showKeyManagementMenu() {
   const { keyManager } = await import("./keys-THCHXIFD.js");
-  const { listKeys, addKey, removeKey } = await import("./keys-U4QZE5YB.js");
+  const { listKeys, addKey, removeKey } = await import("./keys-T2VPHE7Z.js");
   console.log();
   console.log(chalk.bold("API Key Management"));
   console.log(chalk.dim("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));

package/dist/{chunk-75J2JMU3.js → chunk-JNFXMWBR.js}

@@ -47,6 +47,10 @@ async function addKey(provider, options = {}) {
     process.exit(1);
   }
   const label = options.label ?? "default";
+  console.log(chalk.dim("Security: Your API key stays on this machine (never uploaded)."));
+  console.log(chalk.dim("  \u2022 Encrypted at rest (AES-256-GCM)"));
+  console.log(chalk.dim("  \u2022 Stored in ~/.archon/keys.json with owner-only permissions (0600)"));
+  console.log(chalk.dim("  \u2022 Used only for local BYOK calls"));
   const apiKey = await promptForKey(provider);
   if (!apiKey) {
     console.error(chalk.red("API key cannot be empty"));

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   setPreference,
   showExecutionPreferences,
   showPreferences
-} from "./chunk-ZJXIOETW.js";
+} from "./chunk-CTWVQ6F3.js";
 import {
   a11yBadge,
   a11yCheck,
@@ -85,14 +85,14 @@ import {
   listKeys,
   removeKey,
   setPrimaryKey
-} from "./chunk-75J2JMU3.js";
+} from "./chunk-JNFXMWBR.js";
 import "./chunk-TFSHS7EN.js";
 import "./chunk-RDG5BUED.js";
 import {
   login,
   logout,
   status
-} from "./chunk-CZCY63EY.js";
+} from "./chunk-F4OUCZPN.js";
 import {
   API_URL,
   SUPABASE_ANON_KEY,
@@ -102,7 +102,7 @@ import {
   handleTierSetup,
   promptTierSelection,
   updateUserTier
-} from "./chunk-LBBHM4I5.js";
+} from "./chunk-GBYW3YAY.js";
 import {
   getAuthToken,
   loadConfig,
@@ -2850,22 +2850,22 @@ async function start(options = {}) {
       const choice = await promptWithCommands("What would you like to do?", { allowMultiline: true });
       switch (choice) {
         case "1":
-          const { handleTierSetup: handleTierSetup2 } = await import("./tier-selection-426HA765.js");
+          const { handleTierSetup: handleTierSetup2 } = await import("./tier-selection-XFBM4SZ4.js");
           await handleTierSetup2("BYOK");
           break;
         case "2":
-          const { updateUserTier: updateUserTier2 } = await import("./tier-selection-426HA765.js");
+          const { updateUserTier: updateUserTier2 } = await import("./tier-selection-XFBM4SZ4.js");
           const result = await updateUserTier2("CREDITS");
           if (result.success) {
             config.tier = "CREDITS";
             await saveConfig(config);
             console.log(chalk6.green("\u2713 Switched to Managed Plan"));
-            const { handleTierSetup: setupCredits } = await import("./tier-selection-426HA765.js");
+            const { handleTierSetup: setupCredits } = await import("./tier-selection-XFBM4SZ4.js");
             await setupCredits("CREDITS");
           }
           break;
         case "3":
-          const { updateUserTier: downgrade } = await import("./tier-selection-426HA765.js");
+          const { updateUserTier: downgrade } = await import("./tier-selection-XFBM4SZ4.js");
           const downgradeResult = await downgrade("FREE");
           if (downgradeResult.success) {
             config.tier = "FREE";
@@ -3236,7 +3236,7 @@ async function showNewProjectMenu(cwd) {
       await quickStart(cwd);
       break;
     case "3": {
-      const description = await prompt("Describe what you want to do");
+      const description = await promptWithCommands("Describe what you want to do", { allowMultiline: true });
       if (description.trim()) {
         const { plan: plan2 } = await import("./plan-HCYXLSSD.js");
         await plan2(description, {});
@@ -3302,7 +3302,7 @@ async function runExploreFlow(cwd) {
   const choice = await promptWithCommands("Enter choice");
   switch (choice.toLowerCase()) {
     case "1": {
-      const description = await prompt("Describe what you want to do");
+      const description = await promptWithCommands("Describe what you want to do", { allowMultiline: true });
       if (description.trim()) {
         const { plan: plan2 } = await import("./plan-HCYXLSSD.js");
         await plan2(description, {});
@@ -3564,7 +3564,7 @@ ${state.forbiddenPatterns?.length ? `- **Forbidden patterns:** ${state.forbidden
   console.log();
   const continueChoice = await promptYesNo("Would you like to plan your first task now?", true);
   if (continueChoice) {
-    const description = await prompt("Describe what you want to build first");
+    const description = await promptWithCommands("Describe what you want to build first", { allowMultiline: true });
     if (description.trim()) {
       const { plan: plan2 } = await import("./plan-HCYXLSSD.js");
       await plan2(description, {});
@@ -3649,7 +3649,7 @@ async function showAdaptExistingMenu(cwd, state) {
       await runExploreFlow(cwd);
       break;
     case "2": {
-      const description = await prompt("Describe what you want to do");
+      const description = await promptWithCommands("Describe what you want to do", { allowMultiline: true });
       if (description.trim()) {
         const { plan: plan2 } = await import("./plan-HCYXLSSD.js");
         await plan2(description, {});
@@ -3788,7 +3788,7 @@ async function showMainMenu() {
     } }] : [],
     { key: "7", label: "Settings & Preferences", action: () => settingsMenu() },
     { key: "8", label: "Upgrade tier", action: async () => {
-      const { showUpgradeMenu } = await import("./tier-selection-426HA765.js");
+      const { showUpgradeMenu } = await import("./tier-selection-XFBM4SZ4.js");
       await showUpgradeMenu();
       await showMainMenu();
     } },
@@ -3828,7 +3828,7 @@ async function showReviewProgress(cwd) {
 }
 async function planTask() {
   const { plan: plan2 } = await import("./plan-HCYXLSSD.js");
-  const description = await prompt("Describe what you want to build");
+  const description = await promptWithCommands("Describe what you want to build", { allowMultiline: true });
   if (description.trim()) {
     await plan2(description, {});
   }
@@ -3840,7 +3840,7 @@ async function listAtoms() {
 async function executeNext() {
   const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-HCYXLSSD.js");
   const { analyzeProject, getComplexityDescription, getModeDescription } = await import("./orchestration-HIF3KP25.js");
-  const { loadExecutionPreferences } = await import("./preferences-I6WETXOI.js");
+  const { loadExecutionPreferences } = await import("./preferences-OAOZCZGR.js");
   const cwd = process.cwd();
   const atoms = await listLocalAtoms2();
   const pendingAtoms = atoms.filter((a) => a.status === "READY" || a.status === "IN_PROGRESS");
@@ -3935,11 +3935,11 @@ async function reportBug() {
   }
 }
 async function viewStatus() {
-  const { status: status2 } = await import("./auth-HQBAG4CR.js");
+  const { status: status2 } = await import("./auth-7DNVC6UX.js");
   await status2();
 }
 async function settingsMenu() {
-  const { interactiveSettings } = await import("./preferences-I6WETXOI.js");
+  const { interactiveSettings } = await import("./preferences-OAOZCZGR.js");
   await interactiveSettings();
   await showMainMenu();
 }
@@ -3998,12 +3998,12 @@ async function reviewCode() {
 async function handleInSessionCommand(input) {
   const normalized = input.toLowerCase().trim();
   if (normalized === "upgrade" || normalized === "archon upgrade" || normalized === "pricing" || normalized === "archon pricing") {
-    const { showUpgradeMenu } = await import("./tier-selection-426HA765.js");
+    const { showUpgradeMenu } = await import("./tier-selection-XFBM4SZ4.js");
     await showUpgradeMenu();
     return true;
   }
   if (normalized === "status" || normalized === "archon status") {
-    const { status: status2 } = await import("./auth-HQBAG4CR.js");
+    const { status: status2 } = await import("./auth-7DNVC6UX.js");
     await status2();
     return true;
   }
@@ -4019,7 +4019,7 @@ async function handleInSessionCommand(input) {
     return true;
   }
   if (normalized === "keys" || normalized === "archon keys") {
-    const { listKeys: listKeys2 } = await import("./keys-U4QZE5YB.js");
+    const { listKeys: listKeys2 } = await import("./keys-T2VPHE7Z.js");
     await listKeys2();
     return true;
   }
@@ -4041,32 +4041,28 @@ function prompt(question) {
     });
   });
 }
-function promptMultiline(question, idleMs = 250) {
+function promptMultiline(question) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
     });
     const lines = [];
-    let timer = null;
-    const finish = () => {
-      if (timer) clearTimeout(timer);
-      rl.close();
-      resolve(lines.join("\n").trimEnd());
-    };
-    const scheduleFinish = () => {
-      if (timer) clearTimeout(timer);
-      timer = setTimeout(finish, idleMs);
-    };
     rl.on("line", (line) => {
+      if (line.trim() === ".") {
+        rl.close();
+        return;
+      }
       lines.push(line);
-      scheduleFinish();
     });
     rl.on("SIGINT", () => {
       rl.close();
       process.exit(0);
     });
-    rl.setPrompt(`${chalk6.cyan("?")} ${question}: `);
+    rl.on("close", () => {
+      resolve(lines.join("\n").trimEnd());
+    });
+    rl.setPrompt(`${chalk6.cyan("?")} ${question} (multi-line: end with a single '.' line or Ctrl+D): `);
     rl.prompt();
   });
 }
@@ -7138,7 +7134,7 @@ async function modelsList() {
 // src/cli/governance.ts
 import { Command as Command2 } from "commander";
 import chalk17 from "chalk";
-import { existsSync as existsSync18, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync19, readFileSync as readFileSync7 } from "fs";
 import { readFile as readFile12 } from "fs/promises";
 import { join as join19 } from "path";
 import matter4 from "gray-matter";
@@ -7623,6 +7619,7 @@ async function migrateLegacyGovernance(options = {}) {
 }
 
 // src/core/governance/sqlite.ts
+import { existsSync as existsSync18, mkdirSync as mkdirSync5, readFileSync as readFileSync6 } from "fs";
 import { join as join18 } from "path";
 import matter3 from "gray-matter";
 import Database2 from "better-sqlite3";
@@ -7631,6 +7628,262 @@ var TASKS_PATH = join18(".archon", "active", "tasks.json");
 var HANDOFFS_PATH = join18(".archon", "history", "handoffs.jsonl");
 var DECISIONS_PATH = join18(".archon", "history", "decision_log.jsonl");
 var COMPLETED_PATH = join18(".archon", "archive", "completed_tasks.jsonl");
+var GovernanceSqliteView = class {
+  db = null;
+  config;
+  constructor(config = {}) {
+    this.config = config;
+  }
+  init(cwd) {
+    const archonDir = join18(cwd, ".archon");
+    if (!existsSync18(archonDir)) {
+      mkdirSync5(archonDir, { recursive: true });
+    }
+    const dbPath = this.config.inMemory ? ":memory:" : join18(cwd, this.config.dbPath ?? ".archon/governance.db");
+    this.db = new Database2(dbPath);
+    this.db.exec(`
+      PRAGMA journal_mode = WAL;
+      CREATE TABLE IF NOT EXISTS architecture (
+        id TEXT PRIMARY KEY,
+        version REAL,
+        last_updated TEXT,
+        updated_by TEXT,
+        change_reason TEXT,
+        content TEXT
+      );
+      CREATE TABLE IF NOT EXISTS tasks (
+        id TEXT PRIMARY KEY,
+        description TEXT NOT NULL,
+        status TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT,
+        notes TEXT
+      );
+      CREATE TABLE IF NOT EXISTS completed_tasks (
+        id TEXT PRIMARY KEY,
+        description TEXT NOT NULL,
+        status TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT,
+        notes TEXT
+      );
+      CREATE TABLE IF NOT EXISTS handoffs (
+        id TEXT PRIMARY KEY,
+        timestamp TEXT NOT NULL,
+        from_agent TEXT,
+        reason TEXT NOT NULL,
+        summary TEXT NOT NULL,
+        next_actions TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS decisions (
+        id TEXT PRIMARY KEY,
+        timestamp TEXT NOT NULL,
+        category TEXT NOT NULL,
+        change_reason TEXT NOT NULL,
+        updated_by TEXT,
+        diff_summary TEXT
+      );
+      CREATE VIRTUAL TABLE IF NOT EXISTS governance_fts USING fts5(
+        source,
+        record_id,
+        text,
+        timestamp
+      );
+    `);
+  }
+  close() {
+    if (this.db) {
+      this.db.close();
+      this.db = null;
+    }
+  }
+  async loadFromDisk(cwd) {
+    if (!this.db) {
+      throw new Error("GovernanceSqliteView not initialized. Call init() first.");
+    }
+    const stats = {
+      tasks: 0,
+      completedTasks: 0,
+      handoffs: 0,
+      decisions: 0,
+      architecture: false
+    };
+    this.db.exec("DELETE FROM governance_fts; DELETE FROM architecture; DELETE FROM tasks; DELETE FROM completed_tasks; DELETE FROM handoffs; DELETE FROM decisions;");
+    const archPath = join18(cwd, ARCH_PATH);
+    if (existsSync18(archPath)) {
+      const raw = readFileSync6(archPath, "utf-8");
+      const parsed = matter3(raw);
+      const data = parsed.data;
+      const versionRaw = data["version"];
+      const version = typeof versionRaw === "number" ? versionRaw : typeof versionRaw === "string" ? Number.parseFloat(versionRaw) : null;
+      const archId = "architecture";
+      const content = parsed.content.trim();
+      this.db.prepare(
+        `INSERT OR REPLACE INTO architecture (id, version, last_updated, updated_by, change_reason, content)
+         VALUES (?, ?, ?, ?, ?, ?)`
+      ).run(
+        archId,
+        Number.isFinite(version) ? version : null,
+        typeof data["last_updated"] === "string" ? data["last_updated"] : null,
+        typeof data["updated_by"] === "string" ? data["updated_by"] : null,
+        typeof data["change_reason"] === "string" ? data["change_reason"] : null,
+        content
+      );
+      this.db.prepare(
+        `INSERT INTO governance_fts (source, record_id, text, timestamp)
+         VALUES (?, ?, ?, ?)`
+      ).run("architecture", archId, content, typeof data["last_updated"] === "string" ? data["last_updated"] : null);
+      stats.architecture = true;
+    }
+    const tasksPath = join18(cwd, TASKS_PATH);
+    if (existsSync18(tasksPath)) {
+      const raw = readFileSync6(tasksPath, "utf-8");
+      const tasks = JSON.parse(raw);
+      const insertTask = this.db.prepare(
+        `INSERT OR REPLACE INTO tasks (id, description, status, created_at, updated_at, notes)
+         VALUES (?, ?, ?, ?, ?, ?)`
+      );
+      const insertFts = this.db.prepare(
+        `INSERT INTO governance_fts (source, record_id, text, timestamp)
+         VALUES (?, ?, ?, ?)`
+      );
+      for (const task of tasks) {
+        insertTask.run(task.id, task.description, task.status, task.created_at, task.updated_at ?? null, task.notes ?? null);
+        insertFts.run("task", task.id, task.description + (task.notes ? `
+${task.notes}` : ""), task.updated_at ?? task.created_at);
+        stats.tasks += 1;
+      }
+    }
+    const completedPath = join18(cwd, COMPLETED_PATH);
+    if (existsSync18(completedPath)) {
+      const lines = readFileSync6(completedPath, "utf-8").split("\n").filter((line) => line.trim().length > 0);
+      const insertCompleted = this.db.prepare(
+        `INSERT OR REPLACE INTO completed_tasks (id, description, status, created_at, updated_at, notes)
+         VALUES (?, ?, ?, ?, ?, ?)`
+      );
+      const insertFts = this.db.prepare(
+        `INSERT INTO governance_fts (source, record_id, text, timestamp)
+         VALUES (?, ?, ?, ?)`
+      );
+      for (const line of lines) {
+        const task = JSON.parse(line);
+        insertCompleted.run(task.id, task.description, task.status, task.created_at, task.updated_at ?? null, task.notes ?? null);
+        insertFts.run("completed_task", task.id, task.description + (task.notes ? `
+${task.notes}` : ""), task.updated_at ?? task.created_at);
+        stats.completedTasks += 1;
+      }
+    }
+    const handoffsPath = join18(cwd, HANDOFFS_PATH);
+    if (existsSync18(handoffsPath)) {
+      const lines = readFileSync6(handoffsPath, "utf-8").split("\n").filter((line) => line.trim().length > 0);
+      const insertHandoff = this.db.prepare(
+        `INSERT OR REPLACE INTO handoffs (id, timestamp, from_agent, reason, summary, next_actions)
+         VALUES (?, ?, ?, ?, ?, ?)`
+      );
+      const insertFts = this.db.prepare(
+        `INSERT INTO governance_fts (source, record_id, text, timestamp)
+         VALUES (?, ?, ?, ?)`
+      );
+      for (const line of lines) {
+        const entry = JSON.parse(line);
+        const id = `${entry.timestamp}-${entry.from_agent ?? "unknown"}`;
+        const nextActions = entry.next_actions.join("\n");
+        insertHandoff.run(id, entry.timestamp, entry.from_agent ?? null, entry.reason, entry.summary, nextActions);
+        insertFts.run("handoff", id, `${entry.summary}
+${nextActions}`, entry.timestamp);
+        stats.handoffs += 1;
+      }
+    }
+    const decisionsPath = join18(cwd, DECISIONS_PATH);
+    if (existsSync18(decisionsPath)) {
+      const lines = readFileSync6(decisionsPath, "utf-8").split("\n").filter((line) => line.trim().length > 0);
+      const insertDecision = this.db.prepare(
+        `INSERT OR REPLACE INTO decisions (id, timestamp, category, change_reason, updated_by, diff_summary)
+         VALUES (?, ?, ?, ?, ?, ?)`
+      );
+      const insertFts = this.db.prepare(
+        `INSERT INTO governance_fts (source, record_id, text, timestamp)
+         VALUES (?, ?, ?, ?)`
+      );
+      for (const line of lines) {
+        const entry = JSON.parse(line);
+        const id = `${entry.timestamp}-${entry.category}`;
+        insertDecision.run(
+          id,
+          entry.timestamp,
+          entry.category,
+          entry.change_reason,
+          entry.updated_by ?? null,
+          entry.diff_summary ?? null
+        );
+        insertFts.run("decision", id, `${entry.change_reason}${entry.diff_summary ? `
+${entry.diff_summary}` : ""}`, entry.timestamp);
+        stats.decisions += 1;
+      }
+    }
+    return stats;
+  }
+  search(query, limit = 10) {
+    if (!this.db) {
+      throw new Error("GovernanceSqliteView not initialized. Call init() first.");
+    }
+    const rows = this.db.prepare(
+      `SELECT source, record_id as recordId, text, timestamp, rank
+       FROM governance_fts
+       WHERE governance_fts MATCH ?
+       ORDER BY rank
+       LIMIT ?`
+    ).all(query, limit);
+    return rows;
+  }
+  listTasks(status2) {
+    if (!this.db) {
+      throw new Error("GovernanceSqliteView not initialized. Call init() first.");
+    }
+    if (status2) {
+      return this.db.prepare(
+        "SELECT id, description, status, created_at, updated_at, notes FROM tasks WHERE status = ? ORDER BY created_at"
+      ).all(status2);
+    }
+    return this.db.prepare(
+      "SELECT id, description, status, created_at, updated_at, notes FROM tasks ORDER BY created_at"
+    ).all();
+  }
+  getLatestHandoff() {
+    if (!this.db) {
+      throw new Error("GovernanceSqliteView not initialized. Call init() first.");
+    }
+    const row = this.db.prepare(
+      "SELECT timestamp, from_agent as fromAgent, reason, summary, next_actions as nextActions FROM handoffs ORDER BY timestamp DESC LIMIT 1"
+    ).get();
+    if (!row) return null;
+    return {
+      timestamp: row.timestamp,
+      from_agent: row.fromAgent ?? void 0,
+      reason: row.reason,
+      summary: row.summary,
+      next_actions: row.nextActions.split("\n").filter((item) => item.trim().length > 0)
+    };
+  }
+  getArchitecture() {
+    if (!this.db) {
+      throw new Error("GovernanceSqliteView not initialized. Call init() first.");
+    }
+    const row = this.db.prepare(
+      "SELECT version, last_updated, updated_by, change_reason, content FROM architecture LIMIT 1"
+    ).get();
+    if (!row) return null;
+    return {
+      content: row.content,
+      meta: {
+        version: row.version,
+        last_updated: row.last_updated,
+        updated_by: row.updated_by,
+        change_reason: row.change_reason
+      }
+    };
+  }
+};
 
 // src/cli/governance.ts
 var ACTIVE_ARCH_PATH3 = join19(".archon", "active", "architecture.md");
@@ -7644,11 +7897,11 @@ function isTaskStatus(value) {
 }
 function resolveArchitecturePath2(cwd) {
   const agdPath = join19(cwd, ACTIVE_ARCH_PATH3);
-  if (existsSync18(agdPath)) {
+  if (existsSync19(agdPath)) {
     return { path: agdPath, source: "agd" };
   }
   const legacyPath = join19(cwd, "ARCHITECTURE.md");
-  if (existsSync18(legacyPath)) {
+  if (existsSync19(legacyPath)) {
     return { path: legacyPath, source: "legacy" };
   }
   return { path: null, source: null };
@@ -7736,9 +7989,9 @@ function createGovernanceCommand() {
       console.log(chalk17.yellow("  \u25CB No architecture file found"));
     }
     const tasksPath = join19(cwd, ACTIVE_TASKS_PATH2);
-    if (existsSync18(tasksPath)) {
+    if (existsSync19(tasksPath)) {
       try {
-        const tasksRaw = JSON.parse(readFileSync6(tasksPath, "utf-8"));
+        const tasksRaw = JSON.parse(readFileSync7(tasksPath, "utf-8"));
         const tasks2 = parseTasks(tasksRaw);
         if (tasks2) {
           renderStatusCounts(countTaskStatuses(tasks2));
@@ -7750,8 +8003,8 @@ function createGovernanceCommand() {
       }
     }
     const contextPath = join19(cwd, CURRENT_CONTEXT_PATH);
-    if (existsSync18(contextPath)) {
-      const content = readFileSync6(contextPath, "utf-8");
+    if (existsSync19(contextPath)) {
+      const content = readFileSync7(contextPath, "utf-8");
       const meta = parseContextMeta(content);
       console.log(chalk17.dim(`  Handoff: ${meta.timestamp ?? "present"}`));
       if (meta.reason) {
@@ -7759,15 +8012,15 @@ function createGovernanceCommand() {
       }
     }
     const handoffHistoryPath = join19(cwd, HANDOFF_HISTORY_PATH);
-    if (existsSync18(handoffHistoryPath)) {
-      const count = lineCount(readFileSync6(handoffHistoryPath, "utf-8"));
+    if (existsSync19(handoffHistoryPath)) {
+      const count = lineCount(readFileSync7(handoffHistoryPath, "utf-8"));
       if (count > 0) {
         console.log(chalk17.dim(`  Handoff entries: ${count}`));
       }
     }
     const completedPath = join19(cwd, COMPLETED_TASKS_PATH);
-    if (existsSync18(completedPath)) {
-      const count = lineCount(readFileSync6(completedPath, "utf-8"));
+    if (existsSync19(completedPath)) {
+      const count = lineCount(readFileSync7(completedPath, "utf-8"));
       if (count > 0) {
         console.log(chalk17.dim(`  Completed tasks archived: ${count}`));
       }
@@ -7784,7 +8037,7 @@ function createGovernanceCommand() {
       return;
     }
     if (options.raw) {
-      const raw = readFileSync6(archInfo.path, "utf-8");
+      const raw = readFileSync7(archInfo.path, "utf-8");
       console.log(raw.trimEnd());
       return;
     }
@@ -7801,7 +8054,7 @@ function createGovernanceCommand() {
       console.log(result.value);
       return;
     }
-    const legacyRaw = readFileSync6(archInfo.path, "utf-8");
+    const legacyRaw = readFileSync7(archInfo.path, "utf-8");
     const legacyParsed = matter4(legacyRaw);
     const legacyContent = legacyParsed.content.trim();
     if (!legacyContent) {
@@ -7813,7 +8066,7 @@ function createGovernanceCommand() {
   architecture.command("update").description("Update active architecture with change reason").requiredOption("-f, --file <path>", "Path to new architecture content").requiredOption("-r, --reason <text>", "Reason for the change (required)").option("-b, --by <name>", "Updated by (optional)").action(async (options) => {
     const cwd = process.cwd();
     const filePath = options.file;
-    if (!existsSync18(filePath)) {
+    if (!existsSync19(filePath)) {
       console.log(chalk17.red(`File not found: ${filePath}`));
       process.exit(1);
     }
@@ -7885,6 +8138,14 @@ function createGovernanceCommand() {
     }
     console.log("");
   });
+  governance.command("sqlite-init").description("Initialize or refresh local governance SQLite DB").option("--db <path>", "Override DB path (default: .archon/governance.db)").action(async (options) => {
+    const cwd = process.cwd();
+    const view = new GovernanceSqliteView({ dbPath: options.db ?? ".archon/governance.db" });
+    view.init(cwd);
+    await view.loadFromDisk(cwd);
+    view.close();
+    console.log(chalk17.green("\u2713 Governance SQLite DB initialized"));
+  });
   return governance;
 }
 
@@ -7914,11 +8175,11 @@ program.command("status").description("Show current user and project status").ac
   await status();
 });
 program.command("upgrade").description("Upgrade your tier (BYOK for free unlimited, or Managed plan)").action(async () => {
-  const { showUpgradeMenu } = await import("./tier-selection-426HA765.js");
+  const { showUpgradeMenu } = await import("./tier-selection-XFBM4SZ4.js");
   await showUpgradeMenu();
 });
 program.command("pricing", { hidden: true }).action(async () => {
-  const { showUpgradeMenu } = await import("./tier-selection-426HA765.js");
+  const { showUpgradeMenu } = await import("./tier-selection-XFBM4SZ4.js");
   await showUpgradeMenu();
 });
 program.command("init").description("Initialize ArchonDev in current project").option("--analyze", "Run enhanced analysis of codebase").option("--no-git", "Skip git initialization").action(async (options) => {

package/dist/{keys-U4QZE5YB.js → keys-T2VPHE7Z.js}

@@ -3,7 +3,7 @@ import {
   listKeys,
   removeKey,
   setPrimaryKey
-} from "./chunk-75J2JMU3.js";
+} from "./chunk-JNFXMWBR.js";
 import "./chunk-TFSHS7EN.js";
 import "./chunk-RDG5BUED.js";
 import "./chunk-SVU7MLG6.js";

package/dist/{preferences-I6WETXOI.js → preferences-OAOZCZGR.js}

@@ -7,13 +7,13 @@ import {
   setPreference,
   showExecutionPreferences,
   showPreferences
-} from "./chunk-ZJXIOETW.js";
+} from "./chunk-CTWVQ6F3.js";
 import "./chunk-UFR2LX6G.js";
 import "./chunk-TFSHS7EN.js";
 import "./chunk-RDG5BUED.js";
-import "./chunk-CZCY63EY.js";
+import "./chunk-F4OUCZPN.js";
 import "./chunk-M4LGRTLC.js";
-import "./chunk-LBBHM4I5.js";
+import "./chunk-GBYW3YAY.js";
 import "./chunk-SVU7MLG6.js";
 import "./chunk-4VNS5WPM.js";
 export {

package/dist/{tier-selection-426HA765.js → tier-selection-XFBM4SZ4.js}

@@ -4,7 +4,7 @@ import {
   showTierSwitchMenu,
   showUpgradeMenu,
   updateUserTier
-} from "./chunk-LBBHM4I5.js";
+} from "./chunk-GBYW3YAY.js";
 import "./chunk-SVU7MLG6.js";
 import "./chunk-4VNS5WPM.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archondev",
-  "version": "2.19.0",
+  "version": "2.19.2",
   "description": "Local-first AI-powered development governance system",
   "main": "dist/index.js",
   "bin": {