@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/components/docs/manifesto/ManifestoPage.js

@@ -0,0 +1,185 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/docs/manifesto/ManifestoPage.tsx
+function ManifestoPage() {
+	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: "Manifesto"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: "ContractSpec is the deterministic, spec-first compiler that keeps AI-written software coherent, safe, and regenerable. We're building the safety layer for AI-coded systems."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-6",
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Compiler, not prison"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "ContractSpec is a tool in your toolchain, not a platform you're locked into. Like TypeScript compiles to JavaScript, ContractSpec compiles specs to standard code. The generated output is yours—readable, modifiable, and ejectable at any time."
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "We believe developers should own their code. There's no proprietary runtime, no vendor-specific abstractions, no magic that hides complexity. You can always see what ContractSpec generates, understand it, and take it with you if you leave."
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Standard tech, no magic"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "Everything ContractSpec generates uses technology you already know: TypeScript, Zod, Prisma, GraphQL, REST, React. There's no new language to learn, no YAML configuration hell, no DSL that only works in our ecosystem."
+							}),
+							/* @__PURE__ */ jsxs("p", {
+								className: "text-muted-foreground",
+								children: [
+									"Specs are just TypeScript. If you can write",
+									" ",
+									/* @__PURE__ */ jsxs("code", {
+										className: "rounded bg-violet-500/10 px-1.5 py-0.5 text-sm",
+										children: [
+											"z.object(",
+											"{",
+											" name: z.string() ",
+											"}",
+											")"
+										]
+									}),
+									", you can write a ContractSpec. Your existing skills transfer directly."
+								]
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Incremental adoption"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "You don't rewrite your app to use ContractSpec. You stabilize one module at a time. Start with a single API endpoint, a single data model, a single contract. See the value. Expand gradually."
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "This isn't a big-bang migration. It's a safety layer you add incrementally to existing AI-generated chaos. No pressure. No deadlines. Your pace."
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "AI governance"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "In 2025, AI agents generate enormous amounts of code. But they can't enforce invariants, they break multi-surface consistency, and they hallucinate refactors. The result is code that's hard to maintain and dangerous to trust."
+							}),
+							/* @__PURE__ */ jsxs("p", {
+								className: "text-muted-foreground",
+								children: [
+									"ContractSpec provides the governance layer. Contracts define what the system ",
+									/* @__PURE__ */ jsx("em", { children: "should" }),
+									" do. AI agents read specs, not implementations. Code that violates contracts gets flagged and rejected before it can cause damage."
+								]
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Multi-surface consistency"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "One spec generates API endpoints, database schemas, UI types, event definitions, and MCP tools. All surfaces stay in sync because they share the same source of truth."
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "No more chasing drift between your API and your database. No more frontend types that don't match backend contracts. One change to the spec, all surfaces update consistently."
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Safe regeneration"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "You can regenerate code at any time without fear. Specs enforce invariants. Breaking changes are caught at compile time, not in production. Roll back to any previous version with confidence."
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "This is the promise of spec-first development: the code is derived from the spec, so regenerating it is always safe. No more \"don't touch that file\" warnings. No more fear of AI-generated spaghetti."
+							})
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Join us"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "We're building the safety layer for AI-coded systems. If you believe developers should own their code, that AI needs governance, and that standard tech beats proprietary magic—we'd love to have you."
+					}),
+					/* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground",
+						children: [
+							"You keep your app. We stabilize it, one module at a time. You own the code. It's standard tech.",
+							" ",
+							/* @__PURE__ */ jsx("span", {
+								className: "font-semibold text-violet-400",
+								children: "We're the compiler, not the prison."
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex flex-wrap gap-4 pt-4",
+						children: [/* @__PURE__ */ jsx("a", {
+							href: "/install",
+							className: "btn-primary",
+							children: "Install OSS Core"
+						}), /* @__PURE__ */ jsx("a", {
+							href: "/contact#waitlist",
+							className: "btn-ghost",
+							children: "Join Studio Waitlist"
+						})]
+					})
+				]
+			})
+		]
+	});
+}
+
+//#endregion
+export { ManifestoPage };
+//# sourceMappingURL=ManifestoPage.js.map

