@gitpm/cli 0.1.0 → 0.1.15

package/src/commands/import.ts

@@ -1,184 +0,0 @@
-import { importFromGitHub } from '@gitpm/sync-github';
-import type { LinkStrategy } from '@gitpm/sync-github';
-import { importFromGitLab } from '@gitpm/sync-gitlab';
-import type { LinkStrategy as GitLabLinkStrategy } from '@gitpm/sync-gitlab';
-import chalk from 'chalk';
-import { Command } from 'commander';
-import ora from 'ora';
-import { resolveToken } from '../utils/auth.js';
-import { resolveMetaDir } from '../utils/config.js';
-import { printError, printSuccess } from '../utils/output.js';
-
-const VALID_LINK_STRATEGIES = [
-  'body-refs',
-  'sub-issues',
-  'milestone',
-  'labels',
-  'all',
-] as const;
-
-const VALID_GITLAB_LINK_STRATEGIES = [
-  'body-refs',
-  'native-epics',
-  'milestone',
-  'labels',
-  'all',
-] as const;
-
-export const importCommand = new Command('import')
-  .description('Import project data from GitHub or GitLab into .meta/')
-  .option(
-    '--source <source>',
-    'Source platform: github or gitlab (default: github)',
-    'github',
-  )
-  .option('--repo <owner/repo>', 'GitHub repository (owner/repo)')
-  .option(
-    '--project <value>',
-    'GitHub Project number or GitLab project path (namespace/project)',
-  )
-  .option('--token <token>', 'Personal access token')
-  .option('--base-url <url>', 'GitLab base URL (default: https://gitlab.com)')
-  .option(
-    '--link-strategy <strategy>',
-    'Epic-story linkage strategy (default: all)',
-  )
-  .action(async (opts, cmd) => {
-    const metaDir = resolveMetaDir(cmd.optsWithGlobals().metaDir);
-    const source: string = opts.source;
-
-    if (source === 'gitlab') {
-      await importGitLab(opts, metaDir);
-    } else if (source === 'github') {
-      await importGitHub(opts, metaDir);
-    } else {
-      printError(`Unknown source "${source}". Use "github" or "gitlab".`);
-      process.exit(1);
-    }
-  });
-
-async function importGitHub(
-  opts: Record<string, string | undefined>,
-  metaDir: string,
-): Promise<void> {
-  const repo = opts.repo;
-  if (!repo || !repo.includes('/') || repo.split('/').length !== 2) {
-    printError('--repo is required for GitHub import. Expected "owner/repo".');
-    process.exit(1);
-  }
-
-  let token: string;
-  try {
-    token = await resolveToken(opts.token);
-  } catch (err) {
-    printError(err instanceof Error ? err.message : 'Failed to resolve token.');
-    process.exit(1);
-  }
-
-  const linkStrategy: LinkStrategy | undefined = opts.linkStrategy as
-    | LinkStrategy
-    | undefined;
-  if (
-    linkStrategy &&
-    !VALID_LINK_STRATEGIES.includes(
-      linkStrategy as (typeof VALID_LINK_STRATEGIES)[number],
-    )
-  ) {
-    printError(
-      `Invalid link strategy "${linkStrategy}". Must be one of: ${VALID_LINK_STRATEGIES.join(', ')}`,
-    );
-    process.exit(1);
-  }
-
-  const spinner = ora('Importing from GitHub...').start();
-
-  const result = await importFromGitHub({
-    token,
-    repo,
-    projectNumber: opts.project ? Number.parseInt(opts.project, 10) : undefined,
-    metaDir,
-    linkStrategy,
-  });
-
-  if (!result.ok) {
-    spinner.fail('Import failed.');
-    printError(result.error.message);
-    process.exit(1);
-  }
-
-  spinner.succeed('Import complete.');
-  printImportSummary(result.value);
-}
-
-async function importGitLab(
-  opts: Record<string, string | undefined>,
-  metaDir: string,
-): Promise<void> {
-  const project = opts.project ?? opts.repo;
-  if (!project) {
-    printError('--project (namespace/project) is required for GitLab import.');
-    process.exit(1);
-  }
-
-  const token = opts.token ?? process.env.GITLAB_TOKEN;
-  if (!token) {
-    printError(
-      'No GitLab token found. Provide via --token flag or GITLAB_TOKEN env var.',
-    );
-    process.exit(1);
-  }
-
-  const linkStrategy: GitLabLinkStrategy | undefined = opts.linkStrategy as
-    | GitLabLinkStrategy
-    | undefined;
-  if (
-    linkStrategy &&
-    !VALID_GITLAB_LINK_STRATEGIES.includes(
-      linkStrategy as (typeof VALID_GITLAB_LINK_STRATEGIES)[number],
-    )
-  ) {
-    printError(
-      `Invalid link strategy "${linkStrategy}". Must be one of: ${VALID_GITLAB_LINK_STRATEGIES.join(', ')}`,
-    );
-    process.exit(1);
-  }
-
-  const spinner = ora('Importing from GitLab...').start();
-
-  const result = await importFromGitLab({
-    token,
-    project,
-    baseUrl: opts.baseUrl,
-    metaDir,
-    linkStrategy,
-  });
-
-  if (!result.ok) {
-    spinner.fail('Import failed.');
-    printError(result.error.message);
-    process.exit(1);
-  }
-
-  spinner.succeed('Import complete.');
-  printImportSummary(result.value);
-}
-
-function printImportSummary(value: {
-  milestones: number;
-  epics: number;
-  stories: number;
-  totalFiles: number;
-}): void {
-  const { milestones, epics, stories, totalFiles } = value;
-  console.log();
-  console.log(chalk.bold('Summary:'));
-  console.log(`  Milestones: ${milestones}`);
-  console.log(`  Epics:      ${epics}`);
-  console.log(`  Stories:    ${stories}`);
-  console.log(`  Files:      ${totalFiles}`);
-  console.log();
-  printSuccess(
-    `Imported ${milestones + epics + stories} entities (${totalFiles} files).`,
-  );
-  console.log(chalk.dim('Run `gitpm validate` to verify the imported tree.'));
-}

