lunar-skills 1.0.0

package/data/milestones/MILESTONE-004.json

@@ -0,0 +1,112 @@
+{
+  "milestoneId": "MILESTONE-004",
+  "compactedAt": "2026-07-28T09:37:27.230Z",
+  "totalCardsCompacted": 10,
+  "scopesIncluded": [
+    "SCOPE_CORE_ENGINE",
+    "SCOPE_DIAGRAM"
+  ],
+  "summary": "Hồ sơ nén 10 thẻ công việc từ CARD-011 đến CARD-010",
+  "cards": [
+    {
+      "id": "CARD-011",
+      "prompt": "Nghiệp vụ kiểm thử nén số 6",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 6...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:26:40.333Z",
+      "completedAt": "2026-07-28T09:26:40.334Z"
+    },
+    {
+      "id": "CARD-002",
+      "prompt": "Nghiệp vụ kiểm thử nén số 7",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 7...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:26:40.334Z",
+      "completedAt": "2026-07-28T09:26:40.334Z"
+    },
+    {
+      "id": "CARD-003",
+      "prompt": "Nghiệp vụ kiểm thử nén số 8",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 8...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:26:40.334Z",
+      "completedAt": "2026-07-28T09:26:40.334Z"
+    },
+    {
+      "id": "CARD-004",
+      "prompt": "Nghiệp vụ kiểm thử nén số 9",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 9...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:26:40.334Z",
+      "completedAt": "2026-07-28T09:26:40.335Z"
+    },
+    {
+      "id": "CARD-005",
+      "prompt": "Nghiệp vụ kiểm thử nén số 10",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 10...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:26:40.335Z",
+      "completedAt": "2026-07-28T09:37:27.224Z"
+    },
+    {
+      "id": "CARD-006",
+      "prompt": "Vẽ lại sơ đồ kiến trúc hệ thống",
+      "title": "Task: Vẽ lại sơ đồ kiến trúc hệ thống...",
+      "scope": "SCOPE_DIAGRAM",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.226Z",
+      "completedAt": "2026-07-28T09:37:27.227Z"
+    },
+    {
+      "id": "CARD-007",
+      "prompt": "Nghiệp vụ kiểm thử nén số 1",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 1...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.227Z",
+      "completedAt": "2026-07-28T09:37:27.228Z"
+    },
+    {
+      "id": "CARD-008",
+      "prompt": "Nghiệp vụ kiểm thử nén số 2",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 2...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.228Z",
+      "completedAt": "2026-07-28T09:37:27.228Z"
+    },
+    {
+      "id": "CARD-009",
+      "prompt": "Nghiệp vụ kiểm thử nén số 3",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 3...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.228Z",
+      "completedAt": "2026-07-28T09:37:27.229Z"
+    },
+    {
+      "id": "CARD-010",
+      "prompt": "Nghiệp vụ kiểm thử nén số 4",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 4...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.229Z",
+      "completedAt": "2026-07-28T09:37:27.229Z"
+    }
+  ]
+}

package/data/milestones/MILESTONE-005.json

