claudekit-cli 3.36.0-dev.8 → 3.36.0

package/README.md

@@ -9,8 +9,9 @@ Command-line tool and web dashboard for managing ClaudeKit projects.
 ClaudeKit Config UI (`ck`) provides both CLI and web dashboard for managing ClaudeKit projects. Built with Bun, TypeScript, and React, enables fast, secure project setup and comprehensive configuration management.
 
 **Key Features:**
-- **CLI Commands (14)**: new, init, config, projects, setup, skills, agents, commands, migrate, doctor, versions, update, uninstall, easter-egg
+- **CLI Commands (16)**: new, init, config, projects, setup, skills, agents, commands, migrate, doctor, versions, update, uninstall, watch, content, easter-egg
 - **Web Dashboard**: Interactive React UI via `ck config ui` for configuration and project management
+- **Hook Diagnostics Dashboard**: Inspect recent Claude hook activity and failures from `ck config` across global and project scopes
 - **Projects Registry**: Centralized registry at `~/.claudekit/projects.json` with file locking
 - **Skill Installation**: Install ClaudeKit skills to other coding agents (Cursor, Codex, etc.)
 - **Multi-tier Authentication**: gh CLI → env vars → keychain → prompt fallback
@@ -32,6 +33,8 @@ Comprehensive documentation in `/docs`:
 - **[Code Standards](./docs/code-standards.md)** - Coding conventions, best practices
 - **[Project Roadmap](./docs/project-roadmap.md)** - Release timeline, feature status
 - **[Deployment Guide](./docs/deployment-guide.md)** - Release procedures
+- **[ck watch](./docs/ck-watch.md)** - GitHub issue monitoring daemon
+- **[ck content](./docs/ck-content.md)** - Automated content generation from git activity
 
 ## Prerequisites
 
@@ -306,6 +309,64 @@ ck uninstall --yes        # Non-interactive - skip confirmation (for scripts)
 
 **Note:** Only removes valid ClaudeKit installations (with metadata.json). Regular `.claude` directories from Claude Desktop are not affected.
 
