@elevasis/core 0.8.2 → 0.9.0

package/src/_gen/__tests__/__snapshots__/contracts.md.snap

@@ -1,401 +1,402 @@
-<!-- Auto-generated on YYYY-MM-DD by scripts/monorepo/generate-scaffold-contracts.js -->
----
-title: Reference Contracts
-description: Auto-generated TypeScript contracts for SDK consumers. Do not edit manually.
----
-
-> **Auto-generated** from source types. Do not edit manually. Run `node scripts/monorepo/generate-scaffold-contracts.js` to regenerate.
-
-## Organization Model
-
-### `OrganizationModel`
-
-```typescript
-export type OrganizationModel = z.infer<typeof OrganizationModelSchema>
-```
-
-### `OrganizationModelBranding`
-
-```typescript
-export type OrganizationModelBranding = z.infer<typeof OrganizationModelBrandingSchema>
-```
-
-### `OrganizationModelSales`
-
-```typescript
-export type OrganizationModelSales = z.infer<typeof OrganizationModelSalesSchema>
-```
-
-### `OrganizationModelProspecting`
-
-```typescript
-export type OrganizationModelProspecting = z.infer<typeof OrganizationModelProspectingSchema>
-```
-
-### `OrganizationModelProjects`
-
-```typescript
-export type OrganizationModelProjects = z.infer<typeof OrganizationModelProjectsSchema>
-```
-
-### `OrganizationModelFeature`
-
-```typescript
-export type OrganizationModelFeature = z.infer<typeof FeatureSchema>
-```
-
-### `OrganizationModelNavigation`
-
-```typescript
-export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
-```
-
-### `OrganizationModelSurface`
-
-```typescript
-export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
-```
-
-### `OrganizationModelResourceMapping`
-
-```typescript
-export type OrganizationModelResourceMapping = z.infer<typeof ResourceMappingSchema>
-```
-
-### `OrganizationModelTechStackEntry`
-
-```typescript
-export type OrganizationModelTechStackEntry = z.infer<typeof TechStackEntrySchema>
-```
-
-### `OrganizationModelStatuses`
-
-```typescript
-export type OrganizationModelStatuses = z.infer<typeof StatusesDomainSchema>
-```
-
-### `OrganizationModelStatusEntry`
-
-```typescript
-export type OrganizationModelStatusEntry = z.infer<typeof StatusEntrySchema>
-```
-
-### `OrganizationModelStatusSemanticClass`
-
-```typescript
-export type OrganizationModelStatusSemanticClass = z.infer<typeof StatusSemanticClassSchema>
-```
-
-### `OrganizationModelOperations`
-
-```typescript
-export type OrganizationModelOperations = z.infer<typeof OperationsDomainSchema>
-```
-
-### `OrganizationModelOperationEntry`
-
-```typescript
-export type OrganizationModelOperationEntry = z.infer<typeof OperationEntrySchema>
-```
-
-### `OrganizationModelOperationSemanticClass`
-
-```typescript
-export type OrganizationModelOperationSemanticClass = z.infer<typeof OperationSemanticClassSchema>
-```
-
-### `OrganizationModelCustomers`
-
-```typescript
-export type OrganizationModelCustomers = z.infer<typeof CustomersDomainSchema>
-```
-
-### `OrganizationModelCustomerSegment`
-
-```typescript
-export type OrganizationModelCustomerSegment = z.infer<typeof CustomerSegmentSchema>
-```
-
-### `OrganizationModelCustomerFirmographics`
-
-```typescript
-export type OrganizationModelCustomerFirmographics = z.infer<typeof FirmographicsSchema>
-```
-
-### `OrganizationModelOfferings`
-
-```typescript
-export type OrganizationModelOfferings = z.infer<typeof OfferingsDomainSchema>
-```
-
-### `OrganizationModelProduct`
-
-```typescript
-export type OrganizationModelProduct = z.infer<typeof ProductSchema>
-```
-
-### `OrganizationModelPricingModel`
-
-```typescript
-export type OrganizationModelPricingModel = z.infer<typeof PricingModelSchema>
-```
-
-### `OrganizationModelRoles`
-
-```typescript
-export type OrganizationModelRoles = z.infer<typeof RolesDomainSchema>
-```
-
-### `OrganizationModelRole`
-
-```typescript
-export type OrganizationModelRole = z.infer<typeof RoleSchema>
-```
-
-### `OrganizationModelGoals`
-
-```typescript
-export type OrganizationModelGoals = z.infer<typeof GoalsDomainSchema>
-```
-
-### `OrganizationModelObjective`
-
-```typescript
-export type OrganizationModelObjective = z.infer<typeof ObjectiveSchema>
-```
-
-### `OrganizationModelKeyResult`
-
-```typescript
-export type OrganizationModelKeyResult = z.infer<typeof KeyResultSchema>
-```
-
-### `DeepPartial`
-
-```typescript
-export type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
-```
-
-## Feature System
-
-### `FeatureNavLink`
-
-```typescript
-export interface FeatureNavLink {
-  label: string
-  link: string
-  featureKey?: string
-  onClick?: () => void
-  links?: FeatureNavLink[]
-}
-```
-
-### `FeatureNavEntry`
-
-```typescript
-export interface FeatureNavEntry {
-  label: string
-  icon: ComponentType
-  link?: string
-  featureKey?: string
-  requiresAdmin?: boolean
-  dataOnboardingTourId?: string
-  links?: FeatureNavLink[]
-}
-```
-
-### `FeatureSidebarComponent`
-
-```typescript
-export type FeatureSidebarComponent = ComponentType
-```
-
-### `FeatureModule`
-
-```typescript
-export interface FeatureModule {
-  /** Unique stable identifier for this feature (e.g. `'crm'`, `'projects'`). */
-  key: string
-  /** Feature ID used for access-flag gating — must match the `id` of a feature in the organization model. */
-  featureId: string
-  /**
-   * Capability identifiers contributed by this feature.
-   * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
-   * Not queried at runtime — kept for semantic graph completeness so that
-   * capability membership is fully represented in the resolved model even when
-   * a surface does not declare it directly.
-   */
-  capabilityIds?: string[]
-  /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
-  navEntry?: FeatureNavEntry
-  /** Sidebar component rendered when a matching subshell route is active. */
-  sidebar?: FeatureSidebarComponent
-  /** Route path prefixes that activate this feature's sidebar and subshell context. */
-  subshellRoutes?: string[]
-  /**
-   * Operations-only bridge surface connecting this feature to the organization graph.
-   * Ignored by all other features. Only one manifest in the registry should set this.
-   */
-  organizationGraph?: OrganizationGraphFeatureBridge
-}
-```
-
-### `ResolvedFeatureAccess`
-
-```typescript
-export interface ResolvedFeatureAccess {
-  featureId: string
-  enabled: boolean
-}
-```
-
-### `ResolvedFeatureSemantics`
-
-```typescript
-export interface ResolvedFeatureSemantics {
-  capabilityIds: string[]
-  surfaceIds: string[]
-  surfaces: OrganizationModelSurface[]
-}
-```
-
-### `ResolvedFeatureModule`
-
-```typescript
-export interface ResolvedFeatureModule extends FeatureModule {
-  access: ResolvedFeatureAccess
-  semantics: ResolvedFeatureSemantics
-}
-```
-
-### `ShellNavPlacement`
-
-```typescript
-export type ShellNavPlacement = 'primary' | 'bottom'
-```
-
-### `ShellNavSource`
-
-```typescript
-export type ShellNavSource = 'app' | 'feature'
-```
-
-### `ResolvedShellNavItem`
-
-```typescript
-export interface ResolvedShellNavItem extends FeatureNavEntry {
-  placement: ShellNavPlacement
-  source: ShellNavSource
-  featureId?: string
-}
-```
-
-### `ResolvedShellModel`
-
-```typescript
-export interface ResolvedShellModel {
-  navItems: ResolvedShellNavItem[]
-}
-```
-
-### `AppShellOverrides`
-
-```typescript
-export interface AppShellOverrides {
-  primaryNavItems?: FeatureNavEntry[]
-  bottomNavItems?: FeatureNavEntry[]
-}
-```
-
-### `ShellRouteMatchStatus`
-
-```typescript
-export type ShellRouteMatchStatus = 'matched' | 'hidden' | 'unmatched'
-```
-
-### `ResolvedShellRouteMatch`
-
-```typescript
-export interface ResolvedShellRouteMatch {
-  status: ShellRouteMatchStatus
-  path: string
-  feature?: ResolvedFeatureModule
-  navItem?: ResolvedShellNavItem
-  navLink?: FeatureNavLink
-}
-```
-
-### `ShellRuntime`
-
-```typescript
-export interface ShellRuntime {
-  resolveRoute: (path: string) => ResolvedShellRouteMatch
-}
-```
-
-### `OrganizationGraphFeatureBridge`
-
-```typescript
-export interface OrganizationGraphFeatureBridge {
-  surfaceId: string
-}
-```
-
-### `OrganizationGraphContextValue`
-
-```typescript
-export interface OrganizationGraphContextValue {
-  available: boolean
-  surfaceId?: string
-  surfacePath?: string
-  surfaceType?: OrganizationModelSurface['surfaceType']
-  featureId?: string
-}
-```
-
-### `ElevasisFeaturesProviderProps`
-
-```typescript
-export interface ElevasisFeaturesProviderProps {
-  features: FeatureModule[]
-  organizationModel?: OrganizationModel
-  appShellOverrides?: AppShellOverrides
-  timeRange?: TimeRange
-  operationsApiUrl?: string
-  operationsSSEManager?: SSEConnectionManagerLike
-  deliveryApiUrl?: string
-  deliverySSEManager?: SSEConnectionManagerLike
-  disabledSubsectionPaths?: string[]
-  children: ReactNode
-}
-```
-
-### `ElevasisFeaturesContextValue`
-
-```typescript
-export interface ElevasisFeaturesContextValue {
-  shellModel: ResolvedShellModel
-  shellRuntime: ShellRuntime
-  enabledResolvedFeatures: ResolvedFeatureModule[]
-  resolvedFeatures: ResolvedFeatureModule[]
-  organizationGraph: OrganizationGraphContextValue
-  organizationModel?: OrganizationModel
-  timeRange?: TimeRange
-  operationsApiUrl?: string
-  operationsSSEManager?: SSEConnectionManagerLike
-  deliveryApiUrl?: string
-  deliverySSEManager?: SSEConnectionManagerLike
-  disabledSubsectionPaths: string[]
-  isFeatureEnabled: (key: string) => boolean
-  getResolvedFeature: (key: string) => ResolvedFeatureModule | undefined
-}
-```
-
-## Resource Registry
-
-### `ResourceStatus`
-
-```typescript
+<!-- @generated by scripts/monorepo/generate-scaffold-contracts.js — DO NOT EDIT -->
+<!-- Regenerate: pnpm scaffold:sync -->
+---
+title: Reference Contracts
+description: Auto-generated TypeScript contracts for SDK consumers. Do not edit manually.
+---
+
+> **Auto-generated** from source types. Do not edit manually. Run `node scripts/monorepo/generate-scaffold-contracts.js` to regenerate.
+
+## Organization Model
+
+### `OrganizationModel`
+
+```typescript
+export type OrganizationModel = z.infer<typeof OrganizationModelSchema>
+```
+
+### `OrganizationModelBranding`
+
+```typescript
+export type OrganizationModelBranding = z.infer<typeof OrganizationModelBrandingSchema>
+```
+
+### `OrganizationModelSales`
+
+```typescript
+export type OrganizationModelSales = z.infer<typeof OrganizationModelSalesSchema>
+```
+
+### `OrganizationModelProspecting`
+
+```typescript
+export type OrganizationModelProspecting = z.infer<typeof OrganizationModelProspectingSchema>
+```
+
+### `OrganizationModelProjects`
+
+```typescript
+export type OrganizationModelProjects = z.infer<typeof OrganizationModelProjectsSchema>
+```
+
+### `OrganizationModelFeature`
+
+```typescript
+export type OrganizationModelFeature = z.infer<typeof FeatureSchema>
+```
+
+### `OrganizationModelNavigation`
+
+```typescript
+export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
+```
+
+### `OrganizationModelSurface`
+
+```typescript
+export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
+```
+
+### `OrganizationModelResourceMapping`
+
+```typescript
+export type OrganizationModelResourceMapping = z.infer<typeof ResourceMappingSchema>
+```
+
+### `OrganizationModelTechStackEntry`
+
+```typescript
+export type OrganizationModelTechStackEntry = z.infer<typeof TechStackEntrySchema>
+```
+
+### `OrganizationModelStatuses`
+
+```typescript
+export type OrganizationModelStatuses = z.infer<typeof StatusesDomainSchema>
+```
+
+### `OrganizationModelStatusEntry`
+
+```typescript
+export type OrganizationModelStatusEntry = z.infer<typeof StatusEntrySchema>
+```
+
+### `OrganizationModelStatusSemanticClass`
+
+```typescript
+export type OrganizationModelStatusSemanticClass = z.infer<typeof StatusSemanticClassSchema>
+```
+
+### `OrganizationModelOperations`
+
+```typescript
+export type OrganizationModelOperations = z.infer<typeof OperationsDomainSchema>
+```
+
+### `OrganizationModelOperationEntry`
+
+```typescript
+export type OrganizationModelOperationEntry = z.infer<typeof OperationEntrySchema>
+```
+
+### `OrganizationModelOperationSemanticClass`
+
+```typescript
+export type OrganizationModelOperationSemanticClass = z.infer<typeof OperationSemanticClassSchema>
+```
+
+### `OrganizationModelCustomers`
+
+```typescript
+export type OrganizationModelCustomers = z.infer<typeof CustomersDomainSchema>
+```
+
+### `OrganizationModelCustomerSegment`
+
+```typescript
+export type OrganizationModelCustomerSegment = z.infer<typeof CustomerSegmentSchema>
+```
+
+### `OrganizationModelCustomerFirmographics`
+
+```typescript
+export type OrganizationModelCustomerFirmographics = z.infer<typeof FirmographicsSchema>
+```
+
+### `OrganizationModelOfferings`
+
+```typescript
+export type OrganizationModelOfferings = z.infer<typeof OfferingsDomainSchema>
+```
+
+### `OrganizationModelProduct`
+
+```typescript
+export type OrganizationModelProduct = z.infer<typeof ProductSchema>
+```
+
+### `OrganizationModelPricingModel`
+
+```typescript
+export type OrganizationModelPricingModel = z.infer<typeof PricingModelSchema>
+```
+
+### `OrganizationModelRoles`
+
+```typescript
+export type OrganizationModelRoles = z.infer<typeof RolesDomainSchema>
+```
+
+### `OrganizationModelRole`
+
+```typescript
+export type OrganizationModelRole = z.infer<typeof RoleSchema>
+```
+
+### `OrganizationModelGoals`
+
+```typescript
+export type OrganizationModelGoals = z.infer<typeof GoalsDomainSchema>
+```
+
+### `OrganizationModelObjective`
+
+```typescript
+export type OrganizationModelObjective = z.infer<typeof ObjectiveSchema>
+```
+
+### `OrganizationModelKeyResult`
+
+```typescript
+export type OrganizationModelKeyResult = z.infer<typeof KeyResultSchema>
+```
+
+### `DeepPartial`
+
+```typescript
+export type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
+```
+
+## Feature System
+
+### `FeatureNavLink`
+
+```typescript
+export interface FeatureNavLink {
+  label: string
+  link: string
+  featureKey?: string
+  onClick?: () => void
+  links?: FeatureNavLink[]
+}
+```
+
+### `FeatureNavEntry`
+
+```typescript
+export interface FeatureNavEntry {
+  label: string
+  icon: ComponentType
+  link?: string
+  featureKey?: string
+  requiresAdmin?: boolean
+  dataOnboardingTourId?: string
+  links?: FeatureNavLink[]
+}
+```
+
+### `FeatureSidebarComponent`
+
+```typescript
+export type FeatureSidebarComponent = ComponentType
+```
+
+### `FeatureModule`
+
+```typescript
+export interface FeatureModule {
+  /** Unique stable identifier for this feature (e.g. `'crm'`, `'projects'`). */
+  key: string
+  /** Feature ID used for access-flag gating — must match the `id` of a feature in the organization model. */
+  featureId: string
+  /**
+   * Capability identifiers contributed by this feature.
+   * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
+   * Not queried at runtime — kept for semantic graph completeness so that
+   * capability membership is fully represented in the resolved model even when
+   * a surface does not declare it directly.
+   */
+  capabilityIds?: string[]
+  /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
+  navEntry?: FeatureNavEntry
+  /** Sidebar component rendered when a matching subshell route is active. */
+  sidebar?: FeatureSidebarComponent
+  /** Route path prefixes that activate this feature's sidebar and subshell context. */
+  subshellRoutes?: string[]
+  /**
+   * Operations-only bridge surface connecting this feature to the organization graph.
+   * Ignored by all other features. Only one manifest in the registry should set this.
+   */
+  organizationGraph?: OrganizationGraphFeatureBridge
+}
+```
+
+### `ResolvedFeatureAccess`
+
+```typescript
+export interface ResolvedFeatureAccess {
+  featureId: string
+  enabled: boolean
+}
+```
+
+### `ResolvedFeatureSemantics`
+
+```typescript
+export interface ResolvedFeatureSemantics {
+  capabilityIds: string[]
+  surfaceIds: string[]
+  surfaces: OrganizationModelSurface[]
+}
+```
+
+### `ResolvedFeatureModule`
+
+```typescript
+export interface ResolvedFeatureModule extends FeatureModule {
+  access: ResolvedFeatureAccess
+  semantics: ResolvedFeatureSemantics
+}
+```
+
+### `ShellNavPlacement`
+
+```typescript
+export type ShellNavPlacement = 'primary' | 'bottom'
+```
+
+### `ShellNavSource`
+
+```typescript
+export type ShellNavSource = 'app' | 'feature'
+```
+
+### `ResolvedShellNavItem`
+
+```typescript
+export interface ResolvedShellNavItem extends FeatureNavEntry {
+  placement: ShellNavPlacement
+  source: ShellNavSource
+  featureId?: string
+}
+```
+
+### `ResolvedShellModel`
+
+```typescript
+export interface ResolvedShellModel {
+  navItems: ResolvedShellNavItem[]
+}
+```
+
+### `AppShellOverrides`
+
+```typescript
+export interface AppShellOverrides {
+  primaryNavItems?: FeatureNavEntry[]
+  bottomNavItems?: FeatureNavEntry[]
+}
+```
+
+### `ShellRouteMatchStatus`
+
+```typescript
+export type ShellRouteMatchStatus = 'matched' | 'hidden' | 'unmatched'
+```
+
+### `ResolvedShellRouteMatch`
+
+```typescript
+export interface ResolvedShellRouteMatch {
+  status: ShellRouteMatchStatus
+  path: string
+  feature?: ResolvedFeatureModule
+  navItem?: ResolvedShellNavItem
+  navLink?: FeatureNavLink
+}
+```
+
+### `ShellRuntime`
+
+```typescript
+export interface ShellRuntime {
+  resolveRoute: (path: string) => ResolvedShellRouteMatch
+}
+```
+
+### `OrganizationGraphFeatureBridge`
+
+```typescript
+export interface OrganizationGraphFeatureBridge {
+  surfaceId: string
+}
+```
+
+### `OrganizationGraphContextValue`
+
+```typescript
+export interface OrganizationGraphContextValue {
+  available: boolean
+  surfaceId?: string
+  surfacePath?: string
+  surfaceType?: OrganizationModelSurface['surfaceType']
+  featureId?: string
+}
+```
+
+### `ElevasisFeaturesProviderProps`
+
+```typescript
+export interface ElevasisFeaturesProviderProps {
+  features: FeatureModule[]
+  organizationModel?: OrganizationModel
+  appShellOverrides?: AppShellOverrides
+  timeRange?: TimeRange
+  operationsApiUrl?: string
+  operationsSSEManager?: SSEConnectionManagerLike
+  deliveryApiUrl?: string
+  deliverySSEManager?: SSEConnectionManagerLike
+  disabledSubsectionPaths?: string[]
+  children: ReactNode
+}
+```
+
+### `ElevasisFeaturesContextValue`
+
+```typescript
+export interface ElevasisFeaturesContextValue {
+  shellModel: ResolvedShellModel
+  shellRuntime: ShellRuntime
+  enabledResolvedFeatures: ResolvedFeatureModule[]
+  resolvedFeatures: ResolvedFeatureModule[]
+  organizationGraph: OrganizationGraphContextValue
+  organizationModel?: OrganizationModel
+  timeRange?: TimeRange
+  operationsApiUrl?: string
+  operationsSSEManager?: SSEConnectionManagerLike
+  deliveryApiUrl?: string
+  deliverySSEManager?: SSEConnectionManagerLike
+  disabledSubsectionPaths: string[]
+  isFeatureEnabled: (key: string) => boolean
+  getResolvedFeature: (key: string) => ResolvedFeatureModule | undefined
+}
+```
+
+## Resource Registry
+
+### `ResourceStatus`
+
+```typescript
 /**
  * Resource Registry type definitions
  */
