swipium 1.5.0 → 2.0.1

package/dist/orchestration/testThis/terminal.js

@@ -1,11 +1,11 @@
-// qa_test_this terminal-state assembly — every terminal state (completed OR blocked) generates a
+// qa_test_this terminal-state assembly: every terminal state (completed OR blocked) generates a
 // report artifact (Milestone B) and lands the uniform TerminalEnvelope on the job result, so the
 // outcome is summarizable from structured output without log parsing.
 import { buildTerminalEnvelope, typedBlockerFromCode } from '../envelope.js';
 import { generateSessionReport } from '../../services/report.js';
 import { startProgress } from '../../session/progress.js';
 import { log } from '../../lib/logger.js';
-/** Every terminal state — completed OR blocked — generates a report artifact (Milestone B). */
+/** Every terminal state (completed OR blocked) generates a report artifact (Milestone B). */
 export function createFinisher(ctx) {
     const { sessions, session, job, a, attempted, artifacts, upd } = ctx;
     return async (state, failureCode, summary, extra = {}) => {
@@ -16,7 +16,7 @@ export function createFinisher(ctx) {
                 risk: a.testThisPlanMutation.risk,
                 target: a.testThisPlanMutation.affects,
                 consent: a.mutationConsent,
-                status: state === 'completed' ? 'executed' : 'blocked',
+                status: state === 'blocked' || state === 'unsafe' ? 'blocked' : 'executed',
                 detail: failureCode,
             });
         }
@@ -46,6 +46,7 @@ export function createFinisher(ctx) {
             });
             reportUri = r.reportUri;
             manifestUri = r.manifestUri;
+            sessions.milestone(session, 'report_generated'); // persisted flag for qa_status's ladder
             if (!artifacts.includes(reportUri))
                 artifacts.push(reportUri);
             appVerdict = r.report.appVerdict;
