@mrpatronz/nexusflow 0.1.0

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * @module types
+ * Shared interfaces and types for NexusFlow.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/detect-ai.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module utils/detect-ai
+ * Detects which AI coding assistants are available on the system.
+ */
+import type { DetectedAI } from '../types.js';
+/**
+ * Probes the system for known AI coding assistants and returns their status.
+ *
+ * Detection rules:
+ * - **Claude**: detected if `claude` *or* `antigravity` is on PATH.
+ *   When Antigravity is found it is labelled as `'claude'` because it
+ *   generates `CLAUDE.md` context files.
+ * - **Codex**: detected if `codex` is on PATH.
+ * - **Copilot**: always shown as an option (convention-based via
+ *   `.github/copilot-instructions.md`).
+ * - **Cursor**: detected if `cursor` is on PATH.
+ *
+ * @returns An array of {@link DetectedAI} results, one per assistant.
+ */
+export declare function detectAIAssistants(): Promise<DetectedAI[]>;
+//# sourceMappingURL=detect-ai.d.ts.map

package/dist/utils/detect-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ai.d.ts","sourceRoot":"","sources":["../../src/utils/detect-ai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAgB3D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CA2ChE"}

package/dist/utils/detect-ai.js

@@ -0,0 +1,76 @@
+/**
+ * @module utils/detect-ai
+ * Detects which AI coding assistants are available on the system.
+ */
+import { execa } from 'execa';
+/**
+ * Attempts to run `<command> --version` and returns `true` if the process
+ * exits successfully (exit code 0).
+ */
+async function commandExists(command) {
+    try {
+        const result = await execa(command, ['--version'], { reject: false });
+        return result.exitCode === 0;
+    }
+    catch {
+        // The command could not be spawned at all (not in PATH).
+        return false;
+    }
+}
+/**
+ * Probes the system for known AI coding assistants and returns their status.
+ *
+ * Detection rules:
+ * - **Claude**: detected if `claude` *or* `antigravity` is on PATH.
+ *   When Antigravity is found it is labelled as `'claude'` because it
+ *   generates `CLAUDE.md` context files.
+ * - **Codex**: detected if `codex` is on PATH.
+ * - **Copilot**: always shown as an option (convention-based via
+ *   `.github/copilot-instructions.md`).
+ * - **Cursor**: detected if `cursor` is on PATH.
+ *
+ * @returns An array of {@link DetectedAI} results, one per assistant.
+ */
+export async function detectAIAssistants() {
+    // Run all probes concurrently.
+    const [hasClaude, hasAntigravity, hasCodex, hasCursor] = await Promise.all([
+        commandExists('claude'),
+        commandExists('agy'),
+        commandExists('codex'),
+        commandExists('cursor'),
+    ]);
+    const results = [
+        {
+            name: 'claude',
+            displayName: 'Claude Code',
+            detected: hasClaude,
+            ...(hasClaude ? { command: 'claude' } : {}),
+        },
+        {
+            name: 'antigravity',
+            displayName: 'Antigravity',
+            detected: hasAntigravity,
+            ...(hasAntigravity ? { command: 'agy' } : {}),
+        },
+        {
+            name: 'codex',
+            displayName: 'OpenAI Codex',
+            detected: hasCodex,
+            ...(hasCodex ? { command: 'codex' } : {}),
+        },
+        {
+            name: 'copilot',
+            displayName: 'GitHub Copilot',
+            // Copilot is convention-based; always available as an option.
+            detected: true,
+        },
+        {
+            name: 'cursor',
+            displayName: 'Cursor',
+            detected: hasCursor,
+            ...(hasCursor ? { command: 'cursor' } : {}),
+        },
+    ];
+    return results;
+}
+//# sourceMappingURL=detect-ai.js.map

