@lssm/lib.contracts-spec 17.3.2

package/dist/node/docs/docs.feature.js

@@ -0,0 +1,365 @@
+import{defineFeature as e}from"../features/index.js";import{DOCS_DOMAIN as n,DOCS_OWNERS as t,DOCS_STABILITY as a,DOCS_TAGS as o}from"./constants.js";export const DocsFeature=e({meta:{key:"platform.docs",version:"1.0.0",title:"Documentation System",description:"Generate, publish, search, and reference contract documentation and DocBlocks",domain:n,owners:t,tags:[...o],stability:a},operations:[{key:"docs.generate",version:"1.0.0"},{key:"docs.publish",version:"1.0.0"},{key:"docs_search",version:"1.0.0"},{key:"docs.contract.reference",version:"1.0.0"}],events:[{key:"docs.generated",version:"1.0.0"},{key:"docs.published",version:"1.0.0"}],presentations:[{key:"docs.layout",version:"1.0.0"},{key:"docs.reference.page",version:"1.0.0"}],capabilities:{provides:[{key:"docs.system",version:"1.0.0"}]},dataViews:[{key:"docs.index.view",version:"1.0.0"},{key:"docs.contract.reference.view",version:"1.0.0"},{key:"docs.examples.catalog.view",version:"1.0.0"}],forms:[{key:"docs_search.form",version:"1.0.0"}]}),DocsSystemDocBlock={id:"docs.tech.docs-system",title:"Docs system overview",summary:"How ContractSpec generates, indexes, and presents documentation.",kind:"reference",visibility:"public",route:"/docs/tech/docs/system",tags:["docs","system","contracts"],body:`# Docs system overview
+
+ContractSpec treats documentation as a first-class output of your specs. The docs system combines contracts, DocBlocks, manifests, and presentations into a consistent docs surface.
+`},accessibility_wcag_compliance_specs_DocBlocks=[{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 2.2 AA** (aim for AAA where low‑cost), align with **EN 301 549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React Native)**.",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 2.2 AA** (aim for AAA where low‑cost), align with **EN 301 549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React Native)**.
+
+---
+
+## 0) Scope & Principles
+
+- **Standards:** WCAG 2.2 AA (incl. new 2.2 SCs: Focus Not Obscured, Focus Appearance, Target Size, Dragging Movements, Accessible Authentication, Redundant Entry). EN 301 549 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: **≥ 4.5:1**; large text (≥ 18.66px regular / 14px bold): **≥ 3:1**.
+- Interactive states (default/hover/active/disabled/focus) must maintain contrast **≥ 3: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 2.4.11/12)**
+
+- Every interactive element has a **visible focus** with clear offset; indicator contrast **≥ 3:1** vs adjacent colors and indicator **area ≥ 2 CSS px** 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 **≥ 24×24 CSS px** (web) and **≥ 44×44 dp** (mobile) unless exempt.
+
+**1.5 Typography & Layout**
+
+- Support zoom to **400%** without loss of content/functionality; responsive reflow at **320 CSS px** 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 Native)
+
+- Set \`accessibilityLabel\`, \`accessibilityHint\`, and \`accessibilityRole\` on touchables.
+- Ensure **hit slop** / min size **≥ 44×44 dp**.
+- 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 **≥ 95** 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 px 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 2.2 (AA), EN 301 549. 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.
+`}],metaDocs=[{id:"docs.meta.docblocks-process",title:"DocBlocks process",summary:"How to author goal/how/usage DocBlocks close to code.",kind:"reference",visibility:"mixed",route:"/docs/meta/docblocks-process",tags:["docs","process"],body:`## DocBlocks authoring rules
+
+- Colocate docs beside implementation; avoid barrel /docs folders.
+- Split intent:
+  - **goal**: why this exists (before implementation).
+  - **how**: operational/runbook steps.
+  - **usage**: quick checklist for consumers.
+- Use \`visibility\`: public | internal | mixed.
+- Prefer routes like \`/docs/<domain>/<topic>/<kind>\`; ids mirror that.
+- Keep body Markdown LLM-friendly; avoid HTML.
+- Add owners/tags/domain/stability when known.
+- For presentations/markdown outputs, rely on TransformEngine via DocRegistry.
+- No sourcePath; DocBlocks are canonical.`}];

package/dist/node/docs/events/docsGenerated.event.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{defineEvent as r}from"../../events.js";import{DOCS_DOMAIN as n,DOCS_OWNERS as o,DOCS_STABILITY as a,DOCS_TAGS as i}from"../constants.js";import{docId as s}from"../registry.js";export const DocsGeneratedPayload=new t({name:"DocsGeneratedPayload",fields:{buildId:{type:e.String_unsecure(),isOptional:!1},version:{type:e.String_unsecure(),isOptional:!0},generatedAt:{type:e.DateTime(),isOptional:!1},outputDir:{type:e.String_unsecure(),isOptional:!0},artifactCount:{type:e.Int_unsecure(),isOptional:!0},warnings:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}}),DocsGeneratedEvent=r({meta:{key:"docs.generated",version:"1.0.0",description:"Emitted when documentation artifacts are generated.",domain:n,owners:o,tags:[...i,"generation"],stability:a,docId:[s("docs.tech.docs-generator")]},payload:DocsGeneratedPayload});

