@leejungkiin/awkit 1.0.0

package/schemas/brain.schema.json

@@ -0,0 +1,342 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://antigravity.google/schemas/brain.schema.json",
+  "title": "AWF Brain Context Schema",
+  "description": "Static project knowledge - tech stack, DB schema, APIs, features. Session state moved to session.json",
+  "version": "1.1.0",
+  "type": "object",
+  "required": [
+    "meta",
+    "project",
+    "updatedAt"
+  ],
+  "properties": {
+    "meta": {
+      "type": "object",
+      "description": "Schema metadata",
+      "properties": {
+        "schemaVersion": {
+          "type": "string",
+          "default": "1.0.0"
+        },
+        "awfVersion": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "awfVersion"
+      ]
+    },
+    "project": {
+      "type": "object",
+      "description": "Project overview",
+      "properties": {
+        "name": { "type": "string" },
+        "description": { "type": "string" },
+        "type": {
+          "type": "string",
+          "enum": ["website", "webapp", "api", "fullstack", "mobile"]
+        },
+        "status": {
+          "type": "string",
+          "enum": ["planning", "development", "testing", "production", "maintenance"]
+        },
+        "repository": { "type": "string" },
+        "urls": {
+          "type": "object",
+          "properties": {
+            "local": { "type": "string" },
+            "staging": { "type": "string" },
+            "production": { "type": "string" }
+          }
+        }
+      },
+      "required": ["name", "type"]
+    },
+    "techStack": {
+      "type": "object",
+      "description": "Technology stack",
+      "properties": {
+        "frontend": {
+          "type": "object",
+          "properties": {
+            "framework": { "type": "string" },
+            "language": { "type": "string" },
+            "uiLibrary": {
+              "type": "string"
+            },
+            "stateManagement": {
+              "type": "string"
+            },
+            "styling": { "type": "string" }
+          }
+        },
+        "backend": {
+          "type": "object",
+          "properties": {
+            "framework": { "type": "string" },
+            "language": { "type": "string" },
+            "runtime": { "type": "string" }
+          }
+        },
+        "database": {
+          "type": "object",
+          "properties": {
+            "type": { "type": "string" },
+            "orm": { "type": "string" },
+            "name": { "type": "string" }
+          }
+        },
+        "infrastructure": {
+          "type": "object",
+          "properties": {
+            "hosting": { "type": "string" },
+            "cdn": { "type": "string" },
+            "ciCd": {
+              "type": "string"
+            }
+          }
+        },
+        "dependencies": {
+          "type": "array",
+          "description": "Key dependencies (not exhaustive, only notable ones)",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "version": { "type": "string" },
+              "purpose": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "architecture": {
+      "type": "object",
+      "description": "System architecture overview",
+      "properties": {
+        "pattern": {
+          "type": "string",
+          "description": "e.g., MVC, Clean Architecture, Microservices"
+        },
+        "modules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "path": { "type": "string" },
+              "responsibility": { "type": "string" },
+              "dependencies": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "external_services": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "purpose": { "type": "string" },
+              "envVars": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "databaseSchema": {
+      "type": "object",
+      "description": "Database structure",
+      "properties": {
+        "tables": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "description": { "type": "string" },
+              "columns": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": { "type": "string" },
+                    "type": { "type": "string" },
+                    "nullable": { "type": "boolean" },
+                    "primary": { "type": "boolean" },
+                    "foreignKey": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "relationships": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "from": { "type": "string" },
+              "to": { "type": "string" },
+              "type": { "type": "string", "enum": ["one-to-one", "one-to-many", "many-to-many"] },
+              "description": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "apiEndpoints": {
+      "type": "array",
+      "description": "API routes summary",
+      "items": {
+        "type": "object",
+        "properties": {
+          "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+          "path": { "type": "string" },
+          "description": { "type": "string" },
+          "authRequired": {
+            "type": "boolean"
+          },
+          "roles": { "type": "array", "items": { "type": "string" } },
+          "requestBody": {
+            "type": "object"
+          },
+          "response": { "type": "object" }
+        }
+      }
+    },
+    "businessRules": {
+      "type": "array",
+      "description": "Business logic rules",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "domain": { "type": "string" },
+          "rule": { "type": "string" },
+          "implementation": { "type": "string" },
+          "exceptions": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "features": {
+      "type": "array",
+      "description": "Implemented features",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "status": {
+            "type": "string",
+            "enum": ["planned", "in_progress", "implemented", "tested", "deployed"]
+          },
+          "specFile": {
+            "type": "string"
+          },
+          "files": { "type": "array", "items": { "type": "string" } },
+          "notes": { "type": "string" }
+        }
+      }
+    },
+    "knowledgeItems": {
+      "type": "object",
+      "description": "Learned patterns and gotchas",
+      "properties": {
+        "patterns": {
+          "type": "array",
+          "description": "Coding patterns used in this project",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "description": { "type": "string" },
+              "exampleFile": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "gotchas": {
+          "type": "array",
+          "description": "Known issues and workarounds",
+          "items": {
+            "type": "object",
+            "properties": {
+              "issue": { "type": "string" },
+              "cause": { "type": "string" },
+              "solution": { "type": "string" },
+              "affectedFiles": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "conventions": {
+          "type": "array",
+          "description": "Project-specific conventions",
+          "items": {
+            "type": "object",
+            "properties": {
+              "area": { "type": "string" },
+              "convention": { "type": "string" },
+              "example": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "environment": {
+      "type": "object",
+      "description": "Environment configuration",
+      "properties": {
+        "variables": {
+          "type": "array",
+          "description": "Required env vars (values NOT stored, only names)",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "description": { "type": "string" },
+              "required": { "type": "boolean" },
+              "example": { "type": "string" }
+            }
+          }
+        },
+        "scripts": {
+          "type": "object",
+          "description": "Common npm scripts",
+          "properties": {
+            "dev": { "type": "string" },
+            "build": { "type": "string" },
+            "test": { "type": "string" },
+            "lint": { "type": "string" }
+          }
+        }
+      }
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last update timestamp"
+    }
+  }
+}

package/schemas/preferences.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://antigravity.google/schemas/preferences.schema.json",
+  "title": "AWF User Preferences Schema",
+  "description": "User preferences for AI communication and working style",
+  "version": "2.0.0",
+  "type": "object",
+  "properties": {
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "communication": {
+      "type": "object",
+      "description": "How AI communicates",
+      "properties": {
+        "tone": {
+          "type": "string",
+          "enum": ["friendly", "professional", "casual", "custom"],
+          "default": "friendly",
+          "description": "Tone of voice"
+        },
+        "toneCustom": {
+          "type": "string",
+          "description": "Custom tone description if tone=custom"
+        },
+        "persona": {
+          "type": "string",
+          "enum": ["assistant", "mentor", "senior_dev", "partner", "coach", "custom"],
+          "default": "assistant",
+          "description": "AI personality"
+        },
+        "personaCustom": {
+          "type": "string",
+          "description": "Custom persona description if persona=custom"
+        }
+      }
+    },
+    "technical": {
+      "type": "object",
+      "description": "Technical detail preferences",
+      "properties": {
+        "detailLevel": {
+          "type": "string",
+          "enum": ["results_only", "simple", "learning", "full_technical"],
+          "default": "simple",
+          "description": "How much technical detail to show"
+        },
+        "autonomy": {
+          "type": "string",
+          "enum": ["ask_often", "balanced", "autonomous"],
+          "default": "ask_often",
+          "description": "How much AI decides on its own"
+        },
+        "quality": {
+          "type": "string",
+          "enum": ["mvp", "production", "enterprise"],
+          "default": "production",
+          "description": "Output quality level"
+        },
+        "technicalLevel": {
+          "type": "string",
+          "enum": ["newbie", "basic", "technical"],
+          "default": "basic",
+          "description": "User technical proficiency level for language adaptation"
+        }
+      }
+    },
+    "workingStyle": {
+      "type": "object",
+      "description": "How to work together",
+      "properties": {
+        "pace": {
+          "type": "string",
+          "enum": ["careful", "fast"],
+          "default": "careful",
+          "description": "Work pace preference"
+        },
+        "feedback": {
+          "type": "string",
+          "enum": ["gentle", "direct", "silent"],
+          "default": "gentle",
+          "description": "How AI gives feedback"
+        }
+      }
+    },
+    "customRules": {
+      "type": "array",
+      "description": "User-defined custom rules",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/schemas/session.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://antigravity.google/schemas/session.schema.json",
+  "title": "AWF Session State Schema",
+  "description": "Dynamic session state - changes frequently during work sessions",
+  "version": "1.0.0",
+  "type": "object",
+  "required": [
+    "updatedAt"
+  ],
+  "properties": {
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last update timestamp"
+    },
+    "workingOn": {
+      "type": "object",
+      "description": "Current work in progress",
+      "properties": {
+        "feature": { "type": "string", "description": "Feature name" },
+        "task": { "type": "string", "description": "Current task" },
+        "status": {
+          "type": "string",
+          "enum": ["planning", "coding", "testing", "debugging", "reviewing"],
+          "description": "Task status"
+        },
+        "currentPlanPath": {
+          "type": "string",
+          "description": "Path to current plan folder (e.g., plans/260117-1430-orders/)"
+        },
+        "currentPhase": {
+          "type": "string",
+          "description": "Current phase being worked on (e.g., phase-03)"
+        },
+        "files": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Files being modified"
+        },
+        "blockers": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Current blockers"
+        },
+        "notes": { "type": "string", "description": "Quick notes" }
+      }
+    },
+    "pendingTasks": {
+      "type": "array",
+      "description": "Tasks to do next",
+      "items": {
+        "type": "object",
+        "properties": {
+          "task": { "type": "string" },
+          "priority": { "type": "string", "enum": ["high", "medium", "low"] },
+          "notes": { "type": "string" }
+        },
+        "required": ["task", "priority"]
+      }
+    },
+    "recentChanges": {
+      "type": "array",
+      "description": "Recent changes in this session",
+      "items": {
+        "type": "object",
+        "properties": {
+          "timestamp": { "type": "string", "format": "date-time" },
+          "type": { "type": "string", "enum": ["feature", "bugfix", "refactor", "config", "docs"] },
+          "description": { "type": "string" },
+          "files": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "errorsEncountered": {
+      "type": "array",
+      "description": "Errors encountered and solutions",
+      "items": {
+        "type": "object",
+        "properties": {
+          "error": { "type": "string" },
+          "solution": { "type": "string" },
+          "resolved": { "type": "boolean" }
+        }
+      }
+    },
+    "decisionsMade": {
+      "type": "array",
+      "description": "Technical decisions made this session",
+      "items": {
+        "type": "object",
+        "properties": {
+          "decision": { "type": "string" },
+          "reason": { "type": "string" }
+        }
+      }
+    },
+    "skippedTests": {
+      "type": "array",
+      "description": "Tests that were skipped due to fix failures - blocks deploy!",
+      "items": {
+        "type": "object",
+        "properties": {
+          "test": { "type": "string", "description": "Test file name" },
+          "reason": { "type": "string", "description": "Why it was skipped" },
+          "date": { "type": "string", "format": "date-time" }
+        },
+        "required": ["test", "date"]
+      }
+    }
+  }
+}

package/skill-packs/neural-memory/README.md

@@ -0,0 +1,111 @@
+# 🧠 NeuralMemory Skill Pack
+
+> Recall Through Activation, Not Search.
+
+NeuralMemory là bộ nhớ sinh học cho AI — không tìm kiếm, mà **kích hoạt liên tưởng**
+qua mạng neuron. Skill pack này tích hợp NeuralMemory engine vào AWK framework.
+
+---
+
+## Why NeuralMemory vs RAG?
+
+| Aspect | RAG / Vector Search | NeuralMemory |
+|--------|---------------------|--------------|
+| **Model** | Search engine | Human brain |
+| **Query** | "Find similar text" | "Recall through activation" |
+| **Relationships** | None (just similarity) | Explicit: `CAUSED_BY`, `LEADS_TO`, `DISCUSSED` |
+| **Time awareness** | None | Temporal topology built-in |
+| **Causality** | None | "Why?" and "When?" questions |
+| **Forgetting** | Never (stale data) | Natural decay + priority |
+
+---
+
+## Install
+
+```bash
+awkit enable-pack neural-memory
+```
+
+Installs 4 skills into `~/.gemini/antigravity/skills/`:
+- `nm-memory-sync` — Drop-in upgrade cho ambient memory-sync
+- `nm-memory-intake` — Structured memory creation từ notes
+- `nm-memory-audit` — 6-dimension quality review
+- `nm-memory-evolution` — Evidence-based memory optimization
+
+---
+
+## Prerequisites
+
+```bash
+# 1. Install NeuralMemory Python package
+pip install neural-memory
+
+# 2. Configure MCP server in your AI tool
+# Add to MCP config:
+# { "mcpServers": { "neural-memory": { "command": "nmem", "args": ["server"] } } }
+
+# 3. Initialize a brain
+nmem init
+```
+
+> 💡 Tip: Chạy `awkit enable-pack neural-memory` để tự động cài pip + chạy nmem init.
+
+---
+
+## Skills
+
+### `nm-memory-sync` (Core)
+**Replaces:** `memory-sync` / `ambient-brain`  
+**Trigger:** Auto-activate on session start, debug, new task, errors  
+**Enhancement:** Uses NeuralMemory's associative graph instead of flat-file keyword matching
+
+```
+OLD: "keyword overlap > 2" → fuzzy recall  
+NEW: spreading activation → associative reflex recall
+```
+
+### `nm-memory-intake`
+**Trigger:** `/memory-intake "messy notes..."` hoặc sau planning sessions  
+**Role:** Memory Intake Specialist  
+**Process:** Triage → Clarify → Enrich → Deduplicate → Batch Store → Report
+
+### `nm-memory-audit`
+**Trigger:** `/memory-audit` hoặc tuần một lần  
+**Role:** Memory Quality Inspector  
+**Dimensions:** Purity · Freshness · Coverage · Clarity · Relevance · Structure
+
+### `nm-memory-evolution`
+**Trigger:** `/memory-evolution "focus area"` hoặc sau sprint  
+**Role:** Memory Evolution Strategist  
+**Process:** Analysis → Opportunities → Consolidate/Enrich/Prune → Normalize
+
+---
+
+## Typical Usage
+
+```
+# Sau planning session
+/memory-intake "Meeting notes: chose Redis for cache, Bob handles migration, deadline Friday"
+
+# Weekly cleanup  
+/memory-audit
+
+# Sau sprint
+/memory-evolution "focus on auth topic"
+
+# AI auto-sync runs on every session start (nm-memory-sync)
+```
+
+---
+
+## Workflows
+
+| Command | Description |
+|---------|-------------|
+| `/nm-recall` | Query NeuralMemory với associative recall |
+| `/nm-snapshot` | Export current brain state to JSON |
+| `/nm-import` | Import project decisions/errors into brain |
+
+---
+
+*NeuralMemory Skill Pack for AWKit v1.0 · Created by Kien AI*