@assetlab/mcp-server 2.2.0 → 2.4.0

package/dist/tools-write.js

@@ -4696,6 +4696,137 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Infrastructure Lifecycle Events (scope: infrastructure_lifecycle_events)
+    // ============================================================
+    const lifecycleEventScope = {
+        feature_class: z
+            .string()
+            .regex(/^[a-z][a-z0-9_]{0,49}$/)
+            .optional()
+            .describe('Feature class code the strategy scope applies to (omit for a material-wide scope; at least one of feature_class/material is required)'),
+        material: z
+            .string()
+            .max(200)
+            .optional()
+            .describe('Material the scope applies to, exactly as features carry it (e.g. "PVC")'),
+        diameter_min_mm: z
+            .number()
+            .positive()
+            .optional()
+            .describe('Lower bound of a diameter band (requires material); bands ladder like rates'),
+    };
+    const lifecycleEventFields = {
+        event_class: z
+            .enum(['preventive', 'rehabilitation'])
+            .describe('Event type — preventative maintenance or rehabilitation'),
+        trigger_condition_max: z
+            .number()
+            .int()
+            .min(1)
+            .max(99)
+            .describe('Upper bound of the trigger window — the event fires when projected condition falls to this'),
+        trigger_condition_min: z
+            .number()
+            .int()
+            .min(0)
+            .max(98)
+            .optional()
+            .describe('Lower bound of the trigger window (default 0); a feature already below it has missed the event'),
+        impact_method: z
+            .enum(['add_years', 'reset_condition'])
+            .describe('Effect: add years of life, or reset condition to a value'),
+        impact_add_years: z
+            .number()
+            .positive()
+            .max(100)
+            .optional()
+            .describe('Years added (required when impact_method is add_years)'),
+        impact_reset_to: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('Condition after the event (required when impact_method is reset_condition)'),
+        cost_method: z
+            .enum(['per_unit', 'fixed'])
+            .optional()
+            .describe("Costing: per unit (uses the feature's measured quantity and unit) or a fixed amount (default per_unit)"),
+        unit_cost: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Cost per unit (current dollars, never indexed)'),
+        fixed_cost: z.number().min(0).optional().describe('Fixed cost (current dollars)'),
+        cost_source: z
+            .string()
+            .max(200)
+            .optional()
+            .describe('Provenance of the cost ("Engineering 2026", a tender reference)'),
+        max_applications: z
+            .number()
+            .int()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("How many times the event may fire over a feature's life (default 1)"),
+        min_years_between: z
+            .number()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('Minimum years between firings of a recurring event (default 1)'),
+        sort_order: z.number().int().min(0).optional().describe('Evaluation order within the strategy'),
+    };
+    server.tool('create_infrastructure_lifecycle_event', 'Create a lifecycle strategy event. Events attach to a SCOPE (feature_class code, material, optional diameter band) — never to individual features; every feature resolves the most specific matching scope, like replacement rates. Replacement is NOT an event (it is priced by the rates and scheduled by the renewal forecast) — model the interventions BEFORE replacement: crack sealing, relining, resurfacing. List existing events first to reuse a scope. Requires infrastructure_lifecycle_events:write scope.', {
+        name: z.string().max(200).describe('Event name (required, e.g. "Crack Sealing")'),
+        ...lifecycleEventScope,
+        ...lifecycleEventFields,
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-lifecycle-events', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_lifecycle_event', 'Update a lifecycle strategy event by ID. Editing re-confirms the cost (cost_reviewed_on is server-set). Set is_active false to disable an event without deleting it — projections recompute immediately. Requires infrastructure_lifecycle_events:write scope.', {
+        id: z.string().uuid().describe('Lifecycle event ID'),
+        name: z.string().max(200).optional().describe('Event name'),
+        is_active: z.boolean().optional().describe('Disable/enable the event'),
+        event_class: lifecycleEventFields.event_class.optional(),
+        trigger_condition_max: lifecycleEventFields.trigger_condition_max.optional(),
+        trigger_condition_min: lifecycleEventFields.trigger_condition_min,
+        impact_method: lifecycleEventFields.impact_method.optional(),
+        impact_add_years: lifecycleEventFields.impact_add_years,
+        impact_reset_to: lifecycleEventFields.impact_reset_to,
+        cost_method: lifecycleEventFields.cost_method,
+        unit_cost: lifecycleEventFields.unit_cost,
+        fixed_cost: lifecycleEventFields.fixed_cost,
+        cost_source: lifecycleEventFields.cost_source,
+        max_applications: lifecycleEventFields.max_applications,
+        min_years_between: lifecycleEventFields.min_years_between,
+        sort_order: lifecycleEventFields.sort_order,
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-lifecycle-events', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_lifecycle_event', 'Delete a lifecycle strategy event by ID. Projections recompute immediately; consider update with is_active=false to disable instead. Requires infrastructure_lifecycle_events:write scope.', { id: z.string().uuid().describe('Lifecycle event ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-lifecycle-events', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Infrastructure Networks (scope: infrastructure_networks)
     // ============================================================
     server.tool('create_infrastructure_network', 'Create an infrastructure network — a named grouping of features bound to one feature class. Requires infrastructure_networks:write scope.', {
@@ -4952,6 +5083,122 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Asset Lifecycle Events (scope: asset_lifecycle_events)
+    // ============================================================
+    const assetLifecycleEventFields = {
+        event_class: z
+            .enum(['preventive', 'rehabilitation'])
+            .describe('Event type — preventative maintenance or rehabilitation'),
+        trigger_condition_max: z
+            .number()
+            .int()
+            .min(1)
+            .max(99)
+            .describe('Upper bound of the trigger window — the event fires when projected condition falls to this'),
+        trigger_condition_min: z
+            .number()
+            .int()
+            .min(0)
+            .max(98)
+            .optional()
+            .describe('Lower bound of the trigger window (default 0); an asset already below it has missed the event'),
+        impact_method: z
+            .enum(['add_years', 'reset_condition'])
+            .describe('Effect: add years of life, or reset condition to a value'),
+        impact_add_years: z
+            .number()
+            .positive()
+            .max(100)
+            .optional()
+            .describe('Years added (required when impact_method is add_years)'),
+        impact_reset_to: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('Condition after the event (required when impact_method is reset_condition)'),
+        fixed_cost: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Fixed cost per application (current dollars, never indexed)'),
+        cost_source: z
+            .string()
+            .max(200)
+            .optional()
+            .describe('Provenance of the cost ("Engineering 2026", a tender reference)'),
+        max_applications: z
+            .number()
+            .int()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("How many times the event may fire over an asset's life (default 1)"),
+        min_years_between: z
+            .number()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('Minimum years between firings of a recurring event (default 1)'),
+        sort_order: z.number().int().min(0).optional().describe('Evaluation order within the strategy'),
+    };
+    server.tool('create_asset_lifecycle_event', "Create a facility lifecycle strategy event. Events attach to an asset-type SCOPE — exactly ONE of asset_type_id or asset_type_group_id — never to individual assets; an asset resolves its type's own strategy first, else its type group's. Replacement is NOT an event (it stays the renewal forecast + replacement value) — model the interventions BEFORE replacement: roof recoats, boiler retubes, overhauls. Resolve type ids with list_asset_types / list_asset_type_groups, and list existing events first to reuse a scope. Requires asset_lifecycle_events:write scope.", {
+        name: z.string().max(200).describe('Event name (required, e.g. "Roof recoat")'),
+        asset_type_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Asset type the strategy scope applies to (exactly one of the two scope ids)'),
+        asset_type_group_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Asset type group the scope applies to (exactly one of the two scope ids)'),
+        ...assetLifecycleEventFields,
+    }, async (params) => {
+        try {
+            const result = await client.create('asset-lifecycle-events', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_asset_lifecycle_event', 'Update a facility lifecycle strategy event by ID. Editing re-confirms the cost (cost_reviewed_on is server-set). Set is_active false to disable an event without deleting it — projections recompute immediately. Requires asset_lifecycle_events:write scope.', {
+        id: z.string().uuid().describe('Lifecycle event ID'),
+        name: z.string().max(200).optional().describe('Event name'),
+        is_active: z.boolean().optional().describe('Disable/enable the event'),
+        event_class: assetLifecycleEventFields.event_class.optional(),
+        trigger_condition_max: assetLifecycleEventFields.trigger_condition_max.optional(),
+        trigger_condition_min: assetLifecycleEventFields.trigger_condition_min,
+        impact_method: assetLifecycleEventFields.impact_method.optional(),
+        impact_add_years: assetLifecycleEventFields.impact_add_years,
+        impact_reset_to: assetLifecycleEventFields.impact_reset_to,
+        fixed_cost: assetLifecycleEventFields.fixed_cost,
+        cost_source: assetLifecycleEventFields.cost_source,
+        max_applications: assetLifecycleEventFields.max_applications,
+        min_years_between: assetLifecycleEventFields.min_years_between,
+        sort_order: assetLifecycleEventFields.sort_order,
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('asset-lifecycle-events', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_asset_lifecycle_event', 'Delete a facility lifecycle strategy event by ID. Projections recompute immediately; consider update with is_active=false to disable instead. Requires asset_lifecycle_events:write scope.', { id: z.string().uuid().describe('Lifecycle event ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('asset-lifecycle-events', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Asset Condition Assessments (scope: asset_condition_assessments)
     // ============================================================
     server.tool('create_asset_condition_assessment', 'Record a point-in-time condition assessment against an asset. Requires asset_condition_assessments:write scope. Call list_assets first to resolve asset_id.', {