@josephyulei/summon-foundation 0.1.8 → 0.1.9

package/README.md

@@ -4,7 +4,7 @@
 
 保留真实下载状态与独立确认。基础环境不能安全启动页面时，由 Codex 对话先披露并取得独立批准，再准备专用环境；页面启动后全程同页。具体方法见仓库 `docs/install-with-codex.md`，不能先运行 npx 来准备缺失的 Node。不修改共享 PATH；获取器专用环境及其回执按缓存保留，程序另用随包运行时。发行发现仅需 curl，获取还需 tar；已验证载荷的确认、恢复和卸载不依赖下载工具。
 
-0.1.8 单页试用入口与 Foundation 0.2.14 的运行引擎共同支持当前用户共用安装及清晰的完成、取消和部分完成反馈。同一页面内保留目录选择、程序和 Skill 独立确认。真实安装、新任务发现和主动告知仍需独立验收。
+0.1.9 单页试用入口与 Foundation 0.2.15 的运行引擎共同支持当前用户共用安装及清晰的完成、取消和部分完成反馈。同一页面内保留目录选择、程序和 Skill 独立确认。真实安装、新任务发现和主动告知仍需独立验收。
 
 首次 URL 持续显示本次流程；确认仅转交本次受控子进程的当前计划，不新开manager页。--acquire仍只读获取；--resume仅在用户明确要求后恢复未完成Skill，不重放程序安装。
 
