@gitpm/cli 0.1.0 → 0.1.16

package/package.json

@@ -1,20 +1,73 @@
 {
   "name": "@gitpm/cli",
-  "version": "0.1.0",
+  "version": "0.1.16",
+  "license": "MIT",
+  "description": "Git-native project management CLI — manage roadmaps, epics, and stories from a .meta/ tree synced with GitHub, GitLab, Jira, Linear, and Bitbucket",
+  "keywords": [
+    "gitpm",
+    "project-management",
+    "github",
+    "gitlab",
+    "jira",
+    "linear",
+    "bitbucket",
+    "issues",
+    "roadmap",
+    "epics",
+    "cli",
+    "developer-tools"
+  ],
+  "homepage": "https://github.com/yevheniidehtiar/gitpm#readme",
+  "bugs": {
+    "url": "https://github.com/yevheniidehtiar/gitpm/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yevheniidehtiar/gitpm.git",
+    "directory": "packages/cli"
+  },
   "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
   "bin": {
-    "gitpm": "dist/index.js"
+    "gitpm": "./dist/index.js"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup"
   },
   "dependencies": {
-    "@gitpm/core": "workspace:*",
-    "@gitpm/sync-github": "workspace:*",
-    "@gitpm/sync-gitlab": "workspace:*",
-    "@inquirer/prompts": "^7.0.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "ora": "^8.1.0"
+    "@gitpm/core": "0.1.16",
+    "@inquirer/prompts": "^8.7.5",
+    "chalk": "^6.0.1",
+    "commander": "^15.0.0",
+    "ora": "^10.0.0"
+  },
+  "peerDependencies": {
+    "@gitpm/sync-github": "^0.1.14",
+    "@gitpm/sync-gitlab": "^0.1.11",
+    "@gitpm/sync-jira": "^0.1.10",
+    "@gitpm/sync-linear": "^0.1.2",
+    "@gitpm/sync-bitbucket": "^1.1.1"
+  },
+  "peerDependenciesMeta": {
+    "@gitpm/sync-github": {
+      "optional": true
+    },
+    "@gitpm/sync-gitlab": {
+      "optional": true
+    },
+    "@gitpm/sync-jira": {
+      "optional": true
+    },
+    "@gitpm/sync-linear": {
+      "optional": true
+    },
+    "@gitpm/sync-bitbucket": {
+      "optional": true
+    }
   }
 }

package/src/__tests__/import.test.ts

