viepilot 2.1.0 → 2.12.0

package/CHANGELOG.md

@@ -7,6 +7,226 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.12.0] - 2026-04-13
+
+### Added (FEAT-018 — Phase 75)
+- **`vp-crystallize --brownfield`**: Brownfield Mode — bootstrap `.viepilot/` project context from an existing codebase without a brainstorm session
+  - 12-category codebase scanner: build manifests (11 platforms), framework detection (40+ dep patterns), architecture layer inference (18 directory patterns), database schema signals, API contract detection, infrastructure config, environment config shape, test coverage, code quality tools, documentation files, git history, file extension survey
+  - Structured Scan Report (YAML) with DETECTED / ASSUMED / MISSING gap classification
+  - MUST-DETECT gap tier: blocks artifact generation until user fills interactively
+  - Synthetic brainstorm stub (`docs/brainstorm/session-brownfield-import.md`) for `vp-audit` compatibility
+  - Safety rules: never reads `.env`; skips `node_modules/`, `.git/`, `target/`, `build/`, `dist/`, `__pycache__/`, `.venv/`, `vendor/`
+  - `vp-audit` updated to accept brownfield stub as valid brainstorm source (no false-positive errors)
+  - `TRACKER.md` annotated with `## Brownfield Import` block on first-time bootstrap
+
+## [2.11.0] - 2026-04-13
+
+### Added (ENH-045 — Phase 74)
+- **`lib/proposal-generator.cjs`**: `getDesignConfig(projectContext)` helper + `DESIGN_CONFIGS` map (3 styles: modern-tech, enterprise, creative) — auto-selects palette from sector/audience/tone context
+- **`scripts/gen-proposal-pptx.cjs`**: `PALETTES` map with 3 colour schemes + 3 rich slide layouts (timeline-gantt, team-card, investment-visual) + generates `project-proposal-{modern-tech,enterprise,creative}.pptx` variants
+- **`workflows/proposal.md`**: dynamic slide count (no hard cap) + `designConfig` field in manifest + content-aware split rules (technicalNarrative > 4 → 2 slides; team > 4 → 2 slides; phases > 4 → 2 timeline slides) + DESIGN SELECTION AI prompt block
+- 31 contract tests in `vp-enh045-dynamic-slides.test.js`
+
+## [2.10.1] - 2026-04-11
+
+### Changed (ENH-044 — Phase 73)
+- **`lib/screenshot-artifact.cjs`**: `warnMissingTool(tool, installCmd)` — standardized stderr `⚠` warning when visual tool absent but artifacts exist; exports alongside existing helpers
+- **`workflows/proposal.md` Step 4c**: mandatory enforcement — `visualSlides[]` MUST be non-empty when artifacts exist; puppeteer absent → `warnMissingTool('puppeteer', ...)` + `addPlaceholderVisual()` (no more silent skip)
+- **`workflows/proposal.md` Step 7**: mandatory enforcement — Mermaid + ui/arch sections MUST be added when diagrams/artifacts exist; mmdc absent → text fallback + `warnMissingTool('mmdc', ...)`; puppeteer absent → placeholder paragraph + `warnMissingTool('puppeteer', ...)`
+- `warnMissingTool()` called once per missing tool per generation run (not per-diagram)
+- 16 tests in `vp-enh044-visual-enforce.test.js`
+
+## [2.10.0] - 2026-04-11
+
+### Added (ENH-043 — Phase 72)
+- **`lib/screenshot-artifact.cjs`**: `isMmdcAvailable()` — boolean guard for `mmdc` CLI on PATH; `renderMermaidToPng(source, outPath)` — renders Mermaid source string → PNG via `mmdc` CLI; returns null when mmdc absent (no crash)
+- **`scripts/gen-proposal-docx.cjs`**: `imageRunFromPng(pngPath, widthEmu, heightEmu)` → `ImageRun` (docx package) for embedding PNG as inline image; requires `screenshot-artifact.cjs` + `proposal-generator.cjs`; runtime visual embedding comment block documenting three injection points: Mermaid diagrams (renderMermaidToPng → ImageRun), UI prototype screenshot (before Executive Summary), architecture screenshot (after Technical Approach)
+- **`workflows/proposal.md` Step 7**: Diagram Reference updated to render `mermaidSource` → PNG via `renderMermaidToPng()`; documents `screenshotArtifact` for ui-direction + architect injection; all paths use `cleanupScreenshot()`; graceful fallback when mmdc/puppeteer absent
+- 19 tests in `vp-enh043-docx-visuals.test.js`; contracts +2 (769/769 total)
+
+## [2.9.0] - 2026-04-11
+
+### Added (ENH-042 — Phase 71)
+- **`lib/proposal-generator.cjs`**: `detectVisualArtifacts(sessionDir)` — auto-scans `.viepilot/ui-direction/{latest-session}/` for ui-direction pages (`index.html`, `pages/*.html`) and 10 architect workspace page types (`architecture.html`, `erd.html`, `sequence-diagram.html`, etc.)
+- **`lib/screenshot-artifact.cjs`** (new): `screenshotArtifact(htmlPath)` via optional puppeteer (headless Chrome) — returns `null` gracefully when puppeteer not installed; `isPuppeteerAvailable()` boolean guard; `cleanupScreenshot()` temp-file cleanup
+- **`workflows/proposal.md` Step 4c `detect_visual_artifacts`**: AI maps slide topics to HTML artifact files, produces `visualSlides[]` array with `slideIndex`, `artifactType`, `htmlPath`, `label` fields
+- **`scripts/gen-proposal-pptx.cjs`**: `addPlaceholderVisual(slide, label)` — styled navy+accent placeholder shape for when screenshots are unavailable; runtime integration comment block documenting the `screenshotArtifact` → `addImage` → `cleanupScreenshot` pattern
+- Zero breaking change: all proposal generation works without puppeteer; visuals are additive
+
+## [2.8.0] - 2026-04-11
+
+### Added (ENH-041 — Phase 70)
+- **`workflows/proposal.md` Step 4b `generate_docx_content`**: dedicated AI pass for deep `.docx` content, independent of the slide manifest — richer prose, risk analysis, diagrams
+- **`docxContent` JSON schema**: `executiveSummary[]`, `problemStatement[]`, `solutionNarrative[]`, `technicalNarrative[]`, `riskRegister[]`, `glossary[]`, `diagrams[]` (with `mermaidSource`)
+- **Step 7 updated**: `.docx` generator consumes `docxContent` for narrative paragraphs; new Risk Register and Glossary sections fed from `docxContent`
+- **Step 8 updated**: `.md` companion embeds Mermaid fenced code blocks (` ```flowchart `, ` ```sequenceDiagram `, etc.) for each diagram in `docxContent.diagrams[]`
+- **`getDiagramTypes(typeId)` helper** in `lib/proposal-generator.cjs`: maps proposal type to diagram array (`project-proposal` → `[flowchart, gantt]`, `tech-architecture` → `[flowchart, sequenceDiagram, classDiagram]`, etc.)
+- **`.docx` Risk Register table**: Risk | Probability | Impact | Mitigation (5 placeholder rows)
+- **`.docx` Glossary table**: Term | Definition (4 placeholder rows)
+- `project-detail.docx` regenerated — 12 sections (added §8 Risk Register, §11 Glossary; previous §8–10 renumbered §9–12)
+- 17 new tests in `tests/unit/vp-enh041-proposal-docx-ai.test.js`; `vp-proposal-contracts.test.js` updated (+5 ENH-041 assertions)
+
+## [2.7.0] - 2026-04-10
+
+### Added (ENH-040 — Phase 69)
+- **`workflows/proposal.md` Step 2C Quality Brief**: 4 focused questions before AI generation — CTA, budget range, timeline constraint, decision-maker — stored in manifest `meta` field
+- **Manifest `meta` schema**: `cta`, `budget`, `timeline`, `decisionMaker` fields drive tone and content specificity
+- **AI Prompt Contract** in manifest_generation step: 8–15 word outcome-oriented bullets, 3–5 sentence speaker notes, concrete CTA on closing slide, avoids filler phrases
+- **`.pptx` templates: 5 distinct layouts** (ENH-040 Layer 1):
+  - `cover` — split panel (left charcoal + ViePilot mark, right title/subtitle/meta)
+  - `section` — left accent sidebar + heading bar + bullets
+  - `two-column` — heading + dual column content (comparisons, scope, competitive)
+  - `data` — heading + up to 3 metric callout boxes (large value + label + note)
+  - `closing` — full charcoal, prominent CTA text, accent bars top/bottom
+- **`.docx` template: structured tables + narrative** (ENH-040 Layer 3):
+  - **Timeline table**: Phase | Milestone/Deliverable | Duration | Dependencies (6 rows)
+  - **Budget/Investment table**: Line Item | Estimate | Notes (with TOTAL row)
+  - **Team table**: Role | Name/Background | Responsibility
+  - Narrative paragraphs for Executive Summary, Problem & Opportunity, Why Choose Us
+  - 10 sections + explicit `{{placeholder}}` instructions for AI to fill
+- All 4 `.pptx` stock templates regenerated (137–151 KB; prev 97–126 KB)
+- `project-detail.docx` regenerated (12 KB; prev 10 KB)
+
+### Tests
+- Added `tests/unit/vp-enh040-proposal-quality.test.js` (27 tests — workflow contracts, pptx layout coverage, docx structure)
+- Updated `tests/unit/vp-proposal-contracts.test.js` (+2 tests — quality brief + outcome-oriented rules)
+- Total: **660 → 689 tests**
+
+## [2.6.0] - 2026-04-10
+
+### Added (ENH-039 — Phase 68)
+- **`/vp-proposal --lang <code>`**: language selection for AI-generated content (ISO 639-1; e.g. `vi`, `en`, `ja`, `fr`, `zh`)
+  - If omitted: prompted with MRU suggestions from `~/.viepilot/config.json → proposal.recentLangs`
+  - Language is saved to MRU after each successful generation
+- **`/vp-proposal --lang-content-only`**: translate bullets, notes, and paragraphs; keep structural labels / section names in English
+- **MRU language history**: `~/.viepilot/config.json → proposal.recentLangs` (max 5, most recent first, deduped)
+- **`lib/viepilot-config.cjs`**: `getProposalLang()` + `recordProposalLang()` helpers; `DEFAULTS` extended with `proposal.recentLangs` + `proposal.defaultLang`
+- **`lib/proposal-generator.cjs`**: `buildLangInstruction(lang, contentOnly)` — builds AI prompt language instruction; no-op for English
+- **`workflows/proposal.md`**: Step 3b Language Selection (MRU prompt); `langInstruction` injection in manifest generation; `recordProposalLang` after confirm output
+- **`skills/vp-proposal/SKILL.md`**: `--lang` + `--lang-content-only` flags documented
+
+### Tests
+- Added `tests/unit/vp-enh039-proposal-lang.test.js` (13 tests — config helpers, buildLangInstruction, SKILL.md/workflow contracts)
+- Updated `tests/unit/vp-proposal-contracts.test.js` (+2 tests — --lang and --lang-content-only flag documentation)
+- Total: **645 → 660 tests**
+
+## [2.5.0] - 2026-04-11
+
+### Added (FEAT-016 — Phases 63–67)
+- **`/vp-proposal` skill**: convert brainstorm session (or direct brief) → professional proposal package
+  - `.pptx` presentation (ViePilot branded, dark navy/charcoal)
+  - `.docx` detailed document (10 sections: executive summary → appendix)
+  - `.md` Markdown source of truth
+  - Optional `.txt` Google Slides URL (`--slides` flag)
+- **4 proposal types**: `project-proposal` (10 slides), `tech-architecture` (12), `product-pitch` (12), `general` (8)
+- **`lib/proposal-generator.cjs`**: 2-tier template resolution (project `.viepilot/proposal-templates/` override → ViePilot stock fallback), context detection, type validation, output path builder
+- **`lib/google-slides-exporter.cjs`**: service account auth; lazy-loads `@googleapis/slides`; graceful error when package or credentials absent
+- **Stock templates**: `templates/proposal/pptx/` (4 files, dark navy `#1a1f36`/charcoal `#2d3142`, ViePilot branded) + `templates/proposal/docx/project-detail.docx`
+- **`scripts/gen-proposal-pptx.cjs`** + **`scripts/gen-proposal-docx.cjs`**: template generation scripts
+- **`skills/vp-proposal/SKILL.md`**: full skill definition; `--type`, `--from`, `--slides`, `--dry-run` flags
+- **`workflows/proposal.md`**: 10-step workflow; slide manifest schema; 4 proposal type structures; error handling
+- **`docs/user/features/proposal.md`**: full user guide with Google Slides 5-step setup guide
+- **`@googleapis/slides`** added as `optionalDependencies` (install not required unless using `--slides`)
+- **`pptxgenjs` + `docx`** added as runtime `dependencies`
+
+### Tests
+- Added `tests/unit/vp-proposal-contracts.test.js` (25 tests — skill/workflow files, generator exports, stock templates, graceful degradation)
+- Added `tests/unit/vp-proposal-core.test.js` (15 tests — resolveTemplate, validateType, detectBrainstormSession)
+- Total: 607 → **647 tests**
+
+## [2.4.0] - 2026-04-10
+
+### Added (FEAT-015 — Phase 62)
+- **Codex adapter**: `lib/adapters/codex.cjs` — OpenAI Codex CLI is now a first-class install target; skills install to `~/.codex/skills/`, viepilot bundle to `~/.codex/viepilot/`
+- `lib/adapters/index.cjs`: `codex` registered; `listAdapters()` now returns 4 unique adapters
+- `bin/viepilot.cjs`: Codex added to interactive installer TARGETS list and help text
+- `docs/user/features/adapters.md`: Codex row added; `$skill-name` invocation note; removed stale `dev-install.sh` reference
+
+### Notes
+- Codex uses `$vp-status` syntax (not `/vp-status`) — SKILL.md format is fully compatible, invocation prefix differs
+
+### Tests
+- Added `tests/unit/vp-adapter-codex.test.js` (11 tests)
+- Updated `tests/unit/vp-adapter-antigravity.test.js`: `listAdapters()` now expects 4
+- Updated `tests/unit/viepilot-adapters.test.js`: count 3 → 4
+- Updated `tests/unit/guided-installer.test.js`: `normalizeTargets('all')` includes codex
+- Total: 607 tests (was 596)
+
+## [2.3.2] - 2026-04-10
+
+### Changed (ENH-037 — Phase 61)
+- Post-install "Next actions" block is now adapter-driven: each adapter carries a `postInstallHint` string; CLI prints one hint per unique installed target — Antigravity now appears when installed
+- `lib/adapters/claude-code.cjs`, `cursor.cjs`, `antigravity.cjs`: added `postInstallHint` field
+
+## [2.3.1] - 2026-04-10
+
+### Removed (ENH-036 — Phase 60)
+- `install.sh` — bash wrapper was redundant; `bin/viepilot.cjs install` covers all install functionality
+- `dev-install.sh` — bash adapter routing duplicated `lib/adapters/`; `bin/viepilot.cjs install --target <adapter>` is the canonical path
+- Removed 5 tests that only verified shell script content (viepilot-install.test.js, viepilot-adapters.test.js, vp-adapter-antigravity.test.js)
+
+## [2.3.0] - 2026-04-10
+
+### Added (FEAT-014 — Phase 59)
+- **Antigravity adapter**: `lib/adapters/antigravity.cjs` — Google Antigravity IDE is now a first-class install target; skills install to `~/.antigravity/skills/`, viepilot bundle to `~/.antigravity/viepilot/`
+- `lib/adapters/index.cjs`: `antigravity` registered; `listAdapters()` now returns 3 unique adapters
+- `dev-install.sh`: `VIEPILOT_ADAPTER=antigravity` supported
+- `bin/viepilot.cjs`: Antigravity added to interactive installer TARGETS list and help text
+- `docs/user/features/adapters.md`: new doc — supported platforms table, install examples, guide for adding new adapters
+
+### Tests
+- Added `tests/unit/vp-adapter-antigravity.test.js` (12 tests)
+- Updated `tests/unit/viepilot-adapters.test.js`: `listAdapters()` now expects 3
+- Updated `tests/unit/guided-installer.test.js`: `normalizeTargets('all')` includes antigravity
+- Total: 600 tests (was 588)
+
+## [2.2.0] - 2026-04-10
+
+### Changed (ENH-035 — Phase 58)
+- **{envToolDir} template variable**: all 14 `skills/*/SKILL.md` source files now use `$HOME/{envToolDir}/` instead of hardcoded `$HOME/.cursor/viepilot/` — skill sources are platform-neutral
+- **`lib/viepilot-install.cjs`**: path substitution now unconditionally replaces `{envToolDir}` → `adapter.executionContextBase` for every adapter (Cursor → `.cursor/viepilot`, Claude Code → `.claude/viepilot`, future adapters just set `executionContextBase`)
+- **`lib/adapters/claude-code.cjs`**: removed `pathRewrite` field — no longer needed
+- **`lib/adapters/cursor.cjs`**: removed `pathRewrite: null` field — no longer needed
+- Adding a new adapter now requires only `executionContextBase` — no `pathRewrite` definition
+
+### Tests
+- Updated `tests/unit/viepilot-adapters.test.js`: removed `pathRewrite` assertion; rewrite step tests now check `from: '{envToolDir}'`; added cursor-target substitution test
+- Updated `tests/unit/viepilot-install.test.js`: 2 tests updated for ENH-035 behavior
+- Total: 588 tests (was 587)
+
+## [2.1.3] - 2026-04-10
+
+### Fixed (BUG-011 — Phase 55)
+- **brainstorm.md dialogue path**: confirmation option 1 now shows `.viepilot/ui-direction/{session-id}/notes.md` instead of bare `ui-direction/notes.md` — eliminates ambiguity with user-managed `{root}/ui-direction/` folders
+- **crystallize.md PATH GUARD**: `consume_ui_direction` step now opens with `⛔ PATH GUARD (BUG-011)` — explicitly instructs LLM to ignore any `{root}/ui-direction/` folder and read only from `.viepilot/ui-direction/`
+
+### Tests
+- Added `tests/unit/vp-bug011-ui-direction-path-guard.test.js` (3 tests)
+- Total: 587 tests (was 584)
+
+## [2.1.2] - 2026-04-10
+
+### Fixed (BUG-013 — Phase 57)
+- **Untrack .viepilot/ from git**: `git rm -r --cached .viepilot/` — removes all 27 previously-tracked internal state files from the git index; `.viepilot/` now correctly treated as gitignored on disk only, never staged or pushed
+- **GITIGNORE-AWARE STAGING RULE**: `workflows/autonomous.md` commit block now has `⛔ GITIGNORE-AWARE STAGING RULE (BUG-013)` — instructs vp-auto to check `git check-ignore -q` before staging, and explicitly forbids `git add .viepilot/`
+- **Git persistence gate note**: porcelain check section clarified — `??` (untracked-only) lines are CLEAN, not dirty state; prevents false gate failures after BUG-013 fix
+
+### Tests
+- Added `tests/unit/vp-bug013-gitignore-staging-rule.test.js` (3 tests)
+- Total: 584 tests (was 581)
+- **ui-direction path disambiguation**: `workflows/brainstorm.md` confirmation dialogue option 1 now shows full unambiguous path `.viepilot/ui-direction/{session-id}/notes.md` (was bare `ui-direction/notes.md`)
+- **crystallize PATH GUARD**: `workflows/crystallize.md` `consume_ui_direction` step now opens with `⛔ PATH GUARD (BUG-011)` — explicitly instructs LLM to ignore any `{root}/ui-direction/` folder and read only from `.viepilot/ui-direction/`
+
+## [2.1.1] - 2026-04-10
+
+### Fixed (BUG-012 — Phase 56)
+- **PATH RESOLUTION RULE**: `workflows/autonomous.md` now has `⛔ PATH RESOLUTION RULE (BUG-012)` block — explicitly states all file reads/edits during task execution resolve from `{cwd}` (repo root), never from `~/.claude/` or `~/.cursor/` install directories
+- **evolve.md cwd note**: `workflows/evolve.md` TASK PATH RULE section now includes BUG-012 cwd-resolution clarification: repo-relative paths always anchor to `{cwd}`, not install paths
+
+### Tests
+- Added `tests/unit/vp-bug012-path-resolution-rule.test.js` (3 tests)
+- Total: 581 tests (was 578)
+
 ## [2.1.0] - 2026-04-08
 
 ### Added (FEAT-012 — Phase 54)

