wtf-p 0.7.2 → 0.7.4

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/create-slides.md

@@ -3,8 +3,6 @@ description: "Transform the paper's argument, evidence, and findings into an aud
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/create-slides; do not edit. -->
-
 # Create presentation slides
 
 @${pluginRoot}/project/README.md
@@ -22,9 +20,9 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 
 ## Procedure
 
-1. Confirm audience, duration, format, and speaking goal, following the confirmation list in `${pluginRoot}/templates/slides.md`.
+1. Confirm audience, duration, format, speaking goal, and the exact speaker, affiliation, and venue metadata, following the confirmation list in `${pluginRoot}/templates/slides.md`. Never invent missing metadata; leave a visible placeholder.
 1a. Derive the slide count from the confirmed duration using the budget table in `${pluginRoot}/templates/slides.md`, not from the manuscript's section count.
-2. Build a narrative arc from supported manuscript claims and include citations or attribution where needed.
+2. Build a narrative arc from supported manuscript claims only, running the evidence gate in `${pluginRoot}/templates/slides.md`: refuse every statement, comparison, or figure without a cited source record, manuscript passage, or named project file, and derive each diagram from named source files or documents with their paths stated on the slide.
 3. Write slide source and assets under the declared deliverable URI; preview before replacing an existing deliverable. This action produces slide source, not a rendered deck: WTF-P declares no rendering effect and runs no renderer. If the author asks for a rendered artifact, return a labeled handoff naming the exact command they can run in their own toolchain.
 
 ## Safety and completion
@@ -53,3 +51,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/create-slides; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/discuss-section.md

@@ -3,8 +3,6 @@ description: "Capture the researcher's intended purpose, essential content, voic
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/discuss-section; do not edit. -->
-
 # Discuss a section
 
 @${pluginRoot}/project/README.md
@@ -58,3 +56,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/discuss-section; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/execute-outline.md

@@ -3,8 +3,6 @@ description: "Draft independent section waves in parallel and verify cross-secti
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/execute-outline; do not edit. -->
-
 # Execute the outline
 
 @${pluginRoot}/project/README.md
@@ -71,4 +69,8 @@ Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-section-writer`, `wtfp-coherence-checker`. 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/execute-outline; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/export-latex.md

@@ -3,8 +3,6 @@ description: "Export the manuscript and bibliography to portable LaTeX source wi
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/export-latex; do not edit. -->
-
 # Export LaTeX
 
 @${pluginRoot}/project/README.md
@@ -68,3 +66,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/export-latex; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/help.md

@@ -3,10 +3,8 @@ description: "Render the stable WTF-P action reference from the canonical catalo
 display-only: true
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/help; do not edit. -->
-
 ```text
-WTF-P 0.7.2 on Clio Coder: evidence-grounded academic writing
+WTF-P 0.7.4 on Clio Coder: evidence-grounded academic writing
 
 Start here
   /wtfp:new-paper [input]
