@givolt/i3-composer-agent 2.3.0 → 2.3.2

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

@@ -0,0 +1,128 @@
+'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

@@ -29,9 +29,15 @@ function verifyReference(root = assetRoot) {
   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: 'EASEL 企业后台完整示例；模板审查范围，不代表其他业务已适配',
+  scope: 'i3-Composer 企业后台完整示例；模板审查范围，不代表其他业务已适配',
   requirements: [
     { id: 'ENT-01', pages: ['#/workbench'], roles: ['演示身份'], actions: ['查看工作台和导航'], scenarios: ['enterprise-navigation'] },
     { id: 'ENT-02', pages: ['#/models'], roles: ['有模型编辑权限的演示身份'], actions: ['新增模型', '校验和保存草稿'], scenarios: ['enterprise-form'] },
@@ -42,7 +48,7 @@ const mapping = {
     { id: 'ENT-07', pages: ['#/models'], roles: ['演示身份'], actions: ['查看空、失败等演示反馈'], scenarios: ['enterprise-feedback'] },
     { id: 'ENT-08', pages: ['app/routes.json'], roles: ['演示身份'], actions: ['打开原版已提供的全部页面入口'], scenarios: ['enterprise-routes'] },
   ],
-  openQuestions: ['新项目的模块、字段、状态、权限及接口需按实际需求替换。原有 EASEL 示例不自动成为新业务规格。'],
+  openQuestions: ['新项目的模块、字段、状态、权限及接口需按实际需求替换。原有 i3-Composer 示例不自动成为新业务规格。'],
 };
 function initialize(directory, { id, title, purpose, templateRoot = assetRoot }) {
   const origin = verifyReference(templateRoot);
@@ -57,20 +63,30 @@ function initialize(directory, { id, title, purpose, templateRoot = assetRoot })
     fs.renameSync(path.join(app, stored), path.join(app, original));
   }
   const adaptations = [];
-  for (const file of inventory(app).filter(name => /\.(?:js|mjs)$/.test(name))) {
+  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 next = old.replaceAll('i3-prototype-antdv-', storagePrefix);
+    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: '仅替换本地演示存储前缀，隔离不同原型实例', source: origin.files[file], generated: hash(next) });
+      adaptations.push({ file, reason: reasons.join('；'), source: origin.files[file], generated: hash(next) });
     }
   }
-  const index = path.join(app, 'index.html'), original = fs.readFileSync(index, 'utf8');
-  assert.ok(original.includes('src="app.js"'), 'Review changed EASEL boot entry before adapting');
-  const adapted = original.replace('</head>', '  <link rel="stylesheet" href="tokens.css">\n  <link rel="stylesheet" href="usability.css">\n</head>')
-    .replace('src="app.js"', 'src="enterprise-bootstrap.mjs"');
+  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);
-  adaptations.push({ file: 'index.html', reason: '接入原有设计 token、实例配置和独立滚动适配，完整保留页面内容', source: origin.files['index.html'], generated: hash(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'));
@@ -78,11 +94,11 @@ function initialize(directory, { id, title, purpose, templateRoot = assetRoot })
   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: '所有来源文件已复制；局部适配仅用于初始化接入。app/qa 是历史来源证据，当前验收使用原型根 qa/。',
+    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完整 EASEL 示例的数据与规则保留在 app/src/ 各模块中，并使用实例独立的本地存储。它们用于模板审查；新业务需要按需求替换，不能当作真实服务或已完成业务适配。\n');
+  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 };
+  return { kind: 'easel-html', entry: 'app/index.html', sourceVersion: origin.sourceVersion, instanceId, storagePrefix, offlineVersion: 1 };
 }
-module.exports = { verifyReference, initialize };
+module.exports = { verifyReference, initialize, brandRuntimeResource };

package/skills/i3-ui-prototype/scripts/manage-baseline.cjs

@@ -5,7 +5,7 @@ try {
   const { options, positional } = lib.parseArgs(process.argv.slice(2));
   const [operation, directory] = positional;
   if (!directory || !['inspect', 'manifest', 'revise', 'confirm-baseline'].includes(operation)) throw new Error('Usage: manage-baseline.cjs <inspect|manifest|revise|confirm-baseline> <directory> [--revision r002] [--confirmation file.json]');
-  const result = operation === 'manifest' ? lib.contentManifest(directory) : operation === 'inspect' ? lib.compareBaseline(directory) : operation === 'revise' ? lib.revisePrototype(directory, options.revision) : lib.freezeBaseline(directory, JSON.parse(fs.readFileSync(options.confirmation, 'utf8')));
+  const result = operation === 'manifest' ? lib.contentManifest(directory) : operation === 'inspect' ? lib.compareBaseline(directory) : operation === 'revise' ? lib.revisePrototype(directory, options.revision, options) : lib.freezeBaseline(directory, JSON.parse(fs.readFileSync(options.confirmation, 'utf8')));
   process.stdout.write(JSON.stringify(result, null, 2) + '\n');
   if (result.status === 'corrupt-baseline') process.exitCode = 1;
 } catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }