wtf-p 0.3.0 → 0.5.0

package/vendors/opencode/commands/wtfp/polish-prose.md

@@ -0,0 +1,115 @@
+---
+name: wtfp:polish-prose
+description: Improve clarity, flow, and academic voice in written prose
+---
+
+<execution_context>
+@~/.opencode/write-the-f-paper/references/principles.md
+</execution_context>
+
+<objective>
+Polish prose to eliminate robotic AI-sounding text and improve academic voice.
+
+**Orchestrator role:** Identify target files, gather voice preference, resolve model profile, spawn prose-polisher agent, present results.
+</objective>
+
+<context>
+Target: $ARGUMENTS (section number, file path, or "all" for full manuscript)
+
+**Load project state:**
+@.planning/STATE.md
+</context>
+
+<process>
+
+## 1. Validate Environment and Resolve Model Profile
+
+```bash
+ls paper/*.md 2>/dev/null || echo "No content in paper/ directory"
+```
+
+```bash
+MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+```
+
+| Agent | quality | balanced | budget |
+|-------|---------|----------|--------|
+| prose-polisher | opus | sonnet | haiku |
+
+## 2. Identify Target and Gather Preferences
+
+Parse $ARGUMENTS to find target file(s).
+
+Use the question tool:
+- header: "Voice"
+- question: "What tone should dominate this section?"
+- options:
+  - "Authoritative" — Confident, direct claims
+  - "Measured" — Careful hedging, academic caution
+  - "Accessible" — Clear to non-specialists
+  - "Technical" — Dense, specialist terminology OK
+
+## 3. Read Context Files
+
+```bash
+TARGET_CONTENT=$(cat paper/[target].md 2>/dev/null)
+STYLE_CONTENT=$(cat .planning/sources/style-guide.md 2>/dev/null)
+
+SECTION_DIR=$(ls -d .planning/sections/${SECTION}-* 2>/dev/null | head -1)
+CONTEXT_CONTENT=$(cat "${SECTION_DIR}"/*-CONTEXT.md 2>/dev/null)
+```
+
+## 4. Spawn wtfp-prose-polisher Agent
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► POLISHING PROSE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+```
+Task(
+  prompt="First, read ~/.opencode/agents/wtfp/prose-polisher.md for your role and instructions.\n\n" + filled_polish_prompt,
+  subagent_type="general-purpose",
+  model="{polisher_model}",
+  description="Polish prose"
+)
+```
+
+Polish prompt includes: `<target_content>` with section text, `<voice_preference>` with user selection, `<style_guide>` with style context, `<user_decisions>` with CONTEXT_CONTENT.
+
+## 5. Handle Polisher Return
+
+**`## POLISH COMPLETE`:** Present before/after summary.
+
+**`## POLISH BLOCKED`:** Present blocker, ask user how to proceed.
+
+## 6. Present Results
+
+</process>
+
+<offer_next>
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► PROSE POLISHED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+───────────────────────────────────────────
+
+## Next Up
+
+- `/wtfp:review-section {N}` — Get reviewer feedback
+- `/wtfp:check-refs` — Verify citations
+- `/wtfp:export-latex` — Generate LaTeX
+
+───────────────────────────────────────────
+
+</offer_next>
+
+<success_criteria>
+- [ ] Target file(s) identified
+- [ ] Voice preference gathered
+- [ ] Prose-polisher spawned with full context
+- [ ] Changes applied to paper/ files
+- [ ] User knows next steps
+</success_criteria>

package/vendors/opencode/commands/wtfp/progress.md

