sra-skills 0.1.0

package/index.mjs

@@ -0,0 +1,331 @@
+#!/usr/bin/env node
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync,
+         symlinkSync, unlinkSync, lstatSync, readlinkSync } from 'fs';
+import { join, basename, resolve } from 'path';
+import { homedir } from 'os';
+
+const HOME = homedir();
+const SRA_HOME = join(HOME, '.sra');
+const REPOS_DIR = join(SRA_HOME, 'repos');
+const MANIFEST = join(SRA_HOME, 'manifest.json');
+const AGENTS_SKILLS = join(HOME, '.agents', 'skills');
+
+// --- Tool registry ---
+
+const TOOLS = {
+  claude: {
+    detect: () => existsSync(join(HOME, '.claude')),
+    skillsDir: join(HOME, '.claude', 'skills'),
+    setup(repoPath) {
+      // Commands
+      const cmdsDir = join(repoPath, 'adapters', 'claude', 'commands');
+      const targetCmds = join(HOME, '.claude', 'commands');
+      if (existsSync(cmdsDir)) {
+        mkdirSync(targetCmds, { recursive: true });
+        for (const f of readdirSync(cmdsDir).filter(f => f.endsWith('.md'))) {
+          symlinkSafe(join(cmdsDir, f), join(targetCmds, f));
+          console.log(`  [claude] → commands/${f}`);
+        }
+      }
+      // Agents
+      const agentsDir = join(repoPath, 'adapters', 'claude', 'agents');
+      const targetAgents = join(HOME, '.claude', 'agents');
+      if (existsSync(agentsDir)) {
+        mkdirSync(targetAgents, { recursive: true });
+        for (const f of readdirSync(agentsDir).filter(f => f.endsWith('.md'))) {
+          symlinkSafe(join(agentsDir, f), join(targetAgents, f));
+          console.log(`  [claude] → agents/${f}`);
+        }
+      }
+      // MCP servers
+      const mcpBase = join(repoPath, 'mcp');
+      if (existsSync(mcpBase)) {
+        for (const dir of readdirSync(mcpBase)) {
+          if (dir === 'shared') continue;
+          const serverPy = join(mcpBase, dir, 'server.py');
+          if (!existsSync(serverPy)) continue;
+          const name = dir.replace(/-server$/, '');
+          try {
+            execSync(`claude mcp remove -s user "${dir}" 2>/dev/null; claude mcp remove -s user "${name}" 2>/dev/null; claude mcp add -s user "${name}" python3 "${serverPy}"`, { stdio: 'pipe' });
+            console.log(`  [claude] → MCP: ${name}`);
+          } catch { console.log(`  [claude] ⚠ MCP ${name} registration failed`); }
+        }
+      }
+    },
+    teardown(repoPath) {
+      const resolvedRepo = resolve(repoPath);
+      for (const subdir of ['commands', 'agents']) {
+        const dir = join(HOME, '.claude', subdir);
+        if (!existsSync(dir)) continue;
+        for (const f of readdirSync(dir)) {
+          const link = join(dir, f);
+          try {
+            if (lstatSync(link).isSymbolicLink()) {
+              const target = resolve(readlinkSync(link));
+              if (target.startsWith(resolvedRepo)) unlinkSync(link);
+            }
+          } catch {}
+        }
+      }
+      const mcpBase = join(repoPath, 'mcp');
+      if (existsSync(mcpBase)) {
+        for (const dir of readdirSync(mcpBase)) {
+          if (dir === 'shared') continue;
+          const name = dir.replace(/-server$/, '');
+          try { execSync(`claude mcp remove -s user "${name}" 2>/dev/null`, { stdio: 'pipe' }); } catch {}
+        }
+      }
+    },
+  },
+  codex: {
+    detect: () => existsSync(join(HOME, '.codex')),
+    skillsDir: null,
+  },
+  cursor: {
+    detect: () => existsSync(join(HOME, '.cursor')),
+    skillsDir: null,
+  },
+  openclaw: {
+    detect: () => { try { execSync('which openclaw', { stdio: 'pipe' }); return true; } catch { return false; } },
+    skillsDir: null,
+    setup(repoPath) {
+      const configPath = join(HOME, '.openclaw', 'openclaw.json');
+      if (!existsSync(configPath)) return;
+      try {
+        const config = JSON.parse(readFileSync(configPath, 'utf8'));
+        const extra = config?.skills?.load?.extraDirs || [];
+        if (!extra.includes(AGENTS_SKILLS)) {
+          extra.push(AGENTS_SKILLS);
+          config.skills = config.skills || {};
+          config.skills.load = config.skills.load || {};
+          config.skills.load.extraDirs = extra;
+          writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+          console.log(`  [openclaw] Added ${AGENTS_SKILLS} to extraDirs`);
+        }
+      } catch (e) { console.log(`  [openclaw] ⚠ Could not update config: ${e.message}`); }
+    },
+  },
+};
+
+// --- Core functions ---
+
+function readManifest() {
+  if (!existsSync(MANIFEST)) return { repos: {}, tools: [] };
+  return JSON.parse(readFileSync(MANIFEST, 'utf8'));
+}
+
+function writeManifest(m) {
+  mkdirSync(SRA_HOME, { recursive: true });
+  writeFileSync(MANIFEST, JSON.stringify(m, null, 2) + '\n');
+}
+
+function detectTools() {
+  return Object.entries(TOOLS).filter(([, t]) => t.detect()).map(([name]) => name);
+}
+
+function parseToolFlag(args) {
+  const idx = args.indexOf('--tool');
+  if (idx >= 0 && args[idx + 1]) {
+    const val = args[idx + 1];
+    args.splice(idx, 2);
+    return val === 'all' ? Object.keys(TOOLS) : [val];
+  }
+  return null;
+}
+
+function discoverSkills(repoPath) {
+  const skillsDir = join(repoPath, 'skills');
+  if (!existsSync(skillsDir)) return [];
+  return readdirSync(skillsDir)
+    .filter(name => existsSync(join(skillsDir, name, 'SKILL.md')))
+    .map(name => ({ name, path: join(skillsDir, name) }));
+}
+
+function symlinkSafe(target, linkPath) {
+  try { unlinkSync(linkPath); } catch {}
+  symlinkSync(target, linkPath);
+}
+
+function linkSkills(skills, tools) {
+  mkdirSync(AGENTS_SKILLS, { recursive: true });
+  for (const { name, path } of skills) {
+    symlinkSafe(path, join(AGENTS_SKILLS, name));
+  }
+  for (const toolName of tools) {
+    const tool = TOOLS[toolName];
+    if (!tool?.skillsDir) continue;
+    mkdirSync(tool.skillsDir, { recursive: true });
+    for (const { name } of skills) {
+      symlinkSafe(join(AGENTS_SKILLS, name), join(tool.skillsDir, name));
+    }
+  }
+  skills.forEach(s => console.log(`  → ${s.name}`));
+}
+
+function unlinkSkills(skills, tools) {
+  for (const { name } of skills) {
+    const link = join(AGENTS_SKILLS, name);
+    try { if (lstatSync(link).isSymbolicLink()) unlinkSync(link); } catch {}
+    for (const toolName of tools) {
+      const tool = TOOLS[toolName];
+      if (!tool?.skillsDir) continue;
+      const tl = join(tool.skillsDir, name);
+      try { if (lstatSync(tl).isSymbolicLink()) unlinkSync(tl); } catch {}
+    }
+  }
+}
+
+function getVersion(repoPath) {
+  try {
+    return execSync('git describe --tags --always', { cwd: repoPath, encoding: 'utf8' }).trim();
+  } catch { return 'unknown'; }
+}
+
+function repoNameFromUrl(url) {
+  return basename(url).replace(/\.git$/, '');
+}
+
+function mergeCredentials(repoPath) {
+  const tmplPath = join(repoPath, 'config', 'credentials.template.json');
+  if (!existsSync(tmplPath)) return;
+  const credDir = join(HOME, '.config', 'sra');
+  const credPath = join(credDir, 'credentials.json');
+  mkdirSync(credDir, { recursive: true });
+  const template = JSON.parse(readFileSync(tmplPath, 'utf8'));
+  const existing = existsSync(credPath) ? JSON.parse(readFileSync(credPath, 'utf8')) : {};
+  let added = 0;
+  for (const [key, value] of Object.entries(template)) {
+    if (!(key in existing)) { existing[key] = value; added++; }
+  }
+  writeFileSync(credPath, JSON.stringify(existing, null, 2) + '\n');
+  if (added > 0) console.log(`  Merged ${added} new credential key(s)`);
+}
+
+function runToolSetup(repoPath, tools) {
+  for (const name of tools) {
+    const tool = TOOLS[name];
+    if (tool?.setup) tool.setup(repoPath);
+  }
+}
+
+// --- Commands ---
+
+const rawArgs = process.argv.slice(2);
+const cmd = rawArgs[0];
+const cmdArgs = rawArgs.slice(1);
+
+if (cmd === 'add') {
+  const isLocal = cmdArgs.includes('--local');
+  const tools = parseToolFlag(cmdArgs) || detectTools();
+  const nameIdx = cmdArgs.indexOf('--name');
+  let url, name, repoPath;
+
+  if (isLocal) {
+    cmdArgs.splice(cmdArgs.indexOf('--local'), 1);
+    const localPath = cmdArgs.find(a => !a.startsWith('--'));
+    repoPath = resolve(localPath);
+    name = nameIdx >= 0 ? cmdArgs[nameIdx + 1] : basename(repoPath);
+    url = null;
+    mkdirSync(REPOS_DIR, { recursive: true });
+    const repoLink = join(REPOS_DIR, name);
+    if (repoPath !== repoLink) symlinkSafe(repoPath, repoLink);
+  } else {
+    url = cmdArgs.find(a => !a.startsWith('--'));
+    if (!url) { console.error('Usage: sra add <git-url> [--tool <tool>] [--name <name>]'); process.exit(1); }
+    name = nameIdx >= 0 ? cmdArgs[nameIdx + 1] : repoNameFromUrl(url);
+    repoPath = join(REPOS_DIR, name);
+    mkdirSync(REPOS_DIR, { recursive: true });
+    if (existsSync(repoPath)) {
+      console.log(`Repo "${name}" exists, updating...`);
+      execSync('git pull', { cwd: repoPath, stdio: 'inherit' });
+    } else {
+      console.log(`Cloning ${url}...`);
+      execSync(`git clone --depth 1 "${url}" "${repoPath}"`, { stdio: 'inherit' });
+    }
+  }
+
+  const skills = discoverSkills(repoPath);
+  console.log(`Found ${skills.length} skills, tools: [${tools.join(', ')}]`);
+  linkSkills(skills, tools);
+  mergeCredentials(repoPath);
+  runToolSetup(repoPath, tools);
+
+  const m = readManifest();
+  m.repos[name] = { path: repoPath, ...(url && { url }), version: getVersion(repoPath),
+    updated_at: new Date().toISOString() };
+  m.tools = tools;
+  writeManifest(m);
+  console.log(`Done. ${name}: ${m.repos[name].version}`);
+
+} else if (cmd === 'remove') {
+  const name = cmdArgs[0];
+  if (!name) { console.error('Usage: sra remove <repo-name>'); process.exit(1); }
+  const m = readManifest();
+  const repo = m.repos[name];
+  if (!repo) { console.error(`Repo "${name}" not found`); process.exit(1); }
+
+  const tools = m.tools || detectTools();
+  const skills = discoverSkills(repo.path);
+  unlinkSkills(skills, tools);
+  for (const t of tools) { if (TOOLS[t]?.teardown) TOOLS[t].teardown(repo.path); }
+  // Only remove the symlink in repos/, not the actual source repo
+  const repoLink = join(REPOS_DIR, name);
+  try {
+    if (lstatSync(repoLink).isSymbolicLink()) unlinkSync(repoLink);
+    else execSync(`rm -rf "${repoLink}"`);
+  } catch {}
+  delete m.repos[name];
+  writeManifest(m);
+  console.log(`Removed ${name} (${skills.length} skills unlinked)`);
+
+} else if (cmd === 'update') {
+  const m = readManifest();
+  const tools = parseToolFlag(cmdArgs) || m.tools || detectTools();
+  const target = cmdArgs.find(a => !a.startsWith('--'));
+  const targets = target ? [target] : Object.keys(m.repos);
+  for (const name of targets) {
+    const repo = m.repos[name];
+    if (!repo) { console.error(`Repo "${name}" not found`); continue; }
+    console.log(`Updating ${name}...`);
+    try { execSync('git pull', { cwd: repo.path, stdio: 'inherit' }); } catch {}
+    const skills = discoverSkills(repo.path);
+    linkSkills(skills, tools);
+    runToolSetup(repo.path, tools);
+    repo.version = getVersion(repo.path);
+    repo.updated_at = new Date().toISOString();
+  }
+  m.tools = tools;
+  writeManifest(m);
+
+} else if (cmd === 'list') {
+  const m = readManifest();
+  for (const [name, info] of Object.entries(m.repos)) {
+    const skills = discoverSkills(info.path);
+    console.log(`${name} (${info.version || 'unknown'}):`);
+    skills.forEach(s => console.log(`  ${s.name}`));
+  }
+  if (m.tools?.length) console.log(`\nTools: ${m.tools.join(', ')}`);
+
+} else if (cmd === 'version') {
+  const m = readManifest();
+  for (const [name, info] of Object.entries(m.repos)) {
+    console.log(`${name}: ${info.version || 'unknown'}`);
+  }
+
+} else {
+  console.log(`Usage: sra <add|remove|update|list|version> [--tool <tool>] [args]
+
+Commands:
+  add <git-url>         Clone repo, discover skills, symlink, configure tools
+  add --local <path>    Register existing repo directory
+  remove <repo-name>    Unlink skills, remove repo
+  update [repo-name]    Git pull, re-link, re-configure
+  list                  Show installed repos and skills
+  version               Show repo versions
+
+Options:
+  --tool <name>         Target tool (claude|codex|cursor|openclaw|all)
+                        Default: auto-detect installed tools
+  --name <name>         Override repo name (for add)`);
+}

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "sra-skills",
+  "version": "0.1.0",
+  "description": "SRA agent skills installer — manage AI skill repos",
+  "bin": {
+    "sra": "./index.mjs",
+    "sra-skills": "./index.mjs"
+  },
+  "type": "module"
+}