@aipt/cli 0.1.0 → 0.1.13

package/dist/catalog/foundation.ai-education-picturebook-courseware-example/1.0.0/assets/src/picturebook-fixture.ts

@@ -0,0 +1,4 @@
+import{applyCompilePlan,approveCompilePlan,compilePresentation,createDesignSystemRelease,createImageStyleRelease,createMediaObjectPlan,createTypographyPackRelease,presentationDigest,renderPresentationPage,verifyPresentation}from"@aipt/visual-presentation-composition";
+export const storyBible={storyBibleId:"fixture.story-bible.fraction@1",learningTruth:"平均分后每份同样多，四份中的一份是四分之一。",character:{assetReleaseId:"fixture.character.xiaomao@1",name:"小猫米粒",clothing:"橙色围巾"},scene:{assetReleaseId:"fixture.scene.picnic@1",place:"虚构校园草地"},prop:{assetReleaseId:"fixture.prop.round-cake@1",name:"圆饼"},forbiddenStyles:["具体商业 IP","图片内正文文字"]}as const;
+export function createPictureBookFixture(profile:{profileReleaseId:string;method:string}){const beats=["建立角色与世界","问题发生","尝试平均分","认知转折","表达四分之一","迁移与回顾"].map((title,index)=>({pageId:`spread-${index+1}`,role:index===0?"cover"as const:index===5?"end"as const:"content"as const,sequence:index+1,title,body:index===0?profile.method:`${storyBible.character.name}用${storyBible.prop.name}说明四分之一。`,characterAssetReleaseId:storyBible.character.assetReleaseId,sceneAssetReleaseId:storyBible.scene.assetReleaseId,propAssetReleaseId:storyBible.prop.assetReleaseId})),designSystem=createDesignSystemRelease({designSystemReleaseId:"fixture.picturebook.ds@1",tokens:{"--background":"#fff7e8","--foreground":"#29352f"}}),typography=createTypographyPackRelease({typographyPackReleaseId:"fixture.picturebook.font@1",fontFamilies:["Fixture CJK"],glyphRanges:["zh-Hans"],fallbackStack:["system-ui"],license:"fixture"}),imageStyle=createImageStyleRelease({imageStyleReleaseId:"fixture.picturebook.image@1",palette:["#fff7e8","#ef9a62","#78a98f"],constraints:["固定 Canonical Asset","禁止图片内正文文字"]}),layouts=beats.map(beat=>({schemaVersion:1 as const,layoutReleaseId:`fixture.picturebook.${beat.pageId}@1`,compatibleRoles:[beat.role],slots:["illustration","text-overlay"],maxCharacters:140,contentDigest:presentationDigest(beat.pageId)})),blueprints=beats.map((beat,index)=>({pageId:beat.pageId,role:beat.role,sequence:beat.sequence,layoutReleaseId:layouts[index]!.layoutReleaseId,title:beat.title,body:beat.body,mediaObjectIds:[`illustration-${index+1}`],iconIds:[],chartMarks:[],pageDefinitionDigest:presentationDigest(beat)})),plan=approveCompilePlan(compilePresentation({planId:`picturebook-${presentationDigest(profile).slice(7,19)}`,designSystem,typography,imageStyle,template:{schemaVersion:1,templateReleaseId:"fixture.picturebook.template@1",supportedRoles:["cover","content","end"],layoutReleaseIds:layouts.map(x=>x.layoutReleaseId),defaultDesignSystemReleaseId:designSystem.designSystemReleaseId,contentDigest:presentationDigest("template")},layouts,icons:{schemaVersion:1,iconManifestReleaseId:"fixture.picturebook.icons@1",provider:"lucide",iconIds:[],contentDigest:presentationDigest("icons")},chartRenderer:{schemaVersion:1,chartRendererReleaseId:"fixture.picturebook.chart@1",supportedMarks:[],network:false,contentDigest:presentationDigest("chart")},mediaPlan:createMediaObjectPlan({mediaPlanId:"fixture-picturebook-media",objects:beats.map((_,i)=>({mediaObjectId:`illustration-${i+1}`,kind:"illustration",source:"fixture",assetReleaseId:`fixture.illustration.${i+1}@1`}))}),blueprints})),lock=applyCompilePlan(plan,plan.planDigest,"2026-08-24T00:00:00.000Z"),artifacts=blueprints.map((blueprint,index)=>renderPresentationPage({blueprint,layout:layouts[index]!,binding:plan.binding,lock})),findings=verifyPresentation({blueprints,layouts,typography,artifacts});return{profile,storyBible,beats,plan,lock,artifacts,findings};}
+export const fixtures=[createPictureBookFixture({profileReleaseId:"fixture.pedagogy.beijing-normal-math@1",method:"先操作、表达再反思"}),createPictureBookFixture({profileReleaseId:"fixture.pedagogy.people-education-math@1",method:"先示例、辨析再练习"})]as const;

