@pebblehouse/odin-cli 0.6.0 → 0.8.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/auth/login.ts
 import { createServer } from "http";
@@ -311,7 +311,49 @@ decisionsCmd.command("get <slug> <id>").description("Get a decision by ID").acti
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-decisionsCmd.command("log <slug> <title>").description("Log a decision").option("--rationale <rationale>", "Decision rationale").option("--alternatives <alternatives>", "Alternatives considered").action(async (slug, title, opts) => {
+async function detectSupersedes(newTitle, newRationale, recentDecisions) {
+  const apiKey = process.env.ANTHROPIC_API_KEY;
+  if (!apiKey || recentDecisions.length === 0) return [];
+  const decisionList = recentDecisions.map((d) => `- ID: ${d.id} | Title: "${d.title}" | Rationale: "${d.rationale ?? "none"}"`).join("\n");
+  const prompt = `You are an architectural decision tracker. A new decision is being logged:
+
+Title: "${newTitle}"
+Rationale: "${newRationale ?? "none"}"
+
+Here are recent active decisions (last 3 days):
+${decisionList}
+
+Which of these recent decisions, if any, does the new decision SUPERSEDE (i.e., replace, override, or contradict)?
+
+Respond with ONLY a JSON array of IDs that are superseded. If none are superseded, respond with [].
+Example: ["uuid-1", "uuid-2"] or []`;
+  try {
+    const res = await fetch("https://api.anthropic.com/v1/messages", {
+      method: "POST",
+      headers: {
+        "x-api-key": apiKey,
+        "anthropic-version": "2023-06-01",
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        model: "claude-haiku-4-5-20251001",
+        max_tokens: 256,
+        messages: [{ role: "user", content: prompt }]
+      })
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    const text = data?.content?.[0]?.text?.trim() ?? "[]";
+    const match = text.match(/\[.*\]/s);
+    if (!match) return [];
+    const ids = JSON.parse(match[0]);
+    const validIds = new Set(recentDecisions.map((d) => d.id));
+    return ids.filter((id) => validIds.has(id));
+  } catch {
+    return [];
+  }
+}
+decisionsCmd.command("log <slug> <title>").description("Log a decision").option("--rationale <rationale>", "Decision rationale").option("--alternatives <alternatives>", "Alternatives considered").option("--no-auto-supersede", "Skip automatic supersede detection").action(async (slug, title, opts) => {
   const res = await apiRequest(`/pebbles/${slug}/decisions`, {
     method: "POST",
     body: {
@@ -320,8 +362,48 @@ decisionsCmd.command("log <slug> <title>").description("Log a decision").option(
       alternatives_considered: opts.alternatives
     }
   });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
+  if (res.error || !res.data) {
+    process.stdout.write(JSON.stringify(res) + "\n");
+    if (res.error) process.exit(1);
+    return;
+  }
+  const newDecision = res.data;
+  if (opts.autoSupersede) {
+    const threeDaysAgo = /* @__PURE__ */ new Date();
+    threeDaysAgo.setDate(threeDaysAgo.getDate() - 3);
+    const recentRes = await apiRequest(`/pebbles/${slug}/decisions`, {
+      params: { limit: "100" }
+    });
+    if (recentRes.data) {
+      const recentActive = recentRes.data.filter(
+        (d) => d.id !== newDecision.id && d.status === "active" && new Date(d.created_at) >= threeDaysAgo
+      );
+      const supersededIds = await detectSupersedes(title, opts.rationale, recentActive);
+      if (supersededIds.length > 0) {
+        const updateRes = await apiRequest(`/pebbles/${slug}/decisions/${newDecision.id}`, {
+          method: "PUT",
+          body: { supersedes: supersededIds }
+        });
+        for (const id of supersededIds) {
+          await apiRequest(`/pebbles/${slug}/decisions/${id}`, {
+            method: "PUT",
+            body: { status: "superseded" }
+          });
+        }
+        if (updateRes.data) {
+          const supersededTitles = recentActive.filter((d) => supersededIds.includes(d.id)).map((d) => d.title);
+          process.stderr.write(
+            `\u26A1 Auto-superseded ${supersededIds.length} decision(s):
+${supersededTitles.map((t) => `   \u21B3 "${t}"`).join("\n")}
+`
+          );
+          process.stdout.write(JSON.stringify({ data: updateRes.data, error: null }) + "\n");
+          return;
+        }
+      }
+    }
+  }
+  process.stdout.write(JSON.stringify({ data: newDecision, error: null }) + "\n");
 });
 
 // src/commands/context.ts
@@ -577,12 +659,70 @@ guidelinesCmd.command("deprecate <id>").description("Deprecate a guideline").act
   if (res.error) process.exit(1);
 });
 
-// src/index.ts
+// src/commands/rules.ts
+import { Command as Command10 } from "commander";
 import { readFileSync as readFileSync7 } from "fs";
+var rulesCmd = new Command10("rules").description("Manage pebble rules");
+rulesCmd.command("list <slug>").description("List rules for a pebble").option("--category <category>", "Filter by category").option("--status <status>", "Filter by status (default: active)").option("--all", "Include deprecated rules").action(async (slug, opts) => {
+  const params = {};
+  if (opts.category) params.category = opts.category;
+  if (opts.all) params.status = "all";
+  else if (opts.status) params.status = opts.status;
+  const res = await apiRequest(`/pebbles/${slug}/rules`, { params });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+rulesCmd.command("get <slug> <id>").description("Get a rule by ID").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/rules/${id}`);
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+rulesCmd.command("create <slug> <title>").description("Create a rule").option("--category <category>", "Category", "other").option("--content <content>", "Rule content (max 500 chars)").option("--file <path>", "Read content from file").option("--source <source>", "Source", "manual").action(async (slug, title, opts) => {
+  const content = opts.file ? readFileSync7(opts.file, "utf-8") : opts.content ?? "";
+  const res = await apiRequest(`/pebbles/${slug}/rules`, {
+    method: "POST",
+    body: { category: opts.category, title, content, source: opts.source }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+rulesCmd.command("update <slug> <id>").description("Update a rule").option("--title <title>", "New title").option("--content <content>", "New content (max 500 chars)").option("--file <path>", "Read content from file").option("--category <category>", "New category").option("--status <status>", "New status (active|deprecated)").option("--source <source>", "Source").action(async (slug, id, opts) => {
+  const body = {};
+  if (opts.title) body.title = opts.title;
+  if (opts.file) body.content = readFileSync7(opts.file, "utf-8");
+  else if (opts.content) body.content = opts.content;
+  if (opts.category) body.category = opts.category;
+  if (opts.status) body.status = opts.status;
+  if (opts.source) body.source = opts.source;
+  const res = await apiRequest(`/pebbles/${slug}/rules/${id}`, {
+    method: "PUT",
+    body
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+rulesCmd.command("delete <slug> <id>").description("Delete a rule").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/rules/${id}`, {
+    method: "DELETE"
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+rulesCmd.command("deprecate <slug> <id>").description("Deprecate a rule").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/rules/${id}`, {
+    method: "PUT",
+    body: { status: "deprecated" }
+  });
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error) process.exit(1);
+});
+
+// src/index.ts
+import { readFileSync as readFileSync8 } from "fs";
 import { fileURLToPath } from "url";
 import { dirname as dirname2, resolve } from "path";
 var __dirname = dirname2(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync7(resolve(__dirname, "../package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync8(resolve(__dirname, "../package.json"), "utf-8"));
 var GOLD = "\x1B[33m";
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
@@ -600,7 +740,7 @@ ${RESET}
   ${DIM}${cwd}${RESET}
 `);
 }
-var program = new Command10();
+var program = new Command11();
 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();
@@ -625,6 +765,7 @@ program.addCommand(plansCmd);
 program.addCommand(artifactsCmd);
 program.addCommand(versionsCmd);
 program.addCommand(guidelinesCmd);
+program.addCommand(rulesCmd);
 process.on("exit", () => {
   process.stderr.write("\n\n\n\n\n");
 });

package/package.json

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