wtf-p 0.7.3 → 0.8.0

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

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/manifest/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "protocol_version",
+    "id",
+    "title",
+    "document_type",
+    "core_argument",
+    "created_at",
+    "updated_at",
+    "artifacts"
+  ],
+  "properties": {
+    "schema": { "const": "wtfp.project.manifest/v1" },
+    "protocol_version": { "const": 1 },
+    "id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "title": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "document_type": {
+      "enum": [
+        "research-article",
+        "conference-paper",
+        "review",
+        "grant-proposal",
+        "thesis",
+        "dissertation",
+        "book-chapter",
+        "other"
+      ]
+    },
+    "core_argument": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "venue": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+        "audience": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+        "word_limit": { "type": "integer", "minimum": 1 },
+        "deadline": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/date" }
+      }
+    },
+    "requirements": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["must_have", "should_have", "out_of_scope"],
+      "properties": {
+        "must_have": {
+          "type": "array",
+          "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "uniqueItems": true
+        },
+        "should_have": {
+          "type": "array",
+          "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "uniqueItems": true
+        },
+        "out_of_scope": {
+          "type": "array",
+          "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "uniqueItems": true
+        }
+      }
+    },
+    "created_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" },
+    "updated_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["manifest", "config", "state", "decisions", "outline"],
+      "properties": {
+        "manifest": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "config": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "state": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "decisions": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "outline": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "materials": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^project://materials/[A-Za-z0-9._~-]+(?:/[A-Za-z0-9._~-]+)*$" },
+          "uniqueItems": true
+        },
+        "manuscripts": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^project://paper/[A-Za-z0-9._~-]+(?:/[A-Za-z0-9._~-]+)*$" },
+          "uniqueItems": true
+        },
+        "deliverables": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^project://deliverables/[A-Za-z0-9._~-]+(?:/[A-Za-z0-9._~-]+)*$" },
+          "uniqueItems": true
+        },
+        "archives": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^project://archives/[A-Za-z0-9._~-]+(?:/[A-Za-z0-9._~-]+)*$" },
+          "uniqueItems": true
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/outline/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "project_id", "revision", "thesis", "target_words", "sections", "updated_at"],
+  "properties": {
+    "schema": { "const": "wtfp.project.outline/v1" },
+    "project_id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "revision": { "type": "integer", "minimum": 0 },
+    "thesis": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "target_words": { "type": "integer", "minimum": 1 },
+    "sections": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "title",
+          "goal",
+          "argument_role",
+          "word_target",
+          "wave",
+          "depends_on",
+          "claim_ids",
+          "research"
+        ],
+        "properties": {
+          "id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+          "title": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "goal": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "argument_role": {
+            "enum": ["setup", "background", "method", "evidence", "synthesis", "implications", "conclusion", "other"]
+          },
+          "word_target": { "type": "integer", "minimum": 1 },
+          "wave": { "type": "integer", "minimum": 1 },
+          "depends_on": {
+            "type": "array",
+            "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+            "uniqueItems": true
+          },
+          "claim_ids": {
+            "type": "array",
+            "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+            "uniqueItems": true
+          },
+          "research": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["required", "topics"],
+            "properties": {
+              "required": { "type": "boolean" },
+              "topics": {
+                "type": "array",
+                "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+                "uniqueItems": true
+              }
+            }
+          }
+        }
+      }
+    },
+    "updated_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" }
+  }
+}

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

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/section/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "project_id",
+    "outline_uri",
+    "title",
+    "goal",
+    "status",
+    "word_target",
+    "word_count",
+    "wave",
+    "depends_on",
+    "claims",
+    "artifacts",
+    "checkpoint_uris",
+    "validation_uris",
+    "updated_at"
+  ],
+  "properties": {
+    "schema": { "const": "wtfp.project.section/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" },
+    "outline_uri": { "const": "project://structure/outline" },
+    "title": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "goal": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "status": {
+      "enum": ["not-started", "researching", "planned", "writing", "reviewing", "complete", "blocked"]
+    },
+    "word_target": { "type": "integer", "minimum": 1 },
+    "word_count": { "type": "integer", "minimum": 0 },
+    "wave": { "type": "integer", "minimum": 1 },
+    "depends_on": {
+      "type": "array",
+      "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+      "uniqueItems": true
+    },
+    "claims": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "statement", "status", "evidence_required", "evidence_uris"],
+        "properties": {
+          "id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+          "statement": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "status": { "enum": ["planned", "drafted", "verified", "rejected"] },
+          "evidence_required": { "type": "boolean" },
+          "evidence_uris": {
+            "type": "array",
+            "items": { "type": "string", "pattern": "^project://evidence/[A-Za-z0-9._~-]+$" },
+            "uniqueItems": true
+          }
+        }
+      }
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["plans", "reviews"],
+      "properties": {
+        "context": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "research": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "plans": {
+          "type": "array",
+          "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+          "uniqueItems": true
+        },
+        "reviews": {
+          "type": "array",
+          "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+          "uniqueItems": true
+        },
+        "manuscript": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "summary": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+        "handoff": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" }
+      }
+    },
+    "checkpoint_uris": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^project://checkpoints/[A-Za-z0-9._~-]+$" },
+      "uniqueItems": true
+    },
+    "validation_uris": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^project://validations/[A-Za-z0-9._~-]+$" },
+      "uniqueItems": true
+    },
+    "updated_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" }
+  }
+}

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

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/source/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "project_id",
+    "kind",
+    "title",
+    "creators",
+    "year",
+    "identifiers",
+    "status",
+    "provenance"
+  ],
+  "properties": {
+    "schema": { "const": "wtfp.project.source/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": [
+        "journal-article",
+        "conference-paper",
+        "book",
+        "book-chapter",
+        "preprint",
+        "thesis",
+        "dataset",
+        "software",
+        "standard",
+        "web-resource",
+        "author-material",
+        "other"
+      ]
+    },
+    "title": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+    "creators": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" }
+    },
+    "year": { "type": ["integer", "null"], "minimum": 1000, "maximum": 2200 },
+    "identifiers": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "doi": { "type": "string", "pattern": "^10\\.[0-9]{4,9}/\\S+$" },
+        "arxiv": { "type": "string", "pattern": "^(?:[a-z-]+/[0-9]{7}|[0-9]{4}\\.[0-9]{4,5})(?:v[0-9]+)?$" },
+        "isbn": { "type": "string", "minLength": 10 },
+        "url": { "type": "string", "format": "uri" },
+        "local_id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" }
+      }
+    },
+    "citation_key": { "type": "string", "pattern": "^[A-Za-z0-9:_-]+$" },
+    "status": { "enum": ["verified", "provisional", "unavailable", "retracted"] },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["discovered_via", "inspection_depth", "verified_at"],
+      "properties": {
+        "discovered_via": {
+          "enum": ["scholarly-index", "bibliography-import", "author-provided", "repository", "manual"]
+        },
+        "inspection_depth": { "enum": ["metadata", "abstract", "full-text", "primary-data"] },
+        "verified_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" },
+        "notes": { "type": "string" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/state/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "project_id",
+    "revision",
+    "phase",
+    "status",
+    "current_section_uri",
+    "progress",
+    "active_checkpoint_uris",
+    "updated_at"
+  ],
+  "properties": {
+    "schema": { "const": "wtfp.project.state/v1" },
+    "project_id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "revision": { "type": "integer", "minimum": 0 },
+    "phase": {
+      "enum": ["initialized", "mapped", "outlining", "planning", "writing", "reviewing", "ready", "delivered"]
+    },
+    "status": { "enum": ["active", "paused", "blocked", "complete"] },
+    "current_section_uri": {
+      "type": ["string", "null"],
+      "pattern": "^project://sections/[A-Za-z0-9._~-]+$"
+    },
+    "progress": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sections_total", "sections_complete", "word_target", "word_count"],
+      "properties": {
+        "sections_total": { "type": "integer", "minimum": 0 },
+        "sections_complete": { "type": "integer", "minimum": 0 },
+        "word_target": { "type": "integer", "minimum": 0 },
+        "word_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "active_checkpoint_uris": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^project://checkpoints/[A-Za-z0-9._~-]+$" },
+      "uniqueItems": true
+    },
+    "last_transition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["from", "to", "reason", "at"],
+      "properties": {
+        "from": { "type": "string", "minLength": 1 },
+        "to": { "type": "string", "minLength": 1 },
+        "reason": { "type": "string", "minLength": 1 },
+        "at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" }
+      }
+    },
+    "updated_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" }
+  }
+}

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

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.wtf-p.dev/project/validation/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "id",
+    "project_id",
+    "subject_uri",
+    "validator_role",
+    "action_id",
+    "status",
+    "checks",
+    "issues",
+    "next_actions",
+    "effects_applied",
+    "executed_at"
+  ],
+  "properties": {
+    "schema": { "const": "wtfp.project.validation/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" },
+    "subject_uri": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/logicalUri" },
+    "validator_role": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "action_id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+    "status": { "enum": ["passed", "issues-found", "needs-input", "failed"] },
+    "checks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status", "summary", "evidence"],
+        "properties": {
+          "id": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+          "status": { "enum": ["passed", "warning", "failed", "not-applicable"] },
+          "summary": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "evidence": {
+            "type": "array",
+            "items": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" }
+          }
+        }
+      }
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["severity", "summary"],
+        "properties": {
+          "severity": { "enum": ["info", "warning", "error", "blocker"] },
+          "summary": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" },
+          "evidence": { "type": "string" }
+        }
+      }
+    },
+    "next_actions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["action", "reason"],
+        "properties": {
+          "action": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/identifier" },
+          "reason": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/nonEmptyString" }
+        }
+      }
+    },
+    "effects_applied": { "const": [] },
+    "executed_at": { "$ref": "https://schemas.wtf-p.dev/project/common/v1#/$defs/timestamp" }
+  }
+}