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

package/src/track.test.ts

@@ -0,0 +1,57 @@
+import { describe, expect, it } from 'bun:test';
+
+import { moneyAmbientCoachTrack } from './track';
+
+interface TestEvent {
+  name: string;
+  payload?: Record<string, unknown>;
+}
+
+const matchesFilter = (
+  filter: Record<string, unknown> | undefined,
+  payload: Record<string, unknown> | undefined
+) => {
+  if (!filter) return true;
+  if (!payload) return false;
+  return Object.entries(filter).every(([key, value]) => payload[key] === value);
+};
+
+describe('ambient coach track', () => {
+  it('completes steps when tips are acted upon', () => {
+    const tipIds = [
+      'cash_buffer_too_high',
+      'no_savings_goal',
+      'irregular_savings',
+    ];
+
+    const events: TestEvent[] = tipIds.flatMap((tipId) => [
+      { name: 'coach.tip.triggered', payload: { tipId } },
+      { name: 'coach.tip.follow_up_action_taken', payload: { tipId } },
+    ]);
+
+    const progress = moneyAmbientCoachTrack.steps.map((step) => ({
+      id: step.id,
+      status: 'PENDING' as 'PENDING' | 'COMPLETED',
+    }));
+
+    events.forEach((event) => {
+      moneyAmbientCoachTrack.steps.forEach((stepSpec, index) => {
+        const step = progress[index];
+        if (!step || step.status === 'COMPLETED') return;
+        if (stepSpec.completion.kind !== 'event') return;
+        if (stepSpec.completion.eventName !== event.name) return;
+        if (
+          !matchesFilter(
+            stepSpec.completion.payloadFilter,
+            event.payload as Record<string, unknown> | undefined
+          )
+        ) {
+          return;
+        }
+        step.status = 'COMPLETED';
+      });
+    });
+
+    expect(progress.every((s) => s.status === 'COMPLETED')).toBeTrue();
+  });
+});

package/src/track.ts

@@ -0,0 +1,74 @@
+import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+
+const makeTipStep = (
+  id: string,
+  tipId: string,
+  description: string
+): LearningJourneyTrackSpec['steps'][number] => ({
+  id,
+  title: `Resolve tip: ${tipId}`,
+  description,
+  completion: {
+    kind: 'event',
+    eventName: 'coach.tip.follow_up_action_taken',
+    payloadFilter: { tipId },
+  },
+  xpReward: 20,
+  metadata: { tipId },
+});
+
+export const moneyAmbientCoachTrack: LearningJourneyTrackSpec = {
+  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.'
+    ),
+  ],
+};
+
+export const colivingAmbientCoachTrack: LearningJourneyTrackSpec = {
+  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.'
+    ),
+  ],
+};
+
+export const ambientCoachTracks: LearningJourneyTrackSpec[] = [
+  moneyAmbientCoachTrack,
+  colivingAmbientCoachTrack,
+];

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "include": ["src"],
+  "exclude": ["node_modules"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}