@lssm/example.saas-boilerplate 0.0.0-canary-20251217062139 → 0.0.0-canary-20251217072406

package/dist/libs/contracts/dist/docs/presentations.js

@@ -1 +1,71 @@
-const e=[`markdown`,`application/json`,`application/xml`,`react`];function t(e){if(!e.length)return`/`;let t=e.startsWith(`/`)?e:`/${e}`;return t===`/`?`/`:t.replace(/\/+$/,``)}function n(e,n){if(e.route)return t(e.route);let r=n??`/docs`,i=e.id.replace(/^docs\.?/,``).replace(/\./g,`/`).replace(/\/+/g,`/`);return t(i.startsWith(`/`)?i:`${r}/${i}`)}function r(e,t){return t?`${t}.${e.id}`:e.id}function i(t,n){let i=n?.defaultTargets??e,a=t.version??n?.defaultVersion??1,o=t.stability??n?.defaultStability??`stable`;return{meta:{name:r(t,n?.namespace),version:a,description:t.summary??t.title,tags:t.tags,owners:t.owners,domain:t.domain,stability:o},policy:t.visibility&&t.visibility!==`public`?{flags:[t.visibility]}:void 0,source:{type:`blocknotejs`,docJson:t.body},targets:i}}function a(e,t){let n=e.version??t?.defaultVersion??1,i=e.stability??t?.defaultStability??`stable`;return{meta:{name:r(e,t?.namespace),version:n,stability:i,tags:e.tags,owners:e.owners,description:e.summary??e.title},content:{kind:`markdown`,content:e.body}}}function o(e,t){return e.map(e=>({block:e,route:n(e,t?.routePrefix),descriptor:i(e,t)}))}export{a,i,o};
+//#region ../../libs/contracts/dist/docs/presentations.js
+const DEFAULT_TARGETS = [
+	"markdown",
+	"application/json",
+	"application/xml",
+	"react"
+];
+function normalizeRoute(route) {
+	if (!route.length) return "/";
+	const withLeading = route.startsWith("/") ? route : `/${route}`;
+	return withLeading === "/" ? "/" : withLeading.replace(/\/+$/, "");
+}
+function deriveRoute(block, routePrefix) {
+	if (block.route) return normalizeRoute(block.route);
+	const prefix = routePrefix ?? "/docs";
+	const slug = block.id.replace(/^docs\.?/, "").replace(/\./g, "/").replace(/\/+/g, "/");
+	return normalizeRoute(slug.startsWith("/") ? slug : `${prefix}/${slug}`);
+}
+function buildName(block, namespace) {
+	return namespace ? `${namespace}.${block.id}` : block.id;
+}
+function docBlockToPresentationV2(block, options) {
+	const targets = options?.defaultTargets ?? DEFAULT_TARGETS;
+	const version = block.version ?? options?.defaultVersion ?? 1;
+	const stability = block.stability ?? options?.defaultStability ?? "stable";
+	return {
+		meta: {
+			name: buildName(block, options?.namespace),
+			version,
+			description: block.summary ?? block.title,
+			tags: block.tags,
+			owners: block.owners,
+			domain: block.domain,
+			stability
+		},
+		policy: block.visibility && block.visibility !== "public" ? { flags: [block.visibility] } : void 0,
+		source: {
+			type: "blocknotejs",
+			docJson: block.body
+		},
+		targets
+	};
+}
+function docBlockToPresentationSpec(block, options) {
+	const version = block.version ?? options?.defaultVersion ?? 1;
+	const stability = block.stability ?? options?.defaultStability ?? "stable";
+	return {
+		meta: {
+			name: buildName(block, options?.namespace),
+			version,
+			stability,
+			tags: block.tags,
+			owners: block.owners,
+			description: block.summary ?? block.title
+		},
+		content: {
+			kind: "markdown",
+			content: block.body
+		}
+	};
+}
+function docBlocksToPresentationRoutes(blocks, options) {
+	return blocks.map((block) => ({
+		block,
+		route: deriveRoute(block, options?.routePrefix),
+		descriptor: docBlockToPresentationV2(block, options)
+	}));
+}
+
+//#endregion
+export { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes };

package/dist/libs/contracts/dist/docs/registry.js