@@ -0,0 +1,112 @@
+{
+  "milestoneId": "MILESTONE-005",
+  "compactedAt": "2026-07-28T11:19:51.187Z",
+  "totalCardsCompacted": 10,
+  "scopesIncluded": [
+    "SCOPE_CORE_ENGINE",
+    "SCOPE_DIAGRAM"
+  ],
+  "summary": "Hồ sơ nén 10 thẻ công việc từ CARD-011 đến CARD-010",
+  "cards": [
+    {
+      "id": "CARD-011",
+      "prompt": "Nghiệp vụ kiểm thử nén số 5",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 5...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.229Z",
+      "completedAt": "2026-07-28T09:37:27.232Z"
+    },
+    {
+      "id": "CARD-002",
+      "prompt": "Nghiệp vụ kiểm thử nén số 6",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 6...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.232Z",
+      "completedAt": "2026-07-28T09:37:27.232Z"
+    },
+    {
+      "id": "CARD-003",
+      "prompt": "Nghiệp vụ kiểm thử nén số 7",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 7...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.232Z",
+      "completedAt": "2026-07-28T09:37:27.232Z"
+    },
+    {
+      "id": "CARD-004",
+      "prompt": "Nghiệp vụ kiểm thử nén số 8",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 8...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.232Z",
+      "completedAt": "2026-07-28T09:37:27.233Z"
+    },
+    {
+      "id": "CARD-005",
+      "prompt": "Nghiệp vụ kiểm thử nén số 9",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 9...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.233Z",
+      "completedAt": "2026-07-28T09:37:27.233Z"
+    },
+    {
+      "id": "CARD-006",
+      "prompt": "Nghiệp vụ kiểm thử nén số 10",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 10...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T09:37:27.233Z",
+      "completedAt": "2026-07-28T11:19:51.182Z"
+    },
+    {
+      "id": "CARD-007",
+      "prompt": "Vẽ lại sơ đồ kiến trúc hệ thống",
+      "title": "Task: Vẽ lại sơ đồ kiến trúc hệ thống...",
+      "scope": "SCOPE_DIAGRAM",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.184Z",
+      "completedAt": "2026-07-28T11:19:51.185Z"
+    },
+    {
+      "id": "CARD-008",
+      "prompt": "Nghiệp vụ kiểm thử nén số 1",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 1...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.185Z",
+      "completedAt": "2026-07-28T11:19:51.186Z"
+    },
+    {
+      "id": "CARD-009",
+      "prompt": "Nghiệp vụ kiểm thử nén số 2",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 2...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.186Z",
+      "completedAt": "2026-07-28T11:19:51.186Z"
+    },
+    {
+      "id": "CARD-010",
+      "prompt": "Nghiệp vụ kiểm thử nén số 3",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 3...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.186Z",
+      "completedAt": "2026-07-28T11:19:51.186Z"
+    }
+  ]
+}

package/data/milestones/MILESTONE-006.json

@@ -0,0 +1,112 @@
+{
+  "milestoneId": "MILESTONE-006",
+  "compactedAt": "2026-07-28T11:56:33.213Z",
+  "totalCardsCompacted": 10,
+  "scopesIncluded": [
+    "SCOPE_CORE_ENGINE",
+    "SCOPE_DIAGRAM"
+  ],
+  "summary": "Hồ sơ nén 10 thẻ công việc từ CARD-011 đến CARD-010",
+  "cards": [
+    {
+      "id": "CARD-011",
+      "prompt": "Nghiệp vụ kiểm thử nén số 4",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 4...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.186Z",
+      "completedAt": "2026-07-28T11:19:51.188Z"
+    },
+    {
+      "id": "CARD-002",
+      "prompt": "Nghiệp vụ kiểm thử nén số 5",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 5...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.188Z",
+      "completedAt": "2026-07-28T11:19:51.188Z"
+    },
+    {
+      "id": "CARD-003",
+      "prompt": "Nghiệp vụ kiểm thử nén số 6",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 6...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.188Z",
+      "completedAt": "2026-07-28T11:19:51.188Z"
+    },
+    {
+      "id": "CARD-004",
+      "prompt": "Nghiệp vụ kiểm thử nén số 7",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 7...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.188Z",
+      "completedAt": "2026-07-28T11:19:51.189Z"
+    },
+    {
+      "id": "CARD-005",
+      "prompt": "Nghiệp vụ kiểm thử nén số 8",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 8...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.189Z",
+      "completedAt": "2026-07-28T11:19:51.189Z"
+    },
+    {
+      "id": "CARD-006",
+      "prompt": "Nghiệp vụ kiểm thử nén số 9",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 9...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.189Z",
+      "completedAt": "2026-07-28T11:19:51.189Z"
+    },
+    {
+      "id": "CARD-007",
+      "prompt": "Nghiệp vụ kiểm thử nén số 10",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 10...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:19:51.189Z",
+      "completedAt": "2026-07-28T11:56:33.209Z"
+    },
+    {
+      "id": "CARD-008",
+      "prompt": "Vẽ lại sơ đồ kiến trúc hệ thống",
+      "title": "Task: Vẽ lại sơ đồ kiến trúc hệ thống...",
+      "scope": "SCOPE_DIAGRAM",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.210Z",
+      "completedAt": "2026-07-28T11:56:33.211Z"
+    },
+    {
+      "id": "CARD-009",
+      "prompt": "Nghiệp vụ kiểm thử nén số 1",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 1...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.211Z",
+      "completedAt": "2026-07-28T11:56:33.212Z"
+    },
+    {
+      "id": "CARD-010",
+      "prompt": "Nghiệp vụ kiểm thử nén số 2",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 2...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.212Z",
+      "completedAt": "2026-07-28T11:56:33.212Z"
+    }
+  ]
+}

