wtf-p 0.7.1 → 0.7.2

package/README.md

@@ -19,7 +19,7 @@ the scientific judgment. The agent keeps the bookkeeping and does bounded jobs.
 
 It ships as one canonical [Agent Plugins 1.0.0](https://agent-plugins.org)
 bundle that a deterministic compiler projects into a native package for seven
-coding-agent hosts. Version `0.7.1` is the current stable release and is
+coding-agent hosts. Version `0.7.2` is the current stable release and is
 what npm `latest` resolves to; v0.5 remains installable by explicit version.
 
 **Optional CiteNexus research backend (since 0.7.0):** `citation-search --backend=cite-nexus`
@@ -56,18 +56,19 @@ registers it with the host's native plugin lifecycle where one exists.
 
 | Host | Install | Native registration the installer performs | Verified with |
 | --- | --- | --- | --- |
-| Clio Coder (0.4.7 or newer) | `npx --yes --package=wtf-p@0.7.1 -- wtf-p install clio` | `clio-coder library install <staged-bundle> --user`, then `clio-coder library inspect wtfp --user --json` | 0.4.9 (local build) |
-| Claude Code | `npx --yes --package=wtf-p@0.7.1 -- wtf-p install claude` | `claude plugin marketplace add <root>/marketplaces/wtfp --scope user`, then `claude plugin install wtfp@wtfp --scope user -y` | 2.1.274 |
-| Codex | `npx --yes --package=wtf-p@0.7.1 -- wtf-p install codex` | `codex plugin marketplace add <root>/marketplaces/wtfp`, then `codex plugin add wtfp@wtfp --json`; agents copied to `$CODEX_HOME/agents/` | 0.153.3 |
-| GitHub Copilot CLI | `npx --yes --package=wtf-p@0.7.1 -- wtf-p install copilot` | `copilot plugin marketplace add <root>/marketplaces/wtfp`, then `copilot plugin install wtfp@wtfp` | 1.0.85 |
-| OpenCode | `npx --yes --package=wtf-p@0.7.1 -- wtf-p install opencode` | Files under the OpenCode config root; OpenCode discovers them by directory | 1.18.31 |
-| Antigravity CLI | `npx --yes --package=wtf-p@0.7.1 -- wtf-p install antigravity` | `agy plugin install <root>/sources/wtfp` | 1.2.5 |
-| Gemini CLI | `npx --yes --package=wtf-p@0.7.1 -- wtf-p install gemini` | Files under `<root>/extensions/wtfp`; Gemini discovers the extension by directory | 0.60.0 |
+| Clio Coder (0.4.7 or newer) | `npx --yes --package=wtf-p@0.7.2 -- wtf-p install clio` | `clio-coder library install <staged-bundle> --user`, then `clio-coder library inspect wtfp --user --json` | 0.4.9 (local build) |
+| Claude Code | `npx --yes --package=wtf-p@0.7.2 -- wtf-p install claude` | `claude plugin marketplace add <root>/marketplaces/wtfp --scope user`, then `claude plugin install wtfp@wtfp --scope user -y` | 2.1.274 |
+| Codex | `npx --yes --package=wtf-p@0.7.2 -- wtf-p install codex` | `codex plugin marketplace add <root>/marketplaces/wtfp`, then `codex plugin add wtfp@wtfp --json`; agents copied to `$CODEX_HOME/agents/` | 0.153.3 |
+| GitHub Copilot CLI | `npx --yes --package=wtf-p@0.7.2 -- wtf-p install copilot` | `copilot plugin marketplace add <root>/marketplaces/wtfp`, then `copilot plugin install wtfp@wtfp` | 1.0.85 |
+| OpenCode | `npx --yes --package=wtf-p@0.7.2 -- wtf-p install opencode` | Files under the OpenCode config root; OpenCode discovers them by directory | 1.18.31 |
+| Antigravity CLI | `npx --yes --package=wtf-p@0.7.2 -- wtf-p install antigravity` | `agy plugin install <root>/sources/wtfp` | 1.2.5 |
+| Gemini CLI | `npx --yes --package=wtf-p@0.7.2 -- wtf-p install gemini` | Files under `<root>/extensions/wtfp`; Gemini discovers the extension by directory | 0.60.0 |
 
 "Verified" means native discovery in a disposable profile on this exact
 envelope, with the commands recorded in
 [Host capabilities](docs/HOST_CAPABILITIES.md). Clio Coder is published as
 `@iowarp/clio-coder`; 0.4.7 and newer carry the plugin engine WTF-P uses.
+Clio Coder itself requires Node.js 22.19 or newer.
 
 Keep the explicit `--package=wtf-p@<version> -- wtf-p` form. On a workstation
 with WTF-P 0.5 installed globally, the shorter `npx wtf-p@<version>` can run
@@ -76,7 +77,7 @@ the old executable instead.
 ## Sixty-second start
 
 ```bash
-npx --yes --package=wtf-p@0.7.1 -- wtf-p install clio
+npx --yes --package=wtf-p@0.7.2 -- wtf-p install clio
 cd /path/to/your-paper-or-proposal
 clio-coder --autonomy suggest
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtf-p",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Portable, evidence-grounded academic writing workflows (papers, proposals, posters, presentations) for Clio Coder, Claude Code, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, and Gemini CLI.",
   "bin": {
     "wtfp": "bin/install.js",

package/protocol/actions/research-gap.json

@@ -60,6 +60,7 @@
   ],
   "tools": [
     "bibliography.index",
+    "citation.fetch",
     "citation.rank",
     "citation.scholar-lookup",
     "citation.semantic-scholar"
@@ -95,7 +96,7 @@
     },
     {
       "id": "user.gate",
-      "scope": "research scope and depth"
+      "scope": "the external providers, bounded query set, and research scope and depth"
     }
   ]
 }

package/protocol/roles/research-synthesizer.md

@@ -42,6 +42,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.
 - 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/protocol/skills/wtfp-research-literature/references/actions.md

@@ -14,7 +14,7 @@ Contract: [protocol/actions/research-gap.json](../../../actions/research-gap.jso
    - `standard`: run a focused, reproducible search across the most relevant categories;
    - `deep`: map foundational, recent, competing, gap-defining, and methodological work, including important disagreements and intellectual lineage.
 5. Form search questions and inclusion criteria before searching. Record databases or corpora, query strings, date, filters, and stopping rule.
-6. Search authoritative scholarly sources when external research is approved and available. Deduplicate candidates by persistent identifier, then normalized title.
+6. Search authoritative scholarly sources only after disclosing and receiving approval for the external providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Deduplicate candidates by persistent identifier, then normalized title.
 7. Verify each retained source from its primary record or publication. Create a `project://sources/{source}` record with title, creators, year, source kind, identifiers, citation key, status, provenance, inspection depth, and verification time.
 8. Read enough of each source to distinguish its actual claim, method, population, result, and limitation. Do not cite an abstract-only impression as full-paper evidence.
 9. Create `project://evidence/{evidence}` separately for each retained claim-level interpretation, with relation, locator, limitations, confidence, and inspection depth. Synthesize by question rather than listing papers; identify consensus, disagreement, methodological differences, missing evidence, and defensible positioning.

package/protocol/workflows/research-gap.md

@@ -22,7 +22,7 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 ## Procedure
 
 1. Resolve the research question and section scope against locked/deferred decisions; agree on depth and source constraints.
-2. Search declared scholarly services, verify source identity and inspection depth, and separate source records from claim-level evidence.
+2. Search declared scholarly services only after the gate names the providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Verify source identity and inspection depth, and separate source records from claim-level evidence.
 3. Synthesize supported, conflicting, and missing evidence into a Markdown research artifact; link new records and disclose limitations.
 
 ## Bundled tool execution

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

@@ -2,7 +2,7 @@
   "schema": "wtfp.generated-adapter/v1",
   "generatorVersion": 5,
   "target": "antigravity",
-  "sourceHash": "fd300ebe88a80d19a91efd0d8e22700782eceec0728584e5d1004a54794804a7",
+  "sourceHash": "23ee519da7229238b594ff551727214e995b56a308c65b3088716b97b02c0b35",
   "files": [
     {
       "path": "actions/add-todo.json",
@@ -118,7 +118,7 @@
     },
     {
       "path": "actions/research-gap.json",
-      "sha256": "61bb44bf5a5dbbaa5e296f69515b65c21a1ce15022f2bafcb4d22df82f0d690c"
+      "sha256": "80659531e18fb60dd46620c8b35aa27ce0f966c467f0d3073ae8c6519084153e"
     },
     {
       "path": "actions/resume-writing.json",
@@ -178,7 +178,7 @@
     },
     {
       "path": "agents/wtfp-research-synthesizer.md",
-      "sha256": "b4871282113a1ee3c44c42369fe19aaaae3f188a26182a1bc53052592e02c45a"
+      "sha256": "2adec7aab0cad7e9cc66312b14f8ee8824d269ad499319ad47094cfe4936f04a"
     },
     {
       "path": "agents/wtfp-section-planner.md",
@@ -362,7 +362,7 @@
     },
     {
       "path": "plugin.json",
-      "sha256": "1017fe85464c00f4d1f2ad8ac23c1aace4f2edfccccd264b7ba6580568dc42bf"
+      "sha256": "62088bf28c24e8a00012b1d3fd0ec67468fd935aed314a1a6ae1916ef5d23637"
     },
     {
       "path": "project/README.md",
@@ -486,7 +486,7 @@
     },
     {
       "path": "roles/research-synthesizer.md",
-      "sha256": "d04ba72d66f693202b9327aaef82dd47637f1d99349d190149ef82ec43c8be83"
+      "sha256": "011feaa1fdb967c267713f4fa4b0c45b27e66a62f71d1f24c4f44360442aef57"
     },
     {
       "path": "roles/section-planner.md",
@@ -570,7 +570,7 @@
     },
     {
       "path": "skills/wtfp-research-literature/references/actions.md",
-      "sha256": "511439009eebb56a79e88d2ad3851c8d0bad9ba89f7ae564834709bf47163597"
+      "sha256": "83cb1dbc27563a02bb35fbb995fe54d37e5afe523821b5cb5b6c3baf2fa72d50"
     },
     {
       "path": "skills/wtfp-research-literature/SKILL.md",
@@ -790,7 +790,7 @@
     },
     {
       "path": "workflows/research-gap.md",
-      "sha256": "c98eb74ae970713affa435e79ba780703694cd1eca0c141bf840ebe67adc3983"
+      "sha256": "a1736edb7e739708a92e5ef11c2d7c7a87fe8e6e4d6586e8ce9b1db3ae5bb428"
     },
     {
       "path": "workflows/resume-writing.md",

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

@@ -60,6 +60,7 @@
   ],
   "tools": [
     "bibliography.index",
+    "citation.fetch",
     "citation.rank",
     "citation.scholar-lookup",
     "citation.semantic-scholar"
@@ -95,7 +96,7 @@
     },
     {
       "id": "user.gate",
-      "scope": "research scope and depth"
+      "scope": "the external providers, bounded query set, and research scope and depth"
     }
   ]
 }