@@ -409,37 +410,37 @@ import type { ResourceDomain } from './domains'
 
 /**
  * Environment/deployment status for resources
- */
+ */
 export type ResourceStatus = 'dev' | 'prod'
 
 /**
  * All resource types in the platform
  * Used as the discriminator field in ResourceDefinition
- */
-```
-
-### `ResourceType`
-
-```typescript
+ */
+```
+
+### `ResourceType`
+
+```typescript
 /**
  * All resource types in the platform
  * Used as the discriminator field in ResourceDefinition
- */
+ */
 export type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human'
 
 /**
  * Executable resource types (subset of ResourceType)
  * These resources can be directly executed by the execution engine
- */
-```
-
-### `ExecutableResourceType`
-
-```typescript
+ */
+```
+
+### `ExecutableResourceType`
+
+```typescript
 /**
  * Executable resource types (subset of ResourceType)
  * These resources can be directly executed by the execution engine
- */
+ */
 export type ExecutableResourceType = 'workflow' | 'agent'
 
 // ============================================================================
@@ -449,16 +450,16 @@ export type ExecutableResourceType = 'workflow' | 'agent'
 /**
  * Base interface for ALL platform resources
  * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
- */
-```
-
-### `ResourceDefinition`
-
-```typescript
+ */
+```
+
+### `ResourceDefinition`
+
+```typescript
 /**
  * Base interface for ALL platform resources
  * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
- */
+ */
 export interface ResourceDefinition {
   /** Unique resource identifier */
   resourceId: string
@@ -489,12 +490,12 @@ export interface ResourceDefinition {
 
   /** Whether this resource is archived and should be excluded from registration and deployment */
   archived?: boolean
-}
-```
-
-### `DomainDefinition`
-
-```typescript
+}
+```
+
+### `DomainDefinition`
+
+```typescript
 /** Unique resource identifier */
   resourceId: string
 
