@lssm/example.learning-journey-registry 0.0.0-canary-20251212004227

package/.turbo/turbo-build.log

@@ -0,0 +1,35 @@
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.0 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/index.ts, src/progress-store.ts, src/tracks.ts, src/docs/index.ts, src/docs/learning-journey-registry.docblock.ts, src/presentations/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/api.js                                                                    3.28 kB │ gzip: 1.37 kB
+ℹ dist/tracks.js                                                                 1.30 kB │ gzip: 0.50 kB
+ℹ dist/docs/learning-journey-registry.docblock.js                                1.21 kB │ gzip: 0.63 kB
+ℹ dist/presentations/index.js                                                    0.99 kB │ gzip: 0.39 kB
+ℹ dist/index.js                                                                  0.85 kB │ gzip: 0.31 kB
+ℹ dist/progress-store.js                                                         0.43 kB │ gzip: 0.29 kB
+ℹ dist/docs/index.js                                                             0.05 kB │ gzip: 0.07 kB
+ℹ dist/api-types.js                                                              0.00 kB │ gzip: 0.02 kB
+ℹ 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/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
+ℹ dist/libs/contracts/src/docs/tech/workflows/overview.docblock.js               5.44 kB │ gzip: 2.26 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.37 kB │ gzip: 2.06 kB
+ℹ dist/libs/contracts/src/docs/PUBLISHING.docblock.js                            3.43 kB │ gzip: 1.59 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.00 kB │ gzip: 1.53 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.83 kB │ gzip: 1.41 kB
+ℹ dist/libs/contracts/src/docs/tech/presentation-runtime.docblock.js             2.75 kB │ gzip: 1.30 kB
+ℹ dist/libs/contracts/src/docs/presentations.js                                  1.23 kB │ gzip: 0.59 kB
+ℹ dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js                    1.07 kB │ gzip: 0.61 kB
+ℹ dist/libs/contracts/src/docs/index.js                                          0.85 kB │ gzip: 0.35 kB
+ℹ dist/libs/contracts/src/docs/registry.js                                       0.74 kB │ gzip: 0.42 kB
+ℹ 24 files, total: 91.33 kB
+✔ Build complete in 43ms
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @lssm/example.learning-journey-registry
+
+## 0.0.0-canary-20251212004227
+
+### Patch Changes
+
+- @lssm/example.learning-journey.crm-onboarding@0.0.0-canary-20251212004227
+- @lssm/example.learning-journey.ambient-coach@0.0.0-canary-20251212004227
+- @lssm/example.learning-journey.duo-drills@0.0.0-canary-20251212004227
+- @lssm/example.learning-journey.platform-tour@0.0.0-canary-20251212004227
+- @lssm/example.learning-journey.quest-challenges@0.0.0-canary-20251212004227
+- @lssm/example.learning-journey.studio-onboarding@0.0.0-canary-20251212004227
+- @lssm/module.learning-journey@0.0.0-canary-20251212004227

package/README.md

@@ -0,0 +1,22 @@
+# @lssm/example.learning-journey-registry
+
+Aggregated registry for learning journey example tracks.
+
+## Contents
+
+- `learningJourneyTracks`: all track specs
+- `onboardingTrackCatalog`: DTOs aligned with onboarding API outputs
+- `mapTrackSpecToDto`: helper for adapters
+- Re-exports per-track arrays: Studio onboarding, Platform tour, CRM first win
+
+## Usage
+
+```ts
+import { onboardingTrackCatalog } from '@lssm/example.learning-journey-registry';
+// Feed into API/service that implements learning.onboarding.listTracks
+```
+
+## Docs
+
+- Docblock: `src/docs/learning-journey-registry.docblock.ts`
+- Route suggestion: `/docs/learning-journey/registry`

package/dist/api.js