package/dist/catalog/foundation.ai-education-picturebook-courseware-example/1.0.0/release.json

@@ -0,0 +1 @@
+{"schemaVersion":2,"capabilityId":"foundation.ai-education-picturebook-courseware-example","version":"1.0.0","consumerProfile":"any-project","kind":"engineering-feature","dependencies":{"profiles":["nextjs-full-stack-application"],"capabilities":["foundation.visual-presentation-composition"]},"compatibility":{"node":">=24.18.0 <25","pnpm":"11.21.0","typescript":"6.0.3"},"integration":{"title":"AI 教育绘本课件验收示例","purpose":"验证虚构 Story Bible 到跨页连续性和 Visual Compile/Renderer 的绘本闭环。","packages":[],"codeAssets":[{"sourcePath":"assets/README.ai-education-picturebook-courseware.md","targetPath":"README.ai-education-picturebook-courseware.md","ownership":"owned-file"},{"sourcePath":"assets/app/ai-education-picturebook-courseware/page.tsx","targetPath":"app/ai-education-picturebook-courseware/page.tsx","ownership":"owned-file"},{"sourcePath":"assets/src/picturebook-fixture.test.ts","targetPath":"src/picturebook-fixture.test.ts","ownership":"owned-file"},{"sourcePath":"assets/src/picturebook-fixture.ts","targetPath":"src/picturebook-fixture.ts","ownership":"owned-file"}]},"assets":[{"path":"app/ai-education-picturebook-courseware/page.tsx","ownership":"owned-file","digest":"sha256:208d72debc5f366dfdf48e9f1d997f122fc81e30b121831ad772dcc59f0cf6b4","mode":420},{"path":"README.ai-education-picturebook-courseware.md","ownership":"owned-file","digest":"sha256:59ca46cb84c4212b160a73aee9e611249a17cd0a9233b77c0a4415035898aa70","mode":420},{"path":"src/picturebook-fixture.test.ts","ownership":"owned-file","digest":"sha256:6671502c13205c5530a32355941b47398855a02f1ff1baa09f1a367f7e93d072","mode":420},{"path":"src/picturebook-fixture.ts","ownership":"owned-file","digest":"sha256:22760bc92b502e0f72ac1fcd45aafe8a4fc82c54fe86d094aea31ee4ecdcd2f8","mode":420}],"verifiers":[{"id":"capability.assets"},{"id":"typescript.typecheck"},{"id":"vitest.run"},{"id":"next.application-build"}],"exit":{"ownedAssets":["app/ai-education-picturebook-courseware/page.tsx","README.ai-education-picturebook-courseware.md","src/picturebook-fixture.test.ts","src/picturebook-fixture.ts"]},"availability":{"maturity":"candidate","visibility":"maintainers-only","sourceState":"local-artifact"},"packageSources":[],"integrity":"sha256:c0eea736cc3809ef17bf00b7a6d738b0b44ae5ced4b8a8ebfb367b8fb2167bd9"}

package/dist/catalog/foundation.ai-education-web-courseware-example/1.0.0/assets/README.ai-education-web-courseware.md

@@ -0,0 +1,3 @@
+# AI 教育标准网页课件验收示例
+
+本示例只使用完全虚构课时和 fake provider，通过平台 Visual Presentation Compile Plan/Lock、Renderer 与 Verifier 生成课件。它是 development candidate，不代表出版社官方能力或生产可用性。

package/dist/catalog/foundation.ai-education-web-courseware-example/1.0.0/assets/app/ai-education-web-courseware/page.tsx

@@ -0,0 +1 @@
+import{fixtures}from"../../src/courseware-fixture";export default function Page(){return <main lang="zh-CN" style={{maxWidth:1000,margin:"40px auto",padding:24,fontFamily:"system-ui"}}><p>Fixture only · Fake provider · development candidate</p><h1>AI 教育标准网页课件验收</h1><p>教师确认教学范围和创作结果，不选择技术 Skill。</p><section style={{display:"grid",gridTemplateColumns:"repeat(auto-fit,minmax(280px,1fr))",gap:16}}>{fixtures.map(item=><article key={item.profile.profileReleaseId} style={{padding:20,border:"1px solid #ddd",borderRadius:14}}><h2>{item.profile.method}</h2><div dangerouslySetInnerHTML={{__html:item.artifact.html}}/><dl><dt>Compile Lock</dt><dd style={{overflowWrap:"anywhere"}}>{item.lock.lockDigest}</dd><dt>Verifier</dt><dd>通过，无阻断项</dd></dl></article>)}</section></main>}

package/dist/catalog/foundation.ai-education-web-courseware-example/1.0.0/assets/src/courseware-fixture.test.ts