package/data/milestones/MILESTONE-007.json

@@ -0,0 +1,112 @@
+{
+  "milestoneId": "MILESTONE-007",
+  "compactedAt": "2026-07-28T12:43:56.225Z",
+  "totalCardsCompacted": 10,
+  "scopesIncluded": [
+    "SCOPE_CORE_ENGINE",
+    "SCOPE_DIAGRAM"
+  ],
+  "summary": "Hồ sơ nén 10 thẻ công việc từ CARD-011 đến CARD-010",
+  "cards": [
+    {
+      "id": "CARD-011",
+      "prompt": "Nghiệp vụ kiểm thử nén số 3",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 3...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.212Z",
+      "completedAt": "2026-07-28T11:56:33.213Z"
+    },
+    {
+      "id": "CARD-002",
+      "prompt": "Nghiệp vụ kiểm thử nén số 4",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 4...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.214Z",
+      "completedAt": "2026-07-28T11:56:33.214Z"
+    },
+    {
+      "id": "CARD-003",
+      "prompt": "Nghiệp vụ kiểm thử nén số 5",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 5...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.214Z",
+      "completedAt": "2026-07-28T11:56:33.214Z"
+    },
+    {
+      "id": "CARD-004",
+      "prompt": "Nghiệp vụ kiểm thử nén số 6",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 6...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.214Z",
+      "completedAt": "2026-07-28T11:56:33.215Z"
+    },
+    {
+      "id": "CARD-005",
+      "prompt": "Nghiệp vụ kiểm thử nén số 7",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 7...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.215Z",
+      "completedAt": "2026-07-28T11:56:33.215Z"
+    },
+    {
+      "id": "CARD-006",
+      "prompt": "Nghiệp vụ kiểm thử nén số 8",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 8...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.215Z",
+      "completedAt": "2026-07-28T11:56:33.216Z"
+    },
+    {
+      "id": "CARD-007",
+      "prompt": "Nghiệp vụ kiểm thử nén số 9",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 9...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.216Z",
+      "completedAt": "2026-07-28T11:56:33.216Z"
+    },
+    {
+      "id": "CARD-008",
+      "prompt": "Nghiệp vụ kiểm thử nén số 10",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 10...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T11:56:33.216Z",
+      "completedAt": "2026-07-28T12:43:56.221Z"
+    },
+    {
+      "id": "CARD-009",
+      "prompt": "Vẽ lại sơ đồ kiến trúc hệ thống",
+      "title": "Task: Vẽ lại sơ đồ kiến trúc hệ thống...",
+      "scope": "SCOPE_DIAGRAM",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T12:43:56.222Z",
+      "completedAt": "2026-07-28T12:43:56.223Z"
+    },
+    {
+      "id": "CARD-010",
+      "prompt": "Nghiệp vụ kiểm thử nén số 1",
+      "title": "Task: Nghiệp vụ kiểm thử nén số 1...",
+      "scope": "SCOPE_CORE_ENGINE",
+      "category": "Nghiệp vụ mới",
+      "status": "DONE",
+      "createdAt": "2026-07-28T12:43:56.223Z",
+      "completedAt": "2026-07-28T12:43:56.224Z"
+    }
+  ]
+}

