@studio-foundation/cli 0.3.0-beta.1 → 0.3.0-beta.5

package/tests/commands/registry/install.test.ts

@@ -1,200 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { rm, mkdir, readFile, writeFile } from 'node:fs/promises';
-import { resolve, join } from 'node:path';
-
-const TMP = resolve(import.meta.dirname, '.tmp-install');
-const STUDIO_DIR = join(TMP, '.studio');
-
-const MOCK_METADATA = {
-  name: 'linear',
-  type: 'integration',
-  version: '1.0.0',
-  description: 'Linear integration',
-  author: 'studio-core',
-  license: 'MIT',
-  tags: ['linear'],
-  studio_version: '>=7.0.0',
-};
-
-const MOCK_INDEX = {
-  generated_at: '2026-02-28T00:00:00Z',
-  version: '1',
-  packages: [{ ...MOCK_METADATA, downloads: 0 }],
-};
-
-const FAKE_INTEGRATION_CONTENT = 'name: linear\ntype: integration\n';
-
-// Mock syncRegistry to be a no-op (sync already handled), and RegistryCache.read to return mock index
-vi.mock('../../../src/commands/registry/sync.js', () => ({
-  syncRegistry: vi.fn().mockResolvedValue(undefined),
-}));
-vi.mock('../../../src/registry/cache.js', () => {
-  class RegistryCache {
-    read() { return Promise.resolve(MOCK_INDEX); }
-    write() { return Promise.resolve(undefined); }
-    isFresh() { return Promise.resolve(true); }
-  }
-  return { RegistryCache };
-});
-
-beforeEach(async () => {
-  await mkdir(STUDIO_DIR, { recursive: true });
-  vi.stubGlobal('fetch', vi.fn()
-    .mockResolvedValueOnce({ ok: true, json: async () => MOCK_METADATA })
-    .mockResolvedValueOnce({ ok: true, text: async () => FAKE_INTEGRATION_CONTENT }),
-  );
-});
-afterEach(async () => {
-  await rm(TMP, { recursive: true, force: true });
-  vi.unstubAllGlobals();
-  vi.resetModules();
-  vi.restoreAllMocks();
-});
-
-describe('installPackage', () => {
-  it('installs an integration to .studio/integrations/', async () => {
-    const { installPackage } = await import('../../../src/commands/registry/install.js');
-    await installPackage('linear', { studioDir: STUDIO_DIR, force: true });
-
-    const dest = resolve(STUDIO_DIR, 'integrations', 'linear.integration.yaml');
-    const content = await readFile(dest, 'utf8');
-    expect(content).toBe(FAKE_INTEGRATION_CONTENT);
-  });
-
-  it('writes lockfile entry after install', async () => {
-    const { installPackage } = await import('../../../src/commands/registry/install.js');
-    await installPackage('linear', { studioDir: STUDIO_DIR, force: true });
-
-    const lf = JSON.parse(await readFile(resolve(STUDIO_DIR, 'registry.lock.json'), 'utf8'));
-    expect(lf.installed['linear']).toMatchObject({
-      version: '1.0.0',
-      type: 'integration',
-    });
-    expect(lf.installed['linear'].sha256).toBeTruthy();
-  });
-});
-
-// --- ADDITIONAL CONSTANTS for dep resolution tests ---
-
-const MOCK_TOOL_META = {
-  name: 'repo-manager',
-  type: 'tool',
-  version: '1.0.0',
-  description: 'File manager',
-  author: 'studio-core',
-  license: 'MIT',
-  tags: [] as string[],
-  studio_version: '>=7.0.0',
-};
-
-const MOCK_INDEX_WITH_DEPS = {
-  generated_at: '2026-02-28T00:00:00Z',
-  version: '1',
-  packages: [
-    {
-      name: 'software-full',
-      type: 'template',
-      version: '2.0.0',
-      description: 'Full software template',
-      author: 'studio-core',
-      license: 'MIT',
-      tags: [] as string[],
-      studio_version: '>=7.0.0',
-      downloads: 0,
-    },
-    { ...MOCK_TOOL_META, downloads: 0 },
-  ],
-};
-
-const MOCK_TEMPLATE_META_WITH_DEPS = {
-  ...MOCK_INDEX_WITH_DEPS.packages[0],
-  dependencies: {
-    tools: { required: ['repo-manager'] as string[] },
-  },
-};
-
-describe('installPackage — with required dependencies', () => {
-  beforeEach(async () => {
-    await mkdir(STUDIO_DIR, { recursive: true });
-    vi.resetModules();
-  });
-
-  afterEach(async () => {
-    await rm(TMP, { recursive: true, force: true });
-    vi.unstubAllGlobals();
-    vi.resetModules();
-    vi.restoreAllMocks();
-  });
-
-  it('auto-installs required deps without prompting', async () => {
-    vi.doMock('../../../src/registry/cache.js', () => {
-      class RegistryCache {
-        read() { return Promise.resolve(MOCK_INDEX_WITH_DEPS); }
-        write() { return Promise.resolve(undefined); }
-        isFresh() { return Promise.resolve(true); }
-      }
-      return { RegistryCache };
-    });
-    vi.doMock('../../../src/commands/registry/sync.js', () => ({
-      syncRegistry: vi.fn().mockResolvedValue(undefined),
-    }));
-
-    vi.stubGlobal('fetch', vi.fn()
-      // 1. fetch template metadata (has dependencies)
-      .mockResolvedValueOnce({ ok: true, json: async () => MOCK_TEMPLATE_META_WITH_DEPS })
-      // 2. download template dir (GitHub API — empty dir for simplicity)
-      .mockResolvedValueOnce({ ok: true, json: async () => [] })
-      // 3. fetch repo-manager metadata (dep)
-      .mockResolvedValueOnce({ ok: true, json: async () => MOCK_TOOL_META })
-      // 4. download repo-manager file
-      .mockResolvedValueOnce({ ok: true, text: async () => 'name: repo_manager\n' }),
-    );
-
-    const { installPackage } = await import('../../../src/commands/registry/install.js');
-    await installPackage('software-full', { studioDir: STUDIO_DIR, force: true });
-
-    const lf = JSON.parse(await readFile(resolve(STUDIO_DIR, 'registry.lock.json'), 'utf8'));
-    expect(lf.installed['software-full']).toBeDefined();
-    expect(lf.installed['repo-manager']).toBeDefined();
-    expect(lf.installed['repo-manager'].required_by).toEqual(['software-full']);
-  });
-
-  it('updates required_by if dep already installed', async () => {
-    // Pre-install repo-manager in the lockfile
-    await mkdir(resolve(STUDIO_DIR, 'tools'), { recursive: true });
-    await writeFile(resolve(STUDIO_DIR, 'tools', 'repo-manager.tool.yaml'), 'name: repo_manager\n');
-    await writeFile(resolve(STUDIO_DIR, 'registry.lock.json'), JSON.stringify({
-      installed: {
-        'repo-manager': { version: '1.0.0', type: 'tool', installed_at: '2026-02-28', sha256: 'abc' },
-      },
-    }));
-
-    vi.doMock('../../../src/registry/cache.js', () => {
-      class RegistryCache {
-        read() { return Promise.resolve(MOCK_INDEX_WITH_DEPS); }
-        write() { return Promise.resolve(undefined); }
-        isFresh() { return Promise.resolve(true); }
-      }
-      return { RegistryCache };
-    });
-    vi.doMock('../../../src/commands/registry/sync.js', () => ({
-      syncRegistry: vi.fn().mockResolvedValue(undefined),
-    }));
-
-    vi.stubGlobal('fetch', vi.fn()
-      // 1. fetch template metadata
-      .mockResolvedValueOnce({ ok: true, json: async () => MOCK_TEMPLATE_META_WITH_DEPS })
-      // 2. download template dir
-      .mockResolvedValueOnce({ ok: true, json: async () => [] })
-      // 3. fetch repo-manager metadata for resolver
-      .mockResolvedValueOnce({ ok: true, json: async () => MOCK_TOOL_META }),
-    );
-
-    const { installPackage } = await import('../../../src/commands/registry/install.js');
-    await installPackage('software-full', { studioDir: STUDIO_DIR, force: true });
-
-    const lf = JSON.parse(await readFile(resolve(STUDIO_DIR, 'registry.lock.json'), 'utf8'));
-    // repo-manager was not reinstalled but required_by updated
-    expect(lf.installed['repo-manager'].required_by).toContain('software-full');
-  });
-});

