@givolt/i3-composer-agent 2.3.1 → 2.3.2

package/evals/zh-CN/cases/i3-ui-prototype.json

@@ -17,6 +17,26 @@
       {
         "prompt": "根据评审反馈迭代交互原型，保留已确认的原型基线。",
         "top_k": 1
+      },
+      {
+        "prompt": "参考这份可编辑 HTML 内容模板，用 Vue 3 和 antDv-next 生成设备管理交互原型。",
+        "top_k": 1
+      },
+      {
+        "prompt": "先分析内容模板与业务需求如何形成交互原型方案，不修改文件。",
+        "top_k": 1
+      },
+      {
+        "prompt": "根据反馈修改交互原型，保留我手改的代码并检查抽屉退出动画。",
+        "top_k": 1
+      },
+      {
+        "prompt": "请当前会话直接使用原型技能检查待评审候选，不启动其他智能体。",
+        "top_k": 1
+      },
+      {
+        "prompt": "请主会话根据 HTML 内容参考和业务说明分析交互原型方案，保持只读。",
+        "top_k": 1
       }
     ],
     "negative": [
@@ -27,6 +47,10 @@
       {
         "prompt": "产品页面有一千条数据渲染很慢，请定位性能瓶颈并优化。",
         "owner": "i3-performance-optimization"
+      },
+      {
+        "prompt": "昨天通过的测试现在失败，请复现并定位根因。",
+        "owner": "i3-debugging-and-error-recovery"
       }
     ]
   },
@@ -45,6 +69,97 @@
         "The prototype remains pending human review and no approved baseline is invented",
         "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
       ]
