@nimblebrain/mpak 0.0.2 → 0.2.0

package/src/program.ts

@@ -1,212 +0,0 @@
-import { Command } from 'commander';
-import { getVersion } from './utils/version.js';
-import { handleUnifiedSearch } from './commands/search.js';
-import { handleSearch } from './commands/packages/search.js';
-import { handleShow } from './commands/packages/show.js';
-import { handlePull } from './commands/packages/pull.js';
-import { handleRun } from './commands/packages/run.js';
-import {
-  handleConfigSet,
-  handleConfigGet,
-  handleConfigList,
-  handleConfigClear,
-} from './commands/config.js';
-import {
-  handleSkillValidate,
-  handleSkillPack,
-  handleSkillSearch,
-  handleSkillShow,
-  handleSkillPull,
-  handleSkillInstall,
-  handleSkillList,
-} from './commands/skills/index.js';
-
-/**
- * Creates and configures the CLI program
- *
- * Command structure:
- * - mpak search <query>    - Unified search (bundles + skills)
- * - mpak bundle <command>  - MCP bundle commands
- * - mpak skill <command>   - Agent skill commands
- * - mpak config <command>  - Configuration commands
- */
-export function createProgram(): Command {
-  const program = new Command();
-
-  program
-    .name('mpak')
-    .description('CLI for MCP bundles and Agent Skills')
-    .version(getVersion(), '-v, --version', 'Output the current version');
-
-  // ==========================================================================
-  // Unified search (bundles + skills)
-  // ==========================================================================
-
-  program
-    .command('search <query>')
-    .description('Search bundles and skills')
-    .option('--type <type>', 'Filter by type (bundle, skill)')
-    .option('--sort <field>', 'Sort by: downloads, recent, name')
-    .option('--limit <number>', 'Limit results', parseInt)
-    .option('--offset <number>', 'Pagination offset', parseInt)
-    .option('--json', 'Output as JSON')
-    .action(async (query, options) => {
-      await handleUnifiedSearch(query, options);
-    });
-
-  // ==========================================================================
-  // Bundle namespace (MCP bundles)
-  // ==========================================================================
-
-  const bundle = program.command('bundle').description('MCP bundle commands');
-
-  bundle
-    .command('search <query>')
-    .description('Search public bundles')
-    .option('--type <type>', 'Filter by server type (node, python, binary)')
-    .option('--sort <field>', 'Sort by: downloads, recent, name')
-    .option('--limit <number>', 'Limit results', parseInt)
-    .option('--offset <number>', 'Pagination offset', parseInt)
-    .option('--json', 'Output as JSON')
-    .action(async (query, options) => {
-      await handleSearch(query, options);
-    });
-
-  bundle
-    .command('show <package>')
-    .description('Show detailed information about a bundle')
-    .option('--json', 'Output as JSON')
-    .action(async (packageName, options) => {
-      await handleShow(packageName, options);
-    });
-
-  bundle
-    .command('pull <package>')
-    .description('Download a bundle from the registry')
-    .option('-o, --output <path>', 'Output file path')
-    .option('--os <os>', 'Target OS (darwin, linux, win32)')
-    .option('--arch <arch>', 'Target architecture (x64, arm64)')
-    .option('--json', 'Output download info as JSON')
-    .action(async (packageSpec, options) => {
-      await handlePull(packageSpec, options);
-    });
-
-  bundle
-    .command('run <package>')
-    .description('Run an MCP server from the registry')
-    .option('--update', 'Force re-download even if cached')
-    .action(async (packageSpec, options) => {
-      await handleRun(packageSpec, options);
-    });
-
-  // ==========================================================================
-  // Skill namespace (Agent Skills)
-  // ==========================================================================
-
-  const skill = program.command('skill').description('Agent skill commands');
-
-  skill
-    .command('validate <path>')
-    .description('Validate a skill directory against the Agent Skills spec')
-    .option('--json', 'Output as JSON')
-    .action(async (path, options) => {
-      await handleSkillValidate(path, options);
-    });
-
-  skill
-    .command('pack <path>')
-    .description('Create a .skill bundle from a skill directory')
-    .option('-o, --output <path>', 'Output file path')
-    .option('--json', 'Output as JSON')
-    .action(async (path, options) => {
-      await handleSkillPack(path, options);
-    });
-
-  skill
-    .command('search <query>')
-    .description('Search skills in the registry')
-    .option('--tags <tags>', 'Filter by tags (comma-separated)')
-    .option('--category <category>', 'Filter by category')
-    .option('--surface <surface>', 'Filter by surface (claude-code, claude-api, claude-ai)')
-    .option('--sort <field>', 'Sort by: downloads, recent, name')
-    .option('--limit <number>', 'Limit results', parseInt)
-    .option('--offset <number>', 'Pagination offset', parseInt)
-    .option('--json', 'Output as JSON')
-    .action(async (query, options) => {
-      await handleSkillSearch(query, options);
-    });
-
-  skill
-    .command('show <name>')
-    .description('Show detailed information about a skill')
-    .option('--json', 'Output as JSON')
-    .action(async (name, options) => {
-      await handleSkillShow(name, options);
-    });
-
-  skill
-    .command('pull <name>')
-    .description('Download a .skill bundle from the registry')
-    .option('-o, --output <path>', 'Output file path')
-    .option('--json', 'Output as JSON')
-    .action(async (name, options) => {
-      await handleSkillPull(name, options);
-    });
-
-  skill
-    .command('install <name>')
-    .description('Install a skill to ~/.claude/skills/')
-    .option('--force', 'Overwrite existing installation')
-    .option('--json', 'Output as JSON')
-    .action(async (name, options) => {
-      await handleSkillInstall(name, options);
-    });
-
-  skill
-    .command('list')
-    .description('List installed skills')
-    .option('--json', 'Output as JSON')
-    .action(async (options) => {
-      await handleSkillList(options);
-    });
-
-  // ==========================================================================
-  // Config commands (shared for bundles and skills)
-  // ==========================================================================
-
-  const configCmd = program
-    .command('config')
-    .description('Manage per-package configuration values');
-
-  configCmd
-    .command('set <package> <key=value...>')
-    .description('Set config value(s) for a package')
-    .action(async (packageName, keyValuePairs) => {
-      await handleConfigSet(packageName, keyValuePairs);
-    });
-
-  configCmd
-    .command('get <package>')
-    .description('Show stored config for a package (values are masked)')
-    .option('--json', 'Output as JSON')
-    .action(async (packageName, options) => {
-      await handleConfigGet(packageName, options);
-    });
-
-  configCmd
-    .command('list')
-    .description('List all packages with stored config')
-    .option('--json', 'Output as JSON')
-    .action(async (options) => {
-      await handleConfigList(options);
-    });
-
-  configCmd
-    .command('clear <package> [key]')
-    .description('Clear config for a package (all values or specific key)')
-    .action(async (packageName, key) => {
-      await handleConfigClear(packageName, key);
-    });
-
-  return program;
-}

package/src/schemas/config.v1.schema.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://mpak.dev/schemas/config.v1.json",
-  "title": "mpak CLI Configuration v1",
-  "description": "Configuration file for the mpak CLI stored at ~/.mpak/config.json",
-  "type": "object",
-  "required": ["version", "lastUpdated"],
-  "additionalProperties": false,
-  "properties": {
-    "version": {
-      "type": "string",
-      "const": "1.0.0",
-      "description": "Configuration schema version"
-    },
-    "lastUpdated": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of last configuration update"
-    },
-    "registryUrl": {
-      "type": "string",
-      "format": "uri",
-      "description": "Custom registry URL (overrides default https://api.mpak.dev)"
-    },
-    "packages": {
-      "type": "object",
-      "description": "Per-package configuration values (user_config)",
-      "additionalProperties": {
-        "type": "object",
-        "description": "Configuration key-value pairs for a specific package",
-        "additionalProperties": {
-          "type": "string"
-        }
-      }
-    }
-  }
-}

package/src/schemas/generated/api-responses.ts

@@ -1,386 +0,0 @@
-import { z } from 'zod';
-
-// Author schema
-export const PackageAuthorSchema = z.object({
-  name: z.string(),
-});
-
-// Tool schema
-export const PackageToolSchema = z.object({
-  name: z.string(),
-  description: z.string().optional(),
-});
-
-// GitHub info schema
-export const PackageGitHubSchema = z.object({
-  repo: z.string(),
-  stars: z.number().nullable(),
-  forks: z.number().nullable(),
-  watchers: z.number().nullable(),
-  updated_at: z.string().nullable().optional(),
-});
-
-// Package list item schema (what comes back from search/list endpoints)
-export const PackageSchema = z.object({
-  name: z.string(), // Full name: 'react' or '@meta/react'
-  display_name: z.string().nullable(),
-  description: z.string().nullable(),
-  author: PackageAuthorSchema.nullable(),
-  latest_version: z.string(),
-  icon: z.string().nullable(),
-  server_type: z.string(),
-  tools: z.array(PackageToolSchema),
-  downloads: z.number(),
-  published_at: z.union([z.string(), z.date()]),
-  verified: z.boolean(),
-  claimable: z.boolean().optional(),
-  claimed: z.boolean().optional(),
-  github: PackageGitHubSchema.nullable().optional(),
-});
-
-// Artifact schema (platform-specific bundles)
-export const ArtifactSchema = z.object({
-  os: z.string(), // darwin, win32, linux, any
-  arch: z.string(), // x64, arm64, any
-  size_bytes: z.number(),
-  digest: z.string(), // sha256:xxxx format
-  downloads: z.number(),
-});
-
-// Provenance schema (build/publish attestation)
-export const ProvenanceSchema = z.object({
-  publish_method: z.string().nullable(), // 'oidc' | 'upload' | 'cli'
-  repository: z.string().nullable(), // GitHub repo (owner/repo)
-  sha: z.string().nullable(), // Git commit SHA
-});
-
-// Package version schema
-export const PackageVersionSchema = z.object({
-  version: z.string(),
-  published_at: z.union([z.string(), z.date()]),
-  downloads: z.number(),
-  artifacts: z.array(ArtifactSchema).optional(),
-  readme: z.string().nullable().optional(),
-  provenance: ProvenanceSchema.nullable().optional(),
-  release_url: z.string().nullable().optional(),
-  prerelease: z.boolean().optional(),
-  manifest: z.record(z.string(), z.unknown()).nullable().optional(),
-});
-
-// Claiming info schema
-export const PackageClaimingSchema = z.object({
-  claimable: z.boolean(),
-  claimed: z.boolean(),
-  claimed_by: z.string().nullable(),
-  claimed_at: z.union([z.string(), z.date()]).nullable(),
-  github_repo: z.string().nullable(),
-});
-
-// Package detail schema (what comes back from package detail endpoint)
-export const PackageDetailSchema = PackageSchema.extend({
-  homepage: z.string().nullable(),
-  license: z.string().nullable(),
-  claiming: PackageClaimingSchema,
-  versions: z.array(PackageVersionSchema),
-});
-
-// Package search response schema
-export const PackageSearchResponseSchema = z.object({
-  packages: z.array(PackageSchema),
-  total: z.number(),
-});
-
-// =============================================================================
-// V1 Bundle API Schemas
-// =============================================================================
-
-// Platform info schema (os + arch combo)
-export const PlatformInfoSchema = z.object({
-  os: z.string(), // darwin, win32, linux, any
-  arch: z.string(), // x64, arm64, any
-});
-
-// Full provenance schema (returned by v1 API)
-export const FullProvenanceSchema = z.object({
-  schema_version: z.string(),
-  provider: z.string(),
-  repository: z.string(),
-  sha: z.string(),
-});
-
-// Bundle schema (v1 API - similar to Package but with provenance)
-export const BundleSchema = z.object({
-  name: z.string(),
-  display_name: z.string().nullable().optional(),
-  description: z.string().nullable().optional(),
-  author: PackageAuthorSchema.nullable().optional(),
-  latest_version: z.string(),
-  icon: z.string().nullable().optional(),
-  server_type: z.string().nullable().optional(),
-  tools: z.array(PackageToolSchema).optional(),
-  downloads: z.number(),
-  published_at: z.union([z.string(), z.date()]),
-  verified: z.boolean(),
-  provenance: FullProvenanceSchema.nullable().optional(),
-});
-
-// Bundle detail schema (v1 API)
-export const BundleDetailSchema = BundleSchema.extend({
-  homepage: z.string().nullable().optional(),
-  license: z.string().nullable().optional(),
-  versions: z.array(z.object({
-    version: z.string(),
-    published_at: z.union([z.string(), z.date()]),
-    downloads: z.number(),
-  })),
-});
-
-// Bundle search response schema (v1 API)
-export const BundleSearchResponseSchema = z.object({
-  bundles: z.array(BundleSchema),
-  total: z.number(),
-  pagination: z.object({
-    limit: z.number(),
-    offset: z.number(),
-    has_more: z.boolean(),
-  }),
-});
-
-// Version info with platforms (from /v1/bundles/@scope/pkg/versions)
-export const VersionInfoSchema = z.object({
-  version: z.string(),
-  artifacts_count: z.number(),
-  platforms: z.array(PlatformInfoSchema),
-  published_at: z.union([z.string(), z.date()]),
-  downloads: z.number(),
-  publish_method: z.string().nullable(),
-  provenance: FullProvenanceSchema.nullable().optional(),
-});
-
-// Versions response schema (v1 API)
-export const VersionsResponseSchema = z.object({
-  name: z.string(),
-  latest: z.string(),
-  versions: z.array(VersionInfoSchema),
-});
-
-// Download info schema (v1 API)
-export const DownloadInfoSchema = z.object({
-  url: z.string(),
-  bundle: z.object({
-    name: z.string(),
-    version: z.string(),
-    platform: PlatformInfoSchema,
-    sha256: z.string(),
-    size: z.number(),
-  }),
-  expires_at: z.string().optional(),
-});
-
-// =============================================================================
-// Internal API Schemas (used by web UI, not exposed publicly)
-// =============================================================================
-
-// Pagination schema (reusable)
-export const PaginationSchema = z.object({
-  limit: z.number(),
-  offset: z.number(),
-  has_more: z.boolean(),
-});
-
-// Publish response schema
-export const PublishResponseSchema = z.object({
-  success: z.boolean(),
-  package: z.object({
-    name: z.string(),
-    version: z.string(),
-    manifest: z.record(z.string(), z.unknown()),
-  }),
-  sha256: z.string(),
-  size: z.number(),
-  url: z.string(),
-  auto_claimed: z.boolean().optional(),
-  message: z.string().optional(),
-});
-
-// Internal download response schema (different from v1 API)
-export const InternalDownloadResponseSchema = z.object({
-  url: z.string(),
-  package: z.object({
-    name: z.string(),
-    version: z.string(),
-    sha256: z.string(),
-    size: z.number(),
-  }),
-  expires_at: z.string(),
-});
-
-// Claim status response schema
-export const ClaimStatusResponseSchema = z.object({
-  claimable: z.boolean(),
-  reason: z.string().optional(),
-  claimed_by: z.string().nullable().optional(),
-  claimed_at: z.union([z.string(), z.date()]).nullable().optional(),
-  package_name: z.string().optional(),
-  github_repo: z.string().nullable().optional(),
-  instructions: z.object({
-    steps: z.array(z.string()),
-    mpak_json_example: z.string(),
-    verification_url: z.string().nullable(),
-  }).optional(),
-});
-
-// Claim response schema
-export const ClaimResponseSchema = z.object({
-  success: z.boolean(),
-  message: z.string(),
-  package: z.object({
-    name: z.string(),
-    claimed_by: z.string().nullable(),
-    claimed_at: z.union([z.string(), z.date()]).nullable(),
-    github_repo: z.string().nullable(),
-  }),
-  verification: z.object({
-    mpak_json_url: z.string().nullable().optional(),
-    verified_at: z.string(),
-  }),
-});
-
-// My packages response schema
-export const MyPackagesResponseSchema = z.object({
-  packages: z.array(PackageSchema),
-  total: z.number(),
-  pagination: PaginationSchema,
-});
-
-// Unclaimed package schema
-export const UnclaimedPackageSchema = z.object({
-  name: z.string(),
-  display_name: z.string().nullable(),
-  description: z.string().nullable(),
-  server_type: z.string().nullable(),
-  latest_version: z.string(),
-  downloads: z.number(),
-  github_repo: z.string().nullable(),
-  created_at: z.union([z.string(), z.date()]),
-});
-
-// Unclaimed packages response schema
-export const UnclaimedPackagesResponseSchema = z.object({
-  packages: z.array(UnclaimedPackageSchema),
-  total: z.number(),
-  pagination: PaginationSchema,
-});
-
-
-// =============================================================================
-// V1 API Additional Schemas
-// =============================================================================
-
-// Version detail response schema (specific version with artifacts)
-export const VersionDetailSchema = z.object({
-  name: z.string(),
-  version: z.string(),
-  published_at: z.union([z.string(), z.date()]),
-  downloads: z.number(),
-  artifacts: z.array(z.object({
-    platform: PlatformInfoSchema,
-    digest: z.string(),
-    size: z.number(),
-    download_url: z.string(),
-    source_url: z.string().optional(),
-  })),
-  manifest: z.record(z.string(), z.unknown()),
-  release: z.object({
-    tag: z.string().nullable(),
-    url: z.string().nullable(),
-  }).optional(),
-  publish_method: z.string().nullable(),
-  provenance: FullProvenanceSchema.nullable(),
-});
-
-// MCPB Index response schema
-export const MCPBIndexSchema = z.object({
-  index_version: z.string(),
-  mimeType: z.string(),
-  name: z.string(),
-  version: z.string(),
-  description: z.string().nullable(),
-  bundles: z.array(z.object({
-    mimeType: z.string().nullable(),
-    digest: z.string(),
-    size: z.number(),
-    platform: PlatformInfoSchema,
-    urls: z.array(z.string()),
-  })),
-  annotations: z.record(z.string(), z.string()).optional(),
-});
-
-// Announce request schema (per-artifact announcement from GitHub Actions)
-export const AnnounceRequestSchema = z.object({
-  name: z.string(),
-  version: z.string(),
-  manifest: z.record(z.string(), z.unknown()),
-  release_tag: z.string(),
-  prerelease: z.boolean().optional().default(false),
-  artifact: z.object({
-    filename: z.string(),
-    os: z.string(),
-    arch: z.string(),
-    sha256: z.string(),
-    size: z.number(),
-  }),
-});
-
-// Announce response schema (per-artifact, idempotent)
-export const AnnounceResponseSchema = z.object({
-  package: z.string(),
-  version: z.string(),
-  artifact: z.object({
-    os: z.string(),
-    arch: z.string(),
-    filename: z.string(),
-  }),
-  total_artifacts: z.number(),
-  status: z.enum(['created', 'updated']),
-});
-
-// =============================================================================
-// Export TypeScript types
-// =============================================================================
-
-// Core types
-export type PackageAuthor = z.infer<typeof PackageAuthorSchema>;
-export type PackageTool = z.infer<typeof PackageToolSchema>;
-export type PackageGitHub = z.infer<typeof PackageGitHubSchema>;
-export type Package = z.infer<typeof PackageSchema>;
-export type Artifact = z.infer<typeof ArtifactSchema>;
-export type Provenance = z.infer<typeof ProvenanceSchema>;
-export type PackageVersion = z.infer<typeof PackageVersionSchema>;
-export type PackageClaiming = z.infer<typeof PackageClaimingSchema>;
-export type PackageDetail = z.infer<typeof PackageDetailSchema>;
-export type PackageSearchResponse = z.infer<typeof PackageSearchResponseSchema>;
-
-// V1 API types
-export type PlatformInfo = z.infer<typeof PlatformInfoSchema>;
-export type FullProvenance = z.infer<typeof FullProvenanceSchema>;
-export type Bundle = z.infer<typeof BundleSchema>;
-export type BundleDetail = z.infer<typeof BundleDetailSchema>;
-export type BundleSearchResponse = z.infer<typeof BundleSearchResponseSchema>;
-export type VersionInfo = z.infer<typeof VersionInfoSchema>;
-export type VersionsResponse = z.infer<typeof VersionsResponseSchema>;
-export type DownloadInfo = z.infer<typeof DownloadInfoSchema>;
-export type VersionDetail = z.infer<typeof VersionDetailSchema>;
-export type MCPBIndex = z.infer<typeof MCPBIndexSchema>;
-export type AnnounceRequest = z.infer<typeof AnnounceRequestSchema>;
-export type AnnounceResponse = z.infer<typeof AnnounceResponseSchema>;
-
-// Internal API types
-export type Pagination = z.infer<typeof PaginationSchema>;
-export type PublishResponse = z.infer<typeof PublishResponseSchema>;
-export type InternalDownloadResponse = z.infer<typeof InternalDownloadResponseSchema>;
-export type ClaimStatusResponse = z.infer<typeof ClaimStatusResponseSchema>;
-export type ClaimResponse = z.infer<typeof ClaimResponseSchema>;
-export type MyPackagesResponse = z.infer<typeof MyPackagesResponseSchema>;
-export type UnclaimedPackage = z.infer<typeof UnclaimedPackageSchema>;
-export type UnclaimedPackagesResponse = z.infer<typeof UnclaimedPackagesResponseSchema>;

