Add CAML interactive article system with published npm packages

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **CAML Interactive Article System** (PR #1156): Full-stack support for corpus articles using CAML (Corpus Article Markup Language). Includes a two-pass parser (tokenizer + block parsers), typed intermediate representation, and composable renderer supporting hero sections, cards, pills, tabs, timelines, CTAs, signup blocks, corpus stats, and pullquotes. Backend adds `MarkdownParser` pipeline component (`opencontractserver/pipeline/parsers/oc_markdown_parser.py`) with `text/markdown` MIME type detection, `text_to_frontmatter` title filter on `DocumentFilter`, and centralized `TEXT_MIMETYPES` constant (`opencontractserver/constants/document_processing.py`). Frontend adds `CamlArticleEditor` modal with live preview, `CorpusArticleView` for rendered article display, and `CorpusLandingView` integration for article discovery. Comprehensive unit tests for parser and `safeHref` XSS guard (34 tests), plus Playwright component tests with `docScreenshot` captures for all block types.
+
+### Fixed
+
+- **CAML YAML parser nested key bug**: Fixed `parseYamlFrontmatter` in `frontend/src/caml/parser/tokenizer.ts` where `content` used `line.trimEnd()` instead of `line.trimEnd().trimStart()`, causing the key-value regex (`^[a-zA-Z_]...`) to fail for indented nested keys (e.g., `hero.kicker`). Nested frontmatter properties were silently dropped, producing empty objects.
+
+### Changed
+
+- **Replaced hardcoded hex colors with OS_LEGAL_COLORS tokens** in `CamlArticleEditor.tsx` and `CorpusArticleView.tsx`: All hardcoded hex values (`#e2e8f0`, `#fafbfc`, `#f8fafc`, `#64748b`, `#94a3b8`, `#ffffff`, `#fef3c7`, `#92400e`, `#475569`, `#f1f5f9`, `#cbd5e1`) replaced with semantic design tokens from `osLegalStyles.ts`.
+- **Extracted `isExternalHref` helper** in `frontend/src/caml/renderer/safeHref.ts`: Deduplicated `href.startsWith("http")` checks across `CamlBlocks.tsx` and `CamlFooter.tsx` into a shared utility function.
+- **Removed redundant `articleStats` useMemo** in `CorpusArticleView.tsx`: The memo mirrored its input without transformation; `stats` is now passed directly to `CamlArticle`.
+
 ### Fixed
 
 - **Annotation rendering cleanup** (Closes #1144): Replaced hardcoded `"4px 4px 0 0"` border-radius with `ANNOTATION_BOUNDARY_RADIUS` constant in `SearchResult.tsx` and `ChatSourceResult.tsx`. Removed dead `border` prop from `SelectionInfo` interface and call sites. Used `APPROVED_RGB` constant for approved-state box-shadow in `SelectionBoundary.tsx` (matching `REJECTED_RGB` pattern). Added `TOKEN_EXPANSION_PX` constant and replaced magic `-1`/`+2` token expansion values across `SelectionTokenGroup.tsx`, `Tokens.tsx`, and `ChatSourceTokens.tsx`. Consolidated `[Previous Unreleased]` CHANGELOG section into single `[Unreleased]` block. Removed debug `console.log` statements from `DocumentKnowledgeBase.ct.tsx`, `SearchResult.tsx`, and `SelectionTokenGroup.tsx`. Moved annotation display reactive var initialization into `useEffect` in `DocumentKnowledgeBaseTestWrapper.tsx`.

config/graphql/document_mutations.py

@@ -157,7 +157,13 @@ def mutate(
             if kind is None:
 
                 if is_plaintext_content(file_bytes):
-                    kind = "text/plain"
+                    # Detect markdown/CAML files by extension
+                    if filename and filename.lower().endswith(
+                        (".caml", ".md", ".markdown")
+                    ):
+                        kind = "text/markdown"
+                    else:
+                        kind = "text/plain"
                 else:
                     return UploadDocument(
                         message="Unable to determine file type", ok=False, document=None

config/graphql/filters.py

@@ -466,6 +466,7 @@ class Meta:
         fields = {
             "description": ["exact", "contains"],
             "id": ["exact"],
+            "title": ["exact", "contains"],
         }