@@ -0,0 +1 @@
+import{learningJourneyTracks as e}from"./tracks.js";import{getLearnerTracks as t,getTrackResolver as n,initProgress as r}from"./progress-store.js";const i=n(e),a=(e,t)=>e?t?Object.entries(e).every(([e,n])=>t[e]===n):!1:!0,o=(e,t)=>e.eventName!==t.name||e.eventVersion!==void 0&&t.version!==void 0&&e.eventVersion!==t.version||e.sourceModule&&t.sourceModule&&e.sourceModule!==t.sourceModule?!1:a(e.payloadFilter,t.payload),s=(e,t,n,r)=>{if(e.kind===`count`){if(!o(e,t))return{matched:!1};let i=(n.occurrences??0)+1;return{matched:(e.withinHours===void 0||!!(r&&t.occurredAt&&(t.occurredAt.getTime()-r.getTime())/(1e3*60*60)<=e.withinHours))&&i>=e.atLeast,occurrences:i}}if(e.kind===`time_window`)return!o(e,t)||e.withinHoursOfStart!==void 0&&r&&t.occurredAt&&(t.occurredAt.getTime()-r.getTime())/(1e3*60*60)>e.withinHoursOfStart?{matched:!1}:{matched:!0};if(e.kind===`srs_mastery`){if(t.name!==e.eventName)return{matched:!1};let r=t.payload;if(!a(e.payloadFilter,r))return{matched:!1};let i=e.skillIdField??`skillId`,o=e.masteryField??`mastery`,s=r?.[i],c=r?.[o];if(s===void 0||c===void 0||typeof c!=`number`||c<e.minimumMastery)return{matched:!1};let l=(n.masteryCount??0)+1;return{matched:l>=(e.requiredCount??1),masteryCount:l}}return{matched:o(e,t)}},c=(e,t)=>{if(!e||!t)return{};let n=t.getTime(),r=n;e.unlockOnDay!==void 0&&(r=n+(e.unlockOnDay-1)*24*60*60*1e3),e.unlockAfterHours!==void 0&&(r=n+e.unlockAfterHours*60*60*1e3);let i=new Date(r);return{availableAt:i,dueAt:e.dueWithinHours===void 0?void 0:new Date(i.getTime()+e.dueWithinHours*60*60*1e3)}},l=e=>{let t=e.length||1,n=e.filter(e=>e.status===`COMPLETED`).length;return Math.round(n/t*100)},u=(e,t)=>{if(t.isCompleted)return t;let n=new Date,r=t.startedAt??n,i=(n.getTime()-r.getTime())/(1e3*60*60),a=t.xpEarned,{completionRewards:o,streakRule:s}=e;return o?.xpBonus&&(a+=o.xpBonus),s?.hoursWindow!==void 0&&i<=s.hoursWindow&&s.bonusXp&&(a+=s.bonusXp),{...t,xpEarned:a,isCompleted:!0,completedAt:n,lastActivityAt:n}},d=n=>{let r=n?t(n):void 0;return{tracks:e,progress:n&&r?Array.from(r.values()):[]}},f=(e,n)=>{let a=i(e);if(!a)return;let o=t(n),s=o.get(e)??r(n,a);return o.set(e,s),s},p=n=>{let i=n.trackId===void 0?e:e.filter(e=>e.id===n.trackId),a=[],o=n.occurredAt??new Date;for(let e of i){let i=t(n.learnerId),d=i.get(e.id)??r(n.learnerId,e),f=d.startedAt??o,p=d.startedAt===void 0,m=d.steps.map(t=>{if(t.status===`COMPLETED`)return t;let r=e.steps.find(e=>e.id===t.id);if(!r)return t;let{availableAt:i,dueAt:a}=c(r.availability,f);if(i&&o<i||a&&o>a)return{...t,availableAt:i,dueAt:a};let l=s(r.completion,n,t,f);return l.matched?(p=!0,{...t,status:`COMPLETED`,xpEarned:r.xpReward??0,completedAt:o,triggeringEvent:n.name,eventPayload:n.payload,occurrences:l.occurrences??t.occurrences,masteryCount:l.masteryCount??t.masteryCount,availableAt:i,dueAt:a}):((l.occurrences!==void 0||l.masteryCount!==void 0)&&(p=!0),{...t,occurrences:l.occurrences??t.occurrences,masteryCount:l.masteryCount??t.masteryCount,availableAt:i,dueAt:a})});if(!p)continue;let h=m.reduce((e,t)=>e+t.xpEarned,0)+(e.totalXp??0),g={...d,steps:m,xpEarned:h,startedAt:f,lastActivityAt:o,progress:l(m)};m.every(e=>e.status===`COMPLETED`)&&(g=u(e,g)),i.set(e.id,g),a.push(g)}return a};export{f as getProgress,d as listTracks,p as recordEvent};