@@ -0,0 +1 @@
+import{describe,expect,it}from"vitest";import{fixtures}from"./courseware-fixture";describe("虚构标准网页课件",()=>{it("同一平台入口消费两个教研 Profile",()=>{expect(fixtures).toHaveLength(2);expect(fixtures.every(item=>item.findings.length===0&&item.lock.state==="active")).toBe(true);expect(fixtures[0].artifact.contentDigest).not.toBe(fixtures[1].artifact.contentDigest);});});

package/dist/catalog/foundation.ai-education-web-courseware-example/1.0.0/assets/src/courseware-fixture.ts

@@ -0,0 +1,3 @@
+import{applyCompilePlan,approveCompilePlan,compilePresentation,createDesignSystemRelease,createImageStyleRelease,createMediaObjectPlan,createTypographyPackRelease,presentationDigest,renderPresentationPage,verifyPresentation}from"@aipt/visual-presentation-composition";
+export function createCoursewareFixture(profile:{profileReleaseId:string;method:string}){const designSystem=createDesignSystemRelease({designSystemReleaseId:"fixture.courseware.ds@1",tokens:{"--background":"#f7f3ea","--foreground":"#192235"}}),typography=createTypographyPackRelease({typographyPackReleaseId:"fixture.courseware.font@1",fontFamilies:["Fixture CJK"],glyphRanges:["zh-Hans"],fallbackStack:["system-ui"],license:"fixture"}),imageStyle=createImageStyleRelease({imageStyleReleaseId:"fixture.courseware.image@1",palette:["#f7f3ea","#5b6fba"],constraints:["禁止图片内文字"]}),layout={schemaVersion:1 as const,layoutReleaseId:"fixture.courseware.cover@1",compatibleRoles:["cover"as const],slots:["title","body"],maxCharacters:160,contentDigest:presentationDigest("layout")},blueprint={pageId:"cover",role:"cover"as const,sequence:1,layoutReleaseId:layout.layoutReleaseId,title:"认识四分之一",body:profile.method,mediaObjectIds:[],iconIds:["sparkles"],chartMarks:[],pageDefinitionDigest:presentationDigest({profile:profile.profileReleaseId})},plan=approveCompilePlan(compilePresentation({planId:`courseware-${presentationDigest(profile).slice(7,19)}`,designSystem,typography,imageStyle,template:{schemaVersion:1,templateReleaseId:"fixture.courseware.template@1",supportedRoles:["cover"],layoutReleaseIds:[layout.layoutReleaseId],defaultDesignSystemReleaseId:designSystem.designSystemReleaseId,contentDigest:presentationDigest("template")},layouts:[layout],icons:{schemaVersion:1,iconManifestReleaseId:"fixture.courseware.icons@1",provider:"lucide",iconIds:["sparkles"],contentDigest:presentationDigest("icons")},chartRenderer:{schemaVersion:1,chartRendererReleaseId:"fixture.courseware.chart@1",supportedMarks:[],network:false,contentDigest:presentationDigest("chart")},mediaPlan:createMediaObjectPlan({mediaPlanId:"fixture-courseware-media",objects:[]}),blueprints:[blueprint]})),lock=applyCompilePlan(plan,plan.planDigest,"2026-08-24T00:00:00.000Z"),artifact=renderPresentationPage({blueprint,layout,binding:plan.binding,lock}),findings=verifyPresentation({blueprints:[blueprint],layouts:[layout],typography,artifacts:[artifact]});return{profile,plan,lock,artifact,findings};}
+export const fixtures=[createCoursewareFixture({profileReleaseId:"fixture.pedagogy.beijing-normal-math@1",method:"操作、表达与反思"}),createCoursewareFixture({profileReleaseId:"fixture.pedagogy.people-education-math@1",method:"示例、辨析与练习"})]as const;