@@ -62,16 +63,28 @@ export function createFinisher(ctx) {
             : session.findings.some((f) => f.layer === 'app' && f.severity === 'medium')
                 ? 'degraded'
                 : 'OK';
-        // The report already exists — point the agent AT it (fetch/open), not back at qa_report.
-        const nextRecommendedAction = state === 'completed'
-            ? reportUri
-                ? {
-                    tool: 'qa_get_artifact',
-                    args: { uri: reportUri },
-                    why: `Open the generated report (${reportUri})`,
-                }
-                : { tool: 'qa_report', args: { sessionId: session.id }, why: 'Generate the report' }
-            : { tool: 'qa_explain_blocker', args: { failureCode: failureCode ?? 'UNKNOWN' }, why: 'Understand the blocker and how to fix it' };
+        // The report already exists, so point the agent AT it (fetch/open), not back at qa_report.
+        const question = extra.needsInput;
+        const nextRecommendedAction = state === 'needs_input' && question?.resume
+            ? {
+                tool: question.resume.tool,
+                args: question.resume.args,
+                why: `Ask the user exactly this one question, then resume with their answer: ${question.question ?? question.kind ?? 'input needed'}`,
+            }
+            : state === 'completed'
+                ? reportUri
+                    ? {
+                        tool: 'qa_get_artifact',
+                        args: { uri: reportUri },
+                        why: `Open the generated report (${reportUri})`,
+                    }
+                    : { tool: 'qa_report', args: { sessionId: session.id }, why: 'Generate the report' }
+                : {
+                    tool: 'qa_explain_blocker',
+                    // sessionId lets qa_explain_blocker stamp the blocker as explained, so qa_status moves on.
+                    args: { failureCode: failureCode ?? 'UNKNOWN', sessionId: session.id },
+                    why: 'Understand the blocker and how to fix it',
+                };
         // Uniform terminal envelope (Milestone B): summarizable from structured output, no log parsing.
         const envelope = buildTerminalEnvelope({
             state,
@@ -87,16 +100,17 @@ export function createFinisher(ctx) {
                 ...(coverageVerdict ? { coverage: coverageVerdict } : {}),
                 ...(toolVerdict ? { tool: toolVerdict } : {}),
             },
-            blockers: state === 'completed' || !failureCode ? [] : [typedBlockerFromCode(failureCode)],
+            blockers: state === 'completed' || state === 'needs_input' || !failureCode ? [] : [typedBlockerFromCode(failureCode)],
             reportUri: reportUri ?? null,
             nextRecommendedAction,
         });
         upd({
-            status: state === 'completed' ? 'done' : 'failed',
+            // needs_input is a clean pause (the run did what it could and asks ONE question), not a failure.
+            status: state === 'completed' || state === 'needs_input' ? 'done' : 'failed',
             progress: state,
             result: {
                 ...envelope,
-                // Pre-launch static app map URI is present in EVERY terminal state — including blocked (Fix 1).
+                // Pre-launch static app map URI is present in EVERY terminal state, including blocked (Fix 1).
                 appMapUri: a.appMapUri,
                 goal: a.goal,
                 requiredOutputs: a.requiredOutputs,
@@ -106,6 +120,10 @@ export function createFinisher(ctx) {
                 manifestUri,
                 health: { native, app },
                 inputsProvided: session.inputs.map((i) => i.varName),
+                // Compact report pointer: verdict one-liner + URI; the full report lives at reportUri.
+                reportSummary: reportUri
+                    ? `${appVerdict?.status ?? 'n/a'} app · ${coverageVerdict?.status ?? 'n/a'} coverage · ${toolVerdict?.status ?? 'n/a'} tool. Read ${reportUri}`
+                    : null,
                 notes: session.notes.length,
                 findings: session.findings.length,
                 ...extra,

package/dist/orchestration/testThis/terminal.js.map

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

package/dist/orchestration/testThis/types.js

@@ -1,5 +1,5 @@
 // Shared types for the qa_test_this orchestration state machine (split out of
-// src/tools/testThis.ts). Pure declarations + tiny helpers — no side effects.
+// src/tools/testThis.ts). Pure declarations + tiny helpers, no side effects.
 export const selToPlatform = {
     'android-emulator': 'android',
     'android-real': 'android',

package/dist/orchestration/testThis/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/orchestration/testThis/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAyB9E,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,kBAAkB,EAAE,SAAS;IAC7B,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,KAAK;IACtB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/orchestration/testThis/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AA0B7E,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,kBAAkB,EAAE,SAAS;IAC7B,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,KAAK;IACtB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/plan/plan.js

@@ -1,8 +1,8 @@
-// qa_plan core (PHASE3-PLAN §3.2) — PURE synthesis. Given what we detected about the
+// Workflow-plan core (qa_resolve_target include:["plan"]): PURE synthesis. Given what we detected about the
 // project + what the session declared (fixtures, observed auth, prepared appId), produce a
 // safe test plan: which workflows are READY, which are BLOCKED (and why + how to unblock),
 // and which are UNSAFE (and why). No device I/O lives here, so it is fully unit-testable;
-// the tool wrapper (src/tools/plan.ts) gathers the inputs and calls buildPlan().
+// the tool wrapper (src/tools/resolveTarget.ts workflowPlan) gathers the inputs and calls buildPlan().
 const LOGIN_FIXTURE = /login|auth|account|credential|sign[\s_-]?in/i;
 function isDebugRN(fw) {
     return fw === 'expo' || fw === 'bare-react-native';
@@ -37,7 +37,7 @@ export function buildPlan(i) {
         }
         return null;
     };
-    // launch_smoke — the cheapest always-valuable check.
+    // launch_smoke: the cheapest always-valuable check.
     {
         const g = gateEnv('launch_smoke', 'guardrail');
         if (g)
@@ -45,7 +45,7 @@ export function buildPlan(i) {
         else
             ready.push({ workflow: 'launch_smoke', budgetProfile: 'guardrail', requires: [] });
     }
-    // visual_smoke — screenshot/landmark check for visual-only (map/canvas) screens.
+    // visual_smoke: screenshot/landmark check for visual-only (map/canvas) screens.
     {
         const g = gateEnv('visual_smoke', 'login_smoke');
         if (g)
@@ -53,7 +53,7 @@ export function buildPlan(i) {
         else
             ready.push({ workflow: 'visual_smoke', budgetProfile: 'login_smoke', requires: [] });
     }
-    // login_smoke — needs a credential fixture on top of the env gate.
+    // login_smoke: needs a credential fixture on top of the env gate.
     {
         const g = gateEnv('login_smoke', 'login_smoke');
         if (g)
@@ -64,7 +64,7 @@ export function buildPlan(i) {
                 budgetProfile: 'login_smoke',
                 category: 'missing_test_data',
                 requiredState: 'a test account (credentials)',
-                recommendedSetup: 'Declare a fixture with a testAccount label (and provide TEST_EMAIL/TEST_PASSWORD via env), or add it to .swipium/fixtures.json.',
+                recommendedSetup: 'Declare a fixture with a testAccount label (and provide SWIPIUM_TEST_EMAIL/SWIPIUM_TEST_PASSWORD via env), or add it to .swipium/fixtures.json.',
             });
         }
         else {
@@ -80,7 +80,7 @@ export function buildPlan(i) {
             ready.push({ workflow: name, budgetProfile: 'full_smoke', requires: [] });
     }
     // Fixtures that declare an unmet requiredState surface as blocked workflows so "no saved
-    // flight to delete" reads as setup guidance, not a failure (DESIGN §6 / qa_note semantics).
+    // flight to delete" reads as setup guidance, not a failure (qa_note semantics).
     for (const f of i.fixtures) {
         if (f.requiredState && !LOGIN_FIXTURE.test(f.name) && !f.testAccount) {
             blocked.push({
@@ -92,7 +92,7 @@ export function buildPlan(i) {
             });
         }
     }
-    // UNSAFE — destructive actions that Swipium will refuse by default.
+    // UNSAFE: destructive actions that Swipium will refuse by default.
     if (isDebugRN(i.framework)) {
         unsafe.push({
             workflow: 'fresh_start',
@@ -115,7 +115,7 @@ export function buildPlan(i) {
         'Destructive exploration requires dry_run_destructive first, then candidate-bound approval with disposable test state.',
     ];
     if (i.auth.authedAtStart === false || i.auth.loginScreenSeen) {
-        notes.push('A login screen was observed — authenticated workflows will need credentials.');
+        notes.push('A login screen was observed. Authenticated workflows will need credentials.');
     }
     for (const b of i.blockers)
         notes.push(b);

package/dist/plan/plan.js.map

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

package/dist/prompts/index.js

@@ -1,10 +1,10 @@
-// MCP prompts (PHASE3-PLAN §2.4 / §3.3) — the spec's third server capability (after tools +
+// MCP prompts: the spec's third server capability (after tools +
 // resources). Prompts are reusable workflow templates a prompt-capable client (e.g. Claude)
 // can invoke by name, so common QA runs don't need a hand-written prompt each time.
 //
 // Design rules:
 //  - Prompts are THIN: they only orchestrate tools that already exist. No privileged logic
-//    lives here — consent stays server-side (security best-practices doc).
+//    lives here. Consent stays server-side (security best-practices doc).
 //  - Clients that don't support prompts lose nothing: every step is "call <tool>", which the
 //    agent can do directly. Nothing is prompt-only.
 //
@@ -18,20 +18,20 @@ export function registerPrompts(server) {
         description: 'Verify Swipium can test a project and report what (if anything) is blocking.',
         argsSchema: { projectRoot: z.string().optional().describe('Absolute path to the app project.') },
     }, ({ projectRoot }) => userText(`Check whether Swipium can test ${projectRoot ? `the project at ${projectRoot}` : 'this project'}.\n\n` +
-        `1. Call qa_doctor to confirm the toolchain (adb/emulator/java) and that the client is not stale.\n` +
+        `1. Call qa_doctor to confirm the toolchain (Android SDK/emulator, and Xcode/simctl on macOS) and that the client is not stale.\n` +
         `2. Call qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}" }` : ''}.\n` +
-        `3. Call qa_detect_context, then qa_plan with the sessionId.\n` +
-        `4. Summarize: is it READY, PARTIAL, or BLOCKED? List the exact missing items (APK, device, credentials) and the recommended budget profile. Do not start testing yet.`));
+        `3. Call qa_resolve_target { sessionId, include: ["context", "plan"] }.\n` +
+        `4. Summarize: which workflows are READY, BLOCKED, or UNSAFE? List the exact missing items (APK, device, credentials) and the recommended budget profile. Do not start testing yet.`));
     server.registerPrompt('swipium_guardrail_validation', {
         title: 'Validate safety guardrails',
-        description: 'Confirm Swipium refuses an unsafe destructive action (bundle-loss) on a debug RN/Expo build.',
+        description: 'Confirm Swipium refuses an unsafe destructive action (bundle-loss) on a debug RN/Expo Android build.',
         argsSchema: { projectRoot: z.string().optional() },
     }, ({ projectRoot }) => userText(`Validate Swipium's destructive-action guardrails (do NOT override them).\n\n` +
         `1. qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}", ` : ' { '}profile: "guardrail" }.\n` +
-        `2. qa_plan — confirm fresh_start appears under UNSAFE with reason bundle_cache_loss for a debug RN/Expo build.\n` +
-        `3. qa_prepare_target to get the app running.\n` +
-        `4. Attempt qa_app_control { action: "fresh_start" } WITHOUT acknowledgeBundleRisk — expect a refusal (bundle_cache_loss), not execution.\n` +
-        `5. qa_report and confirm destructiveGuardrail shows the action was refused, not executed. Report PASS only if it was refused.`));
+        `2. qa_resolve_target { sessionId, include: ["plan"] } and confirm fresh_start appears under UNSAFE with reason bundle_cache_loss for a debug RN/Expo build.\n` +
+        `3. qa_prepare_target { sessionId } to get the app running on an Android Emulator (approve consent for boot/install if prompted).\n` +
+        `4. Attempt qa_app_control { sessionId, action: "fresh_start" } WITHOUT acknowledgeBundleRisk. Expect a refusal (failureCode BUNDLE_LOSS_REFUSED), not execution.\n` +
+        `5. qa_report { sessionId } and confirm destructiveGuardrail shows the action was refused, not executed. Report PASS only if it was refused.`));
     server.registerPrompt('swipium_full_smoke', {
         title: 'Run a full smoke test',
         description: 'Plan, prepare, run the top ready workflows, and produce a report.',
@@ -41,11 +41,11 @@ export function registerPrompts(server) {
         },
     }, ({ projectRoot, appId }) => userText(`Run a full smoke test and produce a report a developer can act on.\n\n` +
         `1. qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}", ` : ' { '}profile: "full_smoke", responseMode: "compact" }.\n` +
-        `2. qa_plan — pick the READY workflows; respect anything listed as UNSAFE.\n` +
-        `3. qa_prepare_target${appId ? ` { appId: "${appId}" }` : ''} (approve consent for boot/install if prompted).\n` +
+        `2. qa_resolve_target { sessionId, include: ["plan"] } and pick the READY workflows; respect anything listed as UNSAFE.\n` +
+        `3. qa_prepare_target { sessionId${appId ? `, appId: "${appId}"` : ''} } (Android) or qa_prepare_ios_target { sessionId${appId ? `, bundleId: "${appId}"` : ''} } (iOS) (approve consent for boot/install if prompted).\n` +
         `4. For each ready workflow: drive it with qa_snapshot/qa_act, checking qa_check_health after key steps. Use qa_clear_overlay if a keyboard/dialog/banner blocks a target.\n` +
-        `5. Record each result with qa_note (pass/fail/blocked + category). For visual-only screens use qa_assert_visual.\n` +
-        `6. qa_report at the end. Summarize release risk and the single most important next action.`));
+        `5. Record each result with qa_note (sessionId, workflow, outcome pass/fail/blocked + category). For visual-only screens use qa_visual mode:"assert".\n` +
+        `6. qa_report { sessionId } at the end. Summarize release risk and the single most important next action.`));
     server.registerPrompt('swipium_bug_repro', {
         title: 'Reproduce and document a bug',
         description: 'Drive to a described bug, capture deterministic evidence, and file it as a structured outcome.',
@@ -54,20 +54,20 @@ export function registerPrompts(server) {
             projectRoot: z.string().optional(),
         },
     }, ({ bug, projectRoot }) => userText(`Reproduce and document this bug with evidence:\n"${bug}"\n\n` +
-        `1. qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}", ` : ' { '}profile: "login_smoke" }, then qa_plan.\n` +
-        `2. qa_prepare_target, then navigate toward the reported bug with qa_snapshot/qa_act.\n` +
-        `3. At the failure, call qa_check_health (capture native vs app classification) and qa_screenshot for evidence.\n` +
-        `4. Record qa_note { outcome: "fail", category: "app_bug", reason, artifactUris } — or "blocked"/"not_applicable" if you could not reach it, with the precondition.\n` +
-        `5. qa_report. Include exact reproduction steps and the evidence artifact URIs so the report stands alone without the transcript.`));
+        `1. qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}", ` : ' { '}profile: "login_smoke" }, then qa_resolve_target { sessionId, include: ["plan"] }.\n` +
+        `2. qa_prepare_target (Android) or qa_prepare_ios_target (iOS) { sessionId }, then navigate toward the reported bug with qa_snapshot/qa_act.\n` +
+        `3. At the failure, call qa_check_health { sessionId } (native vs app classification) and qa_screenshot { sessionId, reason } for evidence (on a visual-only iOS screen, qa_visual mode:"assert").\n` +
+        `4. Record qa_note { sessionId, workflow, outcome: "fail", category: "app_bug", reason, artifactUris }. Use "blocked"/"not_applicable" if you could not reach it, with missingPrecondition.\n` +
+        `5. qa_report { sessionId }. Include exact reproduction steps and the evidence artifact URIs so the report stands alone without the transcript.`));
     server.registerPrompt('swipium_convert_run_to_flow', {
         title: 'Convert a run into a reusable flow',
         description: 'Draft a repeatable .swipium/flows/*.yaml from the steps you just performed, then validate it.',
         argsSchema: { name: z.string().optional().describe('Flow name, e.g. login-smoke.') },
     }, ({ name }) => userText(`Turn the workflow you just ran into a repeatable Swipium flow.\n\n` +
         `1. Call qa_generate { sessionId, target: "flow", name: "${name ?? 'my-flow'}" } to draft the flow YAML from the recorded actions (or write it by hand with: name, appId, budgetProfile, fixtures, and a steps list).\n` +
-        `2. Use durable selectors: prefer text/id (e.g. tap: "Sign In") over @ref. Replace credentials with \${TEST_EMAIL}/\${TEST_PASSWORD} variables — never inline secrets.\n` +
-        `   Available steps: prepareTarget, tap, tapAt, inputText, assertVisible, assertNotVisible, swipe, scrollTo, press, openUrl, wait.\n` +
+        `2. Use durable selectors: prefer text/id (e.g. tap: "Sign In") over @ref. Replace credentials with \${SWIPIUM_TEST_EMAIL}/\${SWIPIUM_TEST_PASSWORD} variables. Never inline secrets.\n` +
+        `   Common steps: prepareTarget, tap, tapAt, inputText, assertVisible, assertNotVisible, swipe, scrollTo, press, openUrl, wait, clearOverlay (full list: docs/tools.md#flow-steps).\n` +
         `3. Validate it with qa_flow_check { flowYaml: "<your yaml>" } and fix any reported errors (qa_generate also reports a durability grade + brittle steps).\n` +
-        `4. Save it under .swipium/flows/${name ?? 'my-flow'}.yaml (qa_generate save:true does this) so qa_plan lists it and qa_flow_run can replay it.`));
+        `4. Save it under .swipium/flows/${name ?? 'my-flow'}.yaml (qa_generate save:true does this) so the workflow plan lists it and qa_flow_run can replay it.`));
 }
 //# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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