@dzhechkov/p-replicator 1.0.0

package/src/commands/init.js

@@ -0,0 +1,155 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, cyan, bold, dim,
+  info, success, warn, error: logError, step,
+  copyDirRecursive, fileExists, readJSON,
+  createManifest, writeManifest, getTemplatesDir, getRelativePaths,
+  COMPONENTS, MANIFEST_FILE,
+} = 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') + ' PU skills will integrate with Keysarium setup.      ' + cyan('\u2502'));
+  console.log(cyan('  \u2502') + ' Shared directories: .claude/commands, rules, agents  ' + 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 [];
+  }
+
+  copyDirRecursive(src, dest);
+  return getRelativePaths(dest).map((rel) => path.join(comp.src, rel));
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+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('P-Replicator is already installed in this directory.');
+      info(`Run ${cyan('npx @dzhechkov/p-replicator update')} to update, or use ${bold('--force')} to overwrite.`);
+      process.exit(1);
+    }
+    warn('Existing installation found \u2014 overwriting (--force).');
+  }
+
+  // ── b) Detect keysarium integration ─────────────────────────────────────
+  const keysariumManifest = detectKeysarium(targetDir);
+  if (keysariumManifest) {
+    showKeysariumIntegration(keysariumManifest);
+  }
+
+  // ── c) Show plan ────────────────────────────────────────────────────────
+  const componentKeys = Object.keys(COMPONENTS);
+  const templatesDir = getTemplatesDir();
+
+  console.log('');
+  info(bold('Installation plan:'));
+  console.log('');
+
+  for (const key of componentKeys) {
+    const comp = COMPONENTS[key];
+    console.log(`  ${green('+')} ${comp.label}`);
+  }
+
+  console.log('');
+
+  if (dryRun) {
+    warn('Dry run \u2014 no files were written.');
+    process.exit(0);
+  }
+
+  // ── d) 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);
+  }
+
+  // ── e) 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`);
+
+  // ── f) Success summary ─────────────────────────────────────────────────
+  console.log('');
+  success(bold('P-Replicator 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(`  ${dim('Total files:')} ${installedFiles.length}`);
+  console.log('');
+
+  console.log(bold('Next steps:'));
+  console.log(`  1. Open ${cyan('Claude Code')} in this directory`);
+  console.log(`  2. Run ${cyan('/replicate "Your product idea"')} for the full pipeline`);
+  console.log(`  3. Follow 4-5 phases with interactive checkpoints`);
+  console.log('');
+  console.log(bold('Available commands after /replicate:'));
+  console.log(`     ${cyan('/replicate')}  ${dim('\u2014 Full pipeline: idea \u2192 validated docs \u2192 toolkit')}`);
+  console.log(`     ${cyan('/harvest')}    ${dim('\u2014 Extract reusable knowledge from projects')}`);
+  console.log('');
+
+  if (keysariumManifest) {
+    console.log(bold('Integration:'));
+    console.log('  PU commands are available alongside your Keysarium pipeline.');
+    console.log(`  Run ${cyan('npx @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,133 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, cyan, bold, dim, yellow,
+  info, warn,
+  readManifest, fileExists,
+  MANIFEST_FILE,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Skill details for rich listing
+// ---------------------------------------------------------------------------
+
+const SKILL_DETAILS = {
+  'explore':                       'Socratic task clarification',
+  'sparc-prd-mini':                'SPARC documentation generator (11 docs)',
+  'goap-research-ed25519':         'Verified research with Ed25519 anti-hallucination',
+  'problem-solver-enhanced':       'First principles + TRIZ (9 modules)',
+  'requirements-validator':        'INVEST/SMART validation + BDD scenarios',
+  'brutal-honesty-review':         'Unvarnished technical criticism',
+  'cc-toolkit-generator-enhanced': 'Claude Code toolkit generator',
+  'reverse-engineering-unicorn':   'Company reverse engineering + playbook',
+  'pipeline-forge':                'Meta-skill: build AI pipelines from patterns',
+  'knowledge-extractor':           'Extract reusable knowledge from projects',
+};
+
+const COMMAND_DETAILS = {
+  'replicate': 'Full pipeline: idea \u2192 validated docs \u2192 toolkit',
+  'harvest':   'Knowledge extraction from projects',
+};
+
+const AGENT_DETAILS = {
+  'replicate-coordinator': 'Pipeline orchestration (Phases 0-4)',
+  'product-discoverer':    'Market research (Phase 0)',
+  'doc-validator':         'Documentation validation swarm (Phase 2)',
+  'harvest-coordinator':   'Knowledge extraction swarm',
+};
+
+function run(options) {
+  const { targetDir } = options;
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    warn('P-Replicator is not installed in this directory.');
+    info(`Run ${cyan('npx @dzhechkov/p-replicator init')} to install.`);
+    process.exit(1);
+  }
+
+  console.log(bold('P-Replicator') + dim(` v${manifest.version}`));
+  console.log(dim(`Installed: ${manifest.installedAt}`));
+  console.log('');
+
+  // ── Skills ──────────────────────────────────────────────────────────────
+  const skillsDir = path.join(targetDir, '.claude', 'skills');
+  console.log(bold('Skills:'));
+  if (fileExists(skillsDir)) {
+    const skills = fs.readdirSync(skillsDir).filter((d) => {
+      return fs.statSync(path.join(skillsDir, d)).isDirectory();
+    });
+    for (const skill of skills.sort()) {
+      const desc = SKILL_DETAILS[skill] || '';
+      const hasSkillMd = fileExists(path.join(skillsDir, skill, 'SKILL.md'));
+      const status = hasSkillMd ? green('\u2713') : yellow('?');
+      console.log(`  ${status} ${skill}` + (desc ? dim(` \u2014 ${desc}`) : ''));
+    }
+    console.log(dim(`  Total: ${skills.length} skills`));
+  } else {
+    console.log(dim('  No skills directory found.'));
+  }
+  console.log('');
+
+  // ── Commands ────────────────────────────────────────────────────────────
+  const commandsDir = path.join(targetDir, '.claude', 'commands');
+  console.log(bold('Commands:'));
+  if (fileExists(commandsDir)) {
+    const commands = fs.readdirSync(commandsDir)
+      .filter((f) => f.endsWith('.md'))
+      .map((f) => f.replace('.md', ''));
+    for (const cmd of commands.sort()) {
+      const desc = COMMAND_DETAILS[cmd] || '';
+      console.log(`  ${green('\u2713')} /${cmd}` + (desc ? dim(` \u2014 ${desc}`) : ''));
+    }
+    console.log(dim(`  Total: ${commands.length} commands`));
+  } else {
+    console.log(dim('  No commands directory found.'));
+  }
+  console.log('');
+
+  // ── Agents ──────────────────────────────────────────────────────────────
+  const agentsDir = path.join(targetDir, '.claude', 'agents');
+  console.log(bold('Agents:'));
+  if (fileExists(agentsDir)) {
+    const agents = fs.readdirSync(agentsDir)
+      .filter((f) => f.endsWith('.md'))
+      .map((f) => f.replace('.md', ''));
+    for (const agent of agents.sort()) {
+      const desc = AGENT_DETAILS[agent] || '';
+      console.log(`  ${green('\u2713')} ${agent}` + (desc ? dim(` \u2014 ${desc}`) : ''));
+    }
+    console.log(dim(`  Total: ${agents.length} agents`));
+  } else {
+    console.log(dim('  No agents directory found.'));
+  }
+  console.log('');
+
+  // ── Rules ───────────────────────────────────────────────────────────────
+  const rulesDir = path.join(targetDir, '.claude', 'rules');
+  console.log(bold('Rules:'));
+  if (fileExists(rulesDir)) {
+    const rules = fs.readdirSync(rulesDir)
+      .filter((f) => f.endsWith('.md'))
+      .map((f) => f.replace('.md', ''));
+    for (const rule of rules.sort()) {
+      console.log(`  ${green('\u2713')} ${rule}`);
+    }
+    console.log(dim(`  Total: ${rules.length} rules`));
+  } else {
+    console.log(dim('  No rules directory found.'));
+  }
+  console.log('');
+
+  // ── File count ──────────────────────────────────────────────────────────
+  const totalFiles = (manifest.files || []).length;
+  console.log(dim(`Total tracked files: ${totalFiles}`));
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/remove.js

@@ -0,0 +1,111 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, red, cyan, bold, dim,
+  info, success, warn, error: logError,
+  readManifest, fileExists,
+  MANIFEST_FILE,
+} = require('../utils');
+
+function run(options) {
+  const { force, dryRun, targetDir } = options;
+
+  // ── a) Check for existing installation ──────────────────────────────────
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError('P-Replicator is not installed in this directory.');
+    info('Nothing to remove.');
+    process.exit(1);
+  }
+
+  info(`Found installation v${bold(manifest.version)} (${manifest.installedAt})`);
+  console.log('');
+
+  // ── b) List files to remove ─────────────────────────────────────────────
+  const files = manifest.files || [];
+  const existingFiles = files.filter((f) => fileExists(path.join(targetDir, f)));
+
+  console.log(bold('Files to remove:'));
+  for (const f of existingFiles) {
+    console.log(`  ${red('\u2717')} ${f}`);
+  }
+  console.log('');
+  console.log(`  ${dim('Total:')} ${existingFiles.length} files`);
+  console.log('');
+
+  if (existingFiles.length === 0) {
+    warn('No files found to remove (already cleaned up?).');
+    // Still remove manifest
+    const manifestPath = path.join(targetDir, MANIFEST_FILE);
+    if (fileExists(manifestPath)) {
+      fs.unlinkSync(manifestPath);
+      info(`Removed ${MANIFEST_FILE}`);
+    }
+    process.exit(0);
+  }
+
+  if (dryRun) {
+    warn('Dry run \u2014 no files were removed.');
+    process.exit(0);
+  }
+
+  // ── c) Remove files ────────────────────────────────────────────────────
+  let removed = 0;
+  for (const f of existingFiles) {
+    const fullPath = path.join(targetDir, f);
+    try {
+      fs.unlinkSync(fullPath);
+      removed++;
+    } catch (err) {
+      warn(`Could not remove: ${f} (${err.message})`);
+    }
+  }
+
+  // ── d) Clean up empty directories ──────────────────────────────────────
+  const dirs = new Set();
+  for (const f of existingFiles) {
+    let dir = path.dirname(f);
+    while (dir && dir !== '.') {
+      dirs.add(dir);
+      dir = path.dirname(dir);
+    }
+  }
+
+  // Sort deepest first for safe removal
+  const sortedDirs = [...dirs].sort((a, b) => b.split(path.sep).length - a.split(path.sep).length);
+  for (const dir of sortedDirs) {
+    const fullDir = path.join(targetDir, dir);
+    try {
+      const entries = fs.readdirSync(fullDir);
+      if (entries.length === 0) {
+        fs.rmdirSync(fullDir);
+      }
+    } catch {
+      // Directory doesn't exist or not empty — skip
+    }
+  }
+
+  // ── e) Remove manifest ─────────────────────────────────────────────────
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+  if (fileExists(manifestPath)) {
+    fs.unlinkSync(manifestPath);
+  }
+
+  console.log('');
+  success(`Removed ${removed} files.`);
+  console.log('');
+  console.log(bold('Note:'));
+  console.log('  Project-specific files were NOT removed:');
+  console.log(`  ${dim('\u2022')} docs/ (SPARC documentation)`);
+  console.log(`  ${dim('\u2022')} CLAUDE.md, DEVELOPMENT_GUIDE.md`);
+  console.log(`  ${dim('\u2022')} Generated commands (/start, /feature, /plan, etc.)`);
+  console.log(`  ${dim('\u2022')} docker-compose.yml, Dockerfile`);
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;

package/src/commands/update.js

@@ -0,0 +1,102 @@
+'use strict';
+
+const path = require('path');
+const {
+  green, yellow, cyan, bold, dim,
+  info, success, warn, error: logError, step,
+  copyDirRecursive, fileExists, readJSON,
+  diffFiles, getRelativePaths,
+  readManifest, writeManifest, createManifest, getTemplatesDir,
+  COMPONENTS, MANIFEST_FILE,
+} = require('../utils');
+
+function run(options) {
+  const { force, dryRun, targetDir } = options;
+
+  // ── a) Check for existing installation ──────────────────────────────────
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError('P-Replicator is not installed in this directory.');
+    info(`Run ${cyan('npx @dzhechkov/p-replicator init')} first.`);
+    process.exit(1);
+  }
+
+  const pkgPath = path.resolve(__dirname, '../../package.json');
+  const pkg = readJSON(pkgPath);
+  const newVersion = pkg ? pkg.version : '0.0.0';
+
+  info(`Installed version: ${bold(manifest.version)}`);
+  info(`Package version:   ${bold(newVersion)}`);
+  console.log('');
+
+  // ── b) Diff files ───────────────────────────────────────────────────────
+  const templatesDir = getTemplatesDir();
+  const templateClaude = path.join(templatesDir, '.claude');
+  const projectClaude = path.join(targetDir, '.claude');
+
+  if (!fileExists(templateClaude)) {
+    logError('Template .claude/ directory not found in package.');
+    process.exit(1);
+  }
+
+  const { added, modified, unchanged } = diffFiles(templateClaude, projectClaude);
+
+  console.log(bold('Changes detected:'));
+  console.log(`  ${green('+')} ${added.length} new files`);
+  console.log(`  ${yellow('~')} ${modified.length} modified files`);
+  console.log(`  ${dim('=')} ${unchanged.length} unchanged files`);
+  console.log('');
+
+  if (added.length === 0 && modified.length === 0) {
+    success('Already up to date!');
+    process.exit(0);
+  }
+
+  // ── c) Show details ────────────────────────────────────────────────────
+  if (added.length > 0) {
+    console.log(green('New files:'));
+    for (const f of added) {
+      console.log(`  ${green('+')} .claude/${f}`);
+    }
+    console.log('');
+  }
+
+  if (modified.length > 0) {
+    console.log(yellow('Modified files:'));
+    for (const f of modified) {
+      console.log(`  ${yellow('~')} .claude/${f}`);
+    }
+    console.log('');
+  }
+
+  if (dryRun) {
+    warn('Dry run \u2014 no files were written.');
+    process.exit(0);
+  }
+
+  // ── d) Apply updates ───────────────────────────────────────────────────
+  const filesToUpdate = [...added, ...modified];
+  let updated = 0;
+
+  for (const rel of filesToUpdate) {
+    const src = path.join(templateClaude, rel);
+    const dest = path.join(projectClaude, rel);
+    copyDirRecursive(src, dest);
+    updated++;
+  }
+
+  // ── e) Update manifest ─────────────────────────────────────────────────
+  const allFiles = getRelativePaths(projectClaude).map((f) => '.claude/' + f);
+  const componentKeys = Object.keys(COMPONENTS);
+  const newManifest = createManifest(newVersion, componentKeys, allFiles.sort());
+  writeManifest(targetDir, newManifest);
+
+  console.log('');
+  success(`Updated ${updated} files to version ${bold(newVersion)}`);
+  console.log('');
+
+  process.exit(0);
+}
+
+module.exports = run;
+module.exports.run = run;