wtf-p 0.7.3 → 0.8.0

package/vendors/plugin/.wtfp-generated.json

@@ -2,7 +2,7 @@
   "schema": "wtfp.generated-adapter/v1",
   "generatorVersion": 5,
   "target": "portable-plugin",
-  "sourceHash": "4410b402746b85cdca9896c0fb801237d578308f35d520848398ce33868badec",
+  "sourceHash": "b9f5585d873d30c0359174a7085216a46fba6e8299cfd95bfd4da42a587ac5e2",
   "files": [
     {
       "path": "actions/add-todo.json",
@@ -118,7 +118,7 @@
     },
     {
       "path": "actions/research-gap.json",
-      "sha256": "80659531e18fb60dd46620c8b35aa27ce0f966c467f0d3073ae8c6519084153e"
+      "sha256": "0c26fa663f1d2526cbefcc9750b0a176ddf1ca538a46585a1de48c763fbb1a13"
     },
     {
       "path": "actions/resume-writing.json",
@@ -178,7 +178,7 @@
     },
     {
       "path": "ai.iowarp.clio/agents/wtfp-research-synthesizer.md",
-      "sha256": "18cfbac40fe49413797ed8bd12779df158eacb0155620dd34c966e061f2d5182"
+      "sha256": "593ddb282208d889997efd80b3f52168562c8002abd2aabed30992a237caa6cb"
     },
     {
       "path": "ai.iowarp.clio/agents/wtfp-section-planner.md",
@@ -193,36 +193,36 @@
       "sha256": "244c1113f62261628265bb2c2c210e0837865a44077a1362db8e9f77b01dea4b"
     },
     {
-      "path": "ai.iowarp.clio/fleets/wtfp-draft-review.md",
+      "path": "ai.iowarp.clio/playbooks/wtfp-draft-review.md",
       "sha256": "5b1d3f9bb4d39ccaa60837decfdbf58e6fd5fd9fb8267fb01d09784c33467426"
     },
     {
-      "path": "ai.iowarp.clio/fleets/wtfp-plan-section.md",
+      "path": "ai.iowarp.clio/playbooks/wtfp-plan-section.md",
       "sha256": "d4dd9c14e4e07098083141e44f8ed4ce0907ae39ba715d149cf82f5192ae38b9"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/add-todo.md",
-      "sha256": "688825904ac171934d50fd63fa4aa4046d324b723e773585030fe3329d9dfce8"
+      "sha256": "349eb5cb4f713bbb6d66432c343c251ab1ea148d9527423901111be2390f02dc"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/analyze-bib.md",
-      "sha256": "583ba553597346b4680dda0713b68e1c0a93c4be1418b944393a397e800ce41c"
+      "sha256": "25a72c626036921d77294b469831c85e2ae0fecd803b9973ecf563d0cef47f23"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/audit-milestone.md",
-      "sha256": "bb6a5f760154d4d4c18953ad54385d5ee82877da4bfd6ae8b2f6b54cc7503750"
+      "sha256": "4d82c1589232d20eb5733c7ae4968faa9846b0e3285ba9e3619517ef17622ffd"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/check-refs.md",
-      "sha256": "3385439db58741aab645eb1ca02274b60b704e4023158a72af17a77d2eb7f2da"
+      "sha256": "ba98ac168789b38c9aaf1edb81a16ed7ab6a1ed1781e26a2de01f6d895d3ca84"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/check-todos.md",
-      "sha256": "289d348cbf4908a87fc916e08132e16df647ab69a403b8db90b3d1954e6d9d22"
+      "sha256": "c331002c414fb32ca3333e4ea255a2cde10ac03defec4bb39cf42e2b720878d6"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/checkpoint.md",
-      "sha256": "37a9a120c1f4f83e4f183b881209f4da368d2f761f6c0e27919bff3cdc107f74"
+      "sha256": "50b4ca0cd8376d359b09a484e780580473f6de8289867cfba4341431527dc4d9"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/contribute.md",
@@ -230,7 +230,7 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/create-outline.md",
-      "sha256": "111c7370be43755f4cb16feb93913d5a7396cedd63714672c7fedc6d6f88bbcd"
+      "sha256": "2fa1bb7b28ab71808f0cd4dfd1e07f22e41af88d0af310b5089c463f9257dfe5"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/create-poster.md",
@@ -242,11 +242,11 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/discuss-section.md",
-      "sha256": "792cb3e9cc66436796caad842dd2adca71c77b5433e70c25308dcb241fe11d26"
+      "sha256": "c7a5d6810ed5dbd372c9c23f59a77313e4fdd4104ee7bf17557c0c237e79f404"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/execute-outline.md",
-      "sha256": "b0f6ed52a8565f926d629de6d62d0023978ef8d4ee5c2a501b0f82f8a3e94c8a"
+      "sha256": "3aecaf6747e9156964e44bd56a6f1ccf200b815eaac8e0d43b162dae41738afa"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/export-latex.md",
@@ -254,11 +254,11 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/help.md",
-      "sha256": "ac77d149d4e1a6c7932d82ca2a77d4aa62e4bdbd1a9b797cae8ac984f6493c3d"
+      "sha256": "e454bfc4d2b7d0018ce8c539a7abccd80312b8f96b214f3db32d5b91c6eb0d11"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/insert-section.md",
-      "sha256": "742f3859422dfbd8b12b9bdac81da4ecb67b579305e81c359d01cef3606729e8"
+      "sha256": "ef7ef5011c671608dbf798ba3cf11d5c2c4534a46a4b33aaf1074ef4fc86272f"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/list-assumptions.md",
@@ -266,19 +266,19 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/map-project.md",
-      "sha256": "15fef66c4926732197f1f9127624143d5ceb7a4c4cf06ee26c6fd8e4b82b274e"
+      "sha256": "54aab8b851f2acb4f2609fd7b97128395d37230231facbf6266f0996f077dc93"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/new-paper.md",
-      "sha256": "84aa310823146fe231ed4315ce241492b09dd34c3eafedbae662306d6936791e"
+      "sha256": "5eb22e4dc53d70f9590c1012907ad573d710e60de77a1ad739318e343c195669"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/pause-writing.md",
-      "sha256": "3848e1d8336d73500ed6a6d729cdd4284ad6ad0495f8f33ca35fbd405acd1359"
+      "sha256": "d2cde8adb0d478245676086cd41724076842004738f76da607330faff1077c5f"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/plan-milestone-gaps.md",
-      "sha256": "6df911ddd2702a72f6159647760bceb37b5a4acd7493cc75dfb84d62d460e4c6"
+      "sha256": "8ade09b99a64a09813f14e970a69b62a18e20e7d1a53f0a28939ac66a20e67d0"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/plan-revision.md",
@@ -286,11 +286,11 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/plan-section.md",
-      "sha256": "64675acb9837869f406a2124af1964e40098b852fd5fc468339e7c7dba4ccb5f"
+      "sha256": "3e9a5265f2f022b94349666f60d02f509cd799b3ea8e683470aaf0af31abbf3f"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/polish-prose.md",
-      "sha256": "7abb5c3775ebbba4c4f05ba30126b5d13f8bf0ab30ea93421b221e98eaff4c17"
+      "sha256": "fd8f6038531de73aae5e83ae4b569cdbfce0f49ca05f758387a6b03d09b3c774"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/progress.md",
@@ -298,7 +298,7 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/quick.md",
-      "sha256": "217cf43832efd72085f06a77e7ba1ba625d0bd190e867e93e0258e3dd03ddccf"
+      "sha256": "fb5103617e061355a3adc07f6a9a0f22afe84f5d0fa4e4fdbaf829b7cef4a875"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/remove-section.md",
@@ -314,23 +314,23 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/research-gap.md",
-      "sha256": "4a82aa543eb353d5da41a9db5b5da560f38fa00a030558551d04ba81eab60cb5"
+      "sha256": "ec807f47ea82f1f9791ead678eea7496f045be65bf4ec0efc466fed14b59ced3"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/resume-writing.md",
-      "sha256": "836b59b3a45bddfae59fd2136b8801bc1d2a2b8369e9726d31846dd7703b45f7"
+      "sha256": "810580ce5f58d6cda5de809501da92b9e8bb78c3921bc34992142ada6ab8c592"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/review-section.md",
-      "sha256": "1279a53ee6565d237ff3792b2da39140c199a816d939aca8acffb2d32ffb3a3c"
+      "sha256": "0fc8976f0c48784e50f7e94c4f4e9dc94e8b31930d245996c38a893d7951b189"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/settings.md",
-      "sha256": "60f5308b10cc6de61e7d6f6b0c2a82b2effd9201abeaee1b351f2b0f6284a516"
+      "sha256": "ae5c6d7c0042bbd6330ae578d4ad9ec113001e8e86044b2ce03f546ea5f37b50"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/submit-milestone.md",
-      "sha256": "8146dcb0c64a742977d27ab89d7998409116d420864dba627f6c50e7ae88deb4"
+      "sha256": "6128c27b9d24ac460e46a981d12893975826700f4b6b59a7c24e4164e1f26835"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/update.md",
@@ -338,11 +338,11 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/verify-work.md",
-      "sha256": "a868da2cf99de227ab5e56f145174669f937c3df86dd5a921331b9c54ad5d1c4"
+      "sha256": "918f4ca32835d39ad5573eee751ea73d18eeded1f0afee54c9f7b964bed6706e"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/write-section.md",
-      "sha256": "85aafb0a798559a37bf87e0fe1b26da4ef8bb365ba8bb82029c8380043b3fbb1"
+      "sha256": "02db3b9c4fa9d6658ce8f7dfb9759576004e14120b3d74be0ec97ac9ba14ed23"
     },
     {
       "path": "aliases.lock.json",
@@ -354,7 +354,7 @@
     },
     {
       "path": "compatibility/action-availability.json",
-      "sha256": "b410e8921f8dd0657b71025c5aaf6b09999ec80b401cee9b47acdbc3d8844bce"
+      "sha256": "7ba4766f06e913ac1967899836ce1ae322b11c1477837c88803f82aa4c95a085"
     },
     {
       "path": "effects.json",
@@ -362,7 +362,7 @@
     },
     {
       "path": "plugin.json",
-      "sha256": "26d19ac3b6c3071527cfff692e71dd991f377a84b5b0dc45384d2b4aaaff908c"
+      "sha256": "4ba24c372ede7e4708e54fb9baf803f4d79fe0ea2b227596fbff7601ac947a67"
     },
     {
       "path": "project/README.md",
@@ -486,7 +486,7 @@
     },
     {
       "path": "roles/research-synthesizer.md",
-      "sha256": "011feaa1fdb967c267713f4fa4b0c45b27e66a62f71d1f24c4f44360442aef57"
+      "sha256": "7aa6922f5f819918374b1a87dbda5c12fa6d424be64fc13b4019c380e011306c"
     },
     {
       "path": "roles/section-planner.md",
@@ -554,7 +554,7 @@
     },
     {
       "path": "skills/wtfp-plan-section/references/actions.md",
-      "sha256": "12f406519d516f91d42386fb19022cdd9a53d48f59b63b55bea2047ceb222792"
+      "sha256": "80d71be47df4f02a62f35d586ce795d3b47f03c92b25c9ea2a2aa698a4023dfa"
     },
     {
       "path": "skills/wtfp-plan-section/SKILL.md",
@@ -566,7 +566,7 @@
     },
     {
       "path": "skills/wtfp-research-literature/references/actions.md",
-      "sha256": "83ad7126edc5f2012bc4bdbd3486a3eaf6b6453a0d575416b8ca4633c97fff24"
+      "sha256": "85ab6c768813bfcb49b1da3d57e329fc667aa200e72ed82afa3d7112e7384539"
     },
     {
       "path": "skills/wtfp-research-literature/SKILL.md",
@@ -602,7 +602,7 @@
     },
     {
       "path": "skills/wtfp-write-section/references/actions.md",
-      "sha256": "367b9144ce76b4e6116d9a2566c02070e80bbb57325a43bf5aa22447e6cb83f5"
+      "sha256": "1fe6f8d50a1abd7a0b338772560317404942874ddd67be458ca24182ea20f7a4"
     },
     {
       "path": "skills/wtfp-write-section/SKILL.md",
@@ -660,9 +660,13 @@
       "path": "tools/citation/semantic-scholar.js",
       "sha256": "df4c1f3d69a28e06dd5285ba46c116bb2731aa940e16b9438c822846f38646f5"
     },
+    {
+      "path": "tools/package.json",
+      "sha256": "dbf8353f77358bc12169b7bb7301e1978d5b503e002ee927229a8993672818fc"
+    },
     {
       "path": "tools/README.md",
-      "sha256": "997889703a61599a3d6267b1ddbd571ac354b55e7fe3a9dc2ebbf00b6c6d2106"
+      "sha256": "eb99d2ef30209b409e8c0dbfccaabdf301b6bc50f17013cd8fa381c3c1d69ae2"
     },
     {
       "path": "tools/support/cite-nexus-client.js",
@@ -758,7 +762,7 @@
     },
     {
       "path": "workflows/plan-section.md",
-      "sha256": "02311226aa784dea4a6a5219ef59fcea6c904f92566318e3327aa4e883228446"
+      "sha256": "831c20c8afd147a8ba149a46f54591b6f07732983ee916a56c66701c8c701aa2"
     },
     {
       "path": "workflows/polish-prose.md",
@@ -786,7 +790,7 @@
     },
     {
       "path": "workflows/research-gap.md",
-      "sha256": "a1736edb7e739708a92e5ef11c2d7c7a87fe8e6e4d6586e8ce9b1db3ae5bb428"
+      "sha256": "02ffe236ba7de12e4b3abbac308c0e1cfc409147147d509616b95baec3fef012"
     },
     {
       "path": "workflows/resume-writing.md",
@@ -814,7 +818,7 @@
     },
     {
       "path": "workflows/write-section.md",
-      "sha256": "cfb3a0f9c61830d62cebdf8be5dacd17cef996d99cbab1df18267313ca05aacc"
+      "sha256": "5a2f0efcd11d7f41d941f54b80798ad481773820907fee68bea47f28b7af7bc3"
     }
   ]
 }

