@givolt/i3-composer-agent 3.2.1 → 4.0.1

package/skills/i3-ui-prototype/scripts/design-provider-discovery.cjs

@@ -1,128 +0,0 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-const os = require('node:os');
-const { spawnSync } = require('node:child_process');
-
-const PROVIDER = 'ui-ux-pro-max';
-const MARKETPLACE = 'ui-ux-pro-max-skill';
-const json = file => JSON.parse(fs.readFileSync(file, 'utf8'));
-const object = value => value !== null && typeof value === 'object' && !Array.isArray(value);
-const safeSegment = value => typeof value === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9._+-]*$/.test(value) && !value.includes('..');
-function ensure(condition, message) { if (!condition) throw new Error(message); }
-function canonical(file) { return fs.existsSync(file) ? fs.realpathSync(file) : path.resolve(file); }
-
-function pluginRoot(installation, manifests, fallback) {
-  ensure(typeof installation.installPath === 'string' && path.isAbsolute(installation.installPath), 'Plugin installPath must be absolute');
-  ensure(safeSegment(installation.version), 'Installed plugin version is invalid');
-  const root = installation.installPath;
-  const manifestFile = manifests.map(name => path.join(root, name)).find(file => fs.existsSync(file));
-  ensure(manifestFile, 'Installed plugin manifest is missing');
-  const manifest = json(manifestFile);
-  ensure(manifest.name === PROVIDER && manifest.version === installation.version, 'Installed plugin manifest name or version does not match its registration');
-  const declared = manifest.skills === undefined ? fallback : manifest.skills;
-  ensure(typeof declared === 'string' && declared && !path.isAbsolute(declared) && !declared.includes('\\'), 'Plugin skills declaration is missing or invalid');
-  const folder = path.resolve(root, declared), relative = path.relative(path.resolve(root), folder);
-  ensure(relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative), 'Plugin skills declaration escapes its root');
-  if (fs.existsSync(folder)) {
-    const realRelative = path.relative(canonical(root), canonical(folder));
-    ensure(realRelative !== '..' && !realRelative.startsWith(`..${path.sep}`) && !path.isAbsolute(realRelative), 'Plugin skills path escapes its root');
-  }
-  const skill = path.join(folder, PROVIDER);
-  ensure(fs.existsSync(path.join(skill, 'SKILL.md')), 'Installed plugin skill entrypoint is missing');
-  const skillRelative = path.relative(canonical(root), canonical(skill));
-  ensure(skillRelative !== '..' && !skillRelative.startsWith(`..${path.sep}`) && !path.isAbsolute(skillRelative), 'Plugin skill path escapes its root');
-  return skill;
-}
-
-function codexCandidates(config, project, env, add, report) {
-  const source = 'codex-plugin';
-  try {
-    const run = spawnSync('codex', ['plugin', 'list', '--marketplace', MARKETPLACE, '--json'], { cwd: project, env, encoding: 'utf8', timeout: 10000, maxBuffer: 1024 * 1024, shell: false });
-    ensure(!run.error && run.status === 0, `Codex plugin discovery failed${run.error?.code ? ` (${run.error.code})` : ''}`);
-    const data = JSON.parse(run.stdout);
-    ensure(object(data) && Array.isArray(data.installed), 'Codex plugin discovery returned invalid metadata');
-    const records = data.installed.filter(record => record?.pluginId === `${PROVIDER}@${MARKETPLACE}`);
-    if (!records.length) { report(source, 'missing', 'Current Codex host has no registered UI/UX Pro Max plugin'); return; }
-    ensure(records.every(record => record.name === PROVIDER && record.marketplaceName === MARKETPLACE && typeof record.enabled === 'boolean' && typeof record.installed === 'boolean'), 'Codex plugin registration is invalid');
-    const active = records.filter(record => record.installed && record.enabled);
-    if (!active.length) { report(source, records.some(record => record.installed) ? 'disabled' : 'missing', 'UI/UX Pro Max is not enabled in the current Codex host'); return; }
-    if (active.length !== 1) { report(source, 'ambiguous', 'Multiple active Codex UI/UX Pro Max registrations require an explicit provider path'); return; }
-    const record = active[0];
-    ensure(safeSegment(record.version), 'Codex plugin version is invalid');
-    const installPath = path.join(config, 'plugins/cache', MARKETPLACE, PROVIDER, record.version);
-    add(pluginRoot({ installPath, version: record.version }, ['.codex-plugin/plugin.json', '.claude-plugin/plugin.json']), source);
-  } catch (error) { report(source, 'discovery-error', error.message); }
-}
-
-function registeredCandidates(host, config, project, add, report) {
-  const source = `${host}-plugin`, registryFile = path.join(config, 'plugins/installed_plugins.json'), settingsFile = path.join(config, 'settings.json');
-  try {
-    if (!fs.existsSync(registryFile)) { report(source, 'missing', 'Optional host plugin installation registry is absent'); return; }
-    const registry = json(registryFile);
-    ensure(registry.version === 2 && object(registry.plugins), 'Host plugin installation registry has an unsupported or invalid schema');
-    const entries = Object.entries(registry.plugins).filter(([id]) => id.startsWith(`${PROVIDER}@`));
-    if (!entries.length) { report(source, 'missing', 'Current host has no registered UI/UX Pro Max plugin'); return; }
-    ensure(fs.existsSync(settingsFile), 'Registered plugin enablement metadata is missing');
-    const settings = json(settingsFile);
-    ensure(object(settings) && object(settings.enabledPlugins), 'Host plugin enablement metadata is invalid');
-    const active = [];
-    let disabled = false;
-    for (const [id, records] of entries) {
-      ensure(Array.isArray(records), 'Host plugin registration must contain an installation array');
-      if (settings.enabledPlugins[id] !== true) { disabled = true; continue; }
-      for (const record of records) {
-        ensure(object(record), 'Host plugin installation entry is invalid');
-        if (record.scope === 'user') active.push(record);
-        else if (record.scope === 'project') {
-          ensure(typeof record.projectPath === 'string' && path.isAbsolute(record.projectPath), 'Project-scoped plugin requires an absolute projectPath');
-          if (canonical(record.projectPath) === canonical(project)) active.push(record);
-        } else throw new Error('Host plugin installation scope is unsupported');
-      }
-    }
-    if (!active.length) { report(source, disabled ? 'disabled' : 'missing', 'No enabled UI/UX Pro Max installation applies to the current project'); return; }
-    if (active.length !== 1) { report(source, 'ambiguous', 'Multiple applicable plugin installations require an explicit provider path'); return; }
-    const fallback = host === 'workbuddy' || host === 'codebuddy' ? './skills/' : undefined;
-    const manifests = host === 'claude' ? ['.claude-plugin/plugin.json'] : ['.codebuddy-plugin/plugin.json', '.claude-plugin/plugin.json'];
-    add(pluginRoot(active[0], manifests, fallback), source);
-  } catch (error) { report(source, 'discovery-error', error.message); }
-}
-
-function discoverProviderCandidates(options = {}) {
-  const result = { candidates: [], diagnostics: [] }, seen = new Set();
-  const report = (source, availability, reason) => result.diagnostics.push({ source, availability, reason });
-  const add = (root, source) => {
-    ensure(typeof root === 'string' && root, 'Provider root must be a nonempty path');
-    root = path.resolve(root);
-    if (!seen.has(root)) { seen.add(root); result.candidates.push({ root, source }); }
-  };
-  if (options.provider !== undefined) {
-    try { add(options.provider, 'explicit'); } catch (error) { report('explicit', 'discovery-error', error.message); }
-    return result;
-  }
-  if (options.providerRoots !== undefined) {
-    try {
-      ensure(Array.isArray(options.providerRoots), 'Host-exposed providerRoots must be an array');
-      for (const root of options.providerRoots) add(root, 'host-exposed');
-    } catch (error) { report('host-exposed', 'discovery-error', error.message); }
-    return result;
-  }
-  if (options.discover === false) return { ...result, contextRequired: true };
-  const host = options.host === 'claude-code' ? 'claude' : options.host;
-  if (!['codex', 'claude', 'workbuddy', 'codebuddy', 'gemini', 'cursor'].includes(host)) return { ...result, contextRequired: true };
-  const home = options.home || os.homedir(), env = options.env === undefined ? process.env : options.env, project = path.resolve(options.project || '.');
-  const configName = host === 'claude' ? 'CLAUDE_CONFIG_DIR' : `${host.toUpperCase()}_${host === 'codex' ? 'HOME' : 'CONFIG_DIR'}`;
-  const config = path.resolve(env[configName] || path.join(home, `.${host}`));
-  const projectFolder = host === 'codex' ? '.agents' : host === 'workbuddy' ? '.codebuddy' : `.${host}`;
-  const locations = [
-    [path.join(project, projectFolder, 'skills', PROVIDER), 'project-skill'],
-    ...(host === 'codex' ? [[path.join(home, '.agents/skills', PROVIDER), 'global-skill']] : []),
-    [path.join(config, 'skills', PROVIDER), 'global-skill'],
-  ];
-  for (const [root, source] of locations) if (fs.existsSync(path.join(root, 'SKILL.md'))) add(root, source);
-  if (host === 'codex') codexCandidates(config, project, env, add, report);
-  else if (['claude', 'workbuddy', 'codebuddy'].includes(host)) registeredCandidates(host, config, project, add, report);
-  return result;
-}
-
-module.exports = { discoverProviderCandidates };

