@raftlabs/raftstack 1.8.0 → 1.9.1

package/dist/cli.js

@@ -1650,14 +1650,65 @@ async function generateClaudeSkills(targetDir, options) {
   return result;
 }
 
-// src/generators/eslint.ts
+// src/generators/claude-commands.ts
 import { existsSync as existsSync6 } from "fs";
+import { readdir as readdir2, copyFile as copyFile3 } from "fs/promises";
+import { join as join16, dirname as dirname3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function getPackageCommandsDir() {
+  const currentFilePath = fileURLToPath2(import.meta.url);
+  const packageRoot = join16(dirname3(currentFilePath), "..");
+  return join16(packageRoot, ".claude", "commands");
+}
+async function copyDirectory2(srcDir, destDir, result, baseDir) {
+  await ensureDir(destDir);
+  const entries = await readdir2(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join16(srcDir, entry.name);
+    const destPath = join16(destDir, entry.name);
+    const relativePath = destPath.replace(baseDir + "/", "");
+    if (entry.isDirectory()) {
+      await copyDirectory2(srcPath, destPath, result, baseDir);
+    } else {
+      if (existsSync6(destPath)) {
+        const backupPath = await backupFile(destPath);
+        if (backupPath) {
+          result.backedUp.push(relativePath);
+        }
+      }
+      await copyFile3(srcPath, destPath);
+      result.created.push(relativePath);
+    }
+  }
+}
+async function generateClaudeCommands(targetDir) {
+  const result = {
+    created: [],
+    modified: [],
+    skipped: [],
+    backedUp: []
+  };
+  const packageCommandsDir = getPackageCommandsDir();
+  const targetCommandsDir = join16(targetDir, ".claude", "commands");
+  if (!existsSync6(packageCommandsDir)) {
+    console.warn(
+      "Warning: Commands directory not found in package. Skipping commands generation."
+    );
+    return result;
+  }
+  await ensureDir(join16(targetDir, ".claude"));
+  await copyDirectory2(packageCommandsDir, targetCommandsDir, result, targetDir);
+  return result;
+}
+
+// src/generators/eslint.ts
+import { existsSync as existsSync7 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 async function hasReact(targetDir) {
   try {
-    const pkgPath = join16(targetDir, "package.json");
-    if (existsSync6(pkgPath)) {
+    const pkgPath = join17(targetDir, "package.json");
+    if (existsSync7(pkgPath)) {
       const content = await readFile4(pkgPath, "utf-8");
       const pkg = JSON.parse(content);
       const deps = { ...pkg.dependencies, ...pkg.devDependencies };
@@ -1669,8 +1720,8 @@ async function hasReact(targetDir) {
 }
 async function hasNextJs(targetDir) {
   try {
-    const pkgPath = join16(targetDir, "package.json");
-    if (existsSync6(pkgPath)) {
+    const pkgPath = join17(targetDir, "package.json");
+    if (existsSync7(pkgPath)) {
       const content = await readFile4(pkgPath, "utf-8");
       const pkg = JSON.parse(content);
       const deps = { ...pkg.dependencies, ...pkg.devDependencies };
@@ -1949,7 +2000,7 @@ async function generateEslint(targetDir, usesTypeScript, force = false) {
   } else {
     config = generateJsConfig();
   }
-  const configPath = join16(targetDir, "eslint.config.mjs");
+  const configPath = join17(targetDir, "eslint.config.mjs");
   const writeResult = await writeFileSafe(configPath, config);
   if (writeResult.backedUp) {
     result.backedUp.push("eslint.config.mjs");
@@ -1959,7 +2010,7 @@ async function generateEslint(targetDir, usesTypeScript, force = false) {
 }
 
 // src/generators/quick-reference.ts
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 async function generateQuickReference(targetDir, pm) {
   const result = {
     created: [],
@@ -1967,7 +2018,7 @@ async function generateQuickReference(targetDir, pm) {
     skipped: [],
     backedUp: []
   };
-  const quickRefPath = join17(targetDir, ".github", "QUICK_REFERENCE.md");
+  const quickRefPath = join18(targetDir, ".github", "QUICK_REFERENCE.md");
   const content = `# RaftStack Quick Reference
 
 > One-page guide for the RaftStack Git workflow
@@ -2101,7 +2152,7 @@ ${pm.run} test
 }
 
 // src/generators/shared-configs.ts
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 function getEslintConfigPackageJson() {
   return JSON.stringify(
     {
@@ -2367,15 +2418,15 @@ async function generateSharedConfigs(targetDir, projectType) {
   if (!isMonorepo(projectType)) {
     return result;
   }
-  const packagesDir = join18(targetDir, "packages");
-  const eslintConfigDir = join18(packagesDir, "eslint-config");
+  const packagesDir = join19(targetDir, "packages");
+  const eslintConfigDir = join19(packagesDir, "eslint-config");
   await ensureDir(eslintConfigDir);
   const eslintFiles = [
-    { path: join18(eslintConfigDir, "package.json"), content: getEslintConfigPackageJson(), name: "packages/eslint-config/package.json" },
-    { path: join18(eslintConfigDir, "base.js"), content: getBaseEslintConfig(), name: "packages/eslint-config/base.js" },
-    { path: join18(eslintConfigDir, "next.js"), content: getNextJsEslintConfig(), name: "packages/eslint-config/next.js" },
-    { path: join18(eslintConfigDir, "react-internal.js"), content: getReactInternalEslintConfig(), name: "packages/eslint-config/react-internal.js" },
-    { path: join18(eslintConfigDir, "vite.js"), content: getViteEslintConfig(), name: "packages/eslint-config/vite.js" }
+    { path: join19(eslintConfigDir, "package.json"), content: getEslintConfigPackageJson(), name: "packages/eslint-config/package.json" },
+    { path: join19(eslintConfigDir, "base.js"), content: getBaseEslintConfig(), name: "packages/eslint-config/base.js" },
+    { path: join19(eslintConfigDir, "next.js"), content: getNextJsEslintConfig(), name: "packages/eslint-config/next.js" },
+    { path: join19(eslintConfigDir, "react-internal.js"), content: getReactInternalEslintConfig(), name: "packages/eslint-config/react-internal.js" },
+    { path: join19(eslintConfigDir, "vite.js"), content: getViteEslintConfig(), name: "packages/eslint-config/vite.js" }
   ];
   for (const file of eslintFiles) {
     const writeResult = await writeFileSafe(file.path, file.content, { backup: true });
@@ -2386,14 +2437,14 @@ async function generateSharedConfigs(targetDir, projectType) {
       }
     }
   }
-  const tsConfigDir = join18(packagesDir, "typescript-config");
+  const tsConfigDir = join19(packagesDir, "typescript-config");
   await ensureDir(tsConfigDir);
   const tsFiles = [
-    { path: join18(tsConfigDir, "package.json"), content: getTsConfigPackageJson(), name: "packages/typescript-config/package.json" },
-    { path: join18(tsConfigDir, "base.json"), content: getBaseTsConfig(), name: "packages/typescript-config/base.json" },
-    { path: join18(tsConfigDir, "nextjs.json"), content: getNextJsTsConfig(), name: "packages/typescript-config/nextjs.json" },
-    { path: join18(tsConfigDir, "react-library.json"), content: getReactLibraryTsConfig(), name: "packages/typescript-config/react-library.json" },
-    { path: join18(tsConfigDir, "node-library.json"), content: getNodeLibraryTsConfig(), name: "packages/typescript-config/node-library.json" }
+    { path: join19(tsConfigDir, "package.json"), content: getTsConfigPackageJson(), name: "packages/typescript-config/package.json" },
+    { path: join19(tsConfigDir, "base.json"), content: getBaseTsConfig(), name: "packages/typescript-config/base.json" },
+    { path: join19(tsConfigDir, "nextjs.json"), content: getNextJsTsConfig(), name: "packages/typescript-config/nextjs.json" },
+    { path: join19(tsConfigDir, "react-library.json"), content: getReactLibraryTsConfig(), name: "packages/typescript-config/react-library.json" },
+    { path: join19(tsConfigDir, "node-library.json"), content: getNodeLibraryTsConfig(), name: "packages/typescript-config/node-library.json" }
   ];
   for (const file of tsFiles) {
     const writeResult = await writeFileSafe(file.path, file.content, { backup: true });
@@ -2409,10 +2460,10 @@ async function generateSharedConfigs(targetDir, projectType) {
 
 // src/utils/git.ts
 import { execa } from "execa";
-import { existsSync as existsSync7 } from "fs";
-import { join as join19 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { join as join20 } from "path";
 async function isGitRepo(targetDir = process.cwd()) {
-  if (existsSync7(join19(targetDir, ".git"))) {
+  if (existsSync8(join20(targetDir, ".git"))) {
     return true;
   }
   try {
@@ -2548,8 +2599,8 @@ async function runInit(targetDir = process.cwd()) {
     );
     installFailed = true;
   }
-  const spinner4 = p2.spinner();
-  spinner4.start("Generating configuration files...");
+  const spinner5 = p2.spinner();
+  spinner5.start("Generating configuration files...");
   const results = [];
   try {
     results.push(
@@ -2584,10 +2635,11 @@ async function runInit(targetDir = process.cwd()) {
     results.push(await generateClaudeSkills(targetDir, {
       includeAsana: !!config.asanaBaseUrl
     }));
+    results.push(await generateClaudeCommands(targetDir));
     results.push(await updateProjectPackageJson(targetDir, config));
-    spinner4.stop("Configuration files generated!");
+    spinner5.stop("Configuration files generated!");
   } catch (error) {
-    spinner4.stop("Error generating files");
+    spinner5.stop("Error generating files");
     p2.log.error(
       pc2.red(
         `Error: ${error instanceof Error ? error.message : "Unknown error"}`
@@ -2735,11 +2787,11 @@ async function applyMergeStrategy(owner, repo, settings) {
 async function runSetupProtection(targetDir = process.cwd()) {
   console.log();
   p3.intro(pc3.bgCyan(pc3.black(" Branch Protection Setup ")));
-  const spinner4 = p3.spinner();
-  spinner4.start("Checking GitHub CLI...");
+  const spinner5 = p3.spinner();
+  spinner5.start("Checking GitHub CLI...");
   const ghAvailable = await isGhCliAvailable();
   if (!ghAvailable) {
-    spinner4.stop("GitHub CLI not found or not authenticated");
+    spinner5.stop("GitHub CLI not found or not authenticated");
     console.log();
     p3.log.error(pc3.red("The GitHub CLI (gh) is required for this command."));
     p3.log.info("Install it from: https://cli.github.com/");
@@ -2752,18 +2804,18 @@ async function runSetupProtection(targetDir = process.cwd()) {
     );
     process.exit(1);
   }
-  spinner4.stop("GitHub CLI ready");
-  spinner4.start("Getting repository info...");
+  spinner5.stop("GitHub CLI ready");
+  spinner5.start("Getting repository info...");
   const repoInfo = await getGitHubRepoInfo(targetDir);
   if (!repoInfo) {
-    spinner4.stop("Could not determine repository");
+    spinner5.stop("Could not determine repository");
     p3.log.error(
       pc3.red("Could not determine the GitHub repository for this directory.")
     );
     p3.log.info("Make sure you're in a git repository with a GitHub remote.");
     process.exit(1);
   }
-  spinner4.stop(`Repository: ${pc3.cyan(`${repoInfo.owner}/${repoInfo.repo}`)}`);
+  spinner5.stop(`Repository: ${pc3.cyan(`${repoInfo.owner}/${repoInfo.repo}`)}`);
   const branches = await p3.multiselect({
     message: "Which branches need protection?",
     options: [
@@ -2852,13 +2904,13 @@ async function runSetupProtection(targetDir = process.cwd()) {
     p3.cancel("Setup cancelled.");
     process.exit(0);
   }
-  spinner4.start("Configuring merge strategy...");
+  spinner5.start("Configuring merge strategy...");
   try {
     const repoSettings = getMergeStrategySettings(mergeStrategy);
     await applyMergeStrategy(repoInfo.owner, repoInfo.repo, repoSettings);
-    spinner4.stop("Merge strategy configured!");
+    spinner5.stop("Merge strategy configured!");
   } catch (error) {
-    spinner4.stop("Failed to configure merge strategy");
+    spinner5.stop("Failed to configure merge strategy");
     const errorMsg = error instanceof Error ? error.message : "Unknown error";
     p3.log.warn(pc3.yellow(`Warning: Could not set merge strategy: ${errorMsg}`));
     p3.log.info(pc3.dim("Continuing with branch protection..."));
@@ -2866,16 +2918,16 @@ async function runSetupProtection(targetDir = process.cwd()) {
   const protectedBranches = [];
   const failedBranches = [];
   for (const branch of branches) {
-    spinner4.start(`Protecting branch: ${branch}...`);
+    spinner5.start(`Protecting branch: ${branch}...`);
     try {
       const settings = getDefaultSettings(branch);
       settings.requiredReviews = requiredReviews;
       await applyBranchProtection(repoInfo.owner, repoInfo.repo, settings);
       protectedBranches.push(branch);
-      spinner4.stop(`Protected: ${pc3.green(branch)}`);
+      spinner5.stop(`Protected: ${pc3.green(branch)}`);
     } catch (error) {
       failedBranches.push(branch);
-      spinner4.stop(`Failed: ${pc3.red(branch)}`);
+      spinner5.stop(`Failed: ${pc3.red(branch)}`);
       const errorMsg = error instanceof Error ? error.message : "Unknown error";
       p3.log.warn(
         pc3.yellow(
@@ -3398,8 +3450,8 @@ async function runMetrics(targetDir, options = {}) {
     selectedDays = daysOption;
   }
   const analyzeDays = selectedDays || 30;
-  const spinner4 = ciMode ? null : p4.spinner();
-  spinner4?.start("Analyzing repository...");
+  const spinner5 = ciMode ? null : p4.spinner();
+  spinner5?.start("Analyzing repository...");
   let overallCompliance = 100;
   const complianceScores = [];
   if (showGit) {
@@ -3420,7 +3472,7 @@ async function runMetrics(targetDir, options = {}) {
       conventionalCompliance,
       branchMetrics.branchCompliance
     );
-    spinner4?.stop("Git analysis complete");
+    spinner5?.stop("Git analysis complete");
     if (ciMode) {
       console.log("\n=== GIT METRICS ===");
       console.log(`Commits (last ${analyzeDays} days): ${totalCommits}`);
@@ -3478,13 +3530,13 @@ ${pc4.bold("Branches")}
   }
   if (showCode) {
     if (!ciMode && showGit) {
-      spinner4?.start("Analyzing codebase...");
+      spinner5?.start("Analyzing codebase...");
     } else if (!ciMode) {
-      spinner4?.start("Analyzing codebase...");
+      spinner5?.start("Analyzing codebase...");
     }
     const codebaseMetrics = await analyzeCodebase(targetDir);
     complianceScores.push(codebaseMetrics.overallCompliance);
-    spinner4?.stop("Codebase analysis complete");
+    spinner5?.stop("Codebase analysis complete");
     if (ciMode) {
       console.log("\n=== CODEBASE METRICS ===");
       console.log(`Files analyzed: ${codebaseMetrics.filesAnalyzed}`);
@@ -3528,10 +3580,60 @@ PASSED: Compliance meets threshold`);
   }
 }
 
+// src/commands/install-commands.ts
+import * as p5 from "@clack/prompts";
+import pc5 from "picocolors";
+async function runInstallCommands(targetDir = process.cwd()) {
+  p5.intro(pc5.cyan("RaftStack: Install Claude Code commands and skills"));
+  const spinner5 = p5.spinner();
+  spinner5.start("Installing Claude Code commands and skills...");
+  try {
+    const commandsResult = await generateClaudeCommands(targetDir);
+    const skillsResult = await generateClaudeSkills(targetDir);
+    spinner5.stop("Claude Code commands and skills installed!");
+    const created = [...commandsResult.created, ...skillsResult.created];
+    const backedUp = [...commandsResult.backedUp, ...skillsResult.backedUp];
+    console.log();
+    if (created.length > 0) {
+      p5.log.success(pc5.green("Installed files:"));
+      for (const file of created) {
+        console.log(`  ${pc5.dim("+")} ${file}`);
+      }
+    }
+    if (backedUp.length > 0) {
+      console.log();
+      p5.log.info(pc5.dim("Backed up existing files:"));
+      for (const file of backedUp) {
+        console.log(`  ${pc5.dim("\u2192")} ${file}.backup`);
+      }
+    }
+    console.log();
+    p5.note(
+      [
+        `${pc5.cyan("/raftstack/init-context")} - Analyze codebase, generate constitution`,
+        `${pc5.cyan("/raftstack/shape")} - Plan features with adaptive depth`,
+        `${pc5.cyan("/raftstack/discover")} - Extract patterns into standards`,
+        `${pc5.cyan("/raftstack/inject")} - Surface relevant context for tasks`,
+        `${pc5.cyan("/raftstack/index")} - Maintain standards registry`
+      ].join("\n"),
+      "Available Commands"
+    );
+    p5.outro(pc5.green("Ready to use! Try /raftstack/init-context to get started."));
+  } catch (error) {
+    spinner5.stop("Error installing commands");
+    p5.log.error(
+      pc5.red(
+        `Error: ${error instanceof Error ? error.message : "Unknown error"}`
+      )
+    );
+    process.exit(1);
+  }
+}
+
 // package.json
 var package_default = {
   name: "@raftlabs/raftstack",
-  version: "1.8.0",
+  version: "1.9.1",
   description: "CLI tool for setting up Git hooks, commit conventions, and GitHub integration",
   type: "module",
   main: "./dist/index.js",
@@ -3548,7 +3650,8 @@ var package_default = {
   files: [
     "dist",
     "templates",
-    ".claude/skills"
+    ".claude/skills",
+    ".claude/commands"
   ],
   scripts: {
     build: "tsup",
@@ -3636,5 +3739,8 @@ program.command("metrics").description("Analyze repository compliance with RaftS
     });
   }
 );
+program.command("install-commands").description("Install or update Claude Code commands and skills").action(async () => {
+  await runInstallCommands(process.cwd());
+});
 program.parse();
 //# sourceMappingURL=cli.js.map