@idea1/cli 1.7.6 → 1.8.0

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-import type { WorkflowState } from '../lib/workflow-states.generated.js';
+import type { WorkflowState } from '../workflow/data/workflow-states.js';
 /**
  * Unified command option definition following the ops pattern.
  * Every option can be supplied as a CLI argument or an interactive prompt.
@@ -95,6 +95,13 @@ export interface HookConfig {
  * A hook can be either a simple string (command) or a full config object
  */
 export type Hook = string | HookConfig;
+/**
+ * A prompt template: the Handlebars template itself, or the file that holds it
+ */
+export type PromptTemplateSetting = string | {
+    /** Path of the template file, relative to the repo root */
+    templateFile: string;
+};
 /**
  * Idea1 settings from .idea1/settings.json, overlaid with .idea1/settings.local.json
  */
@@ -103,6 +110,10 @@ export interface Idea1Settings {
         'setup-worktree'?: Hook;
         'pre-release'?: Hook;
     };
+    prompts?: {
+        /** The prompt an Agent Implementation session starts with. */
+        agentImplementation?: PromptTemplateSetting;
+    };
     defaults?: {
         branchPrefix?: string;
         baseBranch?: string;
@@ -139,10 +150,6 @@ export type ClaudeModel = 'fable' | 'opus' | 'sonnet' | 'haiku';
  * - 'none': Do not invoke Claude
  */
 export type ClaudeEntryPointMode = 'launch' | 'inline' | 'none';
-/**
- * Development workflow types for branching strategies
- */
-export type DevWorkflowType = 'independent' | 'integration';
 /**
  * Where work on a branch happens.
  * - 'worktree': a dedicated git worktree in a sibling directory (isolated)
@@ -164,58 +171,7 @@ export interface PrInfo {
     number: number;
     url: string;
     state: string;
-}
-/**
- * Workflow state representing the current status of a project item.
- * Generated from shared-config/workflow-states.json.
- */
-export type { WorkflowState } from '../lib/workflow-states.generated.js';
-/**
- * Everything a workflow transition operates on: the project item, its branch and
- * where (if anywhere) that branch is checked out locally. Built by the workflow
- * engine and handed to every state handler.
- */
-export interface WorkflowContext {
-    projectItemUrl: string;
-    /** The item's branch; null until `ensureManaged` has created one. */
-    branchName: string | null;
-    /** PR target branch (the integration branch for integration work). */
-    baseBranch: string;
-    devWorkflowType: DevWorkflowType;
-    stackBranch: string | null;
-    integrationBranch: string | null;
-    /** The item's current state; null when it has never been started. */
-    currentState: WorkflowState | null;
-    /** Local checkout of the branch (worktree or main repo), or null when none exists. */
-    workingPath: string | null;
-    /** Set by a handler once the branch has been merged and no longer carries metadata. */
-    branchRetired: boolean;
-    /** 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.
- */
-export interface WorkflowStateHandler {
-    state: WorkflowState;
-    /** Options the handler reads from `WorkflowContext.options`, contributed to the commands that can reach this state. */
-    options?: CommandOption[];
-    prepare?: (context: WorkflowContext) => Promise<void>;
-    complete?: (context: WorkflowContext) => Promise<void>;
-}
-/**
- * Per-branch metadata stored in `.idea1/<sanitized-branch>.json`.
- * Committed on the branch so it's discoverable from any clone via `git show`.
- */
-export interface BranchMetadata {
-    branchName: string;
-    projectItemUrl?: string;
-    baseBranch?: string;
-    workflowState?: string;
-    devWorkflowType?: string;
-    stackBranch?: string;
-    integrationBranch?: string;
+    /** The PR's target branch. Present from `getPrInfo`; absent from `checkPrExists`. */
+    baseRefName?: string;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.7.6";
+export declare const VERSION = "1.8.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.js - do not edit manually
-export const VERSION = '1.7.6';
+export const VERSION = '1.8.0';
 //# sourceMappingURL=version.js.map

package/dist/workflow/data/project-item.d.ts

@@ -0,0 +1,21 @@
+import type { WorkflowContext } from './workflow-context.js';
+/**
+ * The summary of a project item, as the platform returns it from every tool that reads an item's
+ * summary, looks one up by its branch, or changes its workflow context: the item's core fields and
+ * the workflow context it contains. `workflowContext` is null for an item outside workflow
+ * management. The item's large content, such as its description, is not part of the summary.
+ *
+ * Mirrors the platform's `ProjectItemSummaryResponse`.
+ */
+export interface ProjectItemSummary {
+    url: string;
+    externalId: number;
+    title: string;
+    /** The Epic the item is in; null when it is in none. */
+    epicId: string | null;
+    completionDate: string | null;
+    /** A status the item had outside the workflow states, kept for reference; empty when it had none. */
+    legacyWorkflowStatus: string;
+    workflowContext: WorkflowContext | null;
+}
+//# sourceMappingURL=project-item.d.ts.map

package/dist/workflow/data/project-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-item.d.ts","sourceRoot":"","sources":["../../../src/workflow/data/project-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qGAAqG;IACrG,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;CACzC"}

package/dist/workflow/data/project-item.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-item.js.map

package/dist/workflow/data/project-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-item.js","sourceRoot":"","sources":["../../../src/workflow/data/project-item.ts"],"names":[],"mappings":""}

package/dist/workflow/data/workflow-context.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Whether a branch is worked on its own or as part of an integration branch.
+ */
+export type DevWorkflowType = 'independent' | 'integration';
+/**
+ * Whether a workflow context's branch is live, and the ways it can be disconnected from one.
+ * Serialized as the platform's numeric enum values.
+ */
+export declare enum WorkflowBranchState {
+    /** The branch exists in the repository and is recorded as the item's. */
+    Live = 0,
+    /** The branch's pull request merged and the branch was retired; the work has landed. */
+    Merged = 1,
+    /** The branch was deleted without its pull request merging, or was never recorded. */
+    Deleted = 2
+}
+/**
+ * A project item's place in the workflow: its workflow status and the git branch that carries its
+ * work, as the platform stores it on the item. An item with no context is outside workflow
+ * management and has no workflow status. Every context has a branch: putting an item under
+ * workflow management creates or records the branch, and the branch's pull request targets
+ * `baseBranch`. A context whose branch is no longer live keeps the branch fields as the record of
+ * where the work was, and `branchState` says why the branch is not live.
+ *
+ * Mirrors the platform's `WorkflowContext`.
+ */
+export interface WorkflowContext {
+    /** The item's workflow state as stored; always a canonical state name. */
+    workflowStatus: string;
+    /** Where an external coding agent is implementing the item; empty when none is. */
+    codingAgentUrl: string;
+    /** The pull request carrying the branch's work; empty until one exists. */
+    pullRequestUrl: string;
+    /** The repository the branch lives in, as `owner/name`. */
+    repositoryFullName: string;
+    branchName: string;
+    /** The branch the pull request targets: the integration branch for integration work. */
+    baseBranch: string;
+    devWorkflowType: DevWorkflowType;
+    /** The branch this one is stacked on; null for a branch cut from its base. */
+    stackBranch: string | null;
+    /** The integration branch this one belongs to, for integration work. */
+    integrationBranch: string | null;
+    branchState: WorkflowBranchState;
+}
+//# sourceMappingURL=workflow-context.d.ts.map

package/dist/workflow/data/workflow-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-context.d.ts","sourceRoot":"","sources":["../../../src/workflow/data/workflow-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,CAAC;AAE5D;;;GAGG;AACH,oBAAY,mBAAmB;IAC7B,yEAAyE;IACzE,IAAI,IAAI;IACR,wFAAwF;IACxF,MAAM,IAAI;IACV,sFAAsF;IACtF,OAAO,IAAI;CACZ;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/workflow/data/workflow-context.js

@@ -0,0 +1,14 @@
+/**
+ * Whether a workflow context's branch is live, and the ways it can be disconnected from one.
+ * Serialized as the platform's numeric enum values.
+ */
+export var WorkflowBranchState;
+(function (WorkflowBranchState) {
+    /** The branch exists in the repository and is recorded as the item's. */
+    WorkflowBranchState[WorkflowBranchState["Live"] = 0] = "Live";
+    /** The branch's pull request merged and the branch was retired; the work has landed. */
+    WorkflowBranchState[WorkflowBranchState["Merged"] = 1] = "Merged";
+    /** The branch was deleted without its pull request merging, or was never recorded. */
+    WorkflowBranchState[WorkflowBranchState["Deleted"] = 2] = "Deleted";
+})(WorkflowBranchState || (WorkflowBranchState = {}));
+//# sourceMappingURL=workflow-context.js.map

package/dist/workflow/data/workflow-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-context.js","sourceRoot":"","sources":["../../../src/workflow/data/workflow-context.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAN,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,yEAAyE;IACzE,6DAAQ,CAAA;IACR,wFAAwF;IACxF,iEAAU,CAAA;IACV,sFAAsF;IACtF,mEAAW,CAAA;AACb,CAAC,EAPW,mBAAmB,KAAnB,mBAAmB,QAO9B"}

package/dist/{lib → workflow/data}/workflow-states.d.ts

@@ -7,7 +7,7 @@ export type { WorkflowState } from './workflow-states.generated.js';
 export declare const WORKFLOW_STATE_ORDER: readonly WorkflowState[];
 /**
  * Normalize a stored workflow state value to a current WorkflowState.
- * Accepts current names (case-insensitively, since older metadata files carry
+ * Accepts current names (case-insensitively, since stored statuses carry
  * variants like "Dev implementation"), maps legacy state names to their current
  * equivalents, and returns null for unrecognized values.
  */

package/dist/workflow/data/workflow-states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-states.d.ts","sourceRoot":"","sources":["../../../src/workflow/data/workflow-states.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAChH,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EAAoB,CAAC;AAE9E;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,GAAG,IAAI,CAiB3F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI,CAStF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,EAAE,EAAE,aAAa,GAAG,aAAa,EAAE,CASvG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,GAAG,OAAO,CAE1F"}

package/dist/{lib → workflow/data}/workflow-states.generated.d.ts

@@ -14,7 +14,7 @@ export declare const WorkflowStates: {
     readonly Released: "Released";
 };
 /**
- * Retired state names still found on older project items and branch metadata, mapped to their
+ * Retired state names still found in older workflow data, mapped to their
  * current equivalents. Keys are lowercase; compare case-insensitively.
  */
 export declare const LEGACY_WORKFLOW_STATE_ALIASES: Readonly<Record<string, WorkflowState>>;

package/dist/workflow/data/workflow-states.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-states.generated.d.ts","sourceRoot":"","sources":["../../../src/workflow/data/workflow-states.generated.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,eAAO,MAAM,eAAe,gPAUlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,8CAA8C;AAC9C,eAAO,MAAM,cAAc;;;;;;;;;;CAUjB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAGjF,CAAC"}

package/dist/{lib → workflow/data}/workflow-states.generated.js

@@ -24,7 +24,7 @@ export const WorkflowStates = {
     Released: 'Released',
 };
 /**
- * Retired state names still found on older project items and branch metadata, mapped to their
+ * Retired state names still found in older workflow data, mapped to their
  * current equivalents. Keys are lowercase; compare case-insensitively.
  */
 export const LEGACY_WORKFLOW_STATE_ALIASES = {

package/dist/workflow/data/workflow-states.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-states.generated.js","sourceRoot":"","sources":["../../../src/workflow/data/workflow-states.generated.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,wBAAwB;IACxB,yBAAyB;IACzB,6BAA6B;IAC7B,gCAAgC;IAChC,sBAAsB;IACtB,oBAAoB;IACpB,4BAA4B;IAC5B,qBAAqB;IACrB,UAAU;CACF,CAAC;AAIX,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,mBAAmB,EAAE,wBAAwB;IAC7C,mBAAmB,EAAE,yBAAyB;IAC9C,wBAAwB,EAAE,6BAA6B;IACvD,2BAA2B,EAAE,gCAAgC;IAC7D,mBAAmB,EAAE,sBAAsB;IAC3C,iBAAiB,EAAE,oBAAoB;IACvC,uBAAuB,EAAE,4BAA4B;IACrD,iBAAiB,EAAE,qBAAqB;IACxC,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA4C;IACpF,mBAAmB,EAAE,4BAA4B;IACjD,UAAU,EAAE,qBAAqB;CAClC,CAAC"}

package/dist/{lib → workflow/data}/workflow-states.js

@@ -6,7 +6,7 @@ export { WORKFLOW_STATES, WorkflowStates, LEGACY_WORKFLOW_STATE_ALIASES } from '
 export const WORKFLOW_STATE_ORDER = WORKFLOW_STATES;
 /**
  * Normalize a stored workflow state value to a current WorkflowState.
- * Accepts current names (case-insensitively, since older metadata files carry
+ * Accepts current names (case-insensitively, since stored statuses carry
  * variants like "Dev implementation"), maps legacy state names to their current
  * equivalents, and returns null for unrecognized values.
  */

package/dist/workflow/data/workflow-states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-states.js","sourceRoot":"","sources":["../../../src/workflow/data/workflow-states.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,6BAA6B,EAE9B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAGhH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA6B,eAAe,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAA8B;IACnE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,oBAAoB,CAAC,QAAQ,CAAC,OAAwB,CAAC,EAAE,CAAC;QAC5D,OAAO,OAAwB,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;IAC/F,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,OAAO,6BAA6B,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC9D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,oBAAoB,CAAC,MAAM,GAAG,CAAC;QAC1D,CAAC,CAAC,oBAAoB,CAAC,KAAK,GAAG,CAAC,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAA0B,EAAE,EAAiB;IACpF,MAAM,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEjD,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,IAAI,QAAQ,SAAS,EAAE,6BAA6B,CAAC,CAAC;IAC9G,CAAC;IAED,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB,EAAE,WAA0B;IAC/E,OAAO,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAC1F,CAAC"}

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

@@ -0,0 +1,53 @@
+import type { PrInfo } from '../../types/index.js';
+/**
+ * Stage 1 of change management as it applies to a branch and its PR
+ * (change-management-policy.md clause 2): the PR gets its assignee - the approver of record -
+ * and the assignee approves by merging it once the required CI/CD checks pass. Used by the
+ * workflow handlers for a project item's branch and by `ready-for-approval` / `approve-pr` for a
+ * branch with no project item (an integration branch, for instance). Nothing here reads or writes
+ * the item's workflow context on idea1.ai; that stays with the workflow engine.
+ */
+export interface ReadyForApprovalInput {
+    branchName: string;
+    /** The branch the PR targets. */
+    baseBranch: string;
+    /** The approver of record. A PR with no assignee has no approver (clause 2). */
+    assignee: string;
+    /** The raw `--reviewers` value: comma separated, possibly empty. */
+    reviewers: string;
+    /**
+     * Open the PR when the branch has none, with this title. Null on a project item's branch: that
+     * PR is created on the way into Dev Implementation, so a missing one is reported, not created.
+     */
+    createWhenMissing: {
+        title: string;
+    } | null;
+}
+/**
+ * The PR that carries the change, with its assignee and any requested reviewers set. A PR that has
+ * to be created gets the approval chain of what the branch carries as its body.
+ */
+export declare function ensurePrReadyForApproval(input: ReadyForApprovalInput): Promise<PrInfo>;
+export interface MergeAsApproverInput {
+    branchName: string;
+    baseBranch: string;
+    prNumber: number;
+}
+/**
+ * The stage-1 approval: the assignee merges the PR once the required checks pass. There is no
+ * admin override here (change-management-policy.md clause 3) - a red or unfinished suite stops it,
+ * and the only way past is to fix the build. The caller confirms the approver's identity first.
+ */
+export declare function mergeAsApprover(input: MergeAsApproverInput): Promise<void>;
+export interface CleanUpMergedBranchInput {
+    branchName: string;
+    baseBranch: string;
+    /** The branch's local checkout (worktree or main repo), or null when it has none. */
+    workingPath: string | null;
+}
+/**
+ * After the merge the branch is finished: the remote branch goes, and so do its worktree and local
+ * branch, leaving the user on a branch that still exists.
+ */
+export declare function cleanUpMergedBranch(input: CleanUpMergedBranchInput): Promise<void>;
+//# sourceMappingURL=approval-flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval-flow.d.ts","sourceRoot":"","sources":["../../../src/workflow/engine/approval-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD;;;;;;;GAOG;AAEH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC5F;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhF;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCxF"}

package/dist/workflow/engine/approval-flow.js

@@ -0,0 +1,111 @@
+import { logger } from '../../lib/logger.js';
+import { promptConfirm } from '../../lib/prompt.js';
+import * as git from '../../services/git.js';
+import * as github from '../../services/github.js';
+import { removeCurrentWorktree, resolveBaseBranch } from '../../services/worktree.js';
+import { CHANGE_KIND, createGatedPr } from './release-flow.js';
+/**
+ * The PR that carries the change, with its assignee and any requested reviewers set. A PR that has
+ * to be created gets the approval chain of what the branch carries as its body.
+ */
+export async function ensurePrReadyForApproval(input) {
+    const { branchName, baseBranch, assignee } = input;
+    let prInfo = await github.checkPrExists(branchName, baseBranch);
+    if (prInfo) {
+        logger.info(`PR #${prInfo.number} found`);
+    }
+    else {
+        if (!input.createWhenMissing) {
+            throw new Error('No PR exists for this branch. Move the item to Dev Implementation first (idea1 next), which creates the PR.');
+        }
+        await createGatedPr({
+            sourceBranch: branchName,
+            targetBranch: baseBranch,
+            title: input.createWhenMissing.title,
+            assignee,
+            kind: CHANGE_KIND
+        });
+        prInfo = await github.checkPrExists(branchName, baseBranch);
+        if (!prInfo) {
+            throw new Error(`The PR for ${branchName} was created but could not be read back from GitHub.`);
+        }
+    }
+    const reviewers = input.reviewers
+        .split(',')
+        .map(name => name.trim())
+        .filter(name => name.length > 0);
+    await github.assignReviewers(branchName, reviewers);
+    await github.assignAssignee(branchName, assignee);
+    logger.hint(`PR: ${prInfo.url}`);
+    return prInfo;
+}
+/**
+ * The stage-1 approval: the assignee merges the PR once the required checks pass. There is no
+ * admin override here (change-management-policy.md clause 3) - a red or unfinished suite stops it,
+ * and the only way past is to fix the build. The caller confirms the approver's identity first.
+ */
+export async function mergeAsApprover(input) {
+    const { branchName, baseBranch, prNumber } = input;
+    const confirmMerge = await promptConfirm(`Approve PR #${prNumber} by merging it (${branchName} -> ${baseBranch})?`, { default: true });
+    if (!confirmMerge) {
+        throw new Error('Merge cancelled by user');
+    }
+    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 mergeResult = await github.mergePr(branchName);
+    if (!mergeResult.success) {
+        throw new Error(`Failed to merge PR: ${mergeResult.error}`);
+    }
+}
+/**
+ * After the merge the branch is finished: the remote branch goes, and so do its worktree and local
+ * branch, leaving the user on a branch that still exists.
+ */
+export async function cleanUpMergedBranch(input) {
+    const { branchName, baseBranch, workingPath } = input;
+    await git.fetchLatest();
+    if (!workingPath) {
+        await github.deleteRemoteBranch(branchName);
+        return;
+    }
+    const isWorktree = await git.isInsideWorktree();
+    const mainRepoRoot = await git.getMainRepoRoot();
+    // Inside a worktree the base branch cannot be checked out in place, so the
+    // worktree is removed regardless of removeWorktreeAtState.
+    if (isWorktree) {
+        const worktreePath = await removeCurrentWorktree(mainRepoRoot);
+        await deleteBranchQuietly(branchName);
+        logger.hint(`Worktree removed: ${worktreePath}`);
+        logger.hint(`Change to a different folder (e.g. ${mainRepoRoot}) to continue.`);
+        return;
+    }
+    // Switch to the base branch (it may be checked out in another worktree)
+    const baseWorktreePath = await git.getWorktreePathForBranch(baseBranch);
+    if (baseWorktreePath) {
+        logger.step(`Base branch ${baseBranch} is in a worktree at ${baseWorktreePath}, pulling there...`);
+        await git.updateBranchToLatest(baseBranch);
+        const settingsBaseBranch = await resolveBaseBranch();
+        await git.checkoutAndPullBranch(settingsBaseBranch);
+    }
+    else {
+        await git.checkoutAndPullBranch(baseBranch);
+    }
+    await deleteBranchQuietly(branchName);
+    if (baseWorktreePath) {
+        logger.hint(`Base branch is in worktree at: ${baseWorktreePath}`);
+    }
+}
+async function deleteBranchQuietly(branchName) {
+    try {
+        await git.deleteBranch(branchName, true);
+    }
+    catch {
+        // The remote branch may already have been deleted automatically after the merge
+        logger.dim(`Note: Branch ${branchName} may have been automatically deleted after merge`);
+    }
+}
+//# sourceMappingURL=approval-flow.js.map

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

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

package/dist/{services → workflow/engine}/branch-setup.d.ts

@@ -1,4 +1,5 @@
-import type { CommandOption, DevWorkflowType } from '../types/index.js';
+import type { CommandOption } from '../../types/index.js';
+import type { DevWorkflowType } from '../data/workflow-context.js';
 export declare const WORKFLOW_CHOICES: {
     label: string;
     value: string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch-setup.d.ts","sourceRoot":"","sources":["../../../src/workflow/engine/branch-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,eAAO,MAAM,gBAAgB;;;GAG5B,CAAC;AAaF,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,EAyBhD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,eAAe,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oBAAoB,EAAE,0BAA0B,GAAG,IAAI,CAAC;CACzD;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAYnH;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BnE;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAoBtF"}

package/dist/{services → workflow/engine}/branch-setup.js

@@ -1,7 +1,8 @@
-import { logger } from '../lib/logger.js';
-import { promptInput, promptSelect } from '../lib/prompt.js';
-import * as git from './git.js';
-import * as worktree from './worktree.js';
+import { logger } from '../../lib/logger.js';
+import { promptInput, promptSelect } from '../../lib/prompt.js';
+import * as git from '../../services/git.js';
+import * as worktree from '../../services/worktree.js';
+import { resolveBranchForItem } from './workflow-engine.js';
 export const WORKFLOW_CHOICES = [
     { label: 'Independent Feature', value: 'independent' },
     { label: 'Work for Integration', value: 'integration' }
@@ -84,7 +85,7 @@ export async function promptForStackBranch() {
         if (!stackUrl) {
             throw new Error('Project item URL is required when stacking by URL');
         }
-        const stackBranch = await git.resolveBranchFromProjectItemUrl(stackUrl);
+        const stackBranch = await resolveBranchForItem(stackUrl);
         if (!stackBranch) {
             throw new Error(`No branch found for project item URL: ${stackUrl}. Make sure the project item has been started.`);
         }

package/dist/workflow/engine/branch-setup.js.map

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

package/dist/workflow/engine/handlers/agent-implementation.d.ts

@@ -0,0 +1,10 @@
+import { type WorkflowStateHandler } from '../workflow-engine.js';
+/**
+ * Entering "Agent Implementation": make sure the branch is checked out locally
+ * (worktree or main repo, per the isolation mode), then — once the state is
+ * recorded — launch Claude to implement the item with the Agent Implementation
+ * prompt, rendered against the item's branch context. This is the only
+ * transition that starts code-writing automation.
+ */
+export declare const agentImplementationHandler: WorkflowStateHandler;
+//# sourceMappingURL=agent-implementation.d.ts.map

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

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

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

@@ -0,0 +1,42 @@
+import { isolationModeOption, resolveIsolationMode } from '../../../lib/isolation.js';
+import { claudeEntryPointOption, claudeEntryPointPromptOptions, claudeSessionOptions, resolveClaudeSessionOptions } from '../../../lib/claude-options.js';
+import { projectItemPromptModel, renderAgentImplementationPrompt } from '../../../prompts/project-item-prompts.js';
+import * as git from '../../../services/git.js';
+import * as worktree from '../../../services/worktree.js';
+import { WorkflowStates } from '../../data/workflow-states.js';
+import { requireLiveContext, requireWorkingPath } from '../workflow-engine.js';
+/**
+ * Entering "Agent Implementation": make sure the branch is checked out locally
+ * (worktree or main repo, per the isolation mode), then — once the state is
+ * recorded — launch Claude to implement the item with the Agent Implementation
+ * prompt, rendered against the item's branch context. This is the only
+ * transition that starts code-writing automation.
+ */
+export const agentImplementationHandler = {
+    state: WorkflowStates.AgentImplementation,
+    options: [isolationModeOption, ...claudeSessionOptions, claudeEntryPointOption, ...claudeEntryPointPromptOptions],
+    async prepare(transition) {
+        const { branchName } = requireLiveContext(transition);
+        const isolationMode = resolveIsolationMode(transition.options);
+        const { workingPath } = await worktree.ensureBranchEnvironment(isolationMode, branchName);
+        transition.workingPath = workingPath;
+        if ((await git.getRepoRoot()).trim() !== workingPath) {
+            process.chdir(workingPath);
+        }
+    },
+    async complete(transition) {
+        const context = requireLiveContext(transition);
+        const workingPath = requireWorkingPath(transition, 'run the implementation session');
+        const { permissionMode, model, effort, claudeEntryPointMode, entryPointPrompt } = resolveClaudeSessionOptions(transition.options);
+        const prompt = await renderAgentImplementationPrompt(projectItemPromptModel(transition.projectItemUrl, context, workingPath), entryPointPrompt);
+        await worktree.launchClaudeForBranch(workingPath, {
+            projectItemUrl: transition.projectItemUrl,
+            prompt,
+            permissionMode,
+            model,
+            effort,
+            claudeEntryPointMode
+        });
+    }
+};
+//# sourceMappingURL=agent-implementation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-implementation.js","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/agent-implementation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC1J,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AACnH,OAAO,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAA6B,MAAM,uBAAuB,CAAC;AAE1G;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAyB;IAC9D,KAAK,EAAE,cAAc,CAAC,mBAAmB;IACzC,OAAO,EAAE,CAAC,mBAAmB,EAAE,GAAG,oBAAoB,EAAE,sBAAsB,EAAE,GAAG,6BAA6B,CAAC;IAEjH,KAAK,CAAC,OAAO,CAAC,UAAU;QACtB,MAAM,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAE/D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,QAAQ,CAAC,uBAAuB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC1F,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QAErC,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,UAAU;QACvB,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,kBAAkB,CAAC,UAAU,EAAE,gCAAgC,CAAC,CAAC;QACrF,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,GAAG,2BAA2B,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAClI,MAAM,MAAM,GAAG,MAAM,+BAA+B,CAClD,sBAAsB,CAAC,UAAU,CAAC,cAAc,EAAE,OAAO,EAAE,WAAW,CAAC,EACvE,gBAAgB,CACjB,CAAC;QAEF,MAAM,QAAQ,CAAC,qBAAqB,CAAC,WAAW,EAAE;YAChD,cAAc,EAAE,UAAU,CAAC,cAAc;YACzC,MAAM;YACN,cAAc;YACd,KAAK;YACL,MAAM;YACN,oBAAoB;SACrB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/{services/workflow-handlers → workflow/engine/handlers}/approve-pr.d.ts

@@ -1,12 +1,15 @@
-import type { WorkflowStateHandler } from '../../types/index.js';
+import { type WorkflowStateHandler } 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. 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.
+ * 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 declare const approvePrHandler: WorkflowStateHandler;
 //# sourceMappingURL=approve-pr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approve-pr.d.ts","sourceRoot":"","sources":["../../../../src/workflow/engine/handlers/approve-pr.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEtG;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAiD9B,CAAC"}