package/docs/adr/ADR-001.md

@@ -0,0 +1,31 @@
+# ADR-001: Selection of File-Based Hierarchical Compaction over SQL/Docker
+
+- **Status:** APPROVED
+- **Date:** 2026-07-27
+- **Deciders:** Principal Solution Architect & User
+
+---
+
+## CONTEXT
+During early development, Docker containers and PostgreSQL/Prisma database schemas were created for fullstack deployment. However, for a lightweight, zero-friction AI Skill Framework, running Docker and SQL services locally created unnecessary infrastructure overhead and environment dependencies.
+
+## DECISION
+We decided to **eliminate Docker and SQL database dependencies completely** from the core skill framework repository. Instead, we implemented a 3-Tier File-Based Hierarchical Compaction Engine (`data/cards.json` -> `data/milestones/` -> `data/reports/`).
+
+```mermaid
+graph LR
+    RawCards["10 Cards (cards.json)"] -->|Compaction Engine| Milestone["1 Milestone (data/milestones/)"]
+    Milestone -->|Executive Summarizer| MasterReport["1 Macro Report (data/reports/)"]
+```
+
+## PROS
+1. **Zero Infrastructure Overhead**: Runs 100% natively on Node.js with zero external dependencies.
+2. **Context Window Optimization**: Keeps active card files lightweight (<10 cards) to avoid prompt token bloating.
+3. **High Portability**: The skill repository can be cloned or copied as a single lightweight folder.
+
+## CONS
+1. High-concurrency ACID transactions require locking mechanisms on JSON files.
+
+## ALTERNATIVES CONSIDERED
+- PostgreSQL + Prisma ORM (Rejected due to setup complexity for local CLI skill users).
+- SQLite (Considered, but JSON/Markdown provides direct human readability).

package/docs/adr/ADR-002.md

@@ -0,0 +1,28 @@
+# ADR-002: Implementation of Scope Enforcer Boundary Guard
+
+- **Status:** APPROVED
+- **Date:** 2026-07-27
+- **Deciders:** Principal Solution Architect & User
+
+---
+
+## CONTEXT
+Unrestricted AI Subagent execution often leads to context drift, unwanted modifications across unrelated source files, and excessive prompt token consumption.
+
+## DECISION
+We implemented a strict Scope Boundary Guard (`scripts/scope-enforcer.js`). Every card created is assigned an explicit scope (e.g. `SCOPE_DIAGRAM`, `SCOPE_CORE_ENGINE`, `SCOPE_SECURITY`, `SCOPE_PAYMENT`). File modifications outside the allowed scope paths are blocked automatically.
+
+```mermaid
+graph TD
+    Action["AI Action Request"] --> CheckScope{"File in Card Scope Allowed Paths?"}
+    CheckScope -->|Yes| Pass["SCOPE_PASSED ✅"]
+    CheckScope -->|No| Block["SCOPE_VIOLATION_BLOCKED ⛔"]
+```
+
+## PROS
+1. **Token Cost Control**: Prevents subagents from inspecting or modifying unrelated files.
+2. **Codebase Protection**: Eliminates side-effects and accidental regressions.
+3. **Structured Milestones**: Groups cards cleanly by scope when compacting into milestone files.
+
+## CONS
+1. Multi-scope cross-cutting refactoring tasks require explicit `GLOBAL_SCOPE` assignment.

package/docs/api/api-architecture.md