@@ -0,0 +1,146 @@
+---
+name: wtfp:progress
+description: Check writing progress, show context, and route to next action
+---
+
+<objective>
+Check writing progress, summarize recent work, and intelligently route to the next action.
+
+**Orchestrator role:** Load state files, calculate progress metrics, present rich status report, determine and offer the next logical command.
+</objective>
+
+<context>
+No arguments. Reads project state from .planning/.
+</context>
+
+<process>
+
+## 1. Validate Environment
+
+```bash
+ls .planning/STATE.md .planning/ROADMAP.md .planning/PROJECT.md 2>/dev/null
+```
+
+If missing `.planning/` -> suggest `/wtfp:new-paper`.
+If missing STATE.md or ROADMAP.md -> suggest what's needed.
+
+## 2. Load Project Context
+
+Read: STATE.md, ROADMAP.md, PROJECT.md, config.json (for model_profile).
+
+```bash
+MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+```
+
+## 3. Gather Recent Work
+
+Find 2-3 most recent SUMMARY.md files. Extract: what was written, key decisions, issues.
+
+## 4. Parse Current Position
+
+From STATE.md: current section, plan number, status, word count.
+Calculate: total plans, completed, remaining. Total words vs target.
+Check for CONTEXT.md in current section directory.
+
+## 4b. Build Statusline
+
+Build the statusline string:
+```
+WTF-P > {section progress} * {word count} > {model_profile}
+```
+
+**Section progress:** `{completed}/{total} sections` (count SUMMARY.md files vs total sections)
+
+**Word count:** `{current_words}/{target_words}w` (from STATE.md and PROJECT.md)
+
+**Model profile:** from config.json (quality/balanced/budget)
+
+**Update indicator:** Check for newer version quietly:
+```bash
+CURRENT=$(node -e "console.log(require('$(npm root -g)/wtf-p/package.json').version)" 2>/dev/null || echo "")
+LATEST=$(npm view wtf-p version 2>/dev/null || echo "")
+```
+
+If LATEST exists and CURRENT < LATEST, append ` ^ update` to statusline.
+
+**Pending todos:** Count files:
+```bash
+PENDING_TODOS=$(ls -1 .planning/todos/pending/*.md 2>/dev/null | wc -l | tr -d ' ')
+```
+
+## 5. Present Status Report
+
+**Display statusline FIRST** (before all other output):
+```
+WTF-P > 3/6 sections * 4200/8000w > balanced ^ update
+```
+
+Then the detailed status report:
+
+```
+# [Paper Title]
+
+**Progress:** [########--] 8/10 sections drafted
+**Words:** [current] / [target] ([percentage]%)
+**Profile:** [quality/balanced/budget]
+
+## Recent Work
+- [Section X]: [1-line summary]
+
+## Current Position
+Section [N] of [total]: [name] -- [status]
+CONTEXT: [yes | -]
+
+## Key Decisions
+- [from STATE.md]
+
+## Open Issues
+- [deferred items]
+
+## Pending Todos
+{PENDING_TODOS} pending (run /wtfp:check-todos to review)
+```
+
+## 6. Route to Next Action
+
+**Count files in current section:**
+```bash
+ls -1 .planning/sections/[dir]/*-PLAN.md 2>/dev/null | wc -l
+ls -1 .planning/sections/[dir]/*-SUMMARY.md 2>/dev/null | wc -l
+ls -1 .planning/sections/[dir]/*-ISSUES.md 2>/dev/null | wc -l
+```
+
+**Route A -- Unexecuted plan exists** (summaries < plans):
+Find first PLAN.md without SUMMARY.md. Offer `/wtfp:write-section [path]`.
+
+**Route B -- Section needs planning** (plans = 0):
+If CONTEXT.md exists -> offer `/wtfp:plan-section {N}`.
+If not -> offer `/wtfp:discuss-section {N}` or `/wtfp:plan-section {N}`.
+
+**Route C -- Section complete, more remain** (summaries = plans, not last section):
+Offer `/wtfp:plan-section {N+1}`. Also: `/wtfp:review-section {N}`.
+
+**Route D -- Draft complete** (all sections done):
+Offer `/wtfp:review-section` and `/wtfp:export-latex`.
+
+**Route E -- Review issues need revision** (ISSUES.md without REVISION.md):
+Offer `/wtfp:plan-revision {plan}`.
+
+</process>
+
+<offer_next>
+
+Show the routed next action with clear command and `/clear` suggestion.
+
+</offer_next>
+
+<success_criteria>
+- [ ] Statusline displayed first: WTF-P > {sections} * {words} > {profile} [^ update]
+- [ ] Update indicator shown when newer version available
+- [ ] Pending todo count shown
+- [ ] Rich context provided (recent work, word counts, decisions)
+- [ ] Current position clear with visual progress
+- [ ] Model profile shown
+- [ ] Smart routing to next command
+- [ ] User confirms before any action
+</success_criteria>

package/vendors/opencode/commands/wtfp/quick.md

