@gitpm/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,801 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { readFileSync } from "fs";
+import { dirname, join as join2 } from "path";
+import { fileURLToPath } from "url";
+import { Command as Command7 } from "commander";
+
+// src/commands/import.ts
+import { importFromGitHub } from "@gitpm/sync-github";
+import { importFromGitLab } from "@gitpm/sync-gitlab";
+import chalk2 from "chalk";
+import { Command } from "commander";
+import ora from "ora";
+
+// src/utils/auth.ts
+import { execSync } from "child_process";
+async function resolveToken(cliToken) {
+  if (cliToken) return cliToken;
+  const envToken = process.env.GITHUB_TOKEN;
+  if (envToken) return envToken;
+  try {
+    const ghToken = execSync("gh auth token", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    if (ghToken) return ghToken;
+  } catch {
+  }
+  throw new Error(
+    "No GitHub token found. Provide via --token flag, GITHUB_TOKEN env var, or install GitHub CLI (gh) and run 'gh auth login'."
+  );
+}
+
+// src/utils/config.ts
+import { resolve } from "path";
+function resolveMetaDir(metaDirOption) {
+  return resolve(process.cwd(), metaDirOption);
+}
+
+// src/utils/output.ts
+import chalk from "chalk";
+function printSuccess(msg) {
+  console.log(chalk.green(`\u2713 ${msg}`));
+}
+function printError(msg) {
+  console.error(chalk.red(`\u2717 ${msg}`));
+}
+function printWarning(msg) {
+  console.warn(chalk.yellow(`\u26A0 ${msg}`));
+}
+
+// src/commands/import.ts
+var VALID_LINK_STRATEGIES = [
+  "body-refs",
+  "sub-issues",
+  "milestone",
+  "labels",
+  "all"
+];
+var VALID_GITLAB_LINK_STRATEGIES = [
+  "body-refs",
+  "native-epics",
+  "milestone",
+  "labels",
+  "all"
+];
+var 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 = 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, metaDir) {
+  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;
+  try {
+    token = await resolveToken(opts.token);
+  } catch (err) {
+    printError(err instanceof Error ? err.message : "Failed to resolve token.");
+    process.exit(1);
+  }
+  const linkStrategy = opts.linkStrategy;
+  if (linkStrategy && !VALID_LINK_STRATEGIES.includes(
+    linkStrategy
+  )) {
+    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) : void 0,
+    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, metaDir) {
+  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 = opts.linkStrategy;
+  if (linkStrategy && !VALID_GITLAB_LINK_STRATEGIES.includes(
+    linkStrategy
+  )) {
+    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) {
+  const { milestones, epics, stories, totalFiles } = value;
+  console.log();
+  console.log(chalk2.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(chalk2.dim("Run `gitpm validate` to verify the imported tree."));
+}
+
+// src/commands/init.ts
+import { readdir } from "fs/promises";
+import { join } from "path";
+import { scaffoldMeta } from "@gitpm/core";
+import { input } from "@inquirer/prompts";
+import chalk3 from "chalk";
+import { Command as Command2 } from "commander";
+async function collectFiles(dir, prefix = "") {
+  const entries = await readdir(dir, { withFileTypes: true });
+  const results = [];
+  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;
+}
+var initCommand = new Command2("init").description("Initialize a new .meta/ project structure").argument("[project-name]", "Name of the project").action(async (nameArg, _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);
+  }
+  const files = await collectFiles(metaDir);
+  console.log();
+  console.log(chalk3.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 ? chalk3.blue(`${name}/`) : name}`);
+  }
+  const fileCount = files.filter((f) => f.includes(".")).length;
+  console.log();
+  printSuccess(`Created ${fileCount} files in .meta/`);
+});
+
+// src/commands/pull.ts
+import {
+  loadConfig as loadGitHubConfig,
+  syncWithGitHub
+} from "@gitpm/sync-github";
+import {
+  loadConfig as loadGitLabConfig,
+  syncWithGitLab
+} from "@gitpm/sync-gitlab";
+import chalk5 from "chalk";
+import { Command as Command3 } from "commander";
+import ora2 from "ora";
+
+// src/utils/conflict-ui.ts
+import { select } from "@inquirer/prompts";
+import chalk4 from "chalk";
+async function promptConflictResolution(conflicts) {
+  const resolutions = [];
+  for (const conflict of conflicts) {
+    console.log();
+    console.log(chalk4.yellow("\u2501\u2501\u2501 CONFLICT \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(
+      `Entity: ${chalk4.bold(`"${conflict.entityTitle}"`)} (${conflict.entityId})`
+    );
+    console.log(`Type:   ${conflict.entityType}`);
+    console.log(`Field:  ${conflict.field}`);
+    console.log();
+    console.log(`  Local:  ${chalk4.green(String(conflict.localValue))}`);
+    console.log(`  Remote: ${chalk4.blue(String(conflict.remoteValue))}`);
+    console.log(chalk4.yellow("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    const pick = await select({
+      message: "How do you want to resolve this conflict?",
+      choices: [
+        { name: "[l] Keep local", value: "local" },
+        { name: "[r] Keep remote", value: "remote" },
+        { name: "[s] Skip (leave unresolved)", value: "skip" }
+      ]
+    });
+    if (pick !== "skip") {
+      resolutions.push({
+        entityId: conflict.entityId,
+        field: conflict.field,
+        pick
+      });
+    }
+  }
+  return resolutions;
+}
+
+// src/commands/pull.ts
+var pullCommand = new Command3("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;
+  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, metaDir, repo, strategy) {
+  let token;
+  try {
+    token = await resolveToken(opts.token);
+  } catch (err) {
+    printError(err instanceof Error ? err.message : "Failed to resolve token.");
+    process.exit(1);
+  }
+  const spinner = ora2("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, metaDir, config, strategy) {
+  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 = ora2("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, strategy) {
+  const { pulled, conflicts, resolved, skipped } = result;
+  if (strategy === "ask" && conflicts.length > 0) {
+    console.log();
+    console.log(
+      chalk5.yellow(`${conflicts.length} conflict(s) require resolution:`)
+    );
+    const resolutions = await promptConflictResolution(
+      conflicts
+    );
+    console.log(
+      chalk5.dim(
+        `Resolved ${resolutions.length}, skipped ${conflicts.length - resolutions.length}`
+      )
+    );
+  }
+  console.log();
+  console.log(chalk5.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.");
+}
+
+// src/commands/push.ts
+import {
+  exportToGitHub,
+  loadConfig as loadGitHubConfig2
+} from "@gitpm/sync-github";
+import {
+  exportToGitLab,
+  loadConfig as loadGitLabConfig2
+} from "@gitpm/sync-gitlab";
+import { confirm } from "@inquirer/prompts";
+import chalk6 from "chalk";
+import { Command as Command4 } from "commander";
+import ora3 from "ora";
+var pushCommand = new Command4("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);
+  const ghConfig = await loadGitHubConfig2(metaDir);
+  const glConfig = await loadGitLabConfig2(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, metaDir, repo) {
+  let token;
+  try {
+    token = await resolveToken(opts.token);
+  } catch (err) {
+    printError(err instanceof Error ? err.message : "Failed to resolve token.");
+    process.exit(1);
+  }
+  if (opts.dryRun) {
+    const spinner = ora3("Calculating changes...").start();
+    const result2 = await exportToGitHub({ token, repo, metaDir, dryRun: true });
+    if (!result2.ok) {
+      spinner.fail("Dry run failed.");
+      printError(result2.error.message);
+      process.exit(1);
+    }
+    spinner.succeed("Dry run complete.");
+    printPreview(result2.value);
+    return;
+  }
+  const previewSpinner = ora3("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 \u2014 already in sync.");
+    return;
+  }
+  if (!opts.yes) {
+    const confirmed = await confirm({
+      message: "Push these changes to GitHub?",
+      default: false
+    });
+    if (!confirmed) {
+      console.log(chalk6.dim("Push cancelled."));
+      return;
+    }
+  }
+  const pushSpinner = ora3("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, metaDir, config) {
+  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);
+  }
+  if (opts.dryRun) {
+    const spinner = ora3("Calculating changes...").start();
+    const result2 = await exportToGitLab({
+      token,
+      project: config.project,
+      projectId: config.project_id,
+      baseUrl: config.base_url,
+      metaDir,
+      dryRun: true
+    });
+    if (!result2.ok) {
+      spinner.fail("Dry run failed.");
+      printError(result2.error.message);
+      process.exit(1);
+    }
+    spinner.succeed("Dry run complete.");
+    printPreview(result2.value);
+    return;
+  }
+  const previewSpinner = ora3("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 \u2014 already in sync.");
+    return;
+  }
+  if (!opts.yes) {
+    const confirmed = await confirm({
+      message: "Push these changes to GitLab?",
+      default: false
+    });
+    if (!confirmed) {
+      console.log(chalk6.dim("Push cancelled."));
+      return;
+    }
+  }
+  const pushSpinner = ora3("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) {
+  console.log();
+  console.log(chalk6.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();
+}
+
+// src/commands/sync.ts
+import {
+  loadConfig as loadGitHubConfig3,
+  syncWithGitHub as syncWithGitHub2
+} from "@gitpm/sync-github";
+import {
+  loadConfig as loadGitLabConfig3,
+  syncWithGitLab as syncWithGitLab2
+} from "@gitpm/sync-gitlab";
+import { confirm as confirm2 } from "@inquirer/prompts";
+import chalk7 from "chalk";
+import { Command as Command5 } from "commander";
+import ora4 from "ora";
+var syncCommand = new Command5("sync").description("Bidirectional sync between local .meta/ and GitHub/GitLab").option("--token <token>", "Personal access token").option(
+  "--strategy <strategy>",
+  "Conflict resolution strategy (local-wins, remote-wins, ask)",
+  "ask"
+).option("--dry-run", "Preview changes without syncing").option("--yes", "Skip confirmation prompt").action(async (opts, cmd) => {
+  const metaDir = resolveMetaDir(cmd.optsWithGlobals().metaDir);
+  const strategy = opts.strategy;
+  const ghConfig = await loadGitHubConfig3(metaDir);
+  const glConfig = await loadGitLabConfig3(metaDir);
+  if (glConfig.ok) {
+    await syncGitLab(opts, metaDir, glConfig.value, strategy);
+  } else if (ghConfig.ok) {
+    await syncGitHub(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 syncGitHub(opts, metaDir, repo, strategy) {
+  let token;
+  try {
+    token = await resolveToken(opts.token);
+  } catch (err) {
+    printError(err instanceof Error ? err.message : "Failed to resolve token.");
+    process.exit(1);
+  }
+  if (opts.dryRun) {
+    const spinner2 = ora4("Calculating sync changes...").start();
+    const result2 = await syncWithGitHub2({
+      token,
+      repo,
+      metaDir,
+      strategy,
+      dryRun: true
+    });
+    if (!result2.ok) {
+      spinner2.fail("Dry run failed.");
+      printError(result2.error.message);
+      process.exit(1);
+    }
+    spinner2.succeed("Dry run complete.");
+    printSyncSummary(result2.value, "GitHub");
+    return;
+  }
+  if (!opts.yes) {
+    const confirmed = await confirm2({
+      message: "Run bidirectional sync with GitHub?",
+      default: true
+    });
+    if (!confirmed) {
+      console.log(chalk7.dim("Sync cancelled."));
+      return;
+    }
+  }
+  const spinner = ora4("Syncing with GitHub...").start();
+  const result = await syncWithGitHub2({
+    token,
+    repo,
+    metaDir,
+    strategy: strategy === "ask" ? "ask" : strategy
+  });
+  if (!result.ok) {
+    spinner.fail("Sync failed.");
+    printError(result.error.message);
+    process.exit(1);
+  }
+  spinner.succeed("Sync complete.");
+  await handleConflicts(result.value, strategy);
+  printSyncSummary(result.value, "GitHub");
+}
+async function syncGitLab(opts, metaDir, config, strategy) {
+  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);
+  }
+  if (opts.dryRun) {
+    const spinner2 = ora4("Calculating sync changes...").start();
+    const result2 = await syncWithGitLab2({
+      token,
+      project: config.project,
+      projectId: config.project_id,
+      baseUrl: config.base_url,
+      metaDir,
+      strategy,
+      dryRun: true
+    });
+    if (!result2.ok) {
+      spinner2.fail("Dry run failed.");
+      printError(result2.error.message);
+      process.exit(1);
+    }
+    spinner2.succeed("Dry run complete.");
+    printSyncSummary(result2.value, "GitLab");
+    return;
+  }
+  if (!opts.yes) {
+    const confirmed = await confirm2({
+      message: "Run bidirectional sync with GitLab?",
+      default: true
+    });
+    if (!confirmed) {
+      console.log(chalk7.dim("Sync cancelled."));
+      return;
+    }
+  }
+  const spinner = ora4("Syncing with GitLab...").start();
+  const result = await syncWithGitLab2({
+    token,
+    project: config.project,
+    projectId: config.project_id,
+    baseUrl: config.base_url,
+    metaDir,
+    strategy: strategy === "ask" ? "ask" : strategy
+  });
+  if (!result.ok) {
+    spinner.fail("Sync failed.");
+    printError(result.error.message);
+    process.exit(1);
+  }
+  spinner.succeed("Sync complete.");
+  await handleConflicts(result.value, strategy);
+  printSyncSummary(result.value, "GitLab");
+}
+async function handleConflicts(result, strategy) {
+  const { conflicts } = result;
+  if (strategy === "ask" && conflicts.length > 0) {
+    console.log();
+    console.log(
+      chalk7.yellow(`${conflicts.length} conflict(s) require resolution:`)
+    );
+    const resolutions = await promptConflictResolution(
+      conflicts
+    );
+    console.log(
+      chalk7.dim(
+        `Resolved ${resolutions.length}, skipped ${conflicts.length - resolutions.length}`
+      )
+    );
+  }
+}
+function printSyncSummary(result, platform) {
+  const pushedTotal = result.pushed.milestones + result.pushed.issues;
+  const pulledTotal = result.pulled.milestones + result.pulled.issues;
+  console.log();
+  console.log(chalk7.bold("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
+  console.log(chalk7.bold("\u2502           Sync Complete              \u2502"));
+  console.log(chalk7.bold("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524"));
+  console.log(
+    `${chalk7.bold("\u2502")} Pushed to ${platform.padEnd(6)} \u2502 ${String(pushedTotal).padEnd(17)} ${chalk7.bold("\u2502")}`
+  );
+  console.log(
+    `${chalk7.bold("\u2502")} Pulled to local  \u2502 ${String(pulledTotal).padEnd(17)} ${chalk7.bold("\u2502")}`
+  );
+  console.log(
+    `${chalk7.bold("\u2502")} Conflicts        \u2502 ${String(`${result.resolved} resolved`).padEnd(17)} ${chalk7.bold("\u2502")}`
+  );
+  console.log(
+    `${chalk7.bold("\u2502")} Errors           \u2502 ${String(result.skipped).padEnd(17)} ${chalk7.bold("\u2502")}`
+  );
+  console.log(chalk7.bold("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));
+  console.log();
+  printSuccess("Sync complete.");
+}
+
+// src/commands/validate.ts
+import { relative } from "path";
+import { parseTree, resolveRefs, validateTree } from "@gitpm/core";
+import chalk8 from "chalk";
+import { Command as Command6 } from "commander";
+var validateCommand = new Command6("validate").description("Validate the .meta/ project tree").action(async (_opts, cmd) => {
+  const metaDir = resolveMetaDir(cmd.optsWithGlobals().metaDir);
+  const parseResult = await parseTree(metaDir);
+  if (!parseResult.ok) {
+    printError(parseResult.error.message);
+    process.exit(1);
+  }
+  const tree = parseResult.value;
+  if (tree.errors.length > 0) {
+    for (const err of tree.errors) {
+      const rel = relative(process.cwd(), err.filePath);
+      console.log(chalk8.red(`  \u2717 ${rel}: ${err.message}`));
+    }
+  }
+  const resolveResult = resolveRefs(tree);
+  if (!resolveResult.ok) {
+    printError(resolveResult.error.message);
+    process.exit(1);
+  }
+  const result = validateTree(resolveResult.value);
+  for (const err of result.errors) {
+    const rel = err.filePath ? relative(process.cwd(), err.filePath) : "";
+    const location = rel ? `${rel}: ` : "";
+    const id = err.entityId ? `[${err.entityId}] ` : "";
+    console.log(chalk8.red(`  \u2717 ${location}${id}${err.code}: ${err.message}`));
+  }
+  for (const warn of result.warnings) {
+    const rel = warn.filePath ? relative(process.cwd(), warn.filePath) : "";
+    const location = rel ? `${rel}: ` : "";
+    const id = warn.entityId ? `[${warn.entityId}] ` : "";
+    console.log(
+      chalk8.yellow(`  \u26A0 ${location}${id}${warn.code}: ${warn.message}`)
+    );
+  }
+  if (!result.valid) {
+    console.log();
+    printError(
+      `Validation failed with ${result.errors.length} error(s) and ${result.warnings.length} warning(s)`
+    );
+    process.exit(1);
+  }
+  const entityCount = tree.stories.length + tree.epics.length + tree.milestones.length + tree.roadmaps.length + tree.prds.length;
+  if (result.warnings.length > 0) {
+    console.log();
+    printWarning(`${result.warnings.length} warning(s)`);
+  }
+  printSuccess(`.meta/ tree is valid (${entityCount} entities)`);
+});
+
+// src/index.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(
+  readFileSync(join2(__dirname, "..", "package.json"), "utf-8")
+);
+var program = new Command7();
+program.name("gitpm").description("Git-native project management").version(pkg.version).option("--meta-dir <path>", "Path to .meta directory", ".meta").option("--token <token>", "Personal access token (GitHub or GitLab)");
+program.addCommand(initCommand);
+program.addCommand(validateCommand);
+program.addCommand(importCommand);
+program.addCommand(pushCommand);
+program.addCommand(pullCommand);
+program.addCommand(syncCommand);
+program.parse();