@n-dx/core 0.1.0

package/packages/sourcevision/dist/cli/commands/workspace.js

@@ -0,0 +1,139 @@
+/**
+ * CLI command: sourcevision workspace
+ *
+ * Aggregates multiple pre-analyzed repos into a unified .sourcevision/ output.
+ *
+ * Usage:
+ *   sourcevision workspace [dir]              — aggregate from config
+ *   sourcevision workspace --add <dir> [root]  — add a member
+ *   sourcevision workspace --remove <dir> [root] — remove a member
+ *   sourcevision workspace --status [root]     — show member status
+ */
+import { resolve, basename } from "node:path";
+import { info } from "../output.js";
+import { CLIError } from "../errors.js";
+import { loadWorkspaceConfig, saveWorkspaceConfig, resolveMembers, writeWorkspaceOutput, getWorkspaceStatus, } from "../../analyzers/workspace-aggregate.js";
+import { toPosix } from "../../util/paths.js";
+export function parseWorkspaceFlags(args) {
+    const flags = { add: [], remove: [], status: false };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--add" && i + 1 < args.length) {
+            flags.add.push(args[++i]);
+        }
+        else if (arg.startsWith("--add=")) {
+            flags.add.push(arg.slice("--add=".length));
+        }
+        else if (arg === "--remove" && i + 1 < args.length) {
+            flags.remove.push(args[++i]);
+        }
+        else if (arg.startsWith("--remove=")) {
+            flags.remove.push(arg.slice("--remove=".length));
+        }
+        else if (arg === "--status") {
+            flags.status = true;
+        }
+    }
+    return flags;
+}
+// ── Add member ──────────────────────────────────────────────────────────────
+function addMembers(rootDir, paths) {
+    const config = loadWorkspaceConfig(rootDir) ?? { members: [] };
+    for (const rawPath of paths) {
+        const memberPath = toPosix(rawPath).replace(/\/$/, "");
+        const name = basename(memberPath);
+        // Check for duplicates
+        const existing = config.members.find((m) => toPosix(m.path) === memberPath || (m.name ?? basename(m.path)) === name);
+        if (existing) {
+            info(`Member "${memberPath}" already configured.`);
+            continue;
+        }
+        const member = { path: memberPath };
+        // Only set name explicitly if it differs from directory basename
+        if (name !== basename(memberPath)) {
+            member.name = name;
+        }
+        config.members.push(member);
+        info(`Added workspace member: ${memberPath}`);
+    }
+    saveWorkspaceConfig(rootDir, config);
+}
+// ── Remove member ───────────────────────────────────────────────────────────
+function removeMembers(rootDir, paths) {
+    const config = loadWorkspaceConfig(rootDir);
+    if (!config) {
+        throw new CLIError("No workspace configuration found.", "Run 'sourcevision workspace --add <dir>' to create one.");
+    }
+    for (const rawPath of paths) {
+        const memberPath = toPosix(rawPath).replace(/\/$/, "");
+        const idx = config.members.findIndex((m) => toPosix(m.path) === memberPath || (m.name ?? basename(m.path)) === basename(memberPath));
+        if (idx === -1) {
+            info(`Member "${memberPath}" not found in workspace configuration.`);
+            continue;
+        }
+        const removed = config.members.splice(idx, 1)[0];
+        info(`Removed workspace member: ${removed.path}`);
+    }
+    saveWorkspaceConfig(rootDir, config);
+}
+// ── Status ──────────────────────────────────────────────────────────────────
+function showStatus(rootDir) {
+    const config = loadWorkspaceConfig(rootDir);
+    if (!config || config.members.length === 0) {
+        info("No workspace members configured.");
+        info("Use 'sourcevision workspace --add <dir>' to add members.");
+        return;
+    }
+    const statuses = getWorkspaceStatus(rootDir, config);
+    info(`Workspace: ${statuses.length} member(s)\n`);
+    for (const s of statuses) {
+        const status = s.analyzed ? "✓ analyzed" : "✗ not analyzed";
+        const details = [];
+        if (s.analyzedAt)
+            details.push(`at ${s.analyzedAt}`);
+        if (s.zoneCount != null)
+            details.push(`${s.zoneCount} zones`);
+        if (s.fileCount != null)
+            details.push(`${s.fileCount} files`);
+        const detailStr = details.length > 0 ? ` (${details.join(", ")})` : "";
+        info(`  ${s.name} [${s.path}] — ${status}${detailStr}`);
+    }
+}
+// ── Aggregate (default) ─────────────────────────────────────────────────────
+function runAggregate(rootDir) {
+    const resolved = resolveMembers(rootDir);
+    if (!resolved) {
+        throw new CLIError("No workspace members found.", "Add members with 'sourcevision workspace --add <dir>' or ensure subdirectories have .sourcevision/ analyses.");
+    }
+    const { members, source } = resolved;
+    info(`Workspace aggregation (${source === "config" ? "from config" : "auto-detected"})`);
+    info(`Members: ${members.map((m) => m.prefix).join(", ")}`);
+    info("");
+    const result = writeWorkspaceOutput(rootDir, members);
+    info(`Aggregated ${result.fileCount} files across ${result.zoneCount} zones`);
+    if (result.crossingCount > 0) {
+        info(`Cross-zone crossings: ${result.crossingCount}`);
+    }
+    info("");
+    info("Done.");
+}
+// ── Entry point ─────────────────────────────────────────────────────────────
+export function cmdWorkspace(targetDir, extraArgs) {
+    const absDir = resolve(targetDir);
+    const flags = parseWorkspaceFlags(extraArgs);
+    if (flags.add.length > 0) {
+        addMembers(absDir, flags.add);
+        return;
+    }
+    if (flags.remove.length > 0) {
+        removeMembers(absDir, flags.remove);
+        return;
+    }
+    if (flags.status) {
+        showStatus(absDir);
+        return;
+    }
+    // Default: run aggregation
+    runAggregate(absDir);
+}
+//# sourceMappingURL=workspace.js.map

