@nockdev/awf 6.2.0 → 6.2.1

package/.agent/skills/tooling/browser-agent/data/verification-flow.yaml

@@ -0,0 +1,209 @@
+# =============================================================================
+# verification-flow.yaml — 5-Phase Comprehensive Browser Verification Flow
+# =============================================================================
+
+version: "1.0.0"
+
+phases:
+  - phase: 1
+    name: "Page Load Verification"
+    goal: "Ensure page loads correctly without errors"
+    steps:
+      - step: "Navigate to URL"
+        tool: browser_navigate
+        args: { url: "{target_url}" }
+        verify: "Response status 200"
+
+      - step: "Wait for network idle"
+        tool: browser_wait_for
+        args: { time: 3 }
+        verify: "All resources loaded"
+
+      - step: "Check console errors"
+        tool: browser_console_messages
+        args: { level: "error" }
+        verify: "No JavaScript errors"
+        on_error: "Log errors, continue testing"
+
+      - step: "Capture baseline screenshot"
+        tool: browser_take_screenshot
+        args: { type: "png", fullPage: true }
+        verify: "Page renders correctly"
+
+      - step: "Capture accessibility snapshot"
+        tool: browser_snapshot
+        args: {}
+        verify: "Page structure readable"
+    expected_output: "Page loaded, no errors, baseline captured"
+    failure_handling: "If page fails to load, report immediately and stop"
+
+  - phase: 2
+    name: "Interactive Element Discovery"
+    goal: "Find ALL interactive elements from accessibility tree"
+    steps:
+      - step: "Parse accessibility tree from Phase 1 snapshot"
+        action: "Identify all interactive elements"
+        categories:
+          buttons: "role=button — count and list names"
+          links: "role=link — count and list destinations"
+          inputs: "role=textbox, role=searchbox — count and list labels"
+          selects: "role=combobox, role=listbox — count dropdown menus"
+          checkboxes: "role=checkbox, role=switch — count toggles"
+          tabs: "role=tab — count tab panels"
+          custom: "data-role, aria-haspopup — custom interactive elements"
+        verify: "All interactive elements identified"
+
+      - step: "Identify compound components"
+        action: "Look for complex UI patterns"
+        patterns:
+          modals: "Elements with aria-haspopup=dialog or modal trigger buttons"
+          accordions: "Elements with aria-expanded attribute"
+          menus: "Elements with aria-haspopup=menu"
+          tooltips: "Elements with aria-describedby pointing to hidden content"
+          carousels: "Elements with role=region and navigation controls"
+
+      - step: "Generate test plan"
+        action: "Create ordered list of elements to test"
+        priority: "Critical (forms, modals) → High (dropdowns, buttons) → Medium (tooltips, hovers)"
+
+    expected_output: "Complete element inventory with test priority"
+    failure_handling: "If no interactive elements found, verify page loaded correctly"
+
+  - phase: 3
+    name: "Systematic Interaction Testing"
+    goal: "Test EACH discovered element according to its type"
+
+    by_element_type:
+      button:
+        tests:
+          - test: "Click performs expected action"
+            tool: browser_click
+            verify: "browser_snapshot shows state change"
+          - test: "Disabled state not clickable"
+            tool: browser_snapshot
+            verify: "Disabled attribute present"
+          - test: "Loading state on action"
+            tool: browser_click
+            verify: "Loading indicator shown"
+
+      dropdown:
+        tests:
+          - test: "Click opens option list"
+            tool: browser_click
+            verify: "browser_snapshot shows options visible"
+          - test: "Select option updates value"
+            tool: browser_select_option
+            verify: "browser_snapshot shows selected value"
+          - test: "Escape closes dropdown"
+            tool: browser_press_key
+            args: { key: "Escape" }
+            verify: "browser_snapshot shows dropdown closed"
+
+      modal:
+        tests:
+          - test: "Trigger opens modal"
+            tool: browser_click
+            verify: "browser_snapshot shows dialog role"
+          - test: "Escape closes modal"
+            tool: browser_press_key
+            args: { key: "Escape" }
+            verify: "browser_snapshot shows modal gone"
+          - test: "Focus trapped inside"
+            tool: browser_press_key
+            args: { key: "Tab" }
+            verify: "Focus stays within dialog"
+            repeat: 10
+
+      form:
+        tests:
+          - test: "Fill all fields"
+            tool: browser_fill_form
+            verify: "All fields contain values"
+          - test: "Submit form"
+            tool: browser_click
+            verify: "Success state or redirect"
+          - test: "Empty submit shows validation"
+            tool: browser_click
+            verify: "Error messages visible"
+
+      hover:
+        tests:
+          - test: "Hover shows tooltip/menu"
+            tool: browser_hover
+            verify: "browser_snapshot shows hover content"
+          - test: "Keyboard focus shows same state"
+            tool: browser_press_key
+            args: { key: "Tab" }
+            verify: "Same content visible as hover"
+
+    expected_output: "Per-element pass/fail status"
+    failure_handling: "Log failure details, continue to next element"
+
+  - phase: 4
+    name: "Accessibility & Edge Cases"
+    goal: "Verify keyboard navigation, errors, and responsiveness"
+    steps:
+      - step: "Keyboard navigation"
+        tool: browser_press_key
+        action: "Tab through all elements"
+        verify: "All interactive elements reachable via Tab key"
+
+      - step: "Focus visibility"
+        tool: browser_take_screenshot
+        action: "Tab to element and screenshot"
+        verify: "Visible focus indicator on each element"
+
+      - step: "Console error check (post-interaction)"
+        tool: browser_console_messages
+        args: { level: "error" }
+        verify: "No new errors introduced during testing"
+
+      - step: "Network request check"
+        tool: browser_network_requests
+        args: { includeStatic: false }
+        verify: "No 4xx/5xx responses, no CORS errors"
+
+      - step: "Mobile responsive"
+        tool: browser_resize
+        args: { width: 375, height: 812 }
+        verify: "Layout correct, no overflow, elements accessible"
+        then:
+          - tool: browser_snapshot
+            verify: "All elements still discoverable"
+          - tool: browser_take_screenshot
+            verify: "Visual check mobile layout"
+
+    expected_output: "Accessibility and edge case results"
+    failure_handling: "Document issues with evidence"
+
+  - phase: 5
+    name: "Evidence-Based Report"
+    goal: "Compile comprehensive test results"
+    output:
+      summary_table:
+        format: |
+          | Element | Type | Test | Status | Evidence |
+          |---------|------|------|--------|----------|
+          | Submit button | button | click action | ✅ PASS | screenshot_1 |
+          | Country select | dropdown | open/select | ❌ FAIL | screenshot_2 |
+        required_columns: ["element", "type", "test", "status", "evidence"]
+
+      issues_list:
+        format: |
+          ### Issue 1: [Element Name]
+          - **Expected**: Dropdown opens on click
+          - **Actual**: Nothing happens
+          - **Severity**: Critical
+          - **Evidence**: [screenshot]
+
+      metrics:
+        total_elements: "Count of all interactive elements"
+        tests_passed: "Count of passed tests"
+        tests_failed: "Count of failed tests"
+        coverage: "tests_passed / (tests_passed + tests_failed) * 100"
+        console_errors: "Count of JS errors"
+        network_failures: "Count of 4xx/5xx requests"
+
+    expected_output: "Complete test report with evidence"
+
+# _DOMYH Awesome Code • 5-Phase Verification Flow v1.0.0_

