@evalops/maestro 0.10.42 → 0.10.43

package/dist/cli/commands/operating-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operating-plane.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/operating-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE3B,MAAM,0CAA0C,CAAC;AAMlD,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,kCAAkC;IAClD,OAAO,CAAC,EAAE,CACT,KAAK,EAAE,sBAAsB,KACzB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAqBD,wBAAsB,2BAA2B,CAChD,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,kCAAuC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,MAAM,EAAE,GACZ,wBAAwB,CA8C1B"}
+{"version":3,"file":"operating-plane.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/operating-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE3B,MAAM,0CAA0C,CAAC;AAMlD,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,kCAAkC;IAClD,OAAO,CAAC,EAAE,CACT,KAAK,EAAE,sBAAsB,KACzB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAsBD,wBAAsB,2BAA2B,CAChD,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,kCAAuC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,MAAM,EAAE,GACZ,wBAAwB,CA8C1B"}

package/dist/cli/commands/operating-plane.js

@@ -2,6 +2,7 @@ import { inspectOperatingPlaneRuns, } from "../../platform/operating-plane-clien
 import { formatOperatingPlaneStatusReport, summarizeOperatingPlaneInspection, } from "../../platform/operating-plane-summary.js";
 const VALUE_FLAGS = new Set([
     "--agent-id",
+    "--artifact-id",
     "--audience",
     "--auth-subject",
     "--autonomy-session-id",
@@ -90,7 +91,7 @@ function queryFromFlags(flags) {
         channelThreadId: flagString(flags, "--channel-thread-id"),
         traceId: flagString(flags, "--trace-id"),
         sessionId: flagString(flags, "--session-id"),
-        evidenceId: flagString(flags, "--evidence-id"),
+        evidenceId: flagString(flags, "--artifact-id") ?? flagString(flags, "--evidence-id"),
         gatewayAuthenticatedSubject: flagString(flags, "--gateway-authenticated-subject") ??
             flagString(flags, "--auth-subject"),
         audience: flagString(flags, "--audience"),
@@ -146,7 +147,7 @@ function operatingPlaneHelpText() {
 
 Filters:
   --thread-id <id>                  Slack/channel thread id
-  --evidence-id <id>                Evidence ref id
+  --artifact-id <id>                Runtime artifact ref id
   --auth-subject <subject>          Gateway-authenticated subject
   --trace-id <id>                   Trace id
   --session-id <id>                 Maestro/session id

package/dist/cli/commands/operating-plane.js.map

@@ -1 +1 @@
-{"version":3,"file":"operating-plane.js","sourceRoot":"","sources":["../../../src/cli/commands/operating-plane.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype OperatingPlaneInspection,\n\ttype OperatingPlaneRunQuery,\n\tinspectOperatingPlaneRuns,\n} from \"../../platform/operating-plane-client.js\";\nimport {\n\tformatOperatingPlaneStatusReport,\n\tsummarizeOperatingPlaneInspection,\n} from \"../../platform/operating-plane-summary.js\";\n\nexport interface ParsedOperatingPlaneArgs {\n\tsubcommand: string;\n\tquery: OperatingPlaneRunQuery;\n\tjson: boolean;\n\thelp: boolean;\n}\n\nexport interface HandleOperatingPlaneCommandOptions {\n\tinspect?: (\n\t\tquery: OperatingPlaneRunQuery,\n\t) => Promise<OperatingPlaneInspection>;\n\twrite?: (line: string) => void;\n}\n\nconst VALUE_FLAGS = new Set([\n\t\"--agent-id\",\n\t\"--audience\",\n\t\"--auth-subject\",\n\t\"--autonomy-session-id\",\n\t\"--channel-thread-id\",\n\t\"--evidence-id\",\n\t\"--gateway-authenticated-subject\",\n\t\"--limit\",\n\t\"--run-id\",\n\t\"--session-id\",\n\t\"--thread-id\",\n\t\"--trace-id\",\n\t\"--work-envelope-id\",\n\t\"--workspace-id\",\n]);\n\nconst BOOLEAN_FLAGS = new Set([\"--help\", \"--include-gates\", \"--json\"]);\n\nexport async function handleOperatingPlaneCommand(\n\targs: string[],\n\toptions: HandleOperatingPlaneCommandOptions = {},\n): Promise<void> {\n\tconst parsed = parseOperatingPlaneArgs(args);\n\tconst write = options.write ?? ((line: string) => console.log(line));\n\tif (parsed.help || parsed.subcommand === \"help\") {\n\t\twrite(operatingPlaneHelpText());\n\t\treturn;\n\t}\n\tif (parsed.subcommand !== \"status\" && parsed.subcommand !== \"inspect\") {\n\t\tthrow new Error(`Unknown operating-plane command: ${parsed.subcommand}`);\n\t}\n\n\tconst inspect = options.inspect ?? inspectOperatingPlaneRuns;\n\tconst inspection = await inspect(parsed.query);\n\tconst report = summarizeOperatingPlaneInspection(inspection);\n\twrite(\n\t\tparsed.json\n\t\t\t? JSON.stringify(report, null, 2)\n\t\t\t: formatOperatingPlaneStatusReport(report),\n\t);\n}\n\nexport function parseOperatingPlaneArgs(\n\targs: string[],\n): ParsedOperatingPlaneArgs {\n\tconst positionals: string[] = [];\n\tconst flags = new Map<string, string | boolean>();\n\tfor (let index = 0; index < args.length; index++) {\n\t\tconst arg = args[index];\n\t\tif (!arg) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--\") {\n\t\t\tpositionals.push(...args.slice(index + 1));\n\t\t\tbreak;\n\t\t}\n\t\tif (!arg.startsWith(\"--\")) {\n\t\t\tpositionals.push(arg);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst [flag, inlineValue] = arg.split(\"=\", 2);\n\t\tif (!flag) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (!VALUE_FLAGS.has(flag) && !BOOLEAN_FLAGS.has(flag)) {\n\t\t\tthrow new Error(`Unknown operating-plane option: ${flag}`);\n\t\t}\n\t\tif (inlineValue !== undefined) {\n\t\t\tflags.set(flag, inlineValue);\n\t\t\tcontinue;\n\t\t}\n\t\tif (BOOLEAN_FLAGS.has(flag)) {\n\t\t\tflags.set(flag, true);\n\t\t\tcontinue;\n\t\t}\n\t\tconst next = args[index + 1];\n\t\tif (!next || next === \"--\" || next.startsWith(\"--\")) {\n\t\t\tthrow new Error(`${flag} requires a value`);\n\t\t}\n\t\tflags.set(flag, next);\n\t\tindex++;\n\t}\n\n\treturn {\n\t\tsubcommand: positionals.shift()?.toLowerCase() ?? \"status\",\n\t\tquery: queryFromFlags(flags),\n\t\tjson: flagBoolean(flags, \"--json\") === true,\n\t\thelp: flagBoolean(flags, \"--help\") === true,\n\t};\n}\n\nfunction queryFromFlags(\n\tflags: Map<string, string | boolean>,\n): OperatingPlaneRunQuery {\n\treturn stripUndefined({\n\t\tworkspaceId: flagString(flags, \"--workspace-id\"),\n\t\trunId: flagString(flags, \"--run-id\"),\n\t\tworkEnvelopeId: flagString(flags, \"--work-envelope-id\"),\n\t\tautonomySessionId: flagString(flags, \"--autonomy-session-id\"),\n\t\tagentId: flagString(flags, \"--agent-id\"),\n\t\tthreadId: flagString(flags, \"--thread-id\"),\n\t\tchannelThreadId: flagString(flags, \"--channel-thread-id\"),\n\t\ttraceId: flagString(flags, \"--trace-id\"),\n\t\tsessionId: flagString(flags, \"--session-id\"),\n\t\tevidenceId: flagString(flags, \"--evidence-id\"),\n\t\tgatewayAuthenticatedSubject:\n\t\t\tflagString(flags, \"--gateway-authenticated-subject\") ??\n\t\t\tflagString(flags, \"--auth-subject\"),\n\t\taudience: flagString(flags, \"--audience\") as\n\t\t\t| OperatingPlaneRunQuery[\"audience\"]\n\t\t\t| undefined,\n\t\tincludeGates: flagBoolean(flags, \"--include-gates\"),\n\t\tlimit: flagNonNegativeInt(flags, \"--limit\"),\n\t});\n}\n\nfunction flagString(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): string | undefined {\n\tconst value = flags.get(name);\n\tif (typeof value !== \"string\") {\n\t\treturn undefined;\n\t}\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction flagBoolean(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): boolean | undefined {\n\tconst value = flags.get(name);\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\tswitch (value.trim().toLowerCase()) {\n\t\tcase \"1\":\n\t\tcase \"true\":\n\t\tcase \"yes\":\n\t\t\treturn true;\n\t\tcase \"0\":\n\t\tcase \"false\":\n\t\tcase \"no\":\n\t\t\treturn false;\n\t\tdefault:\n\t\t\tthrow new Error(`${name} must be true or false`);\n\t}\n}\n\nfunction flagNonNegativeInt(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): number | undefined {\n\tconst value = flagString(flags, name);\n\tif (!value) {\n\t\treturn undefined;\n\t}\n\tconst parsed = Number.parseInt(value, 10);\n\tif (!Number.isFinite(parsed) || parsed < 0 || String(parsed) !== value) {\n\t\tthrow new Error(`${name} must be a non-negative integer`);\n\t}\n\treturn parsed;\n}\n\nfunction stripUndefined<T extends Record<string, unknown>>(value: T): T {\n\treturn Object.fromEntries(\n\t\tObject.entries(value).filter(([, entry]) => entry !== undefined),\n\t) as T;\n}\n\nfunction operatingPlaneHelpText(): string {\n\treturn `Usage: maestro operating-plane status [filters]\n\nFilters:\n  --thread-id <id>                  Slack/channel thread id\n  --evidence-id <id>                Evidence ref id\n  --auth-subject <subject>          Gateway-authenticated subject\n  --trace-id <id>                   Trace id\n  --session-id <id>                 Maestro/session id\n  --run-id <id>                     Agent runtime run id\n  --workspace-id <id>               Workspace id\n  --audience <audience>             agent, channel, audit, system, ...\n  --include-gates=<true|false>      Include release/replay gates\n  --limit <n>                       Maximum runs\n  --json                            Emit safe summary JSON`;\n}\n"]}
+{"version":3,"file":"operating-plane.js","sourceRoot":"","sources":["../../../src/cli/commands/operating-plane.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype OperatingPlaneInspection,\n\ttype OperatingPlaneRunQuery,\n\tinspectOperatingPlaneRuns,\n} from \"../../platform/operating-plane-client.js\";\nimport {\n\tformatOperatingPlaneStatusReport,\n\tsummarizeOperatingPlaneInspection,\n} from \"../../platform/operating-plane-summary.js\";\n\nexport interface ParsedOperatingPlaneArgs {\n\tsubcommand: string;\n\tquery: OperatingPlaneRunQuery;\n\tjson: boolean;\n\thelp: boolean;\n}\n\nexport interface HandleOperatingPlaneCommandOptions {\n\tinspect?: (\n\t\tquery: OperatingPlaneRunQuery,\n\t) => Promise<OperatingPlaneInspection>;\n\twrite?: (line: string) => void;\n}\n\nconst VALUE_FLAGS = new Set([\n\t\"--agent-id\",\n\t\"--artifact-id\",\n\t\"--audience\",\n\t\"--auth-subject\",\n\t\"--autonomy-session-id\",\n\t\"--channel-thread-id\",\n\t\"--evidence-id\",\n\t\"--gateway-authenticated-subject\",\n\t\"--limit\",\n\t\"--run-id\",\n\t\"--session-id\",\n\t\"--thread-id\",\n\t\"--trace-id\",\n\t\"--work-envelope-id\",\n\t\"--workspace-id\",\n]);\n\nconst BOOLEAN_FLAGS = new Set([\"--help\", \"--include-gates\", \"--json\"]);\n\nexport async function handleOperatingPlaneCommand(\n\targs: string[],\n\toptions: HandleOperatingPlaneCommandOptions = {},\n): Promise<void> {\n\tconst parsed = parseOperatingPlaneArgs(args);\n\tconst write = options.write ?? ((line: string) => console.log(line));\n\tif (parsed.help || parsed.subcommand === \"help\") {\n\t\twrite(operatingPlaneHelpText());\n\t\treturn;\n\t}\n\tif (parsed.subcommand !== \"status\" && parsed.subcommand !== \"inspect\") {\n\t\tthrow new Error(`Unknown operating-plane command: ${parsed.subcommand}`);\n\t}\n\n\tconst inspect = options.inspect ?? inspectOperatingPlaneRuns;\n\tconst inspection = await inspect(parsed.query);\n\tconst report = summarizeOperatingPlaneInspection(inspection);\n\twrite(\n\t\tparsed.json\n\t\t\t? JSON.stringify(report, null, 2)\n\t\t\t: formatOperatingPlaneStatusReport(report),\n\t);\n}\n\nexport function parseOperatingPlaneArgs(\n\targs: string[],\n): ParsedOperatingPlaneArgs {\n\tconst positionals: string[] = [];\n\tconst flags = new Map<string, string | boolean>();\n\tfor (let index = 0; index < args.length; index++) {\n\t\tconst arg = args[index];\n\t\tif (!arg) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--\") {\n\t\t\tpositionals.push(...args.slice(index + 1));\n\t\t\tbreak;\n\t\t}\n\t\tif (!arg.startsWith(\"--\")) {\n\t\t\tpositionals.push(arg);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst [flag, inlineValue] = arg.split(\"=\", 2);\n\t\tif (!flag) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (!VALUE_FLAGS.has(flag) && !BOOLEAN_FLAGS.has(flag)) {\n\t\t\tthrow new Error(`Unknown operating-plane option: ${flag}`);\n\t\t}\n\t\tif (inlineValue !== undefined) {\n\t\t\tflags.set(flag, inlineValue);\n\t\t\tcontinue;\n\t\t}\n\t\tif (BOOLEAN_FLAGS.has(flag)) {\n\t\t\tflags.set(flag, true);\n\t\t\tcontinue;\n\t\t}\n\t\tconst next = args[index + 1];\n\t\tif (!next || next === \"--\" || next.startsWith(\"--\")) {\n\t\t\tthrow new Error(`${flag} requires a value`);\n\t\t}\n\t\tflags.set(flag, next);\n\t\tindex++;\n\t}\n\n\treturn {\n\t\tsubcommand: positionals.shift()?.toLowerCase() ?? \"status\",\n\t\tquery: queryFromFlags(flags),\n\t\tjson: flagBoolean(flags, \"--json\") === true,\n\t\thelp: flagBoolean(flags, \"--help\") === true,\n\t};\n}\n\nfunction queryFromFlags(\n\tflags: Map<string, string | boolean>,\n): OperatingPlaneRunQuery {\n\treturn stripUndefined({\n\t\tworkspaceId: flagString(flags, \"--workspace-id\"),\n\t\trunId: flagString(flags, \"--run-id\"),\n\t\tworkEnvelopeId: flagString(flags, \"--work-envelope-id\"),\n\t\tautonomySessionId: flagString(flags, \"--autonomy-session-id\"),\n\t\tagentId: flagString(flags, \"--agent-id\"),\n\t\tthreadId: flagString(flags, \"--thread-id\"),\n\t\tchannelThreadId: flagString(flags, \"--channel-thread-id\"),\n\t\ttraceId: flagString(flags, \"--trace-id\"),\n\t\tsessionId: flagString(flags, \"--session-id\"),\n\t\tevidenceId:\n\t\t\tflagString(flags, \"--artifact-id\") ?? flagString(flags, \"--evidence-id\"),\n\t\tgatewayAuthenticatedSubject:\n\t\t\tflagString(flags, \"--gateway-authenticated-subject\") ??\n\t\t\tflagString(flags, \"--auth-subject\"),\n\t\taudience: flagString(flags, \"--audience\") as\n\t\t\t| OperatingPlaneRunQuery[\"audience\"]\n\t\t\t| undefined,\n\t\tincludeGates: flagBoolean(flags, \"--include-gates\"),\n\t\tlimit: flagNonNegativeInt(flags, \"--limit\"),\n\t});\n}\n\nfunction flagString(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): string | undefined {\n\tconst value = flags.get(name);\n\tif (typeof value !== \"string\") {\n\t\treturn undefined;\n\t}\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction flagBoolean(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): boolean | undefined {\n\tconst value = flags.get(name);\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\tswitch (value.trim().toLowerCase()) {\n\t\tcase \"1\":\n\t\tcase \"true\":\n\t\tcase \"yes\":\n\t\t\treturn true;\n\t\tcase \"0\":\n\t\tcase \"false\":\n\t\tcase \"no\":\n\t\t\treturn false;\n\t\tdefault:\n\t\t\tthrow new Error(`${name} must be true or false`);\n\t}\n}\n\nfunction flagNonNegativeInt(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): number | undefined {\n\tconst value = flagString(flags, name);\n\tif (!value) {\n\t\treturn undefined;\n\t}\n\tconst parsed = Number.parseInt(value, 10);\n\tif (!Number.isFinite(parsed) || parsed < 0 || String(parsed) !== value) {\n\t\tthrow new Error(`${name} must be a non-negative integer`);\n\t}\n\treturn parsed;\n}\n\nfunction stripUndefined<T extends Record<string, unknown>>(value: T): T {\n\treturn Object.fromEntries(\n\t\tObject.entries(value).filter(([, entry]) => entry !== undefined),\n\t) as T;\n}\n\nfunction operatingPlaneHelpText(): string {\n\treturn `Usage: maestro operating-plane status [filters]\n\nFilters:\n  --thread-id <id>                  Slack/channel thread id\n  --artifact-id <id>                Runtime artifact ref id\n  --auth-subject <subject>          Gateway-authenticated subject\n  --trace-id <id>                   Trace id\n  --session-id <id>                 Maestro/session id\n  --run-id <id>                     Agent runtime run id\n  --workspace-id <id>               Workspace id\n  --audience <audience>             agent, channel, audit, system, ...\n  --include-gates=<true|false>      Include release/replay gates\n  --limit <n>                       Maximum runs\n  --json                            Emit safe summary JSON`;\n}\n"]}

package/dist/cli/help.js

@@ -252,12 +252,14 @@ export function printHelp(version, options) {
   maestro remote attach <session-id> [--verify] [--print-env]
   maestro remote extend <session-id> --ttl 2h
   maestro remote stop <session-id> [--reason <text>]`)}`;
-    const operatingPlaneSection = `${sectionHeading("maestro operating-plane")}${muted(`  maestro operating-plane status --thread-id <slack-thread> [--evidence-id <id>] [--auth-subject <subject>]
-  maestro operating-plane status --trace-id <id> --json
-
-  Fetches the Platform operating-plane ledger and prints a content-free value
-  proof report with identity, model/tool/approval/trace/evidence/cost status,
-  allowed evidence ids/revisions, blockers, next actions, and withheld reasons.`)}`;
+    const operatingPlaneHelp = [
+        "  maestro operating-plane status --thread-id <slack-thread> [--artifact-id <id>] [--auth-subject <subject>]",
+        "  maestro operating-plane status --trace-id <id> --json",
+        "  Fetches the Platform operating-plane ledger and prints content-free runtime",
+        "  status with identity, model/tool/approval/trace/artifact/cost signals,",
+        "  allowed artifact ids/revisions, blockers, next actions, and withheld reasons.",
+    ].join("\n");
+    const operatingPlaneSection = `${sectionHeading("maestro operating-plane")}${muted(operatingPlaneHelp)}`;
     const runSection = `${sectionHeading("maestro run")}${muted(`  maestro run inspect <session-id> [--json]
   maestro run ledger <session-id>
   maestro run replay <session-id>

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAO1E,MAAM,WAAW,GAAoB;IACpC,EAAE,IAAI,EAAE,+DAA+D,EAAE;IACzE,EAAE,IAAI,EAAE,qDAAqD,EAAE;IAC/D,EAAE,IAAI,EAAE,iEAAiE,EAAE;IAC3E;QACC,IAAI,EAAE,2EAA2E;KACjF;IACD;QACC,IAAI,EAAE,4FAA4F;KAClG;IACD,EAAE,IAAI,EAAE,wDAAwD,EAAE;IAClE;QACC,IAAI,EAAE,0EAA0E;KAChF;IACD;QACC,IAAI,EAAE,yEAAyE;KAC/E;IACD,EAAE,IAAI,EAAE,mEAAmE,EAAE;IAC7E;QACC,IAAI,EAAE,kEAAkE;KACxE;IACD;QACC,IAAI,EAAE,+EAA+E;KACrF;IACD;QACC,IAAI,EAAE,mHAAmH;KACzH;IACD;QACC,IAAI,EAAE,+EAA+E;KACrF;IACD,EAAE,IAAI,EAAE,mDAAmD,EAAE;IAC7D,EAAE,IAAI,EAAE,oDAAoD,EAAE;IAC9D,EAAE,IAAI,EAAE,mDAAmD,EAAE;IAC7D,EAAE,IAAI,EAAE,wDAAwD,EAAE;IAClE,EAAE,IAAI,EAAE,0DAA0D,EAAE;IACpE;QACC,IAAI,EAAE,sEAAsE;KAC5E;IACD;QACC,IAAI,EAAE,qEAAqE;KAC3E;IACD,EAAE,IAAI,EAAE,wCAAwC,EAAE;IAClD;QACC,IAAI,EAAE,qEAAqE;QAC3E,MAAM,EAAE,IAAI;KACZ;IACD;QACC,IAAI,EAAE,4DAA4D;QAClE,MAAM,EAAE,IAAI;KACZ;CACD,CAAC;AAEF,SAAS,iBAAiB,CAAC,OAAwB,EAAE,aAAsB;IAC1E,OAAO,OAAO;SACZ,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC;SAC3D,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;SAC1C,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,SAAS,CACxB,OAAe,EACf,OAAqC;IAErC,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,CAC5C,IAAI,OAAO,gGAAgG,CAC3G,EAAE,CAAC;IACJ,MAAM,KAAK,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,CAC/C,iCAAiC,CACjC,EAAE,CAAC;IACJ,MAAM,eAAe,GAAG,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,iBAAiB,CACvE,WAAW,EACX,aAAa,CACb,EAAE,CAAC;IACJ,MAAM,oBAAoB,GAAG,aAAa;QACzC,CAAC,CAAC,GAAG,cAAc,CAAC,sBAAsB,CAAC,GAAG,KAAK,CACjD,wKAAwK,CACxK,EAAE;QACJ,CAAC,CAAC,IAAI,CAAC;IACR,MAAM,QAAQ,GAAG,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,KAAK,CACrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gFA8E8E,CAC9E,EAAE,CAAC;IACJ,MAAM,GAAG,GAAG,GAAG,cAAc,CAAC,wBAAwB,CAAC,GAAG,KAAK,CAC9D;;;;;;;;;;;;;;;;;;;;yEAoBuE,CACvE,EAAE,CAAC;IACJ,MAAM,WAAW,GAAG,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAC5D;;;;;;;;;oEASkE,CAClE,EAAE,CAAC;IACJ,MAAM,UAAU,GAAG,GAAG,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,CAC1D;;;;0BAIwB,CACxB,EAAE,CAAC;IACJ,MAAM,kBAAkB,GAAG,GAAG,cAAc,CAAC,qBAAqB,CAAC,GAAG,KAAK,CAC1E;;;;;;;+EAO6E,CAC7E,EAAE,CAAC;IACJ,MAAM,YAAY,GAAG,GAAG,cAAc,CAAC,eAAe,CAAC,GAAG,KAAK,CAC9D;;;;;kCAKgC,CAChC,EAAE,CAAC;IACJ,MAAM,aAAa,GAAG,GAAG,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAChE;;;;mEAIiE,CACjE,EAAE,CAAC;IACJ,MAAM,YAAY,GAAG,GAAG,cAAc,CAAC,eAAe,CAAC,GAAG,KAAK,CAC9D;;;;;4GAK0G,CAC1G,EAAE,CAAC;IACJ,MAAM,aAAa,GAAG,GAAG,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAChE;;;;qDAImD,CACnD,EAAE,CAAC;IACJ,MAAM,qBAAqB,GAAG,GAAG,cAAc,CAAC,yBAAyB,CAAC,GAAG,KAAK,CACjF;;;;;gFAK8E,CAC9E,EAAE,CAAC;IACJ,MAAM,UAAU,GAAG,GAAG,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,CAC1D;;;;;;;;gFAQ8E,CAC9E,EAAE,CAAC;IACJ,MAAM,WAAW,GAAG,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAC5D;;;;6EAI2E,CAC3E,EAAE,CAAC;IACJ,MAAM,mBAAmB,GAAG,GAAG,cAAc,CAAC,uBAAuB,CAAC,GAAG,KAAK,CAC7E;;;8FAG4F,CAC5F,EAAE,CAAC;IACJ,MAAM,eAAe,GAAG,GAAG,cAAc,CAAC,kBAAkB,CAAC,GAAG,KAAK,CACpE;;mEAEiE,CACjE,EAAE,CAAC;IACJ,MAAM,iBAAiB,GAAG,GAAG,cAAc,CAAC,kBAAkB,CAAC,GAAG,KAAK,CACtE;;2CAEyC,CACzC,EAAE,CAAC;IACJ,MAAM,KAAK,GAAG,GAAG,cAAc,CAAC,iBAAiB,CAAC,GAAG,KAAK,CACzD;;;;;;;;;;;;2FAYyF,CACzF,EAAE,CAAC;IAEJ,MAAM,gBAAgB,GAAG,GAAG,cAAc,CAAC,sBAAsB,CAAC,GAAG,KAAK,CACzE;;;mGAGiG,CACjG,EAAE,CAAC;IAEJ,OAAO,CAAC,GAAG,CACV;QACC,MAAM;QACN,KAAK;QACL,eAAe;QACf,oBAAoB;QACpB,QAAQ;QACR,GAAG;QACH,WAAW;QACX,UAAU;QACV,kBAAkB;QAClB,YAAY;QACZ,aAAa;QACb,YAAY;QACZ,WAAW;QACX,UAAU;QACV,aAAa;QACb,qBAAqB;QACrB,mBAAmB;QACnB,eAAe;QACf,iBAAiB;QACjB,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,CAChC,cAAc,EACd,qBAAqB,EACrB,MAAM,CACN,EAAE;QACH,gBAAgB;QAChB,KAAK;KACL;SACC,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;SACxD,IAAI,CAAC,MAAM,CAAC,CACd,CAAC;AACH,CAAC","sourcesContent":["/**\n * @fileoverview CLI Help Output Module\n *\n * This module generates and displays the `--help` output for the Maestro CLI.\n * It provides a comprehensive overview of:\n *\n * - **Usage syntax** and common invocation patterns\n * - **Command-line options** for provider, model, session management, etc.\n * - **Environment variables** for API keys and configuration\n * - **Available tools** and their capabilities\n * - **Subcommands** like `maestro exec` for headless execution\n * - **Session management** commands and workflows\n *\n * ## Styling\n *\n * The output uses the application's theme system for consistent terminal styling:\n * - `heading()` - Main title styling\n * - `sectionHeading()` - Section headers\n * - `muted()` - De-emphasized text for descriptions\n * - `badge()` - Highlighted tips and hints\n *\n * @module cli/help\n */\nimport { badge, heading, muted, sectionHeading } from \"../style/theme.js\";\n\ninterface CliHelpOption {\n\ttext: string;\n\thidden?: boolean;\n}\n\nconst CLI_OPTIONS: CliHelpOption[] = [\n\t{ text: \"--provider <name>       Provider name (default: openai-codex)\" },\n\t{ text: \"-m, --model <id>        Model ID (default: gpt-5.5)\" },\n\t{ text: \"--task-budget <tokens> API-side Anthropic task budget in tokens\" },\n\t{\n\t\ttext: \"--models <patterns>     Comma-separated patterns for Ctrl+P model cycling\",\n\t},\n\t{\n\t\ttext: \"--tools <names>         Comma-separated tool names to enable (e.g., read,search,list,find)\",\n\t},\n\t{ text: \"--api-key <key>         API key (defaults to env vars)\" },\n\t{\n\t\ttext: \"--system-prompt <text>  System prompt (default: coding assistant prompt)\",\n\t},\n\t{\n\t\ttext: \"--append-system-prompt <text>  Append instructions to the system prompt\",\n\t},\n\t{ text: \"--mode <mode>           Output mode: text (default), json, or rpc\" },\n\t{\n\t\ttext: \"--auth <mode>           Credential mode: auto (default), api-key\",\n\t},\n\t{\n\t\ttext: \"--approval-mode <mode>  Action approvals: prompt (default in TUI), auto, fail\",\n\t},\n\t{\n\t\ttext: \"--sandbox <mode>        Sandbox mode: read-only, workspace-write, danger-full-access, native, docker, local, none\",\n\t},\n\t{\n\t\ttext: \"--port <n>              Port for `maestro web` (defaults to PORT env or 8080)\",\n\t},\n\t{ text: \"--continue, -c          Continue previous session\" },\n\t{ text: \"--resume, -r            Select a session to resume\" },\n\t{ text: \"--session <path>        Use specific session file\" },\n\t{ text: \"--no-session            Don't save session (ephemeral)\" },\n\t{ text: \"--safe-mode             Enable extra safety restrictions\" },\n\t{\n\t\ttext: \"--replay <path|uri>     Open a scripted deterministic replay session\",\n\t},\n\t{\n\t\ttext: \"--record-scenario <path> Record assistant turns as a replay fixture\",\n\t},\n\t{ text: \"--help, -h              Show this help\" },\n\t{\n\t\ttext: \"--help-hidden          Show hidden support and staged-rollout flags\",\n\t\thidden: true,\n\t},\n\t{\n\t\ttext: \"--list-modes-all       List visible and hidden agent modes\",\n\t\thidden: true,\n\t},\n];\n\nfunction renderHelpOptions(options: CliHelpOption[], includeHidden: boolean) {\n\treturn options\n\t\t.filter((option) => includeHidden || option.hidden !== true)\n\t\t.map((option) => `  ${muted(option.text)}`)\n\t\t.join(\"\\n\");\n}\n\n/**\n * Prints the complete CLI help message to stdout.\n *\n * This function is invoked when the user runs `maestro --help` or `maestro -h`.\n * It formats and displays all available options, commands, and usage examples\n * using the terminal theme for consistent styling.\n *\n * @param version - The current Maestro version string (e.g., \"1.2.3\")\n *\n * @example\n * ```typescript\n * import { printHelp } from \"./help.js\";\n * import { version } from \"../../package.json\";\n *\n * if (args.includes(\"--help\")) {\n *   printHelp(version);\n *   process.exit(0);\n * }\n * ```\n */\nexport function printHelp(\n\tversion: string,\n\toptions?: { includeHidden?: boolean },\n) {\n\tconst includeHidden = options?.includeHidden === true;\n\tconst header = `${heading(\"Maestro\")} ${muted(\n\t\t`v${version} by EvalOps — AI coding assistant with read, list, search, diff, bash, edit, write, todo tools`,\n\t)}`;\n\tconst usage = `${sectionHeading(\"Usage\")}${muted(\n\t\t\"maestro [options] [messages...]\",\n\t)}`;\n\tconst renderedOptions = `${sectionHeading(\"Options\")}${renderHelpOptions(\n\t\tCLI_OPTIONS,\n\t\tincludeHidden,\n\t)}`;\n\tconst hiddenSupportSection = includeHidden\n\t\t? `${sectionHeading(\"Hidden Support Flags\")}${muted(\n\t\t\t\t\"  Hidden flags are external support surfaces. Keep them in docs/CONVENTIONS/staged-rollout-registry.json with an owner, telemetry event, and promotion/removal target.\",\n\t\t\t)}`\n\t\t: null;\n\tconst examples = `${sectionHeading(\"Examples\")}${muted(\n\t\t`  # Interactive mode (defaults to openai-codex/gpt-5.5 after \\`maestro codex login\\`)\n  maestro\n\n  # Single message\n  maestro \"List all .ts files in src/\"\n\n  # Multiple messages\n  maestro \"Read package.json\" \"What dependencies do we have?\"\n\n  # Continue previous session\n  maestro --continue \"What did we discuss?\"\n\n  # Use different model\n  maestro --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n  # Use Codex subscription models explicitly\n  maestro --provider openai-codex --model gpt-5.5 \"Plan this migration\"\n  maestro codex doctor\n\n  # Bootstrap EvalOps login, API key, and agent registration in one flow\n  maestro init\n\n  # Use EvalOps managed gateway models after \\`maestro init\\`\n  maestro --provider evalops --model gpt-4o-mini \"Say hello in one sentence\"\n\n  # Confirm managed mode sinks and EvalOps org identity\n  maestro status\n\n  # Inspect mode-level subagent model dispatch before running a swarm\n  maestro modes describe smart\n\n  # Explain which instruction files and MCP context sources are visible\n  maestro context explain\n\n  # Compare context sources between two workspaces\n  maestro context diff ./before ./after\n\n  # Include live MCP resources and prompts in context diagnostics\n  maestro context explain --live-mcp\n\n  # Export a portable session log\n  maestro export <session-id> ./session.jsonl --format jsonl\n\n  # Export a portable JSON archive with secret redaction\n  maestro export <session-id> ./session.json --format json --redact-secrets\n\n  # Import a portable session log into this workspace\n  maestro import ./session.json\n\n  # Scaffold and validate progressive skill packages\n  maestro skill new processing-incidents --description \"Process incident reports. Use when the user asks for incident triage.\"\n  maestro skill lint .maestro/skills\n\n  # Start a hosted EvalOps runner session and wait for attach readiness\n  maestro remote start --workspace ws_123 --repo evalops/foo --branch main --ttl 90m --wait --verify\n\n  # Run a single-session hosted runtime pod entrypoint\n  maestro hosted-runner --runner-session-id mrs_abc --workspace-root /workspace --listen 0.0.0.0:8080\n\n  # Show usage analytics for the last 7 days\n  maestro stats\n\n  # Show usage analytics for one session\n  maestro stats --session <session-id>\n\n  # Reconstruct the timeline, trajectory, and evidence coverage for a saved run\n  maestro run inspect <session-id> --json\n  maestro run promote <session-id>\n\n  # Validate and run a deterministic scenario fixture\n  maestro scenario validate ./test/fixtures/agent-trajectory-scenarios/local-diagnostic-success.json\n  maestro scenario run ./test/fixtures/agent-trajectory-scenarios/local-diagnostic-success.json --junit ./tmp/scenario.xml\n\n  # Open a real agent session backed by a scripted model fixture\n  maestro --replay ./test/fixtures/scripted-replay/basic-tool-call.json\n  maestro --replay gs://evalops-prod-maestro-scenario-fixtures/maestro/scenarios/example.json\n\n  # Record a live run into a replayable scripted scenario\n  maestro --record-scenario ./tmp/recorded-scenario.json \"inspect package.json\"`,\n\t)}`;\n\tconst env = `${sectionHeading(\"Environment Variables:\")}${muted(\n\t\t`  GEMINI_API_KEY          - Google Gemini API key\n  OPENAI_API_KEY          - OpenAI API key\n  OPENAI_CODEX_TOKEN      - OpenAI Codex ChatGPT access token\n  OPENAI_CODEX_ACCOUNT_ID - ChatGPT account id when using a raw Codex token\n  ANTHROPIC_API_KEY       - Anthropic API key\n  MAESTRO_AGENT_DIR      - Session storage directory (default: ~/.maestro/agent)\n  MAESTRO_SANDBOX_MODE   - Sandbox mode: read-only, workspace-write, danger-full-access\n  MAESTRO_CHANGELOG      - Set to off/false/hide/hidden/skip/0 to hide startup changelog banner\n  MAESTRO_TUI_MINIMAL    - Set to 1/true to disable animations and reduce TUI effects (SSH-friendly)\n  MAESTRO_TUI_TOOL_MAX_CHARS - Max chars shown per tool output panel (0 = unlimited)\n  MAESTRO_TUI_TOOL_MAX_LINES - Max lines shown per tool output panel (0 = unlimited)\n  MAESTRO_MEMORY_BASE - Durable memory service base URL\n  MAESTRO_MEMORY_ACCESS_TOKEN - Override bearer token for durable memory service\n  MAESTRO_MEMORY_TEAM_ID - Optional team scope for durable memory service\n  MAESTRO_SHARED_MEMORY_BASE - Shared memory base URL (Cloudflare Durable Objects worker)\n  MAESTRO_SHARED_MEMORY_API_KEY - API key for shared memory service\n  MAESTRO_REMOTE_RUNNER_URL - Hosted runner control-plane URL (default: https://runner.evalops.dev)\n  MAESTRO_REMOTE_RUNNER_TOKEN - Hosted runner bearer token override\n  MAESTRO_REMOTE_RUNNER_ORG_ID - EvalOps organization id for hosted runner sessions\n  MAESTRO_REMOTE_RUNNER_WORKSPACE_ID - EvalOps workspace id for hosted runner sessions\n  CODING_AGENT_DIR        - Legacy session directory override (fallback)`,\n\t)}`;\n\tconst execSection = `${sectionHeading(\"maestro exec\")}${muted(\n\t\t`  maestro exec \"Summarize recent changes\" --json\n\n  Flags:\n    --json                      Stream JSONL thread/turn events\n    --output-schema <file|json> Validate final assistant JSON against a schema\n    --output-last-message <path> Write the final assistant message to disk\n    --full-auto | --read-only   Force approval policy (auto or fail)\n    --sandbox <mode>            Run in sandbox: read-only, workspace-write, danger-full-access, native, docker, local, none\n    --resume <sessionId>        Resume a prior exec session by id\n    --last                      Resume the most recent exec session`,\n\t)}`;\n\tconst webSection = `${sectionHeading(\"maestro web\")}${muted(\n\t\t`  # Start the bundled web UI + API server\n  maestro web\n\n  # Use a custom port\n  maestro web --port 3000`,\n\t)}`;\n\tconst portabilitySection = `${sectionHeading(\"Session Portability\")}${muted(\n\t\t`  maestro export <session-id> [output-path] --format json|jsonl [--redact-secrets]\n maestro import <file.json|file.jsonl>\n\n  Notes:\n    - json preserves the full session in a portable wrapper object\n    - jsonl preserves the append-only session log verbatim unless redaction is requested\n    - --redact-secrets scrubs detected credentials from exported payloads\n    - import restores the session into the current workspace session directory`,\n\t)}`;\n\tconst modesSection = `${sectionHeading(\"maestro modes\")}${muted(\n\t\t`  maestro modes list\n  maestro modes describe <mode> [--provider <provider>] [--json]\n\n  Prints the mode primary/fallback model policy and resolved subagent dispatch\n  table, including cross-provider overrides such as smart-mode coder lanes\n  routed to openai-codex/gpt-5.5.`,\n\t)}`;\n\tconst memorySection = `${sectionHeading(\"maestro memory\")}${muted(\n\t\t`  maestro memory [status]         Show shared memory service status\n  maestro memory session <id>     Show per-session metrics\n  maestro memory audit <id> [n]   Show recent sync audit entries\n  maestro memory export <id>      Export metrics log as JSONL\n  maestro memory watch [id] [ms]  Poll status/metrics continuously`,\n\t)}`;\n\tconst skillSection = `${sectionHeading(\"maestro skill\")}${muted(\n\t\t`  maestro skill list                 List available progressive skills\n  maestro skill inspect <name>       Print one skill package manifest\n  maestro skill install <source>     Validate and install an OSS skill package\n  maestro skill publish-check <src>  Validate an OSS skill package for publishing\n  maestro skill new <name>           Scaffold SKILL.md, reference/, scripts/, toolbox/, and mcp.json.example\n  maestro skill lint [path...]       Validate frontmatter, budget, mcp.json includeTools, and toolbox shape`,\n\t)}`;\n\tconst remoteSection = `${sectionHeading(\"maestro remote\")}${muted(\n\t\t`  maestro remote start --workspace <id> --repo <repo> --branch <branch> [--ttl 90m] [--wait] [--verify]\n  maestro remote list --workspace <id> [--state running]\n  maestro remote attach <session-id> [--verify] [--print-env]\n  maestro remote extend <session-id> --ttl 2h\n  maestro remote stop <session-id> [--reason <text>]`,\n\t)}`;\n\tconst operatingPlaneSection = `${sectionHeading(\"maestro operating-plane\")}${muted(\n\t\t`  maestro operating-plane status --thread-id <slack-thread> [--evidence-id <id>] [--auth-subject <subject>]\n  maestro operating-plane status --trace-id <id> --json\n\n  Fetches the Platform operating-plane ledger and prints a content-free value\n  proof report with identity, model/tool/approval/trace/evidence/cost status,\n  allowed evidence ids/revisions, blockers, next actions, and withheld reasons.`,\n\t)}`;\n\tconst runSection = `${sectionHeading(\"maestro run\")}${muted(\n\t\t`  maestro run inspect <session-id> [--json]\n  maestro run ledger <session-id>\n  maestro run replay <session-id>\n  maestro run promote <session-id>\n\n  Reconstructs a saved session into a timeline plus canonical agent trajectory\n  with prompt, tool, file-change, artifact, policy, diagnostic, compaction,\n  pending-wait, and MCP-context coverage. The ledger/replay/promote commands\n  expose the local AgentRuntime projection and dry-run Platform promotion plan.`,\n\t)}`;\n\tconst initSection = `${sectionHeading(\"maestro init\")}${muted(\n\t\t`  maestro init                         Login, create or reuse an API key, and register this agent\n  maestro init --rotate-key           Replace the stored agent MCP API key\n  maestro init --mcp-url <url>        Override the EvalOps agent MCP endpoint\n  maestro init --capability code:write Declare an agent-registry capability\n  maestro init --json                 Emit machine-readable bootstrap output`,\n\t)}`;\n\tconst hostedRunnerSection = `${sectionHeading(\"maestro hosted-runner\")}${muted(\n\t\t`  maestro hosted-runner --runner-session-id <id> --workspace-root <path> [--listen 0.0.0.0:8080]\n\n  Env mode:\n    MAESTRO_RUNNER_SESSION_ID=mrs_abc MAESTRO_WORKSPACE_ROOT=/workspace maestro hosted-runner`,\n\t)}`;\n\tconst sessionsSection = `${sectionHeading(\"Session Metadata\")}${muted(\n\t\t`  /session favorite|unfavorite      Toggle favorite for current session\n  /session summary \"<text>\"         Save a manual summary for current session\n  /sessions summarize <id>          Auto-summarize a saved session`,\n\t)}`;\n\tconst sessionsDiscovery = `${sectionHeading(\"Session Commands\")}${muted(\n\t\t`  /session [info|favorite|unfavorite|summary \"<text>\"]\n  /sessions [list|load <id>|favorite <id>|unfavorite <id>|summarize <id>]\n  (Also available via TUI command palette)`,\n\t)}`;\n\tconst tools = `${sectionHeading(\"Available Tools\")}${muted(\n\t\t`  read   - Read file contents\n  list   - List files in a directory\n  find   - Fast file search using fd (glob patterns)\n  search - Search files with ripgrep-style filtering\n  parallel_ripgrep - Run multiple ripgrep patterns in parallel and merge line ranges\n  diff   - Show git diffs (workspace, staged, or ranges)\n  bash   - Execute bash commands\n  edit   - Edit files with find/replace\n  write  - Write files (creates/overwrites)\n  todo   - Create TodoWrite-style checklists\n\n  Read-only tools: read,list,find,search,parallel_ripgrep,diff,status\n  Example: maestro --tools read,list,find,search,parallel_ripgrep,diff \"Analyze this code\"`,\n\t)}`;\n\n\tconst frameworkSection = `${sectionHeading(\"Framework Preference\")}${muted(\n\t\t`  /framework <id>            Set default stack (fastapi, express, node)\n  /framework <id> --workspace  Set workspace-scoped default\n  /framework list              Show available options\n  Precedence: policy (locked) > policy > env override > env default > workspace > user file > none`,\n\t)}`;\n\n\tconsole.log(\n\t\t[\n\t\t\theader,\n\t\t\tusage,\n\t\t\trenderedOptions,\n\t\t\thiddenSupportSection,\n\t\t\texamples,\n\t\t\tenv,\n\t\t\texecSection,\n\t\t\twebSection,\n\t\t\tportabilitySection,\n\t\t\tmodesSection,\n\t\t\tmemorySection,\n\t\t\tskillSection,\n\t\t\tinitSection,\n\t\t\trunSection,\n\t\t\tremoteSection,\n\t\t\toperatingPlaneSection,\n\t\t\thostedRunnerSection,\n\t\t\tsessionsSection,\n\t\t\tsessionsDiscovery,\n\t\t\t`${sectionHeading(\"Tips\")}${badge(\n\t\t\t\t\"Need models?\",\n\t\t\t\t\"maestro models list\",\n\t\t\t\t\"info\",\n\t\t\t)}`,\n\t\t\tframeworkSection,\n\t\t\ttools,\n\t\t]\n\t\t\t.filter((section): section is string => section !== null)\n\t\t\t.join(\"\\n\\n\"),\n\t);\n}\n"]}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview CLI Help Output Module\n *\n * This module generates and displays the `--help` output for the Maestro CLI.\n * It provides a comprehensive overview of:\n *\n * - **Usage syntax** and common invocation patterns\n * - **Command-line options** for provider, model, session management, etc.\n * - **Environment variables** for API keys and configuration\n * - **Available tools** and their capabilities\n * - **Subcommands** like `maestro exec` for headless execution\n * - **Session management** commands and workflows\n *\n * ## Styling\n *\n * The output uses the application's theme system for consistent terminal styling:\n * - `heading()` - Main title styling\n * - `sectionHeading()` - Section headers\n * - `muted()` - De-emphasized text for descriptions\n * - `badge()` - Highlighted tips and hints\n *\n * @module cli/help\n */\nimport { badge, heading, muted, sectionHeading } from \"../style/theme.js\";\n\ninterface CliHelpOption {\n\ttext: string;\n\thidden?: boolean;\n}\n\nconst CLI_OPTIONS: CliHelpOption[] = [\n\t{ text: \"--provider <name>       Provider name (default: openai-codex)\" },\n\t{ text: \"-m, --model <id>        Model ID (default: gpt-5.5)\" },\n\t{ text: \"--task-budget <tokens> API-side Anthropic task budget in tokens\" },\n\t{\n\t\ttext: \"--models <patterns>     Comma-separated patterns for Ctrl+P model cycling\",\n\t},\n\t{\n\t\ttext: \"--tools <names>         Comma-separated tool names to enable (e.g., read,search,list,find)\",\n\t},\n\t{ text: \"--api-key <key>         API key (defaults to env vars)\" },\n\t{\n\t\ttext: \"--system-prompt <text>  System prompt (default: coding assistant prompt)\",\n\t},\n\t{\n\t\ttext: \"--append-system-prompt <text>  Append instructions to the system prompt\",\n\t},\n\t{ text: \"--mode <mode>           Output mode: text (default), json, or rpc\" },\n\t{\n\t\ttext: \"--auth <mode>           Credential mode: auto (default), api-key\",\n\t},\n\t{\n\t\ttext: \"--approval-mode <mode>  Action approvals: prompt (default in TUI), auto, fail\",\n\t},\n\t{\n\t\ttext: \"--sandbox <mode>        Sandbox mode: read-only, workspace-write, danger-full-access, native, docker, local, none\",\n\t},\n\t{\n\t\ttext: \"--port <n>              Port for `maestro web` (defaults to PORT env or 8080)\",\n\t},\n\t{ text: \"--continue, -c          Continue previous session\" },\n\t{ text: \"--resume, -r            Select a session to resume\" },\n\t{ text: \"--session <path>        Use specific session file\" },\n\t{ text: \"--no-session            Don't save session (ephemeral)\" },\n\t{ text: \"--safe-mode             Enable extra safety restrictions\" },\n\t{\n\t\ttext: \"--replay <path|uri>     Open a scripted deterministic replay session\",\n\t},\n\t{\n\t\ttext: \"--record-scenario <path> Record assistant turns as a replay fixture\",\n\t},\n\t{ text: \"--help, -h              Show this help\" },\n\t{\n\t\ttext: \"--help-hidden          Show hidden support and staged-rollout flags\",\n\t\thidden: true,\n\t},\n\t{\n\t\ttext: \"--list-modes-all       List visible and hidden agent modes\",\n\t\thidden: true,\n\t},\n];\n\nfunction renderHelpOptions(options: CliHelpOption[], includeHidden: boolean) {\n\treturn options\n\t\t.filter((option) => includeHidden || option.hidden !== true)\n\t\t.map((option) => `  ${muted(option.text)}`)\n\t\t.join(\"\\n\");\n}\n\n/**\n * Prints the complete CLI help message to stdout.\n *\n * This function is invoked when the user runs `maestro --help` or `maestro -h`.\n * It formats and displays all available options, commands, and usage examples\n * using the terminal theme for consistent styling.\n *\n * @param version - The current Maestro version string (e.g., \"1.2.3\")\n *\n * @example\n * ```typescript\n * import { printHelp } from \"./help.js\";\n * import { version } from \"../../package.json\";\n *\n * if (args.includes(\"--help\")) {\n *   printHelp(version);\n *   process.exit(0);\n * }\n * ```\n */\nexport function printHelp(\n\tversion: string,\n\toptions?: { includeHidden?: boolean },\n) {\n\tconst includeHidden = options?.includeHidden === true;\n\tconst header = `${heading(\"Maestro\")} ${muted(\n\t\t`v${version} by EvalOps — AI coding assistant with read, list, search, diff, bash, edit, write, todo tools`,\n\t)}`;\n\tconst usage = `${sectionHeading(\"Usage\")}${muted(\n\t\t\"maestro [options] [messages...]\",\n\t)}`;\n\tconst renderedOptions = `${sectionHeading(\"Options\")}${renderHelpOptions(\n\t\tCLI_OPTIONS,\n\t\tincludeHidden,\n\t)}`;\n\tconst hiddenSupportSection = includeHidden\n\t\t? `${sectionHeading(\"Hidden Support Flags\")}${muted(\n\t\t\t\t\"  Hidden flags are external support surfaces. Keep them in docs/CONVENTIONS/staged-rollout-registry.json with an owner, telemetry event, and promotion/removal target.\",\n\t\t\t)}`\n\t\t: null;\n\tconst examples = `${sectionHeading(\"Examples\")}${muted(\n\t\t`  # Interactive mode (defaults to openai-codex/gpt-5.5 after \\`maestro codex login\\`)\n  maestro\n\n  # Single message\n  maestro \"List all .ts files in src/\"\n\n  # Multiple messages\n  maestro \"Read package.json\" \"What dependencies do we have?\"\n\n  # Continue previous session\n  maestro --continue \"What did we discuss?\"\n\n  # Use different model\n  maestro --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n  # Use Codex subscription models explicitly\n  maestro --provider openai-codex --model gpt-5.5 \"Plan this migration\"\n  maestro codex doctor\n\n  # Bootstrap EvalOps login, API key, and agent registration in one flow\n  maestro init\n\n  # Use EvalOps managed gateway models after \\`maestro init\\`\n  maestro --provider evalops --model gpt-4o-mini \"Say hello in one sentence\"\n\n  # Confirm managed mode sinks and EvalOps org identity\n  maestro status\n\n  # Inspect mode-level subagent model dispatch before running a swarm\n  maestro modes describe smart\n\n  # Explain which instruction files and MCP context sources are visible\n  maestro context explain\n\n  # Compare context sources between two workspaces\n  maestro context diff ./before ./after\n\n  # Include live MCP resources and prompts in context diagnostics\n  maestro context explain --live-mcp\n\n  # Export a portable session log\n  maestro export <session-id> ./session.jsonl --format jsonl\n\n  # Export a portable JSON archive with secret redaction\n  maestro export <session-id> ./session.json --format json --redact-secrets\n\n  # Import a portable session log into this workspace\n  maestro import ./session.json\n\n  # Scaffold and validate progressive skill packages\n  maestro skill new processing-incidents --description \"Process incident reports. Use when the user asks for incident triage.\"\n  maestro skill lint .maestro/skills\n\n  # Start a hosted EvalOps runner session and wait for attach readiness\n  maestro remote start --workspace ws_123 --repo evalops/foo --branch main --ttl 90m --wait --verify\n\n  # Run a single-session hosted runtime pod entrypoint\n  maestro hosted-runner --runner-session-id mrs_abc --workspace-root /workspace --listen 0.0.0.0:8080\n\n  # Show usage analytics for the last 7 days\n  maestro stats\n\n  # Show usage analytics for one session\n  maestro stats --session <session-id>\n\n  # Reconstruct the timeline, trajectory, and evidence coverage for a saved run\n  maestro run inspect <session-id> --json\n  maestro run promote <session-id>\n\n  # Validate and run a deterministic scenario fixture\n  maestro scenario validate ./test/fixtures/agent-trajectory-scenarios/local-diagnostic-success.json\n  maestro scenario run ./test/fixtures/agent-trajectory-scenarios/local-diagnostic-success.json --junit ./tmp/scenario.xml\n\n  # Open a real agent session backed by a scripted model fixture\n  maestro --replay ./test/fixtures/scripted-replay/basic-tool-call.json\n  maestro --replay gs://evalops-prod-maestro-scenario-fixtures/maestro/scenarios/example.json\n\n  # Record a live run into a replayable scripted scenario\n  maestro --record-scenario ./tmp/recorded-scenario.json \"inspect package.json\"`,\n\t)}`;\n\tconst env = `${sectionHeading(\"Environment Variables:\")}${muted(\n\t\t`  GEMINI_API_KEY          - Google Gemini API key\n  OPENAI_API_KEY          - OpenAI API key\n  OPENAI_CODEX_TOKEN      - OpenAI Codex ChatGPT access token\n  OPENAI_CODEX_ACCOUNT_ID - ChatGPT account id when using a raw Codex token\n  ANTHROPIC_API_KEY       - Anthropic API key\n  MAESTRO_AGENT_DIR      - Session storage directory (default: ~/.maestro/agent)\n  MAESTRO_SANDBOX_MODE   - Sandbox mode: read-only, workspace-write, danger-full-access\n  MAESTRO_CHANGELOG      - Set to off/false/hide/hidden/skip/0 to hide startup changelog banner\n  MAESTRO_TUI_MINIMAL    - Set to 1/true to disable animations and reduce TUI effects (SSH-friendly)\n  MAESTRO_TUI_TOOL_MAX_CHARS - Max chars shown per tool output panel (0 = unlimited)\n  MAESTRO_TUI_TOOL_MAX_LINES - Max lines shown per tool output panel (0 = unlimited)\n  MAESTRO_MEMORY_BASE - Durable memory service base URL\n  MAESTRO_MEMORY_ACCESS_TOKEN - Override bearer token for durable memory service\n  MAESTRO_MEMORY_TEAM_ID - Optional team scope for durable memory service\n  MAESTRO_SHARED_MEMORY_BASE - Shared memory base URL (Cloudflare Durable Objects worker)\n  MAESTRO_SHARED_MEMORY_API_KEY - API key for shared memory service\n  MAESTRO_REMOTE_RUNNER_URL - Hosted runner control-plane URL (default: https://runner.evalops.dev)\n  MAESTRO_REMOTE_RUNNER_TOKEN - Hosted runner bearer token override\n  MAESTRO_REMOTE_RUNNER_ORG_ID - EvalOps organization id for hosted runner sessions\n  MAESTRO_REMOTE_RUNNER_WORKSPACE_ID - EvalOps workspace id for hosted runner sessions\n  CODING_AGENT_DIR        - Legacy session directory override (fallback)`,\n\t)}`;\n\tconst execSection = `${sectionHeading(\"maestro exec\")}${muted(\n\t\t`  maestro exec \"Summarize recent changes\" --json\n\n  Flags:\n    --json                      Stream JSONL thread/turn events\n    --output-schema <file|json> Validate final assistant JSON against a schema\n    --output-last-message <path> Write the final assistant message to disk\n    --full-auto | --read-only   Force approval policy (auto or fail)\n    --sandbox <mode>            Run in sandbox: read-only, workspace-write, danger-full-access, native, docker, local, none\n    --resume <sessionId>        Resume a prior exec session by id\n    --last                      Resume the most recent exec session`,\n\t)}`;\n\tconst webSection = `${sectionHeading(\"maestro web\")}${muted(\n\t\t`  # Start the bundled web UI + API server\n  maestro web\n\n  # Use a custom port\n  maestro web --port 3000`,\n\t)}`;\n\tconst portabilitySection = `${sectionHeading(\"Session Portability\")}${muted(\n\t\t`  maestro export <session-id> [output-path] --format json|jsonl [--redact-secrets]\n maestro import <file.json|file.jsonl>\n\n  Notes:\n    - json preserves the full session in a portable wrapper object\n    - jsonl preserves the append-only session log verbatim unless redaction is requested\n    - --redact-secrets scrubs detected credentials from exported payloads\n    - import restores the session into the current workspace session directory`,\n\t)}`;\n\tconst modesSection = `${sectionHeading(\"maestro modes\")}${muted(\n\t\t`  maestro modes list\n  maestro modes describe <mode> [--provider <provider>] [--json]\n\n  Prints the mode primary/fallback model policy and resolved subagent dispatch\n  table, including cross-provider overrides such as smart-mode coder lanes\n  routed to openai-codex/gpt-5.5.`,\n\t)}`;\n\tconst memorySection = `${sectionHeading(\"maestro memory\")}${muted(\n\t\t`  maestro memory [status]         Show shared memory service status\n  maestro memory session <id>     Show per-session metrics\n  maestro memory audit <id> [n]   Show recent sync audit entries\n  maestro memory export <id>      Export metrics log as JSONL\n  maestro memory watch [id] [ms]  Poll status/metrics continuously`,\n\t)}`;\n\tconst skillSection = `${sectionHeading(\"maestro skill\")}${muted(\n\t\t`  maestro skill list                 List available progressive skills\n  maestro skill inspect <name>       Print one skill package manifest\n  maestro skill install <source>     Validate and install an OSS skill package\n  maestro skill publish-check <src>  Validate an OSS skill package for publishing\n  maestro skill new <name>           Scaffold SKILL.md, reference/, scripts/, toolbox/, and mcp.json.example\n  maestro skill lint [path...]       Validate frontmatter, budget, mcp.json includeTools, and toolbox shape`,\n\t)}`;\n\tconst remoteSection = `${sectionHeading(\"maestro remote\")}${muted(\n\t\t`  maestro remote start --workspace <id> --repo <repo> --branch <branch> [--ttl 90m] [--wait] [--verify]\n  maestro remote list --workspace <id> [--state running]\n  maestro remote attach <session-id> [--verify] [--print-env]\n  maestro remote extend <session-id> --ttl 2h\n  maestro remote stop <session-id> [--reason <text>]`,\n\t)}`;\n\tconst operatingPlaneHelp = [\n\t\t\"  maestro operating-plane status --thread-id <slack-thread> [--artifact-id <id>] [--auth-subject <subject>]\",\n\t\t\"  maestro operating-plane status --trace-id <id> --json\",\n\t\t\"  Fetches the Platform operating-plane ledger and prints content-free runtime\",\n\t\t\"  status with identity, model/tool/approval/trace/artifact/cost signals,\",\n\t\t\"  allowed artifact ids/revisions, blockers, next actions, and withheld reasons.\",\n\t].join(\"\\n\");\n\tconst operatingPlaneSection = `${sectionHeading(\"maestro operating-plane\")}${muted(operatingPlaneHelp)}`;\n\tconst runSection = `${sectionHeading(\"maestro run\")}${muted(\n\t\t`  maestro run inspect <session-id> [--json]\n  maestro run ledger <session-id>\n  maestro run replay <session-id>\n  maestro run promote <session-id>\n\n  Reconstructs a saved session into a timeline plus canonical agent trajectory\n  with prompt, tool, file-change, artifact, policy, diagnostic, compaction,\n  pending-wait, and MCP-context coverage. The ledger/replay/promote commands\n  expose the local AgentRuntime projection and dry-run Platform promotion plan.`,\n\t)}`;\n\tconst initSection = `${sectionHeading(\"maestro init\")}${muted(\n\t\t`  maestro init                         Login, create or reuse an API key, and register this agent\n  maestro init --rotate-key           Replace the stored agent MCP API key\n  maestro init --mcp-url <url>        Override the EvalOps agent MCP endpoint\n  maestro init --capability code:write Declare an agent-registry capability\n  maestro init --json                 Emit machine-readable bootstrap output`,\n\t)}`;\n\tconst hostedRunnerSection = `${sectionHeading(\"maestro hosted-runner\")}${muted(\n\t\t`  maestro hosted-runner --runner-session-id <id> --workspace-root <path> [--listen 0.0.0.0:8080]\n\n  Env mode:\n    MAESTRO_RUNNER_SESSION_ID=mrs_abc MAESTRO_WORKSPACE_ROOT=/workspace maestro hosted-runner`,\n\t)}`;\n\tconst sessionsSection = `${sectionHeading(\"Session Metadata\")}${muted(\n\t\t`  /session favorite|unfavorite      Toggle favorite for current session\n  /session summary \"<text>\"         Save a manual summary for current session\n  /sessions summarize <id>          Auto-summarize a saved session`,\n\t)}`;\n\tconst sessionsDiscovery = `${sectionHeading(\"Session Commands\")}${muted(\n\t\t`  /session [info|favorite|unfavorite|summary \"<text>\"]\n  /sessions [list|load <id>|favorite <id>|unfavorite <id>|summarize <id>]\n  (Also available via TUI command palette)`,\n\t)}`;\n\tconst tools = `${sectionHeading(\"Available Tools\")}${muted(\n\t\t`  read   - Read file contents\n  list   - List files in a directory\n  find   - Fast file search using fd (glob patterns)\n  search - Search files with ripgrep-style filtering\n  parallel_ripgrep - Run multiple ripgrep patterns in parallel and merge line ranges\n  diff   - Show git diffs (workspace, staged, or ranges)\n  bash   - Execute bash commands\n  edit   - Edit files with find/replace\n  write  - Write files (creates/overwrites)\n  todo   - Create TodoWrite-style checklists\n\n  Read-only tools: read,list,find,search,parallel_ripgrep,diff,status\n  Example: maestro --tools read,list,find,search,parallel_ripgrep,diff \"Analyze this code\"`,\n\t)}`;\n\n\tconst frameworkSection = `${sectionHeading(\"Framework Preference\")}${muted(\n\t\t`  /framework <id>            Set default stack (fastapi, express, node)\n  /framework <id> --workspace  Set workspace-scoped default\n  /framework list              Show available options\n  Precedence: policy (locked) > policy > env override > env default > workspace > user file > none`,\n\t)}`;\n\n\tconsole.log(\n\t\t[\n\t\t\theader,\n\t\t\tusage,\n\t\t\trenderedOptions,\n\t\t\thiddenSupportSection,\n\t\t\texamples,\n\t\t\tenv,\n\t\t\texecSection,\n\t\t\twebSection,\n\t\t\tportabilitySection,\n\t\t\tmodesSection,\n\t\t\tmemorySection,\n\t\t\tskillSection,\n\t\t\tinitSection,\n\t\t\trunSection,\n\t\t\tremoteSection,\n\t\t\toperatingPlaneSection,\n\t\t\thostedRunnerSection,\n\t\t\tsessionsSection,\n\t\t\tsessionsDiscovery,\n\t\t\t`${sectionHeading(\"Tips\")}${badge(\n\t\t\t\t\"Need models?\",\n\t\t\t\t\"maestro models list\",\n\t\t\t\t\"info\",\n\t\t\t)}`,\n\t\t\tframeworkSection,\n\t\t\ttools,\n\t\t]\n\t\t\t.filter((section): section is string => section !== null)\n\t\t\t.join(\"\\n\\n\"),\n\t);\n}\n"]}