@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/components/docs/advanced/AdvancedWorkflowMonitoringPage.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/advanced/AdvancedWorkflowMonitoringPage.d.ts
+declare function AdvancedWorkflowMonitoringPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { AdvancedWorkflowMonitoringPage };
+//# sourceMappingURL=AdvancedWorkflowMonitoringPage.d.ts.map

package/dist/components/docs/advanced/AdvancedWorkflowMonitoringPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdvancedWorkflowMonitoringPage.d.ts","names":[],"sources":["../../../../src/components/docs/advanced/AdvancedWorkflowMonitoringPage.tsx"],"mappings":";;;iBAAgB,8BAAA,CAAA,GAA8B,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/advanced/AdvancedWorkflowMonitoringPage.js

@@ -0,0 +1,84 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/docs/advanced/AdvancedWorkflowMonitoringPage.tsx
+function AdvancedWorkflowMonitoringPage() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-8",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "text-4xl font-bold",
+					children: "Workflow Monitoring"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: "Production workflows need robust observability. ContractSpec provides SLA monitoring, distributed tracing, and audit logging out of the box."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "SLA Monitoring"
+					}),
+					/* @__PURE__ */ jsxs("p", { children: [
+						"Use the ",
+						/* @__PURE__ */ jsx("code", { children: "SLAMonitor" }),
+						" to detect when workflows or individual steps exceed their budgeted duration."
+					] }),
+					/* @__PURE__ */ jsx("pre", {
+						className: "bg-muted rounded-lg border p-4 text-sm",
+						children: `import { SLAMonitor } from '@contractspec/lib.contracts/workflow/sla-monitor';
+
+const monitor = new SLAMonitor((event, payload) => {
+  if (event === 'workflow.sla_breach') {
+    console.error('SLA Breach!', payload);
+    // Send to PagerDuty / Slack
+  }
+});
+
+// Check periodically
+monitor.check(currentState, workflowSpec);`
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Telemetry & Tracing"
+					}),
+					/* @__PURE__ */ jsx("p", { children: "Workflows automatically generate OpenTelemetry spans for:" }),
+					/* @__PURE__ */ jsxs("ul", {
+						className: "list-disc space-y-2 pl-6",
+						children: [
+							/* @__PURE__ */ jsx("li", { children: "Overall workflow execution" }),
+							/* @__PURE__ */ jsx("li", { children: "Individual steps" }),
+							/* @__PURE__ */ jsx("li", { children: "Retries and compensation" })
+						]
+					}),
+					/* @__PURE__ */ jsx("p", { children: "Configure your OpenTelemetry exporter to send traces to Jaeger, Datadog, or Honeycomb." })
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Dashboarding"
+				}), /* @__PURE__ */ jsxs("p", { children: [
+					"You can build a custom dashboard using ",
+					/* @__PURE__ */ jsx("code", { children: "DataViews" }),
+					" over your workflow state database. See the DataViews tutorial for how to visualize ",
+					/* @__PURE__ */ jsx("code", { children: "WorkflowState" }),
+					" records."
+				] })]
+			})
+		]
+	});
+}
+
+//#endregion
+export { AdvancedWorkflowMonitoringPage };
+//# sourceMappingURL=AdvancedWorkflowMonitoringPage.js.map