@@ -0,0 +1,97 @@
+---
+name: wtfp:quick
+description: Run a small writing fix without full planning overhead
+---
+
+<objective>
+Execute a quick writing task with atomic commits and state tracking but skip optional agents (plan-checker, argument-verifier).
+
+**Orchestrator role:** Parse task, load minimal context, execute directly or spawn writer agent, commit result.
+
+Use for small targeted tasks: fix a paragraph, add a citation, tweak wording, expand a point.
+</objective>
+
+<context>
+Task: $ARGUMENTS (natural language description of what to do)
+
+**Load project state:**
+@.planning/STATE.md
+@.planning/config.json
+</context>
+
+<process>
+
+## 1. Validate Environment
+
+```bash
+ls .planning/ 2>/dev/null || echo "No project — will work on files directly"
+ls paper/*.md 2>/dev/null
+```
+
+## 2. Parse Task Intent
+
+Classify $ARGUMENTS into task type:
+- **fix** — Correct an error, fix citation, resolve contradiction
+- **add** — Add a paragraph, citation, transition, figure reference
+- **revise** — Rewrite a paragraph, strengthen argument, tighten prose
+- **cite** — Add or fix specific citations
+
+## 3. Load Minimal Context
+
+```bash
+MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+STATE_CONTENT=$(cat .planning/STATE.md 2>/dev/null)
+```
+
+Only load files directly relevant to the task. No full context dump.
+
+## 4. Execute Task
+
+**For simple tasks (fix, cite):** Execute directly in orchestrator — read target file, make edit, verify.
+
+**For complex tasks (add, revise):** Spawn section-writer agent with focused prompt.
+
+| Agent | quality | balanced | budget |
+|-------|---------|----------|--------|
+| section-writer | opus | sonnet | sonnet |
+
+```
+Task(
+  prompt="First, read ~/.opencode/agents/wtfp/section-writer.md for your role.\n\n" + focused_prompt,
+  subagent_type="general-purpose",
+  model="{writer_model}",
+  description="Quick: [task summary]"
+)
+```
+
+**Skip:** plan-checker, argument-verifier (quick mode = no verification loop).
+
+## 5. Commit and Update State
+
+```bash
+git add paper/
+git commit -m "[type](quick): [task description]"
+```
+
+Update STATE.md word count if changed.
+
+</process>
+
+<offer_next>
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► QUICK TASK DONE ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[task summary] — [words changed]
+
+───────────────────────────────────────────
+
+</offer_next>
+
+<success_criteria>
+- [ ] Task executed with minimal context loading
+- [ ] Changes committed atomically
+- [ ] STATE.md word count updated
+- [ ] No unnecessary agent spawning
+</success_criteria>

package/vendors/opencode/commands/wtfp/remove-section.md

