staysfixed 0.11.0 → 0.12.0

package/src/v2/init.js

@@ -1522,14 +1522,20 @@ export function configText(project) {
   const androidHere = android?.adapter === 'android';
   w('  // ───────────────────────────────────────────────────────────────────────');
   w('  // Android apps. Installed on an emulator of its own, walked, then removed.');
-  w('  // Compared against the stored record — whether two emulator snapshots come');
-  w('  // back byte for byte is unproven, and a run says which mode it used.');
+  w('  // Compared against the stored record, or paired if you name the old build.');
+  w('  // A snapshot restore was measured on 2026-08-31 and repeats: 301 of 309');
+  w("  // addresses agreed across five pairs, and the eight that moved were the app's");
+  w('  // own identity code, which the wobble subtraction already removes.');
   w('  // ───────────────────────────────────────────────────────────────────────');
   w(androidHere ? '  android: {' : '  // android: {');
   const andOn = androidHere ? '    ' : '  //   ';
   const apk = android?.suggest?.apk;
   w(`${andOn}// The built package. Left out, it looks in the usual build folders.`);
   w(apk ? `${andOn}apk: ${JSON.stringify(String(apk))},` : `${andOn}// apk: 'app/build/outputs/apk/debug/app-debug.apk',`);
+  w(`${andOn}// A kept copy of the OLD build's package, so a paired run has two builds to compare.`);
+  w(`${andOn}// A checkout of the old commit contains no APK — an APK is a build output — so`);
+  w(`${andOn}// without this a paired run falls back to the stored record and says so.`);
+  w(`${andOn}// reference: 'builds/0.14.0.apk',`);
   w(`${andOn}// Which emulator to use. Left out, it takes the first one that is not a Play Store image.`);
   w(`${andOn}// avd: 'Pixel_7_API_35',`);
   w(`${andOn}// Or a device already plugged in or already running.`);
@@ -1577,6 +1583,10 @@ export function configText(project) {
   w(`${iosOn}// The built app bundle for the simulator. Left out, it looks where builds land.`);
   w(iosApp ? `${iosOn}app: ${JSON.stringify(String(iosApp))},` : `${iosOn}// app: 'build/Debug-iphonesimulator/YourApp.app',`);
   w(`${iosOn}// Which simulator to use, and which system to run it on. Left out, it takes a sensible`);
+  w(`${iosOn}// A kept copy of the OLD build's bundle, so a paired run has two builds to compare.`);
+  w(`${iosOn}// A checkout of the old commit contains no .app — a bundle is a build output — so`);
+  w(`${iosOn}// without this a paired run falls back to the stored record and says so.`);
+  w(`${iosOn}// reference: 'builds/0.14.0.app',`);
   w(`${iosOn}// one and says which.`);
   w(`${iosOn}// deviceType: 'iPhone 17', runtime: 'iOS 26.4',`);
   w(`${iosOn}// Walks through the app. Left out, it opens the app and reads the first screen.`);
@@ -1893,7 +1903,15 @@ export async function run(ctx) {
   const others = (result.plan?.readiness ?? [])
     .map((/** @type {any} */ r) => String(r.product ?? ''))
     .filter((/** @type {string} */ n, /** @type {number} */ i, /** @type {string[]} */ all) => n !== '' && all.indexOf(n) === i);
-  if (result.written.length > 0) ok(`Written: ${result.written.map((f) => shortPath(f)).join(', ')}`);
+  if (result.written.length > 0) {
+    ok(`Written: ${result.written.map((f) => shortPath(f)).join(', ')}`);
+    // Worth one line, because of what happens if it is not done. These files are part of the
+    // build now: until they are committed the working tree is not what git has, so the first
+    // reference gets cut from a tree that has no commit of its own — and a later check cannot
+    // put that build back on the machine to walk it live. It falls back to the stored record,
+    // says so, and is weaker for it. One `git add` avoids the whole thing.
+    say('Commit them before you ship. Settings that are not committed leave the first reference tied to a build git does not have, and a later check can then only compare against the record rather than running the old build live.');
+  }
   if (others.length > 1) {
     warn(
       `Those settings describe ONE product. ${others.length} were found here (${others.join(', ')}), and the others are not covered by this file. ` +

package/src/v2/journeys/index.js

@@ -33,7 +33,7 @@ import path from 'node:path';
 import { measureWobble } from '../observation.js';
 import { journeysFromCode } from './from-routes.js';
 import { DEFAULT_HARVEST_BUDGET_MS, harvestJourneys, testsNear } from './from-suite.js';
-import { loadJourneyFolder, whatWillNotReplay } from './record.js';
+import { RECORDINGS_DIR, loadJourneyFolder, whatWillNotReplay } from './record.js';
 
 /** @typedef {import('../types.js').Journey} Journey */
 /** @typedef {import('../types.js').JourneySource} JourneySource */
@@ -47,7 +47,7 @@ import { loadJourneyFolder, whatWillNotReplay } from './record.js';
 
 export { journeysFromCode, journeysFromDoors, irreversibility } from './from-routes.js';
 export { detectRunner, harvestJourneys, listTestFiles, testsNear, DEFAULT_HARVEST_BUDGET_MS } from './from-suite.js';
-export { startRecording, recordSession, saveJourneys, loadJourneys, loadJourneyFolder, redact } from './record.js';
+export { startRecording, recordSession, saveJourneys, loadJourneys, loadJourneyFolder, redact, RECORDINGS_DIR } from './record.js';
 
 /**
  * A journey with everything this folder knows about where it came from.
@@ -508,7 +508,7 @@ export async function gather(opts) {
 
   // ---- recorded sessions ---------------------------------------------------
   if (opts.recorded !== false) {
-    const dir = opts.recorded?.dir ?? path.join(root, '.staysfixed', 'journeys');
+    const dir = opts.recorded?.dir ?? path.join(root, RECORDINGS_DIR);
     const loaded = await loadJourneyFolder(dir);
     for (const journey of loaded.journeys) {
       const willNotReplay = whatWillNotReplay(journey);