@@ -544,7 +545,7 @@ export interface ResourceDefinition {
  *   color: 'green',
  *   icon: 'IconHeadset'
  * }
- */
+ */
 export interface DomainDefinition {
   /** Unique identifier (e.g., 'support') */
   id: string
@@ -556,12 +557,12 @@ export interface DomainDefinition {
   color?: string
   /** Optional Tabler icon name (e.g., 'IconHeadset') */
   icon?: string
-}
-```
-
-### `ResourceList`
-
-```typescript
+}
+```
+
+### `ResourceList`
+
+```typescript
 /** Unique identifier (e.g., 'support') */
   id: string
   /** Display name (e.g., 'Customer Support') */
@@ -577,29 +578,29 @@ export interface DomainDefinition {
 /**
  * Resource list for organization
  * Returns ResourceDefinition metadata (not full definitions)
- */
+ */
 export interface ResourceList {
   workflows: ResourceDefinition[]
   agents: ResourceDefinition[]
   total: number
   organizationName: string
   environment?: 'dev' | 'prod'
-}
-```
-
-### `WebhookProviderType`
-
-```typescript
-/** Webhook provider identifiers */
+}
+```
+
+### `WebhookProviderType`
+
+```typescript
+/** Webhook provider identifiers */
 export type WebhookProviderType = 'cal-com' | 'stripe' | 'signature-api' | 'instantly' | 'apify' | 'test'
 
