@impulselab/directory 1.0.8 → 2.7.4

package/index.js

@@ -1,666 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const https = require('https');
-const http = require('http');
-const os = require('os');
-
-const PACKAGE = {
-	scopeName: '@impulselab/directory',
-	commandName: 'impulse-directory',
-	aliasName: 'directory',
-	brand: 'Impulse Lab',
-	websiteUrl: 'https://impulselab.ai',
-};
-
-const DEFAULT_BASE_URL = 'impulse.directory';
-const RAW_PATH = '/raw/';
-const STACK_API_PREFIX = '/api/stacks/';
-const STACK_API_SUFFIX = '/npx';
-
-function normalizeBaseHost(input) {
-	const raw = (input || '').trim();
-	if (!raw) return '';
-	let host = raw.replace(/^\s*https?:\/\//i, '');
-	host = host.replace(/\/+$/, '');
-	return host;
-}
-
-function isLocalHost(host) {
-	const hostnameOnly = (host || '').split(':')[0];
-	return (
-		hostnameOnly === 'localhost' ||
-		hostnameOnly === '127.0.0.1' ||
-		hostnameOnly === '::1'
-	);
-}
-
-function canFallbackToHttp(host) {
-	return process.env.ALLOW_HTTP_FALLBACK === '1' || isLocalHost(host);
-}
-
-const MODES = {
-  COMMAND: 'command',
-  STACK: 'stack',
-};
-
-const INSTALLATION_TARGETS = {
-  CLAUDE_SLASH: 'claude-slash',
-  CLAUDE_SUB_AGENT: 'claude-sub-agent',
-  CLAUDE_SKILL: 'claude-skill',
-  CURSOR_COMMAND: 'cursor-command',
-  CURSOR_RULE: 'cursor-rule',
-};
-
-const DEFAULT_TARGET = INSTALLATION_TARGETS.CLAUDE_SLASH;
-
-const TARGET_CONFIG = {
-  [INSTALLATION_TARGETS.CLAUDE_SLASH]: {
-    label: 'Claude slash command',
-    description: '.claude/commands (falls back to ~/.claude/commands)',
-    resolveDirectory: () => resolveClaudeDirectory('commands'),
-    extension: '.md',
-  },
-  [INSTALLATION_TARGETS.CLAUDE_SUB_AGENT]: {
-    label: 'Claude sub agent',
-    description: '.claude/agents (falls back to ~/.claude/agents)',
-    resolveDirectory: () => resolveClaudeDirectory('agents'),
-    extension: '.md',
-  },
-  [INSTALLATION_TARGETS.CLAUDE_SKILL]: {
-    label: 'Claude Code skill',
-    description: '.claude/skills (project only)',
-    resolveDirectory: () => resolveClaudeSkillsDirectory(),
-    extension: '.md',
-    isSkill: true,
-  },
-  [INSTALLATION_TARGETS.CURSOR_COMMAND]: {
-    label: 'Cursor command',
-    description: '.cursor/commands (project only)',
-    resolveDirectory: () => resolveCursorDirectory('commands'),
-    extension: '.md',
-  },
-  [INSTALLATION_TARGETS.CURSOR_RULE]: {
-    label: 'Cursor rule',
-    description: '.cursor/rules (project only)',
-    resolveDirectory: () => resolveCursorDirectory('rules'),
-    extension: '.mdc',
-  },
-};
-
-const KNOWN_TARGETS = Object.keys(TARGET_CONFIG);
-
-function showHelp() {
-	const primaryUsageCmd = `npx impulse-directory`;
-	console.log(`
-Impulse Directory Command Installer
-Made by ${PACKAGE.brand} (${PACKAGE.websiteUrl})
-
-Usage:
-  ${primaryUsageCmd} <user-slug>/<command-slug> [--target <target>]
-  ${primaryUsageCmd} stack <stack-id>
-  
-
-Description:
-  Downloads a command from Impulse Directory and installs it in the right tool folder.
-  When using the stack mode, installs each prompt in the stack to its inferred target.
-
-Arguments:
-  user-slug/command-slug    The full path to the command (user/command)
-  stack-id                  The stack ULID shown in the Impulse Directory UI
-
-Options:
-  --target <target>         Installation target (optional for single commands)
-  -t <target>               Short alias for --target
-  --help, -h                Show this help text
-
-Targets:
-${KNOWN_TARGETS.map((key) => {
-	const config = TARGET_CONFIG[key];
-	const defaultLabel = key === DEFAULT_TARGET ? ' (default)' : '';
-	return `  ${key.padEnd(18)} ${config.label}${defaultLabel}\n        -> ${config.description}`;
-}).join('\n')}
-
-Environment Variables:
-  IMPULSE_BASE_URL    Base host for Impulse Directory (hostname[:port], no scheme, no trailing slash)
-                      Examples: impulse.directory | localhost:3000
-
-Examples:
-  ${primaryUsageCmd} john/my-awesome-command
-  ${primaryUsageCmd} john/my-awesome-command --target claude-sub-agent
-  ${primaryUsageCmd} john/my-awesome-command --target cursor-command
-  ${primaryUsageCmd} stack 01JH0000000ABCDEF --target claude-slash
-`);
-}
-
-function shouldUseHttps(baseUrl) {
-  if (baseUrl.includes('localhost') || baseUrl.includes('127.0.0.1')) {
-    return false;
-  }
-  return true;
-}
-
-function toKebabCase(input) {
-  return String(input)
-    .normalize('NFKD')                    // strip accents
-    .replace(/[\u0300-\u036f]/g, '')
-    .replace(/['"]/g, '')
-    .replace(/[^a-zA-Z0-9]+/g, '-')       // collapse non-alnum to dashes
-    .replace(/^-+|-+$/g, '')
-    .toLowerCase();
-}
-
-function stripTrailingIdSegment(slug) {
-  const normalized = toKebabCase(slug || '');
-  const segments = normalized.split('-');
-  if (segments.length <= 1) return normalized;
-  const last = segments[segments.length - 1];
-  if (/^[a-z0-9]{5,}$/i.test(last)) {
-    segments.pop();
-  }
-  return segments.join('-');
-}
-
-function sanitizeIdentifierForFilename(identifier) {
-  return String(identifier || '')
-    .normalize('NFKD')
-    .replace(/[\u0300-\u036f]/g, '')      // remove accents
-    .replace(/[\u0000-\u001f\u007f-\u009f]/g, '') // remove control chars
-    .replace(/[<>:"/\\|?*]/g, '')         // remove filesystem unsafe chars
-    .replace(/\.\./g, '')                 // remove parent directory traversal
-    .replace(/[/\\]+/g, '-')              // replace all path separators with dashes
-    .replace(/^\.+/g, '')                 // remove leading dots
-    .replace(/\.+$/g, '')                 // remove trailing dots
-    .replace(/^-+|-+$/g, '')              // trim edge dashes
-    .replace(/-+/g, '-')                  // collapse multiple dashes
-    .toLowerCase()
-    || 'unknown';                         // fallback for empty results
-}
-
-function downloadStack(baseUrl, stackId) {
-  return new Promise((resolve, reject) => {
-    const useHttps = shouldUseHttps(baseUrl);
-    const protocol = useHttps ? https : http;
-    const scheme = useHttps ? 'https' : 'http';
-    const url = `${scheme}://${baseUrl}${STACK_API_PREFIX}${stackId}${STACK_API_SUFFIX}`;
-
-    protocol
-      .get(url, (res) => {
-        if (res.statusCode === 200) {
-          let data = '';
-          res.on('data', (chunk) => {
-            data += chunk;
-          });
-          res.on('end', () => {
-            try {
-              const parsed = JSON.parse(data);
-              resolve(parsed);
-            } catch (parseError) {
-              reject(new Error('Received invalid JSON while downloading stack'));
-            }
-          });
-        } else if (res.statusCode === 404) {
-          reject(new Error(`Stack '${stackId}' not found (404)`));
-        } else if (useHttps && (res.statusCode === 500 || res.statusCode >= 400)) {
-          if (canFallbackToHttp(baseUrl)) {
-            console.log(`HTTPS failed (${res.statusCode}), trying HTTP...`);
-            downloadStackWithHttp(baseUrl, stackId)
-              .then(resolve)
-              .catch(reject);
-          } else {
-            reject(new Error(`HTTPS failed (${res.statusCode}) and HTTP fallback is disabled`));
-          }
-        } else {
-          reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
-        }
-      })
-      .on('error', (err) => {
-        if (useHttps) {
-          if (canFallbackToHttp(baseUrl)) {
-            console.log(`HTTPS failed (${err.message}), trying HTTP...`);
-            downloadStackWithHttp(baseUrl, stackId)
-              .then(resolve)
-              .catch(reject);
-          } else {
-            reject(err);
-          }
-        } else {
-          reject(err);
-        }
-      });
-  });
-}
-
-function downloadStackWithHttp(baseUrl, stackId) {
-  return new Promise((resolve, reject) => {
-    const url = `http://${baseUrl}${STACK_API_PREFIX}${stackId}${STACK_API_SUFFIX}`;
-
-    console.log(`Trying HTTP: ${url}`);
-
-    http
-      .get(url, (res) => {
-        if (res.statusCode === 200) {
-          let data = '';
-          res.on('data', (chunk) => {
-            data += chunk;
-          });
-          res.on('end', () => {
-            try {
-              const parsed = JSON.parse(data);
-              resolve(parsed);
-            } catch (parseError) {
-              reject(new Error('Received invalid JSON while downloading stack'));
-            }
-          });
-        } else if (res.statusCode === 404) {
-          reject(new Error(`Stack '${stackId}' not found (404)`));
-        } else {
-          reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
-        }
-      })
-      .on('error', reject);
-  });
-}
-
-function downloadRawWithHeaders(baseUrl, fullPath) {
-  return new Promise((resolve, reject) => {
-    const useHttps = shouldUseHttps(baseUrl);
-    const protocol = useHttps ? https : http;
-    const scheme = useHttps ? 'https' : 'http';
-    const url = `${scheme}://${baseUrl}${RAW_PATH}${fullPath}`;
-
-    const handleOk = (res) => {
-      let data = '';
-      res.on('data', (chunk) => { data += chunk; });
-      res.on('end', () => resolve({ content: data, headers: res.headers }));
-    };
-
-    const handleHttpsFailover = (reason) => {
-      if (useHttps && canFallbackToHttp(baseUrl)) {
-        console.log(`HTTPS failed (${reason}), trying HTTP...`);
-        downloadRawWithHeadersHttp(baseUrl, fullPath).then(resolve).catch(reject);
-      } else {
-        reject(new Error(typeof reason === 'string' ? reason : reason.message));
-      }
-    };
-
-    protocol
-      .get(url, (res) => {
-        if (res.statusCode === 200) return handleOk(res);
-        if (res.statusCode === 404) return reject(new Error(`Command '${fullPath}' not found (404)`));
-        return handleHttpsFailover(`${res.statusCode}`);
-      })
-      .on('error', handleHttpsFailover);
-  });
-}
-
-function downloadRawWithHeadersHttp(baseUrl, fullPath) {
-  return new Promise((resolve, reject) => {
-    const url = `http://${baseUrl}${RAW_PATH}${fullPath}`;
-    console.log(`Trying HTTP: ${url}`);
-    http
-      .get(url, (res) => {
-        if (res.statusCode === 200) {
-          let data = '';
-          res.on('data', (chunk) => { data += chunk; });
-          res.on('end', () => resolve({ content: data, headers: res.headers }));
-        } else if (res.statusCode === 404) {
-          reject(new Error(`Command '${fullPath}' not found (404)`));
-        } else {
-          reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
-        }
-      })
-      .on('error', reject);
-  });
-}
-
-function findClosestFolder(folderName) {
-  let currentDir = process.cwd();
-
-  while (true) {
-    const candidate = path.join(currentDir, folderName);
-    if (fs.existsSync(candidate)) {
-      return candidate;
-    }
-
-    const parentDir = path.dirname(currentDir);
-    if (parentDir === currentDir) {
-      break;
-    }
-    currentDir = parentDir;
-  }
-
-  return null;
-}
-
-function resolveClaudeDirectory(subFolder) {
-  const projectClaudeDir = findClosestFolder('.claude');
-  if (projectClaudeDir) {
-    return path.join(projectClaudeDir, subFolder);
-  }
-  return path.join(os.homedir(), '.claude', subFolder);
-}
-
-function resolveCursorDirectory(subFolder) {
-  const projectCursorDir = findClosestFolder('.cursor');
-  if (!projectCursorDir) {
-    const message =
-      'Unable to find a .cursor directory. Run this command from inside a Cursor project.';
-    throw new Error(message);
-  }
-  return path.join(projectCursorDir, subFolder);
-}
-
-function resolveClaudeSkillsDirectory() {
-  const projectClaudeDir = findClosestFolder('.claude');
-  if (!projectClaudeDir) {
-    const message =
-      'Unable to find a .claude directory. Run this command from inside a project with a .claude folder.';
-    throw new Error(message);
-  }
-  return path.join(projectClaudeDir, 'skills');
-}
-
-function ensureDirectoryExists(dirPath) {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-    console.log(`Created directory: ${dirPath}`);
-  }
-}
-
-function checkFileExists(commandsDir, filename) {
-  const filePath = path.join(commandsDir, filename);
-  return fs.existsSync(filePath);
-}
-
-function saveCommand({
-  directory,
-  filename,
-  content,
-  fullPath,
-  target,
-}) {
-  const targetConfig = TARGET_CONFIG[target];
-  const isSkill = targetConfig && targetConfig.isSkill;
-
-  let filePath;
-  let displayPath;
-  let commandName;
-
-  if (isSkill) {
-    const skillName = filename.replace(path.extname(filename), '');
-    const skillDir = path.join(directory, skillName);
-    ensureDirectoryExists(skillDir);
-    filePath = path.join(skillDir, 'SKILL.md');
-    const relativeDir = path.relative(process.cwd(), skillDir);
-    displayPath = relativeDir
-      ? path.join(relativeDir, 'SKILL.md')
-      : path.join(skillName, 'SKILL.md');
-    commandName = skillName;
-  } else {
-    filePath = path.join(directory, filename);
-    const relativeDir = path.relative(process.cwd(), directory);
-    displayPath = relativeDir
-      ? path.join(relativeDir, filename)
-      : filename;
-    commandName = filename.replace(path.extname(filename), '');
-  }
-
-  console.log(`📁 Saving ${isSkill ? 'skill' : 'command'} to ${displayPath}`);
-
-  fs.writeFileSync(filePath, content, 'utf8');
-
-  logSuccessMessage(target, fullPath, commandName);
-}
-
-function logSuccessMessage(target, fullPath, commandName) {
-  switch (target) {
-    case INSTALLATION_TARGETS.CLAUDE_SLASH:
-      console.log(`✅ Command '${fullPath}' installed successfully`);
-      console.log(`\n🎉 You can now use: /${commandName}`);
-      break;
-    case INSTALLATION_TARGETS.CLAUDE_SUB_AGENT:
-      console.log(`✅ Agent '${fullPath}' installed successfully`);
-      console.log(
-        `\n🎉 You can now select '${commandName}' from Claude Desktop's agent menu.`
-      );
-      break;
-    case INSTALLATION_TARGETS.CLAUDE_SKILL:
-      console.log(`✅ Skill '${fullPath}' installed successfully`);
-      console.log(
-        `\n🎉 Claude Code will now automatically use the '${commandName}' skill when relevant.`
-      );
-      break;
-    case INSTALLATION_TARGETS.CURSOR_COMMAND:
-      console.log(`✅ Cursor command '${fullPath}' installed successfully`);
-      console.log(
-        `\n🎉 Open Cursor and run '${commandName}' from the command palette.`
-      );
-      break;
-    case INSTALLATION_TARGETS.CURSOR_RULE:
-      console.log(`✅ Cursor rule '${fullPath}' installed successfully`);
-      console.log(
-        `\n🎉 Cursor will apply '${commandName}' to this project.`
-      );
-      break;
-    default:
-      console.log(`✅ '${fullPath}' installed successfully`);
-  }
-}
-
-function parseCommandArgs(args) {
-  let mode = MODES.COMMAND;
-  let identifier = null;
-  let target = null;
-  let showHelpFlag = false;
-
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-
-    if (arg === '--help' || arg === '-h') {
-      showHelpFlag = true;
-      continue;
-    }
-
-    if (arg.startsWith('--target')) {
-      let rawValue = null;
-      if (arg.includes('=')) {
-        rawValue = arg.split('=')[1];
-      } else {
-        rawValue = args[i + 1];
-        i += 1;
-      }
-
-      if (!rawValue) {
-        throw new Error('Missing value for --target option');
-      }
-
-      const normalizedTarget = rawValue.toLowerCase();
-      if (!KNOWN_TARGETS.includes(normalizedTarget)) {
-        throw new Error(
-          `Unknown target '${rawValue}'. Available targets: ${KNOWN_TARGETS.join(', ')}`
-        );
-      }
-
-      target = normalizedTarget;
-      continue;
-    }
-
-    if (arg === '-t') {
-      const rawValue = args[i + 1];
-      i += 1;
-
-      if (!rawValue) {
-        throw new Error('Missing value for -t option');
-      }
-
-      const normalizedTarget = rawValue.toLowerCase();
-      if (!KNOWN_TARGETS.includes(normalizedTarget)) {
-        throw new Error(
-          `Unknown target '${rawValue}'. Available targets: ${KNOWN_TARGETS.join(', ')}`
-        );
-      }
-
-      target = normalizedTarget;
-      continue;
-    }
-
-    if (mode === MODES.COMMAND && arg === 'stack' && !identifier) {
-      mode = MODES.STACK;
-      continue;
-    }
-
-    if (!identifier) {
-      identifier = arg;
-      continue;
-    }
-
-    throw new Error(`Unknown argument: ${arg}`);
-  }
-
-  return { mode, identifier, target, showHelp: showHelpFlag };
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  try {
-    const {
-      mode,
-      identifier,
-      target,
-      showHelp: helpRequested,
-    } = parseCommandArgs(args);
-
-    if (helpRequested || args.length === 0) {
-      showHelp();
-      return;
-    }
-
-    const baseUrl = normalizeBaseHost(process.env.IMPULSE_BASE_URL || DEFAULT_BASE_URL);
-
-    if (mode === MODES.COMMAND) {
-      if (!identifier) {
-        console.error('❌ Error: Missing command path');
-        showHelp();
-        process.exit(1);
-      }
-
-      if (!identifier.includes('/')) {
-        console.error('❌ Error: Path must include user/command format');
-        showHelp();
-        process.exit(1);
-      }
-
-      const resolvedTarget = target || DEFAULT_TARGET;
-      const targetConfig = TARGET_CONFIG[resolvedTarget];
-
-      if (!targetConfig) {
-        console.error(`❌ Error: Unsupported target '${resolvedTarget}'`);
-        process.exit(1);
-      }
-
-      const directory = targetConfig.resolveDirectory();
-
-      ensureDirectoryExists(directory);
-
-      const commandNameFromPath = identifier.split('/').pop();
-      // First download the content to capture headers (and title)
-      const { content, headers } = await downloadRawWithHeaders(baseUrl, identifier);
-      const titleHeader = headers['x-prompt-title'];
-      const title = Array.isArray(titleHeader) ? titleHeader[0] : titleHeader;
-
-      const baseNameCandidate = title
-        ? toKebabCase(title)
-        : stripTrailingIdSegment(commandNameFromPath);
-      const finalBaseName = sanitizeIdentifierForFilename(baseNameCandidate);
-
-      // Overwrite if exists; do not append author or random suffix
-      const filename = `${finalBaseName}${targetConfig.extension}`;
-
-      saveCommand({
-        directory,
-        filename,
-        content,
-        fullPath: identifier,
-        target: resolvedTarget,
-      });
-      return;
-    }
-
-    if (!identifier) {
-      console.error('❌ Error: Missing stack identifier');
-      showHelp();
-      process.exit(1);
-    }
-
-    const stackPayload = await downloadStack(baseUrl, identifier);
-    const stack = stackPayload.stack || {};
-    const prompts = Array.isArray(stackPayload.prompts)
-      ? stackPayload.prompts
-      : [];
-
-    console.log(
-      `📦 Installing stack '${stack.title || identifier}' (${prompts.length} prompt${
-        prompts.length === 1 ? '' : 's'
-      })`
-    );
-
-    let installed = 0;
-    let skipped = 0;
-
-    for (let index = 0; index < prompts.length; index += 1) {
-      const prompt = prompts[index];
-      const commandPath = prompt.path || prompt.slug || prompt.id || `prompt-${index + 1}`;
-      const baseName = prompt.title
-        ? toKebabCase(prompt.title)
-        : stripTrailingIdSegment(prompt.slug || `prompt-${index + 1}`);
-
-      const resolvedTarget = target || prompt.target || DEFAULT_TARGET;
-      const targetConfig = TARGET_CONFIG[resolvedTarget];
-      if (!targetConfig) {
-        console.warn(`⚠️  Skipping prompt '${commandPath}' (unsupported target '${resolvedTarget}')`);
-        skipped += 1;
-        continue;
-      }
-
-      const directory = targetConfig.resolveDirectory();
-      ensureDirectoryExists(directory);
-
-      // Sanitize and overwrite if exists (no author or random suffix)
-      const sanitizedBaseName = sanitizeIdentifierForFilename(baseName);
-      const filename = `${sanitizedBaseName}${targetConfig.extension}`;
-
-      if (!prompt.markdown) {
-        console.warn(`⚠️  Skipping prompt '${commandPath}' (no content available)`);
-        skipped += 1;
-        continue;
-      }
-
-      saveCommand({
-        directory,
-        filename,
-        content: prompt.markdown,
-        fullPath: commandPath,
-        target: resolvedTarget,
-      });
-      installed += 1;
-    }
-
-    console.log(
-      `🎉 Installed ${installed} prompt${installed === 1 ? '' : 's'} from stack '${
-        stack.title || identifier
-      }'${skipped ? ` (skipped ${skipped})` : ''}`
-    );
-  } catch (error) {
-    console.error(`❌ Error: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-if (require.main === module) {
-  main();
-}
-
-module.exports = { main };