package/skills/i3-ui-prototype/scripts/enterprise-template.cjs

@@ -1,104 +0,0 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-const crypto = require('node:crypto');
-const assert = require('node:assert/strict');
-const assetRoot = path.resolve(__dirname, '../assets/templates/enterprise-admin');
-const hash = bytes => crypto.createHash('sha256').update(bytes).digest('hex');
-function inventory(root, prefix = '') {
-  return fs.readdirSync(path.join(root, prefix), { withFileTypes: true }).flatMap(entry => {
-    const file = prefix ? prefix + '/' + entry.name : entry.name;
-    assert.ok(!entry.isSymbolicLink(), 'Refusing reference symlink: ' + file);
-    return entry.isDirectory() ? inventory(root, file) : [file];
-  }).sort();
-}
-function verifyReference(root = assetRoot) {
-  const origin = JSON.parse(fs.readFileSync(path.join(root, 'origin.json'), 'utf8'));
-  assert.equal(origin.schemaVersion, 1, 'Invalid enterprise source record');
-  const reference = path.join(root, 'reference');
-  const storedPaths = Object.keys(origin.files).map(file => origin.storagePaths?.[file] || file);
-  assert.equal(new Set(storedPaths).size, storedPaths.length, 'Duplicate enterprise asset mapping');
-  assert.deepEqual(inventory(reference), storedPaths.sort(), 'Enterprise source inventory changed');
-  assert.equal(origin.fileCount, Object.keys(origin.files).length, 'Enterprise source file count changed');
-  for (const [file, expected] of Object.entries(origin.files)) {
-    assert.ok(!path.isAbsolute(file) && !file.split(/[\\/]/).some(part => !part || part === '..'), 'Invalid source path');
-    const stored = origin.storagePaths?.[file] || file;
-    assert.ok(!path.isAbsolute(stored) && !stored.split(/[\\/]/).some(part => !part || part === '..'), 'Invalid mapped source path');
-    assert.equal(hash(fs.readFileSync(path.join(reference, stored))), expected, 'Enterprise source integrity / 来源完整性: ' + file);
-  }
-  assert.equal(hash(fs.readFileSync(path.join(reference, 'assets-manifest.json'))), origin.sourceManifestDigest, 'Invalid source manifest digest');
-  return origin;
-}
-function brandRuntimeResource(file, content) {
-  if (file !== 'index.html' && !/^src\/(?:[^/.][^/]*\/)*[^/]+\.(?:js|mjs|html)$/.test(file)) return content;
-  const text = Buffer.isBuffer(content) ? content.toString('utf8') : content;
-  const branded = text.replaceAll('EASEL', 'i3-Composer');
-  return branded === text ? content : Buffer.isBuffer(content) ? Buffer.from(branded, 'utf8') : branded;
-}
-const mapping = {
-  schemaVersion: 1,
-  scope: 'i3-Composer 企业后台完整示例；模板审查范围，不代表其他业务已适配',
-  requirements: [
-    { id: 'ENT-01', pages: ['#/workbench'], roles: ['演示身份'], actions: ['查看工作台和导航'], scenarios: ['enterprise-navigation'] },
-    { id: 'ENT-02', pages: ['#/models'], roles: ['有模型编辑权限的演示身份'], actions: ['新增模型', '校验和保存草稿'], scenarios: ['enterprise-form'] },
-    { id: 'ENT-03', pages: ['#/models', '#/permissions'], roles: ['演示身份', '只读身份'], actions: ['切换身份并检查动作权限'], scenarios: ['enterprise-permissions'] },
-    { id: 'ENT-04', pages: ['#/workflows'], roles: ['演示身份'], actions: ['查看和编辑流程'], scenarios: ['enterprise-workflow'] },
-    { id: 'ENT-05', pages: ['#/pbcs'], roles: ['演示身份'], actions: ['查看 PBC 并操作业务向导'], scenarios: ['enterprise-pbc'] },
-    { id: 'ENT-06', pages: ['#/workbench', '#/models', '#/intents/new'], roles: ['演示身份'], actions: ['窄屏导航', '键盘开关菜单', '保留未保存输入'], scenarios: ['enterprise-responsive', 'enterprise-keyboard'] },
-    { id: 'ENT-07', pages: ['#/models'], roles: ['演示身份'], actions: ['查看空、失败等演示反馈'], scenarios: ['enterprise-feedback'] },
-    { id: 'ENT-08', pages: ['app/routes.json'], roles: ['演示身份'], actions: ['打开原版已提供的全部页面入口'], scenarios: ['enterprise-routes'] },
-  ],
-  openQuestions: ['新项目的模块、字段、状态、权限及接口需按实际需求替换。原有 i3-Composer 示例不自动成为新业务规格。'],
-};
-function initialize(directory, { id, title, purpose, templateRoot = assetRoot }) {
-  const origin = verifyReference(templateRoot);
-  assert.ok(['template-review', 'business-prototype'].includes(purpose), 'Invalid enterprise prototype purpose');
-  const app = path.join(directory, 'app');
-  const instanceId = crypto.randomUUID();
-  const storagePrefix = 'i3-enterprise-' + id + '-' + instanceId + '-';
-  fs.cpSync(path.join(templateRoot, 'reference'), app, { recursive: true });
-  // Skill-supporting Markdown follows the repository naming convention. The
-  // source name and bytes are recorded, then restored in each runnable copy.
-  for (const [original, stored] of Object.entries(origin.storagePaths || {})) {
-    fs.renameSync(path.join(app, stored), path.join(app, original));
-  }
-  const adaptations = [];
-  for (const file of inventory(app).filter(name => name !== 'index.html' && /\.(?:js|mjs|html)$/.test(name))) {
-    const location = path.join(app, file), old = fs.readFileSync(location, 'utf8');
-    const reasons = [], branded = brandRuntimeResource(file, old);
-    if (branded !== old) reasons.push('运行时可见品牌与示例数据统一为 i3-Composer');
-    const next = /\.(?:js|mjs)$/.test(file) ? branded.replaceAll('i3-prototype-antdv-', storagePrefix) : branded;
-    if (next !== branded) reasons.push('替换本地演示存储前缀，隔离不同原型实例');
-    if (next !== old) {
-      fs.writeFileSync(location, next);
-      adaptations.push({ file, reason: reasons.join('；'), source: origin.files[file], generated: hash(next) });
-    }
-  }
-  const index = path.join(app, 'index.html');
-  const portable = fs.readFileSync(path.join(templateRoot, 'index.html'), 'utf8');
-  assert.ok(portable.includes('src="offline.js"') && !portable.includes('type="module"'), 'Offline enterprise entry required');
-  const adapted = portable.replaceAll('href="reference/', 'href="').replaceAll('data-source="reference/', 'data-source="')
-    .replace('</head>', '  <link rel="stylesheet" href="tokens.css">\n</head>')
-    .replace(/(<script type="application\/json" id="prototype-offline-config">)[\s\S]*?(<\/script>)/,
-      (_, start, end) => start + JSON.stringify({ title }).replaceAll('<', '\\u003c') + end);
-  fs.writeFileSync(index, adapted);
-  const offline = fs.readFileSync(path.join(templateRoot, 'offline.js'), 'utf8')
-    .replaceAll('new URL("reference/', 'new URL("').replaceAll('i3-prototype-antdv-', storagePrefix);
-  fs.writeFileSync(path.join(app, 'offline.js'), offline);
-  adaptations.push({ file: 'index.html', reason: 'i3-Composer 完整可编辑 HTML 片段、路由和实例配置内嵌；经典脚本支持 file://；保留全部内容与本地样式', source: origin.files['index.html'], generated: hash(adapted) });
-  adaptations.push({ file: 'offline.js', reason: '来源模块的离线运行适配，实例存储前缀隔离；原始模块仍保留', generated: hash(offline) });
-  fs.copyFileSync(path.join(templateRoot, 'usability.css'), path.join(app, 'usability.css'));
-  fs.writeFileSync(path.join(app, 'enterprise-bootstrap.mjs'), "const response = await fetch(new URL('./config.json', import.meta.url));\nif (!response.ok) throw new Error('无法读取企业后台实例配置');\nconst config = await response.json();\ndocument.title = config.title;\nawait import('./app.js');\n");
-  fs.copyFileSync(path.join(templateRoot, 'serve.cjs'), path.join(app, 'serve.cjs'));
-  fs.mkdirSync(path.join(directory, 'design-system'), { recursive: true });
-  fs.writeFileSync(path.join(directory, 'design-system/MASTER.md'), fs.readFileSync(path.join(templateRoot, 'design-system.md')));
-  fs.writeFileSync(path.join(directory, 'design-system/source.json'), JSON.stringify({
-    schemaVersion: 1, source: origin.source, sourceVersion: origin.sourceVersion, sourceManifestDigest: origin.sourceManifestDigest,
-    sourceFileCount: origin.fileCount, adaptations, purpose, description: '所有来源文件已复制；运行时统一使用 i3-Composer 品牌，并保留初始化接入和存储隔离记录。app/qa 是历史来源证据，当前验收使用原型根 qa/。',
-  }, null, 2) + '\n');
-  fs.mkdirSync(path.join(directory, 'mocks'), { recursive: true });
-  fs.writeFileSync(path.join(directory, 'mocks/README.md'), '# 演示数据\n\n完整 i3-Composer 示例的数据与规则保留在 app/src/ 各模块中，并使用实例独立的本地存储。它们用于模板审查；新业务需要按需求替换，不能当作真实服务或已完成业务适配。\n');
-  fs.writeFileSync(path.join(directory, 'requirements-map.json'), JSON.stringify(mapping, null, 2) + '\n');
-  return { kind: 'easel-html', entry: 'app/index.html', sourceVersion: origin.sourceVersion, instanceId, storagePrefix, offlineVersion: 1 };
-}
-module.exports = { verifyReference, initialize, brandRuntimeResource };

