agentera 3.0.0-dev.3 → 3.0.0-dev.31

package/dist/cli/commands/state/experiments.js

@@ -0,0 +1,15 @@
+import { emitStructured } from "../../structured.js";
+import { listCurrentExperimentEntities } from "../../../state/objectiveExperimentEntities.js";
+import YAML from "yaml";
+import { out } from "./shared.js";
+export function queryExperiments(args, _schemas, io) {
+    const format = args.format ?? "text";
+    const response = listCurrentExperimentEntities(process.cwd(), args.objective ?? undefined, args.limit ?? undefined, args.cursor ?? undefined, { topic: args.topic ?? undefined, status: args.status ?? undefined }, { format });
+    const output = out(io);
+    if (format === "text")
+        output(YAML.stringify(response));
+    else
+        emitStructured(response, format, output);
+    return 0;
+}
+//# sourceMappingURL=experiments.js.map

package/dist/cli/commands/state/experiments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/state/experiments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAC9F,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,GAAG,EAA2B,MAAM,aAAa,CAAC;AAE3D,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,QAAoC,EAAE,EAAM;IAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IACrC,MAAM,QAAQ,GAAG,6BAA6B,CAC5C,OAAO,CAAC,GAAG,EAAE,EACb,IAAI,CAAC,SAAS,IAAI,SAAS,EAC3B,IAAI,CAAC,KAAK,IAAI,SAAS,EACvB,IAAI,CAAC,MAAM,IAAI,SAAS,EACxB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,EACpE,EAAE,MAAM,EAAE,CACX,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,MAAM,KAAK,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;;QACnD,cAAc,CAAC,QAAQ,EAAE,MAAyB,EAAE,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/state/get.js

