hvp-shared 10.0.0 → 12.0.0

package/dist/constants/document.enums.d.ts

@@ -1,15 +1,9 @@
 /**
  * Document Enums — new document management system (GH#21).
  *
- * Replaces the legacy `documentation.enums.ts` (which keeps serving the legacy
- * `documentations` collection during the 60-day retention window). Do not mix
- * the two — `documentation.*` = legacy, `document.*` = new system.
- *
  * Conventions:
  * - snake_case values per `.claude/rules/enums.md`
  * - `*_LABELS: Record<Enum, string>` Spanish labels alongside each enum
- *
- * @see .claude/plans/active/20260427-GH21-documentation-system-redesign.md
  */
 /**
  * Sentinel value for `audience: WebAppRole[]` meaning "visible to everyone".
@@ -18,35 +12,24 @@
  */
 export declare const AUDIENCE_ALL = "all";
 /**
- * High-level reason a document exists. First axis of the classification
- * (purpose → type → tags). One purpose per audience:
- *
- * - `operational` — staff, day-to-day workflow
- * - `reference`   — staff, consultation / support material
- * - `external`    — public / clients (marketing, communication)
- * - `archive`     — historical records preserved deliberately
+ * Fundamental document nature. Drives lifecycle behavior:
  *
- * Note: `resource` was the previous name of the catch-all bucket. It is
- * deprecated in favor of two narrower purposes (`reference` + `external`)
- * because mixing internal-staff and external-public content under one
- * purpose led to incoherent search filtering. Kept in the enum for legacy
- * data compatibility (migration script will not produce it for new docs).
+ * - `operational` — living doc that evolves; full lifecycle (draft → current →
+ *   outdated → withdrawn); has versions; has elaboratedAt/reviewedAt/
+ *   authorizedAt per version.
+ * - `reference` — singleton authoritative artifact; can be replaced by a newer
+ *   instance (which becomes a separate doc); simpler lifecycle.
+ * - `record` — moment-in-time capture of an unrepeatable event; no real
+ *   lifecycle; just exists.
  */
