@d19n/youfibre-odin-sdk 2.0.166 → 2.0.168

package/dist/actions-v2/CreateInboundCallEventDto.d.ts

@@ -22,8 +22,8 @@ export interface CreateInboundCallEventMessage extends OdinRecordCreatedEvent<Cr
 /**
  * Properties for CreateInboundCallEvent action
  *
- * @property Required fields: 5
- * @property Optional fields: 3
+ * @property Required fields: 6
+ * @property Optional fields: 2
  */
 export interface CreateInboundCallEventProperties {
     /**
@@ -66,6 +66,14 @@ export interface CreateInboundCallEventProperties {
      * @required
      */
     ProcessingStatus: string;
+    /**
+     * Title
+     *
+     * Title of twilio call event record
+     * @type {TEXT}
+     * @required
+     */
+    Title: string;
     /**
      * CallId
      *
@@ -80,13 +88,6 @@ export interface CreateInboundCallEventProperties {
      * @type {TEXT}
      */
     CallSid?: string | null;
-    /**
-     * Title
-     *
-     * Title of twilio call event record
-     * @type {TEXT}
-     */
-    Title?: string | null;
 }
 /**
  * CreateInboundCallEvent

package/dist/actions-v2/CreateOutboundCallEventDto.d.ts

@@ -22,8 +22,8 @@ export interface CreateOutboundCallEventMessage extends OdinRecordCreatedEvent<C
 /**
  * Properties for CreateOutboundCallEvent action
  *
- * @property Required fields: 5
- * @property Optional fields: 3
+ * @property Required fields: 6
+ * @property Optional fields: 2
  */
 export interface CreateOutboundCallEventProperties {
     /**
@@ -66,6 +66,14 @@ export interface CreateOutboundCallEventProperties {
      * @required
      */
     ProcessingStatus: string;
+    /**
+     * Title
+     *
+     * Title of twilio call event record
+     * @type {TEXT}
+     * @required
+     */
+    Title: string;
     /**
      * CallId
      *
@@ -80,13 +88,6 @@ export interface CreateOutboundCallEventProperties {
      * @type {TEXT}
      */
     CallSid?: string | null;
-    /**
-     * Title
-     *
-     * Title of twilio call event record
-     * @type {TEXT}
-     */
-    Title?: string | null;
 }
 /**
  * CreateOutboundCallEvent

package/dist/actions-v2/UpdateCallEventAfterProcessingDto.d.ts

@@ -22,7 +22,7 @@ export interface UpdateCallEventAfterProcessingMessage extends OdinRecordUpdated
  * Properties for UpdateCallEventAfterProcessing action
  *
  * @property Required fields: 2
- * @property Optional fields: 3
+ * @property Optional fields: 0
  */
 export interface UpdateCallEventAfterProcessingProperties {
     /**
@@ -41,27 +41,6 @@ export interface UpdateCallEventAfterProcessingProperties {
      * @required
      */
     ProcessingStatus: string;
-    /**
-     * Title
-     *
-     * Title of twilio call event record
-     * @type {TEXT}
-     */
-    Title?: string | null;
-    /**
-     * CallId
-     *
-     * Reference of the call record
-     * @type {LOOKUP}
-     */
-    CallId?: string | null;
-    /**
-     * CallSid
-     *
-     * Twilio id of the call
-     * @type {TEXT}
-     */
-    CallSid?: string | null;
 }
 /**
  * UpdateCallEventAfterProcessing

package/dist/process-model/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Process-model evaluation engine + frozen BP projections.
+ *
+ *     data + process template + evaluation mechanism → correct / variance
+ *
+ * Deployable lift of the agent-os evaluation harness so backend services
+ * (e.g. the fulfillment-health API) can score live records against the BP
+ * source of truth server-side. Import via the full dist subpath:
+ *   `@d19n/youfibre-odin-sdk/dist/process-model/index`
+ */
+export * from './types';
+export * from './process-validator';
+export { ORDER_PROCESS_PROJECTION } from './order-process.projection';
+export { INSTALL_PROCESS_PROJECTION } from './install-process.projection';

