@lssm/example.learning-journey-registry 0.0.0-canary-20251216035145 → 0.0.0-canary-20251216062412

package/.turbo/turbo-build.log

@@ -2,16 +2,17 @@ $ bun build:bundle && bun build:types
 $ tsdown
 ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-registry/tsdown.config.js 
-ℹ entry: src/api-types.ts, src/api.ts, src/example.ts, src/index.ts, src/progress-store.ts, src/tracks.ts, src/docs/index.ts, src/docs/learning-journey-registry.docblock.ts, src/presentations/index.ts, src/ui/LearningMiniApp.tsx, src/ui/index.ts
+ℹ entry: src/api-types.ts, src/api.ts, src/example.ts, src/index.ts, src/learning-journey-registry.feature.ts, src/progress-store.ts, src/tracks.ts, src/docs/index.ts, src/docs/learning-journey-registry.docblock.ts, src/presentations/index.ts, src/ui/LearningMiniApp.tsx, src/ui/index.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ dist/api.js                                                                    3.28 kB │ gzip: 1.37 kB
 ℹ dist/ui/LearningMiniApp.js                                                     1.88 kB │ gzip: 0.70 kB
 ℹ dist/tracks.js                                                                 1.30 kB │ gzip: 0.50 kB
+ℹ dist/index.js                                                                  1.23 kB │ gzip: 0.42 kB
 ℹ dist/docs/learning-journey-registry.docblock.js                                1.21 kB │ gzip: 0.63 kB
-ℹ dist/index.js                                                                  1.10 kB │ gzip: 0.38 kB
 ℹ dist/presentations/index.js                                                    0.99 kB │ gzip: 0.39 kB
+ℹ dist/learning-journey-registry.feature.js                                      0.86 kB │ gzip: 0.36 kB
 ℹ dist/example.js                                                                0.52 kB │ gzip: 0.32 kB
 ℹ dist/progress-store.js                                                         0.43 kB │ gzip: 0.29 kB
 ℹ dist/ui/index.js                                                               0.19 kB │ gzip: 0.11 kB
@@ -20,6 +21,7 @@ $ tsdown
 ℹ dist/libs/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.js  16.53 kB │ gzip: 7.16 kB
 ℹ dist/libs/contracts/src/docs/tech/schema/README.docblock.js                   10.99 kB │ gzip: 4.29 kB
 ℹ dist/libs/contracts/src/docs/tech/lifecycle-stage-system.docblock.js           9.67 kB │ gzip: 3.78 kB
+ℹ dist/libs/contracts/src/docs/tech/llm/llm-integration.docblock.js              9.12 kB │ gzip: 3.42 kB
 ℹ dist/libs/contracts/src/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.76 kB │ gzip: 2.68 kB
 ℹ dist/libs/contracts/src/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.93 kB │ gzip: 2.61 kB
 ℹ dist/libs/contracts/src/docs/tech/templates/runtime.docblock.js                5.63 kB │ gzip: 2.58 kB
@@ -40,12 +42,12 @@ $ tsdown
 ℹ dist/libs/contracts/src/docs/tech/studio/learning-events.docblock.js           1.79 kB │ gzip: 0.88 kB
 ℹ dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.js         1.72 kB │ gzip: 0.90 kB
 ℹ dist/libs/contracts/src/docs/tech/studio/project-access-teams.docblock.js      1.58 kB │ gzip: 0.78 kB
-ℹ dist/libs/contracts/src/docs/index.js                                          1.50 kB │ gzip: 0.51 kB
+ℹ dist/libs/contracts/src/docs/index.js                                          1.54 kB │ gzip: 0.52 kB
 ℹ dist/libs/contracts/src/docs/tech/studio/workspace-ops.docblock.js             1.49 kB │ gzip: 0.73 kB
 ℹ dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js                    1.24 kB │ gzip: 0.68 kB
 ℹ dist/libs/contracts/src/docs/presentations.js                                  1.23 kB │ gzip: 0.59 kB
 ℹ dist/libs/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.js          0.90 kB │ gzip: 0.56 kB
 ℹ dist/libs/contracts/src/docs/registry.js                                       0.74 kB │ gzip: 0.42 kB
-ℹ 40 files, total: 126.00 kB
-✔ Build complete in 55ms
+ℹ 42 files, total: 136.15 kB
+✔ Build complete in 57ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,17 +1,17 @@
 # @lssm/example.learning-journey-registry
 
