agentera 3.0.0-dev.6 → 3.0.0-dev.7

package/dist/cli/dispatch/prime.js

@@ -1,16 +1,20 @@
 import { cmdPrime } from "../commands/prime.js";
 import { cmdCapability } from "../commands/capability.js";
+import { makeArgvValueReader } from "./argvParser.js";
 import { asEnvelopeFormat } from "./shared.js";
 import { emitInvalidInput } from "../errors.js";
 export function runCapability(command, argv, io, prog) {
     let format = "text";
-    for (let i = 0; i < argv.length; i++) {
+    let i = 0;
+    const value = makeArgvValueReader(argv, () => i, (n) => {
+        i = n;
+    });
+    for (; 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);
+        if ((v = value("--format")) !== null) {
+            // format handled below
+        }
         else if (a === "--fields" || a.startsWith("--fields=")) {
             // accepted by the parser but unused by capability routing
             if (a === "--fields")
@@ -23,17 +27,19 @@ export function runCapability(command, argv, io, prog) {
                 body: { class: "unrecognized_argument", message: `unrecognized arguments: ${a}` },
             });
         }
-        if (v !== "text" && v !== "json" && v !== "yaml") {
-            return emitInvalidInput(io, {
-                format: asEnvelopeFormat(format),
-                body: {
-                    class: "invalid_choice",
-                    message: `argument --format: invalid choice: '${v}' (choose from 'text', 'json', 'yaml')`,
-                    valid_values: ["text", "json", "yaml"],
-                },
-            });
+        if (v !== null) {
+            if (v !== "text" && v !== "json" && v !== "yaml") {
+                return emitInvalidInput(io, {
+                    format: asEnvelopeFormat(format),
+                    body: {
+                        class: "invalid_choice",
+                        message: `argument --format: invalid choice: '${v}' (choose from 'text', 'json', 'yaml')`,
+                        valid_values: ["text", "json", "yaml"],
+                    },
+                });
+            }
+            format = v;
         }
-        format = v;
     }
     try {
         return cmdCapability(command, { format }, io);
@@ -47,7 +53,11 @@ export function runCapability(command, argv, io, prog) {
 }
 export function runPrime(command, argv, io, prog) {
     const args = { command, guidance: false, context: null, dashboard: false, orientation: false, format: "text" };
-    for (let i = 0; i < argv.length; i++) {
+    let i = 0;
+    const value = makeArgvValueReader(argv, () => i, (n) => {
+        i = n;
+    });
+    for (; i < argv.length; i++) {
         const a = argv[i];
         let v = null;
         if (a === "--guidance")
@@ -56,12 +66,9 @@ export function runPrime(command, argv, io, prog) {
             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);
+        else if ((v = value("--context")) !== null)
+            args.context = v;
+        else if ((v = value("--format")) !== null) {
             if (v !== "text" && v !== "json" && v !== "yaml") {
                 return emitInvalidInput(io, {
                     format: asEnvelopeFormat(args.format),
@@ -74,11 +81,8 @@ export function runPrime(command, argv, io, prog) {
             }
             args.format = v;
         }
-        else if (a === "--fields") {
-            args.fields = argv[++i];
-        }
-        else if (a.startsWith("--fields=")) {
-            args.fields = a.slice("--fields=".length);
+        else if ((v = value("--fields")) !== null) {
+            args.fields = v;
         }
         else {
             return emitInvalidInput(io, {

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

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

package/dist/cli/dispatch/state.js

@@ -1,6 +1,7 @@
 import { cmdState } from "../commands/state/index.js";
 import { COMMAND_FILTERS } from "../stateQuery.js";
 import { cmdQuery } from "../commands/query.js";
+import { makeArgvValueReader } from "./argvParser.js";
 import { asEnvelopeFormat, classifyParseError } from "./shared.js";
 import { emitInvalidInput } from "../errors.js";
 export function parseStateArgs(command, argv) {
@@ -15,15 +16,12 @@ export function parseStateArgs(command, argv) {
         fields: null,
     };
     const allowed = new Set([...(COMMAND_FILTERS[command] ?? []), "format", "fields"]);
-    for (let i = 0; i < argv.length; i++) {
+    let i = 0;
+    const value = makeArgvValueReader(argv, () => i, (n) => {
+        i = n;
+    });
+    for (; 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"))
@@ -85,15 +83,12 @@ export function parseQueryArgs(argv) {
         format: "text",
         fields: null,
     };
-    for (let i = 0; i < argv.length; i++) {
+    let i = 0;
+    const value = makeArgvValueReader(argv, () => i, (n) => {
+        i = n;
+    });
+    for (; 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;

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

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/cli/dispatch/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAa,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAW,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAc;IAC5D,MAAM,IAAI,GAAc;QACtB,OAAO;QACP,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;KACb,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAiB,EAAE;YAC5C,IAAI,CAAC,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,GAAW,EAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;QACnH,IAAI,CAAgB,CAAC;QACrB,IAAI,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;aACxD,IAAI,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;aACjE,IAAI,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC;YAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;aAC7E,IAAI,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;aACzE,IAAI,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;YACnC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,yCAAyC,CAAC,GAAG,EAAE,CAAC;YAC1F,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACzD,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;YACtB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACjD,OAAO,EAAE,KAAK,EAAE,uCAAuC,CAAC,wCAAwC,EAAE,CAAC;YACrG,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;;YACrF,OAAO,EAAE,KAAK,EAAE,2BAA2B,CAAC,EAAE,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAc,EAAE,EAAM,EAAE,IAAY;IAC5E,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO,gBAAgB,CAAC,EAAE,EAAE;YAC1B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,gBAAgB,CAAC,EAAE,EAAE;YAC1B,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC;YACvC,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,IAAI,GAAc;QACtB,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,KAAK;QACrB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;KACb,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAiB,EAAE;YAC5C,IAAI,CAAC,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QACF,IAAI,CAAgB,CAAC;QACrB,IAAI,CAAC,KAAK,kBAAkB;YAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;aACpD,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;aACpD,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;aAC1D,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;aAC5D,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aACtD,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,yCAAyC,CAAC,GAAG,EAAE,CAAC;YAC1F,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACjD,OAAO,EAAE,KAAK,EAAE,uCAAuC,CAAC,wCAAwC,EAAE,CAAC;YACrG,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aACxD,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,2BAA2B,CAAC,EAAE,EAAE,CAAC;aACzE,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;;YACxC,OAAO,EAAE,KAAK,EAAE,2BAA2B,CAAC,EAAE,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,EAAM,EAAE,IAAY;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO,gBAAgB,CAAC,EAAE,EAAE;YAC1B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,gBAAgB,CAAC,EAAE,EAAE;YAC1B,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC;YACvC,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/cli/dispatch/state.ts"],"names":[],"mappings":"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"}

package/dist/cli/help.js

@@ -3,8 +3,9 @@ const TOP_LEVEL = [
     "prime",
     "schema",
     "state",
-    ...CAPABILITY_ROUTING_NAMES.filter((n) => n !== "hej"),
+    ...CAPABILITY_ROUTING_NAMES,
     "upgrade",
+    "app-home",
     "doctor",
     "report",
     "check",
@@ -15,7 +16,7 @@ function lines(title, items) {
 export function printTopLevelHelp() {
     const choices = TOP_LEVEL.join(",");
     return [
-        `usage: agentera [-h] {${choices}} ...`,
+        `usage: agentera [-h] [--version] {${choices}} ...`,
         "",
         "agentera: read project state, upgrade installs, and print priming guidance",
         "",
@@ -23,18 +24,21 @@ export function printTopLevelHelp() {
             "prime               Composite orientation briefing, capability startup context, or static guidance",
             "schema              Runtime CLI/schema introspection",
             "state               Routine artifact reads and advanced artifact query",
-            ...CAPABILITY_ROUTING_NAMES.filter((n) => n !== "hej").map((name) => `${name.padEnd(19)} Route to ${name} capability guidance`),
+            ...CAPABILITY_ROUTING_NAMES.map((name) => `${name.padEnd(19)} Route to ${name} capability guidance`),
         ]),
         ...lines("User commands:", [
             "upgrade             Plan or apply an idempotent upgrade with semver/channel gate",
+            "app-home            Resolve the platform Agentera app-home path",
             "doctor              Check Agentera CLI, app, and runtime status",
             "report              Privacy-gated usage analytics",
+            "--version           Print the installed Agentera CLI version",
         ]),
         ...lines("Maintainer commands:", [
             "check               Validation, verification, lint, and repository compaction gates",
         ]),
         "options:",
         "  -h, --help          show this help message and exit",
+        "  --version           print the installed Agentera CLI version and exit",
         "",
         "Examples: agentera prime; agentera state plan --format json; agentera check verify eval skills --dry-run; agentera report refresh --dry-run",
     ].join("\n");
@@ -59,6 +63,19 @@ export function printUpgradeHelp() {
         "  --format {text,json}  Structured output format",
     ].join("\n");
 }
+export function printAppHomeHelp() {
+    return [
+        "usage: agentera app-home [-h] [--install-root PATH] [--home HOME] [--format {text,json}]",
+        "",
+        "Resolve the Agentera app-home path for agent/bootstrap callers.",
+        "",
+        "options:",
+        "  -h, --help            show this help message and exit",
+        "  --install-root PATH   Explicit Agentera app home to resolve",
+        "  --home HOME           Home directory for platform default resolution",
+        "  --format {text,json}  Structured output format",
+    ].join("\n");
+}
 export function printDoctorHelp() {
     return [
         "usage: agentera doctor [-h] [--install-root PATH] [--home HOME] [--project PROJECT]",
@@ -115,8 +132,21 @@ export function printReportHelp() {
     return [
         "usage: agentera report [-h] [--format {text,json}] [--project VALUE]",
         "                       | agentera report refresh [--dry-run|--consent local-history]",
+        "                         [--no-<runtime> ...] [--accept-coverage-gap]",
         "",
         "Privacy-gated usage analytics over an existing corpus.",
+        "",
+        "Corpus extraction flags (report refresh with --consent local-history):",
+        "  These flags deselect runtimes that would otherwise be included when their",
+        "  store exists. Full-mode profile runs a Coverage Audit first; skipping an",
+        "  available runtime flags the run until --accept-coverage-gap is passed.",
+        "  --no-codex            Skip codex even if ~/.codex/sessions exists",
+        "  --no-claude           Skip claude-code even if ~/.claude/projects exists",
+        "  --no-opencode         Skip opencode even if the opencode.db store exists",
+        "  --no-copilot          Skip github-copilot even if session-store.db exists",
+        "  --no-cursor           Skip cursor and cursor-agent stores",
+        "  --accept-coverage-gap Proceed despite skipped available runtimes (EX2)",
+        "  --coverage-audit-only Run the Coverage Audit summary only; do not extract",
     ].join("\n");
 }
 export function printPrimeHelp() {
@@ -127,11 +157,11 @@ export function printPrimeHelp() {
         "Composite orientation briefing, capability startup context, or static guidance.",
         "",
         "options:",
-        "  -h, --help            show this help message and exit",
+        "  -h, --help            show this help message and end",
         "  --format FORMAT       Output format: text, json, or yaml",
-        "  --context CAPABILITY  Emit startup context for a capability (e.g. planera)",
+        "  --context CAPABILITY  Emit startup context for a capability (e.g. plan)",
         "  --guidance            Emit static routing guidance",
-        "  --dashboard           Emit the hej orientation dashboard",
+        "  --dashboard           Emit the prime orientation dashboard",
         "  --orientation         Emit orientation briefing sections",
         "  --fields FIELDS       Comma-separated field filter for JSON/YAML output",
     ].join("\n");
@@ -169,6 +199,8 @@ export function printCommandHelp(command, rest = []) {
             return printSchemaHelp();
         case "upgrade":
             return printUpgradeHelp();
+        case "app-home":
+            return printAppHomeHelp();
         case "doctor":
             return printDoctorHelp();
         case "state":
@@ -180,6 +212,9 @@ export function printCommandHelp(command, rest = []) {
             return printReportHelp();
         case "verify":
             return printCheckHelp("verify");
+        case "--version":
+        case "version":
+            return "usage: agentera --version [--format {text,json}]\n\nPrint the installed Agentera CLI version.\n";
         default:
             if (CAPABILITY_ROUTING_NAMES.includes(command)) {
                 return printCapabilityHelp(command);

package/dist/cli/help.js.map

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

package/dist/cli/orientation/attention.js

@@ -0,0 +1,61 @@
+import { projectIntegrationAttention } from "../../upgrade/projectIntegration.js";
+import { isV2ManagedInstallAtAppHome } from "../../upgrade/coexistenceProbe.js";
+import { corpusCoverageAttention } from "./corpusCoverage.js";
+import { firstPresent } from "../stateQuery.js";
+import { TODO_SEVERITY_ORDER } from "../todoSeverity.js";
+export function buildOrientationAttention(state) {
+    const { profile_status: profileStatus, profile, profile_dict: profileDict, v1_migration: v1Migration, project_integration: projectIntegration, health, plan, decision_attention: decisionAttention, corpus_coverage: corpusCoverage, todo_items: todoItems, } = state;
+    const attention = [];
+    if (isV2ManagedInstallAtAppHome(state.app.appHome)) {
+        attention.push(`normal: v2/v3 coexistence at ${state.app.appHome}; pick one line: complete v3 migration, uninstall v3, or stay on v2`);
+    }
+    const integrationAttention = projectIntegrationAttention(projectIntegration);
+    if (integrationAttention) {
+        attention.push(integrationAttention);
+    }
+    const coverageAttention = corpusCoverageAttention(corpusCoverage);
+    if (coverageAttention) {
+        attention.push(coverageAttention);
+    }
+    if (v1Migration.detected && projectIntegration.recommendation !== "upgrade") {
+        attention.push(`degraded: v1 artifacts detected; preview \`${v1Migration.dry_run_command}\`; files=${v1Migration.affected_files.join(", ")}`);
+    }
+    if (profileStatus === "not found") {
+        attention.push(`degraded: PROFILE.md not found at ${profile}; suggest running profile to generate PROFILE.md`);
+    }
+    else if (profileDict.stale) {
+        const daysSince = profileDict.days_since_generated ?? "?";
+        const staleDays = profileDict.stale_threshold_days ?? "?";
+        attention.push(`normal: profile stale (${daysSince} days since last refresh; ` +
+            `threshold=${staleDays}); suggest running profile to refresh PROFILE.md`);
+    }
+    if (health.stale) {
+        const auditNumber = health.number ?? "?";
+        const daysSince = health.days_since_audit ?? "?";
+        const thresholdDays = health.stale_threshold_days ?? "?";
+        const thresholdCycles = health.stale_threshold_cycles ?? "?";
+        let attentionText = `normal: audit stale (${daysSince} days since Audit ${auditNumber}; ` +
+            `threshold days=${thresholdDays}, cycles=${thresholdCycles}`;
+        const cyclesSince = health.cycles_since_audit;
+        if (cyclesSince !== null && cyclesSince !== undefined)
+            attentionText += `; ${cyclesSince} cycles since audit`;
+        attention.push(`${attentionText}); suggest running audit`);
+    }
+    if (health.degrading) {
+        const worst = health.worst;
+        attention.push(worst ? `critical: health needs attention (${worst[0]}:${worst[1]})` : "critical: health is degrading");
+    }
+    const pending = plan.first_pending;
+    if (pending && typeof pending === "object" && !Array.isArray(pending)) {
+        const title = firstPresent(pending, ["name", "title"], "pending task");
+        attention.push(`normal: PLAN Task ${pending.number ?? "?"}: ${title}`);
+    }
+    if (decisionAttention !== null)
+        attention.push(String(decisionAttention.attention));
+    if (!(pending && typeof pending === "object" && !Array.isArray(pending)) && todoItems.length > 0) {
+        const firstTodo = [...todoItems].sort((a, b) => (TODO_SEVERITY_ORDER[a.severity] ?? 2) - (TODO_SEVERITY_ORDER[b.severity] ?? 2))[0];
+        attention.push(`${firstTodo.severity}: TODO: ${firstTodo.text}`);
+    }
+    return attention;
+}
+//# sourceMappingURL=attention.js.map

package/dist/cli/orientation/attention.js.map

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

package/dist/cli/orientation/corpusCoverage.js

@@ -0,0 +1,71 @@
+import fs from "node:fs";
+import { corpusTooLargeReason } from "../../analytics/usageStats.js";
+import { statsCorpusPath } from "../commands/report.js";
+function emptyCoverageSummary(path, status) {
+    return {
+        path,
+        status,
+        available_runtimes: [],
+        selected_runtimes: [],
+        available_but_not_selected: [],
+    };
+}
+function parseCoverageGap(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const item = value;
+    const runtime = item.runtime;
+    const reason = item.reason;
+    if (typeof runtime !== "string" || typeof reason !== "string")
+        return null;
+    const gap = { runtime, reason };
+    if (typeof item.store_path === "string")
+        gap.store_path = item.store_path;
+    return gap;
+}
+export function corpusCoverageSummary(env = process.env, platform = process.platform) {
+    const corpusPath = statsCorpusPath(env, platform);
+    if (!fs.existsSync(corpusPath))
+        return emptyCoverageSummary(corpusPath, "missing");
+    const tooLarge = corpusTooLargeReason(corpusPath);
+    if (tooLarge)
+        return emptyCoverageSummary(corpusPath, "too_large");
+    let data;
+    try {
+        data = JSON.parse(fs.readFileSync(corpusPath, "utf8"));
+    }
+    catch {
+        return emptyCoverageSummary(corpusPath, "unreadable");
+    }
+    const metadata = data && typeof data === "object" && !Array.isArray(data) && "metadata" in data
+        ? data.metadata
+        : null;
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+        return emptyCoverageSummary(corpusPath, "unreadable");
+    }
+    const md = metadata;
+    const availableRuntimes = Array.isArray(md.available_runtimes)
+        ? md.available_runtimes.filter((item) => typeof item === "string")
+        : [];
+    const selectedRuntimes = Array.isArray(md.selected_runtimes)
+        ? md.selected_runtimes.filter((item) => typeof item === "string")
+        : [];
+    const skipped = Array.isArray(md.available_but_not_selected)
+        ? md.available_but_not_selected.map(parseCoverageGap).filter((item) => item !== null)
+        : [];
+    return {
+        path: corpusPath,
+        status: "loaded",
+        available_runtimes: availableRuntimes,
+        selected_runtimes: selectedRuntimes,
+        available_but_not_selected: skipped,
+    };
+}
+export function corpusCoverageAttention(summary) {
+    if (summary.available_but_not_selected.length === 0)
+        return null;
+    const skipped = summary.available_but_not_selected.map((item) => `${item.runtime} (${item.reason})`).join(", ");
+    return (`flagged: corpus coverage loss (EX2): available runtimes skipped (${skipped}); ` +
+        "suggest running profile stats refresh without --no-* flags");
+}
+//# sourceMappingURL=corpusCoverage.js.map

package/dist/cli/orientation/corpusCoverage.js.map

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