wtf-p 0.3.0 → 0.5.0

package/vendors/opencode/commands/wtfp/execute-outline.md

@@ -0,0 +1,248 @@
+---
+name: wtfp:execute-outline
+description: Write all sections in parallel, then check coherence
+---
+
+<execution_context>
+@~/.opencode/write-the-f-paper/workflows/execute-outline.md
+@~/.opencode/write-the-f-paper/references/checkpoints.md
+@~/.opencode/write-the-f-paper/references/ui-brand.md
+</execution_context>
+
+<objective>
+Execute all sections of a paper in wave-based parallel execution, then verify cross-section coherence.
+
+**Orchestrator role:** Load roadmap and all plans, group sections by wave, spawn parallel write-section Task() calls per wave, collect results, handle checkpoints between waves, spawn coherence-checker after final wave, present results.
+
+**Why wave execution:** Sections within the same wave have no dependencies and can be written in parallel. Sections in later waves depend on earlier waves completing. This maximizes throughput while respecting logical ordering.
+</objective>
+
+<context>
+No arguments. Requires `.planning/ROADMAP.md` and PLAN.md files to exist.
+</context>
+
+<process>
+
+## 1. Validate Environment and Resolve Model Profile
+
+```bash
+[ ! -f .planning/ROADMAP.md ] && echo "ERROR: No outline. Run /wtfp:create-outline" && exit 1
+ls .planning/sections/*/  2>/dev/null
+ls .planning/sections/*/*-PLAN.md 2>/dev/null
+```
+
+**Resolve model profile:**
+
+```bash
+MODEL_PROFILE=$(cat .planning/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+```
+
+**Model lookup table:**
+
+| Agent | quality | balanced | budget |
+|-------|---------|----------|--------|
+| section-writer | opus | sonnet | sonnet |
+| coherence-checker | sonnet | sonnet | haiku |
+
+**Resolve config flags:**
+```bash
+WORKFLOW_VERIFIER=$(cat .planning/config.json 2>/dev/null | grep -o '"verifier"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")
+```
+
+## 2. Read Context Files
+
+```bash
+ROADMAP_CONTENT=$(cat .planning/ROADMAP.md)
+STATE_CONTENT=$(cat .planning/STATE.md)
+PROJECT_CONTENT=$(cat .planning/PROJECT.md)
+ARGMAP_CONTENT=$(cat .planning/structure/argument-map.md 2>/dev/null)
+OUTLINE_CONTENT=$(cat .planning/structure/outline.md 2>/dev/null)
+NARRATIVE_CONTENT=$(cat .planning/structure/narrative-arc.md 2>/dev/null)
+```
+
+## 3. Build Wave Execution Plan
+
+Parse ROADMAP.md and all PLAN.md files to build wave groups:
+
+```bash
+# Find all plans and their wave assignments
+for plan in .planning/sections/*/*-PLAN.md; do
+  section=$(basename $(dirname "$plan"))
+  wave=$(grep -o 'wave:.*' "$plan" | head -1)
+  echo "$wave $section $plan"
+done | sort
+```
+
+Group sections by wave number:
+- Wave 1: [sections with wave: 1] (independent, no dependencies)
+- Wave 2: [sections with wave: 2] (depend on wave 1)
+- ...
+- Wave N: [final sections] (depend on all previous)
+
+Present execution plan:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► EXECUTING OUTLINE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Execution plan:
+  Wave 1: [sections] (parallel)
+  Wave 2: [sections] (after wave 1)
+  Wave 3: [sections] (after wave 2)
+  ...
+
+Total: [N] sections, [W] words target
+```
+
+## 4. Wave Execution Loop
+
+For each wave (1 to max_wave):
+
+**4a. Display wave banner:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► WRITING WAVE {N}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**4b. Spawn parallel writers:**
+
+For each section in the current wave, for each PLAN.md in that section:
+
+```
+Task(
+  prompt="First, read ~/.opencode/agents/wtfp/section-writer.md for your role and instructions.\n\n" + filled_writing_prompt,
+  subagent_type="general-purpose",
+  model="{writer_model}",
+  description="Write Section {X}: {Name}"
+)
+```
+
+Sections within the same wave are spawned in parallel (multiple Task() calls).
+
+**4c. Collect all returns:**
+
+For each completed writer, check return:
+- `## WRITING COMPLETE` -- Record success, update STATE.md
+- `## CHECKPOINT REACHED` -- Queue for user presentation
+- `## WRITING BLOCKED` -- Queue for user presentation
+
+**4d. Handle checkpoints between waves:**
+
+If any CHECKPOINT returns from this wave:
+- Present each checkpoint to user sequentially
+- Get user response for each
+- If checkpoint was blocking and user provides direction, note for re-execution
+
+If any BLOCKED returns:
+- Present blocker to user
+- Options: retry section, skip section (continue to next wave without it), abort execution
+
+**4e. Update progress:**
+
+```bash
+# Update STATE.md with wave completion
+# Update ROADMAP.md section statuses
+```
+
+**4f. Continue to next wave** (only if all sections in current wave are COMPLETE or user chose to skip blocked ones).
+
+## 5. Post-Execution Summary
+
+After all waves complete:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► ALL WAVES COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Sections written: [N]/[total]
+Words written: [W]
+Skipped: [list if any]
+```
+
+## 6. Spawn wtfp-coherence-checker
+
+After the final wave, spawn coherence-checker with explicit inline context:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► VERIFYING COHERENCE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Read all written content:
+```bash
+ALL_PAPER_CONTENT=$(cat paper/*.md 2>/dev/null)
+```
+
+Spawn with inline context (NOT file references -- provide actual content):
+
+```
+Task(
+  prompt="First, read ~/.opencode/agents/wtfp/coherence-checker.md for your role and instructions.\n\n" +
+    "<paper_content>\n" + ALL_PAPER_CONTENT + "\n</paper_content>\n" +
+    "<argument_map>\n" + ARGMAP_CONTENT + "\n</argument_map>\n" +
+    "<narrative_arc>\n" + NARRATIVE_CONTENT + "\n</narrative_arc>\n" +
+    "<outline>\n" + OUTLINE_CONTENT + "\n</outline>\n" +
+    "Run all 5 verification passes and return structured results.",
+  subagent_type="general-purpose",
+  model="{checker_model}",
+  description="Verify Cross-Section Coherence"
+)
+```
+
+## 7. Handle Coherence Check Return
+
+**`## COHERENT`:** All sections pass. Present success summary.
+
+**`## GAPS FOUND`:** Present gaps to user with options:
+- Fix now: Re-spawn writers for affected sections with gap context
+- Accept: Note gaps, proceed to review
+- Plan revision: Create revision plans for affected sections
+
+## 8. Present Final Status
+
+</process>
+
+<offer_next>
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► OUTLINE EXECUTED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Document: {Title}** — {N} sections, {W} words
+
+Coherence: {Verified | Gaps found | Skipped}
+
+───────────────────────────────────────────
+
+## ▶ Next Up
+
+**Verify sections** — acceptance testing
+
+`/wtfp:verify-work [section]`
+
+<sub>`/clear` first → fresh context window</sub>
+
+───────────────────────────────────────────
+
+**Also available:**
+- `/wtfp:review-section [N]` — detailed section review
+- `/wtfp:polish-prose [N]` — improve prose quality
+- `/wtfp:submit-draft` — prepare for submission
+
+</offer_next>
+
+<success_criteria>
+- [ ] Roadmap and plans validated
+- [ ] Wave execution plan built from section dependencies
+- [ ] Parallel writers spawned per wave
+- [ ] All waves executed in order
+- [ ] Checkpoints handled between waves
+- [ ] Coherence-checker spawned after final wave with inline content
+- [ ] Coherence result handled (COHERENT or GAPS FOUND)
+- [ ] STATE.md and ROADMAP.md updated
+- [ ] User knows next steps
+</success_criteria>

package/vendors/opencode/commands/wtfp/export-latex.md

@@ -0,0 +1,210 @@
+---
+name: wtfp:export-latex
+description: Export paper to LaTeX with bibliography and formatting
+---
+
+<objective>
+Export the paper to LaTeX format.
+
+Generates:
+- paper.tex from markdown sections
+- references.bib from literature index
+- Applies journal/conference template
+
+Outputs to paper/ directory.
+</objective>
+
+<process>
+
+<step name="verify">
+**Verify content exists:**
+
+```bash
+[ ! -d paper ] && echo "ERROR: No paper/ directory found. Write sections first." && exit 1
+ls paper/*.md 2>/dev/null || echo "WARNING: No markdown content in paper/"
+```
+
+</step>
+
+<step name="template">
+**Select template:**
+
+Use the question tool:
+- header: "LaTeX Template"
+- question: "Which LaTeX template should we use?"
+- options:
+  - "Article (generic)" — Standard article class
+  - "IEEE" — IEEE conference/journal format
+  - "ACM" — ACM conference format
+  - "Custom" — I have a specific template
+  - "None" — Plain LaTeX, no special template
+
+If "Custom":
+- Ask for template path or template name
+</step>
+
+<step name="gather">
+**Gather content:**
+
+- Read all section files from paper/
+- Read PROJECT.md for title, authors (if specified)
+- Read sources/literature.md for bibliography
+- Identify figures referenced
+</step>
+
+<step name="convert">
+**Convert to LaTeX:**
+
+Create paper/paper.tex:
+
+```latex
+% Generated by WTF-P
+% [timestamp]
+
+\documentclass[template-options]{article-or-template}
+
+% Packages
+\usepackage[utf8]{inputenc}
+\usepackage{amsmath}
+\usepackage{graphicx}
+\usepackage{hyperref}
+\usepackage{cite}
+
+\title{[Title from PROJECT.md]}
+\author{[Author if specified]}
+\date{[Date]}
+
+\begin{document}
+
+\maketitle
+
+% Abstract
+\begin{abstract}
+[Abstract content]
+\end{abstract}
+
+% Sections
+\section{Introduction}
+[Introduction content converted to LaTeX]
+
+\section{Methods}
+[Methods content]
+
+% ... remaining sections ...
+
+% References
+\bibliographystyle{[style]}
+\bibliography{references}
+
+\end{document}
+```
+
+Conversion rules:
+- `## Heading` → `\section{Heading}`
+- `### Subheading` → `\subsection{Subheading}`
+- `**bold**` → `\textbf{bold}`
+- `*italic*` → `\textit{italic}`
+- `[citation]` → `\cite{citation}`
+- `![figure](path)` → `\includegraphics{path}` with figure environment
+- Math: `$inline$` → `$inline$`, `$$display$$` → equation environment
+
+</step>
+
+<step name="bibliography">
+**Generate bibliography:**
+
+Create paper/references.bib from sources/literature.md:
+
+```bibtex
+@article{key1,
+  author = {Author Name},
+  title = {Paper Title},
+  journal = {Journal Name},
+  year = {2024},
+  volume = {1},
+  pages = {1-10}
+}
+
+% ... additional entries ...
+```
+
+</step>
+
+<step name="compile_check">
+**Optional: Test compilation:**
+
+Use the question tool:
+- header: "Compile"
+- question: "Try to compile the LaTeX?"
+- options:
+  - "Yes, compile" — Run pdflatex
+  - "No, just export" — Skip compilation
+
+If yes:
+```bash
+cd paper && pdflatex paper.tex && bibtex paper && pdflatex paper.tex && pdflatex paper.tex
+```
+
+Report any errors.
+
+</step>
+
+<step name="commit">
+```bash
+git add paper/paper.tex paper/references.bib
+git commit -m "$(cat <<'EOF'
+export: generate LaTeX output
+
+Template: [template]
+Sections: [N]
+References: [N]
+EOF
+)"
+```
+
+</step>
+
+<step name="done">
+**Present completion:**
+
+```
+LaTeX export complete:
+
+- Document: paper/paper.tex
+- Bibliography: paper/references.bib
+- Template: [template]
+
+## Files Generated
+- paper.tex: [N] sections, [X] words
+- references.bib: [N] entries
+[If compiled:] - paper.pdf: Generated successfully
+
+## Manual Steps
+1. Review paper/paper.tex for any conversion issues
+2. Add any custom LaTeX packages needed
+3. Compile: `cd paper && pdflatex paper.tex && bibtex paper && pdflatex paper.tex`
+
+---
+
+## ▶ Next Up
+
+**Review output** — check formatting and fix issues
+
+Or if ready:
+`/wtfp:submit-milestone "draft-1"` — archive this version
+
+---
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] All sections converted to LaTeX
+- [ ] Bibliography generated
+- [ ] Template applied correctly
+- [ ] Figures referenced properly
+- [ ] Citations converted
+- [ ] Committed to git
+</success_criteria>

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

@@ -0,0 +1,185 @@
+---
+name: wtfp:help
+description: Show all WTF-P commands and how to use them
+---
+
+<objective>
+Display the complete WTF-P command reference.
+
+Output ONLY the reference content below. Do NOT add:
+
+- Project-specific analysis
+- Git status or file context
+- Next-step suggestions
+- Any commentary beyond the reference
+</objective>
+
+<process>
+<reference>
+# WTF-P Command Reference
+
+**WTF-P** (Write The F***ing Paper) gives you structured commands for writing academic papers, proposals, and presentations. You define your research vision. WTF-P breaks it into plannable, writable, reviewable sections — then tracks everything across sessions.
+
+## Happy Path
+
+New here? Follow these five commands in order:
+
+| Step | Command | What it does |
+|------|---------|-------------|
+| 1 | `/wtfp:new-paper` | Start a new paper with guided interview and setup |
+| 2 | `/wtfp:create-outline` | Build section outline, argument map, and word budgets |
+| 3 | `/wtfp:plan-section 1` | Create detailed writing plan for a section |
+| 4 | `/wtfp:write-section` | Write a section by executing its plan |
+| 5 | `/wtfp:review-section 1` | Review section for citations, coherence, and requirements |
+
+Repeat steps 3-5 for each section. Run `/wtfp:progress` anytime to see where you are and what to do next.
+
+## All Commands
+
+### Setup
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:new-paper` | Start a new paper with guided interview and setup |
+| `/wtfp:create-outline` | Build section outline, argument map, and word budgets |
+| `/wtfp:map-project` | Index existing drafts, data, and references for a project |
+
+### Planning
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:discuss-section [N]` | Discuss your vision for a section before planning it |
+| `/wtfp:research-gap [N]` | Research literature and domain knowledge for a section |
+| `/wtfp:list-assumptions [N]` | Preview intended approach for a section before writing |
+| `/wtfp:plan-section [N]` | Create detailed writing plan for a section |
+
+### Writing
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:write-section <path>` | Write a section by executing its plan |
+| `/wtfp:execute-outline` | Write all sections in parallel, then check coherence |
+| `/wtfp:quick <task>` | Run a small writing fix without full planning overhead |
+
+### Review and Revision
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:review-section [N]` | Review section for citations, coherence, and requirements |
+| `/wtfp:verify-work [N]` | Test a written section against its plan, one check at a time |
+| `/wtfp:plan-revision [N]` | Create revision plan from review issues |
+| `/wtfp:polish-prose [N]` | Improve clarity, flow, and academic voice in written prose |
+
+### Citations
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:analyze-bib` | Analyze bibliography and map citations to sections |
+| `/wtfp:check-refs` | Audit BibTeX for missing, duplicate, or broken references |
+
+### Progress and Sessions
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:progress` | Show writing progress and suggest next step |
+| `/wtfp:pause-writing` | Save current progress so you can resume later |
+| `/wtfp:resume-writing` | Resume writing from a previous session |
+| `/wtfp:checkpoint <save/restore/list>` | Save, restore, or list paper state snapshots |
+
+### Outline Management
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:insert-section <after> <desc>` | Insert a new section between existing sections |
+| `/wtfp:remove-section [N]` | Remove an unwritten section and renumber the rest |
+
+### Export and Submission
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:export-latex` | Export paper to LaTeX with bibliography and formatting |
+| `/wtfp:audit-milestone` | Run pre-submission checks on sections, citations, and word counts |
+| `/wtfp:plan-milestone-gaps` | Create fix plans for gaps found by audit-milestone |
+| `/wtfp:submit-milestone <version>` | Archive a completed draft or submission version |
+
+### Presentations and Posters
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:create-slides` | Generate presentation slides from paper content |
+| `/wtfp:create-poster` | Generate academic poster from paper content |
+
+### Todos
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:add-todo <description>` | Capture a quick note or task without breaking your flow |
+| `/wtfp:check-todos` | Review pending todos and act on, defer, or dismiss each |
+
+### Settings and Utilities
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:settings` | View and edit project settings interactively |
+| `/wtfp:update` | Check for updates and install newer version |
+| `/wtfp:help` | Show all WTF-P commands and how to use them |
+
+### Contributing
+
+| Command | Description |
+|---------|-------------|
+| `/wtfp:report-bug` | Report a bug via GitHub issue |
+| `/wtfp:request-feature` | Request a new feature via GitHub issue |
+| `/wtfp:contribute` | Walk through contributing code to WTF-P via pull request |
+
+## Files and Structure
+
+WTF-P creates a `.planning/` directory in your project:
+
+```
+.planning/
+  PROJECT.md              Paper vision and requirements
+  ROADMAP.md              Section breakdown with status
+  STATE.md                Writing progress and session context
+  config.json             Project settings
+  structure/
+    argument-map.md       Claims mapped to evidence and sections
+    outline.md            Section structure and word budgets
+    narrative-arc.md      Story flow across sections
+  sections/
+    01-introduction/
+      01-01-PLAN.md       Writing plan for section 1
+      01-01-SUMMARY.md    Completion record
+
+paper/                    Written output
+  paper.md                Assembled paper
+  references.bib          Bibliography
+```
+
+## Common Workflows
+
+**Resuming after a break:**
+```
+/wtfp:progress
+```
+
+**Reviving a stalled project:**
+```
+/wtfp:map-project
+/wtfp:new-paper
+```
+
+**Handling reviewer comments:**
+```
+/wtfp:plan-revision 02-01
+/wtfp:write-section .planning/sections/02-methods/02-01-PLAN.md
+```
+
+## Getting Help
+
+- `/wtfp:progress` — See where you are and what to do next
+- `/wtfp:report-bug` — Report a bug
+- `/wtfp:request-feature` — Request a feature
+- GitHub: https://github.com/akougkas/wtf-p
+</reference>
+</process>