agent-trajectories 0.1.1 → 0.2.2

package/dist/cli/index.js

@@ -2,104 +2,41 @@
 import {
   FileStorage,
   abandonTrajectory,
+  addChapter,
   addDecision,
   completeTrajectory,
   createTrajectory,
   exportToJSON,
   exportToMarkdown,
-  exportToTimeline
-} from "../chunk-S3DXLZQ6.js";
+  exportToTimeline,
+  getSearchPaths
+} from "../chunk-2RSTDBLD.js";
 
 // src/cli/index.ts
 import { program } from "commander";
 
-// src/cli/commands/start.ts
-function registerStartCommand(program2) {
-  program2.command("start <title>").description("Start a new trajectory").option("-t, --task <id>", "External task ID").option("-s, --source <system>", "Task system (github, linear, jira, beads)").option("--url <url>", "URL to external task").action(async (title, options) => {
-    const storage = new FileStorage();
-    await storage.initialize();
-    const active = await storage.getActive();
-    if (active) {
-      console.error(`Error: Trajectory already active: ${active.id}`);
-      console.error(`Complete or abandon it first with: trail complete or trail abandon`);
-      throw new Error("Trajectory already active");
-    }
-    let source;
-    if (options.task) {
-      source = {
-        system: options.source || "plain",
-        id: options.task,
-        url: options.url
-      };
-    }
-    const trajectory = createTrajectory({
-      title,
-      source
-    });
-    await storage.save(trajectory);
-    console.log(`\u2713 Trajectory started: ${trajectory.id}`);
-    console.log(`  Title: ${title}`);
-    if (source) {
-      console.log(`  Linked to: ${source.id} (${source.system})`);
-    }
-  });
-}
-
-// src/cli/commands/status.ts
-function registerStatusCommand(program2) {
-  program2.command("status").description("Show active trajectory status").action(async () => {
+// src/cli/commands/abandon.ts
+function registerAbandonCommand(program2) {
+  program2.command("abandon").description("Abandon the active trajectory").option("-r, --reason <text>", "Reason for abandonment").action(async (options) => {
     const storage = new FileStorage();
     await storage.initialize();
     const active = await storage.getActive();
     if (!active) {
-      console.log("No active trajectory");
-      console.log('Start one with: trail start "Task description"');
-      return;
-    }
-    const duration = formatDuration(
-      (/* @__PURE__ */ new Date()).getTime() - new Date(active.startedAt).getTime()
-    );
-    const eventCount = active.chapters.reduce(
-      (sum, ch) => sum + ch.events.length,
-      0
-    );
-    const decisionCount = active.chapters.reduce(
-      (sum, ch) => sum + ch.events.filter((e) => e.type === "decision").length,
-      0
-    );
-    console.log(`Active Trajectory: ${active.id}`);
-    console.log(`\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`);
-    console.log(`Task:      ${active.task.title}`);
-    if (active.task.source) {
-      console.log(`Source:    ${active.task.source.system}:${active.task.source.id}`);
+      console.error("Error: No active trajectory");
+      throw new Error("No active trajectory");
     }
-    console.log(`Status:    ${active.status}`);
-    console.log(`Started:   ${duration} ago`);
-    console.log(`Chapters:  ${active.chapters.length}`);
-    console.log(`Events:    ${eventCount}`);
-    console.log(`Decisions: ${decisionCount}`);
-    if (active.chapters.length > 0) {
-      const currentChapter = active.chapters[active.chapters.length - 1];
-      console.log(`
-Current Chapter: ${currentChapter.title}`);
-      console.log(`  Agent: ${currentChapter.agentName}`);
+    const abandoned = abandonTrajectory(active, options.reason);
+    await storage.save(abandoned);
+    console.log(`\u2713 Trajectory abandoned: ${abandoned.id}`);
+    if (options.reason) {
+      console.log(`  Reason: ${options.reason}`);
     }
   });
 }
-function formatDuration(ms) {
-  const seconds = Math.floor(ms / 1e3);
-  const minutes = Math.floor(seconds / 60);
-  const hours = Math.floor(minutes / 60);
-  const days = Math.floor(hours / 24);
-  if (days > 0) return `${days}d ${hours % 24}h`;
-  if (hours > 0) return `${hours}h ${minutes % 60}m`;
-  if (minutes > 0) return `${minutes}m`;
-  return `${seconds}s`;
-}
 
 // src/cli/commands/complete.ts
 function registerCompleteCommand(program2) {
-  program2.command("complete").description("Complete the active trajectory with retrospective").option("--summary <text>", "Summary of what was accomplished").option("--approach <text>", "How the work was approached").option("--confidence <number>", "Confidence level 0-1", parseFloat).action(async (options) => {
+  program2.command("complete").description("Complete the active trajectory with retrospective").option("--summary <text>", "Summary of what was accomplished").option("--approach <text>", "How the work was approached").option("--confidence <number>", "Confidence level 0-1", Number.parseFloat).action(async (options) => {
     const storage = new FileStorage();
     await storage.initialize();
     const active = await storage.getActive();
@@ -129,28 +66,15 @@ function registerCompleteCommand(program2) {
   });
 }
 
-// src/cli/commands/abandon.ts
-function registerAbandonCommand(program2) {
-  program2.command("abandon").description("Abandon the active trajectory").option("-r, --reason <text>", "Reason for abandonment").action(async (options) => {
-    const storage = new FileStorage();
-    await storage.initialize();
-    const active = await storage.getActive();
-    if (!active) {
-      console.error("Error: No active trajectory");
-      throw new Error("No active trajectory");
-    }
-    const abandoned = abandonTrajectory(active, options.reason);
-    await storage.save(abandoned);
-    console.log(`\u2713 Trajectory abandoned: ${abandoned.id}`);
-    if (options.reason) {
-      console.log(`  Reason: ${options.reason}`);
-    }
-  });
-}
-
 // src/cli/commands/decision.ts
 function registerDecisionCommand(program2) {
-  program2.command("decision <choice>").description("Record a decision").option("-r, --reasoning <text>", "Why this choice was made (optional for minor decisions)").option("-a, --alternatives <items>", "Comma-separated alternatives considered").action(async (choice, options) => {
+  program2.command("decision <choice>").description("Record a decision").option(
+    "-r, --reasoning <text>",
+    "Why this choice was made (optional for minor decisions)"
+  ).option(
+    "-a, --alternatives <items>",
+    "Comma-separated alternatives considered"
+  ).action(async (choice, options) => {
     const storage = new FileStorage();
     await storage.initialize();
     const active = await storage.getActive();
@@ -178,149 +102,10 @@ function registerDecisionCommand(program2) {
   });
 }
 
-// src/cli/commands/list.ts
-function registerListCommand(program2) {
-  program2.command("list").description("List and search trajectories").option("-s, --status <status>", "Filter by status (active, completed, abandoned)").option("-l, --limit <number>", "Limit results", parseInt).option("--search <query>", "Search trajectories by title or content").action(async (options) => {
-    const storage = new FileStorage();
-    await storage.initialize();
-    let trajectories = await storage.list({
-      status: options.status,
-      limit: options.search ? void 0 : options.limit
-      // Apply limit after search
-    });
-    if (options.search) {
-      const query = options.search.toLowerCase();
-      trajectories = trajectories.filter((traj) => {
-        if (traj.title.toLowerCase().includes(query)) return true;
-        if (traj.id.toLowerCase().includes(query)) return true;
-        return false;
-      });
-      if (options.limit) {
-        trajectories = trajectories.slice(0, options.limit);
-      }
-    }
-    if (trajectories.length === 0) {
-      if (options.search) {
-        console.log(`No trajectories found matching "${options.search}"`);
-      } else {
-        console.log("No trajectories found");
-      }
-      return;
-    }
-    const searchNote = options.search ? ` matching "${options.search}"` : "";
-    console.log(`Found ${trajectories.length} trajectories${searchNote}:
-`);
-    for (const traj of trajectories) {
-      const statusIcon = getStatusIcon(traj.status);
-      const confidence = traj.confidence ? ` (${Math.round(traj.confidence * 100)}%)` : "";
-      console.log(`${statusIcon} ${traj.id}`);
-      console.log(`   ${traj.title}${confidence}`);
-      console.log(`   Started: ${formatDate(traj.startedAt)}`);
-      if (traj.completedAt) {
-        console.log(`   Completed: ${formatDate(traj.completedAt)}`);
-      }
-      console.log("");
-    }
-  });
-}
-function getStatusIcon(status) {
-  switch (status) {
-    case "active":
-      return "\u{1F504}";
-    case "completed":
-      return "\u2705";
-    case "abandoned":
-      return "\u274C";
-    default:
-      return "\u2022";
-  }
-}
-function formatDate(isoString) {
-  return new Date(isoString).toLocaleDateString("en-US", {
-    month: "short",
-    day: "numeric",
-    year: "numeric"
-  });
-}
-
-// src/cli/commands/show.ts
-function registerShowCommand(program2) {
-  program2.command("show <id>").description("Show trajectory details").option("-d, --decisions", "Show decisions only").action(async (id, options) => {
-    const storage = new FileStorage();
-    await storage.initialize();
-    const trajectory = await storage.get(id);
-    if (!trajectory) {
-      console.error(`Error: Trajectory not found: ${id}`);
-      throw new Error("Trajectory not found");
-    }
-    if (options.decisions) {
-      const decisions = extractDecisions(trajectory);
-      if (decisions.length === 0) {
-        console.log("No decisions recorded");
-        return;
-      }
-      console.log(`Decisions for ${trajectory.task.title}:
-`);
-      for (const decision of decisions) {
-        console.log(`\u2022 ${decision.question}`);
-        console.log(`  Chose: ${decision.chosen}`);
-        console.log(`  Reasoning: ${decision.reasoning}`);
-        if (decision.alternatives.length > 0) {
-          console.log(`  Alternatives: ${decision.alternatives.join(", ")}`);
-        }
-        console.log("");
-      }
-      return;
-    }
-    console.log(`Trajectory: ${trajectory.id}`);
-    console.log(`\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`);
-    console.log(`Title:   ${trajectory.task.title}`);
-    console.log(`Status:  ${trajectory.status}`);
-    console.log(`Started: ${trajectory.startedAt}`);
-    if (trajectory.completedAt) {
-      console.log(`Ended:   ${trajectory.completedAt}`);
-    }
-    if (trajectory.task.source) {
-      console.log(`Source:  ${trajectory.task.source.system}:${trajectory.task.source.id}`);
-    }
-    console.log(`
-Chapters: ${trajectory.chapters.length}`);
-    for (const chapter of trajectory.chapters) {
-      console.log(`  \u2022 ${chapter.title} (${chapter.agentName})`);
-      console.log(`    Events: ${chapter.events.length}`);
-    }
-    if (trajectory.retrospective) {
-      console.log(`
-Retrospective:`);
-      console.log(`  Summary: ${trajectory.retrospective.summary}`);
-      console.log(`  Confidence: ${Math.round(trajectory.retrospective.confidence * 100)}%`);
-    }
-  });
-}
-function extractDecisions(trajectory) {
-  const decisions = [];
-  if (trajectory.retrospective?.decisions) {
-    decisions.push(...trajectory.retrospective.decisions);
-  }
-  for (const chapter of trajectory.chapters) {
-    for (const event of chapter.events) {
-      if (event.type === "decision" && event.raw) {
-        const raw = event.raw;
-        if (raw.question && raw.chosen && raw.reasoning) {
-          if (!decisions.some((d) => d.question === raw.question)) {
-            decisions.push(raw);
-          }
-        }
-      }
-    }
-  }
-  return decisions;
-}
-
 // src/cli/commands/export.ts
-import { writeFile, mkdir } from "fs/promises";
-import { join } from "path";
 import { exec } from "child_process";
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
 
 // src/web/styles.ts
 var styles = `
@@ -679,7 +464,7 @@ h2 {
 function escapeHtml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
 }
-function formatDate2(isoDate) {
+function formatDate(isoDate) {
   const date = new Date(isoDate);
   return date.toLocaleDateString("en-US", {
     month: "short",
@@ -689,7 +474,7 @@ function formatDate2(isoDate) {
     minute: "2-digit"
   });
 }
-function formatDuration2(startDate, endDate) {
+function formatDuration(startDate, endDate) {
   const start = new Date(startDate).getTime();
   const end = endDate ? new Date(endDate).getTime() : Date.now();
   const ms = end - start;
@@ -721,33 +506,43 @@ function renderDecision(decision) {
        </div>` : "";
   return `
     <div class="decision">
-      <div class="decision-title">${escapeHtml(decision.title)}</div>
+      <div class="decision-title">${escapeHtml(decision.question)}: ${escapeHtml(decision.chosen)}</div>
       <div class="decision-reasoning">${escapeHtml(decision.reasoning)}</div>
       ${alternatives}
     </div>
   `;
 }
 function renderEvent(event) {
-  const time = formatDate2(event.timestamp);
+  const time = formatDate(new Date(event.ts).toISOString());
   let content = "";
   let typeClass = "";
+  const rawData = event.raw;
   switch (event.type) {
     case "decision":
       typeClass = "decision";
       content = `
         <strong>Decision:</strong> ${escapeHtml(event.content)}
-        ${event.metadata?.reasoning ? `<div class="decision-reasoning">${escapeHtml(event.metadata.reasoning)}</div>` : ""}
+        ${rawData?.reasoning ? `<div class="decision-reasoning">${escapeHtml(String(rawData.reasoning))}</div>` : ""}
       `;
       break;
-    case "observation":
-      content = `<strong>Observed:</strong> ${escapeHtml(event.content)}`;
+    case "thinking":
+      content = `<strong>Thinking:</strong> ${escapeHtml(event.content)}`;
       break;
-    case "action":
-      content = `<strong>Action:</strong> ${escapeHtml(event.content)}`;
+    case "prompt":
+      content = `<strong>Prompt:</strong> ${escapeHtml(event.content)}`;
       break;
     case "tool_call":
       content = `<strong>Tool:</strong> <code>${escapeHtml(event.content)}</code>`;
       break;
+    case "tool_result":
+      content = `<strong>Result:</strong> ${escapeHtml(event.content)}`;
+      break;
+    case "message_sent":
+      content = `<strong>Sent:</strong> ${escapeHtml(event.content)}`;
+      break;
+    case "message_received":
+      content = `<strong>Received:</strong> ${escapeHtml(event.content)}`;
+      break;
     case "error":
       content = `<strong style="color: var(--error)">Error:</strong> ${escapeHtml(event.content)}`;
       break;
@@ -772,7 +567,6 @@ function renderChapter(chapter, index) {
         Chapter ${index + 1}: ${escapeHtml(chapter.title)}
       </div>
       <div class="chapter-agent">Agent: ${escapeHtml(chapter.agentName)}</div>
-      ${chapter.summary ? `<p>${escapeHtml(chapter.summary)}</p>` : ""}
       ${chapter.events.length > 0 ? `
         <h3 class="collapsible" onclick="this.classList.toggle('open')">Events (${chapter.events.length})</h3>
         <div class="collapsible-content">
@@ -788,9 +582,10 @@ function renderRetrospective(trajectory) {
   }
   const retro = trajectory.retrospective;
   const confidencePercent = Math.round(retro.confidence * 100);
-  const wentWell = retro.wentWell?.length ? `<div><strong>What went well:</strong><ul class="list">${retro.wentWell.map((w) => `<li>${escapeHtml(w)}</li>`).join("")}</ul></div>` : "";
+  const approach = retro.approach ? `<div><strong>Approach:</strong><p>${escapeHtml(retro.approach)}</p></div>` : "";
+  const learnings = retro.learnings?.length ? `<div><strong>Learnings:</strong><ul class="list">${retro.learnings.map((l) => `<li>${escapeHtml(l)}</li>`).join("")}</ul></div>` : "";
   const challenges = retro.challenges?.length ? `<div><strong>Challenges:</strong><ul class="list">${retro.challenges.map((c) => `<li>${escapeHtml(c)}</li>`).join("")}</ul></div>` : "";
-  const wouldDoDifferently = retro.wouldDoDifferently?.length ? `<div><strong>Would do differently:</strong><ul class="list">${retro.wouldDoDifferently.map((w) => `<li>${escapeHtml(w)}</li>`).join("")}</ul></div>` : "";
+  const suggestions = retro.suggestions?.length ? `<div><strong>Suggestions:</strong><ul class="list">${retro.suggestions.map((s) => `<li>${escapeHtml(s)}</li>`).join("")}</ul></div>` : "";
   return `
     <div class="retrospective">
       <h3>\u{1F4DD} Retrospective</h3>
@@ -804,21 +599,20 @@ function renderRetrospective(trajectory) {
         <span>${confidencePercent}%</span>
       </div>
 
-      ${wentWell}
+      ${approach}
+      ${learnings}
       ${challenges}
-      ${wouldDoDifferently}
+      ${suggestions}
     </div>
   `;
 }
 function generateTrajectoryHtml(trajectory) {
   const statusClass = getStatusClass(trajectory.status);
-  const duration = formatDuration2(trajectory.startedAt, trajectory.completedAt);
+  const duration = formatDuration(trajectory.startedAt, trajectory.completedAt);
   const decisions = trajectory.chapters.flatMap(
-    (ch) => ch.events.filter((e) => e.type === "decision").map((e) => ({
-      title: e.content,
-      reasoning: e.metadata?.reasoning || "",
-      alternatives: e.metadata?.alternatives
-    }))
+    (ch) => ch.events.filter((e) => e.type === "decision" && e.raw).map((e) => e.raw).filter(
+      (d) => d !== void 0 && typeof d.question === "string"
+    )
   );
   const decisionsHtml = decisions.length ? `
       <h2 class="collapsible open" onclick="this.classList.toggle('open')">
@@ -874,7 +668,7 @@ function generateTrajectoryHtml(trajectory) {
       </div>
       <div class="meta-item">
         <span class="meta-label">Started</span>
-        <span class="meta-value">${formatDate2(trajectory.startedAt)}</span>
+        <span class="meta-value">${formatDate(trajectory.startedAt)}</span>
       </div>
       ${trajectory.task.source ? `
       <div class="meta-item">
@@ -907,7 +701,11 @@ function generateTrajectoryHtml(trajectory) {
 
 // src/cli/commands/export.ts
 function registerExportCommand(program2) {
-  program2.command("export [id]").description("Export a trajectory").option("-f, --format <format>", "Export format (md, json, timeline, html)", "md").option("-o, --output <path>", "Output file path").option("--open", "Open in browser (html format only)").action(async (id, options) => {
+  program2.command("export [id]").description("Export a trajectory").option(
+    "-f, --format <format>",
+    "Export format (md, json, timeline, html)",
+    "md"
+  ).option("-o, --output <path>", "Output file path").option("--open", "Open in browser (html format only)").action(async (id, options) => {
     const storage = new FileStorage();
     await storage.initialize();
     let trajectory;
@@ -921,7 +719,9 @@ function registerExportCommand(program2) {
       trajectory = await storage.getActive();
       if (!trajectory) {
         console.error("Error: No active trajectory and no ID provided");
-        console.error("Usage: trail export <id> or trail export (with active trajectory)");
+        console.error(
+          "Usage: trail export <id> or trail export (with active trajectory)"
+        );
         throw new Error("No trajectory specified");
       }
     }
@@ -936,8 +736,6 @@ function registerExportCommand(program2) {
       case "html":
         output = generateTrajectoryHtml(trajectory);
         break;
-      case "md":
-      case "markdown":
       default:
         output = exportToMarkdown(trajectory);
         break;
@@ -977,6 +775,317 @@ function openInBrowser(path) {
   });
 }
 
+// src/cli/commands/list.ts
+import { existsSync } from "fs";
+function registerListCommand(program2) {
+  program2.command("list").description("List and search trajectories").option(
+    "-s, --status <status>",
+    "Filter by status (active, completed, abandoned)"
+  ).option("-l, --limit <number>", "Limit results", Number.parseInt).option("--search <query>", "Search trajectories by title or content").action(async (options) => {
+    const searchPaths = getSearchPaths();
+    let allTrajectories = [];
+    const seenIds = /* @__PURE__ */ new Set();
+    for (const searchPath of searchPaths) {
+      if (!existsSync(searchPath)) {
+        continue;
+      }
+      const originalDataDir = process.env.TRAJECTORIES_DATA_DIR;
+      process.env.TRAJECTORIES_DATA_DIR = searchPath;
+      try {
+        const storage = new FileStorage();
+        await storage.initialize();
+        const trajectories = await storage.list({
+          status: options.status,
+          limit: options.search ? void 0 : void 0
+          // Don't limit per-path
+        });
+        for (const traj of trajectories) {
+          if (!seenIds.has(traj.id)) {
+            seenIds.add(traj.id);
+            allTrajectories.push(traj);
+          }
+        }
+      } finally {
+        if (originalDataDir !== void 0) {
+          process.env.TRAJECTORIES_DATA_DIR = originalDataDir;
+        } else {
+          process.env.TRAJECTORIES_DATA_DIR = void 0;
+        }
+      }
+    }
+    allTrajectories.sort(
+      (a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime()
+    );
+    if (options.search) {
+      const query = options.search.toLowerCase();
+      allTrajectories = allTrajectories.filter((traj) => {
+        if (traj.title.toLowerCase().includes(query)) return true;
+        if (traj.id.toLowerCase().includes(query)) return true;
+        return false;
+      });
+    }
+    if (options.limit) {
+      allTrajectories = allTrajectories.slice(0, options.limit);
+    }
+    if (allTrajectories.length === 0) {
+      if (options.search) {
+        console.log(`No trajectories found matching "${options.search}"`);
+      } else {
+        console.log("No trajectories found");
+      }
+      return;
+    }
+    const searchNote = options.search ? ` matching "${options.search}"` : "";
+    console.log(
+      `Found ${allTrajectories.length} trajectories${searchNote}:
+`
+    );
+    for (const traj of allTrajectories) {
+      const statusIcon = getStatusIcon(traj.status);
+      const confidence = traj.confidence ? ` (${Math.round(traj.confidence * 100)}%)` : "";
+      console.log(`${statusIcon} ${traj.id}`);
+      console.log(`   ${traj.title}${confidence}`);
+      console.log(`   Started: ${formatDate2(traj.startedAt)}`);
+      if (traj.completedAt) {
+        console.log(`   Completed: ${formatDate2(traj.completedAt)}`);
+      }
+      console.log("");
+    }
+  });
+}
+function getStatusIcon(status) {
+  switch (status) {
+    case "active":
+      return "\u{1F504}";
+    case "completed":
+      return "\u2705";
+    case "abandoned":
+      return "\u274C";
+    default:
+      return "\u2022";
+  }
+}
+function formatDate2(isoString) {
+  return new Date(isoString).toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric"
+  });
+}
+
+// src/cli/commands/show.ts
+import { existsSync as existsSync2 } from "fs";
+async function findTrajectory(id) {
+  const searchPaths = getSearchPaths();
+  for (const searchPath of searchPaths) {
+    if (!existsSync2(searchPath)) {
+      continue;
+    }
+    const originalDataDir = process.env.TRAJECTORIES_DATA_DIR;
+    process.env.TRAJECTORIES_DATA_DIR = searchPath;
+    try {
+      const storage = new FileStorage();
+      await storage.initialize();
+      const trajectory = await storage.get(id);
+      if (trajectory) {
+        return trajectory;
+      }
+    } finally {
+      if (originalDataDir !== void 0) {
+        process.env.TRAJECTORIES_DATA_DIR = originalDataDir;
+      } else {
+        process.env.TRAJECTORIES_DATA_DIR = void 0;
+      }
+    }
+  }
+  return null;
+}
+function registerShowCommand(program2) {
+  program2.command("show <id>").description("Show trajectory details").option("-d, --decisions", "Show decisions only").action(async (id, options) => {
+    const trajectory = await findTrajectory(id);
+    if (!trajectory) {
+      console.error(`Error: Trajectory not found: ${id}`);
+      throw new Error("Trajectory not found");
+    }
+    if (options.decisions) {
+      const decisions = extractDecisions(trajectory);
+      if (decisions.length === 0) {
+        console.log("No decisions recorded");
+        return;
+      }
+      console.log(`Decisions for ${trajectory.task.title}:
+`);
+      for (const decision of decisions) {
+        console.log(`\u2022 ${decision.question}`);
+        console.log(`  Chose: ${decision.chosen}`);
+        console.log(`  Reasoning: ${decision.reasoning}`);
+        if (decision.alternatives.length > 0) {
+          console.log(`  Alternatives: ${decision.alternatives.join(", ")}`);
+        }
+        console.log("");
+      }
+      return;
+    }
+    console.log(`Trajectory: ${trajectory.id}`);
+    console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+    console.log(`Title:   ${trajectory.task.title}`);
+    console.log(`Status:  ${trajectory.status}`);
+    console.log(`Started: ${trajectory.startedAt}`);
+    if (trajectory.completedAt) {
+      console.log(`Ended:   ${trajectory.completedAt}`);
+    }
+    if (trajectory.task.source) {
+      console.log(
+        `Source:  ${trajectory.task.source.system}:${trajectory.task.source.id}`
+      );
+    }
+    console.log(`
+Chapters: ${trajectory.chapters.length}`);
+    for (const chapter of trajectory.chapters) {
+      console.log(`  \u2022 ${chapter.title} (${chapter.agentName})`);
+      console.log(`    Events: ${chapter.events.length}`);
+    }
+    if (trajectory.retrospective) {
+      console.log("\nRetrospective:");
+      console.log(`  Summary: ${trajectory.retrospective.summary}`);
+      console.log(
+        `  Confidence: ${Math.round(trajectory.retrospective.confidence * 100)}%`
+      );
+    }
+  });
+}
+function extractDecisions(trajectory) {
+  const decisions = [];
+  if (trajectory.retrospective?.decisions) {
+    decisions.push(...trajectory.retrospective.decisions);
+  }
+  for (const chapter of trajectory.chapters) {
+    for (const event of chapter.events) {
+      if (event.type === "decision" && event.raw) {
+        const raw = event.raw;
+        if (raw.question && raw.chosen && raw.reasoning) {
+          if (!decisions.some((d) => d.question === raw.question)) {
+            decisions.push(raw);
+          }
+        }
+      }
+    }
+  }
+  return decisions;
+}
+
+// src/cli/commands/start.ts
+function registerStartCommand(program2) {
+  program2.command("start <title>").description("Start a new trajectory").option("-t, --task <id>", "External task ID").option(
+    "-s, --source <system>",
+    "Task system (github, linear, jira, beads)"
+  ).option("--url <url>", "URL to external task").option("-a, --agent <name>", "Agent name (or set TRAJECTORIES_AGENT)").option("-p, --project <id>", "Project ID (or set TRAJECTORIES_PROJECT)").option("-q, --quiet", "Only output trajectory ID (for scripting)").action(async (title, options) => {
+    const storage = new FileStorage();
+    await storage.initialize();
+    const active = await storage.getActive();
+    if (active) {
+      if (!options.quiet) {
+        console.error(`Error: Trajectory already active: ${active.id}`);
+        console.error(
+          "Complete or abandon it first with: trail complete or trail abandon"
+        );
+      }
+      throw new Error("Trajectory already active");
+    }
+    let source;
+    if (options.task) {
+      source = {
+        system: options.source || "plain",
+        id: options.task,
+        url: options.url
+      };
+    }
+    const agentName = options.agent ?? process.env.TRAJECTORIES_AGENT ?? void 0;
+    const projectId = options.project ?? process.env.TRAJECTORIES_PROJECT ?? void 0;
+    let trajectory = createTrajectory({
+      title,
+      source,
+      projectId
+    });
+    if (agentName) {
+      trajectory = addChapter(trajectory, {
+        title: "Initial work",
+        agentName
+      });
+    }
+    await storage.save(trajectory);
+    if (options.quiet) {
+      console.log(trajectory.id);
+    } else {
+      console.log(`\u2713 Trajectory started: ${trajectory.id}`);
+      console.log(`  Title: ${title}`);
+      if (agentName) {
+        console.log(`  Agent: ${agentName}`);
+      }
+      if (projectId) {
+        console.log(`  Project: ${projectId}`);
+      }
+      if (source) {
+        console.log(`  Linked to: ${source.id} (${source.system})`);
+      }
+    }
+  });
+}
+
+// src/cli/commands/status.ts
+function registerStatusCommand(program2) {
+  program2.command("status").description("Show active trajectory status").action(async () => {
+    const storage = new FileStorage();
+    await storage.initialize();
+    const active = await storage.getActive();
+    if (!active) {
+      console.log("No active trajectory");
+      console.log('Start one with: trail start "Task description"');
+      return;
+    }
+    const duration = formatDuration2(
+      (/* @__PURE__ */ new Date()).getTime() - new Date(active.startedAt).getTime()
+    );
+    const eventCount = active.chapters.reduce(
+      (sum, ch) => sum + ch.events.length,
+      0
+    );
+    const decisionCount = active.chapters.reduce(
+      (sum, ch) => sum + ch.events.filter((e) => e.type === "decision").length,
+      0
+    );
+    console.log(`Active Trajectory: ${active.id}`);
+    console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+    console.log(`Task:      ${active.task.title}`);
+    if (active.task.source) {
+      console.log(
+        `Source:    ${active.task.source.system}:${active.task.source.id}`
+      );
+    }
+    console.log(`Status:    ${active.status}`);
+    console.log(`Started:   ${duration} ago`);
+    console.log(`Chapters:  ${active.chapters.length}`);
+    console.log(`Events:    ${eventCount}`);
+    console.log(`Decisions: ${decisionCount}`);
+    if (active.chapters.length > 0) {
+      const currentChapter = active.chapters[active.chapters.length - 1];
+      console.log(`
+Current Chapter: ${currentChapter.title}`);
+      console.log(`  Agent: ${currentChapter.agentName}`);
+    }
+  });
+}
+function formatDuration2(ms) {
+  const seconds = Math.floor(ms / 1e3);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (days > 0) return `${days}d ${hours % 24}h`;
+  if (hours > 0) return `${hours}h ${minutes % 60}m`;
+  if (minutes > 0) return `${minutes}m`;
+  return `${seconds}s`;
+}
+
 // src/cli/commands/index.ts
 function registerCommands(program2) {
   registerStartCommand(program2);
@@ -990,7 +1099,15 @@ function registerCommands(program2) {
 }
 
 // src/cli/index.ts
-program.name("trail").description("Leave a trail of your work for others to follow").version("0.1.0");
+program.name("trail").description("Leave a trail of your work for others to follow").version("0.1.0").option(
+  "--data-dir <path>",
+  "Override trajectory storage directory (or set TRAJECTORIES_DATA_DIR)"
+).hook("preAction", (thisCommand) => {
+  const opts = thisCommand.opts();
+  if (opts.dataDir) {
+    process.env.TRAJECTORIES_DATA_DIR = opts.dataDir;
+  }
+});
 registerCommands(program);
 program.parse();
 //# sourceMappingURL=index.js.map