@xemahq/dsl 0.1.1

package/schema/action.schema.json

@@ -0,0 +1,181 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xema.dev/schemas/workflow/v1alpha1/Action.json",
+  "title": "Xema Action Manifest",
+  "description": "Declarative manifest for a single action version. Manifests live in plugins/software-dev/workflow-config/actions/ and are seeded into the workflow-engine action registry.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "additionalProperties": false,
+  "properties": {
+    "apiVersion": { "type": "string", "const": "xema.dev/workflow/v1alpha1" },
+    "kind": { "type": "string", "const": "Action" },
+    "metadata": { "$ref": "#/$defs/Metadata" },
+    "spec": { "$ref": "#/$defs/Spec" }
+  },
+  "$defs": {
+    "Metadata": {
+      "type": "object",
+      "required": ["id", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*/[a-z][a-z0-9-]{0,62}$",
+          "description": "Canonical action id as `<namespace>/<actionId>`, e.g. `xema/agent` or `software-dev/scm-checkout`."
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$"
+        },
+        "title": { "type": "string", "maxLength": 120 },
+        "description": { "type": "string", "maxLength": 4000 }
+      }
+    },
+    "Spec": {
+      "type": "object",
+      "required": ["executionKind", "taskQueue", "inputs", "outputs", "permissions", "retryDefaults", "timeoutDefaults"],
+      "additionalProperties": false,
+      "properties": {
+        "executionKind": { "type": "string", "enum": ["activity", "child_workflow"] },
+        "taskQueue": { "type": "string", "enum": ["xema_default", "xema_agent", "xema_human"] },
+        "actionKind": {
+          "type": "string",
+          "description": "Semantic category — drives consumer presentation (FE canvas shape, badge icon). Optional; omitted manifests are treated as 'generic'. Closed list mirrors `ActionKind` in `@xemahq/workflow-contracts`.",
+          "enum": [
+            "agent",
+            "review",
+            "wait",
+            "timer",
+            "aggregate",
+            "dispatch",
+            "branch",
+            "loop",
+            "publish",
+            "notify",
+            "inquiry",
+            "fetch",
+            "transform",
+            "validate",
+            "terminate",
+            "generic"
+          ]
+        },
+        "inputs": {
+          "type": "object",
+          "description": "JSON Schema (Draft 2020-12) for the action's `with:` arguments."
+        },
+        "outputs": {
+          "type": "object",
+          "description": "JSON Schema (Draft 2020-12) for the action's emitted outputs."
+        },
+        "outputBindings": {
+          "type": "object",
+          "description": "Optional per-output deliverable-spec bindings. Keys are output names declared in `outputs`. Each entry pins the output's payload shape to a deliverable spec; the DSL compiler reads this first for typed reach-in validation, falling back to the job-level `with.deliverableSpecRef` when absent.",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "deliverableSpecRef": {
+                "type": "string",
+                "description": "Canonical `<slug>@<version>` (e.g. `metrics-snapshot@1.0.0`).",
+                "pattern": "^[a-z][a-z0-9-]*@[0-9]+\\.[0-9]+\\.[0-9]+$"
+              }
+            }
+          }
+        },
+        "permissions": {
+          "type": "object",
+          "description": "Minimum permission scope this action requires.",
+          "additionalProperties": false,
+          "properties": {
+            "repos": { "type": "string", "enum": ["none", "read", "limited", "write"] },
+            "kb": { "type": "string", "enum": ["none", "read", "limited", "write"] },
+            "backlog": { "type": "string", "enum": ["none", "read", "limited", "write"] },
+            "integrations": { "type": "string", "enum": ["none", "read", "limited", "write"] },
+            "artifacts": { "type": "string", "enum": ["none", "read", "limited", "write"] }
+          }
+        },
+        "allowedMounts": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "uniqueItems": true
+        },
+        "retryDefaults": {
+          "type": "object",
+          "required": ["maxAttempts", "initialInterval", "backoffCoefficient", "maximumInterval"],
+          "additionalProperties": false,
+          "properties": {
+            "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 20 },
+            "initialInterval": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" },
+            "backoffCoefficient": { "type": "number", "minimum": 1.0, "maximum": 10.0 },
+            "maximumInterval": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" },
+            "nonRetryableErrorTypes": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "timeoutDefaults": {
+          "type": "object",
+          "required": ["startToClose"],
+          "additionalProperties": false,
+          "properties": {
+            "startToClose": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" },
+            "heartbeat": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" }
+          }
+        },
+        "auditEventMapping": {
+          "type": "object",
+          "description": "Mapping from step lifecycle to audit-log-api event code.",
+          "additionalProperties": false,
+          "properties": {
+            "started": { "type": "string", "minLength": 1 },
+            "succeeded": { "type": "string", "minLength": 1 },
+            "failed": { "type": "string", "minLength": 1 }
+          }
+        },
+        "consumes": {
+          "type": "array",
+          "description": "Declarative contracts the action opts into. The DSL compiler reads this list to decide which validation lanes apply — e.g. the `workspace-manifest@v1` entry enables the manifest-source triplet and the frontend canvas Inspector renders the manifest picker.",
+          "items": { "$ref": "#/$defs/ActionContract" }
+        }
+      }
+    },
+    "ActionContract": {
+      "description": "Versioned consume-contract declaration. Kinds: `workspace-manifest@v1` (manifest-source triplet) and `agent-composition@v1` (`with.composition` slug@version reference).",
+      "oneOf": [
+        { "$ref": "#/$defs/WorkspaceManifestActionContract" },
+        { "$ref": "#/$defs/AgentCompositionActionContract" }
+      ]
+    },
+    "WorkspaceManifestActionContract": {
+      "type": "object",
+      "required": ["kind", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "type": "string", "const": "workspace-manifest" },
+        "version": { "type": "string", "const": "v1" },
+        "surfaces": {
+          "type": "array",
+          "description": "Restricts the surfaces the action can be invoked on. Must intersect the manifest's `metadata.surfaceCompat`.",
+          "items": { "type": "string", "enum": ["workflow", "agent-session"] },
+          "uniqueItems": true
+        },
+        "roleHint": {
+          "type": "string",
+          "description": "Pins the manifest's `spec.agent.role` to a closed `AgentRunRole`. Compile-time fail when a workflow points the action at a manifest whose role doesn't match."
+        }
+      }
+    },
+    "AgentCompositionActionContract": {
+      "type": "object",
+      "required": ["kind", "version"],
+      "additionalProperties": false,
+      "description": "Opts the action into the `with.composition` field — a `slug@version` reference to an Agent Composition resolved at dispatch time by the runtime.",
+      "properties": {
+        "kind": { "type": "string", "const": "agent-composition" },
+        "version": { "type": "string", "const": "v1" }
+      }
+    }
+  }
+}