@@ -1 +1,44 @@
-import{a as e,o as t}from"./presentations.js";var n=class{routes=new Map;constructor(e=[],t){e.forEach(e=>this.register(e,t))}register(e,n){let[r]=t([e],n);return r&&this.routes.set(e.id,r),this}list(){return[...this.routes.values()]}get(e){return this.routes.get(e)}toRouteTuples(){return this.list().map(({route:e,descriptor:t})=>[e,t])}toPresentationSpecs(t){return this.list().map(({block:n})=>e(n,t))}};const r=[`id`,`title`,`body`,`kind`,`visibility`,`route`],i=new n;function a(e){for(let t of e){for(let e of r)if(!t[e])throw Error(`DocBlock ${t.id??`<missing id>`} missing field ${String(e)}`);i.register(t)}}export{a,i,n};
+import { docBlockToPresentationSpec, docBlocksToPresentationRoutes } from "./presentations.js";
+
+//#region ../../libs/contracts/dist/docs/registry.js
+var DocRegistry = class {
+	routes = /* @__PURE__ */ new Map();
+	constructor(blocks = [], options) {
+		blocks.forEach((block) => this.register(block, options));
+	}
+	register(block, options) {
+		const [route] = docBlocksToPresentationRoutes([block], options);
+		if (route) this.routes.set(block.id, route);
+		return this;
+	}
+	list() {
+		return [...this.routes.values()];
+	}
+	get(id) {
+		return this.routes.get(id);
+	}
+	toRouteTuples() {
+		return this.list().map(({ route, descriptor }) => [route, descriptor]);
+	}
+	toPresentationSpecs(options) {
+		return this.list().map(({ block }) => docBlockToPresentationSpec(block, options));
+	}
+};
+const requiredFields = [
+	"id",
+	"title",
+	"body",
+	"kind",
+	"visibility",
+	"route"
+];
+const defaultDocRegistry = new DocRegistry();
+function registerDocBlocks(blocks) {
+	for (const block of blocks) {
+		for (const field of requiredFields) if (!block[field]) throw new Error(`DocBlock ${block.id ?? "<missing id>"} missing field ${String(field)}`);
+		defaultDocRegistry.register(block);
+	}
+}
+
+//#endregion
+export { DocRegistry, defaultDocRegistry, registerDocBlocks };

package/dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js