package/dist/docs/index.js

@@ -0,0 +1 @@
+import"./learning-journey-registry.docblock.js";

package/dist/docs/learning-journey-registry.docblock.js

@@ -0,0 +1 @@
+import{registerDocBlocks as e}from"../libs/contracts/src/docs/registry.js";import"../libs/contracts/src/docs/index.js";e([{id:`docs.learning-journey.registry`,title:`Learning Journey — Example Track Registry`,summary:`Aggregates learning journey example tracks (Studio onboarding, Platform tour, CRM first win, Drills, Ambient Coach, Quest challenges).`,kind:`usage`,visibility:`public`,route:`/docs/learning-journey/registry`,tags:[`learning`,`registry`,`onboarding`],body:"## Tracks\n- `studio_getting_started` (Studio onboarding)\n- `platform_primitives_tour` (Platform primitives)\n- `crm_first_win` (CRM pipeline onboarding)\n- `drills_language_basics` (Drills & SRS)\n- `money_ambient_coach`, `coliving_ambient_coach` (Ambient tips)\n- `money_reset_7day` (Quest/challenge)\n\n## Exports\n- `learningJourneyTracks` — raw specs\n- `onboardingTrackCatalog` — DTOs aligned with onboarding API\n- `mapTrackSpecToDto` — helper to map individual tracks\n\n## Wiring\n- Use with onboarding API contracts:\n  - `learning.onboarding.listTracks`\n  - `learning.onboarding.getProgress`\n  - `learning.onboarding.recordEvent`\n- Intended for registry/adapters in Studio UI or services that surface tracks."}]);

package/dist/index.js

@@ -0,0 +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"./docs/index.js";import{LearningTrackDetailPresentation as u,LearningTrackListPresentation as d,LearningTrackProgressWidgetPresentation as f,learningJourneyPresentations as p}from"./presentations/index.js";export{u as LearningTrackDetailPresentation,d as LearningTrackListPresentation,f as LearningTrackProgressWidgetPresentation,e as crmLearningTracks,s as getProgress,p 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/libs/contracts/src/docs/PUBLISHING.docblock.js

@@ -0,0 +1,76 @@
+import{registerDocBlocks as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
+
+This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
+
+## Release Tracks
+
+| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
+|-------|--------|---------|-----------|------------|----------|
+| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
+| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
+
+## Prerequisites
+
+- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
+- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
+- ✅ For stable releases: \`release\` branch exists and is protected.
+
+## Canary Workflow (Automatic)
+
+Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
+
+1. **Trigger**: Push to \`main\`.
+2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
+3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
+
+### Consuming Canary Builds
+
+To install the latest bleeding-edge version:
+
+\`\`\`bash
+npm install @lssm/lib.contracts@canary
+# or
+bun add @lssm/lib.contracts@canary
+\`\`\`
+
+## Stable Release Workflow (Manual)
+
+Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
+
+1. **Develop on \`main\`**: Create features and fixes.
+2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
+3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
+4. **"Version Packages" PR**:
+   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
+   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
+5. **Merge & Publish**:
+   - Review and merge the "Version Packages" PR.
+   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
+
+### Publishing Steps
+
+1. Ensure all changesets are present on \`main\`.
+2. Merge \`main\` into \`release\`:
+   \`\`\`bash
+   git checkout release
+   git pull origin release
+   git merge main
+   git push origin release
+   \`\`\`
+3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
+4. Merge that PR.
+5. The release is now live on npm!
+
+## Manual Verification (Optional)
+
+Before publishing a new version you can run:
+
+\`\`\`bash
+bun run build:not-apps
+npx npm-packlist --json packages/libs/contracts
+\`\`\`
+
+## Rollback
+
+If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
+`}]);

package/dist/libs/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.js

