@groundctl/cli 0.2.0 → 0.2.2

package/dist/index.js

@@ -274,7 +274,7 @@ function generateProjectState(db, projectName) {
     md += "\n";
   }
   if (decisions.length > 0) {
-    md += "## Decisions made\n";
+    md += "## Architecture log\n";
     for (const d of decisions) {
       md += `- ${d.session_id}: ${d.description}`;
       if (d.rationale) md += ` \u2014 ${d.rationale}`;
@@ -1118,10 +1118,10 @@ function parseTranscript(transcriptPath, sessionId, projectPath) {
           if (filePath && isFilePath(filePath)) {
             const content2 = tool.input.content;
             const lines2 = content2 ? countContentLines(content2) : 0;
-            const rel = relativePath(filePath, projectPath);
-            if (!filesMap.has(rel)) {
-              filesMap.set(rel, {
-                path: rel,
+            const rel2 = relativePath(filePath, projectPath);
+            if (!filesMap.has(rel2)) {
+              filesMap.set(rel2, {
+                path: rel2,
                 operation: "created",
                 linesChanged: lines2
               });
@@ -1131,8 +1131,8 @@ function parseTranscript(transcriptPath, sessionId, projectPath) {
         if (tool.name === "Edit" && succeeded) {
           const filePath = tool.input.file_path;
           if (filePath && isFilePath(filePath)) {
-            const rel = relativePath(filePath, projectPath);
-            const existing = filesMap.get(rel);
+            const rel2 = relativePath(filePath, projectPath);
+            const existing = filesMap.get(rel2);
             const oldStr = tool.input.old_string;
             const newStr = tool.input.new_string;
             const lines2 = Math.max(
@@ -1142,8 +1142,8 @@ function parseTranscript(transcriptPath, sessionId, projectPath) {
             if (existing) {
               existing.linesChanged += lines2;
             } else {
-              filesMap.set(rel, {
-                path: rel,
+              filesMap.set(rel2, {
+                path: rel2,
                 operation: "modified",
                 linesChanged: lines2
               });
@@ -1213,8 +1213,8 @@ function extractBashFileOps(command, filesMap, projectPath) {
   const rmMatches = command.matchAll(/\brm\s+(?:-[rf]+\s+)?([^\s;&|]+\.[a-zA-Z0-9]+)/g);
   for (const m of rmMatches) {
     if (isFilePath(m[1])) {
-      const rel = relativePath(m[1], projectPath);
-      filesMap.set(rel, { path: rel, operation: "deleted", linesChanged: 0 });
+      const rel2 = relativePath(m[1], projectPath);
+      filesMap.set(rel2, { path: rel2, operation: "deleted", linesChanged: 0 });
     }
   }
 }
@@ -1444,7 +1444,7 @@ ${sessionRow.summary}
     md += "\n";
   }
   if (decisions.length > 0) {
-    md += "## Decisions\n";
+    md += "## Architecture log\n";
     for (const d of decisions) {
       md += `- ${d.description}`;
       if (d.rationale) md += ` \u2014 ${d.rationale}`;
@@ -1569,7 +1569,7 @@ async function reportCommand(options) {
   console.log(chalk9.green(`
   \u2713 SESSION_REPORT.md written (session ${session.id})
 `));
-  console.log(chalk9.gray(`  ${files.length} files \xB7 ${decisions.length} decisions \xB7 ${completedFeatures.length} features completed`));
+  console.log(chalk9.gray(`  ${files.length} files \xB7 ${decisions.length} arch log entries \xB7 ${completedFeatures.length} features completed`));
   console.log("");
 }
 
@@ -1640,7 +1640,7 @@ async function healthCommand() {
   const decMark = decisionCount > 0 ? "\u2705" : "\u26A0\uFE0F ";
   const decColor = decisionCount > 0 ? chalk10.green : chalk10.yellow;
   console.log(
-    `  ${decMark} Decisions   ${decColor(decisionCount + " documented")}` + chalk10.gray(`  +${decisionScore}pts`)
+    `  ${decMark} Arch log    ${decColor(decisionCount + " entries")}` + chalk10.gray(`  +${decisionScore}pts`)
   );
   const claimMark = staleClaims === 0 ? "\u2705" : "\u26A0\uFE0F ";
   const claimColor = staleClaims === 0 ? chalk10.green : chalk10.red;
@@ -1656,7 +1656,7 @@ async function healthCommand() {
   const recommendations = [];
   if (testFiles === 0) recommendations.push("Write tests before your next feature (0 test files found).");
   if (staleClaims > 0) recommendations.push(`Release ${staleClaims} stale claim(s) with groundctl complete <feature>.`);
-  if (decisionCount === 0) recommendations.push("Document decisions during sessions so agents have context.");
+  if (decisionCount === 0) recommendations.push("Log architecture decisions during sessions so agents understand the why.");
   if (featurePct < 0.5 && total > 0) recommendations.push(`${counts.pending} features pending \u2014 run groundctl next to pick one.`);
   if (recommendations.length > 0) {
     console.log(chalk10.bold("  Recommendations:"));
@@ -1668,35 +1668,180 @@ async function healthCommand() {
 }
 
 // src/commands/dashboard.ts
-import { existsSync as existsSync5 } from "fs";
+import { createServer } from "http";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
 import { join as join7, dirname as dirname2 } from "path";
-import { fileURLToPath } from "url";
-import { spawn } from "child_process";
+import { exec } from "child_process";
 import chalk11 from "chalk";
-var __dirname = dirname2(fileURLToPath(import.meta.url));
-async function dashboardCommand(options) {
-  const port = options.port ?? "4242";
-  const serverPath = join7(__dirname, "..", "..", "..", "dashboard", "src", "server.js");
-  if (!existsSync5(serverPath)) {
-    console.log(chalk11.red(`
-  Dashboard server not found at: ${serverPath}
-`));
-    console.log(chalk11.gray("  If running from source: npm run build"));
-    return;
+import initSqlJs2 from "sql.js";
+function findDbPath(startDir = process.cwd()) {
+  let dir = startDir;
+  for (let i = 0; i < 10; i++) {
+    const candidate = join7(dir, ".groundctl", "db.sqlite");
+    if (existsSync5(candidate)) return candidate;
+    const parent = dirname2(dir);
+    if (parent === dir) break;
+    dir = parent;
   }
-  console.log(chalk11.bold(`
-  groundctl dashboard \u2192 http://localhost:${port}
-`));
-  console.log(chalk11.gray("  Auto-refreshes every 10s. Press Ctrl+C to stop.\n"));
-  const child = spawn(process.execPath, [serverPath], {
-    stdio: "inherit",
-    env: { ...process.env, GROUNDCTL_PORT: port }
+  return null;
+}
+async function readDb(dbPath) {
+  const SQL = await initSqlJs2();
+  const buffer = readFileSync5(dbPath);
+  const db = new SQL.Database(buffer);
+  function q(sql, params = []) {
+    const stmt = db.prepare(sql);
+    stmt.bind(params);
+    const rows = [];
+    while (stmt.step()) rows.push(stmt.getAsObject());
+    stmt.free();
+    return rows;
+  }
+  const features = q("SELECT * FROM features ORDER BY CASE status WHEN 'in_progress' THEN 0 WHEN 'pending' THEN 1 ELSE 2 END, CASE priority WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 ELSE 3 END");
+  const sessions = q("SELECT * FROM sessions ORDER BY started_at DESC LIMIT 20");
+  const claims = q("SELECT c.*, f.name as feature_name FROM claims c JOIN features f ON c.feature_id = f.id WHERE c.released_at IS NULL");
+  const decisions = q("SELECT d.*, s.id as sess FROM decisions d JOIN sessions s ON d.session_id = s.id ORDER BY d.id DESC LIMIT 30");
+  const files = q("SELECT * FROM files_modified ORDER BY id DESC LIMIT 100");
+  const total = features.length;
+  const done = features.filter((f) => f.status === "done").length;
+  const pct = total > 0 ? Math.round(done / total * 100) : 0;
+  const testFiles = files.filter((f) => /\.(test|spec)\./.test(f.path) || f.path.includes("__tests__")).length;
+  const decCount = decisions.length;
+  const stale = claims.filter((c) => Date.now() - new Date(c.claimed_at).getTime() > 864e5).length;
+  const health = Math.min(100, Math.round(
+    done / Math.max(1, total) * 40 + (testFiles > 0 ? Math.min(20, testFiles * 5) : 0) + (decCount > 0 ? Math.min(20, decCount * 2) : 0) + (stale === 0 ? 10 : 0)
+  ));
+  db.close();
+  return { features, sessions, claims, decisions, files, meta: { total, done, pct, health, testFiles, decCount, stale } };
+}
+function bar(done, total, w = 20) {
+  const n = total > 0 ? Math.round(done / total * w) : 0;
+  return "\u2588".repeat(n) + "\u2591".repeat(w - n);
+}
+function esc(s) {
+  return String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function rel(ts) {
+  if (!ts) return "\u2014";
+  const m = Math.floor((Date.now() - new Date(ts).getTime()) / 6e4);
+  if (m < 1) return "just now";
+  if (m < 60) return `${m}m ago`;
+  const h = Math.floor(m / 60);
+  if (h < 24) return `${h}h ago`;
+  return `${Math.floor(h / 24)}d ago`;
+}
+function renderHtml(data, projectName, dbPath) {
+  const { features, sessions, claims, decisions, files, meta } = data;
+  const sc = meta.pct >= 70 ? "#4ade80" : meta.pct >= 40 ? "#facc15" : "#f87171";
+  const hc = meta.health >= 70 ? "#4ade80" : meta.health >= 40 ? "#facc15" : "#f87171";
+  const claimRows = claims.length ? claims.map((c) => `<div class="claim-row"><span class="cy">\u25CF</span><span class="cn">${esc(c.feature_name)}</span><span class="cd">session ${esc(c.session_id)}</span><span class="cb">${rel(c.claimed_at)}</span></div>`).join("") : `<div class="empty">No active claims</div>`;
+  const featRows = features.map((f) => {
+    const cls = f.status === "done" ? "done" : f.status === "in_progress" ? "active" : "pend";
+    const icon = f.status === "done" ? "\u2713" : f.status === "in_progress" ? "\u25CF" : "\u25CB";
+    return `<div class="fr ${cls}"><span class="fi">${icon}</span><span class="fn">${esc(f.name)}</span><span class="fp p-${esc(f.priority)}">${esc(f.priority)}</span><span class="fs">${esc(f.status)}</span></div>`;
+  }).join("");
+  const sessRows = sessions.length ? sessions.map((s) => {
+    const fc = files.filter((f) => f.session_id === s.id).length;
+    const dc = decisions.filter((d) => d.session_id === s.id).length;
+    return `<div class="sr"><span class="si">${esc(s.id)}</span><span class="sd">${s.ended_at ? "\u25CF" : "\u25CC"}</span><span class="ss">${esc((s.summary ?? "").slice(0, 80))}</span><span class="sm">${fc} files \xB7 ${dc} dec \xB7 ${rel(s.started_at)}</span></div>`;
+  }).join("") : `<div class="empty">No sessions yet</div>`;
+  const decRows = decisions.slice(0, 10).length ? decisions.slice(0, 10).map((d) => `<div class="dr"><span class="di">${esc(d.sess)}</span><span class="dt">${esc(d.description.slice(0, 100))}</span>${d.rationale ? `<span class="dra">${esc(d.rationale.slice(0, 80))}</span>` : ""}</div>`).join("") : `<div class="empty">No decisions documented yet</div>`;
+  return `<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${esc(projectName)} \u2014 groundctl</title><meta http-equiv="refresh" content="10">
+<style>
+:root{--bg:#0a0a0a;--b2:#111;--b3:#1a1a1a;--br:#222;--tx:#e0e0e0;--dm:#666;--md:#999;--gn:#4ade80;--yw:#facc15;--bl:#60a5fa;--rd:#f87171;--mo:"Berkeley Mono","IBM Plex Mono","Fira Code",ui-monospace,monospace}
+*{box-sizing:border-box;margin:0;padding:0}
+body{background:var(--bg);color:var(--tx);font-family:var(--mo);font-size:13px;line-height:1.6}
+.layout{display:grid;grid-template-columns:280px 1fr;min-height:100vh}
+.sidebar{border-right:1px solid var(--br);padding:24px 20px;display:flex;flex-direction:column;gap:28px}
+.main{padding:24px;display:flex;flex-direction:column;gap:20px;overflow:auto}
+.pn{font-size:1.1rem;font-weight:700;color:#fff;margin-bottom:4px}
+.pc{color:${sc};font-size:.9rem;margin-bottom:8px}
+.pb{font-size:.85rem;color:var(--gn);letter-spacing:.5px;margin-bottom:4px}
+.ps{font-size:.75rem;color:var(--dm)}
+.hl{font-size:.7rem;color:var(--dm);text-transform:uppercase;letter-spacing:.08em}
+.hs{font-size:1.8rem;font-weight:700;color:${hc}}
+.hi{margin-top:10px;display:flex;flex-direction:column;gap:4px}
+.hi>div{font-size:.8rem;color:var(--md);display:flex;gap:8px}
+.ok{color:var(--gn)}.warn{color:var(--yw)}.bad{color:var(--rd)}
+.sec{background:var(--b2);border:1px solid var(--br);border-radius:8px;overflow:hidden}
+.sh{padding:10px 16px;border-bottom:1px solid var(--br);font-size:.7rem;text-transform:uppercase;letter-spacing:.1em;color:var(--dm);display:flex;justify-content:space-between}
+.sc{background:var(--b3);border-radius:4px;padding:1px 6px;font-size:.7rem;color:var(--md)}
+.claim-row{display:flex;align-items:center;gap:10px;padding:10px 16px;border-bottom:1px solid var(--br)}
+.claim-row:last-child{border-bottom:none}
+.cy{color:var(--yw)}.cn{flex:1;color:#fff}.cd{color:var(--dm);font-size:.8rem}.cb{color:var(--bl);font-size:.8rem}
+.fr{display:grid;grid-template-columns:20px 1fr 70px 90px;gap:8px;padding:8px 16px;border-bottom:1px solid var(--br);align-items:center}
+.fr:last-child{border-bottom:none}
+.done{opacity:.45}.active{background:rgba(250,204,21,.04)}
+.done .fi{color:var(--gn)}.active .fi{color:var(--yw)}.pend .fi{color:var(--dm)}
+.fn{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.fp{font-size:.75rem;text-align:right}.fs{font-size:.75rem;color:var(--dm);text-align:right}
+.p-critical{color:var(--rd)}.p-high{color:var(--yw)}.p-medium{color:var(--md)}.p-low{color:var(--dm)}
+.sr{display:grid;grid-template-columns:60px 16px 1fr auto;gap:8px;padding:10px 16px;border-bottom:1px solid var(--br);align-items:start}
+.sr:last-child{border-bottom:none}
+.si{color:var(--bl);font-weight:600;font-size:.85rem}.sd{color:var(--gn)}.ss{color:var(--md);font-size:.8rem;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.sm{color:var(--dm);font-size:.75rem;white-space:nowrap;text-align:right}
+.dr{padding:10px 16px;border-bottom:1px solid var(--br);display:grid;grid-template-columns:50px 1fr;gap:8px}
+.dr:last-child{border-bottom:none}
+.di{color:var(--bl);font-size:.8rem}.dt{color:var(--tx);font-size:.8rem}.dra{grid-column:2;font-size:.75rem;color:var(--dm);font-style:italic}
+.empty{padding:16px;color:var(--dm);font-size:.85rem;text-align:center}
+.rn{font-size:.7rem;color:var(--dm);text-align:center;padding-top:8px}
+.top{display:grid;grid-template-columns:1fr 1fr;gap:16px}
+@media(max-width:800px){.layout{grid-template-columns:1fr}.sidebar{border-right:none;border-bottom:1px solid var(--br)}.top{grid-template-columns:1fr}}
+</style></head><body>
+<div class="layout">
+<aside class="sidebar">
+  <div><div class="pn">${esc(projectName)}</div><div class="pc">${meta.pct}% implemented</div><div class="pb">${bar(meta.done, meta.total)}</div><div class="ps">${meta.done}/${meta.total} features done</div></div>
+  <div><div class="hl">Health Score</div><div class="hs">${meta.health}<span style="font-size:1rem;color:var(--dm)">/100</span></div>
+  <div class="hi">
+    <div><span class="${meta.done > 0 ? "ok" : "warn"}">${meta.done > 0 ? "\u2713" : "\u26A0"}</span><span>Features ${meta.done}/${meta.total}</span></div>
+    <div><span class="${meta.testFiles > 0 ? "ok" : "bad"}">${meta.testFiles > 0 ? "\u2713" : "\u2717"}</span><span>Tests ${meta.testFiles} files</span></div>
+    <div><span class="${meta.decCount > 0 ? "ok" : "warn"}">${meta.decCount > 0 ? "\u2713" : "\u26A0"}</span><span>Architecture log ${meta.decCount} entries</span></div>
+    <div><span class="${meta.stale === 0 ? "ok" : "bad"}">${meta.stale === 0 ? "\u2713" : "\u2717"}</span><span>Claims ${meta.stale > 0 ? meta.stale + " stale" : "healthy"}</span></div>
+  </div></div>
+  <div class="rn">auto-refresh 10s<br><span style="color:var(--br)">${esc(dbPath.split("/").slice(-3).join("/"))}</span></div>
+</aside>
+<main class="main">
+  <div class="sec"><div class="sh"><span>Claims live</span><span class="sc">${claims.length}</span></div>${claimRows}</div>
+  <div class="top">
+    <div class="sec"><div class="sh"><span>Features</span><span class="sc">${features.length}</span></div>${featRows}</div>
+    <div class="sec"><div class="sh"><span>Session timeline</span><span class="sc">${sessions.length}</span></div>${sessRows}</div>
+  </div>
+  <div class="sec"><div class="sh"><span>Recent decisions</span><span class="sc">${decisions.length}</span></div>${decRows}</div>
+</main>
+</div></body></html>`;
+}
+async function dashboardCommand(options) {
+  const port = parseInt(options.port ?? "4242");
+  const server = createServer(async (req, res) => {
+    if (req.url !== "/" && req.url !== "") {
+      res.writeHead(404);
+      res.end("Not found");
+      return;
+    }
+    const dbPath = findDbPath();
+    if (!dbPath) {
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end(`<!DOCTYPE html><html><body style="background:#0a0a0a;color:#e0e0e0;font-family:monospace;padding:40px"><h2>groundctl</h2><p style="color:#f87171">No .groundctl/db.sqlite found.</p><p>Run: <code>groundctl init</code></p></body></html>`);
+      return;
+    }
+    try {
+      const data = await readDb(dbPath);
+      const name = process.cwd().split("/").pop() ?? "project";
+      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+      res.end(renderHtml(data, name, dbPath));
+    } catch (err) {
+      res.writeHead(500, { "Content-Type": "text/plain" });
+      res.end(`Error: ${err.message}`);
+    }
   });
-  child.on("error", (err) => {
-    console.error(chalk11.red(`  Error: ${err.message}`));
+  server.listen(port, "127.0.0.1", () => {
+    console.log(chalk11.bold(`
+  groundctl dashboard \u2192 `) + chalk11.blue(`http://localhost:${port}`) + "\n");
+    console.log(chalk11.gray("  Auto-refreshes every 10s. Press Ctrl+C to stop.\n"));
+    exec(`open http://localhost:${port} 2>/dev/null || xdg-open http://localhost:${port} 2>/dev/null || true`);
   });
-  await new Promise((resolve2) => {
-    child.on("close", () => resolve2());
+  await new Promise((_, reject) => {
+    server.on("error", reject);
   });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundctl/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Product memory for AI agent builders",
   "license": "MIT",
   "bin": {