@ikunin/sprintpilot 1.0.2 → 1.0.4

package/_Sprintpilot/skills/sprintpilot-codebase-map/agents/quality-assessor.md

@@ -19,35 +19,47 @@ Scan the project at `{{project_root}}` and write your findings to `{{output_file
 - `*.key`, `*.pem`, `*.p12` (private keys)
 - `credentials.json`, `service-account.json`
 
-## Exploration Commands
+## Exploration
 
-```bash
-# Test framework detection
-cat jest.config* vitest.config* pytest.ini setup.cfg pyproject.toml .rspec Cargo.toml 2>/dev/null | grep -i 'test\|jest\|pytest\|mocha\|vitest\|rspec'
+Use your native file tools (Read, Glob, Grep) plus the `scan.js` helper for aggregations.
 
-# Test file count vs source file count
-echo "Test files:" && find . -type f \( -name '*.test.*' -o -name '*.spec.*' -o -name 'test_*' -o -name '*_test.*' \) -not -path '*/node_modules/*' | wc -l
-echo "Source files:" && find . -type f \( -name '*.ts' -o -name '*.js' -o -name '*.py' -o -name '*.go' -o -name '*.rs' -o -name '*.java' -o -name '*.sql' -o -name '*.sps' -o -name '*.spb' -o -name '*.xml' -o -name '*.sh' -o -name '*.c' -o -name '*.h' -o -name '*.cpp' -o -name '*.hpp' -o -name '*.cc' -o -name '*.cxx' -o -name '*.hxx' \) -not -path '*/node_modules/*' -not -path '*/test*' -not -name '*.test.*' -not -name '*.spec.*' | wc -l
+### Test framework detection
+Read if present: `jest.config*`, `vitest.config*`, `pytest.ini`, `setup.cfg`, `pyproject.toml`, `.rspec`, `Cargo.toml`. Grep each for `test|jest|pytest|mocha|vitest|rspec` (case-insensitive).
 
-# Test types present
-find . -path '*/e2e/*' -o -path '*/integration/*' -o -path '*/unit/*' -o -name '*.e2e.*' -o -name '*.integration.*' 2>/dev/null | head -10
+### Test file count
+```
+node "{{project_root}}/_Sprintpilot/scripts/scan.js" files --include "*.test.*,*.spec.*,test_*,*_test.*" --root "{{project_root}}" --count
+```
 
