@lssm/lib.contracts 0.0.0-canary-20251209233744 → 0.0.0-canary-20251210075714

package/dist/policy/docs/policy.docblock.js

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.policy`,title:`PolicySpec & PolicyEngine`,summary:"`PolicySpec` gives a declarative, typed home for access-control logic covering:",kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/policy`,tags:[`tech`,`contracts`,`policy`],body:"# PolicySpec & PolicyEngine\n\n## Purpose\n\n`PolicySpec` gives a declarative, typed home for access-control logic covering:\n- **Who** can perform an action (ABAC/ReBAC style rules)\n- **What** they can access (resources + optional field-level overrides)\n- **When** special conditions apply (contextual expressions)\n- **How** PII should be handled (consent/retention hints)\n\n`PolicyEngine` evaluates one or more policies and returns an `allow`/`deny` decision, field-level outcomes, and PII metadata suitable for downstream enforcement (`SpecRegistry` → `ctx.decide`).\n\n## Location\n\n- Types & registry: `packages/libs/contracts/src/policy/spec.ts`\n- Runtime evaluation: `packages/libs/contracts/src/policy/engine.ts`\n- Tests: `packages/.../policy/engine.test.ts`\n\n## `PolicySpec`\n\n```ts\nexport interface PolicySpec {\n  meta: PolicyMeta;          // ownership metadata + { name, version, scope? }\n  rules: PolicyRule[];       // allow/deny rules for actions\n  fieldPolicies?: FieldPolicyRule[];\n  pii?: { fields: string[]; consentRequired?: boolean; retentionDays?: number };\n  relationships?: RelationshipDefinition[];\n  consents?: ConsentDefinition[];\n  rateLimits?: RateLimitDefinition[];\n  opa?: { package: string; decision?: string };\n}\n```\n\n- `PolicyRule`\n  - `effect`: `'allow' | 'deny'`\n  - `actions`: e.g., `['read', 'write', 'delete']` (string namespace is flexible)\n  - `subject`: `{ roles?: string[]; attributes?: { attr: matcher } }`\n  - `resource`: `{ type: string; fields?: string[]; attributes?: {...} }`\n  - `relationships`: `{ relation, objectId?, objectType? }[]` → ReBAC checks (use `objectId: '$resource'` to target the current resource)\n  - `requiresConsent`: `['consent_id']` → references spec-level consent definitions\n  - `flags`: feature flags that must be enabled (`DecisionContext.flags`)\n  - `rateLimit`: string reference to `rateLimits` entry or inline object `{ rpm, key?, windowSeconds?, burst? }`\n  - `escalate`: `'human_review' | null` to indicate manual approval\n  - `conditions`: optional expression snippets evaluated against `{ subject, resource, context }`\n- `FieldPolicyRule`\n  - `field`: dot-path string (e.g., `contact.email`)\n  - `actions`: subset of `['read', 'write']`\n  - Same `subject` / `resource` / `conditions` shape\n  - Useful for redacting specific fields, even when the global action is allowed\n- `RelationshipDefinition`\n  - Canonical tuples for relationship graph (`subjectType`, `relation`, `objectType`, `transitive?`)\n- `ConsentDefinition`\n  - `{ id, scope, purpose, lawfulBasis?, expiresInDays?, required? }`\n- `RateLimitDefinition`\n  - `{ id, rpm, key?, windowSeconds?, burst? }`\n- `PolicyRef`\n  - `{ name: string; version: number }` → attach to contract specs / workflows\n\n## Registry\n\n```ts\nconst registry = new PolicyRegistry();\nregistry.register(CorePolicySpec);\nconst spec = registry.get('core.default', 1);\n```\n\nGuarantees uniqueness per `(name, version)` and exposes helpers to resolve highest versions.\n\n## Engine\n\n```ts\nconst engine = new PolicyEngine(policyRegistry);\n\nconst decision = engine.decide({\n  action: 'read',\n  subject: { roles: ['admin'] },\n  resource: { type: 'resident', fields: ['contact.email'] },\n  policies: [{ name: 'core.default', version: 1 }],\n});\n/*\n{\n  effect: 'allow',\n  reason: 'core.default',\n  fieldDecisions: [{ field: 'contact.email', effect: 'allow' }],\n  pii: { fields: ['contact.email'], consentRequired: true }\n}\n*/\n```\n\n- First matching **deny** wins; otherwise the first **allow** is returned.\n- Field policies are aggregated across referenced policies:\n  - Later denies override earlier allows for a given field.\n  - Returned as `fieldDecisions` to simplify downstream masking.\n- PII metadata is surfaced when defined to help adapt logging/telemetry.\n\n### Expression Support\n\nConditions accept small JS snippets (e.g., `subject.attributes.orgId === context.orgId`). The engine runs them in a constrained scope (`subject`, `resource`, `context`) without access to global state.\n\n### ReBAC & Relationships\n\n- Provide relationship tuples via `PolicySpec.relationships` for documentation/validation.\n- Reference them inside rules with `relationships: [{ relation: 'manager_of', objectType: 'resident', objectId: '$resource' }]`.\n- The execution context must populate `subject.relationships` (`[{ relation, object, objectType }]`) for the engine to evaluate ReBAC guards.\n\n### Consent & Rate Limits\n\n- Declare reusable consent definitions under `consents`. Rules list the IDs they require; if a user session lacks the consent (`DecisionContext.consents`), the engine returns `effect: 'deny'` with `reason: 'consent_required'` and enumerates missing consents.\n- Attach rate limits either inline or via `rateLimits` references. When a rule matches, the engine surfaces `{ rpm, key, windowSeconds?, burst? }` so callers can feed it to shared limiters.\n\n### OPA Adapter\n\n- `OPAPolicyAdapter` bridges engine decisions to Open Policy Agent (OPA). It forwards the evaluation context + policies to OPA and merges any override result (`effect`, `reason`, `fieldDecisions`, `requiredConsents`).\n- Use when migrating to OPA policies or running defense-in-depth: call `engine.decide()`, then pass the preliminary decision to `adapter.evaluate(...)`. The adapter marks merged decisions with `evaluatedBy: 'opa'`.\n- OPA inputs include meta, rules, relationships, rate limits, and consent catalogs to simplify policy authoring on the OPA side.\n\n## Contract Integration\n\n`ContractSpec.policy` now supports:\n\n```ts\npolicy: {\n  auth: 'anonymous' | 'user' | 'admin';\n  ...\n  policies?: PolicyRef[];                // policies evaluated before execution\n  fieldPolicies?: {                      // field hints (read/write) per policy\n    field: string;\n    actions: ('read' | 'write')[];\n    policy?: PolicyRef;\n  }[];\n}\n```\n\nAdapters can resolve refs through a shared `PolicyEngine` and populate `ctx.decide` so `SpecRegistry.execute` benefits from centralized enforcement.\n\n## Authoring Guidelines\n\n1. Prefer **allow-by-default** policies but explicitly deny sensitive flows (defense-in-depth).\n2. Keep rule scopes narrow (per feature/operation) and compose multiple `PolicyRef`s when necessary.\n3. Store PII field lists here to avoid duplication across logs/telemetry.\n4. Use explicit rule reasons for auditability and better developer feedback.\n5. Treat versioning seriously; bump `meta.version` whenever behavior changes.\n\n## Future Enhancements\n\n- Richer expression language (composable predicates, time-based conditions).\n- Multi-tenant relationship graph services (store/resolve relationships at scale).\n- Tooling that auto-generates docs/tests for policies referenced in specs.\n\n"}];e(t);export{t as tech_contracts_policy_DocBlocks};

