@lssm/example.policy-safe-knowledge-assistant 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

package/dist/libs/contracts/dist/docs/tech-contracts.docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-contracts.docs.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/tech-contracts.docs.js"],"sourcesContent":["import { registerDocBlocks } from \"./registry.js\";\n\n//#region src/docs/tech-contracts.docs.ts\nconst techContractsDocs = [{\n\tid: \"docs.tech.contracts.presentations-v2\",\n\ttitle: \"Presentations V2 — Unified Descriptor & Transform Engine\",\n\tsummary: \"How PresentationDescriptorV2 and TransformEngine keep docs/renderers consistent.\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/contracts/presentations-v2\",\n\tkind: \"reference\",\n\ttags: [\n\t\t\"presentations\",\n\t\t\"docs\",\n\t\t\"mcp\"\n\t],\n\tbody: `## Presentations V2 — Unified Descriptor & Transform Engine\n\n### Purpose\n\nUnify presentations into one descriptor (\\`PresentationDescriptorV2\\`) that declares a single source (React component key or BlockNote doc) and a list of output targets (react, markdown, application/json, application/xml). A pluggable \\`TransformEngine\\` renders any target and applies PII redaction.\n\n### Types\n\n\\`\\`\\`ts\ntype PresentationTarget =\n  | 'react'\n  | 'markdown'\n  | 'application/json'\n  | 'application/xml';\n\ntype PresentationSource =\n  | {\n      type: 'component';\n      framework: 'react';\n      componentKey: string;\n      props?: AnySchemaModel;\n    }\n  | { type: 'blocknotejs'; docJson: unknown; blockConfig?: unknown };\n\ninterface PresentationDescriptorV2 {\n  meta: PresentationV2Meta; // includes partial OwnerShipMeta + description\n  policy?: { flags?: string[]; pii?: string[] };\n  source: PresentationSource;\n  targets: PresentationTarget[];\n}\n\n// Shared ownership schema (source of truth in @lssm/lib.contracts/src/ownership.ts)\ninterface OwnerShipMeta {\n  title: string;\n  description: string;\n  domain: string;\n  owners: Owner[];\n  tags: Tag[];\n  stability: Stability;\n}\n\ntype Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';\ntype Owner = string; // curated list available in code (e.g., '@sigil-team', 'team-strit')\ntype Tag = string; // curated list available in code (e.g., 'auth', 'spots')\n\n// For V2 presentations, meta is a Partial<OwnerShipMeta> plus description, name, version\ninterface PresentationV2Meta extends Partial<OwnerShipMeta> {\n  name: string;\n  version: number;\n  description?: string;\n}\n\\`\\`\\`\n\n### Engine\n\nUse \\`createDefaultTransformEngine()\\` and register custom renderers as needed (e.g., high-fidelity BlockNote → Markdown). The default engine supports markdown/json/xml; a React renderer returns a serializable descriptor the host app renders via a \\`componentMap\\` or a BlockNote renderer. The canonical source type string is \\`blocknotejs\\` (not \\`blocknote\\`).\n\nPII paths (JSON-like) are redacted from rendered outputs.\n\n### MCP Integration\n\n\\`createMcpServer\\` accepts \\`presentationsV2\\`. Each descriptor is exposed under \\`presentation://<name>/v<version>\\` and negotiated variants (\\`.md/.json/.xml\\`) are rendered by the engine.\n\n### Migration\n\n- V1 \\`PresentationSpec\\` remains supported; a back-compat helper converts V1 → V2 when convenient.\n- Prefer V2 for new work.\n\n### Examples (Sigil)\n\n- \\`sigil.auth.webauth_tabs_v2\\`: component source (\\`componentKey: 'sigil.webauth.tabs'\\`), targets \\`react/json/xml\\`.\n- \\`sigil.signup.guide_v2\\`: BlockNote doc source, targets \\`react/markdown/json/xml\\`.\n\n### React Rendering\n\nHost apps use a \\`componentMap\\` (e.g., \\`'sigil.webauth.tabs' → WebAuthTabs\\`) and a BlockNote renderer to turn the React render descriptor into elements.`\n}];\nregisterDocBlocks(techContractsDocs);\n\n//#endregion\nexport { techContractsDocs };"],"mappings":";;;AAGA,MAAM,oBAAoB,CAAC;CAC1B,IAAI;CACJ,OAAO;CACP,SAAS;CACT,YAAY;CACZ,OAAO;CACP,MAAM;CACN,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EN,CAAC;AACF,kBAAkB,kBAAkB"}

package/dist/orchestrator/buildAnswer.d.ts

