wtf-p 0.7.3 → 0.8.0

package/vendors/clio-extension/actions/audit-milestone.json

@@ -0,0 +1,63 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "audit-milestone",
+  "title": "Audit a milestone",
+  "description": "Run readiness checks across section completion, arguments, length, citations, and reviews.",
+  "alias": "wtfp:audit-milestone",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-review-manuscript"
+  },
+  "workflow": "wtfp://workflows/audit-milestone",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "tool.execute",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A draft and its project state are available"
+    ]
+  },
+  "reads": [
+    "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}"
+  ],
+  "produces": [
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [
+    "bibliography.index"
+  ],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://validations/{validation}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "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}"
+    },
+    {
+      "id": "tool.execute",
+      "scope": "wtfp://tools/bibliography/index through tools/wtfp-tool.js"
+    },
+    {
+      "id": "user.gate",
+      "scope": "audit exceptions and missing evidence"
+    }
+  ]
+}

package/vendors/clio-extension/actions/check-refs.json

@@ -0,0 +1,80 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "check-refs",
+  "title": "Check references",
+  "description": "Audit citation integrity and emit a validated corrected-bibliography candidate without mutating source records or manuscript inputs.",
+  "alias": "wtfp:check-refs",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-research-literature"
+  },
+  "workflow": "wtfp://workflows/check-refs",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "network.search",
+      "tool.execute",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A bibliography and at least one manuscript source are available"
+    ]
+  },
+  "reads": [
+    "project://config",
+    "project://sources/{source}",
+    "project://evidence/{evidence}",
+    "project://materials/{artifact}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://deliverables/bibliography/{artifact}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "citation-formatter",
+      "mode": "required",
+      "purpose": "Cross-reference in-text citations and validate bibliography metadata"
+    }
+  ],
+  "tools": [
+    "bibliography.format",
+    "bibliography.index",
+    "citation.fetch"
+  ],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://citation-formatter"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://deliverables/bibliography/{artifact}, project://validations/{validation}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://config, project://sources/{source}, project://evidence/{evidence}, project://materials/{artifact}, project://paper/{artifact}"
+    },
+    {
+      "id": "network.search",
+      "scope": "bounded queries against declared citation metadata providers"
+    },
+    {
+      "id": "tool.execute",
+      "scope": "declared bibliography and citation tools through tools/wtfp-tool.js"
+    },
+    {
+      "id": "user.gate",
+      "scope": "the external providers, bounded query set, and corrected-candidate generation"
+    }
+  ]
+}

package/vendors/clio-extension/actions/check-todos.json

@@ -0,0 +1,52 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "check-todos",
+  "title": "Review todos",
+  "description": "Review pending tasks and explicitly act on, defer, complete, or dismiss each one.",
+  "alias": "wtfp:check-todos",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-manage-project"
+  },
+  "workflow": "wtfp://workflows/check-todos",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "Portable project state has been initialized"
+    ]
+  },
+  "reads": [
+    "project://state",
+    "project://checkpoints/{checkpoint}"
+  ],
+  "produces": [
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.modify",
+      "scope": "project://checkpoints/{checkpoint}, project://state"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://state, project://checkpoints/{checkpoint}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "disposition of each pending todo"
+    }
+  ]
+}

package/vendors/clio-extension/actions/checkpoint.json

@@ -0,0 +1,76 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "checkpoint",
+  "title": "Manage checkpoints",
+  "description": "Save, list, or restore an exact portable paper-state checkpoint.",
+  "alias": "wtfp:checkpoint",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-manage-project"
+  },
+  "workflow": "wtfp://workflows/checkpoint",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "Portable project state has been initialized"
+    ]
+  },
+  "reads": [
+    "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}"
+  ],
+  "produces": [
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://archives/checkpoints/{checkpoint}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://archives/recovery/{artifact}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://manifest",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://checkpoints/{checkpoint}, project://archives/checkpoints/{checkpoint}, project://archives/recovery/{artifact}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "declared project records and authored artifacts selected for the snapshot"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://manifest, project://state, and only snapshot-declared resources during an authorized restore"
+    },
+    {
+      "id": "user.gate",
+      "scope": "checkpoint restore and replacement"
+    }
+  ]
+}

package/vendors/clio-extension/actions/contribute.json

