craftdesk 0.3.0 → 0.5.0

package/src/services/registry-client.ts

@@ -1,163 +0,0 @@
-import axios, { AxiosInstance } from 'axios';
-import { configManager } from './config-manager';
-import { logger } from '../utils/logger';
-import { LockEntry } from '../types/craftdesk-lock';
-
-export interface CraftInfo {
-  name: string;
-  author: string;
-  version: string;
-  type: 'skill' | 'agent' | 'command' | 'hook' | 'plugin';
-  description?: string;
-  dependencies?: Record<string, string>;
-  download_url?: string;
-  integrity?: string;
-}
-
-export interface ResolveResponse {
-  resolved: Record<string, any>;
-  lockfile: any;
-}
-
-export class RegistryClient {
-  private axiosInstance: AxiosInstance | null = null;
-
-  private async getClient(registryUrl: string): Promise<AxiosInstance> {
-    const token = await configManager.getAuthToken(registryUrl);
-
-    return axios.create({
-      baseURL: registryUrl,
-      headers: {
-        'Content-Type': 'application/json',
-        ...(token ? { 'Authorization': `Bearer ${token}` } : {})
-      },
-      timeout: 30000
-    });
-  }
-
-  async getCraftInfo(craftName: string, version?: string, registryOverride?: string): Promise<CraftInfo | null> {
-    // Get registry URL - can be overridden by dependency-specific registry
-    const registryUrl = registryOverride
-      ? await this.resolveRegistry(registryOverride)
-      : await configManager.getRegistryForCraft(craftName);
-
-    const client = await this.getClient(registryUrl);
-
-    // Parse craft name (could be @scope/name or just name)
-    const [author, name] = this.parseCraftName(craftName);
-
-    try {
-      const endpoint = version
-        ? `/api/v1/crafts/${author}/${name}/versions/${version}`
-        : `/api/v1/crafts/${author}/${name}`;
-
-      logger.debug(`Fetching craft info from ${registryUrl}${endpoint}`);
-
-      const response = await client.get(endpoint);
-      return response.data.craft || response.data;
-    } catch (error: any) {
-      if (error.response?.status === 404) {
-        logger.error(`Craft '${craftName}' not found in registry`);
-      } else {
-        logger.error(`Failed to fetch craft info: ${error.message}`);
-      }
-      return null;
-    }
-  }
-
-  private async resolveRegistry(registry: string): Promise<string> {
-    // If it's a URL, use it directly
-    if (registry.startsWith('http://') || registry.startsWith('https://')) {
-      return registry;
-    }
-
-    // Look it up in the craftdesk.json registries section
-    const craftDeskJson = await configManager.getCraftDeskJson();
-    if (craftDeskJson?.registries?.[registry]) {
-      return craftDeskJson.registries[registry].url;
-    }
-
-    // If not found, assume it's a URL without protocol
-    return `https://${registry}`;
-  }
-
-  async listVersions(craftName: string): Promise<string[]> {
-    const registryUrl = await configManager.getRegistryForCraft(craftName);
-    const client = await this.getClient(registryUrl);
-
-    const [author, name] = this.parseCraftName(craftName);
-
-    try {
-      const response = await client.get(`/api/v1/crafts/${author}/${name}/versions`);
-      return response.data.versions || [];
-    } catch (error: any) {
-      logger.error(`Failed to fetch versions: ${error.message}`);
-      return [];
-    }
-  }
-
-  async resolveDependencies(dependencies: Record<string, string>): Promise<ResolveResponse | null> {
-    // Get the default registry from craftdesk.json or use fallback
-    const craftDesk = await configManager.getCraftDeskJson();
-    const registryUrl = craftDesk?.registries?.default?.url || 'https://craftdesk.ai';
-
-    const client = await this.getClient(registryUrl);
-
-    try {
-      logger.debug('Resolving dependencies via API...');
-      const response = await client.post('/api/v1/resolve', { dependencies });
-      return response.data;
-    } catch (error: any) {
-      logger.error(`Failed to resolve dependencies: ${error.message}`);
-      return null;
-    }
-  }
-
-  async downloadCraft(downloadUrl: string, outputPath: string): Promise<void> {
-    try {
-      const response = await axios.get(downloadUrl, {
-        responseType: 'stream'
-      });
-
-      // TODO: Save to file and extract
-      logger.debug(`Downloaded craft from ${downloadUrl}`);
-    } catch (error: any) {
-      throw new Error(`Failed to download craft: ${error.message}`);
-    }
-  }
-
-  async searchCrafts(query: string, type?: string): Promise<CraftInfo[]> {
-    // Get the default registry from craftdesk.json or use fallback
-    const craftDesk = await configManager.getCraftDeskJson();
-    const registryUrl = craftDesk?.registries?.default?.url || 'https://craftdesk.ai';
-
-    const client = await this.getClient(registryUrl);
-
-    try {
-      const params: any = { q: query };
-      if (type) params.type = type;
-
-      const response = await client.get('/api/v1/crafts', { params });
-      return response.data.crafts || [];
-    } catch (error: any) {
-      logger.error(`Failed to search crafts: ${error.message}`);
-      return [];
-    }
-  }
-
-  private parseCraftName(craftName: string): [string, string] {
-    if (craftName.startsWith('@')) {
-      // Scoped craft: @acme/skill-name
-      const parts = craftName.substring(1).split('/');
-      if (parts.length === 2) {
-        return [`@${parts[0]}`, parts[1]];
-      }
-    }
-
-    // Assume author is 'anthropic' for unscoped crafts (default)
-    // This should be configurable or determined by registry
-    return ['anthropic', craftName];
-  }
-}
-
-export const registryClient = new RegistryClient();

