@clunkyard/cli 2.0.0 → 2.0.1

package/README.md

@@ -25,6 +25,10 @@ all-language builder. SDK/engine caches under ignored `.clunkyard/` are keyed
 by their content hashes and remain reusable across CLI updates. Other
 commands are `list`, `setup`, `clean` and `migrate`.
 
+Local matches use a resource mode supported by `bot.json`. Open-capable robots
+use Open; Wasm- or DSL-only robots keep their fuel or operation meter and play
+the bundled Vane rival with its DSL meter.
+
 JavaScript/TypeScript projects use the ordinary npm alias
 `clunkyard@npm:@clunkyard/sdk@2.0.0`. `package-lock.json` pins the reviewed
 integrity. The first build runs `npm ci --ignore-scripts`; the package has no
@@ -34,8 +38,8 @@ assets currently require Linux x86-64/glibc 2.39+ (Ubuntu 24.04+ or WSL2).
 JavaScript, TypeScript and the Vane/Cadence/Glyph Node routes use WebAssembly.
 
 `@2` receives compatible tooling updates. For an exact tool version, run
-`npx --yes @clunkyard/cli@2.0.0` or set
-`CLUNKYARD='npx --yes @clunkyard/cli@2.0.0'` with Make. Commit the npm lockfile
+`npx --yes @clunkyard/cli@2.0.1` or set
+`CLUNKYARD='npx --yes @clunkyard/cli@2.0.1'` with Make. Commit the npm lockfile
 for reproducible JavaScript/TypeScript dependencies. Match replays record the
 game rules and robot actions; local timings do not qualify hosted budgets.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clunkyard/cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Shared local builds, matches and replays for Clunkyard robots",
   "license": "MIT",
   "engines": {

package/project.cjs

@@ -72,7 +72,7 @@ npx --yes @clunkyard/cli@2 match 77 3d zero-g
 
 Keep a baseline commit. Repeat several seeds and rulesets; compare contacts, battery, aim, shots, hits and eliminations in the replay. Local trials run programs as your user. Use hosted trials to measure arena budgets before a tournament.
 
-The CLI packages SDK ${catalogue.sdkVersion}/protocol 2 asset identities from the immutable [${catalogue.release} release](https://github.com/clunkyard/game-kit/releases/tag/${catalogue.release}). \`@2\` receives compatible tooling fixes without copying scripts into your robot repository. To reproduce an exact tool version, use \`npx --yes @clunkyard/cli@2.0.0\` or set \`CLUNKYARD='npx --yes @clunkyard/cli@2.0.0'\` with Make. SDK/engine caches are identified by their content hashes and remain reusable across CLI updates.
+The CLI packages SDK ${catalogue.sdkVersion}/protocol 2 asset identities from the immutable [${catalogue.release} release](https://github.com/clunkyard/game-kit/releases/tag/${catalogue.release}). \`@2\` receives compatible tooling fixes without copying scripts into your robot repository. To reproduce an exact tool version, use \`npx --yes @clunkyard/cli@2.0.1\` or set \`CLUNKYARD='npx --yes @clunkyard/cli@2.0.1'\` with Make. SDK/engine caches are identified by their content hashes and remain reusable across CLI updates.
 
 ## Play online
 

package/runtime.cjs

@@ -6,6 +6,13 @@ const {extract,readAsset}=require('./archive.cjs');
 const catalogue=require('./catalogue.json');
 const {readManifest}=require('./project.cjs');
 
+function selectLocalResourceMode(bot,supported) {
+  if(supported.includes('open'))return 'open';
+  const metered=supported.find(mode=>mode==='dsl'||mode==='wasm');
+  if(metered)return metered;
+  throw new Error(`${bot.name} supports resource modes [${supported.join(', ')}]. Local trials need open, dsl or wasm; use a hosted trial for trusted budgets.`);
+}
+
 function createRuntime(project,entry=path.join(__dirname,'cli.cjs')) {
 const root=path.resolve(project),initial=readManifest(root),lock=catalogue.languages[initial.language];
 const cache=path.join(root,'.clunkyard');
@@ -136,7 +143,24 @@ async function match(args) {
   await build();
   fs.mkdirSync(path.join(root,'replays'),{recursive:true});
   const replay=path.join(root,'replays',`trial-${seed}.json`);
-  run(process.execPath,[path.join(engine,'src','cli.js'),'match','--bot','@'+path.join(cache,'local-bot.json'),'--bot','@'+path.join(engine,'bots','practice','bot.json'),'--mode',mode,'--ruleset',ruleset,'--seed',seed,'--ticks','360','--turn-ms','2000','--startup-ms','60000','--replay',replay]);
+  const {supportedResourceModes}=require(path.join(engine,'src','resources.js'));
+  const m=manifest(),resourceMode=selectLocalResourceMode(m,supportedResourceModes(m));
+  if(resourceMode==='open'){
+    run(process.execPath,[path.join(engine,'src','cli.js'),'match','--bot','@'+path.join(cache,'local-bot.json'),'--bot','@'+path.join(engine,'bots','practice','bot.json'),'--mode',mode,'--ruleset',ruleset,'--resource-mode',resourceMode,'--seed',seed,'--ticks','360','--turn-ms','2000','--startup-ms','60000','--replay',replay]);
+  }else{
+    // The pinned engine already supports mixed Reflex entries: the player's
+    // Wasm/DSL robot and the bundled Vane rival each keep their own meter.
+    const {resolveBot,validateSelection}=require(path.join(engine,'src','roster.js'));
+    const {runMatch,saveReplay}=require(path.join(engine,'src','match.js'));
+    const player=resolveBot('@'+path.join(cache,'local-bot.json'),[],engine,mode,ruleset);
+    const rival=resolveBot('@'+path.join(engine,'bots','practice','bot.json'),[],engine,mode,ruleset);
+    player.resourcePolicy={mode:resourceMode};rival.resourcePolicy={mode:'dsl'};
+    const bots=[player,rival];validateSelection(bots,mode,ruleset);
+    const result=await runMatch(bots,{mode,ruleset,seed:Number(seed),maxTicks:360,turnMs:2000,startupMs:60000,resourcePolicy:{v:3,class:'reflex',policy:'fair-compute-v1'}});
+    saveReplay(result.replay,replay);
+    console.log(`Result: ${result.result?.winners?.join(', ')||'draw'} (${result.result?.reason||'unknown'})`);
+    console.log(`Replay: ${replay}`);
+  }
   const failures=JSON.parse(fs.readFileSync(replay,'utf8')).failures||[];
   if(failures.length)throw new Error(`Match recorded ${failures.map(value=>`${value.botId}: ${value.code}`).join(', ')}. Inspect ${replay}.`);
 }
@@ -198,4 +222,4 @@ async function main(action='build',args=[]){
 return {main};
 }
 
-module.exports={createRuntime};
+module.exports={createRuntime,selectLocalResourceMode};