agentera 3.0.0-dev.2 → 3.0.0-dev.21

package/dist/cli/dispatch/check.js

@@ -0,0 +1,395 @@
+import { cmdLint } from "../commands/lint.js";
+import { cmdCompact } from "../commands/compact.js";
+import { cmdSchema } from "../commands/schema.js";
+import { cmdValidate, cmdValidateCapability, cmdValidateCapabilityContract, cmdValidateArtifact, cmdValidateDescriptors, isDelegatedValidateFamily, } from "../commands/validate.js";
+import { LEGACY_PYTHON_PARITY_FLAG } from "../../validate/lifecycleAdapters.js";
+import { makeArgvValueReader } from "./argvParser.js";
+import { asEnvelopeFormat, classifyParseError, detectTopLevelFormat } from "./shared.js";
+import { emitInvalidInput } from "../errors.js";
+import { StateWriteInputError } from "../../state/write/errors.js";
+import { cmdDurability, durabilityFailure, emitDurabilityFailure, requestedDurabilityFormat, validateDurabilityArgs, } from "../commands/durability.js";
+import { resolveSourceRoot } from "../../core/sourceRoot.js";
+import { StateRetrievalFailure } from "../../state/directRetrieval.js";
+/** Minimal flag parser for the `lint` command surface. */
+export function parseLintArgs(argv) {
+    const args = { artifact: "", file: null, text: null, strict: false, format: "text" };
+    let sawArtifact = false;
+    let i = 0;
+    const value = makeArgvValueReader(argv, () => i, (n) => {
+        i = n;
+    });
+    for (; i < argv.length; i++) {
+        const a = argv[i];
+        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;
+}
+export function runLint(argv, io, prog = "agentera lint") {
+    const parsed = parseLintArgs(argv);
+    if ("error" in parsed) {
+        return emitInvalidInput(io, {
+            format: detectTopLevelFormat(argv),
+            body: classifyParseError(parsed.error),
+        });
+    }
+    try {
+        return cmdLint(parsed, io);
+    }
+    catch (exc) {
+        return emitInvalidInput(io, {
+            format: asEnvelopeFormat(parsed.format),
+            body: { class: "unsupported_target", message: exc.message },
+        });
+    }
+}
+export function compactModeOf(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === "--apply")
+            return "fix";
+        if (argv[i] === "--mode")
+            return argv[i + 1] ?? "check";
+        if (argv[i].startsWith("--mode="))
+            return argv[i].slice("--mode=".length);
+    }
+    return "check";
+}
+export function parseCompactArgs(argv) {
+    const args = { project: null, mode: "check", format: "text" };
+    let i = 0;
+    const value = makeArgvValueReader(argv, () => i, (n) => {
+        i = n;
+    });
+    for (; i < argv.length; i++) {
+        const a = argv[i];
+        let v;
+        if (a === "--apply") {
+            args.mode = "fix";
+        }
+        else 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;
+}
+export function runCompact(argv, io, prog) {
+    const parsed = parseCompactArgs(argv);
+    if ("error" in parsed) {
+        return emitInvalidInput(io, {
+            format: "text",
+            body: classifyParseError(parsed.error),
+        });
+    }
+    try {
+        return cmdCompact(parsed, io);
+    }
+    catch (exc) {
+        if (exc instanceof StateWriteInputError)
+            return emitInvalidInput(io, { format: asEnvelopeFormat(parsed.format), body: exc.body });
+        return emitInvalidInput(io, {
+            format: asEnvelopeFormat(parsed.format),
+            body: { class: "unsupported_target", message: exc.message },
+        });
+    }
+}
+export function parseDurabilityArgs(argv) {
+    const args = { project: null, artifact: null, format: "text" };
+    let i = 0;
+    const value = makeArgvValueReader(argv, () => i, (n) => {
+        i = n;
+    });
+    for (; i < argv.length; i++) {
+        const token = argv[i];
+        let parsed;
+        if ((parsed = value("--project")) !== null)
+            args.project = parsed;
+        else if ((parsed = value("--artifact")) !== null)
+            args.artifact = parsed;
+        else if ((parsed = value("--number")) !== null) {
+            if (!/^[1-9][0-9]*$/.test(parsed))
+                return { error: `argument --number: invalid int value: '${parsed}'` };
+            const number = Number(parsed);
+            if (!Number.isSafeInteger(number))
+                return { error: `argument --number: invalid int value: '${parsed}'` };
+            args.number = number;
+        }
+        else if ((parsed = value("--limit")) !== null) {
+            if (!/^[1-9][0-9]*$/.test(parsed))
+                return { error: `argument --limit: invalid int value: '${parsed}'` };
+            const limit = Number(parsed);
+            if (!Number.isSafeInteger(limit))
+                return { error: `argument --limit: invalid int value: '${parsed}'` };
+            args.limit = limit;
+        }
+        else if ((parsed = value("--format")) !== null) {
+            if (parsed !== "text" && parsed !== "json" && parsed !== "yaml") {
+                return { error: `argument --format: invalid choice: '${parsed}' (choose from 'text', 'json', 'yaml')` };
+            }
+            args.format = parsed;
+        }
+        else
+            return { error: `unrecognized arguments: ${token}` };
+    }
+    if (args.number !== undefined && !args.artifact) {
+        return { error: "the following arguments are required: --artifact when --number is supplied" };
+    }
+    return args;
+}
+export function runDurability(argv, io, prog) {
+    const format = requestedDurabilityFormat(argv);
+    const sourceRoot = resolveSourceRoot();
+    const parsed = parseDurabilityArgs(argv);
+    if ("error" in parsed) {
+        return emitDurabilityFailure(durabilityFailure("invalid_request", parsed.error, sourceRoot), format, io);
+    }
+    try {
+        validateDurabilityArgs(parsed, sourceRoot);
+        return cmdDurability(parsed, io);
+    }
+    catch (exc) {
+        if (exc instanceof StateRetrievalFailure)
+            return emitDurabilityFailure(exc, format, io);
+        return emitDurabilityFailure(durabilityFailure("unsupported_state", exc.message, sourceRoot, parsed.artifact, parsed.number), format, io);
+    }
+}
+export function runValidate(argv, io, prog) {
+    const requestedFormat = detectTopLevelFormat(argv);
+    let family = null;
+    let capabilityTarget = null;
+    let artifactFlag = null;
+    let fileFlag = null;
+    let cwdFlag = null;
+    let legacyPythonParity = false;
+    let format = "text";
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === LEGACY_PYTHON_PARITY_FLAG) {
+            legacyPythonParity = true;
+        }
+        else if (a === "--format") {
+            const v = argv[++i];
+            if (v !== "text" && v !== "json") {
+                return emitInvalidInput(io, {
+                    format,
+                    body: {
+                        class: "invalid_choice",
+                        message: `argument --format: invalid choice: '${v}' (choose from 'text', 'json')`,
+                        valid_values: ["text", "json"],
+                    },
+                });
+            }
+            format = v;
+        }
+        else if (a.startsWith("--format=")) {
+            const v = a.slice("--format=".length);
+            if (v !== "text" && v !== "json") {
+                return emitInvalidInput(io, {
+                    format,
+                    body: {
+                        class: "invalid_choice",
+                        message: `argument --format: invalid choice: '${v}' (choose from 'text', 'json')`,
+                        valid_values: ["text", "json"],
+                    },
+                });
+            }
+            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("--")) {
+            return emitInvalidInput(io, {
+                format: requestedFormat,
+                body: {
+                    class: "unrecognized_argument",
+                    message: `unrecognized arguments: ${a}`,
+                },
+            });
+        }
+        else if (family === null) {
+            family = a;
+        }
+        else if (capabilityTarget === null) {
+            capabilityTarget = a;
+        }
+        else {
+            return emitInvalidInput(io, {
+                format: requestedFormat,
+                body: {
+                    class: "unrecognized_argument",
+                    message: `unrecognized arguments: ${a}`,
+                },
+            });
+        }
+    }
+    if (family === null) {
+        return emitInvalidInput(io, {
+            format,
+            body: {
+                class: "missing_argument",
+                message: "the following arguments are required: validate_family",
+                valid_values: [
+                    "cross-capability",
+                    "lifecycle-adapters",
+                    "app-home-contract",
+                    "vocabularyAuthority",
+                    "selfAudit",
+                    "release-metadata",
+                    "capability",
+                    "capability-contract",
+                    "descriptors",
+                    "artifact",
+                ],
+                example: "agentera check validate cross-capability",
+            },
+        });
+    }
+    try {
+        if (family === "capability") {
+            if (capabilityTarget === null) {
+                return emitInvalidInput(io, {
+                    format,
+                    body: {
+                        class: "missing_argument",
+                        message: "the following arguments are required: target",
+                        example: "agentera check validate capability plan",
+                    },
+                });
+            }
+            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) {
+                return emitInvalidInput(io, {
+                    format,
+                    body: {
+                        class: "missing_argument",
+                        message: "the following arguments are required: --artifact",
+                        example: "agentera check validate artifact --artifact plan",
+                    },
+                });
+            }
+            return cmdValidateArtifact({ artifact: artifactFlag, file: fileFlag, cwd: cwdFlag, format }, io);
+        }
+        if (isDelegatedValidateFamily(family)) {
+            return cmdValidate(family, { format, legacyPythonParity }, io);
+        }
+        return emitInvalidInput(io, {
+            format,
+            body: {
+                class: "unsupported_target",
+                message: `validate family not yet ported: ${family}`,
+                valid_values: [
+                    "cross-capability",
+                    "lifecycle-adapters",
+                    "app-home-contract",
+                    "vocabularyAuthority",
+                    "selfAudit",
+                    "release-metadata",
+                    "capability",
+                    "capability-contract",
+                    "descriptors",
+                    "artifact",
+                ],
+            },
+        });
+    }
+    catch (exc) {
+        return emitInvalidInput(io, {
+            format,
+            body: {
+                class: "unsupported_target",
+                message: exc.message,
+            },
+        });
+    }
+}
+export function runSchema(argv, io, prog) {
+    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 {
+            return emitInvalidInput(io, {
+                format: asEnvelopeFormat(format),
+                body: { class: "unrecognized_argument", message: `unrecognized arguments: ${a}` },
+            });
+        }
+        if (v !== "json" && v !== "yaml") {
+            return emitInvalidInput(io, {
+                format: asEnvelopeFormat(format),
+                body: {
+                    class: "invalid_choice",
+                    message: `argument --format: invalid choice: '${v}' (choose from 'json', 'yaml')`,
+                    valid_values: ["json", "yaml"],
+                },
+            });
+        }
+        format = v;
+    }
+    try {
+        return cmdSchema({ format }, io);
+    }
+    catch (exc) {
+        return emitInvalidInput(io, {
+            format: asEnvelopeFormat(format),
+            body: { class: "unsupported_target", message: exc.message },
+        });
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/dispatch/check.js.map

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

package/dist/cli/dispatch/commands.js

@@ -0,0 +1,27 @@
+import { CAPABILITY_ROUTING_NAMES } from "../commands/capability.js";
+/**
+ * Top-level commands routed by `dispatch/main` (includes migration aliases still
+ * accepted at the CLI surface).
+ */
+export const DISPATCHER_TOP_LEVEL_COMMANDS = [
+    "prime",
+    "app-home",
+    "doctor",
+    "usage",
+    "upgrade",
+    "verify",
+    "report",
+    "stats",
+    "hook",
+    "schema",
+    "lint",
+    "check",
+    "state",
+    "query",
+    "compact",
+    "validate",
+    ...CAPABILITY_ROUTING_NAMES,
+];
+/** Set view for doctor in-process CLI probe checks. */
+export const DISPATCHER_COMMANDS = new Set(DISPATCHER_TOP_LEVEL_COMMANDS);
+//# sourceMappingURL=commands.js.map

package/dist/cli/dispatch/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/cli/dispatch/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,OAAO;IACP,UAAU;IACV,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;IACR,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,SAAS;IACT,UAAU;IACV,GAAG,wBAAwB;CACnB,CAAC;AAEX,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,6BAA6B,CAAC,CAAC"}

package/dist/cli/dispatch/index.js

@@ -0,0 +1,201 @@
+import { isPortedStateCommand } from "../commands/state/index.js";
+import { runBackfill } from "../commands/backfill.js";
+import { runMigrate } from "../commands/migrate.js";
+import { CAPABILITY_ROUTING_NAMES } from "../commands/capability.js";
+import { printCommandHelp, printStateHelp, printTopLevelHelp, splitHelpArgs, stateCommandNames, } from "../help.js";
+import { compactModeOf, runCompact, runDurability, runLint, runSchema, runValidate, } from "./check.js";
+import { runQuery, runState } from "./state.js";
+import { runCapability, runPrime } from "./prime.js";
+import { runAppHome, runDoctor, runGate, runHook, runReport, runUpgrade, runUsage, runVerify, runVersion, } from "./lifecycle.js";
+import { detectTopLevelFormat, emitDeprecationAlias } from "./shared.js";
+import { emitInvalidInput } from "../errors.js";
+import { isWriteVerb } from "../../state/write/operations.js";
+import { stateMigrationContract } from "../../state/migrationAuthority.js";
+import { REMOVED_TOP_LEVEL_CORRECTIONS } from "../commands/schema.js";
+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;
+        }
+        return emitInvalidInput(io, {
+            format: "text",
+            body: {
+                class: "unsupported_target",
+                message: `unknown or not-yet-ported command: ${command}`,
+            },
+        });
+    }
+    switch (command) {
+        case "--version":
+        case "version":
+            return runVersion(rest, io);
+        case "prime":
+            return runPrime("prime", rest, io, "agentera prime");
+        case "app-home":
+            return runAppHome(rest, io, "agentera app-home");
+        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) {
+                return emitInvalidInput(io, {
+                    format: "text",
+                    body: {
+                        class: "missing_argument",
+                        message: "the following arguments are required: hook_name",
+                        valid_values: [
+                            "session-start",
+                            "session-stop",
+                            "cursor-session-start",
+                            "cursor-pre-tool-use",
+                            "validate-artifact",
+                        ],
+                    },
+                });
+            }
+            return runHook(name, rest.slice(1), io);
+        }
+        case "schema":
+            return runSchema(rest, io, "agentera schema");
+        case "lint":
+            emitDeprecationAlias("lint", "check lint", err);
+            return runLint(rest, io);
+        case "check": {
+            const sub = rest[0];
+            if (!sub) {
+                return emitInvalidInput(io, {
+                    format: "text",
+                    body: {
+                        class: "missing_argument",
+                        message: "the following arguments are required: check_command",
+                        valid_values: ["validate", "verify", "lint", "compact", "durability"],
+                    },
+                });
+            }
+            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 === "durability")
+                return runDurability(rest.slice(1), io, "agentera check durability");
+            if (sub === "lint")
+                return runLint(rest.slice(1), io, "agentera check lint");
+            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");
+            }
+            return emitInvalidInput(io, {
+                format: "text",
+                body: {
+                    class: "unsupported_target",
+                    message: `unknown or not-yet-ported check subcommand: ${sub}`,
+                    valid_values: ["validate", "verify", "lint", "compact", "durability"],
+                },
+            });
+        }
+        case "state": {
+            const sub = rest[0];
+            const migration = stateMigrationContract();
+            const stateCommands = stateCommandNames(migration);
+            const migrationCommand = migration.namespace.split(/\s+/).at(-1);
+            const stateSyntax = printStateHelp()
+                .split("\n", 1)[0]
+                .replace(/^usage:\s*/, "");
+            const stateExample = `${migration.namespace} --format ${migration.formats[1] ?? migration.formats[0]}`;
+            if (!sub) {
+                return emitInvalidInput(io, {
+                    format: "text",
+                    body: {
+                        class: "missing_argument",
+                        message: "the following arguments are required: state_command",
+                        valid_values: stateCommands,
+                        syntax: stateSyntax,
+                        example: stateExample,
+                    },
+                });
+            }
+            if (sub === "query")
+                return runQuery(rest.slice(1), io, "agentera state query");
+            if (sub === migrationCommand)
+                return runMigrate(rest.slice(1), io);
+            if (sub === "backfill")
+                return runBackfill(rest.slice(1), io);
+            if (isPortedStateCommand(sub) || isWriteVerb(rest[1]) || rest[1] === "get")
+                return runState(sub, rest.slice(1), io, `agentera state ${sub}`);
+            return emitInvalidInput(io, {
+                format: "text",
+                body: {
+                    class: "unsupported_target",
+                    message: `unknown or not-yet-ported state subcommand: ${sub}`,
+                    valid_values: stateCommands,
+                    syntax: stateSyntax,
+                    example: stateExample,
+                },
+            });
+        }
+        case "query":
+            emitDeprecationAlias("query", "state query", err);
+            return runQuery(rest, io, "agentera query");
+        case "compact":
+            emitDeprecationAlias("compact", "check compact", err);
+            return compactModeOf(rest) === "fix"
+                ? runCompact(rest, io, "agentera compact")
+                : runGate(rest, io, "agentera compact");
+        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 && REMOVED_TOP_LEVEL_CORRECTIONS[command]) {
+                const canonical = REMOVED_TOP_LEVEL_CORRECTIONS[command];
+                const example = `agentera ${canonical} --format json`;
+                return emitInvalidInput(io, {
+                    format: detectTopLevelFormat(rest),
+                    body: {
+                        class: "unsupported_target",
+                        message: `unknown or not-yet-ported command: ${command}; this top-level name was removed, use '${canonical}'`,
+                        valid_values: [canonical],
+                        syntax: `agentera ${canonical} [options]`,
+                        example,
+                        recovery: `Run ${example}; no state was changed by the rejected command.`,
+                    },
+                });
+            }
+            return emitInvalidInput(io, {
+                format: "text",
+                body: {
+                    class: "unsupported_target",
+                    message: `unknown or not-yet-ported command: ${command ?? "(none)"}`,
+                },
+            });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/dispatch/index.js.map

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