@rubytech/create-realagent-code 0.1.574 → 0.1.576

package/payload/platform/lib/canonical-instant/src/index.ts

@@ -0,0 +1,147 @@
+/**
+ * The single definition of a canonical stored instant.
+ *
+ * Extracted from `plugins/scheduling/mcp/src/lib/time-format.ts` by Task 2513,
+ * unchanged, so the dispatch writer, the dispatch migration and the two
+ * scheduling writers cannot disagree about what canonical means. Task 2213
+ * stated the invariant as "One function, three callers, no drift possible"; a
+ * second copy in the dispatch tree would have broken it.
+ *
+ * Pure. No database, no driver, no plugin import.
+ */
+
+/**
+ * Validates an IANA timezone string. Throws with a clear message if invalid.
+ */
+export function validateTimezone(tz: string): void {
+  if (!tz || tz.trim().length === 0) {
+    throw new Error("Timezone is required but was empty");
+  }
+  try {
+    // Intl.DateTimeFormat throws RangeError for invalid IANA timezone identifiers
+    new Intl.DateTimeFormat("en-GB", { timeZone: tz });
+  } catch {
+    throw new Error(
+      `Invalid timezone: "${tz}" — expected IANA format like "Europe/London" or "America/New_York"`,
+    );
+  }
+}
+
+/** Ends with `Z` or a numeric UTC offset, e.g. `+01:00`, `-0500`. */
+const HAS_ZONE = /(?:Z|[+-]\d{2}:?\d{2})$/;
+
+/** The zone's wall-clock parts at a given instant. */
+function partsAt(ms: number, zone: string): Record<string, string> {
+  const dtf = new Intl.DateTimeFormat("en-GB", {
+    timeZone: zone,
+    hour12: false,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+  });
+  return Object.fromEntries(dtf.formatToParts(new Date(ms)).map((p) => [p.type, p.value]));
+}
+
+/**
+ * Milliseconds the zone is ahead of UTC at `ms`.
+ *
+ * Subtracted against the SECOND-truncated instant, never `ms` itself.
+ * `Intl.DateTimeFormat` resolves only to seconds, so differencing its
+ * reconstruction against a millisecond-bearing instant folds the fractional part
+ * into the offset: at `09:00:00.500` the offset came back as 3_599_500 rather
+ * than 3_600_000, and the caller's `naive - offset` then landed a full second
+ * out. A real zone offset is always a whole number of minutes, so truncating is
+ * lossless here and keeps the caller's sub-second precision intact.
+ */
+function offsetMsAt(ms: number, zone: string): number {
+  const p = partsAt(ms, zone);
+  // `hour` renders as "24" for midnight in en-GB; % 24 folds it back to 0.
+  const wallUtc = Date.UTC(+p.year, +p.month - 1, +p.day, +p.hour % 24, +p.minute, +p.second);
+  return wallUtc - Math.floor(ms / 1000) * 1000;
+}
+
+/** The zone's wall clock at `ms`, in the same shape as a zoneless input. */
+function wallAt(ms: number, zone: string): string {
+  const p = partsAt(ms, zone);
+  const hh = String(+p.hour % 24).padStart(2, "0");
+  return `${p.year}-${p.month}-${p.day}T${hh}:${p.minute}:${p.second}`;
+}
+
+/**
+ * The exact 24-character shape `toISOString()` produces, as a regex source.
+ *
+ * Exported as a string rather than a `RegExp` because it is also passed to
+ * Cypher as a `=~` parameter. One source, so the standing audit's predicate and
+ * this module's predicate cannot drift; passing it as a parameter also removes
+ * the backslash-escaping ambiguity of an inlined Cypher literal.
+ */
+export const CANONICAL_INSTANT_PATTERN = "\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z";
+
+/**
+ * Task 2213, generalised by Task 2513 — the single definition of a canonical
+ * stored instant.
+ *
+ * Stored instants are compared as STRINGS, lexically, in Cypher: the scheduling
+ * dispatcher on `e.startDate <= $now`, and the dispatch planner on
+ * `v.startDate >= $from AND v.startDate < $to`. An offset suffix is never
+ * parsed, so a `+01:00` value sorts by its wall-clock digits — 60 minutes out
+ * under BST, and correct under GMT, which is why the defect self-heals every
+ * October and returns every March.
+ *
+ * The output is therefore always the exact 24-character shape `toISOString()`
+ * produces. The fixed width is the point: lexical order equals instant order
+ * only when every stored value shares one shape. That is also why this is not
+ * done in Cypher — `toString(datetime(...))` omits `.000` at a zero-millisecond
+ * instant, and `"…00.000Z"` sorts BEFORE `"…00Z"`.
+ *
+ * A zoneless wall clock is read in `zone`, never in the server's zone: a
+ * server-local reading makes the stored instant depend on which machine wrote
+ * it, which is the same fault class one layer down. With no usable zone this
+ * throws rather than guessing.
+ *
+ * DST is resolved the way `Temporal`'s `disambiguation: 'compatible'` resolves
+ * it. Take the offsets in force a day either side, giving two candidate
+ * instants; keep those that render back to exactly the input wall clock. If any
+ * survive, take the earliest (the earlier occurrence of an ambiguous autumn
+ * time). If none survive, the wall clock is inside a spring-forward gap and does
+ * not exist, so take the later candidate, which shifts it past the gap.
+ */
+export function normaliseInstant(raw: string, zone: string | null): string {
+  const trimmed = raw.trim();
+
+  if (HAS_ZONE.test(trimmed)) {
+    const ms = Date.parse(trimmed);
+    if (Number.isNaN(ms)) {
+      throw new Error(`Unparseable instant: "${raw}" — expected an ISO 8601 date-time`);
+    }
+    return new Date(ms).toISOString();
+  }
+
+  if (!zone) {
+    throw new Error(
+      `Instant "${raw}" carries no timezone offset and no timezone is available to read it in — ` +
+        `pass an IANA timezone, or write the offset into the value`,
+    );
+  }
+  validateTimezone(zone);
+
+  const naive = Date.parse(`${trimmed}Z`);
+  if (Number.isNaN(naive)) {
+    throw new Error(`Unparseable instant: "${raw}" — expected an ISO 8601 date-time`);
+  }
+
+  const DAY_MS = 86_400_000;
+  const before = naive - offsetMsAt(naive - DAY_MS, zone);
+  const after = naive - offsetMsAt(naive + DAY_MS, zone);
+  const valid = [before, after].filter((ms) => wallAt(ms, zone) === trimmed);
+  const chosen = valid.length > 0 ? Math.min(...valid) : Math.max(before, after);
+  return new Date(chosen).toISOString();
+}
+
+/** True when `value` is already in the canonical form above. */
+export function isCanonicalInstant(value: string): boolean {
+  return new RegExp(`^${CANONICAL_INSTANT_PATTERN}$`).test(value);
+}

