@rubytech/create-maxy-code 0.1.565 → 0.1.567

package/payload/platform/plugins/inventory/mcp/dist/lib/replenish.js

@@ -0,0 +1,107 @@
+/**
+ * Task 2448 — the replenishment arithmetic.
+ *
+ * Pure functions over plain numbers, deliberately free of any graph or driver
+ * import, so the whole of the decision maths is testable without a database.
+ */
+/** Population standard deviation. Returns 0 for zero or one value, where
+ *  spread is undefined, rather than NaN: NaN would propagate silently into a
+ *  reorder point and surface as a nonsense order quantity. */
+export function standardDeviation(values) {
+    if (values.length < 2)
+        return 0;
+    const mean = values.reduce((sum, n) => sum + n, 0) / values.length;
+    const variance = values.reduce((sum, n) => sum + (n - mean) ** 2, 0) / values.length;
+    return Math.sqrt(variance);
+}
+/**
+ * How many standard deviations of buffer a given service level needs.
+ *
+ * A lookup table with linear interpolation rather than an inverse normal
+ * function: the table is exact at the levels operators actually pick, it is
+ * readable by anyone auditing a recommendation, and it needs no special
+ * function implementation. Levels between table points interpolate; the
+ * function refuses outside the open interval rather than clamping, because a
+ * clamp would silently answer a question the operator did not ask.
+ */
+const Z_TABLE = [
+    [0.5, 0],
+    [0.8, 0.8416],
+    [0.9, 1.2816],
+    [0.95, 1.6449],
+    [0.975, 1.96],
+    [0.99, 2.3263],
+    [0.999, 3.0902],
+];
+export function serviceLevelZ(serviceLevel) {
+    if (!(serviceLevel > 0 && serviceLevel < 1)) {
+        throw new Error(`[inventory] serviceLevelZ: service level must be strictly between 0 and 1, got ${serviceLevel}`);
+    }
+    if (serviceLevel <= Z_TABLE[0][0])
+        return Z_TABLE[0][1];
+    const last = Z_TABLE[Z_TABLE.length - 1];
+    if (serviceLevel >= last[0])
+        return last[1];
+    for (let i = 1; i < Z_TABLE.length; i += 1) {
+        const [hiLevel, hiZ] = Z_TABLE[i];
+        if (serviceLevel <= hiLevel) {
+            const [loLevel, loZ] = Z_TABLE[i - 1];
+            const t = (serviceLevel - loLevel) / (hiLevel - loLevel);
+            return loZ + t * (hiZ - loZ);
+        }
+    }
+    return last[1];
+}
+/**
+ * The stock level at which to reorder.
+ *
+ * Expected demand across the whole exposure window (the lead time plus the
+ * review period, because an order placed just after a review waits a full
+ * cycle before the next chance), plus a buffer scaled by how much demand
+ * actually varies over that same window.
+ */
+export function reorderPoint(input) {
+    const { perPeriod, stdDevPerPeriod, periodDays, leadTimeDays, reviewPeriodDays, serviceLevel, } = input;
+    if (!(periodDays > 0)) {
+        throw new Error(`[inventory] reorderPoint: periodDays must be positive, got ${periodDays}`);
+    }
+    const exposureDays = leadTimeDays + reviewPeriodDays;
+    const exposurePeriods = exposureDays / periodDays;
+    const expected = perPeriod * exposurePeriods;
+    const buffer = serviceLevelZ(serviceLevel) * stdDevPerPeriod * Math.sqrt(exposurePeriods);
+    return expected + buffer;
+}
+/**
+ * How much to order.
+ *
+ * Order sequence matters and is the usual source of bugs: raise to the
+ * supplier's minimum FIRST, then round up to their pack multiple. Doing it the
+ * other way round can round a raised quantity back below the minimum when the
+ * minimum is not itself a multiple of the pack size.
+ */
+export function orderQuantity(input) {
+    const { target, available, minimumOrderQuantity, orderMultiple } = input;
+    if (!(orderMultiple > 0)) {
+        throw new Error(`[inventory] orderQuantity: order multiple must be positive, got ${orderMultiple}`);
+    }
+    const gap = target - available;
+    if (gap <= 0)
+        return 0;
+    const raised = Math.max(gap, minimumOrderQuantity);
+    return Math.ceil(raised / orderMultiple) * orderMultiple;
+}
+/**
+ * How many days the stock on hand lasts at the expected rate.
+ *
+ * Null when nothing is expected to sell: cover is undefined then, and
+ * returning a large number would rank a dead product alongside a healthy one.
+ */
+export function daysOfCover(quantityOnHand, perPeriod, periodDays) {
+    if (!(periodDays > 0)) {
+        throw new Error(`[inventory] daysOfCover: periodDays must be positive, got ${periodDays}`);
+    }
+    if (perPeriod <= 0)
+        return null;
+    return quantityOnHand / (perPeriod / periodDays);
+}
+//# sourceMappingURL=replenish.js.map

