claudekit-cli 1.4.1 → 1.5.1

package/src/commands/new.ts

@@ -1,185 +0,0 @@
-import { resolve } from "node:path";
-import { pathExists, readdir } from "fs-extra";
-import { AuthManager } from "../lib/auth.js";
-import { DownloadManager } from "../lib/download.js";
-import { GitHubClient } from "../lib/github.js";
-import { FileMerger } from "../lib/merge.js";
-import { PromptsManager } from "../lib/prompts.js";
-import { AVAILABLE_KITS, type NewCommandOptions, NewCommandOptionsSchema } from "../types.js";
-import { ConfigManager } from "../utils/config.js";
-import { logger } from "../utils/logger.js";
-import { createSpinner } from "../utils/safe-spinner.js";
-
-export async function newCommand(options: NewCommandOptions): Promise<void> {
-	const prompts = new PromptsManager();
-
-	prompts.intro("🚀 ClaudeKit - Create New Project");
-
-	try {
-		// Validate and parse options
-		const validOptions = NewCommandOptionsSchema.parse(options);
-
-		// Detect non-interactive mode
-		const isNonInteractive =
-			!process.stdin.isTTY || process.env.CI === "true" || process.env.NON_INTERACTIVE === "true";
-
-		// Load config for defaults
-		const config = await ConfigManager.get();
-
-		// Get kit selection
-		let kit = validOptions.kit || config.defaults?.kit;
-		if (!kit) {
-			if (isNonInteractive) {
-				throw new Error("Kit must be specified via --kit flag in non-interactive mode");
-			}
-			kit = await prompts.selectKit();
-		}
-
-		const kitConfig = AVAILABLE_KITS[kit];
-		logger.info(`Selected kit: ${kitConfig.name}`);
-
-		// Get target directory
-		let targetDir = validOptions.dir || config.defaults?.dir || ".";
-		if (!validOptions.dir && !config.defaults?.dir) {
-			if (isNonInteractive) {
-				targetDir = ".";
-			} else {
-				targetDir = await prompts.getDirectory(targetDir);
-			}
-		}
-
-		const resolvedDir = resolve(targetDir);
-		logger.info(`Target directory: ${resolvedDir}`);
-
-		// Check if directory exists and is not empty
-		if (await pathExists(resolvedDir)) {
-			const files = await readdir(resolvedDir);
-			const isEmpty = files.length === 0;
-			if (!isEmpty) {
-				if (isNonInteractive) {
-					if (!validOptions.force) {
-						throw new Error(
-							"Directory is not empty. Use --force flag to overwrite in non-interactive mode",
-						);
-					}
-					logger.info("Directory is not empty. Proceeding with --force flag");
-				} else {
-					const continueAnyway = await prompts.confirm(
-						"Directory is not empty. Files may be overwritten. Continue?",
-					);
-					if (!continueAnyway) {
-						logger.warning("Operation cancelled");
-						return;
-					}
-				}
-			}
-		}
-
-		// Initialize GitHub client
-		const github = new GitHubClient();
-
-		// Check repository access
-		const spinner = createSpinner("Checking repository access...").start();
-		const hasAccess = await github.checkAccess(kitConfig);
-		if (!hasAccess) {
-			spinner.fail("Access denied to repository");
-			logger.error(
-				`Cannot access ${kitConfig.name}. Make sure your GitHub token has access to private repositories.`,
-			);
-			return;
-		}
-		spinner.succeed("Repository access verified");
-
-		// Get release
-		let release;
-		if (validOptions.version) {
-			logger.info(`Fetching release version: ${validOptions.version}`);
-			release = await github.getReleaseByTag(kitConfig, validOptions.version);
-		} else {
-			logger.info("Fetching latest release...");
-			release = await github.getLatestRelease(kitConfig);
-		}
-
-		logger.success(`Found release: ${release.tag_name} - ${release.name}`);
-
-		// Get downloadable asset (custom asset or GitHub tarball)
-		const downloadInfo = GitHubClient.getDownloadableAsset(release);
-
-		logger.info(`Download source: ${downloadInfo.type}`);
-		logger.debug(`Download URL: ${downloadInfo.url}`);
-
-		// Download asset
-		const downloadManager = new DownloadManager();
-
-		// Apply user exclude patterns if provided
-		if (validOptions.exclude && validOptions.exclude.length > 0) {
-			downloadManager.setExcludePatterns(validOptions.exclude);
-		}
-
-		const tempDir = await downloadManager.createTempDir();
-
-		// Get authentication token for API requests
-		const { token } = await AuthManager.getToken();
-
-		let archivePath: string;
-		try {
-			// Try downloading the asset/tarball with authentication
-			archivePath = await downloadManager.downloadFile({
-				url: downloadInfo.url,
-				name: downloadInfo.name,
-				size: downloadInfo.size,
-				destDir: tempDir,
-				token, // Always pass token for private repository access
-			});
-		} catch (error) {
-			// If asset download fails, fallback to GitHub tarball
-			if (downloadInfo.type === "asset") {
-				logger.warning("Asset download failed, falling back to GitHub tarball...");
-				const tarballInfo = {
-					type: "github-tarball" as const,
-					url: release.tarball_url,
-					name: `${kitConfig.repo}-${release.tag_name}.tar.gz`,
-					size: 0, // Size unknown for tarball
-				};
-
-				archivePath = await downloadManager.downloadFile({
-					url: tarballInfo.url,
-					name: tarballInfo.name,
-					size: tarballInfo.size,
-					destDir: tempDir,
-					token,
-				});
-			} else {
-				throw error;
-			}
-		}
-
-		// Extract archive
-		const extractDir = `${tempDir}/extracted`;
-		await downloadManager.extractArchive(archivePath, extractDir);
-
-		// Validate extraction
-		await downloadManager.validateExtraction(extractDir);
-
-		// Copy files to target directory
-		const merger = new FileMerger();
-
-		// Apply user exclude patterns if provided
-		if (validOptions.exclude && validOptions.exclude.length > 0) {
-			merger.addIgnorePatterns(validOptions.exclude);
-		}
-
-		await merger.merge(extractDir, resolvedDir, true); // Skip confirmation for new projects
-
-		prompts.outro(`✨ Project created successfully at ${resolvedDir}`);
-
-		// Show next steps
-		prompts.note(
-			`cd ${targetDir !== "." ? targetDir : "into the directory"}\nbun install\nbun run dev`,
-			"Next steps",
-		);
-	} catch (error) {
-		logger.error(error instanceof Error ? error.message : "Unknown error occurred");
-		process.exit(1);
-	}
-}

