@unpolarize/knowledge-planning 0.1.0 → 0.2.0

package/dist/cli.js

@@ -0,0 +1,385 @@
+#!/usr/bin/env node
+import {
+  PlanningIndex,
+  Store,
+  cmdBlocked,
+  cmdCalendar,
+  cmdCapture,
+  cmdCreate,
+  cmdDaily,
+  cmdDelete,
+  cmdDeriveProjects,
+  cmdDeriveSessions,
+  cmdDoctor,
+  cmdEdit,
+  cmdExport,
+  cmdGraph,
+  cmdIngestGdoc,
+  cmdIngestThoughts,
+  cmdInsightIngest,
+  cmdLabelSessions,
+  cmdLinkSession,
+  cmdList,
+  cmdLookback,
+  cmdPromote,
+  cmdRecategorize,
+  cmdReindex,
+  cmdResearch,
+  cmdSetDue,
+  cmdSetPriority,
+  cmdSetProject,
+  cmdSetStatus,
+  cmdShow,
+  today
+} from "./chunk-6GL2IYUE.js";
+
+// src/cli/index.ts
+import { homedir } from "os";
+import { join, resolve, basename, dirname } from "path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+var HELP = `KP (knowledge-planning) \u2014 durable, git-backed life-wide planning over a markdown SSOT
+Prefer "KP" in product language; this CLI bin is \`kp\`; package/repo slug is knowledge-planning.
+
+Usage: kp <command> [options]
+
+  reindex                         Rebuild the .index/planning.db projection
+  list [--type T] [--status S] [--project P]  List objects (idea/plan/task/...)
+  daily [--date today|YYYY-MM-DD] [--carry-over]   Render the daily board
+  board                           Alias for 'daily'
+  blocked                         Show objects blocked_by unresolved knowledge
+  graph [--json]                  Graph data (nodes/edges) for the CSV webview
+  capture "<text>" [--domain D]   Quick-capture an idea (status=capture)
+  promote <ideaId> [--to planId]  Promote an idea to a plan
+  link-session <objectId> <uuid>  Bidirectional session link (+planning_refs)
+  insight <file> --source S       Ingest digest/brief bullets into an Insight
+  ingest-gdoc [<file>] [--domain D] [--max N] [--source-url U]  Diff-ingest NEW Google-Doc bullets \u2192
+                                  capture ideas/inbox tasks (baselines on first run, caps per run)
+  ingest-thoughts [<file>] [--max N] [--source S] [--source-url U] [--all]  Diff-ingest NEW prose
+                                  paragraphs \u2192 thoughts/ (status new; --all backfills the whole doc)
+  set-status <objectId> <status> [--note N]  Change status; --note appends a '## Resolution' section
+  set-due <objectId> <date|->     Set/clear a task's due date (due==today \u21D2 must-have)
+  set-priority <objectId> <p0-p3|->  Set/clear priority (p0 highest)
+  set-project <objectId> <project|->  Tag with KP project (projects/slug, CS/CSV/CB/KP, or '-' clear)
+  create "<title>" [--type T --status S --domain D --project P --priority P --due DATE]
+  calendar [--from D] [--to D]    Tasks by due date (default: today \u2192 +14d)
+  serve [--port 4622]             Standalone web dashboard: board \xB7 calendar (month/week/day) \xB7 topics \xB7 lookback
+  lookback [<date>|today]         What was I up to that day: sessions + tasks touched + plan
+  derive-sessions                 Re-analyze ALL captured sessions \u2192 advisory insight (topics/tasks/ideas)
+  derive-projects [--dry-run] [--force]  Heuristic project labels on tasks/ideas/thoughts/plans
+  label-sessions [--dry-run] [--force]   Tag session envelopes with project:<slug> from cwd
+  export [--date today|DATE]      One-shot JSON snapshot (for the CSV planning mode)
+  show <objectId>                 Rich JSON detail (body + resolved refs + children) for the dashboard
+  doctor                          Config, counts, fts, blocked, warnings
+
+Options:
+  --root <path>   Store root (default: package root or $KP_ROOT)
+  --help          This help
+`;
+function addDays(date, n) {
+  const d = /* @__PURE__ */ new Date(`${date}T00:00:00Z`);
+  d.setUTCDate(d.getUTCDate() + n);
+  return d.toISOString().slice(0, 10);
+}
+function getFlag(argv, name) {
+  const i = argv.indexOf(name);
+  if (i >= 0 && i + 1 < argv.length && !argv[i + 1].startsWith("--")) return argv[i + 1];
+  const eq = argv.find((a) => a.startsWith(`${name}=`));
+  return eq ? eq.slice(name.length + 1) : void 0;
+}
+var hasFlag = (argv, name) => argv.includes(name);
+function defaultStoreRoot() {
+  return process.env.KP_ROOT ?? join(homedir(), ".knowledge-planning");
+}
+function resolveRoot(argv) {
+  const flag = getFlag(argv, "--root");
+  if (flag) return resolve(flag);
+  if (process.env.KP_ROOT) return resolve(process.env.KP_ROOT);
+  return defaultStoreRoot();
+}
+function positionals(argv) {
+  const out = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      if (i + 1 < argv.length && !argv[i + 1].startsWith("--") && !a.includes("=")) i++;
+      continue;
+    }
+    out.push(a);
+  }
+  return out;
+}
+function main() {
+  const argv = process.argv.slice(2);
+  const command = argv[0];
+  if (!command || command === "help" || hasFlag(argv, "--help")) {
+    console.log(HELP);
+    return;
+  }
+  const root = resolveRoot(argv);
+  const store = new Store(root);
+  const config = store.config();
+  const rest = positionals(argv).slice(1);
+  const idx = () => new PlanningIndex(store);
+  switch (command) {
+    case "reindex":
+      console.log(cmdReindex(store, root));
+      break;
+    case "list":
+      console.log(
+        cmdList(store, {
+          type: getFlag(argv, "--type"),
+          status: getFlag(argv, "--status"),
+          project: getFlag(argv, "--project")
+        })
+      );
+      break;
+    case "daily":
+    case "board": {
+      const date = getFlag(argv, "--date");
+      console.log(cmdDaily(store, idx(), !date || date === "today" ? today() : date, hasFlag(argv, "--carry-over")));
+      break;
+    }
+    case "blocked":
+      console.log(cmdBlocked(idx(), config.kb_root));
+      break;
+    case "graph":
+      console.log(cmdGraph(store, config.kb_root, hasFlag(argv, "--json")));
+      break;
+    case "capture": {
+      if (!rest[0]) throw new Error('usage: kp capture "<text>" [--domain D]');
+      const res = cmdCapture(store, rest[0], getFlag(argv, "--domain"));
+      console.log(`captured ${res.id}`);
+      break;
+    }
+    case "promote": {
+      if (!rest[0]) throw new Error("usage: kp promote <ideaId> [--to planId]");
+      const res = cmdPromote(store, rest[0], getFlag(argv, "--to"));
+      console.log(`promoted ${res.ideaId} \u2192 ${res.planId}`);
+      break;
+    }
+    case "link-session": {
+      if (!rest[0] || !rest[1]) throw new Error("usage: kp link-session <objectId> <session-uuid>");
+      const res = cmdLinkSession(store, config.sessions_root, rest[0], rest[1]);
+      console.log(
+        `linked ${res.objectId} \u2194 session ${res.uuid}
+  envelope: ${res.envelopePath ? `${res.envelopeUpdated ? "updated" : "already linked"} (${res.envelopePath})` : "not found in " + config.sessions_root}`
+      );
+      break;
+    }
+    case "insight": {
+      if (!rest[0]) throw new Error("usage: kp insight <file> --source S [--ref R]");
+      const text = readFileSync(resolve(rest[0]), "utf8");
+      const res = cmdInsightIngest(store, text, getFlag(argv, "--source") ?? "manual", getFlag(argv, "--ref"));
+      console.log(`created ${res.id} with ${res.suggested} suggested item(s)`);
+      break;
+    }
+    case "export": {
+      const date = getFlag(argv, "--date");
+      console.log(JSON.stringify(cmdExport(store, idx(), config, !date || date === "today" ? today() : date)));
+      break;
+    }
+    case "show": {
+      if (!rest[0]) throw new Error("usage: kp show <objectId>");
+      console.log(JSON.stringify(cmdShow(store, config.kb_root, rest[0])));
+      break;
+    }
+    case "create": {
+      if (!rest[0]) throw new Error('usage: kp create "<title>" [--type task|idea|plan|thought] [--status S] [--domain D] [--project P] [--priority p0-p3] [--due YYYY-MM-DD]');
+      const r = cmdCreate(store, {
+        type: getFlag(argv, "--type"),
+        title: rest[0],
+        status: getFlag(argv, "--status"),
+        domain: getFlag(argv, "--domain"),
+        project: getFlag(argv, "--project"),
+        priority: getFlag(argv, "--priority"),
+        due: getFlag(argv, "--due")
+      });
+      console.log(`created ${r.id}`);
+      break;
+    }
+    case "edit": {
+      if (!rest[0]) throw new Error("usage: kp edit <id> [--title T] [--status S] [--domain D] [--lane L] [--project P] [--body -]");
+      const bodyFlag = getFlag(argv, "--body");
+      cmdEdit(store, rest[0], {
+        title: getFlag(argv, "--title"),
+        status: getFlag(argv, "--status"),
+        domain: getFlag(argv, "--domain"),
+        lane: getFlag(argv, "--lane"),
+        project: getFlag(argv, "--project"),
+        body: bodyFlag === "-" ? readFileSync(0, "utf8") : bodyFlag
+      });
+      console.log(`edited ${rest[0]}`);
+      break;
+    }
+    case "recategorize": {
+      if (!rest[0]) throw new Error("usage: kp recategorize <id> [--to-type task|idea|plan] [--domain D] [--lane L]");
+      const res = cmdRecategorize(store, rest[0], {
+        toType: getFlag(argv, "--to-type"),
+        domain: getFlag(argv, "--domain"),
+        lane: getFlag(argv, "--lane")
+      });
+      console.log(`recategorized ${rest[0]} \u2192 ${res.newId}`);
+      break;
+    }
+    case "delete": {
+      if (!rest[0]) throw new Error("usage: kp delete <id>");
+      cmdDelete(store, rest[0]);
+      console.log(`deleted ${rest[0]}`);
+      break;
+    }
+    case "research": {
+      if (!rest[0]) throw new Error("usage: kp research <id>");
+      console.log(cmdResearch(store, config.kb_root, rest[0]));
+      break;
+    }
+    case "ingest-gdoc": {
+      const src = rest[0] || getFlag(argv, "--file") || process.env.KP_GDOC_MIRROR;
+      if (!src) throw new Error("ingest needs a source file: kp <cmd> <file> (or $KP_GDOC_MIRROR)");
+      const file = resolve(src);
+      const text = readFileSync(file, "utf8");
+      const snapPath = join(root, ".ingest-state", `${basename(file)}.snapshot`);
+      const prevText = existsSync(snapPath) ? readFileSync(snapPath, "utf8") : null;
+      const max = getFlag(argv, "--max");
+      const res = cmdIngestGdoc(store, text, {
+        domain: getFlag(argv, "--domain"),
+        sourceUrl: getFlag(argv, "--source-url"),
+        prevText,
+        max: max ? Number(max) : void 0
+      });
+      mkdirSync(dirname(snapPath), { recursive: true });
+      writeFileSync(snapPath, text, "utf8");
+      if (res.baselined) {
+        console.log(`baselined ${file} (first run \u2014 no ingest). New bullets will be ingested on the next change.`);
+      } else {
+        console.log(
+          `ingested ${file}
+  ${res.newBullets} new bullet(s) \u2192 created ${res.created.length}, skipped ${res.skipped}` + (res.capped ? `, capped ${res.capped} (raise with --max)` : "")
+        );
+        if (res.created.length) console.log("  " + res.created.join("\n  "));
+      }
+      break;
+    }
+    case "ingest-thoughts": {
+      const src = rest[0] || getFlag(argv, "--file") || process.env.KP_GDOC_MIRROR;
+      if (!src) throw new Error("ingest needs a source file: kp <cmd> <file> (or $KP_GDOC_MIRROR)");
+      const file = resolve(src);
+      const text = readFileSync(file, "utf8");
+      const snapPath = join(root, ".ingest-state", `${basename(file)}.thoughts.snapshot`);
+      const backfill = argv.includes("--all");
+      const prevText = backfill ? "" : existsSync(snapPath) ? readFileSync(snapPath, "utf8") : null;
+      const max = getFlag(argv, "--max");
+      const res = cmdIngestThoughts(store, text, {
+        source: getFlag(argv, "--source"),
+        sourceUrl: getFlag(argv, "--source-url"),
+        prevText,
+        max: max ? Number(max) : void 0
+      });
+      mkdirSync(dirname(snapPath), { recursive: true });
+      writeFileSync(snapPath, text, "utf8");
+      if (res.baselined) {
+        console.log(`baselined ${file} (first run \u2014 no thoughts ingested). Use --all to backfill.`);
+      } else {
+        console.log(
+          `ingested thoughts from ${file}
+  ${res.newBlocks} new block(s) \u2192 created ${res.created.length}, skipped ${res.skipped}` + (res.capped ? `, capped ${res.capped} (raise with --max)` : "")
+        );
+        if (res.created.length) console.log("  " + res.created.join("\n  "));
+      }
+      break;
+    }
+    case "set-status": {
+      if (!rest[0] || !rest[1]) throw new Error('usage: kp set-status <objectId> <status> [--note "resolution"]');
+      cmdSetStatus(store, rest[0], rest[1], getFlag(argv, "--note"));
+      console.log(`set ${rest[0]} \u2192 ${rest[1]}`);
+      break;
+    }
+    case "set-due": {
+      if (!rest[0] || !rest[1]) throw new Error("usage: kp set-due <objectId> <YYYY-MM-DD|->");
+      cmdSetDue(store, rest[0], rest[1]);
+      console.log(`set ${rest[0]} due \u2192 ${rest[1]}`);
+      break;
+    }
+    case "set-priority": {
+      if (!rest[0] || !rest[1]) throw new Error("usage: kp set-priority <objectId> <p0..p3|->");
+      cmdSetPriority(store, rest[0], rest[1]);
+      console.log(`set ${rest[0]} priority \u2192 ${rest[1]}`);
+      break;
+    }
+    case "set-project": {
+      if (!rest[0] || !rest[1]) throw new Error("usage: kp set-project <objectId> <projects/slug|alias|->");
+      cmdSetProject(store, rest[0], rest[1]);
+      console.log(`set ${rest[0]} project \u2192 ${rest[1]}`);
+      break;
+    }
+    case "calendar": {
+      const from = getFlag(argv, "--from") ?? today();
+      const toFlag = getFlag(argv, "--to");
+      const to = toFlag ?? addDays(from, 14);
+      console.log(cmdCalendar(idx(), getFlag(argv, "--all") ? "0000-01-01" : from, to));
+      break;
+    }
+    case "lookback": {
+      const date = getFlag(argv, "--date") ?? rest[0] ?? today();
+      console.log(cmdLookback(store, date === "today" ? today() : date));
+      break;
+    }
+    case "derive-sessions": {
+      const res = cmdDeriveSessions(store, config);
+      console.log(`analyzed ${res.sessions} sessions \u2192 ${res.clusters} project clusters \u2192 ${res.id}`);
+      break;
+    }
+    case "derive-projects": {
+      const res = cmdDeriveProjects(store, {
+        dryRun: hasFlag(argv, "--dry-run"),
+        force: hasFlag(argv, "--force")
+      });
+      console.log(
+        `derive-projects${hasFlag(argv, "--dry-run") ? " (dry-run)" : ""}: examined ${res.examined}, labeled ${res.labeled}, already-set ${res.skippedHasProject}, no-match ${res.skippedNoMatch}`
+      );
+      for (const c of res.changes) {
+        console.log(`  ${c.id} \u2192 ${c.project}${c.previous ? ` (was ${c.previous})` : ""}`);
+      }
+      break;
+    }
+    case "label-sessions": {
+      const res = cmdLabelSessions(store, {
+        dryRun: hasFlag(argv, "--dry-run"),
+        force: hasFlag(argv, "--force"),
+        sessionsRoot: config.sessions_root
+      });
+      console.log(
+        `label-sessions${hasFlag(argv, "--dry-run") ? " (dry-run)" : ""}: examined ${res.examined}, labeled ${res.labeled}, skipped ${res.skipped}`
+      );
+      for (const c of res.changes.slice(0, 15)) {
+        console.log(`  ${c.uuid.slice(0, 8)}\u2026 \u2192 ${c.label}`);
+      }
+      if (res.changes.length > 15) console.log(`  \u2026 +${res.changes.length - 15} more`);
+      break;
+    }
+    case "serve": {
+      const port = Number(getFlag(argv, "--port") ?? 4622);
+      void import("./server-NXAKSD5Z.js").then(async ({ serve }) => {
+        const { port: actual } = await serve({ root, config, port });
+        console.log(`kp dashboard: http://127.0.0.1:${actual}  (root: ${root}; Ctrl-C to stop)`);
+      });
+      return;
+    }
+    case "doctor":
+      console.log(cmdDoctor(store, idx(), config));
+      break;
+    default:
+      console.error(`unknown command: ${command}
+`);
+      console.log(HELP);
+      process.exitCode = 1;
+  }
+}
+try {
+  main();
+} catch (err) {
+  console.error(`error: ${err.message}`);
+  process.exitCode = 1;
+}
+export {
+  defaultStoreRoot
+};