@@ -0,0 +1,350 @@
+import{registerDocBlocks as e}from"./registry.js";e([{id:`docs.accessibility_wcag_compliance_specs`,title:`Accessibility & WCAG Compliance — **specs.md**`,summary:`> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet **WCAG\xA02.2 AA** (aim for AAA where low‑cost), align with **EN\xA0301\xA0549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React\xA0Native)**.`,kind:`reference`,visibility:`public`,route:`/docs/accessibility_wcag_compliance_specs`,tags:[`accessibility_wcag_compliance_specs`],body:`# Accessibility & WCAG Compliance — **specs.md**
+
+> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet **WCAG\xA02.2 AA** (aim for AAA where low‑cost), align with **EN\xA0301\xA0549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React\xA0Native)**.
+
+---
+
+## 0) Scope & Principles
+
+- **Standards:** WCAG\xA02.2\xA0AA (incl. new 2.2 SCs: Focus Not Obscured, Focus Appearance, Target Size, Dragging Movements, Accessible Authentication, Redundant Entry). EN\xA0301\xA0549 compliance by conformance to WCAG.
+- **Principles:** Perceivable, Operable, Understandable, Robust (POUR).
+- **Rule of ARIA:** “No ARIA is better than bad ARIA.” Prefer native elements.
+- **Definition of Done (DoD):** No Critical/Major a11y issues in CI; keyboard complete; SR (screen reader) smoke test passed; contrasts pass; acceptance criteria below satisfied.
+- **Repo Alignment:** Web apps use **Radix Primitives + shadcn** wrappers centralized in \`packages/lssm/libs/ui-kit-web\`. Prefer those components over per‑app duplicates (\`packages/*/apps/*/src/components/ui\`). When missing, add to \`ui-kit-web\` first, then adopt app‑side.
+
+---
+
+## 1) Design Requirements (Design System & Tokens)
+
+**1.1 Color & Contrast**
+
+- Body text, icons essential to meaning: **≥\xA04.5:1**; large text (≥\xA018.66px regular / 14px bold): **≥\xA03:1**.
+- Interactive states (default/hover/active/disabled/focus) must maintain contrast **≥\xA03:1** against adjacent colors; text within components follows text ratios.
+- Provide light & dark themes with tokens that guarantee minimums. **Never rely solely on color** to convey meaning; pair with text, shape, or icon.
+
+**1.2 Focus Indicators (WCAG\xA02.4.11/12)**
+
+- Every interactive element has a **visible focus** with clear offset; indicator contrast **≥\xA03:1** vs adjacent colors and indicator **area ≥\xA02\xA0CSS\xA0px** thick.
+- Focus **must not be obscured** by sticky headers/footers or scroll containers.
+
+**1.3 Motion & Preferences**
+
+- Respect \`prefers-reduced-motion\`: suppress large parallax, auto‑animations; provide instant alternatives.
+- Avoid motion that could trigger vestibular issues; under PRM, use fade/scale under **150ms**.
+
+**1.4 Target Size (2.5.8)**
+
+- Hit areas **≥\xA024×24\xA0CSS\xA0px** (web) and **≥\xA044×44\xA0dp** (mobile) unless exempt.
+
+**1.5 Typography & Layout**
+
+- Support zoom to **400%** without loss of content/functionality; responsive reflow at **320\xA0CSS\xA0px** width.
+- Maintain clear heading hierarchy (h1…h6), one **h1** per view.
+
+- Repository baseline (Web): default body text uses Tailwind \`text-lg\` (≈18px). As of 2025‑09‑20, the repository bumped all Tailwind typography scale usages by +1 step (e.g., \`text-sm\`→\`text-base\`, \`text-base\`→\`text-lg\`, …, \`text-8xl\`→\`text-9xl\`). For long‑form content, default to \`prose-lg\`.
+- Do not use \`text-xs\` for body copy. Reserve \`text-sm\` only for non‑essential meta (timestamps, fine print) while ensuring contrast and touch targets remain compliant.
+- When increasing font size, ensure line height supports readability. Prefer Tailwind defaults or \`leading-relaxed\`/\`leading-7\` for body text where dense blocks appear.
+
+**1.6 Iconography & Imagery**
+
+- Decorative images: \`alt=""\` or \`aria-hidden="true"\`.
+- Informative images: concise, specific **alt**; complex charts require a **data table or long description**.
+
+---
+
+## 2) Content Requirements (UX Writing)
+
+- Links say **what happens** (avoid “click here”).
+- Buttons start with verbs; avoid ambiguous labels.
+- Form labels are **visible**; placeholders are **not labels**.
+- Error messages: human + programmatic association; avoid color‑only.
+- Authentication: allow **copy/paste**, password managers, and avoid cognitive tests alone (**3.3.7/3.3.8/3.3.9**).
+- Avoid CAPTCHAs that block users; if unavoidable, provide **multiple alternatives** (logic-free).
+
+---
+
+## 3) Engineering Requirements (Web — Next.js/React)
+
+> Use and extend \`packages/lssm/libs/ui-kit-web\` as the default UI surface. It wraps **Radix** primitives with sensible a11y defaults (focus rings, roles, keyboard, ARIA binding). When a gap exists, add it to \`ui-kit-web\` first.
+
+**3.1 Semantics & Landmarks**
+
+- Use native elements: \`<button>\`, \`<a href>\`, \`<label for>\`, \`<fieldset>\`, \`<legend>\`, \`<table>\`, etc.
+- Landmarks per page: \`header\`, \`nav\`, \`main\`, \`aside\`, \`footer\`. Provide a **Skip to main content** link.
+- Provide a **Route Announcer** (\`aria-live="polite"\`) and move focus to page **h1** after navigation.
+
+**3.2 Keyboard**
+
+- All functionality available with keyboard alone. Tab order follows DOM/visual order; **no keyboard traps**.
+- Common bindings:
+  - Space/Enter → activate button; Enter on link;
+  - Esc closes dialogs/menus;
+  - Arrow keys for lists/menus/tablists with **roving tabindex**.
+
+**3.3 Focus Management**
+
+- On route change (Next.js), move focus to the page \`<h1>\` or container and announce via a live region.
+- Dialogs/menus: **trap focus** inside; return focus to invoking control on close.
+- Don’t steal focus except after explicit user action.
+
+**3.4 Forms**
+
+- Each input has a \`<label>\` or \`aria-label\`. Group related inputs with \`<fieldset><legend>\`.
+- Associate errors via \`aria-describedby\` or inline IDs; announce with \`role="alert"\` (assertive only for critical).
+- Provide **autocomplete** tokens for known fields; show **inline validation** and do not block on **onBlur** alone.
+
+**3.5 ARIA Usage**
+
+- Only when needed; match patterns (dialog, menu, combobox, tablist, listbox) per ARIA Authoring Practices.
+- Ensure **name/role/value** are programmatically determinable.
+
+**3.6 Media**
+
+- Videos: **captions**; provide **transcripts** for audio; audio descriptions for essential visual info.
+- No auto‑playing audio. Auto‑playing video must be muted and pausable; provide controls.
+
+**3.7 Tables & Data**
+
+- Use \`<th scope>\` for headers; captions via \`<caption>\`; announce sorting via \`aria-sort\`.
+- Provide CSV/JSON export where charts are primary.
+
+**3.8 Performance & Robustness**
+
+- Avoid content shifts that move focus; reserve space or use skeletons.
+- Maintain accessible names through hydration/SSR; avoid \`dangerouslySetInnerHTML\` where possible.
+
+**3.9 Next.js specifics**
+
+- Use \`next/link\` for navigation; ensure links are **links**, not buttons.
+- \`next/image\` must include **alt** (empty if decorative).
+- Announce route changes with a **global live region** and shift focus to the new view.
+
+**3.10 Accessibility library integration**
+
+- Import \`@lssm/lib.accessibility\` at app root. It auto-imports its \`styles.css\` via the package entry; ensure bundlers keep CSS side effects. If your app tree-shakes CSS, explicitly import the stylesheet once in your root layout:
+
+\`\`\`tsx
+// app/layout.tsx
+import '@lssm/lib.accessibility'; // includes tokens and provider exports
+// or if needed: import '@lssm/lib.accessibility/src/styles.css';
+\`\`\`
+
+- Wrap the app with \`AccessibilityProvider\` and include an element with \`id="main"\` for the skip link target.
+
+---
+
+## 3b) lssm/ui-kit-web — Component Patterns & Defaults
+
+> Source: \`packages/lssm/libs/ui-kit-web/ui/*\`
+
+- **Button/Input/Textarea**: Built‑in \`focus-visible\` rings; ensure visible labels via \`FormLabel\` or \`aria-label\`.
+- **Form** (\`form.tsx\`): \`FormControl\` wires \`aria-invalid\` and \`aria-describedby\` to \`FormMessage\` and \`FormDescription\`. Prefer \`FormMessage\` for inline errors. Add \`role="alert"\` only for critical.
+- **Dialog/Sheet/Dropdown**: Use Radix wrappers for focus‑trap and return‑focus. Provide \`DialogTitle\` + \`DialogDescription\` for name/description.
+- **Select/Combobox**: Prefer \`SelectTrigger\` with visible label; for icon‑only triggers, supply \`aria-label\`. Document examples in each app.
+- **Tabs**: Use \`TabsList\`, \`TabsTrigger\`, \`TabsContent\`; names are programmatically determinable.
+- **Toast/Toaster**: Prefer non‑blocking announcements; map critical to assertive region; include action buttons with clear labels.
+- **Table**: Use \`TableCaption\`; ensure \`TableHead\` cells use proper \`scope\`. Provide \`aria-sort\` on sortable headers.
+- **Utilities to add (repo action)**:
+  - \`SkipLink\` component and pattern in layouts.
+  - \`RouteAnnouncer\` (\`aria-live="polite"\`) and **FocusOnRouteChange** helper.
+  - \`VisuallyHidden\` wrapper (Radix visually-hidden or minimal utility).
+  - \`useReducedMotion\` helper; honor in animated components.
+  - Touch‑size variants (≥44×44) for interactive atoms.
+
+---
+
+## 4) Engineering Requirements (Mobile — Expo/React\xA0Native)
+
+- Set \`accessibilityLabel\`, \`accessibilityHint\`, and \`accessibilityRole\` on touchables.
+- Ensure **hit slop** / min size **≥\xA044×44\xA0dp**.
+- Support Dynamic Type / font scaling; no clipped text at **200%**.
+- Respect **Invert Colors** and **Reduce Motion**; avoid flashing.
+- Group related items with \`accessibilityElements\` ordering; hide decoration with \`accessible={false}\` or \`importantForAccessibility="no-hide-descendants"\` when appropriate.
+- Test with **VoiceOver (iOS)** and **TalkBack (Android)**.
+
+---
+
+## 5) Component Patterns (Acceptance Rules)
+
+**Buttons & Links**
+
+- Use \`<button>\` for actions, \`<a href>\` for navigation. Provide disabled states that are perceivable beyond color.
+
+**Navigation**
+
+- Provide **Skip link**. One primary nav landmark. Indicate current page (\`aria-current="page"\`).
+
+**Menus/Combobox/Autocomplete**
+
+- Follow ARIA patterns: focus moves into list; \`aria-expanded\`, \`aria-controls\`, \`aria-activedescendant\` when applicable; Esc closes; typing filters.
+
+**Modals/Dialogs**
+
+- \`role="dialog"\` or \`alertdialog\` with **label**; focus trapped; background inert; Esc closes; return focus to trigger.
+
+**Tabs**
+
+- \`role="tablist"\`; tabs are in the tab order; arrow keys switch focus; content is \`role="tabpanel"\` with \`aria-labelledby\`.
+
+**Toasts/Notifications**
+
+- Non-critical: \`aria-live="polite"\`; critical: \`role="alert"\` sparingly.
+
+**Infinite Scroll / “Load More”**
+
+- Provide **Load more** control; announce new content to SR; preserve keyboard position.
+
+**Drag & Drop (2.5.7)**
+
+- Provide **non‑drag** alternative (e.g., move up/down buttons).
+
+**Charts & Maps**
+
+- Provide **table alternative** or textual summary; keyboard access to datapoints where interactive.
+
+---
+
+## 6) Testing & CI (Blocking Gates)
+
+**Static & Unit**
+
+- \`eslint-plugin-jsx-a11y\` — error on violations.
+- \`jest-axe\` — unit tests for components.
+
+**Automated Integration**
+
+- \`axe-core\` via Playwright or Cypress on critical flows.
+- \`pa11y-ci\` on key routes; threshold: **0 Critical / 0 Serious** to merge.
+- Lighthouse CI a11y score **≥\xA095** on target pages.
+
+**Manual QA (per release)**
+
+- **Keyboard patrol:** navigate primary flows without mouse.
+- **Screen reader smoke:** NVDA (Windows) or VoiceOver (macOS/iOS) across login, navigation, forms, dialogs.
+- **Zoom & Reflow:** 200–400% & 320\xA0px width.
+- **Color/Contrast check:** tokens in both themes.
+
+**Reporting**
+
+- A11y issues labeled: \`a11y-blocker\`, \`a11y-bug\`, \`a11y-enhancement\` with WCAG ref.
+
+---
+
+## 7) Repository‑Specific Adoption Plan
+
+- Centralize UI usage on \`packages/lssm/libs/ui-kit-web\` and de‑duplicate per‑app \`components/ui\` where feasible.
+- Introduce \`SkipLink\`, \`RouteAnnouncer\`, \`FocusOnRouteChange\`, and \`VisuallyHidden\` in \`ui-kit-web\`. Adopt in app layouts (\`app/layout.tsx\`) first.
+- Add \`useReducedMotion\` and wire into animated components (e.g., \`drawer\`, \`tooltip\`, \`carousel\`).
+- Add touch‑size variants to \`Button\`, \`IconButton\`, \`TabsTrigger\`, toggles.
+- Document Select label patterns and error association in Forms.
+
+---
+
+## 8) Code Snippets
+
+**Skip Link**
+
+\`\`\`html
+<a
+  class="sr-only focus:not-sr-only focus-visible:outline focus-visible:ring-4 focus-visible:ring-offset-2"
+  href="#main"
+  >Skip to main content</a
+>
+<main id="main">…</main>
+\`\`\`
+
+**Dialog (Radix + shadcn/ui) — essentials**
+
+\`\`\`tsx
+// Ensure label, description, focus trap, and return focus on close remain intact
+<Dialog>
+  <DialogTrigger asChild>
+    <button aria-haspopup="dialog">Open settings</button>
+  </DialogTrigger>
+  <DialogContent aria-describedby="settings-desc">
+    <DialogTitle>Settings</DialogTitle>
+    <p id="settings-desc">Update your preferences.</p>
+    <DialogClose asChild>
+      <button>Close</button>
+    </DialogClose>
+  </DialogContent>
+</Dialog>
+\`\`\`
+
+**Form error association**
+
+\`\`\`tsx
+<label htmlFor="email">Email</label>
+<input id="email" name="email" type="email" aria-describedby="email-err" />
+<p id="email-err" role="alert">Enter a valid email.</p>
+\`\`\`
+
+**Route change announcement (Next.js)**
+
+\`\`\`tsx
+// Add once at app root
+<div
+  aria-live="polite"
+  aria-atomic="true"
+  id="route-announcer"
+  className="sr-only"
+/>
+\`\`\`
+
+---
+
+## 9) Exceptions & Waivers
+
+- If a criterion cannot be met, file an issue with: context, attempted alternatives, WCAG reference, impact assessment, and a remediation date. **Temporary waivers only.**
+
+---
+
+## 10) Ownership
+
+- **Design:** maintains token contrast, component specs.
+- **Engineering:** enforces CI gates, implements patterns.
+- **QA:** runs manual checks per release.
+- **PM:** blocks release if AA not met on user‑visible flows.
+
+---
+
+## 11) References (internalize; no external dependency at runtime)
+
+- WCAG\xA02.2 (AA), EN\xA0301\xA0549. ARIA Authoring Practices. Platform HIG (Apple, Material).
+- \`packages/lssm/libs/ui-kit-web\` as the canonical UI source for web.
+
+> **Bottom line:** Shipping means **accessible by default**. We don’t trade a11y for speed; we bake it into speed.
+
+---
+
+## 12) Adoption Status (2025-09-23)
+
+- web-artisan: AccessibilityProvider integrated; sr-only/forced-colors applied; 44x44 targets; forms announce errors; jest-axe and cypress-axe in place.
+- web-strit: AccessibilityProvider integrated; forced-colors, sr-only; forms announce errors; 44x44 targets; contrast tokens and text-scale wired; jest-axe and cypress-axe in place.
+- web-coliving: AccessibilityProvider integrated; forced-colors and focus visibility added; text-scale wired; landing pages converted to \`Section\`/stacks with text-lg defaults; CTA capture standardized; ESLint guard for text-xs in main content; jest-axe and cypress-axe in place. Next: audit icon-only controls and ensure 44x44 targets; add role="alert" where critical.
+
+> CI gates: run eslint a11y, jest-axe on components, and cypress-axe on critical flows per app.
+
+---
+
+## 13) CI Hardening & Visual QA
+
+- Linting: Run eslint with jsx-a11y rules across all web apps; block on violations.
+- Unit: Run jest-axe for ui-kit-web and app-level components.
+- Integration: cypress-axe on key flows (auth, forms, dialogs, tables).
+- Synthetic scans: pa11y-ci on critical pages (0 Critical/Serious policy).
+- Performance/A11y audit: Lighthouse CI with a11y score >= 95 on target routes.
+- Artifacts: Upload pa11y and Lighthouse reports per PR; annotate failures.
+
+### Recent additions (2025-09-26)
+
+- AutocompleteInput (groceries): Upgraded to ARIA combobox pattern with \`aria-controls\`, \`aria-activedescendant\`, \`Escape\`/\`Tab\` handling, and labelled listbox.
+- Cypress a11y tests added for furniture and incidents modules on \`/modules\` and operators flows; checks run axe with critical/serious impacts.
+
+## 14) Accessibility Telemetry (PostHog)
+
+- Events (anonymized): a11y_pref_changed (text_scale, contrast_mode, reduce_motion), a11y_panel_opened.
+- Properties: app, route, previous_value, new_value, timestamp.
+- Dashboards: Adoption over time, per app/route; correlation with reduced bounce on forms.
+- Privacy: No PII; aggregate only.
+`}]);

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

