stillmade-sdk 0.1.23 → 0.1.24

package/package.json

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

package/packages/block-cli/cli.js

@@ -12,6 +12,10 @@ import {packageFromPortableFiles,withOriginalSource} from '../block-sdk/portable
 import {readPortableArchive,writePortableArchive} from '../block-sdk/portable-archive.js';
 const require=createRequire(import.meta.url);
 function archiveCodec(){try{return require('fflate');}catch{return createRequire(new URL('../../client/package.json',import.meta.url))('fflate');}}
+// The importer opens .stillmade-block and .zip files as ZIP archives, so a JSON package never takes
+// those names (October 20, 2026: a Block packed to key-moment-finder.stillmade-block failed
+// import with "Expected a complete single ZIP archive").
+const jsonOutput=(extra,fallback)=>{const output=resolve(extra||fallback),archive=/\.(stillmade-block|zip)$/i.exec(output);if(archive)throw new Error(`Only a complete portable package can use the ${archive[0]} extension. Leave the output name out to write ${fallback}, then import that file in StillMade.`);return output;};
 import {realpathSync} from 'node:fs';
 import {numberedTakes} from '../block-sdk/state-example.js';
 import {initialBlockState,validateBlockState} from '../block-sdk/state.js';
@@ -274,14 +278,14 @@ export async function main(rawArgs) {
         const scan=scanPackage(dependency);
         if(!scan.passed)throw Object.assign(new Error(`${dependency.manifest.name}: Static validation failed`),{report:scan});
       }
-      const output=resolve(extra || `${pkg.id}-${pkg.version}.stillmade.json`);
+      const output=jsonOutput(extra,`${pkg.id}-${pkg.version}.stillmade.json`);
       await writeFile(output,JSON.stringify(pkg,null,2),{flag:'wx'});
       return {file:output,digest:await digest(pkg),tests:0,...review,message:'Project Type source packaged without execution. In StillMade, review every embedded hosted Block in StillMade (including ComfyUI backend fixtures and samples), then confirm the import after local admission checks. The connected workflow has not run.'};
     }
     const report = await testProjectType(pkg);
     if (!report.passed) throw Object.assign(new Error('Project Type validation or execution checks need attention'), { report:{...report,...(hosted ? {reviewRequired:true,liveVerified:false} : {})} });
     if (command === 'test') return report;
-    const output = resolve(extra || `${pkg.id}-${pkg.version}.stillmade.json`);
+    const output = jsonOutput(extra,`${pkg.id}-${pkg.version}.stillmade.json`);
     await writeFile(output, JSON.stringify(pkg, null, 2), { flag: 'wx' });
     return { file: output, digest: report.digest, tests: (pkg.packages || []).reduce((count,dependency)=>count+dependency.tests.length,0), workflowComplete:report.workflowComplete, workflowStatus:report.workflowStatus };
   }
@@ -332,14 +336,14 @@ export async function main(rawArgs) {
   if(requiresDesktopExecution(pkg)&&['test','pack'].includes(command)){
     const report=await admitLocalPackage(pkg);if(!report.passed)throw Object.assign(new Error('Desktop source admission failed'),{report});
     if(command==='test')return report;
-    const output=resolve(extra || `${pkg.manifest.id}-${pkg.manifest.version}.stillmade.json`);
+    const output=jsonOutput(extra,`${pkg.manifest.id}-${pkg.manifest.version}.stillmade.json`);
     await writeFile(output,JSON.stringify(pkg,null,2),{flag:'wx'});
     return {file:output,digest:report.digest,tests:0,fixtureContracts:pkg.tests.length,execution:'not-run',liveVerified:false,reviewRequired:true,admission:report,message:'Source packaged without native execution. Run and review the declared action through its approved StillMade Desktop adapter.'};
   }
   if(command === 'pack' && ['comfyui','capability'].includes(pkg.manifest.runtime)) {
     const scan=scanPackage(pkg);
     if(!scan.passed)throw Object.assign(new Error('Static validation failed'),{report:scan});
-    const output=resolve(extra || `${pkg.manifest.id}-${pkg.manifest.version}.stillmade.json`);
+    const output=jsonOutput(extra,`${pkg.manifest.id}-${pkg.manifest.version}.stillmade.json`);
     await writeFile(output,JSON.stringify(pkg,null,2),{flag:'wx'});
     return {file:output,digest:await digest(pkg),tests:0,reviewRequired:true,...(pkg.manifest.runtime==='capability'?{liveVerified:false}:{}),message:pkg.manifest.runtime==='capability'?'Source packaged without provider execution. Import into StillMade, choose a model and payment method, and approve the fixtures and sample before confirming installation.':'Source packaged. Import into StillMade to run all fixtures and preview on your connected ComfyUI backend before confirming installation.'};
   }
@@ -359,7 +363,7 @@ export async function main(rawArgs) {
     await writeFile(output,JSON.stringify(createModuleBundle(pkg,files)),{flag:'wx'});
     return {file:output,digest:report.digest,tests:report.results.length,files:Object.keys(pkg.module?.files||{}).length+Object.keys(pkg.view?.files?.files||{}).length,...standInNote(mock),message:'Import this bundle in StillMade (Create, then Import). StillMade checks every file digest and uploads the files once before saving the Block.'};
   }
-  const output = resolve(extra || `${pkg.manifest.id}-${pkg.manifest.version}.stillmade.json`);
+  const output = jsonOutput(extra,`${pkg.manifest.id}-${pkg.manifest.version}.stillmade.json`);
   await writeFile(output, JSON.stringify(pkg, null, 2), { flag: 'wx' });
   return { file: output, digest: report.digest, tests: report.results.length };
 }