@wrongstack/cli 0.6.1 → 0.6.4

package/dist/index.js

@@ -3,7 +3,7 @@ import * as path23 from 'path';
 import { join } from 'path';
 import * as fsp2 from 'fs/promises';
 import { readdir, readFile } from 'fs/promises';
-import { color, DefaultPathResolver, TOKENS, DefaultSystemPromptBuilder, makeAutonomyPromptContributor, ToolRegistry, createContextManagerTool, EventBus, SlashCommandRegistry, createDelegateTool, FLEET_ROSTER, createMcpControlTool, EternalAutonomyEngine, DefaultLogger, DefaultModelsRegistry, ProviderRegistry, InMemoryMetricsSink, wireMetricsToEvents, DefaultHealthRegistry, startMetricsServer, RecoveryLock, DefaultAttachmentStore, QueueStore, Context, loadTodosCheckpoint, attachTodosCheckpoint, loadDirectorState, loadPlan, createDefaultPipelines, AutoCompactionMiddleware, estimateRequestTokens, Agent, loadPlugins, FleetManager, makeDirectorSessionFactory, Director, makeAgentSubagentRunner, NULL_FLEET_BUS, resolveWstackPaths, DefaultSecretVault, migratePlaintextSecrets, DefaultConfigLoader, DefaultSessionReader, DefaultSessionRewinder, DefaultSessionStore, atomicWrite, DefaultPluginAPI, AutoApprovePermissionPolicy, formatContextWindowModeList, repairToolUseAdjacency, getContextWindowMode, resolveContextWindowPolicy, formatTodosList, emptyPlan, clearPlan, savePlan, formatPlanTemplates, getPlanTemplate, addPlanItem, formatPlan, deriveTodosFromPlanItem, removePlanItem, setPlanItemStatus, SpecStore, TaskGraphStore, SpecVersioning, getTemplate, listTemplates, templateToMarkdown, SpecParser, renderSpecAnalysis, AISpecBuilder, DefaultTaskStore, TaskTracker, loadGoal, goalFilePath, summarizeUsage, emptyGoal, saveGoal, buildGoalPreamble, formatGoal, InputBuilder, projectHash, defaultOrchestrator, decryptConfigSecrets, encryptConfigSecrets as encryptConfigSecrets$1, allServers as allServers$1 } from '@wrongstack/core';
+import { color, DefaultPathResolver, TOKENS, DefaultSystemPromptBuilder, makeAutonomyPromptContributor, ToolRegistry, createContextManagerTool, EventBus, SlashCommandRegistry, createDelegateTool, FLEET_ROSTER, createMcpControlTool, EternalAutonomyEngine, DefaultLogger, DefaultModelsRegistry, ProviderRegistry, InMemoryMetricsSink, wireMetricsToEvents, DefaultHealthRegistry, startMetricsServer, RecoveryLock, DefaultAttachmentStore, QueueStore, Context, loadTodosCheckpoint, attachTodosCheckpoint, loadDirectorState, loadPlan, createDefaultPipelines, AutoCompactionMiddleware, estimateRequestTokens, Agent, loadPlugins, FleetManager, makeDirectorSessionFactory, Director, makeAgentSubagentRunner, NULL_FLEET_BUS, resolveWstackPaths, DefaultSecretVault, migratePlaintextSecrets, DefaultConfigLoader, DefaultSessionReader, DefaultSessionRewinder, DefaultSessionStore, atomicWrite, DefaultPluginAPI, AutoApprovePermissionPolicy, formatContextWindowModeList, repairToolUseAdjacency, getContextWindowMode, resolveContextWindowPolicy, formatTodosList, emptyPlan, clearPlan, savePlan, formatPlanTemplates, getPlanTemplate, addPlanItem, formatPlan, deriveTodosFromPlanItem, removePlanItem, setPlanItemStatus, SpecStore, TaskGraphStore, SpecVersioning, getTemplate, listTemplates, templateToMarkdown, SpecParser, renderSpecAnalysis, AISpecBuilder, DefaultTaskStore, TaskTracker, loadGoal, goalFilePath, summarizeUsage, saveGoal, emptyGoal, buildGoalPreamble, formatGoal, InputBuilder, projectHash, defaultOrchestrator, decryptConfigSecrets, encryptConfigSecrets as encryptConfigSecrets$1, allServers as allServers$1 } from '@wrongstack/core';
 import { createRequire } from 'module';
 import * as os6 from 'os';
 import os6__default from 'os';
