@idea1/cli 1.8.2 → 1.8.3

package/dist/commands/start-project-item.js

@@ -0,0 +1,325 @@
+import { logger } from '../lib/logger.js';
+import { promptInput, promptSelect } from '../lib/prompt.js';
+import { isolationModeOption, resolveIsolationMode } from '../lib/isolation.js';
+import * as git from '../services/git.js';
+import * as claude from '../services/claude.js';
+import * as worktree from '../services/worktree.js';
+import { configService } from '../services/config.js';
+import { isProjectItemUrl, validateProjectItemUrl } from '../lib/project-item-url.js';
+export const VALID_PERMISSION_MODES = ['acceptEdits', 'bypassPermissions', 'default', 'delegate', 'dontAsk', 'plan'];
+const VALID_ENTRY_POINT_MODES = ['launch', 'inline', 'none'];
+export const VALID_EFFORT_LEVELS = ['low', 'medium', 'high', 'xhigh', 'max'];
+const ENTRY_POINT_MODE_CHOICES = [
+    { label: 'Launch new Claude session', value: 'launch' },
+    { label: 'Output prompt for current Claude session', value: 'inline' },
+    { label: 'Do not invoke Claude', value: 'none' }
+];
+export const WORKFLOW_CHOICES = [
+    { label: 'Independent Feature', value: 'independent' },
+    { label: 'Work for Integration', value: 'integration' }
+];
+const IMPLEMENT_AFTER_CREATE_CHOICES = [
+    { label: 'Start implementing now', value: 'yes' },
+    { label: 'Just set up the branch and automation (stop before Claude)', value: 'no' }
+];
+const STACK_CHOICES = [
+    { label: 'No', value: 'no' },
+    { label: 'Yes - specify a branch', value: 'branch' },
+    { label: 'Yes - specify a project item URL', value: 'url' }
+];
+const INTEGRATION_BRANCH_CHOICES = [
+    { label: 'Create new integration branch', value: 'new' },
+    { label: 'Use existing integration branch', value: 'existing' }
+];
+/**
+ * Prompt the user whether to stack this branch on another and resolve the
+ * chosen stack branch. Prompt-only: performs no branch writes. Returns the
+ * resolved stack branch name, or null when the user opts not to stack.
+ * Shared by start-project-item and attach-project-item.
+ */
+export async function promptForStackBranch() {
+    const stackChoice = await promptSelect('Stack this branch on another?', STACK_CHOICES);
+    if (stackChoice === 'branch') {
+        const stackBranch = await promptInput('Branch to stack on');
+        if (!stackBranch) {
+            throw new Error('Stack branch is required when stacking');
+        }
+        const stackExists = await git.branchExists(stackBranch);
+        if (!stackExists) {
+            throw new Error(`Stack branch '${stackBranch}' does not exist locally or on origin`);
+        }
+        return stackBranch;
+    }
+    if (stackChoice === 'url') {
+        const stackUrl = await promptInput('Project item URL to stack on');
+        if (!stackUrl) {
+            throw new Error('Project item URL is required when stacking by URL');
+        }
+        const stackBranch = await git.resolveBranchFromProjectItemUrl(stackUrl);
+        if (!stackBranch) {
+            throw new Error(`No branch found for project item URL: ${stackUrl}. Make sure the project item has been started.`);
+        }
+        logger.info(`Resolved stack branch: ${stackBranch}`);
+        return stackBranch;
+    }
+    return null;
+}
+/**
+ * Prompt the user for integration-branch selection. Prompt-only: does not
+ * perform any branch writes. Must be invoked before setWorkflowStatus so the
+ * user completes all setup questions up front.
+ */
+export async function promptForIntegrationBranch() {
+    const existingBranches = await worktree.listExistingIntegrationBranches();
+    const branchChoice = existingBranches.length > 0
+        ? await promptSelect('Integration branch', INTEGRATION_BRANCH_CHOICES)
+        : 'new';
+    if (branchChoice === 'existing') {
+        const branchChoices = existingBranches.map(b => ({ label: b, value: b }));
+        const integrationBranchName = await promptSelect('Select integration branch', branchChoices);
+        const integrationName = await worktree.extractIntegrationName(integrationBranchName);
+        return { integrationName, integrationBranchName, isNew: false };
+    }
+    const integrationName = await promptInput('Integration name (e.g., my-cool-feature)');
+    if (!integrationName) {
+        throw new Error('Integration name is required');
+    }
+    const integrationBranchName = await worktree.buildIntegrationBranchName(integrationName);
+    return { integrationName, integrationBranchName, isNew: true };
+}
+export const startProjectItemCommand = {
+    name: 'start-project-item',
+    aliases: ['s', 'start'],
+    description: 'Start implementing a project item on a new branch, in a worktree or the main repo',
+    options: [
+        {
+            // Declared first so it's the very first thing prompted, before every
+            // other choice — later choices depend on whether it was provided.
+            longName: 'url',
+            description: 'Project item URL (leave blank to create a new item)',
+            defaultValue: '',
+            promptWhenDefaultExists: true,
+            // Allow blank (signals "create a new item"); validate format otherwise.
+            validate: (value) => (value ? validateProjectItemUrl(value) : undefined)
+        },
+        {
+            // Only prompted (and required) when no URL was given, i.e. the user is
+            // creating a new item. Declared after 'url' so it can read its value.
+            longName: 'title',
+            shortName: 't',
+            description: 'Title for the new project item',
+            dependsOn: (resolved) => !resolved['url'],
+            validate: (value) => value.trim() ? undefined : 'A title is required to create a project item'
+        },
+        {
+            // Only relevant when creating a new item. Declared after 'title' so it's
+            // asked once the item to create is named.
+            longName: 'implement-after-create',
+            shortName: 'ic',
+            description: 'After creating the new item, start implementing it now or just set up the branch?',
+            choices: IMPLEMENT_AFTER_CREATE_CHOICES,
+            dependsOn: (resolved) => !resolved['url'],
+            validate: (value) => value === 'yes' || value === 'no' ? undefined : 'Choose whether to start implementing'
+        },
+        {
+            longName: 'branch-name',
+            shortName: 'n',
+            description: 'Branch name (auto-generated if not provided)',
+            defaultValue: undefined,
+            promptWhenDefaultExists: true
+        },
+        {
+            longName: 'source-path',
+            shortName: 'p',
+            description: 'Path to source directory',
+            defaultValue: '',
+            promptWhenDefaultExists: false
+        },
+        {
+            longName: 'base-branch',
+            shortName: 'b',
+            description: 'Base branch',
+            defaultValue: () => configService.getDefaultBaseBranch(),
+            promptWhenDefaultExists: false
+        },
+        {
+            longName: 'permission-mode',
+            shortName: 'pm',
+            description: 'Claude permission mode',
+            defaultValue: 'plan',
+            promptWhenDefaultExists: true,
+            choices: VALID_PERMISSION_MODES.map(m => ({ label: m, value: m })),
+            validate: (value) => {
+                if (!VALID_PERMISSION_MODES.includes(value)) {
+                    return `Must be one of: ${VALID_PERMISSION_MODES.join(', ')}`;
+                }
+                return undefined;
+            }
+        },
+        {
+            longName: 'workflow-type',
+            shortName: 'w',
+            description: 'Development workflow type',
+            defaultValue: undefined,
+            choices: WORKFLOW_CHOICES
+        },
+        isolationModeOption,
+        {
+            longName: 'effort',
+            shortName: 'e',
+            description: 'Claude effort level (reasoning depth)',
+            defaultValue: 'high',
+            promptWhenDefaultExists: true,
+            choices: VALID_EFFORT_LEVELS.map(l => ({ label: l, value: l })),
+            validate: (value) => {
+                if (!VALID_EFFORT_LEVELS.includes(value)) {
+                    return `Must be one of: ${VALID_EFFORT_LEVELS.join(', ')}`;
+                }
+                return undefined;
+            }
+        },
+        {
+            longName: 'claude-entry-point',
+            shortName: 'im',
+            description: 'How to invoke Claude after setup',
+            defaultValue: 'launch',
+            promptWhenDefaultExists: false,
+            choices: ENTRY_POINT_MODE_CHOICES,
+            validate: (value) => {
+                if (!VALID_ENTRY_POINT_MODES.includes(value)) {
+                    return `Must be one of: ${VALID_ENTRY_POINT_MODES.join(', ')}`;
+                }
+                return undefined;
+            }
+        }
+    ],
+    async execute(resolved) {
+        let projectItemUrl = resolved['url'];
+        const sourcePath = resolved['source-path'];
+        const baseBranch = resolved['base-branch'];
+        const permissionMode = resolved['permission-mode'];
+        const effort = (resolved['effort'] ?? 'high');
+        const workflowType = (resolved['workflow-type'] ?? 'independent');
+        const isolationMode = resolveIsolationMode(resolved);
+        let claudeEntryPointMode = (resolved['claude-entry-point'] ?? 'launch');
+        let shortBranchName = resolved['branch-name'] || undefined;
+        // Navigate to source path if provided
+        if (sourcePath) {
+            process.chdir(sourcePath);
+        }
+        // The URL is resolved up front (asked before any other choice). A blank
+        // value means the user wants to create a brand new item here; in that case
+        // the dependent 'title' and 'implement-after-create' options were also
+        // prompted and required.
+        if (!projectItemUrl) {
+            projectItemUrl = await claude.createProjectItem(resolved['title'].trim());
+            if (resolved['implement-after-create'] === 'no') {
+                // Stop before invoking Claude: set up the branch and all automation,
+                // but don't launch the implementation session.
+                claudeEntryPointMode = 'none';
+            }
+        }
+        // Validate URL format
+        if (!isProjectItemUrl(projectItemUrl)) {
+            logger.warning('URL does not appear to be an idea1.ai project item URL');
+        }
+        // Prompt for stack option (before MCP calls so all user questions are asked first)
+        const stackBranch = await promptForStackBranch();
+        // Collect integration-branch answers before the slow workflow status update,
+        // so every setup question is asked up front.
+        let integrationSelection = null;
+        if (workflowType === 'integration') {
+            integrationSelection = await promptForIntegrationBranch();
+        }
+        // Set workflow status to "Agent Implementation"
+        await claude.setWorkflowStatus(projectItemUrl, 'Agent Implementation');
+        // Generate branch name if not provided
+        if (!shortBranchName) {
+            shortBranchName = await claude.generateBranchName(projectItemUrl);
+        }
+        logger.info(`Using branch name: ${shortBranchName}`);
+        if (!shortBranchName) {
+            throw new Error('Failed to generate a branch name');
+        }
+        if (stackBranch) {
+            await git.ensureStackBranchReady(stackBranch);
+        }
+        if (workflowType === 'independent') {
+            await startIndependentFeature(projectItemUrl, shortBranchName, baseBranch, permissionMode, effort, claudeEntryPointMode, stackBranch, isolationMode);
+        }
+        else {
+            if (!integrationSelection) {
+                throw new Error('Integration selection was not collected');
+            }
+            await startWorkForIntegration(projectItemUrl, shortBranchName, baseBranch, permissionMode, effort, claudeEntryPointMode, stackBranch, integrationSelection, isolationMode);
+        }
+    }
+};
+/**
+ * Start an Independent Feature workflow
+ */
+async function startIndependentFeature(projectItemUrl, shortBranchName, baseBranch, permissionMode, effort, claudeEntryPointMode, stackBranch, isolationMode) {
+    logger.section('Independent Feature Workflow');
+    // Resolve branch prefix
+    const branchPrefix = await worktree.resolveBranchPrefix();
+    // Determine which branch to base off of
+    const sourceBranch = stackBranch ?? baseBranch;
+    // PR always targets baseBranch for independent features
+    const prTargetBranch = baseBranch;
+    const fullBranchName = `${branchPrefix}/${shortBranchName}`;
+    if (stackBranch) {
+        logger.info(`Stacked workflow: branching from ${stackBranch}, PR will target ${baseBranch}`);
+    }
+    // Prepare branch
+    await worktree.prepareBranchForWorktreeWithFullName(fullBranchName, shortBranchName, sourceBranch, prTargetBranch);
+    // Store workflow state in git config
+    await git.storeWorkflowState('Agent Implementation', fullBranchName);
+    await git.storeDevWorkflowType('independent', fullBranchName);
+    if (stackBranch) {
+        await git.storeStackBranch(stackBranch, fullBranchName);
+    }
+    await worktree.setupBranchEnvironment(isolationMode, fullBranchName, shortBranchName, prTargetBranch, {
+        projectItemUrl,
+        permissionMode,
+        effort,
+        claudeEntryPointMode
+    });
+}
+/**
+ * Start a Work for Integration workflow
+ */
+async function startWorkForIntegration(projectItemUrl, shortBranchName, baseBranch, permissionMode, effort, claudeEntryPointMode, stackBranch, integrationSelection, isolationMode) {
+    logger.section('Work for Integration Workflow');
+    const { integrationName, integrationBranchName, isNew } = integrationSelection;
+    if (isNew) {
+        // Create the integration branch from baseBranch if it doesn't exist.
+        // Runs after setWorkflowStatus so the slow remote write is not blocking user prompts.
+        await worktree.ensureIntegrationBranch(integrationBranchName, baseBranch);
+    }
+    logger.info(`Integration branch: ${integrationBranchName}`);
+    // For integration workflow, the integration branch acts as the base for PRs
+    const prTargetBranch = integrationBranchName;
+    // Determine which branch to base off of
+    const sourceBranch = stackBranch ?? integrationBranchName;
+    // Build the full work branch name using integration template
+    const fullBranchName = await worktree.buildIntegrationWorkBranchName(integrationName, shortBranchName);
+    if (stackBranch) {
+        logger.info(`Stacked workflow: branching from ${stackBranch}, PR will target ${integrationBranchName}`);
+    }
+    // Prepare branch
+    await worktree.prepareBranchForWorktreeWithFullName(fullBranchName, shortBranchName, sourceBranch, prTargetBranch);
+    // Store workflow state in git config
+    await git.storeWorkflowState('Agent Implementation', fullBranchName);
+    await git.storeDevWorkflowType('integration', fullBranchName);
+    await git.storeIntegrationBranch(integrationBranchName, fullBranchName);
+    if (stackBranch) {
+        await git.storeStackBranch(stackBranch, fullBranchName);
+    }
+    await worktree.setupBranchEnvironment(isolationMode, fullBranchName, shortBranchName, prTargetBranch, {
+        projectItemUrl,
+        permissionMode,
+        effort,
+        claudeEntryPointMode
+    });
+}
+//# sourceMappingURL=start-project-item.js.map

