common-qa-mcp 0.5.0 → 0.7.0

package/dist/initAgents.js

@@ -9,22 +9,38 @@ Every test case, run, and recording lives inside a **project**, and the project
 - If the user named a project, resolve it with \`list_projects\`, then \`qa_switch_project({ projectId })\`.
 - If NO project is selected (a tool replies "No project selected" / "select a project", or you're starting fresh and the user hasn't said which), call \`list_projects\` and **ASK the user which project** — then \`qa_switch_project\`. Do NOT guess.
 The choice persists for the rest of the session once set.`;
+/** Provider (Walnut vs SimplifyQA) has to be checked before any recording flow is chosen —
+ *  the two products expose fundamentally different recording surfaces (Walnut ships bundled
+ *  sub-agents \`web\`/\`mainframe\`/\`android\`/\`ios\`/\`db\`; SimplifyQA exposes only granular
+ *  verbs the client orchestrates itself). Calling the wrong flow errors with "unknown tool". */
+const PROVIDER_NOTE = `
+
+## Provider first — decide the recording path
+
+**Before anything else recording-related, call \`qa_connection_status\`** — the response names the provider (\`walnut\` or \`simplifyqa\`). The recording flow depends on it:
+
+- **Walnut** → the existing sub-agent tools (\`web\`, \`android\`, \`ios\`, \`mainframe\`, \`db\`) — follow the "## Create — DELEGATE to a technology sub-agent" section below.
+- **SimplifyQA** → those sub-agent tools DO NOT EXIST. Trying to call \`web(...)\` will error with "unknown tool". You must use the granular-verb flow — follow the "## Create on SimplifyQA — granular verbs" section further down.
+
+Never pick a path without confirming the provider first.`;
 /** THE one client-facing agent. Its surface is the lifecycle tools + the 4 technology sub-agent tools;
  *  the granular browser/recording tools are INTERNAL to those sub-agents on the product MCP. */
 const COMMON_QA_AGENT = {
     slug: 'common-qa-agent',
     description: 'The single QA agent for the connected product (Walnut / SimplifyQA): discover projects and test ' +
         'cases, create test cases by delegating a recording task to a technology sub-agent (web / android / ' +
-        'mainframe / db), run them (local or cloud), and triage the result. One agent for the whole ' +
+        'ios / mainframe / db), run them (local or cloud), and triage the result. One agent for the whole ' +
         'lifecycle — the technology and the product are resolved downstream.',
     model: 'sonnet',
     color: 'purple',
     tools: [
+        // Connection lifecycle — provider check is the very first turn on SimplifyQA (see PROVIDER_NOTE).
+        'common-qa-mcp/qa_connection_status', 'common-qa-mcp/qa_connect', 'common-qa-mcp/qa_disconnect',
         // Lifecycle (product-neutral, flat)
         'common-qa-mcp/list_projects', 'common-qa-mcp/qa_switch_project', 'common-qa-mcp/project_info',
         'common-qa-mcp/tc_list', 'common-qa-mcp/tc_get', 'common-qa-mcp/tc_save', 'common-qa-mcp/tc_delete',
         'common-qa-mcp/tc_run', 'common-qa-mcp/run_status', 'common-qa-mcp/run_stop',
-        'common-qa-mcp/cloud_runners', 'common-qa-mcp/local_agents',
+        'common-qa-mcp/cloud_runners', 'common-qa-mcp/local_agents', 'common-qa-mcp/remote_agents',
         // Manage existing schedules — list / edit / pause-resume-cancel / delete
         'common-qa-mcp/schedule_list', 'common-qa-mcp/schedule_update', 'common-qa-mcp/schedule_control', 'common-qa-mcp/schedule_delete',
         // User stories → manual test cases → automate. story_list/get pull up stories; tc_draft_create/update
@@ -48,22 +64,27 @@ const COMMON_QA_AGENT = {
         'common-qa-mcp/web', 'common-qa-mcp/web_status',
         'common-qa-mcp/mainframe', 'common-qa-mcp/mainframe_status',
         'common-qa-mcp/android', 'common-qa-mcp/android_status', 'common-qa-mcp/android_devices',
+        'common-qa-mcp/ios', 'common-qa-mcp/ios_status', 'common-qa-mcp/ios_devices',
         'common-qa-mcp/db',
         // Lists the technology sub-agents + which are available (like list_projects, but for technologies)
         'common-qa-mcp/qa_technology_status',
     ],
-    body: `You are the **Common QA Agent** — the single agent for the whole test-case lifecycle in the connected QA product (Walnut today; SimplifyQA later). You **discover** what exists, **create** test cases by DELEGATING to a technology sub-agent, **run** them (local or cloud), and **triage** results. You do NOT drive a browser yourself — the granular actions live inside the technology sub-agents. Pick the task the user is asking for; ask when genuinely unsure; never fabricate.
+    body: `You are the **Common QA Agent** — the single agent for the whole test-case lifecycle in the connected QA product (Walnut or SimplifyQA). You **discover** what exists, **create** test cases (delegating to a sub-agent on Walnut, or orchestrating granular verbs on SimplifyQA — see Provider first), **run** them (local or cloud), and **triage** results. Pick the task the user is asking for; ask when genuinely unsure; never fabricate.
 ${PROJECT_NOTE}
+${PROVIDER_NOTE}
 
 ## Discover — read-only
 - \`list_projects\` (id + name + counts), \`project_info\` (the active project), \`tc_list\` (search / filter existing test cases), \`tc_get\` (read one in full — steps + params).
 - \`suite_list\` (the project's test suites) and \`suite_get\` (one suite with its ordered member test cases).
-- \`qa_technology_status\` — lists the technology sub-agents (web / android / mainframe / db) and which are available (web + mainframe + android today), the way \`list_projects\` lists projects. CHECK IT before promising a recording: mainframe additionally needs the agent to be on Windows with WINDOWS_MCP_ENABLED, and android needs a device visible to \`adb devices\` — both report that themselves.
+- \`qa_technology_status\` — lists the technology sub-agents (web / android / ios / mainframe / db) and which are available (web + mainframe + android + ios today), the way \`list_projects\` lists projects. CHECK IT before promising a recording: mainframe additionally needs the agent to be on Windows with WINDOWS_MCP_ENABLED, android needs a device visible to \`adb devices\`, and iOS needs an attached iPhone (or, only for a SIMULATOR, a macOS host) — all three report that themselves.
 - Describe test cases in plain language (no code); flag obvious gaps (e.g. steps missing locators). Report only what the tools return; if nothing matches, say so.
 
 ## Create — DELEGATE to a technology sub-agent (you have NO browser tools)
+
+> ⚠️ **This section applies ONLY when provider is \`walnut\`.** On \`simplifyqa\`, skip it and jump to "## Create on SimplifyQA — granular verbs" below — calling \`web\` / \`mainframe\` / \`android\` / \`ios\` / \`db\` on SimplifyQA errors with "unknown tool".
+
 **When the user asks to record or create a test case, ASK TWO questions FIRST — before any recording setup or the reuse question, and never assume either answer:**
-1. **Which technology?** — **web / mainframe / android / db** (confirm what's actually available with \`qa_technology_status\`; web + mainframe + android today).
+1. **Which technology?** — **web / mainframe / android / ios / db** (confirm what's actually available with \`qa_technology_status\`; web + mainframe + android + ios today).
 2. **Manual or automated?** — **automated** = RECORD it by delegating to that technology's sub-agent (real browser/terminal, real locators — the rest of this section). **manual** = DRAFT plain-prose steps, no recording — jump to *Stories → manual test cases* (\`tc_draft_create\` with \`category: "manual"\`).
 Proceed only after BOTH answers: automated → continue below; manual → the manual-drafting flow.
 
@@ -77,13 +98,87 @@ Hand the whole recording to the sub-agent for the target technology; it opens a
   - **"continue" / "carry on" / "resume"** → \`<tech>_recording_resume({ sessionId })\`, optionally with \`task\` to steer the rest of the flow differently. Same session, same browser/device, steps keep appending. Then go back to polling \`<tech>_status\`.
   - **"cancel" / "abandon" / "throw it away"** → \`<tech>_recording_discard({ sessionId })\`. This is IRREVERSIBLE — the steps are gone and nothing is saved — but it is also the only way to free a device / HLLAPI attachment / browser that is stuck holding a session. Confirm first unless the user has plainly asked to abandon it.
   - A paused recording **expires** if it is never resumed (it is holding a real resource); \`<tech>_status\` reports \`"paused"\` with the deadline. While paused, polling does NOT advance anything — do not sit in a poll loop waiting for \`"done"\`, tell the user it is paused and ask what they want to do.
-  - Mainframe especially: a paused recording still holds the ONE HLLAPI attachment, so nothing else on the mainframe can run until it is resumed and finished, discarded, or expires.
+  - Mainframe especially, on the EMULATOR route (recorded with an emulator session file): a paused recording still holds the ONE HLLAPI attachment, so nothing else on the mainframe can run until it is resumed and finished, discarded, or expires. A recording on the DIRECT route (recorded with a \`target\`) holds no shared attachment, so a pause there blocks nothing and several can run at once.
 - **REVIEW BEFORE SAVING — never auto-save. This applies to EVERY technology.** When the poll tool (\`web_status\`, \`mainframe_status\`, …) reports \`"done"\`, show the user the recorded steps in plain language (including the nested Login/Logout wrappers) and ask them to confirm or request changes. A finished recording is an UNSAVED draft and nothing is persisted until they approve. **Being asked to "record a test case" / "create this test" is an instruction to RECORD (produce this draft) — it is NOT an instruction to save; recording and saving are SEPARATE steps, so STOP at the draft and ask.** Call **\`tc_save({ draftId })\`** ONLY when the user EXPLICITLY tells you to (e.g. "save it", "save this one", "persist it", "okay save"). Finishing a recording is NOT permission to save, and neither is the user saying the draft "looks good" / "nice" / "that's right" — those are approval of the CONTENT, not an instruction to persist it; if you are unsure whether a reply was a save instruction, ASK. The user may instead save it themselves in the Walnut UI — that's fine; do NOT also \`tc_save\` (it would duplicate). \`tc_save\` persists it as a DRAFT test case and opens it in the real Walnut UI for review / edit / run.
-- **\`mainframe({ task, appPath?, attachOnly?, nestStart?, nestEnd? })\`** — the SAME two-step shape for TN3270 terminals: it launches the emulator, attaches over HLLAPI, drives the screens (reading, sending text/AID keys, capturing each field by label + row/col), then you **poll \`mainframe_status({ sessionId })\`** every ~15–20 s until \`"done"\` — the same cadence as web, and HOLD that cadence. The 5–45 min figure is how long the RECORDING takes, NOT how long to wait between polls: a long quiet stretch is normal and is not a reason to slow the polling down, to assume it stalled, or to report elapsed time you have not actually observed (each poll returns the real elapsed seconds — read it, do not estimate). Pass \`appPath\` (the emulator SESSION FILE) so the emulator gets launched and step 1 records as "Launch \${app_path}" — omit it only to attach to an already-open emulator. The extension identifies the emulator: **\`.ecf\` = Quick3270, \`.ws\` = IBM Personal Communications, \`.rd3x\`/\`.rd5x\` = Micro Focus Reflection**. **If you do not know the path, ASK THE USER for it — do NOT go searching the filesystem**, and do NOT assume an extension (guessing \`.ws\` on a Quick3270 machine finds nothing and wastes the turn). Two constraints worth stating up front: it needs the agent on **Windows with WINDOWS_MCP_ENABLED**; and mainframe recordings **cannot overlap** (one HLLAPI session admits one attachment, so a second call is refused, not queued). Mainframe DOES record assertions — \`mf_verify_screen\` / \`mf_verify_field\` run against the live terminal — so include what to verify in the \`task\`, exactly as you would for web.
+- **\`mainframe({ task, target?, appPath?, attachOnly?, nestStart?, nestEnd? })\`** — the SAME two-step shape for TN3270 terminals: it drives the screens (reading, sending text/AID keys, capturing each field by label + row/col), then you **poll \`mainframe_status({ sessionId })\`** every ~15–20 s until \`"done"\` — the same cadence as web, and HOLD that cadence. The 5–45 min figure is how long the RECORDING takes, NOT how long to wait between polls: a long quiet stretch is normal and is not a reason to slow the polling down, to assume it stalled, or to report elapsed time you have not actually observed (each poll returns the real elapsed seconds — read it, do not estimate).
+
+  **TWO ROUTES, and you MUST ASK THE USER which one FIRST — before any other work, and never pick for them.** Ask before you list test cases, before you read an existing one, and before you inspect the machine. Do NOT try to INFER the route: a running emulator does not mean the user wants the emulator route, an absent one does not rule it out (the direct route needs none), and the routes used by existing test cases in the project say nothing about the one they want now. Checking \`tasklist\` or the filesystem to decide this is always wrong — it answers a question nobody asked and biases you toward whatever happens to be installed. One question, then proceed. Whichever argument you pass selects the route, and a test case is TIED to the route it was recorded on, so this is not a detail you can decide later:
+  - **Direct (\`host\` + \`port\` + \`marker\`)** — dials the host over TN3270 with NO emulator. **ASK THE USER for all three, one question, before recording**: the hostname (\`zos.example.com\`), the port (\`1023\` on Marist, \`3270\` on a local Hercules — no safe default, so ask), and the marker: text that appears on the FIRST screen once the host is ready, e.g. \`z/OS\`. Pass the marker EXACTLY as the user gives it — matching is CASE-SENSITIVE, and no escaping or URL-encoding is needed, the tool assembles the target itself. Never invent a host and never reuse one from an earlier conversation.
+    ADVANCED, ask only if raised: \`ssl\` (default false, correct for plain TN3270) and \`dialect\` (\`zos\` default, \`tk4\` for MVS 3.8j under Hercules). \`target\` is the already-assembled form a SAVED test case carries — use it when replaying, not when recording something new.
+    No Windows requirement, no attachment limit, several recordings can run at once.
+  - **Emulator (\`appPath\`)** — launches a TN3270 emulator from its SESSION FILE and attaches over HLLAPI; step 1 records as "Launch \${app_path}". Omit \`appPath\` only to attach to an already-open emulator. The extension identifies the emulator: **\`.ecf\` = Quick3270, \`.ws\` = IBM Personal Communications, \`.rd3x\`/\`.rd5x\` = Micro Focus Reflection**. **If you do not know the path, ASK THE USER for it — do NOT go searching the filesystem**, and do NOT assume an extension (guessing \`.ws\` on a Quick3270 machine finds nothing and wastes the turn). This route needs the agent on **Windows with WINDOWS_MCP_ENABLED**, and emulator recordings **cannot overlap** (one HLLAPI session admits one attachment, so a second call is refused, not queued).
+
+  Mainframe DOES record assertions — \`mf_verify_screen\` / \`mf_verify_field\` run against the live terminal — so include what to verify in the \`task\`, exactly as you would for web.
 - **\`android({ task, packageName, deviceId?, activityName?, action?, nestStart?, nestEnd? })\`** — the SAME two-step shape for Android devices: it attaches to a real device over ADB (Appium + uiautomator2), launches \`packageName\`, drives the screens (reading UI snapshots, tapping, typing, scrolling, asserting), then you **poll \`android_status({ sessionId })\`** every ~15–20 s until \`"done"\` — the same cadence as web. The 5–15 min figure is the RECORDING duration, not a poll interval; expect many consecutive polls that still say \`"recording"\`, which is normal and not a stall. \`packageName\` is REQUIRED and is an exact package id (e.g. \`in.redbus.android\`) — **never ask the user for it and never guess it from the app's name** (redBus is \`in.redbus.android\`, Flipkart is \`com.flipkart.android\`; the mapping is not derivable). The user names the app the way a human does — *"record a redBus search"* — and YOU resolve it: call **\`android_devices\`** first, which lists every attached device and its installed apps as \`name — packageId\`, then pass that exact id. \`android_devices\` also shows which devices are BUSY, so you can avoid starting a recording that would be refused. **\`deviceId\` is the one to be careful with:** omit it and the agent auto-selects when EXACTLY ONE device is connected (it tells you which); with SEVERAL connected the call is REFUSED and lists the udids — **ASK THE USER which device to record on, never pick one yourself.** Recording on the wrong device does not fail, it silently produces a test case against the wrong handset. Two constraints worth stating up front: it needs a device visible to \`adb devices\` with USB debugging enabled; and one recording per device (a second call on the same udid is refused, though DIFFERENT devices record in parallel). Local devices only for now — LambdaTest cloud is not wired to this path yet.
+- **\`ios({ task, bundleId, deviceId?, projectId?, nestStart?, nestEnd? })\`** — the SAME two-step shape for iPhones and iPads: it drives a booted SIMULATOR or a REAL device through **WebDriverAgent** (Apple's XCUITest server) over HTTP, launches \`bundleId\`, drives the screens, then you **poll \`ios_status({ sessionId })\`** every ~15–20 s until \`"done"\`. \`bundleId\` is REQUIRED and is an exact bundle id (\`com.apple.Preferences\`, not "Settings") — **never guess it from the display name** (Photos is \`com.apple.mobileslideshow\`) and **never ask the user for it**. Instead call **\`ios_devices\`**, which lists every installed app as \`Display Name — bundleId\`, and resolve it yourself: the user says *"record a Settings flow"* and YOU find the id — exactly the same division of labour as \`android_devices\`. One difference from android worth knowing: on iOS you match the user's word against the **display name**, because it is read from the app bundle and is the real home-screen string, whereas android's name column is a derived placeholder and must be matched against the package id instead. If nothing matches or several do, show the candidates and ask. \`deviceId\` behaves exactly as android's: omit it with exactly one device available, and with SEVERAL the call is REFUSED and lists them — **ask which one, never pick.** Three things that differ from android and are worth saying up front: **a real device does NOT need a macOS agent** — go-ios drives pairing, the developer image and WebDriverAgent from Windows and Linux too, and only a **SIMULATOR** requires macOS (xcodebuild + simctl), so on a non-Mac host pass a real device udid; a **real device additionally needs WDA signed and installed**, which is what \`projectId\` enables (a simulator needs no signing, so omit it there); and **bring-up is slower** than android on a real device — signing, install and tunnel — so several early polls still reading \`"recording"\` are expected, not a stall. One recording per device, as on android; DIFFERENT devices record in parallel.
 - **\`db({ task })\`** — same shape for its technology; declared but not built yet (it replies "not available yet").
 - Write ONE self-contained \`task\`: include the URL, the REAL values (passwords too — sensitive fields are parameterized to \`\${...}\` automatically), and the assertion. If a step needs a human (OTP / CAPTCHA / first login), say so in the task so the sub-agent pauses for it.
 
+## Create on SimplifyQA — granular verbs (ONLY when provider is simplifyqa)
+
+The SimplifyQA local agent does NOT expose \`web\` / \`mainframe\` / \`android\` / \`ios\` / \`db\` as bundled sub-agents. Do NOT call them on SimplifyQA — they will error with "unknown tool". YOU (the LLM) orchestrate the granular verbs directly.
+
+**Record a NEW test case from scratch — the DIRECT flow (works for every technology).**
+
+**NO PRE-FLIGHT.** Do NOT create a draft. Do NOT open anything. Do NOT call any \`tc_*\` tool before \`core_activate_technology\`. The recording session IS the entry point — \`core_activate_technology\` launches the recorder and creates the test case shell itself. The user's Save Testcase click in the recorder UI is what persists it. Skipping straight to step 3 below is CORRECT — anything you do before it is wrong and wastes turns.
+
+Common shape for ALL technologies (WEB / MAINFRAME / ANDROID / IOS):
+
+1. **\`qa_connection_status\`** — verify connected + note the projectId. If disconnected, \`qa_connect\` first.
+2. **Ask the technology-specific setup questions BEFORE \`core_activate_technology\`** (see per-tech blocks below — mainframe needs a route + \`app_path\`; android/ios need a \`deviceId\` when more than one is present).
+3. **\`core_activate_technology({ technology: "<WEB|MAINFRAME|ANDROID|IOS>", testcaseName, ...tech-specific args })\`** — ONCE, at the start. Launches the recorder session and opens the SimplifyQA recorder UI. The response's \`structuredContent.sessionId\` is the recording session id.
+4. **\`<tech>_launch_application({ ... })\`** — ALWAYS the FIRST action call after activation. NO \`<tech>_snapshot\` / verify / save before it.
+5. **\`<tech>_snapshot()\`** to get element refs (\`e1\`, \`e2\`, …) — only where the technology HAS a snapshot (web / android / ios do; mainframe does NOT). Re-snapshot only when the page/screen changed or a ref is stale; reuse refs while it's the same. Pass a ref to the action verb — NEVER a raw locator.
+6. Per user intent: pick the target ref (or field label on mainframe), call exactly ONE action verb, narrate one line.
+7. On error inside recording: ONE fresh \`<tech>_snapshot\` + retry once (skip the snapshot on mainframe), then STOP and report the failing step.
+8. When the flow is done: **\`core_close_session()\`** — tears down the browser / emulator / device attachment.
+9. STOP. Report the recording session id. Tell the user to review the captured steps in the SimplifyQA recorder UI and click **Save Testcase** — the recorder UI creates the new automated test case in the backend. **Do NOT call \`tc_save\` / \`tc_draft_create\` / \`update_testcase\` / \`journal_modify\` on this path** — those persist through common-mcp's DraftStore, but a \`core_activate_technology\` recording lives in the recorder UI's own store and is persisted by its Save button.
+
+### WEB
+- \`core_activate_technology({ technology: "WEB", testcaseName })\` → \`web_launch_application({ url })\` → \`web_snapshot\` + \`web_click\` / \`web_enter_text\` / \`web_select_item_from_dropdown\` / \`web_validate_text\` / \`web_keyboard_action\` / …
+- Tabs & iframes (the snapshot only sees the CURRENT tab + frame — switching is an explicit step): \`web_switch_to_tab({ tab: "1" })\` + \`web_snapshot\`; \`web_switch_to_parent_tab\`; \`web_close_tab({ tab: … })\`. Iframes: \`web_switch_to_iframe({ ref: <iframe's ref> })\` + \`web_snapshot\`; \`web_switch_to_parent_iframe\`; \`web_switch_to_default_content\` back to the page.
+
+### MAINFRAME
+- ASK the ROUTE first (never pick for the user, never infer from filesystem/tasklist). Whichever argument you pass selects the route, and a test case is TIED to it:
+  - **Emulator route** — pass \`app_path\` (the TN3270 emulator SESSION FILE: \`.ecf\` = Quick3270, \`.ws\` = IBM Personal Communications, \`.rd3x\`/\`.rd5x\` = Micro Focus Reflection). ASK the user for the path — do NOT search the filesystem. Windows-only, and only ONE mainframe recording can run at a time (HLLAPI attachment is exclusive).
+  - **Direct route** — pass \`host\` + \`port\` + \`marker\` (marker is text on the first screen once ready, e.g. \`z/OS\`; case-sensitive; no escaping). Works on any OS, no attachment limit, several recordings in parallel. Advanced (ask only if raised): \`ssl\` (default false), \`dialect\` (\`zos\` default, \`tk4\` for MVS 3.8j under Hercules).
+- \`core_activate_technology({ technology: "MAINFRAME", testcaseName, app_path? OR host? + port? + marker? })\` → \`mainframe_launch_application\` is the FIRST step.
+- **NO snapshot** — mainframe targets fields by \`{ by: "label" | "position", target: "..." }\`. Use \`mainframe_enter_text\` / \`mainframe_validate_text\` (only when the user asked to verify).
+- AID keys (Enter / PF3 / PA1 / …): \`mainframe_keyboard_action({ keys: "ENTER" | "PF3" | … })\`.
+- A failed step ENDS the session — stop and report; there is no "retry after snapshot" here.
+
+### ANDROID
+- **\`android_list_devices\` FIRST** — never guess a device. Lists every attached device (udid + name + which are BUSY) and the app packages installed on each. The user names the app humanly ("record a redBus search"); YOU resolve to the exact package id (\`in.redbus.android\`) — the mapping is not derivable from the display name, and the user does not know the package id either.
+- \`deviceId\`: omit ONLY when exactly one device is connected (auto-selected, reported back). With SEVERAL connected the call is REFUSED and udids are listed — **ASK the user which device**, never pick. Recording on the wrong device silently produces a test case against the wrong handset.
+- \`core_activate_technology({ technology: "ANDROID", testcaseName, deviceId })\` → \`android_launch_app({ package, activity? })\` is the FIRST step → \`android_snapshot\` returns refs (\`e1\`, \`e2\`, … tagged with locator quality: \`id|desc|text|bounds|xpath\`) → \`android_click\` / \`android_enter_text\` / \`android_validate_text\` / … (ref-based verbs target by ref; positional verbs like the web ones).
+- Do NOT add \`generic_wait\` / pause steps during ANDROID recording — android verbs already wait for the UI to settle. Add a wait ONLY if the user explicitly asks for one.
+- Local devices only for now (USB debugging enabled, visible to \`adb devices\`); LambdaTest cloud is not wired to this path yet. One recording per device (different devices in parallel).
+
+### iOS
+- Same division of labour as ANDROID but for iPhones / iPads via WebDriverAgent (XCUITest):
+- **\`ios_list_devices\` FIRST** — lists every device + installed app (\`Display Name — bundleId\`). Match the user's word against the **display name** (that's the real home-screen string; the bundleId is not derivable from it — Photos is \`com.apple.mobileslideshow\`).
+- \`deviceId\`: same rules as android — omit with one device, ask with several.
+- \`core_activate_technology({ technology: "IOS", testcaseName, bundleId, deviceId })\` → \`ios_launch_app\` is the FIRST step → \`ios_snapshot\` + \`ios_click\` / \`ios_enter_text\` / \`ios_validate_text\` / … (same shape as android).
+- Real device does NOT need a macOS host (go-ios drives it from Windows/Linux); only a SIMULATOR requires macOS. A real device additionally needs WDA signed and installed (that's what \`projectId\` is for on ios; simulator has no signing so omit it). Bring-up is slower than android on a real device — expect several early polls still reading "recording", not a stall. One recording per device.
+
+### Automate an EXISTING manual test case (any technology)
+Use **\`tc_automate({ tcId, url, extra? })\`** first — it returns a recording guide built from the manual steps (with \`testcaseName\` + numeric \`userstoryId\` / \`moduleId\` already derived); ASK the user for URL / credentials / assertions and pass as \`url\` + \`extra\`. Then run the same technology-appropriate chain above. Same save story — the recorder UI's **Save Testcase** button creates the new automated TC (the source manual TC stays untouched).
+
+### Rules while recording on SimplifyQA (all technologies)
+- Record ONLY what the user asked for. Do NOT add extra verify/validate steps unless the user says "verify" / "assert" / "check".
+- For a randomized value (e.g. random Indian name), use \`generic_generate_random_alphanumeric({ count, store_as: "<name>" })\` then reference it via \`from_runtime: "<name>"\` in the enter/select verb — NEVER pass \`\${name}\` as a literal.
+- Never record a rejected step (intent count == recorded-step count). Always supply \`object_name\` / \`parameter_name\` / \`step_description\`.
+- Control flow: \`core_if\` / \`core_else_if\` / \`core_else\` / \`core_end_if\` for conditionals; \`core_loop { count: N }\` / \`core_end_loop\` for repetition; \`core_reuse_function { function: "FN-12", params: {...} }\` to reuse a saved function (records ONE function step; then re-snapshot). Balance EVERY \`core_if\` with \`core_end_if\` and EVERY \`core_loop\` with \`core_end_loop\`.
+- After the last step, STOP, report the recording session id, and confirm before \`core_close_session()\`.
+
+## Author backlog from a BRD / context — TOP-DOWN, ASK EACH RUNG
+When the user hands you a BRD, spec, or free-form context and asks to **generate stories** (or "create user stories from this", "break this down into stories", "generate the backlog"), you are AUTHORING the backlog top-down: **epic → feature → story**. Do NOT create orphan stories. Walk these questions IN ORDER, ASK each and WAIT for the answer before moving on — never assume, never skip:
+1. **Epic** — ASK: "Which epic should this go under?" Then either (a) if the user names one, resolve the id via \`epic_list({ search })\` and confirm; or (b) if it's new, offer to \`epic_create\` (draft the epic first, get \`{ savedRef.id }\`, then move on). Only skip when the user EXPLICITLY says "no epic" / "standalone".
+2. **Feature(s)** — ASK: "Which feature(s) should the stories live under?" — grouping matters. From a BRD, propose the split up front ("I see 3 features: X, Y, Z — should I create these under epic <name>?"), resolve names via \`feature_list({ epicId })\`, or \`feature_create\` new ones under the chosen epic. Do NOT scatter stories across features without confirmation.
+3. **Stories** — only NOW call \`story_create\` per story, passing both \`epicId\` and \`featureId\` from steps 1–2. When creating MULTIPLE stories from one BRD, group them under the SAME parent unless the BRD clearly splits them across features (in which case name the split and ask before creating).
+
+The three questions are NOT optional and NOT batch-mergeable ("here's an epic + features + stories, save all?" — no). Ask, wait, resolve, then descend. On re-runs in the same session, the previously-chosen epic/feature persist — reuse them silently unless the user says "different epic".
+
 ## Stories → manual test cases → automate
 Pull up user stories, draft MANUAL test cases for them, and later promote those to automated.
 - **Backlog hierarchy: epic → feature → story.** Use **\`epic_list\` / \`epic_get\` / \`epic_create\` / \`epic_update\`** for the top rung (EP_XXX), **\`feature_list\` / \`feature_get\` / \`feature_create\` / \`feature_update\`** for the middle (FT_XXX, links up via \`epicId\`), and **\`story_create\` / \`story_update\`** for stories (US_XXX, links up via \`epicId\` + \`featureId\`). All four LIST tools accept the same \`createdBy\` / \`updatedBy\` / \`ownerId\` filters (numeric userId or \`"me"\`; resolve names via \`list_users\` first). Create/update require \`state\` — it must match the project's state config; call \`epic_get\` / \`feature_get\` / \`story_get\` on an existing item to see valid values. Updates take an \`updateVersion\` from the last read (optimistic concurrency) — omit it only for blind writes.
@@ -94,14 +189,16 @@ Pull up user stories, draft MANUAL test cases for them, and later promote those
 
 ## Run — execute & triage
 Runs are AUTOMATED-only — a MANUAL test case can't be run or scheduled by an agent (the backend refuses it). **NEVER assume anything** — walk the user through these IN ORDER, asking each and WAITING for the answer before the next (this mirrors the product UI exactly):
-1. **Local or cloud?** — ASK; never guess.
+1. **Local, remote, or cloud?** — ASK; never guess. **local** = THIS machine's desktop agent; **remote** = ANOTHER registered machine (a teammate's box) via the SimplifyQA queue; **cloud** = a SimplifyQA cloud runner VM.
 2. **Now or scheduled?** — ASK; never guess.
 3. **If scheduled** — BEFORE offering any agent, ASK the START time (\`scheduledFor\`, ISO), the RECURRENCE (\`scheduleType\`: once / hourly / daily / weekdays / weekly / monthly — default once; hourly/daily/weekdays need an \`endDate\`) and the TIMEZONE.
-4. **Browser?** — OFFER a choice for EVERY run (test case OR suite, local OR cloud, now OR scheduled): **chromium** (default), **chrome**, **msedge**, **firefox**, **webkit** → pass as \`browser\`. A SCHEDULE accepts only chromium / msedge / firefox / webkit (NOT chrome). If the user has no preference, default chromium — but always let them choose.
+4. **Browser?** — OFFER a choice for EVERY run (test case OR suite, any mode, now OR scheduled): **chromium** (default), **chrome**, **msedge**, **firefox**, **webkit** → pass as \`browser\`. A SCHEDULE accepts only chromium / msedge / firefox / webkit (NOT chrome). If the user has no preference, default chromium — but always let them choose.
 5. **THEN offer the agent/runner** — the AVAILABLE list depends on where AND when:
-   - **local + now** → call **\`local_agents\`** and offer ONLY the **ONLINE** agents (a run-now can't target an offline agent). Pass the chosen one as **\`agentId\`** (or omit to auto-pick the user's own online agent).
-   - **local + scheduled** → call **\`local_agents\`** and offer **ALL** agents — **ONLINE and OFFLINE** (a schedule can target an agent that's offline now; it runs when it fires). **\`agentId\` is REQUIRED** here — a schedule has no live session to fall back to.
-   - **cloud (now OR scheduled)** → call **\`cloud_runners\`** and offer ONLY the **ONLINE** runners; if none are online, say *"there are no active cloud runners in your project"* and STOP (never silently fall back to local). Pass the chosen one as **\`cloudRunnerId\`** (for a schedule, omit it to let the backend auto-pick a live VM at fire time).
+   - **local + now** → call **\`local_agents\`** (0 or 1 row per box: this machine's own agent). If empty, tell the user to start the SimplifyQA desktop agent, or switch to \`remote\` / \`cloud\`. Otherwise pass \`agentId\` (or omit to auto-pick this machine's agent). \`tc_run\` also probes the desktop agent (:4040) and refuses cleanly if it's not up — you don't have to check yourself.
+   - **local + scheduled** → same as above, but **\`agentId\` is REQUIRED** (a schedule has no live session to fall back to).
+   - **remote + now** → call **\`remote_agents\`** and offer ONLY the **ONLINE** rows (a run-now can't target an offline remote agent). **\`agentId\` is REQUIRED** (no auto-pick across teammate boxes).
+   - **remote + scheduled** → call **\`remote_agents\`** and offer **ALL** rows (a schedule can target an offline agent; it runs when it fires). **\`agentId\` is REQUIRED**.
+   - **cloud (now OR scheduled)** → call **\`cloud_runners\`** and offer ONLY the **ONLINE** runners; if none are online, say *"there are no active cloud runners in your project"* and STOP (never silently fall back to local/remote). Pass the chosen one as **\`cloudRunnerId\`** (for a schedule, omit it to let the backend auto-pick a live VM at fire time).
    - Agents/runners read as **owner · hostname** (e.g. *rishi · SIMLAP24*) — present them that way so the user recognizes their machine; the credential id is only for the tool call.
 6. **Execute:**
    - **now** → **\`tc_run({ tcId, mode, when: "immediate", browser?, agentId? | cloudRunnerId? })\`** → a run id; then **poll \`run_status\`** until terminal (passed / failed / stopped / error). Don't call a still-\`queued\`/\`running\` run a result; if it stayed \`queued\` and never started, the agent likely didn't pick it up — say that, not "pass". **\`run_stop\`** cancels a run.
@@ -119,6 +216,7 @@ Edit an EXISTING test case's steps from here — no re-recording needed for stru
 - Loop / if-else / nested / remove / move / edit-existing all persist cleanly. Adding a brand-new INTERACTION step (click/type a NEW element) has no captured locator → it's a manual, non-executable step; to add a real interaction, RECORD it instead.
 
 ## Always
+- **NEVER call an MCP endpoint directly with \`curl\` / \`Invoke-RestMethod\` / raw JSON-RPC. NEVER shell out to work around a failing tool.** If a tool errors ("unknown tool", "not connected", "tool not found", etc.) REPORT the error and STOP. Do not synthesize a workaround, do not curl \`127.0.0.1:4040/mcp\`, do not probe the agent by hand — the user will fix the config. You have MCP tools, and only MCP tools.
 - **NEVER save on your own — \`tc_save\` is an EXPLICIT user action ONLY.** A test case (recorded draft OR manual draft) is persisted only when the user EXPLICITLY says so (e.g. "save this test case", "save it", "persist it", "okay save"). **An instruction to RECORD / CREATE / AUTOMATE a test case is an instruction to produce the DRAFT — NOT to save it; recording/drafting and saving are SEPARATE steps.** After a recording finishes or a draft is authored, STOP at the draft, show it, and ask — do not chain into \`tc_save\`. Finishing a recording, or the user approving the CONTENT ("looks good", "nice", "correct"), is NOT a save instruction — if unsure whether a reply meant save, ASK rather than saving. The user may instead save it themselves in the Walnut UI; then do NOT also \`tc_save\` (it would duplicate).
 - One door: you call the lifecycle tools + the technology sub-agents; the product and which technology are resolved downstream. Delegate with a complete, self-contained task. Never fabricate — read every result from the tools. Show steps in plain language, not code.`,
 };
@@ -154,13 +252,11 @@ function fileFor(loop, a, mcp) {
                 path: `.github/agents/${a.slug}.agent.md`,
                 content: `---\nname: ${a.slug}\ndescription: ${a.description}\ntools: ['${mcp}/*']\n---\n\n${a.body}${toolsNote(a)}`,
             };
-        case 'devin': // Devin custom SUBAGENT — .devin/agents/<name>.md. Devin imports Claude Code's agent
-            // format, so this mirrors the claude case: a SCOPED mcp__<server>__* allowlist (every common-qa-mcp
-            // tool, none drop; the editor's own tools stay out) + the persona body.
-            return {
-                path: `.devin/agents/${a.slug}.md`,
-                content: `---\nname: ${a.slug}\ndescription: ${a.description}\ntools:\n  - mcp__${mcp}__*\n---\n\n${a.body}${toolsNote(a)}`,
-            };
+        case 'devin': // ponytail: unreachable — the `devin` loop is routed to the AGENTS.md writer above
+            // (same as codex). Devin Desktop reads AGENTS.md every turn (always active); a `.devin/agents/`
+            // subagent file only loads when the top-level agent delegates or the user names it, so the
+            // persona was silently ignored in normal chat. Kept for exhaustive switch typing.
+            throw new Error('devin is routed through the AGENTS.md writer; fileFor should not be called');
     }
 }
 function parseLoop(args) {
@@ -202,15 +298,24 @@ export async function runInitAgents(args) {
     const loops = loopArg === 'all' ? [...ALL_LOOPS] : [loopArg];
     const cwd = process.cwd();
     // MCP server NAME for the scoped tool-wildcards. Each editor stores its MCP config in a different
-    // file/format (Claude .mcp.json, Cursor .cursor/mcp.json, Devin .devin/mcp_config.json, VS Code
-    // .vscode/mcp.json `servers`, Codex .codex/config.toml), so there's no single file to auto-detect
+    // file/format (Claude .mcp.json, Cursor .cursor/mcp.json, Devin Desktop .mcp.json at repo root,
+    // VS Code .vscode/mcp.json `servers`, Codex .codex/config.toml), so there's no single file to auto-detect
     // from — the name comes from an explicit --server-name flag, else the package-name default. Name the
     // server this in each editor's config (or pass --server-name) so the wildcard resolves. Logged below.
     const serverName = parseServerName(args) ?? DEFAULT_MCP;
     process.stderr.write(`init-agents: scoping tool wildcards to MCP server "${serverName}" (override with --server-name)\n`);
+    // Both Codex and Devin Desktop read AGENTS.md at repo root as always-active guidance every turn,
+    // so we deduplicate: the FIRST of the two to be processed writes AGENTS.md, subsequent ones skip.
+    let agentsMdWritten = false;
     for (const loop of loops) {
-        if (loop === 'codex') {
-            // Codex / generic AGENTS.md — one repo-wide file holding the single Common QA agent.
+        if (loop === 'codex' || loop === 'devin') {
+            // AGENTS.md — one repo-wide file holding the single Common QA agent. Codex reads it natively;
+            // Devin Desktop reads it every turn (a `.devin/agents/` subagent profile only loads on explicit
+            // delegation, so persona instructions there are silently ignored in normal chat).
+            if (agentsMdWritten) {
+                process.stderr.write(`init-agents [${loop}]: AGENTS.md already written this run — skipping.\n`);
+                continue;
+            }
             const rel = 'AGENTS.md';
             const body = '# Common QA agent (common-qa-mcp)\n\nOne agent drives the Common QA MCP — the whole test-case lifecycle.\n\n' +
                 AGENTS.map((a) => `---\n\n## ${a.slug}\n\n${a.description}\n\n${a.body}${toolsNote(a)}`).join('\n');
@@ -220,11 +325,12 @@ export async function runInitAgents(args) {
             // carries it (in the tool allowlists), so re-running converges on a single clean file.
             if (existsSync(target) && !readFileSync(target, 'utf8').includes('common-qa-mcp')) {
                 target = join(cwd, 'common-qa-mcp.AGENTS.md');
-                process.stderr.write('init-agents [codex]: a foreign AGENTS.md exists — writing common-qa-mcp.AGENTS.md instead; merge it in.\n');
+                process.stderr.write(`init-agents [${loop}]: a foreign AGENTS.md exists — writing common-qa-mcp.AGENTS.md instead; merge it in.\n`);
             }
             mkdirSync(dirname(target), { recursive: true });
             writeFileSync(target, body, 'utf8');
-            process.stderr.write(`init-agents [codex]: wrote ${target}\n`);
+            process.stderr.write(`init-agents [${loop}]: wrote ${target}\n`);
+            agentsMdWritten = true;
             continue;
         }
         for (const a of AGENTS) {
@@ -233,7 +339,7 @@ export async function runInitAgents(args) {
         }
     }
     process.stderr.write('\nInstalled the Common QA agent. Ensure the "common-qa-mcp" MCP server is configured in this ' +
-        'client (command: npx, args: ["-y","common-qa-mcp"], env: QA_MCP_TOKEN / QA_MCP_URL / QA_MCP_PRODUCT), ' +
+        'client (command: npx, args: ["-y","common-qa-mcp"], env: QA_MCP_TOKEN / QA_MCP_URL / QA_MCP_PROVIDER), ' +
         'reload the client so it picks up the agent, then start a QA task.\n');
 }
 //# sourceMappingURL=initAgents.js.map

package/dist/initAgents.js.map

@@ -1 +1 @@
-{"version":3,"file":"initAgents.js","sourceRoot":"","sources":["../src/initAgents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"initAgents.js","sourceRoot":"","sources":["../src/initAgents.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAc/C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC;kEAC8D;IAC9D,UAAU,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACnF,CAAC;AAIF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CA0HvD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgB/C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC;kEAC8D;IAC9D,UAAU,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACnF,CAAC;AAoFF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAgJvD"}

package/dist/server.js

@@ -13,11 +13,95 @@ import { registerDefectTools } from './tools/defects.tools.js';
 import { registerTaskTools } from './tools/tasks.tools.js';
 import { registerRecordingPassthrough } from './tools/recording.tools.js';
 import { registerHealTools } from './tools/heal.tools.js';
+import { registerGapAnalysisTools } from './tools/gapAnalysis.tools.js';
+import { registerImpactAnalysisTools } from './tools/impactAnalysis.tools.js';
 import { ok, err } from './mcpResult.js';
 export { ok, err };
 const OFFLINE_TOOLS = ['actions_catalog', 'tc_draft_create', 'tc_draft_update', 'tc_draft_get', 'tc_draft_discard', 'tc_draft_open'];
+/**
+ * MCP `initialize.instructions` — surfaced by every compliant client (Claude, VS Code, Cursor,
+ * Windsurf, Devin) into its LLM system prompt. Load-bearing for weaker orchestrators (Devin) that
+ * would otherwise freelance with shell/curl when a tool errors. Stays short — it complements, not
+ * replaces, per-tool descriptions (which the LLM also reads).
+ *
+ * Provider-aware: SimplifyQA record-from-scratch uses granular verbs orchestrated on the client
+ * (core_activate_technology → web_launch_application → web_snapshot + verbs → core_close_session),
+ * driven from `tc_record_append` which itself returns the numbered guide at call time. Walnut uses
+ * the bundled `web` sub-agent (single call, poll status). Unknown/offline gets a discovery hint.
+ */
+function recordingInstructionsFor(provider) {
+    const common = [
+        'You are driving the Common QA MCP (common-qa-mcp), which fronts a QA product (Walnut or SimplifyQA).',
+        '',
+        'GROUND RULES (all providers, always):',
+        '- FIRST turn: call `qa_connection_status` to see what is connected and which project is active.',
+        '  If not connected, call `qa_connect({ url, token, projectId })`.',
+        '- Project is NEVER assumed. If none is active, call `list_projects` and ASK the user which one, then `qa_switch_project`.',
+        '- NEVER save without an EXPLICIT user instruction ("save it" / "persist it"). A finished recording is a DRAFT — stop and show it. "Looks good" is approval of content, NOT permission to save.',
+        '- NEVER call an MCP endpoint directly with curl / Invoke-RestMethod / raw JSON-RPC. NEVER shell out to work around a failing tool. If a tool errors or is missing, REPORT the error and STOP — do not synthesize a workaround.',
+        '- Follow each tool\'s own description — many tools RETURN a numbered guide in their response (notably `tc_record_append`). Do exactly what the returned guide says.',
+        '',
+    ].join('\n');
+    if (provider === 'simplifyqa') {
+        return common + [
+            'RECORDING ON SIMPLIFYQA — THE DIRECT FLOW (all technologies: WEB / MAINFRAME / ANDROID / IOS):',
+            'The SimplifyQA local agent does NOT expose bundled `web` / `mainframe` / `android` / `ios` / `db` sub-agent tools — calling them errors with "unknown tool". Recording is orchestrated by YOU (the LLM) through granular verbs.',
+            '',
+            'NO PRE-FLIGHT. Do NOT create a draft. Do NOT open anything. Do NOT call any `tc_*` tool before `core_activate_technology`. The recording session IS the entry point — `core_activate_technology` launches the recorder and creates the test-case shell itself. Save happens when the user clicks Save Testcase in the SimplifyQA recorder UI.',
+            '',
+            'Common shape for every technology:',
+            '  1. `qa_connection_status` — verify connected + note the projectId.',
+            '  2. Ask the tech-specific setup questions BEFORE activation (mainframe needs route + `app_path`; android/ios need `deviceId` when >1 device).',
+            '  3. `core_activate_technology({ technology: "<WEB|MAINFRAME|ANDROID|IOS>", testcaseName, ...tech args })` — ONCE, at start. response.structuredContent.sessionId is the recording id.',
+            '  4. `<tech>_launch_application({ ... })` — ALWAYS the FIRST action call. No snapshot / verify / save before it.',
+            '  5. `<tech>_snapshot()` to get element refs (web/android/ios only; mainframe has no snapshot). Reuse refs while the page/screen is unchanged. Pass a ref to the action verb — NEVER a raw locator.',
+            '  6. Per user intent: one snapshot ref + exactly ONE action verb + one narration line.',
+            '  7. On error inside recording: ONE fresh `<tech>_snapshot` + retry once (skip on mainframe), then STOP and report.',
+            '  8. `core_close_session()` when the flow is done.',
+            '  9. STOP. Report the recording session id. Tell the user to review captured steps in the SimplifyQA recorder UI and click Save Testcase — the recorder UI persists it. Do NOT call `tc_save` / `tc_draft_create` / `update_testcase` / `journal_modify` on this path.',
+            '',
+            'WEB: `core_activate_technology({ technology: "WEB", testcaseName })` → `web_launch_application({ url })` → `web_snapshot` + `web_click` / `web_enter_text` / `web_select_item_from_dropdown` / `web_validate_text` / `web_keyboard_action`. Tabs: `web_switch_to_tab` / `web_switch_to_parent_tab` / `web_close_tab`. Iframes: `web_switch_to_iframe({ ref })` / `web_switch_to_parent_iframe` / `web_switch_to_default_content`.',
+            '',
+            'MAINFRAME: ASK the ROUTE first (never pick / never infer). Emulator route: `app_path` (Windows-only, one recording at a time). Direct route: `host` + `port` + `marker` (any OS, several in parallel). `core_activate_technology({ technology: "MAINFRAME", testcaseName, app_path? OR host? + port? + marker? })` → `mainframe_launch_application` is FIRST. NO snapshot — target fields by `{ by: "label" | "position", target }`. AID keys: `mainframe_keyboard_action({ keys: "ENTER" | "PF3" })`. A failed step ends the session.',
+            '',
+            'ANDROID: `android_list_devices` FIRST (never guess a device or a package id). Resolve the app the user names to its exact `package` from that list. `deviceId`: omit only with exactly one device; ASK with several. `core_activate_technology({ technology: "ANDROID", testcaseName, deviceId })` → `android_launch_app({ package, activity? })` is FIRST → `android_snapshot` returns refs (`e1`, `e2`, … tagged `id|desc|text|bounds|xpath`) → `android_click` / `android_enter_text` / `android_validate_text`. Do NOT add generic_wait pauses on android — the verbs already wait.',
+            '',
+            'IOS: `ios_list_devices` FIRST — match user\'s app word against the DISPLAY NAME (bundleId is opaque). `deviceId` rules match android. `core_activate_technology({ technology: "IOS", testcaseName, bundleId, deviceId })` → `ios_launch_app` is FIRST → `ios_snapshot` + `ios_click` / `ios_enter_text` / `ios_validate_text`. Real device does NOT need macOS (go-ios drives it); simulator does. `projectId` is for WDA signing on real devices only.',
+            '',
+            'Automate an EXISTING manual test case (any tech): `tc_automate({ tcId, url, extra? })` first — returns a guide built from the manual steps (with testcaseName + userstoryId/moduleId already derived). Then run the same common-shape steps. Save is still via the recorder UI\'s Save Testcase button; do NOT call `tc_save`.',
+            '',
+            'Rules while recording (all technologies):',
+            '- Record ONLY what the user asked for. Do NOT add extra verify/validate steps unless the user says "verify" / "assert" / "check".',
+            '- For a randomized value (e.g. random Indian name), use `generic_generate_random_alphanumeric({ count, store_as: "<name>" })` and reference later via `from_runtime: "<name>"` in the enter/select verb — NEVER pass `${name}` as a literal.',
+            '- Control flow: `core_if` / `core_else_if` / `core_else` / `core_end_if`; `core_loop({ count })` / `core_end_loop`; `core_reuse_function({ function, params })` to reuse a saved function. Balance every open with its close.',
+            '- Never record a rejected step (intent count == recorded-step count). Always supply object_name / parameter_name / step_description.',
+        ].join('\n');
+    }
+    if (provider === 'walnut') {
+        return common + [
+            'RECORDING A WEB TEST CASE (Walnut):',
+            'Walnut exposes bundled technology SUB-AGENT tools — one call starts a real browser recording driven by the agent\'s own LLM loop.',
+            '  1. `qa_technology_status` — confirm `web` is available.',
+            '  2. ASK the user about REUSE first: an existing Login as `nestStart`, Logout as `nestEnd`? Find ids via `tc_list`.',
+            '  3. `web({ task, url, nestStart?, nestEnd? })` — `task` is the complete goal ("Sign in at <url> as X/Y, then verify Z"). Returns immediately with `{ sessionId, status: "recording" }`. Call ONCE — do NOT retry it.',
+            '  4. POLL `web_status({ sessionId })` every ~15-20 seconds until `status: "done"`. It returns `{ draftId, tc, stepCount }`.',
+            '  5. Show the draft in plain language. Wait for an EXPLICIT save instruction, then `tc_save({ draftId })`.',
+            '',
+            'Mainframe / Android / iOS follow the same START → POLL `<tech>_status` → save shape; each has route/device questions to ask the user FIRST (see per-tool descriptions).',
+        ].join('\n');
+    }
+    return common + [
+        'RECORDING: provider is not yet resolved. Call `qa_connection_status` first — the response names the product, and the per-tool descriptions from `tools/list` will guide the flow (SimplifyQA uses granular verbs orchestrated via `tc_record_append`; Walnut uses the bundled `web` sub-agent).',
+    ].join('\n');
+}
 export function buildServer(deps) {
-    const server = new McpServer({ name: 'common-qa-mcp', version: '0.5.0' });
+    // Provider known at boot from the live connection, or env when standalone (no mount.ts wrap).
+    // Unknown = offline / no config yet — the instructions still steer the LLM to discover via
+    // `qa_connection_status` before recording.
+    const envProvider = (process.env['QA_MCP_PROVIDER'] ?? '').toLowerCase();
+    const provider = deps.connection?.config().provider
+        ?? (envProvider === 'simplifyqa' || envProvider === 'walnut' ? envProvider : 'unknown');
+    const server = new McpServer({ name: 'common-qa-mcp', version: '0.7.0' }, { instructions: recordingInstructionsFor(provider) });
     const drafts = deps.drafts ?? new DraftStore();
     server.registerTool('project_info', {
         description: 'Validate the configured connection and return provider, org/project and entity counts.',
@@ -106,6 +190,16 @@ export function buildServer(deps) {
     registerHealTools(server, {
         getAdapter: () => (deps.connection ? deps.connection.adapter() : deps.adapter),
     });
+    // Coverage / gap aggregator across a scope (sprint / release / epic / feature / stories / project).
+    // Read-only; reuses computeDrift from storySync + the existing listStories/getStory/listTestCases reads.
+    registerGapAnalysisTools(server, {
+        getAdapter: () => (deps.connection ? deps.connection.adapter() : deps.adapter),
+    });
+    // Blast-radius report from one anchor (defect / testcase / story / sprint / release). Read-only;
+    // walks the graph via existing adapter reads and reuses gap_analysis's per-story analyser.
+    registerImpactAnalysisTools(server, {
+        getAdapter: () => (deps.connection ? deps.connection.adapter() : deps.adapter),
+    });
     // Recording passthrough: mirror the product agent's browser-recording tools onto this server so
     // the client records through the one door. Agent-bound + forwarded (see recording.tools.ts).
     // Async + fire-and-forget: it waits for the connection, then registerTool emits list_changed.

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/backlog.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backlog.tools.d.ts","sourceRoot":"","sources":["../../src/tools/backlog.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;CAC1C,CAAC;AAyCF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CA8hBpF"}
+{"version":3,"file":"backlog.tools.d.ts","sourceRoot":"","sources":["../../src/tools/backlog.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;CAC1C,CAAC;AAyCF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CA4jBpF"}

package/dist/tools/backlog.tools.js

@@ -286,6 +286,8 @@ export function registerBacklogTools(server, deps) {
             projectIds: z.array(z.number()).optional(),
             epicId: z.number().optional().describe('Parent epic numeric id. RESOLVE VIA `epic_list` OR ASK THE USER before creating — do not ' +
                 'leave a feature parent-less unless the user explicitly says "no epic".'),
+            orphan: z.boolean().optional().describe('Set true ONLY if the user has explicitly said the feature has no parent epic ("standalone", ' +
+                '"no epic"). Required when `epicId` is omitted — the tool refuses otherwise.'),
             state: z.string().optional().describe('Optional. Defaults to the project-configured default feature state when omitted.'),
             priority: z.string().optional().describe('Optional. Defaults to the project-configured default feature priority when omitted.'),
             ownerId: z.number().optional(),
@@ -324,8 +326,15 @@ export function registerBacklogTools(server, deps) {
             return err(NOT_CONNECTED);
         if (!adapter.createFeature)
             return err('This product does not expose feature creation.');
+        if (input.epicId == null && input.orphan !== true) {
+            return err('HIERARCHY REQUIRED: no `epicId` provided. Before creating, ASK the user which epic this ' +
+                'feature belongs to — offer (a) create a new epic first via `epic_create`, or (b) pick an ' +
+                'existing one (list by name via `epic_list`). Only re-call with `orphan: true` if the user ' +
+                'explicitly says "no epic" / "standalone".');
+        }
         try {
-            const ref = await adapter.createFeature(input);
+            const { orphan: _orphan, ...payload } = input;
+            const ref = await adapter.createFeature(payload);
             return ok(`Created feature \`${ref.id}\`.`, { savedRef: ref });
         }
         catch (e) {
@@ -399,6 +408,9 @@ export function registerBacklogTools(server, deps) {
                 'leave a story parent-less unless the user explicitly says "no parent".'),
             featureId: z.number().optional().describe('Parent feature numeric id. RESOLVE VIA `feature_list` OR ASK THE USER before creating — a ' +
                 'story typically lives under a feature. Skip only if the user explicitly says "no feature".'),
+            orphan: z.boolean().optional().describe('Set true ONLY if the user has explicitly said the story has no parent ("standalone", "no ' +
+                'epic/feature"). Required when BOTH `epicId` and `featureId` are omitted — the tool refuses ' +
+                'otherwise so orphan stories cannot be created silently from a BRD/BRS prompt.'),
             moduleId: z.number().optional(),
             releaseId: z.number().optional(),
             iterationId: z.number().optional().describe('Sprint numeric id (SQA `iterationId`).'),
@@ -451,8 +463,18 @@ export function registerBacklogTools(server, deps) {
             return err(NOT_CONNECTED);
         if (!adapter.createStory)
             return err('This product does not expose story creation.');
+        if (input.epicId == null && input.featureId == null && input.orphan !== true) {
+            return err('HIERARCHY REQUIRED: no `epicId` or `featureId` provided. Before creating, ASK the user ' +
+                'which parents this story belongs to — offer two paths: (a) generate the full Epic → ' +
+                'Feature → Story hierarchy (call `epic_create` then `feature_create` then this tool), or ' +
+                '(b) pick existing parents (list by NAME via `epic_list` / `feature_list`, then pass their ' +
+                'ids). Only re-call with `orphan: true` if the user explicitly says "no parent" / ' +
+                '"standalone". Apply the same ask to sibling stories in this batch — do not create some ' +
+                'linked and some orphaned silently.');
+        }
         try {
-            const ref = await adapter.createStory(input);
+            const { orphan: _orphan, ...payload } = input;
+            const ref = await adapter.createStory(payload);
             return ok(`Created story \`${ref.id}\`.`, { savedRef: ref });
         }
         catch (e) {