mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-04 03:57:09 +00:00
feat(sample-app): ledger spec parity (#18)
* feat(sample-app): add FocusTracker * feat(sample-app): support description on TextInput * feat(sample-app): support description on AppButton and Segmented * feat(sample-app): stable ids on login screen * feat(sample-app): stable ids on add-account screen * feat(sample-app): stable ids on add-transaction screen * feat(sample-app): stable ids on home and ledger screens * feat(sample-app): hoist error + form state into UiState * feat(sample-app): register auth_status + accounts snapshots * feat(sample-app): register ledger_rows + ledger_balance snapshots * feat(sample-app): register error + focused_input snapshots * refactor(sample-app): scaffold spec.ts extractors + safety * feat(sample-app): spec accounting invariants * feat(sample-app): spec state-machine monotonicity * feat(sample-app): spec liveness properties * feat(sample-app): spec auth + account action generators * feat(sample-app): spec transaction action generators * feat(sample-app): spec weighted workflow * feat(sample-app): publish login form input snapshots * feat(sample-app): publish account + txn input snapshots * feat(sample-app): register form input snapshots * fix(sample-app): sequence login + idempotent text inputs in spec * fix(sample-app): clear UiState on page dispose * fix(sample-app): tighten adversarial login, allow retype on error * test(verifier): update sample-app spec integration for new selectors * feat(sidecar): clear focused field before InputText types * refactor(sample-app): simplify loginHelper to focus-driven sequencing * refactor(sample-app): drop input-value UiState mirrors * refactor(sample-app): drop input-value snapshot registrations * test(verifier): adjust sample-app integration for replace-on-type
This commit is contained in:
13 files changed
+718
-120
No files matched your search
+394
-59
@@ -14,89 +14,424 @@ import {
|
||||
waitOnce,
|
||||
weighted,
|
||||
} from "@uatu/spec";
|
||||
import { noUncaughtExceptions } from "@uatu/spec/defaults/properties";
|
||||
import { noLogcatErrors, noUncaughtExceptions } from "@uatu/spec/defaults/properties";
|
||||
|
||||
interface AccountSnapshot {
|
||||
id: string;
|
||||
name: string;
|
||||
balance: number;
|
||||
txnCount: number;
|
||||
}
|
||||
|
||||
interface LedgerRow {
|
||||
id: string;
|
||||
accountId: string;
|
||||
type: "credit" | "debit";
|
||||
amount: number;
|
||||
signed: number;
|
||||
}
|
||||
|
||||
// ── Snapshot extractors (fed by SampleApplication.kt) ──────────
|
||||
const loggedIn = extract<boolean>(
|
||||
(state) => (state.snapshots.logged_in as boolean) ?? false,
|
||||
);
|
||||
const authStatus = extract<string>(
|
||||
(state) => (state.snapshots.auth_status as string) ?? "",
|
||||
);
|
||||
const route = extract<string>(
|
||||
(state) => (state.snapshots.route as string) ?? "",
|
||||
);
|
||||
const accounts = extract<AccountSnapshot[]>(
|
||||
(state) => (state.snapshots.accounts as AccountSnapshot[]) ?? [],
|
||||
);
|
||||
const totalBalance = extract<number>(
|
||||
(state) => (state.snapshots.total_balance as number) ?? 0,
|
||||
);
|
||||
const accountCount = extract<number>(
|
||||
(state) => (state.snapshots.account_count as number) ?? 0,
|
||||
);
|
||||
const activeAccountId = extract<string | null>(
|
||||
(state) => (state.snapshots.active_account_id as string | null) ?? null,
|
||||
);
|
||||
const ledgerRows = extract<LedgerRow[]>(
|
||||
(state) => (state.snapshots.ledger_rows as LedgerRow[]) ?? [],
|
||||
);
|
||||
const ledgerBalance = extract<number>(
|
||||
(state) => (state.snapshots.ledger_balance as number) ?? 0,
|
||||
);
|
||||
const focusedInput = extract<string | null>(
|
||||
(state) => (state.snapshots.focused_input as string | null) ?? null,
|
||||
);
|
||||
const txnFormType = extract<string | null>(
|
||||
(state) => (state.snapshots.txn_form_type as string | null) ?? null,
|
||||
);
|
||||
const txnFormAccountId = extract<string | null>(
|
||||
(state) => (state.snapshots.txn_form_account_id as string | null) ?? null,
|
||||
);
|
||||
const loginError = extract<string>(
|
||||
(state) => (state.snapshots.login_error as string) ?? "",
|
||||
);
|
||||
const addAccountError = extract<string>(
|
||||
(state) => (state.snapshots.add_account_error as string) ?? "",
|
||||
);
|
||||
const txnError = extract<string>(
|
||||
(state) => (state.snapshots.txn_error as string) ?? "",
|
||||
);
|
||||
const loginEmailField = extract((state) => state.ax.find("desc:login_email"));
|
||||
const loginPasswordField = extract((state) => state.ax.find("desc:login_password"));
|
||||
const loginSubmitButton = extract((state) => state.ax.find("desc:login_submit"));
|
||||
const addAccountButton = extract((state) => state.ax.find("desc:add_account_button"));
|
||||
const logoutButton = extract((state) => state.ax.find("desc:logout_button"));
|
||||
const accountNameField = extract((state) => state.ax.find("desc:account_name_field"));
|
||||
const addAccountSubmit = extract((state) => state.ax.find("desc:add_account_submit"));
|
||||
const addTxnButton = extract((state) => state.ax.find("desc:add_txn_button"));
|
||||
const txnAmountField = extract((state) => state.ax.find("desc:txn_amount"));
|
||||
const txnNoteField = extract((state) => state.ax.find("desc:txn_note"));
|
||||
const txnCredit = extract((state) => state.ax.find("desc:txn_credit"));
|
||||
const txnDebit = extract((state) => state.ax.find("desc:txn_debit"));
|
||||
const txnSubmit = extract((state) => state.ax.find("desc:txn_submit"));
|
||||
const backButton = extract((state) => state.ax.find("desc:Back"));
|
||||
const anyAccountCard = extract((state) => state.ax.find("descPrefix:account_card:"));
|
||||
|
||||
// ── UI elements ────────────────────────────────────────────────
|
||||
const phoneField = extract((state) => state.ax.find("desc:phone_field"));
|
||||
const continueButton = extract((state) => state.ax.find("text:Continue"));
|
||||
const addAccountButton = extract((state) => state.ax.find("text:Add account"));
|
||||
const nameField = extract((state) => state.ax.find("desc:account_name"));
|
||||
const createButton = extract((state) => state.ax.find("text:Create"));
|
||||
|
||||
// ── Properties ─────────────────────────────────────────────────
|
||||
// accountCountNonNegative: the trivial safety property.
|
||||
const accountCountNonNegative = always(() => accountCount.current >= 0);
|
||||
|
||||
// addAccountAdvances: once we land on add-account, the next step must be on
|
||||
// a different screen. Exercises now(x).implies(next(y)).
|
||||
const addAccountAdvances = always(
|
||||
now(() => route.current === "add-account").implies(
|
||||
next(() => route.current !== "add-account"),
|
||||
const onHome = () => route.current === "home";
|
||||
const onLedger = () =>
|
||||
route.current === "ledger" || route.current === "add-transaction";
|
||||
const isInteger = (n: number) => Number.isFinite(n) && Math.floor(n) === n;
|
||||
|
||||
const totalBalanceMatchesAccounts = always(
|
||||
now(onHome).implies(
|
||||
now(() => {
|
||||
const sum = accounts.current.reduce((acc, a) => acc + a.balance, 0);
|
||||
return sum === totalBalance.current;
|
||||
}),
|
||||
),
|
||||
);
|
||||
|
||||
// eventuallyLoggedIn: within 30 seconds of the run starting, we expect to
|
||||
// reach home. Exercises eventually(p).within(n, unit).
|
||||
const eventuallyLoggedIn = eventually(() => loggedIn.current).within(
|
||||
30,
|
||||
"seconds",
|
||||
const ledgerBalanceMatchesRows = always(
|
||||
now(onLedger).implies(
|
||||
now(() => {
|
||||
const sum = ledgerRows.current.reduce((acc, r) => acc + r.signed, 0);
|
||||
return sum === ledgerBalance.current;
|
||||
}),
|
||||
),
|
||||
);
|
||||
|
||||
const ledgerRowsWellFormed = always(() => {
|
||||
for (const row of ledgerRows.current) {
|
||||
if (row.type !== "credit" && row.type !== "debit") return false;
|
||||
if (!(row.amount > 0)) return false;
|
||||
const expected = row.type === "credit" ? row.amount : -row.amount;
|
||||
if (row.signed !== expected) return false;
|
||||
}
|
||||
return true;
|
||||
});
|
||||
|
||||
const balancesAreIntegerCents = always(() => {
|
||||
if (!isInteger(totalBalance.current)) return false;
|
||||
if (!isInteger(ledgerBalance.current)) return false;
|
||||
for (const a of accounts.current) if (!isInteger(a.balance)) return false;
|
||||
for (const r of ledgerRows.current) {
|
||||
if (!isInteger(r.amount) || !isInteger(r.signed)) return false;
|
||||
}
|
||||
return true;
|
||||
});
|
||||
|
||||
const accountCountMatchesList = always(
|
||||
() => accountCount.current === accounts.current.length,
|
||||
);
|
||||
|
||||
const ledgerCountMatchesRows = always(
|
||||
now(onLedger).implies(
|
||||
now(() => {
|
||||
const active = activeAccountId.current;
|
||||
if (active === null) return true;
|
||||
const fromAccounts = accounts.current.find((a) => a.id === active);
|
||||
if (!fromAccounts) return true;
|
||||
return fromAccounts.txnCount === ledgerRows.current.length;
|
||||
}),
|
||||
),
|
||||
);
|
||||
|
||||
const zeroTxnsMeansZeroBalance = always(() => {
|
||||
for (const a of accounts.current) {
|
||||
if (a.txnCount === 0 && a.balance !== 0) return false;
|
||||
}
|
||||
return true;
|
||||
});
|
||||
|
||||
const noOrphanTransactions = always(() => {
|
||||
const active = activeAccountId.current;
|
||||
if (active === null) return ledgerRows.current.length === 0;
|
||||
return ledgerRows.current.every((r) => r.accountId === active);
|
||||
});
|
||||
|
||||
const uniqueAccountNames = always(() => {
|
||||
const seen = new Set<string>();
|
||||
for (const a of accounts.current) {
|
||||
const key = a.name.trim().toLowerCase();
|
||||
if (seen.has(key)) return false;
|
||||
seen.add(key);
|
||||
}
|
||||
return true;
|
||||
});
|
||||
|
||||
const accountingInvariants = {
|
||||
totalBalanceMatchesAccounts,
|
||||
ledgerBalanceMatchesRows,
|
||||
ledgerRowsWellFormed,
|
||||
balancesAreIntegerCents,
|
||||
accountCountMatchesList,
|
||||
ledgerCountMatchesRows,
|
||||
zeroTxnsMeansZeroBalance,
|
||||
noOrphanTransactions,
|
||||
uniqueAccountNames,
|
||||
};
|
||||
|
||||
const accountsOnlyGrow = always(
|
||||
now(() => true).implies(
|
||||
next(() => accounts.current.length >= (accounts.previous?.length ?? 0)),
|
||||
),
|
||||
);
|
||||
|
||||
const ledgerOnlyGrowsPerAccount = always(
|
||||
now(() => activeAccountId.current !== null).implies(
|
||||
next(() => {
|
||||
if (activeAccountId.current !== activeAccountId.previous) return true;
|
||||
return ledgerRows.current.length >= (ledgerRows.previous?.length ?? 0);
|
||||
}),
|
||||
),
|
||||
);
|
||||
|
||||
const authStatusIsKnown = always(
|
||||
() => authStatus.current === "logged-in" || authStatus.current === "logged-out",
|
||||
);
|
||||
|
||||
const routeIsKnown = always(() => {
|
||||
const r = route.current;
|
||||
return (
|
||||
r === "login" ||
|
||||
r === "home" ||
|
||||
r === "add-account" ||
|
||||
r === "ledger" ||
|
||||
r === "add-transaction"
|
||||
);
|
||||
});
|
||||
|
||||
const loggedInLeavesLogin = always(
|
||||
now(() => loggedIn.current).implies(
|
||||
eventually(() => route.current !== "login").within(3, "seconds"),
|
||||
),
|
||||
);
|
||||
|
||||
const loggedOutReachesLogin = always(
|
||||
now(() => !loggedIn.current).implies(
|
||||
eventually(() => route.current === "login").within(3, "seconds"),
|
||||
),
|
||||
);
|
||||
|
||||
const stateMachine = {
|
||||
accountsOnlyGrow,
|
||||
ledgerOnlyGrowsPerAccount,
|
||||
authStatusIsKnown,
|
||||
routeIsKnown,
|
||||
loggedInLeavesLogin,
|
||||
loggedOutReachesLogin,
|
||||
};
|
||||
|
||||
const loginReachable = eventually(() => loggedIn.current).within(90, "seconds");
|
||||
const accountCreationReachable = eventually(
|
||||
() => accounts.current.length > 0,
|
||||
).within(180, "seconds");
|
||||
const someTransactionExists = eventually(() =>
|
||||
accounts.current.some((a) => a.txnCount > 0),
|
||||
).within(300, "seconds");
|
||||
|
||||
const loginErrorClears = always(
|
||||
now(() => loginError.current !== "").implies(
|
||||
eventually(() => loginError.current === "").within(30, "seconds"),
|
||||
),
|
||||
);
|
||||
const addAccountErrorClears = always(
|
||||
now(() => addAccountError.current !== "").implies(
|
||||
eventually(() => addAccountError.current === "").within(30, "seconds"),
|
||||
),
|
||||
);
|
||||
const txnErrorClears = always(
|
||||
now(() => txnError.current !== "").implies(
|
||||
eventually(() => txnError.current === "").within(30, "seconds"),
|
||||
),
|
||||
);
|
||||
|
||||
const liveness = {
|
||||
loginReachable,
|
||||
accountCreationReachable,
|
||||
someTransactionExists,
|
||||
loginErrorClears,
|
||||
addAccountErrorClears,
|
||||
txnErrorClears,
|
||||
};
|
||||
|
||||
const DEMO_EMAIL = "[email protected]";
|
||||
const DEMO_PASSWORD = "ledger123";
|
||||
|
||||
const loginHelper = actions(() => {
|
||||
if (loggedIn.current) return [];
|
||||
const focus = focusedInput.current;
|
||||
const email = loginEmailField.current;
|
||||
const password = loginPasswordField.current;
|
||||
const submit = loginSubmitButton.current;
|
||||
|
||||
if (focus === "login_password") {
|
||||
return submit ? [Tap({ on: submit })] : [];
|
||||
}
|
||||
if (focus === "login_email") {
|
||||
return password ? [InputText({ into: password, text: DEMO_PASSWORD })] : [];
|
||||
}
|
||||
return email ? [InputText({ into: email, text: DEMO_EMAIL })] : [];
|
||||
});
|
||||
|
||||
const adversarialLogin = actions(() => {
|
||||
if (loggedIn.current) return [];
|
||||
if (focusedInput.current !== null) return [];
|
||||
const submit = loginSubmitButton.current;
|
||||
if (!submit) return [];
|
||||
return [Tap({ on: submit })];
|
||||
});
|
||||
|
||||
const accountNameSampler = from([
|
||||
"Checking",
|
||||
"Savings",
|
||||
"Travel",
|
||||
"Rent",
|
||||
"Emergency Fund",
|
||||
"Investments",
|
||||
"Groceries",
|
||||
" ",
|
||||
"Checking",
|
||||
"A".repeat(41),
|
||||
"Petty Cash",
|
||||
]);
|
||||
|
||||
const typeAccountName = actions(() => {
|
||||
if (route.current !== "add-account") return [];
|
||||
const field = accountNameField.current;
|
||||
if (!field) return [];
|
||||
return [InputText({ into: field, text: accountNameSampler.generate() })];
|
||||
});
|
||||
|
||||
const submitAddAccount = actions(() => {
|
||||
if (route.current !== "add-account") return [];
|
||||
const submit = addAccountSubmit.current;
|
||||
return submit ? [Tap({ on: submit })] : [];
|
||||
});
|
||||
|
||||
const openAddAccount = actions(() => {
|
||||
if (route.current !== "home") return [];
|
||||
const button = addAccountButton.current;
|
||||
return button ? [Tap({ on: button })] : [];
|
||||
});
|
||||
|
||||
const openRandomAccount = actions(() => {
|
||||
if (route.current !== "home") return [];
|
||||
const card = anyAccountCard.current;
|
||||
return card ? [Tap({ on: card })] : [];
|
||||
});
|
||||
|
||||
const logoutAction = actions(() => {
|
||||
if (route.current !== "home") return [];
|
||||
const button = logoutButton.current;
|
||||
return button ? [Tap({ on: button })] : [];
|
||||
});
|
||||
|
||||
const goBack = actions(() => {
|
||||
const button = backButton.current;
|
||||
return button ? [Tap({ on: button })] : [];
|
||||
});
|
||||
|
||||
const amountSampler = from([
|
||||
"12.34",
|
||||
"100",
|
||||
"0.01",
|
||||
"999.99",
|
||||
"5.5",
|
||||
"42",
|
||||
"0",
|
||||
"",
|
||||
"1e4",
|
||||
"0.001",
|
||||
"-5",
|
||||
]);
|
||||
|
||||
const typeAmount = actions(() => {
|
||||
if (route.current !== "add-transaction") return [];
|
||||
const field = txnAmountField.current;
|
||||
if (!field) return [];
|
||||
return [InputText({ into: field, text: amountSampler.generate() })];
|
||||
});
|
||||
|
||||
const noteSampler = from([
|
||||
"Coffee",
|
||||
"Paycheck",
|
||||
"Gas",
|
||||
"Refund",
|
||||
"",
|
||||
"Groceries for the week",
|
||||
]);
|
||||
|
||||
const typeNote = actions(() => {
|
||||
if (route.current !== "add-transaction") return [];
|
||||
const field = txnNoteField.current;
|
||||
if (!field) return [];
|
||||
return [InputText({ into: field, text: noteSampler.generate() })];
|
||||
});
|
||||
|
||||
const toggleTxnType = actions(() => {
|
||||
if (route.current !== "add-transaction") return [];
|
||||
const current = txnFormType.current;
|
||||
const target = current === "credit" ? txnDebit.current : txnCredit.current;
|
||||
return target ? [Tap({ on: target })] : [];
|
||||
});
|
||||
|
||||
const submitTxn = actions(() => {
|
||||
if (route.current !== "add-transaction") return [];
|
||||
const submit = txnSubmit.current;
|
||||
return submit ? [Tap({ on: submit })] : [];
|
||||
});
|
||||
|
||||
const openAddTxn = actions(() => {
|
||||
if (route.current !== "ledger") return [];
|
||||
const button = addTxnButton.current;
|
||||
return button ? [Tap({ on: button })] : [];
|
||||
});
|
||||
|
||||
export const properties = {
|
||||
accountCountNonNegative,
|
||||
addAccountAdvances,
|
||||
eventuallyLoggedIn,
|
||||
...accountingInvariants,
|
||||
...stateMachine,
|
||||
...liveness,
|
||||
noUncaughtExceptions,
|
||||
noLogcatErrors,
|
||||
};
|
||||
|
||||
// ── Actions ────────────────────────────────────────────────────
|
||||
// Sampling: random phone numbers for the login screen.
|
||||
const phoneSampler = from(["+919876543210", "+15555550100", "+442071234567"]);
|
||||
|
||||
const typePhone = actions(() => {
|
||||
const field = phoneField.current;
|
||||
if (!field) return [];
|
||||
return [InputText({ into: field, text: phoneSampler.generate() })];
|
||||
});
|
||||
|
||||
const tapContinue = actions(() =>
|
||||
continueButton.current ? [Tap({ on: continueButton.current })] : [],
|
||||
);
|
||||
const tapAddAccount = actions(() =>
|
||||
addAccountButton.current ? [Tap({ on: addAccountButton.current })] : [],
|
||||
);
|
||||
|
||||
const nameSampler = from(["Alice", "Bob", "Charlie", "Dana"]);
|
||||
const fillName = actions(() => {
|
||||
const field = nameField.current;
|
||||
if (!field) return [];
|
||||
return [InputText({ into: field, text: nameSampler.generate() })];
|
||||
});
|
||||
const tapCreate = actions(() =>
|
||||
createButton.current ? [Tap({ on: createButton.current })] : [],
|
||||
);
|
||||
|
||||
export const actionsRoot = weighted(
|
||||
[30, typePhone],
|
||||
[30, tapContinue],
|
||||
[20, tapAddAccount],
|
||||
[20, fillName],
|
||||
[20, tapCreate],
|
||||
[10, taps],
|
||||
[5, swipes],
|
||||
[5, waitOnce],
|
||||
[5, pressKey],
|
||||
[30, loginHelper],
|
||||
[2, adversarialLogin],
|
||||
[18, typeAccountName],
|
||||
[14, submitAddAccount],
|
||||
[18, typeAmount],
|
||||
[8, typeNote],
|
||||
[6, toggleTxnType],
|
||||
[16, submitTxn],
|
||||
[14, openAddAccount],
|
||||
[14, openRandomAccount],
|
||||
[12, openAddTxn],
|
||||
[6, goBack],
|
||||
[1, logoutAction],
|
||||
[4, taps],
|
||||
[2, swipes],
|
||||
[2, waitOnce],
|
||||
[2, pressKey],
|
||||
);
|
||||
|
||||
(globalThis as { actions?: unknown; properties?: unknown }).actions = actionsRoot;
|
||||
|
||||
Reference in new issue
Block a user