@anthropologies/claudestory 0.1.54 → 0.1.56

package/README.md

@@ -1,6 +1,6 @@
 # claudestory
 
-Cross-session context persistence for AI coding assistants. Tracks tickets, issues, roadmap phases, blockers, and session handovers in a `.story/` directory that AI tools read and write natively.
+An agentic development framework. Track tickets, issues, and progress for your project in a `.story/` directory that AI tools read and write natively.
 
 ## Installation
 

package/dist/cli.js

@@ -8358,7 +8358,7 @@ function getInstalledVersion() {
   }
 }
 function getRunningVersion() {
-  return "0.1.54";
+  return "0.1.56";
 }
 var init_version_check = __esm({
   "src/autonomous/version-check.ts"() {
@@ -8965,7 +8965,7 @@ ${ticket.description}` : "",
       "# Autonomous Session Started",
       "",
       `You are now in autonomous mode. ${sessionDesc}${checkpointDesc}`,
-      "Do NOT stop to summarize. Do NOT ask the user. Pick a ticket or issue and start working immediately.",
+      "Do NOT stop to summarize. Do NOT ask the user. Do NOT cancel for context management \u2014 compaction is automatic. Pick a ticket or issue and start working immediately.",
       "",
       "## Ticket Candidates",
       "",
@@ -8992,6 +8992,7 @@ ${ticket.description}` : "",
         "Do NOT ask the user for confirmation or approval.",
         "Do NOT stop or summarize between tickets \u2014 call autonomous_guide IMMEDIATELY.",
         "You are in autonomous mode \u2014 continue working until done.",
+        "NEVER cancel due to context size. Claude Story's hooks compact context automatically and preserve all session state.",
         ...versionWarning ? [`**Warning:** ${versionWarning}`] : []
       ],
       transitionedFrom: "INIT"
@@ -9315,7 +9316,8 @@ ${driftPreamble}Recovered to state: **${mapping.state}**. Continue from here.`,
       reminders: [
         "Do NOT stop or summarize. Pick the next ticket IMMEDIATELY.",
         "Do NOT ask the user for confirmation.",
-        "You are in autonomous mode \u2014 continue working."
+        "You are in autonomous mode \u2014 continue working.",
+        "Context compacted successfully \u2014 all session state preserved. Continue working."
       ]
     });
   }
@@ -9417,6 +9419,30 @@ async function handleCancel(root, args) {
   if (info.state.state === "SESSION_END" || info.state.status === "completed") {
     return guideError(new Error("Session already ended."));
   }
+  const isAutoMode = info.state.mode === "auto" || !info.state.mode;
+  const hasTicketsRemaining = info.state.config.maxTicketsPerSession === 0 || info.state.completedTickets.length < info.state.config.maxTicketsPerSession;
+  const isWorkingState = !["SESSION_END", "HANDOVER", "COMPACT"].includes(info.state.state);
+  if (isAutoMode && hasTicketsRemaining && isWorkingState) {
+    return {
+      content: [{
+        type: "text",
+        text: [
+          "# Cancel Rejected \u2014 Session Still Active",
+          "",
+          `You have completed ${info.state.completedTickets.length} ticket(s) with more work remaining.`,
+          "Do NOT cancel an autonomous session due to context size.",
+          "If you need to manage context, Claude Code handles compaction automatically.",
+          "",
+          "Continue working by calling `claudestory_autonomous_guide` with:",
+          "```json",
+          `{ "sessionId": "${info.state.sessionId}", "action": "report", "report": { "completedAction": "ticket_picked", "ticketId": "T-XXX" } }`,
+          "```",
+          "",
+          "To force-cancel (admin only), run: `claudestory session stop`"
+        ].join("\n")
+      }]
+    };
+  }
   await recoverPendingMutation(info.dir, info.state, root);
   const cancelInfo = findSessionById(root, args.sessionId) ?? info;
   let ticketReleased = false;
@@ -9483,12 +9509,18 @@ function guideResult(state, currentState, opts) {
     contextPressure: state.contextPressure?.level ?? "low",
     branch: state.git?.branch ?? null
   };
+  const allReminders = [...opts.reminders ?? []];
+  if ((state.mode === "auto" || !state.mode) && currentState !== "SESSION_END") {
+    allReminders.push(
+      "NEVER cancel this session due to context size. Compaction is automatic \u2014 Claude Story preserves all session state across compactions via hooks."
+    );
+  }
   const output = {
     sessionId: state.sessionId,
     state: currentState,
     transitionedFrom: opts.transitionedFrom,
     instruction: opts.instruction,
-    reminders: opts.reminders ?? [],
+    reminders: allReminders,
     contextAdvice: "ok",
     sessionSummary: summary
   };