package/dist/components/docs/manifesto/ManifestoPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestoPage.js","names":[],"sources":["../../../../src/components/docs/manifesto/ManifestoPage.tsx"],"sourcesContent":["// export const metadata = {\n//   title: 'Manifesto: ContractSpec',\n//   description:\n//     'Our philosophy: compiler not prison, no lock-in, standard tech, incremental adoption, AI governance.',\n// };\n\nexport function ManifestoPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Manifesto</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          ContractSpec is the deterministic, spec-first compiler that keeps\n          AI-written software coherent, safe, and regenerable. We're building\n          the safety layer for AI-coded systems.\n        </p>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Compiler, not prison</h2>\n          <p className=\"text-muted-foreground\">\n            ContractSpec is a tool in your toolchain, not a platform you're\n            locked into. Like TypeScript compiles to JavaScript, ContractSpec\n            compiles specs to standard code. The generated output is\n            yours—readable, modifiable, and ejectable at any time.\n          </p>\n          <p className=\"text-muted-foreground\">\n            We believe developers should own their code. There's no proprietary\n            runtime, no vendor-specific abstractions, no magic that hides\n            complexity. You can always see what ContractSpec generates,\n            understand it, and take it with you if you leave.\n          </p>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Standard tech, no magic</h2>\n          <p className=\"text-muted-foreground\">\n            Everything ContractSpec generates uses technology you already know:\n            TypeScript, Zod, Prisma, GraphQL, REST, React. There's no new\n            language to learn, no YAML configuration hell, no DSL that only\n            works in our ecosystem.\n          </p>\n          <p className=\"text-muted-foreground\">\n            Specs are just TypeScript. If you can write{' '}\n            <code className=\"rounded bg-violet-500/10 px-1.5 py-0.5 text-sm\">\n              z.object({'{'} name: z.string() {'}'})\n            </code>\n            , you can write a ContractSpec. Your existing skills transfer\n            directly.\n          </p>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Incremental adoption</h2>\n          <p className=\"text-muted-foreground\">\n            You don't rewrite your app to use ContractSpec. You stabilize one\n            module at a time. Start with a single API endpoint, a single data\n            model, a single contract. See the value. Expand gradually.\n          </p>\n          <p className=\"text-muted-foreground\">\n            This isn't a big-bang migration. It's a safety layer you add\n            incrementally to existing AI-generated chaos. No pressure. No\n            deadlines. Your pace.\n          </p>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">AI governance</h2>\n          <p className=\"text-muted-foreground\">\n            In 2025, AI agents generate enormous amounts of code. But they can't\n            enforce invariants, they break multi-surface consistency, and they\n            hallucinate refactors. The result is code that's hard to maintain\n            and dangerous to trust.\n          </p>\n          <p className=\"text-muted-foreground\">\n            ContractSpec provides the governance layer. Contracts define what\n            the system <em>should</em> do. AI agents read specs, not\n            implementations. Code that violates contracts gets flagged and\n            rejected before it can cause damage.\n          </p>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Multi-surface consistency</h2>\n          <p className=\"text-muted-foreground\">\n            One spec generates API endpoints, database schemas, UI types, event\n            definitions, and MCP tools. All surfaces stay in sync because they\n            share the same source of truth.\n          </p>\n          <p className=\"text-muted-foreground\">\n            No more chasing drift between your API and your database. No more\n            frontend types that don't match backend contracts. One change to the\n            spec, all surfaces update consistently.\n          </p>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Safe regeneration</h2>\n          <p className=\"text-muted-foreground\">\n            You can regenerate code at any time without fear. Specs enforce\n            invariants. Breaking changes are caught at compile time, not in\n            production. Roll back to any previous version with confidence.\n          </p>\n          <p className=\"text-muted-foreground\">\n            This is the promise of spec-first development: the code is derived\n            from the spec, so regenerating it is always safe. No more \"don't\n            touch that file\" warnings. No more fear of AI-generated spaghetti.\n          </p>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Join us</h2>\n        <p className=\"text-muted-foreground\">\n          We're building the safety layer for AI-coded systems. If you believe\n          developers should own their code, that AI needs governance, and that\n          standard tech beats proprietary magic—we'd love to have you.\n        </p>\n        <p className=\"text-muted-foreground\">\n          You keep your app. We stabilize it, one module at a time. You own the\n          code. It's standard tech.{' '}\n          <span className=\"font-semibold text-violet-400\">\n            We're the compiler, not the prison.\n          </span>\n        </p>\n        <div className=\"flex flex-wrap gap-4 pt-4\">\n          <a href=\"/install\" className=\"btn-primary\">\n            Install OSS Core\n          </a>\n          <a href=\"/contact#waitlist\" className=\"btn-ghost\">\n            Join Studio Waitlist\n          </a>\n        </div>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;AAMA,SAAgB,gBAAgB;AAC9B,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAc,EACjD,oBAAC;KAAE,WAAU;eAAgC;MAIzC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAyB;OAC5D,oBAAC;QAAE,WAAU;kBAAwB;SAKjC;OACJ,oBAAC;QAAE,WAAU;kBAAwB;SAKjC;;OACA;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA4B;OAC/D,oBAAC;QAAE,WAAU;kBAAwB;SAKjC;OACJ,qBAAC;QAAE,WAAU;;SAAwB;SACS;SAC5C,qBAAC;UAAK,WAAU;;WAAiD;WACrD;WAAI;WAAmB;WAAI;;WAChC;;;SAGL;;OACA;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAyB;OAC5D,oBAAC;QAAE,WAAU;kBAAwB;SAIjC;OACJ,oBAAC;QAAE,WAAU;kBAAwB;SAIjC;;OACA;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAkB;OACrD,oBAAC;QAAE,WAAU;kBAAwB;SAKjC;OACJ,qBAAC;QAAE,WAAU;;SAAwB;SAExB,oBAAC,kBAAG,WAAW;;;SAGxB;;OACA;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA8B;OACjE,oBAAC;QAAE,WAAU;kBAAwB;SAIjC;OACJ,oBAAC;QAAE,WAAU;kBAAwB;SAIjC;;OACA;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAsB;OACzD,oBAAC;QAAE,WAAU;kBAAwB;SAIjC;OACJ,oBAAC;QAAE,WAAU;kBAAwB;SAIjC;;OACA;;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAY;KAC/C,oBAAC;MAAE,WAAU;gBAAwB;OAIjC;KACJ,qBAAC;MAAE,WAAU;;OAAwB;OAET;OAC1B,oBAAC;QAAK,WAAU;kBAAgC;SAEzC;;OACL;KACJ,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAE,MAAK;OAAW,WAAU;iBAAc;QAEvC,EACJ,oBAAC;OAAE,MAAK;OAAoB,WAAU;iBAAY;QAE9C;OACA;;KACF;;GACF"}