package/src/types/craftdesk-json.ts

@@ -1,53 +0,0 @@
-export interface CraftDeskJson {
-  name: string;
-  version: string;
-  type?: 'skill' | 'agent' | 'command' | 'hook' | 'plugin';
-  description?: string;
-  author?: string;
-  license?: string;
-  homepage?: string;
-  repository?: {
-    type: string;
-    url: string;
-  };
-  keywords?: string[];
-
-  // Dependencies - type-agnostic (skills, agents, commands, hooks, plugins can all depend on each other)
-  // Can be simple string versions or objects with version and registry
-  dependencies?: Record<string, string | DependencyConfig>;
-  devDependencies?: Record<string, string | DependencyConfig>;
-  peerDependencies?: Record<string, string | DependencyConfig>;
-  optionalDependencies?: Record<string, string | DependencyConfig>;
-
-  // Registry configuration (optional, in-file configuration)
-  registries?: Record<string, RegistryConfig>;
-
-  // Commands and hooks
-  commands?: Record<string, string | CommandConfig>;
-  hooks?: Record<string, string[]>;
-
-  // Index signature to allow dynamic property access
-  [key: string]: any;
-}
-
-export interface DependencyConfig {
-  version?: string;  // Optional for git dependencies
-  registry?: string;  // Can be a registry name (from registries section) or direct URL
-  git?: string;       // Git repository URL
-  branch?: string;    // Git branch (default: main/master)
-  tag?: string;       // Git tag
-  commit?: string;    // Git commit hash
-  path?: string;      // Subdirectory path within the repository
-  file?: string;      // Direct file path within the repository
-}
-
-export interface RegistryConfig {
-  url: string;
-  scope?: string;  // Optional scope like "@company"
-  auth?: string;   // Optional auth token (though better in ~/.craftrc for security)
-}
-
-export interface CommandConfig {
-  version: string;
-  config?: Record<string, any>;
-}

package/src/types/craftdesk-lock.ts

@@ -1,38 +0,0 @@
-export interface CraftDeskLock {
-  version: string;
-  lockfileVersion: number;
-  generatedAt: string;
-
-  crafts: Record<string, LockEntry>;
-  tree?: DependencyTree;
-  metadata?: {
-    totalCrafts: number;
-    totalSize: string;
-    installPath: string;
-  };
-}
-
-export interface LockEntry {
-  version: string;
-  resolved: string;  // Download URL or git URL
-  integrity: string; // SHA-256 hash (or commit hash for git)
-  type: 'skill' | 'agent' | 'command' | 'hook' | 'plugin';
-  author?: string;
-  registry?: string;
-  scope?: string;
-  dependencies?: Record<string, string>;
-
-  // Git source fields
-  git?: string;       // Git repository URL
-  branch?: string;    // Git branch
-  tag?: string;       // Git tag
-  commit?: string;    // Git commit hash (resolved)
-  path?: string;      // Subdirectory path within repository
-  file?: string;      // Direct file path within repository
-}
-
-export interface DependencyTree {
-  [key: string]: {
-    dependencies?: DependencyTree;
-  } | string; // String for "(shared)" marker
-}

