@groundctl/cli 0.3.0 → 0.3.2

package/dist/index.js

@@ -98,6 +98,15 @@ function applySchema(db) {
   db.run("CREATE INDEX IF NOT EXISTS idx_claims_active ON claims(feature_id) WHERE released_at IS NULL");
   db.run("CREATE INDEX IF NOT EXISTS idx_files_session ON files_modified(session_id)");
   db.run("CREATE INDEX IF NOT EXISTS idx_decisions_session ON decisions(session_id)");
+  const tryAlter = (sql) => {
+    try {
+      db.run(sql);
+    } catch {
+    }
+  };
+  tryAlter("ALTER TABLE features ADD COLUMN progress_done  INTEGER");
+  tryAlter("ALTER TABLE features ADD COLUMN progress_total INTEGER");
+  tryAlter("ALTER TABLE features ADD COLUMN items          TEXT");
   db.run(
     "INSERT OR REPLACE INTO meta (key, value) VALUES ('schema_version', ?)",
     [String(SCHEMA_VERSION)]
@@ -628,49 +637,87 @@ groundctl init \u2014 ${projectName}
 
 // src/commands/status.ts
 import chalk2 from "chalk";
-function progressBar(done, total, width = 20) {
-  if (total === 0) return chalk2.gray("\u2591".repeat(width));
-  const filled = Math.round(done / total * width);
-  const empty = width - filled;
-  return chalk2.green("\u2588".repeat(filled)) + chalk2.gray("\u2591".repeat(empty));
+var BAR_W = 14;
+var NAME_W = 22;
+var PROG_W = 6;
+function progressBar(done, total, width) {
+  if (total <= 0) return chalk2.gray("\u2591".repeat(width));
+  const filled = Math.min(width, Math.round(done / total * width));
+  return chalk2.green("\u2588".repeat(filled)) + chalk2.gray("\u2591".repeat(width - filled));
+}
+function featureBar(status, progressDone, progressTotal) {
+  if (progressTotal != null && progressTotal > 0) {
+    return progressBar(progressDone ?? 0, progressTotal, BAR_W);
+  }
+  switch (status) {
+    case "done":
+      return progressBar(1, 1, BAR_W);
+    case "in_progress":
+      return progressBar(1, 2, BAR_W);
+    case "blocked":
+      return chalk2.red("\u2591".repeat(BAR_W));
+    default:
+      return chalk2.gray("\u2591".repeat(BAR_W));
+  }
+}
+function featureProgress(progressDone, progressTotal) {
+  if (progressDone != null && progressTotal != null) {
+    return `${progressDone}/${progressTotal}`;
+  }
+  return "";
+}
+function wrapItems(itemsCsv, maxWidth) {
+  const items = itemsCsv.split(",").map((s) => s.trim()).filter(Boolean);
+  const lines = [];
+  let current = "";
+  for (const item of items) {
+    const next = current ? `${current} \xB7 ${item}` : item;
+    if (next.length > maxWidth && current.length > 0) {
+      lines.push(current);
+      current = item;
+    } else {
+      current = next;
+    }
+  }
+  if (current) lines.push(current);
+  return lines;
+}
+function timeSince(isoDate) {
+  const then = (/* @__PURE__ */ new Date(isoDate + "Z")).getTime();
+  const ms = Date.now() - then;
+  const mins = Math.floor(ms / 6e4);
+  if (mins < 60) return `${mins}m`;
+  const h = Math.floor(mins / 60);
+  const m = mins % 60;
+  return `${h}h${m > 0 ? String(m).padStart(2, "0") : ""}`;
 }
 async function statusCommand() {
   const db = await openDb();
   const projectName = process.cwd().split("/").pop() ?? "unknown";
-  const statusCounts = query(
-    db,
-    "SELECT status, COUNT(*) as count FROM features GROUP BY status"
-  );
-  const counts = {
-    pending: 0,
-    in_progress: 0,
-    done: 0,
-    blocked: 0
-  };
-  for (const row of statusCounts) {
-    counts[row.status] = row.count;
-  }
-  const total = counts.pending + counts.in_progress + counts.done + counts.blocked;
-  const activeClaims = query(
-    db,
-    `SELECT c.feature_id, f.name as feature_name, c.session_id, c.claimed_at
-     FROM claims c
-     JOIN features f ON c.feature_id = f.id
-     WHERE c.released_at IS NULL`
-  );
-  const available = query(
+  const features = query(
     db,
-    `SELECT f.id, f.name, f.priority
+    `SELECT
+       f.id, f.name, f.status, f.priority,
+       f.description, f.progress_done, f.progress_total, f.items,
+       c.session_id  AS claimed_session,
+       c.claimed_at  AS claimed_at
      FROM features f
-     WHERE f.status = 'pending'
-     AND f.id NOT IN (SELECT feature_id FROM claims WHERE released_at IS NULL)
+     LEFT JOIN claims c
+       ON c.feature_id = f.id AND c.released_at IS NULL
      ORDER BY
+       CASE f.status
+         WHEN 'in_progress' THEN 0
+         WHEN 'blocked'     THEN 1
+         WHEN 'pending'     THEN 2
+         WHEN 'done'        THEN 3
+       END,
        CASE f.priority
          WHEN 'critical' THEN 0
-         WHEN 'high' THEN 1
-         WHEN 'medium' THEN 2
-         WHEN 'low' THEN 3
-       END`
+         WHEN 'high'     THEN 1
+         WHEN 'medium'   THEN 2
+         WHEN 'low'      THEN 3
+       END,
+       f.created_at`
   );
   const sessionCount = queryOne(
     db,
@@ -678,59 +725,63 @@ async function statusCommand() {
   )?.count ?? 0;
   closeDb();
   console.log("");
-  if (total === 0) {
+  if (features.length === 0) {
     console.log(chalk2.bold(`  ${projectName} \u2014 no features tracked yet
 `));
     console.log(chalk2.gray("  Add features with: groundctl add feature -n 'my-feature'"));
     console.log(chalk2.gray("  Then run: groundctl status\n"));
     return;
   }
-  const pct = total > 0 ? Math.round(counts.done / total * 100) : 0;
+  const total = features.length;
+  const done = features.filter((f) => f.status === "done").length;
+  const inProg = features.filter((f) => f.status === "in_progress").length;
+  const blocked = features.filter((f) => f.status === "blocked").length;
+  const pct = Math.round(done / total * 100);
   console.log(
-    chalk2.bold(`  ${projectName} \u2014 ${pct}% implemented`) + chalk2.gray(` (${sessionCount} sessions)`)
+    chalk2.bold(`  ${projectName} \u2014 ${pct}% implemented`) + chalk2.gray(` (${sessionCount} session${sessionCount !== 1 ? "s" : ""})`)
   );
   console.log("");
-  console.log(
-    `  Features  ${progressBar(counts.done, total)}  ${counts.done}/${total} done`
-  );
-  if (counts.in_progress > 0) {
-    console.log(chalk2.yellow(`            ${counts.in_progress} in progress`));
-  }
-  if (counts.blocked > 0) {
-    console.log(chalk2.red(`            ${counts.blocked} blocked`));
-  }
+  const aggBar = progressBar(done, total, 20);
+  let aggSuffix = chalk2.white(`  ${done}/${total} done`);
+  if (inProg > 0) aggSuffix += chalk2.yellow(`  ${inProg} in progress`);
+  if (blocked > 0) aggSuffix += chalk2.red(`  ${blocked} blocked`);
+  console.log(`  Features  ${aggBar}${aggSuffix}`);
   console.log("");
-  if (activeClaims.length > 0) {
-    console.log(chalk2.bold("  Claimed:"));
-    for (const claim of activeClaims) {
-      const elapsed = timeSince(claim.claimed_at);
-      console.log(
-        chalk2.yellow(`    \u25CF ${claim.feature_name} \u2192 session ${claim.session_id} (${elapsed})`)
-      );
+  const maxNameLen = Math.min(NAME_W, Math.max(...features.map((f) => f.name.length)));
+  const nameW = Math.max(maxNameLen, 12);
+  const contIndent = " ".repeat(4 + nameW + 1);
+  const itemsMaxW = Math.max(40, 76 - contIndent.length);
+  for (const f of features) {
+    const isDone = f.status === "done";
+    const isActive = f.status === "in_progress";
+    const isBlocked = f.status === "blocked";
+    const icon = isDone ? "\u2713" : isActive ? "\u25CF" : isBlocked ? "\u2717" : "\u25CB";
+    const iconChalk = isDone ? chalk2.green : isActive ? chalk2.yellow : isBlocked ? chalk2.red : chalk2.gray;
+    const nameRaw = f.name.slice(0, nameW).padEnd(nameW);
+    const nameChalk = isDone ? chalk2.dim : isActive ? chalk2.white : isBlocked ? chalk2.red : chalk2.gray;
+    const pd = f.progress_done ?? null;
+    const pt = f.progress_total ?? null;
+    const bar2 = featureBar(f.status, pd, pt);
+    const prog = featureProgress(pd, pt).padEnd(PROG_W);
+    const descRaw = f.description ?? "";
+    const descTrunc = descRaw.length > 38 ? descRaw.slice(0, 36) + "\u2026" : descRaw;
+    const descStr = descTrunc ? chalk2.gray(`  ${descTrunc}`) : "";
+    let claimedStr = "";
+    if (isActive && f.claimed_session) {
+      const elapsed = f.claimed_at ? timeSince(f.claimed_at) : "";
+      claimedStr = chalk2.yellow(` \u2192 ${f.claimed_session}${elapsed ? ` (${elapsed})` : ""}`);
     }
-    console.log("");
-  }
-  if (available.length > 0) {
-    console.log(chalk2.bold("  Available:"));
-    for (const feat of available.slice(0, 5)) {
-      const pColor = feat.priority === "critical" || feat.priority === "high" ? chalk2.red : chalk2.gray;
-      console.log(`    \u25CB ${feat.name} ${pColor(`(${feat.priority})`)}`);
-    }
-    if (available.length > 5) {
-      console.log(chalk2.gray(`    ... and ${available.length - 5} more`));
+    console.log(
+      `  ${iconChalk(icon)} ${nameChalk(nameRaw)} ${bar2}  ${prog}${descStr}${claimedStr}`
+    );
+    if (f.items) {
+      const lines = wrapItems(f.items, itemsMaxW);
+      for (const line of lines) {
+        console.log(chalk2.dim(`${contIndent}${line}`));
+      }
     }
-    console.log("");
   }
-}
-function timeSince(isoDate) {
-  const then = (/* @__PURE__ */ new Date(isoDate + "Z")).getTime();
-  const now = Date.now();
-  const diffMs = now - then;
-  const mins = Math.floor(diffMs / 6e4);
-  if (mins < 60) return `${mins}m`;
-  const hours = Math.floor(mins / 60);
-  const remainMins = mins % 60;
-  return `${hours}h${remainMins > 0 ? String(remainMins).padStart(2, "0") : ""}`;
+  console.log("");
 }
 
 // src/commands/claim.ts
@@ -1008,6 +1059,11 @@ async function logCommand(options) {
 // src/commands/add.ts
 import chalk7 from "chalk";
 import { randomUUID as randomUUID2 } from "crypto";
+function parseProgress(s) {
+  const m = s.match(/^(\d+)\/(\d+)$/);
+  if (!m) return null;
+  return { done: parseInt(m[1], 10), total: parseInt(m[2], 10) };
+}
 async function addCommand(type, options) {
   const db = await openDb();
   if (type === "feature") {
@@ -1018,14 +1074,40 @@ async function addCommand(type, options) {
     }
     const id = options.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
     const priority = options.priority ?? "medium";
+    let progressDone = null;
+    let progressTotal = null;
+    if (options.progress) {
+      const p = parseProgress(options.progress);
+      if (p) {
+        progressDone = p.done;
+        progressTotal = p.total;
+      } else {
+        console.log(chalk7.yellow(`  \u26A0  --progress "${options.progress}" ignored (expected N/N format)`));
+      }
+    }
+    const items = options.items ? options.items.split(",").map((s) => s.trim()).filter(Boolean).join(",") : null;
     db.run(
-      "INSERT INTO features (id, name, priority, description) VALUES (?, ?, ?, ?)",
-      [id, options.name, priority, options.description ?? null]
+      `INSERT INTO features
+         (id, name, priority, description, progress_done, progress_total, items)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        options.name,
+        priority,
+        options.description ?? null,
+        progressDone,
+        progressTotal,
+        items
+      ]
     );
     saveDb();
     closeDb();
+    const extras = [];
+    if (progressDone !== null) extras.push(`${progressDone}/${progressTotal}`);
+    if (items) extras.push(`${items.split(",").length} items`);
+    const suffix = extras.length ? chalk7.gray(` \u2014 ${extras.join(", ")}`) : "";
     console.log(chalk7.green(`
-  \u2713 Feature added: ${options.name} (${priority})
+  \u2713 Feature added: ${options.name} (${priority})${suffix}
 `));
   } else if (type === "session") {
     const id = options.name ?? randomUUID2().slice(0, 8);
@@ -2092,6 +2174,82 @@ async function watchCommand(options) {
   });
 }
 
+// src/commands/update.ts
+import chalk13 from "chalk";
+function parseProgress2(s) {
+  const m = s.match(/^(\d+)\/(\d+)$/);
+  if (!m) return null;
+  return { done: parseInt(m[1], 10), total: parseInt(m[2], 10) };
+}
+async function updateCommand(type, nameOrId, options) {
+  if (type !== "feature") {
+    console.log(chalk13.red(`
+  Unknown type "${type}". Use "feature".
+`));
+    process.exit(1);
+  }
+  const db = await openDb();
+  const feature = queryOne(
+    db,
+    `SELECT id, name FROM features
+     WHERE id = ?1 OR name = ?1
+     OR id LIKE ?2 OR name LIKE ?2
+     ORDER BY CASE WHEN id = ?1 OR name = ?1 THEN 0 ELSE 1 END
+     LIMIT 1`,
+    [nameOrId, `%${nameOrId}%`]
+  );
+  if (!feature) {
+    console.log(chalk13.red(`
+  Feature "${nameOrId}" not found.
+`));
+    closeDb();
+    process.exit(1);
+  }
+  const sets = [];
+  const params = [];
+  if (options.description !== void 0) {
+    sets.push("description = ?");
+    params.push(options.description);
+  }
+  if (options.items !== void 0) {
+    const items = options.items.split(",").map((s) => s.trim()).filter(Boolean).join(",");
+    sets.push("items = ?");
+    params.push(items);
+  }
+  if (options.progress !== void 0) {
+    const p = parseProgress2(options.progress);
+    if (!p) {
+      console.log(chalk13.yellow(`  \u26A0  --progress "${options.progress}" ignored (expected N/N format)
+`));
+    } else {
+      sets.push("progress_done = ?", "progress_total = ?");
+      params.push(p.done, p.total);
+    }
+  }
+  if (options.priority !== void 0) {
+    sets.push("priority = ?");
+    params.push(options.priority);
+  }
+  if (options.status !== void 0) {
+    sets.push("status = ?");
+    params.push(options.status);
+  }
+  if (sets.length === 0) {
+    console.log(chalk13.yellow("\n  Nothing to update \u2014 pass at least one option.\n"));
+    closeDb();
+    return;
+  }
+  sets.push("updated_at = datetime('now')");
+  params.push(feature.id);
+  db.run(
+    `UPDATE features SET ${sets.join(", ")} WHERE id = ?`,
+    params
+  );
+  saveDb();
+  closeDb();
+  console.log(chalk13.green(`  \u2713 Updated: ${feature.name}`));
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
@@ -2104,7 +2262,7 @@ program.command("complete <feature>").description("Mark a feature as done and re
 program.command("sync").description("Regenerate PROJECT_STATE.md and AGENTS.md from SQLite").action(syncCommand);
 program.command("next").description("Show next available (unclaimed) feature").action(nextCommand);
 program.command("log").description("Show session timeline").option("-s, --session <id>", "Show details for a specific session").action(logCommand);
-program.command("add <type>").description("Add a feature or session (type: feature, session)").option("-n, --name <name>", "Name").option("-p, --priority <priority>", "Priority (critical, high, medium, low)").option("-d, --description <desc>", "Description").option("--agent <agent>", "Agent type for sessions").action(addCommand);
+program.command("add <type>").description("Add a feature or session (type: feature, session)").option("-n, --name <name>", "Name").option("-p, --priority <priority>", "Priority (critical, high, medium, low)").option("-d, --description <desc>", "Description").option("--agent <agent>", "Agent type for sessions").option("--items <items>", "Comma-separated list of sub-items (features only)").option("--progress <N/N>", "Progress fraction e.g. 11/11 (features only)").action(addCommand);
 program.command("ingest").description("Parse a transcript and write session data to SQLite").option("--source <source>", "Source agent (claude-code, codex)", "claude-code").option("--session-id <id>", "Session ID").option("--transcript <path>", "Path to transcript JSONL file (auto-detected if omitted)").option("--project-path <path>", "Project path (defaults to cwd)").option("--no-sync", "Skip regenerating markdown after ingest").action(
   (opts) => ingestCommand({
     source: opts.source,
@@ -2123,4 +2281,13 @@ program.command("watch").description("Watch for session end and auto-ingest tran
     projectPath: opts.projectPath
   })
 );
+program.command("update <type> <name>").description("Update a feature's description, items, progress, or priority").option("-d, --description <desc>", "New description").option("--items <items>", "Comma-separated sub-items").option("--progress <N/N>", "Progress fraction e.g. 3/5").option("-p, --priority <priority>", "New priority").option("--status <status>", "New status (pending|in_progress|done|blocked)").action(
+  (type, name, opts) => updateCommand(type, name, {
+    description: opts.description,
+    items: opts.items,
+    progress: opts.progress,
+    priority: opts.priority,
+    status: opts.status
+  })
+);
 program.parse();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@groundctl/cli",
-  "version": "0.3.0",
-  "description": "Product memory for AI agent builders",
+  "version": "0.3.2",
+  "description": "Always know what to build next.",
   "license": "MIT",
   "bin": {
     "groundctl": "dist/index.js"