@@ -16,7 +16,7 @@ Foundation 的薄获取入口，不包含完整运行包，没有 npm 安装生
 确认 registry 中存在本版本及对应不可变 Release 后，在具备安装权限的新 Codex 对话粘贴：
 
 ```text
-npx --yes --package @josephyulei/summon-foundation@0.1.8 summon foundation
+npx --yes --package @josephyulei/summon-foundation@0.1.9 summon foundation
 ```
 
 旧版退出推荐入口；支持边界见[现行支持策略](https://github.com/y15801172513-lang/foundation/blob/main/docs/install-platform-024.md#现行支持策略)。旧不可变版本不修改，不自动迁移或清除旧安装。

package/bin/summon.mjs

@@ -11,7 +11,7 @@ import {followMaintenance} from '../lib/maintenance-handoff.mjs';
 import {installedClient} from '../lib/manager-step.mjs';
 import {resumeSkillHandoff} from '../lib/resume-handoff.mjs';
 import {parseSummonArgs} from '../lib/cli-options.mjs';
-import {createOperation,saveOperation,readOperation,runtimeObservation} from '../lib/operation-result.mjs';
+import {createOperation,saveOperation,readOperation,runtimeObservation,operationExitCode} from '../lib/operation-result.mjs';
 import {createJourneyControl} from '../lib/journey-control.mjs';
 import {inspectEntryEnvironment} from '../lib/environment-check.mjs';
 
@@ -52,7 +52,7 @@ function stageDirectory(){
 }
 let operation=null,stage=null,progressPage=null;
 const journeyControl=createJourneyControl(()=>operation,patch=>patch?updateOperation(patch):progressPage?.publish());
-function updateOperation(patch){if(!operation)return;Object.assign(operation,patch,{updatedAt:new Date().toISOString()});const file=saveOperation(operation,stage);if(file)operation.resultFile=file;progressPage?.publish();console.log(JSON.stringify({status:'FOUNDATION_INSTALL_OPERATION',...operation,resultFile:file,recordSaved:!!file}));}
+function updateOperation(patch){if(!operation)return;Object.assign(operation,patch,{updatedAt:new Date().toISOString()});if(operation.terminal)operation.exitCode=operationExitCode(operation);const file=saveOperation(operation,stage);if(file)operation.resultFile=file;progressPage?.publish();console.log(JSON.stringify({status:'FOUNDATION_INSTALL_OPERATION',...operation,resultFile:file,recordSaved:!!file}));}
 try{
   const args=parseSummonArgs(process.argv.slice(2));
   if(args.help){console.log(help);process.exit(0);}
@@ -74,7 +74,7 @@ try{
     console.log(JSON.stringify({status:'FOUNDATION_SINGLE_PAGE',url:progressPage.url,operationId:operation.operationId}));
     const env={...process.env};for(const key of ['NODE_OPTIONS','NODE_PATH','NODE_V8_COVERAGE','NODE_REDIRECT_WARNINGS','NODE_COMPILE_CACHE','NODE_COMPILE_CACHE_PORTABLE','NODE_PRESERVE_SYMLINKS'])delete env[key];
     const result=await resumeSkillHandoff({file:args.resume,env,journeyControl,onChange:updateOperation});
-    updateOperation(result);process.exitCode=result.state==='completed'?0:1;
+    updateOperation(result);process.exitCode=operationExitCode(result);
   }else if(maintenance){
     plainPath(args.root);
     const env={...process.env};for(const key of ['NODE_OPTIONS','NODE_PATH','NODE_V8_COVERAGE','NODE_REDIRECT_WARNINGS','NODE_COMPILE_CACHE','NODE_COMPILE_CACHE_PORTABLE','NODE_PRESERVE_SYMLINKS'])delete env[key];
@@ -96,7 +96,7 @@ try{
       updateOperation({phase:'acquired'});
     }
     updateOperation(await followMaintenance({operation,kind:operation.kind,candidate,env,onChange:updateOperation,journeyControl}));
-    process.exitCode=operation.state==='completed'?0:1;
+    process.exitCode=operationExitCode(operation);
     await progressPage.close();progressPage=null;
   }else if(!args.prepare&&!args.acquire){
     if(initialEnvironment.state!=='ready'){operation=createOperation();updateOperation({phase:'checking-environment',environment:initialEnvironment});fail('发行查询所需环境无法核实；尚未联网');}
@@ -145,6 +145,6 @@ try{
       catch(error){updateOperation({state:'partial',phase:'finished',terminal:true,skillRegistered:false,handoffFailure:{code:error.code||'SKILL_HANDOFF_REQUIRES_VERIFICATION',command:error.command||null,exitCode:error.exitCode??null},next:'程序已安装，Skill 接续未完成；保留当前计划与结果，仅核实未完成步骤，不重装程序或重放确认。'});}
     }
     if(!operation.terminal)updateOperation({state:'verification-required',terminal:true,childExitCode:ended.code,next:'服务退出不等于成功或取消；只读核验原 session 与 installed 状态，不自动重试'});
-    process.exitCode=operation.state==='partial'?1:ended.code;
+    process.exitCode=operationExitCode(operation);
   }
-}catch(e){const message=String(e.message).replace(/https?:\/\/\S+/g,'[已脱敏网址]').replace(/(?:github_pat_|ghp_|npm_)[A-Za-z0-9_]+/g,'[已脱敏凭据]');updateOperation({state:e.code==='ENTRY_CHOICE_CANCELLED'?'cancelled-no-install':e.code==='ENTRY_CHOICE_EXPIRED'?'expired-no-install':operation?.programState==='completed'?'partial':operation&&operation.installationWrites!=='none'?'verification-required':'failed',terminal:true,...(operation?.programState==='completed'?{failedPhase:operation.phase,phase:'finished'}:{}),errorCode:['ACQUISITION_TRANSPORT_FAILED','ACQUISITION_VALIDATION_FAILED','ENTRY_CHOICE_CANCELLED','ENTRY_CHOICE_EXPIRED'].includes(e.code)?e.code:'INSTALL_ENTRY_FAILED',diagnostic:e.diagnostic||null,next:message+'。先核验旧工具进程已结束及同次结果；保留材料，不自动重试或重放安装确认'});console.error(`错误：${message}`);process.exitCode=1;}finally{if(progressPage)await progressPage.close();}
+}catch(e){const message=String(e.message).replace(/https?:\/\/\S+/g,'[已脱敏网址]').replace(/(?:github_pat_|ghp_|npm_)[A-Za-z0-9_]+/g,'[已脱敏凭据]');updateOperation({state:e.code==='ENTRY_CHOICE_CANCELLED'?'cancelled-no-install':e.code==='ENTRY_CHOICE_EXPIRED'?'expired-no-install':operation?.programState==='completed'?'partial':operation&&operation.installationWrites!=='none'?'verification-required':'failed',terminal:true,...(operation?.programState==='completed'?{failedPhase:operation.phase,phase:'finished'}:{}),errorCode:['ACQUISITION_TRANSPORT_FAILED','ACQUISITION_VALIDATION_FAILED','ENTRY_CHOICE_CANCELLED','ENTRY_CHOICE_EXPIRED'].includes(e.code)?e.code:'INSTALL_ENTRY_FAILED',diagnostic:e.diagnostic||null,next:message+'。先核验旧工具进程已结束及同次结果；保留材料，不自动重试或重放安装确认'});console.error(`错误：${message}`);process.exitCode=operationExitCode(operation);}finally{if(progressPage)await progressPage.close();}