@@ -0,0 +1,141 @@
+---
+name: wtfp:remove-section
+description: Remove an unwritten section and renumber the rest
+---
+
+<objective>
+Remove a future (unwritten) section and renumber subsequent sections.
+
+Only works on sections that haven't been started yet.
+
+Git commit preserves historical record of what was removed.
+</objective>
+
+<process>
+
+<step name="verify">
+**Verify project and section:**
+
+```bash
+[ ! -f .planning/ROADMAP.md ] && echo "ERROR: No roadmap found" && exit 1
+```
+
+Check section exists and hasn't been started:
+- No PLAN.md files in section directory
+- No SUMMARY.md files in section directory
+- Status is "Not started" in ROADMAP.md
+
+If section has work:
+```
+ERROR: Section [N] has already been started.
+
+To remove a section with existing work:
+1. Manually delete the content
+2. Update ROADMAP.md
+3. Commit the changes
+
+This command only removes future/unstarted sections.
+```
+</step>
+
+<step name="confirm">
+**Confirm removal:**
+
+Show what will be removed:
+
+```
+## Section to Remove
+
+Section [N]: [Name]
+- Goal: [goal]
+- Word target: [X]
+- Status: Not started
+
+## Impact
+
+Sections to renumber:
+- Section [N+1] → Section [N]
+- Section [N+2] → Section [N+1]
+- ...
+
+Files to delete:
+- .planning/sections/[NN]-[name]/
+```
+
+Use the question tool:
+- header: "Remove Section"
+- question: "Remove Section [N]: [name] and renumber subsequent sections?"
+- options:
+  - "Yes, remove it" — Delete and renumber
+  - "Cancel" — Keep the section
+
+</step>
+
+<step name="remove">
+**Remove section:**
+
+1. Delete section directory:
+```bash
+rm -rf ".planning/sections/[NN]-[name]/"
+```
+
+2. Update ROADMAP.md:
+- Remove section entry
+- Renumber all subsequent sections
+
+3. Rename subsequent section directories:
+```bash
+mv ".planning/sections/[N+1]-[name]/" ".planning/sections/[N]-[name]/"
+# ... for all subsequent sections
+```
+
+4. Update any references in STATE.md
+
+</step>
+
+<step name="commit">
+```bash
+git add .planning/
+git commit -m "$(cat <<'EOF'
+docs: remove Section [N] - [name]
+
+Removed unstarted section.
+Renumbered sections [N+1]-[total] to [N]-[total-1].
+EOF
+)"
+```
+
+</step>
+
+<step name="done">
+**Present completion:**
+
+```
+Section removed:
+
+- Removed: Section [N] - [Name]
+- Renumbered: Sections [N+1]-[total] → [N]-[total-1]
+- Total sections: [new total]
+
+---
+
+## ▶ Next Up
+
+`/wtfp:progress` — check updated status
+
+---
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Section verified as unstarted
+- [ ] User confirmed removal
+- [ ] Section directory deleted
+- [ ] ROADMAP.md updated
+- [ ] Subsequent sections renumbered
+- [ ] All references updated
+- [ ] Committed to git with clear history
+</success_criteria>

package/vendors/opencode/commands/wtfp/report-bug.md

@@ -0,0 +1,127 @@
+---
+name: wtfp:report-bug
+description: Report a bug via GitHub issue
+---
+
+<objective>
+Help the user report a bug in WTF-P by creating a well-formatted GitHub issue.
+</objective>
+
+<context>
+@~/.opencode/write-the-f-paper/references/github-contrib.md
+</context>
+
+<process>
+
+## Step 1: Verify GitHub CLI
+
+Check if `gh` is authenticated:
+
+```bash
+gh auth status 2>&1
+```
+
+If not authenticated, inform the user:
+> To create GitHub issues, you need to authenticate the GitHub CLI.
+> Run: `gh auth login`
+> Then try this command again.
+
+## Step 2: Gather Bug Information
+
+Use the question tool to collect bug details:
+
+**Question 1: Bug Category**
+- Header: "Bug Type"
+- Options:
+  - "Command fails" - A /wtfp:* command doesn't work as expected
+  - "Installation issue" - Problems with npx wtf-p install/uninstall
+  - "Workflow error" - Writing workflow produces wrong output
+  - "Documentation gap" - Docs are missing or incorrect
+
+**Question 2: Bug Description**
+- Header: "Description"
+- Options:
+  - "Let me describe it" - User provides description
+  - "Help me articulate" - Assistant helps user describe the bug
+
+If user needs help articulating, ask follow-up questions:
+- What were you trying to do?
+- What happened instead?
+- What did you expect to happen?
+
+## Step 3: Gather Environment Info
+
+Automatically collect:
+```bash
+npx wtf-p --version 2>/dev/null || echo "Not installed via npx"
+node --version
+uname -s 2>/dev/null || echo "Unknown OS"
+```
+
+## Step 4: Collect Reproduction Steps
+
+Ask user:
+- What command or action triggered the bug?
+- Can you reproduce it consistently?
+- Any error messages? (ask to paste them)
+
+## Step 5: Draft the Issue
+
+Create a draft and show it to the user:
+
+```markdown
+## Bug Description
+[From user input]
+
+## Steps to Reproduce
+1. [Step 1]
+2. [Step 2]
+3. [What happened vs expected]
+
+## Environment
+- WTF-P version: [collected]
+- Node.js version: [collected]
+- OS: [collected]
+
+## Additional Context
+[Error messages, logs, screenshots mentioned]
+```
+
+## Step 6: Confirm and Create
+
+Ask user to confirm:
+- "Create this issue?" with options: Yes / Edit first / Cancel
+
+If confirmed, create the issue:
+
+```bash
+gh issue create \
+  --repo akougkas/wtf-p \
+  --title "bug: [SHORT_TITLE]" \
+  --body "$(cat <<'EOF'
+[FULL_BODY_HERE]
+EOF
+)" \
+  --label "bug"
+```
+
+## Step 7: Report Success
+
+Show the user:
+- Issue URL (from gh output)
+- Issue number
+- What happens next (maintainer will review)
+
+</process>
+
+<error-handling>
+
+**gh not installed**: Direct user to https://cli.github.com/
+
+**gh not authenticated**: Guide through `gh auth login`
+
+**Network error**: Save draft locally, retry later
+
+**Permission denied**: User may need to fork first for external contributors
+
+</error-handling>