@agentbridge1/cli 0.0.1

package/dist/index.js

@@ -0,0 +1,622 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveInitContext = resolveInitContext;
+exports.resolveCliEntryPath = resolveCliEntryPath;
+exports.main = main;
+const init_1 = require("./init");
+const config_1 = require("./config");
+const use_1 = require("./commands/use");
+const watch_1 = require("./commands/watch");
+const precommit_check_1 = require("./commands/precommit-check");
+const status_1 = require("./commands/status");
+const check_1 = require("./commands/check");
+const start_1 = require("./commands/start");
+const verify_1 = require("./commands/verify");
+const handoff_1 = require("./commands/handoff");
+const accept_1 = require("./commands/accept");
+const version_1 = require("./commands/version");
+const doctor_1 = require("./commands/doctor");
+const done_1 = require("./commands/done");
+const next_1 = require("./commands/next");
+const health_1 = require("./commands/health");
+const identity_1 = require("./commands/identity");
+const memory_1 = require("./commands/memory");
+const session_1 = require("./commands/session");
+const handshake_1 = require("./commands/handshake");
+const connect_1 = require("./commands/connect");
+const setup_mcp_1 = require("./commands/setup-mcp");
+const bug_1 = require("./commands/bug");
+const autopilot_1 = require("./commands/autopilot");
+const attention_1 = require("./commands/attention");
+const recover_1 = require("./commands/recover");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const errors_1 = require("./errors");
+const cli_failure_log_1 = require("./cli-failure-log");
+const session_state_1 = require("./session-state");
+const COMMAND_HELP = {
+    connect: "  agentbridge connect [--project <id>] [--api-key <key>] [--api-base-url <url>] [--agent <id>]\n" +
+        "    Save credentials and verify connection to your AgentBridge project.\n" +
+        "    Credentials can also come from AGENTBRIDGE_PROJECT_ID / AGENTBRIDGE_API_KEY env vars.\n",
+    recover: "  agentbridge recover [--force]\n" +
+        "    Recover project context so AI agents do not start blind.\n" +
+        "    Shows project name, domains, and known context.\n",
+    init: "  agentbridge init [--project <id> --api-key <key> --api-base-url <url>]\n" +
+        "    Recover domains from git history, bootstrap the project, and install the pre-commit hook.\n" +
+        "    Run `agentbridge connect` first to save credentials.\n",
+    use: "  agentbridge use <agent-id>\n" +
+        "    Set the active agent identity used by `watch` and `start`.\n",
+    start: "  agentbridge start [\"intent\"] [\"scope\"]\n" +
+        "  Advanced: agentbridge start --summary \"<summary>\" --scope \"<path-or-glob>\" [--domain <name>] [--agent <id>] [--change-request <cr_id>] [--resume]\n" +
+        "    Start supervised work. Without flags, proposes a smart work contract and asks for confirmation.\n" +
+        "    --resume  Continue the active change request/session instead of creating a new one.\n",
+    watch: "  agentbridge watch [--change-request <cr_id>] [--execution-surface <es_id>] [--allow-dirty] [--daemon] [--once]\n" +
+        "    Product entrypoint: AgentBridge infers coding context and reviews proof/scope risk.\n" +
+        "    --allow-dirty   Skip the pre-existing dirty-files prompt.\n" +
+        "    --daemon        Non-interactive mode: skip all prompts, auto-deny domain crossings.\n" +
+        "    --once          Run one startup/supervision pass and exit.\n",
+    "setup-mcp": "  agentbridge setup-mcp [--editor cursor|windsurf|vscode]\n" +
+        "    Print the MCP server configuration snippet to add to your editor.\n",
+    mcp: "  agentbridge mcp\n" +
+        "    Start the AgentBridge MCP stdio server.\n",
+    status: "  agentbridge status [--repair] [--json]\n    Show current work session status.\n",
+    health: "  agentbridge health [--json]\n    Check project health against server.\n",
+    check: "  agentbridge check [--json]\n    Check whether current work session can be accepted.\n",
+    next: "  agentbridge next [--json]\n    Show the recommended next action.\n",
+    verify: "  agentbridge verify [--json] -- <command>\n" +
+        "    Run a command and verify output meets acceptance criteria.\n",
+    handoff: "  agentbridge handoff [--json] --summary \"<summary>\" [--risks-remaining \"<text>\"]\n" +
+        "    Submit a handoff with proof of work.\n",
+    accept: "  agentbridge accept [--json]\n    Accept the current change request (human reviewer).\n",
+    done: "  agentbridge done [--json]\n    Mark the current work session as done.\n",
+    identity: "  agentbridge identity list\n    List available agent identities for this project.\n",
+    session: "  agentbridge session list [--change-request <cr_id>] [--active] [--json]\n" +
+        "  agentbridge session inspect <work-session-id> [--json]\n" +
+        "  agentbridge session cleanup [--stale] [--dry-run] [--json]\n" +
+        "  agentbridge session abandon [--session <id>] --reason \"<why>\" [--json]\n",
+    handshake: "  agentbridge handshake create --domain <name> --action \"<text>\" --reason \"<text>\" [--cr <id>] [--session <id>]\n" +
+        "  agentbridge handshake acknowledge|resolve|list\n",
+    memory: "  agentbridge memory suggest|apply|reject|defer|revert|intake-escaped-bug [...flags]\n" +
+        "    Manage domain memory packets.\n",
+    version: "  agentbridge version\n    Print CLI version.\n",
+    doctor: "  agentbridge doctor\n    Run config and connectivity diagnostics.\n",
+    "precommit-check": "  agentbridge precommit-check\n    Git pre-commit hook: block commits that violate domain boundaries.\n",
+    bug: "  agentbridge bug report --title \"<text>\" --severity P0|P1|P2|P3 --category <CATEGORY> \\\n" +
+        "    [--found-in dogfood,production,...] --observed \"<text>\" --expected \"<text>\" \\\n" +
+        "    [--project <id>] [--work-session <id>] [--change-request <id>] [--commands a,b] [--files a,b] [--logs \"<text>\"]\n" +
+        "    Create docs/bugs/YYYY-MM-DD-<slug>.md (secrets redacted).\n" +
+        "  agentbridge bug validate --file docs/bugs/<file>.md\n" +
+        "    Enforce P0/P1 close requirements before verified/closed.\n",
+};
+function usage(command, opts) {
+    const exitCode = opts?.exitCode ?? 3;
+    const stream = opts?.stream ?? "stderr";
+    const write = stream === "stdout" ? process.stdout.write.bind(process.stdout) : process.stderr.write.bind(process.stderr);
+    if (command && COMMAND_HELP[command]) {
+        write(`\n${COMMAND_HELP[command]}\n`);
+        process.exit(exitCode);
+    }
+    write([
+        "",
+        "Usage: agentbridge <command> [flags]",
+        "",
+        "Quick start:",
+        "  New repo:",
+        "    agentbridge doctor",
+        "    agentbridge start",
+        "  Existing repo:",
+        "    agentbridge doctor",
+        "    agentbridge recover",
+        "    agentbridge start",
+        "",
+        "Commands:",
+        "  doctor         Check AgentBridge connection and repo readiness",
+        "  recover        Understand an existing repo before agents continue",
+        "  start          Start or attach to supervised agent work",
+        "",
+        "Advanced commands:",
+        "  connect        Save credentials and verify connection to a project",
+        "  init           Recover domain map from git history and bootstrap the project",
+        "  use            Set active agent identity",
+        "  watch          Watch for file changes (advanced/manual)",
+        "  start --summary ... --scope ...  Backward-compatible explicit start mode",
+        "  setup-mcp      Print MCP server config for your editor",
+        "  mcp            Start local MCP stdio server",
+        "  status         Show current session status",
+        "  health         Check project health",
+        "  check          Check acceptance readiness",
+        "  next           Show recommended next action",
+        "  verify         Run command and verify output",
+        "  handoff        Submit a handoff with proof of work",
+        "  accept         Accept a change request (reviewer)",
+        "  done           Mark work session as done",
+        "  identity       Manage agent identities",
+        "  session        Manage work sessions",
+        "  handshake      Domain boundary handshake protocol",
+        "  memory         Domain memory management",
+        "  version        Print version",
+        "  bug            Internal bug report + close validation",
+        "  precommit-check  Git pre-commit hook",
+        "  autopilot      Enable/disable background automation for the current session",
+        "  attention      List and resolve items that need human decision",
+        "",
+        "Run `agentbridge <command> --help` for command-specific usage.",
+        "",
+    ].join("\n"));
+    process.exit(exitCode);
+}
+function parseArgs(argv) {
+    const [command, ...rest] = argv;
+    if (!command)
+        usage();
+    let projectId = "";
+    let apiKey = "";
+    let apiBaseUrl = "";
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < rest.length; i += 1) {
+        const token = rest[i];
+        if (token === "--project") {
+            projectId = rest[i + 1] ?? "";
+            i += 1;
+            continue;
+        }
+        if (token === "--api-key") {
+            apiKey = rest[i + 1] ?? "";
+            i += 1;
+            continue;
+        }
+        if (token === "--api-base-url") {
+            apiBaseUrl = rest[i + 1] ?? "";
+            i += 1;
+            continue;
+        }
+        if (token.startsWith("--")) {
+            if (token === "--") {
+                positional.push(...rest.slice(i + 1));
+                break;
+            }
+            const next = rest[i + 1];
+            if (!next || next.startsWith("--")) {
+                flags[token] = "true";
+            }
+            else {
+                flags[token] = next;
+                i += 1;
+            }
+            continue;
+        }
+        positional.push(token);
+    }
+    return {
+        command,
+        projectId: projectId || undefined,
+        apiKey: apiKey || undefined,
+        apiBaseUrl: apiBaseUrl || undefined,
+        positional,
+        flags,
+    };
+}
+function resolveInitContext(overrides) {
+    const cfg = (0, config_1.readConfig)();
+    const projectId = overrides.projectId ??
+        process.env.AGENTBRIDGE_PROJECT_ID ??
+        cfg.projectId;
+    let apiKeySource = "missing";
+    let apiKey = "";
+    if (overrides.apiKey) {
+        apiKey = overrides.apiKey;
+        apiKeySource = "flag";
+    }
+    else if (process.env.AGENTBRIDGE_API_KEY) {
+        apiKey = process.env.AGENTBRIDGE_API_KEY;
+        apiKeySource = "env";
+    }
+    else if (cfg.apiKey) {
+        apiKey = cfg.apiKey;
+        apiKeySource = "config";
+    }
+    const apiBaseUrl = overrides.apiBaseUrl ??
+        process.env.AGENTBRIDGE_BASE_URL ??
+        cfg.apiBaseUrl ??
+        "https://agentauth-api-production.up.railway.app";
+    if (!projectId) {
+        throw (0, errors_1.catalogCliError)("CONFIG_INCOMPLETE");
+    }
+    if (!apiKey) {
+        throw (0, errors_1.catalogCliError)("CONFIG_INCOMPLETE");
+    }
+    return { projectId, apiKey, apiBaseUrl, apiKeySource };
+}
+function resolveCliEntryPath(argv1 = process.argv[1]) {
+    if (!argv1)
+        return undefined;
+    if (argv1.startsWith("/"))
+        return argv1;
+    try {
+        return (0, node_path_1.resolve)(process.cwd(), argv1);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function main() {
+    const { command, projectId, apiKey, apiBaseUrl, positional, flags } = parseArgs(process.argv.slice(2));
+    if (command === "--help" || command === "help") {
+        usage(undefined, { exitCode: 0, stream: "stdout" });
+    }
+    // --help on any subcommand
+    if (flags["--help"] === "true") {
+        usage(command, { exitCode: 0, stream: "stdout" });
+    }
+    if (command === "connect") {
+        await (0, connect_1.runConnect)({
+            projectId,
+            apiKey,
+            apiBaseUrl,
+            agentId: flags["--agent"],
+        });
+        return;
+    }
+    if (command === "recover") {
+        await (0, recover_1.runRecover)({ force: Boolean(flags["--force"]) });
+        return;
+    }
+    if (command === "setup-mcp") {
+        await (0, setup_mcp_1.runSetupMcp)({ editor: flags["--editor"] });
+        return;
+    }
+    if (command === "mcp") {
+        const repoRoot = (0, node_path_1.resolve)(__dirname, "..", "..");
+        const localMcpEntrypoint = (0, node_path_1.resolve)(repoRoot, "mcp", "agentbridge-mcp.ts");
+        if (!(0, node_fs_1.existsSync)(localMcpEntrypoint)) {
+            process.stderr.write([
+                "",
+                "AgentBridge MCP runtime is unavailable in this installation.",
+                "",
+                "Try:",
+                "  npm install -g @agentbridge/cli",
+                "  agentbridge doctor",
+                "",
+            ].join("\n"));
+            process.exit(2);
+            return;
+        }
+        const child = (0, node_child_process_1.spawnSync)("npx", ["tsx", localMcpEntrypoint], {
+            stdio: "inherit",
+            env: process.env,
+        });
+        if (child.error) {
+            process.stderr.write(`Failed to start MCP server via npx/tsx: ${child.error.message}\n`);
+            process.exit(2);
+            return;
+        }
+        process.exit(child.status ?? 0);
+        return;
+    }
+    if (command === "init") {
+        // If credentials aren't available yet, guide the user to connect first.
+        const cfg = (0, config_1.readConfig)();
+        const resolvedProjectId = projectId ?? process.env.AGENTBRIDGE_PROJECT_ID ?? cfg.projectId;
+        const resolvedApiKey = apiKey ?? process.env.AGENTBRIDGE_API_KEY ?? cfg.apiKey;
+        if (!resolvedProjectId || !resolvedApiKey) {
+            process.stderr.write([
+                "",
+                "Credentials not found. Run this first:",
+                "",
+                "  agentbridge connect --project <project-id> --api-key <key>",
+                "",
+                "Then run `agentbridge init` again.",
+                "",
+                "Get your credentials at https://agentbridge.dev/dashboard",
+                "",
+            ].join("\n"));
+            process.exit(3);
+            return;
+        }
+        await (0, init_1.runInit)(resolveInitContext({
+            projectId,
+            apiKey,
+            apiBaseUrl,
+        }));
+        return;
+    }
+    if (command === "use") {
+        (0, use_1.runUse)(positional[0] ?? "");
+        return;
+    }
+    if (command === "watch") {
+        await (0, watch_1.runWatch)({
+            task: flags["--task"],
+            scope: flags["--scope"],
+            changeRequestId: flags["--change-request"],
+            executionSurfaceId: flags["--execution-surface"],
+            allowDirty: flags["--allow-dirty"] === "true",
+            daemon: flags["--daemon"] === "true",
+            once: flags["--once"] === "true",
+        });
+        return;
+    }
+    if (command === "start") {
+        const summaryFlagProvided = Object.prototype.hasOwnProperty.call(flags, "--summary");
+        const scopeFlagProvided = Object.prototype.hasOwnProperty.call(flags, "--scope");
+        await (0, start_1.runStart)({
+            summary: flags["--summary"],
+            scope: flags["--scope"] ?? positional[1],
+            prompt: positional[0],
+            summaryFlagProvided,
+            scopeFlagProvided,
+            domain: flags["--domain"],
+            agentId: flags["--agent"],
+            changeRequestId: flags["--change-request"],
+            resume: flags["--resume"] === "true",
+        });
+        return;
+    }
+    if (command === "identity") {
+        const sub = positional[0] ?? "";
+        if (sub === "list") {
+            await (0, identity_1.runIdentityList)();
+            return;
+        }
+        process.stderr.write("Usage: agentbridge identity list\n");
+        process.exit(3);
+        return;
+    }
+    if (command === "status") {
+        await (0, status_1.runStatus)({
+            repair: flags["--repair"] === "true",
+            json: flags["--json"] === "true",
+        });
+        return;
+    }
+    if (command === "precommit-check") {
+        (0, precommit_check_1.runPrecommitCheckCommand)();
+        return;
+    }
+    if (command === "check") {
+        await (0, check_1.runCheck)({ json: flags["--json"] === "true" });
+        return;
+    }
+    if (command === "next") {
+        await (0, next_1.runNext)({ json: flags["--json"] === "true" });
+        return;
+    }
+    if (command === "health") {
+        await (0, health_1.runHealth)({ json: flags["--json"] === "true" });
+        return;
+    }
+    if (command === "verify") {
+        await (0, verify_1.runVerify)(positional.join(" "), { json: flags["--json"] === "true" });
+        return;
+    }
+    if (command === "handoff") {
+        const summary = flags["--summary"] ?? "";
+        await (0, handoff_1.runHandoff)({
+            summary,
+            risksRemaining: flags["--risks-remaining"],
+        }, { json: flags["--json"] === "true" });
+        return;
+    }
+    if (command === "accept") {
+        await (0, accept_1.runAccept)({ json: flags["--json"] === "true" });
+        return;
+    }
+    if (command === "done") {
+        await (0, done_1.runDone)({ json: flags["--json"] === "true" });
+        return;
+    }
+    if (command === "handshake") {
+        const sub = positional[0] ?? "";
+        if (sub === "create") {
+            const domain = flags["--domain"] ?? "";
+            const action = flags["--action"] ?? "";
+            const reason = flags["--reason"] ?? "";
+            if (!domain || !action || !reason) {
+                process.stderr.write("Usage: agentbridge handshake create --domain <name> --action \"<text>\" --reason \"<text>\" [--cr <id>] [--session <id>]\n");
+                process.exit(3);
+            }
+            await (0, handshake_1.runHandshakeCreate)({
+                domain,
+                action,
+                reason,
+                changeRequestId: flags["--cr"],
+                workSessionId: flags["--session"],
+            });
+            return;
+        }
+        if (sub === "acknowledge") {
+            await (0, handshake_1.runHandshakeAcknowledge)();
+            return;
+        }
+        if (sub === "resolve") {
+            await (0, handshake_1.runHandshakeResolve)();
+            return;
+        }
+        if (sub === "list") {
+            await (0, handshake_1.runHandshakeList)();
+            return;
+        }
+        process.stderr.write("Usage: agentbridge handshake create|acknowledge|resolve|list (see agentbridge --help)\n");
+        process.exit(3);
+        return;
+    }
+    if (command === "memory") {
+        const sub = positional[0] ?? "";
+        if (sub === "suggest") {
+            await (0, memory_1.runMemorySuggest)({
+                workSessionId: flags["--work-session"],
+                changeRequestId: flags["--change-request"],
+                domain: flags["--domain"],
+                compact: flags["--compact"] === "true",
+                json: flags["--json"] === "true",
+            });
+            return;
+        }
+        if (sub === "apply") {
+            const scopeFlag = flags["--scope"];
+            const scope = scopeFlag === "project" || scopeFlag === "domain" || scopeFlag === "both"
+                ? scopeFlag
+                : undefined;
+            await (0, memory_1.runMemoryApply)({
+                workSessionId: flags["--work-session"],
+                changeRequestId: flags["--change-request"],
+                domain: flags["--domain"],
+                scope,
+                items: flags["--items"],
+                reviewerNote: flags["--note"],
+            });
+            return;
+        }
+        if (sub === "reject") {
+            await (0, memory_1.runMemoryReject)({
+                workSessionId: flags["--work-session"],
+                changeRequestId: flags["--change-request"],
+                domain: flags["--domain"],
+                reviewerNote: flags["--note"],
+            });
+            return;
+        }
+        if (sub === "defer") {
+            await (0, memory_1.runMemoryDefer)({
+                workSessionId: flags["--work-session"],
+                changeRequestId: flags["--change-request"],
+                domain: flags["--domain"],
+                reviewerNote: flags["--note"],
+            });
+            return;
+        }
+        if (sub === "revert") {
+            await (0, memory_1.runMemoryRevert)({
+                approvalAuditId: flags["--approval-audit"] ?? "",
+                reviewerNote: flags["--note"],
+                force: flags["--force"] === "true",
+            });
+            return;
+        }
+        if (sub === "intake-escaped-bug") {
+            await (0, memory_1.runMemoryIntakeEscapedBug)({
+                fromFile: flags["--from-file"],
+                title: flags["--title"],
+                summary: flags["--summary"],
+                domain: flags["--domain"],
+                workSessionId: flags["--work-session"],
+                changeRequestId: flags["--change-request"],
+                reviewerNote: flags["--note"],
+                invariants: flags["--invariants"],
+                knownTraps: flags["--known-traps"],
+                futureProofRequirements: flags["--future-proof-requirements"],
+                acceptedLessons: flags["--accepted-lessons"],
+                compact: flags["--compact"] === "true",
+            });
+            return;
+        }
+        process.stderr.write("Usage: agentbridge memory suggest|apply|reject|defer|revert|intake-escaped-bug (see agentbridge --help)\n");
+        process.exit(3);
+        return;
+    }
+    if (command === "session") {
+        const sub = positional[0] ?? "";
+        if (sub === "list") {
+            await (0, session_1.runSessionList)({
+                crId: flags["--change-request"],
+                activeOnly: flags["--active"] === "true",
+                json: flags["--json"] === "true",
+            });
+            return;
+        }
+        if (sub === "inspect") {
+            await (0, session_1.runSessionInspect)(positional[1] ?? "", { json: flags["--json"] === "true" });
+            return;
+        }
+        if (sub === "abandon") {
+            await (0, session_1.runSessionAbandon)({
+                sessionId: flags["--session"],
+                reason: flags["--reason"] ?? "",
+                clearLocal: flags["--keep-local"] !== "true",
+                json: flags["--json"] === "true",
+            });
+            return;
+        }
+        if (sub === "cleanup") {
+            await (0, session_1.runSessionCleanupStale)({
+                dryRun: flags["--dry-run"] !== "false",
+                json: flags["--json"] === "true",
+            });
+            return;
+        }
+        process.stderr.write("Usage: agentbridge session list|inspect|cleanup|abandon (see agentbridge --help)\n");
+        process.exit(3);
+        return;
+    }
+    if (command === "version") {
+        (0, version_1.runVersion)();
+        return;
+    }
+    if (command === "doctor") {
+        process.exitCode = await (0, doctor_1.runDoctor)();
+        return;
+    }
+    if (command === "bug") {
+        const sub = positional[0] ?? "";
+        if (sub === "report") {
+            await (0, bug_1.runBugReport)({
+                title: flags["--title"],
+                severity: flags["--severity"],
+                category: flags["--category"],
+                foundIn: flags["--found-in"],
+                observed: flags["--observed"],
+                expected: flags["--expected"],
+                projectId: flags["--project"],
+                workSessionId: flags["--work-session"],
+                changeRequestId: flags["--change-request"],
+                commands: flags["--commands"],
+                files: flags["--files"],
+                logs: flags["--logs"],
+                userImpact: flags["--user-impact"],
+            });
+            return;
+        }
+        if (sub === "validate") {
+            await (0, bug_1.runBugValidate)({ file: flags["--file"] ?? "" });
+            return;
+        }
+        process.stderr.write("Usage: agentbridge bug report|validate (see agentbridge bug --help)\n");
+        process.exit(3);
+        return;
+    }
+    if (command === "autopilot") {
+        await (0, autopilot_1.runAutopilot)(positional);
+        return;
+    }
+    if (command === "attention") {
+        await (0, attention_1.runAttention)(positional);
+        return;
+    }
+    usage();
+}
+if (require.main === module) {
+    void main().catch((err) => {
+        const session = (0, session_state_1.readSessionState)();
+        const cfg = (0, config_1.readConfig)();
+        (0, cli_failure_log_1.logCliFailure)(err, {
+            command: process.argv.slice(2).join(" ") || process.argv[2],
+            projectId: cfg?.projectId,
+            workSessionId: session?.serverSessionId ?? session?.id,
+            changeRequestId: session?.changeRequestId,
+            correlationId: process.env.AGENTBRIDGE_CORRELATION_ID,
+        });
+        process.stderr.write(`${(0, errors_1.renderCliError)(err)}\n`);
+        // Print full stack trace when --debug is present or DEBUG env is set
+        if ((process.argv.includes("--debug") || process.env.DEBUG) &&
+            err instanceof Error &&
+            err.stack) {
+            process.stderr.write(`\n[debug] ${err.stack}\n`);
+        }
+        // Consolidated exit codes: 1 = blocking, 2 = infra, 3 = user input
+        const view = (0, errors_1.formatCliError)(err);
+        process.exit((0, errors_1.exitCodeForCategory)(view.category));
+    });
+}