package/dist/components/docs/ops/AutoEvolutionOpsPage.d.ts

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

package/dist/components/docs/ops/AutoEvolutionOpsPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoEvolutionOpsPage.d.ts","names":[],"sources":["../../../../src/components/docs/ops/AutoEvolutionOpsPage.tsx"],"mappings":";;;iBAMgB,oBAAA,CAAA,GAAoB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/ops/AutoEvolutionOpsPage.js

@@ -0,0 +1,104 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/docs/ops/AutoEvolutionOpsPage.tsx
+function OpsAutoEvolutionPage() {
+	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: "Auto-Evolution Runbook"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: "Configure sampling, approvals, experiments, and golden tests so your app keeps improving without regressions."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-3",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Pipeline overview"
+				}), /* @__PURE__ */ jsxs("ol", {
+					className: "text-muted-foreground list-decimal space-y-2 pl-6 text-sm",
+					children: [
+						/* @__PURE__ */ jsx("li", { children: "Tracing middleware emits telemetry samples with tenant/user context." }),
+						/* @__PURE__ */ jsx("li", { children: "IntentAggregator batches samples (15m window, configurable)." }),
+						/* @__PURE__ */ jsx("li", { children: "IntentDetector raises error/latency/throughput signals." }),
+						/* @__PURE__ */ jsx("li", { children: "SpecGenerator produces proposals with confidence scores." }),
+						/* @__PURE__ */ jsx("li", { children: "ApprovalWorkflow routes low-confidence suggestions to humans." }),
+						/* @__PURE__ */ jsx("li", { children: "SpecExperimentRegistry rolls out approved variants using guardrails." }),
+						/* @__PURE__ */ jsx("li", { children: "TrafficRecorder captures new traffic and GoldenTestGenerator outputs suites." })
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-3",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Key environment variables"
+				}), /* @__PURE__ */ jsx("pre", {
+					className: "bg-muted rounded-lg border p-4 text-sm",
+					children: `# Telemetry sampling
+AUTO_EVOLUTION_SAMPLE_RATE=0.02
+AUTO_EVOLUTION_WINDOW_MS=900000
+
+# Suggestion thresholds
+AUTO_EVOLUTION_MIN_CONFIDENCE=0.55
+AUTO_EVOLUTION_AUTO_APPROVE=0.2
+
+# Guardrails (fallback defaults)
+AUTO_EVOLUTION_MAX_ERROR_RATE=0.02
+AUTO_EVOLUTION_MAX_P99_MS=500`
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-3",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Operations checklist"
+				}), /* @__PURE__ */ jsxs("ul", {
+					className: "text-muted-foreground list-disc space-y-2 pl-6 text-sm",
+					children: [
+						/* @__PURE__ */ jsx("li", { children: "Review new `SpecSuggestion` records every morning (UI coming soon; Prisma view today)." }),
+						/* @__PURE__ */ jsx("li", { children: "Keep at least one reviewer per domain on-call for approvals." }),
+						/* @__PURE__ */ jsx("li", { children: "Attach `SpecExperimentAdapter.trackOutcome` to every runtime adapter." }),
+						/* @__PURE__ */ jsx("li", { children: "Schedule `contractspec test generate` nightly (or on deploy) to refresh golden suites." }),
+						/* @__PURE__ */ jsx("li", { children: "Feed `runGoldenTests` into CI to gate merges touching evolved specs." })
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "grid gap-4 md:grid-cols-3",
+				children: [
+					{
+						title: "Sampling",
+						description: "Start at 1–2% of traffic. Increase only after sanitization is verified."
+					},
+					{
+						title: "Approvals",
+						description: "High-risk ops (money, compliance) should never auto-approve. Use ApprovalWorkflow notes for audit."
+					},
+					{
+						title: "On-call alerts",
+						description: "Tie SpecExperimentController rollbacks into PagerDuty/Slack so engineers see guardrail trips immediately."
+					}
+				].map((card) => /* @__PURE__ */ jsxs("div", {
+					className: "card-subtle space-y-2 p-4",
+					children: [/* @__PURE__ */ jsx("h3", {
+						className: "text-lg font-semibold",
+						children: card.title
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground text-sm",
+						children: card.description
+					})]
+				}, card.title))
+			})
+		]
+	});
+}
+
+//#endregion
+export { OpsAutoEvolutionPage };
+//# sourceMappingURL=AutoEvolutionOpsPage.js.map