-/** Webhook trigger configuration */
-```
-
-### `WebhookTriggerConfig`
-
-```typescript
-/** Webhook trigger configuration */
+/** Webhook trigger configuration */
+```
+
+### `WebhookTriggerConfig`
+
+```typescript
+/** Webhook trigger configuration */
 export interface WebhookTriggerConfig {
   /** Provider identifier */
   provider: WebhookProviderType
@@ -609,12 +610,12 @@ export interface WebhookTriggerConfig {
   filter?: Record<string, string>
   /** References credential in credentials table for per-org webhook secrets */
   credentialName?: string
-}
-```
-
-### `ScheduleTriggerConfig`
-
-```typescript
+}
+```
+
+### `ScheduleTriggerConfig`
+
+```typescript
 /** Provider identifier */
   provider: WebhookProviderType
   /** Event type for documentation (not used for matching - workflow handles routing) */
@@ -625,43 +626,43 @@ export interface WebhookTriggerConfig {
   credentialName?: string
 }
 
-/** Schedule trigger configuration */
+/** Schedule trigger configuration */
 export interface ScheduleTriggerConfig {
   /** Cron expression (e.g., '0 6 * * *') */
   cron: string
   /** Optional timezone (default: UTC) */
   timezone?: string
-}
-```
-
-### `EventTriggerConfig`
-
-```typescript
+}
+```
+
+### `EventTriggerConfig`
+
+```typescript
 /** Cron expression (e.g., '0 6 * * *') */
   cron: string
   /** Optional timezone (default: UTC) */
   timezone?: string
 }
 
