npm - codex-genesis-harness - Versions diffs - 0.1.6 → 0.1.8 - Mend

codex-genesis-harness 0.1.6 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (136) hide show

package/README.EN.md CHANGED Viewed

@@ -27,6 +27,17 @@
 ---
+## 💖 Support the Project (Donate)
+This project is open-source and developed with passion. If you find **Genesis Codex Harness** helpful and it saves you time, consider buying me a coffee to keep the momentum going:
+- **Momo (Vietnam)**: `0865814259`
+- **PayPal**: *(Will be updated later)*
+Thank you so much for supporting the development of this project! ❤️
+---
 ## 🎯 Why Genesis? (ROI in 3 minutes)
 ### Before Genesis ❌
@@ -133,16 +144,27 @@ Genesis Codex Harness introduces five groundbreaking architectural subsystems to
 ---
-## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.6)
+## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.8)
-Genesis v0.1.6 introduces five advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, and enable self-healing loop memory recall:
+Genesis v0.1.8 introduces five advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, and enable self-healing loop memory recall:
 1. **Visual Architecture AST Sync (`scripts/spec_visual_sync.js`)**: Bidirectional compiler that syncs Mermaid ERD database diagrams (`database-erd.mmd`) to API contracts JSON schemas (`contracts/api/`) and vice-versa, establishing absolute visual-to-code design integrity.
 2. **Contract-Driven Test Auto-Generator (`scripts/test_generator.js`)**: Automatically compiles fully executable Mocha/Jest integration test suites in `tests/integration/` directly from your API contracts JSON response schemas, providing instant TDD "RED" skeletons.
 3. **AST Contract-Code Integrity Gate (`scripts/contract_integrity_gate.js`)**: Static analysis checker that programmatically validates implementation code properties against API contract JSON schemas at FSM transition boundaries, locking state transitions if data type mismatches or missing properties are detected.
-4. **Pre-emptive Prompt Sentinel (`scripts/prompt_sentinel.js`)**: Real-time token budget monitor. Calculates token weights before calling LLM, pre-emptively halting runaway commands, and executing auto-compaction and log pruning when capacity thresholds (e.g. 20k tokens) are crossed.
+4. **Pre-emptive Prompt Sentinel (`scripts/prompt_sentinel.js`)**: Real-time token budget monitor. Calculates token weights before calling LLM, pre-emptively halting runaway commands, and executing auto-compaction and log pruning when the LeanCTX threshold in `.codebase/context-policy.json` is crossed.
 5. **Self-Healing Lessons-Learned Recall (`scripts/healing_telemetry.js`)**: Telemetry system that records compiler/test failure signatures and applied corrective code edits in `.codebase/failures/lessons_learned.md`. The self-healing loop recalls these recorded fixes on identical error signatures, bypassing iterations to achieve immediate **1-turn recovery**.
+### LeanCTX + Optional Local Wrappers
+Genesis ships a portable LeanCTX policy at `.codebase/context-policy.json` and exposes it through:
+```bash
+genesis-harness leanctx
+genesis-harness prime
+```
+`npm install` / `genesis-harness install` seeds the policy into the current project when a project root is detected, and never overwrites an existing custom policy. The `leanctx` command is only for inspection. Npm users keep using portable commands such as `genesis-harness sync`, `genesis-harness docs-gate`, and `npm run verify`. When `rtk` exists on a developer machine, Genesis reports it as an optional local wrapper only; it is not a public dependency.
 ---
 ## 🔬 Research-First Guarantee (NEW)
@@ -611,17 +633,13 @@ Each skill follows the standard naming convention in `.codex/skills/`:
 | **genesis-api-sync** | Automate bi-directional contract & codebase synchronization | When endpoints are updated |
 | **genesis-spec-propagation** | Automatically cascade design specification updates downstream | When specs change |
 | **genesis-docs-automation** | Automatically synchronize system technical docs | Triggers after tests pass |
