@nockdev/awf 6.2.0

package/.agent/core/TOKEN_SUMMARY.yaml

@@ -0,0 +1,121 @@
+# DOMYH Awesome Code — Token Optimization Summary v6.2.0
+# This file provides quick reference for token-optimized usage
+
+# =============================================================================
+# QUICK STATS
+# =============================================================================
+
+stats:
+  workflows: 28
+  skills: 22
+  personas: 7
+  languages_supported: 30+
+
+# Token budgets
+tokens:
+  idle: 2500
+  typical: 6000
+  peak: 12000
+  max_allowed: 25000
+
+# =============================================================================
+# WORKFLOW SIZE CLASSIFICATION
+# =============================================================================
+
+# Workflow classifications are defined in TOKEN_LOADING.yaml (Single Source of Truth)
+# See: core/TOKEN_LOADING.yaml → optimized_workflows section
+# Categories: small (<10KB), medium (10-20KB), large (>20KB)
+workflow_reference: core/TOKEN_LOADING.yaml
+
+# =============================================================================
+# OPTIMIZATION FEATURES ENABLED
+# =============================================================================
+
+features:
+  progressive_loading: true
+  section_based_lazy_load: true
+  dynamic_skill_unload: true
+  context_cleanup_on_switch: true
+  automatic_summarization: true
+  template_externalization: true
+  shared_patterns_library: true
+  # New in : Memory Engine
+  hierarchical_memory: true
+  cross_session_persistence: true
+  auto_save_decisions: true
+  compact_audit_storage: true
+
+# =============================================================================
+# FILES ADDED FOR OPTIMIZATION
+# =============================================================================
+
+optimization_files:
+  - core/PATTERNS.yaml # Shared patterns to reduce duplication
+  - core/TEMPLATES.yaml # External templates registry
+  - core/TOKEN_LOADING.yaml # Section-based lazy loading config
+  - core/TOKEN_SUMMARY.yaml # This file
+  # Phase 1: Memory Engine
+  - core/MEMORY_ENGINE.yaml # 4-layer memory architecture
+  - core/session_cache.json # Active session state
+  - memory/session.md # Session notes (Layer 2)
+  - memory/decisions.md # Decisions log (Layer 3)
+  - memory/state.json # Project state (Layer 3)
+  - memory/audit_summary.json # Compact audit data (Layer 3)
+  # Phase 2: Robust Memory
+  - core/SUMMARIZATION_ENGINE.yaml # 3-level hierarchical summarization
+  - core/CLEANUP_ENGINE.yaml # Automated cleanup triggers
+  - core/MEMORY_UTILS.yaml # Memory commands and utilities
+  - memory/cleanup_log.json # Cleanup operation log
+  - memory/metrics.json # Memory system metrics
+  - memory/archive/ # Archive directory structure
+  # Phase 3: Semantic Memory (Optional — NOT YET IMPLEMENTED)
+  - core/SEMANTIC_ENGINE.yaml # LanceDB vector database config
+  - memory/vectors/ # Vector database storage
+  # Phase 4: Intelligent Memory (2025+ Best Practices)
+  - core/CONTEXT_LOADER.yaml # Just-in-Time context loading
+  - core/CONTEXT_INJECTOR.yaml # Smart context injection
+  - core/CONTEXT_PRIORITY.yaml # Multi-factor priority scoring
+  - core/ACTIVE_MEMORY.yaml # Self-directing memory (Letta-style)
+  - core/MEMORY_CONSOLIDATION.yaml # Auto-consolidation engine
+  - memory/active_memories.json # Active memory storage
+  - memory/insights.md # Memory reflection insights
+  - memory/consolidated.md # Consolidated memory view
+  # Phase 5: Cleanup & SSoT (v6.2.0)
+  - core/SCORING_FORMULA.yaml # SSoT for priority scoring
+  - core/MEMORY_PATHS.yaml # SSoT for memory paths
+  - core/TOKEN_BUDGETS.yaml # SSoT for all token limits
+
+# =============================================================================
+# MEMORY LAYER TOKEN BUDGETS (Optimized with JIT)
+# =============================================================================
+
+memory_budgets:
+  # Core layers
+  layer_1_working: 500 # Always in context
+  layer_2_session: 2000 # Loaded on demand
+  layer_3_state: 500 # Structured JSON
+  layer_4_semantic: 2500 # Optional vector DB
+
+  # Phase 4: JIT Optimization
+  jit_savings: 1500 # Saved via just-in-time loading
+  smart_injection_budget: 2000 # Max for injected context
+  active_memory_budget: 500 # For active memory actions
+
+  # Totals
+  total_memory_max: 5500 # Base without JIT
+  total_with_jit: 4000 # ~3.1% of 128K limit (36% improvement)
+
+# =============================================================================
+# USER TIPS FOR MINIMAL TOKEN USAGE
+# =============================================================================
+
+tips:
+  - "Use specific commands (not just the workflow name)"
+  - "Avoid loading multiple large workflows in sequence"
+  - "Use /workflow suggest for quick recommendations"
+  - "Use /recap before switching contexts"
+  - "Skills auto-unload after 5 minutes of inactivity"
+  # New tips for memory system
+  - "Session notes auto-save every 10 interactions"
+  - "Decisions are automatically logged for cross-session reference"
+  - "Use /recap to restore context from previous sessions"

