wtf-p 0.7.4 → 0.8.0

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

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

@@ -0,0 +1,100 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "plan-section",
+  "title": "Plan a section",
+  "description": "Create and independently check a detailed writing plan for one section.",
+  "alias": "wtfp:plan-section",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-plan-section"
+  },
+  "workflow": "wtfp://workflows/plan-section",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A target section exists in project://structure/outline and has a matching v1 section record",
+      "Exactly one applicable current validation exists with subject_uri project://structure/outline, action_id create-outline, and executed_at greater than or equal to the outline updated_at, and that validation has status passed",
+      "project://structure/outline and the target project://sections/{section} record are consistent with all current locked and deferred choices in project://decisions"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://state",
+    "project://decisions",
+    "project://structure/outline",
+    "project://validations/*",
+    "project://sections/{section}",
+    "project://sections/{section}/context",
+    "project://sections/{section}/research",
+    "project://sections/{section}/summary",
+    "project://sources/{source}",
+    "project://evidence/{evidence}"
+  ],
+  "produces": [
+    {
+      "uri": "project://sections/{section}/plans/{plan}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "section-planner",
+      "mode": "required",
+      "purpose": "Create an executable plan grounded in project intent and evidence"
+    },
+    {
+      "role": "plan-checker",
+      "mode": "required",
+      "purpose": "Check plan completeness, traceability, and feasibility before approval"
+    }
+  ],
+  "tools": [],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://section-planner, role://plan-checker"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}/plans/{plan}, project://validations/{validation}, project://checkpoints/{checkpoint}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://sections/{section}, project://state"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://config, project://state, project://decisions, project://structure/outline, project://validations/*, project://sections/{section}, project://sections/{section}/context, project://sections/{section}/research, project://sections/{section}/summary, project://sources/{source}, project://evidence/{evidence}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://sections/{section}/plans/{plan}, project://validations/{validation}, project://checkpoints/{checkpoint}, project://sections/{section}, project://state"
+    },
+    {
+      "id": "user.gate",
+      "scope": "plan approval, verifier exceptions, and recovery checkpoint approval after complete preview"
+    }
+  ]
+}

package/vendors/clio-extension/actions/polish-prose.json

@@ -0,0 +1,69 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "polish-prose",
+  "title": "Polish prose",
+  "description": "Improve clarity, flow, precision, and academic voice without changing supported claims.",
+  "alias": "wtfp:polish-prose",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-review-manuscript"
+  },
+  "workflow": "wtfp://workflows/polish-prose",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The selected prose target exists"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://decisions",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://paper/{artifact}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "prose-polisher",
+      "mode": "required",
+      "purpose": "Revise prose while preserving factual content, citations, and author voice"
+    }
+  ],
+  "tools": [],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://prose-polisher"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://validations/{validation}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://config, project://decisions, project://paper/{artifact}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "proposed substantive changes"
+    }
+  ]
+}

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

@@ -0,0 +1,51 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "progress",
+  "title": "Show project progress",
+  "description": "Summarize writing progress, surface blockers, and recommend the next compatible action.",
+  "alias": "wtfp:progress",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-manage-project"
+  },
+  "workflow": "wtfp://workflows/progress",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "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://sections/{section}/plans/{plan}",
+    "project://sections/{section}/reviews/{review}",
+    "project://sections/{section}/summary",
+    "project://sections/{section}/handoff",
+    "project://sources/{source}",
+    "project://evidence/{evidence}",
+    "project://checkpoints/{checkpoint}",
+    "project://validations/{validation}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "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}/reviews/{review}, project://sections/{section}/summary, project://sections/{section}/handoff, project://sources/{source}, project://evidence/{evidence}, project://checkpoints/{checkpoint}, project://validations/{validation}, project://paper/{artifact}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "selection of the recommended next action"
+    }
+  ]
+}

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

@@ -0,0 +1,70 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "quick",
+  "title": "Make a quick writing change",
+  "description": "Apply a small, bounded writing fix with minimal planning overhead and state tracking.",
+  "alias": "wtfp:quick",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-write-section"
+  },
+  "workflow": "wtfp://workflows/quick",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The requested change is small and has a clear target"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://state",
+    "project://decisions",
+    "project://sections/{section}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://paper/{artifact}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "section-writer",
+      "mode": "optional",
+      "purpose": "Handle a bounded change that still benefits from a fresh writing context"
+    }
+  ],
+  "tools": [],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://section-writer when needed"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "the user-approved writing target and project state"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://state, project://decisions, project://sections/{section}, project://paper/{artifact}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "ambiguous target or change intent"
+    }
+  ]
+}

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

@@ -0,0 +1,63 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "remove-section",
+  "title": "Remove a section",
+  "description": "Remove an unwritten future section and repair numbering and dependencies.",
+  "alias": "wtfp:remove-section",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-plan-section"
+  },
+  "workflow": "wtfp://workflows/remove-section",
+  "requirements": {
+    "capabilities": [
+      "filesystem.delete",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The selected section exists",
+      "The selected section has not been drafted"
+    ]
+  },
+  "reads": [
+    "project://structure/outline",
+    "project://state",
+    "project://sections/{section}"
+  ],
+  "produces": [
+    {
+      "uri": "project://structure/outline",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "delete"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.delete",
+      "scope": "selected unwritten section artifacts"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://structure/outline, project://state, project://sections/{section}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://structure/outline, project://state, project://sections/{section}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "section deletion and renumbering"
+    }
+  ]
+}