@happyvertical/smrt-content 0.57.36 → 0.57.37

package/dist/smrt-knowledge.json

@@ -3,13 +3,13 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-content",
-  "packageVersion": "0.57.36",
+  "packageVersion": "0.57.37",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "5948a02044c5994e34e320ae5de89a9704a101fc5e2cac7921f550a7a77e19f5",
-    "packageJson": "7fb6fab4902fe5489b600b467d2c72a591eb8cb3e79c515308befd25340ec704",
-    "agents": "dffe54f5b13fa274d24056c6dc48179bd3bb4ef93c4e47670651f27b67523826",
+    "manifest": "ca9871fbcd8ec9765de66876e4a9c981ff554daca0241ab8a4bb25874a8876f0",
+    "packageJson": "ae20cff267d3a05d685950b363e540fc8e6e1513e4e41ed4fa6f1328a3c1c5d0",
+    "agents": "86ed635b8720a6e6d6392791696996449419d7458eb5d7ab3d3e11bae9330b28",
     "moduleDoc:agents/content-list.md": "76052be17883252011f074d1988df0c0353c352a18d33e2ba3c28c37e363af01"
   },
   "exports": [
@@ -1406,20 +1406,23 @@
           "type": "foreignKey",
           "required": true,
           "related": "ContentContributor",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The person who sent this in."
         },
         {
           "name": "contributionTypeKey",
           "type": "text",
           "required": true,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of submission it is, such as an article or a letter."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "submitted"
+          "default": "submitted",
+          "description": "Where the submission stands, from submitted to approved, rejected or published."
         },
         {
           "name": "intakeDecision",
@@ -1433,25 +1436,29 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "web"
+          "default": "web",
+          "description": "How it arrived: through the website or by email."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline the contributor gave it."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A short summary of the submission."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text as it was sent in."
         },
         {
           "name": "contributorEmail",
@@ -1463,7 +1470,8 @@
           "name": "contributorName",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The name the contributor gave."
         },
         {
           "name": "threadKey",
@@ -1482,7 +1490,8 @@
           "name": "editorNotes",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Notes from your team about this submission."
         },
         {
           "name": "promotedContentId",
@@ -2092,20 +2101,23 @@
           "name": "email",
           "type": "text",
           "required": true,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The email address the contributor writes in from."
         },
         {
           "name": "name",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The name the contributor goes by."
         },
         {
           "name": "trustLevel",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "standard"
+          "default": "standard",
+          "description": "How far you trust what they send in: standard, trusted or blocked."
         },
         {
           "name": "metadata",
@@ -2422,7 +2434,8 @@
           "type": "foreignKey",
           "required": true,
           "related": "Content",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The piece being corrected."
         },
         {
           "name": "contentVersionId",
@@ -2450,38 +2463,44 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "fact"
+          "default": "fact",
+          "description": "What kind of mistake it fixes: a fact, a safety concern, wording or something else."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the correction stands: a draft, published or retracted."
         },
         {
           "name": "summary",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A short note on what was wrong and how it was fixed."
         },
         {
           "name": "incorrectText",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The wording that was wrong."
         },
         {
           "name": "correctedText",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The wording that replaces it."
         },
         {
           "name": "publicNote",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The note readers see about this correction."
         },
         {
           "name": "metadata",
@@ -2499,7 +2518,8 @@
           "name": "publishedAt",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the correction was made public."
         },
         {
           "name": "createdAt",
@@ -4563,7 +4583,8 @@
           "type": "foreignKey",
           "required": true,
           "related": "Content",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The piece that was reviewed."
         },
         {
           "name": "contentVersionId",
@@ -4577,26 +4598,30 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "custom"
+          "default": "custom",
+          "description": "What the review checked: facts, safety or a custom policy."
         },
         {
           "name": "policyKey",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The policy the piece was checked against."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "pending"
+          "default": "pending",
+          "description": "The outcome: pending, passed, flagged, failed or waived."
         },
         {
           "name": "summary",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A short account of what the review found."
         },
         {
           "name": "findings",
@@ -4608,7 +4633,8 @@
           "name": "reviewer",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who or what carried out the review."
         },
         {
           "name": "metadata",
@@ -4626,7 +4652,8 @@
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When the review was done."
         },
         {
           "name": "updatedAt",
@@ -4967,7 +4994,8 @@
           "name": "type",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of piece this is, such as an article or a document."
         },
         {
           "name": "variant",
@@ -4985,32 +5013,37 @@
           "name": "author",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who wrote this piece."
         },
         {
           "name": "name",
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "A short name used to find this piece in lists."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline readers see."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A one or two sentence summary of the piece."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text of the piece."
         },
         {
           "name": "bodyFormat",
@@ -5022,7 +5055,8 @@
           "name": "publish_date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "The date the piece went out, or is due to go out."
         },
         {
           "name": "url",
@@ -5053,20 +5087,23 @@
           "type": "json",
           "required": false,
           "columnType": "JSON",
-          "default": []
+          "default": [],
+          "description": "Words that group pieces by subject."
         },
         {
           "name": "category",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The one section the piece belongs to, such as news or local."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the piece stands: draft, in review, published or archived."
         },
         {
           "name": "state",
@@ -6175,7 +6212,8 @@
           "name": "type",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of piece this is, such as an article or a document."
         },
         {
           "name": "variant",
@@ -6193,32 +6231,37 @@
           "name": "author",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who wrote this piece."
         },
         {
           "name": "name",
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "A short name used to find this piece in lists."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline readers see."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A one or two sentence summary of the piece."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text of the piece."
         },
         {
           "name": "bodyFormat",
@@ -6230,7 +6273,8 @@
           "name": "publish_date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "The date the piece went out, or is due to go out."
         },
         {
           "name": "url",
@@ -6261,20 +6305,23 @@
           "type": "json",
           "required": false,
           "columnType": "JSON",
-          "default": []
+          "default": [],
+          "description": "Words that group pieces by subject."
         },
         {
           "name": "category",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The one section the piece belongs to, such as news or local."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the piece stands: draft, in review, published or archived."
         },
         {
           "name": "state",
@@ -7383,7 +7430,8 @@
           "name": "type",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of piece this is, such as an article or a document."
         },
         {
           "name": "variant",
@@ -7401,32 +7449,37 @@
           "name": "author",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who wrote this piece."
         },
         {
           "name": "name",
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "A short name used to find this piece in lists."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline readers see."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A one or two sentence summary of the piece."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text of the piece."
         },
         {
           "name": "bodyFormat",
@@ -7438,7 +7491,8 @@
           "name": "publish_date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "The date the piece went out, or is due to go out."
         },
         {
           "name": "url",
@@ -7469,20 +7523,23 @@
           "type": "json",
           "required": false,
           "columnType": "JSON",
-          "default": []
+          "default": [],
+          "description": "Words that group pieces by subject."
         },
         {
           "name": "category",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The one section the piece belongs to, such as news or local."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the piece stands: draft, in review, published or archived."
         },
         {
           "name": "state",
@@ -8624,27 +8681,31 @@
           "type": "foreignKey",
           "required": true,
           "related": "Content",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The piece this version belongs to."
         },
         {
           "name": "version",
           "type": "integer",
           "required": true,
           "columnType": "INTEGER",
-          "default": 1
+          "default": 1,
+          "description": "The number of this version, counting up from one."
         },
         {
           "name": "kind",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "manual"
+          "default": "manual",
+          "description": "Why the version was saved: a draft, a review, a publication or a correction."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline as it was in this version."
         },
         {
           "name": "description",
@@ -8662,13 +8723,15 @@
           "name": "status",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Where the piece stood when this version was saved."
         },
         {
           "name": "summary",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A short note on what changed in this version."
         },
         {
           "name": "snapshot",
@@ -8692,7 +8755,8 @@
           "name": "createdAt",
           "type": "text",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "When this version was saved."
         },
         {
           "name": "updatedAt",
@@ -9092,7 +9156,8 @@
           "name": "type",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of piece this is, such as an article or a document."
         },
         {
           "name": "variant",
@@ -9110,32 +9175,37 @@
           "name": "author",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who wrote this piece."
         },
         {
           "name": "name",
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "A short name used to find this piece in lists."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline readers see."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A one or two sentence summary of the piece."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text of the piece."
         },
         {
           "name": "bodyFormat",
@@ -9147,7 +9217,8 @@
           "name": "publish_date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "The date the piece went out, or is due to go out."
         },
         {
           "name": "url",
@@ -9178,20 +9249,23 @@
           "type": "json",
           "required": false,
           "columnType": "JSON",
-          "default": []
+          "default": [],
+          "description": "Words that group pieces by subject."
         },
         {
           "name": "category",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The one section the piece belongs to, such as news or local."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the piece stands: draft, in review, published or archived."
         },
         {
           "name": "state",
@@ -13775,7 +13849,7 @@
     "polymorphicAssociations": 0,
     "uuidColumns": 116
   },
