viepilot 2.1.0 → 2.12.0

package/skills/vp-pause/SKILL.md

@@ -41,11 +41,11 @@ Save complete work state so it can be resumed from any context.
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/pause-work.md
+@$HOME/{envToolDir}/workflows/pause-work.md
 </execution_context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/pause-work.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/pause-work.md`
 
 ### Step 1: Detect Current Position
 ```bash

package/skills/vp-proposal/SKILL.md

@@ -0,0 +1,175 @@
+---
+name: vp-proposal
+description: "Generate professional proposal packages (.pptx + .docx + .md) from brainstorm sessions or direct briefs"
+version: 0.1.0
+---
+
+<cursor_skill_adapter>
+## A. Skill Invocation
+- Skill được gọi khi user mention `vp-proposal`, `/vp-proposal`, "proposal", "pitch deck", "presentation", "tài liệu đề xuất"
+- Treat all user text after the skill mention as `{{VP_ARGS}}`
+
+## B. User Prompting
+Prompt user conversationally with numbered list options.
+
+## C. Tool Usage
+Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
+</cursor_skill_adapter>
+<scope_policy>
+## ViePilot Namespace Guard (BUG-004)
+- Default mode: only use and reference `vp-*` skills in ViePilot workflows.
+- External skills (`non vp-*`) are out of framework scope unless user explicitly opts in.
+</scope_policy>
+<implementation_routing_guard>
+## Implementation routing guard (ENH-021)
+
+- **`/vp-proposal`** generates **output artifacts** (`docs/proposals/*.pptx`, `*.docx`, `*.md`) — it does **not** implement shipping code for `lib/`, `tests/`, `bin/`, or framework `workflows/`/`skills/`.
+- This skill is the **delivery lane** after `/vp-brainstorm` captures the ideas. Use `/vp-request` → `/vp-evolve` → `/vp-auto` for ViePilot framework feature work.
+- **Exception:** User **explicit** bypass — state clearly in chat.
+</implementation_routing_guard>
+
+<objective>
+Generate a professional proposal package from a brainstorm session or direct brief.
+
+**Output files** (written to `docs/proposals/`):
+- `{slug}-{date}.md` — structured proposal Markdown (source of truth)
+- `{slug}-{date}.pptx` — presentation file (ViePilot branded, dark navy/charcoal)
+- `{slug}-{date}.docx` — detailed project document
+- `{slug}-{date}-slides.txt` — Google Slides URL (only with `--slides` flag)
+
+**Proposal types:**
+| Type | Slides | Use case |
+|------|--------|----------|
+| `project-proposal` | 10 | Scope, timeline, budget for clients |
+| `tech-architecture` | 12 | Technical design for partners |
+| `product-pitch` | 12 | Investor / partner pitch deck |
+| `general` | 8 | Generic, fallback |
+
+**Template resolution (2-tier):**
+1. `.viepilot/proposal-templates/{type}.pptx` — project-level override
+2. `{viepilot-install}/templates/proposal/pptx/{type}.pptx` — ViePilot stock
+
+**Context detection:**
+- Auto-loads latest `docs/brainstorm/session-*.md` when present
+- Standalone mode if no session found (user provides brief)
+- `--from session-YYYY-MM-DD.md` for explicit session selection
+</objective>
+
+<execution_context>
+workflows/proposal.md
+</execution_context>
+
+<context>
+Optional flags:
+- `--type <id>` : Proposal type — `project-proposal` | `tech-architecture` | `product-pitch` | `general`
+                  If omitted: guided selection menu is shown
+- `--from <file>` : Explicit brainstorm session file to use as context
+                    Default: auto-detect latest `docs/brainstorm/session-*.md`
+- `--lang <code>` : Language for generated content — ISO 639-1 (e.g. vi, en, ja, fr, zh).
+                    If omitted: prompted with MRU suggestions from config.
+                    Saved to ~/.viepilot/config.json → proposal.recentLangs after generation.
+- `--lang-content-only` : Translate content (bullets, notes, paragraphs) only.
+                           Keep structural labels / section names in English.
+- `--slides` : After .pptx is generated, upload to Google Slides via service account auth
+               Requires: `@googleapis/slides` installed + `GOOGLE_APPLICATION_CREDENTIALS` env var
+- `--dry-run` : Show slide manifest (JSON) without writing any files
+</context>
+
+<process>
+Execute workflow from `workflows/proposal.md`
+
+### Step 1: Context Detection
+- Scan `docs/brainstorm/` for `session-*.md` → sort descending → load latest
+- If `--from` specified: load that file directly
+- If no session found: prompt user for brief:
+  - Project name
+  - One-line description
+  - Target audience (client / partner / investor)
+  - 3–5 key points to cover
+
+### Step 2: Proposal Type Selection
+- If `--type` provided: validate; show type + slide count to confirm
+- Else: present menu:
+  ```
+  1. Project Proposal     (10 slides) — scope, timeline, budget
+  2. Tech Architecture    (12 slides) — system design for partners
+  3. Product Pitch Deck   (12 slides) — investor / partner pitch
+  4. General Proposal     ( 8 slides) — generic fallback
+  ```
+
+### Step 3: AI Slide Manifest Generation
+- Structure context into JSON manifest:
+  ```json
+  {
+    "title": "...",
+    "subtitle": "...",
+    "slides": [
+      { "index": 1, "layout": "cover", "heading": "...", "body": "...", "speakerNotes": "..." },
+      { "index": 2, "layout": "section", "heading": "...", "bullets": ["..."], "speakerNotes": "..." }
+    ]
+  }
+  ```
+- Slide count MUST match `PROPOSAL_TYPES[typeId].slides`
+- If `--dry-run`: print manifest and stop
+
+### Step 4: Template Resolution
+- Call `resolveTemplate(typeId, 'pptx', projectRoot)` → pptx template path
+- Call `resolveTemplate('project-detail', 'docx', projectRoot)` → docx template path
+- Warn (not error) if stock fallback is used
+
+### Step 5: Generate .pptx
+- Load template via pptxgenjs
+- Apply slide manifest: inject titles, bullets, speaker notes per slide
+- Ensure `docs/proposals/` directory exists
+- Write `{slug}-{date}.pptx`
+
+### Step 6: Generate .docx
+- Build detailed document from same manifest + extended content
+- Sections: Executive Summary, Problem & Solution, Features & Specifications,
+            Technical Architecture (if relevant), Timeline, Team, Appendix
+- Write `{slug}-{date}.docx`
+
+### Step 7: Generate .md summary
+- Write Markdown mirror of the manifest
+- Save `{slug}-{date}.md`
+
+### Step 8: Optional Google Slides upload (`--slides`)
+- Call `lib/google-slides-exporter.cjs` → `uploadToSlides(pptxPath, title)`
+- Write URL to `{slug}-{date}-slides.txt`
+- On failure: surface error but do NOT fail the whole command (files already written)
+
+### Step 9: Confirm output
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► PROPOSAL GENERATED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Type:    {type label}  ({N} slides)
+ Context: {session file or "direct brief"}
+
+ Files:
+   docs/proposals/{slug}-{date}.md
+   docs/proposals/{slug}-{date}.pptx
+   docs/proposals/{slug}-{date}.docx
+   [docs/proposals/{slug}-{date}-slides.txt]  ← if --slides
+
+ Next:
+   Open .pptx in PowerPoint / Keynote / LibreOffice
+   Share .docx as supporting document
+   Run /vp-proposal --slides to upload to Google Slides
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</process>
+
+<success_criteria>
+- [ ] Context detected (brainstorm session or user brief)
+- [ ] Proposal type selected and validated
+- [ ] Slide manifest generated with correct slide count
+- [ ] .pptx written to docs/proposals/
+- [ ] .docx written to docs/proposals/
+- [ ] .md summary written to docs/proposals/
+- [ ] Template resolution: project override takes precedence over stock
+- [ ] --lang: content generated in specified language; MRU saved to config
+- [ ] --lang-content-only: bullets/notes translated; structural labels stay English
+- [ ] --slides: Google Slides URL written to -slides.txt (or clear error shown)
+- [ ] --dry-run: manifest printed, no files written
+</success_criteria>

