@rubytech/create-maxy-code 0.1.570 → 0.1.572

package/payload/platform/lib/dispatch-read/dist/types.d.ts

@@ -0,0 +1,173 @@
+/**
+ * The dispatch config contract, and the row shapes every read returns.
+ *
+ * This mirrors `platform/plugins/dispatch/mcp/src/lib/types.ts`. It lives here
+ * because two callers now need it: the dispatch plugin's MCP tools and the
+ * office planner's UI route. One declaration, so a field added for the planner
+ * cannot silently diverge from what the tools return.
+ *
+ * Nothing an operator can name appears as a literal in this package. A taxi
+ * firm's fare/pickup/driver and a contractor's job/visit/engineer are both just
+ * `vocabulary`.
+ */
+export interface StatusDecl {
+    readonly name: string;
+    /** True when a job or visit that reaches this status is finished. */
+    readonly terminal: boolean;
+}
+/** One legal move, `[from, to]`. Absent from the list means refused. */
+export type Transition = readonly [string, string];
+export interface StatusConfig {
+    readonly job: readonly StatusDecl[];
+    readonly visit: readonly StatusDecl[];
+    readonly jobTransitions: readonly Transition[];
+    readonly visitTransitions: readonly Transition[];
+}
+export interface JobType {
+    readonly name: string;
+    /** A worker is offered for this type only if they hold this qualification. */
+    readonly requiredQualification: string;
+    readonly defaultDurationMin: number;
+    /**
+     * Hours from job creation to the SLA target. Omitted when the account sets no
+     * target for this type — omitted, never zero, because a zero would make every
+     * job of that type instantly overdue.
+     */
+    readonly slaTargetHours?: number;
+}
+/** `{ mon: ["08:00", "17:00"] }`. Absent day means not working that day. */
+export type WorkingHours = Readonly<Record<string, readonly [string, string]>>;
+export interface Worker {
+    readonly workerId: string;
+    readonly name: string;
+    readonly qualifications: readonly string[];
+    readonly workingHours: WorkingHours;
+    /**
+     * The Telegram user id this worker signs in as, for the field job sheet
+     * (Task 2502). Absent means the worker has no field surface: an `initData`
+     * naming that Telegram user is refused as `unbound-user` rather than matched
+     * to somebody by name.
+     *
+     * It lives on the roster rather than in a bindings file of its own because a
+     * second roster is a second thing to keep in step, and nothing would.
+     */
+    readonly telegramUserId?: string;
+}
+export interface RecordsConfig {
+    /** Checklist template per job type name. */
+    readonly checklists: Readonly<Record<string, readonly string[]>>;
+    /**
+     * Field names a visit must carry before it may reach the keyed terminal visit
+     * status. Recognised names: `notes`, `media`, `parts`, `checklist`,
+     * `signature`.
+     */
+    readonly requiredBeforeTerminal: Readonly<Record<string, readonly string[]>>;
+}
+export interface Vocabulary {
+    readonly job: string;
+    readonly visit: string;
+    readonly worker: string;
+}
+export interface VehicleConfig {
+    readonly enabled: boolean;
+    readonly defaultGeofenceRadiusM?: number;
+}
+export interface DispatchConfig {
+    readonly statuses: StatusConfig;
+    readonly jobTypes: readonly JobType[];
+    readonly workers: readonly Worker[];
+    readonly records: RecordsConfig;
+    readonly vocabulary: Vocabulary;
+    readonly vehicles: VehicleConfig;
+}
+/**
+ * `loadDispatchConfig` result. Absence is a named state, never a throw: the
+ * plugin ships inert and most accounts never enable it, so "no config" is the
+ * common case rather than a fault. Module init reads this and must not throw,
+ * because plugin-system spawn enumerates tools with empty environment and one
+ * boot throw empties the whole registry.
+ */
+export type LoadResult = {
+    readonly present: true;
+    readonly value: DispatchConfig;
+} | {
+    readonly present: false;
+    readonly reason: "no-account-dir" | "no-file" | "unreadable" | "invalid";
+    readonly detail?: string;
+};
+export interface JobRow {
+    jobId: string;
+    status: string;
+    jobType: string | null;
+    slaTargetAt: string | null;
+    siteId: string | null;
+    siteName: string | null;
+    customerId: string | null;
+    createdAt: string | null;
+}
+export interface VisitRow {
+    visitId: string;
+    /** Null when the visit is not linked to a job. Log fields render `none`. */
+    jobId: string | null;
+    status: string;
+    startDate: string | null;
+    endDate: string | null;
+    purpose: string | null;
+    workerId: string | null;
+    /**
+     * What somebody said, and what was measured. Separate properties written by
+     * separate clauses: recording either never clears the other. A single
+     * `arrivedAt` cannot show a worker closing Monday's jobs on Tuesday; two that
+     * disagree can.
+     */
+    arrivedPressedAt: string | null;
+    arrivedObservedAt: string | null;
+    arrivedObservedDistanceM: number | null;
+}
+/** A visit with the fields a planner card needs beyond the plain visit row. */
+export interface PlannerVisit extends VisitRow {
+    siteName: string | null;
+    customerId: string | null;
+    customerName: string | null;
+    jobType: string | null;
+}
+/**
+ * The field job sheet's card (Task 2502).
+ *
+ * Wider than `PlannerVisit` on contact detail, because a worker on a doorstep
+ * needs a name and a telephone and the office grid does not.
+ *
+ * It carries **no address and no postcode**, and that absence is the design.
+ * `:Site` declares neither, and the only `PostalAddress` edge in the ontology
+ * belongs to the logistics vertical. An always-null column would read as a
+ * site with no address rather than a product that does not store one. Task
+ * 2514 adds the edge; `sitesVisitedTodayWithoutAddress` on
+ * `[dispatch-field-census]` counts what it costs until then.
+ */
+export interface FieldVisit extends VisitRow {
+    siteId: string | null;
+    siteName: string | null;
+    customerName: string | null;
+    contactName: string | null;
+    contactTelephone: string | null;
+}
+/**
+ * Aggregates, not the length of a capped row list. `readJobList` caps at 500
+ * rows, so counting its result would under-report any account with more jobs
+ * than that — the reference account holds 2,869.
+ */
+export interface DispatchCounts {
+    total: number;
+    unallocated: number;
+    overdue: number;
+}
+export interface JobListFilter {
+    status?: string;
+    jobType?: string;
+    workerId?: string;
+    from?: string;
+    to?: string;
+    unallocatedOnly?: boolean;
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/payload/platform/lib/dispatch-read/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/payload/platform/lib/dispatch-read/dist/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * The dispatch config contract, and the row shapes every read returns.
+ *
+ * This mirrors `platform/plugins/dispatch/mcp/src/lib/types.ts`. It lives here
+ * because two callers now need it: the dispatch plugin's MCP tools and the
+ * office planner's UI route. One declaration, so a field added for the planner
+ * cannot silently diverge from what the tools return.
+ *
+ * Nothing an operator can name appears as a literal in this package. A taxi
+ * firm's fare/pickup/driver and a contractor's job/visit/engineer are both just
+ * `vocabulary`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/payload/platform/lib/dispatch-read/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/payload/platform/lib/dispatch-read/dist/window.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Day boundaries in the account's zone, converted to UTC instants for the query.
+ *
+ * `dispatch-day` bounded its window with a literal `Z`
+ * (`${date}T00:00:00.000Z`), which places every Europe/London visit between
+ * local midnight and 01:00 on the previous day for the whole of British Summer
+ * Time. The zone here is always the account's, never the browser's and never
+ * the process's.
+ *
+ * No date library: `Intl.DateTimeFormat` carries the IANA rules already, and
+ * adding a dependency to compute an offset the platform ships would be a second
+ * source of zone truth.
+ */
+export declare const MAX_RANGE_DAYS = 31;
+/**
+ * The UTC instant at which `dateYmd` begins in `zone`.
+ *
+ * Two passes: the offset at the naive guess can differ from the offset at the
+ * answer across a DST boundary, so the first pass finds an approximate instant
+ * and the second re-reads the offset there.
+ */
+export declare function zonedDayStartUtc(dateYmd: string, zone: string): string;
+export declare function addDaysYmd(ymd: string, days: number): string;
+export declare function daysBetween(fromYmd: string, toYmd: string): number;
+/**
+ * `[fromUtc, toUtc)` for an inclusive range of local dates. `toUtc` is the
+ * exclusive start of the day after `toYmd`, so the last day is whole.
+ *
+ * A range wider than the cap is refused rather than truncated: a silently
+ * shortened week renders as a quiet week.
+ */
+export declare function zonedRangeBounds(fromYmd: string, toYmd: string, zone: string): {
+    fromUtc: string;
+    toUtc: string;
+};
+/** The calendar date at `instantMs` as seen in `zone`. */
+export declare function ymdInZone(instantMs: number, zone: string): string;
+/**
+ * Minutes from local midnight. This is the grid's row offset, and it has to be
+ * computed in the account zone or a card lands in the wrong column.
+ */
+export declare function minutesIntoDay(instantMs: number, zone: string): number;
+/** Monday to Sunday containing `nowMs`, as local dates in `zone`. */
+export declare function currentWeekYmd(nowMs: number, zone: string): {
+    fromYmd: string;
+    toYmd: string;
+};
+//# sourceMappingURL=window.d.ts.map

package/payload/platform/lib/dispatch-read/dist/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,cAAc,KAAK,CAAC;AAiCjC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUpC;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASpC"}

package/payload/platform/lib/dispatch-read/dist/window.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Day boundaries in the account's zone, converted to UTC instants for the query.
+ *
+ * `dispatch-day` bounded its window with a literal `Z`
+ * (`${date}T00:00:00.000Z`), which places every Europe/London visit between
+ * local midnight and 01:00 on the previous day for the whole of British Summer
+ * Time. The zone here is always the account's, never the browser's and never
+ * the process's.
+ *
+ * No date library: `Intl.DateTimeFormat` carries the IANA rules already, and
+ * adding a dependency to compute an offset the platform ships would be a second
+ * source of zone truth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_RANGE_DAYS = void 0;
+exports.zonedDayStartUtc = zonedDayStartUtc;
+exports.addDaysYmd = addDaysYmd;
+exports.daysBetween = daysBetween;
+exports.zonedRangeBounds = zonedRangeBounds;
+exports.ymdInZone = ymdInZone;
+exports.minutesIntoDay = minutesIntoDay;
+exports.currentWeekYmd = currentWeekYmd;
+exports.MAX_RANGE_DAYS = 31;
+/** Milliseconds the zone is ahead of UTC at this instant. */
+function zoneOffsetMs(instantMs, zone) {
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone: zone,
+        hour12: false,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    }).formatToParts(new Date(instantMs));
+    const get = (type) => Number(parts.find((p) => p.type === type)?.value ?? 0);
+    // `hour` formats local midnight as 24 under hour12:false in some ICU builds.
+    const asIfUtc = Date.UTC(get("year"), get("month") - 1, get("day"), get("hour") % 24, get("minute"), get("second"));
+    return asIfUtc - Math.floor(instantMs / 1000) * 1000;
+}
+function ymdParts(ymd) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(ymd);
+    if (!m)
+        throw new Error(`bad-date reason=not-yyyy-mm-dd value=${ymd}`);
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+/**
+ * The UTC instant at which `dateYmd` begins in `zone`.
+ *
+ * Two passes: the offset at the naive guess can differ from the offset at the
+ * answer across a DST boundary, so the first pass finds an approximate instant
+ * and the second re-reads the offset there.
+ */
+function zonedDayStartUtc(dateYmd, zone) {
+    const [y, m, d] = ymdParts(dateYmd);
+    const guess = Date.UTC(y, m - 1, d, 0, 0, 0, 0);
+    const firstPass = guess - zoneOffsetMs(guess, zone);
+    const secondPass = guess - zoneOffsetMs(firstPass, zone);
+    return new Date(secondPass).toISOString();
+}
+function addDaysYmd(ymd, days) {
+    const [y, m, d] = ymdParts(ymd);
+    return new Date(Date.UTC(y, m - 1, d + days)).toISOString().slice(0, 10);
+}
+function daysBetween(fromYmd, toYmd) {
+    const [fy, fm, fd] = ymdParts(fromYmd);
+    const [ty, tm, td] = ymdParts(toYmd);
+    return Math.round((Date.UTC(ty, tm - 1, td) - Date.UTC(fy, fm - 1, fd)) / 86_400_000);
+}
+/**
+ * `[fromUtc, toUtc)` for an inclusive range of local dates. `toUtc` is the
+ * exclusive start of the day after `toYmd`, so the last day is whole.
+ *
+ * A range wider than the cap is refused rather than truncated: a silently
+ * shortened week renders as a quiet week.
+ */
+function zonedRangeBounds(fromYmd, toYmd, zone) {
+    const span = daysBetween(fromYmd, toYmd);
+    if (span < 0)
+        throw new Error(`range-inverted from=${fromYmd} to=${toYmd}`);
+    if (span + 1 > exports.MAX_RANGE_DAYS) {
+        throw new Error(`range-too-wide days=${span + 1} max=${exports.MAX_RANGE_DAYS}`);
+    }
+    return {
+        fromUtc: zonedDayStartUtc(fromYmd, zone),
+        toUtc: zonedDayStartUtc(addDaysYmd(toYmd, 1), zone),
+    };
+}
+/** The calendar date at `instantMs` as seen in `zone`. */
+function ymdInZone(instantMs, zone) {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+        timeZone: zone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    }).formatToParts(new Date(instantMs));
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    return `${get("year")}-${get("month")}-${get("day")}`;
+}
+/**
+ * Minutes from local midnight. This is the grid's row offset, and it has to be
+ * computed in the account zone or a card lands in the wrong column.
+ */
+function minutesIntoDay(instantMs, zone) {
+    const dayStart = Date.parse(zonedDayStartUtc(ymdInZone(instantMs, zone), zone));
+    return Math.round((instantMs - dayStart) / 60_000);
+}
+/** Monday to Sunday containing `nowMs`, as local dates in `zone`. */
+function currentWeekYmd(nowMs, zone) {
+    const today = ymdInZone(nowMs, zone);
+    const [y, m, d] = ymdParts(today);
+    // A UTC-constructed date gives the weekday of the zone-local calendar date,
+    // because the date parts already came from the zone.
+    const weekday = new Date(Date.UTC(y, m - 1, d)).getUTCDay();
+    const backToMonday = weekday === 0 ? 6 : weekday - 1;
+    const fromYmd = addDaysYmd(today, -backToMonday);
+    return { fromYmd, toYmd: addDaysYmd(fromYmd, 6) };
+}
+//# sourceMappingURL=window.js.map