@@ -1704,7 +1704,9 @@ var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "metrics",
   "webui",
   "no-check",
-  "director"
+  "director",
+  "no-hints",
+  "hints"
 ]);
 function parseArgs(argv) {
   const flags = {};
@@ -2590,6 +2592,84 @@ async function resolveModelSelection(answer, models, provider, _registry, render
 `);
   return { provider: provider.id, model: modelId };
 }
+var GROUPS = [
+  {
+    title: "Autonomy",
+    items: [
+      { key: "/goal <text>", blurb: "lock in a verifiable mission \u2014 only Esc / Ctrl+C interrupt" },
+      { key: "/autonomy eternal", blurb: "sense \u2192 decide \u2192 execute \u2192 reflect loop until you stop it" },
+      { key: "--eternal", blurb: "boot directly into the eternal-autonomy engine" },
+      { key: "/autonomy on|suggest", blurb: "self-driving: auto-pick next step or just suggest it" }
+    ]
+  },
+  {
+    title: "Multi-agent / fleet",
+    items: [
+      { key: '--director "<task>"', blurb: "one-line LLM-driven fleet kickoff with 8 orchestration tools" },
+      { key: "/director", blurb: "promote the current session to director mode at runtime" },
+      { key: "/spawn -p <prov> -m <model> -n <name> <task>", blurb: "launch a single subagent (any provider/model)" },
+      { key: "/fleet status|usage|kill|log|manifest", blurb: "inspect and control the running subagent fleet" }
+    ]
+  },
+  {
+    title: "Steering",
+    items: [
+      { key: "Esc (while busy)", blurb: "soft interrupt \u2014 next message carries a STEERING preamble" },
+      { key: "/steer <text>", blurb: "mid-flight redirect, works when Esc is eaten by tmux" },
+      { key: "Ctrl+C \xD7 1 / \xD7 2 / \xD7 3", blurb: "cancel iteration \xB7 force-exit Ink \xB7 hard exit(130)" }
+    ]
+  },
+  {
+    title: "Modes & context",
+    items: [
+      { key: "/mode", blurb: "switch persona: code-reviewer, debugger, architect, tester, devops, \u2026" },
+      { key: "/model", blurb: "two-step provider \u2192 model picker, hot-swap at runtime" },
+      { key: "/yolo on|off|toggle", blurb: "auto-approve every tool call without restart" },
+      { key: "/context mode frugal|balanced|deep|archival", blurb: "pick how aggressively history is trimmed" },
+      { key: "/compact", blurb: "manually compact the in-flight context window" },
+      { key: "/plan show|add|start|done", blurb: "strategic roadmap, survives /resume across sessions" }
+    ]
+  },
+  {
+    title: "Daily ops",
+    items: [
+      { key: "@<query>  /  Alt+V  /  /image", blurb: "fuzzy file picker \xB7 paste clipboard image (TUI)" },
+      { key: "/mcp  \xB7  wstack mcp add <name>", blurb: "connect MCP servers (stdio / SSE / streamable-http)" },
+      { key: "/plugin install|enable|disable <name>", blurb: "manage plugins (telegram, lsp, \u2026)" },
+      { key: "/skill  \xB7  /init  \xB7  /commit", blurb: "list skills \xB7 scaffold AGENTS.md \xB7 LLM-drafted git commit" },
+      { key: "/diag  \xB7  /usage  \xB7  wstack resume <id>", blurb: "diagnostics \xB7 token & cost totals \xB7 continue any session" }
+    ]
+  }
+];
+var HINT_COUNT = GROUPS.reduce((n, g) => n + g.items.length, 0);
+function shouldSuppress(flags) {
+  if (flags["no-hints"] === true) return true;
+  if (flags["hints"] === false) return true;
+  const env = process.env.WRONGSTACK_NO_HINTS;
+  if (env && env !== "0" && env.toLowerCase() !== "false") return true;
+  return false;
+}
+function printLaunchHints(renderer, flags) {
+  if (shouldSuppress(flags)) return;
+  const lines = [];
+  lines.push("");
+  lines.push(
+    `  ${color.cyan("\u25C6")} ${color.bold(`WrongStack \u2014 ${HINT_COUNT} things you can do here`)}`
+  );
+  for (const group of GROUPS) {
+    lines.push(`  ${color.dim("\u2500")} ${color.cyan(group.title)}`);
+    for (const item of group.items) {
+      lines.push(`     ${color.bold(item.key)}  ${color.dim("\u2014")} ${color.dim(item.blurb)}`);
+    }
+  }
+  lines.push("");
+  lines.push(
+    `  ${color.dim(`tip: hide this with ${color.bold("--no-hints")} or ${color.bold("WRONGSTACK_NO_HINTS=1")}`)}`
+  );
+  lines.push("");
+  renderer.write(`${lines.join("\n")}
+`);
+}
 async function pathExists(file) {
   try {
     await fsp2.access(file);
@@ -3896,10 +3976,11 @@ function buildSpawnCommand(opts) {
 function buildAgentsCommand(opts) {
   return {
     name: "agents",
-    description: "Show status of spawned subagents.",
-    async run() {
+    description: "Show status of spawned subagents. With an id, show live monitor view.",
+    async run(args) {
       if (!opts.onAgents) return { message: "Multi-agent is not enabled in this session." };
-      return { message: opts.onAgents() };
+      const subagentId = args.trim() || void 0;
+      return { message: await opts.onAgents(subagentId) };
     }
   };
 }
@@ -4154,6 +4235,12 @@ function buildAutonomyCommand(opts) {
           opts.renderer.writeWarning(msg3);
           return { message: msg3 };
         }
+        const isStale = goal.iterations > 0 || goal.engineState === "running";
+        if (isStale) {
+          const msg3 = `${color.amber("Stale goal detected.")} Previous mission has ${goal.iterations} iterations (engineState: ${goal.engineState}). Clear it first: ${color.bold("/goal clear")}, then set a new one: ${color.bold("/goal set <mission>")}.`;
+          opts.renderer.writeWarning(msg3);
+          return { message: msg3 };
+        }
         if (!opts.onEternalStart) {
           const msg3 = "Eternal mode controller is not wired in this session.";
           opts.renderer.writeWarning(msg3);
@@ -4257,13 +4344,15 @@ ${color.dim(`Stored in ${goalPath} \u2014 Esc / /steer to redirect, Ctrl+C to st
             opts.renderer.write(msg2);
             return { message: msg2 };
           }
+          const abandoned = { ...existing, goalState: "abandoned" };
+          await saveGoal(goalPath, abandoned);
           const { unlink: unlink4 } = await import('fs/promises');
           try {
             await unlink4(goalPath);
           } catch {
           }
           if (opts.onEternalStop) opts.onEternalStop();
-          const msg = `${color.amber("Goal cleared.")} Eternal mode will stop on next cycle.`;
+          const msg = `${color.amber("Goal cleared.")} Previous goal marked abandoned; eternal mode will stop.`;
           opts.renderer.write(msg);
           return { message: msg };
         }
