@promptwheel/cli 0.6.0

package/dist/lib/solo-config.js

@@ -0,0 +1,354 @@
+/**
+ * Solo mode configuration
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import chalk from 'chalk';
+import { createSQLiteAdapter } from '@promptwheel/sqlite';
+import { getDefaultDatabaseUrl } from '@promptwheel/core/db';
+import { createGitService } from './git.js';
+import { createLogger } from './logger.js';
+import { detectProjectMetadata } from './project-metadata/index.js';
+import { LINTER_COMMANDS, TYPE_CHECKER_COMMANDS } from './tool-command-map.js';
+/**
+ * Default retention configuration — conservative values.
+ */
+export const DEFAULT_RETENTION_CONFIG = {
+    maxRuns: 50,
+    maxHistoryEntries: 100,
+    maxArtifactsPerRun: 20,
+    maxSpoolArchives: 5,
+    maxDeferredProposals: 20,
+    maxCompletedTickets: 200,
+    maxSpindleFileEditKeys: 200,
+    maxMergedBranches: 10,
+    maxStaleBranchDays: 7,
+    maxLogSizeBytes: 1_048_576, // 1MB
+    maxArtifactAgeDays: 14,
+    maxMetricsEntries: 500,
+};
+/**
+ * Default auto config — permissive wheel settings.
+ * Let the scout and dedup do their jobs; don't gate artificially.
+ */
+export const DEFAULT_AUTO_CONFIG = {
+    allowCategories: ['refactor', 'docs', 'types', 'perf', 'security', 'fix', 'cleanup', 'test'],
+    blockCategories: [],
+    minConfidence: 0,
+    maxPrs: 3,
+    docsAudit: true,
+    docsAuditInterval: 3,
+    pullEveryNCycles: 5,
+    pullPolicy: 'halt',
+    guidelinesRefreshCycles: 10,
+    autoCreateGuidelines: true,
+    guidelinesPath: null,
+    adversarialReview: false,
+    learningsEnabled: true,
+    learningsBudget: 2000,
+    learningsDecayRate: 3,
+    conflictSensitivity: 'relaxed',
+};
+/**
+ * Get the .promptwheel directory path (repo-local or global)
+ */
+export function getPromptwheelDir(repoRoot) {
+    if (repoRoot) {
+        return path.join(repoRoot, '.promptwheel');
+    }
+    const home = process.env.HOME || process.env.USERPROFILE || '.';
+    return path.join(home, '.promptwheel');
+}
+/**
+ * Get database path
+ */
+export function getDbPath(repoRoot) {
+    const dir = getPromptwheelDir(repoRoot);
+    return path.join(dir, 'state.sqlite');
+}
+/**
+ * Check if solo mode is initialized for a repo
+ */
+export function isInitialized(repoRoot) {
+    const configPath = path.join(getPromptwheelDir(repoRoot), 'config.json');
+    return fs.existsSync(configPath);
+}
+/**
+ * Detect QA commands from project configuration
+ */
+export function detectQaCommands(repoRoot) {
+    const commands = [];
+    const packageJsonPath = path.join(repoRoot, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            const scripts = packageJson.scripts || {};
+            const qaPatterns = [
+                { pattern: 'typecheck', priority: 1, name: 'typecheck' },
+                { pattern: 'type-check', priority: 1, name: 'typecheck' },
+                { pattern: 'check:types', priority: 1, name: 'typecheck' },
+                { pattern: 'lint', priority: 2, name: 'lint' },
+                { pattern: /^lint:.*/, priority: 2, name: 'lint' },
+                { pattern: 'check', priority: 3, name: 'check' },
+                { pattern: 'test', priority: 4, name: 'test' },
+                { pattern: 'test:unit', priority: 4, name: 'test:unit' },
+                { pattern: 'build', priority: 5, name: 'build' },
+            ];
+            const added = new Set();
+            for (const { pattern, name } of qaPatterns) {
+                for (const [scriptName, _scriptCmd] of Object.entries(scripts)) {
+                    const matches = typeof pattern === 'string'
+                        ? scriptName === pattern
+                        : pattern.test(scriptName);
+                    if (matches && !added.has(scriptName)) {
+                        added.add(scriptName);
+                        commands.push({
+                            name: scriptName === name ? name : `${name} (${scriptName})`,
+                            cmd: `npm run ${scriptName}`,
+                            source: 'package.json',
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore JSON parse errors
+        }
+    } // end if packageJsonPath exists
+    // Fall through to project metadata detection for non-Node projects
+    // (or Node projects missing scripts). Dedup against already-added names.
+    try {
+        const addedNames = new Set(commands.map(c => c.name));
+        const meta = detectProjectMetadata(repoRoot);
+        if (meta.test_runner && !addedNames.has('test')) {
+            commands.push({
+                name: 'test',
+                cmd: meta.test_runner.run_command,
+                source: 'detected',
+            });
+            addedNames.add('test');
+        }
+        if (meta.linter && LINTER_COMMANDS[meta.linter] && !addedNames.has('lint')) {
+            commands.push({
+                name: 'lint',
+                cmd: LINTER_COMMANDS[meta.linter],
+                source: 'detected',
+            });
+            addedNames.add('lint');
+        }
+        if (meta.type_checker && TYPE_CHECKER_COMMANDS[meta.type_checker] && !addedNames.has('typecheck')) {
+            commands.push({
+                name: 'typecheck',
+                cmd: TYPE_CHECKER_COMMANDS[meta.type_checker],
+                source: 'detected',
+            });
+            addedNames.add('typecheck');
+        }
+    }
+    catch {
+        // Metadata detection failed — non-fatal
+    }
+    // Sort by priority order
+    const order = ['typecheck', 'lint', 'check', 'test', 'build'];
+    commands.sort((a, b) => {
+        const aIdx = order.findIndex(o => a.name.startsWith(o));
+        const bIdx = order.findIndex(o => b.name.startsWith(o));
+        return (aIdx === -1 ? 99 : aIdx) - (bIdx === -1 ? 99 : bIdx);
+    });
+    return commands;
+}
+/**
+ * Auto-detect a setup command for worktree initialization.
+ * Returns a shell command string or null if nothing detected.
+ */
+export function detectSetupCommand(repoRoot) {
+    const parts = [];
+    // Detect package manager install command
+    if (fs.existsSync(path.join(repoRoot, 'pnpm-lock.yaml'))) {
+        parts.push('pnpm install --frozen-lockfile');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'yarn.lock'))) {
+        parts.push('yarn install --frozen-lockfile');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'bun.lockb')) || fs.existsSync(path.join(repoRoot, 'bun.lock'))) {
+        parts.push('bun install --frozen-lockfile');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'package-lock.json')) || fs.existsSync(path.join(repoRoot, 'package.json'))) {
+        parts.push('npm ci');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'Pipfile.lock'))) {
+        parts.push('pipenv install --deploy');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'poetry.lock'))) {
+        parts.push('poetry install --no-interaction');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'requirements.txt'))) {
+        parts.push('pip install -r requirements.txt');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'Gemfile.lock'))) {
+        parts.push('bundle install');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'go.sum'))) {
+        parts.push('go mod download');
+    }
+    else if (fs.existsSync(path.join(repoRoot, 'mix.lock'))) {
+        parts.push('mix deps.get');
+    }
+    // Rust/Cargo: no install step needed (cargo build happens via QA commands)
+    // Detect code generation steps
+    if (fs.existsSync(path.join(repoRoot, 'prisma')) || fs.existsSync(path.join(repoRoot, 'schema.prisma'))) {
+        // Use the same package manager runner for prisma generate
+        const runner = fs.existsSync(path.join(repoRoot, 'pnpm-lock.yaml')) ? 'pnpm'
+            : fs.existsSync(path.join(repoRoot, 'yarn.lock')) ? 'yarn'
+                : 'npx';
+        parts.push(`${runner} prisma generate`);
+    }
+    return parts.length > 0 ? parts.join(' && ') : null;
+}
+/**
+ * Initialize solo mode for a repository
+ */
+export async function initSolo(repoRoot) {
+    const dir = getPromptwheelDir(repoRoot);
+    const configPath = path.join(dir, 'config.json');
+    const dbPath = getDbPath(repoRoot);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const detectedQa = detectQaCommands(repoRoot);
+    // Capture origin remote URL for safety validation
+    let allowedRemote;
+    try {
+        const { execSync } = await import('child_process');
+        allowedRemote = execSync('git remote get-url origin', { cwd: repoRoot, encoding: 'utf-8' }).trim();
+    }
+    catch {
+        // No remote configured yet — that's fine
+    }
+    const config = {
+        version: 1,
+        repoRoot,
+        createdAt: new Date().toISOString(),
+        dbPath,
+        ...(allowedRemote ? { allowedRemote } : {}),
+    };
+    if (detectedQa.length > 0) {
+        config.qa = {
+            commands: detectedQa.map(c => ({
+                name: c.name,
+                cmd: c.cmd,
+            })),
+        };
+    }
+    // Auto-detect setup command from project metadata
+    const setupCmd = detectSetupCommand(repoRoot);
+    if (setupCmd) {
+        config.setup = setupCmd;
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    const gitignorePath = path.join(repoRoot, '.gitignore');
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, 'utf-8');
+        if (!content.includes('.promptwheel')) {
+            fs.appendFileSync(gitignorePath, '\n# PromptWheel local state\n.promptwheel/\n');
+        }
+    }
+    return { config, detectedQa };
+}
+/**
+ * Load solo config
+ */
+export function loadConfig(repoRoot) {
+    const configPath = path.join(getPromptwheelDir(repoRoot), 'config.json');
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    // Backfill setup command for existing configs that predate the feature
+    if (!config.setup) {
+        const detected = detectSetupCommand(repoRoot);
+        if (detected) {
+            config.setup = detected;
+            fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+        }
+    }
+    return config;
+}
+/**
+ * Save solo config (merges updates into existing config)
+ */
+export function saveConfig(repoRoot, updates) {
+    const configPath = path.join(getPromptwheelDir(repoRoot), 'config.json');
+    const existing = loadConfig(repoRoot);
+    if (!existing)
+        return;
+    const merged = { ...existing, ...updates };
+    fs.writeFileSync(configPath, JSON.stringify(merged, null, 2));
+}
+/**
+ * Get or create database adapter
+ */
+export async function getAdapter(repoRoot) {
+    const dbPath = repoRoot ? getDbPath(repoRoot) : getDefaultDatabaseUrl();
+    return createSQLiteAdapter({ url: dbPath });
+}
+/**
+ * Create scout dependencies
+ */
+export function createScoutDeps(db, opts = {}) {
+    return {
+        db,
+        git: createGitService(),
+        logger: createLogger(opts),
+    };
+}
+/**
+ * Format progress for display
+ */
+export function formatProgress(progress) {
+    switch (progress.phase) {
+        case 'init':
+            return chalk.gray(progress.message || 'Initializing...');
+        case 'scanning':
+            return chalk.gray(progress.message || 'Scanning files...');
+        case 'analyzing':
+            return chalk.gray(progress.message
+                ? `${progress.message} (${progress.filesScanned}/${progress.totalFiles} files, ${progress.proposalsFound} proposals)`
+                : `Analyzing (${progress.filesScanned}/${progress.totalFiles} files, ${progress.proposalsFound} proposals)`);
+        case 'storing':
+            return chalk.gray(progress.message || 'Storing results...');
+        case 'complete':
+            return chalk.green(`Complete: ${progress.proposalsFound} proposals, ` +
+                `${progress.ticketsCreated} tickets created`);
+        default:
+            return '';
+    }
+}
+/**
+ * Display a proposal summary
+ */
+export function displayProposal(proposal, index) {
+    const categoryColors = {
+        refactor: chalk.cyan,
+        docs: chalk.yellow,
+        test: chalk.green,
+        perf: chalk.magenta,
+        security: chalk.red,
+        fix: chalk.redBright,
+        cleanup: chalk.gray,
+        types: chalk.blue,
+    };
+    const color = categoryColors[proposal.category] || chalk.white;
+    console.log();
+    console.log(chalk.bold(`${index + 1}. ${proposal.title}`));
+    const impactStr = proposal.impact_score !== null ? ` | impact ${proposal.impact_score}/10` : '';
+    console.log(`   ${color(proposal.category)} | ` +
+        `${proposal.estimated_complexity} | ` +
+        `${proposal.confidence}% confidence${impactStr}`);
+    console.log(`   ${chalk.gray(proposal.description.slice(0, 100))}` +
+        `${proposal.description.length > 100 ? '...' : ''}`);
+    console.log(`   ${chalk.gray('Files:')} ` +
+        `${proposal.files.slice(0, 3).join(', ')}` +
+        `${proposal.files.length > 3 ? ` +${proposal.files.length - 3} more` : ''}`);
+}
+//# sourceMappingURL=solo-config.js.map

