events.iterate.com

Event type

events.iterate.com/workspace/created

Creates a workspace processor on this stream. The birth certificate carries the complete default configuration; explicit creation may append an initial configured patch in the same atomic batch.

Payload schema

configobject

The complete configuration the workspace is born with.

mountsRecord<string, object>optional

The mount table, keyed by absolute workspace path ('/' mounts the repo at the workspace root).

[key: string]objectoptional

One repo mount: a subtree of the workspace whose fall-through reads come from that repo's main branch and whose commits route to that repo's own commit lane.

policy"commit-to-main" | "read-only"

Governs the COMMIT door, not the overlay: the local layer is private scratch everywhere, but only commit-to-main mounts accept git.commit (the same lane as that repo's commitFiles — no branches, live on main). read-only marks reference material (e.g. a big imported repo) whose changes must not land anywhere yet.

repoPathstring

The /repos/** stream this mount reads from (main at HEAD) and commits to.

Raw JSON schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "config": {
      "type": "object",
      "properties": {
        "mounts": {
          "default": {},
          "description": "The mount table, keyed by absolute workspace path ('/' mounts the repo at the workspace root).",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "policy": {
                "type": "string",
                "enum": [
                  "commit-to-main",
                  "read-only"
                ],
                "description": "Governs the COMMIT door, not the overlay: the local layer is private scratch everywhere, but only commit-to-main mounts accept git.commit (the same lane as that repo's commitFiles — no branches, live on main). read-only marks reference material (e.g. a big imported repo) whose changes must not land anywhere yet."
              },
              "repoPath": {
                "type": "string",
                "description": "The /repos/** stream this mount reads from (main at HEAD) and commits to."
              }
            },
            "required": [
              "policy",
              "repoPath"
            ],
            "additionalProperties": false,
            "description": "One repo mount: a subtree of the workspace whose fall-through reads come from that repo's main branch and whose commits route to that repo's own commit lane."
          }
        }
      },
      "additionalProperties": false,
      "description": "The complete configuration the workspace is born with."
    }
  },
  "required": [
    "config"
  ],
  "additionalProperties": false
}