snip-manager 0.1.0

package/lib/cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+const { program } = require('commander');
+const pkg = require('../package.json');
+const config = require('./config');
+const addCmd = require('./commands/add');
+const listCmd = require('./commands/list');
+const searchCmd = require('./commands/search');
+const showCmd = require('./commands/show');
+const runCmd = require('./commands/run');
+const cfgCmd = require('./commands/config');
+
+program.name('snip').version(pkg.version).description(pkg.description);
+
+program
+  .command('add <name>')
+  .description('Add a new snippet')
+  .option('--lang <lang>')
+  .option('--tags <tags>')
+  .action((name, opts) => addCmd(name, opts));
+
+program
+  .command('list')
+  .description('List snippets')
+  .option('-t, --tag <tag>')
+  .option('--lang <lang>')
+  .option('--sort <sort>', 'Sort by: name | usage | recent', 'name')
+  .action((opts) => listCmd(opts));
+
+program
+  .command('search <query>')
+  .description('Fuzzy search snippets')
+  .action((q) => searchCmd(q));
+
+program
+  .command('show <idOrName>')
+  .description('Show snippet content')
+  .option('--edit', 'Open in editor')
+  .action((idOrName, opts) => showCmd(idOrName, opts));
+
+program
+  .command('run <idOrName>')
+  .description('Run a snippet (preview + confirm)')
+  .option('--dry-run', 'Print but do not execute')
+  .option('--confirm', 'Skip confirmation prompt; allow running dangerous snippets (use with care)')
+  .action((idOrName, opts) => runCmd(idOrName, opts));
+
+program
+  .command('config <action> [key] [value]')
+  .description('Get or set config values')
+  .action((action, key, value) => cfgCmd(action, key, value));
+
+// additional commands
+const editCmd = require('./commands/edit');
+const rmCmd = require('./commands/rm');
+const exportCmd = require('./commands/export');
+const importCmd = require('./commands/import');
+const syncCmd = require('./commands/sync');
+
+program
+  .command('edit <idOrName>')
+  .description('Edit snippet in editor')
+  .action((idOrName) => editCmd(idOrName));
+
+program
+  .command('rm <idOrName>')
+  .description('Remove a snippet')
+  .action((idOrName) => rmCmd(idOrName));
+
+program
+  .command('export [path]')
+  .description('Export snippets to file (JSON)')
+  .action((path) => exportCmd(path));
+
+program
+  .command('import <file>')
+  .description('Import snippets from file')
+  .action((file) => importCmd(file));
+
+program
+  .command('sync <action> [id]')
+  .description('Sync snippets with GitHub Gists: push|pull')
+  .action((action, id) => syncCmd(action, id));
+
+const uiCmd = require('./commands/ui');
+program
+  .command('ui')
+  .description('Interactive TUI: j/k + Ctrl+d/u navigation, Enter show, c copy, r run, t tag filter, / search')
+  .action(() => uiCmd());
+
+const seedCmd = require('../scripts/seed-examples.js');
+program
+  .command('seed')
+  .description('Clear all snippet data (JSON + SQLite) and add 10 example snippets')
+  .action(() => seedCmd.main());
+
+const fs = require('fs');
+const cfg = config.loadConfig();
+
+// First-run onboarding: when no commands provided and DB missing
+if (process.argv.length <= 2) {
+  try {
+    if (!fs.existsSync(cfg.dbPath)) {
+      console.log('\nWelcome to snip — your terminal snippet manager!');
+      console.log('\nQuick start:\n  1) Set your editor: snip config set editor "code --wait"\n  2) Add a snippet: echo "echo \'hello\'" | snip add hello --lang sh --tags demo\n  3) List snippets: snip list\n  4) Search and run: snip search hello && snip run hello --dry-run');
+      console.log('\nTip: install locally with `npm link` to use the `snip` command.\n');
+    }
+  } catch (e) {}
+}
+
+program.on('--help', () => {
+  console.log('\nQuick start:\n  echo \'echo "hello"\' | snip add test --lang sh --tags demo\n  snip list\n  snip search hello\n  snip run test --dry-run\n');
+});
+
+program.parse(process.argv);

package/lib/clipboard.js

