@lssm/example.learning-journey-ambient-coach 0.0.0-canary-20251217080011 → 0.0.0-canary-20251219202229

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

@@ -0,0 +1,97 @@
+import { registerDocBlocks } from "./registry.js";
+
+//#region ../../libs/contracts/dist/docs/tech-contracts.docs.js
+const techContractsDocs = [{
+	id: "docs.tech.contracts.presentations-v2",
+	title: "Presentations V2 — Unified Descriptor & Transform Engine",
+	summary: "How PresentationDescriptorV2 and TransformEngine keep docs/renderers consistent.",
+	visibility: "public",
+	route: "/docs/tech/contracts/presentations-v2",
+	kind: "reference",
+	tags: [
+		"presentations",
+		"docs",
+		"mcp"
+	],
+	body: `## Presentations V2 — Unified Descriptor & Transform Engine
+
+### Purpose
+
+Unify 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.
+
+### Types
+
+\`\`\`ts
+type PresentationTarget =
+  | 'react'
+  | 'markdown'
+  | 'application/json'
+  | 'application/xml';
+
+type PresentationSource =
+  | {
+      type: 'component';
+      framework: 'react';
+      componentKey: string;
+      props?: AnySchemaModel;
+    }
+  | { type: 'blocknotejs'; docJson: unknown; blockConfig?: unknown };
+
+interface PresentationDescriptorV2 {
+  meta: PresentationV2Meta; // includes partial OwnerShipMeta + description
+  policy?: { flags?: string[]; pii?: string[] };
+  source: PresentationSource;
+  targets: PresentationTarget[];
+}
+
+// Shared ownership schema (source of truth in @lssm/lib.contracts/src/ownership.ts)
+interface OwnerShipMeta {
+  title: string;
+  description: string;
+  domain: string;
+  owners: Owner[];
+  tags: Tag[];
+  stability: Stability;
+}
+
+type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+type Owner = string; // curated list available in code (e.g., '@sigil-team', 'team-strit')
+type Tag = string; // curated list available in code (e.g., 'auth', 'spots')
+
+// For V2 presentations, meta is a Partial<OwnerShipMeta> plus description, name, version
+interface PresentationV2Meta extends Partial<OwnerShipMeta> {
+  name: string;
+  version: number;
+  description?: string;
+}
+\`\`\`
+
+### Engine
+
+Use \`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\`).
+
+PII paths (JSON-like) are redacted from rendered outputs.
+
+### MCP Integration
+
+\`createMcpServer\` accepts \`presentationsV2\`. Each descriptor is exposed under \`presentation://<name>/v<version>\` and negotiated variants (\`.md/.json/.xml\`) are rendered by the engine.
+
+### Migration
+
+- V1 \`PresentationSpec\` remains supported; a back-compat helper converts V1 → V2 when convenient.
+- Prefer V2 for new work.
+
+### Examples (Sigil)
+
+- \`sigil.auth.webauth_tabs_v2\`: component source (\`componentKey: 'sigil.webauth.tabs'\`), targets \`react/json/xml\`.
+- \`sigil.signup.guide_v2\`: BlockNote doc source, targets \`react/markdown/json/xml\`.
+
+### React Rendering
+
+Host apps use a \`componentMap\` (e.g., \`'sigil.webauth.tabs' → WebAuthTabs\`) and a BlockNote renderer to turn the React render descriptor into elements.`
+}];
+registerDocBlocks(techContractsDocs);
+
+//#endregion
+export { techContractsDocs };
+//# sourceMappingURL=tech-contracts.docs.js.map

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 };\n//# sourceMappingURL=tech-contracts.docs.js.map"],"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/{track-CUfQ_9U0.d.mts → track.d.ts}

@@ -5,4 +5,5 @@ declare const moneyAmbientCoachTrack: LearningJourneyTrackSpec;
 declare const colivingAmbientCoachTrack: LearningJourneyTrackSpec;
 declare const ambientCoachTracks: LearningJourneyTrackSpec[];
 //#endregion
-export { colivingAmbientCoachTrack as n, moneyAmbientCoachTrack as r, ambientCoachTracks as t };
+export { ambientCoachTracks, colivingAmbientCoachTrack, moneyAmbientCoachTrack };
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","names":[],"sources":["../src/track.ts"],"sourcesContent":[],"mappings":";;;cAmBa,wBAAwB;cA0BxB,2BAA2B;AA1B3B,cAmDA,kBA3BZ,EA2BgC,wBA3BhC,EAAA"}

package/dist/{track-DXPNrORQ.mjs → track.js}

