@capagents/forgeqe 0.0.0-stage → 1.0.1

package/src/commands.ts

@@ -0,0 +1,101 @@
+export type ShellCommand =
+  | { type: "help" }
+  | { type: "exit" }
+  | { type: "clear" }
+  | { type: "stop" }
+  | { type: "headed"; value: boolean }
+  /** value unset: toggle. */
+  | { type: "details"; value?: boolean }
+  | { type: "profile"; name: string }
+  | { type: "logs"; shots: boolean }
+  | { type: "skills"; name?: string }
+  | { type: "features" }
+  /** Sign in to a system (or save a secret by name), forget one, or show which are signed in. */
+  | { type: "auth"; action: "status" | "login" | "logout"; system?: string }
+  | { type: "text"; text: string }
+  | { type: "unknown"; raw: string }
+
+export const HELP = [
+  "ForgeQE shell",
+  "Type what you want. ForgeQE's agent works out whether it is a goal for the browser, test cases",
+  "(Jira, Azure DevOps, Xray, a file, or steps you paste), a test to write, or a CI pipeline to build,",
+  "and does it. For example:",
+  "  Go to booking.com and search hotels in Mumbai for tomorrow",
+  "  Run SHOP-12 and SHOP-14 from Jira, two browsers at once",
+  "  Run test plan 12 suite 34 from Azure DevOps and don't post results",
+  "  Write a Playwright test for that run",
+  "  Review PR 42 and focus on error handling",
+  "  Add a GitHub Actions workflow that runs tests/cases.yaml on every PR, and make it green",
+  "",
+  "  /stop              stop what is running (or press esc)",
+  "  /headed on|off     show the browser (live profiles)",
+  "  /details [on|off]  show everything the agents do (reasoning, every file read, engine logs); off: just progress",
+  "  /profile <name>    switch LLM profile (or press tab)",
+  "  /logs [shots]      save this session's log and runs in one archive to share (shots: with screenshots)",
+  "  /features          what ForgeQE can do, and what each capability still needs here",
+  "  /skills [name]     the skills each agent can use, or one skill's instructions",
+  "  /auth [system]     sign in to Azure DevOps, GitHub, Jira, Confluence, TestRail, Zephyr, qTest or Xray in the browser",
+  "                     (/auth alone: what is signed in; /auth logout <system>; /auth <ENV_NAME> saves one secret)",
+  "  /clear             clear the transcript",
+  "  /help              this list",
+  "  /exit              quit",
+  "",
+  "Select text with the mouse to copy it.",
+].join("\n")
+
+const COMMANDS = new Set(["help", "?", "exit", "quit", "q", "clear", "stop", "headed", "details", "verbose", "profile", "p", "logs", "skills", "features", "auth", "signin"])
+
+/** Session controls; every other line, including one that starts with a path, goes to the agent as text. */
+export function parseCommand(raw: string): ShellCommand {
+  const line = raw.trim()
+  if (!line) return { type: "unknown", raw: "" }
+  if (!line.startsWith("/")) return { type: "text", text: line }
+
+  const body = line.slice(1).trim()
+  const space = body.indexOf(" ")
+  const head = (space === -1 ? body : body.slice(0, space)).toLowerCase()
+  const arg = space === -1 ? "" : body.slice(space + 1).trim()
+  if (!COMMANDS.has(head)) return { type: "text", text: line }
+
+  switch (head) {
+    case "help":
+    case "?":
+      return { type: "help" }
+    case "exit":
+    case "quit":
+    case "q":
+      return { type: "exit" }
+    case "clear":
+      return { type: "clear" }
+    case "stop":
+      return { type: "stop" }
+    case "logs":
+      return { type: "logs", shots: /^(shots|screenshots)$/i.test(arg) }
+    case "skills":
+      return arg ? { type: "skills", name: arg } : { type: "skills" }
+    case "features":
+      return { type: "features" }
+    case "auth":
+    case "signin": {
+      const [first, ...rest] = arg.split(/\s+/).filter(Boolean)
+      if (!first || (first === "status" && head === "auth")) return head === "signin" ? { type: "auth", action: "login" } : { type: "auth", action: "status" }
+      if (/^(logout|signout|forget)$/i.test(first)) return rest[0] ? { type: "auth", action: "logout", system: rest.join(" ") } : { type: "unknown", raw: line }
+      if (/^(login|signin)$/i.test(first)) return { type: "auth", action: "login", ...(rest.length ? { system: rest.join(" ") } : {}) }
+      return { type: "auth", action: "login", system: [first, ...rest].join(" ") }
+    }
+    case "details":
+    case "verbose": {
+      if (!arg) return { type: "details" }
+      if (/^(1|on|true|yes|full)$/i.test(arg)) return { type: "details", value: true }
+      if (/^(0|off|false|no|brief)$/i.test(arg)) return { type: "details", value: false }
+      return { type: "unknown", raw: line }
+    }
+    case "headed": {
+      if (/^(1|on|true|yes)$/i.test(arg)) return { type: "headed", value: true }
+      if (/^(0|off|false|no)$/i.test(arg)) return { type: "headed", value: false }
+      return { type: "unknown", raw: line }
+    }
+    default:
+      return arg ? { type: "profile", name: arg } : { type: "unknown", raw: line }
+  }
+}