@lssm/example.learning-journey-ui-coaching 0.0.0-canary-20251216033905 → 0.0.0-canary-20251216062412

package/.turbo/turbo-build.log

@@ -6,7 +6,7 @@ $ tsdown
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/index.mjs                123.78 kB │ gzip: 41.01 kB
+ℹ dist/index.mjs                133.25 kB │ gzip: 44.05 kB
 ℹ dist/views/index.mjs            0.20 kB │ gzip:  0.15 kB
 ℹ dist/components/index.mjs       0.17 kB │ gzip:  0.14 kB
 ℹ dist/views-BTGcWRSz.mjs        16.11 kB │ gzip:  2.79 kB
@@ -15,8 +15,8 @@ $ tsdown
 ℹ dist/index.d.mts                1.75 kB │ gzip:  0.70 kB
 ℹ dist/views/index.d.mts          0.16 kB │ gzip:  0.13 kB
 ℹ dist/components/index.d.mts     0.14 kB │ gzip:  0.11 kB
-ℹ dist/index-BH0UbqIy.d.mts       1.16 kB │ gzip:  0.44 kB
-ℹ dist/index-BjhNDTSh.d.mts       0.94 kB │ gzip:  0.34 kB
-ℹ 11 files, total: 152.77 kB
-✔ Build complete in 9293ms
+ℹ dist/index-CYYCjq6y.d.mts       1.16 kB │ gzip:  0.44 kB
+ℹ dist/index-Cpg19PUU.d.mts       0.94 kB │ gzip:  0.34 kB
+ℹ 11 files, total: 162.24 kB
+✔ Build complete in 9332ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,13 +1,13 @@
 # @lssm/example.learning-journey-ui-coaching
 
-## 0.0.0-canary-20251216033905
+## 0.0.0-canary-20251216062412
 
 ### Patch Changes
 
 - Updated dependencies [3086383]
-  - @lssm/lib.design-system@0.0.0-canary-20251216033905
-  - @lssm/lib.ui-kit-web@0.0.0-canary-20251216033905
-  - @lssm/example.learning-journey-crm-onboarding@0.0.0-canary-20251216033905
-  - @lssm/example.learning-journey-ui-shared@0.0.0-canary-20251216033905
-  - @lssm/example.learning-journey-ambient-coach@0.0.0-canary-20251216033905
-  - @lssm/module.learning-journey@0.0.0-canary-20251216033905
+  - @lssm/lib.design-system@0.0.0-canary-20251216062412
+  - @lssm/lib.ui-kit-web@0.0.0-canary-20251216062412
+  - @lssm/example.learning-journey-crm-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/module.learning-journey@0.0.0-canary-20251216062412

package/dist/components/index.d.mts

@@ -1,2 +1,2 @@
-import { n as EngagementMeter, r as TipCard, t as TipFeed } from "../index-BH0UbqIy.mjs";
+import { n as EngagementMeter, r as TipCard, t as TipFeed } from "../index-CYYCjq6y.mjs";
 export { EngagementMeter, TipCard, TipFeed };

package/dist/{index-BH0UbqIy.d.mts → index-CYYCjq6y.d.mts}

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime4 from "react/jsx-runtime";
 import { LearningJourneyStepSpec } from "@lssm/module.learning-journey/track-spec";
 
 //#region src/components/TipCard.d.ts
@@ -15,7 +15,7 @@ declare function TipCard({
   isCurrent,
   onComplete,
   onDismiss
-}: TipCardProps): react_jsx_runtime0.JSX.Element;
+}: TipCardProps): react_jsx_runtime4.JSX.Element;
 //#endregion
 //#region src/components/EngagementMeter.d.ts
 interface EngagementMeterProps {
@@ -29,7 +29,7 @@ declare function EngagementMeter({
   actioned,
   pending,
   streak
-}: EngagementMeterProps): react_jsx_runtime0.JSX.Element;
+}: EngagementMeterProps): react_jsx_runtime4.JSX.Element;
 //#endregion
 //#region src/components/TipFeed.d.ts
 interface TipFeedItem {
@@ -42,6 +42,6 @@ interface TipFeedProps {
 }
 declare function TipFeed({
   items
-}: TipFeedProps): react_jsx_runtime0.JSX.Element;
+}: TipFeedProps): react_jsx_runtime4.JSX.Element;
 //#endregion
 export { EngagementMeter as n, TipCard as r, TipFeed as t };

