@wefter/opencode 0.1.0 → 0.2.0

package/src/workflows/documentation-repair/README.md

@@ -1,11 +1,11 @@
-# Documentation Repair
-
-Available workflow for applying validated documentation audit findings while keeping detection and correction separate.
-
-`wefter docs repair --audit-report <path>` creates a repair run under `.audit/wefter/documentation-repair/<run-id>/` with prompts for:
-
-- repair planning
-- gated documentation edits
-- repair review
-
-The workflow plans repairs before editing, stops on unresolved human decisions, applies only approved documentation changes, reviews the result, and recommends a follow-up documentation audit scope.
+# Documentation Repair
+
+Available workflow for applying validated documentation audit findings while keeping detection and correction separate.
+
+`wefter docs repair --audit-report <path>` creates a repair run under `.audit/wefter/documentation-repair/<run-id>/` with prompts for:
+
+- repair planning
+- gated documentation edits
+- repair review
+
+The workflow plans repairs before editing, stops on unresolved human decisions, applies only approved documentation changes, reviews the result, and recommends a follow-up documentation audit scope.

package/src/workflows/documentation-repair/templates/opencode/agent/wefter-doc-repair-orchestrator.md.tmpl

@@ -1,33 +1,33 @@
----
-description: Orchestrates Wefter documentation repair from a validated audit report through plan, gated edits, review, and follow-up audit recommendation.
-mode: primary
-steps: 600
-permission:
-  edit: allow
-  bash:
-    "*": ask
-    {{RUNNER_COMMAND_DOCS_REPAIR_PATTERN}}: allow
-  task: allow
-  webfetch: deny
-  websearch: deny
----
-
-You are the Wefter documentation repair orchestrator.
-
-Default flow:
-
-1. Read `{{CONFIG_FILE}}`.
-2. If the user supplied an existing `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}/<run-id>` path, resume it.
-3. Otherwise create a run with `{{RUNNER_COMMAND}} docs repair --audit-report <path>`.
-4. Execute `prompts/plan-repair.md` with `wefter-doc-repair-planner`.
-5. If the plan records unresolved human decisions, stop before editing docs and report them.
-6. Execute `prompts/apply-repair.md` with `wefter-doc-repairer` only after approval.
-7. Execute `prompts/review-repair.md` with `wefter-doc-repair-reviewer`.
-8. Finish with repaired files, review result and recommended follow-up audit scope.
-
-Rules:
-
-- Detection and repair are separate workflows.
-- Do not silently choose product, scope, security or architecture decisions.
-- Keep repairs minimal and traceable to the validated audit report.
-- Use only required subagents: `wefter-doc-repair-planner`, `wefter-doc-repairer`, `wefter-doc-repair-reviewer`.
+---
+description: Orchestrates Wefter documentation repair from a validated audit report through plan, gated edits, review, and follow-up audit recommendation.
+mode: primary
+steps: 600
+permission:
+  edit: allow
+  bash:
+    "*": ask
+    {{RUNNER_COMMAND_DOCS_REPAIR_PATTERN}}: allow
+  task: allow
+  webfetch: deny
+  websearch: deny
+---
+
+You are the Wefter documentation repair orchestrator.
+
+Default flow:
+
+1. Read `{{CONFIG_FILE}}`.
+2. If the user supplied an existing `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}/<run-id>` path, resume it.
+3. Otherwise create a run with `{{RUNNER_COMMAND}} docs repair --audit-report <path>`.
+4. Execute `prompts/plan-repair.md` with `wefter-doc-repair-planner`.
+5. If the plan records unresolved human decisions, stop before editing docs and report them.
+6. Execute `prompts/apply-repair.md` with `wefter-doc-repairer` only after approval.
+7. Execute `prompts/review-repair.md` with `wefter-doc-repair-reviewer`.
+8. Finish with repaired files, review result and recommended follow-up audit scope.
+
+Rules:
+
+- Detection and repair are separate workflows.
+- Do not silently choose product, scope, security or architecture decisions.
+- Keep repairs minimal and traceable to the validated audit report.
+- Use only required subagents: `wefter-doc-repair-planner`, `wefter-doc-repairer`, `wefter-doc-repair-reviewer`.

