@nockdev/awf 6.2.0

package/.agent/core/BRANDING.yaml

@@ -0,0 +1,185 @@
+# =============================================================================
+# BRANDING.yaml — Single Source of Truth for Project Identity
+# =============================================================================
+# IMPORTANT: Tất cả thông tin về project name, developer, URLs... NÊN đọc từ đây
+# Khi rebranding, CHỈ cần sửa file này
+# =============================================================================
+
+# =============================================================================
+# PROJECT IDENTITY
+# =============================================================================
+
+identity:
+  name: "DOMYH Awesome Code" # Tên chính thức
+  name_short: "DOMYH" # Viết tắt
+  tagline: "AI-powered development assistant"
+  tagline_vi: "Trợ lý Phát triển Ứng dụng AI"
+
+  developer: "NockDev"
+  organization: "DOMYH"
+
+  # Repository và docs
+  repository: "https://github.com/nockasdd/domyh-awf-code"
+  documentation: "https://domyh.dev/docs"
+
+  # License
+  license: "MIT"
+  copyright_year: 2026
+
+# =============================================================================
+# LANGUAGE DEFAULTS
+# =============================================================================
+
+language:
+  default: "vi" # vi | en
+  supported: ["vi", "en"]
+
+  # Language-specific settings
+  settings:
+    vi:
+      name: "Tiếng Việt"
+      code: "vi"
+      honorific_agent: "em" # Agent tự xưng
+      honorific_user: "anh/chị" # Gọi user
+      use_emoji: true
+
+    en:
+      name: "English"
+      code: "en"
+      honorific_agent: "I"
+      honorific_user: "you"
+      use_emoji: true
+
+# =============================================================================
+# FORMATTING STANDARDS
+# =============================================================================
+
+formatting:
+  # Footer format cho tất cả files
+  footer_template: "_DOMYH Awesome Code v{version} • {component_name} • {component_tagline}_"
+
+  # Header format cho SKILL.md
+  skill_header_template: "# {skill_name} — DOMYH Awesome Code v{version}"
+
+  # Progress bar format
+  progress_bar:
+    filled: "█"
+    empty: "░"
+    width: 10 # Số ký tự
+    format: "📊 {bar} {percent}% ({current}/{total})"
+
+  # Box characters
+  box:
+    top_bottom: "━"
+    separator: "───"
+
+  # Emoji standards
+  emojis:
+    success: "✅"
+    error: "❌"
+    warning: "⚠️"
+    info: "ℹ️"
+    stop: "⛔"
+    progress: "⏳"
+    complete: "🎉"
+
+# =============================================================================
+# PRIORITY SYSTEM
+# =============================================================================
+
+priority:
+  levels:
+    p0:
+      name: "Critical"
+      name_vi: "Nghiêm trọng"
+      emoji: "🔴"
+      action: "Sửa ngay lập tức"
+
+    p1:
+      name: "High"
+      name_vi: "Cao"
+      emoji: "🟠"
+      action: "Phải sửa trước khi deploy"
+
+    p2:
+      name: "Medium"
+      name_vi: "Trung bình"
+      emoji: "🟡"
+      action: "Sửa trong sprint này"
+
+    p3:
+      name: "Low"
+      name_vi: "Thấp"
+      emoji: "🟢"
+      action: "Có thì tốt"
+
+# =============================================================================
+# QUALITY LEVELS (for Auto Test Loop)
+# =============================================================================
+
+quality_levels:
+  mvp:
+    name: "MVP"
+    auto_test: false
+    description: "Speed priority, minimal testing"
+
+  production:
+    name: "Production"
+    auto_test: true
+    description: "Quality standard, full test coverage"
+
+  enterprise:
+    name: "Enterprise"
+    auto_test: true
+    integration_tests: true
+    description: "Full coverage with integration tests"
+
+# =============================================================================
+# COMPLEXITY LEVELS (for Phase Generation)
+# =============================================================================
+
+complexity:
+  simple:
+    tasks: "< 5"
+    phases: "1-2"
+    examples: ["Add a button", "Fix a bug", "Update text"]
+
+  medium:
+    tasks: "5-15"
+    phases: "3-4"
+    examples: ["New API endpoint", "Refactor module", "Add feature"]
+
+  complex:
+    tasks: "15+"
+    phases: "5+"
+    examples: ["New feature system", "Major refactor", "Architecture change"]
+
+# =============================================================================
+# SYNC TARGETS (for version updates)
+# =============================================================================
+
+sync_targets:
+  # Files that need version sync
+  version_files:
+    - ".agent/core/VERSION.yaml" # Primary SSoT
+    - ".agent/manifest.yaml"
+    - ".agent/config.yaml"
+    - ".agent/memory/state.json"
+    - ".agent/i18n/vi.yaml"
+    - ".agent/i18n/en.yaml"
+    - "GEMINI.md"
+
+  # Files that need project name sync
+  identity_files:
+    - ".agent/manifest.yaml"
+    - ".agent/memory/state.json"
+    - ".agent/i18n/vi.yaml"
+    - ".agent/i18n/en.yaml"
+    - "GEMINI.md"
+    - "README.md"
+
+  # Pattern-based targets
+  patterns:
+    workflows: ".agent/workflows/*.md"
+    skills: ".agent/skills/*/SKILL.md"
+    templates: ".agent/templates/*.md"

