forge-cc 1.0.0 → 1.0.1

package/dist/go/linear-sync.d.ts

@@ -1,112 +0,0 @@
-/**
- * Linear Status Sync for Execution Engine
- *
- * Bridges the milestone executor with the Linear project management client.
- * Manages issue and project state transitions during the go execution flow:
- *
- * - Milestone start: issues -> In Progress, project -> In Progress
- * - Mid-execution: progress comments on milestone issues
- * - Milestone complete: issues -> In Review (last milestone) or progress comment
- * - Project done: issues -> Done, project -> Done (post-merge)
- *
- * All operations degrade gracefully — the execution engine must never fail
- * because Linear is unavailable or misconfigured.
- */
-export interface LinearSyncOptions {
-    projectId: string;
-    milestoneNumber: number;
-    milestoneName: string;
-    teamId?: string;
-    apiKey?: string;
-}
-export interface MilestoneStartSync {
-    linearMilestoneId: string | null;
-    issuesUpdated: number;
-    projectUpdated: boolean;
-}
-export interface MilestoneCompleteOptions extends LinearSyncOptions {
-    isLastMilestone: boolean;
-    prUrl?: string;
-}
-export interface MilestoneCompleteSync {
-    issuesUpdated: number;
-    projectUpdated: boolean;
-    finalState: string;
-}
-export interface ProgressCommentOptions {
-    projectId: string;
-    milestoneNumber: number;
-    milestoneName: string;
-    message: string;
-    apiKey?: string;
-}
-export interface ProjectIssueIdentifiers {
-    identifiers: string[];
-    issues: Array<{
-        id: string;
-        identifier: string;
-        title: string;
-    }>;
-}
-export interface ProjectDoneSync {
-    issuesUpdated: number;
-    projectUpdated: boolean;
-}
-/**
- * Execute a Linear operation safely — catches LinearClientError and logs
- * a warning instead of crashing. The execution engine should never fail
- * because Linear is unavailable.
- *
- * Returns the function's result on success, or null on failure.
- */
-export declare function syncLinearSafe<T>(fn: () => Promise<T>): Promise<T | null>;
-/**
- * Sync Linear state when a milestone starts execution.
- *
- * - Finds the Linear milestone by name
- * - Transitions all milestone issues to "In Progress"
- * - Transitions the project to "In Progress" (if not already)
- *
- * Degrades gracefully if Linear is unavailable or the milestone is not found.
- */
-export declare function syncMilestoneStart(options: LinearSyncOptions): Promise<MilestoneStartSync>;
-/**
- * Sync Linear state when a milestone completes.
- *
- * - If NOT the last milestone: adds a progress comment to each issue
- * - If IS the last milestone: transitions all project issues to "In Review",
- *   transitions the project to "In Review"
- *
- * Degrades gracefully if Linear is unavailable.
- */
-export declare function syncMilestoneComplete(options: MilestoneCompleteOptions): Promise<MilestoneCompleteSync>;
-/**
- * Add a progress comment to all issues in a milestone.
- * Used during execution to keep Linear updated with wave progress.
- *
- * Degrades gracefully if Linear is unavailable or the milestone is not found.
- */
-export declare function addMilestoneProgressComment(options: ProgressCommentOptions): Promise<void>;
-/**
- * Fetch all issue identifiers for a project (e.g., ["MSIG-123", "MSIG-124"]).
- * Used to inject `Closes TEAM-XXX` into PR descriptions so Linear's GitHub
- * integration auto-closes issues on merge.
- *
- * Degrades gracefully if Linear is unavailable.
- */
-export declare function fetchProjectIssueIdentifiers(options: {
-    projectId: string;
-    apiKey?: string;
-}): Promise<ProjectIssueIdentifiers | null>;
-/**
- * Transition all project issues and the project itself to "Done".
- * Intended for post-merge cleanup — run after a PR is merged to complete
- * the Linear lifecycle.
- *
- * Skips issues already in Done or Canceled state.
- * Degrades gracefully if Linear is unavailable.
- */
-export declare function syncProjectDone(options: {
-    projectId: string;
-    apiKey?: string;
-}): Promise<ProjectDoneSync>;

