@logicsrc/schemas 0.1.0

package/schemas/logicsrc-repo.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-repo.schema.json",
+  "title": "LogicSRC Repo",
+  "type": "object",
+  "required": ["type", "version", "name", "slug", "owner_did", "backend", "visibility"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.repo" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9/_-]*$" },
+    "description": { "type": "string" },
+    "owner_did": { "$ref": "#/$defs/did" },
+    "board": { "type": "string", "pattern": "^/[a-z0-9][a-z0-9/_-]*$" },
+    "visibility": {
+      "type": "string",
+      "enum": ["members_only", "private", "public"],
+      "default": "members_only"
+    },
+    "default_branch": { "type": "string", "minLength": 1, "default": "main" },
+    "backend": {
+      "type": "object",
+      "required": ["provider", "url"],
+      "additionalProperties": false,
+      "properties": {
+        "provider": { "type": "string", "enum": ["forgejo", "github", "git"] },
+        "url": { "type": "string", "format": "uri" },
+        "external_id": { "type": "string" }
+      }
+    },
+    "members": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["did", "role"],
+        "additionalProperties": false,
+        "properties": {
+          "did": { "$ref": "#/$defs/did" },
+          "role": {
+            "type": "string",
+            "enum": ["maintainer", "contributor", "reviewer", "reader"]
+          }
+        }
+      }
+    },
+    "merge_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "min_reviews": { "type": "integer", "minimum": 0, "default": 1 },
+        "require_passing_checks": { "type": "boolean", "default": true },
+        "reviewer_reputation_min": { "type": "number", "minimum": 0, "default": 0 },
+        "escrow_required": { "type": "boolean", "default": false },
+        "allow_agent_merge": { "type": "boolean", "default": true },
+        "allowed_merge_methods": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["merge", "squash", "rebase"] },
+          "uniqueItems": true,
+          "default": ["squash"]
+        }
+      }
+    },
+    "created_at": { "type": "string", "format": "date-time" },
+    "logicsrc_version": { "type": "string" }
+  },
+  "$defs": {
+    "did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    }
+  }
+}