@@ -7393,22 +7482,22 @@ function fmtDuration(ms) {
   const remMin = m - h * 60;
   return `${h}h${remMin}m`;
 }
-function fmtTaskResultLine(r, color35) {
+function fmtTaskResultLine(r, color36) {
   const stats = `${r.iterations}it ${r.toolCalls}tc ${fmtDuration(r.durationMs)}`;
   const errMsg = typeof r.error === "string" ? r.error : r.error?.message;
   const errKind = typeof r.error === "object" ? r.error?.kind : void 0;
   const errTail = errMsg ? ` \u2014 ${errMsg.replace(/\s+/g, " ").slice(0, 80)}${errMsg.length > 80 ? "\u2026" : ""}` : "";
-  const errKindChip = errKind ? color35.dim(` [${errKind}]`) : "";
-  const errSnip = errMsg || errKind ? `${errKindChip}${color35.dim(errTail)}` : "";
+  const errKindChip = errKind ? color36.dim(` [${errKind}]`) : "";
+  const errSnip = errMsg || errKind ? `${errKindChip}${color36.dim(errTail)}` : "";
   switch (r.status) {
     case "success":
-      return { mark: color35.green("\u2713"), stats, tail: "" };
+      return { mark: color36.green("\u2713"), stats, tail: "" };
     case "timeout":
-      return { mark: color35.yellow("\u23F1"), stats: `${color35.yellow("timeout")} ${stats}`, tail: errSnip };
+      return { mark: color36.yellow("\u23F1"), stats: `${color36.yellow("timeout")} ${stats}`, tail: errSnip };
     case "stopped":
-      return { mark: color35.dim("\u2298"), stats: `${color35.dim("stopped")} ${stats}`, tail: errSnip };
+      return { mark: color36.dim("\u2298"), stats: `${color36.dim("stopped")} ${stats}`, tail: errSnip };
     case "failed":
-      return { mark: color35.red("\u2717"), stats: `${color35.red("failed")} ${stats}`, tail: errSnip };
+      return { mark: color36.red("\u2717"), stats: `${color36.red("failed")} ${stats}`, tail: errSnip };
   }
 }
 
@@ -7549,6 +7638,7 @@ async function boot(argv) {
       flags["no-tui"] = true;
     }
     if (choices.yolo !== config.yolo) config = patchConfig(config, { yolo: choices.yolo });
+    printLaunchHints(renderer, flags);
   }
   return {
     config,
@@ -9789,8 +9879,41 @@ async function main(argv) {
       const tag = tags.length > 0 ? ` (${tags.join(" / ")})` : "";
       return `Spawned subagent ${subagentId}${tag} for task ${taskId}. Use /agents to track progress.`;
     },
-    onAgents: () => {
+    onAgents: (subagentId) => {
       const s = multiAgentHost.status();
+      if (subagentId) {
+        const live = s.live.find((a) => a.subagentId === subagentId);
+        const completed = s.completed.filter((r) => r.subagentId === subagentId);
+        const pending = s.pending.filter((p) => p.subagentId === subagentId);
+        if (!live && completed.length === 0 && pending.length === 0) {
+          return `No subagent found with id "${subagentId}".`;
+        }
+        const STATUS_ICON2 = {
+          running: "\u25CF",
+          idle: "\u25CB",
+          stopped: "\u2298"
+        };
+        const lines2 = [color.bold(`Agent ${subagentId.slice(0, 8)}`)];
+        if (live) {
+          lines2.push(`  ${STATUS_ICON2[live.status] ?? "?"}  status: ${live.status}`);
+          if (live.task) lines2.push(`  task: ${live.task}`);
+        }
+        for (const p of pending) {
+          lines2.push(`  \xB7  pending: ${p.taskId.slice(0, 8)} \u2192 ${p.description.slice(0, 60)}`);
+        }
+        for (const r of completed) {
+          const fmt = fmtTaskResultLine(r, color);
+          lines2.push(`  ${fmt.mark}  ${r.taskId.slice(0, 8)} ${fmt.stats}${fmt.tail}`);
+        }
+        if (director) {
+          const snap = director.snapshot();
+          const per = snap.perSubagent?.[subagentId];
+          if (per?.cost) lines2.push(`  cost: ${per.cost.toFixed(4)}`);
+          if (per?.iterations) lines2.push(`  iterations: ${per.iterations}`);
+          if (per?.toolCalls) lines2.push(`  toolCalls: ${per.toolCalls}`);
+        }
+        return lines2.join("\n");
+      }
       const lines = [s.summary];
       const STATUS_ICON = {
         running: "\u25CF",