@sema-agent/settings-schema 2.1.0 → 3.0.0

package/conformance/cases/c34-skills-content-vs-manifest/expected.json

@@ -0,0 +1,160 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "prompts": {
+        "bindings": []
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": [
+          {
+            "content": "# hello",
+            "description": "d",
+            "enabled": true,
+            "name": "sk1",
+            "rosters": [],
+            "scenarios": []
+          }
+        ]
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [
+      {
+        "domain": "skills",
+        "keys": [
+          [
+            "skills",
+            0,
+            "zzzTypo"
+          ]
+        ],
+        "kind": "unknown-keys-dropped"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": [
+          {
+            "contentHash": "sha256:ea67f39f2a707e536439ee31e49fdd586b4a8437d3408f0466112d040cd06681",
+            "description": "d",
+            "enabled": true,
+            "name": "sk1",
+            "rosters": [],
+            "scenarios": []
+          }
+        ]
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    },
+    "why": "skills 是五条变换里唯一**算出新值**的那条(content → contentHash);派生会让入参与期望同时用被测的那只哈希,算错也两侧同样错 ⇒ wire 腿写显式金样冻结哈希"
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 3769383338762029
+  }
+}

package/conformance/cases/c34-skills-content-vs-manifest/input.json

@@ -0,0 +1,18 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "skills": {
+      "skills": [
+        {
+          "name": "sk1",
+          "description": "d",
+          "content": "# hello",
+          "zzzTypo": 1
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/c34-skills-content-vs-manifest/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "skills 是三腿之间**唯一**的表示差异(T2):域形/本地形带 `content`,wire 形带 `contentHash`。两侧的条目 schema 必须逐字对应(manifest = 域条目 omit content + contentHash),否则 center 一发 manifest,消费端就整张 skill 清单蒸发(wire 腿用的是另一张 schema,域 schema 会把每一条合法 manifest 都判坏)。条目上的未知键在域腿被点名、在 wire 腿**没有**这条告警(manifest 不走剥键扫描)—— 这处不对称也要写在变换表里,不能靠谁记得。",
+  "firstRedOn": []
+}

package/conformance/cases/c35-portable-domain-file-is-null/expected.json

@@ -0,0 +1,76 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "prompts": {
+        "bindings": []
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": []
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [
+      {
+        "domain": "mcp",
+        "kind": "domain-defaulted"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true
+  }
+}

package/conformance/cases/c35-portable-domain-file-is-null/input.json

@@ -0,0 +1,9 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "mcp": null
+  }
+}

package/conformance/cases/c35-portable-domain-file-is-null/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "一个**便携**域的文档是 JSON `null`:domains/wire 两腿走域档位(mcp 是 default 档 ⇒ 降级 + 一条告警),local-root 腿却在**文件层**就拒(`config.d/mcp.json` 的内容必须是对象)—— 同一份输入,两种正确结局。把这条差异当故障去「修平」的消费方,会把一次半写文件读成一份空的 MCP 注册表。",
+  "firstRedOn": []
+}

package/conformance/cases/c36-skills-entry-without-content/expected.json

@@ -0,0 +1,144 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "prompts": {
+        "bindings": []
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": [
+          {
+            "content": "",
+            "description": "d",
+            "enabled": true,
+            "name": "sk-no-content",
+            "rosters": [],
+            "scenarios": []
+          }
+        ]
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": []
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [
+      {
+        "domain": "skills",
+        "kind": "domain-defaulted"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    },
+    "why": "skills 表示变换在这条上非恒等(域腿补了默认 content,wire 入参没有)⇒ 不派生,写显式金样"
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 4186654769350880
+  }
+}

package/conformance/cases/c36-skills-entry-without-content/input.json

@@ -0,0 +1,16 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "skills": {
+      "skills": [
+        {
+          "name": "sk-no-content",
+          "description": "d"
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/c36-skills-entry-without-content/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "skills 条目**不写 content**:域腿把它补成空串(合法条目),而 wire 入参是从**原文档**结构变换出来的 —— 没有 content 就没有 contentHash,manifest schema 判它坏,整条 skill 消失并发 domain-defaulted。同一份文档在两条腿上一条活一条死,而这**不是**表示变换能解释的差异:它是「派生看原文档、期望看已解析文档」这层不对称的真实后果。语料把它钉成显式金样,消费方照着写投影时才不会以为「缺 content 也没事」。",
+  "firstRedOn": []
+}

package/conformance/cases/c37-skills-field-null/expected.json

@@ -0,0 +1,134 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "prompts": {
+        "bindings": []
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": []
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [
+      {
+        "domain": "skills",
+        "kind": "domain-defaulted"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": []
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    },
+    "why": "wire 腿的 `r.skills ?? {}` 把 null 读成缺席(域腿读成坏形),告警多重集因此不同 ⇒ 不派生,写显式金样"
+  },
+  "localRoot": {
+    "derive": true
+  }
+}

package/conformance/cases/c37-skills-field-null/input.json

@@ -0,0 +1,9 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "skills": null
+  }
+}

package/conformance/cases/c37-skills-field-null/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "`skills: null`:域腿判它坏形 ⇒ 降级 + 一条 domain-defaulted;wire 腿走 `r.skills ?? {}`,**null 被当成缺席** ⇒ 解析出空清单、**零告警**。同一份输入,一条腿出声一条腿不出声 —— 消费方把两条腿的告警折进同一个面板时,这条差异会变成「有时候有、有时候没有」的幽灵。钉成显式金样。",
+  "firstRedOn": []
+}

package/conformance/cases/c38-remote-exec-is-a-non-domain-file/expected.json

@@ -0,0 +1,72 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "prompts": {
+        "bindings": []
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": []
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 2617555914511015
+  }
+}

package/conformance/cases/c38-remote-exec-is-a-non-domain-file/input.json

@@ -0,0 +1,11 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "remote-exec": {
+      "provider": "host"
+    }
+  }
+}

package/conformance/cases/c38-remote-exec-is-a-non-domain-file/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "`remote-exec` **不是域、也不是未知文件**:它按表决住在 `config.d/` 里,有自己的读取与校验路径(`loadRemoteExec`),所以本地腿的未知文件扫描**刻意豁免**它。wire 腿把它当 open-world 顶层键逐字承运,域腿根本不问它。把它报成 `not-a-domain` 的门,会对着一份完全合法的单机部署喊错 —— 这条是登记表第六条(T6 文件名分类)的正例。",
+  "firstRedOn": []
+}