@deftai/directive-types 0.65.0 → 0.66.1

package/dist/constants.d.ts

@@ -1,16 +1,24 @@
-/** Canonical vBRIEF schema version exported for downstream contract imports. */
-export declare const VBRIEF_VERSION: "0.6";
+/** Canonical xBRIEF schema version exported for downstream contract imports. */
+export declare const VBRIEF_VERSION: "0.8";
 export type VBriefVersion = typeof VBRIEF_VERSION;
+/** Legacy v0.6 envelope version still accepted by the validator (additive back-compat). */
+export declare const LEGACY_VBRIEF_VERSION: "0.6";
+/** All `*BRIEFInfo.version` values the engine accepts at validation time. */
+export declare const ACCEPTED_VBRIEF_VERSIONS: readonly ["0.6", "0.8"];
 /** npm package identity constant (stable across releases). */
 export declare const TYPES_PACKAGE: "@deftai/directive-types";
 /**
- * vBRIEF#12 extension namespace — keys matching this pattern round-trip preserve-verbatim.
- * Namespaced form: `x-<namespace>/<rest>` (e.g. `x-directive/trace`, `x-vbrief/context`).
+ * xBRIEF#12 extension namespace — keys matching this pattern round-trip preserve-verbatim.
+ * Namespaced form: `x-<namespace>/<rest>` (e.g. `x-directive/trace`, `x-xbrief/context`).
  * @see https://github.com/deftai/vBRIEF/issues/12
  */
 export declare const EXTENSION_KEY_PATTERN: RegExp;
-/** Prefix for schema-conformant vBRIEF reference `type` values. */
+/** Legacy prefix for schema-conformant v0.6 reference `type` values (still accepted). */
 export declare const VBRIEF_REFERENCE_PREFIX: "x-vbrief/";
-/** JSON Schema `$id` for the v0.6 core document (published npm artifact). */
-export declare const VBRIEF_CORE_SCHEMA_ID: "https://vbrief.dev/schemas/vbrief-core-0.6.schema.json";
+/** Canonical prefix for schema-conformant v0.8 reference `type` values. */
+export declare const XBRIEF_REFERENCE_PREFIX: "x-xbrief/";
+/** JSON Schema `$id` for the v0.6 core document (legacy npm artifact). */
+export declare const LEGACY_VBRIEF_CORE_SCHEMA_ID: "https://vbrief.dev/schemas/vbrief-core-0.6.schema.json";
+/** JSON Schema `$id` for the v0.8 core document (published npm artifact). */
+export declare const VBRIEF_CORE_SCHEMA_ID: "https://xbrief.dev/schemas/xbrief-core-0.8.schema.json";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -1,15 +1,23 @@
-/** Canonical vBRIEF schema version exported for downstream contract imports. */
-export const VBRIEF_VERSION = "0.6";
+/** Canonical xBRIEF schema version exported for downstream contract imports. */
+export const VBRIEF_VERSION = "0.8";
+/** Legacy v0.6 envelope version still accepted by the validator (additive back-compat). */
+export const LEGACY_VBRIEF_VERSION = "0.6";
+/** All `*BRIEFInfo.version` values the engine accepts at validation time. */
+export const ACCEPTED_VBRIEF_VERSIONS = [LEGACY_VBRIEF_VERSION, VBRIEF_VERSION];
 /** npm package identity constant (stable across releases). */
 export const TYPES_PACKAGE = "@deftai/directive-types";
 /**
- * vBRIEF#12 extension namespace — keys matching this pattern round-trip preserve-verbatim.
- * Namespaced form: `x-<namespace>/<rest>` (e.g. `x-directive/trace`, `x-vbrief/context`).
+ * xBRIEF#12 extension namespace — keys matching this pattern round-trip preserve-verbatim.
+ * Namespaced form: `x-<namespace>/<rest>` (e.g. `x-directive/trace`, `x-xbrief/context`).
  * @see https://github.com/deftai/vBRIEF/issues/12
  */
 export const EXTENSION_KEY_PATTERN = /^x-[a-z0-9-]+\//;
