wtf-p 0.3.0 → 0.5.0

package/vendors/opencode/commands/wtfp/audit-milestone.md

@@ -0,0 +1,279 @@
+---
+name: wtfp:audit-milestone
+description: Run pre-submission checks on sections, citations, and word counts
+---
+
+<objective>
+Check paper readiness before submission.
+
+Runs 5 audit checks:
+1. Section completion status
+2. Argument coverage (all claims addressed)
+3. Word targets (within tolerance)
+4. Citation completeness (all resolved)
+5. Review status (all sections reviewed)
+
+Produces MILESTONE-AUDIT.md with pass/gap for each criterion.
+</objective>
+
+<process>
+
+<step name="validate">
+**Step 1: Validate Environment**
+
+```bash
+[ ! -f .planning/PROJECT.md ] && echo "ERROR: No PROJECT.md found" && exit 1
+[ ! -f .planning/ROADMAP.md ] && echo "ERROR: No ROADMAP.md found" && exit 1
+[ ! -f .planning/STATE.md ] && echo "ERROR: No STATE.md found" && exit 1
+```
+
+</step>
+
+<step name="banner">
+**Step 2: Display Banner**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► AUDITING MILESTONE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Running 5 pre-submission checks...
+```
+
+</step>
+
+<step name="check_sections">
+**Check 1: Section Completion**
+
+Read ROADMAP.md. For each section entry:
+- Is it marked `[x]` complete?
+- Extract section name and completion status
+
+Count:
+- `TOTAL_SECTIONS`: Number of section entries
+- `COMPLETE_SECTIONS`: Number with `[x]`
+- `INCOMPLETE_SECTIONS`: Number with `[ ]`
+
+**Result:**
+- PASS if `COMPLETE_SECTIONS == TOTAL_SECTIONS`
+- GAP if any sections incomplete
+
+Store result:
+```
+CHECK_1_STATUS="{PASS|GAP}"
+CHECK_1_DETAIL="{M}/{N} complete"
+CHECK_1_GAPS="{list of incomplete section names, if any}"
+```
+
+</step>
+
+<step name="check_arguments">
+**Check 2: Argument Coverage**
+
+Read `.planning/structure/argument-map.md` if it exists.
+
+Extract all claims (lines starting with `- **Claim**:` or numbered claims).
+
+For each claim:
+- Search paper content files (`paper/` directory or equivalent)
+- Check if evidence of the claim being addressed exists
+
+**Result:**
+- PASS if all claims addressed
+- GAP listing unaddressed claims
+
+Store result:
+```
+CHECK_2_STATUS="{PASS|GAP}"
+CHECK_2_DETAIL="{M}/{N} claims addressed"
+CHECK_2_GAPS="{list of unaddressed claims, if any}"
+```
+
+If argument-map.md doesn't exist:
+```
+CHECK_2_STATUS="SKIP"
+CHECK_2_DETAIL="No argument-map.md found"
+```
+
+</step>
+
+<step name="check_words">
+**Check 3: Word Targets**
+
+Read `.planning/structure/outline.md` for word budget per section.
+
+For each section:
+- Count actual words in the paper content file
+- Compare to target from outline
+
+**Tolerance:** +/- 15% of target per section
+
+**Result:**
+- PASS if all sections within range
+- GAP listing sections outside range (with actual vs target)
+
+Store result:
+```
+CHECK_3_STATUS="{PASS|GAP}"
+CHECK_3_DETAIL="{N}/{M} sections within range"
+CHECK_3_GAPS="{list of sections outside range: 'Section X: Y words (target: Z, variance: +/-W%)'}"
+```
+
+If outline.md doesn't exist or has no word targets:
+```
+CHECK_3_STATUS="SKIP"
+CHECK_3_DETAIL="No word targets defined in outline.md"
+```
+
+</step>
+
+<step name="check_citations">
+**Check 4: Citation Completeness**
+
+Scan all paper content files for citation patterns:
+- `(Author, Year)` - APA style
+- `\cite{key}` - LaTeX style
+- `[@key]` - Pandoc/markdown style
+- `[N]` - IEEE style
+
+Cross-reference with bibliography file:
+- `references.bib` (BibTeX)
+- `.planning/sources/bibliography.md`
+- Any `.bib` files in project
+
+Check for:
+1. **Uncited references**: Entries in bibliography not cited in text
+2. **Undefined citations**: Citations in text not in bibliography
+
+**Result:**
+- PASS if all citations resolved
+- GAP listing issues
+
+Store result:
+```
+CHECK_4_STATUS="{PASS|GAP}"
+CHECK_4_DETAIL="{N} issues found"
+CHECK_4_GAPS="{list: 'Uncited: [keys]', 'Undefined: [keys]'}"
+```
+
+If no bibliography file found:
+```
+CHECK_4_STATUS="SKIP"
+CHECK_4_DETAIL="No bibliography file found"
+```
+
+</step>
+
+<step name="check_reviews">
+**Check 5: Review Status**
+
+For each section:
+- Check if review SUMMARY.md exists in `.planning/sections/{section}/`
+- Or check if "review: pass" noted in section summary
+
+**Result:**
+- PASS if all sections reviewed
+- GAP listing unreviewed sections
+
+Store result:
+```
+CHECK_5_STATUS="{PASS|GAP}"
+CHECK_5_DETAIL="{M}/{N} sections reviewed"
+CHECK_5_GAPS="{list of unreviewed sections}"
+```
+
+</step>
+
+<step name="write_audit">
+**Step 3: Write MILESTONE-AUDIT.md**
+
+Determine overall status:
+- `OVERALL="PASS"` if all checks pass or skip
+- `OVERALL="GAPS FOUND"` if any check has GAP status
+
+Write `.planning/MILESTONE-AUDIT.md`:
+
+```markdown
+# Milestone Audit
+
+**Date:** {YYYY-MM-DD}
+**Overall:** {PASS | GAPS FOUND}
+
+## Results
+
+| Check | Status | Details |
+|-------|--------|---------|
+| Section Completion | {PASS/GAP/SKIP} | {CHECK_1_DETAIL} |
+| Argument Coverage | {PASS/GAP/SKIP} | {CHECK_2_DETAIL} |
+| Word Targets | {PASS/GAP/SKIP} | {CHECK_3_DETAIL} |
+| Citation Completeness | {PASS/GAP/SKIP} | {CHECK_4_DETAIL} |
+| Review Status | {PASS/GAP/SKIP} | {CHECK_5_DETAIL} |
+
+## Gaps
+
+{For each GAP status, create a subsection:}
+
+### {Check Name}
+- **Status:** gap
+- **Finding:** {what's missing}
+- **Affected:** {sections/claims/files}
+- **Recommendation:** {what to do}
+
+{If no gaps:}
+No gaps found. Paper is ready for submission.
+
+## Summary
+
+{If PASS: "Paper is ready for submission. Run `/wtfp:submit-milestone {version}` to archive."}
+{If GAPS: "Found {N} gaps requiring attention. Run `/wtfp:plan-milestone-gaps` to create fix plans."}
+```
+
+</step>
+
+<step name="present_results">
+**Step 4: Present Results**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► AUDIT COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Overall: {PASS | GAPS FOUND}
+
+Results:
+  ✓ Section Completion: {details}
+  ✓ Argument Coverage: {details}
+  ✓ Word Targets: {details}
+  ✓ Citation Completeness: {details}
+  ✓ Review Status: {details}
+
+{Use ✓ for PASS, ✗ for GAP, — for SKIP}
+
+Audit saved to: .planning/MILESTONE-AUDIT.md
+
+───────────────────────────────────────────
+
+## Next Up
+
+{If PASS:}
+**Ready to submit:**
+  `/wtfp:submit-milestone {version}`
+
+{If GAPS:}
+**Fix gaps first:**
+  `/wtfp:plan-milestone-gaps` - Create fix plans from audit
+
+───────────────────────────────────────────
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Environment validated
+- [ ] 5 audit checks run (section, argument, word, citation, review)
+- [ ] MILESTONE-AUDIT.md created with pass/gap per check
+- [ ] Gaps include actionable recommendations
+- [ ] Next steps offered based on result
+</success_criteria>

package/vendors/opencode/commands/wtfp/check-refs.md

@@ -0,0 +1,124 @@
+---
+name: wtfp:check-refs
+description: Audit BibTeX for missing, duplicate, or broken references
+---
+
+<objective>
+Audit citations for completeness and consistency.
+
+**Orchestrator role:** Locate bib and draft files, run deterministic indexer, resolve model profile, spawn citation-formatter agent for cross-referencing, present results, apply fixes.
+
+Ensures all in-text citations have BibTeX entries, all entries are cited, and references are properly formatted.
+</objective>
+
+<context>
+BibTeX file: $ARGUMENTS (optional — auto-detects .bib files)
+
+**Load project state:**
+@.planning/STATE.md
+</context>
+
+<process>
+
+## 1. Validate Environment and Resolve Model Profile
+
+```bash
+find . -name "*.bib" -type f 2>/dev/null | head -20
+grep -rl "\\\\cite\|\\[@\|\\[.*\\]" --include="*.tex" --include="*.md" . 2>/dev/null
+```
+
+```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 |
+|-------|---------|----------|--------|
+| citation-formatter | sonnet | sonnet | haiku |
+
+## 2. Run Deterministic Indexer
+
+```bash
+node ~/.opencode/bin/bib-index.js index "$BIB_FILE"
+```
+
+## 3. Spawn citation-formatter Agent
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► AUDITING CITATIONS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+```
+Task(
+  prompt="First, read ~/.opencode/agents/wtfp/citation-formatter.md for your role.\n\n" + audit_prompt,
+  subagent_type="general-purpose",
+  model="{formatter_model}",
+  description="Audit citations"
+)
+```
+
+Audit prompt includes: `<bib_index>` with parsed entries, `<draft_files>` with paths to files containing citations, `<state>` with STATE.md.
+
+Agent performs: extract in-text citations, cross-reference vs BibTeX keys, check required fields by entry type, identify duplicates, flag suspicious years.
+
+## 4. Handle Formatter Return
+
+Present findings:
+- Missing BibTeX entries (cited but not in .bib)
+- Unused references (in .bib but never cited)
+- Incomplete entries (missing required fields)
+- Valid citation count
+
+**`## AUDIT BLOCKED`:** Present blocker (no .bib found, no .tex/.md to scan), ask user to provide file paths.
+
+## 5. Offer Fixes
+
+Ask via the question tool:
+- header: "Fixes"
+- question: "How should I handle unused references?"
+- options: "Remove unused" | "Keep all" | "Comment out"
+
+For missing entries, search using `node ~/.opencode/bin/citation-fetcher.js "title"`.
+
+## 6. Apply Fixes and Commit
+
+```bash
+cp references.bib references.bib.backup
+# Apply approved edits
+git add *.bib
+git commit -m "refs: audit and clean bibliography"
+```
+
+</process>
+
+<offer_next>
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► CITATION AUDIT COMPLETE ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+- Citations in text: [N]
+- BibTeX entries: [N]
+- Issues fixed: [N]
+- Issues flagged: [N]
+
+───────────────────────────────────────────
+
+## Next Up
+
+- `/wtfp:polish-prose` — Refine writing
+- `/wtfp:export-latex` — Generate LaTeX
+- `/wtfp:review-section` — Get reviewer feedback
+
+───────────────────────────────────────────
+
+</offer_next>
+
+<success_criteria>
+- [ ] All in-text citations cross-referenced
+- [ ] Missing entries identified and searched
+- [ ] Incomplete entries flagged
+- [ ] Unused references handled per user choice
+- [ ] Changes committed to git
+</success_criteria>

package/vendors/opencode/commands/wtfp/check-todos.md

@@ -0,0 +1,146 @@
+---
+name: wtfp:check-todos
+description: Review pending todos and act on, defer, or dismiss each
+---
+
+<objective>
+Review pending todos. For each, user decides: act on it, defer it, dismiss it, or mark done.
+</objective>
+
+<context>
+No arguments. Reads from .planning/todos/pending/.
+</context>
+
+<process>
+
+## 1. Validate Environment
+
+```bash
+ls .planning/ 2>/dev/null
+```
+
+If `.planning/` does not exist, output error and exit:
+```
+Error: No project found. Run /wtfp:new-paper first.
+```
+
+## 2. List Pending Todos
+
+```bash
+ls -1 .planning/todos/pending/*.md 2>/dev/null
+```
+
+If no files found:
+```
+No pending todos.
+```
+Exit.
+
+## 3. Display Banner
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► PENDING TODOS ({N})
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 4. Process Each Todo
+
+Initialize counters:
+- acted = 0
+- deferred = 0
+- dismissed = 0
+- done = 0
+
+For each file in `.planning/todos/pending/`:
+
+1. Read the file. Parse frontmatter (created, context) and body (description).
+
+2. Present via the question tool:
+   - header: "Todo #{N}"
+   - question: "{todo description}\n\nCreated: {date} | Context: {context}"
+   - options:
+     - "Act on it now"
+     - "Defer"
+     - "Dismiss"
+     - "Done"
+     - "Skip rest"
+
+3. Handle response:
+
+   **"Act on it now":**
+   - Display the full todo content
+   - Output: "What would you like to do with this? (describe action or command)"
+   - Let user take action manually
+   - Increment acted counter
+   - Keep file in pending (user will mark done when complete)
+
+   **"Defer":**
+   - Keep file in pending
+   - Increment deferred counter
+   - Continue to next
+
+   **"Dismiss":**
+   ```bash
+   mkdir -p .planning/todos/dismissed
+   mv {file} .planning/todos/dismissed/
+   ```
+   - Increment dismissed counter
+   - Continue to next
+
+   **"Done":**
+   ```bash
+   mkdir -p .planning/todos/done
+   mv {file} .planning/todos/done/
+   ```
+   - Increment done counter
+   - Continue to next
+
+   **"Skip rest":**
+   - Break out of loop
+   - All remaining todos stay deferred
+
+## 5. Update STATE.md
+
+Count remaining pending todos:
+```bash
+ls -1 .planning/todos/pending/*.md 2>/dev/null | wc -l
+```
+
+Read STATE.md. Update "### Pending Todos" section with new count:
+```
+### Pending Todos
+
+{N} pending todo(s).
+```
+
+Or if N = 0:
+```
+### Pending Todos
+
+None.
+```
+
+## 6. Summary
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► TODOS REVIEWED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Acted on: {N}
+Deferred: {N}
+Dismissed: {N}
+Done: {N}
+Still pending: {N}
+```
+
+</process>
+
+<success_criteria>
+- [ ] Pending todos listed with count
+- [ ] Each todo presented with act/defer/dismiss/done/skip options
+- [ ] Files moved to dismissed/ or done/ subdirectories as appropriate
+- [ ] STATE.md pending count updated after review
+- [ ] Summary shows actions taken
+</success_criteria>

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

@@ -0,0 +1,97 @@
+---
+name: wtfp:checkpoint
+description: Save, restore, or list paper state snapshots
+---
+
+<objective>
+Save full paper state as a git-tagged checkpoint or restore from a previous one.
+
+**Orchestrator role:** Parse subcommand, execute checkpoint operation via bin/lib/checkpoint.js, report result.
+
+Enables session continuity — save state before `/clear`, restore in next session.
+</objective>
+
+<context>
+Subcommand: $ARGUMENTS
+- `save [label]` — Create checkpoint with label (e.g., "pre-discussion", "draft-1")
+- `restore [tag]` — Restore from a checkpoint tag
+- `list` — Show available checkpoints
+
+**Load project state:**
+@.planning/STATE.md
+</context>
+
+<process>
+
+## 1. Parse Subcommand
+
+Extract subcommand and arguments from $ARGUMENTS.
+
+Default: `save` if no subcommand provided, with auto-generated label from STATE.md position.
+
+## 2. Execute Operation
+
+### Save
+
+```bash
+node -e "
+const cp = require('$HOME/.opencode/bin/lib/checkpoint.js');
+const result = cp.createCheckpoint({
+  planningDir: '.planning',
+  label: '[label]',
+  note: '[current position from STATE.md]'
+});
+console.log(JSON.stringify(result));
+"
+```
+
+### Restore
+
+If no tag provided, list checkpoints and ask via the question tool:
+- header: "Checkpoint"
+- question: "Which checkpoint to restore?"
+- options: [list of available checkpoints]
+
+```bash
+node -e "
+const cp = require('$HOME/.opencode/bin/lib/checkpoint.js');
+cp.restoreCheckpoint('[tag]');
+"
+```
+
+### List
+
+```bash
+node -e "
+const cp = require('$HOME/.opencode/bin/lib/checkpoint.js');
+const list = cp.listCheckpoints();
+list.forEach(c => console.log(c.tag + ' — ' + c.message));
+"
+```
+
+## 3. Present Result
+
+</process>
+
+<offer_next>
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ WTF-P ► CHECKPOINT [SAVED|RESTORED] ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Tag: [tag]
+Files: [N]
+
+───────────────────────────────────────────
+
+Resume with `/wtfp:progress` after restoring.
+
+───────────────────────────────────────────
+
+</offer_next>
+
+<success_criteria>
+- [ ] Checkpoint created/restored/listed successfully
+- [ ] Git tag created (for save)
+- [ ] State verified after restore
+</success_criteria>