skillhub/docs
Xudong Sun 21ba6ee938 fea: implement skill label system end to end (#140)
* docs(label): add skill label system design spec

Covers data model, permission model, search integration,
API design, and frontend design for the label system.

* docs(label): address spec review findings

- Add CHECK constraint on label_definition.type, deny-by-default in app layer
- Use TIMESTAMPTZ consistently for all new tables
- Add (label_id) index on skill_label for filter performance
- Add label count limits (10 per skill, 100 definitions)
- Detail async rebuild strategy (Spring @Async, batch 50, error isolation)
- Clarify search_vector is GENERATED STORED column, auto-maintained
- Expand SearchQuery with labelSlugs field, detail SQL changes
- Define all API response JSON structures
- Clarify PUT update: no slug in body, full-replace translations
- Clarify hard delete with audit_log
- Add cross-namespace permission boundary (promotion scenario)
- Pre-reserve multi-label API param for future
- Clarify ClawHub compat layer: no label support in phase 1

* docs(label): address second-round spec review findings

- Fix chapter numbering (duplicate "6." → "6." + "7.")
- Move labelSlugs to end of SearchQuery record to reduce breaking change
- Add TIMESTAMPTZ convention note for new tables
- Clarify async rebuild transaction boundary (per-skill independent tx)
- Move rebuildByLabelId to app layer to preserve module boundaries
- Clarify multi-label filter uses OR semantics with AND extension path

* docs(label): fix section numbering in frontend design chapter

* Implement skill label system end to end

* Unify label app services and DTOs

* Add admin label management page

* Add label admin backend tests

* Fix merge fallout in generated schema
2026-03-20 15:26:41 +08:00
..
superpowers chore(docs): remove select redesign spec 2026-03-20 14:27:20 +08:00
00-product-direction.md refactor: skill lifecycle projection and docs (#78) 2026-03-18 13:39:22 +08:00
01-system-architecture.md refactor(app): clarify query boundaries and workflow owners 2026-03-20 11:33:32 +08:00
02-domain-model.md refactor(app): slim portal controllers and sync backend findings 2026-03-20 10:09:03 +08:00
03-authentication-design.md refactor(app): slim portal controllers and sync backend findings 2026-03-20 10:09:03 +08:00
04-search-architecture.md feat: add search index rebuild workflow 2026-03-19 15:20:08 +08:00
05-business-flows.md refactor(app): slim portal controllers and sync backend findings 2026-03-20 10:09:03 +08:00
06-api-design.md refactor(app): slim portal controllers and sync backend findings 2026-03-20 10:09:03 +08:00
07-skill-protocol.md refactor: skill lifecycle projection and docs (#78) 2026-03-18 13:39:22 +08:00
08-frontend-architecture.md refactor: skill lifecycle projection and docs (#78) 2026-03-18 13:39:22 +08:00
09-deployment.md chore(runtime): default release runtime to latest 2026-03-19 20:36:45 +08:00
10-delivery-roadmap.md refactor: skill lifecycle projection and docs (#78) 2026-03-18 13:39:22 +08:00
11-auth-extensibility-and-private-sso.md feat(auth): improve extensible login method metadata 2026-03-14 18:52:35 +08:00
12-private-sso-integration-playbook.md feat(auth): improve extensible login method metadata 2026-03-14 18:52:35 +08:00
13-parallel-workflow.md refactor(dev): replace agent-* commands with parallel-* workflow 2026-03-14 20:49:17 +08:00
14-skill-lifecycle.md refactor: skill lifecycle projection and docs (#78) 2026-03-18 13:39:22 +08:00
15-backend-time-governance-plan.md refactor: unify backend time handling in utc 2026-03-18 17:16:55 +08:00
16-backend-time-inventory.md fix: resolve duplicate flyway migration versions 2026-03-19 10:06:25 +08:00
17-backend-annotation-findings.md refactor(app): clarify query boundaries and workflow owners 2026-03-20 11:33:32 +08:00
18-frontend-annotation-findings.md docs: enrich frontend code documentation 2026-03-19 13:37:21 +08:00
2026-03-20-skill-label-system-design.md fea: implement skill label system end to end (#140) 2026-03-20 15:26:41 +08:00
dev-workflow.md test: cover namespace workflow smoke paths 2026-03-16 16:03:46 +08:00
openclaw-integration-en.md docs: align clawhub env vars with public docs 2026-03-19 17:39:38 +08:00
openclaw-integration.md docs: align clawhub env vars with public docs 2026-03-19 17:39:38 +08:00