package/dist/presentations/docs/presentations-conventions.docblock.js

@@ -0,0 +1,8 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.presentations-conventions`,title:`Presentations Conventions (A11y & i18n)`,summary:"- Always provide `meta.description` (≥ 3 chars) — used by a11y/docs/agents.",kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/presentations-conventions`,tags:[`tech`,`contracts`,`presentations-conventions`],body:`## Presentations Conventions (A11y & i18n)
+
+- Always provide \`meta.description\` (≥ 3 chars) — used by a11y/docs/agents.
+- Prefer source = BlockNote for rich guides; use component key for interactive flows.
+- i18n strings belong in host apps; descriptors carry keys/defaults only.
+- Target selection: include only what you intend to support to avoid drift.
+- PII: declare JSON-like paths under \`policy.pii\`; engine redacts in outputs.
+`}];e(t);export{t as tech_contracts_presentations_conventions_DocBlocks};

package/dist/regenerator/docs/regenerator.docblock.js

@@ -0,0 +1,184 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.regenerator`,title:`Regenerator Service`,summary:`The Regenerator daemon observes telemetry, error, and behavior streams, then suggests spec-level changes (not code patches) that can be reviewed and applied through the App Studio.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/regenerator`,tags:[`tech`,`contracts`,`regenerator`],body:`## Regenerator Service
+
+The Regenerator daemon observes telemetry, error, and behavior streams, then suggests spec-level changes (not code patches) that can be reviewed and applied through the App Studio.
+
+- Runtime entrypoint: \`packages/libs/contracts/src/regenerator/service.ts\`
+- Types/interfaces: \`packages/libs/contracts/src/regenerator/types.ts\`
+- Signal adapters: \`packages/libs/contracts/src/regenerator/adapters.ts\`
+
+### Architecture
+
+\`\`\`text
+Signal Adapters ──► RegeneratorService ──► Rules ──► ProposalSink
+          ▲                                       │
+          │                                       ▼
+     Telemetry / Errors / Behavior         Spec change proposals
+\`\`\`
+
+1. **Signal adapters** pull batches of telemetry, error logs, or behavior metrics for each \`RegenerationContext\`.
+2. \`RegeneratorService\` schedules polling (\`resolveAppConfig\` + \`composeAppConfig\` provide context).
+3. **Rules** implement domain heuristics and emit \`SpecChangeProposal\` objects.
+4. **Proposal sinks** persist or forward proposals for human review.
+
+### Key types
+
+\`\`\`ts
+export interface RegenerationContext {
+  id: string;
+  blueprint: AppBlueprintSpec;
+  tenantConfig: TenantAppConfig;
+  resolved: ResolvedAppConfig;
+}
+
+export interface RegeneratorRule {
+  id: string;
+  description: string;
+  evaluate(
+    context: RegenerationContext,
+    signals: RegeneratorSignal[]
+  ): Promise<SpecChangeProposal[]>;
+}
+
+export interface SpecChangeProposal {
+  id: string;
+  title: string;
+  summary: string;
+  confidence: 'low' | 'medium' | 'high';
+  target: ProposalTarget;
+  actions: ProposalAction[];
+  blockers?: ProposalBlocker[];
+  signalIds: string[];
+  createdAt: Date;
+}
+\`\`\`
+
+- Signals are normalized envelopes: telemetry (\`count\`, anomaly score), errors, and behavior trends.
+- Proposals reference blueprint or tenant specs via \`ProposalTarget\`.
+- Actions encode what the automation should perform (update blueprint, run tests/migrations, trigger regeneration).
+
+### Providing signals
+
+Implement \`TelemetrySignalProvider\`, \`ErrorSignalProvider\`, or \`BehaviorSignalProvider\`:
+
+\`\`\`ts
+const service = new RegeneratorService({
+  contexts,
+  adapters: {
+    telemetry: new PosthogTelemetryAdapter(),
+    errors: new SentryErrorAdapter(),
+  },
+  rules: [new WorkflowFailureRule(), new DataViewUsageRule()],
+  sink: new ProposalQueueSink(),
+  pollIntervalMs: 60_000,
+});
+\`\`\`
+
+Adapters receive the full \`RegenerationContext\`, making it easy to scope queries per tenant/app.
+
+### Authoring rules
+
+Rules focus on signals → proposals:
+
+\`\`\`ts
+class WorkflowFailureRule implements RegeneratorRule {
+  id = 'workflow-failure';
+  description = 'Suggest splitting workflows that exceed failure thresholds';
+
+  async evaluate(context, signals) {
+    const failures = signals.filter(
+      (signal) =>
+        signal.type === 'telemetry' &&
+        signal.signal.eventName === 'workflow.failure' &&
+        signal.signal.count >= 10
+    );
+
+    if (failures.length === 0) return [];
+
+    return [
+      {
+        id: \`\${this.id}-\${context.id}\`,
+        title: 'Split onboarding workflow',
+        summary: 'Step 3 fails consistently; propose dedicated remediation branch.',
+        confidence: 'medium',
+        rationale: ['Failure count ≥ 10 within last window'],
+        target: {
+          specType: 'workflow',
+          reference: { name: 'onboarding.workflow', version: 1 },
+          tenantScoped: true,
+        },
+        actions: [
+          { kind: 'update_tenant_config', summary: 'Add alternate fallback path' },
+          { kind: 'run_tests', tests: ['workflows/onboarding.spec.ts'] },
+        ],
+        signalIds: failures.map((f) => f.signal.eventName),
+        createdAt: new Date(),
+      },
+    ];
+  }
+}
+\`\`\`
+
+### Reviewing proposals
+
+Proposals flow to a \`ProposalSink\` (queue, DB, messaging bus). The Studio will surface:
+
+1. Signal evidence (telemetry counts, error metadata)
+2. Proposed spec diffs and required actions (tests/migrations)
+3. Approval workflow (approve → write spec diff → run automation)
+
+### CLI driver
+
+Run the regenerator daemon from the CLI:
+
+\`\`\`bash
+bunx contracts regenerator ./app.blueprint.ts ./tenant.config.ts ./regenerator.rules.ts auto \\
+  --executor ./regenerator.executor.ts \\
+  --poll-interval 60000 \\
+  --batch-duration 300000 \\
+  --dry-run
+\`\`\`
+
+- Expects modules exporting default \`AppBlueprintSpec\`, \`TenantAppConfig\`, and one or more \`RegenerationRule\`s.
+- Pass a sink module path, or use the special \`auto\` value with \`--executor <module>\` to instantiate an \`ExecutorProposalSink\`.
+- Executor modules can export a \`ProposalExecutor\` instance, a factory, or a plain dependency object for the executor constructor. Optional exports: \`sinkOptions\`, \`logger\`, \`onResult\`, \`dryRun\`.
+- Optionally provide \`--contexts ./contexts.ts\` to load custom context arrays (advanced multi-tenant scenarios).
+- Use \`--dry-run\` to preview actions without mutating specs/configs, and \`--once\` for CI smoke tests.
+
+### Proposal executor
+
+\`ProposalExecutor\` + \`ExecutorProposalSink\` orchestrate follow-up actions once a proposal is approved:
+
+- Interfaces for applying blueprint or tenant-config updates (\`BlueprintUpdater\`, \`TenantConfigUpdater\`).
+- Hooks for running contract tests and migrations (\`TestExecutor\`, \`MigrationExecutor\`).
+- Optional trigger to recompose the runtime (\`RegenerationTrigger\`).
+- Built-in \`dryRun\` mode to preview outcomes.
+- Pluggable result logging/forwarding via \`ExecutorSinkOptions\`.
+
+\`\`\`ts
+import {
+  ProposalExecutor,
+  ExecutorProposalSink,
+} from '@lssm/lib.contracts/regenerator';
+
+const executor = new ProposalExecutor({
+  tenantConfigUpdater,
+  testExecutor,
+  migrationExecutor,
+  regenerationTrigger,
+});
+
+const sink = new ExecutorProposalSink(executor, {
+  dryRun: false,
+  onResult: ({ result }) => console.log(result.status),
+});
+\`\`\`
+
+Execution results include per-action status (\`success\`, \`skipped\`, \`failed\`) plus aggregated proposal status (\`success\`, \`partial\`, \`failed\`). Missing dependencies mark actions as \`skipped\`, making it easy to plug into partial automation flows today and extend later.
+
+### Next steps
+
+- Build adapters for existing telemetry/error providers.
+- Encode canonical rules (workflow failure, feature under-use, high latency).
+- Integrate with App Studio proposal inbox and automate acceptance (write spec diff, run tests, queue migrations).
+
+`}];e(t);export{t as tech_contracts_regenerator_DocBlocks};

