wtf-p 0.7.4 → 0.8.0

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

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

@@ -0,0 +1,83 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "review-section",
+  "title": "Review a section",
+  "description": "Review a drafted section for evidence, citations, coherence, requirements, and reader expectations.",
+  "alias": "wtfp:review-section",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-review-manuscript"
+  },
+  "workflow": "wtfp://workflows/review-section",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The selected section has both a plan and a draft"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sections/{section}",
+    "project://sections/{section}/context",
+    "project://sections/{section}/plans/{plan}",
+    "project://sections/{section}/research",
+    "project://sections/{section}/summary",
+    "project://evidence/{evidence}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://sections/{section}/reviews/{review}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    }
+  ],
+  "delegation": [
+    {
+      "role": "section-reviewer",
+      "mode": "required",
+      "purpose": "Independently assess the section against its plan, evidence, and selected review perspective"
+    }
+  ],
+  "tools": [],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://section-reviewer"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://sections/{section}/reviews/{review}, project://validations/{validation}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://sections/{section}"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://manifest, project://decisions, project://structure/outline, project://sections/{section}, project://sections/{section}/context, project://sections/{section}/plans/{plan}, project://sections/{section}/research, project://sections/{section}/summary, project://evidence/{evidence}, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "project://sections/{section}/reviews/{review}, project://validations/{validation}, project://sections/{section}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "review persona and disputed findings"
+    }
+  ]
+}

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

@@ -0,0 +1,47 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "settings",
+  "title": "Manage project settings",
+  "description": "View and update portable project settings after presenting the exact proposed diff.",
+  "alias": "wtfp:settings",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-manage-project"
+  },
+  "workflow": "wtfp://workflows/settings",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "Portable project state has been initialized"
+    ]
+  },
+  "reads": [
+    "project://config"
+  ],
+  "produces": [
+    {
+      "uri": "project://config",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.modify",
+      "scope": "project://config"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://config"
+    },
+    {
+      "id": "user.gate",
+      "scope": "the exact settings diff"
+    }
+  ]
+}

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

@@ -0,0 +1,77 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "submit-milestone",
+  "title": "Archive a milestone",
+  "description": "Archive a completed draft or submission round with its reproducible project state and statistics.",
+  "alias": "wtfp:submit-milestone",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-deliver-research"
+  },
+  "workflow": "wtfp://workflows/submit-milestone",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The milestone identifier is unique",
+      "The user confirms the archive contents"
+    ]
+  },
+  "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://archives/{archive}/{artifact}",
+      "mode": "archive"
+    },
+    {
+      "uri": "project://manifest",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    },
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "artifact.archive",
+      "scope": "selected paper milestone and portable project state"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://archives/{archive}/{artifact}, project://manifest, project://state, project://validations/{validation}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project archive manifest, portable project manifest, outline, and state"
+    },
+    {
+      "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": "user.gate",
+      "scope": "milestone identifier and archive contents"
+    }
+  ]
+}

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

@@ -0,0 +1,42 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "update",
+  "title": "Update WTF-P",
+  "description": "Check for a newer compatible package or plugin release and install it only after approval.",
+  "alias": "wtfp:update",
+  "surface": {
+    "kind": "operations",
+    "operation": "product-operations"
+  },
+  "requirements": {
+    "capabilities": [
+      "network.fetch",
+      "package.update",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The active installation target and scope are explicit"
+    ]
+  },
+  "reads": [
+    "package://metadata",
+    "package://installation-receipt"
+  ],
+  "produces": [],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "network.fetch",
+      "scope": "configured WTF-P release registry"
+    },
+    {
+      "id": "package.update",
+      "scope": "the explicit installation target and scope"
+    },
+    {
+      "id": "user.gate",
+      "scope": "release selection and package replacement"
+    }
+  ]
+}

package/vendors/clio-extension/actions/verify-work.json

@@ -0,0 +1,63 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "verify-work",
+  "title": "Verify written work",
+  "description": "Test a drafted section against each plan requirement and record evidence one check at a time.",
+  "alias": "wtfp:verify-work",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-review-manuscript"
+  },
+  "workflow": "wtfp://workflows/verify-work",
+  "requirements": {
+    "capabilities": [
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The selected section has an approved plan and a draft"
+    ]
+  },
+  "reads": [
+    "project://state",
+    "project://sections/{section}",
+    "project://sections/{section}/plans/{plan}",
+    "project://evidence/{evidence}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://validations/{validation}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://state",
+      "mode": "update"
+    }
+  ],
+  "delegation": [],
+  "tools": [],
+  "effects": [
+    {
+      "id": "filesystem.create",
+      "scope": "selected section verification artifact"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://validations/{validation}, project://sections/{section}, project://state"
+    },
+    {
+      "id": "filesystem.read",
+      "scope": "project://state, project://sections/{section}, project://sections/{section}/plans/{plan}, project://evidence/{evidence}, project://paper/{artifact}"
+    },
+    {
+      "id": "user.gate",
+      "scope": "each failed or disputed verification check"
+    }
+  ]
+}