@agile-team/wl-skills-ui 1.20.0 → 1.20.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.20.1] - 2026-10-11
+
+- 修复 task 在版本漂移后旧顶层 status/ready 与嵌套 decision、notice、公开协议准入不一致；从校正后的记录生成旧字段，gap 始终 ready=false。
+- task/route/explain/status 的旧顶层 ready 复用公开结果核心判定，并核对当前适用 scope；缺资产、歧义、未接入/移动项目、缺上下文或计划过期均不准入。
+- 增加真实 CLI 和协议版本漂移、恢复后重判、缺口/范围/新鲜度回归；ready 不证明宿主读取、代码执行或业务验证通过。
+
 ## [1.20.0] - 2026-10-11
 
 - scan 严格校验已注册规则、范围与参数，CLI/MCP 使用同源选择器；非法请求零检查零任务记录。

package/README.md

@@ -2,7 +2,7 @@
 
 > 项目范围：只对目标自身已接入且平台适用的项目判定规则；父工作区安装不启用子项目。移动端与未接入开源项目不套用。详见 [精准触发与范围配置](docs/project-scope.md)。
 
-**企业级 UI 一致性与 AI 精确治理工具包 v1.17.0** — 面向 Vue 3 + Element Plus 的设计令牌、能力 Profile、样式皮肤、页面骨架、运行时能力、静态扫描、确定性修复、AI Skill、MCP 与脱敏 UI 模板契约。
+**企业级 UI 一致性与 AI 精确治理工具包 v1.20.1** — 面向 Vue 3 + Element Plus 的设计令牌、能力 Profile、样式皮肤、页面骨架、运行时能力、静态扫描、确定性修复、AI Skill、MCP 与脱敏 UI 模板契约。
 
 它把“视觉统一、问题识别、机械修复、项目适配和样例沉淀”拆成可验证、可组合的工程能力。脚本、规则和 MCP 先完成确定性工作，AI 只处理业务语义与人工决策，从而减少重复读源码、上下文 token 和误修改。
 
@@ -17,6 +17,8 @@
 
 `wl-ui doctor-host --json` 对比已分发规范、本地执行器和正在运行的版本，漂移会显式报告。规范更新不会替代依赖升级：同步本包依赖、锁文件和受管入口；未使用的兄弟包无需安装。重开/刷新宿主加载后仍需观察真实任务调用，不能宣称所有 AI 自动触发。
 
+`task/route/explain/status` 的旧顶层 `ready` 与公开协议的 `result.integration.ready` 表示本次工作流的有效就绪状态：当前项目必须已接入且 `scope=applicable`，判定为 matched/baseline，所需资产完整、版本没有已知漂移、计划尚未过期。gap、歧义、缺上下文、未接入/移动项目均为 false，不能只因规范文件存在就称 ready。漂移时旧顶层 task 的 status/ready 与嵌套 decision、notice 保持一致；状态回查以当前 scope 和新鲜度为准。ready=true 不证明宿主读取、自动检查权限、工具执行或业务验证通过，执行仍需核对动作许可和 allowedExecutors。
+
 ## 你能获得什么
 
 | 目标 | 包提供的能力 | 带来的效果 |
@@ -510,7 +512,7 @@ npx wl-ui doctor --project . --print-overrides
 
 ## 版本与进一步阅读
 
-当前 v1.20.0：公开集成协议 describe/request 统一信封（能力清单与路由语料经真实打包产物验证）、输入校验收口与 MCP 目录对齐真实 tools/list。v1.15.0：任务判定、真实执行/验证回执、实际检查范围和过期检测；Codex 原生薄入口按需加载 canonical Skill。确定性路由覆盖已发布目录与显式缺口，不保证识别所有自然语言。v1.14.0：明确独立能力边界，安装、更新、清理按本包贡献保护用户及其他包内容；共享文件采用单文件原子替换，支持历史路由与 `.clinerules` 目录迁移。v1.13.2：R044 审查多列表单超宽标签，R040 识别自定义 `stepper`，均供人工复核。v1.13.0：新增 `native-jh-ag` Profile、显式 Profile 兼容承诺与联邦 AG 依赖识别。
+当前 v1.20.1：公开集成协议 describe/request 统一信封（能力清单与路由语料经真实打包产物验证）、输入校验收口与 MCP 目录对齐真实 tools/list。v1.15.0：任务判定、真实执行/验证回执、实际检查范围和过期检测；Codex 原生薄入口按需加载 canonical Skill。确定性路由覆盖已发布目录与显式缺口，不保证识别所有自然语言。v1.14.0：明确独立能力边界，安装、更新、清理按本包贡献保护用户及其他包内容；共享文件采用单文件原子替换，支持历史路由与 `.clinerules` 目录迁移。v1.13.2：R044 审查多列表单超宽标签，R040 识别自定义 `stepper`，均供人工复核。v1.13.0：新增 `native-jh-ag` Profile、显式 Profile 兼容承诺与联邦 AG 依赖识别。
 
 - [版本摘要](docs/version-history.md)
 - [完整 Changelog](CHANGELOG.md)

