@nockdev/awf 6.2.0

package/.agent/memory/README.md

@@ -0,0 +1,148 @@
+# 🧠 DOMYH Awesome Code Memory System
+
+> Version 6.1.2 — 4-Layer Hierarchical Memory Architecture
+
+---
+
+## Overview
+
+This directory contains the persistent memory system for DOMYH Awesome Code, enabling:
+
+- **Cross-session context** — Remember work across conversations
+- **Low token footprint** — Only ~5,500 tokens total (~4.3% of limit)
+- **Human-readable files** — Easy to review and edit
+- **Structured data** — Fast JSON lookups
+
+---
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│ Layer 1: WORKING MEMORY (in-context)        ~500 tokens      │
+│ └── Managed automatically by agent                           │
+├──────────────────────────────────────────────────────────────┤
+│ Layer 2: SESSION NOTES (file-based)         ~2,000 tokens    │
+│ └── session.md — Current session context                     │
+├──────────────────────────────────────────────────────────────┤
+│ Layer 3: PROJECT STATE (JSON)               ~500 tokens      │
+│ ├── state.json — Project info, preferences                   │
+│ ├── audit_summary.json — Compact audit results               │
+│ └── decisions.md — Architectural decisions log               │
+├──────────────────────────────────────────────────────────────┤
+│ Layer 4: SEMANTIC MEMORY (optional)         ~2,500 tokens    │
+│ └── vectors/ — LanceDB (when enabled)                        │
+└──────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Files
+
+| File                 | Purpose                        | Format   | Max Tokens |
+| -------------------- | ------------------------------ | -------- | ---------- |
+| `session.md`         | Current session notes, history | Markdown | 2,000      |
+| `decisions.md`       | Architectural decisions log    | Markdown | 500        |
+| `state.json`         | Project state, preferences     | JSON     | 500        |
+| `audit_summary.json` | Compact audit results          | JSON     | 200        |
+| `vectors/`           | Semantic memory (optional)     | LanceDB  | 2,500      |
+
+---
+
+## Auto-Save Triggers
+
+The memory system automatically saves when:
+
+| Trigger               | Files Updated                      |
+| --------------------- | ---------------------------------- |
+| Workflow completes    | `session.md`, `state.json`         |
+| Decision made         | `decisions.md`, `state.json`       |
+| Audit completes       | `audit_summary.json`, `state.json` |
+| Error resolved        | `session.md`                       |
+| Every 10 interactions | `session.md`                       |
+| Session ends          | All files                          |
+
+---
+
+## Auto-Load Triggers
+
+Memory is loaded when:
+
+| Event            | Layers Loaded         |
+| ---------------- | --------------------- |
+| Session starts   | State, Session notes  |
+| `/recap` command | All layers            |
+| Context request  | State only            |
+| Semantic search  | Semantic (if enabled) |
+
+---
+
+## Configuration
+
+Memory engine configuration: `core/MEMORY_ENGINE.yaml`
+
+Key settings:
+
+```yaml
+# Token budgets per layer
+layer_budgets:
+  working: 500
+  session: 2000
+  state: 500
+  semantic: 2500 # Only if enabled
+
+# Auto-save interval
+auto_save_interval_ms: 300000 # 5 minutes
+
+# Cleanup threshold
+auto_cleanup_threshold_tokens: 10000
+```
+
+---
+
+## Usage
+
+### View Current Memory
+
+```
+/recap
+```
+
+### Clear Session Memory
+
+```
+/clear session
+```
+
+### Force Save
+
+```
+/save memory
+```
+
+### Enable Semantic Memory
+
+Edit `core/MEMORY_ENGINE.yaml`:
+
+```yaml
+semantic:
+  enabled: true
+```
+
+---
+
+## Human Editing
+
+All markdown files are safe to edit manually:
+
+- `session.md` — Add notes, correct info
+- `decisions.md` — Update rationale, add context
+
+JSON files should maintain schema:
+
+- `state.json` — Use valid JSON
+- `audit_summary.json` — Keep structure intact
+
+---
+
+_DOMYH Awesome Code — Memory System_

package/.agent/memory/active_memories.json

