@logicsrc/schemas 0.1.0

package/fixtures/openprd/valid/minimal.md

@@ -0,0 +1,41 @@
+---
+openprd: "0.2"
+id: "0001"
+title: Expand the parked-domain service
+status: Draft
+authors:
+  - anthony@profullstack.com
+---
+
+## Problem
+
+The thing is broken and it costs us money every week.
+
+## Goals
+
+_None._
+
+## Non-Goals
+
+_None._
+
+## Users
+
+_None._
+
+## Requirements
+
+- R1 [P0] First required capability.
+
+## UX Notes
+
+_None._
+
+## Success Metrics
+
+_None._
+
+## Risks & Open Questions
+
+_None._
+

package/fixtures/openprd/valid/none-sections.md

@@ -0,0 +1,41 @@
+---
+openprd: "0.2"
+id: "0005"
+title: Keep every section even when empty
+status: Accepted
+authors:
+  - a@example.com
+---
+
+## Problem
+
+The thing is broken and it costs us money every week.
+
+## Goals
+
+_None._
+
+## Non-Goals
+
+_None._
+
+## Users
+
+_None._
+
+## Requirements
+
+- R1 [P0] First required capability.
+
+## UX Notes
+
+_None._
+
+## Success Metrics
+
+_None._
+
+## Risks & Open Questions
+
+_None._
+

package/fixtures/openprd/valid/subsections.md

@@ -0,0 +1,47 @@
+---
+openprd: "0.2"
+id: "0003"
+title: Organize a long requirements section
+status: Draft
+authors:
+  - a@example.com
+---
+
+## Problem
+
+The thing is broken and it costs us money every week.
+
+## Goals
+
+_None._
+
+## Non-Goals
+
+_None._
+
+## Users
+
+_None._
+
+## Requirements
+
+### Identity
+
+- R1 [P0] Capability one.
+
+### Storage
+
+- R2 [P0] Capability two.
+
+## UX Notes
+
+_None._
+
+## Success Metrics
+
+_None._
+
+## Risks & Open Questions
+
+_None._
+

package/fixtures/openprd/valid/superseded.md

@@ -0,0 +1,42 @@
+---
+openprd: "0.2"
+id: "0004"
+title: Retire the old flow
+status: Superseded
+authors:
+  - a@example.com
+superseded-by: "0005"
+---
+
+## Problem
+
+The thing is broken and it costs us money every week.
+
+## Goals
+
+_None._
+
+## Non-Goals
+
+_None._
+
+## Users
+
+_None._
+
+## Requirements
+
+- R1 [P0] First required capability.
+
+## UX Notes
+
+_None._
+
+## Success Metrics
+
+_None._
+
+## Risks & Open Questions
+
+_None._
+

package/fixtures/openprd-prd.yaml

@@ -0,0 +1,12 @@
+openprd: "0.2"
+id: "0001"
+title: Expand the parked-domain service
+status: Draft
+authors:
+  - anthony@profullstack.com
+repo: moshcoder/moshcoding
+created: 2026-07-12
+updated: 2026-07-12
+tags:
+  - growth
+  - monetization

package/fixtures/pull-request.yaml

@@ -0,0 +1,24 @@
+type: logicsrc.pull_request
+version: "1.0"
+repo: agentgit-demo
+number: 7
+title: Add Forgejo backend adapter
+description: Implements the M1 ForgeAdapter against the Forgejo REST API.
+author_did: contributor.profullstack
+source_branch: feat/forgejo-adapter
+target_branch: main
+head_sha: abc1234
+task: task-42
+status: approved
+checks:
+  - name: ci
+    status: passing
+    url: https://git.profullstack.com/owner/agentgit-demo/actions
+reviews:
+  - reviewer_did: maintainer.profullstack
+    decision: approve
+    reputation: 25
+    summary: Looks good, policy-gated merge verified.
+    created_at: 2026-06-14T01:00:00Z
+created_at: 2026-06-14T00:30:00Z
+updated_at: 2026-06-14T01:05:00Z

package/fixtures/repo.yaml

@@ -0,0 +1,27 @@
+type: logicsrc.repo
+version: "1.0"
+name: AgentGit Demo
+slug: agentgit-demo
+description: Reference AgentGit repository hosted on git.profullstack.com.
+owner_did: owner.profullstack
+board: /agentgit
+visibility: members_only
+default_branch: main
+backend:
+  provider: forgejo
+  url: https://git.profullstack.com
+  external_id: owner/agentgit-demo
+members:
+  - did: maintainer.profullstack
+    role: maintainer
+  - did: contributor.profullstack
+    role: contributor
+merge_policy:
+  min_reviews: 1
+  require_passing_checks: true
+  reviewer_reputation_min: 0
+  escrow_required: false
+  allow_agent_merge: true
+  allowed_merge_methods:
+    - squash
+created_at: 2026-06-14T00:00:00Z

