@dzhechkov/skills-bto 1.0.0

package/src/commands/init.js

@@ -0,0 +1,188 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, yellow, cyan, bold, dim,
+  info, success, warn, error: logError, step,
+  copyDirRecursive, copyDirFiltered, fileExists, readJSON,
+  ensureDir, getRelativePaths, getRelativePathsFiltered,
+  createManifest, writeManifest, getTemplatesDir,
+  COMPONENTS, MANIFEST_FILE, getComponentFilter,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Keysarium integration detection
+// ---------------------------------------------------------------------------
+
+const KEYSARIUM_MANIFEST = '.keysarium.json';
+
+/**
+ * Check if @dzhechkov/keysarium is installed in the target directory.
+ * Returns the keysarium manifest or null if not found.
+ */
+function detectKeysarium(targetDir) {
+  const manifestPath = path.join(targetDir, KEYSARIUM_MANIFEST);
+  if (!fileExists(manifestPath)) return null;
+  return readJSON(manifestPath);
+}
+
+/**
+ * Show integration message when keysarium is detected.
+ */
+function showKeysariumIntegration(keysariumManifest) {
+  console.log('');
+  console.log(cyan('  ┌──────────────────────────────────────────────────┐'));
+  console.log(cyan('  │') + bold(' @dzhechkov/keysarium detected!') + '                    ' + cyan('│'));
+  console.log(cyan('  │') + ` Version: ${dim(keysariumManifest.version)}` + ' '.repeat(39 - keysariumManifest.version.length) + cyan('│'));
+  console.log(cyan('  │') + ' BTO will integrate with existing Keysarium setup.  ' + cyan('│'));
+  console.log(cyan('  │') + ' Shared directories: .claude/commands, rules, agents' + cyan('│'));
+  console.log(cyan('  └──────────────────────────────────────────────────┘'));
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Copy a single BTO component from templates to the target directory.
+ * Handles both full-directory (skill) and filtered (commands, rules, agents) components.
+ * Returns array of relative file paths that were installed.
+ */
+function installComponent(key, comp, templatesDir, targetDir) {
+  const src = path.join(templatesDir, comp.src);
+  const dest = path.join(targetDir, comp.src);
+
+  if (!fileExists(src)) {
+    warn(`Template source not found: ${comp.src} — skipping.`);
+    return [];
+  }
+
+  const filterFn = getComponentFilter(comp);
+
+  if (filterFn) {
+    // Filtered component — only copy matching files from shared directory
+    copyDirFiltered(src, dest, filterFn);
+    return getRelativePathsFiltered(dest, filterFn).map((rel) => path.join(comp.src, rel));
+  }
+
+  // Non-filtered component — copy entire directory or file
+  if (comp.isFile) {
+    ensureDir(path.dirname(dest));
+    fs.copyFileSync(src, dest);
+    return [comp.src];
+  }
+
+  copyDirRecursive(src, dest);
+  return getRelativePaths(dest).map((rel) => path.join(comp.src, rel));
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+/**
+ * `@dzhechkov/skills-bto init` — Install the BTO skill pack into the target project.
+ *
+ * @param {object} options
+ * @param {boolean} options.force     — Overwrite existing installation
+ * @param {boolean} options.dryRun    — Preview without writing anything
+ * @param {string}  options.targetDir — Destination project root
+ */
+async function run(options) {
+  const { force, dryRun, targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Check for existing BTO installation ─────────────────────────────
+  if (fileExists(manifestPath)) {
+    if (!force) {
+      warn('BTO skill pack is already installed in this directory.');
+      info(`Run ${cyan('@dzhechkov/skills-bto update')} to update, or use ${yellow('--force')} to overwrite.`);
+      process.exit(1);
+    }
+    warn('Existing BTO installation found — overwriting (--force).');
+  }
+
+  // ── b) Detect keysarium integration ─────────────────────────────────────
+  const keysariumManifest = detectKeysarium(targetDir);
+  if (keysariumManifest) {
+    showKeysariumIntegration(keysariumManifest);
+  }
+
+  // ── c) Determine components ─────────────────────────────────────────────
+  const componentKeys = Object.keys(COMPONENTS);
+  const templatesDir = getTemplatesDir();
+
+  // ── d) Show plan ────────────────────────────────────────────────────────
+  console.log('');
+  info(bold('Installation plan:'));
+  console.log('');
+
+  for (const key of componentKeys) {
+    const comp = COMPONENTS[key];
+    const filterNote = comp.filter ? dim(` (filtered: ${comp.filter}*)`): '';
+    console.log(`  ${green('+')} ${comp.label}${filterNote}`);
+  }
+
+  console.log('');
+
+  if (dryRun) {
+    warn('Dry run — no files were written.');
+    process.exit(0);
+  }
+
+  // ── e) Install components ───────────────────────────────────────────────
+  const totalComponents = componentKeys.length;
+  const installedFiles = [];
+
+  for (let i = 0; i < totalComponents; i++) {
+    const key = componentKeys[i];
+    const comp = COMPONENTS[key];
+    step(i + 1, totalComponents, `Installing ${comp.label}...`);
+
+    const files = installComponent(key, comp, templatesDir, targetDir);
+    installedFiles.push(...files);
+  }
+
+  // ── f) Write manifest ──────────────────────────────────────────────────
+  const pkgPath = path.resolve(__dirname, '../../package.json');
+  const pkg = readJSON(pkgPath);
+  const version = pkg ? pkg.version : '0.0.0';
+
+  const manifest = createManifest(version, componentKeys, installedFiles.sort());
+  writeManifest(targetDir, manifest);
+  info(`Created ${MANIFEST_FILE} manifest`);
+
+  // ── g) Success summary ─────────────────────────────────────────────────
+  console.log('');
+  success(bold('BTO skill pack installed!'));
+  console.log('');
+
+  console.log(bold('Installed components:'));
+  for (const key of componentKeys) {
+    const comp = COMPONENTS[key];
+    console.log(`  ${green('\u2713')} ${comp.label}`);
+  }
+
+  console.log('');
+  console.log(bold('Next steps:'));
+  console.log(`  1. Open ${cyan('Claude Code')} in this directory`);
+  console.log(`  2. Run ${cyan('/bto [description]')} for the full BTO pipeline`);
+  console.log(`  3. Or use individual phases:`);
+  console.log(`     ${cyan('/bto-build')} ${dim('\u2014 Generate skill or command')}`);
+  console.log(`     ${cyan('/bto-test')}  ${dim('\u2014 Multi-agent evaluation')}`);
+  console.log('');
+
+  if (keysariumManifest) {
+    console.log(bold('Integration:'));
+    console.log(`  BTO commands are available alongside your Keysarium pipeline.`);
+    console.log(`  Run ${cyan('@dzhechkov/keysarium list')} to see all components.`);
+    console.log('');
+  }
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/list.js

@@ -0,0 +1,161 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, red, cyan, bold, dim,
+  info, warn, error: logError,
+  fileExists, readManifest, getRelativePaths, getRelativePathsFiltered,
+  COMPONENTS, MANIFEST_FILE, getComponentFilter,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Count files on disk for a given BTO component in the target directory.
+ * Respects the component's filter to only count BTO-owned files.
+ * Returns the number of files that actually exist.
+ */
+function countComponentFiles(comp, targetDir) {
+  const destPath = path.join(targetDir, comp.src);
+
+  if (!fileExists(destPath)) {
+    return 0;
+  }
+
+  if (comp.isFile) {
+    return 1;
+  }
+
+  try {
+    const stat = fs.statSync(destPath);
+    if (stat.isDirectory()) {
+      const filterFn = getComponentFilter(comp);
+      if (filterFn) {
+        return getRelativePathsFiltered(destPath, filterFn).length;
+      }
+      return getRelativePaths(destPath).length;
+    }
+  } catch {
+    return 0;
+  }
+
+  return 0;
+}
+
+/**
+ * Pad or truncate a string to a fixed width.
+ */
+function padRight(str, width) {
+  if (str.length >= width) return str.slice(0, width);
+  return str + ' '.repeat(width - str.length);
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+/**
+ * `@dzhechkov/skills-bto list` — Show installed BTO components and their status.
+ *
+ * @param {object} options
+ * @param {string}  options.targetDir — Project root directory
+ */
+async function run(options) {
+  const { targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Read manifest ───────────────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    warn('BTO skill pack is not installed in this directory.');
+    info(`Run ${cyan('@dzhechkov/skills-bto init')} to install.`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError(`Failed to read ${MANIFEST_FILE} — file may be corrupted.`);
+    process.exit(1);
+  }
+
+  const installedKeys = new Set(manifest.components || []);
+
+  // ── Header ─────────────────────────────────────────────────────────────
+  console.log('');
+  console.log(bold(`@dzhechkov/skills-bto v${manifest.version}`));
+  console.log(`Installed: ${manifest.installedAt ? manifest.installedAt.split('T')[0] : 'unknown'}`);
+  if (manifest.updatedAt) {
+    console.log(`Updated:   ${manifest.updatedAt.split('T')[0]}`);
+  }
+  console.log('');
+
+  // ── b) Component table ─────────────────────────────────────────────────
+  const nameWidth = 28;
+  const statusWidth = 18;
+
+  console.log(
+    padRight(bold('Component'), nameWidth) +
+    padRight(bold('Status'), statusWidth) +
+    bold('Files')
+  );
+  console.log('\u2500'.repeat(55));
+
+  const allKeys = Object.keys(COMPONENTS);
+  let totalFiles = 0;
+
+  for (const key of allKeys) {
+    const comp = COMPONENTS[key];
+    const isInstalled = installedKeys.has(key);
+
+    // ── c) Count actual files on disk ───────────────────────────────────
+    let fileCount = 0;
+    let statusText;
+
+    if (isInstalled) {
+      fileCount = countComponentFiles(comp, targetDir);
+      totalFiles += fileCount;
+
+      if (fileCount > 0) {
+        statusText = green('\u2713 OK');
+      } else {
+        statusText = red('\u2717 Missing');
+      }
+    } else {
+      statusText = dim('\u2717 Not installed');
+    }
+
+    // Extract short label (before the parenthetical)
+    const shortLabel = comp.label.split('(')[0].trim();
+    const filesStr = isInstalled ? `${fileCount} file${fileCount !== 1 ? 's' : ''}` : '';
+    const filterTag = comp.filter ? dim(` [${comp.filter}*]`) : '';
+
+    console.log(
+      padRight(shortLabel, nameWidth) +
+      padRight(statusText, statusWidth + 9) + // +9 to account for ANSI escape codes
+      dim(filesStr) +
+      filterTag
+    );
+  }
+
+  console.log('\u2500'.repeat(55));
+  console.log(
+    padRight(bold('Total'), nameWidth) +
+    padRight('', statusWidth) +
+    bold(`${totalFiles} files`)
+  );
+  console.log('');
+
+  // ── d) Integration info ─────────────────────────────────────────────────
+  const keysariumPath = path.join(targetDir, '.keysarium.json');
+  if (fileExists(keysariumPath)) {
+    info(`Keysarium integration: ${green('active')}`);
+    console.log('');
+  }
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/remove.js

@@ -0,0 +1,211 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const {
+  green, red, yellow, cyan, bold, dim,
+  info, success, warn, error: logError, step,
+  fileExists, readManifest,
+  MANIFEST_FILE,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Prompt the user for confirmation via readline.
+ * Resolves to true if user answers 'y' or 'yes', false otherwise.
+ */
+function confirmPrompt(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    rl.question(question, (answer) => {
+      rl.close();
+      const normalized = answer.trim().toLowerCase();
+      resolve(normalized === 'y' || normalized === 'yes');
+    });
+  });
+}
+
+/**
+ * Remove a file if it exists. Returns true if removed, false otherwise.
+ */
+function removeFile(filePath) {
+  try {
+    if (fileExists(filePath)) {
+      fs.unlinkSync(filePath);
+      return true;
+    }
+  } catch (err) {
+    warn(`Could not remove ${filePath}: ${err.message}`);
+  }
+  return false;
+}
+
+/**
+ * Remove a directory if it exists and is empty.
+ * Walks up the directory tree removing empty parents up to (but not including) stopDir.
+ *
+ * IMPORTANT: For BTO, we only clean up directories that are BTO-exclusive
+ * (like .claude/skills/bto/). We do NOT remove shared directories
+ * (.claude/commands/, .claude/rules/, .claude/agents/) as they may contain
+ * files from other skill packs.
+ */
+function removeEmptyDirs(dirPath, stopDir) {
+  try {
+    let current = dirPath;
+    while (current !== stopDir && current !== path.dirname(current)) {
+      if (!fileExists(current)) {
+        current = path.dirname(current);
+        continue;
+      }
+
+      const stat = fs.statSync(current);
+      if (!stat.isDirectory()) break;
+
+      const entries = fs.readdirSync(current);
+      if (entries.length === 0) {
+        fs.rmdirSync(current);
+        current = path.dirname(current);
+      } else {
+        break;
+      }
+    }
+  } catch {
+    // Silently ignore — directory cleanup is best-effort
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+/**
+ * `@dzhechkov/skills-bto remove` — Clean uninstall of the BTO skill pack.
+ *
+ * Only removes BTO-owned files. Shared directories (.claude/commands/,
+ * .claude/rules/, .claude/agents/) are preserved if they contain non-BTO files.
+ *
+ * @param {object} options
+ * @param {boolean} options.force     — Skip confirmation prompt
+ * @param {boolean} options.dryRun    — Preview without removing anything
+ * @param {string}  options.targetDir — Project root directory
+ */
+async function run(options) {
+  const { force, dryRun, targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Read manifest ───────────────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    warn('BTO skill pack is not installed in this directory — nothing to remove.');
+    process.exit(0);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError(`Failed to read ${MANIFEST_FILE} — file may be corrupted.`);
+    info(`You can manually delete ${MANIFEST_FILE} and the installed files.`);
+    process.exit(1);
+  }
+
+  const files = manifest.files || [];
+  const components = manifest.components || [];
+
+  // ── b) Show what will be removed ───────────────────────────────────────
+  console.log('');
+  info(bold('The following BTO components will be removed:'));
+  console.log('');
+
+  for (const key of components) {
+    console.log(`  ${red('-')} ${key}`);
+  }
+
+  console.log('');
+  console.log(`  ${dim(`${files.length} file(s) total`)}`);
+  console.log(`  ${dim(`+ ${MANIFEST_FILE} manifest`)}`);
+  console.log('');
+
+  // Check for keysarium presence
+  const keysariumPath = path.join(targetDir, '.keysarium.json');
+  if (fileExists(keysariumPath)) {
+    info('@dzhechkov/keysarium detected — shared directories will be preserved.');
+  }
+
+  if (dryRun) {
+    console.log(bold('Files to be removed:'));
+    for (const relPath of files) {
+      const absPath = path.join(targetDir, relPath);
+      const exists = fileExists(absPath);
+      const marker = exists ? red('- DEL') : dim('- N/A');
+      console.log(`  ${marker}  ${relPath}`);
+    }
+    console.log(`  ${red('- DEL')}  ${MANIFEST_FILE}`);
+    console.log('');
+    warn('Dry run — no files were removed.');
+    process.exit(0);
+  }
+
+  // ── c) Confirm unless --force ──────────────────────────────────────────
+  if (!force) {
+    const confirmed = await confirmPrompt(
+      yellow('This will remove all BTO skill pack files. Continue? (y/N) ')
+    );
+
+    if (!confirmed) {
+      info('Aborted — no files were removed.');
+      process.exit(0);
+    }
+  }
+
+  // ── d) Remove files ────────────────────────────────────────────────────
+  let removedCount = 0;
+  let skippedCount = 0;
+  const dirsToCheck = new Set();
+
+  for (let i = 0; i < files.length; i++) {
+    const relPath = files[i];
+    const absPath = path.join(targetDir, relPath);
+
+    step(i + 1, files.length, `Removing ${relPath}`);
+
+    if (removeFile(absPath)) {
+      removedCount++;
+      // Track parent directories for cleanup
+      dirsToCheck.add(path.dirname(absPath));
+    } else {
+      skippedCount++;
+    }
+  }
+
+  // Remove empty directories (bottom-up), but only BTO-exclusive ones
+  const sortedDirs = Array.from(dirsToCheck).sort((a, b) => b.length - a.length);
+  for (const dir of sortedDirs) {
+    removeEmptyDirs(dir, targetDir);
+  }
+
+  // ── e) Remove manifest ─────────────────────────────────────────────────
+  removeFile(manifestPath);
+  info(`Removed ${MANIFEST_FILE} manifest`);
+
+  // ── f) Summary ─────────────────────────────────────────────────────────
+  console.log('');
+  success(bold('BTO skill pack removal complete!'));
+  console.log(`  ${green('\u2713')} ${removedCount} file(s) removed`);
+  if (skippedCount > 0) {
+    console.log(`  ${dim('-')} ${skippedCount} file(s) already missing (skipped)`);
+  }
+  console.log('');
+  info(`To reinstall, run: ${cyan('@dzhechkov/skills-bto init')}`);
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;