package/payload/platform/plugins/inventory/mcp/dist/lib/replenish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replenish.js","sourceRoot":"","sources":["../../src/lib/replenish.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;8DAE8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,MAAgB;IAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACrF,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,GAAsC;IACjD,CAAC,GAAG,EAAE,CAAC,CAAC;IACR,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,KAAK,EAAE,IAAI,CAAC;IACb,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,KAAK,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,YAAoB;IAChD,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,kFAAkF,YAAY,EAAE,CACjG,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAC1C,IAAI,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACnC,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC;YACzD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EACJ,SAAS,EACT,eAAe,EACf,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,GAAG,KAAK,CAAC;IAEV,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,8DAA8D,UAAU,EAAE,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACrD,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,CAAC;IAElD,MAAM,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;IAC7C,MAAM,MAAM,GACV,aAAa,CAAC,YAAY,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE7E,OAAO,QAAQ,GAAG,MAAM,CAAC;AAC3B,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAEzE,IAAI,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,mEAAmE,aAAa,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,aAAa,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,cAAsB,EACtB,SAAiB,EACjB,UAAkB;IAElB,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,6DAA6D,UAAU,EAAE,CAC1E,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,cAAc,GAAG,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC;AACnD,CAAC"}

package/payload/platform/plugins/inventory/mcp/dist/lib/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Task 2448 — shared shapes for the inventory tools.
+ *
+ * `write` and the `resolve*` reads are injected rather than imported by the
+ * tool modules so unit tests exercise the decision logic without loading the
+ * Neo4j driver. `index.ts` passes the real implementations.
+ */
+import type { Session } from "neo4j-driver";
+/**
+ * The real graph-write contracts, imported rather than redeclared. A
+ * redeclared GraphRelationship carrying `targetLabel` instead of
+ * `targetNodeId` shipped a dead write path in the ledger plugin: every create
+ * was rejected at runtime with `reason=unresolved-target requested=1 found=0`.
+ * Importing the real types makes that a compile error. Never redeclare them.
+ */
+import type { CreatedBy, GraphRelationship } from "../../../../../lib/graph-write/dist/index.js";
+export type { CreatedBy, GraphRelationship };
+export interface WriteParams {
+    session: Session;
+    labels: string[];
+    props: Record<string, unknown>;
+    relationships: GraphRelationship[];
+    createdBy: CreatedBy;
+}
+export interface WriteResult {
+    nodesCreated?: number;
+    edgesCreated?: number;
+}
+export type WriteFn = (params: WriteParams) => Promise<WriteResult>;
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function ok(text: string): ToolResult;
+export declare function fail(text: string): ToolResult;
+/** One stock line as the agent parsed it out of an upload. */
+export interface StockRow {
+    /** Product SKU. Resolved to a :Product element id by the tool. */
+    sku: string;
+    /** Element id of an existing :StoreLocation. */
+    location: string;
+    quantityOnHand: number;
+    quantityOnOrder: number;
+    /** ISO timestamp the count was taken. */
+    asOf: string;
+}
+/** One period of observed demand for one product at one location. */
+export interface DemandRow {
+    sku: string;
+    location: string;
+    periodStart: string;
+    periodEnd: string;
+    quantitySold: number;
+}
+/** Everything the plan needs about one product at one location, read in a
+ *  single query. Any of the optional fields being absent is what produces a
+ *  skipped line rather than a guessed one. */
+export interface PlanCandidate {
+    sku: string;
+    productNodeId: string;
+    location: string;
+    quantityOnHand: number;
+    quantityOnOrder: number;
+    /** ISO timestamp of the stock count. */
+    asOf: string;
+    /** Units sold per period, oldest first. Empty when no history exists. */
+    history: number[];
+    serviceLevel: number | null;
+    reviewPeriodDays: number | null;
+    leadTimeDays: number | null;
+    minimumOrderQuantity: number | null;
+    orderMultiple: number | null;
+    supplierNodeId: string | null;
+}
+export interface PlanLine {
+    sku: string;
+    location: string;
+    daysOfCover: number | null;
+    reorderPoint: number;
+    recommendedQuantity: number;
+    supplierNodeId: string;
+    /** ISO date the order would arrive if placed today. */
+    expectedArrival: string;
+}
+export type PlanMissing = "leadTime" | "serviceLevel" | "history";
+export interface PlanSkip {
+    sku: string;
+    location: string;
+    missing: PlanMissing;
+}
+/** Resolves a SKU to a :Product element id on this account, or null. */
+export type ResolveProductFn = (session: Session, accountId: string, sku: string) => Promise<string | null>;
+/** Confirms a :StoreLocation element id exists on this account. */
+export type ResolveLocationFn = (session: Session, accountId: string, nodeId: string) => Promise<boolean>;
+//# sourceMappingURL=types.d.ts.map

