@james_sww/metaform-asset-distribution 0.1.6 → 0.1.7

package/README.md

@@ -160,3 +160,28 @@ metaform-assets prepare --plan /tmp/application-plan.json
 
 
 当前骨架安装到 `src/asset-internals/semantic-region/`，生成区域显式将其挂入 RegionSlot。模板自带 fallback 文件随 Code Base 交付，新模板的资产锁初始为空，不继承旧资产所有权。显式使用历史模板时仍保留其原摘要、基线及 templateAssetAliases 兼容记录。旧项目若涉及路径迁移仍返回 upgrade_requires_review，不自动转换其 lock。完整使用流程与来源分层见仓库根 README“从继承本体到独立应用”。
+
+## 沙箱项目入口（待发行 0.1.7）
+
+这是同一 `@james_sww/metaform-asset-distribution` 包的安装入口，不是另一套安装器。`build:project` 生成独立 Node ESM、版本摘要和第三方许可证，包含 proper-lockfile 的运行依赖；不含 TypeScript 编译器、业务源码、模板或完整 Registry。独立 Code Base 通过 `scripts/sync-asset-cli.mjs <产物目录>` 校验摘要并交付到 `tooling/metaform-assets.mjs`，随后 seal。当前线上固定快照不会自动升级。
+
+项目入口支持 `plan add`、`add`、`inspect/search`、`diff`、`doctor`、`reconcile` 和 `export`；不支持 init、prepare 或运行官方下载器。安装阶段使用宿主固定 pnpm，`--no-install` 只落源码和依赖声明，随后仍需安装依赖。MCP reference 改写无需安装，不伪造 CLI 基线。
+
+项目入口必须显式指定选定发行文件 `--registry`，不回退完整 Registry；可信宿主或维护端可用 `export <id#variant> --registry <发行文件> --json` 导出经过校验的所选源码闭包，再通过已授权文件通道交付。输出带自身摘要、`upstreamReleaseDigest`、原始文件摘要和源码提交信息；子集摘要不是上游签名，宿主仍须核对可信来源和预期摘要。新版 MCP 的 `resolve_assets({ids, includeInstallation:true})` 返回 `installation.status=available` 时，项目 CLI 可直接读取该响应 JSON（包括 MCP envelope）；仅 reference 或旧版无 installation 时明确拒绝。宿主未交付相应服务版本时不下载完整发行进项目。
+
+工程内 `.metaform-install` 存放事务、锁和留存备份；旧入口维持工程父目录事务布局。活动事务应先 `doctor --recover`，不可保存半安装结果；提交后源码、`assets.lock.json` 与 `.metaform/asset-baselines/<sha256>` 才是保存恢复基线。事务目录不进入源码摘要/快照，恢复到新沙箱后历史事务备份不保证存在。生成计划后若改变源码须重新计划；同版本重复采用保留已改写文件，升级及非托管文件冲突仍需审阅。
+
+
+### MCP 只读交付，由 Agent 执行
+
+`build:installation` 生成供独立 MCP 服务固定快照采用的轻量发行读取运行时，服务端保存固定完整发行并按请求返回选定闭包；完整发行不进入应用模板。服务快照刷新前先构建该运行时；当前 Registry/catalog 的 releaseDigest 必须一致，否则拒绝交付。
+
+Agent 调用 `resolve_assets({ ids: ["shadcn.resizable#new-york-v4"], includeInstallation: true })`，核对 `installation.status`、`format`、`expectedDigest` 和真实来源，使用工作区文件工具把完整响应暂存到 `.metaform-install/resolve-assets.json`。该目录不计入源码摘要，生成计划后保存计划不会使计划过期：
+
+```sh
+node tooling/metaform-assets.mjs plan add 'shadcn.resizable#new-york-v4' --registry .metaform-install/resolve-assets.json --expect-digest <installation.expectedDigest> --json > .metaform-install/adoption-plan.json
+node tooling/metaform-assets.mjs add --plan .metaform-install/adoption-plan.json
+node tooling/metaform-assets.mjs reconcile
+```
+
+MCP 不获取工程路径、不执行命令、不写沙箱，也不返回服务凭据。只有 Agent 的既有工作区/终端工具负责上述写入与执行。旧服务未提供安装数据时继续 reference 改写，不能把可读源码伪造为已安装。仅 `installation.release`、整个 resolve payload、标准 MCP structuredContent 或单一 text envelope 均可被新 CLI 读取；损坏摘要或 `isError=true` 立即拒绝。

package/codebase/codebase.json

