Description
Tag Taxonomy and Categories provides a persistent, tenant-scoped registry for custom tag categories and their display and behavior metadata. Categories are validated, stored in the platform database, and managed through the same service boundary used by API, CLI, and MCP callers.
Selling Points
- Gives tag governance a durable category vocabulary per company.
- Carries display name, description, color, ordering, and behavior flags.
- Supports guarded create, update, delete, list, and merge operations.
- Preserves merged aliases while retagging affected rows atomically.
User Story
A curator creates a company-specific category, updates its display name, and later merges a duplicate category into the canonical one without losing existing row assignments.
Extension Surface
Automatable: API, CLI, MCP, and trusted service compositions call the tenant-scoped registry service. Category keys and mutation permissions remain platform-governed.
Capabilities & Limits
- Capability: Persists custom category definitions and ordering per company.
- Capability: Updates, deletes, and merges custom categories through guarded operations.
- Limit: This is a custom-category registry, not a fixed built-in taxonomy or a marketplace for executable category logic.
Implementation Map
packages/tags/src/registry.tspackages/tags/src/service.tspackages/db/src/schema/tag-system.ts