-  "agentDoc": "# @happyvertical/smrt-content\n\nSTI content management with governance workflows, contribution intake, AI reviews, fact-checking, corrections, versioning, transparency reports, and thumbnail generation.\n\n## Modules\n\nPer-module semantics live in sibling module docs — read the one for the module\nyou are editing. This file keeps what holds across the package.\n\n| Module | Scope | Module doc |\n|---|---|---|\n| `src/svelte/content-list-*.ts` + `components/ContentList.svelte` | the shared list adapter (#2451), server-backed queries over `POST /api/v1/contents/query` (#2452), shareable URL state, and saved views | [agents/content-list.md](agents/content-list.md) |\n\n## Models\n\n- **Content** (STI base): `type`, `variant` (generator:domain:specific format), `status` (published/draft/review/archived/deleted), `state`, `category` (hierarchical path with `/` separator), `metadata` JSON, `tags` array, `thumbnailAssetId`\n- **Article**, **ContentDocument**, **Mirror**: STI subclasses — all share `contents` table via `_meta_type`\n- **ContentReview**: AI review result tied to a governance policy. Fields: `contentId`, `policyKey`, `kind`, `status` (accepted/flagged/rejected), `findings`, `fingerprint`, `metadata`\n- **ContentCorrection**: Post-publication change record. Fields: `contentId`, `type` (correction/retraction/update/clarification), `summary`, `note`, `status`, `metadata`\n- **ContentVersion**: Content snapshot. Fields: `contentId`, `kind` (manual/draft/review/publication/correction/auto-generated), `versionNumber`, `summary`, `metadata` (includes `transparency` for publication versions)\n- **ContentReference**: Junction model for content-to-content links (`content_references` table). Nullable `targetVersion` pins a citation to a specific `ContentVersion.version` for drift detection.\n- **ContentGovernancePolicy**: Persisted review policy (key, label, kind, instructions)\n- **ContentGovernanceProfile**: Persisted review profile (key, label, requirements array)\n- **ContentGovernanceAssignment**: Governs content type/variant → profile mapping, feature flags\n- **ContentContribution**: Held inbound submission with status lifecycle (submitted → approved/rejected/withdrawn → promoted)\n- **ContentContributor**: Contributor profile resolved by email, with trust level (standard/trusted/blocked)\n- **ContentContributionType**: Configures intake channels, rules, and promotion mapping. Keyed per tenant (`tenant_id`, `key`); NULL-tenant rows are the global defaults each tenant can override by key\n- **ContentContributionRevision**: Revision history for held submissions\n- **ContentContributionAttachment**: Held file metadata; becomes an `Asset` on promotion\n\n## Contents Collection\n\n| Method | Purpose |\n|--------|---------| \n| `mirror({ url })` | Downloads URL content, extracts text, creates `type: 'mirror'`. Idempotent. |\n| `syncContentDir({ contentDir })` | Batch exports articles as markdown with YAML frontmatter |\n| `generateMissingThumbnails(options)` | Bulk thumbnail generation for content missing `thumbnailAssetId` |\n| `findWithGlobals(tenantId)` | Returns tenant-specific + global (tenantId=null) content |\n| `getOrUpsert({ slug, context })` | Upsert by slug+context combination |\n| `browseFacts()` | Browse fact catalog linked to content |\n| `getGovernanceDefinitionsAction()` | Get all governance policy/profile/assignment definitions |\n| `resolveGovernanceAction({ type, variant })` | Resolve effective governance for a content type |\n\n## Content Instance Methods\n\n| Method | Purpose |\n|--------|---------|\n| `resolveGovernance()` | Resolve effective governance config for this content |\n| `runReviewAction(options)` | Run AI review against a policy; returns `ContentReview` |\n| `listReviews()` | List all reviews for this content |\n| `listReviewProfilesAction()` | Get readiness for all profiles |\n| `evaluateReviewProfile(key)` | Evaluate one profile's requirements |\n| `issueCorrectionAction(options)` | Issue a post-publication correction |\n| `listCorrections()` | List corrections for this content |\n| `listVersions()` | List version history |\n| `mutateVersionAction(options)` | Create a version snapshot |\n| `getPublishedTransparencyAction()` | Get frozen transparency from latest publication version |\n| `previewTransparencyAction()` | Preview live transparency state |\n| `addFact(factId, relationship)` | Link a fact (supports/contradicts/referenced_in) |\n| `getFacts(options)` | Get linked facts |\n| `getFactLinks()` | Get fact-content link records |\n| `getFactsState()` / `syncFactsState(options)` | API-level facts get/sync |\n| `addAsset(asset, relationship, sortOrder)` | Add asset association |\n| `setThumbnail(image)` | Convenience: adds asset + updates `thumbnailAssetId` |\n| `addReference(content, options?)` | Link to another content; `options.targetVersion` pins citation-time `ContentVersion.version` |\n| `getReferences()` | Get content references |\n| `getReferenceDrift()` | Per-edge `{ citedVersion, currentVersion, isDrifted }` for drift detection |\n\n## Governance Workflow\n\n1. `configureContentGovernance({ policies, profiles, assignments })` — static config\n2. Or persist `ContentGovernancePolicy/Profile/Assignment` objects — DB overrides static\n3. Effective config: DB layer merges over static defaults\n4. `content.resolveGovernance()` → `ResolvedContentGovernance` with `isGoverned`, `reviewPolicies`, profile keys, feature flags\n5. `content.runReviewAction()` creates a `ContentReview` with fingerprint for staleness detection\n6. `content.evaluateReviewProfile(key)` checks all requirements\n7. `content.save()` auto-validates publish readiness when `enforcePublishReadiness` is true\n8. Publication auto-creates a `ContentVersion` with frozen transparency data\n\n## Thumbnail Generation\n\nThree strategies via ThumbnailGenerator:\n- **headline-card**: title on branded background (via `@happyvertical/images`)\n- **static-map**: requires `metadata.latitude`/`longitude` (via `@happyvertical/geo`)\n- **ai-generate**: AI image generation (dynamic import of `@happyvertical/ai`)\n\n## Svelte Components\n\n### Content Management\n`ContentList`, `ContentEditor`, `GovernedContentEditor`, `ContentAgentChat`, `ContentTitleField`, `ContentStatusFields`, `ContentMetadataFields`, `ContentReferencesPanel`, `ContentImageBrowser`, `ContentReviewStatusTray`, `ArticleCard`, `ArticleList`, `ImageThumbnail`, `Markdown`\n\nThe editor fields (`ContentTitleField`, `ContentStatusFields`,\n`ContentMetadataFields`, `ContentBodyEditor`) must keep a `name`, an `id`, and\na plain label on every control so they register for agents, and honour\n`mode: 'simple' | 'full'` (+ `fields` allow-list; rules in\n`components/content-field-mode.ts`). `full` stays the default.\n\n### Governance\n`ContentGovernanceManager`, `ContentGovernancePanel`, `ContentGovernancePolicyEditor`, `ContentGovernanceProfileEditor`, `ContentGovernanceAssignmentEditor`, `ContentTransparencyReport`\n\n### Contributions\n`ContentContributionForm`, `ContentContributionInbox`, `ContentContributionPortal`, `ContentContributionTypeManager`, `ContentContributorManager`\n\n## Dev Server\n\n`npm run dev` starts SvelteKit at `localhost:5173` with 4 pages:\n\n- `/` — Content catalog (CRUD, search, filters, card/list views)\n- `/governance` — Policy/profile/assignment management\n- `/contributions` — Inbox, submit form, contributor/type management\n- `/api-explorer` — Browse 69 endpoints with try-it-live for GET\n\nOn startup, `hooks.server.ts` bootstraps schemas for all 13 local classes,\nloads cross-package manifests, and seeds 3 sample content items.\n\n## Chat Integration\n\nContent `GET/POST /api/v1/contents/{id}/chat` endpoint creates\nchat sessions via `@happyvertical/smrt-chat`. Gracefully handles\nmissing chat tables (returns `session: null` with notice).\n`ContentAgentChat` Svelte component provides the UI.\n\nFor global assistant shells, `ContentEditor` and `GovernedContentEditor`\nsupport `onAssistantContextChange`. The callback receives a serializable\n`ContentEditorAssistantContext` plus local editor actions, and still fires when\n`hideChat={true}`. `ContentAgentChat` can be mounted outside the editor with an\n`assistantContext` prop. Server-side consumers can reuse the exported\n`getOrCreateContentEditorChatSession`, `createContentEditorChatThread`,\n`listContentEditorChatThreadMessages`, and\n`sendContentEditorChatThreadMessage` helpers for app-specific tenancy/auth/AI\nroute wiring.\n\nThese handlers go exclusively through the tenant-bound `ChatService` facade\n(S5 #1392) — `getAgentSession`/`findActiveAgentSessions`/`getThread`/\n`listRoomThreads`/`getThreadMessages` for reads and `startThread`/`sendMessage`/\n`sendAgentReply` (internal agent-runtime subpath) for writes. They never reach\ninto the now-`#private` chat collections, so cross-tenant chat state can no\nlonger be selected by raw id before authorization.\n\nThe content-editor session is created with a content-scoped `sessionKey`\n(`contentChatSessionKey(contentId)` → `content:<id>`, S5 #1392). Without it,\n`createAgentSession` reuses ANY active `content_editor` session for the same\nprofile/tenant, so a request about a new content id would reuse — and the\nhandler would rewrite — a session created for a different content and return the\nother content's room/threads. Keying on the content id makes each content get a\ndistinct session/room.\n\n## Relationship Models\n\n- **ContentReference**: SMRT junction model backing `content_references` for content-to-content links\n- **ContentAsset**: dedicated SMRT junction model backing `content_assets` for content-owned asset links\n\n```typescript\nawait content.addAsset(image, 'thumbnail', 0);  // relationship, sortOrder\nawait content.getAssets('attachment');\nawait content.setThumbnail(image);  // convenience: adds asset + updates thumbnailAssetId\nawait content.addReference(otherContent);                            // unpinned\nawait content.addReference(otherContent, { targetVersion: 2 });      // pinned to v2\nawait content.getReferences();\nawait content.getReferenceDrift();  // → [{ targetId, citedVersion, currentVersion, isDrifted }, ...]\n```\n\n## API Contracts\n\n`Content` implements `AssetAssociable` and `MetadataAccessor` (issue #1162). Consumers can type their parameters as `Content` (or the interfaces directly) and rely on the methods existing without `typeof === 'function'` defensive checks:\n\n```typescript\nimport type { AssetAssociable, MetadataAccessor } from '@happyvertical/smrt-content';\n\nasync function attachThumbnail(doc: AssetAssociable, asset: Asset) {\n  await doc.addAsset(asset, 'thumbnail', 0); // contract guaranteed\n}\n\nfunction bumpRevision(doc: MetadataAccessor) {\n  const meta = doc.getMetadata();\n  doc.updateMetadata({ revision: (meta.revision ?? 0) + 1 });\n}\n```\n\n## Category Navigation\n\n`getCategorySegments()`, `getParentCategory()`, `getRootCategory()`, `getAncestorPaths()`, `isInCategory(path, includeChildren?)`\n\n## Prompt Registry\n\nContent prompts are registered with `@happyvertical/smrt-prompts` so tenants can override template/profile/model/params at runtime:\n\n```typescript\nimport {\n  smrtContentReviewPrompt,             // key: 'smrtContent.review'\n  smrtContentApplyCorrectionPrompt,    // key: 'smrtContent.applyCorrection'\n  smrtContentThumbnailAIGeneratePrompt, // key: 'smrtContent.thumbnail.aiGenerate'\n} from '@happyvertical/smrt-content';\n```\n\n`smrtContent.thumbnail.aiGenerate` powers the AI image-generation prompt used by `ThumbnailGenerator` (strategy `'ai-generate'`). Variables substituted into the template: `style`, `title`, `styleHint`, `descriptionClause`. Internal foreign-key fields (`id`, `tenantId`) and the freeform `metadata` blob are intentionally excluded — `metadata` may carry tenant-private configuration or coordinates unrelated to the visual prompt.\n\n## Gotchas\n\n- **STI discriminator**: qualified names like `@happyvertical/smrt-content:Article`\n- **Optional tenancy**: `@TenantScoped({ mode: 'optional' })` — null tenantId = global content\n- **Metadata is primary extension pattern**: use JSON `metadata` field, not additional class fields\n- **Static map coordinates**: uses unary `+` for strict parsing (rejects \"45invalid\" unlike parseFloat)\n- **Review fingerprints**: reviews track content state at review time; stale reviews are detected by fingerprint mismatch\n- **Publish readiness enforcement**: `save()` throws `ValidationError` if blocking requirements aren't met when setting status to `'published'`\n- **Transparency snapshots**: published transparency is frozen into `ContentVersion.metadata.transparency` — use published for public display, preview for editors\n- **Reference pinning**: `ContentReference` is keyed on `(source_id, target_id)`; `targetVersion` is an attribute of the edge, not part of identity. Re-calling `addReference(target, { targetVersion })` updates the pin in place. Unpinned references (`targetVersion: null`) report `isDrifted: false` regardless of how stale the target is — pin them only when you want drift to be detectable.\n- **Generated API routes are not tracked**: everything the vite plugin emits under `src/routes/api/v1` is build output, listed in the bounded `.gitignore` block and regenerated on `npm run dev`. The handwritten handlers beside them (`contents/[id]/chat/**`, `images/**`) stay tracked and linted. Do not commit generated routes — they are not Biome-formatted, so tracking them turns the Lint job red (#2198)\n- **`pnpm typecheck` regenerates package-owned routes safely**: Svelte's analysis may load dependent package Vite configs, but those configs anchor their root to their own package. Content's generated API routes therefore remain under `src/routes/api/v1` and the bounded `.gitignore` block stays stable (#2199).\n- **Tests import generated routes and that is fine**: `contents-api.test.ts` imports `contents/+server.ts` and `contents/[id]/+server.ts` to exercise the generated CRUD handlers against a real SQLite database. The `test` script runs `svelte-kit sync` first, which regenerates the whole route tree, so those files exist by the time Vitest loads — no committed copy needed. Run `pnpm test`, never bare `vitest`, or the imports fail to resolve\n- **`generate:test` exists for the callers that bypass `test`**: `scripts/check-coverage.mjs` runs bare `vitest --coverage`, so without a `generate:test` hook the route imports above fail and the Coverage Gate reports `no coverage produced` rather than a real percentage. It is `cache: false` in `packages/content/turbo.json` — the root task's `outputs` describe core's manifest, so a turbo cache hit would restore nothing and silently skip `svelte-kit sync`\n- **Chat tables**: chat endpoint requires `@happyvertical/smrt-chat` tables; dev server handles missing tables gracefully\n- **Dev server bootstraps all classes**: `hooks.server.ts` generates schemas for all 13 local `@smrt()` classes plus cross-package manifests\n",
+  "agentDoc": "# @happyvertical/smrt-content\n\nSTI content management with governance workflows, contribution intake, AI reviews, fact-checking, corrections, versioning, transparency reports, and thumbnail generation.\n\n## Modules\n\nPer-module semantics live in sibling module docs — read the one for the module\nyou are editing. This file keeps what holds across the package.\n\n| Module | Scope | Module doc |\n|---|---|---|\n| `src/svelte/content-list-*.ts` + `components/ContentList.svelte` | the shared list adapter (#2451), server-backed queries over `POST /api/v1/contents/query` (#2452), shareable URL state, and saved views | [agents/content-list.md](agents/content-list.md) |\n\n## Models\n\n- **Content** (STI base): `type`, `variant` (generator:domain:specific format), `status` (published/draft/review/archived/deleted), `state`, `category` (hierarchical path with `/` separator), `metadata` JSON, `tags` array, `thumbnailAssetId`\n- **Article**, **ContentDocument**, **Mirror**: STI subclasses — all share `contents` table via `_meta_type`\n- **ContentReview**: AI review result tied to a governance policy. Fields: `contentId`, `policyKey`, `kind`, `status` (accepted/flagged/rejected), `findings`, `fingerprint`, `metadata`\n- **ContentCorrection**: Post-publication change record. Fields: `contentId`, `type` (correction/retraction/update/clarification), `summary`, `note`, `status`, `metadata`\n- **ContentVersion**: Content snapshot. Fields: `contentId`, `kind` (manual/draft/review/publication/correction/auto-generated), `versionNumber`, `summary`, `metadata` (includes `transparency` for publication versions)\n- **ContentReference**: Junction model for content-to-content links (`content_references` table). Nullable `targetVersion` pins a citation to a specific `ContentVersion.version` for drift detection.\n- **ContentGovernancePolicy**: Persisted review policy (key, label, kind, instructions)\n- **ContentGovernanceProfile**: Persisted review profile (key, label, requirements array)\n- **ContentGovernanceAssignment**: Governs content type/variant → profile mapping, feature flags\n- **ContentContribution**: Held inbound submission with status lifecycle (submitted → approved/rejected/withdrawn → promoted)\n- **ContentContributor**: Contributor profile resolved by email, with trust level (standard/trusted/blocked)\n- **ContentContributionType**: Configures intake channels, rules, and promotion mapping. Keyed per tenant (`tenant_id`, `key`); NULL-tenant rows are the global defaults each tenant can override by key\n- **ContentContributionRevision**: Revision history for held submissions\n- **ContentContributionAttachment**: Held file metadata; becomes an `Asset` on promotion\n- **Recipe `content.articles`** (`src/recipes.ts`, help in `src/articles.recipe.md`): Articles over the exposed `Content` base narrowed to `type = 'article'` (the `Article` subclass is closed), plus versions, corrections, reviews and contributions for the planner and other catalog hosts. Fields it shows carry `@field({ description })` in plain words; keep them when editing the models.\n\n## Contents Collection\n\n| Method | Purpose |\n|--------|---------| \n| `mirror({ url })` | Downloads URL content, extracts text, creates `type: 'mirror'`. Idempotent. |\n| `syncContentDir({ contentDir })` | Batch exports articles as markdown with YAML frontmatter |\n| `generateMissingThumbnails(options)` | Bulk thumbnail generation for content missing `thumbnailAssetId` |\n| `findWithGlobals(tenantId)` | Returns tenant-specific + global (tenantId=null) content |\n| `getOrUpsert({ slug, context })` | Upsert by slug+context combination |\n| `browseFacts()` | Browse fact catalog linked to content |\n| `getGovernanceDefinitionsAction()` | Get all governance policy/profile/assignment definitions |\n| `resolveGovernanceAction({ type, variant })` | Resolve effective governance for a content type |\n\n## Content Instance Methods\n\n| Method | Purpose |\n|--------|---------|\n| `resolveGovernance()` | Resolve effective governance config for this content |\n| `runReviewAction(options)` | Run AI review against a policy; returns `ContentReview` |\n| `listReviews()` | List all reviews for this content |\n| `listReviewProfilesAction()` | Get readiness for all profiles |\n| `evaluateReviewProfile(key)` | Evaluate one profile's requirements |\n| `issueCorrectionAction(options)` | Issue a post-publication correction |\n| `listCorrections()` | List corrections for this content |\n| `listVersions()` | List version history |\n| `mutateVersionAction(options)` | Create a version snapshot |\n| `getPublishedTransparencyAction()` | Get frozen transparency from latest publication version |\n| `previewTransparencyAction()` | Preview live transparency state |\n| `addFact(factId, relationship)` | Link a fact (supports/contradicts/referenced_in) |\n| `getFacts(options)` | Get linked facts |\n| `getFactLinks()` | Get fact-content link records |\n| `getFactsState()` / `syncFactsState(options)` | API-level facts get/sync |\n| `addAsset(asset, relationship, sortOrder)` | Add asset association |\n| `setThumbnail(image)` | Convenience: adds asset + updates `thumbnailAssetId` |\n| `addReference(content, options?)` | Link to another content; `options.targetVersion` pins citation-time `ContentVersion.version` |\n| `getReferences()` | Get content references |\n| `getReferenceDrift()` | Per-edge `{ citedVersion, currentVersion, isDrifted }` for drift detection |\n\n## Governance Workflow\n\n1. `configureContentGovernance({ policies, profiles, assignments })` — static config\n2. Or persist `ContentGovernancePolicy/Profile/Assignment` objects — DB overrides static\n3. Effective config: DB layer merges over static defaults\n4. `content.resolveGovernance()` → `ResolvedContentGovernance` with `isGoverned`, `reviewPolicies`, profile keys, feature flags\n5. `content.runReviewAction()` creates a `ContentReview` with fingerprint for staleness detection\n6. `content.evaluateReviewProfile(key)` checks all requirements\n7. `content.save()` auto-validates publish readiness when `enforcePublishReadiness` is true\n8. Publication auto-creates a `ContentVersion` with frozen transparency data\n\n## Thumbnail Generation\n\nThree strategies via ThumbnailGenerator:\n- **headline-card**: title on branded background (via `@happyvertical/images`)\n- **static-map**: requires `metadata.latitude`/`longitude` (via `@happyvertical/geo`)\n- **ai-generate**: AI image generation (dynamic import of `@happyvertical/ai`)\n\n## Svelte Components\n\n### Content Management\n`ContentList`, `ContentEditor`, `GovernedContentEditor`, `ContentAgentChat`, `ContentTitleField`, `ContentStatusFields`, `ContentMetadataFields`, `ContentReferencesPanel`, `ContentImageBrowser`, `ContentReviewStatusTray`, `ArticleCard`, `ArticleList`, `ImageThumbnail`, `Markdown`\n\nThe editor fields (`ContentTitleField`, `ContentStatusFields`,\n`ContentMetadataFields`, `ContentBodyEditor`) must keep a `name`, an `id`, and\na plain label on every control so they register for agents, and honour\n`mode: 'simple' | 'full'` (+ `fields` allow-list; rules in\n`components/content-field-mode.ts`). `full` stays the default.\n\n### Governance\n`ContentGovernanceManager`, `ContentGovernancePanel`, `ContentGovernancePolicyEditor`, `ContentGovernanceProfileEditor`, `ContentGovernanceAssignmentEditor`, `ContentTransparencyReport`\n\n### Contributions\n`ContentContributionForm`, `ContentContributionInbox`, `ContentContributionPortal`, `ContentContributionTypeManager`, `ContentContributorManager`\n\n## Dev Server\n\n`npm run dev` starts SvelteKit at `localhost:5173` with 4 pages:\n\n- `/` — Content catalog (CRUD, search, filters, card/list views)\n- `/governance` — Policy/profile/assignment management\n- `/contributions` — Inbox, submit form, contributor/type management\n- `/api-explorer` — Browse 69 endpoints with try-it-live for GET\n\nOn startup, `hooks.server.ts` bootstraps schemas for all 13 local classes,\nloads cross-package manifests, and seeds 3 sample content items.\n\n## Chat Integration\n\nContent `GET/POST /api/v1/contents/{id}/chat` endpoint creates\nchat sessions via `@happyvertical/smrt-chat`. Gracefully handles\nmissing chat tables (returns `session: null` with notice).\n`ContentAgentChat` Svelte component provides the UI.\n\nFor global assistant shells, `ContentEditor` and `GovernedContentEditor`\nsupport `onAssistantContextChange`. The callback receives a serializable\n`ContentEditorAssistantContext` plus local editor actions, and still fires when\n`hideChat={true}`. `ContentAgentChat` can be mounted outside the editor with an\n`assistantContext` prop. Server-side consumers can reuse the exported\n`getOrCreateContentEditorChatSession`, `createContentEditorChatThread`,\n`listContentEditorChatThreadMessages`, and\n`sendContentEditorChatThreadMessage` helpers for app-specific tenancy/auth/AI\nroute wiring.\n\nThese handlers go exclusively through the tenant-bound `ChatService` facade\n(S5 #1392) — `getAgentSession`/`findActiveAgentSessions`/`getThread`/\n`listRoomThreads`/`getThreadMessages` for reads and `startThread`/`sendMessage`/\n`sendAgentReply` (internal agent-runtime subpath) for writes. They never reach\ninto the now-`#private` chat collections, so cross-tenant chat state can no\nlonger be selected by raw id before authorization.\n\nThe content-editor session is created with a content-scoped `sessionKey`\n(`contentChatSessionKey(contentId)` → `content:<id>`, S5 #1392). Without it,\n`createAgentSession` reuses ANY active `content_editor` session for the same\nprofile/tenant, so a request about a new content id would reuse — and the\nhandler would rewrite — a session created for a different content and return the\nother content's room/threads. Keying on the content id makes each content get a\ndistinct session/room.\n\n## Relationship Models\n\n- **ContentReference**: SMRT junction model backing `content_references` for content-to-content links\n- **ContentAsset**: dedicated SMRT junction model backing `content_assets` for content-owned asset links\n\n```typescript\nawait content.addAsset(image, 'thumbnail', 0);  // relationship, sortOrder\nawait content.getAssets('attachment');\nawait content.setThumbnail(image);  // convenience: adds asset + updates thumbnailAssetId\nawait content.addReference(otherContent);                            // unpinned\nawait content.addReference(otherContent, { targetVersion: 2 });      // pinned to v2\nawait content.getReferences();\nawait content.getReferenceDrift();  // → [{ targetId, citedVersion, currentVersion, isDrifted }, ...]\n```\n\n## API Contracts\n\n`Content` implements `AssetAssociable` and `MetadataAccessor` (issue #1162). Consumers can type their parameters as `Content` (or the interfaces directly) and rely on the methods existing without `typeof === 'function'` defensive checks:\n\n```typescript\nimport type { AssetAssociable, MetadataAccessor } from '@happyvertical/smrt-content';\n\nasync function attachThumbnail(doc: AssetAssociable, asset: Asset) {\n  await doc.addAsset(asset, 'thumbnail', 0); // contract guaranteed\n}\n\nfunction bumpRevision(doc: MetadataAccessor) {\n  const meta = doc.getMetadata();\n  doc.updateMetadata({ revision: (meta.revision ?? 0) + 1 });\n}\n```\n\n## Category Navigation\n\n`getCategorySegments()`, `getParentCategory()`, `getRootCategory()`, `getAncestorPaths()`, `isInCategory(path, includeChildren?)`\n\n## Prompt Registry\n\nContent prompts are registered with `@happyvertical/smrt-prompts` so tenants can override template/profile/model/params at runtime:\n\n```typescript\nimport {\n  smrtContentReviewPrompt,             // key: 'smrtContent.review'\n  smrtContentApplyCorrectionPrompt,    // key: 'smrtContent.applyCorrection'\n  smrtContentThumbnailAIGeneratePrompt, // key: 'smrtContent.thumbnail.aiGenerate'\n} from '@happyvertical/smrt-content';\n```\n\n`smrtContent.thumbnail.aiGenerate` powers the AI image-generation prompt used by `ThumbnailGenerator` (strategy `'ai-generate'`). Variables substituted into the template: `style`, `title`, `styleHint`, `descriptionClause`. Internal foreign-key fields (`id`, `tenantId`) and the freeform `metadata` blob are intentionally excluded — `metadata` may carry tenant-private configuration or coordinates unrelated to the visual prompt.\n\n## Gotchas\n\n- **STI discriminator**: qualified names like `@happyvertical/smrt-content:Article`\n- **Optional tenancy**: `@TenantScoped({ mode: 'optional' })` — null tenantId = global content\n- **Metadata is primary extension pattern**: use JSON `metadata` field, not additional class fields\n- **Static map coordinates**: uses unary `+` for strict parsing (rejects \"45invalid\" unlike parseFloat)\n- **Review fingerprints**: reviews track content state at review time; stale reviews are detected by fingerprint mismatch\n- **Publish readiness enforcement**: `save()` throws `ValidationError` if blocking requirements aren't met when setting status to `'published'`\n- **Transparency snapshots**: published transparency is frozen into `ContentVersion.metadata.transparency` — use published for public display, preview for editors\n- **Reference pinning**: `ContentReference` is keyed on `(source_id, target_id)`; `targetVersion` is an attribute of the edge, not part of identity. Re-calling `addReference(target, { targetVersion })` updates the pin in place. Unpinned references (`targetVersion: null`) report `isDrifted: false` regardless of how stale the target is — pin them only when you want drift to be detectable.\n- **Generated API routes are not tracked**: everything the vite plugin emits under `src/routes/api/v1` is build output, listed in the bounded `.gitignore` block and regenerated on `npm run dev`. The handwritten handlers beside them (`contents/[id]/chat/**`, `images/**`) stay tracked and linted. Do not commit generated routes — they are not Biome-formatted, so tracking them turns the Lint job red (#2198)\n- **`pnpm typecheck` regenerates package-owned routes safely**: Svelte's analysis may load dependent package Vite configs, but those configs anchor their root to their own package. Content's generated API routes therefore remain under `src/routes/api/v1` and the bounded `.gitignore` block stays stable (#2199).\n- **Tests import generated routes and that is fine**: `contents-api.test.ts` imports `contents/+server.ts` and `contents/[id]/+server.ts` to exercise the generated CRUD handlers against a real SQLite database. The `test` script runs `svelte-kit sync` first, which regenerates the whole route tree, so those files exist by the time Vitest loads — no committed copy needed. Run `pnpm test`, never bare `vitest`, or the imports fail to resolve\n- **`generate:test` exists for the callers that bypass `test`**: `scripts/check-coverage.mjs` runs bare `vitest --coverage`, so without a `generate:test` hook the route imports above fail and the Coverage Gate reports `no coverage produced` rather than a real percentage. It is `cache: false` in `packages/content/turbo.json` — the root task's `outputs` describe core's manifest, so a turbo cache hit would restore nothing and silently skip `svelte-kit sync`\n- **Chat tables**: chat endpoint requires `@happyvertical/smrt-chat` tables; dev server handles missing tables gracefully\n- **Dev server bootstraps all classes**: `hooks.server.ts` generates schemas for all 13 local `@smrt()` classes plus cross-package manifests\n",
   "moduleDocs": [
     {
       "path": "agents/content-list.md",
@@ -13783,6 +13857,466 @@
       "content": "<!-- Module doc for packages/content/AGENTS.md. -->\n\n# ContentList contracts\n\nRead for changes to `src/svelte/content-list-*.ts`, `ContentList.svelte`, or the\nserver content-query/action adapters. Browser exports come from `/svelte`;\nprincipal-bound query/action factories come from `/server`.\n\n## Ownership and integration\n\n- `content-list-controller.ts` is the shared adapter over `DataTableController`.\n  Search, filters, sort, paging, selection, columns, and action eligibility have\n  one implementation across grid, detailed, and compact presentations. Controller\n  modes are manual. Local arrays use `toContentListRows`, `selectContentListRows`,\n  then `paginateContentListRows`; server rows must never be transformed again.\n- `query`, `urlState`, `savedViews`, `lifecycle`, `jobs`, and `dataSurface` are\n  optional bindings. Without query, rows come from `contents`; with it, contents\n  is ignored. `type` locks/hides the type filter; `defaultViewMode` seeds once.\n  Existing callbacks (`onEdit`, `onDelete`, `onAdd`, `getViewHref`) remain usable.\n- `query.bind()` runs once during component initialization so a structural\n  `remoteQuery(collection, transport)` binding registers teardown in that scope.\n  Do not import smrt-svelte/web or its browser data runtime into the content\n  Svelte barrel: public content pages depend on that code-split boundary.\n- The default query transport targets `POST /api/v1/contents/query`.\n  `CONTENT_LIST_QUERY_FIELDS` maps column IDs to server fields;\n  `ROW_FIELD_TO_CONTENT_KEY` maps response fields to ContentData. For example,\n  column `updated`, client `updatedAt`, and server `updated_at` differ.\n  `publish` maps to `publish_date`. Derived `site` comes from url/source and has\n  no server field; server filtering/sorting on it is dropped and reported.\n- Missing/duplicate durable IDs still render with positional keys but are\n  `identified: false`. Disable and explain their selection controls. Page select\n  all and normalization exclude synthetic IDs; server selection must survive\n  page changes, so current-page membership is not a durability test.\n- Compact uses content-owned `select` and `actions` columns, included in\n  `CONTENT_LIST_TABLE_COLUMN_IDS`. DataTable's generic selection cannot enforce\n  per-row eligibility. Resolve links/actions through the shared adapter.\n\n## Paging and freshness\n\nContentList owns the pager in every presentation and passes no `totalRows` to\nDataTable, whose independent clamp would mutate the shared controller without\nknowing which query produced a count.\n\n- Clamp on the local full-array count or an exact total for the active settled\n  server query only. Never clamp on an estimate, unavailable total, page length,\n  previous-query response, or before the current response arrives. An estimate\n  may still drive the displayed pager. Test paging in grid and compact modes.\n- Resolve one page-size ceiling with `resolveContentListMaxPageSize`: the minimum\n  of configured limits and schema limit (default 200). Use it for controller\n  seed, URL/saved-view sanitizers, translator, and live state. Server seed defaults\n  to 50; null page size becomes the seed and oversized values become the ceiling,\n  with reported drops. Local mode may remain unpaginated. Omitted URL size must\n  restore the server seed. `setPageSize` resets page.\n- Offset only; maximum offset is 1,000,000. Report capping and update the marker\n  to `effectivePage`; retain the notice until the operator leaves that page.\n  Pager maximum is `floor(MAX_OFFSET / pageSize) + 1`, while clamp uses the true\n  total so crafted out-of-range pages receive the explanatory notice.\n- Subscribe after the first request; query changes rebind the exact subscription.\n  Offline retains usable stale rows. Online calls live `reconnect()` (refresh\n  before resubscription), otherwise `refresh()`. Refresh errors are inline over\n  retained rows. Show loading, retry, refreshing, last update, offline, truncation,\n  and warnings across presentations. Read completeness flags from retry envelopes\n  as well as execute envelopes; a successful retry replaces old flags.\n\n## Query authority and protocol\n\n`executeContentQuery()` applies tenancy, failing closed to global rows. Host\napplication scope comes from authenticated context, never request body; caller\nfilters only narrow it. Omitted scope means no extra application restriction;\n`scope: []` means no permitted rows (`id IS NULL`). AND scope into every query\nbranch alongside tenancy. Empty object conditions are configuration errors.\n\nKeep field maps, projectable fields, operator/search vocabulary, and mirrored\nlimits asserted against `buildContentQuerySchema()` and core constants or their\nobservable acceptance boundaries.\n\n- No cursor paging, body queries, metadata-path filters, or ETag/version slot.\n  Read body through GET by ID; use queryFingerprint/freshness.asOf for freshness.\n- Search emits an `any` of `like` over title/description/author, escaping caller\n  `%`/`_`. Drop and report unsupported `notContains`, datetime LIKE operators,\n  invalid datetime inputs, unknown projection fields, and derived site queries.\n- Bound normalized request bytes, including default sort. Always emit sort\n  (fall back to `CONTENT_LIST_QUERY_DEFAULT_SORT`) so client accounting is not\n  smaller than the normalizer's. Limits: 100 list values, 50 filter nodes\n  (containers count; search costs four), 128 DNF branches, 50 projection fields\n  with 1–256-character IDs, 128-character request ID, 4096 UTF-16 units per scalar,\n  100,000 serialized request bytes. Count escapes and surrogate pairs without\n  splitting code points. DNF costs include null unions and De Morgan negation.\n- Preserve comparands exactly or omit/report the filter. Oversized/unusable `in`\n  entries may be removed as a reported subset (`out-of-range`/`unsupported-value`).\n  Never partially apply `notIn`: drop/report `filter-widened`. Shed conjuncts for\n  node/branch/byte budgets with that same report. Shortened LIKE/search patterns\n  report widening; retain leading code points for contains/startsWith and trailing\n  ones for endsWith. Never shorten scalar eq/ne/ordered comparands into a value\n  the caller did not name. Every change is either exact, a reported superset,\n  a reported subset, or a reported omitted predicate.\n- Datetimes require a real calendar day, four-digit year, T separator and an\n  offset when time is present. Date-only means midnight UTC; minutes without\n  seconds and lowercase t/z are accepted. Trim and uppercase before parsing,\n  validate that same string, and calendar-round-trip to reject rolled dates.\n\n### Comparison semantics and dialect limits\n\nFold token filter values (type/status/state); preserve free-text case. Local\ntext comparison is case-insensitive; server free-text matching follows its SQL\noperator/dialect. PostgreSQL/DuckDB LIKE is case-sensitive; SQLite LIKE is ASCII\ncase-insensitive. Do not promise uniform free-text matching.\n\nSQLite's LIKE lacks the default backslash escape used by PostgreSQL/DuckDB;\nescaped wildcards can fail closed there. Fixing portability needs SQL-boundary\nESCAPE support. Null placement is likewise dialect-dependent: local sorts absent\nlast ascending/first descending, matching PostgreSQL/DuckDB; SQLite defaults\noppositely. The query sort grammar cannot express NULLS FIRST/LAST.\n\n- Read absence from original ContentData, not flattened display text. Type's\n  `content` and title's `Untitled content` fallbacks are presentation only; missing\n  values compare/search as null, genuinely blank strings remain present.\n- eq/in/LIKE exclude absent values unless null is explicitly listed. ne of a\n  non-null value and notIn without null include absence. notIn containing null\n  excludes absence. eq/ne null lower to IS NULL/IS NOT NULL. Direct ordered\n  comparisons exclude absence; their negations include it. Every supported\n  predicate and its negation must partition rows without gaps or overlap,\n  including nested all/any and double negation. Negated LIKE is refused.\n- Preserve literal null through sanitization, saved views, translation and local\n  evaluation; only undefined denotes unusable input. Test null, false, zero and\n  empty strings. Blank scalar clears a filter; an empty entry within a list is\n  real text, but a wholly empty list parameter is refused/reported.\n\n## Result budgets\n\nCall `assertContentQuerySchema(schema)` at configuration time. Every executor\nmode, including count, rejects maxResultBytes below\n`CONTENT_QUERY_MIN_RESULT_BYTES`; this is a host error, not caller validation.\n\n- Never drop rows to fit bytes: offset advances by requested limit, so omitted\n  rows would become unreachable. Seat every row's irreducible floor first, then\n  distribute surplus max-min fairly by appetite (cost minus floor).\n  `allocateRowBytes` guarantees a page whenever floors fit; otherwise fail loudly.\n  Preserve `floor <= cost` and refund the final unused array separator at exact\n  byte boundaries.\n- Within rows use one sorted water-filling walk. Strings may shorten; datetime\n  and JSON values are all-or-nothing (null only if smaller). Numbers, booleans,\n  null, and identity never shrink. Prefer shortening free text before losing a\n  format-constrained value; new constrained types are all-or-nothing by default.\n  Report shortening with truncated/warnings.\n- Bound JSON documents before result normalization: strings 65,536 characters,\n  containers 1,000 items, depth 16; finite numbers, no cycles, plain values only.\n  Drop forbidden __proto__/constructor/prototype keys and build with null\n  prototypes. Report truncation rather than allowing one stored document to\n  invalidate an entire page.\n- Facets share the result byte budget; drop excess facet values and flag both\n  facet and result. Per-value caps alone do not bound the envelope.\n\n## URL state and saved views\n\nRead urlState.params once; later onChange(params, state) preserves foreign\nparameters and lets the host own routing. `applyContentListViewState` is the\npublic application boundary: sanitize every patch, including raw saved snapshots,\nthen merge over current state without resetting restored page. Sanitize the patch,\nnot the merged result, because selection is intentionally absent from sanitizer\noutput. Keep raw saved-view payloads so stale-field drops remain reportable.\n\n- Escape list separators and double literal backslashes. List null uses the\n  collision-free `\\0` token; a literal backslash-zero string is doubled. Scalar\n  null serializes through isNull/isNotNull. Preserve foreign parameters by base\n  name, even when they have a known operator suffix; unknown suffixed columns\n  may still be reported as refused without being deleted.\n- The type lock applies to live state, including agent reset/filter commands.\n  Fold it into restored patches to preserve paging. Clear it only on an actual\n  lock-removal transition, not every unlocked render.\n- Toolbar selects must state the live predicate honestly. Unlisted equals values\n  render as extra options and produce a notice. Lists, non-equals operators, and\n  multiple predicates render a disabled summary and notice. Use operator-aware\n  `readContentListSelectFilter`, not value-only `readContentListFilter`.\n  Choosing a real option replaces all filters on that column. Summary sentinel\n  uses U+001F; NUL changes during HTML parsing and breaks hydration.\n- Review is an ordinary status; deleted belongs exclusively to opt-in trash\n  mode. Type options are display vocabulary, not the freeform model domain.\n  Restore/translation refusals appear in one dismissible notice; stale state\n  should still open with the refused parts omitted.\n\n## Shared mutations and lifecycle\n\nHuman transports and agent/bulk callers terminate at the same\n`createContentListActionAdapter()` instance. Preview/apply is principal-bound;\nrendered rows are never mutation authority.\n\n- Supported workflows: trash, draft, review submission, publish, archive, restore,\n  automated review, formatting, categorization, optimization. Applications inject\n  formatting/optimization handlers; handlers mutate supplied objects but must\n  not save them because the adapter owns guarded writes.\n- Explicit/current-page/all-matching selections share a default 200-row cap.\n  Match server and browser maxSelectionSize. All-matching is canonical query,\n  fingerprint and exact count, never browser-page expansion. Above-cap requests\n  fail closed, including forged/agent requests; UI asks the operator to narrow.\n- Read-only preview returns resolved scope/count/labels/eligibility/consequences.\n  Apply uses opaque token and idempotency key, re-resolves query under live\n  principal/tenant, rechecks tool/operation permissions and eligibility, and\n  compares aggregate updated_at revision. Query/count/membership/row drift fails\n  before mutation. Each save also guards updated_at atomically at UPDATE.\n  Required projection: id, title, status, updated_at, even under host overrides.\n- Publication workflows require every snapshot read permission, explicitly\n  including contentassets:read and assets:read. Keep assertions aligned with\n  `ContentVersion.createSnapshot()`; embedded adapters rely on them without RLS.\n- Declare workflowStorage capability. PostgreSQL, SQLite, ordinary DuckDB and\n  non-immediate exported-file modes are supported. JSON default/immediate and\n  DuckDB immediate writes are rejected at setup because exports cannot roll back.\n- Partial results separate accepted/skipped/failed rows; clear only accepted IDs.\n  Failures retain selection. Refresh the exact query and expose progress,\n  exceptions, representative labels, resourceType/resourceId and auditReference.\n\nLifecycle binding enables trash controls; trash mode locks deleted and hides\nordinary status/edit/delete controls. Without it legacy onDelete remains.\n`createContentListLifecycleRoute()` mounts POST /api/v1/contents/lifecycle;\nits host authenticates every native Request and supplies current action context.\nOnly move-to-trash, restore, permanent-delete are accepted; malformed/auth/internal\nfailures use bounded envelopes without private error text.\n\n| Action | Eligible state | Contract |\n|---|---|---|\n| move-to-trash | not deleted | soft deletion |\n| restore | deleted | draft/review/published; recheck permissions and publication readiness |\n| permanent-delete | deleted | type exact server count; irreversible |\n\nPermanent DELETE binds updated_at in PostgreSQL's predicate with transactional\ncascade; embedded adapters compare under the shared write queue before cascade.\nRaces return row_revision_drifted. Empty-trash requires exact server count plus\ncanonical query. Query/selection changes invalidate previews; expiry, stale\nrevision, row/query/count drift or token failures require new preview. Preview,\ninitial apply and replay each get distinct attempt request IDs; apply/replay keep\nconfirmation/idempotency authority, and auditReference identifies original execution.\n\n## Jobs and agent surfaces\n\n- Automated review/formatting/optimization return job IDs. Queue callbacks repeat\n  guarded apply with idempotency. Hosts must provide resolveDeferredPrincipal to\n  re-resolve the complete live persona/TenantAgent binding; absent, mismatched or\n  incomplete bindings fail closed. Authenticated jobStatusPath or client.status\n  keeps identical intents locked while running, reconciles terminal outcomes,\n  and allows failed/cancelled retry. Disable selection during status requests and\n  recheck captured intent before reconciling responses.\n- `createContentListJobController().submit({ actionId, submissionKey, target },\n  start)` coalesces duplicate active keys; rejected submissions stay failed until\n  retry. update(job) cannot regress terminal state. Pending row work disables\n  selection/edit/delete. Only succeeded transitions refresh: row targets require\n  an affected visible row; query targets require the active request key. Failed\n  jobs show error/retry and never masquerade as success.\n- Register dataSurface once at ContentList boundary across presentations and\n  loading/empty/error states. Publish rendered columns plus required id (hidden\n  description stays search-only), explicit fieldName mapping, available operators,\n  query fingerprint/total, normalized selection, presentation and freshness.\n  Derived site becomes read-only in server mode. Expose only mounted executable\n  workflow/lifecycle actions. Context changes advance the same revision stream;\n  stale revisions and disconnected registry commands are refused. set-view\n  acknowledgements describe accepted state before renderer changes.\n- Silent reads use server `createContentListDataSurfaceDefinition({ collection,\n  scope })` in createDataSurfaceTools. Resolve collection/scope from live principal;\n  executeContentQuery owns rows/counts/facets/offset continuation. Exclude tenant,\n  hidden and sensitive fields from discovery/projection. Durable agent mutations\n  use the action adapter, never browser registry authority.\n  An optional `rowCountHint` passes through for `data.discover`; it is shown\n  to every reader, so use a coarse static label, never a per-tenant count.\n\n## Validation\n\nUse package `pnpm test` (which generates routes through SvelteKit sync), never\nbare Vitest. Narrow with `-- <test-file>` to the affected content-list, query,\naction, lifecycle or component tests; include both grid and compact paging\nscenarios for reachability changes. Run package `pnpm typecheck` for Svelte\nchanges and root knowledge checks for this module documentation.\n\n### Hydrated result values\n\nThe query boundary normalizes values against their declared descriptors before\nbyte budgeting. Objects hydrated from text columns become JSON strings and use\nthe existing scalar shortening/warning path; JSON columns retain their document\nlimits. Date-only and timezone-less datetime strings mean UTC, including facet\nbuckets. Bigint values must remain safely representable as JavaScript numbers.\n"
     }
   ],