package/payload/platform/lib/canonical-instant/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["src/__tests__"]
+}

package/payload/platform/lib/canonical-instant/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: false,
+    include: ["src/__tests__/**/*.test.ts"],
+  },
+});

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

@@ -0,0 +1,34 @@
+/**
+ * Distance to a site, and whether that counts as being there.
+ *
+ * The verdict names why it could not fire rather than returning a bare false.
+ * "This site has no coordinates", "this account configured no radius" and "the
+ * worker is four kilometres away" are three different problems with three
+ * different fixes, and a single boolean sends an operator to the wrong one.
+ */
+import type { DispatchConfig, SiteLocation } from "./types.js";
+/** Great-circle distance in metres, rounded. */
+export declare function distanceM(a: {
+    latitude: number;
+    longitude: number;
+}, b: {
+    latitude: number;
+    longitude: number;
+}): number;
+export interface GeofenceVerdict {
+    siteHasCoords: boolean;
+    /** The site's own radius, else the account default, else null. */
+    radiusM: number | null;
+    /** Null when there is nothing to measure against. */
+    distanceM: number | null;
+    inside: boolean;
+}
+export declare function geofenceVerdict(p: {
+    site: SiteLocation | null;
+    cfg: DispatchConfig;
+    at: {
+        latitude: number;
+        longitude: number;
+    };
+}): GeofenceVerdict;
+//# sourceMappingURL=geo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/D,gDAAgD;AAChD,wBAAgB,SAAS,CACvB,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC1C,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC,MAAM,CAQR;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE;IACjC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC;IACpB,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C,GAAG,eAAe,CAclB"}

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distanceM = distanceM;
+exports.geofenceVerdict = geofenceVerdict;
+const EARTH_RADIUS_M = 6_371_000;
+const toRad = (deg) => (deg * Math.PI) / 180;
+/** Great-circle distance in metres, rounded. */
+function distanceM(a, b) {
+    const dLat = toRad(b.latitude - a.latitude);
+    const dLon = toRad(b.longitude - a.longitude);
+    const lat1 = toRad(a.latitude);
+    const lat2 = toRad(b.latitude);
+    const h = Math.sin(dLat / 2) ** 2 + Math.sin(dLon / 2) ** 2 * Math.cos(lat1) * Math.cos(lat2);
+    return Math.round(2 * EARTH_RADIUS_M * Math.asin(Math.sqrt(h)));
+}
+function geofenceVerdict(p) {
+    const siteHasCoords = p.site !== null && p.site.latitude !== null && p.site.longitude !== null;
+    const radiusM = p.site?.geofenceRadiusM ?? p.cfg.vehicles?.defaultGeofenceRadiusM ?? null;
+    if (!siteHasCoords) {
+        return { siteHasCoords: false, radiusM, distanceM: null, inside: false };
+    }
+    const d = distanceM({ latitude: p.site.latitude, longitude: p.site.longitude }, p.at);
+    // A distance with no radius to compare it against cannot say whether anybody
+    // arrived. Reported, never assumed.
+    return { siteHasCoords: true, radiusM, distanceM: d, inside: radiusM !== null && d <= radiusM };
+}
+//# sourceMappingURL=geo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geo.js","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":";;AAeA,8BAWC;AAWD,0CAkBC;AA7CD,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;AAE7D,gDAAgD;AAChD,SAAgB,SAAS,CACvB,CAA0C,EAC1C,CAA0C;IAE1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,CAAC,GACL,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAWD,SAAgB,eAAe,CAAC,CAI/B;IACC,MAAM,aAAa,GACjB,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IAC3E,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,sBAAsB,IAAI,IAAI,CAAC;IAC1F,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,CAAC,GAAG,SAAS,CACjB,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAK,CAAC,QAAkB,EAAE,SAAS,EAAE,CAAC,CAAC,IAAK,CAAC,SAAmB,EAAE,EAChF,CAAC,CAAC,EAAE,CACL,CAAC;IACF,6EAA6E;IAC7E,oCAAoC;IACpC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;AAClG,CAAC"}

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

