@ykdz/template 0.0.37 → 0.0.40

package/node_modules/@ykdz/cli-contract/dist/stream-variant-compiler.js

@@ -0,0 +1,45 @@
+import { compileContractSchema } from "#/contract-schema-compiler";
+import { isSingleLineText } from "#/description";
+import { deepFreeze } from "#/json-value";
+export function compileStreamRecords(command, definitions, issues) {
+    const runtime = {};
+    const manifest = {};
+    const wire = {};
+    for (const [variant, definition] of Object.entries(definitions)) {
+        if (!/^[a-z][A-Za-z0-9]*$/.test(variant)) {
+            issues.push({
+                code: "invalidVariantName",
+                command,
+                location: "record",
+                variant,
+            });
+        }
+        if (!isSingleLineText(definition.description)) {
+            issues.push({
+                code: "invalidDescription",
+                command,
+                location: "record",
+                variant,
+                received: typeof definition.description === "string"
+                    ? definition.description
+                    : null,
+            });
+        }
+        const schema = compileContractSchema(definition.schema, { command, location: "record", variant }, issues, isSingleLineText(definition.description)
+            ? definition.description
+            : undefined);
+        runtime[variant] = Object.freeze({
+            description: definition.description,
+            schema: definition.schema,
+            ...("text" in definition ? { text: definition.text } : {}),
+        });
+        if (schema !== undefined) {
+            manifest[variant] = deepFreeze({
+                description: definition.description,
+                ...schema,
+            });
+            wire[variant] = deepFreeze(schema.outputSchema);
+        }
+    }
+    return deepFreeze({ runtime, manifest, wire });
+}

package/node_modules/@ykdz/cli-contract/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@ykdz/cli-contract",
+  "version": "0.2.1",
+  "description": "Framework-agnostic, executable CLI contracts for Node.js.",
+  "keywords": [
+    "cli",
+    "contract",
+    "nodejs",
+    "typescript"
+  ],
+  "homepage": "https://github.com/YKDZ/cli-contract",
+  "bugs": {
+    "url": "https://github.com/YKDZ/cli-contract/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YKDZ/cli-contract.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "imports": {
+    "#/*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.1.0",
+    "@types/node": "^24.13.4"
+  },
+  "devDependencies": {
+    "@cli-contract/typescript-config": "0.1.0",
+    "@valibot/to-json-schema": "^1.7.1",
+    "oxfmt": "^0.67.0",
+    "oxlint": "^1.82.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "typescript-7": "npm:typescript@^7.0.2",
+    "valibot": "^1.5.0",
+    "zod": "^4.5.4"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json --pretty false && node ../../scripts/link-example.ts",
+    "format:check": "oxfmt --list-different --config ../../oxfmt.config.ts .",
+    "format:write": "oxfmt --write --config ../../oxfmt.config.ts .",
+    "lint": "oxlint --quiet --format=unix --config ../../oxlint.config.ts --ignore-pattern node_modules .",
+    "lint:fix": "oxlint --format=unix --config ../../oxlint.config.ts . --fix",
+    "test": "node --test --conditions=source test/*.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false"
+  }
+}

package/node_modules/@ykdz/template-builtin-presets/dist/src/foundation.d.ts

@@ -210,6 +210,26 @@ export declare function planGeneratedRepositoryPackageAddition(options: {
     readonly packagePath?: string;
     readonly linkFrom?: readonly string[];
 }): GeneratedRepositoryPackageAdditionPlan;