package/.agent/skills/tooling/cli-dev/META.yaml

@@ -0,0 +1,55 @@
+name: cli-dev
+version: "1.0.0"
+display: CLI Tool Development
+category: tooling
+tier: 1
+priority: 3
+
+desc: "Production CLI tools with progressive discovery, subcommands, structured output, interactive prompts, and cross-platform support. Covers commander.js, clap (Rust), cobra (Go), Click (Python)."
+
+triggers:
+  file_patterns:
+    - "cli.ts"
+    - "cli.js"
+    - "cli/**"
+    - "bin/**"
+  keywords:
+    - CLI tool
+    - command line tool
+    - commander
+    - commander.js
+    - clap
+    - clap crate
+    - cobra
+    - cobra command
+    - argparse
+    - Click python
+    - interactive CLI
+    - terminal UI
+    - TUI
+    - Inquirer.js
+    - clack
+    - chalk
+    - ora
+    - ink react
+
+caps:
+  - Progressive discovery UX (help → suggest → auto)
+  - Subcommand architecture
+  - Structured output (JSON/YAML/table)
+  - Interactive prompts (Inquirer.js, clack, dialoguer)
+  - Cross-platform compatibility
+  - Error handling & exit codes
+  - Configuration (env + config files + defaults)
+  - AI-augmented CLI patterns
+
+related_skills:
+  - typescript
+  - go
+  - rust
+  - python
+
+hsa_adapter:
+  enabled: true
+  data_dir: "skills/tooling/cli-dev/data"
+  preload_data: false