@@ -0,0 +1,35 @@
+{
+  "version": "1.0.0",
+  "last_updated": null,
+  "memories": [],
+  "categories": {
+    "preferences": [],
+    "decisions": [],
+    "patterns": [],
+    "corrections": [],
+    "contexts": [],
+    "insights": []
+  },
+  "stats": {
+    "total_count": 0,
+    "by_category": {},
+    "by_importance": {},
+    "average_weight": 0
+  },
+  "schema": {
+    "id": "uuid",
+    "content": "string",
+    "category": "enum(preferences,decisions,patterns,corrections,contexts,insights)",
+    "weight": "float (0.0-2.0)",
+    "importance": "enum(critical,high,medium,low,minimal)",
+    "created_at": "timestamp",
+    "updated_at": "timestamp",
+    "accessed_count": "int",
+    "last_accessed": "timestamp",
+    "links": "array[uuid]",
+    "keywords": "array[string]",
+    "source": "string",
+    "confidence": "float (0.0-1.0)",
+    "reviewed": "boolean"
+  }
+}

package/.agent/memory/audit_summary.json

@@ -0,0 +1,58 @@
+{
+  "version": "1.1.0",
+  "last_updated": "2026-02-04T09:40:00+07:00",
+  
+  "summary": {
+    "total_audits": 3,
+    "last_audit_date": "2026-02-04",
+    "overall_score": 9.2,
+    "trend": "improving"
+  },
+  
+  "latest_audit": {
+    "date": "2026-02-04",
+    "type": "full",
+    "score": 9.2,
+    "issues_summary": "P0:0, P1:0, P2:3, P3:7",
+    "fixed_count": 8,
+    "pending_count": 7,
+    "scope": "Workflows (31) + Memory System (16)"
+  },
+  
+  "history": [
+    {
+      "date": "2026-02-04",
+      "type": "full",
+      "score": 9.2,
+      "scope": "Workflows + Memory System"
+    },
+    {
+      "date": "2026-02-01",
+      "type": "re-audit",
+      "score": 8.8,
+      "scope": "Core + Rules + Skills + Memory + Workflows"
+    },
+    {
+      "date": "2026-02-01",
+      "type": "full",
+      "score": 8.2,
+      "scope": "Core + Rules + Skills + Memory + Workflows"
+    }
+  ],
+  "history_max": 10,
+  
+  "top_recurring_issues": [
+    "Version string inconsistency across files",
+    "Stale data in memory files (audit_summary, state.json)",
+    "Metrics tracking not implemented (metrics.json zeros)"
+  ],
+  "recurring_max": 5,
+  
+  "recommendations": [
+    "Implement auto-sync for version strings",
+    "Add metrics tracking to workflows",
+    "Run /save after each session automatically"
+  ],
+  
+  "notes": "System production-ready. Workflows: 9.2/10, Memory: 8.5/10. Skills: 51, Workflows: 31."
+}

package/.agent/memory/cleanup_log.json

@@ -0,0 +1,34 @@
+{
+  "version": "1.1.0",
+  "created_at": null,
+  "last_cleanup": null,
+  
+  "triggers": {
+    "_ref": "rules/context-management.md",
+    "warning": 15000,
+    "high": 20000,
+    "critical": 25000,
+    "emergency": 28000
+  },
+  
+  "actions": {
+    "warning": "summarize_session",
+    "high": "archive_old_decisions",
+    "critical": "compress_metrics",
+    "emergency": "truncate_history"
+  },
+  
+  "history": [],
+  
+  "stats": {
+    "total_cleanups": 0,
+    "tokens_saved_total": 0,
+    "average_compression_ratio": 0,
+    "emergency_cleanups": 0
+  },
+  
+  "settings": {
+    "max_history_entries": 100,
+    "retention_days": 7
+  }
+}

package/.agent/memory/consolidated.md

@@ -0,0 +1,75 @@
+# DOMYH Awesome Code — Consolidated Memory View
+
+> Auto-generated consolidated view of all active memories
+> Optimized for minimal token usage while preserving key information
+
+---
+
+## Project Context
+
+**Project**: _(auto-filled)_  
+**Phase**: _(auto-filled)_  
+**Status**: _(auto-filled)_
+
+---
+
+## Key Decisions (Consolidated)
+
+<!-- Top 5 most relevant decisions -->
+
+_No consolidated decisions yet_
+
+---
+
+## Active Patterns
+
+<!-- Extracted and merged patterns -->
+
+_No patterns consolidated yet_
+
+---
+
+## User Preferences
+
+<!-- Merged from corrections and explicit preferences -->
+
+_No preferences recorded yet_
+
+---
+
+## Error Resolution Patterns
+
+<!-- Consolidated error-solution pairs -->
+
+_No error patterns yet_
+
+---
+
+## Quick Reference
+
+### Last Audit
+
+- **Score**: N/A
+- **Issues**: N/A
+- **Trend**: N/A
+
+### Active Tasks
+
+- None
+
+### Blockers
+
+- None
+
+---
+
+## Consolidation Log
+
+| Date | Items Merged | Tokens Saved | Strategy |
+| ---- | ------------ | ------------ | -------- |
+| -    | -            | -            | -        |
+
+---
+
+_Last consolidated: Never_  
+_Token count: ~200_

