@starci/cli 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.0.0
+
+- Introduce the catalog-driven `starci` dispatcher, generated help and shell completions.
+- Route app commands to `@starci/hfs` and runtime commands to an installed StarCi tree.
+- Add the in-process `starci runtime install` bootstrap.

package/README.md

@@ -0,0 +1,8 @@
+# @starci/cli
+
+`starci` is the single catalog-driven command line for StarCi. Product repositories use
+`starci app ...`; runtime operations use the `workflow`, `kernel`, `runtime`, `supervisor`, and
+`debug` groups.
+
+Install the package as an exact development dependency, then run `starci help`. Runtime commands
+locate an installed StarCi tree automatically. If none exists, run `starci runtime install`.

package/bin/starci.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import process from 'node:process';
+import { main } from '../src/main.mjs';
+
+// A reader that closes early (`starci help | head`) is not an error worth a stack trace.
+for (const stream of [process.stdout, process.stderr]) {
+  stream.on('error', (error) => {
+    if (error?.code === 'EPIPE') process.exit(process.exitCode ?? 0);
+    throw error;
+  });
+}
+
+try {
+  process.exitCode = await main(process.argv.slice(2));
+} catch (error) {
+  process.stderr.write(`starci: ${error?.message ?? error}\n`);
+  process.exitCode = 1;
+}