swipium 1.5.0 → 2.0.1

package/dist/tools/startSession.js

@@ -1,45 +1,108 @@
-// qa_start_session — resolve projectRoot (roots → arg → ask) and open a session.
+// qa_start_session: resolve projectRoot (src/context/projectRoot.ts) and open a session.
 import { z } from 'zod';
-import { readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { loadProjectFixtures } from '../fixtures/load.js';
 import { qaOk, qaError } from '../lib/result.js';
-import { resolveProjectRoot } from '../context/projectRoot.js';
+import { resolveProjectRoot, unresolvedProjectRootError } from '../context/projectRoot.js';
 import { loadProjectConfig } from '../cli/scan.js';
 import { SWIPIUM_VERSION, TOOL_COUNT } from '../version.js';
 import { getSchemaHash } from '../lib/schemaHash.js';
 import { BUDGET_PROFILES } from '../session/store.js';
-/** Load declared fixtures from <root>/.swipium/fixtures.json (best-effort, array or {fixtures:[]}). */
-export function loadProjectFixtures(root) {
-    const p = join(root, '.swipium', 'fixtures.json');
-    if (!existsSync(p))
-        return [];
-    try {
-        const raw = JSON.parse(readFileSync(p, 'utf8'));
-        const arr = Array.isArray(raw) ? raw : Array.isArray(raw?.fixtures) ? raw.fixtures : [];
-        return arr.filter((f) => f && typeof f.name === 'string');
-    }
-    catch {
-        return [];
-    }
-}
+/** Full fixture shape. The tool's inputSchema advertises only `{ name, …passthrough }` (the nested
+ *  seed/cleanup/fields schema tripled the tool's size in tools/list); fixtures are validated
+ *  against this schema in the handler and rejected with INVALID_ARGUMENT, so nothing is lost. */
+export const FIXTURE_SCHEMA = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    requiredState: z.string().optional(),
+    recommendedSetup: z.string().optional(),
+    testAccount: z.string().optional(),
+    apkPath: z.string().optional(),
+    value: z.string().optional().describe('Non-secret safe test input (e.g. flight number/search term) for exploration text entry.'),
+    disposable: z.boolean().optional().describe('True only for disposable accounts/data that destructive QA may mutate or delete.'),
+    environment: z.string().optional().describe('Environment label. Use "test" for non-production disposable test state.'),
+    fields: z
+        .record(z.object({
+        value: z.string().optional(),
+        var: z.string().optional().describe('Environment/secure-input variable name to read at runtime.'),
+        secret: z.boolean().optional(),
+        generator: z
+            .enum([
+            'email',
+            'email_address',
+            'person',
+            'person_name',
+            'full_name',
+            'display_name',
+            'number',
+            'numeric',
+            'text',
+            'city',
+            'city_name',
+            'country',
+            'country_name',
+            'color',
+            'phone',
+            'phone_number',
+            'mobile',
+            'date',
+            'date_iso',
+        ])
+            .optional(),
+        role: z.string().optional(),
+        inputType: z.string().optional(),
+    }))
+        .optional()
+        .describe('Typed fixture catalog for form entry. Fields match by label/id/role and may use a fixed value, variable, or safe generator.'),
+    seed: z
+        .object({
+        type: z.enum(['deeplink', 'script', 'api']),
+        url: z.string().optional(),
+        command: z
+            .union([z.string(), z.array(z.string())])
+            .optional()
+            .describe('script: argv array preferred (string is deprecated).'),
+        method: z.string().optional(),
+        body: z.string().optional(),
+        headers: z.record(z.string()).optional(),
+        idempotent: z.boolean().optional().describe('True when re-running this seed safely converges to the same state.'),
+        cleanup: z
+            .object({
+            type: z.enum(['deeplink', 'script', 'api']),
+            url: z.string().optional(),
+            command: z
+                .union([z.string(), z.array(z.string())])
+                .optional()
+                .describe('script: argv array preferred (string is deprecated).'),
+            method: z.string().optional(),
+            body: z.string().optional(),
+            headers: z.record(z.string()).optional(),
+        })
+            .optional()
+            .describe('Optional teardown/rollback action used for state-profile transactions.'),
+    })
+        .optional()
+        .describe('Opt-in, consent-gated way to create this precondition during flows.'),
+});
+// Moved to src/fixtures/load.ts (store.ts re-reads it on rehydrate); re-exported for callers.
+export { loadProjectFixtures } from '../fixtures/load.js';
 export function registerStartSession(server, sessions) {
     server.registerTool('qa_start_session', {
         title: 'Start a QA session',
-        description: 'Resolve the project root and open a QA session. Resolution order: MCP workspace roots → explicit `projectRoot` arg → ask. NEVER uses the server cwd. A session enforces a BUDGET (default: 8 min / 20 actions / 8 screenshots / 3 snapshot-failures / 3 no-change-actions). Pass `profile` to size the time budget to the workflow (guardrail 8m / login_smoke 10m / full_smoke 15m / install_smoke 20m) — Swipium WARNS if your explicit budget is likely too low. Pass `fixtures` (or add .swipium/fixtures.json) to declare preconditions so unmet ones report as blocked-with-setup, not failures. Pass `responseMode` (compact|normal|verbose) to control transcript size: compact drops the duplicated JSON from the text channel (structured data is unchanged) — recommended for long smoke runs. Call this before snapshot/act tools.',
+        description: 'Open a QA session (only needed for low-level tools; qa_test_this creates one). projectRoot: arg, else MCP roots, else ' +
+            'SWIPIUM_PROJECT_ROOT / CLAUDE_PROJECT_DIR, else the server cwd if it is not / or $HOME and contains a project marker (package.json, app.json, pubspec.yaml, Gradle/Xcode files, Podfile, android/, ios/). Budget defaults to 8 min / 20 ' +
+            'actions / 8 screenshots; profile resizes it. fixtures (or .swipium/fixtures.json) declare preconditions so unmet ones ' +
+            'report as blocked, not failed. responseMode compact keeps transcripts small.',
         inputSchema: {
-            projectRoot: z.string().optional().describe('Absolute path to the app project. Optional if the client exposes a workspace root.'),
+            projectRoot: z.string().optional().describe('Absolute app path (optional with MCP roots).'),
             responseMode: z
                 .enum(['compact', 'normal', 'verbose'])
                 .optional()
-                .describe('Text-channel verbosity for every tool in this session. compact = summary + artifact URIs only (structuredContent stays full); normal (default) = summary + JSON; verbose = everything.'),
-            sensitive: z
-                .boolean()
-                .optional()
-                .describe('Sensitive mode: refuse all screenshots, screen recordings, and on-screen-error evidence capture for this session (no pixels leave the device). For privacy-sensitive apps.'),
+                .describe('Text channel for every tool in this session: compact = summary + URIs; normal (default) = + JSON; verbose.'),
+            sensitive: z.boolean().optional().describe('Refuse all screenshots, recordings, and on-screen evidence capture for this session.'),
             profile: z
                 .enum(['guardrail', 'login_smoke', 'full_smoke', 'install_smoke'])
                 .optional()
-                .describe('Budget class — sizes the time budget to the intended workflow.'),
+                .describe('Budget class sizing the time budget.'),
             budget: z
                 .object({
                 maxMinutes: z.number().optional(),
@@ -51,100 +114,25 @@ export function registerStartSession(server, sessions) {
                 .optional()
                 .describe('Override default budget caps.'),
             fixtures: z
-                .array(z.object({
-                name: z.string(),
-                description: z.string().optional(),
-                requiredState: z.string().optional(),
-                recommendedSetup: z.string().optional(),
-                testAccount: z.string().optional(),
-                apkPath: z.string().optional(),
-                value: z
-                    .string()
-                    .optional()
-                    .describe('Non-secret safe test input (e.g. flight number/search term) for exploration text entry.'),
-                disposable: z
-                    .boolean()
-                    .optional()
-                    .describe('True only for disposable accounts/data that destructive QA may mutate or delete.'),
-                environment: z.string().optional().describe('Environment label. Use "test" for non-production disposable test state.'),
-                fields: z
-                    .record(z.object({
-                    value: z.string().optional(),
-                    var: z.string().optional().describe('Environment/secure-input variable name to read at runtime.'),
-                    secret: z.boolean().optional(),
-                    generator: z
-                        .enum([
-                        'email',
-                        'email_address',
-                        'person',
-                        'person_name',
-                        'full_name',
-                        'display_name',
-                        'number',
-                        'numeric',
-                        'text',
-                        'city',
-                        'city_name',
-                        'country',
-                        'country_name',
-                        'color',
-                        'phone',
-                        'phone_number',
-                        'mobile',
-                        'date',
-                        'date_iso',
-                    ])
-                        .optional(),
-                    role: z.string().optional(),
-                    inputType: z.string().optional(),
-                }))
-                    .optional()
-                    .describe('Typed fixture catalog for form entry. Fields match by label/id/role and may use a fixed value, variable, or safe generator.'),
-                seed: z
-                    .object({
-                    type: z.enum(['deeplink', 'script', 'api']),
-                    url: z.string().optional(),
-                    command: z
-                        .union([z.string(), z.array(z.string())])
-                        .optional()
-                        .describe('script: argv array preferred (string is deprecated).'),
-                    method: z.string().optional(),
-                    body: z.string().optional(),
-                    headers: z.record(z.string()).optional(),
-                    idempotent: z.boolean().optional().describe('True when re-running this seed safely converges to the same state.'),
-                    cleanup: z
-                        .object({
-                        type: z.enum(['deeplink', 'script', 'api']),
-                        url: z.string().optional(),
-                        command: z
-                            .union([z.string(), z.array(z.string())])
-                            .optional()
-                            .describe('script: argv array preferred (string is deprecated).'),
-                        method: z.string().optional(),
-                        body: z.string().optional(),
-                        headers: z.record(z.string()).optional(),
-                    })
-                        .optional()
-                        .describe('Optional teardown/rollback action used for state-profile transactions.'),
-                })
-                    .optional()
-                    .describe('Opt-in, consent-gated way to create this precondition during flows.'),
-            }))
+                .array(z.object({ name: z.string() }).passthrough())
                 .optional()
-                .describe('Declared preconditions/fixtures this run needs (merged with .swipium/fixtures.json).'),
+                .describe('Declared preconditions (merged with .swipium/fixtures.json): {name, requiredState?, recommendedSetup?, value?, disposable?, fields?, seed?, …}. Full shape in docs/tools.md#qa_start_session.'),
         },
     }, async ({ projectRoot, profile, budget, fixtures, responseMode, sensitive }) => {
-        const resolved = await resolveProjectRoot(server, projectRoot);
-        if (!resolved.root) {
+        const parsedFixtures = z.array(FIXTURE_SCHEMA).optional().safeParse(fixtures);
+        if (!parsedFixtures.success)
             return qaError({
-                what: 'Could not resolve a project root',
+                what: `Invalid fixtures: ${parsedFixtures.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ')}`,
                 changedState: false,
                 retrySafe: true,
-                nextSteps: ['Re-call qa_start_session with projectRoot="/absolute/path/to/app"'],
-                clientHint: resolved.hint,
+                failureCode: 'INVALID_ARGUMENT',
+                nextSteps: ['Fix the fixture shape (see docs/tools.md#qa_start_session) and re-call qa_start_session.'],
             });
+        const resolved = await resolveProjectRoot(server, projectRoot);
+        if (!resolved.root) {
+            return unresolvedProjectRootError(resolved);
         }
-        // Budget profile → recommended minutes; explicit profile sets the budget unless the
+        // Budget profile sets recommended minutes; explicit profile sets the budget unless the
         // caller also gave maxMinutes. Warn when the resulting time budget is below the class min.
         const profileMinutes = profile ? BUDGET_PROFILES[profile] : undefined;
         const effBudget = { ...(budget ?? {}) };
@@ -152,10 +140,10 @@ export function registerStartSession(server, sessions) {
             effBudget.maxMinutes = profileMinutes;
         const warnings = [];
         if (profileMinutes != null && effBudget.maxMinutes != null && effBudget.maxMinutes < profileMinutes) {
-            warnings.push(`Requested ${effBudget.maxMinutes}m is below the ${profile} class (${profileMinutes}m) — likely too short; consider raising maxMinutes.`);
+            warnings.push(`Requested ${effBudget.maxMinutes}m is below the ${profile} class (${profileMinutes}m), likely too short; consider raising maxMinutes.`);
         }
         // Surface a prior `swipium scan` (.swipium/config.json) so the agent knows the
-        // recommended profile / appId without re-scanning. Informational — never auto-overrides
+        // recommended profile / appId without re-scanning. Informational only, never auto-overrides
         // an explicit profile choice.
         const projectConfig = loadProjectConfig(resolved.root);
         if (projectConfig && !profile && typeof projectConfig.recommendedProfile === 'string') {
@@ -166,7 +154,7 @@ export function registerStartSession(server, sessions) {
         const byName = new Map();
         for (const f of fileFixtures)
             byName.set(f.name, f);
-        for (const f of fixtures ?? [])
+        for (const f of parsedFixtures.data ?? [])
             byName.set(f.name, f);
         const mergedFixtures = [...byName.values()];
         const session = sessions.create(resolved.root, effBudget, {
@@ -204,7 +192,7 @@ export function registerStartSession(server, sessions) {
                 : null,
             declaredPreconditions: mergedFixtures,
             warnings,
-        }, `Session ${session.id} started (Swipium v${SWIPIUM_VERSION}, ${TOOL_COUNT} tools — if your client lists fewer, restart it).\n` +
+        }, `Session ${session.id} started (Swipium v${SWIPIUM_VERSION}, ${TOOL_COUNT} tools; if your client lists fewer, restart it).\n` +
             `projectRoot: ${session.root} (via ${resolved.source})\n` +
             `budget: ${JSON.stringify(session.budget)}${profile ? ` (profile=${profile})` : ''}\n` +
             (mergedFixtures.length ? `preconditions declared: ${mergedFixtures.map((f) => f.name).join(', ')}\n` : '') +

package/dist/tools/startSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"startSession.js","sourceRoot":"","sources":["../../src/tools/startSession.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAmC,MAAM,qBAAqB,CAAC;AAEvF,uGAAuG;AACvG,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,IAAI,OAAQ,CAAa,CAAC,IAAI,KAAK,QAAQ,CAAc,CAAC;IAC/F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,QAAsB;IAC5E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,gzBAAgzB;QAClzB,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;YACjI,YAAY,EAAE,CAAC;iBACZ,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;iBACtC,QAAQ,EAAE;iBACV,QAAQ,CACP,wLAAwL,CACzL;YACH,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,4KAA4K,CAC7K;YACH,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;iBACjE,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,MAAM,EAAE,CAAC;iBACN,MAAM,CAAC;gBACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACrC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC1C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC1C,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,+BAA+B,CAAC;YAC5C,QAAQ,EAAE,CAAC;iBACR,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC9B,KAAK,EAAE,CAAC;qBACL,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CAAC,yFAAyF,CAAC;gBACtG,UAAU,EAAE,CAAC;qBACV,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CAAC,kFAAkF,CAAC;gBAC/F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;gBACtH,MAAM,EAAE,CAAC;qBACN,MAAM,CACL,CAAC,CAAC,MAAM,CAAC;oBACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;oBACjG,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;oBAC9B,SAAS,EAAE,CAAC;yBACT,IAAI,CAAC;wBACJ,OAAO;wBACP,eAAe;wBACf,QAAQ;wBACR,aAAa;wBACb,WAAW;wBACX,cAAc;wBACd,QAAQ;wBACR,SAAS;wBACT,MAAM;wBACN,MAAM;wBACN,WAAW;wBACX,SAAS;wBACT,cAAc;wBACd,OAAO;wBACP,OAAO;wBACP,cAAc;wBACd,QAAQ;wBACR,MAAM;wBACN,UAAU;qBACX,CAAC;yBACD,QAAQ,EAAE;oBACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBACjC,CAAC,CACH;qBACA,QAAQ,EAAE;qBACV,QAAQ,CACP,6HAA6H,CAC9H;gBACH,IAAI,EAAE,CAAC;qBACJ,MAAM,CAAC;oBACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAC3C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC1B,OAAO,EAAE,CAAC;yBACP,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;yBACxC,QAAQ,EAAE;yBACV,QAAQ,CAAC,sDAAsD,CAAC;oBACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;oBACxC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;oBACjH,OAAO,EAAE,CAAC;yBACP,MAAM,CAAC;wBACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;wBAC3C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;wBAC1B,OAAO,EAAE,CAAC;6BACP,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;6BACxC,QAAQ,EAAE;6BACV,QAAQ,CAAC,sDAAsD,CAAC;wBACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;wBAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;wBAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;qBACzC,CAAC;yBACD,QAAQ,EAAE;yBACV,QAAQ,CAAC,wEAAwE,CAAC;iBACtF,CAAC;qBACD,QAAQ,EAAE;qBACV,QAAQ,CAAC,qEAAqE,CAAC;aACnF,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CAAC,sFAAsF,CAAC;SACpG;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,EAAE;QAC5E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC;gBACb,IAAI,EAAE,kCAAkC;gBACxC,YAAY,EAAE,KAAK;gBACnB,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,CAAC,mEAAmE,CAAC;gBAChF,UAAU,EAAE,QAAQ,CAAC,IAAI;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,oFAAoF;QACpF,2FAA2F;QAC3F,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACxC,IAAI,cAAc,IAAI,IAAI,IAAI,SAAS,CAAC,UAAU,IAAI,IAAI;YAAE,SAAS,CAAC,UAAU,GAAG,cAAc,CAAC;QAClG,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,cAAc,IAAI,IAAI,IAAI,SAAS,CAAC,UAAU,IAAI,IAAI,IAAI,SAAS,CAAC,UAAU,GAAG,cAAc,EAAE,CAAC;YACpG,QAAQ,CAAC,IAAI,CACX,aAAa,SAAS,CAAC,UAAU,kBAAkB,OAAO,WAAW,cAAc,qDAAqD,CACzI,CAAC;QACJ,CAAC;QAED,+EAA+E;QAC/E,wFAAwF;QACxF,8BAA8B;QAC9B,MAAM,aAAa,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,aAAa,IAAI,CAAC,OAAO,IAAI,OAAO,aAAa,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YACtF,QAAQ,CAAC,IAAI,CAAC,oCAAoC,aAAa,CAAC,kBAAkB,8CAA8C,CAAC,CAAC;QACpI,CAAC;QAED,6FAA6F;QAC7F,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,YAAY;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpD,KAAK,MAAM,CAAC,IAAI,QAAQ,IAAI,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAY,CAAC,CAAC;QACjE,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE;YACxD,QAAQ,EAAE,cAAc;YACxB,aAAa,EAAE,OAAO;YACtB,YAAY;YACZ,SAAS;SACV,CAAC,CAAC;QACH,6FAA6F;QAC7F,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YACzE,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,aAAa,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxH,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,OAAO,IAAI,CACT;YACE,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,cAAc,EAAE,eAAe;YAC/B,UAAU,EAAE,aAAa,EAAE;YAC3B,SAAS,EAAE,UAAU;YACrB,WAAW,EAAE,OAAO,CAAC,IAAI;YACzB,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,YAAY,EAAE,OAAO,CAAC,GAAG;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,aAAa,EAAE,OAAO,IAAI,IAAI;YAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAE,aAAa;gBACjB,CAAC,CAAC;oBACE,kBAAkB,EAAE,aAAa,CAAC,kBAAkB,IAAI,IAAI;oBAC5D,KAAK,EAAE,aAAa,CAAC,KAAK,IAAI,IAAI;oBAClC,SAAS,EAAE,aAAa,CAAC,SAAS,IAAI,IAAI;iBAC3C;gBACH,CAAC,CAAC,IAAI;YACR,qBAAqB,EAAE,cAAc;YACrC,QAAQ;SACT,EACD,WAAW,OAAO,CAAC,EAAE,sBAAsB,eAAe,KAAK,UAAU,qDAAqD;YAC5H,gBAAgB,OAAO,CAAC,IAAI,SAAS,QAAQ,CAAC,MAAM,KAAK;YACzD,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;YACtF,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,2BAA2B,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1G,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACrD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"startSession.js","sourceRoot":"","sources":["../../src/tools/startSession.ts"],"names":[],"mappings":"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"}

package/dist/tools/suite.js

@@ -1,7 +1,7 @@
-// Per-run suite generation cores (roadmap §6 / §7 / §12) + qa_flow_compile.
+// Per-run suite generation cores + qa_flow_compile.
 //
 // These turn the actions recorded during a session (qa_act) into a MAINTAINABLE POM suite under
-// .swipium/ — page objects (selectors), tests (reference elements by name), a suite, a test-case
+// .swipium/: page objects (selectors), tests (reference elements by name), a suite, a test-case
 // catalog, and a locator audit. The generation entry points (page objects, full suite, test-case
 // catalog) are exposed through qa_generate (src/tools/generate.ts); this file registers only
 // qa_flow_compile, which compiles a generated POM suite into runnable Flow V2 for qa_flow_run.
@@ -9,7 +9,8 @@ import { z } from 'zod';
 import { createHash } from 'node:crypto';
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
-import { qaOk, qaError } from '../lib/result.js';
+import { qaOk, qaError, unknownSessionError } from '../lib/result.js';
+import { resolveProjectRoot, unresolvedProjectRootError } from '../context/projectRoot.js';
 import { requireConsent, consumeConsent } from '../consent/consent.js';
 import { generatePom } from '../suite/pom.js';
 import { generateTestCases } from '../suite/testcase.js';
@@ -18,10 +19,11 @@ import { parseFlow } from '../flows/schema.js';
 import { runFlow } from '../flows/run.js';
 import { loadProjectConfig } from '../cli/scan.js';
 import { generateAndCompileSuite } from '../services/suiteGenerate.js';
+import { assertNoSecretLeaks, findSecretLeaks, inputBindings, secretSafeNotes, structuralLiterals } from '../suite/secretGuard.js';
 import { getDriver } from '../session/attach.js';
 import { readinessForSession } from '../report/readiness.js';
 import { loadStateProfile, prepareStateProfile, teardownStateProfile, verifyStateProfile } from '../state/profile.js';
-import { hasStateProfileMutation, stateProfileAffects, stateRisk } from './state.js';
+import { hasStateProfileMutation, stateProfileAffects, stateRisk } from '../state/consent.js';
 function stable(value) {
     if (Array.isArray(value))
         return value.map(stable);
@@ -61,7 +63,7 @@ function compiledFlowIdentity(c) {
 function appIdOf(session) {
     return session.appId ?? loadProjectConfig(session.root)?.appId ?? undefined;
 }
-/** Map the replay outcome to the test-case catalog's replay status (Deliverable 4 — honest plumbing). */
+/** Map the replay outcome to the test-case catalog's replay status (Deliverable 4, honest plumbing). */
 function catalogReplayStatus(mode, results, passed) {
     if (mode === 'none' || results.length === 0)
         return 'not_replayed';
@@ -84,6 +86,7 @@ function suiteDir(session) {
 }
 /** Write generated files under .swipium/, returning absolute paths written. */
 function writeFiles(session, files) {
+    assertNoSecretLeaks(files, session.secrets, 'suite generation', { structural: structuralLiterals(session.recordedActions) }); // backstop: never write a secret
     const base = suiteDir(session);
     const written = [];
     for (const f of files) {
@@ -94,12 +97,29 @@ function writeFiles(session, files) {
     }
     return written;
 }
+/** Loud refusal when generated files would carry a registered secret value (nothing is written). */
+function secretLeakError(session, files) {
+    const leaks = findSecretLeaks(files, session.secrets, { structural: structuralLiterals(session.recordedActions) });
+    if (!leaks.length)
+        return null;
+    return qaError({
+        what: `Not generated: a registered secret value would be written in plaintext (${leaks
+            .slice(0, 5)
+            .map((l) => `${l.path}:${l.line}`)
+            .join(', ')})`,
+        changedState: false,
+        retrySafe: false,
+        failureCode: 'SECRET_IN_GENERATED_OUTPUT',
+        nextSteps: ['Nothing was written. Re-record the credential step so it is captured as a ${VAR}, then regenerate.'],
+    });
+}
 function requireActions(session) {
     if (!session.recordedActions.length) {
         return qaError({
             what: 'No actions recorded in this session yet',
             changedState: false,
             retrySafe: true,
+            failureCode: 'NO_RECORDED_ACTIONS',
             nextSteps: ['Drive the app with qa_act first (each action is recorded), then regenerate the suite.'],
         });
     }
@@ -108,47 +128,54 @@ function requireActions(session) {
 function pomFor(session, name) {
     const appId = appIdOf(session);
     const flowName = (name ?? `${(appId ?? 'app').split('.').pop()}-smoke`).replace(/[^\w.-]+/g, '-');
-    const pom = generatePom(session.recordedActions, { name: flowName, appId, budgetProfile: session.budgetProfile });
+    const pom = generatePom(session.recordedActions, {
+        name: flowName,
+        appId,
+        budgetProfile: session.budgetProfile,
+        secrets: session.secrets,
+        inputs: inputBindings(session), // typed text equal to a stored input maps to its ${SWIPIUM_TEST_*} placeholder
+    });
     return { pom, flowName };
 }
-/** Core handler for qa_generate target:"pom" — page objects + locator audit from recorded actions. */
+/** Core handler for qa_generate target:"pom": page objects + locator audit from recorded actions. */
 export async function runPomGenerate(sessions, { sessionId, name, save }) {
     const session = sessions.get(sessionId);
     if (!session)
-        return qaError({
-            what: `Unknown sessionId ${sessionId}`,
-            changedState: false,
-            retrySafe: true,
-            nextSteps: ['Call qa_start_session first.'],
-        });
+        return unknownSessionError(sessionId);
     const noActions = requireActions(session);
     if (noActions)
         return noActions;
     const { pom } = pomFor(session, name);
     const pageFiles = pom.files.filter((f) => f.path.startsWith('pages/') || f.path.startsWith('locators/'));
+    const pomLeak = secretLeakError(session, pageFiles);
+    if (pomLeak)
+        return pomLeak;
     const written = save ? writeFiles(session, pageFiles) : [];
     const summary = `Generated ${pom.pages.length} page object(s): ${pom.pages.map((p) => p.name).join(', ')}\n` +
         `locator audit: ${pom.audit.durable} durable / ${pom.audit.semi} semi / ${pom.audit.brittle} brittle (${pom.audit.brittlePct}% brittle)` +
-        (save ? `\nsaved ${written.length} files under .swipium/` : `\n(not saved — pass save:true)`);
+        (save ? `\nsaved ${written.length} files under .swipium/` : `\n(not saved; pass save:true)`);
     return qaOk({ pages: pom.pages, audit: pom.audit, files: pageFiles, written }, summary);
 }
 /**
- * Core handler for qa_generate target:"suite" — the full per-run .swipium/ suite from recorded
+ * Core handler for qa_generate target:"suite": the full per-run .swipium/ suite from recorded
  * actions: pages + tests + suite + test cases + locator audit, plus compile and replay gates.
  */
 export async function runSuiteGenerate(sessions, { sessionId, name, save, compile, replay, stateProfile, consentId, approve }) {
     const session = sessions.get(sessionId);
     if (!session)
-        return qaError({
-            what: `Unknown sessionId ${sessionId}`,
-            changedState: false,
-            retrySafe: true,
-            nextSteps: ['Call qa_start_session first.'],
-        });
+        return unknownSessionError(sessionId);
     const noActions = requireActions(session);
     if (noActions)
         return noActions;
     const res = generateAndCompileSuite(sessions, session, { name, save: save !== false, compile: compile !== false });
+    if (res.failureCode)
+        return qaError({
+            what: `Suite not generated: ${res.skippedReason}`,
+            changedState: false,
+            retrySafe: false,
+            failureCode: 'SECRET_IN_GENERATED_OUTPUT',
+            nextSteps: [res.recommendation ?? 'Re-record the credential step so it is captured as a ${VAR}, then regenerate.'],
+        });
     const audit = res.audit;
     const ranOk = res.compiledFlows.filter((c) => c.ok).length;
     const replayMode = replay ?? 'dry_run';
@@ -381,7 +408,7 @@ export async function runSuiteGenerate(sessions, { sessionId, name, save, compil
             const tc = generateTestCases(pom, {
                 appId: appIdOf(session),
                 fixtures: session.fixtures,
-                notes: session.notes,
+                notes: secretSafeNotes(session.notes, session.secrets),
                 budgetProfile: session.budgetProfile,
                 replayStatus,
             });
@@ -395,12 +422,12 @@ export async function runSuiteGenerate(sessions, { sessionId, name, save, compil
     const summary = `✅ Suite "${res.name}" generated (${res.pages?.length ?? 0} pages, ${res.testCases?.length ?? 0} test case, suite + audit).\n` +
         `durability: ${audit.durable} durable / ${audit.semi} semi / ${audit.brittle} brittle (${audit.brittlePct}% brittle)` +
         (res.variables?.length ? `\nvariables: ${res.variables.join(', ')}` : '') +
-        (audit.brittle ? `\n⚠ ${audit.brittle} brittle locator(s) — see locators/locator-audit.json for app-code fixes.` : '') +
-        (written.length ? `\nwrote ${written.length} files under ${suiteDir(session)}` : `\n(preview — pass save:true to write)`) +
+        (audit.brittle ? `\n⚠ ${audit.brittle} brittle locator(s), see locators/locator-audit.json for app-code fixes.` : '') +
+        (written.length ? `\nwrote ${written.length} files under ${suiteDir(session)}` : `\n(preview; pass save:true to write)`) +
         (res.compiledFlows.length
-            ? `\ncompiled ${ranOk}/${res.compiledFlows.length} runnable flow(s) → run: swipium suite run (or qa_flow_run).`
+            ? `\ncompiled ${ranOk}/${res.compiledFlows.length} runnable flow(s) > run: swipium suite run (or qa_flow_run).`
             : `\nNext: qa_flow_compile to produce runnable Flow V2.`) +
-        `\nreplay gate (${replayMode}): ${replayPassed ? 'passed' : replayResults.length ? 'not proven' : 'not run'}; readiness=${readiness}; labels=${readinessLabels.join(' → ')}` +
+        `\nreplay gate (${replayMode}): ${replayPassed ? 'passed' : replayResults.length ? 'not proven' : 'not run'}; readiness=${readiness}; labels=${readinessLabels.join(' > ')}` +
         (ciReady
             ? '\nci_ready: compiled + fresh-state replay + state evidence proved'
             : replayMode === 'fresh_state'
@@ -426,16 +453,11 @@ export async function runSuiteGenerate(sessions, { sessionId, name, save, compil
         ciReadyGate,
     }, summary);
 }
-/** Core handler for qa_generate target:"testcases" — industry-style test case catalog from recorded actions. */
+/** Core handler for qa_generate target:"testcases": industry-style test case catalog from recorded actions. */
 export async function runTestcaseGenerate(sessions, { sessionId, name, format, save }) {
     const session = sessions.get(sessionId);
     if (!session)
-        return qaError({
-            what: `Unknown sessionId ${sessionId}`,
-            changedState: false,
-            retrySafe: true,
-            nextSteps: ['Call qa_start_session first.'],
-        });
+        return unknownSessionError(sessionId);
     const noActions = requireActions(session);
     if (noActions)
         return noActions;
@@ -443,7 +465,7 @@ export async function runTestcaseGenerate(sessions, { sessionId, name, format, s
     const tc = generateTestCases(pom, {
         appId: appIdOf(session),
         fixtures: session.fixtures,
-        notes: session.notes,
+        notes: secretSafeNotes(session.notes, session.secrets),
         budgetProfile: session.budgetProfile,
     });
     const fmt = format ?? 'both';
@@ -452,6 +474,9 @@ export async function runTestcaseGenerate(sessions, { sessionId, name, format, s
         files.push({ path: `testcases/${flowName}.cases.yaml`, content: tc.yaml });
     if (fmt !== 'yaml')
         files.push({ path: `testcases/${flowName}.cases.md`, content: tc.markdown });
+    const tcLeak = secretLeakError(session, files);
+    if (tcLeak)
+        return tcLeak;
     const written = save ? writeFiles(session, files) : [];
     const summary = `Generated ${tc.cases.length} test case(s): ${tc.cases.map((c) => `${c.id} ${c.title}`).join('; ')}` +
         (written.length ? `\nsaved under .swipium/testcases` : '');
@@ -461,19 +486,23 @@ export function registerSuite(server, sessions) {
     // ---- qa_flow_compile ----
     server.registerTool('qa_flow_compile', {
         title: 'Compile a POM suite to runnable flows',
-        description: 'Compile a generated POM suite (.swipium/suites/<suite>.yaml → its POM tests) into Flow V2 YAML that qa_flow_run and `swipium ci` can execute. Resolves page-object element refs to selectors, carries variables/secrets, and writes runnable flows to .swipium/flows/ (+ a readable copy under .swipium/compiled/). Validates each compiled flow through parseFlow and reports any errors. This is the step that makes a generated suite runnable, not just documentation.',
+        description: 'Compile an existing POM suite on disk (.swipium/suites/<suite>.yaml, e.g. committed or hand-edited) into runnable Flow V2 ' +
+            'for qa_flow_run: resolves page-object refs to selectors, carries variables, writes .swipium/flows/<slug>.yaml (+ a copy ' +
+            'under .swipium/compiled/), and validates each flow. Needs no session or recorded actions; qa_generate target:"suite" ' +
+            'already compiles the suite it generates from a run.',
         inputSchema: {
             sessionId: z.string().optional(),
             projectRoot: z.string().optional(),
             suite: z.string().optional().describe('Suite file relative to .swipium/ (default suites/smoke.yaml).'),
         },
     }, async ({ sessionId, projectRoot, suite }) => {
-        let root;
-        if (sessionId)
-            root = sessions.get(sessionId)?.root;
-        root = root ?? projectRoot;
-        if (!root)
-            return qaError({ what: 'No project root', changedState: false, retrySafe: true, nextSteps: ['Pass sessionId or projectRoot.'] });
+        let root = sessionId ? sessions.get(sessionId)?.root : undefined;
+        if (!root) {
+            const resolved = await resolveProjectRoot(server, projectRoot);
+            if (!resolved.root)
+                return unresolvedProjectRootError(resolved);
+            root = resolved.root;
+        }
         const result = compileSuite(root, suite ?? 'suites/smoke.yaml');
         if (result.errors.length && result.flows.length === 0) {
             return qaError({
@@ -494,7 +523,7 @@ export function registerSuite(server, sessions) {
             let flowPath;
             let compiledPath;
             if (ok) {
-                flowPath = join(flowsDir, `${slug}.yaml`); // discoverable by `swipium ci --flow <slug>`
+                flowPath = join(flowsDir, `${slug}.yaml`); // discoverable by qa_flow_run flow:"<slug>"
                 compiledPath = join(compiledDir, `${slug}.flow.yaml`);
                 writeFileSync(flowPath, f.yaml);
                 writeFileSync(compiledPath, f.yaml);
@@ -504,7 +533,7 @@ export function registerSuite(server, sessions) {
         const okCount = compiled.filter((c) => c.ok).length;
         const summary = `Compiled ${okCount}/${compiled.length} flow(s) from ${result.suite}.\n` +
             compiled
-                .map((c) => `  ${c.ok ? '✓' : '✗'} ${c.name}${c.ok ? ` → flows/${c.slug}.yaml (run: swipium ci --flow ${c.slug})` : `: ${c.errors.join('; ')}`}`)
+                .map((c) => `  ${c.ok ? '✓' : '✗'} ${c.name}${c.ok ? ` > flows/${c.slug}.yaml (run: qa_flow_run flow:"${c.slug}")` : `: ${c.errors.join('; ')}`}`)
                 .join('\n');
         return qaOk({ suite: result.suite, flows: compiled, okCount }, summary);
     });