package/tests/commands/registry/publish.test.ts

@@ -1,56 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { rm, mkdir, writeFile } from 'node:fs/promises';
-import { resolve, join } from 'node:path';
-
-const TMP = resolve(import.meta.dirname, '.tmp-publish');
-
-const VALID_METADATA = JSON.stringify({
-  name: 'my-tool',
-  version: '1.0.0',
-  description: 'My custom tool',
-  author: 'test-user',
-  license: 'MIT',
-  type: 'tool',
-  tags: ['test'],
-  studio_version: '>=7.0.0',
-}, null, 2);
-
-beforeEach(async () => { await mkdir(TMP, { recursive: true }); });
-afterEach(async () => { await rm(TMP, { recursive: true, force: true }); });
-
-describe('validatePublishPayload', () => {
-  it('accepts valid single-file package with metadata.json in same dir', async () => {
-    const toolPath = join(TMP, 'my-tool.tool.yaml');
-    await writeFile(toolPath, 'name: my-tool\n');
-    await writeFile(join(TMP, 'metadata.json'), VALID_METADATA);
-
-    const { validatePublishPayload } = await import('../../../src/commands/registry/publish.js');
-    const result = await validatePublishPayload(toolPath);
-    expect(result.name).toBe('my-tool');
-    expect(result.type).toBe('tool');
-  });
-
-  it('rejects when metadata.json is missing', async () => {
-    const toolPath = join(TMP, 'sub', 'my-tool.tool.yaml');
-    await mkdir(join(TMP, 'sub'), { recursive: true });
-    await writeFile(toolPath, 'name: my-tool\n');
-    // No metadata.json
-
-    const { validatePublishPayload } = await import('../../../src/commands/registry/publish.js');
-    await expect(validatePublishPayload(toolPath)).rejects.toThrow('metadata.json');
-  });
-
-  it('rejects when metadata is missing required fields', async () => {
-    const toolPath = join(TMP, 'my-tool.tool.yaml');
-    await writeFile(toolPath, 'name: my-tool\n');
-    await writeFile(join(TMP, 'metadata.json'), JSON.stringify({ name: 'my-tool' }));
-
-    const { validatePublishPayload } = await import('../../../src/commands/registry/publish.js');
-    await expect(validatePublishPayload(toolPath)).rejects.toThrow('Missing required');
-  });
-
-  it('rejects when package file does not exist', async () => {
-    const { validatePublishPayload } = await import('../../../src/commands/registry/publish.js');
-    await expect(validatePublishPayload(join(TMP, 'nonexistent.tool.yaml'))).rejects.toThrow('does not exist');
-  });
-});

