@sprawling/mei 0.0.0-stage → 0.0.17-pre.261115

package/bin/mei.cmd

@@ -0,0 +1,20 @@
+:; runtime=$(command -v bun); if test -z "$runtime"; then runtime=$(command -v node); fi; if test -z "$runtime"; then echo "mei: install Bun or Node.js to run this package"; exit 1; fi ; if test $# -eq 0; then echo "mei: package entry file missing; reinstall this package"; exit 1; fi; exec "$runtime" "$@" # Ignore the batch line ending after the shell dispatch.
+: <<'WINDOWS'
+@echo off
+if "%~1"=="" goto noentry
+where bun >nul 2>nul
+if errorlevel 1 goto node
+bun %*
+exit /b %errorlevel%
+:node
+where node >nul 2>nul
+if errorlevel 1 goto missing
+node %*
+exit /b %errorlevel%
+:missing
+echo mei: install Bun or Node.js to run this package 1>&2
+exit /b 1
+:noentry
+echo mei: package entry file missing; reinstall this package 1>&2
+exit /b 1
+WINDOWS

package/bin/mei.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env mei-runtime
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+// Copyright (c) 2026 2youg1 and the sprawling contributors
+//
+// The npm channel's entry point: find the binary for this machine and
+// become it.
+//
+// **This script never installs anything.** Where a downloaded archive
+// puts the binary, and what happens to PATH, belongs to `sprawling
+// install`; where an npm package puts it belongs to npm or bun. Two
+// installers choosing a directory would be two authorities for one
+// rule, so this one resolves, execs, and passes the exit code back.
+//
+// One package per platform, listed as optional dependencies of the root
+// package: npm and bun install only the row whose `os` and `cpu` match,
+// so a Windows machine never downloads a macOS binary.
+
+"use strict";
+
+const { spawn } = require("node:child_process");
+
+// The platforms the release builds, keyed the way node spells them.
+// A machine outside this table is told what is built rather than handed
+// a binary that cannot run, and the answer names the download page,
+// which carries every archive whether or not npm has a package for it.
+const PLATFORMS = {
+  "win32 x64": { package: "@sprawling/sprawling-windows-x64", binary: "sprawling.exe" },
+  "darwin arm64": { package: "@sprawling/sprawling-darwin-arm64", binary: "sprawling" },
+  "linux x64": { package: "@sprawling/sprawling-linux-x64-musl", binary: "sprawling" },
+};
+
+const MEI_PLATFORMS = {
+  "darwin arm64": { package: "@sprawling/mei-darwin-arm64", binary: "mei" },
+  "linux x64": { package: "@sprawling/mei-linux-x64-musl", binary: "mei" },
+};
+
+const RELEASES = "https://github.com/2youg1/sprawling-agents/releases";
+
+// Both root packages carry this same selector. Their own manifest, not
+// the current machine or a second generated script, chooses the product.
+const packageManifest = (() => {
+  try {
+    return require("../package.json");
+  } catch {
+    return {};
+  }
+})();
+const product =
+  packageManifest.name === "@sprawling/mei"
+    ? { command: "mei", root: packageManifest.name, platforms: MEI_PLATFORMS }
+    : { command: "sprawling", root: "sprawling", platforms: PLATFORMS };
+
+function die(message) {
+  process.stderr.write(`${product.command}: ${message}\n`);
+  process.exit(1);
+}
+
+// A package named at the version this run resolves it to, as npm spells
+// that pair. npm pins every optional dependency to the root package's
+// own version, so the root manifest is the one authority for which
+// release is being looked for; in the published package it sits one
+// directory above `bin/sprawling.js`. Where it cannot be read the name
+// is given alone, so a failure still reports everything it knows.
+function spec(name) {
+  return typeof packageManifest.version === "string" ? `${name}@${packageManifest.version}` : name;
+}
+
+const key = `${process.platform} ${process.arch}`;
+const row = product.platforms[key];
+if (row === undefined) {
+  die(
+    `no binary is published for ${key}, so ${spec(product.root)} has ` +
+      `nothing to run here. What is published: ` +
+      `${Object.keys(product.platforms).join(", ")}. ` +
+      `Build from source, or see ${RELEASES}.`,
+  );
+}
+
+let binary;
+try {
+  binary = require.resolve(`${row.package}/bin/${row.binary}`);
+} catch {
+  // The optional dependency did not install. The usual causes are an
+  // `--omit=optional` install and a lockfile copied from another
+  // platform, and both are fixed the same way, so the message says the
+  // fix rather than guessing which one happened.
+  die(
+    `${spec(row.package)} is not installed, so there is no binary for ` +
+      `${key}. Reinstall without omitting optional dependencies, ` +
+      `or see ${RELEASES}.`,
+  );
+}
+
+// `inherit`, so the city's console is this console: the process serves
+// until Ctrl-C, and its output is not something to collect and reprint.
+const child = spawn(binary, process.argv.slice(2), {
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    SPRAWLING_INSTALL_CHANNEL: ["npm", "bun"].includes(process.env.SPRAWLING_INSTALL_CHANNEL)
+      ? process.env.SPRAWLING_INSTALL_CHANNEL
+      : __dirname.split(/[\\/]/).includes(".bun")
+        ? "bun"
+        : __dirname.split(/[\\/]/).includes("_npx")
+          ? "npm"
+          : "package",
+  },
+});
+const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
+const forwards = new Map(signals.map((signal) => [signal, () => child.kill(signal)]));
+for (const [signal, forward] of forwards) process.on(signal, forward);
+child.on("error", (error) => die(`could not run ${binary}: ${error.message}`));
+child.on("exit", (status, signal) => {
+  for (const [name, forward] of forwards) process.removeListener(name, forward);
+  if (signal !== null && process.platform !== "win32") {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(status === null ? 1 : status);
+  }
+});

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@sprawling/mei",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.17-pre.261115",
+  "description": "Archetype:Mei, an academic minimal Agent Harness prototype for secondary development and technical discussion.",
+  "license": "MPL-2.0",
+  "repository": { "type": "git", "url": "git+https://github.com/2youg1/sprawling-agents.git" },
+  "homepage": "https://github.com/2youg1/sprawling-agents",
+  "bin": { "mei": "bin/mei.js", "mei-runtime": "bin/mei.cmd" },
+  "files": ["bin"],
+  "optionalDependencies": {
+    "@sprawling/mei-darwin-arm64": "0.0.17-pre.261115",
+    "@sprawling/mei-linux-x64-musl": "0.0.17-pre.261115"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.