+    },
+    {
+      "id": 1002,
+      "kind": "dialogue",
+      "prompt": "请当前会话直接使用 i3-ui-prototype 技能，分析可编辑 HTML 内容模板和通用能力清单如何生成 Vue 3＋antDv-next 设备列表原型。仅分析：不改文件、不安装升级、不持久化设计结果、不启动另一个智能体。",
+      "expected_output": "A read-only prototype analysis that keeps direct Skill execution valid and states the framework, content, capability and acceptance boundaries",
+      "expectations": [
+        "The current executor runs the shared preflight without redispatching to an Agent, command or meta-skill",
+        "The response preserves analysis-only scope and does not initialize, install, persist design output or update project execution state",
+        "Editable content reference, reusable capabilities and target-framework behavior are explained as separate inputs",
+        "Unavailable provider, host or browser capabilities remain explicitly unverified rather than reported as executed",
+        "The analysis deliverable is the conversation; it does not invent prototype completion or human approval",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
+    },
+    {
+      "id": 1003,
+      "prompt": "请使用 admin-list 可编辑内容模板，创建独立的 Vue 3＋antDv-next 原生组件设备列表原型，本例明确选择 template 模式。要求：固定 21 条设备，每页 10 条；筛选或翻页清空当前页选择；批量状态变更仅影响选中记录；编辑抽屉校验必填名称，模拟保存失败时保留输入，重试后更新正确行。有真实浏览器时验证当前构建的抽屉退出动效和遮罩模糊。保留已有原型，交付待人工评审候选。",
+      "expected_output": "An isolated native component prototype with fixed capability inputs, reproducible local data, current-build verification or a truthful verification gap",
+      "files": [
+        "i3-ui-prototype"
+      ],
+      "expectations": [
+        "The instance uses the native framework runtime and fixed template, capability, scope and framework inputs rather than converting an existing legacy instance",
+        "Real antDv-next components implement filtering, current-page selection, pagination and the edit flow with deterministic isolated mock state",
+        "Required capability bindings remain independently checkable and are not removed or arbitrarily marked inapplicable to make checks pass",
+        "The executor distinguishes source inspection, successful build and real browser execution; unavailable checks remain unverified",
+        "Browser evidence, when present, refers to the current candidate and actual build, with drawer motion and blur verified separately from static screenshots",
+        "Template mode is explicit and does not claim UIUX use; existing prototypes remain unchanged and no human baseline approval is invented",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
+    },
+    {
+      "id": 1004,
+      "kind": "dialogue",
+      "prompt": "请只读检查这份原型验收声明：测试后源码已改，服务仍展示上一版构建，证据只有一张截图和手动填 passed 的报告。同事建议删除分页能力并标为不适用，以便批准候选。请说明正确的后续动作；不改文件、不执行新测试、不确认基线。",
+      "expected_output": "A read-only rejection of stale evidence and unsupported exemption, with concrete required revalidation and pending human review",
+      "expectations": [
+        "The changed candidate and previous build invalidate the supplied acceptance claim",
+        "A screenshot or manually passed report is not treated as proof of current-build browser execution or drawer animation",
+        "Pagination remains required unless an explicit requirement or scope-change source justifies an exemption",
+        "The response proposes rebuilding and revalidating against fixed inputs without claiming those actions already occurred",
+        "No files are changed, no tests are pretended, and human baseline approval remains separate",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
+    },
+    {
+      "id": 1005,
+      "kind": "dialogue",
+      "prompt": "请在主会话中分析可编辑 admin-list HTML 参考和业务说明，形成 Vue 3＋antDv-next 评审原型方案。保持只读。宿主没有原型专责角色，也没有父子 JSON 传输机制。请交付有用的分析和后续步骤，不安装工具，不执行创建阶段的检查。",
+      "expected_output": "A complete read-only main-session analysis with useful coverage and a truthful acceptance plan",
+      "expectations": [
+        "The main session directly applies the shared prototype preflight without requiring or simulating a dedicated Agent",
+        "The analysis delivers requirement and bound-capability coverage, template and framework selection, acceptance planning and concrete gaps",
+        "No initialization, installation, persisted design, project state update, build, browser run or creation-stage UIUX adoption gate occurs",
+        "No parent-child JSON, PROTOTYPE_RESULT_V1 marker or validate-result execution is made a prerequisite for the natural-language deliverable",
+        "Unavailable capabilities and fixed-parameter conflicts remain visible; analysis completion is distinct from implemented coverage and human approval",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
+    },
+    {
+      "id": 1006,
+      "prompt": "请根据可编辑 admin-list 参考创建独立的 Vue 3＋antDv-next 原生组件设备列表评审候选，明确使用 template 模式。我授权页面内四种主题：明亮、暗黑、清新、科技，首次默认明亮。请在我的 HTML 工作副本中启用并固定主题需求，切换时保留业务状态，保留全部已有原型和手改内容。不要再次询问是否需要主题。保持固定必需能力，指定浏览器工具可用时验证当前构建。",
+      "expected_output": "A main-session native review candidate with explicitly fixed four-theme inputs, preserved state and truthful current-build evidence or gaps",
+      "files": [
+        "i3-ui-prototype"
+      ],
+      "expectations": [
+        "The main session uses the prototype workflow and supporting frontend and version-matched official framework knowledge for actual implementation, without requiring a dedicated persona",
+        "The authorized theme capability is bound in the user HTML working copy and fixed with its requirement source rather than left disabled or sent for repeat confirmation",
+        "The generated framework implements the four exact theme names, defaults to 明亮, and verifies that business state survives theme changes",
+        "Existing or unrequested-theme instances, user edits and approved baselines remain unchanged",
+        "Template mode does not claim UIUX use; fixed required capabilities and applicable acceptance scenarios are retained",
+        "Build, actual browser Skill and DevTools observations, supplemental regression and current delivery evidence are distinguished; unavailable checks remain incomplete",
+        "The final natural-language delivery identifies the candidate, current evidence and gaps, and leaves human review pending without requiring a parent-child result envelope",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
+    },
+    {
+      "id": 1007,
+      "kind": "dialogue",
+      "prompt": "请比较三种请求的处理方式：只读分析原型方案；为评审修改原型抽屉交互；把已认可抽屉实现为可复用生产组件。说明各自适用的技能和证据，不执行这些请求。",
+      "expected_output": "Operation-specific support and a clear boundary between prototype work and production frontend engineering",
+      "expectations": [
+        "Read-only prototype analysis uses only material needed for coverage and selection and plans later verification without executing it",
+        "Prototype interaction revision stays within prototype workflow ownership and uses frontend, official framework and browser capabilities when the revision requires them",
+        "Professional UIUX lookup, adoption and effect verification remain distinct and apply to professional design work, with no silent downgrade to template mode",
+        "Approved production component implementation follows the frontend implementation method and the existing engineering workflow rather than creating a new review prototype",
+        "No claim of completed runtime checks or human baseline approval is made",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
     }
   ]
 }

package/evals/zh-CN/cases/i3-using-agent-skills.json

@@ -23,6 +23,10 @@
       {
         "prompt": "为项目配置 CI/CD 流水线，自动运行构建和测试。",
         "owner": "i3-ci-cd-and-automation"
+      },
+      {
+        "prompt": "选择 UI 原型模板，制作一个可操作的申请审批交互原型供评审。",
+        "owner": "i3-ui-prototype"
       }
     ]
   },
@@ -40,6 +44,32 @@
         "Core operating behaviors (assumptions surfaced) are respected",
         "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
       ]
+    },
+    {
+      "id": 1002,
+      "kind": "dialogue",
+      "prompt": "用户希望根据可编辑 HTML 参考和简短业务说明制作设备管理评审原型。请在当前会话选择适用技能并说明下一步；不创建文件，不启动独立任务。",
+      "expected_output": "Ordinary routing to i3-ui-prototype in the main session, with operation and scope decided by the working skill",
+      "expectations": [
+        "The meta-skill selects the prototype workflow for reviewable prototype work",
+        "The main session uses the working skill without requiring a dedicated persona, persistent routing rule or parent-child result protocol",
+        "Detailed operation, framework and acceptance decisions remain in the prototype workflow rather than being copied into the meta-skill",
+        "The requested read-only routing explanation does not initialize a prototype or claim implementation",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
+    },
+    {
+      "id": 1003,
+      "kind": "dialogue",
+      "prompt": "分别收到两个任务：实现已认可的生产 Vue 表单组件并支持键盘操作；对照已认可基线检查评审原型。请分别路由并说明原工程工作流如何继续适用，不执行这两个任务。",
+      "expected_output": "Separate routing for production engineering and prototype review without changing the general lifecycle",
+      "expectations": [
+        "Production UI implementation follows the engineering workflow with the frontend implementation method",
+        "Prototype fidelity inspection selects the prototype workflow",
+        "The prototype route does not replace generic planning, implementation or review methods or impose prototype-specific delegation on them",
+        "The response does not invent runtime verification or human approval",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
     }
   ]
 }

