Description
Publication and Comment Moderation give administrators a scriptable way to control what a public Dotabase exposes and how reader feedback is governed. dots publications publishes, unpublishes, and lists public configurations with an explicit slug, view set, and visible-property whitelist. dots comments lists moderation projections, hides a comment on its exact row, and reviews reported-comment queues.
The workflow is designed for operators and coding agents. It uses the same authenticated, company-scoped service contracts as the rest of Dots, so terminal or protocol convenience never creates a second source of truth. Inputs are validated before or at the route boundary, and outputs preserve identifiers and structured details needed for a reliable next step.
Selling Points
- Makes public exposure explicit at the view and property level.
- Supports repeatable publication configuration instead of ad hoc UI state.
- Keeps comment removal scoped to the exact stored comment and row.
- Provides a dedicated queue for reported content requiring review.
- Lets administrators audit current publications and moderation actions headlessly.
User Story
An administrator publishes a curated view under a chosen slug with only approved properties visible. Later, they review the reported-comment queue, inspect the relevant row, and hide one abusive comment without taking the entire publication offline. The result is a concrete, inspectable outcome that another person or automation can continue from without reconstructing hidden state.
Extension Surface
The surface is automatable: packages/cli/src/commands/publications.ts and packages/cli/src/commands/comments.ts bind a closed set of publishing and moderation operations. The rating reflects the most-open supported seam that is true for this capability, not a transitive implementation detail. The cited path is the operational proof: consumers can use the documented seam, while unsupported changes still require a core release.
Capabilities & Limits
- Capability: Publish, unpublish, and list web publication configurations.
- Capability: Visible-property and published-view whitelisting.
- Capability: Comment listing, exact removal, and report-queue review.
- Limit: The CLI administers supported publication settings and comments; it is not a general website builder or a substitute for editorial judgment.
The limit is intentional product truth rather than missing documentation. Calls also remain subject to authentication, tenant selection, schema validation, and the permissions enforced by the authoritative service.
Implementation Map
packages/cli/src/commands/publications.tspackages/cli/src/commands/comments.tspackages/cli/src/commands/comments-client.ts