-## 0.0.0-canary-20251216035145
+## 0.0.0-canary-20251216062412
 
 ### Patch Changes
 
-- @lssm/example.learning-journey-crm-onboarding@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-ui-coaching@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-ui-gamified@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-ui-onboarding@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-ambient-coach@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-duo-drills@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-platform-tour@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-quest-challenges@0.0.0-canary-20251216035145
-- @lssm/example.learning-journey-studio-onboarding@0.0.0-canary-20251216035145
-- @lssm/module.learning-journey@0.0.0-canary-20251216035145
+- @lssm/example.learning-journey-crm-onboarding@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-ui-coaching@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-ui-gamified@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-ui-onboarding@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-ambient-coach@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-duo-drills@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-platform-tour@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-quest-challenges@0.0.0-canary-20251216062412
+- @lssm/example.learning-journey-studio-onboarding@0.0.0-canary-20251216062412
+- @lssm/module.learning-journey@0.0.0-canary-20251216062412

package/dist/index.js

@@ -1 +1 @@
-import{crmLearningTracks as e,learningJourneyTracks as t,mapStep as n,mapTrackSpecToDto as r,onboardingTrackCatalog as i,platformLearningTracks as a,studioLearningTracks as o}from"./tracks.js";import{getProgress as s,listTracks as c,recordEvent as l}from"./api.js";import u from"./example.js";import"./docs/index.js";import{LearningTrackDetailPresentation as d,LearningTrackListPresentation as f,LearningTrackProgressWidgetPresentation as p,learningJourneyPresentations as m}from"./presentations/index.js";import{LearningMiniApp as h,getLearningTemplateIds as g,isLearningTemplate as _}from"./ui/LearningMiniApp.js";import"./ui/index.js";export{h as LearningMiniApp,d as LearningTrackDetailPresentation,f as LearningTrackListPresentation,p as LearningTrackProgressWidgetPresentation,e as crmLearningTracks,u as example,g as getLearningTemplateIds,s as getProgress,_ as isLearningTemplate,m as learningJourneyPresentations,t as learningJourneyTracks,c as listTracks,n as mapStep,r as mapTrackSpecToDto,i as onboardingTrackCatalog,a as platformLearningTracks,l as recordEvent,o as studioLearningTracks};
+import{crmLearningTracks as e,learningJourneyTracks as t,mapStep as n,mapTrackSpecToDto as r,onboardingTrackCatalog as i,platformLearningTracks as a,studioLearningTracks as o}from"./tracks.js";import{getProgress as s,listTracks as c,recordEvent as l}from"./api.js";import u from"./example.js";import"./docs/index.js";import{LearningTrackDetailPresentation as d,LearningTrackListPresentation as f,LearningTrackProgressWidgetPresentation as p,learningJourneyPresentations as m}from"./presentations/index.js";import{LearningJourneyRegistryFeature as h}from"./learning-journey-registry.feature.js";import{LearningMiniApp as g,getLearningTemplateIds as _,isLearningTemplate as v}from"./ui/LearningMiniApp.js";import"./ui/index.js";export{h as LearningJourneyRegistryFeature,g as LearningMiniApp,d as LearningTrackDetailPresentation,f as LearningTrackListPresentation,p as LearningTrackProgressWidgetPresentation,e as crmLearningTracks,u as example,_ as getLearningTemplateIds,s as getProgress,v as isLearningTemplate,m as learningJourneyPresentations,t as learningJourneyTracks,c as listTracks,n as mapStep,r as mapTrackSpecToDto,i as onboardingTrackCatalog,a as platformLearningTracks,l as recordEvent,o as studioLearningTracks};

package/dist/learning-journey-registry.feature.js

@@ -0,0 +1 @@
+const e={meta:{key:`learning-journey-registry`,title:`Learning Journey Registry`,description:`Shared registry and presentations for learning journey tracks`,domain:`learning-journey`,owners:[`@learning-team`],tags:[`learning`,`journey`,`onboarding`,`registry`],stability:`experimental`},operations:[],events:[],presentations:[{name:`learning.journey.track_list`,version:1},{name:`learning.journey.track_detail`,version:1},{name:`learning.journey.progress_widget`,version:1}],opToPresentation:[],presentationsTargets:[{name:`learning.journey.track_list`,version:1,targets:[`react`,`markdown`]},{name:`learning.journey.track_detail`,version:1,targets:[`react`,`markdown`,`application/json`]},{name:`learning.journey.progress_widget`,version:1,targets:[`react`]}],capabilities:{requires:[{key:`identity`,version:1}]}};export{e as LearningJourneyRegistryFeature};

