@anthropologies/claudestory 0.1.13 → 0.1.15

package/dist/cli.js

@@ -262,7 +262,12 @@ var init_config = __esm({
       type: z6.string(),
       language: z6.string(),
       features: FeaturesSchema,
-      recipe: z6.string().optional()
+      recipe: z6.string().optional(),
+      recipeOverrides: z6.object({
+        maxTicketsPerSession: z6.number().min(0).optional(),
+        compactThreshold: z6.string().optional(),
+        reviewBackends: z6.array(z6.string()).optional()
+      }).optional()
     }).passthrough();
   }
 });
@@ -4491,9 +4496,9 @@ var init_session_types = __esm({
       supersededBy: z8.string().optional(),
       supersededSession: z8.string().optional(),
       stealReason: z8.string().optional(),
-      // Recipe overrides
+      // Recipe overrides (maxTicketsPerSession: 0 = no limit)
       config: z8.object({
-        maxTicketsPerSession: z8.number().default(3),
+        maxTicketsPerSession: z8.number().min(0).default(3),
         compactThreshold: z8.string().default("high"),
         reviewBackends: z8.array(z8.string()).default(["codex", "agent"])
       }).default({ maxTicketsPerSession: 3, compactThreshold: "high", reviewBackends: ["codex", "agent"] })
@@ -4527,7 +4532,7 @@ function statePath(dir) {
 function eventsPath(dir) {
   return join6(dir, "events.log");
 }
-function createSession(root, recipe, workspaceId) {
+function createSession(root, recipe, workspaceId, configOverrides) {
   const id = randomUUID();
   const dir = sessionDir(root, id);
   mkdirSync(dir, { recursive: true });
@@ -4563,9 +4568,9 @@ function createSession(root, recipe, workspaceId) {
     startedAt: now,
     guideCallCount: 0,
     config: {
-      maxTicketsPerSession: 3,
-      compactThreshold: "high",
-      reviewBackends: ["codex", "agent"]
+      maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 3,
+      compactThreshold: configOverrides?.compactThreshold ?? "high",
+      reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"]
     }
   };
   writeSessionSync(dir, state);
@@ -4973,8 +4978,21 @@ async function handleStart(root, args) {
     writeSessionSync(stale.dir, { ...stale.state, status: "superseded" });
   }
   const wsId = deriveWorkspaceId(root);
-  const recipe = "coding";
-  const session = createSession(root, recipe, wsId);
+  let recipe = "coding";
+  let sessionConfig = {};
+  try {
+    const { state: projectState } = await loadProject(root);
+    const projectConfig = projectState.config;
+    if (typeof projectConfig.recipe === "string") recipe = projectConfig.recipe;
+    if (projectConfig.recipeOverrides && typeof projectConfig.recipeOverrides === "object") {
+      const overrides = projectConfig.recipeOverrides;
+      if (typeof overrides.maxTicketsPerSession === "number") sessionConfig.maxTicketsPerSession = overrides.maxTicketsPerSession;
+      if (typeof overrides.compactThreshold === "string") sessionConfig.compactThreshold = overrides.compactThreshold;
+      if (Array.isArray(overrides.reviewBackends)) sessionConfig.reviewBackends = overrides.reviewBackends;
+    }
+  } catch {
+  }
+  const session = createSession(root, recipe, wsId, sessionConfig);
   const dir = sessionDir(root, session.sessionId);
   try {
     const headResult = await gitHead(root);
@@ -5579,7 +5597,7 @@ async function handleReportComplete(root, dir, state, report) {
   if (pressure === "critical") {
     nextState = "HANDOVER";
     advice = "compact-now";
-  } else if (ticketsDone >= maxTickets) {
+  } else if (maxTickets > 0 && ticketsDone >= maxTickets) {
     nextState = "HANDOVER";
   } else if (pressure === "high") {
     advice = "consider-compact";
@@ -6817,7 +6835,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.13";
+    version = "0.1.15";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -7696,10 +7714,95 @@ var init_hook_status = __esm({
   }
 });
 
+// src/cli/commands/config-update.ts
+var config_update_exports = {};
+__export(config_update_exports, {
+  handleConfigSetOverrides: () => handleConfigSetOverrides
+});
+import { readFileSync as readFileSync4 } from "fs";
+import { join as join15 } from "path";
+async function handleConfigSetOverrides(root, format, options) {
+  const { json: jsonArg, clear } = options;
+  if (!clear && !jsonArg) {
+    return {
+      output: format === "json" ? JSON.stringify({ version: 1, error: "Provide --json or --clear" }) : "Error: Provide --json or --clear",
+      errorCode: "invalid_input"
+    };
+  }
+  let parsedOverrides = {};
+  if (jsonArg) {
+    try {
+      parsedOverrides = JSON.parse(jsonArg);
+      if (typeof parsedOverrides !== "object" || parsedOverrides === null || Array.isArray(parsedOverrides)) {
+        return {
+          output: format === "json" ? JSON.stringify({ version: 1, error: "Invalid JSON: expected an object" }) : "Error: Invalid JSON: expected an object",
+          errorCode: "invalid_input"
+        };
+      }
+    } catch {
+      return {
+        output: format === "json" ? JSON.stringify({ version: 1, error: "Invalid JSON syntax" }) : "Error: Invalid JSON syntax",
+        errorCode: "invalid_input"
+      };
+    }
+  }
+  let resultOverrides = null;
+  await withProjectLock(root, { strict: false }, async () => {
+    const configPath = join15(root, ".story", "config.json");
+    const rawContent = readFileSync4(configPath, "utf-8");
+    const raw = JSON.parse(rawContent);
+    if (clear) {
+      delete raw.recipeOverrides;
+    } else {
+      const existing = raw.recipeOverrides ?? {};
+      const merged = { ...existing, ...parsedOverrides };
+      for (const [k, v] of Object.entries(merged)) {
+        if (v === null) delete merged[k];
+      }
+      if (Object.keys(merged).length === 0) {
+        delete raw.recipeOverrides;
+      } else {
+        raw.recipeOverrides = merged;
+      }
+    }
+    const validated = ConfigSchema.safeParse(raw);
+    if (!validated.success) {
+      const message = validated.error.issues.map((i) => i.message).join("; ");
+      throw new ProjectLoaderError(
+        "invalid_input",
+        `Invalid config after merge: ${message}`
+      );
+    }
+    await guardPath(configPath, root);
+    await atomicWrite(configPath, JSON.stringify(raw, null, 2) + "\n");
+    resultOverrides = raw.recipeOverrides ?? null;
+  });
+  const data = { recipeOverrides: resultOverrides };
+  if (format === "json") {
+    return { output: JSON.stringify({ version: 1, data }, null, 2) };
+  }
+  if (resultOverrides === null) {
+    return { output: "Recipe overrides cleared (using recipe defaults)." };
+  }
+  const lines = Object.entries(resultOverrides).map(([k, v]) => `  ${k}: ${JSON.stringify(v)}`);
+  return { output: `Recipe overrides updated:
+${lines.join("\n")}` };
+}
+var init_config_update = __esm({
+  "src/cli/commands/config-update.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_project_loader();
+    init_config();
+    init_errors();
+  }
+});
+
 // src/cli/register.ts
 var register_exports = {};
 __export(register_exports, {
   registerBlockerCommand: () => registerBlockerCommand,
+  registerConfigCommand: () => registerConfigCommand,
   registerExportCommand: () => registerExportCommand,
   registerHandoverCommand: () => registerHandoverCommand,
   registerHookStatusCommand: () => registerHookStatusCommand,
@@ -9265,6 +9368,51 @@ function registerHookStatusCommand(yargs) {
     }
   );
 }
+function registerConfigCommand(yargs) {
+  return yargs.command(
+    "config",
+    "Manage project configuration",
+    (y) => y.command(
+      "set-overrides",
+      "Set or clear recipe overrides in config.json",
+      (y2) => y2.option("json", {
+        type: "string",
+        describe: "JSON object to merge into recipeOverrides"
+      }).option("clear", {
+        type: "boolean",
+        describe: "Remove recipeOverrides entirely (reset to defaults)"
+      }).option("format", {
+        choices: ["json", "md"],
+        default: "md",
+        describe: "Output format"
+      }),
+      async (argv) => {
+        const { handleConfigSetOverrides: handleConfigSetOverrides2 } = await Promise.resolve().then(() => (init_config_update(), config_update_exports));
+        const { writeOutput: writeOutput2 } = await Promise.resolve().then(() => (init_run(), run_exports));
+        const format = argv.format;
+        try {
+          const result = await handleConfigSetOverrides2(
+            process.cwd(),
+            format,
+            { json: argv.json, clear: argv.clear === true }
+          );
+          writeOutput2(result.output);
+          if (result.errorCode) process.exitCode = 1;
+        } catch (err) {
+          const { formatError: formatError2, ExitCode: ExitCode2 } = await Promise.resolve().then(() => (init_output_formatter(), output_formatter_exports));
+          const { ProjectLoaderError: ProjectLoaderError2 } = await Promise.resolve().then(() => (init_errors(), errors_exports));
+          if (err instanceof ProjectLoaderError2) {
+            writeOutput2(formatError2(err.code, err.message, format));
+          } else {
+            const message = err instanceof Error ? err.message : String(err);
+            writeOutput2(formatError2("io_error", message, format));
+          }
+          process.exitCode = ExitCode2.USER_ERROR;
+        }
+      }
+    ).demandCommand(1, "Specify a config subcommand. Available: set-overrides")
+  );
+}
 var init_register = __esm({
   "src/cli/register.ts"() {
     "use strict";
@@ -9319,9 +9467,10 @@ async function runCli() {
     registerReferenceCommand: registerReferenceCommand2,
     registerSelftestCommand: registerSelftestCommand2,
     registerSetupSkillCommand: registerSetupSkillCommand2,
-    registerHookStatusCommand: registerHookStatusCommand2
+    registerHookStatusCommand: registerHookStatusCommand2,
+    registerConfigCommand: registerConfigCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.13";
+  const version2 = "0.1.15";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");
@@ -9360,6 +9509,7 @@ async function runCli() {
   cli = registerSelftestCommand2(cli);
   cli = registerSetupSkillCommand2(cli);
   cli = registerHookStatusCommand2(cli);
+  cli = registerConfigCommand2(cli);
   function handleUnexpectedError(err) {
     if (err instanceof HandledError) return;
     const message = err instanceof Error ? err.message : String(err);

package/dist/index.d.ts

@@ -341,6 +341,19 @@ declare const ConfigSchema: z.ZodObject<{
         reviews: z.ZodBoolean;
     }, z.ZodTypeAny, "passthrough">>;
     recipe: z.ZodOptional<z.ZodString>;
+    recipeOverrides: z.ZodOptional<z.ZodObject<{
+        maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
+        compactThreshold: z.ZodOptional<z.ZodString>;
+        reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        maxTicketsPerSession?: number | undefined;
+        compactThreshold?: string | undefined;
+        reviewBackends?: string[] | undefined;
+    }, {
+        maxTicketsPerSession?: number | undefined;
+        compactThreshold?: string | undefined;
+        reviewBackends?: string[] | undefined;
+    }>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     version: z.ZodNumber;
     schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -367,6 +380,19 @@ declare const ConfigSchema: z.ZodObject<{
         reviews: z.ZodBoolean;
     }, z.ZodTypeAny, "passthrough">>;
     recipe: z.ZodOptional<z.ZodString>;
+    recipeOverrides: z.ZodOptional<z.ZodObject<{
+        maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
+        compactThreshold: z.ZodOptional<z.ZodString>;
+        reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        maxTicketsPerSession?: number | undefined;
+        compactThreshold?: string | undefined;
+        reviewBackends?: string[] | undefined;
+    }, {
+        maxTicketsPerSession?: number | undefined;
+        compactThreshold?: string | undefined;
+        reviewBackends?: string[] | undefined;
+    }>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     version: z.ZodNumber;
     schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -393,6 +419,19 @@ declare const ConfigSchema: z.ZodObject<{
         reviews: z.ZodBoolean;
     }, z.ZodTypeAny, "passthrough">>;
     recipe: z.ZodOptional<z.ZodString>;
+    recipeOverrides: z.ZodOptional<z.ZodObject<{
+        maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
+        compactThreshold: z.ZodOptional<z.ZodString>;
+        reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        maxTicketsPerSession?: number | undefined;
+        compactThreshold?: string | undefined;
+        reviewBackends?: string[] | undefined;
+    }, {
+        maxTicketsPerSession?: number | undefined;
+        compactThreshold?: string | undefined;
+        reviewBackends?: string[] | undefined;
+    }>>;
 }, z.ZodTypeAny, "passthrough">>;
 type Config = z.infer<typeof ConfigSchema>;
 
@@ -853,6 +892,19 @@ declare const SnapshotV1Schema: z.ZodObject<{
             reviews: z.ZodBoolean;
         }, z.ZodTypeAny, "passthrough">>;
         recipe: z.ZodOptional<z.ZodString>;
+        recipeOverrides: z.ZodOptional<z.ZodObject<{
+            maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
+            compactThreshold: z.ZodOptional<z.ZodString>;
+            reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        }, {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        }>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         version: z.ZodNumber;
         schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -879,6 +931,19 @@ declare const SnapshotV1Schema: z.ZodObject<{
             reviews: z.ZodBoolean;
         }, z.ZodTypeAny, "passthrough">>;
         recipe: z.ZodOptional<z.ZodString>;
+        recipeOverrides: z.ZodOptional<z.ZodObject<{
+            maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
+            compactThreshold: z.ZodOptional<z.ZodString>;
+            reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        }, {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        }>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         version: z.ZodNumber;
         schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -905,6 +970,19 @@ declare const SnapshotV1Schema: z.ZodObject<{
             reviews: z.ZodBoolean;
         }, z.ZodTypeAny, "passthrough">>;
         recipe: z.ZodOptional<z.ZodString>;
+        recipeOverrides: z.ZodOptional<z.ZodObject<{
+            maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
+            compactThreshold: z.ZodOptional<z.ZodString>;
+            reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        }, {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        }>>;
     }, z.ZodTypeAny, "passthrough">>;
     roadmap: z.ZodObject<{
         title: z.ZodString;
@@ -1185,6 +1263,11 @@ declare const SnapshotV1Schema: z.ZodObject<{
         };
         schemaVersion?: number | undefined;
         recipe?: string | undefined;
+        recipeOverrides?: {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        } | undefined;
     } & {
         [k: string]: unknown;
     };
@@ -1277,6 +1360,11 @@ declare const SnapshotV1Schema: z.ZodObject<{
         };
         schemaVersion?: number | undefined;
         recipe?: string | undefined;
+        recipeOverrides?: {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+        } | undefined;
     } & {
         [k: string]: unknown;
     };

package/dist/index.js

@@ -129,7 +129,12 @@ var ConfigSchema = z6.object({
   type: z6.string(),
   language: z6.string(),
   features: FeaturesSchema,
-  recipe: z6.string().optional()
+  recipe: z6.string().optional(),
+  recipeOverrides: z6.object({
+    maxTicketsPerSession: z6.number().min(0).optional(),
+    compactThreshold: z6.string().optional(),
+    reviewBackends: z6.array(z6.string()).optional()
+  }).optional()
 }).passthrough();
 
 // src/core/project-state.ts

package/dist/mcp.js

@@ -204,7 +204,12 @@ var init_config = __esm({
       type: z6.string(),
       language: z6.string(),
       features: FeaturesSchema,
-      recipe: z6.string().optional()
+      recipe: z6.string().optional(),
+      recipeOverrides: z6.object({
+        maxTicketsPerSession: z6.number().min(0).optional(),
+        compactThreshold: z6.string().optional(),
+        reviewBackends: z6.array(z6.string()).optional()
+      }).optional()
     }).passthrough();
   }
 });
@@ -4025,9 +4030,9 @@ var SessionStateSchema = z8.object({
   supersededBy: z8.string().optional(),
   supersededSession: z8.string().optional(),
   stealReason: z8.string().optional(),
-  // Recipe overrides
+  // Recipe overrides (maxTicketsPerSession: 0 = no limit)
   config: z8.object({
-    maxTicketsPerSession: z8.number().default(3),
+    maxTicketsPerSession: z8.number().min(0).default(3),
     compactThreshold: z8.string().default("high"),
     reviewBackends: z8.array(z8.string()).default(["codex", "agent"])
   }).default({ maxTicketsPerSession: 3, compactThreshold: "high", reviewBackends: ["codex", "agent"] })
@@ -4062,7 +4067,7 @@ function statePath(dir) {
 function eventsPath(dir) {
   return join6(dir, "events.log");
 }
-function createSession(root, recipe, workspaceId) {
+function createSession(root, recipe, workspaceId, configOverrides) {
   const id = randomUUID();
   const dir = sessionDir(root, id);
   mkdirSync(dir, { recursive: true });
@@ -4098,9 +4103,9 @@ function createSession(root, recipe, workspaceId) {
     startedAt: now,
     guideCallCount: 0,
     config: {
-      maxTicketsPerSession: 3,
-      compactThreshold: "high",
-      reviewBackends: ["codex", "agent"]
+      maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 3,
+      compactThreshold: configOverrides?.compactThreshold ?? "high",
+      reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"]
     }
   };
   writeSessionSync(dir, state);
@@ -4475,8 +4480,21 @@ async function handleStart(root, args) {
     writeSessionSync(stale.dir, { ...stale.state, status: "superseded" });
   }
   const wsId = deriveWorkspaceId(root);
-  const recipe = "coding";
-  const session = createSession(root, recipe, wsId);
+  let recipe = "coding";
+  let sessionConfig = {};
+  try {
+    const { state: projectState } = await loadProject(root);
+    const projectConfig = projectState.config;
+    if (typeof projectConfig.recipe === "string") recipe = projectConfig.recipe;
+    if (projectConfig.recipeOverrides && typeof projectConfig.recipeOverrides === "object") {
+      const overrides = projectConfig.recipeOverrides;
+      if (typeof overrides.maxTicketsPerSession === "number") sessionConfig.maxTicketsPerSession = overrides.maxTicketsPerSession;
+      if (typeof overrides.compactThreshold === "string") sessionConfig.compactThreshold = overrides.compactThreshold;
+      if (Array.isArray(overrides.reviewBackends)) sessionConfig.reviewBackends = overrides.reviewBackends;
+    }
+  } catch {
+  }
+  const session = createSession(root, recipe, wsId, sessionConfig);
   const dir = sessionDir(root, session.sessionId);
   try {
     const headResult = await gitHead(root);
@@ -5081,7 +5099,7 @@ async function handleReportComplete(root, dir, state, report) {
   if (pressure === "critical") {
     nextState = "HANDOVER";
     advice = "compact-now";
-  } else if (ticketsDone >= maxTickets) {
+  } else if (maxTickets > 0 && ticketsDone >= maxTickets) {
     nextState = "HANDOVER";
   } else if (pressure === "high") {
     advice = "consider-compact";
@@ -6016,7 +6034,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.13";
+var version = "0.1.15";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropologies/claudestory",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "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": [