package/src/commands/update.ts

@@ -1,174 +0,0 @@
-import { resolve } from "node:path";
-import { pathExists } from "fs-extra";
-import { AuthManager } from "../lib/auth.js";
-import { DownloadManager } from "../lib/download.js";
-import { GitHubClient } from "../lib/github.js";
-import { FileMerger } from "../lib/merge.js";
-import { PromptsManager } from "../lib/prompts.js";
-import { AVAILABLE_KITS, type UpdateCommandOptions, UpdateCommandOptionsSchema } from "../types.js";
-import { ConfigManager } from "../utils/config.js";
-import { FileScanner } from "../utils/file-scanner.js";
-import { logger } from "../utils/logger.js";
-import { createSpinner } from "../utils/safe-spinner.js";
-
-export async function updateCommand(options: UpdateCommandOptions): Promise<void> {
-	const prompts = new PromptsManager();
-
-	prompts.intro("🔄 ClaudeKit - Update Project");
-
-	try {
-		// Validate and parse options
-		const validOptions = UpdateCommandOptionsSchema.parse(options);
-
-		// Load config for defaults
-		const config = await ConfigManager.get();
-
-		// Get kit selection
-		let kit = validOptions.kit || config.defaults?.kit;
-		if (!kit) {
-			kit = await prompts.selectKit();
-		}
-
-		const kitConfig = AVAILABLE_KITS[kit];
-		logger.info(`Selected kit: ${kitConfig.name}`);
-
-		// Get target directory
-		let targetDir = validOptions.dir || config.defaults?.dir || ".";
-		if (!validOptions.dir && !config.defaults?.dir) {
-			targetDir = await prompts.getDirectory(targetDir);
-		}
-
-		const resolvedDir = resolve(targetDir);
-		logger.info(`Target directory: ${resolvedDir}`);
-
-		// Check if directory exists
-		if (!(await pathExists(resolvedDir))) {
-			logger.error(`Directory does not exist: ${resolvedDir}`);
-			logger.info('Use "ck new" to create a new project');
-			return;
-		}
-
-		// Initialize GitHub client
-		const github = new GitHubClient();
-
-		// Check repository access
-		const spinner = createSpinner("Checking repository access...").start();
-		const hasAccess = await github.checkAccess(kitConfig);
-		if (!hasAccess) {
-			spinner.fail("Access denied to repository");
-			logger.error(
-				`Cannot access ${kitConfig.name}. Make sure your GitHub token has access to private repositories.`,
-			);
-			return;
-		}
-		spinner.succeed("Repository access verified");
-
-		// Get release
-		let release;
-		if (validOptions.version) {
-			logger.info(`Fetching release version: ${validOptions.version}`);
-			release = await github.getReleaseByTag(kitConfig, validOptions.version);
-		} else {
-			logger.info("Fetching latest release...");
-			release = await github.getLatestRelease(kitConfig);
-		}
-
-		logger.success(`Found release: ${release.tag_name} - ${release.name}`);
-
-		// Get downloadable asset (custom asset or GitHub tarball)
-		const downloadInfo = GitHubClient.getDownloadableAsset(release);
-
-		logger.info(`Download source: ${downloadInfo.type}`);
-		logger.debug(`Download URL: ${downloadInfo.url}`);
-
-		// Download asset
-		const downloadManager = new DownloadManager();
-
-		// Apply user exclude patterns if provided
-		if (validOptions.exclude && validOptions.exclude.length > 0) {
-			downloadManager.setExcludePatterns(validOptions.exclude);
-		}
-
-		const tempDir = await downloadManager.createTempDir();
-
-		// Get authentication token for API requests
-		const { token } = await AuthManager.getToken();
-
-		let archivePath: string;
-		try {
-			// Try downloading the asset/tarball with authentication
-			archivePath = await downloadManager.downloadFile({
-				url: downloadInfo.url,
-				name: downloadInfo.name,
-				size: downloadInfo.size,
-				destDir: tempDir,
-				token, // Always pass token for private repository access
-			});
-		} catch (error) {
-			// If asset download fails, fallback to GitHub tarball
-			if (downloadInfo.type === "asset") {
-				logger.warning("Asset download failed, falling back to GitHub tarball...");
-				const tarballInfo = {
-					type: "github-tarball" as const,
-					url: release.tarball_url,
-					name: `${kitConfig.repo}-${release.tag_name}.tar.gz`,
-					size: 0, // Size unknown for tarball
-				};
-
-				archivePath = await downloadManager.downloadFile({
-					url: tarballInfo.url,
-					name: tarballInfo.name,
-					size: tarballInfo.size,
-					destDir: tempDir,
-					token,
-				});
-			} else {
-				throw error;
-			}
-		}
-
-		// Extract archive
-		const extractDir = `${tempDir}/extracted`;
-		await downloadManager.extractArchive(archivePath, extractDir);
-
-		// Validate extraction
-		await downloadManager.validateExtraction(extractDir);
-
-		// Identify custom .claude files to preserve
-		logger.info("Scanning for custom .claude files...");
-		const customClaudeFiles = await FileScanner.findCustomFiles(resolvedDir, extractDir, ".claude");
-
-		// Merge files with confirmation
-		const merger = new FileMerger();
-
-		// Add custom .claude files to ignore patterns
-		if (customClaudeFiles.length > 0) {
-			merger.addIgnorePatterns(customClaudeFiles);
-			logger.success(`Protected ${customClaudeFiles.length} custom .claude file(s)`);
-		}
-
-		// Apply user exclude patterns if provided
-		if (validOptions.exclude && validOptions.exclude.length > 0) {
-			merger.addIgnorePatterns(validOptions.exclude);
-		}
-
-		await merger.merge(extractDir, resolvedDir, false); // Show confirmation for updates
-
-		prompts.outro(`✨ Project updated successfully at ${resolvedDir}`);
-
-		// Show next steps
-		const protectedNote =
-			customClaudeFiles.length > 0
-				? "Your project has been updated with the latest version.\nProtected files (.env, .claude custom files, etc.) were not modified."
-				: "Your project has been updated with the latest version.\nProtected files (.env, etc.) were not modified.";
-
-		prompts.note(protectedNote, "Update complete");
-	} catch (error) {
-		if (error instanceof Error && error.message === "Merge cancelled by user") {
-			logger.warning("Update cancelled");
-			return;
-		}
-		logger.error(error instanceof Error ? error.message : "Unknown error occurred");
-		process.exit(1);
-	}
-}