package/dist/components/docs/advanced/AdvancedWorkflowMonitoringPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdvancedWorkflowMonitoringPage.js","names":[],"sources":["../../../../src/components/docs/advanced/AdvancedWorkflowMonitoringPage.tsx"],"sourcesContent":["export function AdvancedWorkflowMonitoringPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Workflow Monitoring</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          Production workflows need robust observability. ContractSpec provides\n          SLA monitoring, distributed tracing, and audit logging out of the box.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">SLA Monitoring</h2>\n        <p>\n          Use the <code>SLAMonitor</code> to detect when workflows or individual\n          steps exceed their budgeted duration.\n        </p>\n        <pre className=\"bg-muted rounded-lg border p-4 text-sm\">\n          {`import { SLAMonitor } from '@contractspec/lib.contracts/workflow/sla-monitor';\n\nconst monitor = new SLAMonitor((event, payload) => {\n  if (event === 'workflow.sla_breach') {\n    console.error('SLA Breach!', payload);\n    // Send to PagerDuty / Slack\n  }\n});\n\n// Check periodically\nmonitor.check(currentState, workflowSpec);`}\n        </pre>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Telemetry & Tracing</h2>\n        <p>Workflows automatically generate OpenTelemetry spans for:</p>\n        <ul className=\"list-disc space-y-2 pl-6\">\n          <li>Overall workflow execution</li>\n          <li>Individual steps</li>\n          <li>Retries and compensation</li>\n        </ul>\n        <p>\n          Configure your OpenTelemetry exporter to send traces to Jaeger,\n          Datadog, or Honeycomb.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Dashboarding</h2>\n        <p>\n          You can build a custom dashboard using <code>DataViews</code> over\n          your workflow state database. See the DataViews tutorial for how to\n          visualize <code>WorkflowState</code> records.\n        </p>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;AAAA,SAAgB,iCAAiC;AAC/C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAE,WAAU;eAAgC;MAGzC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAmB;KACtD,qBAAC;MAAE;MACO,oBAAC,oBAAK,eAAiB;;SAE7B;KACJ,oBAAC;MAAI,WAAU;gBACZ;;;;;;;;;;;OAWG;;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAwB;KAC3D,oBAAC,iBAAE,8DAA6D;KAChE,qBAAC;MAAG,WAAU;;OACZ,oBAAC,kBAAG,+BAA+B;OACnC,oBAAC,kBAAG,qBAAqB;OACzB,oBAAC,kBAAG,6BAA6B;;OAC9B;KACL,oBAAC,iBAAE,2FAGC;;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAiB,EACpD,qBAAC;KAAE;KACsC,oBAAC,oBAAK,cAAgB;;KAEnD,oBAAC,oBAAK,kBAAoB;;QAClC;KACA;;GACF"}

package/dist/components/docs/advanced/index.d.ts

@@ -0,0 +1,7 @@
+import { AdvancedMCPPage } from "./AdvancedMCPPage.js";
+import { AdvancedOverlayEditorPage } from "./AdvancedOverlayEditorPage.js";
+import { AdvancedRenderersPage } from "./AdvancedRenderersPage.js";
+import { AdvancedSpecExperimentsPage } from "./AdvancedSpecExperimentsPage.js";
+import { AdvancedTelemetryPage } from "./AdvancedTelemetryPage.js";
+import { AdvancedWorkflowMonitoringPage } from "./AdvancedWorkflowMonitoringPage.js";
+export { AdvancedMCPPage, AdvancedOverlayEditorPage, AdvancedRenderersPage, AdvancedSpecExperimentsPage, AdvancedTelemetryPage, AdvancedWorkflowMonitoringPage };

package/dist/components/docs/advanced/index.js

@@ -0,0 +1,8 @@
+import { AdvancedMCPPage } from "./AdvancedMCPPage.js";
+import { AdvancedRenderersPage } from "./AdvancedRenderersPage.js";
+import { AdvancedTelemetryPage } from "./AdvancedTelemetryPage.js";
+import { AdvancedOverlayEditorPage } from "./AdvancedOverlayEditorPage.js";
+import { AdvancedWorkflowMonitoringPage } from "./AdvancedWorkflowMonitoringPage.js";
+import { AdvancedSpecExperimentsPage } from "./AdvancedSpecExperimentsPage.js";
+
+export { AdvancedMCPPage, AdvancedOverlayEditorPage, AdvancedRenderersPage, AdvancedSpecExperimentsPage, AdvancedTelemetryPage, AdvancedWorkflowMonitoringPage };

package/dist/components/docs/architecture/ArchitectureAppConfigPage.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/architecture/ArchitectureAppConfigPage.d.ts
+declare function ArchitectureAppConfigPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ArchitectureAppConfigPage };
+//# sourceMappingURL=ArchitectureAppConfigPage.d.ts.map