package/dist/registry.js

@@ -1 +1 @@
-import{eventKey as e}from"./events.js";import{isEmitDeclRef as t}from"./spec.js";function n(e,t){return`${e}.v${t}`}var r=class{specs=new Map;handlers=new Map;register(e){let t=n(e.meta.name,e.meta.version);if(this.specs.has(t))throw Error(`Duplicate spec ${t}`);return this.specs.set(t,e),this}bind(e,t){let r=n(e.meta.name,e.meta.version);if(!this.specs.has(r))throw Error(`Cannot bind; spec not found: ${r}`);if(this.handlers.has(r))throw Error(`Handler already bound for ${r}`);return this.handlers.set(r,t),this}getSpec(e,t){if(t!=null)return this.specs.get(n(e,t));let r,i=-1/0;for(let[t,n]of this.specs.entries())t.startsWith(`${e}.v`)&&n.meta.version>i&&(i=n.meta.version,r=n);return r}getHandler(e,t){let r=this.getSpec(e,t);if(r)return this.handlers.get(n(r.meta.name,r.meta.version))}listSpecs(){return[...this.specs.values()]}listBound(){let e=[];for(let[t,n]of this.specs.entries()){let r=this.handlers.get(t);r&&e.push({spec:n,handler:r})}return e}async execute(r,i,a,o){let s=this.getSpec(r,i);if(!s)throw Error(`Spec not found for ${r}${i?`.v${i}`:``}`);let c=await o.specVariantResolver?.resolve({name:s.meta.name,version:s.meta.version,kind:s.meta.kind},o)??s,l=n(c.meta.name,c.meta.version),u=this.handlers.get(l);if(!u){let e=n(s.meta.name,s.meta.version);u=this.handlers.get(e),l=e}if(!u)throw Error(`No handler bound for ${l}`);let d=c.io.input?.getZod().parse(a);if(o.decide){let[e,t]=c.meta.name.split(`.`),n=await o.decide({service:e,command:t,version:c.meta.version,actor:o.actor??`anonymous`,channel:o.channel,roles:o.roles,organizationId:o.organizationId,userId:o.userId,flags:[]});if(n.effect===`deny`)throw Error(`PolicyDenied: ${c.meta.name}.v${c.meta.version}`);if(n.rateLimit&&o.rateLimit){let e=n.rateLimit.key??`default`,t=n.rateLimit.rpm??60;await o.rateLimit(e,1,t)}}let f=new Map;if(c.sideEffects?.emits)for(let e of c.sideEffects.emits)t(e)?f.set(`${e.ref.name}.v${e.ref.version}`,e.ref.payload):f.set(`${e.name}.v${e.version}`,e.payload);let p=async(t,r,i)=>{let a=e(t,r),s=f.get(a);if(!s)throw Error(`UndeclaredEvent: ${a} not allowed by ${n(c.meta.name,c.meta.version)}`);let l=s.getZod().parse(i);await o.eventPublisher?.({name:t,version:r,payload:l,traceId:o.traceId})};o.appConfig&&(o.branding||=o.appConfig.branding,o.translation?o.translation.config||(o.translation={...o.translation,config:o.appConfig.translation}):o.translation={config:o.appConfig.translation});let m=o.telemetry,h=async(e,t)=>{if(!(!m||!e?.event))try{let n=e.properties?.(t)??{};await m.track(e.event.name,e.event.version??1,n,{tenantId:o.organizationId??void 0,organizationId:o.organizationId,userId:o.userId,actor:o.actor,channel:o.channel,metadata:o.traceId?{traceId:o.traceId}:void 0})}catch{}},g;try{g=await u(d,{...o,__emitGuard__:p})}catch(e){throw c.telemetry?.failure&&await h(c.telemetry.failure,{input:d??a,error:e}),e}c.telemetry?.success&&await h(c.telemetry.success,{input:d??a,output:g});let _=c.io.output;return _?.getZod?_.getZod().parse(g):g}};export{r as SpecRegistry,n as opKey};
+import{eventKey as e}from"./events.js";import{isEmitDeclRef as t}from"./spec.js";import{defaultDocRegistry as n,docId as r,registerDocBlocks as i}from"./docs/registry.js";function a(e,t){return`${e}.v${t}`}var o=class{specs=new Map;handlers=new Map;register(e){let t=a(e.meta.name,e.meta.version);if(this.specs.has(t))throw Error(`Duplicate spec ${t}`);return this.specs.set(t,e),this}bind(e,t){let n=a(e.meta.name,e.meta.version);if(!this.specs.has(n))throw Error(`Cannot bind; spec not found: ${n}`);if(this.handlers.has(n))throw Error(`Handler already bound for ${n}`);return this.handlers.set(n,t),this}getSpec(e,t){if(t!=null)return this.specs.get(a(e,t));let n,r=-1/0;for(let[t,i]of this.specs.entries())t.startsWith(`${e}.v`)&&i.meta.version>r&&(r=i.meta.version,n=i);return n}getHandler(e,t){let n=this.getSpec(e,t);if(n)return this.handlers.get(a(n.meta.name,n.meta.version))}listSpecs(){return[...this.specs.values()]}listBound(){let e=[];for(let[t,n]of this.specs.entries()){let r=this.handlers.get(t);r&&e.push({spec:n,handler:r})}return e}async execute(n,r,i,o){let s=this.getSpec(n,r);if(!s)throw Error(`Spec not found for ${n}${r?`.v${r}`:``}`);let c=await o.specVariantResolver?.resolve({name:s.meta.name,version:s.meta.version,kind:s.meta.kind},o)??s,l=a(c.meta.name,c.meta.version),u=this.handlers.get(l);if(!u){let e=a(s.meta.name,s.meta.version);u=this.handlers.get(e),l=e}if(!u)throw Error(`No handler bound for ${l}`);let d=c.io.input?.getZod().parse(i);if(o.decide){let[e,t]=c.meta.name.split(`.`),n=await o.decide({service:e,command:t,version:c.meta.version,actor:o.actor??`anonymous`,channel:o.channel,roles:o.roles,organizationId:o.organizationId,userId:o.userId,flags:[]});if(n.effect===`deny`)throw Error(`PolicyDenied: ${c.meta.name}.v${c.meta.version}`);if(n.rateLimit&&o.rateLimit){let e=n.rateLimit.key??`default`,t=n.rateLimit.rpm??60;await o.rateLimit(e,1,t)}}let f=new Map;if(c.sideEffects?.emits)for(let e of c.sideEffects.emits)t(e)?f.set(`${e.ref.name}.v${e.ref.version}`,e.ref.payload):f.set(`${e.name}.v${e.version}`,e.payload);let p=async(t,n,r)=>{let i=e(t,n),s=f.get(i);if(!s)throw Error(`UndeclaredEvent: ${i} not allowed by ${a(c.meta.name,c.meta.version)}`);let l=s.getZod().parse(r);await o.eventPublisher?.({name:t,version:n,payload:l,traceId:o.traceId})};o.appConfig&&(o.branding||=o.appConfig.branding,o.translation?o.translation.config||(o.translation={...o.translation,config:o.appConfig.translation}):o.translation={config:o.appConfig.translation});let m=o.telemetry,h=async(e,t)=>{if(!(!m||!e?.event))try{let n=e.properties?.(t)??{};await m.track(e.event.name,e.event.version??1,n,{tenantId:o.organizationId??void 0,organizationId:o.organizationId,userId:o.userId,actor:o.actor,channel:o.channel,metadata:o.traceId?{traceId:o.traceId}:void 0})}catch{}},g;try{g=await u(d,{...o,__emitGuard__:p})}catch(e){throw c.telemetry?.failure&&await h(c.telemetry.failure,{input:d??i,error:e}),e}c.telemetry?.success&&await h(c.telemetry.success,{input:d??i,output:g});let _=c.io.output;return _?.getZod?_.getZod().parse(g):g}};export{o as SpecRegistry,n as defaultDocRegistry,r as docId,a as opKey,i as registerDocBlocks};

