stillmade-sdk 0.1.28 → 0.1.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stillmade-sdk",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "StillMade Block SDK, CLI and examples",
   "license": "PolyForm-Shield-1.0.0",
   "type": "module",

package/packages/block-cli/cli.js

@@ -193,8 +193,11 @@ export async function readPackage(path) {
   if(localModule||viewFiles)moduleFiles.set(pkg,{...(localModule?.files||{}),...(viewFiles||{})});
   return pkg;
 }
+export const MODULE_EXECUTION_REQUIRED_MESSAGE='This Block runs code, so the gate a hook starts does not run it. Run `stillmade-block gate .` (`npx stillmade-block gate .` in an npm project) yourself and report the status it prints.';
 export async function main(rawArgs) {
-  const mockRequested=rawArgs.includes('--mock'),args=rawArgs.filter(value=>value!=='--mock');
+  // --no-module-execution: what the gate a hook starts passes to ready, so a module Block is refused
+  // before anything of it runs; the decision is made on the same parsed package ready would run.
+  const mockRequested=rawArgs.includes('--mock'),noModuleExecution=rawArgs.includes('--no-module-execution'),args=rawArgs.filter(value=>value!=='--mock'&&value!=='--no-module-execution');
   if(!args.length||['help','--help','-h'].includes(args[0])||args.includes('--help')||args.includes('-h'))return {help:HELP};
   if(args[0]==='templates'||args[0]==='create'&&args.includes('--list'))return {templates:Object.entries(TEMPLATES).map(([name,template])=>({name,runtime:template.runtime,description:template.description}))};
   const [command, target = '.', extra] = args, path = resolve(target);
@@ -251,7 +254,9 @@ export async function main(rawArgs) {
     // On the creator's own machine a module Block runs in the SDK's Node executor with the
     // stand-in host that answers from tests/mocks.json, as test and preview do (October 20,
     // 2026: ready refused every module Block at DOD-01, so none could pass the gate from the SDK).
-    const mock=pkg.manifest?.runtime==='module'?await standIns(path,pkg,true):null;
+    const module=pkg.manifest?.runtime==='module';
+    if(module&&noModuleExecution)throw Object.assign(new Error(MODULE_EXECUTION_REQUIRED_MESSAGE),{code:'MODULE_EXECUTION_REQUIRED'});
+    const mock=module?await standIns(path,pkg,true):null;
     const readiness=await assessBlockReadiness(pkg,{moduleExecution:true,files:moduleFiles.get(pkg),...(mock?{host:mock.host}:{})});
     if(['FAILED','BLOCKED BY PLATFORM CAPABILITY'].includes(readiness.status))throw Object.assign(new Error(`Block readiness: ${readiness.status}`),{report:readiness});
     return readiness;

package/packages/block-cli/ready-gate.js

@@ -88,10 +88,11 @@ const summarize=readiness=>(readiness?.items||[]).filter(item=>['failed','blocke
 export const RUN_READY_YOURSELF='RUN READY YOURSELF';
 async function judge(path,main,{executeModules=true}={}){
  try{
+  // ready decides on the package it would run: with --no-module-execution it refuses a module
+  // Block before anything of it runs (MODULE_EXECUTION_REQUIRED), so the gate never falls open.
+  const readiness=await main(['ready',path,...(executeModules?[]:['--no-module-execution'])]);
   // Every new or edited Block carries its feature map (builder-contract); search, matching and its listing read it.
   const manifest=(await main(['inspect',path]).catch(()=>null))?.manifest;
-  if(!executeModules&&manifest?.runtime==='module')return {ok:false,status:RUN_READY_YOURSELF,failures:['This Block runs code, so the gate a hook starts does not run it. Run `stillmade-block gate .` (`npx stillmade-block gate .` in an npm project) yourself and report the status it prints.'],limitations:0};
-  const readiness=await main(['ready',path]);
   // The starting map create writes (one entry copied from the description) does not count until it is rewritten.
   const placeholder=features=>features.length===1&&features[0].id==='main'&&features[0].asks?.length===1&&features[0].asks[0]===features[0].does;
   if(PASSING.has(readiness.status)&&manifest&&!(Array.isArray(manifest.features)&&manifest.features.length&&!placeholder(manifest.features)))
@@ -102,6 +103,7 @@ async function judge(path,main,{executeModules=true}={}){
    try{await main(['test',path]);return {ok:true,status:'PROJECT TYPE TESTS PASSED',failures:[]};}
    catch(typeError){return {ok:false,status:'FAILED',failures:[String(typeError.message).slice(0,300)]};}
   }
+  if(error.code==='MODULE_EXECUTION_REQUIRED')return {ok:false,status:RUN_READY_YOURSELF,failures:[String(error.message).slice(0,400)],limitations:0};
   if(error.code==='APPLICATION_REVIEW_REQUIRED')return {ok:false,status:'NEEDS STILLMADE REVIEW',failures:[String(error.message).slice(0,400)]};
   if(error.report?.status)return {ok:false,status:error.report.status,failures:summarize(error.report)};
   return {ok:false,status:'FAILED',failures:[String(error.message).slice(0,300)]};