package/skills/i3-ui-prototype/scripts/execution-assertions.cjs

@@ -1,43 +0,0 @@
-'use strict';
-const assert=require('node:assert/strict'),E=require('./execution-evidence.cjs');
-const METHODS=['evaluate_script','take_snapshot','list_console_messages','list_network_requests','performance_stop_trace'];
-function validate(value,scenarioIds) {
- assert.equal(value?.schemaVersion,1,'Fixed native assertions schema required');assert.ok(Array.isArray(value.scenarios),'Fixed native assertion scenarios required');
- assert.deepEqual(value.scenarios.map(s=>s.scenarioId).sort(),[...scenarioIds].sort(),'Fixed native assertion scenario coverage differs');
- for(const scenario of value.scenarios) {
-  assert.ok(scenario.checks?.length,'Each fixed scenario needs actual result assertions before implementation');
-  for(const check of scenario.checks) {
-   assert.ok(METHODS.includes(check.method),'Unsupported native assertion method');
-   assert.ok(typeof check.pointer==='string'&&/^\/(?:[^~]|~[01])*$/.test(check.pointer)&&!/(?:__proto__|constructor|prototype)/.test(check.pointer),'Safe JSON pointer required');
-   assert.ok(['equals','includes','gte','lte'].includes(check.operator),'Unsupported native assertion operator');
-   assert.ok(Object.hasOwn(check,'expected')&&check.expected!==null,'Explicit fixed expected fact required');
-   if(['gte','lte'].includes(check.operator))assert.equal(typeof check.expected,'number','Numeric fixed expectation required');
-  }
- }
- return value;
-}
-function resultData(result) {
- const text=E.resultText(result).trim();let value;
- try{value=JSON.parse(text);}catch{const blocks=[...text.matchAll(/```(?:json)?\s*\n([\s\S]*?)\n```/g)];assert.equal(blocks.length,1,'One actual JSON result or JSON code block required');value=JSON.parse(blocks[0][1]);}
- assert.ok(value&&typeof value==='object','Native JSON fact result required');return value;
-}
-function extract(value,pointer) {
- for(const part of pointer.slice(1).split('/').map(p=>p.replaceAll('~1','/').replaceAll('~0','~'))) {assert.ok(value&&Object.hasOwn(value,part),'Native expected fact is absent');value=value[part];}return value;
-}
-function compare(actual,check) {
- if(check.operator==='equals')assert.deepEqual(actual,check.expected,'Native fact differs from fixed expectation');
- else if(check.operator==='includes')assert.ok((typeof actual==='string'||Array.isArray(actual))&&actual.includes(check.expected),'Native fact does not include fixed expectation');
- else {assert.equal(typeof actual,'number','Native numeric fact required');assert.ok(check.operator==='gte'?actual>=check.expected:actual<=check.expected,'Native numeric fact differs from fixed expectation');}
-}
-function template(options) {
- const fs=require('node:fs'),path=require('node:path'),T=require('./template-contract.cjs');
- assert.ok(options.scope,'Sourced scope file required');const scope=JSON.parse(fs.readFileSync(path.resolve(options.scope),'utf8'));
- const snapshot=options.templateRoot?T.loadTemplate(path.resolve(options.templateRoot)):T.loadBundledTemplate(options.template);
- const selection=snapshot.kind==='content-reference'?require('./content-template.cjs').scopeInputs(snapshot,scope,T):null;
- const generation=scope.schemaVersion===3?require('./generation-contract.cjs').compile(snapshot,scope):null;
- const scenarios=[...(selection?.result.requiredScenarios||snapshot.index.requiredScenarios),...(generation?.scenarios||[])];
- const drawer=selection&&(selection.fixed.regions.some(r=>r.mode==='edit-form')||generation?.bindings.some(b=>b.capabilityId==='dialog'&&b.parameters.presentation==='drawer'));
- const framework=selection?['framework-responsive','framework-instance-isolation','template-content-projection',...(drawer?['framework-drawer-motion','framework-mask-blur','framework-focus-scroll']:[])]:['framework-drawer-motion','framework-mask-blur','framework-focus-scroll','framework-states','framework-responsive','framework-instance-isolation','template-content-projection'];
- return {schemaVersion:1,scopeDigest:E.sha(JSON.stringify(scope)),templateDigest:snapshot.digest,scenarios:[...scenarios.map(s=>({scenarioId:typeof s==='string'?s:s.id,expectedSummary:s.expected||null,checks:[]})),...framework.map(scenarioId=>({scenarioId,checks:[]}))]};
-}
-module.exports={validate,resultData,extract,compare,template};