package/skills/vp-request/SKILL.md

@@ -49,7 +49,7 @@ Create and manage requests for the project under development:
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/request.md
+@$HOME/{envToolDir}/workflows/request.md
 </execution_context>
 
 <context>
@@ -64,7 +64,7 @@ Optional flags:
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/request.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/request.md`
 
 ### Step 1: Detect Request Type
 

package/skills/vp-resume/SKILL.md

@@ -41,11 +41,11 @@ Restore complete project context and resume work seamlessly.
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/resume-work.md
+@$HOME/{envToolDir}/workflows/resume-work.md
 </execution_context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/resume-work.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/resume-work.md`
 
 ### Step 1: Check Project Exists
 ```bash

package/skills/vp-rollback/SKILL.md

@@ -44,7 +44,7 @@ Rollback to any checkpoint safely, with backup and state preservation.
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/rollback.md
+@$HOME/{envToolDir}/workflows/rollback.md
 </execution_context>
 
 <context>

package/skills/vp-ui-components/SKILL.md

@@ -45,7 +45,7 @@ Sources can come from prompt/link/snippet (especially 21st.dev), then normalized
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/workflows/ui-components.md
+@$HOME/{envToolDir}/workflows/ui-components.md
 </execution_context>
 
 <context>
@@ -58,7 +58,7 @@ Optional flags:
 </context>
 
 <process>
-Execute workflow from `@$HOME/.cursor/viepilot/workflows/ui-components.md`
+Execute workflow from `@$HOME/{envToolDir}/workflows/ui-components.md`
 
 Key steps:
 1. Prepare global + local component stores

package/skills/vp-update/SKILL.md

@@ -37,7 +37,7 @@ Run **`vp-tools update`** to plan and (when confirmed) execute the `npm` upgrade
 </objective>
 
 <execution_context>
-@$HOME/.cursor/viepilot/bin/vp-tools.cjs
+@$HOME/{envToolDir}/bin/vp-tools.cjs
 </execution_context>
 
 <process>

package/workflows/autonomous.md

@@ -134,6 +134,25 @@ FOR EACH path in ## Paths:
 This check fires on `~/`, `~\`, and any path starting with `/`.
 It does NOT fire on paths inside code block content within the task (only the `## Paths` header block is validated).
 
