@nimblebrain/mpak 0.1.0 → 0.3.0

package/src/commands/packages/show.ts

@@ -1,128 +0,0 @@
-import { RegistryClient } from '../../lib/api/registry-client.js';
-
-export interface ShowOptions {
-  json?: boolean;
-}
-
-/**
- * Show detailed information about a bundle (v1 API)
- */
-export async function handleShow(
-  packageName: string,
-  options: ShowOptions = {}
-): Promise<void> {
-  try {
-    const client = new RegistryClient();
-
-    // Fetch bundle details and versions in parallel
-    const [bundle, versionsInfo] = await Promise.all([
-      client.getBundle(packageName),
-      client.getVersions(packageName),
-    ]);
-
-    if (options.json) {
-      console.log(JSON.stringify({ ...bundle, versions_detail: versionsInfo.versions }, null, 2));
-      return;
-    }
-
-    // Header
-    const verified = bundle.verified ? '✓ ' : '';
-    const provenance = bundle.provenance ? '🔒 ' : '';
-    console.log(`\n${verified}${provenance}${bundle.display_name || bundle.name} v${bundle.latest_version}\n`);
-
-    // Description
-    if (bundle.description) {
-      console.log(bundle.description);
-      console.log();
-    }
-
-    // Basic info
-    console.log('Bundle Information:');
-    console.log(`  Name: ${bundle.name}`);
-    if (bundle.author?.name) {
-      console.log(`  Author: ${bundle.author.name}`);
-    }
-    if (bundle.server_type) {
-      console.log(`  Type: ${bundle.server_type}`);
-    }
-    if (bundle.license) {
-      console.log(`  License: ${bundle.license}`);
-    }
-    if (bundle.homepage) {
-      console.log(`  Homepage: ${bundle.homepage}`);
-    }
-    console.log();
-
-    // Provenance info
-    if (bundle.provenance) {
-      console.log('Provenance:');
-      console.log(`  Repository: ${bundle.provenance.repository}`);
-      console.log(`  Commit: ${bundle.provenance.sha.substring(0, 12)}`);
-      console.log(`  Provider: ${bundle.provenance.provider}`);
-      console.log();
-    }
-
-    // Stats
-    console.log('Statistics:');
-    console.log(`  Downloads: ${bundle.downloads.toLocaleString()}`);
-    console.log(`  Published: ${new Date(bundle.published_at as string).toLocaleDateString()}`);
-    console.log();
-
-    // Tools
-    if (bundle.tools && bundle.tools.length > 0) {
-      console.log(`Tools (${bundle.tools.length}):`);
-      for (const tool of bundle.tools) {
-        console.log(`  - ${tool.name}`);
-        if (tool.description) {
-          console.log(`    ${tool.description}`);
-        }
-      }
-      console.log();
-    }
-
-    // Versions with platforms
-    if (versionsInfo.versions && versionsInfo.versions.length > 0) {
-      console.log(`Versions (${versionsInfo.versions.length}):`);
-      const recentVersions = versionsInfo.versions.slice(0, 5);
-      for (const version of recentVersions) {
-        const date = new Date(version.published_at as string).toLocaleDateString();
-        const downloads = version.downloads.toLocaleString();
-        const isLatest = version.version === versionsInfo.latest ? ' (latest)' : '';
-        const provTag = version.provenance ? ' 🔒' : '';
-
-        // Format platforms
-        const platformStrs = version.platforms.map((p) => `${p.os}-${p.arch}`);
-        const platformsDisplay = platformStrs.length > 0 ? ` [${platformStrs.join(', ')}]` : '';
-
-        console.log(`  ${version.version}${isLatest}${provTag} - ${date} - ${downloads} downloads${platformsDisplay}`);
-      }
-      if (versionsInfo.versions.length > 5) {
-        console.log(`  ... and ${versionsInfo.versions.length - 5} more`);
-      }
-      console.log();
-    }
-
-    // Available platforms for latest version
-    const latestVersion = versionsInfo.versions.find((v) => v.version === versionsInfo.latest);
-    if (latestVersion && latestVersion.platforms.length > 0) {
-      console.log('Available Platforms:');
-      for (const platform of latestVersion.platforms) {
-        console.log(`  - ${platform.os}-${platform.arch}`);
-      }
-      console.log();
-    }
-
-    // Install instructions
-    console.log('Install:');
-    console.log(`  mpak install ${bundle.name}`);
-    console.log();
-    console.log('Pull (download only):');
-    console.log(`  mpak pull ${bundle.name}`);
-  } catch (error) {
-    console.error('=> Failed to get bundle details');
-    if (error instanceof Error) {
-      console.error(`   ${error.message}`);
-    }
-    process.exit(1);
-  }
-}

