generated from coulomb/repo-seed
tegwick
fcd0f06536
Replaces the hardcoded 6-domain PostgreSQL ENUM with a first-class
`domains` DB table, and adds a `managed_repos` table for multi-repo
support per domain.
P1 — Domain as a DB entity:
- Migration b1c2d3e4f5a6: creates `domains` table, migrates topics.domain
ENUM column to domain_id FK, drops the domain ENUM type
- Domain ORM model (api/models/domain.py) + Pydantic schemas
- Domain API router: GET/POST /domains/, GET/PATCH /domains/{slug}/,
rename and archive endpoints with EP/TD cascade on rename
- Topic model updated: domain_id FK + @property domain_slug for
backwards-compatible JSON serialization (field renamed domain → domain_slug)
- TopicCreate/TopicRead updated; seed.py rewritten to use FK lookup
P2 — Multi-repo support:
- ManagedRepo ORM model (api/models/managed_repo.py) + schemas
- Repo API router: GET/POST /repos/, GET/PATCH /repos/{slug}/, archive
- Makefile: add-domain, rename-domain, add-repo, list-repos targets
- register_project.sh: verify domain via /domains/ API + POST /repos/
P3 — MCP tools & live validation:
- 6 new MCP tools: list_domains, create_domain, rename_domain,
archive_domain, list_domain_repos, register_repo
- EP/TD routers: replace hardcoded VALID_DOMAINS set with per-request
DB lookup — returns 422 with list of valid slugs on unknown domain
- State summary: adds domains: list[DomainSummary] (slug, name,
repo_count, active_workstream_count, ep_count, td_count)
- TOOLS.md updated with domain management section
P4 — Dashboard:
- New domains.md page with KPI row + domain cards + repo lists
- domains.json.py + repos.json.py data loaders
- Domains page added to observablehq.config.js nav
- workstreams.md, extensions.md, techdept.md: domain_slug fix +
dynamic domain list loaded from /domains/ API (no longer hardcoded)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
80 lines
2.0 KiB
Python
80 lines
2.0 KiB
Python
import uuid
|
|
from datetime import datetime
|
|
|
|
from pydantic import BaseModel
|
|
|
|
from api.schemas.decision import DecisionRead
|
|
from api.schemas.domain import DomainSummary
|
|
from api.schemas.progress_event import ProgressEventRead
|
|
from api.schemas.task import TaskRead
|
|
from api.schemas.topic import TopicWithWorkstreams
|
|
from api.schemas.workstream import WorkstreamWithDeps
|
|
|
|
|
|
class TopicTotals(BaseModel):
|
|
active: int = 0
|
|
paused: int = 0
|
|
archived: int = 0
|
|
total: int = 0
|
|
|
|
|
|
class WorkstreamTotals(BaseModel):
|
|
active: int = 0
|
|
blocked: int = 0
|
|
completed: int = 0
|
|
archived: int = 0
|
|
total: int = 0
|
|
|
|
|
|
class TaskTotals(BaseModel):
|
|
todo: int = 0
|
|
in_progress: int = 0
|
|
blocked: int = 0
|
|
done: int = 0
|
|
cancelled: int = 0
|
|
total: int = 0
|
|
|
|
|
|
class DecisionTotals(BaseModel):
|
|
open: int = 0
|
|
resolved: int = 0
|
|
escalated: int = 0
|
|
superseded: int = 0
|
|
total: int = 0
|
|
|
|
|
|
class Totals(BaseModel):
|
|
topics: TopicTotals
|
|
workstreams: WorkstreamTotals
|
|
tasks: TaskTotals
|
|
decisions: DecisionTotals
|
|
|
|
|
|
class NextStep(BaseModel):
|
|
"""A derived suggestion pointing to where work should happen next.
|
|
|
|
Suggestions are never persisted — they are computed on demand from
|
|
current hub state: recently resolved decisions, newly unblocked tasks,
|
|
cleared dependencies.
|
|
"""
|
|
type: str # unblocked_task | resolved_decision | dependency_cleared
|
|
domain: str | None = None
|
|
workstream_id: uuid.UUID | None = None
|
|
workstream_title: str | None = None
|
|
workstream_slug: str | None = None
|
|
task_id: uuid.UUID | None = None
|
|
task_title: str | None = None
|
|
message: str # plain-language explanation
|
|
|
|
|
|
class StateSummary(BaseModel):
|
|
generated_at: datetime
|
|
totals: Totals
|
|
topics: list[TopicWithWorkstreams]
|
|
blocking_decisions: list[DecisionRead]
|
|
blocked_tasks: list[TaskRead]
|
|
recent_progress: list[ProgressEventRead]
|
|
open_workstreams: list[WorkstreamWithDeps]
|
|
next_steps: list[NextStep] = []
|
|
domains: list[DomainSummary] = []
|