@stim-cli/ci 1.36.0 → 1.37.0

package/README.md

@@ -36,6 +36,22 @@ device with `STIM_NO_RECORDED_BUILD`, and the failure's `remedy` names the comma
 to run first, such as `stim-ci build --platform ios --scheme App`. `build` and
 `run` must use the same Stim home: pass the same `--home`, or keep the default.
 
+Every iOS and Android `run` on this machine starts the app from clean state on
+the workspace's own simulator or emulator, including when the device already
+has this build.
+Before it installs, `run` uninstalls every other user app except XCUITest
+runner apps, such as the ones agent-device installs. On iOS it also clears the
+app's defaults and data container and resets the simulator keychain; on Android
+it runs `pm clear` on the app. Simulator-wide settings such as privacy grants
+are kept. A local simulator or emulator Stim does not own refuses with
+`STIM_BAD_ARG` instead of skipping the cleanup. A run that `ios.remote` or
+`android.remote` places on another machine or on EAS is not cleaned, and a
+physical device is refused. `build` always compiles on this machine and ignores
+`remote.build`. By default it compiles an iOS app, and an Android Debug app,
+for this machine's architecture only, so when `run` can land on another
+machine or on EAS, build
+for that device too with `--arch all` (iOS) or `--abi all` (Android).
+
 `--eas-profile <name>` (iOS and Android, build only) downloads a completed EAS
 development build instead of compiling, as `stim ios --eas-profile` does; `run`
 then installs it. Stim never starts an EAS build.

package/dist/{cli-BhFWDeM1.mjs → cli-BCFk6LoD.mjs}

@@ -1,4 +1,4 @@
-import { n as buildCI, t as runCI } from "./src-Gwd9CN7Z.mjs";
+import { n as buildCI, t as runCI } from "./src-CFd6F73i.mjs";
 import { parseArgs } from "node:util";
 //#region src/cli.ts
 const HELP = `Usage: stim-ci build --platform <ios|android|macos> [options]
@@ -131,7 +131,7 @@ function parse(argv) {
 }
 async function main(argv = process.argv.slice(2)) {
 	if (argv.length === 1 && argv[0] === "--version") {
-		process.stdout.write(`1.36.0\n`);
+		process.stdout.write(`1.37.0\n`);
 		return;
 	}
 	if (argv.length === 0 || argv[0] === "--help" || (argv[0] === "run" || argv[0] === "build") && argv[1] === "--help") {

package/dist/index.d.mts

@@ -22,9 +22,10 @@ interface CommandResult {
 }
 //#endregion
 //#region src/build.d.ts
-type WithoutSignal<T> = T extends unknown ? Omit<T, "signal"> : never;
+type WithoutKeys$1<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
 interface CIBuildOptions extends CIContextOptions {
-  build: WithoutSignal<StimBuildOptions>;
+  /** Always compiles on this machine; `remoteBuild` is not accepted. */
+  build: WithoutKeys$1<StimBuildOptions, "signal" | "remoteBuild">;
   /** Also writes the app here as a portable APK (Android) or tar.gz (iOS, macOS); without it the build is only recorded for `run`. */
   exportPath?: string;
 }
@@ -56,7 +57,7 @@ declare function buildCI(input: CIBuildOptions): Promise<CIBuildResult>;
 type WithoutKeys<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
 interface CIOptions extends CIContextOptions {
   /** Selectors of the recorded build to run. `run` never builds, so build-time options such as `easProfile` belong to `buildCI`. */
-  run: WithoutKeys<StimRunOptions, "signal" | "recordedBuild" | "easProfile">;
+  run: WithoutKeys<StimRunOptions, "signal" | "recordedBuild" | "cleanAppState" | "easProfile">;
   command: readonly [string, ...string[]];
 }
 interface CIFailure {

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { n as buildCI, t as runCI } from "./src-Gwd9CN7Z.mjs";
+import { n as buildCI, t as runCI } from "./src-CFd6F73i.mjs";
 export { buildCI, runCI };

package/dist/{src-Gwd9CN7Z.mjs → src-CFd6F73i.mjs}

@@ -201,6 +201,7 @@ async function buildCI(input) {
 		attempted = true;
 		result.build = await stim.build({
 			...options.build,
+			remoteBuild: "local",
 			signal
 		});
 		signal?.throwIfAborted();
@@ -341,6 +342,7 @@ async function runCI(options) {
 		result.run = await stim.run({
 			...options.run,
 			recordedBuild: true,
+			cleanAppState: true,
 			signal
 		});
 		signal?.throwIfAborted();

package/dist/stim-ci.mjs

@@ -6,6 +6,6 @@ const minor = parts[1] ?? 0;
 if (major < 22 || major === 22 && minor < 12) {
 	process.stderr.write(`stim-ci requires Node.js 22.12.0 or later; this is ${process.versions.node}.\n`);
 	process.exitCode = 1;
-} else import("./cli-BhFWDeM1.mjs").then(({ main }) => main());
+} else import("./cli-BCFk6LoD.mjs").then(({ main }) => main());
 //#endregion
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stim-cli/ci",
-  "version": "1.36.0",
+  "version": "1.37.0",
   "description": "Build Stim app artifacts or run Stim apps and test commands in CI with diagnostics and scoped cleanup.",
   "license": "MIT",
   "repository": {
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "cross-spawn": "^7.0.6",
-    "stim": "1.36.0"
+    "stim": "1.37.0"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6"