package/README.md

@@ -2,15 +2,15 @@
 
 **Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**
 
-[![Version](https://img.shields.io/badge/version-1.16.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.5.0-blue.svg)](CHANGELOG.md)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-[![Skills](https://img.shields.io/badge/skills-16-purple.svg)](#skills-reference)
+[![Skills](https://img.shields.io/badge/skills-17-purple.svg)](#skills-reference)
 [![Workflows](https://img.shields.io/badge/workflows-12-orange.svg)](#workflows)
 [![Templates](https://img.shields.io/badge/templates-17-cyan.svg)](#templates)
-[![Tests](https://img.shields.io/badge/tests-448%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-607%20passing-brightgreen.svg)](tests/)
 [![GitHub](https://img.shields.io/github/stars/0-CODE/viepilot?style=social)](https://github.com/0-CODE/viepilot)
 
-**Versioning:** Shield **1.9.5** is the **ViePilot framework SemVer** tracked in `.viepilot/TRACKER.md` and `CHANGELOG.md`. The npm `package.json` field `version` (**1.9.5**) is the Node package identifier for this repo; use the framework version for milestone releases and docs.
+**Versioning:** Shield **2.4.0** is the **ViePilot framework SemVer** tracked in `.viepilot/TRACKER.md` and `CHANGELOG.md`. The npm `package.json` field `version` (**2.4.0**) is the Node package identifier for this repo; use the framework version for milestone releases and docs.
 
 ViePilot là bộ skill framework cho phép AI assistant (Claude, GPT, etc.) phát triển dự án một cách **tự động**, **có kiểm soát**, và **có thể khôi phục**. Thiết kế theo các tiêu chuẩn chuyên nghiệp: Semantic Versioning, Conventional Commits, Keep a Changelog.
 
@@ -28,13 +28,13 @@ Nếu ViePilot giúp ích cho bạn, bạn có thể ủng hộ một ly cafe:
 
 | Chỉ số / Metric | Giá trị / Value |
 |-----------------|-----------------|
-| Total LOC | **~34,308+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
-| Skills | **16** |
+| Total LOC | **~39,668+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
+| Skills | **17** |
 | Workflows | **12** |
 | Templates | **17** (Project: 12, Phase: 5) |
 | CLI Commands | **18** (`vp-tools` 17 subcommands + `viepilot` installer) |
-| Tests | **308** (16 suites: unit + integration + AI compat + README metrics + UI direction + ENH contracts + scope policy + FEAT-009 + FEAT-010 + ENH-021 routing + FEAT-001 Claude Code + ENH-022 crystallize architecture files + viepilot-info/update/install) |
-| ViePilot phases (local `.viepilot`) | **34** phase cycles — **M1.29** FEAT-001 (**v1.9.3** doc); patch **v1.9.4** (Claude installer); **M1.28** FEAT-010 (**v1.9.1**); **v1.9.2** (ENH-019~021); **M1.27** (**v1.9.0** FEAT-009); xem `CHANGELOG.md` |
+| Tests | **607** (34 suites: unit + integration + AI compat + README metrics + UI direction + ENH contracts + scope policy + FEAT-009/010/011/012/013/015 + ENH-021~037 routing/language/architect/adapter + BUG-009~013 guards + viepilot-info/update/install/adapters) |
+| ViePilot phases (local `.viepilot`) | **62** phase cycles — **v2.4.0** FEAT-015 Codex adapter; **v2.3.x** ENH-036~037 installer cleanup; **v2.0.0** FEAT-013 dynamic adapters; **v1.x** M1.29 (FEAT-001~013); xem `CHANGELOG.md` |
 | Standards | 5 (SemVer, Commits, Changelog, Comments, Contributors) |
 
 > Metric `Total LOC` có thể được refresh tự động bằng `npm run readme:sync` (dùng `cloc`; nếu thiếu `cloc` script sẽ fallback an toàn).
@@ -43,33 +43,33 @@ Nếu ViePilot giúp ích cho bạn, bạn có thể ủng hộ một ly cafe:
 
 | Thành phần / Component | Số lượng / Count | Mô tả / Description |
 |------------------------|------------------|---------------------|
-| Skill Definitions | **16** | SKILL.md files với trigger, process, success criteria |
+| Skill Definitions | **17** | SKILL.md files với trigger, process, success criteria |
 | Workflow Files | **12** | Step-by-step execution guides |
 | Project Templates | 12 | AI-GUIDE, ARCHITECTURE, VIEPILOT-META, README, SYSTEM-RULES, etc. |
 | Phase Templates | 5 | SPEC, PHASE-STATE, TASK, VERIFICATION, SUMMARY |
 | CLI Tools | 2 | vp-tools.cjs (**17** subcommands) + viepilot.cjs (guided installer) |
-| Test Files | 15 | Jest: 14 unit + 1 integration (contracts, installer + Claude paths, info/update, FEAT-009, FEAT-010, FEAT-001, ENH-021, scope policy, …) |
+| Test Files | 34 | Jest: 33 unit + 1 integration (contracts, installer + Claude paths, info/update, FEAT-009/010/011~015, ENH-021~037, BUG-009~013 guards, adapter tests, scope policy, …) |
 
 ---
 
 ## Độ hoàn thiện / Completion Status
 
 ```
-Tổng thể / Overall:  ████████████████████  ~98% ✅ Latest **v1.9.4** (Claude Code **installer** ~/.claude/skills); **v1.9.3** FEAT-001 doc; **v1.9.2** (ENH-019~021); **v1.9.1** FEAT-010; **v1.9.0** FEAT-009
+Tổng thể / Overall:  ████████████████████  ~99% ✅ Latest **v2.4.0** FEAT-015 Codex adapter; **v2.3.x** ENH-036~037 installer cleanup; **v2.1.x** BUG-009~013; **v2.0.0** FEAT-013 dynamic adapters
 ```
 
 | Lĩnh vực / Area | Trạng thái | Chi tiết |
 |-----------------|------------|----------|
-| Core Skills (16) | ✅ Hoàn thiện | brainstorm, crystallize, auto, pause, resume, status, info, request, evolve, docs, update, task, debug, rollback, audit, ui-components |
+| Core Skills (17) | ✅ Hoàn thiện | brainstorm, crystallize, auto, pause, resume, status, info, request, evolve, docs, update, task, debug, rollback, audit, ui-components, **proposal** |
 | Workflows (12) | ✅ Hoàn thiện | Full step-by-step guides với success criteria |
 | Project Templates (12) | ✅ Hoàn thiện | Placeholders cho customization (+ `VIEPILOT-META` FEAT-009) |
 | Phase Templates (5) | ✅ Hoàn thiện | Task tracking, verification, summary |
 | CLI Tools (18) | ✅ Hoàn thiện | vp-tools 17 subcommands + viepilot installer; bundle `info` / `update` |
-| Tests (304) | ✅ Hoàn thiện | Unit, integration, AI compat, workflow contracts, installer, scope policy, FEAT-009/010/001, ENH-021, info/update |
+| Tests (607) | ✅ Hoàn thiện | Unit, integration, AI compat, workflow contracts, installer, scope policy, FEAT-009~015, ENH-021~037, BUG-009~013, adapter tests, info/update |
 | CI/CD | ✅ Hoàn thiện | GitHub Actions, Node 18/20/22 matrix, coverage >80% |
 | Documentation | ✅ Hoàn thiện | dev/, user/, api/, videos/, examples/, troubleshooting |
 | Standards | ✅ Hoàn thiện | SemVer, Conventional Commits, Keep a Changelog |
-| Installation | ✅ Hoàn thiện | install.sh + dev-install.sh |
+| Installation | ✅ Hoàn thiện | `bin/viepilot.cjs install` (Node-based, all adapters) |
 
 ---
 
@@ -126,6 +126,7 @@ Tổng thể / Overall:  ██████████████████
 | `/vp-debug` | Debug có hệ thống với state tracking / Systematic debugging | "debug", "gỡ lỗi" | Debug |
 | `/vp-rollback` | Khôi phục về checkpoint / Rollback to checkpoint | "rollback", "revert" | Recovery |
 | `/vp-audit` | Kiểm tra sync docs vs implementation | "audit", "kiểm tra" | Quality |
+| `/vp-proposal` | Generate .pptx + .docx proposal package từ brainstorm | "proposal", "pitch", "presentation" | Deliver |
 
 ---
 
@@ -205,10 +206,13 @@ Chọn target profile trong wizard (phím mũi tên + space + enter):
 - Claude Code
 - Cursor Agent
 - Cursor IDE
+- Antigravity
+- Codex
 
 Non-interactive:
 ```bash
 npx viepilot install --target cursor-agent --yes
+npx viepilot install --target codex --yes
 ```
 
 Gỡ cài đặt:
@@ -353,7 +357,7 @@ viepilot/
 │   ├── vp-rollback/               # Checkpoint recovery
 │   └── vp-audit/                  # Documentation sync
 │
-├── workflows/                     # 11 Workflow definitions
+├── workflows/                     # 12 Workflow definitions
 │   ├── brainstorm.md              # Brainstorm session flow
 │   ├── crystallize.md             # Artifact generation flow
 │   ├── autonomous.md              # Execution loop
@@ -388,17 +392,25 @@ viepilot/
 │       └── SUMMARY.md
 │
 ├── lib/                           # Shared CLI logic (coverage target for Jest)
-│   └── cli-shared.cjs             # Validators, project root, Levenshtein helpers
+│   ├── cli-shared.cjs             # Validators, project root, Levenshtein helpers
+│   └── adapters/                  # Dynamic adapter system (FEAT-013)
+│       ├── index.cjs              # Registry: listAdapters(), getAdapter()
+│       ├── claude-code.cjs        # Claude Code adapter (~/.claude/)
+│       ├── cursor.cjs             # Cursor adapter (~/.cursor/)
+│       ├── antigravity.cjs        # Antigravity adapter (~/.antigravity/)
+│       └── codex.cjs              # Codex CLI adapter (~/.codex/)
 │
 ├── bin/                           # CLI tools
 │   └── vp-tools.cjs               # 17 subcommands; uses ../lib/cli-shared.cjs, viepilot-info/update.cjs
 │
-├── tests/                         # Test suite (308 tests)
-│   ├── unit/                      # Unit tests
+├── tests/                         # Test suite (607 tests, 34 suites)
+│   ├── unit/                      # 33 unit test files
 │   │   ├── validators.test.js     # CLI subprocess + in-process coverage tests
-│   │   └── ai-provider-compat.test.js  # 142 AI compat tests
+│   │   ├── ai-provider-compat.test.js  # AI compat tests
+│   │   ├── viepilot-adapters.test.js   # Adapter registry tests
+│   │   └── vp-adapter-codex.test.js    # Codex adapter tests
 │   └── integration/               # Integration tests
-│       └── workflow.test.js       # 22 E2E tests
+│       └── workflow.test.js       # E2E tests
 │
 ├── .github/workflows/             # CI/CD
 │   └── ci.yml                     # Node 18/20/22 matrix
@@ -419,7 +431,6 @@ viepilot/
 │   ├── api-service/               # Express + JWT example
 │   └── cli-tool/                  # Node.js CLI example
 │
-├── install.sh                     # Installation script
 ├── Makefile                       # Developer commands
 ├── CHANGELOG.md                   # Version history
 ├── CONTRIBUTING.md                # Contribution guide

package/bin/viepilot.cjs

@@ -21,6 +21,8 @@ const TARGETS = [
   { id: 'claude-code',  label: adapterMap['claude-code'].name + ' (default)' },
   { id: 'cursor-agent', label: 'Cursor Agent' },
   { id: 'cursor-ide',   label: 'Cursor IDE' },
+  { id: 'antigravity',  label: adapterMap['antigravity'].name },
+  { id: 'codex',        label: adapterMap['codex'].name },
 ];
 
 function printHelp() {
@@ -34,14 +36,14 @@ Usage:
   viepilot --list-targets
 
 Install options:
-  --target <id|id,id|all>   Target profile(s): claude-code (mirrors vp-* to ~/.claude/skills), cursor-agent, cursor-ide
+  --target <id|id,id|all>   Target profile(s): claude-code (mirrors vp-* to ~/.claude/skills), cursor-agent, cursor-ide, antigravity, codex
   --yes                      Non-interactive mode (skip confirmations)
   --dry-run                  Print actions only (Node installer; no bash)
   --list-targets             Print supported targets and exit
   --help                     Show help
 
 Uninstall options:
-  --target <id|id,id|all>   Remove assets (claude-code: ~/.claude/skills/vp-*; cursor-*: ~/.cursor/skills/vp-*; shared: ~/.cursor/viepilot)
+  --target <id|id,id|all>   Remove assets (claude-code: ~/.claude/skills/vp-*; cursor-*: ~/.cursor/skills/vp-*; antigravity: ~/.antigravity/skills/vp-*; codex: ~/.codex/skills/vp-*)
   --yes                     Non-interactive mode (skip confirmations)
   --dry-run                 Print actions only, do not remove files
 `);
@@ -337,8 +339,14 @@ async function installCommand(rawArgs) {
     else console.log(`- ${r.target}: failed (exit ${r.code})`);
   }
   console.log('\nNext actions:');
-  console.log('- Cursor: open project and run /vp-status');
-  console.log('- Claude Code: restart session if needed so ~/.claude/skills/vp-* is picked up; then /vp-status');
+  const seenAdapters = new Set();
+  for (const target of selectedTargets) {
+    const a = adapterMap[target];
+    if (a && !seenAdapters.has(a.id)) {
+      seenAdapters.add(a.id);
+      console.log(`- ${a.name}: ${a.postInstallHint || 'run /vp-status'}`);
+    }
+  }
   console.log('- If needed, run /vp-brainstorm then /vp-crystallize');
 
   return failed.length === 0 ? 0 : 1;

package/docs/brainstorm/session-2026-04-11.md

@@ -0,0 +1,194 @@
+# Brainstorm Session — 2026-04-11
+
+## Topic
+**vp-proposal** — Skill mới: Idea → Proposal Documents + Presentation files (.pptx, .docx)
+
+## Status
+Completed — Ready for `/vp-crystallize` / `/vp-request` → `/vp-evolve` → `/vp-auto`
+
+---
+
+## Problem Statement
+ViePilot hiện có thể đưa ý tưởng thành code nhưng chưa có cầu nối sang **tài liệu bán hàng / thuyết phục**. Developer cần trình bày dự án cho khách hàng, đối tác, nhà đầu tư — hiện phải tự làm thủ công PowerPoint/Word tốn nhiều thời gian.
+
+---
+
+## Solution: `/vp-proposal`
+
+Skill chuyển đổi ideas/brainstorm session → professional proposal package:
+- **Presentation** (`.pptx`) — thuyết trình trực tiếp
+- **Detail document** (`.docx`) — tài liệu chi tiết kèm theo
+- **Markdown summary** (`.md`) — source of truth, version-controlled
+- **Google Slides link** (optional `--slides`) — cloud sharing
+
+---
+
+## Decisions
+
+### D1: AI content generation
+Auto-generate từ brainstorm session notes (context-aware).
+- Nếu có `docs/brainstorm/session-*.md` → load latest session tự động làm input
+- Standalone mode: user cung cấp brief trực tiếp trong chat
+- Không cần user điền outline thủ công — AI extract + structure
+
+### D2: Template system (2-tier resolution)
+```
+Tier 1 (project override):  .viepilot/proposal-templates/{type}.pptx|docx
+Tier 2 (stock fallback):    {viepilot-install}/templates/proposal/pptx/{type}.pptx
+                             {viepilot-install}/templates/proposal/docx/{type}.docx
+```
+- Override chỉ ảnh hưởng project hiện tại
+- Stock templates ship theo npm package
+
+### D3: Proposal types (4 + 1 docx)
+| Type ID | Tên | Use case |
+|---------|-----|----------|
+| `project-proposal` | Project Proposal | Scope, timeline, budget cho khách hàng |
+| `tech-architecture` | Technical Architecture | Thiết kế hệ thống cho technical partner |
+| `product-pitch` | Product Pitch Deck | Investor / partner pitch |
+| `general` | General Proposal | Tổng quát, fallback |
+| `project-detail` (docx) | Project Detail Doc | Tài liệu chi tiết bổ sung cho tất cả loại trên |
+
+### D4: Output location
+```
+docs/proposals/
+├── {slug}-{date}.md          # Markdown source
+├── {slug}-{date}.pptx        # Presentation
+├── {slug}-{date}.docx        # Detail document
+└── {slug}-{date}-slides.txt  # Google Slides URL (nếu --slides)
+```
+
+### D5: Tech stack
+| Output | Package | Version | Downloads/wk |
+|--------|---------|---------|-------------|
+| `.pptx` | `pptxgenjs` | ^3.x | 1.8M |
+| `.docx` | `docx` | ^9.x | 3.5M |
+| Google Slides | `@googleapis/slides` | official | optional dep |
+
+### D6: Workflow integration
+- `c` — Context-aware: detect brainstorm session tự động OR standalone brief
+- Auto-detect: check `docs/brainstorm/session-*.md` → sort by date → load latest
+- User có thể override: `/vp-proposal --from session-2026-04-11.md`
+
+---
+
+## Architecture
+
+### New files
+```
+skills/vp-proposal/
+└── SKILL.md                          # Skill definition
+
+workflows/
+└── proposal.md                       # Step-by-step workflow
+
+lib/
+└── proposal-generator.cjs            # Core: template resolution + pptxgenjs + docx
+
+templates/proposal/
+├── pptx/
+│   ├── project-proposal.pptx         # ViePilot stock template
+│   ├── tech-architecture.pptx
+│   ├── product-pitch.pptx
+│   └── general.pptx
+└── docx/
+    └── project-detail.docx           # ViePilot stock .docx template
+```
+
+### Template resolution logic (lib/proposal-generator.cjs)
+```js
+function resolveTemplate(type, ext, projectRoot) {
+  const projectOverride = path.join(projectRoot, '.viepilot/proposal-templates', `${type}.${ext}`);
+  if (fs.existsSync(projectOverride)) return projectOverride;
+  return path.join(__dirname, '../templates/proposal', ext, `${type}.${ext}`);
+}
+```
+
+### Slide generation flow
+```
+/vp-proposal [--type project-proposal] [--slides]
+      │
+      ├─ 1. Load context (brainstorm session or user brief)
+      ├─ 2. AI structures content → JSON slide manifest
+      ├─ 3. resolveTemplate() → pick .pptx/.docx template
+      ├─ 4. pptxgenjs → write .pptx
+      ├─ 5. docx → write .docx
+      ├─ 6. Write .md summary
+      └─ 7. (--slides) Google Slides API upload → write URL
+```
+
+---
+
+## Open Questions
+
+- ~~OQ1~~: **Resolved** — Dark theme: navy/charcoal. Professional, tech feel.
+- ~~OQ2~~: **Resolved** — Flexible per type: project-proposal 10, tech-architecture 12, product-pitch 12, general 8.
+- ~~OQ3~~: **Resolved** — `optionalDependencies` — load on demand khi `--slides` flag, npm install không fail nếu thiếu.
+- ~~OQ4~~: **Resolved** — Skill-only `/vp-proposal`, nhất quán với các skill khác.
+
+---
+
+## Phases
+
+### Phase 1 — Core infrastructure
+- Add `pptxgenjs` + `docx` to `package.json` dependencies
+- `lib/proposal-generator.cjs`: template resolution + base pptx/docx writer
+- Unit tests: template resolution logic
+
+### Phase 2 — Skill + Workflow
+- `skills/vp-proposal/SKILL.md`
+- `workflows/proposal.md` — full step-by-step
+- Context detection: brainstorm session auto-load
+- 4 proposal types wired up
+
+### Phase 3 — Stock templates
+- Design + generate 4 stock `.pptx` templates (ViePilot branded)
+- 1 stock `.docx` template
+- Store in `templates/proposal/`
+
+### Phase 4 — Google Slides export (optional)
+- `--slides` flag
+- `@googleapis/slides` optional dependency
+- Service account auth guide in docs
+
+### Phase 5 — Tests + Docs
+- Jest contracts for proposal-generator
+- `docs/user/features/proposal.md`
+- Update `docs/skills-reference.md` + `README.md`
+
+---
+
+## Research Notes
+
+### pptxgenjs
+- MIT, zero runtime dependencies
+- Supports Slide Masters for branded templates
+- HTML-to-PPTX in 1 line
+- Template injection: load existing .pptx → inject content
+
+### docx (by Dolan Miu)
+- MIT, 3.5M downloads/week
+- Declarative API: `new Document({ sections: [...] })`
+- Supports tables, images, headings, lists
+- Version 9.6.1, actively maintained
+
+### Google Slides API
+- Official `@googleapis/slides` Node.js client
+- Service account = no browser auth for CLI
+- Template-based: create in Slides → replace placeholders via API
+- Optional: only needed for `--slides` flag
+
+---
+
+## Project meta intake (FEAT-009)
+Waiver — this is the ViePilot framework repo itself; profile binding already exists.
+
+---
+
+## Session Summary
+- **Feasibility**: HIGH ✅
+- **Dependencies**: 2 well-maintained npm packages (pptxgenjs + docx), both MIT
+- **Complexity**: Medium — template system + AI content structuring + 2 file formats
+- **Estimated phases**: 5
+- **Suggested ID**: FEAT-016
+- **Target version**: 2.5.0