@lingfang/contract

灵坊（LingFang）平台跨层契约——字段与能力的单一事实来源。服务端（apps/collab-api）、插件 SDK（@lingfang/plugin-sdk）与响应类型基于同一套 Zod 契约与 TypeScript 类型，防止跨层漂移。

用途

承载跨层共享的契约定义，例如：

• 插件清单与能力：PluginManifest、CapabilityKind、RuntimeType
• 插件注册 / 发现 / 市场 / 计费契约
• 共享状态、动作、工作流 / 云自动化契约
• RBAC、账单、调度器等后端领域类型

安装

npm install @lingfang/contract

使用

import { ArtifactRefV1, CapabilityKind } from '@lingfang/contract';

const parsed = ArtifactRefV1.safeParse({ /* ... */ });
if (parsed.success) console.log(parsed.data);

发布

本包是源码包（monorepo 内按 main: src/index.ts 源码消费）。对外发布时用构建产物的 dist/：

pnpm build:dist && pnpm pack:dist && npm publish ./dist

pack:dist 会将 dist/*.js 的 extensionless 相对导入改写为 .js 并生成 dist/package.json，确保发布后可在纯 Node ESM 下运行。