@agentproto/corpus-cli 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/specs/resources/aip-4/draft/DESIGN.schema.json

@@ -0,0 +1,189 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-4/DESIGN.schema.json",
+  "title": "DESIGN.md frontmatter (AIP-4)",
+  "description": "Validates the YAML frontmatter portion of an AIP-4 DESIGN.md design-token kit.",
+  "type": "object",
+  "required": ["kit", "title", "colors", "typography"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": {
+      "const": "designkit/v1",
+      "description": "Pins the registry schema this kit conforms to. Required for registry submission."
+    },
+    "kit": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 48,
+      "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+      "description": "Kebab-case kit identifier. Namespaced by the registry on publish."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "description": "Human-readable display name."
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "One-paragraph summary surfaced in registry search results."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][a-zA-Z0-9.-]+)?$",
+      "description": "Semver of THIS kit. Bump on token change."
+    },
+    "author": {
+      "type": "string",
+      "description": "Display name of the author / maintainer."
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX identifier or 'proprietary' for private brand kits."
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri"
+    },
+    "preview": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to a screenshot of the kit applied to a reference surface."
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+      "minItems": 0,
+      "maxItems": 12,
+      "default": []
+    },
+    "based-on": {
+      "type": "string",
+      "description": "URI of a parent DESIGN.md to compose on top of. Depth-limited to 3."
+    },
+    "mode": {
+      "enum": ["light", "dark", "both"],
+      "default": "light",
+      "description": "Default surface mode. 'both' requires a sibling 'variants' block."
+    },
+    "colors": { "$ref": "#/$defs/colorTokens" },
+    "typography": { "$ref": "#/$defs/typographyTokens" },
+    "spacing": { "$ref": "#/$defs/scaleTokens" },
+    "rounded": { "$ref": "#/$defs/scaleTokens" },
+    "shadows": { "$ref": "#/$defs/scaleTokens" },
+    "motion": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "duration": { "$ref": "#/$defs/scaleTokens" },
+        "easing": { "$ref": "#/$defs/scaleTokens" }
+      }
+    },
+    "variants": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "dark": { "$ref": "#/$defs/variantDelta" },
+        "light": { "$ref": "#/$defs/variantDelta" }
+      },
+      "description": "Delta blocks per mode. Only tokens that differ from the base are listed."
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Host-namespaced extension fields. Other hosts MUST tolerate unknown keys here.",
+      "default": {}
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "mode": { "const": "both" } },
+        "required": ["mode"]
+      },
+      "then": { "required": ["variants"] }
+    }
+  ],
+  "$defs": {
+    "colorTokens": {
+      "type": "object",
+      "required": ["background", "ink", "primary"],
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1,
+        "description": "Hex (#RGB / #RRGGBB / #RRGGBBAA), rgb(a), hsl(a), or '{colors.<name>}' reference."
+      },
+      "properties": {
+        "background": { "type": "string" },
+        "surface": { "type": "string" },
+        "ink": { "type": "string" },
+        "ink-muted": { "type": "string" },
+        "primary": { "type": "string" },
+        "on-primary": { "type": "string" },
+        "accent": { "type": "string" },
+        "on-accent": { "type": "string" },
+        "muted": { "type": "string" },
+        "muted-foreground": { "type": "string" },
+        "border": { "type": "string" },
+        "link": { "type": "string" },
+        "success": { "type": "string" },
+        "warning": { "type": "string" },
+        "danger": { "type": "string" }
+      }
+    },
+    "typographyTokens": {
+      "type": "object",
+      "required": ["body", "h1"],
+      "additionalProperties": { "$ref": "#/$defs/typeStyle" },
+      "properties": {
+        "body": { "$ref": "#/$defs/typeStyle" },
+        "h1": { "$ref": "#/$defs/typeStyle" },
+        "h2": { "$ref": "#/$defs/typeStyle" },
+        "h3": { "$ref": "#/$defs/typeStyle" },
+        "h4": { "$ref": "#/$defs/typeStyle" },
+        "code": { "$ref": "#/$defs/typeStyle" },
+        "small": { "$ref": "#/$defs/typeStyle" }
+      }
+    },
+    "typeStyle": {
+      "type": "object",
+      "required": ["family"],
+      "additionalProperties": false,
+      "properties": {
+        "family": { "type": "string", "minLength": 1 },
+        "size": { "type": "string" },
+        "weight": { "type": ["integer", "string"] },
+        "lineHeight": { "type": ["number", "string"] },
+        "letterSpacing": { "type": "string" }
+      }
+    },
+    "scaleTokens": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "variantDelta": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "colors": { "$ref": "#/$defs/scaleTokens" },
+        "typography": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/typeStyle" }
+        },
+        "spacing": { "$ref": "#/$defs/scaleTokens" },
+        "rounded": { "$ref": "#/$defs/scaleTokens" },
+        "shadows": { "$ref": "#/$defs/scaleTokens" },
+        "motion": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "duration": { "$ref": "#/$defs/scaleTokens" },
+            "easing": { "$ref": "#/$defs/scaleTokens" }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/specs/resources/aip-40/draft/EXTENSION.schema.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-40/EXTENSION.schema.json",
+  "title": "ExtensionDefinition",
+  "description": "Validates the YAML frontmatter portion of an AIP-40 EXTENSION.md manifest. An extension declares a workspace-local doctype that inherits a public AIP's schema and may add fields, tighten constraints, set defaults, and override the path convention.",
+  "type": "object",
+  "required": ["schema", "slug", "title", "description", "version", "status", "extends"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": {
+      "const": "agentproto/extension/v1",
+      "description": "Pins the spec version this manifest conforms to."
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*:[a-z][a-z0-9-]*[a-z0-9]$",
+      "description": "Namespaced identifier — `<namespace>:<name>`. Lowercase, digits, dashes; single colon separator. Example: `acme:deal`."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "description": "Human-readable display name."
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000,
+      "description": "One-paragraph statement of the extension's purpose."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][a-zA-Z0-9.-]+)?$",
+      "description": "Extension's own semver. Bump on breaking change."
+    },
+    "status": {
+      "const": "Local",
+      "description": "Extensions are perpetually Local — they never enter the public registry's Draft/Review/Final lifecycle."
+    },
+    "extends": {
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^aip-\\d+$",
+          "description": "Inherit a public AIP's schema (e.g. `aip-14`)."
+        },
+        {
+          "const": "none",
+          "description": "Brand-new doctype, no inheritance."
+        }
+      ],
+      "description": "Parent AIP this extension inherits from, or `none` for a root doctype."
+    },
+    "add_fields": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "properties": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "JSON Schema property definitions to merge into the parent's properties. Collisions are an error — use `tighten` to narrow an existing field."
+        },
+        "required": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true,
+          "default": [],
+          "description": "Field names that become required in addition to parent's required[]. Unioned with parent's required, never replaces."
+        }
+      },
+      "description": "Schema-level additions: new properties + new required entries."
+    },
+    "tighten": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "pattern": { "type": "string" },
+          "enum": { "type": "array" },
+          "minLength": { "type": "integer", "minimum": 0 },
+          "maxLength": { "type": "integer", "minimum": 0 },
+          "minimum": { "type": "number" },
+          "maximum": { "type": "number" }
+        }
+      },
+      "description": "Per-field constraint overrides. Each entry MUST tighten (not loosen) the parent's constraints; runtimes verify monotonicity at registration."
+    },
+    "defaults": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Default values applied when a field is omitted. Layered on top of parent's defaults; extension's value wins on the same key."
+    },
+    "path_convention": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Filesystem convention template, e.g. `\"deals/<slug>/DEAL.md\"`. Tokens: `<slug>` (doctype identity), `<DOCTYPE>` (extension's slug name part). Falls back to parent's convention when omitted."
+    },
+    "requires": {
+      "type": "array",
+      "items": {
+        "type": "integer",
+        "minimum": 1
+      },
+      "uniqueItems": true,
+      "default": [],
+      "description": "Public AIPs the extension depends on, in addition to its parent."
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "default": {},
+      "description": "Free-form vendor extensions under namespaced keys (`metadata.<vendor>.<field>`)."
+    }
+  }
+}

