wtf-p 0.7.3 → 0.8.0

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

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

@@ -0,0 +1,115 @@
+{
+  "schema": "wtfp.action/v1",
+  "id": "write-section",
+  "title": "Write a section",
+  "description": "Execute an approved section plan, update state, and optionally verify argument coverage.",
+  "alias": "wtfp:write-section",
+  "surface": {
+    "kind": "skill",
+    "skill": "wtfp-write-section"
+  },
+  "workflow": "wtfp://workflows/write-section",
+  "requirements": {
+    "capabilities": [
+      "agent.delegate",
+      "filesystem.read",
+      "filesystem.write",
+      "user.interaction"
+    ],
+    "conditions": [
+      "The selected section has an executable plan"
+    ]
+  },
+  "reads": [
+    "project://manifest",
+    "project://config",
+    "project://state",
+    "project://decisions",
+    "project://structure/outline",
+    "project://sections/{section}",
+    "project://sections/{section}/context",
+    "project://sections/{section}/research",
+    "project://sections/{section}/plans/{plan}",
+    "project://sections/{section}/summary",
+    "project://sources/{source}",
+    "project://evidence/{evidence}",
+    "project://paper/{artifact}"
+  ],
+  "produces": [
+    {
+      "uri": "project://paper/{artifact}",
+      "mode": "create"
+    },
+    {
+      "uri": "project://paper/{artifact}",
+      "mode": "update"
+    },
+    {
+      "uri": "project://manifest",
+      "mode": "update"
+    },
+    {
+      "uri": "project://sections/{section}/summary",
+      "mode": "create"
+    },
+    {
+      "uri": "project://sections/{section}/summary",
+      "mode": "update"
+    },
+    {
+      "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-writer",
+      "mode": "required",
+      "purpose": "Draft the section from its approved plan and evidence"
+    },
+    {
+      "role": "argument-verifier",
+      "mode": "optional",
+      "purpose": "Independently verify claim, evidence, and requirement coverage"
+    }
+  ],
+  "tools": [],
+  "effects": [
+    {
+      "id": "agent.delegate",
+      "scope": "role://section-writer, role://argument-verifier"
+    },
+    {
+      "id": "filesystem.create",
+      "scope": "project://paper/{artifact}, project://sections/{section}/summary, project://validations/{validation}, project://checkpoints/{checkpoint}"
+    },
+    {
+      "id": "filesystem.modify",
+      "scope": "project://paper/{artifact}, project://manifest, project://sections/{section}/summary, 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}/context, project://sections/{section}/research, project://sections/{section}/plans/{plan}, project://sections/{section}/summary, project://sources/{source}, project://evidence/{evidence}, project://paper/{artifact}"
+    },
+    {
+      "id": "filesystem.write",
+      "scope": "declared manuscript, manifest, summary, validation, checkpoint, section, and state resources"
+    },
+    {
+      "id": "user.gate",
+      "scope": "verification exceptions and blocked plan decisions"
+    }
+  ]
+}

package/vendors/clio-extension/clio-coder-extension.yaml

@@ -0,0 +1,53 @@
+# Generated by WTF-P adapter compiler v5 from clio/clio-coder-extension.yaml; do not edit.
+id: wtfp
+plugin: wtfp
+name: WTF-P
+version: 0.8.0
+description: "The WTF-P writing desk for Clio Coder; paper state, gates and the write guard run in code."
+compatibility: { clio: ">=0.6.2" }
+runtime:
+  api: 2
+  entrypoint: runtime/extension.ts
+  commands:
+    - { name: desk, description: "Enter the WTF-P writing desk." }
+    - { name: progress, description: "Paper progress and the next action, computed locally.", replaces: prompt }
+    - { name: help, description: "The WTF-P action reference, rendered locally.", replaces: prompt }
+    - { name: check-todos, description: "Answer pending gates and author tasks.", replaces: prompt }
+    - { name: checkpoints, description: "List interaction gates and state snapshots." }
+    - { name: validate, description: "Validate every planning record against its schema." }
+  events: [session_open, dispatch_started, dispatch_completed, dispatch_failed, fs_changed, workspace_enter, workspace_leave]
+  watch: [".planning/**", "paper/**"]
+  hooks:
+    - { on: prompt_submit, timeoutMs: 1000, onTimeout: pass, onError: pass }
+    - { on: before_tool, tools: [write, edit], timeoutMs: 1000, onTimeout: block, onError: block }
+  tools:
+    - name: record
+      description: "Write one .planning record at its logical URI, validated against its canonical schema, its revision bumped, replaced atomically and read back."
+      actionClass: execute
+      inputSchema: { type: object, properties: { uri: { type: string }, record: { type: object }, expect_revision: { type: integer } }, required: [uri, record], additionalProperties: false }
+    - name: measure_section
+      description: "Count a section's manuscript body words by the desk's one method and record the count in the section and state records."
+      actionClass: execute
+      inputSchema: { type: object, properties: { section: { type: string } }, required: [section], additionalProperties: false }
+    - name: gate
+      description: "Ask the author a pending checkpoint as an interview; only the author's answer resolves it, and that answer is the result."
+      actionClass: execute
+      inputSchema: { type: object, properties: { checkpoint: { type: string } }, required: [checkpoint], additionalProperties: false }
+  ui: [status, band, card, toast, interview]
+  workspaces:
+    - id: desk
+      title: WTF-P writing desk
+      regions: [header, board, islands, rail, footer]
+      board: band
+      skin: skins/wtfp.json
+      keys:
+        - { key: f, action: next, label: "Fill the next writing action" }
+        - { key: c, action: gates, label: "Answer the pending gate" }
+        - { key: v, action: validate, label: "Validate planning records" }
+        - { key: h, action: help, label: "WTF-P action reference" }
+  access: [prompt, tool-args]
+  permissions:
+    fs: { read: [".planning", "paper"], write: [".planning"] }
+    exec: false
+    net: false
+  state: { session: true, store: false }