package/src/commands/search.ts

@@ -1,191 +0,0 @@
-import { RegistryClient } from '../lib/api/registry-client.js';
-import { searchSkills } from '../lib/api/skills-client.js';
-
-export interface UnifiedSearchOptions {
-  type?: 'bundle' | 'skill';
-  sort?: 'downloads' | 'recent' | 'name';
-  limit?: number;
-  offset?: number;
-  json?: boolean;
-}
-
-interface UnifiedResult {
-  type: 'bundle' | 'skill';
-  name: string;
-  description: string;
-  downloads: number;
-  version: string;
-  author?: string;
-  // Bundle-specific
-  serverType?: string;
-  verified?: boolean;
-  provenance?: boolean;
-  // Skill-specific
-  category?: string;
-}
-
-/**
- * Unified search across bundles and skills
- */
-export async function handleUnifiedSearch(
-  query: string,
-  options: UnifiedSearchOptions = {}
-): Promise<void> {
-  try {
-    const results: UnifiedResult[] = [];
-    let bundleTotal = 0;
-    let skillTotal = 0;
-
-    // Search both in parallel (unless filtered by type)
-    const searchBundles = !options.type || options.type === 'bundle';
-    const searchSkillsFlag = !options.type || options.type === 'skill';
-
-    const [bundleResult, skillResult] = await Promise.all([
-      searchBundles
-        ? new RegistryClient().searchBundles(query, {
-            sort: options.sort,
-            limit: options.limit,
-            offset: options.offset,
-          })
-        : null,
-      searchSkillsFlag
-        ? searchSkills({
-            q: query,
-            sort: options.sort as any,
-            limit: options.limit,
-            offset: options.offset,
-          }).catch(() => null) // Skills API may not be deployed yet
-        : null,
-    ]);
-
-    // Process bundle results
-    if (bundleResult) {
-      bundleTotal = bundleResult.total;
-      for (const bundle of bundleResult.bundles) {
-        results.push({
-          type: 'bundle',
-          name: bundle.name,
-          description: bundle.description || '',
-          downloads: bundle.downloads || 0,
-          version: bundle.latest_version,
-          author: bundle.author?.name || undefined,
-          serverType: bundle.server_type || undefined,
-          verified: bundle.verified,
-          provenance: !!bundle.provenance,
-        });
-      }
-    }
-
-    // Process skill results
-    if (skillResult) {
-      skillTotal = skillResult.total;
-      for (const skill of skillResult.skills) {
-        results.push({
-          type: 'skill',
-          name: skill.name,
-          description: skill.description || '',
-          downloads: skill.downloads || 0,
-          version: skill.latest_version,
-          author: skill.author?.name || undefined,
-          category: skill.category || undefined,
-        });
-      }
-    }
-
-    // Sort combined results
-    if (options.sort === 'downloads') {
-      results.sort((a, b) => b.downloads - a.downloads);
-    } else if (options.sort === 'name') {
-      results.sort((a, b) => a.name.localeCompare(b.name));
-    }
-    // 'recent' sorting would require timestamps, skip for now
-
-    // JSON output
-    if (options.json) {
-      console.log(
-        JSON.stringify(
-          {
-            results,
-            totals: { bundles: bundleTotal, skills: skillTotal },
-          },
-          null,
-          2
-        )
-      );
-      return;
-    }
-
-    // No results
-    if (results.length === 0) {
-      console.log(`\nNo results found for "${query}"`);
-      if (!searchBundles) console.log('  (searched skills only)');
-      if (!searchSkillsFlag) console.log('  (searched bundles only)');
-      return;
-    }
-
-    // Summary
-    const totalResults = bundleTotal + skillTotal;
-    const typeFilter = options.type ? ` (${options.type}s only)` : '';
-    console.log(`\nFound ${totalResults} result(s) for "${query}"${typeFilter}:\n`);
-
-    // Table header
-    const typeWidth = 10;
-    const nameWidth = 38;
-    const versionWidth = 12;
-    const downloadsWidth = 10;
-
-    console.log(
-      'TYPE'.padEnd(typeWidth) +
-        'NAME'.padEnd(nameWidth) +
-        'VERSION'.padEnd(versionWidth) +
-        'DOWNLOADS'.padStart(downloadsWidth)
-    );
-
-    // Table rows
-    for (const result of results) {
-      const typeLabel = result.type === 'bundle' ? 'bundle' : 'skill';
-      const name =
-        result.name.length > nameWidth - 2
-          ? result.name.slice(0, nameWidth - 5) + '...'
-          : result.name;
-      const version = result.version || '-';
-      const downloads = result.downloads.toLocaleString();
-
-      console.log(
-        typeLabel.padEnd(typeWidth) +
-          name.padEnd(nameWidth) +
-          version.padEnd(versionWidth) +
-          downloads.padStart(downloadsWidth)
-      );
-    }
-
-    console.log('');
-
-    // Show breakdown
-    if (!options.type) {
-      const parts = [];
-      if (bundleTotal > 0) parts.push(`${bundleTotal} bundle(s)`);
-      if (skillTotal > 0) parts.push(`${skillTotal} skill(s)`);
-      if (parts.length > 1) {
-        console.log(`  ${parts.join(', ')}`);
-      }
-    }
-
-    // Pagination hint
-    const currentLimit = options.limit || 20;
-    const currentOffset = options.offset || 0;
-    if (bundleTotal + skillTotal > currentOffset + results.length) {
-      console.log(`  Use --offset ${currentOffset + currentLimit} to see more results.`);
-    }
-
-    // Hint for more details
-    console.log('');
-    console.log('Use "mpak bundle show <name>" or "mpak skill show <name>" for details.');
-  } catch (error) {
-    console.error('Search failed');
-    if (error instanceof Error) {
-      console.error(`  ${error.message}`);
-    }
-    process.exit(1);
-  }
-}