package/dist/catalog/foundation.ai-education-web-courseware-example/1.0.0/release.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion":2,"capabilityId":"foundation.ai-education-web-courseware-example","version":"1.0.0","consumerProfile":"any-project","kind":"engineering-feature",
+  "dependencies":{"profiles":["nextjs-full-stack-application"],"capabilities":["foundation.visual-presentation-composition"]},
+  "compatibility":{"node":">=24.18.0 <25","pnpm":"11.21.0","typescript":"6.0.3"},
+  "integration":{"title":"AI 教育标准网页课件验收示例","purpose":"验证虚构 Creation Intake 到 Visual Compile/Renderer/Verifier 的课件闭环。","packages":[],"codeAssets":[
+    {"sourcePath":"assets/README.ai-education-web-courseware.md","targetPath":"README.ai-education-web-courseware.md","ownership":"owned-file"},
+    {"sourcePath":"assets/app/ai-education-web-courseware/page.tsx","targetPath":"app/ai-education-web-courseware/page.tsx","ownership":"owned-file"},
+    {"sourcePath":"assets/src/courseware-fixture.test.ts","targetPath":"src/courseware-fixture.test.ts","ownership":"owned-file"},
+    {"sourcePath":"assets/src/courseware-fixture.ts","targetPath":"src/courseware-fixture.ts","ownership":"owned-file"}]},
+  "assets":[
+    {"path":"app/ai-education-web-courseware/page.tsx","ownership":"owned-file","digest":"sha256:8742c7ae0f0e7adc07778e3c4d8711a979a16a88654ff8dd3899830bc6806874","mode":420},
+    {"path":"README.ai-education-web-courseware.md","ownership":"owned-file","digest":"sha256:b5577436bc7053e6fa5efbdf4b1ec4f8ee2a718dc5db8acf8578228e42339ff0","mode":420},
+    {"path":"src/courseware-fixture.test.ts","ownership":"owned-file","digest":"sha256:e1087922ea08794b5cf9e7ce1d9481d0ae022c9f9f8c4c549d6546502ea4bf4e","mode":420},
+    {"path":"src/courseware-fixture.ts","ownership":"owned-file","digest":"sha256:7d8338a45a32a2c0dc714d1bdf6f0d2fc06c98a405c65f014a46297f4dd38c1f","mode":420}],
+  "verifiers":[{"id":"capability.assets"},{"id":"typescript.typecheck"},{"id":"vitest.run"},{"id":"next.application-build"}],
+  "exit":{"ownedAssets":["app/ai-education-web-courseware/page.tsx","README.ai-education-web-courseware.md","src/courseware-fixture.test.ts","src/courseware-fixture.ts"]},
+  "availability":{"maturity":"candidate","visibility":"maintainers-only","sourceState":"local-artifact"},"packageSources":[],"integrity":"sha256:adc820975bfb3452f62014b3ad2bb17de843539e415738446aa4871c5b1e3407"
+}

package/dist/catalog/foundation.ai-orchestration/1.0.0/assets/docs/engineering/ai-orchestration.md

@@ -0,0 +1,3 @@
+# AI 编排能力
+
+本项目采用平台 Prompt、模型注册与访问、AI Function 公共合同。Package 和公共导入由 Capability Release 审计；Provider Secret 仍只由服务端 Adapter 注入。

package/dist/catalog/foundation.ai-orchestration/1.0.0/release.json

@@ -0,0 +1,99 @@
+{
+  "schemaVersion": 1,
+  "capabilityId": "foundation.ai-orchestration",
+  "version": "1.0.0",
+  "integrity": "sha256:470d931b2c6cc6d7d43a6aada41a32cfa63f99bc614b93ff85f9c37ad8be9e89",
+  "consumerProfile": "any-project",
+  "kind": "engineering-feature",
+  "dependencies": {
+    "profiles": [
+      "nextjs-full-stack-application",
+      "workspace-node-application",
+      "workspace-web-application"
+    ]
+  },
+  "compatibility": {
+    "node": ">=24.18.0 <25",
+    "pnpm": "11.21.0",
+    "typescript": "6.0.3"
+  },
+  "integration": {
+    "title": "AI 编排",
+    "purpose": "统一 Prompt、模型选择/访问与 AI Function provenance。",
+    "packages": [
+      {
+        "packageName": "@aipt/prompt-runtime",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/prompt-runtime",
+            "symbol": "compilePrompt",
+            "referencePath": "packages/prompt-runtime/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@aipt/model-registry",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/model-registry",
+            "symbol": "selectMultimodalModel",
+            "referencePath": "packages/model-registry/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@aipt/model-access",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/model-access",
+            "symbol": "withDeadline",
+            "referencePath": "packages/model-access/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@aipt/ai-function-runtime",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/ai-function-runtime",
+            "symbol": "createAIFunction",
+            "referencePath": "packages/ai-function-runtime/src/index.ts"
+          }
+        ]
+      }
+    ],
+    "codeAssets": [
+      {
+        "sourcePath": "assets/docs/engineering/ai-orchestration.md",
+        "targetPath": "docs/engineering/ai-orchestration.md",
+        "ownership": "owned-file"
+      }
+    ]
+  },
+  "assets": [
+    {
+      "path": "docs/engineering/ai-orchestration.md",
+      "ownership": "owned-file",
+      "digest": "sha256:ff6664394f61de04bf61b64c45eb9a2fcb0972d9a5be807fc8a55413f1ab1ab7",
+      "mode": 420
+    }
+  ],
+  "verifiers": [
+    {
+      "id": "capability.assets"
+    }
+  ],
+  "exit": {
+    "ownedAssets": [
+      "docs/engineering/ai-orchestration.md"
+    ]
+  }
+}

package/dist/catalog/foundation.api-contract-toolchain/1.0.0/assets/docs/engineering/api-contract.md

