swipium 1.4.0 → 2.0.0

package/dist/build/plan.js

@@ -1,4 +1,4 @@
-// Build-from-source planner (roadmap §4.5) — propose the EXACT commands that turn a source
+// Build-from-source planner: propose the EXACT commands that turn a source
 // project into an installable artifact, per framework + platform, with prerequisites
 // (dependency install, Expo prebuild, CocoaPods) and the artifact globs the build will produce.
 //
@@ -14,11 +14,7 @@ function hasFile(root, ...rel) {
 }
 /** Pick the package manager from lockfiles (npm default). */
 function nodeInstallStep(root) {
-    const pm = existsSync(join(root, 'pnpm-lock.yaml'))
-        ? 'pnpm'
-        : existsSync(join(root, 'yarn.lock'))
-            ? 'yarn'
-            : 'npm';
+    const pm = existsSync(join(root, 'pnpm-lock.yaml')) ? 'pnpm' : existsSync(join(root, 'yarn.lock')) ? 'yarn' : 'npm';
     const argv = pm === 'npm' ? ['npm', 'install'] : [pm, 'install'];
     return { label: 'install JS dependencies', command: argv.join(' '), argv, cwd: root, optionalIfPresent: 'node_modules' };
 }
@@ -51,14 +47,14 @@ function xcodebuildStep(root, variant) {
     const { workspace, project, scheme, dir } = iosWorkspace(root);
     const notes = [];
     if (!scheme)
-        return { step: null, notes: ['Could not find an .xcworkspace/.xcodeproj — pass the scheme/workspace explicitly.'] };
+        return { step: null, notes: ['Could not find an .xcworkspace/.xcodeproj. Pass the scheme/workspace explicitly.'] };
     const config = variant === 'release' ? 'Release' : 'Debug';
     const argv = ['xcodebuild', '-scheme', scheme, '-sdk', 'iphonesimulator', '-configuration', config, '-derivedDataPath', 'build', 'build'];
     if (workspace)
         argv.splice(1, 0, '-workspace', basename(workspace));
     else if (project)
         argv.splice(1, 0, '-project', basename(project));
-    notes.push(`Using scheme "${scheme}" (best-effort) — override if your scheme differs.`);
+    notes.push(`Using scheme "${scheme}" (best-effort). Override if your scheme differs.`);
     return { step: { label: 'build iOS simulator app', command: argv.join(' '), argv, cwd: dir }, notes };
 }
 /**
@@ -72,8 +68,16 @@ export async function buildPlan(opts) {
     const prerequisites = [];
     const missingToolchain = [];
     const base = (over = {}) => ({
-        framework, platform, variant, prerequisites, build: null,
-        expectedArtifactGlobs: [], toolchainOk: missingToolchain.length === 0, missingToolchain, notes, ...over,
+        framework,
+        platform,
+        variant,
+        prerequisites,
+        build: null,
+        expectedArtifactGlobs: [],
+        toolchainOk: missingToolchain.length === 0,
+        missingToolchain,
+        notes,
+        ...over,
     });
     if (framework === 'unknown') {
         return base({ failureCode: 'UNSUPPORTED_FRAMEWORK', notes: ['No supported mobile framework detected at this root.'] });
@@ -88,17 +92,23 @@ export async function buildPlan(opts) {
         const gradleArg = variant === 'release' ? 'assembleRelease' : 'assembleDebug';
         switch (framework) {
             case 'expo': {
-                // No native android dir → expo run:android prebuilds; otherwise it reuses it.
+                // No native android dir: expo run:android prebuilds; otherwise it reuses it.
                 if (!hasFile(root, 'android'))
-                    notes.push('No android/ directory — expo run:android will prebuild it (EXPO_PREBUILD).');
+                    notes.push('No android/ directory, so expo run:android will prebuild it (EXPO_PREBUILD).');
                 notes.push('Expo Android local run compiles native code, installs the app, and starts Metro. First run can take several minutes; later JS/TS-only work should usually reuse the installed development build with Metro.');
                 const argv = ['npx', 'expo', 'run:android', '--variant', variant];
-                return base({ build: { label: 'Expo Android local run', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: apkGlobs });
+                return base({
+                    build: { label: 'Expo Android local run', command: argv.join(' '), argv, cwd: root },
+                    expectedArtifactGlobs: apkGlobs,
+                });
             }
             case 'bare-react-native':
             case 'native-android': {
                 if (!hasFile(root, 'android/gradlew', 'gradlew')) {
-                    return base({ failureCode: 'BUILD_COMMAND_UNAVAILABLE', notes: ['No gradlew found — run from the Android project or add the Gradle wrapper.'] });
+                    return base({
+                        failureCode: 'BUILD_COMMAND_UNAVAILABLE',
+                        notes: ['No gradlew found. Run from the Android project or add the Gradle wrapper.'],
+                    });
                 }
                 const cwd = existsSync(join(root, 'android')) ? join(root, 'android') : root;
                 const argv = ['./gradlew', gradleArg];
@@ -109,7 +119,11 @@ export async function buildPlan(opts) {
                     missingToolchain.push('flutter');
                 prerequisites.unshift({ label: 'flutter pub get', command: 'flutter pub get', argv: ['flutter', 'pub', 'get'], cwd: root });
                 const argv = ['flutter', 'build', 'apk', `--${variant}`];
-                return base({ build: { label: 'flutter build apk', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: flutterGlobs, toolchainOk: missingToolchain.length === 0 });
+                return base({
+                    build: { label: 'flutter build apk', command: argv.join(' '), argv, cwd: root },
+                    expectedArtifactGlobs: flutterGlobs,
+                    toolchainOk: missingToolchain.length === 0,
+                });
             }
             default:
                 return base({ failureCode: 'BUILD_COMMAND_UNAVAILABLE' });
@@ -122,9 +136,12 @@ export async function buildPlan(opts) {
     switch (framework) {
         case 'expo': {
             if (!hasFile(root, 'ios'))
-                notes.push('No ios/ directory — expo run:ios will prebuild it (EXPO_PREBUILD).');
+                notes.push('No ios/ directory, so expo run:ios will prebuild it (EXPO_PREBUILD).');
             const argv = ['npx', 'expo', 'run:ios', '--no-bundler'];
-            return base({ build: { label: 'build + run iOS simulator (Expo)', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: appGlobs });
+            return base({
+                build: { label: 'build + run iOS simulator (Expo)', command: argv.join(' '), argv, cwd: root },
+                expectedArtifactGlobs: appGlobs,
+            });
         }
         case 'bare-react-native':
         case 'native-ios': {
@@ -142,7 +159,11 @@ export async function buildPlan(opts) {
                 missingToolchain.push('flutter');
             prerequisites.unshift({ label: 'flutter pub get', command: 'flutter pub get', argv: ['flutter', 'pub', 'get'], cwd: root });
             const argv = ['flutter', 'build', 'ios', '--simulator', `--${variant}`];
-            return base({ build: { label: 'flutter build ios --simulator', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: ['build/ios/iphonesimulator/*.app'], toolchainOk: missingToolchain.length === 0 });
+            return base({
+                build: { label: 'flutter build ios --simulator', command: argv.join(' '), argv, cwd: root },
+                expectedArtifactGlobs: ['build/ios/iphonesimulator/*.app'],
+                toolchainOk: missingToolchain.length === 0,
+            });
         }
         default:
             return base({ failureCode: 'BUILD_COMMAND_UNAVAILABLE' });

package/dist/build/plan.js.map

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

package/dist/ci/preflight.js

@@ -1,5 +1,5 @@
 import { ciMutationAllowed } from '../report/policy.js';
-const MUTATING_CI_STEPS = new Set(['networkOffline', 'networkOnline', 'seed', 'restartApp']);
+import { flowEnvAllowed, isMutatingFlowStep } from '../flows/schema.js';
 const VAR_REF = /\$\{([^}]+)\}/g;
 function variableBearingValues(step) {
     switch (step.kind) {
@@ -28,13 +28,16 @@ export function ciMutatingSteps(flow) {
     const all = [...flow.setup, ...flow.steps, ...flow.teardown];
     const out = [];
     all.forEach((step, i) => {
-        if (!MUTATING_CI_STEPS.has(step.kind))
+        // Same rule as qa_flow_run consent / qa_smoke: includes an openUrl that interpolates ${VAR}.
+        if (!isMutatingFlowStep(step))
             return;
         out.push({
             flow: flow.name,
             step: i + 1,
             kind: step.kind,
-            reason: `${step.kind} changes device/app/test state and requires .swipium/policy.json ciAllowMutations`,
+            reason: step.kind === 'openUrl'
+                ? 'openUrl interpolates a ${VAR} into a URL that leaves the device and requires .swipium/policy.json ciAllowMutations ("openUrl")'
+                : `${step.kind} changes device/app/test state and requires .swipium/policy.json ciAllowMutations`,
         });
     });
     return out;
@@ -54,7 +57,9 @@ export function ciRequiredVariables(flow) {
                     step: i + 1,
                     kind: step.kind,
                     variable: match[1],
-                    reason: `${step.kind} references \${${match[1]}}; set it in the CI environment before running Swipium.`,
+                    reason: flowEnvAllowed(match[1])
+                        ? `${step.kind} references \${${match[1]}}; set it in the CI environment before running Swipium.`
+                        : `${step.kind} references \${${match[1]}}; flows read only SWIPIUM_* environment variables. Rename it (e.g. SWIPIUM_${match[1]}) or pass it as an explicit variable.`,
                 });
             }
         }
@@ -68,6 +73,10 @@ export function validateCiVariables(flows, env = process.env, variables = {}) {
         const explicit = variables[v.variable];
         if (explicit != null && explicit !== '')
             return false;
+        // The flow runner reads the environment only for SWIPIUM_* names, so any other env var
+        // does not satisfy the requirement (it would still be missing at run time).
+        if (!flowEnvAllowed(v.variable))
+            return true;
         return env[v.variable] == null || env[v.variable] === '';
     });
     return { ok: missing.length === 0, missing };

package/dist/ci/preflight.js.map

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

package/dist/cli/gc.js

@@ -0,0 +1,74 @@
+// `swipium gc [--dry-run] [--days N] [--keep N]`: reclaim disk from old ~/.swipium/runs session dirs
+// (same rule as the automatic startup prune in src/session/retention.ts) and compact
+// ~/.swipium/projects.json (drop entries whose project root no longer exists, cap to 200).
+//
+// CLI path, not the MCP server, so writing to stdout is fine here.
+import { pruneSessionRuns, retentionDaysFromEnv, retentionKeepFromEnv, DEFAULT_RETENTION_DAYS } from '../session/retention.js';
+import { compactProjectRegistry } from '../appMap/projectRegistry.js';
+export const GC_USAGE = `Usage: swipium gc [--dry-run] [--days N] [--keep N]
+  Delete ~/.swipium/runs session dirs older than N days (default: SWIPIUM_RETENTION_DAYS or 30) that
+  are not in ~/.swipium/registry.json, keeping the newest --keep (default: SWIPIUM_RETENTION_KEEP or 20)
+  per project regardless of age; prune ~/.swipium/projects.json entries whose root no longer exists.
+  --dry-run   report what would be reclaimed, delete nothing
+`;
+export function parseGcArgs(argv, env = process.env) {
+    const out = { dryRun: false, days: retentionDaysFromEnv(env) ?? DEFAULT_RETENTION_DAYS, keep: retentionKeepFromEnv(env) };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--dry-run' || a === '-n')
+            out.dryRun = true;
+        else if (a === '--help' || a === '-h')
+            out.help = true;
+        else if (a === '--days' || a === '--keep' || a.startsWith('--days=') || a.startsWith('--keep=')) {
+            const [flag, inline] = a.split('=', 2);
+            const raw = inline ?? argv[++i];
+            const n = Number(raw);
+            if (raw == null || !Number.isInteger(n) || n < 0) {
+                out.error = `${flag} expects a non-negative integer (got ${raw ?? 'nothing'})`;
+                return out;
+            }
+            if (flag === '--days')
+                out.days = n;
+            else
+                out.keep = n;
+        }
+        else {
+            out.error = `unknown option ${a}`;
+            return out;
+        }
+    }
+    return out;
+}
+export function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    if (n < 1024 * 1024 * 1024)
+        return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(n / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+/** Run gc; returns the process exit code. */
+export async function runGc(argv, out = (s) => void process.stdout.write(s)) {
+    const args = parseGcArgs(argv);
+    if (args.help) {
+        out(GC_USAGE);
+        return 0;
+    }
+    if (args.error) {
+        process.stderr.write(`swipium gc: ${args.error}\n\n${GC_USAGE}`);
+        return 2;
+    }
+    const r = await pruneSessionRuns({ days: args.days, keepPerProject: args.keep, dryRun: args.dryRun });
+    const projects = compactProjectRegistry({ dryRun: args.dryRun });
+    const verb = args.dryRun ? 'would delete' : 'deleted';
+    out(`swipium gc${args.dryRun ? ' (dry run)' : ''}: scanned ${r.scanned} session dir(s) under ${r.runsDir}\n` +
+        `  ${verb} ${r.deleted.length} session dir(s) older than ${r.days} day(s) (not registered; newest ${r.keepPerProject} per project kept)\n` +
+        `  ${args.dryRun ? 'reclaimable' : 'reclaimed'}: ${formatBytes(r.bytesReclaimed)}\n` +
+        `  projects.json: ${projects.before} > ${projects.after} entr${projects.after === 1 ? 'y' : 'ies'}` +
+        `${projects.removed ? ` (${projects.removed} stale ${args.dryRun ? 'would be ' : ''}removed)` : ''}\n` +
+        (r.skipped ? `  prune skipped: ${r.skipped}\n` : '') +
+        (r.errors ? `  ${r.errors} entr${r.errors === 1 ? 'y' : 'ies'} could not be processed (see logs)\n` : ''));
+    return 0;
+}
+//# sourceMappingURL=gc.js.map

