@mrpatronz/nexusflow 1.3.3 → 1.6.0

package/dist/core/doctor.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @module core/doctor
+ * Headless workspace diagnostics. Produces a structured {@link DoctorReport}
+ * shared by the CLI `doctor` renderer and the MCP `run_doctor` tool. The local
+ * AI connectivity probe uses fetch + AbortController, so this is safe to run
+ * outside a TTY.
+ */
+export type DoctorCheckStatus = 'pass' | 'warn' | 'fail' | 'info';
+/** A single diagnostic result. */
+export interface DoctorCheck {
+    category: string;
+    name: string;
+    status: DoctorCheckStatus;
+    message: string;
+}
+/** Full diagnostic report for a workspace. */
+export interface DoctorReport {
+    workspacePath: string;
+    branchName: string;
+    checks: DoctorCheck[];
+    errors: string[];
+    warnings: string[];
+    healthy: boolean;
+    /** True when worktree-path errors aborted the deeper checks. */
+    aborted: boolean;
+}
+/**
+ * Runs all workspace diagnostics and returns a structured report.
+ *
+ * @param workspacePath - Absolute path to the workspace directory.
+ * @throws If the workspace manifest cannot be loaded.
+ */
+export declare function runDoctor(workspacePath: string): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/core/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/core/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;CAClB;AAWD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA6O5E"}

package/dist/core/doctor.js

