nexus-devflow 2.16.0 → 2.16.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +121 -7
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,31 +1,145 @@
1
1
  # nexus-devflow
2
2
 
3
- Official Unscoped CLI for **Nexus-DevFlow** — Enterprise-Grade Agentic Workflow Layer supporting **The 3-Pillars Model & Pure Task-Isolated Living Spec Model** for AI coding agents (Google Antigravity, OpenAI Codex, Claude Code, Cursor, Copilot).
3
+ Official Unscoped CLI for **Nexus-DevFlow** — Enterprise-Grade Agentic Workflow Layer supporting **The 3-Pillars Model & Pure Task-Isolated Living Spec Model** for AI coding agents (Google Antigravity, OpenAI Codex, Claude Code, Cursor, Copilot, OpenCode).
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/nexus-devflow?style=flat-square&color=155eef)](https://www.npmjs.com/package/nexus-devflow)
6
+ [![Validate DevFlow](https://github.com/Jakkrich/nexus-devflow/actions/workflows/validate.yml/badge.svg)](https://github.com/Jakkrich/nexus-devflow/actions/workflows/validate.yml)
6
7
  [![MIT license](https://img.shields.io/npm/l/nexus-devflow?style=flat-square&color=155eef)](LICENSE)
7
8
 
9
+ [GitHub Repository](https://github.com/Jakkrich/nexus-devflow) |
10
+ [Documentation](https://github.com/Jakkrich/nexus-devflow#readme) |
11
+ [Changelog](https://github.com/Jakkrich/nexus-devflow/blob/main/CHANGELOG.md)
12
+
8
13
  ---
9
14
 
10
15
  ## 🚀 Quick Start
11
16
 
12
- Run directly without installation:
17
+ Run directly without prior installation using `npx`:
13
18
 
14
19
  ```bash
15
- # Overlay Nexus-DevFlow into your project
20
+ # 1. Overlay Nexus-DevFlow into your project directory
16
21
  npx nexus-devflow
17
22
 
18
- # Launch interactive Web Dashboard
23
+ # 2. Launch local real-time Web Dashboard (http://127.0.0.1:4318)
19
24
  npx nexus-devflow dashboard
20
25
 
21
- # Install all recommended community skills
26
+ # 3. Install all recommended companion skills (archify, diagram-design, bughunter, ponytail, 9arm)
22
27
  npx nexus-devflow skill add --recommended
23
28
 
24
- # Inspect project status and active living spec
29
+ # 4. Check active workspace status, living specs, and findings
25
30
  npx nexus-devflow status
26
31
  ```
27
32
 
28
- For full documentation and advanced commands, visit the [Nexus-DevFlow Repository](https://github.com/Jakkrich/nexus-devflow).
33
+ > **For existing users:** Backward-compatible invocation via `npm create @jakkrichm/nexus-devflow` and `npx @jakkrichm/create-nexus-devflow` is fully supported.
34
+
35
+ ---
36
+
37
+ ## 🏛️ The 3-Pillars Architecture & Task-Isolated Living Spec Model
38
+
39
+ Nexus-DevFlow structures your project into three clear temporal pillars:
40
+
41
+ 1. **🔮 Future (Backlog)**:
42
+ - `devflow/ideas.md` — Idea inbox with instant AI feasibility scoring.
43
+ - `devflow/project-plan.md` & `devflow/build-plan.md` — Master build plan & chronological roadmap.
44
+ 2. **⚡ Present (Active Context)**:
45
+ - `devflow/context/` — Global Shared Source of Truth (`project-overview.md`, `coding-standards.md`, `ai-interaction.md`, `glossary.md`).
46
+ - `devflow/context/{xxx-slug}/` — Pure Task-Isolated Living Spec workspace (`spec.md`, `stage.md`, `findings.md`).
47
+ 3. **📦 Past (History Archive)**:
48
+ - `devflow/history/` — Categorized delivery archives (`features/`, `fixes/`, `rollbacks/`, and `HISTORY.md`).
49
+
50
+ ---
51
+
52
+ ## ⚡ The Unified 4-Stage Living Spec Lifecycle
53
+
54
+ All development tasks execute systematically through a 4-step progressive lifecycle:
55
+
56
+ ```text
57
+ /feature (or /fix) ──▶ /implement ──▶ /check ──▶ /complete
58
+ ```
59
+
60
+ | Stage | Command | Purpose |
61
+ |---|---|---|
62
+ | **1. Feature / Fix** | `/feature`, `/fix` | Combines Discover, Define, Spec, and Plan. Allocates sequential ID (`xxx-slug`) and initializes the Task-Isolated Living Spec (`devflow/context/{xxx-slug}/spec.md`). |
63
+ | **2. Implement** | `/implement [id]` | Checks out branch `feature/{xxx-slug}`, executes checklist tasks incrementally with strict **TDD discipline (Red-Green-Refactor)**, and records diff evidence. |
64
+ | **3. Check** | `/check [id]` | Senior QA review, multi-lane verification matrix (Typecheck, Lint, Test suites, behavioral proof), and records empirical proof into `spec.md` and findings into `findings.md`. |
65
+ | **4. Complete** | `/complete [id]` | Final safety pass, records Release Digest, auto-archives to `devflow/history/`, cleans up active task folder, updates `HISTORY.md`, and manages git squash-merge. |
66
+
67
+ ---
68
+
69
+ ## 🛠️ CLI Command Reference
70
+
71
+ The `nexus-devflow` CLI bundles complete management commands for agents and developers:
72
+
73
+ ### 📊 Dashboard & Status
74
+ ```bash
75
+ # Launch interactive web dashboard with 0ms SSR First Paint
76
+ npx nexus-devflow dashboard [--port 4318] [--no-open]
77
+
78
+ # Show project overview, progress, findings, git status, and next action
79
+ npx nexus-devflow status [--json]
80
+ ```
81
+
82
+ ### 🧠 Skills Management (Extensible Ecosystem)
83
+ ```bash
84
+ # List all installed skills across adapters
85
+ npx nexus-devflow skill list
86
+
87
+ # Install all recommended community companion skills in one command
88
+ npx nexus-devflow skill add --recommended
89
+
90
+ # Or install individual skills by name or git URL:
91
+ npx nexus-devflow skill add archify # Architecture, sequence & data flow trace diagrams
92
+ npx nexus-devflow skill add diagram-design # 39 editorial charts & presentation diagram templates
93
+ npx nexus-devflow skill add bughunter # Offensive security audit & vulnerability testing
94
+ npx nexus-devflow skill add ponytail # Lazy senior dev mode - cuts code bloat & tokens (YAGNI)
95
+ npx nexus-devflow skill add 9arm # Engineering rituals & post-mortem practices
96
+
97
+ # Update installed skills to latest versions
98
+ npx nexus-devflow skill update --recommended
99
+
100
+ # Synchronize skill inventory between .agents and .claude adapters
101
+ npx nexus-devflow skill sync
102
+ ```
103
+
104
+ ### 🛡️ Quality Gatekeeper & CI/CD Hooks
105
+ ```bash
106
+ # Verify active branch gates before commit/merge (exit code 0 or 1)
107
+ npx nexus-devflow check-gate [--strict]
108
+
109
+ # Install automatic local Git pre-commit or pre-push hook
110
+ npx nexus-devflow hook install pre-commit
111
+ npx nexus-devflow hook install pre-push
112
+ ```
113
+
114
+ ### ⚡ Context Optimization & Agent Tooling
115
+ ```bash
116
+ # Model Context Protocol (MCP) JSON-RPC Stdio Server
117
+ npx nexus-devflow mcp
118
+
119
+ # Just-In-Time (JIT) Dynamic Context Slicing (reduces AI tokens by 60-70%)
120
+ npx nexus-devflow slice --stage implement [--max-tokens 4000]
121
+
122
+ # Detect drift between code changes and active living spec
123
+ npx nexus-devflow drift
124
+ npx nexus-devflow reconcile [--fix]
125
+
126
+ # Workspace health doctor and auto-healing
127
+ npx nexus-devflow doctor [--fix]
128
+
129
+ # Safe framework updater (preserves your custom rules & project context)
130
+ npx nexus-devflow update [--dry-run]
131
+ ```
132
+
133
+ ---
134
+
135
+ ## 🤖 Multi-Agent Compatibility
136
+
137
+ Nexus-DevFlow installs cross-compatible adapters for every major AI coding environment:
138
+
139
+ - **Google Antigravity & OpenAI Codex**: `.agents/skills/` & `AGENTS.md`
140
+ - **Claude Code**: `.claude/skills/` & `CLAUDE.md`
141
+ - **Cursor & GitHub Copilot**: `AGENTS.md`
142
+ - **OpenCode & Aider**: Automatic workspace discovery
29
143
 
30
144
  ---
31
145
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nexus-devflow",
3
- "version": "2.16.0",
3
+ "version": "2.16.1",
4
4
  "description": "Enterprise-grade spec-driven development framework for multi-agent workflows",
5
5
  "license": "MIT",
6
6
  "author": "Jakkrich",
@@ -37,7 +37,7 @@
37
37
  "package.json"
38
38
  ],
39
39
  "dependencies": {
40
- "@jakkrichm/create-nexus-devflow": "2.16.0"
40
+ "@jakkrichm/create-nexus-devflow": "2.16.1"
41
41
  },
42
42
  "publishConfig": {
43
43
  "access": "public"