From 57bf0830982c5684bc8ad1aada4f8d56d0d48c57 Mon Sep 17 00:00:00 2001
From: Hitakshi Arora <hitakshiarora005@gmail.com>
Date: Sat, 11 Jul 2026 18:16:15 +0530
Subject: [PATCH] chore(console): remove em-dashes from copy and comments

Sweep every em-dash (357 across the app + shared packages): spaced clause
separators become commas, the rest become hyphens. Clears the em-dash tell
from all user-facing copy and keeps the codebase consistent.
---
 apps/console/src/app/NetworkMenu.tsx          |  8 +--
 apps/console/src/app/RootGate.tsx             |  2 +-
 apps/console/src/app/Shell.tsx                |  2 +-
 apps/console/src/app/nav.ts                   |  2 +-
 apps/console/src/demo/api.ts                  |  6 +-
 apps/console/src/demo/data.ts                 |  8 +--
 apps/console/src/lib/copy.ts                  | 12 ++--
 apps/console/src/lib/format.ts                |  8 +--
 apps/console/src/lib/network.ts               |  2 +-
 apps/console/src/lib/store.test.tsx           |  2 +-
 apps/console/src/lib/store.tsx                |  8 +--
 apps/console/src/screens/Approvals.tsx        | 22 +++----
 apps/console/src/screens/AuditLog.tsx         | 24 ++++----
 apps/console/src/screens/Contractors.tsx      | 22 +++----
 apps/console/src/screens/Dashboard.tsx        | 34 +++++------
 apps/console/src/screens/Grants.tsx           | 14 ++---
 apps/console/src/screens/Invoices.tsx         | 18 +++---
 apps/console/src/screens/Pay.tsx              | 14 ++---
 apps/console/src/screens/Settings.tsx         | 44 +++++++-------
 apps/console/src/ui/Logo.tsx                  |  2 +-
 apps/console/src/ui/SendCeremony.test.tsx     |  2 +-
 apps/console/src/ui/SendCeremony.tsx          |  2 +-
 apps/console/src/ui/controls.tsx              |  8 +--
 apps/console/src/ui/primitives.tsx            | 18 +++---
 packages/core/src/account-file.ts             |  2 +-
 packages/core/src/account.test.ts             |  2 +-
 packages/core/src/account.ts                  | 18 +++---
 packages/core/src/client.ts                   | 58 +++++++++----------
 packages/core/src/crypto/bytes.ts             |  2 +-
 packages/core/src/crypto/poseidon2.ts         |  2 +-
 packages/core/src/crypto/random.ts            |  2 +-
 packages/core/src/index.browser.ts            |  2 +-
 packages/core/src/index.ts                    |  2 +-
 packages/core/src/kybcredential.ts            |  4 +-
 packages/core/src/merkle.ts                   |  2 +-
 packages/core/src/mvk-registry.test.ts        |  2 +-
 packages/core/src/mvk-registry.ts             | 10 ++--
 packages/core/src/notes.ts                    | 14 ++---
 packages/core/src/onboard.ts                  |  8 +--
 packages/core/src/org.ts                      | 12 ++--
 packages/core/src/orgauth.ts                  |  4 +-
 packages/core/src/payoutinnocence.ts          |  2 +-
 packages/core/src/payrollcomp.ts              |  4 +-
 packages/core/src/pool.ts                     | 20 +++----
 packages/core/src/prover.ts                   |  8 +--
 packages/core/src/relay.ts                    |  2 +-
 packages/core/src/reserves.ts                 |  6 +-
 packages/core/src/scanner.ts                  | 14 ++---
 packages/core/src/scval.ts                    | 10 ++--
 packages/core/src/spendingcap.ts              |  4 +-
 packages/core/src/stellar-rpc.ts              |  8 +--
 packages/core/src/stellar.ts                  |  6 +-
 packages/core/src/store.ts                    |  2 +-
 packages/core/src/sum.ts                      |  8 +--
 packages/core/src/tx-signer.ts                | 12 ++--
 packages/core/src/viewkeys.ts                 | 10 ++--
 packages/core/src/zklogin.ts                  | 10 ++--
 packages/core/test/circuits.test.ts           | 14 ++---
 packages/core/test/crypto.test.ts             |  2 +-
 packages/core/test/joinsplit-org.test.ts      |  6 +-
 .../core/test/kyc-issuer-integration.test.ts  |  2 +-
 packages/core/test/mvk-registry.test.ts       |  4 +-
 packages/core/test/notekey.test.ts            |  6 +-
 packages/core/test/org-note-spend.test.ts     |  4 +-
 packages/core/test/org-spend-auth.test.ts     |  4 +-
 packages/core/test/parity.test.ts             |  4 +-
 packages/core/test/reserves.test.ts           |  2 +-
 packages/core/test/scanner.test.ts            |  4 +-
 packages/core/test/selectnotes.test.ts        |  2 +-
 packages/core/test/tx-signer.test.ts          |  2 +-
 packages/core/test/wasm.test.ts               |  2 +-
 packages/links/src/index.ts                   | 18 +++---
 packages/types/src/accounts.ts                |  6 +-
 packages/types/src/api.ts                     |  2 +-
 packages/types/src/approvals.ts               |  2 +-
 packages/types/src/common.ts                  |  2 +-
 packages/types/src/compliance.ts              |  8 +--
 packages/types/src/index.ts                   |  2 +-
 packages/types/src/invoices.ts                |  2 +-
 packages/types/src/org.ts                     |  4 +-
 packages/types/src/payments.ts                |  4 +-
 packages/ui/src/balance.ts                    |  2 +-
 packages/ui/src/format.ts                     |  4 +-
 packages/ui/src/hooks.ts                      |  4 +-
 packages/ui/src/index.ts                      |  4 +-
 packages/ui/src/payment-state.ts              |  6 +-
 packages/ui/src/proving-state.ts              |  2 +-
 packages/ui/src/send-sequence.test.ts         |  2 +-
 packages/ui/src/send-sequence.ts              |  6 +-
 packages/ui/src/wallet-state.ts               |  4 +-
 packages/ui/test/format.test.ts               |  2 +-
 91 files changed, 350 insertions(+), 350 deletions(-)

diff --git a/apps/console/src/app/NetworkMenu.tsx b/apps/console/src/app/NetworkMenu.tsx
index 7d68c8b..400b529 100644
--- a/apps/console/src/app/NetworkMenu.tsx
+++ b/apps/console/src/app/NetworkMenu.tsx
@@ -1,5 +1,5 @@
 /**
- * Top-bar network indicator + chain info — **read-only, not a switcher**. Benzo
+ * Top-bar network indicator + chain info, **read-only, not a switcher**. Benzo
  * Console runs on a single chain (the permissioned BenzoNet L1 by default; pinned at
  * build time), so this shows the active network's identity, environment, and details
  * (chain id / RPC / explorer). There is no network selection: the console isn't
@@ -19,7 +19,7 @@ function envToneCls(env: NetworkEnv): string {
     : "border-warning/30 bg-warning/12 text-[#9a6b12]";
 }
 
-/** Explicit environment badge — Testnet / Mainnet / Permissioned L1. */
+/** Explicit environment badge, Testnet / Mainnet / Permissioned L1. */
 function EnvBadge({ env }: { env: NetworkEnv }) {
   return (
     <span className={`flex-none rounded-full border px-1.5 py-px text-[10px] font-semibold uppercase tracking-wide ${envToneCls(env)}`}>
@@ -69,11 +69,11 @@ export function NetworkMenu({ live }: { live: boolean }) {
     };
   }, [open]);
 
-  // Everything is keyed to the single build-time NETWORK — there is no selection.
+  // Everything is keyed to the single build-time NETWORK, there is no selection.
   const info = chainInfo(NETWORK);
   const env = NETWORK_ENV_BY_NETWORK[NETWORK];
   // Chrome by ENVIRONMENT (never by liveness): amber for testnet / permissioned L1,
-  // green only for real-money mainnet. Liveness is a separate axis — a subtle heartbeat
+  // green only for real-money mainnet. Liveness is a separate axis, a subtle heartbeat
   // when connected, a red "Offline · …" when the chain is unreachable.
   const chipTone = live ? envToneCls(env) : "border-danger/30 bg-danger/10 text-[#b4232a]";
   const chipLabel = live ? env.chip : `Offline · ${env.badge}`;
