@assetlab/mcp-server 1.19.7 → 1.21.0

package/dist/tools-write.js

@@ -6,16 +6,10 @@
  * Write tools require API keys with the appropriate :write scope.
  */
 import { z } from 'zod';
+import { formatError, formatResult } from './response-shaping.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-function formatResult(data) {
-    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-}
-function formatError(err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
-}
 /** Strip undefined values so the API only receives explicitly-set fields. */
 function buildBody(params) {
     const body = {};
@@ -48,8 +42,8 @@ function coerceNumber(value) {
 function normalizePmTemplateBody(params) {
     const out = { ...params };
     if (Array.isArray(out.tasks)) {
-        out.tasks = out.tasks.map((raw) => {
-            const t = (raw && typeof raw === 'object') ? raw : {};
+        out.tasks = out.tasks.map(raw => {
+            const t = raw && typeof raw === 'object' ? raw : {};
             const id = typeof t.id === 'string' && t.id.trim() !== '' ? t.id : randomTaskId();
             const description = typeof t.description === 'string' ? t.description : '';
             const completed = typeof t.completed === 'boolean' ? t.completed : false;
@@ -57,8 +51,8 @@ function normalizePmTemplateBody(params) {
         });
     }
     if (Array.isArray(out.resources)) {
-        out.resources = out.resources.map((raw) => {
-            const r = (raw && typeof raw === 'object') ? raw : {};
+        out.resources = out.resources.map(raw => {
+            const r = raw && typeof raw === 'object' ? raw : {};
             const res = {};
             if (typeof r.name === 'string')
                 res.name = r.name;
@@ -89,11 +83,22 @@ export function registerWriteTools(server, client) {
         title: z.string().min(1).max(500).describe('Work order title (required)'),
         description: z.string().optional().describe('Detailed description'),
         priority: z.enum(['LOW', 'MEDIUM', 'HIGH', 'URGENT']).optional().describe('Priority level'),
-        status: z.enum(['NEW', 'IN_PROGRESS', 'ON_HOLD', 'REJECTED', 'COMPLETED', 'CANCELLED']).optional().describe('Status'),
+        status: z
+            .enum(['NEW', 'IN_PROGRESS', 'ON_HOLD', 'REJECTED', 'COMPLETED', 'CANCELLED'])
+            .optional()
+            .describe('Status'),
         type: z.enum(['PM', 'REACTIVE']).optional().describe('Work order type'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         due_date: z.string().optional().describe('Due date (ISO 8601)'),
@@ -101,9 +106,20 @@ export function registerWriteTools(server, client) {
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         work_category_id: z.string().uuid().optional().describe('Work category ID'),
         assigned_to: z.string().optional().describe('Assigned user ID (mapped to assignees array)'),
-        assignees: z.array(z.string()).optional().describe('Array of assigned user IDs (alternative to assigned_to for multiple assignees)'),
-        image_url: z.string().max(2000).optional().describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
-        meter_reading: z.number().min(0).optional().describe('Meter/odometer reading at time of service'),
+        assignees: z
+            .array(z.string())
+            .optional()
+            .describe('Array of assigned user IDs (alternative to assigned_to for multiple assignees)'),
+        image_url: z
+            .string()
+            .max(2000)
+            .optional()
+            .describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
+        meter_reading: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Meter/odometer reading at time of service'),
         meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
     }, async (params) => {
         try {
@@ -119,11 +135,22 @@ export function registerWriteTools(server, client) {
         title: z.string().min(1).max(500).optional().describe('Work order title'),
         description: z.string().optional().describe('Detailed description'),
         priority: z.enum(['LOW', 'MEDIUM', 'HIGH', 'URGENT']).optional().describe('Priority level'),
-        status: z.enum(['NEW', 'IN_PROGRESS', 'ON_HOLD', 'REJECTED', 'COMPLETED', 'CANCELLED']).optional().describe('Status'),
+        status: z
+            .enum(['NEW', 'IN_PROGRESS', 'ON_HOLD', 'REJECTED', 'COMPLETED', 'CANCELLED'])
+            .optional()
+            .describe('Status'),
         type: z.enum(['PM', 'REACTIVE']).optional().describe('Work order type'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         due_date: z.string().optional().describe('Due date (ISO 8601)'),
@@ -131,9 +158,20 @@ export function registerWriteTools(server, client) {
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         work_category_id: z.string().uuid().optional().describe('Work category ID'),
         assigned_to: z.string().optional().describe('Assigned user ID (mapped to assignees array)'),
-        assignees: z.array(z.string()).optional().describe('Array of assigned user IDs (alternative to assigned_to for multiple assignees)'),
-        image_url: z.string().max(2000).optional().describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
-        meter_reading: z.number().min(0).optional().describe('Meter/odometer reading at time of service'),
+        assignees: z
+            .array(z.string())
+            .optional()
+            .describe('Array of assigned user IDs (alternative to assigned_to for multiple assignees)'),
+        image_url: z
+            .string()
+            .max(2000)
+            .optional()
+            .describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
+        meter_reading: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Meter/odometer reading at time of service'),
         meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
     }, async ({ id, ...rest }) => {
         try {
@@ -159,23 +197,54 @@ export function registerWriteTools(server, client) {
     server.tool('create_asset', 'Create a new asset. Requires assets:write scope. IMPORTANT — Location hierarchy: always resolve top-down by calling list_sites first, then list_buildings filtered by site_id, then list_locations filtered by building_id. Provide all three IDs (site_id, building_id, location_id) explicitly. System hierarchy: similarly resolve via list_system_classes → list_system_groups → list_systems.', {
         name: z.string().min(1).max(500).describe('Asset name (required)'),
         description: z.string().optional().describe('Description'),
-        asset_id: z.string().max(100).optional().describe('Custom asset identifier (unique per tenant)'),
+        asset_id: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Custom asset identifier (unique per tenant)'),
         asset_type_id: z.string().uuid().optional().describe('Asset type ID (from asset_types)'),
-        manufacturer_id: z.string().uuid().optional().describe('Manufacturer ID (from manufacturers)'),
+        manufacturer_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Manufacturer ID (from manufacturers)'),
         model: z.string().max(500).optional().describe('Model name/number'),
         serial_number: z.string().max(200).optional().describe('Serial number'),
         purchase_cost: z.number().min(0).optional().describe('Purchase cost'),
         purchase_date: z.string().optional().describe('Purchase date (ISO 8601)'),
         expected_lifetime_years: z.number().min(0).optional().describe('Expected lifetime in years'),
         condition_score: z.number().min(0).max(100).optional().describe('Condition score (0-100)'),
-        risk_factor: z.enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW']).optional().describe('Risk factor (CRITICAL, HIGH, MEDIUM, LOW)'),
+        risk_factor: z
+            .enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'])
+            .optional()
+            .describe('Risk factor (CRITICAL, HIGH, MEDIUM, LOW)'),
         status_id: z.string().max(100).optional().describe('Status identifier'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
-        system_class_id: z.string().uuid().optional().describe('System class ID — resolve first via list_system_classes'),
-        system_group_id: z.string().uuid().optional().describe('System group ID — resolve second via list_system_groups filtered by system_class_id'),
-        system_id: z.string().uuid().optional().describe('System ID — resolve last via list_systems filtered by system_group_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
+        system_class_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('System class ID — resolve first via list_system_classes'),
+        system_group_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('System group ID — resolve second via list_system_groups filtered by system_class_id'),
+        system_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('System ID — resolve last via list_systems filtered by system_group_id'),
         image_url: z.string().max(2000).optional().describe('Image URL'),
         last_maintenance_date: z.string().optional().describe('Last maintenance date (ISO 8601)'),
         quantity: z.number().min(0).optional().describe('Quantity'),
@@ -183,15 +252,49 @@ export function registerWriteTools(server, client) {
         unit_replacement_value: z.number().min(0).optional().describe('Unit replacement value'),
         cost_per_sq_ft: z.number().min(0).optional().describe('Cost per square foot'),
         salvage_value: z.number().min(0).optional().describe('Salvage value'),
-        salvage_value_percentage: z.number().min(0).max(100).optional().describe('Salvage value percentage (0-100)'),
-        consequence_of_failure_score: z.number().int().min(0).optional().describe('Consequence of failure score'),
-        likelihood_of_failure_score: z.number().int().min(0).optional().describe('Likelihood of failure score'),
-        safety_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Safety impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        service_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Service impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        environmental_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Environmental impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        regulatory_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Regulatory impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        reputation_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Reputation impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        current_meter_reading: z.number().min(0).optional().describe('Current meter/odometer reading'),
+        salvage_value_percentage: z
+            .number()
+            .min(0)
+            .max(100)
+            .optional()
+            .describe('Salvage value percentage (0-100)'),
+        consequence_of_failure_score: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Consequence of failure score'),
+        likelihood_of_failure_score: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Likelihood of failure score'),
+        safety_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Safety impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        service_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Service impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        environmental_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Environmental impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        regulatory_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Regulatory impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        reputation_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Reputation impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        current_meter_reading: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Current meter/odometer reading'),
         meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
     }, async (params) => {
         try {
@@ -206,40 +309,105 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Asset ID'),
         name: z.string().min(1).max(500).optional().describe('Asset name'),
         description: z.string().optional().describe('Description'),
-        asset_id: z.string().max(100).optional().describe('Custom asset identifier (unique per tenant)'),
+        asset_id: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Custom asset identifier (unique per tenant)'),
         asset_type_id: z.string().uuid().optional().describe('Asset type ID (from asset_types)'),
-        manufacturer_id: z.string().uuid().optional().describe('Manufacturer ID (from manufacturers)'),
+        manufacturer_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Manufacturer ID (from manufacturers)'),
         model: z.string().max(500).optional().describe('Model name/number'),
         serial_number: z.string().max(200).optional().describe('Serial number'),
         purchase_cost: z.number().min(0).optional().describe('Purchase cost'),
         purchase_date: z.string().optional().describe('Purchase date (ISO 8601)'),
         expected_lifetime_years: z.number().min(0).optional().describe('Expected lifetime in years'),
         condition_score: z.number().min(0).max(100).optional().describe('Condition score (0-100)'),
-        risk_factor: z.enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW']).optional().describe('Risk factor (CRITICAL, HIGH, MEDIUM, LOW)'),
+        risk_factor: z
+            .enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'])
+            .optional()
+            .describe('Risk factor (CRITICAL, HIGH, MEDIUM, LOW)'),
         status_id: z.string().max(100).optional().describe('Status identifier'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
-        system_class_id: z.string().uuid().optional().describe('System class ID — resolve first via list_system_classes'),
-        system_group_id: z.string().uuid().optional().describe('System group ID — resolve second via list_system_groups filtered by system_class_id'),
-        system_id: z.string().uuid().optional().describe('System ID — resolve last via list_systems filtered by system_group_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
+        system_class_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('System class ID — resolve first via list_system_classes'),
+        system_group_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('System group ID — resolve second via list_system_groups filtered by system_class_id'),
+        system_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('System ID — resolve last via list_systems filtered by system_group_id'),
         image_url: z.string().max(2000).optional().describe('Image URL'),
         last_maintenance_date: z.string().optional().describe('Last maintenance date (ISO 8601)'),
-        current_meter_reading: z.number().min(0).optional().describe('Current meter/odometer reading'),
+        current_meter_reading: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Current meter/odometer reading'),
         meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
         quantity: z.number().min(0).optional().describe('Quantity'),
         unit_of_measure: z.string().max(100).optional().describe('Unit of measure'),
         unit_replacement_value: z.number().min(0).optional().describe('Unit replacement value'),
         cost_per_sq_ft: z.number().min(0).optional().describe('Cost per square foot'),
         salvage_value: z.number().min(0).optional().describe('Salvage value'),
-        salvage_value_percentage: z.number().min(0).max(100).optional().describe('Salvage value percentage (0-100)'),
-        consequence_of_failure_score: z.number().int().min(0).optional().describe('Consequence of failure score'),
-        likelihood_of_failure_score: z.number().int().min(0).optional().describe('Likelihood of failure score'),
-        safety_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Safety impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        service_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Service impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        environmental_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Environmental impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        regulatory_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Regulatory impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
-        reputation_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Reputation impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        salvage_value_percentage: z
+            .number()
+            .min(0)
+            .max(100)
+            .optional()
+            .describe('Salvage value percentage (0-100)'),
+        consequence_of_failure_score: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Consequence of failure score'),
+        likelihood_of_failure_score: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Likelihood of failure score'),
+        safety_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Safety impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        service_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Service impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        environmental_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Environmental impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        regulatory_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Regulatory impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        reputation_impact: z
+            .enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'])
+            .optional()
+            .describe('Reputation impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('assets', id, buildBody(rest));
@@ -265,10 +433,21 @@ export function registerWriteTools(server, client) {
         title: z.string().min(1).max(500).describe('Work request title (required)'),
         description: z.string().optional().describe('Description'),
         priority: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Priority level'),
-        status: z.enum(['SUBMITTED', 'APPROVED', 'REJECTED', 'CONVERTED']).optional().describe('Status'),
+        status: z
+            .enum(['SUBMITTED', 'APPROVED', 'REJECTED', 'CONVERTED'])
+            .optional()
+            .describe('Status'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
         system_id: z.string().uuid().optional().describe('System ID'),
         work_category_id: z.string().uuid().optional().describe('Work category ID'),
@@ -286,10 +465,21 @@ export function registerWriteTools(server, client) {
         title: z.string().min(1).max(500).optional().describe('Work request title'),
         description: z.string().optional().describe('Description'),
         priority: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Priority level'),
-        status: z.enum(['SUBMITTED', 'APPROVED', 'REJECTED', 'CONVERTED']).optional().describe('Status'),
+        status: z
+            .enum(['SUBMITTED', 'APPROVED', 'REJECTED', 'CONVERTED'])
+            .optional()
+            .describe('Status'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
         system_id: z.string().uuid().optional().describe('System ID'),
         work_category_id: z.string().uuid().optional().describe('Work category ID'),
@@ -324,8 +514,15 @@ export function registerWriteTools(server, client) {
         state: z.string().max(100).optional().describe('State/province'),
         country: z.string().max(100).optional().describe('Country'),
         status: z.string().max(50).optional().describe('Vendor status'),
-        categories: z.array(z.string().max(100)).optional().describe('Vendor categories (e.g. ["HVAC", "Plumbing"])'),
-        website: z.string().max(500).optional().describe('Website URL (protocol and www prefix are stripped automatically)'),
+        categories: z
+            .array(z.string().max(100))
+            .optional()
+            .describe('Vendor categories (e.g. ["HVAC", "Plumbing"])'),
+        website: z
+            .string()
+            .max(500)
+            .optional()
+            .describe('Website URL (protocol and www prefix are stripped automatically)'),
         description: z.string().optional().describe('Description'),
     }, async (params) => {
         try {
@@ -347,8 +544,15 @@ export function registerWriteTools(server, client) {
         state: z.string().max(100).optional().describe('State/province'),
         country: z.string().max(100).optional().describe('Country'),
         status: z.string().max(50).optional().describe('Vendor status'),
-        categories: z.array(z.string().max(100)).optional().describe('Vendor categories (e.g. ["HVAC", "Plumbing"])'),
-        website: z.string().max(500).optional().describe('Website URL (protocol and www prefix are stripped automatically)'),
+        categories: z
+            .array(z.string().max(100))
+            .optional()
+            .describe('Vendor categories (e.g. ["HVAC", "Plumbing"])'),
+        website: z
+            .string()
+            .max(500)
+            .optional()
+            .describe('Website URL (protocol and www prefix are stripped automatically)'),
         description: z.string().optional().describe('Description'),
     }, async ({ id, ...rest }) => {
         try {
@@ -440,8 +644,18 @@ export function registerWriteTools(server, client) {
         floors: z.number().int().optional().describe('Number of floors'),
         area_sqft: z.number().min(0).optional().describe('Area in square feet'),
         type: z.string().max(100).optional().describe('Building type label'),
-        building_type_id: z.string().uuid().optional().describe('Building type ID (from building_types)'),
-        year_built: z.number().int().min(1800).max(2100).optional().describe('Year the building was constructed'),
+        building_type_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building type ID (from building_types)'),
+        year_built: z
+            .number()
+            .int()
+            .min(1800)
+            .max(2100)
+            .optional()
+            .describe('Year the building was constructed'),
     }, async (params) => {
         try {
             const result = await client.create('buildings', buildBody(params));
@@ -458,8 +672,18 @@ export function registerWriteTools(server, client) {
         floors: z.number().int().optional().describe('Number of floors'),
         area_sqft: z.number().min(0).optional().describe('Area in square feet'),
         type: z.string().max(100).optional().describe('Building type label'),
-        building_type_id: z.string().uuid().optional().describe('Building type ID (from building_types)'),
-        year_built: z.number().int().min(1800).max(2100).optional().describe('Year the building was constructed'),
+        building_type_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building type ID (from building_types)'),
+        year_built: z
+            .number()
+            .int()
+            .min(1800)
+            .max(2100)
+            .optional()
+            .describe('Year the building was constructed'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('buildings', id, buildBody(rest));
@@ -487,7 +711,11 @@ export function registerWriteTools(server, client) {
         floor: z.string().max(50).optional().describe('Floor identifier'),
         area: z.number().min(0).optional().describe('Area (sq ft or sq m)'),
         type: z.string().max(100).optional().describe('Location type label'),
-        location_type_id: z.string().uuid().optional().describe('Location type ID (from location_types)'),
+        location_type_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location type ID (from location_types)'),
     }, async (params) => {
         try {
             const result = await client.create('locations', buildBody(params));
@@ -504,7 +732,11 @@ export function registerWriteTools(server, client) {
         floor: z.string().max(50).optional().describe('Floor identifier'),
         area: z.number().min(0).optional().describe('Area (sq ft or sq m)'),
         type: z.string().max(100).optional().describe('Location type label'),
-        location_type_id: z.string().uuid().optional().describe('Location type ID (from location_types)'),
+        location_type_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location type ID (from location_types)'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('locations', id, buildBody(rest));
@@ -529,14 +761,39 @@ export function registerWriteTools(server, client) {
     server.tool('create_pm_schedule', 'Create a new preventive maintenance schedule. Requires pm_schedules:write scope. IMPORTANT — Location hierarchy: always resolve top-down by calling list_sites first, then list_buildings filtered by site_id, then list_locations filtered by building_id. Provide all three IDs explicitly.', {
         title: z.string().min(1).max(500).describe('PM schedule title (required)'),
         description: z.string().optional().describe('Description'),
-        frequency: z.enum(['DAILY', 'WEEKLY', 'MONTHLY', 'QUARTERLY', 'SEMI_ANNUAL', 'ANNUAL', 'FIVE_YEARLY', 'CUSTOM']).optional().describe('Frequency'),
-        custom_interval_weeks: z.number().int().min(1).optional().describe('Custom interval in weeks (when frequency is CUSTOM)'),
+        frequency: z
+            .enum([
+            'DAILY',
+            'WEEKLY',
+            'MONTHLY',
+            'QUARTERLY',
+            'SEMI_ANNUAL',
+            'ANNUAL',
+            'FIVE_YEARLY',
+            'CUSTOM',
+        ])
+            .optional()
+            .describe('Frequency'),
+        custom_interval_weeks: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Custom interval in weeks (when frequency is CUSTOM)'),
         next_due: z.string().optional().describe('Next due date (ISO 8601)'),
         estimated_hours: z.number().min(0).optional().describe('Estimated hours'),
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
         work_category: z.string().max(200).optional().describe('Work category label'),
         schedule_type: z.string().max(100).optional().describe('Schedule type'),
@@ -546,18 +803,28 @@ export function registerWriteTools(server, client) {
         status: z.enum(['active', 'inactive']).optional().describe('Schedule status'),
         auto_generate_wo: z.boolean().optional().describe('Auto-generate work orders'),
         floating: z.boolean().optional().describe('Floating schedule (due date based on completion)'),
-        meter_based: z.boolean().optional().describe('Whether this PM triggers at meter intervals (e.g. every 5000 km)'),
-        meter_interval: z.number().min(0).optional().describe('Meter interval — trigger every N units'),
+        meter_based: z
+            .boolean()
+            .optional()
+            .describe('Whether this PM triggers at meter intervals (e.g. every 5000 km)'),
+        meter_interval: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Meter interval — trigger every N units'),
         meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         asset_ids: z.array(z.string().uuid()).optional().describe('Array of asset IDs'),
         system_ids: z.array(z.string().uuid()).optional().describe('Array of system IDs'),
         location_ids: z.array(z.string().uuid()).optional().describe('Array of location IDs'),
-        tasks: z.array(z.object({
+        tasks: z
+            .array(z.object({
             id: z.string().describe('Unique task ID (use a random string)'),
             description: z.string().describe('Task description'),
             completed: z.boolean().describe('Whether the task is completed'),
-        })).optional().describe('Checklist of tasks for this PM schedule'),
+        }))
+            .optional()
+            .describe('Checklist of tasks for this PM schedule'),
     }, async (params) => {
         try {
             const result = await client.create('pm-schedules', buildBody(params));
@@ -571,14 +838,39 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('PM schedule ID'),
         title: z.string().min(1).max(500).optional().describe('PM schedule title'),
         description: z.string().optional().describe('Description'),
-        frequency: z.enum(['DAILY', 'WEEKLY', 'MONTHLY', 'QUARTERLY', 'SEMI_ANNUAL', 'ANNUAL', 'FIVE_YEARLY', 'CUSTOM']).optional().describe('Frequency'),
-        custom_interval_weeks: z.number().int().min(1).optional().describe('Custom interval in weeks (when frequency is CUSTOM)'),
+        frequency: z
+            .enum([
+            'DAILY',
+            'WEEKLY',
+            'MONTHLY',
+            'QUARTERLY',
+            'SEMI_ANNUAL',
+            'ANNUAL',
+            'FIVE_YEARLY',
+            'CUSTOM',
+        ])
+            .optional()
+            .describe('Frequency'),
+        custom_interval_weeks: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Custom interval in weeks (when frequency is CUSTOM)'),
         next_due: z.string().optional().describe('Next due date (ISO 8601)'),
         estimated_hours: z.number().min(0).optional().describe('Estimated hours'),
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
-        building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
-        location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building ID — resolve second via list_buildings filtered by site_id'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Location ID — resolve last via list_locations filtered by building_id'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
         work_category: z.string().max(200).optional().describe('Work category label'),
         schedule_type: z.string().max(100).optional().describe('Schedule type'),
@@ -589,17 +881,24 @@ export function registerWriteTools(server, client) {
         auto_generate_wo: z.boolean().optional().describe('Auto-generate work orders'),
         floating: z.boolean().optional().describe('Floating schedule (due date based on completion)'),
         meter_based: z.boolean().optional().describe('Whether this PM triggers at meter intervals'),
-        meter_interval: z.number().min(0).optional().describe('Meter interval — trigger every N units'),
+        meter_interval: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Meter interval — trigger every N units'),
         meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         asset_ids: z.array(z.string().uuid()).optional().describe('Array of asset IDs'),
         system_ids: z.array(z.string().uuid()).optional().describe('Array of system IDs'),
         location_ids: z.array(z.string().uuid()).optional().describe('Array of location IDs'),
-        tasks: z.array(z.object({
+        tasks: z
+            .array(z.object({
             id: z.string().describe('Unique task ID'),
             description: z.string().describe('Task description'),
             completed: z.boolean().describe('Whether the task is completed'),
-        })).optional().describe('Checklist of tasks for this PM schedule'),
+        }))
+            .optional()
+            .describe('Checklist of tasks for this PM schedule'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('pm-schedules', id, buildBody(rest));
@@ -624,27 +923,66 @@ export function registerWriteTools(server, client) {
     server.tool('create_pm_template', 'Create a new PM template. Templates are reusable PM definitions (not linked to a site/asset) that can seed new PM schedules. Requires pm_templates:write scope.', {
         title: z.string().min(1).max(500).describe('PM template title (required, unique per tenant)'),
         description: z.string().optional().describe('Description'),
-        frequency: z.enum(['DAILY', 'WEEKLY', 'MONTHLY', 'QUARTERLY', 'SEMI_ANNUAL', 'ANNUAL', 'FIVE_YEARLY', 'CUSTOM']).optional().describe('Suggested maintenance frequency'),
-        custom_interval_weeks: z.number().int().min(1).optional().describe('Custom interval in weeks (when frequency is CUSTOM)'),
+        frequency: z
+            .enum([
+            'DAILY',
+            'WEEKLY',
+            'MONTHLY',
+            'QUARTERLY',
+            'SEMI_ANNUAL',
+            'ANNUAL',
+            'FIVE_YEARLY',
+            'CUSTOM',
+        ])
+            .optional()
+            .describe('Suggested maintenance frequency'),
+        custom_interval_weeks: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Custom interval in weeks (when frequency is CUSTOM)'),
         work_category: z.string().max(200).optional().describe('Work category label (free text)'),
-        work_category_id: z.string().uuid().optional().describe('Work category ID — resolve via list_work_categories'),
+        work_category_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Work category ID — resolve via list_work_categories'),
         estimated_hours: z.number().min(0).optional().describe('Estimated hours'),
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         safety_requirements: z.string().optional().describe('Safety requirements'),
-        tasks: z.array(z.object({
+        tasks: z
+            .array(z.object({
             id: z.string().optional().describe('Unique task ID (auto-generated if omitted)'),
             description: z.string().describe('Task description'),
-            completed: z.boolean().optional().describe('Whether the task is completed (defaults to false)'),
-        })).optional().describe('Checklist of tasks baked into this template'),
-        resources: z.array(z.object({
+            completed: z
+                .boolean()
+                .optional()
+                .describe('Whether the task is completed (defaults to false)'),
+        }))
+            .optional()
+            .describe('Checklist of tasks baked into this template'),
+        resources: z
+            .array(z.object({
             name: z.string().optional().describe('Resource name'),
-            type: z.enum(PM_RESOURCE_TYPES).optional().describe('Resource type (TOOL, PART, MATERIAL, or EQUIPMENT)'),
+            type: z
+                .enum(PM_RESOURCE_TYPES)
+                .optional()
+                .describe('Resource type (TOOL, PART, MATERIAL, or EQUIPMENT)'),
             quantity: z.number().optional().describe('Quantity required'),
             cost: z.number().optional().describe('Unit cost'),
-        })).optional().describe('Resource references (parts, tools, materials, equipment)'),
+        }))
+            .optional()
+            .describe('Resource references (parts, tools, materials, equipment)'),
         documents: z.array(z.record(z.unknown())).optional().describe('Document references'),
-        asset_ids: z.array(z.string().uuid()).optional().describe('Default asset IDs to seed on derived schedules'),
-        location_ids: z.array(z.string().uuid()).optional().describe('Default location IDs to seed on derived schedules'),
+        asset_ids: z
+            .array(z.string().uuid())
+            .optional()
+            .describe('Default asset IDs to seed on derived schedules'),
+        location_ids: z
+            .array(z.string().uuid())
+            .optional()
+            .describe('Default location IDs to seed on derived schedules'),
     }, async (params) => {
         try {
             const result = await client.create('pm-templates', buildBody(normalizePmTemplateBody(params)));
@@ -658,24 +996,53 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('PM template ID'),
         title: z.string().min(1).max(500).optional().describe('PM template title'),
         description: z.string().optional().describe('Description'),
-        frequency: z.enum(['DAILY', 'WEEKLY', 'MONTHLY', 'QUARTERLY', 'SEMI_ANNUAL', 'ANNUAL', 'FIVE_YEARLY', 'CUSTOM']).optional().describe('Suggested maintenance frequency'),
-        custom_interval_weeks: z.number().int().min(1).optional().describe('Custom interval in weeks (when frequency is CUSTOM)'),
+        frequency: z
+            .enum([
+            'DAILY',
+            'WEEKLY',
+            'MONTHLY',
+            'QUARTERLY',
+            'SEMI_ANNUAL',
+            'ANNUAL',
+            'FIVE_YEARLY',
+            'CUSTOM',
+        ])
+            .optional()
+            .describe('Suggested maintenance frequency'),
+        custom_interval_weeks: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Custom interval in weeks (when frequency is CUSTOM)'),
         work_category: z.string().max(200).optional().describe('Work category label (free text)'),
         work_category_id: z.string().uuid().optional().describe('Work category ID'),
         estimated_hours: z.number().min(0).optional().describe('Estimated hours'),
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         safety_requirements: z.string().optional().describe('Safety requirements'),
-        tasks: z.array(z.object({
+        tasks: z
+            .array(z.object({
             id: z.string().optional().describe('Unique task ID (auto-generated if omitted)'),
             description: z.string().describe('Task description'),
-            completed: z.boolean().optional().describe('Whether the task is completed (defaults to false)'),
-        })).optional().describe('Checklist of tasks baked into this template'),
-        resources: z.array(z.object({
+            completed: z
+                .boolean()
+                .optional()
+                .describe('Whether the task is completed (defaults to false)'),
+        }))
+            .optional()
+            .describe('Checklist of tasks baked into this template'),
+        resources: z
+            .array(z.object({
             name: z.string().optional().describe('Resource name'),
-            type: z.enum(PM_RESOURCE_TYPES).optional().describe('Resource type (TOOL, PART, MATERIAL, or EQUIPMENT)'),
+            type: z
+                .enum(PM_RESOURCE_TYPES)
+                .optional()
+                .describe('Resource type (TOOL, PART, MATERIAL, or EQUIPMENT)'),
             quantity: z.number().optional().describe('Quantity required'),
             cost: z.number().optional().describe('Unit cost'),
-        })).optional().describe('Resource references (parts, tools, materials, equipment)'),
+        }))
+            .optional()
+            .describe('Resource references (parts, tools, materials, equipment)'),
         documents: z.array(z.record(z.unknown())).optional().describe('Document references'),
         asset_ids: z.array(z.string().uuid()).optional().describe('Default asset IDs'),
         location_ids: z.array(z.string().uuid()).optional().describe('Default location IDs'),
@@ -705,16 +1072,42 @@ export function registerWriteTools(server, client) {
         status: z.string().max(100).describe('Project status (required)'),
         start_date: z.string().describe('Start date (ISO 8601, required)'),
         project_code: z.string().max(100).optional().describe('Project code'),
-        project_type: z.enum(['capital', 'maintenance', 'repair', 'upgrade', 'new_construction', 'renovation', 'deferred_maintenance', 'other']).optional().describe('Project type'),
+        project_type: z
+            .enum([
+            'capital',
+            'maintenance',
+            'repair',
+            'upgrade',
+            'new_construction',
+            'renovation',
+            'deferred_maintenance',
+            'other',
+        ])
+            .optional()
+            .describe('Project type'),
         current_phase: z.string().max(100).optional().describe('Current phase'),
         description: z.string().optional().describe('Description'),
         end_date: z.string().optional().describe('End date (ISO 8601)'),
         budget: z.number().min(0).optional().describe('Total budget'),
         project_manager: z.string().max(200).optional().describe('Project manager name'),
-        progress_percentage: z.number().min(0).max(100).optional().describe('Progress percentage (0-100)'),
-        health_status: z.enum(['on_track', 'at_risk', 'delayed', 'critical']).optional().describe('Health status'),
-        budget_status: z.enum(['off_track', 'on_track', 'not_set', 'monitor']).optional().describe('Budget status'),
-        progress_status: z.enum(['off_track', 'on_track', 'monitor']).optional().describe('Progress status'),
+        progress_percentage: z
+            .number()
+            .min(0)
+            .max(100)
+            .optional()
+            .describe('Progress percentage (0-100)'),
+        health_status: z
+            .enum(['on_track', 'at_risk', 'delayed', 'critical'])
+            .optional()
+            .describe('Health status'),
+        budget_status: z
+            .enum(['off_track', 'on_track', 'not_set', 'monitor'])
+            .optional()
+            .describe('Budget status'),
+        progress_status: z
+            .enum(['off_track', 'on_track', 'monitor'])
+            .optional()
+            .describe('Progress status'),
         image_url: z.string().max(2000).optional().describe('Image URL'),
     }, async (params) => {
         try {
@@ -731,16 +1124,42 @@ export function registerWriteTools(server, client) {
         status: z.string().max(100).optional().describe('Project status'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         project_code: z.string().max(100).optional().describe('Project code'),
-        project_type: z.enum(['capital', 'maintenance', 'repair', 'upgrade', 'new_construction', 'renovation', 'deferred_maintenance', 'other']).optional().describe('Project type'),
+        project_type: z
+            .enum([
+            'capital',
+            'maintenance',
+            'repair',
+            'upgrade',
+            'new_construction',
+            'renovation',
+            'deferred_maintenance',
+            'other',
+        ])
+            .optional()
+            .describe('Project type'),
         current_phase: z.string().max(100).optional().describe('Current phase'),
         description: z.string().optional().describe('Description'),
         end_date: z.string().optional().describe('End date (ISO 8601)'),
         budget: z.number().min(0).optional().describe('Total budget'),
         project_manager: z.string().max(200).optional().describe('Project manager name'),
-        progress_percentage: z.number().min(0).max(100).optional().describe('Progress percentage (0-100)'),
-        health_status: z.enum(['on_track', 'at_risk', 'delayed', 'critical']).optional().describe('Health status'),
-        budget_status: z.enum(['off_track', 'on_track', 'not_set', 'monitor']).optional().describe('Budget status'),
-        progress_status: z.enum(['off_track', 'on_track', 'monitor']).optional().describe('Progress status'),
+        progress_percentage: z
+            .number()
+            .min(0)
+            .max(100)
+            .optional()
+            .describe('Progress percentage (0-100)'),
+        health_status: z
+            .enum(['on_track', 'at_risk', 'delayed', 'critical'])
+            .optional()
+            .describe('Health status'),
+        budget_status: z
+            .enum(['off_track', 'on_track', 'not_set', 'monitor'])
+            .optional()
+            .describe('Budget status'),
+        progress_status: z
+            .enum(['off_track', 'on_track', 'monitor'])
+            .optional()
+            .describe('Progress status'),
         image_url: z.string().max(2000).optional().describe('Image URL'),
     }, async ({ id, ...rest }) => {
         try {
@@ -824,7 +1243,10 @@ export function registerWriteTools(server, client) {
         tax_amount: z.number().min(0).optional().describe('Tax amount'),
         due_date: z.string().optional().describe('Due date (ISO 8601)'),
         paid_date: z.string().optional().describe('Paid date (ISO 8601)'),
-        status: z.enum(['pending', 'approved', 'paid', 'voided']).optional().describe('Invoice status'),
+        status: z
+            .enum(['pending', 'approved', 'paid', 'voided'])
+            .optional()
+            .describe('Invoice status'),
         notes: z.string().optional().describe('Notes'),
         project_id: z.string().uuid().optional().describe('Project ID'),
         work_order_id: z.string().uuid().optional().describe('Work order ID'),
@@ -849,7 +1271,10 @@ export function registerWriteTools(server, client) {
         tax_amount: z.number().min(0).optional().describe('Tax amount'),
         due_date: z.string().optional().describe('Due date (ISO 8601)'),
         paid_date: z.string().optional().describe('Paid date (ISO 8601)'),
-        status: z.enum(['pending', 'approved', 'paid', 'voided']).optional().describe('Invoice status'),
+        status: z
+            .enum(['pending', 'approved', 'paid', 'voided'])
+            .optional()
+            .describe('Invoice status'),
         notes: z.string().optional().describe('Notes'),
         project_id: z.string().uuid().optional().describe('Project ID'),
         work_order_id: z.string().uuid().optional().describe('Work order ID'),
@@ -881,7 +1306,10 @@ export function registerWriteTools(server, client) {
         po_number: z.string().min(1).max(200).describe('PO number (required)'),
         amount: z.number().min(0).describe('PO amount (required)'),
         description: z.string().optional().describe('Description'),
-        status: z.enum(['draft', 'issued', 'partially_received', 'received', 'closed', 'cancelled']).optional().describe('PO status'),
+        status: z
+            .enum(['draft', 'issued', 'partially_received', 'received', 'closed', 'cancelled'])
+            .optional()
+            .describe('PO status'),
         issued_date: z.string().optional().describe('Issued date (ISO 8601)'),
         expected_date: z.string().optional().describe('Expected delivery date (ISO 8601)'),
         notes: z.string().optional().describe('Notes'),
@@ -903,7 +1331,10 @@ export function registerWriteTools(server, client) {
         po_number: z.string().min(1).max(200).optional().describe('PO number'),
         amount: z.number().min(0).optional().describe('PO amount'),
         description: z.string().optional().describe('Description'),
-        status: z.enum(['draft', 'issued', 'partially_received', 'received', 'closed', 'cancelled']).optional().describe('PO status'),
+        status: z
+            .enum(['draft', 'issued', 'partially_received', 'received', 'closed', 'cancelled'])
+            .optional()
+            .describe('PO status'),
         issued_date: z.string().optional().describe('Issued date (ISO 8601)'),
         expected_date: z.string().optional().describe('Expected delivery date (ISO 8601)'),
         notes: z.string().optional().describe('Notes'),
@@ -1037,7 +1468,10 @@ export function registerWriteTools(server, client) {
     server.tool('create_project_document_folder_template', 'Create a project document folder template. Requires project_document_folder_templates:write scope.', {
         name: z.string().min(1).max(500).describe('Template name (required)'),
         description: z.string().max(2000).optional().describe('Template description'),
-        structure: z.array(z.record(z.string(), z.unknown())).optional().describe('Folder hierarchy as JSON array'),
+        structure: z
+            .array(z.record(z.string(), z.unknown()))
+            .optional()
+            .describe('Folder hierarchy as JSON array'),
         is_default: z.boolean().optional().describe('Whether this is the default template'),
     }, async (params) => {
         try {
@@ -1052,7 +1486,10 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Template ID'),
         name: z.string().min(1).max(500).optional().describe('Template name'),
         description: z.string().max(2000).optional().describe('Template description'),
-        structure: z.array(z.record(z.string(), z.unknown())).optional().describe('Folder hierarchy as JSON array'),
+        structure: z
+            .array(z.record(z.string(), z.unknown()))
+            .optional()
+            .describe('Folder hierarchy as JSON array'),
         is_default: z.boolean().optional().describe('Whether this is the default template'),
     }, async ({ id, ...rest }) => {
         try {
@@ -1125,7 +1562,6 @@ export function registerWriteTools(server, client) {
     server.tool('create_asset_comment', 'Create a new comment on an asset. Requires asset_comments:write scope.', {
         asset_id: z.string().uuid().describe('Asset ID (required)'),
         comment: z.string().min(1).describe('Comment text (required)'),
-        user_id: z.string().max(200).optional().describe('User ID of commenter'),
     }, async (params) => {
         try {
             const result = await client.create('asset-comments', buildBody(params));
@@ -1138,7 +1574,6 @@ export function registerWriteTools(server, client) {
     server.tool('update_asset_comment', 'Update an existing asset comment by ID. Requires asset_comments:write scope.', {
         id: z.string().uuid().describe('Asset comment ID'),
         comment: z.string().min(1).optional().describe('Comment text'),
-        user_id: z.string().max(200).optional().describe('User ID of commenter'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('asset-comments', id, buildBody(rest));
@@ -1163,7 +1598,6 @@ export function registerWriteTools(server, client) {
     server.tool('create_work_order_comment', 'Create a new comment on a work order. Requires work_order_comments:write scope.', {
         work_order_id: z.string().uuid().describe('Work order ID (required)'),
         comment: z.string().min(1).describe('Comment text (required)'),
-        user_id: z.string().max(200).optional().describe('User ID of commenter'),
     }, async (params) => {
         try {
             const result = await client.create('work-order-comments', buildBody(params));
@@ -1176,7 +1610,6 @@ export function registerWriteTools(server, client) {
     server.tool('update_work_order_comment', 'Update an existing work order comment by ID. Requires work_order_comments:write scope.', {
         id: z.string().uuid().describe('Work order comment ID'),
         comment: z.string().min(1).optional().describe('Comment text'),
-        user_id: z.string().max(200).optional().describe('User ID of commenter'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('work-order-comments', id, buildBody(rest));
@@ -1202,7 +1635,6 @@ export function registerWriteTools(server, client) {
         project_id: z.string().uuid().describe('Project ID (required)'),
         content: z.string().min(1).describe('Comment content (required)'),
         parent_id: z.string().uuid().optional().describe('Parent comment ID (for threading)'),
-        user_id: z.string().max(200).optional().describe('User ID of commenter'),
     }, async (params) => {
         try {
             const result = await client.create('project-comments', buildBody(params));
@@ -1216,7 +1648,6 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Project comment ID'),
         content: z.string().min(1).optional().describe('Comment content'),
         parent_id: z.string().uuid().optional().describe('Parent comment ID'),
-        user_id: z.string().max(200).optional().describe('User ID of commenter'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('project-comments', id, buildBody(rest));
@@ -1238,8 +1669,10 @@ export function registerWriteTools(server, client) {
     // ============================================================
     // 18. Asset Costs (scope: asset_costs)
     // ============================================================
-    server.tool('create_asset_cost', 'Create a new asset cost entry. Requires asset_costs:write scope.', {
-        category: z.enum(['Repair', 'PM', 'Operation', 'Replacement', 'Decommission', 'Other']).describe('Cost category (required)'),
+    server.tool('create_asset_cost', 'Create a new asset cost entry — the record type shown on the AssetLab "Expenses" page. Requires asset_costs:write scope.', {
+        category: z
+            .enum(['Repair', 'PM', 'Operation', 'Replacement', 'Decommission', 'Other'])
+            .describe('Cost category (required)'),
         amount: z.number().min(0).describe('Cost amount (required)'),
         cost_date: z.string().describe('Cost date (ISO 8601, required)'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
@@ -1247,6 +1680,8 @@ export function registerWriteTools(server, client) {
         building_id: z.string().uuid().optional().describe('Building ID'),
         work_order_id: z.string().uuid().optional().describe('Work order ID'),
         description: z.string().optional().describe('Description'),
+        invoice_number: z.string().max(200).optional().describe('Invoice number (free text)'),
+        po_number: z.string().max(200).optional().describe('Purchase order number (free text)'),
     }, async (params) => {
         try {
             const result = await client.create('asset-costs', buildBody(params));
@@ -1256,9 +1691,12 @@ export function registerWriteTools(server, client) {
             return formatError(err);
         }
     });
-    server.tool('update_asset_cost', 'Update an existing asset cost entry by ID. Requires asset_costs:write scope.', {
+    server.tool('update_asset_cost', 'Update an existing asset cost entry by ID — the record type shown on the AssetLab "Expenses" page. Requires asset_costs:write scope.', {
         id: z.string().uuid().describe('Asset cost ID'),
-        category: z.enum(['Repair', 'PM', 'Operation', 'Replacement', 'Decommission', 'Other']).optional().describe('Cost category'),
+        category: z
+            .enum(['Repair', 'PM', 'Operation', 'Replacement', 'Decommission', 'Other'])
+            .optional()
+            .describe('Cost category'),
         amount: z.number().min(0).optional().describe('Cost amount'),
         cost_date: z.string().optional().describe('Cost date (ISO 8601)'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
@@ -1266,6 +1704,8 @@ export function registerWriteTools(server, client) {
         building_id: z.string().uuid().optional().describe('Building ID'),
         work_order_id: z.string().uuid().optional().describe('Work order ID'),
         description: z.string().optional().describe('Description'),
+        invoice_number: z.string().max(200).optional().describe('Invoice number (free text)'),
+        po_number: z.string().max(200).optional().describe('Purchase order number (free text)'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('asset-costs', id, buildBody(rest));
@@ -1289,10 +1729,18 @@ export function registerWriteTools(server, client) {
     // ============================================================
     server.tool('create_asset_replacement_plan', 'Create a new asset replacement plan. Requires asset_replacement_plans:write scope.', {
         asset_id: z.string().uuid().describe('Asset ID (required)'),
-        planned_replacement_year: z.number().int().min(2000).max(2100).describe('Planned replacement year (required)'),
+        planned_replacement_year: z
+            .number()
+            .int()
+            .min(2000)
+            .max(2100)
+            .describe('Planned replacement year (required)'),
         estimated_cost: z.number().min(0).optional().describe('Estimated replacement cost'),
         priority: z.enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW']).optional().describe('Priority'),
-        status: z.enum(['PLANNED', 'BUDGETED', 'APPROVED', 'COMPLETED', 'CANCELLED']).optional().describe('Status'),
+        status: z
+            .enum(['PLANNED', 'BUDGETED', 'APPROVED', 'COMPLETED', 'CANCELLED'])
+            .optional()
+            .describe('Status'),
         notes: z.string().optional().describe('Notes'),
         funding_source: z.string().max(200).optional().describe('Funding source'),
     }, async (params) => {
@@ -1307,10 +1755,19 @@ export function registerWriteTools(server, client) {
     server.tool('update_asset_replacement_plan', 'Update an existing asset replacement plan by ID. Requires asset_replacement_plans:write scope.', {
         id: z.string().uuid().describe('Asset replacement plan ID'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
-        planned_replacement_year: z.number().int().min(2000).max(2100).optional().describe('Planned replacement year'),
+        planned_replacement_year: z
+            .number()
+            .int()
+            .min(2000)
+            .max(2100)
+            .optional()
+            .describe('Planned replacement year'),
         estimated_cost: z.number().min(0).optional().describe('Estimated replacement cost'),
         priority: z.enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW']).optional().describe('Priority'),
-        status: z.enum(['PLANNED', 'BUDGETED', 'APPROVED', 'COMPLETED', 'CANCELLED']).optional().describe('Status'),
+        status: z
+            .enum(['PLANNED', 'BUDGETED', 'APPROVED', 'COMPLETED', 'CANCELLED'])
+            .optional()
+            .describe('Status'),
         notes: z.string().optional().describe('Notes'),
         funding_source: z.string().max(200).optional().describe('Funding source'),
     }, async ({ id, ...rest }) => {
@@ -1339,7 +1796,10 @@ export function registerWriteTools(server, client) {
         title: z.string().min(1).max(500).describe('Task title (required)'),
         description: z.string().optional().describe('Description'),
         phase_id: z.string().uuid().optional().describe('Phase ID'),
-        status: z.enum(['todo', 'in_progress', 'completed', 'blocked', 'cancelled']).optional().describe('Task status'),
+        status: z
+            .enum(['todo', 'in_progress', 'completed', 'blocked', 'cancelled'])
+            .optional()
+            .describe('Task status'),
         priority: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Priority'),
         assigned_to: z.string().max(200).optional().describe('Assigned user'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
@@ -1361,7 +1821,10 @@ export function registerWriteTools(server, client) {
         title: z.string().min(1).max(500).optional().describe('Task title'),
         description: z.string().optional().describe('Description'),
         phase_id: z.string().uuid().optional().describe('Phase ID'),
-        status: z.enum(['todo', 'in_progress', 'completed', 'blocked', 'cancelled']).optional().describe('Task status'),
+        status: z
+            .enum(['todo', 'in_progress', 'completed', 'blocked', 'cancelled'])
+            .optional()
+            .describe('Task status'),
         priority: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Priority'),
         assigned_to: z.string().max(200).optional().describe('Assigned user'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
@@ -1394,7 +1857,10 @@ export function registerWriteTools(server, client) {
         name: z.string().min(1).max(500).describe('Milestone name (required)'),
         due_date: z.string().describe('Due date (ISO 8601, required)'),
         description: z.string().optional().describe('Description'),
-        status: z.enum(['pending', 'completed', 'missed', 'at_risk']).optional().describe('Milestone status'),
+        status: z
+            .enum(['pending', 'completed', 'missed', 'at_risk'])
+            .optional()
+            .describe('Milestone status'),
         completed_date: z.string().optional().describe('Completed date (ISO 8601)'),
     }, async (params) => {
         try {
@@ -1411,7 +1877,10 @@ export function registerWriteTools(server, client) {
         name: z.string().min(1).max(500).optional().describe('Milestone name'),
         due_date: z.string().optional().describe('Due date (ISO 8601)'),
         description: z.string().optional().describe('Description'),
-        status: z.enum(['pending', 'completed', 'missed', 'at_risk']).optional().describe('Milestone status'),
+        status: z
+            .enum(['pending', 'completed', 'missed', 'at_risk'])
+            .optional()
+            .describe('Milestone status'),
         completed_date: z.string().optional().describe('Completed date (ISO 8601)'),
     }, async ({ id, ...rest }) => {
         try {
@@ -1438,7 +1907,10 @@ export function registerWriteTools(server, client) {
         project_id: z.string().uuid().describe('Project ID (required)'),
         name: z.string().min(1).max(500).describe('Phase name (required)'),
         description: z.string().optional().describe('Description'),
-        status: z.enum(['pending', 'in_progress', 'completed', 'skipped']).optional().describe('Phase status'),
+        status: z
+            .enum(['pending', 'in_progress', 'completed', 'skipped'])
+            .optional()
+            .describe('Phase status'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         end_date: z.string().optional().describe('End date (ISO 8601)'),
         sort_order: z.number().int().min(0).optional().describe('Sort order'),
@@ -1456,7 +1928,10 @@ export function registerWriteTools(server, client) {
         project_id: z.string().uuid().optional().describe('Project ID'),
         name: z.string().min(1).max(500).optional().describe('Phase name'),
         description: z.string().optional().describe('Description'),
-        status: z.enum(['pending', 'in_progress', 'completed', 'skipped']).optional().describe('Phase status'),
+        status: z
+            .enum(['pending', 'in_progress', 'completed', 'skipped'])
+            .optional()
+            .describe('Phase status'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         end_date: z.string().optional().describe('End date (ISO 8601)'),
         sort_order: z.number().int().min(0).optional().describe('Sort order'),
@@ -1483,7 +1958,17 @@ export function registerWriteTools(server, client) {
     // ============================================================
     server.tool('create_project_budget_item', 'Create a new project budget item. Requires project_budget_items:write scope.', {
         project_id: z.string().uuid().describe('Project ID (required)'),
-        category: z.enum(['labor', 'materials', 'equipment', 'subcontractors', 'permits', 'contingency', 'other']).describe('Budget category (required)'),
+        category: z
+            .enum([
+            'labor',
+            'materials',
+            'equipment',
+            'subcontractors',
+            'permits',
+            'contingency',
+            'other',
+        ])
+            .describe('Budget category (required)'),
         description: z.string().optional().describe('Description'),
         estimated_amount: z.number().min(0).optional().describe('Estimated amount'),
         actual_amount: z.number().min(0).optional().describe('Actual amount'),
@@ -1499,7 +1984,18 @@ export function registerWriteTools(server, client) {
     server.tool('update_project_budget_item', 'Update an existing project budget item by ID. Requires project_budget_items:write scope.', {
         id: z.string().uuid().describe('Project budget item ID'),
         project_id: z.string().uuid().optional().describe('Project ID'),
-        category: z.enum(['labor', 'materials', 'equipment', 'subcontractors', 'permits', 'contingency', 'other']).optional().describe('Budget category'),
+        category: z
+            .enum([
+            'labor',
+            'materials',
+            'equipment',
+            'subcontractors',
+            'permits',
+            'contingency',
+            'other',
+        ])
+            .optional()
+            .describe('Budget category'),
         description: z.string().optional().describe('Description'),
         estimated_amount: z.number().min(0).optional().describe('Estimated amount'),
         actual_amount: z.number().min(0).optional().describe('Actual amount'),
@@ -1810,7 +2306,13 @@ export function registerWriteTools(server, client) {
     server.tool('create_project_phase_category', 'Create a new project phase category. Requires project_phase_categories:write scope.', {
         name: z.string().min(1).max(500).describe('Phase name (required), e.g. "Planning", "Design"'),
         description: z.string().max(2000).optional().describe('Description of the phase'),
-        sort_order: z.number().int().min(0).max(10000).optional().describe('Display order (lower = first)'),
+        sort_order: z
+            .number()
+            .int()
+            .min(0)
+            .max(10000)
+            .optional()
+            .describe('Display order (lower = first)'),
     }, async (params) => {
         try {
             const result = await client.create('project-phase-categories', buildBody(params));
@@ -1824,7 +2326,13 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Project phase category ID'),
         name: z.string().min(1).max(500).optional().describe('Phase name'),
         description: z.string().max(2000).optional().describe('Description'),
-        sort_order: z.number().int().min(0).max(10000).optional().describe('Display order (lower = first)'),
+        sort_order: z
+            .number()
+            .int()
+            .min(0)
+            .max(10000)
+            .optional()
+            .describe('Display order (lower = first)'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('project-phase-categories', id, buildBody(rest));
@@ -2129,9 +2637,15 @@ export function registerWriteTools(server, client) {
     // 35. Custom Field Definitions (scope: custom_fields)
     // ============================================================
     server.tool('create_custom_field_definition', 'Create a new custom field definition. Requires custom_fields:write scope.', {
-        entity_type: z.string().min(1).max(100).describe('Entity type this field applies to (required)'),
+        entity_type: z
+            .string()
+            .min(1)
+            .max(100)
+            .describe('Entity type this field applies to (required)'),
         field_name: z.string().min(1).max(200).describe('Field name / key (required)'),
-        field_type: z.enum(['text', 'number', 'date', 'boolean', 'select']).describe('Field data type (required)'),
+        field_type: z
+            .enum(['text', 'number', 'date', 'boolean', 'select'])
+            .describe('Field data type (required)'),
         field_label: z.string().max(200).optional().describe('Display label'),
         options: z.array(z.string()).optional().describe('Options for select-type fields'),
         is_required: z.boolean().optional().describe('Whether the field is required'),
@@ -2149,7 +2663,10 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Custom field definition ID'),
         entity_type: z.string().min(1).max(100).optional().describe('Entity type'),
         field_name: z.string().min(1).max(200).optional().describe('Field name / key'),
-        field_type: z.enum(['text', 'number', 'date', 'boolean', 'select']).optional().describe('Field data type'),
+        field_type: z
+            .enum(['text', 'number', 'date', 'boolean', 'select'])
+            .optional()
+            .describe('Field data type'),
         field_label: z.string().max(200).optional().describe('Display label'),
         options: z.array(z.string()).optional().describe('Options for select-type fields'),
         is_required: z.boolean().optional().describe('Whether the field is required'),
@@ -2175,14 +2692,38 @@ export function registerWriteTools(server, client) {
     // ============================================================
     // 36. Custom Field Values (scope: custom_fields)
     // ============================================================
-    server.tool('create_custom_field_value', 'Create (upsert) a custom field value for an entity. The table stores values in typed columns — prefer setting the one that matches the field definition\'s field_type: value_text (text/select), value_number (number), value_date (date, ISO YYYY-MM-DD), value_boolean (boolean). Alternatively pass a single `value` string and the server will dispatch it to the right column based on field_type. Writes upsert on (entity_id, field_definition_id) so replaying a batch is idempotent. Requires custom_fields:write scope.', {
+    server.tool('create_custom_field_value', "Create (upsert) a custom field value for an entity. The table stores values in typed columns — prefer setting the one that matches the field definition's field_type: value_text (text/select), value_number (number), value_date (date, ISO YYYY-MM-DD), value_boolean (boolean). Alternatively pass a single `value` string and the server will dispatch it to the right column based on field_type. Writes upsert on (entity_id, field_definition_id) so replaying a batch is idempotent. Requires custom_fields:write scope.", {
         entity_id: z.string().uuid().describe('Entity ID — e.g. asset.id, work_order.id (required)'),
-        field_definition_id: z.string().uuid().describe('Custom field definition ID — resolve via list_custom_field_definitions (required)'),
-        value_text: z.string().max(5000).nullable().optional().describe('Text value (use for field_type=text or select)'),
-        value_number: z.number().nullable().optional().describe('Numeric value (use for field_type=number)'),
-        value_date: z.string().nullable().optional().describe('Date value, ISO YYYY-MM-DD (use for field_type=date)'),
-        value_boolean: z.boolean().nullable().optional().describe('Boolean value (use for field_type=boolean)'),
-        value: z.string().max(5000).optional().describe('Legacy single-value shim — server dispatches to the correct typed column based on the field definition\'s field_type. Ignored if any value_* typed column is set.'),
+        field_definition_id: z
+            .string()
+            .uuid()
+            .describe('Custom field definition ID — resolve via list_custom_field_definitions (required)'),
+        value_text: z
+            .string()
+            .max(5000)
+            .nullable()
+            .optional()
+            .describe('Text value (use for field_type=text or select)'),
+        value_number: z
+            .number()
+            .nullable()
+            .optional()
+            .describe('Numeric value (use for field_type=number)'),
+        value_date: z
+            .string()
+            .nullable()
+            .optional()
+            .describe('Date value, ISO YYYY-MM-DD (use for field_type=date)'),
+        value_boolean: z
+            .boolean()
+            .nullable()
+            .optional()
+            .describe('Boolean value (use for field_type=boolean)'),
+        value: z
+            .string()
+            .max(5000)
+            .optional()
+            .describe("Legacy single-value shim — server dispatches to the correct typed column based on the field definition's field_type. Ignored if any value_* typed column is set."),
     }, async (params) => {
         try {
             const result = await client.create('custom-field-values', buildBody(params));
@@ -2192,15 +2733,23 @@ export function registerWriteTools(server, client) {
             return formatError(err);
         }
     });
-    server.tool('update_custom_field_value', 'Update an existing custom field value by ID. Set whichever typed column matches the definition\'s field_type (value_text / value_number / value_date / value_boolean), or pass a single `value` and the server will dispatch it. Requires custom_fields:write scope.', {
+    server.tool('update_custom_field_value', "Update an existing custom field value by ID. Set whichever typed column matches the definition's field_type (value_text / value_number / value_date / value_boolean), or pass a single `value` and the server will dispatch it. Requires custom_fields:write scope.", {
         id: z.string().uuid().describe('Custom field value ID'),
         entity_id: z.string().uuid().optional().describe('Entity ID'),
-        field_definition_id: z.string().uuid().optional().describe('Custom field definition ID — required when using the `value` fallback if you want to avoid the server fetching it'),
+        field_definition_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Custom field definition ID — required when using the `value` fallback if you want to avoid the server fetching it'),
         value_text: z.string().max(5000).nullable().optional().describe('Text value'),
         value_number: z.number().nullable().optional().describe('Numeric value'),
         value_date: z.string().nullable().optional().describe('Date value, ISO YYYY-MM-DD'),
         value_boolean: z.boolean().nullable().optional().describe('Boolean value'),
-        value: z.string().max(5000).optional().describe('Legacy single-value shim — server dispatches based on field_type'),
+        value: z
+            .string()
+            .max(5000)
+            .optional()
+            .describe('Legacy single-value shim — server dispatches based on field_type'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('custom-field-values', id, buildBody(rest));
@@ -2226,11 +2775,27 @@ export function registerWriteTools(server, client) {
         name: z.string().min(1).max(500).describe('Part name (required)'),
         part_number: z.string().max(200).optional().describe('Part number / SKU'),
         category: z.string().max(200).optional().describe('Category label'),
-        supplier: z.string().max(500).optional().describe('DEPRECATED — legacy free-text supplier name. Use supplier_id instead.'),
+        supplier: z
+            .string()
+            .max(500)
+            .optional()
+            .describe('DEPRECATED — legacy free-text supplier name. Use supplier_id instead.'),
         supplier_id: z.string().uuid().optional().describe('Vendor ID (resolve via list_vendors)'),
         cost: z.number().min(0).optional().describe('Unit cost'),
-        quantity: z.number().int().min(0).max(10_000_000).optional().describe('Current stock quantity'),
-        desired_quantity: z.number().int().min(0).max(10_000_000).optional().describe('Target / reorder quantity'),
+        quantity: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000_000)
+            .optional()
+            .describe('Current stock quantity'),
+        desired_quantity: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000_000)
+            .optional()
+            .describe('Target / reorder quantity'),
         specific_location: z.string().max(500).optional().describe('Storage location description'),
         site_id: z.string().uuid().optional().describe('Site ID'),
         building_id: z.string().uuid().optional().describe('Building ID'),
@@ -2249,11 +2814,27 @@ export function registerWriteTools(server, client) {
         name: z.string().min(1).max(500).optional().describe('Part name'),
         part_number: z.string().max(200).optional().describe('Part number / SKU'),
         category: z.string().max(200).optional().describe('Category label'),
-        supplier: z.string().max(500).optional().describe('DEPRECATED — legacy free-text supplier name. Use supplier_id instead.'),
+        supplier: z
+            .string()
+            .max(500)
+            .optional()
+            .describe('DEPRECATED — legacy free-text supplier name. Use supplier_id instead.'),
         supplier_id: z.string().uuid().optional().describe('Vendor ID (resolve via list_vendors)'),
         cost: z.number().min(0).optional().describe('Unit cost'),
-        quantity: z.number().int().min(0).max(10_000_000).optional().describe('Current stock quantity'),
-        desired_quantity: z.number().int().min(0).max(10_000_000).optional().describe('Target / reorder quantity'),
+        quantity: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000_000)
+            .optional()
+            .describe('Current stock quantity'),
+        desired_quantity: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000_000)
+            .optional()
+            .describe('Target / reorder quantity'),
         specific_location: z.string().max(500).optional().describe('Storage location description'),
         site_id: z.string().uuid().optional().describe('Site ID'),
         building_id: z.string().uuid().optional().describe('Building ID'),
@@ -2280,7 +2861,15 @@ export function registerWriteTools(server, client) {
     // Upload URLs
     // ============================================================
     server.tool('create_upload_url', 'Generate a signed upload URL for uploading a file to AssetLab storage. Returns a signed_url to PUT the file to, a public_url for referencing, and the path. IMPORTANT — When a user wants to upload a file, always clarify the target. File upload paths: (1) Asset IMAGE: bucket "asset-images" → update_asset with image_url. (2) Asset DOCUMENT (O&M, warranty, spec): bucket "documents" → create_asset_document. (3) Work order IMAGE: bucket "attachments" → update_work_order with image_url. (4) Work order/request/PM ATTACHMENT: bucket "attachments" → create_attachment with the parent ID. (5) Project DOCUMENT: bucket "project-documents" → create_project_document. (6) Contract DOCUMENT: bucket "contract-documents" → create_contract_document. Always ask the user which type they mean if ambiguous. Requires upload_urls:write scope.', {
-        bucket: z.enum(['documents', 'attachments', 'project-documents', 'contract-documents', 'asset-images']).describe('Storage bucket (required). Use "asset-images" for asset photos.'),
+        bucket: z
+            .enum([
+            'documents',
+            'attachments',
+            'project-documents',
+            'contract-documents',
+            'asset-images',
+        ])
+            .describe('Storage bucket (required). Use "asset-images" for asset photos.'),
         file_name: z.string().min(1).max(500).describe('File name including extension (required)'),
     }, async (params) => {
         try {
@@ -2292,10 +2881,25 @@ export function registerWriteTools(server, client) {
         }
     });
     server.tool('upload_file', 'Upload a file to AssetLab storage by sending its bytes inline (base64). The AssetLab backend performs the storage upload server-side — use this tool when the client cannot PUT directly to Supabase Storage (e.g. Claude integrations whose outbound network blocks arbitrary supabase.co hosts). Returns { path, public_url, bucket, file_size, content_type }. After uploading, pass path or public_url to the appropriate record tool (update_asset image_url, create_asset_document file_path, update_work_order image_url, create_attachment file_path, create_project_document file_path, create_contract_document file_path). Server limit is ~10 MB decoded; MCP arg ceiling effectively caps file size around 700 KB–1 MB. For larger files, use create_upload_url instead. Requires upload_urls:write scope.', {
-        bucket: z.enum(['documents', 'attachments', 'project-documents', 'contract-documents', 'asset-images']).describe('Storage bucket (required). Use "asset-images" for asset photos, "attachments" for work-order/PM attachments.'),
+        bucket: z
+            .enum([
+            'documents',
+            'attachments',
+            'project-documents',
+            'contract-documents',
+            'asset-images',
+        ])
+            .describe('Storage bucket (required). Use "asset-images" for asset photos, "attachments" for work-order/PM attachments.'),
         file_name: z.string().min(1).max(500).describe('File name including extension (required)'),
-        content_base64: z.string().min(1).describe('File contents base64-encoded (required). Data URI prefixes like "data:image/png;base64," are stripped automatically.'),
-        content_type: z.string().max(200).optional().describe('MIME type (e.g. image/jpeg, application/pdf). Defaults to application/octet-stream.'),
+        content_base64: z
+            .string()
+            .min(1)
+            .describe('File contents base64-encoded (required). Data URI prefixes like "data:image/png;base64," are stripped automatically.'),
+        content_type: z
+            .string()
+            .max(200)
+            .optional()
+            .describe('MIME type (e.g. image/jpeg, application/pdf). Defaults to application/octet-stream.'),
     }, async (params) => {
         try {
             const result = await client.create('upload-files', buildBody(params));
@@ -2310,9 +2914,16 @@ export function registerWriteTools(server, client) {
     // ============================================================
     server.tool('create_asset_document', 'Create an asset document record (after uploading the file via create_upload_url). Requires asset_documents:write scope.', {
         name: z.string().min(1).max(500).describe('Document name (required)'),
-        file_path: z.string().min(1).max(2000).describe('Storage path from upload URL response (required)'),
+        file_path: z
+            .string()
+            .min(1)
+            .max(2000)
+            .describe('Storage path from upload URL response (required)'),
         asset_id: z.string().uuid().describe('Asset ID this document belongs to (required)'),
-        category: z.enum(['om', 'commissioning', 'warranty', 'installation', 'specification', 'other']).optional().describe('Document category'),
+        category: z
+            .enum(['om', 'commissioning', 'warranty', 'installation', 'specification', 'other'])
+            .optional()
+            .describe('Document category'),
         description: z.string().optional().describe('Description'),
         file_type: z.string().max(200).optional().describe('MIME type'),
         file_size: z.number().min(0).optional().describe('File size in bytes'),
@@ -2331,7 +2942,10 @@ export function registerWriteTools(server, client) {
         name: z.string().min(1).max(500).optional().describe('Document name'),
         file_path: z.string().max(2000).optional().describe('Storage path'),
         asset_id: z.string().uuid().optional().describe('Asset ID'),
-        category: z.enum(['om', 'commissioning', 'warranty', 'installation', 'specification', 'other']).optional().describe('Document category'),
+        category: z
+            .enum(['om', 'commissioning', 'warranty', 'installation', 'specification', 'other'])
+            .optional()
+            .describe('Document category'),
         description: z.string().optional().describe('Description'),
         file_type: z.string().max(200).optional().describe('MIME type'),
         file_size: z.number().min(0).optional().describe('File size in bytes'),
@@ -2364,10 +2978,26 @@ export function registerWriteTools(server, client) {
         file_type: z.string().max(200).optional().describe('MIME type'),
         uploaded_by: z.string().max(200).optional().describe('Uploader user ID'),
         description: z.string().optional().describe('Description'),
-        work_order_id: z.string().uuid().optional().describe('Work order ID (exactly one parent required)'),
-        work_request_id: z.string().uuid().optional().describe('Work request ID (exactly one parent required)'),
-        pm_schedule_id: z.string().uuid().optional().describe('PM schedule ID (exactly one parent required)'),
-        pm_template_id: z.string().uuid().optional().describe('PM template ID (exactly one parent required)'),
+        work_order_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Work order ID (exactly one parent required)'),
+        work_request_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Work request ID (exactly one parent required)'),
+        pm_schedule_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('PM schedule ID (exactly one parent required)'),
+        pm_template_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('PM template ID (exactly one parent required)'),
     }, async (params) => {
         try {
             const result = await client.create('attachments', buildBody(params));
@@ -2413,7 +3043,11 @@ export function registerWriteTools(server, client) {
     server.tool('create_project_document', 'Create a project document record. Requires project_documents:write scope.', {
         project_id: z.string().uuid().describe('Project ID (required)'),
         name: z.string().min(1).max(500).describe('Document name (required)'),
-        file_path: z.string().min(1).max(2000).describe('Storage path from upload URL response (required)'),
+        file_path: z
+            .string()
+            .min(1)
+            .max(2000)
+            .describe('Storage path from upload URL response (required)'),
         uploaded_by: z.string().min(1).max(200).describe('Uploader user ID (required)'),
         folder_id: z.string().uuid().optional().describe('Folder ID'),
         description: z.string().optional().describe('Description'),
@@ -2462,7 +3096,11 @@ export function registerWriteTools(server, client) {
     server.tool('create_contract_document', 'Create a contract document record. Requires contract_documents:write scope.', {
         contract_id: z.string().uuid().describe('Contract ID (required)'),
         file_name: z.string().min(1).max(500).describe('File name (required)'),
-        file_path: z.string().min(1).max(2000).describe('Storage path from upload URL response (required)'),
+        file_path: z
+            .string()
+            .min(1)
+            .max(2000)
+            .describe('Storage path from upload URL response (required)'),
         file_size: z.number().min(0).optional().describe('File size in bytes'),
         file_type: z.string().max(200).optional().describe('MIME type'),
         uploaded_by: z.string().max(200).optional().describe('Uploader user ID'),
@@ -2554,7 +3192,10 @@ export function registerWriteTools(server, client) {
     server.tool('create_project_task_dependency', 'Create a dependency between two project tasks. Requires project_task_dependencies:write scope.', {
         task_id: z.string().uuid().describe('Task ID (the dependent task, required)'),
         depends_on_task_id: z.string().uuid().describe('Task ID that must complete first (required)'),
-        dependency_type: z.enum(['finish_to_start', 'start_to_start', 'finish_to_finish', 'start_to_finish']).optional().describe('Dependency type (default: finish_to_start)'),
+        dependency_type: z
+            .enum(['finish_to_start', 'start_to_start', 'finish_to_finish', 'start_to_finish'])
+            .optional()
+            .describe('Dependency type (default: finish_to_start)'),
     }, async (params) => {
         try {
             const result = await client.create('project-task-dependencies', buildBody(params));
@@ -2579,9 +3220,20 @@ export function registerWriteTools(server, client) {
     server.tool('create_project_update', 'Create a periodic project status update. Requires project_updates:write scope.', {
         project_id: z.string().uuid().describe('Project ID (required)'),
         author_id: z.string().min(1).max(200).describe('Author Clerk user ID (required)'),
-        timeframe: z.enum(['monthly', 'quarterly', 'bi-annually', 'annually']).describe('Update timeframe (required)'),
-        period_year: z.number().int().min(2000).max(2100).describe('Year for this update period (required)'),
-        period_value: z.string().min(1).max(20).describe('Period value — 1-12 for monthly, 1-4 for quarterly, etc. (required)'),
+        timeframe: z
+            .enum(['monthly', 'quarterly', 'bi-annually', 'annually'])
+            .describe('Update timeframe (required)'),
+        period_year: z
+            .number()
+            .int()
+            .min(2000)
+            .max(2100)
+            .describe('Year for this update period (required)'),
+        period_value: z
+            .string()
+            .min(1)
+            .max(20)
+            .describe('Period value — 1-12 for monthly, 1-4 for quarterly, etc. (required)'),
         content: z.string().min(1).describe('Update content (required)'),
         title: z.string().max(500).optional().describe('Optional custom title'),
     }, async (params) => {
@@ -2597,8 +3249,17 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Project update ID'),
         project_id: z.string().uuid().optional().describe('Project ID'),
         author_id: z.string().min(1).max(200).optional().describe('Author Clerk user ID'),
-        timeframe: z.enum(['monthly', 'quarterly', 'bi-annually', 'annually']).optional().describe('Update timeframe'),
-        period_year: z.number().int().min(2000).max(2100).optional().describe('Year for this update period'),
+        timeframe: z
+            .enum(['monthly', 'quarterly', 'bi-annually', 'annually'])
+            .optional()
+            .describe('Update timeframe'),
+        period_year: z
+            .number()
+            .int()
+            .min(2000)
+            .max(2100)
+            .optional()
+            .describe('Year for this update period'),
         period_value: z.string().min(1).max(20).optional().describe('Period value'),
         content: z.string().min(1).optional().describe('Update content'),
         title: z.string().max(500).optional().describe('Optional custom title'),
@@ -2629,7 +3290,12 @@ export function registerWriteTools(server, client) {
         total_budget: z.number().min(0).describe('Total budget amount (required)'),
         actual_cost: z.number().min(0).describe('Actual cost to date (required)'),
         forecasted_cost: z.number().min(0).optional().describe('Forecasted total cost'),
-        percent_complete: z.number().min(0).max(100).optional().describe('Completion percentage (0-100)'),
+        percent_complete: z
+            .number()
+            .min(0)
+            .max(100)
+            .optional()
+            .describe('Completion percentage (0-100)'),
     }, async (params) => {
         try {
             const result = await client.create('project-cost-snapshots', buildBody(params));
@@ -2799,10 +3465,16 @@ export function registerWriteTools(server, client) {
         project_id: z.string().uuid().describe('Project ID (required)'),
         title: z.string().min(1).max(500).describe('Risk title (required)'),
         description: z.string().optional().describe('Risk description'),
-        category: z.enum(['technical', 'financial', 'schedule', 'resource', 'external']).optional().describe('Risk category'),
+        category: z
+            .enum(['technical', 'financial', 'schedule', 'resource', 'external'])
+            .optional()
+            .describe('Risk category'),
         probability: z.enum(['low', 'medium', 'high']).optional().describe('Probability level'),
         impact: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Impact level'),
-        status: z.enum(['identified', 'analyzing', 'mitigating', 'resolved', 'accepted']).optional().describe('Risk status (default: identified)'),
+        status: z
+            .enum(['identified', 'analyzing', 'mitigating', 'resolved', 'accepted'])
+            .optional()
+            .describe('Risk status (default: identified)'),
         mitigation_plan: z.string().optional().describe('Mitigation plan'),
         contingency_plan: z.string().optional().describe('Contingency plan'),
         owner_id: z.string().max(200).optional().describe('Risk owner (Clerk user ID)'),
@@ -2822,10 +3494,16 @@ export function registerWriteTools(server, client) {
         project_id: z.string().uuid().optional().describe('Project ID'),
         title: z.string().min(1).max(500).optional().describe('Risk title'),
         description: z.string().optional().describe('Risk description'),
-        category: z.enum(['technical', 'financial', 'schedule', 'resource', 'external']).optional().describe('Risk category'),
+        category: z
+            .enum(['technical', 'financial', 'schedule', 'resource', 'external'])
+            .optional()
+            .describe('Risk category'),
         probability: z.enum(['low', 'medium', 'high']).optional().describe('Probability level'),
         impact: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Impact level'),
-        status: z.enum(['identified', 'analyzing', 'mitigating', 'resolved', 'accepted']).optional().describe('Risk status'),
+        status: z
+            .enum(['identified', 'analyzing', 'mitigating', 'resolved', 'accepted'])
+            .optional()
+            .describe('Risk status'),
         mitigation_plan: z.string().optional().describe('Mitigation plan'),
         contingency_plan: z.string().optional().describe('Contingency plan'),
         owner_id: z.string().max(200).optional().describe('Risk owner (Clerk user ID)'),
@@ -2881,7 +3559,10 @@ export function registerWriteTools(server, client) {
         icon: z.string().max(200).optional().describe('Icon name (e.g., "droplets" for water)'),
         color: z.string().max(50).optional().describe('Hex color code (e.g., "#3B82F6")'),
         sort_order: z.number().int().min(0).optional().describe('Sort order for display'),
-        is_active: z.boolean().optional().describe('Whether the service area is active (default: true)'),
+        is_active: z
+            .boolean()
+            .optional()
+            .describe('Whether the service area is active (default: true)'),
     }, async (params) => {
         try {
             const result = await client.create('service-areas', buildBody(params));
@@ -2971,24 +3652,65 @@ export function registerWriteTools(server, client) {
     server.tool('create_los_measure', 'Create a new LoS measure within a service area. Requires los_measures:write scope. Resolve service_area_id first via list_service_areas.', {
         service_area_id: z.string().uuid().describe('Service area ID (required)'),
         name: z.string().min(1).max(500).describe('Measure name (required, unique per service area)'),
-        category: z.enum(['quality', 'reliability', 'responsiveness', 'safety', 'sustainability', 'cost_efficiency', 'capacity']).describe('Measure category (required)'),
+        category: z
+            .enum([
+            'quality',
+            'reliability',
+            'responsiveness',
+            'safety',
+            'sustainability',
+            'cost_efficiency',
+            'capacity',
+        ])
+            .describe('Measure category (required)'),
         type: z.enum(['community', 'technical']).describe('Measure type (required)'),
-        data_source: z.enum([
-            'manual', 'custom_formula', 'asset_condition_avg', 'asset_condition_pct_above',
-            'asset_condition_pct_below', 'risk_score_avg', 'risk_pct_critical',
-            'wo_response_time_avg', 'wo_completion_time_avg', 'wo_backlog_count', 'wo_overdue_count',
-            'pm_compliance_rate', 'compliance_score', 'fci', 'deferred_maintenance_ratio',
+        data_source: z
+            .enum([
+            'manual',
+            'custom_formula',
+            'asset_condition_avg',
+            'asset_condition_pct_above',
+            'asset_condition_pct_below',
+            'risk_score_avg',
+            'risk_pct_critical',
+            'wo_response_time_avg',
+            'wo_completion_time_avg',
+            'wo_backlog_count',
+            'wo_overdue_count',
+            'pm_compliance_rate',
+            'compliance_score',
+            'fci',
+            'deferred_maintenance_ratio',
             'asset_past_useful_life_pct',
-        ]).describe('Data source type (required). Use "manual" if values will be entered by hand.'),
+        ])
+            .describe('Data source type (required). Use "manual" if values will be entered by hand.'),
         description: z.string().max(2000).optional().describe('Description'),
-        community_statement: z.string().max(2000).optional().describe('Community-facing statement (for community type measures)'),
-        unit: z.string().max(100).optional().describe('Unit of measurement (e.g., "%", "hours", "count")'),
-        trend_direction: z.enum(['higher_is_better', 'lower_is_better', 'target_is_optimal']).optional().describe('Which direction is better'),
+        community_statement: z
+            .string()
+            .max(2000)
+            .optional()
+            .describe('Community-facing statement (for community type measures)'),
+        unit: z
+            .string()
+            .max(100)
+            .optional()
+            .describe('Unit of measurement (e.g., "%", "hours", "count")'),
+        trend_direction: z
+            .enum(['higher_is_better', 'lower_is_better', 'target_is_optimal'])
+            .optional()
+            .describe('Which direction is better'),
         target_value: z.number().optional().describe('Target value'),
         minimum_acceptable: z.number().optional().describe('Minimum acceptable value'),
         stretch_goal: z.number().optional().describe('Stretch goal value'),
-        weight: z.number().min(0).optional().describe('Weight for composite score calculation (default: 1.0)'),
-        data_source_config: z.record(z.unknown()).optional().describe('Data source configuration (JSONB). E.g., {"threshold": 3} for pct_above/below, {"days_back": 90} for WO metrics.'),
+        weight: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Weight for composite score calculation (default: 1.0)'),
+        data_source_config: z
+            .record(z.unknown())
+            .optional()
+            .describe('Data source configuration (JSONB). E.g., {"threshold": 3} for pct_above/below, {"days_back": 90} for WO metrics.'),
         is_active: z.boolean().optional().describe('Whether the measure is active (default: true)'),
         sort_order: z.number().int().min(0).optional().describe('Sort order for display'),
     }, async (params) => {
@@ -3003,24 +3725,55 @@ export function registerWriteTools(server, client) {
     server.tool('update_los_measure', 'Update an existing LoS measure by ID. Requires los_measures:write scope.', {
         id: z.string().uuid().describe('LoS measure ID'),
         name: z.string().min(1).max(500).optional().describe('Measure name'),
-        category: z.enum(['quality', 'reliability', 'responsiveness', 'safety', 'sustainability', 'cost_efficiency', 'capacity']).optional().describe('Measure category'),
+        category: z
+            .enum([
+            'quality',
+            'reliability',
+            'responsiveness',
+            'safety',
+            'sustainability',
+            'cost_efficiency',
+            'capacity',
+        ])
+            .optional()
+            .describe('Measure category'),
         type: z.enum(['community', 'technical']).optional().describe('Measure type'),
-        data_source: z.enum([
-            'manual', 'custom_formula', 'asset_condition_avg', 'asset_condition_pct_above',
-            'asset_condition_pct_below', 'risk_score_avg', 'risk_pct_critical',
-            'wo_response_time_avg', 'wo_completion_time_avg', 'wo_backlog_count', 'wo_overdue_count',
-            'pm_compliance_rate', 'compliance_score', 'fci', 'deferred_maintenance_ratio',
+        data_source: z
+            .enum([
+            'manual',
+            'custom_formula',
+            'asset_condition_avg',
+            'asset_condition_pct_above',
+            'asset_condition_pct_below',
+            'risk_score_avg',
+            'risk_pct_critical',
+            'wo_response_time_avg',
+            'wo_completion_time_avg',
+            'wo_backlog_count',
+            'wo_overdue_count',
+            'pm_compliance_rate',
+            'compliance_score',
+            'fci',
+            'deferred_maintenance_ratio',
             'asset_past_useful_life_pct',
-        ]).optional().describe('Data source type'),
+        ])
+            .optional()
+            .describe('Data source type'),
         description: z.string().max(2000).optional().describe('Description'),
         community_statement: z.string().max(2000).optional().describe('Community-facing statement'),
         unit: z.string().max(100).optional().describe('Unit of measurement'),
-        trend_direction: z.enum(['higher_is_better', 'lower_is_better', 'target_is_optimal']).optional().describe('Which direction is better'),
+        trend_direction: z
+            .enum(['higher_is_better', 'lower_is_better', 'target_is_optimal'])
+            .optional()
+            .describe('Which direction is better'),
         target_value: z.number().optional().describe('Target value'),
         minimum_acceptable: z.number().optional().describe('Minimum acceptable value'),
         stretch_goal: z.number().optional().describe('Stretch goal value'),
         weight: z.number().min(0).optional().describe('Weight for composite score calculation'),
-        data_source_config: z.record(z.unknown()).optional().describe('Data source configuration (JSONB)'),
+        data_source_config: z
+            .record(z.unknown())
+            .optional()
+            .describe('Data source configuration (JSONB)'),
         is_active: z.boolean().optional().describe('Active status'),
         sort_order: z.number().int().min(0).optional().describe('Sort order'),
     }, async ({ id, ...rest }) => {
@@ -3046,12 +3799,19 @@ export function registerWriteTools(server, client) {
     // ============================================================
     server.tool('create_los_measurement', 'Record a new LoS measurement value. Requires los_measurements:write scope. Resolve los_measure_id first via list_los_measures.', {
         los_measure_id: z.string().uuid().describe('LoS measure ID (required)'),
-        period_type: z.enum(['monthly', 'quarterly', 'semi_annual', 'annual']).describe('Period type (required)'),
-        period_start: z.string().describe('Period start date (ISO 8601, required, e.g., "2026-01-01")'),
+        period_type: z
+            .enum(['monthly', 'quarterly', 'semi_annual', 'annual'])
+            .describe('Period type (required)'),
+        period_start: z
+            .string()
+            .describe('Period start date (ISO 8601, required, e.g., "2026-01-01")'),
         period_end: z.string().describe('Period end date (ISO 8601, required, e.g., "2026-03-31")'),
         actual_value: z.number().describe('Measured value (required)'),
         notes: z.string().max(2000).optional().describe('Notes or context for this measurement'),
-        is_auto: z.boolean().optional().describe('Whether this is an auto-calculated value (default: false)'),
+        is_auto: z
+            .boolean()
+            .optional()
+            .describe('Whether this is an auto-calculated value (default: false)'),
     }, async (params) => {
         try {
             const result = await client.create('los-measurements', buildBody(params));
@@ -3065,7 +3825,10 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('LoS measurement ID'),
         actual_value: z.number().optional().describe('Measured value'),
         notes: z.string().max(2000).optional().describe('Notes or context'),
-        period_type: z.enum(['monthly', 'quarterly', 'semi_annual', 'annual']).optional().describe('Period type'),
+        period_type: z
+            .enum(['monthly', 'quarterly', 'semi_annual', 'annual'])
+            .optional()
+            .describe('Period type'),
         period_start: z.string().optional().describe('Period start date (ISO 8601)'),
         period_end: z.string().optional().describe('Period end date (ISO 8601)'),
         is_auto: z.boolean().optional().describe('Whether this is auto-calculated'),
@@ -3097,14 +3860,39 @@ export function registerWriteTools(server, client) {
         .min(3)
         .describe('Polygon outline as an array of [x, y] points in normalized 0-1 coordinates (origin top-left). At least 3 points.');
     server.tool('create_floorplan', 'Create a floorplan row. Provide EXACTLY ONE of building_id (per-building floor) or site_id (site-level / campus plan). Typically the web app calls this per page of an uploaded PDF; MCP clients rarely need to call this directly since they do not upload the PDF itself. Requires floorplans:write scope.', {
-        building_id: z.string().uuid().optional().describe('Building this floor belongs to (omit if site-scoped)'),
-        site_id: z.string().uuid().optional().describe('Site this plan belongs to (use for site-level / campus plans; omit if building-scoped)'),
-        floor_label: z.string().max(200).describe('Human-readable label (e.g. "Ground Floor", "Mezzanine", "Site Plan")'),
-        floor_order: z.number().int().min(0).optional().describe('Sort order within the scope (lowest first)'),
+        building_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Building this floor belongs to (omit if site-scoped)'),
+        site_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Site this plan belongs to (use for site-level / campus plans; omit if building-scoped)'),
+        floor_label: z
+            .string()
+            .max(200)
+            .describe('Human-readable label (e.g. "Ground Floor", "Mezzanine", "Site Plan")'),
+        floor_order: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Sort order within the scope (lowest first)'),
         pdf_storage_path: z.string().max(1000).describe('Supabase Storage path to the PDF file'),
         pdf_filename: z.string().max(500).describe('Original filename for display'),
-        page_number: z.number().int().min(1).optional().describe('1-indexed page number within the PDF'),
-        page_width_pt: z.number().min(0).optional().describe('Page width in PDF points (discovered client-side)'),
+        page_number: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('1-indexed page number within the PDF'),
+        page_width_pt: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Page width in PDF points (discovered client-side)'),
         page_height_pt: z.number().min(0).optional().describe('Page height in PDF points'),
         status: z.enum(FLOORPLAN_STATUSES).optional().describe('Detection status (default: pending)'),
     }, async (params) => {
@@ -3149,10 +3937,25 @@ export function registerWriteTools(server, client) {
         floorplan_id: z.string().uuid().describe('Floorplan this region belongs to'),
         label: z.string().max(500).describe('Region label (e.g. "Boiler Room 2B")'),
         polygon: polygonSchema,
-        location_id: z.string().uuid().optional().describe('Linked Location ID (resolved via list_locations)'),
-        source: z.enum(REGION_SOURCES).optional().describe('"manual" (default) or "ai" for AI-detected'),
-        confidence: z.number().min(0).max(1).optional().describe('AI confidence score (0-1), only set when source=ai'),
-        reviewed: z.boolean().optional().describe('True if an admin has reviewed this region (default: true for manual, false for ai)'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Linked Location ID (resolved via list_locations)'),
+        source: z
+            .enum(REGION_SOURCES)
+            .optional()
+            .describe('"manual" (default) or "ai" for AI-detected'),
+        confidence: z
+            .number()
+            .min(0)
+            .max(1)
+            .optional()
+            .describe('AI confidence score (0-1), only set when source=ai'),
+        reviewed: z
+            .boolean()
+            .optional()
+            .describe('True if an admin has reviewed this region (default: true for manual, false for ai)'),
     }, async (params) => {
         try {
             const result = await client.create('floorplan-regions', buildBody(params));
@@ -3166,7 +3969,11 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Floorplan region ID'),
         label: z.string().max(500).optional().describe('New label'),
         polygon: polygonSchema.optional(),
-        location_id: z.string().uuid().optional().describe('Linked Location ID (set to null to unlink)'),
+        location_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Linked Location ID (set to null to unlink)'),
         confidence: z.number().min(0).max(1).optional(),
         reviewed: z.boolean().optional().describe('Mark region as reviewed by admin'),
     }, async ({ id, ...rest }) => {
@@ -3192,8 +3999,15 @@ export function registerWriteTools(server, client) {
         floorplan_id: z.string().uuid().describe('Target floorplan (resolve via list_floorplans)'),
         x: z.number().min(0).max(1).describe('Normalized x coordinate (0=left, 1=right)'),
         y: z.number().min(0).max(1).describe('Normalized y coordinate (0=top, 1=bottom)'),
-        region_id: z.string().uuid().optional().describe('Optional region the pin sits inside (usually auto-inferred)'),
-        source: z.enum(REGION_SOURCES).optional().describe('"manual" (default) or "ai" for AI-placed'),
+        region_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Optional region the pin sits inside (usually auto-inferred)'),
+        source: z
+            .enum(REGION_SOURCES)
+            .optional()
+            .describe('"manual" (default) or "ai" for AI-placed'),
     }, async (params) => {
         try {
             const result = await client.create('asset-placements', buildBody(params));
@@ -3231,30 +4045,80 @@ export function registerWriteTools(server, client) {
     // Bulk operations
     // ============================================================
     const BULK_RESOURCES = [
-        'assets', 'work-orders', 'work-requests', 'vendors', 'sites',
-        'buildings', 'locations', 'systems', 'system-groups', 'system-classes',
-        'pm-schedules', 'pm-templates', 'projects',
-        'contracts', 'invoices', 'purchase-orders', 'expenses', 'budgets',
-        'asset-types', 'asset-type-groups', 'asset-statuses', 'work-categories', 'manufacturers',
-        'building-types', 'location-types', 'cost-categories',
-        'compliance', 'compliance-records',
-        'asset-comments', 'asset-costs', 'asset-replacement-plans',
-        'work-order-comments', 'project-tasks', 'project-milestones',
-        'project-phases', 'project-budget-items', 'project-time-entries',
-        'project-comments', 'project-team-members', 'project-task-dependencies',
-        'project-updates', 'project-cost-snapshots', 'project-locations',
-        'project-sites', 'project-buildings', 'project-systems',
-        'project-system-classes', 'project-system-groups', 'project-assets', 'project-risks',
-        'parts', 'part-categories',
-        'custom-field-definitions', 'custom-field-values',
-        'vendor-site-assignments', 'contract-sites',
-        'asset-documents', 'attachments', 'project-documents', 'contract-documents',
-        'service-areas', 'los-measures', 'los-measurements',
-        'floorplans', 'floorplan-regions', 'asset-placements',
+        'assets',
+        'work-orders',
+        'work-requests',
+        'vendors',
+        'sites',
+        'buildings',
+        'locations',
+        'systems',
+        'system-groups',
+        'system-classes',
+        'pm-schedules',
+        'pm-templates',
+        'projects',
+        'contracts',
+        'invoices',
+        'purchase-orders',
+        'expenses',
+        'budgets',
+        'asset-types',
+        'asset-type-groups',
+        'asset-statuses',
+        'work-categories',
+        'manufacturers',
+        'building-types',
+        'location-types',
+        'cost-categories',
+        'compliance',
+        'compliance-records',
+        'asset-comments',
+        'asset-costs',
+        'asset-replacement-plans',
+        'work-order-comments',
+        'project-tasks',
+        'project-milestones',
+        'project-phases',
+        'project-budget-items',
+        'project-time-entries',
+        'project-comments',
+        'project-team-members',
+        'project-task-dependencies',
+        'project-updates',
+        'project-cost-snapshots',
+        'project-locations',
+        'project-sites',
+        'project-buildings',
+        'project-systems',
+        'project-system-classes',
+        'project-system-groups',
+        'project-assets',
+        'project-risks',
+        'parts',
+        'part-categories',
+        'custom-field-definitions',
+        'custom-field-values',
+        'vendor-site-assignments',
+        'contract-sites',
+        'asset-documents',
+        'attachments',
+        'project-documents',
+        'contract-documents',
+        'service-areas',
+        'los-measures',
+        'los-measurements',
+        'floorplans',
+        'floorplan-regions',
+        'asset-placements',
     ];
     server.tool('bulk_create', 'Create multiple records of a resource type in one API call (max 100). Each item is processed independently — one failure does not affect others. Returns per-item results. Requires {resource}:write scope. Counts as 1 request for rate limiting.', {
         resource: z.enum(BULK_RESOURCES).describe('Resource type (e.g. "assets", "work-orders")'),
-        items: z.array(z.record(z.unknown())).min(1).max(100).describe('Array of objects to create (max 100). Each object uses the same fields as the single-create endpoint for that resource.'),
+        items: z
+            .array(z.record(z.unknown()))
+            .min(1)
+            .max(100)
+            .describe('Array of objects to create (max 100). Each object uses the same fields as the single-create endpoint for that resource.'),
     }, async ({ resource, items }) => {
         try {
             const result = await client.bulkCreate(resource, items);
@@ -3308,7 +4172,12 @@ export function registerWriteTools(server, client) {
         name: z.string().max(500).describe('Compliance item name (required)'),
         description: z.string().optional().describe('Description'),
         regulation_reference: z.string().max(500).optional().describe('Regulation or code reference'),
-        compliance_period_months: z.number().int().min(1).optional().describe('Compliance period in months'),
+        compliance_period_months: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Compliance period in months'),
         status: z.enum(['active', 'archived']).optional().describe('Status'),
         system_id: z.string().uuid().optional().describe('Associated system ID'),
     }, async (params) => {
@@ -3325,7 +4194,12 @@ export function registerWriteTools(server, client) {
         name: z.string().max(500).optional().describe('Compliance item name'),
         description: z.string().optional().describe('Description'),
         regulation_reference: z.string().max(500).optional().describe('Regulation or code reference'),
-        compliance_period_months: z.number().int().min(1).optional().describe('Compliance period in months'),
+        compliance_period_months: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Compliance period in months'),
         status: z.enum(['active', 'archived']).optional().describe('Status'),
         system_id: z.string().uuid().optional().describe('Associated system ID'),
     }, async ({ id, ...rest }) => {
@@ -3355,8 +4229,17 @@ export function registerWriteTools(server, client) {
         work_order_id: z.string().uuid().describe('Work order ID (required)'),
         completed_at: z.string().describe('Completion date-time (ISO 8601, required)'),
         completed_by: z.string().max(200).optional().describe('User ID who completed'),
-        required_frequency_days: z.number().int().min(1).describe('Required frequency in days (required)'),
-        days_since_last_completion: z.number().int().min(0).optional().describe('Days since last completion'),
+        required_frequency_days: z
+            .number()
+            .int()
+            .min(1)
+            .describe('Required frequency in days (required)'),
+        days_since_last_completion: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Days since last completion'),
     }, async (params) => {
         try {
             const result = await client.create('compliance-records', buildBody(params));
@@ -3370,8 +4253,18 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Compliance record ID'),
         completed_at: z.string().optional().describe('Completion date-time (ISO 8601)'),
         completed_by: z.string().max(200).optional().describe('User ID who completed'),
-        required_frequency_days: z.number().int().min(1).optional().describe('Required frequency in days'),
-        days_since_last_completion: z.number().int().min(0).optional().describe('Days since last completion'),
+        required_frequency_days: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('Required frequency in days'),
+        days_since_last_completion: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Days since last completion'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('compliance-records', id, buildBody(rest));
@@ -3395,7 +4288,11 @@ export function registerWriteTools(server, client) {
     // ============================================================
     server.tool('bulk_update', 'Update multiple records of a resource type in one API call (max 100). Each item must include an "id" field (UUID). Each item is processed independently — one failure does not affect others. Returns per-item results. Requires {resource}:write scope. Counts as 1 request for rate limiting.', {
         resource: z.enum(BULK_RESOURCES).describe('Resource type (e.g. "assets", "work-orders")'),
-        items: z.array(z.record(z.unknown())).min(1).max(100).describe('Array of objects to update (max 100). Each must include an "id" field (UUID) plus fields to change.'),
+        items: z
+            .array(z.record(z.unknown()))
+            .min(1)
+            .max(100)
+            .describe('Array of objects to update (max 100). Each must include an "id" field (UUID) plus fields to change.'),
     }, async ({ resource, items }) => {
         try {
             const result = await client.bulkUpdate(resource, items);