Move document title ownership from document to version

Title is now owned by document_versions, following the same pattern as classification and document_type. The documents.title column is made nullable with a TODO to drop it. Backend loads title from a latest_versions CTE for ordering purposes only. The frontend resolves title from the latest version, and DocumentTitleForm now operates on DocumentVersion using UpdateDocumentVersion mutation. Signed-off-by: Sacha Al Himdani <sacha@getprobo.com>
2026-04-07 18:45:46 +02:00
parent ba386d188b
commit b63f043849
20 changed files with 329 additions and 333 deletions
--- a/pkg/coredata/document.go
+++ b/pkg/coredata/document.go
@@ -32,7 +32,6 @@ type (
 	Document struct {
 		ID                    gid.GID               `db:"id"`
 		OrganizationID        gid.GID               `db:"organization_id"`
-		Title                 string                `db:"title"`
 		CurrentPublishedMajor *int                  `db:"current_published_major"`
 		CurrentPublishedMinor *int                  `db:"current_published_minor"`
 		TrustCenterVisibility TrustCenterVisibility `db:"trust_center_visibility"`
@@ -42,6 +41,7 @@ type (
 		UpdatedAt             time.Time             `db:"updated_at"`

 		// ordering only
+		Title        string       `db:"title"`
 		DocumentType DocumentType `db:"document_type"`
 	}

@@ -93,14 +93,13 @@ func (p *Document) LoadByID(
 ) error {
 	q := `
 WITH latest_versions AS (
-    SELECT DISTINCT ON (document_id) document_id, document_type
+    SELECT DISTINCT ON (document_id) document_id, title, document_type
    FROM document_versions
    ORDER BY document_id, major DESC, minor DESC
 )
 SELECT
    documents.id,
    documents.organization_id,
-    documents.title,
    documents.current_published_major,
    documents.current_published_minor,
    documents.trust_center_visibility,
@@ -108,6 +107,7 @@ SELECT
    documents.archived_at,
    documents.created_at,
    documents.updated_at,
+    COALESCE(lv.title, '') AS title,
    COALESCE(lv.document_type, 'OTHER') AS document_type
 FROM
    documents
@@ -152,14 +152,13 @@ func (p *Document) LoadByIDWithFilter(
 ) error {
 	q := `
 WITH latest_versions AS (
-    SELECT DISTINCT ON (document_id) document_id, document_type
+    SELECT DISTINCT ON (document_id) document_id, title, document_type
    FROM document_versions
    ORDER BY document_id, major DESC, minor DESC
 )
 SELECT
    documents.id,
    documents.organization_id,
-    documents.title,
    documents.current_published_major,
    documents.current_published_minor,
    documents.trust_center_visibility,
@@ -167,6 +166,7 @@ SELECT
    documents.archived_at,
    documents.created_at,
    documents.updated_at,
+    COALESCE(lv.title, '') AS title,
    COALESCE(lv.document_type, 'OTHER') AS document_type
 FROM
    documents
@@ -212,14 +212,13 @@ func (p *Documents) LoadByIDs(
 ) error {
 	q := `
 WITH latest_versions AS (
-    SELECT DISTINCT ON (document_id) document_id, document_type
+    SELECT DISTINCT ON (document_id) document_id, title, document_type
    FROM document_versions
    ORDER BY document_id, major DESC, minor DESC
 )
 SELECT
    documents.id,
    documents.organization_id,
-    documents.title,
    documents.current_published_major,
    documents.current_published_minor,
    documents.trust_center_visibility,
@@ -227,6 +226,7 @@ SELECT
    documents.archived_at,
    documents.created_at,
    documents.updated_at,
+    COALESCE(lv.title, '') AS title,
    COALESCE(lv.document_type, 'OTHER') AS document_type
 FROM
    documents
@@ -301,31 +301,33 @@ func (p *Documents) LoadByOrganizationID(
 ) error {
 	q := `
 WITH latest_versions AS (
-    SELECT DISTINCT ON (document_id) document_id, document_type
+    SELECT DISTINCT ON (document_id) document_id, title, document_type
    FROM document_versions
    ORDER BY document_id, major DESC, minor DESC
+),
+base AS (
+    SELECT
+        documents.id,
+        documents.organization_id,
+        documents.current_published_major,
+        documents.current_published_minor,
+        documents.trust_center_visibility,
+        documents.status,
+        documents.archived_at,
+        documents.created_at,
+        documents.updated_at,
+        COALESCE(lv.title, '') AS title,
+        COALESCE(lv.document_type, 'OTHER') AS document_type
+    FROM
+        documents
+    LEFT JOIN latest_versions lv ON lv.document_id = documents.id
+    WHERE
+        %s
+        AND documents.deleted_at IS NULL
+        AND documents.organization_id = @organization_id
+        AND %s
 )
-SELECT
-	documents.id,
-    documents.organization_id,
-    documents.title,
-    documents.current_published_major,
-    documents.current_published_minor,
-    documents.trust_center_visibility,
-    documents.status,
-    documents.archived_at,
-    documents.created_at,
-    documents.updated_at,
-    COALESCE(lv.document_type, 'OTHER') AS document_type
-FROM
-    documents
-LEFT JOIN latest_versions lv ON lv.document_id = documents.id
-WHERE
-    %s
-    AND documents.deleted_at IS NULL
-    AND documents.organization_id = @organization_id
-    AND %s
-    AND %s
+SELECT * FROM base WHERE %s
 `

 	q = fmt.Sprintf(q, scope.SQLFragment(), filter.SQLFragment(), cursor.SQLFragment())
@@ -359,14 +361,13 @@ func (p *Documents) LoadAllByOrganizationID(
 ) error {
 	q := `
 WITH latest_versions AS (
-    SELECT DISTINCT ON (document_id) document_id, document_type
+    SELECT DISTINCT ON (document_id) document_id, title, document_type
    FROM document_versions
    ORDER BY document_id, major DESC, minor DESC
 )
 SELECT
 	documents.id,
    documents.organization_id,
-    documents.title,
    documents.current_published_major,
    documents.current_published_minor,
    documents.trust_center_visibility,
@@ -374,6 +375,7 @@ SELECT
    documents.archived_at,
    documents.created_at,
    documents.updated_at,
+    COALESCE(lv.title, '') AS title,
    COALESCE(lv.document_type, 'OTHER') AS document_type
 FROM
    documents
@@ -417,43 +419,48 @@ func (p *Documents) LoadPublishedByOrganizationID(
 ) error {
 	q := `
 WITH latest_versions AS (
-	SELECT DISTINCT ON (document_id) document_id, document_type
+	SELECT DISTINCT ON (document_id) document_id, title, document_type
 	FROM document_versions
 	ORDER BY document_id, major DESC, minor DESC
 ),
-published_documents AS (
+published_versions AS (
 	SELECT
-		d.*,
+		dv.document_id,
 		dv.title AS published_title
 	FROM
-		documents d
-		LEFT JOIN document_versions dv
+		document_versions dv
+		INNER JOIN documents d
 			ON dv.document_id = d.id
 			AND dv.major = d.current_published_major
 			AND dv.minor = d.current_published_minor
 	WHERE
 		d.deleted_at IS NULL
 		AND d.organization_id = @organization_id
+),
+base AS (
+	SELECT
+		documents.id,
+		documents.organization_id,
+		documents.current_published_major,
+		documents.current_published_minor,
+		documents.trust_center_visibility,
+		documents.status,
+		documents.archived_at,
+		documents.created_at,
+		documents.updated_at,
+		COALESCE(pv.published_title, lv.title, '') AS title,
+		COALESCE(lv.document_type, 'OTHER') AS document_type
+	FROM
+		documents
+	LEFT JOIN latest_versions lv ON lv.document_id = documents.id
+	LEFT JOIN published_versions pv ON pv.document_id = documents.id
+	WHERE
+		%s
+		AND documents.deleted_at IS NULL
+		AND documents.organization_id = @organization_id
+		AND %s
 )
-SELECT
-	documents.id,
-	documents.organization_id,
-	COALESCE(documents.published_title, documents.title) AS title,
-	documents.current_published_major,
-	documents.current_published_minor,
-	documents.trust_center_visibility,
-	documents.status,
-	documents.archived_at,
-	documents.created_at,
-	documents.updated_at,
-	COALESCE(lv.document_type, 'OTHER') AS document_type
-FROM
-	published_documents documents
-LEFT JOIN latest_versions lv ON lv.document_id = documents.id
-WHERE
-	%s
-	AND %s
-	AND %s
+SELECT * FROM base WHERE %s
 `
 	q = fmt.Sprintf(q, scope.SQLFragment(), filter.SQLFragment(), cursor.SQLFragment())

@@ -488,7 +495,6 @@ INSERT INTO
        tenant_id,
 		id,
 		organization_id,
-		title,
 		current_published_major,
 		current_published_minor,
 		trust_center_visibility,
@@ -501,7 +507,6 @@ VALUES (
    @tenant_id,
    @document_id,
    @organization_id,
-    @title,
    @current_published_major,
    @current_published_minor,
    @trust_center_visibility,
@@ -516,7 +521,6 @@ VALUES (
 		"tenant_id":               scope.GetTenantID(),
 		"document_id":             p.ID,
 		"organization_id":         p.OrganizationID,
-		"title":                   p.Title,
 		"current_published_major": p.CurrentPublishedMajor,
 		"current_published_minor": p.CurrentPublishedMinor,
 		"trust_center_visibility": p.TrustCenterVisibility,
@@ -575,7 +579,6 @@ func (p *Document) Update(
 UPDATE
 	documents
 SET
-	title = @title,
 	current_published_major = @current_published_major,
 	current_published_minor = @current_published_minor,
 	trust_center_visibility = @trust_center_visibility,
@@ -592,7 +595,6 @@ WHERE
 	args := pgx.StrictNamedArgs{
 		"document_id":             p.ID,
 		"updated_at":              time.Now(),
-		"title":                   p.Title,
 		"current_published_major": p.CurrentPublishedMajor,
 		"current_published_minor": p.CurrentPublishedMinor,
 		"trust_center_visibility": p.TrustCenterVisibility,
@@ -655,7 +657,7 @@ func (p *Documents) LoadByControlID(
 ) error {
 	q := `
 WITH latest_versions AS (
-	SELECT DISTINCT ON (document_id) document_id, document_type
+	SELECT DISTINCT ON (document_id) document_id, title, document_type
 	FROM document_versions
 	ORDER BY document_id, major DESC, minor DESC
 ),
@@ -665,24 +667,26 @@ scoped_documents AS (
 	WHERE %s
 		AND deleted_at IS NULL
 		AND %s
-		AND %s
+),
+base AS (
+	SELECT
+		sd.id,
+		sd.organization_id,
+		sd.current_published_major,
+		sd.current_published_minor,
+		sd.trust_center_visibility,
+		sd.status,
+		sd.archived_at,
+		sd.created_at,
+		sd.updated_at,
+		COALESCE(lv.title, '') AS title,
+		COALESCE(lv.document_type, 'OTHER') AS document_type
+	FROM scoped_documents sd
+	INNER JOIN controls_documents cp ON sd.id = cp.document_id
+	LEFT JOIN latest_versions lv ON lv.document_id = sd.id
+	WHERE cp.control_id = @control_id
 )
-SELECT
-	scoped_documents.id,
-	scoped_documents.organization_id,
-	scoped_documents.title,
-	scoped_documents.current_published_major,
-	scoped_documents.current_published_minor,
-	scoped_documents.trust_center_visibility,
-	scoped_documents.status,
-	scoped_documents.archived_at,
-	scoped_documents.created_at,
-	scoped_documents.updated_at,
-	COALESCE(lv.document_type, 'OTHER') AS document_type
-FROM scoped_documents
-INNER JOIN controls_documents cp ON scoped_documents.id = cp.document_id
-LEFT JOIN latest_versions lv ON lv.document_id = scoped_documents.id
-WHERE cp.control_id = @control_id
+SELECT * FROM base WHERE %s
 `
 	q = fmt.Sprintf(q, scope.SQLFragment(), filter.SQLFragment(), cursor.SQLFragment())

@@ -752,7 +756,7 @@ func (p *Documents) LoadByRiskID(
 ) error {
 	q := `
 WITH latest_versions AS (
-	SELECT DISTINCT ON (document_id) document_id, document_type
+	SELECT DISTINCT ON (document_id) document_id, title, document_type
 	FROM document_versions
 	ORDER BY document_id, major DESC, minor DESC
 ),
@@ -762,24 +766,26 @@ scoped_documents AS (
 	WHERE %s
 		AND deleted_at IS NULL
 		AND %s
-		AND %s
+),
+base AS (
+	SELECT
+		sd.id,
+		sd.organization_id,
+		sd.current_published_major,
+		sd.current_published_minor,
+		sd.trust_center_visibility,
+		sd.status,
+		sd.archived_at,
+		sd.created_at,
+		sd.updated_at,
+		COALESCE(lv.title, '') AS title,
+		COALESCE(lv.document_type, 'OTHER') AS document_type
+	FROM scoped_documents sd
+	INNER JOIN risks_documents rp ON sd.id = rp.document_id
+	LEFT JOIN latest_versions lv ON lv.document_id = sd.id
+	WHERE rp.risk_id = @risk_id
 )
-SELECT
-	scoped_documents.id,
-	scoped_documents.organization_id,
-	scoped_documents.title,
-	scoped_documents.current_published_major,
-	scoped_documents.current_published_minor,
-	scoped_documents.trust_center_visibility,
-	scoped_documents.status,
-	scoped_documents.archived_at,
-	scoped_documents.created_at,
-	scoped_documents.updated_at,
-	COALESCE(lv.document_type, 'OTHER') AS document_type
-FROM scoped_documents
-INNER JOIN risks_documents rp ON scoped_documents.id = rp.document_id
-LEFT JOIN latest_versions lv ON lv.document_id = scoped_documents.id
-WHERE rp.risk_id = @risk_id
+SELECT * FROM base WHERE %s
 `
 	q = fmt.Sprintf(q, scope.SQLFragment(), filter.SQLFragment(), cursor.SQLFragment())

@@ -849,7 +855,7 @@ func (p *Documents) LoadByMeasureID(
 ) error {
 	q := `
 WITH latest_versions AS (
-	SELECT DISTINCT ON (document_id) document_id, document_type
+	SELECT DISTINCT ON (document_id) document_id, title, document_type
 	FROM document_versions
 	ORDER BY document_id, major DESC, minor DESC
 ),
@@ -859,24 +865,26 @@ scoped_documents AS (
 	WHERE %s
 		AND deleted_at IS NULL
 		AND %s
-		AND %s
+),
+base AS (
+	SELECT
+		sd.id,
+		sd.organization_id,
+		sd.current_published_major,
+		sd.current_published_minor,
+		sd.trust_center_visibility,
+		sd.status,
+		sd.archived_at,
+		sd.created_at,
+		sd.updated_at,
+		COALESCE(lv.title, '') AS title,
+		COALESCE(lv.document_type, 'OTHER') AS document_type
+	FROM scoped_documents sd
+	INNER JOIN measures_documents md ON sd.id = md.document_id
+	LEFT JOIN latest_versions lv ON lv.document_id = sd.id
+	WHERE md.measure_id = @measure_id
 )
-SELECT
-	scoped_documents.id,
-	scoped_documents.organization_id,
-	scoped_documents.title,
-	scoped_documents.current_published_major,
-	scoped_documents.current_published_minor,
-	scoped_documents.trust_center_visibility,
-	scoped_documents.status,
-	scoped_documents.archived_at,
-	scoped_documents.created_at,
-	scoped_documents.updated_at,
-	COALESCE(lv.document_type, 'OTHER') AS document_type
-FROM scoped_documents
-INNER JOIN measures_documents md ON scoped_documents.id = md.document_id
-LEFT JOIN latest_versions lv ON lv.document_id = scoped_documents.id
-WHERE md.measure_id = @measure_id
+SELECT * FROM base WHERE %s
 `
 	q = fmt.Sprintf(q, scope.SQLFragment(), filter.SQLFragment(), cursor.SQLFragment())

--- a/pkg/coredata/migrations/20260407T120000Z.sql
+++ b/pkg/coredata/migrations/20260407T120000Z.sql
@@ -0,0 +1,16 @@
+-- Copyright (c) 2026 Probo Inc <hello@getprobo.com>.
+--
+-- Permission to use, copy, modify, and/or distribute this software for any
+-- purpose with or without fee is hereby granted, provided that the above
+-- copyright notice and this permission notice appear in all copies.
+--
+-- THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+-- REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+-- AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+-- INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+-- LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+-- OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+-- PERFORMANCE OF THIS SOFTWARE.
+
+-- TODO: drop the title column from documents.
+ALTER TABLE documents ALTER COLUMN title DROP NOT NULL;
--- a/pkg/probo/document_service.go
+++ b/pkg/probo/document_service.go
@@ -89,13 +89,13 @@ type (

 	UpdateDocumentRequest struct {
 		DocumentID            gid.GID
-		Title                 *string
 		TrustCenterVisibility *coredata.TrustCenterVisibility
 		DefaultApproverIDs    *[]gid.GID
 	}

 	UpdateDocumentVersionRequest struct {
 		ID             gid.GID
+		Title          *string
 		Content        *string
 		Classification *coredata.DocumentClassification
 		DocumentType   *coredata.DocumentType
@@ -150,7 +150,6 @@ func (udr *UpdateDocumentRequest) Validate() error {
 	v := validator.New()

 	v.Check(udr.DocumentID, "document_id", validator.Required(), validator.GID(coredata.DocumentEntityType))
-	v.Check(udr.Title, "title", validator.SafeTextNoNewLine(TitleMaxLength))
 	v.Check(udr.TrustCenterVisibility, "trust_center_visibility", validator.OneOfSlice(coredata.TrustCenterVisibilities()))
 	if udr.DefaultApproverIDs != nil {
 		v.Check(len(*udr.DefaultApproverIDs), "default_approver_ids", validator.Max(100))
@@ -167,6 +166,7 @@ func (udvr *UpdateDocumentVersionRequest) Validate() error {
 	v := validator.New()

 	v.Check(udvr.ID, "id", validator.Required(), validator.GID(coredata.DocumentVersionEntityType))
+	v.Check(udvr.Title, "title", validator.SafeTextNoNewLine(TitleMaxLength))
 	v.Check(udvr.Classification, "classification", validator.OneOfSlice(coredata.DocumentClassifications()))
 	v.Check(
 		udvr.Content,
@@ -584,7 +584,6 @@ func (s *DocumentService) Create(

 	document := &coredata.Document{
 		ID:                    documentID,
-		Title:                 req.Title,
 		TrustCenterVisibility: coredata.TrustCenterVisibilityNone,
 		Status:                coredata.DocumentStatusActive,
 		CreatedAt:             now,
@@ -863,7 +862,9 @@ func (s *DocumentService) UpdateVersion(
 				documentVersion.Content = content
 			}

-			documentVersion.Title = document.Title
+			if req.Title != nil {
+				documentVersion.Title = *req.Title
+			}
 			if req.Classification != nil {
 				documentVersion.Classification = *req.Classification
 			}
@@ -1119,7 +1120,7 @@ func (s *DocumentService) CreateDraft(
 			draftVersion.ID = draftVersionID
 			draftVersion.OrganizationID = document.OrganizationID
 			draftVersion.DocumentID = documentID
-			draftVersion.Title = document.Title
+			draftVersion.Title = latestVersion.Title
 			draftVersion.Major = latestVersion.Major
 			draftVersion.Minor = latestVersion.Minor + 1
 			draftVersion.Classification = latestVersion.Classification
@@ -1716,10 +1717,6 @@ func (s *DocumentService) Update(
 				return &ErrDocumentArchived{}
 			}

-			if req.Title != nil {
-				document.Title = *req.Title
-			}
-
 			if req.TrustCenterVisibility != nil {
 				document.TrustCenterVisibility = *req.TrustCenterVisibility
 			}
@@ -1730,17 +1727,6 @@ func (s *DocumentService) Update(
 				return fmt.Errorf("cannot update document: %w", err)
 			}

-			draftVersion := &coredata.DocumentVersion{}
-			err := draftVersion.LoadLatestVersion(ctx, tx, s.svc.scope, req.DocumentID)
-			if err == nil && draftVersion.Status == coredata.DocumentVersionStatusDraft {
-				draftVersion.Title = document.Title
-				draftVersion.UpdatedAt = now
-
-				if err := draftVersion.Update(ctx, tx, s.svc.scope); err != nil {
-					return fmt.Errorf("cannot update draft version: %w", err)
-				}
-			}
-
 			if req.DefaultApproverIDs != nil {
 				defaultApprovers := &coredata.DocumentDefaultApprovers{}
 				if err := defaultApprovers.MergeByDocumentID(ctx, tx, s.svc.scope, req.DocumentID, document.OrganizationID, *req.DefaultApproverIDs); err != nil {
--- a/pkg/server/api/console/v1/schema.graphql
+++ b/pkg/server/api/console/v1/schema.graphql
@@ -2562,7 +2562,6 @@ type Evidence implements Node {

 type Document implements Node {
    id: ID!
-    title: String!
    description: String
    currentPublishedMajor: Int
    currentPublishedMinor: Int
@@ -4676,8 +4675,6 @@ input CreateDocumentInput {

 input UpdateDocumentInput {
    id: ID!
-    title: String
-    content: String
    trustCenterVisibility: TrustCenterVisibility
    defaultApproverIds: [ID!]
 }
@@ -5945,6 +5942,7 @@ input DeleteDraftDocumentVersionInput {

 input UpdateDocumentVersionInput {
    documentVersionId: ID!
+    title: String
    content: String
    classification: DocumentClassification
    documentType: DocumentType
--- a/pkg/server/api/console/v1/types/document.go
+++ b/pkg/server/api/console/v1/types/document.go
@@ -75,8 +75,7 @@ func NewDocumentEdge(document *coredata.Document, orderBy coredata.DocumentOrder

 func NewDocument(document *coredata.Document) *Document {
 	return &Document{
-		ID:    document.ID,
-		Title: document.Title,
+		ID: document.ID,
 		Organization: &Organization{
 			ID: document.OrganizationID,
 		},
--- a/pkg/server/api/console/v1/v1_resolver.go
+++ b/pkg/server/api/console/v1/v1_resolver.go
@@ -5307,7 +5307,6 @@ func (r *mutationResolver) UpdateDocument(ctx context.Context, input types.Updat
 		ctx,
 		probo.UpdateDocumentRequest{
 			DocumentID:            input.ID,
-			Title:                 input.Title,
 			TrustCenterVisibility: input.TrustCenterVisibility,
 			DefaultApproverIDs:    defaultApproverIDs,
 		},
@@ -6101,6 +6100,7 @@ func (r *mutationResolver) UpdateDocumentVersion(ctx context.Context, input type
 		ctx,
 		probo.UpdateDocumentVersionRequest{
 			ID:             input.DocumentVersionID,
+			Title:          input.Title,
 			Content:        input.Content,
 			Classification: input.Classification,
 			DocumentType:   input.DocumentType,
--- a/pkg/server/api/mcp/v1/schema.resolvers.go
+++ b/pkg/server/api/mcp/v1/schema.resolvers.go
@@ -2119,7 +2119,6 @@ func (r *Resolver) UpdateDocumentTool(ctx context.Context, req *mcp.CallToolRequ
 		ctx,
 		probo.UpdateDocumentRequest{
 			DocumentID:            input.ID,
-			Title:                 input.Title,
 			TrustCenterVisibility: input.TrustCenterVisibility,
 			DefaultApproverIDs:    defaultApproverIDs,
 		},
@@ -2224,6 +2223,7 @@ func (r *Resolver) UpdateDocumentVersionTool(ctx context.Context, req *mcp.CallT
 		ctx,
 		probo.UpdateDocumentVersionRequest{
 			ID:             input.DocumentVersionID,
+			Title:          input.Title,
 			Content:        content,
 			Classification: input.Classification,
 			DocumentType:   input.DocumentType,
--- a/pkg/server/api/mcp/v1/specification.yaml
+++ b/pkg/server/api/mcp/v1/specification.yaml
@@ -5243,7 +5243,6 @@ components:
      required:
        - id
        - organization_id
-        - title
        - trust_center_visibility
        - status
        - created_at
@@ -5255,9 +5254,6 @@ components:
        organization_id:
          $ref: "#/components/schemas/GID"
          description: Organization ID
-        title:
-          type: string
-          description: Document title
        current_published_major:
          type:
            - integer
@@ -5522,9 +5518,6 @@ components:
        id:
          $ref: "#/components/schemas/GID"
          description: Document ID
-        title:
-          type: string
-          description: Document title
        trust_center_visibility:
          $ref: "#/components/schemas/TrustCenterVisibility"
          description: Trust center visibility
@@ -5655,6 +5648,9 @@ components:
        document_version_id:
          $ref: "#/components/schemas/GID"
          description: Document version ID
+        title:
+          type: string
+          description: Document version title
        content:
          type: string
          description: Document content in markdown format
--- a/pkg/server/api/mcp/v1/types/document.go
+++ b/pkg/server/api/mcp/v1/types/document.go
@@ -45,7 +45,6 @@ func NewDocument(d *coredata.Document) *Document {
 	return &Document{
 		ID:                    d.ID,
 		OrganizationID:        d.OrganizationID,
-		Title:                 d.Title,
 		CurrentPublishedMajor: d.CurrentPublishedMajor,
 		CurrentPublishedMinor: d.CurrentPublishedMinor,
 		TrustCenterVisibility: d.TrustCenterVisibility,