@contractspec/example.learning-journey-ambient-coach 1.44.0

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,25 @@
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-ambient-coach/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/track.ts, src/docs/ambient-coach.docblock.ts, src/docs/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 16 files
+ℹ dist/track.js                            1.63 kB │ gzip: 0.72 kB
+ℹ dist/docs/ambient-coach.docblock.js      1.27 kB │ gzip: 0.71 kB
+ℹ dist/example.js                          0.80 kB │ gzip: 0.45 kB
+ℹ dist/index.js                            0.28 kB │ gzip: 0.14 kB
+ℹ dist/docs/index.js                       0.04 kB │ gzip: 0.06 kB
+ℹ dist/track.js.map                        2.83 kB │ gzip: 1.07 kB
+ℹ dist/docs/ambient-coach.docblock.js.map  1.68 kB │ gzip: 0.88 kB
+ℹ dist/example.js.map                      1.15 kB │ gzip: 0.61 kB
+ℹ dist/track.d.ts.map                      0.18 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                    0.14 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts                        1.03 kB │ gzip: 0.44 kB
+ℹ dist/track.d.ts                          0.44 kB │ gzip: 0.21 kB
+ℹ dist/index.d.ts                          0.23 kB │ gzip: 0.12 kB
+ℹ dist/docs/ambient-coach.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/index.d.ts                     0.01 kB │ gzip: 0.03 kB
+ℹ 15 files, total: 11.71 kB
+✔ Build complete in 13266ms

package/.turbo/turbo-build.log

@@ -0,0 +1,26 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-ambient-coach/tsdown.config.js 
+ℹ entry: src/example.ts, src/index.ts, src/track.ts, src/docs/ambient-coach.docblock.ts, src/docs/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/track.js                            1.63 kB │ gzip: 0.72 kB
+ℹ dist/docs/ambient-coach.docblock.js      1.27 kB │ gzip: 0.71 kB
+ℹ dist/example.js                          0.80 kB │ gzip: 0.45 kB
+ℹ dist/index.js                            0.28 kB │ gzip: 0.14 kB
+ℹ dist/docs/index.js                       0.04 kB │ gzip: 0.06 kB
+ℹ dist/track.js.map                        2.83 kB │ gzip: 1.07 kB
+ℹ dist/docs/ambient-coach.docblock.js.map  1.68 kB │ gzip: 0.88 kB
+ℹ dist/example.js.map                      1.15 kB │ gzip: 0.61 kB
+ℹ dist/track.d.ts.map                      0.18 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                    0.14 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts                        1.03 kB │ gzip: 0.44 kB
+ℹ dist/track.d.ts                          0.44 kB │ gzip: 0.21 kB
+ℹ dist/index.d.ts                          0.23 kB │ gzip: 0.12 kB
+ℹ dist/docs/ambient-coach.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/index.d.ts                     0.01 kB │ gzip: 0.03 kB
+ℹ 15 files, total: 11.71 kB
+✔ Build complete in 14326ms

package/CHANGELOG.md

@@ -0,0 +1,178 @@
+# @contractspec/example.learning-journey-ambient-coach
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/module.learning-journey@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/module.learning-journey@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/module.learning-journey@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/module.learning-journey@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/module.learning-journey@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/module.learning-journey@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/module.learning-journey@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/module.learning-journey@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/module.learning-journey@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/module.learning-journey@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/module.learning-journey@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/module.learning-journey@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/module.learning-journey@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/module.learning-journey@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/module.learning-journey@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/module.learning-journey@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/module.learning-journey@1.42.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @contractspec/example.learning-journey-ambient-coach
+
+Website: https://contractspec.io/
+
+
+Ambient coach learning journey example that surfaces contextual tips based on user behavior and marks completion when acknowledged or acted upon.
+
+## What it shows
+
+- Tip/insight model with trigger → show → acknowledge/action events
+- Track steps for money and coliving behaviors
+- Event and count-based completion with optional action follow-ups
+- XP/engagement increments for acting on tips
+
+## How to run
+
+1. `bun test packages/examples/learning-journey-ambient-coach`
+2. Use registry helper `recordEvent` with events like:
+
+```ts
+recordEvent({
+  name: 'coach.tip.triggered',
+  learnerId: 'u1',
+  payload: { tipId: 'cash_buffer_too_high' },
+});
+recordEvent({
+  name: 'coach.tip.follow_up_action_taken',
+  learnerId: 'u1',
+  payload: { tipId: 'cash_buffer_too_high' },
+});
+```
+
+## Adapting
+
+- Swap categories for your domain (money, coliving, product adoption).
+- Adjust trigger payload filters to align with analytics events.
+- Add more steps or split tracks per persona/segment.

package/dist/docs/ambient-coach.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/ambient-coach.docblock.js