+declare function collectPackageAdditionInput(options: {
+    readonly preset: string;
+    readonly packageLeafName: string;
+    readonly packagePath?: string;
+    readonly linkFrom?: readonly string[];
+}): {
+    readonly status: "input-invalid";
+    readonly issues: readonly PackageAdditionInputIssue[];
+} | {
+    readonly status: "valid";
+    readonly definition: BuiltInPresetDefinition;
+    readonly linkFrom: readonly string[];
+};
+/** 在读取仓库元数据前校验新增包调用参数，供 CLI 输入契约复用。 */
+export declare function validateGeneratedRepositoryPackageAdditionInput(options: Parameters<typeof collectPackageAdditionInput>[0]): {
+    readonly status: "valid";
+} | {
+    readonly status: "input-invalid";
+    readonly issues: readonly PackageAdditionInputIssue[];
+};
 /**
  * Command-owned preparation: user input is checked before local metadata or any
  * Preset default/planner work; all remaining failures are deliberately bounded.

package/node_modules/@ykdz/template-builtin-presets/dist/src/foundation.js

@@ -763,7 +763,27 @@ function contributedDevcontainerComposition(options) {
         toolLayers: layerPlan.layers,
         buildArguments: layerPlan.buildArguments,
         mounts: layerPlan.mounts,
-        probes: layerPlan.probes,
+        probes: [
+            ...layerPlan.probes,
+            {
+                identity: "docker-daemon",
+                command: "docker",
+                args: ["version"],
+                failureMessage: "无法连接宿主 Docker；请检查宿主 daemon 是否运行，以及开发容器 Feature 的连接配置与权限。",
+            },
+            {
+                identity: "docker-buildx",
+                command: "docker",
+                args: ["buildx", "version"],
+                failureMessage: "Buildx 不可用；请重建开发容器以完成官方 Feature 安装。",
+            },
+            {
+                identity: "docker-compose",
+                command: "docker",
+                args: ["compose", "version"],
+                failureMessage: "Compose 不可用；请重建开发容器以完成官方 Feature 安装。",
+            },
+        ],
     };
 }
 function normalizeDatabasePreparation(contributions) {
@@ -1644,33 +1664,6 @@ function deploymentCheckDevelopmentContainerToolLayers(deploymentCheck) {
                 },
             ],
         },
-        {
-            identity: "docker-client",
-            dockerfile: deploymentCheck.sources.dockerClientToolLayer,
-            requires: ["node-pnpm"],
-            mounts: [
-                {
-                    identity: "docker-socket",
-                    type: "bind",
-                    source: "/var/run/docker.sock",
-                    target: "/var/run/docker.sock",
-                },
-            ],
-            probes: [
-                {
-                    identity: "docker-cli",
-                    command: "docker",
-                    args: ["--version"],
-                    failureMessage: "Docker CLI is unavailable; rebuild the Development Container to install the Docker Client Tool Layer.",
-                },
-                {
-                    identity: "docker-daemon",
-                    command: "docker",
-                    args: ["version"],
-                    failureMessage: "Docker daemon is inaccessible through /var/run/docker.sock; verify the host daemon is running and the standard socket is accessible.",
-                },
-            ],
-        },
     ];
 }
 function normalizeRustToolchain(contributions) {
@@ -1698,6 +1691,7 @@ function normalizeRustToolchain(contributions) {
 function composeDependencyMaintenancePolicy(contributions, deploymentCheck) {
     const ecosystems = [
         ...new Set([
+            "devcontainers",
             ...contributions.flatMap((contribution) => contribution.foundation.dependencyMaintenance.ecosystems),
             ...(deploymentCheck === undefined ? [] : ["docker"]),
         ]),
@@ -3369,6 +3363,11 @@ function collectPackageAdditionInput(options) {
     }
     return { status: "valid", definition, linkFrom };
 }
+/** 在读取仓库元数据前校验新增包调用参数，供 CLI 输入契约复用。 */
+export function validateGeneratedRepositoryPackageAdditionInput(options) {
+    const result = collectPackageAdditionInput(options);
+    return result.status === "input-invalid" ? result : { status: "valid" };
+}
 /**
  * Command-owned preparation: user input is checked before local metadata or any
  * Preset default/planner work; all remaining failures are deliberately bounded.

package/node_modules/@ykdz/template-builtin-presets/dist/src/generation-record.d.ts

@@ -1,4 +1,5 @@
 import type { PackageDefinitionId } from "@ykdz/template-core/project-blueprint";
+import * as v from "valibot";
 export type GeneratedPackagePlanningRecord = {
     readonly packageDefinitionId: PackageDefinitionId;
     readonly path: string;
@@ -25,6 +26,24 @@ export type GenerationRecord = {
 };
 /** Canonical durable Generation Record contract for a default npm scope. */
 export declare function isValidDefaultPackageScope(value: string): boolean;