package/schema/reusable-workflow.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xema.dev/schemas/workflow/v1alpha1/ReusableWorkflow.json",
+  "title": "Xema Reusable Workflow",
+  "description": "A workflow invoked via `workflow_call` from another workflow. Must declare `on.workflow_call`.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "on", "jobs"],
+  "additionalProperties": false,
+  "properties": {
+    "apiVersion": { "type": "string", "const": "xema.dev/workflow/v1alpha1" },
+    "kind": { "type": "string", "const": "Workflow" },
+    "metadata": {
+      "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/Metadata"
+    },
+    "on": {
+      "type": "object",
+      "required": ["workflow_call"],
+      "additionalProperties": false,
+      "properties": {
+        "workflow_call": {
+          "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/WorkflowCallTrigger"
+        }
+      }
+    },
+    "concurrency": {
+      "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/Concurrency"
+    },
+    "defaults": {
+      "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/Defaults"
+    },
+    "permissions": {
+      "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/Permissions"
+    },
+    "vars": { "type": "object", "additionalProperties": true },
+    "jobs": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/Job"
+      },
+      "propertyNames": {
+        "$ref": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json#/$defs/JobKey"
+      }
+    }
+  }
+}

package/schema/workflow.schema.json

@@ -0,0 +1,373 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xema.dev/schemas/workflow/v1alpha1/Workflow.json",
+  "title": "Xema Workflow",
+  "description": "Authoring shape for a Xema workflow document (system or custom).",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "on", "jobs"],
+  "additionalProperties": false,
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "xema.dev/workflow/v1alpha1"
+    },
+    "kind": {
+      "type": "string",
+      "const": "Workflow"
+    },
+    "metadata": { "$ref": "#/$defs/Metadata" },
+    "on": { "$ref": "#/$defs/Triggers" },
+    "concurrency": { "$ref": "#/$defs/Concurrency" },
+    "defaults": { "$ref": "#/$defs/Defaults" },
+    "permissions": { "$ref": "#/$defs/Permissions" },
+    "vars": {
+      "type": "object",
+      "description": "Static key/value pairs bound into every job's expression context as `vars.*`.",
+      "additionalProperties": true
+    },
+    "requires": { "$ref": "#/$defs/Requires" },
+    "jobs": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "$ref": "#/$defs/Job" },
+      "propertyNames": { "$ref": "#/$defs/JobKey" }
+    },
+    "outputs": {
+      "type": "object",
+      "description": "Workflow-level named outputs. Each key references a (job, outputName) pair via fromJob/fromOutput and declares the kind of value surfaced.",
+      "additionalProperties": { "$ref": "#/$defs/WorkflowOutput" },
+      "propertyNames": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" }
+    }
+  },
+  "$defs": {
+    "Metadata": {
+      "type": "object",
+      "required": ["name", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
+        "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$" },
+        "title": { "type": "string", "maxLength": 120 },
+        "description": { "type": "string", "maxLength": 4000 },
+        "category": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
+          "uniqueItems": true
+        }
+      }
+    },
+    "JobKey": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_-]{0,62}$"
+    },
+    "Requires": {
+      "type": "object",
+      "description": "Wallet (variable + secret bundle) contracts the workflow needs at dispatch time. Resolved by the engine against project-registry-api before the run is started.",
+      "additionalProperties": false,
+      "properties": {
+        "wallets": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]{0,62}$",
+            "description": "Wallet name unique within the workflow's project/org scope."
+          }
+        },
+        "integrations": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "description": "Integration adapter kinds the workflow consumes. Biome-shipped workflows declare these so biome-host-api can cross-validate against the biome's manifest at boot.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["adapterKind", "capabilities"],
+            "properties": {
+              "adapterKind": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*$",
+                "description": "Adapter kind slug (e.g. 'scm', 'tracker', 'documentation')."
+              },
+              "capabilities": {
+                "type": "array",
+                "minItems": 1,
+                "uniqueItems": true,
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z]+(\\.[a-z][a-z0-9-]*)+$",
+                  "description": "Capability slug in <domain>.<verb-qualifier> form."
+                }
+              },
+              "optional": {
+                "type": "boolean",
+                "description": "Whether the workflow can degrade if the integration is unbound."
+              }
+            }
+          }
+        }
+      }
+    },
+    "Triggers": {
+      "type": "object",
+      "description": "At least one trigger must be declared.",
+      "minProperties": 1,
+      "additionalProperties": false,
+      "properties": {
+        "workflow_dispatch": { "$ref": "#/$defs/WorkflowDispatchTrigger" },
+        "schedule": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "items": { "$ref": "#/$defs/ScheduleTrigger" }
+        },
+        "webhook": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/WebhookTrigger" }
+        },
+        "workflow_call": { "$ref": "#/$defs/WorkflowCallTrigger" }
+      }
+    },
+    "WorkflowDispatchTrigger": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "inputs": { "$ref": "#/$defs/InputSchemaMap" }
+      }
+    },
+    "ScheduleTrigger": {
+      "type": "object",
+      "required": ["cron"],
+      "additionalProperties": false,
+      "properties": {
+        "cron": {
+          "type": "string",
+          "description": "Standard 5-field cron expression.",
+          "pattern": "^[^\\s]+\\s+[^\\s]+\\s+[^\\s]+\\s+[^\\s]+\\s+[^\\s]+$"
+        },
+        "timezone": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9+_/-]+$" },
+        "inputs": {
+          "type": "object",
+          "description": "Pre-bound inputs for every fire.",
+          "additionalProperties": true
+        }
+      }
+    },
+    "WebhookTrigger": {
+      "type": "object",
+      "required": ["event"],
+      "additionalProperties": false,
+      "properties": {
+        "event": { "type": "string", "pattern": "^[a-z][a-z0-9._]*$" },
+        "secretRef": { "type": "string", "minLength": 1 },
+        "filters": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        }
+      }
+    },
+    "WorkflowCallTrigger": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "inputs": { "$ref": "#/$defs/InputSchemaMap" },
+        "outputs": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        }
+      }
+    },
+    "InputSchemaMap": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/InputSchemaEntry" }
+    },
+    "InputSchemaEntry": {
+      "type": "object",
+      "required": ["type"],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["string", "number", "integer", "boolean", "object", "array"]
+        },
+        "required": { "type": "boolean", "default": false },
+        "default": {},
+        "description": { "type": "string", "maxLength": 1000 },
+        "enum": { "type": "array", "minItems": 1 },
+        "items": { "type": "object" }
+      }
+    },
+    "Concurrency": {
+      "type": "object",
+      "required": ["group", "mode"],
+      "additionalProperties": false,
+      "properties": {
+        "group": { "type": "string", "minLength": 1 },
+        "mode": {
+          "type": "string",
+          "enum": ["allow", "queue", "cancel_in_progress", "skip"]
+        }
+      }
+    },
+    "Defaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "retry": { "$ref": "#/$defs/RetryPolicy" },
+        "timeout": { "$ref": "#/$defs/Timeout" }
+      }
+    },
+    "Timeout": {
+      "type": "string",
+      "description": "Duration literal: <int><unit> where unit is one of s, m, h. Hours cap at 168 (1 week).",
+      "pattern": "^([1-9][0-9]*)(s|m|h)$"
+    },
+    "RetryPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 20 },
+        "initialInterval": { "$ref": "#/$defs/Timeout" },
+        "backoffCoefficient": { "type": "number", "minimum": 1.0, "maximum": 10.0 },
+        "maximumInterval": { "$ref": "#/$defs/Timeout" },
+        "nonRetryableErrorTypes": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "Permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "repos": { "$ref": "#/$defs/PermissionScope" },
+        "kb": { "$ref": "#/$defs/PermissionScope" },
+        "backlog": { "$ref": "#/$defs/PermissionScope" },
+        "integrations": { "$ref": "#/$defs/PermissionScope" },
+        "artifacts": { "$ref": "#/$defs/PermissionScope" },
+        "memory": { "$ref": "#/$defs/PermissionScope" }
+      }
+    },
+    "PermissionScope": {
+      "type": "string",
+      "enum": ["none", "read", "limited", "write"]
+    },
+    "Job": {
+      "type": "object",
+      "required": ["uses"],
+      "additionalProperties": false,
+      "properties": {
+        "title": { "type": "string", "maxLength": 120 },
+        "needs": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/JobKey" },
+          "uniqueItems": true
+        },
+        "if": { "type": "string", "minLength": 1 },
+        "strategy": { "$ref": "#/$defs/Strategy" },
+        "matrixGather": {
+          "type": "array",
+          "description": "List of upstream jobKeys whose per-entry outputs should be flattened. For each key listed here, `needs.<key>.outputs` is reshaped from `{ kind: 'matrix', outputs: [...] }` to the flat array `[...]` before the job's `with:` expressions and `if:` are evaluated. Authors use this for synthesizer / coordinator jobs that need to aggregate across a matrix. Each key must be a declared job with a matrix strategy; the compiler auto-adds every key here to `needs` so authors do not have to duplicate.",
+          "items": { "$ref": "#/$defs/JobKey" },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "uses": { "$ref": "#/$defs/UsesRef" },
+        "with": { "type": "object", "additionalProperties": true },
+        "outputs": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "retry": { "$ref": "#/$defs/RetryPolicy" },
+        "timeout": { "$ref": "#/$defs/Timeout" },
+        "permissions": { "$ref": "#/$defs/Permissions" }
+      }
+    },
+    "UsesRef": {
+      "type": "string",
+      "description": "Either <namespace>/<actionId>[@<ver>] (e.g. xema/agent@1.0.0, or xema/agent for the latest-at-compile shorthand from plan §G) or xema://workflow/<slug>[@<ver>] for reusable workflow refs. When the version is omitted, the engine pins the resolved version into the CompiledRun at compile time — replays remain deterministic.",
+      "pattern": "^([a-z][a-z0-9-]*/[a-z][a-z0-9-]*(@[0-9]+(\\.[0-9]+(\\.[0-9]+(-[A-Za-z0-9.-]+)?)?)?)?|xema://workflow/[a-z][a-z0-9-]*(@[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?)?)$"
+    },
+    "Strategy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "matrix": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 64
+          }
+        },
+        "dynamic": {
+          "type": "object",
+          "required": ["from", "as"],
+          "additionalProperties": false,
+          "properties": {
+            "from": { "type": "string", "minLength": 1 },
+            "as": { "type": "string", "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*$" },
+            "maxEntries": { "type": "integer", "minimum": 1, "maximum": 64 },
+            "keyBy": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*(\\.[a-zA-Z_][a-zA-Z0-9_]*)*$"
+            }
+          }
+        },
+        "maxParallel": { "type": "integer", "minimum": 1, "maximum": 64 }
+      },
+      "oneOf": [
+        { "required": ["matrix"] },
+        { "required": ["dynamic"] }
+      ]
+    },
+    "WorkflowOutput": {
+      "type": "object",
+      "required": ["kind", "slug", "fromJob", "fromOutput"],
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "kind": { "const": "deliverable" },
+            "slug": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
+            "fromJob": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" },
+            "fromOutput": { "type": "string", "minLength": 1 },
+            "description": { "type": "string", "maxLength": 4000 },
+            "deliverableSpecRef": { "type": "string", "minLength": 1 }
+          },
+          "required": ["kind", "slug", "fromJob", "fromOutput", "deliverableSpecRef"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "kind": { "const": "structured" },
+            "slug": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
+            "fromJob": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" },
+            "fromOutput": { "type": "string", "minLength": 1 },
+            "description": { "type": "string", "maxLength": 4000 },
+            "schemaRef": { "type": "string", "minLength": 1 }
+          },
+          "required": ["kind", "slug", "fromJob", "fromOutput"]
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "kind": { "const": "text" },
+            "slug": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,62}$" },
+            "fromJob": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,62}$" },
+            "fromOutput": { "type": "string", "minLength": 1 },
+            "description": { "type": "string", "maxLength": 4000 }
+          },
+          "required": ["kind", "slug", "fromJob", "fromOutput"]
+        }
+      ]
+    }
+  }
+}

package/src/deliverable-spec/index.ts

@@ -0,0 +1,19 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// ── @xemahq/deliverable-spec-dsl ──
+//
+// Zod schema for the `manifest.yaml` files that ship inside biome
+// `deliverable-specs/` content directories. A deliverable-spec manifest
+// declares the SHAPE of a single catalog row: kind, content body, page
+// layout, validator parameters.
+//
+// Consumers:
+//   - `biomes/workflow-runtime/api/deliverable-specs-api`: the seeder validates each manifest at
+//     boot using this schema; the schemas controller serves the JSON
+//     Schema rendition at `/schemas/deliverable-spec/v1.json` so authors
+//     can wire their YAML editor via `# yaml-language-server: $schema=…`.
+//
+// Sibling to `@xemahq/workflow-dsl` and `@xemahq/workspace-manifest-dsl`.
+// ═══════════════════════════════════════════════════════════════════════════
+
+export * from './lib/schema';
+export * from './lib/types';