package/dist/lib/solo-config.js.map

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

package/dist/lib/solo-cycle-formula.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Formula and category selection logic for auto-mode cycles.
+ */
+import type { Formula } from './formulas.js';
+export interface CycleFormulaContext {
+    activeFormula: Formula | null;
+    sessionPhase: 'warmup' | 'deep' | 'cooldown';
+    deepFormula: Formula | null;
+    docsAuditFormula: Formula | null;
+    isContinuous: boolean;
+    repoRoot: string;
+    options: {
+        docsAuditInterval?: string;
+        safe?: boolean;
+        tests?: boolean;
+    };
+    config: {
+        auto?: {
+            docsAuditInterval?: number;
+            docsAudit?: boolean;
+        };
+    } | null;
+    sectorProductionFileCount?: number;
+}
+/**
+ * Determine the formula to use for a given cycle.
+ */
+export declare function getCycleFormula(ctx: CycleFormulaContext, cycle: number): Formula | null;
+/**
+ * Get allow/block category lists for a given formula and session context.
+ */
+export declare function getCycleCategories(ctx: CycleFormulaContext, formula: Formula | null): {
+    allow: string[];
+    block: string[];
+};
+//# sourceMappingURL=solo-cycle-formula.d.ts.map

package/dist/lib/solo-cycle-formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solo-cycle-formula.d.ts","sourceRoot":"","sources":["../../src/lib/solo-cycle-formula.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACP,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9E,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAyDvF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAsB1H"}