package/dist/specs/resources/aip-41/draft/ROUTINE.schema.json

@@ -0,0 +1,345 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-41/ROUTINE.schema.json",
+  "title": "ROUTINE.md frontmatter — agentroutine/v1 (recurring schedule + target)",
+  "description": "Validates the YAML frontmatter portion of an AIP-41 ROUTINE.md manifest. Decouples 'when' (schedule) from 'what' (target action/workflow/tool).",
+  "type": "object",
+  "required": ["schema", "id", "description", "schedule", "target"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": {
+      "const": "routine/v1"
+    },
+    "id": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 80,
+      "pattern": "^[a-z0-9@][a-z0-9.@/_-]*$",
+      "description": "Machine identifier. Lowercase, digits, dashes, dots, optional @owner/ prefix. Unique within the registry that hosts the routine."
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000,
+      "description": "One-paragraph purpose."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.\\-]+)?$",
+      "default": "1.0.0",
+      "description": "Spec version of THIS file."
+    },
+    "schedule": {
+      "$ref": "#/$defs/schedule",
+      "description": "When the routine fires."
+    },
+    "target": {
+      "$ref": "#/$defs/target",
+      "description": "What the routine invokes when it fires."
+    },
+    "identity": {
+      "$ref": "#/$defs/identityRef",
+      "description": "Identity that owns the routine fire (AIP-23). Defaults to host policy."
+    },
+    "retry": {
+      "$ref": "#/$defs/retry",
+      "description": "Retry behaviour on failure."
+    },
+    "on_failure": {
+      "$ref": "#/$defs/onFailure",
+      "description": "Where to route failures after retries exhaust."
+    },
+    "history": {
+      "$ref": "#/$defs/history",
+      "description": "Run history retention."
+    },
+    "fires_events": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "default": ["routine-triggered", "routine-completed", "routine-failed"],
+      "description": "AIP-37 LIFECYCLE event names this routine fires."
+    },
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "If false, routine registers but does not fire. Useful for staging."
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": [],
+      "description": "Free-form discovery tags."
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Free-form, namespaced."
+    }
+  },
+  "$defs": {
+    "schedule": {
+      "oneOf": [
+        { "$ref": "#/$defs/scheduleCron" },
+        { "$ref": "#/$defs/scheduleInterval" },
+        { "$ref": "#/$defs/scheduleCalendar" },
+        { "$ref": "#/$defs/scheduleManual" },
+        { "$ref": "#/$defs/scheduleEvent" }
+      ]
+    },
+    "scheduleCron": {
+      "type": "object",
+      "required": ["kind", "cron"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "cron" },
+        "cron": {
+          "type": "string",
+          "minLength": 9,
+          "maxLength": 100,
+          "description": "Standard 5-field cron expression."
+        },
+        "timezone": {
+          "type": "string",
+          "default": "UTC",
+          "description": "IANA tz database name. Legacy abbreviations rejected."
+        },
+        "jitter_seconds": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 3600,
+          "default": 0
+        },
+        "catchup": {
+          "enum": ["skip", "one", "all"],
+          "default": "skip"
+        }
+      }
+    },
+    "scheduleInterval": {
+      "type": "object",
+      "required": ["kind", "every"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "interval" },
+        "every": {
+          "type": "string",
+          "pattern": "^\\d+(s|m|h|d)$",
+          "description": "Duration: Ns | Nm | Nh | Nd."
+        },
+        "from": {
+          "type": "string",
+          "format": "date-time",
+          "description": "OPTIONAL anchor; default = registration time."
+        },
+        "jitter_seconds": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 3600,
+          "default": 0
+        }
+      }
+    },
+    "scheduleCalendar": {
+      "type": "object",
+      "required": ["kind", "rrule"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "calendar" },
+        "rrule": {
+          "type": "string",
+          "minLength": 1,
+          "description": "RFC 5545 RRULE."
+        },
+        "timezone": {
+          "type": "string",
+          "default": "UTC"
+        }
+      }
+    },
+    "scheduleManual": {
+      "type": "object",
+      "required": ["kind"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "manual" }
+      }
+    },
+    "scheduleEvent": {
+      "type": "object",
+      "required": ["kind", "on"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "event" },
+        "on": {
+          "type": "string",
+          "minLength": 1,
+          "description": "AIP-37 LIFECYCLE event name."
+        },
+        "filter": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "OPTIONAL — only fire if event payload matches filter."
+        }
+      }
+    },
+    "target": {
+      "oneOf": [
+        { "$ref": "#/$defs/targetAction" },
+        { "$ref": "#/$defs/targetWorkflow" },
+        { "$ref": "#/$defs/targetTool" }
+      ]
+    },
+    "targetAction": {
+      "type": "object",
+      "required": ["action"],
+      "additionalProperties": false,
+      "properties": {
+        "action": {
+          "type": "string",
+          "minLength": 1,
+          "description": "AIP-39 ACTION ref. Resolver picks tool implementation."
+        },
+        "inputs": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Invocation payload. May reference ${{ vault.* }} and ${{ now }}."
+        }
+      }
+    },
+    "targetWorkflow": {
+      "type": "object",
+      "required": ["workflow"],
+      "additionalProperties": false,
+      "properties": {
+        "workflow": {
+          "oneOf": [
+            { "type": "string", "minLength": 1 },
+            { "$ref": "#/$defs/anyRef" }
+          ],
+          "description": "AIP-15 WORKFLOW ref."
+        },
+        "inputs": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "targetTool": {
+      "type": "object",
+      "required": ["tool"],
+      "additionalProperties": false,
+      "properties": {
+        "tool": {
+          "type": "string",
+          "minLength": 1,
+          "description": "AIP-14 TOOL id (pin specific implementation)."
+        },
+        "inputs": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+    "anyRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "file": { "type": "string", "minLength": 1 },
+        "inline": { "type": "object", "additionalProperties": true }
+      },
+      "description": "AIP-27 ref primitive — exactly one of ref|file|inline."
+    },
+    "identityRef": {
+      "oneOf": [
+        {
+          "type": "string",
+          "minLength": 1,
+          "description": "Shorthand identity URI: operator://<id> | user://<id> | bot://<name> | @<owner>/identities/<slug>"
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "ref": { "type": "string", "minLength": 1 },
+            "file": { "type": "string", "minLength": 1 },
+            "inline": {
+              "type": "object",
+              "properties": {
+                "name": { "type": "string" },
+                "email": { "type": "string" }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "retry": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "max_attempts": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "default": 1
+        },
+        "backoff": {
+          "enum": ["exponential", "linear", "fixed"],
+          "default": "exponential"
+        },
+        "initial_ms": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 60000
+        },
+        "max_ms": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 3600000
+        },
+        "on": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "OPTIONAL — only retry these failure classes."
+        }
+      }
+    },
+    "onFailure": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "notify": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/identityRef" },
+          "description": "Identity-refs to notify."
+        },
+        "create_work_item": {
+          "type": "boolean",
+          "default": false,
+          "description": "Open AIP-13/20 WORK item on retry-exhausted failure."
+        },
+        "fire_event": {
+          "type": "string",
+          "description": "OPTIONAL custom AIP-37 event to fire on failure."
+        }
+      }
+    },
+    "history": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "retain_runs": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 100
+        },
+        "retain_failed": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 30
+        }
+      }
+    }
+  }
+}