@capagents/forgeqe 1.0.9 → 1.1.1

package/src/tui/components.tsx

@@ -122,64 +122,56 @@ export function Prompt(props: PromptProps) {
     props.onLines?.(needed)
     setLines(needed)
   }
+  // A rounded box with ">" before the text, as in Claude Code; the border lights up while it has the keys.
   return (
-    <box style={{ flexDirection: "column", width: props.width, flexShrink: 0 }}>
-      <box
-        border={["left"]}
-        borderColor={props.modeColor}
-        customBorderChars={BAR}
-        style={{
-          flexDirection: "column",
-          backgroundColor: theme.panel,
-          paddingLeft: 2,
-          paddingRight: 2,
-          paddingTop: 1,
-          paddingBottom: 1,
-          width: props.width,
-        }}
-      >
-        {props.masked !== undefined ? (
-          <text style={{ height: 1 }}>
-            {props.masked ? <span fg={theme.text}>{"•".repeat(Math.min(props.masked, Math.max(1, props.width - 8)))}</span> : <span fg={theme.faint}>{props.placeholder}</span>}
-          </text>
-        ) : (
-          <textarea
-            key={props.inputKey}
-            ref={ref}
-            placeholder={props.placeholder}
-            focused={props.focused !== false}
-            initialValue={props.initialValue || ""}
-            wrapMode="word"
-            keyBindings={PROMPT_KEYS}
-            onSubmit={() => props.onSubmit(ref.current?.plainText ?? "")}
-            onContentChange={fit}
-            style={{ height: rows }}
-            backgroundColor={theme.panel}
-            focusedBackgroundColor={theme.panel}
-            textColor={theme.text}
-            focusedTextColor={theme.text}
-            placeholderColor={theme.faint}
-          />
-        )}
-        {props.compact ? null : (
-          <box style={{ flexDirection: "row", justifyContent: "space-between", marginTop: 1 }}>
-            <text>
-              <span fg={theme.muted}>{"Model  "}</span>
-              <span fg={theme.text}>{props.model || "…"}</span>
-            </text>
-            <text>
-              {props.right ? <span fg={props.rightColor || theme.muted}>{props.right}</span> : null}
-              {props.right ? <span fg={theme.faint}>{"  ·  "}</span> : null}
-              <span fg={theme.muted}>{"profile "}</span>
-              <span fg={theme.text}>{props.profile || "none"}</span>
+    <box
+      border
+      borderStyle="rounded"
+      borderColor={props.focused === false ? theme.border : theme.muted}
+      style={{ flexDirection: "column", width: props.width, flexShrink: 0, paddingLeft: 1, paddingRight: 1 }}
+    >
+      <box style={{ flexDirection: "row" }}>
+        <text fg={props.modeColor} style={{ width: 2, flexShrink: 0 }}>
+          {">"}
+        </text>
+        <box style={{ flexDirection: "column", flexGrow: 1, flexShrink: 1 }}>
+          {props.masked !== undefined ? (
+            <text style={{ height: 1 }}>
+              {props.masked ? <span fg={theme.text}>{"•".repeat(Math.min(props.masked, Math.max(1, props.width - 8)))}</span> : <span fg={theme.faint}>{props.placeholder}</span>}
             </text>
-          </box>
-        )}
+          ) : (
+            <textarea
+              key={props.inputKey}
+              ref={ref}
+              placeholder={props.placeholder}
+              focused={props.focused !== false}
+              initialValue={props.initialValue || ""}
+              wrapMode="word"
+              keyBindings={PROMPT_KEYS}
+              onSubmit={() => props.onSubmit(ref.current?.plainText ?? "")}
+              onContentChange={fit}
+              style={{ height: rows }}
+              textColor={theme.text}
+              focusedTextColor={theme.text}
+              placeholderColor={theme.faint}
+            />
+          )}
+        </box>
       </box>
-      <text>
-        <span fg={props.modeColor}>{edge.slice(0, 1)}</span>
-        <span fg={theme.panel}>{edge.slice(1)}</span>
-      </text>
+      {props.compact ? null : (
+        <box style={{ flexDirection: "row", justifyContent: "space-between", marginTop: 1 }}>
+          <text>
+            <span fg={theme.muted}>{"Model  "}</span>
+            <span fg={theme.text}>{props.model || "…"}</span>
+          </text>
+          <text>
+            {props.right ? <span fg={props.rightColor || theme.muted}>{props.right}</span> : null}
+            {props.right ? <span fg={theme.faint}>{"  ·  "}</span> : null}
+            <span fg={theme.muted}>{"profile "}</span>
+            <span fg={theme.text}>{props.profile || "none"}</span>
+          </text>
+        </box>
+      )}
     </box>
   )
 }

