vibe-cokit 1.2.0 → 1.3.0

package/dist/cli.js

@@ -894,6 +894,239 @@ vibe-cokit skills
   }
 }
 
+// src/commands/help.ts
+var HELP_TEXT = `
+vibe-cokit v${version} \u2014 A toolkit for interacting with Claude Code
+
+USAGE
+  vk <command> [options]
+
+COMMANDS
+  init              Set up vibe-cokit for the current project
+                    Clones config repo, copies agents/commands/hooks/prompts/workflows
+                    to ~/.claude/, adds CLAUDE.md to current directory, runs claude init
+
+  update [ref]      Update vibe-cokit config to latest or specific version
+                    Compares local version with remote, skips if already up-to-date
+                    Aliases: upgrade
+
+  skills [ref]      Install or update skills from vibe-cokit skills repo
+                    Copies skill folders to ~/.claude/skills/
+                    Tracks version separately via skillsVersion in settings.json
+
+  help              Show this detailed usage guide
+
+  version           Show version and installed commit IDs
+
+  doctor            Check vibe-cokit setup health
+  doctor --fix      Auto-fix missing config, skills, or CLAUDE.md
+
+EXAMPLES
+  vk init                    # Initialize vibe-cokit in current project
+  vk update                  # Update config to latest version
+  vk update v1.2.0           # Update to specific tag
+  vk skills                  # Install/update all skills
+  vk skills main             # Install skills from specific branch
+  vk version                 # Show version and commit IDs
+  vk doctor                  # Health check setup
+  vk doctor --fix            # Auto-fix setup issues
+
+OPTIONS
+  -h, --help        Show brief help
+  -v, --version     Show version number
+
+PREREQUISITES
+  gh                GitHub CLI (https://cli.github.com)
+  git               Git version control
+
+FILES
+  ~/.claude/        Config directory (agents, commands, hooks, prompts, workflows)
+  ~/.claude/skills/ Skills directory
+  ./CLAUDE.md       Project-level Claude config (created by init)
+`;
+function helpCommand() {
+  console.log(HELP_TEXT);
+}
+
+// src/commands/version.ts
+async function versionCommand() {
+  const commitSha = await getCurrentVersion();
+  const skillsSha = await getSkillsVersion();
+  console.log(`
+vibe-cokit v${version}`);
+  if (commitSha) {
+    console.log(`  Config commit:  ${commitSha.slice(0, 10)}`);
+  } else {
+    console.log(`  Config commit:  not installed`);
+  }
+  if (skillsSha) {
+    console.log(`  Skills commit:  ${skillsSha.slice(0, 10)}`);
+  } else {
+    console.log(`  Skills commit:  not installed`);
+  }
+  console.log();
+}
+
+// src/commands/doctor.ts
+import { execFile as execFile4 } from "child_process";
+import { promisify as promisify4 } from "util";
+import { join as join5 } from "path";
+var exec4 = promisify4(execFile4);
+async function checkBin(name) {
+  try {
+    const { stdout } = await exec4(name, ["--version"]);
+    return stdout.trim().split(`
+`)[0] ?? null;
+  } catch {
+    return null;
+  }
+}
+async function doctorCommand() {
+  console.log(`
+vibe-cokit doctor
+`);
+  let issues = 0;
+  const tools = ["gh", "git", "claude"];
+  for (const tool of tools) {
+    const ver = await checkBin(tool);
+    if (ver) {
+      console.log(`  \u2713 ${tool}: ${ver}`);
+    } else {
+      console.log(`  \u2717 ${tool}: not found`);
+      issues++;
+    }
+  }
+  console.log();
+  if (await dirExists(CLAUDE_DIR)) {
+    console.log(`  \u2713 ~/.claude/ exists`);
+  } else {
+    console.log(`  \u2717 ~/.claude/ not found \u2014 run \`vk init\``);
+    issues++;
+  }
+  for (const folder of CONFIG_FOLDERS) {
+    const path = join5(CLAUDE_DIR, folder);
+    if (await dirExists(path)) {
+      console.log(`  \u2713 ~/.claude/${folder}/`);
+    } else {
+      console.log(`  \u2717 ~/.claude/${folder}/ missing`);
+      issues++;
+    }
+  }
+  if (await dirExists(SKILLS_DIR)) {
+    console.log(`  \u2713 ~/.claude/skills/`);
+  } else {
+    console.log(`  \u2717 ~/.claude/skills/ missing \u2014 run \`vk skills\``);
+    issues++;
+  }
+  const settingsPath = join5(CLAUDE_DIR, "settings.json");
+  if (await fileExists(settingsPath)) {
+    console.log(`  \u2713 ~/.claude/settings.json`);
+  } else {
+    console.log(`  \u2717 ~/.claude/settings.json missing`);
+    issues++;
+  }
+  console.log();
+  const configVersion = await getCurrentVersion();
+  const skillsVersion = await getSkillsVersion();
+  console.log(`  Config version:  ${configVersion ? configVersion.slice(0, 10) : "not installed"}`);
+  console.log(`  Skills version:  ${skillsVersion ? skillsVersion.slice(0, 10) : "not installed"}`);
+  const claudeMdExists = await fileExists(join5(process.cwd(), "CLAUDE.md"));
+  console.log(`  Project CLAUDE.md: ${claudeMdExists ? "found" : "not found"}`);
+  console.log();
+  if (issues === 0) {
+    console.log(`  \u2713 All checks passed!
+`);
+  } else {
+    console.log(`  \u26A0 ${issues} issue${issues > 1 ? "s" : ""} found
+`);
+  }
+}
+
+// src/commands/doctor-fix.ts
+import { join as join6 } from "path";
+async function doctorFixCommand() {
+  console.log(`
+vibe-cokit doctor fix
+`);
+  try {
+    log("Verifying prerequisites...");
+    await verifyPrerequisites();
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`
+\u2717 Cannot fix: ${msg}
+`);
+    process.exit(1);
+  }
+  let fixed = 0;
+  const configMissing = !await dirExists(CLAUDE_DIR) || (await Promise.all(CONFIG_FOLDERS.map((f) => dirExists(join6(CLAUDE_DIR, f))))).some((exists) => !exists) || !await getCurrentVersion();
+  if (configMissing) {
+    log("Config missing \u2014 installing...");
+    const tmpDir = join6(TEMP_DIR, crypto.randomUUID());
+    try {
+      await cloneRepo(tmpDir);
+      await copyConfigFolders(tmpDir);
+      const sha = await getCommitSha(tmpDir);
+      await updateSettings(sha);
+      await cleanup(tmpDir);
+      log(`Config installed (${sha.slice(0, 8)})`);
+      fixed++;
+    } catch (err) {
+      await cleanup(tmpDir);
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`  \u2717 Config fix failed: ${msg}`);
+    }
+  } else {
+    log("Config: OK");
+  }
+  const skillsMissing = !await dirExists(SKILLS_DIR) || !await getSkillsVersion();
+  if (skillsMissing) {
+    log("Skills missing \u2014 installing...");
+    const tmpDir = join6(TEMP_DIR, crypto.randomUUID());
+    try {
+      await cloneRepo(tmpDir, SKILLS_REPO);
+      await copySkillFolders(tmpDir);
+      const sha = await getCommitSha(tmpDir);
+      await updateSkillsVersion(sha);
+      await cleanup(tmpDir);
+      log(`Skills installed (${sha.slice(0, 8)})`);
+      fixed++;
+    } catch (err) {
+      await cleanup(tmpDir);
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`  \u2717 Skills fix failed: ${msg}`);
+    }
+  } else {
+    log("Skills: OK");
+  }
+  const claudeMdPath = join6(process.cwd(), "CLAUDE.md");
+  if (!await fileExists(claudeMdPath)) {
+    log("CLAUDE.md missing \u2014 copying...");
+    const tmpDir = join6(TEMP_DIR, crypto.randomUUID());
+    try {
+      await cloneRepo(tmpDir);
+      await copyClaudeMd(tmpDir);
+      await cleanup(tmpDir);
+      log("CLAUDE.md copied to project");
+      fixed++;
+    } catch (err) {
+      await cleanup(tmpDir);
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`  \u2717 CLAUDE.md fix failed: ${msg}`);
+    }
+  } else {
+    log("CLAUDE.md: OK");
+  }
+  console.log();
+  if (fixed > 0) {
+    console.log(`  \u2713 Fixed ${fixed} issue${fixed > 1 ? "s" : ""}!
+`);
+  } else {
+    console.log(`  \u2713 Nothing to fix \u2014 all good!
+`);
+  }
+}
+
 // src/cli.ts
 var cli = dist_default("vibe-cokit");
 cli.command("", "A toolkit for interacting with Claude Code").action(() => {
@@ -902,6 +1135,13 @@ cli.command("", "A toolkit for interacting with Claude Code").action(() => {
 cli.command("init", "Initialize vibe-cokit for current project").action(initCommand);
 cli.command("update [ref]", "Update vibe-cokit to latest or specific version").alias("upgrade").action(updateCommand);
 cli.command("skills [ref]", "Install or update skills from vibe-cokit").action(skillsCommand);
+cli.command("help", "Show detailed usage guide").action(helpCommand);
+cli.command("version", "Show version and installed commit IDs").action(versionCommand);
+cli.command("doctor", "Check vibe-cokit setup health").option("--fix", "Auto-fix missing config, skills, or CLAUDE.md").action((options) => {
+  if (options.fix)
+    return doctorFixCommand();
+  return doctorCommand();
+});
 cli.help();
 cli.version(version);
 cli.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-cokit",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A toolkit for interacting with Claude Code",
   "module": "index.ts",
   "type": "module",