@llman-sdd/core 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llman-sdd/core",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Pure domain logic for llman-sdd (config, gherkin specs, validation, templates)",
   "license": "MIT",
   "repository": {

package/src/archive/freeze.ts

@@ -90,10 +90,12 @@ export async function runList(io: FreezeIo, sz: SevenZipPort, rootAbs: string):
   if (!io.exists(archiveAbs)) {
     return [`No freeze archive found at ./${ARCHIVE_DIR_REL}/${FREEZE_ARCHIVE_NAME}`];
   }
-  const entries = (await sz.listEntries(archiveAbs))
-    .map((n) => n.replace(/\/$/u, ''))
-    .filter((n) => DATED_RE.test(n) && n.split('/').length === 1);
-  const unique = [...new Set(entries)].toSorted();
+  // Real 7z lists file paths under their directory (`<dir>/proposal.md`);
+  // directory entries themselves are skipped by parseListNames. Derive the
+  // archived change names from the leading path segment.
+  const entries = (await sz.listEntries(archiveAbs)).map((n) => n.replace(/\/$/u, ''));
+  const top = (n: string): string => n.split('/')[0] ?? n;
+  const unique = [...new Set(entries.map(top).filter((n) => DATED_RE.test(n)))].toSorted();
   if (unique.length === 0) {
     return [
       `Freeze archive ${ARCHIVE_DIR_REL}/${FREEZE_ARCHIVE_NAME} contains no archived changes`,

package/src/archive/sevenzip.ts

@@ -1,3 +1,4 @@
+import { Buffer } from 'node:buffer';
 import { mkdirSync } from 'node:fs';
 import { basename, join } from 'node:path';
 
@@ -7,6 +8,13 @@ import { basename, join } from 'node:path';
  * instance per operation; extraction target must be a fresh directory
  * (WASM 7z refuses existing -o dirs). Spike-proven on Bun: compress / list /
  * extract keep directory structure.
+ *
+ * Compiled single-file binaries have no on-disk 7zz.wasm (Emscripten would
+ * probe $bunfs and abort), so build-binary.ts additionally injects the wasm
+ * base64 via the literal define `process.env.LLMAN_SDD_EMBEDDED_7ZZ_WASM_B64`
+ * (define only rewrites literal member access — do not route through a
+ * variable). Unset in source/npm/Node runs → glue loads the .wasm from disk
+ * as before.
  */
 import SevenZip from '7z-wasm';
 
@@ -35,14 +43,34 @@ type ModuleFactory = (opts: {
   noInitialRun: boolean;
   print?: (text: string) => void;
   printErr?: (text: string) => void;
+  wasmBinary?: Uint8Array;
 }) => Promise<EmscriptenModule>;
 
-async function initModule(print?: (text: string) => void): Promise<EmscriptenModule> {
+const WASM_MAGIC = [0x00, 0x61, 0x73, 0x6d] as const;
+
+/** Decode a base64 wasm blob; undefined when absent or not a WASM binary.
+ * Base64 decoding itself never throws, so the magic bytes are the guard. */
+export function resolveEmbeddedWasmB64(value: unknown): Uint8Array | undefined {
+  if (typeof value !== 'string' || value === '') return undefined;
+  const bytes = Buffer.from(value, 'base64');
+  if (bytes.length < 4 || WASM_MAGIC.some((b, i) => bytes[i] !== b)) return undefined;
+  return new Uint8Array(bytes);
+}
+
+/** Read the build-injected wasm; undefined when absent or malformed. */
+export function embeddedWasmBinary(): Uint8Array | undefined {
+  return resolveEmbeddedWasmB64(process.env.LLMAN_SDD_EMBEDDED_7ZZ_WASM_B64);
+}
+
+async function initModule(
+  print?: (text: string) => void,
+  wasmBinary?: Uint8Array,
+): Promise<EmscriptenModule> {
   const sink = (text: string): void => {
     if (print) print(text);
   };
   const factory = SevenZip as unknown as ModuleFactory;
-  return factory({ noInitialRun: true, print: sink, printErr: sink });
+  return factory({ noInitialRun: true, print: sink, printErr: sink, wasmBinary });
 }
 
 function mount(mod: EmscriptenModule, seq: number, hostDir: string): string {
@@ -78,9 +106,10 @@ function parseListNames(lines: string[]): string[] {
 }
 
 export async function makeWasmSevenZip(): Promise<SevenZipPort> {
+  const wasmBinary = embeddedWasmBinary();
   return {
     async add(archivePath: string, baseDir: string, entries: string[]): Promise<void> {
-      const mod = await initModule();
+      const mod = await initModule(undefined, wasmBinary);
       const archMount = mount(mod, 1, join(archivePath, '..'));
       const baseMount = mount(mod, 2, baseDir);
       mod.FS.chdir(baseMount);
@@ -90,7 +119,7 @@ export async function makeWasmSevenZip(): Promise<SevenZipPort> {
 
     async listEntries(archivePath: string): Promise<string[]> {
       const lines: string[] = [];
-      const mod = await initModule((text) => lines.push(text));
+      const mod = await initModule((text) => lines.push(text), wasmBinary);
       const archMount = mount(mod, 1, join(archivePath, '..'));
       const rc = mod.callMain(['l', `${archMount}/${basename(archivePath)}`]);
       if (rc !== 0) throw new SevenZipError(`7z list failed (rc=${rc})`);
@@ -98,7 +127,7 @@ export async function makeWasmSevenZip(): Promise<SevenZipPort> {
     },
 
     async extractAll(archivePath: string, destDir: string): Promise<void> {
-      const mod = await initModule();
+      const mod = await initModule(undefined, wasmBinary);
       const archMount = mount(mod, 1, join(archivePath, '..'));
       mkdirSync(destDir, { recursive: true });
       const destMount = mount(mod, 2, destDir);

package/src/index.ts

@@ -144,7 +144,13 @@ export {
   type SpecMorphology,
   type SpecSummary,
 } from './report/specs.ts';
-export { SevenZipError, makeWasmSevenZip, type SevenZipPort } from './archive/sevenzip.ts';
+export {
+  SevenZipError,
+  embeddedWasmBinary,
+  makeWasmSevenZip,
+  resolveEmbeddedWasmB64,
+  type SevenZipPort,
+} from './archive/sevenzip.ts';
 export {
   ARCHIVE_DIR_REL,
   FREEZE_ARCHIVE_NAME,

package/src/templates/embedded.ts

@@ -1,18 +1,19 @@
 /**
  * Embedded template table for single-file binaries.
  *
- * Bun <= 1.4.x has no working embedding mechanism (`assets` is a silent
- * no-op, `?raw`/`?asset` fail to resolve, `import.meta.glob` is unavailable
- * in compiled output), so templates are injected through the same build-time
- * `define` mechanism as LLMAN_SDD_VERSION: build-binary.ts collects
- * packages/core/templates into a root-relative path→content map and sets
- * process.env.LLMAN_SDD_EMBEDDED_TEMPLATES to that JSON. Bun inlines define
- * values as raw expressions — the JSON is a valid object literal, so in the
- * compiled binary the expression IS the table object itself, while a JSON
- * string reaches these callers through the same expression in other engines
- * or when force-set via env. Both forms are accepted below; every non-compiled
- * run (source, npm package, Node) leaves the define unset and falls back to
- * the real filesystem via TEMPLATES_ROOT.
+ * Bun 1.4.x offers no embedding that survives our Node >= 24 dual-runtime
+ * constraint: `with { type: "text" }` works in compiled output (probed on
+ * 1.4.2) but Node cannot load that attribute, and `assets`/`?raw`/`?asset`
+ * never land in the bundle — so templates are injected through the same
+ * build-time `define` mechanism as LLMAN_SDD_VERSION: build-binary.ts
+ * collects packages/core/templates into a root-relative path→content map and
+ * sets process.env.LLMAN_SDD_EMBEDDED_TEMPLATES to that JSON. Bun inlines
+ * define values as raw expressions — the JSON is a valid object literal, so
+ * in the compiled binary the expression IS the table object itself, while a
+ * JSON string reaches these callers through the same expression in other
+ * engines or when force-set via env. Both forms are accepted below; every
+ * non-compiled run (source, npm package, Node) leaves the define unset and
+ * falls back to the real filesystem via TEMPLATES_ROOT.
  */
 import type { TemplateIo } from './skills.ts';