@binary-balance/seshat 0.1.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gaelian Ditchburn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,8 @@
+# Seshat
+
+This package installs the Seshat command and selects the native payload for
+the current Node platform. The native payload packages are optional so npm can
+skip the four platforms that do not match the consumer.
+
+Seshat needs Node 24.20.0. Run `seshat check`, `seshat crap`, or `seshat mutate`
+with a project `seshat.json`. Add `--json` for the versioned report.

package/bin/seshat.mjs

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+import {spawn} from 'node:child_process';
+import {createRequire} from 'node:module';
+import {existsSync, readFileSync, statSync} from 'node:fs';
+import {basename, dirname, join} from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+const require = createRequire(import.meta.url);
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const packageManifest = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'));
+const version = packageManifest.version;
+const args = process.argv.slice(2);
+const jsonRequested = args.includes('--json');
+const commands = new Set(['check', 'crap', 'mutate']);
+const started = performance.now();
+
+const targets = {
+  'linux-x64': {name: '@binary-balance/seshat-linux-x64', executable: 'seshat'},
+  'linux-arm64': {name: '@binary-balance/seshat-linux-arm64', executable: 'seshat'},
+  'darwin-x64': {name: '@binary-balance/seshat-darwin-x64', executable: 'seshat'},
+  'darwin-arm64': {name: '@binary-balance/seshat-darwin-arm64', executable: 'seshat'},
+  'win32-x64': {name: '@binary-balance/seshat-win32-x64', executable: 'seshat.exe'},
+};
+
+function report(error) {
+  return {
+    schemaVersion: 1,
+    toolVersion: version,
+    command: commands.has(args[0]) ? args[0] : null,
+    complete: false,
+    cancelled: false,
+    signal: null,
+    scope: null,
+    timings: {wallMs: performance.now() - started, captureMs: null, executionMs: null},
+    quality: null,
+    result: {complete: false, error},
+  };
+}
+
+function fail(error) {
+  if (jsonRequested) {
+    process.stdout.write(`${JSON.stringify(report(error))}\n`);
+  } else {
+    process.stderr.write(`seshat: ${error}\n`);
+  }
+  process.exitCode = 2;
+}
+
+function targetForHost() {
+  const key = `${process.platform}-${process.arch}`;
+  const target = targets[key];
+  if (!target) return {error: `unsupported platform ${process.platform}/${process.arch}`};
+  if (process.platform === 'linux') {
+    let glibc;
+    try {
+      glibc = process.report?.getReport?.().header?.glibcVersionRuntime;
+    } catch {
+      glibc = undefined;
+    }
+    if (!glibc) return {error: `unsupported platform ${key}: glibc is required`};
+  }
+  return {target, key};
+}
+
+function payloadExecutable(target) {
+  let manifestPath;
+  try {
+    manifestPath = require.resolve(`${target.name}/package.json`);
+  } catch (error) {
+    if (error?.code === 'MODULE_NOT_FOUND') {
+      throw new Error(`${target.name}@${version} is missing or was omitted for this platform`);
+    }
+    throw error;
+  }
+  const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+  if (manifest.name !== target.name) {
+    throw new Error(`native payload name mismatch: expected ${target.name}, found ${manifest.name ?? 'unknown'}`);
+  }
+  if (manifest.version !== version) {
+    throw new Error(`native payload version mismatch: expected ${version}, found ${manifest.version ?? 'unknown'}`);
+  }
+  const executable = join(dirname(manifestPath), 'bin', target.executable);
+  if (!existsSync(executable) || !statSync(executable).isFile()) {
+    throw new Error(`${target.name}@${version} has no ${basename(executable)} executable`);
+  }
+  return executable;
+}
+
+function signalNumber(signal) {
+  return {SIGINT: 2, SIGTERM: 15}[signal] ?? 1;
+}
+
+const host = targetForHost();
+if (host.error) {
+  fail(host.error);
+} else {
+  let executable;
+  try {
+    executable = payloadExecutable(host.target);
+  } catch (error) {
+    fail(error instanceof Error ? error.message : String(error));
+  }
+  if (executable) {
+    const child = spawn(executable, args, {
+      cwd: process.cwd(),
+      env: {...process.env},
+      shell: false,
+      windowsHide: false,
+      stdio: 'inherit',
+    });
+    let spawnFailed = false;
+    const forward = signal => {
+      if (child.exitCode === null) child.kill(signal);
+    };
+    // A CTRL_BREAK_EVENT is broadcast to the console process group. Keep the
+    // launcher alive on Windows so the native child can handle that event and
+    // return its cancellation report through inherited stdio.
+    const preserveConsole = () => {};
+    process.on('SIGINT', forward);
+    process.on('SIGTERM', forward);
+    if (process.platform === 'win32') process.on('SIGBREAK', preserveConsole);
+    const cleanup = () => {
+      process.removeListener('SIGINT', forward);
+      process.removeListener('SIGTERM', forward);
+      if (process.platform === 'win32') process.removeListener('SIGBREAK', preserveConsole);
+    };
+    child.once('error', error => {
+      spawnFailed = true;
+      cleanup();
+      fail(`cannot start native payload: ${error.message}`);
+    });
+    child.once('close', (code, signal) => {
+      cleanup();
+      if (!spawnFailed) process.exitCode = signal ? 128 + signalNumber(signal) : code ?? 1;
+    });
+  }
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@binary-balance/seshat",
+  "version": "0.1.0-rc.1",
+  "description": "Native TypeScript code assurance",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": "24.20.0"
+  },
+  "bin": {
+    "seshat": "bin/seshat.mjs"
+  },
+  "files": [
+    "bin/seshat.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@binary-balance/seshat-linux-x64": "0.1.0-rc.1",
+    "@binary-balance/seshat-linux-arm64": "0.1.0-rc.1",
+    "@binary-balance/seshat-darwin-x64": "0.1.0-rc.1",
+    "@binary-balance/seshat-darwin-arm64": "0.1.0-rc.1",
+    "@binary-balance/seshat-win32-x64": "0.1.0-rc.1"
+  }
+}