@@ -0,0 +1,33 @@
+# API 契约工具链
+
+本项目的接口契约由服务端声明式路由导出，不手写。
+
+```text
+声明式路由（zod）
+   ├─→ 运行时处理器
+   └─→ openapi.json ──→ 类型 / SDK / TanStack Query / mock
+```
+
+## 固定命令
+
+- `pnpm api:emit`：从路由导出 `openapi.json`。
+- `pnpm api:generate`：由 `openapi.json` 生成类型、SDK、TanStack Query 与 mock。
+- CI 必须校验 `openapi.json` 与路由推导结果一致，否则改了接口却忘了重新导出不会被发现。
+
+## 注入的组合根
+
+- `src/api/runtime.ts`：契约漂移守卫、mock 开关、信封收敛。
+- `src/api/query-client.ts`：服务端状态层默认策略。查询函数与 queryKey 由 codegen 产出，这里只固定跨查询的重试、过期与错误处理——因此它不是一个独立代码服务，而是本能力的注入物。
+
+## 运行时保证
+
+`src/api/runtime.ts` 组合根提供三件事：
+
+- **契约不漂移**：服务端在响应头公布契约摘要，与生成产物所依据的摘要不一致时报 `API_CONTRACT_DRIFTED`。
+- **mock 不绕过契约**：mock 数据同样公布摘要，用过期契约生成的 mock 会被同一个守卫拦下。
+- **失败是数据**：`unwrap` 把信封收敛成判别联合，业务代码不在每个调用点解构线格式。
+- **确定性失败不重试**：契约漂移与信封非法都不会触发重试，重试只会放大故障；写请求默认不重试，避免没有幂等键的重复提交。
+
+## 边界
+
+生成产物是派生结果，请勿手改；重新生成即可。签名密钥不得进入浏览器包——客户端加签只有配合混淆才有意义，那是另一条死路。

package/dist/catalog/foundation.api-contract-toolchain/1.0.0/assets/openapi-ts.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from "@hey-api/openapi-ts";
+
+/**
+ * 生成产物的输入是服务端声明式路由导出的契约，不是手写的 spec。
+ * 因此"后端改了接口、前端不知道"在生成期就会显现为产物变化。
+ *
+ * 本文件是 seed-file：首次生成后归项目所有，可按需增删插件。
+ */
+export default defineConfig({
+  input: "./openapi.json",
+  output: { path: "./src/api/generated" },
+  plugins: [
+    { name: "@hey-api/typescript" },
+    { name: "@hey-api/sdk" },
+    { name: "@hey-api/client-fetch" },
+    { name: "@tanstack/react-query" },
+    { name: "@faker-js/faker" },
+    { name: "msw" },
+  ],
+});

package/dist/catalog/foundation.api-contract-toolchain/1.0.0/assets/src/api/query-client.ts

@@ -0,0 +1,29 @@
+import { QueryClient } from "@tanstack/react-query";
+
+/**
+ * 服务端状态层的组合根。查询函数与 queryKey 由契约 codegen 产出，
+ * 这里只固定跨查询的默认策略——因此它不需要成为一个独立代码服务。
+ *
+ * 本文件由 foundation.api-contract-toolchain 拥有；改动会在 verify 时被检出漂移。
+ */
+export function createQueryClient(): QueryClient {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        // 契约漂移与输入非法都是确定性失败，重试只会放大故障
+        retry: (failureCount, error) => {
+          const code = (error as { code?: string }).code ?? "";
+          if (code.startsWith("API_CONTRACT") || code === "API_ENVELOPE_INVALID") return false;
+          return failureCount < 2;
+        },
+        retryDelay: (attempt) => Math.min(1_000 * 2 ** attempt, 8_000),
+        staleTime: 30_000,
+        // 失败信封是数据而不是异常，因此不该触发全局错误边界
+        throwOnError: false,
+        refetchOnWindowFocus: false,
+      },
+      // 写请求默认不重试：没有幂等键的重试会造成重复提交
+      mutations: { retry: false },
+    },
+  });
+}

package/dist/catalog/foundation.api-contract-toolchain/1.0.0/assets/src/api/runtime.ts