package/dist/process-model/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTALL_PROCESS_PROJECTION = exports.ORDER_PROCESS_PROJECTION = void 0;
+/**
+ * Process-model evaluation engine + frozen BP projections.
+ *
+ *     data + process template + evaluation mechanism → correct / variance
+ *
+ * Deployable lift of the agent-os evaluation harness so backend services
+ * (e.g. the fulfillment-health API) can score live records against the BP
+ * source of truth server-side. Import via the full dist subpath:
+ *   `@d19n/youfibre-odin-sdk/dist/process-model/index`
+ */
+__exportStar(require("./types"), exports);
+__exportStar(require("./process-validator"), exports);
+var order_process_projection_1 = require("./order-process.projection");
+Object.defineProperty(exports, "ORDER_PROCESS_PROJECTION", { enumerable: true, get: function () { return order_process_projection_1.ORDER_PROCESS_PROJECTION; } });
+var install_process_projection_1 = require("./install-process.projection");
+Object.defineProperty(exports, "INSTALL_PROCESS_PROJECTION", { enumerable: true, get: function () { return install_process_projection_1.INSTALL_PROCESS_PROJECTION; } });

package/dist/process-model/install-process.projection.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Frozen evaluation projection of the INSTALL business process.
+ *
+ * Mechanical extraction of `agent-os/knowledge/business-processes/install.ts`
+ * — the EVALUATION-relevant fields only (stage key/name/terminal + thresholds
+ * + dependencies/onVariance). Rendering/BPMN fields (entryActions, stageJobs,
+ * handoffs) are intentionally omitted; the agent-os file remains the authoring
+ * source of truth. Same pattern as `wholesale-provider/install-stage-kci-spec.ts`.
+ *
+ * All INSTALL stages are listed (even those with no dependencies) so that a WO
+ * at any legitimate stage is RECOGNISED by the validator and scores `correct`,
+ * rather than falsely surfacing as `unmatched-variance` (stage-not-found).
+ *
+ * Verified against the live BP on 2026-05-23.
+ */
+import type { ProcessDef } from './types';
+export declare const INSTALL_PROCESS_PROJECTION: ProcessDef;

package/dist/process-model/install-process.projection.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTALL_PROCESS_PROJECTION = void 0;
+exports.INSTALL_PROCESS_PROJECTION = {
+    id: 'INSTALL',
+    title: 'Install Work Order',
+    entity: 'FieldServiceModule:WorkOrder',
+    scopeFilter: [{ column: 'Type', op: 'in', value: ['INSTALL'] }],
+    stages: [
+        {
+            key: 'WorkOrderStageAccepted',
+            name: 'Accepted',
+            warnAfter: '7d',
+            alertAfter: '14d',
+        },
+        {
+            key: 'WorkOrderStageScheduled',
+            name: 'Scheduled',
+            dependencies: [
+                {
+                    kind: 'cross-system-record-exists',
+                    id: 'install-scheduled-must-have-net-counterpart',
+                    mapping: {
+                        system: 'NET',
+                        remoteEntity: 'FieldServiceModule:WorkOrder',
+                        mapping: { fromProperty: 'id', toProperty: 'OdinExternalId' },
+                    },
+                    severity: 'BLOCKER',
+                    notes: 'Every wholesale Scheduled WO must have a NET counterpart.',
+                },
+                {
+                    kind: 'related-record',
+                    id: 'install-scheduled-must-have-service-appointment',
+                    relation: {
+                        entity: 'FieldServiceModule:ServiceAppointment',
+                        filter: [],
+                        minCount: 1,
+                    },
+                    severity: 'WARN',
+                    notes: 'Scheduled WO must have ≥1 linked ServiceAppointment.',
+                },
+            ],
+        },
+        { key: 'WorkOrderStageEnRoute', name: 'En Route' },
+        { key: 'WorkOrderStageInProgress', name: 'In Progress' },
+        { key: 'WorkOrderRemediationRequired', name: 'Remediation Required' },
+        {
+            key: 'CustomerWorkOrdersStagePending',
+            name: 'Pending',
+            warnAfter: '3d',
+            alertAfter: '7d',
+        },
+        { key: 'WorkOrderStageDone', name: 'Done', terminal: true },
+        { key: 'WorkOrderStageCancelled', name: 'Cancelled', terminal: true },
+    ],
+};

package/dist/process-model/order-process.projection.d.ts

@@ -0,0 +1,2 @@
+import type { ProcessDef } from './types';
+export declare const ORDER_PROCESS_PROJECTION: ProcessDef;

package/dist/process-model/order-process.projection.js