@@ -1,220 +0,0 @@
-import { Command } from 'commander';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-// --- Mocks ---
-
-const mockImportFromGitHub = vi.fn();
-const mockImportFromGitLab = vi.fn();
-const mockResolveToken = vi.fn();
-
-vi.mock('@gitpm/sync-github', () => ({
-  importFromGitHub: (...args: unknown[]) => mockImportFromGitHub(...args),
-}));
-
-vi.mock('@gitpm/sync-gitlab', () => ({
-  importFromGitLab: (...args: unknown[]) => mockImportFromGitLab(...args),
-}));
-
-vi.mock('../utils/auth.js', () => ({
-  resolveToken: (...args: unknown[]) => mockResolveToken(...args),
-}));
-
-vi.mock('ora', () => ({
-  default: () => ({
-    start: vi.fn().mockReturnThis(),
-    succeed: vi.fn().mockReturnThis(),
-    fail: vi.fn().mockReturnThis(),
-    stop: vi.fn().mockReturnThis(),
-  }),
-}));
-
-let logSpy: ReturnType<typeof vi.spyOn>;
-let errorSpy: ReturnType<typeof vi.spyOn>;
-let exitSpy: ReturnType<typeof vi.spyOn>;
-
-async function run(...args: string[]) {
-  const { importCommand } = await import('../commands/import.js');
-  const program = new Command();
-  program.option('--meta-dir <path>', 'Path to .meta directory', '.meta');
-  program.addCommand(importCommand);
-  await program.parseAsync(['node', 'gitpm', 'import', ...args]);
-}
-
-const importSummary = {
-  milestones: 2,
-  epics: 3,
-  stories: 5,
-  totalFiles: 10,
-};
-
-// --- Tests ---
-
-describe('gitpm import', () => {
-  beforeEach(() => {
-    vi.resetModules();
-    vi.resetAllMocks();
-    logSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
-    errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
-    exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => {
-      throw new Error('process.exit');
-    }) as never);
-    mockResolveToken.mockResolvedValue('mock-token');
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  // --- GitHub ---
-
-  it('imports from GitHub successfully', async () => {
-    mockImportFromGitHub.mockResolvedValue({ ok: true, value: importSummary });
-
-    await run('--repo', 'owner/repo', '--meta-dir', '/tmp/meta');
-
-    expect(mockImportFromGitHub).toHaveBeenCalledWith(
-      expect.objectContaining({
-        token: 'mock-token',
-        repo: 'owner/repo',
-        metaDir: '/tmp/meta',
-      }),
-    );
-    expect(exitSpy).not.toHaveBeenCalled();
-    const allOutput = logSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(allOutput).toContain('Milestones: 2');
-    expect(allOutput).toContain('Epics:      3');
-    expect(allOutput).toContain('Stories:    5');
-  });
-
-  it('exits with code 1 when --repo is missing', async () => {
-    await expect(run('--meta-dir', '/tmp/meta')).rejects.toThrow(
-      'process.exit',
-    );
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('--repo is required');
-  });
-
-  it('exits with code 1 when --repo format is invalid', async () => {
-    await expect(
-      run('--repo', 'badformat', '--meta-dir', '/tmp/meta'),
-    ).rejects.toThrow('process.exit');
-    expect(exitSpy).toHaveBeenCalledWith(1);
-  });
-
-  it('passes --link-strategy to importFromGitHub', async () => {
-    mockImportFromGitHub.mockResolvedValue({ ok: true, value: importSummary });
-
-    await run(
-      '--repo',
-      'owner/repo',
-      '--link-strategy',
-      'labels',
-      '--meta-dir',
-      '/tmp/meta',
-    );
-
-    expect(mockImportFromGitHub).toHaveBeenCalledWith(
-      expect.objectContaining({ linkStrategy: 'labels' }),
-    );
-  });
-
-  it('exits with code 1 for invalid link strategy', async () => {
-    await expect(
-      run(
-        '--repo',
-        'owner/repo',
-        '--link-strategy',
-        'invalid-strat',
-        '--meta-dir',
-        '/tmp/meta',
-      ),
-    ).rejects.toThrow('process.exit');
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('Invalid link strategy');
-  });
-
-  it('exits with code 1 when import fails', async () => {
-    mockImportFromGitHub.mockResolvedValue({
-      ok: false,
-      error: { message: 'API rate limit exceeded' },
-    });
-
-    await expect(
-      run('--repo', 'owner/repo', '--meta-dir', '/tmp/meta'),
-    ).rejects.toThrow('process.exit');
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('API rate limit exceeded');
-  });
-
-  it('exits with code 1 when token resolution fails', async () => {
-    mockResolveToken.mockRejectedValue(new Error('No GitHub token found'));
-
-    await expect(
-      run('--repo', 'owner/repo', '--meta-dir', '/tmp/meta'),
-    ).rejects.toThrow('process.exit');
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('No GitHub token found');
-  });
-
-  // --- GitLab ---
-
-  it('imports from GitLab successfully', async () => {
-    mockImportFromGitLab.mockResolvedValue({ ok: true, value: importSummary });
-
-    await run(
-      '--source',
-      'gitlab',
-      '--project',
-      'group/proj',
-      '--token',
-      'gl-tok',
-      '--meta-dir',
-      '/tmp/meta',
-    );
-
-    expect(mockImportFromGitLab).toHaveBeenCalledWith(
-      expect.objectContaining({ token: 'gl-tok', project: 'group/proj' }),
-    );
-    expect(exitSpy).not.toHaveBeenCalled();
-  });
-
-  it('exits with code 1 when GitLab project is missing', async () => {
-    await expect(
-      run('--source', 'gitlab', '--token', 'gl-tok', '--meta-dir', '/tmp/meta'),
-    ).rejects.toThrow('process.exit');
-    expect(exitSpy).toHaveBeenCalledWith(1);
-  });
-
-  it('exits with code 1 when GitLab token is missing', async () => {
-    const originalEnv = process.env.GITLAB_TOKEN;
-    // biome-ignore lint/performance/noDelete: must remove env var, not set to "undefined" string
-    delete process.env.GITLAB_TOKEN;
-
-    await expect(
-      run(
-        '--source',
-        'gitlab',
-        '--project',
-        'group/proj',
-        '--meta-dir',
-        '/tmp/meta',
-      ),
-    ).rejects.toThrow('process.exit');
-    expect(exitSpy).toHaveBeenCalledWith(1);
-
-    process.env.GITLAB_TOKEN = originalEnv;
-  });
-
-  it('exits with code 1 for unknown source', async () => {
-    await expect(
-      run('--source', 'bitbucket', '--meta-dir', '/tmp/meta'),
-    ).rejects.toThrow('process.exit');
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('Unknown source');
-  });
-});