package/.agent/memory/core_memory/persona.json

@@ -0,0 +1,30 @@
+{
+  "block_id": "persona",
+  "description": "Agent's self-description and capabilities",
+  "version": "6.1.2",
+  "editable_by_agent": true,
+  "content": {
+    "name": "DOMYH Awesome Code Agent",
+    "version": "6.1.2",
+    "description": "AI-powered development assistant with advanced memory, reflection, and self-improvement capabilities.",
+    "capabilities": [
+      "Code generation in 51+ languages",
+      "Multi-expert audit and review",
+      "Semantic skill routing",
+      "Self-improving through reflection",
+      "Persistent memory across sessions"
+    ],
+    "personality": {
+      "communication_style": "Professional yet friendly",
+      "language": "Vietnamese (Tiếng Việt)",
+      "proactivity": "High - anticipates needs",
+      "error_handling": "Transparent and solution-focused"
+    },
+    "constraints": [
+      "Never execute destructive operations without confirmation",
+      "Always provide evidence for findings",
+      "Stop when information is ambiguous"
+    ]
+  },
+  "last_updated": "2026-02-03T15:12:00+07:00"
+}

package/.agent/memory/core_memory/project.json

@@ -0,0 +1,25 @@
+{
+  "block_id": "project",
+  "description": "Current project context",
+  "version": "6.1.2",
+  "editable_by_agent": true,
+  "content": {
+    "current_project": {
+      "name": null,
+      "type": null,
+      "language": null,
+      "framework": null,
+      "build_system": null
+    },
+    "context": {
+      "current_task": null,
+      "current_file": null,
+      "recent_files": [],
+      "environment": {}
+    },
+    "decisions": [],
+    "todos": [],
+    "blockers": []
+  },
+  "last_updated": "2026-02-03T15:12:00+07:00"
+}

package/.agent/memory/core_memory/rules.json

@@ -0,0 +1,29 @@
+{
+  "block_id": "rules",
+  "description": "Learned rules and patterns from experience",
+  "version": "6.1.2",
+  "editable_by_agent": true,
+  "content": {
+    "do_rules": [
+      "Always validate user input before processing",
+      "Provide file:line evidence for findings",
+      "Use language-specific best practices",
+      "Test changes before committing",
+      "Ask for clarification when ambiguous"
+    ],
+    "dont_rules": [
+      "Never hardcode secrets or credentials",
+      "Never delete files without confirmation",
+      "Never skip error handling",
+      "Never assume without evidence",
+      "Never ignore user corrections"
+    ],
+    "patterns": {
+      "error_patterns": [],
+      "success_patterns": [],
+      "user_preferences": []
+    },
+    "exceptions": []
+  },
+  "last_updated": "2026-02-03T15:12:00+07:00"
+}

package/.agent/memory/core_memory/user.json

@@ -0,0 +1,24 @@
+{
+  "block_id": "user",
+  "description": "User preferences and information learned over time",
+  "version": "6.1.2",
+  "editable_by_agent": true,
+  "content": {
+    "preferences": {
+      "language": "vi",
+      "communication_style": "concise",
+      "code_style": {
+        "prefer_types": true,
+        "prefer_documentation": true,
+        "prefer_tests": true
+      },
+      "frameworks": [],
+      "avoided_patterns": []
+    },
+    "skills_used": {},
+    "project_history": [],
+    "corrections": [],
+    "positive_feedback": []
+  },
+  "last_updated": "2026-02-03T15:12:00+07:00"
+}

package/.agent/memory/decisions.md

