@supersuit/suggest-a-change 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.6 (2026-10-15)
+
+- **Writes made in the same millisecond leave the phone in the order they were made.** `enqueue` stamps each op with `seq`, and the queue sorts by `at`, then `seq`, then id. Before, ties fell to the id, so a screen that saved a draft and then asked for it to be prepared in one tick sent the prepare first about half the time, and the receiver prepared the draft as it had been.
+
+## 0.1.5 (2026-10-14)
+
+- **The agent is Pluma.** Every word a person reads now names Pluma, the agent formerly called Freeda: "With Pluma", "Goes to <owner> and Pluma", "Pluma picks it up". The status key `with-freeda` is unchanged, so stored reports and older clients still read. A copy of the contract vendored elsewhere must be taken again: these are new bytes.
+
 ## 0.1.4 (2026-10-14)
 
 - **The owner may decline a report Freeda has not planned.** `FLOW["with-freeda"].next` and `FLOW["planned"].next` now include `"not-now"`, so a report the reading worker cannot plan has an exit instead of showing "With Freeda" for ever. `agentStatus` accepts both moves (they take the approval, as any end does). A copy of the contract vendored elsewhere must be taken again: these are new bytes.

package/dist/client/detail.d.ts

@@ -2,7 +2,7 @@ import type { Adapters } from './adapters.ts';
 export declare function statusOf(r: Record<string, unknown>): string;
 /** The step shown under "Being made". The timeline entry is the truth (that is where the receiving side puts it); a top-level `step` is read only when there is no timeline. */
 export declare function stepOf(r: Record<string, unknown>): string | undefined;