package/dist/utils/detect-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ai.js","sourceRoot":"","sources":["../../src/utils/detect-ai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAI9B;;;GAGG;AACH,KAAK,UAAU,aAAa,CAAC,OAAe;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,+BAA+B;IAC/B,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzE,aAAa,CAAC,QAAQ,CAAC;QACvB,aAAa,CAAC,KAAK,CAAC;QACpB,aAAa,CAAC,OAAO,CAAC;QACtB,aAAa,CAAC,QAAQ,CAAC;KACxB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAiB;QAC5B;YACE,IAAI,EAAE,QAAuB;YAC7B,WAAW,EAAE,aAAa;YAC1B,QAAQ,EAAE,SAAS;YACnB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C;QACD;YACE,IAAI,EAAE,aAA4B;YAClC,WAAW,EAAE,aAAa;YAC1B,QAAQ,EAAE,cAAc;YACxB,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C;QACD;YACE,IAAI,EAAE,OAAsB;YAC5B,WAAW,EAAE,cAAc;YAC3B,QAAQ,EAAE,QAAQ;YAClB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C;QACD;YACE,IAAI,EAAE,SAAwB;YAC9B,WAAW,EAAE,gBAAgB;YAC7B,8DAA8D;YAC9D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,QAAuB;YAC7B,WAAW,EAAE,QAAQ;YACrB,QAAQ,EAAE,SAAS;YACnB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/detect-editors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module utils/detect-editors
+ * Detects which code editors are available on the system.
+ */
+import type { DetectedEditor } from '../types.js';
+/**
+ * Probes the system for known code editors by checking whether their CLI
+ * commands are available on PATH.
+ *
+ * Currently checks for:
+ * - **VS Code** (`code`)
+ * - **VS Code Insiders** (`code-insiders`)
+ * - **Cursor** (`cursor`)
+ * - **Antigravity** (`antigravity`)
+ *
+ * @returns An array of {@link DetectedEditor} results, one per editor.
+ */
+export declare function detectEditors(): Promise<DetectedEditor[]>;
+//# sourceMappingURL=detect-editors.d.ts.map

package/dist/utils/detect-editors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-editors.d.ts","sourceRoot":"","sources":["../../src/utils/detect-editors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAuBlD;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAW/D"}

package/dist/utils/detect-editors.js

