@ingenx-io/valets-schema-mcp-server 0.1.2 → 0.1.3

package/data/docs/collections/firestore-paths.md

@@ -19,6 +19,7 @@ companies/{companyId}/
 ├── sales/{saleId}
 ├── purchases/{purchaseId}
 ├── customerPayments/{paymentId}
+├── paymentSummaries/{period}
 ├── loyaltyTransactions/{transactionId}
 └── loyaltyConfig (singleton document)
 ```

package/data/docs/enums/booking-status.md

@@ -23,4 +23,4 @@ Must be one of:
 * "COMPLETED_MIXED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000

package/data/docs/enums/customer-payment-status.md

@@ -23,4 +23,4 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000

package/data/docs/enums/customer-payment-target-type.md

@@ -20,4 +20,4 @@ Must be one of:
 * "PURCHASE"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000

package/data/docs/enums/delivery-type.md

@@ -20,4 +20,4 @@ Must be one of:
 * "DELIVERY"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000

package/data/docs/enums/event-status.md

@@ -21,7 +21,7 @@ Must be one of:
 * "COMPLETED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/fulfillment-status.md

@@ -23,7 +23,7 @@ Must be one of:
 * "PICKED_UP"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/loyalty-transaction-type.md

@@ -23,7 +23,7 @@ Must be one of:
 * "REFUND"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/order-status.md

@@ -24,7 +24,7 @@ Must be one of:
 * "EXPIRED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/payment-method.md

@@ -27,7 +27,7 @@ Must be one of:
 * "OTHER"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/payment-proof-status.md

@@ -20,4 +20,4 @@ Must be one of:
 * "REJECTED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000

package/data/docs/enums/payment-status.md

@@ -24,7 +24,7 @@ Must be one of:
 * "PARTIALLY_REFUNDED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/return-status.md

@@ -23,7 +23,7 @@ Must be one of:
 * "EXCHANGE_COMPLETED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/session-status.md

@@ -23,7 +23,7 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/enums/ticket-status.md

@@ -20,7 +20,7 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/index.md

@@ -79,6 +79,13 @@ Core Firestore document schemas:
 
 
 
+| Enum | Values | Description |
+|------|--------|-------------|
+| [AttentionStatus](proposed/enums/attention-status) | 4 values | Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned — set via triggers or callable fn only. |
+| [PendingIssue](proposed/enums/pending-issue) | 11 values | Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array — multiple issues can be active simultaneously. Server-owned. |
+
+
+
 
 ## Machine-friendly formats
 

package/data/docs/models/booking-version.md

@@ -270,7 +270,7 @@ Dot-notation paths for nested fields (e.g. "bookingDates.0.status"). Populated b
 | **Additional properties** | Any type allowed |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/booking.md

@@ -1739,7 +1739,7 @@ Set at creation only. This field cannot be modified after the document is create
 **Description:** When true, suppresses Firebase notification triggers (D20/IG-8).
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/models/customer-payment-allocation.md

@@ -329,7 +329,7 @@ Set at creation only. This field cannot be modified after the document is create
 | **Maximum**  | ≤ 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/customer-payment.md

@@ -379,7 +379,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/customer.md

@@ -459,7 +459,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only, Denormalized) Derived summary from loyalty/status subcollection (D08). Source of truth is LoyaltyStatus.pointsBalance.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/event.md

@@ -372,7 +372,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Immutable) FK → User/staff UID who created this event.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.

package/data/docs/models/loyalty-config.md

@@ -304,7 +304,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/loyalty-reward.md

@@ -229,7 +229,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/loyalty-status.md

@@ -315,7 +315,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/loyalty-transaction.md

@@ -313,7 +313,7 @@ Set at creation only. This field cannot be modified after the document is create
 **Description:** (Immutable, Denormalized) From User display name at creation time.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.

package/data/docs/models/metrics-current.md

@@ -525,7 +525,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Maximum**  | ≤ 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/metrics-daily.md

@@ -541,7 +541,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) YYYY-MM-DD document ID repeated as a field. Identifies the day this snapshot covers.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/metrics-monthly.md

@@ -541,7 +541,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) YYYY-MM document ID repeated as a field. Identifies the month this rollup covers.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/order-item.md

@@ -350,7 +350,7 @@ TBD/WIP — Originally from the archived Couchbase Lite (CBL) restaurant flow. C
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/order.md

@@ -1624,7 +1624,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 **Description:** FK → Sale.id. Link to associated Sale document.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 ## Related Decisions
 

package/data/docs/models/payment-summary.md

@@ -0,0 +1,123 @@
+---
+title: "PaymentSummary"
+sidebar_label: "PaymentSummary"
+sidebar_position: 99
+---
+
+# PaymentSummary
+
+**Collection:** `companies/{companyId}/paymentSummaries/{period}`
+
+Aggregated payment totals broken down by payment method for a given period. This is a **server-owned, read-only** model — clients never write to it directly. It is maintained by Cloud Function triggers that fire on `Order.payments[]` and `CustomerPayment` changes.
+
+## Schema
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "id": "2026-03-09",
+  "companyId": "comp_xyz789",
+  "period": "2026-03-09",
+  "periodType": "DAILY",
+  "paymentsByMethod": {
+    "CASH": { "total": 245000, "count": 12 },
+    "WAVE": { "total": 180000, "count": 8 },
+    "ORANGE_MONEY": { "total": 95000, "count": 5 }
+  },
+  "grandTotal": 520000,
+  "totalCount": 25,
+  "currency": "XOF",
+  "lastUpdatedAt": { "_seconds": 1741478400, "_nanoseconds": 0 },
+  "createdAt": { "_seconds": 1741435200, "_nanoseconds": 0 }
+}
+```
+
+</details>
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `id` | `string` | — | (Read-only) Document ID. Matches the period key. |
+| `companyId` | `string` | + | (Immutable) FK → Company document ID. |
+| `period` | `string` | + | Period key: `YYYY-MM-DD` (daily), `YYYY-Www` (weekly), `YYYY-MM` (monthly). |
+| `periodType` | `enum` | + | `DAILY`, `WEEKLY`, or `MONTHLY`. |
+| `paymentsByMethod` | `map` | + | Keyed by PaymentMethod enum value. Each value has `total` (number) and `count` (integer). |
+| `grandTotal` | `number` | + | (Read-only) Sum of all `paymentsByMethod[*].total`. |
+| `totalCount` | `integer` | + | (Read-only) Sum of all `paymentsByMethod[*].count`. |
+| `currency` | `string` | + | Locked to `XOF`. |
+| `lastUpdatedAt` | `Timestamp` | — | (Read-only) Last increment timestamp. |
+| `createdAt` | `Timestamp` | + | (Read-only) Server-generated creation timestamp. |
+
+:::info PaymentMethod keys
+The `paymentsByMethod` map uses [PaymentMethod](/enums/payment-method) enum values as keys: `CASH`, `WAVE`, `ORANGE_MONEY`, `CREDIT_CARD`, etc. Missing keys imply zero for that method.
+:::
+
+:::warning Server-owned
+This document is entirely server-set. All fields are computed by Cloud Function triggers. Clients should treat it as read-only.
+:::
+
+## Trigger design
+
+### Source events
+
+The summary is updated by **two independent triggers**:
+
+1. **`onOrderPaymentChange`** — fires when `Order.payments[]` array changes (new payment added or existing payment updated). Computes the delta and applies `FieldValue.increment()` to the matching `paymentsByMethod.{method}.total` and `.count`, plus `grandTotal` and `totalCount`.
+
+2. **`onCustomerPaymentWrite`** — fires on `CustomerPayment` create/update. Same increment logic for standalone customer payments not tied to an order.
+
+### Increment pattern
+
+```typescript
+// Pseudo-code for the trigger
+const summaryRef = db.doc(
+  `companies/${companyId}/paymentSummaries/${todayKey}`
+);
+
+await summaryRef.set({
+  companyId,
+  period: todayKey,
+  periodType: 'DAILY',
+  currency: 'XOF',
+  [`paymentsByMethod.${method}.total`]: FieldValue.increment(amount),
+  [`paymentsByMethod.${method}.count`]: FieldValue.increment(1),
+  grandTotal: FieldValue.increment(amount),
+  totalCount: FieldValue.increment(1),
+  lastUpdatedAt: FieldValue.serverTimestamp(),
+  createdAt: FieldValue.serverTimestamp(), // only sets on first write (merge)
+}, { merge: true });
+```
+
+### Idempotency
+
+To avoid double-counting on trigger retries, the trigger should check if the payment has already been counted (e.g., via a `_summarized` flag on the payment or by comparing `before`/`after` snapshots in the `onUpdate` trigger).
+
+### Rollups
+
+A scheduled Cloud Function (daily at midnight WAT) can roll up daily summaries into weekly and monthly documents. This is optional — daily granularity alone may be sufficient for the dashboard.
+
+## Querying
+
+```typescript
+// Get today's summary
+const today = '2026-03-09';
+const snap = await db.doc(`companies/${companyId}/paymentSummaries/${today}`).get();
+const summary = snap.data(); // PaymentSummary
+
+// Get summaries for a date range
+const snaps = await db.collection(`companies/${companyId}/paymentSummaries`)
+  .where('periodType', '==', 'DAILY')
+  .where('period', '>=', '2026-03-01')
+  .where('period', '<=', '2026-03-09')
+  .get();
+```
+
+## Related
+
+- [PaymentMethod](/enums/payment-method) — enum used as map keys
+- [CustomerPayment](/models/customer-payment) — source event for trigger
+- [Order](/models/order) — `payments[]` array is the other source event
+- Decision D02 — Unified PaymentMethod enum