package/vendors/plugin/actions/research-gap.json

@@ -96,7 +96,7 @@
     },
     {
       "id": "user.gate",
-      "scope": "the external providers, bounded query set, and research scope and depth"
+      "scope": "unapproved or paid external providers and bounded query set, plus author-owned research scope and depth decisions"
     }
   ]
 }

package/vendors/plugin/ai.iowarp.clio/agents/wtfp-research-synthesizer.md

@@ -52,7 +52,7 @@ Investigate the literature needed to plan and write a specific section well. The
 ## Boundaries
 
 - This is a `mutation-report` role. It may write only the research and suggestion artifacts authorized by the invoking action.
-- When external literature search is approved, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after the gate. Returned results stay candidates, and this role never performs a bibliography write.
+- An operator-configured, trusted read-only CiteNexus MCP connection may search bounded public scholarly metadata without a second per-query gate. In an explicitly selected full-auto host session for this research action, `citation-search --backend=cite-nexus` may also search `crossref`, `datacite`, `europe_pmc`, or `arxiv` without another gate. Other providers or modes require explicit network approval naming providers and query bounds. Honor offline flags and host refusals. Returned results stay candidates, and this role never performs a bibliography write.
 - Never fabricate a citation, identifier, quotation, metadata field, source conclusion, or claim of exhaustive coverage.
 - Never overwrite an existing `project://sources/{source}` record. Additions remain provisional until identity and provenance are verified by an authorized action.
 - Do not explore alternatives that author decisions explicitly deferred or rejected.

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/add-todo.md

