feat: report repo-bootcamp version in bootcamp doctor

`bootcamp doctor` diagnoses Node, git, gh, auth, mermaid, and cache, but
never surfaced which version of the tool itself was running — the first thing
you want in a bug report. It now reports the running package version as the
leading info check ("repo-bootcamp: v1.2.3") and exposes it as
`environment.toolVersion` in `--json` output.

Also fixes a stray duplicate `### Added` header in the CHANGELOG Unreleased
section.

Tests: extended doctor unit tests (version info check + JSON toolVersion
field) and added a new doctor E2E spec (none existed) asserting the human
report shows the version and the JSON payload carries environment.toolVersion
and a `version` check.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: Copilot

CHANGELOG.md

@@ -9,8 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-### Added
-
+- `bootcamp doctor` now reports the running `repo-bootcamp` version as the first diagnostic line (and `environment.toolVersion` in `--json` output), so it's easy to include in bug reports.
 - Interactive Q&A mode (`bootcamp ask` and `--interactive`) now supports **slash commands**: `/help` (alias `/?`) shows the command reference, `/files` lists the detected repository files, `/clear` clears the screen, and `/exit` (aliases `/quit`, `exit`, `quit`) ends the session. Unknown slash commands are reported instead of being sent to the assistant. The input classifier and renderers are pure and unit-tested.
 - `bootcamp metrics <repo-url>` command: a standalone, deterministic codebase-metrics report for any repository (local path or remote URL) without invoking the LLM. Surfaces language breakdown, source/test/doc/config composition, average/median file size, test-to-source ratio, size classification, top-level directory distribution, largest-file hotspots, and an **approachability score (0-100 + A–F grade)** with human-readable drivers. Prints a human-readable report by default, supports `--json` for scripting, and offers a CI gate via `--check`/`--min-score` (exits non-zero when approachability is below the threshold). Reuses the same `computeCodebaseMetrics` engine that powers `METRICS.md` — mirroring the existing `bootcamp health` command.
 - Web demo file viewer now has **Copy** and **Download** buttons: copy a generated doc's contents to the clipboard (async Clipboard API with a `document.execCommand` fallback and a timeout guard) or download it as a file, directly from the preview modal.

README.md

@@ -146,7 +146,7 @@ Onboarding Risk: 18/100 (A) 🟢
 | Generated files | 14+ |
 | Test suite | 1,000+ tests |
 | Source files | 51 TypeScript modules |
-| Test files | 76 Vitest files |
+| Test files | 77 Vitest files |
 | Lines of code | 13,381 TypeScript LOC (src/) |
 | Languages supported | 10+ |
 | Generation time | < 60 seconds |

src/doctor.ts

@@ -15,6 +15,7 @@ import { readdir } from "fs/promises";
 import { isMermaidCliAvailable } from "./diagrams.js";
 import { getCacheDir, listCacheEntries } from "./cache.js";
 import { formatBytes } from "./metrics.js";
+import pkg from "../package.json" with { type: "json" };
 
 const execFileAsync = promisify(execFile);
 
@@ -52,6 +53,8 @@ export interface DoctorReport {
 
 /** A pure snapshot of the host environment, consumed by `evaluateDoctor`. */
 export interface EnvironmentSnapshot {
+  /** The running repo-bootcamp package version (from package.json). */
+  toolVersion: string;
   nodeVersion: string;
   platform: string;
   arch: string;
@@ -79,6 +82,15 @@ export function parseNodeMajor(version: string): number {
 export function evaluateDoctor(env: EnvironmentSnapshot): DoctorReport {
   const checks: DoctorCheck[] = [];
 
+  // repo-bootcamp version (info) — surfaced so users can include it in bug reports.
+  checks.push({
+    id: "version",
+    label: "repo-bootcamp",
+    severity: "optional",
+    status: "info",
+    detail: `v${env.toolVersion}`,
+  });
+
   // Node.js (required)
   const major = parseNodeMajor(env.nodeVersion);
   const nodeOk = Number.isFinite(major) && major >= MIN_NODE_MAJOR;
@@ -285,6 +297,7 @@ export async function gatherEnvironment(): Promise<EnvironmentSnapshot> {
   }
 
   return {
+    toolVersion: pkg.version,
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,

test/doctor.test.ts

@@ -14,6 +14,7 @@ import {
 
 function env(overrides: Partial<EnvironmentSnapshot> = {}): EnvironmentSnapshot {
   return {
+    toolVersion: "1.0.0",
     nodeVersion: "v20.11.0",
     platform: "linux",
     arch: "x64",
@@ -51,6 +52,16 @@ describe("evaluateDoctor", () => {
     expect(node?.status).toBe("ok");
   });
 
+  it("reports the running tool version as an info check", () => {
+    const report = evaluateDoctor(env({ toolVersion: "2.3.4" }));
+    const version = report.checks.find((c) => c.id === "version");
+    expect(version).toBeDefined();
+    expect(version?.status).toBe("info");
+    expect(version?.detail).toBe("v2.3.4");
+    // info checks never fail the overall report
+    expect(report.ok).toBe(true);
+  });
+
   it("fails (required) on an old Node version", () => {
     const report = evaluateDoctor(env({ nodeVersion: "v18.19.0" }));
     expect(report.ok).toBe(false);
@@ -165,6 +176,7 @@ describe("runDoctor", () => {
     expect(payload.ok).toBe(true);
     expect(Array.isArray(payload.checks)).toBe(true);
     expect(payload.environment.nodeVersion).toBe("v20.11.0");
+    expect(payload.environment.toolVersion).toBe("1.0.0");
   });
 });
 

test/e2e/doctor-command.e2e.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+
+import { runCli } from "./helpers.js";
+
+describe("doctor command", () => {
+  it("prints a human-readable environment report including the tool version", async () => {
+    const result = await runCli(["doctor"], { NO_COLOR: "1" }, 60_000);
+    // `doctor` exits 0 when required checks pass; in CI Node/git are present.
+    expect(result.stdout).toContain("repo-bootcamp environment check");
+    expect(result.stdout).toMatch(/repo-bootcamp:\s*v\d+\.\d+\.\d+/);
+    expect(result.stdout).toContain("Node.js runtime");
+  }, 60_000);
+
+  it("emits valid JSON with --json including environment.toolVersion", async () => {
+    const result = await runCli(["doctor", "--json"], { NO_COLOR: "1" }, 60_000);
+    const parsed = JSON.parse(result.stdout);
+    expect(typeof parsed.ok).toBe("boolean");
+    expect(Array.isArray(parsed.checks)).toBe(true);
+    expect(parsed.checks.some((c: { id: string }) => c.id === "version")).toBe(true);
+    expect(typeof parsed.environment.toolVersion).toBe("string");
+    expect(parsed.environment.toolVersion).toMatch(/^\d+\.\d+\.\d+/);
+  }, 60_000);
+});