@@ -0,0 +1,70 @@
+# 8. API Architecture Documentation
+
+---
+
+## 🌐 8.1 API Overview & Server Implementation
+
+The API Server is implemented in `src/index.js` using Node.js native `http` module listening on port `3000` (configurable via `process.env.PORT`).
+
+```mermaid
+graph TD
+    Client["Client / Browser / CLI"] -->|HTTP Request| Server["src/index.js (HTTP Server Port 3000)"]
+    
+    Server --> Router{"URL Path Matcher"}
+    Router -->|GET /health<br>GET /api/health| HealthEP["Health Endpoint"]
+    Router -->|GET /api/skills| SkillsEP["Skills Manager Endpoint"]
+    Router -->|GET /api/cards| GetCardsEP["Get All Cards Endpoint"]
+    Router -->|POST /api/cards| PostCardEP["Create Card Endpoint"]
+    Router -->|GET /<br>GET /index.html| StaticEP["Static File Server (index.html)"]
+
+    PostCardEP --> Engine["CardManager (scripts/card-manager.js)"]
+    GetCardsEP --> Storage["data/cards.json"]
+```
+
+---
+
+## 📝 8.2 Endpoint Specifications
+
+### 1. `GET /api/health`
+- **Description**: Verifies API Server uptime and operational health.
+- **Response**: `200 OK`
+  ```json
+  {
+    "status": "UP",
+    "app": "Universal Community Auto-Idea Skill Engine",
+    "timestamp": "2026-07-27T19:50:00.000Z"
+  }
+  ```
+
+### 2. `GET /api/cards`
+- **Description**: Returns all active task cards from `data/cards.json`.
+- **Response**: `200 OK`
+  ```json
+  {
+    "status": "SUCCESS",
+    "totalCards": 2,
+    "cards": [ /* Card Objects Array */ ]
+  }
+  ```
+
+### 3. `POST /api/cards`
+- **Description**: Creates a new task card from a user prompt, detects its Scope, and triggers auto-compaction if needed.
+- **Request Payload**:
+  ```json
+  {
+    "prompt": "Tích hợp mã ngân hàng ting-ting",
+    "category": "Payment"
+  }
+  ```
+- **Response**: `201 Created`
+  ```json
+  {
+    "status": "SUCCESS",
+    "card": {
+      "id": "CARD-002",
+      "prompt": "Tích hợp mã ngân hàng ting-ting",
+      "scope": "SCOPE_PAYMENT",
+      "status": "IN_PROGRESS"
+    }
+  }
+  ```

package/docs/api/authentication-flow.md

@@ -0,0 +1,31 @@
+# 11. Authentication & Security Flow Documentation
+
+**Status in Current Source Code:** Local & CLI Direct Execution Mode (Authentication Middleware is *Not Implemented* for local CLI mode, but proposed below for Production Deployment).
+
+---
+
+## 🔒 11.1 Proposed Enterprise Security & Auth Architecture
+
+```mermaid
+graph TD
+    Client["Client App / Browser"] -->|1. POST /api/auth/login| AuthEP["Auth Controller"]
+    AuthEP -->|2. Verify Credentials| UserDB["User Account Store (Bcrypt Hash)"]
+    AuthEP -->|3. Issue JWT Token| TokenSigner["JWT Signer"]
+    
+    TokenSigner -->|4. Return Short-Lived Access Token| Client
+    TokenSigner -->|5. Set HTTP-Only Cookie| RefreshCookie["Refresh Token Cookie (HttpOnly, Secure)"]
+
+    Client -->|6. API Request + Bearer Token| APIGateway["API Gateway / Scope Middleware"]
+    APIGateway -->|7. Verify Token & RBAC Permissions| ScopeGuard["Scope Enforcer"]
+    ScopeGuard -->|8. Scope Passed| InternalEngine["Card Manager Engine"]
+```
+
+---
+
+## 🛡 11.2 Scope & Permission RBAC Table (Proposed Blueprint)
+
+| Role | Permitted Scopes | Allowed Operations |
+| :--- | :--- | :--- |
+| **USER / DEVELOPER** | `SCOPE_DIAGRAM`, `SCOPE_PAYMENT`, `SCOPE_CORE_ENGINE` | Tạo thẻ mới, đọc thẻ active, xem sơ đồ `index.html`. |
+| **ADMIN / ARCHITECT** | `GLOBAL_SCOPE` | Nén thẻ thủ công, dọn dẹp Milestones, sửa file hệ thống core. |
+| **GUEST** | `SCOPE_READONLY` | Chỉ được phép xem `index.html` và `GET /api/cards`. |

