@nockdev/awf 6.2.6 → 6.2.7

package/.agent/workflows/doctor.md

@@ -0,0 +1,124 @@
+---
+description: "🩺 System doctor: environment diagnostics, runtime checks, config validation, dependency health"
+skills: { required: [], contextual: [auto] }
+---
+
+# 🩺 /doctor — System Doctor Pro
+
+> Environment Diagnostics & Fix Recommendations
+> 📚 Runtime Check • Config Validation • Dependency Health • Auto-Fix
+> ℹ️ Complements `/status` (project health); `/doctor` focuses on environment readiness
+
+---
+
+## DOCTOR FLOW
+
+1. **SCAN** — Detect environment via HSA (`hsa_detect_environment`), identify OS, shell, runtimes, package managers. Show: `[Step 1/4] Scanning environment...`
+2. **VALIDATE** — Check runtime versions, required tools, config files, permissions. Show: `[Step 2/4] Validating 12 checks...`
+3. **DIAGNOSE** — Identify issues, classify severity (🔴 Critical / 🟡 Warning / 🟢 OK). Show: `[Step 3/4] Found 2 issues`
+4. **PRESCRIBE** — Generate fix commands, link docs, offer auto-fix for safe items. Show: `[Step 4/4] Generating prescriptions...`
+
+---
+
+## COMMANDS
+
+| Command             | Description                             |
+| ------------------- | --------------------------------------- |
+| `/doctor`           | Full environment diagnostic             |
+| `/doctor quick`     | Brief summary (🔴 only)                 |
+| `/doctor fix`       | Auto-fix safe issues                    |
+| `/doctor [runtime]` | Check specific runtime (node/go/python) |
+
+---
+
+## 📋 DIAGNOSTIC CHECKS
+
+### Runtime Checks
+
+| Check   | Command            | 🟢 Good | 🟡 Warning | 🔴 Critical      |
+| ------- | ------------------ | ------- | ---------- | ---------------- |
+| Node.js | `node -v`          | ≥ 18.x  | 16.x       | < 16 / missing   |
+| npm     | `npm -v`           | ≥ 9.x   | 7-8.x      | < 7 / missing    |
+| Go      | `go version`       | ≥ 1.22  | 1.20-1.21  | < 1.20 / missing |
+| Python  | `python --version` | ≥ 3.11  | 3.9-3.10   | < 3.9 / missing  |
+| Git     | `git --version`    | ≥ 2.40  | 2.30-2.39  | < 2.30 / missing |
+| Docker  | `docker --version` | ≥ 24.x  | 20-23.x    | < 20 / missing   |
+
+### Config Validation
+
+| Check                  | What                            | Auto-fix    |
+| ---------------------- | ------------------------------- | ----------- |
+| `.env` exists          | Required env vars present       | ⚠️ Template |
+| `tsconfig.json`        | Strict mode enabled             | ✅ Yes      |
+| `package.json` engines | Node version constraint         | ✅ Yes      |
+| `.gitignore`           | Sensitive files excluded        | ✅ Yes      |
+| Lock file              | Consistent with package manager | ❌ No       |
+
+### Dependency Health
+
+| Check              | Command                         | Action            |
+| ------------------ | ------------------------------- | ----------------- |
+| Outdated deps      | `npm outdated`                  | Show update plan  |
+| Security vulns     | `npm audit`                     | Show fix commands |
+| Peer dep conflicts | `npm ls --all`                  | Show resolution   |
+| Unused deps        | Analyze imports vs package.json | Suggest removal   |
+
+### HSA Engine Health
+
+| Check       | Tool                   | Expected         |
+| ----------- | ---------------------- | ---------------- |
+| HSA running | `hsa_status`           | Engine healthy   |
+| Index built | `hsa_status` (verbose) | BM25 + Vector OK |
+| Cache warm  | `hsa_status` (verbose) | Hit rate > 50%   |
+
+---
+
+## 📊 REPORT FORMAT
+
+```
+🩺 System Doctor Report
+
+Environment: Windows 11 | PowerShell 7.5 | VS Code
+Project: my-app (TypeScript + React)
+
+Runtime         Version    Status    Fix
+──────────────────────────────────────────
+Node.js         22.4.0     🟢 OK
+npm             10.8.2     🟢 OK
+Git             2.45.1     🟢 OK
+Docker          —          🟡 Not installed
+
+Config          Status     Fix
+──────────────────────────────────
+.env            🟢 OK
+tsconfig.json   🟡 strict: false   → /doctor fix
+.gitignore      🟢 OK
+
+Dependencies    Status     Action
+──────────────────────────────────
+Outdated        🟡 3 minor → npm update
+Security        🟢 0 vulns
+Unused          🟡 2 found → npm uninstall lodash dayjs
+
+HSA Engine      Status
+──────────────────────
+Engine          🟢 Healthy (uptime: 2h)
+Index           🟢 1,234 docs indexed
+Cache           🟡 Hit rate: 45%
+
+Score: 85/100 (🟢 Good)
+Quick fix: `/doctor fix` (2 auto-fixable issues)
+```
+
+---
+
+## ⛔ SAFETY
+
+- Auto-fix only applies to safe items (config formatting, gitignore)
+- Never auto-install system dependencies without confirmation
+- Never modify .env files (only create templates)
+- Show exact commands before executing
+
+---
+
+_DOMYH Awesome Code • System Doctor Pro • Environment Diagnostics_