package/dist/go/linear-sync.js

@@ -1,375 +0,0 @@
-/**
- * Linear Status Sync for Execution Engine
- *
- * Bridges the milestone executor with the Linear project management client.
- * Manages issue and project state transitions during the go execution flow:
- *
- * - Milestone start: issues -> In Progress, project -> In Progress
- * - Mid-execution: progress comments on milestone issues
- * - Milestone complete: issues -> In Review (last milestone) or progress comment
- * - Project done: issues -> Done, project -> Done (post-merge)
- *
- * All operations degrade gracefully — the execution engine must never fail
- * because Linear is unavailable or misconfigured.
- */
-import { LinearClient, LinearClientError } from "../linear/client.js";
-import { transitionProject } from "../linear/projects.js";
-import { transitionMilestoneIssues, resolveStateId } from "../linear/issues.js";
-import { findMilestoneByName } from "../linear/milestones.js";
-// ---------------------------------------------------------------------------
-// Safe Wrapper
-// ---------------------------------------------------------------------------
-/**
- * Execute a Linear operation safely — catches LinearClientError and logs
- * a warning instead of crashing. The execution engine should never fail
- * because Linear is unavailable.
- *
- * Returns the function's result on success, or null on failure.
- */
-export async function syncLinearSafe(fn) {
-    try {
-        return await fn();
-    }
-    catch (error) {
-        if (error instanceof LinearClientError) {
-            console.warn(`[linear-sync] Linear operation failed: ${error.message}`);
-            return null;
-        }
-        // Re-throw unexpected errors — they indicate bugs, not Linear issues
-        throw error;
-    }
-}
-// ---------------------------------------------------------------------------
-// Client Creation
-// ---------------------------------------------------------------------------
-/**
- * Attempt to create a LinearClient. Returns null and logs a warning
- * if no API key is available (graceful degradation).
- */
-function createClientSafe(apiKey) {
-    try {
-        return new LinearClient(apiKey);
-    }
-    catch (error) {
-        if (error instanceof LinearClientError) {
-            console.warn(`[linear-sync] Linear client unavailable: ${error.message}`);
-            return null;
-        }
-        throw error;
-    }
-}
-// ---------------------------------------------------------------------------
-// Milestone Start
-// ---------------------------------------------------------------------------
-/**
- * Sync Linear state when a milestone starts execution.
- *
- * - Finds the Linear milestone by name
- * - Transitions all milestone issues to "In Progress"
- * - Transitions the project to "In Progress" (if not already)
- *
- * Degrades gracefully if Linear is unavailable or the milestone is not found.
- */
-export async function syncMilestoneStart(options) {
-    const noopResult = {
-        linearMilestoneId: null,
-        issuesUpdated: 0,
-        projectUpdated: false,
-    };
-    const client = createClientSafe(options.apiKey);
-    if (!client)
-        return noopResult;
-    const result = await syncLinearSafe(async () => {
-        // Find the milestone in Linear
-        const milestone = await findMilestoneByName(client, options.projectId, options.milestoneName);
-        if (!milestone) {
-            console.warn(`[linear-sync] Milestone "${options.milestoneName}" not found in project ${options.projectId}. Skipping issue transitions.`);
-            // Still try to transition the project
-            let projectUpdated = false;
-            try {
-                await transitionProject(client, options.projectId, "In Progress");
-                projectUpdated = true;
-            }
-            catch {
-                // Project may already be In Progress or beyond — that's fine
-            }
-            return {
-                linearMilestoneId: null,
-                issuesUpdated: 0,
-                projectUpdated,
-            };
-        }
-        // Derive teamId from options or from milestone issues
-        let teamId = options.teamId;
-        if (!teamId) {
-            const milestoneIssues = await client.listIssues({
-                projectId: options.projectId,
-                milestoneId: milestone.id,
-            });
-            teamId = milestoneIssues[0]?.teamId;
-        }
-        if (!teamId) {
-            console.warn(`[linear-sync] No teamId available — cannot resolve state UUIDs. Skipping issue transitions.`);
-            // Still try to transition the project
-            let projectUpdated = false;
-            try {
-                await transitionProject(client, options.projectId, "In Progress");
-                projectUpdated = true;
-            }
-            catch {
-                // Project may already be In Progress or beyond — that's fine
-            }
-            return {
-                linearMilestoneId: milestone.id,
-                issuesUpdated: 0,
-                projectUpdated,
-            };
-        }
-        // Transition milestone issues to In Progress
-        const { updated } = await transitionMilestoneIssues(client, options.projectId, milestone.id, "In Progress", teamId);
-        // Transition project to In Progress
-        let projectUpdated = false;
-        try {
-            await transitionProject(client, options.projectId, "In Progress");
-            projectUpdated = true;
-        }
-        catch {
-            // Project may already be In Progress or beyond — that's fine
-        }
-        return {
-            linearMilestoneId: milestone.id,
-            issuesUpdated: updated,
-            projectUpdated,
-        };
-    });
-    return result ?? noopResult;
-}
-// ---------------------------------------------------------------------------
-// Milestone Complete
-// ---------------------------------------------------------------------------
-/**
- * Sync Linear state when a milestone completes.
- *
- * - If NOT the last milestone: adds a progress comment to each issue
- * - If IS the last milestone: transitions all project issues to "In Review",
- *   transitions the project to "In Review"
- *
- * Degrades gracefully if Linear is unavailable.
- */
-export async function syncMilestoneComplete(options) {
-    const noopResult = {
-        issuesUpdated: 0,
-        projectUpdated: false,
-        finalState: "unknown",
-    };
-    const client = createClientSafe(options.apiKey);
-    if (!client)
-        return noopResult;
-    const result = await syncLinearSafe(async () => {
-        if (!options.isLastMilestone) {
-            // Mid-project milestone — add progress comments
-            const milestone = await findMilestoneByName(client, options.projectId, options.milestoneName);
-            if (milestone) {
-                const issues = await client.listIssues({
-                    projectId: options.projectId,
-                    milestoneId: milestone.id,
-                });
-                const commentBody = `Milestone ${options.milestoneNumber} complete. Moving to next milestone.`;
-                for (const issue of issues) {
-                    await client.createComment(issue.id, commentBody);
-                }
-                return {
-                    issuesUpdated: issues.length,
-                    projectUpdated: false,
-                    finalState: "In Progress",
-                };
-            }
-            return {
-                issuesUpdated: 0,
-                projectUpdated: false,
-                finalState: "In Progress",
-            };
-        }
-        // Last milestone — move everything to In Review
-        // Get ALL project issues (not just this milestone's)
-        const allIssues = await client.listIssues({
-            projectId: options.projectId,
-        });
-        // Resolve state UUIDs per team (state IDs are team-scoped)
-        const stateIdByTeam = new Map();
-        if (options.teamId) {
-            try {
-                const id = await resolveStateId(client, options.teamId, "In Review");
-                stateIdByTeam.set(options.teamId, id);
-            }
-            catch {
-                // State resolution failed for this team
-            }
-        }
-        for (const issue of allIssues) {
-            if (issue.teamId && !stateIdByTeam.has(issue.teamId)) {
-                try {
-                    const id = await resolveStateId(client, issue.teamId, "In Review");
-                    stateIdByTeam.set(issue.teamId, id);
-                }
-                catch {
-                    // State resolution failed for this team — will fall back to name
-                }
-            }
-        }
-        let updatedCount = 0;
-        for (const issue of allIssues) {
-            if (issue.state !== "In Review" && issue.state !== "Done") {
-                try {
-                    const issueStateId = issue.teamId ? stateIdByTeam.get(issue.teamId) : undefined;
-                    await client.updateIssue(issue.id, issueStateId ? { stateId: issueStateId } : { state: "In Review" });
-                    updatedCount++;
-                }
-                catch {
-                    // Some issues may not support this transition — skip them
-                }
-            }
-        }
-        // Add PR link comment if available
-        if (options.prUrl) {
-            for (const issue of allIssues) {
-                try {
-                    await client.createComment(issue.id, `PR created: ${options.prUrl}`);
-                }
-                catch {
-                    // Comment failures are non-critical
-                }
-            }
-        }
-        // Transition project to In Review
-        let projectUpdated = false;
-        try {
-            await transitionProject(client, options.projectId, "In Review");
-            projectUpdated = true;
-        }
-        catch {
-            // Project may already be In Review or beyond — that's fine
-        }
-        return {
-            issuesUpdated: updatedCount,
-            projectUpdated,
-            finalState: "In Review",
-        };
-    });
-    return result ?? noopResult;
-}
-// ---------------------------------------------------------------------------
-// Progress Comments
-// ---------------------------------------------------------------------------
-/**
- * Add a progress comment to all issues in a milestone.
- * Used during execution to keep Linear updated with wave progress.
- *
- * Degrades gracefully if Linear is unavailable or the milestone is not found.
- */
-export async function addMilestoneProgressComment(options) {
-    const client = createClientSafe(options.apiKey);
-    if (!client)
-        return;
-    await syncLinearSafe(async () => {
-        const milestone = await findMilestoneByName(client, options.projectId, options.milestoneName);
-        if (!milestone) {
-            console.warn(`[linear-sync] Milestone "${options.milestoneName}" not found. Skipping progress comment.`);
-            return;
-        }
-        const issues = await client.listIssues({
-            projectId: options.projectId,
-            milestoneId: milestone.id,
-        });
-        for (const issue of issues) {
-            await client.createComment(issue.id, options.message);
-        }
-    });
-}
-// ---------------------------------------------------------------------------
-// Fetch Project Issue Identifiers
-// ---------------------------------------------------------------------------
-/**
- * Fetch all issue identifiers for a project (e.g., ["MSIG-123", "MSIG-124"]).
- * Used to inject `Closes TEAM-XXX` into PR descriptions so Linear's GitHub
- * integration auto-closes issues on merge.
- *
- * Degrades gracefully if Linear is unavailable.
- */
-export async function fetchProjectIssueIdentifiers(options) {
-    const client = createClientSafe(options.apiKey);
-    if (!client)
-        return null;
-    return syncLinearSafe(async () => {
-        const allIssues = await client.listIssues({
-            projectId: options.projectId,
-        });
-        return {
-            identifiers: allIssues.map((issue) => issue.identifier),
-            issues: allIssues.map((issue) => ({
-                id: issue.id,
-                identifier: issue.identifier,
-                title: issue.title,
-            })),
-        };
-    });
-}
-// ---------------------------------------------------------------------------
-// Project Done
-// ---------------------------------------------------------------------------
-/**
- * Transition all project issues and the project itself to "Done".
- * Intended for post-merge cleanup — run after a PR is merged to complete
- * the Linear lifecycle.
- *
- * Skips issues already in Done or Canceled state.
- * Degrades gracefully if Linear is unavailable.
- */
-export async function syncProjectDone(options) {
-    const noopResult = { issuesUpdated: 0, projectUpdated: false };
-    const client = createClientSafe(options.apiKey);
-    if (!client)
-        return noopResult;
-    const result = await syncLinearSafe(async () => {
-        const allIssues = await client.listIssues({
-            projectId: options.projectId,
-        });
-        // Resolve state UUIDs per team (state IDs are team-scoped)
-        const stateIdByTeam = new Map();
-        for (const issue of allIssues) {
-            if (issue.teamId && !stateIdByTeam.has(issue.teamId)) {
-                try {
-                    const id = await resolveStateId(client, issue.teamId, "Done");
-                    stateIdByTeam.set(issue.teamId, id);
-                }
-                catch {
-                    // State resolution failed for this team — will fall back to name
-                }
-            }
-        }
-        let updatedCount = 0;
-        for (const issue of allIssues) {
-            if (issue.state !== "Done" && issue.state !== "Canceled") {
-                try {
-                    const issueStateId = issue.teamId ? stateIdByTeam.get(issue.teamId) : undefined;
-                    await client.updateIssue(issue.id, issueStateId ? { stateId: issueStateId } : { state: "Done" });
-                    updatedCount++;
-                }
-                catch {
-                    // Some issues may not support this transition — skip them
-                }
-            }
-        }
-        let projectUpdated = false;
-        try {
-            await transitionProject(client, options.projectId, "Done");
-            projectUpdated = true;
-        }
-        catch {
-            // Project may already be Done or the transition may be invalid
-        }
-        return { issuesUpdated: updatedCount, projectUpdated };
-    });
-    return result ?? noopResult;
-}
-//# sourceMappingURL=linear-sync.js.map