package/dist/server/index.js

@@ -1 +1 @@
-import{registerContractsOnBuilder as e}from"./graphql-pothos.js";import{exportContractsToGraphQLSchema as t}from"./graphql-schema-export.js";import{createMcpServer as n}from"./provider-mcp.js";import{createFetchHandler as r}from"./rest-generic.js";import{elysiaPlugin as i}from"./rest-elysia.js";import{expressRouter as a}from"./rest-express.js";import{makeNextAppHandler as o}from"./rest-next-app.js";import{makeNextPagesHandler as s}from"./rest-next-pages.js";export{r as createFetchHandler,n as createMcpServer,i as elysiaPlugin,t as exportContractsToGraphQLSchema,a as expressRouter,o as makeNextAppHandler,s as makeNextPagesHandler,e as registerContractsOnBuilder};
+import{registerContractsOnBuilder as e}from"./graphql-pothos.js";import{createMcpServer as t}from"./provider-mcp.js";import{createFetchHandler as n}from"./rest-generic.js";import{elysiaPlugin as r}from"./rest-elysia.js";import{expressRouter as i}from"./rest-express.js";import{makeNextAppHandler as a}from"./rest-next-app.js";import{makeNextPagesHandler as o}from"./rest-next-pages.js";export{n as createFetchHandler,t as createMcpServer,r as elysiaPlugin,i as expressRouter,a as makeNextAppHandler,o as makeNextPagesHandler,e as registerContractsOnBuilder};