package/fixtures/task.yaml

@@ -0,0 +1,26 @@
+type: logicsrc.task
+version: "0.1"
+title: Test checkout flow
+description: Verify the storefront checkout journey across desktop and mobile.
+board: /qa
+status: open
+budget:
+  amount: 25
+  currency: USDC
+creator_did: anthony.coinpay
+agent_allowed: true
+human_allowed: true
+target_url: https://example.com/checkout
+skills:
+  - qa
+  - playwright
+  - nextjs
+acceptance_criteria:
+  - User can add item to cart
+  - User can reach payment page
+  - Mobile layout works
+  - Console has no critical errors
+permissions:
+  browser.visit_url: true
+  github.create_issue: true
+  files.read_attached: true

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@logicsrc/schemas",
+  "version": "0.1.0",
+  "description": "LogicSRC JSON schemas for tasks, agents, runs, events, plugins, the AgentAd ad standard, the OpenOntology knowledge contracts, and the OpenContext context plane.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/profullstack/logicsrc.git",
+    "directory": "packages/schemas"
+  },
+  "homepage": "https://github.com/profullstack/logicsrc/tree/master/packages/schemas",
+  "keywords": [
+    "advertising",
+    "agentad",
+    "agents",
+    "cli",
+    "context",
+    "json-schema",
+    "knowledge-graph",
+    "logicsrc",
+    "ontology",
+    "opencontext",
+    "openontology",
+    "standards"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./account-audit-event": "./schemas/logicsrc-account-audit-event.schema.json",
+    "./account-grant": "./schemas/logicsrc-account-grant.schema.json",
+    "./account-provider": "./schemas/logicsrc-account-provider.schema.json",
+    "./agent": "./schemas/logicsrc-agent.schema.json",
+    "./agentad-ad": "./schemas/agentad-ad.schema.json",
+    "./agentad-ad-request": "./schemas/agentad-ad-request.schema.json",
+    "./agentad-ad-response": "./schemas/agentad-ad-response.schema.json",
+    "./agentad-campaign": "./schemas/agentad-campaign.schema.json",
+    "./agentad-click": "./schemas/agentad-click.schema.json",
+    "./agentad-impression": "./schemas/agentad-impression.schema.json",
+    "./agentad-placement": "./schemas/agentad-placement.schema.json",
+    "./connected-account": "./schemas/logicsrc-connected-account.schema.json",
+    "./credential-audit-event": "./schemas/logicsrc-credential-audit-event.schema.json",
+    "./credential-provider": "./schemas/logicsrc-credential-provider.schema.json",
+    "./credential-sync-plan": "./schemas/logicsrc-credential-sync-plan.schema.json",
+    "./credential-sync-run": "./schemas/logicsrc-credential-sync-run.schema.json",
+    "./email-message": "./schemas/logicsrc-email-message.schema.json",
+    "./event": "./schemas/logicsrc-event.schema.json",
+    "./opencontext-audit-event": "./schemas/logicsrc-opencontext-audit-event.schema.json",
+    "./opencontext-bundle": "./schemas/logicsrc-opencontext-bundle.schema.json",
+    "./opencontext-conformance": "./fixtures/opencontext/conformance.json",
+    "./opencontext-decision": "./schemas/logicsrc-opencontext-decision.schema.json",
+    "./opencontext-diagnostic": "./schemas/logicsrc-opencontext-diagnostic.schema.json",
+    "./opencontext-manifest": "./schemas/logicsrc-opencontext-manifest.schema.json",
+    "./opencontext-object": "./schemas/logicsrc-opencontext-object.schema.json",
+    "./opencontext-provenance": "./schemas/logicsrc-opencontext-provenance.schema.json",
+    "./opencontext-role": "./schemas/logicsrc-opencontext-role.schema.json",
+    "./openontology-action": "./schemas/logicsrc-openontology-action.schema.json",
+    "./openontology-approval": "./schemas/logicsrc-openontology-approval.schema.json",
+    "./openontology-changeset": "./schemas/logicsrc-openontology-changeset.schema.json",
+    "./openontology-claim": "./schemas/logicsrc-openontology-claim.schema.json",
+    "./openontology-conformance": "./fixtures/openontology/conformance.json",
+    "./openontology-constraint": "./schemas/logicsrc-openontology-constraint.schema.json",
+    "./openontology-entity": "./schemas/logicsrc-openontology-entity.schema.json",
+    "./openontology-entity-type": "./schemas/logicsrc-openontology-entity-type.schema.json",
+    "./openontology-event": "./schemas/logicsrc-openontology-event.schema.json",
+    "./openontology-evidence": "./schemas/logicsrc-openontology-evidence.schema.json",
+    "./openontology-manifest": "./schemas/logicsrc-openontology-manifest.schema.json",
+    "./openontology-namespace": "./schemas/logicsrc-openontology-namespace.schema.json",
+    "./openontology-package": "./schemas/logicsrc-openontology-package.schema.json",
+    "./openontology-property": "./schemas/logicsrc-openontology-property.schema.json",
+    "./openontology-query": "./schemas/logicsrc-openontology-query.schema.json",
+    "./openontology-relationship-type": "./schemas/logicsrc-openontology-relationship-type.schema.json",
+    "./openontology-review": "./schemas/logicsrc-openontology-review.schema.json",
+    "./openontology-source": "./schemas/logicsrc-openontology-source.schema.json",
+    "./openprd-prd": "./schemas/openprd-prd.schema.json",
+    "./plugin": "./schemas/logicsrc-plugin.schema.json",
+    "./pull-request": "./schemas/logicsrc-pull-request.schema.json",
+    "./repo": "./schemas/logicsrc-repo.schema.json",
+    "./run": "./schemas/logicsrc-run.schema.json",
+    "./social-post": "./schemas/logicsrc-social-post.schema.json",
+    "./task": "./schemas/logicsrc-task.schema.json"
+  },
+  "files": [
+    "schemas",
+    "fixtures"
+  ],
+  "scripts": {
+    "build": "node -e \"console.log('schemas: no build step')\""
+  }
+}