@@ -5,18 +5,16 @@ argument-hint: "[arguments]"
 
 # Add a todo
 
-@${pluginRoot}/project/README.md
 @${pluginRoot}/skills/wtfp-manage-project/SKILL.md
-@${pluginRoot}/skills/wtfp-manage-project/references/actions.md
 
 ## Record contract
 
 Read: `project://manifest`, `project://state`, `project://checkpoints/{checkpoint}`.
 Produce: `project://checkpoints/{checkpoint}` (create), `project://state` (update).
 
-Resolve every logical URI through the host adapter. Portable v1 JSON records are the source of truth: schema-validate before a write, preserve stable IDs, update revision and timestamps where required, and replace records atomically. Never pass a literal logical URI to a shell command or infer record state from a legacy Markdown control file.
+Use `extension_wtfp__record` for each declared JSON record write: pass its logical `uri`, complete `record`, and the revision read as `expect_revision` for revisioned updates. It validates, bumps revisions/timestamps, replaces atomically and reads back; preserve stable IDs and author decisions.
 
-Manuscript prose and supporting context, research, plan, review, summary, handoff, and deliverable artifacts retain their authored format (normally Markdown). Link them from the relevant v1 record; do not convert manuscript prose into project-state JSON.
+Write prose and linked artifacts with native file tools; keep their authored formats. The record tool handles JSON records only, never manuscript text, deletion or archives.
 
 ## Procedure
 