package/.agent/workflows/feature.md

@@ -0,0 +1,130 @@
+---
+description: "🏗️ Feature lifecycle: scaffold docs, implement with traceability, enforce SDLC phases"
+skills: { required: [coding-rules], contextual: [auto] }
+---
+
+# 🏗️ /feature — Feature Lifecycle Pro
+
+> Spec-Driven Feature Development with Phase Gates
+> 📚 Requirements → Design → Plan → Implement → Test → Ship
+> ⭐ Traceability: AC → Task → Code → Test (full chain)
+
+---
+
+## FEATURE FLOW
+
+1. **PHASE 0: CONTEXT** — Detect stack via HSA (`hsa_detect_stack`), gather codebase context (`hsa_get_context`), repo map (`hsa_get_repo_map`), understand existing patterns
+2. **PHASE 1: REQUIREMENTS** — Define problem, user stories (INVEST), acceptance criteria (AC-xxx), constraints, out-of-scope → Scaffold `docs/features/{slug}/requirements.md` → ⛔ STOP for user approval
+3. **PHASE 2: DESIGN** — Architecture decisions (ADR-xxx format), data models, API contracts, risk matrix → Create `design.md` with decision records → ⛔ STOP if breaking changes
+4. **PHASE 3: PLANNING** — Task breakdown with traceability (T-xxx → AC-xxx), effort estimation (XS-XXL), dependency graph, RICE scoring → Create `planning.md` → ⛔ STOP for user approval
+5. **PHASE 4: IMPLEMENTATION** — Execute tasks per plan, log decisions in `implementation.md`, `hsa_check_changes` after each milestone. Each code change references task ID (T-xxx)
+6. **PHASE 5: TESTING** — Write tests per `testing.md` strategy, run coverage check, validate all ACs met → Update test results
+7. **PHASE 6: SHIP** — Create summary, update `implementation.md` with final status, verify all phase docs complete, run `/verify` for final gate
+
+---
+
+## COMMANDS
+
+| Command                     | Description                       |
+| --------------------------- | --------------------------------- |
+| `/feature [name]`           | Full lifecycle (Phase 0-6)        |
+| `/feature spec [name]`      | Spec-only (Phase 0-3, no code)    |
+| `/feature implement [slug]` | Resume from existing spec         |
+| `/feature status [slug]`    | Show phase progress               |
+| `/feature list`             | List features in `docs/features/` |
+
+---
+
+## FEATURE OUTPUT
+
+```yaml
+output:
+  base: "docs/features/"
+  structure: "{feature-slug}/"
+  files:
+    requirements.md: "Problem statement, user stories, ACs (Phase 1)"
+    design.md: "Architecture, ADRs, data models (Phase 2)"
+    planning.md: "Task breakdown, effort, dependencies (Phase 3)"
+    implementation.md: "Code log, decisions, file changes (Phase 4)"
+    testing.md: "Test strategy, cases, coverage results (Phase 5)"
+  naming:
+    slug: "kebab-case from feature name, max 30 chars"
+    example: "docs/features/jwt-auth/"
+```
+
+---
+
+## PHASE GATES
+
+> Spec-driven development: requirements MUST be approved before code starts
+
+| Gate | Trigger              | Requires      | Blocks      |
+| ---- | -------------------- | ------------- | ----------- |
+| G1   | After Phase 1 (Req)  | User approval | Phase 4,5,6 |
+| G2   | After Phase 3 (Plan) | User approval | Phase 4     |
+| G3   | After Phase 5 (Test) | All ACs pass  | Phase 6     |
+
+### Gate Rules
+
+- G1 (mandatory): Cannot write feature code without approved requirements
+- G2 (recommended): Skip with `/feature --no-plan-gate`
+- G3 (automated): ACs verified by test results
+
+---
+
+## TRACEABILITY MATRIX
+
+```
+AC-001 ←→ T-001 ←→ file:50 ←→ TC-001
+   ↓           ↓           ↓           ↓
+Requirement   Task    Implementation  Test Case
+```
+
+| Source | Links To          | Format             |
+| ------ | ----------------- | ------------------ |
+| AC-xxx | T-xxx, TC-xxx     | `Ref: AC-001`      |
+| T-xxx  | AC-xxx, file:line | `Task: T-001`      |
+| DD-xxx | AC-xxx            | `Decision: DD-001` |
+| TC-xxx | AC-xxx            | `Covers: AC-001`   |
+
+---
+
+## EFFORT ESTIMATION
+
+| Size    | Time  | Examples                    |
+| ------- | ----- | --------------------------- |
+| **XS**  | < 1h  | Config change, copy fix     |
+| **S**   | 1-4h  | Simple endpoint, UI tweak   |
+| **M**   | 4h-2d | Feature with tests          |
+| **L**   | 2-5d  | Multi-component feature     |
+| **XL**  | 1-2w  | Cross-cutting feature       |
+| **XXL** | 2w+   | **Needs breakdown → /plan** |
+
+> Include: testing (20-30%), buffer (10-20%), review time
+
+---
+
+## INTEGRATION
+
+| Related Command | When to Use                       |
+| --------------- | --------------------------------- |
+| `/plan`         | Complex planning (RICE scoring)   |
+| `/scaffold`     | Generate boilerplate files        |
+| `/code`         | Implementation (Phase 4)          |
+| `/test`         | Test writing (Phase 5)            |
+| `/verify`       | Final verification gate (Phase 6) |
+| `/review`       | Code review before merge          |
+
+---
+
+## ⛔ SAFETY
+
+- Never skip Phase 1 gate (requirements approval)
+- Never overwrite existing feature docs without confirmation
+- Warn if feature scope exceeds XL (suggest breakdown)
+- All code changes must reference task IDs
+- Log all architecture decisions in design.md
+
+---
+
+_DOMYH Awesome Code • Feature Lifecycle Pro • Spec-Driven Development_

