@anthropologies/claudestory 0.1.36 → 0.1.37

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -5266,6 +5266,7 @@ var init_session_types = __esm({
       "FINALIZE",
       "COMPACT",
       "LESSON_CAPTURE",
+      "ISSUE_FIX",
       "ISSUE_SWEEP"
     ]);
     IDLE_STATES = /* @__PURE__ */ new Set([
@@ -5294,6 +5295,7 @@ var init_session_types = __esm({
       "HANDOVER",
       "COMPLETE",
       "LESSON_CAPTURE",
+      "ISSUE_FIX",
       "ISSUE_SWEEP",
       "SESSION_END"
     ];
@@ -5342,6 +5344,14 @@ var init_session_types = __esm({
           timestamp: z9.string()
         })).default([])
       }).default({ plan: [], code: [] }),
+      // T-153: Current issue being fixed (null when working on a ticket)
+      currentIssue: z9.object({
+        id: z9.string(),
+        title: z9.string(),
+        severity: z9.string()
+      }).nullable().default(null),
+      // T-153: Issues resolved this session
+      resolvedIssues: z9.array(z9.string()).default([]),
       // Completed tickets this session
       completedTickets: z9.array(z9.object({
         id: z9.string(),
@@ -5845,7 +5855,7 @@ var init_state_machine = __esm({
       // start does INIT + LOAD_CONTEXT internally
       LOAD_CONTEXT: ["PICK_TICKET"],
       // internal (never seen by Claude)
-      PICK_TICKET: ["PLAN", "SESSION_END"],
+      PICK_TICKET: ["PLAN", "ISSUE_FIX", "SESSION_END"],
       PLAN: ["PLAN_REVIEW"],
       PLAN_REVIEW: ["IMPLEMENT", "WRITE_TESTS", "PLAN", "PLAN_REVIEW", "SESSION_END"],
       // approve → IMPLEMENT/WRITE_TESTS, reject → PLAN, stay for next round; SESSION_END for tiered exit
@@ -5859,8 +5869,11 @@ var init_state_machine = __esm({
       // approve → VERIFY/FINALIZE, reject → IMPLEMENT/PLAN, stay for next round; SESSION_END for tiered exit
       VERIFY: ["FINALIZE", "IMPLEMENT", "VERIFY"],
       // pass → FINALIZE, fail → IMPLEMENT, retry
-      FINALIZE: ["COMPLETE"],
+      FINALIZE: ["COMPLETE", "PICK_TICKET"],
+      // PICK_TICKET for issue-fix flow (bypass COMPLETE)
       COMPLETE: ["PICK_TICKET", "HANDOVER", "ISSUE_SWEEP", "SESSION_END"],
+      ISSUE_FIX: ["FINALIZE", "PICK_TICKET", "ISSUE_FIX"],
+      // T-153: fix done → FINALIZE, cancel → PICK_TICKET, retry self
       LESSON_CAPTURE: ["ISSUE_SWEEP", "HANDOVER", "LESSON_CAPTURE"],
       // advance → ISSUE_SWEEP, retry self, done → HANDOVER
       ISSUE_SWEEP: ["ISSUE_SWEEP", "HANDOVER", "PICK_TICKET"],
@@ -6420,28 +6433,52 @@ var init_pick_ticket = __esm({
             (c, i) => `${i + 1}. **${c.ticket.id}: ${c.ticket.title}** (${c.ticket.type})`
           ).join("\n");
         }
+        const highIssues = projectState.issues.filter(
+          (i) => i.status === "open" && (i.severity === "critical" || i.severity === "high")
+        );
+        let issuesText = "";
+        if (highIssues.length > 0) {
+          issuesText = "\n\n## Open Issues (high+ severity)\n\n" + highIssues.map(
+            (i, idx) => `${idx + 1}. **${i.id}: ${i.title}** (${i.severity})`
+          ).join("\n");
+        }
         const topCandidate = candidates.kind === "found" ? candidates.candidates[0] : null;
+        const hasIssues = highIssues.length > 0;
         return {
           instruction: [
-            "# Pick a Ticket",
+            "# Pick a Ticket or Issue",
+            "",
+            "## Ticket Candidates",
             "",
             candidatesText || "No ticket candidates found.",
+            issuesText,
             "",
-            topCandidate ? `Pick **${topCandidate.ticket.id}** (highest priority) by calling \`claudestory_autonomous_guide\` now:` : "Pick a ticket by calling `claudestory_autonomous_guide` now:",
+            topCandidate ? `Pick **${topCandidate.ticket.id}** (highest priority) or an open issue by calling \`claudestory_autonomous_guide\` now:` : hasIssues ? `Pick an issue to fix by calling \`claudestory_autonomous_guide\` now:` : "Pick a ticket by calling `claudestory_autonomous_guide` now:",
             "```json",
             topCandidate ? `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "ticket_picked", "ticketId": "${topCandidate.ticket.id}" } }` : `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "ticket_picked", "ticketId": "T-XXX" } }`,
-            "```"
+            "```",
+            ...hasIssues ? [
+              "",
+              "Or to fix an issue:",
+              "```json",
+              `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "issue_picked", "issueId": "${highIssues[0].id}" } }`,
+              "```"
+            ] : []
           ].join("\n"),
           reminders: [
-            "Do NOT stop or summarize. Call autonomous_guide IMMEDIATELY to pick a ticket.",
+            "Do NOT stop or summarize. Call autonomous_guide IMMEDIATELY to pick a ticket or issue.",
             "Do NOT ask the user for confirmation."
           ]
         };
       }
       async report(ctx, report) {
+        const issueId = report.issueId;
+        if (issueId) {
+          return this.handleIssuePick(ctx, issueId);
+        }
         const ticketId = report.ticketId;
         if (!ticketId) {
-          return { action: "retry", instruction: "report.ticketId is required when picking a ticket." };
+          return { action: "retry", instruction: "report.ticketId or report.issueId is required." };
         }
         const { state: projectState } = await ctx.loadProject();
         const ticket = projectState.ticketByID(ticketId);
@@ -6492,6 +6529,24 @@ ${ticket.description}` : "",
           }
         };
       }
+      // T-153: Handle issue pick -- validate and route to ISSUE_FIX
+      async handleIssuePick(ctx, issueId) {
+        const { state: projectState } = await ctx.loadProject();
+        const issue = projectState.issues.find((i) => i.id === issueId);
+        if (!issue) {
+          return { action: "retry", instruction: `Issue ${issueId} not found. Pick a valid issue or ticket.` };
+        }
+        if (issue.status !== "open") {
+          return { action: "retry", instruction: `Issue ${issueId} is ${issue.status}. Pick an open issue.` };
+        }
+        ctx.updateDraft({
+          currentIssue: { id: issue.id, title: issue.title, severity: issue.severity },
+          ticket: void 0,
+          reviews: { plan: [], code: [] },
+          finalizeCheckpoint: null
+        });
+        return { action: "goto", target: "ISSUE_FIX" };
+      }
     };
   }
 });
@@ -7486,10 +7541,13 @@ var init_finalize = __esm({
             "Code review passed. Time to commit.",
             "",
             ctx.state.ticket ? `1. Update ticket ${ctx.state.ticket.id} status to "complete" in .story/` : "",
-            "2. Stage only the files you created or modified for this ticket (code + .story/ changes). Do NOT use `git add -A` or `git add .`",
+            ctx.state.currentIssue ? `1. Ensure issue ${ctx.state.currentIssue.id} status is "resolved" in .story/issues/` : "",
+            "2. Stage only the files you created or modified for this work (code + .story/ changes). Do NOT use `git add -A` or `git add .`",
             '3. Call me with completedAction: "files_staged"'
           ].filter(Boolean).join("\n"),
-          reminders: ["Stage both code changes and .story/ ticket update in the same commit. Only stage files related to this ticket."],
+          reminders: [
+            ctx.state.currentIssue ? "Stage both code changes and .story/ issue update in the same commit. Only stage files related to this fix." : "Stage both code changes and .story/ ticket update in the same commit. Only stage files related to this ticket."
+          ],
           transitionedFrom: ctx.state.previousState ?? void 0
         };
       }
@@ -7532,9 +7590,9 @@ var init_finalize = __esm({
           const headResult = await gitHead(ctx.root);
           const previousHead = ctx.state.git.expectedHead ?? ctx.state.git.initHead;
           if (headResult.ok && previousHead && headResult.data.hash !== previousHead) {
+            const treeResult = await gitDiffTreeNames(ctx.root, headResult.data.hash);
             const ticketId2 = ctx.state.ticket?.id;
             if (ticketId2) {
-              const treeResult = await gitDiffTreeNames(ctx.root, headResult.data.hash);
               const ticketPath = `.story/tickets/${ticketId2}.json`;
               if (treeResult.ok && !treeResult.data.includes(ticketPath)) {
                 return {
@@ -7543,6 +7601,16 @@ var init_finalize = __esm({
                 };
               }
             }
+            const earlyIssueId = ctx.state.currentIssue?.id;
+            if (earlyIssueId) {
+              const issuePath = `.story/issues/${earlyIssueId}.json`;
+              if (treeResult.ok && !treeResult.data.includes(issuePath)) {
+                return {
+                  action: "retry",
+                  instruction: `Commit detected (${headResult.data.hash.slice(0, 7)}) but issue file ${issuePath} is not in the commit. Amend the commit to include it: \`git add ${issuePath} && git commit --amend --no-edit\`, then report completedAction: "commit_done" with the new hash.`
+                };
+              }
+            }
             ctx.writeState({ finalizeCheckpoint: "precommit_passed" });
             return this.handleCommit(ctx, { ...report, commitHash: headResult.data.hash });
           }
@@ -7576,6 +7644,16 @@ var init_finalize = __esm({
             };
           }
         }
+        const issueId = ctx.state.currentIssue?.id;
+        if (issueId) {
+          const issuePath = `.story/issues/${issueId}.json`;
+          if (!stagedResult.data.includes(issuePath)) {
+            return {
+              action: "retry",
+              instruction: `Issue file ${issuePath} is not staged. Run \`git add ${issuePath}\` and call me again with completedAction: "files_staged".`
+            };
+          }
+        }
         ctx.writeState({
           finalizeCheckpoint: overlapOverridden ? "staged_override" : "staged"
         });
@@ -7623,6 +7701,16 @@ var init_finalize = __esm({
             };
           }
         }
+        const precommitIssueId = ctx.state.currentIssue?.id;
+        if (precommitIssueId) {
+          const issuePath = `.story/issues/${precommitIssueId}.json`;
+          if (!stagedResult.data.includes(issuePath)) {
+            return {
+              action: "retry",
+              instruction: `Pre-commit hooks may have modified the staged set. Issue file ${issuePath} is no longer staged. Run \`git add ${issuePath}\` and call me again with completedAction: "files_staged".`
+            };
+          }
+        }
         ctx.writeState({ finalizeCheckpoint: "precommit_passed" });
         return {
           action: "retry",
@@ -7660,6 +7748,21 @@ var init_finalize = __esm({
         if (previousHead && normalizedHash === previousHead) {
           return { action: "retry", instruction: `No new commit detected: HEAD (${normalizedHash}) has not changed. Create a commit first, then report the new hash.` };
         }
+        const currentIssue = ctx.state.currentIssue;
+        if (currentIssue) {
+          ctx.writeState({
+            finalizeCheckpoint: "committed",
+            resolvedIssues: [...ctx.state.resolvedIssues ?? [], currentIssue.id],
+            currentIssue: null,
+            git: {
+              ...ctx.state.git,
+              mergeBase: normalizedHash,
+              expectedHead: normalizedHash
+            }
+          });
+          ctx.appendEvent("commit", { commitHash: normalizedHash, issueId: currentIssue.id });
+          return { action: "goto", target: "PICK_TICKET" };
+        }
         const completedTicket = ctx.state.ticket ? { id: ctx.state.ticket.id, title: ctx.state.ticket.title, commitHash: normalizedHash, risk: ctx.state.ticket.risk, realizedRisk: ctx.state.ticket.realizedRisk } : void 0;
         ctx.writeState({
           finalizeCheckpoint: "committed",
@@ -7884,6 +7987,85 @@ var init_lesson_capture = __esm({
   }
 });
 
+// src/autonomous/stages/issue-fix.ts
+var IssueFixStage;
+var init_issue_fix = __esm({
+  "src/autonomous/stages/issue-fix.ts"() {
+    "use strict";
+    init_esm_shims();
+    IssueFixStage = class {
+      id = "ISSUE_FIX";
+      async enter(ctx) {
+        const issue = ctx.state.currentIssue;
+        if (!issue) {
+          return { action: "goto", target: "PICK_TICKET" };
+        }
+        const { state: projectState } = await ctx.loadProject();
+        const fullIssue = projectState.issues.find((i) => i.id === issue.id);
+        const details = fullIssue ? [
+          `**${fullIssue.id}**: ${fullIssue.title}`,
+          "",
+          `Severity: ${fullIssue.severity}`,
+          fullIssue.impact ? `Impact: ${fullIssue.impact}` : "",
+          fullIssue.components.length > 0 ? `Components: ${fullIssue.components.join(", ")}` : "",
+          fullIssue.location.length > 0 ? `Location: ${fullIssue.location.join(", ")}` : ""
+        ].filter(Boolean).join("\n") : `**${issue.id}**: ${issue.title} (severity: ${issue.severity})`;
+        return {
+          instruction: [
+            "# Fix Issue",
+            "",
+            details,
+            "",
+            'Fix this issue, then update its status to "resolved" in `.story/issues/`.',
+            "Add a resolution description explaining the fix.",
+            "",
+            "When done, call `claudestory_autonomous_guide` with:",
+            "```json",
+            `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "issue_fixed" } }`,
+            "```"
+          ].join("\n"),
+          reminders: [
+            'Update the issue JSON: set status to "resolved", add resolution text, set resolvedDate.',
+            "Do NOT ask the user for confirmation."
+          ]
+        };
+      }
+      async report(ctx, _report) {
+        const issue = ctx.state.currentIssue;
+        if (!issue) {
+          return { action: "goto", target: "PICK_TICKET" };
+        }
+        const { state: projectState } = await ctx.loadProject();
+        const current = projectState.issues.find((i) => i.id === issue.id);
+        if (!current || current.status !== "resolved") {
+          return {
+            action: "retry",
+            instruction: `Issue ${issue.id} is still ${current?.status ?? "missing"}. Update its status to "resolved" in .story/issues/${issue.id}.json with a resolution description and resolvedDate, then report again.`,
+            reminders: ["Set status to 'resolved', add resolution text, set resolvedDate."]
+          };
+        }
+        return {
+          action: "goto",
+          target: "FINALIZE",
+          result: {
+            instruction: [
+              "# Finalize Issue Fix",
+              "",
+              `Issue ${issue.id} resolved. Time to commit.`,
+              "",
+              `1. Ensure .story/issues/${issue.id}.json is updated with status: "resolved"`,
+              "2. Stage only the files you modified for this fix (code + .story/ changes). Do NOT use `git add -A` or `git add .`",
+              '3. Call me with completedAction: "files_staged"'
+            ].join("\n"),
+            reminders: ["Stage both code changes and .story/ issue update in the same commit. Only stage files related to this fix."],
+            transitionedFrom: "ISSUE_FIX"
+          }
+        };
+      }
+    };
+  }
+});
+
 // src/autonomous/stages/issue-sweep.ts
 var IssueSweepStage;
 var init_issue_sweep = __esm({
@@ -8094,6 +8276,7 @@ var init_stages = __esm({
     init_finalize();
     init_complete();
     init_lesson_capture();
+    init_issue_fix();
     init_issue_sweep();
     init_handover2();
     registerStage(new PickTicketStage());
@@ -8108,6 +8291,7 @@ var init_stages = __esm({
     registerStage(new FinalizeStage());
     registerStage(new CompleteStage());
     registerStage(new LessonCaptureStage());
+    registerStage(new IssueFixStage());
     registerStage(new IssueSweepStage());
     registerStage(new HandoverStage());
   }
@@ -8670,13 +8854,22 @@ ${ticket.description}` : "",
     } else {
       candidatesText = "No tickets found.";
     }
+    const highIssues = projectState.issues.filter(
+      (i) => i.status === "open" && (i.severity === "critical" || i.severity === "high")
+    );
+    let issuesText = "";
+    if (highIssues.length > 0) {
+      issuesText = "\n\n## Open Issues (high+ severity)\n\n" + highIssues.map(
+        (i, idx) => `${idx + 1}. **${i.id}: ${i.title}** (${i.severity})`
+      ).join("\n");
+    }
     const guideRecOptions = buildGuideRecommendOptions(root);
     const recResult = recommend(projectState, 5, guideRecOptions);
     let recsText = "";
     if (recResult.recommendations.length > 0) {
-      const ticketRecs = recResult.recommendations.filter((r) => r.kind === "ticket");
-      if (ticketRecs.length > 0) {
-        recsText = "\n\n**Recommended:**\n" + ticketRecs.map(
+      const actionableRecs = recResult.recommendations.filter((r) => r.kind === "ticket" || r.kind === "issue");
+      if (actionableRecs.length > 0) {
+        recsText = "\n\n**Recommended:**\n" + actionableRecs.map(
           (r) => `- ${r.id}: ${r.title} (${r.reason})`
         ).join("\n");
       }
@@ -8696,21 +8889,30 @@ ${ticket.description}` : "",
     const interval = updated.config.handoverInterval ?? 3;
     const sessionDesc = maxTickets > 0 ? `Work continuously until all tickets are done or you reach ${maxTickets} tickets.` : "Work continuously until all tickets are done.";
     const checkpointDesc = interval > 0 ? ` A checkpoint handover will be saved every ${interval} tickets.` : "";
+    const hasHighIssues = highIssues.length > 0;
     const instruction = [
       "# Autonomous Session Started",
       "",
       `You are now in autonomous mode. ${sessionDesc}${checkpointDesc}`,
-      "Do NOT stop to summarize. Do NOT ask the user. Pick a ticket and start working immediately.",
+      "Do NOT stop to summarize. Do NOT ask the user. Pick a ticket or issue and start working immediately.",
       "",
       "## Ticket Candidates",
       "",
       candidatesText,
+      issuesText,
       recsText,
       "",
-      topCandidate ? `Pick **${topCandidate.ticket.id}** (highest priority) by calling \`claudestory_autonomous_guide\` now:` : "Pick a ticket by calling `claudestory_autonomous_guide` now:",
+      topCandidate ? `Pick **${topCandidate.ticket.id}** (highest priority) or an open issue by calling \`claudestory_autonomous_guide\` now:` : hasHighIssues ? "Pick an issue to fix by calling `claudestory_autonomous_guide` now:" : "Pick a ticket by calling `claudestory_autonomous_guide` now:",
       "```json",
       topCandidate ? `{ "sessionId": "${updated.sessionId}", "action": "report", "report": { "completedAction": "ticket_picked", "ticketId": "${topCandidate.ticket.id}" } }` : `{ "sessionId": "${updated.sessionId}", "action": "report", "report": { "completedAction": "ticket_picked", "ticketId": "T-XXX" } }`,
-      "```"
+      "```",
+      ...hasHighIssues ? [
+        "",
+        "Or to fix an issue:",
+        "```json",
+        `{ "sessionId": "${updated.sessionId}", "action": "report", "report": { "completedAction": "issue_picked", "issueId": "${highIssues[0].id}" } }`,
+        "```"
+      ] : []
     ].join("\n");
     return guideResult(updated, "PICK_TICKET", {
       instruction,
@@ -9285,6 +9487,7 @@ var init_guide = __esm({
       CODE_REVIEW: { state: "PLAN", resetPlan: true, resetCode: true },
       FINALIZE: { state: "IMPLEMENT", resetPlan: false, resetCode: true },
       LESSON_CAPTURE: { state: "PICK_TICKET", resetPlan: false, resetCode: false },
+      ISSUE_FIX: { state: "PICK_TICKET", resetPlan: false, resetCode: false },
       ISSUE_SWEEP: { state: "PICK_TICKET", resetPlan: false, resetCode: false }
     };
     SEVERITY_MAP = {
@@ -10646,7 +10849,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.36";
+    version = "0.1.37";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -14070,7 +14273,7 @@ async function runCli() {
     registerSessionCommand: registerSessionCommand2,
     registerRepairCommand: registerRepairCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.36";
+  const version2 = "0.1.37";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");