-/** The strip is made from the contract's own statuses, one step per distinct word ("planned" reads as "With Freeda"),
+/** The strip is made from the contract's own statuses, one step per distinct word ("planned" reads as "With Pluma"),
  *  and a step is marked from the report's timeline: reached, skipped (the report went past it), or still ahead. */
 export declare function StatusStrip({ status, owner, step, timeline, label }: {
     status: string;

package/dist/client/detail.js

@@ -34,7 +34,7 @@ export function stepOf(r) {
     return typeof r.step === 'string' ? r.step : undefined;
 }
 const timelineOf = (r) => Array.isArray(r?.timeline) ? r.timeline.map((t) => String(t?.status)) : undefined;
-/** The strip is made from the contract's own statuses, one step per distinct word ("planned" reads as "With Freeda"),
+/** The strip is made from the contract's own statuses, one step per distinct word ("planned" reads as "With Pluma"),
  *  and a step is marked from the report's timeline: reached, skipped (the report went past it), or still ahead. */
 export function StatusStrip({ status, owner, step, timeline, label }) {
     const nodes = useMemo(() => {

package/dist/client/outbox.d.ts

@@ -9,6 +9,8 @@ export interface Op {
     /** The id of the write this one belongs to (a part's report or follow-up). While that write is refused, this one is held, not sent. */
     parent?: string;
     at: number;
+    /** The order this phone made it in, among writes with the same `at`. Written by enqueue. */
+    seq?: number;
     error?: string;
 }
 export type Sent = 'done' | {

package/dist/client/outbox.js

@@ -5,8 +5,11 @@ export function makeOutbox({ store, send, reach }) {
     // the new write existed. Measured on the phone: without this, a second answer sat on the phone
     // until the 15 s tick.
     let again = false;
+    // Two writes in one millisecond (a save, then the step that reads it) keep the order they were made
+    // in. Ordering them by id instead sent the second first about half the time.
+    let made = 0;
     async function pending() {
-        return (await store.all('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || a.id.localeCompare(b.id));
+        return (await store.all('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || (a.seq ?? 0) - (b.seq ?? 0) || a.id.localeCompare(b.id));
     }
     async function tell(landed) {
         const all = await pending();
@@ -56,7 +59,7 @@ export function makeOutbox({ store, send, reach }) {
     }
     return {
         pending,
-        async enqueue(op) { await store.put('outbox', op.id, op); await tell(); },
+        async enqueue(op) { await store.put('outbox', op.id, { ...op, seq: op.seq ?? ++made }); await tell(); },
         drain() {
             if (running) {
                 again = true;

package/dist/client/words.js

@@ -27,7 +27,7 @@ export const DEFAULT_STRINGS = {
     takeScreenshot: 'Take a screenshot of this screen',
     remove: 'Remove',
     withLegend: 'What goes with it',
-    goesTo: (owner) => `Goes to ${owner} and Freeda.`,
+    goesTo: (owner) => `Goes to ${owner} and Pluma.`,
     includes: (parts) => `Includes ${list(parts)}.`,
     screenName: "this screen's name",
     alwaysSent: (screen, route) => `Always sent: the screen you are on (${screen}) and its address (${route}).`,
@@ -113,7 +113,7 @@ export function statusMeaning(status, owner) {
 /** The receipt's one line (design section 2). `received` is only ever asked for after the adapter said `done`. */
 export function receiptWords(state, words) {
     if (state === 'received')
-        return `Got it. Freeda picks it up next time ${words.owner}'s Mac is on.`;
+        return `Got it. Pluma picks it up next time ${words.owner}'s Mac is on.`;
     if (state === 'on-mac')
         return 'On your Mac.';
     return 'On this phone, waiting to send.';

package/dist/contract.mjs

@@ -1,7 +1,7 @@
 // src/contract.mjs (@supersuit/suggest-a-change)
 // THE REPORT CONTRACT AND THE FLOW MAP for Suggest a change (design sections 4, 5 and 7). ZERO
 // imports on purpose, so it can be vendored whole where an install step does not exist: the phone, the
-// hosted apps and Freeda's inbox all validate against this one copy. The flow lives here, with who acts
+// hosted apps and Pluma's inbox all validate against this one copy. The flow lives here, with who acts
 // at each step, so what a person sees cannot drift from what happened.
 export const KINDS = ["change", "broken", "feedback"];
 export const ROLES = ["operator", "member", "maintainer"];
@@ -13,9 +13,9 @@ export const CEILINGS = {
 };
 export const STATUSES = ["on-phone", "received", "with-freeda", "planned", "waiting-on-owner", "being-made", "live", "sent-to-template", "filed", "not-now"];
 export const END = ["live", "sent-to-template", "filed", "not-now"];
-// actor: who PERFORMS this step (design section 7): sent by the person, received by the app, with Freeda by the Mac. A Helm on the owner's Mac posts straight into
-// the inbox, so a report may go from the phone to Freeda without the hosted app's "received". The owner may decline
-// ("not-now") before Freeda has a plan or before she asks: a report she cannot plan would otherwise have no exit.
+// actor: who PERFORMS this step (design section 7): sent by the person, received by the app, with Pluma by the Mac. A Helm on the owner's Mac posts straight into
+// the inbox, so a report may go from the phone to Pluma without the hosted app's "received". The owner may decline
+// ("not-now") before Pluma has a plan or before she asks: a report she cannot plan would otherwise have no exit.
 export const FLOW = {
     "on-phone": { actor: "person", next: ["received", "with-freeda"] },
     "received": { actor: "app", next: ["with-freeda"] },
@@ -29,14 +29,14 @@ export const FLOW = {
     "not-now": { actor: "owner", next: [] },
 };
 export const mayMove = (from, to) => Boolean(FLOW[from]?.next.includes(to));
-// The design's status table (section 2), word for word. "planned" is a step inside Freeda's work
-// that the table does not name for a person, so it reads as "With Freeda".
+// The design's status table (section 2), word for word. "planned" is a step inside Pluma's work
+// that the table does not name for a person, so it reads as "With Pluma".
 const TABLE = {
     "on-phone": ["On this phone", () => "Not sent yet; it will send when there is a connection"],
     "received": ["Received", () => "The app has it, safely stored"],
-    "with-freeda": ["With Freeda", (o) => `${o}'s Mac has picked it up`],
-    "planned": ["With Freeda", (o) => `${o}'s Mac has picked it up`],
-    "waiting-on-owner": [null, (o) => `Freeda has a plan and is asking ${o}`],
+    "with-freeda": ["With Pluma", (o) => `${o}'s Mac has picked it up`],
+    "planned": ["With Pluma", (o) => `${o}'s Mac has picked it up`],
+    "waiting-on-owner": [null, (o) => `Pluma has a plan and is asking ${o}`],
     "being-made": ["Being made", () => "A session is working on it; the current step shows underneath"],
     "live": ["Done", () => "Shipped in the app, with the date it went live"],
     "sent-to-template": ["Sent to the template", () => "It became a change to the template every copy of this app uses; it reaches this app once merged"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/suggest-a-change",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "The report format and flow behind a Suggest a change button: what a report is, who acts at each step, the screens, and the check every app runs. The contract has zero dependencies.",
   "type": "module",
   "bin": {

package/src/client/detail.tsx

@@ -30,7 +30,7 @@ export function stepOf(r: Record<string, unknown>): string | undefined {
 const timelineOf = (r?: Record<string, unknown>): string[] | undefined =>
   Array.isArray(r?.timeline) ? (r!.timeline as { status?: unknown }[]).map((t) => String(t?.status)) : undefined
 
-/** The strip is made from the contract's own statuses, one step per distinct word ("planned" reads as "With Freeda"),
+/** The strip is made from the contract's own statuses, one step per distinct word ("planned" reads as "With Pluma"),
  *  and a step is marked from the report's timeline: reached, skipped (the report went past it), or still ahead. */
 export function StatusStrip({ status, owner, step, timeline, label }: { status: string; owner: string; step?: string; timeline?: string[]; /** The list's accessible name; the screens pass the app's own (words.text.stepLabel). */ label?: string }) {
   const nodes = useMemo(() => {

package/src/client/outbox.ts

@@ -18,6 +18,8 @@ export interface Op {
   /** The id of the write this one belongs to (a part's report or follow-up). While that write is refused, this one is held, not sent. */
   parent?: string
   at: number
+  /** The order this phone made it in, among writes with the same `at`. Written by enqueue. */
+  seq?: number
   error?: string
 }
 export type Sent = 'done' | { refused: string }
@@ -30,9 +32,12 @@ export function makeOutbox({ store, send, reach }: { store: Store; send(op: Op):
   // the new write existed. Measured on the phone: without this, a second answer sat on the phone
   // until the 15 s tick.
   let again = false
+  // Two writes in one millisecond (a save, then the step that reads it) keep the order they were made
+  // in. Ordering them by id instead sent the second first about half the time.
+  let made = 0
 
   async function pending(): Promise<Op[]> {
-    return (await store.all<Op>('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || a.id.localeCompare(b.id))
+    return (await store.all<Op>('outbox')).map((r) => r.value).sort((a, b) => a.at - b.at || (a.seq ?? 0) - (b.seq ?? 0) || a.id.localeCompare(b.id))
   }
   async function tell(landed?: string) {
     const all = await pending()
@@ -69,7 +74,7 @@ export function makeOutbox({ store, send, reach }: { store: Store; send(op: Op):
   }
   return {
     pending,
-    async enqueue(op: Op) { await store.put('outbox', op.id, op); await tell() },
+    async enqueue(op: Op) { await store.put('outbox', op.id, { ...op, seq: op.seq ?? ++made }); await tell() },
     drain(): Promise<void> {
       if (running) { again = true; return running }
       return (running = run().finally(() => { running = null }))

package/src/client/words.ts

@@ -122,7 +122,7 @@ export const DEFAULT_STRINGS: Strings = {
   takeScreenshot: 'Take a screenshot of this screen',
   remove: 'Remove',
   withLegend: 'What goes with it',
-  goesTo: (owner) => `Goes to ${owner} and Freeda.`,
+  goesTo: (owner) => `Goes to ${owner} and Pluma.`,
   includes: (parts) => `Includes ${list(parts)}.`,
   screenName: "this screen's name",
   alwaysSent: (screen, route) => `Always sent: the screen you are on (${screen}) and its address (${route}).`,
@@ -202,7 +202,7 @@ export type ReceiptState = 'on-phone' | 'received' | 'on-mac'
 
 /** The receipt's one line (design section 2). `received` is only ever asked for after the adapter said `done`. */
 export function receiptWords(state: ReceiptState, words: Pick<Words, 'owner'>): string {
-  if (state === 'received') return `Got it. Freeda picks it up next time ${words.owner}'s Mac is on.`
+  if (state === 'received') return `Got it. Pluma picks it up next time ${words.owner}'s Mac is on.`
   if (state === 'on-mac') return 'On your Mac.'
   return 'On this phone, waiting to send.'
 }

package/src/contract.mjs

@@ -1,7 +1,7 @@
 // src/contract.mjs (@supersuit/suggest-a-change)
 // THE REPORT CONTRACT AND THE FLOW MAP for Suggest a change (design sections 4, 5 and 7). ZERO
 // imports on purpose, so it can be vendored whole where an install step does not exist: the phone, the
-// hosted apps and Freeda's inbox all validate against this one copy. The flow lives here, with who acts
+// hosted apps and Pluma's inbox all validate against this one copy. The flow lives here, with who acts
 // at each step, so what a person sees cannot drift from what happened.
 
 export const KINDS = ["change", "broken", "feedback"];
@@ -17,9 +17,9 @@ export const CEILINGS = {
 export const STATUSES = ["on-phone", "received", "with-freeda", "planned", "waiting-on-owner", "being-made", "live", "sent-to-template", "filed", "not-now"];
 export const END = ["live", "sent-to-template", "filed", "not-now"];
 
-// actor: who PERFORMS this step (design section 7): sent by the person, received by the app, with Freeda by the Mac. A Helm on the owner's Mac posts straight into
-// the inbox, so a report may go from the phone to Freeda without the hosted app's "received". The owner may decline
-// ("not-now") before Freeda has a plan or before she asks: a report she cannot plan would otherwise have no exit.
+// actor: who PERFORMS this step (design section 7): sent by the person, received by the app, with Pluma by the Mac. A Helm on the owner's Mac posts straight into
+// the inbox, so a report may go from the phone to Pluma without the hosted app's "received". The owner may decline
+// ("not-now") before Pluma has a plan or before she asks: a report she cannot plan would otherwise have no exit.
 export const FLOW = {
   "on-phone": { actor: "person", next: ["received", "with-freeda"] },
   "received": { actor: "app", next: ["with-freeda"] },
@@ -35,14 +35,14 @@ export const FLOW = {
 
 export const mayMove = (from, to) => Boolean(FLOW[from]?.next.includes(to));
 
-// The design's status table (section 2), word for word. "planned" is a step inside Freeda's work
-// that the table does not name for a person, so it reads as "With Freeda".
+// The design's status table (section 2), word for word. "planned" is a step inside Pluma's work
+// that the table does not name for a person, so it reads as "With Pluma".
 const TABLE = {
   "on-phone": ["On this phone", () => "Not sent yet; it will send when there is a connection"],
   "received": ["Received", () => "The app has it, safely stored"],
-  "with-freeda": ["With Freeda", (o) => `${o}'s Mac has picked it up`],
-  "planned": ["With Freeda", (o) => `${o}'s Mac has picked it up`],
-  "waiting-on-owner": [null, (o) => `Freeda has a plan and is asking ${o}`],
+  "with-freeda": ["With Pluma", (o) => `${o}'s Mac has picked it up`],
+  "planned": ["With Pluma", (o) => `${o}'s Mac has picked it up`],
+  "waiting-on-owner": [null, (o) => `Pluma has a plan and is asking ${o}`],
   "being-made": ["Being made", () => "A session is working on it; the current step shows underneath"],
   "live": ["Done", () => "Shipped in the app, with the date it went live"],
   "sent-to-template": ["Sent to the template", () => "It became a change to the template every copy of this app uses; it reaches this app once merged"],