@nockdev/awf 6.2.3 → 6.2.4

package/README.md

@@ -1,17 +1,18 @@
 <p align="center">
-  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:1E40AF,100:8B5CF6&height=160&section=header&text=DOMYH%20Awesome%20Code&fontSize=36&fontColor=FFFFFF&animation=fadeIn&fontAlignY=35&desc=AI-Powered%20Development%20Assistant&descAlignY=55&descSize=14" width="100%" />
+  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:0F172A,50:1E40AF,100:8B5CF6&height=160&section=header&text=DOMYH%20Awesome%20Code&fontSize=36&fontColor=FFFFFF&animation=fadeIn&fontAlignY=35&desc=AI-Powered%20Development%20Assistant&descAlignY=55&descSize=14" width="100%" />
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@nockdev/awf"><img src="https://img.shields.io/npm/v/@nockdev/awf?style=for-the-badge&logo=npm&logoColor=white&labelColor=CB3837&color=000000" alt="npm" /></a>
   <img src="https://img.shields.io/badge/skills-82-8B5CF6?style=for-the-badge&logo=bookstack&logoColor=white" alt="Skills" />
-  <img src="https://img.shields.io/badge/IDEs-22-3B82F6?style=for-the-badge&logo=visualstudiocode&logoColor=white" alt="IDEs" />
+  <img src="https://img.shields.io/badge/IDEs-21-3B82F6?style=for-the-badge&logo=visualstudiocode&logoColor=white" alt="IDEs" />
   <img src="https://img.shields.io/badge/workflows-34-F59E0B?style=for-the-badge&logo=windowsterminal&logoColor=white" alt="Workflows" />
+  <img src="https://img.shields.io/badge/personas-12-EF4444?style=for-the-badge&logo=drama&logoColor=white" alt="Personas" />
   <img src="https://img.shields.io/badge/license-MIT-10B981?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="License" />
 </p>
 
 <p align="center">
-  Plugin for <a href="https://www.npmjs.com/package/@nockdev/cli"><b>@nockdev/cli</b></a> — install once, use across 22 AI IDEs with 82 specialized skills.
+  Plugin for <a href="https://www.npmjs.com/package/@nockdev/cli"><b>@nockdev/cli</b></a> — install once, use across 21 AI IDEs with 82 specialized skills and 13 HSA MCP tools.
 </p>
 
 ---
@@ -53,29 +54,72 @@ nock awf init                 # Initialize in your project
 | **Core**          |   6   | Security, API Design, Error Handling, Logging, Observability, Auth              |
 | **Tooling**       |   5   | CLI Dev, API Protocols, MCP, Browser Agent, IDE Extension                       |
 
+### 3-Tier Progressive Loading
+
+| Tier | File          | Size          | When             |
+| :--: | :------------ | :------------ | :--------------- |
+|  T1  | `META.yaml`   | ~100 tokens   | Always available |
+|  T2  | `SKILL.md`    | ~1,500 tokens | On-demand        |
+|  T3  | `ADVANCED.md` | ~4,000 tokens | Deep dive only   |
+
 ---
 
-## 💻 Supported IDEs (22)
+## 💻 Supported IDEs (21)
+
+| Tier       | IDEs                                                                                     |
+| :--------- | :--------------------------------------------------------------------------------------- |
+| **Tier 0** | Codex                                                                                    |
+| **Tier 1** | Cursor, Claude Code, Gemini CLI, Antigravity, VS Code + Copilot, Windsurf                |
+| **Tier 2** | Cline, Continue, Roo Code, JetBrains AI, Amazon Q, Zed, Aider, CodeRabbit, Cody, Tabnine |
+| **Tier 3** | Amp, OpenCode, Augment                                                                   |
+
+---
 
-| Tier       | IDEs                                                                                                    |
-| :--------- | :------------------------------------------------------------------------------------------------------ |
-| **Tier 0** | Codex                                                                                                   |
-| **Tier 1** | Cursor, Claude Code, Gemini CLI, Antigravity, VS Code + Copilot, Windsurf                               |
-| **Tier 2** | Cline, Continue, Roo Code, JetBrains AI, Amazon Q, Kiro, Zed, Aider, CodeRabbit, Cody, Tabnine, Trae AI |
-| **Tier 3** | Amp, OpenCode, Augment                                                                                  |
+## 🎭 Personas (12)
+
+| Persona         | Role                        | Trigger       |
+| :-------------- | :-------------------------- | :------------ |
+| 🔧 Developer    | Full-stack implementation   | `/code`       |
+| 🏗️ Architect    | System design & patterns    | `/design`     |
+| 🔬 Auditor      | 5-expert audit panel        | `/ap`         |
+| 🐛 Debugger     | Root cause analysis         | `/debug`      |
+| ✅ Tester       | Testing & coverage          | `/test`       |
+| 🚀 DevOps       | Infrastructure & deployment | `/deploy`     |
+| 📚 Documenter   | Documentation specialist    | `/doc`        |
+| 📋 Planner      | Task decomposition          | `/plan`       |
+| 🔍 Researcher   | Investigation & research    | `/find`       |
+| 🎭 Orchestrator | Multi-agent coordination    | Complex tasks |
+| 🔒 Security     | Security analysis           | `/security`   |
+| 💡 Thinker      | Deep reasoning (6 methods)  | `/think`      |
 
 ---
 
