@anthropologies/claudestory 0.1.43 → 0.1.45

package/dist/cli.js

@@ -8358,7 +8358,7 @@ function getInstalledVersion() {
   }
 }
 function getRunningVersion() {
-  return "0.1.43";
+  return "0.1.45";
 }
 var init_version_check = __esm({
   "src/autonomous/version-check.ts"() {
@@ -10923,7 +10923,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.43";
+    version = "0.1.45";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -14354,7 +14354,7 @@ async function runCli() {
     registerSessionCommand: registerSessionCommand2,
     registerRepairCommand: registerRepairCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.43";
+  const version2 = "0.1.45";
   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.43";
+  return "0.1.45";
 }
 
 // src/autonomous/guide.ts
@@ -10055,7 +10055,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.43";
+var version = "0.1.45";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropologies/claudestory",
-  "version": "0.1.43",
+  "version": "0.1.45",
   "license": "UNLICENSED",
   "description": "Cross-session context persistence for AI coding projects. Tracks tickets, issues, roadmap, and handovers so every session builds on the last.",
   "keywords": [

package/src/skill/SKILL.md

@@ -81,18 +81,39 @@ After `claudestory_status` returns, check in order:
 
 ## Step 3: Present Summary
 
-After loading context, present a concise summary:
+After loading context, present a summary that feels like a collaborator catching you up -- conversational, not a status report.
 
+Include:
 - Project progress (X/Y tickets complete, current phase)
 - What changed since last snapshot (from recap)
-- What the last session accomplished (from handover)
-- Next ticket to work on
-- Any high-severity issues or blockers
-- Key process rules (from lessons digest)
-
-For collaborative sessions, `claudestory_recommend` provides context-aware suggestions mixing tickets and issues. For autonomous sessions, `claudestory_ticket_next` provides queue-based next ticket.
-
-Then ask: **"What would you like to work on?"**
+- What the last session accomplished (from handover -- keep it to 1-2 sentences)
+- The recommended next ticket and why it's next (unblocked, high priority, continues recent work)
+- Any high-severity issues or blockers worth knowing about
+- Key process rules (from lessons digest -- only if there are lessons)
+
+Use `claudestory_recommend` for context-aware suggestions mixing tickets and issues.
+
+**First session guide (show only when handover count is 0 or 1):** If this is the user's first or second real session (setup handover is the only one), include a brief mode guide after the summary:
+
+```
+Tip: You can also use these modes anytime:
+  /story auto           I work through tickets autonomously -- plan, review, build, commit, loop
+  /story guided T-XXX   One ticket end-to-end with planning and code review
+  /story review T-XXX   Review code you already wrote
+```
+
+Show this once or twice, then never again. Returning users don't need it.
+
+End with `AskUserQuestion`:
+- question: "What would you like to do?"
+- header: "Next"
+- options:
+  - "Work on [recommended ticket title]" -- the ticket you just recommended
+  - "Something else" -- I'll ask what you have in mind
+  - "Autonomous mode" -- I'll work through tickets on my own
+- (Other always available for free-text input)
+
+This replaces the open-ended "What would you like to work on?" with a one-tap default. Most users want the recommended ticket -- make that effortless.
 
 ## Session Lifecycle
 

package/src/skill/setup-flow.md

@@ -372,12 +372,12 @@ Re-show this `AskUserQuestion` after adjustments. Loop until "Looks good."
 #### 1d2. Refinement and Review
 
 After the user approves the proposal structure, use `AskUserQuestion` for refinement depth:
-- question: "How much refinement before creating?"
+- question: "Want me to refine these before creating?"
 - header: "Depth"
 - options:
-  - "Create as-is" -- skip refinement and review, execute immediately
-  - "Refine tickets" -- add descriptions, dependencies, sizing
-  - "Refine + independent review (if review tools available)" -- full pipeline
+  - "Yes, refine + get a second opinion (Recommended)" -- I'll refine, then have an independent reviewer check my work
+  - "Yes, refine them" -- I'll add descriptions, figure out dependencies, and flag oversized tickets
+  - "Create as-is" -- create tickets now with just titles
 
 If "Create as-is" and no brief exists: warn "Note: tickets will have titles only -- you can add descriptions later."
 
@@ -436,7 +436,7 @@ After refinement, run an independent review of the full proposal (phases, ticket
 - question: "Write project governance files?"
 - header: "Files"
 - options:
-  - "Write both" -- CLAUDE.md and RULES.md
+  - "Write both (Recommended)" -- CLAUDE.md and RULES.md
   - "CLAUDE.md only"
   - "RULES.md only"
   - "Skip" -- I'll write them manually
@@ -487,7 +487,12 @@ After creation completes:
 - Confirm what was created (e.g., "Created 5 phases, 18 tickets, 3 issues, CLAUDE.md, and RULES.md")
 - Check if `.gitignore` includes `.story/snapshots/` (warn if missing -- snapshots should not be committed)
 - Write an initial handover documenting the setup decisions. Explicitly capture which gates were answered and what was chosen: surface, characteristics, stack, system shape, execution model, deployment, data model, domain complexity, auth model, sensitive domain, AI pattern/provider/processing (if applicable), design source. This handover is the source of truth for decisions; CLAUDE.md is the project description.
-- Setup complete. Continue with **Step 2: Load Context** in SKILL.md (already in your context). Execute all 6 steps -- the project now has data to load.
+
+Present a brief completion message and tell the user how to start:
+
+"Your project is set up -- [X] phases, [Y] tickets, CLAUDE.md, and RULES.md created. Type **`/story`** at the start of any session to load context and see what to work on. Or type **`/story auto`** to let me work through the tickets autonomously."
+
+Keep it to 2-3 sentences. The system teaches itself through use -- `/story` loads context, shows status, and suggests next work. No need for a manual.
 
 ---