package/skills/i3-ui-prototype/scripts/execution-diagnostics.cjs

@@ -1,91 +0,0 @@
-'use strict';
-// Protocol failures exist before a run binding. Never turn them into invocation proof.
-const fs=require('node:fs'),path=require('node:path');
-const F=require('./native-files.cjs'),C=require('./codebuddy-context.cjs'),E=require('./execution-evidence.cjs'),H=require('./buddy-host.cjs');
-const read=file=>fs.existsSync(file)?JSON.parse(C.read(file)):null;
-function location(payload,options){
- if(!payload.session_id||!path.isAbsolute(options.base||''))return null;
- const installation=read(path.join(options.base,'state/i3-prototype/installation.json'));if(!installation)return null;
- const identity=H.identify(payload,installation,options),pointer=`state/i3-prototype/tasks/${E.sha(identity.host+':'+identity.product+':'+payload.session_id).slice(0,24)}.json`;
- const previous=read(F.inside(options.base,pointer));
- let project=options.scope==='project'?path.dirname(options.base):previous?.project;
- if(!project)project=H.isIDE(payload)&&payload.cwd==='/'?E.ideWorkspace(payload.transcript_path,payload.session_id):payload.cwd;
- if(!project||!path.isAbsolute(project))return null;project=fs.realpathSync(project);
- if(payload.cwd&&payload.cwd!=='/'){
-  const relative=path.relative(project,fs.realpathSync(payload.cwd));if(relative==='..'||relative.startsWith('..'+path.sep)||path.isAbsolute(relative))return null;
- }
- const record={...installation,...identity,base:options.base,registrationDigest:E.sha(JSON.stringify(installation)),settingsDigest:E.sha(C.read(path.join(options.base,'settings.json')))};
- return {project,record,identity,pointer,previous,directory:C.sessionDirectory(record,project,payload.session_id)};
-}
-function context(payload,options,{source}={}){
- const where=location(payload,options);if(!where)return null;
- let native=source;if(!native)try{native=C.source(payload,where.record,where.project);}catch{/* Failure diagnostics must survive unreadable native history. */}
- // Diagnostics identify a session/context, never the wording of the last user
- // message. UserPromptSubmit can precede persistence: do not combine its text
- // with the preceding native prompt's cursor or digest.
- const contextLine=native?.contextLine??where.previous?.contextLine??0;
- const taskKey=E.sha(JSON.stringify([where.project,where.identity.host,where.identity.product,payload.session_id,contextLine]));
- const task={schemaVersion:2,taskKey,sessionId:payload.session_id,project:where.project,host:where.identity.host,product:where.identity.product,contextLine,
-  restriction:C.restriction(native?.prompts,where.previous?.restriction)};
- return {...where,source:native,task};
-}
-function remember(payload,options){
- const value=context(payload,options);if(!value)return;
- const id=payload.prompt_id||payload.generation_id;
- const submission=id?E.sha(JSON.stringify([id,payload.prompt||''])):null;
- const previous=value.previous?.submissions||[];
- if(submission&&previous.includes(submission))return;
- const control=C.userRestriction(payload.prompt||'');
- // Restrict immediately. Releasing permission waits for the corresponding
- // native user message, so a stale or unpersisted resume cannot grant writes.
- if(control===true)value.task.restriction.blocked=true;
- value.task.submissions=submission?[...previous.slice(-63),submission]:previous;
- F.write(options.base,value.pointer,value.task);
-}
-function state(value){return read(path.join(value.directory,'diagnostics.json'))||{schemaVersion:1,tasks:{}};}
-function message(failure){return `原型 Hook 无法核验当前操作${failure.status==='blocked'?'，已停止重复提示':''}：${failure.reason}。请简要报告未验收项，由维护入口处理；不要在原型任务中修复 Hook 或重复绑定，也不能宣称已验证。`;}
-function failure(value,payload,error){
- if(!value)return {continue:true};
- return F.withLock(value.directory,'.diagnostics.lock',()=>{
- const store=state(value),key=value.task.taskKey;
- const phase=/JSON|transcript|source|history|日志/i.test(error.message)?'native-source':'native-request';
- const eventKey=E.sha(JSON.stringify([key,payload.tool_use_id||payload.call_id||payload.hook_event_name,payload.tool_name||null,payload.tool_input||null,phase]));
- const item=store.tasks[key]||{schemaVersion:1,taskKey:key,total:0,counts:{},events:{},status:'required'};
- if(!item.events[eventKey]&&item.status!=='blocked'){
-  if(item.total>=6||(item.counts[phase]||0)>=2)item.status='blocked';
-  else {item.total++;item.counts[phase]=(item.counts[phase]||0)+1;item.status='required';}
-  Object.assign(item,{eventKey,reason:String(error.message).slice(0,2000),phase,at:new Date().toISOString(),host:value.identity.host,product:value.identity.product,productVersion:value.identity.productVersion,
-   callMode:payload.agent_type==='ptc'||value.source?.calls.some(c=>c.name==='REPL')?'ptc-repl':value.identity.product==='ide'?'native-ide':'direct',sessionId:payload.session_id,project:value.project,
-   registrationDigest:value.record.registrationDigest,settingsDigest:value.record.settingsDigest,transcriptPath:payload.transcript_path});
-  item.events[eventKey]=true;store.tasks[key]=item;F.write(value.directory,'diagnostics.json',store);
- }
- const result={reason:message(item),failure:item};
- return payload.hook_event_name==='PreToolUse'?{...result,deny:true}:{continue:true,failure:item,...(item.status!=='blocked'?{context:result.reason}:{})};
- });
-}
-function recover(value){
- if(!value)return;
- return F.withLock(value.directory,'.diagnostics.lock',()=>{const store=state(value),item=store.tasks[value.task.taskKey];
-  if(item&&item.status!=='recovered'){item.status='recovered';item.recoveredAt=new Date().toISOString();F.write(value.directory,'diagnostics.json',store);}
- });
-}
-function observed(value,payload){
- if(!value)return;
- const source=C.source(payload,value.record,value.project),at=new Date().toISOString();
- const entry={schemaVersion:1,sessionId:payload.session_id,taskKey:value.task.taskKey,project:value.project,projectKey:C.projectKey(value.project),host:value.identity.host,product:value.identity.product,
-  productVersion:value.identity.productVersion,identitySource:value.identity.identitySource,registrationDigest:value.record.registrationDigest,settingsDigest:value.record.settingsDigest,
-  source:{path:source.path,bytes:source.bytes,digest:source.digest},callMode:source.callMode||'direct',skills:Object.fromEntries(['prototype','frontend','antdv','uiux','browser'].map(key=>[key,E.loaded(source.calls,key).length])),
-  lastHook:{event:payload.hook_event_name,at}};
- F.write(value.directory,'observation.json',entry);
-}
-function latest({base,project,host,record}){
- const parent=path.join(base,'state/i3-prototype',C.projectKey(project));let found=null;
- if(!fs.existsSync(parent))return null;
- for(const name of fs.readdirSync(parent)){
-  if(!/^[a-f0-9]{24}$/.test(name))continue;
-  const data=read(path.join(parent,name,'diagnostics.json'));if(!data)continue;
-  for(const item of Object.values(data.tasks||{}))if(item.host===host&&item.project===project&&item.registrationDigest===record.registrationDigest&&item.settingsDigest===record.settingsDigest&&item.status!=='recovered'&&(!found||item.at>found.at))found=item;
- }
- if(!found)return null;const {events,...summary}=found;return summary;
-}
-module.exports={context,remember,failure,recover,observed,latest};