package/src/__tests__/init.test.ts

@@ -1,112 +0,0 @@
-import { mkdtemp, rm } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { Command } from 'commander';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-// --- Mocks ---
-
-const mockScaffoldMeta = vi.fn();
-const mockInput = vi.fn();
-
-vi.mock('@gitpm/core', () => ({
-  scaffoldMeta: (...args: unknown[]) => mockScaffoldMeta(...args),
-}));
-
-vi.mock('@inquirer/prompts', () => ({
-  input: (...args: unknown[]) => mockInput(...args),
-}));
-
-let logSpy: ReturnType<typeof vi.spyOn>;
-let errorSpy: ReturnType<typeof vi.spyOn>;
-let exitSpy: ReturnType<typeof vi.spyOn>;
-
-async function run(...args: string[]) {
-  const { initCommand } = await import('../commands/init.js');
-  const program = new Command();
-  program.option('--meta-dir <path>', 'Path to .meta directory', '.meta');
-  program.addCommand(initCommand);
-  await program.parseAsync(['node', 'gitpm', 'init', ...args]);
-}
-
-// --- Tests ---
-
-describe('gitpm init', () => {
-  let tmpDir: string;
-
-  beforeEach(async () => {
-    vi.resetModules();
-    vi.resetAllMocks();
-    tmpDir = await mkdtemp(join(tmpdir(), 'gitpm-cli-init-'));
-    logSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
-    errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
-    exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => {
-      throw new Error('process.exit');
-    }) as never);
-  });
-
-  afterEach(async () => {
-    vi.restoreAllMocks();
-    await rm(tmpDir, { recursive: true, force: true });
-  });
-
-  it('creates .meta structure with project name argument', async () => {
-    const metaDir = join(tmpDir, '.meta');
-    mockScaffoldMeta.mockResolvedValue({ ok: true, value: undefined });
-
-    // scaffoldMeta is mocked, so collectFiles will read from an empty dir.
-    // We need to create at least one file so the readdir doesn't fail.
-    const { mkdir, writeFile } = await import('node:fs/promises');
-    await mkdir(metaDir, { recursive: true });
-    await writeFile(join(metaDir, 'roadmap.yaml'), '');
-
-    await run('my-project', '--meta-dir', metaDir);
-
-    expect(mockScaffoldMeta).toHaveBeenCalledWith(metaDir, 'my-project');
-    expect(mockInput).not.toHaveBeenCalled();
-    expect(exitSpy).not.toHaveBeenCalled();
-  });
-
-  it('prompts for project name when not provided', async () => {
-    const metaDir = join(tmpDir, '.meta');
-    mockInput.mockResolvedValue('prompted-name');
-    mockScaffoldMeta.mockResolvedValue({ ok: true, value: undefined });
-
-    const { mkdir, writeFile } = await import('node:fs/promises');
-    await mkdir(metaDir, { recursive: true });
-    await writeFile(join(metaDir, 'roadmap.yaml'), '');
-
-    await run('--meta-dir', metaDir);
-
-    expect(mockInput).toHaveBeenCalled();
-    expect(mockScaffoldMeta).toHaveBeenCalledWith(metaDir, 'prompted-name');
-  });
-
-  it('exits with code 1 when scaffoldMeta fails', async () => {
-    const metaDir = join(tmpDir, '.meta');
-    mockScaffoldMeta.mockResolvedValue({
-      ok: false,
-      error: { message: 'directory already exists' },
-    });
-
-    await expect(run('my-project', '--meta-dir', metaDir)).rejects.toThrow(
-      'process.exit',
-    );
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('directory already exists');
-  });
-
-  it('respects --meta-dir option', async () => {
-    const customDir = join(tmpDir, 'custom-meta');
-    mockScaffoldMeta.mockResolvedValue({ ok: true, value: undefined });
-
-    const { mkdir, writeFile } = await import('node:fs/promises');
-    await mkdir(customDir, { recursive: true });
-    await writeFile(join(customDir, 'roadmap.yaml'), '');
-
-    await run('test-proj', '--meta-dir', customDir);
-
-    expect(mockScaffoldMeta).toHaveBeenCalledWith(customDir, 'test-proj');
-  });
-});