package/dist/components/docs/ops/AutoEvolutionOpsPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoEvolutionOpsPage.js","names":[],"sources":["../../../../src/components/docs/ops/AutoEvolutionOpsPage.tsx"],"sourcesContent":["// export const metadata: Metadata = {\n//   title: 'Auto-Evolution Runbook | ContractSpec',\n//   description:\n//     'Operate the telemetry → intent → spec pipeline with guardrails and approvals.',\n// };\n\nexport function OpsAutoEvolutionPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Auto-Evolution Runbook</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          Configure sampling, approvals, experiments, and golden tests so your\n          app keeps improving without regressions.\n        </p>\n      </div>\n\n      <div className=\"space-y-3\">\n        <h2 className=\"text-2xl font-bold\">Pipeline overview</h2>\n        <ol className=\"text-muted-foreground list-decimal space-y-2 pl-6 text-sm\">\n          <li>\n            Tracing middleware emits telemetry samples with tenant/user context.\n          </li>\n          <li>IntentAggregator batches samples (15m window, configurable).</li>\n          <li>IntentDetector raises error/latency/throughput signals.</li>\n          <li>SpecGenerator produces proposals with confidence scores.</li>\n          <li>ApprovalWorkflow routes low-confidence suggestions to humans.</li>\n          <li>\n            SpecExperimentRegistry rolls out approved variants using guardrails.\n          </li>\n          <li>\n            TrafficRecorder captures new traffic and GoldenTestGenerator outputs\n            suites.\n          </li>\n        </ol>\n      </div>\n\n      <div className=\"space-y-3\">\n        <h2 className=\"text-2xl font-bold\">Key environment variables</h2>\n        <pre className=\"bg-muted rounded-lg border p-4 text-sm\">\n          {`# Telemetry sampling\nAUTO_EVOLUTION_SAMPLE_RATE=0.02\nAUTO_EVOLUTION_WINDOW_MS=900000\n\n# Suggestion thresholds\nAUTO_EVOLUTION_MIN_CONFIDENCE=0.55\nAUTO_EVOLUTION_AUTO_APPROVE=0.2\n\n# Guardrails (fallback defaults)\nAUTO_EVOLUTION_MAX_ERROR_RATE=0.02\nAUTO_EVOLUTION_MAX_P99_MS=500`}\n        </pre>\n      </div>\n\n      <div className=\"space-y-3\">\n        <h2 className=\"text-2xl font-bold\">Operations checklist</h2>\n        <ul className=\"text-muted-foreground list-disc space-y-2 pl-6 text-sm\">\n          <li>\n            Review new `SpecSuggestion` records every morning (UI coming soon;\n            Prisma view today).\n          </li>\n          <li>Keep at least one reviewer per domain on-call for approvals.</li>\n          <li>\n            Attach `SpecExperimentAdapter.trackOutcome` to every runtime\n            adapter.\n          </li>\n          <li>\n            Schedule `contractspec test generate` nightly (or on deploy) to\n            refresh golden suites.\n          </li>\n          <li>\n            Feed `runGoldenTests` into CI to gate merges touching evolved specs.\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"grid gap-4 md:grid-cols-3\">\n        {[\n          {\n            title: 'Sampling',\n            description:\n              'Start at 1–2% of traffic. Increase only after sanitization is verified.',\n          },\n          {\n            title: 'Approvals',\n            description:\n              'High-risk ops (money, compliance) should never auto-approve. Use ApprovalWorkflow notes for audit.',\n          },\n          {\n            title: 'On-call alerts',\n            description:\n              'Tie SpecExperimentController rollbacks into PagerDuty/Slack so engineers see guardrail trips immediately.',\n          },\n        ].map((card) => (\n          <div key={card.title} className=\"card-subtle space-y-2 p-4\">\n            <h3 className=\"text-lg font-semibold\">{card.title}</h3>\n            <p className=\"text-muted-foreground text-sm\">{card.description}</p>\n          </div>\n        ))}\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;AAMA,SAAgB,uBAAuB;AACrC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA2B,EAC9D,oBAAC;KAAE,WAAU;eAAgC;MAGzC;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAsB,EACzD,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,yEAEC;MACL,oBAAC,kBAAG,iEAAiE;MACrE,oBAAC,kBAAG,4DAA4D;MAChE,oBAAC,kBAAG,6DAA6D;MACjE,oBAAC,kBAAG,kEAAkE;MACtE,oBAAC,kBAAG,yEAEC;MACL,oBAAC,kBAAG,iFAGC;;MACF;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA8B,EACjE,oBAAC;KAAI,WAAU;eACZ;;;;;;;;;;;MAWG;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAyB,EAC5D,qBAAC;KAAG,WAAU;;MACZ,oBAAC,kBAAG,2FAGC;MACL,oBAAC,kBAAG,iEAAiE;MACrE,oBAAC,kBAAG,0EAGC;MACL,oBAAC,kBAAG,2FAGC;MACL,oBAAC,kBAAG,yEAEC;;MACF;KACD;GAEN,oBAAC;IAAI,WAAU;cACZ;KACC;MACE,OAAO;MACP,aACE;MACH;KACD;MACE,OAAO;MACP,aACE;MACH;KACD;MACE,OAAO;MACP,aACE;MACH;KACF,CAAC,KAAK,SACL,qBAAC;KAAqB,WAAU;gBAC9B,oBAAC;MAAG,WAAU;gBAAyB,KAAK;OAAW,EACvD,oBAAC;MAAE,WAAU;gBAAiC,KAAK;OAAgB;OAF3D,KAAK,MAGT,CACN;KACE;;GACF"}