@@ -0,0 +1,37 @@
+const { spawnSync } = require('child_process');
+
+function getClipboardCommands(platform = process.platform) {
+  if (platform === 'darwin') {
+    return [['pbcopy', []]];
+  }
+  if (platform === 'win32') {
+    return [['clip', []], ['powershell', ['-NoProfile', '-Command', 'Set-Clipboard']]];
+  }
+  return [
+    ['wl-copy', []],
+    ['xclip', ['-selection', 'clipboard']],
+    ['xsel', ['--clipboard', '--input']]
+  ];
+}
+
+function copyText(text, platform = process.platform, runner = spawnSync) {
+  const payload = String(text == null ? '' : text);
+  const commands = getClipboardCommands(platform);
+  let lastError = null;
+
+  for (const [cmd, args] of commands) {
+    const res = runner(cmd, args, {
+      input: payload,
+      encoding: 'utf8',
+      stdio: ['pipe', 'ignore', 'ignore']
+    });
+    if (!res.error && res.status === 0) {
+      return { ok: true, command: cmd };
+    }
+    lastError = res.error || new Error(`${cmd} exited with status ${res.status}`);
+  }
+
+  return { ok: false, error: lastError };
+}
+
+module.exports = { copyText, getClipboardCommands };

package/lib/commands/add.js

@@ -0,0 +1,36 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const storage = require('../storage');
+const config = require('../config');
+
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', chunk => data += chunk);
+    process.stdin.on('end', () => resolve(data));
+    process.stdin.on('error', reject);
+  });
+}
+
+async function add(name, opts) {
+  const cfg = config.loadConfig();
+  let content = '';
+  if (!process.stdin.isTTY) {
+    content = await readStdin();
+  } else {
+    const tmp = path.join(os.tmpdir(), `snip-${Date.now()}.tmp`);
+    fs.writeFileSync(tmp, `# Snippet: ${name}\n\n`);
+    const editor = cfg.editor.split(' ');
+    spawnSync(editor[0], editor.slice(1).concat([tmp]), { stdio: 'inherit' });
+    content = fs.readFileSync(tmp, 'utf8');
+    fs.unlinkSync(tmp);
+  }
+  const tags = opts.tags ? opts.tags.split(',').map(t => t.trim()) : [];
+  const snippet = storage.addSnippet({ name, content, language: opts.lang, tags });
+  console.log(`Added snippet ${snippet.name} (${snippet.id})`);
+}
+
+module.exports = add;

package/lib/commands/config.js

@@ -0,0 +1,19 @@
+const cfg = require('../config');
+
+function run(action, key, value) {
+  if (action === 'get') {
+    const c = cfg.loadConfig();
+    if (!key) return console.log(JSON.stringify(c, null, 2));
+    return console.log((c && c[key]) || '');
+  }
+  if (action === 'set') {
+    if (!key) return console.error('Key required for set');
+    const obj = {};
+    obj[key] = value;
+    cfg.saveConfig(obj);
+    return console.log('OK');
+  }
+  console.error('Unknown action; use get/set');
+}
+
+module.exports = run;

package/lib/commands/edit.js

@@ -0,0 +1,26 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const storage = require('../storage');
+const config = require('../config');
+const { spawnSync } = require('child_process');
+
+function edit(idOrName) {
+  const s = storage.getSnippetByIdOrName(idOrName);
+  if (!s) return console.error('Snippet not found');
+  const content = storage.readSnippetContent(s);
+  const editor = (config.loadConfig().editor || process.env.EDITOR || 'vi').split(' ');
+  const fileToEdit = s.path || path.join(os.tmpdir(), `snip-edit-${s.id}.tmp`);
+  if (!s.path) fs.writeFileSync(fileToEdit, content, 'utf8');
+  spawnSync(editor[0], editor.slice(1).concat([fileToEdit]), { stdio: 'inherit' });
+  const newContent = fs.readFileSync(fileToEdit, 'utf8');
+  if (!s.path) try { fs.unlinkSync(fileToEdit); } catch (e) { }
+  if (newContent !== content) {
+    storage.updateSnippetContent(s.id, newContent);
+    console.log(`Updated "${s.name}"`);
+  } else {
+    console.log('No changes.');
+  }
+}
+
+module.exports = edit;

package/lib/commands/export.js

@@ -0,0 +1,23 @@
+const fs = require('fs');
+const storage = require('../storage');
+
+function exportCmd(pathArg) {
+  const items = storage.listSnippets().map(s => ({
+    id: s.id,
+    name: s.name,
+    language: s.language,
+    tags: s.tags,
+    createdAt: s.createdAt,
+    updatedAt: s.updatedAt,
+    content: storage.readSnippetContent(s)
+  }));
+  const out = JSON.stringify({ exportedAt: new Date().toISOString(), snippets: items }, null, 2);
+  if (!pathArg) {
+    console.log(out);
+    return;
+  }
+  fs.writeFileSync(pathArg, out, 'utf8');
+  console.log('Exported to', pathArg);
+}
+
+module.exports = exportCmd;