package/.agent/skills/tooling/cli-dev/SKILL.md

@@ -0,0 +1,83 @@
+# CLI Tool Development
+
+> Progressive Discovery • Subcommands • Structured Output  
+> commander.js • clap • cobra • Click
+
+---
+
+## Khi Nào Dùng
+
+- Build CLI tool cho developer (dev tooling)
+- Interactive terminal applications
+- Tạo CLI wrapper cho API/service
+
+## Framework Selection
+
+| Framework        | Language   | Strengths                           |
+| ---------------- | ---------- | ----------------------------------- |
+| **commander.js** | Node.js/TS | Simple, widely used, npm ecosystem  |
+| **clap**         | Rust       | Type-safe, derive macros, fast      |
+| **cobra**        | Go         | Subcommands, auto-docs, completions |
+| **Click**        | Python     | Decorators, composable, testable    |
+| **clack**        | Node.js    | Beautiful interactive prompts       |
+
+## Core Patterns
+
+### Progressive Discovery UX
+
+```
+Level 1: mycli              → Show help + suggest commands
+Level 2: mycli --help       → Detailed help with examples
+Level 3: mycli <cmd> --help → Command-specific help
+Level 4: mycli suggest      → AI-powered suggestions
+```
+
+### Structured Output
+
+```typescript
+// Support multiple formats
+if (flags.format === "json") {
+  console.log(JSON.stringify(data, null, 2));
+} else if (flags.format === "yaml") {
+  console.log(yaml.stringify(data));
+} else {
+  console.log(table(data)); // Pretty table for humans
+}
+```
+
+### Exit Codes
+
+| Code | Meaning                  |
+| ---- | ------------------------ |
+| 0    | Success                  |
+| 1    | General error            |
+| 2    | Usage error (wrong args) |
+| 130  | Interrupted (Ctrl+C)     |
+
+### Error Handling
+
+```typescript
+try {
+  await command.execute();
+} catch (err) {
+  if (err instanceof UsageError) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    console.log(chalk.dim("Run --help for usage"));
+    process.exit(2);
+  }
+  console.error(chalk.red(`Fatal: ${err.message}`));
+  process.exit(1);
+}
+```
+
+## Common Traps
+
+| Trap                  | Fix                                         |
+| --------------------- | ------------------------------------------- |
+| No colors in CI       | Detect CI env, disable colors automatically |
+| Global install issues | Use `npx` or `bunx` for zero-install        |
+| No completions        | Add shell completion generator              |
+
+---
+
+_DOMYH Awesome Code • CLI Dev Skill v1.0.0_

package/.agent/skills/tooling/cli-dev/data/frameworks.yaml