package/tests/commands/registry/remove.test.ts

@@ -1,103 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { rm, mkdir, writeFile, readFile } from 'node:fs/promises';
-import { resolve, join } from 'node:path';
-
-const TMP = resolve(import.meta.dirname, '.tmp-remove');
-const STUDIO = join(TMP, '.studio');
-
-beforeEach(async () => {
-  await mkdir(resolve(STUDIO, 'tools'), { recursive: true });
-  await writeFile(resolve(STUDIO, 'tools', 'my-tool.tool.yaml'), 'name: my-tool\n');
-  await writeFile(resolve(STUDIO, 'registry.lock.json'), JSON.stringify({
-    installed: {
-      'my-tool': { version: '1.0.0', type: 'tool', installed_at: '2026-02-28', sha256: 'abc' },
-    },
-  }));
-});
-afterEach(async () => { await rm(TMP, { recursive: true, force: true }); });
-
-describe('removePackage', () => {
-  it('removes the file and lockfile entry', async () => {
-    const { removePackage } = await import('../../../src/commands/registry/remove.js');
-    await removePackage('my-tool', { studioDir: STUDIO });
-    const lf = JSON.parse(await readFile(resolve(STUDIO, 'registry.lock.json'), 'utf8'));
-    expect(lf.installed['my-tool']).toBeUndefined();
-  });
-
-  it('errors if package not installed', async () => {
-    const { removePackage } = await import('../../../src/commands/registry/remove.js');
-    await expect(removePackage('nonexistent', { studioDir: STUDIO })).rejects.toThrow('not installed');
-  });
-});
-
-describe('removePackage — required_by protection', () => {
-  beforeEach(async () => {
-    await mkdir(resolve(STUDIO, 'tools'), { recursive: true });
-    await writeFile(resolve(STUDIO, 'tools', 'repo-manager.tool.yaml'), 'name: repo_manager\n');
-    await writeFile(resolve(STUDIO, 'registry.lock.json'), JSON.stringify({
-      installed: {
-        'repo-manager': {
-          version: '1.0.0', type: 'tool', installed_at: '2026-02-28', sha256: 'abc',
-          required_by: ['software-full'],
-        },
-      },
-    }));
-  });
-  afterEach(async () => {
-    await rm(TMP, { recursive: true, force: true });
-    vi.resetModules();
-  });
-
-  it('throws if package is required by another installed package', async () => {
-    const { removePackage } = await import('../../../src/commands/registry/remove.js');
-    await expect(removePackage('repo-manager', { studioDir: STUDIO }))
-      .rejects.toThrow(/required by.*software-full/i);
-  });
-});
-
-describe('removePackage — orphan cleanup', () => {
-  beforeEach(async () => {
-    await mkdir(resolve(STUDIO, 'tools'), { recursive: true });
-    await mkdir(resolve(STUDIO, 'projects', 'software-full'), { recursive: true });
-    await writeFile(resolve(STUDIO, 'tools', 'repo-manager.tool.yaml'), 'name: repo_manager\n');
-    await writeFile(resolve(STUDIO, 'registry.lock.json'), JSON.stringify({
-      installed: {
-        'software-full': {
-          version: '2.0.0', type: 'template', installed_at: '2026-02-28', sha256: 'def',
-          required_by: [],
-        },
-        'repo-manager': {
-          version: '1.0.0', type: 'tool', installed_at: '2026-02-28', sha256: 'abc',
-          required_by: ['software-full'],
-        },
-      },
-    }));
-  });
-  afterEach(async () => {
-    await rm(TMP, { recursive: true, force: true });
-    vi.resetModules();
-    vi.restoreAllMocks();
-  });
-
-  it('prompts about orphans and removes them when confirmed', async () => {
-    vi.doMock('@inquirer/prompts', () => ({ confirm: vi.fn().mockResolvedValue(true) }));
-    vi.resetModules();
-    const { removePackage } = await import('../../../src/commands/registry/remove.js');
-    await removePackage('software-full', { studioDir: STUDIO });
-
-    const lf = JSON.parse(await readFile(resolve(STUDIO, 'registry.lock.json'), 'utf8'));
-    expect(lf.installed['software-full']).toBeUndefined();
-    expect(lf.installed['repo-manager']).toBeUndefined();
-  });
-
-  it('leaves orphans installed when user declines', async () => {
-    vi.doMock('@inquirer/prompts', () => ({ confirm: vi.fn().mockResolvedValue(false) }));
-    vi.resetModules();
-    const { removePackage } = await import('../../../src/commands/registry/remove.js');
-    await removePackage('software-full', { studioDir: STUDIO });
-
-    const lf = JSON.parse(await readFile(resolve(STUDIO, 'registry.lock.json'), 'utf8'));
-    expect(lf.installed['software-full']).toBeUndefined();
-    expect(lf.installed['repo-manager']).toBeDefined();
-  });
-});