package/lib/commands/import.js

@@ -0,0 +1,18 @@
+const fs = require('fs');
+const storage = require('../storage');
+
+function importCmd(file) {
+  try {
+    const raw = fs.readFileSync(file, 'utf8');
+    const parsed = JSON.parse(raw);
+    const list = parsed.snippets || parsed;
+    list.forEach(s => {
+      storage.addSnippet({ name: s.name || 'imported', content: s.content || '', language: s.language, tags: s.tags });
+    });
+    console.log('Imported', list.length, 'snippets');
+  } catch (e) {
+    console.error('Import failed', e.message);
+  }
+}
+
+module.exports = importCmd;

package/lib/commands/list.js

@@ -0,0 +1,81 @@
+const storage = require('../storage');
+let chalk = null;
+try {
+  const chalkModule = require('chalk');
+  chalk = (chalkModule && chalkModule.default) ? chalkModule.default : chalkModule;
+} catch (e) { }
+
+// Helpers — gracefully degrade to plain text when chalk is unavailable
+const c = {
+  name: (t) => chalk ? chalk.hex('#89B4FA').bold(t) : t,
+  tag: (t) => chalk ? chalk.hex('#94E2D5')(t) : t,
+  muted: (t) => chalk ? chalk.hex('#6C7086')(t) : t,
+  badge: (t) => chalk ? chalk.hex('#F5C2E7')(t) : t,
+  dim: (t) => chalk ? chalk.dim(t) : t,
+};
+
+const SORTERS = {
+  name: (a, b) => String(a.name || '').localeCompare(String(b.name || '')),
+  usage: (a, b) => {
+    const diff = (b.usageCount || 0) - (a.usageCount || 0);
+    if (diff !== 0) return diff;
+    return String(a.name || '').localeCompare(String(b.name || ''));
+  },
+  recent: (a, b) => {
+    const aTs = Date.parse(a.lastUsedAt || a.updatedAt || a.createdAt || 0) || 0;
+    const bTs = Date.parse(b.lastUsedAt || b.updatedAt || b.createdAt || 0) || 0;
+    if (bTs !== aTs) return bTs - aTs;
+    return String(a.name || '').localeCompare(String(b.name || ''));
+  }
+};
+
+function normalizeSort(sort) {
+  const key = String(sort || 'name').trim().toLowerCase();
+  return SORTERS[key] ? key : 'name';
+}
+
+function list(opts) {
+  const items = storage.listSnippets();
+  const filtered = items.filter(s => {
+    if (opts.tag && (!s.tags || !s.tags.includes(opts.tag))) return false;
+    if (opts.lang && s.language !== opts.lang) return false;
+    return true;
+  });
+  const sortBy = normalizeSort(opts.sort);
+  filtered.sort(SORTERS[sortBy]);
+  if (filtered.length === 0) return console.log(c.muted('No snippets found.'));
+
+  // Column widths
+  const nameW = 28;
+  const langW = 10;
+  const tagsW = 30;
+  const usageW = 6;
+
+  // Header
+  console.log(
+    c.dim('  ' +
+      'NAME'.padEnd(nameW) +
+      'LANG'.padEnd(langW) +
+      'TAGS'.padEnd(tagsW) +
+      'USED'.padStart(usageW))
+  );
+  console.log(c.dim('  ' + '─'.repeat(nameW + langW + tagsW + usageW)));
+
+  // Rows
+  filtered.forEach(s => {
+    const name = c.name(String(s.name || 'untitled').slice(0, nameW - 2).padEnd(nameW));
+    const lang = c.muted((s.language || '–').padEnd(langW));
+    const tags = (s.tags || []).length
+      ? c.tag((s.tags || []).join(', ').slice(0, tagsW - 2).padEnd(tagsW))
+      : c.muted('–'.padEnd(tagsW));
+    const usage = s.usageCount
+      ? c.badge(String(s.usageCount).padStart(usageW))
+      : c.muted('0'.padStart(usageW));
+    console.log(`  ${name}${lang}${tags}${usage}`);
+  });
+
+  console.log(c.dim(`\n  ${filtered.length} snippet${filtered.length === 1 ? '' : 's'}`));
+}
+
+module.exports = list;
+

package/lib/commands/rm.js

