@idea1/cli 1.7.7 → 1.8.0

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

@@ -0,0 +1,63 @@
+import { logger } from '../../../lib/logger.js';
+import * as git from '../../../services/git.js';
+import * as github from '../../../services/github.js';
+import { WorkflowBranchState } from '../../data/workflow-context.js';
+import { WorkflowStates } from '../../data/workflow-states.js';
+import { cleanUpMergedBranch, mergeAsApprover } from '../approval-flow.js';
+import { confirmApproverIdentity } from '../release-flow.js';
+import { requireContext, requireLiveContext } from '../workflow-engine.js';
+/**
+ * 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. A repository with no
+ * CI/CD configured has no suite to wait for, so its PR merges straight away.
+ *
+ * The branch is merged as it stands, so the checks waited for are the checks of what merges.
+ * Afterwards the branch and any worktree are cleaned up; the platform records the branch as merged
+ * when GitHub reports its deletion. A context whose branch is already merged has all the pull
+ * request work done, so re-entering this state leaves it as it is.
+ */
+export const approvePrHandler = {
+    state: WorkflowStates.ApprovedAndMerged,
+    async prepare(transition) {
+        // The pull request was merged on an earlier pass through this state.
+        if (requireContext(transition).branchState === WorkflowBranchState.Merged) {
+            logger.dim('The branch\'s PR is already merged; nothing to approve.');
+            return;
+        }
+        const context = requireLiveContext(transition);
+        if (transition.workingPath) {
+            await git.ensureBranchUpToDate();
+        }
+        const prInfo = await github.getPrInfo(context.branchName);
+        if (!prInfo) {
+            throw new Error('No PR found for this branch. Nothing to approve.');
+        }
+        logger.info(`PR #${prInfo.number} found`);
+        context.pullRequestUrl = prInfo.url;
+        // 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; nothing to approve.`);
+            context.branchState = WorkflowBranchState.Merged;
+            return;
+        }
+        await confirmApproverIdentity(context.branchName);
+        await mergeAsApprover({ branchName: context.branchName, baseBranch: context.baseBranch, prNumber: prInfo.number });
+        context.branchState = WorkflowBranchState.Merged;
+    },
+    async complete(transition) {
+        const context = requireContext(transition);
+        await cleanUpMergedBranch({
+            branchName: context.branchName,
+            baseBranch: context.baseBranch,
+            workingPath: transition.workingPath
+        });
+        logger.newline();
+        logger.success('Workflow complete!');
+        logger.newline();
+        logger.hint(`PR merged into ${context.baseBranch} - the merge is the recorded approval`);
+        logger.hint(`Project item: ${transition.projectItemUrl}`);
+    }
+};
+//# sourceMappingURL=approve-pr.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approve-pr.js","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/approve-pr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAA6B,MAAM,uBAAuB,CAAC;AAEtG;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,KAAK,EAAE,cAAc,CAAC,iBAAiB;IAEvC,KAAK,CAAC,OAAO,CAAC,UAAU;QACtB,qEAAqE;QACrE,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC,WAAW,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;YAC1E,MAAM,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACnC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC1C,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;QAEpC,oFAAoF;QACpF,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,yCAAyC,CAAC,CAAC;YAC1E,OAAO,CAAC,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC;YACjD,OAAO;QACT,CAAC;QAED,MAAM,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACnH,OAAO,CAAC,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAU;QACvB,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,mBAAmB,CAAC;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,WAAW,EAAE,UAAU,CAAC,WAAW;SACpC,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,UAAU,uCAAuC,CAAC,CAAC;QACzF,MAAM,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/dist/{services/workflow-handlers → workflow/engine/handlers}/dev-implementation.d.ts

@@ -1,8 +1,9 @@
-import type { WorkflowStateHandler } from '../../types/index.js';
+import { type WorkflowStateHandler } from '../workflow-engine.js';
 /**
  * Entering "Dev Implementation": the agent's work is committed and pushed and a
  * PR exists, so a developer can test, clean up and finish the work. Afterwards
- * the worktree is removed when `removeWorktreeAtState` says so.
+ * the worktree is removed when `removeWorktreeAtState` says so. Idempotent: an
+ * existing PR is reused and a clean branch is pushed as it is.
  */
 export declare const devImplementationHandler: WorkflowStateHandler;
 //# sourceMappingURL=dev-implementation.d.ts.map

