@mrpatronz/nexusflow 0.2.19 → 1.3.1

package/.github/workflows/release-desktop.yml

@@ -1,67 +0,0 @@
-name: Release — Desktop Installer
-
-on:
-  workflow_run:
-    workflows: [CI]
-    branches: [main]
-    types: [completed]
-
-permissions:
-  contents: write
-
-jobs:
-  build-installer:
-    if: github.event.workflow_run.conclusion == 'success'
-    runs-on: windows-latest
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.workflow_run.head_sha }}
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: 'https://registry.npmjs.org/'
-
-      - name: Install Dependencies
-        run: npm ci
-
-      - name: Install GUI Dependencies
-        run: npm ci --prefix gui
-
-      - name: Install Desktop Dependencies
-        run: npm ci --prefix desktop
-
-      - name: Build Desktop GUI
-        run: npm run build --prefix gui
-
-      - name: Build Desktop Binaries
-        run: npm run build --prefix desktop
-
-      - name: Build Standalone Installer
-        run: npm run build:installer --prefix desktop
-
-      - name: Check npm version
-        id: check-version
-        shell: bash
-        run: |
-          VERSION=$(node -e "console.log(require('./package.json').version)")
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          if npm info @mrpatronz/nexusflow@$VERSION --json >/dev/null 2>&1; then
-            echo "is_new=false" >> $GITHUB_OUTPUT
-            echo "Version $VERSION already published. Skipping installer upload."
-          else
-            echo "is_new=true" >> $GITHUB_OUTPUT
-            echo "Version $VERSION is new."
-          fi
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Upload installer to GitHub Release
-        if: steps.check-version.outputs.is_new == 'true'
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: v${{ steps.check-version.outputs.version }}
-          files: desktop/dist-installer-output/NexusFlowSetup.exe

package/.github/workflows/release-npm.yml

@@ -1,65 +0,0 @@
-name: Release — npm
-
-on:
-  workflow_run:
-    workflows: [CI]
-    branches: [main]
-    types: [completed]
-
-permissions:
-  contents: write
-
-jobs:
-  publish-npm:
-    if: github.event.workflow_run.conclusion == 'success'
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.workflow_run.head_sha }}
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: 'https://registry.npmjs.org/'
-
-      - name: Install Dependencies
-        run: npm ci
-
-      - name: Install GUI Dependencies
-        run: npm ci --prefix gui
-
-      - name: Build Project
-        run: npm run build
-
-      - name: Check version
-        id: check-version
-        run: |
-          VERSION=$(node -e "console.log(require('./package.json').version)")
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          if npm info @mrpatronz/nexusflow@$VERSION --json >/dev/null 2>&1; then
-            echo "is_new=false" >> $GITHUB_OUTPUT
-            echo "Version $VERSION is already published on npm. Skipping."
-          else
-            echo "is_new=true" >> $GITHUB_OUTPUT
-            echo "Version $VERSION is new."
-          fi
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Publish to npm
-        if: steps.check-version.outputs.is_new == 'true'
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub Release
-        if: steps.check-version.outputs.is_new == 'true'
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: v${{ steps.check-version.outputs.version }}
-          name: Release v${{ steps.check-version.outputs.version }}
-          generate_release_notes: true
-          target_commitish: ${{ github.event.workflow_run.head_sha }}

package/.github/workflows/release-vscode.yml