package/dist/go/linear-sync.js.map

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

package/dist/go/prd-queue.d.ts

@@ -1,43 +0,0 @@
-/**
- * PRD Queue — Multi-PRD Execution Queue Manager
- *
- * Scans all PRDs, determines which have pending milestones, and tracks
- * which PRDs are currently being executed by active sessions.
- * Used by `npx forge run --all` to dispatch parallel PRD execution.
- */
-export interface PRDQueueEntry {
-    slug: string;
-    project: string;
-    branch: string;
-    pendingMilestones: number;
-    nextMilestone: number | null;
-    isExecuting: boolean;
-}
-export declare class PRDQueue {
-    private projectDir;
-    private repoRoot;
-    constructor(projectDir: string);
-    /**
-     * Scan all PRDs and return queue entries with execution status.
-     *
-     * For each discovered PRD:
-     * - Counts pending milestones
-     * - Finds the next pending milestone number
-     * - Checks the session registry for active sessions with a matching prdSlug
-     */
-    scanPRDs(): Promise<PRDQueueEntry[]>;
-    /**
-     * Get PRDs that are ready to execute.
-     *
-     * A PRD is ready when it has pending milestones and is not currently
-     * being executed by any active session.
-     */
-    getReadyPRDs(): Promise<PRDQueueEntry[]>;
-    /**
-     * Check if a PRD is currently being executed by any active session.
-     *
-     * Loads the session registry and checks for active sessions whose
-     * `prdSlug` field matches the given slug.
-     */
-    isExecuting(slug: string): boolean;
-}