package/dist/cli/gc.js.map

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

package/dist/cli/init.js

@@ -1,34 +1,171 @@
-// `swipium init <client> [--apply] [--scope project|user|local]`
+// `swipium init <client> [--apply] [--scope project|user|local] [--cwd <dir>]`
 //
 // Default = PREVIEW the exact registration (safe, no mutation). `--apply` executes it by
-// DELEGATING to the client's own CLI where one exists (claude/gemini `mcp add`), or writing
-// Codex's config.toml (it has no `mcp add` + a history of silent config-load bugs). After a
-// successful apply it runs `verify` (the server starts + tools inject).
+// DELEGATING to the client's own CLI where that is the documented path (claude/gemini
+// `mcp add`), writing Codex's ~/.codex/config.toml (so the block carries cwd + timeouts, which
+// `codex mcp add` cannot set), or merging a project file for Cursor (.cursor/mcp.json) and
+// VS Code (.vscode/mcp.json). After a successful apply it runs `verify` (the server starts +
+// tools inject).
 //
-// NOTE: this is the CLI path, not the MCP server — writing to stdout is fine here.
+// Portability: anything that lands in a TEAM-SHARED project file (`claude --scope project`,
+// gemini project scope, .cursor/.vscode) uses `npx -y swipium`, never this machine's absolute
+// node/script paths. Absolute paths are used only for machine-local registrations
+// (claude local/user, gemini user, codex), and even then not when this process runs from the
+// npx cache (that path is ephemeral).
+//
+// NOTE: this is the CLI path, not the MCP server, so writing to stdout is fine here.
 import { spawnSync } from 'node:child_process';