package/dist/commands/start-project-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-project-item.js","sourceRoot":"","sources":["../../src/commands/start-project-item.ts"],"names":[],"mappings":"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"}

package/dist/commands/start.d.ts

@@ -9,5 +9,11 @@ export declare const projectItemTargetOptions: CommandOption[];
  * created from the title.
  */
 export declare function resolveOrCreateProjectItem(resolved: Record<string, string>): Promise<string>;
+/**
+ * Put a project item under workflow management, optionally carrying the uncommitted changes of the
+ * base branch checkout onto its branch and then approving and merging it. Shared by every command
+ * that starts an item this way.
+ */
+export declare function startProjectItem(resolved: Record<string, string>): Promise<void>;
 export declare const startCommand: Command;
 //# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQhE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,EAwCnD,CAAC;AAEF;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlG;AAED,eAAO,MAAM,YAAY,EAAE,OA8B1B,CAAC"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAoBhE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,EAwCnD,CAAC;AAEF;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlG;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CtF;AAED,eAAO,MAAM,YAAY,EAAE,OAe1B,CAAC"}

package/dist/commands/start.js

@@ -1,9 +1,11 @@
 import { logger } from '../lib/logger.js';
 import { isProjectItemUrl, validateProjectItemUrl } from '../lib/project-item-url.js';