package/dist/go/prd-queue.js

@@ -1,67 +0,0 @@
-/**
- * PRD Queue — Multi-PRD Execution Queue Manager
- *
- * Scans all PRDs, determines which have pending milestones, and tracks
- * which PRDs are currently being executed by active sessions.
- * Used by `npx forge run --all` to dispatch parallel PRD execution.
- */
-import { discoverPRDs, findNextPendingMilestone, countPendingMilestones, } from "../state/prd-status.js";
-import { getActiveSessions } from "../worktree/session.js";
-import { getRepoRoot } from "../worktree/manager.js";
-// ---------------------------------------------------------------------------
-// PRDQueue
-// ---------------------------------------------------------------------------
-export class PRDQueue {
-    projectDir;
-    repoRoot;
-    constructor(projectDir) {
-        this.projectDir = projectDir;
-        this.repoRoot = getRepoRoot(projectDir);
-    }
-    /**
-     * Scan all PRDs and return queue entries with execution status.
-     *
-     * For each discovered PRD:
-     * - Counts pending milestones
-     * - Finds the next pending milestone number
-     * - Checks the session registry for active sessions with a matching prdSlug
-     */
-    async scanPRDs() {
-        const prds = await discoverPRDs(this.projectDir);
-        const entries = [];
-        for (const prd of prds) {
-            const pending = await countPendingMilestones(this.projectDir, prd.slug);
-            const nextPending = await findNextPendingMilestone(this.projectDir, prd.slug);
-            entries.push({
-                slug: prd.slug,
-                project: prd.status.project,
-                branch: prd.status.branch,
-                pendingMilestones: pending,
-                nextMilestone: nextPending ? nextPending.number : null,
-                isExecuting: this.isExecuting(prd.slug),
-            });
-        }
-        return entries;
-    }
-    /**
-     * Get PRDs that are ready to execute.
-     *
-     * A PRD is ready when it has pending milestones and is not currently
-     * being executed by any active session.
-     */
-    async getReadyPRDs() {
-        const all = await this.scanPRDs();
-        return all.filter((entry) => entry.pendingMilestones > 0 && !entry.isExecuting);
-    }
-    /**
-     * Check if a PRD is currently being executed by any active session.
-     *
-     * Loads the session registry and checks for active sessions whose
-     * `prdSlug` field matches the given slug.
-     */
-    isExecuting(slug) {
-        const activeSessions = getActiveSessions(this.repoRoot);
-        return activeSessions.some((session) => session.prdSlug === slug);
-    }
-}
-//# sourceMappingURL=prd-queue.js.map