package/dist/telemetry/docs/telemetry.docblock.js

@@ -0,0 +1,139 @@
+import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.telemetry`,title:`TelemetrySpec`,summary:"Telemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.",kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/telemetry`,tags:[`tech`,`contracts`,`telemetry`],body:`## TelemetrySpec
+
+Telemetry specs describe product analytics in a durable, type-safe way. They reference existing \`EventSpec\`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.
+
+- **File location**: \`packages/libs/contracts/src/telemetry/spec.ts\`
+- **Runtime tracker**: \`packages/libs/contracts/src/telemetry/tracker.ts\`
+- **Anomaly monitor**: \`packages/libs/contracts/src/telemetry/anomaly.ts\`
+
+### Core concepts
+
+\`\`\`ts
+export interface TelemetrySpec {
+  meta: TelemetryMeta;
+  events: TelemetryEventDef[];
+  config?: TelemetryConfig;
+}
+\`\`\`
+
+- \`meta\`: ownership + identifiers (\`name\`, \`version\`, \`domain\`)
+- \`events\`: per-event semantics, property definitions, privacy level, retention, sampling, anomaly rules
+- \`config\`: defaults and provider configuration
+- \`TelemetryRegistry\`: registers specs, resolves latest version, finds event definitions by name/version
+
+### An example
+
+\`\`\`ts
+export const SigilTelemetry: TelemetrySpec = {
+  meta: {
+    name: 'sigil.telemetry',
+    version: 1,
+    title: 'Sigil telemetry',
+    description: 'Core Sigil product telemetry',
+    domain: 'sigil',
+    owners: ['@team.analytics'],
+    tags: ['telemetry'],
+    stability: StabilityEnum.Experimental,
+  },
+  config: {
+    defaultRetentionDays: 30,
+    defaultSamplingRate: 1,
+    providers: [
+      { type: 'posthog', config: { projectApiKey: process.env.POSTHOG_KEY } },
+    ],
+  },
+  events: [
+    {
+      name: 'sigil.telemetry.workflow_step',
+      version: 1,
+      semantics: {
+        what: 'Workflow step executed',
+        who: 'Actor executing the workflow',
+      },
+      privacy: 'internal',
+      properties: {
+        workflow: { type: 'string', required: true },
+        step: { type: 'string', required: true },
+        durationMs: { type: 'number' },
+        userId: { type: 'string', pii: true, redact: true },
+      },
+      anomalyDetection: {
+        enabled: true,
+        minimumSample: 10,
+        thresholds: [
+          { metric: 'durationMs', max: 1500 },
+        ],
+        actions: ['alert', 'trigger_regen'],
+      },
+    },
+  ],
+};
+\`\`\`
+
+### Tracking events at runtime
+
+\`TelemetryTracker\` performs sampling, PII redaction, provider dispatch, and anomaly detection.
+
+\`\`\`ts
+const tracker = new TelemetryTracker({
+  registry: telemetryRegistry,
+  providers: [
+    {
+      id: 'posthog',
+      async send(dispatch) {
+        posthog.capture({
+          event: dispatch.name,
+          properties: dispatch.properties,
+          distinctId: dispatch.context.userId ?? dispatch.context.sessionId,
+        });
+      },
+    },
+  ],
+  anomalyMonitor: new TelemetryAnomalyMonitor({
+    onAnomaly(event) {
+      console.warn('Telemetry anomaly detected', event);
+    },
+  }),
+});
+
+await tracker.track('sigil.telemetry.workflow_step', 1, {
+  workflow: 'onboarding',
+  step: 'verify_email',
+  durationMs: 2100,
+  userId: 'user-123',
+});
+\`\`\`
+
+- Sampling obeys the event-specific rate (fallback to spec defaults)
+- Properties flagged with \`pii\` or \`redact\` are masked before dispatch
+- Anomaly monitor evaluates thresholds and triggers actions (e.g., log, alert, regeneration)
+
+### Spec integration
+
+- \`ContractSpec.telemetry\` allows operations to emit success/failure events automatically
+- \`SpecRegistry.execute()\` uses the tracker when \`ctx.telemetry\` is provided
+- \`WorkflowRunner\` (Phase 4 follow-up) will emit telemetry during step transitions
+- \`TelemetrySpec\` events should reuse \`EventSpec\` names/versions to keep analytics/contract parity
+
+### CLI workflow
+
+\`\`\`
+contracts-cli create telemetry
+\`\`\`
+
+- Interactive wizard prompts for meta, providers, events, properties, retention, anomaly rules
+- Output: \`*.telemetry.ts\` file using \`TelemetrySpec\`
+
+### Best practices
+
+- Prefer \`internal\` privacy for non-PII; mark PII properties explicitly with \`pii\` + \`redact\`
+- Keep sampling ≥0.05 except for high-volume events
+- Configure anomaly detection on key metrics (duration, error count, conversion)
+- Check telemetry into source control alongside contracts; regenerate via CLI when specs change
+
+### Next steps
+
+- Phase 5: Regenerator monitors telemetry anomalies to propose spec improvements
+- Phase 6: Studio surfaces telemetry controls per tenant via \`TenantAppConfig\`
+
+`}];e(t);export{t as tech_contracts_telemetry_DocBlocks};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.contracts",
-  "version": "0.0.0-canary-20251209233744",
+  "version": "0.0.0-canary-20251210075714",
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "build": "bun build:bundle && bun build:types",
@@ -26,7 +26,6 @@
     "@elevenlabs/elevenlabs-js": "^2.26.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "@google-cloud/storage": "^7.18.0",