@@ -0,0 +1,34 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/ambient-coach.docblock.ts
+registerDocBlocks([{
+	id: "docs.learning-journey.ambient-coach",
+	title: "Learning Journey — Ambient Coach",
+	summary: "Context-aware coaching pattern that triggers tips, shows them, and marks completion when users act or acknowledge.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/learning-journey/ambient-coach",
+	tags: [
+		"learning",
+		"coach",
+		"tips"
+	],
+	body: `## Tracks
+- \`money_ambient_coach\`: cash buffer too high, no savings goal, irregular savings
+- \`coliving_ambient_coach\`: noise late evening, guest frequency high, shared space conflicts
+
+## Steps & Events
+- Trigger tip: \`coach.tip.triggered\` (payload includes \`tipId\`)
+- Show tip (optional UI emission): \`coach.tip.shown\`
+- Complete when acknowledged or follow-up action taken:
+  - \`coach.tip.acknowledged\`
+  - \`coach.tip.follow_up_action_taken\`
+
+## Usage
+- Tracks export from \`@contractspec/example.learning-journey-ambient-coach/track\`.
+- Registry progression is event-driven; payload filters can scope tips per category.
+- XP/engagement can be awarded on completion of each tip step.`
+}]);
+
+//#endregion
+//# sourceMappingURL=ambient-coach.docblock.js.map

package/dist/docs/ambient-coach.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-coach.docblock.js","names":[],"sources":["../../src/docs/ambient-coach.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst ambientCoachDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.learning-journey.ambient-coach',\n    title: 'Learning Journey — Ambient Coach',\n    summary:\n      'Context-aware coaching pattern that triggers tips, shows them, and marks completion when users act or acknowledge.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/learning-journey/ambient-coach',\n    tags: ['learning', 'coach', 'tips'],\n    body: `## Tracks\n- \\`money_ambient_coach\\`: cash buffer too high, no savings goal, irregular savings\n- \\`coliving_ambient_coach\\`: noise late evening, guest frequency high, shared space conflicts\n\n## Steps & Events\n- Trigger tip: \\`coach.tip.triggered\\` (payload includes \\`tipId\\`)\n- Show tip (optional UI emission): \\`coach.tip.shown\\`\n- Complete when acknowledged or follow-up action taken:\n  - \\`coach.tip.acknowledged\\`\n  - \\`coach.tip.follow_up_action_taken\\`\n\n## Usage\n- Tracks export from \\`@contractspec/example.learning-journey-ambient-coach/track\\`.\n- Registry progression is event-driven; payload filters can scope tips per category.\n- XP/engagement can be awarded on completion of each tip step.`,\n  },\n];\n\nregisterDocBlocks(ambientCoachDocBlocks);\n"],"mappings":";;;AA+BA,kBA5B0C,CACxC;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAS;EAAO;CACnC,MAAM;;;;;;;;;;;;;;;CAeP,CACF,CAEuC"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./ambient-coach.docblock.js";

package/dist/example.d.ts

