@sema-agent/settings-schema 2.1.0 → 3.0.0

package/conformance/cases/c03-literal-dotted-top-key/expected.json

@@ -0,0 +1,112 @@
+{
+  "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
+          },
+          {
+            "api": "openai-completions",
+            "apiKeyEnv": "OPENAI_API_KEY",
+            "enabled": true,
+            "id": "m1-id",
+            "name": "m1",
+            "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",
+            1,
+            "k"
+          ],
+          [
+            "models.1.k"
+          ]
+        ],
+        "kind": "unknown-keys-dropped"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 3532081824041502
+  }
+}

package/conformance/cases/c03-literal-dotted-top-key/input.json

@@ -0,0 +1,26 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "models": {
+      "models": [
+        {
+          "name": "m0",
+          "provider": "openai",
+          "id": "m0-id",
+          "apiKeyEnv": "OPENAI_API_KEY"
+        },
+        {
+          "name": "m1",
+          "provider": "openai",
+          "id": "m1-id",
+          "apiKeyEnv": "OPENAI_API_KEY",
+          "k": 1
+        }
+      ],
+      "models.1.k": 1
+    }
+  }
+}

package/conformance/cases/c03-literal-dotted-top-key/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "同一份文档里同时有字面叫 `models.1.k` 的顶层键与 models[1] 里的未知键 `k` —— 2.1.0 的点号串把两者编码成同一个串(S-323c 登记的残余二义)。段坐标下两条必须不同,且比对器按段深相等直比、零 stringify。",
+  "firstRedOn": []
+}

package/conformance/cases/c04-all-bad-collection-not-salvaged/expected.json

@@ -0,0 +1,77 @@
+{
+  "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": "models",
+        "kind": "domain-defaulted"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 2762339062543970
+  }
+}

package/conformance/cases/c04-all-bad-collection-not-salvaged/input.json

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

package/conformance/cases/c04-all-bad-collection-not-salvaged/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "一个集合**所有**条目都坏 = 整个坏掉的集合,不是「部分损坏」。抢救绝不凭空造出一个空集合(空的限制清单常常等于放权),所以这里一条 entry-dropped 都不许发,只发整域降级。",
+  "firstRedOn": []
+}

package/conformance/cases/c05-gate-domain-bad-entry-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": "validate",
+    "why": "rosters 是便携域,文件层过得去(是 JSON 对象),拒绝发生在域校验层"
+  }
+}

package/conformance/cases/c05-gate-domain-bad-entry-throws/input.json

@@ -0,0 +1,18 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "rosters": {
+      "rosters": [
+        {
+          "name": "r1"
+        },
+        {
+          "name": 5
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/c05-gate-domain-bad-entry-throws/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "gate 域(rosters)坏条目**整域拒**,不逐条容错 —— 悄悄丢一条 roster 就是那个 worker 静默拿到全量目录(放权)。三腿都必须拒,任何一腿「容错一下」都是跨仓分歧里最贵的那种。",
+  "firstRedOn": []
+}

package/conformance/cases/c06-legacy-governance-lift/expected.json

@@ -0,0 +1,99 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {
+        "approvalRequire": [
+          "deploy"
+        ],
+        "autonomy": "ask",
+        "commandPolicy": [
+          {
+            "command": "rm",
+            "decision": "deny"
+          }
+        ]
+      },
+      "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"
+          ],
+          [
+            "commandPolicy"
+          ],
+          [
+            "approvalRequire"
+          ]
+        ],
+        "kind": "legacy-governance-lifted"
+      }
+    ],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 442574663489663
+  }
+}

package/conformance/cases/c06-legacy-governance-lift/input.json

@@ -0,0 +1,20 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "runtime": {
+      "autonomy": "ask",
+      "commandPolicy": [
+        {
+          "command": "rm",
+          "decision": "deny"
+        }
+      ],
+      "approvalRequire": [
+        "deploy"
+      ]
+    }
+  }
+}

package/conformance/cases/c06-legacy-governance-lift/meta.json

@@ -0,0 +1,9 @@
+{
+  "contributor": "contract",
+  "claim": "governance 域从未设过时,读侧会从 0.5 期的 runtime 文档里把治理三闸抬起来。兼容臂真生效必须出声(legacy-governance-lifted),否则窗永远关不掉;三腿要同样出声、坐标同样是三个单段键。",
+  "firstRedOn": [
+    "settings-schema@1.0.0",
+    "settings-schema@1.10.0",
+    "settings-schema@1.5.0"
+  ]
+}

package/conformance/cases/c07-hooks-is-not-a-config-domain/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/c07-hooks-is-not-a-config-domain/input.json

@@ -0,0 +1,43 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "hooks": {
+      "PreModelSwitch": [
+        {
+          "matcher": "*",
+          "hooks": [
+            {
+              "type": "command",
+              "command": "echo pre"
+            }
+          ]
+        }
+      ],
+      "PostModelSwitch": [
+        {
+          "matcher": "*",
+          "hooks": [
+            {
+              "type": "command",
+              "command": "echo post"
+            }
+          ]
+        }
+      ],
+      "postToolBatchX": [
+        {
+          "matcher": "*",
+          "hooks": [
+            {
+              "type": "command",
+              "command": "echo out-of-set"
+            }
+          ]
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/c07-hooks-is-not-a-config-domain/meta.json

@@ -0,0 +1,6 @@
+{
+  "contributor": "core",
+  "claim": "`hooks` **不是配置域**(DOMAIN_SCHEMAS 十七员里没有它;HooksConfig 住在 TaskRequest.settings 那条 wire 上)。于是一份带 PreModelSwitch / PostModelSwitch / 闭集外家族名的 hooks 文档:wire 腿按 open-world **逐字承运、零告警**(= server 表态要的护栏形),domains 腿根本不会去问它(无声),local-root 腿把它报成 not-a-domain。三腿三样,谁把它当域谁就错。",
+  "firstRedOn": [],
+  "note": "与 client-core ④(hooks 闭集之外的家族名)合成一条 case 两期望;server 半场表态 = 不拒不映射、逐字保留、零告警。"
+}