@nockdev/awf 6.2.0

package/.agent/core/MEMORY_PATHS.yaml

@@ -0,0 +1,79 @@
+# DOMYH Awesome Code — Memory Paths v6.2.0
+# Single Source of Truth for all memory file paths
+# Eliminates 16 duplicate path definitions across config files
+
+version: "6.1.2"
+engine: memory_paths
+
+# =============================================================================
+# CORE MEMORY PATHS
+# =============================================================================
+
+paths:
+  # Layer 1: Working Memory (always in context)
+  working:
+    session_cache: core/session_cache.json
+
+  # Layer 2: Session Memory
+  session:
+    notes: memory/session.md
+
+  # Layer 3: State Memory
+  state:
+    decisions: memory/decisions.md
+    project_state: memory/state.json
+    audit_summary: memory/audit_summary.json
+
+  # Layer 4: Semantic Memory
+  semantic:
+    vectors: memory/vectors/
+
+  # Active Memory
+  active:
+    memories: memory/active_memories.json
+    insights: memory/insights.md
+    consolidated: memory/consolidated.md
+
+# =============================================================================
+# ARCHIVE PATHS
+# =============================================================================
+
+archive:
+  base: memory/archive/
+  subdirs:
+    sessions: memory/archive/sessions/
+    errors: memory/archive/errors/
+    decisions: memory/archive/decisions/
+    audits: memory/archive/audits/
+    phases: memory/archive/phases/
+    vectors: memory/archive/vectors/
+    consolidation: memory/archive/consolidation/
+    forgotten: memory/archive/forgotten/
+
+# =============================================================================
+# LOG PATHS
+# =============================================================================
+
+logs:
+  cleanup: memory/cleanup_log.json
+  metrics: memory/metrics.json
+  consolidation: memory/consolidation_log.json
+
+# =============================================================================
+# USAGE (How other files reference this)
+# =============================================================================
+
+usage:
+  reference: "core/MEMORY_PATHS.yaml"
+  import_pattern: |
+    # In other config files:
+    paths:
+      reference: core/MEMORY_PATHS.yaml
+      # Use: paths.session.notes, paths.archive.sessions, etc.
+
+  examples:
+    - "MEMORY_ENGINE.yaml → archive.base"
+    - "CONTEXT_INJECTOR.yaml → paths.session.notes"
+    - "CLEANUP_ENGINE.yaml → archive.sessions"
+    - "SUMMARIZATION_ENGINE.yaml → archive.sessions"
+    - "SEMANTIC_ENGINE.yaml → paths.semantic.vectors"

package/.agent/core/MEMORY_UTILS.yaml

