feat(v3): bundle React dashboard and global nyx CLI command

Author: ptkvaibhav

.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [ main, v2, v2-file-organization-audit ]
+    branches: [ main, v3 ]
   pull_request:
-    branches: [ main, v2 ]
+    branches: [ main, v3 ]
 
 jobs:
   build:
@@ -29,9 +29,12 @@ jobs:
     - name: Run Quality Checks
       run: npm run check:quality
 
-    - name: Run Security Checks
+    - name: Run Security Scans on Code
       run: npm run check:security
 
+    - name: Run Dependency Audit
+      run: npm audit
+      
     - name: Run Tests
       run: npm test
 

README.md

@@ -33,8 +33,12 @@ Nyx operates on a **Human-in-the-Loop** model. It never moves or deletes a file
 git clone https://github.com/ptkvaibhav/nyx.git
 cd nyx
 
-# Install dependencies
+# Install dependencies and link globally
 npm install
+npm link
+
+# Now you can use the `nyx` command from anywhere!
+nyx
 
 # Initialize your engagement (what Nyx can scan)
 # Edit docs/engagement.md to add your folders
@@ -44,12 +48,13 @@ npm install
 
 | Command | Description |
 | :--- | :--- |
-| `node src/cli.js audit-local` | Performs a full scan of managed directories. |
-| `node src/cli.js prepare-local-organization` | Generates suggestions for moves and renames. |
-| `node src/cli.js local-organization-status` | Views the current pending review queue. |
-| `node src/cli.js approve-local-organization all` | Approves all organization proposals. |
-| `node src/cli.js apply-local-organization` | Executes the approved changes on disk. |
-| `node src/cli.js rollback-local-organization` | Undoes the last set of organization actions. |
+| `nyx` | Launches the React-based Visual Dashboard automatically. |
+| `nyx audit-local` | Performs a full scan of managed directories. |
+| `nyx prepare-local-organization` | Generates suggestions for moves and renames. |
+| `nyx local-organization-status` | Views the current pending review queue. |
+| `nyx approve-local-organization all` | Approves all organization proposals. |
+| `nyx apply-local-organization` | Executes the approved changes on disk. |
+| `nyx rollback-local-organization` | Undoes the last set of organization actions. |
 
 ## 🧪 Verification
 
@@ -67,6 +72,6 @@ Nyx is built with quality as a first-class citizen:
 - [x] Incremental Scanning Logic
 - [x] Version & Purpose Intelligence
 - [x] Rollback System
-- [ ] **Next**: React-based Visual Dashboard
-- [ ] Google Drive & OneDrive Integration
+- [x] React-based Visual Dashboard
+- [ ] **Next**: Google Drive & OneDrive Integration
 - [ ] Duplicate Suffix Intelligence (`(1)`, `(2)`)

docs/project-plan.md

@@ -216,6 +216,7 @@ SQLite remains the right first persistence layer for this.
 - folder proposal engine
 - irrelevance review engine
 - user approval queue
+- React-based visual dashboard with automated `nyx` CLI global command
 
 ### V4: Local Execution - Implemented
 

docs/roadmap.md

@@ -20,6 +20,7 @@
 - add irrelevance review engine
 - build approval queue
 - expose local-first organization commands
+- bundled React-based Visual Dashboard with an automated global `nyx` CLI launcher
 
 ## V4 - Implemented For Local Files