@@ -0,0 +1,289 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORDER_PROCESS_PROJECTION = void 0;
+/**
+ * Frozen evaluation projection of the ORDER business process.
+ *
+ * Mechanical extraction of `agent-os/knowledge/business-processes/order.ts`
+ * — EVALUATION-relevant fields only. v1 ports the OrderStageSupply dependency
+ * block (the fulfilment off-track surface: missing base product, NET
+ * dispatch/counterpart/commit gaps, the active-progressing-install fan-out,
+ * the OTS-progress gate, and the four INFO activation gates). Other stages are
+ * listed RECOGNISED but without ported dependencies for v1, so an Order at
+ * Sold/Active/Cancelled scores `correct` rather than `unmatched-variance`.
+ * Extend per-stage as later passes need them.
+ *
+ * Activation-gate invariants carry `predicateRef: order.activationGate.*`,
+ * which the lifted engine does NOT register (severity INFO) → they surface as
+ * `unsupported-kind` (honest coverage gap), never as a data variance.
+ *
+ * Verified against the live BP on 2026-05-23.
+ */
+const ChangeReason_1 = require("../entities-v2/ChangeReason");
+exports.ORDER_PROCESS_PROJECTION = {
+    id: 'ORDER',
+    title: 'Order',
+    entity: 'OrderModule:Order',
+    stages: [
+        { key: 'OrderStageDraft', name: 'Draft' },
+        { key: 'OrderStagePreOrder', name: 'Pre-Order' },
+        { key: 'OrderStageSold', name: 'Sold' },
+        {
+            key: 'OrderStageSupply',
+            name: 'Supply',
+            warnAfter: '15d',
+            alertAfter: '30d',
+            dependencies: [
+                {
+                    kind: 'related-record',
+                    id: 'supply-must-have-base-product-item',
+                    relation: {
+                        entity: 'OrderModule:OrderItem',
+                        filter: [{ column: 'ProductType', op: 'eq', value: 'BASE_PRODUCT' }],
+                        minCount: 1,
+                    },
+                    severity: 'BLOCKER',
+                    notes: 'A Supply order must carry the BASE_PRODUCT order item. Missing = offer misconfiguration that blocks NET dispatch and activation. Revert to Draft for correction.',
+                    onVariance: [
+                        {
+                            when: 'no-related-records',
+                            action: {
+                                kind: 'revert-parent-to',
+                                stageKey: 'OrderStageDraft',
+                                notes: 'Supply order has zero OrderItem links — checkout defect. Revert to Draft for investigation.',
+                            },
+                        },
+                        {
+                            when: 'no-records-matching',
+                            match: [{ column: 'ProductType', op: 'eq', value: 'BASE_PRODUCT' }],
+                            action: {
+                                kind: 'revert-parent-to',
+                                stageKey: 'OrderStageDraft',
+                                notes: 'Supply order has items but no BASE_PRODUCT. Offer misconfiguration — cannot dispatch to NET. Revert to Draft for correction.',
+                            },
+                        },
+                    ],
+                },
+                {
+                    kind: 'process-success',
+                    id: 'supply-must-have-net-create-provide-success',
+                    process: 'NetomniaCreateProvideNewOrder',
+                    matchOn: 'journeyId',
+                    withinWindow: '90d',
+                    severity: 'BLOCKER',
+                    notes: 'FNO outbound must succeed for NETOMNIA-wholesale providers.',
+                },
+                {
+                    kind: 'cross-system-record-exists',
+                    id: 'supply-must-have-net-counterpart',
+                    parentFilter: [
+                        { column: 'Provider', op: 'in', value: ['BRSK', 'NETOMNIA', 'NETOMNIA_LEGACY'] },
+                    ],
+                    mapping: {
+                        system: 'NET',
+                        remoteEntity: 'OrderModule:Order',
+                        mapping: { fromProperty: 'id', toProperty: 'ExternalRef' },
+                    },
+                    severity: 'BLOCKER',
+                    notes: 'Every Supply order on a NET-platform provider must have a NET counterpart by ExternalRef. Missing counterpart = YF→NET PROVIDE dispatch never landed (or NET-side dropped the record).',
+                    onVariance: [
+                        {
+                            when: 'no-cross-system-record',
+                            action: {
+                                kind: 'manual-triage',
+                                reason: 'Operator intent: re-fire YF→NET PROVIDE dispatch on the parent order. Idempotency-safe in YF (createNetomniaOrder probes for existing NET counterpart and short-circuits with IDEMPOTENT_SKIP_ALREADY_IN_NET when found). The YF endpoint exists at OrderModule/v1.0/netomnia/create-provide-order.',
+                            },
+                        },
+                    ],
+                },
+                {
+                    kind: 'related-record',
+                    id: 'supply-must-have-committed-kci',
+                    parentFilter: [
+                        { column: 'Provider', op: 'in', value: ['BRSK', 'NETOMNIA', 'NETOMNIA_LEGACY'] },
+                    ],
+                    relation: {
+                        entity: 'OrderModule:OrderKci',
+                        filter: [{ column: 'Type', op: 'in', value: ['COMMITTED', 'ACKNOWLEDGED'] }],
+                        minCount: 1,
+                    },
+                    severity: 'BLOCKER',
+                    notes: 'Supply means YF dispatched AND provider confirmed (COMMITTED or ACKNOWLEDGED OrderKci). Variance = NET dispatched but provider has not confirmed — chase the provider or re-dispatch via /retry-sold-to-supply.',
+                    onVariance: [
+                        {
+                            when: 'no-related-records',
+                            action: {
+                                kind: 'manual-triage',
+                                reason: 'No OrderKci of any kind on this Supply order — NET dispatch may have landed but no KCI received. Investigate whether the NET counterpart was actually created.',
+                            },
+                        },
+                        {
+                            when: 'no-records-matching',
+                            match: [{ column: 'Type', op: 'in', value: ['COMMITTED', 'ACKNOWLEDGED'] }],
+                            action: {
+                                kind: 'manual-triage',
+                                reason: 'OrderKcis exist but none are COMMITTED/ACKNOWLEDGED — provider received the order but has not committed. Normal for very-recent Supply orders (<24h); persistent variance = provider-side hold, chase or re-dispatch.',
+                            },
+                        },
+                    ],
+                },
+                {
+                    kind: 'related-record',
+                    id: 'supply-must-have-active-progressing-install',
+                    relation: {
+                        entity: 'FieldServiceModule:WorkOrder',
+                        filter: [
+                            { column: 'Type', op: 'in', value: ['INSTALL', 'INSTALL_BUSINESS'] },
+                            {
+                                column: 'StageKey',
+                                op: 'in',
+                                value: [
+                                    // INSTALL active-progressing (5 — drops Accepted)
+                                    'WorkOrderStageScheduled',
+                                    'WorkOrderStageEnRoute',
+                                    'WorkOrderStageInProgress',
+                                    'WorkOrderRemediationRequired',
+                                    'CustomerWorkOrdersStagePending',
+                                    // INSTALL_BUSINESS active-progressing (7)
+                                    'BusinessInstallPipelineStageDesktopSurveyRequired',
+                                    'BusinessInstallPipelineStageReadyForInstallation',
+                                    'BusinessInstallPipelineStageScheduled',
+                                    'BusinessInstallPipelineStageEnRoute',
+                                    'BusinessInstallPipelineStageSiteSurveyRequired',
+                                    'BusinessInstallPipelineStageRemediationRequired',
+                                    'BusinessInstallPipelineStageInProgress',
+                                ],
+                            },
+                        ],
+                        minCount: 1,
+                    },
+                    severity: 'BLOCKER',
+                    notes: 'Supply must have ≥1 actively-progressing INSTALL/INSTALL_BUSINESS WO. Variance fans out to multiple remediations by shape — see onVariance.',
+                    onVariance: [
+                        {
+                            when: 'no-related-records',
+                            action: {
+                                kind: 'revert-parent-to',
+                                stageKey: 'OrderStageSold',
+                                notes: 'No WorkOrders linked at all. Order needs to re-flow through fulfilment.',
+                            },
+                        },
+                        {
+                            when: 'no-records-matching',
+                            match: [{ column: 'Type', op: 'in', value: ['INSTALL', 'INSTALL_BUSINESS'] }],
+                            action: {
+                                kind: 'revert-parent-to',
+                                stageKey: 'OrderStageSold',
+                                notes: 'Linked WOs exist (e.g. SERVICE) but no INSTALL/INSTALL_BUSINESS was ever created. Revert so fulfilment dispatch retries from Sold.',
+                            },
+                        },
+                        {
+                            when: 'all-records-matching-also-match',
+                            selector: [{ column: 'Type', op: 'in', value: ['INSTALL', 'INSTALL_BUSINESS'] }],
+                            additional: [{ column: 'StageKey', op: 'in', value: ['WorkOrderStageAccepted'] }],
+                            action: {
+                                kind: 'revert-parent-to',
+                                stageKey: 'OrderStageSold',
+                                notes: 'Every INSTALL is in Accepted — supplier acknowledged but never booked an appointment. Revert so a fresh Sold→Supply pass can re-dispatch.',
+                            },
+                        },
+                        {
+                            when: 'all-records-matching-also-match',
+                            selector: [{ column: 'Type', op: 'in', value: ['INSTALL', 'INSTALL_BUSINESS'] }],
+                            additional: [
+                                {
+                                    column: 'StageKey',
+                                    op: 'in',
+                                    value: ['WorkOrderStageCancelled', 'BusinessInstallPipelineStageCancelled'],
+                                },
+                            ],
+                            action: {
+                                kind: 'cancel-parent',
+                                stageKey: 'OrderStageCancelled',
+                                properties: {
+                                    CancellationReason: ChangeReason_1.ChangeReasonCancelReason.CANCELLATION_FOR_PERSONAL_REASONS,
+                                },
+                                notes: 'Every INSTALL/INSTALL_BUSINESS is Cancelled with no replacement. Cancel cleanly so cancellation history is preserved.',
+                            },
+                        },
+                        {
+                            when: 'all-records-matching-also-match',
+                            selector: [{ column: 'Type', op: 'in', value: ['INSTALL', 'INSTALL_BUSINESS'] }],
+                            additional: [
+                                {
+                                    column: 'StageKey',
+                                    op: 'in',
+                                    value: ['WorkOrderStageDone', 'BusinessInstallPipelineStageComplete'],
+                                },
+                            ],
+                            action: {
+                                kind: 'invoke-platform-api',
+                                endpoint: '/OrderModule/v1.0/orders/{parent.id}/retry-supply-to-active',
+                                method: 'post',
+                                notes: 'Every INSTALL/INSTALL_BUSINESS WO is Done/Complete — engineer finished but Order is stuck in Supply. Trigger the Supply→Active eval; the endpoint handles billing eligibility + ONT activation gates.',
+                            },
+                        },
+                    ],
+                },
+                {
+                    kind: 'related-record',
+                    id: 'supply-gaining-ots-must-progress',
+                    relation: {
+                        entity: 'OrderModule:OneTouchSwitch',
+                        filter: [
+                            { column: 'EntityType', op: 'eq', value: 'GAINING' },
+                            { column: 'Status', op: 'eq', value: 'SWITCH_MATCH_REQUEST_CONFIRMED' },
+                        ],
+                        maxCount: 0,
+                    },
+                    severity: 'BLOCKER',
+                    notes: 'Order in Supply with linked GAINING OTS must NOT have OTS stuck at SWITCH_MATCH_REQUEST_CONFIRMED past the 24h SLO.',
+                    onVariance: [
+                        {
+                            when: 'otherwise',
+                            action: {
+                                kind: 'manual-triage',
+                                reason: 'Operator intent: fire residentialSwitchOrderRequest against the GAINING OTS stuck at SWITCH_MATCH_REQUEST_CONFIRMED, deriving PlannedSwitchDate from the linked Order → INSTALL WO → ServiceAppointment.Date.',
+                            },
+                        },
+                    ],
+                },
+                // Activation gates (INFO) — predicateRef not registered in the lifted
+                // engine → surface as unsupported-kind, never a variance.
+                {
+                    kind: 'invariant',
+                    id: 'supply-activation-gate-install-success',
+                    description: 'Order has ≥1 linked INSTALL / INSTALL_BUSINESS / SERVICE WorkOrder at a success stage (Done / Complete) — the load-bearing causal trigger for activation evaluation.',
+                    severity: 'INFO',
+                    predicateRef: 'order.activationGate.installSuccess',
+                },
+                {
+                    kind: 'invariant',
+                    id: 'supply-activation-gate-base-product',
+                    description: 'Order has items, including ≥1 BASE_PRODUCT order item. Without a base product, Active has no recurring revenue line to bill.',
+                    severity: 'INFO',
+                    predicateRef: 'order.activationGate.baseProduct',
+                },
+                {
+                    kind: 'invariant',
+                    id: 'supply-activation-gate-ots-trigger-confirmed',
+                    description: 'For OTS GAINING orders only: linked OneTouchSwitch Status must be SWITCH_ORDER_TRIGGER_CONFIRMED (transitionSupplyToActive fires switch-trigger-request inline if at REQUEST/UPDATE_CONFIRMED).',
+                    severity: 'INFO',
+                    predicateRef: 'order.activationGate.otsTriggerConfirmed',
+                },
+                {
+                    kind: 'invariant',
+                    id: 'supply-activation-gate-ont-health',
+                    description: 'ONT health on the linked Premise: AdminStatus=up AND OperStatus=up. CITYFIBRE bypassed.',
+                    severity: 'INFO',
+                    predicateRef: 'order.activationGate.ontHealthUp',
+                },
+            ],
+        },
+        { key: 'OrderStageActive', name: 'Active' },
+        { key: 'OrderStageDeactivated', name: 'Deactivated' },
+        { key: 'OrderStagePendingCancellation', name: 'Pending Cancellation' },
+        { key: 'OrderStageCancelled', name: 'Cancelled' },
+        { key: 'OrderStageBrskMigrationRemediation', name: 'BRSK Migration Remediation' },
+    ],
+};