package/.agent/core/VERSION.yaml

@@ -0,0 +1,240 @@
+# =============================================================================
+# VERSION.yaml — Single Source of Truth for System VERSION
+# =============================================================================
+# IMPORTANT: File này CHỈ quản lý VERSION
+# - Project identity → BRANDING.yaml
+# - Language settings → BRANDING.yaml
+# Khi update version, CHỈ cần sửa file này
+# =============================================================================
+
+# =============================================================================
+# CORE SYSTEM VERSION
+# =============================================================================
+
+system:
+  version: "6.1.2"
+  version_short: "v6.2.0" # Dùng cho footer: "_DOMYH Awesome Code "
+  codename: "Context Mesh"
+  release_date: "2026-02-03"
+
+  # Identity comes from BRANDING.yaml
+  _identity_ref: "core/BRANDING.yaml"
+
+# =============================================================================
+# COMPONENT VERSIONS (sub-versions for individual modules)
+# =============================================================================
+
+components:
+  # === CORE WORKFLOWS (High usage) ===
+  ap_pro: "5.1" # Audit Pro - Multi-Expert Consensus
+  code_pro: "3.2" # Code Pro - Auto Test Loop + Security-First
+  debug_pro: "3.3" # Debug Pro - Root Cause Tracing + Defense-in-Depth
+  plan_pro: "3.2" # Plan Pro - Deep Interview + Auto Phase Generation
+  test_pro: "3.2" # Test Pro - TDD Iron Law + AI Testing
+  modify_pro: "3.1" # Modify Pro - AI-Driven Modernization
+
+  # === SECONDARY WORKFLOWS ===
+  deploy_pro: "3.1" # Deploy Pro - GitOps + Progressive Delivery
+  refactor_pro: "3.1" # Refactor Pro - AI-Assisted Refactoring
+  review_pro: "3.1" # Review Pro - AI-Assisted Reviews
+  init_pro: "3.1" # Init Pro - AI Scaffolding + 30+ Templates
+
+  # === EXTENDED WORKFLOWS ===
+  migrate_pro: "3.1" # Migrate Pro - Zero-Downtime CDC
+  doc_pro: "3.1" # Doc Pro - AI-Optimized + Auto API
+  generate_pro: "3.1" # Generate Pro - Multi-Modal + Quality Gates
+  perf_pro: "3.1" # Perf Pro - Agent-Aware Profiling
+  upgrade_pro: "3.1" # Upgrade Pro - Security-First Updates
+  clean_pro: "2.2" # Clean Pro - Dead Code Removal
+  monitor_pro: "3.1" # Monitor Pro - AI-Powered Observability
+  env_pro: "3.1" # Env Pro - Vault + Multi-Env Sync
+
+  # === UTILITY WORKFLOWS ===
+  recap_pro: "3.2" # Recap Pro - Session Continuity
+  status_pro: "3.1" # Status Pro - Full Health Dashboard
+  help_pro: "2.1" # Help Pro - Context-Aware + Smart Suggestions
+  suggest_pro: "3.1" # Suggest Pro - Git-Aware Suggestions
+  dev_pro: "3.1" # Dev Pro - HMR 2025 + Error Overlay
+  revert_pro: "3.1" # Revert Pro - Safe Rollback + Feature Flags
+  orchestrate_pro: "3.1" # Orchestrate Pro - Fault-Tolerant Multi-Agent
+  save_pro: "1.0" # Save Pro - Session Persistence
+  lang_pro: "1.0" # Lang Pro - i18n Switching
+  search_pro: "1.1" # Search Pro - Semantic Memory Search
+
+  # === SPECIALIZED WORKFLOWS ===
+  think_pro: "4.0" # Think Pro - 6 Methods + 5 Tiers + Multi-Mode
+  visualize_pro: "4.0" # Visualize Pro - Multi-Platform + Component Mapping
+  sync_version_pro: "1.0" # Sync Version - SSoT Architecture
+
+  # Default for unlisted
+  default_workflow_version: "3.1"
+
+  # === SKILLS ===
+  ui_ux_pro: "5.0" # UI/UX Pro Max
+  web_perf: "5.0" # Web Performance
+
+  # Default for unlisted
+  default_skill_version: "v6.2.0"
+
+# =============================================================================
+# VERSION HISTORY
+# =============================================================================
+
+changelog:
+  "6.1.2":
+    date: "2026-02-05"
+    codename: "Context Mesh"
+    changes:
+      - "HSA v1.0.0: HybridRAG+ with ColBERT reranking"
+      - "Merkle-bound embedding cache (11x speedup)"
+      - "AST-based semantic chunking (tree-sitter)"
+      - "Dynamic Leiden community detection"
+      - "GPU acceleration (cuGraph + embeddings)"
+      - "UI/UX Pro Max HSA adapter integration"
+
+  "6.1.1":
+    date: "2026-02-03"
+    codename: "Agentic Personas"
+    changes:
+      - "11 personas with CrewAI/Anthropic/LangGraph patterns"
+      - "3-tier constitutional rule hierarchy"
+      - "13 prompt chain templates"
+      - "Deep Interview (PHASE 0) trong /plan"
+      - "Auto Test Loop (3 retries) trong /code"
+
+  "6.1.0":
+    date: "2026-02-02"
+    codename: "Multi-IDE Milestone"
+    changes:
+      - "51 skills milestone achieved"
+      - "14 IDEs supported with verified formats"
+      - "CLI commands: install, validate, doctor"
+      - "Decoupled Adapter Architecture"
+      - "Strategic Profiles system"
+
+  "6.0.0":
+    date: "2026-01-15"
+    codename: "Skills Era"
+    changes:
+      - "21 core skills"
+      - "Progressive Disclosure architecture"
+      - "Semantic skill selection"
+
+  "5.1.0":
+    date: "2026-02-01"
+    codename: "Root Cause"
+    changes:
+      - "Debug Pro với Root Cause Tracing"
+      - "Engineering Iron Laws"
+      - "External Skills Registry"
+
+  "5.0.0":
+    date: "2026-01-28"
+    codename: "Pro Max"
+    changes:
+      - "UI/UX Pro Max skill"
+      - "Web Performance skill"
+      - "Test Pro với AI Testing"
+
+# =============================================================================
+# VERSION REFERENCE PATTERN (VRP) — Auto-Sync Configuration
+# =============================================================================
+# Run: dawf sync-version [--dry-run] [--validate]
+# =============================================================================
+
+sync:
+  enabled: true
+  version: "1.0.0" # VRP version
+
+  # ==========================================================================
+  # SYNC PATTERNS
+  # ==========================================================================
+  patterns:
+    # Pattern 1: YAML version fields
+    yaml_version:
+      description: "Update version: field in YAML files"
+      regex: 'version: "[0-9]+\\.[0-9]+\\.[0-9]+"'
+      replace: 'version: "{system.version}"'
+      targets:
+        - ".agent/core/*.yaml"
+        - ".agent/skills/**/META.yaml"
+        - ".agent/templates/tasks/*.yaml"
+        - ".agent/personas/*.yaml"
+      exclude:
+        - ".agent/core/VERSION.yaml" # SSoT itself
+        - ".agent/core/HSA.yaml" # HSA-specific version
+        - ".agent/skills/_router.yaml" # Schema version
+        - ".agent/skills/_categories.yaml"
+
+    # Pattern 2: Markdown footers
+    md_footer:
+      description: "Update _DOMYH Awesome Code vX.X.X footers"
+      regex: '_DOMYH Awesome Code v[0-9]+\\.[0-9]+(\\.[0-9]+)?'
+      replace: "_DOMYH Awesome Code v{system.version}"
+      targets:
+        - ".agent/workflows/*.md"
+        - ".agent/templates/**/*.md"
+        - ".agent/skills/**/SKILL.md"
+        - ".agent/rules/**/*.md"
+        - "GEMINI.md"
+
+    # Pattern 3: Markdown headers with version
+    md_header:
+      description: "Update # Title vX.X.X headers"
+      regex: '(# .+DOMYH.+)v[0-9]+\\.[0-9]+(\\.[0-9]+)?'
+      replace: '\\1v{system.version}'
+      targets:
+        - ".agent/templates/README.md"
+        - ".agent/core/README.md"
+
+    # Pattern 4: JSON version fields
+    json_version:
+      description: "Update version in JSON files"
+      regex: '"version": "v?[0-9]+\\.[0-9]+\\.[0-9]+"'
+      replace: '"version": "v{system.version}"'
+      targets:
+        - ".agent/memory/state.json"
+
+  # ==========================================================================
+  # VALIDATION
+  # ==========================================================================
+  validation:
+    pre_check:
+      - "SSoT file exists and valid YAML"
+      - "Version follows semver format"
+
+    post_check:
+      - "All targets updated"
+      - "No orphan version references"
+
+    drift_detection:
+      enabled: true
+      schedule: "on_commit"
+      action: "warn"
+      threshold: 0
+
+  # ==========================================================================
+  # CLI OPTIONS
+  # ==========================================================================
+  cli:
+    command: "dawf sync-version"
+    options:
+      dry_run: "--dry-run"
+      validate: "--validate"
+      verbose: "--verbose"
+      report: "--report"
+
+# =============================================================================
+# LEGACY SYNC TARGETS (for reference)
+# =============================================================================
+
+sync_targets_legacy:
+  - ".agent/manifest.yaml → version"
+  - ".agent/config.yaml → header comment"
+  - ".agent/memory/state.json → system.version"
+  - ".agent/i18n/vi.yaml → app.version"
+  - ".agent/i18n/en.yaml → app.version"
+  - "GEMINI.md → header + footer"
+  - ".agent/workflows/*.md → footer"
+  - ".agent/skills/*/SKILL.md → footer"
+  - ".agent/templates/*.md → footer"