-    "@lssm/lib.graphql-federation": "workspace:*",
     "@lssm/lib.schema": "workspace:*",
     "@mistralai/mistralai": "^1.2.3",
     "@modelcontextprotocol/sdk": "^1.24.3",
@@ -66,6 +65,7 @@
     "./app-config": "./src/app-config/index.ts",
     "./app-config/branding": "./src/app-config/branding.ts",
     "./app-config/contracts": "./src/app-config/contracts.ts",
+    "./app-config/docs/app-config.docblock": "./src/app-config/docs/app-config.docblock.ts",
     "./app-config/events": "./src/app-config/events.ts",
     "./app-config/lifecycle": "./src/app-config/lifecycle.ts",
     "./app-config/lifecycle-contracts": "./src/app-config/lifecycle-contracts.ts",
@@ -73,6 +73,7 @@
     "./app-config/spec": "./src/app-config/spec.ts",
     "./app-config/validation": "./src/app-config/validation.ts",
     "./capabilities": "./src/capabilities.ts",
+    "./capabilities/docs/capabilities.docblock": "./src/capabilities/docs/capabilities.docblock.ts",
     "./capabilities/openbanking": "./src/capabilities/openbanking.ts",
     "./client": "./src/client/index.ts",
     "./client/react": "./src/client/react/index.ts",
@@ -83,19 +84,51 @@
     "./contracts-adapter-hydration": "./src/contracts-adapter-hydration.ts",
     "./contracts-adapter-input": "./src/contracts-adapter-input.ts",
     "./data-views": "./src/data-views.ts",
+    "./data-views/docs/data-views.docblock": "./src/data-views/docs/data-views.docblock.ts",
     "./data-views/query-generator": "./src/data-views/query-generator.ts",
     "./data-views/runtime": "./src/data-views/runtime.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/accessibility_wcag_compliance_specs.docblock": "./src/docs/accessibility_wcag_compliance_specs.docblock.ts",
+    "./docs/meta.docs": "./src/docs/meta.docs.ts",
+    "./docs/presentations": "./src/docs/presentations.ts",
+    "./docs/PUBLISHING.docblock": "./src/docs/PUBLISHING.docblock.ts",
+    "./docs/registry": "./src/docs/registry.ts",
+    "./docs/tech-contracts.docs": "./src/docs/tech-contracts.docs.ts",
+    "./docs/tech/contracts/create-subscription.docblock": "./src/docs/tech/contracts/create-subscription.docblock.ts",
+    "./docs/tech/contracts/graphql-typed-outputs.docblock": "./src/docs/tech/contracts/graphql-typed-outputs.docblock.ts",
+    "./docs/tech/contracts/migrations.docblock": "./src/docs/tech/contracts/migrations.docblock.ts",
+    "./docs/tech/contracts/ops-to-presentation-linking.docblock": "./src/docs/tech/contracts/ops-to-presentation-linking.docblock.ts",
+    "./docs/tech/contracts/overlays.docblock": "./src/docs/tech/contracts/overlays.docblock.ts",
+    "./docs/tech/contracts/README.docblock": "./src/docs/tech/contracts/README.docblock.ts",
+    "./docs/tech/contracts/tests.docblock": "./src/docs/tech/contracts/tests.docblock.ts",
+    "./docs/tech/contracts/themes.docblock": "./src/docs/tech/contracts/themes.docblock.ts",
+    "./docs/tech/contracts/vertical-pocket-family-office.docblock": "./src/docs/tech/contracts/vertical-pocket-family-office.docblock.ts",
+    "./docs/tech/lifecycle-stage-system.docblock": "./src/docs/tech/lifecycle-stage-system.docblock.ts",
+    "./docs/tech/mcp-endpoints.docblock": "./src/docs/tech/mcp-endpoints.docblock.ts",
+    "./docs/tech/PHASE_1_QUICKSTART.docblock": "./src/docs/tech/PHASE_1_QUICKSTART.docblock.ts",
+    "./docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock": "./src/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.ts",
+    "./docs/tech/PHASE_3_AUTO_EVOLUTION.docblock": "./src/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.ts",
+    "./docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock": "./src/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.ts",
+    "./docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock": "./src/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.ts",
+    "./docs/tech/presentation-runtime.docblock": "./src/docs/tech/presentation-runtime.docblock.ts",
+    "./docs/tech/schema/README.docblock": "./src/docs/tech/schema/README.docblock.ts",
+    "./docs/tech/templates/runtime.docblock": "./src/docs/tech/templates/runtime.docblock.ts",
+    "./docs/tech/workflows/overview.docblock": "./src/docs/tech/workflows/overview.docblock.ts",
+    "./docs/types": "./src/docs/types.ts",
     "./events": "./src/events.ts",
+    "./experiments/docs/experiments.docblock": "./src/experiments/docs/experiments.docblock.ts",
     "./experiments/evaluator": "./src/experiments/evaluator.ts",
     "./experiments/spec": "./src/experiments/spec.ts",
     "./experiments/spec-resolver": "./src/experiments/spec-resolver.ts",
     "./features": "./src/features.ts",
     "./forms": "./src/forms.ts",
+    "./forms/docs/forms.docblock": "./src/forms/docs/forms.docblock.ts",
     "./install": "./src/install.ts",
     "./integrations": "./src/integrations/index.ts",
     "./integrations/binding": "./src/integrations/binding.ts",
     "./integrations/connection": "./src/integrations/connection.ts",
     "./integrations/contracts": "./src/integrations/contracts.ts",
+    "./integrations/docs/integrations.docblock": "./src/integrations/docs/integrations.docblock.ts",
     "./integrations/health": "./src/integrations/health.ts",
     "./integrations/openbanking/contracts": "./src/integrations/openbanking/contracts/index.ts",
     "./integrations/openbanking/contracts/accounts": "./src/integrations/openbanking/contracts/accounts.ts",
@@ -162,6 +195,7 @@
     "./knowledge": "./src/knowledge/index.ts",
     "./knowledge/binding": "./src/knowledge/binding.ts",
     "./knowledge/contracts": "./src/knowledge/contracts.ts",
