@givolt/i3-composer-agent 3.2.1 → 4.0.0

package/skills/i3-ui-prototype/scripts/codebuddy-hook.cjs

@@ -1,298 +0,0 @@
-'use strict';
-const fs=require('node:fs'),path=require('node:path'),crypto=require('node:crypto'),assert=require('node:assert/strict');
-const F=require('./native-files.cjs'),C=require('./codebuddy-context.cjs'),E=require('./execution-evidence.cjs'),P=require('./execution-policy.cjs'),G=require('./execution-gates.cjs');
-const X=require('./execution-runtime.cjs');
-const H=require('./buddy-host.cjs');
-const Recovery=require('./execution-recovery.cjs');
-const {tokens,nativeCommand,stageFor,completedBegin}=require('./native-command.cjs');
-const {toolName}=require('./native-tool-name.cjs');
-function eventCall(payload,source) {
- const callId=payload.tool_use_id||payload.call_id;
- const canonical=value=>Array.isArray(value)?value.map(canonical):value&&typeof value==='object'?Object.fromEntries(Object.keys(value).sort().map(k=>[k,canonical(value[k])])):value;
- const partial=(before,after)=>typeof before==='string'?typeof after==='string'&&after.startsWith(before):Array.isArray(before)?Array.isArray(after)&&before.length<=after.length&&before.every((value,i)=>partial(value,after[i])):before&&typeof before==='object'?after&&typeof after==='object'&&Object.keys(before).every(key=>Object.hasOwn(after,key)&&partial(before[key],after[key])):before===after;
- const matches=source.calls.filter(call=>{
-  if(call.name!==toolName(payload.tool_name)||call.requestLine<source.prompts.at(-1).line||callId&&call.toolCallId!==callId)return false;
-  if(source.format==='codebuddy-ide-index-v1'&&payload.generation_id&&call.nativeRequestId!==payload.generation_id)return false;
-  if(JSON.stringify(canonical(call.input))===JSON.stringify(canonical(payload.tool_input||{})))return true;
-  // IDE 4.12 streams incomplete args to disk before PreToolUse. Correlate its
-  // actual callback with one pending native call in the exact generation. The
-  // pending call remains unsuccessful until a native result is persisted.
-  return source.format==='codebuddy-ide-index-v1'&&H.isIDE(payload)&&typeof payload.generation_id==='string'&&call.nativeRequestId===payload.generation_id&&!call.resultLine&&partial(call.input,payload.tool_input||{});
- });
- // IDE can omit the call ID and invoke Post before persisting the result.
- // A failed earlier attempt can have identical args; only the still-pending
- // request in this exact generation can be the current callback.
- const pending=matches.filter(call=>!call.resultLine);
- const current=payload.hook_event_name==='PreToolUse'||source.format==='codebuddy-ide-index-v1'&&pending.length?pending:matches;
- assert.equal(current.length,1,'Native Hook event does not uniquely match the current transcript request');return current[0];
-}
-function eventSource(payload,record,project,{readSource=C.source,pause=milliseconds=>Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,milliseconds)}={}) {
- const toolEvent=['PreToolUse','PostToolUse'].includes(payload.hook_event_name);
- // IDE can persist the current call only AFTER returning from both Hooks. Its
- // current native prompt/generation still binds the callback. Never synthesize
- // a successful call; A checks the persisted request/result at a later stage.
- const attempts=toolEvent?8:1;
- for(let attempt=1;attempt<=attempts;attempt++) {
-  try {
-   let source=readSource(payload,record,project);
-   if(toolEvent&&record.product==='cli'&&(payload.agent_type==='ptc'||source.calls.some(c=>c.name==='REPL'&&!c.resultLine))){
-    source=require('./ptc-callbacks.cjs').observe({payload,record,project,source});
-   }
-   let nativeRequestStatus='not-tool-event';
-   if(toolEvent) {
-    if(source.format==='codebuddy-ide-index-v1'&&record.product==='ide'&&H.isIDE(payload)) {
-     const latest=source.prompts.at(-1);
-     assert.ok(typeof payload.generation_id==='string'&&latest?.nativeRequestId===payload.generation_id,'IDE callback differs from the current native task generation');
-     const pending=source.calls.filter(call=>!call.resultLine&&call.requestLine>latest.line&&call.nativeRequestId===payload.generation_id&&call.name===toolName(payload.tool_name));
-     if(pending.length) {eventCall(payload,source);nativeRequestStatus='pending-native-request';}
-     else nativeRequestStatus='deferred-until-native-persistence';
-    }else {eventCall(payload,source);nativeRequestStatus='matched-native-request';}
-   }
-   return {...source,nativeReadAttempts:attempt,nativeRequestStatus};
-  }catch(error){if(attempt===attempts)throw error;pause(100);}
- }
-}
-function decision({event,source,binding,tool,input,directory,cwd,deliveryCurrent,stopHookActive=false,policy,restricted}) {
- if(restricted??C.restriction(source.prompts).blocked)return {continue:true,reason:'user-read-only-or-stopped'};
- if(event==='PreToolUse'&&G.uiWrite({name:tool,input:input||{},cwd},directory)) {
-  const missing=Recovery.missing({source,binding,policy});
-  if(missing.length)return {deny:true,missing,reason:'原型 UI 写入已被阻止。'+Recovery.instruction(missing,{directory,automatic:binding?.association==='automatic'})};
- }
- const final=source.latestAssistant||'',claim=/(?:已完成|已经完成|全部通过|可以交付|\b(?:completed|ready for review|all checks passed)\b)/i.test(final)&&!/(?:未完成|尚未|待验证|阻塞|等待|进度|blocked|awaiting|not complete|in progress)/i.test(final);
- const blocked=/(?:\bblocked\b|无法继续|当前阻塞|等待用户|等待授权)/i.test(final);
- if(event==='Stop'&&binding&&!deliveryCurrent&&!blocked&&(policy?.id===P.AUTO_ID||!stopHookActive)&&claim){
-  const missing=Recovery.missing({source,binding,policy,stage:'delivery'});if(!missing.length)missing.push('execution-evidence');
-  return {feedback:true,missing,reason:'当前原型没有有效交付回执。'+Recovery.instruction(missing,{directory,automatic:binding?.association==='automatic'})};
- }
- return {continue:true};
-}
-function prototypeForWrite(project,tool,input,cwd=project) {
- if(!['Write','Edit','MultiEdit','write_to_file','replace_in_file'].includes(tool))return null;
- const file=input?.file_path||input?.filePath||input?.path||input?.TargetFile;if(typeof file!=='string')return null;
- let current=path.dirname(path.resolve(cwd,file));const prototypes=path.join(project,'prototypes');
- while(current.startsWith(prototypes+path.sep)){if(fs.existsSync(path.join(current,'prototype.json')))return fs.realpathSync(current);current=path.dirname(current);}return null;
-}
-function safeProject(payload,options={},env=process.env,real=file=>fs.realpathSync(file),callbackCwd=process.cwd(),workspace=E.ideWorkspace) {
- const ideRoot=options.product==='ide'&&H.isIDE(payload)&&payload.cwd==='/';
- const hostProject=options.host==='workbuddy'?env.WORKBUDDY_PROJECT_DIR:env.CODEBUDDY_PROJECT_DIR;
- const root=options.scope==='project'?path.dirname(options.base):options.nativeProject|| (ideRoot?workspace(payload.transcript_path,payload.session_id):hostProject||env.CLAUDE_PROJECT_DIR||payload.cwd||(payload.hook_event_name==='SessionStart'?callbackCwd:null));assert.ok(root&&path.isAbsolute(root),'Native project directory required');
- const project=real(root);
- // IDE 4.12.2 reports '/' for absolute-path tools. Use the project registration
- // or session-bound native workspace above; reject all other outside cwd.
- if(payload.cwd&&!ideRoot){const relative=path.relative(project,real(payload.cwd));assert.ok(relative!=='..'&&!relative.startsWith('..'+path.sep)&&!path.isAbsolute(relative),'Hook cwd is outside project');}return project;
-}
-function saveIndex(directory,index) {
- for(const entry of Object.values(index.bindings))F.write(path.dirname(directory),`runs/${entry.runId}/binding.json`,entry);
- F.write(directory,'session.json',index);
-}
-function toolCwd(payload,record,project) {
- return record.product==='ide'&&H.isIDE(payload)&&payload.cwd==='/'?project:payload.cwd||project;
-}
-function settleNativeRetries(index,source,{project,sessionId}) {
- let changed=false;
- for(const entry of Object.values(index.bindings)) {
-  const repair=entry.recovery,expected=repair?.expectedRetry;
-  if(!expected||!['required','ready-to-retry'].includes(repair.status)||entry.contextLine!==source.contextLine)continue;
-  const matches=source.calls.filter(call=>{
-   if(!call.success||!call.resultLine||call.sessionId!==sessionId||call.requestLine<=entry.entryLine||source.stableThroughLine!==undefined&&call.resultLine>source.stableThroughLine)return false;
-   if(expected.kind==='ui-write') {
-    const input=call.input||{},file=input.file_path||input.filePath||input.path||input.TargetFile;
-    return typeof file==='string'&&path.resolve(call.cwd||project,file)===expected.file&&G.uiWrite({...call,cwd:call.cwd||project},entry.directory);
-   }
-   const parsed=nativeCommand(call.name,call.input,call.cwd||project);
-   return expected.kind==='stage'&&parsed?.root===entry.directory&&parsed.operation===expected.operation;
-  });
-  for(const call of matches) {
-   const stage=expected.kind==='stage'?expected.stage:null;
-   if(stage&&X.check(entry.directory,stage,require('./native-pilot-lib.cjs')).status!=='passed')continue;
-   const retry={...expected,toolCallId:call.toolCallId,resultDigest:call.resultDigest,requestLine:call.requestLine,resultLine:call.resultLine};
-   const answer=Recovery.record(index,{source,sessionId,directory:entry.directory,event:'PostToolUse',eventKey:E.sha(JSON.stringify(['persisted-native-result',call.toolCallId,call.resultDigest])),stage,policy:X.policy(entry.directory),resolved:stage?['execution-evidence']:[],retrySucceeded:true,retry},{continue:true});
-   if(answer.recovery&&JSON.stringify(answer.recovery)!==JSON.stringify(entry.recovery)){entry.recovery=answer.recovery;changed=true;}
-   if(entry.recovery?.status==='recovered')break;
-  }
- }
- return changed;
-}
-function dispatch(payload,options) {
- payload={...payload,tool_name:toolName(payload.tool_name)};
- assert.equal(payload.hook_event_name,options.event,'Hook event mismatch');
- if(options.event==='SessionStart')return {continue:true};
- if(options.event==='UserPromptSubmit')return {continue:true};
- let identity,installed;
- try{installed=options.product==='auto'?C.registration(options.base):null;identity=H.identify(payload,installed||{schemaVersion:1,product:options.product},options);}catch(error){
-  const project=options.scope==='project'?path.dirname(options.base):payload.cwd;
-  if(options.event==='PreToolUse'&&project&&path.isAbsolute(project)){
-   const native=nativeCommand(payload.tool_name,payload.tool_input,payload.cwd||project),target=native?.root||prototypeForWrite(project,payload.tool_name,payload.tool_input,payload.cwd==='/'?project:payload.cwd||project);
-   if(target&&fs.existsSync(path.join(target,'prototype.json'))&&X.policy(target))return {deny:true,reason:'原型原生宿主身份尚未核验，禁止受管写入或阶段推进：'+error.message};
-  }
-  throw error;
- }
- options={...options,...identity};
- const project=safeProject(payload,options,options.env),record=C.select({project,product:identity.product,host:identity.host,home:options.home,env:options.env});
- if(!record||record.base!==options.base)return {continue:true};
- const cwd=toolCwd(payload,record,project);
- let source;
- try {
-  source=eventSource(payload,record,project);
- }catch(error){
-  // The outer diagnostic handler must persist and bound this failure as well;
-  // returning an uncounted denial here used to create an endless repair loop.
-  throw error;
- }
- const latest=source.prompts.at(-1);
- if(options.restricted??C.restriction(source.prompts).blocked) {
-  const native=nativeCommand(payload.tool_name,payload.tool_input,cwd),root=native?.root||prototypeForWrite(project,payload.tool_name,payload.tool_input,cwd);
-  if(options.event==='PreToolUse'&&(native&&['create','execution-begin','build','revise','replan','record-run','record-devtools-review','finalize'].includes(native.operation)||root&&X.policy(root)&&G.uiWrite({name:payload.tool_name,input:payload.tool_input,cwd},root)))return {deny:true,reason:'The latest user request is read-only or stopped; no prototype mutation is authorized.'};
-  return {continue:true};
- }
- const stateDirectory=C.sessionDirectory(record,project,payload.session_id),file=path.join(stateDirectory,'session.json');
- let index=JSON.parse(C.read(file)||'{"schemaVersion":1,"bindings":{}}');assert.equal(index.schemaVersion,1,'Unsupported audit session state');
- if(Object.values(index.bindings).some(entry=>['required','ready-to-retry'].includes(entry.recovery?.status))) {
-  const lock=path.join(stateDirectory,'.audit.lock');fs.mkdirSync(stateDirectory,{recursive:true});
-  try{fs.mkdirSync(lock);}catch{throw new Error('Concurrent audit callback; retry the original operation');}
-  try{index=JSON.parse(C.read(file));if(settleNativeRetries(index,source,{project,sessionId:payload.session_id}))saveIndex(stateDirectory,index);}
-  finally{fs.rmdirSync(lock);}
- }
- const command=nativeCommand(payload.tool_name,payload.tool_input,cwd);
- if(options.event==='PreToolUse'&&command?.operation==='create'&&(installed?.schemaVersion===2||E.loaded(source.calls,'prototype').some(c=>c.requestLine>source.contextLine)||/^\s*\/i3-prototype\b/.test(latest.text))){
-  const at=command.argv.indexOf('--execution-policy'),expected=installed?.schemaVersion===2?P.AUTO_ID:P.ID;
-  const hostAt=command.argv.indexOf('--host');
-  if(at<0||command.argv[at+1]!==expected||installed?.schemaVersion===2&&(hostAt<0||command.argv[hostAt+1]!==identity.host))return {deny:true,reason:`New ${identity.host} prototypes require --host ${identity.host} --execution-policy ${expected} and fixed --execution-assertions. Existing artifacts keep their original contracts.`};
- }
- const directory=command?.root||prototypeForWrite(project,payload.tool_name,payload.tool_input,cwd);
- let existing=directory?index.bindings[directory]:null;
- const stage=options.event==='Stop'?'delivery':stageFor[command?.operation];
- let callbackCall=null;if(['PreToolUse','PostToolUse'].includes(options.event))try{callbackCall=eventCall(payload,source);}catch{/* Deferred IDE requests cannot attest results. */}
- const callId=payload.tool_use_id||payload.call_id||callbackCall?.toolCallId;
- const eventKey=E.sha(JSON.stringify([options.event,payload.generation_id||latest.nativeRequestId||null,callId||null,payload.tool_name||null,payload.tool_input||null,callId?null:source.digest]));
- const recoveryContext=target=>{
-  const stagePassed=stage&&options.event!=='Stop'&&X.check(target,stage,require('./native-pilot-lib.cjs')).status==='passed';
-  const retryCall=options.event==='PostToolUse'&&callbackCall?.success&&(stagePassed||G.uiWrite({...callbackCall,cwd:callbackCall.cwd||cwd},target))?callbackCall:null;
-  const input=payload.tool_input||{},uiFile=input.file_path||input.filePath||input.path||input.TargetFile;
-  const expectedRetry=stage?{kind:'stage',stage,operation:options.event==='Stop'?'finalize':command.operation}:G.uiWrite({name:payload.tool_name,input,cwd},target)?{kind:'ui-write',file:path.resolve(cwd,uiFile)}:null;
-  return {source,sessionId:payload.session_id,directory:target,event:options.event,eventKey,stage,expectedRetry,policy:X.policy(target),resolved:[...(completedBegin(source,existing)?['execution-begin']:[]),...(stagePassed?['execution-evidence']:[])],retrySucceeded:!!retryCall,
-   ...(retryCall?{retry:{toolCallId:retryCall.toolCallId,resultDigest:retryCall.resultDigest,requestLine:retryCall.requestLine,resultLine:retryCall.resultLine,...(stagePassed?{kind:'stage',stage,operation:command.operation}:{kind:'ui-write',file:path.resolve(cwd,uiFile)})}}:{})};
- };
- const respond=answer=>{
-  const lock=path.join(stateDirectory,'.audit.lock');fs.mkdirSync(stateDirectory,{recursive:true});
-  try{fs.mkdirSync(lock);}catch{throw new Error('Concurrent audit callback; retry without bypassing the gate');}
-  try{const fresh=JSON.parse(C.read(file)||'{"schemaVersion":1,"bindings":{}}');const result=Recovery.record(fresh,recoveryContext(directory),answer);if(fresh.bindings[directory]&&result.recovery)fresh.bindings[directory].recovery=result.recovery;saveIndex(stateDirectory,fresh);return result;}
-  finally{fs.rmdirSync(lock);}
- };
- const automatic=options.event==='PreToolUse'&&directory&&fs.existsSync(path.join(directory,'prototype.json'))&&X.policy(directory)&&
-  (command||G.uiWrite({name:payload.tool_name,input:payload.tool_input||{},cwd},directory))&&command?.operation!=='execution-begin'&&
-  (!existing||existing.contextLine!==source.contextLine||existing.registrationDigest!==record.registrationDigest||existing.settingsDigest!==record.settingsDigest||existing.inputDigest!==require('./native-pilot-lib.cjs').manifest(directory).inputDigest);
- if(options.event==='PreToolUse'&&command?.operation==='execution-begin'||automatic) {
-  assert.ok(directory&&directory.startsWith(path.join(project,'prototypes')+path.sep),'Prototype must be in this project');
-  const fixed=X.policy(directory);assert.ok(fixed,'Existing prototype retains its original contract; do not rewrite it implicitly');
-  assert.equal(fixed.host,identity.host,'This prototype has a fixed contract for another host; inspect it or explicitly migrate and revalidate, do not inherit its invocation proof');
-  const loaded=E.loaded(source.calls,'prototype').some(c=>c.requestLine>source.contextLine);
-  assert.ok(automatic||loaded||/^\s*\/i3-prototype\b/.test(latest.text),'Native prototype Skill or actual shortcut entry required');
-  const meta=F.json(path.join(directory,'prototype.json')),lib=require('./native-pilot-lib.cjs'),current=lib.manifest(directory);
-  const reuse=existing&&existing.inputDigest===current.inputDigest&&existing.contextLine===source.contextLine&&existing.registrationDigest===record.registrationDigest&&existing.settingsDigest===record.settingsDigest;
-  const runId=reuse?existing.runId:crypto.randomUUID();
-  index.bindings[directory]={schemaVersion:1,...(automatic?{association:'automatic'}:{}),runId,sessionId:payload.session_id,project,projectKey:C.projectKey(project),directory,instanceId:meta.instanceId,policyDigest:fixed.digest,inputDigest:current.inputDigest,entryLine:reuse?existing.entryLine:latest.line,promptDigest:reuse?existing.promptDigest:latest.digest,contextLine:source.contextLine,
-   operation:meta.revision==='r001'?'create':'revise',host:identity.host,identitySource:identity.identitySource,product:record.product,productVersion:identity.productVersion,scope:record.scope,registrationDigest:record.registrationDigest,settingsDigest:record.settingsDigest,source:{path:source.path,bytes:source.bytes,digest:source.digest},lastHook:{event:options.event,at:new Date().toISOString(),nativeReadAttempts:source.nativeReadAttempts,nativeRequestStatus:source.nativeRequestStatus}};
-  const lock=path.join(stateDirectory,'.audit.lock');fs.mkdirSync(stateDirectory,{recursive:true});
-  try{fs.mkdirSync(lock);}catch{throw new Error('Concurrent audit callback; retry the original operation');}
-  try {
-   const fresh=JSON.parse(C.read(file)||'{"schemaVersion":1,"bindings":{}}');fresh.bindings[directory]=index.bindings[directory];
-   saveIndex(stateDirectory,fresh);
-   F.write(directory,'qa/execution-context.json',{schemaVersion:1,runId,sessionId:payload.session_id,project,base:record.base,host:identity.host,product:record.product});
-  }finally{fs.rmdirSync(lock);}
-  existing=index.bindings[directory];
-  if(!automatic)return {continue:true};
- }
- if(directory&&fs.existsSync(path.join(directory,'prototype.json'))&&X.policy(directory)) {
-  const fixed=X.policy(directory),answer=decision({event:options.event,source,binding:existing,tool:payload.tool_name,input:payload.tool_input,directory,cwd,policy:fixed,restricted:options.restricted});
-  if(answer.deny)return respond(answer);
-  if(options.event==='PostToolUse'&&command&&(command.operation==='execution-begin'||stage)){
-   // IDE may not have persisted a callback's result yet. Only observed native
-   // failures produce recovery feedback; outer tool success is insufficient.
-   if(callbackCall?.resultLine&&!callbackCall.success){
-    const missing=command.operation==='execution-begin'?['execution-begin']:['execution-evidence'];
-    return respond({feedback:true,missing,reason:`原型 ${command.operation} 实际返回失败，阶段尚未通过。`+Recovery.instruction(missing,{directory,automatic:existing?.association==='automatic'})});
-   }
-   if(command.operation==='execution-begin')return respond({continue:true});
-  }
-  if(options.event==='PreToolUse'&&command&&['build','record-run','record-devtools-review','finalize'].includes(command.operation)){
-   if(existing?.association!=='automatic'&&!completedBegin(source,existing))return respond({deny:true,missing:['execution-begin'],reason:Recovery.instruction(['execution-begin'],{directory})});
-   const checked=X.check(directory,stage,require('./native-pilot-lib.cjs'));
-   if(checked.status==='failed'){
-    const missing=Recovery.missing({source,binding:existing,policy:fixed,stage});if(!missing.length)missing.push('execution-evidence');
-    return respond({deny:true,missing,reason:Recovery.instruction(missing,{directory,automatic:existing?.association==='automatic'})+' '+checked.errors.join('; ')});
-   }
-  }
-  if(G.uiWrite({name:payload.tool_name,input:payload.tool_input||{},cwd},directory)||stage&&['PreToolUse','PostToolUse'].includes(options.event)){
-   const recovery=respond({continue:true});if(recovery.deny||recovery.feedback||recovery.context)return recovery;
-  }
- }
- if(!Object.keys(index.bindings).length)return {continue:true};
- const lock=path.join(stateDirectory,'.audit.lock');fs.mkdirSync(stateDirectory,{recursive:true});
- try{fs.mkdirSync(lock);}catch(error){if(error.code==='EEXIST')throw new Error('Concurrent audit callback; no success evidence recorded. Retry the stage.');throw error;}
- try {
-  const fresh=JSON.parse(C.read(file));let changed=false;
-  for(const entry of Object.values(fresh.bindings)) {
-   if(entry.contextLine!==source.contextLine)continue;
-   if(entry.lastEventKey===eventKey)continue;
-   entry.source={path:source.path,bytes:source.bytes,digest:source.digest};entry.lastEventKey=eventKey;entry.lastHook={event:options.event,at:new Date().toISOString(),nativeReadAttempts:source.nativeReadAttempts,nativeRequestStatus:source.nativeRequestStatus};changed=true;
-   if(options.event==='Stop') {
-    // Completion of an unrelated task must not trigger delivery of every
-    // prototype previously visited in the session. Inspect actual operations
-    // in this response, without another task lifecycle or activation flag.
-    const workedOn=source.calls.some(call=>{
-     if(call.requestLine<=latest.line)return false;
-     if(G.uiWrite({...call,cwd:call.cwd||project},entry.directory))return true;
-     const native=nativeCommand(call.name,call.input,call.cwd||project);
-     return native?.root===entry.directory&&Object.hasOwn(stageFor,native.operation);
-    });
-    if(!workedOn)continue;
-    const lib=require('./native-pilot-lib.cjs'),state=lib.state(entry.directory);
-    const complete=state.execution.status==='passed'&&state.delivery?.status==='current'&&state.delivery.result.runId===entry.runId;
-    const fixed=X.policy(entry.directory),feedback=decision({event:'Stop',source,binding:entry,directory:entry.directory,deliveryCurrent:complete,policy:fixed,restricted:options.restricted,stopHookActive:payload.stop_hook_active||entry.stopFeedbackPrompt===latest.digest});
-    if(feedback.feedback){const result=Recovery.record(fresh,{...recoveryContext(entry.directory),policy:fixed},feedback);entry.recovery=result.recovery;if(fixed.id!==P.AUTO_ID)entry.stopFeedbackPrompt=latest.digest;saveIndex(stateDirectory,fresh);return result;}
-   }
-  }
-  if(changed)saveIndex(stateDirectory,fresh);
- }finally{fs.rmdirSync(lock);}
- return {continue:true};
-}
-function handle(payload,options){
- const D=require('./execution-diagnostics.cjs');
- payload={...payload,tool_name:toolName(payload.tool_name)};
- let diagnostic;
- try{
-  if(options.event==='UserPromptSubmit')D.remember(payload,options);
-  diagnostic=D.context(payload,options);
- }catch{/* The authoritative dispatcher still checks registration and identity. */}
- const toolEvent=['PreToolUse','PostToolUse'].includes(options.event);
- const cwd=diagnostic&&toolCwd(payload,diagnostic.record,diagnostic.project);
- const command=diagnostic&&nativeCommand(payload.tool_name,payload.tool_input,cwd);
- const root=diagnostic&&(command?.root||prototypeForWrite(diagnostic.project,payload.tool_name,payload.tool_input,cwd));
- const mutation=command&&['create','execution-begin','build','revise','replan','record-run','record-devtools-review','finalize'].includes(command.operation)||root&&G.uiWrite({name:payload.tool_name,input:payload.tool_input||{},cwd},root);
- if(diagnostic&&toolEvent&&['Write','Edit','MultiEdit'].includes(payload.tool_name)&&!mutation)return {continue:true};
- if(diagnostic?.task.restriction.blocked&&toolEvent&&mutation)return options.event==='PreToolUse'?{deny:true,reason:'The user explicitly requested read-only work or stopped implementation; no prototype mutation is authorized.'}:{continue:true};
- try{
-  const answer=dispatch(payload,diagnostic?{...options,nativeProject:diagnostic.project,restricted:diagnostic.task.restriction.blocked}:options);
-  if(toolEvent&&!answer.deny&&!answer.feedback){if(mutation)D.recover(diagnostic);D.observed(diagnostic,payload);}
-  return answer;
- }catch(error){
-  if(diagnostic)return mutation?D.failure(diagnostic,payload,error):{continue:true};
-  if(options.event==='PreToolUse') {
-   // A damaged/absent task source must not turn a protected write into exit 1
-   // (which CodeBuddy treats as non-blocking). This is a failure-only fallback,
-   // not a successful task association or invocation receipt.
-   const cwd=payload.cwd==='/'&&options.scope==='project'?path.dirname(options.base):payload.cwd;
-   if(cwd&&path.isAbsolute(cwd)) {
-    const parsed=nativeCommand(payload.tool_name,payload.tool_input,cwd),input=payload.tool_input||{},file=input.file_path||input.filePath||input.path||input.TargetFile;
-    let target=typeof file==='string'?path.dirname(path.resolve(cwd,file)):parsed?.root;
-    while(target&&target!==path.dirname(target)) {
-     if(fs.existsSync(path.join(target,'prototype.json'))&&X.policy(target)&&(parsed||G.uiWrite({name:payload.tool_name,input,cwd},target)))return {deny:true,reason:'原型 Hook 运行异常，当前操作未放行：'+error.message+'。请停止自动重试并交由维护入口处理；原型会话不排查 Hook。'};
-     target=path.dirname(target);
-    }
-   }
-  }
-  throw error;
- }
-}
-module.exports={tokens,nativeCommand,eventCall,eventSource,decision,safeProject,toolCwd,handle};

