@mrpatronz/nexusflow 1.3.2 → 1.5.0

package/dist/utils/pr.js

@@ -0,0 +1,144 @@
+/**
+ * @module utils/pr
+ * Pull-request helpers: detect the GitHub CLI, parse a git remote URL into its
+ * host/owner/repo, and construct a "create PR / MR" compare URL for the common
+ * forges. Pure functions (`parseRemoteUrl`, `buildCompareUrl`) are unit-tested;
+ * `detectGh`/`createPrWithGh` shell out to `gh`.
+ */
+import { execa } from 'execa';
+/** Determines the forge kind from a hostname. */
+function forgeKind(host) {
+    const h = host.toLowerCase();
+    if (h.includes('github'))
+        return 'github';
+    if (h.includes('gitlab'))
+        return 'gitlab';
+    if (h.includes('dev.azure.com') || h.includes('visualstudio.com') || h.includes('azure'))
+        return 'azure';
+    if (h.includes('bitbucket'))
+        return 'bitbucket';
+    return 'unknown';
+}
+function stripGitSuffix(s) {
+    return s.replace(/\.git$/, '');
+}
+/**
+ * Parses a git remote URL (https, ssh://, scp-style `git@host:path`, and Azure
+ * DevOps variants) into structured parts, or `null` when it cannot be parsed.
+ */
+export function parseRemoteUrl(url) {
+    if (!url)
+        return null;
+    const raw = url.trim();
+    // Azure DevOps SSH: git@ssh.dev.azure.com:v3/{org}/{project}/{repo}
+    //              or:  {org}@vs-ssh.visualstudio.com:v3/{org}/{project}/{repo}
+    const azureSsh = raw.match(/@(?:ssh\.dev\.azure\.com|[^:@]*vs-ssh\.visualstudio\.com):v3\/([^/]+)\/([^/]+)\/([^/]+)/i);
+    if (azureSsh) {
+        return {
+            host: 'dev.azure.com',
+            owner: azureSsh[1],
+            project: azureSsh[2],
+            repo: stripGitSuffix(azureSsh[3]),
+            kind: 'azure',
+        };
+    }
+    // Normalize into a URL we can parse with the WHATWG URL class.
+    let normalized = raw;
+    const scp = raw.match(/^([^@]+)@([^:]+):(.+)$/); // git@host:owner/repo(.git)
+    if (scp && !raw.includes('://')) {
+        normalized = `ssh://${scp[1]}@${scp[2]}/${scp[3]}`;
+    }
+    let parsed;
+    try {
+        parsed = new URL(normalized);
+    }
+    catch {
+        return null;
+    }
+    const host = parsed.hostname;
+    const kind = forgeKind(host);
+    const segments = parsed.pathname.split('/').filter(Boolean).map((s) => decodeURIComponent(s));
+    if (segments.length < 2)
+        return null;
+    // Azure HTTPS: /{org}/{project}/_git/{repo}  (org may be a leading path segment)
+    const gitIdx = segments.indexOf('_git');
+    if (kind === 'azure' && gitIdx >= 1) {
+        const repo = segments[gitIdx + 1];
+        const project = segments[gitIdx - 1];
+        // The org is whatever precedes the project (Azure hosts it at /{org}/...).
+        const org = segments.slice(0, gitIdx - 1).join('/') || project;
+        if (repo) {
+            return { host: 'dev.azure.com', owner: org, project, repo: stripGitSuffix(repo), kind: 'azure' };
+        }
+    }
+    // Generic: owner(/subgroups)/repo — repo is the last segment.
+    const repo = stripGitSuffix(segments[segments.length - 1]);
+    const owner = segments.slice(0, segments.length - 1).join('/');
+    if (!owner || !repo)
+        return null;
+    return { host, owner, repo, kind };
+}
+/**
+ * Builds a "create a PR/MR" URL for a base←head comparison, or `null` for an
+ * unknown forge (the caller should then print the remote URL + branch instead).
+ */
+export function buildCompareUrl(remote, baseBranch, headBranch) {
+    const enc = encodeURIComponent;
+    switch (remote.kind) {
+        case 'github':
+            // GitHub accepts raw slashes in the compare segment (feature/x is fine).
+            return `https://${remote.host}/${remote.owner}/${remote.repo}/compare/${baseBranch}...${headBranch}?expand=1`;
+        case 'gitlab':
+            return (`https://${remote.host}/${remote.owner}/${remote.repo}/-/merge_requests/new` +
+                `?merge_request%5Bsource_branch%5D=${enc(headBranch)}` +
+                `&merge_request%5Btarget_branch%5D=${enc(baseBranch)}`);
+        case 'azure':
+            return (`https://dev.azure.com/${remote.owner}/${remote.project ?? ''}/_git/${remote.repo}/pullrequestcreate` +
+                `?sourceRef=${enc(headBranch)}&targetRef=${enc(baseBranch)}`);
+        case 'bitbucket':
+            return `https://${remote.host}/${remote.owner}/${remote.repo}/pull-requests/new?source=${enc(headBranch)}&dest=${enc(baseBranch)}`;
+        default:
+            return null;
+    }
+}
+/** Detects whether the GitHub CLI is installed and authenticated. */
+export async function detectGh() {
+    let installed = false;
+    try {
+        const v = await execa('gh', ['--version'], { reject: false });
+        installed = v.exitCode === 0;
+    }
+    catch {
+        installed = false;
+    }
+    if (!installed)
+        return { installed: false, authenticated: false };
+    let authenticated = false;
+    try {
+        const a = await execa('gh', ['auth', 'status'], { reject: false });
+        authenticated = a.exitCode === 0;
+    }
+    catch {
+        authenticated = false;
+    }
+    return { installed, authenticated };
+}
+/**
+ * Creates a PR with the GitHub CLI. Never throws — returns `{ url }` on success
+ * or `{ url: null, error }` so the caller can fall back to a compare URL.
+ */
+export async function createPrWithGh(repoPath, opts) {
+    try {
+        const result = await execa('gh', ['pr', 'create', '--base', opts.base, '--head', opts.head, '--title', opts.title, '--body', opts.body], { cwd: repoPath, reject: false });
+        if (result.exitCode === 0) {
+            const lines = result.stdout.split('\n').map((l) => l.trim()).filter(Boolean);
+            const url = lines.reverse().find((l) => l.startsWith('http')) ?? null;
+            return { url };
+        }
+        return { url: null, error: (result.stderr || result.stdout || 'gh pr create failed').split('\n')[0] };
+    }
+    catch (error) {
+        return { url: null, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+//# sourceMappingURL=pr.js.map

package/dist/utils/pr.js.map

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

package/dist/utils/pr.test.d.ts

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

package/dist/utils/pr.test.d.ts.map

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

package/dist/utils/pr.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect } from 'vitest';
+import { parseRemoteUrl, buildCompareUrl } from './pr.js';
+describe('parseRemoteUrl', () => {
+    const cases = [
+        ['https://github.com/owner/repo.git', { host: 'github.com', owner: 'owner', repo: 'repo', kind: 'github' }],
+        ['https://github.com/owner/repo', { host: 'github.com', owner: 'owner', repo: 'repo', kind: 'github' }],
+        ['git@github.com:owner/repo.git', { host: 'github.com', owner: 'owner', repo: 'repo', kind: 'github' }],
+        ['ssh://git@github.com/owner/repo.git', { host: 'github.com', owner: 'owner', repo: 'repo', kind: 'github' }],
+        ['https://gitlab.com/group/subgroup/repo.git', { host: 'gitlab.com', owner: 'group/subgroup', repo: 'repo', kind: 'gitlab' }],
+        ['git@bitbucket.org:team/repo.git', { host: 'bitbucket.org', owner: 'team', repo: 'repo', kind: 'bitbucket' }],
+        ['https://dev.azure.com/myorg/myproject/_git/myrepo', { host: 'dev.azure.com', owner: 'myorg', project: 'myproject', repo: 'myrepo', kind: 'azure' }],
+        ['git@ssh.dev.azure.com:v3/myorg/myproject/myrepo', { host: 'dev.azure.com', owner: 'myorg', project: 'myproject', repo: 'myrepo', kind: 'azure' }],
+    ];
+    it.each(cases)('parses %s', (url, expected) => {
+        expect(parseRemoteUrl(url)).toMatchObject(expected);
+    });
+    it('returns null for junk', () => {
+        expect(parseRemoteUrl('not a url')).toBeNull();
+        expect(parseRemoteUrl('')).toBeNull();
+    });
+    it('classifies an unknown self-hosted host', () => {
+        const r = parseRemoteUrl('https://git.internal.corp/team/repo.git');
+        expect(r).toMatchObject({ host: 'git.internal.corp', owner: 'team', repo: 'repo', kind: 'unknown' });
+    });
+});
+describe('buildCompareUrl', () => {
+    it('builds a GitHub compare URL preserving slashes in branch names', () => {
+        const r = parseRemoteUrl('https://github.com/owner/repo.git');
+        expect(buildCompareUrl(r, 'main', 'feature/x')).toBe('https://github.com/owner/repo/compare/main...feature/x?expand=1');
+    });
+    it('builds a GitLab MR URL with encoded branch params', () => {
+        const r = parseRemoteUrl('https://gitlab.com/group/sub/repo.git');
+        const url = buildCompareUrl(r, 'main', 'feature/x');
+        expect(url).toContain('/group/sub/repo/-/merge_requests/new');
+        expect(url).toContain('source_branch%5D=feature%2Fx');
+        expect(url).toContain('target_branch%5D=main');
+    });
+    it('builds an Azure DevOps PR-create URL', () => {
+        const r = parseRemoteUrl('https://dev.azure.com/myorg/myproject/_git/myrepo');
+        expect(buildCompareUrl(r, 'main', 'feature/x')).toBe('https://dev.azure.com/myorg/myproject/_git/myrepo/pullrequestcreate?sourceRef=feature%2Fx&targetRef=main');
+    });
+    it('returns null for an unknown forge', () => {
+        const r = parseRemoteUrl('https://git.internal.corp/team/repo.git');
+        expect(buildCompareUrl(r, 'main', 'feature/x')).toBeNull();
+    });
+});
+//# sourceMappingURL=pr.test.js.map

package/dist/utils/pr.test.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * @module utils/resolve-workspace
+ * Shared workspace-path resolution used by commands. Replaces the near-identical
+ * private `resolveWorkspace` helpers previously copied across commit/diff/finish
+ * and other commands.
+ */
+/**
+ * Resolves a workspace path without any interactive prompts.
+ *
+ * Resolution order: explicit argument → workspace detected from the current
+ * working directory → `null`.
+ *
+ * @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`.
+ */
+export declare function resolveWorkspaceQuiet(workspaceArg?: string): Promise<string | null>;
+/**
+ * Resolves a workspace path, falling back to an interactive picker when it
+ * cannot be determined from the argument or the current directory.
+ *
+ * Prints friendly errors (and returns `null`) rather than throwing, so callers
+ * can simply `return` when the result is `null`.
+ *
+ * @param workspaceArg - Optional explicit workspace path.
+ * @param promptMessage - Prompt shown when picking from the workspace list.
+ * @returns Absolute workspace path, or `null` when unavailable/none selected.
+ */
+export declare function resolveWorkspaceInteractive(workspaceArg: string | undefined, promptMessage: string): Promise<string | null>;
+//# sourceMappingURL=resolve-workspace.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/resolve-workspace.js

@@ -0,0 +1,77 @@
+/**
+ * @module utils/resolve-workspace
+ * Shared workspace-path resolution used by commands. Replaces the near-identical
+ * private `resolveWorkspace` helpers previously copied across commit/diff/finish
+ * and other commands.
+ */
+import chalk from 'chalk';
+import { select } from '@inquirer/prompts';
+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';
+/**
+ * Resolves a workspace path without any interactive prompts.
+ *
+ * Resolution order: explicit argument → workspace detected from the current
+ * working directory → `null`.
+ *
+ * @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`.
+ */
+export async function resolveWorkspaceQuiet(workspaceArg) {
+    if (workspaceArg) {
+        const absolutePath = path.resolve(workspaceArg);
+        try {
+            await fs.access(path.join(absolutePath, 'nexusflow.json'));
+            return absolutePath;
+        }
+        catch {
+            throw new Error(`Invalid workspace: No nexusflow.json found at ${absolutePath}`);
+        }
+    }
+    const cwdFeature = await loadFeatureConfig(process.cwd());
+    if (cwdFeature) {
+        return cwdFeature.workspacePath;
+    }
+    return null;
+}
+/**
+ * Resolves a workspace path, falling back to an interactive picker when it
+ * cannot be determined from the argument or the current directory.
+ *
+ * Prints friendly errors (and returns `null`) rather than throwing, so callers
+ * can simply `return` when the result is `null`.
+ *
+ * @param workspaceArg - Optional explicit workspace path.
+ * @param promptMessage - Prompt shown when picking from the workspace list.
+ * @returns Absolute workspace path, or `null` when unavailable/none selected.
+ */
+export async function resolveWorkspaceInteractive(workspaceArg, promptMessage) {
+    try {
+        const quiet = await resolveWorkspaceQuiet(workspaceArg);
+        if (quiet) {
+            return quiet;
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`✖ ${error instanceof Error ? error.message : String(error)}`));
+        return null;
+    }
+    const config = await loadConfig();
+    const workspaces = await listWorkspaces(config.workspacesDir);
+    if (workspaces.length === 0) {
+        console.log(chalk.yellow('No workspaces found.\n'));
+        return null;
+    }
+    const selected = await select({
+        message: promptMessage,
+        choices: workspaces.map((ws) => ({
+            name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
+            value: ws.workspacePath,
+        })),
+    });
+    return selected;
+}
+//# sourceMappingURL=resolve-workspace.js.map

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

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrpatronz/nexusflow",
-  "version": "1.3.2",
+  "version": "1.5.0",
   "description": "Combine multiple repos into a workspace with rich AI assistant context",
   "type": "module",
   "repository": {
@@ -45,23 +45,23 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@hono/node-server": "^2.0.4",
+    "@hono/node-server": "^2.0.8",
     "@inquirer/prompts": "^8.5.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "chalk": "^5.3.0",
+    "chalk": "^5.6.2",
     "commander": "^15.0.0",
-    "execa": "^9.5.0",
-    "fs-extra": "^11.2.0",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.6",
     "globby": "^16.2.0",
-    "hono": "^4.12.25",
-    "ora": "^9.4.0",
-    "pm2": "^7.0.1"
+    "hono": "^4.12.27",
+    "ora": "^9.4.1",
+    "pm2": "^7.0.3"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^25.9.3",
-    "rimraf": "^6.0.0",
+    "@types/node": "^26.1.0",
+    "rimraf": "^6.1.3",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   }
 }