@dzhechkov/harness-cli 0.4.6 → 0.5.0

package/dist/bin.js

@@ -1,17 +1,50 @@
 #!/usr/bin/env node
 /**
  * `dz` executable entry point.
+ *
+ * Two phases, and the split is load-bearing (feature dz-cli-defects, D5):
+ *
+ *   phase 1 — ZERO `@dzhechkov/harness-core` imports: probe the installed core version
+ *             and refuse with a NAMED message if it is below `MIN_CORE`;
+ *   phase 2 — `await import('./cli.js')`, which is where the ~100-name static graph is
+ *             linked. A STATIC import here would link that graph before any guard could
+ *             run, which is exactly how a cached lower core produced a bare
+ *             `SyntaxError: … does not provide an export named 'GRADE_SUCCESS_FLOOR'`
+ *             with nothing pointing at the cause.
  */
-import { runCli } from './cli.js';
-const code = await runCli(process.argv.slice(2));
-// `process.exit()` here TRUNCATED large output on a pipe, silently and at exactly the
-// pipe buffer size. On a pipe (not a TTY, not a file) Node's stdout is ASYNCHRONOUS, so
-// `process.exit` discards whatever has not flushed yet: `dz recall --all --json > file`
-// wrote 122826 bytes while `dz recall --all --json | jq` got exactly 65536 and a parse
-// error. That is data loss in the documented sharing path, and silent — the exit code
-// was 0 and the JSON simply stopped mid-string.
-//
-// So: set the code and let the process end when the event loop drains, which is what
-// flushes stdout. `process.exitCode` preserves the status without the race.
-process.exitCode = code;
+import { checkCoreCompat, describeMissingExportError, resolveInstalledCoreVersion, MIN_CORE } from './core-compat.js';
+const foundCore = resolveInstalledCoreVersion(import.meta.url);
+const compat = checkCoreCompat({ found: foundCore, min: MIN_CORE });
+if (!compat.ok) {
+    // stderr, and no stack: the user needs one actionable line, not a trace.
+    console.error(compat.message);
+    process.exitCode = 1;
+}
+else {
+    let code;
+    try {
+        const { runCli } = await import('./cli.js');
+        code = await runCli(process.argv.slice(2));
+    }
+    catch (error) {
+        // The version probe fails OPEN, so a missing-binding link error can still reach us.
+        // Translate exactly that class into the named form; re-throw everything else
+        // unchanged so real bugs still surface.
+        const named = describeMissingExportError(error, foundCore);
+        if (named === null)
+            throw error;
+        console.error(named);
+        code = 1;
+    }
+    // `process.exit()` here TRUNCATED large output on a pipe, silently and at exactly the
+    // pipe buffer size. On a pipe (not a TTY, not a file) Node's stdout is ASYNCHRONOUS, so
+    // `process.exit` discards whatever has not flushed yet: `dz recall --all --json > file`
+    // wrote 122826 bytes while `dz recall --all --json | jq` got exactly 65536 and a parse
+    // error. That is data loss in the documented sharing path, and silent — the exit code
+    // was 0 and the JSON simply stopped mid-string.
+    //
+    // So: set the code and let the process end when the event loop drains, which is what
+    // flushes stdout. `process.exitCode` preserves the status without the race.
+    process.exitCode = code;
+}
 //# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjD,sFAAsF;AACtF,wFAAwF;AACxF,wFAAwF;AACxF,uFAAuF;AACvF,sFAAsF;AACtF,gDAAgD;AAChD,EAAE;AACF,qFAAqF;AACrF,4EAA4E;AAC5E,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEtH,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;AAEpE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;KAAM,CAAC;IACN,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oFAAoF;QACpF,6EAA6E;QAC7E,wCAAwC;QACxC,MAAM,KAAK,GAAG,0BAA0B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,KAAK,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,GAAG,CAAC,CAAC;IACX,CAAC;IAED,sFAAsF;IACtF,wFAAwF;IACxF,wFAAwF;IACxF,uFAAuF;IACvF,sFAAsF;IACtF,gDAAgD;IAChD,EAAE;IACF,qFAAqF;IACrF,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC"}

package/dist/cli.d.ts

@@ -7,6 +7,18 @@
 export interface CliIo {
     readonly cwd?: string;
     readonly write?: (line: string) => void;
+    /**
+     * Diagnostics sink — **stderr**, defaulting to `console.error`.
+     *
+     * Before feature dz-cli-defects `CliIo` had no stderr seam at all, so every
+     * diagnostic (including the top-level error handler) landed on stdout and
+     * `dz list > skills.txt` wrote the error INTO the data file. `write` stays "data
+     * only"; `writeErr` is "diagnosis only".
+     *
+     * There is deliberately **no** fall-back to `write`: a test that wants to assert on
+     * stderr must inject `writeErr`, or the assertion would be theatre.
+     */
+    readonly writeErr?: (line: string) => void;
     /**
      * Pre-read STDIN content (injectable so `dz brain ground`'s hook path is testable without
      * an actual pipe). When omitted, the CLI reads fd 0 synchronously — but only for the one

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAucH,2EAA2E;AAC3E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KACvD;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA4oR9E,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwL5E"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsdH,2EAA2E;AAC3E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KACvD;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAilS9E,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgM5E"}