-/** Prefix for schema-conformant vBRIEF reference `type` values. */
+/** Legacy prefix for schema-conformant v0.6 reference `type` values (still accepted). */
 export const VBRIEF_REFERENCE_PREFIX = "x-vbrief/";
-/** JSON Schema `$id` for the v0.6 core document (published npm artifact). */
-export const VBRIEF_CORE_SCHEMA_ID = "https://vbrief.dev/schemas/vbrief-core-0.6.schema.json";
+/** Canonical prefix for schema-conformant v0.8 reference `type` values. */
+export const XBRIEF_REFERENCE_PREFIX = "x-xbrief/";
+/** JSON Schema `$id` for the v0.6 core document (legacy npm artifact). */
+export const LEGACY_VBRIEF_CORE_SCHEMA_ID = "https://vbrief.dev/schemas/vbrief-core-0.6.schema.json";
+/** JSON Schema `$id` for the v0.8 core document (published npm artifact). */
+export const VBRIEF_CORE_SCHEMA_ID = "https://xbrief.dev/schemas/xbrief-core-0.8.schema.json";
 //# sourceMappingURL=constants.js.map

package/dist/index.d.ts

@@ -1,18 +1,16 @@
-/**
- * `@deftai/directive-types` — canonical vBRIEF/policy contract for downstream consumers (#1799).
- *
- * Supported public API: this package and its published JSON Schema subpaths.
- * Behavior access remains via the `deft` / `directive` CLI — not `@deftai/directive-core`.
- */
-export { EXTENSION_KEY_PATTERN, TYPES_PACKAGE, VBRIEF_CORE_SCHEMA_ID, VBRIEF_REFERENCE_PREFIX, VBRIEF_VERSION, type VBriefVersion, } from "./constants.js";
+export { ACCEPTED_VBRIEF_VERSIONS, EXTENSION_KEY_PATTERN, LEGACY_VBRIEF_CORE_SCHEMA_ID, LEGACY_VBRIEF_VERSION, TYPES_PACKAGE, VBRIEF_CORE_SCHEMA_ID, VBRIEF_REFERENCE_PREFIX, VBRIEF_VERSION, type VBriefVersion, XBRIEF_REFERENCE_PREFIX, } from "./constants.js";
 export type { EngineInfo, Plan, PlanArchitecture, PlanItem, VBriefDocument, VBriefInfo, } from "./document.js";
 export { collectExtensionProperties, type ExtensionKey, isExtensionKey, } from "./extension.js";
 export { GATE_EXIT_CONFIG_ERROR, GATE_EXIT_OK, GATE_EXIT_VIOLATION, type GateExitCode, type GateResult, } from "./gate.js";
 export { type PlanPolicy, type ProjectionProviderExpectation, type ProjectionProviderPolicy, REGISTERED_POLICY_FIELD_NAMES, type TriageScopeRule, } from "./policy.js";
-export { isVBriefReferenceType, KNOWN_REFERENCE_TYPES, type KnownReferenceType, type TrustLevel, type VBriefReference, } from "./reference.js";
+export { isVBriefReferenceType, KNOWN_REFERENCE_TYPES, type KnownReferenceType, referenceTypeMatches, type TrustLevel, type VBriefReference, } from "./reference.js";
 export { FOLDER_ALLOWED_STATUSES, type Status, VALID_STATUSES, } from "./status.js";
 /** Relative path to the published v0.6 core JSON Schema inside the npm package. */
 export declare const PUBLISHED_VBRIEF_CORE_SCHEMA_PATH: "schemas/vbrief-core-0.6.schema.json";
+/** Relative path to the published v0.8 core JSON Schema inside the npm package. */
+export declare const PUBLISHED_XBRIEF_CORE_SCHEMA_PATH: "schemas/xbrief-core-0.8.schema.json";
 /** npm subpath export for the v0.6 core JSON Schema artifact. */
 export declare const VBRIEF_CORE_SCHEMA_EXPORT: "./schemas/vbrief-core-0.6.schema.json";
