@mrpatronz/nexusflow 0.1.2 → 0.1.4

package/dist/types.d.ts.map

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

package/dist/utils/update-check.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module utils/update-check
+ * Checks for updates to the NexusFlow package on the NPM registry.
+ */
+export interface UpdateStatus {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+}
+/**
+ * Resolves the current package version by searching for package.json upward
+ * from the directory of the executing code.
+ */
+export declare function getCurrentVersion(): string;
+/**
+ * Checks for updates from the NPM registry.
+ * Employs a 24-hour cache unless forced.
+ *
+ * @param force - If true, ignores the 24-hour cache and fetches immediately.
+ * @returns The update status, or null if the check fails (e.g. offline).
+ */
+export declare function checkForUpdates(force?: boolean): Promise<UpdateStatus | null>;
+/**
+ * Prints a clean, premium terminal notification banner if an update is available.
+ */
+export declare function printUpdateBanner(status: UpdateStatus): void;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/utils/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/utils/update-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAoB1C;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmDjF;AAqBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAoB5D"}

package/dist/utils/update-check.js

@@ -0,0 +1,128 @@
+/**
+ * @module utils/update-check
+ * Checks for updates to the NexusFlow package on the NPM registry.
+ */
+import { fileURLToPath } from 'node:url';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import chalk from 'chalk';
+import { loadConfig, saveConfig } from '../core/config.js';
+/**
+ * Resolves the current package version by searching for package.json upward
+ * from the directory of the executing code.
+ */
+export function getCurrentVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        let currentDir = __dirname;
+        for (let i = 0; i < 5; i++) {
+            const packageJsonPath = path.join(currentDir, 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                return pkg.version;
+            }
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir)
+                break;
+            currentDir = parentDir;
+        }
+    }
+    catch {
+        // Fallback if filesystem access fails
+    }
+    return '0.1.3'; // Sensible fallback (active release)
+}
+/**
+ * Checks for updates from the NPM registry.
+ * Employs a 24-hour cache unless forced.
+ *
+ * @param force - If true, ignores the 24-hour cache and fetches immediately.
+ * @returns The update status, or null if the check fails (e.g. offline).
+ */
+export async function checkForUpdates(force = false) {
+    const currentVersion = getCurrentVersion();
+    const config = await loadConfig();
+    const now = Date.now();
+    const lastCheck = config.lastUpdateCheck ? new Date(config.lastUpdateCheck).getTime() : 0;
+    const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+    // Use cached result if within 24 hours and not forced
+    if (!force && lastCheck && (now - lastCheck < ONE_DAY_MS) && config.latestVersion) {
+        return {
+            currentVersion,
+            latestVersion: config.latestVersion,
+            updateAvailable: isNewerVersion(currentVersion, config.latestVersion),
+        };
+    }
+    try {
+        // Query NPM registry latest endpoint
+        const response = await fetch('https://registry.npmjs.org/@mrpatronz/nexusflow/latest', {
+            signal: AbortSignal.timeout(3000), // 3-second timeout to prevent blocking CLI/server
+        });
+        if (!response.ok) {
+            throw new Error(`NPM registry returned status ${response.status}`);
+        }
+        const data = await response.json();
+        const latestVersion = data.version;
+        // Cache results
+        config.lastUpdateCheck = new Date().toISOString();
+        config.latestVersion = latestVersion;
+        await saveConfig(config);
+        return {
+            currentVersion,
+            latestVersion,
+            updateAvailable: isNewerVersion(currentVersion, latestVersion),
+        };
+    }
+    catch {
+        // Fallback: If offline or check fails, return cached version status if available
+        if (config.latestVersion) {
+            return {
+                currentVersion,
+                latestVersion: config.latestVersion,
+                updateAvailable: isNewerVersion(currentVersion, config.latestVersion),
+            };
+        }
+        return null;
+    }
+}
+/**
+ * Simple semver comparison (checks major.minor.patch).
+ */
+function isNewerVersion(current, latest) {
+    if (current === latest)
+        return false;
+    const currentParts = current.split('.').map(Number);
+    const latestParts = latest.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const curr = currentParts[i] || 0;
+        const lat = latestParts[i] || 0;
+        if (lat > curr)
+            return true;
+        if (curr > lat)
+            return false;
+    }
+    return false;
+}
+/**
+ * Prints a clean, premium terminal notification banner if an update is available.
+ */
+export function printUpdateBanner(status) {
+    if (!status.updateAvailable)
+        return;
+    const msg = `Update available: ${chalk.red(status.currentVersion)} → ${chalk.green(status.latestVersion)}`;
+    const runMsg = `Run ${chalk.cyan('npm install -g @mrpatronz/nexusflow')} to update!`;
+    const cleanMsg = `Update available: ${status.currentVersion} → ${status.latestVersion}`;
+    const cleanRunMsg = `Run npm install -g @mrpatronz/nexusflow to update!`;
+    const width = Math.max(cleanMsg.length, cleanRunMsg.length) + 2;
+    const padMsg = ' '.repeat(width - cleanMsg.length);
+    const padRunMsg = ' '.repeat(width - cleanRunMsg.length);
+    const border = '─'.repeat(width);
+    console.log();
+    console.log(chalk.yellow(`┌${border}┐`));
+    console.log(chalk.yellow(`│ ${msg}${padMsg} │`));
+    console.log(chalk.yellow(`│ ${runMsg}${padRunMsg} │`));
+    console.log(chalk.yellow(`└${border}┘`));
+    console.log();
+}
+//# sourceMappingURL=update-check.js.map