package/src/commands/version.ts

@@ -1,135 +0,0 @@
-import pc from "picocolors";
-import { GitHubClient } from "../lib/github.js";
-import { PromptsManager } from "../lib/prompts.js";
-import {
-	AVAILABLE_KITS,
-	type GitHubRelease,
-	type VersionCommandOptions,
-	VersionCommandOptionsSchema,
-} from "../types.js";
-import { logger } from "../utils/logger.js";
-
-/**
- * Format a date as a relative time string
- */
-function formatRelativeTime(dateString?: string): string {
-	if (!dateString) return "Unknown";
-
-	const date = new Date(dateString);
-	const now = new Date();
-	const diffMs = now.getTime() - date.getTime();
-	const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
-
-	if (diffDays === 0) return "Today";
-	if (diffDays === 1) return "Yesterday";
-	if (diffDays < 7) return `${diffDays} days ago`;
-	if (diffDays < 30) return `${Math.floor(diffDays / 7)} weeks ago`;
-	if (diffDays < 365) return `${Math.floor(diffDays / 30)} months ago`;
-	return `${Math.floor(diffDays / 365)} years ago`;
-}
-
-/**
- * Display releases for a single kit
- */
-function displayKitReleases(kitName: string, releases: GitHubRelease[]): void {
-	console.log(`\n${pc.bold(pc.cyan(kitName))} - Available Versions:\n`);
-
-	if (releases.length === 0) {
-		console.log(pc.dim("  No releases found"));
-		return;
-	}
-
-	for (const release of releases) {
-		const version = pc.green(release.tag_name);
-		const name = release.name || "No title";
-		const publishedAt = formatRelativeTime(release.published_at);
-		const assetCount = release.assets.length;
-
-		// Add badges for prerelease and draft
-		const badges: string[] = [];
-		if (release.prerelease) badges.push(pc.yellow("[prerelease]"));
-		if (release.draft) badges.push(pc.gray("[draft]"));
-		const badgeStr = badges.length > 0 ? ` ${badges.join(" ")}` : "";
-
-		// Format: version  |  name  |  time  |  assets
-		const versionPart = version.padEnd(20);
-		const namePart = name.length > 40 ? `${name.slice(0, 37)}...` : name.padEnd(40);
-		const timePart = pc.dim(publishedAt.padEnd(20));
-		const assetPart = pc.dim(`(${assetCount} ${assetCount === 1 ? "asset" : "assets"})`);
-
-		console.log(`  ${versionPart}  ${namePart}  ${timePart}  ${assetPart}${badgeStr}`);
-	}
-
-	console.log(
-		pc.dim(`\nShowing ${releases.length} ${releases.length === 1 ? "release" : "releases"}`),
-	);
-}
-
-/**
- * Version command - List available versions of ClaudeKit repositories
- */
-export async function versionCommand(options: VersionCommandOptions): Promise<void> {
-	const prompts = new PromptsManager();
-
-	prompts.intro("📦 ClaudeKit - Available Versions");
-
-	try {
-		// Validate and parse options
-		const validOptions = VersionCommandOptionsSchema.parse(options);
-
-		// Determine which kits to fetch
-		const kitsToFetch = validOptions.kit
-			? [validOptions.kit]
-			: (Object.keys(AVAILABLE_KITS) as Array<keyof typeof AVAILABLE_KITS>);
-
-		// Initialize GitHub client
-		const github = new GitHubClient();
-
-		// Determine limit (default to 30, similar to GitHub CLI)
-		const limit = validOptions.limit || 30;
-
-		// Fetch releases for all requested kits in parallel
-		const releasePromises = kitsToFetch.map(async (kitType) => {
-			const kitConfig = AVAILABLE_KITS[kitType];
-			try {
-				const releases = await github.listReleases(kitConfig, limit);
-
-				// Filter out drafts and prereleases unless --all flag is set
-				const filteredReleases = validOptions.all
-					? releases
-					: releases.filter((r) => !r.draft && !r.prerelease);
-
-				return {
-					kitType,
-					kitConfig,
-					releases: filteredReleases,
-					error: null,
-				};
-			} catch (error) {
-				return {
-					kitType,
-					kitConfig,
-					releases: [],
-					error: error instanceof Error ? error.message : "Unknown error",
-				};
-			}
-		});
-
-		const results = await Promise.all(releasePromises);
-
-		// Display results
-		for (const result of results) {
-			if (result.error) {
-				console.log(`\n${pc.bold(pc.cyan(result.kitConfig.name))} - ${pc.red("Error")}`);
-				console.log(pc.dim(`  ${result.error}`));
-			} else {
-				displayKitReleases(result.kitConfig.name, result.releases);
-			}
-		}
-
-		prompts.outro("✨ Done");
-	} catch (error) {
-		logger.error(error instanceof Error ? error.message : "Unknown error occurred");
-		process.exit(1);
-	}
-}

