@dzhechkov/keysarium 1.0.0

package/src/commands/list.js

@@ -0,0 +1,147 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, red, cyan, bold, dim,
+  info, warn, error: logError,
+  fileExists, readManifest, getRelativePaths,
+  COMPONENTS, MANIFEST_FILE,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Count files on disk for a given component in the target directory.
+ * 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()) {
+      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
+// ---------------------------------------------------------------------------
+
+/**
+ * `@dzhechko/keysarium list` — Show installed 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('Keysarium is not installed in this directory.');
+    info(`Run ${cyan('@dzhechko/keysarium init')} to install.`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError('Failed to read .keysarium.json — file may be corrupted.');
+    process.exit(1);
+  }
+
+  const installedKeys = new Set(manifest.components || []);
+
+  // ── Header ─────────────────────────────────────────────────────────────
+  console.log('');
+  console.log(bold(`@dzhechko/keysarium 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' : ''}` : '';
+
+    console.log(
+      padRight(shortLabel, nameWidth) +
+      padRight(statusText, statusWidth + 9) + // +9 to account for ANSI escape codes
+      dim(filesStr)
+    );
+  }
+
+  console.log('\u2500'.repeat(55));
+  console.log(
+    padRight(bold('Total'), nameWidth) +
+    padRight('', statusWidth) +
+    bold(`${totalFiles} files`)
+  );
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/remove.js

@@ -0,0 +1,197 @@
+'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.
+ */
+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
+// ---------------------------------------------------------------------------
+
+/**
+ * `@dzhechko/keysarium remove` — Clean uninstall of the toolkit.
+ *
+ * @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('Keysarium is not installed in this directory — nothing to remove.');
+    process.exit(0);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError('Failed to read .keysarium.json — file may be corrupted.');
+    info('You can manually delete .keysarium.json 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 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('+ .keysarium.json manifest')}`);
+  console.log('');
+
+  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 Keysarium 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)
+  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 .keysarium.json manifest');
+
+  // ── f) Summary ─────────────────────────────────────────────────────────
+  console.log('');
+  success(bold('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('@dzhechko/keysarium init')}`);
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/update.js

@@ -0,0 +1,191 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, yellow, cyan, bold, dim,
+  info, success, warn, error: logError, step,
+  copyDirRecursive, fileExists, readJSON,
+  ensureDir, getRelativePaths, diffFiles,
+  readManifest, writeManifest, getTemplatesDir,
+  COMPONENTS, MANIFEST_FILE,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+/**
+ * `@dzhechko/keysarium update` — Update an existing toolkit installation.
+ *
+ * @param {object} options
+ * @param {boolean} options.dryRun    — Preview without writing anything
+ * @param {boolean} options.force     — Passed through (unused here)
+ * @param {string}  options.targetDir — Destination project root
+ */
+async function run(options) {
+  const { dryRun, targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Read existing manifest ───────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    logError('Keysarium is not installed in this directory.');
+    info(`Run ${cyan('@dzhechko/keysarium init')} to install.`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError('Failed to read .keysarium.json — file may be corrupted.');
+    process.exit(1);
+  }
+
+  const templatesDir = getTemplatesDir();
+
+  // ── b) Get installed components ─────────────────────────────────────────
+  const installedKeys = manifest.components || [];
+  if (installedKeys.length === 0) {
+    warn('Manifest lists no installed components. Consider running init instead.');
+    process.exit(1);
+  }
+
+  info(`Current version: ${dim(manifest.version)}`);
+  const pkgPath = path.resolve(__dirname, '../../package.json');
+  const pkg = readJSON(pkgPath);
+  const newVersion = pkg ? pkg.version : manifest.version;
+  info(`Available version: ${bold(newVersion)}`);
+  console.log('');
+
+  // ── c) Diff each component ──────────────────────────────────────────────
+  let totalAdded = 0;
+  let totalModified = 0;
+  let totalUnchanged = 0;
+  const filesToCopy = []; // { src, dest, status, relPath }
+
+  for (const key of installedKeys) {
+    const comp = COMPONENTS[key];
+    if (!comp) {
+      warn(`Unknown component "${key}" in manifest — skipping.`);
+      continue;
+    }
+
+    const srcBase = path.join(templatesDir, comp.src);
+    const destBase = path.join(targetDir, comp.src);
+
+    if (!fileExists(srcBase)) {
+      warn(`Template source not found for "${key}" — skipping.`);
+      continue;
+    }
+
+    if (comp.isFile) {
+      // Single file comparison
+      if (!fileExists(destBase)) {
+        filesToCopy.push({ src: srcBase, dest: destBase, status: 'added', relPath: comp.src });
+        totalAdded++;
+      } else {
+        const srcContent = fs.readFileSync(srcBase);
+        const destContent = fs.readFileSync(destBase);
+        if (srcContent.equals(destContent)) {
+          totalUnchanged++;
+        } else {
+          filesToCopy.push({ src: srcBase, dest: destBase, status: 'modified', relPath: comp.src });
+          totalModified++;
+        }
+      }
+    } else {
+      // Directory — use diffFiles utility
+      const diff = diffFiles(srcBase, destBase);
+
+      for (const rel of diff.added) {
+        filesToCopy.push({
+          src: path.join(srcBase, rel),
+          dest: path.join(destBase, rel),
+          status: 'added',
+          relPath: path.join(comp.src, rel),
+        });
+        totalAdded++;
+      }
+
+      for (const rel of diff.modified) {
+        filesToCopy.push({
+          src: path.join(srcBase, rel),
+          dest: path.join(destBase, rel),
+          status: 'modified',
+          relPath: path.join(comp.src, rel),
+        });
+        totalModified++;
+      }
+
+      totalUnchanged += diff.unchanged.length;
+    }
+  }
+
+  // ── Show diff summary ───────────────────────────────────────────────────
+  info(bold('Update summary:'));
+  console.log(`  ${green('+')} ${totalAdded} file(s) to add`);
+  console.log(`  ${yellow('~')} ${totalModified} file(s) to update`);
+  console.log(`  ${dim('=')} ${totalUnchanged} file(s) unchanged`);
+  console.log('');
+
+  if (totalAdded === 0 && totalModified === 0) {
+    success('Everything is up to date!');
+    process.exit(0);
+  }
+
+  if (dryRun) {
+    console.log(bold('Files to be changed:'));
+    for (const f of filesToCopy) {
+      const marker = f.status === 'added' ? green('+ ADD') : yellow('~ MOD');
+      console.log(`  ${marker}  ${f.relPath}`);
+    }
+    console.log('');
+    warn('Dry run — no files were written.');
+    process.exit(0);
+  }
+
+  // ── d) Copy updated files ──────────────────────────────────────────────
+  for (let i = 0; i < filesToCopy.length; i++) {
+    const f = filesToCopy[i];
+    const label = f.status === 'added' ? 'Adding' : 'Updating';
+    step(i + 1, filesToCopy.length, `${label} ${f.relPath}`);
+
+    ensureDir(path.dirname(f.dest));
+    fs.copyFileSync(f.src, f.dest);
+  }
+
+  // ── e) Update manifest ─────────────────────────────────────────────────
+  const allFiles = [];
+  for (const key of installedKeys) {
+    const comp = COMPONENTS[key];
+    if (!comp) continue;
+    const destPath = path.join(targetDir, comp.src);
+    if (comp.isFile) {
+      if (fileExists(destPath)) {
+        allFiles.push(comp.src);
+      }
+    } else if (fileExists(destPath)) {
+      const paths = getRelativePaths(destPath);
+      allFiles.push(...paths.map((rel) => path.join(comp.src, rel)));
+    }
+  }
+
+  manifest.version = newVersion;
+  manifest.updatedAt = new Date().toISOString();
+  manifest.files = allFiles.sort();
+
+  writeManifest(targetDir, manifest);
+  info('Updated .keysarium.json manifest');
+
+  // ── f) Summary ─────────────────────────────────────────────────────────
+  console.log('');
+  success(bold('Update complete!'));
+  console.log(`  ${green('+')} ${totalAdded} file(s) added`);
+  console.log(`  ${yellow('~')} ${totalModified} file(s) updated`);
+  console.log(`  ${dim('=')} ${totalUnchanged} file(s) unchanged`);
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;