-/** Event trigger configuration */
+/** Event trigger configuration */
 export interface EventTriggerConfig {
   /** Internal event type */
   eventType: string
   /** Event source */
   source?: string
-}
-```
-
-### `TriggerConfig`
-
-```typescript
+}
+```
+
+### `TriggerConfig`
+
+```typescript
 /** Internal event type */
   eventType: string
   /** Event source */
   source?: string
 }
 
-/** Union of all trigger configs */
+/** Union of all trigger configs */
 export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | EventTriggerConfig
 
 // ============================================================================
@@ -698,12 +699,12 @@ export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | Event
  * // relationships: {
  * //   'trigger-new-order': { triggers: { workflows: ['order-fulfillment-workflow'] } }
  * // }
- */
-```
-
-### `TriggerDefinition`
-
-```typescript
+ */
+```
+
+### `TriggerDefinition`
+
+```typescript
 /**
  * Trigger metadata - entry points that initiate resource execution
  *
@@ -734,7 +735,7 @@ export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | Event
  * // relationships: {
  * //   'trigger-new-order': { triggers: { workflows: ['order-fulfillment-workflow'] } }
  * // }
- */
+ */
 export interface TriggerDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'trigger'
@@ -755,12 +756,12 @@ export interface TriggerDefinition extends ResourceDefinition {
 
   // NOTE: What this trigger starts is declared in ResourceRelationships, not here
   // This prevents duplication - triggers are forward-declared in relationships
-}
-```
-
-### `IntegrationDefinition`
-
-```typescript
+}
+```
+
+### `IntegrationDefinition`
+
+```typescript
 /** Resource type discriminator (narrowed from base union) */
   type: 'trigger'
 