+import * as git from '../services/git.js';
 import * as platform from '../services/platform.js';
+import * as worktree from '../services/worktree.js';
 import { WorkflowStates } from '../workflow/data/workflow-states.js';
-import { branchCreationOptions } from '../workflow/engine/branch-setup.js';
 import { advanceAsNeededTo, requireLiveContext, resolveTransition } from '../workflow/engine/workflow-engine.js';
+import { approveAndMerge, approveAndMergeOption, approvesAndMerges, branchCreationOptionsWithCarrying, carriesLocalChanges, carryLocalChanges, carryLocalChangesOption, findLocalChanges, shipOptions } from '../workflow/engine/ship-flow.js';
 /**
  * Options every command that can put an item under workflow management shares:
  * which item (or a new one to create) and where the repository is.
@@ -58,30 +60,63 @@ export async function resolveOrCreateProjectItem(resolved) {
     }
     return projectItemUrl;
 }
+/**
+ * Put a project item under workflow management, optionally carrying the uncommitted changes of the
+ * base branch checkout onto its branch and then approving and merging it. Shared by every command
+ * that starts an item this way.
+ */
+export async function startProjectItem(resolved) {
+    const sourcePath = resolved['source-path'];
+    if (sourcePath) {
+        process.chdir(sourcePath);
+    }
+    // Everything that can stop the command is checked before an item or a branch is created.
+    const isNewItem = !resolved['url'];
+    const localChanges = carriesLocalChanges(resolved)
+        ? await findLocalChanges(isNewItem ? resolved['base-branch'] || await worktree.resolveBaseBranch() : null)
+        : null;
+    if (carriesLocalChanges(resolved) && !localChanges) {
+        if (isNewItem && approvesAndMerges(resolved)) {
+            throw new Error('There are no uncommitted changes to carry, so a new item would have nothing to approve and merge.');
+        }
+        logger.info('There are no uncommitted changes to carry.');
+    }
+    const projectItemUrl = await resolveOrCreateProjectItem(resolved);
+    const transition = await resolveTransition({ projectItemUrl, options: resolved });
+    logger.section('Start Workflow');
+    if (localChanges) {
+        await carryLocalChanges(transition, localChanges);
+    }
+    if (approvesAndMerges(resolved)) {
+        await approveAndMerge(transition);
+        return;
+    }
+    // Entering the first state is what starts an item; an item that already has a
+    // state keeps it and, when it has no branch yet, gains one here.
+    await advanceAsNeededTo(transition, WorkflowStates.BuildSpecInProgress);
+    const { branchName, baseBranch } = requireLiveContext(transition);
+    logger.newline();
+    logger.success(`${projectItemUrl} is under workflow management on ${branchName} (state: ${transition.currentState})`);
+    logger.newline();
+    logger.hint(`Advance one step:            idea1 next --url ${projectItemUrl}`);
+    logger.hint(`Jump to agent implementation: idea1 start-agent-implementation --url ${projectItemUrl}`);
+    if (!localChanges && await git.getCurrentBranch() === baseBranch && await git.hasUncommittedChanges()) {
+        logger.hint(`Your uncommitted changes stay on ${baseBranch}. To make them the item's work, run start again with --carry-local-changes while ${branchName} has no commits.`);
+    }
+}
 export const startCommand = {
     name: 'start',
     aliases: ['s'],
-    description: 'Put a project item under workflow management: create its branch and record it as the item\'s (no code changes, no Claude)',
+    description: 'Put a project item under workflow management: create its branch and record it as the item\'s (no code changes, no Claude) - or carry your uncommitted base branch changes onto it, and optionally approve and merge them',
     options: [
+        carryLocalChangesOption,
+        approveAndMergeOption,
         ...projectItemTargetOptions,
-        ...branchCreationOptions
+        ...branchCreationOptionsWithCarrying,
+        ...shipOptions
     ],
     async execute(resolved) {
-        const sourcePath = resolved['source-path'];
-        if (sourcePath) {
-            process.chdir(sourcePath);
-        }
-        const projectItemUrl = await resolveOrCreateProjectItem(resolved);
-        const transition = await resolveTransition({ projectItemUrl, options: resolved });
-        logger.section('Start Workflow');
-        // Entering the first state is what starts an item; an item that already has a
-        // state keeps it and, when it has no branch yet, gains one here.
-        await advanceAsNeededTo(transition, WorkflowStates.BuildSpecInProgress);
-        logger.newline();
-        logger.success(`${projectItemUrl} is under workflow management on ${requireLiveContext(transition).branchName} (state: ${transition.currentState})`);
-        logger.newline();
-        logger.hint(`Advance one step:            idea1 next --url ${projectItemUrl}`);
-        logger.hint(`Jump to agent implementation: idea1 start-agent-implementation --url ${projectItemUrl}`);
+        await startProjectItem(resolved);
     }
 };
 //# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AACjH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,iCAAiC,EACjC,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACZ,MAAM,iCAAiC,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD;QACE,uEAAuE;QACvE,qCAAqC;QACrC,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,qDAAqD;QAClE,YAAY,EAAE,EAAE;QAChB,uBAAuB,EAAE,IAAI;QAC7B,wEAAwE;QACxE,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;KACjF;IACD;QACE,uEAAuE;QACvE,sEAAsE;QACtE,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,gCAAgC;QAC7C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QACzC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAC1B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,8CAA8C;KAC5E;IACD;QACE,yFAAyF;QACzF,6EAA6E;QAC7E,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,+BAA+B;QAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QACzC,OAAO,EAAE,gBAAgB;QACzB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAC1B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gDAAgD;KAC9E;IACD;QACE,QAAQ,EAAE,aAAa;QACvB,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,0BAA0B;QACvC,YAAY,EAAE,EAAE;QAChB,uBAAuB,EAAE,KAAK;KAC/B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,QAAgC;IAC/E,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjI,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,wDAAwD,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgC;IACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,yFAAyF;IACzF,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAChD,CAAC,CAAC,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,MAAM,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1G,CAAC,CAAC,IAAI,CAAC;IACT,IAAI,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACnD,IAAI,SAAS,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAC;QACvH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAElF,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,8EAA8E;IAC9E,iEAAiE;IACjE,MAAM,iBAAiB,CAAC,UAAU,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAExE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,CAAC,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,OAAO,CAAC,GAAG,cAAc,oCAAoC,UAAU,YAAY,UAAU,CAAC,YAAY,GAAG,CAAC,CAAC;IACtH,MAAM,CAAC,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,IAAI,CAAC,iDAAiD,cAAc,EAAE,CAAC,CAAC;IAC/E,MAAM,CAAC,IAAI,CAAC,wEAAwE,cAAc,EAAE,CAAC,CAAC;IACtG,IAAI,CAAC,YAAY,IAAI,MAAM,GAAG,CAAC,gBAAgB,EAAE,KAAK,UAAU,IAAI,MAAM,GAAG,CAAC,qBAAqB,EAAE,EAAE,CAAC;QACtG,MAAM,CAAC,IAAI,CAAC,oCAAoC,UAAU,oFAAoF,UAAU,kBAAkB,CAAC,CAAC;IAC9K,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,CAAC,GAAG,CAAC;IACd,WAAW,EAAE,0NAA0N;IACvO,OAAO,EAAE;QACP,uBAAuB;QACvB,qBAAqB;QACrB,GAAG,wBAAwB;QAC3B,GAAG,iCAAiC;QACpC,GAAG,WAAW;KACf;IAED,KAAK,CAAC,OAAO,CAAC,QAAgC;QAC5C,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF,CAAC"}

