@nockdev/awf 6.2.0

package/.agent/core/ACTIVE_MEMORY.yaml

@@ -0,0 +1,344 @@
+# DOMYH Awesome Code — Active Memory Management v6.2.0
+# Self-directing memory inspired by Letta/MemGPT architecture
+# Agent decides what to remember, forget, update, emphasize
+
+version: "6.1.2"
+engine: active_memory_manager
+
+# =============================================================================
+# CORE PHILOSOPHY
+# =============================================================================
+
+# "Agents actively manage their memory, deciding what information to 
+# retain, update, or search for, rather than passively retrieving it."
+# — Letta Cognitive Architecture (2025)
+
+philosophy:
+  principle: "Agent owns its memory"
+  inspiration: "Human cognitive memory management"
+  difference: "Passive (old) → Active (new)"
+  goal: "Self-improving memory that gets smarter over time"
+
+# =============================================================================
+# MEMORY ACTIONS
+# =============================================================================
+
+actions:
+  # Agent can REMEMBER new information
+  remember:
+    description: "Store new important information"
+    syntax: "@memory remember: {content}"
+    examples:
+      - "@memory remember: User prefers concise responses"
+      - "@memory remember: Project uses PostgreSQL, not MySQL"
+      - "@memory remember: Always run tests before commit"
+    storage:
+      location: memory/active_memories.json
+      categorize: auto
+      weight: 1.0
+      
+  # Agent can FORGET outdated information
+  forget:
+    description: "Mark information as outdated/irrelevant"
+    syntax: "@memory forget: {content_id}"
+    examples:
+      - "@memory forget: old_api_pattern_001"
+      - "@memory forget: deprecated_workflow"
+    action:
+      type: soft_delete  # Move to archive, don't hard delete
+      location: memory/archive/forgotten/
+      reason_required: true
+      
+  # Agent can UPDATE existing memories
+  update:
+    description: "Modify existing memory with new information"
+    syntax: "@memory update: {content_id} -> {new_content}"
+    examples:
+      - "@memory update: db_type -> Now using PostgreSQL 16"
+      - "@memory update: api_version -> Upgraded to v3"
+    action:
+      preserve_history: true
+      log_change: true
+      
+  # Agent can EMPHASIZE important memories
+  emphasize:
+    description: "Increase weight of important memory"
+    syntax: "@memory emphasize: {content_id}"
+    examples:
+      - "@memory emphasize: security_first_principle"
+      - "@memory emphasize: test_coverage_requirement"
+    action:
+      weight_increase: 0.2
+      max_weight: 2.0
+      
+  # Agent can CONNECT related memories
+  connect:
+    description: "Link related memories together"
+    syntax: "@memory connect: {id1} <-> {id2}"
+    examples:
+      - "@memory connect: auth_decision <-> security_audit"
+    action:
+      create_bidirectional_link: true
+
+# =============================================================================
+# AUTO-TRIGGERS
+# =============================================================================
+
+auto_triggers:
+  # User correction triggers memory update
+  on_user_correction:
+    detect: "Actually", "No,", "That's wrong", "Not quite"
+    action: |
+      1. Identify incorrect memory
+      2. Update with correct information
+      3. Remember the correction pattern
+    auto: true
+    
+  # Repeated question triggers memory strengthen
+  on_repeated_question:
+    detect: similar_question_in_last_5
+    action: |
+      1. Identify related memory
+      2. Emphasize that memory
+      3. Consider creating shortcut
+    auto: true
+    
+  # Outdated info detected triggers review
+  on_outdated_detection:
+    detect: version_mismatch, deprecated_api, old_pattern
+    action: |
+      1. Flag memory for review
+      2. Query for updated information
+      3. Propose update or forget
+    auto: true
+    
+  # Success pattern triggers memory
+  on_success_pattern:
+    detect: workflow_completed, test_passed, issue_resolved
+    action: |
+      1. Extract success pattern
+      2. Remember what worked
+      3. Link to similar future tasks
+    auto: true
+    
+  # Error pattern triggers memory
+  on_error_pattern:
+    detect: error_repeated, same_mistake
+    action: |
+      1. Remember error pattern
+      2. Remember solution
+      3. Create prevention rule
+    auto: true
+
+# =============================================================================
+# MEMORY CATEGORIES
+# =============================================================================
+
+categories:
+  preferences:
+    description: "User and project preferences"
+    importance: high
+    examples:
+      - response_style
+      - coding_conventions
+      - tool_preferences
+    retention: permanent
+    
+  decisions:
+    description: "Architectural and technical decisions"
+    importance: high
+    examples:
+      - database_choice
+      - api_design
+      - library_selection
+    retention: long_term
+    sync_to: memory/decisions.md
+    
+  patterns:
+    description: "Recurring code and workflow patterns"
+    importance: medium
+    examples:
+      - error_handling_pattern
+      - test_structure
+      - naming_conventions
+    retention: long_term
+    
+  corrections:
+    description: "User corrections and clarifications"
+    importance: high
+    examples:
+      - wrong_assumption_fixed
+      - terminology_correction
+    retention: permanent
+    weight_boost: 1.5
+    
+  contexts:
+    description: "Project and task contexts"
+    importance: medium
+    examples:
+      - current_project_state
+      - active_features
+    retention: session_based
+    
+  insights:
+    description: "Agent-generated insights"
+    importance: medium
+    examples:
+      - performance_bottleneck
+      - improvement_opportunity
+    retention: long_term
+    review_needed: true
+
+# =============================================================================
+# SELF-REFLECTION
+# =============================================================================
+
+reflection:
+  enabled: true
+  
+  # Periodic self-review
+  schedule:
+    trigger: every_10_interactions
+    max_duration_tokens: 500
+    
+  # Review process
+  process:
+    1_review_recent:
+      action: "Review last 5 memory actions"
+      check: "Were they accurate and helpful?"
+      
+    2_consolidate:
+      action: "Merge similar memories"
+      check: "Are there redundancies?"
+      
+    3_prune:
+      action: "Identify stale memories"
+      check: "Are any memories outdated?"
+      
+    4_strengthen:
+      action: "Emphasize frequently-used memories"
+      check: "What's accessed most often?"
+      
+    5_generate_insights:
+      action: "Derive patterns from memories"
+      output: memory/insights.md
+      
+  # Output
+  output:
+    insights_file: memory/insights.md
+    reflection_log: memory/reflection_log.json
+
+# =============================================================================
+# MEMORY CONSOLIDATION
+# =============================================================================
+
+consolidation:
+  # When to consolidate
+  triggers:
+    - memory_count > 50
+    - session_end
+    - decision_count > 20
+    - explicit_command: "/mem consolidate"
+    
+  # How to consolidate
+  strategies:
+    merge_similar:
+      method: semantic_similarity
+      threshold: 0.85
+      keep: most_recent
+      
+    collapse_sequences:
+      method: temporal_proximity
+      threshold: 5_minutes
+      action: create_summary
+      
+    hierarchy_building:
+      method: topic_clustering
+      levels: [category, topic, detail]
+      
+  # Output
+  output:
+    consolidated_view: memory/consolidated.md
+    full_backup: memory/archive/consolidation/
+
+# =============================================================================
+# MEMORY STORAGE
+# =============================================================================
+
+storage:
+  # Primary storage
+  active_memories:
+    path: memory/active_memories.json
+    format: json
+    max_entries: 100
+    
+  schema:
+    id: uuid
+    content: string
+    category: enum
+    weight: float
+    created_at: timestamp
+    updated_at: timestamp
+    accessed_count: int
+    last_accessed: timestamp
+    links: array[uuid]
+    metadata:
+      source: string
+      confidence: float
+      reviewed: boolean
+      
+  # Indexing
+  indexes:
+    - category
+    - weight_desc
+    - last_accessed_desc
+    - content_embedding  # For semantic search
+
+# =============================================================================
+# INTEGRATION
+# =============================================================================
+
+integration:
+  # Workflow hooks
+  workflows:
+    on_workflow_start:
+      load: relevant_memories_by_workflow
+      max_tokens: 300
+      
+    on_workflow_end:
+      action: remember_outcomes
+      consolidate: if_needed
+      
+  # Memory engine
+  memory_engine:
+    sync_decisions: true
+    sync_errors: true
+    sync_audits: true
+    
+  # Semantic engine
+  semantic_engine:
+    index_on_remember: true
+    search_on_recall: true
+
+# =============================================================================
+# SAFETY
+# =============================================================================
+
+safety:
+  # Never auto-forget
+  protected_categories:
+    - preferences
+    - corrections
+    - security_related
+    
+  # Require confirmation for
+  confirm_required:
+    - forget_permanent
+    - bulk_update
+    - clear_category
+    
+  # Backup before destructive
+  backup:
+    on_forget: true
+    on_bulk_update: true
+    location: memory/archive/safety_backups/