@@ -806,7 +807,7 @@ export interface TriggerDefinition extends ResourceDefinition {
  *   version: '1.0.0',
  *   status: 'prod'
  * }
- */
+ */
 export interface IntegrationDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'integration'
@@ -815,12 +816,12 @@ export interface IntegrationDefinition extends ResourceDefinition {
   provider: IntegrationType
   /** References credentials table (e.g., 'shopify-prod', 'zendesk-api') */
   credentialName: string
-}
-```
-
-### `RelationshipDeclaration`
-
-```typescript
+}
+```
+
+### `RelationshipDeclaration`
+
+```typescript
 /** Resource type discriminator (narrowed from base union) */
   type: 'integration'
 
@@ -841,7 +842,7 @@ export interface IntegrationDefinition extends ResourceDefinition {
  *   triggers: { workflows: ['order-fulfillment-workflow'] },
  *   uses: { integrations: ['integration-shopify-prod', 'integration-postgres'] }
  * }
- */
+ */
 export interface RelationshipDeclaration {
   /** Resources this resource triggers */
   triggers?: {
@@ -855,12 +856,12 @@ export interface RelationshipDeclaration {
     /** Integration IDs this resource uses */
     integrations?: string[]
   }
-}
-```
-
-### `ResourceRelationships`
-
-```typescript
+}
+```
+
+### `ResourceRelationships`
+
+```typescript
 /** Resources this resource triggers */
   triggers?: {
     /** Agent resourceIds this resource triggers */
@@ -886,7 +887,7 @@ export interface RelationshipDeclaration {
  *     uses: { integrations: ['integration-shopify-prod'] }
  *   }
  * }