+export declare const generationRecordSchema: v.StrictObjectSchema<{
+    readonly schemaVersion: v.LiteralSchema<2, (issue: v.LiteralIssue) => string>;
+    readonly repositoryName: v.StringSchema<"repositoryName must be a non-empty string">;
+    readonly defaultPackageScope: v.StringSchema<"defaultPackageScope must be a valid npm scope">;
+    readonly preset: v.StringSchema<"preset must be a non-empty string">;
+    readonly templateVersion: v.LiteralSchema<"0.0.0", "templateVersion must be 0.0.0">;
+    readonly toolchain: v.StrictObjectSchema<{
+        readonly nodeLtsMajor: v.StringSchema<"toolchain.nodeLtsMajor must be a numeric Node major">;
+        readonly packageManagerPin: v.StringSchema<"toolchain.packageManagerPin must be an exact pnpm version pin">;
+    }, (issue: v.StrictObjectIssue) => string>;
+    readonly packages: v.ArraySchema<v.StrictObjectSchema<{
+        readonly packageDefinitionId: v.StringSchema<"packageDefinitionId must use the package-<sha256> format">;
+        readonly path: v.StringSchema<"path must be a non-empty string">;
+        readonly definitionName: v.StringSchema<"definitionName must be a non-empty string">;
+        readonly planningContribution: v.PicklistSchema<["foundationPlan", "planInitialization", "planPackageAddition"], "planningContribution is unsupported">;
+        readonly contributionIdentity: v.StringSchema<"contributionIdentity must be a non-empty string">;
+    }, (issue: v.StrictObjectIssue) => string>, "packages must be an array">;
+}, (issue: v.StrictObjectIssue) => string>;
 /** Strictly decodes the durable Record shape before semantic checks run. */
 export declare function decodeGenerationRecordStructure(value: unknown): GenerationRecord;
 /** Validates semantic invariants that are independent of a Project Blueprint. */

package/node_modules/@ykdz/template-builtin-presets/dist/src/generation-record.js

@@ -23,7 +23,7 @@ const packagePlanningRecordSchema = v.strictObject({
     planningContribution: v.picklist(["foundationPlan", "planInitialization", "planPackageAddition"], "planningContribution is unsupported"),
     contributionIdentity: v.string("contributionIdentity must be a non-empty string"),
 }, (issue) => strictObjectMessage(issue, "package planning fact must be an object"));