package/dist/libs/contracts/src/docs/index.js

@@ -1 +1 @@
-import{docBlockToPresentationSpec as e,docBlockToPresentationV2 as t,docBlocksToPresentationRoutes as n}from"./presentations.js";import{DocRegistry as r,defaultDocRegistry as i,registerDocBlocks as a}from"./registry.js";import"./PUBLISHING.docblock.js";import"./accessibility_wcag_compliance_specs.docblock.js";import"./tech/PHASE_1_QUICKSTART.docblock.js";import"./tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js";import"./tech/PHASE_3_AUTO_EVOLUTION.docblock.js";import"./tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js";import"./tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js";import"./tech/lifecycle-stage-system.docblock.js";import"./tech/presentation-runtime.docblock.js";import"./tech/auth/better-auth-nextjs.docblock.js";import"./tech/schema/README.docblock.js";import"./tech/templates/runtime.docblock.js";import"./tech/workflows/overview.docblock.js";import"./tech/mcp-endpoints.docblock.js";import"./tech/vscode-extension.docblock.js";import"./tech/telemetry-ingest.docblock.js";import"./tech/contracts/openapi-export.docblock.js";import"./tech/studio/workspaces.docblock.js";import"./tech/studio/sandbox-unlogged.docblock.js";import"./tech/studio/workspace-ops.docblock.js";import"./tech/studio/project-routing.docblock.js";import"./tech/studio/platform-admin-panel.docblock.js";import"./tech/studio/learning-events.docblock.js";import"./tech/studio/learning-journeys.docblock.js";import"./tech/studio/project-access-teams.docblock.js";import"./tech/studio/team-invitations.docblock.js";
+import{docBlockToPresentationSpec as e,docBlockToPresentationV2 as t,docBlocksToPresentationRoutes as n}from"./presentations.js";import{DocRegistry as r,defaultDocRegistry as i,registerDocBlocks as a}from"./registry.js";import"./PUBLISHING.docblock.js";import"./accessibility_wcag_compliance_specs.docblock.js";import"./tech/PHASE_1_QUICKSTART.docblock.js";import"./tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js";import"./tech/PHASE_3_AUTO_EVOLUTION.docblock.js";import"./tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js";import"./tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js";import"./tech/lifecycle-stage-system.docblock.js";import"./tech/presentation-runtime.docblock.js";import"./tech/auth/better-auth-nextjs.docblock.js";import"./tech/schema/README.docblock.js";import"./tech/templates/runtime.docblock.js";import"./tech/workflows/overview.docblock.js";import"./tech/mcp-endpoints.docblock.js";import"./tech/vscode-extension.docblock.js";import"./tech/telemetry-ingest.docblock.js";import"./tech/contracts/openapi-export.docblock.js";import"./tech/studio/workspaces.docblock.js";import"./tech/studio/sandbox-unlogged.docblock.js";import"./tech/studio/workspace-ops.docblock.js";import"./tech/studio/project-routing.docblock.js";import"./tech/studio/platform-admin-panel.docblock.js";import"./tech/studio/learning-events.docblock.js";import"./tech/studio/learning-journeys.docblock.js";import"./tech/studio/project-access-teams.docblock.js";import"./tech/studio/team-invitations.docblock.js";import"./tech/llm/llm-integration.docblock.js";

package/dist/libs/contracts/src/docs/tech/llm/llm-integration.docblock.js