-| **ui-ux-test-skill** | Design and validate UI user journeys and visual test specs | Before frontend implementation |
+| **genesis-ui-ux-test** | Design and validate UI user journeys and visual test specs | Before frontend implementation |
 | **genesis-debug-guide** | Systematic, evidence-based debugging and troubleshooting | On compile errors or test failures |
 | **genesis-pipeline-orchestration** | Orchestrate multi-phase software development lifecycle | Complex multi-phase projects |
 | **genesis-architecture** | High-level system design and architecture decisions (ADRs) | Major design changes |
 | **genesis-planning** | Breakdown complex business requirements into micro-plans | Preparing large features |
-| **genesis-mvp-planning** | Automate the setup of a 5-Phase MVP Roadmap post-initialization | Runs right after initialization |
 | **genesis-codebase-map** | Build comprehensive dependency graphs and architecture maps | Navigating large codebases |
-| **genesis-docs** | Generate exhaustive technical engineering summaries | End of phase / release |
-| **genesis-research** | Search official docs, packages, and code patterns | Finding best practices |
-| **genesis-release** | Manage semantic versioning and Git release tags | Preparing releases |
-| **genesis-release-orchestration** | Generate release checklists, rollback plans, and runbooks | Before production deployment |
+| **genesis-release** | Manage semantic versioning, Git tags, runbooks, and rollback plans | Preparing releases & deployments |
 | **genesis-performance-profiling** | Measure system latency and execute runtime optimization | Before performance tuning |
 | **genesis-observability-automation** | Log autonomous decisions, ADR history, and tool outputs | Maintaining execution trace |
 | **genesis-ai-provider** | Monitor, budget, and optimize LLM token consumption | Safeguarding API token limits |
@@ -630,6 +648,10 @@ Each skill follows the standard naming convention in `.codex/skills/`:
 | **genesis-design-spec** | Define and manage design tokens and theme consistency | Standardizing design systems |
 | **genesis-harness-engineering** | Build test frameworks, harness structures, and test fixtures | Setting up test suites |
 | **spec-impact-engine** | Evaluate the blast radius of proposed specification changes | Assessing spec adjustments |
+| **genesis-executing-plans** | Strictly follow the approved execution plan and task.md | Implementing features via plan |
+| **genesis-test-driven-development** | Enforce TDD (Red -> Green -> Refactor) and test verification | Writing logic or bug fixes |
+| **genesis-verification-before-completion** | Require evidence and script execution before task completion | Finalizing any autonomous task |
+| **genesis-using-git-worktrees** | Isolate destructive or large architectural changes | High-risk refactoring |
 ---
@@ -738,17 +760,6 @@ npm run pack:check      # Check npm package
 ---