package/dist/components/docs/architecture/ArchitectureAppConfigPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchitectureAppConfigPage.d.ts","names":[],"sources":["../../../../src/components/docs/architecture/ArchitectureAppConfigPage.tsx"],"mappings":";;;iBAIgB,yBAAA,CAAA,GAAyB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/architecture/ArchitectureAppConfigPage.js

@@ -0,0 +1,320 @@
+import { ChevronRight } from "lucide-react";
+import { CodeBlock } from "@contractspec/lib.design-system";
+import { jsx, jsxs } from "react/jsx-runtime";
+import Link from "@contractspec/lib.ui-link";
+
+//#region src/components/docs/architecture/ArchitectureAppConfigPage.tsx
+function ArchitectureAppConfigPage() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-8",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "text-4xl font-bold",
+					children: "App Configuration"
+				}), /* @__PURE__ */ jsx("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."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "AppBlueprintSpec"
+					}),
+					/* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground",
+						children: [
+							"The ",
+							/* @__PURE__ */ jsx("strong", { children: "AppBlueprintSpec" }),
+							" is the global, versioned definition of your application. It contains no tenant-specific information and is stored in version control."
+						]
+					}),
+					/* @__PURE__ */ jsx(CodeBlock, {
+						language: "typescript",
+						code: `type AppBlueprintSpec = {
+  id: string;
+  version: string;
+  name: string;
+  description: string;
+  
+  // Core specs
+  capabilities: CapabilitySpec[];
+  dataViews: DataViewSpec[];
+  workflows: WorkflowSpec[];
+  policies: PolicySpec[];
+  
+  // Required integrations
+  requiredIntegrations: {
+    integrationId: string;
+    category: IntegrationCategory;
+    purpose: string;
+    optional?: boolean;
+  }[];
+  
+  // Expected knowledge spaces
+  knowledgeSpaces: {
+    spaceId: string;
+    category: KnowledgeCategory;
+    required: boolean;
+    purpose: string;
+  }[];
+  
+  // UI/UX
+  theme: ThemeSpec;
+  overlays: OverlaySpec[];
+  
+  // Observability
+  telemetry: TelemetrySpec;
+  
+  // Schema evolution
+  migrations: MigrationSpec[];
+};`
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "TenantAppConfig"
+					}),
+					/* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground",
+						children: [
+							"The ",
+							/* @__PURE__ */ jsx("strong", { children: "TenantAppConfig" }),
+							" is the per-tenant, per-environment configuration that customizes how a specific tenant uses the app."
+						]
+					}),
+					/* @__PURE__ */ jsx(CodeBlock, {
+						language: "typescript",
+						code: `type TenantAppConfig = {
+  tenantId: string;
+  blueprintId: string;
+  blueprintVersion: string;
+  environment: "sandbox" | "staging" | "production";
+  status: "draft" | "preview" | "published" | "archived" | "superseded";
+  
+  // Integration bindings
+  integrationBindings: AppIntegrationBinding[];
+  
+  // Knowledge bindings
+  knowledgeBindings: AppKnowledgeBinding[];
+  
+  // Tenant-specific overrides
+  featureFlags: Record<string, boolean>;
+  limits: {
+    maxUsers?: number;
+    maxStorage?: number;
+    rateLimit?: number;
+  };
+  
+  // Tenant customization
+  branding: {
+    logo?: string;
+    colors?: Record<string, string>;
+    domain?: string;
+  };
+  
+  metadata: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+};`
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "AppIntegrationBinding"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Defines how a tenant connects specific integration instances to satisfy capabilities and workflows."
+					}),
+					/* @__PURE__ */ jsx(CodeBlock, {
+						language: "typescript",
+						code: `type AppIntegrationBinding = {
+  slotId: string;          // References AppIntegrationSlot.slotId
+  connectionId: string;    // References IntegrationConnection.meta.id
+  scope?: {
+    workflows?: string[];
+    operations?: string[];
+    features?: string[];
+  };
+  priority?: number;       // Lower number = higher priority
+};
+
+// Example:
+{
+  slotId: "payments.primary",
+  connectionId: "conn_stripe_acme_prod",
+  scope: {
+    workflows: ["checkout", "subscription-renewal"],
+    operations: ["payments.stripe.*"]
+  },
+  priority: 1
+}`
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "AppKnowledgeBinding"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Defines which knowledge spaces a tenant's app can access and how."
+					}),
+					/* @__PURE__ */ jsx(CodeBlock, {
+						language: "typescript",
+						code: `type AppKnowledgeBinding = {
+  spaceId: string;
+  enabled: boolean;
+  
+  // Which workflows/agents can read this space
+  allowedConsumers: {
+    workflowIds?: string[];
+    agentIds?: string[];
+    roles?: string[];
+  };
+  
+  // Category-based access control
+  allowedCategories: KnowledgeCategory[];
+  
+  // Sources feeding this space for this tenant
+  sources: string[];  // References KnowledgeSourceConfig IDs
+  
+  metadata?: Record<string, unknown>;
+};
+
+// Example:
+{
+  spaceId: "product-canon",
+  enabled: true,
+  allowedConsumers: {
+    workflowIds: ["invoice-generation", "quote-creation"],
+    agentIds: ["support-agent"]
+  },
+  allowedCategories: ["canonical", "operational"],
+  sources: ["src_notion_product_docs", "src_database_schema"]
+}`
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "ResolvedAppConfig"
+					}),
+					/* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground",
+						children: [
+							"The ",
+							/* @__PURE__ */ jsx("strong", { children: "ResolvedAppConfig" }),
+							" is the runtime result of merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand and never persisted."
+						]
+					}),
+					/* @__PURE__ */ jsx(CodeBlock, {
+						language: "typescript",
+						code: `type ResolvedAppConfig = {
+  appId: string;
+  tenantId: string;
+  blueprintName: string;
+  blueprintVersion: number;
+  environment?: string;
+  configVersion: number;
+
+  capabilities: { enabled: CapabilityRef[]; disabled: CapabilityRef[] };
+  features: { include: FeatureRef[]; exclude: FeatureRef[] };
+  dataViews: Record<string, SpecPointer>;
+  workflows: Record<string, SpecPointer>;
+  policies: PolicyRef[];
+  theme?: AppThemeBinding;
+  telemetry?: TelemetryBinding;
+  experiments: {
+    catalog: ExperimentRef[];
+    active: ExperimentRef[];
+    paused: ExperimentRef[];
+  };
+  featureFlags: FeatureFlagState[];
+  routes: AppRouteConfig[];
+
+  integrations: ResolvedIntegration[]; // [{ slot, binding, connection, spec }]
+  knowledge: ResolvedKnowledge[];       // [{ binding, space, sources }]
+  branding: ResolvedBranding;           // { appName, assets, colors, domain }
+  notes?: string;
+};`
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Configuration flow"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Here's how configuration flows from definition to runtime:"
+					}),
+					/* @__PURE__ */ jsxs("ol", {
+						className: "text-muted-foreground list-inside list-decimal space-y-3",
+						children: [
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Development" }), " - Define AppBlueprintSpec with required integrations and knowledge spaces"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Deployment" }), " - Deploy blueprint to environment (sandbox, staging, production)"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Tenant Setup" }), " - Create TenantAppConfig with specific integration connections and knowledge sources"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Runtime" }), " - Resolve configuration on-demand when tenant accesses the app"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Execution" }), " - Use ResolvedAppConfig to execute capabilities, workflows, and enforce policies"] })
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Best practices"
+				}), /* @__PURE__ */ jsxs("ul", {
+					className: "text-muted-foreground list-inside list-disc space-y-2",
+					children: [
+						/* @__PURE__ */ jsx("li", { children: "Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data" }),
+						/* @__PURE__ */ jsx("li", { children: "Use TenantAppConfig for all tenant-specific settings and connections" }),
+						/* @__PURE__ */ jsx("li", { children: "Cache ResolvedAppConfig per request to avoid repeated resolution" }),
+						/* @__PURE__ */ jsx("li", { children: "Version blueprints carefully - migrations affect all tenants" }),
+						/* @__PURE__ */ jsx("li", { children: "Test blueprint changes in sandbox before promoting to production" })
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsx(Link, {
+					href: "/docs/architecture",
+					className: "btn-ghost",
+					children: "Back to Architecture"
+				}), /* @__PURE__ */ jsxs(Link, {
+					href: "/docs/architecture/integration-binding",
+					className: "btn-primary",
+					children: ["Integration Binding ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { ArchitectureAppConfigPage };
+//# sourceMappingURL=ArchitectureAppConfigPage.js.map

package/dist/components/docs/architecture/ArchitectureAppConfigPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchitectureAppConfigPage.js","names":[],"sources":["../../../../src/components/docs/architecture/ArchitectureAppConfigPage.tsx"],"sourcesContent":["import { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport function ArchitectureAppConfigPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">App Configuration</h1>\n        <p className=\"text-muted-foreground\">\n          ContractSpec uses a three-tier configuration model that separates\n          global app definitions from tenant-specific settings and runtime\n          resolution.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">AppBlueprintSpec</h2>\n        <p className=\"text-muted-foreground\">\n          The <strong>AppBlueprintSpec</strong> is the global, versioned\n          definition of your application. It contains no tenant-specific\n          information and is stored in version control.\n        </p>\n        <CodeBlock\n          language=\"typescript\"\n          code={`type AppBlueprintSpec = {\n  id: string;\n  version: string;\n  name: string;\n  description: string;\n  \n  // Core specs\n  capabilities: CapabilitySpec[];\n  dataViews: DataViewSpec[];\n  workflows: WorkflowSpec[];\n  policies: PolicySpec[];\n  \n  // Required integrations\n  requiredIntegrations: {\n    integrationId: string;\n    category: IntegrationCategory;\n    purpose: string;\n    optional?: boolean;\n  }[];\n  \n  // Expected knowledge spaces\n  knowledgeSpaces: {\n    spaceId: string;\n    category: KnowledgeCategory;\n    required: boolean;\n    purpose: string;\n  }[];\n  \n  // UI/UX\n  theme: ThemeSpec;\n  overlays: OverlaySpec[];\n  \n  // Observability\n  telemetry: TelemetrySpec;\n  \n  // Schema evolution\n  migrations: MigrationSpec[];\n};`}\n        />\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">TenantAppConfig</h2>\n        <p className=\"text-muted-foreground\">\n          The <strong>TenantAppConfig</strong> is the per-tenant,\n          per-environment configuration that customizes how a specific tenant\n          uses the app.\n        </p>\n        <CodeBlock\n          language=\"typescript\"\n          code={`type TenantAppConfig = {\n  tenantId: string;\n  blueprintId: string;\n  blueprintVersion: string;\n  environment: \"sandbox\" | \"staging\" | \"production\";\n  status: \"draft\" | \"preview\" | \"published\" | \"archived\" | \"superseded\";\n  \n  // Integration bindings\n  integrationBindings: AppIntegrationBinding[];\n  \n  // Knowledge bindings\n  knowledgeBindings: AppKnowledgeBinding[];\n  \n  // Tenant-specific overrides\n  featureFlags: Record<string, boolean>;\n  limits: {\n    maxUsers?: number;\n    maxStorage?: number;\n    rateLimit?: number;\n  };\n  \n  // Tenant customization\n  branding: {\n    logo?: string;\n    colors?: Record<string, string>;\n    domain?: string;\n  };\n  \n  metadata: Record<string, unknown>;\n  createdAt: string;\n  updatedAt: string;\n};`}\n        />\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">AppIntegrationBinding</h2>\n        <p className=\"text-muted-foreground\">\n          Defines how a tenant connects specific integration instances to\n          satisfy capabilities and workflows.\n        </p>\n        <CodeBlock\n          language=\"typescript\"\n          code={`type AppIntegrationBinding = {\n  slotId: string;          // References AppIntegrationSlot.slotId\n  connectionId: string;    // References IntegrationConnection.meta.id\n  scope?: {\n    workflows?: string[];\n    operations?: string[];\n    features?: string[];\n  };\n  priority?: number;       // Lower number = higher priority\n};\n\n// Example:\n{\n  slotId: \"payments.primary\",\n  connectionId: \"conn_stripe_acme_prod\",\n  scope: {\n    workflows: [\"checkout\", \"subscription-renewal\"],\n    operations: [\"payments.stripe.*\"]\n  },\n  priority: 1\n}`}\n        />\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">AppKnowledgeBinding</h2>\n        <p className=\"text-muted-foreground\">\n          Defines which knowledge spaces a tenant's app can access and how.\n        </p>\n        <CodeBlock\n          language=\"typescript\"\n          code={`type AppKnowledgeBinding = {\n  spaceId: string;\n  enabled: boolean;\n  \n  // Which workflows/agents can read this space\n  allowedConsumers: {\n    workflowIds?: string[];\n    agentIds?: string[];\n    roles?: string[];\n  };\n  \n  // Category-based access control\n  allowedCategories: KnowledgeCategory[];\n  \n  // Sources feeding this space for this tenant\n  sources: string[];  // References KnowledgeSourceConfig IDs\n  \n  metadata?: Record<string, unknown>;\n};\n\n// Example:\n{\n  spaceId: \"product-canon\",\n  enabled: true,\n  allowedConsumers: {\n    workflowIds: [\"invoice-generation\", \"quote-creation\"],\n    agentIds: [\"support-agent\"]\n  },\n  allowedCategories: [\"canonical\", \"operational\"],\n  sources: [\"src_notion_product_docs\", \"src_database_schema\"]\n}`}\n        />\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">ResolvedAppConfig</h2>\n        <p className=\"text-muted-foreground\">\n          The <strong>ResolvedAppConfig</strong> is the runtime result of\n          merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand\n          and never persisted.\n        </p>\n        <CodeBlock\n          language=\"typescript\"\n          code={`type ResolvedAppConfig = {\n  appId: string;\n  tenantId: string;\n  blueprintName: string;\n  blueprintVersion: number;\n  environment?: string;\n  configVersion: number;\n\n  capabilities: { enabled: CapabilityRef[]; disabled: CapabilityRef[] };\n  features: { include: FeatureRef[]; exclude: FeatureRef[] };\n  dataViews: Record<string, SpecPointer>;\n  workflows: Record<string, SpecPointer>;\n  policies: PolicyRef[];\n  theme?: AppThemeBinding;\n  telemetry?: TelemetryBinding;\n  experiments: {\n    catalog: ExperimentRef[];\n    active: ExperimentRef[];\n    paused: ExperimentRef[];\n  };\n  featureFlags: FeatureFlagState[];\n  routes: AppRouteConfig[];\n\n  integrations: ResolvedIntegration[]; // [{ slot, binding, connection, spec }]\n  knowledge: ResolvedKnowledge[];       // [{ binding, space, sources }]\n  branding: ResolvedBranding;           // { appName, assets, colors, domain }\n  notes?: string;\n};`}\n        />\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Configuration flow</h2>\n        <p className=\"text-muted-foreground\">\n          Here's how configuration flows from definition to runtime:\n        </p>\n        <ol className=\"text-muted-foreground list-inside list-decimal space-y-3\">\n          <li>\n            <strong>Development</strong> - Define AppBlueprintSpec with required\n            integrations and knowledge spaces\n          </li>\n          <li>\n            <strong>Deployment</strong> - Deploy blueprint to environment\n            (sandbox, staging, production)\n          </li>\n          <li>\n            <strong>Tenant Setup</strong> - Create TenantAppConfig with specific\n            integration connections and knowledge sources\n          </li>\n          <li>\n            <strong>Runtime</strong> - Resolve configuration on-demand when\n            tenant accesses the app\n          </li>\n          <li>\n            <strong>Execution</strong> - Use ResolvedAppConfig to execute\n            capabilities, workflows, and enforce policies\n          </li>\n        </ol>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Best practices</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            Keep AppBlueprintSpec environment-agnostic - no secrets or\n            tenant-specific data\n          </li>\n          <li>\n            Use TenantAppConfig for all tenant-specific settings and connections\n          </li>\n          <li>\n            Cache ResolvedAppConfig per request to avoid repeated resolution\n          </li>\n          <li>Version blueprints carefully - migrations affect all tenants</li>\n          <li>\n            Test blueprint changes in sandbox before promoting to production\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/architecture\" className=\"btn-ghost\">\n          Back to Architecture\n        </Link>\n        <Link\n          href=\"/docs/architecture/integration-binding\"\n          className=\"btn-primary\"\n        >\n          Integration Binding <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;AAIA,SAAgB,4BAA4B;AAC1C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAsB,EACzD,oBAAC;KAAE,WAAU;eAAwB;MAIjC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAqB;KACxD,qBAAC;MAAE,WAAU;;OAAwB;OAC/B,oBAAC,sBAAO,qBAAyB;;;OAGnC;KACJ,oBAAC;MACC,UAAS;MACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCN;;KACE;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAoB;KACvD,qBAAC;MAAE,WAAU;;OAAwB;OAC/B,oBAAC,sBAAO,oBAAwB;;;OAGlC;KACJ,oBAAC;MACC,UAAS;MACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCN;;KACE;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAA0B;KAC7D,oBAAC;MAAE,WAAU;gBAAwB;OAGjC;KACJ,oBAAC;MACC,UAAS;MACT,MAAM;;;;;;;;;;;;;;;;;;;;;OAqBN;;KACE;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAwB;KAC3D,oBAAC;MAAE,WAAU;gBAAwB;OAEjC;KACJ,oBAAC;MACC,UAAS;MACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BN;;KACE;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAsB;KACzD,qBAAC;MAAE,WAAU;;OAAwB;OAC/B,oBAAC,sBAAO,sBAA0B;;;OAGpC;KACJ,oBAAC;MACC,UAAS;MACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BN;;KACE;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAuB;KAC1D,oBAAC;MAAE,WAAU;gBAAwB;OAEjC;KACJ,qBAAC;MAAG,WAAU;;OACZ,qBAAC,mBACC,oBAAC,sBAAO,gBAAoB,kFAEzB;OACL,qBAAC,mBACC,oBAAC,sBAAO,eAAmB,yEAExB;OACL,qBAAC,mBACC,oBAAC,sBAAO,iBAAqB,6FAE1B;OACL,qBAAC,mBACC,oBAAC,sBAAO,YAAgB,uEAErB;OACL,qBAAC,mBACC,oBAAC,sBAAO,cAAkB,yFAEvB;;OACF;;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAmB,EACtD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,oFAGC;MACL,oBAAC,kBAAG,yEAEC;MACL,oBAAC,kBAAG,qEAEC;MACL,oBAAC,kBAAG,iEAAiE;MACrE,oBAAC,kBAAG,qEAEC;;MACF;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAAqB,WAAU;eAAY;MAE/C,EACP,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,wBACqB,oBAAC,gBAAa,MAAM,KAAM;MACzC;KACH;;GACF"}

package/dist/components/docs/architecture/ArchitectureIntegrationBindingPage.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/architecture/ArchitectureIntegrationBindingPage.d.ts
+declare function ArchitectureIntegrationBindingPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ArchitectureIntegrationBindingPage };
+//# sourceMappingURL=ArchitectureIntegrationBindingPage.d.ts.map

package/dist/components/docs/architecture/ArchitectureIntegrationBindingPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchitectureIntegrationBindingPage.d.ts","names":[],"sources":["../../../../src/components/docs/architecture/ArchitectureIntegrationBindingPage.tsx"],"mappings":";;;iBAIgB,kCAAA,CAAA,GAAkC,kBAAA,CAAA,GAAA,CAAA,OAAA"}