@@ -0,0 +1,289 @@
+import{registerDocBlocks as e}from"../../registry.js";e([{id:`docs.tech.llm.overview`,title:`LLM Integration Overview`,summary:`Export specs to LLM-friendly formats, generate implementation guides, and verify implementations.`,kind:`reference`,visibility:`public`,route:`/docs/tech/llm/overview`,tags:[`llm`,`ai`,`export`,`guide`,`verify`],body:`# LLM Integration
+
+ContractSpec provides first-class LLM integration to bridge specifications and AI coding agents.
+
+## Core Features
+
+### 1. Multi-Format Export
+
+Export specs to markdown in formats optimized for LLM consumption:
+
+- **Context format**: Summary for understanding (goal, context, acceptance criteria)
+- **Full format**: Complete spec with all details (I/O schemas, policy, events)
+- **Prompt format**: Actionable prompt with implementation instructions
+
+### 2. Implementation Guidance
+
+Generate agent-specific implementation plans:
+
+- **Claude Code**: Extended thinking mode with structured prompts
+- **Cursor CLI**: Background/composer mode with .mdc rules generation
+- **Generic MCP**: Standard format for any MCP-compatible agent
+
+### 3. Tiered Verification
+
+Verify implementations against specs:
+
+- **Tier 1 (Structure)**: Types, exports, imports validation
+- **Tier 2 (Behavior)**: Scenario coverage, error handling, events
+- **Tier 3 (AI Review)**: Semantic compliance analysis via LLM
+
+## Access Points
+
+| Surface | Commands/Tools |
+|---------|---------------|
+| CLI | \`contractspec llm export\`, \`guide\`, \`verify\`, \`copy\` |
+| MCP | \`llm.export\`, \`llm.guide\`, \`llm.verify\` tools |
+| VSCode | Export to LLM, Generate Guide, Verify, Copy commands |
+
+## Quick Start
+
+### CLI Usage
+
+\`\`\`bash
+# Export spec as markdown
+contractspec llm export path/to/my.spec.ts --format full
+
+# Generate implementation guide
+contractspec llm guide path/to/my.spec.ts --agent claude-code
+
+# Verify implementation
+contractspec llm verify path/to/my.spec.ts path/to/impl.ts --tier 2
+
+# Copy spec to clipboard
+contractspec llm copy path/to/my.spec.ts --format context
+\`\`\`
+
+### MCP Usage
+
+\`\`\`
+# Export spec
+llm.export { specPath: "path/to/my.spec.ts", format: "full" }
+
+# Generate guide
+llm.guide { specPath: "path/to/my.spec.ts", agent: "cursor-cli" }
+
+# Verify implementation
+llm.verify { specPath: "path/to/my.spec.ts", implementationPath: "path/to/impl.ts", tier: "2" }
+\`\`\`
+
+### Programmatic Usage
+
+\`\`\`typescript
+import { specToFullMarkdown, specToAgentPrompt } from '@lssm/lib.contracts/llm';
+import { createAgentGuideService, createVerifyService } from '@lssm/bundle.contractspec-workspace';
+
+// Export
+const markdown = specToFullMarkdown(mySpec);
+
+// Generate guide
+const guideService = createAgentGuideService({ defaultAgent: 'claude-code' });
+const guide = guideService.generateGuide(mySpec);
+
+// Verify
+const verifyService = createVerifyService();
+const result = await verifyService.verify(mySpec, implementationCode, {
+  tiers: ['structure', 'behavior']
+});
+\`\`\`
+`},{id:`docs.tech.llm.export-formats`,title:`LLM Export Formats`,summary:`Detailed explanation of the three export formats for LLM consumption.`,kind:`reference`,visibility:`public`,route:`/docs/tech/llm/export-formats`,tags:[`llm`,`export`,`markdown`],body:`# LLM Export Formats
+
+ContractSpec provides three export formats optimized for different LLM use cases.
+
+## Context Format
+
+Best for: Understanding what a spec does, providing background to LLMs.
+
+Includes:
+- Spec name, version, type
+- Goal and context
+- Description
+- Acceptance scenarios
+
+Example:
+
+\`\`\`markdown
+# users.createUser (v1)
+
+> Create a new user account with email verification.
+
+**Type:** command | **Stability:** stable
+
+## Goal
+Create a new user in the system and trigger email verification.
+
+## Context
+Part of the user onboarding flow. Called after signup form submission.
+
+## Acceptance Criteria
+### Happy path
+**Given:** Valid email and password
+**When:** User submits registration
+**Then:** Account is created, verification email is sent
+\`\`\`
+
+## Full Format
+
+Best for: Complete documentation, implementation reference.
+
+Includes everything:
+- All metadata
+- JSON schemas for I/O
+- Error definitions
+- Policy (auth, rate limits, PII)
+- Events emitted
+- Examples
+- Transport configuration
+
+## Prompt Format
+
+Best for: Feeding directly to coding agents.
+
+Includes:
+- Task header with clear instructions
+- Full spec context
+- Implementation requirements
+- Task-specific guidance (implement/test/refactor/review)
+- Expected output format
+
+The prompt format adapts based on task type:
+- **implement**: Full implementation with tests
+- **test**: Test generation for existing code
+- **refactor**: Refactoring while maintaining behavior
+- **review**: Code review against spec
+`},{id:`docs.tech.llm.agent-adapters`,title:`Agent Adapters`,summary:`Adapters for different AI coding agents (Claude, Cursor, MCP).`,kind:`reference`,visibility:`public`,route:`/docs/tech/llm/agent-adapters`,tags:[`llm`,`agents`,`claude`,`cursor`,`mcp`],body:`# Agent Adapters
+
+ContractSpec provides specialized adapters for different AI coding agents.
+
+## Claude Code Adapter
+
+Optimized for Anthropic Claude's extended thinking and code generation.
+
+Features:
+- Structured markdown with clear sections
+- Checklists for steps and verification
+- Icons for file operations (📝 create, ✏️ modify)
+- System prompt for ContractSpec context
+
+Usage:
+\`\`\`typescript
+const guideService = createAgentGuideService({ defaultAgent: 'claude-code' });
+const result = guideService.generateGuide(spec, { agent: 'claude-code' });
+// result.prompt.systemPrompt - Claude system context
+// result.prompt.taskPrompt - Task-specific instructions
+\`\`\`
+
+## Cursor CLI Adapter
+
+Optimized for Cursor's background/composer mode.
+
+Features:
+- Compact format for context efficiency
+- .mdc cursor rules generation
+- Integration with Cursor's file system
+- Concise step lists
+
+Generate Cursor Rules:
+\`\`\`typescript
+const cursorRules = guideService.generateAgentConfig(spec, 'cursor-cli');
+// Save to .cursor/rules/my-spec.mdc
+\`\`\`
+
+## Generic MCP Adapter
+
+Works with any MCP-compatible agent (Cline, Aider, etc.).
+
+Features:
+- Standard markdown format
+- Table-based metadata
+- JSON resource format support
+- Prompt message format
+
+The generic adapter is the default and works across all agents.
+
+## Choosing an Adapter
+
+| Agent | Best For | Key Features |
+|-------|----------|--------------|
+| Claude Code | Complex implementations | Extended thinking, detailed steps |
+| Cursor CLI | IDE-integrated work | Cursor rules, compact format |
+| Generic MCP | Any MCP agent | Universal compatibility |
+`},{id:`docs.tech.llm.verification`,title:`Implementation Verification`,summary:`Tiered verification of implementations against specifications.`,kind:`reference`,visibility:`public`,route:`/docs/tech/llm/verification`,tags:[`llm`,`verify`,`validation`,`testing`],body:`# Implementation Verification
+
+ContractSpec provides tiered verification to check if implementations comply with specs.
+
+## Verification Tiers
+
+### Tier 1: Structure (Fast)
+
+Checks TypeScript structure against spec requirements:
+
+| Check | What it validates |
+|-------|------------------|
+| Handler export | Function is properly exported |
+| Contracts import | Imports from @lssm/lib.contracts |
+| Schema import | Imports from @lssm/lib.schema |
+| No \`any\` type | TypeScript strict compliance |
+| Error handling | Error codes are referenced |
+| Event emission | Event patterns exist |
+| Input validation | Validation patterns used |
+| Async patterns | Async/await for commands |
+
+### Tier 2: Behavior (Comprehensive)
+
+Checks implementation coverage of spec behaviors:
+
+| Check | What it validates |
+|-------|------------------|
+| Scenario coverage | Acceptance scenarios implemented |
+| Example coverage | Example I/O values referenced |
+| Error cases | All error conditions handled |
+| Event conditions | Events emitted correctly |
+| Idempotency | Idempotent patterns (if required) |
+
+### Tier 3: AI Review (Deep)
+
+Uses LLM for semantic analysis:
+
+- Does the implementation fulfill the spec's intent?
+- Are edge cases properly handled?
+- Is the code quality acceptable?
+- Are there any subtle violations?
+
+Requires AI API key configuration.
+
+## Running Verification
+
+\`\`\`typescript
+const verifyService = createVerifyService({
+  aiApiKey: process.env.ANTHROPIC_API_KEY, // Optional, for Tier 3
+  aiProvider: 'anthropic',
+});
+
+const result = await verifyService.verify(spec, implementationCode, {
+  tiers: ['structure', 'behavior'],
+  failFast: false,
+  includeSuggestions: true,
+});
+
+console.log(result.passed);  // true/false
+console.log(result.score);   // 0-100
+console.log(result.summary); // Human-readable summary
+\`\`\`
+
+## Verification Report
+
+The report includes:
+
+- **passed**: Overall compliance
+- **score**: 0-100 score
+- **issues**: Array of problems found
+- **suggestions**: Recommended fixes
+- **coverage**: Metrics on scenario/error/field coverage
+
+Each issue has:
+- **severity**: error, warning, or info
+- **category**: type, export, import, scenario, error_handling, semantic
+- **message**: Description of the issue
+- **suggestion**: How to fix it
+`}]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.learning-journey-registry",
-  "version": "0.0.0-canary-20251216035145",
+  "version": "0.0.0-canary-20251216062412",
   "description": "Registry that aggregates learning journey example tracks.",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,6 +12,7 @@
     "./docs": "./src/docs/index.ts",
     "./docs/learning-journey-registry.docblock": "./src/docs/learning-journey-registry.docblock.ts",
     "./example": "./src/example.ts",
+    "./learning-journey-registry.feature": "./src/learning-journey-registry.feature.ts",
     "./presentations": "./src/presentations/index.ts",
     "./progress-store": "./src/progress-store.ts",
     "./tracks": "./src/tracks.ts",
@@ -63,6 +64,7 @@
       "./docs": "./dist/docs/index.js",
       "./docs/learning-journey-registry.docblock": "./dist/docs/learning-journey-registry.docblock.js",
       "./example": "./dist/example.js",
+      "./learning-journey-registry.feature": "./dist/learning-journey-registry.feature.js",
       "./presentations": "./dist/presentations/index.js",
       "./progress-store": "./dist/progress-store.js",
       "./tracks": "./dist/tracks.js",

package/src/index.ts

@@ -3,5 +3,6 @@ import './docs';
 export * from './tracks';
 export * from './api';
 export * from './presentations';
+export * from './learning-journey-registry.feature';
 export * from './ui';
 export { default as example } from './example';

package/src/learning-journey-registry.feature.ts

@@ -0,0 +1,63 @@
+/**
+ * Learning Journey Registry Feature Module Specification
+ *
+ * Defines the feature module for the learning journey registry.
+ */
+import type { FeatureModuleSpec } from '@lssm/lib.contracts';
+
+/**
+ * Learning Journey Registry feature module that bundles
+ * the shared presentations for learning journey tracks.
+ */
+export const LearningJourneyRegistryFeature: FeatureModuleSpec = {
+  meta: {
+    key: 'learning-journey-registry',
+    title: 'Learning Journey Registry',
+    description:
+      'Shared registry and presentations for learning journey tracks',
+    domain: 'learning-journey',
+    owners: ['@learning-team'],
+    tags: ['learning', 'journey', 'onboarding', 'registry'],
+    stability: 'experimental',
+  },
+
+  // No operations in the registry - it's presentation-only
+  operations: [],
+
+  // Events emitted by this feature
+  events: [],
+
+  // Presentations associated with this feature
+  presentations: [
+    { name: 'learning.journey.track_list', version: 1 },
+    { name: 'learning.journey.track_detail', version: 1 },
+    { name: 'learning.journey.progress_widget', version: 1 },
+  ],
+
+  // No op to presentation links for registry
+  opToPresentation: [],
+
+  // Target requirements for multi-surface rendering
+  presentationsTargets: [
+    {
+      name: 'learning.journey.track_list',
+      version: 1,
+      targets: ['react', 'markdown'],
+    },
+    {
+      name: 'learning.journey.track_detail',
+      version: 1,
+      targets: ['react', 'markdown', 'application/json'],
+    },
+    {
+      name: 'learning.journey.progress_widget',
+      version: 1,
+      targets: ['react'],
+    },
+  ],
+
+  // Capability requirements
+  capabilities: {
+    requires: [{ key: 'identity', version: 1 }],
+  },
+};