package/.agent/core/CACHE.md

@@ -0,0 +1,59 @@
+# Session Cache v6.2.0
+
+## Caching Strategy
+
+### Workflow Cache
+
+```yaml
+enabled: true
+scope: session
+ttl: 3600
+max_entries: 10
+```
+
+### Skill Cache
+
+```yaml
+enabled: true
+max_active: 3
+eviction: lru
+preload_meta: true
+```
+
+### Query Cache
+
+```yaml
+enabled: true
+cache_embeddings: true
+cache_selections: true
+ttl: 1800
+```
+
+## Cache Layers
+
+| Layer     | TTL     | Strategy             |
+| --------- | ------- | -------------------- |
+| META.yaml | Session | Always loaded        |
+| SKILL.md  | 1 hour  | On-demand, LRU       |
+| Workflow  | 1 hour  | Per-command          |
+| Query     | 30 min  | Embedding similarity |
+
+## Eviction Rules
+
+1. When `max_active` reached → evict LRU skill
+2. When cache full → evict oldest entries
+3. On command change → clear irrelevant cache
+
+## Memory Budget
+
+```
+Target: < 10,000 tokens peak
+├── META.yaml baseline: 1,773 tokens
+├── Active skills (3×): 4,500 tokens
+├── Current workflow: 500 tokens
+└── Buffer: 3,227 tokens
+```
+
+---
+
+\_DOMYH Awesome Code

package/.agent/core/CHECKPOINT.yaml

@@ -0,0 +1,153 @@
+# DOMYH Awesome Code — Checkpoint System v6.2.0
+# Implements periodic rule re-injection to prevent drift in long sessions
+# Research: Long-context degradation patterns
+
+version: "6.1.2"
+engine: checkpoint_system
+
+# =============================================================================
+# CHECKPOINT TRIGGERS
+# =============================================================================
+
+checkpoints:
+  enabled: true
+
+  # ─────────────────────────────────────────────────────────────────────────
+  # TRIGGER CONDITIONS
+  # ─────────────────────────────────────────────────────────────────────────
+
+  triggers:
+    # Message-based (every N messages)
+    message_count:
+      enabled: true
+      threshold: 6 # Every 6 messages
+      rationale: "Prevents mid-session rule drift"
+
+    # Token-based (at N tokens in context)
+    token_threshold:
+      enabled: true
+      threshold: 15000 # At 15k tokens (safe for 128k context models)
+      rationale: "Prevents context overflow degradation"
+
+    # Event-based triggers
+    events:
+      before_code_generation:
+        enabled: true
+        patterns:
+          - "scaffold"
+          - "refactor"
+          - "implement"
+          - "create file"
+          - "/code"
+          - "/init"
+        rationale: "Ensure rules applied before large code changes"
+
+      after_tool_chain:
+        enabled: true
+        consecutive_tools: 3 # After 3+ consecutive tool calls
+        rationale: "Re-anchor after heavy tool usage"
+
+      on_context_compression:
+        enabled: true
+        rationale: "Re-inject rules after summarization"
+
+      on_topic_change:
+        enabled: true
+        similarity_threshold: 0.3 # Low similarity = topic change
+        rationale: "Re-establish context on new topics"
+
+# =============================================================================
+# CHECKPOINT ACTIONS
+# =============================================================================
+
+actions:
+  # What to do at each checkpoint
+  on_checkpoint:
+    # Re-inject rules at head + tail
+    reinject_rules:
+      enabled: true
+      zones: ["head", "tail"]
+      source: ".agent/rules/SACRED_RULES.xml"
+      extract: "//requirement[@severity='block']"
+
+    # Restate critical rules
+    restate_critical:
+      enabled: true
+      format: |
+        === CHECKPOINT: Rule Reminder ===
+        Active rules: LANG_001, MCP_001, SESSION_001
+        Priority: Session Rules > Project > Global
+
+    # Optional: Ask model to paraphrase rules (stronger binding)
+    ask_confirmation:
+      enabled: false # Set true for critical tasks
+      prompt: "Before proceeding, confirm you understand the active rules."
+
+    # Log checkpoint for debugging
+    log_state:
+      enabled: true
+      include:
+        - message_count
+        - token_count
+        - active_rules
+        - violations_count
+      output: ".agent/memory/checkpoint_log.json"
+
+# =============================================================================
+# VIOLATION TRACKING
+# =============================================================================
+
+violations:
+  # Track rule violations per session
+  tracking:
+    enabled: true
+    storage: ".agent/memory/violations.json"
+
+  # Actions on violation detection
+  on_violation:
+    severity_block:
+      action: "flag_response_invalid"
+      notify: true
+      log: true
+
+    severity_warn:
+      action: "log_only"
+      notify: false
+      log: true
+
+  # Escalation thresholds
+  escalation:
+    warning_threshold: 3 # 3 warns → escalate
+    block_threshold: 1 # 1 block → immediate flag
+
+# =============================================================================
+# INTEGRATION
+# =============================================================================
+
+integration:
+  context_loader:
+    syncs_with: "CONTEXT_LOADER.yaml"
+    uses_priority_positioning: true
+
+  policy_engine:
+    syncs_with: "policy_engine.py"
+    runs_validation: true
+
+  session_rules:
+    source: ".agent/memory/session_rules.json"
+    loads_at_checkpoint: true
+
+# =============================================================================
+# METRICS
+# =============================================================================
+
+metrics:
+  track:
+    - checkpoints_triggered
+    - rules_reinjected
+    - violations_caught
+    - response_validity_rate
+
+  report:
+    frequency: "on_session_end"
+    output: ".agent/memory/checkpoint_metrics.json"