@@ -1,383 +1,16 @@
-import{a as e}from"../registry.js";e([{id:`docs.tech.PHASE_1_QUICKSTART`,title:`Phase 1: API Reference Index`,summary:`Quick reference for all new Phase 1 APIs.`,kind:`reference`,visibility:`public`,route:`/docs/tech/PHASE_1_QUICKSTART`,tags:[`tech`,`PHASE_1_QUICKSTART`],body:`# Phase 1: API Reference Index
-
-Quick reference for all new Phase 1 APIs.
-
----
-
-## @lssm/lib.multi-tenancy
-
-### RLS
-\`\`\`typescript
-import { createRlsMiddleware, type TenantIdProvider } from '@lssm/lib.multi-tenancy/rls';
-\`\`\`
-
-### Provisioning
-\`\`\`typescript
-import { 
-  TenantProvisioningService,
-  type CreateTenantInput,
-  type TenantProvisioningConfig 
-} from '@lssm/lib.multi-tenancy/provisioning';
-\`\`\`
-
-### Isolation
-\`\`\`typescript
-import { IsolationValidator } from '@lssm/lib.multi-tenancy/isolation';
-\`\`\`
-
----
-
-## @lssm/lib.observability
-
-### Tracing
-\`\`\`typescript
-import { 
-  getTracer,
-  traceAsync,
-  traceSync,
-  createTracingMiddleware 
-} from '@lssm/lib.observability/tracing';
-\`\`\`
-
-### Metrics
-\`\`\`typescript
-import {
-  getMeter,
-  createCounter,
-  createUpDownCounter,
-  createHistogram,
-  standardMetrics
-} from '@lssm/lib.observability/metrics';
-\`\`\`
-
-### Logging
-\`\`\`typescript
-import {
-  Logger,
-  logger,
-  type LogLevel,
-  type LogEntry
-} from '@lssm/lib.observability/logging';
-\`\`\`
-
----
-
-## @lssm/lib.resilience
-
-### Circuit Breaker
-\`\`\`typescript
-import {
-  CircuitBreaker,
-  type CircuitState,
-  type CircuitBreakerConfig
-} from '@lssm/lib.resilience/circuit-breaker';
-\`\`\`
-
-### Retry
-\`\`\`typescript
-import { retry } from '@lssm/lib.resilience/retry';
-\`\`\`
-
-### Timeout
-\`\`\`typescript
-import { timeout } from '@lssm/lib.resilience/timeout';
-\`\`\`
-
-### Fallback
-\`\`\`typescript
-import { fallback } from '@lssm/lib.resilience/fallback';
-\`\`\`
-
----
-
-## Enhanced: @lssm/lib.contracts
-
-### DataViews
-\`\`\`typescript
-import { DataViewQueryGenerator } from '@lssm/lib.contracts/data-views/query-generator';
-import { DataViewRuntime } from '@lssm/lib.contracts/data-views/runtime';
-\`\`\`
-
-### Workflows
-\`\`\`typescript
-import { SLAMonitor, type SLABreachEvent } from '@lssm/lib.contracts/workflow/sla-monitor';
-import { PrismaStateStore } from '@lssm/lib.contracts/workflow/adapters/db-adapter';
-\`\`\`
-
----
-
-## Enhanced: @lssm/lib.design-system
-
-### DataView Components
-\`\`\`typescript
-import { DataViewRenderer } from '@lssm/lib.design-system/components/data-view/DataViewRenderer';
-// Also available: DataViewList, DataViewTable, DataViewDetail
-\`\`\`
-
----
-
-## Usage Examples
-
-### Complete Workflow with All Features
-
-\`\`\`typescript
-import { WorkflowRunner } from '@lssm/lib.contracts/workflow/runner';
-import { PrismaStateStore } from '@lssm/lib.contracts/workflow/adapters/db-adapter';
-import { SLAMonitor } from '@lssm/lib.contracts/workflow/sla-monitor';
-import { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';
-import { traceAsync } from '@lssm/lib.observability/tracing';
-
-const runner = new WorkflowRunner({
-  registry,
-  stateStore: new PrismaStateStore(db),
-  opExecutor: async (op, input, ctx) => {
-    return traceAsync(\`op.\${op.name}\`, async (span) => {
-      span.setAttribute('operation', op.name);
-      const breaker = getCircuitBreaker(op.name);
-      return breaker.execute(() => executeOperation(op, input, ctx));
-    });
-  },
-  eventEmitter: (event, payload) => {
-    if (event.startsWith('workflow.')) {
-      logger.info(event, payload);
-    }
-  },
-});
-
-const monitor = new SLAMonitor((event, payload) => {
-  logger.warn('SLA_BREACH', payload);
-  alertOps(payload);
-});
-
-// Start workflow
-const workflowId = await runner.start('payment.flow', 1);
-
-// Monitor SLA
-const state = await runner.getState(workflowId);
-const spec = registry.get('payment.flow', 1);
-monitor.check(state, spec!);
-\`\`\`
-
-### Complete DataView with Observability
-
-\`\`\`typescript
-import { DataViewRenderer } from '@lssm/lib.design-system';
-import { DataViewQueryGenerator } from '@lssm/lib.contracts/data-views/query-generator';
-import { traceAsync } from '@lssm/lib.observability/tracing';
-import { MyDataView } from './specs/users.data-view';
-
-export function UserListPage() {
-  const [page, setPage] = useState(1);
-  const [users, setUsers] = useState([]);
-
-  const loadUsers = async () => {
-    return traceAsync('load_users', async (span) => {
-      const generator = new DataViewQueryGenerator(MyDataView);
-      const query = generator.generate({ pagination: { page, pageSize: 20 } });
-      
-      span.setAttribute('page', page);
-      const result = await api.execute(query);
-      setUsers(result.data);
-    });
-  };
-
-  return (
-    <DataViewRenderer
-      spec={MyDataView}
-      items={users}
-      pagination={{ page, pageSize: 20, total: users.length }}
-      onPageChange={setPage}
-    />
-  );
-}
-\`\`\`
-
-### Complete Multi-Tenant Setup
-
-\`\`\`typescript
-// 1. RLS Middleware
-import { createRlsMiddleware } from '@lssm/lib.multi-tenancy/rls';
-db.$use(createRlsMiddleware(() => req.tenantId));
-
-// 2. Tenant Provisioning
-import { TenantProvisioningService } from '@lssm/lib.multi-tenancy/provisioning';
-const service = new TenantProvisioningService({ db });
-
-// 3. Create new tenant
-await service.provision({
-  id: 'acme',
-  name: 'Acme Corp',
-  slug: 'acme',
-  ownerEmail: 'admin@acme.com',
-});
-
-// 4. Validate isolation in tests
-import { IsolationValidator } from '@lssm/lib.multi-tenancy/isolation';
-
-test('queries are isolated', () => {
-  const isValid = IsolationValidator.validateQuery(
-    'User',
-    'findMany',
-    { where: { tenantId: 'acme' } },
-    'acme'
-  );
-  expect(isValid).toBe(true);
-});
-\`\`\`
-
----
-
-## Testing
-
-### Test Circuit Breakers
-
-\`\`\`typescript
-import { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';
-
-test('circuit opens after threshold', async () => {
-  const breaker = new CircuitBreaker({
-    failureThreshold: 3,
-    resetTimeoutMs: 5000,
-  });
-
-  // Trigger failures
-  for (let i = 0; i < 3; i++) {
-    await expect(
-      breaker.execute(() => Promise.reject('error'))
-    ).rejects.toThrow();
-  }
-
-  // Circuit should be open
-  await expect(
-    breaker.execute(() => Promise.resolve('ok'))
-  ).rejects.toThrow('CircuitBreaker is OPEN');
-});
-\`\`\`
-
-### Test Workflow Retry
-
-\`\`\`typescript
-test('workflow retries on failure', async () => {
-  let attempts = 0;
-  const opExecutor = async () => {
-    attempts++;
-    if (attempts < 3) throw new Error('fail');
-    return 'success';
-  };
-
-  const runner = new WorkflowRunner({ /* ... */ opExecutor });
-  await runner.executeStep(workflowId);
-  
-  expect(attempts).toBe(3);
-});
-\`\`\`
-
----
-
-## Common Patterns
-
-### Pattern: Resilient External Call
-
-\`\`\`typescript
-import { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';
-import { retry } from '@lssm/lib.resilience/retry';
-import { timeout } from '@lssm/lib.resilience/timeout';
-import { traceAsync } from '@lssm/lib.observability/tracing';
-
-const breaker = new CircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 30000 });
-
-export async function callExternalAPI(input: any) {
-  return traceAsync('external_api_call', async (span) => {
-    span.setAttribute('service', 'stripe');
-    
-    return breaker.execute(() =>
-      retry(
-        () => timeout(() => stripe.api.call(input), 5000),
-        3,
-        1000,
-        true
-      )
-    );
-  });
-}
-\`\`\`
-
-**Benefits**: Circuit breaker + retry + timeout + tracing in one place.
-
----
-
-### Pattern: Tenant-Aware Operation
-
-\`\`\`typescript
-import { traceAsync } from '@lssm/lib.observability/tracing';
-
-export async function listUsers(tenantId: string) {
-  return traceAsync('list_users', async (span) => {
-    span.setAttribute('tenant_id', tenantId);
-    
-    // RLS middleware will inject WHERE tenantId = ?
-    return db.user.findMany();
-  });
-}
-\`\`\`
-
----
-
-### Pattern: Monitored Workflow
-
-\`\`\`typescript
-import { WorkflowRunner } from '@lssm/lib.contracts/workflow/runner';
-import { SLAMonitor } from '@lssm/lib.contracts/workflow/sla-monitor';
-import { logger } from '@lssm/lib.observability/logging';
-
-const monitor = new SLAMonitor((event, payload) => {
-  logger.warn('workflow.sla_breach', payload);
-});
-
-// In workflow poller
-const state = await runner.getState(workflowId);
-const spec = registry.get(state.workflowName, state.workflowVersion);
-if (spec) {
-  monitor.check(state, spec);
-}
-\`\`\`
-
----
-
-## Next Steps
-
-1. **Implement one quick win** (30 minutes)
-2. **Add tests for new functionality** (1 hour)
-3. **Deploy to staging and verify observability** (1 hour)
-4. **Roll out to production** (monitor closely)
-5. **Read full documentation** at https://contractspec.lssm.tech/docs
-
----
-
-**Questions?** See \`/docs/guides/phase-1-migration\` or reach out via https://contractspec.lssm.tech/contact
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}]);
+import { registerDocBlocks } from "../registry.js";
+
+//#region ../../libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js
+const tech_PHASE_1_QUICKSTART_DocBlocks = [{
+	id: "docs.tech.PHASE_1_QUICKSTART",
+	title: "Phase 1: API Reference Index",
+	summary: "Quick reference for all new Phase 1 APIs.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/PHASE_1_QUICKSTART",
+	tags: ["tech", "PHASE_1_QUICKSTART"],
+	body: "# Phase 1: API Reference Index\n\nQuick reference for all new Phase 1 APIs.\n\n---\n\n## @lssm/lib.multi-tenancy\n\n### RLS\n```typescript\nimport { createRlsMiddleware, type TenantIdProvider } from '@lssm/lib.multi-tenancy/rls';\n```\n\n### Provisioning\n```typescript\nimport { \n  TenantProvisioningService,\n  type CreateTenantInput,\n  type TenantProvisioningConfig \n} from '@lssm/lib.multi-tenancy/provisioning';\n```\n\n### Isolation\n```typescript\nimport { IsolationValidator } from '@lssm/lib.multi-tenancy/isolation';\n```\n\n---\n\n## @lssm/lib.observability\n\n### Tracing\n```typescript\nimport { \n  getTracer,\n  traceAsync,\n  traceSync,\n  createTracingMiddleware \n} from '@lssm/lib.observability/tracing';\n```\n\n### Metrics\n```typescript\nimport {\n  getMeter,\n  createCounter,\n  createUpDownCounter,\n  createHistogram,\n  standardMetrics\n} from '@lssm/lib.observability/metrics';\n```\n\n### Logging\n```typescript\nimport {\n  Logger,\n  logger,\n  type LogLevel,\n  type LogEntry\n} from '@lssm/lib.observability/logging';\n```\n\n---\n\n## @lssm/lib.resilience\n\n### Circuit Breaker\n```typescript\nimport {\n  CircuitBreaker,\n  type CircuitState,\n  type CircuitBreakerConfig\n} from '@lssm/lib.resilience/circuit-breaker';\n```\n\n### Retry\n```typescript\nimport { retry } from '@lssm/lib.resilience/retry';\n```\n\n### Timeout\n```typescript\nimport { timeout } from '@lssm/lib.resilience/timeout';\n```\n\n### Fallback\n```typescript\nimport { fallback } from '@lssm/lib.resilience/fallback';\n```\n\n---\n\n## Enhanced: @lssm/lib.contracts\n\n### DataViews\n```typescript\nimport { DataViewQueryGenerator } from '@lssm/lib.contracts/data-views/query-generator';\nimport { DataViewRuntime } from '@lssm/lib.contracts/data-views/runtime';\n```\n\n### Workflows\n```typescript\nimport { SLAMonitor, type SLABreachEvent } from '@lssm/lib.contracts/workflow/sla-monitor';\nimport { PrismaStateStore } from '@lssm/lib.contracts/workflow/adapters/db-adapter';\n```\n\n---\n\n## Enhanced: @lssm/lib.design-system\n\n### DataView Components\n```typescript\nimport { DataViewRenderer } from '@lssm/lib.design-system/components/data-view/DataViewRenderer';\n// Also available: DataViewList, DataViewTable, DataViewDetail\n```\n\n---\n\n## Usage Examples\n\n### Complete Workflow with All Features\n\n```typescript\nimport { WorkflowRunner } from '@lssm/lib.contracts/workflow/runner';\nimport { PrismaStateStore } from '@lssm/lib.contracts/workflow/adapters/db-adapter';\nimport { SLAMonitor } from '@lssm/lib.contracts/workflow/sla-monitor';\nimport { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';\nimport { traceAsync } from '@lssm/lib.observability/tracing';\n\nconst runner = new WorkflowRunner({\n  registry,\n  stateStore: new PrismaStateStore(db),\n  opExecutor: async (op, input, ctx) => {\n    return traceAsync(`op.${op.name}`, async (span) => {\n      span.setAttribute('operation', op.name);\n      const breaker = getCircuitBreaker(op.name);\n      return breaker.execute(() => executeOperation(op, input, ctx));\n    });\n  },\n  eventEmitter: (event, payload) => {\n    if (event.startsWith('workflow.')) {\n      logger.info(event, payload);\n    }\n  },\n});\n\nconst monitor = new SLAMonitor((event, payload) => {\n  logger.warn('SLA_BREACH', payload);\n  alertOps(payload);\n});\n\n// Start workflow\nconst workflowId = await runner.start('payment.flow', 1);\n\n// Monitor SLA\nconst state = await runner.getState(workflowId);\nconst spec = registry.get('payment.flow', 1);\nmonitor.check(state, spec!);\n```\n\n### Complete DataView with Observability\n\n```typescript\nimport { DataViewRenderer } from '@lssm/lib.design-system';\nimport { DataViewQueryGenerator } from '@lssm/lib.contracts/data-views/query-generator';\nimport { traceAsync } from '@lssm/lib.observability/tracing';\nimport { MyDataView } from './specs/users.data-view';\n\nexport function UserListPage() {\n  const [page, setPage] = useState(1);\n  const [users, setUsers] = useState([]);\n\n  const loadUsers = async () => {\n    return traceAsync('load_users', async (span) => {\n      const generator = new DataViewQueryGenerator(MyDataView);\n      const query = generator.generate({ pagination: { page, pageSize: 20 } });\n      \n      span.setAttribute('page', page);\n      const result = await api.execute(query);\n      setUsers(result.data);\n    });\n  };\n\n  return (\n    <DataViewRenderer\n      spec={MyDataView}\n      items={users}\n      pagination={{ page, pageSize: 20, total: users.length }}\n      onPageChange={setPage}\n    />\n  );\n}\n```\n\n### Complete Multi-Tenant Setup\n\n```typescript\n// 1. RLS Middleware\nimport { createRlsMiddleware } from '@lssm/lib.multi-tenancy/rls';\ndb.$use(createRlsMiddleware(() => req.tenantId));\n\n// 2. Tenant Provisioning\nimport { TenantProvisioningService } from '@lssm/lib.multi-tenancy/provisioning';\nconst service = new TenantProvisioningService({ db });\n\n// 3. Create new tenant\nawait service.provision({\n  id: 'acme',\n  name: 'Acme Corp',\n  slug: 'acme',\n  ownerEmail: 'admin@acme.com',\n});\n\n// 4. Validate isolation in tests\nimport { IsolationValidator } from '@lssm/lib.multi-tenancy/isolation';\n\ntest('queries are isolated', () => {\n  const isValid = IsolationValidator.validateQuery(\n    'User',\n    'findMany',\n    { where: { tenantId: 'acme' } },\n    'acme'\n  );\n  expect(isValid).toBe(true);\n});\n```\n\n---\n\n## Testing\n\n### Test Circuit Breakers\n\n```typescript\nimport { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';\n\ntest('circuit opens after threshold', async () => {\n  const breaker = new CircuitBreaker({\n    failureThreshold: 3,\n    resetTimeoutMs: 5000,\n  });\n\n  // Trigger failures\n  for (let i = 0; i < 3; i++) {\n    await expect(\n      breaker.execute(() => Promise.reject('error'))\n    ).rejects.toThrow();\n  }\n\n  // Circuit should be open\n  await expect(\n    breaker.execute(() => Promise.resolve('ok'))\n  ).rejects.toThrow('CircuitBreaker is OPEN');\n});\n```\n\n### Test Workflow Retry\n\n```typescript\ntest('workflow retries on failure', async () => {\n  let attempts = 0;\n  const opExecutor = async () => {\n    attempts++;\n    if (attempts < 3) throw new Error('fail');\n    return 'success';\n  };\n\n  const runner = new WorkflowRunner({ /* ... */ opExecutor });\n  await runner.executeStep(workflowId);\n  \n  expect(attempts).toBe(3);\n});\n```\n\n---\n\n## Common Patterns\n\n### Pattern: Resilient External Call\n\n```typescript\nimport { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';\nimport { retry } from '@lssm/lib.resilience/retry';\nimport { timeout } from '@lssm/lib.resilience/timeout';\nimport { traceAsync } from '@lssm/lib.observability/tracing';\n\nconst breaker = new CircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 30000 });\n\nexport async function callExternalAPI(input: any) {\n  return traceAsync('external_api_call', async (span) => {\n    span.setAttribute('service', 'stripe');\n    \n    return breaker.execute(() =>\n      retry(\n        () => timeout(() => stripe.api.call(input), 5000),\n        3,\n        1000,\n        true\n      )\n    );\n  });\n}\n```\n\n**Benefits**: Circuit breaker + retry + timeout + tracing in one place.\n\n---\n\n### Pattern: Tenant-Aware Operation\n\n```typescript\nimport { traceAsync } from '@lssm/lib.observability/tracing';\n\nexport async function listUsers(tenantId: string) {\n  return traceAsync('list_users', async (span) => {\n    span.setAttribute('tenant_id', tenantId);\n    \n    // RLS middleware will inject WHERE tenantId = ?\n    return db.user.findMany();\n  });\n}\n```\n\n---\n\n### Pattern: Monitored Workflow\n\n```typescript\nimport { WorkflowRunner } from '@lssm/lib.contracts/workflow/runner';\nimport { SLAMonitor } from '@lssm/lib.contracts/workflow/sla-monitor';\nimport { logger } from '@lssm/lib.observability/logging';\n\nconst monitor = new SLAMonitor((event, payload) => {\n  logger.warn('workflow.sla_breach', payload);\n});\n\n// In workflow poller\nconst state = await runner.getState(workflowId);\nconst spec = registry.get(state.workflowName, state.workflowVersion);\nif (spec) {\n  monitor.check(state, spec);\n}\n```\n\n---\n\n## Next Steps\n\n1. **Implement one quick win** (30 minutes)\n2. **Add tests for new functionality** (1 hour)\n3. **Deploy to staging and verify observability** (1 hour)\n4. **Roll out to production** (monitor closely)\n5. **Read full documentation** at https://contractspec.lssm.tech/docs\n\n---\n\n**Questions?** See `/docs/guides/phase-1-migration` or reach out via https://contractspec.lssm.tech/contact\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+}];
+registerDocBlocks(tech_PHASE_1_QUICKSTART_DocBlocks);
+
+//#endregion

package/dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js

@@ -1,68 +1,16 @@
-import{a as e}from"../registry.js";e([{id:`docs.tech.PHASE_2_AI_NATIVE_OPERATIONS`,title:`Phase 2: AI-Native Operations`,summary:`_Last updated: 2025-11-20_`,kind:`reference`,visibility:`public`,route:`/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS`,tags:[`tech`,`PHASE_2_AI_NATIVE_OPERATIONS`],body:`# Phase 2: AI-Native Operations
-
-_Last updated: 2025-11-20_
-
-Phase 2 turns ContractSpec into an AI-first operations stack. The new libraries below are the building blocks used by support bots, growth agents, and human-in-the-loop flows.
-
-## Libraries
-
-### @lssm/lib.ai-agent
-
-- **Spec + Registry**: \`defineAgent\`, \`AgentRegistry\` keep agent definitions type-safe.
-- **Runner**: \`AgentRunner\` drives LLM conversations, tool calls, retries, escalation, and telemetry hooks.
-- **Tools**: \`ToolExecutor\` standardizes schema validation + timeouts.
-- **Memory**: \`InMemoryAgentMemory\` + interfaces for plugging persistent stores.
-- **Approvals**: new \`ApprovalWorkflow\` + \`InMemoryApprovalStore\` capture low-confidence decisions and surface them to reviewers.
-
-### @lssm/lib.support-bot
-
-Composable support automation primitives:
-
-- \`TicketClassifier\` → heuristics + optional LLM validation for category, priority, sentiment.
-- \`TicketResolver\` → RAG pipeline backed by knowledge spaces.
-- \`AutoResponder\` → tone-aware drafts with citations.
-- \`SupportFeedbackLoop\` → tracks resolution rates.
-- \`createSupportTools\` → ready-made tool definitions for AgentRunner.
-
-### @lssm/lib.content-gen
-
-Content generators that consume a \`ContentBrief\` and output production-ready assets:
-
-- \`BlogGenerator\`, \`LandingPageGenerator\`, \`EmailCampaignGenerator\`, \`SocialPostGenerator\`.
-- \`SeoOptimizer\` builds metadata + schema markup.
-
-### @lssm/lib.analytics
-
-Queryless analytics helpers:
-
-- \`FunnelAnalyzer\` – conversion/drop-off per step.
-- \`CohortTracker\` – retention + LTV per cohort.
-- \`ChurnPredictor\` – recency/frequency/error scoring.
-- \`GrowthHypothesisGenerator\` – surfaces experiment ideas from metric trends.
-
-### @lssm/lib.growth
-
-A/B testing toolkit:
-
-- \`ExperimentRegistry\` + \`ExperimentRunner\` – deterministic bucketing.
-- \`ExperimentTracker\` – persist exposures + metrics.
-- \`StatsEngine\` – Welch’s t-test + improvement calculations.
-
-### Human-in-the-loop UI
-
-\`@lssm/lib.design-system\` now exposes:
-
-- \`ApprovalQueue\` – list + act on pending approvals.
-- \`AgentMonitor\` – live view of agent sessions with confidence + status.
-
-## Examples
-
-- \`examples/ai-support-bot/setup.ts\` shows ticket classification → resolution → response draft.
-- \`examples/content-generation/generate.ts\` produces blog, landing, email, social, SEO output from one brief.
-
-## Next Steps
-
-1. Wire these libraries into vertical apps (H-Circle, ArtisanOS, etc.).
-2. Add background workers that consume the new analytics/growth trackers.
-3. Expand web-landing to highlight these Phase 2 capabilities (see separate TODO).
-`}]);
+import { registerDocBlocks } from "../registry.js";
+
+//#region ../../libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js
+const tech_PHASE_2_AI_NATIVE_OPERATIONS_DocBlocks = [{
+	id: "docs.tech.PHASE_2_AI_NATIVE_OPERATIONS",
+	title: "Phase 2: AI-Native Operations",
+	summary: "_Last updated: 2025-11-20_",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS",
+	tags: ["tech", "PHASE_2_AI_NATIVE_OPERATIONS"],
+	body: "# Phase 2: AI-Native Operations\n\n_Last updated: 2025-11-20_\n\nPhase 2 turns ContractSpec into an AI-first operations stack. The new libraries below are the building blocks used by support bots, growth agents, and human-in-the-loop flows.\n\n## Libraries\n\n### @lssm/lib.ai-agent\n\n- **Spec + Registry**: `defineAgent`, `AgentRegistry` keep agent definitions type-safe.\n- **Runner**: `AgentRunner` drives LLM conversations, tool calls, retries, escalation, and telemetry hooks.\n- **Tools**: `ToolExecutor` standardizes schema validation + timeouts.\n- **Memory**: `InMemoryAgentMemory` + interfaces for plugging persistent stores.\n- **Approvals**: new `ApprovalWorkflow` + `InMemoryApprovalStore` capture low-confidence decisions and surface them to reviewers.\n\n### @lssm/lib.support-bot\n\nComposable support automation primitives:\n\n- `TicketClassifier` → heuristics + optional LLM validation for category, priority, sentiment.\n- `TicketResolver` → RAG pipeline backed by knowledge spaces.\n- `AutoResponder` → tone-aware drafts with citations.\n- `SupportFeedbackLoop` → tracks resolution rates.\n- `createSupportTools` → ready-made tool definitions for AgentRunner.\n\n### @lssm/lib.content-gen\n\nContent generators that consume a `ContentBrief` and output production-ready assets:\n\n- `BlogGenerator`, `LandingPageGenerator`, `EmailCampaignGenerator`, `SocialPostGenerator`.\n- `SeoOptimizer` builds metadata + schema markup.\n\n### @lssm/lib.analytics\n\nQueryless analytics helpers:\n\n- `FunnelAnalyzer` – conversion/drop-off per step.\n- `CohortTracker` – retention + LTV per cohort.\n- `ChurnPredictor` – recency/frequency/error scoring.\n- `GrowthHypothesisGenerator` – surfaces experiment ideas from metric trends.\n\n### @lssm/lib.growth\n\nA/B testing toolkit:\n\n- `ExperimentRegistry` + `ExperimentRunner` – deterministic bucketing.\n- `ExperimentTracker` – persist exposures + metrics.\n- `StatsEngine` – Welch’s t-test + improvement calculations.\n\n### Human-in-the-loop UI\n\n`@lssm/lib.design-system` now exposes:\n\n- `ApprovalQueue` – list + act on pending approvals.\n- `AgentMonitor` – live view of agent sessions with confidence + status.\n\n## Examples\n\n- `examples/ai-support-bot/setup.ts` shows ticket classification → resolution → response draft.\n- `examples/content-generation/generate.ts` produces blog, landing, email, social, SEO output from one brief.\n\n## Next Steps\n\n1. Wire these libraries into vertical apps (H-Circle, ArtisanOS, etc.).\n2. Add background workers that consume the new analytics/growth trackers.\n3. Expand web-landing to highlight these Phase 2 capabilities (see separate TODO).\n"
+}];
+registerDocBlocks(tech_PHASE_2_AI_NATIVE_OPERATIONS_DocBlocks);
+
+//#endregion