package/payload/platform/plugins/inventory/mcp/dist/lib/types.d.ts.map

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

package/payload/platform/plugins/inventory/mcp/dist/lib/types.js

@@ -0,0 +1,7 @@
+export function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function fail(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+//# sourceMappingURL=types.js.map

package/payload/platform/plugins/inventory/mcp/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AA0CA,MAAM,UAAU,EAAE,CAAC,IAAY;IAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC"}

package/payload/platform/plugins/inventory/mcp/dist/lib/write-rejects.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Counts `[graph-write] reject` lines across the inventory MCP tee logs
+ * modified within the trailing 24 hours.
+ *
+ * Uses file mtime rather than parsing per-line timestamps: the tee log carries
+ * no timestamp of its own, and a file untouched for a day cannot hold a reject
+ * from the last one. Best-effort; an unreadable log directory yields 0 rather
+ * than throwing, because a census that dies on a missing directory tells the
+ * operator nothing at all.
+ */
+export declare function countWriteRejects24h(logDir: string, now: number): number;
+//# sourceMappingURL=write-rejects.d.ts.map

package/payload/platform/plugins/inventory/mcp/dist/lib/write-rejects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-rejects.d.ts","sourceRoot":"","sources":["../../src/lib/write-rejects.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAuBxE"}

package/payload/platform/plugins/inventory/mcp/dist/lib/write-rejects.js

@@ -0,0 +1,49 @@
+/**
+ * Task 2448 — count recent write rejections from the inventory MCP logs.
+ *
+ * A rejected write cannot record its own failure in the graph, because the
+ * whole point is that nothing was written. The only durable trace is the
+ * stderr line graph-write emits, which mcp-spawn-tee captures per session.
+ * Counting those lines is what lets an operator distinguish a healthy empty
+ * inventory from one whose write path is dead. The ledger plugin printed
+ * those two states identically for a full day on 2026-07-18.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+const DAY_MS = 86_400_000;
+/**
+ * Counts `[graph-write] reject` lines across the inventory MCP tee logs
+ * modified within the trailing 24 hours.
+ *
+ * Uses file mtime rather than parsing per-line timestamps: the tee log carries
+ * no timestamp of its own, and a file untouched for a day cannot hold a reject
+ * from the last one. Best-effort; an unreadable log directory yields 0 rather
+ * than throwing, because a census that dies on a missing directory tells the
+ * operator nothing at all.
+ */
+export function countWriteRejects24h(logDir, now) {
+    let entries;
+    try {
+        entries = readdirSync(logDir).filter((f) => f.startsWith("mcp-inventory-") && f.endsWith(".log"));
+    }
+    catch {
+        return 0;
+    }
+    let total = 0;
+    for (const name of entries) {
+        const path = join(logDir, name);
+        try {
+            if (now - statSync(path).mtimeMs > DAY_MS)
+                continue;
+            for (const line of readFileSync(path, "utf-8").split("\n")) {
+                if (line.includes("[graph-write] reject"))
+                    total += 1;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=write-rejects.js.map

package/payload/platform/plugins/inventory/mcp/dist/lib/write-rejects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-rejects.js","sourceRoot":"","sources":["../../src/lib/write-rejects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,GAAW;IAC9D,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC5D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,MAAM;gBAAE,SAAS;YACpD,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC;oBAAE,KAAK,IAAI,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/payload/platform/plugins/inventory/mcp/dist/tools/demand-record.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Task 2448 — append observed demand for one product at one location.
+ *
+ * A zero-sales period is accepted deliberately: it is the difference between
+ * "sold nothing" and "no data", and collapsing the two would make the forecast
+ * read a quiet week as an absent one.
+ */
+import type { Session } from "neo4j-driver";
+import { type CreatedBy, type DemandRow, type ResolveLocationFn, type ResolveProductFn, type ToolResult, type WriteFn } from "../lib/types.js";
+export interface DemandRecordParams {
+    session: Session;
+    write: WriteFn;
+    resolveProduct: ResolveProductFn;
+    resolveLocation: ResolveLocationFn;
+    accountId: string;
+    createdBy: CreatedBy;
+    rows: DemandRow[];
+}
+export declare function demandRecord(params: DemandRecordParams): Promise<ToolResult>;
+//# sourceMappingURL=demand-record.d.ts.map

package/payload/platform/plugins/inventory/mcp/dist/tools/demand-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demand-record.d.ts","sourceRoot":"","sources":["../../src/tools/demand-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EAEd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,OAAO,EAGb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,gBAAgB,CAAC;IACjC,eAAe,EAAE,iBAAiB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoElF"}

package/payload/platform/plugins/inventory/mcp/dist/tools/demand-record.js

@@ -0,0 +1,53 @@
+import { fail, ok, } from "../lib/types.js";
+export async function demandRecord(params) {
+    const { session, write, resolveProduct, resolveLocation, accountId, createdBy, rows } = params;
+    if (rows.length === 0) {
+        return fail(`[inventory] op=reject reason=empty-batch accountId=${accountId} — no demand rows supplied. Nothing was written.`);
+    }
+    let accepted = 0;
+    const rejected = [];
+    for (const row of rows) {
+        const sku = row.sku.trim();
+        const location = row.location.trim();
+        if (!(Date.parse(row.periodEnd) > Date.parse(row.periodStart))) {
+            rejected.push(`${sku} (period ${row.periodStart}..${row.periodEnd} does not advance)`);
+            continue;
+        }
+        if (!(row.quantitySold >= 0)) {
+            rejected.push(`${sku} (negative quantity ${row.quantitySold})`);
+            continue;
+        }
+        const productNodeId = await resolveProduct(session, accountId, sku);
+        if (productNodeId === null) {
+            rejected.push(`${sku} (unknown sku)`);
+            continue;
+        }
+        if (!(await resolveLocation(session, accountId, location))) {
+            rejected.push(`${sku} (unknown location ${location})`);
+            continue;
+        }
+        const relationships = [
+            { type: "OF_PRODUCT", direction: "outgoing", targetNodeId: productNodeId },
+            { type: "AT_LOCATION", direction: "outgoing", targetNodeId: location },
+        ];
+        await write({
+            session,
+            labels: ["DemandObservation"],
+            props: {
+                accountId,
+                product: productNodeId,
+                location,
+                periodStart: row.periodStart,
+                periodEnd: row.periodEnd,
+                quantitySold: row.quantitySold,
+            },
+            relationships,
+            createdBy,
+        });
+        accepted += 1;
+    }
+    console.error(`[inventory] op=demand-record accountId=${accountId} rows=${rows.length} accepted=${accepted} rejected=${rejected.length}`);
+    const tail = rejected.length === 0 ? "" : ` Rejected: ${rejected.join("; ")}.`;
+    return ok(`op=demand-record rows=${rows.length} accepted=${accepted} rejected=${rejected.length}.${tail}`);
+}
+//# sourceMappingURL=demand-record.js.map

package/payload/platform/plugins/inventory/mcp/dist/tools/demand-record.js.map

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

package/payload/platform/plugins/inventory/mcp/dist/tools/forecast.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Task 2448 — expected demand per period for one product at one location.
+ *
+ * Nothing is stored. The number is derived from :DemandObservation on every
+ * call, which is why replacing the method in Task 2449 needs no migration.
+ * An empty history is an error, not a forecast of zero: those two mean
+ * opposite things to an operator deciding whether to order.
+ */
+import type { Session } from "neo4j-driver";
+import { type ResolveProductFn, type ToolResult } from "../lib/types.js";
+export type ReadHistoryFn = (session: Session, accountId: string, productNodeId: string, location: string) => Promise<number[]>;
+export interface ForecastParams {
+    session: Session;
+    resolveProduct: ResolveProductFn;
+    readHistory: ReadHistoryFn;
+    accountId: string;
+    sku: string;
+    location: string;
+    window: number;
+}
+export declare const FORECAST_METHOD = "moving-average";
+export declare function forecast(params: ForecastParams): Promise<ToolResult>;
+//# sourceMappingURL=forecast.d.ts.map

package/payload/platform/plugins/inventory/mcp/dist/tools/forecast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.d.ts","sourceRoot":"","sources":["../../src/tools/forecast.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAY,MAAM,iBAAiB,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,gBAAgB,CAAC;IACjC,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA2B1E"}

package/payload/platform/plugins/inventory/mcp/dist/tools/forecast.js

@@ -0,0 +1,18 @@
+import { movingAverage } from "../lib/forecast.js";
+import { fail, ok } from "../lib/types.js";
+export const FORECAST_METHOD = "moving-average";
+export async function forecast(params) {
+    const { session, resolveProduct, readHistory, accountId, sku, location, window } = params;
+    const productNodeId = await resolveProduct(session, accountId, sku.trim());
+    if (productNodeId === null) {
+        return fail(`[inventory] op=reject reason=unknown-sku sku=${sku.trim()} — no product with that SKU on this account, or more than one.`);
+    }
+    const history = await readHistory(session, accountId, productNodeId, location.trim());
+    if (history.length === 0) {
+        return fail(`[inventory] op=reject reason=no-history sku=${sku.trim()} location=${location.trim()} — record demand with inventory-demand-record first. No history is not the same as no demand, so no figure is returned.`);
+    }
+    const perPeriod = movingAverage(history, window);
+    console.error(`[inventory] op=forecast accountId=${accountId} method=${FORECAST_METHOD} window=${window} periods=${history.length} sku=${sku.trim()} location=${location.trim()} perPeriod=${perPeriod}`);
+    return ok(`op=forecast method=${FORECAST_METHOD} window=${window} periods=${history.length} perPeriod=${perPeriod}. Expected demand for ${sku.trim()} is ${perPeriod} units per period, averaged over the trailing ${Math.min(window, history.length)} of ${history.length} recorded periods.`);
+}
+//# sourceMappingURL=forecast.js.map

package/payload/platform/plugins/inventory/mcp/dist/tools/forecast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.js","sourceRoot":"","sources":["../../src/tools/forecast.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAA0C,IAAI,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAmBnF,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAsB;IACnD,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAC9E,MAAM,CAAC;IAET,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,IAAI,CACT,gDAAgD,GAAG,CAAC,IAAI,EAAE,gEAAgE,CAC3H,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CACT,+CAA+C,GAAG,CAAC,IAAI,EAAE,aAAa,QAAQ,CAAC,IAAI,EAAE,yHAAyH,CAC/M,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEjD,OAAO,CAAC,KAAK,CACX,qCAAqC,SAAS,WAAW,eAAe,WAAW,MAAM,YAAY,OAAO,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,aAAa,QAAQ,CAAC,IAAI,EAAE,cAAc,SAAS,EAAE,CAC3L,CAAC;IAEF,OAAO,EAAE,CACP,sBAAsB,eAAe,WAAW,MAAM,YAAY,OAAO,CAAC,MAAM,cAAc,SAAS,yBAAyB,GAAG,CAAC,IAAI,EAAE,OAAO,SAAS,iDAAiD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,OAAO,CAAC,MAAM,oBAAoB,CACrR,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/inventory/mcp/dist/tools/policy-set.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Task 2448 — set the replenishment policy for one product at one location.
+ *
+ * A service level of exactly 1 is refused rather than clamped: perfect
+ * availability needs infinite safety stock, and silently substituting 0.99
+ * would hand the operator a number they did not choose.
+ */
+import type { Session } from "neo4j-driver";
+import { type CreatedBy, type ResolveLocationFn, type ResolveProductFn, type ToolResult, type WriteFn } from "../lib/types.js";
+export interface PolicySetParams {
+    session: Session;
+    write: WriteFn;
+    resolveProduct: ResolveProductFn;
+    resolveLocation: ResolveLocationFn;
+    accountId: string;
+    createdBy: CreatedBy;
+    sku: string;
+    location: string;
+    /** Target in-stock probability, strictly between 0 and 1. */
+    serviceLevel: number;
+    /** How often the operator actually reviews and reorders, in days. */
+    reviewPeriodDays: number;
+}
+export declare function policySet(params: PolicySetParams): Promise<ToolResult>;
+//# sourceMappingURL=policy-set.d.ts.map

package/payload/platform/plugins/inventory/mcp/dist/tools/policy-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-set.d.ts","sourceRoot":"","sources":["../../src/tools/policy-set.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,OAAO,EAGb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,gBAAgB,CAAC;IACjC,eAAe,EAAE,iBAAiB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA+D5E"}

package/payload/platform/plugins/inventory/mcp/dist/tools/policy-set.js

@@ -0,0 +1,37 @@
+import { fail, ok, } from "../lib/types.js";
+export async function policySet(params) {
+    const { session, write, resolveProduct, resolveLocation, accountId, createdBy, sku, location, serviceLevel, reviewPeriodDays, } = params;
+    if (!(serviceLevel > 0 && serviceLevel < 1)) {
+        return fail(`[inventory] op=reject reason=service-level-out-of-range value=${serviceLevel} — must be strictly between 0 and 1. A service level of 1 needs infinite safety stock. Nothing was written.`);
+    }
+    if (!(reviewPeriodDays > 0)) {
+        return fail(`[inventory] op=reject reason=non-positive-review-period value=${reviewPeriodDays} — how many days between reorder reviews. Nothing was written.`);
+    }
+    const productNodeId = await resolveProduct(session, accountId, sku.trim());
+    if (productNodeId === null) {
+        return fail(`[inventory] op=reject reason=unknown-sku sku=${sku.trim()} — no product with that SKU on this account, or more than one. Nothing was written.`);
+    }
+    if (!(await resolveLocation(session, accountId, location.trim()))) {
+        return fail(`[inventory] op=reject reason=unknown-location location=${location.trim()} — no store location with that element id on this account. Nothing was written.`);
+    }
+    const relationships = [
+        { type: "OF_PRODUCT", direction: "outgoing", targetNodeId: productNodeId },
+        { type: "AT_LOCATION", direction: "outgoing", targetNodeId: location.trim() },
+    ];
+    const result = await write({
+        session,
+        labels: ["ReplenishmentPolicy"],
+        props: {
+            accountId,
+            product: productNodeId,
+            location: location.trim(),
+            serviceLevel,
+            reviewPeriodDays,
+        },
+        relationships,
+        createdBy,
+    });
+    console.error(`[inventory] op=policy-set accountId=${accountId} sku=${sku.trim()} location=${location.trim()} serviceLevel=${serviceLevel} reviewPeriodDays=${reviewPeriodDays} nodesCreated=${result.nodesCreated ?? 0}`);
+    return ok(`Policy set for ${sku.trim()} at that location: ${(serviceLevel * 100).toFixed(1)}% service level, reviewed every ${reviewPeriodDays} days.`);
+}
+//# sourceMappingURL=policy-set.js.map

package/payload/platform/plugins/inventory/mcp/dist/tools/policy-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-set.js","sourceRoot":"","sources":["../../src/tools/policy-set.ts"],"names":[],"mappings":"AAQA,OAAO,EAOL,IAAI,EACJ,EAAE,GACH,MAAM,iBAAiB,CAAC;AAiBzB,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAuB;IACrD,MAAM,EACJ,OAAO,EACP,KAAK,EACL,cAAc,EACd,eAAe,EACf,SAAS,EACT,SAAS,EACT,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,gBAAgB,GACjB,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CACT,iEAAiE,YAAY,6GAA6G,CAC3L,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CACT,iEAAiE,gBAAgB,gEAAgE,CAClJ,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,IAAI,CACT,gDAAgD,GAAG,CAAC,IAAI,EAAE,qFAAqF,CAChJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,CACT,0DAA0D,QAAQ,CAAC,IAAI,EAAE,iFAAiF,CAC3J,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAwB;QACzC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE;QAC1E,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE;KAC9E,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,OAAO;QACP,MAAM,EAAE,CAAC,qBAAqB,CAAC;QAC/B,KAAK,EAAE;YACL,SAAS;YACT,OAAO,EAAE,aAAa;YACtB,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE;YACzB,YAAY;YACZ,gBAAgB;SACjB;QACD,aAAa;QACb,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,CACX,uCAAuC,SAAS,QAAQ,GAAG,CAAC,IAAI,EAAE,aAAa,QAAQ,CAAC,IAAI,EAAE,iBAAiB,YAAY,qBAAqB,gBAAgB,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,CAC5M,CAAC;IAEF,OAAO,EAAE,CACP,kBAAkB,GAAG,CAAC,IAAI,EAAE,sBAAsB,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC,gBAAgB,QAAQ,CAC7I,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/inventory/mcp/dist/tools/purchase-order-record.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Task 2448 — record a purchase order the operator confirmed.
+ *
+ * This records; it does not send. Sending is Task 2450 and is a different
+ * risk class. The reply says so explicitly, because an operator who believes
+ * the order went out will not send it themselves.
+ */
+import type { Session } from "neo4j-driver";
+import { type CreatedBy, type ToolResult, type WriteFn } from "../lib/types.js";
+export interface PurchaseOrderLine {
+    sku: string;
+    quantity: number;
+}
+export interface PurchaseOrderRecordParams {
+    session: Session;
+    write: WriteFn;
+    accountId: string;
+    createdBy: CreatedBy;
+    supplierNodeId: string;
+    orderDate: string;
+    expectedDelivery: string;
+    lines: PurchaseOrderLine[];
+}
+export declare function purchaseOrderRecord(params: PurchaseOrderRecordParams): Promise<ToolResult>;
+//# sourceMappingURL=purchase-order-record.d.ts.map

package/payload/platform/plugins/inventory/mcp/dist/tools/purchase-order-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchase-order-record.d.ts","sourceRoot":"","sources":["../../src/tools/purchase-order-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,KAAK,OAAO,EAGb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAmErB"}

package/payload/platform/plugins/inventory/mcp/dist/tools/purchase-order-record.js

@@ -0,0 +1,43 @@
+import { fail, ok, } from "../lib/types.js";
+export async function purchaseOrderRecord(params) {
+    const { session, write, accountId, createdBy, supplierNodeId, orderDate, expectedDelivery, lines, } = params;
+    if (lines.length === 0) {
+        return fail(`[inventory] op=reject reason=empty-order accountId=${accountId} — an order with no lines is not an order. Nothing was written.`);
+    }
+    for (const line of lines) {
+        if (!(line.quantity > 0)) {
+            return fail(`[inventory] op=reject reason=non-positive-quantity sku=${line.sku} quantity=${line.quantity} — nothing was written.`);
+        }
+    }
+    if (!(Date.parse(expectedDelivery) >= Date.parse(orderDate))) {
+        return fail(`[inventory] op=reject reason=delivery-before-order orderDate=${orderDate} expectedDelivery=${expectedDelivery} — nothing was written.`);
+    }
+    if (supplierNodeId.trim() === "") {
+        return fail(`[inventory] op=reject reason=missing-supplier — pass the element id of the supplier organisation. Nothing was written.`);
+    }
+    // schema-retail.md requires lineItems on :PurchaseOrder. Neo4j has no map
+    // property type, so the lines are serialised to a JSON string rather than
+    // split across parallel arrays that could drift out of step.
+    const lineItems = JSON.stringify(lines);
+    const relationships = [
+        { type: "FROM_SUPPLIER", direction: "outgoing", targetNodeId: supplierNodeId.trim() },
+    ];
+    const result = await write({
+        session,
+        labels: ["PurchaseOrder"],
+        props: {
+            accountId,
+            supplier: supplierNodeId.trim(),
+            lineItems,
+            orderDate,
+            expectedDelivery,
+            orderStatus: "open",
+        },
+        relationships,
+        createdBy,
+    });
+    const units = lines.reduce((sum, l) => sum + l.quantity, 0);
+    console.error(`[inventory] op=purchase-order-record accountId=${accountId} supplier=${supplierNodeId.trim()} lines=${lines.length} units=${units} nodesCreated=${result.nodesCreated ?? 0} edgesCreated=${result.edgesCreated ?? 0}`);
+    return ok(`Recorded a purchase order for ${lines.length} line${lines.length === 1 ? "" : "s"}, ${units} units, expected ${expectedDelivery}. It has not been sent to the supplier: this records the order only.`);
+}
+//# sourceMappingURL=purchase-order-record.js.map

package/payload/platform/plugins/inventory/mcp/dist/tools/purchase-order-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchase-order-record.js","sourceRoot":"","sources":["../../src/tools/purchase-order-record.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,IAAI,EACJ,EAAE,GACH,MAAM,iBAAiB,CAAC;AAkBzB,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiC;IAEjC,MAAM,EACJ,OAAO,EACP,KAAK,EACL,SAAS,EACT,SAAS,EACT,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,KAAK,GACN,GAAG,MAAM,CAAC;IAEX,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CACT,sDAAsD,SAAS,iEAAiE,CACjI,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CACT,0DAA0D,IAAI,CAAC,GAAG,aAAa,IAAI,CAAC,QAAQ,yBAAyB,CACtH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CACT,gEAAgE,SAAS,qBAAqB,gBAAgB,yBAAyB,CACxI,CAAC;IACJ,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjC,OAAO,IAAI,CACT,wHAAwH,CACzH,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAExC,MAAM,aAAa,GAAwB;QACzC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,CAAC,IAAI,EAAE,EAAE;KACtF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,OAAO;QACP,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,KAAK,EAAE;YACL,SAAS;YACT,QAAQ,EAAE,cAAc,CAAC,IAAI,EAAE;YAC/B,SAAS;YACT,SAAS;YACT,gBAAgB;YAChB,WAAW,EAAE,MAAM;SACpB;QACD,aAAa;QACb,SAAS;KACV,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,KAAK,CACX,kDAAkD,SAAS,aAAa,cAAc,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,MAAM,UAAU,KAAK,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,CACvN,CAAC;IAEF,OAAO,EAAE,CACP,iCAAiC,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,oBAAoB,gBAAgB,sEAAsE,CACvM,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/inventory/mcp/dist/tools/replenish-plan.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Task 2448 — what to reorder at one location, how much, and from whom.
+ *
+ * Two things this deliberately does not do. It never substitutes a default
+ * for a missing lead time, service level or history: those lines come back
+ * named as skipped, because a default would hand the operator a confident
+ * wrong quantity. And it never asserts the freshness of its own answer: the
+ * oldest and newest stock timestamps it actually read are returned, so the
+ * agent reports data age as a measured fact.
+ */
+import type { Session } from "neo4j-driver";
+import { type PlanCandidate, type ToolResult } from "../lib/types.js";
+export type ReadCandidatesFn = (session: Session, accountId: string, location: string) => Promise<PlanCandidate[]>;
+export interface ReplenishPlanParams {
+    session: Session;
+    readCandidates: ReadCandidatesFn;
+    accountId: string;
+    location: string;
+    window: number;
+    periodDays: number;
+    /** ISO date used as the order date. Injected rather than read from the clock
+     *  so the expected-arrival arithmetic is testable. */
+    today: string;
+    /** Recent refused writes, injected. Zero when the caller does not supply
+     *  one, so the plan never fails because a log directory is unreadable. */
+    recentWriteRejects?: number;
+}
+export declare function replenishPlan(params: ReplenishPlanParams): Promise<ToolResult>;
+//# sourceMappingURL=replenish-plan.d.ts.map

package/payload/platform/plugins/inventory/mcp/dist/tools/replenish-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replenish-plan.d.ts","sourceRoot":"","sources":["../../src/tools/replenish-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQ5C,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,UAAU,EAEhB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,gBAAgB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB;0DACsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd;8EAC0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2GpF"}