@contractspec/bundle.library 3.8.10 → 3.8.12

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

@@ -1,307 +1,49 @@
 // @bun
-// src/components/docs/shared/StudioPrompt.tsx
-import Link from "@contractspec/lib.ui-link";
-import { jsx, jsxs } from "react/jsx-runtime";
-function StudioPrompt({
-  title = "Need the operating layer on top of OSS ContractSpec?",
-  body = "ContractSpec Studio helps teams turn evidence into proposed spec changes, governed delivery loops, and execution-ready task packs while keeping the open contract system as the source of truth.",
-  ctaLabel = "See what Studio adds",
-  href = "https://www.contractspec.studio/docs"
-}) {
-  return /* @__PURE__ */ jsxs("div", {
-    className: "card-subtle space-y-3 p-6",
-    children: [
-      /* @__PURE__ */ jsx("h3", {
-        className: "font-semibold text-lg",
-        children: title
-      }),
-      /* @__PURE__ */ jsx("p", {
-        className: "text-muted-foreground text-sm",
-        children: body
-      }),
-      /* @__PURE__ */ jsx(Link, {
-        href,
-        className: "btn-primary",
-        children: ctaLabel
-      })
-    ]
-  });
-}
-
-// src/components/docs/guides/GuideCIDiffGatingPage.tsx
-import { CodeBlock } from "@contractspec/lib.design-system";
-import Link2 from "@contractspec/lib.ui-link";
-import { ChevronRight } from "lucide-react";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-function GuideCIDiffGatingPage() {
-  return /* @__PURE__ */ jsxs2("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs2("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx2("h1", {
-            className: "font-bold text-4xl",
-            children: "CI gating with deterministic diffs"
-          }),
-          /* @__PURE__ */ jsx2("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Add ContractSpec CI checks that validate specs, detect drift, and gate breaking changes before merge."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs2("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx2("h2", {
-            className: "font-bold text-2xl",
-            children: "What you'll build"
-          }),
-          /* @__PURE__ */ jsxs2("ul", {
-            className: "space-y-2 text-muted-foreground text-sm",
-            children: [
-              /* @__PURE__ */ jsx2("li", {
-                children: "CI workflow running ContractSpec validation and drift checks."
-              }),
-              /* @__PURE__ */ jsx2("li", {
-                children: "Machine-readable output for PR annotations."
-              }),
-              /* @__PURE__ */ jsx2("li", {
-                children: "Deterministic contract diffs in review."
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs2("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Add the CI workflow"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Copy the template from the CLI package."
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "bash",
-                filename: "ci-copy",
-                code: `cp node_modules/@contractspec/app.cli-contractspec/templates/github-action.yml .github/workflows/contractspec.yml`
-              }),
-              /* @__PURE__ */ jsxs2("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: new workflow file in ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: ".github/workflows"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Run CI locally"
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "bash",
-                filename: "ci-local",
-                code: `contractspec ci --format json --check-drift`
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Expected output: JSON summary including pass/fail counts and drift status (if configured)."
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Add a diff check"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Use the diff command to inspect breaking changes in PRs."
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "bash",
-                filename: "ci-diff",
-                code: `contractspec diff src/contracts/spec-v1.ts src/contracts/spec-v2.ts --breaking`
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Expected output: deterministic diff with breaking change hints."
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "card-subtle space-y-3 p-6",
-            children: [
-              /* @__PURE__ */ jsx2("h3", {
-                className: "font-semibold text-lg",
-                children: "Example package"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "The CRM pipeline example is already wired in the quickstart smoke test. Use it as a CI-ready template."
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "bash",
-                filename: "crm-ci",
-                code: `cd packages/examples/crm-pipeline
+import $ from"@contractspec/lib.ui-link";import{jsx as O,jsxs as X}from"react/jsx-runtime";function g({title:c="Need the operating layer on top of OSS ContractSpec?",body:_="ContractSpec Studio helps teams turn evidence into proposed spec changes, governed delivery loops, and execution-ready task packs while keeping the open contract system as the source of truth.",ctaLabel:Y="See what Studio adds",href:J="https://www.contractspec.studio/docs"}){return X("div",{className:"card-subtle space-y-3 p-6",children:[O("h3",{className:"font-semibold text-lg",children:c}),O("p",{className:"text-muted-foreground text-sm",children:_}),O($,{href:J,className:"btn-primary",children:Y})]})}import{CodeBlock as R}from"@contractspec/lib.design-system";import L from"@contractspec/lib.ui-link";import{ChevronRight as Z}from"lucide-react";import{jsx as d,jsxs as w}from"react/jsx-runtime";function x(){return w("div",{className:"space-y-8",children:[w("div",{className:"space-y-3",children:[d("h1",{className:"font-bold text-4xl",children:"CI gating with deterministic diffs"}),d("p",{className:"text-lg text-muted-foreground",children:"Add ContractSpec CI checks that validate specs, detect drift, and gate breaking changes before merge."})]}),w("div",{className:"card-subtle space-y-4 p-6",children:[d("h2",{className:"font-bold text-2xl",children:"What you'll build"}),w("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[d("li",{children:"CI workflow running ContractSpec validation and drift checks."}),d("li",{children:"Machine-readable output for PR annotations."}),d("li",{children:"Deterministic contract diffs in review."})]})]}),w("div",{className:"space-y-6",children:[w("div",{className:"space-y-3",children:[d("h2",{className:"font-bold text-2xl",children:"1) Add the CI workflow"}),d("p",{className:"text-muted-foreground text-sm",children:"Copy the template from the CLI package."}),d(R,{language:"bash",filename:"ci-copy",code:"cp node_modules/@contractspec/app.cli-contractspec/templates/github-action.yml .github/workflows/contractspec.yml"}),w("p",{className:"text-muted-foreground text-sm",children:["Expected output: new workflow file in ",d("code",{children:".github/workflows"}),"."]})]}),w("div",{className:"space-y-3",children:[d("h2",{className:"font-bold text-2xl",children:"2) Run CI locally"}),d(R,{language:"bash",filename:"ci-local",code:"contractspec ci --format json --check-drift"}),d("p",{className:"text-muted-foreground text-sm",children:"Expected output: JSON summary including pass/fail counts and drift status (if configured)."})]}),w("div",{className:"space-y-3",children:[d("h2",{className:"font-bold text-2xl",children:"3) Add a diff check"}),d("p",{className:"text-muted-foreground text-sm",children:"Use the diff command to inspect breaking changes in PRs."}),d(R,{language:"bash",filename:"ci-diff",code:"contractspec diff src/contracts/spec-v1.ts src/contracts/spec-v2.ts --breaking"}),d("p",{className:"text-muted-foreground text-sm",children:"Expected output: deterministic diff with breaking change hints."})]}),w("div",{className:"card-subtle space-y-3 p-6",children:[d("h3",{className:"font-semibold text-lg",children:"Example package"}),d("p",{className:"text-muted-foreground text-sm",children:"The CRM pipeline example is already wired in the quickstart smoke test. Use it as a CI-ready template."}),d(R,{language:"bash",filename:"crm-ci",code:`cd packages/examples/crm-pipeline
 bun run build
-bun run validate`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx2(StudioPrompt, {
-            title: "Need continuous checks tied to outcomes?",
-            body: "Studio closes the loop with post-change verification and learning dividends that improve future decisions."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs2("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs2(Link2, {
-            href: "/docs/guides",
-            className: "btn-primary",
-            children: [
-              "Back to guides ",
-              /* @__PURE__ */ jsx2(ChevronRight, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx2(Link2, {
-            href: "/docs",
-            className: "btn-ghost",
-            children: "Docs home"
-          })
-        ]
-      })
-    ]
-  });
-}
-
-// src/components/docs/guides/GuideContractTypesPage.tsx
-import { CodeBlock as CodeBlock2 } from "@contractspec/lib.design-system";
-import Link3 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight2, Globe, Layers, Shield, Zap } from "lucide-react";
-import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
-var contractTypes = [
-  {
-    name: "Operations",
-    factory: "defineCommand / defineQuery",
-    description: "API endpoints with input/output schemas, validation, and policy.",
-    icon: Zap,
-    color: "text-blue-400"
-  },
-  {
-    name: "Events",
-    factory: "defineEvent",
-    description: "Domain events with typed payloads and PII handling.",
-    icon: Layers,
-    color: "text-green-400"
-  },
-  {
-    name: "Capabilities",
-    factory: "defineCapability",
-    description: "Feature groupings that link operations, events, and UIs.",
-    icon: Shield,
-    color: "text-purple-400"
-  },
-  {
-    name: "Presentations",
-    factory: "definePresentation",
-    description: "UI specifications for rendering data and handling interactions.",
-    icon: Globe,
-    color: "text-orange-400"
+bun run validate`})]}),d(g,{title:"Need continuous checks tied to outcomes?",body:"Studio closes the loop with post-change verification and learning dividends that improve future decisions."})]}),w("div",{className:"flex items-center gap-4 pt-4",children:[w(L,{href:"/docs/guides",className:"btn-primary",children:["Back to guides ",d(Z,{size:16})]}),d(L,{href:"/docs",className:"btn-ghost",children:"Docs home"})]})]})}import{CodeBlock as P}from"@contractspec/lib.design-system";import G from"@contractspec/lib.ui-link";import{ChevronRight as j}from"lucide-react";import{jsx as i,jsxs as b}from"react/jsx-runtime";var ee=[".contractspec/connect/context-pack.json",".contractspec/connect/plan-packet.json",".contractspec/connect/patch-verdict.json",".contractspec/connect/audit.ndjson",".contractspec/connect/decisions/<decisionId>/"];function te(){return b("div",{className:"space-y-8",children:[b("div",{className:"space-y-3",children:[i("h1",{className:"font-bold text-4xl",children:"Use Connect in a repo"}),i("p",{className:"text-lg text-muted-foreground",children:"Put coding-agent edits and shell commands behind task-scoped context, plan compilation, verification, and local review evidence without introducing a second control plane."})]}),b("div",{className:"card-subtle space-y-4 p-6",children:[i("h2",{className:"font-bold text-2xl",children:"What you'll build"}),b("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[i("li",{children:"A workspace-level Connect config in `.contractsrc.json`."}),i("li",{children:"A context and plan flow for one task."}),i("li",{children:"Verified file and shell mutations with local review/replay evidence."})]})]}),b("div",{className:"space-y-6",children:[b("div",{className:"space-y-3",children:[i("h2",{className:"font-bold text-2xl",children:"1) Enable Connect"}),i("p",{className:"text-muted-foreground text-sm",children:"Start by making the safety policy explicit. Protected paths, generated paths, review thresholds, and command rules live in the workspace config, not in editor-specific hooks."}),i(P,{language:"json",filename:".contractsrc.json",code:`{
+  "connect": {
+    "enabled": true,
+    "storage": {
+      "root": ".contractspec/connect",
+      "contextPack": ".contractspec/connect/context-pack.json",
+      "planPacket": ".contractspec/connect/plan-packet.json",
+      "patchVerdict": ".contractspec/connect/patch-verdict.json",
+      "auditFile": ".contractspec/connect/audit.ndjson",
+      "reviewPacketsDir": ".contractspec/connect/review-packets"
+    },
+    "policy": {
+      "protectedPaths": ["packages/libs/contracts-spec/**"],
+      "generatedPaths": ["generated/**"],
+      "smokeChecks": ["bun run typecheck"],
+      "reviewThresholds": {
+        "protectedPathWrite": "require_review",
+        "breakingChange": "require_review",
+        "destructiveCommand": "deny"
+      }
+    },
+    "commands": {
+      "allow": ["bun run typecheck"],
+      "review": ["git push"],
+      "deny": ["git reset --hard", "git push --force", "rm -rf"]
+    }
   }
-];
-function GuideContractTypesPage() {
-  return /* @__PURE__ */ jsxs3("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs3("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx3("h1", {
-            className: "font-bold text-4xl",
-            children: "Contract Types Overview"
-          }),
-          /* @__PURE__ */ jsx3("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Learn about the different contract types in ContractSpec and when to use each one when you are making the system boundary explicit."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs3("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx3("h2", {
-            className: "font-bold text-2xl",
-            children: "Core Contract Types"
-          }),
-          /* @__PURE__ */ jsx3("div", {
-            className: "grid gap-3 md:grid-cols-2",
-            children: contractTypes.map((type) => /* @__PURE__ */ jsxs3("div", {
-              className: "flex items-start gap-3 rounded-lg border border-white/10 p-4",
-              children: [
-                /* @__PURE__ */ jsx3(type.icon, {
-                  className: type.color,
-                  size: 20
-                }),
-                /* @__PURE__ */ jsxs3("div", {
-                  className: "space-y-1",
-                  children: [
-                    /* @__PURE__ */ jsx3("h3", {
-                      className: "font-semibold",
-                      children: type.name
-                    }),
-                    /* @__PURE__ */ jsx3("p", {
-                      className: "text-muted-foreground text-xs",
-                      children: type.description
-                    }),
-                    /* @__PURE__ */ jsx3("code", {
-                      className: "text-violet-400 text-xs",
-                      children: type.factory
-                    })
-                  ]
-                })
-              ]
-            }, type.name))
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs3("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs3("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Operations (Commands & Queries)"
-              }),
-              /* @__PURE__ */ jsx3("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Operations are the backbone of your API. Commands mutate state, queries read state. Both have typed input/output schemas."
-              }),
-              /* @__PURE__ */ jsx3(CodeBlock2, {
-                language: "typescript",
-                filename: "src/contracts/user.operation.ts",
-                code: `import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
+}`}),i("p",{className:"text-muted-foreground text-sm",children:"Expected output: Connect has enough policy to classify writes, commands, drift, and review thresholds deterministically."})]}),b("div",{className:"space-y-3",children:[i("h2",{className:"font-bold text-2xl",children:"2) Initialize storage"}),i(P,{language:"bash",filename:"connect-init",code:"contractspec connect init --scope workspace"}),i("p",{className:"text-muted-foreground text-sm",children:"Expected output: `.contractsrc.json` is updated if needed and `.contractspec/connect/` is created."})]}),b("div",{className:"space-y-3",children:[i("h2",{className:"font-bold text-2xl",children:"3) Project context and compile a plan"}),i("p",{className:"text-muted-foreground text-sm",children:"Use the task id as the thread that connects context, plan, verdict, and replay artifacts."}),i(P,{language:"bash",filename:"connect-plan",code:`contractspec connect context \\
+  --task docs-connect \\
+  --paths packages/libs/contracts-spec/src/control-plane/contracts.ts \\
+  --json
+
+printf '{"objective":"Document the control-plane contract surface","commands":["bun run typecheck"]}' | \\
+  contractspec connect plan --task docs-connect --stdin --json`}),i("p",{className:"text-muted-foreground text-sm",children:"Expected output: a `ContextPack` and `PlanPacket` that point back to `controlPlane.intent.submit`, `controlPlane.plan.compile`, and `controlPlane.plan.verify`."})]}),b("div",{className:"space-y-3",children:[i("h2",{className:"font-bold text-2xl",children:"4) Verify file and shell mutations"}),i(P,{language:"bash",filename:"connect-verify",code:`printf '{"operation":"edit","path":"packages/libs/contracts-spec/src/control-plane/contracts.ts"}' | \\
+  contractspec connect verify --task docs-connect --tool acp.fs.access --stdin --json
+
+printf 'bun run typecheck' | \\
+  contractspec connect verify --task docs-connect --tool acp.terminal.exec --stdin --json`}),i("p",{className:"text-muted-foreground text-sm",children:"Expected output: a `PatchVerdict` with `permit`, `rewrite`, `require_review`, or `deny`, plus a runtime-linked control-plane state when that linkage is available."})]}),b("div",{className:"card-subtle space-y-3 p-6",children:[i("h3",{className:"font-semibold text-lg",children:"Artifacts to inspect"}),i("ul",{className:"space-y-2 text-muted-foreground text-sm",children:ee.map((c)=>i("li",{children:i("code",{children:c})},c))})]}),b("div",{className:"space-y-3",children:[i("h2",{className:"font-bold text-2xl",children:"5) Review, replay, and optional Studio sync"}),i(P,{language:"bash",filename:"connect-review-replay",code:`contractspec connect review list --json
+contractspec connect replay <decisionId> --json
+contractspec connect eval <decisionId> --registry ./harness-registry.ts --scenario connect.safe-refactor --json
+
+# Optional when Studio review-bridge mode is enabled
+contractspec connect review sync --decision <decisionId> --json`}),i("p",{className:"text-muted-foreground text-sm",children:"Local review packets remain authoritative. Studio sync is an operator convenience layer, not a requirement for baseline OSS safety."})]})]}),b("div",{className:"flex items-center gap-4 pt-4",children:[b(G,{href:"/docs/specs/connect",className:"btn-primary",children:["Back to Connect spec ",i(j,{size:16})]}),i(G,{href:"/docs/architecture/control-plane",className:"btn-ghost",children:"Control-plane runtime"})]})]})}import{CodeBlock as B}from"@contractspec/lib.design-system";import W from"@contractspec/lib.ui-link";import{ChevronRight as ae,Globe as oe,Layers as ne,Shield as ie,Zap as re}from"lucide-react";import{jsx as t,jsxs as o}from"react/jsx-runtime";var ce=[{name:"Operations",factory:"defineCommand / defineQuery",description:"API endpoints with input/output schemas, validation, and policy.",icon:re,color:"text-blue-400"},{name:"Events",factory:"defineEvent",description:"Domain events with typed payloads and PII handling.",icon:ne,color:"text-green-400"},{name:"Capabilities",factory:"defineCapability",description:"Feature groupings that link operations, events, and UIs.",icon:ie,color:"text-purple-400"},{name:"Presentations",factory:"definePresentation",description:"UI specifications for rendering data and handling interactions.",icon:oe,color:"text-orange-400"}];function se(){return o("div",{className:"space-y-8",children:[o("div",{className:"space-y-3",children:[t("h1",{className:"font-bold text-4xl",children:"Contract Types Overview"}),t("p",{className:"text-lg text-muted-foreground",children:"Learn about the different contract types in ContractSpec and when to use each one when you are making the system boundary explicit."})]}),o("div",{className:"card-subtle space-y-4 p-6",children:[t("h2",{className:"font-bold text-2xl",children:"Core Contract Types"}),t("div",{className:"grid gap-3 md:grid-cols-2",children:ce.map((c)=>o("div",{className:"flex items-start gap-3 rounded-lg border border-white/10 p-4",children:[t(c.icon,{className:c.color,size:20}),o("div",{className:"space-y-1",children:[t("h3",{className:"font-semibold",children:c.name}),t("p",{className:"text-muted-foreground text-xs",children:c.description}),t("code",{className:"text-violet-400 text-xs",children:c.factory})]})]},c.name))})]}),o("div",{className:"space-y-6",children:[o("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"1) Operations (Commands & Queries)"}),t("p",{className:"text-muted-foreground text-sm",children:"Operations are the backbone of your API. Commands mutate state, queries read state. Both have typed input/output schemas."}),t(B,{language:"typescript",filename:"src/contracts/user.operation.ts",code:`import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
 import { SchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 
 // Command: Mutates state (creates a user)
@@ -367,25 +109,7 @@ export const GetUserQuery = defineQuery({
     }),
   },
   policy: { auth: "user" },
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs3("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Events"
-              }),
-              /* @__PURE__ */ jsx3("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Events represent domain occurrences. They have typed payloads with PII field marking for compliance."
-              }),
-              /* @__PURE__ */ jsx3(CodeBlock2, {
-                language: "typescript",
-                filename: "src/contracts/user.event.ts",
-                code: `import { defineEvent } from "@contractspec/lib.contracts-spec";
+});`})]}),o("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"2) Events"}),t("p",{className:"text-muted-foreground text-sm",children:"Events represent domain occurrences. They have typed payloads with PII field marking for compliance."}),t(B,{language:"typescript",filename:"src/contracts/user.event.ts",code:`import { defineEvent } from "@contractspec/lib.contracts-spec";
 import { SchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 
 export const UserCreatedEvent = defineEvent({
@@ -426,25 +150,7 @@ export const UserDeletedEvent = defineEvent({
       reason: { type: ScalarTypeEnum.String(), isOptional: true },
     },
   }),
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs3("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Capabilities"
-              }),
-              /* @__PURE__ */ jsx3("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Capabilities group related operations, events, and presentations. They define feature boundaries and dependencies."
-              }),
-              /* @__PURE__ */ jsx3(CodeBlock2, {
-                language: "typescript",
-                filename: "src/contracts/user-management.capability.ts",
-                code: `import { defineCapability } from "@contractspec/lib.contracts-spec";
+});`})]}),o("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"3) Capabilities"}),t("p",{className:"text-muted-foreground text-sm",children:"Capabilities group related operations, events, and presentations. They define feature boundaries and dependencies."}),t(B,{language:"typescript",filename:"src/contracts/user-management.capability.ts",code:`import { defineCapability } from "@contractspec/lib.contracts-spec";
 
 export const UserManagementCapability = defineCapability({
   meta: {
@@ -487,25 +193,7 @@ export const AdminUserCapability = defineCapability({
     { surface: "operation", key: "user.ban", version: "1.0.0" },
     { surface: "operation", key: "user.impersonate", version: "1.0.0" },
   ],
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs3("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "font-bold text-2xl",
-                children: "4) Presentations"
-              }),
-              /* @__PURE__ */ jsx3("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Presentations define UI specifications. They link to capabilities and specify how data should be displayed."
-              }),
-              /* @__PURE__ */ jsx3(CodeBlock2, {
-                language: "typescript",
-                filename: "src/contracts/user-list.presentation.ts",
-                code: `import { definePresentation } from "@contractspec/lib.contracts-spec";
+});`})]}),o("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"4) Presentations"}),t("p",{className:"text-muted-foreground text-sm",children:"Presentations define UI specifications. They link to capabilities and specify how data should be displayed."}),t(B,{language:"typescript",filename:"src/contracts/user-list.presentation.ts",code:`import { definePresentation } from "@contractspec/lib.contracts-spec";
 
 export const UserListPresentation = definePresentation({
   meta: {
@@ -527,179 +215,7 @@ export const UserListPresentation = definePresentation({
     pagination: { defaultPageSize: 25 },
     search: { fields: ["name", "email"] },
   },
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs3("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "font-bold text-2xl",
-                children: "5) Additional Contract Types"
-              }),
-              /* @__PURE__ */ jsx3("p", {
-                className: "text-muted-foreground text-sm",
-                children: "ContractSpec provides specialized contracts for different concerns:"
-              }),
-              /* @__PURE__ */ jsxs3("div", {
-                className: "grid gap-4 md:grid-cols-2",
-                children: [
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Policy"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "definePolicy"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "RBAC/ABAC rules, rate limits, and access control."
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Workflow"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "defineWorkflow"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "Multi-step processes with states, transitions, and SLAs."
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Translation"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "defineTranslation"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "i18n messages with ICU format and locale fallbacks."
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Integration"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "defineIntegration"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "External service connections and API adapters."
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Form"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "defineFormSpec"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "Form definitions with fields, validation, and layouts."
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Data View"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "defineDataView"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "Read-only data projections and aggregations."
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Feature"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "defineFeature"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "Feature flags and progressive rollout configurations."
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs3("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx3("h3", {
-                        className: "font-semibold",
-                        children: "Test"
-                      }),
-                      /* @__PURE__ */ jsx3("code", {
-                        className: "text-violet-400 text-xs",
-                        children: "defineTestSpec"
-                      }),
-                      /* @__PURE__ */ jsx3("p", {
-                        className: "text-muted-foreground text-xs",
-                        children: "Contract-driven test scenarios and fixtures."
-                      })
-                    ]
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs3("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "font-bold text-2xl",
-                children: "6) Registering Contracts"
-              }),
-              /* @__PURE__ */ jsx3("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Each contract type has a registry for lookup and validation."
-              }),
-              /* @__PURE__ */ jsx3(CodeBlock2, {
-                language: "typescript",
-                filename: "src/contracts/registry.ts",
-                code: `import {
+});`})]}),o("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"5) Additional Contract Types"}),t("p",{className:"text-muted-foreground text-sm",children:"ContractSpec provides specialized contracts for different concerns:"}),o("div",{className:"grid gap-4 md:grid-cols-2",children:[o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Policy"}),t("code",{className:"text-violet-400 text-xs",children:"definePolicy"}),t("p",{className:"text-muted-foreground text-xs",children:"RBAC/ABAC rules, rate limits, and access control."})]}),o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Workflow"}),t("code",{className:"text-violet-400 text-xs",children:"defineWorkflow"}),t("p",{className:"text-muted-foreground text-xs",children:"Multi-step processes with states, transitions, and SLAs."})]}),o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Translation"}),t("code",{className:"text-violet-400 text-xs",children:"defineTranslation"}),t("p",{className:"text-muted-foreground text-xs",children:"i18n messages with ICU format and locale fallbacks."})]}),o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Integration"}),t("code",{className:"text-violet-400 text-xs",children:"defineIntegration"}),t("p",{className:"text-muted-foreground text-xs",children:"External service connections and API adapters."})]}),o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Form"}),t("code",{className:"text-violet-400 text-xs",children:"defineFormSpec"}),t("p",{className:"text-muted-foreground text-xs",children:"Form definitions with fields, validation, and layouts."})]}),o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Data View"}),t("code",{className:"text-violet-400 text-xs",children:"defineDataView"}),t("p",{className:"text-muted-foreground text-xs",children:"Read-only data projections and aggregations."})]}),o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Feature"}),t("code",{className:"text-violet-400 text-xs",children:"defineFeature"}),t("p",{className:"text-muted-foreground text-xs",children:"Feature flags and progressive rollout configurations."})]}),o("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Test"}),t("code",{className:"text-violet-400 text-xs",children:"defineTestSpec"}),t("p",{className:"text-muted-foreground text-xs",children:"Contract-driven test scenarios and fixtures."})]})]})]}),o("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"6) Registering Contracts"}),t("p",{className:"text-muted-foreground text-sm",children:"Each contract type has a registry for lookup and validation."}),t(B,{language:"typescript",filename:"src/contracts/registry.ts",code:`import {
   OperationSpecRegistry,
   installOp,
 } from "@contractspec/lib.contracts-spec/operations";
