@jr2/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rich Snapp
+
+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,18 @@
+# @jr2/cli
+
+The `jr2` binary: the interface to a jr2 [Instance](https://github.com/snapwich/jr2/blob/main/CONTEXT.md) — a folder of
+workflows deployed to whatever cluster the current `kubectl` context names.
+
+```sh
+npm i -g @jr2/cli
+jr2 init my-instance && cd my-instance
+npm install
+jr2 up
+jr2 run <workflow>
+```
+
+`init` scaffolds an Instance pinned at this CLI's version; `up` converges the target namespace to match it (operator,
+Orchestrator, Sandboxes, secrets), and every other verb (`run`, `runs`, `status`, `logs`, `send`, `down`, `gc`,
+`kit push`) talks to what `up` deployed. Node 24, a kube context, and docker for the image `up` builds.
+
+Docs, glossary, and architecture decisions: [github.com/snapwich/jr2](https://github.com/snapwich/jr2).

package/bin/jr2.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// The `jr2` binary (ADR-0009). The kit is zero-build `.ts` — but Node's own type stripping REFUSES
+// to run on files under `node_modules`, and an installed kit is nothing but files under
+// `node_modules` (ADR-0043). So this entry is the one `.js` file in the package: it teaches the
+// loader to erase types the same way Node would, then hands over to the `.ts` sources.
+//
+// One entry for both worlds, deliberately: a checkout-only `.ts` bin plus an installed-only `.js`
+// bin would mean the binary users run is not the binary the checkout's tiers run. The image
+// bundle solves the same problem with `tsx` (see INSTANCE_DOCKERFILE) because there the entry is
+// the orchestrator's, not this one.
+//
+// After the hook it does nothing but hand argv to `main` and surface the exit code. `main` is
+// pure-ish (takes an injectable IO) so the dispatch + commands stay unit-testable without a process.
+
+import { readFileSync } from "node:fs";
+import { registerHooks } from "node:module";
+import { fileURLToPath } from "node:url";
+import tsBlankSpace from "ts-blank-space";
+
+// Erasure, not compilation: types are replaced by whitespace, so line and column numbers in a
+// stack trace still point at the source (ADR-0034 makes the same trade for the Console). What
+// `ts-blank-space` cannot erase — an enum, a namespace, a constructor parameter property — is
+// exactly what Node's own stripping rejects too, so this hook widens where the kit runs, never
+// what the kit may be written in. `module` is the only format the kit ships: every jr2 package is
+// `type: "module"`, and the hook sees kit sources only (the CLI imports no instance code).
+registerHooks({
+  load(url, context, nextLoad) {
+    if (!url.startsWith("file:") || !url.endsWith(".ts")) return nextLoad(url, context);
+    const source = tsBlankSpace(readFileSync(fileURLToPath(url), "utf8"));
+    return { format: "module", source, shortCircuit: true };
+  },
+});
+
+const { main } = await import("../src/cli.ts");
+
+main(process.argv.slice(2)).then((code) => {
+  process.exitCode = code;
+});