cli-jaw 2.17.39 → 2.17.40

package/README.md

@@ -850,7 +850,9 @@ entrypoint or cron. Full guide: [structure/remote-headless.md](structure/remote-
 npm run build          # tsc → dist/
 npm run build:frontend # vite → public/dist/
 npm run dev            # tsx server.ts (hot-reload)
-npm test               # programmatic node:test driver (tests/run.mts, isolation:'process')
+npm test               # programmatic node:test driver (tests/run.mts, isolation:'process', per-file test home)
+npm run test:shard -- 1/4        # deterministic quarter of root+unit (same split CI's test i/4 runs)
+npm run test:integration:all     # tests/integration + manager + bin (CI's integration job; needs a TEST_PORT server)
 npm run gate:all       # named release/docs parity gates (incl. doc-drift, strict-baseline, redaction-sinks)
 npm run docs:check     # AST commands/routes inventory vs structure docs
 bash structure/check-doc-drift.sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cli-jaw",
-  "version": "2.17.39",
+  "version": "2.17.40",
   "description": "Personal AI assistant powered by Pi, Antigravity, AI-E, Claude, Claude E, Codex, Codex App, Cursor, Grok, Kiro, OpenCode, and Copilot — Web, Terminal, Slack, Telegram, and Discord interfaces with 33 skills active by default from a 230-skill reference library",
   "type": "module",
   "keywords": [
@@ -79,6 +79,8 @@
     "pretest:smoke": "npm run ensure:native",
     "test": "tsx --experimental-test-module-mocks tests/run.mts",
     "test:all": "tsx --experimental-test-module-mocks tests/run.mts --all",
+    "test:shard": "tsx --experimental-test-module-mocks tests/run.mts --scope root,unit --shard",
+    "test:integration:all": "tsx --experimental-test-module-mocks tests/run.mts --scope integration,manager,bin",
     "test:integration": "tsx --experimental-test-module-mocks --test tests/integration/*.test.ts",
     "test:coverage": "tsx --experimental-test-module-mocks --experimental-test-coverage tests/run.mts --all",
     "test:watch": "tsx --experimental-test-module-mocks tests/run.mts --watch",

package/scripts/ci/aggregate-check.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# The ci-aggregate decision for .github/workflows/test.yml, kept in a script so
+# tests/unit/ci-aggregate-rules.test.ts can drive its truth table. Inputs are the
+# producer job results and the change classifier's output, all through env.
+#
+#   changes must be success and CODE_CHANGED exactly true|false
+#   code=true : every producer must be success (a skip is a dropped job, not a pass)
+#   code=false: every producer may be success or skipped (docs-only change)
+#   failure, cancelled, empty, or anything unrecognised always fails
+set -uo pipefail
+
+failed=0
+require_code=""
+
+case "${CHANGES_RESULT:-}" in
+  success) echo "PASS  changes: success" ;;
+  *)       echo "FAIL  changes: ${CHANGES_RESULT:-<empty>}"; failed=1 ;;
+esac
+
+case "${CODE_CHANGED:-}" in
+  true|false) require_code="${CODE_CHANGED}"; echo "INFO  changes.outputs.code=${CODE_CHANGED}" ;;
+  *)          echo "FAIL  changes.outputs.code was '${CODE_CHANGED:-}', expected true or false"; failed=1 ;;
+esac
+
+check() {
+  local job="$1" result="$2"
+  case "$result" in
+    success)
+      echo "PASS  $job: success" ;;
+    skipped)
+      if [ "$require_code" = "false" ]; then
+        echo "PASS  $job: skipped (docs-only change)"
+      else
+        echo "FAIL  $job: skipped although change detection reported code changes"; failed=1
+      fi ;;
+    failure)   echo "FAIL  $job: failure"; failed=1 ;;
+    cancelled) echo "FAIL  $job: cancelled"; failed=1 ;;
+    '')        echo "FAIL  $job: no result reported"; failed=1 ;;
+    *)         echo "FAIL  $job: unexpected result '$result'"; failed=1 ;;
+  esac
+}
+
+check test         "${TEST_RESULT:-}"
+check integration  "${INTEGRATION_RESULT:-}"
+check gates        "${GATES_RESULT:-}"
+check windows-unit "${WINDOWS_UNIT_RESULT:-}"
+
+if [ "$failed" -ne 0 ]; then
+  echo "::error::ci-aggregate failed — see the per-job results above"
+  exit 1
+fi
+echo "ci-aggregate: all required jobs succeeded or were legitimately skipped"
+

