@namewta/speculo 1.0.17 → 1.0.18

package/template/workflows/ops/common/rules/inventory-and-records.md

@@ -0,0 +1,55 @@
+# 集中记录、数据持久化与离线视图
+
+本文件拥有 V 的输出与读取范围。资源事实仍由 status.json v3 与原 Run/Release 执行器维护，不建立第二份可编辑 CMDB。
+
+```text
+state_root/
+  status.json                         # 唯一资源登记事实源；仅原执行网关写入
+  FLEET.md                            # V 生成的简单阅读入口，最后原子更新
+  records/
+    tasks/task-id/
+      PLAN.md                         # 已展示的任务计划，受限文件
+      task.json                       # 冻结规格/输入摘要；不是授权
+      specs/step-id.json
+      summary.json                    # 无自由文本/命令/凭据的视图投影输入
+      authorization.json              # 原始明确任务确认，只读审计，不导出看板
+      started.json                    # 禁止自动重放的持久标记
+      progress.json
+      result.json                     # 不可覆盖终态/恢复说明
+    servers/host-id/checks/
+      check-id.json                   # 不可覆盖检查证据
+      latest.json                     # check_id + 内容摘要
+    views/view-id/
+      inventory.json                  # schema_version=1 的白名单投影
+      FLEET.md
+      index.html                      # 离线单文件；无需 Web 服务
+      manifest.json                   # 每个文件的字节 SHA256 回执
+  hosts/host-id/runs/run-id/           # 保留原计划/批准/日志位置
+  releases/run-id/                    # 保留跨主机/项目证据
+  hosts/host-id/deployments/dep-id/    # 保留双边文档/真实配置镜像
+  private/credentials.json            # 受限账本；V 不读取
+```
+
+## 生成和持久化标准
+
+`fleet` 只读取状态、每台服务器最新完整检查、任务 summary 与必要的进度/结果白名单字段，以及 status.releases 的原 Run 索引。不读取 private、env、server-files、outbox、原 task.json/规格/授权文本。缺失任务提交标记显示 incomplete；有 started/running 而未验证终态显示 needs-inspection，不武断判断进程已中断；坏 JSON、摘要不符或链接跳转拒绝生成，不悄悄丢掉损坏记录。
+
+投影有 schema_version、artifact、generated_at、controller_id、source_revision、source_digest、stale_hours 和 servers/projects/deployments/bindings/releases/tasks。数据字段的机器可读合同是 common/schemas/fleet-view.schema.json；输出模板是 common/templates/FLEET.html。版本或字段语义改变时升级投影 schema，不改 status v3 以迎合 UI。
+
+Server 映射 Host.host_id；deployment 使用 server_id 作为展示字段，保留 project_id、环境、实例、计划与已验证版本。Host.host_services 单列，不伪造 Deployment。Binding 的 external provider 显示外部依赖，不猜其服务器身份。内部 IP、路径、项目名仍可能敏感，所有产物保持受限权限；白名单不是允许把秘密写进 display_name/版本/路径的理由。
+
+同一个 data + 模板字节必须产生相同 HTML/MD；view_id 包含内容与渲染结果摘要。先写不可变快照及 manifest，读回校验，再确认资源修订未变、没有 catalog 锁，最后只更新一个 FLEET.md 入口。中断保留旧入口与不完整快照供检查，不覆盖旧批次。HTML 从内嵌 JSON 读取，不 fetch 本地/外部文件；所有动态文本通过 textContent，禁止 innerHTML/eval、外部 CDN、远端 URL 和 mutation 按钮；内联脚本/样式使用内容摘要 CSP。
+
+只读浏览可重复执行，无需再确认部署授权。生成失败保留原执行事实，不因为看板失败而重跑 apply。多个相同 ID 的工作空间不能靠文件复制自动接管：state_root 与控制端身份必须一致。
+
+## 时间和状态
+
+registered 只说明入账；SSH 公钥认证通过只证明该次登录；base-ready 不代表 Compose-ready；Compose-ready 不代表 APP 健康。checklist 保留必需/可选项、状态和 checked_at，默认超过 24 小时显示 stale。身份、连接或 known_hosts 内容变化、缺失时显示 unknown。历史 pass 项仍可回看，但不得使用过期结果作为当前验收。
+
+Node/Docker/Compose、根目录存在、磁盘/内存有自动只读检查。最小权限、时间同步、防火墙、外部依赖和备份恢复默认 unknown，需按项目要求取得真实证据；V 不将它们补写为 pass。没有探测不等于正常。现有 inventory 不验证根目录可写，也不证明备份可恢复。
+
+## 兼容与迁移
+
+不搬迁原 hosts/*/runs、releases、private、配置镜像或远端目录。现有 runtime-contract 的 opaque_default=preserve-byte-for-byte 继续保护 records，刷新静态 Work 不删除状态。FLEET-DEPLOYMENTS.md 仍由原双边交付生成器维护，V 只拥有 FLEET.md 和 records/views。
+
+新增执行器模块/JSON schema 会改变 engine_digest，因此尚未执行的旧计划需要重新生成批准；unknown/运行中现场先 inspect-run，不直接重新部署。旧审批、账本与回执不复用、不篡改。卸载静态扩展也不删除 records 或业务数据。

package/template/workflows/ops/common/rules/research-and-decisions.md

@@ -0,0 +1,18 @@
+# GitHub 调研与采用边界
+
+调研使用 GitHub 仓库搜索及固定提交原文，未安装第三方 Skill、未执行其脚本、未复制外部实现。以下材料用于方法选择，不构成部署授权或对第三方“生产可用”宣传的背书。
+
+| 来源 | 实际读取内容 | 本次采用 | 不直接采用 |
+| --- | --- | --- | --- |
+| [Ansible inventory](https://github.com/ansible/ansible-documentation/blob/7c56be6c083a7f76842be01d16522e7e6309d9c8/docs/docsite/rst/inventory_guide/intro_inventory.rst) | managed nodes、inventory、按模式选择目标；what/where/when 分组 | 独立资源清单、显式目标选择、控制端与被管节点区分；保留 Project/Deployment 关系 | 不新引入 Ansible 运行依赖，不用 all/隐式分组扩展当前任务 |
+| [Linux administration Skill](https://github.com/BagelHole/DevOps-Security-Agent-Skills/blob/0365f57a079b1332f95cf26e31dd2d5332a8399f/infrastructure/servers/linux-administration/SKILL.md) | 包管理、系统信息、文件系统和资源诊断 | 将检查清单按系统/资源/运行环境组织，固定版本且先诊断 | 不照搬 apt upgrade、格式化文件系统、广域清理或随意安装 |
+| [SSH configuration Skill](https://github.com/BagelHole/DevOps-Security-Agent-Skills/blob/0365f57a079b1332f95cf26e31dd2d5332a8399f/infrastructure/servers/ssh-configuration/SKILL.md) | key/agent、指纹、客户端配置、公钥分发、轮换先验证新 key | 密钥/agent 优先、公钥认证单独验收、保留旧通道、接入失败明确阻塞 | 不默认无口令私钥，不自动清 agent，不照搬 sshd 算法清单/关闭密码登录，不隐式添加 ProxyJump 能力 |
+| [Speculo 基线执行器](https://github.com/NAMEWTA/Speculo/tree/60389759ede9f8c4f14b2f7e70da614dfe574ece/template/workflows/ops/common/tools/opslib) | planner、execution、transport、agent、CLI 与 schema | 复用摘要批准、受限写集、身份验证、失败停止、双边回执 | 不重写已有安全底座，不移动历史 Run，不用可视化替代真实验收 |
+
+## 设计取舍
+
+一次授权的对象是有限任务与精确规格，不是“此后所有运维”。本次任务 runner 增加编译前/后的目标与修改集检查，保留原逐 Run 审批文件，但不要求每步由用户再次对话确认。它不是签名授权系统，也不是防御拥有控制端写权限的恶意管理员的沙箱。
+
+离线 HTML 选择原生 HTML/CSS/JavaScript，无前端构建或网络依赖。读模型从 status 与受限证据白名单生成，而非引入第二套数据库。schema v3 不变、新投影 v1、新记录集中 records；这是兼容性重构，不是对既有历史证据的搬家。已有明文历史/真实 env 不自动清理。
+
+第一版不宣称支持云资源发现、JumpHost 参数、首次密码自动登录、远程命令按钮、实时监控、数据库自动恢复或全量 CIS 合规评估。这些都需要独立适配与验收，不通过文档暗示已经实现。

package/template/workflows/ops/common/rules/server-onboarding.md

@@ -0,0 +1,21 @@
+# S：服务器接入与 SSH 公钥认证
+
+本文件只在新增/修复服务器接入时读取。Server 是目标机器，不是发起操作的控制端；host_id 保持既有内部身份。
+
+## 接入顺序
+
+确认用户已经提供的 server_id、地址/端口、远端账号、专用 host.root、可信主机指纹、控制端 SSH 客户端与认证来源；不重复索取已有输入，不把别名相似当作同一服务器。首次指纹必须经云控制台/控制台/既有可信渠道核对，ssh-keyscan 只能收集候选值，不能完成信任。
+
+优先复用受限私钥与 ssh-agent。免密登录指无需重复输入服务器账号密码，不等于私钥必须无口令；不得默认 ssh-keygen -N ""，不得复制私钥到服务器、项目或看板，也不把密码放在 JSON/argv/日志。只登记 identity_file 的本地受限路径；使用 agent 时不能自动清空用户已有 agent。
+
+已有可信登录通道时，仅在原明确授权范围内分发指定公钥，保持旧登录通道，核验新会话成功后才讨论轮换撤销。公钥分发/sshd 修改不是 task-run 的隐式能力；当前执行器不提供首次密码登录或 authorized_keys 写入适配。缺少已验证 key/agent 时，给出待用户在可信交互终端/云控制台完成的最小公钥分发步骤与精确目标，记录“接入阻塞”，不要宣称自动完成，也不要绕过 ops 的写入网关用 sshpass 或任意 shell 写服务器。禁止为方便部署自动关闭密码登录、改 SSH 端口或重启 sshd；这些需要专用可恢复方案。
+
+信任和公钥认证具备后，用 USAGE 中的 discovery/probe 读取身份；Linux SSH 缺 Node 时走原 bootstrap-node 的固定 Volta/Node、已审核 tar SHA256 与独立 ack。复用已有 Node，不改 shell profile。随后 enroll（或 register + probe --host）把真实身份与盘点持久化；identity=discover 不可用于 apply。
+
+最后运行 `server-check --server ID --profile base`。只有成功验证严格主机密钥、公钥认证和实际机器身份后，才写“接入检查通过”；未通过项与证据文件必须列出。需要 Docker 的项目再走 H 的 compose profile，不能把 base-ready 等同完整部署基线。
+
+## 基础环境清单
+
+清单固定包括登记、SSH 公钥、机器身份、Linux、Node、根目录、磁盘、内存、Docker、Compose、Docker data-root、最小权限、时间同步、防火墙、外部依赖、备份恢复。后五项没有自动证据时保持 unknown；不抄一套 Linux 加固命令盲目关闭端口/清缓存/升级全机。
+
+完成输出：status.hosts 的明确资源、原 hosts/ID/inventory 盘点、records/servers/ID/checks 的检查回执、剩余缺口和下一 Work。执行 V 刷新本地列表，使用户直接从 FLEET.md 进入对应服务器及项目视图。连接失效/指纹改变先停止，不自动替换 known_hosts 或注册另一台机器为同一身份。

package/template/workflows/ops/common/rules/workspace-and-authorization.md

@@ -0,0 +1,39 @@
+# 层级路由与一次任务授权
+
+本文件拥有范围选择和任务级授权规则。执行能力、路径保护、单计划批准和双边回执仍由 README、原 spec/plan schema 及执行器负责。
+
+## 范围必须显式
+
+| 用户目的 | scope / Work | 必需输入 | 明确不做 |
+| --- | --- | --- | --- |
+| 准备发起操作的本机 | controller / I | 控制端 ID、绝对 state 根 | 不默认把本机登记为服务器 |
+| 接入一台服务器 | access / S | 一个 server_id、可信连接与身份 | 不部署项目、不自动信任主机密钥 |
+| 配置系统环境、Docker、Nginx | server / H | 一个已登记 server_id | 不从 cwd 推断 project |
+| 安装 APP 或共享服务 | project / D | 一个 project_id、明确 server_ids、真实需求 | 不猜服务器、不把主机级入口伪装成 APP |
+| 看服务器/项目清单 | inventory / V | 已初始化 state 根 | 不联网、不部署、不授予后续操作权限 |
+
+服务本身是用户交付项目（如公共 MySQL）时走 D；为整个服务器提供基础入口的 Nginx/WireGuard 走 H。项目包含服务反向代理配置不自动拥有整台机器的系统修改权限。用户已给出的目标直接使用，不重复询问；名称无法唯一解析时只阻塞该目标，先完成无歧义只读分析。
+
+## 确认任务后，展示 Plan Mode 然后执行
+
+用户明确说“按计划实施/重构并执行/部署到指定服务器”属于实施请求；只说“分析/给计划/看看”不构成执行授权。入口先写清目标、服务器与项目、前置检查、固定来源、持久化、依赖顺序、网络与账号影响、备份恢复、健康检查、完成条件、保留/删除边界，再开始执行；不在每步重复询问“是否继续”。
+
+任务文件不是授权来源。`task-plan` 保存详细 PLAN.md 与冻结的 H/D specs，返回 task_digest；入口已展示计划且存在明确实施请求时，用 `task-authorize` 记录该原始请求的真实确认语句/来源和确认者，再直接 `task-run`。不要求用户手动执行这三个命令，不伪造用户逐一看过未来 Run digest。
+
+H 入口选择一台明确服务器；一个 server 任务可以串行多个 H 步骤，并显式列出包括文档/依赖影响在内的所有获准服务器，不允许变成 D 部署。
+
+任务授权固定一个 Controller、显式服务器、一个主项目（server scope 无主项目）、已声明的影响/依赖项目、1–20 个有序规格、最长 24 小时有效期、执行器摘要、连接/known_hosts 内容、凭据账本、input_paths 文件树。输入每文件 ≤16 MiB、总计 ≤256 MiB/10000 文件；大构件使用经审阅的固定摘要下载适配，不内嵌大二进制。H 影响已有服务时把相关项目和 acknowledged_consumers 全部写清。
+
+运行器针对每个冻结规格在执行前重新编译实际现场计划，检查声明范围、依赖消费者、编译器完整修改集、源码摘要，再写入 `approved_by=task:<task_id>` 的关联批准；之后调用原 apply。H 为 D 准备环境产生的受控状态变化可在同一任务中继续；无法提前明确的新规格、额外服务器/项目或现场不确定性不能自动扩展。通用自定义命令仍是已审核可执行代码，不是系统调用沙箱；尤其须审核下载来源、安装器、命令引用文件和实际持久化参数。
+
+`allow_policy_changes`、`allow_public_ingress`、`allow_destructive` 必须显式声明。迁移、退役、purge-quarantine 还需独立的 `I-APPROVE-THIS-EXACT-DESTRUCTIVE-TASK` 范围确认；它可以包含在原任务授权中，但不能从普通部署请求推断。业务数据删除仍不是默认能力。
+
+## 停止与恢复
+
+首次任务执行要求资源修订未在准备后发生变化；每步开始前复核身份、连接、输入、凭据、执行器和有效期。计划过期/漂移、未知目标、缺权限、真实输入缺失或锁冲突只阻塞受影响动作，不以“要再确认一下”为由重复打断已授权正常步骤。
+
+一旦出现 failed、partial、unknown 或 docs_pending，停止后续步骤并保留 progress、Run 引用、原计划/日志/双边回执。任何 started.json 都禁止 task-run 自动重放，包括已完成任务。不能用新的 task_id 包装同一未知操作以绕过恢复。先 inspect-run，遵循 recovery.md；需要修复或重新部署时形成新的明确规格与任务边界。
+
+正常完成必须以原 apply 返回 completed 且双边回执成立为准，再生成 V 的本地视图。V 失败记为“执行结果已保存、视图生成失败”，不能重跑业务。文档或索引不会自动变成永久知识；知识写入仍走原 owner/gateway 并获得独立同意。
+
+当前任务编排只接入 H/D；I 初始化和 S 的首次信任建立/固定 Node bootstrap 保留原网关，不用任务授权掩盖缺失的 SSH 登录条件。

package/template/workflows/ops/common/schemas/fleet-view.schema.json

@@ -0,0 +1,487 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:ops:fleet-view:v1",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "artifact": {
+      "const": "ops-fleet-view"
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "controller_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "maxLength": 80
+    },
+    "source_revision": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "source_digest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "stale_hours": {
+      "type": "number",
+      "exclusiveMinimum": 0,
+      "maximum": 8760
+    },
+    "notice": {
+      "type": "string"
+    },
+    "servers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "server_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "name": {
+            "type": "string"
+          },
+          "platform": {
+            "type": "string"
+          },
+          "transport": {
+            "enum": [
+              "local",
+              "ssh"
+            ]
+          },
+          "address": {
+            "type": "string"
+          },
+          "port": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "minimum": 1,
+            "maximum": 65535
+          },
+          "root": {
+            "type": "string"
+          },
+          "readiness": {
+            "enum": [
+              "unknown",
+              "stale",
+              "blocked",
+              "ready"
+            ]
+          },
+          "profile": {
+            "enum": [
+              null,
+              "base",
+              "compose",
+              "native"
+            ]
+          },
+          "checked_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "checks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "status": {
+                  "enum": [
+                    "pass",
+                    "fail",
+                    "warn",
+                    "unknown",
+                    "not-applicable"
+                  ]
+                },
+                "required": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "id",
+                "status",
+                "required"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "project_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "deployment_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "host_services": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "service_id": {
+                  "type": "string",
+                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+                  "maxLength": 80
+                },
+                "kind": {
+                  "type": "string"
+                },
+                "unit": {
+                  "type": "string"
+                },
+                "port": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "service_id",
+                "kind",
+                "unit",
+                "port"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "server_id",
+          "name",
+          "platform",
+          "transport",
+          "address",
+          "port",
+          "root",
+          "readiness",
+          "profile",
+          "checked_at",
+          "checks",
+          "project_ids",
+          "deployment_ids",
+          "host_services"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "projects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "kind": {
+            "type": "string"
+          },
+          "service_type": {
+            "type": "string"
+          },
+          "server_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "deployment_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "project_id",
+          "name",
+          "kind",
+          "service_type",
+          "server_ids",
+          "deployment_ids"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "deployments": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "deployment_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "project_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "server_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "environment": {
+            "type": "string"
+          },
+          "instance": {
+            "type": "string"
+          },
+          "method": {
+            "type": "string"
+          },
+          "root": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "desired_version": {
+            "type": "string"
+          },
+          "observed_version": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "updated_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "run_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "deployment_id",
+          "project_id",
+          "server_id",
+          "environment",
+          "instance",
+          "method",
+          "root",
+          "status",
+          "desired_version",
+          "observed_version",
+          "updated_at",
+          "run_id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "bindings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "binding_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "consumer_deployment_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "provider_deployment_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "mode": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "binding_id",
+          "consumer_deployment_id",
+          "provider_deployment_id",
+          "mode",
+          "status"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "releases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "worker": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "server_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "deployment_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "updated_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "run_id",
+          "worker",
+          "status",
+          "server_ids",
+          "deployment_ids",
+          "updated_at"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 80
+          },
+          "scope": {
+            "type": "string"
+          },
+          "server_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "project_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          },
+          "status": {
+            "type": "string"
+          },
+          "updated_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "run_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+              "maxLength": 80
+            },
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "task_id",
+          "scope",
+          "server_ids",
+          "project_ids",
+          "status",
+          "updated_at",
+          "run_ids"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "artifact",
+    "generated_at",
+    "controller_id",
+    "source_revision",
+    "source_digest",
+    "stale_hours",
+    "notice",
+    "servers",
+    "projects",
+    "deployments",
+    "bindings",
+    "releases",
+    "tasks"
+  ],
+  "additionalProperties": false
+}