@@ -0,0 +1,127 @@
+import YAML from "yaml";
+import { resolveSourceRoot } from "../../../core/sourceRoot.js";
+import { StateRetrievalFailure } from "../../../state/directRetrieval.js";
+import { getDecisionEntity } from "../../../state/decisionEntities.js";
+import { getHealthEntity } from "../../../state/healthEntities.js";
+import { getObjectiveEntity } from "../../../state/objectiveExperimentEntities.js";
+import { getProgressEntity } from "../../../state/progressEntities.js";
+import { getTodoDocsEntity } from "../../../state/todoDocsEntities.js";
+import { emitStructured } from "../../structured.js";
+const ENTITY_GET_ARTIFACTS = ["progress", "decisions", "health", "objective", "todo", "docs"];
+function requestedFormat(argv) {
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === "--format") {
+            const value = argv[index + 1];
+            if (value === "json" || value === "yaml")
+                return value;
+        }
+        if (token.startsWith("--format=")) {
+            const value = token.slice("--format=".length);
+            if (value === "json" || value === "yaml")
+                return value;
+        }
+    }
+    return "text";
+}
+function failure(message, id, artifact = "progress") {
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: "invalid_request",
+            message,
+            syntax: `agentera state ${artifact} get --id ID --format json`,
+            example: `agentera state ${artifact} get --id ${id ?? "qjtrmnpvka"} --format json`,
+            recovery: `Use a bare ten-letter ${artifact} ID returned by append or list; no state was changed.`,
+            artifact,
+            ...(id ? { id } : {}),
+        },
+    }, 2);
+}
+function readValue(argv, index, name) {
+    const token = argv[index];
+    if (token.startsWith(`${name}=`))
+        return { value: token.slice(name.length + 1), next: index + 1 };
+    const value = argv[index + 1];
+    if (!value || value.startsWith("--"))
+        throw new Error(`${name} requires a value`);
+    return { value, next: index + 2 };
+}
+function emitFailure(error, format, io) {
+    if (format === "json" || format === "yaml") {
+        emitStructured(error.body, format, io.out ?? ((text) => process.stdout.write(text)));
+    }
+    else {
+        const detail = error.body.error;
+        (io.err ?? ((text) => process.stderr.write(text)))([
+            `Error: ${detail.message}`,
+            `Syntax: ${detail.syntax}`,
+            `Example: ${detail.example}`,
+            `Recovery: ${detail.recovery}`,
+        ].join("\n") + "\n");
+    }
+    return error.exitCode;
+}
+export function runStateGet(artifactId, argv, io, projectRoot = process.cwd()) {
+    const format = requestedFormat(argv);
+    const sourceRoot = resolveSourceRoot();
+    try {
+        if (!ENTITY_GET_ARTIFACTS.includes(artifactId))
+            throw failure(`unsupported state artifact '${artifactId}'`, undefined, artifactId);
+        let id;
+        let entityFormat = "text";
+        let formatSupplied = false;
+        for (let index = 0; index < argv.length;) {
+            const token = argv[index];
+            if (token !== "--id" && !token.startsWith("--id=") && token !== "--format" && !token.startsWith("--format=")) {
+                throw failure(`unrecognized argument '${token}'; entity-mode ${artifactId} retrieval requires --id ID`, id, artifactId);
+            }
+            const name = token.startsWith("--id") ? "--id" : "--format";
+            let parsed;
+            try {
+                parsed = readValue(argv, index, name);
+            }
+            catch (error) {
+                throw failure(error.message, id, artifactId);
+            }
+            index = parsed.next;
+            if (name === "--id") {
+                if (id !== undefined)
+                    throw failure("--id may only be supplied once", id, artifactId);
+                id = parsed.value;
+            }
+            else {
+                if (formatSupplied)
+                    throw failure("--format may only be supplied once", id, artifactId);
+                formatSupplied = true;
+                if (parsed.value !== "text" && parsed.value !== "json" && parsed.value !== "yaml")
+                    throw failure(`invalid --format '${parsed.value}'`, id, artifactId);
+                entityFormat = parsed.value;
+            }
+        }
+        if (!id)
+            throw failure(`--id is required for entity-mode ${artifactId} retrieval`, id, artifactId);
+        const response = artifactId === "progress"
+            ? getProgressEntity(projectRoot, id, sourceRoot)
+            : artifactId === "decisions"
+                ? getDecisionEntity(projectRoot, id, sourceRoot)
+                : artifactId === "health"
+                    ? getHealthEntity(projectRoot, id, sourceRoot)
+                    : artifactId === "objective"
+                        ? getObjectiveEntity(projectRoot, id, sourceRoot)
+                        : getTodoDocsEntity(projectRoot, artifactId, id, sourceRoot);
+        const output = io.out ?? ((text) => process.stdout.write(text));
+        if (entityFormat === "json" || entityFormat === "yaml")
+            emitStructured(response, entityFormat, output);
+        else
+            output(YAML.stringify(response));
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof StateRetrievalFailure)
+            return emitFailure(error, format, io);
+        return emitFailure(failure(error.message, undefined, artifactId), format, io);
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/cli/commands/state/get.js.map

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

package/dist/cli/commands/state/health.js

@@ -0,0 +1,15 @@
+import { emitStructured } from "../../structured.js";
+import { listHealthEntities } from "../../../state/healthEntities.js";
+import YAML from "yaml";
+import { out } from "./shared.js";
+export function queryHealth(args, _schemas, io) {
+    const format = args.format ?? "text";
+    const response = listHealthEntities(process.cwd(), args.limit ?? 1, args.dimension ?? undefined, args.cursor ?? undefined, { format });
+    const output = out(io);
+    if (format === "text")
+        output(YAML.stringify(response));
+    else
+        emitStructured(response, format, output);
+    return 0;
+}
+//# sourceMappingURL=health.js.map

package/dist/cli/commands/state/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/state/health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,GAAG,EAA2B,MAAM,aAAa,CAAC;AAE3D,MAAM,UAAU,WAAW,CAAC,IAAe,EAAE,QAAoC,EAAE,EAAM;IACvF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IACrC,MAAM,QAAQ,GAAG,kBAAkB,CACjC,OAAO,CAAC,GAAG,EAAE,EACb,IAAI,CAAC,KAAK,IAAI,CAAC,EACf,IAAI,CAAC,SAAS,IAAI,SAAS,EAC3B,IAAI,CAAC,MAAM,IAAI,SAAS,EACxB,EAAE,MAAM,EAAE,CACX,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,MAAM,KAAK,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;;QACnD,cAAc,CAAC,QAAQ,EAAE,MAAyB,EAAE,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/state/index.js

@@ -0,0 +1,60 @@
+/**
+ * Public surface for the `state <name>` command family.
+ *
+ * The `cmdState` entry point validates the incoming args, loads the
+ * schema directory, and dispatches to the per-state-family handler
+ * in `STATE_COMMAND_HANDLERS`. The `isPortedStateCommand` predicate
+ * is the public surface used by `cli/dispatch.ts` to decide whether
+ * a top-level token is a state command or a deprecated alias.
+ */
+import { COMMAND_FILTERS, validateFilterValues } from "../../stateQuery.js";
+import { loadSchemas, discoverSchemasDir } from "../../appContext.js";
+import { err } from "./shared.js";
+import { queryProgress } from "./progress.js";
+import { queryPlan } from "./plan.js";
+import { queryHealth } from "./health.js";
+import { queryDocs } from "./docs.js";
+import { queryObjective } from "./objective.js";
+import { queryExperiments } from "./experiments.js";
+import { queryTodo, normalizeSeverity } from "./todo.js";
+import { queryDecisions, decisionContextEntry, decisionSatisfactionContext, decisionSourceContract, extractDecisionEntries, hydrateDecisionEntries, displayFields, } from "./decisions.js";
+import { StateRetrievalFailure } from "../../../state/directRetrieval.js";
+import { emitStructured } from "../../structured.js";
+export { queryProgress, queryPlan, queryHealth, queryDocs, queryObjective, queryExperiments, queryTodo, queryDecisions, normalizeSeverity, decisionContextEntry, decisionSatisfactionContext, decisionSourceContract, extractDecisionEntries, hydrateDecisionEntries, displayFields, };
+const STATE_COMMAND_HANDLERS = {
+    progress: queryProgress,
+    plan: queryPlan,
+    health: queryHealth,
+    docs: queryDocs,
+    objective: queryObjective,
+    experiments: queryExperiments,
+    todo: queryTodo,
+    decisions: queryDecisions,
+};
+export function isPortedStateCommand(command) {
+    return command in STATE_COMMAND_HANDLERS;
+}
+export function cmdState(args, io) {
+    const e = err(io);
+    try {
+        validateFilterValues(args, COMMAND_FILTERS[args.command] ?? []);
+        if (args.limit !== null && args.limit !== undefined && args.limit < 0) {
+            throw new Error("limit must be zero or greater");
+        }
+        const schemas = loadSchemas(discoverSchemasDir());
+        const handler = STATE_COMMAND_HANDLERS[args.command];
+        return handler(args, schemas, io);
+    }
+    catch (exc) {
+        if (exc instanceof StateRetrievalFailure) {
+            if (args.format === "json" || args.format === "yaml")
+                emitStructured(exc.body, args.format, io.out ?? ((text) => process.stdout.write(text)));
+            else
+                e(`Error: ${exc.body.error.message}\nSyntax: ${exc.body.error.syntax}\nRecovery: ${exc.body.error.recovery}\n`);
+            return exc.exitCode;
+        }
+        e(`Error: ${exc.message}\n`);
+        return 2;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/state/index.js.map

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

package/dist/cli/commands/state/list.js

@@ -0,0 +1,176 @@
+import { resolveSourceRoot } from "../../../core/sourceRoot.js";
+import { StateRetrievalFailure } from "../../../state/directRetrieval.js";
+import { emitStructured } from "../../structured.js";
+import { listProgressEntities, renderProgressEntityListText } from "../../../state/progressEntities.js";
+import { listDecisionEntities } from "../../../state/decisionEntities.js";
+import { listHealthEntities } from "../../../state/healthEntities.js";
+import { listObjectiveEntities } from "../../../state/objectiveExperimentEntities.js";
+import { listTodoDocsEntities } from "../../../state/todoDocsEntities.js";
+import YAML from "yaml";
+const ENTITY_LIST_ARTIFACTS = ["progress", "decisions", "health", "objective", "todo", "docs"];
+function requestedFormat(argv) {
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === "--format") {
+            const value = argv[index + 1];
+            if (value === "json" || value === "yaml")
+                return value;
+        }
+        if (token.startsWith("--format=")) {
+            const value = token.slice("--format=".length);
+            if (value === "json" || value === "yaml")
+                return value;
+        }
+    }
+    return "text";
+}
+function syntax(artifactId) {
+    return `agentera state ${artifactId} list [--limit N] [--cursor TOKEN] --format json`;
+}
+function failure(className, artifactId, message, example = `agentera state ${artifactId} list --limit 20 --format json`, validValues) {
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: className,
+            message,
+            syntax: syntax(artifactId),
+            example,
+            recovery: "Correct the command using the valid syntax and retry; no state was changed.",
+            artifact_id: artifactId,
+            ...(validValues ? { valid_values: validValues } : {}),
+        },
+    }, 2);
+}
+function readValue(argv, index, name) {
+    const token = argv[index];
+    if (token.startsWith(`${name}=`))
+        return { value: token.slice(name.length + 1), next: index + 1 };
+    const value = argv[index + 1];
+    if (!value || value.startsWith("--"))
+        throw new Error(`${name} requires a value`);
+    return { value, next: index + 2 };
+}
+function parseListArgs(artifactId, argv) {
+    const validValues = ENTITY_LIST_ARTIFACTS;
+    if (!validValues.includes(artifactId)) {
+        throw failure("unsupported_artifact", artifactId, `unsupported state artifact '${artifactId}'`, undefined, validValues);
+    }
+    let limit = 20;
+    let cursor;
+    let format = "text";
+    const filters = {};
+    const allowedFilters = artifactId === "progress" ? new Set(["--topic", "--status"]) : artifactId === "decisions" ? new Set(["--topic"]) : artifactId === "todo" ? new Set(["--severity", "--status"]) : artifactId === "docs" ? new Set(["--topic", "--status"]) : artifactId === "objective" ? new Set() : new Set(["--dimension"]);
+    let limitSupplied = false;
+    let cursorSupplied = false;
+    let formatSupplied = false;
+    const filterSupplied = new Set();
+    for (let index = 0; index < argv.length;) {
+        const token = argv[index];
+        const name = token.startsWith("--limit") ? "--limit" : token.startsWith("--cursor") ? "--cursor" : token.startsWith("--format") ? "--format" : [...allowedFilters].find((filter) => token === filter || token.startsWith(`${filter}=`)) ?? null;
+        if (!name)
+            throw failure("invalid_request", artifactId, `unrecognized argument '${token}'`);
+        let parsed;
+        try {
+            parsed = readValue(argv, index, name);
+        }
+        catch (error) {
+            throw failure("invalid_request", artifactId, error.message);
+        }
+        index = parsed.next;
+        if (name === "--limit") {
+            if (limitSupplied)
+                throw failure("invalid_request", artifactId, "--limit may only be supplied once");
+            limitSupplied = true;
+            if (!/^[1-9][0-9]*$/.test(parsed.value))
+                throw failure("invalid_request", artifactId, "argument --limit must be a positive canonical integer from 1 through 100");
+            limit = Number(parsed.value);
+            if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+                throw failure("invalid_request", artifactId, "argument --limit must be between 1 and 100", `agentera state ${artifactId} list --limit 20 --format json`);
+        }
+        else if (name === "--cursor") {
+            if (cursorSupplied)
+                throw failure("invalid_request", artifactId, "--cursor may only be supplied once");
+            cursorSupplied = true;
+            if (parsed.value.length === 0)
+                throw failure("invalid_request", artifactId, "argument --cursor must be a non-empty opaque token");
+            cursor = parsed.value;
+        }
+        else {
+            if (name !== "--format") {
+                if (filterSupplied.has(name))
+                    throw failure("invalid_request", artifactId, `${name} may only be supplied once`);
+                filterSupplied.add(name);
+                const key = name.slice(2);
+                filters[key] = parsed.value;
+                continue;
+            }
+            if (formatSupplied)
+                throw failure("invalid_request", artifactId, "--format may only be supplied once");
+            formatSupplied = true;
+            if (parsed.value !== "text" && parsed.value !== "json" && parsed.value !== "yaml") {
+                throw failure("invalid_request", artifactId, `argument --format: invalid choice: '${parsed.value}' (choose from 'text', 'json', 'yaml')`);
+            }
+            format = parsed.value;
+        }
+    }
+    return { limit, ...(cursor ? { cursor } : {}), format, filters };
+}
+function emitFailure(error, format, io) {
+    const out = io.out ?? ((text) => process.stdout.write(text));
+    if (format === "json" || format === "yaml")
+        emitStructured(error.body, format, out);
+    else {
+        const details = error.body.error;
+        out([
+            `Error: ${details.message}`,
+            `Class: ${details.class}`,
+            `Syntax: ${details.syntax}`,
+            `Example: ${details.example}`,
+            `Recovery: ${details.recovery}`,
+        ].join("\n") + "\n");
+    }
+    return error.exitCode;
+}
+export function runStateList(artifactId, argv, io, projectRoot = process.cwd()) {
+    const format = requestedFormat(argv);
+    const sourceRoot = resolveSourceRoot();
+    try {
+        const args = parseListArgs(artifactId, argv);
+        const response = artifactId === "progress"
+            ? listProgressEntities(projectRoot, args.limit, args.filters, args.cursor, { sourceRoot, format: args.format })
+            : artifactId === "decisions"
+                ? listDecisionEntities(projectRoot, args.limit, args.filters.topic ?? undefined, args.cursor, { sourceRoot, format: args.format })
+                : artifactId === "health"
+                    ? listHealthEntities(projectRoot, args.limit, args.filters.dimension ?? undefined, args.cursor, { sourceRoot, format: args.format })
+                    : artifactId === "objective"
+                        ? listObjectiveEntities(projectRoot, args.limit, args.cursor, { sourceRoot, format: args.format })
+                        : listTodoDocsEntities(projectRoot, artifactId, args.limit, args.cursor, args.filters, { sourceRoot, format: args.format });
+        const output = io.out ?? ((text) => process.stdout.write(text));
+        if (args.format === "text")
+            output(artifactId === "progress" ? renderProgressEntityListText(response) : YAML.stringify(response));
+        else
+            emitStructured(response, args.format, output);
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof StateRetrievalFailure) {
+            const body = structuredClone(error.body);
+            delete body.error.artifact_id;
+            body.error.artifact = artifactId;
+            return emitFailure(new StateRetrievalFailure(body, error.exitCode), format, io);
+        }
+        return emitFailure(new StateRetrievalFailure({
+            schemaVersion: "agentera.stateFailure.v1",
+            status: "fail",
+            error: {
+                class: "unsupported_state",
+                message: error.message,
+                syntax: syntax(artifactId),
+                example: `agentera state ${artifactId} list --limit 20 --format json`,
+                recovery: "Use a state format supported by the storage authority, then retry.",
+            },
+        }, 1), format, io);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/state/list.js.map

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

package/dist/cli/commands/state/objective.js

@@ -0,0 +1,26 @@
+import { StateRetrievalFailure } from "../../../state/directRetrieval.js";
+import { currentObjectiveEntity } from "../../../state/objectiveExperimentEntities.js";
+import { emitStructured } from "../../structured.js";
+import { formatEntry } from "../../stateQuery.js";
+import { err, out } from "./shared.js";
+export function queryObjective(args, _schemas, io) {
+    const output = out(io);
+    try {
+        const response = currentObjectiveEntity(process.cwd());
+        if (args.format === "json" || args.format === "yaml")
+            emitStructured(response, args.format, output);
+        else
+            output(formatEntry(response.entries[0], ["id", "artifact"]) + "\n");
+        return 0;
+    }
+    catch (error) {
+        if (!(error instanceof StateRetrievalFailure))
+            throw error;
+        if (args.format === "json" || args.format === "yaml")
+            emitStructured(error.body, args.format, output);
+        else
+            err(io)(`Error: ${error.body.error.message}\nRecovery: ${error.body.error.recovery}\n`);
+        return error.exitCode;
+    }
+}
+//# sourceMappingURL=objective.js.map

package/dist/cli/commands/state/objective.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objective.js","sourceRoot":"","sources":["../../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/state/objective.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,GAAG,EAA2B,MAAM,aAAa,CAAC;AAEhE,MAAM,UAAU,cAAc,CAAC,IAAe,EAAE,QAAoC,EAAE,EAAM;IAC1F,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;YAAE,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;YAC/F,MAAM,CAAC,WAAW,CAAE,QAAQ,CAAC,OAAwB,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3F,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,qBAAqB,CAAC;YAAE,MAAM,KAAK,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;YAAE,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;YACjG,GAAG,CAAC,EAAE,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,eAAe,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC7F,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/cli/commands/state/plan.js

@@ -0,0 +1,15 @@
+import { emitStructured } from "../../structured.js";
+import { currentPlanEntityView } from "../../../state/planEntities.js";
+import YAML from "yaml";
+import { out } from "./shared.js";
+export function queryPlan(args, _schemas, io) {
+    const format = args.format ?? "text";
+    const response = currentPlanEntityView(process.cwd(), args.limit ?? undefined, args.cursor ?? undefined, args.status ?? undefined, { format });
+    const output = out(io);
+    if (format === "text")
+        output(YAML.stringify(response));
+    else
+        emitStructured(response, format, output);
+    return 0;
+}
+//# sourceMappingURL=plan.js.map

package/dist/cli/commands/state/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/state/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,GAAG,EAA2B,MAAM,aAAa,CAAC;AAE3D,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,QAAoC,EAAE,EAAM;IACrF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IACrC,MAAM,QAAQ,GAAG,qBAAqB,CACpC,OAAO,CAAC,GAAG,EAAE,EACb,IAAI,CAAC,KAAK,IAAI,SAAS,EACvB,IAAI,CAAC,MAAM,IAAI,SAAS,EACxB,IAAI,CAAC,MAAM,IAAI,SAAS,EACxB,EAAE,MAAM,EAAE,CACX,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,MAAM,KAAK,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;;QACnD,cAAc,CAAC,QAAQ,EAAE,MAAyB,EAAE,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/state/planTasks.js

@@ -0,0 +1,142 @@
+import YAML from "yaml";
+import { StateRetrievalFailure } from "../../../state/directRetrieval.js";
+import { getPlanTaskEntity, listPlanTaskEntities } from "../../../state/planEntities.js";
+import { emitStructured } from "../../structured.js";
+function requestedFormat(argv) {
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        const value = token === "--format" ? argv[index + 1] : token.startsWith("--format=") ? token.slice(9) : undefined;
+        if (value === "json" || value === "yaml")
+            return value;
+    }
+    return "text";
+}
+function readValue(argv, index, name) {
+    const token = argv[index];
+    if (token.startsWith(`${name}=`))
+        return { value: token.slice(name.length + 1), next: index + 1 };
+    const value = argv[index + 1];
+    if (!value || value.startsWith("--"))
+        throw new Error(`${name} requires a value`);
+    return { value, next: index + 2 };
+}
+function failure(message, verb) {
+    const list = verb === "list";
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: "invalid_request",
+            message,
+            syntax: list
+                ? "agentera state plan tasks list [PLAN_ID] [--limit N] [--cursor TOKEN] --format json"
+                : "agentera state plan tasks get --id ID --format json",
+            example: list
+                ? "agentera state plan tasks list abcdefghij --limit 20 --format json"
+                : "agentera state plan tasks get --id qjtrmnpvka --format json",
+            recovery: "Correct the command using one of the valid forms and retry; no state was changed.",
+            valid_values: list
+                ? ["list", "PLAN_ID", "--limit 1..100", "--cursor TOKEN", "--format text|json|yaml"]
+                : ["get", "--id ID", "--format text|json|yaml"],
+        },
+    }, 2);
+}
+function parse(argv, verb) {
+    let format = "text";
+    let plan;
+    let limit = 20;
+    let cursor;
+    let id;
+    const seen = new Set();
+    for (let index = 0; index < argv.length;) {
+        const token = argv[index];
+        if (verb === "list" && !token.startsWith("--")) {
+            if (plan)
+                throw failure(`unrecognized argument '${token}'`, verb);
+            plan = token;
+            index += 1;
+            continue;
+        }
+        const allowed = verb === "list" ? ["--format", "--limit", "--cursor"] : ["--format", "--id"];
+        const name = allowed.find((flag) => token === flag || token.startsWith(`${flag}=`));
+        if (!name)
+            throw failure(`unrecognized argument '${token}'`, verb);
+        if (seen.has(name))
+            throw failure(`${name} may only be supplied once`, verb);
+        seen.add(name);
+        let parsed;
+        try {
+            parsed = readValue(argv, index, name);
+        }
+        catch (error) {
+            throw failure(error.message, verb);
+        }
+        index = parsed.next;
+        if (name === "--format") {
+            if (!["text", "json", "yaml"].includes(parsed.value))
+                throw failure(`invalid --format '${parsed.value}'`, verb);
+            format = parsed.value;
+        }
+        else if (name === "--limit") {
+            if (!/^[1-9][0-9]*$/.test(parsed.value))
+                throw failure("--limit must be an integer from 1 through 100", verb);
+            limit = Number(parsed.value);
+        }
+        else if (name === "--cursor")
+            cursor = parsed.value;
+        else
+            id = parsed.value;
+    }
+    if (verb === "get" && !id)
+        throw failure("entity mode requires --id ID and rejects numeric --task selectors", verb);
+    return { format, limit, ...(plan ? { plan } : {}), ...(cursor ? { cursor } : {}), ...(id ? { id } : {}) };
+}
+function emitFailure(error, format, io) {
+    if (format === "json" || format === "yaml")
+        emitStructured(error.body, format, io.out ?? ((text) => process.stdout.write(text)));
+    else {
+        const detail = error.body.error;
+        (io.err ?? ((text) => process.stderr.write(text)))([
+            `Error: ${detail.message}`,
+            `Class: ${detail.class}`,
+            `Valid forms: ${(detail.valid_values ?? [detail.syntax]).join("; ")}`,
+            `Example: ${detail.example}`,
+            `Recovery: ${detail.recovery}`,
+        ].join("\n") + "\n");
+    }
+    return error.exitCode;
+}
+export function runPlanTasks(argv, io) {
+    const format = requestedFormat(argv);
+    const verb = argv[0];
+    if (verb !== "list" && verb !== "get")
+        return emitFailure(failure(`expected 'list' or 'get', received '${verb ?? "nothing"}'`, "list"), format, io);
+    try {
+        const args = parse(argv.slice(1), verb);
+        const response = verb === "list"
+            ? listPlanTaskEntities(process.cwd(), args.plan, args.limit, args.cursor, { format: args.format })
+            : getPlanTaskEntity(process.cwd(), args.id);
+        const output = io.out ?? ((text) => process.stdout.write(text));
+        if (args.format === "json" || args.format === "yaml")
+            emitStructured(response, args.format, output);
+        else
+            output(YAML.stringify(response));
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof StateRetrievalFailure)
+            return emitFailure(error, format, io);
+        return emitFailure(new StateRetrievalFailure({
+            schemaVersion: "agentera.stateFailure.v1",
+            status: "fail",
+            error: {
+                class: "unsupported_state",
+                message: error.message,
+                syntax: "agentera state plan tasks {list|get} [options]",
+                example: "agentera state plan tasks list --format json",
+                recovery: "Use a supported active plan and retry; no state was changed.",
+            },
+        }, 1), format, io);
+    }
+}
+//# sourceMappingURL=planTasks.js.map