@@ -0,0 +1,57 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "contribute",
+  "title": "Contribute to WTF-P",
+  "description": "Guide a bounded WTF-P contribution from branch creation through a reviewable change request.",
+  "alias": "wtfp:contribute",
+  "surface": {
+    "kind": "operations",
+    "operation": "product-operations"
+  },
+  "requirements": {
+    "capabilities": [
+      "external.issue",
+      "filesystem.read",
+      "network.fetch",
+      "user.interaction",
+      "vcs.branch",
+      "vcs.commit"
+    ],
+    "conditions": [
+      "The user has selected a repository and explicitly requested contribution guidance"
+    ]
+  },
+  "reads": [
+    "package://contributing",
+    "project://materials/{artifact}"
+  ],
+  "produces": [],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "external.issue",
+      "scope": "the selected repository change-request service"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "package://contributing, project://materials/{artifact}"
+    },
+    {
+      "id": "network.fetch",
+      "scope": "selected repository metadata"
+    },
+    {
+      "id": "user.gate",
+      "scope": "branch, commit, publication, and change-request decisions"
+    },
+    {
+      "id": "vcs.branch",
+      "scope": "selected contribution repository"
+    },
+    {
+      "id": "vcs.commit",
+      "scope": "user-approved contribution changes"
+    }
+  ]
+}

package/vendors/clio-extension/actions/create-outline.json

@@ -0,0 +1,84 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "create-outline",
+  "title": "Create the paper outline",
+  "description": "Build the section structure, argument map, dependencies, and word budgets.",
+  "alias": "wtfp:create-outline",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-start-project"
+  },
+  "workflow": "wtfp://workflows/create-outline",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "Portable project state has been initialized"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://state",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sources/{source}",
+    "project://evidence/{evidence}"
+  ],
+  "produces": [
+    {
+      "uri": "project://structure/outline",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://decisions",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    },
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "outliner",
+      "mode": "required",
+      "purpose": "Design a coherent section and argument structure from the project evidence"
+    }
+  ],
+  "tools": [],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://outliner"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}, project://validations/{validation}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://config, project://state, project://decisions, project://structure/outline, project://sources/{source}, project://evidence/{evidence}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://structure/outline, project://sections/{section}, project://decisions, project://state, project://validations/{validation}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "project://structure/outline, project://sections/{section}, project://decisions, project://state, project://validations/{validation}"
+    }
+  ]
+}

package/vendors/clio-extension/actions/create-poster.json

@@ -0,0 +1,54 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "create-poster",
+  "title": "Create a research poster",
+  "description": "Transform the paper's argument, methods, and findings into a concise academic poster.",
+  "alias": "wtfp:create-poster",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-deliver-research"
+  },
+  "workflow": "wtfp://workflows/create-poster",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A sufficiently complete paper or milestone is available",
+      "A contained host-provided poster renderer is configured when rendering is requested"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://structure/outline",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://deliverables/poster/{artifact}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://deliverables/poster/{artifact}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://structure/outline, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "poster source and generated assets"
+    },
+    {
+      "id": "user.gate",
+      "scope": "poster format and content emphasis"
+    }
+  ]
+}

package/vendors/clio-extension/actions/create-slides.json

@@ -0,0 +1,54 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "create-slides",
+  "title": "Create presentation slides",
+  "description": "Transform the paper's argument, evidence, and findings into an audience-appropriate presentation.",
+  "alias": "wtfp:create-slides",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-deliver-research"
+  },
+  "workflow": "wtfp://workflows/create-slides",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A sufficiently complete paper or milestone is available",
+      "A contained host-provided slide renderer is configured when rendering is requested"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://structure/outline",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://deliverables/slides/{artifact}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://deliverables/slides/{artifact}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://structure/outline, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "slide source and generated assets"
+    },
+    {
+      "id": "user.gate",
+      "scope": "audience, duration, and presentation format"
+    }
+  ]
+}

package/vendors/clio-extension/actions/discuss-section.json

@@ -0,0 +1,76 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "discuss-section",
+  "title": "Discuss a section",
+  "description": "Capture the researcher's intended purpose, essential content, voice, and boundaries before planning.",
+  "alias": "wtfp:discuss-section",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-plan-section"
+  },
+  "workflow": "wtfp://workflows/discuss-section",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A target section is identifiable"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sections/{section}",
+    "project://sections/{section}/context",
+    "project://sections/{section}/summary"
+  ],
+  "produces": [
+    {
+      "uri": "project://sections/{section}/context",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}/context",
+      "mode": "update"
+    },
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://decisions",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}/context, project://checkpoints/{checkpoint}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://decisions, project://sections/{section}, project://sections/{section}/context"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://decisions, project://structure/outline, project://sections/{section}, project://sections/{section}/context, project://sections/{section}/summary"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "declared discussion records"
+    },
+    {
+      "id": "user.gate",
+      "scope": "section intent and boundaries"
+    }
+  ]
+}