@@ -1,61 +0,0 @@
-name: Release — VS Code Extension
-
-on:
-  workflow_run:
-    workflows: [CI]
-    branches: [main]
-    types: [completed]
-
-permissions:
-  id-token: write   # required for OIDC token request
-  contents: read
-
-jobs:
-  publish-extension:
-    if: github.event.workflow_run.conclusion == 'success'
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.workflow_run.head_sha }}
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-
-      - name: Install Extension Dependencies
-        run: npm ci --prefix extension
-
-      - name: Azure Login (OIDC — no stored secrets)
-        uses: azure/login@v2
-        with:
-          client-id: ${{ secrets.AZURE_CLIENT_ID }}
-          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
-          allow-no-subscriptions: true
-
-      - name: Check extension version
-        id: check-version
-        working-directory: extension
-        run: |
-          VERSION=$(node -e "console.log(require('./package.json').version)")
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          PUBLISHED=$(npx vsce show nexusflow.nexusflow-vscode --json 2>/dev/null \
-            | node -e "
-                const d=require('fs').readFileSync(0,'utf8');
-                try { process.exit(JSON.parse(d).versions?.['$VERSION'] ? 0 : 1); }
-                catch { process.exit(1); }
-              " && echo "true" || echo "false")
-          if [ "$PUBLISHED" = "true" ]; then
-            echo "is_new=false" >> $GITHUB_OUTPUT
-            echo "Extension version $VERSION already published. Skipping."
-          else
-            echo "is_new=true" >> $GITHUB_OUTPUT
-            echo "Extension version $VERSION is new."
-          fi
-
-      - name: Publish to VS Code Marketplace
-        if: steps.check-version.outputs.is_new == 'true'
-        working-directory: extension
-        run: npx vsce publish --no-dependencies --azure-credential

package/.vscode/launch.json

@@ -1,17 +0,0 @@
-{
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "name": "Launch Extension",
-      "type": "extensionHost",
-      "request": "launch",
-      "args": [
-        "--extensionDevelopmentPath=${workspaceRoot}/extension"
-      ],
-      "outFiles": [
-        "${workspaceRoot}/extension/dist/**/*.js"
-      ],
-      "preLaunchTask": "npm: extension-compile"
-    }
-  ]
-}

package/.vscode/tasks.json

@@ -1,17 +0,0 @@
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "type": "npm",
-      "script": "extension:compile",
-      "group": {
-        "kind": "build",
-        "isDefault": true
-      },
-      "label": "npm: extension-compile",
-      "problemMatcher": [
-        "$tsc"
-      ]
-    }
-  ]
-}

package/GETTING_STARTED.md