package/dist/utils/update-check.js.map

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

package/gui/src/App.tsx

@@ -99,6 +99,14 @@ export default function App() {
   const [configLoading, setConfigLoading] = useState(true);
   const [configExists, setConfigExists] = useState<boolean>(true);
   const [saveStatus, setSaveStatus] = useState<'success' | 'error' | null>(null);
+
+  // Update Check State
+  const [updateStatus, setUpdateStatus] = useState<{
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+  } | null>(null);
+  const [appVersion, setAppVersion] = useState('0.1.3');
   const [defaultPaths, setDefaultPaths] = useState<{ devDir: string; workspacesDir: string } | null>(null);
 
   // Repos & Tools
@@ -183,6 +191,7 @@ export default function App() {
     fetchAIAssistants();
     fetchEditors();
     fetchWorkspaces();
+    fetchUpdateStatus();
   }, []);
 
   // Poll logs and services status when active workspace is open
@@ -252,6 +261,21 @@ export default function App() {
 
   // ─── API Fetches ────────────────────────────────────────────────────────
 
+  const fetchUpdateStatus = async () => {
+    try {
+      const res = await fetch(`${API_BASE}/api/update-status`);
+      if (res.ok) {
+        const data = await res.json();
+        setUpdateStatus(data);
+        if (data.currentVersion) {
+          setAppVersion(data.currentVersion);
+        }
+      }
+    } catch (e) {
+      console.error('Failed to fetch update status:', e);
+    }
+  };
+
   const fetchConfig = async () => {
     try {
       const res = await fetch(`${API_BASE}/api/config`);
@@ -992,7 +1016,7 @@ Core Instructions:
           </ul>
         </nav>
         <div className="pt-6 border-t border-gray-800/60 text-[11px] text-gray-500 text-center">
-          NexusFlow Engine v0.1.0
+          NexusFlow Engine v{appVersion}
         </div>
       </aside>
 
@@ -1005,6 +1029,36 @@ Core Instructions:
           </div>
         ) : (
           <>
+            {/* Update Notification Banner */}
+            {updateStatus && updateStatus.updateAvailable && (
+              <div className="mb-6 p-4 bg-gradient-to-r from-amber-500/10 to-orange-600/10 border border-amber-500/30 rounded-xl shadow-lg flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4 backdrop-blur-sm">
+                <div className="flex items-center gap-3">
+                  <div className="w-10 h-10 rounded-lg bg-amber-500/10 border border-amber-500/20 flex items-center justify-center text-amber-400 shrink-0">
+                    <Sparkles size={20} />
+                  </div>
+                  <div>
+                    <h4 className="text-sm font-bold text-amber-300">
+                      A new version of NexusFlow is available!
+                    </h4>
+                    <p className="text-xs text-gray-400 mt-0.5">
+                      Upgrade from v{updateStatus.currentVersion} to v{updateStatus.latestVersion} to get the latest features and bug fixes.
+                    </p>
+                  </div>
+                </div>
+                <div className="flex items-center gap-3 shrink-0">
+                  <button
+                    onClick={() => {
+                      navigator.clipboard.writeText('npm install -g @mrpatronz/nexusflow');
+                      alert('Update command copied to clipboard!');
+                    }}
+                    className="px-4 py-2 bg-amber-500 hover:bg-amber-600 text-[#060813] font-bold text-xs rounded-lg transition-all shadow-md shadow-amber-500/10 cursor-pointer flex items-center gap-1.5"
+                  >
+                    Copy Update Command
+                  </button>
+                </div>
+              </div>
+            )}
+
             {/* View 0: Getting Started Guide */}
             {view === 'guide' && config && (
               <div className="max-w-4xl mx-auto">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrpatronz/nexusflow",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Combine multiple repos into a workspace with rich AI assistant context",
   "type": "module",
   "main": "dist/index.js",
@@ -33,6 +33,7 @@
   "dependencies": {
     "@hono/node-server": "^2.0.4",
     "@inquirer/prompts": "^7.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "chalk": "^5.3.0",
     "commander": "^13.0.0",
     "execa": "^9.5.0",

package/src/commands/mcp.ts

@@ -0,0 +1,92 @@
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import chalk from 'chalk';
+import { startMcpServer } from '../mcp/server.js';
+
+export async function mcpRunCommand(workspace?: string) {
+  // If not provided, it attempts to use process.cwd() or waits for workspaceId in MCP calls.
+  // The startMcpServer function handles this.
+  await startMcpServer(workspace);
+}
+
+export async function mcpSetupCommand() {
+  console.log(chalk.blue.bold('\nSetting up NexusFlow MCP Server for AI Assistants...'));
+  
+  const isWin = os.platform() === 'win32';
+  const isMac = os.platform() === 'darwin';
+  const home = os.homedir();
+
+  const configPaths = [
+    // Cursor
+    path.join(home, '.cursor', 'mcp.json'),
+    // VS Code Insiders (for Antigravity/Copilot)
+    isWin 
+      ? path.join(home, 'AppData', 'Roaming', 'Code - Insiders', 'User', 'mcp.json')
+      : isMac 
+        ? path.join(home, 'Library', 'Application Support', 'Code - Insiders', 'User', 'mcp.json')
+        : path.join(home, '.config', 'Code - Insiders', 'User', 'mcp.json'),
+    // VS Code (Stable)
+    isWin 
+      ? path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'mcp.json')
+      : isMac 
+        ? path.join(home, 'Library', 'Application Support', 'Code', 'User', 'mcp.json')
+        : path.join(home, '.config', 'Code', 'User', 'mcp.json'),
+    // Claude Desktop
+    isWin
+      ? path.join(home, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json')
+      : isMac
+        ? path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+        : ''
+  ].filter(Boolean);
+
+  const mcpConfig = {
+    command: 'npx',
+    args: ['-y', '@mrpatronz/nexusflow', 'mcp', 'run']
+  };
+
+  let updatedCount = 0;
+
+  for (const configPath of configPaths) {
+    if (!configPath) continue;
+    try {
+      let configData: any = { mcpServers: {} };
+      
+      try {
+        await fs.access(configPath);
+        const raw = await fs.readFile(configPath, 'utf8');
+        // Handle empty or invalid files gracefully
+        if (raw.trim()) {
+            configData = JSON.parse(raw);
+        }
+        if (!configData.mcpServers) configData.mcpServers = {};
+      } catch (e) {
+        // File doesn't exist, we will create it if the directory exists
+        const dir = path.dirname(configPath);
+        try {
+          await fs.access(dir);
+        } catch {
+          // Directory doesn't exist, skip this environment
+          continue;
+        }
+      }
+
+      configData.mcpServers['nexusflow'] = mcpConfig;
+
+      await fs.writeFile(configPath, JSON.stringify(configData, null, 2), 'utf8');
+      console.log(chalk.green(`  ✓ Configured MCP in: ${configPath}`));
+      updatedCount++;
+    } catch (e: any) {
+      console.log(chalk.gray(`  - Skipped ${configPath} (${e.message})`));
+    }
+  }
+
+  if (updatedCount > 0) {
+    console.log(chalk.green.bold(`\nSuccessfully configured ${updatedCount} AI environments!`));
+    console.log(chalk.white('You may need to restart your editor or Claude Desktop for the changes to take effect.'));
+  } else {
+    console.log(chalk.yellow('\nCould not find any standard configuration files to update.'));
+    console.log('You can manually add this configuration to your mcp.json:');
+    console.log(JSON.stringify({ mcpServers: { nexusflow: mcpConfig } }, null, 2));
+  }
+}

package/src/core/workspace.ts

@@ -7,6 +7,7 @@
 
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
+import { execa } from 'execa';
 
 import type { Feature, RepoInfo } from '../types.js';
 import { createWorktree } from './worktree.js';
@@ -47,6 +48,19 @@ export async function createWorkspace(
   // Ensure the workspace directory exists.
   await fs.mkdir(workspacePath, { recursive: true });
 
+  // Initialize git repository at workspace root to prevent AI assistants (like Claude)
+  // from climbing up to parent git repositories (main/master).
+  try {
+    await execa('git', ['init'], { cwd: workspacePath });
+
+    // Write a .gitignore to ignore the sub-repositories
+    const gitignoreContent = repos.map((repo) => `/${repo.name}/`).join('\n') + '\n';
+    await fs.writeFile(path.join(workspacePath, '.gitignore'), gitignoreContent, 'utf-8');
+  } catch (error) {
+    // Silently ignore or log warning if git init fails
+    console.warn('Warning: Failed to initialize git repository at workspace root:', error);
+  }
+
   // Create a worktree for each repo inside the workspace.
   for (const repo of repos) {
     const worktreeTarget = path.join(workspacePath, repo.name);

package/src/core/worktree.ts

@@ -23,13 +23,30 @@ export async function createWorktree(
   branchName: string,
   baseBranch: string,
 ): Promise<void> {
+  let fetched = false;
   // Fetch latest remote state.
-  await execa('git', ['fetch', 'origin'], { cwd: repoPath });
+  try {
+    await execa('git', ['fetch', 'origin'], { cwd: repoPath });
+    fetched = true;
+  } catch {
+    // Silently ignore fetch failures (e.g., offline or no remote origin)
+  }
 
-  // Create the worktree with a new branch based on the remote base branch.
+  // Determine starting point: remote branch if fetched successfully and exists, else local branch.
+  let startPoint = baseBranch;
+  if (fetched) {
+    try {
+      await execa('git', ['rev-parse', '--verify', `origin/${baseBranch}`], { cwd: repoPath });
+      startPoint = `origin/${baseBranch}`;
+    } catch {
+      // remote tracking branch does not exist, fallback to local branch
+    }
+  }
+
+  // Create the worktree with a new branch based on the start point.
   await execa(
     'git',
-    ['worktree', 'add', targetPath, '-b', branchName, `origin/${baseBranch}`],
+    ['worktree', 'add', targetPath, '-b', branchName, startPoint],
     { cwd: repoPath },
   );
 }

package/src/generators/base.ts

@@ -176,6 +176,14 @@ Once you have created \`nexusflow-overview.md\` and compiled your questions, ask
 
 ## Guidelines
 
+- **Multi-Repo Workspace Structure**: This workspace is a multi-repository developer environment where each project subdirectory (e.g. \`my-api\`, \`my-frontend\`) is a separate Git worktree checked out on the feature branch \`\${feature.branchName}\`.
+  - **All code changes** must be made within the appropriate project subdirectories.
+  - **Git commands** (like \`git status\`, \`git add\`, \`git commit\`, \`git push\`) must be run inside the specific project subdirectories (e.g. \`cd my-api && git commit -m "..."\`), NOT in the workspace root.
+  - **Project commands** (like \`npm install\`, \`npm run build\`, \`npm run test\`) must be run inside the project subdirectories.
+  - **Global helpers**: Alternatively, you can run NexusFlow CLI commands from the workspace root:
+    - \`nexusflow diff\` — view changes across all sub-repositories.
+    - \`nexusflow commit\` — commit and push changes across modified repositories.
+    - \`nexusflow sync\` — rebase all repositories with their default base branches.
 - **Workspace Knowledge**: Read \`nexusflow-knowledge.md\` at the start of every session. It serves as the persistent memory for this feature. Before ending your session, append significant architecture decisions, discovered gotchas, and checklist progress to \`nexusflow-knowledge.md\`. Never delete or overwrite existing knowledge/decisions — only append.
 - **Implementation Plan**: Refer to \`nexusflow-plan.md\` for the suggested implementation order based on dependency analysis. Follow the phased implementation order to avoid blocking yourself on cross-repo dependencies.
 - Read each project's existing \`README.md\` and any doc files before proposing changes.

package/src/index.ts

@@ -23,7 +23,8 @@ import { uiCommand } from './commands/ui.js';
 import { syncCommand } from './commands/sync.js';
 import { commitCommand } from './commands/commit.js';
 import { diffCommand } from './commands/diff.js';
-
+import { mcpRunCommand, mcpSetupCommand } from './commands/mcp.js';
+import { getCurrentVersion, checkForUpdates, printUpdateBanner } from './utils/update-check.js';
 
 const program = new Command();
 
@@ -32,7 +33,7 @@ program
   .description(
     'Combine multiple repos into a workspace with rich AI assistant context',
   )
-  .version('0.1.0');
+  .version(getCurrentVersion());
 
 program
   .command('create')
@@ -233,5 +234,48 @@ program
     }
   });
 
+const mcp = program.command('mcp').description('Manage the NexusFlow MCP Server for AI assistants');
+
+mcp
+  .command('run')
+  .description('Start the NexusFlow MCP Server (typically called automatically by AI assistants)')
+  .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
+  .action(async (workspace?: string) => {
+    try {
+      await mcpRunCommand(workspace);
+    } catch (error) {
+      console.error(error);
+      process.exit(1);
+    }
+  });
+
+mcp
+  .command('setup')
+  .description('Automatically configure your AI environments (Claude Desktop, Cursor, VS Code) to use the NexusFlow MCP Server')
+  .action(async () => {
+    try {
+      await mcpSetupCommand();
+    } catch (error) {
+      console.error(error);
+      process.exit(1);
+    }
+  });
+
+program.hook('postAction', async (thisCommand, actionCommand) => {
+  // Skip update check for MCP run to prevent contaminating stdout stream
+  if (actionCommand.name() === 'run' && actionCommand.parent?.name() === 'mcp') {
+    return;
+  }
+
+  try {
+    const status = await checkForUpdates();
+    if (status) {
+      printUpdateBanner(status);
+    }
+  } catch {
+    // Silently ignore to prevent crashing CLI
+  }
+});
+
 program.parse();