@@ -1,20 +1,23 @@
 {
   "schemaVersion": 1,
   "name": "@james_sww/metaform-codebase-template",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "files": {
     "_gitignore": "184ad45835c68a6d3fd5100366678797c5fe4d2a2aa6548749039912376faf54",
     ".env.example": "602ae0c89a09593ef560b5d1f7010439e228c7fb0dd7bbc69c9655cf82a8944f",
-    "application.json": "832c19243f16e38c7a6e100e995675d995537ea0d53da7df9cc1b239782b3ca0",
+    ".metaform/component-sources.json": "a6ac14edf9a4934037a2af981632c03004f5fe16165e1b66b941097a655bfaa7",
+    ".metaform/ui-baseline.md": "03876cabc1173ea73e50bf2f1caeae5bd07a862c274684623db22aea516d4a4a",
+    "AGENTS.md": "00ed085ef38554349539ae95a18fc3be4cfcde6fd82428f80e5cf3edd4a7a786",
+    "application.json": "5634ccb730afab4eefe922207e294c87a9b40d2866626df7ffa342bdc57863a0",
     "assets.lock.json": "427bc853754c83bccc1baa0275170692c65b512c29978ce7d0407037b3409aed",
     "components.json": "bf8e563e20f684aad29b2b7671b3327effd62dc2cb3bd944fcd1ccb7d581217e",
     "eslint.config.js": "05a1c2fbaca8ec2c04985ca14e7da9ecf7b6722a5d9e27313e814de4b0393ccd",
     "examples/navigation.html": "d4c5f4f52acf12ead806253d2d2947819181e32debc3dbb3d6f8c166abdaada9",
     "index.html": "b0615e4fc6fdf82a768f44c818b3bf280897882ffc72c949c8a3ab5cd78ca37b",
-    "LICENSES/NOTICE.md": "dc2bd63b6bcdf6007dcc823ae145828ae0fc3ff2768950a2899e752c1016e0b2",
+    "LICENSES/NOTICE.md": "0420b594765366d53b78b09abb1bed8948d5a69fc1bfb279f5e4a6b5b5145c09",
     "package.json": "7b256b3982d5683f6279e75ee86280498b7ef444a4262158f8d622f77361f64f",
     "pnpm-lock.yaml": "46912c695ef4a2f351a7469aa26ab1312ccf6347b4d0aa2b075bf3a96632782b",
-    "README.md": "99790ff5b5de2d840c2fa8d70297f5adc92bb5e193729d792c4aa942b1eb3941",
+    "README.md": "e67553b3f2e309268bd77696c06000cc4368712898c61e0c72947c70b185d2c4",
     "role-targets.json": "37517e5f3dc66819f61f5a7bb8ace1921282415f10551d2defa5c3eb0985b570",
     "src/components/business/analytics/contribution-list.tsx": "5a9cd9e8eed906a08a09666c071653f1da278199102d50ace17b0b36773eae63",
     "src/components/business/analytics/index.ts": "c6ce4e0dc0d1ab759db4b0757ebc7e1a73a78750067d31f3933f3ad30dbe72b2",
@@ -24,8 +27,9 @@
     "src/components/business/README.md": "d1672330dce395e96ce89e9d0e5072fd78e036e755011ca42012811c5996ef63",
     "src/components/common/empty-state.tsx": "6008a3193b715c5453eee3dba6ee20608fca3e6cf8bba9af774ba898a1890fea",
     "src/components/common/error-boundary.tsx": "1fef1c92e27d8206448cb0e1840bfe81826a95fc58b1ec4c1e2f14462293bf5b",
-    "src/components/common/semantic-region/contract.ts": "92cd18a919b549b4827f611c3a4157652c4a6ae034850da1254ca422693c759d",
-    "src/components/common/semantic-region/semantic-region-scaffold.tsx": "062e024ed4f9a22464ff329ba38b7a27625a990970a77277ede92b66ff09d3ef",
+    "src/components/common/semantic-region/contract.ts": "d3cce12445e9d4fac47caff4fbbb32ffb92e3ebc20612bcdc82a6dba51135157",
+    "src/components/common/semantic-region/semantic-region-scaffold.css": "654f2d61bdaa93433ba0d68c186a4d36b7b7ffa0253a7826dd2e7030e043e4d9",
+    "src/components/common/semantic-region/semantic-region-scaffold.tsx": "d0c1c72dc29ac8b5bba9580cd77918c05f41d412b8fefb032a3c1fb94f093a97",
     "src/components/ui/alert.tsx": "9c380bb1703ba96fe873d5b3094153fa3402d305719e60aa733e4ab202ffddaa",
     "src/components/ui/avatar.tsx": "e9d4784c2ad5bceccdc4f2f19f367fdc37537a10e3f99f510e42c0226adfbf8f",
     "src/components/ui/badge.tsx": "bf9e1bbb252c1fa5da20a17eeee1ac163c7d3a0b6deff817d30ba04b766fb8a1",
@@ -48,38 +52,57 @@
     "src/components/ui/table.tsx": "602667b428501cd238f201b999191251a979d25da7c3dd349f63db5fb264f1c3",
     "src/components/ui/tabs.tsx": "e1df6e2f95ece373ca909c1d54b8ba8cf4c47dd425c1784bbb9a01c38dd0936b",
     "src/components/ui/tooltip.tsx": "5f56cd15afc07567f7b80b8b4d9e89da405e070a562583bbbc2414fd981af324",
-    "src/contexts/toast-context.tsx": "a3af91f8915d7753ef15888997ba941d07459d4df3e3e6d58e25365143bf336f",
+    "src/contexts/toast-context.tsx": "ffe5c04ffbde60dff7d60e58b85fbdfd8167f01e8da585f33355b0690b650469",
     "src/examples/component-examples.tsx": "71ffb083e0bff1e763ee4613f30107877c94f797a0c2f8e9714d9cbfb94e44fb",
-    "src/examples/navigation-example-data.ts": "31398d891f55f5a793ac77e10b327181466a7248132d398ac9b720885240567d",
-    "src/examples/navigation-example.tsx": "76eb9311078a8c62bcb2dc9ed3fc0c4675b246e581044a786b9a2b1ed004d5c9",
+    "src/examples/navigation-example-data.ts": "bcccaa5d44bbc6bc6f2934f690c3bf4ca072e17fc1a949fc5ff23b805e2cc28c",
+    "src/examples/navigation-example.tsx": "161c8561a461c52ff03af9826b21b623a1f45d2e954aafb1ccca433db8549ff2",
     "src/hooks/index.ts": "ddfe80f0fc8b0b49c0b31f27d9aadc4a54715b5ccee40996a205ecec36958b79",
-    "src/integrations/platform.ts": "6edb9755c91f6bf1f16815911739f64c4f45405948eaf0d7bbd5cd2fa939dbe9",
+    "src/integrations/application-access.tsx": "5c038949df5f7e20b60022415a33688376efaadae7990c28bfed1a313dd9f7f0",
+    "src/integrations/application-contract.ts": "db10a807c1864d096c85dbd875b56f02703bba84d31c8c617bda4bd215749d83",
+    "src/integrations/application-hooks.tsx": "bfdcd22189bd1802b40e4d4a4d966d977a33cf46c11ec908831f8706d75c744d",
+    "src/integrations/application-identity-state.ts": "003eda7c71b26630accb5d9f1107a8b202cae231769809ac3f27187bcc1dc5aa",
+    "src/integrations/application-identity.ts": "44a3339ddedb9457944d1fd57a218d8ab8befc403166f9d8e891ba8ae51fe2b7",
+    "src/integrations/application-navigation.ts": "ba7bb0bcdb38f69a8a0d9441173275df5c4f68783a01cd8cca1338c02ec6ad8f",
+    "src/integrations/application-provider.tsx": "55bf8e555ac827f02e84b5ad8ef7910fb9d6e5452ddbdf67bccea595aed09ca6",
+    "src/integrations/application-runtime.ts": "eb68b3511a9326d4ec428954d31bfecaefcc006e81d37e7db09ecd1707bf981c",
+    "src/integrations/application.ts": "148a618d41a9aef15bdb6d77c6046506140974fd04c900372d3f7371688f591b",
+    "src/integrations/capability-result.ts": "d892d6a0d2a8b529ee98bac4bbbcc5d3925d19ebf9d8b164272b5decb454b23f",
+    "src/integrations/platform-data-adapter.ts": "75ff97da0299157fb513ec789ca99498f20e2e29b02dbd5d575b5ee20dfc31ce",
+    "src/integrations/platform.ts": "59924678805e10fdb1bd64b5dcd26af928b2fd58bf3b0680ba78e2d94b281134",
     "src/layouts/legacy-role-workspace/README.md": "3020935ddc821bc07057b11f9063e3aaa882cbf92acd451b22563cf4952f4b48",
     "src/layouts/legacy-role-workspace/role-workspace-account.tsx": "1156add3b27e6c66e94852514480235277c42a66fd3a9bfc84f7f630c2ed8ac7",
     "src/layouts/legacy-role-workspace/role-workspace-icons.tsx": "4b8ea69ef28a9699c0c3b28e12590a7521f91aa1a4a3d618fc0778455d39cbcc",
     "src/layouts/legacy-role-workspace/role-workspace-routes.ts": "0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e",
     "src/layouts/legacy-role-workspace/role-workspace-shell.tsx": "375a44af5a3a5285c329e2f9ca6df1de446d181e0c8fef126f6efe88c68e67ff",
     "src/layouts/legacy-role-workspace/role-workspace-types.ts": "b9e31158082ce71a2b3bdb904d9462619e3690735e73e138b1ce57f8f036347f",
-    "src/layouts/role-workspace-account.tsx": "3d1a9a8a1f7ed83eaf3422d1497cac02b643fe1c470b5c5f357f3bd26c585a0f",
-    "src/layouts/role-workspace-icons.tsx": "4b8ea69ef28a9699c0c3b28e12590a7521f91aa1a4a3d618fc0778455d39cbcc",
-    "src/layouts/role-workspace-routes.ts": "0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e",
-    "src/layouts/role-workspace-shell.tsx": "b7b28831e0853f98075699171993f127b519c3bfedfc0a620d3a4d3d25f65aa1",
-    "src/layouts/role-workspace-types.ts": "e1aebd03abf747ef894acb89eac9cb1a6335fa906aa496cc37263884b6389bde",
-    "src/layouts/workspace-breadcrumbs.tsx": "b7aa06f871bc257893462237c19c834c176e7ec64e1dfb4aef5d08db78e9fca8",
-    "src/layouts/workspace-navigation-model.ts": "448e8521063168d29955e049d58aa22a53bc34e0d54bc5655566549ac526bb0d",
-    "src/layouts/workspace-navigation.tsx": "763fe03c06aed5136ec6861f6a7299e59af2167c203148b73da3d5144a67d075",
-    "src/lib/http-client.ts": "a284532dd0bcc18aaf444b92e883ec77750515c1ba01626d8fa96c3e540d2e37",
+    "src/layouts/role-workspace-account.tsx": "51ce4f8fd584f57d268e7684a082fe258fc99dcbc3f839f6408dc1be7b8b0662",
+    "src/layouts/role-workspace-icons.tsx": "3d4d4e7b15e79bc3cad765c4c3a1b1a7bae31fea65010e2d28fd1574ae45567f",
+    "src/layouts/role-workspace-routes.ts": "8b79a3434ecdc30e873c6abe8df4cd29f6ca61e874068ac00d3b284a62819fd5",
+    "src/layouts/role-workspace-shell.tsx": "5f5c988c22aee747a4132cccd02c6d51f34a6aac9874ffa17d276cf04145db5e",
+    "src/layouts/role-workspace-types.ts": "3d5d811d1c8c56878a8461567d75d39f7c9aaf482875e4a2beae9c875acb7cee",
+    "src/layouts/workspace-breadcrumbs.tsx": "13608af042ff7dc7402d72f638755faeb7a7380f189d0416c7a9242efd85989b",
+    "src/layouts/workspace-navigation-model.ts": "77afab22de0d8a3f3865fb2ba7b90b3b6066a38b002f126524bd9fb48c801e02",
+    "src/layouts/workspace-navigation.tsx": "ac4d4784a551c8bd9c9da94a3992e51e1529e366d9328a566b6c9acd8f46fe53",
+    "src/layouts/workspace-role-model.ts": "ec3dddd92c89b411ff5f6aecb22cc9dda60d71c63274a4bf4d609de52f81631e",
+    "src/layouts/workspace-role-switcher.tsx": "777429fc9a2a36f351e42ffef50d9dbd48801b63f75288aa7824715f7bf22015",
+    "src/layouts/workspace-sidebar-model.ts": "d701ec7568c6dfed87da6197a7b333b88660d714c3a805d80387d2f5bf4c9e8a",
+    "src/layouts/workspace-sidebar-resize.tsx": "c58efe066c72e693c8234200fbf85577a9c14409db8019a3d7fd51f1e6a7180b",
+    "src/lib/http-client.ts": "662f77f2c03bad639520675f24feac807d973ed0f924f59cc1188c8084019e10",
     "src/lib/utils.ts": "4acbc7165a8d54738ff62b51414e772c08fe78434e524e6d8770180d3ba2925f",
-    "src/main.tsx": "6fa2b2eb510ef94ca04b894c573a041419191f6896043f227eb160ab49bd6efa",
+    "src/main.tsx": "a1ba48b46062c21f5b7d9eef3dc59a3bb9980f401e3929da2c2ba9b4b1f79afc",
     "src/platform/region/region-boundary.tsx": "6cee0fc2482f2a41dcf7a475e39fb037bb591c892046df42862f5b1e39774c9d",
-    "src/platform/region/region-slot.tsx": "cfeae0da0ea3dda8d1614aea8dd6ce5acf6158895a1e66af63ac1ef42e3f5b4c",
+    "src/platform/region/region-slot.tsx": "b52f80c93b88fdd4336ac61c7ede226a25677632088a8c798c68c9ac9d0a6603",
     "src/styles/index.css": "72f8f255c56d117bab6f2aaa53ce5a37aa9b2d5d085b321b9fcb4b4b983e15eb",
     "src/styles/styles.css": "b48c73f51ff3e148f20ad2c9dbd2847235e4fdf1cdb304d5e2feec9c2febd65e",
     "src/styles/theme-tokens.css": "0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5",
-    "src/styles/workspace-shell.css": "7b24fe20ae54c58b27188e58445b694d6aace0867fb76aa548acf4052785a236",
-    "src/workspace/default-workspace.tsx": "977fbade436fb2bfaf71ebdc2a4a4772c8138e00015ea5fe3e3ed8080ab08dc2",
-    "src/workspace/routes.ts": "94275cc4d44abcfa672e7d56ac1abc7ecd9f5caf656aa54d3e3ef68eaa7e2085",
-    "tests/workspace-navigation.test.mjs": "72f059730874f9c91befcca675c8cde7e60681d40b218db84e6f55240e08bd93",
+    "src/styles/workspace-shell.css": "fb7e7c0935b0ade5977063f22c7299c7a76682f3baf5a2c56b48b10e1f6f936d",
+    "src/workspace/default-workspace.tsx": "55c246fe6dd422f75a23a5101e000262ed4c96f12444df2a534f92e73e6fcf18",
+    "src/workspace/routes.ts": "4621b654ded202b6eae2ee4a6700e113be8d2c5b59d031300d3f7fc3e13057cd",
+    "tests/application-identity.test.mjs": "e33118e7c4a5e8f28db7e386a7a03948b531a856ce11a7a2c3e26049f15babc3",
+    "tests/semantic-region.test.mjs": "4d14d4e95e1badf58a7001e94cac002cbe2bb85118fb538e66d67f1d00122141",
+    "tests/workspace-navigation.test.mjs": "7d651bf4e81194f1ae74bd3631235974bcffba2e3585c5898680b48a4206d354",
+    "tests/workspace-role-switcher.test.mjs": "b6a0f3d71775c07ee8561a5a977c2b5f7b648bc70d91d7368b2cbe2e623fddc1",
+    "tests/workspace-sidebar-resize.test.mjs": "938c8251e42850db270ceffeda603d5cc515cf7398206806c3f8a6d6a78bfe49",
     "tests/workspace.test.mjs": "daf930b4db33de45eeecf8431663540ecd54aa90c3ba3dd1e683b539cbb8bf5d",
     "tooling/contracts.d.ts": "9ce9d9ac8e59c11c89aa41881b6e8d6edfc84fb4da115970b9f4a2c1e7486ba8",
     "tooling/contracts.js": "8d539db86dd27573de87c494ae15d7f702d67f24300bce995c7e733619fff630",

package/codebase/template/.metaform/component-sources.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": 1,
+  "components": [
+    {
+      "id": "common.semantic-region-scaffold",
+      "version": "0.1.0",
+      "variant": "current",
+      "releaseDigest": "e3726aa633ae420070433575a374c5d06664e44bea93c2cdc86d96360418d1cb",
+      "license": "UNLICENSED",
+      "mode": "template-compatibility-copy",
+      "files": [
+        {
+          "sourcePath": "packages/asset-internals/src/semantic-region/semantic-region-scaffold.tsx",
+          "distributionPath": "src/asset-internals/semantic-region/semantic-region-scaffold.tsx",
+          "target": "src/components/common/semantic-region/semantic-region-scaffold.tsx",
+          "adaptedSha256": "d0c1c72dc29ac8b5bba9580cd77918c05f41d412b8fefb032a3c1fb94f093a97",
+          "distributionSha256": "4d9723aa16f86a1037270d6435854ddcc8a558eabab36f87bbd459c5e88b5e6f",
+          "upstreamSha256": "00bbb31309cdd36bb14c1abc769de8b37d1c6d429e8976120fcbb67a7b93969d"
+        },
+        {
+          "sourcePath": "packages/asset-internals/src/semantic-region/semantic-region-scaffold.css",
+          "distributionPath": "src/asset-internals/semantic-region/semantic-region-scaffold.css",
+          "target": "src/components/common/semantic-region/semantic-region-scaffold.css",
+          "adaptedSha256": "654f2d61bdaa93433ba0d68c186a4d36b7b7ffa0253a7826dd2e7030e043e4d9",
+          "distributionSha256": "8c075ff3ee92a2c372b9a93763a1182569cbf8be1988d067d4663abc081d9982",
+          "upstreamSha256": "8c075ff3ee92a2c372b9a93763a1182569cbf8be1988d067d4663abc081d9982"
+        }
+      ],
+      "adaptations": [
+        "仅适配模板中的相对导入路径，复用已逐字节核对的 UI、主题及契约依赖。",
+        "保留完整组件与 CSS；默认区域使用标准展示，旧外壳占位样式不覆盖新版组件。",
+        "模板使用紧凑布局，核心说明、能力与操作作为整体居中，标题保留左上对齐，插画使用右侧辅助列；移除宿主接入说明，固定字号与插画尺寸，窄屏隐藏装饰插画。"
+      ]
+    }
+  ]
+}

package/codebase/template/.metaform/ui-baseline.md

@@ -0,0 +1,31 @@
+# 当前应用 UI 源码索引
+
+先读此索引，再按任务读取相关文件及必要依赖；下列路径相对应用根目录。它是源码导航，不是 UI/UE 规范副本、运行配置或服务可用性证明。当前真实源码及导出优先；文件缺失或入口已变时定位实际实现，不补造同名接口。
+
+## 最短读取路径
+
+| 本次任务      | 优先读取                                                                                                                                                    | 需要确认                                             |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
+| 定位页面与装配   | `src/main.tsx`、`src/workspace/default-workspace.tsx`、`src/workspace/routes.ts`                                                                          | 当前入口、页面 target、provider 与装配位置                    |
+| 改一个关注项／区域 | 宿主附加的 `source.component`、`source.contract` 所指文件；必要时 `src/platform/region/region-slot.tsx` 与 `src/components/common/semantic-region/contract.ts`         | regionId、输入／事件、状态归属及替换边界；无附加上下文时从当前路由定位          |
+| 使用外壳及导航   | `src/integrations/application-access.tsx`、`src/layouts/role-workspace-shell.tsx`、`src/layouts/role-workspace-types.ts`                                  | 应用身份包装、model/state/commands/slots；业务内容进入现有承载区    |
+| 改菜单／角色入口  | `src/layouts/workspace-navigation-model.ts`、`src/layouts/workspace-role-model.ts`、`src/layouts/workspace-role-switcher.tsx`                             | 当前主题／任务与角色映射；预览角色不授予权限                           |
+| 改视觉／布局    | `src/styles/index.css`、`src/styles/styles.css`、`src/styles/theme-tokens.css`；涉及外壳再读 `src/styles/workspace-shell.css`                                    | 样式加载链、语义 token、已有角色映射和容器滚动                       |
+| 用基础 UI    | `src/components/ui/` 下本次实际用到的文件                                                                                                                         | 沿现有相对路径或已配置别名静态导入；Props、variant、尺寸以源码为准          |
+| 加空态／反馈    | `src/components/common/empty-state.tsx`、`src/components/ui/skeleton.tsx`、`src/components/ui/alert.tsx`；必要时 `src/contexts/toast-context.tsx`             | 复用已有 provider／Toaster 与反馈入口，不重复挂载                |
+| 接查询／命令／返回 | 先读 `src/integrations/application.ts` 公共导出，再按需读 `application-hooks.tsx`、`application-contract.ts`、`application-provider.tsx`、`application-navigation.ts` | 当前查询、命令回执、刷新、对象版本、导航与返回合同；文件均在同一 integrations 目录 |
+| 接身份／页面访问  | `src/integrations/application-access.tsx`、`src/integrations/application-identity.ts`、`application.json`                                                 | 实际 adapter、登录／退出和页面权限；配置存在不等于服务已绑定               |
+| 验证修改      | `package.json`、`tests/` 中相关测试及当前工具配置                                                                                                                    | 真实可用命令、改动覆盖范围与本轮预览版本                             |
+
+## 基础实现提示
+
+- 外壳由 Code Base 交付，沿 `ApplicationWorkspaceShell`／`RoleWorkspaceShell` 当前实现继续，不重做完整应用菜单。
+- 业务内容只在当前应用装配与区域实现中增加；模板 examples 和 business 示例组件不定义本应用业务。
+- 主题和组件运行效果由当前源码决定，不从旧规范复制 CSS、包路径或尺寸。更改控件前直接读对应组件。
+- 空、加载、错误、不可用、只读及业务完成分别处理；真实回执后再表达成功，不以默认 Mock 替代服务。
+
+## 验证入口与来源
+
+当前模板提供 `pnpm typecheck`、`pnpm lint`、`pnpm test`；执行前核对本项目 `package.json`，按范围选择，测试可直接运行相关 `tests/*.test.mjs` 文件。不默认 build，不假设存在 `lint:colors`。
+
+模板来源读取初始化器实际交付的 `.metaform/codebase.json`（若存在），资产来源读取现有 `assets.lock.json` 及 `.metaform/component-sources.json`；不伪造版本或摘要。项目入口、区域路径或命令变化时更新本索引，保留当前应用的人工补充。

package/codebase/template/AGENTS.md

@@ -0,0 +1,11 @@
+# 应用工程约定
+
+默认中文。首次打造或继续修改前，先读取 [.metaform/ui-baseline.md](.metaform/ui-baseline.md)，再按当前任务打开相关源码；不默认扫描整个工程。线上宿主未自动加载本文时，也应由打造 Skill 显式读取。
+
+- 当前应用本体、用户要求及区域契约决定业务，不从模板示例补业务功能。
+- 沿现有外壳、路由、基础 UI、主题与应用能力接口继续，保留人工修改及来源／锁文件。
+- UI/UE 通用规则由宿主加载的线上打造 Skill 提供；项目索引只记录当前实现入口，不复制整份规范。
+- 索引不保证文件或 API 永远存在；先核实真实导出再使用。修改入口、路径或验证命令时同步维护索引。
+- 优先局部类型检查、lint 和相关测试，不默认全量 build；未执行项如实说明。
+- 不默认提交、发布、部署或升级共享模板。
+

package/codebase/template/LICENSES/NOTICE.md

@@ -3,3 +3,5 @@
 角色工作空间、业务组件、设计系统主题来自 Metaform 内部资产库；适用仓库及企业现有授权，本模板不额外授予开源许可。资产原始路径、版本、摘要见 assets.lock.json 与 .metaform/asset-baselines/。
 
 React、Vite、Tailwind、Radix、Lucide 等通过 npm 安装，保留各包附带的许可证。官方 shadcn 组件适用其上游许可证；本工具不会把官方或手工源码登记为 Metaform 原始资产。
+
+随基础模板维护的 SemanticRegionScaffold 及配套样式，来源版本、发行摘要和相对导入适配记录见 `.metaform/component-sources.json`。

package/codebase/template/README.md

@@ -2,10 +2,12 @@
 
 使用 Node 24.18.0、pnpm 10.18.2。执行 `corepack pnpm install --frozen-lockfile`，然后 `corepack pnpm dev`。检查：`pnpm typecheck`、`pnpm lint`、`pnpm test`、`pnpm build`。
 
-源码、主题和配置属于应用，可以正常修改。默认包含四个固定工作空间入口与语义骨架；没有业务样例、登录实现或在线数据。进入 S7 前由本体初始化流程在 `role-targets.json` 声明角色入口，在 `src/features/<roleKey>/` 实现各角色专属功能，可共享 `src/components/`、`src/layouts/`。每个角色拥有自己的 HTML 和 React 入口，不使用运行时角色分派。一次 build 构建全部入口，共享同一应用配置与锁文件。
+源码、主题和配置属于应用，可以正常修改。默认包含五个固定工作空间入口与语义骨架；没有业务样例或在线数据；默认提供公共身份接入、统一登录入口与页面访问守卫。进入 S7 前由本体初始化流程在 `role-targets.json` 声明角色入口，在 `src/features/<roleKey>/` 实现各角色专属功能，可共享 `src/components/`、`src/layouts/`。每个角色拥有自己的 HTML 和 React 入口，不使用运行时角色分派。一次 build 构建全部入口，共享同一应用配置与锁文件。
 
 role-targets 每项含 `roleKey`、`entry`（如 `operator/index.html`）、`path`（如 `/operator/`）、`featuresRoot`（`src/features/operator`）。构建检测逐入口传递依赖，包括静态枚举的动态导入；角色私有代码必须放在其专属目录，不允许跨角色导入。它用于代码边界检查，业务数据权限由平台授权实现。
 
+右上角角色切换通过 `model.roleEntries: { id, label, href }[]` 与 `model.activeRoleId` 启用。`href` 使用各角色独立入口的应用内地址（如 `/operator/#/my-tasks`），选择后进行完整页面导航，保留各角色独立代码和页面层；菜单不导入其他角色的私有模块。未提供列表或当前角色不在列表时不显示切换器，只有一个角色时显示禁用的当前角色。角色名称和入口由当前应用提供，生产环境的可见列表由宿主授权上下文提供，切换控件不变更账号权限。模板不内置任何业务角色，可信预览宿主可提供全部角色入口供打造预览；未接身份服务的独立运行显示未配置状态，正文受访问守卫保护。
+
 `components.json` 与 `@/` alias 可直接用于官方 shadcn。建议使用 `metaform-assets official add accordion` 先在暂存目录执行并核对冲突；直接使用官方 CLI 修改后运行 `metaform-assets reconcile`。不要用 overwrite 替换已经修改的 Metaform Button，它包含平台特有 variants。
 
 基础能力通过打造前确认的设计接入 `src/integrations/platform.ts`，业务数据仍连接平台。不要把服务端凭据写进 Vite 环境变量或前端源码。
@@ -18,14 +20,73 @@ CLI 可直接在工程内执行 init/add/official add/doctor --recover；也可
 
 ## 通用多级导航
 
-`src/layouts/workspace-navigation.tsx` 导出 `WorkspaceNavigation` 与 `WorkspaceNavigationItem`，可在任意导航区域复用，不依赖工作空间的固定分组。每项使用唯一 `id`、`label`、`availability`，可选 `icon`、`count` 与递归的 `children`；空 `children` 视为末级。父级只展开／收起，末级通过 `onSelect(id)` 导航；`planned` 分支及其后代不可进入。
+`src/layouts/workspace-navigation.tsx` 导出 `WorkspaceNavigation` 与 `WorkspaceNavigationItem`，可在任意导航区域复用，不依赖工作空间的固定分组。每项使用唯一 `id`、`label`、`availability`，可选 `icon`、`count` 与递归的 `children`；空 `children` 视为末级。普通父级只展开／收起；`overview: true` 的父级有独立汇总页面，主按钮导航、独立箭头展开／收起。末级通过 `onSelect(id)` 导航；`planned` 分支及其后代不可进入。
 
 传入 `items`、`activeId`、`onSelect` 即可使用。默认同级互斥展开：打开一个分组会收起其兄弟分组，祖先保持展开；切换末级或异步加载菜单时自动展开对应祖先。传入 `multiple` 可允许同级多开；可通过 `expandedIds`、`onExpandedIdsChange` 接管展开状态。受控模式下，展开状态由消费者提供，切换路由时也由消费者更新。`collapsed` 模式使用图标入口与多级浮出菜单。
 
-现阶段 `RoleWorkspaceShell` 仍将 `model.themes` 的扩展菜单放在“协作空间”之后，旧单层数据无需修改。扩展项及其后代的 ID 不与四个固定入口重复；通过 `state.expandedThemeIds` 与 `commands.onExpandedThemeIdsChange` 可统一控制桌面和手机菜单的展开状态；`model.navigationMultiple` 可显式启用同级多开。模板不预置业务树，具体菜单由当前应用提供。
+侧栏菜单顺序为“价值全景”“我的价值”“待办事项”“企业任务总览”“我的任务”；角色主题与任务统一放在最后的“我的任务”下面。`RoleWorkspaceShell` 将 `model.themes` 的业务主题统一收在“我的任务”下；消费者只传主题，不重复添加总入口。“我的任务”固定目标为 `my-tasks`，默认使用与其他固定入口一致的 `RegionSlot` 待打造骨架，保留区域定义与打造入口，不填模拟数量或业务数据。扩展项及其后代的 ID 不与五个固定入口重复；通过 `state.expandedThemeIds` 与 `commands.onExpandedThemeIdsChange` 可统一控制桌面和手机菜单的展开状态；`model.navigationMultiple` 可显式启用同级多开。模板不预置业务树，具体菜单由当前应用提供。展开菜单使用连接线表达层级，只有最外层入口保留图标，子菜单不展示图标或前置圆点；当前任务使用浅色底、左侧选中条和右侧状态点，普通分组保留展开箭头。
 
-开发时打开 `/examples/navigation.html` 可测试内置示例：协作空间下方的三级业务树、数量角标、禁用项、末级切换、收起后的浮出菜单和手机主题菜单。示例数据位于 `src/examples/navigation-example-data.ts`，使用 `example-` 前缀，与默认工作空间隔离；该 HTML 不在默认生产构建入口中。
+开发时打开 `/examples/navigation.html` 可测试内置示例：工作台“我的任务”下的三级业务树、数量角标、禁用项、末级切换、收起后的浮出菜单和手机主题菜单。示例数据位于 `src/examples/navigation-example-data.ts`，使用 `example-` 前缀，与默认工作空间隔离；该 HTML 不在默认生产构建入口中。
 
 主内容区顶部默认显示通用面包屑：固定入口显示其名称，扩展入口按菜单树展示完整祖先路径，随 `activeThemeId` 更新。有独立页面的菜单节点可提供 `href`，面包屑上级显示为可返回的链接；没有页面地址的祖先显示为带“分组”标识的文字，待开放路径不可返回。当前页始终是不可点击的高亮文字。“工作空间”根入口返回固定的价值全景。传入 `slots.breadcrumbs` 可完全替换；显式传 `null` 可隐藏；未知路由不生成路径。`WorkspaceBreadcrumbs` 也可独立接收 `{ id, label, href?, disabled? }[]` 展示其他页面路径。
 
-面包屑位于正文 `main` 上方的独立导航条，与正文分别成块；`slots.breadcrumbs` 的替换和隐藏规则不变。菜单 `href` 只为面包屑提供真实上级页面地址，父菜单点击仍只展开／收起。示例中的“我的任务”可返回示例总览，“检验准备”仅分组，末级仅显示当前状态。
+面包屑位于正文 `main` 上方的独立导航条，与正文分别成块；`slots.breadcrumbs` 的替换和隐藏规则不变。菜单 `href` 为面包屑提供真实上级页面地址；有独立页面的父级须显式声明 `overview`。只有当前页面菜单高亮，展开或包含当前项不会使其它菜单保持选中。示例中的“我的任务”可返回示例总览，“检验准备”仅分组，末级仅显示当前状态。
+
+## 菜单与正文分栏
+
+桌面侧栏右边缘可拖动调整菜单宽度，默认224px，范围200–420px，并按容器宽度为正文保留至少360px（另计32px间距）。手柄支持左右方向键每次16px、Home最小、End最大；折叠后保留展开宽度，窄屏继续使用抽屉菜单。
+
+默认宽度由外壳在当前入口内维护，不写浏览器存储。消费者可通过 `state.sidebarWidth` 与 `commands.onSidebarWidthChange(width)` 接管；回调返回按当前容器约束后的像素宽度。容器缩窄时展示宽度会收紧，再次放宽时可恢复原请求宽度。模板使用局部ResizeObserver和Pointer Capture，不添加全局拖动监听。
+
+
+## 公共登录、身份和页面访问
+
+`src/main.tsx` 默认调用 `createDefaultApplicationAdapters({ config: application.identity })` 并注入 `ApplicationProvider`。默认工作空间使用 `ApplicationWorkspaceShell`，自动读取共享身份、绑定账户登录/退出命令、过滤角色入口并守卫正文。生成业务页面时复用这些公共能力，不复制用户表、密码校验、JWT 或凭据存储。
+
+`application.json` 的 `identity` 默认为 `null`，界面明确显示身份服务未配置。独立部署时显式配置同源接入：
+
+```json
+{
+  "identity": {
+    "endpoint": "/api/application-identity",
+    "signInPath": "/auth/login",
+    "signOutPath": "/auth/logout"
+  }
+}
+```
+
+三个地址必须是以单个 `/` 开头的同源路径。`GET endpoint` 使用同源会话、禁止自动跟随登录重定向，返回以下公开快照；不配置企业、用户、应用授权来源或服务端密钥到前端：
+
+```ts
+{
+  protocolVersion: 1,
+  session: { status: 'authenticated', user: { id: '真实用户标识', name: '姓名' } },
+  access: {
+    mode: 'runtime',
+    applicationId: '服务端确认的应用标识',
+    releaseId: '有效发布标识',
+    version: '权限配置版本',
+    pages: [{ id: '一级页面标识', name: '工作空间', path: '/my-tasks?previewRole=稳定角色路由键', roleKey: '稳定角色路由键' }],
+    permissions: ['已确认的精确操作编码'],
+    managementURL: 'https://auth.metaform.com.cn/metaform-applications'
+  },
+  csrfToken: '当前服务端会话的退出CSRF值'
+}
+```
+
+`access`、`managementURL` 均可省略；匿名、过期与不可用会话不使用随附授权。正式 `access` 必须有 `releaseId`，没有页面时拒绝访问。HTTP 401 视为会话过期，403 不授予应用访问。HTTP 不接受预览模式。服务端从可信部署配置确定应用绑定并核验每次页面和业务请求；前端快照与守卫只是访问体验的一部分。
+
+登录通过 `signInPath?return_to=<当前 pathname+search+hash>` 发起导航，服务端必须校验回跳白名单。退出立即清空本地身份，再向 `signOutPath` 提交 `POST` 表单 `csrf_token`，以兼容服务端的 303 / SSO 退出链路；HTTP 快照必须提供 `csrfToken`。独立部署必须由部署方已有的同源 BFF 提供身份与登录/退出入口，登记受信任的 OIDC 回调，并配置服务端会话；跨域反代不自动共享 Cookie。服务端负责 OIDC 登录、回调、会话、可见页面查询与 CSRF 校验，前端不持有 AoBase 访问令牌。
+
+平台宿主使用 `window.MetaFormApp.identity`，提供 `getContext()`、`signIn()`、`signOut()`；`getContext()` 返回同一 `ApplicationIdentityContext`（不包含 CSRF）。宿主存在但协议缺失时不会回退到 HTTP。只有可信宿主可提供 `mode: 'preview'`，外壳显示角色预览提示；URL 的 `previewRole` 本身不授予身份或业务权限。
+
+业务组件可从具体模块导入 `useApplicationSession`、`useApplicationAccess`、`useApplicationAuth`（`application-hooks.tsx`），以及 `ApplicationAccessGuard`、`ApplicationSignIn`、`ApplicationWorkspaceShell`（`application-access.tsx`）。外部消费者也可使用 `application.ts` 的统一导出。
+
+- 会话与页面 hooks 的 `state` 使用现有能力结果；多处订阅共享一次快照与在途请求。`useApplicationAuth()` 提供 `session`、`access`、`command`、`signIn()`、`signOut()`、`refresh()`。
+- `ApplicationAccessGuard` / `ApplicationWorkspaceShell` 支持 `pagePath`、`roleKey`。`pagePath` 是服务端一级页面的完整 canonical 路径（含查询参数），任务深链接传所属一级页面路径；未传时使用当前 `window.location.pathname`。正式访问须同时匹配路径及传入角色键，不能依据 `previewRole` 推断权限。
+- `ApplicationWorkspaceShell` 保留原外壳 props 与插槽，自动使用真实会话和账户命令；角色入口按服务端 `pages[].roleKey` 与应用 `roleEntries[].id` 求交，保留应用提供的内部 HTML 地址；管理入口只在服务端返回 `managementURL` 时显示。
+- `checkAction` 只精确匹配服务端 `permissions`；缺少权限数据及未知操作默认拒绝。业务服务仍执行原有细粒度鉴权。
+- 外壳导航变化、显式 `refresh()` / hooks 的 `reload()` 和已识别的业务 401/403 拒绝会使共享快照失效；刷新中立即清理旧页面与旧用户展示。退出立即清空身份并锁存匿名状态，普通 `refresh()` / hooks 的 `reload()` 仍保持匿名；只有显式重新登录或完整重载应用后才解除锁存。退出及更新代际前的异步回执不能恢复旧身份。快照不会通过定时轮询保持实时，服务端必须继续逐请求鉴权。
+- 可在 `createDefaultApplicationAdapters({ config, adapters })` 显式注入其他身份适配器；`adapters.identity` 优先覆盖默认实现。公共 Provider 接口继续支持独立显式注入。
+
+本轮交付仅包含模板公共能力与平台打造前端接线。打造宿主读取既有 `/api/v1/session` 和项目应用列表，提供可信预览身份；不从企业 capabilities 推导业务 permissions。`workspacePages` 仅是生成元数据，不能据此认定发布服务已同步逻辑页面目录。平台正式运行 SDK 身份接线、AoBase 页面查询、服务端页面/动作鉴权整合及发布目录 overlay 已撤回，本轮未交付。独立 HTTP 示例须由部署方已有认证接入服务实现，不表示本轮新增 BFF 路由；旧应用不会自动更新模板接线。本轮未做真实独立部署或线上登录联调。

package/codebase/template/application.json

@@ -1,7 +1,8 @@
 {
   "schemaVersion": 1,
   "name": "metaform-application",
-  "templateVersion": "0.1.0",
+  "templateVersion": "0.1.4",
   "roleTargets": "role-targets.json",
-  "integrationDesign": null
+  "integrationDesign": null,
+  "identity": null
 }

package/codebase/template/src/components/common/semantic-region/contract.ts

@@ -124,7 +124,8 @@ export function validateSemanticRegion(value: unknown): {
     });
   }
   const r = object(value, '');
