@evalops/maestro 0.10.8 → 0.10.10

package/dist/cli-tui/commands/{grouped → subcommands}/safety-commands.js

@@ -13,15 +13,15 @@
  */
 import { SecurityAdvisor, formatAdvisory, } from "../../../safety/security-advisor.js";
 import { getEventStats, getRecentEvents, } from "../../../telemetry/security-events.js";
-import { createGroupedCommandHandler } from "./utils.js";
+import { createSubcommandHandler } from "./utils.js";
 export function createSafetyCommandHandler(deps) {
-    return createGroupedCommandHandler({
+    return createSubcommandHandler({
         defaultSubcommand: "status",
         showHelp: showSafetyHelp,
         routes: [
             {
                 match: ["status", "info"],
-                execute: () => showSafetyStatus(deps),
+                execute: ({ ctx }) => showSafetyStatus(ctx, deps),
             },
             {
                 match: ["approvals", "approval", "approve"],
@@ -37,18 +37,18 @@ export function createSafetyCommandHandler(deps) {
             },
             {
                 match: ["events", "security", "logs"],
-                execute: ({ ctx }) => showSecurityEvents(ctx, deps),
+                execute: ({ ctx }) => showSecurityEvents(ctx),
             },
             {
                 match: ["threats", "threat", "advisory"],
-                execute: () => showThreatLevel(deps),
+                execute: ({ ctx }) => showThreatLevel(ctx),
             },
         ],
     });
 }
-function showSafetyStatus(deps) {
+function showSafetyStatus(ctx, deps) {
     const state = deps.getSafetyState();
-    deps.showInfo(`Safety Settings:
+    ctx.showInfo(`Safety Settings:
   Approval Mode: ${state.approvalMode}
   Plan Mode: ${state.planMode ? "on" : "off"}
   Guardian: ${state.guardianEnabled ? "enabled" : "disabled"}
@@ -87,7 +87,7 @@ function formatEvent(event) {
 /**
  * Show recent security events
  */
-function showSecurityEvents(ctx, deps) {
+function showSecurityEvents(ctx) {
     // Parse limit from arguments
     const args = ctx.argumentText.split(/\s+/).filter(Boolean);
     const subArg = args[1]; // Skip "events" subcommand
@@ -95,7 +95,7 @@ function showSecurityEvents(ctx, deps) {
     const events = getRecentEvents(limit);
     const stats = getEventStats();
     if (events.length === 0) {
-        deps.showInfo(`Security Events:
+        ctx.showInfo(`Security Events:
   No security events recorded in this session.
 
   Stats: 0 total events
@@ -107,7 +107,7 @@ function showSecurityEvents(ctx, deps) {
         .reverse() // Most recent first
         .map((e) => `  ${formatEvent(e)}`)
         .join("\n");
-    deps.showInfo(`Security Events (last ${events.length}):
+    ctx.showInfo(`Security Events (last ${events.length}):
 ${eventLines}
 
 Stats:
@@ -119,7 +119,7 @@ Use /safety threats for threat assessment.`);
 /**
  * Show threat level and advisories
  */
-function showThreatLevel(deps) {
+function showThreatLevel(ctx) {
     const advisor = new SecurityAdvisor({ enableRealtime: false });
     const threat = advisor.getThreatLevel();
     const advisories = advisor.analyze();
@@ -143,7 +143,7 @@ function showThreatLevel(deps) {
         output += "\n  No active advisories.\n";
     }
     output += "\nUse /safety events [N] to see recent events.";
-    deps.showInfo(output);
+    ctx.showInfo(output);
     advisor.dispose();
 }
 //# sourceMappingURL=safety-commands.js.map

package/dist/cli-tui/commands/subcommands/safety-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-commands.js","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/safety-commands.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Consolidated /safety command handler.\n *\n * Combines: /approvals, /plan-mode, /guardian, /security events\n *\n * Usage:\n *   /safety                    - Show safety settings overview\n *   /safety approvals [mode]   - Approval mode (auto|prompt|fail)\n *   /safety plan [on|off]      - Toggle plan mode\n *   /safety guardian [cmd]     - Guardian scanning (run|status|enable|disable)\n *   /safety events [N]         - Show recent N security events (default: 10)\n *   /safety threats            - Show threat level and advisories\n */\n\nimport {\n\tSecurityAdvisor,\n\tformatAdvisory,\n} from \"../../../safety/security-advisor.js\";\nimport {\n\ttype SecurityEvent,\n\tgetEventStats,\n\tgetRecentEvents,\n} from \"../../../telemetry/security-events.js\";\nimport type { CommandExecutionContext } from \"../types.js\";\nimport { createSubcommandHandler } from \"./utils.js\";\n\nexport interface SafetyCommandDeps {\n\thandleApprovals: (ctx: CommandExecutionContext) => void;\n\thandlePlanMode: (ctx: CommandExecutionContext) => void;\n\thandleGuardian: (ctx: CommandExecutionContext) => Promise<void> | void;\n\tgetSafetyState: () => {\n\t\tapprovalMode: string;\n\t\tplanMode: boolean;\n\t\tguardianEnabled: boolean;\n\t};\n}\n\nexport function createSafetyCommandHandler(deps: SafetyCommandDeps) {\n\treturn createSubcommandHandler({\n\t\tdefaultSubcommand: \"status\",\n\t\tshowHelp: showSafetyHelp,\n\t\troutes: [\n\t\t\t{\n\t\t\t\tmatch: [\"status\", \"info\"],\n\t\t\t\texecute: ({ ctx }) => showSafetyStatus(ctx, deps),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"approvals\", \"approval\", \"approve\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleApprovals(rewriteContext(\"approvals\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"plan\", \"plan-mode\", \"planmode\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handlePlanMode(rewriteContext(\"plan-mode\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"guardian\", \"guard\", \"scan\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleGuardian(rewriteContext(\"guardian\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"events\", \"security\", \"logs\"],\n\t\t\t\texecute: ({ ctx }) => showSecurityEvents(ctx),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"threats\", \"threat\", \"advisory\"],\n\t\t\t\texecute: ({ ctx }) => showThreatLevel(ctx),\n\t\t\t},\n\t\t],\n\t});\n}\n\nfunction showSafetyStatus(\n\tctx: CommandExecutionContext,\n\tdeps: SafetyCommandDeps,\n): void {\n\tconst state = deps.getSafetyState();\n\tctx.showInfo(`Safety Settings:\n  Approval Mode: ${state.approvalMode}\n  Plan Mode: ${state.planMode ? \"on\" : \"off\"}\n  Guardian: ${state.guardianEnabled ? \"enabled\" : \"disabled\"}\n\nUse /safety <setting> to change a setting.`);\n}\n\nfunction showSafetyHelp(ctx: CommandExecutionContext): void {\n\tctx.showInfo(`Safety Commands:\n  /safety                    Show safety settings\n  /safety approvals [mode]   Set approval mode (auto|prompt|fail)\n  /safety plan [on|off]      Toggle plan mode (ask before mutations)\n  /safety guardian [cmd]     Guardian scanning:\n                             - run: scan staged files\n                             - status: show last scan\n                             - enable/disable: toggle enforcement\n  /safety events [N]         Show recent N security events (default: 10)\n  /safety threats            Show threat level and advisories\n\nDirect shortcuts still work: /approvals, /plan-mode, /guardian`);\n}\n\n/**\n * Format a security event for display\n */\nfunction formatEvent(event: SecurityEvent): string {\n\tconst severityIcon: Record<string, string> = {\n\t\tcritical: \"🔴\",\n\t\thigh: \"🟠\",\n\t\tmedium: \"🟡\",\n\t\tlow: \"🔵\",\n\t};\n\tconst icon = severityIcon[event.severity] ?? \"•\";\n\tconst time = new Date(event.timestamp).toLocaleTimeString();\n\tconst tool = event.toolName ? ` [${event.toolName}]` : \"\";\n\treturn `${icon} ${time}${tool} ${event.description}`;\n}\n\n/**\n * Show recent security events\n */\nfunction showSecurityEvents(ctx: CommandExecutionContext): void {\n\t// Parse limit from arguments\n\tconst args = ctx.argumentText.split(/\\s+/).filter(Boolean);\n\tconst subArg = args[1]; // Skip \"events\" subcommand\n\tconst limit = subArg ? Number.parseInt(subArg, 10) || 10 : 10;\n\n\tconst events = getRecentEvents(limit);\n\tconst stats = getEventStats();\n\n\tif (events.length === 0) {\n\t\tctx.showInfo(`Security Events:\n  No security events recorded in this session.\n\n  Stats: 0 total events\n\n  Use /safety threats to see threat assessment.`);\n\t\treturn;\n\t}\n\n\tconst eventLines = events\n\t\t.reverse() // Most recent first\n\t\t.map((e) => `  ${formatEvent(e)}`)\n\t\t.join(\"\\n\");\n\n\tctx.showInfo(`Security Events (last ${events.length}):\n${eventLines}\n\nStats:\n  Total: ${stats.total} | Critical: ${stats.bySeverity.critical} | High: ${stats.bySeverity.high} | Medium: ${stats.bySeverity.medium} | Low: ${stats.bySeverity.low}\n  Recent high-severity (1h): ${stats.recentHigh}\n\nUse /safety threats for threat assessment.`);\n}\n\n/**\n * Show threat level and advisories\n */\nfunction showThreatLevel(ctx: CommandExecutionContext): void {\n\tconst advisor = new SecurityAdvisor({ enableRealtime: false });\n\tconst threat = advisor.getThreatLevel();\n\tconst advisories = advisor.analyze();\n\n\tconst levelIcon: Record<string, string> = {\n\t\tinfo: \"✅\",\n\t\twarning: \"⚠️\",\n\t\talert: \"🚨\",\n\t\tcritical: \"🔴\",\n\t};\n\n\tlet output = `Threat Assessment:\n  Level: ${levelIcon[threat.level] ?? \"•\"} ${threat.level.toUpperCase()} (score: ${threat.score.toFixed(1)})\n  ${threat.summary}\n`;\n\n\tif (advisories.length > 0) {\n\t\toutput += `\\nActive Advisories (${advisories.length}):\\n`;\n\t\tfor (const adv of advisories) {\n\t\t\toutput += `\\n${formatAdvisory(adv)}\\n`;\n\t\t}\n\t} else {\n\t\toutput += \"\\n  No active advisories.\\n\";\n\t}\n\n\toutput += \"\\nUse /safety events [N] to see recent events.\";\n\n\tctx.showInfo(output);\n\tadvisor.dispose();\n}\n"]}

package/dist/cli-tui/commands/{grouped → subcommands}/session-commands.d.ts

@@ -21,7 +21,7 @@
 import type { CommandExecutionContext } from "../types.js";
 export interface SessionCommandDeps {
     handleSessionInfo: (ctx: CommandExecutionContext) => void;
-    handleNewChat: () => void | Promise<void>;
+    handleNewChat: (ctx: CommandExecutionContext) => void | Promise<void>;
     handleClear: () => Promise<void> | void;
     handleSessionsList: (ctx: CommandExecutionContext) => Promise<void> | void;
     handleBranch: (ctx: CommandExecutionContext) => Promise<void> | void;
@@ -31,7 +31,6 @@ export interface SessionCommandDeps {
     handleShare: (ctx: CommandExecutionContext) => Promise<void> | void;
     handleRecover: (ctx: CommandExecutionContext) => Promise<void> | void;
     handleCleanup: (ctx: CommandExecutionContext) => Promise<void> | void;
-    showInfo: (message: string) => void;
 }
 export declare function createSessionCommandHandler(deps: SessionCommandDeps): (ctx: CommandExecutionContext) => Promise<void>;
 //# sourceMappingURL=session-commands.d.ts.map

package/dist/cli-tui/commands/subcommands/session-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/session-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,WAAW,kBAAkB;IAClC,iBAAiB,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC1D,aAAa,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,kBAAkB,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3E,YAAY,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrE,UAAU,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnE,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,YAAY,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrE,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,aAAa,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtE,aAAa,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,mDAiGnE"}

package/dist/cli-tui/commands/{grouped → subcommands}/session-commands.js

@@ -18,9 +18,9 @@
  *   /session unfavorite   - Remove favorite mark
  *   /session summary      - Add manual summary
  */
-import { createGroupedCommandHandler, isSessionId } from "./utils.js";
+import { createSubcommandHandler, isSessionId } from "./utils.js";
 export function createSessionCommandHandler(deps) {
-    return createGroupedCommandHandler({
+    return createSubcommandHandler({
         defaultSubcommand: "info",
         showHelp: showSessionHelp,
         routes: [
@@ -28,7 +28,7 @@ export function createSessionCommandHandler(deps) {
                 match: ["info", "status"],
                 execute: ({ ctx }) => deps.handleSessionInfo(ctx),
             },
-            { match: ["new"], execute: () => deps.handleNewChat() },
+            { match: ["new"], execute: ({ ctx }) => deps.handleNewChat(ctx) },
             { match: ["clear"], execute: () => deps.handleClear() },
             {
                 match: ["list", "ls", "history"],

package/dist/cli-tui/commands/subcommands/session-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.js","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/session-commands.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Consolidated /session command handler.\n *\n * Combines: /new, /clear, /session, /sessions, /branch, /queue, /export, /share\n *\n * Usage:\n *   /session              - Show current session info (default)\n *   /session new          - Start a fresh chat session\n *   /session clear        - Clear context and start fresh\n *   /session list         - List recent sessions\n *   /session load <id>    - Load a session by ID\n *   /session branch [n]   - Branch from message n\n *   /session tree         - Navigate the session tree\n *   /session queue        - Show/manage message queue\n *   /session export       - Export session to file\n *   /session share        - Generate shareable HTML\n *   /session favorite     - Mark current session as favorite\n *   /session unfavorite   - Remove favorite mark\n *   /session summary      - Add manual summary\n */\n\nimport type { CommandExecutionContext } from \"../types.js\";\nimport { createSubcommandHandler, isSessionId } from \"./utils.js\";\n\nexport interface SessionCommandDeps {\n\thandleSessionInfo: (ctx: CommandExecutionContext) => void;\n\thandleNewChat: (ctx: CommandExecutionContext) => void | Promise<void>;\n\thandleClear: () => Promise<void> | void;\n\thandleSessionsList: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleBranch: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleTree: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleQueue: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleExport: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleShare: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleRecover: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleCleanup: (ctx: CommandExecutionContext) => Promise<void> | void;\n}\n\nexport function createSessionCommandHandler(deps: SessionCommandDeps) {\n\treturn createSubcommandHandler({\n\t\tdefaultSubcommand: \"info\",\n\t\tshowHelp: showSessionHelp,\n\t\troutes: [\n\t\t\t{\n\t\t\t\tmatch: [\"info\", \"status\"],\n\t\t\t\texecute: ({ ctx }) => deps.handleSessionInfo(ctx),\n\t\t\t},\n\t\t\t{ match: [\"new\"], execute: ({ ctx }) => deps.handleNewChat(ctx) },\n\t\t\t{ match: [\"clear\"], execute: () => deps.handleClear() },\n\t\t\t{\n\t\t\t\tmatch: [\"list\", \"ls\", \"history\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleSessionsList(rewriteContext(\"sessions list\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"load\"],\n\t\t\t\texecute: ({ customContext, restArgumentText }) =>\n\t\t\t\t\tdeps.handleSessionsList(\n\t\t\t\t\t\tcustomContext(\n\t\t\t\t\t\t\t`/sessions load ${restArgumentText}`,\n\t\t\t\t\t\t\t`load ${restArgumentText}`.trim(),\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"branch\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleBranch(rewriteContext(\"branch\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"tree\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleTree(rewriteContext(\"tree\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"queue\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleQueue(rewriteContext(\"queue\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"export\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleExport(rewriteContext(\"export\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"share\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleShare(rewriteContext(\"share\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"favorite\", \"fav\"],\n\t\t\t\texecute: ({ customContext }) =>\n\t\t\t\t\tdeps.handleSessionsList(\n\t\t\t\t\t\tcustomContext(\"/sessions favorite\", \"favorite\"),\n\t\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"unfavorite\", \"unfav\"],\n\t\t\t\texecute: ({ customContext }) =>\n\t\t\t\t\tdeps.handleSessionsList(\n\t\t\t\t\t\tcustomContext(\"/sessions unfavorite\", \"unfavorite\"),\n\t\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"summary\", \"summarize\"],\n\t\t\t\texecute: ({ customContext, restArgumentText }) =>\n\t\t\t\t\tdeps.handleSessionInfo(\n\t\t\t\t\t\tcustomContext(\n\t\t\t\t\t\t\t`/session summary ${restArgumentText}`.trim(),\n\t\t\t\t\t\t\t`summary ${restArgumentText}`.trim(),\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"recover\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleRecover(rewriteContext(\"recover\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"cleanup\", \"prune\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleCleanup(rewriteContext(\"cleanup\")),\n\t\t\t},\n\t\t],\n\t\tonUnknown: async ({ ctx, subcommand, customContext }) => {\n\t\t\tif (isSessionId(subcommand)) {\n\t\t\t\tawait deps.handleSessionsList(\n\t\t\t\t\tcustomContext(`/sessions load ${subcommand}`, `load ${subcommand}`),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.showError(`Unknown subcommand: ${subcommand}`);\n\t\t\tshowSessionHelp(ctx);\n\t\t},\n\t});\n}\n\nfunction showSessionHelp(ctx: CommandExecutionContext): void {\n\tctx.showInfo(`Session Commands:\n  /session              Show current session info\n  /session new          Start a fresh chat session\n  /session clear        Clear context and start fresh\n  /session list         List recent sessions\n  /session load <id>    Load a session by ID or index\n  /session branch [n]   Branch from user message n\n  /session tree         Navigate the session tree\n  /session queue        Show/manage message queue\n  /session export       Export session to file\n  /session share        Generate shareable HTML\n  /session favorite     Mark as favorite\n  /session unfavorite   Remove favorite mark\n  /session summary \"x\"  Add manual summary\n  /session recover      Restore from latest auto-recovery backup\n  /session cleanup      Prune old sessions (respects favorites)\n\nAliases: /s`);\n}\n"]}

package/dist/cli-tui/commands/{grouped → subcommands}/tools-commands.d.ts

@@ -22,7 +22,6 @@ export interface ToolsCommandDeps {
     handleWorkflow: (ctx: CommandExecutionContext) => void | Promise<void>;
     handleRun: (ctx: CommandExecutionContext) => void | Promise<void>;
     handleCommands: (ctx: CommandExecutionContext) => void | Promise<void>;
-    showInfo: (message: string) => void;
 }
 export declare function createToolsCommandHandler(deps: ToolsCommandDeps): (ctx: CommandExecutionContext) => Promise<void>;
 //# sourceMappingURL=tools-commands.d.ts.map

package/dist/cli-tui/commands/subcommands/tools-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/tools-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,WAAW,gBAAgB;IAChC,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,SAAS,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,SAAS,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,SAAS,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,gBAAgB,mDAsD/D"}

package/dist/cli-tui/commands/{grouped → subcommands}/tools-commands.js

@@ -14,9 +14,9 @@
  *   /tools run <script>     - Run npm scripts
  *   /tools commands         - User command management
  */
-import { createGroupedCommandHandler } from "./utils.js";
+import { createSubcommandHandler } from "./utils.js";
 export function createToolsCommandHandler(deps) {
-    return createGroupedCommandHandler({
+    return createSubcommandHandler({
         defaultSubcommand: "list",
         showHelp: showToolsHelp,
         routes: [

package/dist/cli-tui/commands/subcommands/tools-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-commands.js","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/tools-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAWrD,MAAM,UAAU,yBAAyB,CAAC,IAAsB;IAC/D,OAAO,uBAAuB,CAAC;QAC9B,iBAAiB,EAAE,MAAM;QACzB,QAAQ,EAAE,aAAa;QACvB,MAAM,EAAE;YACP;gBACC,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC;gBACnC,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAC9B,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;aACvD;YACD;gBACC,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC;gBACvC,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAC9B,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;aAC/D;YACD;gBACC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;gBACzB,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAC9B,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;aACzD;YACD;gBACC,KAAK,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;gBACzB,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;aACtE;YACD;gBACC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC;gBAC1B,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;aACtE;YACD;gBACC,KAAK,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC;gBACtC,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;aAChD;YACD;gBACC,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC;gBAC/B,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;aACtE;YACD;gBACC,KAAK,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC;gBAClC,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;aAChD;SACD;QACD,SAAS,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;YAC7D,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,CAAC,SAAS,CACnB,aAAa,CAAC,QAAQ,GAAG,CAAC,YAAY,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,CAC3D,CAAC;gBACF,OAAO;YACR,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;YACnD,aAAa,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAA4B;IAClD,GAAG,CAAC,QAAQ,CAAC;;;;;;;;;;;4EAW8D,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["/**\n * Consolidated /tools command handler.\n *\n * Combines: /tools, /mcp, /lsp, /workflow, /run, /commands\n *\n * Usage:\n *   /tools                  - Show available tools\n *   /tools list             - List all tools\n *   /tools failures         - Show tool failures\n *   /tools clear            - Clear tool logs\n *   /tools mcp              - Show, search, or manage MCP servers, approvals, and auth presets\n *   /tools lsp [cmd]        - LSP server management\n *   /tools workflow [cmd]   - Run workflows\n *   /tools run <script>     - Run npm scripts\n *   /tools commands         - User command management\n */\n\nimport type { CommandExecutionContext } from \"../types.js\";\nimport { createSubcommandHandler } from \"./utils.js\";\n\nexport interface ToolsCommandDeps {\n\thandleTools: (ctx: CommandExecutionContext) => void | Promise<void>;\n\thandleMcp: (ctx: CommandExecutionContext) => void | Promise<void>;\n\thandleLsp: (ctx: CommandExecutionContext) => void | Promise<void>;\n\thandleWorkflow: (ctx: CommandExecutionContext) => void | Promise<void>;\n\thandleRun: (ctx: CommandExecutionContext) => void | Promise<void>;\n\thandleCommands: (ctx: CommandExecutionContext) => void | Promise<void>;\n}\n\nexport function createToolsCommandHandler(deps: ToolsCommandDeps) {\n\treturn createSubcommandHandler({\n\t\tdefaultSubcommand: \"list\",\n\t\tshowHelp: showToolsHelp,\n\t\troutes: [\n\t\t\t{\n\t\t\t\tmatch: [\"list\", \"all\", \"available\"],\n\t\t\t\texecute: ({ customContext }) =>\n\t\t\t\t\tdeps.handleTools(customContext(\"/tools list\", \"list\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"failures\", \"errors\", \"failed\"],\n\t\t\t\texecute: ({ customContext }) =>\n\t\t\t\t\tdeps.handleTools(customContext(\"/tools failures\", \"failures\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"clear\", \"reset\"],\n\t\t\t\texecute: ({ customContext }) =>\n\t\t\t\t\tdeps.handleTools(customContext(\"/tools clear\", \"clear\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"mcp\", \"servers\"],\n\t\t\t\texecute: ({ rewriteContext }) => deps.handleMcp(rewriteContext(\"mcp\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"lsp\", \"language\"],\n\t\t\t\texecute: ({ rewriteContext }) => deps.handleLsp(rewriteContext(\"lsp\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"workflow\", \"workflows\", \"wf\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleWorkflow(rewriteContext(\"workflow\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"run\", \"script\", \"npm\"],\n\t\t\t\texecute: ({ rewriteContext }) => deps.handleRun(rewriteContext(\"run\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"commands\", \"cmd\", \"user\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleCommands(rewriteContext(\"commands\")),\n\t\t\t},\n\t\t],\n\t\tonUnknown: async ({ ctx, subcommand, args, customContext }) => {\n\t\t\tif (args[0] && !args[0].startsWith(\"-\")) {\n\t\t\t\tawait deps.handleRun(\n\t\t\t\t\tcustomContext(`/run ${ctx.argumentText}`, ctx.argumentText),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.showError(`Unknown subcommand: ${subcommand}`);\n\t\t\tshowToolsHelp(ctx);\n\t\t},\n\t});\n}\n\nfunction showToolsHelp(ctx: CommandExecutionContext): void {\n\tctx.showInfo(`Tools Commands:\n  /tools                  Show available tools\n  /tools list             List all tools\n  /tools failures         Show tool failures\n  /tools clear            Clear tool logs\n  /tools mcp              Show, search, or manage MCP servers, approvals, and auth presets\n  /tools lsp [cmd]        LSP (status|start|stop|restart|detect)\n  /tools workflow [cmd]   Workflows (list|run|validate|show)\n  /tools run <script>     Run npm script\n  /tools commands         User command management\n\nDirect shortcuts still work: /tools, /mcp, /lsp, /workflow, /run, /commands`);\n}\n"]}

package/dist/cli-tui/commands/{grouped → subcommands}/ui-commands.d.ts

@@ -19,7 +19,6 @@ export interface UiCommandDeps {
     handleFooter: (ctx: CommandExecutionContext) => void;
     handleZen: (ctx: CommandExecutionContext) => void;
     handleCompactTools: (ctx: CommandExecutionContext) => void;
-    showInfo: (message: string) => void;
     getUiState: () => {
         zenMode: boolean;
         cleanMode: string;

package/dist/cli-tui/commands/subcommands/ui-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/ui-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACpD,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACpD,YAAY,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACrD,SAAS,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAClD,kBAAkB,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC3D,UAAU,EAAE,MAAM;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,OAAO,CAAC;KACtB,CAAC;CACF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,mDA6CzD"}

package/dist/cli-tui/commands/{grouped → subcommands}/ui-commands.js

@@ -12,15 +12,15 @@
  *   /ui zen [on|off]      - Toggle zen mode
  *   /ui compact [on|off]  - Toggle tool output folding
  */
-import { createGroupedCommandHandler } from "./utils.js";
+import { createSubcommandHandler } from "./utils.js";
 export function createUiCommandHandler(deps) {
-    return createGroupedCommandHandler({
+    return createSubcommandHandler({
         defaultSubcommand: "status",
         showHelp: showUiHelp,
         routes: [
             {
                 match: ["status", "info"],
-                execute: () => showUiStatus(deps),
+                execute: ({ ctx }) => showUiStatus(ctx, deps),
             },
             {
                 match: ["theme", "color", "colors"],
@@ -49,9 +49,9 @@ export function createUiCommandHandler(deps) {
         ],
     });
 }
-function showUiStatus(deps) {
+function showUiStatus(ctx, deps) {
     const state = deps.getUiState();
-    deps.showInfo(`UI Settings:
+    ctx.showInfo(`UI Settings:
   Zen Mode: ${state.zenMode ? "on" : "off"}
   Clean Mode: ${state.cleanMode}
   Footer: ${state.footerMode}

package/dist/cli-tui/commands/subcommands/ui-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-commands.js","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/ui-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAgBrD,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACzD,OAAO,uBAAuB,CAAC;QAC9B,iBAAiB,EAAE,QAAQ;QAC3B,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE;YACP;gBACC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACzB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC;aAC7C;YACD;gBACC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC;gBACnC,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;aAC1C;YACD;gBACC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;gBACzB,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;aAC1C;YACD;gBACC,KAAK,EAAE,CAAC,QAAQ,CAAC;gBACjB,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;aAC5C;YACD;gBACC,KAAK,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;gBAClC,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAChD,IAAI,CAAC,YAAY,CAChB,aAAa,CACZ,WAAW,gBAAgB,IAAI,SAAS,EAAE,EAC1C,gBAAgB,IAAI,SAAS,CAC7B,CACD;aACF;YACD;gBACC,KAAK,EAAE,CAAC,KAAK,CAAC;gBACd,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;aACtE;YACD;gBACC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;gBAC1B,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;aACzD;SACD;KACD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAA4B,EAAE,IAAmB;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAChC,GAAG,CAAC,QAAQ,CAAC;cACA,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;gBAC1B,KAAK,CAAC,SAAS;YACnB,KAAK,CAAC,UAAU;mBACT,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;;uCAEb,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,UAAU,CAAC,GAA4B;IAC/C,GAAG,CAAC,QAAQ,CAAC;;;;;;;;;mDASqC,CAAC,CAAC;AACrD,CAAC","sourcesContent":["/**\n * Consolidated /ui command handler.\n *\n * Combines: /theme, /clean, /footer, /alerts, /zen, /compact-tools\n *\n * Usage:\n *   /ui                   - Show current UI settings\n *   /ui theme             - Open theme selector\n *   /ui clean [mode]      - Toggle text deduplication (off|soft|aggressive)\n *   /ui footer [mode]     - Footer style (ensemble|solo|history|clear)\n *   /ui alerts [cmd]      - Alert management (history|clear)\n *   /ui zen [on|off]      - Toggle zen mode\n *   /ui compact [on|off]  - Toggle tool output folding\n */\n\nimport type { CommandExecutionContext } from \"../types.js\";\nimport { createSubcommandHandler } from \"./utils.js\";\n\nexport interface UiCommandDeps {\n\thandleTheme: (ctx: CommandExecutionContext) => void;\n\thandleClean: (ctx: CommandExecutionContext) => void;\n\thandleFooter: (ctx: CommandExecutionContext) => void;\n\thandleZen: (ctx: CommandExecutionContext) => void;\n\thandleCompactTools: (ctx: CommandExecutionContext) => void;\n\tgetUiState: () => {\n\t\tzenMode: boolean;\n\t\tcleanMode: string;\n\t\tfooterMode: string;\n\t\tcompactTools: boolean;\n\t};\n}\n\nexport function createUiCommandHandler(deps: UiCommandDeps) {\n\treturn createSubcommandHandler({\n\t\tdefaultSubcommand: \"status\",\n\t\tshowHelp: showUiHelp,\n\t\troutes: [\n\t\t\t{\n\t\t\t\tmatch: [\"status\", \"info\"],\n\t\t\t\texecute: ({ ctx }) => showUiStatus(ctx, deps),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"theme\", \"color\", \"colors\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleTheme(rewriteContext(\"theme\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"clean\", \"dedup\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleClean(rewriteContext(\"clean\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"footer\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleFooter(rewriteContext(\"footer\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"alerts\", \"notifications\"],\n\t\t\t\texecute: ({ customContext, restArgumentText }) =>\n\t\t\t\t\tdeps.handleFooter(\n\t\t\t\t\t\tcustomContext(\n\t\t\t\t\t\t\t`/footer ${restArgumentText || \"history\"}`,\n\t\t\t\t\t\t\trestArgumentText || \"history\",\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"zen\"],\n\t\t\t\texecute: ({ rewriteContext }) => deps.handleZen(rewriteContext(\"zen\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"compact\", \"fold\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleCompactTools(rewriteContext(\"compact-tools\")),\n\t\t\t},\n\t\t],\n\t});\n}\n\nfunction showUiStatus(ctx: CommandExecutionContext, deps: UiCommandDeps): void {\n\tconst state = deps.getUiState();\n\tctx.showInfo(`UI Settings:\n  Zen Mode: ${state.zenMode ? \"on\" : \"off\"}\n  Clean Mode: ${state.cleanMode}\n  Footer: ${state.footerMode}\n  Compact Tools: ${state.compactTools ? \"on\" : \"off\"}\n\nUse /ui <setting> to change a setting.`);\n}\n\nfunction showUiHelp(ctx: CommandExecutionContext): void {\n\tctx.showInfo(`UI Commands:\n  /ui                   Show current UI settings\n  /ui theme             Open theme selector\n  /ui clean [mode]      Text deduplication (off|soft|aggressive)\n  /ui footer [mode]     Footer style (ensemble|solo)\n  /ui alerts [cmd]      Alerts (history|clear)\n  /ui zen [on|off]      Toggle zen mode\n  /ui compact [on|off]  Toggle tool output folding\n\nDirect shortcuts still work: /theme, /zen, /footer`);\n}\n"]}

package/dist/cli-tui/commands/{grouped → subcommands}/undo-commands.d.ts

@@ -1,5 +1,5 @@
 /**
- * Grouped /undo command handler.
+ * Command-suite /undo handler.
  *
  * Combines: /undo, /checkpoint, /changes
  *
@@ -15,7 +15,6 @@ export interface UndoCommandDeps {
     handleUndo: (ctx: CommandExecutionContext) => Promise<void> | void;
     handleCheckpoint: (ctx: CommandExecutionContext) => Promise<void> | void;
     handleChanges: (ctx: CommandExecutionContext) => void;
-    showInfo: (message: string) => void;
     getUndoState: () => {
         canUndo: boolean;
         undoCount: number;

package/dist/cli-tui/commands/subcommands/undo-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/undo-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnE,gBAAgB,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzE,aAAa,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACtD,YAAY,EAAE,MAAM;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,mDA4C7D"}

package/dist/cli-tui/commands/{grouped → subcommands}/undo-commands.js

@@ -1,5 +1,5 @@
 /**
- * Grouped /undo command handler.
+ * Command-suite /undo handler.
  *
  * Combines: /undo, /checkpoint, /changes
  *
@@ -10,9 +10,9 @@
  *   /undo changes          - List tracked file changes
  *   /undo history          - Show undo/redo history
  */
-import { createGroupedCommandHandler, isNumericArg } from "./utils.js";
+import { createSubcommandHandler, isNumericArg } from "./utils.js";
 export function createUndoCommandHandler(deps) {
-    return createGroupedCommandHandler({
+    return createSubcommandHandler({
         defaultSubcommand: "undo",
         showHelp: showUndoHelp,
         routes: [
@@ -30,7 +30,7 @@ export function createUndoCommandHandler(deps) {
             },
             {
                 match: ["history", "list", "status"],
-                execute: () => showUndoHistory(deps),
+                execute: ({ ctx }) => showUndoHistory(ctx, deps),
             },
         ],
         onUnknown: async ({ ctx, subcommand, args, customContext }) => {
@@ -47,12 +47,12 @@ export function createUndoCommandHandler(deps) {
         },
     });
 }
-function showUndoHistory(deps) {
+function showUndoHistory(ctx, deps) {
     const state = deps.getUndoState();
     const checkpointList = state.checkpoints.length > 0
         ? state.checkpoints.map((c) => `  - ${c}`).join("\n")
         : "  (none)";
-    deps.showInfo(`Undo Status:
+    ctx.showInfo(`Undo Status:
   Can Undo: ${state.canUndo ? "yes" : "no"} (${state.undoCount} tracked changes)
 
 Checkpoints:

package/dist/cli-tui/commands/subcommands/undo-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-commands.js","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/undo-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAanE,MAAM,UAAU,wBAAwB,CAAC,IAAqB;IAC7D,OAAO,uBAAuB,CAAC;QAC9B,iBAAiB,EAAE,MAAM;QACzB,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE;YACP;gBACC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;gBACjC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;aAC1C;YACD;gBACC,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;gBACjD,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;aACpD;YACD;gBACC,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;gBACtC,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAChD,IAAI,CAAC,aAAa,CACjB,aAAa,CAAC,YAAY,gBAAgB,EAAE,EAAE,gBAAgB,CAAC,CAC/D;aACF;YACD;gBACC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;gBACpC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC;aAChD;SACD;QACD,SAAS,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;YAC7D,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;gBACxE,OAAO;YACR,CAAC;YACD,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,CAAC,gBAAgB,CAC1B,aAAa,CACZ,uBAAuB,GAAG,CAAC,YAAY,EAAE,EACzC,WAAW,GAAG,CAAC,YAAY,EAAE,CAC7B,CACD,CAAC;gBACF,OAAO;YACR,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;YACnD,YAAY,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACvB,GAA4B,EAC5B,IAAqB;IAErB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IAClC,MAAM,cAAc,GACnB,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAC3B,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACrD,CAAC,CAAC,UAAU,CAAC;IAEf,GAAG,CAAC,QAAQ,CAAC;cACA,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,SAAS;;;EAG5D,cAAc;;0CAE0B,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CAAC,GAA4B;IACjD,GAAG,CAAC,QAAQ,CAAC;;;;;;;;mDAQqC,CAAC,CAAC;AACrD,CAAC","sourcesContent":["/**\n * Command-suite /undo handler.\n *\n * Combines: /undo, /checkpoint, /changes\n *\n * Usage:\n *   /undo                  - Undo last action\n *   /undo [N]              - Undo last N actions\n *   /undo checkpoint [name] - Create/restore checkpoint\n *   /undo changes          - List tracked file changes\n *   /undo history          - Show undo/redo history\n */\n\nimport type { CommandExecutionContext } from \"../types.js\";\nimport { createSubcommandHandler, isNumericArg } from \"./utils.js\";\n\nexport interface UndoCommandDeps {\n\thandleUndo: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleCheckpoint: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleChanges: (ctx: CommandExecutionContext) => void;\n\tgetUndoState: () => {\n\t\tcanUndo: boolean;\n\t\tundoCount: number;\n\t\tcheckpoints: string[];\n\t};\n}\n\nexport function createUndoCommandHandler(deps: UndoCommandDeps) {\n\treturn createSubcommandHandler({\n\t\tdefaultSubcommand: \"undo\",\n\t\tshowHelp: showUndoHelp,\n\t\troutes: [\n\t\t\t{\n\t\t\t\tmatch: [\"undo\", \"back\", \"revert\"],\n\t\t\t\texecute: ({ ctx }) => deps.handleUndo(ctx),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"checkpoint\", \"save\", \"snap\", \"snapshot\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleCheckpoint(rewriteContext(\"checkpoint\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"changes\", \"files\", \"tracked\"],\n\t\t\t\texecute: ({ customContext, restArgumentText }) =>\n\t\t\t\t\tdeps.handleChanges(\n\t\t\t\t\t\tcustomContext(`/changes ${restArgumentText}`, restArgumentText),\n\t\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"history\", \"list\", \"status\"],\n\t\t\t\texecute: ({ ctx }) => showUndoHistory(ctx, deps),\n\t\t\t},\n\t\t],\n\t\tonUnknown: async ({ ctx, subcommand, args, customContext }) => {\n\t\t\tif (isNumericArg(subcommand)) {\n\t\t\t\tawait deps.handleUndo(customContext(`/undo ${subcommand}`, subcommand));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (args[0] && !args[0].startsWith(\"-\")) {\n\t\t\t\tawait deps.handleCheckpoint(\n\t\t\t\t\tcustomContext(\n\t\t\t\t\t\t`/checkpoint restore ${ctx.argumentText}`,\n\t\t\t\t\t\t`restore ${ctx.argumentText}`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.showError(`Unknown subcommand: ${subcommand}`);\n\t\t\tshowUndoHelp(ctx);\n\t\t},\n\t});\n}\n\nfunction showUndoHistory(\n\tctx: CommandExecutionContext,\n\tdeps: UndoCommandDeps,\n): void {\n\tconst state = deps.getUndoState();\n\tconst checkpointList =\n\t\tstate.checkpoints.length > 0\n\t\t\t? state.checkpoints.map((c) => `  - ${c}`).join(\"\\n\")\n\t\t\t: \"  (none)\";\n\n\tctx.showInfo(`Undo Status:\n  Can Undo: ${state.canUndo ? \"yes\" : \"no\"} (${state.undoCount} tracked changes)\n\nCheckpoints:\n${checkpointList}\n\nUse /undo or /undo <N> to revert changes.`);\n}\n\nfunction showUndoHelp(ctx: CommandExecutionContext): void {\n\tctx.showInfo(`Undo Commands:\n  /undo                  Undo last action\n  /undo <N>              Undo last N actions\n  /undo checkpoint [name] Create named checkpoint\n  /undo checkpoint restore <name> Restore checkpoint\n  /undo changes          List tracked file changes\n  /undo history          Show undo status and checkpoints\n\nDirect shortcuts still work: /checkpoint, /changes`);\n}\n"]}

package/dist/cli-tui/commands/subcommands/usage-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/usage-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnE,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,gBAAgB,mDAyC/D"}

package/dist/cli-tui/commands/{grouped → subcommands}/usage-commands.js

@@ -9,9 +9,9 @@
  *   /usage quota [cmd]    - Token quota (detailed|models|alerts|limit <n>)
  *   /usage stats          - Combined status and cost
  */
-import { createGroupedCommandHandler } from "./utils.js";
+import { createSubcommandHandler } from "./utils.js";
 export function createUsageCommandHandler(deps) {
-    return createGroupedCommandHandler({
+    return createSubcommandHandler({
         defaultSubcommand: "overview",
         showHelp: showUsageHelp,
         routes: [

package/dist/cli-tui/commands/subcommands/usage-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-commands.js","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/usage-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAQrD,MAAM,UAAU,yBAAyB,CAAC,IAAsB;IAC/D,OAAO,uBAAuB,CAAC;QAC9B,iBAAiB,EAAE,UAAU;QAC7B,QAAQ,EAAE,aAAa;QACvB,MAAM,EAAE;YACP;gBACC,KAAK,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;gBAC9B,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;aAC3C;YACD;gBACC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;gBACjC,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;aACxC;YACD;gBACC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;gBAC7C,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;aAC1C;YACD;gBACC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;gBACvB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;aAC3C;SACD;QACD,SAAS,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,EAAE;YACvD,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzE,MAAM,IAAI,CAAC,UAAU,CACpB,aAAa,CAAC,SAAS,GAAG,CAAC,YAAY,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,CAC5D,CAAC;gBACF,OAAO;YACR,CAAC;YACD,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,CAAC,WAAW,CACrB,aAAa,CAAC,UAAU,GAAG,CAAC,YAAY,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,CAC7D,CAAC;gBACF,OAAO;YACR,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;YACnD,aAAa,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAA4B;IAClD,GAAG,CAAC,QAAQ,CAAC;;;;;;;;;;;mDAWqC,CAAC,CAAC;AACrD,CAAC","sourcesContent":["/**\n * Consolidated /usage command handler.\n *\n * Combines: /cost, /quota, /stats\n *\n * Usage:\n *   /usage                - Show usage overview\n *   /usage cost [period]  - Show costs (breakdown <period>|clear)\n *   /usage quota [cmd]    - Token quota (detailed|models|alerts|limit <n>)\n *   /usage stats          - Combined status and cost\n */\n\nimport type { CommandExecutionContext } from \"../types.js\";\nimport { createSubcommandHandler } from \"./utils.js\";\n\nexport interface UsageCommandDeps {\n\thandleCost: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleQuota: (ctx: CommandExecutionContext) => Promise<void> | void;\n\thandleStats: (ctx: CommandExecutionContext) => Promise<void> | void;\n}\n\nexport function createUsageCommandHandler(deps: UsageCommandDeps) {\n\treturn createSubcommandHandler({\n\t\tdefaultSubcommand: \"overview\",\n\t\tshowHelp: showUsageHelp,\n\t\troutes: [\n\t\t\t{\n\t\t\t\tmatch: [\"overview\", \"summary\"],\n\t\t\t\texecute: ({ ctx }) => deps.handleStats(ctx),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"cost\", \"costs\", \"spend\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleCost(rewriteContext(\"cost\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"quota\", \"tokens\", \"limit\", \"limits\"],\n\t\t\t\texecute: ({ rewriteContext }) =>\n\t\t\t\t\tdeps.handleQuota(rewriteContext(\"quota\")),\n\t\t\t},\n\t\t\t{\n\t\t\t\tmatch: [\"stats\", \"all\"],\n\t\t\t\texecute: ({ ctx }) => deps.handleStats(ctx),\n\t\t\t},\n\t\t],\n\t\tonUnknown: async ({ ctx, subcommand, customContext }) => {\n\t\t\tif ([\"breakdown\", \"clear\", \"week\", \"month\", \"day\"].includes(subcommand)) {\n\t\t\t\tawait deps.handleCost(\n\t\t\t\t\tcustomContext(`/cost ${ctx.argumentText}`, ctx.argumentText),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif ([\"detailed\", \"models\", \"alerts\"].includes(subcommand)) {\n\t\t\t\tawait deps.handleQuota(\n\t\t\t\t\tcustomContext(`/quota ${ctx.argumentText}`, ctx.argumentText),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.showError(`Unknown subcommand: ${subcommand}`);\n\t\t\tshowUsageHelp(ctx);\n\t\t},\n\t});\n}\n\nfunction showUsageHelp(ctx: CommandExecutionContext): void {\n\tctx.showInfo(`Usage Commands:\n  /usage                Show usage overview\n  /usage cost           Show cost summary\n  /usage cost breakdown <period>  Detailed cost breakdown\n  /usage cost clear     Clear cost history\n  /usage quota          Show token quota status\n  /usage quota detailed Full quota details (enterprise)\n  /usage quota models   Per-model breakdown (enterprise)\n  /usage quota limit <n> Set session token limit\n  /usage stats          Combined status and cost\n\nDirect shortcuts still work: /cost, /quota, /stats`);\n}\n"]}

package/dist/cli-tui/commands/{grouped → subcommands}/utils.d.ts

@@ -1,8 +1,8 @@
 /**
- * Shared utilities for grouped command handlers.
+ * Shared utilities for subcommand suite handlers.
  *
  * Provides consistent argument parsing and context rewriting
- * across all grouped command implementations.
+ * across all subcommand suite implementations.
  */
 import type { AutocompleteItem } from "@evalops/tui";
 import type { CommandExecutionContext } from "../types.js";
@@ -20,32 +20,32 @@ export interface ParsedSubcommand {
     customContext: (rawInput: string, argumentText: string) => CommandExecutionContext;
 }
 /**
- * Runtime context passed to declarative grouped command routes.
+ * Runtime context passed to declarative subcommand suite routes.
  */
-export interface GroupedCommandRouteContext extends ParsedSubcommand {
+export interface SubcommandRouteContext extends ParsedSubcommand {
     ctx: CommandExecutionContext;
     /** Arguments after the matched subcommand */
     restArgs: string[];
     /** Original argument text after the matched subcommand */
     restArgumentText: string;
-    /** Show the grouped command help for the current command */
+    /** Show the subcommand suite help for the current command */
     showHelp: () => void;
 }
 /**
- * One grouped subcommand route, matched either by aliases or custom logic.
+ * One subcommand route, matched either by aliases or custom logic.
  */
-export interface GroupedCommandRoute {
-    match: readonly string[] | ((context: GroupedCommandRouteContext) => boolean);
-    execute: (context: GroupedCommandRouteContext) => void | Promise<void>;
+export interface SubcommandRoute {
+    match: readonly string[] | ((context: SubcommandRouteContext) => boolean);
+    execute: (context: SubcommandRouteContext) => void | Promise<void>;
 }
 /**
- * Declarative grouped command handler configuration.
+ * Declarative subcommand suite handler configuration.
  */
-export interface GroupedCommandHandlerOptions {
+export interface SubcommandHandlerOptions {
     defaultSubcommand: string;
-    routes: readonly GroupedCommandRoute[];
+    routes: readonly SubcommandRoute[];
     showHelp: (ctx: CommandExecutionContext) => void;
-    onUnknown?: (context: GroupedCommandRouteContext) => void | Promise<void>;
+    onUnknown?: (context: SubcommandRouteContext) => void | Promise<void>;
 }
 /**
  * Parse subcommand arguments from a context with a default subcommand.
@@ -64,7 +64,7 @@ export interface GroupedCommandHandlerOptions {
  * ```
  */
 export declare function parseSubcommand(ctx: CommandExecutionContext, defaultSubcommand: string): ParsedSubcommand;
-export declare function createGroupedCommandHandler({ defaultSubcommand, routes, showHelp, onUnknown, }: GroupedCommandHandlerOptions): (ctx: CommandExecutionContext) => Promise<void>;
+export declare function createSubcommandHandler({ defaultSubcommand, routes, showHelp, onUnknown, }: SubcommandHandlerOptions): (ctx: CommandExecutionContext) => Promise<void>;
 /**
  * Check if a string matches common help aliases.
  */
@@ -100,7 +100,7 @@ export interface SubcommandDef {
     aliases?: string[];
 }
 /**
- * Create an autocomplete provider for grouped command subcommands.
+ * Create an autocomplete provider for command suite subcommands.
  *
  * @example
  * ```ts

package/dist/cli-tui/commands/subcommands/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/utils.ts"],"names":[],"mappings":"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"}

package/dist/cli-tui/commands/{grouped → subcommands}/utils.js

@@ -1,10 +1,10 @@
 /**
- * Shared utilities for grouped command handlers.
+ * Shared utilities for subcommand suite handlers.
  *
  * Provides consistent argument parsing and context rewriting
- * across all grouped command implementations.
+ * across all subcommand suite implementations.
  */
-function isGroupedCommandAliasMatch(match) {
+function isSubcommandAliasMatch(match) {
     return Array.isArray(match);
 }
 /**
@@ -38,8 +38,8 @@ export function parseSubcommand(ctx, defaultSubcommand) {
     });
     return { subcommand, args, rewriteContext, customContext };
 }
-export function createGroupedCommandHandler({ defaultSubcommand, routes, showHelp, onUnknown, }) {
-    return async function handleGroupedCommand(ctx) {
+export function createSubcommandHandler({ defaultSubcommand, routes, showHelp, onUnknown, }) {
+    return async function handleSubcommand(ctx) {
         const parsed = parseSubcommand(ctx, defaultSubcommand);
         const routeContext = {
             ctx,
@@ -52,7 +52,7 @@ export function createGroupedCommandHandler({ defaultSubcommand, routes, showHel
             showHelp(ctx);
             return;
         }
-        const route = routes.find((candidate) => isGroupedCommandAliasMatch(candidate.match)
+        const route = routes.find((candidate) => isSubcommandAliasMatch(candidate.match)
             ? matchesAlias(routeContext.subcommand, candidate.match)
             : candidate.match(routeContext));
         if (route) {
@@ -102,7 +102,7 @@ export function matchesAlias(subcommand, aliases) {
     return aliases.includes(subcommand.toLowerCase());
 }
 /**
- * Create an autocomplete provider for grouped command subcommands.
+ * Create an autocomplete provider for command suite subcommands.
  *
  * @example
  * ```ts
@@ -137,7 +137,7 @@ export function createSubcommandCompletions(subcommands) {
     };
 }
 // ═══════════════════════════════════════════════════════════════════════════
-// Predefined subcommand completions for grouped commands
+// Predefined subcommand completions for command suites
 // ═══════════════════════════════════════════════════════════════════════════
 export const SESSION_SUBCOMMANDS = [
     {
@@ -286,6 +286,11 @@ export const AUTH_SUBCOMMANDS = [
     },
     { name: "login", description: "Authenticate", aliases: ["signin"] },
     { name: "logout", description: "Remove credentials", aliases: ["signout"] },
+    {
+        name: "source-of-truth",
+        description: "Set connector source-of-truth policy",
+        aliases: ["sot", "policy"],
+    },
 ];
 export const USAGE_SUBCOMMANDS = [
     {

package/dist/cli-tui/commands/subcommands/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/cli-tui/commands/subcommands/utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared utilities for subcommand suite handlers.\n *\n * Provides consistent argument parsing and context rewriting\n * across all subcommand suite implementations.\n */\n\nimport type { AutocompleteItem } from \"@evalops/tui\";\nimport type { CommandExecutionContext } from \"../types.js\";\n\n/**\n * Result of parsing subcommand arguments.\n */\nexport interface ParsedSubcommand {\n\t/** The subcommand name (first argument, lowercased) */\n\tsubcommand: string;\n\t/** All arguments split by whitespace */\n\targs: string[];\n\t/** Creates a new context for delegating to another command */\n\trewriteContext: (cmd: string) => CommandExecutionContext;\n\t/** Creates a context with custom raw input and argument text */\n\tcustomContext: (\n\t\trawInput: string,\n\t\targumentText: string,\n\t) => CommandExecutionContext;\n}\n\n/**\n * Runtime context passed to declarative subcommand suite routes.\n */\nexport interface SubcommandRouteContext extends ParsedSubcommand {\n\tctx: CommandExecutionContext;\n\t/** Arguments after the matched subcommand */\n\trestArgs: string[];\n\t/** Original argument text after the matched subcommand */\n\trestArgumentText: string;\n\t/** Show the subcommand suite help for the current command */\n\tshowHelp: () => void;\n}\n\n/**\n * One subcommand route, matched either by aliases or custom logic.\n */\nexport interface SubcommandRoute {\n\tmatch: readonly string[] | ((context: SubcommandRouteContext) => boolean);\n\texecute: (context: SubcommandRouteContext) => void | Promise<void>;\n}\n\n/**\n * Declarative subcommand suite handler configuration.\n */\nexport interface SubcommandHandlerOptions {\n\tdefaultSubcommand: string;\n\troutes: readonly SubcommandRoute[];\n\tshowHelp: (ctx: CommandExecutionContext) => void;\n\tonUnknown?: (context: SubcommandRouteContext) => void | Promise<void>;\n}\n\nfunction isSubcommandAliasMatch(\n\tmatch: SubcommandRoute[\"match\"],\n): match is readonly string[] {\n\treturn Array.isArray(match);\n}\n\n/**\n * Parse subcommand arguments from a context with a default subcommand.\n *\n * @example\n * ```ts\n * const { subcommand, args, rewriteContext } = parseSubcommand(ctx, \"status\");\n * switch (subcommand) {\n *   case \"status\":\n *     deps.handleStatus();\n *     break;\n *   case \"start\":\n *     await deps.handleStart(rewriteContext(\"start\"));\n *     break;\n * }\n * ```\n */\nexport function parseSubcommand(\n\tctx: CommandExecutionContext,\n\tdefaultSubcommand: string,\n): ParsedSubcommand {\n\tconst args = ctx.argumentText.trim().split(/\\s+/);\n\tconst subcommand = args[0]?.toLowerCase() || defaultSubcommand;\n\n\tconst rewriteContext = (cmd: string): CommandExecutionContext => ({\n\t\t...ctx,\n\t\trawInput: `/${cmd} ${args.slice(1).join(\" \")}`.trim(),\n\t\targumentText: args.slice(1).join(\" \"),\n\t});\n\n\tconst customContext = (\n\t\trawInput: string,\n\t\targumentText: string,\n\t): CommandExecutionContext => ({\n\t\t...ctx,\n\t\trawInput,\n\t\targumentText,\n\t});\n\n\treturn { subcommand, args, rewriteContext, customContext };\n}\n\nexport function createSubcommandHandler({\n\tdefaultSubcommand,\n\troutes,\n\tshowHelp,\n\tonUnknown,\n}: SubcommandHandlerOptions) {\n\treturn async function handleSubcommand(\n\t\tctx: CommandExecutionContext,\n\t): Promise<void> {\n\t\tconst parsed = parseSubcommand(ctx, defaultSubcommand);\n\t\tconst routeContext: SubcommandRouteContext = {\n\t\t\tctx,\n\t\t\t...parsed,\n\t\t\trestArgs: parsed.args.slice(1),\n\t\t\trestArgumentText: parsed.args.slice(1).join(\" \"),\n\t\t\tshowHelp: () => showHelp(ctx),\n\t\t};\n\n\t\tif (isHelpRequest(routeContext.subcommand)) {\n\t\t\tshowHelp(ctx);\n\t\t\treturn;\n\t\t}\n\n\t\tconst route = routes.find((candidate) =>\n\t\t\tisSubcommandAliasMatch(candidate.match)\n\t\t\t\t? matchesAlias(routeContext.subcommand, candidate.match)\n\t\t\t\t: candidate.match(routeContext),\n\t\t);\n\t\tif (route) {\n\t\t\tawait route.execute(routeContext);\n\t\t\treturn;\n\t\t}\n\n\t\tif (onUnknown) {\n\t\t\tawait onUnknown(routeContext);\n\t\t\treturn;\n\t\t}\n\n\t\tctx.showError(`Unknown subcommand: ${routeContext.subcommand}`);\n\t\tshowHelp(ctx);\n\t};\n}\n\n/**\n * Check if a string matches common help aliases.\n */\nexport function isHelpRequest(subcommand: string): boolean {\n\treturn [\"help\", \"?\", \"-h\", \"--help\"].includes(subcommand);\n}\n\n/**\n * Check if a string looks like a numeric argument.\n */\nexport function isNumericArg(value: string): boolean {\n\treturn /^\\d+$/.test(value);\n}\n\n/**\n * Check if a string looks like a session ID (hex string or number).\n */\nexport function isSessionId(value: string): boolean {\n\treturn /^[a-f0-9-]+$/i.test(value) || /^\\d+$/.test(value);\n}\n\n/**\n * Common aliases for subcommands across handlers.\n */\nexport const COMMON_ALIASES = {\n\tstatus: [\"status\", \"st\", \"info\"],\n\tlist: [\"list\", \"ls\", \"all\"],\n\thelp: [\"help\", \"?\", \"-h\", \"--help\"],\n\tenable: [\"enable\", \"on\", \"yes\", \"true\", \"1\"],\n\tdisable: [\"disable\", \"off\", \"no\", \"false\", \"0\"],\n} as const;\n\n/**\n * Check if a subcommand matches any of the given aliases.\n */\nexport function matchesAlias(\n\tsubcommand: string,\n\taliases: readonly string[],\n): boolean {\n\treturn aliases.includes(subcommand.toLowerCase());\n}\n\n/**\n * Subcommand definition for autocomplete.\n */\nexport interface SubcommandDef {\n\tname: string;\n\tdescription: string;\n\taliases?: string[];\n}\n\n/**\n * Create an autocomplete provider for command suite subcommands.\n *\n * @example\n * ```ts\n * const completions = createSubcommandCompletions([\n *   { name: \"status\", description: \"Show status\", aliases: [\"st\"] },\n *   { name: \"list\", description: \"List items\", aliases: [\"ls\"] },\n * ]);\n * // Use in command definition:\n * { name: \"mygroup\", getArgumentCompletions: completions }\n * ```\n */\nexport function createSubcommandCompletions(\n\tsubcommands: readonly SubcommandDef[],\n): (prefix: string) => AutocompleteItem[] | null {\n\treturn (prefix: string): AutocompleteItem[] | null => {\n\t\tconst lowerPrefix = prefix.toLowerCase().trim();\n\n\t\t// If there's a space, we're past the subcommand - no completions\n\t\tif (lowerPrefix.includes(\" \")) {\n\t\t\treturn null;\n\t\t}\n\n\t\t// Filter subcommands matching the prefix\n\t\tconst matches = subcommands.filter(\n\t\t\t(sub) =>\n\t\t\t\tsub.name.toLowerCase().startsWith(lowerPrefix) ||\n\t\t\t\tsub.aliases?.some((a) => a.toLowerCase().startsWith(lowerPrefix)),\n\t\t);\n\n\t\tif (matches.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn matches.map((sub) => ({\n\t\t\tvalue: sub.name,\n\t\t\tlabel: sub.aliases?.length\n\t\t\t\t? `${sub.name} (${sub.aliases.join(\", \")})`\n\t\t\t\t: sub.name,\n\t\t\tdescription: sub.description,\n\t\t}));\n\t};\n}\n\n// ═══════════════════════════════════════════════════════════════════════════\n// Predefined subcommand completions for command suites\n// ═══════════════════════════════════════════════════════════════════════════\n\nexport const SESSION_SUBCOMMANDS: SubcommandDef[] = [\n\t{\n\t\tname: \"info\",\n\t\tdescription: \"Show current session info\",\n\t\taliases: [\"status\"],\n\t},\n\t{ name: \"new\", description: \"Start a fresh chat session\" },\n\t{ name: \"clear\", description: \"Clear context and start fresh\" },\n\t{\n\t\tname: \"list\",\n\t\tdescription: \"List recent sessions\",\n\t\taliases: [\"ls\", \"history\"],\n\t},\n\t{ name: \"load\", description: \"Load a session by ID\" },\n\t{ name: \"branch\", description: \"Branch from user message n\" },\n\t{ name: \"queue\", description: \"Show/manage message queue\" },\n\t{ name: \"export\", description: \"Export session to file\" },\n\t{ name: \"share\", description: \"Generate shareable HTML\" },\n\t{ name: \"favorite\", description: \"Mark as favorite\", aliases: [\"fav\"] },\n\t{\n\t\tname: \"unfavorite\",\n\t\tdescription: \"Remove favorite mark\",\n\t\taliases: [\"unfav\"],\n\t},\n\t{\n\t\tname: \"summary\",\n\t\tdescription: \"Add manual summary\",\n\t\taliases: [\"summarize\"],\n\t},\n];\n\nexport const DIAG_SUBCOMMANDS: SubcommandDef[] = [\n\t{ name: \"status\", description: \"Health snapshot\", aliases: [\"health\"] },\n\t{\n\t\tname: \"about\",\n\t\tdescription: \"Build and version info\",\n\t\taliases: [\"version\", \"info\"],\n\t},\n\t{\n\t\tname: \"context\",\n\t\tdescription: \"Token usage visualization\",\n\t\taliases: [\"tokens\"],\n\t},\n\t{\n\t\tname: \"stats\",\n\t\tdescription: \"Combined status and cost\",\n\t\taliases: [\"overview\"],\n\t},\n\t{\n\t\tname: \"background\",\n\t\tdescription: \"Background task config\",\n\t\taliases: [\"bg\"],\n\t},\n\t{ name: \"lsp\", description: \"LSP server status\" },\n\t{ name: \"mcp\", description: \"MCP server management\" },\n\t{ name: \"keys\", description: \"API key status\", aliases: [\"api\"] },\n\t{ name: \"telemetry\", description: \"Telemetry status\", aliases: [\"telem\"] },\n\t{ name: \"training\", description: \"Training preference\", aliases: [\"train\"] },\n\t{\n\t\tname: \"otel\",\n\t\tdescription: \"OpenTelemetry config\",\n\t\taliases: [\"opentelemetry\"],\n\t},\n\t{ name: \"config\", description: \"Configuration validation\", aliases: [\"cfg\"] },\n\t{ name: \"pii\", description: \"PII detection patterns\" },\n\t{ name: \"access\", description: \"Directory access rules\" },\n\t{ name: \"audit\", description: \"Audit log (enterprise)\" },\n\t{ name: \"bedrock\", description: \"AWS Bedrock status\", aliases: [\"aws\"] },\n];\n\nexport const ACCESS_SUBCOMMANDS: SubcommandDef[] = [\n\t{ name: \"safe\", description: \"Safe roots for file writes\" },\n\t{\n\t\tname: \"restricted\",\n\t\tdescription: \"System-protected paths\",\n\t\taliases: [\"blocked\"],\n\t},\n\t{ name: \"test\", description: \"Test a path against containment rules\" },\n];\n\nexport const UI_SUBCOMMANDS: SubcommandDef[] = [\n\t{\n\t\tname: \"status\",\n\t\tdescription: \"Show current UI settings\",\n\t\taliases: [\"info\"],\n\t},\n\t{\n\t\tname: \"theme\",\n\t\tdescription: \"Open theme selector\",\n\t\taliases: [\"color\", \"colors\"],\n\t},\n\t{ name: \"clean\", description: \"Text deduplication mode\", aliases: [\"dedup\"] },\n\t{ name: \"footer\", description: \"Footer style\" },\n\t{\n\t\tname: \"alerts\",\n\t\tdescription: \"Alert management\",\n\t\taliases: [\"notifications\"],\n\t},\n\t{ name: \"zen\", description: \"Toggle zen mode\" },\n\t{\n\t\tname: \"compact\",\n\t\tdescription: \"Toggle tool output folding\",\n\t\taliases: [\"fold\"],\n\t},\n];\n\nexport const SAFETY_SUBCOMMANDS: SubcommandDef[] = [\n\t{ name: \"status\", description: \"Show safety settings\", aliases: [\"info\"] },\n\t{\n\t\tname: \"approvals\",\n\t\tdescription: \"Set approval mode\",\n\t\taliases: [\"approval\", \"approve\"],\n\t},\n\t{\n\t\tname: \"plan\",\n\t\tdescription: \"Toggle plan mode\",\n\t\taliases: [\"plan-mode\", \"planmode\"],\n\t},\n\t{\n\t\tname: \"guardian\",\n\t\tdescription: \"Guardian scanning\",\n\t\taliases: [\"guard\", \"scan\"],\n\t},\n\t{\n\t\tname: \"events\",\n\t\tdescription: \"Show recent security events\",\n\t\taliases: [\"security\", \"logs\"],\n\t},\n\t{\n\t\tname: \"threats\",\n\t\tdescription: \"Show threat level and advisories\",\n\t\taliases: [\"threat\", \"advisory\"],\n\t},\n];\n\nexport const GIT_SUBCOMMANDS: SubcommandDef[] = [\n\t{ name: \"status\", description: \"Show git status\", aliases: [\"st\"] },\n\t{ name: \"diff\", description: \"Show diff for file\", aliases: [\"d\"] },\n\t{\n\t\tname: \"review\",\n\t\tdescription: \"Summarize status and diff\",\n\t\taliases: [\"summary\"],\n\t},\n];\n\nexport const AUTH_SUBCOMMANDS: SubcommandDef[] = [\n\t{\n\t\tname: \"status\",\n\t\tdescription: \"Show auth status\",\n\t\taliases: [\"info\", \"whoami\"],\n\t},\n\t{ name: \"login\", description: \"Authenticate\", aliases: [\"signin\"] },\n\t{ name: \"logout\", description: \"Remove credentials\", aliases: [\"signout\"] },\n\t{\n\t\tname: \"source-of-truth\",\n\t\tdescription: \"Set connector source-of-truth policy\",\n\t\taliases: [\"sot\", \"policy\"],\n\t},\n];\n\nexport const USAGE_SUBCOMMANDS: SubcommandDef[] = [\n\t{\n\t\tname: \"overview\",\n\t\tdescription: \"Show usage overview\",\n\t\taliases: [\"summary\"],\n\t},\n\t{\n\t\tname: \"cost\",\n\t\tdescription: \"Show cost summary\",\n\t\taliases: [\"costs\", \"spend\"],\n\t},\n\t{\n\t\tname: \"quota\",\n\t\tdescription: \"Show token quota\",\n\t\taliases: [\"tokens\", \"limit\", \"limits\"],\n\t},\n\t{ name: \"stats\", description: \"Combined status and cost\", aliases: [\"all\"] },\n];\n\nexport const UNDO_SUBCOMMANDS: SubcommandDef[] = [\n\t{\n\t\tname: \"undo\",\n\t\tdescription: \"Undo last action\",\n\t\taliases: [\"back\", \"revert\"],\n\t},\n\t{\n\t\tname: \"checkpoint\",\n\t\tdescription: \"Create/restore checkpoint\",\n\t\taliases: [\"save\", \"snap\", \"snapshot\"],\n\t},\n\t{\n\t\tname: \"changes\",\n\t\tdescription: \"List tracked file changes\",\n\t\taliases: [\"files\", \"tracked\"],\n\t},\n\t{\n\t\tname: \"history\",\n\t\tdescription: \"Show undo status\",\n\t\taliases: [\"list\", \"status\"],\n\t},\n];\n\nexport const CONFIG_SUBCOMMANDS: SubcommandDef[] = [\n\t{\n\t\tname: \"validate\",\n\t\tdescription: \"Validate configuration\",\n\t\taliases: [\"check\", \"status\"],\n\t},\n\t{ name: \"sources\", description: \"Show config sources\" },\n\t{ name: \"providers\", description: \"Show provider configuration\" },\n\t{ name: \"env\", description: \"Show environment variables\" },\n\t{\n\t\tname: \"import\",\n\t\tdescription: \"Import configuration presets\",\n\t\taliases: [\"preset\", \"presets\"],\n\t},\n\t{\n\t\tname: \"framework\",\n\t\tdescription: \"Set/show default framework\",\n\t\taliases: [\"fw\"],\n\t},\n\t{\n\t\tname: \"composer\",\n\t\tdescription: \"Manage custom composer configs\",\n\t\taliases: [\"persona\", \"agent\"],\n\t},\n\t{\n\t\tname: \"init\",\n\t\tdescription: \"Create AGENTS.md scaffolding\",\n\t\taliases: [\"scaffold\", \"setup\"],\n\t},\n];\n\nexport const TOOLS_SUBCOMMANDS: SubcommandDef[] = [\n\t{\n\t\tname: \"list\",\n\t\tdescription: \"List all tools\",\n\t\taliases: [\"all\", \"available\"],\n\t},\n\t{\n\t\tname: \"failures\",\n\t\tdescription: \"Show tool failures\",\n\t\taliases: [\"errors\", \"failed\"],\n\t},\n\t{ name: \"clear\", description: \"Clear tool logs\", aliases: [\"reset\"] },\n\t{\n\t\tname: \"mcp\",\n\t\tdescription: \"Show or manage MCP servers\",\n\t\taliases: [\"servers\"],\n\t},\n\t{ name: \"lsp\", description: \"LSP server management\", aliases: [\"language\"] },\n\t{\n\t\tname: \"workflow\",\n\t\tdescription: \"Run workflows\",\n\t\taliases: [\"workflows\", \"wf\"],\n\t},\n\t{ name: \"run\", description: \"Run npm scripts\", aliases: [\"script\", \"npm\"] },\n\t{\n\t\tname: \"commands\",\n\t\tdescription: \"User command management\",\n\t\taliases: [\"cmd\", \"user\"],\n\t},\n];\n"]}