claudekit-cli 3.36.0-dev.27 → 3.36.0-dev.28

package/README.md

@@ -9,7 +9,7 @@ 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
@@ -33,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
 
@@ -307,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

@@ -1,187 +1,2 @@
-#!/usr/bin/env node
-
-/**
- * Wrapper script that detects platform and executes the correct binary.
- * Falls back to Node.js execution if binary fails (e.g., Alpine/musl).
- * This is the entry point that NPM symlinks to when installing globally.
- */
-
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-// Minimum required Node.js version (major.minor)
-const MIN_NODE_VERSION = [18, 0];
-
-/**
- * Check if the current Node.js version meets minimum requirements.
- * Required because dependencies like ora@8 use ES2022+ features.
- */
-const checkNodeVersion = () => {
-	const [major, minor] = process.versions.node.split(".").map(Number);
-	const [minMajor, minMinor] = MIN_NODE_VERSION;
-
-	if (major < minMajor || (major === minMajor && minor < minMinor)) {
-		console.error(
-			`❌ Node.js ${MIN_NODE_VERSION.join(".")}+ is required. Current version: ${process.versions.node}`,
-		);
-		console.error("   Please upgrade Node.js: https://nodejs.org/");
-		process.exit(1);
-	}
-};
-
-// Check Node.js version before proceeding
-checkNodeVersion();
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-// Detect platform and architecture
-const platform = process.platform;
-const arch = process.arch;
-
-/**
- * Extract error message safely with type guard
- */
-const getErrorMessage = (err) => {
-	return err instanceof Error ? err.message : String(err);
-};
-
-/**
- * Run CLI via Node.js as fallback (slower but works on all platforms).
- * 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
- */
-const runWithNode = async (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 failed, using Node.js fallback (slower startup)");
-	}
-	// The CLI module handles process.exit() internally after command execution
-	// Convert to file:// URL for cross-platform ESM compatibility (Windows paths require this)
-	const distUrl = pathToFileURL(distPath).href;
-	try {
-		await import(distUrl);
-	} catch (importErr) {
-		throw new Error(`Failed to load CLI module: ${getErrorMessage(importErr)}`);
-	}
-};
-
-/**
- * Map platform/arch to binary filename
- */
-const getBinaryPath = () => {
-	const binaryMap = {
-		"darwin-arm64": "ck-darwin-arm64",
-		"darwin-x64": "ck-darwin-x64",
-		"linux-x64": "ck-linux-x64",
-		"win32-x64": "ck-win32-x64.exe",
-	};
-
-	const key = `${platform}-${arch}`;
-	const binaryName = binaryMap[key];
-
-	if (!binaryName) {
-		// Unsupported platform - try Node.js fallback
-		return null;
-	}
-
-	return join(__dirname, binaryName);
-};
-
-/**
- * Execute binary with fallback to Node.js on failure.
- * Uses Promise-based approach to avoid race conditions between error and exit events.
- *
- * Note: This Promise intentionally never rejects - all error paths call process.exit()
- * directly since this is a CLI entry point. The Promise is used purely for async flow
- * control and race condition prevention, not for error propagation.
- *
- * @param {string} binaryPath - Path to the platform-specific binary
- * @returns {Promise<void>} Resolves when fallback completes (binary exit calls process.exit directly)
- */
-const runBinary = (binaryPath) => {
-	return new Promise((resolve) => {
-		const child = spawn(binaryPath, process.argv.slice(2), {
-			stdio: "inherit",
-			windowsHide: true,
-		});
-
-		let errorOccurred = false;
-
-		child.on("error", async (err) => {
-			// Binary execution failed (e.g., ENOENT on Alpine/musl due to missing glibc)
-			// Fall back to Node.js execution
-			errorOccurred = true;
-			try {
-				await runWithNode(true);
-				resolve();
-			} catch (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",
-				);
-				process.exit(1);
-			}
-		});
-
-		child.on("exit", (code, signal) => {
-			// Don't handle exit if error handler is managing fallback
-			if (errorOccurred) return;
-
-			if (signal) {
-				process.kill(process.pid, signal);
-				return;
-			}
-			// Use exitCode instead of exit() for proper handle cleanup on Windows
-			// This prevents libuv assertion failures on Node.js 23.x/24.x/25.x
-			// See: https://github.com/nodejs/node/issues/56645
-			process.exitCode = code || 0;
-			resolve();
-		});
-	});
-};
-
-/**
- * Handle fallback execution with error reporting
- * @param {string} errorPrefix - Prefix for error message if fallback fails
- * @param {boolean} showIssueLink - Whether to show issue reporting link
- */
-const handleFallback = async (errorPrefix, showIssueLink = false) => {
-	try {
-		await runWithNode();
-	} catch (err) {
-		console.error(`❌ ${errorPrefix}: ${getErrorMessage(err)}`);
-		if (showIssueLink) {
-			console.error(
-				"Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues",
-			);
-		}
-		process.exit(1);
-	}
-};
-
-/**
- * Main execution - determine which path to take
- */
-const main = async () => {
-	const binaryPath = getBinaryPath();
-
-	if (!binaryPath) {
-		// No binary for this platform - use Node.js fallback
-		await handleFallback("Failed to run CLI");
-	} else if (!existsSync(binaryPath)) {
-		// Binary should exist but doesn't - try fallback
-		await handleFallback("Binary not found and fallback failed", true);
-	} else {
-		// Execute the binary (handles its own fallback on error)
-		await runBinary(binaryPath);
-	}
-};
-
-main();
+#!/usr/bin/env bash
+exec bun /Users/duynguyen/www/claudekit/claudekit-cli/dist/index.js "$@"