package/dist/workflow/engine/handlers/dev-implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-implementation.d.ts","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/dev-implementation.ts"],"names":[],"mappings":"AAKA,OAAO,EAA0C,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE1G;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBA2BtC,CAAC"}

package/dist/workflow/engine/handlers/dev-implementation.js

@@ -0,0 +1,36 @@
+import { logger } from '../../../lib/logger.js';
+import * as git from '../../../services/git.js';
+import * as github from '../../../services/github.js';
+import { removeWorktreeForWorkflowState } from '../../../services/worktree.js';
+import { WorkflowStates } from '../../data/workflow-states.js';
+import { requireLiveContext, requireWorkingPath } from '../workflow-engine.js';
+/**
+ * Entering "Dev Implementation": the agent's work is committed and pushed and a
+ * PR exists, so a developer can test, clean up and finish the work. Afterwards
+ * the worktree is removed when `removeWorktreeAtState` says so. Idempotent: an
+ * existing PR is reused and a clean branch is pushed as it is.
+ */
+export const devImplementationHandler = {
+    state: WorkflowStates.DevImplementation,
+    async prepare(transition) {
+        const context = requireLiveContext(transition);
+        requireWorkingPath(transition, 'commit and push the implementation');
+        if (await git.hasUncommittedChanges()) {
+            await git.commitAllChanges(`Agent Implementation of ${transition.projectItemUrl} on ${context.branchName}`);
+        }
+        await git.pushToRemote(context.branchName);
+        const prInfo = await github.createPrIfNeeded(context.branchName, context.baseBranch, transition.projectItemUrl);
+        if (prInfo) {
+            context.pullRequestUrl = prInfo.url;
+            logger.hint(`PR: ${prInfo.url}`);
+        }
+    },
+    async complete(transition) {
+        const { branchName } = requireLiveContext(transition);
+        await removeWorktreeForWorkflowState(WorkflowStates.DevImplementation, branchName, transition.projectItemUrl, { checkoutBranchInMainRepo: false });
+        logger.newline();
+        logger.success('Transitioned to Dev Implementation');
+        logger.hint('When ready for review, run: idea1 ready-for-approval [--assignee <username>] [--reviewers <user1,user2>]');
+    }
+};
+//# sourceMappingURL=dev-implementation.js.map

package/dist/workflow/engine/handlers/dev-implementation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-implementation.js","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/dev-implementation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAA6B,MAAM,uBAAuB,CAAC;AAE1G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAyB;IAC5D,KAAK,EAAE,cAAc,CAAC,iBAAiB;IAEvC,KAAK,CAAC,OAAO,CAAC,UAAU;QACtB,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC/C,kBAAkB,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;QAErE,IAAI,MAAM,GAAG,CAAC,qBAAqB,EAAE,EAAE,CAAC;YACtC,MAAM,GAAG,CAAC,gBAAgB,CAAC,2BAA2B,UAAU,CAAC,cAAc,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9G,CAAC;QACD,MAAM,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;QAChH,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAU;QACvB,MAAM,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,8BAA8B,CAAC,cAAc,CAAC,iBAAiB,EAAE,UAAU,EAAE,UAAU,CAAC,cAAc,EAAE,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,CAAC;QAEnJ,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,0GAA0G,CAAC,CAAC;IAC1H,CAAC;CACF,CAAC"}

package/dist/workflow/engine/handlers/index.d.ts

@@ -0,0 +1,21 @@
+import type { CommandOption } from '../../../types/index.js';
+import type { WorkflowState } from '../../data/workflow-states.js';
+import type { WorkflowStateHandler } from '../workflow-engine.js';
+/**
+ * Side effects attached to entering a workflow state. States without an entry
+ * are status-only: entering them records the state and nothing else.
+ */
+export declare const HANDLERS_BY_STATE: ReadonlyMap<WorkflowState, WorkflowStateHandler>;
+/**
+ * The handler for a state, for commands dedicated to one transition.
+ */
+export declare function getHandler(state: WorkflowState): WorkflowStateHandler;
+/**
+ * Every handler option a command does not already declare, for commands that can
+ * advance an item through several states (e.g. `next`, or `ready-for-approval`
+ * from an early state). The options are declared so they parse on the command
+ * line, but marked inapplicable so the resolver never prompts for them up front —
+ * the engine prompts for the ones the actual transition needs.
+ */
+export declare function deferredHandlerOptions(declaredOptions: CommandOption[]): CommandOption[];
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/engine/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMlE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,aAAa,EAAE,oBAAoB,CAG9E,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,oBAAoB,CAMrE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAWxF"}