package/tests/commands/registry/search.test.ts

@@ -1,44 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import type { PackageEntry } from '../../../src/registry/types.js';
-
-const MOCK_PACKAGES: PackageEntry[] = [
-  { name: 'software', type: 'template', version: '1.0.0', description: 'Code generation', author: 'studio-core', license: 'MIT', tags: ['software', 'code'], studio_version: null, downloads: 10 },
-  { name: 'content', type: 'template', version: '1.0.0', description: 'Content creation', author: 'studio-core', license: 'MIT', tags: ['content', 'writing'], studio_version: null, downloads: 5 },
-  { name: 'linear', type: 'integration', version: '1.0.0', description: 'Linear integration', author: 'studio-core', license: 'MIT', tags: ['linear'], studio_version: null, downloads: 3 },
-];
-
-describe('searchPackages', () => {
-  it('filters by name match', async () => {
-    const { searchPackages } = await import('../../../src/commands/registry/search.js');
-    const results = searchPackages(MOCK_PACKAGES, 'software');
-    expect(results).toHaveLength(1);
-    expect(results[0].name).toBe('software');
-  });
-
-  it('filters by description match', async () => {
-    const { searchPackages } = await import('../../../src/commands/registry/search.js');
-    const results = searchPackages(MOCK_PACKAGES, 'creation');
-    expect(results).toHaveLength(1);
-    expect(results[0].name).toBe('content');
-  });
-
-  it('filters by type', async () => {
-    const { searchPackages } = await import('../../../src/commands/registry/search.js');
-    const results = searchPackages(MOCK_PACKAGES, undefined, 'integration');
-    expect(results).toHaveLength(1);
-    expect(results[0].name).toBe('linear');
-  });
-
-  it('returns all packages when no query and no type', async () => {
-    const { searchPackages } = await import('../../../src/commands/registry/search.js');
-    const results = searchPackages(MOCK_PACKAGES);
-    expect(results).toHaveLength(3);
-  });
-
-  it('filters by tag match', async () => {
-    const { searchPackages } = await import('../../../src/commands/registry/search.js');
-    const results = searchPackages(MOCK_PACKAGES, 'writing');
-    expect(results).toHaveLength(1);
-    expect(results[0].name).toBe('content');
-  });
-});