package/dist/components/docs/ops/DistributedTracingOpsPage.d.ts

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

package/dist/components/docs/ops/DistributedTracingOpsPage.d.ts.map

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

package/dist/components/docs/ops/DistributedTracingOpsPage.js

@@ -0,0 +1,60 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/docs/ops/DistributedTracingOpsPage.tsx
+function OpsDistributedTracingPage() {
+	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: "Distributed Tracing"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: "ContractSpec uses OpenTelemetry (OTel) for distributed tracing. This guide explains how to configure exporters and collectors."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Configuration"
+					}),
+					/* @__PURE__ */ jsx("p", { children: "Configure the OTel SDK via environment variables:" }),
+					/* @__PURE__ */ jsx("pre", {
+						className: "bg-muted rounded-lg border p-4 text-sm",
+						children: `OTEL_SERVICE_NAME=my-service
+OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
+OTEL_TRACES_SAMPLER=parentbased_traceidratio
+OTEL_TRACES_SAMPLER_ARG=0.1`
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Exporters"
+					}),
+					/* @__PURE__ */ jsx("p", { children: "By default, the OTLP exporter is used. You can point it to:" }),
+					/* @__PURE__ */ jsxs("ul", {
+						className: "list-disc space-y-2 pl-6",
+						children: [
+							/* @__PURE__ */ jsx("li", { children: "Jaeger" }),
+							/* @__PURE__ */ jsx("li", { children: "Tempo (Grafana)" }),
+							/* @__PURE__ */ jsx("li", { children: "Honeycomb" }),
+							/* @__PURE__ */ jsx("li", { children: "Datadog (via OTel Collector)" })
+						]
+					})
+				]
+			})
+		]
+	});
+}
+
+//#endregion
+export { OpsDistributedTracingPage };
+//# sourceMappingURL=DistributedTracingOpsPage.js.map

package/dist/components/docs/ops/DistributedTracingOpsPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DistributedTracingOpsPage.js","names":[],"sources":["../../../../src/components/docs/ops/DistributedTracingOpsPage.tsx"],"sourcesContent":["// export const metadata: Metadata = {\n//   title: 'Distributed Tracing Operations | ContractSpec',\n//   description: 'Running and configuring distributed tracing in production.',\n// };\n\nexport function OpsDistributedTracingPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Distributed Tracing</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          ContractSpec uses OpenTelemetry (OTel) for distributed tracing. This\n          guide explains how to configure exporters and collectors.\n        </p>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Configuration</h2>\n        <p>Configure the OTel SDK via environment variables:</p>\n        <pre className=\"bg-muted rounded-lg border p-4 text-sm\">\n          {`OTEL_SERVICE_NAME=my-service\nOTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318\nOTEL_TRACES_SAMPLER=parentbased_traceidratio\nOTEL_TRACES_SAMPLER_ARG=0.1`}\n        </pre>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Exporters</h2>\n        <p>By default, the OTLP exporter is used. You can point it to:</p>\n        <ul className=\"list-disc space-y-2 pl-6\">\n          <li>Jaeger</li>\n          <li>Tempo (Grafana)</li>\n          <li>Honeycomb</li>\n          <li>Datadog (via OTel Collector)</li>\n        </ul>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;AAKA,SAAgB,4BAA4B;AAC1C,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;OAAkB;KACrD,oBAAC,iBAAE,sDAAqD;KACxD,oBAAC;MAAI,WAAU;gBACZ;;;;OAIG;;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAG,WAAU;gBAAqB;OAAc;KACjD,oBAAC,iBAAE,gEAA+D;KAClE,qBAAC;MAAG,WAAU;;OACZ,oBAAC,kBAAG,WAAW;OACf,oBAAC,kBAAG,oBAAoB;OACxB,oBAAC,kBAAG,cAAc;OAClB,oBAAC,kBAAG,iCAAiC;;OAClC;;KACD;;GACF"}

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

@@ -0,0 +1,3 @@
+import { OpsAutoEvolutionPage } from "./AutoEvolutionOpsPage.js";
+import { OpsDistributedTracingPage } from "./DistributedTracingOpsPage.js";
+export { OpsAutoEvolutionPage, OpsDistributedTracingPage };

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

@@ -0,0 +1,4 @@
+import { OpsAutoEvolutionPage } from "./AutoEvolutionOpsPage.js";
+import { OpsDistributedTracingPage } from "./DistributedTracingOpsPage.js";
+
+export { OpsAutoEvolutionPage, OpsDistributedTracingPage };

package/dist/components/docs/ops/ops-lifecycle.docblocks.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/components/docs/ops/ops-lifecycle.docblocks.d.ts
+declare const opsLifecycleDocs: DocBlock[];
+//#endregion
+export { opsLifecycleDocs };
+//# sourceMappingURL=ops-lifecycle.docblocks.d.ts.map