@@ -49,4 +49,5 @@ interface BuildAnswerInput {
  */
 declare function buildPolicySafeAnswer(input: BuildAnswerInput): Promise<AssistantAnswerIR>;
 //#endregion
-export { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer };
+export { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer };
+//# sourceMappingURL=buildAnswer.d.ts.map

package/dist/orchestrator/buildAnswer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAnswer.d.ts","names":[],"sources":["../../src/orchestrator/buildAnswer.ts"],"sourcesContent":[],"mappings":";KAMK,YAAA;AAAA,UAEY,iBAAA,CAFA;EAEA,MAAA,EAAA,MAAA;EAkBA,YAAA,EAAA,MAAgB;EAqBX,YAAA,EApCN,YAoC2B;EAClC,QAAA,EAAA;IACE,OAAA,EAAA,MAAA;IAAR,IAAA,EAAA,MAAA;EAAO,CAAA,EAAA;;;;;;;;;;;;;UAvBO,gBAAA;;;;;kBAKC;;;;;;;;;;QAQV;;;;;;;;;;;;iBAQc,qBAAA,QACb,mBACN,QAAQ"}

package/dist/orchestrator/buildAnswer.js

@@ -73,4 +73,5 @@ async function buildPolicySafeAnswer(input) {
 }
 
 //#endregion
-export { buildPolicySafeAnswer };
+export { buildPolicySafeAnswer };
+//# sourceMappingURL=buildAnswer.js.map

package/dist/orchestrator/buildAnswer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAnswer.js","names":["draft: AssistantAnswerIR"],"sources":["../../src/orchestrator/buildAnswer.ts"],"sourcesContent":["import {\n  enforceAllowedScope,\n  enforceCitations,\n  validateEnvelope,\n} from '@lssm/example.locale-jurisdiction-gate/policy/guard';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\n\nexport interface AssistantAnswerIR {\n  locale: string;\n  jurisdiction: string;\n  allowedScope: AllowedScope;\n  sections: { heading: string; body: string }[];\n  citations: {\n    kbSnapshotId: string;\n    sourceType: string;\n    sourceId: string;\n    title?: string;\n    excerpt?: string;\n  }[];\n  disclaimers?: string[];\n  riskFlags?: string[];\n  refused?: boolean;\n  refusalReason?: string;\n}\n\nexport interface BuildAnswerInput {\n  envelope: {\n    traceId: string;\n    locale: string;\n    kbSnapshotId: string;\n    allowedScope: AllowedScope;\n    regulatoryContext: { jurisdiction: string };\n  };\n  question: string;\n  kbSearch: (input: {\n    snapshotId: string;\n    jurisdiction: string;\n    query: string;\n  }) => Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }>;\n}\n\n/**\n * Build a policy-safe assistant answer derived from KB search results.\n *\n * Deterministic: no LLM calls; if search yields no results, it refuses.\n */\nexport async function buildPolicySafeAnswer(\n  input: BuildAnswerInput\n): Promise<AssistantAnswerIR> {\n  const env = validateEnvelope(input.envelope);\n  if (!env.ok) {\n    return {\n      locale: input.envelope.locale ?? 'en-GB',\n      jurisdiction: input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n      allowedScope: input.envelope.allowedScope ?? 'education_only',\n      sections: [{ heading: 'Request blocked', body: env.error.message }],\n      citations: [],\n      disclaimers: ['This system refuses to answer without a valid envelope.'],\n      riskFlags: [env.error.code],\n      refused: true,\n      refusalReason: env.error.code,\n    };\n  }\n\n  const results = await input.kbSearch({\n    snapshotId: env.value.kbSnapshotId,\n    jurisdiction: env.value.regulatoryContext!.jurisdiction!,\n    query: input.question,\n  });\n\n  const citations = results.items.map((item) => ({\n    kbSnapshotId: env.value.kbSnapshotId,\n    sourceType: 'ruleVersion',\n    sourceId: item.ruleVersionId,\n    title: 'Curated rule version',\n    excerpt: item.excerpt,\n  }));\n\n  const draft: AssistantAnswerIR = {\n    locale: env.value.locale,\n    jurisdiction: env.value.regulatoryContext!.jurisdiction!,\n    allowedScope: env.value.allowedScope,\n    sections: [\n      {\n        heading: 'Answer (KB-derived)',\n        body:\n          results.items.length > 0\n            ? `This answer is derived from ${results.items.length} curated rule version(s) in the referenced snapshot.`\n            : 'No curated knowledge found in the referenced snapshot.',\n      },\n    ],\n    citations,\n    disclaimers: ['Educational demo only.'],\n    riskFlags: [],\n  };\n\n  const scope = enforceAllowedScope(env.value.allowedScope, draft);\n  if (!scope.ok) {\n    return {\n      ...draft,\n      sections: [{ heading: 'Escalation required', body: scope.error.message }],\n      refused: true,\n      refusalReason: scope.error.code,\n      riskFlags: [...(draft.riskFlags ?? []), scope.error.code],\n    };\n  }\n\n  const cited = enforceCitations(draft);\n  if (!cited.ok) {\n    return {\n      ...draft,\n      sections: [{ heading: 'Request blocked', body: cited.error.message }],\n      citations: [],\n      refused: true,\n      refusalReason: cited.error.code,\n      riskFlags: [...(draft.riskFlags ?? []), cited.error.code],\n    };\n  }\n\n  return draft;\n}\n"],"mappings":";;;;;;;;AA+CA,eAAsB,sBACpB,OAC4B;CAC5B,MAAM,MAAM,iBAAiB,MAAM,SAAS;AAC5C,KAAI,CAAC,IAAI,GACP,QAAO;EACL,QAAQ,MAAM,SAAS,UAAU;EACjC,cAAc,MAAM,SAAS,mBAAmB,gBAAgB;EAChE,cAAc,MAAM,SAAS,gBAAgB;EAC7C,UAAU,CAAC;GAAE,SAAS;GAAmB,MAAM,IAAI,MAAM;GAAS,CAAC;EACnE,WAAW,EAAE;EACb,aAAa,CAAC,0DAA0D;EACxE,WAAW,CAAC,IAAI,MAAM,KAAK;EAC3B,SAAS;EACT,eAAe,IAAI,MAAM;EAC1B;CAGH,MAAM,UAAU,MAAM,MAAM,SAAS;EACnC,YAAY,IAAI,MAAM;EACtB,cAAc,IAAI,MAAM,kBAAmB;EAC3C,OAAO,MAAM;EACd,CAAC;CAEF,MAAM,YAAY,QAAQ,MAAM,KAAK,UAAU;EAC7C,cAAc,IAAI,MAAM;EACxB,YAAY;EACZ,UAAU,KAAK;EACf,OAAO;EACP,SAAS,KAAK;EACf,EAAE;CAEH,MAAMA,QAA2B;EAC/B,QAAQ,IAAI,MAAM;EAClB,cAAc,IAAI,MAAM,kBAAmB;EAC3C,cAAc,IAAI,MAAM;EACxB,UAAU,CACR;GACE,SAAS;GACT,MACE,QAAQ,MAAM,SAAS,IACnB,+BAA+B,QAAQ,MAAM,OAAO,wDACpD;GACP,CACF;EACD;EACA,aAAa,CAAC,yBAAyB;EACvC,WAAW,EAAE;EACd;CAED,MAAM,QAAQ,oBAAoB,IAAI,MAAM,cAAc,MAAM;AAChE,KAAI,CAAC,MAAM,GACT,QAAO;EACL,GAAG;EACH,UAAU,CAAC;GAAE,SAAS;GAAuB,MAAM,MAAM,MAAM;GAAS,CAAC;EACzE,SAAS;EACT,eAAe,MAAM,MAAM;EAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;EAC1D;CAGH,MAAM,QAAQ,iBAAiB,MAAM;AACrC,KAAI,CAAC,MAAM,GACT,QAAO;EACL,GAAG;EACH,UAAU,CAAC;GAAE,SAAS;GAAmB,MAAM,MAAM,MAAM;GAAS,CAAC;EACrE,WAAW,EAAE;EACb,SAAS;EACT,eAAe,MAAM,MAAM;EAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;EAC1D;AAGH,QAAO"}