+/** npm subpath export for the v0.8 core JSON Schema artifact. */
+export declare const XBRIEF_CORE_SCHEMA_EXPORT: "./schemas/xbrief-core-0.8.schema.json";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,17 +1,15 @@
-/**
- * `@deftai/directive-types` — canonical vBRIEF/policy contract for downstream consumers (#1799).
- *
- * Supported public API: this package and its published JSON Schema subpaths.
- * Behavior access remains via the `deft` / `directive` CLI — not `@deftai/directive-core`.
- */
-export { EXTENSION_KEY_PATTERN, TYPES_PACKAGE, VBRIEF_CORE_SCHEMA_ID, VBRIEF_REFERENCE_PREFIX, VBRIEF_VERSION, } from "./constants.js";
+export { ACCEPTED_VBRIEF_VERSIONS, EXTENSION_KEY_PATTERN, LEGACY_VBRIEF_CORE_SCHEMA_ID, LEGACY_VBRIEF_VERSION, TYPES_PACKAGE, VBRIEF_CORE_SCHEMA_ID, VBRIEF_REFERENCE_PREFIX, VBRIEF_VERSION, XBRIEF_REFERENCE_PREFIX, } from "./constants.js";
 export { collectExtensionProperties, isExtensionKey, } from "./extension.js";
 export { GATE_EXIT_CONFIG_ERROR, GATE_EXIT_OK, GATE_EXIT_VIOLATION, } from "./gate.js";
 export { REGISTERED_POLICY_FIELD_NAMES, } from "./policy.js";
-export { isVBriefReferenceType, KNOWN_REFERENCE_TYPES, } from "./reference.js";
+export { isVBriefReferenceType, KNOWN_REFERENCE_TYPES, referenceTypeMatches, } from "./reference.js";
 export { FOLDER_ALLOWED_STATUSES, VALID_STATUSES, } from "./status.js";
 /** Relative path to the published v0.6 core JSON Schema inside the npm package. */
 export const PUBLISHED_VBRIEF_CORE_SCHEMA_PATH = "schemas/vbrief-core-0.6.schema.json";
+/** Relative path to the published v0.8 core JSON Schema inside the npm package. */
+export const PUBLISHED_XBRIEF_CORE_SCHEMA_PATH = "schemas/xbrief-core-0.8.schema.json";
 /** npm subpath export for the v0.6 core JSON Schema artifact. */
 export const VBRIEF_CORE_SCHEMA_EXPORT = "./schemas/vbrief-core-0.6.schema.json";
+/** npm subpath export for the v0.8 core JSON Schema artifact. */
+export const XBRIEF_CORE_SCHEMA_EXPORT = "./schemas/xbrief-core-0.8.schema.json";
 //# sourceMappingURL=index.js.map

package/dist/reference.d.ts

@@ -1,12 +1,12 @@
-import { VBRIEF_REFERENCE_PREFIX } from "./constants.js";
+import { VBRIEF_REFERENCE_PREFIX, XBRIEF_REFERENCE_PREFIX } from "./constants.js";
 /** Canonical reference types from conventions/references.md (non-exhaustive). */
-export declare const KNOWN_REFERENCE_TYPES: readonly ["x-vbrief/plan", "x-vbrief/github-issue", "x-vbrief/github-pr", "x-vbrief/jira-ticket", "x-vbrief/user-request", "x-vbrief/spec-section", "x-vbrief/context", "x-vbrief/research"];
+export declare const KNOWN_REFERENCE_TYPES: readonly ["x-vbrief/plan", "x-vbrief/github-issue", "x-vbrief/github-pr", "x-vbrief/jira-ticket", "x-vbrief/user-request", "x-vbrief/spec-section", "x-vbrief/context", "x-vbrief/research", "x-xbrief/plan", "x-xbrief/github-issue", "x-xbrief/github-pr", "x-xbrief/jira-ticket", "x-xbrief/user-request", "x-xbrief/spec-section", "x-xbrief/commit", "x-xbrief/context", "x-xbrief/external", "x-xbrief/research", "x-xbrief/adr"];
 export type KnownReferenceType = (typeof KNOWN_REFERENCE_TYPES)[number];
 export type TrustLevel = "internal" | "external";
