viepilot 3.7.2 → 3.7.3

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 (5) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +17 -17
  3. package/docs/dev/architecture.md +26 -0
  4. package/docs/skills-reference.md +96 -0
  5. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -9,6 +9,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
9
9
 
10
10
  ---
11
11
 
12
+ ## [3.7.3] - 2026-05-23
13
+
14
+ ### Documentation
15
+ - sync README.md badges to v3.7.3: version, skills (21), workflows (14), tests (2210 passing)
16
+ - add vp-design, vp-intake, vp-persona sections to docs/skills-reference.md (21 skills total)
17
+ - update docs/dev/architecture.md orchestration model — ENH-096/097 delegation: tracker-agent, vp-git-agent, read+spawn-only orchestrator
18
+ - remove confusing dual-version paragraph from README.md versioning note
19
+
20
+ ---
21
+
12
22
  ## [3.7.2] - 2026-05-23
13
23
 
14
24
  ### Added — ENH-097: vp-auto Full Orchestrator Delegation (Phase 142)
package/README.md CHANGED
@@ -2,15 +2,15 @@
2
2
 
3
3
  **Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**
4
4
 
5
- [![Version](https://img.shields.io/badge/version-3.1.1-blue.svg)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-3.7.3-blue.svg)](CHANGELOG.md)
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
7
- [![Skills](https://img.shields.io/badge/skills-18-purple.svg)](#skills-reference)
8
- [![Workflows](https://img.shields.io/badge/workflows-13-orange.svg)](#workflows)
7
+ [![Skills](https://img.shields.io/badge/skills-21-purple.svg)](#skills-reference)
8
+ [![Workflows](https://img.shields.io/badge/workflows-14-orange.svg)](#workflows)
9
9
  [![Templates](https://img.shields.io/badge/templates-17-cyan.svg)](#templates)
10
- [![Tests](https://img.shields.io/badge/tests-1324%20passing-brightgreen.svg)](tests/)
10
+ [![Tests](https://img.shields.io/badge/tests-2210%20passing-brightgreen.svg)](tests/)
11
11
  [![GitHub](https://img.shields.io/github/stars/0-CODE/viepilot?style=social)](https://github.com/0-CODE/viepilot)
12
12
 
13
- **Versioning:** Shield **2.19.0** is the **ViePilot framework SemVer** tracked in `.viepilot/TRACKER.md` and `CHANGELOG.md`. The npm `package.json` field `version` (**2.19.0**) is the Node package identifier for this repo; use the framework version for milestone releases and docs.
13
+ **Version**: `3.7.3` — tracked in `package.json`, `CHANGELOG.md`, and `.viepilot/TRACKER.md`.
14
14
 
15
15
  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.
16
16
 
@@ -28,13 +28,13 @@ Nếu ViePilot giúp ích cho bạn, bạn có thể ủng hộ một ly cafe:
28
28
 
29
29
  | Chỉ số / Metric | Giá trị / Value |
30
30
  |-----------------|-----------------|
31
- | Total LOC | **~51,713+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
32
- | Skills | **18** |
33
- | Workflows | **12** |
31
+ | Total LOC | **~94,739+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
32
+ | Skills | **21** |
33
+ | Workflows | **14** |
34
34
  | Templates | **17** (Project: 12, Phase: 5) |
35
35
  | CLI Commands | **18** (`vp-tools` 17 subcommands + `viepilot` installer) |
36
- | 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) |
37
- | 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` |
36
+ | Tests | **2210** (111 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) |
37
+ | ViePilot phases (local `.viepilot`) | **142** phase cycles — **v3.7.x** ENH-095~097 orchestrator delegation; **v3.0.0** M3.0 Per-Adapter Intelligence; **v2.4.0** FEAT-015 Codex; **v2.0.0** FEAT-013 dynamic adapters; xem `CHANGELOG.md` |
38
38
  | Standards | 5 (SemVer, Commits, Changelog, Comments, Contributors) |
39
39
 
40
40
  > 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,29 +43,29 @@ Nếu ViePilot giúp ích cho bạn, bạn có thể ủng hộ một ly cafe:
43
43
 
44
44
  | Thành phần / Component | Số lượng / Count | Mô tả / Description |
45
45
  |------------------------|------------------|---------------------|
46
- | Skill Definitions | **17** | SKILL.md files với trigger, process, success criteria |
47
- | Workflow Files | **12** | Step-by-step execution guides |
46
+ | Skill Definitions | **21** | SKILL.md files với trigger, process, success criteria |
47
+ | Workflow Files | **14** | Step-by-step execution guides |
48
48
  | Project Templates | 12 | AI-GUIDE, ARCHITECTURE, VIEPILOT-META, README, SYSTEM-RULES, etc. |
49
49
  | Phase Templates | 5 | SPEC, PHASE-STATE, TASK, VERIFICATION, SUMMARY |
50
50
  | CLI Tools | 2 | vp-tools.cjs (**17** subcommands) + viepilot.cjs (guided installer) |
51
- | 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, …) |
51
+ | Test Files | 111 | Jest: 111 test files (contracts, installer + Claude paths, info/update, FEAT-009/010/011~015, ENH-021~037, BUG-009~013 guards, adapter tests, scope policy, …) |
52
52
 
53
53
  ---
54
54
 
55
55
  ## Độ hoàn thiện / Completion Status
56
56
 
57
57
  ```
58
- 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
58
+ Tổng thể / Overall: ████████████████████ ~99% ✅ Latest **v3.7.3** ENH-095~097 orchestrator delegation; **v3.0.0** M3.0 Per-Adapter Intelligence; **v2.4.0** FEAT-015 Codex adapter; **v2.0.0** FEAT-013 dynamic adapters
59
59
  ```
60
60
 
61
61
  | Lĩnh vực / Area | Trạng thái | Chi tiết |
62
62
  |-----------------|------------|----------|
63
- | Core Skills (18) | ✅ Hoàn thiện | brainstorm, crystallize, auto, pause, resume, status, info, request, evolve, docs, update, task, debug, rollback, audit, ui-components, proposal, **skills** |
64
- | Workflows (13) | ✅ Hoàn thiện | Full step-by-step guides với success criteria |
63
+ | Core Skills (21) | ✅ Hoàn thiện | brainstorm, crystallize, auto, pause, resume, status, info, request, evolve, docs, update, task, debug, rollback, audit, ui-components, proposal, skills, **design, intake, persona** |
64
+ | Workflows (14) | ✅ Hoàn thiện | Full step-by-step guides với success criteria |
65
65
  | Project Templates (12) | ✅ Hoàn thiện | Placeholders cho customization (+ `VIEPILOT-META` FEAT-009) |
66
66
  | Phase Templates (5) | ✅ Hoàn thiện | Task tracking, verification, summary |
67
67
  | CLI Tools (18) | ✅ Hoàn thiện | vp-tools 17 subcommands + viepilot installer; bundle `info` / `update` |
68
- | Tests (957) | ✅ Hoàn thiện | Unit, integration, AI compat, workflow contracts, installer, scope policy, FEAT-009~015, ENH-021~048, BUG-009~013, adapter tests, AskUserQuestion adapter-aware prompts |
68
+ | Tests (2210) | ✅ Hoàn thiện | Unit, integration, AI compat, workflow contracts, installer, scope policy, FEAT-009~015, ENH-021~048, BUG-009~013, adapter tests, AskUserQuestion adapter-aware prompts |
69
69
  | CI/CD | ✅ Hoàn thiện | GitHub Actions, Node 18/20/22 matrix, coverage >80% |
70
70
  | Documentation | ✅ Hoàn thiện | dev/, user/, api/, videos/, examples/, troubleshooting |
71
71
  | Standards | ✅ Hoàn thiện | SemVer, Conventional Commits, Keep a Changelog |
package/docs/dev/architecture.md CHANGED
@@ -216,6 +216,32 @@ User Request
216
216
  | No external runtime | Works with any AI assistant |
217
217
  | CommonJS (no ESM) | Maximum Node.js compatibility |
218
218
 
219
+ ## Agent Orchestration Model (ENH-096/097)
220
+
221
+ As of v3.7.2, the vp-auto orchestrator is **read + spawn only**. It never calls Edit, Write, or Bash for any write operation. All work is delegated to specialized subagents:
222
+
223
+ | Agent | Role | Tools Permitted |
224
+ |-------|------|-----------------|
225
+ | vp-auto orchestrator | Read state, spawn workers, gate phase transitions | Read, Bash (read-only git only), Agent |
226
+ | vp-task-executor | All implementation — code, docs, config edits | Read, Edit, Write, MultiEdit, Bash, Glob, Grep, LS |
227
+ | vp-quality-gate | Run verification commands, report PASS/FAIL | Read, Bash, Grep, Glob, LS |
228
+ | vp-phase-planner | Build dependency graph, identify parallel task clusters | Read, Glob, Grep, LS |
229
+ | tracker-agent | Write state files: PHASE-STATE.md, TRACKER.md, HANDOFF.json, ROADMAP.md | Read, Edit, Write |
230
+ | vp-git-agent | Git operations: create-tag, push-branch, push-tags, push-all, git-status | Bash only |
231
+ | changelog-agent | Write CHANGELOG.md entries for features and fixes | Read, Edit, Write |
232
+
233
+ **Result formats:**
234
+ - `TASK_RESULT: PASS | FAIL | PARTIAL` — returned by vp-task-executor and vp-quality-gate
235
+ - `GIT_RESULT: PASS | FAIL | SKIP` — returned by vp-git-agent
236
+
237
+ **Orchestration flow:**
238
+ 1. Orchestrator reads PHASE-STATE.md + task contracts
239
+ 2. Spawns tracker-agent → set tasks `in_progress`
240
+ 3. Spawns vp-task-executor(s) — parallel fan-out for independent tasks
241
+ 4. Spawns vp-quality-gate for each completed task
242
+ 5. On PASS: spawns tracker-agent → mark task done, update HANDOFF.json
243
+ 6. On phase complete: spawns vp-git-agent (tag + push), tracker-agent (ROADMAP update), changelog-agent
244
+
219
245
  ## Extension Points
220
246
 
221
247
  | Point | How to Extend |
package/docs/skills-reference.md CHANGED
@@ -547,3 +547,99 @@ Full guide: `docs/user/features/proposal.md`
547
547
  - Fallback: `~/.cursor/viepilot/bin/vp-tools.cjs` for Cursor adapter.
548
548
  - Registry file: `~/.viepilot/skill-registry.json` — shared across all projects.
549
549
  - Confirmation AUQ prompt before destructive `uninstall` (Claude Code terminal only).
550
+
551
+ ---
552
+
553
+ ## /vp-design
554
+
555
+ Visual/UI direction skill. Generates UI architecture: component map, color system, typography,
556
+ responsive breakpoints, and Pencil design file integration.
557
+
558
+ ### Triggers
559
+ `vp-design`, `/vp-design`, "thiết kế UI", "UI direction", "design system"
560
+
561
+ ### Flags
562
+ - `--new` : Start fresh UI direction session
563
+ - `--component <name>` : Design a specific component
564
+ - `--mobile` : Mobile-first emphasis
565
+ - `--architect` : Generate Architect HTML view alongside
566
+
567
+ ### Flow
568
+ 1. Collect product goals + target audience + brand constraints
569
+ 2. Generate UI direction: color palette, typography, spacing scale, component inventory
570
+ 3. Output Pencil design stubs (if Pencil MCP available) or Architect HTML fallback
571
+ 4. Write `docs/ui-direction.md` and `PROJECT-CONTEXT.md ## UI Direction`
572
+
573
+ ### Output
574
+ - `docs/ui-direction.md` (created/updated)
575
+ - `PROJECT-CONTEXT.md` UI Direction section (locked by `/vp-crystallize` Step 1E)
576
+ - Optional: Pencil `.pen` file stubs via `mcp__pencil__batch_design`
577
+
578
+ ### Adapter-Aware Prompts
579
+ Uses `AskUserQuestion` on Claude Code terminal for design-direction questions.
580
+
581
+ ---
582
+
583
+ ## /vp-intake
584
+
585
+ Structured intake from Google Sheets, Excel (M365), CSV files, and browser URLs. Reads rows
586
+ from a configured source, creates ViePilot request files, and optionally writes results back.
587
+
588
+ ### Triggers
589
+ `vp-intake`, `/vp-intake`, "đọc intake", "intake từ sheet", "load requests from sheet"
590
+
591
+ ### Flags
592
+ - `--channel <id>` : Force a specific intake channel (sheets/excel/csv/browser)
593
+ - `--dry-run` : Parse and triage without writing request files
594
+ - `--no-writeback` : Skip writing results back to source
595
+ - `--setup` : Launch AUQ-driven channel configuration wizard (ENH-084)
596
+
597
+ ### Flow
598
+ 1. Load intake manifest (`~/.viepilot/intake-manifests/<project>.json`) or prompt setup
599
+ 2. Read rows from configured channel (Google Sheets via API, Excel via M365 Graph, CSV, or browser-agent for public URLs)
600
+ 3. Triage each row: detect type (bug/feature/enhancement/debt), extract title/description
601
+ 4. Create `.viepilot/requests/{TYPE}-{N}.md` for each valid row
602
+ 5. Write-back status column to source row (if writable channel)
603
+
604
+ ### Output
605
+ - `.viepilot/requests/{TYPE}-{N}.md` per intake row
606
+ - Intake manifest updated with last-read cursor
607
+ - Source row status updated (write-back, if enabled)
608
+
609
+ ### Adapters
610
+ Full support: Claude Code. Partial: Cursor (no AUQ). Text fallback: Codex/Copilot/Antigravity.
611
+
612
+ ---
613
+
614
+ ## /vp-persona
615
+
616
+ Manages the global developer persona profile stored in `~/.viepilot/config.json`. Persona
617
+ controls output style, stack preferences, and team-size assumptions injected into every skill.
618
+
619
+ ### Triggers
620
+ `vp-persona`, `/vp-persona`, "cấu hình persona", "set persona", "developer profile"
621
+
622
+ ### Flags
623
+ - `--set` : Interactively set persona fields
624
+ - `--show` : Print current active persona
625
+ - `--auto-switch` : Switch persona based on current project stack (used internally by skills)
626
+ - `--context` : Print persona as `## User Persona` block (used by skill banners)
627
+
628
+ ### Persona Fields
629
+ | Field | Values | Default |
630
+ |-------|--------|---------|
631
+ | `role` | backend / frontend / fullstack / devops / data / mobile | backend |
632
+ | `domain` | web-saas / mobile / api / data / infra / other | web-saas |
633
+ | `stacks` | comma-separated list | — |
634
+ | `outputStyle` | lean / verbose | lean |
635
+ | `phaseTemplate` | lean-startup / enterprise / research | lean-startup |
636
+ | `teamSize` | solo / small / medium / large | solo |
637
+
638
+ ### Flow
639
+ 1. `vp-tools persona auto-switch` — detects stack from package.json / pyproject.toml / build.gradle
640
+ 2. `vp-tools persona context` — outputs `## User Persona` markdown block
641
+ 3. Skills inject this block silently before task execution
642
+
643
+ ### Output
644
+ - `~/.viepilot/config.json` updated
645
+ - `## User Persona` injected into each skill session
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "viepilot",
3
- "version": "3.7.2",
3
+ "version": "3.7.3",
4
4
  "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
5
5
  "main": "index.js",
6
6
  "bin": {