@sema-agent/settings-schema 2.0.0 → 3.0.0

package/conformance/cases/c17-empty-domain-file/input.json

@@ -0,0 +1,10 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {},
+  "localFiles": {
+    "models.json": "   \n"
+  }
+}

package/conformance/cases/c17-empty-domain-file/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "`config.d/models.json` 存在但**是空白** —— 半写/截断,fail-closed 拒,绝不当「缺席→默认」(当成缺席就是一次静默的域丢失)。这一层只有 local-root 腿有:domains/wire 两腿看到的是「没有这个域」。",
+  "firstRedOn": []
+}

package/conformance/cases/c18-wire-envelope-not-an-object/expected.json

@@ -0,0 +1,74 @@
+{
+  "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": {
+    "outcome": "rejected",
+    "stage": "envelope",
+    "why": "载荷不是 JSON 对象,信封层拒;domains/local 两腿没有信封"
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 2617555914511015
+  }
+}

package/conformance/cases/c18-wire-envelope-not-an-object/input.json

@@ -0,0 +1,8 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {},
+  "wirePayload": []
+}

package/conformance/cases/c18-wire-envelope-not-an-object/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "wire 载荷是数组 —— 这不是「某个域坏了」,而是「它根本不是一份 effective」。信封层直接拒,不许退默认后照常返回一份空配置。",
+  "firstRedOn": []
+}

package/conformance/cases/c19-wire-envelope-no-version/expected.json

@@ -0,0 +1,74 @@
+{
+  "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": {
+    "outcome": "rejected",
+    "stage": "envelope",
+    "why": "缺 numeric version,信封层拒"
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 2617555914511015
+  }
+}

package/conformance/cases/c19-wire-envelope-no-version/input.json

@@ -0,0 +1,13 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {},
+  "wirePayload": {
+    "updatedAt": "2026-09-16T00:00:00.000Z",
+    "models": {
+      "models": []
+    }
+  }
+}

package/conformance/cases/c19-wire-envelope-no-version/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "wire 载荷缺 version(或非有限数)—— 同上,信封层拒。version 是消费方跳过重复应用的唯一依据,没有它的载荷不能被「部分信任」。",
+  "firstRedOn": []
+}

package/conformance/cases/c20-governance-absent-lifts/expected.json

@@ -0,0 +1,84 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {
+        "autonomy": "plan"
+      },
+      "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": "governance",
+        "keys": [
+          [
+            "autonomy"
+          ]
+        ],
+        "kind": "legacy-governance-lifted"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 116867246918368
+  }
+}

package/conformance/cases/c20-governance-absent-lifts/input.json

@@ -0,0 +1,11 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "runtime": {
+      "autonomy": "plan"
+    }
+  }
+}

package/conformance/cases/c20-governance-absent-lifts/meta.json

@@ -0,0 +1,9 @@
+{
+  "contributor": "contract",
+  "claim": "governance 三形之一:**缺席** + 旧 runtime 带三闸 ⇒ 抬升生效并出声。与下面两条合起来钉优先序。",
+  "firstRedOn": [
+    "settings-schema@1.0.0",
+    "settings-schema@1.10.0",
+    "settings-schema@1.5.0"
+  ]
+}

package/conformance/cases/c21-governance-empty-object-wins/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": 2876408377214271
+  }
+}

package/conformance/cases/c21-governance-empty-object-wins/input.json

@@ -0,0 +1,12 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "governance": {},
+    "runtime": {
+      "autonomy": "plan"
+    }
+  }
+}

package/conformance/cases/c21-governance-empty-object-wins/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "governance 三形之二:显式 `{}`(设过了,但一个键都没有)⇒ **它赢**,不抬升、零告警。「设了空」与「没设」在下游是两件事:前者意味着 center 明确不管这三闸,后者才回落旧文档。任一腿把 `{}` 当缺席,运维的停管决定就被旧数据悄悄推翻。",
+  "firstRedOn": []
+}

package/conformance/cases/c22-governance-null-throws/expected.json

