@introspection-ai/cli 0.1.1

package/README.md

@@ -0,0 +1,24 @@
+# @introspection-ai/cli
+
+The [Introspection](https://introspection.dev) command-line interface — the
+**remote hot-swap executor**. Attaches to the cloud from your environment and
+streams your local working-tree content into a running task's sandbox,
+re-shipping on every change.
+
+```bash
+npm install -g @introspection-ai/cli
+
+# then, from inside your git work-tree:
+introspection remote --task-id "$TASK_ID"
+```
+
+Or run without installing:
+
+```bash
+npx @introspection-ai/cli remote --task-id "$TASK_ID"
+```
+
+The platform-specific binary is delivered via an optional dependency
+(`@introspection-ai/cli-<os>-<cpu>`) selected automatically by npm.
+
+Full documentation: https://github.com/introspection-org/introspection-cli

package/bin/introspection.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// Launcher for the Introspection CLI. The actual binary ships in a
+// per-platform optional-dependency package (`@introspection-ai/cli-<os>-<cpu>`),
+// gated by npm's `os`/`cpu` fields so only the matching one installs. This
+// shim resolves that binary and execs it, passing argv/stdio/exit code through.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+
+const PACKAGES = {
+  "darwin-arm64": "@introspection-ai/cli-darwin-arm64",
+  "darwin-x64": "@introspection-ai/cli-darwin-x64",
+  "linux-x64": "@introspection-ai/cli-linux-x64",
+  "linux-arm64": "@introspection-ai/cli-linux-arm64",
+  "win32-x64": "@introspection-ai/cli-win32-x64",
+};
+
+function resolveBinary() {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = PACKAGES[key];
+  if (!pkg) {
+    throw new Error(
+      `Unsupported platform: ${key}. ` +
+        `Build from source: https://github.com/introspection-org/introspection-cli`
+    );
+  }
+  const binName = process.platform === "win32" ? "introspection.exe" : "introspection";
+  try {
+    return require.resolve(`${pkg}/bin/${binName}`);
+  } catch {
+    throw new Error(
+      `The platform package "${pkg}" is not installed.\n` +
+        `If you installed with --no-optional or --omit=optional, reinstall ` +
+        `without it so the matching binary is fetched.`
+    );
+  }
+}
+
+let binary;
+try {
+  binary = resolveBinary();
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+// Re-raise a terminating signal as our own exit; otherwise pass the code.
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+process.exit(result.status ?? 0);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@introspection-ai/cli",
+  "version": "0.1.1",
+  "description": "Introspection CLI — remote hot-swap executor for the Introspection agent-reliability platform",
+  "keywords": [
+    "introspection",
+    "cli",
+    "remote",
+    "hot-swap",
+    "agents"
+  ],
+  "homepage": "https://github.com/introspection-org/introspection-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/introspection-org/introspection-cli.git"
+  },
+  "license": "Apache-2.0",
+  "bin": {
+    "introspection": "bin/introspection.js"
+  },
+  "files": [
+    "bin/introspection.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@introspection-ai/cli-darwin-arm64": "0.1.1",
+    "@introspection-ai/cli-darwin-x64": "0.1.1",
+    "@introspection-ai/cli-linux-x64": "0.1.1",
+    "@introspection-ai/cli-linux-arm64": "0.1.1",
+    "@introspection-ai/cli-win32-x64": "0.1.1"
+  }
+}