forgejo-mcp/openspec/changes/add-wiki-support
Christoph Görn aad9b361db
docs: 📝 third-pass survival check refinements for add-wiki-support
Third debate team (NEW-critiques-only + agent-ergonomics lens): 3 CONCEDE-PATCH,
1 WITHDRAWN. Prior C1-C8 surface held; new edges caught:

- N1: sliceLines is unexported — add task 2.3a to export repo.SliceLines (or lift
  to shared pkg), get_file_content unchanged, copy-paste forbidden
- N2 WITHDRAWN: feared template dispatch collision disproven — commit/issue/pr/status
  already coexist; mcp-go v0.17.0 matchesTemplate matches by literal-segment regex.
  Added optional dispatch regression test (3.5)
- N3: update_wiki_page has no commit_sha precondition (vs update_file) — acknowledge
  lost-update window, task 5.6a (optional last_commit_sha if upstream supports)
- N4: create-on-existing-title unspecified — conditional guided-error/overwrite-warning
  branch, task 5.6b

Referee finding (verified vs mcp-go server.go:614): literal-slash resource URIs are
rejected by matchesTemplate before ParseWiki, so the guided -32602 cannot fire at the
resource layer — encoding guidance + get_wiki_page fallback moved to template description.

Agent-ergonomics lens (5 gaps): naming convention note, use-returned-page_name,
honest demo reframing (no over-claim of client auto-resolution), %2F dead-end fallback,
total_lines-always-returned guidance.

openspec validate --strict passes.

Refs: #32
2026-05-31 15:59:45 +02:00
..
specs docs: 📝 third-pass survival check refinements for add-wiki-support 2026-05-31 15:59:45 +02:00
demo.md docs: 📝 third-pass survival check refinements for add-wiki-support 2026-05-31 15:59:45 +02:00
design.md docs: 📝 third-pass survival check refinements for add-wiki-support 2026-05-31 15:59:45 +02:00
proposal.md docs: 📝 apply convergence-round refinements to add-wiki-support 2026-05-31 15:49:42 +02:00
tasks.md docs: 📝 third-pass survival check refinements for add-wiki-support 2026-05-31 15:59:45 +02:00