@pebblehouse/odin-cli 0.8.0 → 0.10.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command11 } from "commander";
+import { Command as Command13 } from "commander";
 
 // src/auth/login.ts
 import { createServer } from "http";
@@ -408,13 +408,19 @@ ${supersededTitles.map((t) => `   \u21B3 "${t}"`).join("\n")}
 
 // src/commands/context.ts
 import { Command as Command4 } from "commander";
-var contextCmd = new Command4("context").description("Get Tier 1 context for a pebble").argument("<slug>", "Pebble slug").action(async (slug) => {
-  console.error(`[odin context] T1 context endpoint is being rebuilt (Phase 5).`);
-  console.error(`In the meantime, use:`);
-  console.error(`  odin guidelines list`);
-  console.error(`  odin docs get ${slug} <type>`);
-  console.error(`  odin decisions list ${slug}`);
-  process.exit(0);
+var contextCmd = new Command4("context").description("Get Tier 1 context packet for a pebble (brief + rules + guidelines)").argument("<slug>", "Pebble slug").action(async (slug) => {
+  const res = await apiRequest(`/pebbles/${slug}/context`);
+  if (res.error) {
+    console.error(`error: ${res.error}`);
+    process.exit(1);
+  }
+  if (res.data?.context) {
+    process.stdout.write(res.data.context + "\n");
+  } else {
+    console.error(`No context available for "${slug}". Create a brief first:`);
+    console.error(`  odin briefs update ${slug} --file brief.md`);
+    process.exit(0);
+  }
 });
 
 // src/commands/search.ts
@@ -717,12 +723,154 @@ rulesCmd.command("deprecate <slug> <id>").description("Deprecate a rule").action
   if (res.error) process.exit(1);
 });
 
-// src/index.ts
+// src/commands/briefs.ts
+import { Command as Command11 } from "commander";
 import { readFileSync as readFileSync8 } from "fs";
+var briefsCmd = new Command11("briefs").description("Manage pebble context briefs");
+briefsCmd.command("get <slug>").description("Get the context brief for a pebble").action(async (slug) => {
+  const res = await apiRequest(`/pebbles/${slug}/brief`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+briefsCmd.command("update <slug>").description("Create or update the context brief").option("--content <content>", "Brief content").option("--file <path>", "Read content from file").option("--title <title>", "Brief title").option("--source <source>", "Source", "manual").action(async (slug, opts) => {
+  const content = opts.file ? readFileSync8(opts.file, "utf-8") : opts.content;
+  if (!content) {
+    console.error("error: --content or --file is required");
+    process.exit(1);
+  }
+  const body = { content, source: opts.source };
+  if (opts.title) body.title = opts.title;
+  const res = await apiRequest(`/pebbles/${slug}/brief`, {
+    method: "PUT",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+briefsCmd.command("delete <slug>").description("Delete the context brief for a pebble").action(async (slug) => {
+  const res = await apiRequest(`/pebbles/${slug}/brief`, { method: "DELETE" });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+briefsCmd.command("versions <slug>").description("List version history for a pebble's brief").action(async (slug) => {
+  const res = await apiRequest(`/pebbles/${slug}/brief/versions`);
+  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/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/index.ts
+import { readFileSync as readFileSync10 } from "fs";
 import { fileURLToPath } from "url";
 import { dirname as dirname2, resolve } from "path";
 var __dirname = dirname2(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync8(resolve(__dirname, "../package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync10(resolve(__dirname, "../package.json"), "utf-8"));
 var GOLD = "\x1B[33m";
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
@@ -740,7 +888,7 @@ ${RESET}
   ${DIM}${cwd}${RESET}
 `);
 }
-var program = new Command11();
+var program = new Command13();
 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();
@@ -766,6 +914,8 @@ program.addCommand(artifactsCmd);
 program.addCommand(versionsCmd);
 program.addCommand(guidelinesCmd);
 program.addCommand(rulesCmd);
+program.addCommand(briefsCmd);
+program.addCommand(blueprintsCmd);
 process.on("exit", () => {
   process.stderr.write("\n\n\n\n\n");
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pebblehouse/odin-cli",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "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"
   }
 }