+  "recipes": [
+    {
+      "id": "content.articles",
+      "className": "ArticlesRecipe",
+      "label": "Articles",
+      "summary": "Write articles, publish them, and keep a record of every change, review and correction.",
+      "synonyms": [
+        "articles",
+        "posts",
+        "blog",
+        "news",
+        "stories",
+        "drafts",
+        "publishing"
+      ],
+      "models": [
+        "@happyvertical/smrt-content:Content",
+        "@happyvertical/smrt-content:ContentVersion",
+        "@happyvertical/smrt-content:ContentCorrection",
+        "@happyvertical/smrt-content:ContentReview",
+        "@happyvertical/smrt-content:ContentContribution",
+        "@happyvertical/smrt-content:ContentContributor"
+      ],
+      "nav": [
+        {
+          "label": "Articles",
+          "model": "@happyvertical/smrt-content:Content",
+          "icon": "fileText",
+          "description": "Every article, from first draft to published.",
+          "key": "articles",
+          "noun": "article",
+          "filter": {
+            "field": "type",
+            "value": "article"
+          }
+        },
+        {
+          "label": "Versions",
+          "model": "@happyvertical/smrt-content:ContentVersion",
+          "icon": "layers",
+          "description": "Each saved state of an article, so nothing is lost.",
+          "noun": "version"
+        },
+        {
+          "label": "Corrections",
+          "model": "@happyvertical/smrt-content:ContentCorrection",
+          "icon": "wrench",
+          "description": "Fixes made to an article after it went out.",
+          "noun": "correction"
+        },
+        {
+          "label": "Reviews",
+          "model": "@happyvertical/smrt-content:ContentReview",
+          "icon": "book",
+          "description": "What the checks found before an article went out.",
+          "noun": "review"
+        },
+        {
+          "label": "Contributions",
+          "model": "@happyvertical/smrt-content:ContentContribution",
+          "icon": "users",
+          "description": "Pieces sent in by readers and outside writers.",
+          "noun": "contribution"
+        }
+      ],
+      "requires": [],
+      "section": {
+        "id": "publish",
+        "label": "Publish",
+        "icon": "fileText",
+        "description": "What you write, record and put out."
+      },
+      "options": {
+        "@happyvertical/smrt-content:Content": {
+          "fields": {
+            "title": {
+              "order": 1
+            },
+            "name": {
+              "label": "Short name",
+              "order": 2
+            },
+            "type": {
+              "label": "Kind",
+              "order": 3,
+              "default": "article"
+            },
+            "status": {
+              "order": 4
+            },
+            "description": {
+              "label": "Summary",
+              "order": 5
+            },
+            "body": {
+              "order": 6
+            },
+            "author": {
+              "order": 7
+            },
+            "publish_date": {
+              "label": "Published on",
+              "order": 8
+            },
+            "category": {
+              "label": "Section",
+              "order": 9
+            },
+            "tags": {
+              "order": 10
+            },
+            "language": {
+              "visibility": "advanced"
+            },
+            "state": {
+              "visibility": "advanced"
+            },
+            "url": {
+              "label": "Web address",
+              "visibility": "advanced"
+            },
+            "source": {
+              "visibility": "advanced"
+            },
+            "original_url": {
+              "label": "Original web address",
+              "visibility": "advanced"
+            },
+            "thumbnailAssetId": {
+              "label": "Picture",
+              "visibility": "advanced"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "variant": {
+              "visibility": "hidden"
+            },
+            "fileKey": {
+              "visibility": "hidden"
+            },
+            "bodyFormat": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-content:ContentVersion": {
+          "fields": {
+            "contentId": {
+              "label": "Article",
+              "order": 1
+            },
+            "version": {
+              "label": "Version number",
+              "order": 2
+            },
+            "kind": {
+              "order": 3
+            },
+            "summary": {
+              "order": 4
+            },
+            "title": {
+              "order": 5
+            },
+            "status": {
+              "order": 6
+            },
+            "createdAt": {
+              "label": "Saved on",
+              "order": 7
+            },
+            "description": {
+              "label": "Summary at the time",
+              "visibility": "advanced"
+            },
+            "body": {
+              "label": "Text at the time",
+              "visibility": "advanced"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "snapshot": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "updatedAt": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-content:ContentCorrection": {
+          "fields": {
+            "contentId": {
+              "label": "Article",
+              "order": 1
+            },
+            "correctionType": {
+              "label": "Kind",
+              "order": 2
+            },
+            "status": {
+              "order": 3
+            },
+            "summary": {
+              "order": 4
+            },
+            "incorrectText": {
+              "label": "What was wrong",
+              "order": 5
+            },
+            "correctedText": {
+              "label": "What it should say",
+              "order": 6
+            },
+            "publicNote": {
+              "label": "Note to readers",
+              "order": 7
+            },
+            "publishedAt": {
+              "label": "Published on",
+              "order": 8
+            },
+            "contentVersionId": {
+              "label": "Version",
+              "visibility": "advanced"
+            },
+            "factId": {
+              "visibility": "hidden"
+            },
+            "replacementFactId": {
+              "visibility": "hidden"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "createdAt": {
+              "visibility": "hidden"
+            },
+            "updatedAt": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-content:ContentReview": {
+          "fields": {
+            "contentId": {
+              "label": "Article",
+              "order": 1
+            },
+            "kind": {
+              "order": 2
+            },
+            "policyKey": {
+              "label": "Policy",
+              "order": 3
+            },
+            "status": {
+              "label": "Outcome",
+              "order": 4
+            },
+            "summary": {
+              "order": 5
+            },
+            "reviewer": {
+              "order": 6
+            },
+            "createdAt": {
+              "label": "Reviewed on",
+              "order": 7
+            },
+            "contentVersionId": {
+              "label": "Version",
+              "visibility": "advanced"
+            },
+            "findings": {
+              "visibility": "hidden"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "updatedAt": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-content:ContentContribution": {
+          "fields": {
+            "title": {
+              "order": 1
+            },
+            "contributorName": {
+              "label": "From",
+              "order": 2
+            },
+            "contributionTypeKey": {
+              "label": "Kind",
+              "order": 3
+            },
+            "status": {
+              "order": 4
+            },
+            "channel": {
+              "label": "Arrived by",
+              "order": 5
+            },
+            "description": {
+              "label": "Summary",
+              "order": 6
+            },
+            "body": {
+              "order": 7
+            },
+            "editorNotes": {
+              "label": "Your notes",
+              "order": 8
+            },
+            "contributorId": {
+              "label": "Contributor",
+              "order": 9
+            },
+            "contributorEmail": {
+              "label": "Email",
+              "visibility": "advanced"
+            },
+            "promotedContentId": {
+              "label": "Published as",
+              "visibility": "advanced"
+            },
+            "intakeDecision": {
+              "visibility": "advanced"
+            },
+            "revisionCount": {
+              "label": "Times revised",
+              "visibility": "advanced"
+            },
+            "threadKey": {
+              "visibility": "hidden"
+            },
+            "sourceMessageId": {
+              "visibility": "hidden"
+            },
+            "approvedAt": {
+              "visibility": "hidden"
+            },
+            "promotedAt": {
+              "visibility": "hidden"
+            },
+            "rejectedAt": {
+              "visibility": "hidden"
+            },
+            "withdrawnAt": {
+              "visibility": "hidden"
+            },
+            "requestedChangesAt": {
+              "visibility": "hidden"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "createdAt": {
+              "visibility": "hidden"
+            },
+            "updatedAt": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-content:ContentContributor": {
+          "fields": {
+            "name": {
+              "order": 1
+            },
+            "email": {
+              "order": 2
+            },
+            "trustLevel": {
+              "label": "Trust",
+              "order": 3
+            },
+            "profileId": {
+              "label": "Person",
+              "visibility": "advanced"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            },
+            "createdAt": {
+              "visibility": "hidden"
+            },
+            "updatedAt": {
+              "visibility": "hidden"
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nArticles is where you write and publish. Each article starts as a draft, can\nbe checked before it goes out, and is published when you are ready. Every time\nan article is published or corrected, a version is saved so nothing is lost.\nFixes made after publication are recorded as corrections readers can see, and\npieces sent in by readers or outside writers wait as contributions until your\nteam has looked at them.\n\n## Tasks\n\n### Write a draft\n\n1. Open the articles and choose **New**.\n2. Type the **{field:Content.title}** and a **{field:Content.name}** to find it by.\n3. Leave the **{field:Content.type}** as article.\n4. Write the **{field:Content.body}** and a short **{field:Content.description}**.\n5. Add the **{field:Content.author}**, a **{field:Content.category}** and any **{field:Content.tags}**.\n6. Save. The **{field:Content.status}** starts as draft, so nobody outside your team sees it yet.\n\n### Publish an article\n\n1. Open the article and set the **{field:Content.publish_date}**.\n2. Change the **{field:Content.status}** to published and save.\n3. If the article still has checks outstanding, the save is refused and tells you what is missing; look at its reviews, fix what they raise and try again.\n\n### See how an article was checked\n\nReviews are made by the checks your publication runs on an article, not by\nhand. Open the reviews to read them.\n\n1. Find the **{field:ContentReview.contentId}** you want and the **{field:ContentReview.kind}** of check.\n2. The **{field:ContentReview.status}** shows the outcome, and the **{field:ContentReview.summary}** says what was found.\n\n### Read an article's history\n\nVersions are saved for you each time an article is published or corrected,\nand when someone saves one on purpose. Open the versions to read them.\n\n1. Find the **{field:ContentVersion.contentId}** and look down the **{field:ContentVersion.version}** numbers.\n2. The **{field:ContentVersion.kind}** says why each one was saved and the **{field:ContentVersion.summary}** what changed.\n3. Open a version to see the **{field:ContentVersion.title}** and **{field:ContentVersion.status}** as they were when the version was saved.\n\n### Issue a correction\n\n1. Open the corrections and choose **New**.\n2. Pick the **{field:ContentCorrection.contentId}** and the **{field:ContentCorrection.correctionType}** of mistake.\n3. Put the old wording in **{field:ContentCorrection.incorrectText}** and the new wording in **{field:ContentCorrection.correctedText}**.\n4. Write a **{field:ContentCorrection.summary}** for your team and a **{field:ContentCorrection.publicNote}** for readers.\n5. Save. The **{field:ContentCorrection.status}** shows whether the correction is still a draft, has been published or was retracted.\n\n### Look at what readers sent in\n\nContributions arrive through your website or by email, not by hand in the\napp. Here you read them and leave notes for your team.\n\n1. Open the contributions and look at the **{field:ContentContribution.title}**, who it is **{field:ContentContribution.contributorName}** and the **{field:ContentContribution.channel}**.\n2. Open one to read the **{field:ContentContribution.body}**.\n3. Add your thoughts in **{field:ContentContribution.editorNotes}** and save.\n4. The **{field:ContentContribution.status}** shows where it stands, from submitted to approved, rejected or published.\n",
+        "fieldRefs": [
+          "Content.author",
+          "Content.body",
+          "Content.category",
+          "Content.description",
+          "Content.name",
+          "Content.publish_date",
+          "Content.status",
+          "Content.tags",
+          "Content.title",
+          "Content.type",
+          "ContentContribution.body",
+          "ContentContribution.channel",
+          "ContentContribution.contributorName",
+          "ContentContribution.editorNotes",
+          "ContentContribution.status",
+          "ContentContribution.title",
+          "ContentCorrection.contentId",
+          "ContentCorrection.correctedText",
+          "ContentCorrection.correctionType",
+          "ContentCorrection.incorrectText",
+          "ContentCorrection.publicNote",
+          "ContentCorrection.status",
+          "ContentCorrection.summary",
+          "ContentReview.contentId",
+          "ContentReview.kind",
+          "ContentReview.status",
+          "ContentReview.summary",
+          "ContentVersion.contentId",
+          "ContentVersion.kind",
+          "ContentVersion.status",
+          "ContentVersion.summary",
+          "ContentVersion.title",
+          "ContentVersion.version"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: node:crypto; documents/spider/files/images/ai SDK graph (crawlee, undici, googleapis, native addons); CJS parse error; and its package depends on @happyvertical/smrt-agents, @happyvertical/smrt-chat, @happyvertical/smrt-images, @happyvertical/smrt-jobs, @happyvertical/smrt-profiles, @happyvertical/smrt-reports, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3615, #3617, #3624, #3625, #3626, #3627, #3628)."
+        ]
+      }
+    }
+  ],
   "browser": {
     "status": "server-only",
     "issues": [