package/dist/lib/solo-cycle-formula.js

@@ -0,0 +1,90 @@
+/**
+ * Formula and category selection logic for auto-mode cycles.
+ */
+import { readRunState, isDocsAuditDue } from './run-state.js';
+/**
+ * Determine the formula to use for a given cycle.
+ */
+export function getCycleFormula(ctx, cycle) {
+    const { activeFormula, sessionPhase, deepFormula, docsAuditFormula, isContinuous, repoRoot, options, config } = ctx;
+    if (activeFormula)
+        return activeFormula;
+    // Session arc: cooldown phase → no formula (light work only)
+    if (sessionPhase === 'cooldown')
+        return null;
+    const rs = readRunState(repoRoot);
+    // Hard guarantee: deep at least every 7 cycles
+    if (deepFormula && isContinuous) {
+        const deepStats = rs.formulaStats['deep'];
+        if (cycle - (deepStats?.lastResetCycle ?? 0) >= 7) {
+            // Session arc: warmup phase → skip deep
+            if (sessionPhase !== 'warmup' && (ctx.sectorProductionFileCount ?? Infinity) >= 25)
+                return deepFormula;
+        }
+    }
+    // Docs-audit: keep existing periodic logic
+    if (docsAuditFormula && repoRoot) {
+        let interval = options.docsAuditInterval
+            ? parseInt(options.docsAuditInterval, 10)
+            : config?.auto?.docsAuditInterval ?? 3;
+        const docsStats = rs.formulaStats['docs-audit'];
+        if (docsStats && docsStats.cycles >= 3 && docsStats.proposalsGenerated === 0) {
+            interval = Math.max(interval, 10);
+        }
+        if (config?.auto?.docsAudit !== false && isDocsAuditDue(repoRoot, interval))
+            return docsAuditFormula;
+    }
+    // Session arc: warmup phase → skip UCB1 deep selection
+    if (sessionPhase === 'warmup')
+        return null;
+    // UCB1 selection: default vs deep
+    if (!deepFormula || !isContinuous)
+        return null;
+    const candidates = [
+        { name: 'default', formula: null },
+        { name: 'deep', formula: deepFormula },
+    ];
+    let bestScore = -Infinity;
+    let bestFormula = null;
+    for (const c of candidates) {
+        const stats = rs.formulaStats[c.name];
+        const alpha = (stats?.recentTicketsSucceeded ?? 0) + 1;
+        const beta = ((stats?.recentTicketsTotal ?? 0) - (stats?.recentTicketsSucceeded ?? 0)) + 1;
+        const exploitation = alpha / (alpha + beta);
+        const exploration = Math.sqrt(2 * Math.log(Math.max(cycle, 1)) / Math.max(stats?.recentCycles ?? 0, 1));
+        if (exploitation + exploration > bestScore) {
+            bestScore = exploitation + exploration;
+            bestFormula = c.formula;
+        }
+    }
+    if (bestFormula === deepFormula && (ctx.sectorProductionFileCount ?? Infinity) < 25) {
+        return null;
+    }
+    return bestFormula;
+}
+/**
+ * Get allow/block category lists for a given formula and session context.
+ */
+export function getCycleCategories(ctx, formula) {
+    const { sessionPhase, options } = ctx;
+    // Session arc: cooldown → restrict to light categories
+    if (sessionPhase === 'cooldown') {
+        return { allow: ['docs', 'cleanup', 'types'], block: ['deps', 'auth', 'config', 'migration'] };
+    }
+    let allow = formula?.categories
+        ? formula.categories
+        : options.safe
+            ? ['refactor', 'docs', 'types', 'perf']
+            : ['refactor', 'docs', 'types', 'perf', 'security', 'fix', 'cleanup'];
+    // --tests flag explicitly includes test proposals in the focus list
+    if (options.tests && !allow.includes('test')) {
+        allow = [...allow, 'test'];
+    }
+    const block = formula?.categories
+        ? []
+        : options.safe
+            ? ['deps', 'auth', 'config', 'migration', 'security', 'fix', 'cleanup']
+            : ['deps', 'auth', 'config', 'migration'];
+    return { allow, block };
+}
+//# sourceMappingURL=solo-cycle-formula.js.map