-  for (const key of ['id', 'pageId', 'title', 'responsibility']) text(r[key], key);
+  for (const key of ['id', 'pageId', 'title']) text(r[key], key);
+  if (typeof r.responsibility !== 'string') issue('responsibility', '需要文字，可为空');
   if (typeof r.id === 'string' && !/^[a-z][a-z0-9-]*$/.test(r.id)) issue('id', '区域标识无效');
   for (const key of ['inputs', 'outputs', 'businessStates', 'navigation']) strings(r[key], key);
   array(r.sourceRefs, 'sourceRefs').forEach((x, i) => {
@@ -150,7 +151,7 @@ export function validateSemanticRegion(value: unknown): {
   const replacement = object(r.replacement, 'replacement');
   strings(replacement.inputs, 'replacement.inputs');
   strings(replacement.events, 'replacement.events');
-  text(replacement.stateOwner, 'replacement.stateOwner');
+  if (typeof replacement.stateOwner !== 'string') issue('replacement.stateOwner', '需要文字，可为空');
   rows(r.questions, 'questions', (q, p) => {
     text(q.question, p + '.question');
     choice(q.status, p + '.status', ['pending', 'confirmed', 'deferred']);

package/codebase/template/src/components/common/semantic-region/semantic-region-scaffold.css

@@ -0,0 +1,88 @@
+.semantic-scaffold {
+  --scaffold-blue: var(--data-blue);
+  --scaffold-violet: var(--data-violet);
+  position: relative;
+  isolation: isolate;
+  container-type: inline-size;
+  width: 100%;
+  min-width: 0;
+  overflow: hidden;
+  border: 1px solid transparent;
+  border-radius: 14px;
+  background:
+    linear-gradient(145deg, color-mix(in srgb, var(--card) 97%, var(--scaffold-blue)), var(--card) 55%, color-mix(in srgb, var(--card) 94%, var(--scaffold-violet))) padding-box,
+    linear-gradient(125deg, color-mix(in srgb, var(--scaffold-blue) 55%, var(--card)), var(--scaffold-blue) 45%, var(--scaffold-violet) 80%, var(--scaffold-blue)) border-box;
+  box-shadow: 0 12px 38px -18px color-mix(in srgb, var(--scaffold-blue) 36%, transparent);
+  color: var(--foreground);
+  text-align: left;
+}
+.semantic-scaffold::before {
+  content: '';
+  position: absolute;
+  inset: 0;
+  z-index: -1;
+  pointer-events: none;
+  background-image: radial-gradient(circle, color-mix(in srgb, var(--scaffold-blue) 12%, transparent) .8px, transparent .9px);
+  background-size: 19px 19px;
+  mask-image: linear-gradient(transparent, black 30%);
+}
+.semantic-scaffold::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  z-index: -1;
+  pointer-events: none;
+  background:
+    radial-gradient(ellipse 42% 50% at 0% 100%, color-mix(in srgb, var(--scaffold-violet) 9%, transparent) 0 70%, transparent 71%),
+    radial-gradient(ellipse 34% 40% at 105% 105%, color-mix(in srgb, var(--scaffold-blue) 7%, transparent) 0 70%, transparent 71%),
+    radial-gradient(ellipse 40% 40% at 100% 0%, color-mix(in srgb, var(--scaffold-violet) 4%, transparent) 0 70%, transparent 71%);
+}
+.semantic-scaffold-header { display: flex; align-items: flex-start; justify-content: space-between; flex-wrap: wrap; gap: 16px; padding: 20px 24px; }
+.semantic-scaffold-heading { display: flex; align-items: flex-start; gap: 12px; min-width: 0; flex: 1 1 360px; }
+.semantic-scaffold-icon { display: grid; place-items: center; flex: 0 0 40px; width: 40px; height: 40px; border: 1px solid color-mix(in srgb, var(--scaffold-blue) 17%, transparent); border-radius: 12px; background: linear-gradient(140deg, var(--card), color-mix(in srgb, var(--scaffold-blue) 7%, var(--card))); box-shadow: 0 3px 10px color-mix(in srgb, var(--scaffold-blue) 8%, transparent); color: var(--scaffold-blue); }
+.semantic-scaffold-icon svg { width: 22px; height: 22px; stroke-width: 1.5; fill: color-mix(in srgb, var(--scaffold-blue) 14%, transparent); }
+.semantic-scaffold-intro { min-width: 0; }
+.semantic-scaffold-title-row { display: flex; flex-wrap: wrap; align-items: center; gap: 12px; }
+.semantic-scaffold-title-row h2 { margin: 0; font-size: 18px; font-weight: 650; letter-spacing: -.025em; line-height: 1.35; overflow-wrap: anywhere; }
+.semantic-scaffold-intro p { margin: 6px 0 0; max-width: 64ch; color: var(--muted-foreground); font-size: 14px; line-height: 1.8; overflow-wrap: anywhere; }
+.semantic-scaffold .semantic-scaffold-badge { padding: 5px 11px; gap: 6px; border-radius: 100px; border-color: color-mix(in srgb, var(--scaffold-blue) 13%, transparent); background: color-mix(in srgb, var(--scaffold-blue) 8%, var(--card)); color: var(--scaffold-blue); font-size: 12px; font-weight: 600; }
+.semantic-scaffold-badge svg { width: 12px; height: 12px; }
+.semantic-scaffold .semantic-scaffold-definition { height: 38px; gap: 7px; border-radius: 100px; border-color: color-mix(in srgb, var(--scaffold-blue) 12%, var(--border)); background: color-mix(in srgb, var(--card) 75%, transparent); color: var(--muted-foreground); padding: 0 14px; font-size: 12px; box-shadow: 0 2px 5px color-mix(in srgb, var(--scaffold-blue) 4%, transparent); }
+.semantic-scaffold-definition svg { width: 15px; height: 15px; }
+.semantic-scaffold-definition[aria-expanded='true'] svg:last-child { transform: rotate(90deg); }
+.semantic-scaffold-main { display: grid; grid-template-columns: 120px minmax(0, 1fr) 120px; align-items: start; justify-items: center; gap: 10px 24px; width: 100%; padding: 0 24px 24px; text-align: center; }
+.semantic-scaffold-main > :not(.semantic-scaffold-art) { grid-column: 2; }
+.semantic-scaffold-art { display: block; grid-column: 3; grid-row: 1 / span 4; align-self: center; justify-self: end; width: 120px; max-width: 100%; height: auto; margin: 0; }
+.semantic-scaffold-main h3 { margin: 0; font-size: 16px; font-weight: 650; line-height: 1.5; letter-spacing: -.02em; }
+.semantic-scaffold-expectation { margin: 0; max-width: 60ch; font-size: 13px; line-height: 1.8; color: var(--muted-foreground); overflow-wrap: anywhere; }
+.semantic-scaffold-features { display: flex; justify-content: center; flex-wrap: wrap; gap: 8px; list-style: none; margin: 4px 0; padding: 0; }
+.semantic-scaffold-features li { display: flex; align-items: center; gap: 8px; min-width: 0; max-width: 100%; padding: 6px 10px; border: 1px solid color-mix(in srgb, var(--scaffold-blue) 11%, var(--border)); border-radius: 100px; background: color-mix(in srgb, var(--card) 78%, transparent); color: var(--muted-foreground); font-size: 12px; font-weight: 500; box-shadow: 0 2px 4px color-mix(in srgb, var(--scaffold-blue) 3%, transparent); }
+.semantic-scaffold-features li svg { flex-shrink: 0; width: 18px; height: 18px; color: var(--scaffold-violet); }
+.semantic-scaffold-features li span { overflow-wrap: anywhere; }
+.semantic-scaffold-authoring { max-width: 100%; }
+.semantic-scaffold .semantic-scaffold-start { min-height: 36px; height: auto; max-width: 100%; padding: 8px 16px; gap: 9px; border: 1px solid color-mix(in srgb, var(--card) 45%, transparent); border-radius: 10px; background: linear-gradient(110deg, var(--scaffold-violet), var(--scaffold-blue) 75%); color: var(--brand-accent-foreground); font-size: 13px; font-weight: 600; white-space: normal; box-shadow: 0 5px 15px color-mix(in srgb, var(--scaffold-blue) 24%, transparent), inset 0 1px 0 color-mix(in srgb, var(--card) 22%, transparent); transition: filter .15s, box-shadow .15s; }
+.semantic-scaffold .semantic-scaffold-start:hover:enabled { filter: brightness(1.08); box-shadow: 0 6px 20px color-mix(in srgb, var(--scaffold-blue) 32%, transparent); }
+.semantic-scaffold-start svg { width: 19px; height: 19px; flex-shrink: 0; }
+.semantic-scaffold-definition-sheet { width: 100%; max-width: 560px; overflow-y: auto; }
+.semantic-scaffold-details { border-top: 1px solid var(--border); background: var(--card); padding: 24px; font-size: 13px; line-height: 1.7; overflow-wrap: anywhere; }
+.semantic-scaffold-definition-sheet [data-action-id] { white-space: normal; height: auto; min-height: 36px; }
+.semantic-scaffold[data-compact] .semantic-scaffold-art { width: 120px; }
+.semantic-scaffold[data-compact] .semantic-scaffold-header { padding-bottom: 10px; }
+.semantic-scaffold[data-compact] .semantic-scaffold-main { padding-bottom: 24px; min-height: 0; }
+@container (max-width: 900px) {
+  .semantic-scaffold-main { display: flex; flex-direction: column; align-items: center; }
+  .semantic-scaffold-art { display: none; }
+}
+@container (max-width: 560px) {
+  .semantic-scaffold-header { gap: 14px; padding: 20px; }
+  .semantic-scaffold-heading { flex-basis: 100%; gap: 13px; }
+  .semantic-scaffold-icon { flex-basis: 40px; width: 40px; height: 40px; }
+  .semantic-scaffold-icon svg { width: 22px; height: 22px; }
+  .semantic-scaffold-intro p { font-size: 13px; }
+  .semantic-scaffold-definition { margin-left: auto; }
+  .semantic-scaffold-main { padding-inline: 20px; }
+  .semantic-scaffold-art { display: none; }
+  .semantic-scaffold-features { margin: 4px 0; }
+  .semantic-scaffold-features li { font-size: 12px; padding: 7px 10px; }
+}
+@media (prefers-reduced-motion: reduce) { .semantic-scaffold .semantic-scaffold-start { transition: none; } }