-const generationRecordSchema = v.strictObject({
+export const generationRecordSchema = v.strictObject({
     schemaVersion: v.literal(2, (issue) => `Unsupported Generation Record schema version ${String(issue.input)}; expected 2`),
     repositoryName: v.string("repositoryName must be a non-empty string"),
     defaultPackageScope: v.string("defaultPackageScope must be a valid npm scope"),

package/node_modules/@ykdz/template-builtin-presets/dist/src/index.d.ts

@@ -1,3 +1,4 @@
-export { builtInPresetRegistry, createGenerationContext, loadLocalTemplateMetadata, prepareGeneratedRepositoryPackageAddition, validateGeneratedRepositoryInitializationInput, prepareGeneratedRepositoryInitialization, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, readRustToolchainChannelFromToml, resolveBuiltInTemplateSource, validateProjectBlueprint, } from "./foundation.ts";
+export { builtInPresetRegistry, createGenerationContext, loadLocalTemplateMetadata, prepareGeneratedRepositoryPackageAddition, validateGeneratedRepositoryInitializationInput, validateGeneratedRepositoryPackageAdditionInput, prepareGeneratedRepositoryInitialization, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, readRustToolchainChannelFromToml, resolveBuiltInTemplateSource, validateProjectBlueprint, } from "./foundation.ts";
 export { templateSources } from "./template-sources.ts";
+export { generationRecordSchema } from "./generation-record.ts";
 export type { BuiltInPresetDefinition, GeneratedRepositoryPlan, PackageContribution, ProjectBlueprint, BuiltInGenerationContext, LocalTemplateMetadata, InitializationIdentityOverrides, InitializationInputIssue, InitializationInputValidation, InitializationPreparation, PackageAdditionBusinessConflict, PackageAdditionInputIssue, PackageAdditionPreparation, NextStepInstruction, PublicationSetupHandoff, ResolvedInitialization, RustToolchainChannelReading, } from "./foundation.ts";

package/node_modules/@ykdz/template-builtin-presets/dist/src/index.js

@@ -1,2 +1,3 @@
-export { builtInPresetRegistry, createGenerationContext, loadLocalTemplateMetadata, prepareGeneratedRepositoryPackageAddition, validateGeneratedRepositoryInitializationInput, prepareGeneratedRepositoryInitialization, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, readRustToolchainChannelFromToml, resolveBuiltInTemplateSource, validateProjectBlueprint, } from "./foundation.js";
+export { builtInPresetRegistry, createGenerationContext, loadLocalTemplateMetadata, prepareGeneratedRepositoryPackageAddition, validateGeneratedRepositoryInitializationInput, validateGeneratedRepositoryPackageAdditionInput, prepareGeneratedRepositoryInitialization, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, readRustToolchainChannelFromToml, resolveBuiltInTemplateSource, validateProjectBlueprint, } from "./foundation.js";
 export { templateSources } from "./template-sources.js";
+export { generationRecordSchema } from "./generation-record.js";

package/node_modules/@ykdz/template-builtin-presets/dist/src/ts-cli/definition.js

@@ -91,8 +91,8 @@ function cliContribution(options) {
         {
             kind: "copyFile",
             source: templateSources.tsCli,
-            from: "test/unit/greet.test.ts",
-            to: `${definition.path}/test/unit/greet.test.ts`,
+            from: "src/standard-schema.ts",
+            to: `${definition.path}/src/standard-schema.ts`,
         },
         {
             kind: "copyFile",
@@ -121,8 +121,8 @@ function cliContribution(options) {
         {
             kind: "copyFile",
             source: templateSources.tsCli,
-            from: "test/e2e/journeys/greet.journey.ts",
-            to: `${definition.path}/test/e2e/journeys/greet.journey.ts`,
+            from: "test/e2e/journeys/lookup.journey.ts",
+            to: `${definition.path}/test/e2e/journeys/lookup.journey.ts`,
         },
     ];
     return {
@@ -135,7 +135,11 @@ function cliContribution(options) {
             type: "module",
             bin: { [options.packageLeafName]: "./dist/cli.js" },
             scripts: packageScripts(),
-            dependencies: { commander: "catalog:" },
+            dependencies: {
+                "@ykdz/cli-contract": "catalog:",
+                "@valibot/to-json-schema": "catalog:",
+                valibot: "catalog:",
+            },
             devDependencies: {
                 "@types/node": "catalog:",
                 oxfmt: "catalog:",

package/node_modules/@ykdz/template-builtin-presets/dist/src/vike-app/definition.js

@@ -290,10 +290,6 @@ function webContribution(context, packageDefinitions = definitions(context)) {
                         source: templateSources.vikeApp,
                         from: "devcontainer/shellcheck.Dockerfile",
                     },
-                    dockerClientToolLayer: {
-                        source: templateSources.vikeApp,
-                        from: "devcontainer/docker-client.Dockerfile",
-                    },
                 },
             },
             developmentContainerToolLayers: [

package/node_modules/@ykdz/template-builtin-presets/package.json

@@ -47,11 +47,12 @@
     "@types/semver": "catalog:",
     "@types/spdx-expression-parse": "catalog:",
     "@types/web-bluetooth": "catalog:",
+    "@valibot/to-json-schema": "catalog:",
     "@vikejs/hono": "catalog:",
     "@vitejs/plugin-vue": "catalog:",
     "@vue/devtools-api": "catalog:",
     "@vue/tsconfig": "catalog:",
-    "commander": "catalog:",
+    "@ykdz/cli-contract": "catalog:",
     "drizzle-kit": "catalog:",
     "drizzle-orm": "catalog:",
     "execa": "catalog:",

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/AGENTS.md.template

@@ -1,11 +1,17 @@
-# 工作约定
+### 本地代理上下文
 
-- 开发自动化：非临时维护脚本必须使用 `scripts/**/*.ts` 中可擦除的 TypeScript，而不是 `.mjs` 等 JavaScript 脚本（Node 24 支持原生直接执行）；归所属非构建 TypeScript 项目并受 format、lint、typecheck 覆盖，防止腐化；产品 build 不产出这些脚本。普通 Node 自动化使用原生 TypeScript 执行链。
+`AGENTS.md`、`.agents/`、`docs/`、`.scratch/`、`.codex/`、`GLOSSARY*.md` 及其他代理本地规划或上下文文件均为本地工作区输入，不得纳入 Git 跟踪，也不得在 `.gitignore` 中为它们添加例外。
+
+### 工作约定
+
+若这些限制与 Spec、Ticket、ADR 等权威本地文档冲突，应该以权威本地文档为准。
+
+- 开发自动化：非临时维护脚本必须使用 `scripts/**/*.ts` 中可擦除的 TypeScript，而不是 `.mjs` 等 JavaScript 脚本；归所属非构建 TypeScript 项目并受 format、lint、typecheck 覆盖，防止腐化；产品 build 不产出这些脚本。普通 Node 自动化使用原生 TypeScript 执行链。
 - 临时脚本：编写临时脚本时，应该将其放到有临时目录语义的位置
-- 任务归属：优先使用工具原生配置；直接命令与简单 `&&` 编排写在所属 package manifest；只有自定义类型化行为才新增 TypeScript script
+- 任务归属：优先使用工具原生配置；直接命令与简单 `&&` 编排写在所属 package manifest；只有复杂逻辑才新增 TypeScript script
 - 包边界：本地文件系统访问留在所属包内；跨包代码与资源通过声明依赖和公开 exports 获取，跨包任务交根 Turbo/pnpm 编排。不要以根目录定位器、跨包物理路径或 `@boundaries-ignore` 绕过边界
 - 最小充分测试：不要过度编写单元测试，包括为硬删除设计的防回归测试（可以临时存在，但是硬删除完成后必须删除，最好放在可丢弃分支中方便清理）、为文档内容或任何文件编写的存在性测试等，确保测试覆盖且仅覆盖业务逻辑本身的正负项
 - YAGNI：除非有明确目的，否则不要规划收益不足的安全边界等内容。简单的代码在未来真的遇到新需求时，重构起来远比一个充满防御性冗余设计的复杂系统要容易得多
 - 正式处理链路：开发、回放和端到端验收应复用生产的正式处理链路与制品，入口和配置可不同；同类流程只保留一份实现，迁移后删除旧链路，局部测试不得冒充全链路验收
 - 用户界面：不要将任何技术细节泄漏到用户可见的 UI 中
-- 完成条件：先通过改动相关的局部门禁，交付前再通过根 `pnpm check`
+- 逐步验收：先通过改动相关的局部门禁，交付前再执行较重的验收任务

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/devcontainer.json

@@ -6,6 +6,9 @@
       "NODE_VERSION": "{{NODE_VERSION}}"
     }
   },
+  "features": {
+    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {}
+  },
   "customizations": {
     "vscode": {
       "extensions": ["oxc.oxc-vscode"]

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/publication/artifact.ts

@@ -17,11 +17,44 @@ import { pathToFileURL } from "node:url";
 import { validRange } from "semver";
 import { list } from "tar";
 
+import { hasLookupEvidence, hasSchemaEvidence } from "./handoff.ts";
 import {
   inspectNpmPublicationReadiness,
   type NpmPublicationReadiness,
 } from "./readiness.ts";
 
+function hasUsageFailure(source: string): boolean {
+  try {
+    const value: unknown = JSON.parse(source);
+    return (
+      isObject(value) &&
+      value.schemaVersion === "1" &&
+      value.kind === "usageFailure" &&
+      Array.isArray(value.issues) &&
+      value.issues.length > 0
+    );
+  } catch {
+    return false;
+  }
+}
+
+function hasNotFoundFailure(source: string): boolean {
+  try {
+    const value: unknown = JSON.parse(source);
+    return (
+      isObject(value) &&
+      value.schemaVersion === "1" &&
+      value.command === "lookup" &&
+      value.kind === "failure" &&
+      value.variant === "notFound" &&
+      isObject(value.data) &&
+      value.data.name === "missing"
+    );
+  } catch {
+    return false;
+  }
+}
+
 type JsonObject = Record<string, unknown>;
 
 export type PublicationArtifactFailureCode =
@@ -96,8 +129,13 @@ export type VerifiedPublicationArtifactReceipt = {
       readonly stdout: string;
     },
     {
-      readonly name: "greet";
-      readonly args: readonly ["greet", "  Ada Lovelace  "];
+      readonly name: "lookup";
+      readonly args: readonly ["lookup", "ada"];
+      readonly stdout: string;
+    },
+    {
+      readonly name: "schema";
+      readonly args: readonly ["schema"];
       readonly stdout: string;
     },
   ];
@@ -158,6 +196,7 @@ const expectedFiles = [
   "package/dist/cli-command-identity.js",
   "package/dist/cli.js",
   "package/dist/main.js",
+  "package/dist/standard-schema.js",
   "package/package.json",
 ] as const;
 
@@ -546,10 +585,15 @@ export function inspectPackedManifestContract(options: {
     bin[readiness.publication.commandName] === "./dist/cli.js";
   const exactDependencies =
     isObject(dependencies) &&
-    Object.keys(dependencies).length === 1 &&
-    typeof dependencies.commander === "string" &&
-    dependencies.commander.length > 0 &&
-    validRange(dependencies.commander) !== null;
+    ["@ykdz/cli-contract", "@valibot/to-json-schema", "valibot"].every(
+      (name) =>
+        typeof dependencies[name] === "string" &&
+        validRange(dependencies[name]) !== null,
+    ) &&
+    Object.values(dependencies).every(
+      (specifier) =>
+        typeof specifier === "string" && validRange(specifier) !== null,
+    );
   const validPublishConfig =
     publishConfig === undefined ||
     (isObject(publishConfig) &&
@@ -736,7 +780,7 @@ async function smokeCommand(options: {
   readonly env: NodeJS.ProcessEnv;
 }): Promise<CommandResult | PublicationArtifactFailure> {
   const result = await runCommand(options);
-  return result.exitCode === 0
+  return result.exitCode === 0 && result.stderr === ""
     ? result
     : commandFailure(
         "consumer-smoke-failed",
@@ -1032,8 +1076,9 @@ export async function verifyNpmPublicationArtifact(options: {
     }
     const helpArgs = ["--help"] as const;
     const versionArgs = ["--version"] as const;
-    const greetArgs = ["greet", "  Ada Lovelace  "] as const;
-    const invalidGreetArgs = ["greet", "   "] as const;
+    const lookupArgs = ["lookup", "ada"] as const;
+    const schemaArgs = ["schema"] as const;
+    const invalidLookupArgs = ["lookup", "   "] as const;
     const helpCommand = planInstalledBinCommand({
       platform: process.platform,
       binPath,
@@ -1066,81 +1111,104 @@ export async function verifyNpmPublicationArtifact(options: {
       result = { kind: "failed", failure: version };
       return result;
     }
-    const greetCommand = planInstalledBinCommand({
+    const lookupCommand = planInstalledBinCommand({
       platform: process.platform,
       binPath,
-      args: greetArgs,
+      args: lookupArgs,
       environment: childEnvironment,
     });
-    const greet = await smokeCommand({
-      executable: greetCommand.executable,
-      args: greetCommand.args,
+    const lookup = await smokeCommand({
+      executable: lookupCommand.executable,
+      args: lookupCommand.args,
       cwd: consumerDirectory,
-      env: greetCommand.environment,
+      env: lookupCommand.environment,
     });
-    if ("code" in greet) {
-      result = { kind: "failed", failure: greet };
-      return result;
-    }
-    if (
-      !help.stdout.includes(`Usage: ${readiness.publication.commandName}`) ||
-      !help.stdout.includes("greet") ||
-      version.stdout !== `${readiness.publication.version}\n` ||
-      greet.stdout !== "Hello, Ada Lovelace\n"
-    ) {
-      result = {
-        kind: "failed",
-        failure: failure(
-          "consumer-smoke-failed",
-          JSON.stringify({
-            help: help.stdout,
-            version: version.stdout,
-            greet: greet.stdout,
-          }),
-          "Installed help, exact version, and greet behavior",
-          "Correct the packed command identity or behavior and retry.",
-        ),
-      };
+    if ("code" in lookup) {
+      result = { kind: "failed", failure: lookup };
       return result;
     }
-    const invalidGreetCommand = planInstalledBinCommand({
+    const schemaCommand = planInstalledBinCommand({
       platform: process.platform,
       binPath,
-      args: invalidGreetArgs,
+      args: schemaArgs,
       environment: childEnvironment,
     });
-    const invalidGreet = await runCommand({
-      executable: invalidGreetCommand.executable,
-      args: invalidGreetCommand.args,
+    const schema = await smokeCommand({
+      executable: schemaCommand.executable,
+      args: schemaCommand.args,
       cwd: consumerDirectory,
-      env: invalidGreetCommand.environment,
+      env: schemaCommand.environment,
     });
+    if ("code" in schema) {
+      result = { kind: "failed", failure: schema };
+      return result;
+    }
     if (
-      invalidGreet.exitCode !== 1 ||
-      invalidGreet.stdout !== "" ||
-      !invalidGreet.stderr.startsWith("error: Name must not be empty\n")
+      !help.stdout.includes(readiness.publication.commandName) ||
+      !help.stdout.includes("lookup") ||
+      !help.stdout.includes("schema") ||
+      version.stdout !==
+        `${readiness.publication.commandName} ${readiness.publication.version}\n` ||
+      !hasLookupEvidence(lookup.stdout) ||
+      !hasSchemaEvidence(schema.stdout, readiness.publication.commandName)
     ) {
       result = {
         kind: "failed",
         failure: failure(
           "consumer-smoke-failed",
           JSON.stringify({
-            args: invalidGreetArgs,
-            exitCode: invalidGreet.exitCode,
-            stdout: invalidGreet.stdout,
-            stderr: invalidGreet.stderr,
+            help: help.stdout,
+            version: version.stdout,
+            lookup: lookup.stdout,
           }),
-          "Installed greet with a blank name to exit 1 with the stable validation error and no stdout",
-          "Correct the packed command validation behavior and retry.",
-          {
-            executable: invalidGreetCommand.executable,
-            args: invalidGreetCommand.args,
-            exitCode: invalidGreet.exitCode,
-          },
+          "安装后的帮助、实际版本、lookup 查询及完整 schema 契约",
+          "修正制品中的命令身份或行为后重试。",
         ),
       };
       return result;
     }
+    for (const scenario of [
+      {
+        args: [...invalidLookupArgs, "--output-format", "text"],
+        exitCode: 2,
+        accepts: hasUsageFailure,
+      },
+      { args: ["lookup", "missing"], exitCode: 1, accepts: hasNotFoundFailure },
+    ]) {
+      const command = planInstalledBinCommand({
+        platform: process.platform,
+        binPath,
+        args: scenario.args,
+        environment: childEnvironment,
+      });
+      const observed = await runCommand({
+        executable: command.executable,
+        args: command.args,
+        cwd: consumerDirectory,
+        env: command.environment,
+      });
+      if (
+        observed.exitCode !== scenario.exitCode ||
+        observed.stdout !== "" ||
+        !scenario.accepts(observed.stderr)
+      ) {
+        result = {
+          kind: "failed",
+          failure: failure(
+            "consumer-smoke-failed",
+            JSON.stringify(observed),
+            "非法输入应退出 2，未找到记录应退出 1；均通过 stderr 返回原生结果。",
+            "修正安装后命令的失败协议并重试。",
+            {
+              executable: command.executable,
+              args: command.args,
+              exitCode: observed.exitCode,
+            },
+          ),
+        };
+        return result;
+      }
+    }
 
     const artifactBytes = await readFile(packedArtifactPath);
     const digest = createHash("sha512").update(artifactBytes).digest();
@@ -1181,7 +1249,8 @@ export async function verifyNpmPublicationArtifact(options: {
         { name: "runtime-import", args: [], stdout: "" },
         { name: "help", args: helpArgs, stdout: help.stdout },
         { name: "version", args: versionArgs, stdout: version.stdout },
-        { name: "greet", args: greetArgs, stdout: greet.stdout },
+        { name: "lookup", args: lookupArgs, stdout: lookup.stdout },
+        { name: "schema", args: schemaArgs, stdout: schema.stdout },
       ],
     };
     try {