@@ -0,0 +1,276 @@
+/**
+ * @module core/doctor
+ * Headless workspace diagnostics. Produces a structured {@link DoctorReport}
+ * shared by the CLI `doctor` renderer and the MCP `run_doctor` tool. The local
+ * AI connectivity probe uses fetch + AbortController, so this is safe to run
+ * outside a TTY.
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { execa } from 'execa';
+import { globby } from 'globby';
+import { loadConfig } from './config.js';
+import { loadFeatureConfig, resolveRepoInfos } from './workspace.js';
+import { getRepoStatus } from '../utils/multi-git.js';
+import { workspaceFileExists, baseFileExists } from './storage.js';
+import { analyzeAllReposCached } from '../analyzers/index.js';
+import { isOllamaModelAvailable, getOpenAiCompatibleUrl } from '../utils/local-ai.js';
+/** Resolves the conventional test command for a repo's tech stack. */
+function getTestCommand(analysis) {
+    if (analysis.techStack.languages.includes('csharp'))
+        return 'dotnet test';
+    if (analysis.techStack.languages.includes('typescript') || analysis.techStack.languages.includes('javascript'))
+        return 'npm test';
+    if (analysis.techStack.languages.includes('python'))
+        return 'pytest';
+    if (analysis.techStack.languages.includes('go'))
+        return 'go test ./...';
+    return 'npm test';
+}
+/**
+ * Runs all workspace diagnostics and returns a structured report.
+ *
+ * @param workspacePath - Absolute path to the workspace directory.
+ * @throws If the workspace manifest cannot be loaded.
+ */
+export async function runDoctor(workspacePath) {
+    const feature = await loadFeatureConfig(workspacePath);
+    if (!feature) {
+        throw new Error('Failed to load workspace configuration. Ensure nexusflow.json exists.');
+    }
+    const allRepos = await resolveRepoInfos(feature.repos);
+    const checks = [];
+    const warnings = [];
+    const errors = [];
+    const report = () => ({
+        workspacePath,
+        branchName: feature.branchName,
+        checks,
+        errors,
+        warnings,
+        healthy: errors.length === 0 && warnings.length === 0,
+        aborted: false,
+    });
+    // ── 1. Worktree Paths ──────────────────────────────────────────────────
+    let worktreeErrors = false;
+    for (const repo of allRepos) {
+        try {
+            const stat = await fs.stat(repo.path);
+            if (!stat.isDirectory()) {
+                errors.push(`Worktree path for "${repo.name}" is not a directory.`);
+                checks.push({ category: 'Worktree Paths', name: repo.name, status: 'fail', message: 'Path is not a directory' });
+                worktreeErrors = true;
+            }
+            else {
+                checks.push({ category: 'Worktree Paths', name: repo.name, status: 'pass', message: 'Directory exists' });
+            }
+        }
+        catch {
+            errors.push(`Worktree path for "${repo.name}" does not exist: ${repo.path}`);
+            checks.push({ category: 'Worktree Paths', name: repo.name, status: 'fail', message: 'Path does not exist' });
+            worktreeErrors = true;
+        }
+    }
+    if (worktreeErrors) {
+        return { ...report(), aborted: true };
+    }
+    // ── 2. Analysis (feeds later checks) ───────────────────────────────────
+    const { analysis } = await analyzeAllReposCached(allRepos, workspacePath);
+    // ── 3. Branch Alignment & Git Status ───────────────────────────────────
+    for (const repo of allRepos) {
+        let branch = 'unknown';
+        try {
+            const { stdout } = await execa('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: repo.path });
+            branch = stdout.trim();
+        }
+        catch {
+            // Detached HEAD or git failure — leave as 'unknown'.
+        }
+        if (branch !== feature.branchName) {
+            warnings.push(`Repository "${repo.name}" is checked out on branch "${branch}", but workspace branch is "${feature.branchName}".`);
+            checks.push({ category: 'Branch Alignment & Git Status', name: repo.name, status: 'warn', message: `Branch mismatch (${branch} vs expected ${feature.branchName})` });
+        }
+        else {
+            checks.push({ category: 'Branch Alignment & Git Status', name: repo.name, status: 'pass', message: `Aligned on branch "${branch}"` });
+        }
+        const status = await getRepoStatus(repo.path);
+        if (status.hasChanges) {
+            warnings.push(`Repository "${repo.name}" has uncommitted changes.`);
+            checks.push({ category: 'Branch Alignment & Git Status', name: repo.name, status: 'warn', message: `Has uncommitted changes (${status.summary})` });
+        }
+    }
+    // ── 4. Local Package Setup & Reference Versioning ──────────────────────
+    let hasCsharp = false;
+    let hasNode = false;
+    for (const repo of allRepos) {
+        const a = analysis.get(repo.path);
+        if (!a)
+            continue;
+        if (a.techStack.languages.includes('csharp'))
+            hasCsharp = true;
+        if (a.techStack.languages.includes('typescript') || a.techStack.languages.includes('javascript'))
+            hasNode = true;
+        if (a.techStack.languages.includes('csharp')) {
+            try {
+                const csprojs = await globby('**/*.csproj', {
+                    cwd: repo.path,
+                    absolute: true,
+                    ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
+                });
+                for (const csproj of csprojs) {
+                    const content = await fs.readFile(csproj, 'utf-8');
+                    if (content.toLowerCase().includes('-local') || content.toLowerCase().includes('-dev')) {
+                        warnings.push(`Temporary package version (e.g. ending in "-local" or "-dev") found in "${path.basename(csproj)}".`);
+                        checks.push({ category: 'Local Package Setup', name: repo.name, status: 'warn', message: `Temporary local package version in "${path.basename(csproj)}"` });
+                    }
+                }
+            }
+            catch { }
+            if (a.nugetFeeds && a.nugetFeeds.length === 0) {
+                try {
+                    const nugetConfigs = await globby('**/NuGet.config', {
+                        cwd: repo.path,
+                        ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
+                    });
+                    if (nugetConfigs.length === 0) {
+                        warnings.push(`Repository "${repo.name}" does not have a NuGet.config. It might not resolve local package dependencies.`);
+                        checks.push({ category: 'Local Package Setup', name: repo.name, status: 'warn', message: 'No NuGet.config found (needed for local package feeds)' });
+                    }
+                }
+                catch { }
+            }
+        }
+        if (a.techStack.languages.includes('typescript') || a.techStack.languages.includes('javascript')) {
+            try {
+                const pjs = await globby('**/package.json', {
+                    cwd: repo.path,
+                    absolute: true,
+                    ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
+                });
+                for (const pj of pjs) {
+                    const content = await fs.readFile(pj, 'utf-8');
+                    if (content.includes('"file:') || content.includes('"link:')) {
+                        warnings.push(`Temporary package link/file reference (e.g., "file:../") found in "${path.basename(pj)}".`);
+                        checks.push({ category: 'Local Package Setup', name: repo.name, status: 'warn', message: `Temporary local dependency reference ("file:" or "link:") in "${path.basename(pj)}"` });
+                    }
+                }
+            }
+            catch { }
+        }
+    }
+    if (hasCsharp || hasNode) {
+        checks.push({ category: 'Local Package Setup', name: 'validation', status: 'pass', message: 'Local registry feeds/link validation completed.' });
+    }
+    else {
+        checks.push({ category: 'Local Package Setup', name: 'validation', status: 'info', message: 'No C# or Node.js repositories to validate.' });
+    }
+    // ── 5. Test Commands ───────────────────────────────────────────────────
+    for (const repo of allRepos) {
+        const a = analysis.get(repo.path);
+        if (!a)
+            continue;
+        const testCommand = getTestCommand(a);
+        if (testCommand === 'npm test' && !a.techStack.languages.includes('typescript') && !a.techStack.languages.includes('javascript')) {
+            warnings.push(`Repository "${repo.name}" fell back to default test command "npm test".`);
+            checks.push({ category: 'Test Commands', name: repo.name, status: 'warn', message: 'Using default fallback test command "npm test"' });
+        }
+        else {
+            checks.push({ category: 'Test Commands', name: repo.name, status: 'pass', message: `Test command is "${testCommand}"` });
+        }
+    }
+    // ── 6. Core Artifacts ──────────────────────────────────────────────────
+    const featureId = path.basename(workspacePath);
+    const coreFiles = [
+        { name: 'WORKSPACE.md', exists: () => workspaceFileExists(workspacePath, featureId, 'WORKSPACE.md') },
+        { name: 'nexusflow-knowledge.md', exists: () => workspaceFileExists(workspacePath, featureId, 'nexusflow-knowledge.md') },
+        { name: 'nexusflow-plan.md', exists: () => workspaceFileExists(workspacePath, featureId, 'nexusflow-plan.md') },
+    ];
+    for (const repo of allRepos) {
+        const name = `nexusflow-map-${repo.name}.md`;
+        coreFiles.push({ name, exists: () => baseFileExists(workspacePath, repo.name, name) });
+    }
+    for (const file of coreFiles) {
+        if (await file.exists()) {
+            checks.push({ category: 'Core Artifacts', name: file.name, status: 'pass', message: 'exists' });
+        }
+        else {
+            warnings.push(`Missing core workspace artifact: "${file.name}".`);
+            checks.push({ category: 'Core Artifacts', name: file.name, status: 'warn', message: 'is missing' });
+        }
+    }
+    const workspaceName = path.basename(workspacePath);
+    const codeWorkspacePath = path.join(workspacePath, `${workspaceName}.code-workspace`);
+    try {
+        await fs.access(codeWorkspacePath);
+        checks.push({ category: 'Core Artifacts', name: `${workspaceName}.code-workspace`, status: 'pass', message: 'exists' });
+    }
+    catch {
+        warnings.push(`Missing ${workspaceName}.code-workspace. VS Code SCM will not show changes inside repo sub-folders. Run \`nexusflow refresh\` to regenerate it.`);
+        checks.push({ category: 'Core Artifacts', name: `${workspaceName}.code-workspace`, status: 'warn', message: 'is missing' });
+    }
+    const vscodeSettingsPath = path.join(workspacePath, '.vscode', 'settings.json');
+    try {
+        const content = await fs.readFile(vscodeSettingsPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (parsed['search.useIgnoreFiles'] === false) {
+            checks.push({ category: 'Core Artifacts', name: '.vscode/settings.json', status: 'pass', message: 'configured correctly (search.useIgnoreFiles: false)' });
+        }
+        else {
+            warnings.push('.vscode/settings.json search.useIgnoreFiles is not set to false. VS Code global search may ignore repository files.');
+            checks.push({ category: 'Core Artifacts', name: '.vscode/settings.json', status: 'warn', message: 'search.useIgnoreFiles is not set to false' });
+        }
+    }
+    catch {
+        warnings.push('Missing .vscode/settings.json. VS Code search might not work properly inside sub-repos.');
+        checks.push({ category: 'Core Artifacts', name: '.vscode/settings.json', status: 'warn', message: 'is missing or invalid' });
+    }
+    // ── 7. Local AI Agent Connection ───────────────────────────────────────
+    const config = await loadConfig();
+    if (config.localLlm?.enabled) {
+        const { provider, endpoint, model } = config.localLlm;
+        try {
+            const cleanEndpoint = endpoint.replace(/\/$/, '');
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            try {
+                if (provider === 'ollama') {
+                    const res = await fetch(`${cleanEndpoint}/api/tags`, { signal: controller.signal });
+                    if (!res.ok)
+                        throw new Error(`Ollama responded with status ${res.status}`);
+                    const data = await res.json();
+                    const models = data?.models || [];
+                    if (isOllamaModelAvailable(models, model)) {
+                        checks.push({ category: 'Local AI Agent', name: provider, status: 'pass', message: `Ollama active and model "${model}" is ready` });
+                    }
+                    else {
+                        const availableList = models.map((m) => m.name).join(', ') || 'none';
+                        warnings.push(`Local model "${model}" is not pulled in Ollama. Available: [${availableList}]. Run "ollama pull ${model}" to install it.`);
+                        checks.push({ category: 'Local AI Agent', name: provider, status: 'warn', message: `Ollama active, but model "${model}" is not pulled` });
+                    }
+                }
+                else {
+                    const testUrl = getOpenAiCompatibleUrl(cleanEndpoint, '/v1/models');
+                    const res = await fetch(testUrl, { signal: controller.signal });
+                    if (!res.ok)
+                        throw new Error(`OpenAI-compatible server responded with status ${res.status}`);
+                    checks.push({ category: 'Local AI Agent', name: provider, status: 'pass', message: `OpenAI-compatible server at "${endpoint}" is active` });
+                }
+            }
+            catch (e) {
+                throw new Error(e.name === 'AbortError' ? 'Request timed out after 5 seconds' : e.message);
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch (e) {
+            warnings.push(`Local LLM server at "${endpoint}" is offline or unreachable: ${e.message}`);
+            checks.push({ category: 'Local AI Agent', name: 'connection', status: 'warn', message: `Local LLM server is offline or unreachable (${e.message})` });
+        }
+    }
+    else {
+        checks.push({ category: 'Local AI Agent', name: 'status', status: 'info', message: 'Local AI agent is disabled in config.' });
+    }
+    return report();
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/doctor.js.map

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

package/dist/core/finish.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @module core/finish
+ * Headless "finish a feature" engine shared by the CLI `finish` command and the
+ * MCP `finish_workspace` tool. Commits remaining changes, pushes branches, and
+ * surfaces a way to open a PR for each repo (via `gh` when available, otherwise
+ * a compare URL). It never promotes knowledge or deletes anything — those are
+ * interactive concerns owned by the command.
+ */
+import { type WorkspaceStatusReport } from './status.js';
+/** Options for {@link finishWorkspace}. */
+export interface FinishOptions {
+    /** Commit message for any remaining dirty changes. */
+    message?: string;
+    /** Do not push after committing. */
+    skipPush?: boolean;
+    /** Attempt `gh pr create` when the GitHub CLI is installed and authenticated. */
+    createPrs?: boolean;
+    prTitle?: string;
+    prBody?: string;
+}
+/** Per-repo finish outcome. */
+export interface RepoFinishReport {
+    name: string;
+    committed: boolean;
+    commitHash?: string;
+    pushed: boolean;
+    /** PR URL created via `gh`, when available. */
+    prUrl?: string;
+    /** Compare/create-PR URL to open in a browser (fallback and default path). */
+    compareUrl?: string;
+    /** Set when the repo was intentionally skipped (wrong branch, no remote, …). */
+    skipped?: string;
+    /** Set when an operation failed for this repo. */
+    error?: string;
+}
+/** Aggregate finish report. */
+export interface FinishReport {
+    workspacePath: string;
+    branchName: string;
+    preflight: WorkspaceStatusReport;
+    repos: RepoFinishReport[];
+    /** True when `gh` was used to create PRs. */
+    ghUsed: boolean;
+    /** True when, after finishing, every repo is clean and pushed. */
+    safeToCleanup: boolean;
+}
+/**
+ * Runs the finish sequence: preflight → commit dirty repos → push → PR links →
+ * recheck. Repos on the wrong branch or in a detached-HEAD state are skipped
+ * (never committed) so a stray checkout can't push to the wrong branch.
+ *
+ * @param workspacePath - Absolute path to the workspace directory.
+ * @param options       - Finish options.
+ */
+export declare function finishWorkspace(workspacePath: string, options?: FinishOptions): Promise<FinishReport>;
+//# sourceMappingURL=finish.d.ts.map

package/dist/core/finish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../src/core/finish.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA4B,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKnF,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAmGvB"}

package/dist/core/finish.js

@@ -0,0 +1,121 @@
+/**
+ * @module core/finish
+ * Headless "finish a feature" engine shared by the CLI `finish` command and the
+ * MCP `finish_workspace` tool. Commits remaining changes, pushes branches, and
+ * surfaces a way to open a PR for each repo (via `gh` when available, otherwise
+ * a compare URL). It never promotes knowledge or deletes anything — those are
+ * interactive concerns owned by the command.
+ */
+import { getWorkspaceStatusReport } from './status.js';
+import { commitWorkspace } from './commit.js';
+import { pushRepo } from '../utils/multi-git.js';
+import { detectGh, createPrWithGh, parseRemoteUrl, buildCompareUrl } from '../utils/pr.js';
+/**
+ * Runs the finish sequence: preflight → commit dirty repos → push → PR links →
+ * recheck. Repos on the wrong branch or in a detached-HEAD state are skipped
+ * (never committed) so a stray checkout can't push to the wrong branch.
+ *
+ * @param workspacePath - Absolute path to the workspace directory.
+ * @param options       - Finish options.
+ */
+export async function finishWorkspace(workspacePath, options = {}) {
+    const preflight = await getWorkspaceStatusReport(workspacePath);
+    const reports = new Map();
+    for (const repo of preflight.repos) {
+        reports.set(repo.name, { name: repo.name, committed: false, pushed: false });
+    }
+    // Repos we are allowed to act on: on the expected branch, not detached.
+    const actionable = preflight.repos.filter((r) => r.onExpectedBranch && r.branch);
+    for (const repo of preflight.repos) {
+        if (!r_isActionable(repo.name, actionable)) {
+            const rep = reports.get(repo.name);
+            rep.skipped = repo.branch
+                ? `on branch "${repo.branch}", not the feature branch "${repo.expectedBranch}"`
+                : 'detached HEAD';
+        }
+    }
+    // ── Commit dirty, actionable repos ──────────────────────────────────────
+    const dirtyActionable = actionable.filter((r) => r.dirty);
+    if (dirtyActionable.length > 0) {
+        if (!options.message || !options.message.trim()) {
+            for (const r of dirtyActionable) {
+                reports.get(r.name).error = 'uncommitted changes and no commit message provided';
+            }
+        }
+        else {
+            const commitReport = await commitWorkspace(workspacePath, options.message, {
+                noPush: true, // push is handled uniformly below
+                repos: dirtyActionable.map((r) => r.name),
+            });
+            for (const c of commitReport.repos) {
+                const rep = reports.get(c.name);
+                rep.committed = c.success;
+                rep.commitHash = c.commitHash || undefined;
+                if (!c.success)
+                    rep.error = c.message;
+            }
+        }
+    }
+    // ── Push actionable repos with a remote ─────────────────────────────────
+    for (const repo of actionable) {
+        const rep = reports.get(repo.name);
+        if (rep.error)
+            continue;
+        if (!repo.remoteUrl) {
+            rep.skipped = rep.skipped ?? 'no remote configured';
+            continue;
+        }
+        if (options.skipPush)
+            continue;
+        // Push when we committed, when the branch is ahead, or when it was never pushed.
+        const needsPush = rep.committed || repo.ahead === null || (repo.ahead ?? 0) > 0;
+        if (needsPush) {
+            const result = await pushRepo(repo.path, repo.expectedBranch);
+            rep.pushed = result.success;
+            if (!result.success)
+                rep.error = result.message;
+        }
+    }
+    // ── PR links ────────────────────────────────────────────────────────────
+    const gh = options.createPrs ? await detectGh() : { installed: false, authenticated: false };
+    const ghUsed = Boolean(options.createPrs && gh.installed && gh.authenticated);
+    for (const repo of actionable) {
+        const rep = reports.get(repo.name);
+        if (!repo.remoteUrl || rep.error)
+            continue;
+        const remote = parseRemoteUrl(repo.remoteUrl);
+        if (remote) {
+            rep.compareUrl = buildCompareUrl(remote, repo.defaultBranch, repo.expectedBranch) ?? undefined;
+        }
+        if (ghUsed && rep.pushed) {
+            const title = options.prTitle?.trim() || repo.expectedBranch;
+            const body = options.prBody ?? '';
+            const pr = await createPrWithGh(repo.path, {
+                base: repo.defaultBranch,
+                head: repo.expectedBranch,
+                title,
+                body,
+            });
+            if (pr.url) {
+                rep.prUrl = pr.url;
+            }
+            // On gh failure we silently keep compareUrl (already populated above).
+        }
+    }
+    // ── Recheck to decide whether cleanup is safe ───────────────────────────
+    const after = await getWorkspaceStatusReport(workspacePath);
+    const safeToCleanup = after.allClean && after.allPushed;
+    return {
+        workspacePath,
+        branchName: preflight.branchName,
+        preflight,
+        repos: preflight.repos.map((r) => reports.get(r.name)),
+        ghUsed,
+        safeToCleanup,
+    };
+}
+/** Whether a repo name is in the actionable set. */
+function r_isActionable(name, actionable) {
+    return actionable.some((r) => r.name === name);
+}
+//# sourceMappingURL=finish.js.map

package/dist/core/finish.js.map

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

package/dist/core/finish.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=finish.test.d.ts.map

package/dist/core/finish.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.test.d.ts","sourceRoot":"","sources":["../../src/core/finish.test.ts"],"names":[],"mappings":""}