@@ -0,0 +1,33 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "learning-journey-ambient-coach";
+  readonly title: "Learning Journey — Ambient Coach";
+  readonly summary: "Ambient coaching pattern: lightweight nudges driven by context and recent progress.";
+  readonly tags: readonly ["learning", "coaching", "ambient"];
+  readonly kind: "template";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.learning-journey.ambient-coach";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.learning-journey-ambient-coach";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["playground", "markdown"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAqBI,EAAA,gCAAA"}

package/dist/example.js

@@ -0,0 +1,35 @@
+//#region src/example.ts
+const example = {
+	id: "learning-journey-ambient-coach",
+	title: "Learning Journey — Ambient Coach",
+	summary: "Ambient coaching pattern: lightweight nudges driven by context and recent progress.",
+	tags: [
+		"learning",
+		"coaching",
+		"ambient"
+	],
+	kind: "template",
+	visibility: "public",
+	docs: { rootDocId: "docs.learning-journey.ambient-coach" },
+	entrypoints: {
+		packageName: "@contractspec/example.learning-journey-ambient-coach",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["playground", "markdown"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'learning-journey-ambient-coach',\n  title: 'Learning Journey — Ambient Coach',\n  summary:\n    'Ambient coaching pattern: lightweight nudges driven by context and recent progress.',\n  tags: ['learning', 'coaching', 'ambient'],\n  kind: 'template',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.learning-journey.ambient-coach',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.learning-journey-ambient-coach',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['playground', 'markdown'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAY;EAAY;EAAU;CACzC,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,WAAW,uCACZ;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,cAAc,WAAW;GAAE;EAC7D,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import example from "./example.js";
+import { ambientCoachTracks, colivingAmbientCoachTrack, moneyAmbientCoachTrack } from "./track.js";
+export { ambientCoachTracks, colivingAmbientCoachTrack, example, moneyAmbientCoachTrack };

package/dist/index.js

@@ -0,0 +1,5 @@
+import example_default from "./example.js";
+import { ambientCoachTracks, colivingAmbientCoachTrack, moneyAmbientCoachTrack } from "./track.js";
+import "./docs/index.js";
+
+export { ambientCoachTracks, colivingAmbientCoachTrack, example_default as example, moneyAmbientCoachTrack };

package/dist/track.d.ts

@@ -0,0 +1,9 @@
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/track.d.ts
+declare const moneyAmbientCoachTrack: LearningJourneyTrackSpec;
+declare const colivingAmbientCoachTrack: LearningJourneyTrackSpec;
+declare const ambientCoachTracks: LearningJourneyTrackSpec[];
+//#endregion
+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.js

@@ -0,0 +1,42 @@
+//#region src/track.ts
+const makeTipStep = (id, tipId, description) => ({
+	id,
+	title: `Resolve tip: ${tipId}`,
+	description,
+	completion: {
+		kind: "event",
+		eventName: "coach.tip.follow_up_action_taken",
+		payloadFilter: { tipId }
+	},
+	xpReward: 20,
+	metadata: { tipId }
+});
+const moneyAmbientCoachTrack = {
+	id: "money_ambient_coach",
+	name: "Ambient Coach — Money",
+	description: "Subtle coaching for money patterns (cash buffer, goals, saving rhythm).",
+	targetUserSegment: "money_user",
+	totalXp: 60,
+	steps: [
+		makeTipStep("cash_buffer_too_high", "cash_buffer_too_high", "Suggest sweeping excess cash into goals."),
+		makeTipStep("no_savings_goal", "no_savings_goal", "Prompt setting a first savings goal."),
+		makeTipStep("irregular_savings", "irregular_savings", "Recommend recurring saves after irregular deposits.")
+	]
+};
+const colivingAmbientCoachTrack = {
+	id: "coliving_ambient_coach",
+	name: "Ambient Coach — Coliving",
+	description: "Contextual tips for healthy coliving habits.",
+	targetUserSegment: "coliving",
+	totalXp: 60,
+	steps: [
+		makeTipStep("noise_late_evening", "noise_late_evening", "Suggest updating quiet hours to reduce evening noise."),
+		makeTipStep("guest_frequency_high", "guest_frequency_high", "Set guest frequency expectations for the house."),
+		makeTipStep("shared_space_conflicts", "shared_space_conflicts", "Offer a shared-space checklist to reduce conflicts.")
+	]
+};
+const ambientCoachTracks = [moneyAmbientCoachTrack, colivingAmbientCoachTrack];
+
+//#endregion
+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 '@contractspec/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/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@contractspec/example.learning-journey-ambient-coach",
+  "version": "1.44.0",
+  "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": {
+    ".": "./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": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/module.learning-journey": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./example": "./dist/example.js",
+      "./track": "./dist/track.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/ambient-coach.docblock": "./dist/docs/ambient-coach.docblock.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/learning-journey-ambient-coach"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/ambient-coach.docblock.ts

@@ -0,0 +1,32 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const ambientCoachDocBlocks: DocBlock[] = [
+  {
+    id: 'docs.learning-journey.ambient-coach',
+    title: 'Learning Journey — Ambient Coach',
+    summary:
+      'Context-aware coaching pattern that triggers tips, shows them, and marks completion when users act or acknowledge.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/learning-journey/ambient-coach',
+    tags: ['learning', 'coach', 'tips'],
+    body: `## Tracks
+- \`money_ambient_coach\`: cash buffer too high, no savings goal, irregular savings
+- \`coliving_ambient_coach\`: noise late evening, guest frequency high, shared space conflicts
+
+## Steps & Events
+- Trigger tip: \`coach.tip.triggered\` (payload includes \`tipId\`)
+- Show tip (optional UI emission): \`coach.tip.shown\`
+- Complete when acknowledged or follow-up action taken:
+  - \`coach.tip.acknowledged\`
+  - \`coach.tip.follow_up_action_taken\`
+
+## Usage
+- Tracks export from \`@contractspec/example.learning-journey-ambient-coach/track\`.
+- Registry progression is event-driven; payload filters can scope tips per category.
+- XP/engagement can be awarded on completion of each tip step.`,
+  },
+];
+
+registerDocBlocks(ambientCoachDocBlocks);

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './ambient-coach.docblock';

package/src/example.ts

@@ -0,0 +1,24 @@
+const example = {
+  id: 'learning-journey-ambient-coach',
+  title: 'Learning Journey — Ambient Coach',
+  summary:
+    'Ambient coaching pattern: lightweight nudges driven by context and recent progress.',
+  tags: ['learning', 'coaching', 'ambient'],
+  kind: 'template',
+  visibility: 'public',
+  docs: {
+    rootDocId: 'docs.learning-journey.ambient-coach',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.learning-journey-ambient-coach',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['playground', 'markdown'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './track';
+export { default as example } from './example';
+import './docs';