package/schemas/agentad-ad-request.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/agentad-ad-request.schema.json",
+  "title": "AgentAd Ad Request",
+  "description": "A request from a CLI/agent for an ad to fill a placement, with optional runtime context for relevance.",
+  "type": "object",
+  "required": ["type", "version", "placement_id"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "agentad.ad_request" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "placement_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+    "publisher_did": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$" },
+    "consumer": {
+      "type": "string",
+      "enum": ["human", "agent"],
+      "description": "Who will read the ad. Agents SHOULD receive machine_readable payloads and clear disclosure."
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "tool": { "type": "string", "description": "Host tool identifier, e.g. 'claude-code'." },
+        "keywords": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "language": { "type": "string" },
+        "locale": { "type": "string" }
+      }
+    },
+    "format_override": { "type": "string", "enum": ["text", "markdown", "ansi", "banner", "json"] },
+    "count": { "type": "integer", "minimum": 1, "maximum": 10, "default": 1 }
+  }
+}

package/schemas/agentad-ad-response.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/agentad-ad-response.schema.json",
+  "title": "AgentAd Ad Response",
+  "description": "The network's response to an ad request: zero or more filled ads plus signed tracking tokens for impression/click events.",
+  "type": "object",
+  "required": ["type", "version", "request_id", "ads"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "agentad.ad_response" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "request_id": { "type": "string", "minLength": 1 },
+    "ads": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["ad", "impression_token"],
+        "additionalProperties": false,
+        "properties": {
+          "ad": { "type": "object", "description": "An agentad.ad document; validate separately against agentad-ad.schema.json." },
+          "impression_token": { "type": "string", "minLength": 1, "description": "Opaque token to confirm the impression and to mint a click token." },
+          "rendered": { "type": "string", "description": "Server-rendered representation in the requested format." }
+        }
+      }
+    },
+    "no_fill_reason": {
+      "type": "string",
+      "enum": ["no_inventory", "frequency_capped", "blocked_category", "invalid_request"]
+    }
+  }
+}