package/src/commands/init.ts

@@ -1,62 +0,0 @@
-import { readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { scaffoldMeta } from '@gitpm/core';
-import { input } from '@inquirer/prompts';
-import chalk from 'chalk';
-import { Command } from 'commander';
-import { resolveMetaDir } from '../utils/config.js';
-import { printError, printSuccess } from '../utils/output.js';
-
-async function collectFiles(dir: string, prefix = ''): Promise<string[]> {
-  const entries = await readdir(dir, { withFileTypes: true });
-  const results: string[] = [];
-  for (const entry of entries) {
-    const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
-    if (entry.isDirectory()) {
-      results.push(rel);
-      const children = await collectFiles(join(dir, entry.name), rel);
-      results.push(...children);
-    } else {
-      results.push(rel);
-    }
-  }
-  return results;
-}
-
-export const initCommand = new Command('init')
-  .description('Initialize a new .meta/ project structure')
-  .argument('[project-name]', 'Name of the project')
-  .action(async (nameArg: string | undefined, _opts, cmd) => {
-    const metaDir = resolveMetaDir(cmd.optsWithGlobals().metaDir);
-
-    let projectName = nameArg;
-    if (!projectName) {
-      projectName = await input({
-        message: 'Project name:',
-        required: true,
-      });
-    }
-
-    const result = await scaffoldMeta(metaDir, projectName);
-
-    if (!result.ok) {
-      printError(result.error.message);
-      process.exit(1);
-    }
-
-    // Print created file tree
-    const files = await collectFiles(metaDir);
-    console.log();
-    console.log(chalk.bold('.meta/'));
-    for (const file of files) {
-      const parts = file.split('/');
-      const indent = '  '.repeat(parts.length);
-      const name = parts[parts.length - 1];
-      const isDir = !name.includes('.');
-      console.log(`${indent}${isDir ? chalk.blue(`${name}/`) : name}`);
-    }
-
-    const fileCount = files.filter((f) => f.includes('.')).length;
-    console.log();
-    printSuccess(`Created ${fileCount} files in .meta/`);
-  });

package/src/commands/pull.ts

@@ -1,145 +0,0 @@
-import {
-  loadConfig as loadGitHubConfig,
-  syncWithGitHub,
-} from '@gitpm/sync-github';
-import type { ConflictStrategy } from '@gitpm/sync-github';
-import {
-  loadConfig as loadGitLabConfig,
-  syncWithGitLab,
-} from '@gitpm/sync-gitlab';
-import chalk from 'chalk';
-import { Command } from 'commander';
-import ora from 'ora';
-import { resolveToken } from '../utils/auth.js';
-import { resolveMetaDir } from '../utils/config.js';
-import { promptConflictResolution } from '../utils/conflict-ui.js';
-import { printError, printSuccess } from '../utils/output.js';
-
-export const pullCommand = new Command('pull')
-  .description('Pull changes from GitHub or GitLab into local .meta/')
-  .option('--token <token>', 'Personal access token')
-  .option(
-    '--strategy <strategy>',
-    'Conflict resolution strategy (local-wins, remote-wins, ask)',
-    'remote-wins',
-  )
-  .action(async (opts, cmd) => {
-    const metaDir = resolveMetaDir(cmd.optsWithGlobals().metaDir);
-    const strategy = opts.strategy as ConflictStrategy;
-
-    // Detect platform
-    const ghConfig = await loadGitHubConfig(metaDir);
-    const glConfig = await loadGitLabConfig(metaDir);
-
-    if (glConfig.ok) {
-      await pullFromGitLab(opts, metaDir, glConfig.value, strategy);
-    } else if (ghConfig.ok) {
-      await pullFromGitHub(opts, metaDir, ghConfig.value.repo, strategy);
-    } else {
-      printError(
-        'No sync config found. Run `gitpm import` first to set up sync.',
-      );
-      process.exit(1);
-    }
-  });
-
-async function pullFromGitHub(
-  opts: Record<string, string | undefined>,
-  metaDir: string,
-  repo: string,
-  strategy: ConflictStrategy,
-): Promise<void> {
-  let token: string;
-  try {
-    token = await resolveToken(opts.token);
-  } catch (err) {
-    printError(err instanceof Error ? err.message : 'Failed to resolve token.');
-    process.exit(1);
-  }
-
-  const spinner = ora('Pulling from GitHub...').start();
-  const result = await syncWithGitHub({
-    token,
-    repo,
-    metaDir,
-    strategy: strategy === 'ask' ? 'ask' : strategy,
-  });
-
-  if (!result.ok) {
-    spinner.fail('Pull failed.');
-    printError(result.error.message);
-    process.exit(1);
-  }
-
-  spinner.succeed('Pull complete.');
-  await handleConflictsAndPrint(result.value, strategy);
-}
-
-async function pullFromGitLab(
-  opts: Record<string, string | undefined>,
-  metaDir: string,
-  config: { project: string; project_id: number; base_url: string },
-  strategy: ConflictStrategy,
-): Promise<void> {
-  const token = opts.token ?? process.env.GITLAB_TOKEN;
-  if (!token) {
-    printError(
-      'No GitLab token found. Provide via --token flag or GITLAB_TOKEN env var.',
-    );
-    process.exit(1);
-  }
-
-  const spinner = ora('Pulling from GitLab...').start();
-  const result = await syncWithGitLab({
-    token,
-    project: config.project,
-    projectId: config.project_id,
-    baseUrl: config.base_url,
-    metaDir,
-    strategy: strategy === 'ask' ? 'ask' : strategy,
-  });
-
-  if (!result.ok) {
-    spinner.fail('Pull failed.');
-    printError(result.error.message);
-    process.exit(1);
-  }
-
-  spinner.succeed('Pull complete.');
-  await handleConflictsAndPrint(result.value, strategy);
-}
-
-async function handleConflictsAndPrint(
-  result: {
-    pulled: { milestones: number; issues: number };
-    conflicts: unknown[];
-    resolved: number;
-    skipped: number;
-  },
-  strategy: ConflictStrategy,
-): Promise<void> {
-  const { pulled, conflicts, resolved, skipped } = result;
-
-  if (strategy === 'ask' && conflicts.length > 0) {
-    console.log();
-    console.log(
-      chalk.yellow(`${conflicts.length} conflict(s) require resolution:`),
-    );
-    const resolutions = await promptConflictResolution(
-      conflicts as Parameters<typeof promptConflictResolution>[0],
-    );
-    console.log(
-      chalk.dim(
-        `Resolved ${resolutions.length}, skipped ${conflicts.length - resolutions.length}`,
-      ),
-    );
-  }
-
-  console.log();
-  console.log(chalk.bold('Pull Summary:'));
-  console.log(`  Pulled: ${pulled.milestones + pulled.issues} changes`);
-  console.log(`  Conflicts resolved: ${resolved}`);
-  console.log(`  Skipped: ${skipped}`);
-  console.log();
-  printSuccess('Pull complete.');
-}

package/src/commands/push.ts

@@ -1,224 +0,0 @@
-import {
-  exportToGitHub,
-  loadConfig as loadGitHubConfig,
-} from '@gitpm/sync-github';
-import {
-  exportToGitLab,
-  loadConfig as loadGitLabConfig,
-} from '@gitpm/sync-gitlab';
-import { confirm } from '@inquirer/prompts';
-import chalk from 'chalk';
-import { Command } from 'commander';
-import ora from 'ora';
-import { resolveToken } from '../utils/auth.js';
-import { resolveMetaDir } from '../utils/config.js';
-import { printError, printSuccess } from '../utils/output.js';
-
-export const pushCommand = new Command('push')
-  .description('Push local .meta/ changes to GitHub or GitLab')
-  .option('--token <token>', 'Personal access token')
-  .option('--dry-run', 'Preview changes without pushing')
-  .option('--yes', 'Skip confirmation prompt')
-  .action(async (opts, cmd) => {
-    const metaDir = resolveMetaDir(cmd.optsWithGlobals().metaDir);
-
-    // Detect which platform config exists
-    const ghConfig = await loadGitHubConfig(metaDir);
-    const glConfig = await loadGitLabConfig(metaDir);
-
-    if (glConfig.ok) {
-      await pushToGitLab(opts, metaDir, glConfig.value);
-    } else if (ghConfig.ok) {
-      await pushToGitHub(opts, metaDir, ghConfig.value.repo);
-    } else {
-      printError(
-        'No sync config found. Run `gitpm import` first to set up sync.',
-      );
-      process.exit(1);
-    }
-  });
-
-async function pushToGitHub(
-  opts: Record<string, string | boolean | undefined>,
-  metaDir: string,
-  repo: string,
-): Promise<void> {
-  let token: string;
-  try {
-    token = await resolveToken(opts.token as string | undefined);
-  } catch (err) {
-    printError(err instanceof Error ? err.message : 'Failed to resolve token.');
-    process.exit(1);
-  }
-
-  if (opts.dryRun) {
-    const spinner = ora('Calculating changes...').start();
-    const result = await exportToGitHub({ token, repo, metaDir, dryRun: true });
-
-    if (!result.ok) {
-      spinner.fail('Dry run failed.');
-      printError(result.error.message);
-      process.exit(1);
-    }
-
-    spinner.succeed('Dry run complete.');
-    printPreview(result.value);
-    return;
-  }
-
-  const previewSpinner = ora('Calculating changes...').start();
-  const preview = await exportToGitHub({
-    token,
-    repo,
-    metaDir,
-    dryRun: true,
-  });
-
-  if (!preview.ok) {
-    previewSpinner.fail('Failed to calculate changes.');
-    printError(preview.error.message);
-    process.exit(1);
-  }
-
-  previewSpinner.succeed('Changes calculated.');
-  printPreview(preview.value);
-
-  if (preview.value.totalChanges === 0) {
-    printSuccess('Nothing to push — already in sync.');
-    return;
-  }
-
-  if (!opts.yes) {
-    const confirmed = await confirm({
-      message: 'Push these changes to GitHub?',
-      default: false,
-    });
-    if (!confirmed) {
-      console.log(chalk.dim('Push cancelled.'));
-      return;
-    }
-  }
-
-  const pushSpinner = ora('Pushing to GitHub...').start();
-  const result = await exportToGitHub({ token, repo, metaDir, dryRun: false });
-
-  if (!result.ok) {
-    pushSpinner.fail('Push failed.');
-    printError(result.error.message);
-    process.exit(1);
-  }
-
-  pushSpinner.succeed('Push complete.');
-  const { created, updated } = result.value;
-  console.log(
-    `  Created ${created.milestones + created.issues}, Updated ${updated.milestones + updated.issues}`,
-  );
-}
-
-async function pushToGitLab(
-  opts: Record<string, string | boolean | undefined>,
-  metaDir: string,
-  config: { project: string; project_id: number; base_url: string },
-): Promise<void> {
-  const token = (opts.token as string | undefined) ?? process.env.GITLAB_TOKEN;
-  if (!token) {
-    printError(
-      'No GitLab token found. Provide via --token flag or GITLAB_TOKEN env var.',
-    );
-    process.exit(1);
-  }
-
-  if (opts.dryRun) {
-    const spinner = ora('Calculating changes...').start();
-    const result = await exportToGitLab({
-      token,
-      project: config.project,
-      projectId: config.project_id,
-      baseUrl: config.base_url,
-      metaDir,
-      dryRun: true,
-    });
-
-    if (!result.ok) {
-      spinner.fail('Dry run failed.');
-      printError(result.error.message);
-      process.exit(1);
-    }
-
-    spinner.succeed('Dry run complete.');
-    printPreview(result.value);
-    return;
-  }
-
-  const previewSpinner = ora('Calculating changes...').start();
-  const preview = await exportToGitLab({
-    token,
-    project: config.project,
-    projectId: config.project_id,
-    baseUrl: config.base_url,
-    metaDir,
-    dryRun: true,
-  });
-
-  if (!preview.ok) {
-    previewSpinner.fail('Failed to calculate changes.');
-    printError(preview.error.message);
-    process.exit(1);
-  }
-
-  previewSpinner.succeed('Changes calculated.');
-  printPreview(preview.value);
-
-  if (preview.value.totalChanges === 0) {
-    printSuccess('Nothing to push — already in sync.');
-    return;
-  }
-
-  if (!opts.yes) {
-    const confirmed = await confirm({
-      message: 'Push these changes to GitLab?',
-      default: false,
-    });
-    if (!confirmed) {
-      console.log(chalk.dim('Push cancelled.'));
-      return;
-    }
-  }
-
-  const pushSpinner = ora('Pushing to GitLab...').start();
-  const result = await exportToGitLab({
-    token,
-    project: config.project,
-    projectId: config.project_id,
-    baseUrl: config.base_url,
-    metaDir,
-    dryRun: false,
-  });
-
-  if (!result.ok) {
-    pushSpinner.fail('Push failed.');
-    printError(result.error.message);
-    process.exit(1);
-  }
-
-  pushSpinner.succeed('Push complete.');
-  const { created, updated } = result.value;
-  console.log(
-    `  Created ${created.milestones + created.issues}, Updated ${updated.milestones + updated.issues}`,
-  );
-}
-
-function printPreview(result: {
-  created: { milestones: number; issues: number };
-  updated: { milestones: number; issues: number };
-  totalChanges: number;
-}): void {
-  console.log();
-  console.log(chalk.bold('Changes to push:'));
-  console.log(`  New milestones: ${result.created.milestones}`);
-  console.log(`  New issues:     ${result.created.issues}`);
-  console.log(`  Updated milestones: ${result.updated.milestones}`);
-  console.log(`  Updated issues:     ${result.updated.issues}`);
-  console.log(`  Total changes:  ${result.totalChanges}`);
-  console.log();
-}