Allow publishing generated documents as minor versions

Generated documents (asset list, risk register, SoA, ...) previously
only ever produced a new major version. Every regeneration of an
auto-built register consumed a major number, even when the change was
trivial. They now accept a minor flag and publish as
currentMajor.currentMinor+1 when set, bypassing the approval flow.

To carry the flag through cleanly, the document publish API was
refactored. The three split mutations (publishMajor, publishMinor,
requestDocumentVersionApproval) and the two bulk variants collapse
into a single publishDocument / bulkPublishDocuments, both taking the
new minor: Boolean! and a now-required changelog: String!. The same
shape flows through the CLI ("prb document publish --minor"), the MCP
tool, the n8n operations, and the Relay dialogs, where each
generated-doc dialog gains a "Publish as minor" button. Publishing
minor without an existing major is rejected with
ErrCannotPublishMinorWithoutMajor.

This is a deliberate breaking change for callers of the prior
mutations.

Signed-off-by: Sacha Al Himdani <sacha@getprobo.com>

pkg/server/api/console/v1/asset_resolvers.go

@@ -403,11 +403,14 @@ func (r *mutationResolver) PublishDataList(ctx context.Context, input types.Publ
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishDataList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishDataList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish data list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}
@@ -426,11 +429,14 @@ func (r *mutationResolver) PublishAssetList(ctx context.Context, input types.Pub
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishAssetList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishAssetList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish asset list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/console/v1/audit_resolvers.go

@@ -679,11 +679,14 @@ func (r *mutationResolver) PublishFindingList(ctx context.Context, input types.P
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishFindingList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishFindingList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish finding list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/console/v1/control_resolvers.go

@@ -771,11 +771,14 @@ func (r *mutationResolver) PublishStatementOfApplicability(ctx context.Context,
 
 	prb := r.ProboService(ctx, input.StatementOfApplicabilityID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishStatementOfApplicability(ctx, input.StatementOfApplicabilityID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishStatementOfApplicability(ctx, input.StatementOfApplicabilityID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish statement of applicability", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/console/v1/data_protection_impact_assessment_resolvers.go

@@ -274,11 +274,14 @@ func (r *mutationResolver) PublishDataProtectionImpactAssessmentList(ctx context
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishDataProtectionImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishDataProtectionImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish data protection impact assessment list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}
@@ -297,11 +300,14 @@ func (r *mutationResolver) PublishTransferImpactAssessmentList(ctx context.Conte
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishTransferImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishTransferImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish transfer impact assessment list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/console/v1/document_resolvers.go

@@ -980,198 +980,21 @@ func (r *mutationResolver) DeleteDocument(ctx context.Context, input types.Delet
 	}, nil
 }
 
-// PublishMajorDocumentVersion is the resolver for the publishMajorDocumentVersion field.
-func (r *mutationResolver) PublishMajorDocumentVersion(ctx context.Context, input types.PublishMajorDocumentVersionInput) (*types.PublishDocumentVersionPayload, error) {
-	if err := r.authorize(ctx, input.DocumentID, probo.ActionDocumentVersionPublish); err != nil {
+// PublishDocument is the resolver for the publishDocument field.
+func (r *mutationResolver) PublishDocument(ctx context.Context, input types.PublishDocumentInput) (*types.PublishDocumentPayload, error) {
+	action := probo.ActionDocumentVersionPublish
+	if !input.Minor && len(input.ApproverIds) > 0 {
+		action = probo.ActionDocumentVersionRequestApproval
+	}
+	if err := r.authorize(ctx, input.DocumentID, action); err != nil {
 		return nil, err
 	}
 
 	prb := r.ProboService(ctx, input.DocumentID.TenantID())
 
-	document, documentVersion, err := prb.Documents.PublishMajorVersion(
-		ctx,
-		input.DocumentID,
-		authn.IdentityFromContext(ctx).ID,
-		input.Changelog,
-	)
-	if err != nil {
-		if errArchived, ok := errors.AsType[*probo.ErrDocumentArchived](err); ok {
-			return nil, gqlutils.Conflict(ctx, errArchived)
-		}
-
-		if errNotDraft, ok := errors.AsType[*probo.ErrDocumentVersionNotDraft](err); ok {
-			return nil, gqlutils.Invalid(ctx, errNotDraft)
-		}
-
-		if errPending, ok := errors.AsType[*probo.ErrDocumentVersionPendingApproval](err); ok {
-			return nil, gqlutils.Conflict(ctx, errPending)
-		}
-
-		r.logger.ErrorCtx(ctx, "cannot publish major document version", log.Error(err))
-		return nil, gqlutils.Internal(ctx)
-	}
-
-	return &types.PublishDocumentVersionPayload{
-		Document:        types.NewDocument(document),
-		DocumentVersion: types.NewDocumentVersion(documentVersion),
-	}, nil
-}
-
-// PublishMinorDocumentVersion is the resolver for the publishMinorDocumentVersion field.
-func (r *mutationResolver) PublishMinorDocumentVersion(ctx context.Context, input types.PublishMinorDocumentVersionInput) (*types.PublishDocumentVersionPayload, error) {
-	if err := r.authorize(ctx, input.DocumentID, probo.ActionDocumentVersionPublish); err != nil {
-		return nil, err
-	}
-
-	prb := r.ProboService(ctx, input.DocumentID.TenantID())
-
-	document, documentVersion, err := prb.Documents.PublishMinorVersion(
-		ctx,
-		input.DocumentID,
-		authn.IdentityFromContext(ctx).ID,
-		input.Changelog,
-	)
-	if err != nil {
-		if errArchived, ok := errors.AsType[*probo.ErrDocumentArchived](err); ok {
-			return nil, gqlutils.Conflict(ctx, errArchived)
-		}
-
-		if errNotDraft, ok := errors.AsType[*probo.ErrDocumentVersionNotDraft](err); ok {
-			return nil, gqlutils.Invalid(ctx, errNotDraft)
-		}
-
-		if errPending, ok := errors.AsType[*probo.ErrDocumentVersionPendingApproval](err); ok {
-			return nil, gqlutils.Conflict(ctx, errPending)
-		}
-
-		r.logger.ErrorCtx(ctx, "cannot publish minor document version", log.Error(err))
-		return nil, gqlutils.Internal(ctx)
-	}
-
-	return &types.PublishDocumentVersionPayload{
-		Document:        types.NewDocument(document),
-		DocumentVersion: types.NewDocumentVersion(documentVersion),
-	}, nil
-}
-
-// BulkPublishMajorDocumentVersions is the resolver for the bulkPublishMajorDocumentVersions field.
-func (r *mutationResolver) BulkPublishMajorDocumentVersions(ctx context.Context, input types.BulkPublishDocumentVersionsInput) (*types.BulkPublishDocumentVersionsPayload, error) {
-	if len(input.DocumentIds) == 0 {
-		return &types.BulkPublishDocumentVersionsPayload{
-			DocumentVersions: []*types.DocumentVersion{},
-			Documents:        []*types.Document{},
-		}, nil
-	}
-
-	for _, documentID := range input.DocumentIds {
-		if err := r.authorize(ctx, documentID, probo.ActionDocumentVersionPublish); err != nil {
-			return nil, err
-		}
-	}
-
-	prb := r.ProboService(ctx, input.DocumentIds[0].TenantID())
-
-	versions, documents, err := prb.DocumentApprovals.BulkPublishMajorVersions(ctx, probo.BulkPublishVersionsRequest{
-		DocumentIDs: input.DocumentIds,
-		Changelog:   input.Changelog,
-	})
-	if err != nil {
-		if errors.Is(err, coredata.ErrResourceNotFound) {
-			return nil, gqlutils.NotFound(ctx, err)
-		}
-
-		if errArchived, ok := errors.AsType[*probo.ErrDocumentArchived](err); ok {
-			return nil, gqlutils.Conflict(ctx, errArchived)
-		}
-
-		if errNotDraft, ok := errors.AsType[*probo.ErrDocumentVersionNotDraft](err); ok {
-			return nil, gqlutils.Invalid(ctx, errNotDraft)
-		}
-
-		r.logger.ErrorCtx(ctx, "cannot bulk publish major document versions", log.Error(err))
-		return nil, gqlutils.Internal(ctx)
-	}
-
-	typesVersions := make([]*types.DocumentVersion, len(versions))
-	for i, v := range versions {
-		typesVersions[i] = types.NewDocumentVersion(v)
-	}
-
-	typesDocuments := make([]*types.Document, len(documents))
-	for i, d := range documents {
-		typesDocuments[i] = types.NewDocument(d)
-	}
-
-	return &types.BulkPublishDocumentVersionsPayload{
-		DocumentVersions: typesVersions,
-		Documents:        typesDocuments,
-	}, nil
-}
-
-// BulkPublishMinorDocumentVersions is the resolver for the bulkPublishMinorDocumentVersions field.
-func (r *mutationResolver) BulkPublishMinorDocumentVersions(ctx context.Context, input types.BulkPublishDocumentVersionsInput) (*types.BulkPublishDocumentVersionsPayload, error) {
-	if len(input.DocumentIds) == 0 {
-		return &types.BulkPublishDocumentVersionsPayload{
-			DocumentVersions: []*types.DocumentVersion{},
-			Documents:        []*types.Document{},
-		}, nil
-	}
-
-	for _, documentID := range input.DocumentIds {
-		if err := r.authorize(ctx, documentID, probo.ActionDocumentVersionPublish); err != nil {
-			return nil, err
-		}
-	}
-
-	prb := r.ProboService(ctx, input.DocumentIds[0].TenantID())
-
-	versions, documents, err := prb.Documents.BulkPublishMinorVersions(ctx, probo.BulkPublishVersionsRequest{
-		DocumentIDs: input.DocumentIds,
-		Changelog:   input.Changelog,
-	})
-	if err != nil {
-		if errors.Is(err, coredata.ErrResourceNotFound) {
-			return nil, gqlutils.NotFound(ctx, err)
-		}
-
-		if errArchived, ok := errors.AsType[*probo.ErrDocumentArchived](err); ok {
-			return nil, gqlutils.Conflict(ctx, errArchived)
-		}
-
-		if errNotDraft, ok := errors.AsType[*probo.ErrDocumentVersionNotDraft](err); ok {
-			return nil, gqlutils.Invalid(ctx, errNotDraft)
-		}
-
-		r.logger.ErrorCtx(ctx, "cannot bulk publish minor document versions", log.Error(err))
-		return nil, gqlutils.Internal(ctx)
-	}
-
-	typesVersions := make([]*types.DocumentVersion, len(versions))
-	for i, v := range versions {
-		typesVersions[i] = types.NewDocumentVersion(v)
-	}
-
-	typesDocuments := make([]*types.Document, len(documents))
-	for i, d := range documents {
-		typesDocuments[i] = types.NewDocument(d)
-	}
-
-	return &types.BulkPublishDocumentVersionsPayload{
-		DocumentVersions: typesVersions,
-		Documents:        typesDocuments,
-	}, nil
-}
-
-// RequestDocumentVersionApproval is the resolver for the requestDocumentVersionApproval field.
-func (r *mutationResolver) RequestDocumentVersionApproval(ctx context.Context, input types.RequestDocumentVersionApprovalInput) (*types.RequestDocumentVersionApprovalPayload, error) {
-	if err := r.authorize(ctx, input.DocumentID, probo.ActionDocumentVersionRequestApproval); err != nil {
-		return nil, err
-	}
-
-	prb := r.ProboService(ctx, input.DocumentID.TenantID())
-
-	quorum, err := prb.DocumentApprovals.RequestApproval(ctx, probo.RequestApprovalRequest{
+	result, err := prb.Documents.PublishVersion(ctx, probo.PublishDocumentRequest{
 		DocumentID:  input.DocumentID,
+		Minor:       input.Minor,
 		ApproverIDs: input.ApproverIds,
 		Changelog:   input.Changelog,
 	})
@@ -1181,7 +1004,15 @@ func (r *mutationResolver) RequestDocumentVersionApproval(ctx context.Context, i
 		}
 
 		if errNotDraft, ok := errors.AsType[*probo.ErrDocumentVersionNotDraft](err); ok {
-			return nil, gqlutils.Conflict(ctx, errNotDraft)
+			return nil, gqlutils.Invalid(ctx, errNotDraft)
+		}
+
+		if errPending, ok := errors.AsType[*probo.ErrDocumentVersionPendingApproval](err); ok {
+			return nil, gqlutils.Conflict(ctx, errPending)
+		}
+
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
 		}
 
 		if errContractEnded, ok := errors.AsType[*probo.ErrProfileContractEnded](err); ok {
@@ -1192,12 +1023,72 @@ func (r *mutationResolver) RequestDocumentVersionApproval(ctx context.Context, i
 			return nil, gqlutils.InvalidValidationErrors(ctx, validationErrors)
 		}
 
-		r.logger.ErrorCtx(ctx, "cannot request document version approval", log.Error(err))
+		r.logger.ErrorCtx(ctx, "cannot publish document", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}
 
-	return &types.RequestDocumentVersionApprovalPayload{
-		ApprovalQuorum: types.NewDocumentVersionApprovalQuorum(quorum),
+	payload := &types.PublishDocumentPayload{
+		Document:        types.NewDocument(result.Document),
+		DocumentVersion: types.NewDocumentVersion(result.Version),
+	}
+	if result.Quorum != nil {
+		payload.ApprovalQuorum = types.NewDocumentVersionApprovalQuorum(result.Quorum)
+	}
+	return payload, nil
+}
+
+// BulkPublishDocuments is the resolver for the bulkPublishDocuments field.
+func (r *mutationResolver) BulkPublishDocuments(ctx context.Context, input types.BulkPublishDocumentsInput) (*types.BulkPublishDocumentsPayload, error) {
+	if len(input.DocumentIds) == 0 {
+		return &types.BulkPublishDocumentsPayload{
+			DocumentVersions: []*types.DocumentVersion{},
+			Documents:        []*types.Document{},
+		}, nil
+	}
+
+	for _, documentID := range input.DocumentIds {
+		if err := r.authorize(ctx, documentID, probo.ActionDocumentVersionPublish); err != nil {
+			return nil, err
+		}
+	}
+
+	prb := r.ProboService(ctx, input.DocumentIds[0].TenantID())
+
+	versions, documents, err := prb.DocumentApprovals.BulkPublishVersions(ctx, probo.BulkPublishVersionsRequest{
+		DocumentIDs: input.DocumentIds,
+		Minor:       input.Minor,
+		Changelog:   input.Changelog,
+	})
+	if err != nil {
+		if errors.Is(err, coredata.ErrResourceNotFound) {
+			return nil, gqlutils.NotFound(ctx, err)
+		}
+
+		if errArchived, ok := errors.AsType[*probo.ErrDocumentArchived](err); ok {
+			return nil, gqlutils.Conflict(ctx, errArchived)
+		}
+
+		if errNotDraft, ok := errors.AsType[*probo.ErrDocumentVersionNotDraft](err); ok {
+			return nil, gqlutils.Invalid(ctx, errNotDraft)
+		}
+
+		r.logger.ErrorCtx(ctx, "cannot bulk publish documents", log.Error(err))
+		return nil, gqlutils.Internal(ctx)
+	}
+
+	typesVersions := make([]*types.DocumentVersion, len(versions))
+	for i, v := range versions {
+		typesVersions[i] = types.NewDocumentVersion(v)
+	}
+
+	typesDocuments := make([]*types.Document, len(documents))
+	for i, d := range documents {
+		typesDocuments[i] = types.NewDocument(d)
+	}
+
+	return &types.BulkPublishDocumentsPayload{
+		DocumentVersions: typesVersions,
+		Documents:        typesDocuments,
 	}, nil
 }
 

pkg/server/api/console/v1/graphql/asset.graphql

@@ -219,6 +219,7 @@ type DeleteDatumPayload {
 input PublishDataListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type PublishDataListPayload {
@@ -229,6 +230,7 @@ type PublishDataListPayload {
 input PublishAssetListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type PublishAssetListPayload {

pkg/server/api/console/v1/graphql/audit.graphql

@@ -276,6 +276,7 @@ extend type Mutation {
 input PublishFindingListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type PublishFindingListPayload {

pkg/server/api/console/v1/graphql/control.graphql

@@ -375,6 +375,7 @@ input DeleteStatementOfApplicabilityInput {
 input PublishStatementOfApplicabilityInput {
     statementOfApplicabilityId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type CreateControlPayload {

pkg/server/api/console/v1/graphql/data_protection_impact_assessment.graphql

@@ -184,11 +184,13 @@ input DeleteTransferImpactAssessmentInput {
 input PublishDataProtectionImpactAssessmentListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 input PublishTransferImpactAssessmentListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type CreateDataProtectionImpactAssessmentPayload {

pkg/server/api/console/v1/graphql/document.graphql

@@ -536,21 +536,12 @@ extend type Mutation {
     archiveDocument(input: ArchiveDocumentInput!): ArchiveDocumentPayload!
     unarchiveDocument(input: UnarchiveDocumentInput!): UnarchiveDocumentPayload!
     deleteDocument(input: DeleteDocumentInput!): DeleteDocumentPayload!
-    publishMajorDocumentVersion(
-        input: PublishMajorDocumentVersionInput!
-    ): PublishDocumentVersionPayload!
-    publishMinorDocumentVersion(
-        input: PublishMinorDocumentVersionInput!
-    ): PublishDocumentVersionPayload!
-    bulkPublishMajorDocumentVersions(
-        input: BulkPublishDocumentVersionsInput!
-    ): BulkPublishDocumentVersionsPayload!
-    bulkPublishMinorDocumentVersions(
-        input: BulkPublishDocumentVersionsInput!
-    ): BulkPublishDocumentVersionsPayload!
-    requestDocumentVersionApproval(
-        input: RequestDocumentVersionApprovalInput!
-    ): RequestDocumentVersionApprovalPayload!
+    publishDocument(
+        input: PublishDocumentInput!
+    ): PublishDocumentPayload!
+    bulkPublishDocuments(
+        input: BulkPublishDocumentsInput!
+    ): BulkPublishDocumentsPayload!
     voidDocumentVersionApproval(
         input: VoidDocumentVersionApprovalInput!
     ): VoidDocumentVersionApprovalPayload!
@@ -641,25 +632,17 @@ input ExportEmployeeDocumentVersionPDFInput {
     documentVersionId: ID!
 }
 
-input PublishMajorDocumentVersionInput {
+input PublishDocumentInput {
     documentId: ID!
-    changelog: String
-}
-
-input PublishMinorDocumentVersionInput {
-    documentId: ID!
-    changelog: String
-}
-
-input BulkPublishDocumentVersionsInput {
-    documentIds: [ID!]!
+    minor: Boolean!
+    approverIds: [ID!]
     changelog: String!
 }
 
-input RequestDocumentVersionApprovalInput {
-    documentId: ID!
-    approverIds: [ID!]!
-    changelog: String
+input BulkPublishDocumentsInput {
+    documentIds: [ID!]!
+    minor: Boolean!
+    changelog: String!
 }
 
 input VoidDocumentVersionApprovalInput {
@@ -756,20 +739,17 @@ type ExportEmployeeDocumentVersionPDFPayload {
     data: String!
 }
 
-type PublishDocumentVersionPayload {
+type PublishDocumentPayload {
     document: Document!
     documentVersion: DocumentVersion!
+    approvalQuorum: DocumentVersionApprovalQuorum
 }
 
-type BulkPublishDocumentVersionsPayload {
+type BulkPublishDocumentsPayload {
     documentVersions: [DocumentVersion!]!
     documents: [Document!]!
 }
 
-type RequestDocumentVersionApprovalPayload {
-    approvalQuorum: DocumentVersionApprovalQuorum!
-}
-
 type VoidDocumentVersionApprovalPayload {
     approvalQuorum: DocumentVersionApprovalQuorum!
     documentVersion: DocumentVersion!

pkg/server/api/console/v1/graphql/obligation.graphql

@@ -96,6 +96,7 @@ extend type Mutation {
 input PublishObligationListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type PublishObligationListPayload {

pkg/server/api/console/v1/graphql/processing_activity.graphql

@@ -262,6 +262,7 @@ input DeleteProcessingActivityInput {
 input PublishProcessingActivityListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type CreateProcessingActivityPayload {

pkg/server/api/console/v1/graphql/risk.graphql

@@ -157,6 +157,7 @@ extend type Mutation {
 input PublishRiskListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type PublishRiskListPayload {

pkg/server/api/console/v1/graphql/vendor.graphql

@@ -465,6 +465,7 @@ extend type Mutation {
 input PublishVendorListInput {
     organizationId: ID!
     approverIds: [ID!]
+    minor: Boolean!
 }
 
 type PublishVendorListPayload {

pkg/server/api/console/v1/obligation_resolvers.go

@@ -120,11 +120,14 @@ func (r *mutationResolver) PublishObligationList(ctx context.Context, input type
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishObligationList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishObligationList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish obligation list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/console/v1/processing_activity_resolvers.go

@@ -132,11 +132,14 @@ func (r *mutationResolver) PublishProcessingActivityList(ctx context.Context, in
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishProcessingActivityList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishProcessingActivityList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish processing activity list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/console/v1/risk_resolvers.go

@@ -247,11 +247,14 @@ func (r *mutationResolver) PublishRiskList(ctx context.Context, input types.Publ
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishRiskList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishRiskList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish risk list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/console/v1/vendor_resolvers.go

@@ -573,11 +573,14 @@ func (r *mutationResolver) PublishVendorList(ctx context.Context, input types.Pu
 
 	prb := r.ProboService(ctx, input.OrganizationID.TenantID())
 
-	document, documentVersion, err := prb.GeneratedDocuments.PublishVendorList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := prb.GeneratedDocuments.PublishVendorList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		if errors.Is(err, coredata.ErrResourceAlreadyExists) {
 			return nil, gqlutils.Conflict(ctx, err)
 		}
+		if errMinor, ok := errors.AsType[*probo.ErrCannotPublishMinorWithoutMajor](err); ok {
+			return nil, gqlutils.Invalid(ctx, errMinor)
+		}
 		r.logger.ErrorCtx(ctx, "cannot publish vendor list", log.Error(err))
 		return nil, gqlutils.Internal(ctx)
 	}

pkg/server/api/mcp/v1/schema.resolvers.go

@@ -3508,74 +3508,6 @@ func (r *Resolver) ListAuditLogEntriesTool(ctx context.Context, req *mcp.CallToo
 	return nil, types.NewListAuditLogEntriesOutput(p), nil
 }
 
-func (r *Resolver) RequestDocumentVersionApprovalTool(ctx context.Context, req *mcp.CallToolRequest, input *types.RequestDocumentVersionApprovalInput) (*mcp.CallToolResult, types.RequestDocumentVersionApprovalOutput, error) {
-	r.MustAuthorize(ctx, input.DocumentID, probo.ActionDocumentVersionRequestApproval)
-
-	svc := r.ProboService(ctx, input.DocumentID)
-
-	quorum, err := svc.DocumentApprovals.RequestApproval(ctx, probo.RequestApprovalRequest{
-		DocumentID:  input.DocumentID,
-		ApproverIDs: input.ApproverIds,
-		Changelog:   input.Changelog,
-	})
-	if err != nil {
-		panic(fmt.Errorf("cannot request document version approval: %w", err))
-	}
-
-	documentVersion, err := svc.Documents.GetVersion(ctx, quorum.VersionID)
-	if err != nil {
-		panic(fmt.Errorf("cannot get document version: %w", err))
-	}
-
-	return nil, types.RequestDocumentVersionApprovalOutput{
-		DocumentVersion: types.NewDocumentVersion(documentVersion),
-	}, nil
-}
-
-func (r *Resolver) PublishMajorDocumentVersionTool(ctx context.Context, req *mcp.CallToolRequest, input *types.PublishMajorDocumentVersionInput) (*mcp.CallToolResult, types.PublishMajorDocumentVersionOutput, error) {
-	r.MustAuthorize(ctx, input.DocumentID, probo.ActionDocumentVersionPublish)
-
-	svc := r.ProboService(ctx, input.DocumentID)
-	user := authn.IdentityFromContext(ctx)
-
-	document, documentVersion, err := svc.Documents.PublishMajorVersion(
-		ctx,
-		input.DocumentID,
-		user.ID,
-		input.Changelog,
-	)
-	if err != nil {
-		panic(fmt.Errorf("cannot publish major document version: %w", err))
-	}
-
-	return nil, types.PublishMajorDocumentVersionOutput{
-		Document:        types.NewDocument(document),
-		DocumentVersion: types.NewDocumentVersion(documentVersion),
-	}, nil
-}
-
-func (r *Resolver) PublishMinorDocumentVersionTool(ctx context.Context, req *mcp.CallToolRequest, input *types.PublishMinorDocumentVersionInput) (*mcp.CallToolResult, types.PublishMinorDocumentVersionOutput, error) {
-	r.MustAuthorize(ctx, input.DocumentID, probo.ActionDocumentVersionPublish)
-
-	svc := r.ProboService(ctx, input.DocumentID)
-	user := authn.IdentityFromContext(ctx)
-
-	document, documentVersion, err := svc.Documents.PublishMinorVersion(
-		ctx,
-		input.DocumentID,
-		user.ID,
-		input.Changelog,
-	)
-	if err != nil {
-		panic(fmt.Errorf("cannot publish minor document version: %w", err))
-	}
-
-	return nil, types.PublishMinorDocumentVersionOutput{
-		Document:        types.NewDocument(document),
-		DocumentVersion: types.NewDocumentVersion(documentVersion),
-	}, nil
-}
-
 func (r *Resolver) ListMeasureDocumentsTool(ctx context.Context, req *mcp.CallToolRequest, input *types.ListMeasureDocumentsInput) (*mcp.CallToolResult, types.ListMeasureDocumentsOutput, error) {
 	r.MustAuthorize(ctx, input.MeasureID, probo.ActionMeasureGet)
 
@@ -3652,7 +3584,7 @@ func (r *Resolver) PublishStatementOfApplicabilityTool(ctx context.Context, req
 
 	svc := r.ProboService(ctx, input.ID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishStatementOfApplicability(ctx, input.ID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishStatementOfApplicability(ctx, input.ID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishStatementOfApplicabilityOutput{}, fmt.Errorf("cannot publish statement of applicability: %w", err)
 	}
@@ -3882,7 +3814,7 @@ func (r *Resolver) PublishDataListTool(ctx context.Context, req *mcp.CallToolReq
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishDataList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishDataList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishDataListOutput{}, fmt.Errorf("cannot publish data list: %w", err)
 	}
@@ -3898,7 +3830,7 @@ func (r *Resolver) PublishAssetListTool(ctx context.Context, req *mcp.CallToolRe
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishAssetList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishAssetList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishAssetListOutput{}, fmt.Errorf("cannot publish asset list: %w", err)
 	}
@@ -4665,7 +4597,7 @@ func (r *Resolver) PublishFindingListTool(ctx context.Context, req *mcp.CallTool
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishFindingList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishFindingList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishFindingListOutput{}, fmt.Errorf("cannot publish finding list: %w", err)
 	}
@@ -4681,7 +4613,7 @@ func (r *Resolver) PublishObligationListTool(ctx context.Context, req *mcp.CallT
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishObligationList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishObligationList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishObligationListOutput{}, fmt.Errorf("cannot publish obligation list: %w", err)
 	}
@@ -4697,7 +4629,7 @@ func (r *Resolver) PublishProcessingActivityListTool(ctx context.Context, req *m
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishProcessingActivityList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishProcessingActivityList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishProcessingActivityListOutput{}, fmt.Errorf("cannot publish processing activity list: %w", err)
 	}
@@ -4713,7 +4645,7 @@ func (r *Resolver) PublishDataProtectionImpactAssessmentListTool(ctx context.Con
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishDataProtectionImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishDataProtectionImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishDataProtectionImpactAssessmentListOutput{}, fmt.Errorf("cannot publish DPIA list: %w", err)
 	}
@@ -4729,7 +4661,7 @@ func (r *Resolver) PublishTransferImpactAssessmentListTool(ctx context.Context,
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishTransferImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishTransferImpactAssessmentList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishTransferImpactAssessmentListOutput{}, fmt.Errorf("cannot publish TIA list: %w", err)
 	}
@@ -4745,7 +4677,7 @@ func (r *Resolver) PublishVendorListTool(ctx context.Context, req *mcp.CallToolR
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishVendorList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishVendorList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishVendorListOutput{}, fmt.Errorf("cannot publish vendor list: %w", err)
 	}
@@ -5098,7 +5030,7 @@ func (r *Resolver) PublishRiskListTool(ctx context.Context, req *mcp.CallToolReq
 
 	svc := r.ProboService(ctx, input.OrganizationID)
 
-	document, documentVersion, err := svc.GeneratedDocuments.PublishRiskList(ctx, input.OrganizationID, input.ApproverIds)
+	document, documentVersion, err := svc.GeneratedDocuments.PublishRiskList(ctx, input.OrganizationID, input.ApproverIds, input.Minor)
 	if err != nil {
 		return nil, types.PublishRiskListOutput{}, fmt.Errorf("cannot publish risk list: %w", err)
 	}
@@ -5222,3 +5154,32 @@ func (r *Resolver) ListSCIMEventsTool(ctx context.Context, req *mcp.CallToolRequ
 
 	return nil, types.NewListSCIMEventsOutput(p), nil
 }
+
+func (r *Resolver) PublishDocumentTool(ctx context.Context, req *mcp.CallToolRequest, input *types.PublishDocumentInput) (*mcp.CallToolResult, types.PublishDocumentOutput, error) {
+	action := probo.ActionDocumentVersionPublish
+	if !input.Minor && len(input.ApproverIds) > 0 {
+		action = probo.ActionDocumentVersionRequestApproval
+	}
+	r.MustAuthorize(ctx, input.DocumentID, action)
+
+	svc := r.ProboService(ctx, input.DocumentID)
+
+	result, err := svc.Documents.PublishVersion(ctx, probo.PublishDocumentRequest{
+		DocumentID:  input.DocumentID,
+		Minor:       input.Minor,
+		ApproverIDs: input.ApproverIds,
+		Changelog:   input.Changelog,
+	})
+	if err != nil {
+		panic(fmt.Errorf("cannot publish document: %w", err))
+	}
+
+	output := types.PublishDocumentOutput{
+		Document:        types.NewDocument(result.Document),
+		DocumentVersion: types.NewDocumentVersion(result.Version),
+	}
+	if result.Quorum != nil {
+		output.ApprovalQuorum = types.NewDocumentVersionApprovalQuorum(result.Quorum)
+	}
+	return nil, output, nil
+}

pkg/server/api/mcp/v1/specification.yaml

@@ -5965,31 +5965,29 @@ components:
         document_version:
           $ref: "#/components/schemas/DocumentVersion"
 
-    PublishMajorDocumentVersionInput:
+    PublishDocumentInput:
       type: object
       required:
         - document_id
+        - minor
+        - changelog
       properties:
         document_id:
           $ref: "#/components/schemas/GID"
           description: Document ID
+        minor:
+          type: boolean
+          description: When true, publish the draft as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
+        approver_ids:
+          type: array
+          items:
+            $ref: "#/components/schemas/GID"
+          description: Approver profile IDs (ignored when minor is true)
         changelog:
           type: string
           description: Changelog for this version
 
-    PublishMinorDocumentVersionInput:
-      type: object
-      required:
-        - document_id
-      properties:
-        document_id:
-          $ref: "#/components/schemas/GID"
-          description: Document ID
-        changelog:
-          type: string
-          description: Changelog for this version
-
-    PublishDocumentVersionOutput:
+    PublishDocumentOutput:
       type: object
       description: document_version.content is markdown
       required:
@@ -6000,33 +5998,9 @@ components:
           $ref: "#/components/schemas/Document"
         document_version:
           $ref: "#/components/schemas/DocumentVersion"
-
-    RequestDocumentVersionApprovalInput:
-      type: object
-      required:
-        - document_id
-        - approver_ids
-      properties:
-        document_id:
-          $ref: "#/components/schemas/GID"
-          description: Document ID
-        approver_ids:
-          type: array
-          items:
-            $ref: "#/components/schemas/GID"
-          description: Approver profile IDs
-        changelog:
-          type: string
-          description: Changelog for this version
-
-    RequestDocumentVersionApprovalOutput:
-      type: object
-      description: document_version.content is markdown
-      required:
-        - document_version
-      properties:
-        document_version:
-          $ref: "#/components/schemas/DocumentVersion"
+        approval_quorum:
+          $ref: "#/components/schemas/DocumentVersionApprovalQuorum"
+          description: Set when an approval was requested instead of publishing.
 
     DeleteDocumentInput:
       type: object
@@ -6721,6 +6695,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6729,7 +6704,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishDataListOutput:
       type: object
@@ -6748,6 +6726,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6756,7 +6735,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishAssetListOutput:
       type: object
@@ -6775,6 +6757,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6783,7 +6766,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishFindingListOutput:
       type: object
@@ -6802,6 +6788,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6810,7 +6797,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishObligationListOutput:
       type: object
@@ -6829,6 +6819,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6837,7 +6828,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishProcessingActivityListOutput:
       type: object
@@ -6856,6 +6850,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6864,7 +6859,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishDataProtectionImpactAssessmentListOutput:
       type: object
@@ -6883,6 +6881,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6891,7 +6890,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishTransferImpactAssessmentListOutput:
       type: object
@@ -6910,6 +6912,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6918,7 +6921,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishVendorListOutput:
       type: object
@@ -6937,6 +6943,7 @@ components:
       type: object
       required:
         - organization_id
+        - minor
       properties:
         organization_id:
           $ref: "#/components/schemas/GID"
@@ -6945,7 +6952,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishRiskListOutput:
       type: object
@@ -6964,6 +6974,7 @@ components:
       type: object
       required:
         - id
+        - minor
       properties:
         id:
           $ref: "#/components/schemas/GID"
@@ -6972,7 +6983,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/GID"
-          description: Optional approver profile IDs. If provided, creates a draft pending approval instead of publishing immediately.
+          description: Optional approver profile IDs. When minor is false and at least one ID is provided, an approval is requested as a major version. Ignored when minor is true.
+        minor:
+          type: boolean
+          description: When true, publish as a minor version (currentMajor.currentMinor+1) and ignore approver_ids; the document must already have a published major version. When false, publish as a new major version; if approver_ids are provided, an approval is requested instead.
 
     PublishStatementOfApplicabilityOutput:
       type: object
@@ -11231,30 +11245,14 @@ tools:
       $ref: "#/components/schemas/GetDocumentVersionInput"
     outputSchema:
       $ref: "#/components/schemas/GetDocumentVersionOutput"
-  - name: publishMajorDocumentVersion
-    description: Publish a draft document version as a new major version
+  - name: publishDocument
+    description: Publish the latest draft of a document. Set minor=true to publish a minor version (no approval flow). When minor=false, providing approver_ids triggers an approval request as a new major version; otherwise the draft is published immediately as a new major version.
     hints:
       readonly: false
     inputSchema:
-      $ref: "#/components/schemas/PublishMajorDocumentVersionInput"
+      $ref: "#/components/schemas/PublishDocumentInput"
     outputSchema:
-      $ref: "#/components/schemas/PublishDocumentVersionOutput"
-  - name: publishMinorDocumentVersion
-    description: Publish a draft document version as a minor version
-    hints:
-      readonly: false
-    inputSchema:
-      $ref: "#/components/schemas/PublishMinorDocumentVersionInput"
-    outputSchema:
-      $ref: "#/components/schemas/PublishDocumentVersionOutput"
-  - name: requestDocumentVersionApproval
-    description: Request approval for a document version
-    hints:
-      readonly: false
-    inputSchema:
-      $ref: "#/components/schemas/RequestDocumentVersionApprovalInput"
-    outputSchema:
-      $ref: "#/components/schemas/RequestDocumentVersionApprovalOutput"
+      $ref: "#/components/schemas/PublishDocumentOutput"
   - name: deleteDocument
     description: Delete a document
     hints: