@sema-agent/settings-schema 2.1.0 → 3.0.0

package/conformance/cases/c39-hidden-file-in-config-d/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/c39-hidden-file-in-config-d/input.json

@@ -0,0 +1,11 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    ".hidden": {
+      "a": 1
+    }
+  }
+}

package/conformance/cases/c39-hidden-file-in-config-d/meta.json

@@ -0,0 +1,5 @@
+{
+  "contributor": "contract",
+  "claim": "`config.d/` 里的**隐藏文件**(含原子写留下的 `.<域>.json.*.tmp` 中间态)被扫描忽略,不报未知文件 —— 否则每一次并发写盘都会在审计流里炸出一条假告警。同 T6 的另一半正例;wire 腿照样逐字承运这个顶层键(open-world 不认识文件名这回事)。",
+  "firstRedOn": []
+}

package/conformance/cases/cc01-mcp-toolfaces-non-object/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": [
+          {
+            "elicitation": false,
+            "enabled": true,
+            "name": "s-null",
+            "rosters": [],
+            "scenarios": [],
+            "toolFaces": null,
+            "transport": {
+              "kind": "http",
+              "url": "https://a.example"
+            }
+          },
+          {
+            "elicitation": false,
+            "enabled": true,
+            "name": "s-array",
+            "rosters": [],
+            "scenarios": [],
+            "toolFaces": [
+              1,
+              2
+            ],
+            "transport": {
+              "kind": "http",
+              "url": "https://b.example"
+            }
+          },
+          {
+            "elicitation": false,
+            "enabled": true,
+            "name": "s-string",
+            "rosters": [],
+            "scenarios": [],
+            "toolFaces": "not-an-object",
+            "transport": {
+              "kind": "http",
+              "url": "https://c.example"
+            }
+          }
+        ]
+      },
+      "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": 197807763204275
+  }
+}

package/conformance/cases/cc01-mcp-toolfaces-non-object/input.json

@@ -0,0 +1,39 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "mcp": {
+      "servers": [
+        {
+          "name": "s-null",
+          "transport": {
+            "kind": "http",
+            "url": "https://a.example"
+          },
+          "toolFaces": null
+        },
+        {
+          "name": "s-array",
+          "transport": {
+            "kind": "http",
+            "url": "https://b.example"
+          },
+          "toolFaces": [
+            1,
+            2
+          ]
+        },
+        {
+          "name": "s-string",
+          "transport": {
+            "kind": "http",
+            "url": "https://c.example"
+          },
+          "toolFaces": "not-an-object"
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/cc01-mcp-toolfaces-non-object/meta.json

@@ -0,0 +1,8 @@
+{
+  "contributor": "client-core",
+  "claim": "client-core ①:`mcp[].toolFaces` 是**解析透明**键(z.unknown)。喂它数组 / null / 串 ⇒ 四读腿要么逐字同形透传、要么同形丢键,**不许一腿丢一腿留**。真读数 = 三形全部逐字透传(含 null),形归引擎校验。",
+  "firstRedOn": [
+    "settings-schema@1.0.0",
+    "settings-schema@1.5.0"
+  ]
+}

package/conformance/cases/cc02-mcp-source-key-is-transported/expected.json

@@ -0,0 +1,85 @@
+{
+  "domains": {
+    "outcome": "effective",
+    "effective": {
+      "collab": {
+        "templates": []
+      },
+      "entitlement": {
+        "budgetGroups": [],
+        "groupBindings": [],
+        "subjects": [],
+        "tiers": []
+      },
+      "execution": {
+        "allowedLanes": [
+          "host"
+        ],
+        "required": false
+      },
+      "governance": {},
+      "hosts": {
+        "hosts": []
+      },
+      "limits": {},
+      "mcp": {
+        "servers": [
+          {
+            "elicitation": false,
+            "enabled": true,
+            "name": "s1",
+            "rosters": [],
+            "scenarios": [],
+            "source": "plugin",
+            "transport": {
+              "kind": "http",
+              "url": "https://x.example"
+            }
+          }
+        ]
+      },
+      "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": 2482576595667034
+  }
+}

package/conformance/cases/cc02-mcp-source-key-is-transported/input.json

@@ -0,0 +1,20 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "mcp": {
+      "servers": [
+        {
+          "name": "s1",
+          "transport": {
+            "kind": "http",
+            "url": "https://x.example"
+          },
+          "source": "plugin"
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/cc02-mcp-source-key-is-transported/meta.json

@@ -0,0 +1,8 @@
+{
+  "contributor": "client-core",
+  "claim": "client-core ②:提案说「`source` 是记账键,四读腿的 wire 产物都**不含**它」。**真读数推翻了这一半**:`source` 是 `z.unknown().optional()` 的解析透明键,三腿**都**逐字透传。本条把真相钉成金样 —— 消费方按「不含」去写投影,就会在 wire 上丢掉运维的分组标签。",
+  "firstRedOn": [
+    "settings-schema@1.0.0",
+    "settings-schema@1.5.0"
+  ]
+}

package/conformance/cases/cc03-model-compat-unknown-subkey/expected.json

@@ -0,0 +1,89 @@
+{
+  "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",
+            "compat": {
+              "thinkingFormat": "anthropic",
+              "zzz": 1
+            },
+            "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": [],
+    "metadata": {
+      "version": 7,
+      "updatedAt": "2026-09-16T00:00:00.000Z"
+    }
+  },
+  "wire": {
+    "derive": true
+  },
+  "localRoot": {
+    "derive": true,
+    "localVersion": 4345724001787046
+  }
+}

package/conformance/cases/cc03-model-compat-unknown-subkey/input.json

@@ -0,0 +1,22 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "models": {
+      "models": [
+        {
+          "name": "m0",
+          "provider": "openai",
+          "id": "m0-id",
+          "apiKeyEnv": "OPENAI_API_KEY",
+          "compat": {
+            "thinkingFormat": "anthropic",
+            "zzz": 1
+          }
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/cc03-model-compat-unknown-subkey/meta.json

@@ -0,0 +1,8 @@
+{
+  "contributor": "client-core",
+  "claim": "client-core ③:`models[].compat` 带未知子键(`compat.zzz`)⇒ 四读腿**同形保留**而不是静默剥。那张词表随引擎走,本包复述一份必漂,所以这里是自由形 + 安全判据;任一腿把子键剥掉,引擎就少收一个 wire-compat 声明且零告警。",
+  "firstRedOn": [
+    "settings-schema@1.0.0",
+    "settings-schema@1.5.0"
+  ]
+}

package/conformance/cases/cli01-model-name-nfc-vs-nfd/expected.json

@@ -0,0 +1,102 @@
+{
+  "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": "ascii-ok-id",
+            "name": "ascii-ok",
+            "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",
+          0
+        ]
+      },
+      {
+        "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": 694685728514477
+  }
+}

package/conformance/cases/cli01-model-name-nfc-vs-nfd/input.json

@@ -0,0 +1,30 @@
+{
+  "meta": {
+    "version": 7,
+    "updatedAt": "2026-09-16T00:00:00.000Z"
+  },
+  "domains": {
+    "models": {
+      "models": [
+        {
+          "name": "café",
+          "provider": "openai",
+          "id": "café-id",
+          "apiKeyEnv": "OPENAI_API_KEY"
+        },
+        {
+          "name": "café",
+          "provider": "openai",
+          "id": "café-id",
+          "apiKeyEnv": "OPENAI_API_KEY"
+        },
+        {
+          "name": "ascii-ok",
+          "provider": "openai",
+          "id": "ascii-ok-id",
+          "apiKeyEnv": "OPENAI_API_KEY"
+        }
+      ]
+    }
+  }
+}

package/conformance/cases/cli01-model-name-nfc-vs-nfd/meta.json

@@ -0,0 +1,9 @@
+{
+  "contributor": "cli",
+  "claim": "壳视角①:两条 models[].name 只差 Unicode 规范化(NFC 的 é vs NFD 的 e+组合符)。**真读数与提案不同**:name 的字符集是 letters/digits/._-,两条都过不了条目校验,于是**两条都被逐条丢掉并各自点名下标** —— 读侧既不合并也不归一,壳的「渲两行同名」病在契约层就不成立。三腿必须丢同样两条。",
+  "firstRedOn": [
+    "settings-schema@1.0.0",
+    "settings-schema@1.10.0",
+    "settings-schema@1.5.0"
+  ]
+}