package/dist/node/docs/events/docsPublished.event.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{defineEvent as i}from"../../events.js";import{DOCS_DOMAIN as s,DOCS_OWNERS as n,DOCS_STABILITY as o,DOCS_TAGS as r}from"../constants.js";import{docId as u}from"../registry.js";export const DocsPublishedPayload=new t({name:"DocsPublishedPayload",fields:{publishId:{type:e.String_unsecure(),isOptional:!1},version:{type:e.String_unsecure(),isOptional:!0},environment:{type:e.String_unsecure(),isOptional:!0},url:{type:e.String_unsecure(),isOptional:!0},publishedAt:{type:e.DateTime(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!0},warnings:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}}),DocsPublishedEvent=i({meta:{key:"docs.published",version:"1.0.0",description:"Emitted when documentation is published.",domain:s,owners:n,tags:[...r,"publish"],stability:o,docId:[u("docs.tech.docs-publish")]},payload:DocsPublishedPayload});

package/dist/node/docs/events/index.d.js

@@ -0,0 +1 @@
+export*from"./docsGenerated.event.js";export*from"./docsPublished.event.js";

package/dist/node/docs/events/index.js

@@ -0,0 +1 @@
+export*from"./docsGenerated.event.js";export*from"./docsPublished.event.js";

package/dist/node/docs/forms/docsSearch.form.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as l}from"@lssm/lib.schema";import{defineFormSpec as a}from"../../forms/forms.js";import{DOCS_DOMAIN as i,DOCS_OWNERS as n,DOCS_STABILITY as o,DOCS_TAGS as r}from"../constants.js";import{docId as t}from"../registry.js";const c=new l({name:"DocsSearchFormModel",fields:{query:{type:e.String_unsecure(),isOptional:!0},visibility:{type:e.String_unsecure(),isOptional:!0},kind:{type:e.String_unsecure(),isOptional:!0}}});export const DocsSearchForm=a({meta:{key:"docs_search.form",title:"Docs Search",version:"1.0.0",description:"Search form for documentation discovery.",domain:i,owners:n,tags:[...r,"search"],stability:o,docId:[t("docs.tech.docs-search")]},model:c,fields:[{kind:"text",name:"query",labelI18n:"Search",placeholderI18n:"Search docs"},{kind:"select",name:"visibility",labelI18n:"Visibility",options:{kind:"static",options:[{labelI18n:"Public",value:"public"},{labelI18n:"Internal",value:"internal"},{labelI18n:"Mixed",value:"mixed"}]}},{kind:"select",name:"kind",labelI18n:"Kind",options:{kind:"static",options:[{labelI18n:"Goal",value:"goal"},{labelI18n:"How",value:"how"},{labelI18n:"Usage",value:"usage"},{labelI18n:"Reference",value:"reference"},{labelI18n:"FAQ",value:"faq"},{labelI18n:"Changelog",value:"changelog"}]}}],actions:[{key:"search",labelI18n:"Search"}],policy:{flags:[],pii:[]}});

package/dist/node/docs/forms/index.d.js

@@ -0,0 +1 @@
+export*from"./docsSearch.form.js";

package/dist/node/docs/forms/index.js

@@ -0,0 +1 @@
+export*from"./docsSearch.form.js";

package/dist/node/docs/index.d.js

@@ -0,0 +1 @@
+export*from"./capabilities/index.js";export*from"./commands/index.js";export*from"./constants.js";export*from"./contracts.js";export*from"./docblocks.manifest.generated.js";export*from"./docs.feature.js";export*from"./events/index.js";export*from"./forms/index.js";export*from"./manifest.js";export*from"./presentations.js";export*from"./presentations/index.js";export*from"./queries/index.js";export*from"./registry.js";export*from"./types.js";export*from"./views/index.js";

package/dist/node/docs/index.js

@@ -0,0 +1 @@
+export*from"./capabilities/index.js";export*from"./commands/index.js";export*from"./constants.js";export*from"./contracts.js";export*from"./docblocks.manifest.generated.js";export*from"./docs.feature.js";export*from"./events/index.js";export*from"./forms/index.js";export*from"./manifest.js";export*from"./presentations.js";export*from"./presentations/index.js";export*from"./queries/index.js";export*from"./registry.js";export*from"./types.js";export*from"./views/index.js";

package/dist/node/docs/manifest-builder.js

