@kilip/opus 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,47 @@
-# Temporary Holding Version
+# @kilip/opus
 
-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.
+Opus mission control dashboard for AI coding agents.
+
+This package provides a platform-independent wrapper and CLI runner for Opus. When installed or run via `npx` / `bunx`, it automatically delegates execution to the pre-compiled platform binary matching your operating system and architecture (`@kilip/opus-linux-x64` or `@kilip/opus-linux-arm64`).
+
+## Quick Start
+
+### Run with npx or bunx (Zero Install)
+
+```bash
+# Using npx
+npx @kilip/opus serve
+
+# Using bunx
+bunx @kilip/opus serve
+```
+
+### Install Opus to `~/.opus/bin`
+
+To install Opus permanently on your system and optionally configure a systemd user service:
+
+```bash
+# Install binary to ~/.opus/bin/opus
+npx @kilip/opus install
+
+# Install binary and enable/start systemd user service
+npx @kilip/opus install --service
+```
+
+### Global Installation via npm
+
+```bash
+npm install -g @kilip/opus
+opus serve
+```
+
+## Supported Platforms
+
+- Linux x86_64 (`linux-x64`)
+- Linux ARM64 (`linux-arm64`)
+
+For other platforms (macOS, Windows), please [build from source](https://github.com/kilip/opus#building-from-source).
+
+## License
+
+[MIT](https://github.com/kilip/opus/blob/main/LICENSE)

package/bin/opus.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const process = require('node:process');
+const { spawn } = require('node:child_process');
+
+function main() {
+  if (process.platform !== 'linux') {
+    process.stderr.write(
+      'Error: Opus npm distribution is currently only supported on Linux (x64 and arm64).\n' +
+      `Detected platform: ${process.platform}/${process.arch}.\n` +
+      'For macOS, Windows, or other platforms, please build from source:\n' +
+      '  https://github.com/kilip/opus#building-from-source\n'
+    );
+    process.exit(1);
+  }
+
+  const supportedArchs = ['x64', 'arm64'];
+  if (!supportedArchs.includes(process.arch)) {
+    process.stderr.write(
+      `Error: Unsupported CPU architecture: ${process.arch}.\n` +
+      'Opus npm distribution supports x64 and arm64 on Linux.\n' +
+      'Please build from source:\n' +
+      '  https://github.com/kilip/opus#building-from-source\n'
+    );
+    process.exit(1);
+  }
+
+  const pkgName = `@kilip/opus-linux-${process.arch}`;
+  const binPath = resolveBinary(pkgName);
+
+  if (!binPath) {
+    process.stderr.write(
+      `Error: Opus binary package '${pkgName}' is not installed.\n\n` +
+      'This usually means optionalDependencies were omitted during installation\n' +
+      '(for example, via --no-optional or an unsupported package manager setting).\n\n' +
+      `Please try installing '${pkgName}' explicitly or reinstalling '@kilip/opus':\n` +
+      `  npm install ${pkgName}\n`
+    );
+    process.exit(1);
+  }
+
+  try {
+    fs.chmodSync(binPath, 0o755);
+  } catch {
+    // Ignore error if file is already executable or read-only filesystem
+  }
+
+  const child = spawn(binPath, process.argv.slice(2), {
+    stdio: 'inherit'
+  });
+
+  const forwardSignal = (signal) => {
+    if (!child.killed) {
+      try {
+        child.kill(signal);
+      } catch {
+        // Child might have already exited
+      }
+    }
+  };
+
+  process.on('SIGINT', () => forwardSignal('SIGINT'));
+  process.on('SIGTERM', () => forwardSignal('SIGTERM'));
+  process.on('SIGHUP', () => forwardSignal('SIGHUP'));
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code ?? 0);
+    }
+  });
+
+  child.on('error', (err) => {
+    process.stderr.write(`Failed to start Opus binary: ${err.message}\n`);
+    process.exit(1);
+  });
+}
+
+function resolveBinary(pkgName) {
+  // Strategy 1: Node package resolution to package.json
+  try {
+    const pkgJsonPath = require.resolve(`${pkgName}/package.json`);
+    const target = path.join(path.dirname(pkgJsonPath), 'bin', 'opus');
+    if (fs.existsSync(target)) {
+      return target;
+    }
+  } catch {
+    // Fall back to relative searches
+  }
+
+  // Strategy 2: Relative paths for flat node_modules, npm caching, or monorepo links
+  const candidates = [
+    path.resolve(__dirname, '..', '..', pkgName, 'bin', 'opus'),
+    path.resolve(__dirname, '..', '..', `opus-linux-${process.arch}`, 'bin', 'opus'),
+    path.resolve(__dirname, '..', 'node_modules', pkgName, 'bin', 'opus')
+  ];
+
+  for (const candidate of candidates) {
+    try {
+      if (fs.existsSync(candidate)) {
+        return candidate;
+      }
+    } catch {
+      // Ignore filesystem access errors
+    }
+  }
+
+  return null;
+}
+
+main();

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@kilip/opus",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Opus mission control dashboard for AI coding agents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kilip/opus.git"
+  },
+  "homepage": "https://github.com/kilip/opus#readme",
+  "bugs": {
+    "url": "https://github.com/kilip/opus/issues"
+  },
+  "keywords": [
+    "opus",
+    "ai",
+    "coding-agent",
+    "agent",
+    "omp",
+    "mission-control",
+    "dashboard"
+  ],
+  "bin": {
+    "opus": "bin/opus.js"
+  },
+  "files": [
+    "bin/opus.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@kilip/opus-linux-x64": "0.1.1",
+    "@kilip/opus-linux-arm64": "0.1.1"
+  }
+}