@idea1/cli 1.7.1 → 1.7.3

package/dist/services/release-flow.js

@@ -0,0 +1,338 @@
+import { logger } from '../lib/logger.js';
+import { exec, execOrThrow } from '../lib/shell.js';
+import { promptConfirm, promptInput } from '../lib/prompt.js';
+import * as git from './git.js';
+import * as github from './github.js';
+export const RELEASE_KIND = { commandName: 'idea1 release', label: 'Release' };
+export const INTEGRATION_KIND = { commandName: 'idea1 integrate', label: 'Integration' };
+/**
+ * The `--pr-mode` option both commands share. `create` is the default: the PR is opened and the
+ * approver merges it in GitHub once the required checks are green - that merge is the approval of
+ * record, exactly as in `merge` mode, where the CLI waits for the checks and merges here.
+ */
+export const PR_MODE_OPTION = {
+    longName: 'pr-mode',
+    shortName: 'pr',
+    description: 'What to do once the PR exists',
+    defaultValue: 'create',
+    promptWhenDefaultExists: true,
+    choices: [
+        { label: 'create - Create the PR and open it in the browser; merge it there once the required checks pass', value: 'create' },
+        { label: 'merge - Wait for every required check with gh, then merge here', value: 'merge' }
+    ]
+};
+/** The first line of the comment that records an admin override; the evidence script keys on it. */
+export const OVERRIDE_COMMENT_MARKER = '**Change-management exception: merged with admin override.**';
+/**
+ * The local checkout must be the source branch, clean, fully pushed and level with origin, so the
+ * PR carries exactly what the person running the command is looking at.
+ */
+export async function validateSourceBranch(sourceBranch) {
+    logger.step('Validating current branch...');
+    const currentBranch = await git.getCurrentBranch();
+    if (currentBranch !== sourceBranch) {
+        throw new Error(`You must be on the '${sourceBranch}' branch to run this command.\n` +
+            `Current branch: ${currentBranch}`);
+    }
+    logger.success(`On ${sourceBranch} branch`);
+    logger.newline();
+    logger.step('Checking for uncommitted changes...');
+    const status = await exec('git', ['status', '--porcelain']);
+    if (status.stdout.trim()) {
+        throw new Error('You have uncommitted changes. Please commit or stash them first.\n\n' + status.stdout);
+    }
+    logger.success('No uncommitted changes');
+    logger.newline();
+    logger.step('Fetching latest from remote...');
+    await git.fetchLatest();
+    logger.newline();
+    logger.step('Checking for unpushed commits...');
+    const unpushed = await exec('git', ['log', '@{u}..HEAD', '--oneline']);
+    if (unpushed.exitCode === 0 && unpushed.stdout.trim()) {
+        throw new Error('You have local commits that haven\'t been pushed. Please push first.\n\n' +
+            'Unpushed commits:\n' + unpushed.stdout);
+    }
+    logger.success('No unpushed commits');
+    logger.newline();
+    logger.step('Checking if local branch is up to date with remote...');
+    const localCommit = (await execOrThrow('git', ['rev-parse', 'HEAD'])).trim();
+    const remoteCommit = (await execOrThrow('git', ['rev-parse', '@{u}'])).trim();
+    if (localCommit !== remoteCommit) {
+        throw new Error('Your local branch is behind the remote. Please pull the latest changes.\n\n' +
+            `Local:  ${localCommit}\n` +
+            `Remote: ${remoteCommit}`);
+    }
+    logger.success('Local branch matches remote');
+    logger.newline();
+}
+/**
+ * The commits that landed on the source branch since the target last caught up, first-parent
+ * only: one merge commit per merge-commit PR, one squash commit per squash PR, the rebased commits
+ * of a rebase PR, and anything pushed straight to the branch.
+ */
+async function listFirstParentCommits(sourceBranch, targetBranch) {
+    const result = await exec('git', [
+        'log', '--first-parent',
+        '--pretty=%H%x1f%an%x1f%s',
+        `origin/${targetBranch}..origin/${sourceBranch}`
+    ]);
+    if (result.exitCode !== 0) {
+        throw new Error(`Could not list commits between origin/${targetBranch} and origin/${sourceBranch}: ${result.stderr}`);
+    }
+    return result.stdout
+        .split('\n')
+        .filter(line => line.trim().length > 0)
+        .map(line => {
+        const [sha, author, subject] = line.split('\x1f');
+        return { sha, author, subject };
+    });
+}
+/**
+ * Escape a value going into a markdown table cell. Backslashes go first, or escaping the pipe
+ * would produce an escaped backslash followed by a live pipe that breaks the row.
+ */
+function escapeTableCell(value) {
+    return value.replace(/\\/g, '\\\\').replace(/\|/g, '\\|');
+}
+/**
+ * The PR body, written as the approval record for everything the PR carries.
+ *
+ * SOC2 change management asks who approved a change and when. Each change on the source branch
+ * was already approved by its assignee, who merged its PR into that branch. Listing those merges
+ * here makes this PR self-contained evidence: the whole chain is readable from the one PR an
+ * auditor lands on. Commits are attributed to PRs through GitHub's own association, so squash and
+ * rebase merges are covered, and a commit with no PR is shown rather than silently dropped.
+ */
+export async function buildApprovalChainBody(sourceBranch, targetBranch, kind) {
+    const commits = await listFirstParentCommits(sourceBranch, targetBranch);
+    if (commits.length === 0) {
+        throw new Error(`Nothing to ${kind.label.toLowerCase()}: origin/${targetBranch} already contains everything on origin/${sourceBranch}.`);
+    }
+    logger.step(`Attributing ${commits.length} commit(s) on ${sourceBranch} to their pull requests...`);
+    const prNumbers = new Set();
+    const directCommits = [];
+    for (const commit of commits) {
+        const prs = (await github.getPullRequestsForCommit(commit.sha))
+            .filter(pr => pr.merged && pr.baseBranch === sourceBranch);
+        if (prs.length === 0) {
+            directCommits.push(commit);
+            continue;
+        }
+        for (const pr of prs) {
+            prNumbers.add(pr.number);
+        }
+    }
+    if (prNumbers.size === 0) {
+        throw new Error(`Refusing to open the ${kind.label.toLowerCase()} PR: none of the ${commits.length} commit(s) on origin/${sourceBranch} ` +
+            `beyond origin/${targetBranch} came through a merged pull request into ${sourceBranch}. Every change must be ` +
+            'approved on its own PR first (change-management-policy.md clause 2).');
+    }
+    const records = new Map((await github.listMergedPrsInto(sourceBranch)).map(record => [record.number, record]));
+    const sortedNumbers = [...prNumbers].sort((a, b) => a - b);
+    const lines = [
+        `${kind.label} from \`${sourceBranch}\` into \`${targetBranch}\`, created by \`${kind.commandName}\`.`,
+        '',
+        '## Approval chain',
+        '',
+        'Every pull request below was approved by its assignee, who merged it into',
+        `\`${sourceBranch}\` (change-management-policy.md clause 2, stage 1). This PR is the next gate:`,
+        'no further review is required, it must pass the required CI/CD checks, and the merge of this',
+        'PR is its approval - performed by its assignee.',
+        '',
+        '| PR | Title | Author | Merged (UTC) | Approved by |',
+        '|---|---|---|---|---|'
+    ];
+    let selfApproved = 0;
+    for (const number of sortedNumbers) {
+        const record = records.get(number);
+        if (!record) {
+            lines.push(`| #${number} | _could not be read from GitHub - verify manually_ | - | - | - |`);
+            continue;
+        }
+        if (record.mergedBy === record.author) {
+            selfApproved += 1;
+        }
+        lines.push(`| #${record.number} | ${escapeTableCell(record.title)} | @${record.author} | ${record.mergedAt} | @${record.mergedBy} |`);
+    }
+    if (selfApproved > 0) {
+        lines.push('');
+        lines.push(`> **${selfApproved} of ${sortedNumbers.length} contained PR(s) were approved by their own author.** ` +
+            'That is the narrow case change-management-policy.md clause 4 discloses at this headcount ' +
+            'rather than papers over. It is counted here so the disclosure stays honest, and reviewed at ' +
+            'the quarterly review.');
+    }
+    if (directCommits.length > 0) {
+        lines.push('');
+        lines.push('## Direct commits (no pull request)');
+        lines.push('');
+        lines.push(`The commits below reached \`${sourceBranch}\` without a pull request. The only expected entry`);
+        lines.push('is the version bump made by the `pre-release` hook when a release is cut; anything else is an');
+        lines.push('exception under change-management-policy.md clause 2, to be explained at the quarterly review.');
+        lines.push('');
+        lines.push('| Commit | Author | Subject |');
+        lines.push('|---|---|---|');
+        for (const commit of directCommits) {
+            lines.push(`| ${commit.sha.slice(0, 9)} | ${escapeTableCell(commit.author)} | ${escapeTableCell(commit.subject)} |`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Open the PR with its approval-chain body and its approver as assignee. Returns the PR URL.
+ */
+export async function createGatedPr(options) {
+    await github.ensureGitHubCli();
+    const body = await buildApprovalChainBody(options.sourceBranch, options.targetBranch, options.kind);
+    logger.step(`Creating pull request (assigned to @${options.assignee})...`);
+    const prUrl = await github.createPr({
+        sourceBranch: options.sourceBranch,
+        targetBranch: options.targetBranch,
+        title: options.title,
+        body,
+        assignee: options.assignee
+    });
+    logger.success(`PR created: ${prUrl}`);
+    return prUrl;
+}
+/**
+ * The PR's assignee is its approver of record, and GitHub records whoever merges as `merged_by`.
+ * The two must be the same person for the record to name the right approver: no assignee means
+ * no approver, and a different merger is an exception the evidence report calls out - so it
+ * takes an explicit, eyes-open confirmation.
+ */
+export async function confirmApproverIdentity(branchName) {
+    const assignees = await github.getPrAssignees(branchName);
+    if (assignees.length === 0) {
+        throw new Error('This PR has no assignee, so it has no approver of record. Assign one first - the assignee is who ' +
+            'approves the change by merging it (change-management-policy.md clause 2). For a work-item PR run ' +
+            'idea1 ready-for-approval --assignee <login>; otherwise set the assignee on the PR in GitHub.');
+    }
+    const login = await github.getCurrentLogin();
+    const names = assignees.map(assignee => `@${assignee}`).join(', ');
+    if (assignees.includes(login)) {
+        logger.info(`Assigned to ${names} - you are the approver of record`);
+        return;
+    }
+    logger.newline();
+    logger.warning(`This PR is assigned to ${names}, but you are @${login}.`);
+    logger.warning('The merge record will name YOU as the approver, not the assignee, and the evidence');
+    logger.warning('report lists that merge as an exception (change-management-policy.md clause 2).');
+    logger.newline();
+    const proceed = await promptConfirm(`Merge anyway as @${login}, knowing ${names} is the named approver and is not the one approving?`, { default: false });
+    if (!proceed) {
+        throw new Error(`Merge cancelled: reassign the PR to @${login}, or have ${names} run the merge.`);
+    }
+}
+function buildOverrideComment(kind, reason, checkSummary) {
+    return [
+        OVERRIDE_COMMENT_MARKER,
+        '',
+        'The required CI/CD checks did not pass before this PR was merged, and the merge used admin',
+        'privileges to bypass branch protection.',
+        '',
+        `Reason given: ${reason}`,
+        '',
+        'Check status at the time of the override:',
+        '',
+        '```',
+        checkSummary || '(no check summary available)',
+        '```',
+        '',
+        `Recorded automatically by \`${kind.commandName}\` for the quarterly review`,
+        '(change-management-policy.md clause 3).'
+    ].join('\n');
+}
+/**
+ * Merge the PR once the required checks pass. Checks that fail, never start or never finish stop
+ * the merge. The one sanctioned admin override remains: it needs an explicit confirmation, a
+ * stated reason, and the exception must be recorded as a comment on the PR *before* the merge -
+ * if the comment cannot be posted, nothing is merged.
+ */
+export async function mergeWithCheckGate(branchName, kind) {
+    const checks = await github.waitForPrChecks(branchName);
+    if (checks.passed) {
+        const result = await github.mergePr(branchName);
+        if (!result.success) {
+            throw new Error(`Failed to merge PR: ${result.error}`);
+        }
+        return;
+    }
+    logger.newline();
+    logger.warning('The required checks on this PR did not pass.');
+    logger.dim(checks.summary);
+    logger.newline();
+    const override = await promptConfirm('Override the failing/incomplete checks and merge with admin privileges? (recorded as an exception)', { default: false });
+    if (!override) {
+        throw new Error('Merge cancelled: required checks did not pass.');
+    }
+    const reason = (await promptInput('Reason for the override (required - recorded on the PR):', {
+        validate: input => input.trim() ? true : 'A reason is required for an admin override'
+    })).trim();
+    logger.step('Recording the exception on the PR...');
+    await github.addPrComment(branchName, buildOverrideComment(kind, reason, checks.summary));
+    const result = await github.mergePrWithAdminOverride(branchName);
+    if (!result.success) {
+        throw new Error(`Failed to merge PR with admin override: ${result.error}`);
+    }
+    logger.success('Exception recorded on the PR');
+}
+/**
+ * Open URL in browser (cross-platform)
+ */
+async function openUrlInBrowser(url) {
+    for (const command of ['open', 'xdg-open', 'start']) {
+        const result = await exec(command, [url]);
+        if (result.exitCode === 0) {
+            return;
+        }
+    }
+    logger.warning('Could not automatically open browser. Please open the following URL manually:');
+    logger.info(url);
+}
+async function openGitHubActions() {
+    logger.step('Opening GitHub Actions...');
+    const result = await exec('gh', ['repo', 'view', '--json', 'url', '-q', '.url']);
+    if (result.exitCode !== 0) {
+        logger.warning('Could not get repository URL');
+        return;
+    }
+    const actionsUrl = `${result.stdout.trim()}/actions`;
+    logger.info(`Opening: ${actionsUrl}`);
+    await openUrlInBrowser(actionsUrl);
+}
+/**
+ * Finish the sequence in the chosen mode. Either way the merge is the approval of record: in
+ * `create` mode the approver performs it in GitHub once the checks are green; in `merge` mode the
+ * CLI waits for the checks and performs it here, as the approver.
+ */
+export async function runPrMode(options) {
+    const { mode, sourceBranch, targetBranch, prUrl, kind } = options;
+    const noun = `${kind.label.toLowerCase()} PR`;
+    if (mode === 'create') {
+        logger.step('Opening PR in browser...');
+        await exec('gh', ['pr', 'view', sourceBranch, '--web']);
+        logger.newline();
+        logger.success('================================================');
+        logger.success(`${kind.label} PR created and opened in browser`);
+        logger.success('================================================');
+        logger.hint(`Merge it in GitHub once the required checks pass - that merge is the ${kind.label.toLowerCase()} approval of record.`);
+        return;
+    }
+    await confirmApproverIdentity(sourceBranch);
+    const confirmMerge = await promptConfirm(`Merge ${noun} (${sourceBranch} -> ${targetBranch}) once the required checks pass?`, { default: true });
+    if (!confirmMerge) {
+        logger.info(`Merge cancelled. The ${noun} is created and can be merged from GitHub instead.`);
+        logger.hint(`PR: ${prUrl}`);
+        return;
+    }
+    await mergeWithCheckGate(sourceBranch, kind);
+    logger.newline();
+    if (options.openActionsAfterMerge) {
+        await openGitHubActions();
+        logger.newline();
+    }
+    logger.success('========================================');
+    logger.success(`${kind.label} merge to ${targetBranch} complete!`);
+    logger.success('========================================');
+}
+//# sourceMappingURL=release-flow.js.map

package/dist/services/release-flow.js.map

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

package/dist/services/setup.js

@@ -52,7 +52,7 @@ Hooks are shell scripts that run at specific points in the workflow. All hooks a
 | Hook | When it runs |
 |------|--------------|
 | \`setup-worktree\` | After creating a new git worktree |
-| \`pre-release\` | During \`idea1 release\`, before PR creation |
+| \`pre-release\` | During \`idea1 release\`, before the release PR is opened - for release-time automation such as version bumps. The PR, its check gate and its merge belong to the CLI |
 
 **Simple hook:**
 \`\`\`json
@@ -68,7 +68,7 @@ Hooks are shell scripts that run at specific points in the workflow. All hooks a
 {
   "hooks": {
     "pre-release": {
-      "command": "scripts/release.sh",
+      "command": "scripts/version-bump.sh",
       "inputs": [
         {
           "name": "version-type",

package/dist/services/workflow-handlers/agent-implementation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-implementation.d.ts","sourceRoot":"","sources":["../../../src/services/workflow-handlers/agent-implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,oBA4BxC,CAAC"}
+{"version":3,"file":"agent-implementation.d.ts","sourceRoot":"","sources":["../../../src/services/workflow-handlers/agent-implementation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,oBA6BxC,CAAC"}

package/dist/services/workflow-handlers/agent-implementation.js

@@ -1,6 +1,6 @@
 import { WorkflowStates } from '../../lib/workflow-states.js';
 import { isolationModeOption, resolveIsolationMode } from '../../lib/isolation.js';
-import { claudeEntryPointOption, claudeSessionOptions, resolveClaudeSessionOptions } from '../../lib/claude-options.js';
+import { claudeEntryPointOption, claudeEntryPointPromptOptions, claudeSessionOptions, resolveClaudeSessionOptions } from '../../lib/claude-options.js';
 import * as git from '../git.js';
 import * as worktree from '../worktree.js';
 import { requireBranch, requireWorkingPath } from '../workflow-engine.js';
@@ -12,7 +12,7 @@ import { requireBranch, requireWorkingPath } from '../workflow-engine.js';
  */
 export const agentImplementationHandler = {
     state: WorkflowStates.AgentImplementation,
-    options: [isolationModeOption, ...claudeSessionOptions(true), claudeEntryPointOption],
+    options: [isolationModeOption, ...claudeSessionOptions(true), claudeEntryPointOption, ...claudeEntryPointPromptOptions],
     async prepare(context) {
         const branchName = requireBranch(context);
         const isolationMode = resolveIsolationMode(context.options);
@@ -24,13 +24,14 @@ export const agentImplementationHandler = {
     },
     async complete(context) {
         const workingPath = requireWorkingPath(context, 'run the implementation session');
-        const { permissionMode, model, effort, claudeEntryPointMode } = resolveClaudeSessionOptions(context.options);
+        const { permissionMode, model, effort, claudeEntryPointMode, entryPointPrompt } = resolveClaudeSessionOptions(context.options);
         await worktree.launchClaudeForBranch(workingPath, {
             projectItemUrl: context.projectItemUrl,
             permissionMode,
             model,
             effort,
-            claudeEntryPointMode
+            claudeEntryPointMode,
+            entryPointPrompt
         });
     }
 };

package/dist/services/workflow-handlers/agent-implementation.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-implementation.js","sourceRoot":"","sources":["../../../src/services/workflow-handlers/agent-implementation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AACxH,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAyB;IAC9D,KAAK,EAAE,cAAc,CAAC,mBAAmB;IACzC,OAAO,EAAE,CAAC,mBAAmB,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAErF,KAAK,CAAC,OAAO,CAAC,OAAO;QACnB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE5D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,QAAQ,CAAC,uBAAuB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC1F,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QAElC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAO;QACpB,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;QAClF,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,2BAA2B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7G,MAAM,QAAQ,CAAC,qBAAqB,CAAC,WAAW,EAAE;YAChD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc;YACd,KAAK;YACL,MAAM;YACN,oBAAoB;SACrB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}
+{"version":3,"file":"agent-implementation.js","sourceRoot":"","sources":["../../../src/services/workflow-handlers/agent-implementation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AACvJ,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAyB;IAC9D,KAAK,EAAE,cAAc,CAAC,mBAAmB;IACzC,OAAO,EAAE,CAAC,mBAAmB,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,sBAAsB,EAAE,GAAG,6BAA6B,CAAC;IAEvH,KAAK,CAAC,OAAO,CAAC,OAAO;QACnB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE5D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,QAAQ,CAAC,uBAAuB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC1F,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QAElC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAO;QACpB,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;QAClF,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,GAAG,2BAA2B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/H,MAAM,QAAQ,CAAC,qBAAqB,CAAC,WAAW,EAAE;YAChD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc;YACd,KAAK;YACL,MAAM;YACN,oBAAoB;YACpB,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/services/workflow-handlers/approve-pr.d.ts

@@ -1,8 +1,11 @@
 import type { WorkflowStateHandler } from '../../types/index.js';
 /**
- * Entering "Approved and Merged": approve the PR when the user is a requested
- * reviewer, drop the branch's metadata file so it does not leak into the target
- * branch, and merge. Afterwards the branch and any worktree are cleaned up.
+ * Entering "Approved and Merged": merge the PR. The merge IS the approval - it is performed by
+ * the PR's assignee, and GitHub records it as `merged_by` with a timestamp and merge commit
+ * (change-management-policy.md clause 2, stage 1). The merge waits for the required CI/CD checks
+ * and there is no override at this stage: a red or unfinished suite stops it. Before merging, the
+ * branch's metadata file is dropped so it does not leak into the target branch; afterwards the
+ * branch and any worktree are cleaned up.
  */
 export declare const approvePrHandler: WorkflowStateHandler;
 //# sourceMappingURL=approve-pr.d.ts.map

package/dist/services/workflow-handlers/approve-pr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approve-pr.d.ts","sourceRoot":"","sources":["../../../src/services/workflow-handlers/approve-pr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AASjE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBA+F9B,CAAC"}
+{"version":3,"file":"approve-pr.d.ts","sourceRoot":"","sources":["../../../src/services/workflow-handlers/approve-pr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAUjE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAsF9B,CAAC"}

package/dist/services/workflow-handlers/approve-pr.js

@@ -3,27 +3,21 @@ import { promptConfirm } from '../../lib/prompt.js';
 import { WorkflowStates } from '../../lib/workflow-states.js';
 import * as git from '../git.js';
 import * as github from '../github.js';
+import { confirmApproverIdentity } from '../release-flow.js';
 import { removeCurrentWorktree, resolveBaseBranch } from '../worktree.js';
 import { requireBranch } from '../workflow-engine.js';
 /**
- * Entering "Approved and Merged": approve the PR when the user is a requested
- * reviewer, drop the branch's metadata file so it does not leak into the target
- * branch, and merge. Afterwards the branch and any worktree are cleaned up.
+ * Entering "Approved and Merged": merge the PR. The merge IS the approval - it is performed by
+ * the PR's assignee, and GitHub records it as `merged_by` with a timestamp and merge commit
+ * (change-management-policy.md clause 2, stage 1). The merge waits for the required CI/CD checks
+ * and there is no override at this stage: a red or unfinished suite stops it. Before merging, the
+ * branch's metadata file is dropped so it does not leak into the target branch; afterwards the
+ * branch and any worktree are cleaned up.
  */
 export const approvePrHandler = {
     state: WorkflowStates.ApprovedAndMerged,
-    options: [
-        {
-            longName: 'comment',
-            shortName: 'c',
-            description: 'Custom approval comment',
-            defaultValue: '',
-            promptWhenDefaultExists: false
-        }
-    ],
     async prepare(context) {
         const branchName = requireBranch(context);
-        const comment = context.options['comment'] || 'Approved via idea1 CLI workflow';
         if (context.workingPath) {
             await git.ensureBranchUpToDate();
         }
@@ -34,23 +28,24 @@ export const approvePrHandler = {
         logger.info(`PR #${prInfo.number} found`);
         // Re-entering this state after the item was moved back: the merge already happened.
         if (prInfo.state.toUpperCase() === 'MERGED') {
-            logger.dim(`PR #${prInfo.number} is already merged; skipping approval and merge.`);
+            logger.dim(`PR #${prInfo.number} is already merged; nothing to approve.`);
             context.branchRetired = true;
             return;
         }
-        await approveIfRequestedReviewer(branchName, comment);
-        // Remove the branch metadata file before merging so it does not leak into the target branch
+        await confirmApproverIdentity(branchName);
+        // Remove the branch metadata file before merging so it does not leak into the target branch.
+        // This push re-runs the CI/CD suite on the PR, and the merge below waits for that run.
         if (context.workingPath) {
             await git.removeBranchMetadataAndPush(branchName);
         }
         else {
             await git.removeBranchMetadataDetached(branchName);
         }
-        const confirmMerge = await promptConfirm(`Merge PR #${prInfo.number} (${branchName} -> ${context.baseBranch})?`, { default: true });
+        const confirmMerge = await promptConfirm(`Approve PR #${prInfo.number} by merging it (${branchName} -> ${context.baseBranch})?`, { default: true });
         if (!confirmMerge) {
             throw new Error('Merge cancelled by user');
         }
-        await mergeWithProtectionFallback(branchName);
+        await mergeAfterChecksPass(branchName);
         context.branchRetired = true;
     },
     async complete(context) {
@@ -91,56 +86,21 @@ export const approvePrHandler = {
         }
     }
 };
-async function approveIfRequestedReviewer(branchName, comment) {
-    const approvalStatus = await github.getUserApprovalStatus(branchName);
-    if (!approvalStatus) {
-        logger.dim('Could not determine approval status, skipping approval');
-        return;
-    }
-    if (approvalStatus.hasAlreadyApproved) {
-        logger.dim('You have already approved this PR');
-        return;
-    }
-    if (!approvalStatus.isRequestedReviewer) {
-        logger.dim('You are not a requested reviewer on this PR');
-        return;
-    }
-    const approved = await github.approvePr(branchName, comment);
-    if (!approved) {
-        logger.warning('Failed to approve PR, continuing with merge...');
-    }
-}
 /**
- * Merge the PR; when branch protections block it, offer an admin override.
- * `gh pr merge` emits a variety of messages depending on the rule that blocked
- * the merge, and suggests `--admin` when admin privileges can resolve it.
+ * Merge only once the required checks pass. Stage 1 has no admin override
+ * (change-management-policy.md clause 3): the only way past a failing suite is to fix it.
  */
-async function mergeWithProtectionFallback(branchName) {
-    const mergeResult = await github.mergePr(branchName);
-    if (mergeResult.success) {
-        return;
+async function mergeAfterChecksPass(branchName) {
+    const checks = await github.waitForPrChecks(branchName);
+    if (!checks.passed) {
+        throw new Error('Required checks did not pass, so the PR was not merged. There is no override at this stage ' +
+            '(change-management-policy.md clause 3) - fix the build and run idea1 approve-pr again.\n\n' +
+            checks.summary);
     }
-    const errorText = mergeResult.error?.toLowerCase() ?? '';
-    const isBranchProtectionError = errorText.includes('branch protection') ||
-        errorText.includes('required status check') ||
-        errorText.includes('required review') ||
-        errorText.includes('pull request review is required') ||
-        errorText.includes('base branch policy') ||
-        errorText.includes('policy prohibits the merge') ||
-        errorText.includes('--admin');
-    if (!isBranchProtectionError) {
+    const mergeResult = await github.mergePr(branchName);
+    if (!mergeResult.success) {
         throw new Error(`Failed to merge PR: ${mergeResult.error}`);
     }
-    logger.warning('Merge failed due to branch protections');
-    logger.dim(mergeResult.error ?? '');
-    const override = await promptConfirm('Would you like to override branch protections with admin privileges?', { default: false });
-    if (!override) {
-        throw new Error('Merge cancelled by user');
-    }
-    const adminMergeResult = await github.mergePrWithAdminOverride(branchName);
-    if (!adminMergeResult.success) {
-        throw new Error(`Failed to merge PR with admin override: ${adminMergeResult.error}`);
-    }
 }
 async function deleteBranchQuietly(branchName) {
     try {
@@ -155,7 +115,7 @@ function printCompletion(baseBranch, projectItemUrl) {
     logger.newline();
     logger.success('Workflow complete!');
     logger.newline();
-    logger.hint(`PR merged into ${baseBranch}`);
+    logger.hint(`PR merged into ${baseBranch} - the merge is the recorded approval`);
     logger.hint(`Project item: ${projectItemUrl}`);
 }
 //# sourceMappingURL=approve-pr.js.map

package/dist/services/workflow-handlers/approve-pr.js.map

@@ -1 +1 @@
-{"version":3,"file":"approve-pr.js","sourceRoot":"","sources":["../../../src/services/workflow-handlers/approve-pr.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approve-pr.js","sourceRoot":"","sources":["../../../src/services/workflow-handlers/approve-pr.ts"],"names":[],"mappings":"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"}

package/dist/services/workflow-handlers/ready-for-approval.d.ts

@@ -1,8 +1,10 @@
 import type { WorkflowStateHandler } from '../../types/index.js';
 /**
- * Entering "Needs Approval for Release": the PR is complete and gets its
- * reviewers and assignee. Afterwards the worktree is removed when
- * `removeWorktreeAtState` says so (this state is the default).
+ * Entering "Needs Approval for Release": the PR is complete and gets its assignee - the person
+ * who will approve it by merging it with `idea1 approve-pr`. The assignee is required: without
+ * one the PR has no approver of record (change-management-policy.md clause 2). Reviewers are
+ * optional and record nothing. Afterwards the worktree is removed when `removeWorktreeAtState`
+ * says so (this state is the default).
  */
 export declare const readyForApprovalHandler: WorkflowStateHandler;
 //# sourceMappingURL=ready-for-approval.d.ts.map

package/dist/services/workflow-handlers/ready-for-approval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ready-for-approval.d.ts","sourceRoot":"","sources":["../../../src/services/workflow-handlers/ready-for-approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBAsDrC,CAAC"}
+{"version":3,"file":"ready-for-approval.d.ts","sourceRoot":"","sources":["../../../src/services/workflow-handlers/ready-for-approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBAkDrC,CAAC"}