@anthropologies/claudestory 0.1.55 → 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.55";
+  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.55";
+    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.55";
+  const version2 = "0.1.56";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/index.d.ts

@@ -1377,42 +1377,15 @@ declare const SnapshotV1Schema: z.ZodObject<{
         file: z.ZodString;
         message: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        type: string;
         message: string;
+        type: string;
         file: string;
     }, {
-        type: string;
         message: string;
+        type: string;
         file: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    version: 1;
-    config: {
-        version: number;
-        type: string;
-        language: string;
-        project: string;
-        features: {
-            issues: boolean;
-            tickets: boolean;
-            handovers: boolean;
-            roadmap: boolean;
-            reviews: boolean;
-        } & {
-            [k: string]: unknown;
-        };
-        schemaVersion?: number | undefined;
-        recipe?: string | undefined;
-        recipeOverrides?: {
-            maxTicketsPerSession?: number | undefined;
-            compactThreshold?: string | undefined;
-            reviewBackends?: string[] | undefined;
-            handoverInterval?: number | undefined;
-            stages?: Record<string, Record<string, unknown>> | undefined;
-        } | undefined;
-    } & {
-        [k: string]: unknown;
-    };
     issues: z.objectOutputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1449,8 +1422,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         claimedBySession: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.ZodTypeAny, "passthrough">[];
     roadmap: {
-        date: string;
         title: string;
+        date: string;
         phases: z.objectOutputType<{
             id: z.ZodString;
             label: z.ZodString;
@@ -1468,6 +1441,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
+    version: 1;
     project: string;
     notes: z.objectOutputType<{
         id: z.ZodString;
@@ -1493,19 +1467,11 @@ declare const SnapshotV1Schema: z.ZodObject<{
         status: z.ZodEnum<["active", "deprecated", "superseded"]>;
     }, z.ZodTypeAny, "passthrough">[];
     createdAt: string;
-    handoverFilenames: string[];
-    warnings?: {
-        type: string;
-        message: string;
-        file: string;
-    }[] | undefined;
-}, {
-    version: 1;
     config: {
-        version: number;
         type: string;
-        language: string;
+        version: number;
         project: string;
+        language: string;
         features: {
             issues: boolean;
             tickets: boolean;
@@ -1527,6 +1493,13 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
+    handoverFilenames: string[];
+    warnings?: {
+        message: string;
+        type: string;
+        file: string;
+    }[] | undefined;
+}, {
     issues: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1563,8 +1536,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         claimedBySession: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.ZodTypeAny, "passthrough">[];
     roadmap: {
-        date: string;
         title: string;
+        date: string;
         phases: z.objectInputType<{
             id: z.ZodString;
             label: z.ZodString;
@@ -1582,8 +1555,35 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
+    version: 1;
     project: string;
     createdAt: string;
+    config: {
+        type: string;
+        version: number;
+        project: string;
+        language: string;
+        features: {
+            issues: boolean;
+            tickets: boolean;
+            handovers: boolean;
+            roadmap: boolean;
+            reviews: boolean;
+        } & {
+            [k: string]: unknown;
+        };
+        schemaVersion?: number | undefined;
+        recipe?: string | undefined;
+        recipeOverrides?: {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } & {
+        [k: string]: unknown;
+    };
     notes?: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodNullable<z.ZodString>;
@@ -1608,8 +1608,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         status: z.ZodEnum<["active", "deprecated", "superseded"]>;
     }, z.ZodTypeAny, "passthrough">[] | undefined;
     warnings?: {
-        type: string;
         message: string;
+        type: string;
         file: string;
     }[] | undefined;
     handoverFilenames?: string[] | undefined;

package/dist/mcp.js

@@ -7816,7 +7816,7 @@ function getInstalledVersion() {
   }
 }
 function getRunningVersion() {
-  return "0.1.55";
+  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.55";
+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.55",
-  "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

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