package/src/utils/file-system.ts

@@ -1,55 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-import { CraftDeskJson } from '../types/craftdesk-json';
-import { CraftDeskLock } from '../types/craftdesk-lock';
-
-export async function readCraftDeskJson(dir: string = process.cwd()): Promise<CraftDeskJson | null> {
-  const filePath = path.join(dir, 'craftdesk.json');
-
-  try {
-    const content = await fs.readFile(filePath, 'utf-8');
-    return JSON.parse(content);
-  } catch (error) {
-    return null;
-  }
-}
-
-export async function writeCraftDeskJson(data: CraftDeskJson, dir: string = process.cwd()): Promise<void> {
-  const filePath = path.join(dir, 'craftdesk.json');
-  const content = JSON.stringify(data, null, 2);
-  await fs.writeFile(filePath, content, 'utf-8');
-}
-
-export async function readCraftDeskLock(dir: string = process.cwd()): Promise<CraftDeskLock | null> {
-  const filePath = path.join(dir, 'craftdesk.lock');
-
-  try {
-    const content = await fs.readFile(filePath, 'utf-8');
-    return JSON.parse(content);
-  } catch (error) {
-    return null;
-  }
-}
-
-export async function writeCraftDeskLock(data: CraftDeskLock, dir: string = process.cwd()): Promise<void> {
-  const filePath = path.join(dir, 'craftdesk.lock');
-  const content = JSON.stringify(data, null, 2);
-  await fs.writeFile(filePath, content, 'utf-8');
-}
-
-export async function ensureDir(dirPath: string): Promise<void> {
-  await fs.ensureDir(dirPath);
-}
-
-export async function removeDir(dirPath: string): Promise<void> {
-  await fs.remove(dirPath);
-}
-
-export async function exists(filePath: string): Promise<boolean> {
-  try {
-    await fs.access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}

package/src/utils/logger.ts

@@ -1,82 +0,0 @@
-// ANSI color codes
-const colors = {
-  reset: '\x1b[0m',
-  green: '\x1b[32m',
-  red: '\x1b[31m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  gray: '\x1b[90m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-};
-
-export class Logger {
-  private spinnerText: string | null = null;
-
-  success(message: string): void {
-    console.log(`${colors.green}✓${colors.reset}`, message);
-  }
-
-  error(message: string): void {
-    console.error(`${colors.red}✗${colors.reset}`, message);
-  }
-
-  warn(message: string): void {
-    console.log(`${colors.yellow}!${colors.reset}`, message);
-  }
-
-  info(message: string): void {
-    console.log(`${colors.blue}→${colors.reset}`, message);
-  }
-
-  debug(message: string): void {
-    if (process.env.DEBUG) {
-      console.log(`${colors.gray}[DEBUG]${colors.reset}`, message);
-    }
-  }
-
-  startSpinner(text: string): void {
-    this.spinnerText = text;
-    console.log(`${colors.cyan}⋯${colors.reset}`, text);
-  }
-
-  updateSpinner(text: string): void {
-    if (this.spinnerText) {
-      this.spinnerText = text;
-      console.log('  ', text);
-    }
-  }
-
-  succeedSpinner(text?: string): void {
-    if (this.spinnerText) {
-      console.log(`${colors.green}✓${colors.reset}`, text || this.spinnerText);
-      this.spinnerText = null;
-    }
-  }
-
-  failSpinner(text?: string): void {
-    if (this.spinnerText) {
-      console.log(`${colors.red}✗${colors.reset}`, text || this.spinnerText);
-      this.spinnerText = null;
-    }
-  }
-
-  stopSpinner(): void {
-    this.spinnerText = null;
-  }
-
-  log(message: string): void {
-    console.log(message);
-  }
-
-  bold(text: string): string {
-    return `${colors.bold}${text}${colors.reset}`;
-  }
-
-  dim(text: string): string {
-    return `${colors.dim}${text}${colors.reset}`;
-  }
-}
-
-export const logger = new Logger();

package/tests/fixtures/craftdesk-git.json

@@ -1,17 +0,0 @@
-{
-  "name": "git-test-project",
-  "version": "1.0.0",
-  "type": "skill",
-  "description": "Test project with git dependencies",
-  "dependencies": {
-    "custom-auth": {
-      "git": "https://github.com/company/auth.git",
-      "branch": "main"
-    },
-    "monorepo-skill": {
-      "git": "https://github.com/company/monorepo.git",
-      "tag": "v3.0.0",
-      "path": "skills/auth"
-    }
-  }
-}

package/tests/fixtures/craftdesk.json

@@ -1,15 +0,0 @@
-{
-  "name": "test-project",
-  "version": "1.0.0",
-  "type": "skill",
-  "description": "Test project for unit tests",
-  "dependencies": {
-    "ruby-on-rails": "^7.0.0",
-    "postgres-expert": "^1.0.0"
-  },
-  "registries": {
-    "default": {
-      "url": "https://craftdesk.ai"
-    }
-  }
-}

package/tests/helpers/test-utils.ts

@@ -1,60 +0,0 @@
-import fs from 'fs-extra';
-import path from 'path';
-
-/**
- * Creates a temporary test directory
- */
-export async function createTempDir(prefix: string = 'test-'): Promise<string> {
-  const tmpDir = path.join(process.cwd(), '.test-tmp', `${prefix}${Date.now()}`);
-  await fs.ensureDir(tmpDir);
-  return tmpDir;
-}
-
-/**
- * Cleans up a temporary directory
- */
-export async function cleanupTempDir(dirPath: string): Promise<void> {
-  if (dirPath.includes('.test-tmp')) {
-    await fs.remove(dirPath);
-  }
-}
-
-/**
- * Copies a fixture file to a target directory
- */
-export async function copyFixture(fixtureName: string, targetDir: string): Promise<void> {
-  const fixturePath = path.join(__dirname, '..', 'fixtures', fixtureName);
-  const targetPath = path.join(targetDir, path.basename(fixtureName));
-  await fs.copy(fixturePath, targetPath);
-}
-
-/**
- * Reads a JSON file and returns parsed content
- */
-export async function readJsonFile<T = any>(filePath: string): Promise<T> {
-  const content = await fs.readFile(filePath, 'utf-8');
-  return JSON.parse(content);
-}
-
-/**
- * Writes a JSON object to a file
- */
-export async function writeJsonFile(filePath: string, data: any): Promise<void> {
-  await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8');
-}
-
-/**
- * Mock registry response for testing
- */
-export function createMockCraftInfo(name: string, version: string = '1.0.0') {
-  return {
-    name,
-    version,
-    type: 'skill',
-    author: 'test-author',
-    description: 'Test craft',
-    download_url: `https://craftdesk.ai/api/v1/crafts/test-author/${name}/versions/${version}/download`,
-    integrity: 'sha256-test123',
-    dependencies: {}
-  };
-}

package/tests/integration/init-command.test.ts

@@ -1,70 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { execSync } from 'child_process';
-import { createTempDir, cleanupTempDir, readJsonFile } from '../helpers/test-utils';
-import path from 'path';
-import fs from 'fs-extra';
-
-describe('craftdesk init command', () => {
-  let tempDir: string;
-  let originalCwd: string;
-  const cliPath = path.join(__dirname, '../../dist/index.js');
-
-  beforeEach(async () => {
-    tempDir = await createTempDir('init-test-');
-    originalCwd = process.cwd();
-    process.chdir(tempDir);
-  });
-
-  afterEach(async () => {
-    process.chdir(originalCwd);
-    await cleanupTempDir(tempDir);
-  });
-
-  it('should create a new craftdesk.json file', async () => {
-    // Run init command
-    execSync(`node ${cliPath} init --name test-project --project-version 1.0.0 --type skill`, {
-      stdio: 'pipe'
-    });
-
-    const craftdeskPath = path.join(tempDir, 'craftdesk.json');
-    const exists = await fs.pathExists(craftdeskPath);
-    expect(exists).toBe(true);
-
-    const config = await readJsonFile(craftdeskPath);
-    expect(config.name).toBe('test-project');
-    expect(config.version).toBe('1.0.0');
-    expect(config.type).toBe('skill');
-  });
-
-  it('should include default registry configuration', async () => {
-    execSync(`node ${cliPath} init --name test --project-version 1.0.0 --type agent`, {
-      stdio: 'pipe'
-    });
-
-    const config = await readJsonFile(path.join(tempDir, 'craftdesk.json'));
-    expect(config.registries).toBeDefined();
-    expect(config.registries.default).toBeDefined();
-    expect(config.registries.default.url).toBe('https://craftdesk.ai');
-  });
-
-  it('should not overwrite existing craftdesk.json', async () => {
-    // Create existing file
-    await fs.writeJson(path.join(tempDir, 'craftdesk.json'), {
-      name: 'existing',
-      version: '2.0.0'
-    });
-
-    // Try to init again
-    try {
-      execSync(`node ${cliPath} init --name test --project-version 1.0.0 --type skill`, {
-        stdio: 'pipe'
-      });
-    } catch (error) {
-      // Expected to fail
-    }
-
-    const config = await readJsonFile(path.join(tempDir, 'craftdesk.json'));
-    expect(config.name).toBe('existing');
-    expect(config.version).toBe('2.0.0');
-  });
-});

package/tests/integration/list-command.test.ts

@@ -1,77 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { execSync } from 'child_process';
-import { createTempDir, cleanupTempDir, writeJsonFile } from '../helpers/test-utils';
-import path from 'path';
-import fs from 'fs-extra';
-
-describe('craftdesk list command', () => {
-  let tempDir: string;
-  let originalCwd: string;
-  const cliPath = path.join(__dirname, '../../dist/index.js');
-
-  beforeEach(async () => {
-    tempDir = await createTempDir('list-test-');
-    originalCwd = process.cwd();
-    process.chdir(tempDir);
-  });
-
-  afterEach(async () => {
-    process.chdir(originalCwd);
-    await cleanupTempDir(tempDir);
-  });
-
-  it('should list installed crafts', async () => {
-    // Create craftdesk.json
-    await writeJsonFile(path.join(tempDir, 'craftdesk.json'), {
-      name: 'test-project',
-      version: '1.0.0',
-      dependencies: {
-        'ruby-on-rails': '^7.0.0',
-        'postgres-expert': '^1.0.0'
-      }
-    });
-
-    // Create mock installed crafts
-    const skillDir = path.join(tempDir, '.claude', 'skills', 'ruby-on-rails');
-    await fs.ensureDir(skillDir);
-    await writeJsonFile(path.join(skillDir, '.craftdesk-metadata.json'), {
-      name: 'ruby-on-rails',
-      version: '7.1.0',
-      type: 'skill',
-      installedAt: new Date().toISOString()
-    });
-
-    const agentDir = path.join(tempDir, '.claude', 'agents', 'postgres-expert');
-    await fs.ensureDir(agentDir);
-    await writeJsonFile(path.join(agentDir, '.craftdesk-metadata.json'), {
-      name: 'postgres-expert',
-      version: '1.2.0',
-      type: 'agent',
-      installedAt: new Date().toISOString()
-    });
-
-    const output = execSync(`node ${cliPath} list`, {
-      encoding: 'utf-8'
-    });
-
-    expect(output).toContain('ruby-on-rails');
-    expect(output).toContain('7.1.0');
-    expect(output).toContain('postgres-expert');
-    expect(output).toContain('1.2.0');
-  });
-
-  it('should handle no installed crafts', async () => {
-    // Create craftdesk.json first
-    await writeJsonFile(path.join(tempDir, 'craftdesk.json'), {
-      name: 'empty-project',
-      version: '1.0.0',
-      dependencies: {}
-    });
-
-    const output = execSync(`node ${cliPath} list`, {
-      encoding: 'utf-8'
-    });
-
-    expect(output).toContain('No crafts installed');
-  });
-});