archondev 2.19.0 → 2.19.1

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`.
 

package/dist/index.js

@@ -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, {});
@@ -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, {});
   }
@@ -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;
 }
 

package/package.json

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