@givolt/i3-composer-agent 3.1.0 → 4.0.0

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

@@ -1,407 +0,0 @@
-'use strict';
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const path = require('node:path');
-const crypto = require('node:crypto');
-
-const ASSETS = path.resolve(__dirname, '../assets');
-const INDEX = 'capabilities.generated.json';
-const EXTRACTOR_VERSION = '1.1.0';
-const ID = /^[a-z][a-z0-9-]{0,63}$/;
-const VOID = new Set(['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', 'track', 'wbr']);
-const sha = value => crypto.createHash('sha256').update(value).digest('hex');
-const canonical = value => JSON.stringify(value);
-function readJson(file) { return JSON.parse(fs.readFileSync(file, 'utf8')); }
-function identifier(value, label) { if (!ID.test(value || '')) throw new Error(`Invalid identifier / 标识: ${label}: ${value}`); }
-function assertNoSymlinks(file) {
-  let current = path.resolve(file);
-  while (true) {
-    // macOS exposes its system temporary directories through these fixed aliases.
-    const systemAlias = process.platform === 'darwin' && ['/var', '/tmp'].includes(current) && fs.realpathSync(current) === `/private${current}`;
-    if (fs.existsSync(current) && fs.lstatSync(current).isSymbolicLink() && !systemAlias) throw new Error(`Symlink / 符号链接 is not allowed: ${current}`);
-    const parent = path.dirname(current);
-    if (parent === current) break;
-    current = parent;
-  }
-}
-function filesUnder(directory) {
-  const files = [];
-  function walk(current, relative = '') {
-    for (const entry of fs.readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name, 'en'))) {
-      if (entry.name === INDEX || entry.name.startsWith(`.${INDEX}.`)) continue;
-      const file = path.join(current, entry.name);
-      const name = relative ? `${relative}/${entry.name}` : entry.name;
-      if (entry.isSymbolicLink()) throw new Error(`Symlink / 符号链接 is not allowed: ${name}`);
-      if (entry.isDirectory()) walk(file, name);
-      else if (entry.isFile()) files.push({ path: name, digest: sha(fs.readFileSync(file)) });
-      else throw new Error(`Unsupported template source: ${name}`);
-    }
-  }
-  assertNoSymlinks(directory);
-  walk(directory);
-  return files;
-}
-function localFile(directory, relative) {
-  if (typeof relative !== 'string' || !relative || path.isAbsolute(relative) || relative.split(/[\\/]/).includes('..')) throw new Error(`Unsafe template file: ${relative}`);
-  const target = path.resolve(directory, relative);
-  assertNoSymlinks(target);
-  return target;
-}
-function attributes(tag) {
-  const values = {};
-  const expression = /([^\s=<>/]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g;
-  const body = tag.replace(/^<\/?[\w:-]+/, '').replace(/\/?\s*>$/, '');
-  let match;
-  while ((match = expression.exec(body))) {
-    const key = match[1].toLowerCase();
-    if (Object.hasOwn(values, key)) throw new Error(`Duplicate HTML attribute: ${key}`);
-    values[key] = (match[2] ?? match[3] ?? match[4] ?? '').replace(/&quot;/g, '"').replace(/&#39;|&apos;/g, "'").replace(/&amp;/g, '&');
-  }
-  return values;
-}
-function visibleText(value) {
-  return value.replace(/&#(x[0-9a-f]+|\d+);/gi, (match,code)=>{
-    const point=code[0].toLowerCase()==='x'?parseInt(code.slice(1),16):parseInt(code,10);
-    return point>0&&point<=0x10ffff?String.fromCodePoint(point):match;
-  }).replace(/&(nbsp|lt|gt|quot|apos|amp);/g,(_,entity)=>({nbsp:' ',lt:'<',gt:'>',quot:'"',apos:"'",amp:'&'})[entity]).replace(/\s+/g,' ').trim();
-}
-function extractHtml(html, file, result) {
-  const stack = [];
-  const labels=new Map(),fieldTargets=[];
-  function close(frame) {
-    const text=visibleText(frame.text);
-    if(frame.name==='h1'&&frame.pageEntry&&!frame.pageEntry.title)frame.pageEntry.title=text;
-    if(frame.name==='h2'&&frame.regionEntry&&!frame.regionEntry.title)frame.regionEntry.title=text;
-    if(frame.contentId==='page-description'&&frame.pageEntry)frame.pageEntry.description=text;
-    for(const item of frame.items)if(text&&!frame.explicitLabel){item.label=text;item.labelSource='text';}
-    if(frame.name==='label') {
-      const label=text.replace(/\s*\*\s*$/,'').trim();
-      if(frame.labelFor)labels.set(frame.labelFor,label);
-      for(const item of frame.labelFields)if(label&&item.labelSource!=='data-label'){item.label=label;item.labelSource='label';}
-    }
-  }
-  const cleaned = html.replace(/<(script|style)\b([^>]*)>[\s\S]*?<\/\1\s*>/gi, '<$1$2></$1>');
-  const tokens = cleaned.match(/<!--[\s\S]*?-->|<![^>]*>|<\/?(?:[^'"<>]|"[^"]*"|'[^']*')+>|[^<]+/g) || [];
-  for (const token of tokens) {
-    if (token.startsWith('<!')) continue;
-    if(!token.startsWith('<')) {
-      for(let i=0;i<stack.length;i++) {
-        if(stack[i].name==='label'&&stack.slice(i+1).some(frame=>['input','select','textarea','button'].includes(frame.name)))continue;
-        stack[i].text+=token;
-      }
-      continue;
-    }
-    const closing = /^<\//.test(token);
-    const name = /^<\/?\s*([\w:-]+)/.exec(token)?.[1]?.toLowerCase();
-    if (!name) continue;
-    if (closing) {
-      const last = stack.pop();
-      if (!last || last.name !== name) throw new Error(`Malformed HTML nesting in ${file}: ${name}`);
-      close(last);
-      continue;
-    }
-    const attr = attributes(token);
-    if (name === 'script' && attr.type === 'module') throw new Error(`Offline / 离线 template cannot use module scripts: ${file}`);
-    const resource = ['script', 'img', 'audio', 'video', 'source', 'iframe'].includes(name) ? attr.src : name === 'link' ? attr.href : undefined;
-    if (resource) {
-      if (/^(?:[a-z][a-z0-9+.-]*:|\/\/|\/)/i.test(resource)) throw new Error(`Offline / 离线 template requires local resources: ${resource}`);
-      result.resources.push({ file, path: resource.split(/[?#]/)[0] });
-    }
-    const parent = stack.at(-1) || {};
-    const context = { name, pageId: parent.pageId, regionId: parent.regionId, mode: parent.mode, capabilityId: parent.capabilityId, pageEntry:parent.pageEntry,regionEntry:parent.regionEntry,text:'',items:[],labelFields:[],labelFor:attr.for,contentId:attr['data-content-id'],explicitLabel:attr['data-label'] };
-    if (attr['data-page-id']) {
-      identifier(attr['data-page-id'], 'page');
-      context.pageId = attr['data-page-id']; context.regionId = undefined; context.capabilityId = undefined;
-      if (result.pages.some(page => page.id === context.pageId)) throw new Error(`Duplicate page identity / 身份: ${context.pageId}`);
-      context.pageEntry={id:context.pageId,file};context.regionEntry=undefined;
-      result.pages.push(context.pageEntry);
-    }
-    if (attr['data-region-id']) {
-      identifier(attr['data-region-id'], 'region');
-      if (!context.pageId) throw new Error(`Region requires page identity: ${file}`);
-      context.regionId = attr['data-region-id']; context.mode = attr['data-region-mode']; context.capabilityId = undefined;
-      if (result.regions.some(region => region.pageId === context.pageId && region.id === context.regionId)) throw new Error(`Duplicate region identity / 身份: ${context.pageId}/${context.regionId}`);
-      context.regionEntry={id:context.regionId,pageId:context.pageId,mode:context.mode,file};
-      result.regions.push(context.regionEntry);
-    }
-    if (attr['data-capability-id']) {
-      identifier(attr['data-capability-id'], 'capability');
-      if (!context.pageId || !context.regionId) throw new Error(`Capability requires page and region identity: ${file}`);
-      context.capabilityId = attr['data-capability-id'];
-      let parameters;
-      try { parameters = JSON.parse(attr['data-capability-parameters'] || '{}'); } catch { throw new Error(`Invalid capability parameters: ${context.capabilityId}`); }
-      result.bindings.push({ id: `${context.pageId}/${context.regionId}/${context.capabilityId}`, pageId: context.pageId, regionId: context.regionId, capabilityId: context.capabilityId, parameters, source: { file } });
-    }
-    for (const kind of ['field', 'action']) {
-      const value = attr[`data-${kind}-id`];
-      if (!value) continue;
-      identifier(value, kind);
-      if (!context.capabilityId) throw new Error(`Unbound ${kind} interaction / 交互: ${value}`);
-      const items = result[`${kind}s`];
-      const id = `${context.pageId}/${context.regionId}/${value}`;
-      if (items.some(item => item.id === id)) throw new Error(`Duplicate ${kind} identity / 身份: ${id}`);
-      const item={id,pageId:context.pageId,regionId:context.regionId,capabilityId:context.capabilityId,localId:value,tag:name,label:attr['data-label']||attr['aria-label']||attr.placeholder||attr.value||value,labelSource:attr['data-label']?'data-label':attr['aria-label']?'aria-label':'identifier',source:{file}};
-      if(kind==='field') {
-        if(Object.hasOwn(attr,'placeholder'))item.placeholder=attr.placeholder;
-        if(Object.hasOwn(attr,'required'))item.required=true;
-        if(attr.type)item.inputType=attr.type;
-        const label=stack.findLast(frame=>frame.name==='label');
-        if(label)label.labelFields.push(item);
-        if(attr.id)fieldTargets.push({id:attr.id,item});
-      }
-      items.push(item);context.items.push(item);
-    }
-    const interactive = ['button', 'input', 'select', 'textarea'].includes(name) || (name === 'a' && attr.href) || ['button', 'checkbox', 'switch', 'textbox'].includes(attr.role) || attr.contenteditable === 'true' || /on(click|change|input)/i.test(Object.keys(attr).join(' '));
-    if (interactive && !attr['data-field-id'] && !attr['data-action-id']) throw new Error(`Unbound interaction / 交互 in ${file}: ${name}`);
-    if (!VOID.has(name) && !/\/\s*>$/.test(token)) stack.push(context);
-    else close(context);
-  }
-  if (stack.length) throw new Error(`Unclosed HTML element in ${file}: ${stack.at(-1).name}`);
-  for(const target of fieldTargets)if(labels.has(target.id)&&target.item.labelSource!=='data-label'){target.item.label=labels.get(target.id);target.item.labelSource='label-for';}
-}
-
-function projectAdminListContent(snapshot) {
-  const index=snapshot.index;
-  if(index.pages.length!==1||index.pages[0].id!=='devices')throw new Error('Unsupported admin-list page identity; explicit framework adaptation / 适配 required');
-  const page=index.pages[0];
-  const region=id=>index.regions.find(item=>item.pageId===page.id&&item.id===id);
-  if(!region('device-list')||!region('device-editor')||index.regions.length!==2)throw new Error('Unsupported admin-list region; explicit framework adaptation / 适配 required');
-  const fieldMap={
-    'device-list/device-code':'code','device-list/device-name':'name','device-list/device-category':'category','device-list/device-status':'status',
-    'device-list/query-name':'queryName','device-list/query-status':'queryStatus',
-    'device-editor/edit-code':'editCode','device-editor/edit-name':'editName','device-editor/edit-category':'editCategory','device-editor/edit-status':'editStatus',
-  };
-  const actionMap={
-    'device-list/query':'query','device-list/reset-query':'resetQuery','device-list/bulk-disable':'bulkDisable',
-    'device-list/previous-page':'previousPage','device-list/next-page':'nextPage',
-    'device-editor/edit':'edit','device-editor/save-edit':'save','device-editor/cancel-edit':'cancel',
-  };
-  const fields={},actions={};
-  for(const item of index.fields) {
-    const key=fieldMap[`${item.regionId}/${item.localId}`];
-    if(!key) {
-      const sampleControl=item.regionId==='device-list'&&((item.capabilityId==='selection'&&item.inputType==='checkbox')||(item.capabilityId==='feedback'&&item.localId==='preview-state'));
-      if(sampleControl)continue;
-      throw new Error(`Unsupported admin-list field ${item.id}; explicit framework adaptation / 适配 required`);
-    }
-    fields[key]={label:item.label,...(item.placeholder!==undefined?{placeholder:item.placeholder}:{}),...(item.required!==undefined?{required:item.required}:{})};
-  }
-  for(const item of index.actions) {
-    const key=actionMap[`${item.regionId}/${item.localId}`];
-    if(!key)throw new Error(`Unsupported admin-list action ${item.id}; explicit framework adaptation / 适配 required`);
-    actions[key]=item.label;
-  }
-  for(const key of Object.values(fieldMap))if(!fields[key]?.label)throw new Error(`Missing admin-list content field ${key}; explicit adaptation required`);
-  for(const key of Object.values(actionMap))if(!actions[key])throw new Error(`Missing admin-list content action ${key}; explicit adaptation required`);
-  if(fields.editName.required!==true)throw new Error('Admin-list editName is required / 名称必填合同冲突; explicit adaptation required');
-  return {schemaVersion:1,templateDigest:snapshot.digest,pageTitle:page.title||snapshot.id,description:page.description||'',listTitle:region('device-list').title||'',editorTitle:region('device-editor').title||'',fields,actions};
-}
-function sameBinding(a, b) { return a.pageId === b.pageId && a.regionId === b.regionId && a.capabilityId === b.capabilityId; }
-function sourceValid(requirement) {
-  const source = requirement?.source;
-  return requirement?.id && requirement?.text && ['prd', 'user', 'scope-change'].includes(source?.type) && typeof source.reference === 'string' && source.reference.trim() && typeof source.statement === 'string' && source.statement.trim();
-}
-function resolvePaginationParameters(parameters = {}) {
-  const mode = parameters.mode === undefined ? 'fixed' : parameters.mode;
-  const positiveInteger = value => Number.isInteger(value) && value > 0;
-  if (!['fixed', 'adjustable'].includes(mode)) throw new Error('Invalid pagination mode');
-  if (mode === 'fixed') {
-    if (!positiveInteger(parameters.fixedPageSize)) throw new Error('Fixed pagination requires a positive integer fixedPageSize');
-    if (parameters.defaultPageSize !== undefined || parameters.pageSizeOptions !== undefined) throw new Error('Fixed pagination cannot declare adjustable defaults or options');
-    return { mode, defaultPageSize: parameters.fixedPageSize, pageSizeOptions: [parameters.fixedPageSize] };
-  }
-  if (parameters.fixedPageSize !== undefined) throw new Error('Adjustable pagination cannot declare fixedPageSize');
-  if (!positiveInteger(parameters.defaultPageSize)) throw new Error('Adjustable pagination requires a positive integer defaultPageSize');
-  const options = parameters.pageSizeOptions;
-  if (!Array.isArray(options) || options.length < 2 || !options.every(positiveInteger) || new Set(options).size !== options.length) throw new Error('Adjustable pagination requires at least two unique positive integer pageSizeOptions');
-  if (!options.includes(parameters.defaultPageSize)) throw new Error('Pagination options must include defaultPageSize');
-  return { mode, defaultPageSize: parameters.defaultPageSize, pageSizeOptions: [...options] };
-}
-function resolveThemeParameters(parameters = {}) {
-  const ids=['light','dark','fresh','tech'];
-  if(parameters.defaultTheme!=='light'||!Array.isArray(parameters.presets)||parameters.presets.length!==4||new Set(parameters.presets).size!==4||!ids.every(id=>parameters.presets.includes(id)))throw new Error('Theme requires default light and the four named presets light/dark/fresh/tech');
-  return {defaultTheme:'light',presets:[...ids]};
-}
-function checkCapabilities({ definition, bindings = [], regions = [], scope = {}, decisions = [] } = {}) {
-  const errors = [], requiredBindings = [], requiredScenarios = [];
-  const definitions = new Map();
-  for (const capability of definition?.capabilities || []) {
-    if (definitions.has(capability.id) || !ID.test(capability.id || '')) errors.push(`Invalid or duplicate capability definition: ${capability.id}`);
-    definitions.set(capability.id, capability);
-  }
-  if (definition?.schemaVersion !== 1 || !definitions.size) errors.push('Missing fixed capability definition');
-  const regionKeys = new Set();
-  for (const region of regions) {
-    const key = `${region.pageId}/${region.id}`;
-    if (regionKeys.has(key)) errors.push(`Duplicate region identity: ${key}`);
-    regionKeys.add(key);
-    if (!definition?.regionModes?.includes(region.mode)) errors.push(`Unknown region mode: ${key}: ${region.mode}`);
-  }
-  const bindingMap = new Map();
-  for (const binding of bindings) {
-    const key = `${binding.pageId}/${binding.regionId}/${binding.capabilityId}`;
-    if (binding.id !== key || bindingMap.has(key)) errors.push(`Invalid or duplicate binding identity: ${key}`);
-    bindingMap.set(key, binding);
-    if (!regionKeys.has(`${binding.pageId}/${binding.regionId}`)) errors.push(`Binding has unknown region: ${key}`);
-    const capability = definitions.get(binding.capabilityId);
-    if (!capability) { errors.push(`Unknown capability / 能力: ${key}`); continue; }
-    for (const [name, rule] of Object.entries(capability.parameters || {})) {
-      const value = binding.parameters?.[name];
-      if (value === undefined && !rule.required) continue;
-      const regionMode = regions.find(region => region.pageId === binding.pageId && region.id === binding.regionId)?.mode;
-      const includes = rule.includesByMode?.[regionMode] || rule.includes;
-      const typeValid = rule.type === 'array' ? Array.isArray(value) : rule.type === 'integer' ? Number.isInteger(value) : typeof value === rule.type;
-      if (!typeValid || (rule.enum && !rule.enum.includes(value)) || (rule.minimum !== undefined && value < rule.minimum) || (includes && !includes.every(item => value?.includes?.(item)))) errors.push(`Invalid capability parameter: ${key}.${name}`);
-    }
-    if (capability.id === 'pagination') {
-      try { resolvePaginationParameters(binding.parameters); }
-      catch (error) { errors.push(`Invalid pagination parameters: ${key}: ${error.message}`); }
-    }
-    if (capability.id === 'theme') {
-      try { resolveThemeParameters(binding.parameters); }
-      catch(error) { errors.push(`Invalid theme parameters: ${key}: ${error.message}`); }
-    }
-  }
-  const decisionMap = new Map();
-  for (const decision of decisions) {
-    if (decisionMap.has(decision.bindingId)) errors.push(`Duplicate decision: ${decision.bindingId}`);
-    decisionMap.set(decision.bindingId, decision);
-    if (decision.status === 'pending') errors.push(`Pending capability: ${decision.bindingId}`);
-    else if (!['required', 'applicable', 'not-applicable'].includes(decision.status)) errors.push(`Unknown capability decision: ${decision.bindingId}`);
-  }
-  const expected = [];
-  for (const region of regions) {
-    for (const capability of definitions.values()) {
-      if (capability.requirement === 'required' && capability.appliesTo?.includes(region.mode)) expected.push({ pageId: region.pageId, regionId: region.id, capabilityId: capability.id });
-    }
-  }
-  for (const requirement of scope.requirements || []) {
-    if (!sourceValid(requirement)) errors.push(`Requirement needs explicit source: ${requirement.id || '(missing id)'}`);
-    for (const capability of requirement.capabilities || []) {
-      if (!definitions.has(capability.capabilityId) || !regionKeys.has(`${capability.pageId}/${capability.regionId}`)) errors.push(`Unknown scoped capability: ${requirement.id}`);
-      else if (!expected.some(entry => sameBinding(entry, capability))) expected.push(capability);
-    }
-  }
-  for (const entry of expected) {
-    const key = `${entry.pageId}/${entry.regionId}/${entry.capabilityId}`;
-    const decision = decisionMap.get(key);
-    if (decision?.status === 'not-applicable') {
-      const exemption = (scope.exemptions || []).find(item => sameBinding(item, entry) && item.requirementId === decision.requirementId && item.reason?.trim());
-      const requirement = (scope.requirements || []).find(item => item.id === exemption?.requirementId);
-      if (exemption && sourceValid(requirement)) continue;
-      errors.push(`Required capability needs explicit scoped exemption: ${key}`);
-    }
-    requiredBindings.push(key);
-    if (!bindingMap.has(key)) errors.push(`Missing required capability: ${key}`);
-    const capability = definitions.get(entry.capabilityId);
-    for (const scenario of capability?.scenarios || []) requiredScenarios.push({ ...scenario, id: `${key}/${scenario.id}`, scenarioId: scenario.id, bindingId: key });
-  }
-  for (const decision of decisions) if (!expected.some(entry => `${entry.pageId}/${entry.regionId}/${entry.capabilityId}` === decision.bindingId) && !bindingMap.has(decision.bindingId)) errors.push(`Decision has unknown binding: ${decision.bindingId}`);
-  return { status: errors.length ? 'failed' : 'passed', errors, requiredBindings, requiredScenarios };
-}
-function syncTemplate(directory, { write = true } = {}) {
-  directory = path.resolve(directory);
-  if (write && fs.existsSync(path.join(directory, 'component-inventory.json'))) fs.writeFileSync(path.join(directory, 'template-inventory.json'), JSON.stringify(require('./template-inventory.cjs').scan(directory), null, 2) + '\n');
-  const files = filesUnder(directory);
-  const manifest = readJson(localFile(directory, 'template.json'));
-  identifier(manifest.id, 'template');
-  const definitionFile = localFile(directory, manifest.definition);
-  const definition = readJson(definitionFile);
-  let result;
-  if (manifest.kind === 'content-reference') result = require('./content-template.cjs').extract(directory, manifest, files);
-  else {
-    result = { pages: [], regions: [], bindings: [], fields: [], actions: [], resources: [] };
-  for (const file of files.filter(entry => /\.html?$/i.test(entry.path))) extractHtml(fs.readFileSync(localFile(directory, file.path), 'utf8'), file.path, result);
-  for (const resource of result.resources) {
-    const relative = path.posix.normalize(path.posix.join(path.posix.dirname(resource.file), resource.path));
-    if (!files.some(file => file.path === relative)) throw new Error(`Offline / 离线 template resource missing: ${relative}`);
-  }
-  for (const file of files.filter(entry => /\.(?:html?|js|css)$/i.test(entry.path))) {
-    const text = fs.readFileSync(localFile(directory, file.path), 'utf8');
-    if (/\bfetch\s*\(|\bXMLHttpRequest\b|\bimport\s*(?:\(|["'{*])|\bfrom\s*["']|@import\b|url\s*\(\s*["']?(?:https?:|\/\/)/i.test(text)) throw new Error(`Offline / 离线 template cannot use async or remote loads: ${file.path}`);
-  }
-  if (!result.pages.length || !result.regions.length) throw new Error('Missing page or region identity / 身份');
-  if (!files.some(file => file.path === manifest.entry)) throw new Error('Template entry is missing');
-  }
-  const checked = checkCapabilities({ definition, ...result, scope: manifest.scope, decisions: manifest.decisions });
-  if (checked.status !== 'passed') throw new Error(checked.errors.join('\n'));
-  const htmlFiles = files.filter(file => /\.html?$/i.test(file.path));
-  const extractorFiles = manifest.kind==='content-reference' ? Object.fromEntries(['template-contract.cjs','content-template.cjs'].map(file=>[file,sha(fs.readFileSync(path.join(__dirname,file)))])) : null;
-  const extractor = extractorFiles ? { version:'2.0.0', files:extractorFiles, digest:sha(canonical(extractorFiles)) } : { version:EXTRACTOR_VERSION,digest:sha(fs.readFileSync(__filename)) };
-  const value = { schemaVersion: 1, templateId: manifest.id, version: manifest.version, sourceDigest: sha(canonical(files)), htmlDigest: sha(canonical(htmlFiles)), definitionDigest: sha(fs.readFileSync(definitionFile)), extractor, files, definition, ...result, requiredBindings: checked.requiredBindings, requiredScenarios: checked.requiredScenarios };
-  const index = { ...value, digest: sha(canonical(value)) };
-  if (write) {
-    const temporary = path.join(directory, `.${INDEX}.${process.pid}.tmp`);
-    try { fs.writeFileSync(temporary, `${JSON.stringify(index, null, 2)}\n`, { flag: 'wx' }); fs.renameSync(temporary, path.join(directory, INDEX)); }
-    finally { fs.rmSync(temporary, { force: true }); }
-  }
-  return index;
-}
-function templateSnapshot(directory, expected) {
-  return { schemaVersion: 1, ...(expected.kind ? { kind: expected.kind } : {}), id: expected.templateId, version: expected.version, digest: expected.digest, index: expected, definition: expected.definition, files: expected.files.map(file => ({ path: file.path, encoding: 'base64', content: fs.readFileSync(localFile(directory, file.path)).toString('base64') })) };
-}
-function loadTemplate(directory) {
-  directory = path.resolve(directory);
-  const expected = syncTemplate(directory, { write: false });
-  const stored = fs.existsSync(path.join(directory, INDEX)) ? readJson(path.join(directory, INDEX)) : null;
-  if (!stored || canonical(stored) !== canonical(expected)) throw new Error('Template index is stale / 源和索引不同步; run sync-template.cjs');
-  return templateSnapshot(directory, expected);
-}
-function loadBundledTemplate(templateId, { templatesRoot = path.join(ASSETS, 'templates') } = {}) {
-  const catalog = readJson(localFile(templatesRoot, 'catalog.json'));
-  templateId ||= catalog.defaultTemplate; identifier(templateId, 'template');
-  const selected = catalog.templates.find(item => item.id === templateId);
-  assert.ok(selected?.availability === 'available' && selected.contentRoot, `Unsupported or not available native template: ${templateId}`);
-  const directory = localFile(templatesRoot, selected.contentRoot);
-  const manifest = readJson(localFile(directory, 'template.json'));
-  assert.equal(manifest.kind, 'content-reference', 'Native templates require an explicit content-reference manifest');
-  assert.equal(manifest.id, templateId, 'Template catalog identity differs from its manifest');
-  return templateSnapshot(directory, syncTemplate(directory, { write: false }));
-}
-function prepareTemplate({ project, id = 'enterprise-admin' }) {
-  identifier(id, 'template');
-  const directory = path.resolve(project, 'ui-templates', id);
-  assertNoSymlinks(directory);
-  if (fs.existsSync(directory)) return { directory, created: false, index: loadTemplate(directory).index };
-  fs.mkdirSync(path.dirname(directory), { recursive: true });
-  const temporary = path.join(path.dirname(directory), `.${id}.${process.pid}.tmp`);
-  try {
-    fs.cpSync(path.join(ASSETS, 'templates/enterprise-admin'), temporary, { recursive: true, errorOnExist: true, force: false });
-    fs.copyFileSync(path.join(ASSETS, 'capabilities/management.json'), path.join(temporary, 'capability-definition.json'));
-    const manifest = readJson(path.join(temporary, 'template.json'));
-    manifest.id = id;
-    fs.writeFileSync(path.join(temporary, 'template.json'), `${JSON.stringify(manifest, null, 2)}\n`);
-    const index = syncTemplate(temporary);
-    if (fs.existsSync(directory)) throw new Error(`Template already exists: ${directory}`);
-    fs.renameSync(temporary, directory);
-    return { directory, created: true, index };
-  } finally { fs.rmSync(temporary, { recursive: true, force: true }); }
-}
-function checkInstanceCapabilities(inputsRoot) {
-  try {
-    const fixed = readJson(localFile(inputsRoot, 'capabilities.json'));
-    if (fs.existsSync(localFile(inputsRoot, 'template-snapshot.json')) && readJson(localFile(inputsRoot, 'template-snapshot.json')).kind === 'content-reference') return require('./content-template.cjs').checkInputs(inputsRoot, module.exports);
-    const scopeFile = localFile(inputsRoot, 'scope.json');
-    const snapshotFile = localFile(inputsRoot, 'template-snapshot.json');
-    if (fs.existsSync(snapshotFile)) {
-      const snapshot = readJson(snapshotFile);
-      if (canonical(fixed.definition) !== canonical(snapshot.definition)) throw new Error('Fixed capability definition differs from template snapshot');
-      for (const region of snapshot.index.regions) {
-        if (!fixed.regions.some(entry => entry.pageId === region.pageId && entry.id === region.id && entry.mode === region.mode)) throw new Error(`Fixed template region missing or mode changed: ${region.pageId}/${region.id}`);
-      }
-      for (const binding of snapshot.index.bindings) {
-        if (!fixed.bindings.some(entry => entry.id === binding.id && sameBinding(entry, binding))) throw new Error(`Fixed template binding missing: ${binding.id}`);
-      }
-    }
-    const scope=fs.existsSync(scopeFile) ? readJson(scopeFile) : fixed.scope;
-    const result=checkCapabilities({ ...fixed, scope });
-    for(const binding of fixed.bindings.filter(item=>item.capabilityId==='theme')) {
-      if(binding.id!=='devices/device-list/theme')result.errors.push(`Theme binding needs an explicit native adapter: ${binding.id}`);
-      if(!(scope?.requirements||[]).some(requirement=>sourceValid(requirement)&&(requirement.capabilities||[]).some(item=>sameBinding(item,binding))))result.errors.push(`Theme binding requires an explicit requirement source: ${binding.id}`);
-      if(!result.requiredBindings.includes(binding.id))result.errors.push(`Enabled theme must retain its acceptance; remove the explicit binding to disable it: ${binding.id}`);
-    }
-    if(result.errors.length)result.status='failed';
-    return result;
-  } catch (error) { return { status: 'failed', errors: [error.message], requiredBindings: [], requiredScenarios: [] }; }
-}
-module.exports = { prepareTemplate, syncTemplate, loadTemplate, loadBundledTemplate, checkCapabilities, checkInstanceCapabilities, projectAdminListContent, resolvePaginationParameters, resolveThemeParameters };

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

@@ -1,78 +0,0 @@
-'use strict';
-const fs = require('node:fs'), path = require('node:path'), crypto = require('node:crypto'), assert = require('node:assert/strict');
-const digest = value => crypto.createHash('sha256').update(value).digest('hex');
-const ignored = new Set(['template-inventory.json', 'capabilities.generated.json']);
-function files(directory, prefix = '') {
-  return fs.readdirSync(path.join(directory, prefix), { withFileTypes: true }).sort((a,b) => a.name.localeCompare(b.name, 'en')).flatMap(entry => {
-    const name = prefix ? `${prefix}/${entry.name}` : entry.name;
-    assert.ok(!entry.isSymbolicLink(), `Refusing template symlink: ${name}`);
-    if (['.git', 'node_modules'].includes(entry.name) || ignored.has(name)) return [];
-    return entry.isDirectory() ? files(directory, name) : [name];
-  });
-}
-function attributes(text) {
-  const value = {};
-  for (const match of text.matchAll(/([^\s=<>/'"`]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+)))?/g)) {
-    assert.ok(!Object.hasOwn(value, match[1]), `Duplicate HTML attribute: ${match[1]}`);
-    value[match[1]] = match[2] ?? match[3] ?? match[4] ?? '';
-  }
-  return value;
-}
-function scan(directory) {
-  directory = fs.realpathSync(directory);
-  const sourceFiles = files(directory), hashes = Object.fromEntries(sourceFiles.map(file => [file, digest(fs.readFileSync(path.join(directory, file)))]));
-  const html = fs.readFileSync(path.join(directory, 'index.html'), 'utf8');
-  const policy = JSON.parse(fs.readFileSync(path.join(directory, 'component-inventory.json'), 'utf8'));
-  return scanResources(hashes, html, policy);
-}
-function scanResources(hashes, html, policy) {
-  const routesMatch = html.match(/id="prototype-offline-routes">([\s\S]*?)<\/script>/);
-  assert.ok(routesMatch, 'Template inventory requires explicit offline routes');
-  const routes = JSON.parse(routesMatch[1]);
-  assert.equal(policy.schemaVersion, 1, 'Unsupported component inventory classification');
-  const fragments = [], components = {}, unknownComponents = new Set(); let eventCount = 0;
-  for (const match of html.matchAll(/^<template data-source="([^"]+)">\n([\s\S]*?)^<\/template>/gm)) {
-    const file = match[1], content = match[2], nodes = [];
-    assert.ok(!fragments.some(fragment => fragment.file === file), `Duplicate HTML fragment: ${file}`);
-    const cleaned = content.replace(/<!--[\s\S]*?-->/g, text => ' '.repeat(text.length));
-    for (const token of cleaned.matchAll(/<([a-zA-Z][\w:.-]*)(\s(?:[^"'<>]|"[^"]*"|'[^']*')*)?\s*\/?\s*>/g)) {
-      const attrs = attributes(token[2] || ''), node = { id: `${file}#${nodes.length + 1}`, tag: token[1], attributes: attrs };
-      nodes.push(node);
-      eventCount += Object.keys(attrs).filter(key => key.startsWith('data-on-')).length;
-      const component = attrs['data-component'];
-      if (!component) continue;
-      const classification = policy.components?.[component];
-      if (!classification) unknownComponents.add(component);
-      else {
-        assert.ok(['framework', 'business-reference', 'icon', 'router', 'dynamic'].includes(classification.kind), `Unknown classification: ${component}`);
-        assert.ok(Array.isArray(classification.capabilities), `Missing semantic classification: ${component}`);
-        if (classification.source) assert.ok(fragments.some(item => item.file === classification.source) || html.includes(`<template data-source="${classification.source}">`), `Missing component source: ${component}`);
-      }
-      components[component] ||= { classification: classification || null, occurrences: [] };
-      components[component].occurrences.push(node.id);
-    }
-    fragments.push({ file, digest: digest(content), nodes });
-  }
-  assert.ok(fragments.length, 'Template inventory requires editable fragments');
-  assert.equal(unknownComponents.size, 0, `Unclassified template components: ${[...unknownComponents].join(', ')}`);
-  const pages = [...new Set(routes.map(route => route.component).filter(Boolean))].map(component => {
-    const fragment = 'reference/' + component.replace(/^\.\//, '').replace(/\.js$/, '.html');
-    assert.ok(fragments.some(item => item.file === fragment), `Route has no editable HTML: ${component}`);
-    return { component, fragment, routes: routes.filter(route => route.component === component).map(route => route.path) };
-  });
-  return { schemaVersion: 1, files: hashes, routes, pages, fragments, components, eventCount, unknownComponents: [] };
-}
-function verify(directory, inventory) {
-  assert.deepEqual(scan(directory), inventory, 'Template inventory changed; review every source/component/interaction difference and regenerate the inventory');
-  return { status: 'passed', files: Object.keys(inventory.files).length, routes: inventory.routes.length, pages: inventory.pages.length, fragments: inventory.fragments.length, components: Object.keys(inventory.components).length, events: inventory.eventCount };
-}
-function verifySnapshot(snapshot) {
-  const resources = new Map(snapshot.files.map(file => [file.path, Buffer.from(file.content, 'base64')]));
-  assert.equal(resources.size, snapshot.files.length, 'Duplicate template snapshot resource');
-  const hashes = Object.fromEntries([...resources].filter(([file]) => !ignored.has(file)).map(([file, content]) => [file, digest(content)]));
-  const expected = JSON.parse(resources.get('template-inventory.json').toString('utf8'));
-  const actual = scanResources(hashes, resources.get('index.html').toString('utf8'), JSON.parse(resources.get('component-inventory.json').toString('utf8')));
-  assert.deepEqual(actual, expected, 'Template snapshot inventory differs from actual sources/components/events');
-  return actual;
-}
-module.exports = { scan, verify, verifySnapshot };

package/skills/i3-ui-prototype/scripts/validate-result.cjs

@@ -1,117 +0,0 @@
-'use strict';
-
-const REQUIRED = ['operation', 'status', 'executionMode', 'prototypeId', 'revision',
-  'candidateDigest', 'summary', 'checks', 'delivery', 'openItems'];
-const OPERATIONS = ['analyze', 'create', 'revise', 'inspect', 'confirm-baseline'];
-const MODES = ['inline', 'delegated'];
-const MARKER = 'PROTOTYPE_RESULT_V1';
-const object = value => value !== null && typeof value === 'object' && !Array.isArray(value);
-const text = value => typeof value === 'string' && value.trim().length > 0;
-
-function options(args) {
-  const result = { runtime: 'native' };
-  for (let index = 0; index < args.length; index++) {
-    const flag = args[index];
-    if (flag === '--check-return') { result.checkReturn = true; continue; }
-    if (!['--expected-operation', '--expected-mode', '--runtime'].includes(flag)) throw new Error(`Unexpected option: ${flag}`);
-    const value = args[++index];
-    if (!value || value.startsWith('--')) throw new Error(`${flag} requires a value`);
-    result[flag.slice(2)] = value;
-  }
-  if (!OPERATIONS.includes(result['expected-operation'])) throw new Error('--expected-operation must be analyze, create, revise, inspect or confirm-baseline');
-  if (!MODES.includes(result['expected-mode'])) throw new Error('--expected-mode must be inline or delegated, from the actual entry handoff');
-  if (!['native', 'legacy'].includes(result.runtime)) throw new Error('--runtime must be native or legacy, from existing artifact metadata');
-  return result;
-}
-
-function validate(value, expected) {
-  if (!object(value)) throw new Error('Result must be a JSON object');
-  const errors = [];
-  for (const field of REQUIRED) if (!Object.hasOwn(value, field)) errors.push(`${field}: required field is missing`);
-  if (!OPERATIONS.includes(value.operation)) errors.push('operation: unsupported operation');
-  else if (value.operation !== expected['expected-operation']) errors.push(`operation: expected ${expected['expected-operation']}, received ${value.operation}`);
-  if (!['complete', 'partial', 'blocked'].includes(value.status)) errors.push('status: expected complete, partial or blocked');
-  if (!MODES.includes(value.executionMode)) errors.push('executionMode: expected inline or delegated');
-  else if (value.executionMode !== expected['expected-mode']) errors.push(`executionMode: expected ${expected['expected-mode']}, received ${value.executionMode}`);
-  if (!text(value.summary)) errors.push('summary: a non-empty string is required');
-  if (!Array.isArray(value.openItems)) errors.push('openItems: an array is required');
-  else value.openItems.forEach((item, index) => { if (!text(item)) errors.push(`openItems[${index}]: a non-empty string is required`); });
-
-  if (!Array.isArray(value.checks) || value.checks.length === 0) errors.push('checks: a non-empty array is required');
-  else value.checks.forEach((check, index) => {
-    const at = `checks[${index}]`;
-    if (!object(check)) { errors.push(`${at}: an object is required`); return; }
-    if (!text(check.name)) errors.push(`${at}.name: a non-empty string is required`);
-    if (!['passed', 'failed', 'not-run'].includes(check.status)) errors.push(`${at}.status: expected passed, failed or not-run (result is not a status alias)`);
-    if (!text(check.evidence)) errors.push(`${at}.evidence: a non-empty evidence locator or analysis explanation is required`);
-  });
-
-  for (const field of ['prototypeId', 'revision', 'candidateDigest']) {
-    if (value[field] !== null && !text(value[field])) errors.push(`${field}: expected null or a non-empty string`);
-  }
-  const allPresent = ['prototypeId', 'revision', 'candidateDigest'].every(field => text(value[field]));
-  if ((value.revision === null) !== (value.candidateDigest === null)) errors.push('identity: revision and candidateDigest must be a pair, without inventing an uncreated version');
-  if ((text(value.revision) || text(value.candidateDigest)) && !text(value.prototypeId)) errors.push('identity: revision/candidateDigest require prototypeId');
-  if (text(value.candidateDigest) && !/^[a-f0-9]{64}$/.test(value.candidateDigest)) errors.push('candidateDigest: expected the existing lowercase SHA-256 content digest');
-  if (value.status === 'complete' && value.operation !== 'analyze' && !allPresent) errors.push('identity: complete create, revise, inspect or confirm-baseline requires prototypeId, revision and candidateDigest');
-
-  if (value.delivery !== null && !text(value.delivery)) errors.push('delivery: expected null or a non-empty path string');
-  if (value.operation === 'analyze' && value.delivery !== null) errors.push('delivery: analyze must use null and must not write a receipt');
-  const nativeReceipt = expected.runtime === 'native' && ['create', 'revise'].includes(value.operation);
-  if (nativeReceipt && value.status === 'complete' && !text(value.delivery)) errors.push('delivery: complete native create/revise requires the current qa/delivery.json path');
-  if (expected.runtime === 'native' && text(value.delivery)
-    && (!/(?:^|[\\/])qa[\\/]delivery\.json$/.test(value.delivery) || /[\u0000-\u001f]/.test(value.delivery))) {
-    errors.push('delivery: native receipt path must end in qa/delivery.json');
-  }
-  if (value.status === 'complete' && ['create', 'revise', 'confirm-baseline'].includes(value.operation)
-    && Array.isArray(value.checks) && value.checks.some(check => !object(check) || check.status !== 'passed')) {
-    errors.push('checks: complete write operations cannot contain failed or not-run checks');
-  }
-  if (errors.length) throw new Error(errors.join('\n- '));
-  // Keep the established fields in one order while retaining optional context.
-  return Object.fromEntries([...REQUIRED, ...Object.keys(value).filter(field => !REQUIRED.includes(field)).sort()]
-    .map(field => [field, value[field]]));
-}
-
-function originalResult(input) {
-  if (/<\/?(?:tool_call|arg_key|arg_value|function_calls?|invoke)(?:[:>\s])/i.test(input)) {
-    throw new Error('Original reply contains tool protocol text instead of a final result');
-  }
-  // CodeBuddy Code 2.168.2 appends this host note to Agent tool results.
-  // Accept only that terminal UUID form; other trailing content stays invalid.
-  const original = input.replace(/\r?\n\r?\n\[Agent ID: agent-[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}\][ \t\r\n]*$/, '');
-  const lines = original.split(/\r?\n/);
-  const markers = lines.map((line, index) => line === MARKER ? index : -1).filter(index => index >= 0);
-  if (markers.length !== 1) throw new Error(`Original reply requires one separate exact marker line ${MARKER}; found ${markers.length}`);
-  const at = markers[0];
-  if (!text(lines.slice(0, at).join('\n'))) throw new Error('Original reply requires a separate natural-language outcome before the marker');
-  let json = lines.slice(at + 1).join('\n').trim();
-  if (json.startsWith('```')) {
-    const fenced = json.match(/^```(?:json)?[ \t]*\n([\s\S]*?)\n```[ \t]*$/);
-    if (!fenced) throw new Error('JSON fence must contain one JSON value with no trailing content');
-    json = fenced[1];
-  }
-  return json;
-}
-
-async function main() {
-  const expected = options(process.argv.slice(2));
-  let input = '';
-  process.stdin.setEncoding('utf8');
-  for await (const chunk of process.stdin) {
-    input += chunk;
-    if (Buffer.byteLength(input, 'utf8') > 1024 * 1024) throw new Error('JSON input exceeds 1 MiB');
-  }
-  let value;
-  try { value = JSON.parse(expected.checkReturn ? originalResult(input) : input); }
-  catch (error) { throw new Error(`JSON: ${error.message}`); }
-  const canonical = validate(value, expected);
-  process.stdout.write(`${MARKER}\n${JSON.stringify(canonical, null, 2)}\n`);
-}
-
-if (require.main === module) main().catch(error => {
-  process.stderr.write(`Invalid prototype result:\n- ${error.message}\n`);
-  process.exitCode = 1;
-});
-
-module.exports = { validate, options, REQUIRED, MARKER };