@rubytech/create-maxy-code 0.1.570 → 0.1.572

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy-code",
-  "version": "0.1.570",
+  "version": "0.1.572",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy-code": "./dist/index.js"

package/payload/platform/config/brand.json

@@ -81,6 +81,7 @@
     ],
     "available": [
       "connector",
+      "dispatch",
       "telegram",
       "deep-research",
       "whatsapp",

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

@@ -0,0 +1,35 @@
+import type { DispatchConfig, LoadResult, Worker } from "./types.js";
+/**
+ * Field names `records.requiredBeforeTerminal` may demand of a visit.
+ *
+ * Task 2502 moved this here from the dispatch plugin's own config module. Two
+ * packages now need it: the plugin still validates a config against it, and
+ * `dispatch-write`'s required-field gate answers with one of these names. A
+ * copy in each would be two lists that drift, and the drift would show up as a
+ * visit that cannot be closed for a reason the config never declared.
+ */
+export declare const RECORDABLE_FIELDS: readonly ["notes", "media", "parts", "checklist", "signature"];
+export type RecordableField = (typeof RECORDABLE_FIELDS)[number];
+/**
+ * The worker a Telegram user id belongs to, or null (Task 2502).
+ *
+ * The empty-input guard is load-bearing rather than defensive. Without it an
+ * undefined lookup would compare equal to every worker who carries no
+ * `telegramUserId`, so the first unbound worker on the roster would answer for
+ * any stranger who opened the sheet.
+ */
+export declare function workerForTelegramUser(cfg: DispatchConfig, telegramUserId: string): Worker | null;
+/**
+ * Read `$ACCOUNT_DIR/dispatch/config.json`.
+ *
+ * Every outcome is a named state. A caller can tell "this account never enabled
+ * dispatch" from "this account's config is corrupt", which matters because the
+ * first is the ordinary case and the second needs an operator. Collapsing them
+ * into one falsy result is how a broken config comes to look like a quiet day.
+ */
+export declare function loadDispatchConfig(accountDir: string): LoadResult;
+/** The account's terminal job status names, for the overdue and open rules. */
+export declare function terminalJobStatuses(cfg: DispatchConfig): string[];
+/** The account's terminal visit status names. */
+export declare function terminalVisitStatuses(cfg: DispatchConfig): string[];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,gEAMpB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAGf;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CA2BjE;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAEjE;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAEnE"}

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

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECORDABLE_FIELDS = void 0;
+exports.workerForTelegramUser = workerForTelegramUser;
+exports.loadDispatchConfig = loadDispatchConfig;
+exports.terminalJobStatuses = terminalJobStatuses;
+exports.terminalVisitStatuses = terminalVisitStatuses;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Field names `records.requiredBeforeTerminal` may demand of a visit.
+ *
+ * Task 2502 moved this here from the dispatch plugin's own config module. Two
+ * packages now need it: the plugin still validates a config against it, and
+ * `dispatch-write`'s required-field gate answers with one of these names. A
+ * copy in each would be two lists that drift, and the drift would show up as a
+ * visit that cannot be closed for a reason the config never declared.
+ */
+exports.RECORDABLE_FIELDS = [
+    "notes",
+    "media",
+    "parts",
+    "checklist",
+    "signature",
+];
+/**
+ * The worker a Telegram user id belongs to, or null (Task 2502).
+ *
+ * The empty-input guard is load-bearing rather than defensive. Without it an
+ * undefined lookup would compare equal to every worker who carries no
+ * `telegramUserId`, so the first unbound worker on the roster would answer for
+ * any stranger who opened the sheet.
+ */
+function workerForTelegramUser(cfg, telegramUserId) {
+    if (!telegramUserId)
+        return null;
+    return cfg.workers.find((w) => w.telegramUserId === telegramUserId) ?? null;
+}
+/**
+ * Read `$ACCOUNT_DIR/dispatch/config.json`.
+ *
+ * Every outcome is a named state. A caller can tell "this account never enabled
+ * dispatch" from "this account's config is corrupt", which matters because the
+ * first is the ordinary case and the second needs an operator. Collapsing them
+ * into one falsy result is how a broken config comes to look like a quiet day.
+ */
+function loadDispatchConfig(accountDir) {
+    if (!accountDir || !(0, node_fs_1.existsSync)(accountDir)) {
+        return { present: false, reason: "no-account-dir" };
+    }
+    const path = (0, node_path_1.join)(accountDir, "dispatch", "config.json");
+    if (!(0, node_fs_1.existsSync)(path))
+        return { present: false, reason: "no-file" };
+    let raw;
+    try {
+        raw = (0, node_fs_1.readFileSync)(path, "utf-8");
+    }
+    catch (err) {
+        return {
+            present: false,
+            reason: "unreadable",
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    try {
+        return { present: true, value: JSON.parse(raw) };
+    }
+    catch (err) {
+        return {
+            present: false,
+            reason: "invalid",
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/** The account's terminal job status names, for the overdue and open rules. */
+function terminalJobStatuses(cfg) {
+    return cfg.statuses.job.filter((s) => s.terminal).map((s) => s.name);
+}
+/** The account's terminal visit status names. */
+function terminalVisitStatuses(cfg) {
+    return cfg.statuses.visit.filter((s) => s.terminal).map((s) => s.name);
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AA+BA,sDAMC;AAUD,gDA2BC;AAGD,kDAEC;AAGD,sDAEC;AApFD,qCAAmD;AACnD,yCAAiC;AAGjC;;;;;;;;GAQG;AACU,QAAA,iBAAiB,GAAG;IAC/B,OAAO;IACP,OAAO;IACP,OAAO;IACP,WAAW;IACX,WAAW;CACH,CAAC;AAIX;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,GAAmB,EACnB,cAAsB;IAEtB,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,cAAc,CAAC,IAAI,IAAI,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,UAAkB;IACnD,IAAI,CAAC,UAAU,IAAI,CAAC,IAAA,oBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACzD,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpE,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,EAAE,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAgB,mBAAmB,CAAC,GAAmB;IACrD,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,iDAAiD;AACjD,SAAgB,qBAAqB,CAAC,GAAmB;IACvD,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Dispatch reads, shared by the MCP tools and the office planner.
+ *
+ * One implementation of the account-scoped queries, the config contract and the
+ * timezone arithmetic. Before this package existed the UI server re-implemented
+ * the census queries against the same on-disk config, which was a second source
+ * of truth with nothing watching it.
+ *
+ * Two consumption shapes, both supported: `platform/ui` imports from `src`
+ * (tsup bundles the TypeScript), plugins import from `dist` (built by the
+ * platform `build:lib` chain, which runs before the plugin glob).
+ */
+export { RECORDABLE_FIELDS, loadDispatchConfig, terminalJobStatuses, terminalVisitStatuses, workerForTelegramUser, } from "./config.js";
+export type { RecordableField } from "./config.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 { nonZuluStarts, readCounts, readDay, readJobList, readWorkerDay } from "./read.js";
+export type { Commitment, 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

@@ -0,0 +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"}

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

@@ -0,0 +1,56 @@
+"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;
+/**
+ * Dispatch reads, shared by the MCP tools and the office planner.
+ *
+ * One implementation of the account-scoped queries, the config contract and the
+ * timezone arithmetic. Before this package existed the UI server re-implemented
+ * the census queries against the same on-disk config, which was a second source
+ * of truth with nothing watching it.
+ *
+ * Two consumption shapes, both supported: `platform/ui` imports from `src`
+ * (tsup bundles the TypeScript), plugins import from `dist` (built by the
+ * platform `build:lib` chain, which runs before the plugin glob).
+ */
+var config_js_1 = require("./config.js");
+Object.defineProperty(exports, "RECORDABLE_FIELDS", { enumerable: true, get: function () { return config_js_1.RECORDABLE_FIELDS; } });
+Object.defineProperty(exports, "loadDispatchConfig", { enumerable: true, get: function () { return config_js_1.loadDispatchConfig; } });
+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; } });
+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");
+Object.defineProperty(exports, "resolveAccountZone", { enumerable: true, get: function () { return zone_js_1.resolveAccountZone; } });
+var window_js_1 = require("./window.js");
+Object.defineProperty(exports, "MAX_RANGE_DAYS", { enumerable: true, get: function () { return window_js_1.MAX_RANGE_DAYS; } });
+Object.defineProperty(exports, "addDaysYmd", { enumerable: true, get: function () { return window_js_1.addDaysYmd; } });
+Object.defineProperty(exports, "currentWeekYmd", { enumerable: true, get: function () { return window_js_1.currentWeekYmd; } });
+Object.defineProperty(exports, "daysBetween", { enumerable: true, get: function () { return window_js_1.daysBetween; } });
+Object.defineProperty(exports, "minutesIntoDay", { enumerable: true, get: function () { return window_js_1.minutesIntoDay; } });
+Object.defineProperty(exports, "ymdInZone", { enumerable: true, get: function () { return window_js_1.ymdInZone; } });
+Object.defineProperty(exports, "zonedDayStartUtc", { enumerable: true, get: function () { return window_js_1.zonedDayStartUtc; } });
+Object.defineProperty(exports, "zonedRangeBounds", { enumerable: true, get: function () { return window_js_1.zonedRangeBounds; } });
+// 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, "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, "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, "readSiteHistory", { enumerable: true, get: function () { return read_js_1.readSiteHistory; } });
+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; } });
+// 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; } });
+Object.defineProperty(exports, "readCounts", { enumerable: true, get: function () { return read_js_2.readCounts; } });
+Object.defineProperty(exports, "readDay", { enumerable: true, get: function () { return read_js_2.readDay; } });
+Object.defineProperty(exports, "readJobList", { enumerable: true, get: function () { return read_js_2.readJobList; } });
+Object.defineProperty(exports, "readWorkerDay", { enumerable: true, get: function () { return read_js_2.readWorkerDay; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,107 @@
+/**
+ * Cypher reads. One module, so no caller writes its own query and no query
+ * forgets the `accountId` scope.
+ *
+ * Every query here is account-scoped by property, never by edge. Account scope
+ * is a property in this ontology; an ownership edge added to satisfy an
+ * adjacency rule is a second source of truth that drifts.
+ *
+ * The session-taking functions are the dispatch plugin's, moved here unchanged
+ * so the plugin and the office planner share one implementation. The functions
+ * that own their session (`readDay`, `readJobList`, `readCounts`) are the
+ * planner's, and exist so a route can read the graph while holding none of it.
+ */
+import type { Session } from "neo4j-driver";
+import type { DispatchCounts, FieldVisit, JobListFilter, JobRow, PlannerVisit, VisitRow } from "./types.js";
+/** Visits a worker is already committed to inside a window. */
+export interface Commitment {
+    readonly visitId: string;
+    readonly start: string;
+    readonly end: string;
+}
+/** What a visit currently carries, for the required-before-terminal gate. */
+export interface VisitRecordState {
+    readonly notes: number;
+    readonly media: number;
+    readonly parts: number;
+    readonly checklistDone: number;
+    readonly checklistTotal: number;
+    readonly signatures: number;
+}
+/** Shared job projection, so every job query returns one shape. */
+export declare function projectJob(g: {
+    get(key: string): unknown;
+}): JobRow;
+/** Shared visit projection, so the day read and its tests cannot drift apart. */
+export declare function projectVisit(g: {
+    get(key: string): unknown;
+}): PlannerVisit;
+export declare function readJob(session: Session, accountId: string, jobId: string): Promise<JobRow | null>;
+export declare function readVisit(session: Session, accountId: string, visitId: string): Promise<VisitRow | null>;
+export declare function readVisitRecordState(session: Session, accountId: string, visitId: string): Promise<VisitRecordState>;
+export declare function readVisitsForJob(session: Session, accountId: string, jobId: string): Promise<VisitRow[]>;
+/** Visits a worker is already committed to inside `[from, to)`. */
+export declare function readCommitments(session: Session, accountId: string, from: string, to: string): Promise<Map<string, Commitment[]>>;
+/**
+ * The job-list query as text plus params, extracted so its shape is testable
+ * without a database.
+ */
+export declare function buildJobListQuery(filter: JobListFilter): {
+    text: string;
+    params: Record<string, unknown>;
+};
+export declare function readJobs(session: Session, accountId: string, filter: JobListFilter): Promise<JobRow[]>;
+/** Element id of an existing node on this account, or null. */
+export declare function readNodeId(session: Session, accountId: string, label: "Site" | "Customer" | "Engineer" | "Vehicle", keyProp: string, keyValue: string): Promise<string | null>;
+/** Every visit at one site, newest first, with its job. */
+export declare function readSiteHistory(session: Session, accountId: string, siteId: string, limit: number): Promise<Array<VisitRow & {
+    jobStatus: string;
+    notes: string[];
+    mediaCount: number;
+}>>;
+/** Every visit starting inside `[from, to)`. */
+export declare function readVisitsInWindow(session: Session, accountId: string, from: string, to: string): Promise<Array<VisitRow & {
+    siteName: string | null;
+}>>;
+/**
+ * Visit ids whose `startDate` is not Zulu-normalised.
+ *
+ * The window compare above is lexical, so an offset-bearing start is wrong by
+ * the offset: correct under GMT, an hour out under BST. `dispatch-allocate`
+ * stores the caller's `start` string verbatim while normalising `end` through
+ * `toISOString`, so this cannot be corrected on read. It can only be made
+ * visible, which is what this is for.
+ */
+export declare function nonZuluStarts(visits: readonly PlannerVisit[]): string[];
+/**
+ * Every visit starting inside `[fromUtc, toUtc)`, carrying the fields a planner
+ * card needs. The shipped window read returns `siteName` only, so a card had no
+ * customer and no job type to show.
+ */
+export declare function readDay(accountId: string, fromUtc: string, toUtc: string): Promise<PlannerVisit[]>;
+/**
+ * One worker's visits in a window, with the contact detail a doorstep needs.
+ *
+ * A separate function rather than a widening of `readDay`, because the planner
+ * draws a week of cards for the whole roster and needs a customer's telephone
+ * on none of them.
+ *
+ * **No address and no postcode.** `schema-dispatch.md` declares neither on
+ * `:Site`, and the only `PostalAddress` edge in the whole ontology is
+ * logistics' `(:Stop)-[:AT_ADDRESS]->(:PostalAddress)`. Returning them as
+ * always-null columns would read to a worker as "this site has no address"
+ * rather than "we do not store one". Task 2514 adds the edge.
+ */
+export declare function readWorkerDay(accountId: string, workerId: string, fromUtc: string, toUtc: string): Promise<FieldVisit[]>;
+/** The job list, owning its own session. */
+export declare function readJobList(accountId: string, filter: JobListFilter): Promise<JobRow[]>;
+/**
+ * True counts, as aggregates.
+ *
+ * `readJobList` caps at 500 rows, so the length of its result is not the number
+ * of open jobs on an account with 2,869 of them. `overdue` is computed here
+ * rather than stored, because a stored flag goes stale the moment the clock
+ * passes the target with nothing writing to the row.
+ */
+export declare function readCounts(accountId: string, terminalJobStatuses: readonly string[], nowIso: string): Promise<DispatchCounts>;
+//# sourceMappingURL=read.d.ts.map

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

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