@@ -0,0 +1,212 @@
+# DOMYH Awesome Code — Memory Utilities v6.2.0
+# Helper commands for memory management
+
+# =============================================================================
+# MEMORY COMMANDS
+# =============================================================================
+
+commands:
+  # View current memory state
+  memory_status:
+    trigger: ["/memory", "/mem status"]
+    description: "View current memory usage and state"
+    action:
+      - read: core/session_cache.json
+      - calculate: tokens_estimate
+      - display:
+          format: table
+          fields:
+            - layer
+            - tokens
+            - status
+            - last_updated
+
+  # Force save all memory
+  memory_save:
+    trigger: ["/mem save", "/save memory"]
+    description: "Force save all memory layers"
+    action:
+      - save: [session.md, state.json, decisions.md, audit_summary.json]
+      - update: session_cache.json
+      - notify: "Memory saved to all layers"
+
+  # Clear session memory
+  memory_clear:
+    trigger: ["/mem clear", "/clear session"]
+    description: "Clear current session memory (archive first)"
+    action:
+      - archive: session.md → archive/sessions/
+      - reset: session.md
+      - update: session_cache.json
+      - notify: "Session memory cleared and archived"
+
+  # View decision history
+  memory_decisions:
+    trigger: ["/mem decisions", "/decisions"]
+    description: "View recent decisions"
+    action:
+      - read: memory/decisions.md
+      - display: last 10 entries
+
+  # View audit history
+  memory_audits:
+    trigger: ["/mem audits", "/audit history"]
+    description: "View audit history summary"
+    action:
+      - read: memory/audit_summary.json
+      - display: formatted summary
+
+  # Compact memory
+  memory_compact:
+    trigger: ["/mem compact", "/compact"]
+    description: "Trigger manual memory compaction"
+    action:
+      - trigger: summarization.medium
+      - notify: "Memory compacted"
+
+  # Export memory
+  memory_export:
+    trigger: ["/mem export"]
+    description: "Export all memory to single file"
+    action:
+      - merge: [session.md, decisions.md, state.json]
+      - export: memory/export_{timestamp}.md
+      - notify: "Memory exported"
+
+# =============================================================================
+# MEMORY STATUS DISPLAY TEMPLATE
+# =============================================================================
+
+status_template: |
+  ## 🧠 Memory Status
+
+  | Layer | Status | Tokens | Last Updated |
+  |-------|--------|--------|--------------|
+  | Working | {working_status} | ~{working_tokens} | Always |
+  | Session | {session_status} | ~{session_tokens} | {session_updated} |
+  | State | {state_status} | ~{state_tokens} | {state_updated} |
+  | Semantic | {semantic_status} | ~{semantic_tokens} | {semantic_updated} |
+
+  **Total Estimate**: ~{total_tokens} tokens ({percentage}% of limit)
+
+  ### Session Info
+  - **Started**: {session_start}
+  - **Interactions**: {interaction_count}
+  - **Workflows Run**: {workflow_count}
+  - **Decisions Made**: {decision_count}
+
+  ### Cleanup Status
+  - **Last Cleanup**: {last_cleanup}
+  - **Next Trigger**: {next_trigger}
+  - **Token Threshold**: {threshold_status}
+
+# =============================================================================
+# HANDOFF GENERATION
+# =============================================================================
+
+handoff:
+  # Generate handoff document for session continuity
+  template: |
+    # Session Handoff
+
+    **Date**: {date}
+    **Session ID**: {session_id}
+    **Project**: {project_path}
+
+    ## Current Task
+    {current_task}
+
+    ## Context Summary
+    {context_summary}
+
+    ## Pending Actions
+    {pending_actions}
+
+    ## Key Decisions Made
+    {recent_decisions}
+
+    ## Files Changed
+    {files_changed}
+
+    ## Errors/Blockers
+    {errors_blockers}
+
+    ## Resume Instructions
+    1. Run `/recap` to load context
+    2. Review pending actions above
+    3. Continue with: `{suggested_next_command}`
+
+    ---
+    _Generated by DOMYH Awesome Code Memory System_
+
+  generate_on:
+    - session_end
+    - emergency_cleanup
+    - agent_switch
+
+  save_to: memory/handoff_{timestamp}.md
+
+# =============================================================================
+# MEMORY METRICS
+# =============================================================================
+
+metrics:
+  # Track memory usage over time
+  track:
+    - tokens_by_layer
+    - compression_ratio
+    - cleanup_frequency
+    - decision_count
+    - audit_count
+    - session_duration
+
+  # Store metrics
+  storage:
+    file: memory/metrics.json
+    max_entries: 100
+    roll_after: 7 days
+
+  # Calculate trends
+  trends:
+    - average_session_tokens
+    - cleanup_trigger_rate
+    - memory_efficiency_score
+
+# =============================================================================
+# INTEGRATION WITH WORKFLOWS
+# =============================================================================
+
+workflow_hooks:
+  # Before any workflow starts
+  pre_workflow:
+    - load_relevant_memory
+    - check_pending_from_state
+    - restore_error_context
+
+  # After any workflow completes
+  post_workflow:
+    - save_workflow_outcome
+    - update_session_notes
+    - check_cleanup_triggers
+
+  # Workflow-specific hooks
+  specific:
+    /recap:
+      pre: [load_all_memory_layers]
+      post: [update_session_timestamp]
+
+    /ap:
+      pre: [load_previous_audit]
+      post: [save_audit_summary, log_audit_decision]
+
+    /code:
+      pre: [load_recent_decisions]
+      post: [save_code_decisions, update_files_changed]
+
+    /debug:
+      pre: [load_error_patterns]
+      post: [archive_resolved_error, log_resolution]
+
+    /deploy:
+      pre: [load_deployment_state]
+      post: [save_deployment_log, update_version]

