Archived
JCAI Main AgentandClaude Opus 5
14d4fa046a
@contracts 首版(§8.1 九个文件): - id 品牌 ID / terminal 终态五名与归侧四标签 / envelope 信封六字段与四类事件 - card 工单两模式 + 对话卡族(形状对齐 2026-07-26 原型定稿) - contract7 契约七件 / ledger 三级寻址与写三分 / process-package 流程包 DSL 与触发器三类 - manifest 活动包清单六区(含 CMMN·DMN·步序声明的资产形状)/ org / api 路由契约 模块(L1): - event 信封存储、归属解析三级短路、投递五诺、监听注册表、三级消费裁定 - ledger schema 自生长(最大化合并/最宽类型/只增不破坏)、任务视图叠加、写三分、冲突检查 - org 岗位授权(客体三类×动作三种)、停用前置检查、会话、种子播种 - llm 四元绑定、ModelGateway 三模式(live/record/replay)—— 两缝之一 app 装配:Hono 服务 + 鉴权中间件 + 治理台/工作台路由;drizzle 迁移;AES-256-GCM 凭证密封 ADR-007 工具链与门禁 · ADR-008 投递队列 · ADR-009 凭证加密 (ADR 编号自 007 续:编码规范 §14 已用到 006,README 写「从 005 续」是笔误) 门禁五道全绿;96 个测试通过,含对真实 PG 的 ledger 集成测试 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2.5 KiB
2.5 KiB
ADR-007 · 工具链与门禁的落地形态
- 状态:已决(M0)
- 日期:2026-07-27
- 上下文:编码规范 §11 规定五道门禁(tsc / eslint / depcruise / api-report / test)必须存在且可执行, 但未规定 TypeScript 的运行与产出形态。§1 表内已定案的构建件只有 Vite(前端)与 tsup(§8.2 活动编译预设)。
决定
- 后端不引新的 TS 运行器。
apps/api以 tsup(§8.2 已定案的表内件,esbuild 内核,原生解析 tsconfigpaths) 打包为 ESM 后由 Node 22+ 直跑;开发期tsup --watch --onSuccess node dist/main.js。 不引入tsx/ts-node/swc等表外依赖(§12.5#3)。 - tsc 分两个工程:
tsconfig.node.json(api / packages / activities / tools,lib ES2023)与tsconfig.web.json(web / ui-kit,lib DOM + jsx)。二者共享tsconfig.base.json的严格开关与 §11.1 规定的paths。根tsconfig.json只做 solution 引用。 理由:一份 tsconfig 同时挂 DOM 与 Node 全局会让 §9.2「组件内禁裸 fetch」之类的门禁失去类型依据。 - 契约快照的范围(
tools/api-report.mjs):tsc --emitDeclarationOnly出全量声明后, 只保留契约面落api-report/——packages/contracts/**、各packages/<pkg>/src/index.d.ts、 各apps/api/src/modules/<m>/{index,contract,port}.d.ts。 由此「改internal/时 api-report 纹丝不动」(§11.5)成立。 配套纪律:模块出口的公开签名必须由contract.ts/port.ts的显式类型承载, 不得依赖internal/的推断类型泄漏(由explicit-module-boundary-types在 modules/ 下强制)。 - §11.2 的解析层封装采用双保险:每个后端模块带 workspace
package.json(exports只开index.ts), 同时保留 §11.1 的@modules/*路径别名;穿透internal/的拦截由 ESLintno-restricted-imports与 depcruiseno-cross-module-internal两道机检承担(§11.3 / §11.4)。 - tier-order 生成物入库:
tools/depcruise-tiers.generated.cjs由tools/gen-depcruise-tiers.ts从tools/module-tiers.json生成并提交,pnpm gates首步重新生成 —— 层级表与门禁的漂移在 diff 上可见。
后果
- 表外依赖为零;门禁全部可离线执行。
- 后端产物是打好的 bundle,栈帧靠 sourcemap 还原。
no-orphans对契约面(index/contract/port)、app/、activities/、tools/与测试放行—— 这些是合法的无入边文件;其余孤儿一律 error。