package/dist/go/prd-queue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prd-queue.js","sourceRoot":"","sources":["../../src/go/prd-queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAerD,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,OAAO,QAAQ;IACX,UAAU,CAAS;IACnB,QAAQ,CAAS;IAEzB,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,OAAO,GAAoB,EAAE,CAAC;QAEpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACxE,MAAM,WAAW,GAAG,MAAM,wBAAwB,CAChD,IAAI,CAAC,UAAU,EACf,GAAG,CAAC,IAAI,CACT,CAAC;YAEF,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO;gBAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM;gBACzB,iBAAiB,EAAE,OAAO;gBAC1B,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;gBACtD,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,OAAO,GAAG,CAAC,MAAM,CACf,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAC7D,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAY;QACtB,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,OAAO,cAAc,CAAC,IAAI,CACxB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CACtC,CAAC;IACJ,CAAC;CACF"}

package/dist/go/prd-selector.d.ts

@@ -1,57 +0,0 @@
-/**
- * PRD Selector — Discovery and Presentation for PRD Picking
- *
- * Wraps the low-level prd-status module to provide higher-level functions
- * for the /forge:go skill's PRD selection UI. Discovers PRDs with pending
- * milestones, formats them for AskUserQuestion pickers, and handles
- * single-PRD auto-selection.
- */
-export interface PendingPRD {
-    slug: string;
-    project: string;
-    branch: string;
-    pendingCount: number;
-    completeCount: number;
-    totalCount: number;
-}
-export interface PRDPickerOption {
-    label: string;
-    description: string;
-}
-export interface ModePickerOption {
-    label: string;
-    description: string;
-}
-export interface SelectPRDResult {
-    prd: PendingPRD;
-    autoSelected: boolean;
-}
-/**
- * Discover all PRDs that have at least one pending milestone.
- *
- * Wraps `discoverPRDs()` from prd-status, filters to those with pending
- * milestones, and computes completion counts for each.
- */
-export declare function discoverPendingPRDs(projectDir: string): Promise<PendingPRD[]>;
-/**
- * Format pending PRDs as label/description pairs for AskUserQuestion.
- *
- * Each option shows the project name, branch, and milestone progress.
- * Example label: "forge-agent-teams (2/5 complete)"
- * Example description: "Branch: feat/agent-teams | 3 milestones remaining"
- */
-export declare function presentPRDPicker(prds: PendingPRD[]): PRDPickerOption[];
-/**
- * Return the two execution mode options for AskUserQuestion.
- *
- * - "Single milestone" — execute one milestone, then stop for review
- * - "Auto (all milestones)" — chain through all pending milestones
- */
-export declare function presentModePicker(): ModePickerOption[];
-/**
- * Convenience function: discover pending PRDs and auto-select if only one.
- *
- * Returns the selected PRD and whether it was auto-selected (skipping the
- * picker). Returns null if no PRDs have pending milestones.
- */
-export declare function selectPRD(projectDir: string): Promise<SelectPRDResult | null>;