-## 💖 Support the Project (Donate)
-This project is open-source and developed with passion. If you find **Genesis Codex Harness** helpful and it saves you time, consider buying me a coffee to keep the momentum going:
-- **Momo (Vietnam)**: `0865814259`
-- **PayPal**: *(Will be updated later)*
-Thank you so much for supporting the development of this project! ❤️
----
 ## 🔗 Resources
 - **GitHub**: [codex-genesis-harness](https://github.com/tuanpham09/codex-genesis-harness)
@@ -765,7 +776,7 @@ Thank you so much for supporting the development of this project! ❤️
 - ✅ **Skills**: 25 fully implemented & verified (added 5-Phase MVP Roadmap planner, advanced self-healing and compaction engines)
 - ✅ **Test Coverage**: 80%+ required
 - ✅ **Token Savings**: 40-60%
-- ✅ **Production Ready**: Yes (v0.1.6)
+- ✅ **Production Ready**: Yes (v0.1.8)
 - ✅ **Auto-Research Enforcement**: Active
 - ✅ **Auto-Debug Verification**: Active
 - ✅ **Auto-Spec-Propagation**: Active
@@ -777,7 +788,7 @@ Thank you so much for supporting the development of this project! ❤️
 MIT License - See [LICENSE](LICENSE)
-**Genesis Codex Harness** - Build production software with Codex | v0.1.6 | June 2026
+**Genesis Codex Harness** - Build production software with Codex | v0.1.8 | June 2026
 ---

package/README.VI.md CHANGED Viewed

@@ -26,6 +26,17 @@
 ---
+## 💖 Ủng Hộ Dự Án (Donate)
+Dự án này là mã nguồn mở và được phát triển hoàn toàn vì đam mê. Nếu bạn thấy **Genesis Codex Harness** hữu ích và giúp bạn tiết kiệm thời gian, bạn có thể mời tôi một ly cafe để tiếp thêm động lực phát triển nhé:
+- **Momo**: `0865814259`
+- **PayPal**: *(Sẽ cập nhật sau)*
+Cảm ơn bạn rất nhiều vì đã đồng hành cùng sự phát triển của dự án! ❤️
+---
 ## 🎯 Tại Sao Dùng Genesis? (ROI trong 3 phút)
 ### Trước Genesis ❌
@@ -132,15 +143,27 @@ Genesis Codex Harness giới thiệu 5 phân hệ kỹ thuật mang tính đột
 ---
-## 🚀 Nâng Cấp Kỹ Nghệ Harness Thế Hệ Mới (v0.1.6)
+## 🚀 Nâng Cấp Kỹ Nghệ Harness Thế Hệ Mới (v0.1.8)
-Phiên bản Genesis v0.1.6 giới thiệu năm công cụ cao cấp, đột phá trong thư mục `scripts/` nhằm áp đặt an toàn kiểu dữ liệu, tự động hóa test, thiết lập sự đồng nhất giữa sơ đồ trực quan và mã nguồn, chủ động kiểm soát token và khôi phục nhanh bài học sửa lỗi của Ralph Loop:
+Phiên bản Genesis v0.1.8 giới thiệu sáu công cụ cao cấp, đột phá trong thư mục `scripts/` nhằm áp đặt an toàn kiểu dữ liệu, tự động hóa test, thiết lập sự đồng nhất giữa sơ đồ trực quan và mã nguồn, chủ động kiểm soát token, khôi phục nhanh bài học sửa lỗi và hỗ trợ lập trình UI thần tốc:
 1. **Đồng bộ Sơ đồ Trực quan 2 Chiều (`scripts/spec_visual_sync.js`)**: Trình biên dịch hai chiều tự động đồng bộ hóa sơ đồ cơ sở dữ liệu ERD Mermaid (`database-erd.mmd`) sang các tệp JSON API contracts (`contracts/api/`) và ngược lại, bảo vệ tính nhất quán thiết kế tuyệt đối.
 2. **Trình Tự Động Sinh Test từ Hợp Đồng (`scripts/test_generator.js`)**: Tự động biên dịch và tạo cấu trúc các bộ kiểm thử tích hợp (Node.js/Jest) hoàn chỉnh tại `tests/integration/` trực tiếp từ các file response contract JSON, hỗ trợ lập tức kịch bản TDD "RED" skeleton.
 3. **Cổng Kiểm Soát Đồng Nhất Kiểu Dữ Liệu Tĩnh (`scripts/contract_integrity_gate.js`)**: Trình phân tích tĩnh chủ động đối chiếu mã nguồn thực tế với JSON API contract khi FSM chuyển trạng thái, khóa cứng tiến trình build/commit nếu phát hiện trường dữ liệu bị thiếu hoặc sai lệch kiểu dữ liệu.
-4. **Vệ Binh Tiền Trảm Token Chủ Động (`scripts/prompt_sentinel.js`)**: Bộ giám sát dung lượng token thời gian thực. Sentinel đo lường tải lượng token trước khi gọi LLM, chủ động tạm dừng các lệnh quá nặng và kích hoạt nén FSM/dọn logs khi dung lượng chạm ngưỡng an toàn (ví dụ: 20k tokens).
+4. **Vệ Binh Tiền Trảm Token Chủ Động (`scripts/prompt_sentinel.js`)**: Bộ giám sát dung lượng token thời gian thực. Sentinel đo lường tải lượng token trước khi gọi LLM, chủ động tạm dừng các lệnh quá nặng và kích hoạt nén FSM/dọn logs khi dung lượng chạm ngưỡng LeanCTX trong `.codebase/context-policy.json`.
 5. **Tự Động Thu Hồi Bài Học Sửa Lỗi (`scripts/healing_telemetry.js`)**: Hệ thống ghi chép lịch sử chữ ký lỗi và mã nguồn sửa lỗi thành công vào `.codebase/failures/lessons_learned.md`. Vòng lặp Ralph Loop sẽ đối sánh và tái sử dụng trực tiếp các phương án sửa lỗi này khi gặp lỗi tương ứng, đạt hiệu suất **tự khắc phục lỗi chỉ trong đúng 1 turn**.
+6. **Aesthetic Vibe Mode (`VIBE_MODE=1`)**: Một hệ thống Triage linh hoạt cho phép AI tự động bỏ qua các bài test nghiêm ngặt (TDD/Contract) khi người dùng chỉ muốn chỉnh sửa giao diện thẩm mỹ (CSS/UI). Mọi vi phạm lách luật đều được ghi chép ngầm vào `.codebase/TECH_DEBT.md` để xử lý sau.
+### LeanCTX + wrapper local tùy chọn
+Genesis cài kèm policy LeanCTX portable tại `.codebase/context-policy.json` và cung cấp:
+```bash
+genesis-harness leanctx
+genesis-harness prime
+```
+`npm install` / `genesis-harness install` sẽ tự seed policy vào project hiện tại khi phát hiện project root, và không ghi đè policy đã custom. Lệnh `leanctx` chỉ để xem/kiểm tra policy. Người dùng cài từ npm vẫn dùng lệnh chuẩn như `genesis-harness sync`, `genesis-harness docs-gate`, `npm run verify`. Nếu máy dev có `rtk`, Genesis chỉ tự nhận diện và hiển thị như wrapper local tùy chọn; `rtk` không phải dependency công khai.
 ---
@@ -611,17 +634,13 @@ Mỗi skill tuân theo naming quy chuẩn trong thư mục `.codex/skills/`:
 | **genesis-api-sync** | Đồng bộ hóa API contract và codebase tự động | Khi cập nhật endpoint |
 | **genesis-spec-propagation** | Tự động lan tỏa thay đổi đặc tả xuống hạ nguồn | Khi spec thay đổi |
 | **genesis-docs-automation** | Tự động hóa đồng bộ tài liệu hệ thống | Tự động chạy sau khi test pass |
-| **ui-ux-test-skill** | Thiết kế và xác thực UI flows, kịch bản test giao diện | Trước khi triển khai giao diện |
+| **genesis-ui-ux-test** | Thiết kế và xác thực UI flows, kịch bản test giao diện | Trước khi triển khai giao diện |
 | **genesis-debug-guide** | Hướng dẫn chẩn đoán và khắc phục lỗi có hệ thống | Khi code lỗi hoặc test fail |
 | **genesis-pipeline-orchestration** | Điều phối pipeline phát triển nhiều giai đoạn | Quản lý đa giai đoạn |
 | **genesis-architecture** | Thiết kế hệ thống và ghi nhận quyết định kiến trúc (ADR) | Quyết định thiết kế lớn |
-| **genesis-planning** | Lập kế hoạch phân rã công việc khoa học | Chuẩn bị feature phức tạp |
-| **genesis-mvp-planning** | Tự động lập kế hoạch và phân rã Lộ trình 5-Phase MVP | Chạy ngay sau khi khởi tạo dự án |
+| **genesis-planning** | Lập kế hoạch phân rã công việc và Lộ trình 5-Phase MVP | Chuẩn bị feature phức tạp & thiết lập lộ trình |
 | **genesis-codebase-map** | Vẽ bản đồ kiến trúc codebase | Tìm hiểu codebase lớn |
-| **genesis-docs** | Tạo tài liệu kỹ thuật chi tiết | Kết thúc giai đoạn / release |
-| **genesis-research** | Nghiên cứu công nghệ, thư viện phù hợp | Tìm kiếm best practices |
-| **genesis-release** | Quản lý quy trình phát hành phiên bản | Version control + git tag |
-| **genesis-release-orchestration** | Tự động hóa lập kế hoạch và runbook phát hành | Chuẩn bị deploy hệ thống |
+| **genesis-release** | Quản lý phiên bản, runbooks, và kế hoạch khôi phục (rollback) | Chuẩn bị phát hành & triển khai |
 | **genesis-performance-profiling** | Đo lường hiệu suất và tối ưu hóa thời gian chạy | Trước khi tối ưu hiệu năng |
 | **genesis-observability-automation** | Tự động ghi chép quyết định (ADR) và log hành vi hệ thống | Ghi chép lịch sử vận hành |
 | **genesis-ai-provider** | Theo dõi và tối ưu hóa lượng token tiêu thụ | Giám sát chi phí API |
@@ -630,6 +649,10 @@ Mỗi skill tuân theo naming quy chuẩn trong thư mục `.codex/skills/`:
 | **genesis-design-spec** | Thiết lập Design System và Design Tokens | Đồng bộ thiết kế hệ thống |
 | **genesis-harness-engineering** | Xây dựng cơ sở hạ tầng test và dữ liệu mẫu | Setup test framework |
 | **spec-impact-engine** | Công cụ đánh giá mức độ ảnh hưởng của thay đổi spec | Kiểm tra độ tương thích |
+| **genesis-executing-plans** | Tuân thủ chặt chẽ bản kế hoạch đã duyệt và task.md | Triển khai theo plan đã chốt |
+| **genesis-test-driven-development** | Ép buộc tuân thủ TDD (Red -> Green -> Refactor) | Viết logic mới hoặc sửa lỗi |
+| **genesis-verification-before-completion** | Bắt buộc chạy kịch bản kiểm định trước khi xong việc | Đóng gói/hoàn tất đầu mục |
+| **genesis-using-git-worktrees** | Cô lập môi trường code bằng git worktree an toàn | Đổi cấu trúc/refactor diện rộng |
 ---
@@ -638,7 +661,7 @@ Mỗi skill tuân theo naming quy chuẩn trong thư mục `.codex/skills/`:
 | Tài Liệu | Mục Đích | Thời Gian |
 |----------|---------|----------|
 | [MODEL_ALLOCATION.md](.codex/MODEL_ALLOCATION.md) | Tại sao Codex là primary | 5 phút |
-| [SKILLS_INDEX.md](.codex/SKILLS_INDEX.md) | Chi tiết 19 skills | 20 phút |
+| [SKILLS_INDEX.md](.codex/SKILLS_INDEX.md) | Chi tiết 25 skills | 20 phút |
 | [SKILLS_NAMING_GUIDE.md](.codex/SKILLS_NAMING_GUIDE.md) | Convention naming | 5 phút |
 | [FILE_NAMING_CLARIFICATION.md](.codebase/FILE_NAMING_CLARIFICATION.md) | Giải thích file naming | 5 phút |
 | [CONTRIBUTING.md](CONTRIBUTING.md) | Cách đóng góp | 10 phút |
@@ -730,17 +753,6 @@ npm run eval            # Chạy evaluation
 ---
-## 💖 Ủng Hộ Dự Án (Donate)
-Dự án này là mã nguồn mở và được phát triển hoàn toàn vì đam mê. Nếu bạn thấy **Genesis Codex Harness** hữu ích và giúp bạn tiết kiệm thời gian, bạn có thể mời tôi một ly cafe để tiếp thêm động lực phát triển nhé:
-- **Momo**: `0865814259`
-- **PayPal**: *(Sẽ cập nhật sau)*
-Cảm ơn bạn rất nhiều vì đã đồng hành cùng sự phát triển của dự án! ❤️
----
 ## 🔗 Tài Nguyên
 - **GitHub**: [codex-genesis-harness](https://github.com/tuanpham09/codex-genesis-harness)
@@ -757,7 +769,7 @@ Cảm ơn bạn rất nhiều vì đã đồng hành cùng sự phát triển c
 - ✅ **25 Skills**: Hoàn toàn kế thừa và triển khai đầy đủ (đã bổ sung lộ trình 5-Phase MVP, tự chữa lành & nén context)
 - ✅ **Test Coverage**: 80%+ required
 - ✅ **Token Savings**: 40-60%
-- ✅ **Production Ready**: Yes (v0.1.6)
+- ✅ **Production Ready**: Yes (v0.1.8)
 - ✅ **Auto-Research Enforcement**: Active
 - ✅ **Auto-Debug Verification**: Active
 - ✅ **Auto-Spec-Propagation**: Active
@@ -769,7 +781,7 @@ Cảm ơn bạn rất nhiều vì đã đồng hành cùng sự phát triển c
 MIT License - Xem [LICENSE](LICENSE)
-**Genesis Codex Harness** - Xây dựng phần mềm production với Codex | v0.1.6 | Tháng 6, 2026
+**Genesis Codex Harness** - Xây dựng phần mềm production với Codex | v0.1.8 | Tháng 6, 2026
 ---

package/README.md CHANGED Viewed

@@ -13,6 +13,17 @@
 ---
+## 💖 Support the Project (Donate)
+This project is open-source and developed purely out of passion. If you find **Genesis Codex Harness** helpful and it saves you time, you can buy me a coffee to keep the development going:
+- **Momo**: `0865814259`
+- **PayPal**: *(Coming soon)*
+Thank you so much for your support! ❤️
+---
 ## ⚡ Core Pillars at a Glance
 *   🗺️ **Structured 5-Phase MVP Roadmap (`genesis-mvp-planning`):** Guarantees a decision-complete path to production. Genesis structures project delivery across 5 standard MVP phases (Foundation/API Core, Auth/Security, Core Features, Integrations, and Production Readiness), ensuring core infrastructure is verified before writing feature code.
@@ -67,7 +78,7 @@ graph TD
     VL -- Test Passes / Green --> VG[4. Zero-Drift Validation Gate]
     VG -- Git Diff Spec Warning --> Synced[5. Auto-Docs & State Compaction]
     Synced --> Complete([COMPLETED State])
     subgraph Harness Runtime Shell (FSM-Driven)
         RF
         TDD
@@ -76,7 +87,7 @@ graph TD
         VG
         Synced
     end
     subgraph Memory & Context Safeguards
         Compaction[(Context Compaction)] <--> Synced
         Offload[(Tool Log Offloader)] <--> VL
@@ -89,20 +100,32 @@ Genesis is built on five core, state-of-the-art technological breakthroughs that
 1. **Context Compaction Engine (`compact-context.sh`)**: Automatically condenses architectural decisions, API states, and task history into `.codebase/context/` when prompt window boundaries are reached, freeing up massive context space while keeping 100% decision recall.
 2. **Tool Call Offloading (`offload-log.sh`)**: Intercepts massive terminal outputs (such as verbose test suites or compiler logs) and offloads them to disk log files (`.system_generated/tasks/`), returning a clean, structural status summary back to the model.
 3. **Verify-Fix Self-Healing Loop (`run-verify-loop.sh`)**: An autonomous, closed-loop debug engine that captures test failures, reads error output from disk logs, refactors implementation code, and re-runs tests autonomously up to 5 times until the build turns green.
-4. **5-Phase MVP Planner (`genesis-mvp-planning`)**: Guarantees architectural rigor. Runs immediately post-initialization to break down requirements into 5 standard delivery phases, ensuring core contracts are validated before feature coding.
+4. **5-Phase MVP Planner (`genesis-planning`)**: Guarantees architectural rigor. Breaks down requirements into 5 standard delivery phases, ensuring core contracts are validated before feature coding.
 5. **Documentation Drift Check Validation Gates (`validation_gates.sh`)**: A hook-level scan that alerts the engineer on phase state changes if source code changes are detected without matching spec updates under `.codebase/`.
 ---
-## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.6)
+## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.8)
-Genesis v0.1.6 introduces five advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, and enable self-healing loop memory recall:
+Genesis v0.1.8 introduces six advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, enable self-healing loop memory recall, and provide agile UI iteration:
 1. **Visual Architecture AST Sync (`scripts/spec_visual_sync.js`)**: Bidirectional compiler that syncs Mermaid ERD database diagrams (`database-erd.mmd`) to API contracts JSON schemas (`contracts/api/`) and vice-versa, establishing absolute visual-to-code design integrity.
 2. **Contract-Driven Test Auto-Generator (`scripts/test_generator.js`)**: Automatically compiles fully executable Mocha/Jest integration test suites in `tests/integration/` directly from your API contracts JSON response schemas, providing instant TDD "RED" skeletons.
 3. **AST Contract-Code Integrity Gate (`scripts/contract_integrity_gate.js`)**: Static analysis checker that programmatically validates implementation code properties against API contract JSON schemas at FSM transition boundaries, locking state transitions if data type mismatches or missing properties are detected.
 4. **Pre-emptive Prompt Sentinel (`scripts/prompt_sentinel.js`)**: Real-time token budget monitor. Calculates token weights before calling LLM, pre-emptively halting runaway commands, and executing auto-compaction and log pruning when capacity thresholds (e.g. 20k tokens) are crossed.
 5. **Self-Healing Lessons-Learned Recall (`scripts/healing_telemetry.js`)**: Telemetry system that records compiler/test failure signatures and applied corrective code edits in `.codebase/failures/lessons_learned.md`. The self-healing loop recalls these recorded fixes on identical error signatures, bypassing iterations to achieve immediate **1-turn recovery**.
+6. **Aesthetic Vibe Mode (`VIBE_MODE=1`)**: A dynamic Triage engine that allows the AI to bypass strict PEV loops and TDD blockers exclusively for pure UI/CSS aesthetic changes. Bypassed failures are seamlessly routed to `.codebase/TECH_DEBT.md` for later reconciliation.
+### LeanCTX + Optional Local Wrappers
+Genesis ships a portable LeanCTX policy at `.codebase/context-policy.json` and exposes it through:
+```bash
+genesis-harness leanctx
+genesis-harness prime
+```
+`npm install` / `genesis-harness install` seeds the policy into the current project when a project root is detected, and never overwrites an existing custom policy. The `leanctx` command is only for inspection. Public npm usage and CI commands stay portable (`genesis-harness sync`, `genesis-harness docs-gate`, `npm run verify`). If `rtk` is installed locally, Genesis reports it as an optional wrapper for developer machines only; it is not required for npm users.
 ---
@@ -145,7 +168,7 @@ After installation, simply type standard commands in your Codex chat interface t
   ├── genesis-upgrade-design/             # Existing visual audit and upgrade engine
   ├── genesis-api-contract/               # Enterprise API contract designer
   ├── genesis-spec-propagation/           # Automated spec propagation engine
-  ├── genesis-mvp-planning/               # 5-Phase MVP roadmap generator [NEW v0.1.6]
+  ├── genesis-planning/                   # 5-Phase MVP roadmap planner
   └── ... (19 more skills, total 25 skills)
 .codebase/                                # Persistent repository memory system
@@ -158,13 +181,28 @@ observability/                            # Run records and architectural ADR lo
 ---
+## 🔌 MCP Server Configuration (Optional)
+To supercharge the agent's research and debugging capabilities, you can optionally configure MCP (Model Context Protocol) servers.
+We provide two ways to integrate them:
+### Option 1: Global Installation
+Run the built-in setup script to install recommended MCPs globally:
+```bash
+npm run mcp:setup
+```
+This installs essential MCPs like Puppeteer (Browser/UI tests), GitHub, and SQLite (Vector Memory).
+### Option 2: Dynamic Execution (Agent Config)
+If you prefer not to install them globally, you can configure your Agent Client (e.g., Claude Desktop, Hermes, Cursor) to run them dynamically. See the `mcp.example.json` file in the repository root for configuration snippets.
 ## 📊 Project Status & Versioning
 - ✅ **Architecture Rating**: `10/10` (Enforced research-first + self-healing + spec-propagation)
 - ✅ **Codex-Only Enforcement**: `100%`
 - ✅ **Skills Matrix**: 25 fully implemented, structured, and verified skills
 - ✅ **Token Caching Savings**: `40% to 60%` verified per enterprise project
-- ✅ **Stability & Readiness**: Production Ready (`v0.1.6` - June 2026)
+- ✅ **Stability & Readiness**: Production Ready (`v0.1.8` - June 2026)
 ---
@@ -174,5 +212,5 @@ Licensed under the [MIT License](LICENSE). Contributions, bug reports, and featu
 ---
-**Genesis Codex Harness** v0.1.6 | June 2026
+**Genesis Codex Harness** v0.1.8 | June 2026
 👉 **[Full English Guide](README.EN.md) | [Tiếng Việt Hướng Dẫn](README.VI.md)**

package/VERSION CHANGED Viewed

@@ -1,2 +1,2 @@
-0.1.6
+0.1.8