@@ -30,16 +28,12 @@ Do not initialize a repository or run branch, stage, commit, merge, push, or pub
 
 Report the logical resources read, created, updated, archived, or deleted; the gates crossed; validation results; unresolved checkpoints; and the safest next action. Never claim a mutation that was not verified.
 
-## Bound action contract and schemas
+Discover the named tools with `gateway(op="describe", capability="extension_wtfp__record")` (and the corresponding `measure_section` or `gate` name), then use `gateway(op="call", capability="<exact name>", args={...})`. A present tool's error or refusal stops the action; never bypass it with a manual write or shell script.
+If desk tools are absent, follow `${pluginRoot}/workflows/add-todo.md` and `${pluginRoot}/project/README.md` with native tools and `ask_user` gates.
+
+## Bound action contract
 
 @${pluginRoot}/actions/add-todo.json
-@${pluginRoot}/project/schemas/common.schema.json
-@${pluginRoot}/project/schemas/checkpoint.schema.json
-@${pluginRoot}/project/templates/checkpoint.json
-@${pluginRoot}/project/schemas/manifest.schema.json
-@${pluginRoot}/project/templates/manifest.json
-@${pluginRoot}/project/schemas/state.schema.json
-@${pluginRoot}/project/templates/state.json
 
 ## Invocation input
 

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/analyze-bib.md