package/packages/sourcevision/dist/cli/commands/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/cli/commands/workspace.ts"],"names":[],"mappings":"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"}

package/packages/sourcevision/dist/cli/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLI error handling — user-friendly errors with optional suggestions.
+ *
+ * Sourcevision's CLIError extends the foundation CLIError from @n-dx/llm-client,
+ * providing a consistent error hierarchy across all n-dx packages.
+ */
+import { CLIError as BaseCLIError } from "@n-dx/llm-client";
+/**
+ * Sourcevision CLI error — extends the foundation CLIError.
+ *
+ * Inherits from {@link BaseCLIError} (which extends ClaudeClientError),
+ * so `instanceof ClaudeClientError` checks work across the entire error hierarchy.
+ */
+export declare class CLIError extends BaseCLIError {
+    constructor(message: string, suggestion?: string);
+}
+/**
+ * Format an error for CLI output. Returns lines to print to stderr.
+ * Never includes stack traces in the output.
+ */
+export declare function formatCLIError(err: unknown): string;
+/**
+ * Handle a CLI error: print it and exit.
+ * Drop-in replacement for catch blocks in CLI entry points.
+ */
+export declare function handleCLIError(err: unknown): never;
+/**
+ * Check that .sourcevision/ exists in the given directory.
+ * Throws a CLIError with an init suggestion if missing.
+ */
+export declare function requireSvDir(dir: string): void;

package/packages/sourcevision/dist/cli/errors.js