package/schemas/agentad-ad.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/agentad-ad.schema.json",
+  "title": "AgentAd Ad",
+  "description": "A single advertising unit served to CLI tools and AI agents. Ads MUST be disclosed and SHOULD carry a machine-readable payload so agents can reason about them.",
+  "type": "object",
+  "required": ["type", "version", "id", "advertiser_did", "format", "title", "url", "disclosure"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "agentad.ad" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "id": { "$ref": "#/$defs/id" },
+    "campaign_id": { "$ref": "#/$defs/id" },
+    "advertiser_did": { "$ref": "#/$defs/did" },
+    "format": {
+      "type": "string",
+      "enum": ["text", "markdown", "ansi", "banner", "json"],
+      "description": "Render format. 'json' is the agent-native structured format; 'ansi'/'banner' target human CLI surfaces."
+    },
+    "title": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "body": { "type": "string", "maxLength": 2000 },
+    "url": { "type": "string", "format": "uri" },
+    "cta": { "type": "string", "maxLength": 60, "description": "Call to action label, e.g. 'Install' or 'Read docs'." },
+    "disclosure": {
+      "type": "object",
+      "description": "Transparency contract. Every ad is labeled as sponsored so humans and agents can distinguish it from organic output.",
+      "required": ["sponsored", "label"],
+      "additionalProperties": false,
+      "properties": {
+        "sponsored": { "const": true },
+        "label": { "type": "string", "minLength": 1, "maxLength": 40, "default": "Sponsored" },
+        "advertiser_name": { "type": "string", "maxLength": 120 }
+      }
+    },
+    "machine_readable": {
+      "type": "object",
+      "description": "Optional structured payload an agent can parse instead of (or alongside) the rendered text.",
+      "additionalProperties": true
+    },
+    "targeting": { "$ref": "#/$defs/targeting" },
+    "media": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "ansi_art": { "type": "string", "description": "Pre-rendered ANSI/ASCII art for banner format." },
+        "icon": { "type": "string", "format": "uri" }
+      }
+    },
+    "pricing": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "model": { "type": "string", "enum": ["cpm", "cpc", "cpa", "flat"] },
+        "bid": { "type": "number", "minimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "expires_at": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$", "minLength": 1, "maxLength": 64 },
+    "did": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$" },
+    "targeting": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "surfaces": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["cli", "tui", "agent", "ci"] },
+          "uniqueItems": true
+        },
+        "keywords": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+        "tools": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true, "description": "Host CLI/agent identifiers to target, e.g. 'claude-code', 'gh'." },
+        "languages": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+        "exclude_keywords": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+      }
+    }
+  }
+}

package/schemas/agentad-campaign.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/agentad-campaign.schema.json",
+  "title": "AgentAd Campaign",
+  "description": "An advertiser campaign grouping one or more ads under a shared budget, schedule, and targeting policy.",
+  "type": "object",
+  "required": ["type", "version", "id", "advertiser_did", "name", "budget"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "agentad.campaign" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$", "minLength": 1, "maxLength": 64 },
+    "advertiser_did": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "status": { "type": "string", "enum": ["draft", "active", "paused", "completed"], "default": "draft" },
+    "budget": {
+      "type": "object",
+      "required": ["total", "currency"],
+      "additionalProperties": false,
+      "properties": {
+        "total": { "type": "number", "minimum": 0 },
+        "daily_cap": { "type": "number", "minimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "schedule": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "start_at": { "type": "string", "format": "date-time" },
+        "end_at": { "type": "string", "format": "date-time" }
+      }
+    },
+    "ad_ids": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+      "uniqueItems": true
+    }
+  }
+}

package/schemas/agentad-click.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/agentad-click.schema.json",
+  "title": "AgentAd Click",
+  "description": "A consumer action on an ad (a click, install, or conversion). For agents, 'action' records the structured intent taken.",
+  "type": "object",
+  "required": ["type", "version", "click_token", "ad_id", "occurred_at"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "agentad.click" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "click_token": { "type": "string", "minLength": 1 },
+    "ad_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+    "placement_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+    "action": {
+      "type": "string",
+      "enum": ["click", "open_url", "copy_command", "install", "convert"],
+      "default": "click"
+    },
+    "consumer": { "type": "string", "enum": ["human", "agent"] },
+    "occurred_at": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/agentad-impression.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/agentad-impression.schema.json",
+  "title": "AgentAd Impression",
+  "description": "A confirmed display of an ad. Recorded only after the ad was actually rendered to the consumer.",
+  "type": "object",
+  "required": ["type", "version", "impression_token", "ad_id", "occurred_at"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "agentad.impression" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "impression_token": { "type": "string", "minLength": 1 },
+    "ad_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+    "placement_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+    "consumer": { "type": "string", "enum": ["human", "agent"] },
+    "occurred_at": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/agentad-placement.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/agentad-placement.schema.json",
+  "title": "AgentAd Placement",
+  "description": "A slot registered by a publisher (a CLI tool or agent) where AgentAd units may be rendered.",
+  "type": "object",
+  "required": ["type", "version", "id", "publisher_did", "surface", "accepted_formats"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "agentad.placement" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$", "minLength": 1, "maxLength": 64 },
+    "publisher_did": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$" },
+    "surface": { "type": "string", "enum": ["cli", "tui", "agent", "ci"] },
+    "accepted_formats": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "enum": ["text", "markdown", "ansi", "banner", "json"] },
+      "uniqueItems": true
+    },
+    "dimensions": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "max_width": { "type": "integer", "minimum": 1, "description": "Max columns for text/ansi rendering." },
+        "max_lines": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "context_tags": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true,
+      "description": "Keywords describing the host context, used for relevance matching."
+    },
+    "frequency_cap": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "max_per_session": { "type": "integer", "minimum": 0 },
+        "max_per_day": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "allow_categories": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+    "block_categories": { "type": "array", "items": { "type": "string" }, "uniqueItems": true }
+  }
+}