- */
+ */
 export type ResourceRelationships = Record<string, RelationshipDeclaration>
 
 // ============================================================================
@@ -896,16 +897,16 @@ export type ResourceRelationships = Record<string, RelationshipDeclaration>
 /**
  * External platform type
  * Supported third-party automation platforms
- */
-```
-
-### `ExternalPlatform`
-
-```typescript
+ */
+```
+
+### `ExternalPlatform`
+
+```typescript
 /**
  * External platform type
  * Supported third-party automation platforms
- */
+ */
 export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
 
 /**
@@ -937,12 +938,12 @@ export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
  *   triggers: { workflows: ['order-fulfillment-workflow'] },
  *   uses: { integrations: ['integration-shopify-prod'] }
  * }
- */
-```
-
-### `ExternalResourceDefinition`
-
-```typescript
+ */
+```
+
+### `ExternalResourceDefinition`
+
+```typescript
 /**
  * External automation resource metadata
  *
@@ -972,7 +973,7 @@ export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
  *   triggers: { workflows: ['order-fulfillment-workflow'] },
  *   uses: { integrations: ['integration-shopify-prod'] }
  * }
- */
+ */
 export interface ExternalResourceDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'external'
@@ -1003,12 +1004,12 @@ export interface ExternalResourceDefinition extends ResourceDefinition {
   // NOTE: triggeredBy field removed - per relationship-consolidation design,
   // all relationships are forward-only declarations. Graph edges are built
   // from forward declarations only.
-}
-```
-
-### `HumanCheckpointDefinition`
-
-```typescript
+}
+```
+
+### `HumanCheckpointDefinition`
+
+```typescript
 /** Resource type discriminator (narrowed from base union) */
   type: 'external'
 