package/schemas/logicsrc-run.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-run.schema.json",
+  "title": "LogicSRC Agent Run",
+  "type": "object",
+  "required": ["type", "version", "run_id", "task_id", "agent_did", "status", "started_at"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.agent_run" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "task_id": { "type": "string", "minLength": 1 },
+    "agent_did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["created", "authorized", "started", "running", "submitted", "completed", "failed", "cancelled", "disputed"]
+    },
+    "started_at": { "type": "string", "format": "date-time" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "logs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["timestamp", "action", "status"],
+        "additionalProperties": false,
+        "properties": {
+          "timestamp": { "type": "string", "format": "date-time" },
+          "action": { "type": "string" },
+          "status": { "type": "string" },
+          "resource": { "type": "string" },
+          "message": { "type": "string" }
+        }
+      }
+    },
+    "files_accessed": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "tools_used": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "deliverables": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["type", "url"],
+        "additionalProperties": false,
+        "properties": {
+          "type": { "type": "string" },
+          "url": { "type": "string", "format": "uri" }
+        }
+      }
+    },
+    "cost": {
+      "type": "object",
+      "required": ["amount", "currency"],
+      "additionalProperties": false,
+      "properties": {
+        "amount": { "type": "number", "minimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "payment_status": { "type": "string" }
+  }
+}

package/schemas/logicsrc-social-post.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-social-post.schema.json",
+  "title": "LogicSRC Social Post",
+  "type": "object",
+  "required": ["id", "accountId", "status", "media", "metadata", "createdAt", "updatedAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "accountId": { "type": "string", "minLength": 1 },
+    "providerPostId": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["draft", "pending_approval", "published", "deleted", "failed"] },
+    "text": { "type": "string" },
+    "media": {
+      "type": "array",
+      "items": { "type": "object" }
+    },
+    "url": { "type": "string", "format": "uri" },
+    "publishedAt": { "type": "string", "format": "date-time" },
+    "createdByPrincipalType": { "enum": ["user", "agent", "workflow", "plugin"] },
+    "createdByPrincipalId": { "type": "string", "minLength": 1 },
+    "metadata": { "type": "object" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-task.schema.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-task.schema.json",
+  "title": "LogicSRC Task",
+  "type": "object",
+  "required": ["type", "version", "title", "description", "board", "creator_did", "status"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.task" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "description": { "type": "string", "minLength": 1 },
+    "board": { "type": "string", "pattern": "^/[a-z0-9][a-z0-9/_-]*$" },
+    "creator_did": { "$ref": "#/$defs/did" },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft",
+        "open",
+        "funded",
+        "claimed",
+        "in_progress",
+        "submitted",
+        "approved",
+        "paid",
+        "rejected",
+        "disputed",
+        "cancelled",
+        "expired",
+        "refunded"
+      ]
+    },
+    "budget": { "$ref": "#/$defs/money" },
+    "currency": { "type": "string", "minLength": 2, "maxLength": 12 },
+    "deadline": { "type": "string", "format": "date-time" },
+    "skills": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "attachments": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/attachment" }
+    },
+    "external_links": {
+      "type": "array",
+      "items": { "type": "string", "format": "uri" }
+    },
+    "github_repo": { "type": "string" },
+    "github_issue": { "type": "string" },
+    "target_url": { "type": "string", "format": "uri" },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": { "type": "boolean" }
+    },
+    "assignee_did": { "$ref": "#/$defs/did" },
+    "agent_allowed": { "type": "boolean", "default": true },
+    "human_allowed": { "type": "boolean", "default": true },
+    "escrow_required": { "type": "boolean", "default": false },
+    "payment": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "provider": { "type": "string" },
+        "escrow_id": { "type": "string" },
+        "status": {
+          "type": "string",
+          "enum": [
+            "unfunded",
+            "funding_pending",
+            "funded",
+            "release_pending",
+            "released",
+            "refunded",
+            "disputed",
+            "cancelled",
+            "failed"
+          ]
+        }
+      }
+    },
+    "logicsrc_version": { "type": "string" }
+  },
+  "$defs": {
+    "did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    },
+    "money": {
+      "type": "object",
+      "required": ["amount", "currency"],
+      "additionalProperties": false,
+      "properties": {
+        "amount": { "type": "number", "exclusiveMinimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "attachment": {
+      "type": "object",
+      "required": ["type", "url"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "type": "string" },
+        "name": { "type": "string" },
+        "url": { "type": "string", "format": "uri" },
+        "sha256": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/openprd-prd.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/openprd-prd.schema.json",
+  "title": "OpenPRD Product Requirements Document",
+  "description": "The front-matter manifest of an OpenPRD document. OpenPRD is a lightweight, DIP-style proposal standard: a repo publishes a numbered collection of PRDs under prd/ (prd/NNNN-slug.md), with a 0000-template.md and a README index, committed to the repo like a BIP/EIP/DIP process. This schema governs the YAML front-matter; the body is Markdown with a fixed set of sections. Optional keys MAY be present but empty (null) — the template ships them blank for authors to fill.",
+  "type": "object",
+  "required": ["openprd", "id", "title", "status"],
+  "additionalProperties": false,
+  "properties": {
+    "openprd": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+(\\.\\d+)?$",
+      "description": "OpenPRD standard version this document conforms to, e.g. '0.2'."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^\\d{4}$",
+      "description": "Four-digit zero-padded number, monotonically increasing with no gaps. Matches the filename prefix: prd/<id>-<slug>.md."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Short imperative title — start with a verb where possible."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["Draft", "Review", "Accepted", "Final", "Rejected", "Withdrawn", "Superseded"],
+      "description": "Lifecycle stage. Draft → Review → Accepted → Final; or Rejected/Withdrawn/Superseded."
+    },
+    "authors": {
+      "type": ["array", "null"],
+      "items": { "type": "string" },
+      "uniqueItems": true,
+      "description": "Author identities — email, handle, or DID."
+    },
+    "owner": {
+      "type": ["string", "null"],
+      "description": "Optional DID or handle of the accountable owner (e.g. a LogicSRC account/agent DID)."
+    },
+    "repo": {
+      "type": ["string", "null"],
+      "description": "Optional owner/name of the repository this PRD targets."
+    },
+    "created": {
+      "type": ["string", "null"],
+      "format": "date",
+      "description": "ISO date (YYYY-MM-DD) the PRD was created."
+    },
+    "updated": {
+      "type": ["string", "null"],
+      "format": "date",
+      "description": "ISO date (YYYY-MM-DD) of the last substantive edit."
+    },
+    "discussion": {
+      "type": ["string", "null"],
+      "description": "Optional URL to the PR/issue/thread where this PRD is discussed."
+    },
+    "implementation": {
+      "type": ["string", "null"],
+      "description": "Optional URL/reference to the implementation PR or tracking issue."
+    },
+    "tags": {
+      "type": ["array", "null"],
+      "items": { "type": "string" },
+      "uniqueItems": true,
+      "description": "Optional freeform labels for grouping PRDs."
+    },
+    "supersedes": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{4}$",
+      "description": "Optional id of an earlier PRD this one replaces."
+    },
+    "superseded-by": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{4}$",
+      "description": "Optional id of a later PRD that replaces this one."
+    }
+  }
+}