wtf-p 0.7.4 → 0.8.0

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 }

package/vendors/clio-extension/compatibility/action-availability.json

@@ -0,0 +1,295 @@
+{
+  "schema": "wtfp.action-availability/v1",
+  "target": "clio",
+  "marker": "WTFP_ACTION_UNAVAILABLE",
+  "hostToolEnforcement": {
+    "actionScoped": false,
+    "surface": "clio:session-tools",
+    "certificationAutonomy": [
+      "read-only",
+      "suggest"
+    ],
+    "undeclaredToolCall": "fail"
+  },
+  "capabilityBindings": {
+    "agent.delegate": "clio:plugin-agent",
+    "agent.parallel": "clio:fleet",
+    "external.issue": null,
+    "filesystem.delete": null,
+    "filesystem.read": "clio:workspace-read",
+    "filesystem.write": "clio:workspace-write",
+    "network.fetch": "clio:web_fetch",
+    "network.search": "clio:bash-bundled-citation-tools",
+    "package.update": null,
+    "tool.execute": "clio:bash",
+    "user.interaction": "clio:ask_user",
+    "vcs.branch": null,
+    "vcs.commit": null
+  },
+  "approvalBindings": {
+    "none": "clio:permission-policy",
+    "implicit": "clio:permission-policy",
+    "explicit": "clio:ask_user"
+  },
+  "effectCapabilityBindings": {
+    "agent.delegate": "agent.delegate",
+    "agent.parallel": "agent.parallel",
+    "artifact.archive": "filesystem.write",
+    "external.issue": "external.issue",
+    "filesystem.create": "filesystem.write",
+    "filesystem.delete": "filesystem.delete",
+    "filesystem.modify": "filesystem.write",
+    "filesystem.read": "filesystem.read",
+    "filesystem.write": "filesystem.write",
+    "network.fetch": "network.fetch",
+    "network.search": "network.search",
+    "package.update": "package.update",
+    "tool.execute": "tool.execute",
+    "user.gate": "user.interaction",
+    "vcs.branch": "vcs.branch",
+    "vcs.commit": "vcs.commit",
+    "vcs.merge": null
+  },
+  "actions": [
+    {
+      "id": "add-todo",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "analyze-bib",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "audit-milestone",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "check-refs",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "check-todos",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "checkpoint",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "contribute",
+      "status": "unavailable",
+      "unavailableCapabilities": [
+        "external.issue",
+        "vcs.branch",
+        "vcs.commit"
+      ],
+      "unavailableEffects": [
+        "external.issue",
+        "vcs.branch",
+        "vcs.commit"
+      ]
+    },
+    {
+      "id": "create-outline",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "create-poster",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "create-slides",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "discuss-section",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "execute-outline",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "export-latex",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "help",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "insert-section",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "list-assumptions",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "map-project",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "new-paper",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "pause-writing",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "plan-milestone-gaps",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "plan-revision",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "plan-section",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "polish-prose",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "progress",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "quick",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "remove-section",
+      "status": "unavailable",
+      "unavailableCapabilities": [
+        "filesystem.delete"
+      ],
+      "unavailableEffects": [
+        "filesystem.delete"
+      ]
+    },
+    {
+      "id": "report-bug",
+      "status": "unavailable",
+      "unavailableCapabilities": [
+        "external.issue"
+      ],
+      "unavailableEffects": [
+        "external.issue"
+      ]
+    },
+    {
+      "id": "request-feature",
+      "status": "unavailable",
+      "unavailableCapabilities": [
+        "external.issue"
+      ],
+      "unavailableEffects": [
+        "external.issue"
+      ]
+    },
+    {
+      "id": "research-gap",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "resume-writing",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "review-section",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "settings",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "submit-milestone",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "update",
+      "status": "unavailable",
+      "unavailableCapabilities": [
+        "package.update"
+      ],
+      "unavailableEffects": [
+        "package.update"
+      ]
+    },
+    {
+      "id": "verify-work",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    },
+    {
+      "id": "write-section",
+      "status": "available",
+      "unavailableCapabilities": [],
+      "unavailableEffects": []
+    }
+  ]
+}