package/package.json

@@ -100,6 +100,12 @@
     "evals/fixtures/i3-test-driven-development/package.json",
     "evals/fixtures/i3-test-driven-development/src/split.js",
     "evals/fixtures/i3-test-driven-development/test/split.test.js",
+    "evals/fixtures/i3-ui-prototype/admin-list/assets/reference.css",
+    "evals/fixtures/i3-ui-prototype/admin-list/assets/reference.js",
+    "evals/fixtures/i3-ui-prototype/admin-list/capability-definition.json",
+    "evals/fixtures/i3-ui-prototype/admin-list/index.html",
+    "evals/fixtures/i3-ui-prototype/admin-list/readme.md",
+    "evals/fixtures/i3-ui-prototype/admin-list/template.json",
     "evals/fixtures/i3-ui-prototype/business-brief.md",
     "evals/fixtures/i3-using-agent-skills/incident.md",
     "evals/fixtures/incremental-implementation-pressure/draft-export.js",
@@ -163,6 +169,8 @@
     "docs/getting-started.md",
     "docs/opencode-setup.md",
     "docs/other-hosts.md",
+    "docs/ui-prototype-native/MAIN-SESSION-REPORT.md",
+    "docs/ui-prototype-native/USAGE.md",
     "docs/windsurf-setup.md",
     "docs/workbuddy-setup.md",
     "plugin.json",
@@ -172,12 +180,19 @@
     "scripts/design-provider-test.js",
     "scripts/enterprise-template-test.js",
     "scripts/floor-guard-reference-test.js",
+    "scripts/lib/prototype-fixture.cjs",
     "scripts/lib/skill-lint-test.js",
     "scripts/lib/skill-lint.js",
+    "scripts/prototype-locations-test.js",
     "scripts/run-evals-test.js",
     "scripts/run-evals.js",
     "scripts/run-regressions.js",
     "scripts/template-adapter-test.js",
+    "scripts/ui-prototype-content-test.js",
+    "scripts/ui-prototype-dependencies-test.js",
+    "scripts/ui-prototype-devtools-test.js",
+    "scripts/ui-prototype-native-test.js",
+    "scripts/ui-prototype-template-test.js",
     "scripts/ui-prototype-test.js",
     "scripts/validate-artifact-paths-test.js",
     "scripts/validate-artifact-paths.js",
@@ -287,6 +302,12 @@
       "evals/fixtures/i3-test-driven-development/package.json",
       "evals/fixtures/i3-test-driven-development/src/split.js",
       "evals/fixtures/i3-test-driven-development/test/split.test.js",