@@ -0,0 +1,100 @@
+/**
+ * CLI error handling — user-friendly errors with optional suggestions.
+ *
+ * Sourcevision's CLIError extends the foundation CLIError from @n-dx/llm-client,
+ * providing a consistent error hierarchy across all n-dx packages.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { CLIError as BaseCLIError } from "@n-dx/llm-client";
+import { SV_DIR } from "./commands/constants.js";
+/**
+ * Sourcevision CLI error — extends the foundation CLIError.
+ *
+ * Inherits from {@link BaseCLIError} (which extends ClaudeClientError),
+ * so `instanceof ClaudeClientError` checks work across the entire error hierarchy.
+ */
+export class CLIError extends BaseCLIError {
+    constructor(message, suggestion) {
+        super(message, suggestion);
+        this.name = "CLIError";
+    }
+}
+/**
+ * Known error patterns mapped to user-friendly messages and suggestions.
+ * Each entry: [regex to match, user-friendly message, suggestion].
+ */
+const ERROR_HINTS = [
+    [
+        /ENOENT.*\.sourcevision/,
+        "Sourcevision directory not found.",
+        "Run 'n-dx init' or 'sourcevision init' to set up analysis.",
+    ],
+    [
+        /ENOENT.*manifest\.json/,
+        "Sourcevision manifest not found.",
+        "Run 'sourcevision analyze' to generate analysis output.",
+    ],
+    [
+        /EACCES/,
+        "Permission denied.",
+        "Check file permissions for the .sourcevision/ directory.",
+    ],
+    [
+        /Unexpected token/,
+        "Failed to parse JSON file.",
+        "Check for syntax errors in the file, or run 'sourcevision reset' to start fresh.",
+    ],
+    [
+        /Directory not found/,
+        "", // Use original message
+        "Check the path and try again.",
+    ],
+    [
+        /ENOENT/,
+        "File or directory not found.",
+        "Check the path and try again.",
+    ],
+];
+/**
+ * Format an error for CLI output. Returns lines to print to stderr.
+ * Never includes stack traces in the output.
+ */
+export function formatCLIError(err) {
+    // CLIError — already user-friendly
+    if (err instanceof CLIError) {
+        let msg = `Error: ${err.message}`;
+        if (err.suggestion) {
+            msg += `\nHint: ${err.suggestion}`;
+        }
+        return msg;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    // Check for known patterns
+    for (const [pattern, friendly, suggestion] of ERROR_HINTS) {
+        if (pattern.test(message)) {
+            const displayMsg = friendly || message;
+            return `Error: ${displayMsg}\nHint: ${suggestion}`;
+        }
+    }
+    // Generic fallback — show the message, never the stack
+    return `Error: ${message}`;
+}
+/**
+ * Handle a CLI error: print it and exit.
+ * Drop-in replacement for catch blocks in CLI entry points.
+ */
+export function handleCLIError(err) {
+    console.error(formatCLIError(err));
+    process.exit(1);
+}
+/**
+ * Check that .sourcevision/ exists in the given directory.
+ * Throws a CLIError with an init suggestion if missing.
+ */
+export function requireSvDir(dir) {
+    if (!existsSync(join(dir, SV_DIR))) {
+        throw new CLIError(`Sourcevision directory not found in ${dir}`, "Run 'n-dx init' to set up the project, or 'sourcevision init' if using sourcevision standalone.");
+    }
+}
+//# sourceMappingURL=errors.js.map

package/packages/sourcevision/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IACxC,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,GAAoC;IACnD;QACE,wBAAwB;QACxB,mCAAmC;QACnC,4DAA4D;KAC7D;IACD;QACE,wBAAwB;QACxB,kCAAkC;QAClC,yDAAyD;KAC1D;IACD;QACE,QAAQ;QACR,oBAAoB;QACpB,0DAA0D;KAC3D;IACD;QACE,kBAAkB;QAClB,4BAA4B;QAC5B,kFAAkF;KACnF;IACD;QACE,qBAAqB;QACrB,EAAE,EAAG,uBAAuB;QAC5B,+BAA+B;KAChC;IACD;QACE,QAAQ;QACR,8BAA8B;QAC9B,+BAA+B;KAChC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,mCAAmC;IACnC,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,GAAG,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,GAAG,IAAI,WAAW,GAAG,CAAC,UAAU,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEjE,2BAA2B;IAC3B,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC;QAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,CAAC;YACvC,OAAO,UAAU,UAAU,WAAW,UAAU,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,OAAO,UAAU,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAChB,uCAAuC,GAAG,EAAE,EAC5C,iGAAiG,CAClG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/packages/sourcevision/dist/cli/help.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Command-specific help content for the sourcevision CLI.
+ *
+ * Each command has a dedicated help definition that includes:
+ *   - Synopsis / usage pattern
+ *   - Relevant flags only
+ *   - 2–3 practical examples
+ *
+ * Uses the shared formatHelp() from @n-dx/llm-client for consistent
+ * presentation with semantic color coding across all n-dx packages.
+ *
+ * @module sourcevision/cli/help
+ */
+/**
+ * Get the help text for a command without printing it.
+ * Returns null if the command has no dedicated help.
+ */
+export declare function getCommandHelp(command: string): string | null;
+/**
+ * Show command-specific help. Returns true if help was shown, false if
+ * the command has no dedicated help.
+ */
+export declare function showCommandHelp(command: string): boolean;

package/packages/sourcevision/dist/cli/help.js

@@ -0,0 +1,241 @@
+/**
+ * Command-specific help content for the sourcevision CLI.
+ *
+ * Each command has a dedicated help definition that includes:
+ *   - Synopsis / usage pattern
+ *   - Relevant flags only
+ *   - 2–3 practical examples
+ *
+ * Uses the shared formatHelp() from @n-dx/llm-client for consistent
+ * presentation with semantic color coding across all n-dx packages.
+ *
+ * @module sourcevision/cli/help
+ */
+import { formatHelp } from "@n-dx/llm-client";
+/** Map of command name → help definition. */
+const COMMAND_DEFS = {
+    init: {
+        tool: "sourcevision",
+        command: "init",
+        summary: "set up .sourcevision/ directory",
+        usage: "sourcevision init [dir]",
+        description: "Creates .sourcevision/ with a manifest.json in the target directory.\n" +
+            "If .sourcevision/ already exists, reports it and suggests running analyze.",
+        examples: [
+            { command: "sourcevision init", description: "Initialize in current directory" },
+            { command: "sourcevision init ./my-project", description: "Initialize in a specific directory" },
+            { command: "sv init .", description: "Using the 'sv' alias" },
+        ],
+        related: ["analyze"],
+    },
+    analyze: {
+        tool: "sourcevision",
+        command: "analyze",
+        summary: "run the analysis pipeline",
+        usage: "sourcevision analyze [options] [dir]",
+        description: "Runs the full four-phase analysis pipeline: inventory, imports, zone\n" +
+            "detection, and component cataloging. Generates CONTEXT.md, llms.txt,\n" +
+            "and structured JSON data files in .sourcevision/.",
+        sections: [
+            {
+                title: "Phases",
+                content: "1. Inventory    File listing with metadata and classifications\n" +
+                    "2. Imports      Dependency graph and import edges\n" +
+                    "3. Zones        Architectural zone detection (Louvain community detection)\n" +
+                    "4. Components   React component catalog and prop analysis",
+            },
+        ],
+        options: [
+            { flag: "--phase=<N>", description: "Run only phase N (1–4)" },
+            { flag: "--only=<module>", description: "Run only a named module: inventory, imports, zones, components" },
+            { flag: "--fast", description: "Skip AI zone-name enrichment (algorithmic names only)" },
+            { flag: "--full", description: "Run all 4 enrichment passes in sequence" },
+            { flag: "--deep", description: "Re-analyze sub-packages before root analysis" },
+            { flag: "--per-zone", description: "Per-zone enrichment (smaller context, parallelizable)" },
+            { flag: "--quiet, -q", description: "Suppress informational output" },
+        ],
+        examples: [
+            { command: "sourcevision analyze", description: "Full analysis of current directory" },
+            { command: "sourcevision analyze --fast .", description: "Skip AI enrichment for speed" },
+            { command: "sourcevision analyze --phase=1", description: "Run only the inventory phase" },
+            { command: "sv analyze --only=zones .", description: "Re-run zone detection only" },
+        ],
+        related: ["validate", "serve"],
+    },
+    serve: {
+        tool: "sourcevision",
+        command: "serve",
+        summary: "start a local viewer server",
+        usage: "sourcevision serve [options] [dir]",
+        description: "Starts an HTTP server to browse the analysis results interactively.\n" +
+            "Requires .sourcevision/ to exist (run 'sourcevision init' and\n" +
+            "'sourcevision analyze' first).",
+        options: [
+            { flag: "--port=<N>", description: "Server port (default: 3117)" },
+        ],
+        examples: [
+            { command: "sourcevision serve", description: "Start viewer on default port" },
+            { command: "sourcevision serve --port=8080", description: "Start viewer on custom port" },
+            { command: "sv serve .", description: "Using the 'sv' alias" },
+        ],
+        related: ["analyze"],
+    },
+    validate: {
+        tool: "sourcevision",
+        command: "validate",
+        summary: "validate analysis output files",
+        usage: "sourcevision validate [dir]",
+        description: "Checks that .sourcevision/ contains valid manifest.json and data files.\n" +
+            "Useful for CI pipelines to ensure analysis output is consistent.",
+        examples: [
+            { command: "sourcevision validate", description: "Validate current directory" },
+            { command: "sourcevision validate ./project", description: "Validate a specific project" },
+            { command: "sv validate .", description: "Using the 'sv' alias" },
+        ],
+        related: ["analyze"],
+    },
+    reset: {
+        tool: "sourcevision",
+        command: "reset",
+        summary: "remove .sourcevision/ and start fresh",
+        usage: "sourcevision reset [dir]",
+        description: "Deletes the entire .sourcevision/ directory. Use this when you want\n" +
+            "a clean re-analysis or when troubleshooting stale data.",
+        examples: [
+            { command: "sourcevision reset", description: "Reset current directory" },
+            { command: "sourcevision reset ./project", description: "Reset a specific project" },
+            { command: "sv reset .", description: "Using the 'sv' alias" },
+        ],
+        related: ["init"],
+    },
+    "export-pdf": {
+        tool: "sourcevision",
+        command: "export-pdf",
+        summary: "export analysis as PDF report",
+        usage: "sourcevision export-pdf [options] [dir]",
+        description: "Generates a PDF report from the analysis data. Requires .sourcevision/\n" +
+            "to exist with completed analysis.",
+        options: [
+            { flag: "--output=<path>", description: "Output file path (default: .sourcevision/report.pdf)" },
+        ],
+        examples: [
+            { command: "sourcevision export-pdf", description: "Export to default location" },
+            { command: "sourcevision export-pdf --output=report.pdf", description: "Custom output path" },
+            { command: "sv export-pdf .", description: "Using the 'sv' alias" },
+        ],
+        related: ["analyze"],
+    },
+    "pr-markdown": {
+        tool: "sourcevision",
+        command: "pr-markdown",
+        summary: "regenerate pull-request markdown on demand",
+        usage: "sourcevision pr-markdown [dir]",
+        description: "Generates PR-ready markdown from git diff metadata and writes it to\n" +
+            ".sourcevision/pr-markdown.md in the target directory.",
+        sections: [
+            {
+                title: "Output",
+                content: ".sourcevision/pr-markdown.md",
+            },
+        ],
+        examples: [
+            { command: "sourcevision pr-markdown", description: "Regenerate markdown in current directory" },
+            { command: "sourcevision pr-markdown ./project", description: "Regenerate markdown for a specific project" },
+            { command: "sv pr-markdown .", description: "Using the 'sv' alias" },
+        ],
+        related: ["serve", "git-credential-helper"],
+    },
+    "git-credential-helper": {
+        tool: "sourcevision",
+        command: "git-credential-helper",
+        summary: "run interactive GitHub credential setup",
+        usage: "sourcevision git-credential-helper",
+        description: "Checks GitHub CLI auth state (`gh auth status`). If unauthenticated,\n" +
+            "hands off to `gh auth login`. If `gh` is unavailable, shows platform\n" +
+            "credential-manager guidance for git remote operations.",
+        examples: [
+            { command: "sourcevision git-credential-helper", description: "Start interactive GitHub auth setup" },
+        ],
+        related: ["pr-markdown"],
+    },
+    mcp: {
+        tool: "sourcevision",
+        command: "mcp",
+        summary: "start MCP server for AI tool integration",
+        usage: "sourcevision mcp [dir]",
+        description: "Starts a Model Context Protocol (MCP) server over stdio for integration\n" +
+            "with AI coding assistants. Exposes tools for querying the codebase:\n" +
+            "inventory, imports, zones, components, and full context.",
+        examples: [
+            { command: "sourcevision mcp", description: "Start MCP server in current directory" },
+            { command: "sourcevision mcp /path/to/proj", description: "Start MCP server for a specific project" },
+            { command: "sv mcp .", description: "Using the 'sv' alias" },
+        ],
+        related: [],
+    },
+    workspace: {
+        tool: "sourcevision",
+        command: "workspace",
+        summary: "aggregate multiple analyzed repos into a unified view",
+        usage: "sourcevision workspace [options] [dir]",
+        description: "Aggregates pre-analyzed repositories into a unified .sourcevision/ output.\n" +
+            "Each member repo must already have .sourcevision/ from a prior analysis run.\n" +
+            "Members are configured in .n-dx.json or auto-detected from nested\n" +
+            ".sourcevision/ directories.",
+        options: [
+            { flag: "--add <dir>", description: "Add a directory as a workspace member (persists to .n-dx.json)" },
+            { flag: "--remove <dir>", description: "Remove a workspace member" },
+            { flag: "--status", description: "List members with analysis freshness, zone counts, file counts" },
+            { flag: "--quiet, -q", description: "Suppress informational output" },
+        ],
+        examples: [
+            { command: "sourcevision workspace --add packages/api --add packages/web .", description: "Add workspace members" },
+            { command: "sourcevision workspace .", description: "Run workspace aggregation" },
+            { command: "sourcevision workspace --status .", description: "Check member status" },
+            { command: "sv workspace .", description: "Using the 'sv' alias" },
+        ],
+        related: ["analyze", "validate"],
+    },
+};
+/** Related commands for each sourcevision command (shown as "See also"). */
+const RELATED_COMMANDS = {
+    init: ["analyze"],
+    analyze: ["validate", "serve"],
+    serve: ["analyze"],
+    validate: ["analyze"],
+    reset: ["init"],
+    "export-pdf": ["analyze"],
+    "pr-markdown": ["serve", "git-credential-helper"],
+    "git-credential-helper": ["pr-markdown"],
+    mcp: [],
+    workspace: ["analyze", "validate"],
+};
+/**
+ * Get the help text for a command without printing it.
+ * Returns null if the command has no dedicated help.
+ */
+export function getCommandHelp(command) {
+    const def = COMMAND_DEFS[command];
+    if (!def)
+        return null;
+    const related = def.related && def.related.length > 0
+        ? def.related
+        : RELATED_COMMANDS[command];
+    const fullDef = {
+        ...def,
+        related: related && related.length > 0 ? related : undefined,
+    };
+    return formatHelp(fullDef);
+}
+/**
+ * Show command-specific help. Returns true if help was shown, false if
+ * the command has no dedicated help.
+ */
+export function showCommandHelp(command) {
+    const text = getCommandHelp(command);
+    if (!text)
+        return false;
+    console.log(text);
+    return true;
+}
+//# sourceMappingURL=help.js.map

package/packages/sourcevision/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}

package/packages/sourcevision/dist/cli/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Sourcevision CLI
+ *
+ * Commands:
+ *   init               - Initialize .sourcevision/ in current project
+ *   analyze [dir]      - Run analysis pipeline
+ *   serve [dir]        - Start local viewer server
+ *   validate [dir]     - Validate .sourcevision/ output files
+ *   export-pdf [dir]   - Export analysis as a PDF report
+ *   pr-markdown [dir]  - Regenerate PR markdown in .sourcevision/
+ *   git-credential-helper - Interactive GitHub credential setup helper
+ *   mcp [dir]          - Start MCP server for AI tool integration
+ */
+export {};