package/dist/components/docs/ops/ops-lifecycle.docblocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-lifecycle.docblocks.d.ts","names":[],"sources":["../../../../src/components/docs/ops/ops-lifecycle.docblocks.ts"],"mappings":";;;cAEa,gBAAA,EAAkB,QAAA"}

package/dist/components/docs/ops/ops-lifecycle.docblocks.js

@@ -0,0 +1,152 @@
+//#region src/components/docs/ops/ops-lifecycle.docblocks.ts
+const opsLifecycleDocs = [
+	{
+		id: "docs.ops.lifecycle-operations.goal",
+		title: "Lifecycle operations goal",
+		summary: "Keep managed lifecycle assessments timely, auditable, and low-risk per tenant.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/ops/lifecycle-operations/goal",
+		tags: ["ops", "lifecycle"],
+		body: "Operate lifecycle assessments with predictable cadence, clear observability, and reversible customizations so tenants stay aligned to milestones without risking data access."
+	},
+	{
+		id: "docs.ops.lifecycle-operations.usage",
+		title: "Lifecycle operations usage guide",
+		summary: "Quick checklist for running lifecycle managed ops.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/ops/lifecycle-operations/usage",
+		tags: ["ops", "lifecycle"],
+		body: `- Run weekly auto-refresh per tenant; allow manual reruns behind \`LIFECYCLE_DETECTION_ALPHA\`.
+- Publish top 3 actions + milestone checklist to Studio UI; emit lifecycle events.
+- Monitor P95 < 500ms; alert on confidence < 0.5 or stage churn.
+- Version overrides (weights, milestones, playbooks); never edit compiled JS.
+- Log incidents for detection gaps or bad recommendations; gate ceremony output via flag if broken.`
+	},
+	{
+		id: "docs.ops.lifecycle-operations.how",
+		title: "Lifecycle operations runbook",
+		summary: "Full runbook for lifecycle assessments, customization, and alerts.",
+		kind: "how",
+		visibility: "public",
+		route: "/docs/ops/lifecycle-operations/how",
+		tags: ["ops", "lifecycle"],
+		body: `## Lifecycle Operations Runbook (ContractSpec Managed)
+
+This runbook guides ContractSpec operators who run the lifecycle managed service (bundle + Studio surfaces). It focuses on cadence, monitoring, customization, and escalation without touching tenant-specific databases.
+
+---
+
+### 1. Responsibilities
+
+1. **Assessment Cadence**
+   - Default: weekly auto-refresh per tenant (using latest telemetry + questionnaires).
+   - Manual rerun allowed any time via Studio admin (flag \`LIFECYCLE_DETECTION_ALPHA\` must be on).
+2. **Guidance Delivery**
+   - Publish top 3 recommended actions + milestone checklist to Studio UI.
+   - Trigger ceremony payload when stage changes (Stage N → N+1 or N-1).
+3. **Observability**
+   - Ensure lifecycle events hit analytics pipeline (\`lifecycle_assessment_run\`, \`lifecycle_stage_changed\`, \`lifecycle_guidance_consumed\`).
+   - Monitor error budget for orchestrator runtime (<500ms P95 on synthetic data).
+
+---
+
+### 2. Operational Flow
+
+1. **Collect Signals**
+   - Kick \`StageSignalCollector\` with adapters:
+     - Analytics adapter pulls synthetic/aggregated metrics (no raw tenant data).
+     - Questionnaire adapter reads stored JSON answers (per customer).
+     - Intent adapter listens to observability events (optional).
+2. **Score & Assess**
+   - \`LifecycleOrchestrator\` returns \`LifecycleAssessment\` + confidence.
+   - Persist assessment snapshot via Studio storage abstraction (file or KV).
+3. **Generate Guidance**
+   - \`LifecycleRecommendationEngine\` + \`LifecycleCeremonyDesigner\`.
+   - Queue AI advisor agent call if \`LIFECYCLE_ADVISOR_ALPHA\` enabled.
+4. **Publish**
+   - Update Studio dashboard caches.
+   - Emit lifecycle events.
+   - Notify support (Slack/Webhook) when confidence < 0.5 or stage regresses.
+
+---
+
+### 3. Customization Guide
+
+| What | How | Notes |
+| --- | --- | --- |
+| Stage weights | Update \`modules/lifecycle-core/configs/stage-weights.json\` via bundle config layer | Keep doc changes in sync; re-run unit tests |
+| Milestones | Edit \`milestones-catalog.json\`, re-run CLI fixtures | Do not remove IDs used in history |
+| Playbooks / ceremonies | Update \`modules/lifecycle-advisor/src/data/*.json\` | Provide localized copy if required |
+| Feature flags | Toggle via progressive-delivery library (per tenant) | Document rationale and expiration date |
+
+All overrides must be versioned; operators should never edit compiled JS.
+
+---
+
+### 4. Monitoring & Alerts
+
+- **Dashboards** (Grafana or equivalent):
+  - Stage distribution (per tenant / aggregated)
+  - Assessment latency (trigger → completion)
+  - Adoption metrics (guidance consumed events)
+- **Alerts**:
+  - \`LifecycleAssessmentFailed\` (error > 3 in 5m)
+  - \`LifecycleConfidenceLow\` (confidence < 0.4 for 2 consecutive runs)
+  - \`LifecycleStageChurn\` (stage oscillates >2 times in 7 days)
+
+Alert recipients: lifecycle ops squad + product owner.
+
+---
+
+### 5. Escalation Playbook
+
+1. **Detection gap** (signals missing):
+   - Check analytics adapter health.
+   - Fall back to questionnaire-only mode.
+   - Log incident in lifecycle ops channel.
+2. **Inaccurate recommendation**:
+   - Capture assessment payload + manual notes.
+   - File issue referencing \`LifecycleRecommendationEngine\`.
+   - Update playbook JSON + add regression test.
+3. **Ceremony assets broken**:
+   - Disable \`LifecycleCeremonyDesigner\` output via feature flag.
+   - Notify design systems to refresh assets.
+
+---
+
+### 6. Data Handling
+
+- Managed bundle uses Studio storage; no direct access to tenant DBs.
+- Retain last 10 assessments per tenant for comparison (configurable).
+- Delete assessments on tenant request (flag \`lifecycle_data_retention_days\`).
+- Questionnaire answers treated as customer data; store encrypted if possible.
+
+---
+
+### 7. Run / Maintenance Tasks
+
+| Task | Cadence | Owner |
+| --- | --- | --- |
+| Review staged weight adjustments | Monthly | Lifecycle PM + Ops |
+| Refresh milestone catalog with new learnings | Quarterly | Lifecycle strategist |
+| Validate CLI + dashboard examples still work | Release cycle | DevRel |
+| Audit analytics events coverage | Monthly | Data team |
+
+---
+
+### 8. Tooling References
+
+- \`packages/bundles/lifecycle-managed/\` for managed runtime code.
+- \`packages/modules/lifecycle-core/\` for detection logic.
+- \`packages/modules/lifecycle-advisor/\` for playbooks and ceremonies.
+- Progressive delivery config for lifecycle feature flags.
+
+Maintain this runbook alongside code changes; every bundle release must document operational impact and flag defaults.`
+	}
+];
+
+//#endregion
+export { opsLifecycleDocs };
+//# sourceMappingURL=ops-lifecycle.docblocks.js.map