package/src/commands/skills/index.ts

@@ -1,7 +0,0 @@
-export { handleSkillValidate, validateSkillDirectory } from './validate.js';
-export { handleSkillPack, packSkill } from './pack.js';
-export { handleSkillSearch } from './search.js';
-export { handleSkillShow } from './show.js';
-export { handleSkillPull } from './pull.js';
-export { handleSkillInstall } from './install.js';
-export { handleSkillList } from './list.js';

package/src/commands/skills/install.ts

@@ -1,129 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync, rmSync } from 'fs';
-import { join, basename } from 'path';
-import { homedir, tmpdir } from 'os';
-import { getSkillDownloadInfo, downloadSkillBundle } from '../../lib/api/skills-client.js';
-import { execSync } from 'child_process';
-
-/**
- * Get the Claude Code skills directory
- */
-function getSkillsDir(): string {
-  return join(homedir(), '.claude', 'skills');
-}
-
-/**
- * Parse skill spec into name and version
- */
-function parseSkillSpec(spec: string): { name: string; version?: string } {
-  const atIndex = spec.lastIndexOf('@');
-  if (atIndex <= 0) {
-    return { name: spec };
-  }
-  const slashIndex = spec.indexOf('/');
-  if (atIndex > slashIndex) {
-    return {
-      name: spec.slice(0, atIndex),
-      version: spec.slice(atIndex + 1),
-    };
-  }
-  return { name: spec };
-}
-
-/**
- * Extract skill name from scoped name
- * @scope/skill-name -> skill-name
- */
-function getShortName(scopedName: string): string {
-  const parts = scopedName.replace('@', '').split('/');
-  return parts[parts.length - 1];
-}
-
-export interface InstallOptions {
-  force?: boolean;
-  json?: boolean;
-}
-
-/**
- * Handle the skill install command
- */
-export async function handleSkillInstall(skillSpec: string, options: InstallOptions): Promise<void> {
-  try {
-    const { name, version } = parseSkillSpec(skillSpec);
-
-    // Get download info
-    const downloadInfo = await getSkillDownloadInfo(name, version);
-    const shortName = getShortName(downloadInfo.skill.name);
-    const skillsDir = getSkillsDir();
-    const installPath = join(skillsDir, shortName);
-
-    // Check if already installed
-    if (existsSync(installPath) && !options.force) {
-      console.error(`Skill "${shortName}" is already installed at ${installPath}`);
-      console.error('Use --force to overwrite');
-      process.exit(1);
-    }
-
-    console.log(`Pulling ${downloadInfo.skill.name}@${downloadInfo.skill.version}...`);
-
-    // Download the bundle
-    const buffer = await downloadSkillBundle(downloadInfo.url, downloadInfo.skill.sha256);
-
-    console.log(`Downloaded ${basename(downloadInfo.skill.name)}-${downloadInfo.skill.version}.skill (${formatSize(downloadInfo.skill.size)})`);
-
-    // Ensure skills directory exists
-    if (!existsSync(skillsDir)) {
-      mkdirSync(skillsDir, { recursive: true });
-    }
-
-    // Write to temp file
-    const tempPath = join(tmpdir(), `skill-${Date.now()}.skill`);
-    writeFileSync(tempPath, buffer);
-
-    // Remove existing installation if force
-    if (existsSync(installPath)) {
-      rmSync(installPath, { recursive: true });
-    }
-
-    // Extract using unzip
-    // The .skill bundle contains: skillName/SKILL.md, skillName/...
-    // We extract to the skills directory
-    try {
-      execSync(`unzip -o "${tempPath}" -d "${skillsDir}"`, { stdio: 'pipe' });
-    } catch (err) {
-      throw new Error(`Failed to extract skill bundle: ${err}`);
-    } finally {
-      // Clean up temp file
-      rmSync(tempPath, { force: true });
-    }
-
-    if (options.json) {
-      console.log(
-        JSON.stringify(
-          {
-            installed: true,
-            name: downloadInfo.skill.name,
-            shortName,
-            version: downloadInfo.skill.version,
-            path: installPath,
-          },
-          null,
-          2
-        )
-      );
-    } else {
-      console.log(`Extracting to ${installPath}/`);
-      console.log(`\u2713 Installed: ${shortName}`);
-      console.log('');
-      console.log('Skill available in Claude Code. Restart to activate.');
-    }
-  } catch (err) {
-    console.error(`Error: ${err instanceof Error ? err.message : err}`);
-    process.exit(1);
-  }
-}
-
-function formatSize(bytes: number): string {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}