package/.agent/core/PATTERNS.yaml

@@ -0,0 +1,319 @@
+# DOMYH Awesome Code — Shared Patterns Library
+# Version: 5.5
+# Purpose: Reduce token duplication across workflows
+
+# =============================================================================
+# PHASE FLOW PATTERNS
+# =============================================================================
+
+phase_flows:
+  # Standard 5-phase flow (most common)
+  standard_5:
+    phases: [DETECT, ANALYZE, EXECUTE, VERIFY, REPORT]
+    icons: ["🔍", "📊", "⚡", "✅", "📋"]
+    stop_points: [ANALYZE, EXECUTE]
+
+  # Planning flow
+  planning_5:
+    phases: [UNDERSTAND, ANALYZE, DESIGN, BREAKDOWN, VALIDATE]
+    icons: ["🎯", "📊", "✏️", "📋", "✅"]
+    stop_points: [DESIGN, VALIDATE]
+
+  # Audit flow
+  audit_4:
+    phases: [DISCOVER, ANALYZE, REPORT, RECOMMEND]
+    icons: ["🔍", "📊", "📋", "💡"]
+    stop_points: [REPORT]
+
+  # Quick flow (utility commands)
+  quick_3:
+    phases: [COLLECT, PROCESS, OUTPUT]
+    icons: ["📥", "⚙️", "📤"]
+    stop_points: []
+
+# =============================================================================
+# STACK DETECTION PATTERNS
+# =============================================================================
+
+stack_detection:
+  # Node.js/TypeScript
+  nodejs:
+    files: ["package.json", "tsconfig.json", "node_modules"]
+    extensions: [".ts", ".tsx", ".js", ".jsx"]
+    package_managers: ["npm", "yarn", "pnpm", "bun"]
+
+  # Go
+  golang:
+    files: ["go.mod", "go.sum", "main.go"]
+    extensions: [".go"]
+    commands: ["go"]
+
+  # Python
+  python:
+    files: ["requirements.txt", "pyproject.toml", "setup.py", "Pipfile"]
+    extensions: [".py"]
+    package_managers: ["pip", "poetry", "pipenv", "uv"]
+
+  # Rust
+  rust:
+    files: ["Cargo.toml", "Cargo.lock"]
+    extensions: [".rs"]
+    commands: ["cargo"]
+
+  # Java
+  java:
+    files: ["pom.xml", "build.gradle", "build.gradle.kts"]
+    extensions: [".java", ".kt"]
+    build_tools: ["maven", "gradle"]
+
+  # .NET
+  dotnet:
+    files: ["*.csproj", "*.sln", "*.fsproj"]
+    extensions: [".cs", ".fs"]
+    commands: ["dotnet"]
+
+  # PHP
+  php:
+    files: ["composer.json", "composer.lock"]
+    extensions: [".php"]
+    commands: ["composer"]
+
+  # Ruby
+  ruby:
+    files: ["Gemfile", "Gemfile.lock", "*.gemspec"]
+    extensions: [".rb"]
+    commands: ["bundle", "gem"]
+
+# =============================================================================
+# STOP CONDITIONS
+# =============================================================================
+
+stop_conditions:
+  # Always stop
+  critical:
+    - "Before destructive operations (delete, drop, reset)"
+    - "Before production changes"
+    - "Before committing sensitive changes"
+    - "When user approval explicitly required"
+
+  # Stop for confirmation
+  confirm:
+    - "Breaking changes detected"
+    - "Security implications found"
+    - "Multiple solutions available"
+    - "Scope exceeds initial request"
+
+  # Ask for clarification
+  clarify:
+    - "Ambiguous requirements"
+    - "Missing information"
+    - "Conflicting constraints"
+
+# =============================================================================
+# VERIFICATION PATTERNS
+# =============================================================================
+
+verification:
+  # Code verification
+  code:
+    - "Syntax check (compile/lint)"
+    - "Type check"
+    - "Unit tests pass"
+    - "No security issues"
+
+  # Build verification
+  build:
+    - "Clean build succeeds"
+    - "No warnings (or acceptable)"
+    - "Output artifacts generated"
+
+  # Deployment verification
+  deploy:
+    - "Health check passes"
+    - "Smoke tests pass"
+    - "Logs clean"
+    - "Metrics normal"
+
+# =============================================================================
+# OUTPUT FORMATS
+# =============================================================================
+
+output_formats:
+  # Summary table
+  summary_table:
+    columns: ["Category", "Status", "Details"]
+    status_icons:
+      pass: "✅"
+      warn: "🟡"
+      fail: "🔴"
+      skip: "⏭️"
+
+  # Action items
+  action_items:
+    format: "| Priority | Action | Owner |"
+    priorities:
+      - "🔴 Critical"
+      - "🟠 High"
+      - "🟡 Medium"
+      - "🔵 Low"
+
+  # Progress indicator
+  progress:
+    format: "████████░░ 80%"
+    symbols:
+      filled: "█"
+      empty: "░"
+
+# =============================================================================
+# TOKEN SAVING RULES
+# =============================================================================
+
+token_saving:
+  rules:
+    - "Use tables over prose"
+    - "Use YAML over JSON"
+    - "Reference patterns, don't inline"
+    - "Summarize, don't repeat"
+    - "Focus on current phase only"
+    - "Unload completed context"
+
+  # Reference TOKEN_BUDGETS.yaml as SSoT (v6.2.0 cleanup)
+  thresholds:
+    reference: core/TOKEN_BUDGETS.yaml
+    use:
+      warning: workflow.thresholds.high_load # 8000
+      critical: workflow.thresholds.peak_usage # 12000
+      max: global.max_allowed # 25000
+
+  actions:
+    at_warning: "Summarize older interactions"
+    at_critical: "Unload non-essential skills"
+    at_max: "Request context cleanup"
+
+# =============================================================================
+# EVIDENCE REQUIREMENTS
+# =============================================================================
+
+evidence:
+  format: "file:line"
+
+  required_for:
+    - "Bug reports"
+    - "Security findings"
+    - "Performance issues"
+    - "Code changes"
+
+  includes:
+    - "File path"
+    - "Line number(s)"
+    - "Code snippet"
+    - "Explanation"
+
+# =============================================================================
+# COMMON COMMANDS BY STACK
+# =============================================================================
+
+commands:
+  test:
+    nodejs: "npm test"
+    golang: "go test ./..."
+    python: "pytest"
+    rust: "cargo test"
+    java_maven: "mvn test"
+    java_gradle: "./gradlew test"
+    dotnet: "dotnet test"
+    php: "composer test"
+    ruby: "bundle exec rspec"
+
+  build:
+    nodejs: "npm run build"
+    golang: "go build"
+    python: "python -m build"
+    rust: "cargo build"
+    java_maven: "mvn package"
+    java_gradle: "./gradlew build"
+    dotnet: "dotnet build"
+    php: "composer build"
+    ruby: "bundle exec rake build"
+
+  lint:
+    nodejs: "npm run lint"
+    golang: "golangci-lint run"
+    python: "ruff check ."
+    rust: "cargo clippy"
+    java: "mvn checkstyle:check"
+    dotnet: "dotnet format --verify-no-changes"
+    php: "composer lint"
+    ruby: "bundle exec rubocop"
+
+  format:
+    nodejs: "prettier --write ."
+    golang: "gofmt -w ."
+    python: "black ."
+    rust: "cargo fmt"
+    java: "mvn spotless:apply"
+    dotnet: "dotnet format"
+    php: "composer format"
+    ruby: "bundle exec rubocop -a"
+
+# =============================================================================
+# UTILITY DIRECTORY PATTERNS (Code Deduplication)
+# =============================================================================
+
+utility_directories:
+  # Standard locations to search before adding new utils
+  nodejs:
+    search_order:
+      - "src/lib/"
+      - "src/utils/"
+      - "src/helpers/"
+      - "lib/"
+      - "utils/"
+    create_in: "src/utils/"
+
+  golang:
+    search_order:
+      - "pkg/"
+      - "internal/utils/"
+      - "internal/helpers/"
+      - "internal/common/"
+    create_in: "pkg/"
+
+  python:
+    search_order:
+      - "src/utils/"
+      - "utils/"
+      - "common/"
+      - "helpers/"
+    create_in: "src/utils/"
+
+  java:
+    search_order:
+      - "src/main/java/**/utils/"
+      - "src/main/java/**/common/"
+      - "src/main/java/**/helpers/"
+    create_in: "src/main/java/{package}/utils/"
+
+  csharp:
+    search_order:
+      - "Common/"
+      - "Utilities/"
+      - "Helpers/"
+      - "Shared/"
+    create_in: "Common/"
+
+  php:
+    search_order:
+      - "src/Utils/"
+      - "app/Helpers/"
+      - "lib/"
+    create_in: "src/Utils/"
+
+  # Common utility categories
+  categories:
+    string: ["format", "parse", "truncate", "slugify"]
+    validation: ["validate", "isValid", "check", "assert"]
+    http: ["request", "response", "header", "url"]
+    crypto: ["hash", "encrypt", "decrypt", "random"]
+    file: ["read", "write", "path", "ensure"]
+    date: ["format", "parse", "diff", "add"]

