@b00dea/cockpit 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+<p align="center"><img src="https://raw.githubusercontent.com/b0dea/cockpit/main/.github/assets/cockpit-logo.png" alt="" width="128"></p>
 
-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.
+# @b00dea/cockpit
+
+This package is the cockpit CLI: where coding agents work on your whole product. From one reviewed
+`cockpit.toml` it gives Claude Code, Codex CLI and OpenCode the same instructions, skills and guard
+hook across every repository of the product, runs the product's own Compose stack on the live
+checkouts with a port lease per checkout, checks work orders against criteria you set, and fails a
+check when any generated file drifts. What each tool actually enforces is in the
+[capability matrix](https://github.com/b0dea/cockpit/blob/main/docs/capability-matrix.md).
+
+Install it as an exact, project-local dev dependency (the package is pre-alpha, so pin the version):
+
+```sh
+npm install --save-dev --save-exact @b00dea/cockpit
+```
+
+With pnpm or yarn, use `pnpm add -D -E @b00dea/cockpit` or `yarn add -D -E @b00dea/cockpit`, and run
+`pnpm exec cockpit` or `yarn cockpit` in place of running it through `npx --no`.
+
+Start with the [repository README](https://github.com/b0dea/cockpit#readme) and
+[Getting started](https://github.com/b0dea/cockpit/blob/main/docs/getting-started.md#install-cockpit).
+
+The `cockpit` command is the only public interface; the package's exports and type declarations
+serve cockpit's own tooling and are not a stable API. Supported Node.js versions are in `engines`
+in this package's `package.json`.

package/bin/cockpit.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+// Mirrors package.json "engines.node"; the floor is the 22.x minor, not just the major.
+const supportedRange = '^22.22.0 || ^24.0.0 || ^26.0.0'
+const minimumNode22Minor = 22
+const version = process.versions.node
+const match = typeof version === 'string' && /^([0-9]+)\.([0-9]+)\.[0-9]+(?:[-+].*)?$/.exec(version)
+const major = match ? Number(match[1]) : Number.NaN
+const minor = match ? Number(match[2]) : Number.NaN
+
+if (!Number.isInteger(major) || major < 22 || (major === 22 && minor < minimumNode22Minor)) {
+    console.error(
+        `COCKPIT_NODE_VERSION_UNSUPPORTED: Node.js ${supportedRange} is required; this is ${version}.`,
+    )
+    process.exitCode = 1
+} else {
+    const { runCli } = await import('../dist/cli.js')
+    const argv = process.argv.slice(2)
+    if (argv[0] !== 'session' && argv[0] !== 'logs') {
+        process.exitCode = await runCli(argv)
+    } else {
+        const controller = new AbortController()
+        const abort = () => controller.abort()
+        process.once('SIGINT', abort)
+        process.once('SIGTERM', abort)
+        try {
+            process.exitCode = await runCli(argv, process, {}, { signal: controller.signal })
+        } finally {
+            process.removeListener('SIGINT', abort)
+            process.removeListener('SIGTERM', abort)
+        }
+    }
+}