@pebblehouse/odin-cli 0.4.2 → 0.6.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command14 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/auth/login.ts
 import { createServer } from "http";
@@ -311,14 +311,13 @@ 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) => {
+decisionsCmd.command("log <slug> <title>").description("Log a decision").option("--rationale <rationale>", "Decision rationale").option("--alternatives <alternatives>", "Alternatives considered").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");
@@ -327,42 +326,18 @@ decisionsCmd.command("log <slug> <title>").description("Log a decision").option(
 
 // 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").option("--limit <n>", "Number of context entries", "50").action(async (slug, opts) => {
-  const res = await apiRequest(`/pebbles/${slug}/context`, {
-    params: { limit: opts.limit }
-  });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-
-// src/commands/sessions.ts
-import { Command as Command5 } from "commander";
-var sessionsCmd = new Command5("sessions").description("Manage sessions");
-sessionsCmd.command("start <slug>").description("Start a session").option("--source <source>", "Session source", "claude-code").action(async (slug, opts) => {
-  const res = await apiRequest("/sessions", {
-    method: "POST",
-    body: { pebble_slug: slug, source: opts.source }
-  });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-sessionsCmd.command("list <slug>").description("List sessions for a pebble").action(async (slug) => {
-  const res = await apiRequest(`/sessions/by-pebble/${slug}`);
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-sessionsCmd.command("end <id>").description("End a session").option("--summary <summary>", "Session summary").option("--status <status>", "Final status", "completed").action(async (id, opts) => {
-  const res = await apiRequest(`/sessions/${id}`, {
-    method: "PUT",
-    body: { summary: opts.summary, status: opts.status }
-  });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
+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);
 });
 
 // src/commands/search.ts
-import { Command as Command6 } from "commander";
-var searchCmd = new Command6("search").description("Full-text search across Odin").argument("<query>", "Search query").option("--pebble <slug>", "Scope to a pebble").action(async (query, opts) => {
+import { Command as Command5 } from "commander";
+var searchCmd = new Command5("search").description("Full-text search across Odin").argument("<query>", "Search query").option("--pebble <slug>", "Scope to a pebble").action(async (query, opts) => {
   const params = { q: query };
   if (opts.pebble) params.pebble = opts.pebble;
   const res = await apiRequest("/search", { params });
@@ -371,9 +346,9 @@ var searchCmd = new Command6("search").description("Full-text search across Odin
 });
 
 // src/commands/plans.ts
-import { Command as Command7 } from "commander";
+import { Command as Command6 } from "commander";
 import { readFileSync as readFileSync4 } from "fs";
-var plansCmd = new Command7("plans").description("Manage plans");
+var plansCmd = new Command6("plans").description("Manage plans");
 plansCmd.command("list <slug>").description("List plans for a pebble").action(async (slug) => {
   const res = await apiRequest(`/pebbles/${slug}/plans`);
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -452,7 +427,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: {
@@ -472,154 +447,61 @@ plansCmd.command("remove-phase-link <slug> <planId> <phaseId> <linkId>").descrip
   if (res.error) process.exit(1);
 });
 
-// src/commands/conversations.ts
-import { Command as Command8 } from "commander";
-function collect(value, previous) {
-  return previous.concat([value]);
-}
-var conversationsCmd = new Command8("conversations").description("Manage conversations");
-conversationsCmd.command("list <slug>").description("List conversations for a pebble").action(async (slug) => {
-  const res = await apiRequest(`/pebbles/${slug}/conversations`);
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-conversationsCmd.command("get <slug> <id>").description("Get a conversation by ID").action(async (slug, id) => {
-  const res = await apiRequest(`/pebbles/${slug}/conversations/${id}`);
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-conversationsCmd.command("create <slug> <title>").description("Create a conversation").option("--summary <summary>", "Conversation summary").option("--key-point <point>", "Key point (repeatable)", collect, []).option("--decision <decision>", "Decision made (repeatable)", collect, []).option("--source-url <url>", "Source URL").option("--session-id <id>", "Link to active session").action(async (slug, title, opts) => {
-  const res = await apiRequest(`/pebbles/${slug}/conversations`, {
-    method: "POST",
-    body: {
-      title,
-      summary: opts.summary ?? null,
-      key_points: opts.keyPoint,
-      decisions_made: opts.decision,
-      source_url: opts.sourceUrl ?? null,
-      session_id: opts.sessionId ?? null
-    }
-  });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-conversationsCmd.command("update <slug> <id>").description("Update a conversation").option("--title <title>", "New title").option("--summary <summary>", "New summary").option("--key-point <point>", "Key point (repeatable, replaces existing)", collect, []).option("--decision <decision>", "Decision made (repeatable, replaces existing)", collect, []).option("--source-url <url>", "New source URL").action(async (slug, id, opts) => {
-  const body = {};
-  if (opts.title) body.title = opts.title;
-  if (opts.summary) body.summary = opts.summary;
-  if (opts.keyPoint.length > 0) body.key_points = opts.keyPoint;
-  if (opts.decision.length > 0) body.decisions_made = opts.decision;
-  if (opts.sourceUrl) body.source_url = opts.sourceUrl;
-  const res = await apiRequest(`/pebbles/${slug}/conversations/${id}`, {
-    method: "PUT",
-    body
-  });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-conversationsCmd.command("delete <slug> <id>").description("Delete a conversation").action(async (slug, id) => {
-  const res = await apiRequest(`/pebbles/${slug}/conversations/${id}`, {
-    method: "DELETE"
-  });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-
-// src/commands/specs.ts
-import { Command as Command9 } from "commander";
+// src/commands/artifacts.ts
+import { Command as Command7 } from "commander";
 import { readFileSync as readFileSync5 } from "fs";
-var specsCmd = new Command9("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");
   if (res.error) process.exit(1);
 });
 
-// src/commands/executions.ts
-import { Command as Command10 } from "commander";
-var executionsCmd = new Command10("executions").description("View Claude Code executions");
-executionsCmd.command("create <slug>").description("Create an execution record").requiredOption("--tool-name <name>", "Tool name").option("--session-id <id>", "Session ID").option("--summary-text <text>", "Summary text").option("--execution-type <type>", "Execution type (task|discovery|system|plan)").option("--raw-input <json>", "Raw input JSON").option("--raw-output <json>", "Raw output JSON").option("--files-read <files...>", "Files read").option("--files-modified <files...>", "Files modified").option("--prompt-number <n>", "Prompt number").option("--content-hash <hash>", "Content hash for dedup").action(async (slug, opts) => {
-  const body = {
-    tool_name: opts.toolName
-  };
-  if (opts.sessionId) body.session_id = opts.sessionId;
-  if (opts.summaryText) body.summary_text = opts.summaryText;
-  if (opts.executionType) body.execution_type = opts.executionType;
-  if (opts.rawInput) body.raw_input = opts.rawInput;
-  if (opts.rawOutput) body.raw_output = opts.rawOutput;
-  if (opts.filesRead) body.files_read = opts.filesRead;
-  if (opts.filesModified) body.files_modified = opts.filesModified;
-  if (opts.promptNumber) body.prompt_number = parseInt(opts.promptNumber, 10);
-  if (opts.contentHash) body.content_hash = opts.contentHash;
-  const res = await apiRequest(`/pebbles/${slug}/executions`, {
-    method: "POST",
-    body
-  });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-executionsCmd.command("list <slug>").description("List executions for a pebble").option("--session-id <id>", "Filter by session ID").option("--limit <n>", "Max results", "50").option("--offset <n>", "Offset for pagination", "0").action(async (slug, opts) => {
-  const params = {
-    limit: opts.limit,
-    offset: opts.offset
-  };
-  if (opts.sessionId) params.session_id = opts.sessionId;
-  const res = await apiRequest(`/pebbles/${slug}/executions`, { params });
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-executionsCmd.command("get <slug> <id>").description("Get a single execution").action(async (slug, id) => {
-  const res = await apiRequest(`/pebbles/${slug}/executions/${id}`);
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-
 // src/commands/versions.ts
-import { Command as Command11 } from "commander";
-var versionsCmd = new Command11("versions").description("View document version history");
+import { Command as Command8 } from "commander";
+var versionsCmd = new Command8("versions").description("View document version history");
 versionsCmd.command("list <slug> <docType>").description("List versions for a document").action(async (slug, docType) => {
   const res = await apiRequest(`/pebbles/${slug}/documents/${docType}/versions`);
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -632,9 +514,9 @@ versionsCmd.command("get <slug> <docType> <versionId>").description("Get a speci
 });
 
 // src/commands/guidelines.ts
-import { Command as Command12 } from "commander";
+import { Command as Command9 } from "commander";
 import { readFileSync as readFileSync6 } from "fs";
-var guidelinesCmd = new Command12("guidelines").description("Manage global guidelines");
+var guidelinesCmd = new Command9("guidelines").description("Manage global guidelines");
 guidelinesCmd.command("list").description("List guidelines").option("--category <category>", "Filter by category").option("--status <status>", "Filter by status (default: active)").option("--all", "Include deprecated guidelines").action(async (opts) => {
   const params = new URLSearchParams();
   if (opts.category) params.set("category", opts.category);
@@ -695,51 +577,6 @@ guidelinesCmd.command("deprecate <id>").description("Deprecate a guideline").act
   if (res.error) process.exit(1);
 });
 
-// src/commands/observations.ts
-import { Command as Command13 } from "commander";
-var observationsCmd = new Command13("observations").description(
-  "View and synthesize observations"
-);
-observationsCmd.command("list <slug>").description("List observations for a pebble").option("--limit <n>", "Max results", "50").option("--offset <n>", "Offset for pagination", "0").action(async (slug, opts) => {
-  const res = await apiRequest(
-    `/pebbles/${slug}/observations`,
-    {
-      params: { limit: opts.limit, offset: opts.offset }
-    }
-  );
-  process.stdout.write(JSON.stringify(res) + "\n");
-  if (res.error) process.exit(1);
-});
-observationsCmd.command("synthesize [slug]").description("Trigger observation synthesis (requires running worker)").action(async (slug) => {
-  try {
-    const body = {};
-    if (slug) body.slug = slug;
-    const res = await fetch("http://127.0.0.1:7433/synthesize", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body)
-    });
-    if (!res.ok) {
-      const text = await res.text();
-      console.error(`Worker returned ${res.status}: ${text}`);
-      process.exit(1);
-    }
-    const data = await res.json();
-    process.stdout.write(JSON.stringify(data) + "\n");
-  } catch (err) {
-    if (err instanceof Error && (err.message.includes("ECONNREFUSED") || err.message.includes("fetch failed"))) {
-      console.error(
-        "Worker not running. Start a Claude Code session to launch the worker."
-      );
-    } else {
-      console.error(
-        `Failed: ${err instanceof Error ? err.message : err}`
-      );
-    }
-    process.exit(1);
-  }
-});
-
 // src/index.ts
 import { readFileSync as readFileSync7 } from "fs";
 import { fileURLToPath } from "url";
@@ -763,7 +600,7 @@ ${RESET}
   ${DIM}${cwd}${RESET}
 `);
 }
-var program = new Command14();
+var program = new Command10();
 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();
@@ -783,15 +620,11 @@ program.addCommand(pebblesCmd);
 program.addCommand(docsCmd);
 program.addCommand(decisionsCmd);
 program.addCommand(contextCmd);
-program.addCommand(sessionsCmd);
 program.addCommand(searchCmd);
 program.addCommand(plansCmd);
-program.addCommand(conversationsCmd);
-program.addCommand(specsCmd);
-program.addCommand(executionsCmd);
+program.addCommand(artifactsCmd);
 program.addCommand(versionsCmd);
 program.addCommand(guidelinesCmd);
-program.addCommand(observationsCmd);
 process.on("exit", () => {
   process.stderr.write("\n\n\n\n\n");
 });

package/package.json

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