+#### ⛔ PATH RESOLUTION RULE (BUG-012)
+
+**All file reads and edits during task execution MUST be resolved from `{cwd}`** — the repository root where `package.json` lives (e.g. `/Users/.../my-project/`).
+
+```
+WHEN executing a task with:
+  ## Paths
+  workflows/brainstorm.md
+
+→ Read and edit: {cwd}/workflows/brainstorm.md
+→ NEVER:         ~/.claude/viepilot/workflows/brainstorm.md
+→ NEVER:         ~/.cursor/viepilot/workflows/brainstorm.md
+→ NEVER:         any path outside {cwd}
+```
+
+**Rule**: If a file exists at both `{cwd}/workflows/foo.md` (codebase) and `~/.claude/viepilot/workflows/foo.md` (production install), **ALWAYS use the `{cwd}` copy**.
+
+The install directory (`~/.claude/`, `~/.cursor/`) is a **deployment artifact** — it is populated by `dev-install.sh`. Editing it directly bypasses version control and will be silently overwritten on the next install.
+
 ### ViePilot Skill Scope Policy (BUG-004 baseline)
 - **Default mode**: only reference/route skills in the ViePilot namespace (`vp-*`).
 - **External skills** (`non vp-*`) are out of scope by default and must not be suggested implicitly.
@@ -214,6 +233,16 @@ Ensure `PHASE-STATE.md` already shows current task `in_progress` (set during the
    git commit -m "{type}({scope}): {description}"
    git push
    ```
+
+   ⛔ **GITIGNORE-AWARE STAGING RULE (BUG-013)**: Before staging any file, verify it is
+   not gitignored. NEVER stage or commit gitignored files — they are internal state, not
+   shipping artifacts.
+   ```bash
+   # Check before staging:
+   git check-ignore -q {file} && echo "IGNORED — skip" || git add {file}
+   ```
+   `.viepilot/` is ALWAYS gitignored in ViePilot repos. **Never run `git add .viepilot/`.**
+
 8. Log notes in task file after each sub-task
 
 #### Verify Task
@@ -238,6 +267,9 @@ Before marking a task PASS, require durable git persistence:
 ```bash
 # Must have no unstaged/staged residue for this task
 git status --porcelain
+# NOTE (BUG-013): lines starting with "??" are UNTRACKED files — NOT a dirty state.
+# Porcelain is CLEAN when output is empty OR contains only "??" lines.
+# Gitignored files (e.g. .viepilot/) must never be staged, so they appear as ?? here.
 
 # Must track an upstream branch
 git rev-parse --abbrev-ref --symbolic-full-name @{u}

package/workflows/brainstorm.md

@@ -413,7 +413,7 @@ Display a confirmation dialogue when any of the following conditions occur:
 ...
 
 What would you like to do?
-1. Save to ui-direction/notes.md (background extraction)
+1. Save to .viepilot/ui-direction/{session-id}/notes.md (background extraction)
 2. Save + activate UI Direction Mode to generate HTML direction
 3. Discard and continue brainstorming
 ```