wtf-p 0.7.3 → 0.8.0

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

package/vendors/clio-extension/actions/report-bug.json

@@ -0,0 +1,47 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "report-bug",
+  "title": "Report a WTF-P bug",
+  "description": "Collect a reproducible bug report and publish it only after explicit user approval.",
+  "alias": "wtfp:report-bug",
+  "surface": {
+    "kind": "operations",
+    "operation": "product-operations"
+  },
+  "requirements": {
+    "capabilities": [
+      "external.issue",
+      "filesystem.read",
+      "network.fetch",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The user explicitly requested a bug report"
+    ]
+  },
+  "reads": [
+    "package://metadata",
+    "project://state"
+  ],
+  "produces": [],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "external.issue",
+      "scope": "the configured WTF-P issue tracker"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "package://metadata, project://state"
+    },
+    {
+      "id": "network.fetch",
+      "scope": "issue template and duplicate metadata"
+    },
+    {
+      "id": "user.gate",
+      "scope": "the exact issue body before publication"
+    }
+  ]
+}

package/vendors/clio-extension/actions/request-feature.json

@@ -0,0 +1,47 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "request-feature",
+  "title": "Request a WTF-P feature",
+  "description": "Shape a concrete feature request and publish it only after explicit user approval.",
+  "alias": "wtfp:request-feature",
+  "surface": {
+    "kind": "operations",
+    "operation": "product-operations"
+  },
+  "requirements": {
+    "capabilities": [
+      "external.issue",
+      "filesystem.read",
+      "network.fetch",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The user explicitly requested a feature proposal"
+    ]
+  },
+  "reads": [
+    "package://metadata",
+    "protocol://catalog.json"
+  ],
+  "produces": [],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "external.issue",
+      "scope": "the configured WTF-P issue tracker"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "package://metadata, protocol://catalog.json"
+    },
+    {
+      "id": "network.fetch",
+      "scope": "feature template and duplicate metadata"
+    },
+    {
+      "id": "user.gate",
+      "scope": "the exact issue body before publication"
+    }
+  ]
+}

package/vendors/clio-extension/actions/research-gap.json

@@ -0,0 +1,102 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "research-gap",
+  "title": "Research a section gap",
+  "description": "Synthesize literature, domain conventions, open gaps, and defensible positioning for a section.",
+  "alias": "wtfp:research-gap",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-research-literature"
+  },
+  "workflow": "wtfp://workflows/research-gap",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "network.fetch",
+      "network.search",
+      "tool.execute",
+      "user.interaction"
+    ],
+    "conditions": [
+      "A target section is identifiable in project://structure/outline"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sections/{section}",
+    "project://sections/{section}/context",
+    "project://sources/{source}",
+    "project://evidence/{evidence}"
+  ],
+  "produces": [
+    {
+      "uri": "project://sources/{source}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://evidence/{evidence}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}/research",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "research-synthesizer",
+      "mode": "required",
+      "purpose": "Synthesize existing and newly discovered evidence into a section research brief"
+    }
+  ],
+  "tools": [
+    "bibliography.index",
+    "citation.fetch",
+    "citation.rank",
+    "citation.scholar-lookup",
+    "citation.semantic-scholar"
+  ],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://research-synthesizer"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://sources/{source}, project://evidence/{evidence}, project://sections/{section}/research"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://sections/{section}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://config, project://decisions, project://structure/outline, project://sections/{section}, project://sections/{section}/context, project://sources/{source}, project://evidence/{evidence}"
+    },
+    {
+      "id": "network.fetch",
+      "scope": "selected scholarly records"
+    },
+    {
+      "id": "network.search",
+      "scope": "declared scholarly indexes"
+    },
+    {
+      "id": "tool.execute",
+      "scope": "declared bibliography and citation tools through tools/wtfp-tool.js"
+    },
+    {
+      "id": "user.gate",
+      "scope": "unapproved or paid external providers and bounded query set, plus author-owned research scope and depth decisions"
+    }
+  ]
+}

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

@@ -0,0 +1,65 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "resume-writing",
+  "title": "Resume writing",
+  "description": "Restore the latest portable handoff and route the researcher to the next safe action.",
+  "alias": "wtfp:resume-writing",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-manage-project"
+  },
+  "workflow": "wtfp://workflows/resume-writing",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "Portable project state or a session handoff exists",
+      "Every declared resume input is read and validated in the current invocation before options are presented",
+      "A host-native user gate returns one exact checkpoint option in the current invocation before any checkpoint or state mutation"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://state",
+    "project://decisions",
+    "project://structure/outline",
+    "project://checkpoints/{checkpoint}",
+    "project://sections/{section}",
+    "project://sections/{section}/plans/{plan}",
+    "project://sections/{section}/reviews/{review}",
+    "project://sections/{section}/handoff",
+    "project://sections/{section}/summary",
+    "project://validations/{validation}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://checkpoints/{checkpoint}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://config, project://state, project://decisions, project://structure/outline, project://checkpoints/{checkpoint}, project://sections/{section}, project://sections/{section}/plans/{plan}, project://sections/{section}/reviews/{review}, project://sections/{section}/handoff, project://sections/{section}/summary, project://validations/{validation}, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://checkpoints/{checkpoint}, project://state"
+    },
+    {
+      "id": "user.gate",
+      "scope": "selection of the resumed action"
+    }
+  ]
+}