package/dist/{services/workflow-handlers → workflow/engine/handlers}/index.js

@@ -19,16 +19,20 @@ export function getHandler(state) {
     return handler;
 }
 /**
- * Every handler option, for commands that can reach any state (e.g. `next`).
- * The options are declared so they parse on the command line, but marked
- * inapplicable so the resolver never prompts for them up front — the engine
- * prompts for the ones the actual transition needs.
+ * Every handler option a command does not already declare, for commands that can
+ * advance an item through several states (e.g. `next`, or `ready-for-approval`
+ * from an early state). The options are declared so they parse on the command
+ * line, but marked inapplicable so the resolver never prompts for them up front —
+ * the engine prompts for the ones the actual transition needs.
  */
-export function deferredHandlerOptions() {
+export function deferredHandlerOptions(declaredOptions) {
+    const declared = new Set(declaredOptions.map(option => option.longName));
     const options = [];
     for (const handler of HANDLERS_BY_STATE.values()) {
         for (const option of handler.options ?? []) {
-            options.push({ ...option, dependsOn: () => false });
+            if (!declared.has(option.longName)) {
+                options.push({ ...option, dependsOn: () => false });
+            }
         }
     }
     return options;

package/dist/workflow/engine/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqD,IAAI,GAAG,CACxF,CAAC,0BAA0B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,gBAAgB,CAAC;KAC9F,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,GAAG,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,eAAgC;IACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,11 @@
+import { type WorkflowStateHandler } from '../workflow-engine.js';
+/**
+ * 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. From here on the branch stays as it is, so the CI/CD run the approval is gated on is
+ * the run on the code exactly as it will merge. 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/workflow/engine/handlers/ready-for-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-for-approval.d.ts","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/ready-for-approval.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEtF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBA6CrC,CAAC"}

package/dist/workflow/engine/handlers/ready-for-approval.js

@@ -0,0 +1,56 @@
+import { logger } from '../../../lib/logger.js';
+import * as git from '../../../services/git.js';
+import { removeWorktreeForWorkflowState } from '../../../services/worktree.js';
+import { WorkflowStates } from '../../data/workflow-states.js';
+import { ensurePrReadyForApproval } from '../approval-flow.js';
+import { requireLiveContext } from '../workflow-engine.js';
+/**
+ * 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. From here on the branch stays as it is, so the CI/CD run the approval is gated on is
+ * the run on the code exactly as it will merge. Afterwards the worktree is removed when
+ * `removeWorktreeAtState` says so (this state is the default).
+ */
+export const readyForApprovalHandler = {
+    state: WorkflowStates.NeedsApprovalForRelease,
+    options: [
+        {
+            longName: 'assignee',
+            shortName: 'a',
+            description: 'Who to assign the PR to - The assignee approves the PR by merging it (the approver of record)',
+            choices: 'github-members',
+            validate: value => value.trim() ? undefined : 'An assignee is required - the assignee is the approver of record'
+        },
+        {
+            longName: 'reviewers',
+            shortName: 'r',
+            description: 'Who to request a review from - optional, the assignee is the approver (select any number)',
+            choices: 'github-members',
+            multiSelect: true
+        }
+    ],
+    async prepare(transition) {
+        const context = requireLiveContext(transition);
+        if (transition.workingPath) {
+            await git.ensureBranchUpToDate();
+        }
+        // The PR was created on the way into Dev Implementation; a missing one is an error.
+        const prInfo = await ensurePrReadyForApproval({
+            branchName: context.branchName,
+            baseBranch: context.baseBranch,
+            assignee: transition.options['assignee'],
+            reviewers: transition.options['reviewers'] ?? '',
+            createWhenMissing: null
+        });
+        context.pullRequestUrl = prInfo.url;
+    },
+    async complete(transition) {
+        const { branchName } = requireLiveContext(transition);
+        await removeWorktreeForWorkflowState(WorkflowStates.NeedsApprovalForRelease, branchName, transition.projectItemUrl, { checkoutBranchInMainRepo: false });
+        logger.newline();
+        logger.success('PR is ready for approval');
+        logger.hint('The assignee approves it by running: idea1 approve-pr (which merges it once the CI/CD suite passes)');
+    }
+};
+//# sourceMappingURL=ready-for-approval.js.map

package/dist/workflow/engine/handlers/ready-for-approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-for-approval.js","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/ready-for-approval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAA6B,MAAM,uBAAuB,CAAC;AAEtF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAyB;IAC3D,KAAK,EAAE,cAAc,CAAC,uBAAuB;IAC7C,OAAO,EAAE;QACP;YACE,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,+FAA+F;YAC5G,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kEAAkE;SACjH;QACD;YACE,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,2FAA2F;YACxG,OAAO,EAAE,gBAAgB;YACzB,WAAW,EAAE,IAAI;SAClB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,UAAU;QACtB,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACnC,CAAC;QAED,oFAAoF;QACpF,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC;YAC5C,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;YACxC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE;YAChD,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAU;QACvB,MAAM,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,8BAA8B,CAAC,cAAc,CAAC,uBAAuB,EAAE,UAAU,EAAE,UAAU,CAAC,cAAc,EAAE,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,CAAC;QAEzJ,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,qGAAqG,CAAC,CAAC;IACrH,CAAC;CACF,CAAC"}

package/dist/{services → workflow/engine}/release-flow.d.ts

@@ -1,23 +1,32 @@
-import type { CommandOption } from '../types/index.js';
+import type { CommandOption } from '../../types/index.js';
 /**
- * The gated-merge sequence shared by `idea1 release` (release branch -> main) and
- * `idea1 integrate` (integration branch -> release branch). Both open a PR whose body is the
- * approval chain of the changes it carries, both assign it to its approver, and both merge it only
- * once the required CI/CD checks have passed - with the one sanctioned admin override
- * (change-management-policy.md clause 3) recorded on the PR before any merge happens.
+ * The gated PR sequence: a PR whose body is the approval chain of the changes it carries, assigned
+ * to its approver, merged only once the required CI/CD checks have passed. `idea1 release`
+ * (release branch -> main) runs the whole sequence here, including the one sanctioned admin
+ * override (change-management-policy.md clause 3) recorded on the PR before any merge happens.
+ * `idea1 ready-for-approval` opens a stage-1 change PR with the same kind of body for a branch
+ * that has no project item (see approval-flow.ts).
  */
-/** Which command is running the sequence; shapes the PR body and the override record. */
+/** Which command opened the PR; shapes the PR body and the override record. */
 export interface GatedPrKind {
     /** The command as recorded on the PR, e.g. `idea1 release`. */
     commandName: string;
-    /** Noun for the PR, e.g. `Release` / `Integration`. */
+    /** Noun for the PR, e.g. `Release` / `Change`. */
     label: string;
+    /**
+     * Whether the PR's assignee reviews the commits it carries. True for a stage-1 change PR opened
+     * by `idea1 ready-for-approval`: a commit pushed straight to the branch IS the change under
+     * review, so it is listed neutrally and never refused - this PR is its approval. False for a
+     * release, where every change was already approved on its own PR (change-management-policy.md
+     * clause 2), so a commit with no pull request is an exception.
+     */
+    assigneeReviewsCommits: boolean;
 }
 export declare const RELEASE_KIND: GatedPrKind;
-export declare const INTEGRATION_KIND: GatedPrKind;
+export declare const CHANGE_KIND: GatedPrKind;
 export type PrMode = 'create' | 'merge';
 /**
- * The `--pr-mode` option both commands share. `create` is the default: the PR is opened and the
+ * The `--pr-mode` option of `idea1 release`. `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.
  */

package/dist/workflow/engine/release-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-flow.d.ts","sourceRoot":"","sources":["../../../src/workflow/engine/release-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,YAAY,EAAE,WAA+F,CAAC;AAC3H,eAAO,MAAM,WAAW,EAAE,WAAwG,CAAC;AAEnI,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,aAU5B,CAAC;AAEF,oGAAoG;AACpG,eAAO,MAAM,uBAAuB,iEAAiE,CAAC;AAEtG;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,qFACsC,CAAC;AAErF;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C9E;AAED,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AA4CD,wFAAwF;AACxF,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC1C;AAyED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CAgJxB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlF;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B/E;AAsBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC7F;AA+BD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,gGAAgG;IAChG,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCxE"}

package/dist/{services → workflow/engine}/release-flow.js

@@ -1,12 +1,12 @@
-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' };
+import { logger } from '../../lib/logger.js';
+import { exec, execOrThrow } from '../../lib/shell.js';
+import { promptConfirm, promptInput } from '../../lib/prompt.js';
+import * as git from '../../services/git.js';
+import * as github from '../../services/github.js';
+export const RELEASE_KIND = { commandName: 'idea1 release', label: 'Release', assigneeReviewsCommits: false };
+export const CHANGE_KIND = { commandName: 'idea1 ready-for-approval', label: 'Change', assigneeReviewsCommits: true };
 /**
- * The `--pr-mode` option both commands share. `create` is the default: the PR is opened and the
+ * The `--pr-mode` option of `idea1 release`. `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.
  */
@@ -197,8 +197,9 @@ export async function buildApprovalChain(sourceBranch, targetBranch, kind) {
         unapprovedCommits.push(commit);
     }
     // A release of nothing but the pre-release version bump is a release of release automation:
-    // there is no unapproved change in it, so there is nothing to refuse.
-    const exception = prNumbers.size === 0 && unapprovedCommits.length > 0
+    // there is no unapproved change in it, so there is nothing to refuse. A change PR is never
+    // refused over direct commits: they are what its assignee reviews.
+    const exception = !kind.assigneeReviewsCommits && prNumbers.size === 0 && unapprovedCommits.length > 0
         ? await resolveUnapprovedCommits(unapprovedCommits, sourceBranch, targetBranch, kind)
         : null;
     const records = new Map((await github.listMergedPrsInto(sourceBranch)).map(record => [record.number, record]));
@@ -213,7 +214,14 @@ export async function buildApprovalChain(sourceBranch, targetBranch, kind) {
         lines.push(`No pull request was merged into \`${sourceBranch}\` for the changes below.`);
     }
     else {
-        lines.push('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 |', '|---|---|---|---|---|');
+        lines.push('Every pull request below was approved by its assignee, who merged it into', `\`${sourceBranch}\` (change-management-policy.md clause 2, stage 1).`);
+        if (kind.assigneeReviewsCommits) {
+            lines.push('This PR is the stage-1 gate for everything it carries: its assignee reviews it, it must pass', 'the required CI/CD checks, and the merge of this PR is its approval.');
+        }
+        else {
+            lines.push('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.');
+        }
+        lines.push('', '| PR | Title | Author | Merged (UTC) | Approved by |', '|---|---|---|---|---|');
     }
     let selfApproved = 0;
     for (const number of sortedNumbers) {
@@ -250,11 +258,20 @@ export async function buildApprovalChain(sourceBranch, targetBranch, kind) {
     }
     if (unapprovedCommits.length > 0) {
         lines.push('');
-        lines.push('## Direct commits (no pull request)');
-        lines.push('');
-        lines.push(`The commits below reached \`${sourceBranch}\` without a pull request, so they were never approved`);
-        lines.push('at stage 1. Each is an exception under change-management-policy.md clause 2, to be explained');
-        lines.push('at the quarterly review.');
+        if (kind.assigneeReviewsCommits) {
+            lines.push('## Commits in this change');
+            lines.push('');
+            lines.push(`The commits below were pushed to \`${sourceBranch}\`. They are the change this PR asks its assignee to`);
+            lines.push('review and approve by merging it, so they are not an exception under change-management-policy.md');
+            lines.push('clause 2 - this PR is their stage-1 approval.');
+        }
+        else {
+            lines.push('## Direct commits (no pull request)');
+            lines.push('');
+            lines.push(`The commits below reached \`${sourceBranch}\` without a pull request, so they were never approved`);
+            lines.push('at stage 1. Each is an exception under change-management-policy.md clause 2, to be explained');
+            lines.push('at the quarterly review.');
+        }
         lines.push('');
         lines.push('| Commit | Author | Subject |');
         lines.push('|---|---|---|');

package/dist/workflow/engine/release-flow.js.map

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

package/dist/workflow/engine/workflow-engine.d.ts

@@ -0,0 +1,162 @@
+import type { CommandOption } from '../../types/index.js';
+import type { ProjectItemSummary } from '../data/project-item.js';
+import type { DevWorkflowType, WorkflowContext } from '../data/workflow-context.js';
+import { type WorkflowState } from '../data/workflow-states.js';
+/**
+ * The workflow engine: it moves a project item between workflow states and owns every operation on
+ * the `WorkflowContext` the item contains in the Idea1 platform, reading the item's summary (its core
+ * fields and its context) by item or by branch.
+ *
+ * A transition is "enter state X": the state's handler runs its `prepare` side effects, the new
+ * state is recorded on the item, then the handler's `complete` side effects run. Advancing to a
+ * later state enters every state on the way in turn, each prepared, recorded and completed before
+ * the next, exactly as advancing one state at a time does; a run that stops part way leaves the
+ * item at the last state it entered, and running it again continues from there. Handlers are
+ * idempotent, so a transition replayed after the item was moved back finds its work done and
+ * leaves it as it is.
+ *
+ * A command resolves the transition it operates on and, when it changes the item, calls the
+ * operation that says so: `advanceAsNeededTo` to move the item on, `reenterState` to run the
+ * automation of the state it is already in. Both put the item under workflow management on the way
+ * in - an item with no live branch gets one, created on origin and recorded on the platform as the
+ * item's - so a command never arranges that for itself and every handler runs on a branch.
+ *
+ * The workflow changes the item's context; the branch itself carries the work. A branch's PR is
+ * therefore gated on a CI/CD run of exactly what merges, and approving merges that run's head.
+ *
+ * One thing lives locally, and only here: the item URL of each branch is remembered in the clone's
+ * git config, so "is this branch under workflow?" and "which item?" are answered instantly for
+ * display. The platform is the truth.
+ */
+/**
+ * One project item moving through the workflow, as the engine and the state handlers see it.
+ */
+export interface WorkflowTransition {
+    projectItemUrl: string;
+    /** The item's workflow context; null for an item outside workflow management, until the transition puts it under. */
+    context: WorkflowContext | null;
+    /** The item's current state; null when it is outside workflow management. */
+    currentState: WorkflowState | null;
+    /** Local checkout of the branch (worktree or main repo), or null when none exists. */
+    workingPath: string | null;
+    /** Resolved command options the handlers read (model, effort, assignee, ...). */
+    options: Record<string, string>;
+}
+/**
+ * Side effects attached to entering a workflow state. `prepare` runs before the new state is
+ * recorded (it must succeed for the transition to happen); `complete` runs after the state has been
+ * persisted. Handlers record what they did on the transition's context in memory.
+ */
+export interface WorkflowStateHandler {
+    state: WorkflowState;
+    /** Options the handler reads from `WorkflowTransition.options`, contributed to the commands that can reach this state. */
+    options?: CommandOption[];
+    prepare?: (transition: WorkflowTransition) => Promise<void>;
+    complete?: (transition: WorkflowTransition) => Promise<void>;
+}
+export interface ResolveTransitionInput {
+    /** Project item URL; required when the current branch is not the item's branch. */
+    projectItemUrl?: string;
+    /** Resolved command options, handed to the state handlers. */
+    options: Record<string, string>;
+}
+/**
+ * Work out which project item and branch a command operates on. Reading only: an item outside
+ * workflow management resolves to a transition with no context, and the transition the command
+ * goes on to make is what gives it one.
+ *
+ * On a managed branch (the platform records the current branch as an item's) the branch is the
+ * target. Otherwise the item URL is required: its summary is read from the platform and, when its
+ * branch is live and checked out somewhere locally, that checkout becomes the working directory.
+ */
+export declare function resolveTransition(input: ResolveTransitionInput): Promise<WorkflowTransition>;
+/**
+ * Like `resolveTransition`, returning null for a current branch outside workflow management when
+ * no item URL was given. For commands that also operate on a branch with no project item
+ * (`ready-for-approval`, `approve-pr`).
+ */
+export declare function resolveTransitionIfManaged(input: ResolveTransitionInput): Promise<WorkflowTransition | null>;
+/**
+ * Move the item to `targetState` one state at a time: each state on the way is entered in order -
+ * its handler prepares, the state is recorded on the item, its handler completes - exactly as
+ * advancing to each state with its own command would. The options of every handler on the way are
+ * asked for before the first state is entered. An item that is not under workflow management yet
+ * is put under it first, so advancing an item that has never been started to the first state is
+ * what starts it; an item already at or past `targetState` keeps its state and only gains its
+ * branch, so advancing again is a no-op and a run that stopped part way continues where it stopped.
+ */
+export declare function advanceAsNeededTo(transition: WorkflowTransition, targetState: WorkflowState): Promise<void>;
+/**
+ * Run the automation of the state the item is already in, without a transition: the state's
+ * handler prepares and completes again, so its working environment is set up and its session
+ * starts afresh. The item's status already is this state and stays as it is.
+ */
+export declare function reenterState(transition: WorkflowTransition, state: WorkflowState): Promise<void>;
+/**
+ * The summary of the project item a branch in this repository implements, with the item's workflow
+ * context. Null for a branch outside workflow management. The item URL is remembered locally for
+ * the branch.
+ */
+export declare function getProjectItemSummaryForBranch(branchName: string): Promise<ProjectItemSummary | null>;
+/**
+ * The summary of a project item, with its workflow context: `workflowContext` is null for an item
+ * outside workflow management. When the item's live branch is in this repository, the item URL is
+ * remembered locally for it.
+ */
+export declare function getProjectItemSummary(projectItemUrl: string): Promise<ProjectItemSummary>;
+export interface UpsertProjectItemWorkflowContextInput {
+    projectItemUrl: string;
+    branchName: string;
+    /** The PR target branch: the integration branch for integration work. */
+    baseBranch: string;
+    devWorkflowType: DevWorkflowType;
+    stackBranch: string | null;
+    integrationBranch: string | null;
+}
+/**
+ * Record a branch of this repository in an item's workflow context as the one implementing the
+ * item, putting the item under workflow management when it is not yet. The status is left alone: a
+ * new context starts at the first state, an existing one keeps its state. Idempotent for the same
+ * branch and item. Returns the item's summary.
+ */
+export declare function upsertProjectItemWorkflowContext(input: UpsertProjectItemWorkflowContextInput): Promise<ProjectItemSummary>;
+/**
+ * The item URL of a branch as this clone last saw it - instant, and null for a branch this clone
+ * has yet to resolve. For display and for deciding whether a platform read is worth making; the
+ * platform is the truth (`getProjectItemSummaryForBranch`).
+ */
+export declare function getRememberedProjectItemUrl(branchName: string): Promise<string | null>;
+/**
+ * The item URL of a branch: remembered locally, else read from the platform. Null for a branch
+ * outside workflow management.
+ */
+export declare function getProjectItemUrlForBranch(branchName: string): Promise<string | null>;
+/**
+ * The live branch of an item in this repository, as this clone remembers it when that branch
+ * still exists, else the platform's answer. Null for an item with no live branch here.
+ */
+export declare function resolveBranchForItem(projectItemUrl: string): Promise<string | null>;
+/**
+ * The current branch and the summary of the project item it implements, for display. A branch this
+ * clone has yet to resolve as an item's is reported with a null item straight from the remembered
+ * URLs, so the interactive header is instant on ordinary branches; the platform is read for a
+ * branch this clone knows as an item's.
+ */
+export declare function getProjectItemSummaryForCurrentBranch(): Promise<{
+    branch: string;
+    item: ProjectItemSummary | null;
+}>;
+/**
+ * The item's context, for handlers that record what they did on it; the item is put under
+ * workflow management before any handler runs.
+ */
+export declare function requireContext(transition: WorkflowTransition): WorkflowContext;
+/**
+ * The item's context with its live branch, for handlers that do branch work.
+ */
+export declare function requireLiveContext(transition: WorkflowTransition): WorkflowContext;
+/**
+ * The local checkout a handler needs, with guidance when there is none.
+ */
+export declare function requireWorkingPath(transition: WorkflowTransition, purpose: string): string;
+//# sourceMappingURL=workflow-engine.d.ts.map

package/dist/workflow/engine/workflow-engine.d.ts.map

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