package/dist/seed/fixtures.d.ts

@@ -31,4 +31,5 @@ declare const DEMO_FIXTURES: {
   };
 };
 //#endregion
-export { DEMO_FIXTURES };
+export { DEMO_FIXTURES };
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/seed/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","names":[],"sources":["../../src/seed/fixtures.ts"],"sourcesContent":[],"mappings":";cAAa;EAAA,SAAA,aA8BH,EAAA,SAAA,CAAA,IAAA,EAAA,IAAA,CAAA;;;;;;;;;0BAAA;;;;;;;;0BAAA"}

package/dist/seed/fixtures.js

@@ -30,4 +30,5 @@ const DEMO_FIXTURES = {
 };
 
 //#endregion
-export { DEMO_FIXTURES };
+export { DEMO_FIXTURES };
+//# sourceMappingURL=fixtures.js.map

package/dist/seed/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","names":[],"sources":["../../src/seed/fixtures.ts"],"sourcesContent":["export const DEMO_FIXTURES = {\n  jurisdictions: ['EU', 'FR'] as const,\n  locales: ['en-GB', 'fr-FR'] as const,\n  demoOrgId: 'org_demo',\n  demoUserId: 'user_demo',\n  sources: {\n    EU_SOURCE_1: {\n      jurisdiction: 'EU',\n      authority: 'DemoAuthority',\n      title: 'EU Demo Source v1',\n      fetchedAt: new Date('2026-01-01T00:00:00.000Z'),\n      hash: 'hash_eu_v1',\n      fileId: 'file_eu_v1',\n    },\n    EU_SOURCE_2: {\n      jurisdiction: 'EU',\n      authority: 'DemoAuthority',\n      title: 'EU Demo Source v2',\n      fetchedAt: new Date('2026-02-01T00:00:00.000Z'),\n      hash: 'hash_eu_v2',\n      fileId: 'file_eu_v2',\n    },\n  },\n  rules: {\n    EU_RULE_TAX: {\n      id: 'rule_eu_tax',\n      jurisdiction: 'EU',\n      topicKey: 'tax_reporting',\n    },\n  },\n} as const;\n"],"mappings":";AAAA,MAAa,gBAAgB;CAC3B,eAAe,CAAC,MAAM,KAAK;CAC3B,SAAS,CAAC,SAAS,QAAQ;CAC3B,WAAW;CACX,YAAY;CACZ,SAAS;EACP,aAAa;GACX,cAAc;GACd,WAAW;GACX,OAAO;GACP,2BAAW,IAAI,KAAK,2BAA2B;GAC/C,MAAM;GACN,QAAQ;GACT;EACD,aAAa;GACX,cAAc;GACd,WAAW;GACX,OAAO;GACP,2BAAW,IAAI,KAAK,2BAA2B;GAC/C,MAAM;GACN,QAAQ;GACT;EACF;CACD,OAAO,EACL,aAAa;EACX,IAAI;EACJ,cAAc;EACd,UAAU;EACX,EACF;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.policy-safe-knowledge-assistant",
-  "version": "0.0.0-canary-20251217083314",
+  "version": "0.0.0-canary-20251220002821",
   "description": "All-in-one template example: policy-safe knowledge assistant with locale/jurisdiction gating, versioned KB snapshots, HITL update pipeline, and learning hub.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,25 +31,25 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/example.locale-jurisdiction-gate": "0.0.0-canary-20251217083314",
