@synapsync/cli 0.1.2 → 0.1.4

package/dist/index.js

@@ -28,7 +28,7 @@ var init_version = __esm({
   "src/version.ts"() {
     "use strict";
     init_esm_shims();
-    version = "0.1.0";
+    version = "0.1.4";
   }
 });
 
@@ -144,7 +144,7 @@ var REGISTRY_MANIFEST_FILE = "manifest.json";
 // src/ui/repl.ts
 init_esm_shims();
 import * as readline from "readline";
-import pc16 from "picocolors";
+import pc17 from "picocolors";
 
 // src/ui/banner.ts
 init_esm_shims();
@@ -337,7 +337,7 @@ function showBanner() {
   logger.command("synapsync init", "Initialize a new project");
   logger.command("synapsync connect", "Connect to AI providers");
   logger.command("synapsync search", "Search registry for assets");
-  logger.command("synapsync install <name>", "Install skill, agent, or prompt");
+  logger.command("synapsync add <name>", "Add skill, agent, or prompt");
   logger.command("synapsync sync", "Sync assets to providers");
   logger.line();
   logger.log(`  ${pc2.dim("Run")} ${pc2.cyan("synapsync --help")} ${pc2.dim("for all commands")}`);
@@ -359,10 +359,10 @@ var INFO_TOPICS = {
     description: "Types of AI cognitives managed by SynapSync",
     content: showCognitivesInfo
   },
-  install: {
-    name: "Install",
-    description: "How to install cognitives from different sources",
-    content: showInstallInfo
+  add: {
+    name: "Add",
+    description: "How to add cognitives from different sources",
+    content: showAddInfo
   },
   providers: {
     name: "Providers",
@@ -439,8 +439,8 @@ function showCognitivesInfo() {
   logger.line();
   logger.log(pc3.bold("  Usage Examples:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync install")} code-reviewer      ${pc3.dim("# Install a skill")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync install")} ci-agent           ${pc3.dim("# Install an agent")}`);
+  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer      ${pc3.dim("# Add a skill")}`);
+  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} ci-agent           ${pc3.dim("# Add an agent")}`);
   logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync list")} --type agent          ${pc3.dim("# List only agents")}`);
   logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")} --type skill          ${pc3.dim("# Sync only skills")}`);
   logger.line();
@@ -451,7 +451,7 @@ function showCognitivesInfo() {
   logger.line();
   logger.log(pc3.bold("  Type Detection:"));
   logger.line();
-  logger.dim("  When installing, SynapSync detects the cognitive type automatically:");
+  logger.dim("  When adding, SynapSync detects the cognitive type automatically:");
   logger.line();
   logger.log(`  ${pc3.cyan("1.")} ${pc3.white("Flag")}       ${pc3.dim("--type skill (explicit, highest priority)")}`);
   logger.log(`  ${pc3.cyan("2.")} ${pc3.white("Registry")}   ${pc3.dim("Metadata from the registry")}`);
@@ -459,43 +459,43 @@ function showCognitivesInfo() {
   logger.log(`  ${pc3.cyan("4.")} ${pc3.white("Prompt")}     ${pc3.dim("Asks you if cannot detect")}`);
   logger.line();
 }
-function showInstallInfo() {
+function showAddInfo() {
   logger.line();
   logger.log(pc3.bold(pc3.cyan("  Installation Sources")));
   logger.line();
-  logger.dim("  SynapSync can install cognitives from multiple sources:");
+  logger.dim("  SynapSync can add cognitives from multiple sources:");
   logger.line();
   logger.log(pc3.bold("  Supported Sources:"));
   logger.line();
   const sources = [
     {
       source: "Registry",
-      format: "synapsync install code-reviewer",
+      format: "synapsync add code-reviewer",
       description: "From the SynapSync registry"
     },
     {
       source: "Local",
-      format: "synapsync install ./path/to/cognitive",
+      format: "synapsync add ./path/to/cognitive",
       description: "From local file system"
     },
     {
       source: "GitHub",
-      format: "synapsync install github:user/repo",
+      format: "synapsync add github:user/repo",
       description: "From a GitHub repository"
     },
     {
       source: "GitHub Path",
-      format: "synapsync install github:user/repo/cognitives/skill",
+      format: "synapsync add github:user/repo/cognitives/skill",
       description: "Specific path in repo"
     },
     {
       source: "GitHub Branch",
-      format: "synapsync install github:user/repo#develop",
+      format: "synapsync add github:user/repo#develop",
       description: "Specific branch or tag"
     },
     {
       source: "GitHub URL",
-      format: "synapsync install https://github.com/user/repo",
+      format: "synapsync add https://github.com/user/repo",
       description: "Full GitHub URL"
     }
   ];
@@ -508,22 +508,21 @@ function showInstallInfo() {
   logger.line();
   logger.dim("  SynapSync automatically detects the cognitive type using:");
   logger.line();
-  logger.log(`  ${pc3.cyan("1.")} ${pc3.white("Explicit flag")}     ${pc3.dim("synapsync install code-reviewer --type skill")}`);
+  logger.log(`  ${pc3.cyan("1.")} ${pc3.white("Explicit flag")}     ${pc3.dim("synapsync add code-reviewer --type skill")}`);
   logger.log(`  ${pc3.cyan("2.")} ${pc3.white("Registry lookup")}   ${pc3.dim("Registry provides type metadata")}`);
   logger.log(`  ${pc3.cyan("3.")} ${pc3.white("File detection")}    ${pc3.dim("Scans for SKILL.md, AGENT.md, etc.")}`);
   logger.log(`  ${pc3.cyan("4.")} ${pc3.white("Interactive")}       ${pc3.dim("Prompts you to select if unknown")}`);
   logger.line();
   logger.log(pc3.bold("  Version Specification:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync install")} code-reviewer          ${pc3.dim("# Latest version")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync install")} code-reviewer@1.2.0    ${pc3.dim("# Specific version")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync install")} code-reviewer@^1.0.0   ${pc3.dim("# Version range")}`);
+  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer          ${pc3.dim("# Latest version")}`);
+  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer@1.2.0    ${pc3.dim("# Specific version")}`);
+  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer@^1.0.0   ${pc3.dim("# Version range")}`);
   logger.line();
   logger.log(pc3.bold("  Common Options:"));
   logger.line();
   logger.log(`  ${pc3.yellow("--type <type>")}       ${pc3.dim("Explicit cognitive type (skill, agent, prompt, workflow, tool)")}`);
   logger.log(`  ${pc3.yellow("--category <cat>")}    ${pc3.dim("Explicit category (frontend, backend, etc.)")}`);
-  logger.log(`  ${pc3.yellow("--global")}            ${pc3.dim("Install globally for all projects")}`);
   logger.log(`  ${pc3.yellow("--force")}             ${pc3.dim("Force reinstall even if exists")}`);
   logger.line();
 }
@@ -586,7 +585,7 @@ function showCategoriesInfo() {
   logger.line();
   logger.log(pc3.bold("  Usage:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync install")} react-patterns ${pc3.dim("--category frontend")}`);
+  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} react-patterns ${pc3.dim("--category frontend")}`);
   logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync list")} --category devops`);
   logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync search")} --category security`);
   logger.line();
@@ -664,7 +663,7 @@ function showAllTopics() {
   logger.line();
   const topics = [
     { flag: "--cognitives", desc: "Types of AI cognitives (skills, agents, prompts, etc.)" },
-    { flag: "--install", desc: "How to install from registry, GitHub, local" },
+    { flag: "--add", desc: "How to add from registry, GitHub, local" },
     { flag: "--providers", desc: "Supported AI providers (Claude, OpenAI, etc.)" },
     { flag: "--categories", desc: "Cognitive organization categories" },
     { flag: "--sync", desc: "How synchronization works" },
@@ -707,7 +706,7 @@ function executeInfoCommand(args) {
   }
 }
 function registerInfoCommand(program) {
-  program.command("info").description("Show information about SynapSync concepts").option("--cognitives", "Show cognitive types information").option("--install", "Show installation sources and detection").option("--providers", "Show supported providers").option("--categories", "Show cognitive categories").option("--sync", "Show sync information").option("--structure", "Show project structure").action((options) => {
+  program.command("info").description("Show information about SynapSync concepts").option("--cognitives", "Show cognitive types information").option("--add", "Show installation sources and detection").option("--providers", "Show supported providers").option("--categories", "Show cognitive categories").option("--sync", "Show sync information").option("--structure", "Show project structure").action((options) => {
     const topic = Object.keys(options).find((key) => options[key] === true);
     if (topic && INFO_TOPICS[topic]) {
       INFO_TOPICS[topic].content();
@@ -823,8 +822,8 @@ function validateConfig(config) {
   }
   return errors;
 }
-function getNestedValue(obj, path16) {
-  const parts = path16.split(".");
+function getNestedValue(obj, path17) {
+  const parts = path17.split(".");
   let current = obj;
   for (const part of parts) {
     if (current === null || current === void 0) {
@@ -837,8 +836,8 @@ function getNestedValue(obj, path16) {
   }
   return current;
 }
-function setNestedValue(obj, path16, value) {
-  const parts = path16.split(".");
+function setNestedValue(obj, path17, value) {
+  const parts = path17.split(".");
   let current = obj;
   for (let i = 0; i < parts.length - 1; i++) {
     const part = parts[i];
@@ -1197,9 +1196,9 @@ function showSuccessMessage(setup, configPath, storagePath) {
   logger.log(`  ${pc4.cyan("1.")} Connect to providers:`);
   logger.log(`     ${pc4.dim("$")} synapsync connect claude`);
   logger.line();
-  logger.log(`  ${pc4.cyan("2.")} Install cognitives:`);
-  logger.log(`     ${pc4.dim("$")} synapsync install code-reviewer`);
-  logger.log(`     ${pc4.dim("$")} synapsync install github:user/my-skill`);
+  logger.log(`  ${pc4.cyan("2.")} Add cognitives:`);
+  logger.log(`     ${pc4.dim("$")} synapsync add code-reviewer`);
+  logger.log(`     ${pc4.dim("$")} synapsync add github:user/my-skill`);
   logger.line();
   logger.log(`  ${pc4.cyan("3.")} Sync to providers:`);
   logger.log(`     ${pc4.dim("$")} synapsync sync`);
@@ -2101,7 +2100,7 @@ function displaySearchResults(cognitives, query, total) {
     displayCognitive(cognitive);
   }
   logger.line();
-  logger.hint("Run synapsync install <name> to install a cognitive.");
+  logger.hint("Run synapsync add <name> to add a cognitive.");
 }
 function displayCognitive(cognitive) {
   const typeIcon = getCognitiveIcon2(cognitive.type);
@@ -2141,7 +2140,7 @@ function registerSearchCommand(program) {
   });
 }
 
-// src/commands/install.ts
+// src/commands/add.ts
 init_esm_shims();
 import * as fs8 from "fs";
 import * as path10 from "path";
@@ -3318,8 +3317,8 @@ var SyncEngine = class {
   }
 };
 
-// src/commands/install.ts
-async function executeInstallCommand(source, options) {
+// src/commands/add.ts
+async function executeAddCommand(source, options) {
   logger.line();
   const configManager = ConfigManager.findConfig();
   if (configManager === null) {
@@ -3344,7 +3343,7 @@ async function executeInstallCommand(source, options) {
         success = installFromGitHub(parsedSource, options, configManager);
         break;
     }
-    if (success && options.sync === true) {
+    if (success) {
       logger.log(`  ${pc9.dim("Syncing to providers...")}`);
       const synapSyncDir = configManager.getSynapSyncDir();
       const projectRoot = configManager.getProjectRoot();
@@ -3433,10 +3432,6 @@ async function installFromRegistry(name, options, configManager) {
   logger.log(`    ${pc9.dim("Type:")} ${manifest.type}`);
   logger.log(`    ${pc9.dim("Category:")} ${category}`);
   logger.log(`    ${pc9.dim("Location:")} ${path10.relative(process.cwd(), targetDir)}`);
-  if (options.sync !== true) {
-    logger.line();
-    logger.hint("Run synapsync sync to sync to your providers.");
-  }
   return true;
 }
 async function downloadAssets(client, name, _manifest) {
@@ -3516,10 +3511,6 @@ function installFromLocal(sourcePath, options, configManager) {
   logger.log(`    ${pc9.dim("Category:")} ${category}`);
   logger.log(`    ${pc9.dim("Source:")} local`);
   logger.log(`    ${pc9.dim("Location:")} ${path10.relative(process.cwd(), targetDir)}`);
-  if (options.sync !== true) {
-    logger.line();
-    logger.hint("Run synapsync sync to sync to your providers.");
-  }
   return true;
 }
 function detectCognitiveType(dirPath) {
@@ -3577,7 +3568,7 @@ function parseMetadata(content) {
 function installFromGitHub(_source, _options, _configManager) {
   logger.line();
   logger.error("GitHub installation is not yet fully implemented.");
-  logger.hint("For now, clone the repo locally and use: synapsync install ./path/to/cognitive");
+  logger.hint("For now, clone the repo locally and use: synapsync add ./path/to/cognitive");
   return false;
 }
 function getTargetDir(configManager, type, category, name) {
@@ -3626,9 +3617,9 @@ function updateProjectManifest(configManager, manifest, source) {
   projectManifest.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
   fs8.writeFileSync(manifestPath, JSON.stringify(projectManifest, null, 2), "utf-8");
 }
-function registerInstallCommand(program) {
-  program.command("install <source>").description("Install a cognitive from registry, local path, or GitHub").option("-t, --type <type>", "Cognitive type (skill, agent, prompt, workflow, tool)").option("-c, --category <category>", "Category (overrides default)").option("-f, --force", "Overwrite if already installed").option("-s, --sync", "Sync to providers after installation").option("-g, --global", "Install globally (not yet implemented)").action(async (source, options) => {
-    await executeInstallCommand(source, options);
+function registerAddCommand(program) {
+  program.command("add <source>").description("Add a cognitive from registry, local path, or GitHub").option("-t, --type <type>", "Cognitive type (skill, agent, prompt, workflow, tool)").option("-c, --category <category>", "Category (overrides default)").option("-f, --force", "Overwrite if already installed").action(async (source, options) => {
+    await executeAddCommand(source, options);
   });
 }
 
@@ -3731,7 +3722,7 @@ function displayRemoteCognitives(cognitives) {
   }
   logger.log(`  ${pc10.dim(`Total: ${cognitives.length} cognitive${cognitives.length === 1 ? "" : "s"} available`)}`);
   logger.line();
-  logger.hint("Run synapsync install <name> to install a cognitive.");
+  logger.hint("Run synapsync add <name> to add a cognitive.");
 }
 function validateOptions2(options) {
   const validated = {};
@@ -3796,7 +3787,7 @@ function displayCognitives(manifest, options) {
     if (cognitives.length === 0) {
       logger.log(`  ${pc10.dim("No cognitives installed yet.")}`);
       logger.line();
-      logger.hint("Run synapsync search to find cognitives to install.");
+      logger.hint("Run synapsync search to find cognitives to add.");
     } else {
       logger.log(`  ${pc10.dim("No cognitives match the specified filters.")}`);
       logger.line();
@@ -4366,7 +4357,7 @@ async function executeUpdateCommand(cognitiveName, options = {}) {
       console.log(JSON.stringify({ message: "No cognitives installed" }));
     } else {
       logger.log(`  ${pc13.dim("No cognitives installed.")}`);
-      logger.hint("Run synapsync install <name> to install a cognitive.");
+      logger.hint("Run synapsync add <name> to add a cognitive.");
     }
     return;
   }
@@ -5428,6 +5419,140 @@ function registerCleanCommand(program) {
   });
 }
 
+// src/commands/purge.ts
+init_esm_shims();
+import * as fs14 from "fs";
+import * as path16 from "path";
+import pc16 from "picocolors";
+function executePurgeCommand(options) {
+  logger.line();
+  const configManager = ConfigManager.findConfig();
+  if (configManager === null) {
+    logger.error("No SynapSync project found.");
+    return;
+  }
+  const projectRoot = configManager.getProjectRoot();
+  const synapSyncDir = configManager.getSynapSyncDir();
+  if (options.force !== true) {
+    logger.log(`  ${pc16.yellow("!")} This will completely remove SynapSync from your project:`);
+    logger.line();
+    const itemsToRemove = collectItemsToRemove(projectRoot, synapSyncDir);
+    for (const item of itemsToRemove) {
+      logger.log(`    ${pc16.red("\u2717")} ${item}`);
+    }
+    logger.line();
+    logger.hint("Use --force to confirm and remove everything.");
+    logger.log(`  ${pc16.dim("To confirm, run:")} synapsync purge --force`);
+    return;
+  }
+  let removedCount = 0;
+  try {
+    removedCount += removeProviderSymlinks(projectRoot, synapSyncDir);
+    if (fs14.existsSync(synapSyncDir)) {
+      fs14.rmSync(synapSyncDir, { recursive: true, force: true });
+      logger.log(`  ${pc16.red("\u2717")} Removed ${path16.relative(projectRoot, synapSyncDir)}/`);
+      removedCount++;
+    }
+    const configPath = path16.join(projectRoot, "synapsync.config.yaml");
+    if (fs14.existsSync(configPath)) {
+      fs14.unlinkSync(configPath);
+      logger.log(`  ${pc16.red("\u2717")} Removed synapsync.config.yaml`);
+      removedCount++;
+    }
+    if (cleanGitignore(projectRoot)) {
+      logger.log(`  ${pc16.red("\u2717")} Cleaned SynapSync entries from .gitignore`);
+      removedCount++;
+    }
+    logger.line();
+    if (removedCount > 0) {
+      logger.log(`  ${pc16.green("\u2713")} SynapSync has been completely removed from this project.`);
+    } else {
+      logger.log(`  ${pc16.green("\u2713")} Nothing to remove.`);
+    }
+    logger.line();
+  } catch (error) {
+    logger.line();
+    if (error instanceof Error) {
+      logger.error(`Purge failed: ${error.message}`);
+    } else {
+      logger.error("Purge failed with unknown error");
+    }
+  }
+}
+function collectItemsToRemove(projectRoot, synapSyncDir) {
+  const items = [];
+  const symlinks = findSynapSyncSymlinks(projectRoot, synapSyncDir);
+  for (const link of symlinks) {
+    items.push(`${path16.relative(projectRoot, link)} (symlink)`);
+  }
+  if (fs14.existsSync(synapSyncDir)) {
+    items.push(path16.relative(projectRoot, synapSyncDir) + "/");
+  }
+  const configPath = path16.join(projectRoot, "synapsync.config.yaml");
+  if (fs14.existsSync(configPath)) {
+    items.push("synapsync.config.yaml");
+  }
+  const gitignorePath = path16.join(projectRoot, ".gitignore");
+  if (fs14.existsSync(gitignorePath)) {
+    const content = fs14.readFileSync(gitignorePath, "utf-8");
+    if (content.includes("# SynapSync")) {
+      items.push(".gitignore (SynapSync entries)");
+    }
+  }
+  return items;
+}
+function findSynapSyncSymlinks(projectRoot, synapSyncDir) {
+  const symlinks = [];
+  const resolvedSynapSync = path16.resolve(synapSyncDir);
+  for (const provider of SUPPORTED_PROVIDERS) {
+    const providerPaths = PROVIDER_PATHS[provider];
+    for (const type of COGNITIVE_TYPES) {
+      const typePath = path16.join(projectRoot, providerPaths[type]);
+      if (!fs14.existsSync(typePath)) continue;
+      try {
+        const entries = fs14.readdirSync(typePath, { withFileTypes: true });
+        for (const entry of entries) {
+          const fullPath = path16.join(typePath, entry.name);
+          if (entry.isSymbolicLink()) {
+            const target = path16.resolve(typePath, fs14.readlinkSync(fullPath));
+            if (target.startsWith(resolvedSynapSync)) {
+              symlinks.push(fullPath);
+            }
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  return symlinks;
+}
+function removeProviderSymlinks(projectRoot, synapSyncDir) {
+  const symlinks = findSynapSyncSymlinks(projectRoot, synapSyncDir);
+  for (const link of symlinks) {
+    fs14.unlinkSync(link);
+    logger.log(`  ${pc16.red("\u2717")} Removed symlink ${path16.relative(projectRoot, link)}`);
+  }
+  return symlinks.length;
+}
+function cleanGitignore(projectRoot) {
+  const gitignorePath = path16.join(projectRoot, ".gitignore");
+  if (!fs14.existsSync(gitignorePath)) return false;
+  const content = fs14.readFileSync(gitignorePath, "utf-8");
+  if (!content.includes("# SynapSync")) return false;
+  const cleaned = content.replace(/\n?# SynapSync\n\.synapsync\/manifest\.json\n\*\.local\.yaml\n?/g, "").replace(/^\s*\n$/gm, "\n");
+  if (cleaned.trim() === "") {
+    fs14.unlinkSync(gitignorePath);
+  } else {
+    fs14.writeFileSync(gitignorePath, cleaned, "utf-8");
+  }
+  return true;
+}
+function registerPurgeCommand(program) {
+  program.command("purge").description("Completely remove SynapSync from the project").option("-f, --force", "Skip confirmation and remove everything").action((options) => {
+    executePurgeCommand(options);
+  });
+}
+
 // src/ui/repl.ts
 var COMMANDS = {};
 function registerInteractiveCommand(name, description, handler, options) {
@@ -5444,24 +5569,24 @@ function showCommandHelp(commandName) {
     return;
   }
   logger.line();
-  logger.log(pc16.bold(pc16.cyan(`  /${commandName}`)) + pc16.dim(` - ${cmd.description}`));
+  logger.log(pc17.bold(pc17.cyan(`  /${commandName}`)) + pc17.dim(` - ${cmd.description}`));
   logger.line();
   if (cmd.usage) {
-    logger.log(pc16.bold("  Usage:"));
-    logger.log(`    ${pc16.cyan(cmd.usage)}`);
+    logger.log(pc17.bold("  Usage:"));
+    logger.log(`    ${pc17.cyan(cmd.usage)}`);
     logger.line();
   }
   if (cmd.options && cmd.options.length > 0) {
-    logger.log(pc16.bold("  Options:"));
+    logger.log(pc17.bold("  Options:"));
     for (const opt of cmd.options) {
-      logger.log(`    ${pc16.yellow(opt.flag.padEnd(16))} ${pc16.dim(opt.description)}`);
+      logger.log(`    ${pc17.yellow(opt.flag.padEnd(16))} ${pc17.dim(opt.description)}`);
     }
     logger.line();
   }
   if (cmd.examples && cmd.examples.length > 0) {
-    logger.log(pc16.bold("  Examples:"));
+    logger.log(pc17.bold("  Examples:"));
     for (const example of cmd.examples) {
-      logger.log(`    ${pc16.dim("$")} ${pc16.cyan(example)}`);
+      logger.log(`    ${pc17.dim("$")} ${pc17.cyan(example)}`);
     }
     logger.line();
   }
@@ -5478,17 +5603,17 @@ registerInteractiveCommand(
     logger.line();
     logger.bold("  Available Commands:");
     logger.line();
-    logger.log(`  ${pc16.cyan("/help [command]")}    ${pc16.dim("Show help (or help for a command)")}`);
-    logger.log(`  ${pc16.cyan("/clear")}             ${pc16.dim("Clear the screen")}`);
-    logger.log(`  ${pc16.cyan("/exit")}              ${pc16.dim("Exit interactive mode")}`);
+    logger.log(`  ${pc17.cyan("/help [command]")}    ${pc17.dim("Show help (or help for a command)")}`);
+    logger.log(`  ${pc17.cyan("/clear")}             ${pc17.dim("Clear the screen")}`);
+    logger.log(`  ${pc17.cyan("/exit")}              ${pc17.dim("Exit interactive mode")}`);
     logger.line();
     const categories = {
       "Information": ["info", "version"],
       "Project": ["init", "config", "status"],
       "Providers": ["providers"],
-      "Cognitives": ["search", "install", "list", "uninstall", "create"],
-      "Sync": ["sync", "push", "pull"],
-      "Maintenance": ["update", "doctor", "clean"]
+      "Cognitives": ["search", "add", "list", "uninstall"],
+      "Sync": ["sync"],
+      "Maintenance": ["update", "doctor", "clean", "purge"]
     };
     for (const [category, cmds] of Object.entries(categories)) {
       const availableCmds = cmds.filter((name) => COMMANDS[name]);
@@ -5498,8 +5623,8 @@ registerInteractiveCommand(
           const cmd = COMMANDS[name];
           const hasOptions = cmd?.options !== void 0 && cmd.options.length > 0;
           const paddedName = `/${name}`.padEnd(18);
-          const optionsHint = hasOptions ? pc16.yellow(" [options]") : "";
-          logger.log(`  ${pc16.cyan(paddedName)} ${pc16.dim(cmd?.description ?? "")}${optionsHint}`);
+          const optionsHint = hasOptions ? pc17.yellow(" [options]") : "";
+          logger.log(`  ${pc17.cyan(paddedName)} ${pc17.dim(cmd?.description ?? "")}${optionsHint}`);
         }
         logger.line();
       }
@@ -5509,7 +5634,7 @@ registerInteractiveCommand(
   },
   {
     usage: "/help [command]",
-    examples: ["/help", "/help info", "/help install"]
+    examples: ["/help", "/help info", "/help add"]
   }
 );
 registerInteractiveCommand("clear", "Clear the screen", (_args) => {
@@ -5532,13 +5657,13 @@ registerInteractiveCommand(
     usage: "/info [--topic]",
     options: [
       { flag: "--cognitives", description: "Types of AI cognitives (skills, agents, etc.)" },
-      { flag: "--install", description: "How to install from registry, GitHub, local" },
+      { flag: "--add", description: "How to add from registry, GitHub, local" },
       { flag: "--providers", description: "Supported AI providers" },
       { flag: "--categories", description: "Cognitive organization categories" },
       { flag: "--sync", description: "How synchronization works" },
       { flag: "--structure", description: "Project directory structure" }
     ],
-    examples: ["/info", "/info --cognitives", "/info --install"]
+    examples: ["/info", "/info --cognitives", "/info --add"]
   }
 );
 registerInteractiveCommand(
@@ -5644,8 +5769,8 @@ registerInteractiveCommand(
   }
 );
 registerInteractiveCommand(
-  "install",
-  "Install a cognitive from registry, local path, or GitHub",
+  "add",
+  "Add a cognitive from registry, local path, or GitHub",
   async (args) => {
     const parts = args.split(/\s+/);
     let source;
@@ -5659,33 +5784,29 @@ registerInteractiveCommand(
         options["category"] = parts[++i] ?? "";
       } else if (part === "--force" || part === "-f") {
         options["force"] = true;
-      } else if (part === "--sync" || part === "-s") {
-        options["sync"] = true;
       } else if (!part.startsWith("-")) {
         source = part;
       }
     }
     if (source === void 0 || source === "") {
-      logger.error("Please specify a cognitive to install.");
-      logger.hint("Usage: /install <name|path|github:user/repo>");
+      logger.error("Please specify a cognitive to add.");
+      logger.hint("Usage: /add <name|path|github:user/repo>");
       return;
     }
-    await executeInstallCommand(source, options);
+    await executeAddCommand(source, options);
   },
   {
-    usage: "/install <source> [options]",
+    usage: "/add <source> [options]",
     options: [
       { flag: "-t, --type <type>", description: "Cognitive type (skill, agent, etc.)" },
       { flag: "-c, --category <cat>", description: "Category (overrides default)" },
-      { flag: "-f, --force", description: "Overwrite if already installed" },
-      { flag: "-s, --sync", description: "Sync to providers after installation" }
+      { flag: "-f, --force", description: "Overwrite if already installed" }
     ],
     examples: [
-      "/install skill-creator",
-      "/install skill-creator --sync",
-      "/install ./my-skill",
-      "/install github:user/repo",
-      "/install skill-creator --force"
+      "/add skill-creator",
+      "/add ./my-skill",
+      "/add github:user/repo",
+      "/add skill-creator --force"
     ]
   }
 );
@@ -5755,9 +5876,6 @@ registerInteractiveCommand(
     examples: ["/uninstall skill-creator", "/uninstall my-agent --force"]
   }
 );
-registerInteractiveCommand("create", "Create a new asset", (_args) => {
-  showInfo("Command not yet implemented. Coming in Phase 2.");
-});
 registerInteractiveCommand(
   "sync",
   "Sync cognitives to providers",
@@ -5810,12 +5928,6 @@ registerInteractiveCommand(
     examples: ["/sync", "/sync status", "/sync --dry-run", "/sync --provider claude"]
   }
 );
-registerInteractiveCommand("push", "Push local cognitives to registry", (_args) => {
-  showInfo("Command not yet implemented. Coming in Phase 3.");
-});
-registerInteractiveCommand("pull", "Pull latest cognitives from registry", (_args) => {
-  showInfo("Command not yet implemented. Coming in Phase 3.");
-});
 registerInteractiveCommand(
   "update",
   "Update installed cognitives",
@@ -5912,10 +6024,31 @@ registerInteractiveCommand(
     examples: ["/clean", "/clean --dry-run", "/clean --force"]
   }
 );
+registerInteractiveCommand(
+  "purge",
+  "Completely remove SynapSync from the project",
+  (args) => {
+    const parts = args.split(/\s+/);
+    const options = {};
+    for (const part of parts) {
+      if (part === "--force" || part === "-f") {
+        options["force"] = true;
+      }
+    }
+    executePurgeCommand(options);
+  },
+  {
+    usage: "/purge [options]",
+    options: [
+      { flag: "-f, --force", description: "Skip confirmation and remove everything" }
+    ],
+    examples: ["/purge", "/purge --force"]
+  }
+);
 registerInteractiveCommand("version", "Show version information", async (_args) => {
   const { version: version2 } = await Promise.resolve().then(() => (init_version(), version_exports));
   logger.line();
-  logger.log(`${pc16.bold("SynapSync CLI")} ${pc16.cyan(`v${version2}`)}`);
+  logger.log(`${pc17.bold("SynapSync CLI")} ${pc17.cyan(`v${version2}`)}`);
   logger.line();
   logger.label("Node.js", process.version);
   logger.label("Platform", `${process.platform} ${process.arch}`);
@@ -5928,7 +6061,7 @@ async function executeCommand(input) {
   }
   if (!trimmed.startsWith("/")) {
     showError(`Unknown input. Commands must start with /`);
-    logger.log(`${pc16.dim("Type")} ${pc16.cyan("/help")} ${pc16.dim("for available commands.")}`);
+    logger.log(`${pc17.dim("Type")} ${pc17.cyan("/help")} ${pc17.dim("for available commands.")}`);
     return;
   }
   const parts = trimmed.slice(1).split(/\s+/);
@@ -5940,7 +6073,7 @@ async function executeCommand(input) {
   const command = COMMANDS[commandName];
   if (!command) {
     showError(`Unknown command: /${commandName}`);
-    logger.log(`${pc16.dim("Type")} ${pc16.cyan("/help")} ${pc16.dim("for available commands.")}`);
+    logger.log(`${pc17.dim("Type")} ${pc17.cyan("/help")} ${pc17.dim("for available commands.")}`);
     return;
   }
   try {
@@ -5956,13 +6089,13 @@ async function executeCommand(input) {
 function startInteractiveMode() {
   showBanner();
   logger.log(
-    `${pc16.dim("Type")} ${pc16.cyan("/help")} ${pc16.dim("for commands,")} ${pc16.cyan("/exit")} ${pc16.dim("to quit.")}`
+    `${pc17.dim("Type")} ${pc17.cyan("/help")} ${pc17.dim("for commands,")} ${pc17.cyan("/exit")} ${pc17.dim("to quit.")}`
   );
   logger.line();
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
-    prompt: `${pc16.green(CLI_NAME)} ${pc16.dim(">")} `,
+    prompt: `${pc17.green(CLI_NAME)} ${pc17.dim(">")} `,
     terminal: true
   });
   rl.on("line", (line) => {
@@ -5988,7 +6121,7 @@ init_version();
 
 // src/commands/help.ts
 init_esm_shims();
-import pc17 from "picocolors";
+import pc18 from "picocolors";
 function registerHelpCommand(program) {
   program.command("help [command]").description("Display help for a command").action((commandName) => {
     if (commandName) {
@@ -5998,7 +6131,7 @@ function registerHelpCommand(program) {
       } else {
         logger.error(`Unknown command: ${commandName}`);
         logger.line();
-        logger.log(`Run ${pc17.cyan("synapsync --help")} to see available commands.`);
+        logger.log(`Run ${pc18.cyan("synapsync --help")} to see available commands.`);
       }
     } else {
       program.outputHelp();
@@ -6009,7 +6142,7 @@ function registerHelpCommand(program) {
 // src/commands/version.ts
 init_esm_shims();
 init_version();
-import pc18 from "picocolors";
+import pc19 from "picocolors";
 var PACKAGE_NAME = "synapsync";
 function compareVersions(a, b) {
   const partsA = a.split(".").map(Number);
@@ -6050,12 +6183,12 @@ async function checkForUpdates() {
   const comparison = compareVersions(version, latestVersion);
   if (comparison < 0) {
     logger.line();
-    logger.warning(`Update available: ${pc18.cyan(`v${version}`)} \u2192 ${pc18.green(`v${latestVersion}`)}`);
+    logger.warning(`Update available: ${pc19.cyan(`v${version}`)} \u2192 ${pc19.green(`v${latestVersion}`)}`);
     logger.line();
-    logger.log(`  Run ${pc18.cyan("npm install -g synapsync")} to update`);
+    logger.log(`  Run ${pc19.cyan("npm install -g synapsync")} to update`);
   } else if (comparison > 0) {
-    logger.info(`You are running a development version (${pc18.cyan(`v${version}`)})`);
-    logger.log(`  Latest published: ${pc18.dim(`v${latestVersion}`)}`);
+    logger.info(`You are running a development version (${pc19.cyan(`v${version}`)})`);
+    logger.log(`  Latest published: ${pc19.dim(`v${latestVersion}`)}`);
   } else {
     logger.success("You are using the latest version");
   }
@@ -6063,7 +6196,7 @@ async function checkForUpdates() {
 function registerVersionCommand(program) {
   program.command("version").description("Show detailed version information").option("--check", "Check for available updates").action(async (options) => {
     logger.line();
-    logger.log(`${pc18.bold("SynapSync CLI")} ${pc18.cyan(`v${version}`)}`);
+    logger.log(`${pc19.bold("SynapSync CLI")} ${pc19.cyan(`v${version}`)}`);
     logger.line();
     logger.label("Node.js", process.version);
     logger.label("Platform", `${process.platform} ${process.arch}`);
@@ -6091,13 +6224,14 @@ function createCLI() {
   registerStatusCommand(program);
   registerProvidersCommand(program);
   registerSearchCommand(program);
-  registerInstallCommand(program);
+  registerAddCommand(program);
   registerListCommand(program);
   registerUninstallCommand(program);
   registerSyncCommand(program);
   registerUpdateCommand(program);
   registerDoctorCommand(program);
   registerCleanCommand(program);
+  registerPurgeCommand(program);
   return program;
 }
 async function runCLI(args = process.argv) {