@pebblehouse/odin-cli 0.18.2 → 0.19.0

package/README.md

@@ -73,6 +73,15 @@ odin tasks promote <slug> <task-id> --file ./bet.md   # Promote a task to a bet
 odin tasks create <slug> "Fix" --follow-up-of ODIN-12 # Allocate ODIN-12A as a follow-up
 ```
 
+### Roadmaps
+
+```bash
+odin roadmaps client-draft get <roadmap-id> [--pebble <slug>]
+odin roadmaps client-draft save <roadmap-id> --expected-revision <n> --file <payload.json> [--pebble <slug>]
+```
+
+Reads or saves the client-page draft of a master roadmap. `--pebble` defaults to the nearest `CLAUDE.md` `pebble:` line. Requires `odin login` as Kenny; API keys get `dashboard_approval_required`. Prints the `{ data, error, issues? }` JSON envelope and exits 1 on any error.
+
 ### Auth
 
 ```bash

package/dist/index.js

@@ -1416,10 +1416,31 @@ tasksCmd.command("delete <slug> <id>").description("Delete a task").action(async
 
 // src/commands/roadmaps.ts
 import { Command as Command18 } from "commander";
-import { readFileSync as readFileSync13 } from "fs";
+import { readFileSync as readFileSync14 } from "fs";
+
+// src/resolve-pebble.ts
+import { existsSync as existsSync3, readFileSync as readFileSync13 } from "fs";
+import { dirname as dirname2, join as join2 } from "path";
+var PEBBLE_LINE = /^pebble:\s*([a-z0-9][a-z0-9-]*)\s*$/m;
+function resolvePebbleSlug(explicit, cwd = process.cwd()) {
+  if (explicit) return explicit;
+  let dir = cwd;
+  for (; ; ) {
+    const file = join2(dir, "CLAUDE.md");
+    if (existsSync3(file)) {
+      const m = readFileSync13(file, "utf-8").match(PEBBLE_LINE);
+      if (m) return m[1];
+    }
+    const parent = dirname2(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+// src/commands/roadmaps.ts
 var roadmapsCmd = new Command18("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 = {};
+roadmapsCmd.command("list <slug>").description("List roadmaps for a pebble").option("--status <status>", "Filter by status").option("--all", "Include child roadmaps (default: top-level only)").action(async (slug, opts) => {
+  const params = { nesting: opts.all ? "all" : "top" };
   if (opts.status) params.status = opts.status;
   const res = await apiRequest(`/pebbles/${slug}/roadmaps`, { params });
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -1430,21 +1451,33 @@ roadmapsCmd.command("get <slug> <id>").description("Get a roadmap by ID (include
   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 ? readFileSync13(opts.file, "utf-8") : opts.content ?? "";
+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").option("--parent <id>", "Parent roadmap UUID (nesting is capped at 2 levels)").option("--starts-on <date>", "Start date, YYYY-MM-DD").option("--ends-on <date>", "End date, YYYY-MM-DD").action(async (slug, title, opts) => {
+  const content = opts.file ? readFileSync14(opts.file, "utf-8") : opts.content ?? "";
   const res = await apiRequest(`/pebbles/${slug}/roadmaps`, {
     method: "POST",
-    body: { title, source: opts.source, content, status: opts.status }
+    body: {
+      title,
+      source: opts.source,
+      content,
+      status: opts.status,
+      parent_roadmap_id: opts.parent,
+      starts_on: opts.startsOn,
+      ends_on: opts.endsOn
+    }
   });
   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) => {
+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").option("--parent <id>", 'New parent roadmap UUID, or the literal "null" to promote to top level').option("--starts-on <date>", 'New start date YYYY-MM-DD, or the literal "null" to clear').option("--ends-on <date>", 'New end date YYYY-MM-DD, or the literal "null" to clear').action(async (slug, id, opts) => {
   const body = {};
   if (opts.title) body.title = opts.title;
-  if (opts.file) body.content = readFileSync13(opts.file, "utf-8");
+  if (opts.file) body.content = readFileSync14(opts.file, "utf-8");
   else if (opts.content) body.content = opts.content;
   if (opts.status) body.status = opts.status;
+  const nullable = (v) => v === void 0 ? void 0 : v === "null" ? null : v;
+  if (opts.parent !== void 0) body.parent_roadmap_id = nullable(opts.parent);
+  if (opts.startsOn !== void 0) body.starts_on = nullable(opts.startsOn);
+  if (opts.endsOn !== void 0) body.ends_on = nullable(opts.endsOn);
   const res = await apiRequest(`/pebbles/${slug}/roadmaps/${id}`, {
     method: "PUT",
     body
@@ -1459,11 +1492,41 @@ roadmapsCmd.command("delete <slug> <id>").description("Delete a roadmap").action
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
+function emit(res, failed) {
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (failed) process.exit(1);
+}
+function draftPath(pebble, roadmapId) {
+  const slug = resolvePebbleSlug(pebble);
+  return slug ? `/pebbles/${slug}/roadmaps/${roadmapId}/client-page/draft` : null;
+}
+var clientDraftCmd = roadmapsCmd.command("client-draft").description("Read or save the client-page draft of a master roadmap (Kenny's session only; draft only)");
+clientDraftCmd.command("get <roadmap-id>").description("Print the draft as { data: { revision, payload } | null, error }").option("--pebble <slug>", "Pebble slug (default: nearest CLAUDE.md `pebble:` line)").action(async (roadmapId, opts) => {
+  const path = draftPath(opts.pebble, roadmapId);
+  if (!path) return emit({ data: null, error: "pebble_unresolved" }, true);
+  const res = await apiRequest(path);
+  emit(res, Boolean(res.error));
+});
+clientDraftCmd.command("save <roadmap-id>").description("Save the draft; --file holds the payload only. Prints { data, error, issues? }").requiredOption("--expected-revision <n>", "Revision you read (0 creates the first draft)").requiredOption("--file <path>", "JSON file containing the RoadmapClientPayload").option("--pebble <slug>", "Pebble slug (default: nearest CLAUDE.md `pebble:` line)").action(async (roadmapId, opts) => {
+  const path = draftPath(opts.pebble, roadmapId);
+  if (!path) return emit({ data: null, error: "pebble_unresolved" }, true);
+  if (!/^\d+$/.test(opts.expectedRevision) || !Number.isSafeInteger(Number(opts.expectedRevision))) {
+    return emit({ data: null, error: "invalid_payload", issues: [{ path: "expectedRevision", message: "must be a non-negative integer" }] }, true);
+  }
+  let payload;
+  try {
+    payload = JSON.parse(readFileSync14(opts.file, "utf-8"));
+  } catch (e) {
+    return emit({ data: null, error: "invalid_payload", issues: [{ path: "(root)", message: `payload file is not valid JSON: ${e.message}` }] }, true);
+  }
+  const res = await apiRequest(path, { method: "PUT", body: { expectedRevision: Number(opts.expectedRevision), payload } });
+  emit(res, Boolean(res.error));
+});
 
 // src/commands/persona-runs.ts
 import { Command as Command19 } from "commander";
-import { readFileSync as readFileSync14 } from "fs";
-import { join as join2 } from "path";
+import { readFileSync as readFileSync15 } from "fs";
+import { join as join3 } from "path";
 import { homedir as homedir2 } from "os";
 var personaRunsCmd = new Command19("persona-runs").description(
   "Manage per-persona per-session token usage rows"
@@ -1489,7 +1552,7 @@ personaRunsCmd.command("get <slug> <id>").description("Get a persona run by id")
   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(readFileSync14(opts.file, "utf-8"));
+  const body = JSON.parse(readFileSync15(opts.file, "utf-8"));
   const res = await apiRequest(`/pebbles/${slug}/persona-runs`, {
     method: "POST",
     body
@@ -1498,10 +1561,10 @@ personaRunsCmd.command("create <slug>").description("Create/upsert a persona run
   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`);
+  const markerPath = opts.marker ?? join3(homedir2(), ".claude", "odin-context", `${opts.sessionId}.json`);
   let marker = {};
   try {
-    marker = JSON.parse(readFileSync14(markerPath, "utf-8"));
+    marker = JSON.parse(readFileSync15(markerPath, "utf-8"));
   } catch {
     process.exit(0);
   }
@@ -1511,7 +1574,7 @@ personaRunsCmd.command("capture").description("Read marker + transcript, compute
   let input = 0, output = 0, cacheRead = 0, cacheCreate = 0;
   let minTs = null, maxTs = null;
   try {
-    const raw = readFileSync14(opts.transcript, "utf-8");
+    const raw = readFileSync15(opts.transcript, "utf-8");
     for (const line of raw.split("\n")) {
       if (!line.trim()) continue;
       let obj;
@@ -1563,7 +1626,7 @@ personaRunsCmd.command("capture").description("Read marker + transcript, compute
 
 // src/commands/blog.ts
 import { Command as Command20 } from "commander";
-import { readFileSync as readFileSync15 } from "fs";
+import { readFileSync as readFileSync16 } from "fs";
 var blogCmd = new Command20("blog").description("Manage blog posts");
 blogCmd.command("list <slug>").description("List blog posts for a pebble").option("--status <status>", "Filter by status (draft, review, scheduled, published, archived)").option("--tag <tag>", "Filter by tag").option("--page <page>", "Page number", "1").option("--per-page <perPage>", "Results per page", "20").action(async (slug, opts) => {
   const params = {};
@@ -1583,7 +1646,7 @@ blogCmd.command("get <slug> <idOrSlug>").description("Get a blog post by UUID or
 blogCmd.command("create <slug> <title>").description("Create a blog post").requiredOption("--post-slug <postSlug>", "URL slug for the post").option("--blocks <blocks>", "Content blocks as JSON string").option("--file <path>", "Read content blocks from JSON file").option("--status <status>", "Initial status (draft, review, scheduled)", "draft").option("--scheduled-publish-at <iso>", "UTC ISO timestamp for scheduled publishing (required when --status scheduled)").option("--metadata <metadata>", "Post metadata as JSON string").option("--campaign-id <campaignId>", "Link to a marketing campaign").action(async (slug, title, opts) => {
   let blocks = [];
   if (opts.file) {
-    blocks = JSON.parse(readFileSync15(opts.file, "utf-8"));
+    blocks = JSON.parse(readFileSync16(opts.file, "utf-8"));
   } else if (opts.blocks) {
     blocks = JSON.parse(opts.blocks);
   }
@@ -1607,7 +1670,7 @@ blogCmd.command("update <slug> <id>").description("Update a blog post").option("
   const body = {};
   if (opts.title) body.title = opts.title;
   if (opts.postSlug) body.slug = opts.postSlug;
-  if (opts.file) body.blocks = JSON.parse(readFileSync15(opts.file, "utf-8"));
+  if (opts.file) body.blocks = JSON.parse(readFileSync16(opts.file, "utf-8"));
   else if (opts.blocks) body.blocks = JSON.parse(opts.blocks);
   if (opts.status) body.status = opts.status;
   if (opts.scheduledPublishAt !== void 0)
@@ -2582,11 +2645,11 @@ var setupCmd = new Command23("setup").description("Alias for `create project`").
 );
 
 // src/index.ts
-import { readFileSync as readFileSync16 } from "fs";
+import { readFileSync as readFileSync17 } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname2, resolve as resolve2 } from "path";
-var __dirname = dirname2(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync16(resolve2(__dirname, "../package.json"), "utf-8"));
+import { dirname as dirname3, resolve as resolve2 } from "path";
+var __dirname = dirname3(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(readFileSync17(resolve2(__dirname, "../package.json"), "utf-8"));
 var GOLD = "\x1B[33m";
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pebblehouse/odin-cli",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "type": "module",
   "description": "CLI for Odin — the knowledge backbone for Pebble House",
   "bin": {