@james_sww/metaform-asset-distribution 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,117 @@
-# Temporary Holding Version
+# Metaform 源码资产分发（P1）
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+这个包提供源码资产 CLI，并携带独立 `@james_sww/metaform-codebase-template` 的版本快照。基础模板唯一维护源已迁到桌面 `metaform-codebase/`，包含 RoleWorkspaceShell、设计系统原语、完整主题与语义骨架。业务组件按需复制，源码归应用维护；生成工程不依赖 Metaform workspace 或该 CLI 才能运行。
+
+## npm 使用与沙箱接入
+
+发布版本使用 Node 24.18.0、pnpm 10.18.2。CLI 自带固定版本模板与源码 Registry，无需平台仓库或本机桌面目录。私有包需有下载权限；沙箱凭据由运行环境注入，不写入应用源码。
+
+```sh
+npm install -g @james_sww/metaform-asset-distribution@0.1.0
+metaform-assets init --project ./my-app
+cd my-app
+corepack pnpm install --frozen-lockfile
+```
+
+不安装全局工具也可运行：
+
+```sh
+npm exec --yes --package=@james_sww/metaform-asset-distribution@0.1.0 -- metaform-assets init --project ./my-app
+```
+
+Agent 根据应用本体和 skill 形成 `ApplicationDesign` JSON 后，在已初始化的应用目录执行：
+
+```sh
+metaform-assets search 岗位任务 --json
+metaform-assets inspect quality.role-task-groups --json
+metaform-assets plan prepare --design /path/to/application-design.json --json > /tmp/application-plan.json
+metaform-assets prepare --plan /tmp/application-plan.json
+corepack pnpm dev
+```
+
+CLI 负责按底稿确定性装配；读取线上本体并作语义转译由 Agent 完成。匹配组件安装为应用内源码，未匹配区域保留语义骨架。模板初始化、安装成功不代表真实业务数据已绑定或平台 S7 已自动接通。
+
+基础模板也单独按 `@james_sww/metaform-codebase-template@0.1.0` 分发，可安装到工具目录后用 `--codebase /path/to/node_modules/@james_sww/metaform-codebase-template` 指定。初始化底稿的完整类型随 CLI 发布在 `dist/application-design.d.ts`，语义区域类型在 `dist/generated/semantic-region-contract.d.ts`。固定 CLI、模板和 Registry 版本用于沙箱重放；初始化后的源码和基线存入项目快照。
+
+## 维护仓库
+
+在 frontend 目录使用 pnpm 10.18.2：
+
+```sh
+corepack pnpm --filter @james_sww/metaform-asset-distribution test
+corepack pnpm --filter @james_sww/metaform-asset-distribution typecheck
+corepack pnpm --filter @james_sww/metaform-asset-distribution build
+corepack pnpm --filter @james_sww/metaform-asset-distribution pack --pack-destination /tmp/metaform-cli
+corepack pnpm --filter @james_sww/metaform-asset-distribution test:standalone
+```
+
+pack 前从独立基础模板包生成 `codebase/` 快照，再生成 CLI 和资产发布快照。`codebase-source.json` 固定模板名称、版本及本地来源；可用 `METAFORM_CODEBASE_SOURCE` 指向其他包目录（包括已安装或解压的 npm 包）。修改模板后先在模板包运行 `npm run seal`。CLI 发行包不依赖桌面路径。`prepare:release` 只写本地 registry 目录，不发布在线服务。默认 Registry URL 是本机验收地址；正式托管前显式设置 `METAFORM_REGISTRY_BASE=https://...`。每个 release 目录以完整内容摘要命名；同摘要的条目、依赖 URL 和 Catalog 不可改写。更换部署 URL 时使用新的输出目录，不能覆盖已发布版本。
+
+`registry/<digest>/registry.json`、`r/*.json` 遵守 shadcn Registry schema；`release.json` 是 Metaform 的原始字节和来源 sidecar。schema 校验 fixture 来自 [官方 registry-item schema](https://ui.shadcn.com/schema/registry-item.json)，2026-10-17 固定入库。Catalog 分开保留 component 与 asset 两种粒度，候选不会自动变成推荐。可发现但不在首批源码范围内的条目显示 `installable: false`。
+
+当前可安装资产：role-workspace-shell、quality.role-task-overview、quality.role-task-groups、common.semantic-region-scaffold，以及真实传递依赖。不猜测任意资产或 npm 版本。所有直接、重导出、字面量动态 import 使用 AST 改写为应用内相对路径；UI aliases 由应用自由配置。未枚举动态 import、未知 npm 依赖、越界路径、软链接、同目标所有权冲突均拒绝。标准 Registry 本轮只接收 UTF-8；二进制资源明确报错。
+
+## 独立应用使用
+
+在仓库外安装生成的 tgz 后，可直接在应用目录内使用（--project 仍可用于操作其他目录）：
+
+```sh
+mkdir my-app
+cd my-app
+metaform-assets init
+corepack pnpm install --frozen-lockfile
+metaform-assets search 岗位任务 --json
+metaform-assets inspect quality.role-task-groups --json
+metaform-assets plan add quality.role-task-overview quality.role-task-groups --json > /tmp/metaform-assets-plan.json
+metaform-assets add --plan /tmp/metaform-assets-plan.json
+metaform-assets official add accordion
+metaform-assets reconcile
+metaform-assets diff
+metaform-assets doctor --recover
+```
+
+可用 `--registry /path/to/release.json` 或可信 HTTPS 地址替换内置快照，用 `--expect-digest` 固定已审核摘要。摘要只校验一致性，不代替分发身份认证；远端托管及鉴权由后续平台工作负责。CLI 默认输出可读 JSON，`--json` 输出紧凑 JSON。`inspect` 展示版本、契约来源、候选状态、依赖和实际可读源码（包括 Props 类型）。
+
+init 只接受空目录，验证模板清单并记录 `.metaform/codebase.json`，复制自带锁文件；支持 `--codebase /path/to/template-package`；然后在工程内运行 `corepack pnpm install --frozen-lockfile`。Node 24.18.0、pnpm 10.18.2。项目可直接 dev/typecheck/lint/test/build，官方 shadcn 通过 components.json 和 @/ alias 接入。默认包含四个固定框架入口及其语义骨架，没有业务角色、业务菜单、演示数据或在线调用；进入 S7 前由初始化流程根据本体底稿和首轮选型填写角色、页面和区域；S7 沿当前源码继续打造。
+
+同一应用一次 build 处理全部角色 HTML/React 入口，一份 package.json、pnpm-lock.yaml、application.json 和 dist。`src/features/<roleKey>/` 属于角色私有，公共 UI/layouts 可共享；构建审计静态与可枚举动态导入的传递模块图，输出 entry-map.json，禁止跨角色专属导入。边界按源码归属执行：不要将角色私有业务代码放进公共目录来规避检查。基础能力按照打造前确认的接入设计实现，P1 没有实现真实登录或数据授权。
+
+## 源码维护和恢复
+
+assets.lock.json 保存每个资产原始文件 SHA、版本及发布摘要，.metaform/asset-baselines/ 保存原始字节，必须一并进入 Git、工程下载和快照。重复加入同版本不会覆盖应用修改；不同来源占用已有路径、依赖版本不相容、需要升级的差异均产生冲突，没有自动 overwrite 或自动三方合并。基线缺失会明确失败。
+
+安装先核对计划与当前源码摘要，在临时工作目录准备源码和依赖结果；确认后只将实际变化的文件逐项写回原工程。工程根目录、未改源码、.git、已有 dist 不替换，终端 cwd 和无关文件句柄保持有效。文件变更带日志和原文件备份，初始化也使用同一机制。多文件更新不宣称是文件系统原子事务。
+
+依赖声明或锁文件变化、或依赖目录缺失时，才在安装完成后切换 node_modules；仅新增源码且依赖未变时保持现有依赖目录。安装失败不写回源码；中途异常只恢复本次触及文件与依赖，不回滚无关编辑。回滚清理本次创建且仍为空的目录，保留原有目录及外部新增内容，空目录初始化恢复后可以重试。目标文件已有外部新编辑时停止自动恢复并保留双方副本。工具锁带心跳，进程中断至少等 10 秒后可在工程内运行 doctor --recover。 `--no-install` 仅复制源码，保留已有依赖目录；新增 npm 依赖后须自行运行 pnpm install 更新锁文件。官方组件使用固定 shadcn 4.19.0 在暂存副本运行，不带 overwrite；如果修改了原有源码、主题或来源基线则拒绝提交。新增官方或手工文件标记 unverified，意为“没有 Metaform 上游基线”，不表示组件质量不合格。
+
+## 验收范围
+
+test:standalone 需要 Docker 和公共 npm/shadcn 网络，使用固定 Node 24.18.0 镜像。它在仓库外安装打包 CLI，验证默认工程、两个岗位任务资产、官方 Accordion、保留用户 Button 修改、双角色构建、动态跨角色拒绝及第二目录按锁文件冷重放。报告和逐命令日志保存在打印的临时路径；浏览器桌面、窄屏、键盘与动作由单独的浏览器验收记录补充。不会因为缺少外部环境把未验收当通过。
+
+P1 不改现有应用工作台，不包含线上沙箱、S7 执行器、项目快照、平台预览/发布和真实基础能力集成；这些由 P2–P5 实施。
+
+成功后仅保留本次触及源码文件的旧 inode 和快照，输出 retainedBackup，doctor 列出备份及 changedPaths。它不再是整工程备份。若外部进程在更晚时刻通过旧句柄写入已替换的文件，仍可从该文件备份找回；未修改文件的旧句柄继续指向活工程。node_modules 作为可由锁文件重建的缓存，不保留成功安装前的缓存副本。源码备份可由开发者确认后显式清理。
+
+## S7 前本地初始化
+
+打包 CLI 可全局安装后在任意独立应用目录使用，不需本维护仓库。Agent 先读取本体并完成双粒度检索、inspect 与选型，形成 ApplicationDesign JSON；CLI 消费底稿生成普通源码，不自行猜测业务映射。
+
+```sh
+metaform-assets init
+metaform-assets plan prepare --design /path/to/application-design.json --json > /tmp/application-plan.json
+metaform-assets prepare --plan /tmp/application-plan.json
+```
+
+底稿结构由 src/application-design.ts 定义，区域契约来自 layout 的唯一维护源；CLI 构建前生成纯契约快照，发布后只读取其本地模块。匹配区域指定固定 asset/version/exportName、JSON props 与已声明事件；其余使用 common.semantic-region-scaffold。当前生成页面按区域顺序装配，复杂布局与真实业务能力由后续打造实现。
+
+生成结果保留 docs/application-design.json、.metaform/application-baselines.json，以及原有 assets.lock.json／资产基线。相同底稿重复准备会保留用户已改文件；新底稿需变更已编辑源码时形成冲突。后续真实替换单独记录区域实现与源码摘要，初始底稿不冒充最终实现。
+
+本地闭环验收：corepack pnpm test:semantic-region。它使用打包 CLI 与 Node 24.18.0 容器，在仓库外验证全局命令安装、初始化、源码替换、修改保护和冷安装构建。未接入线上 S7、真实身份或业务数据。
+
+## 独立基础模板与固定入口
+
+仓库中的 `templates/role-workspace/` 已迁出，不再维护第二份模板源。资产库仍在原仓库；CLI 将匹配资产装进应用源码。模板初始化不需要 Registry；业务资产安装和应用准备使用 Registry。
+
+底稿支持 `roles[].workspaceRoutes`，将 `value-panorama`、`my-value`、`inbox`、`enterprise-tasks` 显式映射到当前角色的页面 ID，禁止跨角色映射。未映射入口由模板中的平台语义骨架承接；不将平台占位页面伪造为应用本体页面。映射页面不重复显示在扩展菜单，业务页面和区域保留原本体 ID。
+
+本地已验证模板拆分、源码资产装配和入口衔接；npm 发布状态以 Registry 为准，线上 S7 接入单独完成。已有桌面应用不会被强制覆盖，新模板需在新工程初始化或显式审阅升级。

package/codebase/codebase.json

@@ -0,0 +1,87 @@
+{
+  "schemaVersion": 1,
+  "name": "@james_sww/metaform-codebase-template",
+  "version": "0.1.0",
+  "files": {
+    "_gitignore": "184ad45835c68a6d3fd5100366678797c5fe4d2a2aa6548749039912376faf54",
+    ".env.example": "5c15c4f0187d52019398f42ced14c7e6d54211ddb554c2142c4b8a9d250573c0",
+    ".metaform/asset-baselines/0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e": "0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e",
+    ".metaform/asset-baselines/0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5": "0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5",
+    ".metaform/asset-baselines/3d1a9a8a1f7ed83eaf3422d1497cac02b643fe1c470b5c5f357f3bd26c585a0f": "3d1a9a8a1f7ed83eaf3422d1497cac02b643fe1c470b5c5f357f3bd26c585a0f",
+    ".metaform/asset-baselines/4acbc7165a8d54738ff62b51414e772c08fe78434e524e6d8770180d3ba2925f": "4acbc7165a8d54738ff62b51414e772c08fe78434e524e6d8770180d3ba2925f",
+    ".metaform/asset-baselines/4b8ea69ef28a9699c0c3b28e12590a7521f91aa1a4a3d618fc0778455d39cbcc": "4b8ea69ef28a9699c0c3b28e12590a7521f91aa1a4a3d618fc0778455d39cbcc",
+    ".metaform/asset-baselines/567f039384fb23a20a4cd5e1d4fda56255abda6fc04d80b36c4bb6f6c040691b": "567f039384fb23a20a4cd5e1d4fda56255abda6fc04d80b36c4bb6f6c040691b",
+    ".metaform/asset-baselines/5f56cd15afc07567f7b80b8b4d9e89da405e070a562583bbbc2414fd981af324": "5f56cd15afc07567f7b80b8b4d9e89da405e070a562583bbbc2414fd981af324",
+    ".metaform/asset-baselines/7b725132bcc0688429adae31cb0ba872421d87eab5ae118fab88292e2c6e3fd3": "7b725132bcc0688429adae31cb0ba872421d87eab5ae118fab88292e2c6e3fd3",
+    ".metaform/asset-baselines/89d01af0d566e2f42b4653d75be97356896ade09dbfb8de2865d941ade16b398": "89d01af0d566e2f42b4653d75be97356896ade09dbfb8de2865d941ade16b398",
+    ".metaform/asset-baselines/8d4794e5500b7f577ad5c5676d27a7796cdb32984b40ec41a25acbba17c7a425": "8d4794e5500b7f577ad5c5676d27a7796cdb32984b40ec41a25acbba17c7a425",
+    ".metaform/asset-baselines/92cd18a919b549b4827f611c3a4157652c4a6ae034850da1254ca422693c759d": "92cd18a919b549b4827f611c3a4157652c4a6ae034850da1254ca422693c759d",
+    ".metaform/asset-baselines/b48c73f51ff3e148f20ad2c9dbd2847235e4fdf1cdb304d5e2feec9c2febd65e": "b48c73f51ff3e148f20ad2c9dbd2847235e4fdf1cdb304d5e2feec9c2febd65e",
+    ".metaform/asset-baselines/b9e31158082ce71a2b3bdb904d9462619e3690735e73e138b1ce57f8f036347f": "b9e31158082ce71a2b3bdb904d9462619e3690735e73e138b1ce57f8f036347f",
+    ".metaform/asset-baselines/bcc48c05cd912dad5373242ff699cdbec032c8ebb2de45a9df5de79a6daec59c": "bcc48c05cd912dad5373242ff699cdbec032c8ebb2de45a9df5de79a6daec59c",
+    ".metaform/asset-baselines/bf9e1bbb252c1fa5da20a17eeee1ac163c7d3a0b6deff817d30ba04b766fb8a1": "bf9e1bbb252c1fa5da20a17eeee1ac163c7d3a0b6deff817d30ba04b766fb8a1",
+    ".metaform/asset-baselines/e9d4784c2ad5bceccdc4f2f19f367fdc37537a10e3f99f510e42c0226adfbf8f": "e9d4784c2ad5bceccdc4f2f19f367fdc37537a10e3f99f510e42c0226adfbf8f",
+    ".metaform/asset-baselines/f3ce568d1ede383d9cb0d11dcc2acb6ce7984cbef8e2db0feec310df76303ccd": "f3ce568d1ede383d9cb0d11dcc2acb6ce7984cbef8e2db0feec310df76303ccd",
+    ".metaform/asset-baselines/fc763d53079b51a789c1cfff23d40e00f844a9a093a2ad112f0ac68ab46fe080": "fc763d53079b51a789c1cfff23d40e00f844a9a093a2ad112f0ac68ab46fe080",
+    "application.json": "832c19243f16e38c7a6e100e995675d995537ea0d53da7df9cc1b239782b3ca0",
+    "assets.lock.json": "cad385719b1d3b2ccbb56343ca5305d862b813a1e0013d2c12c827423ca47db4",
+    "components.json": "bf8e563e20f684aad29b2b7671b3327effd62dc2cb3bd944fcd1ccb7d581217e",
+    "eslint.config.js": "05a1c2fbaca8ec2c04985ca14e7da9ecf7b6722a5d9e27313e814de4b0393ccd",
+    "index.html": "0c8ce9649128d2ebbe282b1eee040524b78896b9df13f3ca1481c3965f66b823",
+    "LICENSES/NOTICE.md": "dc2bd63b6bcdf6007dcc823ae145828ae0fc3ff2768950a2899e752c1016e0b2",
+    "package.json": "7b256b3982d5683f6279e75ee86280498b7ef444a4262158f8d622f77361f64f",
+    "pnpm-lock.yaml": "46912c695ef4a2f351a7469aa26ab1312ccf6347b4d0aa2b075bf3a96632782b",
+    "README.md": "d738a1bfbe9e9221f15e2bdcb46af9fae112afd0c1354bd9d45bdf3ae5205e38",
+    "role-targets.json": "37517e5f3dc66819f61f5a7bb8ace1921282415f10551d2defa5c3eb0985b570",
+    "src/components/common/error-boundary.tsx": "990d7a72a5634dc854f3acbe9b9d4aac8f13540ca0901be8dbc2f27d77a76f3e",
+    "src/components/common/semantic-region/contract.ts": "92cd18a919b549b4827f611c3a4157652c4a6ae034850da1254ca422693c759d",
+    "src/components/common/semantic-region/semantic-region-scaffold.tsx": "567f039384fb23a20a4cd5e1d4fda56255abda6fc04d80b36c4bb6f6c040691b",
+    "src/components/ui/alert.tsx": "d03dcae5cdb63c381c1144ca9a0c49ba0e46466967d7deb94662034042acb034",
+    "src/components/ui/avatar.tsx": "e9d4784c2ad5bceccdc4f2f19f367fdc37537a10e3f99f510e42c0226adfbf8f",
+    "src/components/ui/badge.tsx": "bf9e1bbb252c1fa5da20a17eeee1ac163c7d3a0b6deff817d30ba04b766fb8a1",
+    "src/components/ui/breadcrumb.tsx": "c75fcd3d9e8470188bc0dd4b27a2b26fff3ad42b9c9c534a953dc090ae2cba33",
+    "src/components/ui/button.tsx": "8d4794e5500b7f577ad5c5676d27a7796cdb32984b40ec41a25acbba17c7a425",
+    "src/components/ui/card.tsx": "8f7c5833342b8365a7df2c34350cffa15ddc3ec9a5475b2a8dd7110431aa7192",
+    "src/components/ui/checkbox.tsx": "ba0ac64064e2d8fa7299d53e9e84b9a4772fef8dd4cf6170c56d3030a1d69941",
+    "src/components/ui/collapsible.tsx": "f3ce568d1ede383d9cb0d11dcc2acb6ce7984cbef8e2db0feec310df76303ccd",
+    "src/components/ui/dialog.tsx": "dcd488cc5d713da215ce2037efd644f35904df755c70f31534706643db488514",
+    "src/components/ui/dropdown-menu.tsx": "7b725132bcc0688429adae31cb0ba872421d87eab5ae118fab88292e2c6e3fd3",
+    "src/components/ui/input.tsx": "6db36fff95daf78fdf73d00940a3608108146083a63e76f94a37ecc63048571d",
+    "src/components/ui/label.tsx": "344bde38b8531615dbf8e14af3895517c24d8ef6ce56ddeda7e2e6fe4b5d0c00",
+    "src/components/ui/progress.tsx": "cf5de49b1c6d9ba6753d1d2f62820c543935cf426b8af8b49b277cfda6cc2c5b",
+    "src/components/ui/radio-group.tsx": "38c810acd91e1ef4aa8a9c7ec8375b6e65c89ce3f2292dacebaf5176f1d4e394",
+    "src/components/ui/select.tsx": "9293fd75923693411cd443049fba313135014c4ad6997cfcde1e37693fc85b04",
+    "src/components/ui/separator.tsx": "ad7d5403fe337160e41dbf04147896e448ae3a747b8d06660d627d74d60021bc",
+    "src/components/ui/sheet.tsx": "fc763d53079b51a789c1cfff23d40e00f844a9a093a2ad112f0ac68ab46fe080",
+    "src/components/ui/skeleton.tsx": "89d01af0d566e2f42b4653d75be97356896ade09dbfb8de2865d941ade16b398",
+    "src/components/ui/switch.tsx": "743676f33f823ffa8008bbd5eb94cb68e227599447d60e132a202291a395f8e4",
+    "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/hooks/index.ts": "31e5708e471dbeb44413632535b8f846686de9be28c8ad18e2d930761de8b73b",
+    "src/integrations/platform.ts": "2deb59e0f2938342cb66600b7310da0a67f8754ed291330a18034e819b448c4e",
+    "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": "bcc48c05cd912dad5373242ff699cdbec032c8ebb2de45a9df5de79a6daec59c",
+    "src/layouts/role-workspace-types.ts": "b9e31158082ce71a2b3bdb904d9462619e3690735e73e138b1ce57f8f036347f",
+    "src/lib/http-client.ts": "da19f0a16d8be3672573346d59c7242aa87440fc8b97b68a35867291f4da6af7",
+    "src/lib/utils.ts": "4acbc7165a8d54738ff62b51414e772c08fe78434e524e6d8770180d3ba2925f",
+    "src/main.tsx": "60221d67b63e9e685f2669f8deea9e4e56d5f285ea248d399e87fa69134b191f",
+    "src/styles/index.css": "72f8f255c56d117bab6f2aaa53ce5a37aa9b2d5d085b321b9fcb4b4b983e15eb",
+    "src/styles/styles.css": "b48c73f51ff3e148f20ad2c9dbd2847235e4fdf1cdb304d5e2feec9c2febd65e",
+    "src/styles/theme-tokens.css": "0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5",
+    "src/workspace/default-workspace.tsx": "0239a9926ab2bc6aa6a0c4923a1af03d618bc245483b114c74b017a4a2051737",
+    "src/workspace/routes.ts": "94275cc4d44abcfa672e7d56ac1abc7ecd9f5caf656aa54d3e3ef68eaa7e2085",
+    "tests/workspace.test.mjs": "daf930b4db33de45eeecf8431663540ecd54aa90c3ba3dd1e683b539cbb8bf5d",
+    "tooling/contracts.d.ts": "9ce9d9ac8e59c11c89aa41881b6e8d6edfc84fb4da115970b9f4a2c1e7486ba8",
+    "tooling/contracts.js": "8d539db86dd27573de87c494ae15d7f702d67f24300bce995c7e733619fff630",
+    "tooling/role-inputs.d.mts": "eb0e0acbb70e5d2b4def558d2e768ae59a6eade0748f374b3219c7bbef923efb",
+    "tooling/role-inputs.mjs": "70080473372b7db8056166b9f8035f6e6997b0f36d8a040131a25f76423b17d0",
+    "tooling/validate.d.ts": "5a8da530567c8cefe820e94ee09ab2de1987fea87735531340c1e81299ed0ae4",
+    "tooling/validate.js": "b64d25b1c4ff78c6a9f2c6534b895b3c0b032df965cb1f010cf7436f8946240a",
+    "tsconfig.json": "77045d61127f797598d0cf6671b7465313b33c35744bd68bae2656bc8032e8bd",
+    "vite.config.ts": "30b4f3de7b6e97a6bb237853719c9c45098c5d6982ba90d940a63170fd162b33"
+  }
+}

package/codebase/template/.env.example

@@ -0,0 +1 @@
+# 在打造前完成基础能力接入设计后填写；默认不配置业务服务地址。

package/codebase/template/.metaform/asset-baselines/0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e

@@ -0,0 +1,13 @@
+/** 固定框架入口；URL 前缀、页面内容和权限由消费者负责。 */
+export const DEFAULT_WORKSPACE_ROUTES = [
+  { id: 'value-panorama', label: '价值全景', group: 'value' },
+  { id: 'my-value', label: '我的价值', group: 'value' },
+  { id: 'inbox', label: '待办事项', group: 'inbox' },
+  { id: 'enterprise-tasks', label: '企业任务总览', group: 'enterprise' },
+] as const;
+
+export type WorkspaceRouteId = (typeof DEFAULT_WORKSPACE_ROUTES)[number]['id'];
+
+export function isWorkspaceRouteId(id: string): id is WorkspaceRouteId {
+  return DEFAULT_WORKSPACE_ROUTES.some((route) => route.id === id);
+}

package/codebase/template/.metaform/asset-baselines/0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5

@@ -0,0 +1,373 @@
+/* Platform console's always-dark navigation, shared by light and dark modes. */
+[data-sidebar-theme='platform'] {
+  --sidebar-background: #17263c;
+  --sidebar-foreground: #aebed0;
+  --sidebar-border: #2e4055;
+  --sidebar-user-foreground: #fff;
+  --sidebar-avatar-background: #e4d9c9;
+  --sidebar-avatar-foreground: #7a6044;
+  --foreground: #fff;
+  --muted-foreground: #859bb2;
+  --control-hover: #263950;
+  --selection: #294c54;
+  --selection-foreground: #58d5bd;
+  --selection-border: #294c54;
+  --ring: #58d5bd;
+}
+
+/*
+ * Metaform theme source of truth.
+ *
+ * Palette tokens never change meaning. Theme role tokens are the only values
+ * overridden by a preset, so application code never depends on a brand hex.
+ */
+:root {
+  --radius: 0.5rem;
+
+  /* Fixed palette */
+  --palette-ink: oklch(21.01% 0.0318 264.66deg);
+  --palette-ink-hover: oklch(27.81% 0.0296 256.85deg);
+  --palette-ink-active: oklch(12.96% 0.0274 261.69deg);
+  --palette-cobalt: oklch(54.78% 0.1724 265.67deg);
+  --palette-cobalt-hover: oklch(47.44% 0.1459 265.64deg);
+  --palette-cobalt-active: oklch(39.72% 0.1074 262.56deg);
+  --palette-cyan: oklch(71.5% 0.143 215.22deg);
+  --palette-teal: oklch(49.5% 0.102 181.5deg);
+  --palette-teal-hover: oklch(43.5% 0.092 181.5deg);
+  --palette-teal-active: oklch(36% 0.075 181.5deg);
+  --palette-steel: oklch(48% 0.065 245deg);
+  --palette-steel-hover: oklch(41% 0.06 245deg);
+  --palette-steel-active: oklch(33% 0.052 245deg);
+  --palette-safety: oklch(66% 0.17 58deg);
+  --palette-safety-hover: oklch(57% 0.15 58deg);
+  --palette-safety-active: oklch(48% 0.13 58deg);
+  --palette-ocean: oklch(49% 0.11 210deg);
+  --palette-ocean-hover: oklch(42% 0.1 210deg);
+  --palette-ocean-active: oklch(35% 0.082 210deg);
+  --palette-white: oklch(98.5% 0.003 247.86deg);
+
+  /* Theme roles: neutral is the default preset. */
+  --theme-accent: var(--palette-ink);
+  --theme-accent-hover: var(--palette-ink-hover);
+  --theme-accent-active: var(--palette-ink-active);
+  --theme-accent-soft: oklch(96.83% 0.0069 247.9deg);
+  --theme-accent-border: oklch(86.9% 0.0198 252.89deg);
+  --theme-accent-foreground: var(--palette-white);
+
+  /* Auxiliary brand roles: every preset owns the complete family. */
+  --theme-support: var(--palette-cobalt);
+  --theme-support-strong: var(--palette-teal);
+  --theme-support-soft: oklch(96.5% 0.012 230deg);
+  --theme-display-gradient-start: var(--palette-cobalt-active);
+  --theme-display-gradient-highlight: var(--palette-cyan);
+  --theme-display-gradient-end: var(--palette-teal);
+
+  /* Stable semantic colors never follow the selected brand theme. */
+  --semantic-success: oklch(65.59% 0.1686 146.19deg);
+  --semantic-success-soft: oklch(96.3% 0.032 146.19deg);
+  --semantic-success-foreground: oklch(40.5% 0.115 146.19deg);
+  --semantic-warning: oklch(79.98% 0.1706 72.75deg);
+  --semantic-warning-soft: oklch(97.3% 0.035 72.75deg);
+  --semantic-warning-foreground: oklch(43% 0.12 72.75deg);
+  --semantic-danger: oklch(63.07% 0.201 25.03deg);
+  --semantic-danger-soft: oklch(95.8% 0.025 25.03deg);
+  --semantic-danger-foreground: oklch(44% 0.16 25.03deg);
+
+  /* Surfaces and content */
+  --surface-canvas: oklch(97.89% 0.0029 264.54deg);
+  --surface-panel: oklch(99.5% 0.002 247.86deg);
+  --surface-raised: oklch(100% 0.001 247.86deg);
+  --surface-muted: oklch(96.7% 0.004 264.54deg);
+  --surface-muted-foreground: var(--text-regular);
+  --text-primary: var(--palette-ink);
+  --text-regular: oklch(37.3% 0.034 259.73deg);
+  --text-secondary: oklch(55.44% 0.0407 257.42deg);
+
+  /* Navigation links stay blue independently of the selected brand theme. */
+  --link-foreground: var(--palette-cobalt);
+  --link-hover-foreground: var(--palette-cobalt-hover);
+  --border-base: oklch(92.88% 0.0126 255.51deg);
+  --border-soft: oklch(95.5% 0.008 255.51deg);
+  --border-input: oklch(84.5% 0.016 255.51deg);
+  --control-hover: var(--surface-muted);
+  --control-active: var(--selection);
+  --control-active-foreground: var(--selection-foreground);
+  --control-active-border: var(--selection-border);
+
+  /* shadcn focus ring: neutral gray, not brand accent */
+  --ring-muted: oklch(70.4% 0.04 256.79deg);
+
+  /* Application roles derived from the active theme preset. */
+  --brand-accent: var(--theme-accent);
+  --brand-accent-hover: var(--theme-accent-hover);
+  --brand-accent-active: var(--theme-accent-active);
+  --brand-accent-soft: var(--theme-accent-soft);
+  --brand-accent-border: var(--theme-accent-border);
+  --brand-accent-foreground: var(--theme-accent-foreground);
+  --brand-support: var(--theme-support);
+  --brand-support-strong: var(--theme-support-strong);
+  --brand-support-soft: var(--theme-support-soft);
+  --brand-gradient-start: var(--theme-display-gradient-start);
+  --brand-gradient-highlight: var(--theme-display-gradient-highlight);
+  --brand-gradient-end: var(--theme-display-gradient-end);
+  --action-primary: var(--theme-accent);
+  --action-primary-hover: var(--theme-accent-hover);
+  --action-primary-active: var(--theme-accent-active);
+  --action-primary-foreground: var(--theme-accent-foreground);
+  --selection: var(--theme-accent-soft);
+  --selection-foreground: var(--theme-accent);
+  --selection-border: var(--theme-accent-border);
+  --selection-strong: var(--theme-accent-active);
+  --focus-ring: var(--theme-accent);
+  --sidebar-background: var(--surface-panel);
+  --sidebar-foreground: var(--text-primary);
+  --sidebar-active: var(--selection);
+  --sidebar-active-foreground: var(--selection-foreground);
+  --sidebar-border: var(--border-base);
+
+  /* Data visualization colors are fixed and independent from branding. */
+  --data-blue: var(--palette-cobalt);
+  --data-cyan: var(--palette-cyan);
+  --data-violet: oklch(60.6% 0.196 286.48deg);
+  --data-green: var(--semantic-success);
+  --data-amber: var(--semantic-warning);
+  --data-red: var(--semantic-danger);
+  --data-business: var(--palette-teal);
+  --data-equipment: var(--semantic-danger);
+  --data-process: var(--semantic-warning);
+  --data-metric: var(--data-violet);
+  --data-strategy: var(--palette-cyan);
+  --data-business-soft: color-mix(in oklch, var(--data-business) 10%, var(--surface-panel));
+  --data-equipment-soft: color-mix(in oklch, var(--data-equipment) 10%, var(--surface-panel));
+  --data-process-soft: color-mix(in oklch, var(--data-process) 10%, var(--surface-panel));
+  --data-metric-soft: color-mix(in oklch, var(--data-metric) 10%, var(--surface-panel));
+  --data-strategy-soft: color-mix(in oklch, var(--data-strategy) 10%, var(--surface-panel));
+
+  /* Theme setting swatches */
+  --theme-swatch-neutral: var(--palette-ink);
+  --theme-swatch-cobalt: var(--palette-cobalt);
+  --theme-swatch-teal: var(--palette-teal);
+  --theme-swatch-steel: var(--palette-steel);
+  --theme-swatch-safety: var(--palette-safety);
+  --theme-swatch-ocean: var(--palette-ocean);
+
+  /* shadcn roles */
+  --background: var(--surface-canvas);
+  --foreground: var(--text-primary);
+  --card: var(--surface-panel);
+  --card-foreground: var(--text-primary);
+  --popover: var(--surface-raised);
+  --popover-foreground: var(--text-primary);
+  --primary: var(--action-primary);
+  --primary-foreground: var(--action-primary-foreground);
+  --secondary: var(--surface-muted);
+  --secondary-foreground: var(--surface-muted-foreground);
+  --muted: var(--surface-muted);
+  --muted-foreground: var(--text-secondary);
+  --accent: var(--selection);
+  --accent-foreground: var(--selection-foreground);
+  --destructive: var(--semantic-danger);
+  --destructive-foreground: var(--palette-white);
+  --border: var(--border-base);
+  --input: var(--border-input);
+  --ring: var(--brand-accent);
+
+  /* Legacy aliases. New code should use role tokens above. */
+  --el-color-primary: var(--theme-accent);
+  --el-color-primary-hover: var(--theme-accent-hover);
+  --el-color-primary-active: var(--theme-accent-active);
+  --el-color-primary-light-9: var(--theme-accent-soft);
+  --el-color-primary-light-7: var(--theme-accent-border);
+  --el-color-action: var(--action-primary);
+  --el-color-action-hover: var(--action-primary-hover);
+  --el-color-action-active: var(--action-primary-active);
+  --el-color-success: var(--semantic-success);
+  --el-color-success-light-9: var(--semantic-success-soft);
+  --el-color-warning: var(--semantic-warning);
+  --el-color-warning-light-9: var(--semantic-warning-soft);
+  --el-color-danger: var(--semantic-danger);
+  --el-color-danger-light-9: var(--semantic-danger-soft);
+  --el-bg-color: var(--surface-canvas);
+  --el-text-color-primary: var(--text-primary);
+  --el-text-color-regular: var(--text-regular);
+  --el-text-color-secondary: var(--text-secondary);
+  --el-border-color-base: var(--border-base);
+}
+
+:root[data-accent='cobalt'] {
+  --theme-accent: var(--palette-cobalt);
+  --theme-accent-hover: var(--palette-cobalt-hover);
+  --theme-accent-active: var(--palette-cobalt-active);
+  --theme-accent-soft: oklch(95.53% 0.0154 269.98deg);
+  --theme-accent-border: oklch(86.49% 0.0463 269.14deg);
+  --theme-accent-foreground: var(--palette-white);
+  --theme-support: var(--palette-cyan);
+  --theme-support-strong: var(--palette-teal);
+  --theme-support-soft: oklch(95.5% 0.025 215.22deg);
+  --theme-display-gradient-start: var(--palette-cobalt-active);
+  --theme-display-gradient-highlight: oklch(70% 0.13 265.67deg);
+  --theme-display-gradient-end: var(--palette-cobalt);
+}
+
+:root[data-accent='teal'] {
+  --theme-accent: var(--palette-teal);
+  --theme-accent-hover: var(--palette-teal-hover);
+  --theme-accent-active: var(--palette-teal-active);
+  --theme-accent-soft: oklch(96% 0.018 181.5deg);
+  --theme-accent-border: oklch(84% 0.045 181.5deg);
+  --theme-accent-foreground: var(--palette-white);
+  --theme-support: var(--palette-cyan);
+  --theme-support-strong: var(--palette-cobalt);
+  --theme-support-soft: oklch(95.5% 0.025 205deg);
+  --theme-display-gradient-start: var(--palette-teal-active);
+  --theme-display-gradient-highlight: oklch(72% 0.1 181.5deg);
+  --theme-display-gradient-end: var(--palette-teal);
+}
+
+:root[data-accent='steel'] {
+  --theme-accent: var(--palette-steel);
+  --theme-accent-hover: var(--palette-steel-hover);
+  --theme-accent-active: var(--palette-steel-active);
+  --theme-accent-soft: oklch(95.5% 0.012 245deg);
+  --theme-accent-border: oklch(84% 0.035 245deg);
+  --theme-accent-foreground: var(--palette-white);
+  --theme-support: var(--palette-cobalt);
+  --theme-support-strong: var(--palette-ocean);
+  --theme-support-soft: oklch(95.5% 0.02 225deg);
+  --theme-display-gradient-start: var(--palette-steel-active);
+  --theme-display-gradient-highlight: oklch(75% 0.08 225deg);
+  --theme-display-gradient-end: var(--palette-ocean);
+}
+
+:root[data-accent='safety'] {
+  --theme-accent: var(--palette-safety);
+  --theme-accent-hover: var(--palette-safety-hover);
+  --theme-accent-active: var(--palette-safety-active);
+  --theme-accent-soft: oklch(96.5% 0.025 75deg);
+  --theme-accent-border: oklch(86% 0.08 70deg);
+  --theme-accent-foreground: var(--palette-ink-active);
+  --theme-support: var(--palette-ocean);
+  --theme-support-strong: var(--palette-steel);
+  --theme-support-soft: oklch(95.5% 0.02 210deg);
+  --theme-display-gradient-start: var(--palette-safety-active);
+  --theme-display-gradient-highlight: oklch(79% 0.11 75deg);
+  --theme-display-gradient-end: var(--palette-ocean);
+}
+
+:root[data-accent='ocean'] {
+  --theme-accent: var(--palette-ocean);
+  --theme-accent-hover: var(--palette-ocean-hover);
+  --theme-accent-active: var(--palette-ocean-active);
+  --theme-accent-soft: oklch(95.5% 0.02 210deg);
+  --theme-accent-border: oklch(84% 0.055 210deg);
+  --theme-accent-foreground: var(--palette-white);
+  --theme-support: var(--palette-cyan);
+  --theme-support-strong: var(--palette-steel);
+  --theme-support-soft: oklch(95.5% 0.025 215deg);
+  --theme-display-gradient-start: var(--palette-ocean-active);
+  --theme-display-gradient-highlight: oklch(78% 0.1 210deg);
+  --theme-display-gradient-end: var(--palette-cyan);
+}
+
+:root.dark {
+  color-scheme: dark;
+
+  --link-foreground: oklch(72% 0.12 265.67deg);
+  --link-hover-foreground: oklch(78% 0.105 265.67deg);
+  --theme-accent: oklch(92.88% 0.0126 255.51deg);
+  --theme-accent-hover: oklch(86% 0.015 255.51deg);
+  --theme-accent-active: oklch(78% 0.018 255.51deg);
+  --theme-accent-soft: oklch(25.5% 0.018 257.42deg);
+  --theme-accent-border: oklch(36% 0.02 257.42deg);
+  --theme-accent-foreground: oklch(16% 0.02 264.66deg);
+  --theme-support: oklch(72% 0.12 215.22deg);
+  --theme-support-strong: oklch(72% 0.1 181.5deg);
+  --theme-support-soft: oklch(25.5% 0.025 215.22deg);
+  --theme-display-gradient-start: oklch(69% 0.02 257.42deg);
+  --theme-display-gradient-highlight: oklch(96% 0.008 255.51deg);
+  --theme-display-gradient-end: oklch(82% 0.014 255.51deg);
+  --surface-canvas: oklch(14.5% 0.014 264.66deg);
+  --surface-panel: oklch(17.8% 0.016 264.66deg);
+  --surface-raised: oklch(21% 0.018 264.66deg);
+  --surface-muted: oklch(24.5% 0.017 264.66deg);
+  --surface-muted-foreground: var(--text-regular);
+  --text-primary: oklch(95.5% 0.008 255.51deg);
+  --text-regular: oklch(82% 0.014 255.51deg);
+  --text-secondary: oklch(69% 0.02 257.42deg);
+  --border-base: oklch(31% 0.018 257.42deg);
+  --border-soft: oklch(25.5% 0.015 257.42deg);
+  --border-input: oklch(38% 0.02 257.42deg);
+  --ring-muted: oklch(55.1% 0.027 264.36deg);
+  --semantic-success: oklch(74% 0.145 146.19deg);
+  --semantic-success-soft: oklch(24% 0.045 146.19deg);
+  --semantic-success-foreground: oklch(82% 0.12 146.19deg);
+  --semantic-warning: oklch(82% 0.15 72.75deg);
+  --semantic-warning-soft: oklch(25% 0.045 72.75deg);
+  --semantic-warning-foreground: oklch(86% 0.12 72.75deg);
+  --semantic-danger: oklch(70.4% 0.191 22.22deg);
+  --semantic-danger-soft: oklch(25% 0.045 22.22deg);
+  --semantic-danger-foreground: oklch(82% 0.14 22.22deg);
+}
+
+:root.dark[data-accent='cobalt'] {
+  --theme-accent: oklch(67.5% 0.145 265.67deg);
+  --theme-accent-hover: oklch(73% 0.125 265.67deg);
+  --theme-accent-active: oklch(62% 0.135 265.67deg);
+  --theme-accent-soft: oklch(25.5% 0.04 265.67deg);
+  --theme-accent-border: oklch(42% 0.075 265.67deg);
+  --theme-accent-foreground: oklch(16% 0.02 264.66deg);
+  --theme-support: oklch(76% 0.11 215.22deg);
+  --theme-support-strong: oklch(72% 0.1 181.5deg);
+  --theme-support-soft: oklch(25.5% 0.04 215.22deg);
+  --theme-display-gradient-start: oklch(62% 0.135 265.67deg);
+  --theme-display-gradient-highlight: oklch(82% 0.095 265.67deg);
+  --theme-display-gradient-end: oklch(70% 0.13 265.67deg);
+}
+
+:root.dark[data-accent='teal'] {
+  --theme-accent: oklch(72% 0.12 181.5deg);
+  --theme-accent-hover: oklch(78% 0.105 181.5deg);
+  --theme-accent-active: oklch(65% 0.11 181.5deg);
+  --theme-accent-soft: oklch(25.5% 0.035 181.5deg);
+  --theme-accent-border: oklch(42% 0.065 181.5deg);
+  --theme-accent-foreground: oklch(16% 0.02 264.66deg);
+  --theme-support: oklch(76% 0.11 215.22deg);
+  --theme-support-strong: oklch(72% 0.12 265.67deg);
+  --theme-support-soft: oklch(25.5% 0.035 215.22deg);
+  --theme-display-gradient-start: oklch(65% 0.11 181.5deg);
+  --theme-display-gradient-highlight: oklch(84% 0.08 181.5deg);
+  --theme-display-gradient-end: oklch(72% 0.12 181.5deg);
+}
+
+:root.dark[data-accent='steel'],
+:root.dark[data-accent='safety'],
+:root.dark[data-accent='ocean'] {
+  --theme-accent-foreground: oklch(16% 0.02 264.66deg);
+  --theme-accent-soft: color-mix(in oklch, var(--theme-accent) 22%, transparent);
+  --theme-accent-border: color-mix(in oklch, var(--theme-accent) 48%, var(--border-base));
+  --theme-support-soft: color-mix(in oklch, var(--theme-support) 22%, transparent);
+}
+
+:root.dark[data-accent='steel'] {
+  --theme-accent: oklch(70% 0.075 245deg);
+  --theme-accent-hover: oklch(77% 0.065 245deg);
+  --theme-accent-active: oklch(62% 0.07 245deg);
+  --theme-support: oklch(73% 0.1 210deg);
+  --theme-support-strong: oklch(70% 0.08 210deg);
+}
+
+:root.dark[data-accent='safety'] {
+  --theme-accent: oklch(76% 0.15 65deg);
+  --theme-accent-hover: oklch(82% 0.12 65deg);
+  --theme-accent-active: oklch(68% 0.14 65deg);
+  --theme-support: oklch(73% 0.1 210deg);
+  --theme-support-strong: oklch(70% 0.075 245deg);
+}
+
+:root.dark[data-accent='ocean'] {
+  --theme-accent: oklch(72% 0.11 210deg);
+  --theme-accent-hover: oklch(79% 0.095 210deg);
+  --theme-accent-active: oklch(64% 0.105 210deg);
+  --theme-support: oklch(76% 0.11 215.22deg);
+  --theme-support-strong: oklch(70% 0.075 245deg);
+}