package/src/tui/landing.ts

@@ -11,32 +11,84 @@ import { allStatuses, configuredSystems, SYSTEM_LABEL, type Probes, MACHINE } fr
  * in the folder, so it changes as the setup changes.
  */
 
-/** "C# · .NET solution · Playwright Test": what the folder's own files say it is built with. */
-export function projectStack(cwd: string): string[] {
-  let names: string[] = []
+/** Files a stack is read from, at the top and one or two folders down (tests/Shop.Tests/Shop.Tests.csproj). */
+function projectFiles(cwd: string, match: RegExp, depth = 2): string[] {
+  const out: string[] = []
+  const walk = (dir: string, level: number) => {
+    let names: string[] = []
+    try {
+      names = readdirSync(dir)
+    } catch {
+      return
+    }
+    for (const n of names) {
+      if (n.startsWith(".") || n === "node_modules" || n === "bin" || n === "obj") continue
+      const full = path.join(dir, n)
+      if (match.test(n)) out.push(full)
+      else if (level < depth) {
+        try {
+          if (statSync(full).isDirectory()) walk(full, level + 1)
+        } catch {}
+      }
+      if (out.length > 20) return
+    }
+  }
+  walk(cwd, 0)
+  return out
+}
+
+const read = (file: string) => {
   try {
-    names = readdirSync(cwd)
+    return readFileSync(file, "utf8")
   } catch {
-    return []
+    return ""
   }
-  const has = (re: RegExp) => names.some((n) => re.test(n))
-  const out: string[] = []
-  if (has(/^playwright\.config\.(ts|js|mjs|cjs)$/)) out.push("Playwright Test")
-  if (has(/^cypress\.config\.(ts|js|mjs|cjs)$/)) out.push("Cypress")
-  if (has(/\.sln$/) || has(/\.csproj$/)) out.push(".NET")
-  if (has(/^pom\.xml$/)) out.push("Maven")
-  if (has(/^build\.gradle(\.kts)?$/)) out.push("Gradle")
-  if (has(/^(pytest\.ini|conftest\.py)$/) || (has(/^pyproject\.toml$/) && !out.length)) out.push("Python")
-  if (has(/^package\.json$/) && !out.some((s) => s === "Playwright Test" || s === "Cypress")) out.push("Node")
-  return out.slice(0, 2)
 }
 
-/** The project line: folder, stack, the systems ForgeQE works with here, and the model. */
-export function projectLine(cfg: AppConfig | null, cwd: string, model: string): string[] {
-  const parts = [path.basename(cwd), ...projectStack(cwd)]
-  if (cfg) parts.push(...[...configuredSystems(cfg)].filter((s) => s !== "xray" || !configuredSystems(cfg).has("jira")).map((s) => SYSTEM_LABEL[s]))
-  if (model) parts.push(model)
-  return parts.filter(Boolean)
+/**
+ * "C# · NUnit · Playwright": the language, test framework, and browser library the project's own files declare
+ * (project files, package.json, Python requirements). Read from the files, never guessed from folder names.
+ */
+export function projectStack(cwd: string): string[] {
+  const csproj = projectFiles(cwd, /\.csproj$/).map(read).join("\n")
+  if (csproj) {
+    const framework = /PackageReference Include="NUnit"/i.test(csproj) ? "NUnit" : /PackageReference Include="xunit/i.test(csproj) ? "xUnit" : /PackageReference Include="MSTest/i.test(csproj) ? "MSTest" : ""
+    const browser = /Microsoft\.Playwright/i.test(csproj) ? "Playwright" : /Selenium\.WebDriver/i.test(csproj) ? "Selenium" : /Reqnroll|SpecFlow/i.test(csproj) ? "BDD" : ""
+    return ["C#", framework, browser].filter(Boolean)
+  }
+  const pkg = read(path.join(cwd, "package.json"))
+  if (pkg) {
+    const lang = existsSync(path.join(cwd, "tsconfig.json")) ? "TypeScript" : "JavaScript"
+    const runner = /"@playwright\/test"/.test(pkg) ? "Playwright Test" : /"cypress"/.test(pkg) ? "Cypress" : /"webdriverio"|"@wdio\//.test(pkg) ? "WebdriverIO" : /"vitest"/.test(pkg) ? "Vitest" : /"jest"/.test(pkg) ? "Jest" : ""
+    return [lang, runner].filter(Boolean)
+  }
+  const py = ["requirements.txt", "pyproject.toml", "setup.cfg"].map((f) => read(path.join(cwd, f))).join("\n")
+  if (py.trim() || existsSync(path.join(cwd, "pytest.ini")) || existsSync(path.join(cwd, "conftest.py"))) {
+    return ["Python", /pytest/i.test(py) || existsSync(path.join(cwd, "pytest.ini")) ? "pytest" : "", /playwright/i.test(py) ? "Playwright" : /selenium/i.test(py) ? "Selenium" : ""].filter(Boolean)
+  }
+  const java = [read(path.join(cwd, "pom.xml")), read(path.join(cwd, "build.gradle")), read(path.join(cwd, "build.gradle.kts"))].join("\n")
+  if (java.trim()) return ["Java", /junit-jupiter|junit/i.test(java) ? "JUnit" : /testng/i.test(java) ? "TestNG" : "", /playwright/i.test(java) ? "Playwright" : /selenium/i.test(java) ? "Selenium" : ""].filter(Boolean)
+  return []
+}
+
+export type Fact = { text: string; tone: "name" | "plain" | "warn" }
+
+/**
+ * The project line: the folder, its stack, each system ForgeQE works with here and how it is signed in ("Azure DevOps
+ * (PAT)"), and the model; or, where nothing is set up, that this folder has no forgeqe.yaml.
+ */
+export function projectLine(cfg: AppConfig | null, cwd: string, opts: { model: string; signIns?: Record<string, string> }): Fact[] {
+  const facts: Fact[] = [{ text: path.basename(cwd), tone: "name" }, ...projectStack(cwd).map((t) => ({ text: t, tone: "plain" as const }))]
+  if (!cfg) return facts
+  if (!cfg.configPath) return [...facts, { text: "no forgeqe.yaml here", tone: "warn" }]
+  const systems = [...configuredSystems(cfg)].filter((s) => s !== "xray" || !configuredSystems(cfg).has("jira"))
+  for (const s of systems) {
+    const how = opts.signIns?.[SYSTEM_LABEL[s]]
+    facts.push({ text: how ? `${SYSTEM_LABEL[s]} (${how})` : SYSTEM_LABEL[s], tone: "plain" })
+  }
+  const live = cfg.llm.provider !== "none" && cfg.llm.provider !== "mock"
+  facts.push(live && opts.model ? { text: opts.model, tone: "plain" } : { text: "no model", tone: "warn" })
+  return facts
 }
 
 const ALL_SYSTEMS = Object.values(SYSTEM_LABEL)
@@ -61,8 +113,9 @@ const START_LABEL: Record<string, string> = {
   "browser-goals": "Try a flow in the browser",
 }
 
-export function startActions(cfg: AppConfig | null, limit = 4, probes: Probes = MACHINE): StartAction[] {
-  if (!cfg) return []
+export function startActions(cfg: AppConfig | null, limit = 4, probes: Probes = MACHINE, hasRuns = true): StartAction[] {
+  // Without a live model nothing on the list can run: the start screen offers Get started instead.
+  if (!cfg || cfg.llm.provider === "none" || cfg.llm.provider === "mock") return []
   const statuses = allStatuses(cfg, probes)
   const systems = [...configuredSystems(cfg)].map((x) => SYSTEM_LABEL[x])
   const out: StartAction[] = []
@@ -70,9 +123,12 @@ export function startActions(cfg: AppConfig | null, limit = 4, probes: Probes =
     const c = CAPABILITIES.find((x) => x.id === id)
     if (!c || statuses.get(id)?.state === "needs_setup") continue
     // An example in the words of this setup: one that names a system that is set up, else one that names none.
-    const named = c.examples.find((e) => systems.some((n) => e.includes(n)))
-    const neutral = c.examples.find((e) => !ALL_SYSTEMS.some((n) => e.includes(n)))
-    const example = named || neutral || c.examples[0] || c.title
+    // Not an example that builds on a run when there is none to build on.
+    const usable = c.examples.filter((e) => hasRuns || !/\blast run\b|\bthe run\b|that run/i.test(e))
+    if (!usable.length) continue
+    const named = usable.find((e) => systems.some((n) => e.includes(n)))
+    const neutral = usable.find((e) => !ALL_SYSTEMS.some((n) => e.includes(n)))
+    const example = named || neutral || usable[0]!
     out.push({ id, label: START_LABEL[id] || c.title, detail: example, request: example })
     if (out.length === limit) break
   }
@@ -91,9 +147,11 @@ export function recentWork(outDir: string, limit = 3): RecentItem[] {
       if (!statSync(dir).isDirectory()) continue
       const when = statSync(dir).mtime
       if (existsSync(path.join(dir, "run.json"))) {
-        const run = JSON.parse(readFileSync(path.join(dir, "run.json"), "utf8")) as { goal?: string; status?: string }
+        // The engine writes success; ForgeQE's own records write status. Either says how the run ended.
+        const run = JSON.parse(readFileSync(path.join(dir, "run.json"), "utf8")) as { goal?: string; status?: string; success?: boolean }
         const report = path.join(dir, "report.html")
-        items.push({ kind: "run", title: String(run.goal || name), dir, open: existsSync(report) ? report : dir, when, status: run.status })
+        const status = run.status || (run.success === true ? "passed" : run.success === false ? "fail" : undefined)
+        items.push({ kind: "run", title: String(run.goal || name), dir, open: existsSync(report) ? report : dir, when, ...(status ? { status } : {}) })
       } else if (existsSync(path.join(dir, "report.md"))) {
         const first = readFileSync(path.join(dir, "report.md"), "utf8").split("\n")[0] || ""
         const html = path.join(dir, "report.html")
@@ -126,3 +184,18 @@ export function setupSentence(missing: string[], room: number): string {
   const named = `${listWords(missing)} ${missing.length === 1 ? "is" : "are"} not set up`
   return named.length <= room ? named : `${missing.length} ${missing.length === 1 ? "item is" : "items are"} not set up`
 }
+
+/** What to do first where little is set up: each step runs a command or says how, in the order they are needed. */
+export type GetStarted = { id: string; label: string; detail: string; command?: string; fix?: string }
+
+export function getStarted(cfg: AppConfig | null, setup: { id: string; done: boolean; fix?: string; command?: string }[]): GetStarted[] {
+  if (!cfg) return []
+  const out: GetStarted[] = []
+  if (!cfg.configPath) out.push({ id: "init", label: "Set up ForgeQE in this folder", detail: "writes forgeqe.yaml, llms.json, prompts, skills", command: "/init" })
+  const missing = (id: string) => setup.find((i) => i.id === id && !i.done)
+  const model = missing("model")
+  if (model) out.push({ id: "model", label: "Add a model", detail: "an API key or Microsoft Entra ID, in llms.json", fix: model.fix })
+  const system = missing("system")
+  if (system) out.push({ id: "system", label: "Sign in to Azure DevOps or Jira", detail: "test cases, stories, pipelines", command: "/auth" })
+  return out.slice(0, 4)
+}

package/src/tui/next.ts

@@ -26,7 +26,7 @@ export function nextSteps(p: Produced, opts: { testsOn: boolean; followUps?: Fol
     steps.push({ label: "Rerun the cases that failed", run: { kind: "insert", text: "Run the cases that failed in the last suite again" } })
   } else if (run) {
     const report = path.join(run.runDir, "report.html")
-    if (run.status === "complete" && !p.tests.some((t) => t.runDir === run.runDir)) steps.push({ label: "Write a test for this run", run: { kind: "insert", text: "Write a test for the last run" } })
+    if (opts.testsOn && run.status === "complete" && !p.tests.some((t) => t.runDir === run.runDir)) steps.push({ label: "Write a test for this run", run: { kind: "insert", text: "Write a test for the last run" } })
     if (run.status !== "complete") {
       steps.push({ label: "Why did it fail?", run: { kind: "insert", text: "Why did the last run fail, and what should change?" } })
       steps.push({ label: "Run it again, visible", run: { kind: "insert", text: "Run the last goal again in a visible browser" } })

package/src/tui/palette.tsx

@@ -34,6 +34,7 @@ export function paletteItems(opts: { running: boolean; headed: boolean; detailsF
   items.push({ id: "shortcuts", group: "Action", title: "Keyboard shortcuts", keys: "?", run: { kind: "action", id: "shortcuts" } })
   command("features", "What ForgeQE can do here", "/features", "and what each feature still needs")
   command("auth", "Sign in to a system", "/auth", "Azure DevOps, GitHub, Jira, Confluence, TestRail, Zephyr, qTest, Xray")
+  command("init", "Set up ForgeQE in this folder", "/init", "forgeqe.yaml, llms.json, prompts, skills, knowledge")
   command("auth-status", "What is signed in", "/auth status")
   command("headed", opts.headed ? "Hide the browser window" : "Show the browser window", `/headed ${opts.headed ? "off" : "on"}`)
   command("details", opts.detailsFull ? "Show progress only" : "Show everything the agents do", `/details ${opts.detailsFull ? "off" : "on"}`)

package/src/tui/refine-panel.tsx

@@ -1,11 +1,12 @@
 import type { Refined } from "../refine.ts"
 import { Spinner } from "./components.tsx"
-import { theme } from "./theme.ts"
+import { formatDuration, formatTokens, theme } from "./theme.ts"
 
 /** Refine's panel, in the prompt's place: working, the result with what was checked, or why it could not refine. */
 export type RefineState =
   | { phase: "working"; original: string }
-  | { phase: "done"; original: string; result: Refined; choice: number }
+  /** `tokens` and `ms`: what Refine's own model session cost, shown in the title. */
+  | { phase: "done"; original: string; result: Refined; choice: number; tokens?: number; ms?: number }
   | { phase: "error"; original: string; message: string }
 
 export const REFINE_CHOICES = [
@@ -18,9 +19,24 @@ export type RefineChoice = (typeof REFINE_CHOICES)[number]["id"]
 
 const COLOR = theme.memory
 
+/** A fact as written in context and in grounded, compared without case, spaces, or a closing full stop. */
+const norm = (s: string) => s.trim().replace(/\.$/, "").replace(/\s+/g, " ").toLowerCase()
+
+/** The choice the panel starts on: Edit while Refine still has a question, so an unclear request is not sent. */
+export function initialChoice(missing: string[]): number {
+  return REFINE_CHOICES.findIndex((c) => c.id === (missing.length ? "edit" : "use"))
+}
+
 export function RefinePanel(props: { state: RefineState; width: number; onChoose: (id: RefineChoice) => void; onHover: (i: number) => void }) {
   const { state, width } = props
-  const title = state.phase === "working" ? " ✦ Refining " : state.phase === "error" ? " ✦ Could not refine " : " ✦ Refined request "
+  const cost = state.phase === "done" && state.tokens ? ` · ${formatTokens(state.tokens)} tokens${state.ms ? ` · ${formatDuration(state.ms)}` : ""}` : ""
+  // How much of the request keeps the ASD-STE100 rules, as Refine's prompt asks.
+  const ste = state.phase === "done" && state.result.ste !== undefined ? ` · STE ${Math.round(state.result.ste * 100)}%` : ""
+  const title = state.phase === "working" ? " ✦ Refining " : state.phase === "error" ? " ✦ Could not refine " : ` ✦ Refined request${ste}${cost} `
+  // Facts Refine checked that are also context lines are marked there, not repeated under Checked.
+  const contextLines = state.phase === "done" ? state.result.refined.split("\n").filter((l) => l.startsWith("- ")).map((l) => norm(l.slice(2))) : []
+  const inContext = new Set(contextLines)
+  const checked = new Set(state.phase === "done" ? state.result.grounded.filter((g) => g.checked).map((g) => norm(g.fact)).filter((f) => inContext.has(f)) : [])
   const section = (label: string, color: string, mark: string, items: string[]) =>
     items.length ? (
       <box style={{ flexDirection: "column", marginTop: 1 }}>
@@ -49,9 +65,18 @@ export function RefinePanel(props: { state: RefineState; width: number; onChoose
           <text fg={theme.err}>{state.message}</text>
         ) : (
           <>
-            {/* The request as it is sent: its labelled parts (Goal, Context, Steps, Rules, Result) stand out. */}
+            {/* The request as it is sent: its labelled parts (Role, Objective, Context, Steps, Rules, Output format, Summary) stand out. */}
             {state.result.refined.split("\n").map((line, i) => {
-              const label = /^(Goal|Context|Steps|Rules|Result):/.exec(line)
+              const label = /^(Role|Objective|Context|Steps|Rules|Output format|Summary|Goal|Result):/.exec(line)
+              // A context line Refine checked against the systems: ✓ in place of its dash, so it is not listed twice.
+              if (line.startsWith("- ") && checked.has(norm(line.slice(2)))) {
+                return (
+                  <text key={i}>
+                    <span fg={theme.ok}>{"✓ "}</span>
+                    <span fg={theme.text}>{line.slice(2)}</span>
+                  </text>
+                )
+              }
               return label ? (
                 <text key={i}>
                   <span fg={COLOR}>{label[0]}</span>
@@ -63,7 +88,7 @@ export function RefinePanel(props: { state: RefineState; width: number; onChoose
                 </text>
               )
             })}
-            {section("Checked", theme.ok, "✓", state.result.grounded.filter((g) => g.checked).map((g) => g.fact))}
+            {section("Checked", theme.ok, "✓", state.result.grounded.filter((g) => g.checked && !inContext.has(norm(g.fact))).map((g) => g.fact))}
             {section("Assumed", theme.warn, "~", [...state.result.grounded.filter((g) => !g.checked).map((g) => g.fact), ...state.result.assumed])}
             {section("Missing — answer these in your request", theme.err, "?", state.result.missing)}
           </>
@@ -88,7 +113,7 @@ export function RefinePanel(props: { state: RefineState; width: number; onChoose
           {state.phase === "done" ? (
             <>
               <span fg={theme.text}>{"enter"}</span>
-              <span fg={theme.muted}>{" use  "}</span>
+              <span fg={theme.muted}>{` ${REFINE_CHOICES[state.choice]!.id === "keep" ? "keep mine" : REFINE_CHOICES[state.choice]!.id}  `}</span>
               <span fg={theme.text}>{"e"}</span>
               <span fg={theme.muted}>{" edit  "}</span>
               <span fg={theme.text}>{"esc"}</span>

package/src/tui/shortcuts.tsx

@@ -17,7 +17,7 @@ export const SHORTCUTS: { group: string; keys: [string, string][] }[] = [
     keys: [
       ["ctrl+p", "search: actions, commands, profiles, examples"],
       ["shift+tab", "move between the chat and the plan, activity, and files panels"],
-      ["ctrl+o", "chat or details, on a narrow terminal"],
+      ["ctrl+o", "open or close the panels: plan, activity, files, context, tokens"],
       ["alt+1 to alt+4", "a start action, or a next step"],
     ],
   },