@pebblehouse/odin-cli 0.9.0 → 0.10.1

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command12 } from "commander";
+import { Command as Command18 } from "commander";
 
 // src/auth/login.ts
 import { createServer } from "http";
@@ -757,13 +757,394 @@ briefsCmd.command("versions <slug>").description("List version history for a peb
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
+briefsCmd.command("generate [slug]").description("Generate/regenerate brief for a pebble (or all pebbles)").option("--secret <secret>", "Worker secret (defaults to ODIN_WORKER_SECRET env var)").action(async (slug, opts) => {
+  const secret = opts.secret ?? process.env.ODIN_WORKER_SECRET;
+  if (!secret) {
+    console.error("error: ODIN_WORKER_SECRET env var or --secret flag required");
+    process.exit(1);
+  }
+  const apiUrl = process.env.ODIN_API_URL ?? "https://odin.mu";
+  const url = slug ? `${apiUrl}/api/internal/briefs/generate?slug=${slug}` : `${apiUrl}/api/internal/briefs/generate`;
+  try {
+    const res = await fetch(url, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${secret}` }
+    });
+    const body = await res.json();
+    if (!res.ok) {
+      console.error(`error: ${body.error ?? res.statusText}`);
+      process.exit(1);
+    }
+    process.stdout.write(JSON.stringify(body, null, 2) + "\n");
+  } catch (err) {
+    console.error(`error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+});
 
-// src/index.ts
+// src/commands/blueprints.ts
+import { Command as Command12 } from "commander";
 import { readFileSync as readFileSync9 } from "fs";
+var blueprintsCmd = new Command12("blueprints").description("Manage global blueprints");
+blueprintsCmd.command("list").description("List blueprints").option("--tag <tag>", "Filter by tag").option("--status <status>", "Filter by status (default: active)").option("--all", "Include deprecated/experimental blueprints").action(async (opts) => {
+  const params = new URLSearchParams();
+  if (opts.tag) params.set("tag", opts.tag);
+  if (opts.all) params.set("status", "all");
+  else if (opts.status) params.set("status", opts.status);
+  const qs = params.toString();
+  const res = await apiRequest(`/blueprints${qs ? `?${qs}` : ""}`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("get <id>").description("Get a blueprint by ID (includes assets)").action(async (id) => {
+  const res = await apiRequest(`/blueprints/${id}`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("create <title>").description("Create a blueprint").option("--content <content>", "Blueprint content").option("--file <path>", "Read content from file").option("--tags <tags>", "Comma-separated tags").option("--status <status>", "Status (active|experimental)", "active").option("--source <source>", "Source", "manual").action(async (title, opts) => {
+  const content = opts.file ? readFileSync9(opts.file, "utf-8") : opts.content ?? "";
+  const tags = opts.tags ? opts.tags.split(",").map((t) => t.trim()) : [];
+  const res = await apiRequest("/blueprints", {
+    method: "POST",
+    body: { title, content, tags, status: opts.status, source: opts.source }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("update <id>").description("Update a blueprint").option("--title <title>", "New title").option("--content <content>", "New content").option("--file <path>", "Read content from file").option("--tags <tags>", "Comma-separated tags (replaces all)").option("--status <status>", "New status (active|deprecated|experimental)").option("--source <source>", "Source").action(async (id, opts) => {
+  const body = {};
+  if (opts.title) body.title = opts.title;
+  if (opts.file) body.content = readFileSync9(opts.file, "utf-8");
+  else if (opts.content) body.content = opts.content;
+  if (opts.tags) body.tags = opts.tags.split(",").map((t) => t.trim());
+  if (opts.status) body.status = opts.status;
+  if (opts.source) body.source = opts.source;
+  const res = await apiRequest(`/blueprints/${id}`, {
+    method: "PUT",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("delete <id>").description("Delete a blueprint").action(async (id) => {
+  const res = await apiRequest(`/blueprints/${id}`, {
+    method: "DELETE"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("versions <id>").description("List version history for a blueprint").action(async (id) => {
+  const res = await apiRequest(`/blueprints/${id}/versions`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("deprecate <id>").description("Deprecate a blueprint").action(async (id) => {
+  const res = await apiRequest(`/blueprints/${id}`, {
+    method: "PUT",
+    body: { status: "deprecated" }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("add-asset <id>").description("Add an asset reference to a blueprint").requiredOption("--title <title>", "Asset title").requiredOption("--url <url>", "Asset URL").option("--type <type>", "Asset type (screenshot|diagram|code-snippet|figma-link|github-link|raw-text|other)", "other").option("--description <description>", "Asset description").action(async (id, opts) => {
+  const res = await apiRequest(`/blueprints/${id}/assets`, {
+    method: "POST",
+    body: {
+      title: opts.title,
+      asset_url: opts.url,
+      type: opts.type,
+      description: opts.description ?? ""
+    }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blueprintsCmd.command("assets <id>").description("List assets for a blueprint").action(async (id) => {
+  const res = await apiRequest(`/blueprints/${id}/assets`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+
+// src/commands/bets.ts
+import { Command as Command14 } from "commander";
+import { readFileSync as readFileSync10 } from "fs";
+
+// src/commands/bet-dependencies.ts
+import { Command as Command13 } from "commander";
+var depsCmd = new Command13("deps").description("Manage bet dependencies (blocked-by graph)");
+depsCmd.command("list <slug> <bet-id>").description("List dependencies for a bet (blocked_by + blocking)").action(async (slug, betId) => {
+  const res = await apiRequest(
+    `/pebbles/${slug}/bets/${betId}/dependencies`
+  );
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+depsCmd.command("add <slug> <bet-id>").description("Add a blocked-by dependency").requiredOption("--blocked-by <id>", "Bet ID that blocks this bet").action(async (slug, betId, opts) => {
+  const res = await apiRequest(
+    `/pebbles/${slug}/bets/${betId}/dependencies`,
+    {
+      method: "POST",
+      body: { blocked_by_bet_id: opts.blockedBy }
+    }
+  );
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+depsCmd.command("remove <slug> <bet-id>").description("Remove a blocked-by dependency").requiredOption("--blocked-by <id>", "Bet ID to unlink").action(async (slug, betId, opts) => {
+  const res = await apiRequest(
+    `/pebbles/${slug}/bets/${betId}/dependencies/${opts.blockedBy}`,
+    { method: "DELETE" }
+  );
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+
+// src/commands/bets.ts
+var betsCmd = new Command14("bets").description("Manage bets");
+betsCmd.command("list <slug>").description("List bets for a pebble").option("--status <status>", "Filter by status").action(async (slug, opts) => {
+  const params = {};
+  if (opts.status) params.status = opts.status;
+  const res = await apiRequest(`/pebbles/${slug}/bets`, { params });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+betsCmd.command("get <slug> <id>").description("Get a bet by ID").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/bets/${id}`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+betsCmd.command("create <slug> <title>").description("Create a bet").option("--source <source>", "Source agent", "claude-code").option("--content <content>", "Bet content").option("--file <path>", "Read content from file").option("--status <status>", "Bet status").option("--priority <priority>", "Bet priority").option("--appetite <appetite>", "Bet appetite").action(async (slug, title, opts) => {
+  const content = opts.file ? readFileSync10(opts.file, "utf-8") : opts.content ?? "";
+  const res = await apiRequest(`/pebbles/${slug}/bets`, {
+    method: "POST",
+    body: { title, source: opts.source, content, status: opts.status, priority: opts.priority, appetite: opts.appetite }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+betsCmd.command("update <slug> <id>").description("Update a bet").option("--title <title>", "New title").option("--content <content>", "New content").option("--file <path>", "Read content from file").option("--status <status>", "New status").option("--priority <priority>", "New priority").option("--appetite <appetite>", "New appetite").action(async (slug, id, opts) => {
+  const body = {};
+  if (opts.title) body.title = opts.title;
+  if (opts.file) body.content = readFileSync10(opts.file, "utf-8");
+  else if (opts.content) body.content = opts.content;
+  if (opts.status) body.status = opts.status;
+  if (opts.priority) body.priority = opts.priority;
+  if (opts.appetite) body.appetite = opts.appetite;
+  const res = await apiRequest(`/pebbles/${slug}/bets/${id}`, {
+    method: "PUT",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+betsCmd.command("delete <slug> <id>").description("Delete a bet").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/bets/${id}`, {
+    method: "DELETE"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+betsCmd.addCommand(depsCmd);
+
+// src/commands/tasks.ts
+import { Command as Command15 } from "commander";
+var tasksCmd = new Command15("tasks").description("Manage tasks");
+tasksCmd.command("list <slug>").description("List tasks for a pebble").option("--status <status>", "Filter by status").option("--bet <bet-id>", "Filter by bet ID").action(async (slug, opts) => {
+  const params = {};
+  if (opts.status) params.status = opts.status;
+  if (opts.bet) params.bet_id = opts.bet;
+  const res = await apiRequest(`/pebbles/${slug}/tasks`, { params });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+tasksCmd.command("get <slug> <id>").description("Get a task by ID").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/tasks/${id}`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+tasksCmd.command("create <slug> <title>").description("Create a task").option("--source <source>", "Source agent", "claude-code").option("--description <description>", "Task description").option("--bet <bet-id>", "Parent bet ID").option("--status <status>", "Task status").option("--priority <priority>", "Task priority").action(async (slug, title, opts) => {
+  const res = await apiRequest(`/pebbles/${slug}/tasks`, {
+    method: "POST",
+    body: { title, source: opts.source, description: opts.description, bet_id: opts.bet, status: opts.status, priority: opts.priority }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+tasksCmd.command("update <slug> <id>").description("Update a task").option("--title <title>", "New title").option("--description <description>", "New description").option("--status <status>", "New status").option("--priority <priority>", "New priority").option("--bet <bet-id>", "New parent bet ID").action(async (slug, id, opts) => {
+  const body = {};
+  if (opts.title) body.title = opts.title;
+  if (opts.description) body.description = opts.description;
+  if (opts.status) body.status = opts.status;
+  if (opts.priority) body.priority = opts.priority;
+  if (opts.bet) body.bet_id = opts.bet;
+  const res = await apiRequest(`/pebbles/${slug}/tasks/${id}`, {
+    method: "PUT",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+tasksCmd.command("delete <slug> <id>").description("Delete a task").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/tasks/${id}`, {
+    method: "DELETE"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+
+// src/commands/roadmaps.ts
+import { Command as Command16 } from "commander";
+import { readFileSync as readFileSync11 } from "fs";
+var roadmapsCmd = new Command16("roadmaps").description("Manage roadmaps");
+roadmapsCmd.command("list <slug>").description("List roadmaps for a pebble").option("--status <status>", "Filter by status").action(async (slug, opts) => {
+  const params = {};
+  if (opts.status) params.status = opts.status;
+  const res = await apiRequest(`/pebbles/${slug}/roadmaps`, { params });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+roadmapsCmd.command("get <slug> <id>").description("Get a roadmap by ID (includes bets)").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/roadmaps/${id}`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+roadmapsCmd.command("create <slug> <title>").description("Create a roadmap").option("--source <source>", "Source agent", "claude-code").option("--content <content>", "Roadmap content").option("--file <path>", "Read content from file").option("--status <status>", "Roadmap status").action(async (slug, title, opts) => {
+  const content = opts.file ? readFileSync11(opts.file, "utf-8") : opts.content ?? "";
+  const res = await apiRequest(`/pebbles/${slug}/roadmaps`, {
+    method: "POST",
+    body: { title, source: opts.source, content, status: opts.status }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+roadmapsCmd.command("update <slug> <id>").description("Update a roadmap").option("--title <title>", "New title").option("--content <content>", "New content").option("--file <path>", "Read content from file").option("--status <status>", "New status").action(async (slug, id, opts) => {
+  const body = {};
+  if (opts.title) body.title = opts.title;
+  if (opts.file) body.content = readFileSync11(opts.file, "utf-8");
+  else if (opts.content) body.content = opts.content;
+  if (opts.status) body.status = opts.status;
+  const res = await apiRequest(`/pebbles/${slug}/roadmaps/${id}`, {
+    method: "PUT",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+roadmapsCmd.command("delete <slug> <id>").description("Delete a roadmap").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/roadmaps/${id}`, {
+    method: "DELETE"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+
+// src/commands/persona-runs.ts
+import { Command as Command17 } from "commander";
+import { readFileSync as readFileSync12 } from "fs";
+import { join as join2 } from "path";
+import { homedir as homedir2 } from "os";
+var personaRunsCmd = new Command17("persona-runs").description(
+  "Manage per-persona per-session token usage rows"
+);
+personaRunsCmd.command("list <slug>").description("List persona runs for a pebble").option("--bet-id <id>", "Filter by bet_id").option("--plan-id <id>", "Filter by plan_id").option("--persona <name>", "Filter by persona name").option("--limit <n>", "Max rows", "50").action(async (slug, opts) => {
+  const params = {};
+  if (opts.betId) params.bet_id = opts.betId;
+  if (opts.planId) params.plan_id = opts.planId;
+  if (opts.persona) params.persona = opts.persona;
+  if (opts.limit) params.limit = String(opts.limit);
+  const res = await apiRequest(
+    `/pebbles/${slug}/persona-runs`,
+    { params }
+  );
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+personaRunsCmd.command("get <slug> <id>").description("Get a persona run by id").action(async (slug, id) => {
+  const res = await apiRequest(
+    `/pebbles/${slug}/persona-runs/${id}`
+  );
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+personaRunsCmd.command("create <slug>").description("Create/upsert a persona run from a JSON file").requiredOption("--file <path>", "JSON payload matching PersonaRunCreate").action(async (slug, opts) => {
+  const body = JSON.parse(readFileSync12(opts.file, "utf-8"));
+  const res = await apiRequest(`/pebbles/${slug}/persona-runs`, {
+    method: "POST",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+personaRunsCmd.command("capture").description("Read marker + transcript, compute tokens, POST to endpoint (hook path)").requiredOption("--session-id <id>", "Claude Code session id").requiredOption("--transcript <path>", "Path to transcript JSONL").option("--marker <path>", "Explicit marker path (default: ~/.claude/odin-context/<session-id>.json)").action(async (opts) => {
+  const markerPath = opts.marker ?? join2(homedir2(), ".claude", "odin-context", `${opts.sessionId}.json`);
+  let marker = {};
+  try {
+    marker = JSON.parse(readFileSync12(markerPath, "utf-8"));
+  } catch {
+    process.exit(0);
+  }
+  if (!marker.pebble_slug || !marker.persona) {
+    process.exit(0);
+  }
+  let input = 0, output = 0, cacheRead = 0, cacheCreate = 0;
+  let minTs = null, maxTs = null;
+  try {
+    const raw = readFileSync12(opts.transcript, "utf-8");
+    for (const line of raw.split("\n")) {
+      if (!line.trim()) continue;
+      let obj;
+      try {
+        obj = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      if (obj.type !== "assistant") continue;
+      const u = obj.message?.usage;
+      if (!u) continue;
+      input += Number(u.input_tokens ?? 0);
+      output += Number(u.output_tokens ?? 0);
+      cacheRead += Number(u.cache_read_input_tokens ?? 0);
+      cacheCreate += Number(u.cache_creation_input_tokens ?? 0);
+      const ts = obj.timestamp;
+      if (ts) {
+        if (!minTs || ts < minTs) minTs = ts;
+        if (!maxTs || ts > maxTs) maxTs = ts;
+      }
+    }
+  } catch {
+    process.exit(0);
+  }
+  const payload = {
+    persona: marker.persona,
+    session_id: opts.sessionId,
+    input_tokens: input,
+    output_tokens: output,
+    cache_read_tokens: cacheRead,
+    cache_creation_tokens: cacheCreate,
+    bet_id: marker.bet_id ?? null,
+    plan_id: marker.plan_id ?? null,
+    phase_id: marker.phase_id ?? null,
+    started_at: minTs,
+    ended_at: maxTs
+  };
+  const res = await apiRequest(
+    `/pebbles/${marker.pebble_slug}/persona-runs`,
+    { method: "POST", body: payload }
+  );
+  if (res.error) {
+    process.stderr.write(`odin persona-runs capture: ${res.error}
+`);
+    process.exit(1);
+  }
+  process.stdout.write(JSON.stringify(res.data) + "\n");
+});
+
+// src/index.ts
+import { readFileSync as readFileSync13 } from "fs";
 import { fileURLToPath } from "url";
 import { dirname as dirname2, resolve } from "path";
 var __dirname = dirname2(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync9(resolve(__dirname, "../package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync13(resolve(__dirname, "../package.json"), "utf-8"));
 var GOLD = "\x1B[33m";
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
@@ -781,7 +1162,7 @@ ${RESET}
   ${DIM}${cwd}${RESET}
 `);
 }
-var program = new Command12();
+var program = new Command18();
 program.name("odin").description("CLI for Odin \u2014 the knowledge backbone for Pebble House").version(VERSION);
 program.command("login").description("Authenticate with Odin via browser").action(async () => {
   printBanner();
@@ -808,6 +1189,11 @@ program.addCommand(versionsCmd);
 program.addCommand(guidelinesCmd);
 program.addCommand(rulesCmd);
 program.addCommand(briefsCmd);
+program.addCommand(blueprintsCmd);
+program.addCommand(betsCmd);
+program.addCommand(tasksCmd);
+program.addCommand(roadmapsCmd);
+program.addCommand(personaRunsCmd);
 process.on("exit", () => {
   process.stderr.write("\n\n\n\n\n");
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pebblehouse/odin-cli",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "type": "module",
   "description": "CLI for Odin — the knowledge backbone for Pebble House",
   "bin": {
@@ -11,7 +11,10 @@
   ],
   "scripts": {
     "build": "tsup",
-    "dev": "tsup --watch"
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "odin",
@@ -36,7 +39,9 @@
     "open": "^10.0.0"
   },
   "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.2",
     "tsup": "^8.0.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^4.1.2"
   }
 }