@@ -0,0 +1,44 @@
+import { contractDriftGuard, mockFetch, unwrapEnvelope, type Envelope, type MockHandler } from "@aipt/api-contract";
+
+/**
+ * API 运行时组合根。生成产物负责"怎么调"，这里负责"调用时还要保证什么"：
+ * 契约不漂移、mock 与真实走同一份契约、失败信封收敛成判别联合。
+ *
+ * 本文件由 foundation.api-contract-toolchain 拥有；改动会在 verify 时被检出漂移。
+ */
+export type ApiRuntimeConfig = Readonly<{
+  baseUrl: string;
+  /** 生成产物所依据的契约摘要。由 CI 从 openapi.json 计算后注入。 */
+  contractDigest: string;
+  /** 开启后按 operationId 使用本地数据；未登记的 operation 显式失败，不静默打真实网络。 */
+  mock?: Readonly<{ enabled: boolean; handlers: Readonly<Record<string, MockHandler>> }>;
+  /** 从请求还原 operationId，供 mock 与策略判定使用。 */
+  operationIdOf(request: Request): string | undefined;
+  /** 跨切面请求改写：加签、染色标签、租户头等。 */
+  requestInterceptors?: readonly ((request: Request) => Promise<Request> | Request)[];
+}>;
+
+export function createApiRuntime(config: ApiRuntimeConfig) {
+  const guard = contractDriftGuard({ expectedDigest: config.contractDigest });
+  const real = globalThis.fetch;
+  const transport = config.mock?.enabled
+    ? mockFetch({ handlers: config.mock.handlers, operationIdOf: config.operationIdOf, digest: config.contractDigest as `sha256:${string}` })
+    : real;
+
+  /** 交给生成客户端的 fetch 实现：先过拦截器，再校验契约摘要。 */
+  const fetchImpl: typeof globalThis.fetch = async (input, init) => {
+    let request = input instanceof Request && init === undefined ? input : new Request(input as RequestInfo | URL, init);
+    for (const interceptor of config.requestInterceptors ?? []) request = await interceptor(request);
+    const response = await transport(request);
+    return guard(response, request) as Response;
+  };
+
+  return Object.freeze({
+    baseUrl: config.baseUrl,
+    fetch: fetchImpl,
+    /** 把生成 SDK 的返回值收敛成 `{ ok, data } | { ok, error }`，业务代码不解构线格式。 */
+    unwrap: <T>(value: unknown) => unwrapEnvelope<T>(value),
+  });
+}
+
+export type { Envelope, MockHandler };

package/dist/catalog/foundation.api-contract-toolchain/1.0.0/release.json

@@ -0,0 +1,122 @@
+{
+  "schemaVersion": 1,
+  "capabilityId": "foundation.api-contract-toolchain",
+  "version": "1.0.0",
+  "consumerProfile": "any-project",
+  "kind": "engineering-feature",
+  "dependencies": {
+    "profiles": [
+      "nextjs-full-stack-application",
+      "workspace-node-application",
+      "workspace-web-application"
+    ]
+  },
+  "compatibility": {
+    "node": ">=24.18.0 <25",
+    "pnpm": "11.21.0",
+    "typescript": "6.0.3"
+  },
+  "integration": {
+    "title": "API 契约工具链",
+    "purpose": "接口契约由声明式路由导出；类型、SDK、TanStack Query 与 mock 全部由它生成，并注入运行时与状态层组合根。",
+    "packages": [
+      {
+        "packageName": "@aipt/api-contract",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/api-contract",
+            "symbol": "contractDriftGuard",
+            "referencePath": "packages/api-contract/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@aipt/api-route",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/api-route",
+            "symbol": "createApiRouter",
+            "referencePath": "packages/api-route/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@tanstack/react-query",
+        "version": "5.101.4",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@tanstack/react-query",
+            "symbol": "QueryClient"
+          }
+        ]
+      }
+    ],
+    "codeAssets": [
+      {
+        "sourcePath": "assets/openapi-ts.config.ts",
+        "targetPath": "openapi-ts.config.ts",
+        "ownership": "seed-file"
+      },
+      {
+        "sourcePath": "assets/src/api/runtime.ts",
+        "targetPath": "src/api/runtime.ts",
+        "ownership": "owned-file"
+      },
+      {
+        "sourcePath": "assets/src/api/query-client.ts",
+        "targetPath": "src/api/query-client.ts",
+        "ownership": "owned-file"
+      },
+      {
+        "sourcePath": "assets/docs/engineering/api-contract.md",
+        "targetPath": "docs/engineering/api-contract.md",
+        "ownership": "owned-file"
+      }
+    ]
+  },
+  "assets": [
+    {
+      "path": "docs/engineering/api-contract.md",
+      "ownership": "owned-file",
+      "digest": "sha256:da5d84d8b59aa91b6707fdd1a609f3b29bd60c9c497d4c05209c0fcc2ac24c30",
+      "mode": 420
+    },
+    {
+      "path": "openapi-ts.config.ts",
+      "ownership": "seed-file",
+      "digest": "sha256:320ff603611e4e3bf2f1c5d97e2d465ccb90e6c5672de3a6f6dcf59f1dca10cd",
+      "mode": 420
+    },
+    {
+      "path": "src/api/query-client.ts",
+      "ownership": "owned-file",
+      "digest": "sha256:dd4b9b7b9d72bbfea947db213f0e5208b8cea5536e5b887148a9e52d5ea1f09c",
+      "mode": 420
+    },
+    {
+      "path": "src/api/runtime.ts",
+      "ownership": "owned-file",
+      "digest": "sha256:9d5175a753845990c2d20edcf4d35364613abd559abaeb0cc6d32834dabef72b",
+      "mode": 420
+    }
+  ],
+  "verifiers": [
+    {
+      "id": "capability.assets"
+    }
+  ],
+  "exit": {
+    "ownedAssets": [
+      "docs/engineering/api-contract.md",
+      "openapi-ts.config.ts",
+      "src/api/query-client.ts",
+      "src/api/runtime.ts"
+    ]
+  },
+  "integrity": "sha256:af0ec73d62356badfd2615d6ae00271b6a34c4d3d2c61c3eb3b66e434ee9d42b"
+}