package/dist/lib/claude-options.d.ts

@@ -14,11 +14,12 @@ export declare const MODEL_CHOICES: {
 /**
  * The options that configure a Claude implementation session. Shared by every
  * command that can launch one, so they all ask the same questions the same way;
- * the defaults are confirmed interactively.
+ * the defaults are confirmed interactively. Not asked when Claude is not invoked.
  */
 export declare const claudeSessionOptions: CommandOption[];
 /**
- * How Claude is invoked once the working environment is ready.
+ * How Claude is invoked once the working environment is ready. Declared before the session and
+ * prompt options, which are only asked when Claude is invoked.
  */
 export declare const claudeEntryPointOption: CommandOption;
 /**

package/dist/lib/claude-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-options.d.ts","sourceRoot":"","sources":["../../src/lib/claude-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnI,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,EAAmF,CAAC;AAC7I,eAAO,MAAM,uBAAuB,EAAE,oBAAoB,EAAiC,CAAC;AAC5F,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAA8C,CAAC;AAClG,eAAO,MAAM,YAAY,EAAE,WAAW,EAAyC,CAAC;AAChF,eAAO,MAAM,+BAA+B,UAAgB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,EAAE,oBAA6B,CAAC;AACpE,eAAO,MAAM,aAAa,EAAE,WAAoB,CAAC;AACjD,eAAO,MAAM,cAAc,EAAE,iBAA0B,CAAC;AAGxD,eAAO,MAAM,aAAa;;;GAKzB,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,EA4B/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAQpC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,EAAE,aAAa,EAqBxD,CAAC;AAEF;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAC7E,cAAc,EAAE,oBAAoB,CAAC;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,sGAAsG;IACtG,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAUA"}
+{"version":3,"file":"claude-options.d.ts","sourceRoot":"","sources":["../../src/lib/claude-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnI,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,EAAmF,CAAC;AAC7I,eAAO,MAAM,uBAAuB,EAAE,oBAAoB,EAAiC,CAAC;AAC5F,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAA8C,CAAC;AAClG,eAAO,MAAM,YAAY,EAAE,WAAW,EAAyC,CAAC;AAChF,eAAO,MAAM,+BAA+B,UAAgB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,EAAE,oBAA6B,CAAC;AACpE,eAAO,MAAM,aAAa,EAAE,WAAoB,CAAC;AACjD,eAAO,MAAM,cAAc,EAAE,iBAA0B,CAAC;AAGxD,eAAO,MAAM,aAAa;;;GAKzB,CAAC;AAyBF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,EA+B/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAQpC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,EAAE,aAAa,EAqBxD,CAAC;AAEF;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAC7E,cAAc,EAAE,oBAAoB,CAAC;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,sGAAsG;IACtG,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAUA"}

package/dist/lib/claude-options.js

@@ -22,13 +22,20 @@ const ENTRY_POINT_MODE_CHOICES = [
     { label: 'Output prompt for current Claude session', value: 'inline' },
     { label: 'Do not invoke Claude', value: 'none' }
 ];
+/**
+ * Whether the resolved options invoke Claude at all; with 'none' there is no session to configure.
+ * Reads `claude-entry-point`, so it must be declared before the options that depend on it.
+ */
+function invokesClaude(resolved) {
+    return resolved['claude-entry-point'] !== 'none';
+}
 function oneOf(valid) {
     return (value) => (valid.includes(value) ? undefined : `Must be one of: ${valid.join(', ')}`);
 }
 /**
  * The options that configure a Claude implementation session. Shared by every
  * command that can launch one, so they all ask the same questions the same way;
- * the defaults are confirmed interactively.
+ * the defaults are confirmed interactively. Not asked when Claude is not invoked.
  */
 export const claudeSessionOptions = [
     {
@@ -37,6 +44,7 @@ export const claudeSessionOptions = [
         description: 'Claude permission mode',
         defaultValue: DEFAULT_PERMISSION_MODE,
         promptWhenDefaultExists: true,
+        dependsOn: invokesClaude,
         choices: VALID_PERMISSION_MODES.map(m => ({ label: m, value: m })),
         validate: oneOf(VALID_PERMISSION_MODES)
     },
@@ -46,6 +54,7 @@ export const claudeSessionOptions = [
         description: 'Claude model for the implementation session',
         defaultValue: DEFAULT_MODEL,
         promptWhenDefaultExists: true,
+        dependsOn: invokesClaude,
         choices: MODEL_CHOICES,
         validate: oneOf(VALID_MODELS)
     },
@@ -55,12 +64,14 @@ export const claudeSessionOptions = [
         description: 'Claude effort level (reasoning depth)',
         defaultValue: DEFAULT_EFFORT,
         promptWhenDefaultExists: true,
+        dependsOn: invokesClaude,
         choices: VALID_EFFORT_LEVELS.map(l => ({ label: l, value: l })),
         validate: oneOf(VALID_EFFORT_LEVELS)
     }
 ];
 /**
- * How Claude is invoked once the working environment is ready.
+ * How Claude is invoked once the working environment is ready. Declared before the session and
+ * prompt options, which are only asked when Claude is invoked.
  */
 export const claudeEntryPointOption = {
     longName: 'claude-entry-point',
@@ -86,8 +97,8 @@ export const claudeEntryPointPromptOptions = [
         description: 'Use default prompt?',
         defaultValue: 'yes',
         promptWhenDefaultExists: true,
-        // Skipped when the prompt itself was supplied — there is nothing to ask.
-        dependsOn: resolved => !resolved['entry-point-prompt'],
+        // Skipped when the prompt itself was supplied, or Claude is not invoked — there is nothing to ask.
+        dependsOn: resolved => invokesClaude(resolved) && !resolved['entry-point-prompt'],
         choices: USE_DEFAULT_PROMPT_CHOICES,
         validate: oneOf(VALID_USE_DEFAULT_PROMPT_VALUES)
     },

package/dist/lib/claude-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-options.js","sourceRoot":"","sources":["../../src/lib/claude-options.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"claude-options.js","sourceRoot":"","sources":["../../src/lib/claude-options.ts"],"names":[],"mappings":"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"}

package/dist/lib/settings.d.ts

@@ -1,4 +1,4 @@
-import type { Idea1Settings } from '../types/index.js';
+import type { Idea1Settings, VersionedPackage } from '../types/index.js';
 import { type WorkflowState } from '../workflow/data/workflow-states.js';
 /**
  * Settings files read from `.idea1/`, in increasing order of precedence.
@@ -16,7 +16,6 @@ export declare const SETTINGS_FILES: readonly string[];
 export declare const DEFAULT_BRANCH_SETTINGS: {
     readonly branchPrefix: "working/agent";
     readonly baseBranch: "working/release";
-    readonly releaseBranch: "working/release";
     readonly releaseTargetBranch: "main";
     readonly integrationBranchPrefix: "working/integration";
     readonly integrationBranchTemplate: "{prefix}/{name}-main";
@@ -63,7 +62,6 @@ export declare function getTestCommand(repoRoot: string): Promise<string | null>
 export interface ResolvedBranchSettings {
     branchPrefix: string;
     baseBranch: string;
-    releaseBranch: string;
     releaseTargetBranch: string;
     integrationBranchPrefix: string;
     integrationBranchTemplate: string;
@@ -74,6 +72,18 @@ export interface ResolvedBranchSettings {
  * Read the repository's branch settings, defaulting each field on its own. See `ResolvedBranchSettings`.
  */
 export declare function readBranchSettings(repoRoot: string): Promise<ResolvedBranchSettings>;
+/**
+ * The repository's release settings: the packages a release can bump. `versionedPackages` is empty
+ * when the repository's settings name none - such a repository's releases have no version bump step.
+ */
+export interface ResolvedReleaseSettings {
+    versionedPackages: VersionedPackage[];
+}
+/**
+ * Read the repository's release settings (`release` in `.idea1/settings.json`, with
+ * `settings.local.json` overlaid). See `ResolvedReleaseSettings`.
+ */
+export declare function readReleaseSettings(repoRoot: string): Promise<ResolvedReleaseSettings>;
 /**
  * Get the workflow state whose transition removes the worktree
  * (default: 'Needs Approval for Release')

package/dist/lib/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/lib/settings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAA0C,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEjH;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAA6C,CAAC;AAE1F;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;CAS1B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAI1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,aAAsD,CAAC;AAkBtG;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiBlF;AAED;;;GAGG;AACH,wBAAsB,oCAAoC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAenG;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWnF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG7E;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,6BAA6B,EAAE,MAAM,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAY1F;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBvF"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/lib/settings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAA0C,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEjH;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAA6C,CAAC;AAE1F;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;CAQ1B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAI1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,aAAsD,CAAC;AAkBtG;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAkBlF;AAED;;;GAGG;AACH,wBAAsB,oCAAoC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAenG;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWnF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG7E;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,6BAA6B,EAAE,MAAM,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAW1F;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAK5F;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBvF"}