-export declare enum Purpose {
+export declare enum Category {
     operational = "operational",
     reference = "reference",
-    external = "external",
-    archive = "archive",
-    /** @deprecated Use `reference` (internal staff) or `external` (clients/public) instead. */
-    resource = "resource"
+    record = "record"
 }
-export declare const PURPOSE_LABELS: Record<Purpose, string>;
+export declare const CATEGORY_LABELS: Record<Category, string>;
 /**
- * Specific kind of document within a purpose. Second axis of classification.
- *
- * Mapping of legacy `DocumentationType` is documented in the migration script
- * (`migrate-documentations-to-documents.ts`). Some values exist purely so
- * legacy docs map cleanly (e.g. `meeting_recording` for `admon` videos).
+ * Specific kind of document within a category. Second axis of classification.
  */
 export declare enum DocumentType {
     protocol = "protocol",
@@ -59,29 +42,61 @@ export declare enum DocumentType {
      * Living registry/tracker. The structure is fixed but the data evolves over
      * time (e.g. monthly income tracker, supplier promotional log). Differs from
      * `format` (a template instance is filled once) and from `reference_data`
-     * (typically static reference like catalogs). Added in 9.2.0.
+     * (typically static reference like catalogs).
      */
     control = "control",
     reference_data = "reference_data",
-    training_material = "training_material",
     legal_document = "legal_document",
     brand_asset = "brand_asset",
+    /**
+     * Permits, certifications, fiscal certificates issued by external authorities.
+     * Singletons replaced when re-issued (e.g. CSF SAT, COFEPRIS, MVR cards).
+     */
+    permit = "permit",
     meeting_recording = "meeting_recording",
     historical = "historical",
+    /**
+     * Specific instance of a class/training session (e.g. "Otitis externa 1
+     * con Anahí Fuentes"). Each is its own doc; new courses ≠ new versions.
+     */
+    training_class = "training_class",
+    /**
+     * One-shot presentation tied to a specific event (anniversaries, public
+     * health campaigns).
+     */
+    presentation = "presentation",
+    /**
+     * Promotional or marketing content (videos, banners, campaign materials)
+     * that captures past-event communication. Different from `presentation`
+     * (talk/slide deck) — `marketing` is promotional/external-facing material
+     * preserved as historical record.
+     */
     marketing = "marketing"
 }
 export declare const DOCUMENT_TYPE_LABELS: Record<DocumentType, string>;
+/**
+ * Which Category each DocumentType belongs to. Source of truth for category
+ * derivation when only `type` is known. Used by validation and queries.
+ */
+export declare const TYPE_TO_CATEGORY: Record<DocumentType, Category>;
 /**
  * Lifecycle state of the document.
  *
- * Per workflow decision (master plan §Decision 3): there are NO automatic
- * direct-publish rules per criticality — author chooses to publish directly
- * or send to in_review. Reviewer (different person from author) approves.
+ * Unified vocabulary across categories. Each category uses a subset:
+ *   - operational: draft → current → outdated → withdrawn
+ *   - reference:           current → outdated → withdrawn
+ *   - record:              current → withdrawn (rarely outdated)
+ *
+ * No automatic direct-publish rules per criticality — author chooses status
+ * directly.
  */
 export declare enum DocumentStatus {
     draft = "draft",
-    in_review = "in_review",
-    published = "published",
+    /**
+     * Vigente: doc activo y autoritativo (operational), instancia actual
+     * (reference) o registro accesible (record).
+     */
+    current = "current",
     /**
      * Vigente pero desfasado: el contenido sigue aplicando, pero hay partes
      * desactualizadas que conviene revisar. Visible en listas con un warning.
@@ -89,27 +104,16 @@ export declare enum DocumentStatus {
     outdated = "outdated",
     /**
      * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
-     * Oculto por defecto en listas. Reemplaza a `obsolete` desde 9.3.0
-     * (alineación con ISO/TR 10013 "withdrawn" y con la RAE — "retirado"
-     * captura mejor la decisión activa que "obsoleto").
+     * Oculto por defecto en listas. Alineado con ISO/TR 10013 "withdrawn".
      */
-    withdrawn = "withdrawn",
-    /**
-     * @deprecated Renombrado a `withdrawn` desde 9.3.0. Sigue presente en
-     * el enum durante la ventana de migración para compat de lectura;
-     * removable en una mayor futura cuando la BBDD ya no contenga este
-     * valor. La UI lo trata como sinónimo de `withdrawn`.
-     */
-    obsolete = "obsolete",
-    /**
-     * Archivado-histórico: preservación de un documento cuya naturaleza es
-     * registro (grabaciones de reunión, comunicados pasados, etc.). Oculto por
-     * defecto. Distinto de `withdrawn`: archived es preservación pasiva,
-     * withdrawn es retiro activo.
-     */
-    archived = "archived"
+    withdrawn = "withdrawn"
 }
 export declare const DOCUMENT_STATUS_LABELS: Record<DocumentStatus, string>;
+/**
+ * Allowed statuses per category. UI uses this to render the right options
+ * in dropdowns. Unified vocabulary, but each category uses a subset.
+ */
+export declare const STATUS_BY_CATEGORY: Record<Category, DocumentStatus[]>;
 /**
  * How critical the document is. Used for ranking, badge color, and (in SP4)
  * acknowledgment urgency.

package/dist/constants/document.enums.js

@@ -2,18 +2,12 @@
 /**
  * Document Enums — new document management system (GH#21).
  *
- * Replaces the legacy `documentation.enums.ts` (which keeps serving the legacy
- * `documentations` collection during the 60-day retention window). Do not mix
- * the two — `documentation.*` = legacy, `document.*` = new system.
- *
  * Conventions:
  * - snake_case values per `.claude/rules/enums.md`
  * - `*_LABELS: Record<Enum, string>` Spanish labels alongside each enum
- *
- * @see .claude/plans/active/20260427-GH21-documentation-system-redesign.md
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EXTERNAL_LINK_PROVIDER_LABELS = exports.ExternalLinkProvider = exports.CONTENT_TYPE_LABELS = exports.ContentType = exports.CHANGE_TYPE_LABELS = exports.ChangeType = exports.CRITICALITY_LABELS = exports.Criticality = exports.DOCUMENT_STATUS_LABELS = exports.DocumentStatus = exports.DOCUMENT_TYPE_LABELS = exports.DocumentType = exports.PURPOSE_LABELS = exports.Purpose = exports.AUDIENCE_ALL = void 0;
+exports.EXTERNAL_LINK_PROVIDER_LABELS = exports.ExternalLinkProvider = exports.CONTENT_TYPE_LABELS = exports.ContentType = exports.CHANGE_TYPE_LABELS = exports.ChangeType = exports.CRITICALITY_LABELS = exports.Criticality = exports.STATUS_BY_CATEGORY = exports.DOCUMENT_STATUS_LABELS = exports.DocumentStatus = exports.TYPE_TO_CATEGORY = exports.DOCUMENT_TYPE_LABELS = exports.DocumentType = exports.CATEGORY_LABELS = exports.Category = exports.AUDIENCE_ALL = void 0;
 // ─── Audience sentinel ──────────────────────────────────────────────────────
 /**
  * Sentinel value for `audience: WebAppRole[]` meaning "visible to everyone".
@@ -21,49 +15,36 @@ exports.EXTERNAL_LINK_PROVIDER_LABELS = exports.ExternalLinkProvider = exports.C
  * skip the role filter.
  */
 exports.AUDIENCE_ALL = "all";
-// ─── Purpose ────────────────────────────────────────────────────────────────
+// ─── Category ───────────────────────────────────────────────────────────────
 /**
- * High-level reason a document exists. First axis of the classification
- * (purpose → type → tags). One purpose per audience:
+ * Fundamental document nature. Drives lifecycle behavior:
  *
- * - `operational` — staff, day-to-day workflow
- * - `reference`   — staff, consultation / support material
- * - `external`    — public / clients (marketing, communication)
- * - `archive`     — historical records preserved deliberately
- *
- * Note: `resource` was the previous name of the catch-all bucket. It is
- * deprecated in favor of two narrower purposes (`reference` + `external`)
- * because mixing internal-staff and external-public content under one
- * purpose led to incoherent search filtering. Kept in the enum for legacy
- * data compatibility (migration script will not produce it for new docs).
+ * - `operational` — living doc that evolves; full lifecycle (draft → current →
+ *   outdated → withdrawn); has versions; has elaboratedAt/reviewedAt/
+ *   authorizedAt per version.
+ * - `reference` — singleton authoritative artifact; can be replaced by a newer
+ *   instance (which becomes a separate doc); simpler lifecycle.
+ * - `record` — moment-in-time capture of an unrepeatable event; no real
+ *   lifecycle; just exists.
  */
-var Purpose;
-(function (Purpose) {
-    Purpose["operational"] = "operational";
-    Purpose["reference"] = "reference";
-    Purpose["external"] = "external";
-    Purpose["archive"] = "archive";
-    /** @deprecated Use `reference` (internal staff) or `external` (clients/public) instead. */
-    Purpose["resource"] = "resource";
-})(Purpose || (exports.Purpose = Purpose = {}));
-exports.PURPOSE_LABELS = {
-    [Purpose.operational]: "Operativo",
-    [Purpose.reference]: "Consulta",
-    [Purpose.external]: "Externo / comunicación pública",
-    [Purpose.archive]: "Archivo",
-    [Purpose.resource]: "Recurso (deprecated)",
+var Category;
+(function (Category) {
+    Category["operational"] = "operational";
+    Category["reference"] = "reference";
+    Category["record"] = "record";
+})(Category || (exports.Category = Category = {}));
+exports.CATEGORY_LABELS = {
+    [Category.operational]: "Operativo",
+    [Category.reference]: "Referencia",
+    [Category.record]: "Registro",
 };
 // ─── DocumentType ───────────────────────────────────────────────────────────
 /**
- * Specific kind of document within a purpose. Second axis of classification.
- *
- * Mapping of legacy `DocumentationType` is documented in the migration script
- * (`migrate-documentations-to-documents.ts`). Some values exist purely so
- * legacy docs map cleanly (e.g. `meeting_recording` for `admon` videos).
+ * Specific kind of document within a category. Second axis of classification.
  */
 var DocumentType;
 (function (DocumentType) {
-    // Operational
+    // ── operational types (Category.operational) ───────────────────────────
     DocumentType["protocol"] = "protocol";
     DocumentType["guidance"] = "guidance";
     DocumentType["tutorial"] = "tutorial";
@@ -74,18 +55,37 @@ var DocumentType;
      * Living registry/tracker. The structure is fixed but the data evolves over
      * time (e.g. monthly income tracker, supplier promotional log). Differs from
      * `format` (a template instance is filled once) and from `reference_data`
-     * (typically static reference like catalogs). Added in 9.2.0.
+     * (typically static reference like catalogs).
      */
     DocumentType["control"] = "control";
-    // Resource
+    // ── reference types (Category.reference) ───────────────────────────────
     DocumentType["reference_data"] = "reference_data";
-    DocumentType["training_material"] = "training_material";
     DocumentType["legal_document"] = "legal_document";
     DocumentType["brand_asset"] = "brand_asset";
-    // Archive
+    /**
+     * Permits, certifications, fiscal certificates issued by external authorities.
+     * Singletons replaced when re-issued (e.g. CSF SAT, COFEPRIS, MVR cards).
+     */
+    DocumentType["permit"] = "permit";
+    // ── record types (Category.record) ─────────────────────────────────────
     DocumentType["meeting_recording"] = "meeting_recording";
     DocumentType["historical"] = "historical";
-    // Resource — communication / external content (added in 7.8.0)
+    /**
+     * Specific instance of a class/training session (e.g. "Otitis externa 1
+     * con Anahí Fuentes"). Each is its own doc; new courses ≠ new versions.
+     */
+    DocumentType["training_class"] = "training_class";
+    /**
+     * One-shot presentation tied to a specific event (anniversaries, public
+     * health campaigns).
+     */
+    DocumentType["presentation"] = "presentation";
+    /**
+     * Promotional or marketing content (videos, banners, campaign materials)
+     * that captures past-event communication. Different from `presentation`
+     * (talk/slide deck) — `marketing` is promotional/external-facing material
+     * preserved as historical record.
+     */
     DocumentType["marketing"] = "marketing";
 })(DocumentType || (exports.DocumentType = DocumentType = {}));
 exports.DOCUMENT_TYPE_LABELS = {
@@ -97,26 +97,60 @@ exports.DOCUMENT_TYPE_LABELS = {
     [DocumentType.policy]: "Política",
     [DocumentType.control]: "Control",
     [DocumentType.reference_data]: "Datos de referencia",
-    [DocumentType.training_material]: "Material de capacitación",
     [DocumentType.legal_document]: "Documento legal",
     [DocumentType.brand_asset]: "Activo de marca",
+    [DocumentType.permit]: "Permiso / certificado",
     [DocumentType.meeting_recording]: "Grabación de reunión",
     [DocumentType.historical]: "Histórico",
-    [DocumentType.marketing]: "Marketing y comunicación externa",
+    [DocumentType.training_class]: "Clase de capacitación",
+    [DocumentType.presentation]: "Presentación de evento",
+    [DocumentType.marketing]: "Marketing",
+};
+/**
+ * Which Category each DocumentType belongs to. Source of truth for category
+ * derivation when only `type` is known. Used by validation and queries.
+ */
+exports.TYPE_TO_CATEGORY = {
+    // operational
+    [DocumentType.protocol]: Category.operational,
+    [DocumentType.guidance]: Category.operational,
+    [DocumentType.tutorial]: Category.operational,
+    [DocumentType.format]: Category.operational,
+    [DocumentType.tool]: Category.operational,
+    [DocumentType.policy]: Category.operational,
+    [DocumentType.control]: Category.operational,
+    // reference
+    [DocumentType.reference_data]: Category.reference,
+    [DocumentType.legal_document]: Category.reference,
+    [DocumentType.brand_asset]: Category.reference,
+    [DocumentType.permit]: Category.reference,
+    // record
+    [DocumentType.meeting_recording]: Category.record,
+    [DocumentType.historical]: Category.record,
+    [DocumentType.training_class]: Category.record,
+    [DocumentType.presentation]: Category.record,
+    [DocumentType.marketing]: Category.record,
 };
 // ─── DocumentStatus ─────────────────────────────────────────────────────────
 /**
  * Lifecycle state of the document.
  *
- * Per workflow decision (master plan §Decision 3): there are NO automatic
- * direct-publish rules per criticality — author chooses to publish directly
- * or send to in_review. Reviewer (different person from author) approves.
+ * Unified vocabulary across categories. Each category uses a subset:
+ *   - operational: draft → current → outdated → withdrawn
+ *   - reference:           current → outdated → withdrawn
+ *   - record:              current → withdrawn (rarely outdated)
+ *
+ * No automatic direct-publish rules per criticality — author chooses status
+ * directly.
  */
 var DocumentStatus;
 (function (DocumentStatus) {
     DocumentStatus["draft"] = "draft";
-    DocumentStatus["in_review"] = "in_review";
-    DocumentStatus["published"] = "published";
+    /**
+     * Vigente: doc activo y autoritativo (operational), instancia actual
+     * (reference) o registro accesible (record).
+     */
+    DocumentStatus["current"] = "current";
     /**
      * Vigente pero desfasado: el contenido sigue aplicando, pero hay partes
      * desactualizadas que conviene revisar. Visible en listas con un warning.
@@ -124,35 +158,36 @@ var DocumentStatus;
     DocumentStatus["outdated"] = "outdated";
     /**
      * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
-     * Oculto por defecto en listas. Reemplaza a `obsolete` desde 9.3.0
-     * (alineación con ISO/TR 10013 "withdrawn" y con la RAE — "retirado"
-     * captura mejor la decisión activa que "obsoleto").
+     * Oculto por defecto en listas. Alineado con ISO/TR 10013 "withdrawn".
      */
     DocumentStatus["withdrawn"] = "withdrawn";
-    /**
-     * @deprecated Renombrado a `withdrawn` desde 9.3.0. Sigue presente en
-     * el enum durante la ventana de migración para compat de lectura;
-     * removable en una mayor futura cuando la BBDD ya no contenga este
-     * valor. La UI lo trata como sinónimo de `withdrawn`.
-     */
-    DocumentStatus["obsolete"] = "obsolete";
-    /**
-     * Archivado-histórico: preservación de un documento cuya naturaleza es
-     * registro (grabaciones de reunión, comunicados pasados, etc.). Oculto por
-     * defecto. Distinto de `withdrawn`: archived es preservación pasiva,
-     * withdrawn es retiro activo.
-     */
-    DocumentStatus["archived"] = "archived";
 })(DocumentStatus || (exports.DocumentStatus = DocumentStatus = {}));
 exports.DOCUMENT_STATUS_LABELS = {
     [DocumentStatus.draft]: "Borrador",
-    [DocumentStatus.in_review]: "En revisión",
-    [DocumentStatus.published]: "Publicado",
-    [DocumentStatus.outdated]: "Desactualizado",
+    [DocumentStatus.current]: "Vigente",
+    [DocumentStatus.outdated]: "Desfasado",
     [DocumentStatus.withdrawn]: "Retirado",
-    // Deprecated alias — kept for read compat during 9.3.x migration window
-    [DocumentStatus.obsolete]: "Retirado",
-    [DocumentStatus.archived]: "Archivado",
+};
+/**
+ * Allowed statuses per category. UI uses this to render the right options
+ * in dropdowns. Unified vocabulary, but each category uses a subset.
+ */
+exports.STATUS_BY_CATEGORY = {
+    [Category.operational]: [
+        DocumentStatus.draft,
+        DocumentStatus.current,
+        DocumentStatus.outdated,
+        DocumentStatus.withdrawn,
+    ],
+    [Category.reference]: [
+        DocumentStatus.current,
+        DocumentStatus.outdated,
+        DocumentStatus.withdrawn,
+    ],
+    [Category.record]: [
+        DocumentStatus.current,
+        DocumentStatus.withdrawn,
+    ],
 };
 // ─── Criticality ────────────────────────────────────────────────────────────
 /**

package/dist/contracts/document/requests.d.ts

@@ -6,17 +6,13 @@
  *   - Date fields are ISO 8601 strings, never `Date` objects.
  *   - Update requests are partial; Create requests are complete.
  */
-import { ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider, Purpose } from "../../constants/document.enums";
+import { Category, ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider } from "../../constants/document.enums";
 /**
  * Status values that callers may set via the generic status-change endpoint.
- * `draft`, `in_review`, `published` follow the existing workflow endpoints
- * (saveDraft / submitForReview / publish); `archived` keeps its `/archive`
- * endpoint for backward compat. The generic endpoint covers the new
- * lifecycle moves added in GH#22 SP2 plus return-to-published.
- */
-export type ChangeableDocumentStatus = DocumentStatus.outdated | DocumentStatus.withdrawn
-/** @deprecated alias of `withdrawn`; kept for compat during 9.3.x window. */
- | DocumentStatus.obsolete | DocumentStatus.published;
+ * `draft` is governed by the workflow endpoints (saveDraft / publish), not
+ * by the generic status-change endpoint.
+ */
+export type ChangeableDocumentStatus = DocumentStatus.current | DocumentStatus.outdated | DocumentStatus.withdrawn;
 import { WebAppRole } from "../../constants/collaborator.constants";
 /**
  * One element of `audience[]`. Either a role or the `"all"` sentinel.
@@ -50,11 +46,17 @@ export interface CreateDocumentRequest {
     title: string;
     /** Optional — auto-generated from title via slugify if omitted. */
     slug?: string;
-    purpose: Purpose;
+    /**
+     * Optional — derived server-side from `type` via `TYPE_TO_CATEGORY`. If
+     * provided, must agree with the type's required category or the request
+     * is rejected.
+     */
+    category?: Category;
     type: DocumentType;
     tags?: string[];
     audience: DocumentAudienceEntry[];
     criticality: Criticality;
+    description?: string;
     requiredForOnboarding?: boolean;
     requiresAcknowledgment?: boolean;
     /** ObjectIds (as strings) of related documents. */
@@ -73,11 +75,13 @@ export interface CreateDocumentRequest {
 export interface UpdateDocumentMetadataRequest {
     title?: string;
     slug?: string;
-    purpose?: Purpose;
+    /** Server re-derives from `type` if `type` changes; explicit override allowed. */
+    category?: Category;
     type?: DocumentType;
     tags?: string[];
     audience?: DocumentAudienceEntry[];
     criticality?: Criticality;
+    description?: string;
     requiredForOnboarding?: boolean;
     requiresAcknowledgment?: boolean;
     references?: string[];
@@ -198,10 +202,10 @@ export type AcknowledgeVersionRequest = Record<string, never>;
  * Query string parameters for `GET /api/documents`. All optional. Audience
  * filtering by current user role is implicit (handled server-side).
  *
- * @example GET /api/documents?purpose=operational&status=published
+ * @example GET /api/documents?category=operational&status=current
  */
 export interface ListDocumentsQuery {
-    purpose?: Purpose;
+    category?: Category;
     type?: DocumentType;
     status?: DocumentStatus;
     criticality?: Criticality;
@@ -212,16 +216,11 @@ export interface ListDocumentsQuery {
     requiredForOnboarding?: boolean;
     requiresAcknowledgment?: boolean;
     /**
-     * If true, the response includes `obsolete` documents. Default: false (the
-     * server hides obsolete docs unless the caller asks for them). Ignored when
-     * `status` is set explicitly. Writer-only flag.
-     */
-    includeObsolete?: boolean;
-    /**
-     * If true, the response includes `archived` documents. Default: false.
-     * Ignored when `status` is set explicitly. Writer-only flag.
+     * If true, the response includes `withdrawn` documents. Default: false
+     * (server hides them unless explicitly requested). Ignored when `status`
+     * is set explicitly. Writer-only flag.
      */
-    includeArchived?: boolean;
+    includeWithdrawn?: boolean;
     limit?: number;
     skip?: number;
 }

package/dist/contracts/document/responses.d.ts

@@ -5,7 +5,7 @@
  *   - Date fields are ISO 8601 strings (server converts Date → ISO at the mapper layer).
  *   - Use Public → View → Admin inheritance where it adds value.
  */
-import { ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider, Purpose } from "../../constants/document.enums";
+import { Category, ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider } from "../../constants/document.enums";
 import { DocumentAudienceEntry } from "./requests";
 /**
  * Compact reference to a document's current version, embedded in
@@ -28,7 +28,7 @@ export interface PublicDocumentResponse {
     id: string;
     slug: string;
     title: string;
-    purpose: Purpose;
+    category: Category;
     type: DocumentType;
     status: DocumentStatus;
     criticality: Criticality;
@@ -42,6 +42,7 @@ export interface PublicDocumentResponse {
 export interface DocumentViewResponse extends PublicDocumentResponse {
     tags: string[];
     audience: DocumentAudienceEntry[];
+    description?: string;
     requiredForOnboarding: boolean;
     requiresAcknowledgment: boolean;
     references: string[];
@@ -73,7 +74,7 @@ export interface DocumentSummaryResponse {
     id: string;
     slug: string;
     title: string;
-    purpose: Purpose;
+    category: Category;
     type: DocumentType;
     status: DocumentStatus;
     criticality: Criticality;
@@ -109,7 +110,7 @@ export interface DocumentVersionResponse {
     id: string;
     documentId: string;
     versionNumber: string;
-    status: "draft" | "in_review" | "current" | "superseded";
+    status: "draft" | "in_review" | "current" | "superseded" | "withdrawn";
     contentType: ContentType;
     markdown: string | null;
     externalLink: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "10.0.0",
+  "version": "12.0.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",