-# CI/CD configuration
-cat .github/workflows/*.yml .gitlab-ci.yml Jenkinsfile azure-pipelines.yml .circleci/config.yml .travis.yml 2>/dev/null | head -80
+### Source file count
+```
+node "{{project_root}}/_Sprintpilot/scripts/scan.js" files --include "*.ts,*.js,*.py,*.go,*.rs,*.java,*.sql,*.sps,*.spb,*.xml,*.sh,*.c,*.h,*.cpp,*.hpp,*.cc,*.cxx,*.hxx" --exclude "**/test/**,**/tests/**,**/__tests__/**,**/spec/**,*.test.*,*.spec.*,*_test.*,test_*" --root "{{project_root}}" --count
+```
+(The `scan.js` helper automatically also excludes `node_modules`, `.git`, `vendor`, `dist`, `build`, etc.)
 
-# Linting & formatting config
-ls -la .eslintrc* .prettierrc* .editorconfig .rubocop.yml .flake8 pyproject.toml rustfmt.toml .golangci.yml biome.json .sqlfluff .sqlfluffrc 2>/dev/null
+### Test types present
+Use Glob for `**/e2e/**`, `**/integration/**`, `**/unit/**`, `*.e2e.*`, `*.integration.*`. First ~10 hits are enough.
 
-# Code metrics (approximate LOC)
-find . -type f \( -name '*.ts' -o -name '*.js' -o -name '*.py' -o -name '*.go' -o -name '*.rs' -o -name '*.java' -o -name '*.sql' -o -name '*.sps' -o -name '*.spb' -o -name '*.xml' -o -name '*.sh' -o -name '*.c' -o -name '*.h' -o -name '*.cpp' -o -name '*.hpp' -o -name '*.cc' -o -name '*.cxx' -o -name '*.hxx' \) -not -path '*/node_modules/*' -not -path '*/.git/*' | xargs wc -l 2>/dev/null | tail -1
+### CI/CD configuration
+Read if present: `.github/workflows/*.yml` (use Glob to list them first), `.gitlab-ci.yml`, `Jenkinsfile`, `azure-pipelines.yml`, `.circleci/config.yml`, `.travis.yml`. 80 lines each is usually enough.
 
-# Largest files (complexity hotspots)
-find . -type f \( -name '*.ts' -o -name '*.js' -o -name '*.py' -o -name '*.sql' -o -name '*.sps' -o -name '*.spb' -o -name '*.sh' -o -name '*.c' -o -name '*.h' -o -name '*.cpp' -o -name '*.hpp' -o -name '*.cc' -o -name '*.cxx' -o -name '*.hxx' \) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | sort -rn | head -10
+### Linting & formatting config
+Use Glob to list: `.eslintrc*`, `.prettierrc*`, `.editorconfig`, `.rubocop.yml`, `.flake8`, `pyproject.toml`, `rustfmt.toml`, `.golangci.yml`, `biome.json`, `.sqlfluff*`.
 
-# Coverage config
-cat .nycrc .istanbul.yml jest.config* vitest.config* 2>/dev/null | grep -i 'cover'
-ls -la coverage/ htmlcov/ .coverage 2>/dev/null
+### Code metrics (total LOC)
+```
+node "{{project_root}}/_Sprintpilot/scripts/scan.js" loc --include "*.ts,*.js,*.py,*.go,*.rs,*.java,*.sql,*.sps,*.spb,*.xml,*.sh,*.c,*.h,*.cpp,*.hpp,*.cc,*.cxx,*.hxx" --root "{{project_root}}"
 ```
+Output is tab-separated `<total-lines>\t<file-count>`.
+
+### Largest files (complexity hotspots)
+```
+node "{{project_root}}/_Sprintpilot/scripts/scan.js" largest --include "*.ts,*.js,*.py,*.sql,*.sps,*.spb,*.sh,*.c,*.h,*.cpp,*.hpp,*.cc,*.cxx,*.hxx" --root "{{project_root}}" --limit 10
+```
+Output: `<lines>\t<path>`, descending.
+
+### Coverage
+Read `.nycrc`, `.istanbul.yml`, `jest.config*`, `vitest.config*` if present and grep for `cover`. Use Glob to check for `coverage/`, `htmlcov/`, `.coverage` directories/files.
 
 ## Downstream Consumers
 
@@ -69,8 +81,8 @@ Write to `{{output_file}}`:
 | Metric | Value | Evidence |
 |--------|-------|----------|
 | Test framework | Jest 29.7 | jest.config.ts:1 |
-| Test files | 45 | find output |
-| Source files | 120 | find output |
+| Test files | 45 | scan.js files --include ... --count |
+| Source files | 120 | scan.js files --include ... --count |
 | Test:Source ratio | 1:2.7 | Calculated |
 | Test types present | unit, integration | directory structure |
 | Test types missing | e2e, snapshot | No e2e/ directory found |

package/_Sprintpilot/skills/sprintpilot-codebase-map/agents/stack-analyzer.md

@@ -20,50 +20,48 @@ Scan the project at `{{project_root}}` and write your findings to `{{output_file
 - `credentials.json`, `service-account.json`
 - `*.secret`, `*password*`, `*token*` (in filenames)
 
-## Exploration Commands
-
-Run these to gather data (adapt paths as needed):
-
-```bash
-# Package manifests
-cat package.json 2>/dev/null | head -100
-cat pyproject.toml 2>/dev/null
-cat Cargo.toml 2>/dev/null
-cat go.mod 2>/dev/null
-cat Gemfile 2>/dev/null
-cat pom.xml 2>/dev/null | head -100
-cat build.gradle 2>/dev/null | head -50
-cat *.csproj 2>/dev/null | head -50
-
-# Database / PL/SQL manifests
-ls -la *.sql *.sps *.spb 2>/dev/null | head -10
-find . -type f \( -name '*.sql' -o -name '*.sps' -o -name '*.spb' \) -not -path '*/.git/*' 2>/dev/null | wc -l
-cat tnsnames.ora sqlnet.ora 2>/dev/null | head -20
-
-# C / C++ manifests
-ls -la *.c *.h *.cpp *.hpp *.cc *.cxx *.hxx 2>/dev/null | head -10
-find . -type f \( -name '*.c' -o -name '*.h' -o -name '*.cpp' -o -name '*.hpp' -o -name '*.cc' -o -name '*.cxx' -o -name '*.hxx' \) -not -path '*/.git/*' 2>/dev/null | wc -l
-cat CMakeLists.txt configure.ac conanfile.txt vcpkg.json 2>/dev/null | head -20
-
-# Lockfiles (versions)
-head -100 package-lock.json 2>/dev/null || head -100 yarn.lock 2>/dev/null || head -100 pnpm-lock.yaml 2>/dev/null
-
-# Runtime versions
-cat .nvmrc .node-version .python-version .ruby-version .tool-versions 2>/dev/null
-cat rust-toolchain.toml 2>/dev/null
-
-# File type distribution
-find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/vendor/*' -not -path '*/target/*' | sed 's/.*\.//' | sort | uniq -c | sort -rn | head -20
-
-# Build tools
-ls -la webpack.config* vite.config* rollup.config* tsconfig* babel.config* .babelrc Makefile CMakeLists.txt build.gradle* pom.xml *.sln *.xml 2>/dev/null
-
-# Infrastructure
-ls -la Dockerfile* docker-compose* .dockerignore 2>/dev/null
-ls -la terraform/ cdk.json serverless.yml k8s/ kubernetes/ helm/ 2>/dev/null
+## Exploration
+
+Gather data using your native file tools (Read, Glob, Grep). The commands below are illustrative — use the equivalent tool from your CLI. Skip files that don't exist; do not fail the task on missing manifests.
+
+### Package manifests
+Read each of these if present (top 100 lines is enough for most):
+`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `Gemfile`, `pom.xml`, `build.gradle`, any `*.csproj`.
+
+### Database / PL/SQL manifests
+Read `tnsnames.ora`, `sqlnet.ora` if present.
+Count SQL / PL-SQL files:
+```
+node "{{project_root}}/_Sprintpilot/scripts/scan.js" files --include "*.sql,*.sps,*.spb" --root "{{project_root}}" --count
+```
+
+### C / C++ manifests
+Read `CMakeLists.txt`, `configure.ac`, `conanfile.txt`, `vcpkg.json` if present.
+Count C/C++ files:
+```
+node "{{project_root}}/_Sprintpilot/scripts/scan.js" files --include "*.c,*.h,*.cpp,*.hpp,*.cc,*.cxx,*.hxx" --root "{{project_root}}" --count
 ```
 
-Also use Glob and Grep to find patterns not covered above.
+### Lockfiles (versions)
+Read the first ~100 lines of whichever is present: `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`.
+
+### Runtime versions
+Read if present: `.nvmrc`, `.node-version`, `.python-version`, `.ruby-version`, `.tool-versions`, `rust-toolchain.toml`.
+
+### File type distribution
+```
+node "{{project_root}}/_Sprintpilot/scripts/scan.js" extensions --root "{{project_root}}" --limit 20
+```
+Output is tab-separated `<count>\t<extension>`, descending.
+
+### Build tools
+Use Glob to list if present: `webpack.config*`, `vite.config*`, `rollup.config*`, `tsconfig*`, `babel.config*`, `.babelrc`, `Makefile`, `CMakeLists.txt`, `build.gradle*`, `pom.xml`, `*.sln`.
+
+### Infrastructure
+Use Glob to list if present: `Dockerfile*`, `docker-compose*`, `.dockerignore`.
+Check for directories: `terraform/`, `k8s/`, `kubernetes/`, `helm/`. Read `cdk.json`, `serverless.yml` if present.
+
+Use Glob and Grep to find patterns not covered above.
 
 ## Downstream Consumers
 
@@ -87,7 +85,7 @@ Write to `{{output_file}}`:
 | TypeScript | 142 | 65% | Application code |
 | ... | ... | ... | ... |
 
-Evidence: `find` command output showing file distribution
+Evidence: `scan.js extensions` output showing file distribution
 
 ## Frameworks & Core Libraries
 | Name | Version | Purpose | Evidence |

package/_Sprintpilot/skills/sprintpilot-codebase-map/workflow.md

@@ -18,7 +18,7 @@ Complementary, not a replacement. `bmad-document-project` generates comprehensiv
 
 ## Step 1 — Prepare
 
-<action>Create output directory: `mkdir -p {output_folder}/codebase-analysis`</action>
+<action>Create output directory `{output_folder}/codebase-analysis` (use your native file-create tool; it will create parent directories as needed). The first `Write` tool call targeting a file inside this directory will auto-create it, so no explicit mkdir is required in practice.</action>
 <action>Determine project root absolute path: `{{project_root}}`</action>
 
 ---

package/lib/commands/install.js

@@ -64,6 +64,9 @@ const { V1_ADDON_DIR_NAME, V1_SKILL_NAMES, detectV1Installation } = require('../
 
 const ADDON_DIR = path.resolve(__dirname, '..', '..', '_Sprintpilot');
 const PROJECT_ADDON_DIR_NAME = '_Sprintpilot';
+const DEFAULT_SESSION_STORY_LIMIT = 3;
+const DEFAULT_RETROSPECTIVE_MODE = 'auto';
+const RETROSPECTIVE_MODES = ['auto', 'stop', 'skip'];
 const RUNTIME_RESOURCES = [
   'Sprintpilot.md',
   'manifest.yaml',
@@ -603,6 +606,211 @@ async function evictV1Installation(projectRoot, { dryRun, migrateV1, yes }) {
   return { migrated: true, moduleConfigSnapshot: snapshot };
 }
 
+// Parse the user's existing autopilot config (if any) so interactive prompts
+// can default to the current values AND so a v1 migration's patcher run
+// preserves user-edited values rather than overwriting them with bundled
+// defaults.
+//
+// Checks both locations, in order of precedence:
+//   1. `_Sprintpilot/modules/autopilot/config.yaml`  — normal upgrade
+//   2. `_bmad-addons/modules/autopilot/config.yaml`  — v1 legacy (bmad-
+//      autopilot-addon), picked up BEFORE evictV1Installation moves it
+//
+// Regex-based so we don't add a YAML parser dep for two scalar fields.
+// Unrecognized / unreadable files fall back to bundled defaults.
+async function readExistingAutopilotConfig(projectRoot, v1Snapshot) {
+  const out = { sessionStoryLimit: null, retrospectiveMode: null };
+  let raw = null;
+
+  // Precedence order:
+  //   1. `_Sprintpilot/modules/autopilot/config.yaml`  — normal upgrade
+  //   2. `_bmad-addons/modules/autopilot/config.yaml`  — v1 legacy still
+  //      on disk (install was invoked before evictV1Installation ran)
+  //   3. v1 in-memory snapshot                         — v1 legacy already
+  //      evicted; evictV1Installation captured the buffer before removing
+  //      the directory, so we extract the autopilot/config.yaml bytes
+  //      from there. Without this the patcher would overwrite the user's
+  //      v1-preserved values with bundled defaults.
+  const candidates = [
+    path.join(projectRoot, PROJECT_ADDON_DIR_NAME, 'modules', 'autopilot', 'config.yaml'),
+    path.join(projectRoot, V1_ADDON_DIR_NAME, 'modules', 'autopilot', 'config.yaml'),
+  ];
+  for (const file of candidates) {
+    if (!(await fs.pathExists(file))) continue;
+    try {
+      raw = await fs.readFile(file, 'utf8');
+      break;
+    } catch {
+      /* try next candidate */
+    }
+  }
+
+  if (raw == null && v1Snapshot && Array.isArray(v1Snapshot.autopilot)) {
+    const entry = v1Snapshot.autopilot.find((f) => f.relPath === 'config.yaml');
+    if (entry && Buffer.isBuffer(entry.buffer)) {
+      try {
+        raw = entry.buffer.toString('utf8');
+      } catch {
+        /* unreadable — fall back to defaults */
+      }
+    }
+  }
+
+  if (raw == null) return out;
+
+  // Both patterns tolerate a trailing `# comment` tail so users can annotate
+  // their config without breaking upgrade detection (e.g.
+  // `retrospective_mode: stop  # we want manual retros`). `[ \t]` rather
+  // than `\s` inside each line so matches never cross a newline.
+  const commentTail = /[ \t]*(?:#.*)?$/.source;
+
+  // `session_story_limit: 3`  — unquoted integer, optional trailing comment
+  const limitMatch = raw.match(
+    new RegExp(`^[ \\t]*session_story_limit:[ \\t]*(\\d+)${commentTail}`, 'm'),
+  );
+  if (limitMatch) {
+    const n = Number.parseInt(limitMatch[1], 10);
+    if (Number.isFinite(n) && n >= 0) out.sessionStoryLimit = n;
+  }
+  // `retrospective_mode: auto` — unquoted or single/double-quoted string,
+  // optional trailing comment
+  const modeMatch = raw.match(
+    new RegExp(`^[ \\t]*retrospective_mode:[ \\t]*["']?([a-zA-Z_-]+)["']?${commentTail}`, 'm'),
+  );
+  if (modeMatch && RETROSPECTIVE_MODES.includes(modeMatch[1])) {
+    out.retrospectiveMode = modeMatch[1];
+  }
+  return out;
+}
+
+// Rewrite the `session_story_limit:` and `retrospective_mode:` scalar lines
+// in the freshly-copied autopilot/config.yaml with the user's chosen values.
+// Done as a line-level string replacement instead of a token-substitution
+// because workflow.md uses the `{{session_story_limit}}` / `{{retrospective_mode}}`
+// variable-reference syntax — threading these keys through `renderString`
+// would match the inner `{key}` inside `{{key}}` and corrupt the workflow
+// variables to literal `{value}` strings.
+//
+// Handles three shapes for each key:
+//   1. line present with a value    → in-place replace (preserves trailing comment)
+//   2. line present with no value   → in-place fill
+//   3. line missing                 → append to the `autopilot:` block
+// (3) is the path that catches v1 (bmad-autopilot-addon) migrations whose
+// legacy config predates `retrospective_mode` — without it, the user's
+// prompted choice would be silently dropped.
+function applyScalar(source, key, value) {
+  // Structure of a YAML scalar line we support:
+  //   [indent][key]:[space(s)][value][space(s) + # comment]?
+  //
+  // Groups, non-greedy on value so the trailing-comment capture wins:
+  //   indent  — leading whitespace (preserved verbatim)
+  //   value   — `\S[^#\n]*?` — starts non-ws, stops as early as possible so
+  //             the comment tail can match. Optional, so this also matches
+  //             "key:\n" (no value at all) — P1-C.
+  //   tail    — `\s*#.*` — the whitespace-before-# is INSIDE the tail capture
+  //             so the original spacing ("value  # note") round-trips
+  //             instead of collapsing to a single space.
+  // Using [ \t] instead of \s everywhere INSIDE the line so the match
+  // cannot cross a newline — `\s*` would greedily consume the trailing
+  // `\n` after "key:" on an empty-value line, breaking the rewrite.
+  const replaceRe = new RegExp(`^([ \\t]*)${key}:[ \\t]*(\\S[^#\\n]*?)?([ \\t]*#.*)?$`, 'm');
+  if (replaceRe.test(source)) {
+    return source.replace(replaceRe, (_m, indent, _oldValue, tail) => {
+      return `${indent}${key}: ${value}${tail || ''}`;
+    });
+  }
+
+  // Key is absent. Append under the `autopilot:` block at the file's end.
+  // The bundled shipping config always starts with `autopilot:` at column
+  // 0 and indents children two spaces — match that style. If the file has
+  // no `autopilot:` header at all (hand-edited to a different shape), bail
+  // rather than guess.
+  if (!/^autopilot:\s*$/m.test(source)) return source;
+  const trimmed = source.endsWith('\n') ? source : `${source}\n`;
+  return `${trimmed}  ${key}: ${value}\n`;
+}
+
+async function patchAutopilotConfig(projectRoot, { sessionStoryLimit, retrospectiveMode }) {
+  const file = path.join(
+    projectRoot,
+    PROJECT_ADDON_DIR_NAME,
+    'modules',
+    'autopilot',
+    'config.yaml',
+  );
+  if (!(await fs.pathExists(file))) return;
+  const original = await fs.readFile(file, 'utf8');
+  let updated = applyScalar(original, 'session_story_limit', sessionStoryLimit);
+  updated = applyScalar(updated, 'retrospective_mode', retrospectiveMode);
+  if (updated !== original) {
+    await writeAtomic(file, updated);
+  }
+}
+
+async function resolveAutopilotSettings({ projectRoot, yes, dryRun, v1Snapshot }) {
+  const existing = await readExistingAutopilotConfig(projectRoot, v1Snapshot);
+  const defaultLimit = existing.sessionStoryLimit ?? DEFAULT_SESSION_STORY_LIMIT;
+  const defaultMode = existing.retrospectiveMode ?? DEFAULT_RETROSPECTIVE_MODE;
+
+  if (yes) {
+    if (existing.sessionStoryLimit != null || existing.retrospectiveMode != null) {
+      console.log(
+        pc.dim(
+          `Preserving autopilot config: session_story_limit=${defaultLimit}, retrospective_mode=${defaultMode}`,
+        ),
+      );
+    }
+    return { sessionStoryLimit: defaultLimit, retrospectiveMode: defaultMode };
+  }
+
+  if (dryRun) {
+    console.log(
+      pc.dim(
+        `[DRY RUN] Would prompt for autopilot config (current: session_story_limit=${defaultLimit}, retrospective_mode=${defaultMode})`,
+      ),
+    );
+    return { sessionStoryLimit: defaultLimit, retrospectiveMode: defaultMode };
+  }
+
+  const limitRaw = await prompts.text({
+    message: 'Autopilot: stories to fully implement per session (0 = unlimited)',
+    initialValue: String(defaultLimit),
+    validate(value) {
+      if (value == null || value === '') return undefined;
+      const n = Number.parseInt(value, 10);
+      if (!Number.isFinite(n) || String(n) !== String(value).trim() || n < 0) {
+        return 'Enter a non-negative integer (0 = unlimited)';
+      }
+      return undefined;
+    },
+  });
+  const sessionStoryLimit =
+    limitRaw == null || String(limitRaw).trim() === ''
+      ? defaultLimit
+      : Number.parseInt(String(limitRaw).trim(), 10);
+
+  const retrospectiveMode = await prompts.select({
+    message: 'Autopilot: retrospective handling at epic completion',
+    options: [
+      {
+        value: 'auto',
+        label: 'Auto — autopilot generates retrospective inline and continues (recommended)',
+      },
+      {
+        value: 'stop',
+        label: 'Stop — pause autopilot so you can run /bmad-retrospective manually',
+      },
+      {
+        value: 'skip',
+        label: 'Skip — do not generate a retrospective (NOT RECOMMENDED)',
+      },
+    ],
+    initialValue: defaultMode,
+  });
+
+  return { sessionStoryLimit, retrospectiveMode };
+}
+
 async function runInteractiveToolPicker(detected) {
   const options = ALL_TOOLS.map((tool) => ({
     value: tool,
@@ -665,12 +873,24 @@ async function runInstall(options = {}) {
 
   // 2. Resolve output_folder
   const outputFolder = await readOutputFolder(projectRoot);
-  const ctx = buildContext({ outputFolder });
   if (outputFolder !== '_bmad-output') {
     console.log(pc.dim(`Using output_folder: ${outputFolder}`));
     console.log('');
   }
 
+  // 2a. Autopilot configuration (prompt or preserve existing values).
+  // These values are patched into modules/autopilot/config.yaml AFTER the
+  // runtime copy — they're NOT threaded through `renderString`, because
+  // workflow.md's `{{session_story_limit}}` / `{{retrospective_mode}}`
+  // variable references would collide with single-brace token matching.
+  const { sessionStoryLimit, retrospectiveMode } = await resolveAutopilotSettings({
+    projectRoot,
+    yes,
+    dryRun,
+    v1Snapshot: v1ConfigSnapshot,
+  });
+  const ctx = buildContext({ outputFolder });
+
   // 3. Detect + select tools
   const detected = await detectInstalledTools(projectRoot);
 
@@ -888,6 +1108,12 @@ async function runInstall(options = {}) {
     // .sprintpilot-v1-snapshot*.json were added up-front in
     // evictV1Installation (step 0) so they're in place even if the
     // module-snapshot branch never runs.
+
+    // 6b. Apply the resolved autopilot settings. Runs AFTER step 6 (which
+    //     wrote the bundled default config) AND after the v1 snapshot
+    //     reapply (which might have restored an older config.yaml without
+    //     `retrospective_mode`). The user's prompted values always win.
+    await patchAutopilotConfig(projectRoot, { sessionStoryLimit, retrospectiveMode });
   }
 
   // 7. Verify git check-ignore
@@ -936,8 +1162,15 @@ async function runInstall(options = {}) {
   console.log('    multi_agent.max_parallel_analysis  5      Codebase analysis agents');
   console.log('');
   console.log('  _Sprintpilot/modules/autopilot/config.yaml');
+  // padEnd so the description column stays aligned across both rows,
+  // independent of the chosen values' widths (e.g. 2-digit limit, 4-char mode).
+  const apKey = (k) => k.padEnd(31, ' ');
+  const apVal = (v) => String(v).padEnd(6, ' ');
+  console.log(
+    `    ${apKey('autopilot.session_story_limit')}${apVal(sessionStoryLimit)} Stories to fully implement per run (0 = unlimited)`,
+  );
   console.log(
-    '    autopilot.session_story_limit    3      Stories to fully implement per run (0 = unlimited)',
+    `    ${apKey('autopilot.retrospective_mode')}${apVal(retrospectiveMode)} Epic-end retrospective: auto (inline) | stop (pause) | skip (not recommended)`,
   );
   console.log('');
   console.log('Multi-agent skills — run parallel subagents for faster analysis:');
@@ -963,4 +1196,15 @@ async function runInstall(options = {}) {
   console.log('Apache 2.0 License — Igor Kunin — https://github.com/ikunin/sprintpilot');
 }
 
-module.exports = { runInstall };
+module.exports = {
+  runInstall,
+  // Exported for unit tests only — do not depend on this surface elsewhere.
+  _internals: {
+    readExistingAutopilotConfig,
+    patchAutopilotConfig,
+    applyScalar,
+    RETROSPECTIVE_MODES,
+    DEFAULT_SESSION_STORY_LIMIT,
+    DEFAULT_RETROSPECTIVE_MODE,
+  },
+};

package/lib/prompts.js

@@ -27,6 +27,26 @@ async function confirm(opts) {
   return result;
 }
 
+async function text(opts) {
+  const clack = await loadClack();
+  const result = await clack.text(opts);
+  if (clack.isCancel(result)) {
+    clack.cancel('Cancelled');
+    process.exit(0);
+  }
+  return result;
+}
+
+async function select(opts) {
+  const clack = await loadClack();
+  const result = await clack.select(opts);
+  if (clack.isCancel(result)) {
+    clack.cancel('Cancelled');
+    process.exit(0);
+  }
+  return result;
+}
+
 async function intro(message) {
   const clack = await loadClack();
   clack.intro(message);
@@ -76,5 +96,7 @@ module.exports = {
   note,
   multiselect,
   confirm,
+  text,
+  select,
   log,
 };

package/lib/substitute.js

@@ -19,7 +19,7 @@ function renderString(text, ctx) {
   return out;
 }
 
-function buildContext({ outputFolder }) {
+function buildContext({ outputFolder } = {}) {
   const out = outputFolder || '_bmad-output';
   return {
     output_folder: out,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikunin/sprintpilot",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Sprintpilot — autopilot and multi-agent addon for BMad Method v6: git workflow, parallel agents, autonomous story execution",
   "license": "Apache-2.0",
   "repository": {
@@ -33,6 +33,9 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "scripts": {
+    "prepare": "node scripts/setup-git-hooks.mjs"
+  },
   "dependencies": {
     "@clack/core": "^1.0.0",
     "@clack/prompts": "^1.0.0",