package/payload/platform/lib/dispatch-read/dist/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"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"}

package/payload/platform/lib/dispatch-read/dist/zone.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The account's IANA timezone, read from `:UserProfile`.
+ *
+ * Reimplemented here rather than imported from the UI server's `neo4j-store`
+ * because a route importing that would transitively pull in the neo4j driver,
+ * and the whole point of this package is that the planner route can be asserted
+ * to hold no graph access.
+ *
+ * Null on any failure, and the caller's policy is UTC. Falling back to the
+ * browser zone is the defect Task 2280 left on thirteen surfaces: it renders
+ * plausibly and is wrong, which is worse than rendering a zone you can see.
+ *
+ * `userId` omitted is the account-wide read: one UserProfile per account today,
+ * with the ORDER BY pinning the row so the answer stays deterministic if that
+ * ever stops being true.
+ */
+export declare function resolveAccountZone(accountId: string, userId?: string): Promise<string | null>;
+//# sourceMappingURL=zone.d.ts.map

package/payload/platform/lib/dispatch-read/dist/zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../src/zone.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxB"}

package/payload/platform/lib/dispatch-read/dist/zone.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAccountZone = resolveAccountZone;
+const session_js_1 = require("./session.js");
+/**
+ * The account's IANA timezone, read from `:UserProfile`.
+ *
+ * Reimplemented here rather than imported from the UI server's `neo4j-store`
+ * because a route importing that would transitively pull in the neo4j driver,
+ * and the whole point of this package is that the planner route can be asserted
+ * to hold no graph access.
+ *
+ * Null on any failure, and the caller's policy is UTC. Falling back to the
+ * browser zone is the defect Task 2280 left on thirteen surfaces: it renders
+ * plausibly and is wrong, which is worse than rendering a zone you can see.
+ *
+ * `userId` omitted is the account-wide read: one UserProfile per account today,
+ * with the ORDER BY pinning the row so the answer stays deterministic if that
+ * ever stops being true.
+ */
+async function resolveAccountZone(accountId, userId) {
+    try {
+        return await (0, session_js_1.withSession)(async (session) => {
+            const query = userId
+                ? `MATCH (up:UserProfile {accountId: $accountId, userId: $userId})
+           RETURN up.timezone AS timezone`
+                : `MATCH (up:UserProfile {accountId: $accountId})
+           RETURN up.timezone AS timezone ORDER BY up.createdAt LIMIT 1`;
+            const result = await session.run(query, { accountId, userId: userId ?? "" });
+            if (result.records.length === 0)
+                return null;
+            const tz = result.records[0].get("timezone");
+            return tz && tz.trim().length > 0 ? tz : null;
+        });
+    }
+    catch (err) {
+        console.error(`[dispatch-planner] op=zone-unresolved account=${accountId} error="${err instanceof Error ? err.message : String(err)}"`);
+        return null;
+    }
+}
+//# sourceMappingURL=zone.js.map