@@ -38,4 +38,5 @@ const colivingAmbientCoachTrack = {
 const ambientCoachTracks = [moneyAmbientCoachTrack, colivingAmbientCoachTrack];
 
 //#endregion
-export { colivingAmbientCoachTrack as n, moneyAmbientCoachTrack as r, ambientCoachTracks as t };
+export { ambientCoachTracks, colivingAmbientCoachTrack, moneyAmbientCoachTrack };
+//# sourceMappingURL=track.js.map

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":["moneyAmbientCoachTrack: LearningJourneyTrackSpec","colivingAmbientCoachTrack: LearningJourneyTrackSpec","ambientCoachTracks: LearningJourneyTrackSpec[]"],"sources":["../src/track.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@lssm/module.learning-journey/track-spec';\n\nconst makeTipStep = (\n  id: string,\n  tipId: string,\n  description: string\n): LearningJourneyTrackSpec['steps'][number] => ({\n  id,\n  title: `Resolve tip: ${tipId}`,\n  description,\n  completion: {\n    kind: 'event',\n    eventName: 'coach.tip.follow_up_action_taken',\n    payloadFilter: { tipId },\n  },\n  xpReward: 20,\n  metadata: { tipId },\n});\n\nexport const moneyAmbientCoachTrack: LearningJourneyTrackSpec = {\n  id: 'money_ambient_coach',\n  name: 'Ambient Coach — Money',\n  description:\n    'Subtle coaching for money patterns (cash buffer, goals, saving rhythm).',\n  targetUserSegment: 'money_user',\n  totalXp: 60,\n  steps: [\n    makeTipStep(\n      'cash_buffer_too_high',\n      'cash_buffer_too_high',\n      'Suggest sweeping excess cash into goals.'\n    ),\n    makeTipStep(\n      'no_savings_goal',\n      'no_savings_goal',\n      'Prompt setting a first savings goal.'\n    ),\n    makeTipStep(\n      'irregular_savings',\n      'irregular_savings',\n      'Recommend recurring saves after irregular deposits.'\n    ),\n  ],\n};\n\nexport const colivingAmbientCoachTrack: LearningJourneyTrackSpec = {\n  id: 'coliving_ambient_coach',\n  name: 'Ambient Coach — Coliving',\n  description: 'Contextual tips for healthy coliving habits.',\n  targetUserSegment: 'coliving',\n  totalXp: 60,\n  steps: [\n    makeTipStep(\n      'noise_late_evening',\n      'noise_late_evening',\n      'Suggest updating quiet hours to reduce evening noise.'\n    ),\n    makeTipStep(\n      'guest_frequency_high',\n      'guest_frequency_high',\n      'Set guest frequency expectations for the house.'\n    ),\n    makeTipStep(\n      'shared_space_conflicts',\n      'shared_space_conflicts',\n      'Offer a shared-space checklist to reduce conflicts.'\n    ),\n  ],\n};\n\nexport const ambientCoachTracks: LearningJourneyTrackSpec[] = [\n  moneyAmbientCoachTrack,\n  colivingAmbientCoachTrack,\n];\n"],"mappings":";AAEA,MAAM,eACJ,IACA,OACA,iBAC+C;CAC/C;CACA,OAAO,gBAAgB;CACvB;CACA,YAAY;EACV,MAAM;EACN,WAAW;EACX,eAAe,EAAE,OAAO;EACzB;CACD,UAAU;CACV,UAAU,EAAE,OAAO;CACpB;AAED,MAAaA,yBAAmD;CAC9D,IAAI;CACJ,MAAM;CACN,aACE;CACF,mBAAmB;CACnB,SAAS;CACT,OAAO;EACL,YACE,wBACA,wBACA,2CACD;EACD,YACE,mBACA,mBACA,uCACD;EACD,YACE,qBACA,qBACA,sDACD;EACF;CACF;AAED,MAAaC,4BAAsD;CACjE,IAAI;CACJ,MAAM;CACN,aAAa;CACb,mBAAmB;CACnB,SAAS;CACT,OAAO;EACL,YACE,sBACA,sBACA,wDACD;EACD,YACE,wBACA,wBACA,kDACD;EACD,YACE,0BACA,0BACA,sDACD;EACF;CACF;AAED,MAAaC,qBAAiD,CAC5D,wBACA,0BACD"}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@lssm/example.learning-journey-ambient-coach",
-  "version": "0.0.0-canary-20251217080011",
+  "version": "0.0.0-canary-20251219202229",
   "description": "Ambient coach learning journey example with contextual tips and follow-up actions.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./example": "./src/example.ts",
-    "./track": "./src/track.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/ambient-coach.docblock": "./src/docs/ambient-coach.docblock.ts",
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/ambient-coach.docblock": "./dist/docs/ambient-coach.docblock.js",
+    "./example": "./dist/example.js",
+    "./track": "./dist/track.js",
     "./*": "./*"
   },
   "scripts": {
@@ -27,14 +27,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/module.learning-journey": "0.0.0-canary-20251217080011",
-    "@lssm/lib.schema": "0.0.0-canary-20251217080011",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217080011"
+    "@lssm/module.learning-journey": "0.0.0-canary-20251219202229",
+    "@lssm/lib.schema": "0.0.0-canary-20251219202229",
+    "@lssm/lib.contracts": "0.0.0-canary-20251219202229"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217080011",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217080011",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251219202229",
+    "@lssm/tool.typescript": "0.0.0-canary-20251219202229",
+    "tsdown": "^0.18.1",
     "typescript": "^5.9.3"
   },
   "module": "./dist/index.js",
@@ -47,5 +47,6 @@
       "./docs/ambient-coach.docblock": "./dist/docs/ambient-coach.docblock.js",
       "./*": "./*"
     }
-  }
+  },
+  "license": "MIT"
 }