@qrafty-ai/opencode-kanban 0.0.0-dev

package/README.md

@@ -0,0 +1,79 @@
+# opencode-kanban
+
+A Rust terminal kanban board for managing Git worktrees and OpenCode tmux sessions.
+
+## Features
+
+- TUI task board for OpenCode session workflows
+- Git worktree management from the board
+- tmux-first workflow with quick session switching
+- SQLite-backed state and task metadata
+
+## Requirements
+
+- Linux or macOS
+- `tmux` installed and available on `PATH`
+
+## Install
+
+### npm
+
+```bash
+npm install -g opencode-kanban
+```
+
+### Build from source
+
+```bash
+cargo build --release
+./target/release/opencode-kanban
+```
+
+## Run
+
+```bash
+opencode-kanban
+```
+
+If you run the CLI outside tmux, it creates or attaches to an `opencode-kanban` tmux session automatically.
+
+## Local development
+
+```bash
+cargo test
+cargo clippy -- -D warnings
+cargo build --release
+```
+
+## npm release process
+
+Publishing is handled by `.github/workflows/publish-npm.yaml` and uses npm trusted publishing via GitHub OIDC.
+
+1. Create and push a release tag:
+
+```bash
+git tag -a v0.1.0 -m "Release v0.1.0"
+git push origin v0.1.0
+```
+
+For prereleases, use `vX.Y.Z-alpha.N` tags.
+
+The workflow derives the package version from the tag (or manual dispatch input) and updates `Cargo.toml` during CI before building.
+
+The workflow builds platform binaries, packages npm tarballs, and publishes:
+
+- `opencode-kanban` (main package)
+- platform-tagged variants for Linux x64, macOS x64, and macOS arm64
+
+## First-time npm setup
+
+In npm package settings, configure a Trusted Publisher for this repository and workflow file:
+
+- Repository: this GitHub repository
+- Workflow: `.github/workflows/publish-npm.yaml`
+
+No `NPM_TOKEN` secret is required when trusted publishing is configured.
+
+## License
+
+MIT

package/npm/bin/opencode-kanban.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { 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": "opencode-kanban-linux-x64",
+  "x86_64-apple-darwin": "opencode-kanban-darwin-x64",
+  "aarch64-apple-darwin": "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") {
+    return "x86_64-apple-darwin";
+  }
+
+  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 opencode-kanban@latest"
+      : "npm install -g opencode-kanban@latest";
+  throw new Error(
+    `Missing optional dependency ${platformPackage}. Reinstall opencode-kanban: ${updateCommand}`,
+  );
+}
+
+const binaryPath = path.join(vendorRoot, targetTriple, "opencode-kanban", binaryName);
+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

@@ -0,0 +1,28 @@
+{
+  "name": "@qrafty-ai/opencode-kanban",
+  "version": "0.0.0-dev",
+  "description": "Terminal kanban board for managing OpenCode tmux sessions",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "opencode-kanban": "npm/bin/opencode-kanban.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "npm/bin",
+    "vendor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qrafty-ai/opencode-kanban.git"
+  },
+  "homepage": "https://github.com/qrafty-ai/opencode-kanban#readme",
+  "bugs": {
+    "url": "https://github.com/qrafty-ai/opencode-kanban/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}