@nimblebrain/mpak 0.0.1-beta.1

package/dist/utils/config-manager.js

@@ -0,0 +1,65 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Configuration manager for CLI settings in ~/.mpak/config.json
+ */
+export class ConfigManager {
+    configDir;
+    configFile;
+    config = null;
+    constructor() {
+        this.configDir = join(homedir(), '.mpak');
+        this.configFile = join(this.configDir, 'config.json');
+        this.ensureConfigDir();
+    }
+    ensureConfigDir() {
+        if (!existsSync(this.configDir)) {
+            mkdirSync(this.configDir, { recursive: true, mode: 0o700 });
+        }
+    }
+    loadConfig() {
+        if (this.config) {
+            return this.config;
+        }
+        if (!existsSync(this.configFile)) {
+            this.config = {
+                version: '1.0.0',
+                lastUpdated: new Date().toISOString(),
+            };
+            this.saveConfig();
+            return this.config;
+        }
+        try {
+            const configJson = readFileSync(this.configFile, 'utf8');
+            this.config = JSON.parse(configJson);
+            return this.config;
+        }
+        catch {
+            this.config = {
+                version: '1.0.0',
+                lastUpdated: new Date().toISOString(),
+            };
+            this.saveConfig();
+            return this.config;
+        }
+    }
+    saveConfig() {
+        if (!this.config) {
+            return;
+        }
+        this.config.lastUpdated = new Date().toISOString();
+        const configJson = JSON.stringify(this.config, null, 2);
+        writeFileSync(this.configFile, configJson, { mode: 0o600 });
+    }
+    setRegistryUrl(url) {
+        const config = this.loadConfig();
+        config.registryUrl = url;
+        this.saveConfig();
+    }
+    getRegistryUrl() {
+        const config = this.loadConfig();
+        return config.registryUrl || process.env.MPAK_REGISTRY_URL || 'https://api.mpak.dev';
+    }
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/utils/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../src/utils/config-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAW5B;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,SAAS,CAAS;IAClB,UAAU,CAAS;IACnB,MAAM,GAAsB,IAAI,CAAC;IAEzC;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG;gBACZ,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAe,CAAC;YACnD,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,GAAG;gBACZ,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,CAAC,GAAW;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QACzB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,sBAAsB,CAAC;IACvF,CAAC;CACF"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom error class for CLI errors
+ */
+export declare class CLIError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+/**
+ * Handles errors gracefully and exits with appropriate code
+ */
+export declare function handleError(error: unknown): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAG/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAU;CAMvB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAajD"}

package/dist/utils/errors.js

@@ -0,0 +1,27 @@
+/**
+ * Custom error class for CLI errors
+ */
+export class CLIError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = 'CLIError';
+        this.exitCode = exitCode;
+    }
+}
+/**
+ * Handles errors gracefully and exits with appropriate code
+ */
+export function handleError(error) {
+    if (error instanceof CLIError) {
+        console.error(`Error: ${error.message}`);
+        process.exit(error.exitCode);
+    }
+    if (error instanceof Error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+    console.error('An unexpected error occurred');
+    process.exit(1);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,QAAQ,CAAS;IAEjC,YACE,OAAe,EACf,WAAmB,CAAC;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Gets the current version from package.json
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAUnC"}

package/dist/utils/version.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+/**
+ * Gets the current version from package.json
+ */
+export function getVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const packageJsonPath = join(__dirname, '../../package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        return packageJson.version;
+    }
+    catch (_error) {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/eslint.config.js

@@ -0,0 +1,63 @@
+import js from '@eslint/js';
+import typescript from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+
+export default [
+  js.configs.recommended,
+  {
+    files: ['src/**/*.ts'],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module'
+      },
+      globals: {
+        console: 'readonly',
+        process: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+        fetch: 'readonly',
+        setTimeout: 'readonly',
+        setInterval: 'readonly',
+        clearTimeout: 'readonly',
+        clearInterval: 'readonly',
+        setImmediate: 'readonly',
+        Blob: 'readonly',
+        FormData: 'readonly',
+        URLSearchParams: 'readonly',
+        NodeJS: 'readonly'
+      }
+    },
+    plugins: {
+      '@typescript-eslint': typescript
+    },
+    rules: {
+      // TypeScript specific rules
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrors: 'all', caughtErrorsIgnorePattern: '^_' }],
+      'no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrors: 'all', caughtErrorsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      
+      // General JavaScript rules
+      'no-console': 'off', // CLI needs console output
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'eqeqeq': 'error',
+      'no-trailing-spaces': 'error',
+      'no-multiple-empty-lines': ['error', { max: 2 }],
+      
+      // Import/export rules
+      'no-duplicate-imports': 'error'
+    }
+  },
+  {
+    ignores: [
+      'dist/**',
+      'node_modules/**',
+      '*.js',
+      'examples/**'
+    ]
+  }
+];

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@nimblebrain/mpak",
+  "version": "0.0.1-beta.1",
+  "description": "CLI for downloading MCPB bundles from the mpak registry",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "mpak": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "generate:types": "openapi-typescript http://localhost:3200/documentation/json -o src/lib/api/schema.d.ts",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "mcpb",
+    "anthropic",
+    "cli",
+    "package-manager"
+  ],
+  "author": "NimbleBrain Inc",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@vitest/ui": "^4.0.16",
+    "openapi-typescript": "^7.10.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/commands/packages/pull.ts