package/.agent/core/CLEANUP_ENGINE.yaml

@@ -0,0 +1,326 @@
+# DOMYH Awesome Code — Context Cleanup Engine v6.2.0
+# Automated context management and token optimization
+
+version: "6.1.2"
+engine: context_cleanup
+
+# =============================================================================
+# CLEANUP TRIGGERS
+# =============================================================================
+
+triggers:
+  # Token-based triggers (reference TOKEN_BUDGETS.yaml as SSoT)
+  token_threshold:
+    reference: core/TOKEN_BUDGETS.yaml
+    use:
+      warning: workflow.thresholds.high_load # 8000
+      critical: workflow.thresholds.peak_usage # 12000
+      emergency: global.max_allowed # 25000 (was 12000 - aligned with SSoT)
+
+  # Time-based triggers
+  time_based:
+    idle_minutes: 30 # Cleanup if idle
+    session_hours: 4 # Cleanup after long session
+    last_cleanup_hours: 2 # Minimum between cleanups
+
+  # Event-based triggers
+  event_based:
+    on_workflow_switch: true
+    on_phase_complete: true
+    on_skill_unload: true
+    on_session_end: true
+    on_error_resolved: true
+    on_audit_complete: true
+
+# =============================================================================
+# CLEANUP ACTIONS BY TRIGGER
+# =============================================================================
+
+actions:
+  # When switching workflows
+  on_workflow_switch:
+    priority: 1
+    steps:
+      - unload_previous_workflow:
+          except: [core_context, decisions]
+
+      - summarize_completed_work:
+          max_tokens: 150
+          append_to: session.md
+
+      - reset_skill_context:
+          keep_active: 3
+          unload_dormant: true
+
+      - update_session_cache:
+          fields: [last_workflow, active_skills]
+
+    token_savings: "~2000"
+
+  # When phase completes (e.g., PLANNING → EXECUTION)
+  on_phase_complete:
+    priority: 2
+    steps:
+      - archive_phase_artifacts:
+          destination: memory/archive/phases/
+
+      - compress_phase_notes:
+          keep_summary: true
+          max_tokens: 200
+
+      - update_state:
+          fields: [current_phase, phase_history]
+
+      - log_phase_decision:
+          append_to: decisions.md
+
+    token_savings: "~1500"
+
+  # At warning threshold (8000 tokens)
+  at_warning_threshold:
+    priority: 3
+    steps:
+      - trigger_light_summarization:
+          level: light
+
+      - unload_optional_skills:
+          keep: [current_active]
+
+      - compress_session_notes:
+          target_tokens: 1500
+
+      - clear_resolved_items:
+          types: [errors, todos]
+
+    token_savings: "~2500"
+
+  # At critical threshold (10000 tokens)
+  at_critical_threshold:
+    priority: 4
+    steps:
+      - trigger_medium_summarization:
+          level: medium
+
+      - force_unload_all_skills:
+          except: [primary]
+
+      - archive_session_notes:
+          keep_summary_only: true
+
+      - compact_state_json:
+          remove_history: true
+          keep_current: true
+
+      - alert_user:
+          message: "⚠️ Context nearing limit. Running cleanup..."
+
+    token_savings: "~4000"
+
+  # Emergency threshold (12000 tokens)
+  at_emergency_threshold:
+    priority: 5
+    steps:
+      - trigger_aggressive_summarization:
+          level: aggressive
+
+      - nuclear_cleanup:
+          keep_only: [current_task, critical_errors]
+
+      - reset_session:
+          backup: true
+          create_handoff: true
+
+      - alert_user:
+          message: "🚨 Context limit reached. Session reset. Use /recap to continue."
+
+    token_savings: "~6000+"
+
+  # On session end
+  on_session_end:
+    priority: 1
+    steps:
+      - save_all_memory_layers:
+          layers: [session, state, decisions]
+
+      - create_session_summary:
+          max_tokens: 300
+          include: [completed, pending, decisions]
+
+      - archive_session:
+          path: memory/archive/sessions/
+
+      - reset_working_memory:
+          clear_all: true
+
+      - update_metrics:
+          fields: [session_duration, tokens_used, workflows_run]
+
+# =============================================================================
+# SKILL MANAGEMENT
+# =============================================================================
+
+skill_cleanup:
+  # Maximum active skills
+  max_active: 3
+
+  # Auto-unload after inactivity
+  inactivity_timeout_minutes: 5
+
+  # Priority order (keep these longer)
+  priority_skills:
+    - current_language_skill
+    - active_framework_skill
+    - debugging_skill_if_errors
+
+  # Rules for unloading
+  unload_rules:
+    - if_not_used_in: 5 minutes
+    - if_workflow_switched: true
+    - if_token_threshold_reached: true
+    - preserve_if_errors_active: true
+
+  # On unload actions
+  on_unload:
+    - log_to_session: true
+    - save_skill_state: false # Skills are stateless
+    - update_cache: true
+
+# =============================================================================
+# WORKFLOW CONTEXT MANAGEMENT
+# =============================================================================
+
+workflow_cleanup:
+  # On workflow switch
+  on_switch:
+    unload_previous: true
+    keep_decisions: true
+    keep_errors: true
+    summarize_completed: true
+
+  # Workflow-specific cleanup
+  by_workflow:
+    /ap: # Audit
+      on_complete:
+        - save_to_audit_summary: true
+        - archive_detailed_report: true
+        - keep_scores_in_state: true
+
+    /code: # Coding
+      on_complete:
+        - log_files_changed: true
+        - save_decisions: true
+        - clear_debug_context: true
+
+    /debug: # Debugging
+      on_complete:
+        - archive_error_trace: true
+        - log_resolution: true
+        - update_error_patterns: true
+
+    /deploy: # Deployment
+      on_complete:
+        - save_deployment_log: true
+        - update_state_version: true
+        - archive_pre_deploy_state: true
+
+# =============================================================================
+# ERROR CONTEXT MANAGEMENT
+# =============================================================================
+
+error_cleanup:
+  # Keep errors until resolved
+  keep_while_active: true
+
+  # On error resolved
+  on_resolved:
+    - archive_to: memory/archive/errors/
+    - log_resolution: session.md
+    - update_pattern_db: true
+
+  # Automatic cleanup
+  auto_cleanup:
+    resolved_after_hours: 2
+    orphaned_after_hours: 24
+    max_archived: 50
+
+  # What to preserve
+  preserve:
+    - error_type
+    - file_and_line
+    - resolution_summary
+
+  # What to remove
+  remove:
+    - full_stack_trace
+    - verbose_logs
+    - duplicate_instances
+
+# =============================================================================
+# MEMORY FILE CLEANUP
+# =============================================================================
+
+file_cleanup:
+  session_md:
+    max_tokens: 2000
+    on_exceed:
+      - archive_old_content
+      - keep_recent_section
+      - update_summary_section
+
+  decisions_md:
+    max_entries: 50
+    on_exceed:
+      - archive_oldest
+      - keep_in_memory: 20
+
+  state_json:
+    max_history_items: 10
+    on_exceed:
+      - trim_history
+      - keep_latest
+
+  audit_summary_json:
+    max_history_entries: 20
+    on_exceed:
+      - consolidate_old
+      - keep_summary_stats
+
+# =============================================================================
+# CLEANUP SCHEDULING
+# =============================================================================
+
+schedule:
+  # Check triggers every N interactions
+  check_interval: 5
+
+  # Force check on these events
+  force_check:
+    - after_large_operation
+    - after_file_read
+    - after_skill_load
+
+  # Background cleanup (if supported)
+  background:
+    enabled: false # Not supported in current env
+    interval_minutes: 10
+
+# =============================================================================
+# METRICS & LOGGING
+# =============================================================================
+
+metrics:
+  track:
+    - cleanup_count
+    - tokens_saved_total
+    - average_compression_ratio
+    - trigger_frequency
+
+  log:
+    file: memory/cleanup_log.json
+    keep_days: 7
+    format: json
+
+  alert_on:
+    - emergency_cleanup_triggered
+    - session_reset_forced
+    - archive_size_limit_reached