package/lib/journey-view.mjs

@@ -15,19 +15,20 @@ export function lifecycleContent(record, observations) {
     else if(cancelled)title='已取消'+verb;
     else if(expired)title=verb+'确认已到期';
     else if(environmentBlocked)title='运行环境需要处理';
-    else if(record.state==='failed'||stepStates.includes('failed'))title=verb+'未成功';
+    else if(record.state==='failed'||stepStates.includes('failed'))title=verb+'未完成';
     else title=anyCompleted?'部分步骤已完成':'操作结果待确认';
     if(programDone&&kind!=='uninstall'&&!skipped&&!record.skillRegistered)title+='；对话功能'+(['cancelled','skipped'].includes(registration)?'未启用':registration==='failed'?'未处理成功':'尚未完成');
   }
   let program=programDone?'程序'+verb+'已完成。'+(kind==='uninstall'?'卸载结果已保存。':record.runtimeHealth==='passed'?'已检查，可以正常打开。':'能否正常打开仍需检查。')
     :record.installationWrites==='none'||['not-started','cancelled','expired'].includes(record.programState)||['cancelled','expired'].includes(observations.program?.state)?'尚未'+(kind==='install'?'安装 Foundation':'执行程序'+verb)+'。':'程序是否发生变化仍需查看本次结果，请勿重复执行。';
   if(programDone&&kind==='update'&&record.programResult?.cleanup)program+=record.programResult.cleanup.state==='completed'?'本次下载暂存已按计划清理。':'部分下载文件已保留，不影响已完成的更新。';
+  if(!programDone&&record.programState==='failed')program=verb+'未完成。'+(record.rollback==='completed'?'本次程序变更已回退；不表示安装成功。':'是否已回退仍待核实；不要重复执行。');
   const skill=kind==='uninstall'?(removal==='completed'?'已处理本安装的对话功能文件；修改或未知文件按计划保留。':removal?'对话功能尚未移除成功，原文件保留。':record.hadSkill===false?'本安装没有已登记的对话功能，此次未删除其他 Skill。':'尚未确认是否需要移除对话功能。')
     :record.skillRegistered===true?'对话功能文件已就位，请在新 Codex 对话中尝试“打开 Foundation”。'
     :skipped?(kind==='update'?'本次未新增对话功能。':'本次不启用 Codex 对话功能。')
     :['cancelled','skipped'].includes(registration)?'本次未启用 Codex 对话功能。'
     :registration==='failed'?'对话功能未处理成功；只需检查这一项，不必重装程序。'
-    :record.terminal&&!programDone&&(cancelled||expired)?'本次未启用 Codex 对话功能。'
+    :record.terminal&&!programDone&&(cancelled||expired||record.programState==='failed')?'本次未安装或启用 Skill；程序失败不会继续安装 Skill。'
     :observations.material?.state==='completed'?'Skill 已准备，还需要你确认启用到 Codex。'
     :record.journeyContext?.skillChoice==='selected'?'已选择对话功能，仍需单独确认后才能启用。':'可选择是否启用 Codex 对话功能。';
   const description=record.terminal?program+' '+skill:kind==='install'?'给当前用户安装一份 Foundation，不同项目按需使用，项目资料各自保管。'+(skipped?'本次不启用对话功能。':'对话功能可选，需另外确认。')

package/lib/operation-result.mjs

@@ -5,6 +5,14 @@ import crypto from 'node:crypto';
 export function createOperation() {
   return {schemaVersion:'1.0.0',operationId:crypto.randomUUID(),pid:process.pid,startedAt:new Date().toISOString(),phase:'discovering',state:'running',terminal:false,installationWrites:'none',skillRegistered:false};
 }