package/.agent/core/ARCH_REGISTRY.yaml

@@ -0,0 +1,252 @@
+# Architecture Registry — DOMYH Awesome Code
+# Token-optimized reference for /init
+
+# FORMAT: skill: {arch: [pattern|⭐best], type: [app|lib|api|cli|web|mobile]}
+
+registry:
+  # === LANGUAGES ===
+
+  go:
+    archs:
+      - { id: standard, dir: "cmd/,internal/,pkg/", best: true }
+      - { id: clean, dir: "domain/,usecase/,delivery/" }
+      - { id: hexagonal, dir: "core/,ports/,adapters/" }
+      - { id: ddd, dir: "domain/,application/,infra/" }
+    types: [api, cli, lib]
+    default: standard
+
+  python:
+    archs:
+      - { id: src, dir: "src/,tests/", best: true }
+      - { id: flat, dir: "app/,tests/" }
+      - { id: django, dir: "apps/,templates/" }
+      - { id: fastapi, dir: "app/routers/,models/,schemas/" }
+    types: [api, cli, lib, web]
+    default: src
+
+  typescript:
+    archs:
+      - { id: src, dir: "src/,dist/", best: true }
+      - { id: feature, dir: "features/,shared/" }
+      - { id: modular, dir: "modules/,common/" }
+    types: [api, cli, lib, web]
+    default: src
+
+  rust:
+    archs:
+      - { id: cargo, dir: "src/,tests/", best: true }
+      - { id: workspace, dir: "crates/,common/" }
+      - { id: binary, dir: "src/bin/,lib/" }
+    types: [cli, lib, api]
+    default: cargo
+
+  cpp:
+    archs:
+      - { id: cmake, dir: "src/,include/,tests/", best: true }
+      - { id: single, dir: "src/" }
+      - { id: library, dir: "include/,src/,examples/" }
+    types: [lib, cli, app]
+    default: cmake
+
+  csharp:
+    archs:
+      - { id: clean, dir: "Domain/,Application/,Infra/,API/", best: true }
+      - { id: mvvm, dir: "Models/,Views/,ViewModels/" }
+      - { id: mvc, dir: "Controllers/,Models/,Views/" }
+      - { id: minimal, dir: "single file" }
+      - { id: feature, dir: "Features/{name}/" }
+    types: [api, web, desktop, mobile]
+    default: clean
+
+  java:
+    archs:
+      - { id: maven, dir: "src/main/java/,src/test/", best: true }
+      - { id: gradle, dir: "app/,lib/" }
+      - { id: spring, dir: "controller/,service/,repository/" }
+      - { id: clean, dir: "domain/,application/,infra/" }
+    types: [api, lib, web]
+    default: maven
+
+  kotlin:
+    archs:
+      - { id: android, dir: "app/,buildSrc/", best: true }
+      - { id: multiplatform, dir: "shared/,android/,ios/" }
+      - { id: ktor, dir: "routes/,plugins/" }
+      - { id: compose, dir: "ui/,data/,domain/" }
+    types: [mobile, api, lib]
+    default: android
+
+  swift:
+    archs:
+      - { id: swiftpm, dir: "Sources/,Tests/", best: true }
+      - { id: ios, dir: "App/,Views/,Models/" }
+      - { id: mvvm, dir: "Views/,ViewModels/,Services/" }
+      - { id: tca, dir: "Features/,Core/" }
+    types: [mobile, cli, lib]
+    default: swiftpm
+
+  php:
+    archs:
+      - { id: laravel, dir: "app/,routes/,resources/", best: true }
+      - { id: symfony, dir: "src/,config/,templates/" }
+      - { id: psr4, dir: "src/,public/,vendor/" }
+      - { id: wordpress, dir: "themes/,plugins/" }
+    types: [web, api, cli]
+    default: laravel
+
+  lua:
+    archs:
+      - { id: standard, dir: "src/,spec/", best: true }
+      - { id: love2d, dir: "main.lua,conf.lua" }
+      - { id: neovim, dir: "lua/,plugin/" }
+    types: [script, game, plugin]
+    default: standard
+
+  # === FRAMEWORKS ===
+
+  react:
+    archs:
+      - { id: vite, dir: "src/,public/", best: true }
+      - { id: feature, dir: "features/,shared/" }
+      - { id: atomic, dir: "atoms/,molecules/,organisms/" }
+    types: [web, lib]
+    default: vite
+
+  vue:
+    archs:
+      - { id: vite, dir: "src/,public/", best: true }
+      - { id: nuxt, dir: "pages/,composables/,server/" }
+      - { id: pinia, dir: "stores/,views/" }
+    types: [web, ssr]
+    default: vite
+
+  nextjs:
+    archs:
+      - { id: app, dir: "app/,components/,lib/", best: true }
+      - { id: pages, dir: "pages/,components/,lib/" }
+      - { id: fullstack, dir: "app/,prisma/,lib/" }
+    types: [web, ssr, fullstack]
+    default: app
+
+  # === DEVOPS ===
+
+  docker:
+    archs:
+      - { id: multistage, file: "multi-stage Dockerfile", best: true }
+      - { id: single, file: "simple Dockerfile" }
+      - { id: compose, file: "docker-compose.yml" }
+    types: [container]
+    default: multistage
+
+  kubernetes:
+    archs:
+      - { id: helm, dir: "charts/,values/", best: true }
+      - { id: kustomize, dir: "base/,overlays/" }
+      - { id: manifest, dir: "k8s/" }
+      - { id: gitops, dir: "argocd/,flux/" }
+    types: [orchestration]
+    default: helm
+
+  aws:
+    archs:
+      - { id: cdk, dir: "lib/,bin/", best: true }
+      - { id: sam, dir: "template.yaml,functions/" }
+      - { id: terraform, dir: "modules/,envs/" }
+    types: [infra]
+    default: cdk
+
+  ci-cd:
+    archs:
+      - { id: github, file: ".github/workflows/", best: true }
+      - { id: gitlab, file: ".gitlab-ci.yml" }
+      - { id: jenkins, file: "Jenkinsfile" }
+    types: [pipeline]
+    default: github
+
+  # === SUPPORT ===
+
+  database:
+    archs:
+      - { id: migration, dir: "migrations/,seeds/", best: true }
+      - { id: orm, dir: "models/,repositories/" }
+      - { id: raw, dir: "sql/,scripts/" }
+    types: [schema]
+    default: migration
+
+  testing:
+    archs:
+      - { id: colocated, dir: "*.test.ts next to src", best: true }
+      - { id: separate, dir: "tests/,__tests__/" }
+      - { id: e2e, dir: "e2e/,playwright/" }
+    types: [unit, integration, e2e]
+    default: colocated
+
+  security:
+    archs:
+      - { id: owasp, file: "security-headers,CSP,CORS" }
+      - { id: hardened, file: "container-security,secrets" }
+    types: [audit]
+    default: owasp
+
+  # === ASM ===
+  asm:
+    archs:
+      - { id: flat, dir: "src/,include/", best: true }
+      - { id: project, dir: "asm/,data/,inc/" }
+    types: [binary, lib]
+    default: flat
+
+# ============================================
+# CROSS-CUTTING PATTERNS (P1/P2 Additions)
+# ============================================
+
+patterns:
+  # MONOREPO (P1)
+  monorepo:
+    tools:
+      - { id: turborepo, cmd: "npx create-turbo@latest", best: true }
+      - { id: nx, cmd: "npx create-nx-workspace" }
+      - { id: pnpm, cmd: "pnpm init", config: "pnpm-workspace.yaml" }
+      - { id: lerna, cmd: "npx lerna init", note: "legacy" }
+    structure: "apps/,packages/,libs/"
+
+  # ENVIRONMENT (P1)
+  environment:
+    files: [".env", ".env.example", ".env.local", ".env.production"]
+    secrets: ["vault", "aws-secrets", "doppler", "infisical"]
+    validation: ["dotenv", "envalid", "zod"]
+
+  # DEPENDENCY INJECTION (P2)
+  di:
+    csharp: ["Microsoft.DI", "Autofac", "Ninject"]
+    java: ["Spring", "Guice", "Dagger"]
+    kotlin: ["Hilt", "Koin", "Kodein"]
+    typescript: ["tsyringe", "inversify", "typedi"]
+    python: ["dependency-injector", "injector"]
+    go: ["wire", "fx", "dig"]
+
+  # OBSERVABILITY (P2)
+  observability:
+    logging: ["slog", "zap", "winston", "pino"]
+    tracing: ["otel", "jaeger", "zipkin"]
+    metrics: ["prometheus", "grafana", "datadog"]
+    apm: ["sentry", "newrelic", "elastic-apm"]
+
+  # API GATEWAY (P2)
+  api_gateway:
+    patterns: ["kong", "traefik", "nginx", "envoy"]
+    auth: ["oauth2", "jwt", "apikey"]
+    features: ["rate-limit", "circuit-breaker", "retry"]
+
+  # LINTING (P3)
+  linting:
+    go: "golangci-lint"
+    python: "ruff"
+    typescript: "eslint+prettier"
+    rust: "clippy"
+    csharp: "dotnet-format"
+
+  # GIT HOOKS (P3)
+  git_hooks:
+    tools: ["husky", "pre-commit", "lefthook"]
+    checks: ["lint", "test", "typecheck", "commit-msg"]