package/scripts/ci/windows-unit-manifest.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+// Validates scripts/ci/windows-unit-manifest.txt — the list of unit test files
+// the windows-unit job runs on windows-latest. One repo-relative POSIX path per
+// line; blank lines and full-line '#' comments are ignored; no globs, duplicates,
+// traversal, or paths outside tests/unit/. Consumed by the Windows job (--print)
+// and by tests/unit/windows-unit-manifest.test.ts, so a renamed test breaks on
+// Linux before it silently vanishes from the Windows lane.
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import process from 'node:process';
+
+export const MANIFEST_PATH = 'scripts/ci/windows-unit-manifest.txt';
+const ENTRY = /^tests\/unit\/[A-Za-z0-9_-]+\.test\.ts$/;
+
+/** @returns {string[]} validated entries in manifest order; throws with the reason */
+export function readManifest(manifestPath, { root } = {}) {
+    const repoRoot = root ?? resolve(fileURLToPath(import.meta.url), '..', '..', '..');
+    const abs = resolve(repoRoot, manifestPath);
+    if (!existsSync(abs)) throw new Error(`manifest missing: ${manifestPath}`);
+    const lines = readFileSync(abs, 'utf8').split(/\r?\n/);
+    const entries = [];
+    const seen = new Set();
+    lines.forEach((raw, i) => {
+        const line = raw.trim();
+        if (!line || line.startsWith('#')) return;
+        const where = `${manifestPath}:${i + 1}`;
+        if (!ENTRY.test(line)) throw new Error(`${where}: invalid entry '${line}' (expected tests/unit/<name>.test.ts)`);
+        if (seen.has(line)) throw new Error(`${where}: duplicate entry '${line}'`);
+        const file = join(repoRoot, line);
+        if (!existsSync(file) || !statSync(file).isFile()) throw new Error(`${where}: missing file '${line}'`);
+        seen.add(line);
+        entries.push(line);
+    });
+    if (entries.length === 0) throw new Error(`${manifestPath}: empty manifest`);
+    return entries;
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    const args = process.argv.slice(2);
+    const print = args.includes('--print');
+    const target = args.find(a => !a.startsWith('--')) ?? MANIFEST_PATH;
+    try {
+        const entries = readManifest(target);
+        if (print) process.stdout.write(entries.join('\n') + '\n');
+        else console.log(`windows-unit manifest ok: ${entries.length} files`);
+    } catch (error) {
+        console.error(`[windows-unit-manifest] ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+}
+

package/scripts/ci/windows-unit-manifest.txt

@@ -0,0 +1,19 @@
+# Unit test files the windows-unit job runs on windows-latest (.github/workflows/test.yml).
+# One repo-relative path per line, tests/unit/<name>.test.ts only; no globs.
+# Validated by scripts/ci/windows-unit-manifest.mjs and tests/unit/windows-unit-manifest.test.ts.
+tests/unit/windows-service-esm.test.ts
+tests/unit/service-windows-branch.test.ts
+tests/unit/windows-service-lifecycle-honesty.test.ts
+tests/unit/windows-installer-shims.test.ts
+tests/unit/windows-spawn-primitives.test.ts
+tests/unit/manager-browser-open.test.ts
+tests/unit/eaddrinuse-diagnostics-contract.test.ts
+tests/unit/tui-env-flags.test.ts
+tests/unit/windows-launch-spec.test.ts
+tests/unit/service-lifecycle-cli.test.ts
+tests/unit/claude-sdk-windows-launch.test.ts
+tests/unit/claude-sdk-session.test.ts
+tests/unit/claude-sdk-control.test.ts
+tests/unit/claude-sdk-core-hardening.test.ts
+tests/unit/claude-sdk-deferred-core.test.ts
+