@@ -0,0 +1,96 @@
+import { resolve } from 'path';
+import { RegistryClient } from '../../lib/api/registry-client.js';
+
+export interface PullOptions {
+  output?: string;
+  json?: boolean;
+  os?: string;
+  arch?: string;
+}
+
+/**
+ * Parse package specification into name and version
+ * Examples:
+ *   @scope/name -> { name: '@scope/name', version: undefined }
+ *   @scope/name@1.0.0 -> { name: '@scope/name', version: '1.0.0' }
+ */
+function parsePackageSpec(spec: string): { name: string; version?: string } {
+  // Find the last @ which separates version from package name
+  // Package names start with @, so we need to find the second @
+  const lastAtIndex = spec.lastIndexOf('@');
+
+  if (lastAtIndex <= 0) {
+    // No version specified or invalid format
+    return { name: spec };
+  }
+
+  const name = spec.substring(0, lastAtIndex);
+  const version = spec.substring(lastAtIndex + 1);
+
+  // Validate that the name still starts with @
+  if (!name.startsWith('@')) {
+    // This means the @ was part of the package name, not a version separator
+    return { name: spec };
+  }
+
+  return { name, version };
+}
+
+/**
+ * Pull (download) a package from the registry
+ */
+export async function handlePull(
+  packageSpec: string,
+  options: PullOptions = {}
+): Promise<void> {
+  try {
+    const { name, version } = parsePackageSpec(packageSpec);
+
+    const client = new RegistryClient();
+
+    // Detect platform (or use explicit overrides)
+    const detectedPlatform = RegistryClient.detectPlatform();
+    const platform = {
+      os: options.os || detectedPlatform.os,
+      arch: options.arch || detectedPlatform.arch,
+    };
+
+    console.log(`=> Fetching ${version ? `${name}@${version}` : `${name} (latest)`}...`);
+    console.log(`   Platform: ${platform.os}-${platform.arch}`);
+
+    // Get download info with platform
+    const downloadInfo = await client.getDownloadInfo(name, version, platform);
+
+    if (options.json) {
+      console.log(JSON.stringify(downloadInfo, null, 2));
+      return;
+    }
+
+    const bundle = downloadInfo.bundle;
+    console.log(`   Version: ${bundle.version}`);
+    console.log(`   Artifact: ${bundle.platform.os}-${bundle.platform.arch}`);
+    console.log(`   Size: ${(bundle.size / (1024 * 1024)).toFixed(2)} MB`);
+
+    // Determine output filename (include platform in name)
+    const platformSuffix = `${bundle.platform.os}-${bundle.platform.arch}`;
+    const defaultFilename = `${name.replace('@', '').replace('/', '-')}-${bundle.version}-${platformSuffix}.mcpb`;
+    const outputPath = options.output
+      ? resolve(options.output)
+      : resolve(defaultFilename);
+
+    console.log(`\n=> Downloading to ${outputPath}...`);
+
+    // Download the bundle
+    await client.downloadBundle(downloadInfo.url, outputPath);
+
+    console.log(`\n=> Bundle downloaded successfully!`);
+    console.log(`   File: ${outputPath}`);
+    console.log(`   SHA256: ${bundle.sha256.substring(0, 16)}...`);
+  } catch (error) {
+    console.error('\n=> Failed to pull bundle');
+    if (error instanceof Error) {
+      console.error(`   ${error.message}`);
+    }
+    process.exit(1);
+  }
+}