package/vendors/clio-extension/project/schemas/checkpoint.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/checkpoint/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "required": ["kind"],
+        "properties": { "kind": { "const": "state-snapshot" } }
+      },
+      "then": {
+        "required": ["snapshot"],
+        "properties": {
+          "status": { "enum": ["available", "restored", "expired"] },
+          "blocking": { "const": false }
+        }
+      },
+      "else": {
+        "not": { "required": ["snapshot"] },
+        "properties": {
+          "status": { "enum": ["pending", "resolved", "waived", "expired"] }
+        }
+      }
+    }
+  ],
+  "required": [
+    "schema",
+    "id",
+    "project_id",
+    "kind",
+    "status",
+    "blocking",
+    "scope_uri",
+    "request",
+    "options",
+    "resume_action",
+    "created_at"
+  ],
+  "properties": {
+    "schema": { "const": "wtfp.project.checkpoint/v1" },
+    "id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "project_id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "kind": { "enum": ["human-verify", "decision", "human-action", "safety-authorization", "state-snapshot"] },
+    "status": { "enum": ["pending", "resolved", "waived", "expired", "available", "restored"] },
+    "blocking": { "type": "boolean" },
+    "scope_uri": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+    "request": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "context": { "type": "string" },
+    "options": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "label", "implication"],
+        "properties": {
+          "id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+          "label": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "implication": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" }
+        }
+      }
+    },
+    "resume_action": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "created_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" },
+    "snapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["archive_uri", "resources"],
+      "properties": {
+        "archive_uri": {
+          "type": "string",
+          "pattern": "^project://archives/checkpoints/[A-Za-z0-9._~-]+$"
+        },
+        "resources": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["uri", "sha256"],
+            "properties": {
+              "uri": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+              "revision": { "type": "integer", "minimum": 0 },
+              "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+            }
+          }
+        }
+      }
+    },
+    "resolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["resolved_by", "summary", "resolved_at"],
+      "properties": {
+        "resolved_by": { "enum": ["author", "policy"] },
+        "selected_option": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+        "summary": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+        "resolved_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" }
+      }
+    }
+  }
+}

package/vendors/clio-extension/project/schemas/common.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/common/v1",
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+    },
+    "logicalUri": {
+      "type": "string",
+      "pattern": "^project://(?!\\.{1,2}(?:/|$))(?!.*\\/\\.{1,2}(?:/|$))[A-Za-z0-9._~-]+(?:/[A-Za-z0-9._~-]+)*$"
+    },
+    "protocolUri": {
+      "type": "string",
+      "pattern": "^protocol://(?!\\.{1,2}(?:/|$))(?!.*\\/\\.{1,2}(?:/|$))[A-Za-z0-9._~-]+(?:/[A-Za-z0-9._~-]+)*$"
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "date": {
+      "type": "string",
+      "format": "date"
+    },
+    "confidence": {
+      "enum": ["high", "medium", "low", "unknown"]
+    }
+  }
+}

package/vendors/clio-extension/project/schemas/config.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/config/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "project_id",
+    "interaction_mode",
+    "depth",
+    "output_format",
+    "language",
+    "gates",
+    "workflow",
+    "safety",
+    "parallelism"
+  ],
+  "properties": {
+    "schema": { "const": "wtfp.project.config/v1" },
+    "project_id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "interaction_mode": { "enum": ["guided", "standard", "autonomous"] },
+    "depth": { "enum": ["quick", "standard", "comprehensive"] },
+    "output_format": { "enum": ["markdown", "latex", "typst"] },
+    "language": { "type": "string", "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$" },
+    "citation_style": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "gates": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["confirm_outline", "confirm_plan", "confirm_write", "confirm_review", "confirm_delivery"],
+      "properties": {
+        "confirm_outline": { "type": "boolean" },
+        "confirm_plan": { "type": "boolean" },
+        "confirm_write": { "type": "boolean" },
+        "confirm_review": { "type": "boolean" },
+        "confirm_delivery": { "type": "boolean" }
+      }
+    },
+    "workflow": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["research", "plan_validation", "argument_validation", "coherence_validation"],
+      "properties": {
+        "research": { "type": "boolean" },
+        "plan_validation": { "type": "boolean" },
+        "argument_validation": { "type": "boolean" },
+        "coherence_validation": { "type": "boolean" }
+      }
+    },
+    "safety": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["destructive_requires_authorization", "external_publish_requires_authorization", "backup_before_major_edits"],
+      "properties": {
+        "destructive_requires_authorization": { "const": true },
+        "external_publish_requires_authorization": { "const": true },
+        "backup_before_major_edits": { "type": "boolean" }
+      }
+    },
+    "parallelism": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["enabled", "max_workers"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "max_workers": { "type": "integer", "minimum": 1, "maximum": 32 }
+      }
+    }
+  }
+}