@@ -10923,7 +10955,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.54";
+    version = "0.1.56";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -14354,7 +14386,7 @@ async function runCli() {
     registerSessionCommand: registerSessionCommand2,
     registerRepairCommand: registerRepairCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.54";
+  const version2 = "0.1.56";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -7816,7 +7816,7 @@ function getInstalledVersion() {
   }
 }
 function getRunningVersion() {
-  return "0.1.54";
+  return "0.1.56";
 }
 
 // src/autonomous/guide.ts
@@ -8439,7 +8439,7 @@ ${ticket.description}` : "",
       "# Autonomous Session Started",
       "",
       `You are now in autonomous mode. ${sessionDesc}${checkpointDesc}`,
-      "Do NOT stop to summarize. Do NOT ask the user. Pick a ticket or issue and start working immediately.",
+      "Do NOT stop to summarize. Do NOT ask the user. Do NOT cancel for context management \u2014 compaction is automatic. Pick a ticket or issue and start working immediately.",
       "",
       "## Ticket Candidates",
       "",
@@ -8466,6 +8466,7 @@ ${ticket.description}` : "",
         "Do NOT ask the user for confirmation or approval.",
         "Do NOT stop or summarize between tickets \u2014 call autonomous_guide IMMEDIATELY.",
         "You are in autonomous mode \u2014 continue working until done.",
+        "NEVER cancel due to context size. Claude Story's hooks compact context automatically and preserve all session state.",
         ...versionWarning ? [`**Warning:** ${versionWarning}`] : []
       ],
       transitionedFrom: "INIT"
@@ -8790,7 +8791,8 @@ ${driftPreamble}Recovered to state: **${mapping.state}**. Continue from here.`,
       reminders: [
         "Do NOT stop or summarize. Pick the next ticket IMMEDIATELY.",
         "Do NOT ask the user for confirmation.",
-        "You are in autonomous mode \u2014 continue working."
+        "You are in autonomous mode \u2014 continue working.",
+        "Context compacted successfully \u2014 all session state preserved. Continue working."
       ]
     });
   }
@@ -8892,6 +8894,30 @@ async function handleCancel(root, args) {
   if (info.state.state === "SESSION_END" || info.state.status === "completed") {
     return guideError(new Error("Session already ended."));
   }
+  const isAutoMode = info.state.mode === "auto" || !info.state.mode;
+  const hasTicketsRemaining = info.state.config.maxTicketsPerSession === 0 || info.state.completedTickets.length < info.state.config.maxTicketsPerSession;
+  const isWorkingState = !["SESSION_END", "HANDOVER", "COMPACT"].includes(info.state.state);
+  if (isAutoMode && hasTicketsRemaining && isWorkingState) {
+    return {
+      content: [{
+        type: "text",
+        text: [
+          "# Cancel Rejected \u2014 Session Still Active",
+          "",
+          `You have completed ${info.state.completedTickets.length} ticket(s) with more work remaining.`,
+          "Do NOT cancel an autonomous session due to context size.",
+          "If you need to manage context, Claude Code handles compaction automatically.",
+          "",
+          "Continue working by calling `claudestory_autonomous_guide` with:",
+          "```json",
+          `{ "sessionId": "${info.state.sessionId}", "action": "report", "report": { "completedAction": "ticket_picked", "ticketId": "T-XXX" } }`,
+          "```",
+          "",
+          "To force-cancel (admin only), run: `claudestory session stop`"
+        ].join("\n")
+      }]
+    };
+  }
   await recoverPendingMutation(info.dir, info.state, root);
   const cancelInfo = findSessionById(root, args.sessionId) ?? info;
   let ticketReleased = false;
@@ -8958,12 +8984,18 @@ function guideResult(state, currentState, opts) {
     contextPressure: state.contextPressure?.level ?? "low",
     branch: state.git?.branch ?? null
   };
+  const allReminders = [...opts.reminders ?? []];
+  if ((state.mode === "auto" || !state.mode) && currentState !== "SESSION_END") {
+    allReminders.push(
+      "NEVER cancel this session due to context size. Compaction is automatic \u2014 Claude Story preserves all session state across compactions via hooks."
+    );
+  }
   const output = {
     sessionId: state.sessionId,
     state: currentState,
     transitionedFrom: opts.transitionedFrom,
     instruction: opts.instruction,
-    reminders: opts.reminders ?? [],
+    reminders: allReminders,
     contextAdvice: "ok",
     sessionSummary: summary
   };