@@ -117,3 +115,5 @@ Fleets (clio-coder fleet run <fleet> --var section=<section>; explicit fleet pri
 Each action reads .planning/ records and paper/ artifacts, asks before any gated write, and never runs Git or publishes.
 An unavailable action fails closed with WTFP_ACTION_UNAVAILABLE and returns a manual handoff instead.
 ```
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/help; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/insert-section.md

@@ -3,8 +3,6 @@ description: "Insert a newly discovered section while preserving established num
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/insert-section; do not edit. -->
-
 # Insert a section
 
 @${pluginRoot}/project/README.md
@@ -54,3 +52,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/insert-section; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/list-assumptions.md

@@ -3,8 +3,6 @@ description: "Preview the intended approach and assumptions for a section withou
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/list-assumptions; do not edit. -->
-
 # List section assumptions
 
 @${pluginRoot}/project/README.md
@@ -52,3 +50,5 @@ Treat the following text as the user-supplied input for this action. Preserve it
 <invocation_arguments>
 $ARGUMENTS
 </invocation_arguments>
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/list-assumptions; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/map-project.md

@@ -3,8 +3,6 @@ description: "Index existing drafts, data, figures, and references into portable
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/map-project; do not edit. -->
-
 # Map an existing project
 
 @${pluginRoot}/project/README.md
@@ -54,3 +52,5 @@ Treat the following text as the user-supplied input for this action. Preserve it
 <invocation_arguments>
 $ARGUMENTS
 </invocation_arguments>
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/map-project; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/new-paper.md

@@ -3,8 +3,6 @@ description: "Interview the researcher and initialize a portable WTF-P project."
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/new-paper; do not edit. -->
-
 # Start a new paper
 
 @${pluginRoot}/project/README.md
@@ -63,3 +61,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/new-paper; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/pause-writing.md

@@ -3,8 +3,6 @@ description: "Record an exact context handoff so another session can resume with
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/pause-writing; do not edit. -->
-
 # Pause writing
 
 @${pluginRoot}/project/README.md
@@ -56,3 +54,5 @@ Treat the following text as the user-supplied input for this action. Preserve it
 <invocation_arguments>
 $ARGUMENTS
 </invocation_arguments>
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/pause-writing; do not edit. -->

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

@@ -3,8 +3,6 @@ description: "Convert milestone audit failures into targeted, verifiable fix pla
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/plan-milestone-gaps; do not edit. -->
-
 # Plan milestone gap fixes
 
 @${pluginRoot}/project/README.md
@@ -56,3 +54,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/plan-milestone-gaps; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/plan-revision.md

@@ -3,8 +3,6 @@ description: "Turn prioritized review findings into a bounded, testable revision
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/plan-revision; do not edit. -->
-
 # Plan a revision
 
 @${pluginRoot}/project/README.md
@@ -56,3 +54,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/plan-revision; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/plan-section.md

@@ -3,8 +3,6 @@ description: "Create and independently check a detailed writing plan for one sec
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/plan-section; do not edit. -->
-
 # Plan a section
 
 @${pluginRoot}/project/README.md
@@ -25,8 +23,9 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 1. Resolve one section record, load its linked context, research, evidence, decisions, and outline constraints, and enumerate the bounded `project://validations/*` collection before any specialist dispatch.
 2. Filter those records to candidates whose `subject_uri` is exactly `project://structure/outline` and whose `action_id` is exactly `create-outline`. A candidate is current only when `executed_at >= outline.updated_at`. Because the v1 validation schema carries no outline revision or content hash, disclose that this timestamp test is a conservative freshness proxy.
 3. Require exactly one current candidate and require its `status` to be `passed`. Separately verify that the current outline and target section are consistent with all current locked and deferred author choices: honor locked choices and do not treat deferred choices as resolved. A missing, stale, ambiguous, or non-passing candidate, or a decision contradiction, blocks all specialist dispatch and every plan, section, state, or validation write. Only a recovery checkpoint may be proposed on this blocked path, and it may be written only after a complete record preview and explicit author approval.
-4. Only after those prerequisites pass, delegate a bounded plan to `section-planner`, then require a fresh `plan-checker` pass over claim coverage, dependencies, file scope, citations, and decision fidelity.
-5. At confirm_plan, preview the plan and validation; on approval link the plan, update section status to planned, and reconcile state. Create a checkpoint for unresolved judgment instead of bypassing the required checker.
+4. For a literature-heavy section, first require a section-specific research artifact plus resolvable source/evidence records that cover the planned claims. If they are absent or insufficient, run `research-gap` with the configured CiteNexus backend when available, verify candidate metadata against the returned records, and stop planning with an explicit research checkpoint if evidence remains insufficient. Never invent citations or treat search candidates as verified sources.
+5. Only after those prerequisites pass, delegate a bounded plan to `section-planner`, then require a fresh `plan-checker` pass over claim coverage, dependencies, file scope, citations, and decision fidelity. Dispatch the exact WTF-P specialist roles; generic coder and verifier roles do not satisfy this workflow.
+6. At confirm_plan, preview the plan and validation; on approval link the plan, update section status to planned, and reconcile state. Create a checkpoint for unresolved judgment instead of bypassing the required checker.
 
 ## Safety and completion
 
@@ -73,4 +72,8 @@ Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-section-planner`, `wtfp-plan-checker`. 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/plan-section; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/polish-prose.md

@@ -3,8 +3,6 @@ description: "Improve clarity, flow, precision, and academic voice without chang
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/polish-prose; do not edit. -->
-
 # Polish prose
 
 @${pluginRoot}/project/README.md
@@ -59,4 +57,8 @@ Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-prose-polisher`. 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/polish-prose; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/progress.md

@@ -3,8 +3,6 @@ description: "Summarize writing progress, surface blockers, and recommend the ne
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/progress; do not edit. -->
-
 # Show project progress
 
 @${pluginRoot}/project/README.md
@@ -68,3 +66,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/progress; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/quick.md

@@ -3,8 +3,6 @@ description: "Apply a small, bounded writing fix with minimal planning overhead
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/quick; do not edit. -->
-
 # Make a quick writing change
 
 @${pluginRoot}/project/README.md
@@ -59,4 +57,8 @@ Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-section-writer`. 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/quick; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/remove-section.md

@@ -2,8 +2,6 @@
 description: "Remove an unwritten future section and repair numbering and dependencies."
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/remove-section; do not edit. -->
-
 WTFP_ACTION_UNAVAILABLE
 
 Action: `remove-section`
@@ -13,3 +11,5 @@ Unavailable effects: `filesystem.delete`
 
 No workflow, tool, network request, package operation, external issue, VCS operation, or other effect ran.
 Safe alternative: preserve project state and return a manual, non-executed handoff for the requested operation.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/remove-section; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/report-bug.md

@@ -2,8 +2,6 @@
 description: "Collect a reproducible bug report and publish it only after explicit user approval."
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/report-bug; do not edit. -->
-
 WTFP_ACTION_UNAVAILABLE
 
 Action: `report-bug`
@@ -13,3 +11,5 @@ Unavailable effects: `external.issue`
 
 No workflow, tool, network request, package operation, external issue, VCS operation, or other effect ran.
 Safe alternative: preserve project state and return a manual, non-executed handoff for the requested operation.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/report-bug; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/request-feature.md

@@ -2,8 +2,6 @@
 description: "Shape a concrete feature request and publish it only after explicit user approval."
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/request-feature; do not edit. -->
-
 WTFP_ACTION_UNAVAILABLE
 
 Action: `request-feature`
@@ -13,3 +11,5 @@ Unavailable effects: `external.issue`
 
 No workflow, tool, network request, package operation, external issue, VCS operation, or other effect ran.
 Safe alternative: preserve project state and return a manual, non-executed handoff for the requested operation.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/request-feature; do not edit. -->

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

@@ -3,8 +3,6 @@ description: "Synthesize literature, domain conventions, open gaps, and defensib
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/research-gap; do not edit. -->
-
 # Research a section gap
 
 @${pluginRoot}/project/README.md
@@ -23,7 +21,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 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.
+2. Prefer an operator-configured, trusted read-only CiteNexus MCP connection for bounded public metadata searches when the host has already authorized it. In an explicitly selected full-auto host session for this research action, the bundled CiteNexus dispatcher may also search the free no-key public indexes `crossref`, `datacite`, `europe_pmc`, and `arxiv` without a second per-query author gate; use only selected relevant indexes with an explicit `--providers` list. Record provider IDs, queries, date, and result limits; never send unpublished manuscript text or private notes as search terms. For any other route, first obtain explicit author approval naming the providers and bounded query set. Results remain 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
@@ -34,7 +32,7 @@ The declared `tool.execute` effect authorises exactly one command, run from the
 node ${pluginRoot}/tools/wtfp-tool.js [--offline] <command> [arguments]
 ```
 
-Run it with `list` first to read the declared commands, their arguments, their bounds, and the effects each one applies; `${pluginRoot}/tools/README.md` carries the same table. A command whose effects include `network.*` performs outbound requests. Until network use has been approved for this run, pass `--offline` (or set `WTFP_TOOL_OFFLINE=1`), which makes the dispatcher refuse those commands instead of relying on prose restraint. Never execute another module in this package, never pass a logical `project://` or `wtfp://` URI as a shell argument, and treat every returned record as candidate evidence until it is verified and written to a source or evidence record.
+Run it with `list` first to read the declared commands, their arguments, their bounds, and the effects each one applies; `${pluginRoot}/tools/README.md` carries the same table. A command whose effects include `network.*` performs outbound requests. Pass `--offline` (or set `WTFP_TOOL_OFFLINE=1`) until the provider/query gate is approved, except for this action's explicit full-auto public-index route. On that route omit `--offline` only for `citation-search --backend=cite-nexus` with bounded queries and `--providers` drawn from `crossref,datacite,europe_pmc,arxiv`; never override an operator-set offline flag or a host refusal. Never execute another module in this package, never pass a logical `project://` or `wtfp://` URI as a shell argument, and treat every returned record as candidate evidence until it is verified and written to a source or evidence record.
 
 ## Safety and completion
 
@@ -73,6 +71,14 @@ $ARGUMENTS
 
 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.
 
+## Clio CiteNexus binding
+
+In full-auto, the main agent first calls `gateway(op="find", query="cite-nexus")`. If a CiteNexus server is present and its tools are admitted as read-class through the operator's user configuration, call `gateway(op="describe", capability="<search-papers capability>")`, then `gateway(op="call", capability="<search-papers capability>", args={...})` with bounded public metadata queries. Use the capability name and argument schema returned by the gateway, not a guessed name. MCP connections are session-owned and unavailable in delegated workers, so pass the returned candidates and provenance to `wtfp-research-synthesizer` instead of asking that worker to discover the MCP server. This user-configured read connection is prior authorization for those searches; do not call `ask_user` again for each query. If no read-class CiteNexus connection is available and no gateway call has been refused, full-auto may instead run the bundled `citation-search --backend=cite-nexus` through its declared dispatcher with bounded public queries and an explicit `--providers` list containing only `crossref`, `datacite`, `europe_pmc`, or `arxiv`; pass those candidates to the same specialist. An operator-set offline flag, unavailable companion, or host refusal stops this route. Other providers and modes follow the declared user gate. Never bypass a gateway refusal by rerunning the same denied request through `bash`. Record the exact provider IDs, queries, limits, date, and provenance; verify each retained candidate before citing it.
+
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-research-synthesizer`. 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/research-gap; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/resume-writing.md

@@ -3,8 +3,6 @@ description: "Restore the latest portable handoff and route the researcher to th
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/resume-writing; do not edit. -->
-
 # Resume writing
 
 @${pluginRoot}/project/README.md
@@ -66,3 +64,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/resume-writing; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/review-section.md

@@ -3,8 +3,6 @@ description: "Review a drafted section for evidence, citations, coherence, requi
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/review-section; do not edit. -->
-
 # Review a section
 
 @${pluginRoot}/project/README.md
@@ -64,4 +62,8 @@ Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-section-reviewer`. 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/review-section; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/settings.md

@@ -3,8 +3,6 @@ description: "View and update portable project settings after presenting the exa
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/settings; do not edit. -->
-
 # Manage project settings
 
 @${pluginRoot}/project/README.md
@@ -50,3 +48,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/settings; do not edit. -->

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

@@ -3,8 +3,6 @@ description: "Archive a completed draft or submission round with its reproducibl
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/submit-milestone; do not edit. -->
-
 # Archive a milestone
 
 @${pluginRoot}/project/README.md
@@ -66,3 +64,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/submit-milestone; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/update.md

@@ -2,8 +2,6 @@
 description: "Check for a newer compatible package or plugin release and install it only after approval."
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/update; do not edit. -->
-
 WTFP_ACTION_UNAVAILABLE
 
 Action: `update`
@@ -13,3 +11,5 @@ Unavailable effects: `package.update`
 
 No workflow, tool, network request, package operation, external issue, VCS operation, or other effect ran.
 Safe alternative: preserve project state and return a manual, non-executed handoff for the requested operation.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/update; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/verify-work.md

@@ -3,8 +3,6 @@ description: "Test a drafted section against each plan requirement and record ev
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/verify-work; do not edit. -->
-
 # Verify written work
 
 @${pluginRoot}/project/README.md
@@ -56,3 +54,5 @@ $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.
+
+<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/verify-work; do not edit. -->

package/vendors/plugin/ai.iowarp.clio/prompts/wtfp/write-section.md

@@ -3,8 +3,6 @@ description: "Execute an approved section plan, update state, and optionally ver
 argument-hint: "[arguments]"
 ---
 
-<!-- Generated by WTF-P adapter compiler v5 from protocol/actions/write-section; do not edit. -->
-
 # Write a section
 
 @${pluginRoot}/project/README.md
@@ -23,7 +21,7 @@ Manuscript prose and supporting context, research, plan, review, summary, handof
 ## Procedure
 
 1. Require one approved plan and resolve all linked context, research, source/evidence records, decisions, prior summary, existing target, and necessary neighboring prose before choosing create or update.
-2. Draft only the declared manuscript artifact; cite only resolvable sources, preserve author constraints, and stop at blocking decisions.
+2. Before drafting a literature-heavy section, verify that its linked research artifact and source/evidence records cover the plan's factual claims. If coverage is missing, use the declared research workflow and pause at a checkpoint until verified records exist. Draft only the declared manuscript artifact; cite only resolvable sources, preserve author constraints, and stop at blocking decisions. A plausible bibliography entry, search candidate, or model memory is not a verified citation.
 3. Read the persisted manuscript text back and calculate its actual body word count with one deterministic method; never copy a worker self-report, plan target, or summary count into project records. Validate the persisted draft against its plan and word budget.
 4. Create or update the required Markdown summary with that measured count, then read back both manuscript and summary. Missing, empty, or inconsistent output is a failed completion condition, not permission to link a path that does not exist.
 5. Persist the validation, synchronize the manuscript URI in `manifest.artifacts.manuscripts`, and reconcile section/state records only after manuscript, summary, and validation readback succeeds. If blocked, create the declared checkpoint and stop; do not commit or merge automatically.
@@ -73,4 +71,8 @@ Call `ask_user` whenever this workflow reaches a declared `user.gate`; only the
 
 ## Clio role-result binding
 
+Dispatch the declared specialist roles using these exact Clio agent IDs: `wtfp-section-writer`, `wtfp-argument-verifier`. 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/write-section; do not edit. -->

package/vendors/plugin/plugin.json

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

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

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

@@ -52,7 +52,7 @@ Contract: [protocol/actions/create-slides.json](../../../actions/create-slides.j
 1. Require project identity and enough manuscript or verified results to support a presentation.
 2. Ask for duration, expected slide count, audience, occasion, delivery format, visual style, and desired emphasis.
 3. Derive a timed narrative: audience problem, thesis, minimum background, method, strongest evidence, limitations, implications, and closing takeaway. Allocate time and slides before writing.
-4. Use verified project claims and cite source or manuscript locations in speaker notes or a references slide. Do not introduce novel results to make the story cleaner.
+4. Use verified project claims and cite source or manuscript locations in speaker notes or a references slide. Do not introduce novel results to make the story cleaner. Refuse any claim without a ledger row, never invent speaker or venue metadata, and derive diagrams only from named source files or documents with stated paths.
 5. Prefer one communicative purpose per slide. Use concise text, readable type, high contrast, descriptive titles, accessible color, and alt text or equivalent descriptions for meaningful visuals.
 6. Use existing figures only when provenance and interpretation are known. Mark placeholders and data needs explicitly; never fabricate a chart.
 7. Generate editable slide source and a delivery manifest under `project://deliverables/slides/{artifact}`.
@@ -65,11 +65,11 @@ Completion requires an audience-appropriate editable deck with an honest render
 
 Contract: [protocol/actions/create-poster.json](../../../actions/create-poster.json)
 
-1. Require project identity and verified manuscript findings. Ask for dimensions, orientation, venue rules, audience viewing distance, title, authors, affiliations, contact details, output format, and available visuals.
+1. Require project identity and verified manuscript findings. Ask for dimensions, orientation, venue rules, audience viewing distance, title, authors, affiliations, contact details, output format, and available visuals. Never invent missing metadata; leave a visible placeholder and report it.
 2. Define a non-linear reading hierarchy: one-sentence takeaway, motivation, minimal method, principal evidence, limitations, conclusion, and contact or artifact link.
 3. Budget physical space before writing. Prioritize the title, takeaway, and strongest figure; avoid shrinking prose to preserve excess content.
-4. Use verified claims, values, citations, and figures. Record provenance and include accessible descriptions. Mark missing visuals as placeholders rather than generating false evidence.
-5. Generate editable poster source and a delivery manifest under `project://deliverables/poster/{artifact}`.
+4. Use verified claims, values, citations, and figures, recorded in the claim ledger from `protocol://templates/poster.md`; refuse any statement without a source record, manuscript passage, or named project file. Derive diagrams only from named source files or documents and state their paths. Record provenance and include accessible descriptions. Mark missing visuals as placeholders rather than generating false evidence.
+5. Generate editable, laid-out poster source (the template's HTML grid or the venue's mandated template) and a delivery manifest with the claim ledger under `project://deliverables/poster/{artifact}`.
 6. Check dimensions, orientation, margins, font sizes at final scale, column flow, contrast, image resolution, citation legibility, link or code targets, and overflow.
 7. Render only when requested and a configured host-provided local renderer exists; invoke it under the action's declared `tool.execute` effect and verify the actual artifact dimensions. Distinguish source validity from render success.
 8. Report source and rendered paths, validation results, print-service considerations, and unresolved manual steps.

package/vendors/plugin/skills/wtfp-plan-section/references/actions.md

@@ -62,7 +62,7 @@ Contract: [protocol/actions/plan-section.json](../../../actions/plan-section.jso
 2. Read the complete planning context before decomposing work: manifest, config, state, decisions, outline, section record, context, research, source/evidence records, relevant prior summaries, and the bounded `project://validations/*` collection.
 3. Before any specialist dispatch, filter the validation records to candidates whose `subject_uri` is exactly `project://structure/outline` and whose `action_id` is exactly `create-outline`. A candidate is current only when `executed_at >= outline.updated_at`. Because the v1 validation schema carries no outline revision or content hash, disclose that this timestamp test is a conservative freshness proxy.
 4. Require exactly one current candidate and require its `status` to be `passed`. Separately verify that the current outline and target section are consistent with all current locked and deferred author choices: honor locked choices and do not treat deferred choices as resolved. A missing, stale, ambiguous, or non-passing candidate, or a decision contradiction, blocks all specialist dispatch and every plan, section, state, or validation write. Only a recovery checkpoint may be proposed on this blocked path, and it may be written only after a complete record preview and explicit author approval.
-5. If the section is literature-heavy and research obligations remain empty, offer `research-gap`; do not manufacture citations to keep planning moving.
+5. If the section is literature-heavy, require a section-specific research artifact and resolvable source/evidence records for its planned claims before dispatch or approval. Run `research-gap` with the configured CiteNexus backend when available; if coverage remains insufficient, record a research checkpoint and stop. Search candidates alone are not verified citations. Do not manufacture citations to keep planning moving.
 6. Summarize the section goal, claims, evidence, manuscript artifact, dependencies, and open decisions at `config.gates.confirm_plan`.
 7. After the prerequisites pass, require `section-planner` in a bounded delegated pass to create one or more immutable Markdown `project://sections/{section}/plans/{plan}` artifacts. Each plan must declare:
    - stable section and plan identifiers;

package/vendors/plugin/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 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.
+6. Search authoritative scholarly sources with bounded queries. Two routes need no second per-query author gate: a host connection the operator already configured and authorized for read-only public scholarly metadata search, or the bundled CiteNexus dispatcher in a host session explicitly set to full-auto for this research action when every selected provider is a free, no-key public index (`crossref`, `datacite`, `europe_pmc`, or `arxiv`). Record provider IDs, query strings, date, and result limits in the research artifact. Do not send unpublished manuscript text, private notes, or credentials as search terms. Outside those routes, first disclose the providers and bounded query set and obtain explicit author approval. The dispatcher runs only `citation-search --backend=cite-nexus` with an explicit `--providers` list; honor an operator-set offline flag or any host refusal. 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/plugin/skills/wtfp-write-section/references/actions.md

@@ -8,7 +8,7 @@ Contract: [protocol/actions/write-section.json](../../../actions/write-section.j
 
 1. Require an exact `project://sections/{section}/plans/{plan}` artifact linked from `project://sections/{section}` and verify its declared inputs, outputs, dependencies, validation, and approval state.
 2. If a corresponding summary or manuscript output exists, show the overwrite or merge impact and require explicit re-execution approval.
-3. Read the plan, `project://manifest`, `project://state`, `project://decisions`, `project://structure/outline`, section context and research, relevant source/evidence records, and enough neighboring prose to maintain continuity.
+3. Read the plan, `project://manifest`, `project://state`, `project://decisions`, `project://structure/outline`, section context and research, relevant source/evidence records, and enough neighboring prose to maintain continuity. For a literature-heavy section, require research and verified source/evidence coverage of the plan's factual claims before drafting. Route missing coverage through `research-gap` and a checkpoint; do not substitute model memory or search candidates for source records.
 4. Present the plan objective, output path, target words, evidence obligations, and checkpoints at the configured writing gate.
 5. Execute tasks in order against the exact `project://paper/{artifact}` output. For each task:
    - establish the paragraph or subsection's rhetorical job;