@@ -0,0 +1,128 @@
+# CLI Frameworks Comparison — HSA Tier 3 Data
+version: "1.0.0"
+
+patterns:
+  - id: CLI-FW-001
+    name: commander.js
+    category: node
+    description: Node.js/TypeScript CLI framework.
+    text: |
+      Strengths: Widely used, mature, npm ecosystem
+      Weaknesses: Manual type inference
+    example: |
+      import { Command } from "commander";
+
+      const program = new Command()
+        .name("mycli")
+        .version("1.0.0")
+        .description("My CLI tool");
+
+      program.command("init <name>")
+        .description("Initialize project")
+        .option("-t, --template <template>", "Template", "default")
+        .option("--no-git", "Skip git init")
+        .action((name, options) => {
+          console.log(`Creating ${name} with template ${options.template}`);
+        });
+
+      program.parse();
+
+  - id: CLI-FW-002
+    name: clap (Rust)
+    category: rust
+    description: Rust CLI framework with derive macros.
+    text: |
+      Strengths: Type-safe, derive macros, fast compile-time validation
+      Weaknesses: Rust-only
+    example: |
+      use clap::{Parser, Subcommand};
+
+      #[derive(Parser)]
+      #[command(name = "mycli", version, about)]
+      struct Cli {
+        #[command(subcommand)]
+        command: Commands,
+        #[arg(short, long)]
+        verbose: bool,
+      }
+
+      #[derive(Subcommand)]
+      enum Commands {
+        Init { name: String, #[arg(short, long, default_value = "default")] template: String },
+        Build { #[arg(long)] release: bool },
+      }
+
+      fn main() {
+        let cli = Cli::parse();
+        match cli.command {
+          Commands::Init { name, template } => println!("Init {name} with {template}"),
+          Commands::Build { release } => println!("Building (release: {release})"),
+        }
+      }
+
+  - id: CLI-FW-003
+    name: cobra (Go)
+    category: go
+    description: Go CLI framework with auto-generated docs.
+    text: |
+      Strengths: Subcommands, auto shell completion, auto docs
+      Weaknesses: Verbose setup
+    example: |
+      var rootCmd = &cobra.Command{
+        Use:   "mycli",
+        Short: "My CLI tool",
+      }
+
+      var initCmd = &cobra.Command{
+        Use:   "init [name]",
+        Short: "Initialize project",
+        Args:  cobra.ExactArgs(1),
+        Run: func(cmd *cobra.Command, args []string) {
+          template, _ := cmd.Flags().GetString("template")
+          fmt.Printf("Creating %s with %s\n", args[0], template)
+        },
+      }
+
+      func init() {
+        initCmd.Flags().StringP("template", "t", "default", "Template to use")
+        rootCmd.AddCommand(initCmd)
+      }
+
+  - id: CLI-FW-004
+    name: Click (Python)
+    category: python
+    description: Python CLI with decorator-based API.
+    example: |
+      import click
+
+      @click.group()
+      @click.version_option("1.0.0")
+      def cli():
+          """My CLI tool"""
+          pass
+
+      @cli.command()
+      @click.argument("name")
+      @click.option("--template", "-t", default="default", help="Template")
+      def init(name, template):
+          """Initialize project"""
+          click.echo(f"Creating {name} with {template}")
+
+      if __name__ == "__main__":
+          cli()
+
+  - id: CLI-FW-005
+    name: Framework Comparison
+    category: comparison
+    description: |
+      Side-by-side framework comparison.
+    text: |
+      | Feature | commander.js | clap | cobra | Click |
+      |---------|-------------|------|-------|-------|
+      | Language | Node.js/TS | Rust | Go | Python |
+      | Type safety | Manual | Compile-time | Runtime | Runtime |
+      | Subcommands | ✅ | ✅ | ✅ | ✅ |
+      | Auto-complete | Plugin | Built-in | Built-in | Plugin |
+      | Auto docs | ❌ | ✅ | ✅ Man pages | ❌ |
+      | Testing | Unit tests | Integration | Test helpers | CliRunner |
+      | Ecosystem | npm | crates.io | Go modules | PyPI |

package/.agent/skills/tooling/cli-dev/data/output-formats.yaml

@@ -0,0 +1,58 @@
+# CLI Output Formats — HSA Tier 3 Data
+version: "1.0.0"
+
+patterns:
+  - id: CLI-OUT-001
+    name: Structured Output
+    category: output
+    description: |
+      Support multiple output formats.
+    example: |
+      function output(data: unknown, format: string) {
+        switch (format) {
+          case "json": console.log(JSON.stringify(data, null, 2)); break;
+          case "yaml": console.log(yaml.stringify(data)); break;
+          case "csv": console.log(toCSV(data)); break;
+          case "table": default: console.log(renderTable(data)); break;
+        }
+      }
+
+      program.option("--format <format>", "Output format", "table");
+
+  - id: CLI-OUT-002
+    name: Exit Codes
+    category: output
+    description: |
+      Standard exit codes for CLI tools.
+    text: |
+      | Code | Meaning | When |
+      |------|---------|------|
+      | 0 | Success | Normal completion |
+      | 1 | General error | Runtime errors |
+      | 2 | Usage error | Invalid args/options |
+      | 126 | Not executable | Permission denied |
+      | 127 | Not found | Command not found |
+      | 130 | Interrupted | Ctrl+C (SIGINT) |
+
+  - id: CLI-OUT-003
+    name: Progress Indicators
+    category: output
+    description: |
+      Show progress for long-running operations.
+    example: |
+      import ora from "ora";
+      import cliProgress from "cli-progress";
+
+      // Spinner
+      const spinner = ora("Processing...").start();
+      await doWork();
+      spinner.succeed("Done!");
+
+      // Progress bar
+      const bar = new cliProgress.SingleBar();
+      bar.start(100, 0);
+      for (let i = 0; i <= 100; i++) {
+        bar.update(i);
+        await sleep(50);
+      }
+      bar.stop();

package/.agent/skills/tooling/cli-dev/data/ux-patterns.yaml

@@ -0,0 +1,97 @@
+# CLI UX Patterns — HSA Tier 3 Data
+version: "1.0.0"
+
+patterns:
+  - id: CLI-UX-001
+    name: Progressive Discovery
+    category: ux
+    description: |
+      Guide users from beginner to expert progressively.
+    text: |
+      Level 1: mycli → Show help + suggest commands
+      Level 2: mycli --help → Detailed help with examples
+      Level 3: mycli <cmd> --help → Command-specific help
+      Level 4: mycli suggest → AI-powered context suggestions
+      Level 5: mycli --verbose → Expert debug output
+
+  - id: CLI-UX-002
+    name: Color and Formatting
+    category: ux
+    description: |
+      Use colors, icons, and formatting for readability.
+    text: |
+      Libraries:
+      - chalk (Node.js): Color output
+      - ora (Node.js): Spinners
+      - cli-table3: Tables
+      - boxen: Boxed messages
+      Rules:
+      - Detect NO_COLOR env and CI environments
+      - Use stderr for progress, stdout for data
+      - Use emoji/icons sparingly (✓ ✗ ⚠ ℹ)
+
+  - id: CLI-UX-003
+    name: Interactive Prompts
+    category: ux
+    description: |
+      Interactive input with validation.
+    text: |
+      Libraries:
+      - @clack/prompts: Beautiful, modern prompts
+      - Inquirer.js: Feature-rich
+      - prompts: Lightweight
+    example: |
+      import { intro, select, text, confirm, outro } from "@clack/prompts";
+
+      intro("Welcome to MyTool");
+      const name = await text({ message: "Project name?", validate: (v) => v.length < 1 ? "Required" : undefined });
+      const framework = await select({ message: "Framework?", options: [
+        { value: "react", label: "React" },
+        { value: "vue", label: "Vue" },
+      ]});
+      const proceed = await confirm({ message: "Create project?" });
+      outro("Done!");
+
+  - id: CLI-UX-004
+    name: Help Formatting
+    category: ux
+    description: |
+      Well-formatted help output.
+    text: |
+      Structure:
+      USAGE: mycli <command> [options]
+
+      COMMANDS:
+        init      Initialize project
+        build     Build project
+        deploy    Deploy to production
+
+      OPTIONS:
+        -v, --verbose    Verbose output
+        -h, --help       Show help
+        --no-color       Disable colors
+
+      EXAMPLES:
+        $ mycli init my-project --template react
+        $ mycli deploy --env production
+
+  - id: CLI-UX-005
+    name: Error Display
+    category: ux
+    description: |
+      User-friendly error messages.
+    example: |
+      import chalk from "chalk";
+
+      function displayError(err: CLIError) {
+        console.error();
+        console.error(chalk.red.bold("Error:"), err.message);
+        if (err.suggestion) {
+          console.error(chalk.dim("Suggestion:"), err.suggestion);
+        }
+        if (err.docs) {
+          console.error(chalk.dim("Docs:"), chalk.underline(err.docs));
+        }
+        console.error();
+        process.exit(err.code || 1);
+      }

package/.agent/skills/tooling/ide-extension/META.yaml

@@ -0,0 +1,72 @@
+name: ide-extension
+version: "1.0.0"
+display: IDE Extension Development
+category: tooling
+tier: 1
+priority: 2
+
+desc: "Multi-IDE extension development. VS Code (Extension Host, Contribution Points, LSP, DAP), JetBrains (IntelliJ Plugin SDK, PSI), Neovim (Lua API, lazy.nvim). Cross-platform patterns."
+
+  ### Data Files (3 domains, ~21 patterns)
+  - vscode-patterns.yaml: Extension Host, contribution points, webview (8)
+  - lsp-patterns.yaml: Language Server Protocol, diagnostics, code actions (7)
+  - jetbrains-patterns.yaml: Plugin SDK, PSI, remote dev (6)
+
+triggers:
+  file_patterns:
+    # VS Code
+    - "extension.ts"
+    - "extension.js"
+    - "*.vsix"
+    - ".vscode/launch.json"
+    - "**/contributes/**"
+    # JetBrains
+    - "plugin.xml"
+    - "build.gradle.kts:intellij"
+    # Neovim
+    - "lua/*/init.lua"
+    - "plugin/**/*.vim"
+  keywords:
+    - vscode extension
+    - vs code extension
+    - jetbrains plugin
+    - intellij plugin
+    - neovim plugin
+    - neovim lua
+    - language server
+    - LSP
+    - language server protocol
+    - DAP
+    - debug adapter
+    - activation events
+    - contribution points
+    - webview
+    - Extension Host
+    - extension development host
+    - vscode api
+    - TextDocument
+    - CompletionProvider
+    - DiagnosticCollection
+
+caps:
+  - VS Code Extension Host architecture (isolated process)
+  - package.json contribution points (commands, views, keybindings)
+  - Activation events (onLanguage, onCommand, workspaceContains)
+  - Language Server Protocol (LSP) implementation
+  - Debug Adapter Protocol (DAP) implementation
+  - Webview panels (React/Vue in VS Code sidebar/editor)
+  - JetBrains IntelliJ Plugin SDK 2.x
+  - PSI (Program Structure Interface) tree traversal
+  - Neovim Lua 5.1 plugin architecture
+  - lazy.nvim plugin management
+  - Extension testing (Extension Development Host)
+  - Publishing (VSIX, JetBrains Marketplace, Neovim package managers)
+
+related_skills:
+  - typescript
+  - mcp
+
+hsa_adapter:
+  enabled: true
+  data_dir: "skills/tooling/ide-extension/data"
+  preload_data: true