wtf-p 0.7.4 → 0.8.0

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"
+    }
+  ]
+}

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

@@ -0,0 +1,116 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "execute-outline",
+  "title": "Execute the outline",
+  "description": "Draft independent section waves in parallel and verify cross-section coherence.",
+  "alias": "wtfp:execute-outline",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-write-section"
+  },
+  "workflow": "wtfp://workflows/execute-outline",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "agent.parallel",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "project://structure/outline defines executable section waves",
+      "Each scheduled section has an approved plan"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://state",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sections/{section}",
+    "project://sections/{section}/plans/{plan}",
+    "project://sections/{section}/summary",
+    "project://sources/{source}",
+    "project://evidence/{evidence}",
+    "project://checkpoints/{checkpoint}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://paper/{artifact}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sections/{section}/summary",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}/summary",
+      "mode": "update"
+    },
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    },
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "section-writer",
+      "mode": "parallel",
+      "purpose": "Draft independent sections within each declared execution wave"
+    },
+    {
+      "role": "coherence-checker",
+      "mode": "required",
+      "purpose": "Check terminology, transitions, argument flow, and duplication after drafting"
+    }
+  ],
+  "tools": [],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://coherence-checker"
+    },
+    {
+      "id": "agent.parallel",
+      "scope": "role://section-writer per outline wave"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}/summary, project://checkpoints/{checkpoint}, project://validations/{validation}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://paper/{artifact}, project://sections/{section}/summary, project://checkpoints/{checkpoint}, project://sections/{section}, project://state"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://config, project://state, project://decisions, project://structure/outline, project://sections/{section}, project://sections/{section}/plans/{plan}, project://sections/{section}/summary, project://sources/{source}, project://evidence/{evidence}, project://checkpoints/{checkpoint}, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "declared manuscript, summary, checkpoint, validation, section, and state resources"
+    },
+    {
+      "id": "user.gate",
+      "scope": "blocking checkpoints between execution waves"
+    }
+  ]
+}

package/vendors/clio-extension/actions/export-latex.json

@@ -0,0 +1,65 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "export-latex",
+  "title": "Export LaTeX",
+  "description": "Export the manuscript and bibliography to portable LaTeX source with declared formatting.",
+  "alias": "wtfp:export-latex",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-deliver-research"
+  },
+  "workflow": "wtfp://workflows/export-latex",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "tool.execute",
+      "user.interaction"
+    ],
+    "conditions": [
+      "Manuscript source is available",
+      "A contained host-provided LaTeX syntax checker or compiler is configured when compilation is requested"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://structure/outline",
+    "project://sources/{source}",
+    "project://evidence/{evidence}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://deliverables/latex/{artifact}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [
+    "bibliography.format",
+    "bibliography.index"
+  ],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://deliverables/latex/{artifact}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://config, project://structure/outline, project://sources/{source}, project://evidence/{evidence}, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "portable LaTeX and bibliography outputs"
+    },
+    {
+      "id": "tool.execute",
+      "scope": "wtfp://tools/bibliography/** through tools/wtfp-tool.js"
+    },
+    {
+      "id": "user.gate",
+      "scope": "venue template and destructive output replacement"
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "help",
+  "title": "Show WTF-P help",
+  "description": "Render the stable WTF-P action reference from the canonical catalog.",
+  "alias": "wtfp:help",
+  "surface": {
+    "kind": "operations",
+    "operation": "product-operations"
+  },
+  "requirements": {
+    "capabilities": [
+      "filesystem.read"
+    ],
+    "conditions": []
+  },
+  "reads": [
+    "protocol://catalog.json",
+    "protocol://actions/{action}.json"
+  ],
+  "produces": [],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.read",
+      "scope": "protocol://catalog.json, protocol://actions/{action}.json"
+    }
+  ]
+}

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

@@ -0,0 +1,61 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "insert-section",
+  "title": "Insert a section",
+  "description": "Insert a newly discovered section while preserving established numbering and dependencies.",
+  "alias": "wtfp:insert-section",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-plan-section"
+  },
+  "workflow": "wtfp://workflows/insert-section",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The insertion point exists in project://structure/outline"
+    ]
+  },
+  "reads": [
+    "project://structure/outline",
+    "project://state",
+    "project://sections/{section}"
+  ],
+  "produces": [
+    {
+      "uri": "project://structure/outline",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://structure/outline, project://sections/{section}, project://state"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://structure/outline, project://sections/{section}, project://state"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://structure/outline, project://state, project://sections/{section}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "section insertion and renumbering"
+    }
+  ]
+}

package/vendors/clio-extension/actions/list-assumptions.json

@@ -0,0 +1,35 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "list-assumptions",
+  "title": "List section assumptions",
+  "description": "Preview the intended approach and assumptions for a section without changing project files.",
+  "alias": "wtfp:list-assumptions",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-plan-section"
+  },
+  "workflow": "wtfp://workflows/list-assumptions",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read"
+    ],
+    "conditions": [
+      "A target section is identifiable"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sections/{section}"
+  ],
+  "produces": [],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://decisions, project://structure/outline, project://sections/{section}"
+    }
+  ]
+}