@@ -0,0 +1,49 @@
+/**
+ * @module utils/detect-editors
+ * Detects which code editors are available on the system.
+ */
+import { execa } from 'execa';
+/** Editor definitions we probe for. */
+const EDITOR_CANDIDATES = [
+    { name: 'VS Code', command: 'code' },
+    { name: 'VS Code Insiders', command: 'code-insiders' },
+    { name: 'Cursor', command: 'cursor' },
+    { name: 'Antigravity', command: 'agy' },
+];
+/**
+ * Attempts to run `<command> --version` and returns `true` if the process
+ * exits successfully (exit code 0).
+ */
+async function commandExists(command) {
+    try {
+        const result = await execa(command, ['--version'], { reject: false });
+        return result.exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probes the system for known code editors by checking whether their CLI
+ * commands are available on PATH.
+ *
+ * Currently checks for:
+ * - **VS Code** (`code`)
+ * - **VS Code Insiders** (`code-insiders`)
+ * - **Cursor** (`cursor`)
+ * - **Antigravity** (`antigravity`)
+ *
+ * @returns An array of {@link DetectedEditor} results, one per editor.
+ */
+export async function detectEditors() {
+    const probes = EDITOR_CANDIDATES.map(async (editor) => {
+        const detected = await commandExists(editor.command);
+        return {
+            name: editor.name,
+            command: editor.command,
+            detected,
+        };
+    });
+    return Promise.all(probes);
+}
+//# sourceMappingURL=detect-editors.js.map

package/dist/utils/detect-editors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-editors.js","sourceRoot":"","sources":["../../src/utils/detect-editors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAI9B,uCAAuC;AACvC,MAAM,iBAAiB,GAAqD;IAC1E,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE;IACpC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,EAAE;IACtD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;IACrC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE;CACxC,CAAC;AAEF;;;GAGG;AACH,KAAK,UAAU,aAAa,CAAC,OAAe;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ;SACgB,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/utils/git.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module utils/git
+ * Low-level git helper functions used throughout NexusFlow.
+ */
+/**
+ * Checks whether the given directory is a git repository
+ * by testing for the presence of a `.git` entry.
+ *
+ * @param dirPath - Absolute path to the directory.
+ * @returns `true` if a `.git` file or directory exists.
+ */
+export declare function isGitRepo(dirPath: string): Promise<boolean>;
+/**
+ * Runs `git fetch origin` inside the given repository.
+ *
+ * @param repoPath - Absolute path to the repo root.
+ */
+export declare function gitFetch(repoPath: string): Promise<void>;
+/**
+ * Detects the default branch of a repository by inspecting remote branches.
+ * Prefers `main` over `master`. Falls back to `'main'` when neither is found.
+ *
+ * @param repoPath - Absolute path to the repo root.
+ * @returns The name of the default branch.
+ */
+export declare function detectDefaultBranch(repoPath: string): Promise<string>;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB3E"}

package/dist/utils/git.js

@@ -0,0 +1,57 @@
+/**
+ * @module utils/git
+ * Low-level git helper functions used throughout NexusFlow.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { execa } from 'execa';
+/**
+ * Checks whether the given directory is a git repository
+ * by testing for the presence of a `.git` entry.
+ *
+ * @param dirPath - Absolute path to the directory.
+ * @returns `true` if a `.git` file or directory exists.
+ */
+export async function isGitRepo(dirPath) {
+    try {
+        const gitPath = path.join(dirPath, '.git');
+        await fs.access(gitPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Runs `git fetch origin` inside the given repository.
+ *
+ * @param repoPath - Absolute path to the repo root.
+ */
+export async function gitFetch(repoPath) {
+    await execa('git', ['fetch', 'origin'], { cwd: repoPath });
+}
+/**
+ * Detects the default branch of a repository by inspecting remote branches.
+ * Prefers `main` over `master`. Falls back to `'main'` when neither is found.
+ *
+ * @param repoPath - Absolute path to the repo root.
+ * @returns The name of the default branch.
+ */
+export async function detectDefaultBranch(repoPath) {
+    try {
+        const { stdout } = await execa('git', ['branch', '-r'], { cwd: repoPath });
+        const branches = stdout.split('\n').map((b) => b.trim());
+        if (branches.some((b) => b === 'origin/main' || b.endsWith('/origin/main'))) {
+            return 'main';
+        }
+        if (branches.some((b) => b === 'origin/master' || b.endsWith('/origin/master'))) {
+            return 'master';
+        }
+        // Fallback — assume main.
+        return 'main';
+    }
+    catch {
+        return 'main';
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YAC5E,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,eAAe,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;YAChF,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,0BAA0B;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/utils/prompts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module utils/prompts
+ * Interactive CLI prompts for NexusFlow using @inquirer/prompts.
+ */
+import type { AIAssistant, DetectedAI, DetectedEditor, RepoInfo } from '../types.js';
+/**
+ * Prompts the user for a feature branch name.
+ */
+export declare function promptBranchName(): Promise<string>;
+/**
+ * Prompts the user for a feature description.
+ * Accepts plain text or a path to a file.
+ */
+export declare function promptDescription(): Promise<string>;
+/**
+ * Prompts the user to select repos from a list of discovered repos.
+ */
+export declare function promptSelectRepos(repos: RepoInfo[]): Promise<RepoInfo[]>;
+/**
+ * Prompts the user to select AI assistants to generate context for.
+ */
+export declare function promptSelectAI(detected: DetectedAI[]): Promise<AIAssistant[]>;
+/**
+ * Prompts the user to select an editor to open the workspace in.
+ */
+export declare function promptSelectEditor(detected: DetectedEditor[]): Promise<DetectedEditor | null>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/utils/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErF;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAUxD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CA0BzD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAmB9E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAexB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,cAAc,EAAE,GACzB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA0BhC"}

package/dist/utils/prompts.js

@@ -0,0 +1,119 @@
+/**
+ * @module utils/prompts
+ * Interactive CLI prompts for NexusFlow using @inquirer/prompts.
+ */
+import { input, checkbox, confirm } from '@inquirer/prompts';
+import chalk from 'chalk';
+/**
+ * Prompts the user for a feature branch name.
+ */
+export async function promptBranchName() {
+    const branchName = await input({
+        message: 'Feature branch name:',
+        validate: (value) => {
+            if (!value.trim())
+                return 'Branch name cannot be empty';
+            if (/\s/.test(value))
+                return 'Branch name cannot contain spaces';
+            return true;
+        },
+    });
+    return branchName.trim();
+}
+/**
+ * Prompts the user for a feature description.
+ * Accepts plain text or a path to a file.
+ */
+export async function promptDescription() {
+    const { readFile } = await import('node:fs/promises');
+    const { existsSync } = await import('node:fs');
+    const descInput = await input({
+        message: 'Describe the feature (or paste a path to a .md/.txt file):',
+        validate: (value) => {
+            if (!value.trim())
+                return 'Description cannot be empty';
+            return true;
+        },
+    });
+    const trimmed = descInput.trim();
+    // Check if it's a file path
+    if (existsSync(trimmed)) {
+        try {
+            const content = await readFile(trimmed, 'utf-8');
+            console.log(chalk.dim(`  Read description from ${trimmed}`));
+            return content;
+        }
+        catch {
+            // Fall through to use as plain text
+        }
+    }
+    return trimmed;
+}
+/**
+ * Prompts the user to select repos from a list of discovered repos.
+ */
+export async function promptSelectRepos(repos) {
+    if (repos.length === 0) {
+        return [];
+    }
+    const selected = await checkbox({
+        message: 'Select projects to include:',
+        choices: repos.map((repo) => ({
+            name: `${repo.name} ${chalk.dim(`(${repo.path})`)}`,
+            value: repo.path,
+            checked: false,
+        })),
+        validate: (items) => {
+            if (items.length === 0)
+                return 'Please select at least one project';
+            return true;
+        },
+    });
+    return repos.filter((r) => selected.includes(r.path));
+}
+/**
+ * Prompts the user to select AI assistants to generate context for.
+ */
+export async function promptSelectAI(detected) {
+    const selected = await checkbox({
+        message: 'Select AI assistant(s) to generate context for:',
+        choices: detected.map((ai) => ({
+            name: `${ai.displayName} ${ai.detected ? chalk.green('✓ detected') : chalk.dim('not found')}`,
+            value: ai.name,
+            checked: ai.detected,
+        })),
+        validate: (items) => {
+            if (items.length === 0)
+                return 'Please select at least one AI assistant';
+            return true;
+        },
+    });
+    return selected;
+}
+/**
+ * Prompts the user to select an editor to open the workspace in.
+ */
+export async function promptSelectEditor(detected) {
+    const shouldOpen = await confirm({
+        message: 'Open workspace in an editor?',
+        default: true,
+    });
+    if (!shouldOpen)
+        return null;
+    const available = detected.filter((e) => e.detected);
+    if (available.length === 0) {
+        console.log(chalk.yellow('  No editors detected in PATH.'));
+        return null;
+    }
+    const selected = await checkbox({
+        message: 'Select editor:',
+        choices: available.map((editor) => ({
+            name: editor.name,
+            value: editor.command,
+        })),
+    });
+    if (selected.length === 0)
+        return null;
+    return available.find((e) => e.command === selected[0]) ?? null;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/utils/prompts.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * @module utils/session-finder
+ * Scans local storage directories of various AI coding assistants to find conversation histories.
+ */
+import type { AISession, ChatMessage } from '../types.js';
+/**
+ * Derives the directory name that Claude Code uses inside `~/.claude/projects/`
+ * for a given absolute project directory path.
+ * It replaces special characters /, \, space, -, and _ with a hyphen.
+ */
+export declare function getClaudeProjectFolderName(absolutePath: string): string;
+/**
+ * Scans the local filesystem for conversation histories belonging to Claude, Antigravity,
+ * Codex, and Copilot that relate to the specified workspace.
+ *
+ * @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 {@link AISession} objects sorted by update time descending.
+ */
+export declare function findSessions(workspacePath: string, repoPaths?: string[]): Promise<AISession[]>;
+/**
+ * Reads and parses the full transcript for a specific assistant conversation session.
+ *
+ * @param assistant - The name of the AI assistant ('antigravity', 'claude', 'codex', 'copilot').
+ * @param sessionId - Unique ID of the conversation session.
+ * @returns A promise that resolves to an array of {@link ChatMessage} objects.
+ */
+export declare function getSessionTranscript(assistant: string, sessionId: string): Promise<ChatMessage[]>;
+//# sourceMappingURL=session-finder.d.ts.map

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

@@ -0,0 +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;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAsBD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA4QxG;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA8JvG"}