+### Watch GitHub Issues (`ck watch`)
+
+Autonomous daemon that monitors GitHub issues, analyzes them with Claude, generates plans, and creates PRs.
+
+```bash
+# Start watching (single repo)
+ck watch
+
+# Dry-run mode (no posts/PRs)
+ck watch --dry-run
+
+# Custom poll interval (ms)
+ck watch --interval 60000
+
+# Force restart (clear state)
+ck watch --force
+
+# Verbose logging
+ck watch --verbose
+```
+
+**Features:** issue lifecycle management (10 statuses), Claude-powered brainstorming/planning, automatic PR creation, rate limiting (persisted across restarts), maintainer reply filtering, processedIssues TTL, optional git worktree isolation per issue, multi-repo support, graceful shutdown.
+
+**Config:** `.ck.json` under `watch` key. See [docs/ck-watch.md](./docs/ck-watch.md) for full configuration reference.
+
+### Content Generation (`ck content`)
+
+Daemon that scans git activity (commits, PRs, tags), generates social media content with Claude, and publishes to X/Twitter and Facebook.
+
+```bash
+# Interactive setup wizard
+ck content setup
+
+# Start daemon
+ck content start
+
+# Check status
+ck content status
+
+# View logs
+ck content logs
+
+# Queue manual content
+ck content queue
+
+# Review workflow
+ck content approve <id>
+ck content reject <id>
+
+# Dry-run / verbose
+ck content start --dry-run
+ck content start --verbose
+```
+
+**Features:** 11-phase pipeline (scan → filter → classify → context → create → validate → review → photo → publish → engage → analyze), noise filtering, context caching (24h TTL), content validation, photo generation, 3 review modes (auto/manual/hybrid), quiet hours scheduling, engagement tracking, SQLite database, platform-specific adapters.
+
+**Config:** `.ck.json` under `content` key. See [docs/ck-content.md](./docs/ck-content.md) for full configuration reference.
+
 ### Other Commands
 
 ```bash

package/bin/ck.js

@@ -6,7 +6,7 @@
  * This is the entry point that NPM symlinks to when installing globally.
  */
 
-import { spawn } from "node:child_process";
+import { execSync, spawn, spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -48,7 +48,56 @@ const getErrorMessage = (err) => {
 };
 
 /**
- * Run CLI via Node.js as fallback (slower but works on all platforms).
+ * Check if bun runtime is available on the system.
+ * Used to run dist/index.js with bun when no platform binary exists (e.g., dev releases).
+ * dist/index.js may contain bun-specific imports (bun:sqlite) that Node.js can't handle.
+ * Result is cached to avoid repeated execSync calls across fallback paths.
+ */
+let _bunAvailable = undefined;
+const hasBun = () => {
+	if (_bunAvailable !== undefined) return _bunAvailable;
+	try {
+		execSync("bun --version", { stdio: "ignore", timeout: 3000 });
+		_bunAvailable = true;
+	} catch {
+		_bunAvailable = false;
+	}
+	return _bunAvailable;
+};
+
+/**
+ * Run CLI via bun runtime. Preferred over Node.js when dist/index.js contains
+ * bun-specific imports (e.g., bun:sqlite) that the Node.js ESM loader rejects.
+ * Uses spawnSync to hand full terminal control to bun — this prevents Unicode
+ * rendering issues (garbled @clack/prompts box-drawing chars) that occur when
+ * bun runs as an async child of a Node.js parent process.
+ * @param {boolean} showWarning - Whether to show runtime info message
+ * @returns {boolean} true if bun ran successfully, false if spawn failed
+ */
+const runWithBun = (showWarning = false) => {
+	const distPath = join(__dirname, "..", "dist", "index.js");
+	if (!existsSync(distPath)) {
+		throw new Error("Compiled distribution not found. This may indicate a packaging issue.");
+	}
+	if (showWarning) {
+		console.error("⚠️  Native binary not found, using bun runtime");
+	}
+	const result = spawnSync("bun", [distPath, ...process.argv.slice(2)], {
+		stdio: "inherit",
+		windowsHide: true,
+	});
+	if (result.error) {
+		// bun spawn failed (e.g., ENOENT) — caller handles fallback
+		return false;
+	}
+	if (result.signal) {
+		process.kill(process.pid, result.signal);
+	}
+	process.exit(result.status || 0);
+};
+
+/**
+ * Run CLI via Node.js as last-resort fallback (slower, no bun: protocol support).
  * The imported dist/index.js handles its own process lifecycle via the cac CLI framework.
  * @param {boolean} showWarning - Whether to show fallback warning message
  * @throws {Error} If dist/index.js is missing or fails to load
@@ -115,17 +164,29 @@ const runBinary = (binaryPath) => {
 
 		child.on("error", async (err) => {
 			// Binary execution failed (e.g., ENOENT on Alpine/musl due to missing glibc)
-			// Fall back to Node.js execution
+			// Fall back to bun (exits process on success), then Node.js
 			errorOccurred = true;
+			if (hasBun()) {
+				// runWithBun calls process.exit() on success — won't return here
+				runWithBun(true);
+			}
 			try {
 				await runWithNode(true);
 				resolve();
 			} catch (fallbackErr) {
+				const fallbackMsg = getErrorMessage(fallbackErr);
 				console.error(`❌ Binary failed: ${getErrorMessage(err)}`);
-				console.error(`❌ Fallback also failed: ${getErrorMessage(fallbackErr)}`);
-				console.error(
-					"Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues",
-				);
+				console.error(`❌ Fallback also failed: ${fallbackMsg}`);
+				if (fallbackMsg.includes("bun:") || fallbackMsg.includes("Received protocol")) {
+					console.error("");
+					console.error("This version of ClaudeKit CLI requires the bun runtime.");
+					console.error("Install bun:  curl -fsSL https://bun.sh/install | bash");
+					console.error("Or switch to stable:  npm install -g claudekit-cli@latest");
+				} else {
+					console.error(
+						"Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues",
+					);
+				}
 				process.exit(1);
 			}
 		});
@@ -148,16 +209,29 @@ const runBinary = (binaryPath) => {
 };
 
 /**
- * Handle fallback execution with error reporting
- * @param {string} errorPrefix - Prefix for error message if fallback fails
+ * Handle fallback execution: try bun first (handles bun: imports), then Node.js.
+ * @param {string} errorPrefix - Prefix for error message if all fallbacks fail
  * @param {boolean} showIssueLink - Whether to show issue reporting link
  */
 const handleFallback = async (errorPrefix, showIssueLink = false) => {
+	// Prefer bun — dist/index.js may contain bun-specific imports (bun:sqlite)
+	// runWithBun calls process.exit() on success — won't return here
+	if (hasBun()) {
+		runWithBun(true);
+	}
+	// Last resort: Node.js (works for stable builds without bun: imports)
 	try {
 		await runWithNode();
 	} catch (err) {
-		console.error(`❌ ${errorPrefix}: ${getErrorMessage(err)}`);
-		if (showIssueLink) {
+		const errMsg = getErrorMessage(err);
+		console.error(`❌ ${errorPrefix}: ${errMsg}`);
+		// Detect bun-specific import failures and guide user to install bun
+		if (errMsg.includes("bun:") || errMsg.includes("Received protocol")) {
+			console.error("");
+			console.error("This version of ClaudeKit CLI requires the bun runtime.");
+			console.error("Install bun:  curl -fsSL https://bun.sh/install | bash");
+			console.error("Or switch to stable:  npm install -g claudekit-cli@latest");
+		} else if (showIssueLink) {
 			console.error(
 				"Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues",
 			);