@@ -0,0 +1,10 @@
+const storage = require('../storage');
+
+function remove(idOrName) {
+  const s = storage.getSnippetByIdOrName(idOrName);
+  if (!s) return console.error('Snippet not found');
+  storage.deleteSnippetById(s.id);
+  console.log('Removed', s.id);
+}
+
+module.exports = remove;

package/lib/commands/run.js

@@ -0,0 +1,34 @@
+const storage = require('../storage');
+const exec = require('../exec');
+const config = require('../config');
+
+function run(idOrName, opts) {
+  const s = storage.getSnippetByIdOrName(idOrName);
+  if (!s) return console.error('Snippet not found');
+  const content = storage.readSnippetContent(s);
+  const cfg = config.loadConfig();
+  const runner = exec.resolveRunner(s.language, cfg.defaultShell);
+  console.log(`--- Preview (${runner.command}) ---`);
+  console.log(content);
+  const doConfirm = cfg.confirmRun && !opts.confirm;
+  const safety = require('../safety');
+  if (safety.isDangerous(content)) {
+    console.error('Warning: snippet contains potentially dangerous commands. Aborting. Use --confirm to override.');
+    if (!opts.confirm) return process.exitCode = 2;
+  }
+  if (opts['dryRun']) return exec.runSnippetContent(content, { dryRun: true });
+  if (doConfirm) {
+    const readline = require('readline-sync');
+    const ans = readline.question('Run snippet? (y/N): ');
+    if (!['y', 'Y', 'yes'].includes(ans)) return console.log('Aborted');
+  }
+  const status = exec.runSnippetContent(content, {
+    dryRun: false,
+    shell: cfg.defaultShell,
+    language: s.language
+  });
+  if (status === 0) storage.touchUsage(s);
+  process.exitCode = status;
+}
+
+module.exports = run;

package/lib/commands/search.js

@@ -0,0 +1,13 @@
+const search = require('../search');
+const storage = require('../storage');
+
+function run(query) {
+  const results = search.search(query, 15);
+  if (!results.length) return console.log('No results');
+  results.forEach((r, i) => {
+    const snip = storage.getSnippetByIdOrName(r.id);
+    console.log(`${i+1}. ${snip.name} (${snip.id}) [${(snip.tags||[]).join(', ')}]`);
+  });
+}
+
+module.exports = run;

package/lib/commands/show.js

@@ -0,0 +1,29 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const storage = require('../storage');
+const { spawnSync } = require('child_process');
+
+function show(idOrName, opts) {
+  const s = storage.getSnippetByIdOrName(idOrName);
+  if (!s) return console.error('Snippet not found');
+  const content = storage.readSnippetContent(s);
+  if (opts.edit) {
+    const editor = (require('../config').loadConfig().editor || 'vi').split(' ');
+    const fileToEdit = s.path || path.join(os.tmpdir(), `snip-show-${s.id}.tmp`);
+    if (!s.path) fs.writeFileSync(fileToEdit, content, 'utf8');
+    spawnSync(editor[0], editor.slice(1).concat([fileToEdit]), { stdio: 'inherit' });
+    if (!s.path) {
+      const newContent = fs.readFileSync(fileToEdit, 'utf8');
+      fs.unlinkSync(fileToEdit);
+      storage.updateSnippetContent(s.id, newContent);
+    } else {
+      storage.updateSnippetUpdatedAt(s.id);
+    }
+    return;
+  }
+  console.log('--- ' + s.name + ' ---');
+  console.log(content);
+}
+
+module.exports = show;

package/lib/commands/sync.js

@@ -0,0 +1,27 @@
+const gist = require('../sync/gist');
+const cfg = require('../config');
+
+async function run(action, id) {
+  const config = cfg.loadConfig();
+  const token = config.gist_token;
+  try {
+    if (action === 'push') {
+      if (!id) return console.error('Usage: snip sync push <snippetId|name>');
+      if (!token) return console.error('No gist token found. Set SNIP_GIST_TOKEN env var or: snip config set gist_token <token>');
+      const res = await gist.pushSnippet(id, token);
+      console.log('Pushed to gist:', res.html_url || res.id);
+      return;
+    }
+    if (action === 'pull') {
+      if (!id) return console.error('Usage: snip sync pull <gistId>');
+      const imported = await gist.pullGist(id, token);
+      console.log('Imported', imported.length, 'files from gist', id);
+      return;
+    }
+    console.error('Unknown action. Use push|pull');
+  } catch (e) {
+    console.error('Sync failed:', e.message);
+  }
+}
+
+module.exports = run;