package/dist/lib/solo-cycle-formula.js.map

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

package/dist/lib/solo-git.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Solo mode git utilities
+ */
+export declare function withGitMutex<T>(fn: () => Promise<T>): Promise<T>;
+/**
+ * Async git command execution — does not block the event loop.
+ * Used instead of execSync to allow parallel ticket execution.
+ */
+export declare function gitExec(cmd: string, opts: {
+    cwd: string;
+    encoding?: 'utf-8';
+    maxBuffer?: number;
+    stdio?: 'ignore';
+}): Promise<string>;
+/**
+ * Async git command execution using execFile — avoids shell interpolation.
+ * Use this instead of gitExec when arguments contain user-controlled data
+ * (e.g., ticket titles) to prevent shell injection.
+ */
+export declare function gitExecFile(cmd: string, args: string[], opts: {
+    cwd: string;
+}): Promise<string>;
+/**
+ * Clean up worktree directory. Branch is left for merge or later pruning.
+ */
+export declare function cleanupWorktree(repoRoot: string, worktreePath: string): Promise<void>;
+/**
+ * Delete a ticket branch after it has been merged.
+ */
+export declare function deleteTicketBranch(repoRoot: string, branchName: string): Promise<void>;
+/**
+ * Delete a remote branch (non-fatal).
+ */
+export declare function deleteRemoteBranch(repoRoot: string, branchName: string): Promise<void>;
+/**
+ * Check if the direct branch's PR was merged; if so, delete local+remote branch.
+ * Returns true if cleanup was performed.
+ */
+export declare function cleanupMergedDirectBranch(repoRoot: string, branchName: string): Promise<boolean>;
+/**
+ * Create a milestone branch and persistent worktree for batch merging.
+ * Returns the branch name and worktree path.
+ */
+export declare function createMilestoneBranch(repoRoot: string, baseBranch: string): Promise<{
+    milestoneBranch: string;
+    milestoneWorktreePath: string;
+}>;
+/**
+ * Merge a ticket branch into the milestone branch under git mutex.
+ * Returns success/conflict status.
+ */
+export declare function mergeTicketToMilestone(repoRoot: string, ticketBranch: string, milestoneWorktreePath: string): Promise<{
+    success: boolean;
+    conflicted: boolean;
+}>;
+/**
+ * Push milestone branch and create a squash-merge draft PR to the base branch.
+ * Returns the PR URL.
+ */
+export declare function pushAndPrMilestone(repoRoot: string, milestoneBranch: string, milestoneWorktreePath: string, milestoneNumber: number, ticketCount: number, summaries: string[]): Promise<string | undefined>;
+/**
+ * Clean up the milestone worktree (but not the branch, which may have a PR).
+ */
+export declare function cleanupMilestone(repoRoot: string): Promise<void>;
+/**
+ * Fetch review comments from a PR for feedback ingestion.
+ * Non-fatal — returns [] on failure.
+ */
+export declare function fetchPrReviewComments(repoRoot: string, prUrl: string): Promise<Array<{
+    body: string;
+    author: string;
+}>>;
+/** Create/checkout the direct branch, branching from base if needed */
+export declare function ensureDirectBranch(repoRoot: string, branchName: string, baseBranch: string): Promise<void>;
+/** Push the direct branch to remote */
+export declare function pushDirectBranch(repoRoot: string, branchName: string): Promise<void>;
+/** Create a summary PR from the direct branch → base */
+export declare function createDirectSummaryPr(repoRoot: string, branchName: string, baseBranch: string, title: string, body: string, draft: boolean): Promise<string>;
+/** Auto-merge a PR after CI passes (gh pr merge --auto --squash) */
+export declare function autoMergePr(repoRoot: string, prUrl: string): Promise<boolean>;
+export declare function checkPrStatuses(repoRoot: string, prUrls: string[]): Promise<Array<{
+    url: string;
+    state: 'open' | 'merged' | 'closed';
+    mergedAt?: string;
+    branch?: string;
+}>>;
+//# sourceMappingURL=solo-git.d.ts.map

package/dist/lib/solo-git.d.ts.map

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