@powerhousedao/service-offering 1.0.0-dev.4 → 1.0.0-dev.6

package/dist/document-models/subscription-instance/v1/gen/document-model.js

@@ -5,8 +5,8 @@ export const documentModel = {
         name: "Powerhouse",
         website: "https://www.powerhouse.inc/",
     },
-    extension: "phsi",
-    description: "Tracks an individual subscription instance for a service offering, including customer info, tier selection, billing, services, service groups, and usage metrics.",
+    extension: "",
+    description: "Tracks an individual subscription instance for a service offering, including customer info, tier selection, billing, services, service groups, and usage metrics",
     specifications: [
         {
             state: {
@@ -16,200 +16,256 @@ export const documentModel = {
                     initialValue: "",
                 },
                 global: {
-                    schema: "type SubscriptionInstanceState {\n    customerId: PHID\n    customerName: String\n    customerEmail: String\n    customerType: CustomerType\n    teamMemberCount: Int\n    operatorId: PHID\n    serviceOfferingId: PHID\n    tierName: String\n    tierPricingOptionId: OID\n    tierPrice: Amount_Money\n    tierCurrency: Currency\n    tierPricingMode: TierPricingMode\n    selectedBillingCycle: BillingCycle\n    globalCurrency: Currency\n    resource: ResourceDocument\n    status: SubscriptionStatus!\n    createdAt: DateTime\n    activatedSince: DateTime\n    pausedSince: DateTime\n    expiringSince: DateTime\n    renewalDate: DateTime\n    cancelledSince: DateTime\n    cancellationReason: String\n    autoRenew: Boolean!\n    operatorNotes: String\n    budget: BudgetCategory\n    nextBillingDate: DateTime\n    projectedBillAmount: Amount_Money\n    projectedBillCurrency: Currency\n    services: [SubscriptionService!]!\n    serviceGroups: [ServiceGroup!]!\n}\n\ntype ResourceDocument {\n    documentId: PHID!\n    documentType: String!\n}\n\ntype BudgetCategory {\n    id: OID!\n    name: String!\n    description: String\n}\n\nenum CustomerType {\n    INDIVIDUAL\n    TEAM\n    ENTERPRISE\n}\n\nenum TierPricingMode {\n    FIXED\n    PER_SEAT\n    CUSTOM\n}\n\nenum BillingCycle {\n    MONTHLY\n    QUARTERLY\n    SEMI_ANNUAL\n    ANNUAL\n}\n\nenum SubscriptionStatus {\n    DRAFT\n    ACTIVE\n    PAUSED\n    EXPIRING\n    CANCELLED\n}\n\nenum DiscountType {\n    PERCENTAGE\n    FIXED_AMOUNT\n}\n\nenum DiscountSource {\n    TIER\n    CUSTOM\n}\n\nenum GroupCostType {\n    SETUP\n    RECURRING\n}\n\nenum ResetPeriod {\n    DAILY\n    WEEKLY\n    MONTHLY\n    QUARTERLY\n    ANNUAL\n}\n\ntype SubscriptionService {\n    id: OID!\n    name: String!\n    description: String\n    customValue: String\n    facetSelections: [FacetSelection!]!\n    setupCost: ServiceCost\n    recurringCost: ServiceCost\n    metrics: [ServiceMetric!]!\n}\n\ntype FacetSelection {\n    id: OID!\n    facetName: String!\n    selectedOption: String!\n}\n\ntype ServiceCost {\n    amount: Amount_Money!\n    currency: Currency!\n    paidAmount: Amount_Money\n    paidAt: DateTime\n}\n\ntype ServiceMetric {\n    id: OID!\n    name: String!\n    unitName: String\n    limit: Int\n    freeLimit: Int\n    paidLimit: Int\n    unitCost: Amount_Money\n    currentUsage: Int!\n    usageResetPeriod: ResetPeriod\n    nextUsageReset: DateTime\n}\n\ntype ServiceGroup {\n    id: OID!\n    optional: Boolean!\n    name: String!\n    costType: GroupCostType\n    setupCost: ServiceCost\n    recurringCost: ServiceCost\n    services: [OID!]!\n}",
+                    schema: "type SubscriptionInstanceState {\n    customerId: PHID\n    customerName: String\n    customerEmail: EmailAddress\n    customerType: CustomerType\n    teamMemberCount: Int\n    operatorId: PHID\n    serviceOfferingId: PHID\n    tierName: String\n    tierPricingOptionId: OID\n    tierPrice: Amount_Money\n    tierCurrency: Currency\n    tierPricingMode: TierPricingMode\n    selectedBillingCycle: BillingCycle\n    globalCurrency: Currency\n    resource: ResourceDocument\n    status: SubscriptionStatus!\n    createdAt: DateTime\n    activatedSince: DateTime\n    pausedSince: DateTime\n    expiringSince: DateTime\n    renewalDate: DateTime\n    cancelledSince: DateTime\n    cancellationReason: String\n    autoRenew: Boolean!\n    operatorNotes: String\n    budget: BudgetCategory\n    nextBillingDate: DateTime\n    projectedBillAmount: Amount_Money\n    projectedBillCurrency: Currency\n    services: [Service!]!\n    serviceGroups: [ServiceGroup!]!\n}\n\nenum TierPricingMode {\n    CALCULATED\n    MANUAL_OVERRIDE\n}\n\nenum CustomerType {\n    INDIVIDUAL\n    TEAM\n}\n\nenum GroupCostType {\n    RECURRING\n    SETUP\n}\n\nenum SubscriptionStatus {\n    PENDING\n    ACTIVE\n    PAUSED\n    EXPIRING\n    CANCELLED\n}\n\nenum DiscountType {\n    PERCENTAGE\n    FLAT_AMOUNT\n}\n\nenum DiscountSource {\n    TIER_INHERITED\n    GROUP_INDEPENDENT\n    BUNDLE\n}\n\nenum BillingCycle {\n    MONTHLY\n    QUARTERLY\n    SEMI_ANNUAL\n    ANNUAL\n    ONE_TIME\n}\n\nenum ResetPeriod {\n    HOURLY\n    DAILY\n    WEEKLY\n    MONTHLY\n    QUARTERLY\n    SEMI_ANNUAL\n    ANNUAL\n}\n\ntype DiscountInfo {\n    originalAmount: Amount_Money!\n    discountType: DiscountType!\n    discountValue: Float!\n    source: DiscountSource!\n}\n\ntype SetupCost {\n    amount: Amount_Money!\n    currency: Currency!\n    billingDate: DateTime\n    paymentDate: DateTime\n}\n\ntype RecurringCost {\n    amount: Amount_Money!\n    currency: Currency!\n    billingCycle: BillingCycle!\n    nextBillingDate: DateTime\n    lastPaymentDate: DateTime\n    discount: DiscountInfo\n}\n\ntype ResourceDocument {\n    id: PHID!\n    label: String\n    thumbnailUrl: URL\n}\n\ntype BudgetCategory {\n    id: OID!\n    label: String!\n}\n\ntype ServiceFacetSelection {\n    id: OID!\n    facetName: String!\n    selectedOption: String!\n}\n\ntype ServiceMetric {\n    id: OID!\n    name: String!\n    unitName: String!\n    limit: Int\n    freeLimit: Int\n    paidLimit: Int\n    unitCost: RecurringCost\n    currentUsage: Int!\n    usageResetPeriod: ResetPeriod\n    nextUsageReset: DateTime\n}\n\ntype Service {\n    id: OID!\n    name: String\n    description: String\n    customValue: String\n    facetSelections: [ServiceFacetSelection!]!\n    setupCost: SetupCost\n    recurringCost: RecurringCost\n    metrics: [ServiceMetric!]!\n}\n\ntype ServiceGroup {\n    id: OID!\n    optional: Boolean!\n    name: String!\n    costType: GroupCostType\n    setupCost: SetupCost\n    recurringCost: RecurringCost\n    services: [Service!]!\n}",
                     examples: [],
-                    initialValue: '{"customerId": null, "customerName": null, "customerEmail": null, "customerType": null, "teamMemberCount": null, "operatorId": null, "serviceOfferingId": null, "tierName": null, "tierPricingOptionId": null, "tierPrice": null, "tierCurrency": null, "tierPricingMode": null, "selectedBillingCycle": null, "globalCurrency": null, "resource": null, "status": "DRAFT", "createdAt": null, "activatedSince": null, "pausedSince": null, "expiringSince": null, "renewalDate": null, "cancelledSince": null, "cancellationReason": null, "autoRenew": false, "operatorNotes": null, "budget": null, "nextBillingDate": null, "projectedBillAmount": null, "projectedBillCurrency": null, "services": [], "serviceGroups": []}',
+                    initialValue: '{"customerId":null,"customerName":null,"customerEmail":null,"customerType":null,"teamMemberCount":null,"operatorId":null,"serviceOfferingId":null,"tierName":null,"tierPricingOptionId":null,"tierPrice":null,"tierCurrency":null,"tierPricingMode":null,"selectedBillingCycle":null,"globalCurrency":null,"resource":null,"status":"PENDING","createdAt":null,"activatedSince":null,"pausedSince":null,"expiringSince":null,"renewalDate":null,"cancelledSince":null,"cancellationReason":null,"autoRenew":false,"operatorNotes":null,"budget":null,"nextBillingDate":null,"projectedBillAmount":null,"projectedBillCurrency":null,"services":[],"serviceGroups":[]}',
                 },
             },
             modules: [
                 {
-                    id: "subscription",
-                    name: "Subscription",
-                    description: "Operations for managing subscription lifecycle",
+                    id: "mod-subscription",
+                    name: "subscription",
+                    description: "Subscription lifecycle, customer info, tier, billing, and general management operations",
                     operations: [
                         {
-                            id: "initialize-subscription",
+                            id: "op-initialize-subscription",
                             name: "INITIALIZE_SUBSCRIPTION",
-                            description: "Initializes a subscription",
-                            schema: "input InitializeSubscriptionInput {\n    customerId: PHID\n    customerName: String\n    customerEmail: String\n    operatorId: PHID\n    serviceOfferingId: PHID\n    tierName: String\n    tierPricingOptionId: OID\n    tierPrice: Amount_Money\n    tierCurrency: Currency\n    tierPricingMode: TierPricingMode\n    selectedBillingCycle: BillingCycle\n    globalCurrency: Currency\n    createdAt: DateTime!\n}",
-                            template: "Initializes a subscription",
-                            reducer: 'state.customerId = action.input.customerId || null;\nstate.customerName = action.input.customerName || null;\nstate.customerEmail = action.input.customerEmail || null;\nstate.operatorId = action.input.operatorId || null;\nstate.serviceOfferingId = action.input.serviceOfferingId || null;\nstate.tierName = action.input.tierName || null;\nstate.tierPricingOptionId = action.input.tierPricingOptionId || null;\nstate.tierPrice = action.input.tierPrice || null;\nstate.tierCurrency = action.input.tierCurrency || null;\nstate.tierPricingMode = action.input.tierPricingMode || null;\nstate.selectedBillingCycle = action.input.selectedBillingCycle || null;\nstate.globalCurrency = action.input.globalCurrency || null;\nstate.createdAt = action.input.createdAt;\nstate.status = "DRAFT";',
+                            description: "Initialize a subscription from a service offering",
+                            schema: "input InitializeFacetSelectionInput {\n    id: OID!\n    facetName: String!\n    selectedOption: String!\n}\n\ninput DiscountInfoInitInput {\n    originalAmount: Amount_Money!\n    discountType: DiscountType!\n    discountValue: Float!\n    source: DiscountSource!\n}\n\ninput InitializeMetricInput {\n    id: OID!\n    name: String!\n    unitName: String!\n    limit: Int\n    freeLimit: Int\n    paidLimit: Int\n    currentUsage: Int!\n    usageResetPeriod: ResetPeriod\n    unitCostAmount: Amount_Money\n    unitCostCurrency: Currency\n    unitCostBillingCycle: BillingCycle\n}\n\ninput InitializeServiceInput {\n    id: OID!\n    name: String\n    description: String\n    customValue: String\n    facetSelections: [InitializeFacetSelectionInput!]\n    setupAmount: Amount_Money\n    setupCurrency: Currency\n    recurringAmount: Amount_Money\n    recurringCurrency: Currency\n    recurringBillingCycle: BillingCycle\n    recurringDiscount: DiscountInfoInitInput\n    metrics: [InitializeMetricInput!]\n}\n\ninput InitializeServiceGroupInput {\n    id: OID!\n    name: String!\n    optional: Boolean!\n    costType: GroupCostType\n    setupAmount: Amount_Money\n    setupCurrency: Currency\n    setupBillingDate: DateTime\n    recurringAmount: Amount_Money\n    recurringCurrency: Currency\n    recurringBillingCycle: BillingCycle\n    recurringDiscount: DiscountInfoInitInput\n    services: [InitializeServiceInput!]\n}\n\ninput InitializeSubscriptionInput {\n    customerId: PHID\n    customerName: String\n    customerEmail: EmailAddress\n    serviceOfferingId: PHID\n    tierName: String\n    tierPricingOptionId: OID\n    tierPrice: Amount_Money\n    tierCurrency: Currency\n    tierPricingMode: TierPricingMode\n    selectedBillingCycle: BillingCycle\n    globalCurrency: Currency\n    resourceId: PHID\n    resourceLabel: String\n    resourceThumbnailUrl: URL\n    autoRenew: Boolean\n    createdAt: DateTime!\n    services: [InitializeServiceInput!]\n    serviceGroups: [InitializeServiceGroupInput!]\n}",
+                            template: "Initialize a subscription from a service offering",
+                            reducer: 'state.customerId = action.input.customerId || null;\nstate.customerName = action.input.customerName || null;\nstate.customerEmail = action.input.customerEmail || null;\nstate.serviceOfferingId = action.input.serviceOfferingId || null;\nstate.tierName = action.input.tierName || null;\nstate.tierPricingOptionId = action.input.tierPricingOptionId || null;\nstate.tierPrice = action.input.tierPrice || null;\nstate.tierCurrency = action.input.tierCurrency || null;\nstate.tierPricingMode = action.input.tierPricingMode || null;\nstate.selectedBillingCycle = action.input.selectedBillingCycle || null;\nstate.globalCurrency = action.input.globalCurrency || null;\nif (action.input.resourceId) {\n  state.resource = {\n    id: action.input.resourceId,\n    label: action.input.resourceLabel || null,\n    thumbnailUrl: action.input.resourceThumbnailUrl || null,\n  };\n}\nstate.autoRenew = action.input.autoRenew || false;\nstate.createdAt = action.input.createdAt;\nstate.status = "PENDING";\nstate.services = (action.input.services || []).map((s) => ({\n  id: s.id,\n  name: s.name || null,\n  description: s.description || null,\n  customValue: s.customValue || null,\n  facetSelections: (s.facetSelections || []).map((fs) => ({\n    id: fs.id,\n    facetName: fs.facetName,\n    selectedOption: fs.selectedOption,\n  })),\n  setupCost: s.setupAmount && s.setupCurrency ? {\n    amount: s.setupAmount,\n    currency: s.setupCurrency,\n    billingDate: null,\n    paymentDate: null,\n  } : null,\n  recurringCost: s.recurringAmount && s.recurringCurrency && s.recurringBillingCycle ? {\n    amount: s.recurringAmount,\n    currency: s.recurringCurrency,\n    billingCycle: s.recurringBillingCycle,\n    nextBillingDate: null,\n    lastPaymentDate: null,\n    discount: s.recurringDiscount ? {\n      originalAmount: s.recurringDiscount.originalAmount,\n      discountType: s.recurringDiscount.discountType,\n      discountValue: s.recurringDiscount.discountValue,\n      source: s.recurringDiscount.source,\n    } : null,\n  } : null,\n  metrics: (s.metrics || []).map((m) => ({\n    id: m.id,\n    name: m.name,\n    unitName: m.unitName,\n    limit: m.limit || null,\n    freeLimit: m.freeLimit || null,\n    paidLimit: m.paidLimit || null,\n    unitCost: m.unitCostAmount && m.unitCostCurrency && m.unitCostBillingCycle ? {\n      amount: m.unitCostAmount,\n      currency: m.unitCostCurrency,\n      billingCycle: m.unitCostBillingCycle,\n      nextBillingDate: null,\n      lastPaymentDate: null,\n      discount: null,\n    } : null,\n    currentUsage: m.currentUsage,\n    usageResetPeriod: m.usageResetPeriod || null,\n    nextUsageReset: null,\n  })),\n}));\nstate.serviceGroups = (action.input.serviceGroups || []).map((sg) => ({\n  id: sg.id,\n  name: sg.name,\n  optional: sg.optional,\n  costType: sg.costType || null,\n  setupCost: sg.setupAmount && sg.setupCurrency ? {\n    amount: sg.setupAmount,\n    currency: sg.setupCurrency,\n    billingDate: sg.setupBillingDate || null,\n    paymentDate: null,\n  } : null,\n  recurringCost: sg.recurringAmount && sg.recurringCurrency && sg.recurringBillingCycle ? {\n    amount: sg.recurringAmount,\n    currency: sg.recurringCurrency,\n    billingCycle: sg.recurringBillingCycle,\n    nextBillingDate: null,\n    lastPaymentDate: null,\n    discount: sg.recurringDiscount ? {\n      originalAmount: sg.recurringDiscount.originalAmount,\n      discountType: sg.recurringDiscount.discountType,\n      discountValue: sg.recurringDiscount.discountValue,\n      source: sg.recurringDiscount.source,\n    } : null,\n  } : null,\n  services: (sg.services || []).map((s) => ({\n    id: s.id,\n    name: s.name || null,\n    description: s.description || null,\n    customValue: s.customValue || null,\n    facetSelections: (s.facetSelections || []).map((fs) => ({\n      id: fs.id,\n      facetName: fs.facetName,\n      selectedOption: fs.selectedOption,\n    })),\n    setupCost: s.setupAmount && s.setupCurrency ? {\n      amount: s.setupAmount,\n      currency: s.setupCurrency,\n      billingDate: null,\n      paymentDate: null,\n    } : null,\n    recurringCost: s.recurringAmount && s.recurringCurrency && s.recurringBillingCycle ? {\n      amount: s.recurringAmount,\n      currency: s.recurringCurrency,\n      billingCycle: s.recurringBillingCycle,\n      nextBillingDate: null,\n      lastPaymentDate: null,\n      discount: s.recurringDiscount ? {\n        originalAmount: s.recurringDiscount.originalAmount,\n        discountType: s.recurringDiscount.discountType,\n        discountValue: s.recurringDiscount.discountValue,\n        source: s.recurringDiscount.source,\n      } : null,\n    } : null,\n    metrics: (s.metrics || []).map((m) => ({\n      id: m.id,\n      name: m.name,\n      unitName: m.unitName,\n      limit: m.limit || null,\n      freeLimit: m.freeLimit || null,\n      paidLimit: m.paidLimit || null,\n      unitCost: m.unitCostAmount && m.unitCostCurrency && m.unitCostBillingCycle ? {\n        amount: m.unitCostAmount,\n        currency: m.unitCostCurrency,\n        billingCycle: m.unitCostBillingCycle,\n        nextBillingDate: null,\n        lastPaymentDate: null,\n        discount: null,\n      } : null,\n      currentUsage: m.currentUsage,\n      usageResetPeriod: m.usageResetPeriod || null,\n      nextUsageReset: null,\n    })),\n  })),\n}));',
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "set-resource-document",
+                            id: "op-set-resource-document",
                             name: "SET_RESOURCE_DOCUMENT",
-                            description: "Sets the resource document reference",
-                            schema: "input SetResourceDocumentInput {\n    documentId: PHID!\n    documentType: String!\n}",
-                            template: "Sets the resource document reference",
-                            reducer: "state.resource = { documentId: action.input.documentId, documentType: action.input.documentType };",
+                            description: "Link a resource document to the subscription",
+                            schema: "input SetResourceDocumentInput {\n    resourceId: PHID!\n    resourceLabel: String\n    resourceThumbnailUrl: URL\n}",
+                            template: "Link a resource document to the subscription",
+                            reducer: "state.resource = {\n  id: action.input.resourceId,\n  label: action.input.resourceLabel || null,\n  thumbnailUrl: action.input.resourceThumbnailUrl || null,\n};",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-subscription-status",
+                            id: "op-update-subscription-status",
                             name: "UPDATE_SUBSCRIPTION_STATUS",
-                            description: "Updates subscription status",
+                            description: "Directly update the subscription status",
                             schema: "input UpdateSubscriptionStatusInput {\n    status: SubscriptionStatus!\n}",
-                            template: "Updates subscription status",
+                            template: "Directly update the subscription status",
                             reducer: "state.status = action.input.status;",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "activate-subscription",
+                            id: "op-activate-subscription",
                             name: "ACTIVATE_SUBSCRIPTION",
-                            description: "Activates the subscription",
-                            schema: "input ActivateSubscriptionInput {\n    activatedAt: DateTime!\n}",
-                            template: "Activates the subscription",
-                            reducer: 'state.status = "ACTIVE";\nstate.activatedSince = action.input.activatedAt;',
-                            errors: [],
+                            description: "Activate a pending subscription",
+                            schema: "input ActivateSubscriptionInput {\n    activatedSince: DateTime!\n}",
+                            template: "Activate a pending subscription",
+                            reducer: 'if (state.status !== "PENDING") {\n  throw new ActivateNotPendingError(`Cannot activate subscription with status ${state.status}`);\n}\nstate.status = "ACTIVE";\nstate.activatedSince = action.input.activatedSince;',
+                            errors: [
+                                {
+                                    id: "err-activate-not-pending",
+                                    name: "ActivateNotPendingError",
+                                    code: "ACTIVATE_NOT_PENDING",
+                                    description: "Subscription must be in PENDING status to activate",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "pause-subscription",
+                            id: "op-pause-subscription",
                             name: "PAUSE_SUBSCRIPTION",
-                            description: "Pauses the subscription",
-                            schema: "input PauseSubscriptionInput {\n    pausedAt: DateTime!\n}",
-                            template: "Pauses the subscription",
-                            reducer: 'state.status = "PAUSED";\nstate.pausedSince = action.input.pausedAt;',
-                            errors: [],
+                            description: "Pause an active subscription",
+                            schema: "input PauseSubscriptionInput {\n    pausedSince: DateTime!\n}",
+                            template: "Pause an active subscription",
+                            reducer: 'if (state.status !== "ACTIVE") {\n  throw new PauseNotActiveError(`Cannot pause subscription with status ${state.status}`);\n}\nstate.status = "PAUSED";\nstate.pausedSince = action.input.pausedSince;',
+                            errors: [
+                                {
+                                    id: "err-pause-not-active",
+                                    name: "PauseNotActiveError",
+                                    code: "PAUSE_NOT_ACTIVE",
+                                    description: "Subscription must be in ACTIVE status to pause",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "set-expiring",
+                            id: "op-set-expiring",
                             name: "SET_EXPIRING",
-                            description: "Sets expiring status",
-                            schema: "input SetExpiringInput {\n    expiringAt: DateTime!\n    renewalDate: DateTime\n}",
-                            template: "Sets expiring status",
-                            reducer: 'state.status = "EXPIRING";\nstate.expiringSince = action.input.expiringAt;\nif (action.input.renewalDate) state.renewalDate = action.input.renewalDate;',
-                            errors: [],
+                            description: "Mark subscription as expiring",
+                            schema: "input SetExpiringInput {\n    expiringSince: DateTime!\n}",
+                            template: "Mark subscription as expiring",
+                            reducer: 'if (state.status !== "ACTIVE") {\n  throw new SetExpiringNotActiveError(`Cannot set expiring on subscription with status ${state.status}`);\n}\nstate.status = "EXPIRING";\nstate.expiringSince = action.input.expiringSince;',
+                            errors: [
+                                {
+                                    id: "err-set-expiring-not-active",
+                                    name: "SetExpiringNotActiveError",
+                                    code: "SET_EXPIRING_NOT_ACTIVE",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "cancel-subscription",
+                            id: "op-cancel-subscription",
                             name: "CANCEL_SUBSCRIPTION",
-                            description: "Cancels the subscription",
-                            schema: "input CancelSubscriptionInput {\n    cancelledAt: DateTime!\n    reason: String\n}",
-                            template: "Cancels the subscription",
-                            reducer: 'state.status = "CANCELLED";\nstate.cancelledSince = action.input.cancelledAt;\nstate.cancellationReason = action.input.reason || null;',
-                            errors: [],
+                            description: "Cancel a subscription with optional reason",
+                            schema: "input CancelSubscriptionInput {\n    cancelledSince: DateTime!\n    cancellationReason: String\n}",
+                            template: "Cancel a subscription with optional reason",
+                            reducer: 'if (state.status === "CANCELLED") {\n  throw new CancelAlreadyCancelledError("Subscription is already cancelled");\n}\nstate.status = "CANCELLED";\nstate.cancelledSince = action.input.cancelledSince;\nstate.cancellationReason = action.input.cancellationReason || null;',
+                            errors: [
+                                {
+                                    id: "err-cancel-already-cancelled",
+                                    name: "CancelAlreadyCancelledError",
+                                    code: "CANCEL_ALREADY_CANCELLED",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "resume-subscription",
+                            id: "op-resume-subscription",
                             name: "RESUME_SUBSCRIPTION",
-                            description: "Resumes the subscription",
-                            schema: "input ResumeSubscriptionInput {\n    resumedAt: DateTime!\n}",
-                            template: "Resumes the subscription",
-                            reducer: 'state.status = "ACTIVE";\nstate.activatedSince = action.input.resumedAt;\nstate.pausedSince = null;',
-                            errors: [],
+                            description: "Resume a paused subscription",
+                            schema: "input ResumeSubscriptionInput {\n    timestamp: DateTime!\n}",
+                            template: "Resume a paused subscription",
+                            reducer: 'if (state.status !== "PAUSED") {\n  throw new ResumeNotPausedError(`Cannot resume subscription with status ${state.status}`);\n}\nstate.status = "ACTIVE";\nstate.pausedSince = null;',
+                            errors: [
+                                {
+                                    id: "err-resume-not-paused",
+                                    name: "ResumeNotPausedError",
+                                    code: "RESUME_NOT_PAUSED",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "renew-expiring-subscription",
+                            id: "op-renew-expiring-subscription",
                             name: "RENEW_EXPIRING_SUBSCRIPTION",
-                            description: "Renews an expiring subscription",
-                            schema: "input RenewExpiringSubscriptionInput {\n    renewedAt: DateTime!\n    newRenewalDate: DateTime\n}",
-                            template: "Renews an expiring subscription",
-                            reducer: 'state.status = "ACTIVE";\nstate.activatedSince = action.input.renewedAt;\nstate.expiringSince = null;\nif (action.input.newRenewalDate) state.renewalDate = action.input.newRenewalDate;',
-                            errors: [],
+                            description: "Renew an expiring subscription",
+                            schema: "input RenewExpiringSubscriptionInput {\n    timestamp: DateTime!\n    newRenewalDate: DateTime\n}",
+                            template: "Renew an expiring subscription",
+                            reducer: 'if (state.status !== "EXPIRING") {\n  throw new RenewNotExpiringError(`Cannot renew subscription with status ${state.status}`);\n}\nstate.status = "ACTIVE";\nstate.expiringSince = null;\nstate.renewalDate = action.input.newRenewalDate || null;',
+                            errors: [
+                                {
+                                    id: "err-renew-not-expiring",
+                                    name: "RenewNotExpiringError",
+                                    code: "RENEW_NOT_EXPIRING",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "set-budget-category",
+                            id: "op-set-budget-category",
                             name: "SET_BUDGET_CATEGORY",
-                            description: "Sets the budget category",
-                            schema: "input SetBudgetCategoryInput {\n    id: OID!\n    name: String!\n    description: String\n}",
-                            template: "Sets the budget category",
-                            reducer: "state.budget = { id: action.input.id, name: action.input.name, description: action.input.description || null };",
+                            description: "Assign a budget category",
+                            schema: "input SetBudgetCategoryInput {\n    budgetId: OID!\n    budgetLabel: String!\n}",
+                            template: "Assign a budget category",
+                            reducer: "state.budget = {\n  id: action.input.budgetId,\n  label: action.input.budgetLabel,\n};",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "remove-budget-category",
+                            id: "op-remove-budget-category",
                             name: "REMOVE_BUDGET_CATEGORY",
-                            description: "Removes the budget category",
-                            schema: "input RemoveBudgetCategoryInput {\n    id: OID!\n}",
-                            template: "Removes the budget category",
-                            reducer: "state.budget = null;",
-                            errors: [],
+                            description: "Remove budget category",
+                            schema: "input RemoveBudgetCategoryInput {\n    budgetId: OID!\n}",
+                            template: "Remove budget category",
+                            reducer: "if (!state.budget || state.budget.id !== action.input.budgetId) {\n  throw new RemoveBudgetNotFoundError(`Budget category with ID ${action.input.budgetId} not found`);\n}\nstate.budget = null;",
+                            errors: [
+                                {
+                                    id: "err-remove-budget-not-found",
+                                    name: "RemoveBudgetNotFoundError",
+                                    code: "REMOVE_BUDGET_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-customer-info",
+                            id: "op-update-customer-info",
                             name: "UPDATE_CUSTOMER_INFO",
-                            description: "Updates customer info",
-                            schema: "input UpdateCustomerInfoInput {\n    customerName: String\n    customerEmail: String\n}",
-                            template: "Updates customer info",
-                            reducer: "if (action.input.customerName) state.customerName = action.input.customerName;\nif (action.input.customerEmail) state.customerEmail = action.input.customerEmail;",
+                            description: "Update customer details",
+                            schema: "input UpdateCustomerInfoInput {\n    customerId: PHID\n    customerName: String\n    customerEmail: EmailAddress\n}",
+                            template: "Update customer details",
+                            reducer: "if (action.input.customerId !== undefined) state.customerId = action.input.customerId || null;\nif (action.input.customerName !== undefined) state.customerName = action.input.customerName || null;\nif (action.input.customerEmail !== undefined) state.customerEmail = action.input.customerEmail || null;",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-tier-info",
+                            id: "op-update-tier-info",
                             name: "UPDATE_TIER_INFO",
-                            description: "Updates tier info",
-                            schema: "input UpdateTierInfoInput {\n    tierName: String\n    tierPricingOptionId: OID\n    tierPrice: Amount_Money\n    tierCurrency: Currency\n    tierPricingMode: TierPricingMode\n    selectedBillingCycle: BillingCycle\n}",
-                            template: "Updates tier info",
-                            reducer: "if (action.input.tierName) state.tierName = action.input.tierName;\nif (action.input.tierPricingOptionId) state.tierPricingOptionId = action.input.tierPricingOptionId;\nif (action.input.tierPrice) state.tierPrice = action.input.tierPrice;\nif (action.input.tierCurrency) state.tierCurrency = action.input.tierCurrency;\nif (action.input.tierPricingMode) state.tierPricingMode = action.input.tierPricingMode;\nif (action.input.selectedBillingCycle) state.selectedBillingCycle = action.input.selectedBillingCycle;",
+                            description: "Update tier selection and pricing",
+                            schema: "input UpdateTierInfoInput {\n    tierName: String\n    tierPricingOptionId: OID\n    tierPrice: Amount_Money\n    tierCurrency: Currency\n    tierPricingMode: TierPricingMode\n}",
+                            template: "Update tier selection and pricing",
+                            reducer: "if (action.input.tierName !== undefined) state.tierName = action.input.tierName || null;\nif (action.input.tierPricingOptionId !== undefined) state.tierPricingOptionId = action.input.tierPricingOptionId || null;\nif (action.input.tierPrice !== undefined) state.tierPrice = action.input.tierPrice || null;\nif (action.input.tierCurrency !== undefined) state.tierCurrency = action.input.tierCurrency || null;\nif (action.input.tierPricingMode !== undefined) state.tierPricingMode = action.input.tierPricingMode || null;",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "set-operator-notes",
+                            id: "op-set-operator-notes",
                             name: "SET_OPERATOR_NOTES",
-                            description: "Sets operator notes",
-                            schema: "input SetOperatorNotesInput {\n    notes: String\n}",
-                            template: "Sets operator notes",
-                            reducer: "state.operatorNotes = action.input.notes || null;",
+                            description: "Set operator notes",
+                            schema: "input SetOperatorNotesInput {\n    operatorNotes: String\n}",
+                            template: "Set operator notes",
+                            reducer: "state.operatorNotes = action.input.operatorNotes || null;",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "set-auto-renew",
+                            id: "op-set-auto-renew",
                             name: "SET_AUTO_RENEW",
-                            description: "Sets auto-renew flag",
+                            description: "Toggle auto-renewal",
                             schema: "input SetAutoRenewInput {\n    autoRenew: Boolean!\n}",
-                            template: "Sets auto-renew flag",
+                            template: "Toggle auto-renewal",
                             reducer: "state.autoRenew = action.input.autoRenew;",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "set-renewal-date",
+                            id: "op-set-renewal-date",
                             name: "SET_RENEWAL_DATE",
-                            description: "Sets the renewal date",
+                            description: "Set renewal date",
                             schema: "input SetRenewalDateInput {\n    renewalDate: DateTime!\n}",
-                            template: "Sets the renewal date",
+                            template: "Set renewal date",
                             reducer: "state.renewalDate = action.input.renewalDate;",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-billing-projection",
+                            id: "op-update-billing-projection",
                             name: "UPDATE_BILLING_PROJECTION",
-                            description: "Updates billing projection",
+                            description: "Update billing projections",
                             schema: "input UpdateBillingProjectionInput {\n    nextBillingDate: DateTime\n    projectedBillAmount: Amount_Money\n    projectedBillCurrency: Currency\n}",
-                            template: "Updates billing projection",
-                            reducer: "if (action.input.nextBillingDate) state.nextBillingDate = action.input.nextBillingDate;\nif (action.input.projectedBillAmount) state.projectedBillAmount = action.input.projectedBillAmount;\nif (action.input.projectedBillCurrency) state.projectedBillCurrency = action.input.projectedBillCurrency;",
+                            template: "Update billing projections",
+                            reducer: "if (action.input.nextBillingDate !== undefined) state.nextBillingDate = action.input.nextBillingDate || null;\nif (action.input.projectedBillAmount !== undefined) state.projectedBillAmount = action.input.projectedBillAmount || null;\nif (action.input.projectedBillCurrency !== undefined) state.projectedBillCurrency = action.input.projectedBillCurrency || null;",
                             errors: [],
                             examples: [],
                             scope: "global",
@@ -217,268 +273,454 @@ export const documentModel = {
                     ],
                 },
                 {
-                    id: "service",
-                    name: "Service",
-                    description: "Operations for managing subscription services",
+                    id: "mod-service",
+                    name: "service",
+                    description: "Standalone service CRUD, cost management, facet selections, and payment tracking",
                     operations: [
                         {
-                            id: "add-service",
+                            id: "op-add-service",
                             name: "ADD_SERVICE",
-                            description: "Adds a service to the subscription",
-                            schema: "input AddServiceInput {\n    id: OID!\n    name: String!\n    description: String\n    customValue: String\n}",
-                            template: "Adds a service to the subscription",
-                            reducer: "state.services.push({ id: action.input.id, name: action.input.name, description: action.input.description || null, customValue: action.input.customValue || null, facetSelections: [], setupCost: null, recurringCost: null, metrics: [] });",
+                            description: "Add a standalone service",
+                            schema: "input DiscountServiceInfoInput {\n    originalAmount: Amount_Money!\n    discountType: DiscountType!\n    discountValue: Float!\n    source: DiscountSource!\n}\n\ninput AddServiceInput {\n    serviceId: OID!\n    name: String\n    description: String\n    customValue: String\n    setupAmount: Amount_Money\n    setupCurrency: Currency\n    setupBillingDate: DateTime\n    setupPaymentDate: DateTime\n    recurringAmount: Amount_Money\n    recurringCurrency: Currency\n    recurringBillingCycle: BillingCycle\n    recurringNextBillingDate: DateTime\n    recurringLastPaymentDate: DateTime\n    recurringDiscount: DiscountServiceInfoInput\n}",
+                            template: "Add a standalone service",
+                            reducer: "const service = {\n  id: action.input.serviceId,\n  name: action.input.name || null,\n  description: action.input.description || null,\n  customValue: action.input.customValue || null,\n  facetSelections: [],\n  setupCost: action.input.setupAmount && action.input.setupCurrency ? {\n    amount: action.input.setupAmount,\n    currency: action.input.setupCurrency,\n    billingDate: action.input.setupBillingDate || null,\n    paymentDate: action.input.setupPaymentDate || null,\n  } : null,\n  recurringCost: action.input.recurringAmount && action.input.recurringCurrency && action.input.recurringBillingCycle ? {\n    amount: action.input.recurringAmount,\n    currency: action.input.recurringCurrency,\n    billingCycle: action.input.recurringBillingCycle,\n    nextBillingDate: action.input.recurringNextBillingDate || null,\n    lastPaymentDate: action.input.recurringLastPaymentDate || null,\n    discount: action.input.recurringDiscount ? {\n      originalAmount: action.input.recurringDiscount.originalAmount,\n      discountType: action.input.recurringDiscount.discountType,\n      discountValue: action.input.recurringDiscount.discountValue,\n      source: action.input.recurringDiscount.source,\n    } : null,\n  } : null,\n  metrics: [],\n};\nstate.services.push(service);",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "remove-service",
+                            id: "op-remove-service",
                             name: "REMOVE_SERVICE",
-                            description: "Removes a service from the subscription",
-                            schema: "input RemoveServiceInput {\n    id: OID!\n}",
-                            template: "Removes a service from the subscription",
-                            reducer: "const serviceIndex = state.services.findIndex(s => s.id === action.input.id);\nif (serviceIndex !== -1) { state.services.splice(serviceIndex, 1); }",
-                            errors: [],
+                            description: "Remove a standalone service",
+                            schema: "input RemoveServiceInput {\n    serviceId: OID!\n}",
+                            template: "Remove a standalone service",
+                            reducer: "const index = state.services.findIndex((s) => s.id === action.input.serviceId);\nif (index === -1) {\n  throw new RemoveServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nstate.services.splice(index, 1);",
+                            errors: [
+                                {
+                                    id: "err-remove-service-not-found",
+                                    name: "RemoveServiceNotFoundError",
+                                    code: "REMOVE_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-service-setup-cost",
+                            id: "op-update-service-setup-cost",
                             name: "UPDATE_SERVICE_SETUP_COST",
-                            description: "Updates service setup cost",
-                            schema: "input UpdateServiceSetupCostInput {\n    serviceId: OID!\n    amount: Amount_Money!\n    currency: Currency!\n}",
-                            template: "Updates service setup cost",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) { service.setupCost = { amount: action.input.amount, currency: action.input.currency, paidAmount: null, paidAt: null }; }",
-                            errors: [],
+                            description: "Update setup cost for a service",
+                            schema: "input UpdateServiceSetupCostInput {\n    serviceId: OID!\n    amount: Amount_Money\n    currency: Currency\n    billingDate: DateTime\n    paymentDate: DateTime\n}",
+                            template: "Update setup cost for a service",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new UpdateServiceSetupCostNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nif (action.input.amount && action.input.currency) {\n  svc.setupCost = {\n    amount: action.input.amount,\n    currency: action.input.currency,\n    billingDate: action.input.billingDate || null,\n    paymentDate: action.input.paymentDate || null,\n  };\n} else if (svc.setupCost) {\n  if (action.input.amount) svc.setupCost.amount = action.input.amount;\n  if (action.input.currency) svc.setupCost.currency = action.input.currency;\n  if (action.input.billingDate !== undefined) svc.setupCost.billingDate = action.input.billingDate || null;\n  if (action.input.paymentDate !== undefined) svc.setupCost.paymentDate = action.input.paymentDate || null;\n}",
+                            errors: [
+                                {
+                                    id: "err-update-service-setup-cost-not-found",
+                                    name: "UpdateServiceSetupCostNotFoundError",
+                                    code: "UPDATE_SERVICE_SETUP_COST_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-service-recurring-cost",
+                            id: "op-update-service-recurring-cost",
                             name: "UPDATE_SERVICE_RECURRING_COST",
-                            description: "Updates service recurring cost",
-                            schema: "input UpdateServiceRecurringCostInput {\n    serviceId: OID!\n    amount: Amount_Money!\n    currency: Currency!\n}",
-                            template: "Updates service recurring cost",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) { service.recurringCost = { amount: action.input.amount, currency: action.input.currency, paidAmount: null, paidAt: null }; }",
-                            errors: [],
+                            description: "Update recurring cost for a service",
+                            schema: "input UpdateServiceRecurringCostInput {\n    serviceId: OID!\n    amount: Amount_Money\n    currency: Currency\n    billingCycle: BillingCycle\n    nextBillingDate: DateTime\n    lastPaymentDate: DateTime\n}",
+                            template: "Update recurring cost for a service",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new UpdateServiceRecurringCostNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nif (action.input.amount && action.input.currency && action.input.billingCycle) {\n  svc.recurringCost = {\n    amount: action.input.amount,\n    currency: action.input.currency,\n    billingCycle: action.input.billingCycle,\n    nextBillingDate: action.input.nextBillingDate || null,\n    lastPaymentDate: action.input.lastPaymentDate || null,\n    discount: svc.recurringCost?.discount || null,\n  };\n} else if (svc.recurringCost) {\n  if (action.input.amount) svc.recurringCost.amount = action.input.amount;\n  if (action.input.currency) svc.recurringCost.currency = action.input.currency;\n  if (action.input.billingCycle) svc.recurringCost.billingCycle = action.input.billingCycle;\n  if (action.input.nextBillingDate !== undefined) svc.recurringCost.nextBillingDate = action.input.nextBillingDate || null;\n  if (action.input.lastPaymentDate !== undefined) svc.recurringCost.lastPaymentDate = action.input.lastPaymentDate || null;\n}",
+                            errors: [
+                                {
+                                    id: "err-update-service-recurring-cost-not-found",
+                                    name: "UpdateServiceRecurringCostNotFoundError",
+                                    code: "UPDATE_SERVICE_RECURRING_COST_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "report-setup-payment",
+                            id: "op-report-setup-payment",
                             name: "REPORT_SETUP_PAYMENT",
-                            description: "Reports a setup payment",
-                            schema: "input ReportSetupPaymentInput {\n    serviceId: OID!\n    paidAmount: Amount_Money!\n    paidAt: DateTime!\n}",
-                            template: "Reports a setup payment",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service && service.setupCost) { service.setupCost.paidAmount = action.input.paidAmount; service.setupCost.paidAt = action.input.paidAt; }",
-                            errors: [],
+                            description: "Record a setup payment",
+                            schema: "input ReportSetupPaymentInput {\n    serviceId: OID!\n    paymentDate: DateTime!\n}",
+                            template: "Record a setup payment",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new ReportSetupPaymentServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nif (svc.setupCost) {\n  svc.setupCost.paymentDate = action.input.paymentDate;\n}",
+                            errors: [
+                                {
+                                    id: "err-report-setup-payment-not-found",
+                                    name: "ReportSetupPaymentServiceNotFoundError",
+                                    code: "REPORT_SETUP_PAYMENT_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "report-recurring-payment",
+                            id: "op-report-recurring-payment",
                             name: "REPORT_RECURRING_PAYMENT",
-                            description: "Reports a recurring payment",
-                            schema: "input ReportRecurringPaymentInput {\n    serviceId: OID!\n    paidAmount: Amount_Money!\n    paidAt: DateTime!\n}",
-                            template: "Reports a recurring payment",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service && service.recurringCost) { service.recurringCost.paidAmount = action.input.paidAmount; service.recurringCost.paidAt = action.input.paidAt; }",
-                            errors: [],
+                            description: "Record a recurring payment",
+                            schema: "input ReportRecurringPaymentInput {\n    serviceId: OID!\n    paymentDate: DateTime!\n}",
+                            template: "Record a recurring payment",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new ReportRecurringPaymentServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nif (svc.recurringCost) {\n  svc.recurringCost.lastPaymentDate = action.input.paymentDate;\n}",
+                            errors: [
+                                {
+                                    id: "err-report-recurring-payment-not-found",
+                                    name: "ReportRecurringPaymentServiceNotFoundError",
+                                    code: "REPORT_RECURRING_PAYMENT_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-service-info",
+                            id: "op-update-service-info",
                             name: "UPDATE_SERVICE_INFO",
-                            description: "Updates service info",
+                            description: "Update service name, description, custom value",
                             schema: "input UpdateServiceInfoInput {\n    serviceId: OID!\n    name: String\n    description: String\n    customValue: String\n}",
-                            template: "Updates service info",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) {\n    if (action.input.name) service.name = action.input.name;\n    if (action.input.description !== undefined) service.description = action.input.description || null;\n    if (action.input.customValue !== undefined) service.customValue = action.input.customValue || null;\n}",
-                            errors: [],
+                            template: "Update service name, description, custom value",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new UpdateServiceInfoNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nif (action.input.name !== undefined) svc.name = action.input.name || null;\nif (action.input.description !== undefined) svc.description = action.input.description || null;\nif (action.input.customValue !== undefined) svc.customValue = action.input.customValue || null;",
+                            errors: [
+                                {
+                                    id: "err-update-service-info-not-found",
+                                    name: "UpdateServiceInfoNotFoundError",
+                                    code: "UPDATE_SERVICE_INFO_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "add-service-facet-selection",
+                            id: "op-add-service-facet-selection",
                             name: "ADD_SERVICE_FACET_SELECTION",
-                            description: "Adds a facet selection to a service",
-                            schema: "input AddServiceFacetSelectionInput {\n    serviceId: OID!\n    id: OID!\n    facetName: String!\n    selectedOption: String!\n}",
-                            template: "Adds a facet selection to a service",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) { service.facetSelections.push({ id: action.input.id, facetName: action.input.facetName, selectedOption: action.input.selectedOption }); }",
-                            errors: [],
+                            description: "Add facet selection to a service",
+                            schema: "input AddServiceFacetSelectionInput {\n    serviceId: OID!\n    facetSelectionId: OID!\n    facetName: String!\n    selectedOption: String!\n}",
+                            template: "Add facet selection to a service",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new AddServiceFacetSelectionServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nsvc.facetSelections.push({\n  id: action.input.facetSelectionId,\n  facetName: action.input.facetName,\n  selectedOption: action.input.selectedOption,\n});",
+                            errors: [
+                                {
+                                    id: "err-add-facet-service-not-found",
+                                    name: "AddServiceFacetSelectionServiceNotFoundError",
+                                    code: "ADD_FACET_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "remove-service-facet-selection",
+                            id: "op-remove-service-facet-selection",
                             name: "REMOVE_SERVICE_FACET_SELECTION",
-                            description: "Removes a facet selection",
+                            description: "Remove facet selection from a service",
                             schema: "input RemoveServiceFacetSelectionInput {\n    serviceId: OID!\n    facetSelectionId: OID!\n}",
-                            template: "Removes a facet selection",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) {\n    const fsIndex = service.facetSelections.findIndex(fs => fs.id === action.input.facetSelectionId);\n    if (fsIndex !== -1) { service.facetSelections.splice(fsIndex, 1); }\n}",
-                            errors: [],
+                            template: "Remove facet selection from a service",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new RemoveServiceFacetSelectionServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nconst index = svc.facetSelections.findIndex((fs) => fs.id === action.input.facetSelectionId);\nif (index !== -1) {\n  svc.facetSelections.splice(index, 1);\n}",
+                            errors: [
+                                {
+                                    id: "err-remove-facet-service-not-found",
+                                    name: "RemoveServiceFacetSelectionServiceNotFoundError",
+                                    code: "REMOVE_FACET_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                     ],
                 },
                 {
-                    id: "service-group",
-                    name: "Service Group",
-                    description: "Operations for managing service groups",
+                    id: "mod-service-group",
+                    name: "service-group",
+                    description: "Service group management and grouped service operations",
                     operations: [
                         {
-                            id: "add-service-group",
+                            id: "op-add-service-group",
                             name: "ADD_SERVICE_GROUP",
-                            description: "Adds a service group",
-                            schema: "input AddServiceGroupInput {\n    id: OID!\n    name: String!\n    optional: Boolean!\n    costType: GroupCostType\n}",
-                            template: "Adds a service group",
-                            reducer: "state.serviceGroups.push({ id: action.input.id, name: action.input.name, optional: action.input.optional, costType: action.input.costType || null, setupCost: null, recurringCost: null, services: [] });",
+                            description: "Add a service group",
+                            schema: "input AddServiceGroupInput {\n    groupId: OID!\n    name: String!\n    optional: Boolean!\n    costType: GroupCostType\n    setupAmount: Amount_Money\n    setupCurrency: Currency\n    setupBillingDate: DateTime\n    recurringAmount: Amount_Money\n    recurringCurrency: Currency\n    recurringBillingCycle: BillingCycle\n    recurringDiscount: DiscountServiceInfoInput\n}",
+                            template: "Add a service group",
+                            reducer: "state.serviceGroups.push({\n  id: action.input.groupId,\n  name: action.input.name,\n  optional: action.input.optional,\n  costType: action.input.costType || null,\n  setupCost: action.input.setupAmount && action.input.setupCurrency ? {\n    amount: action.input.setupAmount,\n    currency: action.input.setupCurrency,\n    billingDate: action.input.setupBillingDate || null,\n    paymentDate: null,\n  } : null,\n  recurringCost: action.input.recurringAmount && action.input.recurringCurrency && action.input.recurringBillingCycle ? {\n    amount: action.input.recurringAmount,\n    currency: action.input.recurringCurrency,\n    billingCycle: action.input.recurringBillingCycle,\n    nextBillingDate: null,\n    lastPaymentDate: null,\n    discount: action.input.recurringDiscount ? {\n      originalAmount: action.input.recurringDiscount.originalAmount,\n      discountType: action.input.recurringDiscount.discountType,\n      discountValue: action.input.recurringDiscount.discountValue,\n      source: action.input.recurringDiscount.source,\n    } : null,\n  } : null,\n  services: [],\n});",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "remove-service-group",
+                            id: "op-remove-service-group",
                             name: "REMOVE_SERVICE_GROUP",
-                            description: "Removes a service group",
-                            schema: "input RemoveServiceGroupInput {\n    id: OID!\n}",
-                            template: "Removes a service group",
-                            reducer: "const groupIndex = state.serviceGroups.findIndex(g => g.id === action.input.id);\nif (groupIndex !== -1) { state.serviceGroups.splice(groupIndex, 1); }",
-                            errors: [],
+                            description: "Remove a service group",
+                            schema: "input RemoveServiceGroupInput {\n    groupId: OID!\n}",
+                            template: "Remove a service group",
+                            reducer: "const index = state.serviceGroups.findIndex((g) => g.id === action.input.groupId);\nif (index === -1) {\n  throw new RemoveServiceGroupNotFoundError(`Service group with ID ${action.input.groupId} not found`);\n}\nstate.serviceGroups.splice(index, 1);",
+                            errors: [
+                                {
+                                    id: "err-remove-group-not-found",
+                                    name: "RemoveServiceGroupNotFoundError",
+                                    code: "REMOVE_GROUP_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "add-service-to-group",
+                            id: "op-add-service-to-group",
                             name: "ADD_SERVICE_TO_GROUP",
-                            description: "Adds a service to a group",
-                            schema: "input AddServiceToGroupInput {\n    groupId: OID!\n    serviceId: OID!\n}",
-                            template: "Adds a service to a group",
-                            reducer: "const group = state.serviceGroups.find(g => g.id === action.input.groupId);\nif (group && !group.services.includes(action.input.serviceId)) { group.services.push(action.input.serviceId); }",
-                            errors: [],
+                            description: "Add a service to a group",
+                            schema: "input AddServiceToGroupInput {\n    groupId: OID!\n    serviceId: OID!\n    name: String\n    description: String\n    customValue: String\n    setupAmount: Amount_Money\n    setupCurrency: Currency\n    setupBillingDate: DateTime\n    setupPaymentDate: DateTime\n    recurringAmount: Amount_Money\n    recurringCurrency: Currency\n    recurringBillingCycle: BillingCycle\n    recurringNextBillingDate: DateTime\n    recurringLastPaymentDate: DateTime\n}",
+                            template: "Add a service to a group",
+                            reducer: "const group = state.serviceGroups.find((g) => g.id === action.input.groupId);\nif (!group) {\n  throw new AddServiceToGroupGroupNotFoundError(`Service group with ID ${action.input.groupId} not found`);\n}\ngroup.services.push({\n  id: action.input.serviceId,\n  name: action.input.name || null,\n  description: action.input.description || null,\n  customValue: action.input.customValue || null,\n  facetSelections: [],\n  setupCost: action.input.setupAmount && action.input.setupCurrency ? {\n    amount: action.input.setupAmount,\n    currency: action.input.setupCurrency,\n    billingDate: action.input.setupBillingDate || null,\n    paymentDate: action.input.setupPaymentDate || null,\n  } : null,\n  recurringCost: action.input.recurringAmount && action.input.recurringCurrency && action.input.recurringBillingCycle ? {\n    amount: action.input.recurringAmount,\n    currency: action.input.recurringCurrency,\n    billingCycle: action.input.recurringBillingCycle,\n    nextBillingDate: action.input.recurringNextBillingDate || null,\n    lastPaymentDate: action.input.recurringLastPaymentDate || null,\n    discount: null,\n  } : null,\n  metrics: [],\n});",
+                            errors: [
+                                {
+                                    id: "err-add-to-group-not-found",
+                                    name: "AddServiceToGroupGroupNotFoundError",
+                                    code: "ADD_TO_GROUP_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "remove-service-from-group",
+                            id: "op-remove-service-from-group",
                             name: "REMOVE_SERVICE_FROM_GROUP",
-                            description: "Removes a service from a group",
+                            description: "Remove a service from a group",
                             schema: "input RemoveServiceFromGroupInput {\n    groupId: OID!\n    serviceId: OID!\n}",
-                            template: "Removes a service from a group",
-                            reducer: "const group = state.serviceGroups.find(g => g.id === action.input.groupId);\nif (group) {\n    const sIndex = group.services.indexOf(action.input.serviceId);\n    if (sIndex !== -1) { group.services.splice(sIndex, 1); }\n}",
-                            errors: [],
-                            examples: [],
-                            scope: "global",
-                        },
-                        {
-                            id: "update-service-group-cost",
+                            template: "Remove a service from a group",
+                            reducer: "const group = state.serviceGroups.find((g) => g.id === action.input.groupId);\nif (!group) {\n  throw new RemoveServiceFromGroupGroupNotFoundError(`Service group with ID ${action.input.groupId} not found`);\n}\nconst index = group.services.findIndex((s) => s.id === action.input.serviceId);\nif (index === -1) {\n  throw new RemoveServiceFromGroupServiceNotFoundError(`Service with ID ${action.input.serviceId} not found in group ${action.input.groupId}`);\n}\ngroup.services.splice(index, 1);",
+                            errors: [
+                                {
+                                    id: "err-remove-from-group-not-found",
+                                    name: "RemoveServiceFromGroupGroupNotFoundError",
+                                    code: "REMOVE_FROM_GROUP_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                                {
+                                    id: "err-remove-from-group-service-not-found",
+                                    name: "RemoveServiceFromGroupServiceNotFoundError",
+                                    code: "REMOVE_FROM_GROUP_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "op-update-service-group-cost",
                             name: "UPDATE_SERVICE_GROUP_COST",
-                            description: "Updates service group cost",
-                            schema: "input UpdateServiceGroupCostInput {\n    groupId: OID!\n    costType: GroupCostType!\n    amount: Amount_Money!\n    currency: Currency!\n}",
-                            template: "Updates service group cost",
-                            reducer: 'const group = state.serviceGroups.find(g => g.id === action.input.groupId);\nif (group) {\n    group.costType = action.input.costType;\n    const cost = { amount: action.input.amount, currency: action.input.currency, paidAmount: null, paidAt: null };\n    if (action.input.costType === "SETUP") { group.setupCost = cost; } else { group.recurringCost = cost; }\n}',
-                            errors: [],
+                            description: "Update group setup and recurring costs",
+                            schema: "input UpdateServiceGroupCostInput {\n    groupId: OID!\n    setupAmount: Amount_Money\n    setupCurrency: Currency\n    setupBillingDate: DateTime\n    recurringAmount: Amount_Money\n    recurringCurrency: Currency\n    recurringBillingCycle: BillingCycle\n}",
+                            template: "Update group setup and recurring costs",
+                            reducer: "const group = state.serviceGroups.find((g) => g.id === action.input.groupId);\nif (!group) {\n  throw new UpdateServiceGroupCostNotFoundError(`Service group with ID ${action.input.groupId} not found`);\n}\nif (action.input.setupAmount && action.input.setupCurrency) {\n  group.setupCost = {\n    amount: action.input.setupAmount,\n    currency: action.input.setupCurrency,\n    billingDate: action.input.setupBillingDate || null,\n    paymentDate: group.setupCost?.paymentDate || null,\n  };\n} else if (group.setupCost) {\n  if (action.input.setupAmount) group.setupCost.amount = action.input.setupAmount;\n  if (action.input.setupCurrency) group.setupCost.currency = action.input.setupCurrency;\n  if (action.input.setupBillingDate !== undefined) group.setupCost.billingDate = action.input.setupBillingDate || null;\n}\nif (action.input.recurringAmount && action.input.recurringCurrency && action.input.recurringBillingCycle) {\n  group.recurringCost = {\n    amount: action.input.recurringAmount,\n    currency: action.input.recurringCurrency,\n    billingCycle: action.input.recurringBillingCycle,\n    nextBillingDate: group.recurringCost?.nextBillingDate || null,\n    lastPaymentDate: group.recurringCost?.lastPaymentDate || null,\n    discount: group.recurringCost?.discount || null,\n  };\n} else if (group.recurringCost) {\n  if (action.input.recurringAmount) group.recurringCost.amount = action.input.recurringAmount;\n  if (action.input.recurringCurrency) group.recurringCost.currency = action.input.recurringCurrency;\n  if (action.input.recurringBillingCycle) group.recurringCost.billingCycle = action.input.recurringBillingCycle;\n}",
+                            errors: [
+                                {
+                                    id: "err-update-group-cost-not-found",
+                                    name: "UpdateServiceGroupCostNotFoundError",
+                                    code: "UPDATE_GROUP_COST_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                     ],
                 },
                 {
-                    id: "metrics",
-                    name: "Metrics",
-                    description: "Operations for managing service metrics and usage",
+                    id: "mod-metrics",
+                    name: "metrics",
+                    description: "Service metric tracking and usage management",
                     operations: [
                         {
-                            id: "add-service-metric",
+                            id: "op-add-service-metric",
                             name: "ADD_SERVICE_METRIC",
-                            description: "Adds a metric to a service",
-                            schema: "input AddServiceMetricInput {\n    serviceId: OID!\n    id: OID!\n    name: String!\n    unitName: String\n    limit: Int\n    freeLimit: Int\n    paidLimit: Int\n    unitCost: Amount_Money\n    usageResetPeriod: ResetPeriod\n    nextUsageReset: DateTime\n}",
-                            template: "Adds a metric to a service",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) { service.metrics.push({ id: action.input.id, name: action.input.name, unitName: action.input.unitName || null, limit: action.input.limit || null, freeLimit: action.input.freeLimit || null, paidLimit: action.input.paidLimit || null, unitCost: action.input.unitCost || null, currentUsage: 0, usageResetPeriod: action.input.usageResetPeriod || null, nextUsageReset: action.input.nextUsageReset || null }); }",
-                            errors: [],
+                            description: "Add a metric to a service",
+                            schema: "input AddServiceMetricInput {\n    serviceId: OID!\n    metricId: OID!\n    name: String!\n    unitName: String!\n    limit: Int\n    freeLimit: Int\n    paidLimit: Int\n    currentUsage: Int!\n    usageResetPeriod: ResetPeriod\n    nextUsageReset: DateTime\n    unitCostAmount: Amount_Money\n    unitCostCurrency: Currency\n    unitCostBillingCycle: BillingCycle\n    unitCostNextBillingDate: DateTime\n    unitCostLastPaymentDate: DateTime\n}",
+                            template: "Add a metric to a service",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new AddServiceMetricServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nsvc.metrics.push({\n  id: action.input.metricId,\n  name: action.input.name,\n  unitName: action.input.unitName,\n  limit: action.input.limit || null,\n  freeLimit: action.input.freeLimit || null,\n  paidLimit: action.input.paidLimit || null,\n  unitCost: action.input.unitCostAmount && action.input.unitCostCurrency && action.input.unitCostBillingCycle ? {\n    amount: action.input.unitCostAmount,\n    currency: action.input.unitCostCurrency,\n    billingCycle: action.input.unitCostBillingCycle,\n    nextBillingDate: action.input.unitCostNextBillingDate || null,\n    lastPaymentDate: action.input.unitCostLastPaymentDate || null,\n    discount: null,\n  } : null,\n  currentUsage: action.input.currentUsage,\n  usageResetPeriod: action.input.usageResetPeriod || null,\n  nextUsageReset: action.input.nextUsageReset || null,\n});",
+                            errors: [
+                                {
+                                    id: "err-add-metric-service-not-found",
+                                    name: "AddServiceMetricServiceNotFoundError",
+                                    code: "ADD_METRIC_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-metric",
+                            id: "op-update-metric",
                             name: "UPDATE_METRIC",
-                            description: "Updates a metric",
-                            schema: "input UpdateMetricInput {\n    serviceId: OID!\n    metricId: OID!\n    name: String\n    unitName: String\n    limit: Int\n    freeLimit: Int\n    paidLimit: Int\n    unitCost: Amount_Money\n    usageResetPeriod: ResetPeriod\n    nextUsageReset: DateTime\n}",
-                            template: "Updates a metric",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) {\n    const metric = service.metrics.find(m => m.id === action.input.metricId);\n    if (metric) {\n        if (action.input.name) metric.name = action.input.name;\n        if (action.input.unitName !== undefined) metric.unitName = action.input.unitName || null;\n        if (action.input.limit !== undefined) metric.limit = action.input.limit;\n        if (action.input.freeLimit !== undefined) metric.freeLimit = action.input.freeLimit;\n        if (action.input.paidLimit !== undefined) metric.paidLimit = action.input.paidLimit;\n        if (action.input.unitCost !== undefined) metric.unitCost = action.input.unitCost;\n        if (action.input.usageResetPeriod !== undefined) metric.usageResetPeriod = action.input.usageResetPeriod;\n        if (action.input.nextUsageReset !== undefined) metric.nextUsageReset = action.input.nextUsageReset;\n    }\n}",
-                            errors: [],
-                            examples: [],
-                            scope: "global",
-                        },
-                        {
-                            id: "update-metric-usage",
+                            description: "Update metric configuration",
+                            schema: "input UpdateMetricInput {\n    serviceId: OID!\n    metricId: OID!\n    name: String\n    unitName: String\n    limit: Int\n    usageResetPeriod: ResetPeriod\n    nextUsageReset: DateTime\n}",
+                            template: "Update metric configuration",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new UpdateMetricServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nconst metric = svc.metrics.find((m) => m.id === action.input.metricId);\nif (!metric) {\n  throw new UpdateMetricNotFoundError(`Metric with ID ${action.input.metricId} not found`);\n}\nif (action.input.name) metric.name = action.input.name;\nif (action.input.unitName) metric.unitName = action.input.unitName;\nif (action.input.limit !== undefined) metric.limit = action.input.limit || null;\nif (action.input.usageResetPeriod !== undefined) metric.usageResetPeriod = action.input.usageResetPeriod || null;\nif (action.input.nextUsageReset !== undefined) metric.nextUsageReset = action.input.nextUsageReset || null;",
+                            errors: [
+                                {
+                                    id: "err-update-metric-service-not-found",
+                                    name: "UpdateMetricServiceNotFoundError",
+                                    code: "UPDATE_METRIC_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                                {
+                                    id: "err-update-metric-not-found",
+                                    name: "UpdateMetricNotFoundError",
+                                    code: "UPDATE_METRIC_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "op-update-metric-usage",
                             name: "UPDATE_METRIC_USAGE",
-                            description: "Updates metric usage",
-                            schema: "input UpdateMetricUsageInput {\n    serviceId: OID!\n    metricId: OID!\n    currentUsage: Int!\n}",
-                            template: "Updates metric usage",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) {\n    const metric = service.metrics.find(m => m.id === action.input.metricId);\n    if (metric) { metric.currentUsage = action.input.currentUsage; }\n}",
-                            errors: [],
-                            examples: [],
-                            scope: "global",
-                        },
-                        {
-                            id: "remove-service-metric",
+                            description: "Set metric usage directly",
+                            schema: "input UpdateMetricUsageInput {\n    serviceId: OID!\n    metricId: OID!\n    currentTime: DateTime!\n    currentUsage: Int!\n}",
+                            template: "Set metric usage directly",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new UpdateMetricUsageServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nconst metric = svc.metrics.find((m) => m.id === action.input.metricId);\nif (!metric) {\n  throw new UpdateMetricUsageNotFoundError(`Metric with ID ${action.input.metricId} not found`);\n}\nmetric.currentUsage = action.input.currentUsage;",
+                            errors: [
+                                {
+                                    id: "err-update-usage-service-not-found",
+                                    name: "UpdateMetricUsageServiceNotFoundError",
+                                    code: "UPDATE_USAGE_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                                {
+                                    id: "err-update-usage-metric-not-found",
+                                    name: "UpdateMetricUsageNotFoundError",
+                                    code: "UPDATE_USAGE_METRIC_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "op-remove-service-metric",
                             name: "REMOVE_SERVICE_METRIC",
-                            description: "Removes a metric",
+                            description: "Remove a metric from a service",
                             schema: "input RemoveServiceMetricInput {\n    serviceId: OID!\n    metricId: OID!\n}",
-                            template: "Removes a metric",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) {\n    const mIndex = service.metrics.findIndex(m => m.id === action.input.metricId);\n    if (mIndex !== -1) { service.metrics.splice(mIndex, 1); }\n}",
-                            errors: [],
-                            examples: [],
-                            scope: "global",
-                        },
-                        {
-                            id: "increment-metric-usage",
+                            template: "Remove a metric from a service",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new RemoveServiceMetricServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nconst index = svc.metrics.findIndex((m) => m.id === action.input.metricId);\nif (index === -1) {\n  throw new RemoveServiceMetricNotFoundError(`Metric with ID ${action.input.metricId} not found`);\n}\nsvc.metrics.splice(index, 1);",
+                            errors: [
+                                {
+                                    id: "err-remove-metric-service-not-found",
+                                    name: "RemoveServiceMetricServiceNotFoundError",
+                                    code: "REMOVE_METRIC_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                                {
+                                    id: "err-remove-metric-not-found",
+                                    name: "RemoveServiceMetricNotFoundError",
+                                    code: "REMOVE_METRIC_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "op-increment-metric-usage",
                             name: "INCREMENT_METRIC_USAGE",
-                            description: "Increments metric usage",
-                            schema: "input IncrementMetricUsageInput {\n    serviceId: OID!\n    metricId: OID!\n    amount: Int!\n}",
-                            template: "Increments metric usage",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) {\n    const metric = service.metrics.find(m => m.id === action.input.metricId);\n    if (metric) { metric.currentUsage += action.input.amount; }\n}",
-                            errors: [],
-                            examples: [],
-                            scope: "global",
-                        },
-                        {
-                            id: "decrement-metric-usage",
+                            description: "Increment usage counter",
+                            schema: "input IncrementMetricUsageInput {\n    serviceId: OID!\n    metricId: OID!\n    currentTime: DateTime!\n    incrementBy: Int!\n}",
+                            template: "Increment usage counter",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new IncrementMetricUsageServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nconst metric = svc.metrics.find((m) => m.id === action.input.metricId);\nif (!metric) {\n  throw new IncrementMetricUsageNotFoundError(`Metric with ID ${action.input.metricId} not found`);\n}\nmetric.currentUsage += action.input.incrementBy;",
+                            errors: [
+                                {
+                                    id: "err-increment-service-not-found",
+                                    name: "IncrementMetricUsageServiceNotFoundError",
+                                    code: "INCREMENT_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                                {
+                                    id: "err-increment-metric-not-found",
+                                    name: "IncrementMetricUsageNotFoundError",
+                                    code: "INCREMENT_METRIC_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "op-decrement-metric-usage",
                             name: "DECREMENT_METRIC_USAGE",
-                            description: "Decrements metric usage",
-                            schema: "input DecrementMetricUsageInput {\n    serviceId: OID!\n    metricId: OID!\n    amount: Int!\n}",
-                            template: "Decrements metric usage",
-                            reducer: "const service = state.services.find(s => s.id === action.input.serviceId);\nif (service) {\n    const metric = service.metrics.find(m => m.id === action.input.metricId);\n    if (metric) { metric.currentUsage = Math.max(0, metric.currentUsage - action.input.amount); }\n}",
-                            errors: [],
+                            description: "Decrement usage counter",
+                            schema: "input DecrementMetricUsageInput {\n    serviceId: OID!\n    metricId: OID!\n    currentTime: DateTime!\n    decrementBy: Int!\n}",
+                            template: "Decrement usage counter",
+                            reducer: "const svc = state.services.find((s) => s.id === action.input.serviceId);\nif (!svc) {\n  throw new DecrementMetricUsageServiceNotFoundError(`Service with ID ${action.input.serviceId} not found`);\n}\nconst metric = svc.metrics.find((m) => m.id === action.input.metricId);\nif (!metric) {\n  throw new DecrementMetricUsageNotFoundError(`Metric with ID ${action.input.metricId} not found`);\n}\nmetric.currentUsage -= action.input.decrementBy;",
+                            errors: [
+                                {
+                                    id: "err-decrement-service-not-found",
+                                    name: "DecrementMetricUsageServiceNotFoundError",
+                                    code: "DECREMENT_SERVICE_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                                {
+                                    id: "err-decrement-metric-not-found",
+                                    name: "DecrementMetricUsageNotFoundError",
+                                    code: "DECREMENT_METRIC_NOT_FOUND",
+                                    description: "",
+                                    template: "",
+                                },
+                            ],
                             examples: [],
                             scope: "global",
                         },
                     ],
                 },
                 {
-                    id: "customer",
-                    name: "Customer",
-                    description: "Operations for managing customer info",
+                    id: "mod-customer",
+                    name: "customer",
+                    description: "Customer type and team member management",
                     operations: [
                         {
-                            id: "set-customer-type",
+                            id: "op-set-customer-type",
                             name: "SET_CUSTOMER_TYPE",
-                            description: "Sets the customer type",
-                            schema: "input SetCustomerTypeInput {\n    customerType: CustomerType!\n}",
-                            template: "Sets the customer type",
-                            reducer: "state.customerType = action.input.customerType;",
+                            description: "Set customer type (individual/team)",
+                            schema: "input SetCustomerTypeInput {\n    customerType: CustomerType!\n    teamMemberCount: Int\n}",
+                            template: "Set customer type (individual/team)",
+                            reducer: "state.customerType = action.input.customerType;\nstate.teamMemberCount = action.input.teamMemberCount || null;",
                             errors: [],
                             examples: [],
                             scope: "global",
                         },
                         {
-                            id: "update-team-member-count",
+                            id: "op-update-team-member-count",
                             name: "UPDATE_TEAM_MEMBER_COUNT",
-                            description: "Updates team member count",
+                            description: "Update team member count",
                             schema: "input UpdateTeamMemberCountInput {\n    teamMemberCount: Int!\n}",
-                            template: "Updates team member count",
+                            template: "Update team member count",
                             reducer: "state.teamMemberCount = action.input.teamMemberCount;",
                             errors: [],
                             examples: [],