-    "@lssm/example.versioned-knowledge-base": "0.0.0-canary-20251217083314",
-    "@lssm/example.kb-update-pipeline": "0.0.0-canary-20251217083314",
-    "@lssm/example.learning-patterns": "0.0.0-canary-20251217083314",
-    "@lssm/lib.schema": "0.0.0-canary-20251217083314",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217083314",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217083314",
-    "@lssm/lib.jobs": "0.0.0-canary-20251217083314",
-    "@lssm/lib.feature-flags": "0.0.0-canary-20251217083314",
-    "@lssm/lib.files": "0.0.0-canary-20251217083314",
-    "@lssm/lib.metering": "0.0.0-canary-20251217083314",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251217083314",
-    "@lssm/module.notifications": "0.0.0-canary-20251217083314",
-    "@lssm/module.learning-journey": "0.0.0-canary-20251217083314"
+    "@lssm/example.locale-jurisdiction-gate": "0.0.0-canary-20251220002821",
+    "@lssm/example.versioned-knowledge-base": "0.0.0-canary-20251220002821",
+    "@lssm/example.kb-update-pipeline": "0.0.0-canary-20251220002821",
+    "@lssm/example.learning-patterns": "0.0.0-canary-20251220002821",
+    "@lssm/lib.schema": "0.0.0-canary-20251220002821",
+    "@lssm/lib.contracts": "0.0.0-canary-20251220002821",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251220002821",
+    "@lssm/lib.jobs": "0.0.0-canary-20251220002821",
+    "@lssm/lib.feature-flags": "0.0.0-canary-20251220002821",
+    "@lssm/lib.files": "0.0.0-canary-20251220002821",
+    "@lssm/lib.metering": "0.0.0-canary-20251220002821",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251220002821",
+    "@lssm/module.notifications": "0.0.0-canary-20251220002821",
+    "@lssm/module.learning-journey": "0.0.0-canary-20251220002821"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217083314",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217083314",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251220002821",
+    "@lssm/tool.typescript": "0.0.0-canary-20251220002821",
+    "tsdown": "^0.18.1",
     "typescript": "^5.9.3"
   },
   "publishConfig": {
@@ -64,6 +64,13 @@
       "./seed": "./dist/seed/index.js",
       "./seed/fixtures": "./dist/seed/fixtures.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/policy-safe-knowledge-assistant"
   }
 }