@@ -12,11 +12,15 @@
  */
 export { RECORDABLE_FIELDS, loadDispatchConfig, terminalJobStatuses, terminalVisitStatuses, workerForTelegramUser, } from "./config.js";
 export type { RecordableField } from "./config.js";
+export { CALLBACK_DATA_MAX_BYTES, buildVisitKeyboard, dispatchCallbackData, parseDispatchCallback, } from "./keyboard.js";
+export type { DispatchButton, VisitKeyboard } from "./keyboard.js";
 export { withSession } from "./session.js";
 export { resolveAccountZone } from "./zone.js";
 export { MAX_RANGE_DAYS, addDaysYmd, currentWeekYmd, daysBetween, minutesIntoDay, ymdInZone, zonedDayStartUtc, zonedRangeBounds, } from "./window.js";
-export { buildJobListQuery, projectJob, projectVisit, readCommitments, readJob, readJobs, readNodeId, readSiteHistory, readVisit, readVisitRecordState, readVisitsForJob, readVisitsInWindow, } from "./read.js";
+export { buildJobListQuery, projectFieldVisit, projectJob, projectVisit, readCommitments, readDraft, readDrafts, readFieldVisit, readJob, readJobs, readNodeId, readOpenVisitsForWorker, readPreviousVisits, readSiteHistory, readSiteLocation, readVisit, readVisitRecordState, readVisitsForJob, readVisitsInWindow, } from "./read.js";
+export { distanceM, geofenceVerdict } from "./geo.js";
+export type { GeofenceVerdict } from "./geo.js";
 export { nonZuluStarts, readCounts, readDay, readJobList, readWorkerDay } from "./read.js";
-export type { Commitment, VisitRecordState } from "./read.js";
+export type { Commitment, DraftRow, PreviousVisit, VisitRecordState } from "./read.js";
 export type * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,UAAU,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,OAAO,EACP,QAAQ,EACR,UAAU,EACV,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3F,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9D,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,UAAU,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,SAAS,EACT,UAAU,EACV,cAAc,EACd,OAAO,EACP,QAAQ,EACR,UAAU,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3F,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvF,mBAAmB,YAAY,CAAC"}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readWorkerDay = exports.readJobList = exports.readDay = exports.readCounts = exports.nonZuluStarts = exports.readVisitsInWindow = exports.readVisitsForJob = exports.readVisitRecordState = exports.readVisit = exports.readSiteHistory = exports.readNodeId = exports.readJobs = exports.readJob = exports.readCommitments = exports.projectVisit = exports.projectJob = exports.buildJobListQuery = exports.zonedRangeBounds = exports.zonedDayStartUtc = exports.ymdInZone = exports.minutesIntoDay = exports.daysBetween = exports.currentWeekYmd = exports.addDaysYmd = exports.MAX_RANGE_DAYS = exports.resolveAccountZone = exports.withSession = exports.workerForTelegramUser = exports.terminalVisitStatuses = exports.terminalJobStatuses = exports.loadDispatchConfig = exports.RECORDABLE_FIELDS = void 0;
+exports.readWorkerDay = exports.readJobList = exports.readDay = exports.readCounts = exports.nonZuluStarts = exports.geofenceVerdict = exports.distanceM = exports.readVisitsInWindow = exports.readVisitsForJob = exports.readVisitRecordState = exports.readVisit = exports.readSiteLocation = exports.readSiteHistory = exports.readPreviousVisits = exports.readOpenVisitsForWorker = exports.readNodeId = exports.readJobs = exports.readJob = exports.readFieldVisit = exports.readDrafts = exports.readDraft = exports.readCommitments = exports.projectVisit = exports.projectJob = exports.projectFieldVisit = exports.buildJobListQuery = exports.zonedRangeBounds = exports.zonedDayStartUtc = exports.ymdInZone = exports.minutesIntoDay = exports.daysBetween = exports.currentWeekYmd = exports.addDaysYmd = exports.MAX_RANGE_DAYS = exports.resolveAccountZone = exports.withSession = exports.parseDispatchCallback = exports.dispatchCallbackData = exports.buildVisitKeyboard = exports.CALLBACK_DATA_MAX_BYTES = exports.workerForTelegramUser = exports.terminalVisitStatuses = exports.terminalJobStatuses = exports.loadDispatchConfig = exports.RECORDABLE_FIELDS = void 0;
 /**
  * Dispatch reads, shared by the MCP tools and the office planner.
  *
@@ -19,6 +19,14 @@ Object.defineProperty(exports, "loadDispatchConfig", { enumerable: true, get: fu
 Object.defineProperty(exports, "terminalJobStatuses", { enumerable: true, get: function () { return config_js_1.terminalJobStatuses; } });
 Object.defineProperty(exports, "terminalVisitStatuses", { enumerable: true, get: function () { return config_js_1.terminalVisitStatuses; } });
 Object.defineProperty(exports, "workerForTelegramUser", { enumerable: true, get: function () { return config_js_1.workerForTelegramUser; } });
+// Task 2510 — the card's buttons and the press's wire format. Config-derived
+// and pure, so the plugin that draws a card and the route that reads a press
+// share one implementation rather than two encoders that can drift.
+var keyboard_js_1 = require("./keyboard.js");
+Object.defineProperty(exports, "CALLBACK_DATA_MAX_BYTES", { enumerable: true, get: function () { return keyboard_js_1.CALLBACK_DATA_MAX_BYTES; } });
+Object.defineProperty(exports, "buildVisitKeyboard", { enumerable: true, get: function () { return keyboard_js_1.buildVisitKeyboard; } });
+Object.defineProperty(exports, "dispatchCallbackData", { enumerable: true, get: function () { return keyboard_js_1.dispatchCallbackData; } });
+Object.defineProperty(exports, "parseDispatchCallback", { enumerable: true, get: function () { return keyboard_js_1.parseDispatchCallback; } });
 var session_js_1 = require("./session.js");
 Object.defineProperty(exports, "withSession", { enumerable: true, get: function () { return session_js_1.withSession; } });
 var zone_js_1 = require("./zone.js");
@@ -35,17 +43,29 @@ Object.defineProperty(exports, "zonedRangeBounds", { enumerable: true, get: func
 // Session-taking reads: the dispatch plugin's, moved here unchanged.
 var read_js_1 = require("./read.js");
 Object.defineProperty(exports, "buildJobListQuery", { enumerable: true, get: function () { return read_js_1.buildJobListQuery; } });
+Object.defineProperty(exports, "projectFieldVisit", { enumerable: true, get: function () { return read_js_1.projectFieldVisit; } });
 Object.defineProperty(exports, "projectJob", { enumerable: true, get: function () { return read_js_1.projectJob; } });
 Object.defineProperty(exports, "projectVisit", { enumerable: true, get: function () { return read_js_1.projectVisit; } });
 Object.defineProperty(exports, "readCommitments", { enumerable: true, get: function () { return read_js_1.readCommitments; } });
+Object.defineProperty(exports, "readDraft", { enumerable: true, get: function () { return read_js_1.readDraft; } });
+Object.defineProperty(exports, "readDrafts", { enumerable: true, get: function () { return read_js_1.readDrafts; } });
+Object.defineProperty(exports, "readFieldVisit", { enumerable: true, get: function () { return read_js_1.readFieldVisit; } });
 Object.defineProperty(exports, "readJob", { enumerable: true, get: function () { return read_js_1.readJob; } });
 Object.defineProperty(exports, "readJobs", { enumerable: true, get: function () { return read_js_1.readJobs; } });
 Object.defineProperty(exports, "readNodeId", { enumerable: true, get: function () { return read_js_1.readNodeId; } });
+Object.defineProperty(exports, "readOpenVisitsForWorker", { enumerable: true, get: function () { return read_js_1.readOpenVisitsForWorker; } });
+Object.defineProperty(exports, "readPreviousVisits", { enumerable: true, get: function () { return read_js_1.readPreviousVisits; } });
 Object.defineProperty(exports, "readSiteHistory", { enumerable: true, get: function () { return read_js_1.readSiteHistory; } });
+Object.defineProperty(exports, "readSiteLocation", { enumerable: true, get: function () { return read_js_1.readSiteLocation; } });
 Object.defineProperty(exports, "readVisit", { enumerable: true, get: function () { return read_js_1.readVisit; } });
 Object.defineProperty(exports, "readVisitRecordState", { enumerable: true, get: function () { return read_js_1.readVisitRecordState; } });
 Object.defineProperty(exports, "readVisitsForJob", { enumerable: true, get: function () { return read_js_1.readVisitsForJob; } });
 Object.defineProperty(exports, "readVisitsInWindow", { enumerable: true, get: function () { return read_js_1.readVisitsInWindow; } });
+// Task 2510 — the geofence maths. Pure, so it is asserted against real
+// coordinates rather than against a mocked graph.
+var geo_js_1 = require("./geo.js");
+Object.defineProperty(exports, "distanceM", { enumerable: true, get: function () { return geo_js_1.distanceM; } });
+Object.defineProperty(exports, "geofenceVerdict", { enumerable: true, get: function () { return geo_js_1.geofenceVerdict; } });
 // Session-owning reads: the planner's, so a route holds no graph access.
 var read_js_2 = require("./read.js");
 Object.defineProperty(exports, "nonZuluStarts", { enumerable: true, get: function () { return read_js_2.nonZuluStarts; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,yCAMqB;AALnB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,kHAAA,qBAAqB,OAAA;AAGvB,2CAA2C;AAAlC,yGAAA,WAAW,OAAA;AACpB,qCAA+C;AAAtC,6GAAA,kBAAkB,OAAA;AAC3B,yCASqB;AARnB,2GAAA,cAAc,OAAA;AACd,uGAAA,UAAU,OAAA;AACV,2GAAA,cAAc,OAAA;AACd,wGAAA,WAAW,OAAA;AACX,2GAAA,cAAc,OAAA;AACd,sGAAA,SAAS,OAAA;AACT,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAGlB,qEAAqE;AACrE,qCAamB;AAZjB,4GAAA,iBAAiB,OAAA;AACjB,qGAAA,UAAU,OAAA;AACV,uGAAA,YAAY,OAAA;AACZ,0GAAA,eAAe,OAAA;AACf,kGAAA,OAAO,OAAA;AACP,mGAAA,QAAQ,OAAA;AACR,qGAAA,UAAU,OAAA;AACV,0GAAA,eAAe,OAAA;AACf,oGAAA,SAAS,OAAA;AACT,+GAAA,oBAAoB,OAAA;AACpB,2GAAA,gBAAgB,OAAA;AAChB,6GAAA,kBAAkB,OAAA;AAGpB,yEAAyE;AACzE,qCAA2F;AAAlF,wGAAA,aAAa,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,kGAAA,OAAO,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,yCAMqB;AALnB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,kHAAA,qBAAqB,OAAA;AAIvB,6EAA6E;AAC7E,6EAA6E;AAC7E,oEAAoE;AACpE,6CAKuB;AAJrB,sHAAA,uBAAuB,OAAA;AACvB,iHAAA,kBAAkB,OAAA;AAClB,mHAAA,oBAAoB,OAAA;AACpB,oHAAA,qBAAqB,OAAA;AAIvB,2CAA2C;AAAlC,yGAAA,WAAW,OAAA;AACpB,qCAA+C;AAAtC,6GAAA,kBAAkB,OAAA;AAC3B,yCASqB;AARnB,2GAAA,cAAc,OAAA;AACd,uGAAA,UAAU,OAAA;AACV,2GAAA,cAAc,OAAA;AACd,wGAAA,WAAW,OAAA;AACX,2GAAA,cAAc,OAAA;AACd,sGAAA,SAAS,OAAA;AACT,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAGlB,qEAAqE;AACrE,qCAoBmB;AAnBjB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,qGAAA,UAAU,OAAA;AACV,uGAAA,YAAY,OAAA;AACZ,0GAAA,eAAe,OAAA;AACf,oGAAA,SAAS,OAAA;AACT,qGAAA,UAAU,OAAA;AACV,yGAAA,cAAc,OAAA;AACd,kGAAA,OAAO,OAAA;AACP,mGAAA,QAAQ,OAAA;AACR,qGAAA,UAAU,OAAA;AACV,kHAAA,uBAAuB,OAAA;AACvB,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AACf,2GAAA,gBAAgB,OAAA;AAChB,oGAAA,SAAS,OAAA;AACT,+GAAA,oBAAoB,OAAA;AACpB,2GAAA,gBAAgB,OAAA;AAChB,6GAAA,kBAAkB,OAAA;AAGpB,uEAAuE;AACvE,kDAAkD;AAClD,mCAAsD;AAA7C,mGAAA,SAAS,OAAA;AAAE,yGAAA,eAAe,OAAA;AAGnC,yEAAyE;AACzE,qCAA2F;AAAlF,wGAAA,aAAa,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,kGAAA,OAAO,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA"}

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

@@ -0,0 +1,66 @@
+/**
+ * The buttons on a dispatch card, and the wire format a press comes back on.
+ *
+ * One implementation for two processes. The dispatch MCP plugin draws the card;
+ * the UI server's webhook route reads the press and redraws it. Two encoders
+ * would be two authorities for one wire format, and the failure would be a
+ * button that does nothing with no line anywhere saying why.
+ *
+ * No status string appears below. The buttons are the account's own configured
+ * transitions out of the visit's current status, labelled with the account's own
+ * status names.
+ */
+import type { DispatchConfig } from "./types.js";
+/** Bot API: "Data to be sent in a callback query to the bot when the button is
+ *  pressed, UTF-8 1-64 bytes." Telegram refuses a longer button at send time
+ *  with nothing in our logs to explain it, so the builder measures instead. */
+export declare const CALLBACK_DATA_MAX_BYTES = 64;
+export interface DispatchButton {
+    text: string;
+    callbackData?: string;
+    webAppUrl?: string;
+}
+export interface VisitKeyboard {
+    rows: DispatchButton[][];
+    /** Transitions whose encoded data exceeded the cap. Named, never silent: a
+     *  dropped button is a worker who cannot close a job. */
+    dropped: Array<{
+        status: string;
+        bytes: number;
+    }>;
+}
+/**
+ * `d:<visitId>:<to>:<drawnFor>`.
+ *
+ * Status NAMES rather than indices into `cfg.statuses.visit`. Indices always fit
+ * the 64 bytes, but an operator reordering the status list would silently
+ * repoint every live button, and the stale check exists to catch a visit that
+ * moved on, not a config that did.
+ */
+export declare function dispatchCallbackData(p: {
+    visitId: string;
+    to: string;
+    drawnFor: string;
+}): string;
+/** Null means "not ours". A status name containing a colon would split wrongly,
+ *  so the parse requires exactly four parts rather than joining the tail. */
+export declare function parseDispatchCallback(data: string | null): {
+    visitId: string;
+    to: string;
+    drawnFor: string;
+} | null;
+/**
+ * The card's buttons for a visit at `status`.
+ *
+ * One button per legal transition out of `status`, plus one `web_app` button
+ * opening the job sheet. `web_app` and never `url`: a `url` button sends the
+ * worker to the device browser, where Telegram has signed nothing and the sheet
+ * refuses him.
+ */
+export declare function buildVisitKeyboard(p: {
+    cfg: DispatchConfig;
+    visitId: string;
+    status: string;
+    sheetUrl: string;
+}): VisitKeyboard;
+//# sourceMappingURL=keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;+EAE+E;AAC/E,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAQ1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC;IACzB;6DACyD;IACzD,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAET;AAED;6EAC6E;AAC7E,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO1D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE;IACpC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,aAAa,CAiBhB"}

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CALLBACK_DATA_MAX_BYTES = void 0;
+exports.dispatchCallbackData = dispatchCallbackData;
+exports.parseDispatchCallback = parseDispatchCallback;
+exports.buildVisitKeyboard = buildVisitKeyboard;
+/** Bot API: "Data to be sent in a callback query to the bot when the button is
+ *  pressed, UTF-8 1-64 bytes." Telegram refuses a longer button at send time
+ *  with nothing in our logs to explain it, so the builder measures instead. */
+exports.CALLBACK_DATA_MAX_BYTES = 64;
+/** The prefix that makes a press ours. A press without it belongs to some other
+ *  keyboard and falls through the route untouched. */
+const PREFIX = "d";
+const SEP = ":";
+/**
+ * `d:<visitId>:<to>:<drawnFor>`.
+ *
+ * Status NAMES rather than indices into `cfg.statuses.visit`. Indices always fit
+ * the 64 bytes, but an operator reordering the status list would silently
+ * repoint every live button, and the stale check exists to catch a visit that
+ * moved on, not a config that did.
+ */
+function dispatchCallbackData(p) {
+    return [PREFIX, p.visitId, p.to, p.drawnFor].join(SEP);
+}
+/** Null means "not ours". A status name containing a colon would split wrongly,
+ *  so the parse requires exactly four parts rather than joining the tail. */
+function parseDispatchCallback(data) {
+    if (data === null)
+        return null;
+    const parts = data.split(SEP);
+    if (parts.length !== 4 || parts[0] !== PREFIX)
+        return null;
+    const [, visitId, to, drawnFor] = parts;
+    if (!visitId || !to || !drawnFor)
+        return null;
+    return { visitId, to, drawnFor };
+}
+/**
+ * The card's buttons for a visit at `status`.
+ *
+ * One button per legal transition out of `status`, plus one `web_app` button
+ * opening the job sheet. `web_app` and never `url`: a `url` button sends the
+ * worker to the device browser, where Telegram has signed nothing and the sheet
+ * refuses him.
+ */
+function buildVisitKeyboard(p) {
+    const rows = [];
+    const dropped = [];
+    for (const [from, to] of p.cfg.statuses.visitTransitions) {
+        if (from !== p.status)
+            continue;
+        const callbackData = dispatchCallbackData({ visitId: p.visitId, to, drawnFor: p.status });
+        const bytes = Buffer.byteLength(callbackData, "utf8");
+        if (bytes > exports.CALLBACK_DATA_MAX_BYTES) {
+            dropped.push({ status: to, bytes });
+            continue;
+        }
+        rows.push([{ text: to, callbackData }]);
+    }
+    rows.push([{ text: p.cfg.vocabulary.visit, webAppUrl: p.sheetUrl }]);
+    return { rows, dropped };
+}
+//# sourceMappingURL=keyboard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":";;;AA8CA,oDAMC;AAID,sDASC;AAUD,gDAsBC;AAnFD;;+EAE+E;AAClE,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAE1C;sDACsD;AACtD,MAAM,MAAM,GAAG,GAAG,CAAC;AAEnB,MAAM,GAAG,GAAG,GAAG,CAAC;AAehB;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,CAIpC;IACC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC;AAED;6EAC6E;AAC7E,SAAgB,qBAAqB,CACnC,IAAmB;IAEnB,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;IACxC,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,CAKlC;IACC,MAAM,IAAI,GAAuB,EAAE,CAAC;IACpC,MAAM,OAAO,GAA6C,EAAE,CAAC;IAE7D,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACzD,IAAI,IAAI,KAAK,CAAC,CAAC,MAAM;YAAE,SAAS;QAChC,MAAM,YAAY,GAAG,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1F,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,KAAK,GAAG,+BAAuB,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}