@@ -729,291 +245,9 @@ installOp(operationRegistry, GetUserQuery, async (input) => {
 
 // Register events and capabilities
 eventRegistry.register(UserCreatedEvent);
-capabilityRegistry.register(UserManagementCapability);`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs3("div", {
-            className: "card-subtle space-y-3 p-6",
-            children: [
-              /* @__PURE__ */ jsx3("h3", {
-                className: "font-semibold text-lg",
-                children: "Contract Type Decision Guide"
-              }),
-              /* @__PURE__ */ jsxs3("table", {
-                className: "w-full text-sm",
-                children: [
-                  /* @__PURE__ */ jsx3("thead", {
-                    children: /* @__PURE__ */ jsxs3("tr", {
-                      className: "border-white/10 border-b",
-                      children: [
-                        /* @__PURE__ */ jsx3("th", {
-                          className: "py-2 text-left",
-                          children: "When you need..."
-                        }),
-                        /* @__PURE__ */ jsx3("th", {
-                          className: "py-2 text-left",
-                          children: "Use this contract"
-                        })
-                      ]
-                    })
-                  }),
-                  /* @__PURE__ */ jsxs3("tbody", {
-                    className: "text-muted-foreground",
-                    children: [
-                      /* @__PURE__ */ jsxs3("tr", {
-                        className: "border-white/5 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: "An API endpoint that changes data"
-                          }),
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: /* @__PURE__ */ jsx3("code", {
-                              children: "defineCommand"
-                            })
-                          })
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs3("tr", {
-                        className: "border-white/5 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: "An API endpoint that reads data"
-                          }),
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: /* @__PURE__ */ jsx3("code", {
-                              children: "defineQuery"
-                            })
-                          })
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs3("tr", {
-                        className: "border-white/5 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: "Async notification of something that happened"
-                          }),
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: /* @__PURE__ */ jsx3("code", {
-                              children: "defineEvent"
-                            })
-                          })
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs3("tr", {
-                        className: "border-white/5 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: "Group related specs under a feature"
-                          }),
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: /* @__PURE__ */ jsx3("code", {
-                              children: "defineCapability"
-                            })
-                          })
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs3("tr", {
-                        className: "border-white/5 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: "Define UI rendering specifications"
-                          }),
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: /* @__PURE__ */ jsx3("code", {
-                              children: "definePresentation"
-                            })
-                          })
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs3("tr", {
-                        className: "border-white/5 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: "Access control and rate limiting"
-                          }),
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: /* @__PURE__ */ jsx3("code", {
-                              children: "definePolicy"
-                            })
-                          })
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs3("tr", {
-                        children: [
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: "Multi-step business processes"
-                          }),
-                          /* @__PURE__ */ jsx3("td", {
-                            className: "py-2",
-                            children: /* @__PURE__ */ jsx3("code", {
-                              children: "defineWorkflow"
-                            })
-                          })
-                        ]
-                      })
-                    ]
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx3(StudioPrompt, {
-            title: "Need to decide which contract should change next?",
-            body: "Studio uses evidence and focus constraints to generate decision briefs, patch intents, and execution-ready task packs."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs3("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs3(Link3, {
-            href: "/docs/guides/nextjs-one-endpoint",
-            className: "btn-primary",
-            children: [
-              "Next: Add your first endpoint ",
-              /* @__PURE__ */ jsx3(ChevronRight2, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx3(Link3, {
-            href: "/docs/guides",
-            className: "btn-ghost",
-            children: "Back to guides"
-          })
-        ]
-      })
-    ]
-  });
-}
-
-// src/components/docs/guides/GuideDocsPipelinePage.tsx
-import { CodeBlock as CodeBlock3 } from "@contractspec/lib.design-system";
-import Link4 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight3 } from "lucide-react";
-import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
-function GuideDocsPipelinePage() {
-  return /* @__PURE__ */ jsxs4("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs4("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx4("h1", {
-            className: "font-bold text-4xl",
-            children: "Build the docs pipeline"
-          }),
-          /* @__PURE__ */ jsx4("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Generate reference docs, chunk the index, and wire the docs pages the same way this repo does."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs4("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx4("h2", {
-            className: "font-bold text-2xl",
-            children: "What you'll build"
-          }),
-          /* @__PURE__ */ jsxs4("ul", {
-            className: "space-y-2 text-muted-foreground text-sm",
-            children: [
-              /* @__PURE__ */ jsx4("li", {
-                children: "Generated Markdown and a chunked index manifest."
-              }),
-              /* @__PURE__ */ jsx4("li", {
-                children: "Reference routes powered by the docs loader."
-              }),
-              /* @__PURE__ */ jsx4("li", {
-                children: "Versioned outputs you can publish per release."
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs4("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs4("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx4("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Generate contract docs"
-              }),
-              /* @__PURE__ */ jsx4(CodeBlock3, {
-                language: "bash",
-                filename: "generate-contract-docs",
-                code: `contractspec generate`
-              }),
-              /* @__PURE__ */ jsxs4("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: Markdown in ",
-                  /* @__PURE__ */ jsx4("code", {
-                    children: "generated/docs"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs4("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx4("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Build the docs index"
-              }),
-              /* @__PURE__ */ jsx4(CodeBlock3, {
-                language: "bash",
-                filename: "docs-generate",
-                code: `bun docs:generate
+capabilityRegistry.register(UserManagementCapability);`})]}),o("div",{className:"card-subtle space-y-3 p-6",children:[t("h3",{className:"font-semibold text-lg",children:"Contract Type Decision Guide"}),o("table",{className:"w-full text-sm",children:[t("thead",{children:o("tr",{className:"border-white/10 border-b",children:[t("th",{className:"py-2 text-left",children:"When you need..."}),t("th",{className:"py-2 text-left",children:"Use this contract"})]})}),o("tbody",{className:"text-muted-foreground",children:[o("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2",children:"An API endpoint that changes data"}),t("td",{className:"py-2",children:t("code",{children:"defineCommand"})})]}),o("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2",children:"An API endpoint that reads data"}),t("td",{className:"py-2",children:t("code",{children:"defineQuery"})})]}),o("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2",children:"Async notification of something that happened"}),t("td",{className:"py-2",children:t("code",{children:"defineEvent"})})]}),o("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2",children:"Group related specs under a feature"}),t("td",{className:"py-2",children:t("code",{children:"defineCapability"})})]}),o("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2",children:"Define UI rendering specifications"}),t("td",{className:"py-2",children:t("code",{children:"definePresentation"})})]}),o("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2",children:"Access control and rate limiting"}),t("td",{className:"py-2",children:t("code",{children:"definePolicy"})})]}),o("tr",{children:[t("td",{className:"py-2",children:"Multi-step business processes"}),t("td",{className:"py-2",children:t("code",{children:"defineWorkflow"})})]})]})]})]}),t(g,{title:"Need to decide which contract should change next?",body:"Studio uses evidence and focus constraints to generate decision briefs, patch intents, and execution-ready task packs."})]}),o("div",{className:"flex items-center gap-4 pt-4",children:[o(W,{href:"/docs/guides/nextjs-one-endpoint",className:"btn-primary",children:["Next: Add your first endpoint ",t(ae,{size:16})]}),t(W,{href:"/docs/guides",className:"btn-ghost",children:"Back to guides"})]})]})}import{CodeBlock as U}from"@contractspec/lib.design-system";import H from"@contractspec/lib.ui-link";import{ChevronRight as de}from"lucide-react";import{jsx as p,jsxs as f}from"react/jsx-runtime";function le(){return f("div",{className:"space-y-8",children:[f("div",{className:"space-y-3",children:[p("h1",{className:"font-bold text-4xl",children:"Build the docs pipeline"}),p("p",{className:"text-lg text-muted-foreground",children:"Generate reference docs, chunk the index, and wire the docs pages the same way this repo does."})]}),f("div",{className:"card-subtle space-y-4 p-6",children:[p("h2",{className:"font-bold text-2xl",children:"What you'll build"}),f("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[p("li",{children:"Generated Markdown and a chunked index manifest."}),p("li",{children:"Reference routes powered by the docs loader."}),p("li",{children:"Versioned outputs you can publish per release."})]})]}),f("div",{className:"space-y-6",children:[f("div",{className:"space-y-3",children:[p("h2",{className:"font-bold text-2xl",children:"1) Generate contract docs"}),p(U,{language:"bash",filename:"generate-contract-docs",code:"contractspec generate"}),f("p",{className:"text-muted-foreground text-sm",children:["Expected output: Markdown in ",p("code",{children:"generated/docs"}),"."]})]}),f("div",{className:"space-y-3",children:[p("h2",{className:"font-bold text-2xl",children:"2) Build the docs index"}),p(U,{language:"bash",filename:"docs-generate",code:`bun docs:generate
 # versioned output
-bun docs:generate -- --version v1.0.0`
-              }),
-              /* @__PURE__ */ jsxs4("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "This writes ",
-                  /* @__PURE__ */ jsx4("code", {
-                    children: "docs-index.manifest.json"
-                  }),
-                  " and chunked",
-                  /* @__PURE__ */ jsx4("code", {
-                    children: "docs-index.*.json"
-                  }),
-                  " files in the generated docs bundle."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs4("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx4("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Wire reference routes"
-              }),
-              /* @__PURE__ */ jsx4(CodeBlock3, {
-                language: "tsx",
-                filename: "docs-reference-route",
-                code: `import { notFound } from "next/navigation";
+bun docs:generate -- --version v1.0.0`}),f("p",{className:"text-muted-foreground text-sm",children:["This writes ",p("code",{children:"docs-index.manifest.json"})," and chunked",p("code",{children:"docs-index.*.json"})," files in the generated docs bundle."]})]}),f("div",{className:"space-y-3",children:[p("h2",{className:"font-bold text-2xl",children:"3) Wire reference routes"}),p(U,{language:"tsx",filename:"docs-reference-route",code:`import { notFound } from "next/navigation";
 import {
   DocsReferenceIndexPage,
   DocsReferencePage,
@@ -1031,474 +265,159 @@ export default async function Page({ params }: { params: { slug?: string[] } })
   const doc = await getGeneratedDocById(slug);
   if (!doc) notFound();
   return <DocsReferencePage entry={doc.entry} content={doc.content} />;
-}`
-              }),
-              /* @__PURE__ */ jsxs4("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Use the index page on ",
-                  /* @__PURE__ */ jsx4("code", {
-                    children: "/docs/reference"
-                  }),
-                  " to render the searchable list."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs4("div", {
-            className: "card-subtle space-y-3 p-6",
-            children: [
-              /* @__PURE__ */ jsx4("h3", {
-                className: "font-semibold text-lg",
-                children: "Repo reference"
-              }),
-              /* @__PURE__ */ jsxs4("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "This repo wires docs under",
-                  " ",
-                  /* @__PURE__ */ jsx4("code", {
-                    children: "packages/apps/web-landing/src/app/docs/reference"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx4(StudioPrompt, {
-            title: "Need decision-to-export automation?",
-            body: "Studio exports evidence-backed spec changes and task packs to Linear, Jira, Notion, and GitHub."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs4("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs4(Link4, {
-            href: "/docs/guides/ci-contract-diff-gating",
-            className: "btn-primary",
-            children: [
-              "Next: CI gating ",
-              /* @__PURE__ */ jsx4(ChevronRight3, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx4(Link4, {
-            href: "/docs/guides",
-            className: "btn-ghost",
-            children: "Back to guides"
-          })
-        ]
-      })
-    ]
-  });
-}
+}`}),f("p",{className:"text-muted-foreground text-sm",children:["Use the index page on ",p("code",{children:"/docs/reference"})," to render the searchable list."]})]}),f("div",{className:"card-subtle space-y-3 p-6",children:[p("h3",{className:"font-semibold text-lg",children:"Repo reference"}),f("p",{className:"text-muted-foreground text-sm",children:["This repo wires docs under"," ",p("code",{children:"packages/apps/web-landing/src/app/docs/reference"}),"."]})]}),p(g,{title:"Need decision-to-export automation?",body:"Studio exports evidence-backed spec changes and task packs to Linear, Jira, Notion, and GitHub."})]}),f("div",{className:"flex items-center gap-4 pt-4",children:[f(H,{href:"/docs/guides/ci-contract-diff-gating",className:"btn-primary",children:["Next: CI gating ",p(de,{size:16})]}),p(H,{href:"/docs/guides",className:"btn-ghost",children:"Back to guides"})]})]})}import{CodeBlock as D}from"@contractspec/lib.design-system";import z from"@contractspec/lib.ui-link";import{ChevronRight as pe}from"lucide-react";import{jsx as s,jsxs as C}from"react/jsx-runtime";function me(){return C("div",{className:"space-y-8",children:[C("div",{className:"space-y-3",children:[s("h1",{className:"font-bold text-4xl",children:"Build a first module bundle"}),s("p",{className:"text-lg text-muted-foreground",children:"Define one bundle spec, resolve it for a real route and preference profile, then render the resulting surface plan through the React host layer."})]}),C("div",{className:"card-subtle space-y-4 p-6",children:[s("h2",{className:"font-bold text-2xl",children:"What you'll build"}),C("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[s("li",{children:"One `ModuleBundleSpec` with a route and workbench surface."}),s("li",{children:"One `ResolvedSurfacePlan` from `resolveBundle`."}),s("li",{children:"One React host using `BundleProvider` and `BundleRenderer`."})]})]}),C("div",{className:"space-y-6",children:[C("div",{className:"space-y-3",children:[s("h2",{className:"font-bold text-2xl",children:"1) Define the bundle spec"}),s("p",{className:"text-muted-foreground text-sm",children:"The bundle spec is the durable contract. It owns route selection, surface shape, layouts, data recipes, and verification coverage for all seven preference dimensions."}),s(D,{language:"typescript",filename:"src/bundles/support.workbench.bundle.ts",code:`import { defineModuleBundle } from "@contractspec/lib.surface-runtime/spec/define-module-bundle";
+
+export const SupportWorkbenchBundle = defineModuleBundle({
+  meta: {
+    key: "support.workbench",
+    version: "0.1.0",
+    title: "Support Workbench",
+  },
+  routes: [
+    {
+      routeId: "support-ticket",
+      path: "/operate/support/tickets/:ticketId",
+      defaultSurface: "ticket-workbench",
+    },
+  ],
+  surfaces: {
+    "ticket-workbench": {
+      surfaceId: "ticket-workbench",
+      kind: "workbench",
+      slots: [
+        { slotId: "primary", role: "primary", accepts: ["entity-section"], cardinality: "many" },
+        { slotId: "assistant", role: "assistant", accepts: ["assistant-panel"], cardinality: "many", mutableByAi: true, mutableByUser: true },
+      ],
+      layouts: [
+        { layoutId: "balanced", title: "Balanced", root: { type: "slot", slotId: "primary" } },
+      ],
+      data: [
+        { recipeId: "ticket-core", source: { kind: "entity", entityType: "support.ticket" }, hydrateInto: "ticket" },
+      ],
+      verification: {
+        dimensions: {
+          guidance: "Surface can reveal walkthrough or inline help states.",
+          density: "Layout supports compact and balanced detail modes.",
+          dataDepth: "Resolver can hydrate summary or detailed ticket context.",
+          control: "Advanced actions stay policy-gated.",
+          media: "Surface supports text-first and hybrid assist modes.",
+          pace: "Transitions and confirmations adapt to operator pace.",
+          narrative: "Summary and evidence ordering stay explicit.",
+        },
+      },
+    },
+  },
+});`}),s("p",{className:"text-muted-foreground text-sm",children:"Expected output: `defineModuleBundle` validates the route, surface, and verification dimensions at runtime."})]}),C("div",{className:"space-y-3",children:[s("h2",{className:"font-bold text-2xl",children:"2) Resolve the plan"}),s("p",{className:"text-muted-foreground text-sm",children:"Resolve against a real route, device, and preference profile. This is where the runtime chooses the surface, layout, bindings, and audit reasons."}),s(D,{language:"typescript",filename:"src/runtime/resolve-support-workbench.ts",code:`import { resolveBundle } from "@contractspec/lib.surface-runtime/runtime/resolve-bundle";
 
-// src/components/docs/guides/GuideGenerateDocsClientsSchemasPage.tsx
-import { CodeBlock as CodeBlock4 } from "@contractspec/lib.design-system";
-import Link5 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight4 } from "lucide-react";
-import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
-function GuideGenerateDocsClientsSchemasPage() {
-  return /* @__PURE__ */ jsxs5("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs5("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx5("h1", {
-            className: "font-bold text-4xl",
-            children: "Generate docs + client schemas"
-          }),
-          /* @__PURE__ */ jsx5("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Generate docs and OpenAPI output from ContractSpec operations to power SDKs, docs sites, and tooling."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs5("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx5("h2", {
-            className: "font-bold text-2xl",
-            children: "What you'll build"
-          }),
-          /* @__PURE__ */ jsxs5("ul", {
-            className: "space-y-2 text-muted-foreground text-sm",
-            children: [
-              /* @__PURE__ */ jsx5("li", {
-                children: "Export docs from your specs."
-              }),
-              /* @__PURE__ */ jsx5("li", {
-                children: "Emit OpenAPI 3.1 for client SDK generation."
-              }),
-              /* @__PURE__ */ jsx5("li", {
-                children: "Keep outputs deterministic with CI validation."
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs5("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs5("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx5("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Generate docs"
-              }),
-              /* @__PURE__ */ jsx5("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Use the generator to emit docs from your contracts."
-              }),
-              /* @__PURE__ */ jsx5(CodeBlock4, {
-                language: "bash",
-                filename: "generate-docs",
-                code: `contractspec generate`
-              }),
-              /* @__PURE__ */ jsxs5("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: ",
-                  /* @__PURE__ */ jsx5("code", {
-                    children: "Generate X doc files in generated/docs"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs5("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx5("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Export OpenAPI"
-              }),
-              /* @__PURE__ */ jsx5("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Export an OpenAPI document from your registry module."
-              }),
-              /* @__PURE__ */ jsx5(CodeBlock4, {
-                language: "bash",
-                filename: "openapi-export",
-                code: `contractspec openapi export --registry ./src/contracts/registry.ts --out ./generated/openapi.json`
-              }),
-              /* @__PURE__ */ jsxs5("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output:",
-                  " ",
-                  /* @__PURE__ */ jsx5("code", {
-                    children: "OpenAPI written to .../generated/openapi.json"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs5("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx5("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Validate specs"
-              }),
-              /* @__PURE__ */ jsx5(CodeBlock4, {
-                language: "bash",
-                filename: "validate-specs",
-                code: `contractspec validate`
-              }),
-              /* @__PURE__ */ jsxs5("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: ",
-                  /* @__PURE__ */ jsx5("code", {
-                    children: "Validation passed"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs5("div", {
-            className: "card-subtle space-y-3 p-6",
-            children: [
-              /* @__PURE__ */ jsx5("h3", {
-                className: "font-semibold text-lg",
-                children: "Example package"
-              }),
-              /* @__PURE__ */ jsx5("p", {
-                className: "text-muted-foreground text-sm",
-                children: "The Integration Hub example provides a full registry of operations and is a good source for OpenAPI exports."
-              }),
-              /* @__PURE__ */ jsx5(CodeBlock4, {
-                language: "bash",
-                filename: "integration-hub-example",
-                code: `contractspec examples show integration-hub
+export const supportWorkbenchPlan = await resolveBundle(
+  SupportWorkbenchBundle,
+  {
+    tenantId: "tenant_demo",
+    workspaceId: "workspace_ops",
+    actorId: "user_42",
+    route: "/operate/support/tickets/123",
+    params: { ticketId: "123" },
+    query: {},
+    device: "desktop",
+    locale: "en",
+    preferences: {
+      guidance: "hints",
+      density: "compact",
+      dataDepth: "detailed",
+      control: "advanced",
+      media: "hybrid",
+      pace: "balanced",
+      narrative: "top-down",
+    },
+    capabilities: ["tickets.read", "tickets.update"],
+  }
+);`}),s("p",{className:"text-muted-foreground text-sm",children:"Expected output: a `ResolvedSurfacePlan` with `bundleKey`, `surfaceId`, `layoutId`, `bindings`, `adaptation`, and audit reasons."})]}),C("div",{className:"space-y-3",children:[s("h2",{className:"font-bold text-2xl",children:"3) Render the plan"}),s("p",{className:"text-muted-foreground text-sm",children:"The host app renders the resolved plan, not the raw spec. That keeps layout selection, overlays, and AI proposals downstream of the declared bundle contract."}),s(D,{language:"tsx",filename:"src/app/support/SurfaceHost.tsx",code:`import { BundleProvider, BundleRenderer } from "@contractspec/lib.surface-runtime/react";
+
+export function SurfaceHost() {
+  return (
+    <BundleProvider plan={supportWorkbenchPlan}>
+      <BundleRenderer assistantSlotId="assistant" />
+    </BundleProvider>
+  );
+}`}),s("p",{className:"text-muted-foreground text-sm",children:"Expected output: the route renders according to the resolved layout root and slot plan instead of bespoke page assembly."})]}),C("div",{className:"card-subtle space-y-3 p-6",children:[s("h3",{className:"font-semibold text-lg",children:"Verification checks"}),C("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[s("li",{children:"The resolved `surfaceId` matches the route you expected."}),s("li",{children:"The `layoutId` is stable for the active view and preferences."}),s("li",{children:"The plan carries audit reasons and all seven adaptation dimensions."}),s("li",{children:"Assistant or overlay work stays within declared slots."})]})]})]}),C("div",{className:"flex items-center gap-4 pt-4",children:[C(z,{href:"/docs/specs/module-bundles",className:"btn-primary",children:["Back to module bundles ",s(pe,{size:16})]}),s(z,{href:"/docs/specs/overlays",className:"btn-ghost",children:"Next: overlays"})]})]})}import{CodeBlock as T}from"@contractspec/lib.design-system";import V from"@contractspec/lib.ui-link";import{ChevronRight as ue}from"lucide-react";import{jsx as l,jsxs as y}from"react/jsx-runtime";function he(){return y("div",{className:"space-y-8",children:[y("div",{className:"space-y-3",children:[l("h1",{className:"font-bold text-4xl",children:"Generate docs + client schemas"}),l("p",{className:"text-lg text-muted-foreground",children:"Generate docs and OpenAPI output from ContractSpec operations to power SDKs, docs sites, and tooling."})]}),y("div",{className:"card-subtle space-y-4 p-6",children:[l("h2",{className:"font-bold text-2xl",children:"What you'll build"}),y("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[l("li",{children:"Export docs from your specs."}),l("li",{children:"Emit OpenAPI 3.1 for client SDK generation."}),l("li",{children:"Keep outputs deterministic with CI validation."})]})]}),y("div",{className:"space-y-6",children:[y("div",{className:"space-y-3",children:[l("h2",{className:"font-bold text-2xl",children:"1) Generate docs"}),l("p",{className:"text-muted-foreground text-sm",children:"Use the generator to emit docs from your contracts."}),l(T,{language:"bash",filename:"generate-docs",code:"contractspec generate"}),y("p",{className:"text-muted-foreground text-sm",children:["Expected output: ",l("code",{children:"Generate X doc files in generated/docs"}),"."]})]}),y("div",{className:"space-y-3",children:[l("h2",{className:"font-bold text-2xl",children:"2) Export OpenAPI"}),l("p",{className:"text-muted-foreground text-sm",children:"Export an OpenAPI document from your registry module."}),l(T,{language:"bash",filename:"openapi-export",code:"contractspec openapi export --registry ./src/contracts/registry.ts --out ./generated/openapi.json"}),y("p",{className:"text-muted-foreground text-sm",children:["Expected output:"," ",l("code",{children:"OpenAPI written to .../generated/openapi.json"}),"."]})]}),y("div",{className:"space-y-3",children:[l("h2",{className:"font-bold text-2xl",children:"3) Validate specs"}),l(T,{language:"bash",filename:"validate-specs",code:"contractspec validate"}),y("p",{className:"text-muted-foreground text-sm",children:["Expected output: ",l("code",{children:"Validation passed"}),"."]})]}),y("div",{className:"card-subtle space-y-3 p-6",children:[l("h3",{className:"font-semibold text-lg",children:"Example package"}),l("p",{className:"text-muted-foreground text-sm",children:"The Integration Hub example provides a full registry of operations and is a good source for OpenAPI exports."}),l(T,{language:"bash",filename:"integration-hub-example",code:`contractspec examples show integration-hub
 
 # openapi export against your registry module
-contractspec openapi export --registry ./src/contracts/registry.ts --out ./generated/openapi.json`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx5(StudioPrompt, {
-            title: "Want exports tied to product decisions?",
-            body: "Studio compiles approved changes into deliverables and pushes them to your execution stack with full evidence context."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs5("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs5(Link5, {
-            href: "/docs/guides/docs-generation-pipeline",
-            className: "btn-primary",
-            children: [
-              "Next: Docs pipeline ",
-              /* @__PURE__ */ jsx5(ChevronRight4, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx5(Link5, {
-            href: "/docs/guides",
-            className: "btn-ghost",
-            children: "Back to guides"
-          })
-        ]
-      })
-    ]
+contractspec openapi export --registry ./src/contracts/registry.ts --out ./generated/openapi.json`})]}),l(g,{title:"Want exports tied to product decisions?",body:"Studio compiles approved changes into deliverables and pushes them to your execution stack with full evidence context."})]}),y("div",{className:"flex items-center gap-4 pt-4",children:[y(V,{href:"/docs/guides/docs-generation-pipeline",className:"btn-primary",children:["Next: Docs pipeline ",l(ue,{size:16})]}),l(V,{href:"/docs/guides",className:"btn-ghost",children:"Back to guides"})]})]})}import{CodeBlock as I}from"@contractspec/lib.design-system";import Q from"@contractspec/lib.ui-link";import{ChevronRight as fe}from"lucide-react";import{jsx as n,jsxs as v}from"react/jsx-runtime";var ge=["builder.workspace.bootstrap","builder.channel.receiveInbound","builder.blueprint.generate","builder.plan.compile","builder.preview.create","builder.preview.runHarness","builder.export.prepare","builder.export.approve","builder.export.execute"];function ye(){return v("div",{className:"space-y-8",children:[v("div",{className:"space-y-3",children:[n("h1",{className:"font-bold text-4xl",children:"Host the Builder workbench"}),n("p",{className:"text-lg text-muted-foreground",children:"Use the reusable Builder workbench as the desktop control surface for snapshot loading, guided authoring, preview, readiness, export, and mobile review handoff."})]}),v("div",{className:"card-subtle space-y-4 p-6",children:[n("h2",{className:"font-bold text-2xl",children:"What you'll build"}),v("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[n("li",{children:"A workspace snapshot fetch path."}),n("li",{children:"A `BuilderWorkbench` host with action callbacks."}),n("li",{children:"Runtime-mode aware preview/export controls plus mobile review links."})]})]}),v("div",{className:"space-y-6",children:[v("div",{className:"space-y-3",children:[n("h2",{className:"font-bold text-2xl",children:"1) Fetch the workspace snapshot"}),n("p",{className:"text-muted-foreground text-sm",children:"The web shell already exposes a query path for the current Builder workspace snapshot. Your host should load it first, then refresh it after each successful command."}),n(I,{language:"typescript",filename:"builder-workbench-controller.ts",code:`export async function fetchBuilderSnapshot(workspaceId: string) {
+  const response = await fetch(
+    \`/api/operate/builder/queries/builder.workspace.snapshot?workspaceId=\${encodeURIComponent(workspaceId)}\`,
+    { cache: "no-store" }
+  );
+  if (!response.ok) {
+    throw new Error("Failed to fetch Builder workspace snapshot.");
+  }
+  const payload = await response.json() as {
+    ok: boolean;
+    result: BuilderWorkspaceSnapshot;
+  };
+  if (!payload.ok) {
+    throw new Error("Builder workspace snapshot query returned an error.");
+  }
+  return payload.result;
+}`}),n("p",{className:"text-muted-foreground text-sm",children:"Expected output: one `BuilderWorkspaceSnapshot` containing workspace, plan, providers, runtime targets, preview, export, and mobile review state."})]}),v("div",{className:"space-y-3",children:[n("h2",{className:"font-bold text-2xl",children:"2) Host the workbench and refresh on action"}),n("p",{className:"text-muted-foreground text-sm",children:"The simplest host pattern is local state plus a small action wrapper that executes one Builder command and then refreshes the snapshot."}),n(I,{language:"tsx",filename:"BuilderWorkbenchHost.tsx",code:`import {
+  BuilderWorkbench,
+  useBuilderWorkbenchState,
+} from "@contractspec/module.builder-workbench/presentation";
+
+const { snapshot, setSnapshot, promptDraft, setPromptDraft } =
+  useBuilderWorkbenchState({
+    workspace: initialSnapshot.workspace,
+    initialSnapshot,
   });
+
+async function runAction(commandKey: string, payload?: Record<string, unknown>) {
+  await executeBuilderCommand({ commandKey, workspaceId, payload });
+  setSnapshot(await fetchBuilderSnapshot(workspaceId));
 }
 
-// src/components/docs/guides/GuideImportExistingCodebasesPage.tsx
-import { CodeBlock as CodeBlock5 } from "@contractspec/lib.design-system";
-import Link6 from "@contractspec/lib.ui-link";
-import {
-  AlertCircle,
-  ChevronRight as ChevronRight5,
-  FileCode,
-  Scan,
-  Settings
-} from "lucide-react";
-import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
-var supportedFrameworks = [
-  {
-    name: "NestJS",
-    flag: "nestjs",
-    description: "Controllers, decorators, DTOs"
-  },
-  {
-    name: "Express",
-    flag: "express",
-    description: "Router methods, middleware"
-  },
-  {
-    name: "Fastify",
-    flag: "fastify",
-    description: "Route definitions, schemas"
-  },
-  {
-    name: "Hono",
-    flag: "hono",
-    description: "Route handlers, validators"
-  },
-  {
-    name: "Elysia",
-    flag: "elysia",
-    description: "Type-safe routes, schemas"
-  },
-  {
-    name: "tRPC",
-    flag: "trpc",
-    description: "Procedure definitions"
-  },
-  {
-    name: "Next.js",
-    flag: "next-api",
-    description: "API routes (app/api, pages/api)"
+<BuilderWorkbench
+  snapshot={snapshot}
+  promptDraft={promptDraft}
+  onPromptDraftChange={setPromptDraft}
+  onCapturePrompt={() =>
+    runAction("builder.channel.receiveInbound", createPromptEnvelope(workspaceId, promptDraft))
   }
-];
-function GuideImportExistingCodebasesPage() {
-  return /* @__PURE__ */ jsxs6("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs6("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx6("h1", {
-            className: "font-bold text-4xl",
-            children: "Import Existing Codebases"
-          }),
-          /* @__PURE__ */ jsx6("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Convert your existing API endpoints into ContractSpec contracts. Auto-detect frameworks, extract schemas, and generate explicit contract definitions from your code."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs6("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx6("h2", {
-            className: "font-bold text-2xl",
-            children: "What you'll learn"
-          }),
-          /* @__PURE__ */ jsxs6("ul", {
-            className: "space-y-2 text-muted-foreground text-sm",
-            children: [
-              /* @__PURE__ */ jsx6("li", {
-                children: "How to import existing API endpoints as ContractSpec contracts."
-              }),
-              /* @__PURE__ */ jsx6("li", {
-                children: "Framework-specific patterns and auto-detection."
-              }),
-              /* @__PURE__ */ jsx6("li", {
-                children: "Customizing imports with scopes, dry-run, and output options."
-              }),
-              /* @__PURE__ */ jsx6("li", {
-                children: "Registering imported contracts and adding handlers."
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs6("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "Why import existing code?"
-              }),
-              /* @__PURE__ */ jsx6("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Instead of writing contracts from scratch, the import command extracts endpoint patterns from your existing codebase. This gives you:"
-              }),
-              /* @__PURE__ */ jsxs6("ul", {
-                className: "list-disc space-y-1 pl-5 text-muted-foreground text-sm",
-                children: [
-                  /* @__PURE__ */ jsx6("li", {
-                    children: "Instant spec coverage for existing APIs"
-                  }),
-                  /* @__PURE__ */ jsx6("li", {
-                    children: "Type-safe schemas derived from your existing types"
-                  }),
-                  /* @__PURE__ */ jsx6("li", {
-                    children: "A foundation to iterate and refine contracts"
-                  }),
-                  /* @__PURE__ */ jsx6("li", {
-                    children: "Gradual adoption without rewriting code"
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "Supported frameworks"
-              }),
-              /* @__PURE__ */ jsx6("div", {
-                className: "grid gap-3 md:grid-cols-2 lg:grid-cols-3",
-                children: supportedFrameworks.map((fw) => /* @__PURE__ */ jsxs6("div", {
-                  className: "flex items-start gap-3 rounded-lg border border-white/10 p-4",
-                  children: [
-                    /* @__PURE__ */ jsx6(FileCode, {
-                      className: "text-violet-400",
-                      size: 18
-                    }),
-                    /* @__PURE__ */ jsxs6("div", {
-                      className: "space-y-1",
-                      children: [
-                        /* @__PURE__ */ jsx6("h3", {
-                          className: "font-semibold",
-                          children: fw.name
-                        }),
-                        /* @__PURE__ */ jsx6("p", {
-                          className: "text-muted-foreground text-xs",
-                          children: fw.description
-                        }),
-                        /* @__PURE__ */ jsxs6("code", {
-                          className: "text-violet-400 text-xs",
-                          children: [
-                            "--framework ",
-                            fw.flag
-                          ]
-                        })
-                      ]
-                    })
-                  ]
-                }, fw.flag))
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Quick start"
-              }),
-              /* @__PURE__ */ jsx6("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Run the import command to auto-detect your framework and extract endpoints:"
-              }),
-              /* @__PURE__ */ jsx6(CodeBlock5, {
-                language: "bash",
-                filename: "import-quickstart",
-                code: `# Auto-detect framework and import all endpoints
+  onGenerateBlueprint={() => runAction("builder.blueprint.generate")}
+  onCompilePlan={() => runAction("builder.plan.compile")}
+  onCreatePreview={() => runAction("builder.preview.create", { runtimeMode: "hybrid" })}
+  onRunReadiness={() => runAction("builder.preview.runHarness")}
+  onPrepareExport={() => runAction("builder.export.prepare", { runtimeMode: "hybrid" })}
+  onApproveExport={() => runAction("builder.export.approve")}
+  onExecuteExport={() => runAction("builder.export.execute")}
+  selectedExportRuntimeMode="hybrid"
+/>;`}),n("p",{className:"text-muted-foreground text-sm",children:"Expected output: each successful action leaves the host with a fresh snapshot and keeps the workbench tabs aligned with current runtime state."})]}),v("div",{className:"space-y-3",children:[n("h2",{className:"font-bold text-2xl",children:"3) Bootstrap providers and routing policy explicitly"}),n("p",{className:"text-muted-foreground text-sm",children:"Builder v3 treats provider routing as policy, not heuristic. Use the workspace bootstrap command as the single managed-first setup path instead of orchestrating provider registration in the app shell."}),n(I,{language:"typescript",filename:"builder-bootstrap.ts",code:`await executeBuilderCommand({
+  commandKey: "builder.workspace.bootstrap",
+  workspaceId,
+  payload: {
+    preset: "managed_mvp",
+    includeLocalHelperProvider: true,
+  },
+});`})]}),v("div",{className:"card-subtle space-y-3 p-6",children:[n("h3",{className:"font-semibold text-lg",children:"Common command keys"}),n("ul",{className:"space-y-2 text-muted-foreground text-sm",children:ge.map((c)=>n("li",{children:n("code",{children:c})},c))})]}),v("div",{className:"space-y-3",children:[n("h2",{className:"font-bold text-2xl",children:"4) Keep runtime mode explicit"}),n("p",{className:"text-muted-foreground text-sm",children:"Preview and export flows are runtime-mode aware. The host chooses between `managed`, `local`, and `hybrid` and passes that choice into preview or export commands instead of hiding it behind provider selection heuristics."}),n(I,{language:"typescript",filename:"runtime-mode",code:`const [selectedExportRuntimeMode, setSelectedExportRuntimeMode] =
+  React.useState(resolveBuilderExportRuntimeMode(initialSnapshot));
+
+await executeBuilderCommand({
+  commandKey: "builder.preview.create",
+  workspaceId,
+  payload: {
+    runtimeMode: selectedExportRuntimeMode,
+  },
+	});`})]}),v("div",{className:"space-y-3",children:[n("h2",{className:"font-bold text-2xl",children:"5) Link mobile review flows"}),n("p",{className:"text-muted-foreground text-sm",children:"When a patch proposal, approval ticket, or incident needs operator follow-up away from the desktop workbench, deep-link into the mobile review route instead of inventing a separate data model."}),n(I,{language:"typescript",filename:"mobile-review-path.ts",code:`export function buildBuilderMobileReviewPath(
+  workspaceId: string,
+  cardId: string
+) {
+  return \`/operate/builder/workspaces/\${encodeURIComponent(workspaceId)}/mobile-review/\${encodeURIComponent(cardId)}\`;
+}`}),n("p",{className:"text-muted-foreground text-sm",children:"Expected output: the same Builder workspace state stays visible from desktop workbench and mobile review surfaces."})]}),v("div",{className:"space-y-3",children:[n("h2",{className:"font-bold text-2xl",children:"6) Keep Connect adjacent, not embedded"}),n("p",{className:"text-muted-foreground text-sm",children:"Builder owns the authoring control plane. When Builder delegates into coding repositories, enable Connect in those target workspaces for context packs, mutation verification, replay, and review packets, but do not replace Builder contracts with Connect artifacts."}),n(I,{language:"bash",filename:"connect-init.sh",code:"contractspec connect init --scope workspace"})]})]}),v("div",{className:"flex items-center gap-4 pt-4",children:[v(Q,{href:"/docs/specs/builder-control-plane",className:"btn-primary",children:["Back to Builder control plane ",n(fe,{size:16})]}),n(Q,{href:"/docs/studio",className:"btn-ghost",children:"Studio overview"})]})]})}import{CodeBlock as S}from"@contractspec/lib.design-system";import q from"@contractspec/lib.ui-link";import{AlertCircle as ve,ChevronRight as be,FileCode as Ne,Scan as M,Settings as ke}from"lucide-react";import{jsx as e,jsxs as a}from"react/jsx-runtime";var we=[{name:"NestJS",flag:"nestjs",description:"Controllers, decorators, DTOs"},{name:"Express",flag:"express",description:"Router methods, middleware"},{name:"Fastify",flag:"fastify",description:"Route definitions, schemas"},{name:"Hono",flag:"hono",description:"Route handlers, validators"},{name:"Elysia",flag:"elysia",description:"Type-safe routes, schemas"},{name:"tRPC",flag:"trpc",description:"Procedure definitions"},{name:"Next.js",flag:"next-api",description:"API routes (app/api, pages/api)"}];function Ce(){return a("div",{className:"space-y-8",children:[a("div",{className:"space-y-3",children:[e("h1",{className:"font-bold text-4xl",children:"Import Existing Codebases"}),e("p",{className:"text-lg text-muted-foreground",children:"Convert your existing API endpoints into ContractSpec contracts. Auto-detect frameworks, extract schemas, and generate explicit contract definitions from your code."})]}),a("div",{className:"card-subtle space-y-4 p-6",children:[e("h2",{className:"font-bold text-2xl",children:"What you'll learn"}),a("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[e("li",{children:"How to import existing API endpoints as ContractSpec contracts."}),e("li",{children:"Framework-specific patterns and auto-detection."}),e("li",{children:"Customizing imports with scopes, dry-run, and output options."}),e("li",{children:"Registering imported contracts and adding handlers."})]})]}),a("div",{className:"space-y-6",children:[a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Why import existing code?"}),e("p",{className:"text-muted-foreground text-sm",children:"Instead of writing contracts from scratch, the import command extracts endpoint patterns from your existing codebase. This gives you:"}),a("ul",{className:"list-disc space-y-1 pl-5 text-muted-foreground text-sm",children:[e("li",{children:"Instant spec coverage for existing APIs"}),e("li",{children:"Type-safe schemas derived from your existing types"}),e("li",{children:"A foundation to iterate and refine contracts"}),e("li",{children:"Gradual adoption without rewriting code"})]})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Supported frameworks"}),e("div",{className:"grid gap-3 md:grid-cols-2 lg:grid-cols-3",children:we.map((c)=>a("div",{className:"flex items-start gap-3 rounded-lg border border-white/10 p-4",children:[e(Ne,{className:"text-violet-400",size:18}),a("div",{className:"space-y-1",children:[e("h3",{className:"font-semibold",children:c.name}),e("p",{className:"text-muted-foreground text-xs",children:c.description}),a("code",{className:"text-violet-400 text-xs",children:["--framework ",c.flag]})]})]},c.flag))})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"1) Quick start"}),e("p",{className:"text-muted-foreground text-sm",children:"Run the import command to auto-detect your framework and extract endpoints:"}),e(S,{language:"bash",filename:"import-quickstart",code:`# Auto-detect framework and import all endpoints
 contractspec import ./src
 
 # Preview what would be imported (dry-run)
 contractspec import ./src --dry-run
 
 # Force a specific framework
-contractspec import ./src --framework nestjs`
-              }),
-              /* @__PURE__ */ jsx6("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Expected output: A summary of endpoints found, schemas extracted, and files generated."
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Framework-specific patterns"
-              }),
-              /* @__PURE__ */ jsx6("p", {
-                className: "text-muted-foreground text-sm",
-                children: "The import command recognizes these patterns in each framework:"
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs6("h3", {
-                className: "flex items-center gap-2 font-semibold text-xl",
-                children: [
-                  /* @__PURE__ */ jsx6(Scan, {
-                    size: 18,
-                    className: "text-blue-400"
-                  }),
-                  "NestJS"
-                ]
-              }),
-              /* @__PURE__ */ jsx6(CodeBlock5, {
-                language: "typescript",
-                filename: "src/users/users.controller.ts (before)",
-                code: `@Controller('users')
+contractspec import ./src --framework nestjs`}),e("p",{className:"text-muted-foreground text-sm",children:"Expected output: A summary of endpoints found, schemas extracted, and files generated."})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"2) Framework-specific patterns"}),e("p",{className:"text-muted-foreground text-sm",children:"The import command recognizes these patterns in each framework:"})]}),a("div",{className:"space-y-3",children:[a("h3",{className:"flex items-center gap-2 font-semibold text-xl",children:[e(M,{size:18,className:"text-blue-400"}),"NestJS"]}),e(S,{language:"typescript",filename:"src/users/users.controller.ts (before)",code:`@Controller('users')
 export class UsersController {
   @Get(':id')
   async getUser(@Param('id') id: string): Promise<UserDto> {
@@ -1510,59 +429,7 @@ export class UsersController {
   async createUser(@Body() dto: CreateUserDto): Promise<UserDto> {
     return this.usersService.create(dto);
   }
-}`
-              }),
-              /* @__PURE__ */ jsxs6("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Detected: ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "@Controller"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "@Get"
-                  }),
-                  ",",
-                  " ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "@Post"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "@Body"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "@Param"
-                  }),
-                  ",",
-                  " ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "@UseGuards"
-                  }),
-                  " decorators."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs6("h3", {
-                className: "flex items-center gap-2 font-semibold text-xl",
-                children: [
-                  /* @__PURE__ */ jsx6(Scan, {
-                    size: 18,
-                    className: "text-green-400"
-                  }),
-                  "Express"
-                ]
-              }),
-              /* @__PURE__ */ jsx6(CodeBlock5, {
-                language: "typescript",
-                filename: "src/routes/users.ts (before)",
-                code: `const router = express.Router();
+}`}),a("p",{className:"text-muted-foreground text-sm",children:["Detected: ",e("code",{children:"@Controller"}),", ",e("code",{children:"@Get"}),","," ",e("code",{children:"@Post"}),", ",e("code",{children:"@Body"}),", ",e("code",{children:"@Param"}),","," ",e("code",{children:"@UseGuards"})," decorators."]})]}),a("div",{className:"space-y-3",children:[a("h3",{className:"flex items-center gap-2 font-semibold text-xl",children:[e(M,{size:18,className:"text-green-400"}),"Express"]}),e(S,{language:"typescript",filename:"src/routes/users.ts (before)",code:`const router = express.Router();
 
 router.get('/users/:id', async (req, res) => {
   const user = await getUserById(req.params.id);
@@ -1572,41 +439,7 @@ router.get('/users/:id', async (req, res) => {
 router.post('/users', validateBody(CreateUserSchema), async (req, res) => {
   const user = await createUser(req.body);
   res.status(201).json(user);
-});`
-              }),
-              /* @__PURE__ */ jsxs6("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Detected: ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "router.get"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "router.post"
-                  }),
-                  ", validation middleware, Zod schemas."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs6("h3", {
-                className: "flex items-center gap-2 font-semibold text-xl",
-                children: [
-                  /* @__PURE__ */ jsx6(Scan, {
-                    size: 18,
-                    className: "text-purple-400"
-                  }),
-                  "Next.js API Routes"
-                ]
-              }),
-              /* @__PURE__ */ jsx6(CodeBlock5, {
-                language: "typescript",
-                filename: "app/api/users/[id]/route.ts (before)",
-                code: `export async function GET(
+});`}),a("p",{className:"text-muted-foreground text-sm",children:["Detected: ",e("code",{children:"router.get"}),", ",e("code",{children:"router.post"}),", validation middleware, Zod schemas."]})]}),a("div",{className:"space-y-3",children:[a("h3",{className:"flex items-center gap-2 font-semibold text-xl",children:[e(M,{size:18,className:"text-purple-400"}),"Next.js API Routes"]}),e(S,{language:"typescript",filename:"app/api/users/[id]/route.ts (before)",code:`export async function GET(
   request: Request,
   { params }: { params: { id: string } }
 ) {
@@ -1618,48 +451,7 @@ export async function POST(request: Request) {
   const body = await request.json();
   const user = await createUser(body);
   return Response.json(user, { status: 201 });
-}`
-              }),
-              /* @__PURE__ */ jsxs6("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Detected: ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "GET"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "POST"
-                  }),
-                  " exports in",
-                  " ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "app/api/**/route.ts"
-                  }),
-                  " and ",
-                  /* @__PURE__ */ jsx6("code", {
-                    children: "pages/api/**/*.ts"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Understanding generated contracts"
-              }),
-              /* @__PURE__ */ jsx6("p", {
-                className: "text-muted-foreground text-sm",
-                children: "The import command generates ContractSpec operations with TODO placeholders for fields it cannot infer:"
-              }),
-              /* @__PURE__ */ jsx6(CodeBlock5, {
-                language: "typescript",
-                filename: ".contractspec/generated/users.operation.ts",
-                code: `import { defineQuery, defineCommand } from "@contractspec/lib.contracts-spec";
+}`}),a("p",{className:"text-muted-foreground text-sm",children:["Detected: ",e("code",{children:"GET"}),", ",e("code",{children:"POST"})," exports in"," ",e("code",{children:"app/api/**/route.ts"})," and ",e("code",{children:"pages/api/**/*.ts"}),"."]})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"3) Understanding generated contracts"}),e("p",{className:"text-muted-foreground text-sm",children:"The import command generates ContractSpec operations with TODO placeholders for fields it cannot infer:"}),e(S,{language:"typescript",filename:".contractspec/generated/users.operation.ts",code:`import { defineQuery, defineCommand } from "@contractspec/lib.contracts-spec";
 import { SchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 
 export const GetUserQuery = defineQuery({
@@ -1719,191 +511,7 @@ export const CreateUserCommand = defineCommand({
   transport: {
     rest: { method: "POST", path: "/users" },
   },
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "4) Customizing imports"
-              }),
-              /* @__PURE__ */ jsxs6("div", {
-                className: "flex items-center gap-2",
-                children: [
-                  /* @__PURE__ */ jsx6(Settings, {
-                    size: 18,
-                    className: "text-violet-400"
-                  }),
-                  /* @__PURE__ */ jsx6("h3", {
-                    className: "font-semibold text-lg",
-                    children: "Available options"
-                  })
-                ]
-              }),
-              /* @__PURE__ */ jsx6("div", {
-                className: "overflow-x-auto",
-                children: /* @__PURE__ */ jsxs6("table", {
-                  className: "w-full text-sm",
-                  children: [
-                    /* @__PURE__ */ jsx6("thead", {
-                      children: /* @__PURE__ */ jsxs6("tr", {
-                        className: "border-white/10 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx6("th", {
-                            className: "py-2 pr-4 text-left",
-                            children: "Option"
-                          }),
-                          /* @__PURE__ */ jsx6("th", {
-                            className: "py-2 pr-4 text-left",
-                            children: "Description"
-                          }),
-                          /* @__PURE__ */ jsx6("th", {
-                            className: "py-2 text-left",
-                            children: "Example"
-                          })
-                        ]
-                      })
-                    }),
-                    /* @__PURE__ */ jsxs6("tbody", {
-                      className: "text-muted-foreground",
-                      children: [
-                        /* @__PURE__ */ jsxs6("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--scope"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: "Limit to specific directories"
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--scope src/users src/auth"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs6("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--framework"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: "Force a specific framework"
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--framework express"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs6("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--output"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: "Output directory"
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--output ./contracts"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs6("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--dry-run"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: "Preview without writing files"
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--dry-run"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs6("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--analyze"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: "Analysis only, no code generation"
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--analyze"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs6("tr", {
-                          children: [
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--json"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2 pr-4",
-                              children: "Output as JSON for scripting"
-                            }),
-                            /* @__PURE__ */ jsx6("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx6("code", {
-                                children: "--json"
-                              })
-                            })
-                          ]
-                        })
-                      ]
-                    })
-                  ]
-                })
-              }),
-              /* @__PURE__ */ jsx6(CodeBlock5, {
-                language: "bash",
-                filename: "import-options",
-                code: `# Import only specific modules
+});`})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"4) Customizing imports"}),a("div",{className:"flex items-center gap-2",children:[e(ke,{size:18,className:"text-violet-400"}),e("h3",{className:"font-semibold text-lg",children:"Available options"})]}),e("div",{className:"overflow-x-auto",children:a("table",{className:"w-full text-sm",children:[e("thead",{children:a("tr",{className:"border-white/10 border-b",children:[e("th",{className:"py-2 pr-4 text-left",children:"Option"}),e("th",{className:"py-2 pr-4 text-left",children:"Description"}),e("th",{className:"py-2 text-left",children:"Example"})]})}),a("tbody",{className:"text-muted-foreground",children:[a("tr",{className:"border-white/5 border-b",children:[e("td",{className:"py-2 pr-4",children:e("code",{children:"--scope"})}),e("td",{className:"py-2 pr-4",children:"Limit to specific directories"}),e("td",{className:"py-2",children:e("code",{children:"--scope src/users src/auth"})})]}),a("tr",{className:"border-white/5 border-b",children:[e("td",{className:"py-2 pr-4",children:e("code",{children:"--framework"})}),e("td",{className:"py-2 pr-4",children:"Force a specific framework"}),e("td",{className:"py-2",children:e("code",{children:"--framework express"})})]}),a("tr",{className:"border-white/5 border-b",children:[e("td",{className:"py-2 pr-4",children:e("code",{children:"--output"})}),e("td",{className:"py-2 pr-4",children:"Output directory"}),e("td",{className:"py-2",children:e("code",{children:"--output ./contracts"})})]}),a("tr",{className:"border-white/5 border-b",children:[e("td",{className:"py-2 pr-4",children:e("code",{children:"--dry-run"})}),e("td",{className:"py-2 pr-4",children:"Preview without writing files"}),e("td",{className:"py-2",children:e("code",{children:"--dry-run"})})]}),a("tr",{className:"border-white/5 border-b",children:[e("td",{className:"py-2 pr-4",children:e("code",{children:"--analyze"})}),e("td",{className:"py-2 pr-4",children:"Analysis only, no code generation"}),e("td",{className:"py-2",children:e("code",{children:"--analyze"})})]}),a("tr",{children:[e("td",{className:"py-2 pr-4",children:e("code",{children:"--json"})}),e("td",{className:"py-2 pr-4",children:"Output as JSON for scripting"}),e("td",{className:"py-2",children:e("code",{children:"--json"})})]})]})]})}),e(S,{language:"bash",filename:"import-options",code:`# Import only specific modules
 contractspec import ./src --scope src/users src/orders
 
 # Preview with analysis
@@ -1913,25 +521,7 @@ contractspec import ./src --dry-run --analyze
 contractspec import ./src --output ./src/contracts/generated
 
 # Get JSON for CI/scripting
-contractspec import ./src --json > import-result.json`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "5) Registering imported contracts"
-              }),
-              /* @__PURE__ */ jsx6("p", {
-                className: "text-muted-foreground text-sm",
-                children: "After import, register contracts and add handlers:"
-              }),
-              /* @__PURE__ */ jsx6(CodeBlock5, {
-                language: "typescript",
-                filename: "src/contracts/registry.ts",
-                code: `import {
+contractspec import ./src --json > import-result.json`})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"5) Registering imported contracts"}),e("p",{className:"text-muted-foreground text-sm",children:"After import, register contracts and add handlers:"}),e(S,{language:"typescript",filename:"src/contracts/registry.ts",code:`import {
   OperationSpecRegistry,
   installOp,
 } from "@contractspec/lib.contracts-spec/operations";
@@ -1951,271 +541,8 @@ installOp(registry, GetUserQuery, async (input) => {
 installOp(registry, CreateUserCommand, async (input) => {
   const user = await db.user.create({ data: input });
   return { id: user.id };
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx6("h2", {
-                className: "font-bold text-2xl",
-                children: "6) After importing"
-              }),
-              /* @__PURE__ */ jsxs6("ol", {
-                className: "list-decimal space-y-2 pl-5 text-muted-foreground text-sm",
-                children: [
-                  /* @__PURE__ */ jsxs6("li", {
-                    children: [
-                      /* @__PURE__ */ jsx6("strong", {
-                        children: "Review generated contracts"
-                      }),
-                      " \u2014 Check the TODO placeholders and fill in descriptions, owners, and tags."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs6("li", {
-                    children: [
-                      /* @__PURE__ */ jsx6("strong", {
-                        children: "Refine schemas"
-                      }),
-                      " \u2014 Add proper types, validation rules, and error definitions."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs6("li", {
-                    children: [
-                      /* @__PURE__ */ jsx6("strong", {
-                        children: "Run validation"
-                      }),
-                      " \u2014",
-                      " ",
-                      /* @__PURE__ */ jsx6("code", {
-                        children: "contractspec validate"
-                      }),
-                      " to ensure contracts are valid."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs6("li", {
-                    children: [
-                      /* @__PURE__ */ jsx6("strong", {
-                        children: "Register and wire handlers"
-                      }),
-                      " \u2014 Connect contracts to your existing business logic."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs6("li", {
-                    children: [
-                      /* @__PURE__ */ jsx6("strong", {
-                        children: "Iterate"
-                      }),
-                      " \u2014 The imported contracts are a starting point. Refine them as your spec matures."
-                    ]
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs6("h2", {
-                className: "flex items-center gap-2 font-bold text-2xl",
-                children: [
-                  /* @__PURE__ */ jsx6(AlertCircle, {
-                    size: 20,
-                    className: "text-yellow-400"
-                  }),
-                  "Troubleshooting"
-                ]
-              }),
-              /* @__PURE__ */ jsxs6("div", {
-                className: "space-y-4",
-                children: [
-                  /* @__PURE__ */ jsxs6("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx6("h3", {
-                        className: "font-semibold",
-                        children: "Framework not detected"
-                      }),
-                      /* @__PURE__ */ jsxs6("p", {
-                        className: "text-muted-foreground text-sm",
-                        children: [
-                          "Use ",
-                          /* @__PURE__ */ jsx6("code", {
-                            children: "--framework <name>"
-                          }),
-                          " to force a specific framework. Check that your entry files follow standard patterns."
-                        ]
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs6("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx6("h3", {
-                        className: "font-semibold",
-                        children: "Missing schemas"
-                      }),
-                      /* @__PURE__ */ jsxs6("p", {
-                        className: "text-muted-foreground text-sm",
-                        children: [
-                          "Schema inference works best with explicit types. If using",
-                          " ",
-                          /* @__PURE__ */ jsx6("code", {
-                            children: "any"
-                          }),
-                          " or dynamic types, you'll see TODO placeholders. Fill them in manually."
-                        ]
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs6("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx6("h3", {
-                        className: "font-semibold",
-                        children: "Partial imports"
-                      }),
-                      /* @__PURE__ */ jsxs6("p", {
-                        className: "text-muted-foreground text-sm",
-                        children: [
-                          "Some endpoints may not be detected if they use unconventional patterns. Use ",
-                          /* @__PURE__ */ jsx6("code", {
-                            children: "--analyze"
-                          }),
-                          " to see what was found, then add missing contracts manually."
-                        ]
-                      })
-                    ]
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx6(StudioPrompt, {
-            title: "Want evidence-driven migration priorities?",
-            body: "Studio clusters product signals into scored patterns, then proposes contract changes and execution-ready work for the highest-impact areas."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs6("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs6(Link6, {
-            href: "/docs/guides/spec-validation-and-typing",
-            className: "btn-primary",
-            children: [
-              "Next: Spec validation + typing ",
-              /* @__PURE__ */ jsx6(ChevronRight5, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx6(Link6, {
-            href: "/docs/guides",
-            className: "btn-ghost",
-            children: "Back to guides"
-          })
-        ]
-      })
-    ]
-  });
-}
-
-// src/components/docs/guides/GuideNextjsOneEndpointPage.tsx
-import { CodeBlock as CodeBlock6 } from "@contractspec/lib.design-system";
-import Link7 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight6 } from "lucide-react";
-import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
-function GuideNextjsOneEndpointPage() {
-  return /* @__PURE__ */ jsxs7("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs7("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx7("h1", {
-            className: "font-bold text-4xl",
-            children: "Next.js: add one endpoint"
-          }),
-          /* @__PURE__ */ jsx7("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Add ContractSpec to an existing Next.js App Router project by wiring a single operation end-to-end with validation and types."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs7("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx7("h2", {
-            className: "font-bold text-2xl",
-            children: "What you'll build"
-          }),
-          /* @__PURE__ */ jsxs7("ul", {
-            className: "space-y-2 text-muted-foreground text-sm",
-            children: [
-              /* @__PURE__ */ jsx7("li", {
-                children: "One OperationSpec with SchemaModel validation."
-              }),
-              /* @__PURE__ */ jsx7("li", {
-                children: "A registry wiring the operation to its handler."
-              }),
-              /* @__PURE__ */ jsx7("li", {
-                children: "A Next.js route handler that exposes the operation."
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs7("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs7("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx7("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Install core packages"
-              }),
-              /* @__PURE__ */ jsx7(CodeBlock6, {
-                language: "bash",
-                filename: "nextjs-install",
-                code: `bun add -D contractspec
-bun add @contractspec/lib.contracts-spec @contractspec/lib.contracts-runtime-server-rest @contractspec/lib.schema`
-              }),
-              /* @__PURE__ */ jsxs7("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: ",
-                  /* @__PURE__ */ jsx7("code", {
-                    children: "added 3 packages"
-                  }),
-                  " and a lockfile update."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs7("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx7("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Define the operation spec"
-              }),
-              /* @__PURE__ */ jsxs7("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Create ",
-                  /* @__PURE__ */ jsx7("code", {
-                    children: "src/contracts/healthcheck.operation.ts"
-                  }),
-                  ":"
-                ]
-              }),
-              /* @__PURE__ */ jsx7(CodeBlock6, {
-                language: "typescript",
-                filename: "src/contracts/healthcheck.operation.ts",
-                code: `import { defineQuery } from "@contractspec/lib.contracts-spec/operations";
+});`})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"6) After importing"}),a("ol",{className:"list-decimal space-y-2 pl-5 text-muted-foreground text-sm",children:[a("li",{children:[e("strong",{children:"Review generated contracts"})," \u2014 Check the TODO placeholders and fill in descriptions, owners, and tags."]}),a("li",{children:[e("strong",{children:"Refine schemas"})," \u2014 Add proper types, validation rules, and error definitions."]}),a("li",{children:[e("strong",{children:"Run validation"})," \u2014"," ",e("code",{children:"contractspec validate"})," to ensure contracts are valid."]}),a("li",{children:[e("strong",{children:"Register and wire handlers"})," \u2014 Connect contracts to your existing business logic."]}),a("li",{children:[e("strong",{children:"Iterate"})," \u2014 The imported contracts are a starting point. Refine them as your spec matures."]})]})]}),a("div",{className:"space-y-3",children:[a("h2",{className:"flex items-center gap-2 font-bold text-2xl",children:[e(ve,{size:20,className:"text-yellow-400"}),"Troubleshooting"]}),a("div",{className:"space-y-4",children:[a("div",{className:"card-subtle space-y-2 p-4",children:[e("h3",{className:"font-semibold",children:"Framework not detected"}),a("p",{className:"text-muted-foreground text-sm",children:["Use ",e("code",{children:"--framework <name>"})," to force a specific framework. Check that your entry files follow standard patterns."]})]}),a("div",{className:"card-subtle space-y-2 p-4",children:[e("h3",{className:"font-semibold",children:"Missing schemas"}),a("p",{className:"text-muted-foreground text-sm",children:["Schema inference works best with explicit types. If using"," ",e("code",{children:"any"})," or dynamic types, you'll see TODO placeholders. Fill them in manually."]})]}),a("div",{className:"card-subtle space-y-2 p-4",children:[e("h3",{className:"font-semibold",children:"Partial imports"}),a("p",{className:"text-muted-foreground text-sm",children:["Some endpoints may not be detected if they use unconventional patterns. Use ",e("code",{children:"--analyze"})," to see what was found, then add missing contracts manually."]})]})]})]}),e(g,{title:"Want evidence-driven migration priorities?",body:"Studio clusters product signals into scored patterns, then proposes contract changes and execution-ready work for the highest-impact areas."})]}),a("div",{className:"flex items-center gap-4 pt-4",children:[a(q,{href:"/docs/guides/spec-validation-and-typing",className:"btn-primary",children:["Next: Spec validation + typing ",e(be,{size:16})]}),e(q,{href:"/docs/guides",className:"btn-ghost",children:"Back to guides"})]})]})}import{CodeBlock as E}from"@contractspec/lib.design-system";import F from"@contractspec/lib.ui-link";import{ChevronRight as Se}from"lucide-react";import{jsx as r,jsxs as u}from"react/jsx-runtime";function Ie(){return u("div",{className:"space-y-8",children:[u("div",{className:"space-y-3",children:[r("h1",{className:"font-bold text-4xl",children:"Next.js: add one endpoint"}),r("p",{className:"text-lg text-muted-foreground",children:"Add ContractSpec to an existing Next.js App Router project by wiring a single operation end-to-end with validation and types."})]}),u("div",{className:"card-subtle space-y-4 p-6",children:[r("h2",{className:"font-bold text-2xl",children:"What you'll build"}),u("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[r("li",{children:"One OperationSpec with SchemaModel validation."}),r("li",{children:"A registry wiring the operation to its handler."}),r("li",{children:"A Next.js route handler that exposes the operation."})]})]}),u("div",{className:"space-y-6",children:[u("div",{className:"space-y-3",children:[r("h2",{className:"font-bold text-2xl",children:"1) Install core packages"}),r(E,{language:"bash",filename:"nextjs-install",code:`bun add -D contractspec
+bun add @contractspec/lib.contracts-spec @contractspec/lib.contracts-runtime-server-rest @contractspec/lib.schema`}),u("p",{className:"text-muted-foreground text-sm",children:["Expected output: ",r("code",{children:"added 3 packages"})," and a lockfile update."]})]}),u("div",{className:"space-y-3",children:[r("h2",{className:"font-bold text-2xl",children:"2) Define the operation spec"}),u("p",{className:"text-muted-foreground text-sm",children:["Create ",r("code",{children:"src/contracts/healthcheck.operation.ts"}),":"]}),r(E,{language:"typescript",filename:"src/contracts/healthcheck.operation.ts",code:`import { defineQuery } from "@contractspec/lib.contracts-spec/operations";
 import { SchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 
 const HealthcheckOutput = new SchemaModel({
@@ -2246,31 +573,7 @@ export const HealthcheckQuery = defineQuery({
     gql: { field: "healthcheck_get" },
     mcp: { toolName: "healthcheck_get-v1" },
   },
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs7("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx7("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Register the operation"
-              }),
-              /* @__PURE__ */ jsxs7("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Create ",
-                  /* @__PURE__ */ jsx7("code", {
-                    children: "src/contracts/registry.ts"
-                  }),
-                  ":"
-                ]
-              }),
-              /* @__PURE__ */ jsx7(CodeBlock6, {
-                language: "typescript",
-                filename: "src/contracts/registry.ts",
-                code: `import {
+});`})]}),u("div",{className:"space-y-3",children:[r("h2",{className:"font-bold text-2xl",children:"3) Register the operation"}),u("p",{className:"text-muted-foreground text-sm",children:["Create ",r("code",{children:"src/contracts/registry.ts"}),":"]}),r(E,{language:"typescript",filename:"src/contracts/registry.ts",code:`import {
   OperationSpecRegistry,
   installOp,
 } from "@contractspec/lib.contracts-spec/operations";
@@ -2281,31 +584,7 @@ export const registry = new OperationSpecRegistry();
 installOp(registry, HealthcheckQuery, async () => ({
   status: "ok",
   checkedAt: new Date().toISOString(),
-}));`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs7("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx7("h2", {
-                className: "font-bold text-2xl",
-                children: "4) Add the Next.js handler"
-              }),
-              /* @__PURE__ */ jsxs7("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Create ",
-                  /* @__PURE__ */ jsx7("code", {
-                    children: "app/api/ops/[...route]/route.ts"
-                  }),
-                  ":"
-                ]
-              }),
-              /* @__PURE__ */ jsx7(CodeBlock6, {
-                language: "typescript",
-                filename: "app/api/ops/[...route]/route.ts",
-                code: `import { makeNextAppHandler } from "@contractspec/lib.contracts-runtime-server-rest/rest-next-app";
+}));`})]}),u("div",{className:"space-y-3",children:[r("h2",{className:"font-bold text-2xl",children:"4) Add the Next.js handler"}),u("p",{className:"text-muted-foreground text-sm",children:["Create ",r("code",{children:"app/api/ops/[...route]/route.ts"}),":"]}),r(E,{language:"typescript",filename:"app/api/ops/[...route]/route.ts",code:`import { makeNextAppHandler } from "@contractspec/lib.contracts-runtime-server-rest/rest-next-app";
 import { registry } from "@/contracts/registry";
 
 const handler = makeNextAppHandler(registry, async () => ({
@@ -2313,171 +592,11 @@ const handler = makeNextAppHandler(registry, async () => ({
   tenantId: "public",
 }));
 
-export { handler as GET, handler as POST };`
-              }),
-              /* @__PURE__ */ jsxs7("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: the route responds at",
-                  /* @__PURE__ */ jsx7("code", {
-                    children: " /api/ops/healthcheck.get"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs7("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx7("h2", {
-                className: "font-bold text-2xl",
-                children: "5) Validate the spec"
-              }),
-              /* @__PURE__ */ jsx7(CodeBlock6, {
-                language: "bash",
-                filename: "nextjs-validate",
-                code: `contractspec validate src/contracts/healthcheck.operation.ts`
-              }),
-              /* @__PURE__ */ jsxs7("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: ",
-                  /* @__PURE__ */ jsx7("code", {
-                    children: "Validation passed"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs7("div", {
-            className: "card-subtle space-y-3 p-6",
-            children: [
-              /* @__PURE__ */ jsx7("h3", {
-                className: "font-semibold text-lg",
-                children: "Example package"
-              }),
-              /* @__PURE__ */ jsxs7("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Use ",
-                  /* @__PURE__ */ jsx7("code", {
-                    children: "@contractspec/example.lifecycle-dashboard"
-                  }),
-                  " as a lightweight Next.js snippet reference."
-                ]
-              }),
-              /* @__PURE__ */ jsx7(CodeBlock6, {
-                language: "bash",
-                filename: "nextjs-example",
-                code: `# Inspect the example docs
+export { handler as GET, handler as POST };`}),u("p",{className:"text-muted-foreground text-sm",children:["Expected output: the route responds at",r("code",{children:" /api/ops/healthcheck.get"}),"."]})]}),u("div",{className:"space-y-3",children:[r("h2",{className:"font-bold text-2xl",children:"5) Validate the spec"}),r(E,{language:"bash",filename:"nextjs-validate",code:"contractspec validate src/contracts/healthcheck.operation.ts"}),u("p",{className:"text-muted-foreground text-sm",children:["Expected output: ",r("code",{children:"Validation passed"}),"."]})]}),u("div",{className:"card-subtle space-y-3 p-6",children:[r("h3",{className:"font-semibold text-lg",children:"Example package"}),u("p",{className:"text-muted-foreground text-sm",children:["Use ",r("code",{children:"@contractspec/example.lifecycle-dashboard"})," as a lightweight Next.js snippet reference."]}),r(E,{language:"bash",filename:"nextjs-example",code:`# Inspect the example docs
 contractspec examples show lifecycle-dashboard
 
 # Validate all example manifests in this repo
-contractspec examples validate --repo-root .`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx7(StudioPrompt, {
-            title: "Want real product evidence behind endpoint changes?",
-            body: "Studio correlates meetings, support, analytics, and code signals before compiling endpoint decisions into spec diffs."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs7("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs7(Link7, {
-            href: "/docs/guides/spec-validation-and-typing",
-            className: "btn-primary",
-            children: [
-              "Next: Spec validation + typing ",
-              /* @__PURE__ */ jsx7(ChevronRight6, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx7(Link7, {
-            href: "/docs/guides",
-            className: "btn-ghost",
-            children: "Back to guides"
-          })
-        ]
-      })
-    ]
-  });
-}
-
-// src/components/docs/guides/GuideSpecValidationTypingPage.tsx
-import { CodeBlock as CodeBlock7 } from "@contractspec/lib.design-system";
-import Link8 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight7 } from "lucide-react";
-import { jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
-function GuideSpecValidationTypingPage() {
-  return /* @__PURE__ */ jsxs8("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs8("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx8("h1", {
-            className: "font-bold text-4xl",
-            children: "Spec-driven validation + typing"
-          }),
-          /* @__PURE__ */ jsx8("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Define a single operation with SchemaModel, generate validation, and keep your existing handler logic."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs8("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx8("h2", {
-            className: "font-bold text-2xl",
-            children: "What you'll build"
-          }),
-          /* @__PURE__ */ jsxs8("ul", {
-            className: "space-y-2 text-muted-foreground text-sm",
-            children: [
-              /* @__PURE__ */ jsx8("li", {
-                children: "One command spec with explicit input/output models."
-              }),
-              /* @__PURE__ */ jsx8("li", {
-                children: "Validation + typing without rewriting your service layer."
-              }),
-              /* @__PURE__ */ jsx8("li", {
-                children: "Clear acceptance scenarios for regression safety."
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs8("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs8("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx8("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Define the spec"
-              }),
-              /* @__PURE__ */ jsxs8("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Create ",
-                  /* @__PURE__ */ jsx8("code", {
-                    children: "src/contracts/contact-create.operation.ts"
-                  }),
-                  ":"
-                ]
-              }),
-              /* @__PURE__ */ jsx8(CodeBlock7, {
-                language: "typescript",
-                filename: "src/contracts/contact-create.operation.ts",
-                code: `import { defineCommand } from "@contractspec/lib.contracts-spec/operations";
+contractspec examples validate --repo-root .`})]}),r(g,{title:"Want real product evidence behind endpoint changes?",body:"Studio correlates meetings, support, analytics, and code signals before compiling endpoint decisions into spec diffs."})]}),u("div",{className:"flex items-center gap-4 pt-4",children:[u(F,{href:"/docs/guides/spec-validation-and-typing",className:"btn-primary",children:["Next: Spec validation + typing ",r(Se,{size:16})]}),r(F,{href:"/docs/guides",className:"btn-ghost",children:"Back to guides"})]})]})}import{CodeBlock as A}from"@contractspec/lib.design-system";import K from"@contractspec/lib.ui-link";import{ChevronRight as Ee}from"lucide-react";import{jsx as m,jsxs as N}from"react/jsx-runtime";function Pe(){return N("div",{className:"space-y-8",children:[N("div",{className:"space-y-3",children:[m("h1",{className:"font-bold text-4xl",children:"Spec-driven validation + typing"}),m("p",{className:"text-lg text-muted-foreground",children:"Define a single operation with SchemaModel, generate validation, and keep your existing handler logic."})]}),N("div",{className:"card-subtle space-y-4 p-6",children:[m("h2",{className:"font-bold text-2xl",children:"What you'll build"}),N("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[m("li",{children:"One command spec with explicit input/output models."}),m("li",{children:"Validation + typing without rewriting your service layer."}),m("li",{children:"Clear acceptance scenarios for regression safety."})]})]}),N("div",{className:"space-y-6",children:[N("div",{className:"space-y-3",children:[m("h2",{className:"font-bold text-2xl",children:"1) Define the spec"}),N("p",{className:"text-muted-foreground text-sm",children:["Create ",m("code",{children:"src/contracts/contact-create.operation.ts"}),":"]}),m(A,{language:"typescript",filename:"src/contracts/contact-create.operation.ts",code:`import { defineCommand } from "@contractspec/lib.contracts-spec/operations";
 import { SchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 
 const ContactInput = new SchemaModel({
@@ -2523,25 +642,7 @@ export const ContactCreateCommand = defineCommand({
       },
     ],
   },
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs8("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx8("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Wire the handler"
-              }),
-              /* @__PURE__ */ jsx8("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Keep your existing code. Just ensure the handler returns the output shape defined above."
-              }),
-              /* @__PURE__ */ jsx8(CodeBlock7, {
-                language: "typescript",
-                filename: "src/handlers/contact-create.ts",
-                code: `import { ContactCreateCommand } from "@/contracts/contact-create.operation";
+});`})]}),N("div",{className:"space-y-3",children:[m("h2",{className:"font-bold text-2xl",children:"2) Wire the handler"}),m("p",{className:"text-muted-foreground text-sm",children:"Keep your existing code. Just ensure the handler returns the output shape defined above."}),m(A,{language:"typescript",filename:"src/handlers/contact-create.ts",code:`import { ContactCreateCommand } from "@/contracts/contact-create.operation";
  
  export async function handleContactCreate(
    input: (typeof ContactCreateCommand)["io"]["input"],
@@ -2553,304 +654,21 @@ export const ContactCreateCommand = defineCommand({
      email: input.email,
      createdAt: new Date().toISOString(),
    };
- }`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs8("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx8("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Validate"
-              }),
-              /* @__PURE__ */ jsx8(CodeBlock7, {
-                language: "bash",
-                filename: "spec-validation",
-                code: `contractspec validate src/contracts/contact-create.operation.ts`
-              }),
-              /* @__PURE__ */ jsxs8("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Expected output: ",
-                  /* @__PURE__ */ jsx8("code", {
-                    children: "Validation passed"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs8("div", {
-            className: "card-subtle space-y-3 p-6",
-            children: [
-              /* @__PURE__ */ jsx8("h3", {
-                className: "font-semibold text-lg",
-                children: "Example package"
-              }),
-              /* @__PURE__ */ jsx8("p", {
-                className: "text-muted-foreground text-sm",
-                children: "The CRM Pipeline example includes real specs, handlers, and presentations for contact + deal flows."
-              }),
-              /* @__PURE__ */ jsx8(CodeBlock7, {
-                language: "bash",
-                filename: "crm-example",
-                code: `# Build + validate the CRM pipeline example
+ }`})]}),N("div",{className:"space-y-3",children:[m("h2",{className:"font-bold text-2xl",children:"3) Validate"}),m(A,{language:"bash",filename:"spec-validation",code:"contractspec validate src/contracts/contact-create.operation.ts"}),N("p",{className:"text-muted-foreground text-sm",children:["Expected output: ",m("code",{children:"Validation passed"}),"."]})]}),N("div",{className:"card-subtle space-y-3 p-6",children:[m("h3",{className:"font-semibold text-lg",children:"Example package"}),m("p",{className:"text-muted-foreground text-sm",children:"The CRM Pipeline example includes real specs, handlers, and presentations for contact + deal flows."}),m(A,{language:"bash",filename:"crm-example",code:`# Build + validate the CRM pipeline example
 cd packages/examples/crm-pipeline
 bun install
 bun run build
-bun run validate`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx8(StudioPrompt, {
-            title: "Need validation tied to real outcomes?",
-            body: "Studio links checks to evidence, focus decisions, and post-release verification so specs evolve with product truth."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs8("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs8(Link8, {
-            href: "/docs/guides/generate-docs-clients-schemas",
-            className: "btn-primary",
-            children: [
-              "Next: Generate docs + clients ",
-              /* @__PURE__ */ jsx8(ChevronRight7, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx8(Link8, {
-            href: "/docs/guides",
-            className: "btn-ghost",
-            children: "Back to guides"
-          })
-        ]
-      })
-    ]
-  });
-}
-
-// src/components/docs/guides/GuidesIndexPage.tsx
-import { CodeBlock as CodeBlock8 } from "@contractspec/lib.design-system";
-import Link9 from "@contractspec/lib.ui-link";
-import { ArrowRight, CheckCircle2, GitBranch } from "lucide-react";
-import { jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
-var guides = [
-  {
-    title: "Adopt one endpoint in Next.js",
-    description: "Start inside a live app with one operation, one generated surface, and one clearly bounded change.",
-    href: "/docs/guides/nextjs-one-endpoint",
-    time: "25 min"
-  },
-  {
-    title: "Import an existing codebase",
-    description: "Stabilize what already exists instead of treating adoption as a rewrite project.",
-    href: "/docs/guides/import-existing-codebases",
-    time: "20 min"
-  },
-  {
-    title: "Validation and typing",
-    description: "Keep runtime validation and TypeScript behavior aligned from the same source definitions.",
-    href: "/docs/guides/spec-validation-and-typing",
-    time: "20 min"
-  },
-  {
-    title: "Generate docs and clients",
-    description: "Publish stable docs, schemas, and client-facing artifacts from the contract layer.",
-    href: "/docs/guides/generate-docs-clients-schemas",
-    time: "20 min"
-  },
-  {
-    title: "Docs pipeline",
-    description: "Feed generated reference material into the docs site without confusing ownership.",
-    href: "/docs/guides/docs-generation-pipeline",
-    time: "20 min"
-  },
-  {
-    title: "CI diff gating",
-    description: "Use deterministic checks to catch drift and risky changes before they ship.",
-    href: "/docs/guides/ci-contract-diff-gating",
-    time: "15 min"
-  }
-];
-function GuidesIndexPage() {
-  return /* @__PURE__ */ jsxs9("div", {
-    className: "space-y-10",
-    children: [
-      /* @__PURE__ */ jsxs9("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx9("p", {
-            className: "editorial-kicker",
-            children: "Build"
-          }),
-          /* @__PURE__ */ jsx9("h1", {
-            className: "font-serif text-4xl tracking-[-0.04em] md:text-5xl",
-            children: "Adoption guides for teams that want to keep their code."
-          }),
-          /* @__PURE__ */ jsx9("p", {
-            className: "max-w-3xl text-lg text-muted-foreground leading-8",
-            children: "These guides assume you are introducing ContractSpec into a real code base. Start with a narrow surface, verify the generated outputs, and expand only after the contract loop feels trustworthy."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsx9("div", {
-        className: "grid gap-4 md:grid-cols-2",
-        children: guides.map((guide) => /* @__PURE__ */ jsxs9(Link9, {
-          href: guide.href,
-          className: "editorial-panel",
-          children: [
-            /* @__PURE__ */ jsxs9("div", {
-              className: "flex items-start justify-between gap-4",
-              children: [
-                /* @__PURE__ */ jsxs9("div", {
-                  children: [
-                    /* @__PURE__ */ jsx9("h2", {
-                      className: "font-semibold text-xl",
-                      children: guide.title
-                    }),
-                    /* @__PURE__ */ jsx9("p", {
-                      className: "mt-2 text-muted-foreground text-sm leading-7",
-                      children: guide.description
-                    })
-                  ]
-                }),
-                /* @__PURE__ */ jsx9(ArrowRight, {
-                  className: "mt-1 shrink-0",
-                  size: 18
-                })
-              ]
-            }),
-            /* @__PURE__ */ jsxs9("div", {
-              className: "mt-4 flex items-center gap-2 text-muted-foreground text-xs",
-              children: [
-                /* @__PURE__ */ jsx9(CheckCircle2, {
-                  size: 14
-                }),
-                /* @__PURE__ */ jsxs9("span", {
-                  children: [
-                    "Target time: ",
-                    guide.time
-                  ]
-                })
-              ]
-            })
-          ]
-        }, guide.href))
-      }),
-      /* @__PURE__ */ jsxs9("div", {
-        className: "editorial-panel space-y-4",
-        children: [
-          /* @__PURE__ */ jsxs9("div", {
-            className: "flex items-center gap-2 font-semibold text-[color:var(--rust)] text-sm uppercase tracking-[0.2em]",
-            children: [
-              /* @__PURE__ */ jsx9(GitBranch, {
-                size: 16
-              }),
-              "Working style"
-            ]
-          }),
-          /* @__PURE__ */ jsxs9("ul", {
-            className: "editorial-list",
-            children: [
-              /* @__PURE__ */ jsxs9("li", {
-                children: [
-                  /* @__PURE__ */ jsx9("span", {
-                    className: "editorial-list-marker"
-                  }),
-                  /* @__PURE__ */ jsx9("span", {
-                    children: "Run each guide in a branch or sandboxed workspace."
-                  })
-                ]
-              }),
-              /* @__PURE__ */ jsxs9("li", {
-                children: [
-                  /* @__PURE__ */ jsx9("span", {
-                    className: "editorial-list-marker"
-                  }),
-                  /* @__PURE__ */ jsx9("span", {
-                    children: "Prefer one bounded surface at a time: one endpoint, one workflow, one integration, one unsafe module."
-                  })
-                ]
-              }),
-              /* @__PURE__ */ jsxs9("li", {
-                children: [
-                  /* @__PURE__ */ jsx9("span", {
-                    className: "editorial-list-marker"
-                  }),
-                  /* @__PURE__ */ jsx9("span", {
-                    children: "Use the example and reference outputs to verify what changed, not just the narrative page."
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx9(CodeBlock8, {
-            language: "bash",
-            filename: "guides-quickstart",
-            code: `# list example systems
+bun run validate`})]}),m(g,{title:"Need validation tied to real outcomes?",body:"Studio links checks to evidence, focus decisions, and post-release verification so specs evolve with product truth."})]}),N("div",{className:"flex items-center gap-4 pt-4",children:[N(K,{href:"/docs/guides/generate-docs-clients-schemas",className:"btn-primary",children:["Next: Generate docs + clients ",m(Ee,{size:16})]}),m(K,{href:"/docs/guides",className:"btn-ghost",children:"Back to guides"})]})]})}import{CodeBlock as Be}from"@contractspec/lib.design-system";import Re from"@contractspec/lib.ui-link";import{ArrowRight as Te,CheckCircle2 as Ae,GitBranch as Oe}from"lucide-react";import{jsx as h,jsxs as k}from"react/jsx-runtime";var Ue=[{title:"Adopt one endpoint in Next.js",description:"Start inside a live app with one operation, one generated surface, and one clearly bounded change.",href:"/docs/guides/nextjs-one-endpoint",time:"25 min"},{title:"Import an existing codebase",description:"Stabilize what already exists instead of treating adoption as a rewrite project.",href:"/docs/guides/import-existing-codebases",time:"20 min"},{title:"Validation and typing",description:"Keep runtime validation and TypeScript behavior aligned from the same source definitions.",href:"/docs/guides/spec-validation-and-typing",time:"20 min"},{title:"Generate docs and clients",description:"Publish stable docs, schemas, and client-facing artifacts from the contract layer.",href:"/docs/guides/generate-docs-clients-schemas",time:"20 min"},{title:"Docs pipeline",description:"Feed generated reference material into the docs site without confusing ownership.",href:"/docs/guides/docs-generation-pipeline",time:"20 min"},{title:"Build a first module bundle",description:"Define one bundle spec, resolve a surface plan, and render it through the React host layer.",href:"/docs/guides/first-module-bundle",time:"20 min"},{title:"Host the Builder workbench",description:"Wire a Builder workspace snapshot, common commands, runtime modes, and mobile review links into the reusable host.",href:"/docs/guides/host-builder-workbench",time:"20 min"},{title:"Use Connect in a repo",description:"Enable Connect, verify agent actions locally, and inspect the resulting review and replay artifacts.",href:"/docs/guides/connect-in-a-repo",time:"15 min"},{title:"CI diff gating",description:"Use deterministic checks to catch drift and risky changes before they ship.",href:"/docs/guides/ci-contract-diff-gating",time:"15 min"}];function De(){return k("div",{className:"space-y-10",children:[k("div",{className:"space-y-3",children:[h("p",{className:"editorial-kicker",children:"Build"}),h("h1",{className:"font-serif text-4xl tracking-[-0.04em] md:text-5xl",children:"Adoption guides for teams that want to keep their code."}),h("p",{className:"max-w-3xl text-lg text-muted-foreground leading-8",children:"These guides assume you are introducing ContractSpec into a real code base. Start with a narrow surface, verify the generated outputs, and expand only after the contract loop feels trustworthy."})]}),h("div",{className:"grid gap-4 md:grid-cols-2",children:Ue.map((c)=>k(Re,{href:c.href,className:"editorial-panel",children:[k("div",{className:"flex items-start justify-between gap-4",children:[k("div",{children:[h("h2",{className:"font-semibold text-xl",children:c.title}),h("p",{className:"mt-2 text-muted-foreground text-sm leading-7",children:c.description})]}),h(Te,{className:"mt-1 shrink-0",size:18})]}),k("div",{className:"mt-4 flex items-center gap-2 text-muted-foreground text-xs",children:[h(Ae,{size:14}),k("span",{children:["Target time: ",c.time]})]})]},c.href))}),k("div",{className:"editorial-panel space-y-4",children:[k("div",{className:"flex items-center gap-2 font-semibold text-[color:var(--rust)] text-sm uppercase tracking-[0.2em]",children:[h(Oe,{size:16}),"Working style"]}),k("ul",{className:"editorial-list",children:[k("li",{children:[h("span",{className:"editorial-list-marker"}),h("span",{children:"Run each guide in a branch or sandboxed workspace."})]}),k("li",{children:[h("span",{className:"editorial-list-marker"}),h("span",{children:"Prefer one bounded surface at a time: one endpoint, one workflow, one integration, one unsafe module."})]}),k("li",{children:[h("span",{className:"editorial-list-marker"}),h("span",{children:"Use the example and reference outputs to verify what changed, not just the narrative page."})]})]}),h(Be,{language:"bash",filename:"guides-quickstart",code:`# list example systems
 contractspec examples list
 
 # validate the examples in this workspace
-contractspec examples validate --repo-root .`
-          })
-        ]
-      })
-    ]
-  });
-}
+contractspec examples validate --repo-root .`})]})]})}import{registerDocBlocks as Me}from"@contractspec/lib.contracts-spec/docs";var Le=[{id:"docs.guides.index",title:"Guides",summary:"Hands-on guides for adopting ContractSpec in real workflows.",kind:"goal",visibility:"public",route:"/docs/guides",tags:["guides","adoption"],body:`# Guides
 
-// src/components/docs/guides/guides.docblocks.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var guideDocBlocks = [
-  {
-    id: "docs.guides.index",
-    title: "Guides",
-    summary: "Hands-on guides for adopting ContractSpec in real workflows.",
-    kind: "goal",
-    visibility: "public",
-    route: "/docs/guides",
-    tags: ["guides", "adoption"],
-    body: `# Guides
-
-Hands-on, runnable guides that map to real adoption scenarios. Each guide includes commands, expected output, and a CI-verified example package.`
-  },
-  {
-    id: "docs.guides.nextjs-one-endpoint",
-    title: "Next.js one endpoint",
-    summary: "Add ContractSpec to an existing Next.js app with one endpoint.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/nextjs-one-endpoint",
-    tags: ["guides", "nextjs", "operations"],
-    body: `# Add ContractSpec to a Next.js app (one endpoint)
-
-Create a single OperationSpec, register it, and expose it through a Next.js App Router handler.`
-  },
-  {
-    id: "docs.guides.spec-validation-typing",
-    title: "Spec validation and typing",
-    summary: "Define an operation spec with validation and types, no rewrites.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/spec-validation-and-typing",
-    tags: ["guides", "validation", "typing"],
-    body: `# Spec-driven validation and typing
-
-Define command/query specs that enforce validation and generate types without rewriting your app.`
-  },
-  {
-    id: "docs.guides.docs-clients-schemas",
-    title: "Generate docs, clients, schemas",
-    summary: "Generate docs and OpenAPI for client SDKs from specs.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/generate-docs-clients-schemas",
-    tags: ["guides", "docs", "openapi"],
-    body: `# Generate docs and client schemas
+Hands-on, runnable guides that map to real adoption scenarios. Each guide includes commands, expected output, and a CI-verified example package.`},{id:"docs.guides.nextjs-one-endpoint",title:"Next.js one endpoint",summary:"Add ContractSpec to an existing Next.js app with one endpoint.",kind:"usage",visibility:"public",route:"/docs/guides/nextjs-one-endpoint",tags:["guides","nextjs","operations"],body:`# Add ContractSpec to a Next.js app (one endpoint)
+
+Create a single OperationSpec, register it, and expose it through a Next.js App Router handler.`},{id:"docs.guides.spec-validation-typing",title:"Spec validation and typing",summary:"Define an operation spec with validation and types, no rewrites.",kind:"usage",visibility:"public",route:"/docs/guides/spec-validation-and-typing",tags:["guides","validation","typing"],body:`# Spec-driven validation and typing
+
+Define command/query specs that enforce validation and generate types without rewriting your app.`},{id:"docs.guides.docs-clients-schemas",title:"Generate docs, clients, schemas",summary:"Generate docs and OpenAPI for client SDKs from specs.",kind:"usage",visibility:"public",route:"/docs/guides/generate-docs-clients-schemas",tags:["guides","docs","openapi"],body:`# Generate docs and client schemas
 
 Use ContractSpec to generate documentation and OpenAPI exports for client SDKs.
 
@@ -2868,17 +686,7 @@ bun contractspec generate
 bun docs:generate
 # or versioned output
 bun docs:generate -- --version v1.0.0
-\`\`\``
-  },
-  {
-    id: "docs.guides.docs-generation-pipeline",
-    title: "Docs generation pipeline",
-    summary: "Wire generated docs into a reference site with chunked indexes.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/docs-generation-pipeline",
-    tags: ["guides", "docs", "pipeline"],
-    body: `# Build the docs pipeline
+\`\`\``},{id:"docs.guides.docs-generation-pipeline",title:"Docs generation pipeline",summary:"Wire generated docs into a reference site with chunked indexes.",kind:"usage",visibility:"public",route:"/docs/guides/docs-generation-pipeline",tags:["guides","docs","pipeline"],body:`# Build the docs pipeline
 
 Use ContractSpec to generate reference markdown, build a chunked index, and wire it into your docs routes.
 
@@ -2898,29 +706,6 @@ bun docs:generate -- --version v1.0.0
 
 ## Reference wiring
 
-Use the generated manifest and chunks under \`docs-index.manifest.json\` and \`docs-index.*.json\` to load the index at runtime.`
-  },
-  {
-    id: "docs.guides.ci-contract-diff-gating",
-    title: "CI gating for contract diffs",
-    summary: "Gate changes with deterministic diffs and CI checks.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/ci-contract-diff-gating",
-    tags: ["guides", "ci", "diff"],
-    body: `# CI gating with deterministic diffs
-
-Run ContractSpec CI checks to detect drift and breaking changes before merge.`
-  }
-];
-registerDocBlocks(guideDocBlocks);
-export {
-  GuidesIndexPage,
-  GuideSpecValidationTypingPage,
-  GuideNextjsOneEndpointPage,
-  GuideImportExistingCodebasesPage,
-  GuideGenerateDocsClientsSchemasPage,
-  GuideDocsPipelinePage,
-  GuideContractTypesPage,
-  GuideCIDiffGatingPage
-};
+Use the generated manifest and chunks under \`docs-index.manifest.json\` and \`docs-index.*.json\` to load the index at runtime.`},{id:"docs.guides.ci-contract-diff-gating",title:"CI gating for contract diffs",summary:"Gate changes with deterministic diffs and CI checks.",kind:"usage",visibility:"public",route:"/docs/guides/ci-contract-diff-gating",tags:["guides","ci","diff"],body:`# CI gating with deterministic diffs
+
+Run ContractSpec CI checks to detect drift and breaking changes before merge.`}];Me(Le);export{De as GuidesIndexPage,Pe as GuideSpecValidationTypingPage,Ie as GuideNextjsOneEndpointPage,Ce as GuideImportExistingCodebasesPage,ye as GuideHostBuilderWorkbenchPage,he as GuideGenerateDocsClientsSchemasPage,me as GuideFirstModuleBundlePage,le as GuideDocsPipelinePage,se as GuideContractTypesPage,te as GuideConnectInRepoPage,x as GuideCIDiffGatingPage};