package/tests/commands/registry/sync.test.ts

@@ -1,37 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { rm, mkdir, readFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
-
-const TMP = resolve(import.meta.dirname, '.tmp-sync');
-const MOCK_INDEX = { generated_at: '2026-02-28T00:00:00Z', version: '1', packages: [] };
-
-beforeEach(async () => {
-  await mkdir(TMP, { recursive: true });
-  vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, json: async () => MOCK_INDEX }));
-});
-afterEach(async () => {
-  await rm(TMP, { recursive: true, force: true });
-  vi.unstubAllGlobals();
-});
-
-describe('syncRegistry', () => {
-  it('writes index.json to cache dir when forced', async () => {
-    const { syncRegistry } = await import('../../../src/commands/registry/sync.js');
-    await syncRegistry({ cacheDir: TMP, force: true });
-    const raw = await readFile(resolve(TMP, 'index.json'), 'utf8');
-    const data = JSON.parse(raw);
-    expect(data.version).toBe('1');
-  });
-
-  it('skips sync if cache is fresh and force=false', async () => {
-    // Write a fresh cache first
-    const { RegistryCache } = await import('../../../src/registry/cache.js');
-    const cache = new RegistryCache(TMP);
-    await cache.write(MOCK_INDEX);
-    vi.mocked(fetch).mockClear();
-
-    const { syncRegistry } = await import('../../../src/commands/registry/sync.js');
-    await syncRegistry({ cacheDir: TMP, force: false });
-    expect(vi.mocked(fetch)).not.toHaveBeenCalled();
-  });
-});

package/tests/commands/registry/update.test.ts

@@ -1,62 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { rm, mkdir, writeFile } from 'node:fs/promises';
-import { resolve, join } from 'node:path';
-import type { RegistryIndex } from '../../../src/registry/types.js';
-
-const TMP = resolve(import.meta.dirname, '.tmp-update');
-const STUDIO = join(TMP, '.studio');
-
-const MOCK_INDEX: RegistryIndex = {
-  generated_at: '2026-02-28T00:00:00Z',
-  version: '1',
-  packages: [
-    { name: 'linear', type: 'integration', version: '2.0.0', description: 'Linear', author: 'studio-core', license: 'MIT', tags: [], studio_version: null, downloads: 0 },
-  ],
-};
-
-vi.mock('../../../src/commands/registry/sync.js', () => ({
-  syncRegistry: vi.fn().mockResolvedValue(undefined),
-}));
-vi.mock('../../../src/registry/cache.js', () => {
-  class RegistryCache {
-    read() { return Promise.resolve(MOCK_INDEX); }
-    write() { return Promise.resolve(undefined); }
-    isFresh() { return Promise.resolve(true); }
-  }
-  return { RegistryCache };
-});
-
-beforeEach(async () => {
-  await mkdir(STUDIO, { recursive: true });
-  await writeFile(resolve(STUDIO, 'registry.lock.json'), JSON.stringify({
-    installed: {
-      'linear': { version: '1.0.0', type: 'integration', installed_at: '2026-02-28', sha256: 'old' },
-    },
-  }));
-});
-afterEach(async () => {
-  await rm(TMP, { recursive: true, force: true });
-  vi.resetModules();
-  vi.restoreAllMocks();
-});
-
-describe('outdatedPackages', () => {
-  it('returns packages with newer versions in registry', async () => {
-    const { outdatedPackages } = await import('../../../src/commands/registry/update.js');
-    const result = await outdatedPackages({ studioDir: STUDIO });
-    expect(result).toHaveLength(1);
-    expect(result[0]).toMatchObject({ name: 'linear', installed: '1.0.0', latest: '2.0.0' });
-  });
-
-  it('returns empty when all packages up to date', async () => {
-    // Update lockfile to match registry version
-    await writeFile(resolve(STUDIO, 'registry.lock.json'), JSON.stringify({
-      installed: {
-        'linear': { version: '2.0.0', type: 'integration', installed_at: '2026-02-28', sha256: 'new' },
-      },
-    }));
-    const { outdatedPackages } = await import('../../../src/commands/registry/update.js');
-    const result = await outdatedPackages({ studioDir: STUDIO });
-    expect(result).toHaveLength(0);
-  });
-});