package/skills/i3-ui-prototype/scripts/execution-evidence.cjs

@@ -1,177 +0,0 @@
-'use strict';
-const assert = require('node:assert/strict');
-const crypto = require('node:crypto');
-const fs = require('node:fs');
-const path = require('node:path');
-const P = require('./execution-policy.cjs');
-const {toolName}=require('./native-tool-name.cjs');
-const sha = value => crypto.createHash('sha256').update(value).digest('hex');
-function contentText(content) {
-  if (typeof content === 'string') return content;
-  if (content?.type === 'text' && typeof content.text === 'string') return content.text;
-  if (Array.isArray(content)) return content.map(item => item?.type === 'text' ? item.text || '' : item?.type === 'image' ? '[native image result]' : '').join('\n');
-  return content === undefined ? '' : JSON.stringify(content);
-}
-// CodeBuddy Code 2.169 serializes flat message/function_call rows. Keep the
-// original line cursor and session identity while adapting only observed shapes.
-// Legacy assistant/user + tool_use/tool_result JSONL remains supported.
-function nativeEvent(event) {
-  if (event.type === 'message' && ['assistant', 'user'].includes(event.role)) {
-    const content = Array.isArray(event.content) ? event.content.map(block =>
-      ['input_text', 'output_text'].includes(block?.type) ? { ...block, type: 'text' } : block) : event.content;
-    return { ...event, type: event.role, isMeta:event.isMeta===true||event.providerData?.isMeta===true, message: { content } };
-  }
-  if (event.type === 'function_call') {
-    let input;
-    try { input = typeof event.arguments === 'string' ? JSON.parse(event.arguments) : event.arguments; }
-    catch { throw new Error('Invalid native function arguments JSON'); }
-    assert.ok(input && typeof input === 'object' && !Array.isArray(input), 'Invalid native function arguments');
-    return { ...event, type: 'assistant', message: { content: [{ type: 'tool_use', id: event.callId, name: event.name, input }] } };
-  }
-  if (event.type === 'function_call_result') {
-    return { ...event, type: 'user', message: { content: [{ type: 'tool_result', tool_use_id: event.callId,
-      tool_name: event.name, content: event.output, is_error: event.status !== 'completed' }] } };
-  }
-  return event;
-}
-function successful(block) {
-  if (block.is_error || block.isError || block.success === false || block.error) return false;
-  const text = contentText(block.content ?? block.result ?? block.tool_response);
-  if (!text.trim()) return false;
-  function failed(value,depth=0) {
-    if(depth>8)return true;
-    if(typeof value==='string'){
-      if(/^\s*(?:Error:|Error\b|错误[:：]|Unknown skill\b|Skill[^\n]*not (?:found|available))/i.test(value))return true;
-      try{return failed(JSON.parse(value),depth+1);}catch{return false;}
-    }
-    if(!value||typeof value!=='object')return false;
-    if(value.type==='text')return failed(value.text,depth+1);
-    if(value.isError||value.is_error||value.success===false||value.error||['failed','error','cancelled'].includes(value.status))return true;
-    if(typeof value.exitCode==='number'&&value.exitCode!==0)return true;
-    if(typeof value.stdout==='string'&&failed(value.stdout,depth+1))return true;
-    // Only descend through native execution envelopes, not arbitrary observed
-    // application data such as {result:{status:'failed'}} from a browser check.
-    const envelope=typeof value.success==='boolean'||['success','error'].includes(value.status)||value.type==='execute_command_result';
-    return !!(envelope&&value.result!==undefined&&failed(value.result,depth+1));
-  }
-  return !failed(text);
-}
-function resultContent(content){
-  let value=content;
-  for(let depth=0;depth<8;depth++){
-    if(typeof value==='string'){
-      try{const parsed=JSON.parse(value);if(parsed&&typeof parsed==='object'&&(parsed.type==='text'||parsed.type==='execute_command_result'||typeof parsed.success==='boolean')){value=parsed;continue;}}catch{/* Plain text and fenced MCP facts remain text. */}
-      return value;
-    }
-    if(Array.isArray(value)){value=contentText(value);continue;}
-    if(value?.type==='text'){value=value.text;continue;}
-    if(!value||typeof value!=='object')return value;
-    if((typeof value.success==='boolean'||['success','error'].includes(value.status)||value.type==='execute_command_result')&&value.result!==undefined){value=value.result;continue;}
-    if(typeof value.stdout==='string'){value=value.stdout;continue;}
-    return value;
-  }
-  return null;
-}
-function resultValue(content){
-  const value=resultContent(content);
-  if(typeof value==='string'){try{return JSON.parse(value);}catch{return null;}}
-  return value;
-}
-const resultText=content=>contentText(resultContent(content));
-function parse(text) {
-  assert.ok(typeof text === 'string' && Buffer.byteLength(text) <= 64 * 1024 * 1024, 'Native transcript is too large');
-  const calls = [], requests = new Map(); let nativeMessages = 0, contextLine = 0, promptLine = 0;
-  for (const [lineIndex, line] of text.split('\n').entries()) {
-    if (!line.trim()) continue;
-    let event; try { event = JSON.parse(line); } catch { throw new Error(`Invalid native JSONL at line ${lineIndex + 1}`); }
-    event = nativeEvent(event);
-    if (event.type === 'system' && ['compact_boundary','compact'].includes(event.subtype)) contextLine = lineIndex + 1;
-    const message = event.message;
-    if (!message || !['assistant', 'user'].includes(event.type)) continue;
-    const content = typeof message.content === 'string' ? [{type:'text',text:message.content}] : message.content;
-    if (!Array.isArray(content)) continue;
-    nativeMessages++;
-    if (event.type === 'user' && !event.isMeta && !event.isSidechain && content.some(block=>block.type==='text') && !content.some(block=>block.type==='tool_result')) promptLine = lineIndex + 1;
-    for (const block of content) {
-      if (event.type === 'assistant' && block.type === 'tool_use') {
-        assert.ok(typeof block.id === 'string' && block.id && typeof block.name === 'string', 'Native request identity missing');
-        assert.ok(!requests.has(block.id), 'Duplicate native tool call ID');
-        const name=toolName(block.name),input = block.input || {}, skillName = name==='Skill' ? input.skill || input.name || input.command : null;
-        const normalized = typeof skillName === 'string' ? skillName.replace(/^i3-composer-agent:/, '') : null;
-        const call = { toolCallId: block.id, name, ...(name!==block.name?{rawName:block.name}:{}), input, skillName: normalized, skill: P.skillKey(normalized),
-          sessionId:event.sessionId||event.session_id||null, cwd:event.cwd||null, nativeRequestId:event.nativeRequestId||null, contextLine, promptLine,
-          requestLine: lineIndex + 1, requestDigest: sha(JSON.stringify(block)), success: false };
-        requests.set(block.id, call); calls.push(call);
-      } else if (event.type === 'user' && block.type === 'tool_result') {
-        const call = requests.get(block.tool_use_id);
-        assert.ok(call && !call.resultLine, 'Unmatched or duplicate native tool result');
-        if (block.tool_name !== undefined) assert.equal(toolName(block.tool_name), call.name, 'Native tool result name differs');
-        if (call.sessionId && (event.sessionId||event.session_id)) assert.equal(call.sessionId,event.sessionId||event.session_id,'Cross-session native result');
-        Object.assign(call, { resultLine: lineIndex + 1, resultDigest: sha(JSON.stringify(block)),
-          result: block.content, success: successful(block) });
-      }
-    }
-  }
-  assert.ok(nativeMessages, 'No native assistant/user transcript messages');
-  return calls;
-}
-function loaded(calls, skill) { return calls.filter(call => call.skill === skill && call.success && call.resultLine); }
-function reference(calls, value) {
-  const call = calls.find(item => item.toolCallId === value?.toolCallId);
-  assert.ok(call?.success && call.resultLine, 'Successful native tool result missing');
-  if (value.resultDigest !== undefined) assert.equal(value.resultDigest, call.resultDigest, 'Native result digest differs');
-  return call;
-}
-function describe(text) {
-  const prompts=[];let contextLine=0,latestAssistant='';
-  for(const [index,line] of text.split('\n').entries()) {
-    if(!line.trim())continue;const row=nativeEvent(JSON.parse(line));
-    if(row.type==='system'&&['compact_boundary','compact'].includes(row.subtype))contextLine=index+1;
-    const content=row.message?.content;
-    if(row.type==='assistant'&&(typeof content==='string'||Array.isArray(content)&&content.some(b=>b.type==='text')&&!content.some(b=>b.type==='tool_use')))latestAssistant=contentText(content);
-    if(row.type==='user'&&!row.isMeta&&!row.isSidechain&&(typeof content==='string'||Array.isArray(content)&&content.some(b=>b.type==='text')&&!content.some(b=>b.type==='tool_result')))
-      prompts.push({line:index+1,digest:sha(line),text:contentText(content),sessionId:row.sessionId||row.session_id||null,
-        ...(row.nativeRequestId?{nativeRequestId:row.nativeRequestId}:{})});
-  }
-  return {prompts,contextLine,latestAssistant};
-}
-function sourceData(file) {
-  if(path.basename(file)==='index.json') {
-    const ide=require('./codebuddy-ide-source.cjs').read(file);
-    return {...ide,buffer:Buffer.from(ide.text)};
-  }
-  const buffer=fs.readFileSync(file);return {buffer,text:buffer.toString('utf8'),format:'native-jsonl'};
-}
-function cursorBytes(file){return sourceData(file).buffer;}
-function ideWorkspace(file,sessionId) {
-  assert.ok(typeof file==='string'&&path.isAbsolute(file)&&path.basename(file)==='index.json','Native IDE index path required');
-  assert.equal(path.basename(path.dirname(file)),sessionId,'Native IDE session directory differs');
-  const data=sourceData(file);assert.ok(data.workspace,'Native IDE workspace context is missing');
-  return data.workspace;
-}
-function readSource(file, roots, {mode='manual',project}={}) {
-  assert.ok(typeof file==='string'&&path.isAbsolute(file)&&!/[\x00\r\n]/.test(file), 'Absolute native transcript file required');
-  assert.ok(['auto','manual'].includes(mode)&&Array.isArray(roots), 'Invalid native transcript policy');
-  if(mode==='manual')assert.ok(roots.length, 'Configured host transcript roots required');
-  else assert.equal(roots.length,0,'Automatic transcript mode cannot bypass configured manual roots');
-  const real = fs.realpathSync(file);
-  if(mode==='manual')assert.ok(roots.some(root => { if(!fs.existsSync(root))return false;const relative = path.relative(fs.realpathSync(root), real); return relative && relative!=='..'&&!relative.startsWith('..'+path.sep) && !path.isAbsolute(relative); }), 'Transcript is outside the configured native host log roots');
-  if(mode==='auto') {
-    assert.ok(typeof project==='string'&&path.isAbsolute(project), 'Native project required for automatic transcript validation');
-    const relative=path.relative(fs.realpathSync(project),real);
-    assert.ok(relative==='..'||relative.startsWith('..'+path.sep)||path.isAbsolute(relative), 'Native transcript cannot be inside the business project');
-  }
-  assert.ok(!fs.lstatSync(file).isSymbolicLink() && fs.statSync(real).isFile() && fs.statSync(real).size <= 64 * 1024 * 1024, 'Invalid native transcript file');
-  const data=sourceData(real),text=data.text,calls=parse(text);
-  if(data.workspace&&project)assert.equal(fs.realpathSync(data.workspace),fs.realpathSync(project),'Native IDE workspace differs from the bound project');
-  // IDE rewrites streaming argument objects before persisting their results.
-  // Freeze only the completed prefix; a pending request cannot attest success.
-  const pending=data.format==='codebuddy-ide-index-v1'?calls.filter(call=>!call.resultLine):[];
-  const firstPending=pending.length?Math.min(...pending.map(call=>call.requestLine)):null;
-  const bytes=firstPending?Buffer.from(text.split('\n').slice(0,firstPending-1).join('\n')+'\n'):data.buffer;
-  return { path: real, digest: sha(bytes), bytes: bytes.length, format:data.format, calls, ...describe(text),
-    ...(firstPending?{stableThroughLine:firstPending-1}:{}),
-    ...(data.latestAssistant!==undefined?{latestAssistant:data.latestAssistant}:{}),
-    sourceVerification: mode==='auto'?'native-hook-transcript':'configured-host-transcript', tamperProof: false };
-}
-module.exports = { sha, contentText, successful, resultContent, resultText, resultValue, parse, loaded, reference, describe, readSource, cursorBytes, ideWorkspace };