+      "evals/fixtures/i3-ui-prototype/admin-list/assets/reference.css",
+      "evals/fixtures/i3-ui-prototype/admin-list/assets/reference.js",
+      "evals/fixtures/i3-ui-prototype/admin-list/capability-definition.json",
+      "evals/fixtures/i3-ui-prototype/admin-list/index.html",
+      "evals/fixtures/i3-ui-prototype/admin-list/readme.md",
+      "evals/fixtures/i3-ui-prototype/admin-list/template.json",
       "evals/fixtures/i3-ui-prototype/business-brief.md",
       "evals/fixtures/i3-using-agent-skills/incident.md",
       "evals/fixtures/incremental-implementation-pressure/draft-export.js",
@@ -350,6 +371,8 @@
       "docs/getting-started.md",
       "docs/opencode-setup.md",
       "docs/other-hosts.md",
+      "docs/ui-prototype-native/MAIN-SESSION-REPORT.md",
+      "docs/ui-prototype-native/USAGE.md",
       "docs/windsurf-setup.md",
       "docs/workbuddy-setup.md",
       "plugin.json",
@@ -360,12 +383,19 @@
       "scripts/design-provider-test.js",
       "scripts/enterprise-template-test.js",
       "scripts/floor-guard-reference-test.js",
+      "scripts/lib/prototype-fixture.cjs",
       "scripts/lib/skill-lint-test.js",
       "scripts/lib/skill-lint.js",
+      "scripts/prototype-locations-test.js",
       "scripts/run-evals-test.js",
       "scripts/run-evals.js",
       "scripts/run-regressions.js",
       "scripts/template-adapter-test.js",
+      "scripts/ui-prototype-content-test.js",
+      "scripts/ui-prototype-dependencies-test.js",
+      "scripts/ui-prototype-devtools-test.js",
+      "scripts/ui-prototype-native-test.js",
+      "scripts/ui-prototype-template-test.js",
       "scripts/ui-prototype-test.js",
       "scripts/validate-artifact-paths-test.js",
       "scripts/validate-artifact-paths.js",
@@ -378,7 +408,7 @@
       "scripts/validate-versions.js"
     ]
   },
-  "version": "2.3.1",
+  "version": "2.3.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/49780522/i3-composer-agent.git"

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "homepage": "https://github.com/49780522/i3-composer-agent",
   "repository": "https://github.com/49780522/i3-composer-agent"

package/scripts/design-provider-test.js

@@ -66,3 +66,10 @@ test('all unusable providers preserve their individual failure reasons without a
   assert.ok(!result.choices.some(choice => choice.id === 'install'));
   assert.equal(fs.existsSync(path.join(home, 'prototypes')), false);
 });
+test('a business package version cannot masquerade as the later installed UIUX version', t => {
+  const home = fixture(t), root = provider(home, 'manual-provider');
+  fs.writeFileSync(path.join(home, 'package.json'), JSON.stringify({ name: 'human-business-project', version: '99.88.77' }));
+  assert.equal(lib.checkDesignProvider({ provider: root }).version, 'unversioned');
+  fs.writeFileSync(path.join(root, 'UPSTREAM-ORIGIN.json'), JSON.stringify({ packageName: 'ui-ux-pro-max-cli', version: '2.15.0' }));
+  assert.equal(lib.checkDesignProvider({ provider: root }).version, '2.15.0');
+});

package/scripts/enterprise-template-test.js

@@ -104,11 +104,37 @@ test('generated enterprise instances isolate their local demo storage and retain
   const source = fs.readFileSync(path.join(dir, 'app/src/shared/session.js'), 'utf8');
   assert.match(source, /i3-enterprise-enterprise-demo-/);
   assert.doesNotMatch(source, /i3-prototype-antdv-/);
-  assert.match(fs.readFileSync(path.join(dir, 'app/index.html'), 'utf8'), /enterprise-bootstrap\.mjs/);
+  assert.match(fs.readFileSync(path.join(dir, 'app/index.html'), 'utf8'), /src="offline\.js"/);
+  assert.ok(fs.existsSync(path.join(dir, 'app/enterprise-bootstrap.mjs')), 'Retain the historical module bootstrap for compatibility');
   assert.match(fs.readFileSync(path.join(dir, 'app/index.html'), 'utf8'), /tokens\.css/);
   const other = initialize(t);
   assert.notEqual(read(dir, 'prototype.json').runtime.storagePrefix, read(other, 'prototype.json').runtime.storagePrefix);
 });
