@mrpatronz/nexusflow 2.9.0 → 2.10.1

package/dist/utils/repo-freshness.js

@@ -0,0 +1,405 @@
+/**
+ * @module utils/repo-freshness
+ * Base repository freshness inspection and safe fast-forward synchronization.
+ *
+ * Helps developers detect when a base repository's default branch (or custom branch)
+ * is behind remote tracking commits before creating a new workspace, and safely
+ * fast-forwards clean repositories without disturbing dirty working trees.
+ */
+import { execa } from 'execa';
+import { detectDefaultBranch } from './git.js';
+/**
+ * Gets the configured or inferred remote tracking branch for a given branch in a repository.
+ * Tries `git rev-parse --abbrev-ref <branch>@{u}` first. If no upstream is configured,
+ * scans available remotes ('origin', 'upstream', etc.) for a matching remote branch ref.
+ */
+export async function resolveTrackingBranch(repoPath, branch) {
+    // 1. Check if git has an explicit upstream tracking branch configured
+    try {
+        const { stdout } = await execa('git', ['rev-parse', '--abbrev-ref', '--symbolic-full-name', `${branch}@{u}`], { cwd: repoPath });
+        const tracking = stdout.trim();
+        if (tracking && !tracking.endsWith('@{u}')) {
+            const slashIndex = tracking.indexOf('/');
+            const remoteName = slashIndex > 0 ? tracking.slice(0, slashIndex) : null;
+            return { trackingBranch: tracking, remoteName, hasRemote: true };
+        }
+    }
+    catch {
+        // No explicit upstream configured
+    }
+    // 2. Discover remotes
+    let remotes = [];
+    try {
+        const { stdout } = await execa('git', ['remote'], { cwd: repoPath });
+        remotes = stdout
+            .split('\n')
+            .map((r) => r.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return { trackingBranch: null, remoteName: null, hasRemote: false };
+    }
+    if (remotes.length === 0) {
+        return { trackingBranch: null, remoteName: null, hasRemote: false };
+    }
+    // Prioritize origin, then upstream, then any other remote
+    const candidateRemotes = [
+        ...remotes.filter((r) => r === 'origin'),
+        ...remotes.filter((r) => r === 'upstream'),
+        ...remotes.filter((r) => r !== 'origin' && r !== 'upstream'),
+    ];
+    for (const remote of candidateRemotes) {
+        try {
+            await execa('git', ['rev-parse', '--verify', `refs/remotes/${remote}/${branch}`], {
+                cwd: repoPath,
+            });
+            return { trackingBranch: `${remote}/${branch}`, remoteName: remote, hasRemote: true };
+        }
+        catch {
+            // Remote branch does not exist on this remote
+        }
+    }
+    return { trackingBranch: null, remoteName: candidateRemotes[0] ?? null, hasRemote: true };
+}
+/**
+ * Checks whether the repository working tree is clean.
+ */
+export async function isRepoClean(repoPath) {
+    try {
+        const { stdout } = await execa('git', ['status', '--porcelain'], { cwd: repoPath });
+        return stdout.trim().length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks the freshness of a branch against its remote tracking branch.
+ */
+export async function checkRepoFreshness(repoPath, targetBranch, options = {}) {
+    const repoName = repoPath.split(/[\/\\]/).filter(Boolean).pop() || 'repo';
+    let defaultBranch = 'main';
+    try {
+        defaultBranch = await detectDefaultBranch(repoPath);
+    }
+    catch {
+        // fallback
+    }
+    const branch = targetBranch || defaultBranch;
+    const isClean = await isRepoClean(repoPath);
+    const { trackingBranch, remoteName, hasRemote } = await resolveTrackingBranch(repoPath, branch);
+    if (!hasRemote) {
+        return {
+            repoPath,
+            repoName,
+            branch,
+            defaultBranch,
+            trackingBranch: null,
+            remoteName: null,
+            hasRemote: false,
+            isClean,
+            ahead: 0,
+            behind: 0,
+            status: 'untracked',
+            message: 'Local repository (no remotes configured)',
+        };
+    }
+    let fetchFailed = false;
+    let fetchErrorMsg;
+    // Run fetch if requested and remote is known
+    if (options.fetch !== false && remoteName) {
+        try {
+            await execa('git', ['fetch', remoteName], {
+                cwd: repoPath,
+                timeout: options.timeoutMs ?? 10000,
+                env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+            });
+        }
+        catch (err) {
+            fetchFailed = true;
+            fetchErrorMsg = err instanceof Error ? err.message : String(err);
+        }
+    }
+    // Re-verify tracking branch in case fetch just populated it
+    let resolvedTracking = trackingBranch;
+    if (!resolvedTracking && remoteName) {
+        try {
+            await execa('git', ['rev-parse', '--verify', `refs/remotes/${remoteName}/${branch}`], {
+                cwd: repoPath,
+            });
+            resolvedTracking = `${remoteName}/${branch}`;
+        }
+        catch {
+            // Still untracked
+        }
+    }
+    if (!resolvedTracking) {
+        return {
+            repoPath,
+            repoName,
+            branch,
+            defaultBranch,
+            trackingBranch: null,
+            remoteName,
+            hasRemote: true,
+            isClean,
+            ahead: 0,
+            behind: 0,
+            status: fetchFailed ? 'offline' : 'untracked',
+            message: fetchFailed
+                ? `Could not reach remote ${remoteName} (offline)`
+                : `Branch "${branch}" has no tracking branch on ${remoteName}`,
+            error: fetchErrorMsg,
+        };
+    }
+    // Calculate ahead / behind counts
+    try {
+        const { stdout } = await execa('git', ['rev-list', '--left-right', '--count', `${branch}...${resolvedTracking}`], { cwd: repoPath });
+        const [aheadRaw, behindRaw] = stdout.trim().split(/\s+/);
+        const ahead = parseInt(aheadRaw ?? '0', 10) || 0;
+        const behind = parseInt(behindRaw ?? '0', 10) || 0;
+        let status;
+        let message;
+        if (ahead === 0 && behind === 0) {
+            status = 'up-to-date';
+            message = `Up to date with ${resolvedTracking}`;
+        }
+        else if (ahead === 0 && behind > 0) {
+            status = 'behind';
+            message = `${behind} commit${behind === 1 ? '' : 's'} behind ${resolvedTracking}`;
+        }
+        else if (ahead > 0 && behind === 0) {
+            status = 'ahead';
+            message = `${ahead} commit${ahead === 1 ? '' : 's'} ahead of ${resolvedTracking}`;
+        }
+        else {
+            status = 'diverged';
+            message = `Diverged (${ahead} ahead, ${behind} behind ${resolvedTracking})`;
+        }
+        if (fetchFailed) {
+            message += ' (offline - using cached refs)';
+        }
+        return {
+            repoPath,
+            repoName,
+            branch,
+            defaultBranch,
+            trackingBranch: resolvedTracking,
+            remoteName,
+            hasRemote: true,
+            isClean,
+            ahead,
+            behind,
+            status,
+            message,
+            error: fetchErrorMsg,
+        };
+    }
+    catch (err) {
+        return {
+            repoPath,
+            repoName,
+            branch,
+            defaultBranch,
+            trackingBranch: resolvedTracking,
+            remoteName,
+            hasRemote: true,
+            isClean,
+            ahead: 0,
+            behind: 0,
+            status: 'error',
+            message: `Failed to compare branch ${branch} with ${resolvedTracking}`,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Safely fast-forwards a repository branch to its remote tracking branch.
+ *
+ * Rules:
+ * 1. If up-to-date, does nothing and reports success.
+ * 2. If diverged, fails cleanly without modifying anything.
+ * 3. If the inspected branch is currently checked out:
+ *    - Fails if the working tree is dirty (protects user's uncommitted work).
+ *    - Runs `git merge --ff-only <trackingBranch>` if clean.
+ * 4. If another branch is checked out:
+ *    - Safely fast-forwards the ref via `git fetch <remote> <remoteBranch>:<branch>`
+ *      or `git update-ref` without touching the active working directory.
+ */
+export async function fastForwardBranch(repoPath, targetBranch, options = {}) {
+    const freshness = await checkRepoFreshness(repoPath, targetBranch, {
+        fetch: true,
+        timeoutMs: options.timeoutMs,
+    });
+    const { repoName, branch, trackingBranch, remoteName, isClean, ahead, behind, status } = freshness;
+    if (status === 'up-to-date') {
+        return {
+            success: true,
+            repoPath,
+            repoName,
+            branch,
+            status: 'up-to-date',
+            message: `Already up to date with ${trackingBranch}`,
+            ahead: 0,
+            behind: 0,
+        };
+    }
+    if (status === 'ahead') {
+        return {
+            success: true,
+            repoPath,
+            repoName,
+            branch,
+            status: 'ahead',
+            message: `Branch "${branch}" is ahead of ${trackingBranch} by ${ahead} commit(s)`,
+            ahead,
+            behind: 0,
+        };
+    }
+    if (status === 'diverged') {
+        return {
+            success: false,
+            repoPath,
+            repoName,
+            branch,
+            status: 'diverged',
+            message: `Cannot fast-forward: branch "${branch}" has diverged from ${trackingBranch} (${ahead} ahead, ${behind} behind). Manual merge or rebase required.`,
+            ahead,
+            behind,
+        };
+    }
+    if (status === 'untracked') {
+        return {
+            success: false,
+            repoPath,
+            repoName,
+            branch,
+            status: 'untracked',
+            message: freshness.message,
+            ahead: 0,
+            behind: 0,
+        };
+    }
+    if (status === 'offline') {
+        return {
+            success: false,
+            repoPath,
+            repoName,
+            branch,
+            status: 'offline',
+            message: freshness.message,
+            ahead: 0,
+            behind: 0,
+            error: freshness.error,
+        };
+    }
+    if (status === 'error' || !trackingBranch) {
+        return {
+            success: false,
+            repoPath,
+            repoName,
+            branch,
+            status: 'error',
+            message: freshness.message,
+            ahead: 0,
+            behind: 0,
+            error: freshness.error,
+        };
+    }
+    // Target branch is behind. Determine currently checked out branch
+    let currentBranch = '';
+    try {
+        const { stdout } = await execa('git', ['branch', '--show-current'], { cwd: repoPath });
+        currentBranch = stdout.trim();
+    }
+    catch {
+        // detached HEAD or error
+    }
+    try {
+        if (currentBranch === branch) {
+            // Currently checked out: require clean working tree
+            if (!isClean) {
+                return {
+                    success: false,
+                    repoPath,
+                    repoName,
+                    branch,
+                    status: 'dirty',
+                    message: `Cannot fast-forward: working tree has uncommitted changes in "${branch}". Stash or commit changes first.`,
+                    ahead,
+                    behind,
+                };
+            }
+            await execa('git', ['merge', '--ff-only', trackingBranch], { cwd: repoPath });
+            return {
+                success: true,
+                repoPath,
+                repoName,
+                branch,
+                status: 'fast-forwarded',
+                message: `Fast-forwarded "${branch}" to ${trackingBranch} (${behind} commit${behind === 1 ? '' : 's'})`,
+                ahead: 0,
+                behind: 0,
+            };
+        }
+        else {
+            // Not checked out: verify ancestor and update ref safely
+            await execa('git', ['merge-base', '--is-ancestor', branch, trackingBranch], { cwd: repoPath });
+            // Fast-forward local ref from remote ref without checkout
+            const rName = remoteName || trackingBranch.split('/')[0];
+            const remoteBranchPart = trackingBranch.slice(rName.length + 1);
+            try {
+                await execa('git', ['fetch', rName, `${remoteBranchPart}:${branch}`], {
+                    cwd: repoPath,
+                    timeout: options.timeoutMs ?? 10000,
+                    env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+                });
+            }
+            catch {
+                // If git fetch refuses or network is offline, update ref directly since ancestry is verified
+                const { stdout: commitSha } = await execa('git', ['rev-parse', trackingBranch], { cwd: repoPath });
+                await execa('git', ['update-ref', `refs/heads/${branch}`, commitSha.trim()], { cwd: repoPath });
+            }
+            return {
+                success: true,
+                repoPath,
+                repoName,
+                branch,
+                status: 'fast-forwarded',
+                message: `Fast-forwarded "${branch}" to ${trackingBranch} (${behind} commit${behind === 1 ? '' : 's'})`,
+                ahead: 0,
+                behind: 0,
+            };
+        }
+    }
+    catch (err) {
+        return {
+            success: false,
+            repoPath,
+            repoName,
+            branch,
+            status: 'error',
+            message: `Failed to fast-forward "${branch}" to ${trackingBranch}: ${err instanceof Error ? err.message : String(err)}`,
+            ahead,
+            behind,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Checks freshness for a batch of repositories.
+ */
+export async function checkReposFreshness(repos, options = {}) {
+    return Promise.all(repos.map((r) => checkRepoFreshness(r.path, r.branch, options)));
+}
+/**
+ * Fast-forwards base branches for a batch of repositories.
+ */
+export async function fastForwardRepos(repos, options = {}) {
+    const results = [];
+    for (const repo of repos) {
+        results.push(await fastForwardBranch(repo.path, repo.branch, options));
+    }
+    return results;
+}
+//# sourceMappingURL=repo-freshness.js.map

package/dist/utils/repo-freshness.js.map

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

package/dist/utils/resolve-workspace.d.ts

@@ -12,7 +12,7 @@
  *
  * @param workspaceArg - Optional explicit workspace path.
  * @returns Absolute workspace path, or `null` when none can be determined.
- * @throws If an explicit `workspaceArg` is given but has no `nexusflow.json`.
+ * @throws If an explicit `workspaceArg` is given but has no manifest.
  */
 export declare function resolveWorkspaceQuiet(workspaceArg?: string): Promise<string | null>;
 /**

package/dist/utils/resolve-workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-workspace.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBzF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB"}
+{"version":3,"file":"resolve-workspace.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBzF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB"}

package/dist/utils/resolve-workspace.js

@@ -10,6 +10,7 @@ import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
 import { loadConfig } from '../core/config.js';
 import { listWorkspaces, loadFeatureConfig } from '../core/workspace.js';
+import { PRIMARY_MANIFEST_FILE, LEGACY_MANIFEST_FILE } from '../core/constants.js';
 /**
  * Resolves a workspace path without any interactive prompts.
  *
@@ -18,17 +19,23 @@ import { listWorkspaces, loadFeatureConfig } from '../core/workspace.js';
  *
  * @param workspaceArg - Optional explicit workspace path.
  * @returns Absolute workspace path, or `null` when none can be determined.
- * @throws If an explicit `workspaceArg` is given but has no `nexusflow.json`.
+ * @throws If an explicit `workspaceArg` is given but has no manifest.
  */
 export async function resolveWorkspaceQuiet(workspaceArg) {
     if (workspaceArg) {
         const absolutePath = path.resolve(workspaceArg);
         try {
-            await fs.access(path.join(absolutePath, 'nexusflow.json'));
+            await fs.access(path.join(absolutePath, PRIMARY_MANIFEST_FILE));
             return absolutePath;
         }
         catch {
-            throw new Error(`Invalid workspace: No nexusflow.json found at ${absolutePath}`);
+            try {
+                await fs.access(path.join(absolutePath, LEGACY_MANIFEST_FILE));
+                return absolutePath;
+            }
+            catch {
+                throw new Error(`Invalid workspace: No ${PRIMARY_MANIFEST_FILE} found at ${absolutePath}`);
+            }
         }
     }
     const cwdFeature = await loadFeatureConfig(process.cwd());

package/dist/utils/resolve-workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-workspace.js","sourceRoot":"","sources":["../../src/utils/resolve-workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,YAAqB;IAC/D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC;YAC3D,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,iDAAiD,YAAY,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,aAAa,CAAC;IAClC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAgC,EAChC,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACxD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAE9D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;QAC5B,OAAO,EAAE,aAAa;QACtB,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,EAAE;YACnE,KAAK,EAAE,EAAE,CAAC,aAAa;SACxB,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"resolve-workspace.js","sourceRoot":"","sources":["../../src/utils/resolve-workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,YAAqB;IAC/D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC;YAChE,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC;gBAC/D,OAAO,YAAY,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,yBAAyB,qBAAqB,aAAa,YAAY,EAAE,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,aAAa,CAAC;IAClC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAgC,EAChC,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACxD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAE9D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;QAC5B,OAAO,EAAE,aAAa;QACtB,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,EAAE;YACnE,KAAK,EAAE,EAAE,CAAC,aAAa;SACxB,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/session-finder.d.ts

@@ -2,7 +2,7 @@
  * @module utils/session-finder
  * Scans local storage directories of various AI coding assistants to find conversation histories.
  */
-import type { AISession, ChatMessage } from '../types.js';
+import type { AIAssistant, AISession, ChatMessage } from '../types.js';
 export declare const SESSION_ID_RE: RegExp;
 /** Returns true if the given value is a canonical UUIDv4-shaped string. */
 export declare function isUuid(id: unknown): id is string;
@@ -72,6 +72,17 @@ export declare function canTransferClaudeSessionInWorkspace(workspacePath: strin
  * @returns A promise that resolves to an array of {@link AISession} objects sorted by update time descending.
  */
 export declare function findSessions(workspacePath: string, repoPaths?: string[]): Promise<AISession[]>;
+/** Clears internal caches used by session detection (primarily for unit tests). */
+export declare function clearSessionFinderCache(): void;
+/**
+ * Quickly checks which AI assistants have active/recorded sessions for a given workspace.
+ * Uses mtime-checked metadata caching and early exit to ensure sub-millisecond execution.
+ *
+ * @param workspacePath - Root directory of the active workspace.
+ * @param repoPaths - Directories of sub-repositories included in the workspace.
+ * @returns A promise that resolves to an array of unique {@link AIAssistant} names.
+ */
+export declare function findActiveAssistants(workspacePath: string, repoPaths?: string[]): Promise<AIAssistant[]>;
 /**
  * Reads and parses the full transcript for a specific assistant conversation session.
  *

package/dist/utils/session-finder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-finder.d.ts","sourceRoot":"","sources":["../../src/utils/session-finder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,eAAO,MAAM,aAAa,QAAoE,CAAC;AAE/F,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAEhD;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO9E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUpE;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAOrD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAGzD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAI7E;AA4CD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,OAAO,CAAC,CAgDlB;AAED;;;;GAIG;AACH,wBAAsB,mCAAmC,CACvD,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,OAAO,CAAC,CA+ClB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAiSxG;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA2KvG"}
+{"version":3,"file":"session-finder.d.ts","sourceRoot":"","sources":["../../src/utils/session-finder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,aAAa,QAAoE,CAAC;AAE/F,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAEhD;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO9E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUpE;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAOrD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAGzD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAI7E;AA4CD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,OAAO,CAAC,CAgDlB;AAED;;;;GAIG;AACH,wBAAsB,mCAAmC,CACvD,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,OAAO,CAAC,CA+ClB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAgTxG;AAgBD,mFAAmF;AACnF,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AA2FD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAM,EAAO,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CA4DxB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA2KvG"}