package/.agent/core/AUDIT_POLICY.md

@@ -0,0 +1,68 @@
+# DOMYH Awesome Code Audit Policy v6.2.0
+
+> Logging and accountability based on 2025 AI governance standards
+
+## What to Log
+
+| Category | Events                                  | Retention |
+| -------- | --------------------------------------- | --------- |
+| Critical | Permission escalations, destructive ops | 90 days   |
+| High     | File modifications, deploys             | 30 days   |
+| Medium   | Command executions                      | 7 days    |
+| Low      | Read operations                         | Session   |
+
+---
+
+## Log Format
+
+```json
+{
+  "timestamp": "ISO8601",
+  "action": "action_type",
+  "target": "file/resource",
+  "result": "success/fail",
+  "user_approved": true/false,
+  "session_id": "uuid"
+}
+```
+
+---
+
+## Required Logging
+
+### Always Log
+
+- File deletions
+- Production commands
+- Permission denials
+- Error loops (3+)
+- User confirmations
+
+### Never Log
+
+- Sensitive data content
+- API keys/secrets
+- PII
+
+---
+
+## Audit Trail Requirements
+
+1. **Immutable** — No modification of logs
+2. **Complete** — All state-changing operations
+3. **Searchable** — By session, action, time
+4. **Exportable** — JSON format
+
+---
+
+## Compliance Mapping
+
+| Standard    | Requirements      | Status |
+| ----------- | ----------------- | ------ |
+| EU AI Act   | Transparency logs | ✅     |
+| NIST AI RMF | Decision trail    | ✅     |
+| ISO 27001   | Access logs       | ✅     |
+
+---
+
+_DOMYH Awesome Code — Audit Policy_