package/dist/catalog/foundation.application-config-binding/1.0.0/assets/.dyyto/application-config-binding.json

@@ -0,0 +1,4 @@
+{
+  "schemaVersion": 1,
+  "renderer": "application-config-binding-v1"
+}

package/dist/catalog/foundation.application-config-binding/1.0.0/assets/docs/engineering/application-config-binding.md

@@ -0,0 +1,5 @@
+# 应用配置位置
+
+`.dyyto/application-config-binding.json` 只记录可迁移的逻辑 Binding。当前机器必须通过绝对 `APP_CONFIG_DIR` 指向项目和环境独享的仓库外配置根；项目不得保存 Secret、证书私钥或该绝对路径。
+
+使用 `dyyto config inspect --project .` 检查合同、权限、配置状态和脱敏投影。业务 Secret 由外部部署控制面写入，开发工作台不会把完整明文返回浏览器。

package/dist/catalog/foundation.application-config-binding/1.0.0/release.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "capabilityId": "foundation.application-config-binding",
+  "version": "1.0.0",
+  "integrity": "sha256:7ac10b8d2a8425cdcb810b9efb9767c7b509ea2809c1a2bd67fc8aa69b75c99e",
+  "consumerProfile": "any-project",
+  "kind": "engineering-feature",
+  "dependencies": {
+    "profiles": ["nextjs-full-stack-application", "workspace-node-application", "workspace-web-application"],
+    "capabilities": [{ "capabilityId": "foundation.environment-schema", "version": "2.0.0" }]
+  },
+  "compatibility": { "node": ">=24.18.0 <25", "pnpm": "11.21.0", "typescript": "6.0.3" },
+  "integration": {
+    "title": "应用独立 Config Dir Binding",
+    "purpose": "让项目通过可迁移逻辑合同发现APP_CONFIG_DIR，并安全投影配置状态。",
+    "packages": [],
+    "codeAssets": [
+      { "sourcePath": "assets/.dyyto/application-config-binding.json", "targetPath": ".dyyto/application-config-binding.json", "ownership": "owned-file" },
+      { "sourcePath": "assets/docs/engineering/application-config-binding.md", "targetPath": "docs/engineering/application-config-binding.md", "ownership": "owned-file" }
+    ]
+  },
+  "assets": [
+    { "path": ".dyyto/application-config-binding.json", "ownership": "owned-file", "digest": "sha256:a90c9ada72e98d0e77cfa3228ed4d1b58933c7d9ae4a7afe3a9b15e2909523d2", "mode": 420, "renderer": "application-config-binding-v1" },
+    { "path": "docs/engineering/application-config-binding.md", "ownership": "owned-file", "digest": "sha256:d95bfec13840cc757744aca857a31dccd70c410eea4cfa13835677aa3b3789cf", "mode": 420 }
+  ],
+  "verifiers": [{ "id": "capability.assets" }],
+  "exit": { "ownedAssets": [".dyyto/application-config-binding.json", "docs/engineering/application-config-binding.md"] }
+}

package/dist/catalog/foundation.artifact-delivery/1.0.0/assets/docs/engineering/artifact-delivery.md

@@ -0,0 +1,3 @@
+# Artifact Delivery
+
+本项目从 Published Package 生成确定性 Web Bundle，并通过正式 Delivery Plan 与 Receipt 交付 Offline 或 Hosted 目标。

package/dist/catalog/foundation.artifact-delivery/1.0.0/release.json