@@ -1,114 +0,0 @@
-# NexusFlow — Getting Started Guide
-
-Welcome to **NexusFlow**! This guide will walk you through the system, explain its core workflows, and show you how to leverage multi-repository workspaces and agentic orchestration to accelerate feature development.
-
----
-
-## 💡 What is NexusFlow?
-
-When developing complex features in modern systems, you often need to touch multiple repositories simultaneously (e.g., modifying a shared package, updating a backend REST API, and updating a frontend application). 
-
-Traditional AI assistant setups only give the assistant context of a single repository. NexusFlow solves this by:
-1. **Grouping Repositories**: Creating a dedicated workspace using **git worktrees** on a unified feature branch name.
-2. **Generating AI Context**: Writing specialized configurations (`CLAUDE.md`, `AGENTS.md`, Copilot guidelines, and Cursor rules) that outline the workspace architecture.
-3. **Smart Codebase Analysis**: Scanning tech stacks, ports, and API endpoints so the AI instantly understands the codebase boundaries.
-4. **Service Orchestration**: Running, stopping, and logging all projects simultaneously from a single place.
-
----
-
-## 🚀 Step-by-Step Workflow
-
-Here is how to get started with your first feature workspace.
-
-```mermaid
-flowchart TD
-    A["1. Run Web GUI or CLI"] --> B["2. Fill Feature Details & Pick Repos"]
-    B --> C["3. Workspace Created\n(Git Worktrees + Context generated)"]
-    C --> D["4. AI Agent Initializes\n(Fills nexusflow-overview.md + questions)"]
-    D --> E["5. Confirm Assumptions & Spin up services"]
-```
-
-### 1. Initialize NexusFlow
-First, initialize the default configuration on your machine:
-```bash
-nexusflow init
-```
-This sets up `~/.nexusflow/config.json` with default settings:
-* **Development Directory**: Where your git repositories are located (defaults to `~/dev`).
-* **Workspaces Directory**: Where your worktrees will be created (defaults to `~/dev/workspaces`).
-
----
-
-### 2. Launch the Web Dashboard
-NexusFlow comes with a rich, interactive Web Dashboard. Launch it by running:
-```bash
-nexusflow ui
-```
-This starts the local backend server on port `3000` and automatically opens the browser.
-
----
-
-### 3. Create a Feature Workspace
-On the dashboard (or via the `nexusflow create` CLI command):
-1. **Branch name**: Enter your branch name (e.g. `feature/user-profiles`). Slashes are supported!
-2. **Description**: Describe the feature you are building. The AI assistant will read this to compile the plan.
-3. **Pick Repositories**: Choose which repositories you need to modify or reference.
-4. **Assistant Selection**: Select which AI coding assistants you plan to use (Claude Code, Antigravity, Cursor, etc.).
-5. **Click Build Workspace**: NexusFlow will fetch origin updates, create local branches, spin up git worktrees under `workspaces/feature/user-profiles`, run tech analyses, and write context configurations.
-
----
-
-### 4. The Agentic Initialization (Universal Context)
-Once the workspace is built, open it in your preferred AI assistant. 
-
-Whichever AI harness you use, **the agent's very first instructions** are to:
-1. Scan the workspace projects.
-2. Create a universal reference file: **`nexusflow-overview.md`**.
-3. Write down its assumptions of what each project does, how they interact, and their responsibilities.
-4. List any **Clarifying Questions** it needs you to answer before coding.
-
-**Your Action**: Review the generated `nexusflow-overview.md`, answer the assistant's questions directly in the chat or file, and confirm its assumptions. This ensures you and the agent are aligned before a single line of code is modified.
-
----
-
-### 5. Orchestrate Local Services
-You don't need to open five terminal windows to start your backend, frontend, databases, or libraries.
-
-**On the Web Dashboard:**
-* Expand your active workspace to see all detected services (e.g. node scripts, dotnet servers, python hosts).
-* Click **Start All** to spin them up.
-* View aggregate console streams inside the tabbed retro-terminal output screen.
-
-**Via the CLI:**
-* Navigate to your workspace directory and run:
-  ```bash
-  nexusflow start
-  ```
-* Check logs or stop services with:
-  ```bash
-  nexusflow logs
-  nexusflow stop
-  ```
-
----
-
-## 🛠️ CLI Reference
-
-Here is a summary of the command-line interface:
-
-| Command | Usage | Description |
-| :--- | :--- | :--- |
-| **`nexusflow ui`** | `nexusflow ui [-p <port>]` | Starts the backend Hono API server and opens the GUI Dashboard. |
-| **`nexusflow create`** | `nexusflow create` | Launches the interactive step-by-step terminal wizard to build a workspace. |
-| **`nexusflow list`** | `nexusflow list` / `nexusflow ls` | Lists all active feature workspaces discovered on your machine. |
-| **`nexusflow open`** | `nexusflow open` | Prompts you to pick an active workspace and opens it in your editor. |
-| **`nexusflow start`** | `nexusflow start [path]` | Starts background processes for all projects in the workspace. |
-| **`nexusflow stop`** | `nexusflow stop [path]` | Kills all running processes for the workspace. |
-| **`nexusflow logs`** | `nexusflow logs [path] [-n <lines>]` | Tails output log files for all service processes in the workspace. |
-| **`nexusflow status`** | `nexusflow status [path]` | Displays running/stopped statuses and PIDs for each service. |
-| **`nexusflow init`** | `nexusflow init` | Creates or edits the global config file. |
-| **`nexusflow diff`** | `nexusflow diff` | Displays pending code changes across all active workspace repositories. |
-| **`nexusflow commit`** | `nexusflow commit` | Automates cross-repository git commit and branch pushes in the workspace. |
-| **`nexusflow sync`** | `nexusflow sync` | Syncs and rebases all workspace worktrees with default base branches. |
-| **`nexusflow refresh`**| `nexusflow refresh` | Regenerates architecture maps, task plans, and AI context files. |
-| **`nexusflow doctor`** | `nexusflow doctor` | Assesses and reports diagnostics of the current workspace setup. |

package/desktop/build-installer.js

