@contractspec/example.learning-journey-ui-coaching 3.7.6 → 3.7.10

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=15 noBundle=false
-Bundled 15 modules in 17ms
+Bundled 15 modules in 24ms
 
   ./CoachingMiniApp.js                            44.47 KB  (entry point)
   ./index.js                                      46.87 KB  (entry point)
@@ -22,7 +22,7 @@ Bundled 15 modules in 17ms
   ./example.js                                    0.93 KB   (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=15 noBundle=false
-Bundled 15 modules in 23ms
+Bundled 15 modules in 17ms
 
   ./CoachingMiniApp.js                            44.44 KB  (entry point)
   ./index.js                                      46.83 KB  (entry point)
@@ -41,7 +41,7 @@ Bundled 15 modules in 23ms
   ./example.js                                    0.92 KB   (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=15 noBundle=false
-Bundled 15 modules in 31ms
+Bundled 15 modules in 24ms
 
   ./CoachingMiniApp.js                            44.44 KB  (entry point)
   ./index.js                                      46.83 KB  (entry point)

package/AGENTS.md

@@ -1,34 +1,59 @@
-# AI Agent Guide -- `@contractspec/example.learning-journey-ui-coaching`
+# AI Agent Guide — `@contractspec/example.learning-journey-ui-coaching`
 
 Scope: `packages/examples/learning-journey-ui-coaching/*`
 
-Demonstrates a contextual coaching UI with tip cards, engagement tracking, and multi-view navigation.
+Contextual coaching UI with tip cards and engagement tracking.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `module.learning-journey`, `lib.contracts-spec`, `lib.design-system`, `lib.ui-kit-web`, `example.learning-journey-ui-shared`, `example.learning-journey-ambient-coach`, `example.learning-journey-crm-onboarding`
-
-## What This Demonstrates
-
-- CoachingMiniApp as a self-contained React application
-- TipCard, TipFeed, and EngagementMeter components
-- Multi-view layout (Overview, Progress, Steps, Timeline)
-- Integration with ambient-coach and crm-onboarding tracks
-- Design system and UI kit usage patterns
-
-## Public Exports
-
-- `.` -- root barrel
-- `./CoachingMiniApp` -- main mini-app component
-- `./components` -- TipCard, TipFeed, EngagementMeter
-- `./views` -- Overview, Progress, Steps, Timeline views
-- `./docs` -- DocBlock documentation
-- `./example` -- runnable example entry point
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/example.learning-journey-ambient-coach`, `@contractspec/example.learning-journey-crm-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-web`, ...
+
+## Architecture
+
+- `src/CoachingMiniApp.tsx` is part of the package's public or composition surface.
+- `src/components/` contains reusable UI components and view composition.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-ui-coaching.feature.ts` defines a feature entrypoint.
+- `src/views/` contains view-level composition.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./CoachingMiniApp` resolves through `./src/CoachingMiniApp.tsx`.
+- Export `./components` resolves through `./src/components/index.ts`.
+- Export `./components/EngagementMeter` resolves through `./src/components/EngagementMeter.tsx`.
+- Export `./components/TipCard` resolves through `./src/components/TipCard.tsx`.
+- Export `./components/TipFeed` resolves through `./src/components/TipFeed.tsx`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/learning-journey-ui-coaching.docblock` resolves through `./src/docs/learning-journey-ui-coaching.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-ui-coaching.feature` resolves through `./src/learning-journey-ui-coaching.feature.ts`.
+- The package publishes 15 total export subpaths; keep docs aligned with `package.json`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/example.learning-journey-ambient-coach`, `@contractspec/example.learning-journey-crm-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-web`, ....
+- Changes here can affect downstream packages such as `@contractspec/example.learning-journey-ambient-coach`, `@contractspec/example.learning-journey-crm-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.ui-kit-web`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @contractspec/example.learning-journey-ui-coaching
 
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/example.learning-journey-crm-onboarding@3.7.10
+  - @contractspec/example.learning-journey-ambient-coach@3.7.10
+  - @contractspec/example.learning-journey-ui-shared@3.7.10
+  - @contractspec/module.learning-journey@3.7.10
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.design-system@3.8.3
+  - @contractspec/lib.ui-kit-web@3.9.2
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/example.learning-journey-crm-onboarding@3.7.9
+  - @contractspec/example.learning-journey-ambient-coach@3.7.9
+  - @contractspec/example.learning-journey-ui-shared@3.7.9
+  - @contractspec/module.learning-journey@3.7.9
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.design-system@3.8.2
+  - @contractspec/lib.ui-kit-web@3.9.1
+
 ## 3.7.6
 
 ### Patch Changes
@@ -559,6 +587,7 @@
 - 7f3203a: fix: make workspace test runs resilient when packages have no tests
 
   Updates package test scripts to pass cleanly when no matching test files exist:
+
   - Uses `bun test --pass-with-no-tests` in Bun-based packages that currently ship without test files.
   - Uses `jest --passWithNoTests` for the UI kit web package.
   - Adds `.vscode-test.mjs` for `vscode-contractspec` so VS Code extension test runs have an explicit config and stop failing on missing default configuration.
@@ -1035,14 +1064,17 @@
   feat: Contract layers support (features, examples, app-configs)
 
   ### New CLI Commands
+
   - `contractspec list layers` - List all contract layers with filtering
 
   ### Enhanced Commands
+
   - `contractspec ci` - New `layers` check category validates features/examples/config
   - `contractspec doctor` - New `layers` health checks
   - `contractspec integrity` - Now shows layer statistics
 
   ### New APIs
+
   - `discoverLayers()` - Scan workspace for all layer files
   - `scanExampleSource()` - Parse ExampleSpec from source code
   - `isExampleFile()` - Check if file is an example spec

package/README.md

@@ -1,32 +1,75 @@
 # @contractspec/example.learning-journey-ui-coaching
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Contextual coaching UI with tip cards and engagement tracking.**
 
-Contextual coaching UI with tip cards and engagement tracking.
+## What This Demonstrates
 
-## Features
+- CoachingMiniApp as a self-contained React application.
+- TipCard, TipFeed, and EngagementMeter components.
+- Multi-view layout (Overview, Progress, Steps, Timeline).
+- Integration with ambient-coach and crm-onboarding tracks.
+- Design system and UI kit usage patterns.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-- **Overview**: Active tips carousel with quick stats
-- **Steps**: Stacked tip cards with action/dismiss buttons
-- **Progress**: Engagement donut chart, streak counter, XP bar
-- **Timeline**: Reverse-chronological feed of tip activity
+## Running Locally
+
+From `packages/examples/learning-journey-ui-coaching`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
 ## Usage
 
-```tsx
-import { CoachingMiniApp } from '@contractspec/example.learning-journey-ui-coaching';
-import { moneyAmbientCoachTrack } from '@contractspec/example.learning-journey-ambient-coach/track';
+Use `@contractspec/example.learning-journey-ui-coaching` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
+
+## Architecture
+
+- `src/CoachingMiniApp.tsx` is part of the package's public or composition surface.
+- `src/components/` contains reusable UI components and view composition.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/learning-journey-ui-coaching.feature.ts` defines a feature entrypoint.
+- `src/views/` contains view-level composition.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./CoachingMiniApp` resolves through `./src/CoachingMiniApp.tsx`.
+- Export `./components` resolves through `./src/components/index.ts`.
+- Export `./components/EngagementMeter` resolves through `./src/components/EngagementMeter.tsx`.
+- Export `./components/TipCard` resolves through `./src/components/TipCard.tsx`.
+- Export `./components/TipFeed` resolves through `./src/components/TipFeed.tsx`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/learning-journey-ui-coaching.docblock` resolves through `./src/docs/learning-journey-ui-coaching.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./learning-journey-ui-coaching.feature` resolves through `./src/learning-journey-ui-coaching.feature.ts`.
+- The package publishes 15 total export subpaths; keep docs aligned with `package.json`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
 
-function MyApp() {
-  return (
-    <CoachingMiniApp track={moneyAmbientCoachTrack} initialView="overview" />
-  );
-}
-```
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
 
-## Components
+## Notes
 
-- **TipCard** - Individual coaching tip with action/dismiss options
-- **EngagementMeter** - Donut chart showing actioned/acknowledged/pending
-- **TipFeed** - Timeline feed of tip activity
+- Works alongside `@contractspec/example.learning-journey-ambient-coach`, `@contractspec/example.learning-journey-crm-onboarding`, `@contractspec/example.learning-journey-ui-shared`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, ...