package/skills/i3-ui-prototype/scripts/codebuddy-ide-source.cjs

@@ -1,69 +0,0 @@
-'use strict';
-// Observed CodeBuddy IDE history format: Hook-provided index.json and only the
-// UUID message files explicitly referenced by that index. No directory scan.
-const fs=require('node:fs'),path=require('node:path'),assert=require('node:assert/strict');
-const ID=/^[a-f0-9]{32}$/;
-const {toolName}=require('./native-tool-name.cjs');
-function read(file) {
- assert.equal(path.basename(file),'index.json','Expected native IDE index');
- const directory=path.dirname(file),sessionId=path.basename(directory);
- assert.match(sessionId,ID,'Invalid IDE session directory');
- let total=0;
- const load=target=>{
-  const stat=fs.lstatSync(target);assert.ok(stat.isFile()&&!stat.isSymbolicLink(),'Invalid IDE history file');
-  total+=stat.size;assert.ok(total<=64*1024*1024,'IDE history exceeds size limit');
-  return JSON.parse(fs.readFileSync(target,'utf8'));
- };
- const index=load(file);assert.ok(Array.isArray(index.messages)&&Array.isArray(index.requests),'Unsupported IDE index');
- assert.ok(index.messages.length<=10000&&index.requests.length<=10000,'IDE history index exceeds limit');
- const folder=path.join(directory,'messages');assert.ok(fs.lstatSync(folder).isDirectory()&&!fs.lstatSync(folder).isSymbolicLink(),'Invalid IDE message directory');
- const requestIds=new Map(),seen=new Set(),events=[];let latestAssistant='',workspace;
- for(const request of index.requests){
-  assert.match(request.id,ID,'Invalid IDE request ID');assert.ok(Array.isArray(request.messages),'Invalid IDE request messages');
-  for(const id of request.messages){assert.match(id,ID,'Invalid IDE message reference');assert.ok(!requestIds.has(id),'Duplicate IDE message request');requestIds.set(id,request.id);}
- }
- for(const item of index.messages){
-  assert.match(item.id,ID,'Invalid IDE message ID');assert.ok(!seen.has(item.id),'Duplicate IDE message ID');seen.add(item.id);
-  const row=load(path.join(folder,item.id+'.json'));
-  assert.equal(row.id,item.id,'IDE message identity differs');assert.equal(row.role,item.role,'IDE message role differs');
-  const message=JSON.parse(row.message),extra=JSON.parse(row.extra||'{}');
-  assert.equal(message.role,row.role,'IDE serialized message role differs');
-  assert.ok(requestIds.has(item.id),'Unbound IDE message');
-  // The index is the primary request membership. During execution the SDK can
-  // write message content before its duplicate extra.requestId metadata.
-  const requestId=requestIds.get(item.id);
-  if(extra.requestId!==undefined)assert.equal(extra.requestId,requestId,'IDE request identity differs');
-  assert.ok(Array.isArray(message.content),'Invalid IDE message content');
-  const base={sessionId,nativeMessageId:item.id,nativeRequestId:requestId};
-  if(row.role==='user'&&!extra.isHelperMessage){
-   const hostText=message.content[0]?.type==='text'?message.content[0].text:'';
-   const context=typeof hostText==='string'?hostText.match(/^<user_info>\s*([\s\S]*?)<\/user_info>/):null;
-   const nativeFolder=context?.[1].match(/^Workspace Folder:\s*(\/[^\r\n]+)$/m)?.[1]?.trim();
-   if(nativeFolder){
-    assert.ok(path.isAbsolute(nativeFolder)&&!/[\x00\r\n]/.test(nativeFolder),'Invalid native IDE workspace');
-    if(workspace)assert.equal(workspace,nativeFolder,'Native IDE workspace changed within one session');
-    workspace=nativeFolder;
-   }
-   assert.ok(Array.isArray(extra.sourceContentBlocks),'Original IDE user task is missing');
-   const text=extra.sourceContentBlocks.filter(b=>b.type==='text'&&typeof b.text==='string').map(b=>b.text).join('\n');
-   if(text.trim())events.push({...base,type:'user',message:{content:[{type:'text',text}]}});
-  }else if(row.role==='assistant'){
-   const text=message.content.filter(b=>b.type==='text').map(b=>b.text||'').join('\n');
-   if(text)latestAssistant=text;
-   for(const block of message.content.filter(b=>b.type==='tool-call')){
-    assert.ok(block.args&&typeof block.args==='object'&&!Array.isArray(block.args),'Invalid IDE tool arguments');
-    events.push({...base,type:'assistant',message:{content:[{type:'tool_use',id:block.toolCallId,name:toolName(block.toolName),input:block.args}]}});
-   }
-  }else if(row.role==='tool'){
-   for(const block of message.content.filter(b=>b.type==='tool-result')){
-    const result=block.result,success=!block.isError&&result?.success===true&&result.status==='success';
-    events.push({...base,type:'user',message:{content:[{type:'tool_result',tool_use_id:block.toolCallId,
-     tool_name:toolName(block.toolName),content:result,is_error:!success}]}});
-   }
-  }
- }
- // Only stable prompt/call/result facts form the prefix cursor. Streaming text,
- // reasoning, request state and mutable toolStatus do not invalidate old facts.
- return {text:events.map(row=>JSON.stringify(row)).join('\n')+'\n',latestAssistant,workspace,format:'codebuddy-ide-index-v1'};
-}
-module.exports={read};