package/docs/api/data-flow.md

@@ -0,0 +1,21 @@
+# 10. Data Flow Diagram Documentation
+
+---
+
+## 🌊 10.1 End-to-End Data Flow Pipeline
+
+```mermaid
+graph TD
+    UserPrompt["1. User Prompt (Terminal/Gemini)"] -->|Input Text| API["2. API / CLI Interface (src/index.js)"]
+    API -->|Passes Prompt| Manager["3. Card Manager (scripts/card-manager.js)"]
+    
+    Manager -->|Validate Scope| ScopeGuard["4. Scope Enforcer (scripts/scope-enforcer.js)"]
+    ScopeGuard -->|Passed| SaveLevel0["5. Save Level 0: data/cards.json"]
+    
+    SaveLevel0 -->|10 Cards Milestone| Compactor["6. Compaction Engine"]
+    Compactor -->|Save Level 1| Milestones["7. Save Level 1: data/milestones/MILESTONE-xxx.json"]
+    Milestones -->|10 Milestones Macro| Reports["8. Save Level 2: data/reports/MASTER_REPORT_xxx.md"]
+
+    Manager -->|Reads Cards| Visualizer["9. Dashboard Visualizer (index.html)"]
+    Visualizer -->|Renders SVG/Mermaid| UserView["10. Live User Dashboard Display"]
+```

package/docs/architecture/dependency-diagram.md

@@ -0,0 +1,37 @@
+# 6. Dependency Diagram Documentation
+
+---
+
+## 🔗 6.1 Complete Call Chain & Dependency Flow
+
+```mermaid
+graph TD
+    UserClient["HTTP Client / Terminal"] -->|HTTP GET / POST| IndexJS["src/index.js (Server Controller)"]
+    
+    subgraph Internal_Engine ["Internal Engine Scope"]
+        IndexJS -->|Imports & Calls| CardManager["scripts/card-manager.js (Business Engine)"]
+        CardManager -->|Validates Action| ScopeEnforcer["scripts/scope-enforcer.js (Security Guard)"]
+    end
+
+    subgraph Data_Persistence ["Data Persistence Layer"]
+        CardManager -->|Reads/Writes Active Cards| CardsJSON["data/cards.json"]
+        CardManager -->|Writes Compacted Milestones| MilestonesDir["data/milestones/MILESTONE-xxx.json"]
+        CardManager -->|Writes Macro Reports| ReportsDir["data/reports/MASTER_REPORT_xxx.md"]
+    end
+
+    subgraph Visual_Output ["Visual Output Layer"]
+        IndexJS -->|Serves Static File| IndexHTML["index.html"]
+        IndexHTML -->|CDN Fetch| MermaidCDN["Mermaid.js CDN (mermaid.min.js)"]
+    end
+```
+
+---
+
+## 🔍 6.2 Full Dependency Matrix
+
+1. `src/index.js` ➔ `scripts/card-manager.js` (Required)
+2. `scripts/card-manager.js` ➔ `scripts/scope-enforcer.js` (Required)
+3. `scripts/card-manager.js` ➔ `data/cards.json` (Required, Auto-creates if missing)
+4. `scripts/card-manager.js` ➔ `data/milestones/` (Required, Auto-creates if missing)
+5. `scripts/card-manager.js` ➔ `data/reports/` (Required, Auto-creates if missing)
+6. `index.html` ➔ `https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js` (External CDN for rendering graphs)