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

package/dist/specs/resources/aip-22/draft/OFFICE.schema.json

@@ -0,0 +1,390 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentproto.sh/schemas/aip-22/OFFICE.schema.json",
+  "title": "agentoffice/v1 frontmatter (AIP-22)",
+  "description": "Validates the YAML frontmatter portion of an AIP-22 OFFICE.md (workspace root or per-context view). The single doctype 'office.workspace/v1' is used in both modes; the host distinguishes by checking whether `extends` is set. Per-item-kind schemas are delegated to AIP-18 (COLLECTION.md / ITEM.md).",
+  "type": "object",
+  "required": ["schema", "name", "title", "description", "version"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": {
+      "const": "office.workspace/v1",
+      "description": "Discriminator for the AIP-22 workspace doctype."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 96,
+      "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+      "description": "Stable kebab-case identifier for the company or view."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "description": "Human-readable company title."
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000,
+      "description": "One-paragraph statement of purpose: what this company is, who it serves."
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$",
+      "description": "Semantic version of the WORKSPACE shape. Bump on collection / orgTree / lint / defaults changes. Independent of the company's content version."
+    },
+    "extends": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(\\.\\./|\\./)[^\\s]+/COMPANY\\.md$",
+      "description": "OPTIONAL — relative path to a parent OFFICE.md. Presence makes the manifest a VIEW; absence makes it a WORKSPACE ROOT. Recursive composition; maximum chain depth is 8."
+    },
+    "appliesTo": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^(ws://(operators|skills)/[a-z][a-z0-9-]*|\\.\\./[^\\s]+)$",
+        "description": "Either a ws:// ref to an AIP-9 operator or AIP-3 skill, or a relative path to a consumer workspace folder."
+      },
+      "uniqueItems": true,
+      "description": "OPTIONAL — list of consumers this VIEW adapts the company for. Hosts MUST refuse the view if any binding does not resolve. Not inherited; views declare their own scope."
+    },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "legalName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200,
+          "description": "OPTIONAL — registered legal name of the entity, if it differs from the title."
+        },
+        "legalEntity": {
+          "type": "string",
+          "pattern": "^ws://companies/[a-z][a-z0-9-]*$",
+          "description": "OPTIONAL — ws:// ref to the legal entity OFFICE.md (self-ref if this manifest IS the legal entity; parent ref if this is a subsidiary view)."
+        },
+        "jurisdiction": {
+          "type": "string",
+          "pattern": "^[A-Z]{2}$",
+          "description": "OPTIONAL — ISO 3166-1 alpha-2 country code for primary jurisdiction (e.g. US, FR, DE, GB)."
+        },
+        "foundedAt": {
+          "type": "string",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+          "description": "OPTIONAL — ISO 8601 date the entity was founded."
+        },
+        "mission": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000,
+          "description": "OPTIONAL — one-paragraph mission statement."
+        },
+        "defaultCurrency": {
+          "type": "string",
+          "pattern": "^[A-Z]{3}$",
+          "description": "OPTIONAL — ISO 4217 default currency code (e.g. USD, EUR, GBP)."
+        },
+        "taxId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "description": "OPTIONAL — tax / VAT identifier."
+        }
+      },
+      "description": "Organisation identity fields. Each leaf field independently overridable via merge; a divisional view MAY narrow `jurisdiction` while inheriting `mission` from the parent."
+    },
+    "executor": {
+      "type": "string",
+      "pattern": "^ws://operators/[a-z][a-z0-9-]*$",
+      "description": "OPTIONAL — AIP-9 default org-level operator. The host activates this operator for company-level prompts when no more-specific operator applies."
+    },
+    "governance": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "description": "OPTIONAL — AIP-7 policy or audit binding. May be a path to an AIP-7 policy file or a ws:// ref. Org-level approvals (role creation, reporting reassignment, jurisdiction change) flow through this ref. Subject to the office_signing_downgrade one-way switch when the bound policy declares signing.required=true."
+    },
+    "work": {
+      "type": "string",
+      "pattern": "^ws://workspaces/[a-z][a-z0-9-]*$",
+      "description": "OPTIONAL — AIP-20 work tracker the company runs. Cross-references on items resolve against the bound work workspace by default."
+    },
+    "agency": {
+      "type": "string",
+      "pattern": "^ws://agencies/[a-z][a-z0-9-]*$",
+      "description": "OPTIONAL — AIP-21 agency context. Set when the company also operates as a commercial agency selling services to external counterparties."
+    },
+    "knowledge": {
+      "type": "string",
+      "pattern": "^ws://wikis/[a-z][a-z0-9-]*(/KNOWLEDGE\\.md)?$",
+      "description": "OPTIONAL — AIP-10 KNOWLEDGE.md ref. The institutional wiki — runbooks, onboarding docs, decision logs."
+    },
+    "playbook": {
+      "type": "string",
+      "pattern": "^ws://playbooks/[a-z][a-z0-9-]*$",
+      "description": "OPTIONAL — AIP-12 active playbook governing culture, values, and operating rhythm."
+    },
+    "collections": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/collectionEntry"
+      },
+      "default": [],
+      "description": "Collections enabled by this organisation. Three forms supported: inline (full COLLECTION.md frontmatter), file ref, or registry import. Merge-by-effective-name (alias if set, otherwise the collection's name) across the extends chain."
+    },
+    "orgTree": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "containment": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Whether org-tree containment is active. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false (would orphan items). Refusal: office_orgtree_disable (HARD)."
+            },
+            "field": {
+              "type": "string",
+              "pattern": "^[a-z][a-zA-Z0-9_]*$",
+              "default": "parent",
+              "description": "Item field name carrying the org-parent ref. Defaults to AIP-18's universal-ish 'parent'."
+            },
+            "rules": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "allowedKinds": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$"
+                  },
+                  "uniqueItems": true,
+                  "description": "OPTIONAL — collection names that participate in the org tree. Items in collections NOT listed here are outside the tree (e.g. policies, objectives) and must not carry containment refs."
+                },
+                "allowedParentKinds": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$"
+                    },
+                    "uniqueItems": true
+                  },
+                  "description": "OPTIONAL — containment matrix. Keys are CHILD collection names; values are arrays of allowed PARENT collection names. The host enforces this at item-write time. Per-item violations: office_orgtree_invalid_parent_kind (HARD)."
+                },
+                "maxDepth": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 16,
+                  "description": "OPTIONAL — maximum org-tree depth. ONE-WAY SWITCH on widening: once set at any ancestor, descendants may narrow (smaller value) but MUST NOT widen. Refusal: office_orgtree_depth_widen (HARD)."
+                }
+              },
+              "description": "OPTIONAL containment rules."
+            }
+          },
+          "description": "Org-tree containment axis. AIP-22's distinctive concept: which collection kinds nest under which, how deep the tree goes."
+        },
+        "reporting": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Whether the reporting graph is active. When false, the host does not validate reportsTo refs."
+            },
+            "field": {
+              "type": "string",
+              "pattern": "^[a-z][a-zA-Z0-9_]*$",
+              "default": "reportsTo",
+              "description": "Item field name carrying the reporting (manager) ref. Distinct from the containment field — a role's manager is logically separate from its containment parent."
+            },
+            "cardinality": {
+              "enum": ["single", "multiple"],
+              "default": "single",
+              "description": "Reporting cardinality. 'single' (typical) = one manager per role; 'multiple' = matrixed (role MAY report to multiple managers, the field becomes an array)."
+            },
+            "rules": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "mustResolveTo": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+                  "default": "role",
+                  "description": "Collection name the report target MUST resolve to. Typically 'role' (a role reports to another role). The host MUST refuse a reportsTo ref pointing at a different kind."
+                },
+                "circularBan": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Whether reporting cycles are banned. Default true. The host MUST walk the reportsTo chain on every write and refuse a write that would close a cycle (office_orgtree_circular_report, HARD)."
+                }
+              },
+              "description": "Reporting graph constraints."
+            }
+          },
+          "description": "Reporting / authority graph. Logically separate from containment; a role's manager is independent from its containment parent."
+        }
+      },
+      "description": "Org-tree declaration — the AIP-22 distinctive concept. Containment governs the structural tree; reporting governs the authority graph."
+    },
+    "lints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "kind", "severity"],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$",
+            "description": "Stable kebab-case lint id. Merge key when composing with extends parent."
+          },
+          "kind": {
+            "enum": [
+              "orphan-role",
+              "broken-report",
+              "missing-manager",
+              "unassigned-objective",
+              "stale-objective",
+              "custom"
+            ],
+            "description": "Workspace-spanning lint algorithm. AIP-18 per-collection lints (missing-owner, overdue, required-field, etc.) live on COLLECTION.md and are NOT redeclared here. 'custom' delegates to a host-defined check identified by `id`."
+          },
+          "severity": {
+            "enum": ["error", "warn", "info"],
+            "description": "Lint severity. Children may soften; governance policies MAY forbid softening below `error`."
+          },
+          "params": {
+            "type": "object",
+            "additionalProperties": true,
+            "default": {},
+            "description": "Kind-specific parameters. e.g. { collections: [role] } for orphan-role; { days: 30 } for stale-objective."
+          }
+        }
+      },
+      "default": [],
+      "description": "Workspace-spanning lints. Merge-by-id vs parent."
+    },
+    "defaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "workflow": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "description": "OPTIONAL — default AIP-15 WORKFLOW.md path or ref. Routine workflow run against company items (e.g. monthly reporting-graph integrity sweep)."
+        },
+        "approvalClass": {
+          "type": "string",
+          "pattern": "^(auto|always|on-mutate|policy:[A-Za-z0-9_./:-]+)$",
+          "description": "Approval class for mutations. 'auto' = no gate; 'always' = every mutation requires approval; 'on-mutate' = approval on field-level mutations; 'policy:<ref>' = delegate to an AIP-7 policy."
+        },
+        "auditMutations": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether mutations are audited. ONE-WAY SWITCH: once true at any ancestor, descendants MUST NOT set false. Refusal: office_audit_downgrade (HARD)."
+        }
+      },
+      "description": "Routine workflow defaults. Composes with AIP-15."
+    },
+    "display": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "homePage": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_:-]*$",
+          "description": "OPTIONAL — id of the item to use as the company landing page (e.g. a top-level department or the founder role)."
+        },
+        "defaultGrouping": {
+          "enum": ["kind", "department", "parent"],
+          "description": "Default grouping for list views."
+        },
+        "defaultView": {
+          "enum": ["list", "tree", "board"],
+          "description": "Default rendering mode. 'tree' is the typical pick — org charts render naturally as trees."
+        }
+      },
+      "description": "Display hints for UIs that render the company. Runtime-agnostic."
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "default": {},
+      "description": "Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain. MUST NOT change the meaning of any spec field."
+    }
+  },
+  "allOf": [
+    {
+      "description": "A view (any manifest with appliesTo set) MUST extend a parent. A workspace-root manifest has neither field.",
+      "if": {
+        "required": ["appliesTo"],
+        "properties": {
+          "appliesTo": { "type": "array", "minItems": 1 }
+        }
+      },
+      "then": {
+        "required": ["extends"]
+      }
+    }
+  ],
+  "$defs": {
+    "collectionEntry": {
+      "oneOf": [
+        { "$ref": "#/$defs/collectionInline" },
+        { "$ref": "#/$defs/collectionRef" }
+      ],
+      "description": "One collection declaration. Either an inline AIP-18 collection schema, or a ref (path or ws:// URI) optionally aliased and version-pinned."
+    },
+    "collectionInline": {
+      "type": "object",
+      "required": ["inline"],
+      "additionalProperties": false,
+      "properties": {
+        "inline": {
+          "$ref": "https://agentproto.sh/schemas/aip-18/COLLECTION.schema.json#/$defs/schema",
+          "description": "Full AIP-18 collection.schema/v1 frontmatter, parsed in-place. The host registers the collection directly via AIP-18's defineCollection without loading a separate file."
+        }
+      },
+      "description": "Inline collection declaration. Full AIP-18 schema embedded; hosts MUST validate it against the AIP-18 COLLECTION schema before registration."
+    },
+    "collectionRef": {
+      "type": "object",
+      "required": ["ref"],
+      "additionalProperties": false,
+      "properties": {
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^((\\.\\./|\\./)[^\\s]+/COLLECTION\\.md|ws://collections/[a-z][a-z0-9-]*)$",
+          "description": "Either a relative path to a COLLECTION.md (file ref) or a ws://collections/<slug> URI (registry import). The host loads the referenced collection via AIP-18 and registers it under its name (or the alias, if set)."
+        },
+        "alias": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 96,
+          "description": "OPTIONAL — workspace-local name to expose the collection under. Items in this organisation reference the alias, not the upstream name. Two collections resolving to the same effective name (alias or upstream) is a HARD failure: office_collection_alias_conflict."
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "description": "OPTIONAL — semver range (e.g. \"1.x\", \"^1.2\", \"1.2.0\"). When set, schema bumps outside the range fail with collection_item_schema_pinned_drift (HARD) at item load time."
+        }
+      },
+      "description": "Collection ref declaration. Either a file path (./.. /COLLECTION.md) or a registry URI (ws://collections/<slug>)."
+    }
+  }
+}