package/data/docs/models/sale.md

@@ -524,7 +524,7 @@ Set at creation only. This field cannot be modified after the document is create
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/ticket.md

@@ -388,7 +388,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Immutable) FK → User/staff UID who created this ticket.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.

package/data/static/llms.txt

@@ -4,7 +4,7 @@
 > Source of truth: Zod schemas in packages/schema/src/
 > All Firestore documents are scoped under companies/{companyId}/
 
-> Generated: 2026-03-09
+> Generated: 2026-04-06
 
 ---
 
@@ -1004,6 +1004,16 @@ Example:
 
 > These schemas are under review and not yet part of @valets/schema. Shape may change.
 
+### Proposed Enums
+
+#### AttentionStatus [proposed]
+Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned — set via triggers or callable fn only.
+Values: ACTIVE, STALE, ON_HOLD, ESCALATED
+
+#### PendingIssue [proposed]
+Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array — multiple issues can be active simultaneously. Server-owned.
+Values: PAYMENT_PROOF_PENDING, PAYMENT_PROOF_REJECTED, AMOUNT_DISCREPANCY, RETURN_UNRESOLVED, OVERDUE_DELIVERY, SESSION_OVERDUE, PAYMENT_INCOMPLETE, CANCELLATION_REQUESTED, UNREFUNDED_CANCELLATION, UPCOMING_UNPAID, NO_SHOW_UNRESOLVED
+
 ### Proposed Models
 
 #### PaymentSummary [proposed]

