@contractspec/bundle.library 3.8.10 → 3.8.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.turbo/turbo-build.log +606 -594
- package/CHANGELOG.md +37 -0
- package/dist/application/context-storage/index.js +1 -28
- package/dist/application/index.js +13 -2133
- package/dist/application/mcp/cliMcp.js +4 -452
- package/dist/application/mcp/common.js +1 -193
- package/dist/application/mcp/contractsMcp.js +2 -549
- package/dist/application/mcp/contractsMcpResources.js +2 -123
- package/dist/application/mcp/contractsMcpTools.js +1 -199
- package/dist/application/mcp/docsMcp.catalog.js +3 -381
- package/dist/application/mcp/docsMcp.data.js +1 -147
- package/dist/application/mcp/docsMcp.js +6 -1039
- package/dist/application/mcp/docsMcp.prompts.js +6 -521
- package/dist/application/mcp/docsMcp.reference.js +3 -235
- package/dist/application/mcp/docsMcp.resources.js +3 -519
- package/dist/application/mcp/docsMcp.tools.js +3 -518
- package/dist/application/mcp/index.js +13 -2106
- package/dist/application/mcp/internalMcp.js +2 -410
- package/dist/application/mcp/normalizeMcpRequest.js +1 -21
- package/dist/application/mcp/providerRankingMcp.js +1 -530
- package/dist/bundles/LibraryBundle.js +1 -138
- package/dist/bundles/index.js +1 -138
- package/dist/components/docs/DocsIndexPage.js +2 -912
- package/dist/components/docs/advanced/AdvancedMCPPage.js +4 -271
- package/dist/components/docs/advanced/AdvancedOverlayEditorPage.js +1 -107
- package/dist/components/docs/advanced/AdvancedRenderersPage.js +2 -118
- package/dist/components/docs/advanced/AdvancedSpecExperimentsPage.js +4 -92
- package/dist/components/docs/advanced/AdvancedTelemetryPage.js +2 -373
- package/dist/components/docs/advanced/AdvancedWorkflowMonitoringPage.js +2 -99
- package/dist/components/docs/advanced/index.js +10 -1055
- package/dist/components/docs/architecture/ArchitectureAppConfigPage.js +6 -243
- package/dist/components/docs/architecture/ArchitectureControlPlanePage.js +3 -160
- package/dist/components/docs/architecture/ArchitectureIntegrationBindingPage.js +7 -259
- package/dist/components/docs/architecture/ArchitectureKnowledgeBindingPage.js +6 -374
- package/dist/components/docs/architecture/ArchitectureMultiTenancyPage.js +2 -166
- package/dist/components/docs/architecture/ArchitectureOverviewPage.js +1 -143
- package/dist/components/docs/architecture/index.js +20 -1340
- package/dist/components/docs/comparison/ComparisonAutomationPlatformsPage.js +1 -245
- package/dist/components/docs/comparison/ComparisonEnterprisePlatformsPage.js +1 -230
- package/dist/components/docs/comparison/ComparisonInternalToolBuildersPage.js +1 -245
- package/dist/components/docs/comparison/ComparisonOverviewPage.js +1 -202
- package/dist/components/docs/comparison/ComparisonWindmillPage.js +1 -254
- package/dist/components/docs/comparison/ComparisonWorkflowEnginesPage.js +1 -339
- package/dist/components/docs/comparison/index.js +1 -1510
- package/dist/components/docs/docsManifest.js +1 -611
- package/dist/components/docs/docsManifest.test.d.ts +1 -0
- package/dist/components/docs/ecosystem/IntegrationsPage.js +2 -103
- package/dist/components/docs/ecosystem/PluginsPage.js +13 -179
- package/dist/components/docs/ecosystem/RegistryPage.js +7 -100
- package/dist/components/docs/ecosystem/TemplatesPage.js +3 -141
- package/dist/components/docs/ecosystem/ecosystem.docblocks.js +2 -48
- package/dist/components/docs/ecosystem/index.js +23 -569
- package/dist/components/docs/examples/DocsExamplesPage.js +4 -124
- package/dist/components/docs/examples/ExampleShowcasePage.js +4 -244
- package/dist/components/docs/examples/exampleShowcaseData.js +4 -39
- package/dist/components/docs/examples/index.js +4 -330
- package/dist/components/docs/generated/docs-index.generated.js +1 -5
- package/dist/components/docs/generated/index.js +1 -74
- package/dist/components/docs/generated/loader.js +1 -74
- package/dist/components/docs/getting-started/CLIPage.js +4 -271
- package/dist/components/docs/getting-started/CompatibilityPage.js +1 -173
- package/dist/components/docs/getting-started/DataViewTutorialPage.js +4 -134
- package/dist/components/docs/getting-started/DeveloperToolsPage.js +1 -194
- package/dist/components/docs/getting-started/HelloWorldPage.js +5 -183
- package/dist/components/docs/getting-started/InstallationPage.js +3 -154
- package/dist/components/docs/getting-started/StartHerePage.js +2 -129
- package/dist/components/docs/getting-started/TroubleshootingPage.js +2 -168
- package/dist/components/docs/getting-started/VSCodeExtensionPage.js +1 -432
- package/dist/components/docs/getting-started/getting-started.docblocks.js +4 -41
- package/dist/components/docs/getting-started/index.js +18 -1869
- package/dist/components/docs/guides/GuideCIDiffGatingPage.js +2 -196
- package/dist/components/docs/guides/GuideConnectInRepoPage.d.ts +1 -0
- package/dist/components/docs/guides/GuideConnectInRepoPage.js +44 -0
- package/dist/components/docs/guides/GuideContractTypesPage.js +6 -541
- package/dist/components/docs/guides/GuideDocsPipelinePage.js +3 -207
- package/dist/components/docs/guides/GuideFirstModuleBundlePage.d.ts +1 -0
- package/dist/components/docs/guides/GuideFirstModuleBundlePage.js +76 -0
- package/dist/components/docs/guides/GuideGenerateDocsClientsSchemasPage.js +2 -209
- package/dist/components/docs/guides/GuideHostBuilderWorkbenchPage.d.ts +1 -0
- package/dist/components/docs/guides/GuideHostBuilderWorkbenchPage.js +70 -0
- package/dist/components/docs/guides/GuideImportExistingCodebasesPage.js +8 -754
- package/dist/components/docs/guides/GuideNextjsOneEndpointPage.js +6 -268
- package/dist/components/docs/guides/GuideSpecValidationTypingPage.js +4 -196
- package/dist/components/docs/guides/GuidesIndexPage.js +2 -169
- package/dist/components/docs/guides/guides.docblocks.js +11 -75
- package/dist/components/docs/guides/index.d.ts +3 -0
- package/dist/components/docs/guides/index.js +213 -2428
- package/dist/components/docs/index.js +542 -24310
- package/dist/components/docs/integrations/IntegrationsCircuitBreakersPage.js +2 -42
- package/dist/components/docs/integrations/IntegrationsElevenLabsPage.js +3 -105
- package/dist/components/docs/integrations/IntegrationsGithubPage.js +3 -142
- package/dist/components/docs/integrations/IntegrationsGmailPage.js +3 -109
- package/dist/components/docs/integrations/IntegrationsGoogleCalendarPage.js +3 -79
- package/dist/components/docs/integrations/IntegrationsHealthRoutingPage.js +3 -146
- package/dist/components/docs/integrations/IntegrationsMistralPage.js +5 -150
- package/dist/components/docs/integrations/IntegrationsOpenAIPage.js +5 -140
- package/dist/components/docs/integrations/IntegrationsOverviewPage.js +1 -160
- package/dist/components/docs/integrations/IntegrationsPostmarkPage.js +4 -218
- package/dist/components/docs/integrations/IntegrationsPowensPage.js +4 -300
- package/dist/components/docs/integrations/IntegrationsQdrantPage.js +5 -111
- package/dist/components/docs/integrations/IntegrationsResendPage.js +3 -102
- package/dist/components/docs/integrations/IntegrationsS3Page.js +4 -124
- package/dist/components/docs/integrations/IntegrationsSlackPage.js +3 -144
- package/dist/components/docs/integrations/IntegrationsSpecModelPage.js +7 -290
- package/dist/components/docs/integrations/IntegrationsStripePage.js +6 -327
- package/dist/components/docs/integrations/IntegrationsTwilioPage.js +3 -128
- package/dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js +2 -146
- package/dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js +2 -156
- package/dist/components/docs/integrations/index.js +52 -3100
- package/dist/components/docs/intent/ContractFirstApiPage.js +2 -126
- package/dist/components/docs/intent/DeterministicCodegenPage.js +2 -148
- package/dist/components/docs/intent/GenerateClientFromSchemaPage.js +7 -207
- package/dist/components/docs/intent/OpenapiAlternativePage.js +3 -201
- package/dist/components/docs/intent/SchemaValidationTypescriptPage.js +4 -144
- package/dist/components/docs/intent/SpecDrivenDevelopmentPage.js +2 -126
- package/dist/components/docs/intent/index.js +15 -1135
- package/dist/components/docs/intent/intent-pages.docblocks.js +1 -201
- package/dist/components/docs/knowledge/KnowledgeCategoriesPage.js +6 -750
- package/dist/components/docs/knowledge/KnowledgeExamplesPage.js +4 -175
- package/dist/components/docs/knowledge/KnowledgeOverviewPage.js +1 -116
- package/dist/components/docs/knowledge/KnowledgeSourcesPage.js +8 -391
- package/dist/components/docs/knowledge/KnowledgeSpacesPage.js +6 -302
- package/dist/components/docs/knowledge/index.js +21 -1730
- package/dist/components/docs/libraries/LibrariesAccessibilityPage.js +3 -198
- package/dist/components/docs/libraries/LibrariesAiAgentPage.js +3 -141
- package/dist/components/docs/libraries/LibrariesAnalyticsPage.js +4 -80
- package/dist/components/docs/libraries/LibrariesContentGenPage.js +2 -100
- package/dist/components/docs/libraries/LibrariesContractsPage.js +2 -284
- package/dist/components/docs/libraries/LibrariesCostTrackingPage.js +3 -112
- package/dist/components/docs/libraries/LibrariesDataBackendPage.js +2 -166
- package/dist/components/docs/libraries/LibrariesDataViewsPage.js +3 -186
- package/dist/components/docs/libraries/LibrariesDesignSystemPage.js +4 -279
- package/dist/components/docs/libraries/LibrariesEvolutionPage.js +4 -127
- package/dist/components/docs/libraries/LibrariesGraphQLPage.js +2 -173
- package/dist/components/docs/libraries/LibrariesGrowthPage.js +3 -88
- package/dist/components/docs/libraries/LibrariesMultiTenancyPage.js +3 -108
- package/dist/components/docs/libraries/LibrariesObservabilityPage.js +5 -130
- package/dist/components/docs/libraries/LibrariesOverlayEnginePage.js +4 -110
- package/dist/components/docs/libraries/LibrariesOverviewPage.js +1 -170
- package/dist/components/docs/libraries/LibrariesPersonalizationPage.js +4 -114
- package/dist/components/docs/libraries/LibrariesProgressiveDeliveryPage.js +3 -132
- package/dist/components/docs/libraries/LibrariesResiliencePage.js +4 -120
- package/dist/components/docs/libraries/LibrariesRuntimePage.js +2 -200
- package/dist/components/docs/libraries/LibrariesSLOPage.js +3 -116
- package/dist/components/docs/libraries/LibrariesSchemaPage.js +3 -273
- package/dist/components/docs/libraries/LibrariesSupportBotPage.js +3 -134
- package/dist/components/docs/libraries/LibrariesTestingPage.js +3 -133
- package/dist/components/docs/libraries/LibrariesUIKitPage.js +2 -230
- package/dist/components/docs/libraries/LibrariesWorkflowComposerPage.js +3 -88
- package/dist/components/docs/libraries/LibrariesWorkflowsPage.js +2 -181
- package/dist/components/docs/libraries/index.js +54 -4147
- package/dist/components/docs/manifesto/ManifestoPage.js +1 -86
- package/dist/components/docs/ops/AutoEvolutionOpsPage.js +2 -132
- package/dist/components/docs/ops/DistributedTracingOpsPage.js +2 -71
- package/dist/components/docs/ops/index.js +3 -202
- package/dist/components/docs/ops/ops-lifecycle.docblocks.js +3 -38
- package/dist/components/docs/ops/ops-runbooks-a.docblocks.js +3 -94
- package/dist/components/docs/ops/ops-runbooks-b.docblocks.js +3 -76
- package/dist/components/docs/ops/ops-slo-tenant.docblocks.js +3 -76
- package/dist/components/docs/ops/ops-top.docs.js +2 -17
- package/dist/components/docs/ops/ops.docs.js +10 -302
- package/dist/components/docs/product/product.docblocks.js +5 -72
- package/dist/components/docs/reference/DocsMarkdownContent.js +2 -196
- package/dist/components/docs/reference/DocsReferenceContent.js +3 -256
- package/dist/components/docs/reference/DocsReferenceIndexClient.js +2 -127
- package/dist/components/docs/reference/DocsReferenceIndexPage.js +2 -206
- package/dist/components/docs/reference/DocsReferencePage.js +3 -265
- package/dist/components/docs/reference/docsMarkdownParser.js +2 -92
- package/dist/components/docs/reference/index.js +4 -470
- package/dist/components/docs/safety/SafetyAuditingPage.js +2 -350
- package/dist/components/docs/safety/SafetyMigrationsPage.js +2 -359
- package/dist/components/docs/safety/SafetyOverviewPage.js +1 -101
- package/dist/components/docs/safety/SafetyPDPPage.js +2 -301
- package/dist/components/docs/safety/SafetySecurityTrustPage.js +1 -206
- package/dist/components/docs/safety/SafetySigningPage.js +3 -90
- package/dist/components/docs/safety/SafetyTenantIsolationPage.js +2 -79
- package/dist/components/docs/safety/index.js +7 -1480
- package/dist/components/docs/shared/StudioPrompt.js +1 -31
- package/dist/components/docs/specs/SpecsBuilderControlPlanePage.d.ts +1 -0
- package/dist/components/docs/specs/SpecsBuilderControlPlanePage.js +34 -0
- package/dist/components/docs/specs/SpecsCapabilitiesPage.js +2 -158
- package/dist/components/docs/specs/SpecsConnectPage.d.ts +1 -0
- package/dist/components/docs/specs/SpecsConnectPage.js +8 -0
- package/dist/components/docs/specs/SpecsDataViewsPage.js +2 -260
- package/dist/components/docs/specs/SpecsModuleBundlesPage.d.ts +1 -0
- package/dist/components/docs/specs/SpecsModuleBundlesPage.js +67 -0
- package/dist/components/docs/specs/SpecsOverlaysPage.js +2 -372
- package/dist/components/docs/specs/SpecsOverviewPage.js +1 -186
- package/dist/components/docs/specs/SpecsPolicyPage.js +3 -420
- package/dist/components/docs/specs/SpecsWorkflowsPage.js +2 -325
- package/dist/components/docs/specs/index.d.ts +3 -0
- package/dist/components/docs/specs/index.js +109 -1715
- package/dist/components/docs/studio/StudioBYOKPage.js +1 -26
- package/dist/components/docs/studio/StudioDeploymentsPage.js +1 -26
- package/dist/components/docs/studio/StudioGettingStartedPage.js +1 -26
- package/dist/components/docs/studio/StudioIntegrationsPage.js +1 -26
- package/dist/components/docs/studio/StudioOverviewPage.js +1 -157
- package/dist/components/docs/studio/StudioVisualBuilderPage.js +1 -26
- package/dist/components/docs/studio/index.js +1 -282
- package/dist/components/docs/tech/contracts/tech-docs.docblocks.js +2 -19
- package/dist/components/integrations/index.js +2 -600
- package/dist/components/integrations/molecules/IntegrationCard.js +1 -100
- package/dist/components/integrations/organisms/IntegrationMarketplace.js +1 -214
- package/dist/components/integrations/organisms/IntegrationSettings.js +2 -284
- package/dist/components/integrations/organisms/KnowledgeSourceList.js +1 -103
- package/dist/components/legal/PrivacyTemplate.js +1 -1025
- package/dist/components/legal/TermsTemplate.js +1 -941
- package/dist/components/legal/index.js +1 -1963
- package/dist/components/shared/FeatureGateNotice.js +1 -38
- package/dist/components/shared/index.js +1 -38
- package/dist/components/shell/WorkspaceHeader.js +1 -100
- package/dist/components/shell/WorkspaceProjectShellLayout.js +1 -222
- package/dist/components/shell/WorkspaceShellRenderer.js +1 -228
- package/dist/components/shell/WorkspaceSidebar.js +1 -68
- package/dist/components/shell/index.js +1 -287
- package/dist/components/templates/engine/index.js +1 -39
- package/dist/components/templates/index.js +11 -965
- package/dist/components/templates/messaging/ConversationList.js +2 -83
- package/dist/components/templates/messaging/MessageComposer.js +4 -150
- package/dist/components/templates/messaging/MessageThread.js +3 -83
- package/dist/components/templates/messaging/MessagingWorkspace.js +5 -265
- package/dist/components/templates/messaging/index.js +5 -269
- package/dist/components/templates/recipes/LanguageSwitcher.js +1 -16
- package/dist/components/templates/recipes/RecipeCard.js +1 -80
- package/dist/components/templates/recipes/RecipeDetail.js +1 -74
- package/dist/components/templates/recipes/RecipeList.js +3 -245
- package/dist/components/templates/recipes/index.js +3 -248
- package/dist/components/templates/todos/FilterBar.js +1 -107
- package/dist/components/templates/todos/TaskForm.js +2 -158
- package/dist/components/templates/todos/TaskItem.js +1 -77
- package/dist/components/templates/todos/TaskList.js +5 -449
- package/dist/components/templates/todos/index.js +5 -452
- package/dist/config/contractspec-blueprint.js +1 -123
- package/dist/config/contractspec-branding.js +1 -44
- package/dist/config/contractspec-routes.js +1 -24
- package/dist/config/index.js +1 -126
- package/dist/features/contracts-registry.js +1 -178
- package/dist/features/docs/docs.contracts.js +1 -17
- package/dist/features/docs/index.js +1 -17
- package/dist/features/docs.feature.js +1 -33
- package/dist/features/index.js +1 -315
- package/dist/features/mcp.feature.js +1 -30
- package/dist/features/presentations.feature.js +1 -33
- package/dist/features/registry.js +1 -116
- package/dist/index.js +556 -28593
- package/dist/infrastructure/elysia/index.js +1 -35
- package/dist/infrastructure/elysia/logger.js +1 -35
- package/dist/infrastructure/index.js +1 -35
- package/dist/libs/email/client.js +1 -114
- package/dist/libs/email/contact.js +12 -165
- package/dist/libs/email/newsletter.js +6 -167
- package/dist/libs/email/types.js +0 -2
- package/dist/libs/email/utils.js +2 -8
- package/dist/libs/email/waitlist-application.js +28 -209
- package/dist/libs/email/waitlist.js +6 -167
- package/dist/libs/email.js +46 -363
- package/dist/libs/posthog/client.js +1 -63
- package/dist/libs/posthog/native.js +1 -23
- package/dist/libs/posthog/server.js +1 -13
- package/dist/libs/pricing-examples.js +1 -18
- package/dist/node/application/context-storage/index.js +1 -28
- package/dist/node/application/index.js +13 -2133
- package/dist/node/application/mcp/cliMcp.js +4 -452
- package/dist/node/application/mcp/common.js +1 -193
- package/dist/node/application/mcp/contractsMcp.js +2 -549
- package/dist/node/application/mcp/contractsMcpResources.js +2 -123
- package/dist/node/application/mcp/contractsMcpTools.js +1 -199
- package/dist/node/application/mcp/docsMcp.catalog.js +3 -381
- package/dist/node/application/mcp/docsMcp.data.js +1 -147
- package/dist/node/application/mcp/docsMcp.js +6 -1039
- package/dist/node/application/mcp/docsMcp.prompts.js +6 -521
- package/dist/node/application/mcp/docsMcp.reference.js +3 -235
- package/dist/node/application/mcp/docsMcp.resources.js +3 -519
- package/dist/node/application/mcp/docsMcp.tools.js +3 -518
- package/dist/node/application/mcp/index.js +13 -2106
- package/dist/node/application/mcp/internalMcp.js +2 -410
- package/dist/node/application/mcp/normalizeMcpRequest.js +1 -21
- package/dist/node/application/mcp/providerRankingMcp.js +1 -530
- package/dist/node/bundles/LibraryBundle.js +1 -138
- package/dist/node/bundles/index.js +1 -138
- package/dist/node/components/docs/DocsIndexPage.js +2 -912
- package/dist/node/components/docs/advanced/AdvancedMCPPage.js +4 -271
- package/dist/node/components/docs/advanced/AdvancedOverlayEditorPage.js +1 -107
- package/dist/node/components/docs/advanced/AdvancedRenderersPage.js +2 -118
- package/dist/node/components/docs/advanced/AdvancedSpecExperimentsPage.js +4 -92
- package/dist/node/components/docs/advanced/AdvancedTelemetryPage.js +2 -373
- package/dist/node/components/docs/advanced/AdvancedWorkflowMonitoringPage.js +2 -99
- package/dist/node/components/docs/advanced/index.js +10 -1055
- package/dist/node/components/docs/architecture/ArchitectureAppConfigPage.js +6 -243
- package/dist/node/components/docs/architecture/ArchitectureControlPlanePage.js +3 -160
- package/dist/node/components/docs/architecture/ArchitectureIntegrationBindingPage.js +7 -259
- package/dist/node/components/docs/architecture/ArchitectureKnowledgeBindingPage.js +6 -374
- package/dist/node/components/docs/architecture/ArchitectureMultiTenancyPage.js +2 -166
- package/dist/node/components/docs/architecture/ArchitectureOverviewPage.js +1 -143
- package/dist/node/components/docs/architecture/index.js +20 -1340
- package/dist/node/components/docs/comparison/ComparisonAutomationPlatformsPage.js +1 -245
- package/dist/node/components/docs/comparison/ComparisonEnterprisePlatformsPage.js +1 -230
- package/dist/node/components/docs/comparison/ComparisonInternalToolBuildersPage.js +1 -245
- package/dist/node/components/docs/comparison/ComparisonOverviewPage.js +1 -202
- package/dist/node/components/docs/comparison/ComparisonWindmillPage.js +1 -254
- package/dist/node/components/docs/comparison/ComparisonWorkflowEnginesPage.js +1 -339
- package/dist/node/components/docs/comparison/index.js +1 -1510
- package/dist/node/components/docs/docsManifest.js +1 -611
- package/dist/node/components/docs/ecosystem/IntegrationsPage.js +2 -103
- package/dist/node/components/docs/ecosystem/PluginsPage.js +13 -179
- package/dist/node/components/docs/ecosystem/RegistryPage.js +7 -100
- package/dist/node/components/docs/ecosystem/TemplatesPage.js +3 -141
- package/dist/node/components/docs/ecosystem/ecosystem.docblocks.js +2 -48
- package/dist/node/components/docs/ecosystem/index.js +23 -569
- package/dist/node/components/docs/examples/DocsExamplesPage.js +4 -124
- package/dist/node/components/docs/examples/ExampleShowcasePage.js +4 -244
- package/dist/node/components/docs/examples/exampleShowcaseData.js +4 -39
- package/dist/node/components/docs/examples/index.js +4 -330
- package/dist/node/components/docs/generated/docs-index.generated.js +1 -5
- package/dist/node/components/docs/generated/index.js +1 -74
- package/dist/node/components/docs/generated/loader.js +1 -74
- package/dist/node/components/docs/getting-started/CLIPage.js +4 -271
- package/dist/node/components/docs/getting-started/CompatibilityPage.js +1 -173
- package/dist/node/components/docs/getting-started/DataViewTutorialPage.js +4 -134
- package/dist/node/components/docs/getting-started/DeveloperToolsPage.js +1 -194
- package/dist/node/components/docs/getting-started/HelloWorldPage.js +5 -183
- package/dist/node/components/docs/getting-started/InstallationPage.js +3 -154
- package/dist/node/components/docs/getting-started/StartHerePage.js +2 -129
- package/dist/node/components/docs/getting-started/TroubleshootingPage.js +2 -168
- package/dist/node/components/docs/getting-started/VSCodeExtensionPage.js +1 -432
- package/dist/node/components/docs/getting-started/getting-started.docblocks.js +4 -41
- package/dist/node/components/docs/getting-started/index.js +18 -1869
- package/dist/node/components/docs/guides/GuideCIDiffGatingPage.js +2 -196
- package/dist/node/components/docs/guides/GuideConnectInRepoPage.js +43 -0
- package/dist/node/components/docs/guides/GuideContractTypesPage.js +6 -541
- package/dist/node/components/docs/guides/GuideDocsPipelinePage.js +3 -207
- package/dist/node/components/docs/guides/GuideFirstModuleBundlePage.js +75 -0
- package/dist/node/components/docs/guides/GuideGenerateDocsClientsSchemasPage.js +2 -209
- package/dist/node/components/docs/guides/GuideHostBuilderWorkbenchPage.js +69 -0
- package/dist/node/components/docs/guides/GuideImportExistingCodebasesPage.js +8 -754
- package/dist/node/components/docs/guides/GuideNextjsOneEndpointPage.js +6 -268
- package/dist/node/components/docs/guides/GuideSpecValidationTypingPage.js +4 -196
- package/dist/node/components/docs/guides/GuidesIndexPage.js +2 -169
- package/dist/node/components/docs/guides/guides.docblocks.js +11 -75
- package/dist/node/components/docs/guides/index.js +213 -2428
- package/dist/node/components/docs/index.js +542 -24310
- package/dist/node/components/docs/integrations/IntegrationsCircuitBreakersPage.js +2 -42
- package/dist/node/components/docs/integrations/IntegrationsElevenLabsPage.js +3 -105
- package/dist/node/components/docs/integrations/IntegrationsGithubPage.js +3 -142
- package/dist/node/components/docs/integrations/IntegrationsGmailPage.js +3 -109
- package/dist/node/components/docs/integrations/IntegrationsGoogleCalendarPage.js +3 -79
- package/dist/node/components/docs/integrations/IntegrationsHealthRoutingPage.js +3 -146
- package/dist/node/components/docs/integrations/IntegrationsMistralPage.js +5 -150
- package/dist/node/components/docs/integrations/IntegrationsOpenAIPage.js +5 -140
- package/dist/node/components/docs/integrations/IntegrationsOverviewPage.js +1 -160
- package/dist/node/components/docs/integrations/IntegrationsPostmarkPage.js +4 -218
- package/dist/node/components/docs/integrations/IntegrationsPowensPage.js +4 -300
- package/dist/node/components/docs/integrations/IntegrationsQdrantPage.js +5 -111
- package/dist/node/components/docs/integrations/IntegrationsResendPage.js +3 -102
- package/dist/node/components/docs/integrations/IntegrationsS3Page.js +4 -124
- package/dist/node/components/docs/integrations/IntegrationsSlackPage.js +3 -144
- package/dist/node/components/docs/integrations/IntegrationsSpecModelPage.js +7 -290
- package/dist/node/components/docs/integrations/IntegrationsStripePage.js +6 -327
- package/dist/node/components/docs/integrations/IntegrationsTwilioPage.js +3 -128
- package/dist/node/components/docs/integrations/IntegrationsWhatsappMetaPage.js +2 -146
- package/dist/node/components/docs/integrations/IntegrationsWhatsappTwilioPage.js +2 -156
- package/dist/node/components/docs/integrations/index.js +52 -3100
- package/dist/node/components/docs/intent/ContractFirstApiPage.js +2 -126
- package/dist/node/components/docs/intent/DeterministicCodegenPage.js +2 -148
- package/dist/node/components/docs/intent/GenerateClientFromSchemaPage.js +7 -207
- package/dist/node/components/docs/intent/OpenapiAlternativePage.js +3 -201
- package/dist/node/components/docs/intent/SchemaValidationTypescriptPage.js +4 -144
- package/dist/node/components/docs/intent/SpecDrivenDevelopmentPage.js +2 -126
- package/dist/node/components/docs/intent/index.js +15 -1135
- package/dist/node/components/docs/intent/intent-pages.docblocks.js +1 -201
- package/dist/node/components/docs/knowledge/KnowledgeCategoriesPage.js +6 -750
- package/dist/node/components/docs/knowledge/KnowledgeExamplesPage.js +4 -175
- package/dist/node/components/docs/knowledge/KnowledgeOverviewPage.js +1 -116
- package/dist/node/components/docs/knowledge/KnowledgeSourcesPage.js +8 -391
- package/dist/node/components/docs/knowledge/KnowledgeSpacesPage.js +6 -302
- package/dist/node/components/docs/knowledge/index.js +21 -1730
- package/dist/node/components/docs/libraries/LibrariesAccessibilityPage.js +3 -198
- package/dist/node/components/docs/libraries/LibrariesAiAgentPage.js +3 -141
- package/dist/node/components/docs/libraries/LibrariesAnalyticsPage.js +4 -80
- package/dist/node/components/docs/libraries/LibrariesContentGenPage.js +2 -100
- package/dist/node/components/docs/libraries/LibrariesContractsPage.js +2 -284
- package/dist/node/components/docs/libraries/LibrariesCostTrackingPage.js +3 -112
- package/dist/node/components/docs/libraries/LibrariesDataBackendPage.js +2 -166
- package/dist/node/components/docs/libraries/LibrariesDataViewsPage.js +3 -186
- package/dist/node/components/docs/libraries/LibrariesDesignSystemPage.js +4 -279
- package/dist/node/components/docs/libraries/LibrariesEvolutionPage.js +4 -127
- package/dist/node/components/docs/libraries/LibrariesGraphQLPage.js +2 -173
- package/dist/node/components/docs/libraries/LibrariesGrowthPage.js +3 -88
- package/dist/node/components/docs/libraries/LibrariesMultiTenancyPage.js +3 -108
- package/dist/node/components/docs/libraries/LibrariesObservabilityPage.js +5 -130
- package/dist/node/components/docs/libraries/LibrariesOverlayEnginePage.js +4 -110
- package/dist/node/components/docs/libraries/LibrariesOverviewPage.js +1 -170
- package/dist/node/components/docs/libraries/LibrariesPersonalizationPage.js +4 -114
- package/dist/node/components/docs/libraries/LibrariesProgressiveDeliveryPage.js +3 -132
- package/dist/node/components/docs/libraries/LibrariesResiliencePage.js +4 -120
- package/dist/node/components/docs/libraries/LibrariesRuntimePage.js +2 -200
- package/dist/node/components/docs/libraries/LibrariesSLOPage.js +3 -116
- package/dist/node/components/docs/libraries/LibrariesSchemaPage.js +3 -273
- package/dist/node/components/docs/libraries/LibrariesSupportBotPage.js +3 -134
- package/dist/node/components/docs/libraries/LibrariesTestingPage.js +3 -133
- package/dist/node/components/docs/libraries/LibrariesUIKitPage.js +2 -230
- package/dist/node/components/docs/libraries/LibrariesWorkflowComposerPage.js +3 -88
- package/dist/node/components/docs/libraries/LibrariesWorkflowsPage.js +2 -181
- package/dist/node/components/docs/libraries/index.js +54 -4147
- package/dist/node/components/docs/manifesto/ManifestoPage.js +1 -86
- package/dist/node/components/docs/ops/AutoEvolutionOpsPage.js +2 -132
- package/dist/node/components/docs/ops/DistributedTracingOpsPage.js +2 -71
- package/dist/node/components/docs/ops/index.js +3 -202
- package/dist/node/components/docs/ops/ops-lifecycle.docblocks.js +3 -38
- package/dist/node/components/docs/ops/ops-runbooks-a.docblocks.js +3 -94
- package/dist/node/components/docs/ops/ops-runbooks-b.docblocks.js +3 -76
- package/dist/node/components/docs/ops/ops-slo-tenant.docblocks.js +3 -76
- package/dist/node/components/docs/ops/ops-top.docs.js +2 -17
- package/dist/node/components/docs/ops/ops.docs.js +10 -302
- package/dist/node/components/docs/product/product.docblocks.js +5 -72
- package/dist/node/components/docs/reference/DocsMarkdownContent.js +2 -196
- package/dist/node/components/docs/reference/DocsReferenceContent.js +3 -256
- package/dist/node/components/docs/reference/DocsReferenceIndexClient.js +2 -127
- package/dist/node/components/docs/reference/DocsReferenceIndexPage.js +2 -206
- package/dist/node/components/docs/reference/DocsReferencePage.js +3 -265
- package/dist/node/components/docs/reference/docsMarkdownParser.js +2 -92
- package/dist/node/components/docs/reference/index.js +4 -470
- package/dist/node/components/docs/safety/SafetyAuditingPage.js +2 -350
- package/dist/node/components/docs/safety/SafetyMigrationsPage.js +2 -359
- package/dist/node/components/docs/safety/SafetyOverviewPage.js +1 -101
- package/dist/node/components/docs/safety/SafetyPDPPage.js +2 -301
- package/dist/node/components/docs/safety/SafetySecurityTrustPage.js +1 -206
- package/dist/node/components/docs/safety/SafetySigningPage.js +3 -90
- package/dist/node/components/docs/safety/SafetyTenantIsolationPage.js +2 -79
- package/dist/node/components/docs/safety/index.js +7 -1480
- package/dist/node/components/docs/shared/StudioPrompt.js +1 -31
- package/dist/node/components/docs/specs/SpecsBuilderControlPlanePage.js +33 -0
- package/dist/node/components/docs/specs/SpecsCapabilitiesPage.js +2 -158
- package/dist/node/components/docs/specs/SpecsConnectPage.js +7 -0
- package/dist/node/components/docs/specs/SpecsDataViewsPage.js +2 -260
- package/dist/node/components/docs/specs/SpecsModuleBundlesPage.js +66 -0
- package/dist/node/components/docs/specs/SpecsOverlaysPage.js +2 -372
- package/dist/node/components/docs/specs/SpecsOverviewPage.js +1 -186
- package/dist/node/components/docs/specs/SpecsPolicyPage.js +3 -420
- package/dist/node/components/docs/specs/SpecsWorkflowsPage.js +2 -325
- package/dist/node/components/docs/specs/index.js +109 -1715
- package/dist/node/components/docs/studio/StudioBYOKPage.js +1 -26
- package/dist/node/components/docs/studio/StudioDeploymentsPage.js +1 -26
- package/dist/node/components/docs/studio/StudioGettingStartedPage.js +1 -26
- package/dist/node/components/docs/studio/StudioIntegrationsPage.js +1 -26
- package/dist/node/components/docs/studio/StudioOverviewPage.js +1 -157
- package/dist/node/components/docs/studio/StudioVisualBuilderPage.js +1 -26
- package/dist/node/components/docs/studio/index.js +1 -282
- package/dist/node/components/docs/tech/contracts/tech-docs.docblocks.js +2 -19
- package/dist/node/components/integrations/index.js +2 -600
- package/dist/node/components/integrations/molecules/IntegrationCard.js +1 -100
- package/dist/node/components/integrations/organisms/IntegrationMarketplace.js +1 -214
- package/dist/node/components/integrations/organisms/IntegrationSettings.js +2 -284
- package/dist/node/components/integrations/organisms/KnowledgeSourceList.js +1 -103
- package/dist/node/components/legal/PrivacyTemplate.js +1 -1025
- package/dist/node/components/legal/TermsTemplate.js +1 -941
- package/dist/node/components/legal/index.js +1 -1963
- package/dist/node/components/shared/FeatureGateNotice.js +1 -38
- package/dist/node/components/shared/index.js +1 -38
- package/dist/node/components/shell/WorkspaceHeader.js +1 -100
- package/dist/node/components/shell/WorkspaceProjectShellLayout.js +1 -222
- package/dist/node/components/shell/WorkspaceShellRenderer.js +1 -228
- package/dist/node/components/shell/WorkspaceSidebar.js +1 -68
- package/dist/node/components/shell/index.js +1 -287
- package/dist/node/components/templates/engine/index.js +1 -39
- package/dist/node/components/templates/index.js +11 -965
- package/dist/node/components/templates/messaging/ConversationList.js +2 -83
- package/dist/node/components/templates/messaging/MessageComposer.js +4 -150
- package/dist/node/components/templates/messaging/MessageThread.js +3 -83
- package/dist/node/components/templates/messaging/MessagingWorkspace.js +5 -265
- package/dist/node/components/templates/messaging/index.js +5 -269
- package/dist/node/components/templates/recipes/LanguageSwitcher.js +1 -16
- package/dist/node/components/templates/recipes/RecipeCard.js +1 -80
- package/dist/node/components/templates/recipes/RecipeDetail.js +1 -74
- package/dist/node/components/templates/recipes/RecipeList.js +3 -245
- package/dist/node/components/templates/recipes/index.js +3 -248
- package/dist/node/components/templates/todos/FilterBar.js +1 -107
- package/dist/node/components/templates/todos/TaskForm.js +2 -158
- package/dist/node/components/templates/todos/TaskItem.js +1 -77
- package/dist/node/components/templates/todos/TaskList.js +5 -449
- package/dist/node/components/templates/todos/index.js +5 -452
- package/dist/node/config/contractspec-blueprint.js +1 -123
- package/dist/node/config/contractspec-branding.js +1 -44
- package/dist/node/config/contractspec-routes.js +1 -24
- package/dist/node/config/index.js +1 -126
- package/dist/node/features/contracts-registry.js +1 -178
- package/dist/node/features/docs/docs.contracts.js +1 -17
- package/dist/node/features/docs/index.js +1 -17
- package/dist/node/features/docs.feature.js +1 -33
- package/dist/node/features/index.js +1 -315
- package/dist/node/features/mcp.feature.js +1 -30
- package/dist/node/features/presentations.feature.js +1 -33
- package/dist/node/features/registry.js +1 -116
- package/dist/node/index.js +556 -28593
- package/dist/node/infrastructure/elysia/index.js +1 -35
- package/dist/node/infrastructure/elysia/logger.js +1 -35
- package/dist/node/infrastructure/index.js +1 -35
- package/dist/node/libs/email/client.js +1 -114
- package/dist/node/libs/email/contact.js +12 -165
- package/dist/node/libs/email/newsletter.js +6 -167
- package/dist/node/libs/email/types.js +0 -2
- package/dist/node/libs/email/utils.js +2 -8
- package/dist/node/libs/email/waitlist-application.js +28 -209
- package/dist/node/libs/email/waitlist.js +6 -167
- package/dist/node/libs/email.js +46 -363
- package/dist/node/libs/posthog/client.js +1 -63
- package/dist/node/libs/posthog/native.js +1 -23
- package/dist/node/libs/posthog/server.js +1 -13
- package/dist/node/libs/pricing-examples.js +1 -18
- package/dist/node/presentation/features/atoms/FeatureIcon/FeatureIcon.js +1 -97
- package/dist/node/presentation/features/atoms/FeatureIcon/index.js +1 -97
- package/dist/node/presentation/features/atoms/index.js +1 -97
- package/dist/node/presentation/features/hooks/index.js +1 -397
- package/dist/node/presentation/features/hooks/useContractsRegistry.js +1 -289
- package/dist/node/presentation/features/hooks/useFeatureFilters.js +1 -75
- package/dist/node/presentation/features/hooks/useFeatureRegistry.js +1 -147
- package/dist/node/presentation/features/hooks/useRelatedDocs.js +1 -28
- package/dist/node/presentation/features/index.js +1 -3063
- package/dist/node/presentation/features/molecules/FeatureCard/FeatureCard.js +1 -366
- package/dist/node/presentation/features/molecules/FeatureCard/index.js +1 -366
- package/dist/node/presentation/features/molecules/FeatureCategoryHeader/FeatureCategoryHeader.js +1 -50
- package/dist/node/presentation/features/molecules/FeatureCategoryHeader/index.js +1 -50
- package/dist/node/presentation/features/molecules/FeatureFilters/FeatureFilters.js +1 -92
- package/dist/node/presentation/features/molecules/FeatureFilters/index.js +1 -92
- package/dist/node/presentation/features/molecules/FeatureHoverPreview/FeatureHoverPreview.js +1 -176
- package/dist/node/presentation/features/molecules/FeatureHoverPreview/index.js +1 -176
- package/dist/node/presentation/features/molecules/index.js +1 -505
- package/dist/node/presentation/features/organisms/FeatureDataViewsList.js +1 -304
- package/dist/node/presentation/features/organisms/FeatureDetail/FeatureDetail.js +1 -154
- package/dist/node/presentation/features/organisms/FeatureDetail/index.js +1 -154
- package/dist/node/presentation/features/organisms/FeatureDiscovery/FeatureDiscovery.js +1 -909
- package/dist/node/presentation/features/organisms/FeatureDiscovery/index.js +1 -909
- package/dist/node/presentation/features/organisms/FeatureEventsList.js +1 -302
- package/dist/node/presentation/features/organisms/FeatureFormsList.js +1 -302
- package/dist/node/presentation/features/organisms/FeatureOperationsList.js +1 -180
- package/dist/node/presentation/features/organisms/FeaturePresentationsList.js +1 -304
- package/dist/node/presentation/features/organisms/index.js +1 -1359
- package/dist/node/presentation/features/templates/FeatureDataViewDetailTemplate/FeatureDataViewDetailTemplate.js +1 -332
- package/dist/node/presentation/features/templates/FeatureDataViewDetailTemplate/index.js +1 -332
- package/dist/node/presentation/features/templates/FeatureDataViewsTemplate/FeatureDataViewsTemplate.js +1 -342
- package/dist/node/presentation/features/templates/FeatureDataViewsTemplate/index.js +1 -342
- package/dist/node/presentation/features/templates/FeatureEventDetailTemplate/FeatureEventDetailTemplate.js +1 -303
- package/dist/node/presentation/features/templates/FeatureEventDetailTemplate/index.js +1 -303
- package/dist/node/presentation/features/templates/FeatureEventsTemplate/FeatureEventsTemplate.js +1 -340
- package/dist/node/presentation/features/templates/FeatureEventsTemplate/index.js +1 -340
- package/dist/node/presentation/features/templates/FeatureFormDetailTemplate/FeatureFormDetailTemplate.js +1 -329
- package/dist/node/presentation/features/templates/FeatureFormDetailTemplate/index.js +1 -329
- package/dist/node/presentation/features/templates/FeatureFormsTemplate/FeatureFormsTemplate.js +1 -340
- package/dist/node/presentation/features/templates/FeatureFormsTemplate/index.js +1 -340
- package/dist/node/presentation/features/templates/FeatureOperationDetailTemplate/FeatureOperationDetailTemplate.js +1 -302
- package/dist/node/presentation/features/templates/FeatureOperationDetailTemplate/index.js +1 -302
- package/dist/node/presentation/features/templates/FeatureOperationsTemplate/FeatureOperationsTemplate.js +1 -218
- package/dist/node/presentation/features/templates/FeatureOperationsTemplate/index.js +1 -218
- package/dist/node/presentation/features/templates/FeatureOverviewTemplate/FeatureOverviewTemplate.js +1 -187
- package/dist/node/presentation/features/templates/FeatureOverviewTemplate/index.js +1 -187
- package/dist/node/presentation/features/templates/FeaturePresentationDetailTemplate/FeaturePresentationDetailTemplate.js +1 -306
- package/dist/node/presentation/features/templates/FeaturePresentationDetailTemplate/index.js +1 -306
- package/dist/node/presentation/features/templates/FeaturePresentationsTemplate/FeaturePresentationsTemplate.js +1 -342
- package/dist/node/presentation/features/templates/FeaturePresentationsTemplate/index.js +1 -342
- package/dist/presentation/features/atoms/FeatureIcon/FeatureIcon.js +1 -97
- package/dist/presentation/features/atoms/FeatureIcon/index.js +1 -97
- package/dist/presentation/features/atoms/index.js +1 -97
- package/dist/presentation/features/hooks/index.js +1 -397
- package/dist/presentation/features/hooks/useContractsRegistry.js +1 -289
- package/dist/presentation/features/hooks/useFeatureFilters.js +1 -75
- package/dist/presentation/features/hooks/useFeatureRegistry.js +1 -147
- package/dist/presentation/features/hooks/useRelatedDocs.js +1 -28
- package/dist/presentation/features/index.js +1 -3063
- package/dist/presentation/features/molecules/FeatureCard/FeatureCard.js +1 -366
- package/dist/presentation/features/molecules/FeatureCard/index.js +1 -366
- package/dist/presentation/features/molecules/FeatureCategoryHeader/FeatureCategoryHeader.js +1 -50
- package/dist/presentation/features/molecules/FeatureCategoryHeader/index.js +1 -50
- package/dist/presentation/features/molecules/FeatureFilters/FeatureFilters.js +1 -92
- package/dist/presentation/features/molecules/FeatureFilters/index.js +1 -92
- package/dist/presentation/features/molecules/FeatureHoverPreview/FeatureHoverPreview.js +1 -176
- package/dist/presentation/features/molecules/FeatureHoverPreview/index.js +1 -176
- package/dist/presentation/features/molecules/index.js +1 -505
- package/dist/presentation/features/organisms/FeatureDataViewsList.js +1 -304
- package/dist/presentation/features/organisms/FeatureDetail/FeatureDetail.js +1 -154
- package/dist/presentation/features/organisms/FeatureDetail/index.js +1 -154
- package/dist/presentation/features/organisms/FeatureDiscovery/FeatureDiscovery.js +1 -909
- package/dist/presentation/features/organisms/FeatureDiscovery/index.js +1 -909
- package/dist/presentation/features/organisms/FeatureEventsList.js +1 -302
- package/dist/presentation/features/organisms/FeatureFormsList.js +1 -302
- package/dist/presentation/features/organisms/FeatureOperationsList.js +1 -180
- package/dist/presentation/features/organisms/FeaturePresentationsList.js +1 -304
- package/dist/presentation/features/organisms/index.js +1 -1359
- package/dist/presentation/features/templates/FeatureDataViewDetailTemplate/FeatureDataViewDetailTemplate.js +1 -332
- package/dist/presentation/features/templates/FeatureDataViewDetailTemplate/index.js +1 -332
- package/dist/presentation/features/templates/FeatureDataViewsTemplate/FeatureDataViewsTemplate.js +1 -342
- package/dist/presentation/features/templates/FeatureDataViewsTemplate/index.js +1 -342
- package/dist/presentation/features/templates/FeatureEventDetailTemplate/FeatureEventDetailTemplate.js +1 -303
- package/dist/presentation/features/templates/FeatureEventDetailTemplate/index.js +1 -303
- package/dist/presentation/features/templates/FeatureEventsTemplate/FeatureEventsTemplate.js +1 -340
- package/dist/presentation/features/templates/FeatureEventsTemplate/index.js +1 -340
- package/dist/presentation/features/templates/FeatureFormDetailTemplate/FeatureFormDetailTemplate.js +1 -329
- package/dist/presentation/features/templates/FeatureFormDetailTemplate/index.js +1 -329
- package/dist/presentation/features/templates/FeatureFormsTemplate/FeatureFormsTemplate.js +1 -340
- package/dist/presentation/features/templates/FeatureFormsTemplate/index.js +1 -340
- package/dist/presentation/features/templates/FeatureOperationDetailTemplate/FeatureOperationDetailTemplate.js +1 -302
- package/dist/presentation/features/templates/FeatureOperationDetailTemplate/index.js +1 -302
- package/dist/presentation/features/templates/FeatureOperationsTemplate/FeatureOperationsTemplate.js +1 -218
- package/dist/presentation/features/templates/FeatureOperationsTemplate/index.js +1 -218
- package/dist/presentation/features/templates/FeatureOverviewTemplate/FeatureOverviewTemplate.js +1 -187
- package/dist/presentation/features/templates/FeatureOverviewTemplate/index.js +1 -187
- package/dist/presentation/features/templates/FeaturePresentationDetailTemplate/FeaturePresentationDetailTemplate.js +1 -306
- package/dist/presentation/features/templates/FeaturePresentationDetailTemplate/index.js +1 -306
- package/dist/presentation/features/templates/FeaturePresentationsTemplate/FeaturePresentationsTemplate.js +1 -342
- package/dist/presentation/features/templates/FeaturePresentationsTemplate/index.js +1 -342
- package/package.json +103 -31
- package/src/components/docs/DocsIndexPage.tsx +55 -0
- package/src/components/docs/architecture/ArchitectureControlPlanePage.tsx +19 -0
- package/src/components/docs/architecture/ArchitectureOverviewPage.tsx +34 -0
- package/src/components/docs/docsManifest.test.ts +70 -0
- package/src/components/docs/docsManifest.ts +71 -1
- package/src/components/docs/ecosystem/PluginsPage.tsx +24 -10
- package/src/components/docs/ecosystem/RegistryPage.tsx +11 -6
- package/src/components/docs/generated/docs-index._common.json +206 -273
- package/src/components/docs/generated/docs-index.control-plane.json +18 -0
- package/src/components/docs/generated/docs-index.defineExample.json +10 -0
- package/src/components/docs/generated/docs-index.manifest.json +22 -12
- package/src/components/docs/generated/docs-index.platform-acp.json +64 -0
- package/src/components/docs/generated/docs-index.platform-agent.json +89 -1
- package/src/components/docs/generated/docs-index.platform-context.json +48 -0
- package/src/components/docs/generated/docs-index.platform-control-plane.json +72 -0
- package/src/components/docs/generated/docs-index.platform-database.json +40 -0
- package/src/components/docs/generated/docs-index.platform-docs.json +64 -0
- package/src/components/docs/generated/docs-index.platform-provider-ranking.json +89 -1
- package/src/components/docs/generated/docs-index.pocket-family-office.json +8 -0
- package/src/components/docs/generated/docs-index.unknown.json +8 -0
- package/src/components/docs/guides/GuideConnectInRepoPage.tsx +184 -0
- package/src/components/docs/guides/GuideFirstModuleBundlePage.tsx +182 -0
- package/src/components/docs/guides/GuideHostBuilderWorkbenchPage.tsx +230 -0
- package/src/components/docs/guides/GuidesIndexPage.tsx +21 -0
- package/src/components/docs/guides/index.ts +3 -0
- package/src/components/docs/specs/SpecsBuilderControlPlanePage.tsx +210 -0
- package/src/components/docs/specs/SpecsConnectPage.tsx +162 -0
- package/src/components/docs/specs/SpecsModuleBundlesPage.tsx +223 -0
- package/src/components/docs/specs/SpecsOverlaysPage.tsx +20 -0
- package/src/components/docs/specs/SpecsOverviewPage.tsx +44 -0
- package/src/components/docs/specs/index.ts +3 -0
- package/src/components/docs/studio/StudioOverviewPage.tsx +26 -0
- package/src/infrastructure/elysia/logger.ts +11 -3
|
@@ -1,45 +1,4 @@
|
|
|
1
|
-
|
|
2
|
-
import { CodeBlock } from "@contractspec/lib.design-system";
|
|
3
|
-
import Link from "@contractspec/lib.ui-link";
|
|
4
|
-
import { ChevronRight } from "lucide-react";
|
|
5
|
-
import { jsx, jsxs } from "react/jsx-runtime";
|
|
6
|
-
function ArchitectureAppConfigPage() {
|
|
7
|
-
return /* @__PURE__ */ jsxs("div", {
|
|
8
|
-
className: "space-y-8",
|
|
9
|
-
children: [
|
|
10
|
-
/* @__PURE__ */ jsxs("div", {
|
|
11
|
-
className: "space-y-4",
|
|
12
|
-
children: [
|
|
13
|
-
/* @__PURE__ */ jsx("h1", {
|
|
14
|
-
className: "font-bold text-4xl",
|
|
15
|
-
children: "App Configuration"
|
|
16
|
-
}),
|
|
17
|
-
/* @__PURE__ */ jsx("p", {
|
|
18
|
-
className: "text-muted-foreground",
|
|
19
|
-
children: "ContractSpec uses a three-tier configuration model that separates global app definitions from tenant-specific settings and runtime resolution."
|
|
20
|
-
})
|
|
21
|
-
]
|
|
22
|
-
}),
|
|
23
|
-
/* @__PURE__ */ jsxs("div", {
|
|
24
|
-
className: "space-y-4",
|
|
25
|
-
children: [
|
|
26
|
-
/* @__PURE__ */ jsx("h2", {
|
|
27
|
-
className: "font-bold text-2xl",
|
|
28
|
-
children: "AppBlueprintSpec"
|
|
29
|
-
}),
|
|
30
|
-
/* @__PURE__ */ jsxs("p", {
|
|
31
|
-
className: "text-muted-foreground",
|
|
32
|
-
children: [
|
|
33
|
-
"The ",
|
|
34
|
-
/* @__PURE__ */ jsx("strong", {
|
|
35
|
-
children: "AppBlueprintSpec"
|
|
36
|
-
}),
|
|
37
|
-
" is the global, versioned definition of your application. It contains no tenant-specific information and is stored in version control."
|
|
38
|
-
]
|
|
39
|
-
}),
|
|
40
|
-
/* @__PURE__ */ jsx(CodeBlock, {
|
|
41
|
-
language: "typescript",
|
|
42
|
-
code: `type AppBlueprintSpec = {
|
|
1
|
+
import{CodeBlock as g}from"@contractspec/lib.design-system";import b from"@contractspec/lib.ui-link";import{ChevronRight as C}from"lucide-react";import{jsx as n,jsxs as r}from"react/jsx-runtime";function I(){return r("div",{className:"space-y-8",children:[r("div",{className:"space-y-4",children:[n("h1",{className:"font-bold text-4xl",children:"App Configuration"}),n("p",{className:"text-muted-foreground",children:"ContractSpec uses a three-tier configuration model that separates global app definitions from tenant-specific settings and runtime resolution."})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppBlueprintSpec"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"AppBlueprintSpec"})," is the global, versioned definition of your application. It contains no tenant-specific information and is stored in version control."]}),n(g,{language:"typescript",code:`type AppBlueprintSpec = {
|
|
43
2
|
id: string;
|
|
44
3
|
version: string;
|
|
45
4
|
name: string;
|
|
@@ -76,30 +35,7 @@ function ArchitectureAppConfigPage() {
|
|
|
76
35
|
|
|
77
36
|
// Schema evolution
|
|
78
37
|
migrations: MigrationSpec[];
|
|
79
|
-
};`
|
|
80
|
-
})
|
|
81
|
-
]
|
|
82
|
-
}),
|
|
83
|
-
/* @__PURE__ */ jsxs("div", {
|
|
84
|
-
className: "space-y-4",
|
|
85
|
-
children: [
|
|
86
|
-
/* @__PURE__ */ jsx("h2", {
|
|
87
|
-
className: "font-bold text-2xl",
|
|
88
|
-
children: "TenantAppConfig"
|
|
89
|
-
}),
|
|
90
|
-
/* @__PURE__ */ jsxs("p", {
|
|
91
|
-
className: "text-muted-foreground",
|
|
92
|
-
children: [
|
|
93
|
-
"The ",
|
|
94
|
-
/* @__PURE__ */ jsx("strong", {
|
|
95
|
-
children: "TenantAppConfig"
|
|
96
|
-
}),
|
|
97
|
-
" is the per-tenant, per-environment configuration that customizes how a specific tenant uses the app."
|
|
98
|
-
]
|
|
99
|
-
}),
|
|
100
|
-
/* @__PURE__ */ jsx(CodeBlock, {
|
|
101
|
-
language: "typescript",
|
|
102
|
-
code: `type TenantAppConfig = {
|
|
38
|
+
};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"TenantAppConfig"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"TenantAppConfig"})," is the per-tenant, per-environment configuration that customizes how a specific tenant uses the app."]}),n(g,{language:"typescript",code:`type TenantAppConfig = {
|
|
103
39
|
tenantId: string;
|
|
104
40
|
blueprintId: string;
|
|
105
41
|
blueprintVersion: string;
|
|
@@ -130,24 +66,7 @@ function ArchitectureAppConfigPage() {
|
|
|
130
66
|
metadata: Record<string, unknown>;
|
|
131
67
|
createdAt: string;
|
|
132
68
|
updatedAt: string;
|
|
133
|
-
};`
|
|
134
|
-
})
|
|
135
|
-
]
|
|
136
|
-
}),
|
|
137
|
-
/* @__PURE__ */ jsxs("div", {
|
|
138
|
-
className: "space-y-4",
|
|
139
|
-
children: [
|
|
140
|
-
/* @__PURE__ */ jsx("h2", {
|
|
141
|
-
className: "font-bold text-2xl",
|
|
142
|
-
children: "AppIntegrationBinding"
|
|
143
|
-
}),
|
|
144
|
-
/* @__PURE__ */ jsx("p", {
|
|
145
|
-
className: "text-muted-foreground",
|
|
146
|
-
children: "Defines how a tenant connects specific integration instances to satisfy capabilities and workflows."
|
|
147
|
-
}),
|
|
148
|
-
/* @__PURE__ */ jsx(CodeBlock, {
|
|
149
|
-
language: "typescript",
|
|
150
|
-
code: `type AppIntegrationBinding = {
|
|
69
|
+
};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppIntegrationBinding"}),n("p",{className:"text-muted-foreground",children:"Defines how a tenant connects specific integration instances to satisfy capabilities and workflows."}),n(g,{language:"typescript",code:`type AppIntegrationBinding = {
|
|
151
70
|
slotId: string; // References AppIntegrationSlot.slotId
|
|
152
71
|
connectionId: string; // References IntegrationConnection.meta.id
|
|
153
72
|
scope?: {
|
|
@@ -167,24 +86,7 @@ function ArchitectureAppConfigPage() {
|
|
|
167
86
|
operations: ["payments.stripe.*"]
|
|
168
87
|
},
|
|
169
88
|
priority: 1
|
|
170
|
-
}`
|
|
171
|
-
})
|
|
172
|
-
]
|
|
173
|
-
}),
|
|
174
|
-
/* @__PURE__ */ jsxs("div", {
|
|
175
|
-
className: "space-y-4",
|
|
176
|
-
children: [
|
|
177
|
-
/* @__PURE__ */ jsx("h2", {
|
|
178
|
-
className: "font-bold text-2xl",
|
|
179
|
-
children: "AppKnowledgeBinding"
|
|
180
|
-
}),
|
|
181
|
-
/* @__PURE__ */ jsx("p", {
|
|
182
|
-
className: "text-muted-foreground",
|
|
183
|
-
children: "Defines which knowledge spaces a tenant's app can access and how."
|
|
184
|
-
}),
|
|
185
|
-
/* @__PURE__ */ jsx(CodeBlock, {
|
|
186
|
-
language: "typescript",
|
|
187
|
-
code: `type AppKnowledgeBinding = {
|
|
89
|
+
}`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppKnowledgeBinding"}),n("p",{className:"text-muted-foreground",children:"Defines which knowledge spaces a tenant's app can access and how."}),n(g,{language:"typescript",code:`type AppKnowledgeBinding = {
|
|
188
90
|
spaceId: string;
|
|
189
91
|
enabled: boolean;
|
|
190
92
|
|
|
@@ -214,30 +116,7 @@ function ArchitectureAppConfigPage() {
|
|
|
214
116
|
},
|
|
215
117
|
allowedCategories: ["canonical", "operational"],
|
|
216
118
|
sources: ["src_notion_product_docs", "src_database_schema"]
|
|
217
|
-
}`
|
|
218
|
-
})
|
|
219
|
-
]
|
|
220
|
-
}),
|
|
221
|
-
/* @__PURE__ */ jsxs("div", {
|
|
222
|
-
className: "space-y-4",
|
|
223
|
-
children: [
|
|
224
|
-
/* @__PURE__ */ jsx("h2", {
|
|
225
|
-
className: "font-bold text-2xl",
|
|
226
|
-
children: "ResolvedAppConfig"
|
|
227
|
-
}),
|
|
228
|
-
/* @__PURE__ */ jsxs("p", {
|
|
229
|
-
className: "text-muted-foreground",
|
|
230
|
-
children: [
|
|
231
|
-
"The ",
|
|
232
|
-
/* @__PURE__ */ jsx("strong", {
|
|
233
|
-
children: "ResolvedAppConfig"
|
|
234
|
-
}),
|
|
235
|
-
" is the runtime result of merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand and never persisted."
|
|
236
|
-
]
|
|
237
|
-
}),
|
|
238
|
-
/* @__PURE__ */ jsx(CodeBlock, {
|
|
239
|
-
language: "typescript",
|
|
240
|
-
code: `type ResolvedAppConfig = {
|
|
119
|
+
}`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"ResolvedAppConfig"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"ResolvedAppConfig"})," is the runtime result of merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand and never persisted."]}),n(g,{language:"typescript",code:`type ResolvedAppConfig = {
|
|
241
120
|
appId: string;
|
|
242
121
|
tenantId: string;
|
|
243
122
|
blueprintName: string;
|
|
@@ -264,195 +143,7 @@ function ArchitectureAppConfigPage() {
|
|
|
264
143
|
knowledge: ResolvedKnowledge[]; // [{ binding, space, sources }]
|
|
265
144
|
branding: ResolvedBranding; // { appName, assets, colors, domain }
|
|
266
145
|
notes?: string;
|
|
267
|
-
};`
|
|
268
|
-
})
|
|
269
|
-
]
|
|
270
|
-
}),
|
|
271
|
-
/* @__PURE__ */ jsxs("div", {
|
|
272
|
-
className: "space-y-4",
|
|
273
|
-
children: [
|
|
274
|
-
/* @__PURE__ */ jsx("h2", {
|
|
275
|
-
className: "font-bold text-2xl",
|
|
276
|
-
children: "Configuration flow"
|
|
277
|
-
}),
|
|
278
|
-
/* @__PURE__ */ jsx("p", {
|
|
279
|
-
className: "text-muted-foreground",
|
|
280
|
-
children: "Here's how configuration flows from definition to runtime:"
|
|
281
|
-
}),
|
|
282
|
-
/* @__PURE__ */ jsxs("ol", {
|
|
283
|
-
className: "list-inside list-decimal space-y-3 text-muted-foreground",
|
|
284
|
-
children: [
|
|
285
|
-
/* @__PURE__ */ jsxs("li", {
|
|
286
|
-
children: [
|
|
287
|
-
/* @__PURE__ */ jsx("strong", {
|
|
288
|
-
children: "Development"
|
|
289
|
-
}),
|
|
290
|
-
" - Define AppBlueprintSpec with required integrations and knowledge spaces"
|
|
291
|
-
]
|
|
292
|
-
}),
|
|
293
|
-
/* @__PURE__ */ jsxs("li", {
|
|
294
|
-
children: [
|
|
295
|
-
/* @__PURE__ */ jsx("strong", {
|
|
296
|
-
children: "Deployment"
|
|
297
|
-
}),
|
|
298
|
-
" - Deploy blueprint to environment (sandbox, staging, production)"
|
|
299
|
-
]
|
|
300
|
-
}),
|
|
301
|
-
/* @__PURE__ */ jsxs("li", {
|
|
302
|
-
children: [
|
|
303
|
-
/* @__PURE__ */ jsx("strong", {
|
|
304
|
-
children: "Tenant Setup"
|
|
305
|
-
}),
|
|
306
|
-
" - Create TenantAppConfig with specific integration connections and knowledge sources"
|
|
307
|
-
]
|
|
308
|
-
}),
|
|
309
|
-
/* @__PURE__ */ jsxs("li", {
|
|
310
|
-
children: [
|
|
311
|
-
/* @__PURE__ */ jsx("strong", {
|
|
312
|
-
children: "Runtime"
|
|
313
|
-
}),
|
|
314
|
-
" - Resolve configuration on-demand when tenant accesses the app"
|
|
315
|
-
]
|
|
316
|
-
}),
|
|
317
|
-
/* @__PURE__ */ jsxs("li", {
|
|
318
|
-
children: [
|
|
319
|
-
/* @__PURE__ */ jsx("strong", {
|
|
320
|
-
children: "Execution"
|
|
321
|
-
}),
|
|
322
|
-
" - Use ResolvedAppConfig to execute capabilities, workflows, and enforce policies"
|
|
323
|
-
]
|
|
324
|
-
})
|
|
325
|
-
]
|
|
326
|
-
})
|
|
327
|
-
]
|
|
328
|
-
}),
|
|
329
|
-
/* @__PURE__ */ jsxs("div", {
|
|
330
|
-
className: "space-y-4",
|
|
331
|
-
children: [
|
|
332
|
-
/* @__PURE__ */ jsx("h2", {
|
|
333
|
-
className: "font-bold text-2xl",
|
|
334
|
-
children: "Best practices"
|
|
335
|
-
}),
|
|
336
|
-
/* @__PURE__ */ jsxs("ul", {
|
|
337
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
338
|
-
children: [
|
|
339
|
-
/* @__PURE__ */ jsx("li", {
|
|
340
|
-
children: "Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data"
|
|
341
|
-
}),
|
|
342
|
-
/* @__PURE__ */ jsx("li", {
|
|
343
|
-
children: "Use TenantAppConfig for all tenant-specific settings and connections"
|
|
344
|
-
}),
|
|
345
|
-
/* @__PURE__ */ jsx("li", {
|
|
346
|
-
children: "Cache ResolvedAppConfig per request to avoid repeated resolution"
|
|
347
|
-
}),
|
|
348
|
-
/* @__PURE__ */ jsx("li", {
|
|
349
|
-
children: "Version blueprints carefully - migrations affect all tenants"
|
|
350
|
-
}),
|
|
351
|
-
/* @__PURE__ */ jsx("li", {
|
|
352
|
-
children: "Test blueprint changes in sandbox before promoting to production"
|
|
353
|
-
})
|
|
354
|
-
]
|
|
355
|
-
})
|
|
356
|
-
]
|
|
357
|
-
}),
|
|
358
|
-
/* @__PURE__ */ jsxs("div", {
|
|
359
|
-
className: "flex items-center gap-4 pt-4",
|
|
360
|
-
children: [
|
|
361
|
-
/* @__PURE__ */ jsx(Link, {
|
|
362
|
-
href: "/docs/architecture",
|
|
363
|
-
className: "btn-ghost",
|
|
364
|
-
children: "Back to Architecture"
|
|
365
|
-
}),
|
|
366
|
-
/* @__PURE__ */ jsxs(Link, {
|
|
367
|
-
href: "/docs/architecture/integration-binding",
|
|
368
|
-
className: "btn-primary",
|
|
369
|
-
children: [
|
|
370
|
-
"Integration Binding ",
|
|
371
|
-
/* @__PURE__ */ jsx(ChevronRight, {
|
|
372
|
-
size: 16
|
|
373
|
-
})
|
|
374
|
-
]
|
|
375
|
-
})
|
|
376
|
-
]
|
|
377
|
-
})
|
|
378
|
-
]
|
|
379
|
-
});
|
|
380
|
-
}
|
|
381
|
-
|
|
382
|
-
// src/components/docs/architecture/ArchitectureControlPlanePage.tsx
|
|
383
|
-
import { CodeBlock as CodeBlock2 } from "@contractspec/lib.design-system";
|
|
384
|
-
import Link2 from "@contractspec/lib.ui-link";
|
|
385
|
-
import { ChevronRight as ChevronRight2 } from "lucide-react";
|
|
386
|
-
import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
|
|
387
|
-
function ArchitectureControlPlanePage() {
|
|
388
|
-
return /* @__PURE__ */ jsxs2("div", {
|
|
389
|
-
className: "space-y-8",
|
|
390
|
-
children: [
|
|
391
|
-
/* @__PURE__ */ jsxs2("div", {
|
|
392
|
-
className: "space-y-4",
|
|
393
|
-
children: [
|
|
394
|
-
/* @__PURE__ */ jsx2("h1", {
|
|
395
|
-
className: "font-bold text-4xl",
|
|
396
|
-
children: "Control Plane Runtime"
|
|
397
|
-
}),
|
|
398
|
-
/* @__PURE__ */ jsx2("p", {
|
|
399
|
-
className: "text-muted-foreground",
|
|
400
|
-
children: "The control plane is the governance layer for agentic execution. It turns incoming intent into deterministic plans, enforces risk policy before side effects, and records replayable traces for audits."
|
|
401
|
-
})
|
|
402
|
-
]
|
|
403
|
-
}),
|
|
404
|
-
/* @__PURE__ */ jsxs2("div", {
|
|
405
|
-
className: "space-y-4",
|
|
406
|
-
children: [
|
|
407
|
-
/* @__PURE__ */ jsx2("h2", {
|
|
408
|
-
className: "font-bold text-2xl",
|
|
409
|
-
children: "Canonical execution loop"
|
|
410
|
-
}),
|
|
411
|
-
/* @__PURE__ */ jsxs2("ol", {
|
|
412
|
-
className: "list-inside list-decimal space-y-2 text-muted-foreground",
|
|
413
|
-
children: [
|
|
414
|
-
/* @__PURE__ */ jsx2("li", {
|
|
415
|
-
children: "Accept intent and create execution identity + trace context."
|
|
416
|
-
}),
|
|
417
|
-
/* @__PURE__ */ jsx2("li", {
|
|
418
|
-
children: "Compile intent into a typed, deterministic plan DAG."
|
|
419
|
-
}),
|
|
420
|
-
/* @__PURE__ */ jsx2("li", {
|
|
421
|
-
children: "Verify plan against policy and risk rules."
|
|
422
|
-
}),
|
|
423
|
-
/* @__PURE__ */ jsx2("li", {
|
|
424
|
-
children: "Route into autonomous or assist mode based on verdict."
|
|
425
|
-
}),
|
|
426
|
-
/* @__PURE__ */ jsx2("li", {
|
|
427
|
-
children: "Execute steps with idempotent keys and explicit stage events."
|
|
428
|
-
}),
|
|
429
|
-
/* @__PURE__ */ jsx2("li", {
|
|
430
|
-
children: "Persist outcomes for replay, audits, and operator visibility."
|
|
431
|
-
})
|
|
432
|
-
]
|
|
433
|
-
})
|
|
434
|
-
]
|
|
435
|
-
}),
|
|
436
|
-
/* @__PURE__ */ jsxs2("div", {
|
|
437
|
-
className: "space-y-4",
|
|
438
|
-
children: [
|
|
439
|
-
/* @__PURE__ */ jsx2("h2", {
|
|
440
|
-
className: "font-bold text-2xl",
|
|
441
|
-
children: "Contract surfaces (v1 baseline)"
|
|
442
|
-
}),
|
|
443
|
-
/* @__PURE__ */ jsxs2("p", {
|
|
444
|
-
className: "text-muted-foreground",
|
|
445
|
-
children: [
|
|
446
|
-
"The runtime is contract-first. Commands, queries, events, and capabilities are explicit and versioned under",
|
|
447
|
-
/* @__PURE__ */ jsx2("code", {
|
|
448
|
-
children: " @contractspec/lib.contracts-spec"
|
|
449
|
-
}),
|
|
450
|
-
"."
|
|
451
|
-
]
|
|
452
|
-
}),
|
|
453
|
-
/* @__PURE__ */ jsx2(CodeBlock2, {
|
|
454
|
-
language: "text",
|
|
455
|
-
code: `Commands
|
|
146
|
+
};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"Configuration flow"}),n("p",{className:"text-muted-foreground",children:"Here's how configuration flows from definition to runtime:"}),r("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[r("li",{children:[n("strong",{children:"Development"})," - Define AppBlueprintSpec with required integrations and knowledge spaces"]}),r("li",{children:[n("strong",{children:"Deployment"})," - Deploy blueprint to environment (sandbox, staging, production)"]}),r("li",{children:[n("strong",{children:"Tenant Setup"})," - Create TenantAppConfig with specific integration connections and knowledge sources"]}),r("li",{children:[n("strong",{children:"Runtime"})," - Resolve configuration on-demand when tenant accesses the app"]}),r("li",{children:[n("strong",{children:"Execution"})," - Use ResolvedAppConfig to execute capabilities, workflows, and enforce policies"]})]})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"Best practices"}),r("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[n("li",{children:"Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data"}),n("li",{children:"Use TenantAppConfig for all tenant-specific settings and connections"}),n("li",{children:"Cache ResolvedAppConfig per request to avoid repeated resolution"}),n("li",{children:"Version blueprints carefully - migrations affect all tenants"}),n("li",{children:"Test blueprint changes in sandbox before promoting to production"})]})]}),r("div",{className:"flex items-center gap-4 pt-4",children:[n(b,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),r(b,{href:"/docs/architecture/integration-binding",className:"btn-primary",children:["Integration Binding ",n(C,{size:16})]})]})]})}import{CodeBlock as v}from"@contractspec/lib.design-system";import h from"@contractspec/lib.ui-link";import{ChevronRight as A}from"lucide-react";import{jsx as o,jsxs as p}from"react/jsx-runtime";function S(){return p("div",{className:"space-y-8",children:[p("div",{className:"space-y-4",children:[o("h1",{className:"font-bold text-4xl",children:"Control Plane Runtime"}),o("p",{className:"text-muted-foreground",children:"The control plane is the governance layer for agentic execution. It turns incoming intent into deterministic plans, enforces risk policy before side effects, and records replayable traces for audits."})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Canonical execution loop"}),p("ol",{className:"list-inside list-decimal space-y-2 text-muted-foreground",children:[o("li",{children:"Accept intent and create execution identity + trace context."}),o("li",{children:"Compile intent into a typed, deterministic plan DAG."}),o("li",{children:"Verify plan against policy and risk rules."}),o("li",{children:"Route into autonomous or assist mode based on verdict."}),o("li",{children:"Execute steps with idempotent keys and explicit stage events."}),o("li",{children:"Persist outcomes for replay, audits, and operator visibility."})]})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Contract surfaces (v1 baseline)"}),p("p",{className:"text-muted-foreground",children:["The runtime is contract-first. Commands, queries, events, and capabilities are explicit and versioned under",o("code",{children:" @contractspec/lib.contracts-spec"}),"."]}),o(v,{language:"text",code:`Commands
|
|
456
147
|
- controlPlane.intent.submit
|
|
457
148
|
- controlPlane.plan.compile
|
|
458
149
|
- controlPlane.plan.verify
|
|
@@ -488,49 +179,7 @@ Capabilities
|
|
|
488
179
|
- control-plane.approval
|
|
489
180
|
- control-plane.audit
|
|
490
181
|
- control-plane.skill-registry
|
|
491
|
-
- control-plane.channel-runtime`
|
|
492
|
-
})
|
|
493
|
-
]
|
|
494
|
-
}),
|
|
495
|
-
/* @__PURE__ */ jsxs2("div", {
|
|
496
|
-
className: "space-y-4",
|
|
497
|
-
children: [
|
|
498
|
-
/* @__PURE__ */ jsx2("h2", {
|
|
499
|
-
className: "font-bold text-2xl",
|
|
500
|
-
children: "Policy and safety posture"
|
|
501
|
-
}),
|
|
502
|
-
/* @__PURE__ */ jsxs2("ul", {
|
|
503
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
504
|
-
children: [
|
|
505
|
-
/* @__PURE__ */ jsx2("li", {
|
|
506
|
-
children: "No side-effect action executes unless it comes from a compiled plan."
|
|
507
|
-
}),
|
|
508
|
-
/* @__PURE__ */ jsx2("li", {
|
|
509
|
-
children: "High-risk actions are blocked from autonomous mode in v1."
|
|
510
|
-
}),
|
|
511
|
-
/* @__PURE__ */ jsx2("li", {
|
|
512
|
-
children: "Approval commands provide explicit human-in-the-loop transitions."
|
|
513
|
-
}),
|
|
514
|
-
/* @__PURE__ */ jsx2("li", {
|
|
515
|
-
children: "Skill installation is modeled as governance-controlled operations."
|
|
516
|
-
}),
|
|
517
|
-
/* @__PURE__ */ jsx2("li", {
|
|
518
|
-
children: "Trace queries expose policy rationale and step outcomes for replay."
|
|
519
|
-
})
|
|
520
|
-
]
|
|
521
|
-
})
|
|
522
|
-
]
|
|
523
|
-
}),
|
|
524
|
-
/* @__PURE__ */ jsxs2("div", {
|
|
525
|
-
className: "space-y-4",
|
|
526
|
-
children: [
|
|
527
|
-
/* @__PURE__ */ jsx2("h2", {
|
|
528
|
-
className: "font-bold text-2xl",
|
|
529
|
-
children: "Implementation map"
|
|
530
|
-
}),
|
|
531
|
-
/* @__PURE__ */ jsx2(CodeBlock2, {
|
|
532
|
-
language: "text",
|
|
533
|
-
code: `packages/libs/contracts-spec/src/control-plane/
|
|
182
|
+
- control-plane.channel-runtime`})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Policy and safety posture"}),p("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[o("li",{children:"No side-effect action executes unless it comes from a compiled plan."}),o("li",{children:"High-risk actions are blocked from autonomous mode in v1."}),o("li",{children:"Approval commands provide explicit human-in-the-loop transitions."}),o("li",{children:"Skill installation is modeled as governance-controlled operations."}),o("li",{children:"Trace queries expose policy rationale and step outcomes for replay."})]})]}),p("section",{className:"editorial-panel space-y-4",children:[o("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Apply the runtime locally with Connect"}),o("p",{className:"text-muted-foreground text-sm leading-7",children:"The control plane defines the governance contracts. Connect is the local adapter that turns those contracts into task-scoped context, plan, verification, review, and replay flows for coding agents."}),p("div",{className:"flex flex-wrap gap-3",children:[o(h,{href:"/docs/specs/connect",className:"btn-primary",children:"Connect spec"}),o(h,{href:"/docs/guides/connect-in-a-repo",className:"btn-ghost",children:"Use Connect in a repo"})]})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Implementation map"}),o(v,{language:"text",code:`packages/libs/contracts-spec/src/control-plane/
|
|
534
183
|
commands/
|
|
535
184
|
queries/
|
|
536
185
|
events/
|
|
@@ -539,132 +188,7 @@ Capabilities
|
|
|
539
188
|
contracts.test.ts
|
|
540
189
|
|
|
541
190
|
packages/apps/web-landing/src/app/docs/architecture/control-plane/page.tsx
|
|
542
|
-
implementation_plan_controle_plane.md`
|
|
543
|
-
})
|
|
544
|
-
]
|
|
545
|
-
}),
|
|
546
|
-
/* @__PURE__ */ jsxs2("div", {
|
|
547
|
-
className: "space-y-4",
|
|
548
|
-
children: [
|
|
549
|
-
/* @__PURE__ */ jsx2("h2", {
|
|
550
|
-
className: "font-bold text-2xl",
|
|
551
|
-
children: "What comes next"
|
|
552
|
-
}),
|
|
553
|
-
/* @__PURE__ */ jsx2("p", {
|
|
554
|
-
className: "text-muted-foreground",
|
|
555
|
-
children: "WS1 delivers the contract fabric. Next increments add planner/executor split, policy escalation, capability-bound authorization, signed skill compatibility checks, and full replay tooling."
|
|
556
|
-
})
|
|
557
|
-
]
|
|
558
|
-
}),
|
|
559
|
-
/* @__PURE__ */ jsxs2("div", {
|
|
560
|
-
className: "flex items-center gap-4 pt-4",
|
|
561
|
-
children: [
|
|
562
|
-
/* @__PURE__ */ jsx2(Link2, {
|
|
563
|
-
href: "/docs/architecture/integration-binding",
|
|
564
|
-
className: "btn-ghost",
|
|
565
|
-
children: "Previous: Integration Binding"
|
|
566
|
-
}),
|
|
567
|
-
/* @__PURE__ */ jsxs2(Link2, {
|
|
568
|
-
href: "/docs/safety/auditing",
|
|
569
|
-
className: "btn-primary",
|
|
570
|
-
children: [
|
|
571
|
-
"Audit Logs ",
|
|
572
|
-
/* @__PURE__ */ jsx2(ChevronRight2, {
|
|
573
|
-
size: 16
|
|
574
|
-
})
|
|
575
|
-
]
|
|
576
|
-
})
|
|
577
|
-
]
|
|
578
|
-
})
|
|
579
|
-
]
|
|
580
|
-
});
|
|
581
|
-
}
|
|
582
|
-
|
|
583
|
-
// src/components/docs/architecture/ArchitectureIntegrationBindingPage.tsx
|
|
584
|
-
import { CodeBlock as CodeBlock3 } from "@contractspec/lib.design-system";
|
|
585
|
-
import Link3 from "@contractspec/lib.ui-link";
|
|
586
|
-
import { ChevronRight as ChevronRight3 } from "lucide-react";
|
|
587
|
-
import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
|
|
588
|
-
function ArchitectureIntegrationBindingPage() {
|
|
589
|
-
return /* @__PURE__ */ jsxs3("div", {
|
|
590
|
-
className: "space-y-8",
|
|
591
|
-
children: [
|
|
592
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
593
|
-
className: "space-y-4",
|
|
594
|
-
children: [
|
|
595
|
-
/* @__PURE__ */ jsx3("h1", {
|
|
596
|
-
className: "font-bold text-4xl",
|
|
597
|
-
children: "Integration Binding"
|
|
598
|
-
}),
|
|
599
|
-
/* @__PURE__ */ jsx3("p", {
|
|
600
|
-
className: "text-muted-foreground",
|
|
601
|
-
children: "Integration binding connects your app's capabilities to external service providers. Each tenant can configure their own integration connections while sharing the same app blueprint."
|
|
602
|
-
})
|
|
603
|
-
]
|
|
604
|
-
}),
|
|
605
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
606
|
-
className: "space-y-4",
|
|
607
|
-
children: [
|
|
608
|
-
/* @__PURE__ */ jsx3("h2", {
|
|
609
|
-
className: "font-bold text-2xl",
|
|
610
|
-
children: "How it works"
|
|
611
|
-
}),
|
|
612
|
-
/* @__PURE__ */ jsx3("p", {
|
|
613
|
-
className: "text-muted-foreground",
|
|
614
|
-
children: "Integration binding follows a three-layer model:"
|
|
615
|
-
}),
|
|
616
|
-
/* @__PURE__ */ jsxs3("ol", {
|
|
617
|
-
className: "list-inside list-decimal space-y-3 text-muted-foreground",
|
|
618
|
-
children: [
|
|
619
|
-
/* @__PURE__ */ jsxs3("li", {
|
|
620
|
-
children: [
|
|
621
|
-
/* @__PURE__ */ jsx3("strong", {
|
|
622
|
-
children: "IntegrationSpec"
|
|
623
|
-
}),
|
|
624
|
-
" (global) - Defines what an integration provides"
|
|
625
|
-
]
|
|
626
|
-
}),
|
|
627
|
-
/* @__PURE__ */ jsxs3("li", {
|
|
628
|
-
children: [
|
|
629
|
-
/* @__PURE__ */ jsx3("strong", {
|
|
630
|
-
children: "IntegrationConnection"
|
|
631
|
-
}),
|
|
632
|
-
" (per-tenant) - A tenant's configured connection"
|
|
633
|
-
]
|
|
634
|
-
}),
|
|
635
|
-
/* @__PURE__ */ jsxs3("li", {
|
|
636
|
-
children: [
|
|
637
|
-
/* @__PURE__ */ jsx3("strong", {
|
|
638
|
-
children: "AppIntegrationBinding"
|
|
639
|
-
}),
|
|
640
|
-
" (per-app) - Maps named slots to concrete tenant connections"
|
|
641
|
-
]
|
|
642
|
-
})
|
|
643
|
-
]
|
|
644
|
-
})
|
|
645
|
-
]
|
|
646
|
-
}),
|
|
647
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
648
|
-
className: "space-y-4",
|
|
649
|
-
children: [
|
|
650
|
-
/* @__PURE__ */ jsx3("h2", {
|
|
651
|
-
className: "font-bold text-2xl",
|
|
652
|
-
children: "Example: Payment processing"
|
|
653
|
-
}),
|
|
654
|
-
/* @__PURE__ */ jsx3("p", {
|
|
655
|
-
className: "text-muted-foreground",
|
|
656
|
-
children: "Let's walk through a complete example of binding Stripe for payments."
|
|
657
|
-
}),
|
|
658
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
659
|
-
className: "space-y-3",
|
|
660
|
-
children: [
|
|
661
|
-
/* @__PURE__ */ jsx3("h3", {
|
|
662
|
-
className: "font-semibold text-lg",
|
|
663
|
-
children: "Step 1: Blueprint declares requirement"
|
|
664
|
-
}),
|
|
665
|
-
/* @__PURE__ */ jsx3(CodeBlock3, {
|
|
666
|
-
language: "typescript",
|
|
667
|
-
code: `// AppBlueprintSpec
|
|
191
|
+
implementation_plan_controle_plane.md`})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"What comes next"}),o("p",{className:"text-muted-foreground",children:"WS1 delivers the contract fabric. Next increments add planner/executor split, policy escalation, capability-bound authorization, signed skill compatibility checks, and full replay tooling."})]}),p("div",{className:"flex items-center gap-4 pt-4",children:[o(h,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),p(h,{href:"/docs/safety/auditing",className:"btn-primary",children:["Audit Logs ",o(A,{size:16})]})]})]})}import{CodeBlock as m}from"@contractspec/lib.design-system";import w from"@contractspec/lib.ui-link";import{ChevronRight as P}from"lucide-react";import{jsx as t,jsxs as s}from"react/jsx-runtime";function _(){return s("div",{className:"space-y-8",children:[s("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Integration Binding"}),t("p",{className:"text-muted-foreground",children:"Integration binding connects your app's capabilities to external service providers. Each tenant can configure their own integration connections while sharing the same app blueprint."})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"How it works"}),t("p",{className:"text-muted-foreground",children:"Integration binding follows a three-layer model:"}),s("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[s("li",{children:[t("strong",{children:"IntegrationSpec"})," (global) - Defines what an integration provides"]}),s("li",{children:[t("strong",{children:"IntegrationConnection"})," (per-tenant) - A tenant's configured connection"]}),s("li",{children:[t("strong",{children:"AppIntegrationBinding"})," (per-app) - Maps named slots to concrete tenant connections"]})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Example: Payment processing"}),t("p",{className:"text-muted-foreground",children:"Let's walk through a complete example of binding Stripe for payments."}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares requirement"}),t(m,{language:"typescript",code:`// AppBlueprintSpec
|
|
668
192
|
{
|
|
669
193
|
meta: { name: "invoice-app", version: '1.0.0', appId: "invoice" },
|
|
670
194
|
integrationSlots: [
|
|
@@ -688,20 +212,7 @@ function ArchitectureIntegrationBindingPage() {
|
|
|
688
212
|
assets: [{ type: "logo", url: "https://cdn.acme.dev/logo.png" }],
|
|
689
213
|
colorTokens: { primary: "colors.brand.primary" }
|
|
690
214
|
}
|
|
691
|
-
}`
|
|
692
|
-
})
|
|
693
|
-
]
|
|
694
|
-
}),
|
|
695
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
696
|
-
className: "space-y-3",
|
|
697
|
-
children: [
|
|
698
|
-
/* @__PURE__ */ jsx3("h3", {
|
|
699
|
-
className: "font-semibold text-lg",
|
|
700
|
-
children: "Step 2: Tenant creates connection"
|
|
701
|
-
}),
|
|
702
|
-
/* @__PURE__ */ jsx3(CodeBlock3, {
|
|
703
|
-
language: "typescript",
|
|
704
|
-
code: `// IntegrationConnection
|
|
215
|
+
}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant creates connection"}),t(m,{language:"typescript",code:`// IntegrationConnection
|
|
705
216
|
{
|
|
706
217
|
meta: {
|
|
707
218
|
id: "conn_stripe_acme_prod",
|
|
@@ -721,20 +232,7 @@ function ArchitectureIntegrationBindingPage() {
|
|
|
721
232
|
},
|
|
722
233
|
secretRef: "vault://integrations/acme/conn_stripe_acme_prod",
|
|
723
234
|
status: "active"
|
|
724
|
-
}`
|
|
725
|
-
})
|
|
726
|
-
]
|
|
727
|
-
}),
|
|
728
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
729
|
-
className: "space-y-3",
|
|
730
|
-
children: [
|
|
731
|
-
/* @__PURE__ */ jsx3("h3", {
|
|
732
|
-
className: "font-semibold text-lg",
|
|
733
|
-
children: "Step 3: TenantAppConfig binds connection"
|
|
734
|
-
}),
|
|
735
|
-
/* @__PURE__ */ jsx3(CodeBlock3, {
|
|
736
|
-
language: "typescript",
|
|
737
|
-
code: `// TenantAppConfig
|
|
235
|
+
}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds connection"}),t(m,{language:"typescript",code:`// TenantAppConfig
|
|
738
236
|
{
|
|
739
237
|
meta: {
|
|
740
238
|
tenantId: "acme-corp",
|
|
@@ -760,20 +258,7 @@ function ArchitectureIntegrationBindingPage() {
|
|
|
760
258
|
customDomain: "billing.acme.com",
|
|
761
259
|
assets: [{ type: "logo", url: "https://assets.acme.com/logo.svg" }]
|
|
762
260
|
}
|
|
763
|
-
}`
|
|
764
|
-
})
|
|
765
|
-
]
|
|
766
|
-
}),
|
|
767
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
768
|
-
className: "space-y-3",
|
|
769
|
-
children: [
|
|
770
|
-
/* @__PURE__ */ jsx3("h3", {
|
|
771
|
-
className: "font-semibold text-lg",
|
|
772
|
-
children: "Step 4: Runtime resolves and executes"
|
|
773
|
-
}),
|
|
774
|
-
/* @__PURE__ */ jsx3(CodeBlock3, {
|
|
775
|
-
language: "typescript",
|
|
776
|
-
code: `// ResolvedAppConfig (runtime)
|
|
261
|
+
}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 4: Runtime resolves and executes"}),t(m,{language:"typescript",code:`// ResolvedAppConfig (runtime)
|
|
777
262
|
{
|
|
778
263
|
integrations: {
|
|
779
264
|
"payments.createPaymentIntent": {
|
|
@@ -790,26 +275,7 @@ const result = await executeCapability(
|
|
|
790
275
|
{ amount: 5000, currency: "usd" },
|
|
791
276
|
resolvedConfig
|
|
792
277
|
);
|
|
793
|
-
// → Uses Stripe connection automatically`
|
|
794
|
-
})
|
|
795
|
-
]
|
|
796
|
-
})
|
|
797
|
-
]
|
|
798
|
-
}),
|
|
799
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
800
|
-
className: "space-y-4",
|
|
801
|
-
children: [
|
|
802
|
-
/* @__PURE__ */ jsx3("h2", {
|
|
803
|
-
className: "font-bold text-2xl",
|
|
804
|
-
children: "Multi-integration scenarios"
|
|
805
|
-
}),
|
|
806
|
-
/* @__PURE__ */ jsx3("p", {
|
|
807
|
-
className: "text-muted-foreground",
|
|
808
|
-
children: "A single app can use multiple integrations across different categories:"
|
|
809
|
-
}),
|
|
810
|
-
/* @__PURE__ */ jsx3(CodeBlock3, {
|
|
811
|
-
language: "typescript",
|
|
812
|
-
code: `integrations: [
|
|
278
|
+
// → Uses Stripe connection automatically`})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Multi-integration scenarios"}),t("p",{className:"text-muted-foreground",children:"A single app can use multiple integrations across different categories:"}),t(m,{language:"typescript",code:`integrations: [
|
|
813
279
|
{
|
|
814
280
|
slotId: "payments.primary",
|
|
815
281
|
connectionId: "conn_stripe_prod",
|
|
@@ -835,24 +301,7 @@ const result = await executeCapability(
|
|
|
835
301
|
workflows: ["semantic-search", "rag-query"]
|
|
836
302
|
}
|
|
837
303
|
}
|
|
838
|
-
]`
|
|
839
|
-
})
|
|
840
|
-
]
|
|
841
|
-
}),
|
|
842
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
843
|
-
className: "space-y-4",
|
|
844
|
-
children: [
|
|
845
|
-
/* @__PURE__ */ jsx3("h2", {
|
|
846
|
-
className: "font-bold text-2xl",
|
|
847
|
-
children: "Sandbox vs Production"
|
|
848
|
-
}),
|
|
849
|
-
/* @__PURE__ */ jsx3("p", {
|
|
850
|
-
className: "text-muted-foreground",
|
|
851
|
-
children: "Tenants typically maintain separate connections for sandbox and production environments:"
|
|
852
|
-
}),
|
|
853
|
-
/* @__PURE__ */ jsx3(CodeBlock3, {
|
|
854
|
-
language: "typescript",
|
|
855
|
-
code: `// Sandbox environment
|
|
304
|
+
]`})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Sandbox vs Production"}),t("p",{className:"text-muted-foreground",children:"Tenants typically maintain separate connections for sandbox and production environments:"}),t(m,{language:"typescript",code:`// Sandbox environment
|
|
856
305
|
{
|
|
857
306
|
meta: { environment: "sandbox", status: "preview" },
|
|
858
307
|
integrations: [
|
|
@@ -872,183 +321,7 @@ const result = await executeCapability(
|
|
|
872
321
|
connectionId: "conn_stripe_acme_prod"
|
|
873
322
|
}
|
|
874
323
|
]
|
|
875
|
-
}`
|
|
876
|
-
})
|
|
877
|
-
]
|
|
878
|
-
}),
|
|
879
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
880
|
-
className: "space-y-4",
|
|
881
|
-
children: [
|
|
882
|
-
/* @__PURE__ */ jsx3("h2", {
|
|
883
|
-
className: "font-bold text-2xl",
|
|
884
|
-
children: "Security & validation"
|
|
885
|
-
}),
|
|
886
|
-
/* @__PURE__ */ jsxs3("ul", {
|
|
887
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
888
|
-
children: [
|
|
889
|
-
/* @__PURE__ */ jsx3("li", {
|
|
890
|
-
children: "Integration connections are validated before binding - health checks ensure connectivity"
|
|
891
|
-
}),
|
|
892
|
-
/* @__PURE__ */ jsx3("li", {
|
|
893
|
-
children: "Secrets are never stored in TenantAppConfig - only references to encrypted secrets"
|
|
894
|
-
}),
|
|
895
|
-
/* @__PURE__ */ jsx3("li", {
|
|
896
|
-
children: "Policy Decision Point (PDP) enforces which workflows can use which integrations"
|
|
897
|
-
}),
|
|
898
|
-
/* @__PURE__ */ jsx3("li", {
|
|
899
|
-
children: "All integration calls are audited with full request/response logging"
|
|
900
|
-
}),
|
|
901
|
-
/* @__PURE__ */ jsx3("li", {
|
|
902
|
-
children: "Rate limiting and quotas are enforced per connection"
|
|
903
|
-
})
|
|
904
|
-
]
|
|
905
|
-
})
|
|
906
|
-
]
|
|
907
|
-
}),
|
|
908
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
909
|
-
className: "space-y-4",
|
|
910
|
-
children: [
|
|
911
|
-
/* @__PURE__ */ jsx3("h2", {
|
|
912
|
-
className: "font-bold text-2xl",
|
|
913
|
-
children: "Best practices"
|
|
914
|
-
}),
|
|
915
|
-
/* @__PURE__ */ jsxs3("ul", {
|
|
916
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
917
|
-
children: [
|
|
918
|
-
/* @__PURE__ */ jsxs3("li", {
|
|
919
|
-
children: [
|
|
920
|
-
"Use wildcard patterns sparingly in ",
|
|
921
|
-
/* @__PURE__ */ jsx3("code", {
|
|
922
|
-
children: "allowedWorkflows"
|
|
923
|
-
}),
|
|
924
|
-
" - be explicit about access"
|
|
925
|
-
]
|
|
926
|
-
}),
|
|
927
|
-
/* @__PURE__ */ jsx3("li", {
|
|
928
|
-
children: "Always maintain separate sandbox and production connections"
|
|
929
|
-
}),
|
|
930
|
-
/* @__PURE__ */ jsx3("li", {
|
|
931
|
-
children: "Monitor integration health checks and set up alerts for failures"
|
|
932
|
-
}),
|
|
933
|
-
/* @__PURE__ */ jsx3("li", {
|
|
934
|
-
children: "Document the purpose of each integration binding for your team"
|
|
935
|
-
}),
|
|
936
|
-
/* @__PURE__ */ jsx3("li", {
|
|
937
|
-
children: "Test integration changes in sandbox before promoting to production"
|
|
938
|
-
})
|
|
939
|
-
]
|
|
940
|
-
})
|
|
941
|
-
]
|
|
942
|
-
}),
|
|
943
|
-
/* @__PURE__ */ jsxs3("div", {
|
|
944
|
-
className: "flex items-center gap-4 pt-4",
|
|
945
|
-
children: [
|
|
946
|
-
/* @__PURE__ */ jsx3(Link3, {
|
|
947
|
-
href: "/docs/architecture/app-config",
|
|
948
|
-
className: "btn-ghost",
|
|
949
|
-
children: "Previous: App Configuration"
|
|
950
|
-
}),
|
|
951
|
-
/* @__PURE__ */ jsxs3(Link3, {
|
|
952
|
-
href: "/docs/architecture/knowledge-binding",
|
|
953
|
-
className: "btn-primary",
|
|
954
|
-
children: [
|
|
955
|
-
"Knowledge Binding ",
|
|
956
|
-
/* @__PURE__ */ jsx3(ChevronRight3, {
|
|
957
|
-
size: 16
|
|
958
|
-
})
|
|
959
|
-
]
|
|
960
|
-
})
|
|
961
|
-
]
|
|
962
|
-
})
|
|
963
|
-
]
|
|
964
|
-
});
|
|
965
|
-
}
|
|
966
|
-
|
|
967
|
-
// src/components/docs/architecture/ArchitectureKnowledgeBindingPage.tsx
|
|
968
|
-
import { CodeBlock as CodeBlock4 } from "@contractspec/lib.design-system";
|
|
969
|
-
import Link4 from "@contractspec/lib.ui-link";
|
|
970
|
-
import { ChevronRight as ChevronRight4 } from "lucide-react";
|
|
971
|
-
import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
|
|
972
|
-
function ArchitectureKnowledgeBindingPage() {
|
|
973
|
-
return /* @__PURE__ */ jsxs4("div", {
|
|
974
|
-
className: "space-y-8",
|
|
975
|
-
children: [
|
|
976
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
977
|
-
className: "space-y-4",
|
|
978
|
-
children: [
|
|
979
|
-
/* @__PURE__ */ jsx4("h1", {
|
|
980
|
-
className: "font-bold text-4xl",
|
|
981
|
-
children: "Knowledge Binding"
|
|
982
|
-
}),
|
|
983
|
-
/* @__PURE__ */ jsx4("p", {
|
|
984
|
-
className: "text-muted-foreground",
|
|
985
|
-
children: "Knowledge binding connects your app's workflows and agents to structured knowledge spaces. This enables semantic search, RAG (Retrieval-Augmented Generation), and context-aware decision-making."
|
|
986
|
-
})
|
|
987
|
-
]
|
|
988
|
-
}),
|
|
989
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
990
|
-
className: "space-y-4",
|
|
991
|
-
children: [
|
|
992
|
-
/* @__PURE__ */ jsx4("h2", {
|
|
993
|
-
className: "font-bold text-2xl",
|
|
994
|
-
children: "How it works"
|
|
995
|
-
}),
|
|
996
|
-
/* @__PURE__ */ jsx4("p", {
|
|
997
|
-
className: "text-muted-foreground",
|
|
998
|
-
children: "Knowledge binding follows a three-layer model:"
|
|
999
|
-
}),
|
|
1000
|
-
/* @__PURE__ */ jsxs4("ol", {
|
|
1001
|
-
className: "list-inside list-decimal space-y-3 text-muted-foreground",
|
|
1002
|
-
children: [
|
|
1003
|
-
/* @__PURE__ */ jsxs4("li", {
|
|
1004
|
-
children: [
|
|
1005
|
-
/* @__PURE__ */ jsx4("strong", {
|
|
1006
|
-
children: "KnowledgeSpaceSpec"
|
|
1007
|
-
}),
|
|
1008
|
-
" (global) - Defines a logical knowledge domain"
|
|
1009
|
-
]
|
|
1010
|
-
}),
|
|
1011
|
-
/* @__PURE__ */ jsxs4("li", {
|
|
1012
|
-
children: [
|
|
1013
|
-
/* @__PURE__ */ jsx4("strong", {
|
|
1014
|
-
children: "KnowledgeSourceConfig"
|
|
1015
|
-
}),
|
|
1016
|
-
" (per-tenant) - Tenant's data sources feeding spaces"
|
|
1017
|
-
]
|
|
1018
|
-
}),
|
|
1019
|
-
/* @__PURE__ */ jsxs4("li", {
|
|
1020
|
-
children: [
|
|
1021
|
-
/* @__PURE__ */ jsx4("strong", {
|
|
1022
|
-
children: "AppKnowledgeBinding"
|
|
1023
|
-
}),
|
|
1024
|
-
" (per-app) - Maps spaces to workflows/agents"
|
|
1025
|
-
]
|
|
1026
|
-
})
|
|
1027
|
-
]
|
|
1028
|
-
})
|
|
1029
|
-
]
|
|
1030
|
-
}),
|
|
1031
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1032
|
-
className: "space-y-4",
|
|
1033
|
-
children: [
|
|
1034
|
-
/* @__PURE__ */ jsx4("h2", {
|
|
1035
|
-
className: "font-bold text-2xl",
|
|
1036
|
-
children: "Example: Support agent with RAG"
|
|
1037
|
-
}),
|
|
1038
|
-
/* @__PURE__ */ jsx4("p", {
|
|
1039
|
-
className: "text-muted-foreground",
|
|
1040
|
-
children: "Let's build a support agent that uses canonical product documentation and operational support history."
|
|
1041
|
-
}),
|
|
1042
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1043
|
-
className: "space-y-3",
|
|
1044
|
-
children: [
|
|
1045
|
-
/* @__PURE__ */ jsx4("h3", {
|
|
1046
|
-
className: "font-semibold text-lg",
|
|
1047
|
-
children: "Step 1: Blueprint declares knowledge needs"
|
|
1048
|
-
}),
|
|
1049
|
-
/* @__PURE__ */ jsx4(CodeBlock4, {
|
|
1050
|
-
language: "typescript",
|
|
1051
|
-
code: `// AppBlueprintSpec
|
|
324
|
+
}`})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Security & validation"}),s("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[t("li",{children:"Integration connections are validated before binding - health checks ensure connectivity"}),t("li",{children:"Secrets are never stored in TenantAppConfig - only references to encrypted secrets"}),t("li",{children:"Policy Decision Point (PDP) enforces which workflows can use which integrations"}),t("li",{children:"All integration calls are audited with full request/response logging"}),t("li",{children:"Rate limiting and quotas are enforced per connection"})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Best practices"}),s("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[s("li",{children:["Use wildcard patterns sparingly in ",t("code",{children:"allowedWorkflows"})," - be explicit about access"]}),t("li",{children:"Always maintain separate sandbox and production connections"}),t("li",{children:"Monitor integration health checks and set up alerts for failures"}),t("li",{children:"Document the purpose of each integration binding for your team"}),t("li",{children:"Test integration changes in sandbox before promoting to production"})]})]}),s("div",{className:"flex items-center gap-4 pt-4",children:[t(w,{href:"/docs/architecture/app-config",className:"btn-ghost",children:"Previous: App Configuration"}),s(w,{href:"/docs/architecture/knowledge-binding",className:"btn-primary",children:["Knowledge Binding ",t(P,{size:16})]})]})]})}import{CodeBlock as f}from"@contractspec/lib.design-system";import N from"@contractspec/lib.ui-link";import{ChevronRight as T}from"lucide-react";import{jsx as e,jsxs as a}from"react/jsx-runtime";function B(){return a("div",{className:"space-y-8",children:[a("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Knowledge Binding"}),e("p",{className:"text-muted-foreground",children:"Knowledge binding connects your app's workflows and agents to structured knowledge spaces. This enables semantic search, RAG (Retrieval-Augmented Generation), and context-aware decision-making."})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"How it works"}),e("p",{className:"text-muted-foreground",children:"Knowledge binding follows a three-layer model:"}),a("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[a("li",{children:[e("strong",{children:"KnowledgeSpaceSpec"})," (global) - Defines a logical knowledge domain"]}),a("li",{children:[e("strong",{children:"KnowledgeSourceConfig"})," (per-tenant) - Tenant's data sources feeding spaces"]}),a("li",{children:[e("strong",{children:"AppKnowledgeBinding"})," (per-app) - Maps spaces to workflows/agents"]})]})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Example: Support agent with RAG"}),e("p",{className:"text-muted-foreground",children:"Let's build a support agent that uses canonical product documentation and operational support history."}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares knowledge needs"}),e(f,{language:"typescript",code:`// AppBlueprintSpec
|
|
1052
325
|
{
|
|
1053
326
|
id: "support-app",
|
|
1054
327
|
version: "1.0.0",
|
|
@@ -1072,20 +345,7 @@ function ArchitectureKnowledgeBindingPage() {
|
|
|
1072
345
|
purpose: "Third-party integration documentation"
|
|
1073
346
|
}
|
|
1074
347
|
]
|
|
1075
|
-
}`
|
|
1076
|
-
})
|
|
1077
|
-
]
|
|
1078
|
-
}),
|
|
1079
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1080
|
-
className: "space-y-3",
|
|
1081
|
-
children: [
|
|
1082
|
-
/* @__PURE__ */ jsx4("h3", {
|
|
1083
|
-
className: "font-semibold text-lg",
|
|
1084
|
-
children: "Step 2: Tenant configures sources"
|
|
1085
|
-
}),
|
|
1086
|
-
/* @__PURE__ */ jsx4(CodeBlock4, {
|
|
1087
|
-
language: "typescript",
|
|
1088
|
-
code: `// KnowledgeSourceConfig (per-tenant)
|
|
348
|
+
}`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant configures sources"}),e(f,{language:"typescript",code:`// KnowledgeSourceConfig (per-tenant)
|
|
1089
349
|
[
|
|
1090
350
|
{
|
|
1091
351
|
id: "src_notion_product_docs",
|
|
@@ -1114,20 +374,7 @@ function ArchitectureKnowledgeBindingPage() {
|
|
|
1114
374
|
syncPolicy: { interval: "24h" },
|
|
1115
375
|
lastSyncedAt: "2025-01-15T00:00:00Z"
|
|
1116
376
|
}
|
|
1117
|
-
]`
|
|
1118
|
-
})
|
|
1119
|
-
]
|
|
1120
|
-
}),
|
|
1121
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1122
|
-
className: "space-y-3",
|
|
1123
|
-
children: [
|
|
1124
|
-
/* @__PURE__ */ jsx4("h3", {
|
|
1125
|
-
className: "font-semibold text-lg",
|
|
1126
|
-
children: "Step 3: TenantAppConfig binds spaces"
|
|
1127
|
-
}),
|
|
1128
|
-
/* @__PURE__ */ jsx4(CodeBlock4, {
|
|
1129
|
-
language: "typescript",
|
|
1130
|
-
code: `// TenantAppConfig
|
|
377
|
+
]`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds spaces"}),e(f,{language:"typescript",code:`// TenantAppConfig
|
|
1131
378
|
{
|
|
1132
379
|
tenantId: "acme-corp",
|
|
1133
380
|
blueprintId: "support-app",
|
|
@@ -1163,20 +410,7 @@ function ArchitectureKnowledgeBindingPage() {
|
|
|
1163
410
|
sources: ["src_stripe_docs"]
|
|
1164
411
|
}
|
|
1165
412
|
]
|
|
1166
|
-
}`
|
|
1167
|
-
})
|
|
1168
|
-
]
|
|
1169
|
-
}),
|
|
1170
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1171
|
-
className: "space-y-3",
|
|
1172
|
-
children: [
|
|
1173
|
-
/* @__PURE__ */ jsx4("h3", {
|
|
1174
|
-
className: "font-semibold text-lg",
|
|
1175
|
-
children: "Step 4: Workflow uses knowledge"
|
|
1176
|
-
}),
|
|
1177
|
-
/* @__PURE__ */ jsx4(CodeBlock4, {
|
|
1178
|
-
language: "yaml",
|
|
1179
|
-
code: `// WorkflowSpec
|
|
413
|
+
}`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 4: Workflow uses knowledge"}),e(f,{language:"yaml",code:`// WorkflowSpec
|
|
1180
414
|
workflowId: answer-question
|
|
1181
415
|
version: '1.0.0'.0.0
|
|
1182
416
|
|
|
@@ -1218,156 +452,7 @@ steps:
|
|
|
1218
452
|
\${steps.search-canonical.output.results}
|
|
1219
453
|
|
|
1220
454
|
Support history:
|
|
1221
|
-
\${steps.search-support-history.output.results}`
|
|
1222
|
-
})
|
|
1223
|
-
]
|
|
1224
|
-
})
|
|
1225
|
-
]
|
|
1226
|
-
}),
|
|
1227
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1228
|
-
className: "space-y-4",
|
|
1229
|
-
children: [
|
|
1230
|
-
/* @__PURE__ */ jsx4("h2", {
|
|
1231
|
-
className: "font-bold text-2xl",
|
|
1232
|
-
children: "Category-based access control"
|
|
1233
|
-
}),
|
|
1234
|
-
/* @__PURE__ */ jsx4("p", {
|
|
1235
|
-
className: "text-muted-foreground",
|
|
1236
|
-
children: "Different knowledge categories have different trust levels and access patterns:"
|
|
1237
|
-
}),
|
|
1238
|
-
/* @__PURE__ */ jsx4("div", {
|
|
1239
|
-
className: "overflow-x-auto rounded-lg border border-border/50",
|
|
1240
|
-
children: /* @__PURE__ */ jsxs4("table", {
|
|
1241
|
-
className: "w-full text-left text-sm",
|
|
1242
|
-
children: [
|
|
1243
|
-
/* @__PURE__ */ jsx4("thead", {
|
|
1244
|
-
className: "bg-card/50",
|
|
1245
|
-
children: /* @__PURE__ */ jsxs4("tr", {
|
|
1246
|
-
className: "border-border/50 border-b",
|
|
1247
|
-
children: [
|
|
1248
|
-
/* @__PURE__ */ jsx4("th", {
|
|
1249
|
-
className: "px-4 py-3 font-semibold",
|
|
1250
|
-
children: "Category"
|
|
1251
|
-
}),
|
|
1252
|
-
/* @__PURE__ */ jsx4("th", {
|
|
1253
|
-
className: "px-4 py-3 font-semibold",
|
|
1254
|
-
children: "Trust Level"
|
|
1255
|
-
}),
|
|
1256
|
-
/* @__PURE__ */ jsx4("th", {
|
|
1257
|
-
className: "px-4 py-3 font-semibold",
|
|
1258
|
-
children: "Use Cases"
|
|
1259
|
-
}),
|
|
1260
|
-
/* @__PURE__ */ jsx4("th", {
|
|
1261
|
-
className: "px-4 py-3 font-semibold",
|
|
1262
|
-
children: "Policy Impact"
|
|
1263
|
-
})
|
|
1264
|
-
]
|
|
1265
|
-
})
|
|
1266
|
-
}),
|
|
1267
|
-
/* @__PURE__ */ jsxs4("tbody", {
|
|
1268
|
-
className: "divide-y divide-border/50",
|
|
1269
|
-
children: [
|
|
1270
|
-
/* @__PURE__ */ jsxs4("tr", {
|
|
1271
|
-
children: [
|
|
1272
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1273
|
-
className: "px-4 py-3 font-mono text-xs",
|
|
1274
|
-
children: "canonical"
|
|
1275
|
-
}),
|
|
1276
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1277
|
-
className: "px-4 py-3",
|
|
1278
|
-
children: "Highest"
|
|
1279
|
-
}),
|
|
1280
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1281
|
-
className: "px-4 py-3",
|
|
1282
|
-
children: "Product specs, schemas, official policies"
|
|
1283
|
-
}),
|
|
1284
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1285
|
-
className: "px-4 py-3",
|
|
1286
|
-
children: "Can drive policy decisions"
|
|
1287
|
-
})
|
|
1288
|
-
]
|
|
1289
|
-
}),
|
|
1290
|
-
/* @__PURE__ */ jsxs4("tr", {
|
|
1291
|
-
children: [
|
|
1292
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1293
|
-
className: "px-4 py-3 font-mono text-xs",
|
|
1294
|
-
children: "operational"
|
|
1295
|
-
}),
|
|
1296
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1297
|
-
className: "px-4 py-3",
|
|
1298
|
-
children: "High"
|
|
1299
|
-
}),
|
|
1300
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1301
|
-
className: "px-4 py-3",
|
|
1302
|
-
children: "Support tickets, sales docs, internal runbooks"
|
|
1303
|
-
}),
|
|
1304
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1305
|
-
className: "px-4 py-3",
|
|
1306
|
-
children: "Can inform decisions"
|
|
1307
|
-
})
|
|
1308
|
-
]
|
|
1309
|
-
}),
|
|
1310
|
-
/* @__PURE__ */ jsxs4("tr", {
|
|
1311
|
-
children: [
|
|
1312
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1313
|
-
className: "px-4 py-3 font-mono text-xs",
|
|
1314
|
-
children: "external"
|
|
1315
|
-
}),
|
|
1316
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1317
|
-
className: "px-4 py-3",
|
|
1318
|
-
children: "Medium"
|
|
1319
|
-
}),
|
|
1320
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1321
|
-
className: "px-4 py-3",
|
|
1322
|
-
children: "Third-party docs, regulations, PSP guides"
|
|
1323
|
-
}),
|
|
1324
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1325
|
-
className: "px-4 py-3",
|
|
1326
|
-
children: "Reference only, not authoritative"
|
|
1327
|
-
})
|
|
1328
|
-
]
|
|
1329
|
-
}),
|
|
1330
|
-
/* @__PURE__ */ jsxs4("tr", {
|
|
1331
|
-
children: [
|
|
1332
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1333
|
-
className: "px-4 py-3 font-mono text-xs",
|
|
1334
|
-
children: "ephemeral"
|
|
1335
|
-
}),
|
|
1336
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1337
|
-
className: "px-4 py-3",
|
|
1338
|
-
children: "Low"
|
|
1339
|
-
}),
|
|
1340
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1341
|
-
className: "px-4 py-3",
|
|
1342
|
-
children: "Agent scratchpads, session context, drafts"
|
|
1343
|
-
}),
|
|
1344
|
-
/* @__PURE__ */ jsx4("td", {
|
|
1345
|
-
className: "px-4 py-3",
|
|
1346
|
-
children: "Never used for decisions"
|
|
1347
|
-
})
|
|
1348
|
-
]
|
|
1349
|
-
})
|
|
1350
|
-
]
|
|
1351
|
-
})
|
|
1352
|
-
]
|
|
1353
|
-
})
|
|
1354
|
-
})
|
|
1355
|
-
]
|
|
1356
|
-
}),
|
|
1357
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1358
|
-
className: "space-y-4",
|
|
1359
|
-
children: [
|
|
1360
|
-
/* @__PURE__ */ jsx4("h2", {
|
|
1361
|
-
className: "font-bold text-2xl",
|
|
1362
|
-
children: "Multi-space workflows"
|
|
1363
|
-
}),
|
|
1364
|
-
/* @__PURE__ */ jsx4("p", {
|
|
1365
|
-
className: "text-muted-foreground",
|
|
1366
|
-
children: "Workflows can query multiple knowledge spaces and combine results:"
|
|
1367
|
-
}),
|
|
1368
|
-
/* @__PURE__ */ jsx4(CodeBlock4, {
|
|
1369
|
-
language: "typescript",
|
|
1370
|
-
code: `knowledgeBindings: [
|
|
455
|
+
\${steps.search-support-history.output.results}`})]})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Category-based access control"}),e("p",{className:"text-muted-foreground",children:"Different knowledge categories have different trust levels and access patterns:"}),e("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:a("table",{className:"w-full text-left text-sm",children:[e("thead",{className:"bg-card/50",children:a("tr",{className:"border-border/50 border-b",children:[e("th",{className:"px-4 py-3 font-semibold",children:"Category"}),e("th",{className:"px-4 py-3 font-semibold",children:"Trust Level"}),e("th",{className:"px-4 py-3 font-semibold",children:"Use Cases"}),e("th",{className:"px-4 py-3 font-semibold",children:"Policy Impact"})]})}),a("tbody",{className:"divide-y divide-border/50",children:[a("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"canonical"}),e("td",{className:"px-4 py-3",children:"Highest"}),e("td",{className:"px-4 py-3",children:"Product specs, schemas, official policies"}),e("td",{className:"px-4 py-3",children:"Can drive policy decisions"})]}),a("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"operational"}),e("td",{className:"px-4 py-3",children:"High"}),e("td",{className:"px-4 py-3",children:"Support tickets, sales docs, internal runbooks"}),e("td",{className:"px-4 py-3",children:"Can inform decisions"})]}),a("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"external"}),e("td",{className:"px-4 py-3",children:"Medium"}),e("td",{className:"px-4 py-3",children:"Third-party docs, regulations, PSP guides"}),e("td",{className:"px-4 py-3",children:"Reference only, not authoritative"})]}),a("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"ephemeral"}),e("td",{className:"px-4 py-3",children:"Low"}),e("td",{className:"px-4 py-3",children:"Agent scratchpads, session context, drafts"}),e("td",{className:"px-4 py-3",children:"Never used for decisions"})]})]})]})})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Multi-space workflows"}),e("p",{className:"text-muted-foreground",children:"Workflows can query multiple knowledge spaces and combine results:"}),e(f,{language:"typescript",code:`knowledgeBindings: [
|
|
1371
456
|
{
|
|
1372
457
|
spaceId: "product-canon",
|
|
1373
458
|
enabled: true,
|
|
@@ -1395,416 +480,11 @@ steps:
|
|
|
1395
480
|
allowedCategories: ["operational"],
|
|
1396
481
|
sources: ["src_crm_data", "src_past_invoices"]
|
|
1397
482
|
}
|
|
1398
|
-
]`
|
|
1399
|
-
})
|
|
1400
|
-
]
|
|
1401
|
-
}),
|
|
1402
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1403
|
-
className: "space-y-4",
|
|
1404
|
-
children: [
|
|
1405
|
-
/* @__PURE__ */ jsx4("h2", {
|
|
1406
|
-
className: "font-bold text-2xl",
|
|
1407
|
-
children: "Security & validation"
|
|
1408
|
-
}),
|
|
1409
|
-
/* @__PURE__ */ jsxs4("ul", {
|
|
1410
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
1411
|
-
children: [
|
|
1412
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1413
|
-
children: "Knowledge sources are validated before sync - credentials and permissions checked"
|
|
1414
|
-
}),
|
|
1415
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1416
|
-
children: "PDP enforces which workflows/agents can access which spaces"
|
|
1417
|
-
}),
|
|
1418
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1419
|
-
children: "All knowledge queries are audited with search terms and results"
|
|
1420
|
-
}),
|
|
1421
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1422
|
-
children: "Canonical knowledge is immutable once indexed - changes require re-sync"
|
|
1423
|
-
}),
|
|
1424
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1425
|
-
children: "Ephemeral knowledge is automatically purged based on retention policies"
|
|
1426
|
-
})
|
|
1427
|
-
]
|
|
1428
|
-
})
|
|
1429
|
-
]
|
|
1430
|
-
}),
|
|
1431
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1432
|
-
className: "space-y-4",
|
|
1433
|
-
children: [
|
|
1434
|
-
/* @__PURE__ */ jsx4("h2", {
|
|
1435
|
-
className: "font-bold text-2xl",
|
|
1436
|
-
children: "Best practices"
|
|
1437
|
-
}),
|
|
1438
|
-
/* @__PURE__ */ jsxs4("ul", {
|
|
1439
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
1440
|
-
children: [
|
|
1441
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1442
|
-
children: "Use canonical spaces for policy-critical decisions, operational for suggestions"
|
|
1443
|
-
}),
|
|
1444
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1445
|
-
children: "Never allow workflows to write to canonical spaces - maintain read-only access"
|
|
1446
|
-
}),
|
|
1447
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1448
|
-
children: "Set up monitoring for sync failures and stale knowledge sources"
|
|
1449
|
-
}),
|
|
1450
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1451
|
-
children: "Document the purpose and trust level of each knowledge space"
|
|
1452
|
-
}),
|
|
1453
|
-
/* @__PURE__ */ jsx4("li", {
|
|
1454
|
-
children: "Test knowledge queries in sandbox before promoting to production"
|
|
1455
|
-
}),
|
|
1456
|
-
/* @__PURE__ */ jsxs4("li", {
|
|
1457
|
-
children: [
|
|
1458
|
-
"Use explicit ",
|
|
1459
|
-
/* @__PURE__ */ jsx4("code", {
|
|
1460
|
-
children: "allowedConsumers"
|
|
1461
|
-
}),
|
|
1462
|
-
" - avoid wildcard access"
|
|
1463
|
-
]
|
|
1464
|
-
})
|
|
1465
|
-
]
|
|
1466
|
-
})
|
|
1467
|
-
]
|
|
1468
|
-
}),
|
|
1469
|
-
/* @__PURE__ */ jsxs4("div", {
|
|
1470
|
-
className: "flex items-center gap-4 pt-4",
|
|
1471
|
-
children: [
|
|
1472
|
-
/* @__PURE__ */ jsx4(Link4, {
|
|
1473
|
-
href: "/docs/architecture/integration-binding",
|
|
1474
|
-
className: "btn-ghost",
|
|
1475
|
-
children: "Previous: Integration Binding"
|
|
1476
|
-
}),
|
|
1477
|
-
/* @__PURE__ */ jsxs4(Link4, {
|
|
1478
|
-
href: "/docs/knowledge",
|
|
1479
|
-
className: "btn-primary",
|
|
1480
|
-
children: [
|
|
1481
|
-
"Knowledge & Context ",
|
|
1482
|
-
/* @__PURE__ */ jsx4(ChevronRight4, {
|
|
1483
|
-
size: 16
|
|
1484
|
-
})
|
|
1485
|
-
]
|
|
1486
|
-
})
|
|
1487
|
-
]
|
|
1488
|
-
})
|
|
1489
|
-
]
|
|
1490
|
-
});
|
|
1491
|
-
}
|
|
1492
|
-
|
|
1493
|
-
// src/components/docs/architecture/ArchitectureMultiTenancyPage.tsx
|
|
1494
|
-
import { CodeBlock as CodeBlock5 } from "@contractspec/lib.design-system";
|
|
1495
|
-
import Link5 from "@contractspec/lib.ui-link";
|
|
1496
|
-
import { ChevronRight as ChevronRight5 } from "lucide-react";
|
|
1497
|
-
import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
|
|
1498
|
-
function ArchitectureMultiTenancyPage() {
|
|
1499
|
-
return /* @__PURE__ */ jsxs5("div", {
|
|
1500
|
-
className: "space-y-8",
|
|
1501
|
-
children: [
|
|
1502
|
-
/* @__PURE__ */ jsxs5("div", {
|
|
1503
|
-
className: "space-y-4",
|
|
1504
|
-
children: [
|
|
1505
|
-
/* @__PURE__ */ jsx5("h1", {
|
|
1506
|
-
className: "font-bold text-4xl",
|
|
1507
|
-
children: "Multi-Tenancy"
|
|
1508
|
-
}),
|
|
1509
|
-
/* @__PURE__ */ jsx5("p", {
|
|
1510
|
-
className: "text-muted-foreground",
|
|
1511
|
-
children: "ContractSpec is designed from the ground up for multi-tenancy. Apps built with ContractSpec can serve multiple organizations (tenants) from a single deployment, while ensuring strict data isolation and configuration separation."
|
|
1512
|
-
})
|
|
1513
|
-
]
|
|
1514
|
-
}),
|
|
1515
|
-
/* @__PURE__ */ jsxs5("div", {
|
|
1516
|
-
className: "space-y-4",
|
|
1517
|
-
children: [
|
|
1518
|
-
/* @__PURE__ */ jsx5("h2", {
|
|
1519
|
-
className: "font-bold text-2xl",
|
|
1520
|
-
children: "Core Concepts"
|
|
1521
|
-
}),
|
|
1522
|
-
/* @__PURE__ */ jsxs5("ul", {
|
|
1523
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
1524
|
-
children: [
|
|
1525
|
-
/* @__PURE__ */ jsxs5("li", {
|
|
1526
|
-
children: [
|
|
1527
|
-
/* @__PURE__ */ jsx5("strong", {
|
|
1528
|
-
children: "Tenant"
|
|
1529
|
-
}),
|
|
1530
|
-
": An organization or customer that uses your app. Each tenant has a unique ",
|
|
1531
|
-
/* @__PURE__ */ jsx5("code", {
|
|
1532
|
-
children: "tenantId"
|
|
1533
|
-
}),
|
|
1534
|
-
"."
|
|
1535
|
-
]
|
|
1536
|
-
}),
|
|
1537
|
-
/* @__PURE__ */ jsxs5("li", {
|
|
1538
|
-
children: [
|
|
1539
|
-
/* @__PURE__ */ jsx5("strong", {
|
|
1540
|
-
children: "Tenant Isolation"
|
|
1541
|
-
}),
|
|
1542
|
-
": Data and configuration for one tenant is never accessible to another tenant unless explicitly shared."
|
|
1543
|
-
]
|
|
1544
|
-
}),
|
|
1545
|
-
/* @__PURE__ */ jsxs5("li", {
|
|
1546
|
-
children: [
|
|
1547
|
-
/* @__PURE__ */ jsx5("strong", {
|
|
1548
|
-
children: "Tenant Context"
|
|
1549
|
-
}),
|
|
1550
|
-
": Every request and operation runs within the context of a specific tenant."
|
|
1551
|
-
]
|
|
1552
|
-
})
|
|
1553
|
-
]
|
|
1554
|
-
})
|
|
1555
|
-
]
|
|
1556
|
-
}),
|
|
1557
|
-
/* @__PURE__ */ jsxs5("div", {
|
|
1558
|
-
className: "space-y-4",
|
|
1559
|
-
children: [
|
|
1560
|
-
/* @__PURE__ */ jsx5("h2", {
|
|
1561
|
-
className: "font-bold text-2xl",
|
|
1562
|
-
children: "Tenant Resolution"
|
|
1563
|
-
}),
|
|
1564
|
-
/* @__PURE__ */ jsx5("p", {
|
|
1565
|
-
className: "text-muted-foreground",
|
|
1566
|
-
children: "The runtime automatically resolves the tenant context for every request based on:"
|
|
1567
|
-
}),
|
|
1568
|
-
/* @__PURE__ */ jsxs5("ul", {
|
|
1569
|
-
className: "list-inside list-disc space-y-2 text-muted-foreground",
|
|
1570
|
-
children: [
|
|
1571
|
-
/* @__PURE__ */ jsxs5("li", {
|
|
1572
|
-
children: [
|
|
1573
|
-
"Subdomain (e.g., ",
|
|
1574
|
-
/* @__PURE__ */ jsx5("code", {
|
|
1575
|
-
children: "acme.app.com"
|
|
1576
|
-
}),
|
|
1577
|
-
")"
|
|
1578
|
-
]
|
|
1579
|
-
}),
|
|
1580
|
-
/* @__PURE__ */ jsxs5("li", {
|
|
1581
|
-
children: [
|
|
1582
|
-
"Custom Domain (e.g., ",
|
|
1583
|
-
/* @__PURE__ */ jsx5("code", {
|
|
1584
|
-
children: "portal.acme.com"
|
|
1585
|
-
}),
|
|
1586
|
-
")"
|
|
1587
|
-
]
|
|
1588
|
-
}),
|
|
1589
|
-
/* @__PURE__ */ jsxs5("li", {
|
|
1590
|
-
children: [
|
|
1591
|
-
"Header (e.g., ",
|
|
1592
|
-
/* @__PURE__ */ jsx5("code", {
|
|
1593
|
-
children: "x-tenant-id: acme-corp"
|
|
1594
|
-
}),
|
|
1595
|
-
")"
|
|
1596
|
-
]
|
|
1597
|
-
}),
|
|
1598
|
-
/* @__PURE__ */ jsx5("li", {
|
|
1599
|
-
children: "Authentication Token (embedded tenant claim)"
|
|
1600
|
-
})
|
|
1601
|
-
]
|
|
1602
|
-
})
|
|
1603
|
-
]
|
|
1604
|
-
}),
|
|
1605
|
-
/* @__PURE__ */ jsxs5("div", {
|
|
1606
|
-
className: "space-y-4",
|
|
1607
|
-
children: [
|
|
1608
|
-
/* @__PURE__ */ jsx5("h2", {
|
|
1609
|
-
className: "font-bold text-2xl",
|
|
1610
|
-
children: "Configuration Isolation"
|
|
1611
|
-
}),
|
|
1612
|
-
/* @__PURE__ */ jsxs5("p", {
|
|
1613
|
-
className: "text-muted-foreground",
|
|
1614
|
-
children: [
|
|
1615
|
-
"Each tenant has its own ",
|
|
1616
|
-
/* @__PURE__ */ jsx5("code", {
|
|
1617
|
-
children: "TenantAppConfig"
|
|
1618
|
-
}),
|
|
1619
|
-
" which defines:"
|
|
1620
|
-
]
|
|
1621
|
-
}),
|
|
1622
|
-
/* @__PURE__ */ jsx5(CodeBlock5, {
|
|
1623
|
-
language: "typescript",
|
|
1624
|
-
code: `type TenantAppConfig = {
|
|
483
|
+
]`})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Security & validation"}),a("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Knowledge sources are validated before sync - credentials and permissions checked"}),e("li",{children:"PDP enforces which workflows/agents can access which spaces"}),e("li",{children:"All knowledge queries are audited with search terms and results"}),e("li",{children:"Canonical knowledge is immutable once indexed - changes require re-sync"}),e("li",{children:"Ephemeral knowledge is automatically purged based on retention policies"})]})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),a("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Use canonical spaces for policy-critical decisions, operational for suggestions"}),e("li",{children:"Never allow workflows to write to canonical spaces - maintain read-only access"}),e("li",{children:"Set up monitoring for sync failures and stale knowledge sources"}),e("li",{children:"Document the purpose and trust level of each knowledge space"}),e("li",{children:"Test knowledge queries in sandbox before promoting to production"}),a("li",{children:["Use explicit ",e("code",{children:"allowedConsumers"})," - avoid wildcard access"]})]})]}),a("div",{className:"flex items-center gap-4 pt-4",children:[e(N,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),a(N,{href:"/docs/knowledge",className:"btn-primary",children:["Knowledge & Context ",e(T,{size:16})]})]})]})}import{CodeBlock as R}from"@contractspec/lib.design-system";import k from"@contractspec/lib.ui-link";import{ChevronRight as q}from"lucide-react";import{jsx as c,jsxs as l}from"react/jsx-runtime";function L(){return l("div",{className:"space-y-8",children:[l("div",{className:"space-y-4",children:[c("h1",{className:"font-bold text-4xl",children:"Multi-Tenancy"}),c("p",{className:"text-muted-foreground",children:"ContractSpec is designed from the ground up for multi-tenancy. Apps built with ContractSpec can serve multiple organizations (tenants) from a single deployment, while ensuring strict data isolation and configuration separation."})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Core Concepts"}),l("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[l("li",{children:[c("strong",{children:"Tenant"}),": An organization or customer that uses your app. Each tenant has a unique ",c("code",{children:"tenantId"}),"."]}),l("li",{children:[c("strong",{children:"Tenant Isolation"}),": Data and configuration for one tenant is never accessible to another tenant unless explicitly shared."]}),l("li",{children:[c("strong",{children:"Tenant Context"}),": Every request and operation runs within the context of a specific tenant."]})]})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Tenant Resolution"}),c("p",{className:"text-muted-foreground",children:"The runtime automatically resolves the tenant context for every request based on:"}),l("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[l("li",{children:["Subdomain (e.g., ",c("code",{children:"acme.app.com"}),")"]}),l("li",{children:["Custom Domain (e.g., ",c("code",{children:"portal.acme.com"}),")"]}),l("li",{children:["Header (e.g., ",c("code",{children:"x-tenant-id: acme-corp"}),")"]}),c("li",{children:"Authentication Token (embedded tenant claim)"})]})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Configuration Isolation"}),l("p",{className:"text-muted-foreground",children:["Each tenant has its own ",c("code",{children:"TenantAppConfig"})," which defines:"]}),c(R,{language:"typescript",code:`type TenantAppConfig = {
|
|
1625
484
|
tenantId: string;
|
|
1626
485
|
blueprintId: string;
|
|
1627
486
|
// ...
|
|
1628
487
|
integrationBindings: AppIntegrationBinding[];
|
|
1629
488
|
knowledgeBindings: AppKnowledgeBinding[];
|
|
1630
489
|
featureFlags: Record<string, boolean>;
|
|
1631
|
-
};`
|
|
1632
|
-
}),
|
|
1633
|
-
/* @__PURE__ */ jsx5("p", {
|
|
1634
|
-
className: "mt-2 text-muted-foreground",
|
|
1635
|
-
children: "This allows you to customize feature flags, integration connections, and knowledge sources per tenant without changing the application code."
|
|
1636
|
-
})
|
|
1637
|
-
]
|
|
1638
|
-
}),
|
|
1639
|
-
/* @__PURE__ */ jsxs5("div", {
|
|
1640
|
-
className: "flex items-center gap-4 pt-4",
|
|
1641
|
-
children: [
|
|
1642
|
-
/* @__PURE__ */ jsx5(Link5, {
|
|
1643
|
-
href: "/docs/architecture",
|
|
1644
|
-
className: "btn-ghost",
|
|
1645
|
-
children: "Back to Architecture"
|
|
1646
|
-
}),
|
|
1647
|
-
/* @__PURE__ */ jsxs5(Link5, {
|
|
1648
|
-
href: "/docs/libraries/multi-tenancy",
|
|
1649
|
-
className: "btn-primary",
|
|
1650
|
-
children: [
|
|
1651
|
-
"Multi-Tenancy Library ",
|
|
1652
|
-
/* @__PURE__ */ jsx5(ChevronRight5, {
|
|
1653
|
-
size: 16
|
|
1654
|
-
})
|
|
1655
|
-
]
|
|
1656
|
-
})
|
|
1657
|
-
]
|
|
1658
|
-
})
|
|
1659
|
-
]
|
|
1660
|
-
});
|
|
1661
|
-
}
|
|
1662
|
-
|
|
1663
|
-
// src/components/docs/architecture/ArchitectureOverviewPage.tsx
|
|
1664
|
-
import Link6 from "@contractspec/lib.ui-link";
|
|
1665
|
-
import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
|
|
1666
|
-
var layers = [
|
|
1667
|
-
{
|
|
1668
|
-
title: "Contracts and schemas",
|
|
1669
|
-
body: "Explicit specs define the durable boundary for behavior, data, and governance."
|
|
1670
|
-
},
|
|
1671
|
-
{
|
|
1672
|
-
title: "Bindings and configuration",
|
|
1673
|
-
body: "Apps, tenants, integrations, and knowledge sources are wired through explicit configuration instead of hidden glue."
|
|
1674
|
-
},
|
|
1675
|
-
{
|
|
1676
|
-
title: "Runtimes and generators",
|
|
1677
|
-
body: "Serve or generate aligned surfaces for API, UI, workflows, docs, and agent-facing interfaces."
|
|
1678
|
-
},
|
|
1679
|
-
{
|
|
1680
|
-
title: "Operate and observe",
|
|
1681
|
-
body: "Carry auditability, policy, tracing, migrations, and tenant isolation through the same model."
|
|
1682
|
-
}
|
|
1683
|
-
];
|
|
1684
|
-
function ArchitectureOverviewPage() {
|
|
1685
|
-
return /* @__PURE__ */ jsxs6("div", {
|
|
1686
|
-
className: "space-y-10",
|
|
1687
|
-
children: [
|
|
1688
|
-
/* @__PURE__ */ jsxs6("div", {
|
|
1689
|
-
className: "space-y-3",
|
|
1690
|
-
children: [
|
|
1691
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1692
|
-
className: "editorial-kicker",
|
|
1693
|
-
children: "Build"
|
|
1694
|
-
}),
|
|
1695
|
-
/* @__PURE__ */ jsx6("h1", {
|
|
1696
|
-
className: "font-serif text-4xl tracking-[-0.04em] md:text-5xl",
|
|
1697
|
-
children: "The architecture keeps contracts, runtime behavior, and operations in the same system."
|
|
1698
|
-
}),
|
|
1699
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1700
|
-
className: "max-w-3xl text-lg text-muted-foreground leading-8",
|
|
1701
|
-
children: "ContractSpec is not a single runtime. It is a layered system that lets you define explicit boundaries, bind real-world configuration, and then serve or generate aligned surfaces without losing control of the output."
|
|
1702
|
-
})
|
|
1703
|
-
]
|
|
1704
|
-
}),
|
|
1705
|
-
/* @__PURE__ */ jsx6("div", {
|
|
1706
|
-
className: "grid gap-4 md:grid-cols-2",
|
|
1707
|
-
children: layers.map((layer) => /* @__PURE__ */ jsxs6("article", {
|
|
1708
|
-
className: "editorial-panel space-y-3",
|
|
1709
|
-
children: [
|
|
1710
|
-
/* @__PURE__ */ jsx6("h2", {
|
|
1711
|
-
className: "font-semibold text-xl",
|
|
1712
|
-
children: layer.title
|
|
1713
|
-
}),
|
|
1714
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1715
|
-
className: "text-muted-foreground text-sm leading-7",
|
|
1716
|
-
children: layer.body
|
|
1717
|
-
})
|
|
1718
|
-
]
|
|
1719
|
-
}, layer.title))
|
|
1720
|
-
}),
|
|
1721
|
-
/* @__PURE__ */ jsxs6("section", {
|
|
1722
|
-
className: "editorial-panel space-y-5",
|
|
1723
|
-
children: [
|
|
1724
|
-
/* @__PURE__ */ jsxs6("div", {
|
|
1725
|
-
className: "space-y-2",
|
|
1726
|
-
children: [
|
|
1727
|
-
/* @__PURE__ */ jsx6("h2", {
|
|
1728
|
-
className: "font-serif text-3xl tracking-[-0.03em]",
|
|
1729
|
-
children: "Follow the architecture by responsibility"
|
|
1730
|
-
}),
|
|
1731
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1732
|
-
className: "text-muted-foreground text-sm leading-7",
|
|
1733
|
-
children: "Use the architecture pages when you need to understand how the pieces snap together in a real deployment."
|
|
1734
|
-
})
|
|
1735
|
-
]
|
|
1736
|
-
}),
|
|
1737
|
-
/* @__PURE__ */ jsxs6("div", {
|
|
1738
|
-
className: "grid gap-4 md:grid-cols-2",
|
|
1739
|
-
children: [
|
|
1740
|
-
/* @__PURE__ */ jsxs6(Link6, {
|
|
1741
|
-
href: "/docs/architecture/app-config",
|
|
1742
|
-
className: "docs-footer-link",
|
|
1743
|
-
children: [
|
|
1744
|
-
/* @__PURE__ */ jsx6("h3", {
|
|
1745
|
-
className: "font-semibold text-lg",
|
|
1746
|
-
children: "App configuration"
|
|
1747
|
-
}),
|
|
1748
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1749
|
-
className: "text-muted-foreground text-sm leading-7",
|
|
1750
|
-
children: "How blueprint-level and tenant-level config stay explicit and merge safely."
|
|
1751
|
-
})
|
|
1752
|
-
]
|
|
1753
|
-
}),
|
|
1754
|
-
/* @__PURE__ */ jsxs6(Link6, {
|
|
1755
|
-
href: "/docs/architecture/integration-binding",
|
|
1756
|
-
className: "docs-footer-link",
|
|
1757
|
-
children: [
|
|
1758
|
-
/* @__PURE__ */ jsx6("h3", {
|
|
1759
|
-
className: "font-semibold text-lg",
|
|
1760
|
-
children: "Integration binding"
|
|
1761
|
-
}),
|
|
1762
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1763
|
-
className: "text-muted-foreground text-sm leading-7",
|
|
1764
|
-
children: "How apps connect to tenant-owned integrations without leaking provider logic everywhere."
|
|
1765
|
-
})
|
|
1766
|
-
]
|
|
1767
|
-
}),
|
|
1768
|
-
/* @__PURE__ */ jsxs6(Link6, {
|
|
1769
|
-
href: "/docs/architecture/knowledge-binding",
|
|
1770
|
-
className: "docs-footer-link",
|
|
1771
|
-
children: [
|
|
1772
|
-
/* @__PURE__ */ jsx6("h3", {
|
|
1773
|
-
className: "font-semibold text-lg",
|
|
1774
|
-
children: "Knowledge binding"
|
|
1775
|
-
}),
|
|
1776
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1777
|
-
className: "text-muted-foreground text-sm leading-7",
|
|
1778
|
-
children: "How trusted knowledge enters the system and stays isolated by context and tenant."
|
|
1779
|
-
})
|
|
1780
|
-
]
|
|
1781
|
-
}),
|
|
1782
|
-
/* @__PURE__ */ jsxs6(Link6, {
|
|
1783
|
-
href: "/docs/architecture/control-plane",
|
|
1784
|
-
className: "docs-footer-link",
|
|
1785
|
-
children: [
|
|
1786
|
-
/* @__PURE__ */ jsx6("h3", {
|
|
1787
|
-
className: "font-semibold text-lg",
|
|
1788
|
-
children: "Control plane runtime"
|
|
1789
|
-
}),
|
|
1790
|
-
/* @__PURE__ */ jsx6("p", {
|
|
1791
|
-
className: "text-muted-foreground text-sm leading-7",
|
|
1792
|
-
children: "How intent, policy, planning, and execution flow through the system runtime."
|
|
1793
|
-
})
|
|
1794
|
-
]
|
|
1795
|
-
})
|
|
1796
|
-
]
|
|
1797
|
-
})
|
|
1798
|
-
]
|
|
1799
|
-
})
|
|
1800
|
-
]
|
|
1801
|
-
});
|
|
1802
|
-
}
|
|
1803
|
-
export {
|
|
1804
|
-
ArchitectureOverviewPage,
|
|
1805
|
-
ArchitectureMultiTenancyPage,
|
|
1806
|
-
ArchitectureKnowledgeBindingPage,
|
|
1807
|
-
ArchitectureIntegrationBindingPage,
|
|
1808
|
-
ArchitectureControlPlanePage,
|
|
1809
|
-
ArchitectureAppConfigPage
|
|
1810
|
-
};
|
|
490
|
+
};`}),c("p",{className:"mt-2 text-muted-foreground",children:"This allows you to customize feature flags, integration connections, and knowledge sources per tenant without changing the application code."})]}),l("div",{className:"flex items-center gap-4 pt-4",children:[c(k,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),l(k,{href:"/docs/libraries/multi-tenancy",className:"btn-primary",children:["Multi-Tenancy Library ",c(q,{size:16})]})]})]})}import u from"@contractspec/lib.ui-link";import{jsx as i,jsxs as d}from"react/jsx-runtime";var K=[{title:"Contracts and schemas",body:"Explicit specs define the durable boundary for behavior, data, and governance."},{title:"Bindings and configuration",body:"Apps, tenants, integrations, and knowledge sources are wired through explicit configuration instead of hidden glue."},{title:"Runtimes and generators",body:"Serve or generate aligned surfaces for API, UI, workflows, docs, and agent-facing interfaces."},{title:"Operate and observe",body:"Carry auditability, policy, tracing, migrations, and tenant isolation through the same model."}];function D(){return d("div",{className:"space-y-10",children:[d("div",{className:"space-y-3",children:[i("p",{className:"editorial-kicker",children:"Build"}),i("h1",{className:"font-serif text-4xl tracking-[-0.04em] md:text-5xl",children:"The architecture keeps contracts, runtime behavior, and operations in the same system."}),i("p",{className:"max-w-3xl text-lg text-muted-foreground leading-8",children:"ContractSpec is not a single runtime. It is a layered system that lets you define explicit boundaries, bind real-world configuration, and then serve or generate aligned surfaces without losing control of the output."})]}),i("div",{className:"grid gap-4 md:grid-cols-2",children:K.map((y)=>d("article",{className:"editorial-panel space-y-3",children:[i("h2",{className:"font-semibold text-xl",children:y.title}),i("p",{className:"text-muted-foreground text-sm leading-7",children:y.body})]},y.title))}),d("section",{className:"editorial-panel space-y-5",children:[d("div",{className:"space-y-2",children:[i("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"UI composition belongs in the bundle runtime layer"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"When the system needs adaptive layouts, entity workbenches, assistant slots, and safe overlays, use module bundles as the layer between the contract model and the rendered surface."})]}),d("div",{className:"grid gap-4 md:grid-cols-2",children:[d(u,{href:"/docs/specs/module-bundles",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Module bundles spec"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"See the typed bundle contract, resolved surface plan model, and bounded AI/runtime behavior."})]}),d(u,{href:"/docs/guides/first-module-bundle",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Build a first module bundle"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"Follow the route-to-plan-to-render path with one practical host example."})]})]})]}),d("section",{className:"editorial-panel space-y-5",children:[d("div",{className:"space-y-2",children:[i("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Follow the architecture by responsibility"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"Use the architecture pages when you need to understand how the pieces snap together in a real deployment."})]}),d("div",{className:"grid gap-4 md:grid-cols-2",children:[d(u,{href:"/docs/architecture/app-config",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"App configuration"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How blueprint-level and tenant-level config stay explicit and merge safely."})]}),d(u,{href:"/docs/architecture/integration-binding",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Integration binding"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How apps connect to tenant-owned integrations without leaking provider logic everywhere."})]}),d(u,{href:"/docs/architecture/knowledge-binding",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Knowledge binding"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How trusted knowledge enters the system and stays isolated by context and tenant."})]}),d(u,{href:"/docs/architecture/control-plane",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Control plane runtime"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How intent, policy, planning, and execution flow through the system runtime."})]})]})]})]})}export{D as ArchitectureOverviewPage,L as ArchitectureMultiTenancyPage,B as ArchitectureKnowledgeBindingPage,_ as ArchitectureIntegrationBindingPage,S as ArchitectureControlPlanePage,I as ArchitectureAppConfigPage};
|