package/dist/process-model/process-validator.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Generic process-template evaluation engine (deployable lift).
+ *
+ *   data + process template + evaluation mechanism → correct / variance
+ *
+ * Lifted verbatim from `agent-os/tools/ops/src/lib/process-validator.ts` so
+ * the deployed fulfillment-health API can score live records against the
+ * frozen `ProcessDef` projections server-side. Pure function — no SDK calls,
+ * no mutation, no I/O. The caller pre-hydrates relations / cross-system
+ * records / process-success indexes.
+ *
+ * Design rules (project memory `project_data_template_evaluation_model.md`):
+ * - The engine evaluates schema; it does not encode business decisions.
+ * - A failing dependency with no matching `onVariance` clause → `unmatched-
+ *   variance` (never a silent default). This is the signal the template is
+ *   incomplete — the BP-gap-analysis trigger.
+ * - A dependency whose `kind` the caller didn't hydrate → `unsupported-kind`,
+ *   distinguishing "coverage gap this run" from "template extension needed".
+ */
+import type { ActionDecl, Dependency, ProcessDef, ProcessSuccessRecord } from './types';
+/**
+ * Minimal record shape the engine needs. Concrete SDK record types
+ * (OrderRecord, WorkOrderRecord, etc.) structurally satisfy this.
+ */
+export interface MinimalRecord {
+    id?: string;
+    type?: string;
+    recordNumber?: string;
+    stage?: {
+        key?: string;
+        name?: string;
+    };
+    properties?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ValidationContext {
+    record: MinimalRecord;
+    process: ProcessDef;
+    /** Hydrated related records, keyed by canonical Odin entity key. */
+    relations: Record<string, MinimalRecord[]>;
+    /** Hydrated cross-system records, keyed by `<system>:<remoteEntity>`. */
+    crossSystemRecords?: Record<string, MinimalRecord[]>;
+    /** process-success indexes keyed by `${process}::${withinWindow ?? '<no-window>'}`. */
+    processSuccessIndexes?: Record<string, Map<string, ProcessSuccessRecord>>;
+}
+export declare type DepStatus = 'correct' | 'variance' | 'unmatched-variance' | 'unsupported-kind';
+export interface DepVerdict {
+    depId: string;
+    depKind: Dependency['kind'];
+    status: DepStatus;
+    varianceShape?: string;
+    varianceActualSummary?: string;
+    prescribedAction?: ActionDecl;
+    unresolvedReason?: string;
+}
+export declare type AgeStatus = 'green' | 'warn' | 'alert' | 'unknown';
+export interface AgeInStage {
+    days: number;
+    status: AgeStatus;
+    warnAfterDays?: number;
+    alertAfterDays?: number;
+}
+export interface ValidationReport {
+    recordId: string;
+    recordNumber?: string;
+    stageKey: string;
+    stageRecognised: boolean;
+    verdicts: DepVerdict[];
+    ageInStage: AgeInStage;
+    /** Priority: 'variance' > 'unmatched-variance' > 'correct' > 'unsupported-kind'. */
+    overall: DepStatus;
+}
+/**
+ * Evaluate `ctx.record` against `ctx.process` for the record's current stage.
+ */
+export declare function validateAgainstProcess(ctx: ValidationContext): ValidationReport;
+export declare function buildProcessSuccessIndexKey(process: string, withinWindow: string | undefined): string;