@@ -0,0 +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/schema/README.docblock.js";import"./tech/templates/runtime.docblock.js";import"./tech/workflows/overview.docblock.js";import"./tech/mcp-endpoints.docblock.js";

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

@@ -0,0 +1 @@
+const e=[`markdown`,`application/json`,`application/xml`,`react`];function t(e){if(!e.length)return`/`;let t=e.startsWith(`/`)?e:`/${e}`;return t===`/`?`/`:t.replace(/\/+$/,``)}function n(e,n){if(e.route)return t(e.route);let r=n??`/docs`,i=e.id.replace(/^docs\.?/,``).replace(/\./g,`/`).replace(/\/+/g,`/`);return t(i.startsWith(`/`)?i:`${r}/${i}`)}function r(e,t){return t?`${t}.${e.id}`:e.id}function i(t,n){let i=n?.defaultTargets??e,a=t.version??n?.defaultVersion??1,o=t.stability??n?.defaultStability??`stable`;return{meta:{name:r(t,n?.namespace),version:a,description:t.summary??t.title,tags:t.tags,owners:t.owners,domain:t.domain,stability:o},policy:t.visibility&&t.visibility!==`public`?{flags:[t.visibility]}:void 0,source:{type:`blocknotejs`,docJson:t.body},targets:i}}function a(e,t){let n=e.version??t?.defaultVersion??1,i=e.stability??t?.defaultStability??`stable`;return{meta:{name:r(e,t?.namespace),version:n,stability:i,tags:e.tags,owners:e.owners,description:e.summary??e.title},content:{kind:`markdown`,content:e.body}}}function o(e,t){return e.map(e=>({block:e,route:n(e,t?.routePrefix),descriptor:i(e,t)}))}export{a as docBlockToPresentationSpec,i as docBlockToPresentationV2,o as docBlocksToPresentationRoutes};

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

@@ -0,0 +1 @@
+import{docBlockToPresentationSpec as e,docBlocksToPresentationRoutes as t}from"./presentations.js";var n=class{routes=new Map;constructor(e=[],t){e.forEach(e=>this.register(e,t))}register(e,n){let[r]=t([e],n);return r&&this.routes.set(e.id,r),this}list(){return[...this.routes.values()]}get(e){return this.routes.get(e)}toRouteTuples(){return this.list().map(({route:e,descriptor:t})=>[e,t])}toPresentationSpecs(t){return this.list().map(({block:n})=>e(n,t))}};const r=[`id`,`title`,`body`,`kind`,`visibility`,`route`],i=new n;function a(e){for(let t of e){for(let e of r)if(!t[e])throw Error(`DocBlock ${t.id??`<missing id>`} missing field ${String(e)}`);i.register(t)}}export{n as DocRegistry,i as defaultDocRegistry,a as registerDocBlocks};