-import { existsSync, readFileSync, appendFileSync, mkdirSync } from 'node:fs';
+import { existsSync, readFileSync, appendFileSync, mkdirSync, writeFileSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { dirname, resolve, join } from 'node:path';
 import { runVerify } from './verify.js';
 import { initFlowTemplates } from '../flows/templates.js';
 const SELF = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'index.js'); // dist/index.js
+export const PORTABLE_COMMAND = { command: 'npx', args: ['-y', 'swipium'] };
+/** True when `self` lives in npm's npx cache (…/_npx/…). An absolute path to it would rot. */
+export function isEphemeralInstall(self = SELF) {
+    return self.split(/[\\/]/).includes('_npx');
+}
+/** The command a client should run: portable `npx -y swipium`, or this machine's node + script. */
+export function serverCommand(portable, node = process.execPath, self = SELF) {
+    if (portable || isEphemeralInstall(self))
+        return { command: PORTABLE_COMMAND.command, args: [...PORTABLE_COMMAND.args] };
+    return { command: node, args: [self] };
+}
 /** A delegated CLI registration succeeded only if it both ran and exited 0. */
 export function applyOk(r) {
     return !r.error && r.status === 0;
 }
-function geminiBlock(node) {
-    return `  "swipium": { "command": ${JSON.stringify(node)}, "args": [${JSON.stringify(SELF)}], "cwd": "<your repo>", "timeout": 600000 }`;
+/** Gemini settings.json entry (user scope: machine-local command + the app repo as cwd). */
+export function geminiBlock(node, cwd, self = SELF) {
+    const c = serverCommand(false, node, self);
+    return `  "swipium": { "command": ${JSON.stringify(c.command)}, "args": ${JSON.stringify(c.args)}, "cwd": ${JSON.stringify(cwd)}, "timeout": 600000 }`;
+}
+/** Codex keeps servers in ~/.codex/config.toml; its defaults (10 s startup, 60 s per tool) are too
+ *  short for `npx` first runs and for device work (builds, boots, flows). */
+export function codexBlock(node, cwd, self = SELF) {
+    const c = serverCommand(false, node, self);
+    return [
+        '[mcp_servers.swipium]',
+        `command = ${JSON.stringify(c.command)}`,
+        `args = [${c.args.map((a) => JSON.stringify(a)).join(', ')}]`,
+        `cwd = ${JSON.stringify(cwd)}`,
+        'startup_timeout_sec = 30',
+        'tool_timeout_sec = 600',
+    ].join('\n');
+}
+/** `claude mcp add` argv. Project scope writes the team-shared .mcp.json, so the command is portable. */
+export function claudeAddArgs(scope, node = process.execPath, self = SELF) {
+    const c = serverCommand(scope === 'project', node, self);
+    return ['mcp', 'add', 'swipium', ...(scope !== 'local' ? ['--scope', scope] : []), '--', c.command, ...c.args];
+}
+/** `gemini mcp add` argv. Gemini's default scope is project (.gemini/settings.json), so it's portable. */
+export function geminiAddArgs(scope, node = process.execPath, self = SELF) {
+    const user = scope === 'user';
+    const c = serverCommand(!user, node, self);
+    // Gemini's parser would read `-y` as its own flag: server args that start with "-" go after `--`
+    // (documented form: `gemini mcp add python-server python server.py -- --server-arg v`).
+    const rest = c.args.some((x) => x.startsWith('-')) ? ['--', ...c.args] : c.args;
+    return ['mcp', 'add', '--scope', user ? 'user' : 'project', 'swipium', c.command, ...rest];
+}
+/** Cursor: .cursor/mcp.json (`mcpServers`). ${workspaceFolder} is interpolated by Cursor. */
+export function cursorEntry() {
+    return {
+        type: 'stdio',
+        command: PORTABLE_COMMAND.command,
+        args: [...PORTABLE_COMMAND.args],
+        env: { SWIPIUM_PROJECT_ROOT: '${workspaceFolder}' },
+    };
+}
+/** VS Code: .vscode/mcp.json uses a top-level `servers` object (not `mcpServers`). */
+export function vscodeEntry() {
+    return {
+        type: 'stdio',
+        command: PORTABLE_COMMAND.command,
+        args: [...PORTABLE_COMMAND.args],
+        env: { SWIPIUM_PROJECT_ROOT: '${workspaceFolder}' },
+    };
+}
+/**
+ * Merge `swipium` into an existing JSON config under `topKey` WITHOUT touching anything else.
+ * Refuses (never overwrites) when the file isn't plain JSON (e.g. JSONC comments) or `topKey`
+ * isn't an object; leaves an existing `swipium` entry as-is.
+ */
+export function mergeServerJson(existing, topKey, entry) {
+    let doc = {};
+    if (existing !== null && existing.trim()) {
+        try {
+            const parsed = JSON.parse(existing);
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+                return { status: 'invalid', reason: 'top level is not a JSON object' };
+            doc = parsed;
+        }
+        catch (e) {
+            return {
+                status: 'invalid',
+                reason: `not valid JSON (${e.message}); comments/trailing commas are not merged automatically`,
+            };
+        }
+    }
+    const cur = doc[topKey];
+    if (cur !== undefined && (typeof cur !== 'object' || cur === null || Array.isArray(cur))) {
+        return { status: 'invalid', reason: `"${topKey}" is not an object` };
+    }
+    const servers = { ...(cur ?? {}) };
+    if (Object.prototype.hasOwnProperty.call(servers, 'swipium'))
+        return { status: 'present' };
+    servers.swipium = entry;
+    return { status: 'added', json: `${JSON.stringify({ ...doc, [topKey]: servers }, null, 2)}\n` };
+}
+/** The app repo the server should run in: `--cwd <dir>` if given, else where init was invoked. */
+export function resolveTargetCwd(args) {
+    const cwdIdx = args.indexOf('--cwd');
+    return resolve(cwdIdx >= 0 ? (args[cwdIdx + 1] ?? '') : process.cwd());
+}
+function isDir(p) {
+    try {
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
 }
-function codexBlock(node) {
-    return `[mcp_servers.swipium]\ncommand = ${JSON.stringify(node)}\nargs = [${JSON.stringify(SELF)}]\ncwd = "<your repo>"`;
+const CWD_NOTE = '(cwd should be your mobile app repo: run init from it, or pass --cwd <dir>)';
+export const INIT_USAGE = 'Usage: swipium init <claude|codex|gemini|cursor|vscode> [--apply] [--scope local|user|project] [--cwd <dir>]\n' +
+    '       swipium init flows [--root <dir>] [--force]\n' +
+    'Without --apply, prints the exact registration and changes nothing.\n';
+/** Preview/apply a project-file registration (Cursor/VS Code). Returns false when refused. */
+function projectFileInit(opts) {
+    const { label, file, topKey, entry, apply } = opts;
+    const snippet = JSON.stringify({ [topKey]: { swipium: entry } }, null, 2);
+    if (!apply) {
+        process.stdout.write(`Preview (run with --apply to merge into ${file}):\n${snippet}\n` +
+            `SWIPIUM_PROJECT_ROOT uses \${workspaceFolder}, which ${label} expands to the open folder.\n` +
+            (opts.extraPreview ?? ''));
+        return true;
+    }
+    const existing = existsSync(file) ? readFileSync(file, 'utf8') : null;
+    const merged = mergeServerJson(existing, topKey, entry);
+    if (merged.status === 'invalid') {
+        process.stdout.write(`Refusing to modify ${file}: ${merged.reason}.\nAdd this under "${topKey}" by hand:\n${snippet}\n`);
+        process.exitCode = 2;
+        return false;
+    }
+    if (merged.status === 'present') {
+        process.stdout.write(`Already present in ${file} (left unchanged).\n`);
+        return true;
+    }
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, merged.json);
+    process.stdout.write(`${existing === null ? 'Created' : 'Merged into'} ${file}\n`);
+    return true;
 }
 export async function runInit(args) {
     const client = (args[0] ?? '').toLowerCase();
     const apply = args.includes('--apply');
     const scopeIdx = args.indexOf('--scope');
-    const scope = scopeIdx >= 0 ? args[scopeIdx + 1] : 'local';
+    const scope = scopeIdx >= 0 ? (args[scopeIdx + 1] ?? 'local') : 'local';
     const node = process.execPath;
     if (client === 'flows') {
         const rootIdx = args.indexOf('--root');
@@ -42,15 +179,33 @@ export async function runInit(args) {
         process.stdout.write('\nNext: edit selectors/variables, then validate with qa_flow_check and run with qa_flow_run from an MCP session.\n');
         return;
     }
-    if (!['claude', 'gemini', 'codex'].includes(client)) {
-        process.stdout.write('Usage: swipium init <claude|gemini|codex> [--apply] [--scope project|user|local]\n       swipium init flows [--root <dir>] [--force]\n');
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(INIT_USAGE);
+        return;
+    }
+    if (!['claude', 'gemini', 'codex', 'cursor', 'vscode'].includes(client)) {
+        process.stdout.write(INIT_USAGE);
+        process.exitCode = 2;
+        return;
+    }
+    if (!['local', 'user', 'project'].includes(scope)) {
+        process.stdout.write(`Unknown --scope "${scope}" (expected local, user, or project).\n${INIT_USAGE}`);
         process.exitCode = 2;
         return;
     }
+    const cwd = resolveTargetCwd(args);
+    const refuseMissingCwd = () => {
+        if (isDir(cwd))
+            return false;
+        process.stdout.write(`Refusing to apply: cwd ${cwd} does not exist. Run init from your mobile app repo or pass --cwd <dir>.\n`);
+        process.exitCode = 2;
+        return true;
+    };
     if (client === 'claude') {
-        const cmd = ['mcp', 'add', 'swipium', ...(scope !== 'local' ? ['--scope', scope] : []), '--', node, SELF];
+        const cmd = claudeAddArgs(scope, node);
+        const shared = scope === 'project' ? '\n(project scope writes .mcp.json for your team, so it uses the portable `npx -y swipium`.)' : '';
         if (apply) {
-            const r = spawnSync('claude', cmd, { stdio: 'inherit' });
+            const r = spawnSync('claude', cmd, { stdio: 'inherit', cwd: isDir(cwd) ? cwd : undefined });
             if (!applyOk(r)) {
                 process.stdout.write(`claude registration failed (status ${r.status ?? 'n/a'}). Run manually:\n  claude ${cmd.join(' ')}\n`);
             }
@@ -60,15 +215,18 @@ export async function runInit(args) {
             }
         }
         else {
-            process.stdout.write(`Preview (run with --apply to execute):\n  claude ${cmd.join(' ')}\n`);
+            process.stdout.write(`Preview (run with --apply to execute):\n  claude ${cmd.join(' ')}${shared}\n`);
         }
     }
     else if (client === 'gemini') {
-        const cmd = ['mcp', 'add', 'swipium', node, SELF];
+        const cmd = geminiAddArgs(scope, node);
+        const manual = scope === 'user'
+            ? `add to ~/.gemini/settings.json under "mcpServers":\n${geminiBlock(node, cwd)}\n${CWD_NOTE}`
+            : `add to ${join(cwd, '.gemini', 'settings.json')} under "mcpServers":\n  "swipium": { "command": "npx", "args": ["-y", "swipium"], "timeout": 600000 }`;
         if (apply) {
-            const r = spawnSync('gemini', cmd, { stdio: 'inherit' });
+            const r = spawnSync('gemini', cmd, { stdio: 'inherit', cwd: isDir(cwd) ? cwd : undefined });
             if (!applyOk(r)) {
-                process.stdout.write(`gemini \`mcp add\` unavailable. Add to ~/.gemini/settings.json under "mcpServers":\n${geminiBlock(node)}\n`);
+                process.stdout.write(`gemini \`mcp add\` failed or unavailable. Instead, ${manual}\n`);
             }
             else {
                 process.stdout.write('\nRegistered. Verifying…\n');
@@ -76,28 +234,61 @@ export async function runInit(args) {
             }
         }
         else {
-            process.stdout.write(`Preview (run with --apply):\n  gemini ${cmd.join(' ')}\nor add to ~/.gemini/settings.json:\n${geminiBlock(node)}\n`);
+            process.stdout.write(`Preview (run with --apply):\n  gemini ${cmd.join(' ')}\nor ${manual}\n`);
         }
     }
-    else {
-        // codex — no `mcp add`; write config.toml (append if absent), then self-verify.
+    else if (client === 'codex') {
+        // Written to config.toml directly (rather than `codex mcp add`) so the block carries cwd and
+        // longer startup/tool timeouts, which `codex mcp add` has no flags for.
         const cfg = join(homedir(), '.codex', 'config.toml');
-        const block = codexBlock(node);
+        const block = codexBlock(node, cwd);
+        const c = serverCommand(false, node);
+        const alt = `  codex mcp add swipium --env SWIPIUM_PROJECT_ROOT=${cwd} -- ${[c.command, ...c.args].join(' ')}\n  (then add startup_timeout_sec = 30 and tool_timeout_sec = 600 under [mcp_servers.swipium] in ${cfg})`;
+        const caveat = '⚠ Codex Desktop threads may not expose tools from custom stdio MCP servers (openai/codex#19425, open). If the tools are missing in the Desktop app, try the Codex CLI.\n';
         if (apply) {
+            if (refuseMissingCwd())
+                return;
             mkdirSync(dirname(cfg), { recursive: true });
             const cur = existsSync(cfg) ? readFileSync(cfg, 'utf8') : '';
             if (cur.includes('[mcp_servers.swipium]')) {
-                process.stdout.write(`Already present in ${cfg}\n`);
+                process.stdout.write(`Already present in ${cfg} (left unchanged). Expected block:\n${block}\n`);
             }
             else {
                 appendFileSync(cfg, `\n${block}\n`);
                 process.stdout.write(`Appended to ${cfg}\n`);
             }
-            process.stdout.write('⚠ Codex has an open tool-injection regression (#19425) on builds after ~0.120.0 — confirm tools actually appear in Codex. Server-side self-check:\n');
+            process.stdout.write(caveat + 'Server-side self-check:\n');
             await runVerify();
         }
         else {
-            process.stdout.write(`Add to ${cfg}:\n${block}\n⚠ Codex has an open tool-injection regression — verify tools appear after adding.\n`);
+            process.stdout.write(`Preview (run with --apply to append to ${cfg}):\n${block}\n${CWD_NOTE}\nor register with the Codex CLI:\n${alt}\n${caveat}`);
+        }
+    }
+    else if (client === 'cursor' || client === 'vscode') {
+        const isCursor = client === 'cursor';
+        if (scope === 'user') {
+            process.stdout.write(`Note: init ${client} only writes the project file (${isCursor ? '.cursor/mcp.json' : '.vscode/mcp.json'}); ` +
+                (isCursor
+                    ? 'for all projects, add the same entry to ~/.cursor/mcp.json.\n'
+                    : 'for your user profile use `code --add-mcp` (shown below).\n'));
+        }
+        if (apply && refuseMissingCwd())
+            return;
+        const ok = projectFileInit({
+            label: isCursor ? 'Cursor' : 'VS Code',
+            file: join(cwd, isCursor ? '.cursor' : '.vscode', 'mcp.json'),
+            topKey: isCursor ? 'mcpServers' : 'servers',
+            entry: isCursor ? cursorEntry() : vscodeEntry(),
+            apply,
+            extraPreview: isCursor
+                ? undefined
+                : `or add it to your VS Code user profile:\n  code --add-mcp '${JSON.stringify({ name: 'swipium', command: 'npx', args: ['-y', 'swipium'] })}'\n`,
+        });
+        if (!ok)
+            return;
+        if (apply) {
+            process.stdout.write(`Reload ${isCursor ? 'Cursor' : 'VS Code'} (or its MCP server list) to start Swipium. Server-side self-check:\n`);
+            await runVerify();
         }
     }
     process.stdout.write('\nSelf-check anytime: swipium verify\n');