wtf-p 0.7.3 → 0.8.0

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

package/vendors/clio-extension/actions/map-project.json

@@ -0,0 +1,71 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "map-project",
+  "title": "Map an existing project",
+  "description": "Index existing drafts, data, figures, and references into portable project state.",
+  "alias": "wtfp:map-project",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-start-project"
+  },
+  "workflow": "wtfp://workflows/map-project",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write"
+    ],
+    "conditions": [
+      "The project contains material to inventory"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://state",
+    "project://materials/{artifact}",
+    "project://paper/{artifact}",
+    "project://sources/{source}",
+    "project://evidence/{evidence}"
+  ],
+  "produces": [
+    {
+      "uri": "project://sources/{source}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://evidence/{evidence}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sources/{source}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://evidence/{evidence}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://manifest",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://sources/{source}, project://evidence/{evidence}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://state, project://materials/{artifact}, project://paper/{artifact}, project://sources/{source}, project://evidence/{evidence}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://sources/{source}, project://evidence/{evidence}, project://state, project://manifest"
+    }
+  ]
+}

package/vendors/clio-extension/actions/new-paper.json

@@ -0,0 +1,70 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "new-paper",
+  "title": "Start a new paper",
+  "description": "Interview the researcher and initialize a portable WTF-P project.",
+  "alias": "wtfp:new-paper",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-start-project"
+  },
+  "workflow": "wtfp://workflows/new-paper",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The selected project root is writable",
+      "Existing project state is preserved unless the user approves reuse"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://materials/{artifact}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://manifest",
+      "mode": "create"
+    },
+    {
+      "uri": "project://config",
+      "mode": "create"
+    },
+    {
+      "uri": "project://state",
+      "mode": "create"
+    },
+    {
+      "uri": "project://decisions",
+      "mode": "create"
+    },
+    {
+      "uri": "project://structure/outline",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://manifest, project://config, project://state, project://decisions, project://structure/outline"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://materials/{artifact}, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://manifest, project://config, project://state, project://decisions, project://structure/outline"
+    },
+    {
+      "id": "user.gate",
+      "scope": "project initialization decisions"
+    }
+  ]
+}

package/vendors/clio-extension/actions/pause-writing.json

@@ -0,0 +1,71 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "pause-writing",
+  "title": "Pause writing",
+  "description": "Record an exact context handoff so another session can resume without reconstructing intent.",
+  "alias": "wtfp:pause-writing",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-manage-project"
+  },
+  "workflow": "wtfp://workflows/pause-writing",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write"
+    ],
+    "conditions": [
+      "Portable project state has been initialized"
+    ]
+  },
+  "reads": [
+    "project://state",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sections/{section}",
+    "project://sections/{section}/plans/{plan}",
+    "project://sections/{section}/reviews/{review}",
+    "project://sections/{section}/summary",
+    "project://sections/{section}/handoff",
+    "project://validations/{validation}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://sections/{section}/handoff",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}/handoff",
+      "mode": "update"
+    },
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}/handoff, project://checkpoints/{checkpoint}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://sections/{section}/handoff, project://sections/{section}, project://state"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://state, project://decisions, project://structure/outline, project://sections/{section}, project://sections/{section}/plans/{plan}, project://sections/{section}/reviews/{review}, project://sections/{section}/summary, project://sections/{section}/handoff, project://validations/{validation}, project://paper/{artifact}"
+    }
+  ]
+}

package/vendors/clio-extension/actions/plan-milestone-gaps.json

@@ -0,0 +1,57 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "plan-milestone-gaps",
+  "title": "Plan milestone gap fixes",
+  "description": "Convert milestone audit failures into targeted, verifiable fix plans.",
+  "alias": "wtfp:plan-milestone-gaps",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-review-manuscript"
+  },
+  "workflow": "wtfp://workflows/plan-milestone-gaps",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A milestone audit contains unresolved gaps"
+    ]
+  },
+  "reads": [
+    "project://validations/{validation}",
+    "project://structure/outline",
+    "project://sections/{section}"
+  ],
+  "produces": [
+    {
+      "uri": "project://sections/{section}/plans/{plan}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}/plans/{plan}, project://checkpoints/{checkpoint}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://validations/{validation}, project://structure/outline, project://sections/{section}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "targeted milestone fix plans"
+    },
+    {
+      "id": "user.gate",
+      "scope": "fix priorities and deferred gaps"
+    }
+  ]
+}

package/vendors/clio-extension/actions/plan-revision.json

@@ -0,0 +1,58 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "plan-revision",
+  "title": "Plan a revision",
+  "description": "Turn prioritized review findings into a bounded, testable revision plan.",
+  "alias": "wtfp:plan-revision",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-plan-section"
+  },
+  "workflow": "wtfp://workflows/plan-revision",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "Review issues exist for the selected section"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://decisions",
+    "project://sections/{section}",
+    "project://sections/{section}/plans/{plan}",
+    "project://sections/{section}/reviews/{review}",
+    "project://sections/{section}/summary",
+    "project://validations/{validation}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://sections/{section}/plans/{plan}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}/plans/{plan}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://decisions, project://sections/{section}, project://sections/{section}/plans/{plan}, project://sections/{section}/reviews/{review}, project://sections/{section}/summary, project://validations/{validation}, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://sections/{section}/plans/{plan}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "revision priorities"
+    }
+  ]
+}