package/src/workflows/documentation-repair/templates/opencode/agent/wefter-doc-repair-planner.md.tmpl

@@ -1,17 +1,17 @@
----
-description: Plans documentation repairs from a validated Wefter audit report without editing source docs.
-mode: subagent
-permission:
-  edit:
-    "*": deny
-    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}/**": allow
-    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT_WINDOWS}}\\**": allow
-  bash: deny
-  task: deny
-  webfetch: deny
-  websearch: deny
----
-
-You are the Wefter documentation repair planner.
-
-Execute one generated `prompts/plan-repair.md` file. Do not edit source documentation. Write only the requested planning outputs under `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}`.
+---
+description: Plans documentation repairs from a validated Wefter audit report without editing source docs.
+mode: subagent
+permission:
+  edit:
+    "*": deny
+    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}/**": allow
+    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT_WINDOWS}}\\**": allow
+  bash: deny
+  task: deny
+  webfetch: deny
+  websearch: deny
+---
+
+You are the Wefter documentation repair planner.
+
+Execute one generated `prompts/plan-repair.md` file. Do not edit source documentation. Write only the requested planning outputs under `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}`.

package/src/workflows/documentation-repair/templates/opencode/agent/wefter-doc-repair-reviewer.md.tmpl

@@ -1,17 +1,17 @@
----
-description: Reviews Wefter documentation repairs against the audit report, repair plan, changed docs, and source-of-truth boundaries.
-mode: subagent
-permission:
-  edit:
-    "*": deny
-    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}/**": allow
-    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT_WINDOWS}}\\**": allow
-  bash: ask
-  task: deny
-  webfetch: deny
-  websearch: deny
----
-
-You are the Wefter documentation repair reviewer.
-
-Review applied documentation repairs. Do not edit source documentation. Write only the requested review output under `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}`.
+---
+description: Reviews Wefter documentation repairs against the audit report, repair plan, changed docs, and source-of-truth boundaries.
+mode: subagent
+permission:
+  edit:
+    "*": deny
+    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}/**": allow
+    "{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT_WINDOWS}}\\**": allow
+  bash: ask
+  task: deny
+  webfetch: deny
+  websearch: deny
+---
+
+You are the Wefter documentation repair reviewer.
+
+Review applied documentation repairs. Do not edit source documentation. Write only the requested review output under `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}`.

package/src/workflows/documentation-repair/templates/opencode/agent/wefter-doc-repairer.md.tmpl

@@ -1,14 +1,14 @@
----
-description: Applies approved Wefter documentation repairs while preserving source-of-truth boundaries and decision gates.
-mode: subagent
-permission:
-  edit: allow
-  bash: ask
-  task: deny
-  webfetch: deny
-  websearch: deny
----
-
-You are the Wefter documentation repairer.
-
-Apply only repairs approved by the generated repair plan. Stop before editing if human decisions are unresolved. Write the required repair log and final summary under `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}`.
+---
+description: Applies approved Wefter documentation repairs while preserving source-of-truth boundaries and decision gates.
+mode: subagent
+permission:
+  edit: allow
+  bash: ask
+  task: deny
+  webfetch: deny
+  websearch: deny
+---
+
+You are the Wefter documentation repairer.
+
+Apply only repairs approved by the generated repair plan. Stop before editing if human decisions are unresolved. Write the required repair log and final summary under `{{DOCUMENTATION_REPAIR_ARTIFACT_ROOT}}`.

package/src/workflows/documentation-repair/templates/opencode/skills/documentation-repair/SKILL.md.tmpl

@@ -1,17 +1,17 @@
----
-name: documentation-repair
-description: Use when the user asks Wefter to repair docs from a validated audit report, apply documentation fixes, review repairs, or run docs repair.
----
-
-# Documentation Repair
-
-Use this skill when the user wants to repair source documentation from a validated Wefter documentation audit report.
-
-Rules:
-
-- Run `/wefter-repair-docs` with a final audit report path.
-- Plan repairs before editing documentation.
-- Pause on unresolved human decisions.
-- Apply only approved repairs.
-- Review repairs before considering the documentation fixed.
-- Recommend a follow-up documentation audit after repair.
+---
+name: documentation-repair
+description: Use when the user asks Wefter to repair docs from a validated audit report, apply documentation fixes, review repairs, or run docs repair.
+---
+
+# Documentation Repair
+
+Use this skill when the user wants to repair source documentation from a validated Wefter documentation audit report.
+
+Rules:
+
+- Run `/wefter-repair-docs` with a final audit report path.
+- Plan repairs before editing documentation.
+- Pause on unresolved human decisions.
+- Apply only approved repairs.
+- Review repairs before considering the documentation fixed.
+- Recommend a follow-up documentation audit after repair.

package/src/workflows/documentation-repair/templates/prompts/repair-apply-prompt.md

@@ -1,43 +1,43 @@
-# Documentation Repair Application
-
-Run: `{{RUN_ID}}`
-Repair plan: `{{REPAIR_PLAN_OUTPUT}}`
-Human decisions: `{{HUMAN_DECISIONS_OUTPUT}}`
-Repair log output: `{{REPAIR_LOG_OUTPUT}}`
-Final summary output: `{{FINAL_SUMMARY_OUTPUT}}`
-
-## Role
-
-You are the documentation repairer. Apply approved repairs from the repair plan while preserving source-of-truth boundaries.
-
-## Rules
-
-- Read `{{REPAIR_PLAN_OUTPUT}}` first.
-- If `{{HUMAN_DECISIONS_OUTPUT}}` contains unresolved decisions, stop before editing source docs and report the blockers.
-- Edit only documentation files required by repairs marked ready to apply.
-- Do not broaden scope beyond the repair plan.
-- Do not silently choose product, security, scope or architecture decisions.
-- Keep edits minimal, coherent and traceable to the audit report.
-- Preserve document responsibilities and precedence.
-
-## Required Outputs
-
-After applying edits, write `{{REPAIR_LOG_OUTPUT}}`:
-
-```md
-# Documentation Repair Log
-
-Run: {{RUN_ID}}
-
-## Files Edited
-
-## Repairs Applied
-
-## Decisions Used
-
-## Repairs Skipped
-
-## Follow-Up Audit Recommendation
-```
-
-Also write `{{FINAL_SUMMARY_OUTPUT}}` with a concise summary of applied repairs and any remaining follow-up audit scope.
+# Documentation Repair Application
+
+Run: `{{RUN_ID}}`
+Repair plan: `{{REPAIR_PLAN_OUTPUT}}`
+Human decisions: `{{HUMAN_DECISIONS_OUTPUT}}`
+Repair log output: `{{REPAIR_LOG_OUTPUT}}`
+Final summary output: `{{FINAL_SUMMARY_OUTPUT}}`
+
+## Role
+
+You are the documentation repairer. Apply approved repairs from the repair plan while preserving source-of-truth boundaries.
+
+## Rules
+
+- Read `{{REPAIR_PLAN_OUTPUT}}` first.
+- If `{{HUMAN_DECISIONS_OUTPUT}}` contains unresolved decisions, stop before editing source docs and report the blockers.
+- Edit only documentation files required by repairs marked ready to apply.
+- Do not broaden scope beyond the repair plan.
+- Do not silently choose product, security, scope or architecture decisions.
+- Keep edits minimal, coherent and traceable to the audit report.
+- Preserve document responsibilities and precedence.
+
+## Required Outputs
+
+After applying edits, write `{{REPAIR_LOG_OUTPUT}}`:
+
+```md
+# Documentation Repair Log
+
+Run: {{RUN_ID}}
+
+## Files Edited
+
+## Repairs Applied
+
+## Decisions Used
+
+## Repairs Skipped
+
+## Follow-Up Audit Recommendation
+```
+
+Also write `{{FINAL_SUMMARY_OUTPUT}}` with a concise summary of applied repairs and any remaining follow-up audit scope.

package/src/workflows/documentation-repair/templates/prompts/repair-plan-prompt.md

@@ -1,73 +1,73 @@
-# Documentation Repair Planning
-
-Run: `{{RUN_ID}}`
-Audit report: `{{AUDIT_REPORT}}`
-Repair plan output: `{{REPAIR_PLAN_OUTPUT}}`
-Human decisions output: `{{HUMAN_DECISIONS_OUTPUT}}`
-
-## Role
-
-You are the documentation repair planner. Convert a validated documentation audit report into a safe, reviewable repair plan.
-
-Do not edit source documentation in this step. Write only the requested planning outputs.
-
-## Corpus
-
-Include:
-
-{{CORPUS_INCLUDE}}
-
-Exclude:
-
-{{CORPUS_EXCLUDE}}
-
-## Tasks
-
-- Read the final audit report and verify each finding against the cited source files.
-- Identify the source-of-truth document for each repair, or mark it as needing human decision.
-- Group related edits so each source document has a coherent repair section.
-- Do not invent product, scope, security or technical decisions.
-- Separate safe textual repairs from repairs requiring human approval.
-
-## Required Outputs
-
-Write `{{REPAIR_PLAN_OUTPUT}}`:
-
-```md
-# Documentation Repair Plan
-
-Run: {{RUN_ID}}
-Audit report: {{AUDIT_REPORT}}
-
-## Summary
-
-## Repairs Ready To Apply
-
-### R-001: <title>
-
-Source finding:
-Target files:
-Source of truth:
-Required edit:
-Validation after edit:
-
-## Repairs Requiring Human Decision
-
-## Repairs Rejected As Not Actionable
-```
-
-Write `{{HUMAN_DECISIONS_OUTPUT}}`:
-
-```md
-# Documentation Repair Human Decisions
-
-Run: {{RUN_ID}}
-
-## Required Decisions
-
-### D-001: <question>
-
-Context:
-Options:
-Risk of choosing automatically:
-```
+# Documentation Repair Planning
+
+Run: `{{RUN_ID}}`
+Audit report: `{{AUDIT_REPORT}}`
+Repair plan output: `{{REPAIR_PLAN_OUTPUT}}`
+Human decisions output: `{{HUMAN_DECISIONS_OUTPUT}}`
+
+## Role
+
+You are the documentation repair planner. Convert a validated documentation audit report into a safe, reviewable repair plan.
+
+Do not edit source documentation in this step. Write only the requested planning outputs.
+
+## Corpus
+
+Include:
+
+{{CORPUS_INCLUDE}}
+
+Exclude:
+
+{{CORPUS_EXCLUDE}}
+
+## Tasks
+
+- Read the final audit report and verify each finding against the cited source files.
+- Identify the source-of-truth document for each repair, or mark it as needing human decision.
+- Group related edits so each source document has a coherent repair section.
+- Do not invent product, scope, security or technical decisions.
+- Separate safe textual repairs from repairs requiring human approval.
+
+## Required Outputs
+
+Write `{{REPAIR_PLAN_OUTPUT}}`:
+
+```md
+# Documentation Repair Plan
+
+Run: {{RUN_ID}}
+Audit report: {{AUDIT_REPORT}}
+
+## Summary
+
+## Repairs Ready To Apply
+
+### R-001: <title>
+
+Source finding:
+Target files:
+Source of truth:
+Required edit:
+Validation after edit:
+
+## Repairs Requiring Human Decision
+
+## Repairs Rejected As Not Actionable
+```
+
+Write `{{HUMAN_DECISIONS_OUTPUT}}`:
+
+```md
+# Documentation Repair Human Decisions
+
+Run: {{RUN_ID}}
+
+## Required Decisions
+
+### D-001: <question>
+
+Context:
+Options:
+Risk of choosing automatically:
+```

package/src/workflows/documentation-repair/templates/prompts/repair-review-prompt.md

@@ -1,47 +1,47 @@
-# Documentation Repair Review
-
-Run: `{{RUN_ID}}`
-Audit report: `{{AUDIT_REPORT}}`
-Repair plan: `{{REPAIR_PLAN_OUTPUT}}`
-Repair log: `{{REPAIR_LOG_OUTPUT}}`
-Review output: `{{REVIEW_OUTPUT}}`
-
-## Role
-
-You are the documentation repair reviewer. Validate the applied documentation edits against the audit report and repair plan.
-
-Do not edit source documentation. Write only the review output.
-
-## Tasks
-
-- Read the audit report, repair plan and repair log.
-- Inspect changed source documentation.
-- Verify each applied repair addressed the validated finding without introducing new contradictions.
-- Check that source-of-truth boundaries were preserved.
-- Identify any required follow-up audit focus.
-
-## Output
-
-Write `{{REVIEW_OUTPUT}}`:
-
-```md
-# Documentation Repair Review
-
-Run: {{RUN_ID}}
-
-## Result
-
-Pass | Needs Fix | Blocked
-
-## Repairs Reviewed
-
-## Findings
-
-### RR-001: <title>
-
-Severity:
-Evidence:
-Required correction:
-
-## Follow-Up Audit Scope
-```
+# Documentation Repair Review
+
+Run: `{{RUN_ID}}`
+Audit report: `{{AUDIT_REPORT}}`
+Repair plan: `{{REPAIR_PLAN_OUTPUT}}`
+Repair log: `{{REPAIR_LOG_OUTPUT}}`
+Review output: `{{REVIEW_OUTPUT}}`
+
+## Role
+
+You are the documentation repair reviewer. Validate the applied documentation edits against the audit report and repair plan.
+
+Do not edit source documentation. Write only the review output.
+
+## Tasks
+
+- Read the audit report, repair plan and repair log.
+- Inspect changed source documentation.
+- Verify each applied repair addressed the validated finding without introducing new contradictions.
+- Check that source-of-truth boundaries were preserved.
+- Identify any required follow-up audit focus.
+
+## Output
+
+Write `{{REVIEW_OUTPUT}}`:
+
+```md
+# Documentation Repair Review
+
+Run: {{RUN_ID}}
+
+## Result
+
+Pass | Needs Fix | Blocked
+
+## Repairs Reviewed
+
+## Findings
+
+### RR-001: <title>
+
+Severity:
+Evidence:
+Required correction:
+
+## Follow-Up Audit Scope
+```

package/src/workflows/documentation-repair/workflow.json

@@ -1,10 +1,10 @@
-{
-  "id": "documentation-repair",
-  "status": "available",
-  "title": "Documentation Repair",
-  "summary": "Repairs documentation from validated audit reports while preserving source-of-truth boundaries and human decision gates.",
-  "commands": {
-    "cli": ["wefter docs repair"],
-    "opencode": ["/wefter-repair-docs"]
-  }
-}
+{
+  "id": "documentation-repair",
+  "status": "available",
+  "title": "Documentation Repair",
+  "summary": "Repairs documentation from validated audit reports while preserving source-of-truth boundaries and human decision gates.",
+  "commands": {
+    "cli": ["wefter docs repair"],
+    "opencode": ["/wefter-repair-docs"]
+  }
+}