@@ -5,18 +5,16 @@ argument-hint: "[arguments]"
 
 # Analyze the bibliography
 
-@${pluginRoot}/project/README.md
 @${pluginRoot}/skills/wtfp-research-literature/SKILL.md
-@${pluginRoot}/skills/wtfp-research-literature/references/actions.md
 
 ## Record contract
 
 Read: `project://manifest`, `project://structure/outline`, `project://sections/{section}`, `project://sources/{source}`, `project://evidence/{evidence}`, `project://materials/{artifact}`, `project://paper/{artifact}`.
 Produce: `project://sources/{source}` (create), `project://sources/{source}` (update), `project://evidence/{evidence}` (create), `project://evidence/{evidence}` (update), `project://validations/{validation}` (create).
 
-Resolve every logical URI through the host adapter. Portable v1 JSON records are the source of truth: schema-validate before a write, preserve stable IDs, update revision and timestamps where required, and replace records atomically. Never pass a literal logical URI to a shell command or infer record state from a legacy Markdown control file.
+Use `extension_wtfp__record` for each declared JSON record write: pass its logical `uri`, complete `record`, and the revision read as `expect_revision` for revisioned updates. It validates, bumps revisions/timestamps, replaces atomically and reads back; preserve stable IDs and author decisions.
 
-Manuscript prose and supporting context, research, plan, review, summary, handoff, and deliverable artifacts retain their authored format (normally Markdown). Link them from the relevant v1 record; do not convert manuscript prose into project-state JSON.
+Write prose and linked artifacts with native file tools; keep their authored formats. The record tool handles JSON records only, never manuscript text, deletion or archives.
 
 ## Procedure
 
@@ -41,22 +39,12 @@ Do not initialize a repository or run branch, stage, commit, merge, push, or pub
 
 Report the logical resources read, created, updated, archived, or deleted; the gates crossed; validation results; unresolved checkpoints; and the safest next action. Never claim a mutation that was not verified.
 
-## Bound action contract and schemas
+Discover the named tools with `gateway(op="describe", capability="extension_wtfp__record")` (and the corresponding `measure_section` or `gate` name), then use `gateway(op="call", capability="<exact name>", args={...})`. A present tool's error or refusal stops the action; never bypass it with a manual write or shell script.
+If desk tools are absent, follow `${pluginRoot}/workflows/analyze-bib.md` and `${pluginRoot}/project/README.md` with native tools and `ask_user` gates.
+
+## Bound action contract
 
 @${pluginRoot}/actions/analyze-bib.json
-@${pluginRoot}/project/schemas/common.schema.json
-@${pluginRoot}/project/schemas/evidence.schema.json
-@${pluginRoot}/project/templates/evidence.json
-@${pluginRoot}/project/schemas/manifest.schema.json
-@${pluginRoot}/project/templates/manifest.json
-@${pluginRoot}/project/schemas/outline.schema.json
-@${pluginRoot}/project/templates/outline.json
-@${pluginRoot}/project/schemas/section.schema.json
-@${pluginRoot}/project/templates/section.json
-@${pluginRoot}/project/schemas/source.schema.json
-@${pluginRoot}/project/templates/source.json
-@${pluginRoot}/project/schemas/validation.schema.json
-@${pluginRoot}/project/templates/validation.json
 
 ## Invocation input
 
@@ -68,10 +56,12 @@ $ARGUMENTS
 
 ## Clio user-gate binding
 
-Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the structured value returned by that tool satisfies the gate. Invocation arguments, assistant prose, silence, or a report artifact do not count as a selection. Apply no gated mutation before `ask_user` returns. After any permitted mutation, perform the workflow-required readback before reporting success.
+For a pending checkpoint in the declared gate's exact scope, call `extension_wtfp__gate` with its ID. Create a missing pending checkpoint through `extension_wtfp__record` only when this action declares checkpoint creation; otherwise use `ask_user` for the unpersisted author decision and do not invent an undeclared output. Only the structured author answer satisfies the gate; cancelled, retained or expired checkpoints authorize nothing. Never write `resolution.resolved_by: author` yourself or infer approval from invocation text, prose or silence. Read back a persisted resolution before applying its gated mutation.
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-citation-expert`. Do not substitute generic coder or verifier agents. If a named agent is unavailable, report that blocker and stop instead of silently changing roles.
+
 Read the single wtfp.role-result entry in native validations/checks and parse its evidence string as portable role-result JSON. Validate its schema, role and action against the dispatched task. Missing, duplicate or malformed outcomes fail closed. On needs_input ask the author through ask_user and redispatch with the response; on blocked or failed stop and report the issue. Only completed permits downstream work, and it never substitutes for an author gate or artifact readback.
 
 <!-- Generated by WTF-P adapter compiler v5 from protocol/actions/analyze-bib; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/audit-milestone.md

@@ -5,18 +5,16 @@ argument-hint: "[arguments]"
 
 # Audit a milestone
 
-@${pluginRoot}/project/README.md
 @${pluginRoot}/skills/wtfp-review-manuscript/SKILL.md
-@${pluginRoot}/skills/wtfp-review-manuscript/references/actions.md
 
 ## Record contract
 
 Read: `project://manifest`, `project://config`, `project://state`, `project://decisions`, `project://structure/outline`, `project://sections/{section}`, `project://sources/{source}`, `project://evidence/{evidence}`, `project://validations/{validation}`, `project://paper/{artifact}`.
 Produce: `project://validations/{validation}` (create).
 
-Resolve every logical URI through the host adapter. Portable v1 JSON records are the source of truth: schema-validate before a write, preserve stable IDs, update revision and timestamps where required, and replace records atomically. Never pass a literal logical URI to a shell command or infer record state from a legacy Markdown control file.
+Use `extension_wtfp__record` for each declared JSON record write: pass its logical `uri`, complete `record`, and the revision read as `expect_revision` for revisioned updates. It validates, bumps revisions/timestamps, replaces atomically and reads back; preserve stable IDs and author decisions.
 
-Manuscript prose and supporting context, research, plan, review, summary, handoff, and deliverable artifacts retain their authored format (normally Markdown). Link them from the relevant v1 record; do not convert manuscript prose into project-state JSON.
+Write prose and linked artifacts with native file tools; keep their authored formats. The record tool handles JSON records only, never manuscript text, deletion or archives.
 
 ## Procedure
 
@@ -40,28 +38,12 @@ Do not initialize a repository or run branch, stage, commit, merge, push, or pub
 
 Report the logical resources read, created, updated, archived, or deleted; the gates crossed; validation results; unresolved checkpoints; and the safest next action. Never claim a mutation that was not verified.
 
-## Bound action contract and schemas
+Discover the named tools with `gateway(op="describe", capability="extension_wtfp__record")` (and the corresponding `measure_section` or `gate` name), then use `gateway(op="call", capability="<exact name>", args={...})`. A present tool's error or refusal stops the action; never bypass it with a manual write or shell script.
+If desk tools are absent, follow `${pluginRoot}/workflows/audit-milestone.md` and `${pluginRoot}/project/README.md` with native tools and `ask_user` gates.
+
+## Bound action contract
 
 @${pluginRoot}/actions/audit-milestone.json
-@${pluginRoot}/project/schemas/common.schema.json
-@${pluginRoot}/project/schemas/config.schema.json
-@${pluginRoot}/project/templates/config.json
-@${pluginRoot}/project/schemas/decisions.schema.json
-@${pluginRoot}/project/templates/decisions.json
-@${pluginRoot}/project/schemas/evidence.schema.json
-@${pluginRoot}/project/templates/evidence.json
-@${pluginRoot}/project/schemas/manifest.schema.json
-@${pluginRoot}/project/templates/manifest.json
-@${pluginRoot}/project/schemas/outline.schema.json
-@${pluginRoot}/project/templates/outline.json
-@${pluginRoot}/project/schemas/section.schema.json
-@${pluginRoot}/project/templates/section.json
-@${pluginRoot}/project/schemas/source.schema.json
-@${pluginRoot}/project/templates/source.json
-@${pluginRoot}/project/schemas/state.schema.json
-@${pluginRoot}/project/templates/state.json
-@${pluginRoot}/project/schemas/validation.schema.json
-@${pluginRoot}/project/templates/validation.json
 
 ## Invocation input
 
@@ -73,6 +55,6 @@ $ARGUMENTS
 
 ## Clio user-gate binding
 
-Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the structured value returned by that tool satisfies the gate. Invocation arguments, assistant prose, silence, or a report artifact do not count as a selection. Apply no gated mutation before `ask_user` returns. After any permitted mutation, perform the workflow-required readback before reporting success.
+For a pending checkpoint in the declared gate's exact scope, call `extension_wtfp__gate` with its ID. Create a missing pending checkpoint through `extension_wtfp__record` only when this action declares checkpoint creation; otherwise use `ask_user` for the unpersisted author decision and do not invent an undeclared output. Only the structured author answer satisfies the gate; cancelled, retained or expired checkpoints authorize nothing. Never write `resolution.resolved_by: author` yourself or infer approval from invocation text, prose or silence. Read back a persisted resolution before applying its gated mutation.
 
 <!-- Generated by WTF-P adapter compiler v5 from protocol/actions/audit-milestone; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/check-refs.md

@@ -5,18 +5,16 @@ argument-hint: "[arguments]"
 
 # Check references
 
-@${pluginRoot}/project/README.md
 @${pluginRoot}/skills/wtfp-research-literature/SKILL.md
-@${pluginRoot}/skills/wtfp-research-literature/references/actions.md
 
 ## Record contract
 
 Read: `project://config`, `project://sources/{source}`, `project://evidence/{evidence}`, `project://materials/{artifact}`, `project://paper/{artifact}`.
 Produce: `project://deliverables/bibliography/{artifact}` (create), `project://validations/{validation}` (create).
 
-Resolve every logical URI through the host adapter. Portable v1 JSON records are the source of truth: schema-validate before a write, preserve stable IDs, update revision and timestamps where required, and replace records atomically. Never pass a literal logical URI to a shell command or infer record state from a legacy Markdown control file.
+Use `extension_wtfp__record` for each declared JSON record write: pass its logical `uri`, complete `record`, and the revision read as `expect_revision` for revisioned updates. It validates, bumps revisions/timestamps, replaces atomically and reads back; preserve stable IDs and author decisions.
 
-Manuscript prose and supporting context, research, plan, review, summary, handoff, and deliverable artifacts retain their authored format (normally Markdown). Link them from the relevant v1 record; do not convert manuscript prose into project-state JSON.
+Write prose and linked artifacts with native file tools; keep their authored formats. The record tool handles JSON records only, never manuscript text, deletion or archives.
 
 ## Procedure
 
@@ -40,18 +38,12 @@ Do not initialize a repository or run branch, stage, commit, merge, push, or pub
 
 Report the logical resources read, created, updated, archived, or deleted; the gates crossed; validation results; unresolved checkpoints; and the safest next action. Never claim a mutation that was not verified.
 
-## Bound action contract and schemas
+Discover the named tools with `gateway(op="describe", capability="extension_wtfp__record")` (and the corresponding `measure_section` or `gate` name), then use `gateway(op="call", capability="<exact name>", args={...})`. A present tool's error or refusal stops the action; never bypass it with a manual write or shell script.
+If desk tools are absent, follow `${pluginRoot}/workflows/check-refs.md` and `${pluginRoot}/project/README.md` with native tools and `ask_user` gates.
+
+## Bound action contract
 
 @${pluginRoot}/actions/check-refs.json
-@${pluginRoot}/project/schemas/common.schema.json
-@${pluginRoot}/project/schemas/config.schema.json
-@${pluginRoot}/project/templates/config.json
-@${pluginRoot}/project/schemas/evidence.schema.json
-@${pluginRoot}/project/templates/evidence.json
-@${pluginRoot}/project/schemas/source.schema.json
-@${pluginRoot}/project/templates/source.json
-@${pluginRoot}/project/schemas/validation.schema.json
-@${pluginRoot}/project/templates/validation.json
 
 ## Invocation input
 
@@ -63,10 +55,12 @@ $ARGUMENTS
 
 ## Clio user-gate binding
 
-Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the structured value returned by that tool satisfies the gate. Invocation arguments, assistant prose, silence, or a report artifact do not count as a selection. Apply no gated mutation before `ask_user` returns. After any permitted mutation, perform the workflow-required readback before reporting success.
+For a pending checkpoint in the declared gate's exact scope, call `extension_wtfp__gate` with its ID. Create a missing pending checkpoint through `extension_wtfp__record` only when this action declares checkpoint creation; otherwise use `ask_user` for the unpersisted author decision and do not invent an undeclared output. Only the structured author answer satisfies the gate; cancelled, retained or expired checkpoints authorize nothing. Never write `resolution.resolved_by: author` yourself or infer approval from invocation text, prose or silence. Read back a persisted resolution before applying its gated mutation.
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-citation-formatter`. Do not substitute generic coder or verifier agents. If a named agent is unavailable, report that blocker and stop instead of silently changing roles.
+
 Read the single wtfp.role-result entry in native validations/checks and parse its evidence string as portable role-result JSON. Validate its schema, role and action against the dispatched task. Missing, duplicate or malformed outcomes fail closed. On needs_input ask the author through ask_user and redispatch with the response; on blocked or failed stop and report the issue. Only completed permits downstream work, and it never substitutes for an author gate or artifact readback.
 
 <!-- Generated by WTF-P adapter compiler v5 from protocol/actions/check-refs; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/check-todos.md

@@ -5,24 +5,22 @@ argument-hint: "[arguments]"
 
 # Review todos
 
-@${pluginRoot}/project/README.md
 @${pluginRoot}/skills/wtfp-manage-project/SKILL.md
-@${pluginRoot}/skills/wtfp-manage-project/references/actions.md
 
 ## Record contract
 
 Read: `project://state`, `project://checkpoints/{checkpoint}`.
 Produce: `project://checkpoints/{checkpoint}` (update), `project://state` (update).
 
-Resolve every logical URI through the host adapter. Portable v1 JSON records are the source of truth: schema-validate before a write, preserve stable IDs, update revision and timestamps where required, and replace records atomically. Never pass a literal logical URI to a shell command or infer record state from a legacy Markdown control file.
+Use `extension_wtfp__record` for each declared JSON record write: pass its logical `uri`, complete `record`, and the revision read as `expect_revision` for revisioned updates. It validates, bumps revisions/timestamps, replaces atomically and reads back; preserve stable IDs and author decisions.
 
-Manuscript prose and supporting context, research, plan, review, summary, handoff, and deliverable artifacts retain their authored format (normally Markdown). Link them from the relevant v1 record; do not convert manuscript prose into project-state JSON.
+Write prose and linked artifacts with native file tools; keep their authored formats. The record tool handles JSON records only, never manuscript text, deletion or archives.
 
 ## Procedure
 
 1. List pending human-action checkpoints in deterministic order with their requests and scope URIs.
-2. Ask the user to resolve, waive, retain, or expire each selected checkpoint.
-3. Apply only the approved status transitions and reconcile state.active_checkpoint_uris.
+2. Call `extension_wtfp__gate` for each selected pending checkpoint; the parked interview records the author's answer.
+3. Read back the resulting checkpoint and state; retained or cancelled gates remain pending.
 
 ## Safety and completion
 
@@ -30,14 +28,12 @@ Do not initialize a repository or run branch, stage, commit, merge, push, or pub
 
 Report the logical resources read, created, updated, archived, or deleted; the gates crossed; validation results; unresolved checkpoints; and the safest next action. Never claim a mutation that was not verified.
 
-## Bound action contract and schemas
+Discover the named tools with `gateway(op="describe", capability="extension_wtfp__record")` (and the corresponding `measure_section` or `gate` name), then use `gateway(op="call", capability="<exact name>", args={...})`. A present tool's error or refusal stops the action; never bypass it with a manual write or shell script.
+If desk tools are absent, follow `${pluginRoot}/workflows/check-todos.md` and `${pluginRoot}/project/README.md` with native tools and `ask_user` gates.
+
+## Bound action contract
 
 @${pluginRoot}/actions/check-todos.json
-@${pluginRoot}/project/schemas/common.schema.json
-@${pluginRoot}/project/schemas/checkpoint.schema.json
-@${pluginRoot}/project/templates/checkpoint.json
-@${pluginRoot}/project/schemas/state.schema.json
-@${pluginRoot}/project/templates/state.json
 
 ## Invocation input
 
@@ -49,6 +45,6 @@ $ARGUMENTS
 
 ## Clio user-gate binding
 
-Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the structured value returned by that tool satisfies the gate. Invocation arguments, assistant prose, silence, or a report artifact do not count as a selection. Apply no gated mutation before `ask_user` returns. After any permitted mutation, perform the workflow-required readback before reporting success.
+For a pending checkpoint in the declared gate's exact scope, call `extension_wtfp__gate` with its ID. Create a missing pending checkpoint through `extension_wtfp__record` only when this action declares checkpoint creation; otherwise use `ask_user` for the unpersisted author decision and do not invent an undeclared output. Only the structured author answer satisfies the gate; cancelled, retained or expired checkpoints authorize nothing. Never write `resolution.resolved_by: author` yourself or infer approval from invocation text, prose or silence. Read back a persisted resolution before applying its gated mutation.
 
 <!-- Generated by WTF-P adapter compiler v5 from protocol/actions/check-todos; do not edit. -->