@qrafty-ai/opencode-kanban 0.3.3-linux-x64 → 0.3.4

package/README.md

@@ -18,32 +18,27 @@ A Rust terminal kanban board for managing Git worktrees and OpenCode tmux sessio
 - `opencode` installed and available on `PATH` (recommended for attach/resume workflows)
 
 ## Quickstart (2 minutes)
-
-1. Install:
-
-   ```bash
-   npm install -g opencode-kanban
-   ```
-
-2. Verify runtime tools:
+1. Verify runtime tools:
 
    ```bash
-   opencode-kanban --version
    tmux -V
    opencode --version
    ```
 
-3. Start the app:
+2. Start the app:
 
    ```bash
-   opencode-kanban
+   npx @qrafty-ai/opencode-kanban
    ```
 
-4. In the UI:
+3. In the UI:
    - Press `n` to create a task
    - Press `Enter` on a task to attach
    - Press `?` for built-in help
    - Press `q` to quit
+4. In the attached tmux session:
+   - Press `<prefix>+O` for help overlay
+   - Press `<prefix>+K` to return to kanban session
 
 If you start outside tmux, `opencode-kanban` auto-creates or auto-attaches to a tmux session named `opencode-kanban`.
 
@@ -52,7 +47,7 @@ If you start outside tmux, `opencode-kanban` auto-creates or auto-attaches to a
 ### npm
 
 ```bash
-npm install -g opencode-kanban
+npm install -g @qrafty-ai/opencode-kanban
 ```
 
 ### AUR (Arch Linux)

package/bin/opencode-kanban.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { accessSync, chmodSync, constants, existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const require = createRequire(import.meta.url);
+
+const PLATFORM_PACKAGE_BY_TARGET = {
+  "x86_64-unknown-linux-gnu": "@qrafty-ai/opencode-kanban-linux-x64",
+  "aarch64-apple-darwin": "@qrafty-ai/opencode-kanban-darwin-arm64",
+};
+
+function detectTargetTriple() {
+  const { platform, arch } = process;
+
+  if (platform === "linux" && arch === "x64") {
+    return "x86_64-unknown-linux-gnu";
+  }
+
+  if (platform === "darwin" && arch === "x64") {
+    throw new Error("darwin-x64 is not supported. Please use macOS with Apple Silicon (arm64).");
+  }
+
+  if (platform === "darwin" && arch === "arm64") {
+    return "aarch64-apple-darwin";
+  }
+
+  throw new Error(`Unsupported platform: ${platform} (${arch})`);
+}
+
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (/\bbun\//.test(userAgent)) {
+    return "bun";
+  }
+  return "npm";
+}
+
+const targetTriple = detectTargetTriple();
+const platformPackage = PLATFORM_PACKAGE_BY_TARGET[targetTriple];
+const binaryName = process.platform === "win32" ? "opencode-kanban.exe" : "opencode-kanban";
+const localVendorRoot = path.join(__dirname, "..", "vendor");
+const localBinaryPath = path.join(
+  localVendorRoot,
+  targetTriple,
+  "opencode-kanban",
+  binaryName,
+);
+
+let vendorRoot;
+try {
+  const packageJsonPath = require.resolve(`${platformPackage}/package.json`);
+  vendorRoot = path.join(path.dirname(packageJsonPath), "vendor");
+} catch {
+  if (existsSync(localBinaryPath)) {
+    vendorRoot = localVendorRoot;
+  }
+}
+
+if (!vendorRoot) {
+  const packageManager = detectPackageManager();
+  const updateCommand =
+    packageManager === "bun"
+      ? "bun install -g @qrafty-ai/opencode-kanban@latest"
+      : "npm install -g @qrafty-ai/opencode-kanban@latest";
+  throw new Error(
+    `Missing optional dependency ${platformPackage}. Reinstall opencode-kanban: ${updateCommand}`,
+  );
+}
+
+const binaryPath = path.join(vendorRoot, targetTriple, "opencode-kanban", binaryName);
+
+function ensureExecutable(pathToBinary) {
+  if (process.platform === "win32") {
+    return;
+  }
+
+  try {
+    accessSync(pathToBinary, constants.X_OK);
+    return;
+  } catch {
+  }
+
+  try {
+    chmodSync(pathToBinary, 0o755);
+    accessSync(pathToBinary, constants.X_OK);
+  } catch (error) {
+    throw new Error(`Binary is not executable: ${pathToBinary}`, { cause: error });
+  }
+}
+
+ensureExecutable(binaryPath);
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("error", (error) => {
+  console.error(error);
+  process.exit(1);
+});
+
+const forwardSignal = (signal) => {
+  if (child.killed) {
+    return;
+  }
+  try {
+    child.kill(signal);
+  } catch {
+  }
+};
+
+["SIGINT", "SIGTERM", "SIGHUP"].forEach((signal) => {
+  process.on(signal, () => forwardSignal(signal));
+});
+
+const childResult = await new Promise((resolve) => {
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      resolve({ type: "signal", signal });
+      return;
+    }
+    resolve({ type: "code", exitCode: code ?? 1 });
+  });
+});
+
+if (childResult.type === "signal") {
+  process.kill(process.pid, childResult.signal);
+} else {
+  process.exit(childResult.exitCode);
+}

package/package.json

@@ -1,22 +1,24 @@
 {
   "name": "@qrafty-ai/opencode-kanban",
-  "version": "0.3.3-linux-x64",
+  "version": "0.3.4",
   "description": "Terminal kanban board for managing OpenCode tmux sessions",
   "license": "MIT",
-  "os": [
-    "linux"
-  ],
-  "cpu": [
-    "x64"
-  ],
+  "type": "module",
+  "bin": {
+    "opencode-kanban": "bin/opencode-kanban.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "files": [
-    "vendor"
+    "bin"
   ],
   "repository": {
     "type": "git",
     "url": "https://github.com/qrafty-ai/opencode-kanban.git"
   },
-  "engines": {
-    "node": ">=18"
+  "optionalDependencies": {
+    "@qrafty-ai/opencode-kanban-linux-x64": "npm:@qrafty-ai/opencode-kanban@0.3.4-linux-x64",
+    "@qrafty-ai/opencode-kanban-darwin-arm64": "npm:@qrafty-ai/opencode-kanban@0.3.4-darwin-arm64"
   }
 }