@@ -0,0 +1,40 @@
+# DOMYH Awesome Code — Architectural Decisions Log
+
+> Records key decisions made during development sessions.
+> Auto-updated when agent makes architectural or significant technical choices.
+
+---
+
+## Decision Template
+
+<!--
+Each decision follows this format:
+
+### [DATE] Decision Title
+- **Context**: What situation led to this decision
+- **Options Considered**: What alternatives were evaluated
+- **Decision**: What was chosen
+- **Rationale**: Why this choice was made
+- **Consequences**: Expected outcomes or trade-offs
+-->
+
+---
+
+## Decisions
+
+<!-- Auto-appended below this line -->
+
+### [Template] Example Decision
+
+- **Context**: Need to choose database for user data
+- **Options Considered**:
+  1. PostgreSQL - full relational
+  2. MongoDB - flexible schema
+  3. SQLite - embedded, simple
+- **Decision**: PostgreSQL
+- **Rationale**: Strong consistency needed, complex queries expected
+- **Consequences**: Requires more setup, but better long-term scalability
+
+---
+
+_This file is auto-managed by DOMYH Awesome Code. Manual edits are preserved._

package/.agent/memory/graph/knowledge_graph.json

@@ -0,0 +1,12 @@
+{
+  "version": "6.1.2",
+  "description": "Knowledge graph entities and relationships",
+  "entities": {},
+  "relationships": [],
+  "statistics": {
+    "entity_count": 0,
+    "relationship_count": 0,
+    "by_type": {}
+  },
+  "last_updated": "2026-02-03T15:12:00+07:00"
+}

package/.agent/memory/insights.md

@@ -0,0 +1,52 @@
+# DOMYH Awesome Code — Memory Insights
+
+> Auto-generated insights from memory reflection and analysis
+> Updated periodically through self-reflection process
+
+---
+
+## Current Session Insights
+
+<!-- Generated by ACTIVE_MEMORY reflection process -->
+
+### Patterns Detected
+
+_No patterns detected yet_
+
+### Recommendations
+
+_No recommendations yet_
+
+---
+
+## Historical Insights
+
+<!-- Accumulated insights from past sessions -->
+
+### Top Recurring Themes
+
+_None identified yet_
+
+### Successful Patterns
+
+_None identified yet_
+
+### Areas for Improvement
+
+_None identified yet_
+
+---
+
+## Memory Statistics
+
+| Metric            | Value |
+| ----------------- | ----- |
+| Total Memories    | 0     |
+| Active Memories   | 0     |
+| Archived Memories | 0     |
+| Consolidations    | 0     |
+| Last Reflection   | Never |
+
+---
+
+_Auto-updated by DOMYH Memory System_

package/.agent/memory/metrics.json

@@ -0,0 +1,48 @@
+{
+  "version": "1.1.0",
+  "created_at": null,
+  "last_updated": null,
+  
+  "retention": {
+    "max_sessions": 100,
+    "max_score_trend": 50,
+    "archive_path": "archive/"
+  },
+  
+  "sessions": {
+    "total": 0,
+    "average_duration_minutes": 0,
+    "average_tokens_used": 0
+  },
+  
+  "memory": {
+    "total_saves": 0,
+    "total_loads": 0,
+    "compression_events": 0,
+    "archive_events": 0
+  },
+  
+  "workflows": {
+    "total_executed": 0,
+    "by_type": {},
+    "most_used": null
+  },
+  
+  "decisions": {
+    "total_logged": 0,
+    "by_category": {}
+  },
+  
+  "audits": {
+    "total_completed": 0,
+    "average_score": 0,
+    "score_trend": []
+  },
+  
+  "cleanup": {
+    "light_triggers": 0,
+    "medium_triggers": 0,
+    "aggressive_triggers": 0,
+    "emergency_triggers": 0
+  }
+}

package/.agent/memory/patterns/errors.json

@@ -0,0 +1,11 @@
+{
+  "version": "6.1.2",
+  "description": "Learned error patterns for prevention",
+  "patterns": [],
+  "statistics": {
+    "total_errors": 0,
+    "prevented": 0,
+    "by_type": {}
+  },
+  "last_updated": "2026-02-03T15:12:00+07:00"
+}

package/.agent/memory/patterns/successes.json

@@ -0,0 +1,10 @@
+{
+  "version": "6.1.2",
+  "description": "Successful patterns for reinforcement",
+  "patterns": [],
+  "statistics": {
+    "total_successes": 0,
+    "by_category": {}
+  },
+  "last_updated": "2026-02-03T15:12:00+07:00"
+}