@mrpatronz/nexusflow 0.2.12 → 0.2.17

package/.github/dependabot.yml

@@ -1,52 +1,52 @@
-version: 2
-updates:
-  # 1. Root npm dependencies
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "daily"
-      time: "03:00"
-    open-pull-requests-limit: 10
-    reviewers:
-      - "antan87"
-    groups:
-      root-minor-patch:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
-
-  # 2. GUI npm dependencies
-  - package-ecosystem: "npm"
-    directory: "/gui"
-    schedule:
-      interval: "daily"
-      time: "03:00"
-    open-pull-requests-limit: 10
-    reviewers:
-      - "antan87"
-    groups:
-      gui-minor-patch:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
-
-  # 3. VS Code Extension npm dependencies
-  - package-ecosystem: "npm"
-    directory: "/extension"
-    schedule:
-      interval: "daily"
-      time: "03:00"
-    open-pull-requests-limit: 10
-    reviewers:
-      - "antan87"
-    groups:
-      extension-minor-patch:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
+version: 2
+updates:
+  # 1. Root npm dependencies
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "daily"
+      time: "03:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "antan87"
+    groups:
+      root-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # 2. GUI npm dependencies
+  - package-ecosystem: "npm"
+    directory: "/gui"
+    schedule:
+      interval: "daily"
+      time: "03:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "antan87"
+    groups:
+      gui-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # 3. VS Code Extension npm dependencies
+  - package-ecosystem: "npm"
+    directory: "/extension"
+    schedule:
+      interval: "daily"
+      time: "03:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "antan87"
+    groups:
+      extension-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"

package/.github/workflows/dependabot-merge.yml

@@ -0,0 +1,53 @@
+name: Dependabot Auto-Merge and Version Bump
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  dependabot:
+    runs-on: ubuntu-latest
+    if: github.actor == 'dependabot[bot]'
+    steps:
+      - name: Checkout PR branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Bump Version
+        run: |
+          # Configure Git
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          # Fetch main to compare versions
+          git fetch origin main:main
+          
+          MAIN_VERSION=$(git show main:package.json | node -e "console.log(JSON.parse(require('fs').readFileSync(0, 'utf-8')).version)")
+          PR_VERSION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('package.json', 'utf-8')).version)")
+          
+          if [ "$PR_VERSION" = "$MAIN_VERSION" ]; then
+            echo "Version has not been bumped yet. Bumping patch version..."
+            npm version patch --no-git-tag-version
+            git add package.json package-lock.json
+            git commit -m "chore: bump version for dependabot update"
+            git push origin HEAD:${{ github.event.pull_request.head.ref }}
+          else
+            echo "Version is already bumped ($PR_VERSION vs main $MAIN_VERSION). Skipping bump."
+          fi
+
+      - name: Enable Auto-Merge
+        run: gh pr merge --auto --merge "${{ github.event.pull_request.html_url }}"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/release.yml

@@ -1,100 +1,112 @@
-name: Release & Publish
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-permissions:
-  contents: write
-
-jobs:
-  build-and-test:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-
-      - name: Install Dependencies
-        run: npm ci
-
-      - name: Install GUI Dependencies
-        run: npm ci --prefix gui
-
-      - name: Install Extension Dependencies
-        run: npm ci --prefix extension
-
-      - name: Build Project
-        run: npm run build
-
-      - name: Run Tests
-        run: npm test
-
-      - name: Install Playwright Browsers
-        run: npx playwright install chromium --with-deps
-        working-directory: gui
-
-      - name: Run GUI E2E Tests
-        run: npm run test:gui
-
-  publish:
-    needs: build-and-test
-    runs-on: ubuntu-latest
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: 'https://registry.npmjs.org/'
-
-      - name: Install Dependencies
-        run: npm ci
-
-      - name: Install GUI Dependencies
-        run: npm ci --prefix gui
-
-      - name: Install Extension Dependencies
-        run: npm ci --prefix extension
-
-      - name: Build Project
-        run: npm run build
-
-      - name: Check version and NPM
-        id: check-version
-        run: |
-          CURRENT_VERSION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('./package.json', 'utf8')).version)")
-          echo "version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-          if npm info @mrpatronz/nexusflow@$CURRENT_VERSION --json >/dev/null 2>&1; then
-            echo "is_new=false" >> $GITHUB_OUTPUT
-            echo "Version $CURRENT_VERSION is already published on NPM. Skipping publish."
-          else
-            echo "is_new=true" >> $GITHUB_OUTPUT
-            echo "Version $CURRENT_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.sha }}
+name: Release & Publish
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Install GUI Dependencies
+        run: npm ci --prefix gui
+
+      - name: Install Extension Dependencies
+        run: npm ci --prefix extension
+
+      - name: Build Project
+        run: npm run build
+
+      - name: Run Tests
+        run: npm test
+
+      - name: Install Playwright Browsers
+        run: npx playwright install chromium --with-deps
+        working-directory: gui
+
+      - name: Run GUI E2E Tests
+        run: npm run test:gui
+
+  publish:
+    needs: build-and-test
+    runs-on: windows-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Install GUI Dependencies
+        run: npm ci --prefix gui
+
+      - name: Install Extension Dependencies
+        run: npm ci --prefix extension
+
+      - name: Install Desktop Dependencies
+        run: npm ci --prefix desktop
+
+      - name: Build Project
+        run: npm run build
+
+      - name: Build Desktop GUI & Binaries
+        run: npm run build --prefix desktop
+
+      - name: Build Standalone Installer
+        run: npm run build:installer --prefix desktop
+
+      - name: Check version and NPM
+        id: check-version
+        shell: bash
+        run: |
+          CURRENT_VERSION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('./package.json', 'utf8')).version)")
+          echo "version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          if npm info @mrpatronz/nexusflow@$CURRENT_VERSION --json >/dev/null 2>&1; then
+            echo "is_new=false" >> $GITHUB_OUTPUT
+            echo "Version $CURRENT_VERSION is already published on NPM. Skipping publish."
+          else
+            echo "is_new=true" >> $GITHUB_OUTPUT
+            echo "Version $CURRENT_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.sha }}
+          files: |
+            desktop/dist-installer-output/NexusFlowSetup.exe

package/.vscode/launch.json

@@ -1,17 +1,17 @@
-{
-  "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"
-    }
-  ]
-}
+{
+  "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 +1,17 @@
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "type": "npm",
-      "script": "extension:compile",
-      "group": {
-        "kind": "build",
-        "isDefault": true
-      },
-      "label": "npm: extension-compile",
-      "problemMatcher": [
-        "$tsc"
-      ]
-    }
-  ]
-}
+{
+  "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,109 +1,114 @@
-# 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 — 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. |