package/payload/platform/lib/dispatch-read/dist/zone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.js","sourceRoot":"","sources":["../src/zone.ts"],"names":[],"mappings":";;AAkBA,gDAwBC;AA1CD,6CAA2C;AAE3C;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,MAAe;IAEf,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,wBAAW,EAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,MAAM;gBAClB,CAAC,CAAC;0CACgC;gBAClC,CAAC,CAAC;wEAC8D,CAAC;YACnE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7E,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAkB,CAAC;YAC9D,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,iDAAiD,SAAS,WACxD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,GAAG,CACJ,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/payload/platform/lib/dispatch-read/src/__tests__/config.test.ts

@@ -0,0 +1,62 @@
+import { describe, expect, it } from "vitest";
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadDispatchConfig } from "../config.js";
+
+function accountDirWith(config: unknown): string {
+  const dir = mkdtempSync(join(tmpdir(), "dispatch-cfg-"));
+  mkdirSync(join(dir, "dispatch"));
+  writeFileSync(join(dir, "dispatch", "config.json"), JSON.stringify(config));
+  return dir;
+}
+
+const TAXI = {
+  statuses: {
+    job: [{ name: "Hailed", terminal: false }],
+    visit: [],
+    jobTransitions: [],
+    visitTransitions: [],
+  },
+  jobTypes: [],
+  workers: [],
+  records: { checklists: {}, requiredBeforeTerminal: {} },
+  vocabulary: { job: "fare", visit: "pickup", worker: "driver" },
+  vehicles: { enabled: false },
+};
+
+describe("loadDispatchConfig", () => {
+  it("names a missing account dir rather than throwing", () => {
+    const r = loadDispatchConfig(join(tmpdir(), "dispatch-does-not-exist-ever"));
+    expect(r).toEqual({ present: false, reason: "no-account-dir" });
+  });
+
+  it("names an absent file rather than throwing", () => {
+    const dir = mkdtempSync(join(tmpdir(), "dispatch-empty-"));
+    expect(loadDispatchConfig(dir)).toEqual({ present: false, reason: "no-file" });
+  });
+
+  it("names an unparseable file as invalid, not as missing", () => {
+    const dir = mkdtempSync(join(tmpdir(), "dispatch-bad-"));
+    mkdirSync(join(dir, "dispatch"));
+    writeFileSync(join(dir, "dispatch", "config.json"), "{ not json");
+    const r = loadDispatchConfig(dir);
+    expect(r.present).toBe(false);
+    if (!r.present) {
+      expect(r.reason).toBe("invalid");
+      expect(r.detail).toBeTruthy();
+    }
+  });
+
+  it("returns the account vocabulary verbatim", () => {
+    const r = loadDispatchConfig(accountDirWith(TAXI));
+    expect(r.present).toBe(true);
+    if (r.present) {
+      expect(r.value.vocabulary).toEqual({ job: "fare", visit: "pickup", worker: "driver" });
+    }
+  });
+
+  it("never throws on an empty account dir string", () => {
+    expect(loadDispatchConfig("")).toEqual({ present: false, reason: "no-account-dir" });
+  });
+});