@rubytech/create-maxy-code 0.1.566 → 0.1.568

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

@@ -0,0 +1,91 @@
+const num = (v) => typeof v?.toNumber === "function"
+    ? v.toNumber()
+    : Number(v);
+const numOrNull = (v) => v === null || v === undefined ? null : num(v);
+/** Everything the plan needs for one location, in one query. OPTIONAL MATCH
+ *  throughout rather than MATCH: a product missing its policy or supplier
+ *  terms must still come back, as a skipped line naming what is missing. A
+ *  plain MATCH would drop it and the plan would look complete while silently
+ *  omitting exactly the products that need operator attention. */
+export async function readPlanCandidates(session, accountId, location) {
+    const res = await session.run(`MATCH (sp:StockPosition {accountId: $accountId, location: $location})
+     MATCH (p:Product {accountId: $accountId}) WHERE elementId(p) = sp.product
+     OPTIONAL MATCH (pol:ReplenishmentPolicy {accountId: $accountId, product: sp.product, location: $location})
+     OPTIONAL MATCH (p)-[terms:SUPPLIED_BY]->(o:Organization {accountId: $accountId})
+     OPTIONAL MATCH (d:DemandObservation {accountId: $accountId, product: sp.product, location: $location})
+     WITH sp, p, pol, terms, o, d ORDER BY d.periodStart ASC
+     WITH sp, p, pol, terms, o, collect(d.quantitySold) AS history
+     RETURN p.sku AS sku,
+            sp.product AS productNodeId,
+            sp.location AS location,
+            sp.quantityOnHand AS quantityOnHand,
+            sp.quantityOnOrder AS quantityOnOrder,
+            sp.asOf AS asOf,
+            history,
+            pol.serviceLevel AS serviceLevel,
+            pol.reviewPeriodDays AS reviewPeriodDays,
+            terms.leadTimeDays AS leadTimeDays,
+            terms.minimumOrderQuantity AS minimumOrderQuantity,
+            terms.orderMultiple AS orderMultiple,
+            CASE WHEN o IS NULL THEN null ELSE elementId(o) END AS supplierNodeId`, { accountId, location });
+    return res.records.map((r) => ({
+        sku: r.get("sku"),
+        productNodeId: r.get("productNodeId"),
+        location: r.get("location"),
+        quantityOnHand: num(r.get("quantityOnHand")),
+        quantityOnOrder: num(r.get("quantityOnOrder")),
+        asOf: r.get("asOf"),
+        history: r.get("history").map(num),
+        serviceLevel: numOrNull(r.get("serviceLevel")),
+        reviewPeriodDays: numOrNull(r.get("reviewPeriodDays")),
+        leadTimeDays: numOrNull(r.get("leadTimeDays")),
+        minimumOrderQuantity: numOrNull(r.get("minimumOrderQuantity")),
+        orderMultiple: numOrNull(r.get("orderMultiple")),
+        supplierNodeId: r.get("supplierNodeId") ?? null,
+    }));
+}
+/** Resolves a SKU to a :Product element id on this account. Null when absent
+ *  or when the SKU is ambiguous — two products sharing a SKU is a data fault
+ *  the operator must fix, not something to guess past. */
+export async function resolveProductBySku(session, accountId, sku) {
+    const res = await session.run(`MATCH (p:Product {accountId: $accountId, sku: $sku})
+     RETURN elementId(p) AS id
+     LIMIT 2`, { accountId, sku });
+    if (res.records.length !== 1)
+        return null;
+    return res.records[0].get("id");
+}
+/** Units sold per period for one product at one location, oldest first. */
+export async function readDemandHistory(session, accountId, productNodeId, location) {
+    const res = await session.run(`MATCH (d:DemandObservation {accountId: $accountId, product: $productNodeId, location: $location})
+     RETURN d.quantitySold AS q
+     ORDER BY d.periodStart ASC`, { accountId, productNodeId, location });
+    return res.records.map((r) => {
+        const q = r.get("q");
+        return typeof q?.toNumber === "function" ? q.toNumber() : Number(q);
+    });
+}
+/** Sets the commercial terms on an existing SUPPLIED_BY edge. Returns false
+ *  when no such edge exists: the edge is the operator's assertion that this
+ *  supplier supplies this product, and creating it here would let a typo
+ *  invent a supply relationship. */
+export async function setSupplierTerms(session, accountId, productNodeId, supplierNodeId, terms) {
+    const res = await session.run(`MATCH (p:Product {accountId: $accountId})-[r:SUPPLIED_BY]->(o:Organization {accountId: $accountId})
+     WHERE elementId(p) = $productNodeId AND elementId(o) = $supplierNodeId
+     SET r.leadTimeDays = $leadTimeDays,
+         r.minimumOrderQuantity = $minimumOrderQuantity,
+         r.orderMultiple = $orderMultiple,
+         r.unitCost = $unitCost
+     RETURN count(r) AS n`, { accountId, productNodeId, supplierNodeId, ...terms });
+    const n = res.records[0]?.get("n");
+    return (typeof n?.toNumber === "function" ? n.toNumber() : Number(n ?? 0)) > 0;
+}
+/** Confirms a :StoreLocation element id exists on this account. */
+export async function resolveLocation(session, accountId, nodeId) {
+    const res = await session.run(`MATCH (l:StoreLocation {accountId: $accountId})
+     WHERE elementId(l) = $nodeId
+     RETURN count(l) AS n`, { accountId, nodeId });
+    const n = res.records[0]?.get("n");
+    return (typeof n?.toNumber === "function" ? n.toNumber() : Number(n ?? 0)) === 1;
+}
+//# sourceMappingURL=read.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * 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 declare function standardDeviation(values: number[]): number;
+export declare function serviceLevelZ(serviceLevel: number): number;
+export interface ReorderPointInput {
+    /** Expected units sold per period, from the forecast. */
+    perPeriod: number;
+    /** Spread of units sold per period, across the same history. */
+    stdDevPerPeriod: number;
+    /** Length of one demand period in days. */
+    periodDays: number;
+    leadTimeDays: number;
+    reviewPeriodDays: number;
+    serviceLevel: number;
+}
+/**
+ * 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 declare function reorderPoint(input: ReorderPointInput): number;
+export interface OrderQuantityInput {
+    /** Order-up-to level, which is the reorder point under periodic review. */
+    target: number;
+    /** On hand plus already on order. */
+    available: number;
+    minimumOrderQuantity: number;
+    orderMultiple: number;
+}
+/**
+ * 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 declare function orderQuantity(input: OrderQuantityInput): number;
+/**
+ * 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 declare function daysOfCover(quantityOnHand: number, perPeriod: number, periodDays: number): number | null;
+//# sourceMappingURL=replenish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replenish.d.ts","sourceRoot":"","sources":["../../src/lib/replenish.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;8DAE8D;AAC9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAK1D;AAsBD,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAmB1D;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAwB7D;AAED,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAc/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAQf"}

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":"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"}

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"}