@dzhechkov/skills-presentation-storyteller 0.1.0

package/src/commands/init.js

@@ -0,0 +1,168 @@
+'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';
+
+function detectKeysarium(targetDir) {
+  const manifestPath = path.join(targetDir, KEYSARIUM_MANIFEST);
+  if (!fileExists(manifestPath)) return null;
+  return readJSON(manifestPath);
+}
+
+function showKeysariumIntegration(keysariumManifest) {
+  console.log('');
+  console.log(cyan('  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510'));
+  console.log(cyan('  \u2502') + bold(' @dzhechkov/keysarium detected!') + '                    ' + cyan('\u2502'));
+  console.log(cyan('  \u2502') + ` Version: ${dim(keysariumManifest.version)}` + ' '.repeat(39 - keysariumManifest.version.length) + cyan('\u2502'));
+  console.log(cyan('  \u2502') + ' Presentation Storyteller integrates with existing Keysarium.  ' + cyan('\u2502'));
+  console.log(cyan('  \u2502') + ' Shared: .claude/commands, skills                    ' + cyan('\u2502'));
+  console.log(cyan('  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518'));
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+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} \u2014 skipping.`);
+    return [];
+  }
+
+  // Single file copy (for isFile components)
+  if (comp.isFile) {
+    ensureDir(path.dirname(dest));
+    fs.copyFileSync(src, dest);
+    return [comp.src];
+  }
+
+  const filterFn = getComponentFilter(comp);
+
+  if (filterFn) {
+    copyDirFiltered(src, dest, filterFn);
+    return getRelativePathsFiltered(src, filterFn).map((rel) => path.join(comp.src, rel));
+  }
+
+  copyDirRecursive(src, dest);
+  return getRelativePaths(src).map((rel) => path.join(comp.src, rel));
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+async function run(options) {
+  const { force, dryRun, targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Check for existing installation ─────────────────────────────────
+  if (fileExists(manifestPath)) {
+    if (!force) {
+      warn('Presentation Storyteller skill pack is already installed in this directory.');
+      info(`Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to update, or use ${yellow('--force')} to overwrite.`);
+      process.exit(1);
+    }
+    warn('Existing Presentation Storyteller installation found \u2014 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 \u2014 no files were written.');
+    process.exit(0);
+  }
+
+  // ── e) Install components ──────────────────────────────────────────────
+  const totalComponents = componentKeys.length;
+  const installedFiles = [];
+  let stepNum = 0;
+
+  for (const key of componentKeys) {
+    stepNum++;
+    const comp = COMPONENTS[key];
+    step(stepNum, 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('Presentation Storyteller 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('/presentation-storyteller [topic or question]')} to start analysis`);
+  console.log(`  3. The skill orchestrates explore, research, and problem-solving`);
+  console.log('');
+
+  if (keysariumManifest) {
+    console.log(bold('Integration:'));
+    console.log(`  Presentation Storyteller is available alongside your Keysarium pipeline.`);
+    console.log(`  Use ${cyan('/casarium')} for research, ${cyan('/presentation-storyteller')} for deep analysis.`);
+    console.log('');
+  }
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/list.js