package/.agent/workflows/help.md

@@ -25,11 +25,12 @@ skills: { required: [], contextual: [] }
 
 ### Planning & Design
 
-| Command             | Description         | Example                |
-| ------------------- | ------------------- | ---------------------- |
-| `/plan [feature]`   | 📋 Feature planning | `/plan shopping cart`  |
-| `/think [topic]`    | 💡 Brainstorming    | `/think architecture`  |
-| `/visualize [page]` | 🖼️ UI/UX mockups    | `/visualize dashboard` |
+| Command             | Description          | Example                |
+| ------------------- | -------------------- | ---------------------- |
+| `/plan [feature]`   | 📋 Feature planning  | `/plan shopping cart`  |
+| `/feature [name]`   | 🏗️ Feature lifecycle | `/feature jwt-auth`    |
+| `/think [topic]`    | 💡 Brainstorming     | `/think architecture`  |
+| `/visualize [page]` | 🖼️ UI/UX mockups     | `/visualize dashboard` |
 
 ### Quality & Ops
 
@@ -54,6 +55,7 @@ skills: { required: [], contextual: [] }
 | Command    | Description           | Example        |
 | ---------- | --------------------- | -------------- |
 | `/status`  | 📊 Project health     | `/status`      |
+| `/doctor`  | 🩺 Environment check  | `/doctor`      |
 | `/recap`   | 📖 Session summary    | `/recap`       |
 | `/upgrade` | 📦 Update deps        | `/upgrade`     |
 | `/env`     | 🔐 Environment config | `/env scan`    |

package/dist/constants.d.ts

@@ -2,7 +2,7 @@
  * Plugin version - SSoT
  * Update this when releasing new versions
  */
-export declare const AWF_VERSION = "6.2.6";
+export declare const AWF_VERSION = "6.2.7";
 /**
  * Plugin name
  */

package/dist/constants.js

@@ -9,7 +9,7 @@ const __dirname = dirname(__filename);
  * Plugin version - SSoT
  * Update this when releasing new versions
  */
-export const AWF_VERSION = "6.2.6";
+export const AWF_VERSION = "6.2.7";
 /**
  * Plugin name
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nockdev/awf",
-  "version": "6.2.6",
+  "version": "6.2.7",
   "description": "DOMYH Awesome Code - AI Development Assistant with 82 Skills",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
     "configs"
   ],
   "peerDependencies": {
-    "@nockdev/cli": "1.0.2"
+    "@nockdev/cli": "1.0.3"
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",