@@ -10055,7 +10087,7 @@ async function ensureGitignoreEntries(gitignorePath, entries) {
 // src/mcp/index.ts
 var ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
 var CONFIG_PATH2 = ".story/config.json";
-var version = "0.1.54";
+var version = "0.1.56";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@anthropologies/claudestory",
-  "version": "0.1.54",
-  "license": "UNLICENSED",
-  "description": "Cross-session context persistence for AI coding projects. Tracks tickets, issues, roadmap, and handovers so every session builds on the last.",
+  "version": "0.1.56",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "description": "An agentic development framework. Track tickets, issues, and progress for your project so every session builds on the last.",
   "keywords": [
     "claudestory",
     "claude-code",

package/src/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: story
-description: Cross-session context persistence for AI coding projects. Load project context, manage sessions, guide setup.
+description: Track tickets, issues, and progress for your project. Load project context, manage sessions, guide setup.
 ---
 
 # /story -- Project Context & Session Management
@@ -272,6 +272,8 @@ options:
 - "None" -- skip automated review
 ```
 
+Note: this sets the top-level `reviewBackends`. If the config has per-stage overrides in `stages.PLAN_REVIEW.backends` or `stages.CODE_REVIEW.backends`, those take precedence. When displaying settings, check for per-stage overrides and show them if present.
+
 **Handover frequency:**
 ```
 AskUserQuestion: "Write a handover after every N tickets?"
@@ -284,15 +286,27 @@ options: "Every ticket", "Every 3 tickets (default)", "Every 5 tickets", "Manual
 claudestory config set-overrides --json '<constructed JSON>'
 ```
 
-Show a confirmation of what changed.
+**IMPORTANT:** The `--json` argument takes only the `recipeOverrides` object, NOT the full config. Top-level fields (version, project, type, language) are NOT settable via this command.
+```
+# Correct:
+claudestory config set-overrides --json '{"maxTicketsPerSession": 10}'
+
+# Correct (stages):
+claudestory config set-overrides --json '{"stages": {"VERIFY": {"enabled": true}}}'
+
+# WRONG -- do not include top-level fields:
+claudestory config set-overrides --json '{"version": 2, "project": "foo"}'
+```
+
+Show a confirmation of what changed, then ask if the user wants to change anything else or is done. If done, return to normal session.
 
 ### Config Schema Reference
 
-Do NOT search source code for this. The schema is:
+Do NOT search source code for this. The full config.json schema is shown below. Only the `recipeOverrides` section is settable via `config set-overrides`.
 
 ```json
 {
-  "version": 1,
+  "version": 2,
   "schemaVersion": 1,
   "project": "string",
   "type": "string (npm, cargo, pip, etc.)",
@@ -305,7 +319,7 @@ Do NOT search source code for this. The schema is:
   "recipeOverrides": {
     "maxTicketsPerSession": "number (0 = unlimited, default: 5)",
     "compactThreshold": "string (high/medium/low, default: high)",
-    "reviewBackends": ["codex", "agent"],  // top-level default; per-stage backends override this
+    "reviewBackends": ["codex", "agent"],
     "handoverInterval": "number (default: 3)",
     "stages": {
       "WRITE_TESTS": {

package/src/skill/autonomous-mode.md

@@ -21,9 +21,21 @@ This file is referenced from SKILL.md for `/story auto`, `/story review`, `/stor
 - Follow the guide's instructions exactly -- it specifies which tools to call, what parameters to use
 - After each step completes, call `claudestory_autonomous_guide` with `action: "report"` and the results
 
+**Recommended setup for long sessions:**
+
+Run Claude Code with: `claude --model claude-opus-4-6 --dangerously-skip-permissions`
+
+- **Skip-permissions** enables unattended execution -- no approval prompts consuming context
+- **Claude Story handles compaction automatically** -- context preserved across compactions, do not cancel because context feels large
+- Use only in **trusted repositories** -- skip-permissions disables safety prompts for all tool use
+
 **If the guide says to compact:** Call `claudestory_autonomous_guide` with `action: "pre_compact"`, then run `/compact`, then call with `action: "resume"`.
 
-**If something goes wrong:** Call `claudestory_autonomous_guide` with `action: "cancel"` to cleanly end the session.
+**If something goes wrong:**
+- Context feels large -- do nothing, compaction is automatic via hooks
+- Compaction happened -- call with `action: "resume"` to continue
+- Session stuck after compact -- run `claudestory session clear-compact` in terminal, then `action: "resume"`
+- Unrecoverable error -- run `claudestory session stop` in terminal (admin escape hatch)
 
 ## Tiered Access -- Review, Plan, Guided Modes
 

package/src/skill/setup-flow.md

@@ -2,6 +2,8 @@
 
 This file is referenced from SKILL.md when no `.story/` directory exists but project indicators are present. SKILL.md has already determined that setup is needed before routing here.
 
+**Skill command name:** When this file references `/story` in user-facing output, use the actual command that invoked you (e.g., `/story` for standalone install, `/story:go` for plugin install). Same for `/story auto` -- use `/story:go auto` if invoked as a plugin.
+
 **If arriving from Step 2b (scaffold detection):** The project already has an empty `.story/` scaffold but no tickets. Skip 1a and start at **1b. Existing Project -- Analyze**.
 
 ## Design Rules