package/src/index.ts

@@ -1,102 +0,0 @@
-#!/usr/bin/env bun
-
-import { cac } from "cac";
-import packageInfo from "../package.json" assert { type: "json" };
-import { newCommand } from "./commands/new.js";
-import { updateCommand } from "./commands/update.js";
-import { versionCommand } from "./commands/version.js";
-import { logger } from "./utils/logger.js";
-
-// Set proper output encoding to prevent unicode rendering issues
-if (process.stdout.setEncoding) {
-	process.stdout.setEncoding("utf8");
-}
-if (process.stderr.setEncoding) {
-	process.stderr.setEncoding("utf8");
-}
-
-const packageVersion = packageInfo.version;
-
-const cli = cac("ck");
-
-// Global options
-cli.option("--verbose, -v", "Enable verbose logging for debugging");
-cli.option("--log-file <path>", "Write logs to file");
-
-// New command
-cli
-	.command("new", "Bootstrap a new ClaudeKit project")
-	.option("--dir <dir>", "Target directory (default: .)")
-	.option("--kit <kit>", "Kit to use (engineer, marketing)")
-	.option("--version <version>", "Specific version to download (default: latest)")
-	.option("--force", "Overwrite existing files without confirmation")
-	.option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)")
-	.action(async (options) => {
-		// Normalize exclude to always be an array (CAC may pass string for single value)
-		if (options.exclude && !Array.isArray(options.exclude)) {
-			options.exclude = [options.exclude];
-		}
-		await newCommand(options);
-	});
-
-// Update command
-cli
-	.command("update", "Update existing ClaudeKit project")
-	.option("--dir <dir>", "Target directory (default: .)")
-	.option("--kit <kit>", "Kit to use (engineer, marketing)")
-	.option("--version <version>", "Specific version to download (default: latest)")
-	.option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)")
-	.action(async (options) => {
-		// Normalize exclude to always be an array (CAC may pass string for single value)
-		if (options.exclude && !Array.isArray(options.exclude)) {
-			options.exclude = [options.exclude];
-		}
-		await updateCommand(options);
-	});
-
-// Versions command
-cli
-	.command("versions", "List available versions of ClaudeKit repositories")
-	.option("--kit <kit>", "Filter by specific kit (engineer, marketing)")
-	.option("--limit <limit>", "Number of releases to show (default: 30)")
-	.option("--all", "Show all releases including prereleases")
-	.action(async (options) => {
-		await versionCommand(options);
-	});
-
-// Version
-cli.version(packageVersion);
-
-// Help
-cli.help();
-
-// Parse to get global options first
-const parsed = cli.parse(process.argv, { run: false });
-
-// Check environment variable
-const envVerbose =
-	process.env.CLAUDEKIT_VERBOSE === "1" || process.env.CLAUDEKIT_VERBOSE === "true";
-
-// Enable verbose if flag or env var is set
-const isVerbose = parsed.options.verbose || envVerbose;
-
-if (isVerbose) {
-	logger.setVerbose(true);
-}
-
-// Set log file if specified
-if (parsed.options.logFile) {
-	logger.setLogFile(parsed.options.logFile);
-}
-
-// Log startup info in verbose mode
-logger.verbose("ClaudeKit CLI starting", {
-	version: packageVersion,
-	command: parsed.args[0] || "none",
-	options: parsed.options,
-	cwd: process.cwd(),
-	node: process.version,
-});
-
-// Parse again to run the command
-cli.parse();