package/skills/i3-ui-prototype/scripts/codebuddy-registration.cjs

@@ -1,125 +0,0 @@
-'use strict';
-// Pure configuration planning. This module does not install or activate a host.
-const assert = require('node:assert/strict');
-const path = require('node:path');
-const fs = require('node:fs');
-const crypto = require('node:crypto');
-const { digest } = require('./execution-policy.cjs');
-const OWNER = 'i3-prototype-codebuddy-v1';
-const EVENTS = ['SessionStart', 'UserPromptSubmit', 'PreToolUse', 'PostToolUse', 'Stop'];
-function quote(value) {
-  assert.ok(typeof value === 'string' && !/[\x00\r\n]/.test(value), 'Unsafe Hook argument');
-  return "'" + value.replaceAll("'", "'\\''") + "'";
-}
-function config(text) {
-  if (text === null) return {};
-  let value; try { value = JSON.parse(text); } catch { throw new Error('Settings must be valid JSON; preserve the original file'); }
-  assert.ok(value && !Array.isArray(value) && typeof value === 'object', 'Settings must be a JSON object');
-  assert.ok(!value.hooks || (typeof value.hooks === 'object' && !Array.isArray(value.hooks)), 'Invalid hooks configuration');
-  for (const groups of Object.values(value.hooks || {})) {
-    assert.ok(Array.isArray(groups), 'Hook groups must be arrays');
-    for (const group of groups) assert.ok(group && Array.isArray(group.hooks), 'Invalid Hook group');
-  }
-  return value;
-}
-function ownedMarker(group) { return group.hooks.some(hook => typeof hook.command === 'string' && hook.command.includes(OWNER)); }
-function plan(options) {
-  const { action = 'keep', scope, product = 'auto', base, project, nodePath, scriptPath, scriptDigest, currentText = null, record = null,
-    transcriptRoots = record?.transcriptRoots || [], transcriptMode = record?.transcriptMode || (transcriptRoots.length ? 'manual' : 'auto'), productVersion = record?.productVersion || 'unreported' } = options;
-  assert.ok(['keep', 'enable', 'disable'].includes(action), 'Invalid Hook action');
-  assert.ok(['project', 'global'].includes(scope), 'Invalid installation scope');
-  assert.ok(['auto', 'ide', 'cli'].includes(product), 'Use automatic product detection, or a legacy ide/cli profile');
-  const hosts=[...new Set(options.hosts || [...(record?.hosts || (record ? ['codebuddy'] : [])),...(options.agents?.filter(host=>['codebuddy','workbuddy'].includes(host)) || [options.host || 'codebuddy'])])].sort();
-  assert.ok((hosts.length||action==='disable')&&hosts.every(host=>['codebuddy','workbuddy'].includes(host)), 'Unsupported prototype Hook host');
-  for (const item of [base, project, nodePath, scriptPath]) assert.ok(typeof item === 'string' && path.isAbsolute(item) && !/[\x00\r\n]/.test(item), 'Absolute safe registration paths required');
-  if (process.platform === 'win32' && action !== 'disable') throw new Error('CodeBuddy A+B Windows Hook quoting is not yet verified');
-  const before = config(currentText), after = structuredClone(before), activeRecord = record && record.owner === OWNER ? record : null;
-  if (record) {
-    assert.ok(activeRecord && [1,2].includes(activeRecord.schemaVersion), 'Unknown registration ownership');
-    assert.equal(activeRecord.scope, scope, 'Registration scope changed');
-    if(product!=='auto')assert.equal(activeRecord.product, product, 'Disable the previous product profile before changing it');
-    assert.equal(activeRecord.base, base, 'Registration base changed');
-  }
-  const found = {};
-  for (const [event, groups] of Object.entries(after.hooks || {})) {
-    for (const group of groups.filter(ownedMarker)) {
-      assert.ok(activeRecord?.groups[event], 'Hook ownership is missing; do not adopt an unknown command');
-      assert.deepEqual(group, activeRecord.groups[event], 'Owned Hook was modified; preserve the user changes');
-      assert.ok(!found[event], 'Duplicate owned Hook registration'); found[event] = group;
-    }
-  }
-  if (activeRecord) for (const event of Object.keys(activeRecord.groups)) assert.ok(found[event], 'Owned Hook registration changed or is missing');
-  const unchanged = action === 'keep' && !activeRecord;
-  let recordAfter = null;
-  if (!unchanged) {
-    after.hooks ||= {};
-    for (const event of Object.keys(found)) after.hooks[event] = after.hooks[event].filter(group => group !== found[event]);
-    if (action !== 'disable') {
-      assert.match(scriptDigest || '', /^[a-f0-9]{64}$/, 'Hook script digest required');
-      const groups = {};
-      for (const event of EVENTS) {
-        const argv = [nodePath, scriptPath, '--registration', OWNER, '--base', base, '--scope', scope, '--product', product, '--event', event];
-        const group = { ...(event.endsWith('ToolUse') ? { matcher: '' } : {}), hooks: [{ type: 'command', command: argv.map(quote).join(' '), timeout: 10 }] };
-        groups[event] = group; (after.hooks[event] ||= []).push(group);
-      }
-      assert.ok(Array.isArray(transcriptRoots)&&transcriptRoots.every(root=>typeof root==='string'&&path.isAbsolute(root)&&!/[\x00\r\n]/.test(root)),'Absolute native transcript roots required');
-      assert.ok(['auto','manual'].includes(transcriptMode),'Invalid native transcript mode');
-      assert.ok(transcriptMode==='manual'?transcriptRoots.length>0:transcriptRoots.length===0,'Manual transcript mode requires roots; auto uses only the native callback file');
-      recordAfter = { schemaVersion: product==='auto'?2:1, owner: OWNER, scope, product, ...(product==='auto'?{hosts}:{}), base, scriptPath, scriptDigest, nodePath, groups, transcriptMode, transcriptRoots, productVersion };
-    }
-  }
-  const afterText = unchanged ? currentText : JSON.stringify(after, null, 2) + '\n';
-  return { action, scope, product, base, project, settingsPath: path.join(base, 'settings.json'),
-    recordPath: path.join(base, 'state/i3-prototype/installation.json'), beforeDigest: digest(currentText), beforeRecordDigest: digest(record), afterText, recordAfter,
-    summary: { status: unchanged || action === 'disable' ? 'not-enabled' : product === 'cli' ? 'pending-host-review' : 'registered',
-      ...(recordAfter?{transcript:{mode:transcriptMode,status:'awaiting-native-event',invocationVerified:false}}:{}),
-      scope, product, settingsPath: path.join(base, 'settings.json'), events: recordAfter ? EVENTS : [], changed: afterText !== currentText || digest(recordAfter)!==digest(record),
-      next: product === 'cli' && recordAfter ? 'Review the external settings change in CodeBuddy /hooks; then start a new session.' : 'Actual Hook invocation must be checked in the host; registration is not activation.' } };
-}
-function safePath(file) {
-  let current = path.parse(path.resolve(file)).root;
-  for (const part of path.resolve(file).slice(current.length).split(path.sep)) {
-    current = path.join(current, part);
-    if (fs.existsSync(current)) assert.ok(!fs.lstatSync(current).isSymbolicLink(), 'Hook settings symlink refused');
-  }
-}
-const fileIO = {
-  lock(file) {safePath(file);fs.mkdirSync(path.dirname(file),{recursive:true});const lock=file+'.i3-prototype.lock';try{fs.mkdirSync(lock);}catch{throw new Error('Hook configuration is being updated; retry without overwriting the other change');}return ()=>fs.rmdirSync(lock);},
-  read(file) {
-    safePath(file); if (!fs.existsSync(file)) return null;
-    assert.ok(fs.statSync(file).isFile() && fs.statSync(file).size <= 4 * 1024 * 1024, 'Invalid or oversized Hook configuration');
-    return fs.readFileSync(file, 'utf8');
-  },
-  write(file, text, expected) {
-    assert.equal(digest(this.read(file)), expected, 'Hook configuration changed concurrently');
-    if (text === null) { if (fs.existsSync(file)) fs.unlinkSync(file); return; }
-    fs.mkdirSync(path.dirname(file), { recursive: true }); safePath(file);
-    const staging = file + '.' + crypto.randomUUID() + '.new';
-    try {
-      fs.writeFileSync(staging, text, { flag: 'wx', mode: fs.existsSync(file) ? fs.statSync(file).mode & 0o777 : 0o600 });
-      assert.equal(digest(this.read(file)), expected, 'Hook configuration changed before publication');
-      fs.renameSync(staging, file);
-    } finally { if (fs.existsSync(staging)) fs.unlinkSync(staging); }
-  },
-};
-function apply(change, io = fileIO) {
-  const unlock=io.lock?io.lock(change.settingsPath):()=>{};
-  try {return applyLocked(change,io);}finally{unlock();}
-}
-function applyLocked(change, io) {
-  const before = io.read(change.settingsPath), recordBefore = io.read(change.recordPath);
-  assert.equal(digest(before), change.beforeDigest, 'Hook configuration changed after preview');
-  assert.equal(digest(recordBefore === null ? null : JSON.parse(recordBefore)), change.beforeRecordDigest, 'Hook ownership changed after preview');
-  const recordAfter = change.recordAfter ? JSON.stringify(change.recordAfter, null, 2) + '\n' : null;
-  if (change.afterText === before && recordAfter === recordBefore) return change.summary;
-  let settingsWritten = false;
-  try {
-    if (change.afterText !== before) { io.write(change.settingsPath, change.afterText, digest(before)); settingsWritten = true; }
-    if (recordAfter !== recordBefore) io.write(change.recordPath, recordAfter, digest(recordBefore));
-  } catch (error) {
-    if (settingsWritten && io.read(change.settingsPath) === change.afterText) io.write(change.settingsPath, before, digest(change.afterText));
-    throw error;
-  }
-  return change.summary;
-}
-module.exports = { OWNER, EVENTS, quote, config, plan, apply, fileIO };

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