+test('offline entry carries every editable HTML fragment and routes without changing the reference', t => {
+  const root = path.join(skill, 'assets/templates/enterprise-admin');
+  const build = read(root, 'offline-build.json');
+  for (const [file, expected] of Object.entries(build.files)) {
+    assert.equal(crypto.createHash('sha256').update(fs.readFileSync(path.join(root, file))).digest('hex'), expected, file);
+  }
+  const html = fs.readFileSync(path.join(root, 'index.html'), 'utf8');
+  assert.equal([...html.matchAll(/<template data-source=/g)].length, build.htmlFragmentCount);
+  const routes = JSON.parse(html.match(/id="prototype-offline-routes">([\s\S]*?)<\/script>/)[1]);
+  assert.deepEqual(routes, read(root, 'reference/routes.json'));
+  for (const component of new Set(routes.map(route => route.component).filter(Boolean))) {
+    const source = fs.readFileSync(path.resolve(root, 'reference', component), 'utf8');
+    const fragment = source.match(/template: new URL\('\.\/([^']+\.html)'/)[1];
+    assert.ok(html.includes(`data-source="reference/${path.posix.dirname(component).replace(/^\.\//, '')}/${fragment}"`), component);
+  }
+  assert.doesNotMatch(html, /type="module"/);
+  assert.doesNotMatch(fs.readFileSync(path.join(root, 'offline.js'), 'utf8'), /\bfetch\s*\(|\bimport\s*\(|import\.meta/);
+  const dir = initialize(t, { title: '离线配置 <安全标题>' });
+  const instance = fs.readFileSync(path.join(dir, 'app/index.html'), 'utf8');
+  assert.equal(JSON.parse(instance.match(/id="prototype-offline-config">([\s\S]*?)<\/script>/)[1]).title, '离线配置 <安全标题>');
+  assert.equal(read(dir, 'prototype.json').runtime.offlineVersion, 1);
+  assert.equal(lib.checkPrototype(dir).status, 'passed');
+  fs.unlinkSync(path.join(dir, 'app/offline.js'));
+  assert.equal(lib.checkPrototype(dir).status, 'failed', 'A new offline instance must require its runtime');
+});
 test('missing enterprise runtime imports are rejected while declarative data-bind attributes remain valid', t => {
   const dir = initialize(t);
   assert.equal(lib.checkPrototype(dir).status, 'passed');

package/scripts/lib/prototype-fixture.cjs

@@ -0,0 +1,17 @@
+'use strict';
+// Historical admin-list input for regression tests only; no public template entry.
+const fs = require('node:fs');
+const path = require('node:path');
+function prepareTemplate(contract, { project, id = 'admin-list' }) {
+  if (!/^[a-z][a-z0-9-]{0,63}$/.test(id)) throw new Error('Invalid identifier');
+  const directory = path.resolve(project, 'ui-templates', id);
+  if (fs.existsSync(path.join(project, 'ui-templates')) && fs.lstatSync(path.join(project, 'ui-templates')).isSymbolicLink()) throw new Error('Refusing symlink');
+  if (fs.existsSync(directory)) return { directory, created: false, index: contract.loadTemplate(directory).index };
+  fs.cpSync(path.resolve(__dirname, '../../evals/fixtures/i3-ui-prototype/admin-list'), directory, { recursive: true });
+  const file = path.join(directory, 'template.json');
+  const manifest = JSON.parse(fs.readFileSync(file));
+  manifest.id = id;
+  fs.writeFileSync(file, JSON.stringify(manifest, null, 2) + '\n');
+  return { directory, created: true, index: contract.syncTemplate(directory) };
+}
+module.exports = { prepareTemplate };

package/scripts/prototype-locations-test.js

@@ -0,0 +1,58 @@
+'use strict';
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+const installation = path.join(__dirname, 'lib/installation.js');
+const skills = fs.existsSync(installation) ? require(installation).loadInstallation().skillsDirectory : path.resolve(__dirname, '../skills');
+const locations = require(path.join(skills, 'i3-ui-prototype/scripts/prototype-locations.cjs'));
+function workspace(t) {
+  const root = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'i3-tool-locations-')));
+  t.after(() => fs.rmSync(root, { recursive: true, force: true }));
+  const project = path.join(root, 'business'), home = path.join(root, 'home');
+  fs.mkdirSync(project); fs.mkdirSync(home);
+  return { project, home, env: {} };
+}
+test('all registered project and global targets keep tools under their host base without writes', t => {
+  const options = workspace(t);
+  for (const agent of locations.registry.agents) {
+    const local = locations.resolveLocations({ ...options, host: agent.id });
+    assert.equal(local.skillsDirectory, path.resolve(options.project, agent.projectSkillsDir));
+    const toolBase = path.dirname(local.skillsDirectory) === options.project ? path.join(options.project, `.${agent.id}`) : path.dirname(local.skillsDirectory);
+    assert.equal(local.toolsDirectory, path.join(toolBase, 'tools/i3-prototype'));
+    assert.notEqual(local.toolsDirectory, path.join(options.project, 'tools/i3-prototype'));
+    if (agent.globalSkillsDir) {
+      const global = locations.resolveLocations({ ...options, host: agent.id, scope: 'global' });
+      assert.equal(global.toolsDirectory, path.join(path.dirname(global.skillsDirectory), 'tools/i3-prototype'));
+      assert.ok(global.base.startsWith(options.home + path.sep));
+    } else assert.throws(() => locations.resolveLocations({ ...options, host: agent.id, scope: 'global' }), /project installation only/);
+  }
+  assert.deepEqual(fs.readdirSync(options.project), []);
+  assert.deepEqual(fs.readdirSync(options.home), []);
+});
+test('CodeBuddy and WorkBuddy share project tools but use separate global roots; Codex follows agents', t => {
+  const options = workspace(t), get = (host, scope = 'project') => locations.resolveLocations({ ...options, host, scope });
+  assert.equal(get('codebuddy').toolsDirectory, get('workbuddy').toolsDirectory);
+  assert.notEqual(get('codebuddy', 'global').toolsDirectory, get('workbuddy', 'global').toolsDirectory);
+  assert.equal(get('codex').base, path.join(options.project, '.agents'));
+  assert.equal(get('codex', 'global').base, path.join(options.home, '.agents'));
+});
+test('configuration roots and aliases follow installer mapping and explicit global checks exclude business paths', t => {
+  const options = workspace(t);
+  const context = locations.resolveLocations({ ...options, host: 'claude', scope: 'global', env: { CLAUDE_CONFIG_DIR: path.join(options.home, 'custom claude') } });
+  assert.equal(context.base, path.join(options.home, 'custom claude'));
+  assert.equal(context.host, 'claude-code');
+  const opencode = locations.resolveLocations({ ...options, host: 'opencode', env: { XDG_CONFIG_HOME: path.join(options.home, 'config') }, scope: 'global' });
+  assert.equal(opencode.base, path.join(options.home, 'config/opencode'));
+  assert.ok(locations.toolCandidates(context).every(item => !item.root.startsWith(options.project + path.sep)));
+  assert.throws(() => locations.resolveLocations({ ...options, host: 'unknown' }), /Unknown host/);
+  assert.throws(() => locations.resolveLocations({ ...options, scope: 'all' }), /scope/);
+});
+test('new project and global tools precede both legacy layouts', t => {
+  const options = workspace(t), context = locations.resolveLocations({ ...options, host: 'codex' });
+  const paths = locations.toolCandidates(context);
+  assert.deepEqual(paths.map(item => item.source), ['project-tool', 'global-tool', 'legacy-project-tool', 'legacy-project-tool']);
+  assert.ok(paths[0].root.includes('/.agents/tools/i3-prototype/antdv-cli/'));
+  assert.ok(paths.at(-1).root.includes('/.prototype-tools/node_modules/'));
+});

package/scripts/ui-prototype-content-test.js

@@ -0,0 +1,123 @@
+'use strict';
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const crypto = require('node:crypto');
+const installation = path.join(__dirname, 'lib/installation.js');
+const skills = fs.existsSync(installation) ? require(installation).loadInstallation().skillsDirectory : path.resolve(__dirname, '../skills');
+const root = path.join(skills, 'i3-ui-prototype');
+const contract = require(path.join(root, 'scripts/template-contract.cjs'));
+const native = require(path.join(root, 'scripts/native-pilot-lib.cjs'));
+const read = (directory, file) => JSON.parse(fs.readFileSync(path.join(directory, file), 'utf8'));
+const write = (directory, file, data) => fs.writeFileSync(path.join(directory, file), JSON.stringify(data, null, 2));
+const files = directory => Object.fromEntries(fs.readdirSync(directory, { recursive: true }).filter(file => fs.statSync(path.join(directory, file)).isFile()).sort().map(file => [file, crypto.createHash('sha256').update(fs.readFileSync(path.join(directory, file))).digest('hex')]));
+function fixture(t, { prepare = true } = {}) {
+  const project = fs.mkdtempSync(path.join(os.tmpdir(), 'i3-full-content-'));
+  t.after(() => fs.rmSync(project, { recursive: true, force: true }));
+  const template = prepare ? contract.prepareTemplate({ project }) : null;
+  const scope = { schemaVersion: 1, title: '资产审核', pages: [{ id: 'assets', title: '资产台账', referencePage: 'models-page',
+    regions: [{ id: 'list', mode: 'management-list' }, { id: 'editor', mode: 'edit-form' }] }],
+    requirements: [{ id: 'ASSET-01', text: '查询、选择和修改资产', pages: ['assets'], source: { type: 'prd', reference: 'PRD.md#ASSET-01', statement: '按资产字段实现清单与编辑；使用模板通用能力约定。' } }], exemptions: [] };
+  write(project, 'scope.json', scope);
+  const create = options => native.createPrototype({ project, id: 'assets', expertMode: 'template', scope: path.join(project, 'scope.json'), ...(template ? { templateRoot: template.directory } : {}), ...options });
+  return { project, template, scope, create };
+}
+test('explicit legacy preparation uses the complete offline reference and never overwrites a working copy', t => {
+  const { project, template } = fixture(t);
+  const snapshot = contract.loadTemplate(template.directory);
+  assert.equal(snapshot.kind, 'content-reference'); assert.equal(snapshot.id, 'enterprise-admin');
+  assert.equal(snapshot.index.pages.length, 35); assert.equal(snapshot.index.routes.length, 44); assert.equal(snapshot.index.htmlFragments.length, 93);
+  assert.deepEqual(Object.keys(snapshot.index.extractor.files).sort(), ['content-template.cjs', 'template-contract.cjs']);
+  const file = path.join(template.directory, 'index.html');
+  fs.writeFileSync(file, fs.readFileSync(file, 'utf8').replace('<h1>模型管理</h1>', '<h1>资产参考内容</h1>'));
+  assert.throws(() => contract.loadTemplate(template.directory), /stale|不同步/);
+  const index = contract.syncTemplate(template.directory);
+  assert.equal(index.pages.find(page => page.id === 'models-page').title, '资产参考内容');
+  const content = require(path.join(root, 'scripts/content-template.cjs')).pageContent(contract.loadTemplate(template.directory), 'models-page');
+  assert.ok(content.html.includes('<h1>资产参考内容</h1>')); assert.equal(content.readOnly, true);
+  assert.equal(contract.prepareTemplate({ project }).created, false);
+  assert.ok(fs.readFileSync(file, 'utf8').includes('资产参考内容'));
+});
+test('default creation reads the released template without preparing a business template directory or modifying Skill assets', t => {
+  const { project, create } = fixture(t, { prepare: false });
+  const builtin = path.join(root, 'assets/templates/enterprise-admin');
+  const before = files(builtin);
+  const created = create();
+  assert.equal(fs.existsSync(path.join(project, 'ui-templates')), false);
+  assert.equal(fs.existsSync(path.join(project, '.prototype-preparation')), false);
+  assert.deepEqual(files(builtin), before);
+  assert.equal(native.inspect(created.directory).status, 'passed');
+  const snapshot = read(created.directory, 'inputs/template-snapshot.json');
+  assert.equal(snapshot.id, 'enterprise-admin'); assert.equal(snapshot.index.pages.length, 35);
+  assert.deepEqual(snapshot, contract.loadBundledTemplate());
+  assert.deepEqual(read(created.directory, 'inputs/scope.json'), read(project, 'scope.json'));
+});
+test('an existing edited template copy is preserved and used only when explicitly selected', t => {
+  const { project, template, create } = fixture(t);
+  const entry = path.join(template.directory, 'index.html');
+  fs.writeFileSync(entry, fs.readFileSync(entry, 'utf8').replace('<h1>模型管理</h1>', '<h1>用户维护的旧模板</h1>'));
+  contract.syncTemplate(template.directory);
+  const before = files(template.directory);
+  const current = create({ id: 'current', templateRoot: undefined });
+  const legacy = create({ id: 'legacy' });
+  assert.notEqual(read(current.directory, 'inputs/template-snapshot.json').digest, read(legacy.directory, 'inputs/template-snapshot.json').digest);
+  assert.equal(read(legacy.directory, 'inputs/template-snapshot.json').index.pages.find(page => page.id === 'models-page').title, '用户维护的旧模板');
+  assert.deepEqual(files(template.directory), before);
+});
+test('new business generation requires a sourced scope and does not silently generate a device list', t => {
+  const { project, create } = fixture(t);
+  assert.throws(() => create({ scope: undefined }), /scope|需求/i);
+  assert.equal(fs.existsSync(path.join(project, 'prototypes')), false);
+  const created = create(), meta = read(created.directory, 'prototype.json');
+  assert.equal(meta.runtime.contentReference, true); assert.equal(meta.business.status, 'needs-adaptation');
+  assert.equal(native.inspect(created.directory).status, 'passed');
+  assert.match(native.inspect(created.directory, { acceptance: true }).errors.join('; '), /implementation pending|scaffold/);
+  const config = read(created.directory, 'app/public/prototype-config.json');
+  assert.deepEqual(config.pages, [{ id: 'assets', title: '资产台账' }]);
+  assert.deepEqual(config.theme, { defaultTheme: 'light', presets: ['light', 'dark', 'fresh', 'tech'] });
+  assert.equal(config.content, undefined); assert.equal(read(created.directory, 'mocks/contract.json').count, undefined);
+  assert.equal(fs.existsSync(path.join(created.directory, 'app/src/domain/devices.ts')), false);
+  const state = native.state(created.directory, {});
+  assert.equal(state.nextAction, 'implement-business'); assert.equal(state.commands.browser, undefined); assert.ok(state.commands.recordRun);
+});
+test('the complete content reference yields fixed common capabilities for the selected business regions', t => {
+  const { create } = fixture(t), directory = create().directory;
+  const fixed = read(directory, 'inputs/capabilities.json'), acceptance = read(directory, 'inputs/acceptance.json');
+  for (const id of ['filter', 'selection', 'pagination', 'bulk', 'feedback']) assert.ok(fixed.bindings.some(binding => binding.id === `assets/list/${id}`));
+  assert.ok(fixed.bindings.some(binding => binding.id === 'assets/editor/edit'));
+  assert.ok(fixed.bindings.some(binding => binding.id === 'app-shell/appearance/theme'));
+  assert.ok(acceptance.requiredScenarios.includes('assets/list/pagination/pages'));
+  assert.ok(acceptance.requiredScenarios.includes('app-shell/appearance/theme/persistence'));
+  assert.equal(acceptance.requiredScenarios.some(id => id.startsWith('devices/')), false);
+  fixed.bindings = fixed.bindings.filter(binding => binding.capabilityId !== 'selection'); write(directory, 'inputs/capabilities.json', fixed);
+  const candidate = native.manifest(directory);
+  assert.throws(() => native.revise(directory, { revision: 'r002', expectedRevision: candidate.revision, expectedDigest: candidate.digest, acceptInputs: true }), /binding|capabilit|合同/i);
+});
+test('business page and requirement references must remain explicit and unambiguous', t => {
+  const { project, scope, create } = fixture(t);
+  for (const modify of [
+    value => { value.pages[0].referencePage = 'missing-page'; },
+    value => { value.pages.push(structuredClone(value.pages[0])); },
+    value => { value.requirements.push(structuredClone(value.requirements[0])); },
+    value => { value.requirements[0].source = {}; },
+    value => { value.requirements[0].pages = ['other-business']; },
+    value => { value.pages[0].regions[0].mode = 'unknown-mode'; },
+  ]) {
+    const broken = structuredClone(scope); modify(broken); write(project, 'scope.json', broken);
+    assert.throws(() => create()); assert.equal(fs.existsSync(path.join(project, 'prototypes')), false);
+  }
+});
+test('offline reference synchronization rejects missing runtime resources and module loading', t => {
+  const { template } = fixture(t), file = path.join(template.directory, 'index.html'), html = fs.readFileSync(file, 'utf8');
+  fs.writeFileSync(file, html.replace('src="offline.js"', 'src="missing.js"')); assert.throws(() => contract.syncTemplate(template.directory), /resource missing/);
+  fs.writeFileSync(file, html.replace('<script src="offline.js"', '<script type="module" src="offline.js"')); assert.throws(() => contract.syncTemplate(template.directory), /modules/);
+  fs.writeFileSync(file, html); fs.appendFileSync(path.join(template.directory, 'offline.js'), '\nfetch("parts.html")'); assert.throws(() => contract.syncTemplate(template.directory), /Offline runtime/);
+});
+test('the historical device regression runner refuses a business contract before writing evidence', async t => {
+  const { create } = fixture(t), directory = create().directory;
+  const before = fs.readdirSync(path.join(directory, 'qa'));
+  await assert.rejects(require(path.join(root, 'scripts/native-browser.cjs')).main(directory), /historical device-list/);
+  assert.deepEqual(fs.readdirSync(path.join(directory, 'qa')), before);
+});