+    "./knowledge/docs/knowledge.docblock": "./src/knowledge/docs/knowledge.docblock.ts",
     "./knowledge/ingestion": "./src/knowledge/ingestion/index.ts",
     "./knowledge/ingestion/document-processor": "./src/knowledge/ingestion/document-processor.ts",
     "./knowledge/ingestion/embedding-service": "./src/knowledge/ingestion/embedding-service.ts",
@@ -183,17 +217,21 @@
     "./markdown": "./src/markdown.ts",
     "./migrations": "./src/migrations.ts",
     "./onboarding-base": "./src/onboarding-base.ts",
+    "./openbanking/docs/openbanking.docblock": "./src/openbanking/docs/openbanking.docblock.ts",
     "./ownership": "./src/ownership.ts",
+    "./policy/docs/policy.docblock": "./src/policy/docs/policy.docblock.ts",
     "./policy/engine": "./src/policy/engine.ts",
     "./policy/opa-adapter": "./src/policy/opa-adapter.ts",
     "./policy/spec": "./src/policy/spec.ts",
     "./presentations": "./src/presentations.ts",
     "./presentations.backcompat": "./src/presentations.backcompat.ts",
     "./presentations.v2": "./src/presentations.v2.ts",
+    "./presentations/docs/presentations-conventions.docblock": "./src/presentations/docs/presentations-conventions.docblock.ts",
     "./prompt": "./src/prompt.ts",
     "./promptRegistry": "./src/promptRegistry.ts",
     "./regenerator": "./src/regenerator/index.ts",
     "./regenerator/adapters": "./src/regenerator/adapters.ts",
+    "./regenerator/docs/regenerator.docblock": "./src/regenerator/docs/regenerator.docblock.ts",
     "./regenerator/executor": "./src/regenerator/executor.ts",
     "./regenerator/service": "./src/regenerator/service.ts",
     "./regenerator/sinks": "./src/regenerator/sinks.ts",
@@ -204,7 +242,6 @@
     "./schema-to-markdown": "./src/schema-to-markdown.ts",
     "./server": "./src/server/index.ts",
     "./server/graphql-pothos": "./src/server/graphql-pothos.ts",
-    "./server/graphql-schema-export": "./src/server/graphql-schema-export.ts",
     "./server/provider-mcp": "./src/server/provider-mcp.ts",
     "./server/rest-elysia": "./src/server/rest-elysia.ts",
     "./server/rest-express": "./src/server/rest-express.ts",
@@ -215,6 +252,7 @@
     "./spec": "./src/spec.ts",
     "./telemetry": "./src/telemetry/index.ts",
     "./telemetry/anomaly": "./src/telemetry/anomaly.ts",
+    "./telemetry/docs/telemetry.docblock": "./src/telemetry/docs/telemetry.docblock.ts",
     "./telemetry/spec": "./src/telemetry/spec.ts",
     "./telemetry/tracker": "./src/telemetry/tracker.ts",
     "./tests": "./src/tests/index.ts",
@@ -245,6 +283,7 @@
       "./app-config": "./dist/app-config/index.js",
       "./app-config/branding": "./dist/app-config/branding.js",
       "./app-config/contracts": "./dist/app-config/contracts.js",
+      "./app-config/docs/app-config.docblock": "./dist/app-config/docs/app-config.docblock.js",
       "./app-config/events": "./dist/app-config/events.js",
       "./app-config/lifecycle": "./dist/app-config/lifecycle.js",
       "./app-config/lifecycle-contracts": "./dist/app-config/lifecycle-contracts.js",
@@ -252,6 +291,7 @@
       "./app-config/spec": "./dist/app-config/spec.js",
       "./app-config/validation": "./dist/app-config/validation.js",
       "./capabilities": "./dist/capabilities.js",
+      "./capabilities/docs/capabilities.docblock": "./dist/capabilities/docs/capabilities.docblock.js",
       "./capabilities/openbanking": "./dist/capabilities/openbanking.js",
       "./client": "./dist/client/index.js",
       "./client/react": "./dist/client/react/index.js",
@@ -262,19 +302,51 @@
       "./contracts-adapter-hydration": "./dist/contracts-adapter-hydration.js",
       "./contracts-adapter-input": "./dist/contracts-adapter-input.js",
       "./data-views": "./dist/data-views.js",
+      "./data-views/docs/data-views.docblock": "./dist/data-views/docs/data-views.docblock.js",
       "./data-views/query-generator": "./dist/data-views/query-generator.js",
       "./data-views/runtime": "./dist/data-views/runtime.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/accessibility_wcag_compliance_specs.docblock": "./dist/docs/accessibility_wcag_compliance_specs.docblock.js",
+      "./docs/meta.docs": "./dist/docs/meta.docs.js",
+      "./docs/presentations": "./dist/docs/presentations.js",
+      "./docs/PUBLISHING.docblock": "./dist/docs/PUBLISHING.docblock.js",
+      "./docs/registry": "./dist/docs/registry.js",
+      "./docs/tech-contracts.docs": "./dist/docs/tech-contracts.docs.js",
+      "./docs/tech/contracts/create-subscription.docblock": "./dist/docs/tech/contracts/create-subscription.docblock.js",
+      "./docs/tech/contracts/graphql-typed-outputs.docblock": "./dist/docs/tech/contracts/graphql-typed-outputs.docblock.js",
+      "./docs/tech/contracts/migrations.docblock": "./dist/docs/tech/contracts/migrations.docblock.js",
+      "./docs/tech/contracts/ops-to-presentation-linking.docblock": "./dist/docs/tech/contracts/ops-to-presentation-linking.docblock.js",
+      "./docs/tech/contracts/overlays.docblock": "./dist/docs/tech/contracts/overlays.docblock.js",
+      "./docs/tech/contracts/README.docblock": "./dist/docs/tech/contracts/README.docblock.js",
+      "./docs/tech/contracts/tests.docblock": "./dist/docs/tech/contracts/tests.docblock.js",
+      "./docs/tech/contracts/themes.docblock": "./dist/docs/tech/contracts/themes.docblock.js",
+      "./docs/tech/contracts/vertical-pocket-family-office.docblock": "./dist/docs/tech/contracts/vertical-pocket-family-office.docblock.js",
+      "./docs/tech/lifecycle-stage-system.docblock": "./dist/docs/tech/lifecycle-stage-system.docblock.js",
+      "./docs/tech/mcp-endpoints.docblock": "./dist/docs/tech/mcp-endpoints.docblock.js",
+      "./docs/tech/PHASE_1_QUICKSTART.docblock": "./dist/docs/tech/PHASE_1_QUICKSTART.docblock.js",
+      "./docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock": "./dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js",
+      "./docs/tech/PHASE_3_AUTO_EVOLUTION.docblock": "./dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js",
+      "./docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock": "./dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js",
+      "./docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock": "./dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js",
+      "./docs/tech/presentation-runtime.docblock": "./dist/docs/tech/presentation-runtime.docblock.js",
+      "./docs/tech/schema/README.docblock": "./dist/docs/tech/schema/README.docblock.js",
+      "./docs/tech/templates/runtime.docblock": "./dist/docs/tech/templates/runtime.docblock.js",
+      "./docs/tech/workflows/overview.docblock": "./dist/docs/tech/workflows/overview.docblock.js",
+      "./docs/types": "./dist/docs/types.js",
       "./events": "./dist/events.js",