package/src/schemas/generated/auth.ts

@@ -1,21 +0,0 @@
-import { z } from 'zod';
-
-// User profile response from /internal/auth/me
-export const UserProfileSchema = z.object({
-  id: z.string(),
-  email: z.string().email(),
-  emailVerified: z.boolean(),
-  username: z.string().nullable(),
-  name: z.string().nullable(),
-  avatarUrl: z.string().nullable(),
-  githubUsername: z.string().nullable(),
-  githubLinked: z.boolean(),
-  verified: z.boolean(),
-  publishedBundles: z.number(),
-  totalDownloads: z.number(),
-  createdAt: z.union([z.string(), z.date()]).nullable(),
-  lastLoginAt: z.union([z.string(), z.date()]).nullable(),
-});
-
-// Export TypeScript type
-export type UserProfile = z.infer<typeof UserProfileSchema>;

package/src/schemas/generated/index.ts

@@ -1,5 +0,0 @@
-// Export all schemas and types
-export * from './package';
-export * from './api-responses';
-export * from './auth';
-export * from './skill';

package/src/schemas/generated/package.ts

@@ -1,29 +0,0 @@
-import { z } from 'zod';
-
-// Server type enum
-export const ServerTypeSchema = z.enum(['node', 'python', 'binary']);
-
-// Platform enum
-export const PlatformSchema = z.enum(['darwin', 'win32', 'linux']);
-
-// Sort options
-export const PackageSortSchema = z.enum(['downloads', 'recent', 'name']);
-
-// Package search params schema
-// Query params from HTTP are always strings, but we parse them to proper types
-export const PackageSearchParamsSchema = z.object({
-  q: z.string().optional(),
-  type: ServerTypeSchema.optional(),
-  tool: z.string().optional(),
-  prompt: z.string().optional(),
-  platform: PlatformSchema.optional(),
-  sort: PackageSortSchema.optional(),
-  limit: z.union([z.string(), z.number()]).optional(),
-  offset: z.union([z.string(), z.number()]).optional(),
-});
-
-// Export TypeScript types
-export type ServerType = z.infer<typeof ServerTypeSchema>;
-export type Platform = z.infer<typeof PlatformSchema>;
-export type PackageSort = z.infer<typeof PackageSortSchema>;
-export type PackageSearchParams = z.infer<typeof PackageSearchParamsSchema>;