worclaude 2.10.1 → 2.10.3

package/CHANGELOG.md

@@ -4,6 +4,42 @@ All notable changes to worclaude are documented in this file. Format loosely fol
 
 ## [Unreleased]
 
+## [2.10.3] — 2026-04-30
+
+Fixes a user-reported breakage where every arrow-selectable prompt across `worclaude init` / `upgrade` / `restore` / `delete` accepted typed text instead of arrow-key navigation. Root cause: PR #169 (v2.10.0) bumped `inquirer` 12 → 13 with no code changes, but inquirer 13 renamed its legacy `list` prompt type to `select` and ships a runner that silently falls back to `type: 'input'` (free-text) for unknown types — so every `type: 'list'` site degraded silently. The "Everything look right?" prompt looped because typed `y`/`yes` did not strictly equal the choice value `'yes'`. Renames all 20 sites, migrates 4 index-based defaults to value-based (inquirer 13's `select` matches by value, not index), aligns the CLAUDE.md tech-stack metadata that had drifted behind `package.json` for three deps (Inquirer / Ora / Commander), and closes the test-suite blind spot — the prior `vi.mock('inquirer')` setup never inspected `spec.type`.
+
+### Fixed
+
+- **Arrow-selectable prompts work again across init / upgrade / restore / delete** (PR #177) — renamed all 20 `type: 'list'` sites to `type: 'select'` across `src/commands/{init,upgrade,restore,delete}.js` and `src/prompts/{claude-md-merge,conflict-resolution,project-type,tech-stack}.js`. Migrated 4 index-based `default:` values to value-based: `init.js:93,111`, `restore.js:51`, `delete.js:113,156`. Without this, "Generate plugin.json?", "Scaffold memory files?", "Install GitHub Action?", "Everything look right?", "Which step do you want to adjust?", restore and delete confirmations, and the standalone hook-conflict / project-type / claude-md-merge prompts all rendered as silent free-text inputs.
+
+### Tests
+
+- **Structural regression coverage for prompt types** (PR #177) — new `tests/utils/prompt-types.js` exposes `VALID_INQUIRER_TYPES` (the 10 v13 built-in prompt names) plus `expectAllValidPromptTypes(inquirer, label)` which inspects every captured `inquirer.prompt.mock.calls` spec and fails when any `type` is not a v13 built-in. New `tests/prompts/prompt-types.test.js` exercises the four standalone prompt modules + agent-selection. Single-line assertions added to `tests/commands/{init,upgrade,restore,delete}.test.js` so the ~30 sites in command files are also covered. Three stale `expect(spec.type).toBe('list')` assertions in `init.test.js` updated to `'select'`. Test counts: 992 → 999.
+
+### Docs
+
+- **CLAUDE.md tech-stack metadata aligned with package.json** (PR #177) — Inquirer ^12.5.0 → ^13.4.2, Ora ^8.2.0 → ^9.4.0, Commander ^13.1.0 → ^14.0.3 (all three were drifted; CLAUDE.md's own "watch for breaking changes between majors" warning had not been acted on at the time of PR #169's bump). Two new Gotchas added: (1) the silent `type` → `input` fallback in inquirer 13's legacy runner (`node_modules/inquirer/dist/ui/prompt.js`), and (2) inquirer 13 `select` defaults take the choice value, not its index — `default: 1` (second choice) becomes `default: <that-choice's-value>`.
+
+Release group: 1 PR (patch). v2.10.2 → v2.10.3. No missing declarations.
+
+## [2.10.2] — 2026-04-30
+
+Bundles a dogfood catch-up of this repo's own `.claude/` (skipping from v2.8.0 to v2.10.1 in one upgrade run) with a real scaffold bug fix surfaced during that upgrade — `.claude/workflow-ref/` (transient upgrade-time conflict references) was missing from the scaffolder's `updateGitignore` entries, so every user running `worclaude upgrade` had those files pollute their git status. Also closes the BACKLOG "claude --worktree command visibility" item via a docs-only fix: investigation confirmed Claude Code does not create a "minimal `.claude/`" (the worktree's `.claude/` is a normal git checkout from `origin/HEAD`); the perceived missing-commands symptom was caused by main lagging develop, and the existing `subagent-usage` skill already documented the mechanism. The gap was direct `claude --worktree` users with no agent-mediated freshness preamble — filled with a one-paragraph copy-paste reset block.
+
+### Fixed
+
+- **`.claude/workflow-ref/` now scaffolded into `.gitignore`** (PR #174) — `src/core/scaffolder.js` `updateGitignore` entries list now includes `.claude/workflow-ref/`. Existing users pick up the fix on the next scaffold or upgrade pass that runs `updateGitignore`. Two existing tests updated (`is idempotent` seed input + `writes exactly N entries` count 10 → 11 + expected array).
+
+### Docs
+
+- **Manual freshness reset for direct `claude --worktree`** (PR #175) — added a copy-paste workaround block (`cd .claude/worktrees/<name> && git fetch origin && git reset --hard origin/<your-branch>`) to the existing "Base-branch gotcha" section of the `subagent-usage` skill, in both `templates/skills/universal/subagent-usage.md` and the dogfood mirror. Closes BACKLOG "claude --worktree command visibility" (the entry's "minimal `.claude/`" framing was wrong; investigation captured in the session summary).
+
+### Internal
+
+- **Dogfood catch-up v2.8.0 → v2.10.1** (PR #174) — applied 3 release groups' worth of template evolution to this repo's own `.claude/`: sandbox.network block in settings.json (self-testing the v2.10.1 feature), observability hooks for UserPromptSubmit / InstructionsLoaded / SubagentStart / SubagentStop, 3 obs-\*.cjs hook scripts, 3 helper scripts under `.claude/scripts/`, and template-current versions of 5 slash commands plus the git-conventions skill that had drifted behind their templates.
+
+Release group: 2 PRs (1 patch, 1 none). v2.10.1 → v2.10.2.
+
 ## [2.10.1] — 2026-04-29
 
 Adds opt-in scaffolding for Claude Code 2.1.113's `sandbox.network` deny/allow lists. Worclaude is a scaffolder, so the new `templates/settings/base.json` ships empty `deniedDomains` and `allowedDomains` stubs rather than an opinionated default list — project owners decide their own network policy. The merge paths for both fresh init (Scenario A) and existing-project init/upgrade (Scenarios B/C) union-merge the new arrays preserving any user-added domains, and a new `worclaude doctor` check warns when the block is missing or malformed (with `worclaude upgrade` as the remediation hint). Also bundles a Dependabot major bump to `commander` 14, which is now Node-20+-only and was unblocked by the v2.10.0 Node 18 drop.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worclaude",
-  "version": "2.10.1",
+  "version": "2.10.3",
   "description": "The Workflow Layer for Claude Code — scaffold agents, commands, skills, hooks, and memory into any project",
   "type": "module",
   "bin": {

package/src/commands/delete.js

@@ -32,7 +32,7 @@ export async function deleteCommand() {
   // Step 1: Mode selection
   const { mode } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'mode',
       message: 'What would you like to do?',
       choices: [
@@ -82,7 +82,7 @@ export async function deleteCommand() {
     display.newline();
     const { modifiedAction } = await inquirer.prompt([
       {
-        type: 'list',
+        type: 'select',
         name: 'modifiedAction',
         message: `${classification.modified.length} file(s) have been customized. What should we do?`,
         choices: [
@@ -110,7 +110,7 @@ export async function deleteCommand() {
 
     const { rootAction } = await inquirer.prompt([
       {
-        type: 'list',
+        type: 'select',
         name: 'rootAction',
         message: 'What would you like to do with these files?',
         choices: [
@@ -118,7 +118,7 @@ export async function deleteCommand() {
           { name: 'Let me choose which to remove', value: 'choose' },
           { name: 'Remove all', value: 'remove' },
         ],
-        default: 0,
+        default: 'keep',
       },
     ]);
 
@@ -153,14 +153,14 @@ export async function deleteCommand() {
 
   const { confirm } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'confirm',
       message: 'Confirm deletion?',
       choices: [
         { name: 'Yes, delete', value: true },
         { name: 'No, cancel', value: false },
       ],
-      default: 1,
+      default: false,
     },
   ]);
 

package/src/commands/init.js

@@ -83,14 +83,14 @@ async function runAgents(selections) {
 async function runOptionalExtras(selections) {
   const previouslySelected = new Set(selections.optionalFeatures || []);
   const questions = OPTIONAL_FEATURES.map((feature) => ({
-    type: 'list',
+    type: 'select',
     name: feature.id,
     message: feature.label,
     choices: [
       { name: 'Yes', value: true },
       { name: 'No', value: false },
     ],
-    default: previouslySelected.has(feature.id) ? 0 : 1,
+    default: previouslySelected.has(feature.id),
   }));
   const answers = await inquirer.prompt(questions);
   const optionalFeatures = OPTIONAL_FEATURES.filter((f) => answers[f.id]).map((f) => f.id);
@@ -100,7 +100,7 @@ async function runOptionalExtras(selections) {
   // at it. Phase 7 T7.3.
   const { installGithubAction } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'installGithubAction',
       message:
         'Install Claude Code\'s GitHub Action for the @claude "compounding engineering" workflow?',
@@ -108,7 +108,7 @@ async function runOptionalExtras(selections) {
         { name: 'Yes — show me the install instructions now', value: true },
         { name: "No — I'll do it later", value: false },
       ],
-      default: 1,
+      default: false,
     },
   ]);
 
@@ -179,7 +179,7 @@ async function showConfirmation(selections) {
 
   const { confirmation } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'confirmation',
       message: 'Everything look right?',
       choices: [
@@ -241,7 +241,7 @@ async function runInteractivePrompts(projectRoot) {
     } else if (confirmation === 'adjust') {
       const { step } = await inquirer.prompt([
         {
-          type: 'list',
+          type: 'select',
           name: 'step',
           message: 'Which step do you want to adjust?',
           choices: CONFIRMATION_STEPS,
@@ -772,7 +772,7 @@ export async function initCommand() {
 
     const { proceed } = await inquirer.prompt([
       {
-        type: 'list',
+        type: 'select',
         name: 'proceed',
         message: 'Proceed with workflow installation?',
         choices: [

package/src/commands/restore.js

@@ -27,7 +27,7 @@ export async function restoreCommand() {
 
   const { selected } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'selected',
       message: 'Select backup to restore:',
       choices,
@@ -48,14 +48,14 @@ export async function restoreCommand() {
 
   const { confirm } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'confirm',
       message: 'Confirm restore?',
       choices: [
         { name: 'Yes', value: true },
         { name: 'No', value: false },
       ],
-      default: 1,
+      default: false,
     },
   ]);
 

package/src/commands/upgrade.js

@@ -233,7 +233,7 @@ async function applyRepairPass(projectRoot, plan, variables) {
 async function promptProceed(message) {
   const { proceed } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'proceed',
       message,
       choices: [
@@ -357,7 +357,7 @@ async function promptAndScaffoldOptionalFeatures(projectRoot, meta, { yes, dryRu
   for (const feature of available) {
     const { accept } = await inquirer.prompt([
       {
-        type: 'list',
+        type: 'select',
         name: 'accept',
         message: feature.label,
         choices: [
@@ -397,7 +397,7 @@ export async function upgradeCommand(options = {}) {
     );
     const { doUpdate } = await inquirer.prompt([
       {
-        type: 'list',
+        type: 'select',
         name: 'doUpdate',
         message: 'Update worclaude CLI?',
         choices: [
@@ -533,7 +533,7 @@ export async function upgradeCommand(options = {}) {
       agentReport = await patchAgentDescriptions(projectRoot, meta, async (agentName) => {
         const { patch } = await inquirer.prompt([
           {
-            type: 'list',
+            type: 'select',
             name: 'patch',
             message: `Agent "${agentName}" has been customized. Add missing description field?`,
             choices: [

package/src/core/scaffolder.js

@@ -78,6 +78,7 @@ export async function updateGitignore(projectDir) {
     '.claude/cache/',
     '.claude/scratch/',
     '.claude/observability/',
+    '.claude/workflow-ref/',
   ];
   const header = '# Worclaude (generated workflow files)';
 

package/src/prompts/claude-md-merge.js

@@ -107,7 +107,7 @@ export async function promptClaudeMdMerge(existingContent, missingSections) {
 
   const { choice } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'choice',
       message: 'How would you like to handle CLAUDE.md?',
       choices: [
@@ -139,7 +139,7 @@ export async function interactiveSectionMerge(existingContent, renderedTemplate,
 
     const { addSection } = await inquirer.prompt([
       {
-        type: 'list',
+        type: 'select',
         name: 'addSection',
         message: `Add "${sectionName}" to your CLAUDE.md?`,
         choices: [

package/src/prompts/conflict-resolution.js

@@ -16,7 +16,7 @@ export async function promptHookConflict(hookCategory, existingHook, workflowHoo
 
   const { resolution } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'resolution',
       message: 'How would you like to resolve this?',
       choices: [

package/src/prompts/project-type.js

@@ -37,7 +37,7 @@ export async function promptProjectType() {
       display.dim('You may not need both.');
       const { continueAnyway } = await inquirer.prompt([
         {
-          type: 'list',
+          type: 'select',
           name: 'continueAnyway',
           message: 'Continue anyway?',
           choices: [

package/src/prompts/tech-stack.js

@@ -20,7 +20,7 @@ export async function promptTechStack(_projectTypes) {
 
   const { useDocker } = await inquirer.prompt([
     {
-      type: 'list',
+      type: 'select',
       name: 'useDocker',
       message: 'Do you use Docker currently?',
       choices: [

package/templates/skills/universal/subagent-usage.md

@@ -88,6 +88,14 @@ Run `worclaude doctor` to diagnose. Fix locally with `git remote set-head origin
 their worktree to match the parent's current branch automatically; other worktree
 agents do not.
 
+If you invoke `claude --worktree` directly (not via an agent), no preamble runs
+— sync the worktree manually before doing real work:
+
+```bash
+cd .claude/worktrees/<name>
+git fetch origin && git reset --hard origin/<your-working-branch>
+```
+
 Benefits:
 - Agent's changes don't conflict with your uncommitted work
 - You can review agent changes before merging