{
  "cli": {
    "cli:apply": {
      "about": "Apply configuration files (idempotent create-or-update)\n\nEach file contains a prelude (kind, path, version) separated from the config body by '---'. Creates new nodes or updates changed ones.",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Configuration files to apply",
          "id": "files",
          "long": null,
          "num_args": "1..",
          "positional": null,
          "required": true,
          "short": "f",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "apply"
    },
    "cli:backup": {
      "about": "Manage backup attachments (push-side of remote split, D5.7b)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "backup"
    },
    "cli:backup/add": {
      "about": "Attach a backup remote (push-only by default; `--bidirectional` makes it push+pull).  Backups always mirror the entire pond",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [
            "access-key"
          ],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 access key id",
          "id": "access_key_id",
          "long": "access-key-id",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Allow plain HTTP (required for local MinIO)",
          "id": "allow_http",
          "long": "allow-http",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Also pull from this remote (push + pull, i.e. mode=both)",
          "id": "bidirectional",
          "long": "bidirectional",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Custom S3 endpoint (e.g., for MinIO or R2)",
          "id": "endpoint",
          "long": "endpoint",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical name for the backup (e.g., \"origin\", \"backup-s3\")",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Replace an existing attachment of the same name",
          "id": "overwrite",
          "long": "overwrite",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "AWS region (S3 only)",
          "id": "region",
          "long": "region",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [
            "secret-key"
          ],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 secret access key",
          "id": "secret_access_key",
          "long": "secret-access-key",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Remote URL (`file:///path` or `s3://bucket/prefix`)",
          "id": "url",
          "long": null,
          "num_args": "1",
          "positional": 2,
          "required": true,
          "short": null,
          "values": []
        }
      ],
      "path": "backup/add"
    },
    "cli:backup/cleanup-uploads": {
      "about": "Delete abandoned immutable-payload upload staging objects",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical name of the backup",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "86400"
          ],
          "global": false,
          "help": "Delete staging objects at least this old",
          "id": "older_than_seconds",
          "long": "older-than-seconds",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "backup/cleanup-uploads"
    },
    "cli:backup/list": {
      "about": "List backup-mode attachments only",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "backup/list"
    },
    "cli:backup/publish-consolidated": {
      "about": "Publish verified local whole-range series packs to this backup.\n\nThis is the only operation that installs remote consolidated-pack locators. It validates the backup's pond identity and exact current `main` publication, uploads immutable physical objects, then each pack, then its locator. It never runs as part of collection or ordinary push.",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical name of a push/both backup",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "backup/publish-consolidated"
    },
    "cli:backup/remove": {
      "about": "Remove a backup attachment (alias of `pond remote remove` for symmetry; same semantics: deletes config and clears watermarks). Backups have no `mount_path`, so `--purge` is a no-op for them but accepted for symmetry",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical name of the backup to remove",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Accepted for symmetry with `pond remote remove --purge`; has no effect on backups (no mount entry to purge)",
          "id": "purge",
          "long": "purge",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "backup/remove"
    },
    "cli:capsule": {
      "about": "Install recovery recipes or verify portable recovery capsules",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule"
    },
    "cli:capsule/activate": {
      "about": "Safely enable post-commit dispatch on a completed capsule import.\n\nReads and validates every restored `/sys/remotes/*` attachment and `/system/run/*` dynamic config without executing factories. Dispatch remains suppressed if any entry is invalid or unsafe.",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/activate"
    },
    "cli:capsule/import": {
      "about": "Import a pondcapsule.4 into a brand-new pond.\n\nThe target must not already exist. A private sibling staging directory is created next to it, given a fresh pond identity, and populated in bounded, journaled transactions with post-commit factory execution and remote auto-push suppressed. Retrying the same command resumes the matching staging directory at an exact entry/leaf cursor. Only after the staged result is re-verified against the capsule's logical contract is it renamed atomically onto the target. On any failure the staging directory is left in place for inspection rather than silently removed. The promoted pond remains inert until `pond capsule activate` passes its safety preflight.",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Birthplace of the freshly minted target pond identity (see `pond init --birthplace`)",
          "id": "birthplace",
          "long": "birthplace",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Directory containing the downloaded `recovery/` tree",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/import"
    },
    "cli:capsule/inspect": {
      "about": "Verify a downloaded pondcapsule.4 without opening a pond",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Directory containing the downloaded `recovery/` tree",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/inspect"
    },
    "cli:capsule/publish": {
      "about": "Build and publish the current portable `pondcapsule.4` snapshot",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical backup name",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/publish"
    },
    "cli:capsule/recipe": {
      "about": "Publish or inspect a static native-format recovery recipe",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/recipe"
    },
    "cli:capsule/recipe/inspect": {
      "about": "Verify the watertown.commit.v1 -> pondcapsule.4 recipe",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Remote attachment name",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/recipe/inspect"
    },
    "cli:capsule/recipe/publish": {
      "about": "Install the watertown.commit.v1 -> pondcapsule.4 recipe",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Backup attachment name",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/recipe/publish"
    },
    "cli:capsule/verify": {
      "about": "Verify a pondcapsule.4 and all leaf identities",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Directory containing the downloaded `recovery/` tree",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "capsule/verify"
    },
    "cli:cat": {
      "about": "Read a file from the pond",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Show pattern resolution and schema without executing the query",
          "id": "explain",
          "long": "explain",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "auto"
          ],
          "global": false,
          "help": "Output format [default: auto] [possible values: auto, raw, table, csv] auto: table for queryable types, raw for non-queryable files",
          "id": "format",
          "long": "format",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "File path to read",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [
            "query"
          ],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "SQL query to execute on the file:series data",
          "id": "query",
          "long": "sql",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Time range end (Unix timestamp in milliseconds, optional)",
          "id": "time_end",
          "long": "time-end",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Time range start (Unix timestamp in milliseconds, optional)",
          "id": "time_start",
          "long": "time-start",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "cat"
    },
    "cli:config": {
      "about": "Show or set pond configuration",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "config"
    },
    "cli:config/set": {
      "about": "Set a configuration value",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Configuration key",
          "id": "key",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Configuration value",
          "id": "value",
          "long": null,
          "num_args": "1",
          "positional": 2,
          "required": true,
          "short": null,
          "values": []
        }
      ],
      "path": "config/set"
    },
    "cli:copy": {
      "about": "Copy files into or out of the pond\n\nCopy IN (host -> pond): pond copy host:///file.csv /dest/path Entry type is encoded in the source URL: host:///file.csv              -> raw data (default) host+table:///file.parquet    -> queryable parquet table host+series:///file.parquet   -> time-series parquet Copy OUT (pond -> host): pond copy '/pattern/**/*.series' host:///output/dir",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Destination: pond path (copy IN) or host:///path (copy OUT)",
          "id": "dest",
          "long": null,
          "num_args": "1",
          "positional": 2,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Source paths: host URLs (copy IN) or pond paths/patterns (copy OUT)",
          "id": "sources",
          "long": null,
          "num_args": "1..",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Strip a leading path prefix from pond paths when copying OUT. e.g. --strip-prefix=/hydrovu copies /hydrovu/devices/123/foo.series to <dest>/devices/123/foo.series instead of <dest>/hydrovu/devices/123/foo.series",
          "id": "strip_prefix",
          "long": "strip-prefix",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "copy"
    },
    "cli:describe": {
      "about": "Describe file schemas and types",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "**/*"
          ],
          "global": false,
          "help": "Pattern to match (supports wildcards, defaults to \"**/*\")",
          "id": "pattern",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "describe"
    },
    "cli:emergency": {
      "about": "Emergency operations (destructive, use with care)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "emergency"
    },
    "cli:emergency/erase-bucket": {
      "about": "Erase all objects in an S3 bucket. Requires --dangerous flag",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 access key",
          "id": "access_key",
          "long": "access-key",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Allow HTTP (non-TLS) connections",
          "id": "allow_http",
          "long": "allow-http",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Required safety flag to confirm destructive operation",
          "id": "dangerous",
          "long": "dangerous",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 endpoint (e.g., \"http://localhost:9000\" for MinIO)",
          "id": "endpoint",
          "long": "endpoint",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "us-east-1"
          ],
          "global": false,
          "help": "S3 region",
          "id": "region",
          "long": "region",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 secret key",
          "id": "secret_key",
          "long": "secret-key",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 bucket URL (e.g., \"s3://water-staging\")",
          "id": "url",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        }
      ],
      "path": "emergency/erase-bucket"
    },
    "cli:export": {
      "about": "Export pond data to external Parquet files with time partitioning",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Output directory for exported files",
          "id": "dir",
          "long": "dir",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Time range end (human-readable, e.g., \"2024-12-31 23:59:59\", \"2024-12-31T23:59:59Z\")",
          "id": "end_time",
          "long": "end-time",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "File patterns to export (e.g., \"/sensors/*.series\")",
          "id": "pattern",
          "long": "pattern",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "p",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Drop the temporal-reduce partial-aggregate cache before exporting, forcing a full recompute. A maintenance escape hatch: the cache is derived state, so discarding it can only cost time",
          "id": "rebuild",
          "long": "rebuild",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Time range start (human-readable, e.g., \"2024-01-01 00:00:00\", \"2024-01-01T00:00:00Z\")",
          "id": "start_time",
          "long": "start-time",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            ""
          ],
          "global": false,
          "help": "Temporal partitioning levels (comma-separated: year,month,day,hour,minute)",
          "id": "temporal",
          "long": "temporal",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "export"
    },
    "cli:freeze": {
      "about": "Manage the persistent pond-wide data-write freeze",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "freeze"
    },
    "cli:freeze/disable": {
      "about": "Re-enable data writes",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "freeze/disable"
    },
    "cli:freeze/enable": {
      "about": "Reject future data writes; fails while another writer holds the pond",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Auditable operator reason for freezing this pond",
          "id": "reason",
          "long": "reason",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        }
      ],
      "path": "freeze/enable"
    },
    "cli:freeze/status": {
      "about": "Report whether writes are frozen and show the protected content tip",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "freeze/status"
    },
    "cli:fsck": {
      "about": "Filesystem-check: verify content checksums and Merkle trees, and print a single root checksum that exhaustively fingerprints every row in the pond (across all pond_ids).  Two replicas are identical iff their root checksums match",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Skip the content-rehash pass; compute only the structural root checksum (fast)",
          "id": "quick",
          "long": "quick",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Print a per-partition breakdown and content statistics in addition to the root checksum",
          "id": "verbose",
          "long": "verbose",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "fsck"
    },
    "cli:global-options": {
      "about": "Watertown - A very small data lake",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Version",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print version",
          "id": "version",
          "long": "version",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "V",
          "values": []
        }
      ],
      "path": ""
    },
    "cli:init": {
      "about": "Initialize a new pond",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Birthplace of the pond: an immutable label for where this pond is created (for example a hostname, site, or deployment name). Recorded permanently in the pond's identity metadata",
          "id": "birthplace",
          "long": "birthplace",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "init"
    },
    "cli:limits": {
      "about": "Show bounded per-limiter state without scanning usage history",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "table"
          ],
          "global": false,
          "help": "Output format for operators or collectors",
          "id": "format",
          "long": "format",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": [
            "table",
            "json",
            "jsonl"
          ]
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "limits"
    },
    "cli:list": {
      "about": "List files and directories (ls -l style)",
      "aliases": [],
      "arguments": [
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Show all files including hidden ones",
          "id": "all",
          "long": "all",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "a",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Show full entry type names (e.g., table:series, table:dynamic)",
          "id": "long",
          "long": "long",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "l",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "**/*"
          ],
          "global": false,
          "help": "Pattern to match (supports wildcards, defaults to \"**/*\")",
          "id": "pattern",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "list"
    },
    "cli:list-factories": {
      "about": "List available dynamic node factories",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "list-factories"
    },
    "cli:log": {
      "about": "View transaction history and audit trail",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [
            "txn_seq"
          ],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Show incomplete operations (for recovery)",
          "id": "incomplete",
          "long": "incomplete",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "10"
          ],
          "global": false,
          "help": "Number of recent transactions to show",
          "id": "limit",
          "long": "limit",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [
            "incomplete"
          ],
          "defaults": [],
          "global": false,
          "help": "Show detailed lifecycle for a specific transaction sequence number",
          "id": "txn_seq",
          "long": "txn-seq",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "log"
    },
    "cli:maintain": {
      "about": "Run Delta Lake maintenance (checkpoint, vacuum, optional compaction)",
      "aliases": [],
      "arguments": [
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "With --prune: permit pruning when no push-mode remote is attached (retention-only; pruned history is then unrecoverable)",
          "id": "allow_no_remote",
          "long": "allow-no-remote",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "0"
          ],
          "global": false,
          "help": "Repack native-v2 series whose live physical fanout exceeds this threshold into verified whole-range packs under local `data/_packs`. Pass 0 to disable (the default). This never rewrites or reclaims user logical-series rows; publish selected packs explicitly with `pond backup publish-consolidated NAME`",
          "id": "collapse_versions",
          "long": "collapse-versions",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Also compact small parquet files into larger ones",
          "id": "compact",
          "long": "compact",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Report which local series packs would be rebuilt, without changing anything",
          "id": "dry_run",
          "long": "dry-run",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "1000"
          ],
          "global": false,
          "help": "With --prune: number of most-recent transactions to always retain",
          "id": "keep_txns",
          "long": "keep-txns",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Also prune replicated control-table lifecycle history at or below a safe horizon, reclaimed by this same checkpoint + vacuum pass",
          "id": "prune",
          "long": "prune",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "maintain"
    },
    "cli:mkdir": {
      "about": "Create a directory in the pond",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Create parent directories as needed (like mkdir -p)",
          "id": "parents",
          "long": "parents",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "p",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Directory path to create",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "mkdir"
    },
    "cli:mknod": {
      "about": "Create node (factory objects like CSV, SQL views, etc.)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Path to configuration file for the factory",
          "id": "config_path",
          "long": "config-path",
          "num_args": "1",
          "positional": null,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Factory type to create (use 'list-factories' to see all available types)",
          "id": "factory_type",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Overwrite existing dynamic node with new configuration",
          "id": "overwrite",
          "long": "overwrite",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Path where the node will be created",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 2,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "mknod"
    },
    "cli:pull": {
      "about": "Pull new bundles from one or more remotes (D4)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Remote name.  Omit to pull every remote in `pull` or `both` mode",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Atomically replace this remote's graft partition, mount, and pin",
          "id": "rebuild_graft",
          "long": "rebuild-graft",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "pull"
    },
    "cli:push": {
      "about": "Push pending local transactions to one or more remotes (D4)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Remote name (from `pond remote add`).  Omit to push every remote in `push` or `both` mode",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "push"
    },
    "cli:rebuild-control": {
      "about": "Rebuild the control table from the data Delta table when the control table is lost or corrupt (D6).  Recovers pond identity and the transaction-log skeleton; settings/watermarks must be re-established by re-attaching remotes",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Move an existing control table aside (to control.bak.<ts>) and rebuild.  Required when a control table already exists",
          "id": "force",
          "long": "force",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "rebuild-control"
    },
    "cli:recover": {
      "about": "Recover from crash by checking and restoring transaction metadata",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "recover"
    },
    "cli:remote": {
      "about": "Manage remote attachments under `/sys/remotes/` (D4)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "remote"
    },
    "cli:remote/add": {
      "about": "Attach a pull-mode remote and mount it at PATH.\n\n`PATH = /` is a mirror restart (foreign store_id must match this pond's pond_id).  Non-root PATH is a cross-pond import (foreign store_id must differ).",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [
            "access-key"
          ],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 access key id",
          "id": "access_key_id",
          "long": "access-key-id",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Allow plain HTTP (required for local MinIO)",
          "id": "allow_http",
          "long": "allow-http",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Custom S3 endpoint (e.g., for MinIO or R2)",
          "id": "endpoint",
          "long": "endpoint",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical name for the remote (e.g., \"upstream\")",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Replace an existing attachment of the same name",
          "id": "overwrite",
          "long": "overwrite",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "In-pond mount path.  Use `/` for a mirror restart of this pond's own backup, or `/imports/<name>` for cross-pond import",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 3,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "AWS region (S3 only)",
          "id": "region",
          "long": "region",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [
            "secret-key"
          ],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 secret access key",
          "id": "secret_access_key",
          "long": "secret-access-key",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Remote URL (`file:///path` or `s3://bucket/prefix`)",
          "id": "url",
          "long": null,
          "num_args": "1",
          "positional": 2,
          "required": true,
          "short": null,
          "values": []
        }
      ],
      "path": "remote/add"
    },
    "cli:remote/list": {
      "about": "List all attached remotes (both pull and backup)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "remote/list"
    },
    "cli:remote/remove": {
      "about": "Remove a remote attachment and clear its watermarks.\n\nBy default this is a **detach**: the YAML config and watermark keys are removed but any cross-pond mount entry materialized at `mount_path` is kept (the imported data snapshot stays readable).  Pass `--purge` to also remove the mount entry itself (the foreign data becomes inaccessible by path even if it remains in the Delta log).",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical name of the remote to remove",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Also remove the mount entry at the remote's `mount_path` (cross-pond imports only).  Without this flag the imported data remains visible via the existing mount path",
          "id": "purge",
          "long": "purge",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "remote/remove"
    },
    "cli:restore": {
      "about": "Restore a whole pond from a backup published to a remote.\n\nBootstraps a FRESH replica: discovers the source pond's id from the remote, stamps a local pond carrying that id, attaches the remote as a mirror at `/`, and pulls the full content graph.  Refuses to run over an existing pond.  Use `pond pull <name>` afterward to track the upstream.",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [
            "access-key"
          ],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 access key id",
          "id": "access_key_id",
          "long": "access-key-id",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Allow plain HTTP (required for local MinIO)",
          "id": "allow_http",
          "long": "allow-http",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Custom S3 endpoint (e.g., for MinIO or R2)",
          "id": "endpoint",
          "long": "endpoint",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help (see a summary with '-h')",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Logical name to attach the restored mirror under (e.g., \"origin\")",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Replace an existing attachment of the same name",
          "id": "overwrite",
          "long": "overwrite",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "AWS region (S3 only)",
          "id": "region",
          "long": "region",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [
            "secret-key"
          ],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "S3 secret access key",
          "id": "secret_access_key",
          "long": "secret-access-key",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Remote URL (`file:///path` or `s3://bucket/prefix`) of the backup",
          "id": "url",
          "long": null,
          "num_args": "1",
          "positional": 2,
          "required": true,
          "short": null,
          "values": []
        }
      ],
      "path": "restore"
    },
    "cli:run": {
      "about": "Execute a run configuration (e.g., hydrovu collector)",
      "aliases": [],
      "arguments": [
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Additional arguments to pass to the factory (e.g., subcommands like 'replicate', 'list-bundles')",
          "id": "args",
          "long": null,
          "num_args": "0..",
          "positional": 2,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Path to the configuration file to execute",
          "id": "path",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": true,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "run"
    },
    "cli:show": {
      "about": "Show pond contents",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "brief"
          ],
          "global": false,
          "help": "Display mode: brief (summary stats), concise (1 line per tx), or detailed (full dump)",
          "id": "mode",
          "long": "mode",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "m",
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "show"
    },
    "cli:status": {
      "about": "Show an operator-facing status aggregate: identity, local commit state, recovery health, and per-remote sync watermarks (D6)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "status"
    },
    "cli:tlog": {
      "about": "Inspect and verify the pond's transparency log (D5)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "tlog"
    },
    "cli:tlog/show": {
      "about": "Show the current checkpoint, checkpoint history, and tree size",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "tlog/show"
    },
    "cli:tlog/verify": {
      "about": "Verify inclusion of every leaf, append-only consistency across every published checkpoint, and faithfulness to the control-table commit spine",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "tlog/verify"
    },
    "cli:verify": {
      "about": "Verify local data matches one or more remotes' recorded checksums (D6)",
      "aliases": [],
      "arguments": [
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Host directory root for host+ URL operations (defaults to none; when set, host+ paths are resolved relative to this directory)",
          "id": "directory",
          "long": "directory",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": "d",
          "values": []
        },
        {
          "action": "SetTrue",
          "aliases": [],
          "conflicts": [],
          "defaults": [
            "false"
          ],
          "global": false,
          "help": "Exit nonzero unless every remote tip exactly equals the local tip",
          "id": "exact",
          "long": "exact",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Help",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Print help",
          "id": "help",
          "long": "help",
          "num_args": "0",
          "positional": null,
          "required": false,
          "short": "h",
          "values": []
        },
        {
          "action": "Append",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Mount factory definitions onto host filesystem paths. Format: <mount_path>=host+<factory>:///<config_path> Example: --hostmount /reduced=host+dyndir:///reduce.yaml",
          "id": "hostmount",
          "long": "hostmount",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": false,
          "help": "Remote or backup name.  Omit to verify against every attachment",
          "id": "name",
          "long": null,
          "num_args": "1",
          "positional": 1,
          "required": false,
          "short": null,
          "values": []
        },
        {
          "action": "Set",
          "aliases": [],
          "conflicts": [],
          "defaults": [],
          "global": true,
          "help": "Pond path override (defaults to POND env var)",
          "id": "pond",
          "long": "pond",
          "num_args": "1",
          "positional": null,
          "required": false,
          "short": null,
          "values": []
        }
      ],
      "path": "verify"
    }
  },
  "contract": 1,
  "factories": {
    "factory:column-rename": {
      "description": "Column rename transformation for table providers",
      "directory": false,
      "execute": false,
      "file": false,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": true
    },
    "factory:dynamic-dir": {
      "description": "Dynamic directory that creates entries from factory configurations",
      "directory": true,
      "execute": false,
      "file": false,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:email-report": {
      "description": "Render a named sitegen report and deliver it through Azure Communication Services Email",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:exec": {
      "description": "Run an external program against declared pond paths inside a sandbox, committing its declared outputs as one transaction",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:git-ingest": {
      "description": "Mount a git repository branch as a dynamic directory in the pond",
      "directory": true,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:hydrovu": {
      "description": "HydroVu data collector configuration",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:infinite-csv": {
      "description": "Generates infinite CSV stream for testing streaming readers",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:journal-ingest": {
      "description": "Collect systemd journal logs into per-unit JSON Lines files",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:logfile-ingest": {
      "description": "Ingest rotating log files from host directory with bao-tree verification",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:materialize-series": {
      "description": "Incrementally materialize a derived signal into a physical table series",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:monitor-report": {
      "description": "Evaluate committed pond measurements and publish an atomic host status report",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadOnly",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:pump-state-series": {
      "description": "Classify adaptive pumping, recovering, and static well-depth episodes",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:rate-limit": {
      "description": "Declare a consumption budget (e.g. 10 MiB/day) that governs actions in the pond",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:sitegen": {
      "description": "Static site generator -- Markdown + Maud templates powered by Maudit",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadWrite",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:sql-derived-series": {
      "description": "Create SQL-derived tables from multiple FileSeries sources",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:sql-derived-table": {
      "description": "Create SQL-derived tables from single FileTable sources",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:storage-azure": {
      "description": "Declare how to reach an Azure Blob Storage account (account + one credential shape), referenced by path from remotes",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": true,
      "table_transform": false
    },
    "factory:storage-minio": {
      "description": "Declare how to reach a MinIO deployment (endpoint + credentials), referenced by path from remotes",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": true,
      "table_transform": false
    },
    "factory:synthetic-timeseries": {
      "description": "Generate synthetic timeseries with configurable waveforms (sine, triangle, square, line)",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:temporal-reduce": {
      "description": "Create temporal downsampling views with configurable resolutions and aggregations",
      "directory": true,
      "execute": false,
      "file": false,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:temporal-reduce-series": {
      "description": "Create one directly addressable incrementally reduced time series",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:test-dir": {
      "description": "Test directory factory with required YAML config for unit testing",
      "directory": true,
      "execute": false,
      "file": false,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:test-executor": {
      "description": "Test executable factory for unit testing",
      "directory": false,
      "execute": true,
      "file": false,
      "initialize": true,
      "post_commit_access": "ReadOnly",
      "raw_validation": false,
      "table_transform": false
    },
    "factory:test-file": {
      "description": "Test file factory with required YAML config for unit testing",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:timeseries-join": {
      "description": "Create time series join files with automatic COALESCE and FULL OUTER JOIN",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    },
    "factory:timeseries-pivot": {
      "description": "Pivot a timeseries by value column",
      "directory": false,
      "execute": false,
      "file": true,
      "initialize": false,
      "post_commit_access": null,
      "raw_validation": false,
      "table_transform": false
    }
  },
  "formats": [
    "format:csv",
    "format:excelhtml",
    "format:hledger",
    "format:jsonlogs",
    "format:oteljson",
    "format:weblog",
    "format:xls"
  ],
  "schemas": {
    "factory:column-rename": {
      "$defs": {
        "RenameRule": {
          "description": "A single column rename rule",
          "oneOf": [
            {
              "additionalProperties": false,
              "description": "Direct column name mapping\n\nExample:\n```yaml\n- type: direct\n  from: \"DateTime\"\n  to: \"timestamp\"\n  cast: \"timestamp\"\n```",
              "properties": {
                "cast": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "from": {
                  "type": "string"
                },
                "to": {
                  "type": "string"
                },
                "type": {
                  "const": "direct",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "from",
                "to"
              ],
              "type": "object"
            },
            {
              "additionalProperties": false,
              "description": "Regex pattern-based renaming\n\nExample:\n```yaml\n- type: pattern\n  pattern: \"^(.+) \\\\((.+)\\\\)$\"\n  replacement: \"$1.$2\"\n```\nThis transforms \"Temperature (C)\" -> \"Temperature.C\"",
              "properties": {
                "pattern": {
                  "type": "string"
                },
                "replacement": {
                  "type": "string"
                },
                "type": {
                  "const": "pattern",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "pattern",
                "replacement"
              ],
              "type": "object"
            }
          ]
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for column rename transformation",
      "properties": {
        "rules": {
          "description": "List of rename rules applied in order",
          "items": {
            "$ref": "#/$defs/RenameRule"
          },
          "type": "array"
        }
      },
      "required": [
        "rules"
      ],
      "title": "ColumnRenameConfig",
      "type": "object"
    },
    "factory:dynamic-dir": {
      "$defs": {
        "DynamicDirEntry": {
          "additionalProperties": false,
          "description": "Configuration for a single directory entry",
          "properties": {
            "config": {
              "description": "Configuration for the specific factory (as raw Value for flexibility)"
            },
            "factory": {
              "description": "Factory type to use for creating this entry",
              "type": "string"
            },
            "name": {
              "description": "Name of the entry in the directory",
              "type": "string"
            }
          },
          "required": [
            "name",
            "factory",
            "config"
          ],
          "type": "object"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for the dynamic directory",
      "properties": {
        "entries": {
          "description": "List of directory entries to create",
          "items": {
            "$ref": "#/$defs/DynamicDirEntry"
          },
          "type": "array"
        }
      },
      "required": [
        "entries"
      ],
      "title": "DynamicDirConfig",
      "type": "object"
    },
    "factory:email-report": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "access_key_env": {
          "type": "string"
        },
        "endpoint_env": {
          "type": "string"
        },
        "recipient_env": {
          "type": "string"
        },
        "reply_to": {
          "default": null,
          "type": [
            "string",
            "null"
          ]
        },
        "report": {
          "type": "string"
        },
        "sender": {
          "type": "string"
        },
        "sitegen": {
          "type": "string"
        },
        "subject": {
          "type": "string"
        },
        "timeout": {
          "default": null,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "sitegen",
        "report",
        "endpoint_env",
        "access_key_env",
        "recipient_env",
        "sender",
        "subject"
      ],
      "title": "EmailReportConfig",
      "type": "object"
    },
    "factory:exec": {
      "$defs": {
        "HostInput": {
          "additionalProperties": false,
          "description": "A read-only path projected from the operator-selected hostmount root into\nthe external program's bubblewrap sandbox.",
          "properties": {
            "source": {
              "description": "Absolute path within the `pond -d` hostmount namespace.",
              "type": "string"
            },
            "target": {
              "description": "Absolute path at which the source is visible inside the sandbox.",
              "type": "string"
            }
          },
          "required": [
            "source",
            "target"
          ],
          "type": "object"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for one `exec` factory mount.",
      "properties": {
        "args": {
          "default": [],
          "description": "Literal argument vector passed to the program. Never shell-interpreted;\nif shell semantics are wanted, spell them out explicitly, e.g.\n`program: /bin/bash, args: [\"-c\", \"...\"]`.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "env": {
          "additionalProperties": {
            "type": "string"
          },
          "default": {},
          "description": "Explicit environment variables set inside the sandbox. Empty by\ndefault -- nothing is inherited from the `pond` process environment.",
          "type": "object"
        },
        "host_inputs": {
          "default": [],
          "description": "Read-only paths from the explicit `pond -d` hostmount root. The exec\nrun fails unless the operator supplied `-d`; pond-stored configuration\ncan never select an ambient host filesystem root by itself.",
          "items": {
            "$ref": "#/$defs/HostInput"
          },
          "type": "array"
        },
        "inputs": {
          "description": "Exact pond paths staged read-only into the sandbox before exec.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "interactive": {
          "default": false,
          "description": "Run the program without `bwrap`'s `--new-session` isolation, so a\nreal interactive program (a REPL, `hledger add`, etc.) keeps normal\nterminal job control (Ctrl-C, Ctrl-Z) instead of losing it to a\ndetached session. This trades away `--new-session`'s defense against\nthe sandboxed program injecting fake keystrokes back at the\ncontrolling terminal (`TIOCSTI`) -- acceptable only because running\na program interactively is already an explicit, attended choice by\nthe operator. See docs/exec-factory-design.md's interactive sessions\nsection.",
          "type": "boolean"
        },
        "network": {
          "default": false,
          "description": "Allow network access inside the sandbox. `false` unless a concrete\nuse case needs it; bookkeeping tools are local-file-only.",
          "type": "boolean"
        },
        "outputs": {
          "default": [],
          "description": "Pond paths (exact files) or directory prefixes (trailing `/`) that\nmay be created or modified by the program. Anything written outside\nthese paths in the staging directory is discarded, not committed.\nDeletions of a path that matched `outputs` before exec are always\ntreated as an error (see design doc, \"Deletions, failure, and commit\nsemantics\").",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "program": {
          "description": "Absolute path to the program to execute. Never searched on `$PATH`:\nthe config is pond-versioned, so the exact binary invoked should be\nan explicit, auditable value.",
          "type": "string"
        },
        "series_outputs": {
          "default": [],
          "description": "Exact pond paths (no directory prefixes) treated as **append-only**\n`tinyfs::EntryType::FilePhysicalSeries` files: the program sees the\npath's full prior content staged read-write (series versions are\nconcatenated on read), and on clean exit only the *new* suffix bytes\n-- not the whole file -- are committed as the series' next version.\nA natural fit for append-only formats like Ledger journals. If the\nprogram leaves behind anything that isn't a byte-for-byte extension\nof what it started with (edited, truncated, or deleted), the whole\nrun is rejected and the pond is left unchanged, same as any other\noutput error.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "timeout_seconds": {
          "default": null,
          "description": "Kill the program if it hasn't exited within this many seconds.\n`None` resolves via [`ExecConfig::effective_timeout`]: 60s for\nordinary runs, no timeout at all for `interactive: true` runs.\n`Some(0)` always means \"no timeout\", for either kind of run.",
          "format": "uint64",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "program",
        "inputs"
      ],
      "title": "ExecConfig",
      "type": "object"
    },
    "factory:git-ingest": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for the git-ingest factory",
      "properties": {
        "prefix": {
          "default": null,
          "description": "Optional path prefix filter.  When set, only files under this\ndirectory in the git tree are synced, with the prefix stripped\nfrom their paths.",
          "type": [
            "string",
            "null"
          ]
        },
        "ref": {
          "description": "Git ref to track (branch name, tag, or SHA)",
          "type": "string"
        },
        "url": {
          "description": "Git remote URL (HTTPS or SSH)",
          "type": "string"
        }
      },
      "required": [
        "url",
        "ref"
      ],
      "title": "GitIngestConfig",
      "type": "object"
    },
    "factory:hydrovu": {
      "$defs": {
        "HydroVuDevice": {
          "additionalProperties": false,
          "description": "Device configuration specifying which HydroVu location to collect",
          "properties": {
            "active": {
              "default": true,
              "description": "When false, device is skipped during `collect`. Default: true.",
              "type": "boolean"
            },
            "comment": {
              "type": [
                "string",
                "null"
              ]
            },
            "id": {
              "format": "int64",
              "type": "integer"
            },
            "name": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "id"
          ],
          "type": "object"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for HydroVu OAuth credentials and device list",
      "properties": {
        "archive_path": {
          "default": null,
          "description": "Optional path within pond holding read-only seed archives (e.g.\n\"/hydrovu-archive\"), typically git-ingested `FileDynamic` Parquet\n`.series` snapshots laid out as `{archive_path}/devices/{id}/*.series`.\nConsulted by `find_youngest_timestamp` ONLY when the writeable device\ndirectory has no temporal data (a freshly reset pond), so live\ncollection resumes from the archive's youngest timestamp instead of\ncrawling from epoch.  These archives are NOT written to.",
          "type": [
            "string",
            "null"
          ]
        },
        "client_id": {
          "description": "OAuth client ID (sensitive - redacted from debug output)",
          "type": "string"
        },
        "client_secret": {
          "description": "OAuth client secret (sensitive - redacted from debug output)",
          "type": "string"
        },
        "devices": {
          "description": "Device list",
          "items": {
            "$ref": "#/$defs/HydroVuDevice"
          },
          "type": "array"
        },
        "hydrovu_path": {
          "description": "Path within pond for hydrovu data (e.g., \"/hydrovu\")",
          "type": "string"
        },
        "max_points_per_run": {
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "client_id",
        "client_secret",
        "max_points_per_run",
        "hydrovu_path",
        "devices"
      ],
      "title": "HydroVuConfig",
      "type": "object"
    },
    "factory:journal-ingest": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for the journal ingestion factory",
      "properties": {
        "collect_kernel": {
          "default": true,
          "description": "Whether to collect kernel ring buffer as a separate stream (default: true)",
          "type": "boolean"
        },
        "extra_args": {
          "default": [],
          "description": "Extra command-line arguments appended to every `journalctl`\ninvocation.  Useful for e.g. `[\"--merge\"]` to pull both the\nsystem journal and the per-user journal of the invoking user\n(which is what surfaces user-scope units like\n`pond@water-prod.service` to the ingester).  Default: empty.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "journalctl_command": {
          "default": "journalctl",
          "description": "Command to invoke journalctl (default: \"journalctl\")\nCan be customized for non-standard installs",
          "type": "string"
        },
        "pond_path": {
          "description": "Destination path within the pond (relative to pond root)\nExample: \"logs/watershop\"",
          "type": "string"
        },
        "timestamp_field": {
          "default": "__REALTIME_TIMESTAMP",
          "description": "JSON field name containing the timestamp (default: \"__REALTIME_TIMESTAMP\")\nThe value is interpreted as microseconds since Unix epoch.",
          "type": "string"
        }
      },
      "required": [
        "pond_path"
      ],
      "title": "JournalIngestConfig",
      "type": "object"
    },
    "factory:logfile-ingest": {
      "$defs": {
        "TimestampUnit": {
          "description": "Interpretation of the values found under `timestamp_field`.\n\ntlogfs records event times in microseconds, so everything is converted to\nthat. Microseconds is the default because it is what tlogfs itself uses.",
          "oneOf": [
            {
              "enum": [
                "seconds",
                "milliseconds",
                "microseconds",
                "nanoseconds"
              ],
              "type": "string"
            },
            {
              "const": "rfc3339",
              "description": "RFC3339 date-time strings, including an explicit UTC offset.",
              "type": "string"
            }
          ]
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for the logfile ingestion factory",
      "properties": {
        "active_pattern": {
          "description": "Glob pattern for the active (append-only) log file\nExample: \"/var/log/casparwater.json\"",
          "type": "string"
        },
        "archived_pattern": {
          "description": "Glob pattern for archived (immutable) log files\nExample: \"/var/log/casparwater-*.json\"",
          "type": "string"
        },
        "pond_path": {
          "description": "Destination path within the pond (relative to pond root)\nExample: \"logs/casparwater\"",
          "type": "string"
        },
        "timestamp_field": {
          "default": null,
          "description": "JSON key holding the event time of a record, looked up at any depth in\neach line. Example: \"timeUnixNano\" for OTLP metrics JSON.\nWhen configured, every parsed JSON record must contain usable values\nfor this key; missing or malformed timestamps reject the write.\n\nAbsent by default, which leaves versions without event-time bounds.\nThat is not free: `temporal-reduce` reads these bounds to decide which\ncached segments a new source version can have touched, and a version\nwithout them is taken to span all of time (`SourceRange::UNKNOWN`), so\nevery build unseals every segment and recomputes the whole history from\nsource. Setting this is what keeps an incremental build incremental.",
          "type": [
            "string",
            "null"
          ]
        },
        "timestamp_unit": {
          "$ref": "#/$defs/TimestampUnit",
          "default": "microseconds",
          "description": "Numeric unit or explicit string format for `timestamp_field`.\nOTLP's `timeUnixNano` is nanoseconds; journald uses microseconds.\nUse `rfc3339` for complete date-time strings with a UTC offset."
        }
      },
      "required": [
        "archived_pattern",
        "active_pattern",
        "pond_path"
      ],
      "title": "LogfileIngestConfig",
      "type": "object"
    },
    "factory:materialize-series": {
      "$defs": {
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for the materialize-series factory.",
      "properties": {
        "source": {
          "$ref": "#/$defs/WatertownUrl",
          "description": "URL of the signal to materialize, e.g.\n`series:///derived/p-water-prod`.  Anything the provider can turn into\na table works, so a derived node, a physical series, or a raw log read\nthrough a format scheme are all valid sources."
        },
        "target": {
          "description": "Pond path of the `TablePhysicalSeries` to append to.  Created on the\nfirst run.",
          "type": "string"
        },
        "time_column": {
          "description": "Event-time column, present in the source and used both as the\nwatermark and as the series' temporal index.",
          "type": "string"
        }
      },
      "required": [
        "source",
        "target",
        "time_column"
      ],
      "title": "MaterializeSeriesConfig",
      "type": "object"
    },
    "factory:monitor-report": {
      "$defs": {
        "Accumulation": {
          "enum": [
            "positive-deltas"
          ],
          "type": "string"
        },
        "AlarmConfig": {
          "additionalProperties": false,
          "properties": {
            "operator": {
              "$ref": "#/$defs/AlarmOperator"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value": {
              "format": "double",
              "type": "number"
            }
          },
          "required": [
            "operator",
            "value"
          ],
          "type": "object"
        },
        "AlarmOperator": {
          "enum": [
            "lt"
          ],
          "type": "string"
        },
        "AlignmentConfig": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "$ref": "#/$defs/AlignmentMethod"
            },
            "tolerance": {
              "type": "string"
            }
          },
          "required": [
            "method",
            "tolerance"
          ],
          "type": "object"
        },
        "AlignmentMethod": {
          "enum": [
            "previous"
          ],
          "type": "string"
        },
        "AnyObservedBelowCheckConfig": {
          "additionalProperties": false,
          "properties": {
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "threshold": {
              "format": "double",
              "type": "number"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/AnyObservedBelowType"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value_column": {
              "type": "string"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "source",
            "value_column",
            "threshold",
            "window"
          ],
          "type": "object"
        },
        "AnyObservedBelowType": {
          "enum": [
            "any-observed-below"
          ],
          "type": "string"
        },
        "AverageRangeCheckConfig": {
          "additionalProperties": false,
          "properties": {
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "lower_bound": {
              "format": "double",
              "type": "number"
            },
            "source": {
              "type": "string"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/AverageRangeType"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "upper_bound": {
              "format": "double",
              "type": "number"
            },
            "value_column": {
              "type": "string"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "source",
            "value_column",
            "lower_bound",
            "upper_bound",
            "window"
          ],
          "type": "object"
        },
        "AverageRangeType": {
          "enum": [
            "average-range"
          ],
          "type": "string"
        },
        "BelowCheckConfig": {
          "additionalProperties": false,
          "properties": {
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "threshold": {
              "format": "double",
              "type": "number"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value_column": {
              "type": "string"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "source",
            "value_column",
            "threshold",
            "window"
          ],
          "type": "object"
        },
        "CheckConfig": {
          "anyOf": [
            {
              "$ref": "#/$defs/RateWhileCheckConfig"
            },
            {
              "$ref": "#/$defs/AnyObservedBelowCheckConfig"
            },
            {
              "$ref": "#/$defs/AverageRangeCheckConfig"
            },
            {
              "$ref": "#/$defs/BelowCheckConfig"
            },
            {
              "$ref": "#/$defs/StaleAfterCheckConfig"
            },
            {
              "$ref": "#/$defs/GradedScoreCheckConfig"
            },
            {
              "$ref": "#/$defs/StaleOrBelowCheckConfig"
            },
            {
              "$ref": "#/$defs/StaleOrAllBelowCheckConfig"
            },
            {
              "$ref": "#/$defs/StaleOrBelowAnyColumnCheckConfig"
            }
          ]
        },
        "ConditionConfig": {
          "additionalProperties": false,
          "properties": {
            "predicate": {
              "$ref": "#/$defs/PredicateConfig"
            },
            "source": {
              "type": "string"
            },
            "timestamp": {
              "default": "timestamp",
              "type": "string"
            }
          },
          "required": [
            "source",
            "predicate"
          ],
          "type": "object"
        },
        "GradedScoreCheckConfig": {
          "additionalProperties": false,
          "description": "Classifies the latest sample of a continuous 0.0-1.0-style score into one\nof four quality bands (good/watch/concern/alarm) instead of a plain\npass/fail threshold, for signals like the leak-probability score where a\nsingle alarm/healthy split loses the gradient the operator cares about.\n`good_max < watch_max < concern_max` must hold; values above\n`concern_max`, and a missing/no-data window, both land in the worst\n(`alarm`) band -- absence of a recent score is treated as the worst case,\nnot as \"unknown\", so a quiet source can't hide a real leak behind a\ngray card.",
          "properties": {
            "concern_max": {
              "format": "double",
              "type": "number"
            },
            "description": {
              "type": "string"
            },
            "good_max": {
              "format": "double",
              "type": "number"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/GradedScoreType"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value_column": {
              "type": "string"
            },
            "watch_max": {
              "format": "double",
              "type": "number"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "source",
            "value_column",
            "good_max",
            "watch_max",
            "concern_max",
            "window"
          ],
          "type": "object"
        },
        "GradedScoreType": {
          "enum": [
            "graded-score"
          ],
          "type": "string"
        },
        "MeasurementConfig": {
          "additionalProperties": false,
          "properties": {
            "accumulation": {
              "$ref": "#/$defs/Accumulation"
            },
            "column": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "timestamp": {
              "default": "timestamp",
              "type": "string"
            }
          },
          "required": [
            "source",
            "column",
            "accumulation"
          ],
          "type": "object"
        },
        "PredicateConfig": {
          "additionalProperties": false,
          "properties": {
            "column": {
              "type": "string"
            },
            "operator": {
              "$ref": "#/$defs/PredicateOperator"
            },
            "value": {
              "type": "string"
            }
          },
          "required": [
            "column",
            "operator",
            "value"
          ],
          "type": "object"
        },
        "PredicateOperator": {
          "enum": [
            "eq"
          ],
          "type": "string"
        },
        "RateWhileCheckConfig": {
          "additionalProperties": false,
          "properties": {
            "alarm": {
              "$ref": "#/$defs/AlarmConfig"
            },
            "alignment": {
              "$ref": "#/$defs/AlignmentConfig"
            },
            "condition": {
              "$ref": "#/$defs/ConditionConfig"
            },
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "measurement": {
              "$ref": "#/$defs/MeasurementConfig"
            },
            "minimum_active_time": {
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/RateWhileType"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "measurement",
            "condition",
            "alignment",
            "window",
            "minimum_active_time",
            "alarm"
          ],
          "type": "object"
        },
        "RateWhileType": {
          "enum": [
            "rate-while"
          ],
          "type": "string"
        },
        "StaleAfterCheckConfig": {
          "additionalProperties": false,
          "description": "Alarms when a source has produced zero non-null samples within `window`.\nUnlike the other scalar checks, an empty sample set here *is* the alarm\ncondition rather than an unknown/indeterminate state: it means the data\nsource has stopped producing new data.",
          "properties": {
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/StaleAfterType"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value_column": {
              "type": "string"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "source",
            "value_column",
            "window"
          ],
          "type": "object"
        },
        "StaleAfterType": {
          "enum": [
            "stale-after"
          ],
          "type": "string"
        },
        "StaleOrAllBelowCheckConfig": {
          "additionalProperties": false,
          "description": "Alarms if the source has produced zero samples at all in the longer\n`stale_window` (ingestion has stalled), or if every sample observed\nwithin the shorter `window` is below `threshold` -- combining the\nstaleness and sustained-low-value failure modes of a single instrument\n(e.g. well depth) into one check instead of requiring two separate\ncards. Unlike `stale-or-below`, this uses \"all observed\" polarity: a\nsingle recent reading at or above `threshold` is enough to stay healthy.",
          "properties": {
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "stale_window": {
              "type": "string"
            },
            "threshold": {
              "format": "double",
              "type": "number"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/StaleOrAllBelowType"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value_column": {
              "type": "string"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "source",
            "value_column",
            "threshold",
            "window",
            "stale_window"
          ],
          "type": "object"
        },
        "StaleOrAllBelowType": {
          "enum": [
            "stale-or-all-below"
          ],
          "type": "string"
        },
        "StaleOrBelowAnyColumnCheckConfig": {
          "additionalProperties": false,
          "description": "Combines a staleness check on `value_column` (zero samples within\n`window` means the source has stopped reporting, same polarity as\n`stale-after`) with a threshold check spread across one or more\nsecondary `threshold_columns` -- alarm if ANY sample on ANY of those\ncolumns is below `threshold` within the same window -- into a single\ncheck/card. Useful when a device's primary signal and some auxiliary\nsignals (e.g. two redundant radio batteries) should be reported as one\npass/fail instead of three separate cards. Staleness on the primary\ncolumn is checked first and takes priority: if the device has stopped\nreporting at all, the secondary columns (which live on the same stalled\ndevice) aren't evaluated separately.",
          "properties": {
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "threshold": {
              "format": "double",
              "type": "number"
            },
            "threshold_columns": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/StaleOrBelowAnyColumnType"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value_column": {
              "type": "string"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "source",
            "value_column",
            "threshold_columns",
            "threshold",
            "window"
          ],
          "type": "object"
        },
        "StaleOrBelowAnyColumnType": {
          "enum": [
            "stale-or-below-any-column"
          ],
          "type": "string"
        },
        "StaleOrBelowCheckConfig": {
          "additionalProperties": false,
          "description": "Alarms if the source has produced zero samples in `window` (stale or\nmissing), or if any observed sample is below `threshold` -- combining\nthe staleness and low-value failure modes of a single instrument (e.g. a\npH probe) into one check instead of requiring two separate cards.",
          "properties": {
            "description": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "label": {
              "type": "string"
            },
            "source": {
              "type": "string"
            },
            "threshold": {
              "format": "double",
              "type": "number"
            },
            "timestamp_column": {
              "default": "timestamp",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/StaleOrBelowType"
            },
            "unit": {
              "default": "",
              "type": "string"
            },
            "value_column": {
              "type": "string"
            },
            "window": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "label",
            "description",
            "href",
            "type",
            "source",
            "value_column",
            "threshold",
            "window"
          ],
          "type": "object"
        },
        "StaleOrBelowType": {
          "enum": [
            "stale-or-below"
          ],
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "checks": {
          "items": {
            "$ref": "#/$defs/CheckConfig"
          },
          "type": "array"
        },
        "output_dir": {
          "type": "string"
        },
        "pond": {
          "type": "string"
        },
        "title": {
          "type": "string"
        }
      },
      "required": [
        "pond",
        "title",
        "output_dir",
        "checks"
      ],
      "title": "MonitorConfig",
      "type": "object"
    },
    "factory:pump-state-series": {
      "$defs": {
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for a typed adaptive pump-state series.",
      "properties": {
        "depth_column": {
          "description": "Source well-depth column.",
          "type": "string"
        },
        "disturbance_drop": {
          "description": "Minimum depth drop below the trailing ceiling that starts disturbance.",
          "format": "double",
          "type": "number"
        },
        "lookback": {
          "description": "Width of the trailing ceiling.",
          "type": "string"
        },
        "source": {
          "$ref": "#/$defs/WatertownUrl",
          "description": "Exact logical source URL."
        },
        "time_column": {
          "description": "Source event-time column.",
          "type": "string"
        },
        "valid_depth_max": {
          "description": "Inclusive valid depth ceiling.",
          "format": "double",
          "type": "number"
        },
        "valid_depth_min": {
          "description": "Inclusive valid depth floor.",
          "format": "double",
          "type": "number"
        }
      },
      "required": [
        "source",
        "time_column",
        "depth_column",
        "lookback",
        "disturbance_drop",
        "valid_depth_min",
        "valid_depth_max"
      ],
      "title": "PumpStateConfig",
      "type": "object"
    },
    "factory:rate-limit": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "On-disk config for a `rate-limit` node.\n\nThe unit is one string; the magnitudes are numbers (Decision L4a).",
      "properties": {
        "burst": {
          "description": "Optional instantaneous allowance, in the **scale** component of `unit`\nonly -- the period does not apply to a burst.  `unit: MiB/day` with\n`burst: 1` permits 1 MiB to be spent faster than the smoothed rate.\n\nDefaults to one period's worth of `limit`, i.e. a pure sliding window\nwith no extra allowance.",
          "format": "double",
          "type": [
            "number",
            "null"
          ]
        },
        "limit": {
          "description": "How many `unit`s per period are permitted.  `unit: MiB/day` with\n`limit: 10` means 10 MiB per day.",
          "format": "double",
          "type": "number"
        },
        "unit": {
          "description": "`<scale>/<period>`, e.g. `MiB/day`, `iops/second`, `B/hour`.\nCarries dimension, scale, and period together.",
          "type": "string"
        }
      },
      "required": [
        "unit",
        "limit"
      ],
      "title": "RateLimitConfig",
      "type": "object"
    },
    "factory:sitegen": {
      "$defs": {
        "AnalyticsConfig": {
          "additionalProperties": false,
          "description": "First-visible-document analytics, disabled unless explicitly enabled.",
          "properties": {
            "default_section": {
              "default": "Other / unclassified",
              "description": "Section assigned to eligible pages without a matching section prefix.",
              "type": "string"
            },
            "enabled": {
              "default": false,
              "type": "boolean"
            },
            "endpoint": {
              "default": "/_analytics/view",
              "description": "Same-origin absolute path, routed to this site's dedicated beacon log.",
              "type": "string"
            },
            "exclude": {
              "default": [],
              "description": "Exact canonical mounted paths to exclude, in addition to /analytics.\nFrontmatter analytics: false also excludes a page; hidden does not.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "sections": {
              "additionalProperties": {
                "type": "string"
              },
              "default": {},
              "description": "Site-relative path prefixes mapped to section labels; longest match wins.\nPrefixes match complete path segments, independently of the publishing mount.",
              "type": "object"
            },
            "site_id": {
              "description": "Stable publisher-owned site identity, independent of host and mount path.",
              "type": "string"
            }
          },
          "required": [
            "site_id"
          ],
          "type": "object"
        },
        "ContentStage": {
          "additionalProperties": false,
          "description": "A content stage: globs markdown data files in the pond and reads\ntheir frontmatter for metadata (title, weight, slug).\n\nContent stages are resolved before route expansion. A `content` route\nreferences a stage by name, producing one page per matched file.",
          "properties": {
            "name": {
              "description": "Name referenced by content routes (e.g., \"pages\")",
              "type": "string"
            },
            "pattern": {
              "description": "Pond glob pattern matching data files (e.g., \"/pages/*.md\")",
              "type": "string"
            }
          },
          "required": [
            "name",
            "pattern"
          ],
          "type": "object"
        },
        "DocumentationConfig": {
          "additionalProperties": false,
          "description": "Bounded documentation capabilities; paths are relative to the input root.",
          "properties": {
            "include_roots": {
              "default": [],
              "description": "Approved directories for literal source inclusions.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "source_root": {
              "description": "Markdown root used to derive nested slugs (excluding `_generated`).",
              "type": "string"
            },
            "version": {
              "description": "Required renderer contract. Unsupported revisions fail explicitly.",
              "format": "uint32",
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "version",
            "source_root"
          ],
          "type": "object"
        },
        "ExploreConfig": {
          "additionalProperties": false,
          "description": "Browser data explorer configuration.\n\nLists which export stages to surface as queryable datasets in the explorer.",
          "properties": {
            "datasets": {
              "description": "Datasets exposed in the explorer, in display order.",
              "items": {
                "$ref": "#/$defs/ExploreDataset"
              },
              "type": "array"
            },
            "url": {
              "default": null,
              "description": "URL of the explorer page, joined relative to `base_url` (e.g.\n`explore/`; a leading slash is tolerated). When set, chart pages render\nan \"Explore this data\" button that opens this page pre-loaded with the\nchart's current files and time window. Absent means no cross-link.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "datasets"
          ],
          "type": "object"
        },
        "ExploreDataset": {
          "additionalProperties": false,
          "description": "One explorer dataset: an export stage surfaced as a named DuckDB view.",
          "properties": {
            "export": {
              "description": "Name of the `exports:` stage providing this dataset's parquet files.",
              "type": "string"
            },
            "label": {
              "description": "Human-readable label shown in the dataset picker.",
              "type": "string"
            },
            "table": {
              "description": "DuckDB view/table name the explorer registers (SQL identifier).",
              "type": "string"
            }
          },
          "required": [
            "export",
            "table",
            "label"
          ],
          "type": "object"
        },
        "ExportStage": {
          "additionalProperties": false,
          "description": "An export stage: runs `pond export` internally to produce data files\nthat become template context.\n\n# Automatic Temporal Partitioning\n\nParquet files are split into Hive-style temporal partitions automatically.\nThe system discovers resolutions from the matched files (e.g., `res=1h`,\n`res=24h`) and computes the right partition level for each resolution\nso that any viewport loads at most 2 files.\n\n`target_points` controls the trade-off: higher values mean finer partitions\n(more data per file, fewer files). Default is 1500, matching a typical\nscreen width in pixels.",
          "properties": {
            "name": {
              "description": "Name referenced by routes (e.g., \"params\", \"sites\")",
              "type": "string"
            },
            "pattern": {
              "description": "Pond glob pattern or format-provider URL pattern.\n\nBare paths (e.g., `/reduced/single_param/*/*.series`) are resolved\ndirectly as queryable pond files.\n\nURL-scheme patterns (e.g., `jsonlogs:///logs/watershop/*.jsonl`)\nare resolved through the format provider registry, allowing raw\ndata files to be queried via DataFusion.",
              "type": "string"
            },
            "target_points": {
              "default": 1500,
              "description": "Target data points per screen width for partition sizing.\nTypical value: 1000-2000. Default: 1500.\nControls how parquet files are temporally partitioned per resolution.",
              "format": "uint64",
              "minimum": 0,
              "type": "integer"
            },
            "timestamp_column": {
              "default": "timestamp",
              "description": "Name of the timestamp column for temporal partitioning.\nDefault: \"timestamp\". Override for format-provider patterns where\nthe timestamp column has a different name (e.g., \"__REALTIME_TIMESTAMP\"\nfor journald logs).",
              "type": "string"
            }
          },
          "required": [
            "name",
            "pattern"
          ],
          "type": "object"
        },
        "FeedConfig": {
          "additionalProperties": false,
          "description": "RSS feed configuration (optional section in site.yaml).",
          "properties": {
            "content": {
              "default": null,
              "description": "Which content stage provides pages (default: first content stage).",
              "type": [
                "string",
                "null"
              ]
            },
            "description": {
              "default": null,
              "description": "Channel description (default: site title).",
              "type": [
                "string",
                "null"
              ]
            },
            "section": {
              "default": "Blog",
              "description": "Content section to include in the feed (default: \"Blog\").",
              "type": "string"
            }
          },
          "type": "object"
        },
        "ReportConfig": {
          "additionalProperties": false,
          "description": "A named, transport-independent report.",
          "properties": {
            "include_pond_size": {
              "default": false,
              "description": "Include the pond's allocated storage size.",
              "type": "boolean"
            },
            "message": {
              "default": null,
              "description": "Optional reminder or explanatory text below the heading.",
              "type": [
                "string",
                "null"
              ]
            },
            "sections": {
              "description": "Ordered data sections.",
              "items": {
                "$ref": "#/$defs/ReportSectionConfig"
              },
              "type": "array"
            },
            "title": {
              "description": "Heading shown in rendered report artifacts.",
              "type": "string"
            },
            "window": {
              "description": "Trailing time window, such as `7d` or `168h`.",
              "type": "string"
            }
          },
          "required": [
            "title",
            "window",
            "sections"
          ],
          "type": "object"
        },
        "ReportSectionConfig": {
          "additionalProperties": false,
          "description": "A numeric series included in a report.",
          "properties": {
            "captures": {
              "default": [],
              "description": "Exact wildcard captures selecting one file from the export pattern.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "chart": {
              "default": false,
              "description": "Render a static PNG line chart.",
              "type": "boolean"
            },
            "export": {
              "description": "Name of an entry in `exports`.",
              "type": "string"
            },
            "href": {
              "description": "Relative or absolute link to the corresponding site page.",
              "type": "string"
            },
            "summary": {
              "$ref": "#/$defs/ReportSummary",
              "default": "range",
              "description": "Summary calculation."
            },
            "title": {
              "default": null,
              "description": "Optional heading override. Defaults to the first capture's configured\nsite label, then to a title-cased capture value.",
              "type": [
                "string",
                "null"
              ]
            },
            "unit": {
              "description": "Display unit appended to numeric values.",
              "type": "string"
            },
            "value": {
              "description": "Numeric column to summarize and chart.",
              "type": "string"
            }
          },
          "required": [
            "export",
            "value",
            "unit",
            "href"
          ],
          "type": "object"
        },
        "ReportSummary": {
          "description": "Numeric aggregation shown for a report section.",
          "enum": [
            "range",
            "sum"
          ],
          "type": "string"
        },
        "RouteConfig": {
          "additionalProperties": false,
          "description": "A route in the hierarchical route tree.",
          "properties": {
            "annotations": {
              "default": null,
              "description": "Optional secondary export whose files are handed to the page as\nannotation data (e.g. leak/no-leak interval periods drawn as a shaded\nchart background). Resolved pond-wide (all files of the named export),\nso every page under the route shares the same annotations.",
              "type": [
                "string",
                "null"
              ]
            },
            "content": {
              "default": null,
              "description": "For content routes: which content stage provides pages",
              "type": [
                "string",
                "null"
              ]
            },
            "export": {
              "default": null,
              "description": "For template routes: which export stage provides data",
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "description": "Route name (for logging/debugging)",
              "type": "string"
            },
            "page": {
              "default": null,
              "description": "Path to markdown page (e.g., \"/site/index.md\")",
              "type": [
                "string",
                "null"
              ]
            },
            "routes": {
              "default": [],
              "description": "Nested child routes",
              "items": {
                "$ref": "#/$defs/RouteConfig"
              },
              "type": "array"
            },
            "slug": {
              "description": "URL slug -- may contain `$0`, `$1` for template routes",
              "type": "string"
            },
            "type": {
              "$ref": "#/$defs/RouteType",
              "description": "\"static\" or \"template\""
            }
          },
          "required": [
            "name",
            "type",
            "slug"
          ],
          "type": "object"
        },
        "RouteType": {
          "description": "Route type.",
          "enum": [
            "static",
            "template",
            "content"
          ],
          "type": "string"
        },
        "SidebarChild": {
          "additionalProperties": false,
          "description": "A child item in a sidebar entry with sub-navigation.\n\nSupports recursive nesting: a child may have its own children, enabling\narbitrary-depth sidebar trees. `href` is optional; a child without an\nhref but with children renders as a section heading that links to its\nfirst descendant leaf.",
          "properties": {
            "children": {
              "default": [],
              "description": "Nested sub-navigation items. Empty for leaf entries.",
              "items": {
                "$ref": "#/$defs/SidebarChild"
              },
              "type": "array"
            },
            "href": {
              "default": null,
              "description": "Direct URL path (e.g., \"/data/well-depth.html\").\nOptional: parent-only entries (those with children) may omit href.",
              "type": [
                "string",
                "null"
              ]
            },
            "label": {
              "description": "Display label",
              "type": "string"
            }
          },
          "required": [
            "label"
          ],
          "type": "object"
        },
        "SidebarEntry": {
          "anyOf": [
            {
              "description": "Label with nested sub-navigation items and optional parent href.",
              "properties": {
                "children": {
                  "items": {
                    "$ref": "#/$defs/SidebarChild"
                  },
                  "type": "array"
                },
                "href": {
                  "default": null,
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "label": {
                  "type": "string"
                }
              },
              "required": [
                "label",
                "children"
              ],
              "type": "object"
            },
            {
              "description": "Direct link with label and href (no children, no page matching).",
              "properties": {
                "href": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                }
              },
              "required": [
                "label",
                "href"
              ],
              "type": "object"
            },
            {
              "description": "Simple label matched by page title (exact > case-insensitive > substring).",
              "type": "string"
            }
          ],
          "description": "A sidebar entry: either a simple label or a label with sub-navigation children.\n\nSimple entries are plain strings matched by page title.\nMatch priority: exact title > case-insensitive exact > substring.\nEntries with children render a parent link plus nested sub-items\nthat expand when the parent or any child is the current page.\n\n```yaml\nsidebar:\n  - \"Political\"                    # simple\n  - label: \"Monitoring\"            # with children\n    children:\n      - label: \"Well Depth\"\n        href: \"/data/well-depth.html\"\n```"
        },
        "SiteMeta": {
          "additionalProperties": false,
          "description": "Site-wide metadata.",
          "properties": {
            "base_url": {
              "default": "/",
              "type": "string"
            },
            "default_range": {
              "default": null,
              "description": "Default time-range button selected when a chart first loads, given as\none of the chart.js duration labels such as \"1M\", \"3M\" or \"24h\". When\nabsent, chart.js falls back to its adaptive default based on the data\nspan. The value is clamped to the ranges that fit the available data.",
              "type": [
                "string",
                "null"
              ]
            },
            "github_url": {
              "default": null,
              "description": "GitHub repository URL shown as an icon in the top bar.\nIf absent, the GitHub icon is omitted.",
              "type": [
                "string",
                "null"
              ]
            },
            "home_url": {
              "default": null,
              "description": "Destination of Home navigation links; defaults to base_url.\nDoes not change page or asset paths.",
              "type": [
                "string",
                "null"
              ]
            },
            "site_url": {
              "default": null,
              "description": "Canonical site URL for RSS feed links (e.g., \"https://casparwater.org\").\nRequired for RSS feed generation; if absent, feed is skipped.",
              "type": [
                "string",
                "null"
              ]
            },
            "title": {
              "type": "string"
            }
          },
          "required": [
            "title"
          ],
          "type": "object"
        },
        "StaticAsset": {
          "additionalProperties": false,
          "description": "Static asset to copy verbatim.",
          "properties": {
            "pattern": {
              "type": "string"
            }
          },
          "required": [
            "pattern"
          ],
          "type": "object"
        },
        "StatusGridConfig": {
          "additionalProperties": false,
          "description": "Config for the per-pond systemd status card grid.\n\nSitegen lists journal `.jsonl` files matching `journal_pattern`, filters\nthe basenames against `unit_globs`, and for each surviving unit runs\ntwo SQL queries: a status query (latest event, latest \"Started\" /\nexit / \"Peak memory usage\" lines) and a tail query (most recent\n`tail_lines` MESSAGE values).  Results are rendered as static HTML\ncards by the `pond_status_grid` shortcode; refresh requires\nre-running sitegen.\n\nWhen `perf_pattern` is set, sitegen ALSO queries each unit's perf series\nwithin `hot_window` for the latest `(timer.active, last_run.seconds_ago,\ntimer.interval_s, run.wall_s)` tuple. Those values feed the per-card health\nclassification (green/yellow/red) and Timer/Period/Last-run metadata lines\nin the rendered HTML. All four values come from one latest-row provider scan\nper card.",
          "properties": {
            "hot_window": {
              "default": null,
              "description": "Optional lookback window (humantime, e.g. `\"1d\"`, `\"12h\"`) bounding how\nfar back the per-unit status/tail scan reads the append-only journal\nseries. Journal versions whose newest event predates\n`now - hot_window` are pruned before the reader materializes them, so\nper-render memory stays bounded regardless of retained history. The\nbound also applies to `perf_pattern` enrichment. All history remains on\ndisk and queryable; only this default status render is windowed. Unset\ndefaults to [`DEFAULT_STATUS_HOT_WINDOW`] (1 day).",
              "type": [
                "string",
                "null"
              ]
            },
            "journal_pattern": {
              "description": "URL pattern resolving to the journal `.jsonl` files written by\nthe `journal-ingest` factory, e.g.\n`\"jsonlogs:///logs/journal/*.jsonl\"`.",
              "type": "string"
            },
            "perf_pattern": {
              "default": null,
              "description": "Optional URL pattern (with `{pond}` placeholder) resolving to\nthe per-pond perf series produced by `measure-pond.sh` +\n`sql-derived-series`. When set, sitegen reads the latest\n`(timer.active, last_run.seconds_ago, timer.interval_s, run.wall_s)` row\nper unit within `hot_window` and uses it for health classification.\nWhen the lookup fails for an individual unit (missing series,\nunparsable data, etc.) the card stays at `Health::Unknown` rather than\nfailing the build.\n\n`{pond}` is the unit's bare pond name -- the basename with\n`user-pond@` / `user-pond-selfmon@` prefix and `.service`\nsuffix stripped.  Example value:\n`\"series:///derived/p-{pond}\"`.",
              "type": [
                "string",
                "null"
              ]
            },
            "tail_lines": {
              "default": 10,
              "description": "Number of MESSAGE lines to render in the tail block per card.",
              "format": "uint",
              "minimum": 0,
              "type": "integer"
            },
            "unit_globs": {
              "default": [],
              "description": "Shell-style globs (matched against the journal file basename\nwithout the `.jsonl` suffix) selecting which units to render.\nExamples: `[\"user-pond@*.service\",\n\"user-pond-selfmon@*.service\"]`.  Empty list disables filtering\n(every journal file becomes a card -- usually not what you want).",
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          "required": [
            "journal_pattern"
          ],
          "type": "object"
        },
        "SubsiteConfig": {
          "additionalProperties": false,
          "description": "A sub-site to generate recursively from an imported pond.\n\n```yaml\nsubsites:\n  - name: \"noyo\"\n    path: \"/sources/noyo\"\n    config: \"/system/etc/90-sitegen\"\n    base_url: \"/noyo/\"\n```",
          "properties": {
            "base_url": {
              "default": null,
              "description": "Override the sub-site's base_url for the combined site.\nIf omitted, the sub-site's own base_url is used.",
              "type": [
                "string",
                "null"
              ]
            },
            "config": {
              "description": "Path to the sitegen config within the foreign pond (absolute,\nresolved relative to the mount point via effective_root).",
              "type": "string"
            },
            "name": {
              "description": "Display name (used for logging and output directory fallback).",
              "type": "string"
            },
            "path": {
              "description": "Pond path to the import mount point (e.g., \"/sources/noyo\").",
              "type": "string"
            }
          },
          "required": [
            "name",
            "path",
            "config"
          ],
          "type": "object"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Top-level site configuration.\n\n```yaml\nsite:\n  title: \"Noyo Harbor Blue Economy\"\n  base_url: \"/\"\n\nexports:\n  - name: \"params\"\n    pattern: \"/reduced/single_param/*/*.series\"\n\nroutes:\n  - name: \"home\"\n    type: static\n    slug: \"\"\n    page: \"/site/index.md\"\n    routes: [...]\n\npartials:\n  sidebar: \"/site/sidebar.md\"\n\nstatic:\n  - pattern: \"/static/*\"\n```",
      "properties": {
        "analytics": {
          "anyOf": [
            {
              "$ref": "#/$defs/AnalyticsConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Independent, opt-in reported page views. Never inherited by subsites."
        },
        "content": {
          "default": [],
          "items": {
            "$ref": "#/$defs/ContentStage"
          },
          "type": "array"
        },
        "documentation": {
          "anyOf": [
            {
              "$ref": "#/$defs/DocumentationConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Opt in to source-relative manual paths, literal code, and lean assets."
        },
        "explore": {
          "anyOf": [
            {
              "$ref": "#/$defs/ExploreConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Browser data explorer configuration. When present, the `{{ explore }}`\nshortcode (on an `layout: explore` page) exposes the named export stages\nas queryable datasets in a Datasette-style SQL playground. Opt-in per\nsite: absent means the explorer falls back to the single export bound to\nthe page's route."
        },
        "exports": {
          "default": [],
          "items": {
            "$ref": "#/$defs/ExportStage"
          },
          "type": "array"
        },
        "feed": {
          "anyOf": [
            {
              "$ref": "#/$defs/FeedConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "RSS feed configuration. If present, an RSS feed is generated.\nRequires `site.site_url` to be set for absolute link generation."
        },
        "footer": {
          "default": null,
          "description": "Custom text shown in the page footer alongside the build identifier.\nExample: `footer: \"Made in Mendocino\"` renders as\n\"Made in Mendocino | Watertown v0.39.0\".",
          "type": [
            "string",
            "null"
          ]
        },
        "header": {
          "default": null,
          "description": "Image path for a full-width centered banner at the top of every page.\nPath is relative to `base_url` (e.g., `\"img/logo.svg\"`).\nIf absent, no banner is rendered.",
          "type": [
            "string",
            "null"
          ]
        },
        "labels": {
          "additionalProperties": {
            "type": "string"
          },
          "default": {},
          "description": "Optional display-name overrides for template-route capture values.\nKeyed by the raw capture string (the `$0`/`$1` value taken from the\nexport path, e.g. `DO`), with the friendly label as the value\n(e.g. `Dissolved Oxygen`).  Applied when a capture is rendered as a\npage title or heading via `{{ $0 }}`; URL slugs keep the raw value so\nlinks are unaffected.  Missing keys fall back to the raw capture.",
          "type": "object"
        },
        "metric_captions": {
          "additionalProperties": {
            "type": "string"
          },
          "default": {},
          "description": "Optional human-readable caption per chart, keyed by `<param>.<unit>`\n(the same key used in `metric_registry`).  When present, the\ndashboard renders the caption directly beneath the corresponding\nchart.  Missing entries render no caption.",
          "type": "object"
        },
        "metric_registry": {
          "additionalProperties": {
            "type": "string"
          },
          "default": {},
          "description": "Metric instrument-kind registry, keyed by metric name (the\n`<param>.<unit>` portion of a wide column name).  Values are\nOpenTelemetry instrument kinds: `counter`, `updowncounter`,\nor `gauge`.  Default kind is `gauge`; only non-gauge entries\nneed to appear here.\n\nchart.js reads this map and applies a per-kind transform:\n  counter         -> first-difference per scope, plot rate\n  updowncounter   -> plot value as-is (today; future: sum\n                      across scopes for spatial aggregation)\n  rate            -> plot value as-is, but with a zero-anchored,\n                      always-rendered y-axis (for flow/rate gauges\n                      such as `usage.gpm` where 0 is meaningful)\n  gauge / missing -> plot value as-is (latest/avg)\n\nThe canonical source of truth for each project should be a\nWeaver semconv registry (e.g. caspar.water's\n`config/semconv/watertown-pond.yaml`); mirror its\nnon-gauge entries here.",
          "type": "object"
        },
        "partials": {
          "additionalProperties": {
            "type": "string"
          },
          "default": {},
          "type": "object"
        },
        "reports": {
          "additionalProperties": {
            "$ref": "#/$defs/ReportConfig"
          },
          "default": {},
          "description": "Named reports rendered from the same exported datasets as the site.",
          "type": "object"
        },
        "routes": {
          "default": [],
          "items": {
            "$ref": "#/$defs/RouteConfig"
          },
          "type": "array"
        },
        "sidebar": {
          "default": [],
          "description": "Ordered list of sidebar entries.\nEach entry is either a plain string (matched by page title, preferring exact match)\nor a map with `label` and `children` for hierarchical navigation.\nWhen present, `content_nav` renders pages in this exact order.\nPages not listed are excluded from the sidebar.",
          "items": {
            "$ref": "#/$defs/SidebarEntry"
          },
          "type": "array"
        },
        "site": {
          "$ref": "#/$defs/SiteMeta"
        },
        "static": {
          "default": [],
          "items": {
            "$ref": "#/$defs/StaticAsset"
          },
          "type": "array"
        },
        "status_grid": {
          "anyOf": [
            {
              "$ref": "#/$defs/StatusGridConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional pond status grid configuration.  When present, sitegen\nruns DataFusion queries against the configured journal data at\nrender time and exposes per-unit status to the\n`{{ pond_status_grid /}}` shortcode as static HTML cards.\nSee `StatusGridConfig` for fields."
        },
        "strict": {
          "default": false,
          "description": "Reject incomplete routes, navigation, includes, and local links.",
          "type": "boolean"
        },
        "subsites": {
          "default": [],
          "description": "Sub-sites to generate recursively from imported ponds.\nEach sub-site references a sitegen config inside an imported mount\nand generates into a subdirectory of the output.",
          "items": {
            "$ref": "#/$defs/SubsiteConfig"
          },
          "type": "array"
        },
        "theme": {
          "additionalProperties": {
            "type": "string"
          },
          "default": {},
          "description": "Theme overrides for CSS custom properties.\nAny key here overrides the corresponding CSS variable in `:root`.\nExample: `accent: \"#1a365d\"` sets `--accent: #1a365d`.",
          "type": "object"
        }
      },
      "required": [
        "site"
      ],
      "title": "SiteConfig",
      "type": "object"
    },
    "factory:sql-derived-series": {
      "$defs": {
        "SqlDerivedLocality": {
          "description": "Explicit locality contract for user-authored SQL.",
          "oneOf": [
            {
              "description": "Unrestricted SQL. The query is visible as global and non-incremental.",
              "properties": {
                "type": {
                  "const": "global",
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            },
            {
              "description": "A single-source immutable projection/filter that preserves event time,\noptionally sorted without limiting rows.",
              "properties": {
                "event_time": {
                  "description": "Event-time column retained by the output.",
                  "type": "string"
                },
                "input_event_time": {
                  "description": "Source event-time column, defaulting to event_time. Only renaming,\nRFC3339 parsing, and integer-microsecond parsing preserve time.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "type": {
                  "const": "timestamp-local",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "event_time"
              ],
              "type": "object"
            },
            {
              "description": "Single-source aggregation grouped only by the exact retained event time.\nThe event-time value must be preserved; text may be parsed into a\nnanosecond timestamp. Nonlocal operators and time bucketing are rejected.",
              "properties": {
                "event_time": {
                  "description": "Event-time column retained by the output.",
                  "type": "string"
                },
                "input_event_time": {
                  "description": "Source event-time column, defaulting to event_time.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "type": {
                  "const": "timestamp-grouped",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "event_time"
              ],
              "type": "object"
            }
          ]
        },
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for SQL-derived file generation",
      "properties": {
        "locality": {
          "$ref": "#/$defs/SqlDerivedLocality",
          "default": {
            "type": "global"
          },
          "description": "Declared query locality. Defaults to conservative global execution."
        },
        "patterns": {
          "additionalProperties": {
            "$ref": "#/$defs/WatertownUrl"
          },
          "default": {},
          "description": "Named URL patterns for matching files. Each pattern name becomes a table in the SQL query.\nEach pattern can match multiple files which are automatically harmonized with UNION ALL BY NAME.\n\n**URL Format**: `scheme:///path/pattern`\n- `series:///pattern` - FileSeries (for sql-derived-series mode)\n- `table:///pattern` - FileTable (for sql-derived-table mode)\n\nExample: {\"vulink\": \"series:///data/vulink*.series\", \"at500\": \"series:///data/at500*.series\"}",
          "type": "object"
        },
        "query": {
          "description": "SQL query to execute on the source data. Defaults to \"SELECT * FROM source\" if not specified",
          "type": [
            "string",
            "null"
          ]
        },
        "transforms": {
          "description": "Optional list of table transform factory paths to apply to each pattern's TableProvider.\nTransforms are applied in order before scope prefixes and SQL execution.\nEach transform is a path like \"/transforms/column-rename\"",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "title": "SqlDerivedConfig",
      "type": "object"
    },
    "factory:sql-derived-table": {
      "$defs": {
        "SqlDerivedLocality": {
          "description": "Explicit locality contract for user-authored SQL.",
          "oneOf": [
            {
              "description": "Unrestricted SQL. The query is visible as global and non-incremental.",
              "properties": {
                "type": {
                  "const": "global",
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            },
            {
              "description": "A single-source immutable projection/filter that preserves event time,\noptionally sorted without limiting rows.",
              "properties": {
                "event_time": {
                  "description": "Event-time column retained by the output.",
                  "type": "string"
                },
                "input_event_time": {
                  "description": "Source event-time column, defaulting to event_time. Only renaming,\nRFC3339 parsing, and integer-microsecond parsing preserve time.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "type": {
                  "const": "timestamp-local",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "event_time"
              ],
              "type": "object"
            },
            {
              "description": "Single-source aggregation grouped only by the exact retained event time.\nThe event-time value must be preserved; text may be parsed into a\nnanosecond timestamp. Nonlocal operators and time bucketing are rejected.",
              "properties": {
                "event_time": {
                  "description": "Event-time column retained by the output.",
                  "type": "string"
                },
                "input_event_time": {
                  "description": "Source event-time column, defaulting to event_time.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "type": {
                  "const": "timestamp-grouped",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "event_time"
              ],
              "type": "object"
            }
          ]
        },
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for SQL-derived file generation",
      "properties": {
        "locality": {
          "$ref": "#/$defs/SqlDerivedLocality",
          "default": {
            "type": "global"
          },
          "description": "Declared query locality. Defaults to conservative global execution."
        },
        "patterns": {
          "additionalProperties": {
            "$ref": "#/$defs/WatertownUrl"
          },
          "default": {},
          "description": "Named URL patterns for matching files. Each pattern name becomes a table in the SQL query.\nEach pattern can match multiple files which are automatically harmonized with UNION ALL BY NAME.\n\n**URL Format**: `scheme:///path/pattern`\n- `series:///pattern` - FileSeries (for sql-derived-series mode)\n- `table:///pattern` - FileTable (for sql-derived-table mode)\n\nExample: {\"vulink\": \"series:///data/vulink*.series\", \"at500\": \"series:///data/at500*.series\"}",
          "type": "object"
        },
        "query": {
          "description": "SQL query to execute on the source data. Defaults to \"SELECT * FROM source\" if not specified",
          "type": [
            "string",
            "null"
          ]
        },
        "transforms": {
          "description": "Optional list of table transform factory paths to apply to each pattern's TableProvider.\nTransforms are applied in order before scope prefixes and SQL execution.\nEach transform is a path like \"/transforms/column-rename\"",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "title": "SqlDerivedConfig",
      "type": "object"
    },
    "factory:storage-azure": {
      "$defs": {
        "ServicePrincipal": {
          "additionalProperties": false,
          "description": "An Azure AD service principal: the credential shape used when a pond\nauthenticates as an application rather than with a shared secret.",
          "properties": {
            "client_id": {
              "description": "Application (client) id.  Must be an `${env:...}` reference.",
              "type": "string"
            },
            "client_secret": {
              "description": "Client secret.  Must be an `${env:...}` reference.",
              "type": "string"
            },
            "tenant_id": {
              "description": "Directory (tenant) id.  Must be an `${env:...}` reference.",
              "type": "string"
            }
          },
          "required": [
            "client_id",
            "client_secret",
            "tenant_id"
          ],
          "type": "object"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "On-disk config for a `storage-azure` node.",
      "properties": {
        "account_key": {
          "description": "Shared account key.  Must be an `${env:...}` reference (Decision A1).",
          "type": [
            "string",
            "null"
          ]
        },
        "account_name": {
          "description": "Storage account name, e.g. `casparwater`.  Required: an Azure profile\nwithout an account names nothing.  Not a credential (see module docs).",
          "type": "string"
        },
        "sas_token": {
          "description": "Shared access signature token.  Must be an `${env:...}` reference.",
          "type": [
            "string",
            "null"
          ]
        },
        "service_principal": {
          "anyOf": [
            {
              "$ref": "#/$defs/ServicePrincipal"
            },
            {
              "type": "null"
            }
          ],
          "description": "Azure AD application credentials.  Each field must be an `${env:...}`\nreference."
        },
        "timeout": {
          "description": "Per-request HTTP timeout accepted by `object_store` (for example `2m`).\nAzure multipart uploads can otherwise exceed the 30-second default on a\nconstrained uplink when several parts are in flight.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "account_name"
      ],
      "title": "StorageAzureConfig",
      "type": "object"
    },
    "factory:storage-minio": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "On-disk config for a `storage-minio` node.",
      "properties": {
        "access_key_id": {
          "description": "Access key id.  Must be an `${env:...}` reference (Decision A1).",
          "type": "string"
        },
        "endpoint": {
          "description": "MinIO endpoint URL, e.g. `http://watershop:9000`.  Required: a MinIO\nwithout an endpoint is not a MinIO.",
          "type": "string"
        },
        "region": {
          "description": "Region used for SigV4 signing.  Defaults to [`DEFAULT_REGION`], which\n[`render`] makes explicit so `pond cat` shows what is in effect.",
          "type": [
            "string",
            "null"
          ]
        },
        "secret_access_key": {
          "description": "Secret access key.  Must be an `${env:...}` reference (Decision A1).",
          "type": "string"
        }
      },
      "required": [
        "endpoint",
        "access_key_id",
        "secret_access_key"
      ],
      "title": "StorageMinioConfig",
      "type": "object"
    },
    "factory:synthetic-timeseries": {
      "$defs": {
        "PointConfig": {
          "additionalProperties": false,
          "description": "A named timeseries point -- its value at each timestamp is the sum of its components",
          "properties": {
            "components": {
              "description": "Waveform components whose values are summed",
              "items": {
                "$ref": "#/$defs/WaveformComponent"
              },
              "type": "array"
            },
            "name": {
              "description": "Column name for this point",
              "type": "string"
            }
          },
          "required": [
            "name",
            "components"
          ],
          "type": "object"
        },
        "WaveformComponent": {
          "description": "Waveform component type",
          "oneOf": [
            {
              "description": "Sine wave: offset + amplitude * sin(2pi * t / period + phase)",
              "properties": {
                "amplitude": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "offset": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "period": {
                  "description": "Period as a human-readable duration (e.g., \"24h\", \"1h30m\", \"90s\")",
                  "type": "string"
                },
                "phase": {
                  "default": 0.0,
                  "description": "Phase offset in radians",
                  "format": "double",
                  "type": "number"
                },
                "type": {
                  "const": "sine",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "period"
              ],
              "type": "object"
            },
            {
              "description": "Triangle wave: offset + amplitude * triangle(t / period + phase)",
              "properties": {
                "amplitude": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "offset": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "period": {
                  "type": "string"
                },
                "phase": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "type": {
                  "const": "triangle",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "period"
              ],
              "type": "object"
            },
            {
              "description": "Square wave: offset + amplitude * sign(sin(2pi * t / period + phase))",
              "properties": {
                "amplitude": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "offset": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "period": {
                  "type": "string"
                },
                "phase": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "type": {
                  "const": "square",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "period"
              ],
              "type": "object"
            },
            {
              "description": "Linear ramp: offset + slope * t_seconds",
              "properties": {
                "offset": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "slope": {
                  "default": 0.0,
                  "format": "double",
                  "type": "number"
                },
                "type": {
                  "const": "line",
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          ]
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Top-level configuration for the synthetic-timeseries factory",
      "properties": {
        "end": {
          "description": "End time (RFC 3339 / ISO 8601)",
          "type": "string"
        },
        "interval": {
          "description": "Sampling interval as a human-readable duration (e.g., \"15m\", \"1h\", \"30s\")",
          "type": "string"
        },
        "points": {
          "description": "Named timeseries points (each becomes a Float64 column)",
          "items": {
            "$ref": "#/$defs/PointConfig"
          },
          "type": "array"
        },
        "start": {
          "description": "Start time (RFC 3339 / ISO 8601)",
          "type": "string"
        },
        "time_column": {
          "default": "timestamp",
          "description": "Name of the timestamp column (default: \"timestamp\")",
          "type": "string"
        }
      },
      "required": [
        "start",
        "end",
        "interval",
        "points"
      ],
      "title": "SyntheticTimeseriesConfig",
      "type": "object"
    },
    "factory:temporal-reduce": {
      "$defs": {
        "AggregationConfig": {
          "additionalProperties": false,
          "description": "Configuration for a single aggregation operation",
          "properties": {
            "columns": {
              "default": null,
              "description": "Columns to apply the aggregation to\nIf not specified, applies to all numeric columns\nUse [\"*\"] for count operations",
              "items": {
                "type": "string"
              },
              "type": [
                "array",
                "null"
              ]
            },
            "type": {
              "$ref": "#/$defs/AggregationType",
              "description": "Type of aggregation (avg, min, max, count, sum)"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        },
        "AggregationType": {
          "description": "Aggregation types supported by the temporal reduce factory",
          "enum": [
            "avg",
            "min",
            "max",
            "count",
            "sum"
          ],
          "type": "string"
        },
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for the temporal-reduce factory",
      "properties": {
        "aggregations": {
          "description": "Aggregation operations to perform",
          "items": {
            "$ref": "#/$defs/AggregationConfig"
          },
          "type": "array"
        },
        "allowed_lateness": {
          "description": "Maximum allowed lateness for the segment partial-aggregate cache: how far behind\nthe newest bucket a late/backfilled sample may still land before its\noutput bucket is treated as sealed. Buckets older than\n`newest_bucket - allowed_lateness` are frozen into immutable segment files and\nnever recomputed, which bounds the rollup's working set to this window\ninstead of all history. Parsed with `humantime::parse_duration`; defaults\nto one day. Data arriving older than the sealed watermark is not an\nerror: the segments covering it are unsealed and recomputed from source.\nChanging this value invalidates the merged (segment) cache, which is\nrebuilt from the cached source versions.",
          "type": [
            "string",
            "null"
          ]
        },
        "group_by": {
          "description": "Exact source columns retained as grouping keys alongside the time bucket.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "in_pattern": {
          "$ref": "#/$defs/WatertownUrl",
          "description": "Input URL pattern to match source files (supports glob patterns)"
        },
        "max_live_segments": {
          "description": "Maximum number of segment files to leave live per resolution before\ncompaction merges them regardless of size class. Defaults to\n[`crate::partial_aggregate_cache::MAX_LIVE_SEGMENTS`]. Like `seal_target_bytes`, changing\nit invalidates nothing.",
          "format": "uint",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "out_pattern": {
          "description": "Output basename pattern using captured groups (e.g., \"$0\", \"$1\") - no URL scheme",
          "type": "string"
        },
        "output_aliases": {
          "additionalProperties": {
            "type": "string"
          },
          "description": "Optional final output aliases keyed by the default `<column>.<aggregate>` name.",
          "type": [
            "object",
            "null"
          ]
        },
        "resolutions": {
          "description": "List of temporal resolutions (e.g., \"1h\", \"6h\", \"1d\")\nParsed using humantime::parse_duration",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "seal_target_bytes": {
          "description": "Minimum accumulated size before frozen buckets are sealed into an\nimmutable segment file. Accepts a byte count; defaults to\n[`crate::partial_aggregate_cache::SEAL_TARGET_BYTES`].\n\nUnlike `allowed_lateness`, changing this does NOT invalidate the cache:\na segment already sealed is correct at any target, so the new value simply\ngoverns the next seal. Exposed mainly so the tradeoff can be measured\nagainst real data -- larger means fewer files but a heavier hot-window\nrecompute each build. The fixed sealable-backlog span backstop still\napplies when output remains below this byte target.",
          "format": "uint64",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "time_column": {
          "description": "Name of the timestamp column",
          "type": "string"
        },
        "transforms": {
          "description": "Optional list of table transform factory paths to apply to input TableProvider.\nTransforms are applied in order before SQL execution.\nEach transform is a path like \"/etc/hydro_rename\"",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "required": [
        "in_pattern",
        "out_pattern",
        "time_column",
        "resolutions",
        "aggregations"
      ],
      "title": "TemporalReduceConfig",
      "type": "object"
    },
    "factory:temporal-reduce-series": {
      "$defs": {
        "AggregationConfig": {
          "additionalProperties": false,
          "description": "Configuration for a single aggregation operation",
          "properties": {
            "columns": {
              "default": null,
              "description": "Columns to apply the aggregation to\nIf not specified, applies to all numeric columns\nUse [\"*\"] for count operations",
              "items": {
                "type": "string"
              },
              "type": [
                "array",
                "null"
              ]
            },
            "type": {
              "$ref": "#/$defs/AggregationType",
              "description": "Type of aggregation (avg, min, max, count, sum)"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        },
        "AggregationType": {
          "description": "Aggregation types supported by the temporal reduce factory",
          "enum": [
            "avg",
            "min",
            "max",
            "count",
            "sum"
          ],
          "type": "string"
        },
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for a direct single-resolution temporal-reduce series.",
      "properties": {
        "aggregations": {
          "items": {
            "$ref": "#/$defs/AggregationConfig"
          },
          "type": "array"
        },
        "allowed_lateness": {
          "type": [
            "string",
            "null"
          ]
        },
        "group_by": {
          "description": "Exact source columns retained as grouping keys alongside the time bucket.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "in_pattern": {
          "$ref": "#/$defs/WatertownUrl"
        },
        "max_live_segments": {
          "format": "uint",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "output_aliases": {
          "additionalProperties": {
            "type": "string"
          },
          "type": [
            "object",
            "null"
          ]
        },
        "resolution": {
          "type": "string"
        },
        "seal_target_bytes": {
          "format": "uint64",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "time_column": {
          "type": "string"
        },
        "transforms": {
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "required": [
        "in_pattern",
        "time_column",
        "resolution",
        "aggregations"
      ],
      "title": "TemporalReduceSeriesConfig",
      "type": "object"
    },
    "factory:timeseries-join": {
      "$defs": {
        "TimeRange": {
          "additionalProperties": false,
          "description": "Time range bounds for filtering",
          "properties": {
            "begin": {
              "description": "Optional start time (ISO 8601 format)",
              "type": [
                "string",
                "null"
              ]
            },
            "end": {
              "description": "Optional end time (ISO 8601 format)",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "type": "object"
        },
        "TimeseriesInput": {
          "additionalProperties": false,
          "description": "Input source with URL pattern and optional time range",
          "properties": {
            "pattern": {
              "$ref": "#/$defs/WatertownUrl",
              "description": "URL pattern for matching time series files\n\nSupported URL schemes:\n- `series:///pattern` - Builtin TinyFS FileSeries (Parquet)\n- `series+gzip:///pattern` - Compressed FileSeries\n- `csv:///pattern` - CSV files (requires format conversion)\n- `csv+gzip:///pattern?delimiter=;` - CSV with decompression and options\n- `excelhtml:///pattern` - HydroVu HTML exports\n\nExample: `series:///data/sensors/*.series`"
            },
            "range": {
              "anyOf": [
                {
                  "$ref": "#/$defs/TimeRange"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional time range filter for this specific input"
            },
            "scope": {
              "description": "Optional scope prefix to add to all column names (e.g.,\n\"temperature\" -> \"BDock.temperature\")",
              "type": [
                "string",
                "null"
              ]
            },
            "transforms": {
              "description": "Optional list of table transform factory paths to apply to this input's TableProvider.\nTransforms are applied in order before scope prefixes and SQL execution.\nEach transform is a path like \"/etc/hydro_rename\"",
              "items": {
                "type": "string"
              },
              "type": [
                "array",
                "null"
              ]
            }
          },
          "required": [
            "pattern"
          ],
          "type": "object"
        },
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for the timeseries-join factory",
      "properties": {
        "inputs": {
          "description": "List of input sources with patterns and optional time ranges",
          "items": {
            "$ref": "#/$defs/TimeseriesInput"
          },
          "type": "array"
        },
        "time_column": {
          "default": "timestamp",
          "description": "Name of the timestamp column (defaults to \"timestamp\")",
          "type": "string"
        }
      },
      "required": [
        "inputs"
      ],
      "title": "TimeseriesJoinConfig",
      "type": "object"
    },
    "factory:timeseries-pivot": {
      "$defs": {
        "WatertownUrl": {
          "type": "string"
        }
      },
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "description": "Configuration for timeseries-pivot factory",
      "properties": {
        "columns": {
          "description": "List of column names to pivot across all matched inputs",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "pattern": {
          "$ref": "#/$defs/WatertownUrl",
          "description": "Pattern to match input files (e.g., \"series:///combined/*\")"
        },
        "time_column": {
          "default": "timestamp",
          "description": "Time column name (default: \"timestamp\")",
          "type": "string"
        },
        "transforms": {
          "description": "Optional list of table transform factory paths to apply to input TableProvider.\nTransforms are applied in order before SQL execution.\nEach transform is a path like \"/etc/hydro_rename\"",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "required": [
        "pattern",
        "columns"
      ],
      "title": "TimeseriesPivotConfig",
      "type": "object"
    },
    "format:csv": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "description": "CSV format options parsed from query parameters\n\nBased on arrow_csv::reader::Format and ReaderBuilder options.\nAll fields have sensible defaults matching arrow_csv defaults.\n\n# URL Examples\n\n- `csv:///data/file.csv` - Default settings (comma delimiter, has header)\n- `csv:///data/file.csv?delimiter=;` - Semicolon delimiter\n- `csv:///data/file.csv?delimiter=;&has_header=false` - No header row\n- `csv:///data/file.csv?batch_size=16384` - Larger batch size",
      "properties": {
        "batch_size": {
          "default": 8192,
          "description": "Number of records per batch (default: 8192)",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "delimiter": {
          "default": ",",
          "description": "Field delimiter (default: ',')",
          "maxLength": 1,
          "minLength": 1,
          "type": "string"
        },
        "escape": {
          "description": "Escape character (default: None)",
          "maxLength": 1,
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "has_header": {
          "default": true,
          "description": "Whether the file has a header row (default: true)",
          "type": "boolean"
        },
        "quote": {
          "default": "\"",
          "description": "Quote character (default: '\"')",
          "maxLength": 1,
          "minLength": 1,
          "type": "string"
        },
        "schema_infer_max_records": {
          "default": 100,
          "description": "Number of rows to sample for schema inference (default: 100)",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        }
      },
      "title": "CsvOptions",
      "type": "object"
    },
    "format:hledger": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "batch_size": {
          "default": 8192,
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        }
      },
      "title": "Options",
      "type": "object"
    },
    "format:xls": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "batch_size": {
          "default": 8192,
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "header": {
          "default": true,
          "type": "boolean"
        },
        "header_row": {
          "default": null,
          "format": "uint",
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "sheet": {
          "default": null,
          "type": [
            "string",
            "null"
          ]
        },
        "table": {
          "default": null,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "title": "XlsOptions",
      "type": "object"
    },
    "sitegen:frontmatter": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "description": "Frontmatter parsed from the top of each markdown page.",
      "properties": {
        "analytics": {
          "default": null,
          "description": "Set false to exclude this page from analytics, independently of navigation.\nTrue never enables analytics when the site or build has disabled it.",
          "type": [
            "boolean",
            "null"
          ]
        },
        "date": {
          "default": null,
          "description": "Publication date (ISO 8601, e.g. \"2024-06-15\").",
          "type": [
            "string",
            "null"
          ]
        },
        "hidden": {
          "default": false,
          "description": "If true, page renders but does not appear in navigation.",
          "type": "boolean"
        },
        "image": {
          "default": null,
          "description": "Image URL for blog card hero image.",
          "type": [
            "string",
            "null"
          ]
        },
        "layout": {
          "default": "default",
          "type": "string"
        },
        "section": {
          "default": null,
          "description": "Navigation section for grouping (e.g., \"About\", \"Blog\").",
          "type": [
            "string",
            "null"
          ]
        },
        "slug": {
          "default": null,
          "description": "URL slug override. If absent, derived from filename.",
          "type": [
            "string",
            "null"
          ]
        },
        "summary": {
          "default": null,
          "description": "Short summary for blog card display.",
          "type": [
            "string",
            "null"
          ]
        },
        "title": {
          "default": "",
          "type": "string"
        },
        "weight": {
          "default": 100,
          "description": "Sort weight for content pages (lower = higher in nav). Default: 100",
          "format": "int32",
          "type": "integer"
        }
      },
      "title": "Frontmatter",
      "type": "object"
    }
  },
  "schemes": [
    "compression:bzip2",
    "compression:gzip",
    "compression:zstd",
    "scheme:data",
    "scheme:file",
    "scheme:series",
    "scheme:table"
  ],
  "shortcodes": [
    "shortcode:base_url",
    "shortcode:blog_grid",
    "shortcode:breadcrumb",
    "shortcode:cap0",
    "shortcode:cap1",
    "shortcode:cap2",
    "shortcode:cap3",
    "shortcode:cap4",
    "shortcode:cap5",
    "shortcode:cap6",
    "shortcode:cap7",
    "shortcode:cap8",
    "shortcode:cap9",
    "shortcode:chart",
    "shortcode:content_nav",
    "shortcode:explore",
    "shortcode:figure",
    "shortcode:log_viewer",
    "shortcode:nav_list",
    "shortcode:overlay_chart",
    "shortcode:pond_status_grid",
    "shortcode:site_title",
    "shortcode:source",
    "shortcode:viz"
  ]
}