@@ -0,0 +1,146 @@
+'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
+// ---------------------------------------------------------------------------
+
+function countComponentFiles(comp, targetDir) {
+  const destPath = path.join(targetDir, comp.src);
+
+  if (!fileExists(destPath)) {
+    return 0;
+  }
+
+  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;
+}
+
+function padRight(str, width) {
+  if (str.length >= width) return str.slice(0, width);
+  return str + ' '.repeat(width - str.length);
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+async function run(options) {
+  const { targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Read manifest ──────────────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    warn('Presentation Storyteller skill pack is not installed in this directory.');
+    info(`Run ${cyan('@dzhechkov/skills-presentation-storyteller init')} to install.`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError(`Failed to read ${MANIFEST_FILE} \u2014 file may be corrupted.`);
+    process.exit(1);
+  }
+
+  const installedKeys = new Set(manifest.components || []);
+
+  // ── Header ────────────────────────────────────────────────────────────
+  console.log('');
+  console.log(bold(`@dzhechkov/skills-presentation-storyteller 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 = 40;
+  const statusWidth = 18;
+
+  console.log(
+    padRight(bold('Component'), nameWidth) +
+    padRight(bold('Status'), statusWidth) +
+    bold('Files')
+  );
+  console.log('\u2500'.repeat(68));
+
+  const allKeys = Object.keys(COMPONENTS);
+  let totalFiles = 0;
+
+  for (const key of allKeys) {
+    const comp = COMPONENTS[key];
+    const isInstalled = installedKeys.has(key);
+
+    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');
+    }
+
+    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) +
+      dim(filesStr) +
+      filterTag
+    );
+  }
+
+  console.log('\u2500'.repeat(68));
+  console.log(
+    padRight(bold('Total'), nameWidth) +
+    padRight('', statusWidth) +
+    bold(`${totalFiles} files`)
+  );
+  console.log('');
+
+  // ── c) Integration info ───────────────────────────────────────────────
+  const keysariumPath = path.join(targetDir, '.keysarium.json');
+  if (fileExists(keysariumPath)) {
+    info(`Keysarium integration: ${green('active')}`);
+  }
+
+  const btoPath = path.join(targetDir, '.skills-bto.json');
+  if (fileExists(btoPath)) {
+    info(`BTO integration: ${green('active')}`);
+  }
+
+  console.log('');
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/remove.js

@@ -0,0 +1,182 @@
+'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
+// ---------------------------------------------------------------------------
+
+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');
+    });
+  });
+}
+
+function removeFile(filePath) {
+  try {
+    if (fileExists(filePath)) {
+      fs.unlinkSync(filePath);
+      return true;
+    }
+  } catch (err) {
+    warn(`Could not remove ${filePath}: ${err.message}`);
+  }
+  return false;
+}
+
+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
+// ---------------------------------------------------------------------------
+
+async function run(options) {
+  const { force, dryRun, targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Read manifest ──────────────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    warn('Presentation Storyteller skill pack is not installed in this directory \u2014 nothing to remove.');
+    process.exit(0);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError(`Failed to read ${MANIFEST_FILE} \u2014 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 Presentation Storyteller 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('');
+
+  const keysariumPath = path.join(targetDir, '.keysarium.json');
+  if (fileExists(keysariumPath)) {
+    info('@dzhechkov/keysarium detected \u2014 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 \u2014 no files were removed.');
+    process.exit(0);
+  }
+
+  // ── c) Confirm unless --force ─────────────────────────────────────────
+  if (!force) {
+    const confirmed = await confirmPrompt(
+      yellow('This will remove all Presentation Storyteller skill pack files. Continue? (y/N) ')
+    );
+
+    if (!confirmed) {
+      info('Aborted \u2014 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++;
+      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 ${MANIFEST_FILE} manifest`);
+
+  // ── f) Summary ────────────────────────────────────────────────────────
+  console.log('');
+  success(bold('Presentation Storyteller 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-presentation-storyteller init')}`);
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/update.js

@@ -0,0 +1,170 @@
+'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, diffFiles,
+  readManifest, writeManifest, getTemplatesDir,
+  COMPONENTS, MANIFEST_FILE, getComponentFilter,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+async function run(options) {
+  const { dryRun, targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Read existing manifest ─────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    logError('Presentation Storyteller skill pack is not installed in this directory.');
+    info(`Run ${cyan('@dzhechkov/skills-presentation-storyteller init')} to install.`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError(`Failed to read ${MANIFEST_FILE} \u2014 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 = [];
+
+  for (const key of installedKeys) {
+    const comp = COMPONENTS[key];
+    if (!comp) {
+      warn(`Unknown component "${key}" in manifest \u2014 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}" \u2014 skipping.`);
+      continue;
+    }
+
+    const filterFn = getComponentFilter(comp);
+    const diff = diffFiles(srcBase, destBase, filterFn);
+
+    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 \u2014 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);
+    const srcPath = path.join(templatesDir, comp.src);
+    const filterFn = getComponentFilter(comp);
+    const scanBase = fileExists(srcPath) ? srcPath : destPath;
+
+    if (fileExists(destPath)) {
+      // Scan the TEMPLATE source, not the destination, so user files aren't adopted.
+      const paths = filterFn
+        ? getRelativePathsFiltered(scanBase, filterFn)
+        : getRelativePaths(scanBase);
+      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 ${MANIFEST_FILE} 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;