package/data/static/schemas.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "description": "@valets/schema \u2014 consolidated schema bundle",
-  "generated": "2026-03-09T13:15:53.632648+00:00",
+  "generated": "2026-04-06T19:27:48.749605+00:00",
   "schemas": {
     "booking": {
       "type": "object",
@@ -3846,6 +3846,24 @@
       ],
       "description": "Event ticket status (D32). VALID = active and unused."
     },
+    "attention-status": {
+      "type": "string",
+      "enum": [
+        "ACTIVE",
+        "STALE",
+        "ON_HOLD",
+        "ESCALATED"
+      ],
+      "description": "Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned \u2014 set via triggers or callable fn only.",
+      "x-note": "ACTIVE = normal urgent queue (default). STALE = idle past threshold, moved to review queue \u2014 excluded from pendingOrdersCount. ON_HOLD = intentionally paused by manager via callable fn. ESCALATED = ignored past second threshold.",
+      "x-see": {
+        "decisions": [
+          "D39"
+        ]
+      },
+      "x-when": "Set by server automation or callable fn. Mobile and Dashboard read this field; never write it directly. ON_HOLD is the only human-initiated transition \u2014 goes through a dedicated callable function.",
+      "x-status": "proposed"
+    },
     "payment-summary": {
       "type": "object",
       "properties": {
@@ -4007,6 +4025,31 @@
       "additionalProperties": false,
       "description": "Aggregated payment totals by method for a given period. Collection: companies/{companyId}/paymentSummaries/{period}. Server-owned \u2014 all fields are set by Cloud Function triggers on Order.payments[] and CustomerPayment writes. Clients must never write to this collection.",
       "x-status": "proposed"
+    },
+    "pending-issue": {
+      "type": "string",
+      "enum": [
+        "PAYMENT_PROOF_PENDING",
+        "PAYMENT_PROOF_REJECTED",
+        "AMOUNT_DISCREPANCY",
+        "RETURN_UNRESOLVED",
+        "OVERDUE_DELIVERY",
+        "SESSION_OVERDUE",
+        "PAYMENT_INCOMPLETE",
+        "CANCELLATION_REQUESTED",
+        "UNREFUNDED_CANCELLATION",
+        "UPCOMING_UNPAID",
+        "NO_SHOW_UNRESOLVED"
+      ],
+      "description": "Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array \u2014 multiple issues can be active simultaneously. Server-owned.",
+      "x-note": "Shared: PAYMENT_PROOF_PENDING (proof uploaded, awaiting review), PAYMENT_PROOF_REJECTED (proof rejected, needs resubmission), AMOUNT_DISCREPANCY (amountPaid does not reconcile with amount/paymentStatus). Order-only: RETURN_UNRESOLVED (return/exchange stuck), OVERDUE_DELIVERY (estimatedDeliveryDate past, not yet delivered). Booking-only: SESSION_OVERDUE (session date passed, status not updated), PAYMENT_INCOMPLETE (sessions completed but payment not recorded), CANCELLATION_REQUESTED (cancellation not actioned), UNREFUNDED_CANCELLATION (cancelled with amountPaid > 0 and no refund), UPCOMING_UNPAID (session within 48h, payment not recorded), NO_SHOW_UNRESOLVED (no-show without follow-up).",
+      "x-see": {
+        "decisions": [
+          "D39"
+        ]
+      },
+      "x-when": "Set and cleared by server automation or triggers. Never affects pendingOrdersCount or pendingBookingsCount \u2014 orthogonal to urgency. Multiple values can be active at once (stored as PendingIssue[] on Order/Booking).",
+      "x-status": "proposed"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingenx-io/valets-schema-mcp-server",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "MCP server exposing @valets/schema documentation to AI agents",
   "type": "module",
   "main": "index.js",