diff --git a/apps/console/src/app/RootGate.tsx b/apps/console/src/app/RootGate.tsx
index b3a1c46..5ead83a 100644
--- a/apps/console/src/app/RootGate.tsx
+++ b/apps/console/src/app/RootGate.tsx
@@ -14,7 +14,7 @@ export function RootGate() {
   const { session, loading, refresh } = useConsole();
   const isDesktop = useIsDesktop();
   // Demo mode skips SIWE onboarding entirely and boots into the Shell (the
-  // desktop-only gate below still applies — this stays a desktop product).
+  // desktop-only gate below still applies, this stays a desktop product).
   const [onboarded, setOnboarded] = useState(() => DEMO_MODE || localStorage.getItem("benzo.console.onboarded") === "1");
   const [orgOnboarding, setOrgOnboarding] = useState(false);
   function finish() {
diff --git a/apps/console/src/app/Shell.tsx b/apps/console/src/app/Shell.tsx
index d17806e..c94abbf 100644
--- a/apps/console/src/app/Shell.tsx
+++ b/apps/console/src/app/Shell.tsx
@@ -157,7 +157,7 @@ export function Shell() {
             <div className="relative flex-none">
               <button
                 onClick={() => setMenu((m) => (m === "bell" ? null : "bell"))}
-                aria-label={pending ? `Notifications — ${pending} awaiting approval` : "Notifications"}
+                aria-label={pending ? `Notifications, ${pending} awaiting approval` : "Notifications"}
                 title={pending ? `${pending} awaiting approval` : "Notifications"}
                 aria-haspopup="menu"
                 aria-expanded={menu === "bell"}
diff --git a/apps/console/src/app/nav.ts b/apps/console/src/app/nav.ts
index 89915ab..5bf802a 100644
--- a/apps/console/src/app/nav.ts
+++ b/apps/console/src/app/nav.ts
@@ -1,5 +1,5 @@
 /**
- * Nav model — the single source of truth for the sidebar + command bar, and which
+ * Nav model, the single source of truth for the sidebar + command bar, and which
  * screens are exposed in each build mode. In **real mode** the console only shows
  * screens that actually talk to the eERC backend (auth/onboarding/treasury/payroll);
  * the rest (Overview, Contractors, Invoices, one-off Pay, Approvals, Grants, Audit,
diff --git a/apps/console/src/demo/api.ts b/apps/console/src/demo/api.ts
index 65fdea1..a135ae6 100644
--- a/apps/console/src/demo/api.ts
+++ b/apps/console/src/demo/api.ts
@@ -1,5 +1,5 @@
 /**
- * Demo api — a drop-in for the real typed `api` client that resolves every read
+ * Demo api, a drop-in for the real typed `api` client that resolves every read
  * against a seeded in-memory org and every write against a mutable copy of it, on
  * realistic timers, with NO network. Swapped in at build time by `VITE_DEMO_MODE=1`
  * (see ../lib/api.ts). Writes mutate the shared `db`, and prove/settle flows return
@@ -50,7 +50,7 @@ let demoMockKyc: { name?: string; country?: string } | undefined;
 // ---- fake-chain helpers ---------------------------------------------------
 function randHex(len: number): string {
   const bytes = new Uint8Array(Math.ceil(len / 2));
-  // Fallback must fill `bytes` IN PLACE — `.map()` returns a fresh array that
+  // Fallback must fill `bytes` IN PLACE, `.map()` returns a fresh array that
   // would be discarded, leaving `bytes` all-zeros (identical output every call).
   const rng = globalThis.crypto ?? {
     getRandomValues: (a: Uint8Array) => {
@@ -556,7 +556,7 @@ export const demoApi = {
     return {
       packet: built,
       integrity: { ok: true, headHash: built.anchor.headHash },
-      disclosure: "Anchored on-chain — only the Merkle root leaves the ciphertext.",
+      disclosure: "Anchored on-chain, only the Merkle root leaves the ciphertext.",
       packetHash: fakeTx(),
       orgHash: fakeTx(),
       anchor: { onChain: true, contractId: fakeVerifier(), txHash, sequence: String(Math.floor(Math.random() * 90000) + 10000), explorer: explorerTxUrl(txHash) },
diff --git a/apps/console/src/demo/data.ts b/apps/console/src/demo/data.ts
index d9afb0d..89b03c2 100644
--- a/apps/console/src/demo/data.ts
+++ b/apps/console/src/demo/data.ts
@@ -1,5 +1,5 @@
 /**
- * Seed data for demo mode — a rich, believable org so every console screen and
+ * Seed data for demo mode, a rich, believable org so every console screen and
  * cinematic has something real to render with zero backend. Pure factory: it
  * returns a fresh, mutable in-memory "db" the demo api reads/writes, so a session
  * feels alive (approvals clear, payroll completes, grants revoke) without a network.
@@ -56,7 +56,7 @@ export interface DemoDb {
   onboardingStatus: OnboardingStatus;
   treasuryProvision: ProvisionTreasuryResponse;
   treasuryDeposits: TreasuryDeposit[];
-  /** Private (shielded) pool total, minor units — grows when "Make private" runs. */
+  /** Private (shielded) pool total, minor units, grows when "Make private" runs. */
   privateTotal: string;
   /** Public liquid USDC balance, minor units. */
   publicUnits: string;
@@ -238,7 +238,7 @@ export function createDemoDb(): DemoDb {
       orgId: ORG_ID,
       number: "INV-2042",
       counterpartyId: "cp_diego",
-      lineItems: [{ description: "Brand system — July milestone", quantity: 1, unitAmount: usd(6200) }],
+      lineItems: [{ description: "Brand system, July milestone", quantity: 1, unitAmount: usd(6200) }],
       total: { amount: usd(6200), assetCode: "USDC" },
       status: "open",
       dueDate: ISO("2026-07-25"),
@@ -321,7 +321,7 @@ export function createDemoDb(): DemoDb {
     { id: "pr_jun", kind: "payroll", title: "June payroll · 5 people", status: "completed", amountLabel: "Private", at: ISO("2026-06-01T12:00:00Z") },
     { id: "po_done_2", kind: "invoice", title: "INV-2039 · Northwind", status: "paid", amountLabel: "$9,800.00", at: ISO("2026-06-28T16:22:00Z") },
     { id: "dep_1", kind: "deposit", title: "Shielded USDC deposit", status: "confirmed", amountLabel: "Private", at: ISO("2026-07-02T09:30:00Z") },
-    { id: "vg_1", kind: "grant", title: "Grant Thornton LLP · Q2", status: "active", amountLabel: "—", at: ISO("2026-07-01T00:00:00Z") },
+    { id: "vg_1", kind: "grant", title: "Grant Thornton LLP · Q2", status: "active", amountLabel: "-", at: ISO("2026-07-01T00:00:00Z") },
   ];
 
   const onboardingStatus: OnboardingStatus = {
diff --git a/apps/console/src/lib/copy.ts b/apps/console/src/lib/copy.ts
index 1523dac..7822f02 100644
--- a/apps/console/src/lib/copy.ts
+++ b/apps/console/src/lib/copy.ts
@@ -1,15 +1,15 @@
 /**
- * Central copy constants — reusable privacy / disclosure wording so every screen
+ * Central copy constants, reusable privacy / disclosure wording so every screen
  * says the same thing the same way. Business language first; cryptographic detail
  * only where it earns its place. Screens adopt these in later waves; exported now so
  * the vocabulary is fixed before the rewrites start.
  *
  * Rule of thumb:
- *  - PRIVACY.privateOnChain — the amount AND recipient are not publicly visible.
- *  - PRIVACY.visibleToWorkspace — authorized teammates can see it in this console.
- *  - PRIVACY.hiddenDueToRole — you personally can't see it (your role, not a failure).
- *  - PRIVACY.disclosedThroughProof — revealed deliberately, backed by an on-chain proof.
- *  - PRIVACY.hideBalances — the screen-level mask toggle label.
+ *  - PRIVACY.privateOnChain, the amount AND recipient are not publicly visible.
+ *  - PRIVACY.visibleToWorkspace, authorized teammates can see it in this console.
+ *  - PRIVACY.hiddenDueToRole, you personally can't see it (your role, not a failure).
+ *  - PRIVACY.disclosedThroughProof, revealed deliberately, backed by an on-chain proof.
+ *  - PRIVACY.hideBalances, the screen-level mask toggle label.
  */
 export const PRIVACY = {
   /** Amount + recipient are not publicly visible on-chain. */
diff --git a/apps/console/src/lib/format.ts b/apps/console/src/lib/format.ts
index 36eb4fe..366848e 100644
--- a/apps/console/src/lib/format.ts
+++ b/apps/console/src/lib/format.ts
@@ -65,10 +65,10 @@ function toDate(ts: number | string | Date): Date | null {
 }
 
 /**
- * Date-only display: "22 Jul 2026" — NO time component. Formatted from the value's
+ * Date-only display: "22 Jul 2026", NO time component. Formatted from the value's
  * UTC calendar day so a date-only value (a due date / expiry stored as midnight UTC)
  * can never leak a spurious local time (the "05:30" IST artifact) or shift a day
- * across timezones. Use this for due dates, expiries, period labels — anything that
+ * across timezones. Use this for due dates, expiries, period labels, anything that
  * is conceptually a day, not an instant.
  */
 export function fmtDate(ts: number | string | Date): string {
@@ -79,7 +79,7 @@ export function fmtDate(ts: number | string | Date): string {
 
 /**
  * Full timestamp display (local): date + time, for genuine instants (posted-at,
- * settled-at). Use this ONLY when the time actually matters — otherwise use fmtDate.
+ * settled-at). Use this ONLY when the time actually matters, otherwise use fmtDate.
  */
 export function fmtDateTime(ts: number | string | Date): string {
   const d = toDate(ts);
@@ -93,7 +93,7 @@ export function formatDate(ts: number | string | Date): string {
 }
 
 /**
- * Person initials for avatars — the ONE shared source so the top-bar avatar and the
+ * Person initials for avatars, the ONE shared source so the top-bar avatar and the
  * Settings/team rows never disagree (the "JE vs JO" bug). Two words → first letter of
  * first + last ("John Everett" → "JE"); one word / an email → first two chars
  * ("jordan@acme.co" → "JO"). Always uppercase.
diff --git a/apps/console/src/lib/network.ts b/apps/console/src/lib/network.ts
index 8316d5c..f59deb8 100644
--- a/apps/console/src/lib/network.ts
+++ b/apps/console/src/lib/network.ts
@@ -28,7 +28,7 @@ export const NETWORK_LABEL_BY_NETWORK = {
 export const NETWORK_LABEL = NETWORK_LABEL_BY_NETWORK[NETWORK];
 
 /**
- * Environment framing for the network chip — a financial-safety signal, not
+ * Environment framing for the network chip, a financial-safety signal, not
  * wording. A testnet must NEVER read as a green "Live"; only real-money mainnet
  * gets the green (`success`) treatment. Testnet and the permissioned L1 are amber
  * (`warning`) so nobody mistakes play money for production. Consumed by the top-bar
diff --git a/apps/console/src/lib/store.test.tsx b/apps/console/src/lib/store.test.tsx
index cf2e503..443d7fd 100644
--- a/apps/console/src/lib/store.test.tsx
+++ b/apps/console/src/lib/store.test.tsx
@@ -119,7 +119,7 @@ describe("ConsoleProvider treasury read model", () => {
   });
 
   it("does not sign out on a transient session failure (stays on the loading screen)", async () => {
-    // A network blip / 5xx / timeout — NOT a 401 — must not strand the session on
+    // A network blip / 5xx / timeout, NOT a 401, must not strand the session on
     // sign-in: no logout, and RootGate keeps showing "Loading workspace…" (loading
     // stays true while session is still null), so the boot retry can recover.
     apiMock.session.mockRejectedValue(new Error("network blip"));
diff --git a/apps/console/src/lib/store.tsx b/apps/console/src/lib/store.tsx
index 21c1043..bbef046 100644
--- a/apps/console/src/lib/store.tsx
+++ b/apps/console/src/lib/store.tsx
@@ -92,7 +92,7 @@ export function ConsoleProvider({ children }: { children: ReactNode }) {
   // Mirror the live session in a ref so refresh()'s catch can tell "we already
   // have a workspace to keep" (a transient failure should stay on the shell) from
   // "the first load hasn't landed yet" (a transient failure should stay on the
-  // loading screen — never the sign-in screen).
+  // loading screen, never the sign-in screen).
   const sessionRef = useRef<AuthSession | null>(null);
 
   const clearReadModels = useCallback(() => {
@@ -137,7 +137,7 @@ export function ConsoleProvider({ children }: { children: ReactNode }) {
         if (sessionRef.current) {
           // Mid-session: keep the workspace and its last-loaded data on screen,
           // just surface a reconnecting note; the boot retry / 30s poll recover.
-          setError("Couldn't refresh — reconnecting…");
+          setError("Couldn't refresh, reconnecting…");
           setLoading(false);
         } else {
           // First load hasn't succeeded yet: stay on the "Loading workspace…"
@@ -195,7 +195,7 @@ export function ConsoleProvider({ children }: { children: ReactNode }) {
   }, [clearReadModels]);
 
   // Switching workspace must reload the org-scoped read models, not just the
-  // label — otherwise the UI shows one workspace's name over another's data.
+  // label, otherwise the UI shows one workspace's name over another's data.
   const setActiveOrg = useCallback((id: string) => {
     setSession((current) => (current ? sessionWithActiveOrg(current, id) : current));
     void refresh();
@@ -242,7 +242,7 @@ export function ConsoleProvider({ children }: { children: ReactNode }) {
   }, []);
 
   // #61: a confirmed 401 (session expired) is signalled by AUTH_REQUIRED_EVENT via
-  // notifyAuthRequired(). This — and an explicit logout (AUTH_CHANGED) — are the
+  // notifyAuthRequired(). This, and an explicit logout (AUTH_CHANGED), are the
   // ONLY things that clear auth in real mode; a transient read failure never fires
   // it, so it can no longer strand a live session on the sign-in screen.
   useEffect(() => {
diff --git a/apps/console/src/screens/Approvals.tsx b/apps/console/src/screens/Approvals.tsx
index 359b9f2..ea0f2bd 100644
--- a/apps/console/src/screens/Approvals.tsx
+++ b/apps/console/src/screens/Approvals.tsx
@@ -1,5 +1,5 @@
 /**
- * Approvals — the dual-control release gate. Each payment awaiting approval reads as
+ * Approvals, the dual-control release gate. Each payment awaiting approval reads as
  * a structured three-area row: what it is (memo, counterparty, reference, proposer),
  * where it stands (M-of-N progress, policy, privacy, risk), and the decision (amount,
  * Deny, Approve). Denying requires a reason; approving that satisfies the policy
@@ -39,7 +39,7 @@ const HIGH_VALUE = 10_000n * 1_000_000n;
 /** "…on-chain" network prose without doubling "Mainnet" on a mainnet build. */
 const NETWORK_PROSE = `${NETWORK_LABEL}${NETWORK_ENV.kind === "mainnet" ? "" : ` ${NETWORK_ENV.badge}`}`;
 
-/** "2 hours ago" — a calm relative age for a proposed-at timestamp. */
+/** "2 hours ago", a calm relative age for a proposed-at timestamp. */
 function timeAgo(ts: string | number | Date): string {
   const then = new Date(ts).getTime();
   if (Number.isNaN(then)) return "";
@@ -79,7 +79,7 @@ function matchPolicy(p: PaymentOrder, policies: ApprovalPolicy[]): ApprovalPolic
   return matches.sort((a, b) => amountConds(b) - amountConds(a))[0];
 }
 
-/** Segmented M-of-N progress — filled segments for recorded approvals. */
+/** Segmented M-of-N progress, filled segments for recorded approvals. */
 function Progress({ have, need }: { have: number; need: number }) {
   return (
     <div data-testid="approval-progress">
@@ -176,7 +176,7 @@ export function Approvals() {
               const have = approvedTrail.length;
               const knownNeed = policy ? totalApprovers(policy) : null;
               // Only claim this approval RELEASES the payment when the threshold is
-              // actually known — an unresolved policy must not over-promise a settle.
+              // actually known, an unresolved policy must not over-promise a settle.
               const willRelease = knownNeed != null && have + 1 >= knownNeed;
               const need = knownNeed ?? Math.max(have + 1, 2); // display fallback for the progress bar
               const risky = BigInt(p.amount.amount) > HIGH_VALUE;
@@ -191,7 +191,7 @@ export function Approvals() {
                 >
                   <Card data-testid="approval-card">
                     <div className="grid gap-5 md:grid-cols-[1fr_auto_auto] md:items-start">
-                      {/* Left — what it is */}
+                      {/* Left, what it is */}
                       <div className="min-w-0">
                         <div className="t-card-title truncate text-fg">{p.memo ?? "Payment"}</div>
                         <div className="t-secondary mt-0.5">
@@ -204,7 +204,7 @@ export function Approvals() {
                         </div>
                       </div>
 
-                      {/* Middle — where it stands */}
+                      {/* Middle, where it stands */}
                       <div className="space-y-2.5 md:w-60 md:border-l md:border-border md:pl-5">
                         <Progress have={have} need={need} />
                         {have > 0 ? (
@@ -225,7 +225,7 @@ export function Approvals() {
                         </div>
                       </div>
 
-                      {/* Right — the decision */}
+                      {/* Right, the decision */}
                       <div className="flex flex-col items-end gap-3 md:w-44 md:pl-5">
                         <div className="font-display tnum text-2xl font-semibold text-fg" data-testid="approval-amount">
                           {masked || p.privacy.amountHidden ? "••••••" : fmtUsd(p.amount.amount)}
@@ -296,7 +296,7 @@ export function Approvals() {
                         <StatusPill status={p.status} />
                       )}
                     </Td>
-                    <Td>{last ? `${memberName(last.approverMemberId)}${memberRole(last.approverMemberId) ? ` · ${memberRole(last.approverMemberId)}` : ""}` : "—"}</Td>
+                    <Td>{last ? `${memberName(last.approverMemberId)}${memberRole(last.approverMemberId) ? ` · ${memberRole(last.approverMemberId)}` : ""}` : "-"}</Td>
                     <Td align="right" className="tnum">
                       {masked || p.privacy.amountHidden ? "••••••" : fmtUsd(p.amount.amount)}
                     </Td>
@@ -311,7 +311,7 @@ export function Approvals() {
                           Receipt <ExternalLink size={12} />
                         </a>
                       ) : (
-                        <span className="text-muted">—</span>
+                        <span className="text-muted">-</span>
                       )}
                     </Td>
                   </Tr>
@@ -322,7 +322,7 @@ export function Approvals() {
         </div>
       ) : null}
 
-      {/* Approve confirm — releases explicitly say what happens on-chain. */}
+      {/* Approve confirm, releases explicitly say what happens on-chain. */}
       <Modal
         open={!!confirm}
         onClose={() => busy === null && setConfirm(null)}
@@ -382,7 +382,7 @@ export function Approvals() {
           <p className="t-helper">A reason is recorded in the audit trail and shared with the proposer.</p>
           <Textarea
             label="Reason for denial"
-            placeholder="e.g. Duplicate of PO-4480 — already paid."
+            placeholder="e.g. Duplicate of PO-4480, already paid."
             value={denyReason}
             onChange={(e) => setDenyReason(e.target.value)}
             data-testid="deny-reason"
diff --git a/apps/console/src/screens/AuditLog.tsx b/apps/console/src/screens/AuditLog.tsx
index 84c811f..f20907a 100644
--- a/apps/console/src/screens/AuditLog.tsx
+++ b/apps/console/src/screens/AuditLog.tsx
@@ -1,10 +1,10 @@
 /**
- * Audit log — the tamper-evident double-entry ledger on screen. Every shielded
+ * Audit log, the tamper-evident double-entry ledger on screen. Every shielded
  * movement projects to a balanced entry whose hash commits to the one before it, so
  * any after-the-fact edit/insert/delete breaks the chain. A dense, filterable table
  * (search, date range, event, account, status, export) with a per-row detail drawer.
  * "Generate auditor packet" re-walks the chain, folds every encrypted event under one
- * Merkle root, and anchors it on-chain — one full-screen, re-verifiable disclosure.
+ * Merkle root, and anchors it on-chain, one full-screen, re-verifiable disclosure.
  */
 import { useEffect, useMemo, useReducer, useState } from "react";
 import { CheckCircle2, Download, ExternalLink, ScrollText, Search, ShieldAlert, X } from "lucide-react";
@@ -35,7 +35,7 @@ const ALL_EVENTS = Object.keys(EVENT_LABEL) as LedgerSourceType[];
 
 // `finalityOf` only ever yields confirmed / pending / reversed for a ledger entry
 // (there's no failure signal on the model), so "failed" was unreachable everywhere
-// it appeared — the pill branch and the status-filter option both included a state
+// it appeared, the pill branch and the status-filter option both included a state
 // no row could ever have. Dropped it until the ledger actually surfaces failures.
 type Finality = "confirmed" | "pending" | "reversed";
 const FINALITY_LABEL: Record<Finality, string> = { confirmed: "Confirmed", pending: "Pending", reversed: "Reversed" };
@@ -45,7 +45,7 @@ const FINALITY_LABEL: Record<Finality, string> = { confirmed: "Confirmed", pendi
 const PACKET_TITLES: CeremonyTitles = {
   encrypt: { title: "Re-walking the audit chain", sub: "Re-hashing every entry and gathering the encrypted events" },
   settle: { title: "Folding the audit proof", sub: "Committing the Merkle root and anchoring it on-chain" },
-  verify: { title: "Anchored on-chain — Merkle root revealed", sub: "Here's your downloadable, re-verifiable packet" },
+  verify: { title: "Anchored on-chain, Merkle root revealed", sub: "Here's your downloadable, re-verifiable packet" },
   error: { title: "Couldn't seal the packet" },
 };
 
@@ -59,10 +59,10 @@ function accountFor(e: LedgerEntry): string {
   return e.lines.find((l) => l.direction === "credit")?.accountId ?? e.lines[0]?.accountId ?? "";
 }
 
-/** "acct_operating" -> "Operating" — a friendly bucket label, no store needed. */
+/** "acct_operating" -> "Operating", a friendly bucket label, no store needed. */
 function accountLabel(id: string): string {
   const base = id.replace(/^acct_/, "").replace(/_/g, " ");
-  return base ? base.charAt(0).toUpperCase() + base.slice(1) : "—";
+  return base ? base.charAt(0).toUpperCase() + base.slice(1) : "-";
 }
 
 /** Settlement finality of an entry. */
@@ -130,7 +130,7 @@ export function AuditLog() {
       if (eventType !== "all" && e.sourceType !== eventType) return false;
       if (statusFilter !== "all" && finalityOf(e) !== statusFilter) return false;
       if (accountFilter !== "all" && !e.lines.some((l) => l.accountId === accountFilter)) return false;
-      // Both bounds parsed as LOCAL start/end-of-day — bare `new Date("2026-07-10")`
+      // Both bounds parsed as LOCAL start/end-of-day, bare `new Date("2026-07-10")`
       // is UTC midnight, which would slice the day off by the viewer's tz offset.
       if (dateFrom && new Date(e.postedAt) < new Date(`${dateFrom}T00:00:00`)) return false;
       if (dateTo && new Date(e.postedAt) > new Date(`${dateTo}T23:59:59`)) return false;
@@ -146,7 +146,7 @@ export function AuditLog() {
   const pageClamped = Math.min(page, totalPages - 1);
   const pageRows = filtered.slice(pageClamped * PAGE_SIZE, pageClamped * PAGE_SIZE + PAGE_SIZE);
   useEffect(() => setPage(0), [search, eventType, statusFilter, accountFilter, dateFrom, dateTo]);
-  // Escape closes the detail drawer — the dialog affordance keyboard users expect.
+  // Escape closes the detail drawer, the dialog affordance keyboard users expect.
   useEffect(() => {
     if (!detail) return;
     const onKey = (e: KeyboardEvent) => e.key === "Escape" && setDetail(null);
@@ -361,7 +361,7 @@ export function AuditLog() {
                   key={e.id}
                   role="button"
                   tabIndex={0}
-                  aria-label={`${EVENT_LABEL[e.sourceType]} — open details`}
+                  aria-label={`${EVENT_LABEL[e.sourceType]}, open details`}
                   onClick={() => setDetail(e)}
                   onKeyDown={(ev) => {
                     if (ev.key === "Enter" || ev.key === " ") {
@@ -380,7 +380,7 @@ export function AuditLog() {
                         <CopyButton value={e.hash} />
                       </span>
                     ) : (
-                      <span className="text-muted">—</span>
+                      <span className="text-muted">-</span>
                     )}
                   </Td>
                   <Td className="!py-4">{accountLabel(accountFor(e))}</Td>
@@ -398,7 +398,7 @@ export function AuditLog() {
                         Receipt <ExternalLink size={12} />
                       </a>
                     ) : (
-                      <span className="text-muted">—</span>
+                      <span className="text-muted">-</span>
                     )}
                   </Td>
                 </Tr>
@@ -468,7 +468,7 @@ export function AuditLog() {
                       <span className="flex-none"><CopyButton value={detail.hash} /></span>
                     </div>
                   ) : (
-                    <span className="text-muted">—</span>
+                    <span className="text-muted">-</span>
                   )}
                 </div>
 
diff --git a/apps/console/src/screens/Contractors.tsx b/apps/console/src/screens/Contractors.tsx
index 3d24853..0f97a91 100644
--- a/apps/console/src/screens/Contractors.tsx
+++ b/apps/console/src/screens/Contractors.tsx
@@ -2,7 +2,7 @@
  * Contractors - the roster + rate cards that the pay engine COMPUTES runs from.
  * This is the input to every payroll run: a managed payee book with a monthly USDC
  * rate per contractor, CSV import, single-row add, and inline rate/handle edits. Run
- * amounts are computed server-side from these rates (never typed in) — surfaced as the
+ * amounts are computed server-side from these rates (never typed in), surfaced as the
  * info note beside the payroll total, not as page chrome.
  */
 import { Fragment, useMemo, useState } from "react";
@@ -46,7 +46,7 @@ export function Contractors() {
 
   const contractors = useMemo(() => counterparties.filter((c) => c.type === "contractor"), [counterparties]);
   // Two distinct axes: an ACTIVE contractor is allowlisted (payable); IN REVIEW is
-  // still being screened. The header stat used to say "5" while six rows showed — the
+  // still being screened. The header stat used to say "5" while six rows showed, the
   // 6th is in review, not active. These counts keep that split honest.
   const active = useMemo(() => contractors.filter((c) => c.status === "allowlisted"), [contractors]);
   const inReview = useMemo(() => contractors.filter((c) => c.status === "pending_screening"), [contractors]);
@@ -93,7 +93,7 @@ export function Contractors() {
     }
   }
 
-  // Single-row add reuses the roster import path — same server-side validation, so a
+  // Single-row add reuses the roster import path, same server-side validation, so a
   // quick add and a bulk import can't diverge.
   async function doAdd() {
     const name = add.name.trim();
@@ -120,7 +120,7 @@ export function Contractors() {
     }
   }
 
-  // Close the add modal AND clear its form — both the ✕ and Cancel use this so a
+  // Close the add modal AND clear its form, both the ✕ and Cancel use this so a
   // half-filled, cancelled form never reappears on reopen.
   function closeAdd() {
     setAddOpen(false);
@@ -234,7 +234,7 @@ export function Contractors() {
                 <Amount minor={monthlyTotal} code="USDC" />
                 <span
                   className="cursor-help text-muted transition hover:text-fg"
-                  title="Computed from each contractor's rate card on the server — amounts are never typed into a run."
+                  title="Computed from each contractor's rate card on the server, amounts are never typed into a run."
                   aria-label="How this total is computed"
                 >
                   <Info size={14} />
@@ -308,7 +308,7 @@ export function Contractors() {
                       </div>
                     </Td>
 
-                    {/* Monthly rate — tight tabular, right-aligned, click to edit */}
+                    {/* Monthly rate, tight tabular, right-aligned, click to edit */}
                     <Td align="right">
                       <motion.div
                         className="-mx-2 inline-block rounded-md px-2"
@@ -381,17 +381,17 @@ export function Contractors() {
                       </motion.div>
                     </Td>
 
-                    {/* Tax form — neutral MetaPill; missing = amber (incomplete, not a failure) */}
+                    {/* Tax form, neutral MetaPill; missing = amber (incomplete, not a failure) */}
                     <Td>
                       {hasTax ? <MetaPill>{c.taxFormType}</MetaPill> : <Pill tone="warning">Missing</Pill>}
                     </Td>
 
-                    {/* Verification — compact lifecycle badge (screening outcome) */}
+                    {/* Verification, compact lifecycle badge (screening outcome) */}
                     <Td>
                       <StatusPill status={c.status} />
                     </Td>
 
-                    {/* Payment access — the allowlist control (separate axis from verification) */}
+                    {/* Payment access, the allowlist control (separate axis from verification) */}
                     <Td>
                       <select
                         value={c.status}
@@ -476,7 +476,7 @@ export function Contractors() {
           />
           <Input
             label="Handle"
-            hint="Optional. Their Benzo handle for private payouts — you can add it later."
+            hint="Optional. Their Benzo handle for private payouts, you can add it later."
             value={add.handle}
             onChange={(e) => setAdd((a) => ({ ...a, handle: e.target.value.replace(/[^a-zA-Z0-9_@.-]/g, "") }))}
             placeholder="@jane"
@@ -484,7 +484,7 @@ export function Contractors() {
           />
           <Input
             label="Monthly rate (USDC)"
-            hint="The rate card each payroll run is computed from — never typed into a run."
+            hint="The rate card each payroll run is computed from, never typed into a run."
             value={add.rate}
             onChange={(e) => setAdd((a) => ({ ...a, rate: e.target.value.replace(/[^0-9.]/g, "") }))}
             placeholder="8500"
diff --git a/apps/console/src/screens/Dashboard.tsx b/apps/console/src/screens/Dashboard.tsx
index 1da4335..d918351 100644
--- a/apps/console/src/screens/Dashboard.tsx
+++ b/apps/console/src/screens/Dashboard.tsx
@@ -1,8 +1,8 @@
 /**
- * Dashboard / Overview — calm, dense enterprise-finance home. A compact setup
+ * Dashboard / Overview, calm, dense enterprise-finance home. A compact setup
  * banner (only when setup is unfinished), the private treasury balance, the one
  * approval awaiting the current member, and a real recent-activity table. Amounts
- * follow one rule: •••••• only when the viewer can't see the figure, — when there
+ * follow one rule: •••••• only when the viewer can't see the figure,, when there
  * is no amount, and a "Private on-chain" tag for money that's visible in Benzo but
  * hidden publicly. Everything settles on Avalanche/eERC.
  */
@@ -39,7 +39,7 @@ function useCountUp(target: number, durationMs = 1000): number {
   return value;
 }
 
-/** "2026-07-08T14:10:00Z" -> "2 hours ago" — a calm relative age for submitted-at. */
+/** "2026-07-08T14:10:00Z" -> "2 hours ago", a calm relative age for submitted-at. */
 function timeAgo(ts: string | number | Date): string {
   const then = new Date(ts).getTime();
   if (Number.isNaN(then)) return "";
@@ -47,7 +47,7 @@ function timeAgo(ts: string | number | Date): string {
   const min = Math.round(diff / 60_000);
   if (min < 1) return "just now";
   if (min < 60) return `${min} minute${min === 1 ? "" : "s"} ago`;
-  // Derive each unit from `diff` directly — deriving hr from the already-rounded
+  // Derive each unit from `diff` directly, deriving hr from the already-rounded
   // min (etc.) compounds rounding and overstates age at boundaries.
   const hr = Math.round(diff / 3_600_000);
   if (hr < 24) return `${hr} hour${hr === 1 ? "" : "s"} ago`;
@@ -62,11 +62,11 @@ function primaryTreasuryMinor(treasury: TreasuryView | null | undefined, fallbac
 }
 
 /**
- * Setup banner — the bridge from onboarding to first value, collapsed into ONE calm
- * line: "Finish setup — N steps remaining" + the next action's prompt + its CTA.
+ * Setup banner, the bridge from onboarding to first value, collapsed into ONE calm
+ * line: "Finish setup, N steps remaining" + the next action's prompt + its CTA.
  * Steps are seeded from REAL store state (not a stored "seen" flag), so each flips to
  * done on its own when the underlying condition is met. Completed steps are disclosed
- * under a small toggle — a muted check + "Completed", never struck through. It
+ * under a small toggle, a muted check + "Completed", never struck through. It
  * auto-hides once everything's done and can be dismissed (persisted).
  */
 function SetupBanner() {
@@ -75,7 +75,7 @@ function SetupBanner() {
   const [dismissed, setDismissed] = useState(() => localStorage.getItem("benzo.console.firstrun.dismissed") === "1");
   const [showDone, setShowDone] = useState(false);
 
-  // Seed each item from live state — honest, not a stored flag.
+  // Seed each item from live state, honest, not a stored flag.
   const funded = Number(primaryTreasuryMinor(treasury)) > 0;
   // Maker-checker needs a proposer ≠ approver: more than one member, at least one of
   // whom can approve.
@@ -114,7 +114,7 @@ function SetupBanner() {
           </span>
           <div className="min-w-0">
             <div className="t-card-title text-fg">
-              Finish setup — {remaining.length} step{remaining.length === 1 ? "" : "s"} remaining
+              Finish setup, {remaining.length} step{remaining.length === 1 ? "" : "s"} remaining
             </div>
             <div className="t-helper mt-0.5">{next.prompt}</div>
           </div>
@@ -166,7 +166,7 @@ function SetupBanner() {
   );
 }
 
-/** Business labels for activity kinds — an auditor-grant event reads distinct from a payment. */
+/** Business labels for activity kinds, an auditor-grant event reads distinct from a payment. */
 const TYPE_LABEL: Record<ActivityItem["kind"], string> = {
   payment: "Payment",
   invoice: "Invoice",
@@ -225,9 +225,9 @@ export function Dashboard() {
   const targetDollars = Number(primaryTreasuryMinor(treasury, dashboard?.totalPosition.amount ?? "0")) / USDC_SCALE;
   const animatedTotal = useCountUp(targetDollars);
 
-  /** •••••• (hidden from viewer) · — (no amount) · the figure (visible). */
+  /** •••••• (hidden from viewer) ·, (no amount) · the figure (visible). */
   function amountCell(a: ActivityItem) {
-    if (a.amountLabel === "—") return <span className="text-muted">—</span>;
+    if (a.amountLabel === "-") return <span className="text-muted">-</span>;
     if (masked || a.amountLabel === "Private") return <span className="mask">••••••</span>;
     return <span className="tnum font-medium text-fg">{a.amountLabel}</span>;
   }
@@ -251,7 +251,7 @@ export function Dashboard() {
       ) : null}
 
       <Stagger className="grid grid-cols-1 items-start gap-4 lg:grid-cols-12">
-        {/* Private treasury balance — 7 col */}
+        {/* Private treasury balance, 7 col */}
         <Stagger.Item index={0} className="lg:col-span-7">
           <Card>
             <div className="flex items-center justify-between gap-3">
@@ -271,7 +271,7 @@ export function Dashboard() {
           </Card>
         </Stagger.Item>
 
-        {/* Approval awaiting you — 5 col */}
+        {/* Approval awaiting you, 5 col */}
         <Stagger.Item index={1} className="lg:col-span-5">
           <Card className="flex flex-col">
             <div className="t-label text-muted">Approvals</div>
@@ -308,7 +308,7 @@ export function Dashboard() {
         </Stagger.Item>
       </Stagger>
 
-      {/* Recent activity — full width */}
+      {/* Recent activity, full width */}
       <Stagger className="mt-8">
         <Stagger.Item index={2}>
           <div className="mb-3 flex items-center justify-between gap-4">
@@ -349,7 +349,7 @@ export function Dashboard() {
                     key={a.id}
                     role="button"
                     tabIndex={0}
-                    aria-label={`${a.title} — view details`}
+                    aria-label={`${a.title}, view details`}
                     onClick={() => nav(routeForActivity(a))}
                     onKeyDown={(e) => {
                       if (e.key === "Enter" || e.key === " ") {
@@ -370,7 +370,7 @@ export function Dashboard() {
                       </span>
                     </Td>
                     <Td align="right">{amountCell(a)}</Td>
-                    <Td>{a.kind === "grant" ? <span className="text-muted">—</span> : <PrivateOnChain />}</Td>
+                    <Td>{a.kind === "grant" ? <span className="text-muted">-</span> : <PrivateOnChain />}</Td>
                   </tr>
                 ))
               )}
diff --git a/apps/console/src/screens/Grants.tsx b/apps/console/src/screens/Grants.tsx
index 3e1ad2e..e0185c2 100644
--- a/apps/console/src/screens/Grants.tsx
+++ b/apps/console/src/screens/Grants.tsx
@@ -1,5 +1,5 @@
 /**
- * Auditor access — issue a scoped, read-only viewing key so an auditor sees exactly
+ * Auditor access, issue a scoped, read-only viewing key so an auditor sees exactly
  * the in-scope notes (a corridor/period), nothing else, and revoke it on-chain. Two
  * tabs: Access (the grant register + revoke) and Attestations (a network-verified
  * period-total report). Private by default, disclosable on your terms.
@@ -39,7 +39,7 @@ type PeriodTotal = Awaited<ReturnType<typeof api.periodTotalAttestation>>;
 type TabId = "access" | "attestations";
 type AccessFilter = "active" | "inactive";
 
-/** De-jargoned disclosure tiers — no bare "outgoing"/"incoming"/"full" in the UI. */
+/** De-jargoned disclosure tiers, no bare "outgoing"/"incoming"/"full" in the UI. */
 const TIER_LABEL: Record<DisclosureTier, string> = {
   full: "Full access",
   incoming: "Incoming payments",
@@ -50,7 +50,7 @@ const TIER_LABEL: Record<DisclosureTier, string> = {
 const ATTEST_TITLES: CeremonyTitles = {
   encrypt: { title: "Loading the period's notes", sub: "Gathering the in-scope notes and building the witness" },
   settle: { title: "Folding the ORGSUM proof", sub: "Proving the total on-chain without revealing a single salary" },
-  verify: { title: "Verified on-chain — Merkle root revealed", sub: "Here's your downloadable, re-verifiable attestation" },
+  verify: { title: "Verified on-chain, Merkle root revealed", sub: "Here's your downloadable, re-verifiable attestation" },
   error: { title: "Couldn't prove the total" },
 };
 
@@ -315,7 +315,7 @@ export function Grants() {
                           <XCircle size={14} /> Revoke
                         </Button>
                       ) : (
-                        <span className="text-muted">—</span>
+                        <span className="text-muted">-</span>
                       )}
                     </Td>
                   </Tr>
@@ -330,7 +330,7 @@ export function Grants() {
             <FileCheck size={16} className="text-primary" /> Period total for tax / audit
           </div>
           <p className="t-helper mt-1 max-w-2xl">
-            Export a network-verified statement of what you paid out for a period — the total is proven on-chain; the individual
+            Export a network-verified statement of what you paid out for a period, the total is proven on-chain; the individual
             salaries stay hidden. The file embeds the proof so your auditor can re-verify it independently.
           </p>
           <div className="mt-4 flex items-end gap-3">
@@ -344,7 +344,7 @@ export function Grants() {
           <details className="mt-4 text-[12.5px] text-muted">
             <summary className="cursor-pointer select-none font-medium text-fg outline-none focus-visible:ring-2 focus-visible:ring-primary/40">Technical details</summary>
             <p className="mt-2 max-w-2xl leading-relaxed">
-              Soundness: this proves the disclosed notes sum to the stated total — not that the set is complete. It attests the total
+              Soundness: this proves the disclosed notes sum to the stated total, not that the set is complete. It attests the total
               you claim; it does not detect a payout deliberately left out (completeness is bounded only by the authorized-key registry).
             </p>
           </details>
@@ -403,7 +403,7 @@ export function Grants() {
       >
         <p className="text-sm text-muted">
           This revokes <b>{confirmRevoke?.auditorName}</b>'s read-only access on-chain, immediately. They'll lose visibility into the
-          granted scope and you can't undo it — you'd have to grant new access.
+          granted scope and you can't undo it, you'd have to grant new access.
         </p>
       </Modal>
     </Screen>
diff --git a/apps/console/src/screens/Invoices.tsx b/apps/console/src/screens/Invoices.tsx
index 6685361..304763d 100644
--- a/apps/console/src/screens/Invoices.tsx
+++ b/apps/console/src/screens/Invoices.tsx
@@ -1,5 +1,5 @@
 /**
- * Invoices — AP inbox and the second front-door into the pay engine. Contractor /
+ * Invoices, AP inbox and the second front-door into the pay engine. Contractor /
  * vendor invoices land here and settle through the SAME maker-checker + confidential
  * settlement as a payroll run (over the policy threshold → Approvals first).
  *
@@ -72,7 +72,7 @@ function isPayable(inv: Invoice): boolean {
 }
 
 /**
- * Display lifecycle — derives Due soon / Overdue from a real due date so the pill
+ * Display lifecycle, derives Due soon / Overdue from a real due date so the pill
  * carries operational meaning (never leaks a spurious time; dates render date-only).
  * Terminal states pass through unchanged.
  */
@@ -81,7 +81,7 @@ function displayStatus(inv: Invoice): string {
   if (inv.status === "partially_paid") return "partially_paid";
   if (inv.status === "cancelled") return "cancelled";
   // Honor an explicit server-set "overdue" even if the local dueDate math wouldn't
-  // derive it (missing/future dueDate) — don't silently downgrade it to "open".
+  // derive it (missing/future dueDate), don't silently downgrade it to "open".
   if (inv.status === "overdue") return "overdue";
   if (inv.dueDate) {
     const days = (new Date(inv.dueDate).getTime() - Date.now()) / 86_400_000;
@@ -171,7 +171,7 @@ export function Invoices() {
     });
   }
 
-  /** The settled payment behind a paid invoice — carries the on-chain receipt + date. */
+  /** The settled payment behind a paid invoice, carries the on-chain receipt + date. */
   const paymentFor = (inv: Invoice) => payments.find((p) => inv.paymentOrderIds.includes(p.id));
 
   async function pay(inv: Invoice) {
@@ -202,7 +202,7 @@ export function Invoices() {
   }
 
   // Bulk review → pay: run each selected invoice through the SAME engine. Lines resolve
-  // independently — some settle, some route to Approvals — so we report both counts.
+  // independently, some settle, some route to Approvals, so we report both counts.
   async function paySelected() {
     setPayingAll(true);
     let paid = 0;
@@ -245,7 +245,7 @@ export function Invoices() {
         <Tabs items={tabs} active={tab} onChange={setTab} />
       </div>
 
-      {/* Selection bar — appears once at least one payable row is checked. Review, don't blind-pay. */}
+      {/* Selection bar, appears once at least one payable row is checked. Review, don't blind-pay. */}
       {selected.size > 0 ? (
         <Card compact className="mb-4 flex flex-wrap items-center justify-between gap-3" data-testid="selection-bar">
           <div className="t-body text-fg">
@@ -337,7 +337,7 @@ export function Invoices() {
                     ) : null}
                   </Td>
                   <Td>{name(inv.counterpartyId)}</Td>
-                  <Td>{inv.dueDate ? fmtDate(inv.dueDate) : "—"}</Td>
+                  <Td>{inv.dueDate ? fmtDate(inv.dueDate) : "-"}</Td>
                   <Td>
                     <StatusPill status={status} />
                   </Td>
@@ -371,7 +371,7 @@ export function Invoices() {
                         ) : null}
                       </div>
                     ) : (
-                      <span className="text-muted">—</span>
+                      <span className="text-muted">-</span>
                     )}
                   </Td>
                 </Tr>
@@ -412,7 +412,7 @@ export function Invoices() {
             <dl className="rounded-lg border border-border bg-bg px-4 py-3 text-sm">
               <Row label="Invoice" value={review.number} />
               <Row label="Payee" value={name(review.counterpartyId)} />
-              <Row label="Due date" value={review.dueDate ? fmtDate(review.dueDate) : "—"} />
+              <Row label="Due date" value={review.dueDate ? fmtDate(review.dueDate) : "-"} />
               <Row label="Amount" value={masked ? "••••••" : <Amount minor={review.total.amount} code="USDC" />} />
               <Row label="Network fee" value={<span className="text-success">Free</span>} />
             </dl>
diff --git a/apps/console/src/screens/Pay.tsx b/apps/console/src/screens/Pay.tsx
index 4e6f2d8..c0be26a 100644
--- a/apps/console/src/screens/Pay.tsx
+++ b/apps/console/src/screens/Pay.tsx
@@ -1,5 +1,5 @@
 /**
- * One-off payment — create a single confidential payment outside of payroll/invoices.
+ * One-off payment, create a single confidential payment outside of payroll/invoices.
  * Pick a funding account and who you're paying; a live review summary on the right
  * fills in as you go (source, recipient, amount, fee, network, privacy, approval,
  * settlement). "Review payment" gates a send: over-threshold payments route to
@@ -56,7 +56,7 @@ export function Pay() {
   const busy = isInFlight(paymentState);
   const ceremonyOpen = paymentState.phase !== "idle";
 
-  // The one honest reason the primary is disabled — shown next to a neutral-gray button.
+  // The one honest reason the primary is disabled, shown next to a neutral-gray button.
   const disabledReason = !fromAccountId
     ? "Choose the account to pay from."
     : !toCounterpartyId
@@ -186,9 +186,9 @@ export function Pay() {
               <div className="mt-1.5 flex flex-wrap items-center gap-2 text-[13px] text-muted">
                 {payee.status ? <StatusPill status={payee.status} /> : null}
                 {hasHandle ? (
-                  <span>Payout handle on file — eligible to receive.</span>
+                  <span>Payout handle on file, eligible to receive.</span>
                 ) : (
-                  <span className="text-warning">No payout handle yet — may not settle until onboarded.</span>
+                  <span className="text-warning">No payout handle yet, may not settle until onboarded.</span>
                 )}
               </div>
             ) : null}
@@ -205,7 +205,7 @@ export function Pay() {
           />
           <Input
             label="Note (optional)"
-            hint="Internal reference — visible to authorized workspace members, not on-chain."
+            hint="Internal reference, visible to authorized workspace members, not on-chain."
             placeholder="PO-4480 components"
             value={memo}
             onChange={(e) => setMemo(e.target.value)}
@@ -286,7 +286,7 @@ export function Pay() {
               />
               <SummaryRow label="Network fee" value={<span className="text-success">Free</span>} />
               <SummaryRow label="Network" value={NETWORK_ENV.chip} />
-              <SummaryRow label="Privacy" value="Private on-chain — amount and recipient hidden" />
+              <SummaryRow label="Privacy" value="Private on-chain, amount and recipient hidden" />
               <SummaryRow
                 label="Approval"
                 value={
@@ -308,7 +308,7 @@ export function Pay() {
   );
 }
 
-const placeholder = <span className="text-muted">—</span>;
+const placeholder = <span className="text-muted">-</span>;
 
 function SummaryRow({ label, value }: { label: string; value: React.ReactNode }) {
   return (
diff --git a/apps/console/src/screens/Settings.tsx b/apps/console/src/screens/Settings.tsx
index 37dc7fb..a46a08a 100644
--- a/apps/console/src/screens/Settings.tsx
+++ b/apps/console/src/screens/Settings.tsx
@@ -1,5 +1,5 @@
 /**
- * Settings & team — the workspace control surface, organized into tabs: Team (members
+ * Settings & team, the workspace control surface, organized into tabs: Team (members
  * + roles + invites), Approval policy (require N approvals over $X), Recovery, Payees,
  * and Integrations. The heavy value-moving actions still live on their own screens.
  */
@@ -112,8 +112,8 @@ export function SettingsScreen() {
 }
 
 /**
- * Team — members (table), roles, and team invites. A team invite mints a console
- * seat; the raw claim URL is never shown — Copy link / Resend / Revoke instead.
+ * Team, members (table), roles, and team invites. A team invite mints a console
+ * seat; the raw claim URL is never shown, Copy link / Resend / Revoke instead.
  */
 function TeamCard() {
   const { members, session, loading } = useConsole();
@@ -240,7 +240,7 @@ function TeamCard() {
                   <Td className="text-muted">{m.email}</Td>
                   <Td><MetaPill>{m.role}</MetaPill></Td>
                   <Td><StatusPill status={m.status} /></Td>
-                  <Td align="right"><span className="text-muted">—</span></Td>
+                  <Td align="right"><span className="text-muted">-</span></Td>
                 </Tr>
               );
             })}
@@ -261,7 +261,7 @@ function TeamCard() {
                 <Button size="sm" variant="ghost" onClick={() => void copyLink(inv.link)} data-testid="team-invite-copy">
                   Copy link
                 </Button>
-                <Button size="sm" variant="ghost" onClick={() => void copyLink(inv.link, "Invite link copied — send it to your teammate")} data-testid="team-invite-resend">
+                <Button size="sm" variant="ghost" onClick={() => void copyLink(inv.link, "Invite link copied, send it to your teammate")} data-testid="team-invite-resend">
                   <RefreshCw size={13} /> Resend
                 </Button>
                 <button
@@ -300,7 +300,7 @@ function TeamCard() {
             ))}
           </Select>
           {formError ? <p className="text-[13px] font-medium text-danger" data-testid="team-invite-error">{formError}</p> : null}
-          <p className="text-[12px] text-muted">Team invites create a console seat. Share the link — they finish sign-in themselves.</p>
+          <p className="text-[12px] text-muted">Team invites create a console seat. Share the link, they finish sign-in themselves.</p>
         </div>
       </Modal>
 
@@ -326,7 +326,7 @@ function TeamCard() {
 }
 
 /**
- * Approval policy — "require N approvals over $X". When none is configured we show a
+ * Approval policy, "require N approvals over $X". When none is configured we show a
  * coherent empty state with Create (no dashboard contradiction); the editor persists
  * a real policy via updatePolicy (a freshly created default is session-local until a
  * backend create exists).
@@ -367,7 +367,7 @@ function ApprovalPolicyCard() {
       reApprovalTriggers: [],
       createdAt: new Date().toISOString(),
     });
-    toast({ title: "Default policy created — review and activate", tone: "success" });
+    toast({ title: "Default policy created, review and activate", tone: "success" });
   }
 
   async function save() {
@@ -382,7 +382,7 @@ function ApprovalPolicyCard() {
 
     // A freshly created default isn't in the store yet. Try to persist it; if this
     // build has no create/upsert path (updatePolicy rejects an unknown id), keep it
-    // for the session and say so honestly — never claim it's activated when it isn't.
+    // for the session and say so honestly, never claim it's activated when it isn't.
     if (!storePolicy && localPolicy) {
       const next = { ...localPolicy, conditions, steps, releaseGate };
       setBusy(true);
@@ -393,7 +393,7 @@ function ApprovalPolicyCard() {
         toast({ title: "Approval policy activated", tone: "success" });
       } catch {
         setLocalPolicy(next);
-        toast({ title: "Session-only default — not yet saved to your workspace.", tone: "warning" });
+        toast({ title: "Session-only default, not yet saved to your workspace.", tone: "warning" });
       } finally {
         setBusy(false);
       }
@@ -432,7 +432,7 @@ function ApprovalPolicyCard() {
         <>
           {!storePolicy ? (
             <div className="mx-5 mt-4 rounded-lg border border-warning/30 bg-warning/8 px-3.5 py-2.5 text-[12.5px] text-warning" data-testid="approval-policy-draft">
-              Default policy created — review the threshold and approvals below, then activate.
+              Default policy created, review the threshold and approvals below, then activate.
             </div>
           ) : null}
           <div className="flex flex-col gap-4 px-5 py-4 sm:flex-row sm:items-end">
@@ -456,7 +456,7 @@ function ApprovalPolicyCard() {
           <div className="mx-5 my-4 flex items-start gap-2 rounded-xl bg-primary/[0.06] px-3.5 py-3 text-[12.5px] text-fg" data-testid="approval-policy-enforcement">
             <ShieldCheck size={15} className="mt-0.5 flex-none text-primary" />
             <span>
-              <b>Enforced on-chain.</b> Org funds settle only with a valid in-circuit M-of-N proof — the verifier rejects a single-key spend, so release is gated by the contract, not just this server. A proposer can never approve their own payment.
+              <b>Enforced on-chain.</b> Org funds settle only with a valid in-circuit M-of-N proof, the verifier rejects a single-key spend, so release is gated by the contract, not just this server. A proposer can never approve their own payment.
             </span>
           </div>
           <div className="flex justify-end border-t border-border px-5 py-3">
@@ -501,7 +501,7 @@ function Stepper({ value, onDec, onInc, testid }: { value: number; onDec: () =>
   );
 }
 
-/** Account recovery — the workspace binding + next steps. */
+/** Account recovery, the workspace binding + next steps. */
 function RecoveryCard({ recovery }: { recovery: RecoveryStatus["recovery"] | null }) {
   return (
     <Card className="p-0" data-testid="account-recovery-card">
@@ -528,7 +528,7 @@ function RecoveryCard({ recovery }: { recovery: RecoveryStatus["recovery"] | nul
   );
 }
 
-/** Payees — vendors & contractors at a glance. */
+/** Payees, vendors & contractors at a glance. */
 function PayeesCard({ loading }: { loading: boolean }) {
   const { counterparties } = useConsole();
   return (
@@ -566,7 +566,7 @@ function PayeesCard({ loading }: { loading: boolean }) {
               <Tr key={c.id}>
                 <Td className="font-medium text-fg">{c.name}</Td>
                 <Td className="capitalize text-muted">{c.type}</Td>
-                <Td>{c.taxFormType && c.taxFormType !== "none" ? <MetaPill>{c.taxFormType}</MetaPill> : <span className="text-muted">—</span>}</Td>
+                <Td>{c.taxFormType && c.taxFormType !== "none" ? <MetaPill>{c.taxFormType}</MetaPill> : <span className="text-muted">-</span>}</Td>
                 <Td align="right"><StatusPill status={c.status} /></Td>
               </Tr>
             ))}
@@ -578,7 +578,7 @@ function PayeesCard({ loading }: { loading: boolean }) {
   );
 }
 
-/** Integrations — table with connected account, last sync, and actionable errors. */
+/** Integrations, table with connected account, last sync, and actionable errors. */
 function IntegrationsCard({ integrations }: { integrations: Integration[] | null }) {
   const toast = useToast();
   return (
@@ -611,7 +611,7 @@ function IntegrationsCard({ integrations }: { integrations: Integration[] | null
           </thead>
           <tbody>
             {integrations.map((it) => {
-              const account = it.externalRefs?.linkedAccount ?? it.externalRefs?.company ?? (it.status === "connected" ? "Connected" : "—");
+              const account = it.externalRefs?.linkedAccount ?? it.externalRefs?.company ?? (it.status === "connected" ? "Connected" : "-");
               return (
                 <Tr key={it.id}>
                   <Td className="font-medium text-fg">{PROVIDER_LABEL[it.provider] ?? it.provider}</Td>
@@ -625,15 +625,15 @@ function IntegrationsCard({ integrations }: { integrations: Integration[] | null
                   </Td>
                   <Td align="right">
                     {it.status === "error" ? (
-                      <Button size="sm" variant="outline" onClick={() => toast({ title: `${PROVIDER_LABEL[it.provider] ?? it.provider} reconnects through the API — not wired up in this build.`, tone: "muted" })}>
+                      <Button size="sm" variant="outline" onClick={() => toast({ title: `${PROVIDER_LABEL[it.provider] ?? it.provider} reconnects through the API, not wired up in this build.`, tone: "muted" })}>
                         <RefreshCw size={13} /> Reconnect
                       </Button>
                     ) : it.status === "disconnected" ? (
-                      <Button size="sm" variant="outline" onClick={() => toast({ title: `${PROVIDER_LABEL[it.provider] ?? it.provider} connects through the API — not wired up in this build.`, tone: "muted" })}>
+                      <Button size="sm" variant="outline" onClick={() => toast({ title: `${PROVIDER_LABEL[it.provider] ?? it.provider} connects through the API, not wired up in this build.`, tone: "muted" })}>
                         Connect
                       </Button>
                     ) : (
-                      <span className="text-muted">—</span>
+                      <span className="text-muted">-</span>
                     )}
                   </Td>
                 </Tr>
@@ -648,7 +648,7 @@ function IntegrationsCard({ integrations }: { integrations: Integration[] | null
 }
 
 /**
- * Roles — the per-role blurb list is the everyday read; the full roles × permissions
+ * Roles, the per-role blurb list is the everyday read; the full roles × permissions
  * matrix stays one click away behind "See full matrix".
  */
 function RolesCard() {
@@ -710,7 +710,7 @@ function RolesCard() {
         </div>
       ) : null}
       <div className="flex items-center gap-1.5 border-t border-border px-5 py-3 text-[12px] text-muted">
-        <ShieldCheck size={13} className="text-primary" /> Auditor is a scoped viewing-key holder — read-only, never a signer. A privacy-native role.
+        <ShieldCheck size={13} className="text-primary" /> Auditor is a scoped viewing-key holder, read-only, never a signer. A privacy-native role.
       </div>
     </Card>
   );
diff --git a/apps/console/src/ui/Logo.tsx b/apps/console/src/ui/Logo.tsx
index 9358ead..c8510f6 100644
--- a/apps/console/src/ui/Logo.tsx
+++ b/apps/console/src/ui/Logo.tsx
@@ -1,6 +1,6 @@
 /**
  * Avalanche network mark (the chain Benzo settles on). Red disc + the Avalanche
- * twin-peak "A"; a faithful in-house rendition — swap for the official brand SVG anytime.
+ * twin-peak "A"; a faithful in-house rendition, swap for the official brand SVG anytime.
  */
 export function AvalancheMark({ size = 16, className = "" }: { size?: number; className?: string }) {
   return (
diff --git a/apps/console/src/ui/SendCeremony.test.tsx b/apps/console/src/ui/SendCeremony.test.tsx
index efadb45..def1161 100644
--- a/apps/console/src/ui/SendCeremony.test.tsx
+++ b/apps/console/src/ui/SendCeremony.test.tsx
@@ -46,7 +46,7 @@ describe("SendCeremony", () => {
     rerender(<SendCeremony open state={{ phase: "confirmed" }} />);
     expect(screen.getByRole("heading", { name: "Encrypting your payment" })).toBeInTheDocument();
 
-    // After the encrypt floor, the Settling beat must appear — never skipped,
+    // After the encrypt floor, the Settling beat must appear, never skipped,
     // or the ceremony would be lying about settlement.
     await act(async () => {
       vi.advanceTimersByTime(SEND_PHASE_FLOOR_MS.encrypt);
diff --git a/apps/console/src/ui/SendCeremony.tsx b/apps/console/src/ui/SendCeremony.tsx
index 7260042..81fa388 100644
--- a/apps/console/src/ui/SendCeremony.tsx
+++ b/apps/console/src/ui/SendCeremony.tsx
@@ -200,7 +200,7 @@ function useFlooredPaymentState(open: boolean, state: PaymentState, reducedMotio
 
     // Advance exactly ONE ceremony beat toward the target, holding the current
     // beat for its floor. Re-running on visibleState change walks the remaining
-    // beats — so a batched encrypt -> confirmed jump still plays "Settling".
+    // beats, so a batched encrypt -> confirmed jump still plays "Settling".
     const ci = CEREMONY_ORDER.indexOf(currentPhase as OrderedPhase);
     const ni = CEREMONY_ORDER.indexOf(nextPhase as OrderedPhase);
     const stepPhase: OrderedPhase | typeof nextPhase = ci >= 0 && ni > ci + 1 ? CEREMONY_ORDER[ci + 1] : nextPhase;
diff --git a/apps/console/src/ui/controls.tsx b/apps/console/src/ui/controls.tsx
index e8f4941..8e97a32 100644
--- a/apps/console/src/ui/controls.tsx
+++ b/apps/console/src/ui/controls.tsx
@@ -112,7 +112,7 @@ export function Modal({
 
 // ---------------------------------------------------------------- table
 
-/** Text alignment for a cell — `right` for amount columns, `left` (default) otherwise. */
+/** Text alignment for a cell, `right` for amount columns, `left` (default) otherwise. */
 type CellAlign = "left" | "right" | "center";
 const ALIGN: Record<CellAlign, string> = { left: "text-left", right: "text-right", center: "text-center" };
 
@@ -124,7 +124,7 @@ export function Table({ children, className = "" }: { children: ReactNode; class
   );
 }
 /**
- * Header cell — the 12px status/table-label treatment. `align="right"` for the amount
+ * Header cell, the 12px status/table-label treatment. `align="right"` for the amount
  * column; put row actions in the rightmost column (align right or center).
  */
 export function Th({ children, align = "left", className = "" }: { children?: ReactNode; align?: CellAlign; className?: string }) {
@@ -142,7 +142,7 @@ export function Tr({ children, onClick, className = "", ...rest }: { children: R
         onClick
           ? (e) => {
               // Don't hijack a click that landed on a nested control (a button, link, or
-              // field inside a cell) — let that control run its own action.
+              // field inside a cell), let that control run its own action.
               if (!(e.target as HTMLElement).closest("button, a, input, select, textarea, label")) onClick();
             }
           : undefined
@@ -154,7 +154,7 @@ export function Tr({ children, onClick, className = "", ...rest }: { children: R
       onKeyDown={
         onClick
           ? (e) => {
-              // Only the row itself activates — a focused nested control keeps its keys.
+              // Only the row itself activates, a focused nested control keeps its keys.
               if (e.target !== e.currentTarget) return;
               if (e.key === "Enter" || e.key === " ") {
                 e.preventDefault();
diff --git a/apps/console/src/ui/primitives.tsx b/apps/console/src/ui/primitives.tsx
index 9701b15..c8fada1 100644
--- a/apps/console/src/ui/primitives.tsx
+++ b/apps/console/src/ui/primitives.tsx
@@ -6,7 +6,7 @@ import { motion, spring } from "./motion";
 export * from "./controls";
 
 /**
- * Surface card — 12px radius, one visible neutral hairline, white on the very light
+ * Surface card, 12px radius, one visible neutral hairline, white on the very light
  * neutral page bg, NO fixed height, no shadow (shadows are reserved for floating
  * things like dropdowns/modals). Default padding is 24px; pass `compact` for the 20px
  * dense variant, or any `p-*`/`px-*` class to take full control (back-compat: a Card
@@ -28,7 +28,7 @@ export function Card({ children, className = "", compact, ...rest }: { children:
 }
 
 /**
- * Plain explanatory block — NOT a card. Use for prose / technical explanation; caps
+ * Plain explanatory block, NOT a card. Use for prose / technical explanation; caps
  * the reading measure (~720px) so long paragraphs stay legible. The page → card →
  * control hierarchy stays at 3 levels; a Section is page-level, never nested chrome.
  */
@@ -58,7 +58,7 @@ const TONE: Record<Tone, string> = {
   shielded: "bg-shielded/12 text-shielded",
 };
 
-/** Status pill — ~24px tall, 12px label. */
+/** Status pill, ~24px tall, 12px label. */
 export function Pill({ children, tone = "muted" }: { children: ReactNode; tone?: Tone }) {
   return (
     <span className={`inline-flex min-h-[24px] items-center gap-1 rounded-full px-2.5 py-0.5 text-[12px] font-medium ${TONE[tone]}`}>
@@ -68,7 +68,7 @@ export function Pill({ children, tone = "muted" }: { children: ReactNode; tone?:
 }
 
 /**
- * Metadata pill — ALWAYS neutral gray. For descriptive tags that are NOT a lifecycle
+ * Metadata pill, ALWAYS neutral gray. For descriptive tags that are NOT a lifecycle
  * status: tax forms (W9, W8-BEN), "manual", "full", counterparty type, etc. These must
  * never borrow green/purple, which are reserved for confirmed / private-on-chain.
  */
@@ -128,12 +128,12 @@ export function ShieldedBadge({ label = "Private" }: { label?: string }) {
 }
 
 /**
- * Money — a tight `$X,XXX.XX` amount. The number renders as ONE solid token, so there
+ * Money, a tight `$X,XXX.XX` amount. The number renders as ONE solid token, so there
  * are no wide gaps around the `$`, commas or decimal (the tabular-nums-spacing
  * regression). `code` notes the denomination (e.g. "USDC") as a muted suffix where it
- * matters — treasury / summaries. `tabular` opts into fixed-width digits for column
+ * matters, treasury / summaries. `tabular` opts into fixed-width digits for column
  * alignment inside tables; alignment there is fine, but tightness always wins.
- * `minor` is USDC base units (6dp) as string|bigint — same contract as fmtUsd.
+ * `minor` is USDC base units (6dp) as string|bigint, same contract as fmtUsd.
  */
 export function Amount({
   minor,
@@ -156,7 +156,7 @@ export function Amount({
   );
 }
 
-/** Alias — some surfaces read better as <Money/>. */
+/** Alias, some surfaces read better as <Money/>. */
 export const Money = Amount;
 
 export function Button({
@@ -196,7 +196,7 @@ export function Button({
     lg: "min-h-[44px] px-4 text-sm",
   };
   // Disabled = NEUTRAL GRAY, never a faded-purple primary (which reads as "still
-  // clickable"). Applies only to a genuinely-disabled button — a loading button keeps
+  // clickable"). Applies only to a genuinely-disabled button, a loading button keeps
   // its variant colour so the spinner stays legible.
   const disabledCls =
     disabled && !loading
diff --git a/packages/core/src/account-file.ts b/packages/core/src/account-file.ts
index 5ae1ec7..6dc8608 100644
--- a/packages/core/src/account-file.ts
+++ b/packages/core/src/account-file.ts
@@ -90,7 +90,7 @@ export function loadAccount(
   let file: AccountFile;
   if ((parsed as EncryptedFile).benzoEncrypted === 1) {
     if (!passphrase) {
-      throw new Error("account file is encrypted — set BENZO_PASSPHRASE to unlock it");
+      throw new Error("account file is encrypted, set BENZO_PASSPHRASE to unlock it");
     }
     file = JSON.parse(decrypt(parsed as EncryptedFile, passphrase)) as AccountFile;
   } else {
diff --git a/packages/core/src/account.test.ts b/packages/core/src/account.test.ts
index f1d7abb..d85947d 100644
--- a/packages/core/src/account.test.ts
+++ b/packages/core/src/account.test.ts
@@ -3,7 +3,7 @@ import { accountFromClaimSecret } from "./account.js";
 
 const secret = new Uint8Array(32).fill(7);
 
-describe("accountFromClaimSecret — app-scoped key domains", () => {
+describe("accountFromClaimSecret, app-scoped key domains", () => {
   it("is deterministic per (secret, app)", () => {
     const a = accountFromClaimSecret(secret, "consumer");
     const b = accountFromClaimSecret(secret, "consumer");
diff --git a/packages/core/src/account.ts b/packages/core/src/account.ts
index feda9cf..2cae100 100644
--- a/packages/core/src/account.ts
+++ b/packages/core/src/account.ts
@@ -1,5 +1,5 @@
 /**
- * Benzo account — the key bundle a wallet holds. UI-facing: a frontend calls
+ * Benzo account, the key bundle a wallet holds. UI-facing: a frontend calls
  * `BenzoClient.createOrLoadAccount()` and never touches these internals.
  *
  * An account separates three authorities (BENZO.md §4.3 / §7):
@@ -71,17 +71,17 @@ export function createAccount(opts: {
   };
 }
 
-/** Product scope a claim link belongs to — separates the two apps' key domains. */
+/** Product scope a claim link belongs to, separates the two apps' key domains. */
 export type ClaimAppScope = "consumer" | "business";
 
 /**
  * Deterministically derive a full Benzo account from a claim secret (the
  * payload of a claim link). Anyone holding the secret reconstructs the exact
  * same spend/MVK/view keys and can therefore discover and spend the note that
- * was sent to this account — the basis of send-to-link.
+ * was sent to this account, the basis of send-to-link.
  *
  * The `app` scope is folded into the HKDF domain separator so a consumer claim
- * secret cannot reconstruct a business account, and vice-versa — the two-app
+ * secret cannot reconstruct a business account, and vice-versa, the two-app
  * boundary enforced cryptographically, not just in the UI. The "consumer"
  * domain is intentionally the legacy domain (`benzo/claim/...`) so existing
  * consumer claim links keep deriving the exact same account.
@@ -100,11 +100,11 @@ export const NOTE_KEY_MESSAGE = "BENZO-NOTE-KEY-v1";
 
 /**
  * Derive a full Benzo account (spend + viewing keys) from a SINGLE wallet
- * signature over NOTE_KEY_MESSAGE — the Railgun pattern. This is the piece no
+ * signature over NOTE_KEY_MESSAGE, the Railgun pattern. This is the piece no
  * embedded-wallet SDK (Dynamic/Privy/Para) provides: those manage only the
  * ed25519 SIGNING key, while Benzo's note keys are a separate layer. The user
  * signs `NOTE_KEY_MESSAGE` once; the same signature deterministically recovers
- * the same shielded account on any device — no second seed phrase.
+ * the same shielded account on any device, no second seed phrase.
  */
 export function accountFromSignedMessage(signature: Uint8Array, label = "wallet"): BenzoAccount {
   const spendOkm = hkdf(sha256, signature, undefined, "benzo/notekey/spend", 32);
@@ -140,7 +140,7 @@ export function verifyStellarSignature(stellarAddress: string, message: Uint8Arr
  * Deterministic serverless testnet account derivation. Vercel functions cannot
  * rely on a durable `~/.benzo/account.json`; deriving from the env-held testnet
  * wallet keeps note discovery stable across cold starts while preserving app
- * domain separation. This is for managed sandbox/API identities only — real
+ * domain separation. This is for managed sandbox/API identities only, real
  * end-user wallets should use `accountFromSignedMessage`/passkeys on-device.
  */
 export function accountFromServerSecret(
@@ -168,13 +168,13 @@ export type SignMessage = (message: string) => Promise<Uint8Array> | Uint8Array;
 /**
  * The headless login seam: turn ANY wallet's signer into a Benzo shielded
  * account. The user signs NOTE_KEY_MESSAGE once and `accountFromSignedMessage`
- * deterministically derives the spend/MVK/view keys — same account on every
+ * deterministically derives the spend/MVK/view keys, same account on every
  * device, no second seed phrase.
  *
  * This is the integration point for embedded-wallet logins. Dynamic is the
  * recommended Tier-1 Stellar provider (Privy/Para/passkeys also work): the
  * frontend obtains the wallet, gets its `signMessage`, and calls this. Nothing
- * here is frontend-specific — the signer is injected — so the seam is built and
+ * here is frontend-specific, the signer is injected, so the seam is built and
  * testable now and the UI simply supplies the signer later.
  */
 export async function loginWithSigner(signMessage: SignMessage, label = "wallet"): Promise<BenzoAccount> {
diff --git a/packages/core/src/client.ts b/packages/core/src/client.ts
index 2b2820f..4f3876c 100644
--- a/packages/core/src/client.ts
+++ b/packages/core/src/client.ts
@@ -1,5 +1,5 @@
 /**
- * BenzoClient — the single, UI-facing SDK facade.
+ * BenzoClient, the single, UI-facing SDK facade.
  *
  * A frontend (or any caller) uses ONLY this class: it hides the pool client,
  * the note scanner/indexer, the headless prover, and the viewing-key crypto
@@ -774,14 +774,14 @@ export class BenzoClient {
   }
 
   /**
-   * Confidential payroll from the org treasury — one `pool.transfer_org` per
+   * Confidential payroll from the org treasury, one `pool.transfer_org` per
    * payout under a ≥threshold member quorum (dual control enforced in-circuit).
    * The treasury note covering the whole run is spent and its remainder rolls
    * into a fresh CHANGE org note each time, so the treasury stays confidential
    * AND dual-controlled across the run. Individual salaries are never revealed
    * on-chain (each payout is its own confidential transfer).
    *
-   * `signerIndices` are the approving members (≥ threshold) — the cryptographic
+   * `signerIndices` are the approving members (≥ threshold), the cryptographic
    * embodiment of the maker-checker quorum. `sign(memberIndex, message)` lets
    * each approver self-sign client-side; omit it to sign from the derived keys.
    */
@@ -857,7 +857,7 @@ export class BenzoClient {
   }
 
   /**
-   * BATCHED confidential payroll — settle a run with ONE `batch_transfer_org` per
+   * BATCHED confidential payroll, settle a run with ONE `batch_transfer_org` per
    * chunk (one combined on-chain verification) instead of one tx per payout.
    *
    * Unlike `orgPayroll` (which chains a single covering note's change across
@@ -867,7 +867,7 @@ export class BenzoClient {
    * `maxPerTx` (default 8, inside the ~10-15 measured real-testnet limit) and
    * larger runs are auto-chunked into multiple batch txs (re-syncing between
    * chunks so change notes become spendable). HONEST: this batches VERIFICATION,
-   * not settlement — the win is one pairing check + one tx per chunk, not "all in
+   * not settlement, the win is one pairing check + one tx per chunk, not "all in
    * one proof".
    */
   async orgBatchPayroll(opts: {
@@ -899,7 +899,7 @@ export class BenzoClient {
       await this.sync();
 
       // Assign a DISTINCT covering treasury note to each payout (largest-first,
-      // each note used at most once — the contract also rejects intra-batch
+      // each note used at most once, the contract also rejects intra-batch
       // double-spends, but we must not even propose one).
       const avail = this.orgTreasuryNotes(org)
         .slice()
@@ -1059,7 +1059,7 @@ export class BenzoClient {
       }
     } catch (e) {
       if (e instanceof Error && e.message.includes("insufficient USDC")) throw e;
-      // else: read failure / no trustline — let the on-chain transfer decide.
+      // else: read failure / no trustline, let the on-chain transfer decide.
     }
   }
 
@@ -1144,7 +1144,7 @@ export class BenzoClient {
       const assetId = await this.assetId();
 
       // Spend one covering note (+ a dummy), or two notes when no single note
-      // covers the amount — the joinsplit circuit takes two inputs either way.
+      // covers the amount, the joinsplit circuit takes two inputs either way.
       //
       // On long-lived testnet deployments RPC event retention can leave the
       // local pool mirror gapped. The Merkle contract storage can recover a
@@ -1211,7 +1211,7 @@ export class BenzoClient {
         mvkCt: seal(changePlain, senderTvk.publicKey).bytes,
       };
       // Privacy: randomize output order so the change note isn't always in slot 1
-      // — otherwise an observer learns which output is the payment vs the change.
+      //, otherwise an observer learns which output is the payment vs the change.
       // Tornado-nova shuffles outputs for exactly this reason; discovery is
       // order-independent (the recipient finds its note by view tag, any slot).
       const [b0, b1] =
@@ -1504,7 +1504,7 @@ export class BenzoClient {
    * Confidential payroll / invoicing: pay many recipients in one batch where
    * each payout is an independent shielded transfer, so individual amounts and
    * recipients stay hidden on-chain. The employer can later prove the TOTAL to
-   * an auditor with `proveTotal()` (a ZK proof-of-sum verified on-chain) —
+   * an auditor with `proveTotal()` (a ZK proof-of-sum verified on-chain) -
    * salaries private, totals provable. Payouts settle sequentially.
    */
   async payroll(opts: {
@@ -1527,7 +1527,7 @@ export class BenzoClient {
   }
 
   /**
-   * @deprecated NOT zero-knowledge — this sums the in-scope notes in the clear
+   * @deprecated NOT zero-knowledge, this sums the in-scope notes in the clear
    * and asks the auditor to trust the figure (no proof). Use {@link proveTotal},
    * which produces a `proof_of_sum` Groth16 proof that verifies on-chain (vk_id
    * `SUM`). Kept only for debugging / back-compat; do not surface it as "the"
@@ -1541,7 +1541,7 @@ export class BenzoClient {
   // ----------------------------------------------------- proof-of-balance ----
 
   /**
-   * Prove this account owns at least `minAmount` USDC in the shielded pool —
+   * Prove this account owns at least `minAmount` USDC in the shielded pool -
    * without revealing the exact balance, the note count, or which notes. Returns
    * the proof in both snarkjs and Soroban-encoded forms (ready for the on-chain
    * verifier) plus the public inputs. Requires `circuits.proofOfBalance`.
@@ -1593,10 +1593,10 @@ export class BenzoClient {
    *
    * The old version collapsed three very different outcomes into a single bare
    * `false`: (1) the VK isn't registered on this cluster (`vk-unregistered`),
-   * (2) the proof is genuinely invalid (`invalid-proof` — the verifier traps
+   * (2) the proof is genuinely invalid (`invalid-proof`, the verifier traps
    * `InvalidProof` and fails closed), and (3) a transport/RPC failure
    * (`rpc-error`). Conflating them made a real, valid proof against an
-   * unregistered VK read as "verified then false" — i.e. ZK theater. We now
+   * unregistered VK read as "verified then false", i.e. ZK theater. We now
    * pre-check `has_vk` and classify the trap so the caller (and the logs) can
    * tell a missing key from a bad proof from a flaky RPC.
    */
@@ -1659,13 +1659,13 @@ export class BenzoClient {
   }
 
   /**
-   * Prove this account's shielded holdings sum to an EXACT total — the
+   * Prove this account's shielded holdings sum to an EXACT total, the
    * confidential disclose-total, a cryptographic replacement for the plaintext
    * `disclosedTotal`. Reveals only the total, never any individual amount.
    * Requires `circuits.proofOfSum`. Aggregates up to 4 notes (circuit-fixed).
    *
    * Completeness note: this proves "these owned notes sum to `total`", not
-   * "these are ALL my notes" — set-completeness composes with the authorized-MVK
+   * "these are ALL my notes", set-completeness composes with the authorized-MVK
    * registry binding.
    */
   async proveTotal(opts?: { context?: bigint }): Promise<{
@@ -1709,7 +1709,7 @@ export class BenzoClient {
   }
 
   /**
-   * ORG proof-of-sum — disclose the M-of-N TREASURY total to an auditor as a real
+   * ORG proof-of-sum, disclose the M-of-N TREASURY total to an auditor as a real
    * Groth16 proof verified ON-CHAIN (vk_id ORGSUM), revealing only the total, not
    * any individual salary. Unlike `proveTotal` (single-key notes), this proves the
    * sum over ORG notes owned by the member set. Aggregates up to MAX_SUM_NOTES.
@@ -1758,10 +1758,10 @@ export class BenzoClient {
   }
 
   /**
-   * ORG proof-of-balance — prove the M-of-N treasury holds AT LEAST `minTotal`,
+   * ORG proof-of-balance, prove the M-of-N treasury holds AT LEAST `minTotal`,
    * verified ON-CHAIN (vk_id ORGBAL), revealing nothing else. Powers the cryptographic
    * "Payroll funded ✓" (minTotal = run total), reserves-to-lender (covenant), and
-   * true solvency (minTotal = Σ liabilities). Returns `{ holds, onChain }` —
+   * true solvency (minTotal = Σ liabilities). Returns `{ holds, onChain }` -
    * `holds:false` (no proof) when the treasury can't cover the floor.
    */
   async proveOrgBalance(opts: { org: OrgIdentity; minTotal: bigint; context?: bigint }): Promise<{
@@ -1803,10 +1803,10 @@ export class BenzoClient {
   }
 
   /**
-   * In-ZK spending policy (Z3) — prove a payout to `to` of `amount` is WITHIN the
+   * In-ZK spending policy (Z3), prove a payout to `to` of `amount` is WITHIN the
    * approved per-payout `cap`, verified ON-CHAIN (vk_id SPENDCAP), WITHOUT
    * revealing the amount. The limit is a circuit constraint, so an over-cap payout
-   * cannot produce a proof — `withinCap:false` is a cryptographic "no". Use as a
+   * cannot produce a proof, `withinCap:false` is a cryptographic "no". Use as a
    * pre-settlement gate: a line that can't prove ≤ cap is provably blocked.
    */
   async proveOrgPayoutCap(opts: {
@@ -1849,7 +1849,7 @@ export class BenzoClient {
   }
 
   /**
-   * Per-payout proof-of-innocence (Z4) — prove a payout's RECIPIENT is NOT on a
+   * Per-payout proof-of-innocence (Z4), prove a payout's RECIPIENT is NOT on a
    * sanctions / deny set (OFAC-style deny SMT), verified ON-CHAIN (vk_id
    * POIPAYOUT), WITHOUT revealing the recipient. A sanctioned recipient is found
    * in the deny SMT ⇒ no non-inclusion proof exists ⇒ `innocent:false`, the
@@ -1895,7 +1895,7 @@ export class BenzoClient {
   }
 
   /**
-   * Anonymous approver / surveillance-free dual-control (Z5) — prove ≥`threshold`
+   * Anonymous approver / surveillance-free dual-control (Z5), prove ≥`threshold`
    * DISTINCT org approvers signed off on a run (`spendMessage`), verified ON-CHAIN
    * (vk_id ORGAUTH), WITHOUT revealing WHICH approvers signed. Dual-control
    * becomes a property of the proof; the approval leaves no surveillance trail of
@@ -1945,7 +1945,7 @@ export class BenzoClient {
   }
 
   /**
-   * Verifiable payroll computation (Z6) — prove the run total AND each per-line
+   * Verifiable payroll computation (Z6), prove the run total AND each per-line
    * note commitment were CORRECTLY DERIVED from the rate card (gross = rate ×
    * period − deductions, runTotal = Σ gross), verified ON-CHAIN (vk_id PAYCOMP),
    * with the RATE CARD kept PRIVATE. The total is computed-not-asserted: the chain
@@ -1978,7 +1978,7 @@ export class BenzoClient {
   }
 
   /**
-   * KYB-as-ZK credential (Z7) — prove the org holds an issuer-signed KYB
+   * KYB-as-ZK credential (Z7), prove the org holds an issuer-signed KYB
    * credential, disclosing only "verified business, jurisdiction Y, tier Z",
    * verified ON-CHAIN (vk_id KYB), WITHOUT revealing the documents. Emits a
    * scope-bound `orgNullifier` for one-credential-per-scope Sybil resistance.
@@ -2023,7 +2023,7 @@ export class BenzoClient {
   }
 
   /**
-   * Cross-entity private netting (Z8) — prove two parties' mutual inter-company
+   * Cross-entity private netting (Z8), prove two parties' mutual inter-company
    * invoices net to a single `net` amount (paid by the larger debtor), verified
    * ON-CHAIN (vk_id NETTING), WITHOUT revealing either gross. The two orgs settle
    * only the difference. Returns `net` + `payerIsA` (1 = A pays B, 0 = B pays A).
@@ -2116,7 +2116,7 @@ export class BenzoClient {
   /**
    * Create a claim link: privately send `amount` to a fresh account derived
    * from a random claim secret, and return a link carrying that secret. Anyone
-   * with the link can claim the funds — no prior account or on-chain state.
+   * with the link can claim the funds, no prior account or on-chain state.
    */
   async createClaimLink(opts: {
     amount: bigint;
@@ -2142,7 +2142,7 @@ export class BenzoClient {
   /**
    * Claim a link's funds into a public Stellar address. This client ADOPTS the
    * claim account (derived from the secret), scans, and unshields the full
-   * balance to `toAddress` — settling the claim on-chain.
+   * balance to `toAddress`, settling the claim on-chain.
    */
   async claim(opts: {
     claimSecret: Uint8Array;
@@ -2389,7 +2389,7 @@ export function stroopsToUsdc(stroops: bigint): string {
 
 /**
  * Parse a human USDC amount ("25", "25.50", "0.0000001") to stroops (1 USDC =
- * 1e7), losslessly via string math — unlike `BigInt(Math.round(n * 1e7))`,
+ * 1e7), losslessly via string math, unlike `BigInt(Math.round(n * 1e7))`,
  * which loses precision past ~9e9 USDC or beyond 7 decimals.
  */
 export function usdcToStroops(amount: string): bigint {
diff --git a/packages/core/src/crypto/bytes.ts b/packages/core/src/crypto/bytes.ts
index 1028dd7..0bbe21d 100644
--- a/packages/core/src/crypto/bytes.ts
+++ b/packages/core/src/crypto/bytes.ts
@@ -1,5 +1,5 @@
 /**
- * Byte helpers — hex / base64url / concat over Uint8Array.
+ * Byte helpers, hex / base64url / concat over Uint8Array.
  *
  * Core uses these instead of Node's `Buffer` so the protocol modules bundle for
  * the browser without a Buffer polyfill. `btoa`/`atob` are globals in Node 20+
diff --git a/packages/core/src/crypto/poseidon2.ts b/packages/core/src/crypto/poseidon2.ts
index 073a52b..435204c 100644
--- a/packages/core/src/crypto/poseidon2.ts
+++ b/packages/core/src/crypto/poseidon2.ts
@@ -1,5 +1,5 @@
 /**
- * Poseidon2 over the BN254 scalar field — TypeScript mirror.
+ * Poseidon2 over the BN254 scalar field, TypeScript mirror.
  *
  * The parameterization (d=5, RF=8, RP=56, round constants, internal matrix
  * diagonals for t = 2/3/4) is loaded from the pinned canonical JSON
diff --git a/packages/core/src/crypto/random.ts b/packages/core/src/crypto/random.ts
index 36d3c04..920a570 100644
--- a/packages/core/src/crypto/random.ts
+++ b/packages/core/src/crypto/random.ts
@@ -2,7 +2,7 @@
  * Cross-runtime CSPRNG bytes via the Web Crypto API.
  *
  * `globalThis.crypto.getRandomValues` is available as a global in Node 20+ and
- * every browser, so core never has to import `node:crypto` — keeping the hot
+ * every browser, so core never has to import `node:crypto`, keeping the hot
  * path (note blindings, claim secrets) browser-portable. Same CSPRNG quality on
  * both runtimes.
  */
diff --git a/packages/core/src/index.browser.ts b/packages/core/src/index.browser.ts
index 4afe230..ef1ffa8 100644
--- a/packages/core/src/index.browser.ts
+++ b/packages/core/src/index.browser.ts
@@ -1,5 +1,5 @@
 /**
- * Browser entry for @benzo/core — everything EXCEPT the two node-only modules:
+ * Browser entry for @benzo/core, everything EXCEPT the two node-only modules:
  *   - stellar.js      (StellarCli shells `node:child_process`)
  *   - account-file.js (file persistence via `node:fs`)
  *
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index eadbb71..d7bcb65 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @benzo/core — headless TypeScript SDK for the Benzo shielded-USDC protocol
+ * @benzo/core, headless TypeScript SDK for the Benzo shielded-USDC protocol
  * on Stellar (Soroban).
  *
  * Modules:
diff --git a/packages/core/src/kybcredential.ts b/packages/core/src/kybcredential.ts
index 6a214c2..8f6c3b7 100644
--- a/packages/core/src/kybcredential.ts
+++ b/packages/core/src/kybcredential.ts
@@ -3,13 +3,13 @@
  *
  * Builds + proves the kyb_credential circuit: an org proves it holds a KYB
  * credential signed by an AUTHORIZED issuer, disclosing ONLY "verified business,
- * jurisdiction Y, tier Z" — WITHOUT revealing the underlying documents (only
+ * jurisdiction Y, tier Z", WITHOUT revealing the underlying documents (only
  * their hash is signed, and it stays private). A scope-bound `orgNullifier` gives
  * one-credential-per-scope Sybil resistance.
  *
  * Node-only (circomlibjs EdDSA/Poseidon/BabyJubJub); exported from index.ts. The
  * managed service holds the issuer key and re-issues credentials from a verified
- * identity (Plaid KYB / document IDV) — the docs never reach the chain.
+ * identity (Plaid KYB / document IDV), the docs never reach the chain.
  *
  * Public inputs: [issuerRegistryRoot, jurisdiction, tier, currentTime, scope,
  *                 orgNullifier, addressBinding].
diff --git a/packages/core/src/merkle.ts b/packages/core/src/merkle.ts
index ff500a6..8bc315e 100644
--- a/packages/core/src/merkle.ts
+++ b/packages/core/src/merkle.ts
@@ -3,7 +3,7 @@
  * (contracts/merkle): same Poseidon2 compression, same zero table, so paths
  * computed here fold to exactly the on-chain roots.
  *
- * Incremental, stored-node design (the pattern every production mixer uses —
+ * Incremental, stored-node design (the pattern every production mixer uses -
  * Tornado/Railgun/NethermindEth's stellar-private-payments): each level keeps
  * its filled nodes, so `insert` updates only the O(levels) spine, `root` is
  * O(1), and `path` is O(levels). The previous version recomputed the whole
diff --git a/packages/core/src/mvk-registry.test.ts b/packages/core/src/mvk-registry.test.ts
index 51a02c7..4b64b4e 100644
--- a/packages/core/src/mvk-registry.test.ts
+++ b/packages/core/src/mvk-registry.test.ts
@@ -20,7 +20,7 @@ describe("MvkRegistryMirror.syncWithOwnedKey", () => {
 
   it("yields a valid path for an owned key that is NOT the tail (the claim bug)", () => {
     const m = new MvkRegistryMirror();
-    m.syncWithOwnedKey(leaves, 22n); // middle key — used to throw 'MVK not registered'
+    m.syncWithOwnedKey(leaves, 22n); // middle key, used to throw 'MVK not registered'
     expect(() => m.pathFor(22n)).not.toThrow();
     expect(m.pathFor(22n)).toEqual(ref.pathFor(22n));
   });
diff --git a/packages/core/src/mvk-registry.ts b/packages/core/src/mvk-registry.ts
index f77c6c8..f5a4dcb 100644
--- a/packages/core/src/mvk-registry.ts
+++ b/packages/core/src/mvk-registry.ts
@@ -4,7 +4,7 @@
  * note's MVK is a member of this registry under a recent `registeredMvkRoot`
  * (leaf = `mvkRegistryLeaf(mvkPub, keyMeta)`, the circuit's
  * `BenzoMvkRegistryLeaf`, domain 0x08). To build that witness the SDK needs the
- * registry root + a Merkle path to the MVK's leaf — exactly what this mirror
+ * registry root + a Merkle path to the MVK's leaf, exactly what this mirror
  * provides, the same way `MerkleTreeMirror` mirrors the pool and ASP trees.
  *
  * Depth is pinned to the circuit's `mvkLevels` (16). The on-chain registry is
@@ -22,7 +22,7 @@
 import { MerkleTreeMirror, type MerklePath } from "./merkle.js";
 import { mvkRegistryLeaf } from "./notes.js";
 
-/** Circuit `mvkLevels` — the on-chain registry must be deployed with this depth. */
+/** Circuit `mvkLevels`, the on-chain registry must be deployed with this depth. */
 export const MVK_REGISTRY_DEPTH = 16;
 
 /** Default `keyMeta` (packs org/scope/expiry/epoch; a single 0 field for the MVP). */
@@ -42,7 +42,7 @@ export class MvkRegistryMirror {
    * Replay prior on-chain state: reset and insert `leaves` (raw leaf values from
    * `MvkRegistered` events, in index order) so the mirror's root tracks a
    * registry that already holds entries. Subsequent `register()` calls append
-   * after them — exactly as the contract does — so the root stays in lockstep.
+   * after them, exactly as the contract does, so the root stays in lockstep.
    * Prior leaves carry no `mvkPub→index` mapping (we only need paths for keys
    * this process registers); `pathFor` on a synced-but-not-registered key throws.
    */
@@ -82,7 +82,7 @@ export class MvkRegistryMirror {
     return this.index.has(mvkPub);
   }
 
-  /** Current registry root — the witness's `registeredMvkRoot`. */
+  /** Current registry root, the witness's `registeredMvkRoot`. */
   root(): bigint {
     return this.tree.root();
   }
@@ -95,7 +95,7 @@ export class MvkRegistryMirror {
   }
 
   /**
-   * A one-entry registry holding just `mvkPub` — the well-formed-proof stand-in
+   * A one-entry registry holding just `mvkPub`, the well-formed-proof stand-in
    * used until the registry is deployed and synced. Equivalent to `new
    * MvkRegistryMirror()` + a single `register`.
    */
diff --git a/packages/core/src/notes.ts b/packages/core/src/notes.ts
index a4e4a8e..859c55b 100644
--- a/packages/core/src/notes.ts
+++ b/packages/core/src/notes.ts
@@ -1,5 +1,5 @@
 /**
- * Benzo shielded notes — the canonical cryptographic invariants.
+ * Benzo shielded notes, the canonical cryptographic invariants.
  *
  * Key hierarchy (mirrors circuits/groth16/note.circom BenzoSpendKeys):
  *   ak (spend-auth) = Poseidon2(orgSpendId, 0)  (domain 0x06)
@@ -29,12 +29,12 @@ export const ORG_NOTE_DOMAIN = 0x09n;
 // --------------------------------------------------------------- org notes ----
 // An ORG note is a shielded note owned by an M-of-N member set, not a single key.
 // Its recipient_pk is the PREIMAGE-BOUND hash of (memberRoot, threshold, the
-// group spend-auth pub) under the ORG domain — so the only way to satisfy the
+// group spend-auth pub) under the ORG domain, so the only way to satisfy the
 // commitment's owner branch is the in-circuit M-of-N path in `joinsplit_org`
 // (`pool.transfer_org`). A single key can never move it: there is no `ak` whose
 // keypair pub equals an org recipient_pk. Mirrors circuits/groth16/org_note_spend.
 
-/** The org's GROUP spend-auth public — akGroup is the group key (FROST ak / dev). */
+/** The org's GROUP spend-auth public, akGroup is the group key (FROST ak / dev). */
 export function akGroupPub(akGroup: bigint): bigint {
   return hash([akGroup, 0n], KEYPAIR_DOMAIN);
 }
@@ -45,7 +45,7 @@ export function orgRecipientPk(memberRoot: bigint, threshold: bigint, akGroup: b
 }
 
 /**
- * Org-note nullifier — double-spend-safe AND unlinkable. Keyed by an org
+ * Org-note nullifier, double-spend-safe AND unlinkable. Keyed by an org
  * nullifier secret nk_org = Poseidon2(akGroup, blinding; NK), so two org notes
  * of the same set produce unrelated nullifiers (no org spend-graph leak):
  *   nullifier = Poseidon2(nk_org, leaf_index; NULLIFIER).
@@ -55,7 +55,7 @@ export function orgNullifier(akGroup: bigint, blinding: bigint, leafIndex: bigin
 }
 
 /**
- * Authorized-MVK registry leaf = Poseidon2(mvkPub, keyMeta) — mirrors
+ * Authorized-MVK registry leaf = Poseidon2(mvkPub, keyMeta), mirrors
  * circuits/groth16/note.circom BenzoMvkRegistryLeaf. A note's MVK tag is only
  * valid when this leaf is a member of the registered-MVK root, so every note is
  * bound to a real registered viewing key. `keyMeta` packs org/scope/expiry/epoch.
@@ -71,7 +71,7 @@ export interface SpendKeys {
 
 /**
  * Derive the spend-auth key `ak` and the SEPARATE nullifier key `nk` from one
- * root `orgSpendId` — mirrors circuits/groth16/note.circom BenzoSpendKeys.
+ * root `orgSpendId`, mirrors circuits/groth16/note.circom BenzoSpendKeys.
  * N=1 (consumer): orgSpendId is the account seed. M-of-N (org): orgSpendId is
  * split off-circuit via FROST with `ak` as the group key.
  */
@@ -113,7 +113,7 @@ export interface Note {
 
 export function noteCommitment(note: Note): bigint {
   // t=4 permutation over exactly [amount, recipient_pk, blinding, asset_id]
-  // (asset_id in the capacity slot) — see circuits/groth16/note.circom.
+  // (asset_id in the capacity slot), see circuits/groth16/note.circom.
   return hash([note.amount, note.recipientPk, note.blinding], note.assetId);
 }
 
diff --git a/packages/core/src/onboard.ts b/packages/core/src/onboard.ts
index 7afb92d..184ef97 100644
--- a/packages/core/src/onboard.ts
+++ b/packages/core/src/onboard.ts
@@ -1,5 +1,5 @@
 /**
- * Sponsored onboarding — assemble + sign + submit the CAP-33 reserve sandwich
+ * Sponsored onboarding, assemble + sign + submit the CAP-33 reserve sandwich
  * from reserves.ts so a brand-new user gets a usable account at ZERO XLM with a
  * USDC trustline, both reserves paid by the sponsor. The user funds nothing and
  * signs once.
@@ -20,7 +20,7 @@ import { sponsoredCreateAccountOps, sponsoredTrustlineOps } from "./reserves.js"
 export interface OnboardParams {
   horizonUrl: string;
   networkPassphrase: string;
-  /** sponsor account secret — pays both reserves (the deployer/relayer) */
+  /** sponsor account secret, pays both reserves (the deployer/relayer) */
   sponsorSecret: string;
   asset: { code: string; issuer: string };
   /** reuse an existing keypair, or omit to generate a fresh account */
@@ -47,7 +47,7 @@ export async function sponsoredOnboard(params: OnboardParams): Promise<OnboardRe
     networkPassphrase: params.networkPassphrase,
   });
   // create the account (reserve sponsored) then add the USDC trustline (reserve
-  // sponsored) — both in one atomic transaction; the new account exists by the
+  // sponsored), both in one atomic transaction; the new account exists by the
   // time its later ops execute.
   for (const op of sponsoredCreateAccountOps({
     sponsor: sponsor.publicKey(),
@@ -71,7 +71,7 @@ export async function sponsoredOnboard(params: OnboardParams): Promise<OnboardRe
  * NON-CUSTODIAL onboarding (the wallet path): the browser generates its own
  * keypair and only sends its PUBLIC key. The sponsor service builds the
  * create+trustline tx, signs with the sponsor key, and returns the XDR. The
- * browser then signs with its own key and submits — the server never sees the
+ * browser then signs with its own key and submits, the server never sees the
  * user's secret.
  */
 export async function prepareSponsoredOnboard(params: {
diff --git a/packages/core/src/org.ts b/packages/core/src/org.ts
index c9183f0..1eaddc8 100644
--- a/packages/core/src/org.ts
+++ b/packages/core/src/org.ts
@@ -6,7 +6,7 @@
  * `joinsplit_org` proof carrying ≥ threshold distinct member EdDSA signatures
  * over the spend message. This module builds that member set (a Baby-Jubjub
  * EdDSA keypair per member + a Merkle tree of member key-ids) and signs the
- * spend message — the cryptographic embodiment of a maker-checker approval.
+ * spend message, the cryptographic embodiment of a maker-checker approval.
  *
  * Browser-safe: circomlibjs (eddsa + poseidon) is already a dependency. The
  * heavy WASM builders are lazily constructed once and reused.
@@ -20,7 +20,7 @@ import { FIELD_MODULUS } from "./crypto/poseidon2.js";
 import { toHex } from "./crypto/bytes.js";
 import { randomBytes } from "./crypto/random.js";
 
-/** Depth of the in-circuit member tree — must match JoinSplitOrg(_, ML=16). */
+/** Depth of the in-circuit member tree, must match JoinSplitOrg(_, ML=16). */
 export const ORG_MEMBER_DEPTH = 16;
 
 // Lazy circomlibjs singletons (WASM init is ~50ms; do it once).
@@ -39,7 +39,7 @@ export interface OrgMember {
   /** Public key coordinates (decimal field elements). */
   Ax: bigint;
   Ay: bigint;
-  /** Member-tree leaf = Poseidon(Ax, Ay) — the identity committed on-chain. */
+  /** Member-tree leaf = Poseidon(Ax, Ay), the identity committed on-chain. */
   keyId: bigint;
 }
 
@@ -109,7 +109,7 @@ export async function buildOrgIdentity(
  * The message ≥threshold members must sign for a 2-in/2-out org spend:
  *   spendMessage = Poseidon(nullifier0, nullifier1, outCommitment0, outCommitment1).
  * Derived from the (public) nullifiers + output commitments, so any change to
- * the spend invalidates the signatures — they must be collected LAST.
+ * the spend invalidates the signatures, they must be collected LAST.
  */
 export async function orgSpendMessage(
   n0: bigint,
@@ -139,7 +139,7 @@ export async function signOrgSpend(
  * Deterministically derive an org identity (member EdDSA keys + group spend-auth
  * secret) from a single root seed, domain-separated by orgId. HKDF is pure, so
  * the SAME (seed, orgId) yields the SAME identity in the browser, the CLI, and a
- * self-hosted BFF — the deployed and self-hosted apps interoperate, and a member
+ * self-hosted BFF, the deployed and self-hosted apps interoperate, and a member
  * can re-derive their key by signing once (no second secret to store). Each
  * member's `prv` is the key that member downloads / holds for self-signing.
  *
@@ -147,7 +147,7 @@ export async function signOrgSpend(
  * `set_member_root`) and matches the org notes' `recipientPk`.
  */
 export async function deriveOrgIdentity(opts: {
-  /** root IKM — the org owner's account seed or a dedicated org root secret. */
+  /** root IKM, the org owner's account seed or a dedicated org root secret. */
   seed: Uint8Array;
   /** namespace so one seed can host distinct orgs. */
   orgId: string | number;
diff --git a/packages/core/src/orgauth.ts b/packages/core/src/orgauth.ts
index c2d2713..d9807ca 100644
--- a/packages/core/src/orgauth.ts
+++ b/packages/core/src/orgauth.ts
@@ -5,7 +5,7 @@
  * vk_id ORGAUTH): at least `threshold` DISTINCT approvers each EdDSA-signed the
  * SAME run binding (`spendMessage`), WITHOUT revealing WHICH approvers signed.
  * The chain accepts the authorization only if a real threshold of member
- * signatures is present — dual-control becomes a property of the proof, and the
+ * signatures is present, dual-control becomes a property of the proof, and the
  * approver identities stay private (no surveillance trail of who signed what).
  *
  * The circuit enforces distinctness (no approver counts twice), and `authTag =
@@ -74,7 +74,7 @@ export interface ProveOrgApprovalParams {
 /**
  * Build the witness and generate an anonymous M-of-N approval proof. The proof
  * attests `signerIndices.length` distinct members signed `spendMessage`, but the
- * public inputs reveal only the count threshold — never which members.
+ * public inputs reveal only the count threshold, never which members.
  */
 export async function proveOrgApproval(
   params: ProveOrgApprovalParams,
diff --git a/packages/core/src/payoutinnocence.ts b/packages/core/src/payoutinnocence.ts
index 735953e..f9c60db 100644
--- a/packages/core/src/payoutinnocence.ts
+++ b/packages/core/src/payoutinnocence.ts
@@ -3,7 +3,7 @@
  *
  * Proves the RECIPIENT of a payout is NOT on a sanctions / deny set (an OFAC-style
  * deny SMT) WITHOUT revealing who the recipient is. A sanctioned recipient cannot
- * produce a non-inclusion proof, so that payout is provably blocked — the deny
+ * produce a non-inclusion proof, so that payout is provably blocked, the deny
  * screen is enforced by cryptography, bound to the payout's note commitment.
  *
  * Public inputs: [denyRoot, commitment, assetId, context].
diff --git a/packages/core/src/payrollcomp.ts b/packages/core/src/payrollcomp.ts
index c61f56f..e893831 100644
--- a/packages/core/src/payrollcomp.ts
+++ b/packages/core/src/payrollcomp.ts
@@ -2,8 +2,8 @@
  * Verifiable payroll computation (Z6).
  *
  * Proves the run total AND every per-line note commitment were CORRECTLY DERIVED
- * from the rate card — gross_i = rate_i * period_i - deductions_i, runTotal =
- * Σ gross_i — with the RATE CARD kept PRIVATE. The total is computed, not
+ * from the rate card, gross_i = rate_i * period_i - deductions_i, runTotal =
+ * Σ gross_i, with the RATE CARD kept PRIVATE. The total is computed, not
  * asserted: the chain accepts it only if it equals the sum of the hidden grosses.
  *
  * `commitDigest` = Poseidon2 binary fold over the per-line note commitments binds
diff --git a/packages/core/src/pool.ts b/packages/core/src/pool.ts
index f6fd31c..33b48af 100644
--- a/packages/core/src/pool.ts
+++ b/packages/core/src/pool.ts
@@ -60,7 +60,7 @@ export interface CircuitSet {
   joinsplitOrg?: CircuitArtifacts;
   /** optional proof-of-balance circuit (prove funds ≥ threshold) */
   proofOfBalance?: CircuitArtifacts;
-  /** optional proof-of-sum circuit (disclose an EXACT total — confidential disclose-total) */
+  /** optional proof-of-sum circuit (disclose an EXACT total, confidential disclose-total) */
   proofOfSum?: CircuitArtifacts;
   /** optional ORG proof-of-sum (disclose the M-of-N treasury total, ZK, verified on-chain) */
   proofOfSumOrg?: CircuitArtifacts;
@@ -141,7 +141,7 @@ export class BenzoPoolClient {
    * Use a shared, on-chain-synced MVK registry mirror for all subsequent money
    * ops. Every MVK a note binds to must already be `register`ed in `mirror`
    * (and on-chain) so its root is a known registry root; `pathFor` throws
-   * otherwise — the correct fail-closed behavior for an unregistered key.
+   * otherwise, the correct fail-closed behavior for an unregistered key.
    */
   useMvkRegistry(mirror: MvkRegistryMirror): void {
     this.mvkRegistry = mirror;
@@ -383,7 +383,7 @@ export class BenzoPoolClient {
     /**
      * Optional gasless-relay hook. When provided, the proven transfer is
      * handed to the relayer for submission instead of being submitted by this
-     * client — the relayer pays the XLM fee. The proof is self-authorizing, so
+     * client, the relayer pays the XLM fee. The proof is self-authorizing, so
      * the relayer cannot alter the transfer.
      */
     relay?: (args: {
@@ -456,7 +456,7 @@ export class BenzoPoolClient {
     });
 
     // Authorized-MVK registry membership for each output's MVK (closes the audit
-    // P0 — see shield). A shared synced registry (if set) yields an on-chain-known
+    // P0, see shield). A shared synced registry (if set) yields an on-chain-known
     // root; otherwise build a local one over just this op's outputs.
     const mvkKeyMeta = DEFAULT_MVK_KEY_META;
     let mvkReg: MvkRegistryMirror;
@@ -610,7 +610,7 @@ export class BenzoPoolClient {
   /**
    * Spend an ORG treasury note under in-circuit M-of-N dual control
    * (`pool.transfer_org`, VK `JSPLITORG`). The org note can ONLY move because
-   * ≥ threshold distinct members signed the spend message — the cryptographic
+   * ≥ threshold distinct members signed the spend message, the cryptographic
    * embodiment of a maker-checker approval, enforced in-circuit, not by a server.
    *
    * input0 = the org note (owner = org.recipientPk); input1 = a genuine zero
@@ -625,7 +625,7 @@ export class BenzoPoolClient {
    */
   /**
    * Build ONE org join-split: validate, assemble the witness, and prove
-   * `joinsplit_org` — WITHOUT submitting. Returns the proof + the JSON-ready
+   * `joinsplit_org`, WITHOUT submitting. Returns the proof + the JSON-ready
    * `OrgSpend` struct (matching the pool's `OrgSpend` contract type) so the
    * caller can either submit a single `transfer_org` (see `transferOrg`) or
    * bundle many into one `batch_transfer_org` (see `batchTransferOrg`). The
@@ -677,7 +677,7 @@ export class BenzoPoolClient {
     const root = this.poolTree.root();
 
     // Pad the candidate set to MAX_ORG_SIGNERS slots (unused slots reuse a real
-    // member with enabled=0 — the circuit only verifies enabled slots).
+    // member with enabled=0, the circuit only verifies enabled slots).
     const cand = Array.from({ length: MAX_ORG_SIGNERS }, (_, i) =>
       i < org.members.length ? i : 0,
     );
@@ -721,7 +721,7 @@ export class BenzoPoolClient {
       "--mvk_ct1", hexBytes(opts.mvkCts[1]),
     ]);
 
-    // spend message = Poseidon(n0,n1,c0,c1) — collect approvals LAST.
+    // spend message = Poseidon(n0,n1,c0,c1), collect approvals LAST.
     const spendMessage = await orgSpendMessage(n0, n1, outCommitments[0], outCommitments[1]);
     const getSig = async (slot: number): Promise<OrgSignature> => {
       const member = org.members[cand[slot]];
@@ -807,7 +807,7 @@ export class BenzoPoolClient {
   }
 
   /**
-   * Single org join-split (M-of-N dual control) — settles under the JSPLITORG VK.
+   * Single org join-split (M-of-N dual control), settles under the JSPLITORG VK.
    * Thin wrapper over `buildOrgSpend` + a `transfer_org` submit (unchanged shape).
    */
   async transferOrg(opts: {
@@ -1045,7 +1045,7 @@ export class BenzoPoolClient {
     ]);
 
     // Authorized-MVK registry membership of the change note's MVK (closes the
-    // audit P0 — see shield). Shared synced registry (if set) → on-chain-known
+    // audit P0, see shield). Shared synced registry (if set) → on-chain-known
     // root; otherwise a single-leaf stand-in over the change MVK.
     const mvkKeyMeta = DEFAULT_MVK_KEY_META;
     const mvkReg = opts.changeMvkWitness ? undefined : (this.mvkRegistry ?? MvkRegistryMirror.singleLeaf(opts.changeMvkPubScalar, mvkKeyMeta));
diff --git a/packages/core/src/prover.ts b/packages/core/src/prover.ts
index 54fe2e4..0c5c017 100644
--- a/packages/core/src/prover.ts
+++ b/packages/core/src/prover.ts
@@ -1,5 +1,5 @@
 /**
- * Headless Groth16 proving (Node — never a browser).
+ * Headless Groth16 proving (Node, never a browser).
  *
  * Wraps snarkjs `groth16.fullProve` over the compiled circuit artifacts
  * (witness-generator WASM + proving zkey) and returns both the snarkjs JSON
@@ -38,7 +38,7 @@ type WitnessValue = string | WitnessValue[];
 type BigNest = bigint | BigNest[];
 export type WitnessInput = Record<string, WitnessValue>;
 
-/** Recursively serialize bigints (any nesting depth — the org join-split needs
+/** Recursively serialize bigints (any nesting depth, the org join-split needs
  *  3D `mPathElements`) into snarkjs input form. */
 function serWitness(v: BigNest): WitnessValue {
   return typeof v === "bigint" ? v.toString() : v.map(serWitness);
@@ -78,7 +78,7 @@ export async function verifyLocal(
 /**
  * A pluggable proving backend: turns a witness into a Groth16 proof. Core builds
  * witnesses and calls a `ProverPort`; the runtime (Node / browser WASM / native)
- * decides *where* the proof is generated — so swapping runtimes never touches
+ * decides *where* the proof is generated, so swapping runtimes never touches
  * protocol logic. This is the seam that lets the same `BenzoClient` run headless
  * on the CLI and client-side in the browser.
  */
@@ -96,7 +96,7 @@ export class NodeProver implements ProverPort {
 }
 
 /**
- * On-device Groth16 proving via snarkjs — the same proof output as NodeProver,
+ * On-device Groth16 proving via snarkjs, the same proof output as NodeProver,
  * but it accepts preloaded `Uint8Array` artifacts (fetched once in the browser)
  * and never assumes `node:fs`, so it runs in a Web Worker on the user's device.
  * The witness and proving key never leave the device. `packages/proving-worker`
diff --git a/packages/core/src/relay.ts b/packages/core/src/relay.ts
index 78a9685..86b4afd 100644
--- a/packages/core/src/relay.ts
+++ b/packages/core/src/relay.ts
@@ -1,5 +1,5 @@
 /**
- * The gasless `transfer` relay argument shape — shared by the in-client relay
+ * The gasless `transfer` relay argument shape, shared by the in-client relay
  * hook (BenzoClient.makeRelay) and the standalone @benzo/relayer service, so the
  * fnArgs are defined once. Pure + browser-safe.
  */
diff --git a/packages/core/src/reserves.ts b/packages/core/src/reserves.ts
index 98e74f9..78f5e71 100644
--- a/packages/core/src/reserves.ts
+++ b/packages/core/src/reserves.ts
@@ -1,11 +1,11 @@
 /**
- * Sponsored reserves (CAP-33) — gasless onboarding.
+ * Sponsored reserves (CAP-33), gasless onboarding.
  *
  * A new Stellar account normally needs ~1 XLM of base reserve before it can
  * exist or hold a USDC trustline. That is the single biggest friction for a
  * web2 user who has never heard of XLM. With sponsored reserves, Benzo's
  * sponsor account pays the reserve while the user's account starts at a 0 XLM
- * balance — the user funds nothing and signs once.
+ * balance, the user funds nothing and signs once.
  *
  * The on-chain shape is a three-operation sandwich:
  *   beginSponsoringFutureReserves(sponsoredId = newAccount)   [signed by sponsor]
@@ -30,7 +30,7 @@ export interface SponsoredCreateAccountParams {
 
 /**
  * Build the begin/create/end operation sandwich that creates `newAccount`
- * with its base reserve paid by `sponsor`. Pure — returns operations to drop
+ * with its base reserve paid by `sponsor`. Pure, returns operations to drop
  * into a TransactionBuilder; the caller loads the source account, sets fee +
  * timebounds, and collects both signatures.
  */
diff --git a/packages/core/src/scanner.ts b/packages/core/src/scanner.ts
index 1f268a8..f5ba05a 100644
--- a/packages/core/src/scanner.ts
+++ b/packages/core/src/scanner.ts
@@ -1,5 +1,5 @@
 /**
- * On-chain note discovery — the scanning core shared by the SDK facade and the
+ * On-chain note discovery, the scanning core shared by the SDK facade and the
  * standalone @benzo/indexer service.
  *
  * Reads the pool's `new_commitment_event` / `new_nullifier_event` and the
@@ -283,7 +283,7 @@ export class NoteScanner {
    * orgRecipientPk) that the org's viewing key can decrypt and that are not yet
    * spent via the org nullifier (keyed by akGroup + blinding, not a single
    * spendSk). This is how the console rediscovers its dual-controlled treasury
-   * from chain — no backend storage; the org MVK + akGroup are sufficient.
+   * from chain, no backend storage; the org MVK + akGroup are sufficient.
    */
   orgSpendable(
     viewingSecret: Uint8Array,
@@ -352,14 +352,14 @@ async function getEventsRpc(
         });
         if (res.status >= 500 || res.status === 429) {
           lastErr = new Error(`getEvents HTTP ${res.status}`);
-          continue; // transient — retry
+          continue; // transient, retry
         }
         return (await res.json()) as { result?: EventsPage; error?: { message: string } };
       } finally {
         clearTimeout(timer);
       }
     } catch (e) {
-      lastErr = e; // network/timeout — retry
+      lastErr = e; // network/timeout, retry
     }
   }
   throw new Error(`getEvents failed after retries: ${String(lastErr)}`);
@@ -377,7 +377,7 @@ export async function collectEvents(
   let json = await post({ startLedger, filters, pagination: { limit: 10000 } });
   // If startLedger has aged out of the retention window, RPC returns a range
   // error naming the oldest retained ledger; restart from there (explicit, not
-  // silent — a durable store keeps anything that aged out from a prior sync).
+  // silent, a durable store keeps anything that aged out from a prior sync).
   for (let attempt = 0; attempt < 6 && json.error; attempt++) {
     const m = /(\d+)\s*-\s*(\d+)/.exec(json.error.message);
     if (!m) break;
@@ -447,7 +447,7 @@ export async function fetchAspLeaves(
  * `startLedger`) into `prior` ordered leaves, returning the merged ordered
  * list plus the highest ledger seen (the resume cursor). The allow-set is
  * append-only and index-addressed, so a durable caller persists `{leaves,
- * cursor}` and resumes from `cursor + 1` — never re-fetching the whole set.
+ * cursor}` and resumes from `cursor + 1`, never re-fetching the whole set.
  */
 export async function fetchAspLeavesSince(
   rpcUrl: string,
@@ -839,7 +839,7 @@ export async function fetchPoolWitnessFromStorageWithKnownSuffix(
 
 /**
  * Reconstruct the ordered authorized-MVK registry leaves from on-chain
- * `MvkRegistered` events — the raw leaf values, indexed by the event's `index`,
+ * `MvkRegistered` events, the raw leaf values, indexed by the event's `index`,
  * so `MvkRegistryMirror.syncLeaves(...)` can resume a registry that already
  * holds entries (e.g. a second e2e flow appending to the same deployment).
  */
diff --git a/packages/core/src/scval.ts b/packages/core/src/scval.ts
index 1d23c8f..a06121a 100644
--- a/packages/core/src/scval.ts
+++ b/packages/core/src/scval.ts
@@ -6,8 +6,8 @@
  * SDK's spec parser chokes on our >10-fn specs).
  *
  * Two entry points share one table:
- *   - `scvalForArg`      — the read surface (no proof struct; reads never carry one).
- *   - `scvalForWriteArg` — the read surface PLUS the Groth16 `--proof` struct,
+ *   - `scvalForArg`     , the read surface (no proof struct; reads never carry one).
+ *   - `scvalForWriteArg`, the read surface PLUS the Groth16 `--proof` struct,
  *                          so a browser can build+sign a write client-side
  *                          instead of handing it to a custodial relayer.
  */
@@ -26,7 +26,7 @@ function fixedBytes32(value: string): Uint8Array {
 /** Coerce a single CLI read arg (`name`, `value`) to its ScVal by name. */
 export function scvalForArg(name: string, value: string): xdr.ScVal {
   // VK identifier (e.g. "BALANCE"/"SHIELD") is an on-chain `Symbol`, NOT a
-  // string — a String-for-Symbol arg traps the contract (UnreachableCodeReached).
+  // string, a String-for-Symbol arg traps the contract (UnreachableCodeReached).
   if (name === "vk_id") return nativeToScVal(value, { type: "symbol" });
   // Groth16 public inputs: a Vec<Bn254Fr> (encoded on-chain as Vec<U256>). Each
   // field element is a 254-bit scalar (decimal string) → U256, matching how the
@@ -80,7 +80,7 @@ export function scvalForArg(name: string, value: string): xdr.ScVal {
 
 /**
  * The on-chain `Groth16Proof` is `{ a, b, c }` where `a`/`c` are 64-byte G1 and
- * `b` is a 128-byte G2 point — SDK-native `Bn254G1Affine`/`Bn254G2Affine`, each
+ * `b` is a 128-byte G2 point, SDK-native `Bn254G1Affine`/`Bn254G2Affine`, each
  * wire-encoded as fixed-length `Bytes`. `proofToSoroban` already produced the
  * hex; here we lift `{a,b,c}` hex into the struct ScVal. (Field order a<b<c is
  * already the sorted ScMap order Soroban requires.)
@@ -101,7 +101,7 @@ export function proofToScVal(json: string): xdr.ScVal {
   return xdr.ScVal.scvMap([field("a", p.a), field("b", p.b), field("c", p.c)]);
 }
 
-/** Coerce a single CLI WRITE arg — the read table plus the `--proof` struct. */
+/** Coerce a single CLI WRITE arg, the read table plus the `--proof` struct. */
 export function scvalForWriteArg(name: string, value: string): xdr.ScVal {
   if (name === "proof") return proofToScVal(value);
   return scvalForArg(name, value);
diff --git a/packages/core/src/spendingcap.ts b/packages/core/src/spendingcap.ts
index 2074f28..0f90566 100644
--- a/packages/core/src/spendingcap.ts
+++ b/packages/core/src/spendingcap.ts
@@ -3,7 +3,7 @@
  *
  * Proves a single payout is WITHIN an approved per-payout cap WITHOUT revealing
  * the payout amount. The spending limit is a circuit constraint (amount <= cap),
- * so an over-cap payout is unprovable — the policy is enforced by cryptography,
+ * so an over-cap payout is unprovable, the policy is enforced by cryptography,
  * not by a server check that could be bypassed.
  *
  * The proof binds to the SPECIFIC payout via its public note commitment (the same
@@ -26,7 +26,7 @@ export interface ProveSpendingCapParams {
 
 /**
  * Build the witness and generate a spending-cap proof. Throws if `note.amount`
- * exceeds `cap` — the constraint `amount <= cap` is unsatisfiable, so an
+ * exceeds `cap`, the constraint `amount <= cap` is unsatisfiable, so an
  * over-cap payout simply cannot produce a proof (that IS the enforcement).
  */
 export async function proveSpendingCap(
diff --git a/packages/core/src/stellar-rpc.ts b/packages/core/src/stellar-rpc.ts
index 8682720..ffacc61 100644
--- a/packages/core/src/stellar-rpc.ts
+++ b/packages/core/src/stellar-rpc.ts
@@ -4,11 +4,11 @@
  * The CLI-backed StellarCli shells the `stellar` binary (impossible in a
  * browser). This adapter implements the same ChainClient interface using the
  * JSON-RPC server directly:
- *   - reads (`view`) run as a `simulateTransaction` — no signing, no fees, no
+ *   - reads (`view`) run as a `simulateTransaction`, no signing, no fees, no
  *     contract-spec fetch (the SDK's spec parser chokes on our >10-fn specs);
  *     contract args are coerced to ScVals from the same CLI-style string args
  *     core already builds.
- *   - writes (`invoke … send:true`) are DELEGATED to an injected submitter —
+ *   - writes (`invoke … send:true`) are DELEGATED to an injected submitter -
  *     in the wallet that's the self-hosted relayer/sponsor service, which pays
  *     the fee and submits via the proven Node path. The browser only ever hands
  *     over the proof + public inputs (never the witness), so privacy holds and
@@ -120,7 +120,7 @@ export class StellarRpcClient implements ChainClient {
     if (!opts.send) return this.simulate(opts.contractId, opts.source, opts.fnArgs);
     if (!this.opts.submitWrite) {
       throw new Error(
-        "StellarRpcClient: no write submitter configured — the browser submits writes via the relayer/sponsor service",
+        "StellarRpcClient: no write submitter configured, the browser submits writes via the relayer/sponsor service",
       );
     }
     return this.opts.submitWrite({
@@ -156,7 +156,7 @@ export class StellarRpcClient implements ChainClient {
         const sim = await this.server.simulateTransaction(tx);
         if (rpc.Api.isSimulationError(sim)) {
           // A simulation error is a real contract/account error, not a network
-          // hiccup — classify the common not-funded / missing-contract case so
+          // hiccup, classify the common not-funded / missing-contract case so
           // the caller gets an actionable message instead of a raw host trap.
           const hint = /account not found|MissingValue|no such|trustline/i.test(sim.error)
             ? " (is the source account funded, with a USDC trustline, on this network?)"
diff --git a/packages/core/src/stellar.ts b/packages/core/src/stellar.ts
index 15bd0e5..325d219 100644
--- a/packages/core/src/stellar.ts
+++ b/packages/core/src/stellar.ts
@@ -1,5 +1,5 @@
 /**
- * Stellar client — wraps the `stellar` CLI for deploys/invokes (so every
+ * Stellar client, wraps the `stellar` CLI for deploys/invokes (so every
  * transaction is reproducible from a shell) and the Soroban JSON-RPC for
  * reads (events, ledger entries).
  */
@@ -81,7 +81,7 @@ export class StellarCli implements ChainClient {
 
   /**
    * Run a READ-ONLY command with bounded exponential-backoff retry on transient
-   * failures. Only safe for idempotent reads (view/keys) — never for submits,
+   * failures. Only safe for idempotent reads (view/keys), never for submits,
    * which could double-execute.
    */
   private async runRead(
@@ -194,7 +194,7 @@ export class StellarCli implements ChainClient {
         return body.result as T;
       } catch (e) {
         lastErr = e;
-        // RPC-level errors (body.error) are non-transient — rethrow immediately.
+        // RPC-level errors (body.error) are non-transient, rethrow immediately.
         if (e instanceof Error && e.message.startsWith(`rpc ${method}:`) && !/HTTP 5|HTTP 429/.test(e.message)) throw e;
       } finally {
         clearTimeout(timer);
diff --git a/packages/core/src/store.ts b/packages/core/src/store.ts
index 06a536e..95e7dfb 100644
--- a/packages/core/src/store.ts
+++ b/packages/core/src/store.ts
@@ -1,5 +1,5 @@
 /**
- * KVStore — the minimal durable key/value port the client persists wallet state
+ * KVStore, the minimal durable key/value port the client persists wallet state
  * to (note-discovery snapshot, ASP allow-set, transaction journal). Structurally
  * compatible with `@benzo/platform`'s `KVStorage`, but declared here so core
  * never depends on the platform package (no dependency cycle).
diff --git a/packages/core/src/sum.ts b/packages/core/src/sum.ts
index 3211b98..c85f55b 100644
--- a/packages/core/src/sum.ts
+++ b/packages/core/src/sum.ts
@@ -2,13 +2,13 @@
  * Proof-of-sum / confidential disclose-total.
  *
  * Generates a zero-knowledge proof that the holder's notes in the pool tree sum
- * to EXACTLY `claimedTotal`, revealing only that total — the cryptographic
+ * to EXACTLY `claimedTotal`, revealing only that total, the cryptographic
  * replacement for the old plaintext decrypt-and-sum disclosure (which leaked
  * every individual amount to the auditor). Public inputs:
  * [root, claimedTotal, assetId, context].
  *
  * COMPLETENESS: this proves "I own notes summing to claimedTotal", NOT "these
- * are ALL my in-scope notes" — a discloser could still under-report by omitting
+ * are ALL my in-scope notes", a discloser could still under-report by omitting
  * a note. The set-completeness guarantee composes with the authorized-MVK
  * registry binding.
  */
@@ -49,7 +49,7 @@ export async function proveSum(params: ProveSumParams): Promise<ProveResult> {
     throw new Error(`proof-of-sum supports at most ${MAX_SUM_NOTES} notes`);
   }
   // Fail fast off-circuit: the circuit enforces sum === claimedTotal, so a
-  // mismatch would just fail to prove — surface it as a clear error instead.
+  // mismatch would just fail to prove, surface it as a clear error instead.
   const declared = params.notes.reduce((s, n) => s + n.amount, 0n);
   if (declared !== params.claimedTotal) {
     throw new Error(
@@ -108,7 +108,7 @@ export interface ProveSumOrgParams {
  * ORG proof-of-sum: prove the M-of-N treasury (owner = orgRecipientPk(memberRoot,
  * threshold, akGroupPub(akGroup))) owns notes summing to EXACTLY `claimedTotal`,
  * revealing only the total. The disclosure proves OWNER KNOWLEDGE (the org key
- * preimage) — not a spend — so no member signatures are needed.
+ * preimage), not a spend, so no member signatures are needed.
  */
 export async function proveSumOrg(params: ProveSumOrgParams): Promise<ProveResult> {
   if (params.notes.length > MAX_SUM_NOTES) {
diff --git a/packages/core/src/tx-signer.ts b/packages/core/src/tx-signer.ts
index de3da16..33bddb1 100644
--- a/packages/core/src/tx-signer.ts
+++ b/packages/core/src/tx-signer.ts
@@ -3,7 +3,7 @@
  *
  * Background: `StellarRpcClient` delegates writes to an injected `submitWrite`.
  * The MVP wired that to a self-hosted relayer that held a `DEPLOYER_SECRET` and
- * signed on the user's behalf — CUSTODIAL: the operator key could submit any
+ * signed on the user's behalf, CUSTODIAL: the operator key could submit any
  * transaction. This module replaces that with a `TxSignerPort` so the *user's
  * own* key (Freighter, a passkey smart account, or a local keypair for
  * CLI/self-host) signs, and the relayer (if used at all) only sponsors fees via
@@ -36,7 +36,7 @@ import type { InvokeResult } from "./stellar.js";
 
 /**
  * A pluggable signer: turns an unsigned transaction XDR into a signed one. This
- * is the custody boundary — core builds and submits, but the *signature* comes
+ * is the custody boundary, core builds and submits, but the *signature* comes
  * from whatever the runtime trusts (a browser extension, a passkey, an HSM, a
  * local key). Deliberately the same shape as `@stellar/freighter-api`'s
  * `signTransaction`, so the browser wallet needs no adapter.
@@ -49,7 +49,7 @@ export interface TxSignerPort {
 }
 
 /**
- * Local Ed25519 signer over a `S…` secret — for the CLI, self-host services,
+ * Local Ed25519 signer over a `S…` secret, for the CLI, self-host services,
  * and tests. In the browser you would NOT use this (it holds the raw key);
  * there you pass a `TxSignerPort` backed by Freighter or a passkey instead.
  */
@@ -86,7 +86,7 @@ export function signerFromFn(
   };
 }
 
-/** The slice of `rpc.Server` the submit path needs — narrowed so tests can
+/** The slice of `rpc.Server` the submit path needs, narrowed so tests can
  *  inject a fake without standing up a chain. */
 export interface SubmitRpc {
   sendTransaction(tx: Transaction | FeeBumpTransaction): Promise<{
@@ -120,7 +120,7 @@ function nativeResult(retval?: xdr.ScVal): { result: unknown; raw: string } {
  * Sign an already-prepared (simulated + assembled) transaction with the port,
  * submit it, and poll to finality. The signer is the only thing that touches
  * key material; this function is pure transport. Submission normally runs
- * exactly once (a Soroban write is not idempotent — a blind retry could
+ * exactly once (a Soroban write is not idempotent, a blind retry could
  * double-execute). The only send retry allowed here is a freshly rebuilt tx
  * after RPC returns `txBadSeq`, which means the rejected inner transaction did
  * not execute.
@@ -276,7 +276,7 @@ export async function buildInvokeTx(opts: {
 
 /**
  * Produce a `submitWrite` (for `StellarRpcOptions.submitWrite`) that signs
- * client-side with `signer` and submits directly to RPC — no custodial relayer.
+ * client-side with `signer` and submits directly to RPC, no custodial relayer.
  * Drop-in: `new StellarRpcClient({ …, submitWrite: makeClientSubmitWrite({…}) })`.
  */
 export function makeClientSubmitWrite(deps: {
diff --git a/packages/core/src/viewkeys.ts b/packages/core/src/viewkeys.ts
index d02ac53..ccafcaf 100644
--- a/packages/core/src/viewkeys.ts
+++ b/packages/core/src/viewkeys.ts
@@ -7,13 +7,13 @@
  *   HKDF-SHA256(MVK, "benzo/tvk" || scope). The MVK is not recoverable from
  *   any TVK, and TVKs for different scopes are non-correlatable.
  * - Note ciphertexts: X25519 ECDH + AES-256-GCM ("sealed box" style with an
- *   ephemeral sender key). The same plaintext is sealed twice — once to the
- *   recipient's note-discovery key, once to the controlling MVK epoch key —
+ *   ephemeral sender key). The same plaintext is sealed twice, once to the
+ *   recipient's note-discovery key, once to the controlling MVK epoch key -
  *   so the recipient can spend and a scoped auditor can passively decrypt.
  *
  * Viewing keys are decrypt-only. No spend authority is ever derivable here.
  *
- * Runtime: this module is browser-portable — it uses Web Crypto CSPRNG
+ * Runtime: this module is browser-portable, it uses Web Crypto CSPRNG
  * (`./crypto/random`), `@noble/ciphers` AES-256-GCM, and Uint8Array byte
  * helpers (`./crypto/bytes`) instead of `node:crypto`/`Buffer`. The on-wire
  * "BNZ1" box format is byte-identical to the previous node:crypto implementation
@@ -66,7 +66,7 @@ export interface SealedBox {
 
 // v1 discovery-box format: "BNZ1" (magic) || viewTag(1) || ephPub(32) || nonce(12) || ct.
 // The view tag lets a scanner skip the AES-GCM open for non-matching notes after
-// the (unavoidable) ECDH — a Zcash/Umbra-style fast path. Boxes without the magic
+// the (unavoidable) ECDH, a Zcash/Umbra-style fast path. Boxes without the magic
 // prefix are treated as legacy v0 (ephPub||nonce||ct) and always trial-decrypted,
 // so previously-emitted notes keep working unchanged.
 const MAGIC = Uint8Array.of(0x42, 0x4e, 0x5a, 0x31); // "BNZ1"
@@ -87,7 +87,7 @@ export function seal(plaintext: Uint8Array, recipientPub: Uint8Array): SealedBox
   const shared = x25519.getSharedSecret(ephSecret, recipientPub);
   const key = aeadKey(shared);
   const nonce = randomBytes(12);
-  // @noble/ciphers AES-256-GCM returns ciphertext || tag(16) — byte-identical to
+  // @noble/ciphers AES-256-GCM returns ciphertext || tag(16), byte-identical to
   // node's createCipheriv(update+final)+getAuthTag concatenation.
   const ct = gcm(key, nonce).encrypt(plaintext);
   const tag = Uint8Array.of(viewTag(shared));
diff --git a/packages/core/src/zklogin.ts b/packages/core/src/zklogin.ts
index db563b5..8150aa8 100644
--- a/packages/core/src/zklogin.ts
+++ b/packages/core/src/zklogin.ts
@@ -1,5 +1,5 @@
 /**
- * zkLogin for Benzo — the Sui-zkLogin / Aptos-Keyless model, adapted to Stellar.
+ * zkLogin for Benzo, the Sui-zkLogin / Aptos-Keyless model, adapted to Stellar.
  *
  * HOW THE OTHER CHAINS DO IT (Sui zkLogin, Aptos Keyless):
  *   1. the wallet makes an ephemeral key pair and embeds nonce = H(eph_pk,
@@ -8,7 +8,7 @@
  *      sub, nonce, ...};
  *   3. a Groth16/BN254 proof proves, in zero knowledge: the JWT's RSA signature
  *      verifies against the provider's JWK, the nonce commits to eph_pk, and the
- *      account address = H(sub, aud, iss, salt) — without revealing the JWT/sub;
+ *      account address = H(sub, aud, iss, salt), without revealing the JWT/sub;
  *   4. the chain verifies that proof against the provider's published JWKs.
  *   The address is H(sub, aud, iss, salt) so it is STABLE per user yet UNLINKABLE
  *   to the Google identity (salt hides sub). Salt "option 4" = HKDF(seed, iss|aud, sub).
@@ -23,7 +23,7 @@
  *     OFF-CHAIN (the BFF), so the chain trusts the BFF for the JWT step.
  *   - Phase 2: move the JWT RSA verification IN-CIRCUIT (the heavy ~2^20
  *     ptau circuit) so the chain verifies the proof against Google's JWKs
- *     directly — fully trustless, no BFF trust. The verifier needs no change
+ *     directly, fully trustless, no BFF trust. The verifier needs no change
  *     (it already verifies Groth16/BN254).
  *
  * This module is the Phase-1 derivation: pure, browser-safe, deterministic.
@@ -42,7 +42,7 @@ const enc = (s: string) => new TextEncoder().encode(s);
 const feFromBytes = (b: Uint8Array): bigint => BigInt("0x" + toHex(b)) % FIELD_MODULUS;
 
 /**
- * The OIDC nonce binding — commits the ephemeral pubkey + session expiry into the
+ * The OIDC nonce binding, commits the ephemeral pubkey + session expiry into the
  * OAuth request, exactly like Sui zkLogin (`nonce = H(eph_pk, max_epoch,
  * randomness)`). The app passes this as the `nonce` in the Google OAuth request;
  * a Phase-2 in-circuit proof checks the JWT's `nonce` equals this, binding the
@@ -72,7 +72,7 @@ export function oidcClaimSecret(id: OidcIdentity, salt: Uint8Array | string = "b
 }
 
 /**
- * Derive a full Benzo account (spend + viewing keys) from VERIFIED OIDC claims —
+ * Derive a full Benzo account (spend + viewing keys) from VERIFIED OIDC claims -
  * Phase-1 zkLogin. The caller MUST have verified the JWT signature first (the BFF
  * does this against Google's JWKs); this only does the deterministic key
  * derivation. Same model as `accountFromClaimSecret`, keyed by the OIDC identity.
diff --git a/packages/core/test/circuits.test.ts b/packages/core/test/circuits.test.ts
index 09c056c..e00e527 100644
--- a/packages/core/test/circuits.test.ts
+++ b/packages/core/test/circuits.test.ts
@@ -2,7 +2,7 @@
  * Circuit integration tests: build witnesses with the TS SDK and prove
  * through the REAL compiled circuits (snarkjs, headless). If any TS hash
  * mirror diverged from the circom templates by a byte, witness generation
- * would violate a constraint and proving would fail — so a green run here
+ * would violate a constraint and proving would fail, so a green run here
  * is the circuit<->SDK byte-identity proof. Local verification uses the
  * exported snarkjs verification keys.
  *
@@ -39,7 +39,7 @@ if (!HAVE_ARTIFACTS) {
   // Make the skip LOUD: a green run with these tests skipped does NOT mean the ZK
   // works. `pnpm test:zk` hard-fails on this via scripts/check-artifacts.mjs.
   console.warn(
-    "\n⚠️  ZK PROVING ARTIFACTS ABSENT — shield/joinsplit/unshield/sum proving tests are SKIPPED.\n" +
+    "\n⚠️  ZK PROVING ARTIFACTS ABSENT, shield/joinsplit/unshield/sum proving tests are SKIPPED.\n" +
       "    A passing run here does NOT exercise any real proof. Build them first:\n" +
       "      bash scripts/build-artifacts.sh   (compile from source)\n" +
       "      bash scripts/fetch-artifacts.sh   (download the exact deployed-matching artifacts)\n" +
@@ -108,7 +108,7 @@ describe.skipIf(!HAVE_ARTIFACTS)("shield circuit", () => {
 
   it("rejects a note bound to an UNREGISTERED MVK (the audit P0)", async () => {
     const w = buildShieldWitness();
-    // Bind the note to mvkPub 888 (with a matching tag) — but 888 is NOT in the
+    // Bind the note to mvkPub 888 (with a matching tag), but 888 is NOT in the
     // authorized-MVK registry, so registry membership fails. Pre-fix this would
     // have proven, yielding a permanently-unauditable note.
     const bad = { ...w, mvkPub: 888n, mvkTag: mvkTag(888n, w.blinding) };
@@ -206,7 +206,7 @@ describe.skipIf(!HAVE_ARTIFACTS)("joinsplit circuit", () => {
     const bad = {
       ...witness,
       outAmount: [witness.outAmount[0] + 1_000_000n, witness.outAmount[1]],
-      // recompute commitment so only the conservation constraint trips? No —
+      // recompute commitment so only the conservation constraint trips? No -
       // keep the declared commitment; either constraint failing is fine.
     };
     await expect(prove(art("joinsplit"), toWitnessInput(bad))).rejects.toThrow();
@@ -232,7 +232,7 @@ describe.skipIf(!HAVE_ARTIFACTS)("joinsplit circuit", () => {
 
   // Hardening (goal G): the 64-bit range check on INPUT amounts. This witness
   // is fully self-consistent (membership, nullifier, value-conservation, and
-  // both outputs in 64-bit range) and WOULD have proven before the check —
+  // both outputs in 64-bit range) and WOULD have proven before the check -
   // its only defect is an input amount of 2^64+10. It must now fail to prove.
   it("rejects an out-of-range INPUT amount (2^64+10) that conserves value", async () => {
     const tree = new MerkleTreeMirror(32);
@@ -342,7 +342,7 @@ describe.skipIf(!HAVE_ARTIFACTS)("unshield circuit", () => {
 
 describe.skipIf(!HAVE_ARTIFACTS)("proof_of_sum circuit (disclose-total)", () => {
   // Three real notes summing to 6,000,000, owned by one spend identity, plus a
-  // padding slot — the ZK replacement for the old plaintext decrypt-and-sum.
+  // padding slot, the ZK replacement for the old plaintext decrypt-and-sum.
   function fixture() {
     const tree = new MerkleTreeMirror(32);
     const kp = deriveKeypair(13579n);
@@ -384,7 +384,7 @@ describe.skipIf(!HAVE_ARTIFACTS)("proof_of_sum circuit (disclose-total)", () =>
     };
     const res = await prove(art("proof_of_sum"), toWitnessInput(witness));
     expect(res.sorobanPublics.length).toBe(4);
-    // public order: [root, claimedTotal, assetId, context] — only the total is revealed.
+    // public order: [root, claimedTotal, assetId, context], only the total is revealed.
     expect(BigInt(res.publicSignals[1])).toBe(6_000_000n);
     expect(await verifyLocal(vk("proof_of_sum"), res.publicSignals, res.proof)).toBe(true);
   }, 120_000);
diff --git a/packages/core/test/crypto.test.ts b/packages/core/test/crypto.test.ts
index da245a3..73507a6 100644
--- a/packages/core/test/crypto.test.ts
+++ b/packages/core/test/crypto.test.ts
@@ -79,7 +79,7 @@ describe("notes", () => {
 
   it("nullifier = Poseidon2(nk, leaf_index, NULLIFIER_DOMAIN), nk from the key hierarchy", () => {
     // Key hierarchy: the nullifier is keyed by the SEPARATE nullifier key nk,
-    // not the raw root spend secret — so a viewing key cannot be used to spend.
+    // not the raw root spend secret, so a viewing key cannot be used to spend.
     const nk = deriveSpendKeys(3n).nk;
     expect(noteNullifier(3n, 4n)).toBe(hash([nk, 4n], NULLIFIER_DOMAIN));
     // The nullifier must NOT be derivable from the raw root directly.
diff --git a/packages/core/test/joinsplit-org.test.ts b/packages/core/test/joinsplit-org.test.ts
index 94eaf8b..1730310 100644
--- a/packages/core/test/joinsplit-org.test.ts
+++ b/packages/core/test/joinsplit-org.test.ts
@@ -1,5 +1,5 @@
 /**
- * joinsplit_org — TRANSFER with in-circuit M-of-N org dual-control (stage 2).
+ * joinsplit_org, TRANSFER with in-circuit M-of-N org dual-control (stage 2).
  *
  * A copy of the live joinsplit with a per-input selector forced by the note's
  * recipient_pk: an ORG note (recipientPk = Poseidon2(memberRoot, threshold,
@@ -84,7 +84,7 @@ function build(specs: [InSpec, InSpec], opts: { forceConsumerSpend?: boolean } =
   const inputNullifier = [ins[0].nullifier, ins[1].nullifier];
   const outputCommitment = [noteCommitment(out0), noteCommitment(out1)];
 
-  // spendMessage = circomlib Poseidon(4)(nullifiers, commitments) — what members sign.
+  // spendMessage = circomlib Poseidon(4)(nullifiers, commitments), what members sign.
   const spendMessage = F.toObject(poseidon([inputNullifier[0], inputNullifier[1], outputCommitment[0], outputCommitment[1]]));
   const msgEl = F.e(spendMessage);
 
@@ -143,7 +143,7 @@ describe.skipIf(!HAVE)("joinsplit_org circuit (in-circuit M-of-N dual-control tr
     await expect(calc(build([ORG0(), DUMMY]))).resolves.toBeUndefined();
   });
 
-  it("valid: BOTH inputs are org notes (2-of-3 each) — the 2-org-input case", async () => {
+  it("valid: BOTH inputs are org notes (2-of-3 each), the 2-org-input case", async () => {
     const a = ORG0({ amount: 4_000_000n, blinding: 0xa11n, akGroup: 0x6772_70n });
     const b = ORG0({ amount: 2_000_000n, blinding: 0xb22n, akGroup: 0x6772_70n });
     await expect(calc(build([a, b]))).resolves.toBeUndefined();
diff --git a/packages/core/test/kyc-issuer-integration.test.ts b/packages/core/test/kyc-issuer-integration.test.ts
index b86b602..11f5720 100644
--- a/packages/core/test/kyc-issuer-integration.test.ts
+++ b/packages/core/test/kyc-issuer-integration.test.ts
@@ -2,7 +2,7 @@
  * End-to-end KYC pipeline: CredentialIssuer (the re-issuer that turns a verified
  * identity tier into a signed credential) → the real kyc_credential circuit.
  * Proves that a credential minted by @benzo/kyc's CredentialIssuer verifies in
- * ZK and surfaces the assurance tier as credType (public input #1) — the value
+ * ZK and surfaces the assurance tier as credType (public input #1), the value
  * the on-chain admit_by_proof tier gate binds. Self-skips without artifacts.
  */
 import { existsSync, readFileSync } from "node:fs";
diff --git a/packages/core/test/mvk-registry.test.ts b/packages/core/test/mvk-registry.test.ts
index b46c343..ab710e1 100644
--- a/packages/core/test/mvk-registry.test.ts
+++ b/packages/core/test/mvk-registry.test.ts
@@ -1,5 +1,5 @@
 /**
- * MvkRegistryMirror — the off-chain twin the witness builders use for the
+ * MvkRegistryMirror, the off-chain twin the witness builders use for the
  * authorized-MVK membership proof. Verifies dedup, the nonzero rule, path
  * availability, and that the mirror's root equals a plain tree built from the
  * same `mvkRegistryLeaf` values (so a synced mirror matches the on-chain tree
@@ -53,7 +53,7 @@ describe("MvkRegistryMirror", () => {
     reg.syncLeaves(priorLeaves);
     expect(reg.root()).toBe(onchain.root()); // resumed root matches
 
-    // Appending a fresh MVK lands at index 2 — same as the chain would.
+    // Appending a fresh MVK lands at index 2, same as the chain would.
     const idx = reg.register(30n);
     expect(idx).toBe(2);
     onchain.insert(mvkRegistryLeaf(30n, 0n));
diff --git a/packages/core/test/notekey.test.ts b/packages/core/test/notekey.test.ts
index 3a4de6e..387a151 100644
--- a/packages/core/test/notekey.test.ts
+++ b/packages/core/test/notekey.test.ts
@@ -13,7 +13,7 @@ const sig = new Uint8Array(64).fill(7);
 const sig2 = new Uint8Array(64).fill(9);
 
 describe("note keys from one signed message (Railgun pattern)", () => {
-  it("is deterministic — the same signature recovers the same account", () => {
+  it("is deterministic, the same signature recovers the same account", () => {
     const a = accountFromSignedMessage(sig);
     const b = accountFromSignedMessage(sig);
     expect(a.spendSk).toBe(b.spendSk);
@@ -31,7 +31,7 @@ describe("note keys from one signed message (Railgun pattern)", () => {
   });
 });
 
-describe("loginWithSigner — the headless wallet login seam", () => {
+describe("loginWithSigner, the headless wallet login seam", () => {
   it("signs NOTE_KEY_MESSAGE and yields the same account as direct derivation", async () => {
     let signed = "";
     const signer = (m: string) => { signed = m; return sig; };
@@ -58,7 +58,7 @@ describe("Stellar edge-key challenge signatures", () => {
   });
 });
 
-describe("accountFromServerSecret — stable serverless sandbox identity", () => {
+describe("accountFromServerSecret, stable serverless sandbox identity", () => {
   it("recovers the same account from the same env-held secret", () => {
     const a = accountFromServerSecret("SDETTESTSECRET", "consumer");
     const b = accountFromServerSecret("SDETTESTSECRET", "consumer");
diff --git a/packages/core/test/org-note-spend.test.ts b/packages/core/test/org-note-spend.test.ts
index 31ae449..12f59b8 100644
--- a/packages/core/test/org-note-spend.test.ts
+++ b/packages/core/test/org-note-spend.test.ts
@@ -1,5 +1,5 @@
 /**
- * Org-NOTE spend authorization (in-circuit M-of-N merge — stage 1+2 core).
+ * Org-NOTE spend authorization (in-circuit M-of-N merge, stage 1+2 core).
  *
  * org_note_spend now proves all three legs the merged joinsplit needs:
  *  (A) M-of-N: >=threshold DISTINCT members EdDSA-signed this transfer's spendMessage.
@@ -33,7 +33,7 @@ const HAVE = existsSync(wasm);
 const HAVE_ZKEY = existsSync(zkeyPath);
 const LEVELS = 16;
 const MAX = 3;
-// Capacity-slot domains — must match note.circom.
+// Capacity-slot domains, must match note.circom.
 const KEYPAIR_DOMAIN = 0x03n;
 const NULLIFIER_DOMAIN = 0x02n;
 const NK_DOMAIN = 0x07n;
diff --git a/packages/core/test/org-spend-auth.test.ts b/packages/core/test/org-spend-auth.test.ts
index 3ffa4b4..db0c6b1 100644
--- a/packages/core/test/org-spend-auth.test.ts
+++ b/packages/core/test/org-spend-auth.test.ts
@@ -2,7 +2,7 @@
  * In-circuit M-of-N org spend-authorization circuit test. Builds real member
  * EdDSA-over-BabyJubJub signatures (circomlibjs) over a shared spendMessage, a
  * member Merkle tree, and asserts the security properties by WITNESS CALCULATION
- * (which enforces every constraint — no trusted setup needed): a valid 2-of-3
+ * (which enforces every constraint, no trusted setup needed): a valid 2-of-3
  * authorizes; sub-threshold (1 of required 2) and a duplicate signer (same member
  * twice) both FAIL. Self-skips when the gitignored circuit wasm is absent.
  */
@@ -85,7 +85,7 @@ describe.skipIf(!HAVE)("org_spend_auth circuit (in-circuit M-of-N)", () => {
 
   it("rejects a duplicate signer (same member counted twice)", async () => {
     const a = member(11), c = member(13);
-    // slots 0 and 1 are the SAME member a — distinctness must reject it
+    // slots 0 and 1 are the SAME member a, distinctness must reject it
     await expect(calc(buildInput([{ m: a, enabled: 1 }, { m: a, enabled: 1 }, { m: c, enabled: 0 }], 2n))).rejects.toThrow();
   });
 
diff --git a/packages/core/test/parity.test.ts b/packages/core/test/parity.test.ts
index 1604807..0945ec1 100644
--- a/packages/core/test/parity.test.ts
+++ b/packages/core/test/parity.test.ts
@@ -20,7 +20,7 @@ const HAVE_VKS = ["shield", "joinsplit", "unshield"].every((c) => existsSync(vkP
 
 if (!HAVE_VKS) {
   console.warn(
-    "\n⚠️  ZK VERIFYING KEYS ABSENT — verifier-parity VK byte-shape tests are SKIPPED.\n" +
+    "\n⚠️  ZK VERIFYING KEYS ABSENT, verifier-parity VK byte-shape tests are SKIPPED.\n" +
       "    `pnpm test:zk` hard-fails on missing artifacts before this suite runs.\n",
   );
 }
@@ -42,7 +42,7 @@ describe.skipIf(!HAVE_VKS)("verifier-parity oracle: real VK byte-shape", () => {
 describe("verifier-parity oracle: snarkjs → Soroban encoding", () => {
   it("a proof encodes to the exact Soroban byte shape", () => {
     // Synthetic-but-well-formed Groth16 proof (affine points: G1 z=1, G2 z=[1,0]).
-    // Self-contained on purpose — no longer depends on the cut "trivial" circuit's
+    // Self-contained on purpose, no longer depends on the cut "trivial" circuit's
     // build artifacts; it exercises the same proofToSoroban byte-shape encoding.
     const proof = {
       pi_a: ["1", "2", "1"],
diff --git a/packages/core/test/reserves.test.ts b/packages/core/test/reserves.test.ts
index 04fb35a..c5f9ddf 100644
--- a/packages/core/test/reserves.test.ts
+++ b/packages/core/test/reserves.test.ts
@@ -8,7 +8,7 @@ const ISSUER = "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5";
 
 const opName = (op: any) => op.body().switch().name;
 
-describe("sponsored reserves (CAP-33) — gasless onboarding", () => {
+describe("sponsored reserves (CAP-33), gasless onboarding", () => {
   it("creates the begin/create/end sandwich in order", () => {
     const ops = sponsoredCreateAccountOps({ sponsor: SPONSOR, newAccount: NEW });
     expect(ops).toHaveLength(3);
diff --git a/packages/core/test/scanner.test.ts b/packages/core/test/scanner.test.ts
index 0100bdb..acad837 100644
--- a/packages/core/test/scanner.test.ts
+++ b/packages/core/test/scanner.test.ts
@@ -10,8 +10,8 @@ import {
 } from "../src/scanner.js";
 
 // collectEvents talks to Soroban RPC via the global `fetch`; mock it with a
-// queue of canned JSON-RPC envelopes so the two most failure-prone branches —
-// the retention-aged-out restart and the multi-page drain — get unit coverage
+// queue of canned JSON-RPC envelopes so the two most failure-prone branches -
+// the retention-aged-out restart and the multi-page drain, get unit coverage
 // (previously only exercised indirectly by live-testnet e2e).
 
 const realFetch = globalThis.fetch;
diff --git a/packages/core/test/selectnotes.test.ts b/packages/core/test/selectnotes.test.ts
index 80bc1bd..d456442 100644
--- a/packages/core/test/selectnotes.test.ts
+++ b/packages/core/test/selectnotes.test.ts
@@ -7,7 +7,7 @@ const mk = (amount: bigint, leafIndex = 0) => ({
   leafIndex,
 });
 
-describe("selectSpendNotes — 2-in coin selection", () => {
+describe("selectSpendNotes, 2-in coin selection", () => {
   it("returns the smallest single note that covers the amount", () => {
     const r = selectSpendNotes([mk(5n, 0), mk(10n, 1), mk(20n, 2)], 8n);
     expect(r).toHaveLength(1);
diff --git a/packages/core/test/tx-signer.test.ts b/packages/core/test/tx-signer.test.ts
index 0c71d4a..e2cf7a0 100644
--- a/packages/core/test/tx-signer.test.ts
+++ b/packages/core/test/tx-signer.test.ts
@@ -1,5 +1,5 @@
 /**
- * Non-custodial signing (B.5) — headless coverage of the custody-seam removal,
+ * Non-custodial signing (B.5), headless coverage of the custody-seam removal,
  * no live chain:
  *   - LocalKeypairSigner actually signs the tx (signature verifies against the
  *     tx hash with the signer's public key, and only that key's sig is added).
diff --git a/packages/core/test/wasm.test.ts b/packages/core/test/wasm.test.ts
index 4380646..da757ac 100644
--- a/packages/core/test/wasm.test.ts
+++ b/packages/core/test/wasm.test.ts
@@ -1,5 +1,5 @@
 /**
- * WasmProver test — the on-device proving backend. Proves from preloaded
+ * WasmProver test, the on-device proving backend. Proves from preloaded
  * Uint8Array artifacts (as the browser would, having fetched the wasm/zkey once)
  * rather than fs paths, confirming the proof is byte-valid and the witness never
  * needs a filesystem. Self-skips when the gitignored artifacts are absent.
diff --git a/packages/links/src/index.ts b/packages/links/src/index.ts
index 8e5cec0..25ceb95 100644
--- a/packages/links/src/index.ts
+++ b/packages/links/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @benzo/links — one typed link format shared by every surface.
+ * @benzo/links, one typed link format shared by every surface.
  *
  * Modeled on Daimo's daimoLink.ts: links are defined ONCE as a discriminated
  * union, encoded/parsed by this single package, and consumed by web / mobile /
@@ -8,7 +8,7 @@
  *
  * Every link carries an `app` scope ("consumer" | "business"). This is the
  * single source of truth for the two-app boundary: a consumer wallet must never
- * act on a business invite and vice-versa. The scope is enforced twice —
+ * act on a business invite and vice-versa. The scope is enforced twice -
  * `assertAppScope()` here (UI/runtime) and, for claim links, by folding the
  * scope into the key-derivation domain separator in `@benzo/core` so a consumer
  * claim secret cannot even reconstruct a business account (and vice-versa).
@@ -22,16 +22,16 @@ export type BenzoLink = ClaimLink | RequestLink | HandleLink | OrgInviteLink;
 /** A tappable link that funds a fresh account from an embedded claim secret. */
 export interface ClaimLink {
   type: "claim";
-  /** claim secret — carried in the URL fragment, never sent to a server */
+  /** claim secret, carried in the URL fragment, never sent to a server */
   secret: string;
   amount?: string;
   asset?: string;
   /** product scope (default "consumer" when absent) */
   app?: AppScope;
-  /** expiry (unix seconds) — after this the sender may self-claim a refund */
+  /** expiry (unix seconds), after this the sender may self-claim a refund */
   expiresAt?: string;
   /**
-   * opaque, sealed sender context ("Maya sent you $25 — thanks!"). Encrypted
+   * opaque, sealed sender context ("Maya sent you $25, thanks!"). Encrypted
    * to the recipient with a key derived from the claim secret (see
    * sealLinkContext/openLinkContext); the server only ever sees ciphertext.
    */
@@ -67,7 +67,7 @@ export interface HandleLink {
 }
 
 /**
- * A business invite — onboards an employee/contractor/customer into the correct
+ * A business invite, onboards an employee/contractor/customer into the correct
  * app. No money is attached (unlike a ClaimLink); a single-use HMAC token in the
  * fragment authorizes the seat/payee creation. Always `app: "business"`.
  */
@@ -81,7 +81,7 @@ export interface OrgInviteLink {
   counterpartyId?: string;
   /** invited person/customer label, used as a client-side fallback only */
   inviteeName?: string;
-  /** single-use HMAC token — carried in the URL fragment */
+  /** single-use HMAC token, carried in the URL fragment */
   token: string;
   /** role granted (members only) */
   role?: string;
@@ -89,7 +89,7 @@ export interface OrgInviteLink {
   orgName?: string;
   /** expiry (unix seconds) */
   expiresAt?: string;
-  /** product scope — an org invite is always "business" */
+  /** product scope, an org invite is always "business" */
   app?: AppScope;
 }
 
@@ -118,7 +118,7 @@ function prefix(base: "scheme" | "web"): string {
   return base === "web" ? `${WEB_BASE}/` : `${SCHEME}//`;
 }
 
-/** The effective scope of a link — legacy links with no tag are "consumer". */
+/** The effective scope of a link, legacy links with no tag are "consumer". */
 export function linkApp(link: BenzoLink): AppScope {
   return link.app ?? (link.type === "org" ? "business" : "consumer");
 }
diff --git a/packages/types/src/accounts.ts b/packages/types/src/accounts.ts
index 3775eaf..0fad6b4 100644
--- a/packages/types/src/accounts.ts
+++ b/packages/types/src/accounts.ts
@@ -11,7 +11,7 @@ import type { PaymentAddress } from "./org.js";
 /** Internal ledger account kinds an org operates. */
 export type AccountType = "operating" | "payroll" | "treasury";
 
-/** An internal account — a named bucket of shielded value the ledger tracks. */
+/** An internal account, a named bucket of shielded value the ledger tracks. */
 export interface Account {
   id: AccountId;
   orgId: OrgId;
@@ -51,7 +51,7 @@ export type CounterpartyStatus =
   | "allowlisted"
   | "blocked";
 
-/** A payee/payer — a first-class, shared org object. */
+/** A payee/payer, a first-class, shared org object. */
 export interface Counterparty {
   id: CounterpartyId;
   orgId: OrgId;
@@ -67,7 +67,7 @@ export interface Counterparty {
   /** tax form on file */
   taxFormType?: "W9" | "W8-BEN" | "none";
   /**
-   * Pay rate card — the source-of-truth a payroll run COMPUTES each line from
+   * Pay rate card, the source-of-truth a payroll run COMPUTES each line from
    * (server-side, never trusting a caller-supplied amount). v1 = a fixed
    * recurring retainer; hours×rate / milestones are a fast-follow.
    */
diff --git a/packages/types/src/api.ts b/packages/types/src/api.ts
index 7b96da5..ac221cb 100644
--- a/packages/types/src/api.ts
+++ b/packages/types/src/api.ts
@@ -118,7 +118,7 @@ export interface DashboardSummary {
   live: boolean;
 }
 
-/** GET /api/live — is the BFF wired to live testnet, and if not, why. */
+/** GET /api/live, is the BFF wired to live testnet, and if not, why. */
 export interface LiveStatusResponse {
   live: boolean;
   mode: "live" | "unavailable";
diff --git a/packages/types/src/approvals.ts b/packages/types/src/approvals.ts
index 5a9ac6d..43d7623 100644
--- a/packages/types/src/approvals.ts
+++ b/packages/types/src/approvals.ts
@@ -10,7 +10,7 @@ import type { Role } from "./org.js";
 
 /**
  * A routing condition. NOTE (privacy crux): conditions reference amount /
- * counterparty, which Benzo hides on-chain — the BFF evaluates the policy over
+ * counterparty, which Benzo hides on-chain, the BFF evaluates the policy over
  * the PLAINTEXT PROPOSAL before a proof is generated.
  */
 export interface ApprovalCondition {
diff --git a/packages/types/src/common.ts b/packages/types/src/common.ts
index 41ebcfa..c6b26a2 100644
--- a/packages/types/src/common.ts
+++ b/packages/types/src/common.ts
@@ -3,7 +3,7 @@
  *
  * IDs are plain strings (aliased for documentation, not branded, to keep the
  * API/UI boundary friction-free). Money is integer MINOR UNITS encoded as a
- * string so it survives JSON without bigint loss — the on-chain truth is
+ * string so it survives JSON without bigint loss, the on-chain truth is
  * 6-decimal USDC base units on Avalanche; the product layer keeps the same
  * convention.
  */
diff --git a/packages/types/src/compliance.ts b/packages/types/src/compliance.ts
index 60cb2d4..e847999 100644
--- a/packages/types/src/compliance.ts
+++ b/packages/types/src/compliance.ts
@@ -8,8 +8,8 @@ import type {
 /**
  * Disclosure tiers mirror Penumbra/Zcash key hierarchy:
  *  - full     = full-history read (FVK)
- *  - incoming = only payments the scope RECEIVED (IVK) — e.g. show a supplier
- *  - outgoing = only payments the scope SENT (OVK) — e.g. show payroll outflows
+ *  - incoming = only payments the scope RECEIVED (IVK), e.g. show a supplier
+ *  - outgoing = only payments the scope SENT (OVK), e.g. show payroll outflows
  */
 export type DisclosureTier = "full" | "incoming" | "outgoing";
 
@@ -39,7 +39,7 @@ export interface ViewingGrant {
   auditorPubKey: string;
   tier: DisclosureTier;
   scope: GrantScope;
-  /** TVK ciphertext (sealed to auditorPubKey) — delivered via the portal */
+  /** TVK ciphertext (sealed to auditorPubKey), delivered via the portal */
   tvkCiphertext?: string;
   /** on-chain hash commitment of the scoped key (tamper-evidence) */
   onChainKeyHash?: string;
@@ -52,7 +52,7 @@ export interface ViewingGrant {
 }
 
 /**
- * A per-jurisdiction compliance partition — the ASP allow/deny root set the
+ * A per-jurisdiction compliance partition, the ASP allow/deny root set the
  * org's deposits/withdrawals are screened against (maps to Benzo asp_registry).
  */
 export interface ComplianceZone {
diff --git a/packages/types/src/index.ts b/packages/types/src/index.ts
index bf38198..2a353f2 100644
--- a/packages/types/src/index.ts
+++ b/packages/types/src/index.ts
@@ -1,5 +1,5 @@
 /**
- * @benzo/types — the shared domain model + API contract for the Benzo B2B
+ * @benzo/types, the shared domain model + API contract for the Benzo B2B
  * console (UI) and services/api. Pure types, zero runtime deps.
  */
 export * from "./common.js";
diff --git a/packages/types/src/invoices.ts b/packages/types/src/invoices.ts
index c191337..3ce9856 100644
--- a/packages/types/src/invoices.ts
+++ b/packages/types/src/invoices.ts
@@ -31,7 +31,7 @@ export interface RecurringConfig {
 }
 
 /**
- * A private invoice. The hosted page lives at a secret URL — that URL *is* the
+ * A private invoice. The hosted page lives at a secret URL, that URL *is* the
  * viewing grant (the payer reconstructs only this invoice). Reconciled to a
  * shielded payment via a per-invoice memo/commitment.
  */
diff --git a/packages/types/src/org.ts b/packages/types/src/org.ts
index d6c1198..de9041e 100644
--- a/packages/types/src/org.ts
+++ b/packages/types/src/org.ts
@@ -21,7 +21,7 @@ export interface OrgSummary {
   baseAssetCode?: string;
 }
 
-/** A business tenant — the top-level account everything hangs off. */
+/** A business tenant, the top-level account everything hangs off. */
 export interface Org {
   id: OrgId;
   name: string;
@@ -112,7 +112,7 @@ export interface Member {
   name?: string;
   role: Role;
   status: MemberStatus;
-  /** member's MVK public scalar (hex) — lets them decode in-scope notes */
+  /** member's MVK public scalar (hex), lets them decode in-scope notes */
   mvkPublic?: string;
   /** signer EVM address for SIWE authorization (treasurer/approver) */
   signerAddress?: EvmAddress;
diff --git a/packages/types/src/payments.ts b/packages/types/src/payments.ts
index 7b05e64..18525e3 100644
--- a/packages/types/src/payments.ts
+++ b/packages/types/src/payments.ts
@@ -39,7 +39,7 @@ export type PaymentStatus =
   | "cancelled"
   | "expired";
 
-/** Valid transitions — the BFF enforces these; the UI reflects them. */
+/** Valid transitions, the BFF enforces these; the UI reflects them. */
 export const PAYMENT_TRANSITIONS: Record<PaymentStatus, readonly PaymentStatus[]> = {
   created: ["needs_approval", "approved", "cancelled"],
   needs_approval: ["approved", "cancelled", "expired"],
@@ -64,7 +64,7 @@ export const TERMINAL_PAYMENT_STATUSES: readonly PaymentStatus[] = [
   "expired",
 ];
 
-/** What a given payment reveals vs hides — surfaced at the confirm step. */
+/** What a given payment reveals vs hides, surfaced at the confirm step. */
 export interface PrivacyDisclosure {
   amountHidden: boolean;
   counterpartyHidden: boolean;
diff --git a/packages/ui/src/balance.ts b/packages/ui/src/balance.ts
index 9226e83..818e645 100644
--- a/packages/ui/src/balance.ts
+++ b/packages/ui/src/balance.ts
@@ -1,5 +1,5 @@
 /**
- * Balance display for a private wallet — selectors over shielded + pending
+ * Balance display for a private wallet, selectors over shielded + pending
  * amounts with a one-switch privacy mask ("peek to reveal"). Pure; the screens
  * own the chrome, this owns the numbers and the masking rule.
  */
diff --git a/packages/ui/src/format.ts b/packages/ui/src/format.ts
index 96f0a36..0c46bbe 100644
--- a/packages/ui/src/format.ts
+++ b/packages/ui/src/format.ts
@@ -1,5 +1,5 @@
 /**
- * Display/parse helpers for money and identifiers — pure, framework-agnostic, so
+ * Display/parse helpers for money and identifiers, pure, framework-agnostic, so
  * pay.benzo.xyz and work.benzo.xyz render amounts and addresses identically.
  *
  * On Avalanche, USDC carries 6 decimals; the protocol moves base units, so
@@ -48,7 +48,7 @@ export function parseUsdc(input: string, decimals = USDC_DECIMALS): bigint {
   return neg ? -value : value;
 }
 
-/** "0x1234…abcd" — middle-truncate an EVM address/contract id. */
+/** "0x1234…abcd", middle-truncate an EVM address/contract id. */
 export function truncateAddress(addr: string, head = 5, tail = 4): string {
   if (addr.length <= head + tail + 1) return addr;
   return `${addr.slice(0, head)}…${addr.slice(-tail)}`;
diff --git a/packages/ui/src/hooks.ts b/packages/ui/src/hooks.ts
index f6ead7f..62b77ab 100644
--- a/packages/ui/src/hooks.ts
+++ b/packages/ui/src/hooks.ts
@@ -1,8 +1,8 @@
 /**
- * React bindings — thin `useReducer`/`useState` wrappers over the pure state
+ * React bindings, thin `useReducer`/`useState` wrappers over the pure state
  * machines in this package. All real logic lives in the reducers (tested
  * headlessly); these just connect them to React so a screen consumes one hook.
- * `react` is an optional peer dependency — import these only in a React app.
+ * `react` is an optional peer dependency, import these only in a React app.
  */
 import { useCallback, useReducer, useState } from "react";
 import { Keychain, type KVStore, type WalletSecrets } from "@benzo/wallet";
diff --git a/packages/ui/src/index.ts b/packages/ui/src/index.ts
index cf34b72..393d361 100644
--- a/packages/ui/src/index.ts
+++ b/packages/ui/src/index.ts
@@ -1,11 +1,11 @@
 /**
- * @benzo/ui — shared, framework-agnostic privacy/payment primitives for both
+ * @benzo/ui, shared, framework-agnostic privacy/payment primitives for both
  * Benzo apps (pay.benzo.xyz consumer + work.benzo.xyz console).
  *
  * The *logic* lives here (formatting, the payment/proving/wallet state machines,
  * balance masking) so both apps behave identically; the *presentational* chrome
  * (cards, buttons, Tailwind tokens) stays per-app. React hooks in `./hooks`
- * connect the pure reducers to a screen — import those only in a React app.
+ * connect the pure reducers to a screen, import those only in a React app.
  */
 export * from "./format.js";
 export * from "./payment-state.js";
diff --git a/packages/ui/src/payment-state.ts b/packages/ui/src/payment-state.ts
index cabd780..904ba0d 100644
--- a/packages/ui/src/payment-state.ts
+++ b/packages/ui/src/payment-state.ts
@@ -1,7 +1,7 @@
 /**
  * The shielded-payment lifecycle as a pure state machine, shared by both apps so
  * "what's happening to my money right now" is modeled once. A private payment is
- * not one network call — it is build-witness → prove (seconds, on-device) →
+ * not one network call, it is build-witness → prove (seconds, on-device) →
  * submit → confirm, and the UI must show each phase honestly (especially the
  * proving wait, which is the unfamiliar part for a Cash-App-shaped user).
  *
@@ -42,7 +42,7 @@ const ORDER: PaymentPhase[] = ["idle", "building", "proving", "submitting", "con
 export function paymentReducer(state: PaymentState, event: PaymentEvent): PaymentState {
   switch (event.type) {
     case "START":
-      // Only startable from a rest state — ignore double-submits mid-flight.
+      // Only startable from a rest state, ignore double-submits mid-flight.
       return state.phase === "idle" || state.phase === "failed" || state.phase === "confirmed"
         ? { phase: "building" }
         : state;
@@ -68,7 +68,7 @@ export function paymentReducer(state: PaymentState, event: PaymentEvent): Paymen
   }
 }
 
-/** No further automatic transitions — the flow has settled. */
+/** No further automatic transitions, the flow has settled. */
 export function isTerminal(state: PaymentState): boolean {
   return state.phase === "confirmed" || state.phase === "failed";
 }
diff --git a/packages/ui/src/proving-state.ts b/packages/ui/src/proving-state.ts
index d83398a..f55e907 100644
--- a/packages/ui/src/proving-state.ts
+++ b/packages/ui/src/proving-state.ts
@@ -22,6 +22,6 @@ export const initialProvingStatus: ProvingStatus = { phase: "idle", label: "Read
 export function provingStatusFromStage(stage: string): ProvingStatus {
   if (stage === "done") return { phase: "done", label: "Proof ready", raw: stage };
   if (stage === "proving") return { phase: "proving", label: "Generating proof on your device…", raw: stage };
-  // A forwarded internal info log — stay in "proving" but keep the detail.
+  // A forwarded internal info log, stay in "proving" but keep the detail.
   return { phase: "proving", label: "Generating proof on your device…", raw: stage };
 }
diff --git a/packages/ui/src/send-sequence.test.ts b/packages/ui/src/send-sequence.test.ts
index 222c2b7..bbe2eb6 100644
--- a/packages/ui/src/send-sequence.test.ts
+++ b/packages/ui/src/send-sequence.test.ts
@@ -4,7 +4,7 @@ import { sendCeremonyView, ceremonyPhase, SEND_PHASE_FLOOR_MS } from "./send-seq
 
 const at = (phase: PaymentState["phase"], extra: Partial<PaymentState> = {}): PaymentState => ({ phase, ...extra });
 
-describe("send ceremony — phase mapping (slave to the machine)", () => {
+describe("send ceremony, phase mapping (slave to the machine)", () => {
   it("maps the full happy path through the reducer", () => {
     let s = initialPaymentState;
     s = paymentReducer(s, { type: "START" }); // building
diff --git a/packages/ui/src/send-sequence.ts b/packages/ui/src/send-sequence.ts
index 4f1c1e6..05a707f 100644
--- a/packages/ui/src/send-sequence.ts
+++ b/packages/ui/src/send-sequence.ts
@@ -3,7 +3,7 @@
  * machine (payment-state.ts). The animation is a SLAVE to the machine, never a
  * timer: phase 1 ("encrypt") holds through building+proving, phase 2 ("settle")
  * through submitting, phase 3 ("verify") on confirmed. This is the line between a
- * credible ZK demo and a progress-bar lie — so the mapping lives here, tested,
+ * credible ZK demo and a progress-bar lie, so the mapping lives here, tested,
  * and both apps render it (warm coin-ceremony in the wallet, condensed strip in
  * the console).
  *
@@ -34,9 +34,9 @@ export interface CeremonyView {
   floorMs: number;
   /** whether to play motion (false under prefers-reduced-motion) */
   animate: boolean;
-  /** settled — render the verifiable receipt */
+  /** settled, render the verifiable receipt */
   done: boolean;
-  /** failed — render the error state */
+  /** failed, render the error state */
   failed: boolean;
 }
 
diff --git a/packages/ui/src/wallet-state.ts b/packages/ui/src/wallet-state.ts
index 7b03ce4..53237a7 100644
--- a/packages/ui/src/wallet-state.ts
+++ b/packages/ui/src/wallet-state.ts
@@ -1,7 +1,7 @@
 /**
- * Keychain lock/unlock lifecycle as a pure reducer — the UI side of
+ * Keychain lock/unlock lifecycle as a pure reducer, the UI side of
  * @benzo/wallet's `Keychain`. Models the states a lock screen needs: no wallet
- * yet, locked, unlocking (deriving the wrapping key — scrypt/passkey is not
+ * yet, locked, unlocking (deriving the wrapping key, scrypt/passkey is not
  * instant), unlocked, or a failed attempt.
  */
 
diff --git a/packages/ui/test/format.test.ts b/packages/ui/test/format.test.ts
index 36efc11..d48eb72 100644
--- a/packages/ui/test/format.test.ts
+++ b/packages/ui/test/format.test.ts
@@ -1,5 +1,5 @@
 /**
- * format.ts — money parse/format round-trips and identifier truncation. The
+ * format.ts, money parse/format round-trips and identifier truncation. The
  * parse path must refuse to silently drop a user's cents (over-precision throws).
  */
 import { describe, it, expect } from "vitest";