test: add CLI help output snapshot tests

Add snapshot tests for CLI help output per Testing spec requirement:
- Main help output snapshot
- Upload, login, config, mcp command help snapshots
- Version output format validation

Also fixes:
- Remove duplicate shebang from CLI source (tsup adds it via banner)
- Fix package.json path resolution for bundled CLI

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Addono

src/cli/index.ts

@@ -1,15 +1,16 @@
-#!/usr/bin/env node
-
 /**
  * gh-attach CLI entry point.
  */
 
 import { readFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 import { Command } from "commander";
 
-const pkg = JSON.parse(
-  readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
-);
+// Get package.json from the project root (works in both src and dist)
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgPath = resolve(__dirname, "..", "package.json");
+const pkg = JSON.parse(readFileSync(pkgPath, "utf8")) as { version: string };
 
 const program = new Command();
 

test/integration/cli/__snapshots__/snapshot.test.ts.snap

@@ -0,0 +1,71 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`CLI Help Output Snapshots > should match config command help output 1`] = `
+"Usage: gh-attach config [options] <action> [key] [value]
+
+Manage gh-attach configuration
+
+Arguments:
+  action      Action: list, set, get
+  key         Configuration key
+  value       Configuration value
+
+Options:
+  -h, --help  display help for command"
+`;
+
+exports[`CLI Help Output Snapshots > should match login command help output 1`] = `
+"Usage: gh-attach login [options]
+
+Authenticate with GitHub via browser
+
+Options:
+  --state-path <path>  Path to save session state
+  --status             Check current authentication status
+  -h, --help           display help for command"
+`;
+
+exports[`CLI Help Output Snapshots > should match main help output 1`] = `
+"Usage: gh-attach [options] [command]
+
+Upload images to GitHub issues, PRs, and comments
+
+Options:
+  -V, --version                  output the version number
+  -h, --help                     display help for command
+
+Commands:
+  upload [options] <files...>    Upload an image and get a markdown embed URL
+  login [options]                Authenticate with GitHub via browser
+  config <action> [key] [value]  Manage gh-attach configuration
+  mcp [options]                  Start the MCP server
+  help [command]                 display help for command"
+`;
+
+exports[`CLI Help Output Snapshots > should match mcp command help output 1`] = `
+"Usage: gh-attach mcp [options]
+
+Start the MCP server
+
+Options:
+  --transport <type>  Transport: stdio, http (default: "stdio")
+  --port <number>     Port for HTTP transport (default: "3000")
+  -h, --help          display help for command"
+`;
+
+exports[`CLI Help Output Snapshots > should match upload command help output 1`] = `
+"Usage: gh-attach upload [options] <files...>
+
+Upload an image and get a markdown embed URL
+
+Arguments:
+  files              Image file(s) to upload
+
+Options:
+  --target <ref>     GitHub issue/PR reference (owner/repo#N, #N, or URL)
+  --strategy <name>  Upload strategy to use
+  --format <type>    Output format: markdown, url, json (default: "markdown")
+  --stdin            Read image from stdin
+  --filename <name>  Filename when using --stdin
+  -h, --help         display help for command"
+`;

test/integration/cli/snapshot.test.ts

@@ -0,0 +1,51 @@
+import { describe, it, expect } from "vitest";
+import { execSync } from "child_process";
+import { resolve } from "path";
+
+const CLI_PATH = resolve(import.meta.dirname, "../../../dist/cli.js");
+
+/**
+ * Executes the CLI with given arguments and returns stdout.
+ */
+function runCli(args: string): string {
+  const result = execSync(`node ${CLI_PATH} ${args}`, {
+    encoding: "utf8",
+    cwd: resolve(import.meta.dirname, "../../.."),
+  });
+  return result.trim();
+}
+
+describe("CLI Help Output Snapshots", () => {
+  it("should match main help output", () => {
+    const output = runCli("--help");
+    expect(output).toMatchSnapshot();
+  });
+
+  it("should match upload command help output", () => {
+    const output = runCli("upload --help");
+    expect(output).toMatchSnapshot();
+  });
+
+  it("should match login command help output", () => {
+    const output = runCli("login --help");
+    expect(output).toMatchSnapshot();
+  });
+
+  it("should match config command help output", () => {
+    const output = runCli("config --help");
+    expect(output).toMatchSnapshot();
+  });
+
+  it("should match mcp command help output", () => {
+    const output = runCli("mcp --help");
+    expect(output).toMatchSnapshot();
+  });
+});
+
+describe("CLI Version Output", () => {
+  it("should output version in expected format", () => {
+    const output = runCli("--version");
+    // Version output should be a semver-ish pattern
+    expect(output).toMatch(/^\d+\.\d+\.\d+(-\w+)?$/);
+  });
+});