@pebblehouse/odin-cli 0.10.1 → 0.12.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command18 } from "commander";
+import { Command as Command20 } from "commander";
 
 // src/auth/login.ts
 import { createServer } from "http";
@@ -281,8 +281,15 @@ docsCmd.command("create <slug> <type>").description("Create a document").require
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-docsCmd.command("delete <slug> <type>").description("Delete a document").action(async (slug, type) => {
-  const res = await apiRequest(`/pebbles/${slug}/documents/${type}`, {
+docsCmd.command("delete <slug> [type]").description("Delete a document by type, or by --id (unambiguous)").option("--id <id>", "Delete a specific document by its UUID").action(async (slug, type, opts) => {
+  if (!opts.id && !type) {
+    process.stdout.write(
+      JSON.stringify({ data: null, error: "Provide a <type> or --id <uuid> to delete" }) + "\n"
+    );
+    process.exit(1);
+  }
+  const path = opts.id ? `/pebbles/${slug}/documents/id/${opts.id}` : `/pebbles/${slug}/documents/${type}`;
+  const res = await apiRequest(path, {
     method: "DELETE"
   });
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -464,11 +471,23 @@ plansCmd.command("create <slug> <title>").description("Create a plan").option("-
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-plansCmd.command("update <slug> <id>").description("Update a plan").option("--title <title>", "New title").option("--description <description>", "New description").option("--status <status>", "Plan status (active|completed|archived)").action(async (slug, id, opts) => {
+plansCmd.command("update <slug> <id>").description("Update a plan").option("--title <title>", "New title").option("--description <description>", "New description").option("--status <status>", "Plan status (active|done|archived)").option("--bet-id <uuid>", "Link plan to a bet").option("--task-id <uuid>", "Link plan to a task").option("--clear-bet", "Clear the bet link").option("--clear-task", "Clear the task link").action(async (slug, id, opts) => {
+  if (opts.betId && opts.clearBet) {
+    process.stderr.write("Cannot combine --bet-id with --clear-bet\n");
+    process.exit(1);
+  }
+  if (opts.taskId && opts.clearTask) {
+    process.stderr.write("Cannot combine --task-id with --clear-task\n");
+    process.exit(1);
+  }
   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.betId) body.bet_id = opts.betId;
+  else if (opts.clearBet) body.bet_id = null;
+  if (opts.taskId) body.task_id = opts.taskId;
+  else if (opts.clearTask) body.task_id = null;
   const res = await apiRequest(`/pebbles/${slug}/plans/${id}`, {
     method: "PUT",
     body
@@ -495,7 +514,7 @@ plansCmd.command("add-phase <slug> <planId> <title>").description("Add a phase t
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-plansCmd.command("update-phase <slug> <planId> <phaseId>").description("Update a phase").option("--title <title>", "Phase title").option("--status <status>", "Phase status (pending|in_progress|completed|skipped)").option("--notes <notes>", "Phase notes").option("--description <description>", "Phase description").action(async (slug, planId, phaseId, opts) => {
+plansCmd.command("update-phase <slug> <planId> <phaseId>").description("Update a phase").option("--title <title>", "Phase title").option("--status <status>", "Phase status (pending|in_progress|done|skipped)").option("--notes <notes>", "Phase notes").option("--description <description>", "Phase description").action(async (slug, planId, phaseId, opts) => {
   const body = {};
   if (opts.title) body.title = opts.title;
   if (opts.status) body.status = opts.status;
@@ -846,12 +865,21 @@ blueprintsCmd.command("deprecate <id>").description("Deprecate a blueprint").act
   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) => {
+blueprintsCmd.command("add-asset <id>").description("Add an asset reference or inline content to a blueprint").requiredOption("--title <title>", "Asset title").option("--url <url>", "Asset URL (optional if content provided)").option("--content <content>", "Inline content string").option("--content-file <path>", "Read content from file").option("--type <type>", "Asset type (screenshot|diagram|code-snippet|figma-link|github-link|raw-text|visual-spec|other)", "other").option("--description <description>", "Asset description").action(async (id, opts) => {
+  let content = opts.content;
+  if (opts.contentFile) {
+    content = readFileSync9(opts.contentFile, "utf-8");
+  }
+  if (!opts.url && !content) {
+    process.stderr.write("Error: at least one of --url, --content, or --content-file is required\n");
+    process.exit(1);
+  }
   const res = await apiRequest(`/blueprints/${id}/assets`, {
     method: "POST",
     body: {
       title: opts.title,
-      asset_url: opts.url,
+      asset_url: opts.url || null,
+      content: content || null,
       type: opts.type,
       description: opts.description ?? ""
     }
@@ -1139,12 +1167,119 @@ personaRunsCmd.command("capture").description("Read marker + transcript, compute
   process.stdout.write(JSON.stringify(res.data) + "\n");
 });
 
-// src/index.ts
+// src/commands/blog.ts
+import { Command as Command18 } from "commander";
 import { readFileSync as readFileSync13 } from "fs";
+var blogCmd = new Command18("blog").description("Manage blog posts");
+blogCmd.command("list <slug>").description("List blog posts for a pebble").option("--status <status>", "Filter by status (draft, review, 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 = {};
+  if (opts.status) params.status = opts.status;
+  if (opts.tag) params.tag = opts.tag;
+  params.page = opts.page;
+  params.per_page = opts.perPage;
+  const res = await apiRequest(`/pebbles/${slug}/blog`, { params });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blogCmd.command("get <slug> <idOrSlug>").description("Get a blog post by UUID or slug").action(async (slug, idOrSlug) => {
+  const res = await apiRequest(`/pebbles/${slug}/blog/${idOrSlug}`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+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)", "draft").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(readFileSync13(opts.file, "utf-8"));
+  } else if (opts.blocks) {
+    blocks = JSON.parse(opts.blocks);
+  }
+  const body = {
+    title,
+    slug: opts.postSlug,
+    blocks,
+    status: opts.status
+  };
+  if (opts.metadata) body.metadata = JSON.parse(opts.metadata);
+  if (opts.campaignId) body.campaign_id = opts.campaignId;
+  const res = await apiRequest(`/pebbles/${slug}/blog`, {
+    method: "POST",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blogCmd.command("update <slug> <id>").description("Update a blog post").option("--title <title>", "New title").option("--post-slug <postSlug>", "New URL slug").option("--blocks <blocks>", "Content blocks as JSON string").option("--file <path>", "Read content blocks from JSON file").option("--status <status>", "New status (draft, review, published, archived)").option("--metadata <metadata>", "Post metadata as JSON string").action(async (slug, id, opts) => {
+  const body = {};
+  if (opts.title) body.title = opts.title;
+  if (opts.postSlug) body.slug = opts.postSlug;
+  if (opts.file) body.blocks = JSON.parse(readFileSync13(opts.file, "utf-8"));
+  else if (opts.blocks) body.blocks = JSON.parse(opts.blocks);
+  if (opts.status) body.status = opts.status;
+  if (opts.metadata) body.metadata = JSON.parse(opts.metadata);
+  const res = await apiRequest(`/pebbles/${slug}/blog/${id}`, {
+    method: "PUT",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+blogCmd.command("delete <slug> <id>").description("Delete a blog post").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/blog/${id}`, {
+    method: "DELETE"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+
+// src/commands/api-keys.ts
+import { Command as Command19 } from "commander";
+var apiKeysCmd = new Command19("api-keys").description("Manage API keys for server-to-server access");
+apiKeysCmd.command("list <slug>").description("List API keys for a pebble").action(async (slug) => {
+  const res = await apiRequest(`/pebbles/${slug}/api-keys`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+apiKeysCmd.command("create <slug>").description("Create a new API key").requiredOption("--name <name>", "Human-readable key name").requiredOption("--scopes <scopes>", "Comma-separated scopes (e.g. blog:read,marketing_content:read)").option("--expires-at <expiresAt>", "Expiration timestamp (ISO 8601)").action(async (slug, opts) => {
+  const scopes = opts.scopes.split(",").map((s) => s.trim());
+  const body = { name: opts.name, scopes };
+  if (opts.expiresAt) body.expires_at = opts.expiresAt;
+  const res = await apiRequest(`/pebbles/${slug}/api-keys`, {
+    method: "POST",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+  if (res.data?.key) {
+    process.stderr.write(
+      `
+  Store this key securely -- it cannot be retrieved again:
+  ${res.data.key}
+
+`
+    );
+  }
+});
+apiKeysCmd.command("revoke <slug> <id>").description("Revoke an API key").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/api-keys/${id}/revoke`, {
+    method: "POST"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+apiKeysCmd.command("delete <slug> <id>").description("Permanently delete an API key").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/api-keys/${id}`, {
+    method: "DELETE"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+
+// src/index.ts
+import { readFileSync as readFileSync14 } from "fs";
 import { fileURLToPath } from "url";
 import { dirname as dirname2, resolve } from "path";
 var __dirname = dirname2(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync13(resolve(__dirname, "../package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync14(resolve(__dirname, "../package.json"), "utf-8"));
 var GOLD = "\x1B[33m";
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
@@ -1162,7 +1297,7 @@ ${RESET}
   ${DIM}${cwd}${RESET}
 `);
 }
-var program = new Command18();
+var program = new Command20();
 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();
@@ -1194,6 +1329,8 @@ program.addCommand(betsCmd);
 program.addCommand(tasksCmd);
 program.addCommand(roadmapsCmd);
 program.addCommand(personaRunsCmd);
+program.addCommand(blogCmd);
+program.addCommand(apiKeysCmd);
 process.on("exit", () => {
   process.stderr.write("\n\n\n\n\n");
 });

package/package.json

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