@pebblehouse/odin-cli 0.5.0 → 0.7.0

package/dist/index.js

@@ -311,18 +311,99 @@ 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").option("--session-id <id>", "Link to active session").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: {
       title,
       rationale: opts.rationale,
-      alternatives_considered: opts.alternatives,
-      session_id: opts.sessionId
+      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
@@ -428,7 +509,7 @@ plansCmd.command("delete-phase <slug> <planId> <phaseId>").description("Delete a
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-plansCmd.command("add-phase-link <slug> <planId> <phaseId>").description("Add a link from a phase to a spec or document").requiredOption("--link-type <type>", "Link type (spec|plan_doc)").requiredOption("--target-type <type>", "Target type (agent_spec|document)").requiredOption("--target-id <id>", "Target entity UUID").action(async (slug, planId, phaseId, opts) => {
+plansCmd.command("add-phase-link <slug> <planId> <phaseId>").description("Add a link from a phase to a spec or document").requiredOption("--link-type <type>", "Link type (spec|plan_doc)").requiredOption("--target-type <type>", "Target type (artifact|document)").requiredOption("--target-id <id>", "Target entity UUID").action(async (slug, planId, phaseId, opts) => {
   const res = await apiRequest(`/pebbles/${slug}/plans/${planId}/phases/${phaseId}/links`, {
     method: "POST",
     body: {
@@ -448,53 +529,52 @@ plansCmd.command("remove-phase-link <slug> <planId> <phaseId> <linkId>").descrip
   if (res.error) process.exit(1);
 });
 
-// src/commands/specs.ts
+// src/commands/artifacts.ts
 import { Command as Command7 } from "commander";
 import { readFileSync as readFileSync5 } from "fs";
-var specsCmd = new Command7("specs").description("Manage agent specs");
-specsCmd.command("list <slug>").description("List specs for a pebble").option("--source <source>", "Filter by source (claude-code, superpowers, etc.)").action(async (slug, opts) => {
+var artifactsCmd = new Command7("artifacts").description("Manage artifacts");
+artifactsCmd.command("list <slug>").description("List artifacts for a pebble").option("--source <source>", "Filter by source (claude-code, superpowers, etc.)").action(async (slug, opts) => {
   const params = {};
   if (opts.source) params.source = opts.source;
-  const res = await apiRequest(`/pebbles/${slug}/agent-specs`, { params });
+  const res = await apiRequest(`/pebbles/${slug}/artifacts`, { params });
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-specsCmd.command("get <slug> <id>").description("Get a spec by ID").action(async (slug, id) => {
-  const res = await apiRequest(`/pebbles/${slug}/agent-specs/${id}`);
+artifactsCmd.command("get <slug> <id>").description("Get an artifact by ID").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/artifacts/${id}`);
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-specsCmd.command("create <slug> <title>").description("Create a spec").requiredOption("--spec-type <type>", "Spec type (e.g. brainstorm, plan, research)").option("--source <source>", "Source agent", "claude-code").option("--content <content>", "Spec content").option("--file <path>", "Read content from file").option("--session-id <id>", "Link to active session").action(async (slug, title, opts) => {
+artifactsCmd.command("create <slug> <title>").description("Create an artifact").requiredOption("--type <type>", "Artifact type (e.g. brainstorm, plan, research, spec)").option("--source <source>", "Source agent", "claude-code").option("--content <content>", "Artifact content").option("--file <path>", "Read content from file").action(async (slug, title, opts) => {
   const content = opts.file ? readFileSync5(opts.file, "utf-8") : opts.content ?? "";
-  const res = await apiRequest(`/pebbles/${slug}/agent-specs`, {
+  const res = await apiRequest(`/pebbles/${slug}/artifacts`, {
     method: "POST",
     body: {
       title,
-      spec_type: opts.specType,
+      type: opts.type,
       source: opts.source,
-      content,
-      session_id: opts.sessionId ?? null
+      content
     }
   });
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-specsCmd.command("update <slug> <id>").description("Update a spec").option("--title <title>", "New title").option("--spec-type <type>", "New spec type").option("--source <source>", "New source").option("--content <content>", "New content").option("--file <path>", "Read content from file").action(async (slug, id, opts) => {
+artifactsCmd.command("update <slug> <id>").description("Update an artifact").option("--title <title>", "New title").option("--type <type>", "New type").option("--source <source>", "New source").option("--content <content>", "New content").option("--file <path>", "Read content from file").action(async (slug, id, opts) => {
   const body = {};
   if (opts.title) body.title = opts.title;
-  if (opts.specType) body.spec_type = opts.specType;
+  if (opts.type) body.type = opts.type;
   if (opts.source) body.source = opts.source;
   if (opts.file) body.content = readFileSync5(opts.file, "utf-8");
   else if (opts.content) body.content = opts.content;
-  const res = await apiRequest(`/pebbles/${slug}/agent-specs/${id}`, {
+  const res = await apiRequest(`/pebbles/${slug}/artifacts/${id}`, {
     method: "PUT",
     body
   });
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-specsCmd.command("delete <slug> <id>").description("Delete a spec").action(async (slug, id) => {
-  const res = await apiRequest(`/pebbles/${slug}/agent-specs/${id}`, {
+artifactsCmd.command("delete <slug> <id>").description("Delete an artifact").action(async (slug, id) => {
+  const res = await apiRequest(`/pebbles/${slug}/artifacts/${id}`, {
     method: "DELETE"
   });
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -624,7 +704,7 @@ program.addCommand(decisionsCmd);
 program.addCommand(contextCmd);
 program.addCommand(searchCmd);
 program.addCommand(plansCmd);
-program.addCommand(specsCmd);
+program.addCommand(artifactsCmd);
 program.addCommand(versionsCmd);
 program.addCommand(guidelinesCmd);
 process.on("exit", () => {

package/package.json

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