@@ -0,0 +1,16 @@
+{
+  "domains": {
+    "outcome": "rejected",
+    "stage": "validate"
+  },
+  "wire": {
+    "outcome": "rejected",
+    "stage": "validate",
+    "why": "domains 腿拒绝态不派生;wire 腿同一个 buildEffective,同层拒"
+  },
+  "localRoot": {
+    "outcome": "rejected",
+    "stage": "parse",
+    "why": "local 腿先撞文件层:config.d/governance.json 的内容是 JSON `null`,不是对象 ⇒ 文件层就拒(比域校验层更早)"
+  }
+}

package/conformance/cases/c22-governance-null-throws/input.json

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

package/conformance/cases/c22-governance-null-throws/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "governance 三形之三:显式 `null` ⇒ 坏输入。governance 是 throw 档(降级 = 运维的护栏静默消失 = 放权),三腿都必须拒。",
+  "firstRedOn": []
+}

package/conformance/cases/c23-mixed-validity-models/expected.json

@@ -0,0 +1,106 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [
+          {
+            "api": "openai-completions",
+            "apiKeyEnv": "OPENAI_API_KEY",
+            "enabled": true,
+            "id": "keep-a-id",
+            "name": "keep-a",
+            "provider": "openai",
+            "quotaWeight": 1,
+            "reasoning": false,
+            "tier": "standard",
+            "vision": false
+          },
+          {
+            "api": "openai-completions",
+            "apiKeyEnv": "OPENAI_API_KEY",
+            "enabled": true,
+            "id": "keep-b-id",
+            "name": "keep-b",
+            "provider": "openai",
+            "quotaWeight": 1,
+            "reasoning": false,
+            "tier": "standard",
+            "vision": false
+          }
+        ],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "prompts": {
+        "bindings": []
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": []
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [
+      {
+        "domain": "models",
+        "kind": "entry-dropped",
+        "path": [
+          "models",
+          1
+        ]
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 3336475058493084
+  }
+}

package/conformance/cases/c23-mixed-validity-models/input.json

@@ -0,0 +1,27 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "models": {
+      "models": [
+        {
+          "name": "keep-a",
+          "provider": "openai",
+          "id": "keep-a-id",
+          "apiKeyEnv": "OPENAI_API_KEY"
+        },
+        {
+          "name": "bad-entry"
+        },
+        {
+          "name": "keep-b",
+          "provider": "openai",
+          "id": "keep-b-id",
+          "apiKeyEnv": "OPENAI_API_KEY"
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/c23-mixed-validity-models/meta.json

@@ -0,0 +1,9 @@
+{
+  "contributor": "contract",
+  "claim": "混合有效性:三条模型里坏一条 ⇒ 只丢那一条并逐条点名,同域好兄弟活下来。这是 1.11.0 逐条容错律的正例,三腿必须丢同一条、报同一个下标。",
+  "firstRedOn": [
+    "settings-schema@1.0.0",
+    "settings-schema@1.10.0",
+    "settings-schema@1.5.0"
+  ]
+}

package/conformance/cases/c24-valid-entries-with-unknown-keys/expected.json

@@ -0,0 +1,100 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": []
+      },
+      "models": {
+        "models": [
+          {
+            "api": "openai-completions",
+            "apiKeyEnv": "OPENAI_API_KEY",
+            "enabled": true,
+            "id": "m0-id",
+            "name": "m0",
+            "provider": "openai",
+            "quotaWeight": 1,
+            "reasoning": false,
+            "tier": "standard",
+            "vision": false
+          }
+        ],
+        "roles": {},
+        "tierGroups": []
+      },
+      "plugins": {
+        "plugins": []
+      },
+      "projects": {
+        "projects": {}
+      },
+      "prompts": {
+        "bindings": []
+      },
+      "rosters": {
+        "rosters": []
+      },
+      "runtime": {},
+      "scenarios": {
+        "scenarios": []
+      },
+      "skills": {
+        "skills": []
+      },
+      "systems": {
+        "systems": []
+      },
+      "workers": {
+        "workers": []
+      }
+    },
+    "warnings": [
+      {
+        "domain": "models",
+        "keys": [
+          [
+            "models",
+            0,
+            "typoKey"
+          ],
+          [
+            "zzzTop"
+          ]
+        ],
+        "kind": "unknown-keys-dropped"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 4283098253643745
+  }
+}