package/dist/components/docs/ops/ops-lifecycle.docblocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-lifecycle.docblocks.js","names":[],"sources":["../../../../src/components/docs/ops/ops-lifecycle.docblocks.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\n\nexport const opsLifecycleDocs: DocBlock[] = [\n  {\n    id: 'docs.ops.lifecycle-operations.goal',\n    title: 'Lifecycle operations goal',\n    summary:\n      'Keep managed lifecycle assessments timely, auditable, and low-risk per tenant.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/ops/lifecycle-operations/goal',\n    tags: ['ops', 'lifecycle'],\n    body: 'Operate lifecycle assessments with predictable cadence, clear observability, and reversible customizations so tenants stay aligned to milestones without risking data access.',\n  },\n  {\n    id: 'docs.ops.lifecycle-operations.usage',\n    title: 'Lifecycle operations usage guide',\n    summary: 'Quick checklist for running lifecycle managed ops.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/ops/lifecycle-operations/usage',\n    tags: ['ops', 'lifecycle'],\n    body: `- Run weekly auto-refresh per tenant; allow manual reruns behind \\`LIFECYCLE_DETECTION_ALPHA\\`.\n- Publish top 3 actions + milestone checklist to Studio UI; emit lifecycle events.\n- Monitor P95 < 500ms; alert on confidence < 0.5 or stage churn.\n- Version overrides (weights, milestones, playbooks); never edit compiled JS.\n- Log incidents for detection gaps or bad recommendations; gate ceremony output via flag if broken.`,\n  },\n  {\n    id: 'docs.ops.lifecycle-operations.how',\n    title: 'Lifecycle operations runbook',\n    summary:\n      'Full runbook for lifecycle assessments, customization, and alerts.',\n    kind: 'how',\n    visibility: 'public',\n    route: '/docs/ops/lifecycle-operations/how',\n    tags: ['ops', 'lifecycle'],\n    body: `## Lifecycle Operations Runbook (ContractSpec Managed)\n\nThis runbook guides ContractSpec operators who run the lifecycle managed service (bundle + Studio surfaces). It focuses on cadence, monitoring, customization, and escalation without touching tenant-specific databases.\n\n---\n\n### 1. Responsibilities\n\n1. **Assessment Cadence**\n   - Default: weekly auto-refresh per tenant (using latest telemetry + questionnaires).\n   - Manual rerun allowed any time via Studio admin (flag \\`LIFECYCLE_DETECTION_ALPHA\\` must be on).\n2. **Guidance Delivery**\n   - Publish top 3 recommended actions + milestone checklist to Studio UI.\n   - Trigger ceremony payload when stage changes (Stage N → N+1 or N-1).\n3. **Observability**\n   - Ensure lifecycle events hit analytics pipeline (\\`lifecycle_assessment_run\\`, \\`lifecycle_stage_changed\\`, \\`lifecycle_guidance_consumed\\`).\n   - Monitor error budget for orchestrator runtime (<500ms P95 on synthetic data).\n\n---\n\n### 2. Operational Flow\n\n1. **Collect Signals**\n   - Kick \\`StageSignalCollector\\` with adapters:\n     - Analytics adapter pulls synthetic/aggregated metrics (no raw tenant data).\n     - Questionnaire adapter reads stored JSON answers (per customer).\n     - Intent adapter listens to observability events (optional).\n2. **Score & Assess**\n   - \\`LifecycleOrchestrator\\` returns \\`LifecycleAssessment\\` + confidence.\n   - Persist assessment snapshot via Studio storage abstraction (file or KV).\n3. **Generate Guidance**\n   - \\`LifecycleRecommendationEngine\\` + \\`LifecycleCeremonyDesigner\\`.\n   - Queue AI advisor agent call if \\`LIFECYCLE_ADVISOR_ALPHA\\` enabled.\n4. **Publish**\n   - Update Studio dashboard caches.\n   - Emit lifecycle events.\n   - Notify support (Slack/Webhook) when confidence < 0.5 or stage regresses.\n\n---\n\n### 3. Customization Guide\n\n| What | How | Notes |\n| --- | --- | --- |\n| Stage weights | Update \\`modules/lifecycle-core/configs/stage-weights.json\\` via bundle config layer | Keep doc changes in sync; re-run unit tests |\n| Milestones | Edit \\`milestones-catalog.json\\`, re-run CLI fixtures | Do not remove IDs used in history |\n| Playbooks / ceremonies | Update \\`modules/lifecycle-advisor/src/data/*.json\\` | Provide localized copy if required |\n| Feature flags | Toggle via progressive-delivery library (per tenant) | Document rationale and expiration date |\n\nAll overrides must be versioned; operators should never edit compiled JS.\n\n---\n\n### 4. Monitoring & Alerts\n\n- **Dashboards** (Grafana or equivalent):\n  - Stage distribution (per tenant / aggregated)\n  - Assessment latency (trigger → completion)\n  - Adoption metrics (guidance consumed events)\n- **Alerts**:\n  - \\`LifecycleAssessmentFailed\\` (error > 3 in 5m)\n  - \\`LifecycleConfidenceLow\\` (confidence < 0.4 for 2 consecutive runs)\n  - \\`LifecycleStageChurn\\` (stage oscillates >2 times in 7 days)\n\nAlert recipients: lifecycle ops squad + product owner.\n\n---\n\n### 5. Escalation Playbook\n\n1. **Detection gap** (signals missing):\n   - Check analytics adapter health.\n   - Fall back to questionnaire-only mode.\n   - Log incident in lifecycle ops channel.\n2. **Inaccurate recommendation**:\n   - Capture assessment payload + manual notes.\n   - File issue referencing \\`LifecycleRecommendationEngine\\`.\n   - Update playbook JSON + add regression test.\n3. **Ceremony assets broken**:\n   - Disable \\`LifecycleCeremonyDesigner\\` output via feature flag.\n   - Notify design systems to refresh assets.\n\n---\n\n### 6. Data Handling\n\n- Managed bundle uses Studio storage; no direct access to tenant DBs.\n- Retain last 10 assessments per tenant for comparison (configurable).\n- Delete assessments on tenant request (flag \\`lifecycle_data_retention_days\\`).\n- Questionnaire answers treated as customer data; store encrypted if possible.\n\n---\n\n### 7. Run / Maintenance Tasks\n\n| Task | Cadence | Owner |\n| --- | --- | --- |\n| Review staged weight adjustments | Monthly | Lifecycle PM + Ops |\n| Refresh milestone catalog with new learnings | Quarterly | Lifecycle strategist |\n| Validate CLI + dashboard examples still work | Release cycle | DevRel |\n| Audit analytics events coverage | Monthly | Data team |\n\n---\n\n### 8. Tooling References\n\n- \\`packages/bundles/lifecycle-managed/\\` for managed runtime code.\n- \\`packages/modules/lifecycle-core/\\` for detection logic.\n- \\`packages/modules/lifecycle-advisor/\\` for playbooks and ceremonies.\n- Progressive delivery config for lifecycle feature flags.\n\nMaintain this runbook alongside code changes; every bundle release must document operational impact and flag defaults.`,\n  },\n];\n"],"mappings":";AAEA,MAAa,mBAA+B;CAC1C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,OAAO,YAAY;EAC1B,MAAM;EACP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,OAAO,YAAY;EAC1B,MAAM;;;;;EAKP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,OAAO,YAAY;EAC1B,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgHP;CACF"}

package/dist/components/docs/ops/ops-runbooks-a.docblocks.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/components/docs/ops/ops-runbooks-a.docblocks.d.ts
+declare const opsRunbookDocsA: DocBlock[];
+//#endregion
+export { opsRunbookDocsA };
+//# sourceMappingURL=ops-runbooks-a.docblocks.d.ts.map

package/dist/components/docs/ops/ops-runbooks-a.docblocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-runbooks-a.docblocks.d.ts","names":[],"sources":["../../../../src/components/docs/ops/ops-runbooks-a.docblocks.ts"],"mappings":";;;cAEa,eAAA,EAAiB,QAAA"}