@capagents/forgeqe 1.0.9 → 1.1.1

package/src/mcp/tools.ts

@@ -98,6 +98,25 @@ export type ToolEvent =
   | { type: "card"; card: Card }
   /** write_report saved a report: its page and its Markdown. */
   | { type: "report"; title: string; html: string; markdown: string }
+  /** A finished call of a tool that has no card of its own, as one line: "Azure DevOps API · QI-Claims/_apis/build/builds (top 5)". */
+  | { type: "call"; text: string; ok: boolean }
+
+const API_LABEL: Record<string, string> = { azure_devops: "Azure DevOps", jira: "Jira", xray: "Xray", confluence: "Confluence" }
+
+/**
+ * A query_api call as a line: "Azure DevOps API · QI-Claims/_apis/release/releases (top 1, queryOrder descending)". The
+ * host and organization are left out, as are api-version and the start of a WIQL query.
+ */
+export function queryLine(args: Record<string, any>): string {
+  const name = `${API_LABEL[String(args.system)] || String(args.system || "API")} API`
+  if (args.wiql) return `${name} · WIQL (${clip(String(args.wiql).replace(/\s+/g, " ").replace(/^SELECT .*? FROM WorkItems WHERE /i, ""), 90)})`
+  if (args.query) return `${name} · GraphQL (${clip(String(args.query).replace(/\s+/g, " "), 90)})`
+  const raw = String(args.path || "")
+  const url = /^https?:\/\//.test(raw) ? raw.replace(/^https?:\/\/[^/]+\/(?:[^/]+\/(?=[^/]+\/_apis\/))?/, "") : raw.replace(/^\//, "")
+  const [where, search = ""] = url.split("?")
+  const params = [...new URLSearchParams(search)].filter(([k]) => k !== "api-version").map(([k, v]) => `${k.replace(/^\$/, "")} ${v}`)
+  return `${name} · ${decodeURIComponent(where || "")}${params.length ? ` (${clip(params.join(", "), 90)})` : ""}`
+}
 
 export type ToolContext = {
   config: AppConfig
@@ -135,6 +154,8 @@ export type McpTool = {
   description: string
   inputSchema: Record<string, unknown>
   run(args: Record<string, any>, ctx: ToolContext): Promise<unknown>
+  /** The call as one line in the conversation, for a tool that shows nothing else: the ForgeQE tools are hidden there. */
+  line?(args: Record<string, any>): string
 }
 
 const clip = (s: string | undefined, n: number) => {
@@ -563,6 +584,7 @@ export const TOOLS: McpTool[] = [
         limit: { type: "integer", minimum: 1, maximum: 25, description: "Most pages to return (default 10)" },
       },
     },
+    line: (args) => `Confluence · ${args.cql ? `search (${clip(String(args.cql), 90)})` : `pages (${clip((Array.isArray(args.pages) ? args.pages : []).map(String).join(", "), 90)})`}`,
     async run(args, ctx) {
       const pages = Array.isArray(args.pages) ? args.pages.map(String) : undefined
       return readConfluence(ctx.config.sources, { pages, cql: args.cql ? String(args.cql) : undefined, limit: Number(args.limit) || undefined })
@@ -571,7 +593,7 @@ export const TOOLS: McpTool[] = [
   {
     name: "query_api",
     description:
-      "Read anything from Azure DevOps, Jira, Xray, or Confluence through their APIs with the credentials in ForgeQE's settings: work items, bugs, stories, queries, pipeline runs, issues, JQL searches, Xray tests and executions, Confluence pages and spaces. Use it for what the other tools and connected MCP servers don't cover, or when a system has no MCP server. Read-only: GET requests, WIQL searches for Azure DevOps work items, and GraphQL queries for Xray Cloud.",
+      "Read anything from Azure DevOps, Jira, Xray, or Confluence through their APIs with the credentials in ForgeQE's settings: work items, bugs, stories, queries, pipeline runs, classic releases and deployments, issues, JQL searches, Xray tests and executions, Confluence pages and spaces. Use it for what the other tools and connected MCP servers don't cover, or when a system has no MCP server: before the browser, and never curl or scripts in the shell, which have no credentials. Read-only: GET requests, WIQL searches for Azure DevOps work items, and GraphQL queries for Xray Cloud.",
     inputSchema: {
       type: "object",
       properties: {
@@ -579,7 +601,7 @@ export const TOOLS: McpTool[] = [
         path: {
           type: "string",
           description:
-            "azure_devops: REST path under the organization URL, e.g. Shop/_apis/wit/workitems/12?$expand=all (api-version=7.1 is added when missing). jira: REST path under the site URL, e.g. /rest/api/3/search/jql?jql=project%3DSHOP&fields=summary,status (Server/Data Center: /rest/api/2/..., Xray Server: /rest/raven/1.0/...). confluence: REST path under the Confluence URL, e.g. /rest/api/space or /api/v2/pages/123/children (Cloud).",
+            "azure_devops: REST path under the organization URL, e.g. Shop/_apis/wit/workitems/12?$expand=all or Shop/_apis/build/builds?$top=5 (api-version=7.1 is added when missing). Classic releases are on the release host: pass the full URL, e.g. https://vsrm.dev.azure.com/<org>/Shop/_apis/release/releases?$top=10, .../_apis/release/definitions, or .../_apis/release/deployments. jira: REST path under the site URL, e.g. /rest/api/3/search/jql?jql=project%3DSHOP&fields=summary,status (Server/Data Center: /rest/api/2/..., Xray Server: /rest/raven/1.0/...). confluence: REST path under the Confluence URL, e.g. /rest/api/space or /api/v2/pages/123/children (Cloud).",
         },
         query: { type: "string", description: "xray (Cloud): a GraphQL query, e.g. { getTests(jql: \"project = SHOP\", limit: 10) { results { jira(fields: [\"key\"]) } } }" },
         wiql: {
@@ -592,6 +614,7 @@ export const TOOLS: McpTool[] = [
       },
       required: ["system"],
     },
+    line: queryLine,
     async run(args, ctx) {
       return queryApi(ctx.config.sources, { system: args.system, path: args.path, query: args.query, variables: args.variables, wiql: args.wiql, project: args.project })
     },

package/src/refine.ts

@@ -10,6 +10,7 @@ import { CAPABILITIES } from "./capabilities/registry.ts"
 import { allStatuses } from "./capabilities/status.ts"
 import { domainNotes } from "./domain.ts"
 import type { CodeEvent } from "./types.ts"
+import { steScore } from "./ste.ts"
 
 /**
  * The shell's Refine (ctrl+r): what the user typed becomes a precise request for ForgeQE's agent, checked against what
@@ -20,13 +21,18 @@ import type { CodeEvent } from "./types.ts"
 /** The only tools the refiner may call: each reads, none changes anything or starts a run. */
 export const REFINE_TOOLS = ["capabilities", "query_api", "find_test_cases", "list_sprints", "run_details"]
 
-/** The refined request as a task specification: what ForgeQE's agent is asked to do, in the parts its own prompt uses. */
-export type RefinedSpec = { goal: string; context: string[]; steps: string[]; rules: string[]; result: string }
+/**
+ * The refined request as a task specification, laid out as a system prompt: the role the agent takes, the objective,
+ * the context, the steps, the rules, the output format, and the objective again in one sentence at the end.
+ */
+export type RefinedSpec = { role: string; objective: string; context: string[]; steps: string[]; rules: string[]; output: string; summary: string }
 
 export type Refined = {
-  /** The request that is sent: the spec written out (Goal, Context, Steps, Rules, Result). */
+  /** The request that is sent: the spec written out (Role, Objective, Context, Steps, Rules, Output format, Summary). */
   refined: string
   spec?: RefinedSpec
+  /** The share of the request's sentences that keep the ASD-STE100 rules, 0 to 1. */
+  ste?: number
   grounded: { fact: string; checked: boolean }[]
   assumed: string[]
   missing: string[]
@@ -37,11 +43,13 @@ const lines = { type: "array", items: { type: "string" } } as const
 export const REFINE_SCHEMA = {
   type: "object",
   properties: {
-    goal: { type: "string", description: "One instruction that starts with a verb: what the agent must do" },
+    role: { type: "string", description: "The role the agent takes for this task, as one description, e.g. A release analyst who reads Azure DevOps deployments" },
+    objective: { type: "string", description: "One instruction that starts with a verb: what the agent must do" },
     context: { ...lines, description: "Facts the agent needs, one per line: system, project, work items, files, runs, with exact names and ids" },
     steps: { ...lines, description: "The actions in sequence, one per step; empty for a request with one action" },
     rules: { ...lines, description: "Limits the user gave or the setup sets, one per line" },
-    result: { type: "string", description: "What the agent must give back" },
+    output: { type: "string", description: "The output format: what the agent gives back and how it is laid out (sections, a table, a file)" },
+    summary: { type: "string", description: "The objective again, in one short sentence, as the last line" },
     grounded: {
       type: "array",
       items: { type: "object", properties: { fact: { type: "string" }, checked: { type: "boolean" } }, required: ["fact", "checked"] },
@@ -49,7 +57,7 @@ export const REFINE_SCHEMA = {
     assumed: { type: "array", items: { type: "string" } },
     missing: { type: "array", items: { type: "string" } },
   },
-  required: ["goal", "context", "steps", "rules", "result", "grounded", "assumed", "missing"],
+  required: ["role", "objective", "context", "steps", "rules", "output", "summary", "grounded", "assumed", "missing"],
 } as const
 
 const REFINE_AGENT = {
@@ -64,11 +72,14 @@ const REFINE_AGENT = {
 
 /** The spec as the request ForgeQE's agent gets: labelled parts, empty ones left out. */
 export function composeRefined(spec: RefinedSpec): string {
-  const parts = [`Goal: ${spec.goal}`]
+  const parts: string[] = []
+  if (spec.role) parts.push(`Role: ${spec.role}`)
+  parts.push(`Objective: ${spec.objective}`)
   if (spec.context.length) parts.push(["Context:", ...spec.context.map((c) => `- ${c}`)].join("\n"))
   if (spec.steps.length) parts.push(["Steps:", ...spec.steps.map((st, i) => `${i + 1}. ${st}`)].join("\n"))
   if (spec.rules.length) parts.push(["Rules:", ...spec.rules.map((r) => `- ${r}`)].join("\n"))
-  if (spec.result) parts.push(`Result: ${spec.result}`)
+  if (spec.output) parts.push(`Output format: ${spec.output}`)
+  if (spec.summary) parts.push(`Summary: ${spec.summary}`)
   return parts.join("\n\n")
 }
 
@@ -97,13 +108,18 @@ export function refineRequest(text: string, recent: { user: string; reply: strin
 }
 
 /** Keeps only what the schema allows, so the shell never shows a malformed answer. */
-export function cleanRefined(r: (Partial<Refined> & Partial<RefinedSpec>) | null | undefined, original: string): Refined {
+export function cleanRefined(r: (Partial<Refined> & Partial<RefinedSpec> & { goal?: string; result?: string }) | null | undefined, original: string): Refined {
   const strings = (v: unknown) => (Array.isArray(v) ? v.map(String).map((s) => s.trim()).filter(Boolean) : [])
-  const goal = String(r?.goal || "").trim()
-  const spec: RefinedSpec | undefined = goal ? { goal, context: strings(r?.context), steps: strings(r?.steps), rules: strings(r?.rules), result: String(r?.result || "").trim() } : undefined
+  const text = (v: unknown) => String(v || "").trim()
+  // goal and result: the names an older refine prompt (a project's own copy) gives the objective and the output.
+  const objective = text(r?.objective) || text(r?.goal)
+  const spec: RefinedSpec | undefined = objective
+    ? { role: text(r?.role), objective, context: strings(r?.context), steps: strings(r?.steps), rules: strings(r?.rules), output: text(r?.output) || text(r?.result), summary: text(r?.summary) }
+    : undefined
+  const refined = spec ? composeRefined(spec) : text(r?.refined) || original
   return {
-    refined: spec ? composeRefined(spec) : String(r?.refined || "").trim() || original,
-    ...(spec ? { spec } : {}),
+    refined,
+    ...(spec ? { spec, ste: steScore(refined).score } : {}),
     grounded: Array.isArray(r?.grounded) ? r!.grounded.filter((g) => g && String(g.fact || "").trim()).map((g) => ({ fact: String(g.fact).trim(), checked: g.checked === true })) : [],
     assumed: strings(r?.assumed),
     missing: strings(r?.missing),
@@ -150,7 +166,7 @@ export async function refine(opts: {
     })
     try {
       let out = await session.prompt(refineRequest(opts.text, opts.recent))
-      if (!out.report && !out.error && !opts.signal?.aborted) out = await session.prompt("Give the structured result: goal, context, steps, rules, result, grounded, assumed, and missing.")
+      if (!out.report && !out.error && !opts.signal?.aborted) out = await session.prompt("Give the structured result: role, objective, context, steps, rules, output, summary, grounded, assumed, and missing.")
       if (!out.report) throw new Error(out.error ? `Refine failed: ${out.error}` : "Refine gave no result.")
       return cleanRefined(out.report, opts.text)
     } finally {

package/src/tui/App.tsx

@@ -26,8 +26,9 @@ import { meterSnapshot, requestLine } from "../usage.ts"
 import { cleanSelection, copyText } from "./clipboard.ts"
 import { ButtonBar, ChoicePanel, Footer, Hints, Logo, Prompt, Spinner, type Button, type Hint } from "./components.tsx"
 import { setupChecklist, type SetupItem } from "./setup.ts"
+import { initWorkspace } from "../init.ts"
 import { ShortcutsPanel } from "./shortcuts.tsx"
-import { ago, projectLine, setupSentence, recentWork, startActions, type RecentItem, type StartAction } from "./landing.ts"
+import { ago, getStarted, projectLine, setupSentence, type Fact, type GetStarted, recentWork, startActions, type RecentItem, type StartAction } from "./landing.ts"
 import { TIPS, formatDuration, formatTokens, packageVersion, shortCwd, theme } from "./theme.ts"
 import { emptyProduced, Line, Produced, producedCard, TestsSetting, TranscriptLine } from "./transcript.tsx"
 import { Dialog, dialogSpec } from "./dialogs.ts"
@@ -35,7 +36,7 @@ import { activityFromLog, clip, hostOf, modelLabel } from "./text.ts"
 import { featuresText } from "../capabilities/render.ts"
 import { Palette, paletteItems, searchPalette, SuggestList, type PaletteItem } from "./palette.tsx"
 import { commandSuggestions, complete, lookupWorkItem, recentRuns, referenceSuggestions, repoFiles, triggerAt, type Suggestion, type WorkItem } from "./suggest.ts"
-import { REFINE_CHOICES, RefinePanel, type RefineChoice, type RefineState } from "./refine-panel.tsx"
+import { initialChoice, REFINE_CHOICES, RefinePanel, type RefineChoice, type RefineState } from "./refine-panel.tsx"
 import { refine } from "../refine.ts"
 import { nextSteps, type NextStep } from "./next.ts"
 import { CAPABILITIES } from "../capabilities/registry.ts"
@@ -178,8 +179,8 @@ export function App({ options }: { options: TuiOptions }) {
   /** Under 120 columns there is room for one pane: ctrl+o switches between the chat and the details. */
   const [narrowView, setNarrowView] = useState<"chat" | "details">("chat")
   // The split view's chat at the full width, for reading a long answer; the panels come back with Split view.
-  const [chatWide, setChatWide] = useState(false)
-  const setupRef = useRef<{ key: string; items: SetupItem[]; start: StartAction[]; recent: RecentItem[] }>({ key: "", items: [], start: [], recent: [] })
+  const [chatWide, setChatWide] = useState(true)
+  const setupRef = useRef<{ key: string; items: SetupItem[]; start: StartAction[]; recent: RecentItem[]; first: GetStarted[]; facts: Fact[] }>({ key: "", items: [], start: [], recent: [], first: [], facts: [] })
   // Which panel the keys go to (shift+tab moves on), the row selected in the plan and files, and the activity filter.
   const [nav, setNavState] = useState<{ focus: Focus; plan: number; files: number; filter: ActivityFilter }>({ focus: "chat", plan: 0, files: 0, filter: "all" })
   const navRef = useRef(nav)
@@ -518,6 +519,7 @@ export function App({ options }: { options: TuiOptions }) {
   }
 
   /** Refines what is in the prompt; the user then decides what is sent. */
+  const refineCount = useRef(0)
   const startRefine = () => {
     const text = promptTextRef.current.trim()
     const cfg = configRef.current
@@ -533,10 +535,19 @@ export function App({ options }: { options: TuiOptions }) {
     const controller = new AbortController()
     refineAbort.current = controller
     setRefine({ phase: "working", original: text })
-    void (options.refine || refine)({ config: cfg, cwd: sessionSetup(cfg, options.repo).cwd, text, recent: convoRef.current, signal: controller.signal })
+    // Refine is a model session of its own: its tokens count in the session total, under a key per refine.
+    const key = `refine-${++refineCount.current}`
+    const started = Date.now()
+    let used = 0
+    const onEvent = (e: CodeEvent) => {
+      if (e.kind !== "usage") return
+      used = e.usage.input + e.usage.output
+      useTokens(key, used)
+    }
+    void (options.refine || refine)({ config: cfg, cwd: sessionSetup(cfg, options.repo).cwd, text, recent: convoRef.current, signal: controller.signal, onEvent })
       .then((result) => {
         if (controller.signal.aborted || refiningRef.current?.phase !== "working") return
-        setRefine({ phase: "done", original: text, result, choice: 0 })
+        setRefine({ phase: "done", original: text, result, choice: initialChoice(result.missing), ...(used ? { tokens: used } : {}), ms: Date.now() - started })
       })
       .catch((err) => {
         if (controller.signal.aborted) return
@@ -668,7 +679,8 @@ export function App({ options }: { options: TuiOptions }) {
     // The panels: shift+tab moves focus through those on screen; a focused panel takes the arrows, enter, and esc.
     const panes = (width >= SPLIT_MIN && !chatWide) || (width < SPLIT_MIN && narrowView === "details")
     const insp = inspRef.current
-    const shown = (f: Focus) => f === "activity" || f === "files" || (f === "plan" && planLines(insp).length > 0) || (f === "chat" && width >= SPLIT_MIN)
+    const panelsOpen = width >= SPLIT_MIN && !chatWide
+    const shown = (f: Focus) => f === "activity" || f === "files" || (f === "plan" && planLines(insp).length > 0) || (f === "chat" && panelsOpen)
     if (panes && key.name === "tab" && key.shift && !entryRef.current) {
       // Consumed here: the prompt can take focus within this key press and must not also act on it.
       key.preventDefault()
@@ -682,7 +694,7 @@ export function App({ options }: { options: TuiOptions }) {
       const list = at === "plan" ? planLines(insp).length : at === "files" ? filesByUse(insp).length : 0
       const move = (d: number) => setNav((n) => ({ ...n, [at]: Math.max(0, Math.min(list - 1, (n[at as "plan" | "files"] ?? 0) + d)) }))
       const page = Math.max(3, Math.floor(height / 3))
-      if (key.name === "escape") return setNav((n) => ({ ...n, focus: width >= SPLIT_MIN ? "chat" : "activity" }))
+      if (key.name === "escape") return setNav((n) => ({ ...n, focus: panelsOpen ? "chat" : "activity" }))
       if (at === "activity") {
         const box = activityScroll.current
         if (key.name === "up") return box?.scrollBy(-1)
@@ -710,7 +722,7 @@ export function App({ options }: { options: TuiOptions }) {
         }
       }
       // Anything typed goes back to the chat, where the prompt is.
-      if (!key.ctrl && !key.meta && key.sequence && key.sequence.length === 1 && key.sequence > " " && width >= SPLIT_MIN) return setNav((n) => ({ ...n, focus: "chat" }))
+      if (!key.ctrl && !key.meta && key.sequence && key.sequence.length === 1 && key.sequence > " " && panelsOpen) return setNav((n) => ({ ...n, focus: "chat" }))
       if (!key.ctrl && !key.meta) return
     }
     // ? on an empty prompt: every key in one panel; esc or ? closes it.
@@ -726,8 +738,11 @@ export function App({ options }: { options: TuiOptions }) {
     }
     // The start screen's actions: alt+1 to alt+4 put one in the prompt.
     if (key.meta && /^[1-4]$/.test(key.name || "") && linesRef.current === 0 && !abortRef.current) {
-      const a = setupRef.current.start[Number(key.name) - 1]
+      const n = Number(key.name) - 1
+      const a = setupRef.current.start[n]
+      const g = setupRef.current.first[n]
       if (a) fillPrompt(a.request)
+      else if (!setupRef.current.start.length && g) g.command ? submitRef.current(g.command) : g.fix && push("sys", g.fix, "chat")
       return
     }
     if (suggRef.current.list.length && suggRef.current.trigger && !entryRef.current) {
@@ -748,7 +763,11 @@ export function App({ options }: { options: TuiOptions }) {
       return
     }
     if (key.name === "r" && key.ctrl && !entryRef.current) startRefine()
-    if (key.name === "o" && key.ctrl && width < SPLIT_MIN) setNarrowView((v) => (v === "chat" ? "details" : "chat"))
+    // ctrl+o: the panels (plan, activity, files, context, tokens) beside the chat on a wide terminal, in its place on a narrow one.
+    if (key.name === "o" && key.ctrl) {
+      if (width >= SPLIT_MIN) setChatWide((w) => !w)
+      else setNarrowView((v) => (v === "chat" ? "details" : "chat"))
+    }
     if (key.name === "escape" && abortRef.current) openDialog("stop")
   })
 
@@ -905,6 +924,10 @@ export function App({ options }: { options: TuiOptions }) {
       case "info":
         push(e.ok === undefined ? "code" : e.ok ? "ok" : "err", e.text)
         return
+      case "call":
+        pushTool(e.text, e.ok)
+        if (!aborted()) setActivity(`Agent: ${clip(e.text, 60)}`)
+        return
       case "agent": {
         const ev = e.event
         inspect(ev)
@@ -1104,7 +1127,9 @@ export function App({ options }: { options: TuiOptions }) {
       pushProduced()
       // What this request used and cost in total: ForgeQE's agent, browser runs, Scribe, and the reviewer.
       // The split view's session and tokens panels show this; only the one-pane view needs it in the chat.
-      const spent = widthRef.current < SPLIT_MIN ? requestLine(meterStart) : ""
+      // The footer and the tokens panel show what a request used; the conversation stays about the work.
+      const spent = ""
+      void meterStart
       if (spent) push("sys", spent, "chat")
       finish(finalStatus, followUps)
     }
@@ -1129,6 +1154,19 @@ export function App({ options }: { options: TuiOptions }) {
     else void askAgent(text, cfg)
   }
 
+  /** Reads forgeqe.yaml and llms.json again (after /init wrote them), keeping the session going. */
+  const reloadConfig = () => {
+    let cfg = loadConfig({ configPath: options.configPath, profile: options.profile })
+    if (options.profile) cfg = selectProfile(cfg, options.profile)
+    configRef.current = cfg
+    setProfile(cfg.activeProfile)
+    setModel(modelLabel(cfg))
+    setupRef.current.key = ""
+    contextInfo.current.key = ""
+    closeBrain()
+    bump()
+  }
+
   useEffect(() => {
     if (booted.current) return
     booted.current = true
@@ -1198,7 +1236,8 @@ export function App({ options }: { options: TuiOptions }) {
     if (!text) return
     // Setup notes come before the request, so they do not read as its answer; the split view shows them in its session panel.
     const notes = priceNotesRef.current.splice(0)
-    if (width < SPLIT_MIN) for (const w of notes) push("sys", `Price check: ${w}`, "chat")
+    // Price notes stay out of the conversation: forgeqe models and the reports say what a run cost.
+    void notes
     push("user", text)
     const cmd = parseCommand(text)
     if (cmd.type === "help") {
@@ -1240,6 +1279,17 @@ export function App({ options }: { options: TuiOptions }) {
       }
       return
     }
+    if (cmd.type === "init") {
+      // forgeqe init in this folder, then the session reads what it wrote: the start screen updates at once.
+      try {
+        const r = initWorkspace(process.cwd(), {})
+        push("sys", [r.created.length ? `Created in ${shortCwd()}:` : "Nothing to create: this folder is set up.", ...r.created.map((f) => `  ✚ ${path.relative(process.cwd(), f) || f}`), ...r.notes].join("\n"), "chat")
+        reloadConfig()
+      } catch (err) {
+        push("err", (err as Error).message, "chat")
+      }
+      return
+    }
     if (cmd.type === "features") {
       if (configRef.current) push("sys", featuresText(configRef.current))
       else push("err", "Config is not loaded.")
@@ -1309,7 +1359,11 @@ export function App({ options }: { options: TuiOptions }) {
           ? "headed"
           : ""
   const rightColor = running ? theme.warn : status === "done" ? theme.ok : status === "fail" ? theme.err : theme.muted
-  const footerRight = VERSION ? `ForgeQE ${VERSION}` : "ForgeQE"
+  const footerVersion = VERSION ? `ForgeQE ${VERSION}` : "ForgeQE"
+  // In the conversation, the footer is the status line: the model, what the session used, and the version.
+  const sessionTokens = meterSince(sessionMeter.current).total
+  const usedTokens = sessionTokens.input + sessionTokens.output
+  const footerRight = lines.length ? [configRef.current ? modelLabel(configRef.current) : model, usedTokens ? `${formatTokens(usedTokens)} tokens` : "", footerVersion].filter(Boolean).join("  ·  ") : footerVersion
   // Suggestions for what is being typed: "/" commands, "@" references (runs, files, an Azure DevOps item by id).
   const suggTrigger = triggerAt(promptText)
   const suggKey = suggTrigger ? `${suggTrigger.kind}${suggTrigger.token}` : ""
@@ -1336,8 +1390,10 @@ export function App({ options }: { options: TuiOptions }) {
 
   const closeHint: Hint = { key: "ctrl+c", label: "close", onPress: () => openDialog("quit") }
   const copiedHint: Hint[] = copied ? [{ key: `✓ ${copied}`, label: "" }] : []
-  // The split view's right pane shows tokens, time, and the last result, so the row under the prompt leaves them out.
+  // One column by default, as in Claude Code; ctrl+o (or Panels) opens the plan, activity, files, context, and
+  // tokens beside it on a wide terminal, or in its place on a narrow one.
   const wide = width >= SPLIT_MIN
+  const panelsOpen = wide && !chatWide
   const openPalette = () => {
     paletteRef.current = { query: "", selected: 0 }
     setPalette(paletteRef.current)
@@ -1347,25 +1403,26 @@ export function App({ options }: { options: TuiOptions }) {
   // `drop`: the order they give way on a narrow row; Refine, Search, and Stop always stay.
   const refineButton: Button = { icon: "✦", label: "Refine", keys: "ctrl+r", color: theme.memory, onPress: () => refineRef.current(), active: Boolean(promptText.trim()) }
   const searchButton: Button = { icon: "⌕", label: "Search", keys: "ctrl+p", color: theme.accent, onPress: openPalette }
-  // The view: in the split view, Panels and Wide chat sit in the right pane's status line, where there is room;
-  // Split view comes back here when the chat is wide, and Details on a narrow terminal.
+  // The view: with the panels open, moving into them and closing them sit in their status line; otherwise Panels
+  // (Details on a narrow terminal) opens them.
   const toggleWide = () => setChatWide((w) => !w)
   const paneButtons: Button[] = [
-    { icon: "▦", label: "Panels", keys: "shift+tab", color: theme.thought, onPress: focusPanels, drop: 2 },
-    { icon: "⤢", label: "Wide chat", color: theme.muted, onPress: toggleWide, drop: 1 },
+    { icon: "▦", label: "Focus panels", keys: "shift+tab", color: theme.thought, onPress: focusPanels, drop: 2 },
+    { icon: "✕", label: "Close", keys: "ctrl+o", color: theme.muted, onPress: toggleWide, drop: 1 },
   ]
   const viewButtons: Button[] = wide
     ? chatWide
-      ? [{ icon: "◧", label: "Split view", color: theme.thought, onPress: toggleWide, drop: 2 }]
+      ? [{ icon: "▦", label: "Panels", keys: "ctrl+o", color: theme.thought, onPress: toggleWide, drop: 2 }]
       : []
     : [{ icon: "◧", label: "Details", keys: "ctrl+o", color: theme.thought, onPress: () => setNarrowView("details"), drop: 1 }]
   const idleButtons: Button[] = [refineButton, searchButton, ...viewButtons, ...(wide ? [] : [{ icon: "⇄", label: "Profile", keys: "tab", color: theme.muted, onPress: cycleProfile, drop: 4 }])]
   const runningButtons: Button[] = [{ icon: "■", label: "Stop", keys: "esc", color: theme.warn, onPress: () => openDialog("stop") }, searchButton, ...viewButtons]
   const shortcutsHint: Hint = { key: "?", label: "shortcuts", onPress: () => setShortcuts(true) }
   // ? is offered where there is room for it: the start screen of a terminal 110 columns or wider; it works everywhere.
-  const idleHints: Hint[] = [...copiedHint, ...(lastStats && !wide && !copied ? [{ key: `last run ${lastStats}`, label: "" }] : []), ...(home && width >= 110 ? [shortcutsHint] : []), closeHint]
+  const idleHints: Hint[] = [...copiedHint, ...(home && width >= 110 ? [shortcutsHint] : []), closeHint]
   // The one-pane view has no tokens panel, so the tokens and time show here.
-  const runningHints: Hint[] = [...copiedHint, ...(wide || copied ? [] : [{ key: `${formatTokens(tokens)} tokens · ${elapsed}`, label: "" }]), closeHint]
+  // While a request runs, the line above the prompt says what is happening, for how long, and with how many tokens.
+  const runningHints: Hint[] = [...copiedHint, closeHint]
   const runningLeft = (
     <box style={{ flexDirection: "row", marginRight: 1 }}>
       <Spinner kind="bar" />
@@ -1454,8 +1511,8 @@ export function App({ options }: { options: TuiOptions }) {
           model={model}
           right={right}
           rightColor={rightColor}
-          compact={width >= SPLIT_MIN && !home}
-          focused={!palette && !refining && (nav.focus === "chat" || (width < SPLIT_MIN && narrowView === "chat"))}
+          compact={!home}
+          focused={!palette && !refining && (panelsOpen ? nav.focus === "chat" : wide || narrowView === "chat")}
           initialValue={draft}
           onText={(t) => {
             promptTextRef.current = t
@@ -1479,24 +1536,37 @@ export function App({ options }: { options: TuiOptions }) {
     const cfgHome = configRef.current
     const setupKey = cfgHome ? `${cfgHome.configPath}|${cfgHome.activeProfile}` : ""
     if (cfgHome && setupRef.current.key !== setupKey) {
+      const items = setupChecklist(cfgHome)
+      const recent = recentWork(path.resolve(cfgHome.export.outDir))
+      let signIns: Record<string, string> = {}
+      try {
+        // "Azure DevOps (PAT)": how each system's server signs in, as the session panel says it.
+        signIns = Object.fromEntries(externalMcp(cfgHome).servers.filter((x) => x.signIn).map((x) => [x.label.replace(/ MCP$/, ""), x.signIn!.startsWith("PAT") ? "PAT" : "az login"]))
+      } catch {}
       setupRef.current = {
         key: setupKey,
-        items: setupChecklist(cfgHome),
-        start: startActions(cfgHome),
-        recent: recentWork(path.resolve(cfgHome.export.outDir)),
+        items,
+        start: startActions(cfgHome, 4, undefined, recent.some((r) => r.kind === "run")),
+        recent,
+        first: getStarted(cfgHome, items),
+        facts: projectLine(cfgHome, process.cwd(), { model: modelLabel(cfgHome), signIns }),
       }
     }
-    const { items: setup, start, recent } = setupRef.current
+    const { items: setup, start, recent, first, facts } = setupRef.current
     const open = setup.filter((i) => !i.done)
     // Each missing item with how to set it up, in the chat; the first that a command sets up (/auth) is offered last.
     const explainSetup = (items: SetupItem[]) => push("sys", items.map((i) => `○ ${i.fix}${i.command ? ` Type ${i.command} to start.` : ""}`).join("\n"), "chat")
-    const facts = projectLine(cfgHome, process.cwd(), cfgHome ? modelLabel(cfgHome) : "")
 
     // Rows: the logo, the project line, and the prompt always; then Start with, Continue, and Setup while they fit.
     // A long request takes rows from them, last section first, so the box never scrolls while there is room.
     const loading = !cfgHome
     // Each section is a blank row and then its own rows: a heading and its items, or the setup line.
-    const startRows = loading ? 1 + 1 + 4 : start.length ? 1 + 1 + start.length : 0
+    // Get started takes Start with's place while there is nothing to start with: no model, or no forgeqe.yaml.
+    const offer: { id: string; label: string; detail: string; run: () => void }[] = start.length
+      ? start.map((a) => ({ id: a.id, label: a.label, detail: a.detail, run: () => fillPrompt(a.request) }))
+      : first.map((g) => ({ id: g.id, label: g.label, detail: g.detail, run: () => (g.command ? submitRef.current(g.command) : g.fix && push("sys", g.fix, "chat")) }))
+    const offerTitle = start.length ? "Start with" : "Get started"
+    const startRows = loading ? 1 + 1 + 4 : offer.length ? 1 + 1 + offer.length : 0
     const recentRows = recent.length ? 1 + 1 + recent.length : 0
     const setupRows = loading || open.length ? 2 : 0
     const fixed = 5 + 2 + 1 + 5 + 1 + 1 + 1 // logo, project line, gap, prompt chrome, buttons, footer, one row to spare
@@ -1521,8 +1591,8 @@ export function App({ options }: { options: TuiOptions }) {
           <text>
             {facts.length ? (
               facts.map((f, i) => (
-                <span key={i} fg={i === 0 ? theme.text : theme.muted}>
-                  {`${i ? "  ·  " : ""}${f}`}
+                <span key={i} fg={f.tone === "name" ? theme.text : f.tone === "warn" ? theme.warn : theme.muted}>
+                  {`${i ? "  ·  " : ""}${f.text}`}
                 </span>
               ))
             ) : (
@@ -1535,11 +1605,11 @@ export function App({ options }: { options: TuiOptions }) {
             {renderControls(promptWidth, "Describe what you want to test…", [5, maxRows])}
             {showStart ? (
               <box style={{ flexDirection: "column", marginTop: 1, height: startRows - 1, flexShrink: 0 }}>
-                {heading("Start with")}
+                {heading(offerTitle)}
                 {loading
                   ? [0, 1, 2, 3].map((i) => <text key={i} fg={theme.faint}>{i ? " " : "  Loading what works in this setup…"}</text>)
-                  : start.map((a, i) => (
-                      <box key={a.id} onMouseDown={() => fillPrompt(a.request)} style={{ flexDirection: "row", justifyContent: "space-between", flexShrink: 0 }}>
+                  : offer.map((a, i) => (
+                      <box key={a.id} onMouseDown={a.run} style={{ flexDirection: "row", justifyContent: "space-between", flexShrink: 0 }}>
                         <text>
                           <span fg={theme.accent}>{"  ▸ "}</span>
                           <span fg={theme.text}>{a.label.padEnd(32)}</span>
@@ -1640,9 +1710,7 @@ export function App({ options }: { options: TuiOptions }) {
     ? coding
       ? "The coding agent is writing a test · esc to stop"
       : `${thinking ? "ForgeQE's agent" : "The browser agent"} is working · esc to stop`
-    : width >= SPLIT_MIN
-      ? "Ask ForgeQE · / commands · @ references"
-      : "Ask ForgeQE: a goal, test cases, a test, a pipeline… (/ commands, @ references)"
+    : "Ask ForgeQE… (/ for commands, @ to reference a run, file, or work item)"
   const chatLines = lines.filter((l) => l.pane !== "activity")
   const activityLines = lines.filter((l) => l.pane === "activity")
   const stop = () => openDialog("stop")
@@ -1684,13 +1752,17 @@ export function App({ options }: { options: TuiOptions }) {
 
   const transcript = (all: Line[], style: Record<string, unknown>) => (
     <scrollbox ref={scrollRef} stickyScroll stickyStart="bottom" style={{ flexGrow: 1, ...style }} focused={false}>
-      {all.map((line) => (
-        <TranscriptLine key={line.id} line={line} />
+      {all.map((line, i) => (
+        <TranscriptLine key={line.id} line={line} prev={all[i - 1]} />
       ))}
-      {running && (!split || chatWide) ? (
-        <box style={{ flexDirection: "row", marginTop: 1, paddingLeft: 2, flexShrink: 0 }}>
-          <Spinner kind="dots" />
-          <text fg={theme.text}>{` ${activity || "Working…"}`}</text>
+      {running && !panelsOpen ? (
+        // What is happening now, for how long, and with how many tokens, as one line under the conversation.
+        <box style={{ flexDirection: "row", marginTop: 1, flexShrink: 0 }}>
+          <Spinner kind="dots" color={theme.memory} />
+          <text>
+            <span fg={theme.memory}>{` ${activity || "Working…"}`}</span>
+            <span fg={theme.faint}>{`  (${elapsed}${tokens ? ` · ${formatTokens(tokens)} tokens` : ""} · esc to interrupt)`}</span>
+          </text>
         </box>
       ) : null}
     </scrollbox>
@@ -1698,24 +1770,20 @@ export function App({ options }: { options: TuiOptions }) {
   // A long request gets room: the box grows with the text up to nearly half the screen, then scrolls.
   const controls = (paneWidth: number) => renderControls(paneWidth, placeholder, [3, Math.max(3, Math.floor(height * 0.45))])
 
-  const split = width >= SPLIT_MIN
+  const split = panelsOpen
   if (split) {
-    // Wide chat: the conversation across the screen for reading, the panels hidden until Split view.
-    const leftWidth = chatWide ? width : Math.floor(width * 0.4)
+    const leftWidth = Math.floor(width * 0.4)
     return (
       <box style={{ flexDirection: "column", flexGrow: 1 }}>
         <box style={{ flexDirection: "row", height: height - 1, flexShrink: 0, paddingTop: 1 }}>
-          <box onMouseDown={() => navRef.current.focus !== "chat" && setNav((n) => ({ ...n, focus: "chat" }))} style={{ flexDirection: "column", width: leftWidth, height: height - 2, paddingLeft: 2, paddingRight: chatWide ? 2 : 1 }}>
-            <SessionPanel info={sessionInfo} width={leftWidth - (chatWide ? 4 : 3)} />
-            {/* Wide chat shows what the agents do in the conversation, as the one-pane view does. */}
-            {transcript(chatWide ? lines : chatLines, {})}
-            <box style={{ flexDirection: "column", flexShrink: 0 }}>{controls(leftWidth - (chatWide ? 4 : 3))}</box>
+          <box onMouseDown={() => navRef.current.focus !== "chat" && setNav((n) => ({ ...n, focus: "chat" }))} style={{ flexDirection: "column", width: leftWidth, height: height - 2, paddingLeft: 2, paddingRight: 1 }}>
+            <SessionPanel info={sessionInfo} width={leftWidth - 3} />
+            {transcript(chatLines, {})}
+            <box style={{ flexDirection: "column", flexShrink: 0 }}>{controls(leftWidth - 3)}</box>
+          </box>
+          <box style={{ flexDirection: "column", width: width - leftWidth, height: height - 2, paddingLeft: 1, paddingRight: 2 }}>
+            {details(width - leftWidth - 3, height - 2)}
           </box>
-          {chatWide ? null : (
-            <box style={{ flexDirection: "column", width: width - leftWidth, height: height - 2, paddingLeft: 1, paddingRight: 2 }}>
-              {details(width - leftWidth - 3, height - 2)}
-            </box>
-          )}
         </box>
         <Footer left={shortCwd()} right={footerRight} width={width} />
         {paletteOverlay}
@@ -1724,7 +1792,7 @@ export function App({ options }: { options: TuiOptions }) {
   }
 
   const promptWidth = Math.max(40, width - 4)
-  if (narrowView === "details") {
+  if (!wide && narrowView === "details") {
     return (
       <box style={{ flexDirection: "column", flexGrow: 1 }}>
         <box style={{ flexDirection: "column", flexGrow: 1, paddingLeft: 2, paddingRight: 2, paddingTop: 1 }}>{details(promptWidth, height - 3 - (dialog ? 8 : 0))}</box>