@logicsrc/schemas 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @logicsrc/schemas
+
+Canonical JSON Schemas (draft 2020-12) for the LogicSRC open coordination
+standards, maintained by Profullstack, Inc.
+
+Two schema families ship from this package:
+
+- **LogicSRC core** — `logicsrc-*.schema.json`: tasks, agents, runs, events,
+  plugins, connected accounts, email messages, social posts.
+- **AgentAd** — `agentad-*.schema.json`: a disclosed, agent-readable advertising
+  contract for CLI tools and AI agents (ads, placements, requests, responses,
+  impressions, clicks, campaigns). See `docs/agentad.md` in the repo;
+  [cl1s.tech](https://github.com/profullstack/cl1s.tech) is the reference network.
+
+## Install
+
+```bash
+npm install @logicsrc/schemas
+```
+
+## Use
+
+```js
+import adSchema from "@logicsrc/schemas/agentad-ad" with { type: "json" };
+import taskSchema from "@logicsrc/schemas/task" with { type: "json" };
+```
+
+Schema `$id`s resolve under `https://schemas.logicsrc.com/`. Validate with any
+draft 2020-12 validator (e.g. `ajv/dist/2020.js`), or use `@logicsrc/validators`
+from the monorepo.
+
+## License
+
+MIT © Profullstack, Inc.

package/fixtures/agent.yaml

@@ -0,0 +1,20 @@
+type: logicsrc.agent
+version: "0.1"
+name: Playwright QA Agent
+did: qa-agent-01.coinpay
+owner_did: anthony.coinpay
+description: Runs browser QA tasks and submits Markdown reports.
+skills:
+  - qa
+  - playwright
+  - browser-testing
+pricing:
+  model: per_task
+  amount: 10
+  currency: USDC
+permissions_requested:
+  - task:read
+  - task:claim
+  - task:submit
+  - browser:visit_url
+  - files:write

package/fixtures/agentad-ad.yaml

@@ -0,0 +1,33 @@
+type: agentad.ad
+version: "0.1"
+id: deploy-faster-railway
+campaign_id: railway-q3
+advertiser_did: railway.coinpay
+format: markdown
+title: Ship your CLI to production in 60 seconds
+body: Railway deploys any Node, Bun, or Go service straight from your terminal. No YAML wrangling.
+url: https://railway.app/?ref=cl1s
+cta: Deploy now
+disclosure:
+  sponsored: true
+  label: Sponsored
+  advertiser_name: Railway
+machine_readable:
+  product: railway
+  category: infrastructure
+  install: "npm i -g @railway/cli"
+targeting:
+  surfaces:
+    - cli
+    - agent
+  keywords:
+    - deploy
+    - hosting
+    - infrastructure
+  tools:
+    - claude-code
+    - gh
+pricing:
+  model: cpc
+  bid: 0.4
+  currency: USDC

package/fixtures/agentad-placement.yaml

@@ -0,0 +1,21 @@
+type: agentad.placement
+version: "0.1"
+id: cli-footer-slot
+publisher_did: mytool.coinpay
+surface: cli
+accepted_formats:
+  - text
+  - ansi
+  - json
+dimensions:
+  max_width: 80
+  max_lines: 4
+context_tags:
+  - devtools
+  - deploy
+frequency_cap:
+  max_per_session: 1
+  max_per_day: 5
+block_categories:
+  - gambling
+  - crypto-tokens

package/fixtures/opencontext/conformance.json

@@ -0,0 +1,279 @@
+{
+  "opencontextConformance": "1.0",
+  "description": "Conformance fixtures for LogicSRC OpenContext. A third-party implementation can run these against the published JSON Schemas with no LogicSRC code: every valid fixture MUST validate, and every invalid fixture MUST fail for the stated reason. The resolution/ scenarios go further and pin resolver behaviour — scope, authority, supersession, lifecycle, and redaction — which schemas alone cannot express.",
+  "schemas": {
+    "manifest": "https://logicsrc.com/schemas/opencontext/manifest.schema.json",
+    "object": "https://logicsrc.com/schemas/opencontext/object.schema.json",
+    "bundle": "https://logicsrc.com/schemas/opencontext/bundle.schema.json",
+    "role": "https://logicsrc.com/schemas/opencontext/role.schema.json",
+    "provenance": "https://logicsrc.com/schemas/opencontext/provenance.schema.json",
+    "decision": "https://logicsrc.com/schemas/opencontext/decision.schema.json",
+    "diagnostic": "https://logicsrc.com/schemas/opencontext/diagnostic.schema.json",
+    "audit-event": "https://logicsrc.com/schemas/opencontext/audit-event.schema.json"
+  },
+  "valid": [
+    {
+      "fixture": "valid/manifest.json",
+      "kind": "opencontext-manifest"
+    },
+    {
+      "fixture": "valid/manifest-minimal.json",
+      "kind": "opencontext-manifest"
+    },
+    {
+      "fixture": "valid/object-policy.json",
+      "kind": "opencontext-object"
+    },
+    {
+      "fixture": "valid/object-minimal.json",
+      "kind": "opencontext-object"
+    },
+    {
+      "fixture": "valid/object-structured.json",
+      "kind": "opencontext-object"
+    },
+    {
+      "fixture": "valid/object-untrusted.json",
+      "kind": "opencontext-object"
+    },
+    {
+      "fixture": "valid/decision.json",
+      "kind": "opencontext-decision"
+    },
+    {
+      "fixture": "valid/role.json",
+      "kind": "opencontext-role"
+    },
+    {
+      "fixture": "valid/provenance.json",
+      "kind": "opencontext-provenance"
+    },
+    {
+      "fixture": "valid/provenance-canonical.json",
+      "kind": "opencontext-provenance"
+    },
+    {
+      "fixture": "valid/bundle.json",
+      "kind": "opencontext-bundle"
+    },
+    {
+      "fixture": "valid/diagnostic.json",
+      "kind": "opencontext-diagnostic"
+    },
+    {
+      "fixture": "valid/audit-event.json",
+      "kind": "opencontext-audit-event"
+    }
+  ],
+  "invalid": [
+    {
+      "fixture": "invalid/manifest-missing-version.json",
+      "kind": "opencontext-manifest",
+      "why": "manifest has no opencontext version"
+    },
+    {
+      "fixture": "invalid/manifest-bad-id.json",
+      "kind": "opencontext-manifest",
+      "why": "namespace id must be a lowercase slug"
+    },
+    {
+      "fixture": "invalid/manifest-unknown-key.json",
+      "kind": "opencontext-manifest",
+      "why": "unknown top-level key (contexts vs context)"
+    },
+    {
+      "fixture": "invalid/manifest-bad-authority.json",
+      "kind": "opencontext-manifest",
+      "why": "authority precedence contains a level that is not defined"
+    },
+    {
+      "fixture": "invalid/manifest-bad-ttl.json",
+      "kind": "opencontext-manifest",
+      "why": "duration must look like 30d"
+    },
+    {
+      "fixture": "invalid/manifest-role-bad-pattern.json",
+      "kind": "opencontext-manifest",
+      "why": "a wildcard must be a whole segment, never a substring"
+    },
+    {
+      "fixture": "invalid/manifest-bad-extension.json",
+      "kind": "opencontext-manifest",
+      "why": "extension keys must be reverse-DNS namespaced"
+    },
+    {
+      "fixture": "invalid/object-missing-type.json",
+      "kind": "opencontext-object",
+      "why": "type is required"
+    },
+    {
+      "fixture": "invalid/object-missing-id.json",
+      "kind": "opencontext-object",
+      "why": "id is required"
+    },
+    {
+      "fixture": "invalid/object-bad-id.json",
+      "kind": "opencontext-object",
+      "why": "id must be a dotted lowercase slug"
+    },
+    {
+      "fixture": "invalid/object-unknown-authority.json",
+      "kind": "opencontext-object",
+      "why": "authority must be one of the six defined levels"
+    },
+    {
+      "fixture": "invalid/object-unknown-classification.json",
+      "kind": "opencontext-object",
+      "why": "classification must be public/internal/confidential/restricted"
+    },
+    {
+      "fixture": "invalid/object-unknown-trust.json",
+      "kind": "opencontext-object",
+      "why": "trust must be trusted/verified/untrusted"
+    },
+    {
+      "fixture": "invalid/object-extra-property.json",
+      "kind": "opencontext-object",
+      "why": "unknown field must go under extensions"
+    },
+    {
+      "fixture": "invalid/object-confidence-out-of-range.json",
+      "kind": "opencontext-object",
+      "why": "confidence must be between 0 and 1"
+    },
+    {
+      "fixture": "invalid/object-bad-digest.json",
+      "kind": "opencontext-object",
+      "why": "source digest must be sha256:<64 hex>"
+    },
+    {
+      "fixture": "invalid/object-bad-layer.json",
+      "kind": "opencontext-object",
+      "why": "layer must be L0 to L5"
+    },
+    {
+      "fixture": "invalid/object-source-without-uri.json",
+      "kind": "opencontext-object",
+      "why": "every source needs a uri"
+    },
+    {
+      "fixture": "invalid/object-bad-supersedes.json",
+      "kind": "opencontext-object",
+      "why": "version pin must be @<integer>"
+    },
+    {
+      "fixture": "invalid/object-bad-redaction-mode.json",
+      "kind": "opencontext-object",
+      "why": "redaction mode must be remove/mask/hash"
+    },
+    {
+      "fixture": "invalid/decision-missing-decision.json",
+      "kind": "opencontext-decision",
+      "why": "a decision record must state the decision"
+    },
+    {
+      "fixture": "invalid/decision-wrong-type.json",
+      "kind": "opencontext-decision",
+      "why": "type must be decision"
+    },
+    {
+      "fixture": "invalid/decision-bad-status.json",
+      "kind": "opencontext-decision",
+      "why": "status must be proposed/accepted/rejected/superseded/deprecated"
+    },
+    {
+      "fixture": "invalid/bundle-missing-digest.json",
+      "kind": "opencontext-bundle",
+      "why": "a bundle must carry a digest"
+    },
+    {
+      "fixture": "invalid/bundle-bad-digest.json",
+      "kind": "opencontext-bundle",
+      "why": "digest must be sha256:<64 hex>"
+    },
+    {
+      "fixture": "invalid/bundle-bad-id.json",
+      "kind": "opencontext-bundle",
+      "why": "bundle_id must be prefixed ocb_"
+    },
+    {
+      "fixture": "invalid/bundle-unknown-exclusion-reason.json",
+      "kind": "opencontext-bundle",
+      "why": "exclusion reasons are a closed set"
+    },
+    {
+      "fixture": "invalid/role-bad-classification.json",
+      "kind": "opencontext-role",
+      "why": "max_classification must be one of the four bands"
+    },
+    {
+      "fixture": "invalid/role-bad-include.json",
+      "kind": "opencontext-role",
+      "why": "scope patterns are lowercase"
+    },
+    {
+      "fixture": "invalid/provenance-no-source.json",
+      "kind": "opencontext-provenance",
+      "why": "must declare sources or canonical_source"
+    },
+    {
+      "fixture": "invalid/provenance-canonical-false.json",
+      "kind": "opencontext-provenance",
+      "why": "canonical_source: false does not satisfy the requirement"
+    },
+    {
+      "fixture": "invalid/diagnostic-unknown-code.json",
+      "kind": "opencontext-diagnostic",
+      "why": "diagnostic codes are normative and closed"
+    },
+    {
+      "fixture": "invalid/diagnostic-missing-ok.json",
+      "kind": "opencontext-diagnostic",
+      "why": "ok is required — it is what the exit code follows"
+    },
+    {
+      "fixture": "invalid/audit-event-unknown-event.json",
+      "kind": "opencontext-audit-event",
+      "why": "event names are a closed set"
+    },
+    {
+      "fixture": "invalid/audit-event-missing-actor.json",
+      "kind": "opencontext-audit-event",
+      "why": "an audit event without an actor is not attributable"
+    }
+  ],
+  "resolution": [
+    {
+      "scenario": "resolution/authority-conflict",
+      "expected": "resolution/authority-conflict/expected.json"
+    },
+    {
+      "scenario": "resolution/classification-ceiling",
+      "expected": "resolution/classification-ceiling/expected.json"
+    },
+    {
+      "scenario": "resolution/deny-overrides-allow",
+      "expected": "resolution/deny-overrides-allow/expected.json"
+    },
+    {
+      "scenario": "resolution/duplicate-canonical",
+      "expected": "resolution/duplicate-canonical/expected.json"
+    },
+    {
+      "scenario": "resolution/lifecycle",
+      "expected": "resolution/lifecycle/expected.json"
+    },
+    {
+      "scenario": "resolution/object-permissions",
+      "expected": "resolution/object-permissions/expected.json"
+    },
+    {
+      "scenario": "resolution/redaction",
+      "expected": "resolution/redaction/expected.json"
+    },
+    {
+      "scenario": "resolution/supersession",
+      "expected": "resolution/supersession/expected.json"
+    }
+  ]
+}

package/fixtures/opencontext/invalid/audit-event-missing-actor.json

@@ -0,0 +1,5 @@
+{
+  "opencontext": "1.0",
+  "event": "context.read",
+  "at": "2026-08-09T15:00:00Z"
+}

package/fixtures/opencontext/invalid/audit-event-unknown-event.json

@@ -0,0 +1,9 @@
+{
+  "opencontext": "1.0",
+  "event": "context.peek",
+  "at": "2026-08-09T15:00:00Z",
+  "actor": {
+    "type": "agent",
+    "id": "a"
+  }
+}

package/fixtures/opencontext/invalid/bundle-bad-digest.json

@@ -0,0 +1,11 @@
+{
+  "opencontext": "1.0",
+  "bundle_id": "ocb_abc",
+  "generated_at": "2026-08-09T15:00:00Z",
+  "consumer": {
+    "type": "agent",
+    "id": "a"
+  },
+  "objects": [],
+  "digest": "sha1:abc"
+}

package/fixtures/opencontext/invalid/bundle-bad-id.json

@@ -0,0 +1,11 @@
+{
+  "opencontext": "1.0",
+  "bundle_id": "bundle-1",
+  "generated_at": "2026-08-09T15:00:00Z",
+  "consumer": {
+    "type": "agent",
+    "id": "a"
+  },
+  "objects": [],
+  "digest": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
+}

package/fixtures/opencontext/invalid/bundle-missing-digest.json

@@ -0,0 +1,10 @@
+{
+  "opencontext": "1.0",
+  "bundle_id": "ocb_abc",
+  "generated_at": "2026-08-09T15:00:00Z",
+  "consumer": {
+    "type": "agent",
+    "id": "a"
+  },
+  "objects": []
+}

package/fixtures/opencontext/invalid/bundle-unknown-exclusion-reason.json

@@ -0,0 +1,17 @@
+{
+  "opencontext": "1.0",
+  "bundle_id": "ocb_abc",
+  "generated_at": "2026-08-09T15:00:00Z",
+  "consumer": {
+    "type": "agent",
+    "id": "a"
+  },
+  "objects": [],
+  "excluded": [
+    {
+      "id": "x",
+      "reason": "vibes"
+    }
+  ],
+  "digest": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
+}

package/fixtures/opencontext/invalid/decision-bad-status.json

@@ -0,0 +1,7 @@
+{
+  "id": "decision.2026-08-09-x",
+  "type": "decision",
+  "title": "X",
+  "decision": "Do X.",
+  "status": "maybe"
+}

package/fixtures/opencontext/invalid/decision-missing-decision.json

@@ -0,0 +1,5 @@
+{
+  "id": "decision.2026-08-09-x",
+  "type": "decision",
+  "title": "X"
+}

package/fixtures/opencontext/invalid/decision-wrong-type.json

@@ -0,0 +1,6 @@
+{
+  "id": "decision.2026-08-09-x",
+  "type": "policy",
+  "title": "X",
+  "decision": "Do X."
+}

package/fixtures/opencontext/invalid/diagnostic-missing-ok.json

@@ -0,0 +1,4 @@
+{
+  "opencontext": "1.0",
+  "findings": []
+}

package/fixtures/opencontext/invalid/diagnostic-unknown-code.json

@@ -0,0 +1,11 @@
+{
+  "opencontext": "1.0",
+  "ok": false,
+  "findings": [
+    {
+      "code": "vibes-off",
+      "severity": "error",
+      "message": "x"
+    }
+  ]
+}

package/fixtures/opencontext/invalid/manifest-bad-authority.json

@@ -0,0 +1,10 @@
+{
+  "opencontext": "1.0",
+  "id": "acme",
+  "authority": {
+    "precedence": [
+      "gospel",
+      "canonical"
+    ]
+  }
+}

package/fixtures/opencontext/invalid/manifest-bad-extension.json

@@ -0,0 +1,9 @@
+{
+  "opencontext": "1.0",
+  "id": "acme",
+  "extensions": {
+    "risk": {
+      "score": 1
+    }
+  }
+}

package/fixtures/opencontext/invalid/manifest-bad-id.json

@@ -0,0 +1,4 @@
+{
+  "opencontext": "1.0",
+  "id": "ACME Corp"
+}

package/fixtures/opencontext/invalid/manifest-bad-ttl.json

@@ -0,0 +1,7 @@
+{
+  "opencontext": "1.0",
+  "id": "acme",
+  "freshness": {
+    "default_ttl": "30 days"
+  }
+}

package/fixtures/opencontext/invalid/manifest-missing-version.json

@@ -0,0 +1,3 @@
+{
+  "id": "acme"
+}

package/fixtures/opencontext/invalid/manifest-role-bad-pattern.json

@@ -0,0 +1,11 @@
+{
+  "opencontext": "1.0",
+  "id": "acme",
+  "roles": {
+    "support": {
+      "include": [
+        "policies.*support"
+      ]
+    }
+  }
+}

package/fixtures/opencontext/invalid/manifest-unknown-key.json

@@ -0,0 +1,5 @@
+{
+  "opencontext": "1.0",
+  "id": "acme",
+  "contexts": {}
+}

package/fixtures/opencontext/invalid/object-bad-digest.json

@@ -0,0 +1,10 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "sources": [
+    {
+      "uri": "https://example.com/p",
+      "digest": "md5:abc"
+    }
+  ]
+}