-## 🔍 MCP Server & Dashboard
+## 🔍 HSA MCP Server (13 Tools)
 
-HSA MCP Server provides intelligent context to your AI IDE — semantic search, code graph analysis, and project understanding.
+Intelligent context engine with BM25 search, Merkle tree change detection, and web dashboard.
 
 ```bash
 nock awf mcp install --ide all      # Configure for all IDEs
-nock awf mcp install --ide cursor   # Specific IDE
+nock awf hsa start                  # Start HSA server
 ```
 
-**Web Dashboard** is enabled by default at `http://localhost:13100/dashboard` — real-time project monitoring, tool call logs, and cache stats.
+| Tool                     | Description                            |
+| :----------------------- | :------------------------------------- |
+| `hsa_get_context`        | Retrieve optimized context for LLM     |
+| `hsa_detect_stack`       | Detect project tech stack              |
+| `hsa_get_agent_config`   | Load commands, personas, rules, skills |
+| `hsa_check_changes`      | Check file changes via Merkle diff     |
+| `hsa_prefetch`           | Prefetch context for predicted queries |
+| `hsa_status`             | Engine health and cache stats          |
+| `hsa_search_skills`      | BM25 search across skill patterns      |
+| `hsa_get_snapshot`       | Project structure snapshot             |
+| `hsa_get_repo_map`       | Repository structure map               |
+| `hsa_export`             | Export context as portable format      |
+| `hsa_detect_environment` | Detect runtime environment             |
+| `hsa_prepare_handoff`    | Prepare context for agent handoff      |
+| `hsa_filter_tools`       | Filter available tools by context      |
+
+**Web Dashboard** at `http://localhost:13100/dashboard` — real-time monitoring, tool call logs, and cache stats.
 
 ---
 
@@ -89,5 +133,5 @@ nock awf mcp install --ide cursor   # Specific IDE
 MIT © [**NockDev**](https://github.com/nockasdd)
 
 <p align="center">
-  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:8B5CF6,100:1E40AF&height=100&section=footer" width="100%" />
+  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:8B5CF6,50:1E40AF,100:0F172A&height=100&section=footer" width="100%" />
 </p>

package/configs/aider/root.CONVENTIONS.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/amazonq/root.amazonq.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/amp/root.AGENTS.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/antigravity/root.GEMINI.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `~/.gemini/antigravity/skills/` (global) or `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/augment/root.guidelines.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/claude/root.CLAUDE.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.claude/skills/` (project) or `~/.claude/skills/` (global)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/cline/root.clinerules.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/codex/root.AGENTS.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/continue/root.continue.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/copilot/root.copilot-instructions.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/gemini/root.GEMINI.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.gemini/skills/` (project) or `~/.gemini/skills/` (global)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/jetbrains/root.guidelines.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/roo/root.roorules.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/tabnine/root.guidelines.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/configs/vscode/root.copilot-instructions.md

@@ -37,7 +37,7 @@ Developer · Architect · Auditor · Debugger · Tester · DevOps · Documenter
 META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive)
 Skills location: `.agent/skills/` (project)
 
-## MCP Tools (HSA v1.0.2)
+## MCP Tools (HSA v1.1.0)
 
 | Tool                     | Purpose                                 |
 | ------------------------ | --------------------------------------- |

package/dist/constants/ide-install-specs.js

@@ -1,7 +1,7 @@
 // packages/plugin-awf/src/constants/ide-install-specs.ts
 // IDE Installation Specifications - Deep Audit v2 corrections applied
 // version: 6.2.3 (Feb 7, 2026)
-// Phase 3: Aligned 20 spec gaps with Feature Matrix v6.2.3
+// Phase 3: Aligned 20 spec gaps with Feature Matrix v6.2.4
 import { DISABLED_SPEC } from "../types/ide-install.js";
 // ============================================================================
 // TIER 1: Major IDEs (6)

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.3";
+export declare const AWF_VERSION = "6.2.4";
 /**
  * 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.3";
+export const AWF_VERSION = "6.2.4";
 /**
  * Plugin name
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nockdev/awf",
-  "version": "6.2.3",
+  "version": "6.2.4",
   "description": "DOMYH Awesome Code - AI Development Assistant with 82 Skills",
   "type": "module",
   "main": "dist/index.js",