package/.agent/core/PERMISSIONS.md

@@ -0,0 +1,100 @@
+# DOMYH Awesome Code Permissions v6.2.0
+
+> Access control tiers based on 2025 AI safety best practices
+
+## Permission Tiers
+
+| Tier | Level       | Tools                       | Requires  |
+| ---- | ----------- | --------------------------- | --------- |
+| T1   | Read        | view_file, search, list_dir | None      |
+| T2   | Write       | write_file, edit_file       | Auto      |
+| T3   | Execute     | run_command                 | Safe flag |
+| T4   | Destructive | delete, drop, deploy        | CONFIRM   |
+
+---
+
+## T1: Read-Only (Safe)
+
+```yaml
+allowed:
+  - view_file
+  - view_file_outline
+  - grep_search
+  - find_by_name
+  - list_dir
+  - read_url_content
+```
+
+No confirmation needed.
+
+---
+
+## T2: Safe Writes (Auto-approve)
+
+```yaml
+allowed:
+  - write_to_file (new files)
+  - replace_file_content
+  - multi_replace_file_content
+requires: File in project scope
+```
+
+---
+
+## T3: Command Execution (SafeToAutoRun check)
+
+```yaml
+allowed:
+  - run_command (SafeToAutoRun=true)
+  - send_command_input
+forbidden:
+  - rm -rf
+  - format
+  - shutdown
+  - DROP TABLE
+  - DELETE FROM (no WHERE)
+```
+
+---
+
+## T4: Destructive (MUST CONFIRM)
+
+```yaml
+requires_confirmation:
+  - Any production environment
+  - File deletion
+  - Database drops
+  - Schema migrations
+  - Deploy commands
+format: "⚠️ CONFIRM: [action] — [impact]"
+```
+
+---
+
+## Path Restrictions
+
+```yaml
+allowed_paths:
+  - "{project_root}/**"
+  - "{temp}/**"
+  - "{artifacts}/**"
+forbidden_paths:
+  - "C:/Windows/**"
+  - "/etc/**"
+  - "~/.ssh/**"
+  - "**/node_modules/**"
+```
+
+---
+
+## Rate Limits
+
+| Action      | Limit | Window |
+| ----------- | ----- | ------ |
+| file_writes | 50    | 1min   |
+| commands    | 20    | 1min   |
+| api_calls   | 100   | 1min   |
+
+---
+
+_DOMYH Awesome Code — Permission Framework_