@@ -1064,7 +1065,7 @@ export interface ExternalResourceDefinition extends ResourceDefinition {
  *   requestedBy: { agents: ['order-processor-agent'] },
  *   routesTo: { agents: ['order-fulfillment-agent'] }
  * }
- */
+ */
 export interface HumanCheckpointDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'human'
@@ -1084,14 +1085,14 @@ export interface HumanCheckpointDefinition extends ResourceDefinition {
     /** Workflow resourceIds that handle approved tasks */
     workflows?: string[]
   }
-}
-```
-
-## Deployment Spec
-
-### `DeploymentSpec`
-
-```typescript
+}
+```
+
+## Deployment Spec
+
+### `DeploymentSpec`
+
+```typescript
 /** Supabase Storage path: "{orgId}/{deploymentId}/bundle.js" */
   storagePath: string
   /** Deployment record ID */
@@ -1111,7 +1112,7 @@ export interface HumanCheckpointDefinition extends ResourceDefinition {
  *
  * Complete manifest of all automation resources for an organization.
  * Used by ResourceRegistry for discovery and Command View for visualization.
- */
+ */
 export interface DeploymentSpec {
   /** Deployment version (semver) */
   version: string
@@ -1131,5 +1132,5 @@ export interface DeploymentSpec {
   externalResources?: ExternalResourceDefinition[]
   /** Human checkpoint definitions - human decision points in automation */
   humanCheckpoints?: HumanCheckpointDefinition[]
-}
-```
+}
+```