package/dist/{index-BjhNDTSh.d.mts → index-Cpg19PUU.d.mts}

@@ -1,5 +1,5 @@
 import { LearningViewProps } from "@lssm/example.learning-journey-ui-shared";
-import * as react_jsx_runtime4 from "react/jsx-runtime";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/views/Overview.d.ts
 interface CoachingOverviewProps extends LearningViewProps {
@@ -10,25 +10,25 @@ declare function Overview({
   progress,
   onStepComplete,
   onStart
-}: CoachingOverviewProps): react_jsx_runtime4.JSX.Element;
+}: CoachingOverviewProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/views/Steps.d.ts
 declare function Steps({
   track,
   progress,
   onStepComplete
-}: LearningViewProps): react_jsx_runtime4.JSX.Element;
+}: LearningViewProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/views/Progress.d.ts
 declare function ProgressView({
   track,
   progress
-}: LearningViewProps): react_jsx_runtime4.JSX.Element;
+}: LearningViewProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/views/Timeline.d.ts
 declare function Timeline({
   track,
   progress
-}: LearningViewProps): react_jsx_runtime4.JSX.Element;
+}: LearningViewProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { Overview as i, ProgressView as n, Steps as r, Timeline as t };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { n as EngagementMeter, r as TipCard, t as TipFeed } from "./index-BH0UbqIy.mjs";
-import { i as Overview, n as ProgressView, r as Steps, t as Timeline } from "./index-BjhNDTSh.mjs";
+import { n as EngagementMeter, r as TipCard, t as TipFeed } from "./index-CYYCjq6y.mjs";
+import { i as Overview, n as ProgressView, r as Steps, t as Timeline } from "./index-Cpg19PUU.mjs";
 import { LearningMiniAppProps } from "@lssm/example.learning-journey-ui-shared";
-import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime6 from "react/jsx-runtime";
 
 //#region src/CoachingMiniApp.d.ts
 type CoachingMiniAppProps = Omit<LearningMiniAppProps, 'progress'> & {
@@ -13,7 +13,7 @@ declare function CoachingMiniApp({
   onStepComplete: externalOnStepComplete,
   onViewChange,
   initialView
-}: CoachingMiniAppProps): react_jsx_runtime2.JSX.Element;
+}: CoachingMiniAppProps): react_jsx_runtime6.JSX.Element;
 //#endregion
 //#region src/example.d.ts
 declare const example: {

package/dist/index.mjs

@@ -1322,6 +1322,361 @@ Acceptance rules:
 }];
 registerDocBlocks(tech_studio_team_invitations_DocBlocks);
 
+//#endregion
+//#region ../../libs/contracts/src/docs/tech/llm/llm-integration.docblock.ts
+const tech_llm_integration_DocBlocks = [
+	{
+		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
+`
+	}
+];
+registerDocBlocks(tech_llm_integration_DocBlocks);
+
 //#endregion
 //#region src/docs/learning-journey-ui-coaching.docblock.ts
 registerDocBlocks([{

package/dist/views/index.d.mts

@@ -1,2 +1,2 @@
-import { i as Overview, n as ProgressView, r as Steps, t as Timeline } from "../index-BjhNDTSh.mjs";
+import { i as Overview, n as ProgressView, r as Steps, t as Timeline } from "../index-Cpg19PUU.mjs";
 export { Overview, ProgressView as Progress, Steps, Timeline };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.learning-journey-ui-coaching",
-  "version": "0.0.0-canary-20251216033905",
+  "version": "0.0.0-canary-20251216062412",
   "description": "Contextual coaching UI with tip cards and engagement tracking.",
   "type": "module",
   "main": "./dist/index.js",