@vcp-dev/contracts 0.10.11 → 0.10.12

package/dist/launcher-prompt-templates.d.ts

@@ -323,8 +323,8 @@ export declare const LauncherPromptTemplateApplyRequestSchema: z.ZodObject<{
                     userEdited: z.ZodBoolean;
                     lastEditedAt: z.ZodString;
                     lastEditedBy: z.ZodEnum<{
-                        ai: "ai";
                         user: "user";
+                        ai: "ai";
                     }>;
                     userInstruction: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
@@ -510,8 +510,8 @@ export declare const LauncherPromptTemplateApplyResponseSchema: z.ZodObject<{
                     userEdited: z.ZodBoolean;
                     lastEditedAt: z.ZodString;
                     lastEditedBy: z.ZodEnum<{
-                        ai: "ai";
                         user: "user";
+                        ai: "ai";
                     }>;
                     userInstruction: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;

package/dist/page-template.d.ts

@@ -92,6 +92,7 @@ export declare const PageTemplateTaskSchema: z.ZodObject<{
         failed: "failed";
     }>>;
     degraded_reason: z.ZodNull;
+    changes: z.ZodDefault<z.ZodNull>;
 }, z.core.$strict>;
 export type PageTemplateTask = z.infer<typeof PageTemplateTaskSchema>;
 /** Create returns the shared asynchronous task envelope (HTTP 202). */
@@ -124,6 +125,7 @@ export declare const PageTemplateCreateResponseSchema: z.ZodObject<{
             failed: "failed";
         }>>;
         degraded_reason: z.ZodNull;
+        changes: z.ZodDefault<z.ZodNull>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type PageTemplateCreateResponse = z.infer<typeof PageTemplateCreateResponseSchema>;
@@ -156,7 +158,6 @@ export declare const PageTemplateErrorCodeSchema: z.ZodEnum<{
     PAGE_TEMPLATE_ID_COLLISION: "PAGE_TEMPLATE_ID_COLLISION";
     PAGE_TEMPLATE_MANAGED_SOURCE_INVALID: "PAGE_TEMPLATE_MANAGED_SOURCE_INVALID";
     PAGE_TEMPLATE_SNAPSHOT_CONFLICT: "PAGE_TEMPLATE_SNAPSHOT_CONFLICT";
-    PAGE_TEMPLATE_DYNAMIC_ROUTE_UNSUPPORTED: "PAGE_TEMPLATE_DYNAMIC_ROUTE_UNSUPPORTED";
     PAGE_TEMPLATE_SOURCE_UNSUPPORTED: "PAGE_TEMPLATE_SOURCE_UNSUPPORTED";
     PAGE_TEMPLATE_GENERATION_FAILED: "PAGE_TEMPLATE_GENERATION_FAILED";
     PAGE_TEMPLATE_PATCH_FAILED: "PAGE_TEMPLATE_PATCH_FAILED";

package/dist/site-design-notes.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+/**
+ * `app/globals.css` 里给 Agent 读的设计说明注释：自由文本行 + 结构化的调色板
+ * 输入依据。明暗底不进这里——一律读令牌区的 `color-scheme`（方案同步，见
+ * `design-token-block.ts` 的 `readColorScheme`）。
+ */
+export declare const SITE_DESIGN_NOTES_START = "/* <cms-builder:site-design-notes>";
+export declare const SITE_DESIGN_NOTES_END = "</cms-builder:site-design-notes> */";
+export declare const PaletteInputsSchema: z.ZodObject<{
+    primarySource: z.ZodEnum<{
+        user: "user";
+        derived: "derived";
+    }>;
+    neutral: z.ZodOptional<z.ZodString>;
+    foreground: z.ZodOptional<z.ZodString>;
+    supporting: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    imagePalette: z.ZodOptional<z.ZodObject<{
+        background: z.ZodOptional<z.ZodString>;
+        foreground: z.ZodOptional<z.ZodString>;
+        card: z.ZodOptional<z.ZodString>;
+        muted: z.ZodOptional<z.ZodString>;
+        border: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PaletteInputs = z.infer<typeof PaletteInputsSchema>;
+export type SiteDesignNotes = {
+    lines: string[];
+    paletteInputs: PaletteInputs | null;
+};
+export declare function formatSiteDesignNotes(notes: SiteDesignNotes): string;
+/**
+ * 去掉 site-design-notes 注释块，连同 `upsertSiteDesignNotes` 插入它时附带的
+ * 换行一起清除，使「css 只有这段注释不同」在去除后能精确比较回同一份 CSS
+ * （对「块内容不同，其余字节相同」的两份 CSS 做相等性判断时尤其需要）。
+ *
+ * `upsertSiteDesignNotes` 有两条插入路径，各自加的换行数量固定，与插入点原有
+ * 的格式无关：
+ * - 紧跟最后一条 `@import` 插入（或替换已有块）：块前、块后各恰好加一个换行。
+ * - 没有 `@import` 可挂靠、块插在文件开头：块后固定加两个换行（`\n\n`）。
+ * 按块前是否为空区分这两条路径，只吃掉这固定数量的换行，不动插入点本来就有
+ * 的其余换行——这样才能在原 css 本身带空行格式时也精确复原。
+ */
+export declare function stripSiteDesignNotes(css: string): string;
+export declare function readSiteDesignNotes(css: string): SiteDesignNotes | null;
+/**
+ * 有则替换，无则插在**最后一个** `@import` 行之后（模板常见连续多条 `@import`，
+ * 插在第一个之后会把说明注释楔进 import 语句之间）；没有 import 时放文件开头。
+ */
+export declare function upsertSiteDesignNotes(css: string, notes: SiteDesignNotes): string;

package/dist/site-edit-command-result.d.ts

@@ -3,6 +3,7 @@ import { type SiteEditCompositionContext } from "./site-edit-composition.js";
 export declare const SiteEditCommandErrorSchema: z.ZodObject<{
     code: z.ZodString;
     message: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type SiteEditCommandError = z.infer<typeof SiteEditCommandErrorSchema>;
 export declare const SiteEditCommandDiagnosticSchema: z.ZodObject<{
@@ -53,6 +54,7 @@ export type SiteEditCommandFailure<TCode extends string = string, TCurrent = unk
     error: {
         code: TCode;
         message: string;
+        details?: Record<string, unknown>;
     };
     current?: TCurrent;
     diagnostics?: TDiagnostic[];

package/dist/site-edit-version.d.ts

@@ -5,7 +5,7 @@
  *
  * 由 release-edit-engine-packages.ts 在 bump 版本时自动更新。
  */
-export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.11";
+export declare const CURRENT_EDIT_ENGINE_VERSION = "0.10.12";
 export declare const EDIT_ENGINE_VERSION_HEADER = "x-vcp-edit-engine-version";
 export declare const EDIT_ENGINE_VERSION_SOURCE_HEADER = "x-vcp-edit-engine-version-source";
 export type EditEngineVersionSource = "explicit" | "fallback_current" | "system_current";

package/dist/site-migration-progress.d.ts

@@ -46,6 +46,56 @@ export declare const MigrationCollectionProgressSchema: z.ZodDiscriminatedUnion<
     imported: z.ZodNumber;
     exception: z.ZodNumber;
 }, z.core.$strict>], "status">;
+/** Site-wide reasons that make every written redirect ineffective. */
+export declare const MigrationRedirectSiteReasonSchema: z.ZodEnum<{
+    legacy_domain_not_routed: "legacy_domain_not_routed";
+    site_context_missing: "site_context_missing";
+    site_rules_limit_exceeded: "site_rules_limit_exceeded";
+    site_rules_not_served: "site_rules_not_served";
+}>;
+export declare const MigrationRedirectReasonCodeSchema: z.ZodEnum<{
+    legacy_domain_not_routed: "legacy_domain_not_routed";
+    site_context_missing: "site_context_missing";
+    site_rules_limit_exceeded: "site_rules_limit_exceeded";
+    site_rules_not_served: "site_rules_not_served";
+    target_page_unpublished: "target_page_unpublished";
+    redirect_target_missing: "redirect_target_missing";
+    redirect_write_failed: "redirect_write_failed";
+}>;
+/**
+ * Initialization 301 card, returned only after the site is published.
+ * "active" is inferred by the migration service (rule written + site-wide
+ * checks), not probed per URL. Processing/unavailable carry no counts.
+ */
+export declare const MigrationRedirectProgressSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"processing">;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"unavailable">;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"ready">;
+    site_reason: z.ZodNullable<z.ZodEnum<{
+        legacy_domain_not_routed: "legacy_domain_not_routed";
+        site_context_missing: "site_context_missing";
+        site_rules_limit_exceeded: "site_rules_limit_exceeded";
+        site_rules_not_served: "site_rules_not_served";
+    }>>;
+    same_path: z.ZodNumber;
+    active: z.ZodNumber;
+    exception: z.ZodNumber;
+    exceptions: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason_code: z.ZodEnum<{
+            legacy_domain_not_routed: "legacy_domain_not_routed";
+            site_context_missing: "site_context_missing";
+            site_rules_limit_exceeded: "site_rules_limit_exceeded";
+            site_rules_not_served: "site_rules_not_served";
+            target_page_unpublished: "target_page_unpublished";
+            redirect_target_missing: "redirect_target_missing";
+            redirect_write_failed: "redirect_write_failed";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "status">;
+export type MigrationRedirectProgress = z.infer<typeof MigrationRedirectProgressSchema>;
 /** Additive fields shared by the service boundary and browser adapter. */
 export declare const MigrationContentProgressSchema: z.ZodObject<{
     overall_status: z.ZodEnum<{
@@ -109,5 +159,33 @@ export declare const MigrationContentProgressSchema: z.ZodObject<{
             kind_budget_exhausted: "kind_budget_exhausted";
         }>;
     }, z.core.$strip>>;
+    redirects: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"processing">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"ready">;
+        site_reason: z.ZodNullable<z.ZodEnum<{
+            legacy_domain_not_routed: "legacy_domain_not_routed";
+            site_context_missing: "site_context_missing";
+            site_rules_limit_exceeded: "site_rules_limit_exceeded";
+            site_rules_not_served: "site_rules_not_served";
+        }>>;
+        same_path: z.ZodNumber;
+        active: z.ZodNumber;
+        exception: z.ZodNumber;
+        exceptions: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            reason_code: z.ZodEnum<{
+                legacy_domain_not_routed: "legacy_domain_not_routed";
+                site_context_missing: "site_context_missing";
+                site_rules_limit_exceeded: "site_rules_limit_exceeded";
+                site_rules_not_served: "site_rules_not_served";
+                target_page_unpublished: "target_page_unpublished";
+                redirect_target_missing: "redirect_target_missing";
+                redirect_write_failed: "redirect_write_failed";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "status">>>;
 }, z.core.$strip>;
 export type MigrationContentProgress = z.infer<typeof MigrationContentProgressSchema>;

package/dist/site-permissions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 建站范围权限：VCP 在建站流程里唯一消费的授权维度。
+ *
+ * 增长平台负责「网站建设」等菜单与按钮权限，并决定用户能否跳转过来；VCP 不重复
+ * 判定那一层，只读取当前用户在当前主站上的建站范围。方案见
+ * docs/security/2026-09-17-site-permissions-design.md。
+ */
+import { z } from "zod";
+/**
+ * none 是「1–7 和 1–8 都没选」的正常结果，不是数据缺失，也不能回落成 build。
+ */
+export declare const LauncherScopeSchema: z.ZodEnum<{
+    none: "none";
+    build: "build";
+    build_publish: "build_publish";
+}>;
+export type LauncherScope = z.infer<typeof LauncherScopeSchema>;
+export declare const SiteLauncherPermissionSchema: z.ZodObject<{
+    site_id: z.ZodUUID;
+    launcher_scope: z.ZodEnum<{
+        none: "none";
+        build: "build";
+        build_publish: "build_publish";
+    }>;
+}, z.core.$strip>;
+export type SiteLauncherPermission = z.infer<typeof SiteLauncherPermissionSchema>;
+export declare const GetSiteLauncherPermissionResponseSchema: z.ZodObject<{
+    permission: z.ZodObject<{
+        site_id: z.ZodUUID;
+        launcher_scope: z.ZodEnum<{
+            none: "none";
+            build: "build";
+            build_publish: "build_publish";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type GetSiteLauncherPermissionResponse = z.infer<typeof GetSiteLauncherPermissionResponseSchema>;
+/**
+ * 两个判断都从范围派生，不单独配置：单个布尔值分不出「未选择」和「1–7」，
+ * 所以合同保留三态。
+ */
+export declare function canEnterLauncher(scope: LauncherScope): boolean;
+export declare function canPublishSite(scope: LauncherScope): boolean;

package/dist/site-workflow.d.ts

@@ -932,6 +932,12 @@ export declare const CompleteSiteWorkflowRequestSchema: z.ZodObject<{
     expected_current_node: z.ZodLiteral<"publishing">;
 }, z.core.$strict>;
 export type CompleteSiteWorkflowRequest = z.infer<typeof CompleteSiteWorkflowRequestSchema>;
+export declare const CompleteQualityOnlyWorkflowRequestSchema: z.ZodObject<{
+    expected_current_node: z.ZodLiteral<"preview_personalization">;
+    publish_workflow_id: z.ZodUUID;
+    expected_publish_revision: z.ZodNumber;
+}, z.core.$strict>;
+export type CompleteQualityOnlyWorkflowRequest = z.infer<typeof CompleteQualityOnlyWorkflowRequestSchema>;
 export declare const RegisterWorkflowTaskRequestSchema: z.ZodObject<{
     node_code: z.ZodEnum<{
         welcome: "welcome";

package/dist/workspace-design-apply.d.ts

@@ -18,7 +18,7 @@ export declare const WorkspaceDesignApplyRequestSchema: z.ZodObject<{
 export type WorkspaceDesignApplyRequest = z.infer<typeof WorkspaceDesignApplyRequestSchema>;
 export declare const WorkspaceDesignApplyResponseSchema: z.ZodObject<{
     ok: z.ZodLiteral<true>;
-    design_plan_version: z.ZodNumber;
+    design_plan_version: z.ZodOptional<z.ZodNumber>;
     snapshot_id: z.ZodUUID;
     site_design_context: z.ZodOptional<z.ZodLazy<z.ZodObject<{
         visualDirection: z.ZodString;
@@ -78,3 +78,49 @@ export declare const WorkspaceDesignApplyResponseSchema: z.ZodObject<{
     changed_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type WorkspaceDesignApplyResponse = z.infer<typeof WorkspaceDesignApplyResponseSchema>;
+/**
+ * Response for the workspace design panel's baseline read. Reverse-derived
+ * from `app/globals.css`'s executable token block when the snapshot has one
+ * (`source: "globals_css"`); falls back to the persisted DesignPlan archive's
+ * `siteDesignContext` for older snapshots that never materialized a token
+ * block (`source: "design_plan_archive"`).
+ */
+export declare const WorkspaceDesignCurrentResponseSchema: z.ZodObject<{
+    snapshot_id: z.ZodUUID;
+    color_seeds: z.ZodNullable<z.ZodObject<{
+        primary: z.ZodString;
+        accent: z.ZodString;
+        foreground: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    surface_mode: z.ZodNullable<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>;
+    fonts: z.ZodNullable<z.ZodObject<{
+        heading: z.ZodString;
+        body: z.ZodString;
+    }, z.core.$strip>>;
+    palette_inputs_present: z.ZodBoolean;
+    palette_inputs: z.ZodNullable<z.ZodObject<{
+        primarySource: z.ZodEnum<{
+            user: "user";
+            derived: "derived";
+        }>;
+        neutral: z.ZodOptional<z.ZodString>;
+        foreground: z.ZodOptional<z.ZodString>;
+        supporting: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        imagePalette: z.ZodOptional<z.ZodObject<{
+            background: z.ZodOptional<z.ZodString>;
+            foreground: z.ZodOptional<z.ZodString>;
+            card: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodString>;
+            border: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    notes: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    source: z.ZodEnum<{
+        globals_css: "globals_css";
+        design_plan_archive: "design_plan_archive";
+    }>;
+}, z.core.$strip>;
+export type WorkspaceDesignCurrentResponse = z.infer<typeof WorkspaceDesignCurrentResponseSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcp-dev/contracts",
-  "version": "0.10.11",
+  "version": "0.10.12",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {
@@ -32,6 +32,11 @@
       "types": "./dist/design-tokens.d.ts",
       "default": "./dist/design-tokens.js"
     },
+    "./design-token-block": {
+      "development": "./src/design-token-block.ts",
+      "types": "./dist/design-token-block.d.ts",
+      "default": "./dist/design-token-block.js"
+    },
     "./colorway-distinctness": {
       "development": "./src/colorway-distinctness.ts",
       "types": "./dist/colorway-distinctness.d.ts",