package/fixtures/opencontext/invalid/object-bad-id.json

@@ -0,0 +1,4 @@
+{
+  "id": "Policy Refunds",
+  "type": "policy"
+}

package/fixtures/opencontext/invalid/object-bad-layer.json

@@ -0,0 +1,5 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "layer": "L6"
+}

package/fixtures/opencontext/invalid/object-bad-redaction-mode.json

@@ -0,0 +1,10 @@
+{
+  "id": "c.acme",
+  "type": "customer",
+  "redact": [
+    {
+      "path": "ssn",
+      "mode": "shred"
+    }
+  ]
+}

package/fixtures/opencontext/invalid/object-bad-supersedes.json

@@ -0,0 +1,7 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "supersedes": [
+    "policy.refunds@v2"
+  ]
+}

package/fixtures/opencontext/invalid/object-confidence-out-of-range.json

@@ -0,0 +1,5 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "confidence": 1.5
+}

package/fixtures/opencontext/invalid/object-extra-property.json

@@ -0,0 +1,5 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "authorship": "support"
+}

package/fixtures/opencontext/invalid/object-missing-id.json

@@ -0,0 +1,3 @@
+{
+  "type": "policy"
+}

package/fixtures/opencontext/invalid/object-missing-type.json

@@ -0,0 +1,3 @@
+{
+  "id": "policy.refunds"
+}

package/fixtures/opencontext/invalid/object-source-without-uri.json

@@ -0,0 +1,9 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "sources": [
+    {
+      "type": "document"
+    }
+  ]
+}

package/fixtures/opencontext/invalid/object-unknown-authority.json

@@ -0,0 +1,5 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "authority": "gospel"
+}

package/fixtures/opencontext/invalid/object-unknown-classification.json

@@ -0,0 +1,5 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "classification": "secret"
+}

package/fixtures/opencontext/invalid/object-unknown-trust.json

@@ -0,0 +1,5 @@
+{
+  "id": "policy.refunds",
+  "type": "policy",
+  "trust": "probably-fine"
+}