package/src/commands/packages/search.ts

@@ -0,0 +1,83 @@
+import { RegistryClient } from '../../lib/api/registry-client.js';
+
+export interface SearchOptions {
+  type?: string;
+  sort?: 'downloads' | 'recent' | 'name';
+  limit?: number;
+  offset?: number;
+  json?: boolean;
+}
+
+/**
+ * Search bundles (v1 API)
+ */
+export async function handleSearch(
+  query: string,
+  options: SearchOptions = {}
+): Promise<void> {
+  try {
+    const client = new RegistryClient();
+    const result = await client.searchBundles(query, {
+      type: options.type,
+      sort: options.sort,
+      limit: options.limit,
+      offset: options.offset,
+    });
+
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    if (result.bundles.length === 0) {
+      console.log(`\nNo bundles found for "${query}"`);
+      return;
+    }
+
+    console.log(`\nFound ${result.total} bundle(s) for "${query}":\n`);
+
+    for (const bundle of result.bundles) {
+      const verified = bundle.verified ? '✓' : ' ';
+      const provenance = bundle.provenance ? '🔒' : '';
+
+      console.log(`${verified} ${bundle.name} v${bundle.latest_version} ${provenance}`);
+
+      if (bundle.description) {
+        console.log(`  ${bundle.description}`);
+      }
+
+      const details = [];
+      if (bundle.downloads) details.push(`${bundle.downloads} downloads`);
+      if (bundle.server_type) details.push(bundle.server_type);
+      if (bundle.author?.name) details.push(`by ${bundle.author.name}`);
+
+      if (details.length > 0) {
+        console.log(`  ${details.join(' • ')}`);
+      }
+
+      if (bundle.tools && bundle.tools.length > 0) {
+        const toolNames = bundle.tools.slice(0, 3).map((t) => t.name);
+        const toolsDisplay =
+          bundle.tools.length > 3
+            ? `${toolNames.join(', ')} +${bundle.tools.length - 3} more`
+            : toolNames.join(', ');
+        console.log(`  Tools: ${toolsDisplay}`);
+      }
+
+      console.log();
+    }
+
+    if (result.pagination.has_more) {
+      const nextOffset = (options.offset || 0) + (options.limit || 20);
+      console.log(`More results available. Use --offset ${nextOffset} to see more.`);
+    }
+
+    console.log(`Use "mpak show <bundle>" for more details`);
+  } catch (error) {
+    console.error('=> Failed to search bundles');
+    if (error instanceof Error) {
+      console.error(`   ${error.message}`);
+    }
+    process.exit(1);
+  }
+}

package/src/commands/packages/show.ts

@@ -0,0 +1,138 @@
+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).toLocaleDateString()}`);
+    console.log();
+
+    // GitHub info
+    if (bundle.github) {
+      console.log('GitHub:');
+      console.log(`  Repository: ${bundle.github.repo}`);
+      if (bundle.github.stars != null) console.log(`  Stars: ${bundle.github.stars}`);
+      if (bundle.github.forks != null) console.log(`  Forks: ${bundle.github.forks}`);
+      if (bundle.github.watchers != null) console.log(`  Watchers: ${bundle.github.watchers}`);
+      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).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/index.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+import { config } from 'dotenv';
+import { createProgram } from './program.js';
+import { handleError } from './utils/errors.js';
+
+// Load environment variables from .env file
+config();
+
+async function main() {
+  const program = createProgram();
+  await program.parseAsync(process.argv);
+}
+
+main().catch(handleError);