package/src/commands/skills/list.ts

@@ -1,116 +0,0 @@
-import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-import matter from 'gray-matter';
-
-/**
- * Get the Claude Code skills directory
- */
-function getSkillsDir(): string {
-  return join(homedir(), '.claude', 'skills');
-}
-
-interface InstalledSkill {
-  name: string;
-  description: string;
-  version: string | null;
-  path: string;
-}
-
-/**
- * List all installed skills
- */
-function listInstalledSkills(): InstalledSkill[] {
-  const skillsDir = getSkillsDir();
-
-  if (!existsSync(skillsDir)) {
-    return [];
-  }
-
-  const skills: InstalledSkill[] = [];
-  const entries = readdirSync(skillsDir);
-
-  for (const entry of entries) {
-    // Skip hidden files
-    if (entry.startsWith('.')) continue;
-
-    const skillPath = join(skillsDir, entry);
-    const stat = statSync(skillPath);
-
-    if (!stat.isDirectory()) continue;
-
-    // Check for SKILL.md
-    const skillMdPath = join(skillPath, 'SKILL.md');
-    if (!existsSync(skillMdPath)) continue;
-
-    // Parse SKILL.md
-    try {
-      const content = readFileSync(skillMdPath, 'utf-8');
-      const parsed = matter(content);
-
-      skills.push({
-        name: parsed.data.name || entry,
-        description: parsed.data.description || '',
-        version: parsed.data.metadata?.version || null,
-        path: skillPath,
-      });
-    } catch {
-      // If we can't parse, still include with basic info
-      skills.push({
-        name: entry,
-        description: '(unable to parse SKILL.md)',
-        version: null,
-        path: skillPath,
-      });
-    }
-  }
-
-  return skills.sort((a, b) => a.name.localeCompare(b.name));
-}
-
-export interface ListOptions {
-  json?: boolean;
-}
-
-/**
- * Handle the skill list command
- */
-export async function handleSkillList(options: ListOptions): Promise<void> {
-  const skills = listInstalledSkills();
-
-  if (options.json) {
-    console.log(JSON.stringify(skills, null, 2));
-    return;
-  }
-
-  if (skills.length === 0) {
-    console.log('No skills installed.');
-    console.log('');
-    console.log('Install skills with: mpak skill install <name>');
-    console.log('Or create your own in ~/.claude/skills/');
-    return;
-  }
-
-  console.log('');
-  console.log('Installed skills:');
-  console.log('');
-
-  const nameWidth = Math.max(20, ...skills.map((s) => s.name.length)) + 2;
-  const versionWidth = 10;
-
-  console.log('NAME'.padEnd(nameWidth) + 'VERSION'.padEnd(versionWidth) + 'DESCRIPTION');
-
-  for (const skill of skills) {
-    const name = skill.name.padEnd(nameWidth);
-    const version = (skill.version || '-').padEnd(versionWidth);
-    const desc =
-      skill.description.length > 50
-        ? skill.description.slice(0, 47) + '...'
-        : skill.description;
-
-    console.log(name + version + desc);
-  }
-
-  console.log('');
-  console.log(`${skills.length} skill(s) installed in ${getSkillsDir()}`);
-}