agentera 3.0.0-dev.4 → 3.0.0-dev.41

package/dist/cli/dispatch.js

@@ -1,996 +1,2 @@
-import { cmdPrime } from "./commands/prime.js";
-import { cmdLint } from "./commands/lint.js";
-import { cmdBackfill } from "./commands/backfill.js";
-import { cmdState, isPortedStateCommand } from "./commands/state.js";
-import { COMMAND_FILTERS } from "./stateQuery.js";
-import { cmdQuery } from "./commands/query.js";
-import { cmdCompact, cmdGate } from "./commands/compact.js";
-import { cmdSchema } from "./commands/schema.js";
-import { cmdDoctor } from "./commands/doctor.js";
-import { cmdUpgrade } from "./commands/upgrade.js";
-import { cmdVerify } from "./commands/verify.js";
-import { cmdReport } from "./commands/report.js";
-import { runSessionStart } from "../hooks/sessionStart.js";
-import { runSessionStop } from "../hooks/sessionStop.js";
-import { runCursorSessionStart } from "../hooks/cursorSessionStart.js";
-import { runCursorPreToolUse } from "../hooks/cursorPreToolUse.js";
-import { HookCliAdapter } from "../hooks/validateArtifact.js";
-import fsForHooks from "node:fs";
-import { usageMain } from "../analytics/usageStats.js";
-import { validatePathValue } from "./argvalidate.js";
-import { cmdCapability, CAPABILITY_ROUTING_NAMES } from "./commands/capability.js";
-import { printCommandHelp, printDoctorHelp, printTopLevelHelp, printUpgradeHelp, splitHelpArgs, wantsHelp, } from "./help.js";
-import { cmdValidate, cmdValidateCapability, cmdValidateCapabilityContract, cmdValidateArtifact, cmdValidateDescriptors, isDelegatedValidateFamily, } from "./commands/validate.js";
-function emitDeprecationAlias(legacy, canonical, err) {
-    err(`Deprecation: agentera ${legacy} is deprecated; use agentera ${canonical}\n`);
-}
-/** Minimal flag parser for the `lint` command surface. */
-function parseLintArgs(argv) {
-    const args = { artifact: "", file: null, text: null, strict: false, format: "text" };
-    let sawArtifact = false;
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i];
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--artifact")) !== null) {
-            args.artifact = v;
-            sawArtifact = true;
-        }
-        else if ((v = value("--file")) !== null) {
-            args.file = v;
-        }
-        else if ((v = value("--text")) !== null) {
-            args.text = v;
-        }
-        else if (a === "--strict") {
-            args.strict = true;
-        }
-        else if ((v = value("--format")) !== null) {
-            if (v !== "text" && v !== "json") {
-                return { error: `argument --format: invalid choice: '${v}' (choose from 'text', 'json')` };
-            }
-            args.format = v;
-        }
-        else {
-            return { error: `unrecognized arguments: ${a}` };
-        }
-    }
-    if (!sawArtifact)
-        return { error: "the following arguments are required: --artifact" };
-    if (args.file !== null && args.text !== null) {
-        return { error: "argument --text: not allowed with argument --file" };
-    }
-    return args;
-}
-function runLint(argv, io, prog = "agentera lint") {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const parsed = parseLintArgs(argv);
-    if ("error" in parsed) {
-        err(`${prog}: error: ${parsed.error}\n`);
-        return 2;
-    }
-    try {
-        return cmdLint(parsed, io);
-    }
-    catch (exc) {
-        err(`Error: ${exc.message}\n`);
-        return 2;
-    }
-}
-function parseBackfillArgs(argv) {
-    const args = { project: null, mode: "check", commit: null, cycle: null, format: "text" };
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i];
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--project")) !== null)
-            args.project = v;
-        else if ((v = value("--mode")) !== null) {
-            if (v !== "check" && v !== "fix") {
-                return { error: `argument --mode: invalid choice: '${v}' (choose from 'check', 'fix')` };
-            }
-            args.mode = v;
-        }
-        else if ((v = value("--commit")) !== null)
-            args.commit = v;
-        else if ((v = value("--cycle")) !== null) {
-            const n = Number(v);
-            if (!Number.isInteger(n))
-                return { error: `argument --cycle: invalid int value: '${v}'` };
-            args.cycle = n;
-        }
-        else if ((v = value("--format")) !== null) {
-            if (v !== "text" && v !== "json") {
-                return { error: `argument --format: invalid choice: '${v}' (choose from 'text', 'json')` };
-            }
-            args.format = v;
-        }
-        else {
-            return { error: `unrecognized arguments: ${a}` };
-        }
-    }
-    return args;
-}
-function runBackfill(argv, io, prog = "agentera backfill") {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const parsed = parseBackfillArgs(argv);
-    if ("error" in parsed) {
-        err(`${prog}: error: ${parsed.error}\n`);
-        return 2;
-    }
-    try {
-        return cmdBackfill(parsed, io);
-    }
-    catch (exc) {
-        err(`Error: ${exc.message}\n`);
-        return 2;
-    }
-}
-function parseStateArgs(command, argv) {
-    const args = {
-        command,
-        topic: null,
-        status: null,
-        dimension: null,
-        severity: null,
-        limit: 5,
-        format: "text",
-        fields: null,
-    };
-    const allowed = new Set([...(COMMAND_FILTERS[command] ?? []), "format", "fields"]);
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i];
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        const named = (flag, key) => allowed.has(key) && (a === flag || a.startsWith(flag + "="));
-        let v;
-        if (named("--topic", "topic"))
-            args.topic = value("--topic");
-        else if (named("--status", "status"))
-            args.status = value("--status");
-        else if (named("--dimension", "dimension"))
-            args.dimension = value("--dimension");
-        else if (named("--severity", "severity"))
-            args.severity = value("--severity");
-        else if (named("--limit", "limit")) {
-            v = value("--limit");
-            const n = Number(v);
-            if (!Number.isInteger(n))
-                return { error: `argument --limit: invalid int value: '${v}'` };
-            args.limit = n;
-        }
-        else if (a === "--format" || a.startsWith("--format=")) {
-            v = value("--format");
-            if (v !== "text" && v !== "json" && v !== "yaml") {
-                return { error: `argument --format: invalid choice: '${v}' (choose from 'text', 'json', 'yaml')` };
-            }
-            args.format = v;
-        }
-        else if (a === "--fields" || a.startsWith("--fields="))
-            args.fields = value("--fields");
-        else
-            return { error: `unrecognized arguments: ${a}` };
-    }
-    return args;
-}
-function runState(command, argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const parsed = parseStateArgs(command, argv);
-    if ("error" in parsed) {
-        err(`${prog}: error: ${parsed.error}\n`);
-        return 2;
-    }
-    return cmdState(parsed, io);
-}
-function parseQueryArgs(argv) {
-    const args = {
-        query: null,
-        list_artifacts: false,
-        topic: null,
-        severity: null,
-        dimension: null,
-        status: null,
-        limit: null,
-        format: "text",
-        fields: null,
-    };
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i];
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if (a === "--list-artifacts")
-            args.list_artifacts = true;
-        else if ((v = value("--topic")) !== null)
-            args.topic = v;
-        else if ((v = value("--severity")) !== null)
-            args.severity = v;
-        else if ((v = value("--dimension")) !== null)
-            args.dimension = v;
-        else if ((v = value("--status")) !== null)
-            args.status = v;
-        else if ((v = value("--limit")) !== null) {
-            const n = Number(v);
-            if (!Number.isInteger(n))
-                return { error: `argument --limit: invalid int value: '${v}'` };
-            args.limit = n;
-        }
-        else if ((v = value("--format")) !== null) {
-            if (v !== "text" && v !== "json" && v !== "yaml") {
-                return { error: `argument --format: invalid choice: '${v}' (choose from 'text', 'json', 'yaml')` };
-            }
-            args.format = v;
-        }
-        else if ((v = value("--fields")) !== null)
-            args.fields = v;
-        else if (a.startsWith("--"))
-            return { error: `unrecognized arguments: ${a}` };
-        else if (args.query === null)
-            args.query = a;
-        else
-            return { error: `unrecognized arguments: ${a}` };
-    }
-    return args;
-}
-function runQuery(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const parsed = parseQueryArgs(argv);
-    if ("error" in parsed) {
-        err(`${prog}: error: ${parsed.error}\n`);
-        return 2;
-    }
-    try {
-        return cmdQuery(parsed, io);
-    }
-    catch (exc) {
-        err(`Error: ${exc.message}\n`);
-        return 2;
-    }
-}
-function compactModeOf(argv) {
-    for (let i = 0; i < argv.length; i++) {
-        if (argv[i] === "--mode")
-            return argv[i + 1] ?? "check";
-        if (argv[i].startsWith("--mode="))
-            return argv[i].slice("--mode=".length);
-    }
-    return "check";
-}
-function parseCompactArgs(argv) {
-    const args = { project: null, mode: "check", format: "text" };
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i];
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--project")) !== null)
-            args.project = v;
-        else if ((v = value("--mode")) !== null) {
-            if (v !== "check" && v !== "fix") {
-                return { error: `argument --mode: invalid choice: '${v}' (choose from 'check', 'fix')` };
-            }
-            args.mode = v;
-        }
-        else if ((v = value("--format")) !== null) {
-            if (v !== "text" && v !== "json") {
-                return { error: `argument --format: invalid choice: '${v}' (choose from 'text', 'json')` };
-            }
-            args.format = v;
-        }
-        else
-            return { error: `unrecognized arguments: ${a}` };
-    }
-    return args;
-}
-function runCompact(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const parsed = parseCompactArgs(argv);
-    if ("error" in parsed) {
-        err(`${prog}: error: ${parsed.error}\n`);
-        return 2;
-    }
-    try {
-        return cmdCompact(parsed, io);
-    }
-    catch (exc) {
-        err(`Error: ${exc.message}\n`);
-        return 2;
-    }
-}
-function runValidate(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    let family = null;
-    let capabilityTarget = null;
-    let artifactFlag = null;
-    let fileFlag = null;
-    let cwdFlag = null;
-    let format = "text";
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === "--format") {
-            const v = argv[++i];
-            if (v !== "text" && v !== "json") {
-                err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'text', 'json')\n`);
-                return 2;
-            }
-            format = v;
-        }
-        else if (a.startsWith("--format=")) {
-            const v = a.slice("--format=".length);
-            if (v !== "text" && v !== "json") {
-                err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'text', 'json')\n`);
-                return 2;
-            }
-            format = v;
-        }
-        else if (a === "--artifact" || a.startsWith("--artifact=")) {
-            artifactFlag = a === "--artifact" ? argv[++i] : a.slice("--artifact=".length);
-        }
-        else if (a === "--file" || a.startsWith("--file=")) {
-            fileFlag = a === "--file" ? argv[++i] : a.slice("--file=".length);
-        }
-        else if (a === "--cwd" || a.startsWith("--cwd=")) {
-            cwdFlag = a === "--cwd" ? argv[++i] : a.slice("--cwd=".length);
-        }
-        else if (a.startsWith("--")) {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-        else if (family === null) {
-            family = a;
-        }
-        else if (capabilityTarget === null) {
-            capabilityTarget = a;
-        }
-        else {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-    }
-    if (family === null) {
-        err(`${prog}: error: the following arguments are required: validate_family\n`);
-        return 2;
-    }
-    try {
-        if (family === "capability") {
-            if (capabilityTarget === null) {
-                err(`${prog} capability: error: the following arguments are required: target\n`);
-                return 2;
-            }
-            return cmdValidateCapability(capabilityTarget, { format }, io);
-        }
-        if (family === "capability-contract") {
-            return cmdValidateCapabilityContract({ format }, io);
-        }
-        if (family === "descriptors") {
-            return cmdValidateDescriptors({ format }, io);
-        }
-        if (family === "artifact") {
-            if (artifactFlag === null) {
-                err(`${prog} artifact: error: the following arguments are required: --artifact\n`);
-                return 2;
-            }
-            return cmdValidateArtifact({ artifact: artifactFlag, file: fileFlag, cwd: cwdFlag, format }, io);
-        }
-        if (isDelegatedValidateFamily(family)) {
-            return cmdValidate(family, { format }, io);
-        }
-        err(`agentera: validate family not yet ported: ${family}\n`);
-        return 1;
-    }
-    catch (exc) {
-        err(`Error: ${exc.message}\n`);
-        return 2;
-    }
-}
-function runSchema(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    let format = "json";
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        let v = null;
-        if (a === "--format")
-            v = argv[++i];
-        else if (a.startsWith("--format="))
-            v = a.slice("--format=".length);
-        else {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-        if (v !== "json" && v !== "yaml") {
-            err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'json', 'yaml')\n`);
-            return 2;
-        }
-        format = v;
-    }
-    try {
-        return cmdSchema({ format }, io);
-    }
-    catch (exc) {
-        err(`Error: ${exc.message}\n`);
-        return 2;
-    }
-}
-function runCapability(command, argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    let format = "text";
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        let v = null;
-        if (a === "--format")
-            v = argv[++i];
-        else if (a.startsWith("--format="))
-            v = a.slice("--format=".length);
-        else if (a === "--fields" || a.startsWith("--fields=")) {
-            // accepted by the parser but unused by capability routing
-            if (a === "--fields")
-                i++;
-            continue;
-        }
-        else {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-        if (v !== "text" && v !== "json" && v !== "yaml") {
-            err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'text', 'json', 'yaml')\n`);
-            return 2;
-        }
-        format = v;
-    }
-    return cmdCapability(command, { format }, io);
-}
-function runPrime(command, argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const args = { command, guidance: false, context: null, dashboard: false, orientation: false, format: "text" };
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        let v = null;
-        if (a === "--guidance")
-            args.guidance = true;
-        else if (a === "--dashboard")
-            args.dashboard = true;
-        else if (a === "--orientation")
-            args.orientation = true;
-        else if (a === "--context")
-            args.context = argv[++i];
-        else if (a.startsWith("--context="))
-            args.context = a.slice("--context=".length);
-        else if (a === "--format" || a.startsWith("--format=")) {
-            v = a === "--format" ? argv[++i] : a.slice("--format=".length);
-            if (v !== "text" && v !== "json" && v !== "yaml") {
-                err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'text', 'json', 'yaml')\n`);
-                return 2;
-            }
-            args.format = v;
-        }
-        else if (a === "--fields") {
-            args.fields = argv[++i];
-        }
-        else if (a.startsWith("--fields=")) {
-            args.fields = a.slice("--fields=".length);
-        }
-        else {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-    }
-    return cmdPrime(args, io);
-}
-function runGate(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const parsed = parseCompactArgs(argv);
-    if ("error" in parsed) {
-        err(`${prog}: error: ${parsed.error}\n`);
-        return 2;
-    }
-    try {
-        return cmdGate(parsed, io);
-    }
-    catch (exc) {
-        err(`Error: ${exc.message}\n`);
-        return 2;
-    }
-}
-function runDoctor(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const out = io.out ?? ((t) => process.stdout.write(t));
-    if (wantsHelp(argv)) {
-        out(printDoctorHelp() + "\n");
-        return 0;
-    }
-    const args = {
-        installRoot: null,
-        home: null,
-        project: null,
-        expectedVersion: null,
-        expectCommand: [],
-        smoke: false,
-        allowLiveModel: false,
-        format: "text",
-    };
-    let jsonFlag = false;
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i];
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--install-root")) !== null)
-            args.installRoot = v;
-        else if ((v = value("--home")) !== null)
-            args.home = v;
-        else if ((v = value("--project")) !== null)
-            args.project = v;
-        else if ((v = value("--expected-version")) !== null)
-            args.expectedVersion = v;
-        else if ((v = value("--expect-command")) !== null)
-            args.expectCommand.push(v);
-        else if ((v = value("--format")) !== null) {
-            if (v !== "text" && v !== "json") {
-                err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'text', 'json')\n`);
-                return 2;
-            }
-            args.format = v;
-        }
-        else if (a === "--json")
-            jsonFlag = true;
-        else if (a === "--smoke")
-            args.smoke = true;
-        else if (a === "--allow-live-model")
-            args.allowLiveModel = true;
-        else {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-    }
-    if (jsonFlag) {
-        emitDeprecationAlias("doctor --json", "doctor --format json", err);
-        args.format = "json";
-    }
-    return cmdDoctor(args, io);
-}
-function readStdin() {
-    try {
-        return fsForHooks.readFileSync(0, "utf8");
-    }
-    catch {
-        return "";
-    }
-}
-function runHook(name, argv, io) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const raw = io.stdin ? io.stdin() : readStdin();
-    // Each hook owns its own stdout newline convention; do not wrap stdout here.
-    switch (name) {
-        case "session-start":
-            return runSessionStart(raw);
-        case "session-stop":
-            return runSessionStop(raw);
-        case "cursor-session-start":
-            return runCursorSessionStart(raw);
-        case "cursor-pre-tool-use":
-            return runCursorPreToolUse(raw);
-        case "validate-artifact": {
-            const [rc, violations] = new HookCliAdapter().run(raw, null);
-            for (const v of violations)
-                err(`${v}\n`);
-            return rc;
-        }
-        default:
-            err(`agentera hook: unknown hook '${name}'\n`);
-            return 2;
-    }
-}
-function runUsage(argv, io, prog) {
-    const realOut = io.out ?? ((t) => process.stdout.write(t));
-    const realErr = io.err ?? ((t) => process.stderr.write(t));
-    let format = "text";
-    let corpus = null;
-    let project = null;
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i] ?? null;
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--format")) !== null)
-            format = v;
-        else if ((v = value("--corpus")) !== null)
-            corpus = v;
-        else if ((v = value("--project")) !== null)
-            project = v;
-        else {
-            realErr(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-    }
-    if (corpus !== null) {
-        try {
-            validatePathValue(corpus, "path");
-        }
-        catch (e) {
-            realErr(`${prog}: error: argument --corpus: ${e.message}\n`);
-            return 2;
-        }
-    }
-    if (format !== "text" && format !== "json") {
-        const syntax = "agentera usage [--format text|json] [--corpus PATH] [--project VALUE]";
-        const example = "agentera usage --format json --project agentera";
-        realErr(`Error: unsupported usage format '${format}'; valid formats: text, json. ` +
-            `Syntax: ${syntax}. Example: ${example}\n`);
-        return 2;
-    }
-    const engineArgv = [];
-    if (corpus !== null)
-        engineArgv.push("--corpus", corpus);
-    if (project !== null)
-        engineArgv.push("--project", project);
-    if (format === "json")
-        engineArgv.push("--json");
-    return usageMain(engineArgv, {
-        out: (t) => realOut(t + "\n"),
-        err: (t) => realErr(t + "\n"),
-    });
-}
-function runUpgrade(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const out = io.out ?? ((t) => process.stdout.write(t));
-    if (wantsHelp(argv)) {
-        out(printUpgradeHelp() + "\n");
-        return 0;
-    }
-    const args = {
-        installRoot: null,
-        home: null,
-        project: null,
-        expectedVersion: null,
-        channel: null,
-        yes: false,
-        dryRun: false,
-        only: [],
-        force: false,
-        format: "text",
-    };
-    let jsonFlag = false;
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i] ?? null;
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--install-root")) !== null)
-            args.installRoot = v;
-        else if ((v = value("--home")) !== null)
-            args.home = v;
-        else if ((v = value("--project")) !== null)
-            args.project = v;
-        else if ((v = value("--expected-version")) !== null)
-            args.expectedVersion = v;
-        else if ((v = value("--channel")) !== null)
-            args.channel = v;
-        else if ((v = value("--target-major")) !== null) {
-            void v;
-            err(`${prog}: error: --target-major was removed; use --channel with dry-run preview then --yes\n`);
-            return 2;
-        }
-        else if ((v = value("--runtime")) !== null)
-            void v; // accepted; orchestrator uses fixture runtimes
-        else if ((v = value("--only")) !== null) {
-            if (v !== "artifacts" && v !== "runtime" && v !== "cleanup") {
-                err(`${prog}: error: argument --only: invalid choice: '${v}' (choose from 'artifacts', 'runtime', 'cleanup')\n`);
-                return 2;
-            }
-            args.only.push(v);
-        }
-        else if ((v = value("--opencode-config-dir")) !== null)
-            void v; // accepted; ignored
-        else if (a === "--yes")
-            args.yes = true;
-        else if (a === "--dry-run")
-            args.dryRun = true;
-        else if (a === "--force")
-            args.force = true;
-        else if (a === "--update-packages")
-            void 0; // deferred for 3.x channel model
-        else if (a === "--json")
-            jsonFlag = true;
-        else if ((v = value("--format")) !== null) {
-            if (v !== "text" && v !== "json") {
-                err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'text', 'json')\n`);
-                return 2;
-            }
-            args.format = v;
-        }
-        else {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-    }
-    if (jsonFlag)
-        args.format = "json";
-    return cmdUpgrade(args, io);
-}
-function runVerify(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const args = {
-        family: null,
-        target: null,
-        format: "text",
-        run: false,
-        dryRun: false,
-        skill: null,
-        timeout: 120,
-        parallel: 1,
-        runtime: "auto",
-        fixtures: [],
-    };
-    const positionals = [];
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i] ?? null;
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--format")) !== null) {
-            if (v !== "text" && v !== "json") {
-                err(`${prog}: error: argument --format: invalid choice: '${v}' (choose from 'text', 'json')\n`);
-                return 2;
-            }
-            args.format = v;
-        }
-        else if ((v = value("--skill")) !== null)
-            args.skill = v;
-        else if ((v = value("--runtime")) !== null)
-            args.runtime = v;
-        else if ((v = value("--timeout")) !== null)
-            args.timeout = Number(v);
-        else if ((v = value("--parallel")) !== null)
-            args.parallel = Number(v);
-        else if (a === "--run")
-            args.run = true;
-        else if (a === "--dry-run")
-            args.dryRun = true;
-        else if (a.startsWith("--")) {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-        else {
-            positionals.push(a);
-        }
-    }
-    args.family = positionals[0] ?? null;
-    args.target = positionals[1] ?? null;
-    args.fixtures = positionals.slice(2);
-    return cmdVerify(args, io);
-}
-function runReport(argv, io, prog) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const args = {
-        action: null,
-        format: "text",
-        project: null,
-        dryRun: false,
-        consent: null,
-        projectRoot: [],
-    };
-    const positionals = [];
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const value = (name) => {
-            if (a === name)
-                return argv[++i] ?? null;
-            if (a.startsWith(name + "="))
-                return a.slice(name.length + 1);
-            return null;
-        };
-        let v;
-        if ((v = value("--format")) !== null)
-            args.format = v;
-        else if ((v = value("--project")) !== null)
-            args.project = v;
-        else if ((v = value("--consent")) !== null) {
-            if (v !== "local-history") {
-                err(`${prog}: error: argument --consent: invalid choice: '${v}' (choose from 'local-history')\n`);
-                return 2;
-            }
-            args.consent = v;
-        }
-        else if ((v = value("--project-root")) !== null)
-            args.projectRoot.push(v);
-        else if ((v = value("--output")) !== null)
-            args.output = v;
-        else if ((v = value("--codex-sessions-dir")) !== null)
-            args.codexSessionsDir = v;
-        else if ((v = value("--claude-projects-dir")) !== null)
-            args.claudeProjectsDir = v;
-        else if ((v = value("--opencode-conversations-dir")) !== null)
-            args.opencodeConversationsDir = v;
-        else if ((v = value("--copilot-conversations-dir")) !== null)
-            args.copilotConversationsDir = v;
-        else if ((v = value("--cursor-projects-dir")) !== null)
-            args.cursorProjectsDir = v;
-        else if ((v = value("--cursor-chats-dir")) !== null)
-            args.cursorChatsDir = v;
-        else if (a === "--no-codex")
-            args.noCodex = true;
-        else if (a === "--no-claude")
-            args.noClaude = true;
-        else if (a === "--no-opencode")
-            args.noOpencode = true;
-        else if (a === "--no-copilot")
-            args.noCopilot = true;
-        else if (a === "--no-cursor")
-            args.noCursor = true;
-        else if (a === "--dry-run")
-            args.dryRun = true;
-        else if (a.startsWith("--")) {
-            err(`${prog}: error: unrecognized arguments: ${a}\n`);
-            return 2;
-        }
-        else {
-            positionals.push(a);
-        }
-    }
-    args.action = positionals[0] ?? null;
-    return cmdReport(args, io);
-}
-export function main(argv, io = {}) {
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const out = io.out ?? ((t) => process.stdout.write(t));
-    const args = argv.slice(2);
-    if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-        out(printTopLevelHelp() + "\n");
-        return 0;
-    }
-    const command = args[0];
-    const { args: rest, help } = splitHelpArgs(args.slice(1));
-    if (help) {
-        const text = printCommandHelp(command, rest);
-        if (text) {
-            out(text + "\n");
-            return 0;
-        }
-        err(`agentera: unknown or not-yet-ported command: ${command}\n`);
-        return 1;
-    }
-    switch (command) {
-        case "prime":
-            return runPrime("prime", rest, io, "agentera prime");
-        case "doctor":
-            return runDoctor(rest, io, "agentera doctor");
-        case "usage":
-            return runUsage(rest, io, "agentera usage");
-        case "upgrade":
-            return runUpgrade(rest, io, "agentera upgrade");
-        case "verify":
-            emitDeprecationAlias("verify", "check verify", err);
-            return runVerify(rest, io, "agentera verify");
-        case "report":
-            return runReport(rest, io, "agentera report");
-        case "stats":
-            emitDeprecationAlias("stats", "report", err);
-            return runReport(rest, io, "agentera stats");
-        case "hook": {
-            const name = rest[0];
-            if (!name) {
-                err("agentera hook: error: the following arguments are required: hook_name\n");
-                return 2;
-            }
-            return runHook(name, rest.slice(1), io);
-        }
-        case "hej":
-            emitDeprecationAlias("hej", "prime", err);
-            return runPrime("hej", rest, io, "agentera hej");
-        case "schema":
-            return runSchema(rest, io, "agentera schema");
-        case "describe":
-            emitDeprecationAlias("describe", "schema", err);
-            return runSchema(rest, io, "agentera describe");
-        case "lint":
-            emitDeprecationAlias("lint", "check lint", err);
-            return runLint(rest, io);
-        case "check": {
-            const sub = rest[0];
-            if (!sub) {
-                err("agentera check: error: the following arguments are required: check_command\n");
-                return 2;
-            }
-            if (sub === "validate")
-                return runValidate(rest.slice(1), io, "agentera check validate");
-            if (sub === "verify")
-                return runVerify(rest.slice(1), io, "agentera check verify");
-            if (sub === "lint")
-                return runLint(rest.slice(1), io, "agentera check lint");
-            if (sub === "backfill")
-                return runBackfill(rest.slice(1), io, "agentera check backfill");
-            if (sub === "compact") {
-                const subArgs = rest.slice(1);
-                const mode = compactModeOf(subArgs);
-                if (mode === "fix")
-                    return runCompact(subArgs, io, "agentera check compact");
-                return runGate(subArgs, io, "agentera check compact");
-            }
-            err(`agentera: unknown or not-yet-ported check subcommand: ${sub}\n`);
-            return 1;
-        }
-        case "state": {
-            const sub = rest[0];
-            if (!sub) {
-                err("agentera state: error: the following arguments are required: state_command\n");
-                return 2;
-            }
-            if (sub === "query")
-                return runQuery(rest.slice(1), io, "agentera state query");
-            if (isPortedStateCommand(sub))
-                return runState(sub, rest.slice(1), io, `agentera state ${sub}`);
-            err(`agentera: unknown or not-yet-ported state subcommand: ${sub}\n`);
-            return 1;
-        }
-        case "query":
-            emitDeprecationAlias("query", "state query", err);
-            return runQuery(rest, io, "agentera query");
-        case "compact":
-            emitDeprecationAlias("compact", "check compact", err);
-            return runCompact(rest, io, "agentera compact");
-        case "gate":
-            emitDeprecationAlias("gate", "check compact", err);
-            return runGate(rest, io, "agentera gate");
-        case "validate":
-            emitDeprecationAlias("validate", "check validate", err);
-            return runValidate(rest, io, "agentera validate");
-        default:
-            if (command && CAPABILITY_ROUTING_NAMES.includes(command)) {
-                return runCapability(command, rest, io, `agentera ${command}`);
-            }
-            if (command && isPortedStateCommand(command)) {
-                emitDeprecationAlias(command, `state ${command}`, err);
-                return runState(command, rest, io, `agentera ${command}`);
-            }
-            err(`agentera: unknown or not-yet-ported command: ${command ?? "(none)"}\n`);
-            return 1;
-    }
-}
+export { main } from "./dispatch/index.js";
 //# sourceMappingURL=dispatch.js.map