package/bin/__tests__/readiness-compatibility.test.mjs

@@ -0,0 +1,133 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import {spawnSync} from "node:child_process";
+
+const repo = path.resolve(import.meta.dirname, '../..');
+const pkg = JSON.parse(fs.readFileSync(path.join(repo, "package.json"), "utf8"));
+const cli = path.join(repo, "bin", 'wl-ui.js');
+const key = 'ui';
+const manifestName = key === "kit" ? ".wl-skills-manifest.json" : ".wl-skills-ui-manifest.json";
+const selected = "src/views/Example/index.vue";
+
+function fixture() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), `wl-${key}-ready-`));
+  fs.writeFileSync(path.join(root, "package.json"), JSON.stringify({private: true, devDependencies: {[pkg.name]: pkg.version, vue: "^3.4.0"}}));
+  fs.mkdirSync(path.join(root, "node_modules/@agile-team"), {recursive: true});
+  fs.symlinkSync(repo, path.join(root, "node_modules", pkg.name), "dir");
+  fs.mkdirSync(path.dirname(path.join(root, selected)), {recursive: true});
+  fs.writeFileSync(path.join(root, selected), "<template><div>example</div></template>\n");
+  const initialized = spawnSync(process.execPath, [cli, "init", ...(key === "ui" ? ["--editor", "all", "--profile", "native-element"] : [])], {cwd: root, encoding: "utf8", timeout: 30000});
+  assert.equal(initialized.status, 0, initialized.stderr || initialized.stdout);
+  return root;
+}
+
+function request(root, transport, operation, input = {}) {
+  let args;
+  if (transport === "protocol") {
+    const file = path.join(root, "request.json");
+    fs.writeFileSync(file, JSON.stringify({operation, projectRoot: root, ...input}));
+    args = ["protocol", "request", "--input-file", file, "--json"];
+  } else {
+    args = [operation, ...(input.task ? [input.task] : []), ...(input.targets || []).flatMap(target => ["--target", target]), ...(input.runId ? ["--run-id", input.runId] : []), "--json"];
+  }
+  const processResult = spawnSync(process.execPath, [cli, ...args], {cwd: root, encoding: "utf8", timeout: 30000});
+  assert.equal(processResult.status, 0, processResult.stderr || processResult.stdout);
+  const result = JSON.parse(processResult.stdout);
+  if (transport === "protocol") {assert.equal(result.ok, true);return result.result;}
+  return result;
+}
+
+function readiness(result, ready, status, runtime) {
+  const decision = result.decision || result;
+  assert.equal(result.ready, ready, "legacy ready must express effective admission");
+  if (status) assert.equal(decision.status, status);
+  if (result.status && result.decision) assert.equal(result.status, decision.status, "flattened task status agrees with its recorded decision");
+  if (runtime) assert.equal(result.notice.runtime.status, runtime);
+  if (result.integration) {
+    assert.equal(result.integration.ready, ready);
+    if (!ready) assert.deepEqual(result.integration.allowedExecutors, []);
+  }
+}
+
+test("legacy 与公开协议：真实版本漂移拒绝且 task/status/route/explain 的 ready 一致", () => {
+  const root = fixture();
+  try {
+    for (const transport of ["legacy", "protocol"]) {
+      for (const operation of ["route", "explain", "task"]) {
+        const input = {task: "检查当前 Vue 代码", targets: [selected], ...(operation === "task" ? {runId: `aligned-${transport}`} : {})};
+        readiness(request(root, transport, operation, input), true, "baseline", "aligned");
+      }
+      readiness(request(root, transport, "status", {runId: `aligned-${transport}`}), true, "baseline", "aligned");
+    }
+    const manifest = path.join(root, manifestName);
+    const bytes = fs.readFileSync(manifest);
+    const old = JSON.parse(bytes);old.version = key === "kit" ? "2.30.0" : "1.19.0";
+    fs.writeFileSync(manifest, JSON.stringify(old));
+    for (const transport of ["legacy", "protocol"]) {
+      for (const operation of ["route", "explain", "task"]) {
+        const input = {task: "检查当前 Vue 代码", targets: [selected], ...(operation === "task" ? {runId: `drift-${transport}`} : {})};
+        const result = request(root, transport, operation, input);
+        readiness(result, false, "gap", "mismatch");
+        assert.equal((result.decision || result).scope.status, "applicable");
+        assert.ok((result.decision || result).gaps.some(gap => gap.code === "runtime-mismatch"));
+      }
+      readiness(request(root, transport, "status", {runId: `aligned-${transport}`}), false, "gap", "mismatch");
+      readiness(request(root, transport, "status", {runId: `drift-${transport}`}), false, "gap", "mismatch");
+    }
+    fs.writeFileSync(manifest, bytes);
+    readiness(request(root, "protocol", "task", {task: "检查当前 Vue 代码", targets: [selected], runId: "replanned"}), true, "baseline", "aligned");
+    readiness(request(root, "protocol", "status", {runId: "replanned"}), true, "baseline", "aligned");
+  } finally {fs.rmSync(root, {recursive: true, force: true});}
+});
+
+test("规则资产存在不能替代适用scope、无歧义与计划新鲜度", () => {
+  const root = fixture();
+  try {
+    for (const transport of ["legacy", "protocol"]) {
+      readiness(request(root, transport, "route", {task: "帮我写诗"}), false, "not-applicable");
+      readiness(request(root, transport, "route", {task: "闲聊"}), false, "needs-context");
+      readiness(request(root, transport, "route", {task: key === "kit" ? "创建页面并自动修复" : "检查表格和表单", targets: [selected]}), false, "ambiguous");
+      readiness(request(root, transport, "status", {runId: "absent"}), false);
+    }
+    const owned = key === "kit" ? path.join(root, ".wl-skills/standards/03-comments.md") : path.join(root, "node_modules", pkg.name);
+    const bytes = key === "kit" ? fs.readFileSync(owned) : null;
+    fs.unlinkSync(owned);
+    for (const transport of ["legacy", "protocol"]) {
+      const result = request(root, transport, "route", {task: "检查当前 Vue 代码", targets: [selected]});
+      readiness(result, false, "gap");
+      assert.ok((result.decision || result).missingInputs.length > 0);
+    }
+    if (key === "kit") fs.writeFileSync(owned, bytes);
+    else fs.symlinkSync(repo, owned, "dir");
+    readiness(request(root, "legacy", "task", {task: "检查当前 Vue 代码", targets: [selected], runId: "freshness"}), true, "baseline");
+    fs.appendFileSync(path.join(root, selected), "<!-- modified after inspect plan -->\n");
+    for (const transport of ["legacy", "protocol"]) {
+      const result = request(root, transport, "status", {runId: "freshness"});
+      assert.equal(result.planStale, true);readiness(result, false, "baseline");
+    }
+    fs.writeFileSync(path.join(root, ".wl-skills-scope.json"), JSON.stringify({schemaVersion: 1, projectType: "pc", packages: {[key]: false}}));
+    for (const transport of ["legacy", "protocol"]) {
+      const result = request(root, transport, "status", {runId: "freshness"});
+      assert.equal(result.currentScope.status, "not-applicable");readiness(result, false);
+      readiness(request(root, transport, "task", {task: "检查当前 Vue 代码", targets: [selected], runId: "disabled"}), false, "not-applicable");
+    }
+  } finally {fs.rmSync(root, {recursive: true, force: true});}
+});
+
+test("未接入和移动项目即使有Vue任务对象也不准入，不新建任务记录", () => {
+  for (const mobile of [false, true]) {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), `wl-${key}-excluded-`));
+    try {
+      fs.writeFileSync(path.join(root, "package.json"), JSON.stringify({private: true, devDependencies: {vue: "^3.4.0", ...(mobile ? {[pkg.name]: pkg.version, "@dcloudio/uni-app": "*"} : {})}}));
+      for (const transport of ["legacy", "protocol"]) {
+        const result = request(root, transport, "task", {task: "检查当前 Vue 代码", targets: [selected], runId: "excluded"});
+        readiness(result, false, "not-applicable");
+        assert.deepEqual(result.requiredRules, []);
+      }
+      assert.equal(fs.existsSync(path.join(root, key === "kit" ? ".wl-skills/runs" : ".wl-skills-ui/runs")), false);
+    } finally {fs.rmSync(root, {recursive: true, force: true});}
+  }
+});

package/bin/task-integration.mjs

@@ -4,6 +4,7 @@ import { parseArgs } from "node:util";
 import core from "./task-observability.cjs";
 import projectScope from "./project-scope.cjs";
 import taskIntent from "./task-intent.cjs";
+import resultCore from "./integration-result.cjs";
 import { GATEWAY_PATH } from "./task-gateway.mjs";
 import { resolveProjectProfile } from "../standards/profiles-loader.mjs";
 import { getRules } from "../scanner/rules/index.mjs";
@@ -78,9 +79,9 @@ function capabilityGap(decision, reason) {
 export function runTaskAction(action, input = {}) {
   const resolved = projectScope.resolveScope({ projectRoot: input.projectRoot || process.env.WL_PROJECT_ROOT || process.cwd(), packageName: pkg.name, targets: input.targets || [] });
   const opts = taskOptions(resolved.projectRoot, { runId: input.runId, targets: resolved.targets });
-  if (action === "status") return core.readStatus(opts);
+  if (action === "status") return taskResultReadiness(core.readStatus(opts), opts);
   if (action === "doctor-host") return hostDiagnostic({ ...opts, host: input.host || "unknown" });
-  if (resolved.scope.status !== "applicable") return core.attachNotice(projectScope.excludedDecision(resolved.scope), opts);
+  if (resolved.scope.status !== "applicable") return taskResultReadiness(core.attachNotice(projectScope.excludedDecision(resolved.scope), opts), opts);
   const profile = resolveProjectProfile({ projectRoot: opts.projectRoot, profile: input.profile }).profile;
   const routed = decideTask({ task: input.task || "", targets: opts.targets, skill: input.skill, context: input.context });
   const applicable = getRules({ profile: profile.id });
@@ -90,8 +91,14 @@ export function runTaskAction(action, input = {}) {
   decision.requiredRules = decision.requiredRules.filter((id) => enabled.has(id));
   decision.ruleDetails = applicable.filter((rule) => decision.requiredRules.includes(rule.id)).map((rule) => ({ id: rule.id, name: rule.title, source: `node_modules/${pkg.name}/standards/rules.json` }));
   assetReadiness(decision, opts.projectRoot);
-  if (action !== "task") return core.attachNotice(decision, opts);
-  return core.attachNotice({ ...decision, ...core.startTask({ ...opts, task: input.task || "", decision }) }, opts);
+  if (action !== "task") return taskResultReadiness(core.attachNotice(decision, opts), opts);
+  const record = core.startTask({ ...opts, task: input.task || "", decision });
+  return taskResultReadiness(core.attachNotice({ ...record.decision, ...record }, opts), opts);
+}
+
+function taskResultReadiness(result, opts) {
+  const effective = resultCore.projectResult(result, opts, { packageName: pkg.name, packageVersion: pkg.version }).integration;
+  return { ...result, ready: effective.scope?.status === "applicable" && effective.ready === true };
 }
 
 function hostDiagnostic(opts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-ui",
-  "version": "1.20.0",
+  "version": "1.20.1",
   "description": "企业级 UI 风格对齐框架 — Vue + Element Plus 双模式、任务路由与真实检查回执（tokens / element / vendors / layouts / runtime / scanner / fixer / skills）",
   "type": "module",
   "main": "./es/index.js",