-/** Schema-conformant vBRIEF reference (`VBriefReference` in vbrief-core.schema.json). */
+/** Schema-conformant vBRIEF/xBRIEF reference (`VBriefReference` in core schema). */
 export interface VBriefReference {
     readonly uri: string;
-    readonly type: `${typeof VBRIEF_REFERENCE_PREFIX}${string}` | KnownReferenceType;
+    readonly type: `${typeof VBRIEF_REFERENCE_PREFIX}${string}` | `${typeof XBRIEF_REFERENCE_PREFIX}${string}` | KnownReferenceType;
     readonly title?: string;
     readonly description?: string;
     readonly tags?: readonly string[];
@@ -14,6 +14,13 @@ export interface VBriefReference {
     readonly TrustLevel?: TrustLevel;
     readonly [key: `x-${string}`]: unknown;
 }
-/** Return true when `type` is a schema-conformant `x-vbrief/*` reference type. */
+/** Return true when `type` is a schema-conformant `x-vbrief/*` or `x-xbrief/*` reference type. */
 export declare function isVBriefReferenceType(type: string): boolean;
+/**
+ * Return true when `value` matches either the legacy `x-vbrief/<bareType>` or
+ * the canonical `x-xbrief/<bareType>` form.  Use this for all reader/matcher
+ * comparisons so that both namespaces are accepted during the transition
+ * period while `x-vbrief/` remains read-accepted for consumer back-compat.
+ */
+export declare function referenceTypeMatches(value: string, bareType: string): boolean;
 //# sourceMappingURL=reference.d.ts.map

package/dist/reference.js

@@ -1,4 +1,4 @@
-import { VBRIEF_REFERENCE_PREFIX } from "./constants.js";
+import { VBRIEF_REFERENCE_PREFIX, XBRIEF_REFERENCE_PREFIX } from "./constants.js";
 /** Canonical reference types from conventions/references.md (non-exhaustive). */
 export const KNOWN_REFERENCE_TYPES = [
     "x-vbrief/plan",
@@ -9,9 +9,30 @@ export const KNOWN_REFERENCE_TYPES = [
     "x-vbrief/spec-section",
     "x-vbrief/context",
     "x-vbrief/research",
+    "x-xbrief/plan",
+    "x-xbrief/github-issue",
+    "x-xbrief/github-pr",
+    "x-xbrief/jira-ticket",
+    "x-xbrief/user-request",
+    "x-xbrief/spec-section",
+    "x-xbrief/commit",
+    "x-xbrief/context",
+    "x-xbrief/external",
+    "x-xbrief/research",
+    "x-xbrief/adr",
 ];
-/** Return true when `type` is a schema-conformant `x-vbrief/*` reference type. */
+/** Return true when `type` is a schema-conformant `x-vbrief/*` or `x-xbrief/*` reference type. */
 export function isVBriefReferenceType(type) {
-    return type.startsWith(VBRIEF_REFERENCE_PREFIX);
+    return type.startsWith(VBRIEF_REFERENCE_PREFIX) || type.startsWith(XBRIEF_REFERENCE_PREFIX);
+}
+/**
+ * Return true when `value` matches either the legacy `x-vbrief/<bareType>` or
+ * the canonical `x-xbrief/<bareType>` form.  Use this for all reader/matcher
+ * comparisons so that both namespaces are accepted during the transition
+ * period while `x-vbrief/` remains read-accepted for consumer back-compat.
+ */
+export function referenceTypeMatches(value, bareType) {
+    return (value === `${VBRIEF_REFERENCE_PREFIX}${bareType}` ||
+        value === `${XBRIEF_REFERENCE_PREFIX}${bareType}`);
 }
 //# sourceMappingURL=reference.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-types",
-  "version": "0.65.0",
+  "version": "0.66.1",
   "description": "Shared TypeScript types for the Directive framework engine.",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,7 +10,8 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./schemas/vbrief-core-0.6.schema.json": "./schemas/vbrief-core-0.6.schema.json"
+    "./schemas/vbrief-core-0.6.schema.json": "./schemas/vbrief-core-0.6.schema.json",
+    "./schemas/xbrief-core-0.8.schema.json": "./schemas/xbrief-core-0.8.schema.json"
   },
   "files": [
     "dist/**/*.js",

package/schemas/xbrief-core-0.8.schema.json

@@ -0,0 +1,786 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xbrief.dev/schemas/xbrief-core-0.8.schema.json",
+  "title": "xBRIEF Core Schema v0.8",
+  "description": "JSON Schema for xBRIEF core document structure (v0.8). Adds PlanItem type (task/group/milestone/epic), summary, planRefs, extension property namespace (x-<consumer>/), Source/Confidence narrative keys, and reference type registry.",
+  "type": "object",
+  "required": [
+    "xBRIEFInfo",
+    "plan"
+  ],
+  "properties": {
+    "xBRIEFInfo": {
+      "$ref": "#/$defs/xBRIEFInfo"
+    },
+    "plan": {
+      "$ref": "#/$defs/Plan"
+    }
+  },
+  "additionalProperties": true,
+  "patternProperties": {
+    "^x-[a-z0-9-]+/": {
+      "description": "Extension property. Consumer-scoped; MUST be preserved verbatim on round-trip."
+    }
+  },
+  "not": {
+    "anyOf": [
+      {
+        "required": [
+          "todoList"
+        ]
+      },
+      {
+        "required": [
+          "playbook"
+        ]
+      }
+    ]
+  },
+  "$defs": {
+    "xBRIEFInfo": {
+      "type": "object",
+      "required": [
+        "version"
+      ],
+      "properties": {
+        "version": {
+          "type": "string",
+          "const": "0.8"
+        },
+        "author": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "metadata": {
+          "type": "object"
+        },
+        "created": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "updated": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "timezone": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true,
+      "patternProperties": {
+        "^x-[a-z0-9-]+/": {}
+      }
+    },
+    "Plan": {
+      "type": "object",
+      "required": [
+        "title",
+        "status",
+        "items"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9_-]+(\\.[a-zA-Z0-9_-]+)*$"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "$ref": "#/$defs/PlanStatus"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/PlanItem"
+          }
+        },
+        "narratives": {
+          "type": "object",
+          "properties": {
+            "Proposal": {
+              "type": "string"
+            },
+            "Overview": {
+              "type": "string"
+            },
+            "Background": {
+              "type": "string"
+            },
+            "Problem": {
+              "type": "string"
+            },
+            "Constraint": {
+              "type": "string"
+            },
+            "Hypothesis": {
+              "type": "string"
+            },
+            "Alternative": {
+              "type": "string"
+            },
+            "Risk": {
+              "type": "string"
+            },
+            "Test": {
+              "type": "string"
+            },
+            "Action": {
+              "type": "string"
+            },
+            "Observation": {
+              "type": "string"
+            },
+            "Result": {
+              "type": "string"
+            },
+            "Reflection": {
+              "type": "string"
+            },
+            "Outcome": {
+              "type": "string"
+            },
+            "Strengths": {
+              "type": "string"
+            },
+            "Weaknesses": {
+              "type": "string"
+            },
+            "Lessons": {
+              "type": "string"
+            },
+            "Source": {
+              "type": "string",
+              "description": "How a fact was established. Recommended values: verified:<method>, observed:<method>, inferred:<reason>, assumed."
+            },
+            "Confidence": {
+              "type": "string",
+              "description": "Agent certainty level. Recommended values: high, medium, low."
+            }
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Edge"
+          }
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "metadata": {
+          "type": "object"
+        },
+        "created": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "updated": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "author": {
+          "type": "string"
+        },
+        "reviewers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "uris": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/URI"
+          }
+        },
+        "references": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/VBriefReference"
+          }
+        },
+        "timezone": {
+          "type": "string"
+        },
+        "agent": {
+          "$ref": "#/$defs/Agent"
+        },
+        "lastModifiedBy": {
+          "$ref": "#/$defs/Agent"
+        },
+        "changeLog": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Change"
+          }
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "fork": {
+          "$ref": "#/$defs/Fork"
+        }
+      },
+      "additionalProperties": true,
+      "patternProperties": {
+        "^x-[a-z0-9-]+/": {}
+      }
+    },
+    "PlanItem": {
+      "type": "object",
+      "required": [
+        "title",
+        "status"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9_-]+(\\.[a-zA-Z0-9_-]+)*$"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["task", "group", "milestone", "epic"],
+          "default": "task",
+          "description": "Item type. Containers (group, milestone, epic) support status rollup."
+        },
+        "summary": {
+          "type": "string",
+          "description": "Single-sentence shorthand description. Equivalent to narrative.Overview when narrative is absent."
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "$ref": "#/$defs/PlanItemStatus"
+        },
+        "narrative": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "subItems": {
+          "type": "array",
+          "description": "Deprecated legacy alias for items; retained for compatibility.",
+          "items": {
+            "$ref": "#/$defs/PlanItem"
+          }
+        },
+        "planRef": {
+          "type": "string",
+          "pattern": "^(#[a-zA-Z0-9_.-]+|file://.*|https://.*)$"
+        },
+        "planRefs": {
+          "type": "array",
+          "description": "Array of plan reference URIs for container items aggregating multiple external xBRIEFs.",
+          "items": {
+            "type": "string",
+            "pattern": "^(#[a-zA-Z0-9_.-]+|file://.*|https://.*)$"
+          }
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "metadata": {
+          "type": "object"
+        },
+        "created": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "updated": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "completed": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "priority": {
+          "enum": [
+            "low",
+            "medium",
+            "high",
+            "critical"
+          ]
+        },
+        "dueDate": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "startDate": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "endDate": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "percentComplete": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "participants": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Participant"
+          }
+        },
+        "location": {
+          "$ref": "#/$defs/Location"
+        },
+        "uris": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/URI"
+          }
+        },
+        "recurrence": {
+          "$ref": "#/$defs/RecurrenceRule"
+        },
+        "reminders": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Reminder"
+          }
+        },
+        "classification": {
+          "enum": [
+            "public",
+            "private",
+            "confidential"
+          ]
+        },
+        "relatedComments": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "timezone": {
+          "type": "string"
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "lastModifiedBy": {
+          "$ref": "#/$defs/Agent"
+        },
+        "lockedBy": {
+          "$ref": "#/$defs/Lock"
+        },
+        "items": {
+          "type": "array",
+          "description": "Preferred v0.6 nested PlanItem field.",
+          "items": {
+            "$ref": "#/$defs/PlanItem"
+          }
+        }
+      },
+      "additionalProperties": true,
+      "patternProperties": {
+        "^x-[a-z0-9-]+/": {}
+      }
+    },
+    "PlanStatus": {
+      "enum": [
+        "draft",
+        "proposed",
+        "approved",
+        "pending",
+        "running",
+        "completed",
+        "blocked",
+        "failed",
+        "cancelled"
+      ],
+      "description": "Status values valid at plan level. 'auto' is excluded — it is only valid on container PlanItems with children."
+    },
+    "PlanItemStatus": {
+      "enum": [
+        "draft",
+        "proposed",
+        "approved",
+        "pending",
+        "running",
+        "completed",
+        "blocked",
+        "failed",
+        "cancelled",
+        "auto"
+      ],
+      "description": "Status values valid on PlanItems. 'auto' rolls up from children and is valid only on container items (group/milestone/epic) with children."
+    },
+    "Edge": {
+      "type": "object",
+      "required": [
+        "from",
+        "to",
+        "type"
+      ],
+      "properties": {
+        "from": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9_-]+(\\.[a-zA-Z0-9_-]+)*$"
+        },
+        "to": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9_-]+(\\.[a-zA-Z0-9_-]+)*$"
+        },
+        "type": {
+          "type": "string",
+          "description": "Core types: blocks, informs, invalidates, suggests. Custom types allowed."
+        }
+      },
+      "additionalProperties": true
+    },
+    "Participant": {
+      "type": "object",
+      "required": [
+        "id",
+        "role"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "role": {
+          "enum": [
+            "owner",
+            "assignee",
+            "reviewer",
+            "observer",
+            "contributor"
+          ]
+        },
+        "status": {
+          "enum": [
+            "accepted",
+            "declined",
+            "tentative",
+            "needsAction"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "URI": {
+      "type": "object",
+      "required": [
+        "uri"
+      ],
+      "properties": {
+        "uri": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "VBriefReference": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/URI"
+        },
+        {
+          "type": "object",
+          "required": [
+            "uri",
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "type": "string",
+              "pattern": "^x-[a-zA-Z0-9_-]+/",
+              "description": "A xBRIEF reference type. Canonical types: x-xbrief/plan, x-xbrief/github-issue, x-xbrief/github-pr, x-xbrief/commit, x-xbrief/external, x-xbrief/research, x-xbrief/adr. Custom consumer types SHOULD use x-<consumer>/ namespace (e.g. x-myapp/ticket)."
+            }
+          }
+        }
+      ]
+    },
+    "Location": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "address": {
+          "type": "string"
+        },
+        "geo": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "items": {
+            "type": "number"
+          }
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "RecurrenceRule": {
+      "type": "object",
+      "required": [
+        "frequency"
+      ],
+      "properties": {
+        "frequency": {
+          "enum": [
+            "daily",
+            "weekly",
+            "monthly",
+            "yearly"
+          ]
+        },
+        "interval": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "until": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "count": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "byDay": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "MO",
+              "TU",
+              "WE",
+              "TH",
+              "FR",
+              "SA",
+              "SU"
+            ]
+          }
+        },
+        "byMonth": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 12
+          }
+        },
+        "byMonthDay": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 31
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "Reminder": {
+      "type": "object",
+      "required": [
+        "trigger",
+        "action"
+      ],
+      "properties": {
+        "trigger": {
+          "type": "string"
+        },
+        "action": {
+          "enum": [
+            "display",
+            "email",
+            "webhook",
+            "audio"
+          ]
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "Agent": {
+      "type": "object",
+      "required": [
+        "id",
+        "type"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "human",
+            "aiAgent",
+            "system"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "model": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "Change": {
+      "type": "object",
+      "required": [
+        "sequence",
+        "timestamp",
+        "agent",
+        "operation"
+      ],
+      "properties": {
+        "sequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "timestamp": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "agent": {
+          "$ref": "#/$defs/Agent"
+        },
+        "operation": {
+          "enum": [
+            "create",
+            "update",
+            "delete",
+            "fork",
+            "merge"
+          ]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "oldValue": {},
+        "newValue": {},
+        "description": {
+          "type": "string"
+        },
+        "snapshotUri": {
+          "type": "string"
+        },
+        "relatedChanges": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "Fork": {
+      "type": "object",
+      "required": [
+        "parentUid",
+        "parentSequence",
+        "forkedAt"
+      ],
+      "properties": {
+        "parentUid": {
+          "type": "string"
+        },
+        "parentSequence": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "forkedAt": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "forkReason": {
+          "type": "string"
+        },
+        "mergeStatus": {
+          "enum": [
+            "unmerged",
+            "mergePending",
+            "merged",
+            "conflict"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "Lock": {
+      "type": "object",
+      "required": [
+        "agent",
+        "acquiredAt",
+        "type"
+      ],
+      "properties": {
+        "agent": {
+          "$ref": "#/$defs/Agent"
+        },
+        "acquiredAt": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "expiresAt": {
+          "$ref": "#/$defs/dateTime"
+        },
+        "type": {
+          "enum": [
+            "soft",
+            "hard"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "dateTime": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "(Z|[+-]\\d{2}:\\d{2})$"
+    }
+  }
+}