@@ -0,0 +1,75 @@
+{
+  "schemaVersion": 1,
+  "capabilityId": "foundation.artifact-delivery",
+  "version": "1.0.0",
+  "integrity": "sha256:3ad443d9418baf3b7023c78aee7481010a9f1ad749369aa6f6e7704d24adce7a",
+  "consumerProfile": "any-project",
+  "kind": "engineering-feature",
+  "dependencies": {
+    "profiles": [
+      "nextjs-full-stack-application",
+      "workspace-node-application",
+      "workspace-web-application"
+    ]
+  },
+  "compatibility": {
+    "node": ">=24.18.0 <25",
+    "pnpm": "11.21.0",
+    "typescript": "6.0.3"
+  },
+  "integration": {
+    "title": "Artifact Delivery",
+    "purpose": "从 Published Package 生成 Web Bundle 并进入正式 Delivery。",
+    "packages": [
+      {
+        "packageName": "@aipt/artifact-delivery",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/artifact-delivery",
+            "symbol": "createPublishedPackageDeliveryPlan",
+            "referencePath": "packages/artifact-delivery/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@aipt/web-bundle-builder",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/web-bundle-builder",
+            "symbol": "buildWebBundle",
+            "referencePath": "packages/web-bundle-builder/src/index.ts"
+          }
+        ]
+      }
+    ],
+    "codeAssets": [
+      {
+        "sourcePath": "assets/docs/engineering/artifact-delivery.md",
+        "targetPath": "docs/engineering/artifact-delivery.md",
+        "ownership": "owned-file"
+      }
+    ]
+  },
+  "assets": [
+    {
+      "path": "docs/engineering/artifact-delivery.md",
+      "ownership": "owned-file",
+      "digest": "sha256:475a6b40750b74e8cabfb6a0da1f79c2a62e900e2a228e1f79b8b16b989f9836",
+      "mode": 420
+    }
+  ],
+  "verifiers": [
+    {
+      "id": "capability.assets"
+    }
+  ],
+  "exit": {
+    "ownedAssets": [
+      "docs/engineering/artifact-delivery.md"
+    ]
+  }
+}

package/dist/catalog/foundation.artifact-runtime/1.0.0/assets/docs/engineering/artifact-runtime.md

@@ -0,0 +1,3 @@
+# Artifact Runtime
+
+本项目采用版本化 Artifact、Runtime Session 与 Renderer Host，Published Package 是运行和渲染的唯一正式输入。

package/dist/catalog/foundation.artifact-runtime/1.0.0/release.json

@@ -0,0 +1,87 @@
+{
+  "schemaVersion": 1,
+  "capabilityId": "foundation.artifact-runtime",
+  "version": "1.0.0",
+  "integrity": "sha256:354b94c92cde04d2d2e81d4d3b036e74220127203885c78cb28f8a32c502ac5c",
+  "consumerProfile": "any-project",
+  "kind": "engineering-feature",
+  "dependencies": {
+    "profiles": [
+      "nextjs-full-stack-application",
+      "workspace-node-application",
+      "workspace-web-application"
+    ]
+  },
+  "compatibility": {
+    "node": ">=24.18.0 <25",
+    "pnpm": "11.21.0",
+    "typescript": "6.0.3"
+  },
+  "integration": {
+    "title": "Artifact Runtime",
+    "purpose": "统一 Published Package、Runtime Session 与 Renderer Host。",
+    "packages": [
+      {
+        "packageName": "@aipt/artifact-contracts",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/artifact-contracts",
+            "symbol": "assertPublishedPackage",
+            "referencePath": "packages/artifact-contracts/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@aipt/artifact-runtime-core",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/artifact-runtime-core",
+            "symbol": "createRuntimeSession",
+            "referencePath": "packages/artifact-runtime-core/src/index.ts"
+          }
+        ]
+      },
+      {
+        "packageName": "@aipt/artifact-renderer-host",
+        "version": "workspace:*",
+        "usage": "runtime",
+        "imports": [
+          {
+            "importFrom": "@aipt/artifact-renderer-host",
+            "symbol": "createRendererHost",
+            "referencePath": "packages/artifact-renderer-host/src/index.ts"
+          }
+        ]
+      }
+    ],
+    "codeAssets": [
+      {
+        "sourcePath": "assets/docs/engineering/artifact-runtime.md",
+        "targetPath": "docs/engineering/artifact-runtime.md",
+        "ownership": "owned-file"
+      }
+    ]
+  },
+  "assets": [
+    {
+      "path": "docs/engineering/artifact-runtime.md",
+      "ownership": "owned-file",
+      "digest": "sha256:69477d633d230ebfa0b2eead5b1621c81a353b810f0ce924c04a6252c9d6c1d2",
+      "mode": 420
+    }
+  ],
+  "verifiers": [
+    {
+      "id": "capability.assets"
+    }
+  ],
+  "exit": {
+    "ownedAssets": [
+      "docs/engineering/artifact-runtime.md"
+    ]
+  }
+}

package/dist/catalog/foundation.capability-family-routing/1.0.0/assets/README.capability-family-routing.md

@@ -0,0 +1,7 @@
+# Capability Family Routing 示例
+
+这是 Dyyto 平台的 development candidate，只证明通用 Capability Family / Strategy / Workflow Binding 路由合同，不代表 production available。
+
+运行 `pnpm test` 后应看到文档审阅能力族固定到一个策略和一个工作流 Release。未知策略、撤回 Release、旧 Skill 映射缺失、stale revision 和 schema 漂移均 fail closed。
+
+本示例不包含教育、出版社或 PoC 名称分支。