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>
14 KiB
14 KiB
title
| title |
|---|
| Technical Debt |
const API = "http://127.0.0.1:8000";
const POLL = 15_000;
const tdState = (async function*() {
while (true) {
let data = [], ok = false;
try {
const [rt, rw, rto] = await Promise.all([
fetch(`${API}/technical-debt/`),
fetch(`${API}/workstreams/`),
fetch(`${API}/topics/`),
]);
ok = rt.ok && rw.ok && rto.ok;
if (ok) {
const [tdList, wsList, topicList] = await Promise.all([rt.json(), rw.json(), rto.json()]);
const topicMap = Object.fromEntries(topicList.map(t => [t.id, t]));
const wsMap = Object.fromEntries(wsList.map(w => [w.id, {
...w, domain: topicMap[w.topic_id]?.domain_slug ?? "unknown",
}]));
data = tdList.map(t => ({
...t,
workstream_title: wsMap[t.workstream_id]?.title ?? null,
})).sort((a, b) => {
const sv = {critical: 0, high: 1, medium: 2, low: 3};
const st = {open: 0, in_progress: 1, deferred: 2, resolved: 3, wont_fix: 4};
const sd = (st[a.status] ?? 9) - (st[b.status] ?? 9);
return sd !== 0 ? sd : (sv[a.severity] ?? 9) - (sv[b.severity] ?? 9);
});
}
} catch {}
yield {data, ok, ts: new Date()};
await new Promise(res => setTimeout(res, POLL));
}
})();
const data = tdState.data ?? [];
const _ok = tdState.ok ?? false;
const _ts = tdState.ts;
import {MultiSelect} from "./components/multiselect.js";
const STATUSES = ["open", "in_progress", "resolved", "deferred", "wont_fix"];
const SEVERITIES = ["critical", "high", "medium", "low"];
const _domainsResp = await fetch(`${API}/domains/?status=active`).catch(() => null);
const DOMAINS = _domainsResp?.ok
? (await _domainsResp.json()).map(d => d.slug)
: ["custodian", "railiance", "markitect", "coulomb_social", "personhood", "foerster_capabilities"];
const DEBT_TYPES = ["design", "implementation", "test", "docs", "dependencies", "performance", "security", "other"];
const _filtersForm = Inputs.form(
{
status: MultiSelect(STATUSES, {label: "Status", placeholder: "All statuses"}),
severity: MultiSelect(SEVERITIES, {label: "Severity", placeholder: "All severities"}),
domain: MultiSelect(DOMAINS, {label: "Domain", placeholder: "All domains"}),
debt_type: MultiSelect(DEBT_TYPES, {label: "Type", placeholder: "All types"}),
},
{
template: ({status, severity, domain, debt_type}) => html`<div class="filter-bar">
${status}${severity}${domain}${debt_type}
</div>`,
}
);
const filters = Generators.input(_filtersForm);
const filtered = data.filter(t =>
(filters.status.length === 0 || filters.status.includes(t.status)) &&
(filters.severity.length === 0 || filters.severity.includes(t.severity)) &&
(filters.domain.length === 0 || filters.domain.includes(t.domain)) &&
(filters.debt_type.length === 0 || filters.debt_type.includes(t.debt_type))
);
Technical Debt
import {injectTocTop} from "./components/toc-sidebar.js";
import {withDocHelp} from "./components/doc-overlay.js";
import {openEntityModal} from "./components/entity-modal.js";
// ── KPI sidebar ───────────────────────────────────────────────────────────────
const _open = data.filter(t => t.status === "open" || t.status === "in_progress");
const _critical = data.filter(t => t.severity === "critical" && t.status === "open");
const _high = data.filter(t => t.severity === "high" && t.status === "open");
const _resolved = data.filter(t => t.status === "resolved");
const _total = data.filter(t => t.status !== "wont_fix").length;
const _resolvedPct = _total > 0 ? Math.round(_resolved.length / _total * 100) : 0;
const _kpiBox = html`<div class="kpi-infobox">
<div class="kpi-infobox-title">Tech Debt</div>
<div class="kpi-row">
<span class="kpi-row-label">open</span>
<div class="kpi-row-right"><div class="kpi-row-value">${_open.length}</div></div>
</div>
<div class="kpi-row">
<span class="kpi-row-label">critical</span>
<div class="kpi-row-right">
<div class="kpi-row-value" style="color:${_critical.length > 0 ? '#dc2626' : 'inherit'}">${_critical.length}</div>
</div>
</div>
<div class="kpi-row">
<span class="kpi-row-label">high</span>
<div class="kpi-row-right">
<div class="kpi-row-value" style="color:${_high.length > 0 ? '#d97706' : 'inherit'}">${_high.length}</div>
</div>
</div>
<div class="kpi-row" style="border-top:1px solid var(--theme-foreground-faint,#eee)">
<span class="kpi-row-label">resolved</span>
<div class="kpi-row-right">
<div class="kpi-row-value">${_resolved.length}</div>
<div class="kpi-row-sub">${_resolvedPct}% of total</div>
</div>
</div>
</div>`;
// ── Live indicator ─────────────────────────────────────────────────────────────
const _liveEl = html`<div class="live-indicator">
<span style="color:${_ok ? 'var(--theme-foreground-focus)' : 'red'}">●</span>
${_ok
? `Live · updated ${_ts?.toLocaleTimeString()}`
: html`<span style="color:red">Offline — run: <code>make api</code></span>`}
</div>`;
withDocHelp(_liveEl, "/docs/live-data");
injectTocTop("td-kpi-box", _kpiBox);
injectTocTop("live-indicator", _liveEl);
const _h1 = document.querySelector("#observablehq-main h1");
if (_h1) _h1.style.position = "relative";
By Type & Severity
import * as Plot from "npm:@observablehq/plot";
const SEVERITY_COLOR = {critical: "#dc2626", high: "#ea580c", medium: "#3b82f6", low: "#94a3b8"};
const TYPE_COLOR = {
design: "#8b5cf6", implementation: "#3b82f6", test: "#f59e0b",
docs: "#10b981", dependencies: "#6366f1", performance: "#ec4899",
security: "#dc2626", other: "#94a3b8",
};
const bySeverity = SEVERITIES
.map(s => ({severity: s, count: filtered.filter(t => t.severity === s && t.status !== "resolved" && t.status !== "wont_fix").length}))
.filter(d => d.count > 0);
const byType = DEBT_TYPES
.map(t => ({type: t, count: filtered.filter(d => d.debt_type === t).length}))
.filter(d => d.count > 0);
if (filtered.length === 0) {
display(html`<p class="dim">No technical debt items match the current filter.</p>`);
} else {
display(html`<div class="chart-row">
${bySeverity.length > 0 ? Plot.plot({
marks: [
Plot.barX(bySeverity, {y: "severity", x: "count", fill: d => SEVERITY_COLOR[d.severity] ?? "#94a3b8", tip: true}),
Plot.ruleX([0]),
],
marginLeft: 80, width: 300, title: "Open by severity",
}) : ""}
${byType.length > 0 ? Plot.plot({
marks: [
Plot.barX(byType, {y: "type", x: "count", fill: d => TYPE_COLOR[d.type] ?? "#94a3b8", tip: true}),
Plot.ruleX([0]),
],
marginLeft: 110, width: 360, title: "By type",
}) : ""}
</div>`);
}
Critical & High
const _urgent = filtered.filter(t => (t.severity === "critical" || t.severity === "high") && t.status === "open");
if (_urgent.length === 0) {
display(html`<p class="dim">No critical or high severity open items in current filter. ✓</p>`);
} else {
display(html`<div class="td-list">${_urgent.map(t => html`
<div class="td-item td-sev-${t.severity} entity-row"
onclick=${() => openEntityModal(t, "td")}
title="Click to view full details">
<div class="td-item-header">
${t.td_id ? html`<span class="td-ref">${t.td_id}</span>` : ""}
<span class="td-sev-badge td-sev-${t.severity}">${t.severity}</span>
<span class="td-type-badge">${t.debt_type}</span>
<span class="td-domain">${t.domain}</span>
${t.workstream_title ? html`<span class="td-ws" title=${t.workstream_title}>${t.workstream_title}</span>` : ""}
</div>
<div class="td-title">${t.title}</div>
${t.description ? html`<div class="td-desc">${t.description.slice(0, 220)}${t.description.length > 220 ? " …" : ""}</div>` : ""}
${t.location ? html`<div class="td-location"><code>${t.location}</code></div>` : ""}
</div>
`)}</div>`);
}
All Technical Debt
display(_filtersForm);
display(html`<p><strong>${filtered.length}</strong> items shown.</p>`);
display(html`<div class="td-list">${filtered.map(t => html`
<div class="td-item td-status-${t.status} entity-row"
onclick=${() => openEntityModal(t, "td")}
title="Click to view full details">
<div class="td-item-header">
${t.td_id ? html`<span class="td-ref">${t.td_id}</span>` : ""}
<span class="td-sev-badge td-sev-${t.severity}">${t.severity}</span>
<span class="td-type-badge">${t.debt_type}</span>
<span class="td-badge td-badge-${t.status}">${t.status.replace("_", " ")}</span>
<span class="td-domain">${t.domain}</span>
${t.workstream_title ? html`<span class="td-ws" title=${t.workstream_title}>${t.workstream_title}</span>` : ""}
</div>
<div class="td-title">${t.title}</div>
${t.description ? html`<div class="td-desc">${t.description.slice(0, 220)}${t.description.length > 220 ? " …" : ""}</div>` : ""}
${t.location ? html`<div class="td-location"><code>${t.location}</code></div>` : ""}
</div>
`)}
</div>`);