+      "./experiments/docs/experiments.docblock": "./dist/experiments/docs/experiments.docblock.js",
       "./experiments/evaluator": "./dist/experiments/evaluator.js",
       "./experiments/spec": "./dist/experiments/spec.js",
       "./experiments/spec-resolver": "./dist/experiments/spec-resolver.js",
       "./features": "./dist/features.js",
       "./forms": "./dist/forms.js",
+      "./forms/docs/forms.docblock": "./dist/forms/docs/forms.docblock.js",
       "./install": "./dist/install.js",
       "./integrations": "./dist/integrations/index.js",
       "./integrations/binding": "./dist/integrations/binding.js",
       "./integrations/connection": "./dist/integrations/connection.js",
       "./integrations/contracts": "./dist/integrations/contracts.js",
+      "./integrations/docs/integrations.docblock": "./dist/integrations/docs/integrations.docblock.js",
       "./integrations/health": "./dist/integrations/health.js",
       "./integrations/openbanking/contracts": "./dist/integrations/openbanking/contracts/index.js",
       "./integrations/openbanking/contracts/accounts": "./dist/integrations/openbanking/contracts/accounts.js",
@@ -341,6 +413,7 @@
       "./knowledge": "./dist/knowledge/index.js",
       "./knowledge/binding": "./dist/knowledge/binding.js",
       "./knowledge/contracts": "./dist/knowledge/contracts.js",
+      "./knowledge/docs/knowledge.docblock": "./dist/knowledge/docs/knowledge.docblock.js",
       "./knowledge/ingestion": "./dist/knowledge/ingestion/index.js",
       "./knowledge/ingestion/document-processor": "./dist/knowledge/ingestion/document-processor.js",
       "./knowledge/ingestion/embedding-service": "./dist/knowledge/ingestion/embedding-service.js",
@@ -362,17 +435,21 @@
       "./markdown": "./dist/markdown.js",
       "./migrations": "./dist/migrations.js",
       "./onboarding-base": "./dist/onboarding-base.js",
+      "./openbanking/docs/openbanking.docblock": "./dist/openbanking/docs/openbanking.docblock.js",
       "./ownership": "./dist/ownership.js",
+      "./policy/docs/policy.docblock": "./dist/policy/docs/policy.docblock.js",
       "./policy/engine": "./dist/policy/engine.js",
       "./policy/opa-adapter": "./dist/policy/opa-adapter.js",
       "./policy/spec": "./dist/policy/spec.js",
       "./presentations": "./dist/presentations.js",
       "./presentations.backcompat": "./dist/presentations.backcompat.js",
       "./presentations.v2": "./dist/presentations.v2.js",
+      "./presentations/docs/presentations-conventions.docblock": "./dist/presentations/docs/presentations-conventions.docblock.js",
       "./prompt": "./dist/prompt.js",
       "./promptRegistry": "./dist/promptRegistry.js",
       "./regenerator": "./dist/regenerator/index.js",
       "./regenerator/adapters": "./dist/regenerator/adapters.js",
+      "./regenerator/docs/regenerator.docblock": "./dist/regenerator/docs/regenerator.docblock.js",
       "./regenerator/executor": "./dist/regenerator/executor.js",
       "./regenerator/service": "./dist/regenerator/service.js",
       "./regenerator/sinks": "./dist/regenerator/sinks.js",
@@ -383,7 +460,6 @@
       "./schema-to-markdown": "./dist/schema-to-markdown.js",
       "./server": "./dist/server/index.js",
       "./server/graphql-pothos": "./dist/server/graphql-pothos.js",
-      "./server/graphql-schema-export": "./dist/server/graphql-schema-export.js",
       "./server/provider-mcp": "./dist/server/provider-mcp.js",
       "./server/rest-elysia": "./dist/server/rest-elysia.js",
       "./server/rest-express": "./dist/server/rest-express.js",
@@ -394,6 +470,7 @@
       "./spec": "./dist/spec.js",
       "./telemetry": "./dist/telemetry/index.js",
       "./telemetry/anomaly": "./dist/telemetry/anomaly.js",
+      "./telemetry/docs/telemetry.docblock": "./dist/telemetry/docs/telemetry.docblock.js",
       "./telemetry/spec": "./dist/telemetry/spec.js",
       "./telemetry/tracker": "./dist/telemetry/tracker.js",
       "./tests": "./dist/tests/index.js",

package/dist/server/graphql-schema-export.js

@@ -1 +0,0 @@
-"use server";import{require_graphql as e}from"../node_modules/graphql/index.js";import{toSubgraphSDL as t}from"@lssm/lib.graphql-federation";var n=e();const r=async(e,r)=>{let i=await import(`fs`),a=await import(`path`),o=(0,n.printSchema)(e),s=t(e),c=a.join(r,`../schema.graphql`),l=a.join(r,`../schema.subgraph.graphql`);i.writeFileSync(c,o),console.log(`Schema exported to ${c}`),i.writeFileSync(l,s),console.log(`Subgraph exported to ${l}`)};export{r as exportContractsToGraphQLSchema};