package/vendors/antigravity/agents/wtfp-research-synthesizer.md

@@ -48,6 +48,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.
 - 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/antigravity/plugin.json

@@ -1,5 +1,5 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "wtfp",
-  "description": "Portable academic research and writing workflows (WTF-P 0.7.1)."
+  "description": "Portable academic research and writing workflows (WTF-P 0.7.2)."
 }

package/vendors/antigravity/roles/research-synthesizer.md

@@ -42,6 +42,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.
 - 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/antigravity/skills/wtfp-research-literature/references/actions.md

@@ -54,7 +54,7 @@ Contract: [protocol/actions/research-gap.json](../../../actions/research-gap.jso
    - `standard`: run a focused, reproducible search across the most relevant categories;
    - `deep`: map foundational, recent, competing, gap-defining, and methodological work, including important disagreements and intellectual lineage.
 5. Form search questions and inclusion criteria before searching. Record databases or corpora, query strings, date, filters, and stopping rule.
-6. Search authoritative scholarly sources when external research is approved and available. Deduplicate candidates by persistent identifier, then normalized title.
+6. Search authoritative scholarly sources only after disclosing and receiving approval for the external providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Deduplicate candidates by persistent identifier, then normalized title.
 7. Verify each retained source from its primary record or publication. Create a `project://sources/{source}` record with title, creators, year, source kind, identifiers, citation key, status, provenance, inspection depth, and verification time.
 8. Read enough of each source to distinguish its actual claim, method, population, result, and limitation. Do not cite an abstract-only impression as full-paper evidence.
 9. Create `project://evidence/{evidence}` separately for each retained claim-level interpretation, with relation, locator, limitations, confidence, and inspection depth. Synthesize by question rather than listing papers; identify consensus, disagreement, methodological differences, missing evidence, and defensible positioning.

package/vendors/antigravity/workflows/research-gap.md

@@ -22,7 +22,7 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 ## Procedure
 
 1. Resolve the research question and section scope against locked/deferred decisions; agree on depth and source constraints.
-2. Search declared scholarly services, verify source identity and inspection depth, and separate source records from claim-level evidence.
+2. Search declared scholarly services only after the gate names the providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Verify source identity and inspection depth, and separate source records from claim-level evidence.
 3. Synthesize supported, conflicting, and missing evidence into a Markdown research artifact; link new records and disclose limitations.
 
 ## Bundled tool execution

package/vendors/claude/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "WTF-P evidence-grounded academic workflow plugin.",
-    "version": "0.7.1"
+    "version": "0.7.2"
   },
   "plugins": [
     {
       "name": "wtfp",
       "source": "./",
       "description": "Portable academic research and writing workflows.",
-      "version": "0.7.1",
+      "version": "0.7.2",
       "author": {
         "name": "akougkas"
       },

package/vendors/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wtfp",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Portable academic research and writing workflows with stable wtfp actions.",
   "author": {
     "name": "akougkas",

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

@@ -2,15 +2,15 @@
   "schema": "wtfp.generated-adapter/v1",
   "generatorVersion": 5,
   "target": "claude",
-  "sourceHash": "f3cd9326674a890a0eaea6f2d30816e9d91c9832cbfc6a5c6f18c7dee3b4f075",
+  "sourceHash": "37a8fd8b02f436188b91203393eae686c24749034028203907202226f2aae4d2",
   "files": [
     {
       "path": ".claude-plugin/marketplace.json",
-      "sha256": "55edd7c736d654630ea1267fde8e7f8e090b8fadd8cd0bb3ef16cd6cab5af7a1"
+      "sha256": "483f68f214398786956b33c3f4202dbcff0f38966f74b7228424abe733359e0c"
     },
     {
       "path": ".claude-plugin/plugin.json",
-      "sha256": "1f77fce4cb2bdb2ec25d7dd8a8fa4fb65d7f58beab887e657b73f6d9fcf44d44"
+      "sha256": "737a8818dc1ef220429a477c9226664c5c924fcc42da54c421fc36d6b6fcbc37"
     },
     {
       "path": "actions/add-todo.json",
@@ -126,7 +126,7 @@
     },
     {
       "path": "actions/research-gap.json",
-      "sha256": "61bb44bf5a5dbbaa5e296f69515b65c21a1ce15022f2bafcb4d22df82f0d690c"
+      "sha256": "80659531e18fb60dd46620c8b35aa27ce0f966c467f0d3073ae8c6519084153e"
     },
     {
       "path": "actions/resume-writing.json",
@@ -186,7 +186,7 @@
     },
     {
       "path": "agents/wtfp-research-synthesizer.md",
-      "sha256": "d4e80c84d0ff45e55b38018e879a4f38cabe84e65f2a6769c3447f4ff7a8a021"
+      "sha256": "7852d483aa3385604f8d07f018202d7d8396fe1e15c76e3284a3db0696183f4b"
     },
     {
       "path": "agents/wtfp-section-planner.md",
@@ -230,7 +230,7 @@
     },
     {
       "path": "ai.iowarp.clio/agents/wtfp-research-synthesizer.md",
-      "sha256": "0458f59e99dc04e36e6e8430ecd9d06a6a115af31bab087069f768e9d767034c"
+      "sha256": "18cfbac40fe49413797ed8bd12779df158eacb0155620dd34c966e061f2d5182"
     },
     {
       "path": "ai.iowarp.clio/agents/wtfp-section-planner.md",
@@ -306,7 +306,7 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/help.md",
-      "sha256": "f7d0a9479be53c68cc07c9f33522d8484326b5267aa1790a2825d71caba57112"
+      "sha256": "dc549d5ea17cd14f945bc1a4cbc8bc95d67488bc61ea82e40dfa2f24bb839877"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/insert-section.md",
@@ -366,7 +366,7 @@
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/research-gap.md",
-      "sha256": "f59efde01a3a461c2fef4219774eb32795324960649980da5e390c99d57774f3"
+      "sha256": "9a08d66ac0f23ec846aa054ce50a76ebe1d5b19a922389a96b99c8cbe1e88665"
     },
     {
       "path": "ai.iowarp.clio/prompts/wtfp/resume-writing.md",
@@ -518,7 +518,7 @@
     },
     {
       "path": "commands/research-gap.md",
-      "sha256": "a99892c6f728cd33325e70e2861287f30c33fcb10124660099411eb7782409ce"
+      "sha256": "10a9a5a9e27ad3f30c10b3cf012f935421ac25384480f4f376382619369b9364"
     },
     {
       "path": "commands/resume-writing.md",
@@ -574,7 +574,7 @@
     },
     {
       "path": "plugin.json",
-      "sha256": "de4f7583a5c4d9d1a04deeb20f1f74d8a3cc718c3d4dbbc82c07c4b8605b28f0"
+      "sha256": "9ca54a9c1ac8c20bd741650ec5e8556db9168a55d7b150d8ab03e3c97b64c81f"
     },
     {
       "path": "project/README.md",
@@ -698,7 +698,7 @@
     },
     {
       "path": "roles/research-synthesizer.md",
-      "sha256": "d04ba72d66f693202b9327aaef82dd47637f1d99349d190149ef82ec43c8be83"
+      "sha256": "011feaa1fdb967c267713f4fa4b0c45b27e66a62f71d1f24c4f44360442aef57"
     },
     {
       "path": "roles/section-planner.md",
@@ -786,7 +786,7 @@
     },
     {
       "path": "skills/wtfp-research-literature/references/actions.md",
-      "sha256": "04768c3c0e0817ae3c3158c59c7075e838ad7c63b70d5a06a719ea0ef9f399b6"
+      "sha256": "83ad7126edc5f2012bc4bdbd3486a3eaf6b6453a0d575416b8ca4633c97fff24"
     },
     {
       "path": "skills/wtfp-research-literature/SKILL.md",
@@ -1006,7 +1006,7 @@
     },
     {
       "path": "workflows/research-gap.md",
-      "sha256": "c98eb74ae970713affa435e79ba780703694cd1eca0c141bf840ebe67adc3983"
+      "sha256": "a1736edb7e739708a92e5ef11c2d7c7a87fe8e6e4d6586e8ce9b1db3ae5bb428"
     },
     {
       "path": "workflows/resume-writing.md",

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

@@ -60,6 +60,7 @@
   ],
   "tools": [
     "bibliography.index",
+    "citation.fetch",
     "citation.rank",
     "citation.scholar-lookup",
     "citation.semantic-scholar"
@@ -95,7 +96,7 @@
     },
     {
       "id": "user.gate",
-      "scope": "research scope and depth"
+      "scope": "the external providers, bounded query set, and research scope and depth"
     }
   ]
 }

package/vendors/claude/agents/wtfp-research-synthesizer.md

@@ -49,6 +49,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.
 - 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/claude/ai.iowarp.clio/agents/wtfp-research-synthesizer.md

@@ -52,6 +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.
 - 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/claude/ai.iowarp.clio/prompts/wtfp/help.md

@@ -6,7 +6,7 @@ display-only: true
 <!-- Generated by WTF-P adapter compiler v5 from protocol/actions/help; do not edit. -->
 
 ```text
-WTF-P 0.7.1 on Clio Coder: evidence-grounded academic writing
+WTF-P 0.7.2 on Clio Coder: evidence-grounded academic writing
 
 Start here
   /wtfp:new-paper [input]

package/vendors/claude/ai.iowarp.clio/prompts/wtfp/research-gap.md

@@ -23,7 +23,7 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 ## Procedure
 
 1. Resolve the research question and section scope against locked/deferred decisions; agree on depth and source constraints.
-2. Search declared scholarly services, verify source identity and inspection depth, and separate source records from claim-level evidence.
+2. Search declared scholarly services only after the gate names the providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Verify source identity and inspection depth, and separate source records from claim-level evidence.
 3. Synthesize supported, conflicting, and missing evidence into a Markdown research artifact; link new records and disclose limitations.
 
 ## Bundled tool execution

package/vendors/claude/commands/research-gap.md

@@ -34,7 +34,7 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 ## Procedure
 
 1. Resolve the research question and section scope against locked/deferred decisions; agree on depth and source constraints.
-2. Search declared scholarly services, verify source identity and inspection depth, and separate source records from claim-level evidence.
+2. Search declared scholarly services only after the gate names the providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Verify source identity and inspection depth, and separate source records from claim-level evidence.
 3. Synthesize supported, conflicting, and missing evidence into a Markdown research artifact; link new records and disclose limitations.
 
 ## Bundled tool execution

package/vendors/claude/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "wtfp",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Portable, evidence-grounded academic research and writing workflows.",
   "author": {
     "name": "akougkas"

package/vendors/claude/roles/research-synthesizer.md

@@ -42,6 +42,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.
 - 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/claude/skills/wtfp-research-literature/references/actions.md

@@ -14,7 +14,7 @@ Contract: [protocol/actions/research-gap.json](../../../actions/research-gap.jso
    - `standard`: run a focused, reproducible search across the most relevant categories;
    - `deep`: map foundational, recent, competing, gap-defining, and methodological work, including important disagreements and intellectual lineage.
 5. Form search questions and inclusion criteria before searching. Record databases or corpora, query strings, date, filters, and stopping rule.
-6. Search authoritative scholarly sources when external research is approved and available. Deduplicate candidates by persistent identifier, then normalized title.
+6. Search authoritative scholarly sources only after disclosing and receiving approval for the external providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Deduplicate candidates by persistent identifier, then normalized title.
 7. Verify each retained source from its primary record or publication. Create a `project://sources/{source}` record with title, creators, year, source kind, identifiers, citation key, status, provenance, inspection depth, and verification time.
 8. Read enough of each source to distinguish its actual claim, method, population, result, and limitation. Do not cite an abstract-only impression as full-paper evidence.
 9. Create `project://evidence/{evidence}` separately for each retained claim-level interpretation, with relation, locator, limitations, confidence, and inspection depth. Synthesize by question rather than listing papers; identify consensus, disagreement, methodological differences, missing evidence, and defensible positioning.

package/vendors/claude/workflows/research-gap.md

@@ -22,7 +22,7 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 ## Procedure
 
 1. Resolve the research question and section scope against locked/deferred decisions; agree on depth and source constraints.
-2. Search declared scholarly services, verify source identity and inspection depth, and separate source records from claim-level evidence.
+2. Search declared scholarly services only after the gate names the providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Verify source identity and inspection depth, and separate source records from claim-level evidence.
 3. Synthesize supported, conflicting, and missing evidence into a Markdown research artifact; link new records and disclose limitations.
 
 ## Bundled tool execution

package/vendors/codex/plugins/wtfp/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wtfp",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Evidence-grounded academic research, planning, writing, review, and delivery workflows.",
   "author": {
     "name": "akougkas",

package/vendors/codex/plugins/wtfp/.wtfp-generated.json

@@ -2,11 +2,11 @@
   "schema": "wtfp.generated-adapter/v1",
   "generatorVersion": 5,
   "target": "codex",
-  "sourceHash": "1e1af2ef70ac9839e13375b442cdfab39948203582e4bf63a3047223ac23ca1c",
+  "sourceHash": "2f0b9bbd18cb05ce2b6638ac631d8be9b8d04b56a102fd4d55b95cec86b06447",
   "files": [
     {
       "path": ".codex-plugin/plugin.json",
-      "sha256": "3534b5fe702c0513c6e74c1ee030c15e4532e880d4695a08427cb37f8f699280"
+      "sha256": "d3a6f7b32d52b514aeee2b87aa156ced48d2ccf4d2aeb9230a3ff2da69165017"
     },
     {
       "path": "actions/add-todo.json",
@@ -122,7 +122,7 @@
     },
     {
       "path": "actions/research-gap.json",
-      "sha256": "61bb44bf5a5dbbaa5e296f69515b65c21a1ce15022f2bafcb4d22df82f0d690c"
+      "sha256": "80659531e18fb60dd46620c8b35aa27ce0f966c467f0d3073ae8c6519084153e"
     },
     {
       "path": "actions/resume-writing.json",
@@ -182,7 +182,7 @@
     },
     {
       "path": "agents/wtfp-research-synthesizer.toml",
-      "sha256": "5dcd64229c6f93120771a60f64110285f4c63d5ef39c9cf3925eb9492b3f71b4"
+      "sha256": "392a1efbbc36f96e2e3f58c7f397a54b1cf76c8f16b71c154013604bc8f52d70"
     },
     {
       "path": "agents/wtfp-section-planner.toml",
@@ -222,7 +222,7 @@
     },
     {
       "path": "plugin.json",
-      "sha256": "30ee228934147fbfbb51a61d7e75673691aa36a99fb1576c41f02fc072a77e6f"
+      "sha256": "6e98cece8176076bc3d1a09b8c02c44ba46c5393f3a837d0feceb91724098d14"
     },
     {
       "path": "project/README.md",
@@ -346,7 +346,7 @@
     },
     {
       "path": "roles/research-synthesizer.md",
-      "sha256": "d04ba72d66f693202b9327aaef82dd47637f1d99349d190149ef82ec43c8be83"
+      "sha256": "011feaa1fdb967c267713f4fa4b0c45b27e66a62f71d1f24c4f44360442aef57"
     },
     {
       "path": "roles/section-planner.md",
@@ -426,7 +426,7 @@
     },
     {
       "path": "skills/wtfp-research-literature/references/actions.md",
-      "sha256": "a7d95b8ab9a647b1742dbce1f561454a53f7829947e748819bd1bef3f2c62828"
+      "sha256": "5a7729f4d2fe816ea2b850f4d6421b293612c0d1719aadbe01817f5fcb11af72"
     },
     {
       "path": "skills/wtfp-research-literature/SKILL.md",
@@ -646,7 +646,7 @@
     },
     {
       "path": "workflows/research-gap.md",
-      "sha256": "c98eb74ae970713affa435e79ba780703694cd1eca0c141bf840ebe67adc3983"
+      "sha256": "a1736edb7e739708a92e5ef11c2d7c7a87fe8e6e4d6586e8ce9b1db3ae5bb428"
     },
     {
       "path": "workflows/resume-writing.md",

package/vendors/codex/plugins/wtfp/actions/research-gap.json

@@ -60,6 +60,7 @@
   ],
   "tools": [
     "bibliography.index",
+    "citation.fetch",
     "citation.rank",
     "citation.scholar-lookup",
     "citation.semantic-scholar"
@@ -95,7 +96,7 @@
     },
     {
       "id": "user.gate",
-      "scope": "research scope and depth"
+      "scope": "the external providers, bounded query set, and research scope and depth"
     }
   ]
 }

package/vendors/codex/plugins/wtfp/agents/wtfp-research-synthesizer.toml

@@ -38,6 +38,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.
 - 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/codex/plugins/wtfp/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "wtfp",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Portable, evidence-grounded academic research and writing workflows.",
   "author": {
     "name": "akougkas"

package/vendors/codex/plugins/wtfp/roles/research-synthesizer.md

@@ -42,6 +42,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.
 - 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/codex/plugins/wtfp/skills/wtfp-research-literature/references/actions.md

@@ -54,7 +54,7 @@ Contract: [protocol/actions/research-gap.json](../../../actions/research-gap.jso
    - `standard`: run a focused, reproducible search across the most relevant categories;
    - `deep`: map foundational, recent, competing, gap-defining, and methodological work, including important disagreements and intellectual lineage.
 5. Form search questions and inclusion criteria before searching. Record databases or corpora, query strings, date, filters, and stopping rule.
-6. Search authoritative scholarly sources when external research is approved and available. Deduplicate candidates by persistent identifier, then normalized title.
+6. Search authoritative scholarly sources only after disclosing and receiving approval for the external providers and bounded query set. When using the bundled dispatcher, `citation-search` may run with `--backend=cite-nexus` and an explicit `--providers` list after this gate. Returned results stay candidates, and this action performs no bibliography write. Deduplicate candidates by persistent identifier, then normalized title.
 7. Verify each retained source from its primary record or publication. Create a `project://sources/{source}` record with title, creators, year, source kind, identifiers, citation key, status, provenance, inspection depth, and verification time.
 8. Read enough of each source to distinguish its actual claim, method, population, result, and limitation. Do not cite an abstract-only impression as full-paper evidence.
 9. Create `project://evidence/{evidence}` separately for each retained claim-level interpretation, with relation, locator, limitations, confidence, and inspection depth. Synthesize by question rather than listing papers; identify consensus, disagreement, methodological differences, missing evidence, and defensible positioning.