@antprofuse/saddle-islands-tools 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antprofuse/saddle-islands-tools",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Independent Saddle–Islands engineering tools",
   "files": [
     "tools"

package/tools/docs/backend-testing.md

@@ -10,8 +10,12 @@ python3 <frozen-package>/tools/cli/main.py backend --project <suite-root> --repo
 npm run selftest --prefix <frozen-package>/tools/modules/backend
 ```
 
+运行器消费已构建的可执行制品，不负责选择或安装Rust工具链。发起者为构建阶段准备框架要求的工具链及可解析的cargo/rustc入口，核版本后交接执行环境；不能依赖其他workspace的隐含PATH。
+
 所有根、适配、协议、Service、启动 app/alias 与制品均为显式输入。适配和协议预检真实路径，拒绝未声明根、符号链接逃逸、缺配置或缺制品。项目源依据与 Islands 公开生成工具仍由项目声明；本包不复制 Islands 或 Saddle 运行时。
 
+`--out`须位于业务仓外且最终目录尚不存在。工具自动创建缺失父目录，但拒绝复用已有最终目录（即使为空），避免混入历史证据；目录准备失败时不启动业务进程。
+
 ## 适配合同
 
 适配模块导出 `project(projectRoot)`，返回 `scenarios`、`proto`、`rpc`、`process`、`frozen`、`inputFiles`、`database`、`databaseLogPolicy`、`prepare` 和 `execute`。

package/tools/modules/backend/output.test.mjs

@@ -0,0 +1,36 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {mkdtemp,mkdir,writeFile,readFile,rm,access} from 'node:fs/promises';
+import {tmpdir} from 'node:os';
+import {join} from 'node:path';
+import {createExternalOutput} from './index.mjs';
+test('fresh nested output is created; prior evidence and repository paths are rejected',async()=>{
+ const root=await mkdtemp(join(tmpdir(),'backend-output-'));
+ try {
+  const repo=join(root,'repo');await mkdir(repo);
+  const out=join(root,'missing','nested','run');assert.equal(await createExternalOutput(repo,out),out);
+  await assert.rejects(createExternalOutput(repo,out),{code:'EEXIST'});
+  await writeFile(join(out,'evidence.json'),'original');
+  await assert.rejects(createExternalOutput(repo,out),{code:'EEXIST'});
+  assert.equal(await readFile(join(out,'evidence.json'),'utf8'),'original');
+  const illegal=join(repo,'new','run');await assert.rejects(createExternalOutput(repo,illegal),/outside source repository/);
+  await assert.rejects(access(join(repo,'new')),{code:'ENOENT'});
+  const file=join(root,'file');await writeFile(file,'unchanged');
+  await assert.rejects(createExternalOutput(repo,join(file,'run')));
+  assert.equal(await readFile(file,'utf8'),'unchanged');
+ } finally {await rm(root,{recursive:true,force:true});}
+});
+
+test('runner rejects reused output before starting RPC or product',async()=>{
+ const {run}=await import('./run.mjs');
+ const root=await mkdtemp(join(tmpdir(),'backend-preflight-'));
+ try {
+  const repo=join(root,'repo');await mkdir(repo);
+  const proto=join(repo,'input.proto');await writeFile(proto,'intentionally invalid proto');
+  const adapter=join(repo,'adapter.mjs');
+  await writeFile(adapter,`export async function project(){return {rpc:{serviceName:'Synthetic'},proto:${JSON.stringify(proto)},process:{app:'synthetic',alias:'test'},inputFiles:[${JSON.stringify(proto)}],scenarios:[{id:'one'}],prepare(){},execute(){throw Error('business must not start')}}}`);
+  const out=join(root,'existing');await mkdir(out);
+  await assert.rejects(run({projectRoot:repo,repositoryRoot:repo,adapter,out,binary:process.execPath}),{code:'EEXIST'});
+  await assert.rejects(access(join(out,'report.json')),{code:'ENOENT'});
+ } finally {await rm(root,{recursive:true,force:true});}
+});

package/tools/modules/backend/run.mjs

@@ -8,7 +8,7 @@ import {within,preflight} from './paths.mjs';
 import {scenarioActions} from './actions.mjs';
 import {mock} from './grpc.mjs';
 import {product} from './product.mjs';
-import {externalOutput,sleep} from './util.mjs';
+import {createExternalOutput,sleep} from './util.mjs';
 import {requestLogs} from './logs.mjs';
 import {assertRouteRejection} from './rejection-logs.mjs';
 import {classifyReport} from './report.mjs';
@@ -25,8 +25,8 @@ export async function run({projectRoot,repositoryRoot,adapter,out,binary,caseId,
  const all=config.scenarios;assert(Array.isArray(all)&&all.length,'empty scenarios');assert.equal(new Set(all.map(s=>s.id)).size,all.length,'duplicate scene id');
  const selected=caseId?all.filter(s=>s.id===caseId):all;assert(selected.length,'unknown case');
  if(list){await new Promise(done=>process.stdout.write(JSON.stringify(all.map(({id,operation,basis,scope})=>({id,operation,basis,scope:scope??'business'})),null,2)+'\n',done));return;}
- assert(binary&&out,'real binary and fresh external output required');await access(resolve(binary),constants.X_OK);await access(config.proto);const destination=externalOutput(repositoryRoot,out);
- await mkdir(destination);const report={...config.frozen,tool:identity,projectInputs,scenarioSetSha256:createHash('sha256').update(JSON.stringify(all)).digest('hex'),started:new Date().toISOString(),scenarios:[],database:config.database};
+ assert(binary&&out,'real binary and fresh external output required');await access(resolve(binary),constants.X_OK);await access(config.proto);const destination=await createExternalOutput(repositoryRoot,out);
+ const report={...config.frozen,tool:identity,projectInputs,scenarioSetSha256:createHash('sha256').update(JSON.stringify(all)).digest('hex'),started:new Date().toISOString(),scenarios:[],database:config.database};
  let rpc,app,stage='startup';const abort=new AbortController();const listeners=new Map();
  for(const signal of ['SIGINT','SIGTERM']){const handler=()=>{report.interrupted=signal;abort.abort();rpc?.release();};listeners.set(signal,handler);process.once(signal,handler);}
  try{

package/tools/modules/backend/util.mjs

@@ -1,7 +1,7 @@
 import {spawn} from 'node:child_process';
 import {createServer} from 'node:net';
 import {mkdir,open} from 'node:fs/promises';
-import {resolve,relative} from 'node:path';
+import {resolve,relative,dirname} from 'node:path';
 import {setTimeout as sleep} from 'node:timers/promises';
 export {sleep};
 export async function port() {
@@ -22,3 +22,11 @@ export async function command(binary,args,dir,env={}) {
 }
 export async function until(fn,timeout=30000) { const end=Date.now()+timeout;let error;while(Date.now()<end){try{return await fn();}catch(e){error=e;await sleep(100);}}throw error ?? Error('readiness timeout'); }
 export function externalOutput(project,out) { const p=resolve(out);const rel=relative(resolve(project),p);if(rel!=='..'&&!rel.startsWith('../')) throw Error('output must be outside source repository');return p; }
+
+export async function createExternalOutput(repository,out) {
+  const destination=externalOutput(repository,out);
+  await mkdir(dirname(destination),{recursive:true});
+  // Keep the final creation exclusive: existing evidence must never be reused.
+  await mkdir(destination);
+  return destination;
+}