package/src/__tests__/pull.test.ts

@@ -1,225 +0,0 @@
-import { Command } from 'commander';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-// --- Mocks ---
-
-const mockLoadGitHubConfig = vi.fn();
-const mockSyncWithGitHub = vi.fn();
-const mockLoadGitLabConfig = vi.fn();
-const mockSyncWithGitLab = vi.fn();
-const mockResolveToken = vi.fn();
-const mockPromptConflictResolution = vi.fn();
-
-vi.mock('@gitpm/sync-github', () => ({
-  loadConfig: (...args: unknown[]) => mockLoadGitHubConfig(...args),
-  syncWithGitHub: (...args: unknown[]) => mockSyncWithGitHub(...args),
-}));
-
-vi.mock('@gitpm/sync-gitlab', () => ({
-  loadConfig: (...args: unknown[]) => mockLoadGitLabConfig(...args),
-  syncWithGitLab: (...args: unknown[]) => mockSyncWithGitLab(...args),
-}));
-
-vi.mock('../utils/auth.js', () => ({
-  resolveToken: (...args: unknown[]) => mockResolveToken(...args),
-}));
-
-vi.mock('../utils/conflict-ui.js', () => ({
-  promptConflictResolution: (...args: unknown[]) =>
-    mockPromptConflictResolution(...args),
-}));
-
-vi.mock('ora', () => ({
-  default: () => ({
-    start: vi.fn().mockReturnThis(),
-    succeed: vi.fn().mockReturnThis(),
-    fail: vi.fn().mockReturnThis(),
-    stop: vi.fn().mockReturnThis(),
-  }),
-}));
-
-let logSpy: ReturnType<typeof vi.spyOn>;
-let errorSpy: ReturnType<typeof vi.spyOn>;
-let exitSpy: ReturnType<typeof vi.spyOn>;
-
-async function run(...args: string[]) {
-  const { pullCommand } = await import('../commands/pull.js');
-  const program = new Command();
-  program.option('--meta-dir <path>', 'Path to .meta directory', '.meta');
-  program.addCommand(pullCommand);
-  await program.parseAsync(['node', 'gitpm', 'pull', ...args]);
-}
-
-const pullResult = {
-  pulled: { milestones: 1, issues: 3 },
-  conflicts: [],
-  resolved: 0,
-  skipped: 0,
-};
-
-// --- Tests ---
-
-describe('gitpm pull', () => {
-  beforeEach(() => {
-    vi.resetModules();
-    vi.resetAllMocks();
-    logSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
-    errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
-    exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => {
-      throw new Error('process.exit');
-    }) as never);
-    mockResolveToken.mockResolvedValue('mock-token');
-    mockLoadGitHubConfig.mockResolvedValue({
-      ok: true,
-      value: { repo: 'owner/repo' },
-    });
-    mockLoadGitLabConfig.mockResolvedValue({
-      ok: false,
-      error: { message: 'not found' },
-    });
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it('pulls from GitHub successfully with remote-wins', async () => {
-    mockSyncWithGitHub.mockResolvedValue({ ok: true, value: pullResult });
-
-    await run('--meta-dir', '/tmp/meta');
-
-    expect(mockSyncWithGitHub).toHaveBeenCalledWith(
-      expect.objectContaining({ strategy: 'remote-wins' }),
-    );
-    expect(exitSpy).not.toHaveBeenCalled();
-    const allOutput = logSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(allOutput).toContain('Pull Summary');
-    expect(allOutput).toContain('4 changes');
-  });
-
-  it('prompts for conflict resolution with ask strategy', async () => {
-    const conflicts = [
-      {
-        entityId: 'e1',
-        entityTitle: 'Story 1',
-        entityType: 'story',
-        field: 'title',
-        localValue: 'Local Title',
-        remoteValue: 'Remote Title',
-      },
-    ];
-    mockSyncWithGitHub.mockResolvedValue({
-      ok: true,
-      value: { ...pullResult, conflicts, resolved: 0 },
-    });
-    mockPromptConflictResolution.mockResolvedValue([
-      { entityId: 'e1', field: 'title', pick: 'local' },
-    ]);
-
-    await run('--strategy', 'ask', '--meta-dir', '/tmp/meta');
-
-    expect(mockPromptConflictResolution).toHaveBeenCalledWith(conflicts);
-    expect(exitSpy).not.toHaveBeenCalled();
-  });
-
-  it('does not prompt for conflicts with local-wins', async () => {
-    mockSyncWithGitHub.mockResolvedValue({ ok: true, value: pullResult });
-
-    await run('--strategy', 'local-wins', '--meta-dir', '/tmp/meta');
-
-    expect(mockPromptConflictResolution).not.toHaveBeenCalled();
-    expect(mockSyncWithGitHub).toHaveBeenCalledWith(
-      expect.objectContaining({ strategy: 'local-wins' }),
-    );
-  });
-
-  it('exits with code 1 when pull fails', async () => {
-    mockSyncWithGitHub.mockResolvedValue({
-      ok: false,
-      error: { message: 'sync error' },
-    });
-
-    await expect(run('--meta-dir', '/tmp/meta')).rejects.toThrow(
-      'process.exit',
-    );
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('sync error');
-  });
-
-  it('exits with code 1 when no sync config found', async () => {
-    mockLoadGitHubConfig.mockResolvedValue({
-      ok: false,
-      error: { message: 'not found' },
-    });
-    mockLoadGitLabConfig.mockResolvedValue({
-      ok: false,
-      error: { message: 'not found' },
-    });
-
-    await expect(run('--meta-dir', '/tmp/meta')).rejects.toThrow(
-      'process.exit',
-    );
-    expect(exitSpy).toHaveBeenCalledWith(1);
-    const errOutput = errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
-    expect(errOutput).toContain('No sync config found');
-  });
-
-  it('exits with code 1 when token resolution fails', async () => {
-    mockResolveToken.mockRejectedValue(new Error('No GitHub token found'));
-
-    await expect(run('--meta-dir', '/tmp/meta')).rejects.toThrow(
-      'process.exit',
-    );
-    expect(exitSpy).toHaveBeenCalledWith(1);
-  });
-
-  it('pulls from GitLab when GitLab config is found', async () => {
-    mockLoadGitHubConfig.mockResolvedValue({
-      ok: false,
-      error: { message: 'not found' },
-    });
-    mockLoadGitLabConfig.mockResolvedValue({
-      ok: true,
-      value: {
-        project: 'group/proj',
-        project_id: 42,
-        base_url: 'https://gitlab.com',
-      },
-    });
-    mockSyncWithGitLab.mockResolvedValue({ ok: true, value: pullResult });
-
-    await run('--token', 'gl-tok', '--meta-dir', '/tmp/meta');
-
-    expect(mockSyncWithGitLab).toHaveBeenCalledWith(
-      expect.objectContaining({ token: 'gl-tok', project: 'group/proj' }),
-    );
-    expect(exitSpy).not.toHaveBeenCalled();
-  });
-
-  it('exits with code 1 when GitLab token is missing', async () => {
-    const originalEnv = process.env.GITLAB_TOKEN;
-    // biome-ignore lint/performance/noDelete: must remove env var, not set to "undefined" string
-    delete process.env.GITLAB_TOKEN;
-
-    mockLoadGitHubConfig.mockResolvedValue({
-      ok: false,
-      error: { message: 'not found' },
-    });
-    mockLoadGitLabConfig.mockResolvedValue({
-      ok: true,
-      value: {
-        project: 'group/proj',
-        project_id: 42,
-        base_url: 'https://gitlab.com',
-      },
-    });
-
-    await expect(run('--meta-dir', '/tmp/meta')).rejects.toThrow(
-      'process.exit',
-    );
-    expect(exitSpy).toHaveBeenCalledWith(1);
-
-    process.env.GITLAB_TOKEN = originalEnv;
-  });
-});