+// Product outcome, never the confirmation server's exit status, controls the CLI.
+export function operationExitCode(record) {
+  if (!record?.terminal) return 1;
+  if (record.state === 'completed') return 0;
+  if (['cancelled','cancelled-no-install'].includes(record.state)) return 2;
+  if (['expired','expired-no-install'].includes(record.state)) return 3;
+  return 1;
+}
 // Observations from the verified runtime, never confirmation or execution authority.
 export function runtimeObservation(event) {
   let confirmationUrl;
@@ -13,9 +21,11 @@ export function runtimeObservation(event) {
   if(['FOUNDATION_SELECTION_BOUND','AWAITING_FOUNDATION_UI_CONFIRMATION'].includes(event.status))return {phase:'awaiting-confirmation',...(event.journeyContext?{journeyContext:event.journeyContext}:{}),sessionId:event.sessionId,planHash:event.planHash,installationWrites:'none',...(confirmationUrl?{confirmationUrl}:{})};
   if(event.status==='FOUNDATION_OPERATION_STATE'&&['executing','consumed'].includes(event.state))return {phase:'executing',sessionId:event.sessionId,installationWrites:'possible'};
   if(event.status==='BOOTSTRAP_OPERATION_ENDED'){
-    const state=['completed','failed','cancelled','expired'].includes(event.state)?event.state:'verification-required';
+    const state=event.state==='completed'&&event.result?.ok!==true?'verification-required':['completed','failed','cancelled','expired'].includes(event.state)?event.state:'verification-required';
     const selectedPending=state==='completed'&&event.journeyContext?.skillChoice==='selected';
-    return {phase:'runtime-ended',programState:state,state:selectedPending?'awaiting-skill':state,terminal:state!=='verification-required'&&!selectedPending,sessionId:event.sessionId,installationRoot:event.installationRoot,installationWrites:state==='completed'?'runtime-reported-installed':'unknown',runtimeHealth:event.result?.stableLauncherHealth||event.result?.lifecycleResult?.stableLauncherHealth||event.result?.executableHealth||'unknown',journeyContext:event.journeyContext,next:selectedPending?'程序已完成，正在准备所选 Codex 接入的独立确认':'只读核验稳定 installed launcher 或同次 session 结果，不重放确认'};
+    const rollback=event.failure?.details?.rollback||'unknown';
+    const failureNext=rollback==='completed'?'本次程序变更已回退；Skill 未安装。保留本次记录，在原对话查看健康检查错误，修复后再申请新计划；不要重放旧确认。':'回退情况待核实；Skill 未安装。保留本次记录，在原对话核实健康检查与恢复状态；不要自动重试。';
+    return {phase:'runtime-ended',programState:state,state:selectedPending?'awaiting-skill':state,terminal:state!=='verification-required'&&!selectedPending,sessionId:event.sessionId,installationRoot:event.installationRoot,installationWrites:state==='completed'?'runtime-reported-installed':rollback==='completed'?'rolled-back':'unknown',runtimeHealth:event.result?.stableLauncherHealth||event.result?.lifecycleResult?.stableLauncherHealth||event.result?.executableHealth||'unknown',failure:event.failure||null,rollback,journeyContext:event.journeyContext,next:selectedPending?'程序已完成，正在准备所选 Codex 接入的独立确认':state==='failed'?failureNext:'只读核验稳定 installed launcher 或同次 session 结果，不重放确认'};
   }
   if(['cancelled-no-install','expired-no-install','shutdown-no-install'].includes(event.state))return {phase:'directory-selection-ended',state:event.state,terminal:true,installationWrites:'none'};
   return null;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@josephyulei/summon-foundation",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@josephyulei/summon-foundation",
-      "version": "0.1.8",
+      "version": "0.1.9",
       "license": "MIT",
       "dependencies": {
         "@sigstore/bundle": "4.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyulei/summon-foundation",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Prepare a verified Foundation release for an explicitly confirmed Codex installation",
   "type": "module",
   "bin": {"summon": "bin/summon.mjs"},