@@ -0,0 +1 @@
+import b from"node:fs";import y from"node:path";import*as n from"@lssm/lib.typescript-runtime";function x(e){if(!e||typeof e!=="object"||Array.isArray(e))return!1;const i=e;return typeof i.id==="string"&&typeof i.title==="string"&&typeof i.body==="string"}function u(e,i,o){if(n.isParenthesizedExpression(e))return u(e.expression,i,o);if(n.isSatisfiesExpression(e)||n.isAsExpression(e))return u(e.expression,i,o);if(n.isStringLiteral(e)||n.isNoSubstitutionTemplateLiteral(e))return e.text;if(n.isTemplateExpression(e)){let t=e.head.text;for(const r of e.templateSpans){const s=u(r.expression,i,o);if(typeof s!=="string"&&typeof s!=="number"&&typeof s!=="boolean")return;t+=`${s}${r.literal.text}`}return t}if(n.isNumericLiteral(e))return Number(e.text);if(n.isBinaryExpression(e)){const t=u(e.left,i,o),r=u(e.right,i,o);if(t===void 0||r===void 0)return;if(e.operatorToken.kind===n.SyntaxKind.PlusToken){if(typeof t==="number"&&typeof r==="number")return t+r;if((typeof t==="string"||typeof t==="number")&&(typeof r==="string"||typeof r==="number"))return`${t}${r}`}if(e.operatorToken.kind===n.SyntaxKind.SlashToken&&typeof t==="number"&&typeof r==="number")return t/r;return}if(e.kind===n.SyntaxKind.TrueKeyword)return!0;if(e.kind===n.SyntaxKind.FalseKeyword)return!1;if(e.kind===n.SyntaxKind.NullKeyword)return null;if(n.isArrayLiteralExpression(e)){const t=[];for(const r of e.elements){if(n.isSpreadElement(r)){const c=u(r.expression,i,o);if(!Array.isArray(c))return;t.push(...c);continue}const s=u(r,i,o);if(s===void 0)return;t.push(s)}return t}if(n.isObjectLiteralExpression(e)){const t={};for(const r of e.properties){if(!n.isPropertyAssignment(r))return;const s=r.name.getText().replace(/^["']|["']$/g,""),c=u(r.initializer,i,o);if(c===void 0)return;t[s]=c}return t}if(n.isIdentifier(e))return i.get(e.text);if(n.isPropertyAccessExpression(e)){const t=u(e.expression,i,o);if(!t||typeof t!=="object"||Array.isArray(t))return;return t[e.name.text]}if(n.isCallExpression(e)&&n.isIdentifier(e.expression)){if((e.expression.text==="docId"||e.expression.text==="docRef")&&e.arguments.length===1)return u(e.arguments[0],i,o)}if(n.isCallExpression(e)&&n.isPropertyAccessExpression(e.expression)&&e.expression.name.text==="join"&&e.arguments.length<=1){const t=u(e.expression.expression,i,o),r=e.arguments.length===0?",":u(e.arguments[0],i,o);if(!Array.isArray(t)||typeof r!=="string")return;return t.map((s)=>String(s)).join(r)}return}function D(e,i){const o=new Map;for(const t of e.statements){if(!n.isVariableStatement(t))continue;for(const r of t.declarationList.declarations){if(!n.isIdentifier(r.name)||!r.initializer)continue;let s;try{s=u(r.initializer,o,i)}catch{s=void 0}if(s!==void 0)o.set(r.name.text,s)}}return o}function M(e,i,o){let t=e;while(n.isParenthesizedExpression(t)||n.isSatisfiesExpression(t)||n.isAsExpression(t))t=t.expression;if(!n.isObjectLiteralExpression(t))return[];const r=t.properties.find((f)=>n.isPropertyAssignment(f)&&f.name.getText()==="meta");if(!r||!n.isPropertyAssignment(r))return[];let s=r.initializer;while(n.isParenthesizedExpression(s)||n.isSatisfiesExpression(s)||n.isAsExpression(s))s=s.expression;if(!n.isObjectLiteralExpression(s))return[];const c=s.properties.find((f)=>n.isPropertyAssignment(f)&&f.name.getText()==="docId");if(!c||!n.isPropertyAssignment(c))return[];const g=u(c.initializer,i,o);if(!Array.isArray(g)||!g.every((f)=>typeof f==="string"))throw Error(`Non-static DocBlock reference in ${o} at ${c.initializer.getStart()}`);return g}export async function extractModuleDocData(e,i,o,t){const r=t?await t.parse({filePath:i,sourceText:e}):await n.parseTypeScriptSource({filePath:i,sourceText:e}),s=D(r,i),c=[],g=new Set;for(const f of r.statements){if(!n.isVariableStatement(f))continue;if(!f.modifiers?.some((a)=>a.kind===n.SyntaxKind.ExportKeyword))continue;for(const a of f.declarationList.declarations){if(!n.isIdentifier(a.name)||!a.initializer)continue;const d=u(a.initializer,s,i);for(const l of M(a.initializer,s,i))g.add(l);if(d===void 0){if(a.name.text.includes("DocBlock")||a.initializer.getText(r).includes("satisfies DocBlock"))throw Error(`Non-static DocBlock source in ${i} at ${a.initializer.getStart(r)}`);continue}if(x(d))c.push({id:d.id,exportName:a.name.text,sourceModule:o,block:d});if(Array.isArray(d)&&d.every((l)=>x(l)))for(const l of d)c.push({id:l.id,exportName:a.name.text,sourceModule:o,block:l})}}return{entries:c,docRefs:[...g]}}function h(e){return!e.endsWith(".ts")||e.endsWith(".test.ts")||e.endsWith(".generated.ts")||e.includes(`${y.sep}dist${y.sep}`)}function A(e){return b.readdirSync(e,{withFileTypes:!0}).flatMap((i)=>{const o=y.join(e,i.name);if(i.isDirectory())return A(o);return h(o)?[]:[o]}).sort((i,o)=>i.localeCompare(o))}function V(e,i){return y.relative(e,i).replace(/\\/g,"/").replace(/\.ts$/,"")}export async function buildPackageDocManifest(e){const{packageName:i,srcRoot:o,generatedAt:t=new Date().toISOString()}=e,r=A(o);for(const a of r){if(a.endsWith(".docblock.ts"))throw Error(`Standalone DocBlock sources are not allowed: ${a}`);if(a.includes(`${y.sep}docs${y.sep}tech${y.sep}`))throw Error(`docs/tech source files are not allowed: ${a}`)}const s=[],c=new Map,g=new Map,f=new Map,k=new n.TypeScriptSourceParser;try{for(const a of r){const d=b.readFileSync(a,"utf8"),l=V(o,a),E=await extractModuleDocData(d,a,l,k);for(const p of E.entries){const m=`${p.sourceModule}:${p.exportName}`,w=c.get(p.id);if(w)throw Error(`Duplicate DocBlock id ${p.id} in ${m} and ${w}`);c.set(p.id,m);if(p.block.route){const S=g.get(p.block.route);if(S)throw Error(`Duplicate DocBlock route ${p.block.route} in ${m} and ${S}`);g.set(p.block.route,m)}s.push(p)}if(E.docRefs.length>0)f.set(l,E.docRefs)}}finally{await k.close()}for(const[a,d]of f)for(const l of d)if(!c.has(l))throw Error(`Missing DocBlock reference ${l} from ${a}`);s.sort((a,d)=>a.id.localeCompare(d.id));return{packageName:i,generatedAt:t,blocks:s}}

package/dist/node/docs/manifest.js

@@ -0,0 +1 @@
+export function packageDocBlocks(e){return e.blocks.map(({block:c})=>c)}export function workspaceDocBlocks(e){return e.packages.flatMap((c)=>packageDocBlocks(c))}

package/dist/node/docs/presentations/docsLayout.presentation.js

@@ -0,0 +1 @@
+import{definePresentation as o}from"../../presentations/index.js";import{DOCS_DOMAIN as t,DOCS_OWNERS as e,DOCS_STABILITY as s,DOCS_TAGS as a}from"../constants.js";import{docId as c}from"../registry.js";export const DocsLayoutPresentation=o({meta:{key:"docs.layout",title:"Docs Layout",version:"1.0.0",description:"Shared layout shell for documentation pages.",goal:"Provide consistent navigation, layout, and docs UI scaffolding.",context:"Used by web docs surfaces to render DocBlock-based content.",domain:t,owners:e,tags:[...a,"layout"],stability:s,docId:[c("docs.tech.docs-system")]},capability:{key:"docs.system",version:"1.0.0"},source:{type:"component",framework:"react",componentKey:"docsLayout"},targets:["react"]});

package/dist/node/docs/presentations/docsReferencePage.presentation.js

@@ -0,0 +1 @@
+import{definePresentation as e}from"../../presentations/index.js";import{DOCS_DOMAIN as t,DOCS_OWNERS as o,DOCS_STABILITY as r,DOCS_TAGS as c}from"../constants.js";import{docId as n}from"../registry.js";export const DocsReferencePagePresentation=e({meta:{key:"docs.reference.page",title:"Docs Reference Page",version:"1.0.0",description:"Reference page layout for contract documentation.",goal:"Render contract references with consistent metadata and formatting.",context:"Used by docs surfaces to present contract reference content and schemas.",domain:t,owners:o,tags:[...c,"reference"],stability:r,docId:[n("docs.tech.docs-reference")]},capability:{key:"docs.system",version:"1.0.0"},source:{type:"component",framework:"react",componentKey:"docsReferencePage"},targets:["react","markdown"]});

package/dist/node/docs/presentations/index.d.js

@@ -0,0 +1 @@
+export*from"./docsLayout.presentation.js";export*from"./docsReferencePage.presentation.js";

package/dist/node/docs/presentations/index.js

@@ -0,0 +1 @@
+export*from"./docsLayout.presentation.js";export*from"./docsReferencePage.presentation.js";

package/dist/node/docs/presentations.js

@@ -0,0 +1 @@
+const s=["markdown","react"];function o(t){if(!t.length)return"/";const e=t.startsWith("/")?t:`/${t}`;return e==="/"?"/":e.replace(/\/+$/,"")}function a(t,e){if(t.route)return o(t.route);const n=e??"/docs",r=t.id.replace(/^docs\.?/,"").replace(/\./g,"/").replace(/\/+/g,"/"),i=r.startsWith("/")?r:`${n}/${r}`;return o(i)}function c(t,e){return e?`${e}.${t.id}`:t.id}export function docBlockToPresentationSpec(t,e){const n=e?.defaultTargets??s,r=t.version??e?.defaultVersion??"1.0.0",i=t.stability??e?.defaultStability??"stable";return{meta:{key:c(t,e?.namespace),title:t.title,version:r,description:t.summary??t.title,tags:t.tags||[],owners:t.owners||[],domain:t.domain||"",stability:i,goal:`Documentation of: ${t.summary}`,context:"Auto-generated"},policy:t.visibility&&t.visibility!=="public"?{flags:[t.visibility]}:void 0,source:{type:"blocknotejs",docJson:t.body},targets:n}}export function docBlocksToPresentationRoutes(t,e){return t.map((n)=>({block:n,route:a(n,e?.routePrefix),descriptor:docBlockToPresentationSpec(n,e)}))}export function docBlocksToPresentationSpecs(t,e){return t.map((n)=>docBlockToPresentationSpec(n,e))}export function mapDocRoutes(t){return t.map(({route:e,descriptor:n})=>[e,n])}

package/dist/node/docs/queries/contractReference.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{defineQuery as r}from"../../operations/index.js";import{DOCS_DOMAIN as n,DOCS_OWNERS as o,DOCS_STABILITY as c,DOCS_TAGS as i}from"../constants.js";import{docId as s}from"../registry.js";export const ContractReferenceInput=new t({name:"ContractReferenceInput",fields:{key:{type:e.String_unsecure(),isOptional:!1},version:{type:e.String_unsecure(),isOptional:!0},type:{type:e.String_unsecure(),isOptional:!0},format:{type:e.String_unsecure(),isOptional:!0},includeSchema:{type:e.Boolean(),isOptional:!0}}}),ContractReferenceModel=new t({name:"ContractReference",fields:{key:{type:e.String_unsecure(),isOptional:!1},version:{type:e.String_unsecure(),isOptional:!1},type:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!0},description:{type:e.String_unsecure(),isOptional:!0},markdown:{type:e.String_unsecure(),isOptional:!0},route:{type:e.String_unsecure(),isOptional:!0},schema:{type:e.JSONObject(),isOptional:!0},policy:{type:e.JSONObject(),isOptional:!0},tags:{type:e.String_unsecure(),isOptional:!0,isArray:!0},owners:{type:e.String_unsecure(),isOptional:!0,isArray:!0},stability:{type:e.String_unsecure(),isOptional:!0}}}),ContractReferenceOutput=new t({name:"ContractReferenceOutput",fields:{reference:{type:ContractReferenceModel,isOptional:!1}}}),ContractReferenceDocBlock={id:"docs.tech.docs-reference",title:"Contract reference pages",summary:"Resolve any spec into a docs-ready reference payload.",kind:"reference",visibility:"public",route:"/docs/tech/docs/reference",tags:["docs","reference"],body:`# Contract reference
+
+Contract reference pages are generated from spec metadata plus schema details and exposed as a docs-ready payload.
+`},ContractReferenceQuery=r({meta:{key:"docs.contract.reference",title:"Contract Reference",version:"1.0.0",description:"Resolve a contract into a documentation-ready reference.",goal:"Expose a canonical reference view for any ContractSpec surface.",context:"Used by docs generators and UI to render consistent reference pages.",domain:n,owners:o,tags:[...i,"reference"],stability:c,docId:[s("docs.tech.docs-reference")]},capability:{key:"docs.system",version:"1.0.0"},io:{input:ContractReferenceInput,output:ContractReferenceOutput},policy:{auth:"anonymous",pii:[]}});

package/dist/node/docs/queries/docsIndex.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{defineQuery as i}from"../../operations/index.js";import{DOCS_DOMAIN as s,DOCS_OWNERS as o,DOCS_STABILITY as r,DOCS_TAGS as n}from"../constants.js";import{docId as c}from"../registry.js";export const DocSummaryModel=new t({name:"DocSummary",fields:{id:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},summary:{type:e.String_unsecure(),isOptional:!0},route:{type:e.String_unsecure(),isOptional:!0},visibility:{type:e.String_unsecure(),isOptional:!0},kind:{type:e.String_unsecure(),isOptional:!0},version:{type:e.String_unsecure(),isOptional:!0},tags:{type:e.String_unsecure(),isOptional:!0,isArray:!0}}}),DocsIndexInput=new t({name:"DocsIndexInput",fields:{query:{type:e.String_unsecure(),isOptional:!0},tag:{type:e.String_unsecure(),isOptional:!0,isArray:!0},visibility:{type:e.String_unsecure(),isOptional:!0},kind:{type:e.String_unsecure(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0},offset:{type:e.Int_unsecure(),isOptional:!0}}}),DocsIndexOutput=new t({name:"DocsIndexOutput",fields:{items:{type:DocSummaryModel,isOptional:!0,isArray:!0},docs:{type:DocSummaryModel,isOptional:!1,isArray:!0},total:{type:e.Int_unsecure(),isOptional:!0},nextOffset:{type:e.Int_unsecure(),isOptional:!0}}}),DocsIndexDocBlock={id:"docs.tech.docs-search",title:"Docs index and search",summary:"Search DocBlocks by query, tag, kind, or visibility.",kind:"reference",visibility:"public",route:"/docs/tech/docs/search",tags:["docs","search"],body:`# Docs index and search
+
+The docs index is the canonical list of DocBlocks exposed to UI, CLI, and MCP surfaces for filtering and retrieval.
+`},DocsIndexQuery=i({meta:{key:"docs_search",title:"Docs Index",version:"1.0.0",description:"Search and filter DocBlocks by query, tag, or visibility.",goal:"Provide a consistent index of documentation entries for UI and MCP.",context:"Used by docs surfaces to list and filter DocBlocks without coupling to storage.",domain:s,owners:o,tags:[...n,"search","index"],stability:r,docId:[c("docs.tech.docs-search")]},capability:{key:"docs.system",version:"1.0.0"},io:{input:DocsIndexInput,output:DocsIndexOutput},policy:{auth:"anonymous",pii:[]}});

package/dist/node/docs/queries/index.d.js

@@ -0,0 +1 @@
+export*from"./contractReference.query.js";export*from"./docsIndex.query.js";

package/dist/node/docs/queries/index.js

@@ -0,0 +1 @@
+export*from"./contractReference.query.js";export*from"./docsIndex.query.js";

package/dist/node/docs/registry.js

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

package/dist/node/docs/views/contractReference.dataView.js

@@ -0,0 +1 @@
+import{defineDataView as t}from"../../data-views/index.js";import{defineTranslation as i}from"../../translations/index.js";import{DOCS_DOMAIN as e,DOCS_OWNERS as a,DOCS_STABILITY as r,DOCS_TAGS as n}from"../constants.js";import{ContractReferenceQuery as l}from"../queries/contractReference.query.js";import{docId as o}from"../registry.js";const s=i({meta:{key:"docs.contract.reference.view.i18n",version:"1.0.0",domain:e,owners:a},locale:"en",messages:{"field.key.label":{value:"Key"},"field.version.label":{value:"Version"},"field.type.label":{value:"Type"},"field.title.label":{value:"Title"},"field.description.label":{value:"Description"},"field.tags.label":{value:"Tags"},"field.owners.label":{value:"Owners"},"field.stability.label":{value:"Stability"}}});export const ContractReferenceDataView=t(s,{meta:{key:"docs.contract.reference.view",title:"Contract Reference",version:"1.0.0",description:"Detail view for a single contract reference.",domain:e,owners:a,tags:[...n,"reference"],stability:r,entity:"contract-reference",docId:[o("docs.tech.docs-reference")]},source:{primary:{key:l.meta.key,version:l.meta.version}},view:{kind:"detail",fields:[{key:"key",label:"field.key.label",dataPath:"reference.key"},{key:"version",label:"field.version.label",dataPath:"reference.version"},{key:"type",label:"field.type.label",dataPath:"reference.type"},{key:"title",label:"field.title.label",dataPath:"reference.title"},{key:"description",label:"field.description.label",dataPath:"reference.description",format:"markdown"},{key:"tags",label:"field.tags.label",dataPath:"reference.tags"},{key:"owners",label:"field.owners.label",dataPath:"reference.owners"},{key:"stability",label:"field.stability.label",dataPath:"reference.stability"}],primaryField:"title",secondaryFields:["description"]},policy:{flags:[],pii:[]}});

package/dist/node/docs/views/docsIndex.dataView.js

@@ -0,0 +1 @@
+import{defineDataView as a}from"../../data-views/index.js";import{defineTranslation as t}from"../../translations/index.js";import{DOCS_DOMAIN as e,DOCS_OWNERS as i,DOCS_STABILITY as o,DOCS_TAGS as n}from"../constants.js";import{DocsIndexQuery as l}from"../queries/docsIndex.query.js";import{docId as r}from"../registry.js";const d=t({meta:{key:"docs.index.view.i18n",version:"1.0.0",domain:e,owners:i},locale:"en",messages:{"field.id.label":{value:"ID"},"field.title.label":{value:"Title"},"field.summary.label":{value:"Summary"},"field.route.label":{value:"Route"},"field.tags.label":{value:"Tags"},"field.kind.label":{value:"Kind"},"field.visibility.label":{value:"Visibility"},"filter.query.label":{value:"Search"},"filter.visibility.label":{value:"Visibility"},"filter.visibility.option.public":{value:"Public"},"filter.visibility.option.internal":{value:"Internal"},"filter.visibility.option.mixed":{value:"Mixed"},"filter.kind.label":{value:"Kind"},"filter.kind.option.goal":{value:"Goal"},"filter.kind.option.how":{value:"How"},"filter.kind.option.usage":{value:"Usage"},"filter.kind.option.reference":{value:"Reference"},"filter.kind.option.faq":{value:"FAQ"},"filter.kind.option.changelog":{value:"Changelog"}}});export const DocsIndexDataView=a(d,{meta:{key:"docs.index.view",title:"Docs Index",version:"1.0.0",description:"List and filter documentation entries.",domain:e,owners:i,tags:[...n,"index"],stability:o,entity:"docs",docId:[r("docs.tech.docs-search")]},source:{primary:{key:l.meta.key,version:l.meta.version}},view:{kind:"list",fields:[{key:"id",label:"field.id.label",dataPath:"id"},{key:"title",label:"field.title.label",dataPath:"title"},{key:"summary",label:"field.summary.label",dataPath:"summary"},{key:"route",label:"field.route.label",dataPath:"route"},{key:"tags",label:"field.tags.label",dataPath:"tags",format:"badge"},{key:"kind",label:"field.kind.label",dataPath:"kind"},{key:"visibility",label:"field.visibility.label",dataPath:"visibility"}],primaryField:"title",secondaryFields:["summary","route"],filters:[{key:"query",label:"filter.query.label",field:"query",type:"search"},{key:"visibility",label:"filter.visibility.label",field:"visibility",type:"enum",options:[{value:"public",label:"filter.visibility.option.public"},{value:"internal",label:"filter.visibility.option.internal"},{value:"mixed",label:"filter.visibility.option.mixed"}]},{key:"kind",label:"filter.kind.label",field:"kind",type:"enum",options:[{value:"goal",label:"filter.kind.option.goal"},{value:"how",label:"filter.kind.option.how"},{value:"usage",label:"filter.kind.option.usage"},{value:"reference",label:"filter.kind.option.reference"},{value:"faq",label:"filter.kind.option.faq"},{value:"changelog",label:"filter.kind.option.changelog"}]}]},policy:{flags:[],pii:[]}});

package/dist/node/docs/views/exampleCatalog.dataView.js

@@ -0,0 +1,4 @@
+import{defineDataView as t}from"../../data-views/index.js";import{defineTranslation as s}from"../../translations/index.js";import{DOCS_DOMAIN as e,DOCS_OWNERS as a,DOCS_STABILITY as o,DOCS_TAGS as i}from"../constants.js";import{DocsIndexQuery as l}from"../queries/docsIndex.query.js";import{docId as r}from"../registry.js";const m=s({meta:{key:"docs.examples.catalog.view.i18n",version:"1.0.0",domain:e,owners:a},locale:"en",messages:{"field.id.label":{value:"ID"},"field.title.label":{value:"Title"},"field.summary.label":{value:"Summary"},"field.route.label":{value:"Route"},"field.tags.label":{value:"Tags"},"filter.query.label":{value:"Search"},"filter.tags.label":{value:"Tags"},"filter.tags.option.examples":{value:"Examples"},"filter.tags.option.templates":{value:"Templates"},"filter.tags.option.sandbox":{value:"Sandbox"}}});export const ExampleCatalogDocBlock={id:"docs.tech.docs-examples",title:"Examples catalog",summary:"Document and surface example projects with sandbox support.",kind:"reference",visibility:"public",route:"/docs/tech/docs/examples",tags:["docs","examples"],body:`# Examples catalog
+
+Examples are registered as ExampleSpecs and surface DocBlocks for discovery, templates, and sandbox entrypoints.
+`},ExampleCatalogDataView=t(m,{meta:{key:"docs.examples.catalog.view",title:"Examples Catalog",version:"1.0.0",description:"Catalog view of ContractSpec examples and demos.",domain:e,owners:a,tags:[...i,"examples"],stability:o,entity:"docs-examples",docId:[r("docs.tech.docs-examples")]},source:{primary:{key:l.meta.key,version:l.meta.version}},view:{kind:"grid",fields:[{key:"id",label:"field.id.label",dataPath:"id"},{key:"title",label:"field.title.label",dataPath:"title"},{key:"summary",label:"field.summary.label",dataPath:"summary"},{key:"route",label:"field.route.label",dataPath:"route"},{key:"tags",label:"field.tags.label",dataPath:"tags",format:"badge"}],primaryField:"title",secondaryFields:["summary"],filters:[{key:"query",label:"filter.query.label",field:"query",type:"search"},{key:"tags",label:"filter.tags.label",field:"tag",type:"enum",options:[{value:"examples",label:"filter.tags.option.examples"},{value:"templates",label:"filter.tags.option.templates"},{value:"sandbox",label:"filter.tags.option.sandbox"}]}]},policy:{flags:[],pii:[]}});

package/dist/node/docs/views/index.d.js

@@ -0,0 +1 @@
+export*from"./contractReference.dataView.js";export*from"./docsIndex.dataView.js";export*from"./exampleCatalog.dataView.js";

package/dist/node/docs/views/index.js

@@ -0,0 +1 @@
+export*from"./contractReference.dataView.js";export*from"./docsIndex.dataView.js";export*from"./exampleCatalog.dataView.js";

package/dist/node/editions/companyos-scenario.js

@@ -0,0 +1 @@
+import{evaluateEditionConnectGate as F,ManagedCompanyOsConnectReviewPacketFixture as P}from"./connect-gates.js";import{ManagedCompanyOsEditionEditorViewFixture as s}from"./editor/index.js";import{evaluateEditionEnterpriseGuardrails as O,ManagedCompanyOsEnterpriseGuardrailContextFixture as V}from"./enterprise-guardrails.js";import{ManagedCompanyOsEditionExperimentBindingFixture as G,ManagedCompanyOsEditionExperimentMetricsFixture as S,resolveEditionExperimentDashboard as D}from"./experiments.js";import{ManagedCompanyOsDatabaseExperimentEditionFixture as L,ManagedCompanyOsFilePublishedEditionFixture as I}from"./fixtures.js";import{evaluateEditionHarnessCoverage as A,ManagedCompanyOsHarnessReplayEnvelopeFixture as H}from"./harness-evidence.js";import{ManagedCompanyOsImprovementCandidateFixture as q,resolveEditionImprovementLoop as K}from"./improvement.js";import{ManagedCompanyOsCoachSuggestionFixtures as T,resolveEditionCoachWorkflowSurface as j}from"./intelligence-coach.js";import{evaluateEditionKnowledgeReadiness as W,ManagedCompanyOsKnowledgeProvenanceEnvelopeFixture as z}from"./knowledge-provenance.js";import{executeEditionRollback as B,planEditionRollback as _,resolveEditionRollbackView as J}from"./rollback.js";import{createInMemoryDatabaseEditionAdapter as N}from"./storage.js";import{createInMemoryFileEditionAdapter as Q}from"./storage-file.js";import{createInMemoryHybridEditionSyncAdapter as U}from"./storage-hybrid.js";import{validateEditionLifecycle as X}from"./validation.js";export function resolveManagedCompanyOsFullLoopScenario(){const o=I,e=L;w(o);w(e);const n=N([e]),x=Q([o]),y=U(),d=y.materializeDatabaseDraftToFilePatch({databaseEdition:e,fileAdapter:x,baseRef:o.identity.editionId,targetRef:"file-patch:customer-profile:db-experiment-v2",evidenceRefs:["artifact:db-draft-to-file-patch","harness-run:customer-profile-materialization"]});if(!d.patch)throw Error("Managed CompanyOS scenario requires a file patch.");const u=H,i=A({envelope:u,requiredArtifactKinds:["screenshot","dom-snapshot","trace"]}),R=z,a=W({envelope:R,requiredCanonRefs:["canon:companyos:customer-profile"]}),c=P,r=F({packet:c}),v=y.projectFileReleaseToDatabase({fileEdition:o,databaseAdapter:n,databaseEdition:{...e,identity:{...e.identity,state:"published"},evidence:{...e.evidence,compatibilityIntent:"behavior_compatible",promotionEvidenceRefs:["promotion:companyos:db-experiment:approved"],releaseRefs:["release:companyos:2026.06.1"]}},actorRef:"actor:contract-steward",evidenceRefs:["release:companyos:2026.06.1","replay:companyos:file-release-to-db"]}),g=_({edition:e,targetEditionRef:o.identity.editionId,approvalRefs:["approval:companyos:rollback-approved"],harnessRunRefs:["harness-run:customer-profile-rollback"],replayPacketRef:"replay:customer-profile-rollback"}),l=J(g,B(g)),p=j({surfaceRef:"coach-surface:companyos:contract-editions",suggestions:T,minimumConfidence:0.8}),b=V,t=O({context:b}),m=D({experiment:G,activeEdition:e,metrics:S,requiredEvidenceRefs:["connect:companyos:experiment-promotion:permit","harness-run:customer-profile-experiment"]}),f=K({state:{loopRef:"loop:companyos:customer-profile:full-loop",mode:"mixed",stage:"verify",activeEdition:e,scopeRefs:["workspace:managed-companyos"],candidates:[q],historyRefs:["audit:companyos:full-loop:started"]}}),h=n.getAuditEvents(e.identity.editionId).map((E)=>E.eventRef),C=["ontology:companyos:contract-editions","canon:companyos:customer-profile"],k=[{key:"contract-edition.full-loop.dashboard",version:"1.0.0"}],M=Y([...s.evidence.connectVerdictRefs,...s.evidence.harnessRunRefs,...s.evidence.knowledgeProvenanceRefs,...d.evidenceRefs,...v.evidenceRefs,...i.evidenceRefs.harnessRunRefs,...i.evidenceRefs.replayEvidenceRefs,...i.evidenceRefs.artifactRefs,...a.knowledgeProvenanceRefs,...a.canonicalRefs,...c.evidenceRefs,...r.policyDecisionRefs,...p.feedbackEventRefs,...t.auditTrailRefs,...t.redactionRefs,...t.observabilityRefs,...l.preview.requiredEvidenceRefs,...m.promotionReadiness.requiredEvidenceRefs,...f.auditEventRefs]);return{scenarioRef:"scenario:managed-companyos:contract-edition-full-loop",stableFileEdition:o,databaseExperimentEdition:e,editor:s,hybridPatch:d.patch,releaseProjection:v,harnessReplay:u,harnessCoverage:i,knowledgeProvenance:R,knowledgeReadiness:a,connectReviewPacket:c,connectGate:r,coachSurface:p,enterpriseGuardrails:b,enterpriseGuardrailResult:t,experimentDashboard:m,improvementLoop:f,rollback:l,databaseAuditEventRefs:h,canonicalOntologyRefs:C,dataViewRefs:k,evidenceTrailRefs:M,readyForEnterpriseReview:i.ready&&a.ready&&r.allowed&&r.reviewResolved&&p.decisions.every((E)=>E.ready)&&t.ready&&h.length>0&&m.promotionReadiness.ready&&l.execution?.status==="executed"&&f.autonomousActionRefs.length>0}}function w(o){const e=X(o);if(!e.valid)throw Error(`Invalid scenario edition: ${e.issues.map((n)=>n.message).join("; ")}`)}function Y(o){return Array.from(new Set(o))}

package/dist/node/editions/connect-gates.js

@@ -0,0 +1 @@
+export function evaluateEditionConnectGate(e){const i=a(e.packet.intent,e.packet.thresholds),n=d(e.packet),t=r(e.packet.verdict)<=r(i);return{packetRef:e.packet.packetRef,allowed:t&&n.length===0&&(i!=="require_review"||e.packet.escalationRefs.length>0)&&(e.packet.verdict!=="require_review"||e.packet.escalationRefs.length>0),reviewResolved:(i!=="require_review"||e.packet.escalationRefs.length>0)&&(e.packet.verdict!=="require_review"||e.packet.escalationRefs.length>0),verdict:e.packet.verdict,requiredVerdict:i,requiresHumanReview:e.packet.verdict==="require_review"||i==="require_review",missingEvidenceKinds:n,policyDecisionRefs:e.packet.policyDecisionRefs}}export function mergeEditionConnectGates(e){if(!e.packets.length)return{packetRef:"connect:missing",allowed:!1,verdict:"deny",requiredVerdict:"permit",reviewResolved:!1,requiresHumanReview:!0,missingEvidenceKinds:["packet"],policyDecisionRefs:[]};const i=e.packets.map((t)=>evaluateEditionConnectGate({packet:t})),n=i.reduce((t,o)=>r(o.verdict)>r(t.verdict)?o:t);return{packetRef:e.packets.map((t)=>t.packetRef).join("+"),allowed:i.every((t)=>t.allowed),reviewResolved:i.every((t)=>t.reviewResolved),verdict:n.verdict,requiredVerdict:n.requiredVerdict,requiresHumanReview:i.some((t)=>t.requiresHumanReview),missingEvidenceKinds:s(i.flatMap((t)=>t.missingEvidenceKinds)),policyDecisionRefs:s(i.flatMap((t)=>t.policyDecisionRefs))}}export const ManagedCompanyOsConnectReviewPacketFixture={packetRef:"connect:companyos:contract-edition-full-loop:packet",subjectEditionRef:"companyos.customer-profile.db.experiment.v2",intent:"experiment",verdict:"permit",thresholds:{protectedPathWrite:"require_review",unknownImpact:"require_review",contractDrift:"require_review",breakingChange:"require_review",destructiveCommand:"deny"},policyDecisionRefs:["policy-decision:companyos:connect-full-loop"],reviewerRefs:["connect-reviewer:contractspec"],evidenceRefs:["connect:companyos:experiment-promotion:permit","harness-run:companyos:contract-edition-full-loop","knowledge:companyos:customer-profile:canon"],escalationRefs:["approval:companyos:connect-review-resolved"]};function a(e,i){if(e==="breaking")return i.breakingChange??"require_review";if(e==="migration_required")return i.contractDrift??"require_review";return i.unknownImpact??"permit"}function d(e){const i=[];c(i,"policy",e.policyDecisionRefs);c(i,"reviewer",e.reviewerRefs);c(i,"evidence",e.evidenceRefs);if(e.verdict==="require_review")c(i,"escalation",e.escalationRefs);return i}function r(e){return{permit:0,rewrite:1,require_review:2,deny:3}[e]}function c(e,i,n){if(!n.length)e.push(i)}function s(e){return Array.from(new Set(e))}

package/dist/node/editions/delivery-audit.js

@@ -0,0 +1 @@
+export function evaluateEditionDeliveryAudit(e){const i={};for(const t of e.modules){const o=a(t,e.assets);if(o.length)i[t.moduleRef]=o}return{complete:Object.keys(i).length===0,missingByModule:i,moduleRefs:e.modules.map((t)=>t.moduleRef)}}export const EditionFullLoopDeliveryAssets={exportRefs:["@lssm/lib.contracts-spec/editions","@lssm/lib.contracts-spec/editions/editor","@lssm/lib.contracts-spec/editions/storage","@lssm/lib.contracts-spec/editions/storage-file","@lssm/lib.contracts-spec/editions/storage-hybrid","@lssm/lib.contracts-spec/editions/rollback","@lssm/lib.contracts-spec/editions/experiments","@lssm/lib.contracts-spec/editions/improvement","@lssm/lib.contracts-spec/editions/companyos-scenario","@lssm/lib.contracts-spec/editions/harness-evidence","@lssm/lib.contracts-spec/editions/knowledge-provenance","@lssm/lib.contracts-spec/editions/connect-gates","@lssm/lib.contracts-spec/editions/intelligence-coach","@lssm/lib.contracts-spec/editions/enterprise-guardrails","@lssm/lib.contracts-spec/editions/ontology-boundary","@lssm/lib.contracts-spec/editions/evidence-boundary","@lssm/lib.contracts-spec/editions/storage-parity","@lssm/lib.contracts-spec/editions/delivery-audit","@lssm/lib.contracts-spec/editions/full-loop-gate","@lssm/lib.contracts-spec/editions/operation-specs","@lssm/lib.contracts-spec/editions/runtime-wiring","@lssm/example.managed-companyos-contract-editions/example"],testRefs:["test:editor","test:storage","test:storage-file","test:storage-hybrid","test:rollback","test:experiments","test:improvement","test:companyos-scenario","test:harness-evidence","test:knowledge-provenance","test:connect-gates","test:intelligence-coach","test:enterprise-guardrails","test:ontology-boundary","test:evidence-boundary","test:storage-parity","test:delivery-audit","test:full-loop-gate","test:operation-specs","test:runtime-wiring","test:managed-companyos-contract-editions-example"],docRefs:["packages/libs/contracts-spec/src/editions/README.md","packages/examples/managed-companyos-contract-editions/README.md"]},EditionFullLoopDeliveryRecords=[s("editor","ManagedCompanyOsEditionEditorViewFixture"),s("storage","createInMemoryDatabaseEditionAdapter"),s("storage-file","createInMemoryFileEditionAdapter"),s("storage-hybrid","createInMemoryHybridEditionSyncAdapter"),s("rollback","planEditionRollback"),s("experiments","ManagedCompanyOsEditionExperimentBindingFixture"),s("improvement","ManagedCompanyOsImprovementCandidateFixture"),s("companyos-scenario","resolveManagedCompanyOsFullLoopScenario"),s("harness-evidence","ManagedCompanyOsHarnessReplayEnvelopeFixture"),s("knowledge-provenance","ManagedCompanyOsKnowledgeProvenanceEnvelopeFixture"),s("connect-gates","ManagedCompanyOsConnectReviewPacketFixture"),s("intelligence-coach","ManagedCompanyOsCoachSuggestionFixtures"),s("enterprise-guardrails","ManagedCompanyOsEnterpriseGuardrailContextFixture"),s("ontology-boundary","evaluateEditionOntologyBoundary"),s("evidence-boundary","evaluateEditionEvidenceBoundary"),s("storage-parity","evaluateEditionStorageParity"),s("operation-specs","EditionOperationSpecs"),s("runtime-wiring","evaluateEditionRuntimeWiring"),r()];function s(e,i){return{moduleRef:e,contractRefs:[`types:${e}`],runtimeRefs:[`runtime:${i}`],fixtureRefs:[`fixture:${i}`],testRefs:[`test:${e}`],exportRefs:[`@lssm/lib.contracts-spec/editions/${e}`],docRefs:["packages/libs/contracts-spec/src/editions/README.md"]}}function r(){return{moduleRef:"managed-companyos-contract-editions-example",contractRefs:["types:managed-companyos-contract-editions-example"],runtimeRefs:["runtime:resolveManagedCompanyOsEditionsExample"],fixtureRefs:["fixture:ManagedCompanyOsEditionsExample"],testRefs:["test:managed-companyos-contract-editions-example"],exportRefs:["@lssm/example.managed-companyos-contract-editions/example"],docRefs:["packages/examples/managed-companyos-contract-editions/README.md"]}}function a(e,i){const t=[];if(!e.contractRefs.length)t.push("contracts");if(!e.runtimeRefs.length)t.push("runtime");if(!e.fixtureRefs.length)t.push("fixtures");if(!e.testRefs.length)t.push("tests");if(!e.exportRefs.length)t.push("exports");if(!e.docRefs.length)t.push("docs");if(!i)return t;if(!n(e.testRefs,i.testRefs))t.push("available-tests");if(!n(e.exportRefs,i.exportRefs))t.push("available-exports");if(!n(e.docRefs,i.docRefs))t.push("available-docs");return t}function n(e,i){return e.every((t)=>i.includes(t))}