@@ -1,98 +0,0 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-const assert = require('node:assert/strict');
-const read = file => JSON.parse(fs.readFileSync(file, 'utf8'));
-
-function extract(directory, manifest, files) {
-  assert.equal(manifest.entry, 'index.html', 'Content templates use the offline index.html convention');
-  const html = fs.readFileSync(path.join(directory, manifest.entry), 'utf8');
-  assert.ok(!/<script\b[^>]*type=["']module/i.test(html), 'Offline entry cannot use modules');
-  const routesMatch = html.match(/id="prototype-offline-routes">([\s\S]*?)<\/script>/);
-  assert.ok(routesMatch, 'Editable route inventory is required');
-  const routes = JSON.parse(routesMatch[1]);
-  const fragments = new Map([...html.matchAll(/^<template data-source="([^"]+)">\n([\s\S]*?)^<\/template>/gm)].map(match => [match[1], match[2]]));
-  assert.ok(fragments.size, 'Editable HTML fragments are required');
-  const resources = [];
-  for (const match of html.matchAll(/<(script|link)\b[^>]*\b(src|href)="([^"]+)"/gi)) {
-    if (match[3].startsWith('data:')) continue;
-    assert.ok(!/^(?:[a-z]+:|\/)/i.test(match[3]) && !match[3].split('/').includes('..'), 'Offline resources must remain inside the template');
-    const resource = match[3].split(/[?#]/)[0];
-    assert.ok(files.some(file => file.path === resource), `Offline resource missing: ${resource}`);
-    resources.push({ file: manifest.entry, path: resource });
-    if (match[1].toLowerCase() === 'script') {
-      const script = fs.readFileSync(path.join(directory, resource), 'utf8');
-      assert.ok(!/\bfetch\s*\(|\bXMLHttpRequest\b|\bimport\s*(?:\(|["'{*])|\bfrom\s*["']/.test(script), 'Offline runtime cannot load modules or remote HTML');
-    }
-  }
-  const pages = [...new Set(routes.map(route => route.component).filter(Boolean))].map(component => {
-    const fragment = 'reference/' + component.replace(/^\.\//, '').replace(/\.js$/, '.html');
-    assert.ok(fragments.has(fragment), `Missing page HTML: ${fragment}`);
-    const title = fragments.get(fragment).match(/<h1[^>]*>([^<{]+)<\/h1>/)?.[1]?.trim();
-    return { id: path.posix.basename(component, '.js').replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase(),
-      title: title || path.posix.basename(component, '.js'), file: 'index.html', fragment,
-      routes: routes.filter(route => route.component === component).map(route => route.path) };
-  });
-  assert.equal(new Set(pages.map(page => page.id)).size, pages.length, 'Duplicate content page identity');
-  return { kind: 'content-reference', pages, regions: [], bindings: [], fields: [], actions: [], resources,
-    htmlFragments: [...fragments.keys()], routes, requiredBindings: [], requiredScenarios: [] };
-}
-
-function scopeInputs(snapshot, scope, contract) {
-  assert.ok(Array.isArray(scope?.pages) && scope.pages.length, 'Provide sourced PRD scope.pages; the reference is not the business requirement');
-  assert.ok(scope.requirements?.length, 'Provide sourced business requirements');
-  const known = new Set(snapshot.index.pages.map(page => page.id));
-  const seen = new Set(['app-shell']), regions = [{ pageId: 'app-shell', id: 'appearance', mode: 'application-shell' }], bindings = [];
-  const defaults = {
-    theme: { defaultTheme: 'light', presets: ['light', 'dark', 'fresh', 'tech'] },
-    filter: { resetPage: true, clearSelection: true }, selection: { strategy: 'current-page-clear-on-change' },
-    pagination: { mode: 'adjustable', defaultPageSize: 10, pageSizeOptions: [10, 20, 50], minimumTestPages: 3 },
-    bulk: { target: 'selected-only' }, edit: { presentation: 'drawer', preserveOnFailure: true },
-  };
-  for (const page of scope.pages) {
-    assert.match(page.id || '', /^[a-z][a-z0-9-]{0,63}$/);
-    assert.ok(!seen.has(page.id), `Duplicate business page: ${page.id}`); seen.add(page.id);
-    assert.ok(page.title?.trim() && known.has(page.referencePage), `Missing explicit template reference page: ${page.id}`);
-    assert.ok(page.regions?.length, `Declare the actual region modes: ${page.id}`);
-    for (const region of page.regions) {
-      assert.match(region.id || '', /^[a-z][a-z0-9-]{0,63}$/);
-      assert.ok(['management-list', 'edit-form', 'content'].includes(region.mode) || (scope.schemaVersion === 3 && require('./generation-contract.cjs').resource(snapshot, 'generation.json').patterns.includes(region.pattern || region.mode)), `Unknown business region mode: ${region.mode}`);
-      regions.push({ pageId: page.id, id: region.id, mode: scope.schemaVersion === 3 ? 'content' : region.mode });
-    }
-  }
-  for (const region of regions) for (const capability of snapshot.definition.capabilities) {
-    if (capability.requirement !== 'required' || !capability.appliesTo.includes(region.mode)) continue;
-    const configured = scope.pages.find(page => page.id === region.pageId)?.regions.find(item => item.id === region.id)?.parameters?.[capability.id];
-    const parameters = configured || (capability.id === 'feedback'
-      ? { states: region.mode === 'edit-form' ? ['loading', 'error', 'success'] : ['loading', 'empty', 'error', 'success'] }
-      : defaults[capability.id]);
-    bindings.push({ id: `${region.pageId}/${region.id}/${capability.id}`, pageId: region.pageId, regionId: region.id, capabilityId: capability.id, parameters });
-  }
-  const requirementIds = new Set();
-  for (const requirement of scope.requirements) {
-    assert.ok(typeof requirement.id==='string'&&requirement.id.trim()&&!requirementIds.has(requirement.id), `Missing or duplicate requirement identity: ${requirement.id}`);
-    requirementIds.add(requirement.id);
-    assert.ok(requirement.pages?.length && requirement.pages.every(page => seen.has(page) && page !== 'app-shell'), `Map each business requirement to its pages: ${requirement.id}`);
-  }
-  for (const page of scope.pages) assert.ok(scope.requirements.some(requirement => requirement.pages?.includes(page.id)), `Business page lacks a requirement: ${page.id}`);
-  const fixed = { schemaVersion: 1, definition: snapshot.definition, regions, bindings, decisions: scope.decisions || [] };
-  assert.ok(!fixed.decisions.some(decision=>decision.bindingId==='app-shell/appearance/theme'&&decision.status==='not-applicable'), 'The default four-theme contract must retain its acceptance');
-  const result = contract.checkCapabilities({ ...fixed, scope });
-  assert.equal(result.status, 'passed', result.errors.join('; '));
-  return { fixed, result };
-}
-function checkInputs(inputsRoot, contract) {
-  const snapshot = read(path.join(inputsRoot, 'template-snapshot.json')), scope = read(path.join(inputsRoot, 'scope.json'));
-  const expected = scopeInputs(snapshot, scope, contract), fixed = read(path.join(inputsRoot, 'capabilities.json'));
-  assert.deepEqual(fixed, expected.fixed, 'Business capability bindings differ from the fixed sourced page/region contract');
-  return expected.result;
-}
-function pageContent(snapshot, pageId) {
-  assert.equal(snapshot.kind, 'content-reference');
-  const page = snapshot.index.pages.find(entry=>entry.id===pageId);
-  assert.ok(page, `Unknown reference page: ${pageId}`);
-  const html = Buffer.from(snapshot.files.find(file=>file.path==='index.html').content, 'base64').toString('utf8');
-  const fragments = new Map([...html.matchAll(/^<template data-source="([^"]+)">\n([\s\S]*?)^<\/template>/gm)].map(match=>[match[1],match[2]]));
-  return { ...page, html: fragments.get(page.fragment), templateDigest: snapshot.digest, readOnly: true };
-}
-module.exports = { extract, scopeInputs, checkInputs, pageContent };