@@ -1,228 +0,0 @@
-import { execSync } from 'child_process';
-import fs from 'fs';
-import https from 'https';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Resolve parent project directory dynamically supporting both nested and sibling structures
-let parentDir = path.resolve(__dirname, '..');
-if (!fs.existsSync(path.join(parentDir, 'package.json')) || 
-    JSON.parse(fs.readFileSync(path.join(parentDir, 'package.json'), 'utf8')).name !== '@mrpatronz/nexusflow') {
-  parentDir = path.resolve(__dirname, '../NexusFlow');
-}
-
-const distInstallerDir = path.resolve(__dirname, 'dist-installer');
-const nodeStagingDir = path.resolve(distInstallerDir, 'node');
-const serverStagingDir = path.resolve(distInstallerDir, 'server');
-const outputDir = path.resolve(__dirname, 'dist-installer-output');
-
-const nodeExeUrl = 'https://nodejs.org/dist/v20.15.0/win-x64/node.exe';
-const nodeExePath = path.resolve(nodeStagingDir, 'node.exe');
-
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function downloadFile(url, destPath) {
-  return new Promise((resolve, reject) => {
-    console.log(`Downloading ${url} to ${destPath}...`);
-    const file = fs.createWriteStream(destPath);
-    https.get(url, (response) => {
-      if (response.statusCode !== 200) {
-        reject(new Error(`Failed to download: Status ${response.statusCode}`));
-        return;
-      }
-      response.pipe(file);
-      file.on('finish', () => {
-        file.close();
-        console.log('Download complete.');
-        resolve();
-      });
-    }).on('error', (err) => {
-      fs.unlink(destPath, () => {});
-      reject(err);
-    });
-  });
-}
-
-function sleepSync(ms) {
-  const start = Date.now();
-  while (Date.now() - start < ms) {}
-}
-
-function retryRmSync(dir, maxRetries = 5, delay = 150) {
-  for (let i = 0; i < maxRetries; i++) {
-    try {
-      if (fs.existsSync(dir)) {
-        fs.rmSync(dir, { recursive: true, force: true });
-      }
-      return;
-    } catch (err) {
-      if (i === maxRetries - 1) throw err;
-      console.log(`Directory ${path.basename(dir)} locked by OS, retrying deletion (${i + 1}/${maxRetries}) in ${delay}ms...`);
-      sleepSync(delay);
-    }
-  }
-}
-
-function pruneNodeModules(dir) {
-  if (!fs.existsSync(dir)) return;
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      const nameLower = entry.name.toLowerCase();
-      if (
-        nameLower === 'test' ||
-        nameLower === 'tests' ||
-        nameLower === 'examples' ||
-        nameLower === 'docs' ||
-        nameLower === '.github'
-      ) {
-        fs.rmSync(fullPath, { recursive: true, force: true });
-      } else {
-        pruneNodeModules(fullPath);
-      }
-    } else {
-      const ext = path.extname(entry.name).toLowerCase();
-      if (ext === '.map' || ext === '.ts' || ext === '.md') {
-        fs.unlinkSync(fullPath);
-      }
-    }
-  }
-}
-
-async function build() {
-  try {
-    console.log('--- Starting NexusFlow Installer Build ---');
-
-    // 1. Re-create clean staging directories with OS lock retry handling
-    console.log('Cleaning and creating staging directories...');
-    retryRmSync(distInstallerDir);
-    fs.mkdirSync(distInstallerDir, { recursive: true });
-    fs.mkdirSync(nodeStagingDir, { recursive: true });
-    fs.mkdirSync(serverStagingDir, { recursive: true });
-
-    try {
-      retryRmSync(outputDir);
-      fs.mkdirSync(outputDir, { recursive: true });
-    } catch (err) {
-      console.log('Output directory locked by shell, clearing files inside instead...');
-      if (fs.existsSync(outputDir)) {
-        const files = fs.readdirSync(outputDir);
-        for (const file of files) {
-          fs.rmSync(path.join(outputDir, file), { recursive: true, force: true });
-        }
-      } else {
-        fs.mkdirSync(outputDir, { recursive: true });
-      }
-    }
-
-    // 2. Copy Neutralino assets
-    console.log('Copying Neutralino assets...');
-    const winExeSrc = path.resolve(__dirname, 'dist/nexusflow-desktop/nexusflow-desktop-win_x64.exe');
-    const resourcesNeuSrc = path.resolve(__dirname, 'dist/nexusflow-desktop/resources.neu');
-
-    if (!fs.existsSync(winExeSrc) || !fs.existsSync(resourcesNeuSrc)) {
-      throw new Error('Neutralino build outputs not found. Please run "npm run build" first in the desktop folder.');
-    }
-
-    fs.copyFileSync(winExeSrc, path.resolve(distInstallerDir, 'nexusflow-desktop-win_x64.exe'));
-    fs.copyFileSync(resourcesNeuSrc, path.resolve(distInstallerDir, 'resources.neu'));
-
-    // 3. Copy Hono backend server files
-    console.log('Copying Hono server dist and package.json...');
-    const serverDistSrc = path.resolve(parentDir, 'dist');
-    const serverPackageJsonSrc = path.resolve(parentDir, 'package.json');
-
-    if (!fs.existsSync(serverDistSrc) || !fs.existsSync(serverPackageJsonSrc)) {
-      throw new Error('NexusFlow server build outputs not found. Please run "npm run build" first in NexusFlow.');
-    }
-
-    copyDir(serverDistSrc, path.resolve(serverStagingDir, 'dist'));
-    fs.copyFileSync(serverPackageJsonSrc, path.resolve(serverStagingDir, 'package.json'));
-
-    // Copy templates/resources
-    const serverResourcesSrc = path.resolve(parentDir, 'resources');
-    if (fs.existsSync(serverResourcesSrc)) {
-      copyDir(serverResourcesSrc, path.resolve(serverStagingDir, 'resources'));
-    }
-
-    // 4. Install server dependencies and prune unused assets
-    console.log('Installing production dependencies for staging server...');
-    execSync('npm install --omit=dev', { cwd: serverStagingDir, stdio: 'inherit', shell: true });
-    
-    console.log('Pruning non-runtime files from node_modules (maps, tests, docs)...');
-    pruneNodeModules(path.resolve(serverStagingDir, 'node_modules'));
-
-    // 5. Download embedded Node.js executable
-    await downloadFile(nodeExeUrl, nodeExePath);
-
-    // 6. Locate and run Inno Setup compiler (ISCC.exe)
-    console.log('Locating Inno Setup compiler...');
-    const userIsccPath = path.join(
-      process.env.USERPROFILE || 'C:\\Users\\default',
-      'AppData\\Local\\Programs\\Inno Setup 6\\ISCC.exe'
-    );
-    const globalIsccPath = 'C:\\Program Files (x86)\\Inno Setup 6\\ISCC.exe';
-
-    let isccPath = '';
-    if (fs.existsSync(userIsccPath)) {
-      isccPath = userIsccPath;
-    } else if (fs.existsSync(globalIsccPath)) {
-      isccPath = globalIsccPath;
-    } else {
-      // Try resolving from PATH
-      try {
-        execSync('iscc /?', { stdio: 'ignore', shell: true });
-        isccPath = 'iscc';
-      } catch {
-        throw new Error('Inno Setup compiler (ISCC.exe) not found. Please verify it is installed.');
-      }
-    }
-
-    console.log(`Using Inno Setup compiler: ${isccPath}`);
-    const issScriptPath = path.resolve(__dirname, 'installer/nexusflow.iss');
-    console.log(`Compiling installer script: ${issScriptPath}...`);
-    execSync(`"${isccPath}" "${issScriptPath}"`, { stdio: 'inherit', shell: true });
-
-    // 7. Check if file got redirected to VirtualStore due to Windows virtualization and move it back
-    const expectedOutputExe = path.resolve(outputDir, 'NexusFlowSetup.exe');
-    if (!fs.existsSync(expectedOutputExe)) {
-      console.log('Checking for Windows VirtualStore redirection...');
-      const localAppData = process.env.LOCALAPPDATA || path.join(process.env.USERPROFILE || 'C:\\Users\\default', 'AppData\\Local');
-      // VirtualStore mirrors the absolute path starting from the drive root
-      const relativePathFromDrive = __dirname.replace(/^[a-zA-Z]:/, '');
-      const virtualStorePath = path.join(localAppData, 'VirtualStore', relativePathFromDrive, 'dist-installer-output', 'NexusFlowSetup.exe');
-      
-      if (fs.existsSync(virtualStorePath)) {
-        console.log(`Detected VirtualStore redirection! Moving installer from ${virtualStorePath} to ${expectedOutputExe}...`);
-        fs.copyFileSync(virtualStorePath, expectedOutputExe);
-        fs.unlinkSync(virtualStorePath);
-      } else {
-        throw new Error('Installer compiled successfully but the output file could not be found anywhere.');
-      }
-    }
-
-    console.log('--- Installer Build Completed Successfully ---');
-    console.log(`Installer location: ${expectedOutputExe}`);
-  } catch (error) {
-    console.error('Installer build failed:', error.message);
-    process.exit(1);
-  }
-}
-
-build();