Files

tegwick 235355eb58 feat(dashboard): nav restructure, full context-help coverage, 11 new ref docs

Navigation:
- New order: Overview · Todo · Domains · Repos · Workstreams (collapsible,
  open:false, with atomic sub-entries: Decisions, Tasks, Debt, Extends,
  Dependencies) · Contributions · SBOM · Progress · Reference (collapsible)
- Reference section gains path:/reference landing page; all 18 doc pages
  listed in nav (alphabetical) and in reference.md table

New pages:
- todo.md — Internal / Ecosystem / Third-party todo classification
- dependencies.md — dependency edge table derived from state/summary
- reference.md — Reference landing page with full doc index

New reference doc pages (11):
  contributions, debt, dependencies, domains, extensions, overview,
  repos, tasks, todo + reference (meta) already added previously

doc-overlay.js — lazy bubblehelp tooltip:
- _titleCache Map + _fetchDocTitle(docPath): on first hover of any ?
  button, fetches the target doc page, parses <h1>, sets btn.title
- Native browser tooltip appears exactly on the ? circle on subsequent hover

Context-help wired on all 14 dashboard pages:
- h1 withDocHelp added to: index, todo, domains, repos, tasks, techdept,
  extensions, dependencies (contributions/workstreams/decisions/sbom/
  progress/reference were already wired)
- domains.md + repos.md: added missing withDocHelp import and live-data link
- tasks/techdept/extensions: removed duplicate _h1 const that caused
  SyntaxError: Identifier '_h1' has already been declared

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-01 23:46:26 +01:00

2.1 KiB

Raw Blame History

title

title
Domains — Reference

Domains — Reference

The Domains page shows all registered project domains and the repositories associated with each one. Domains are the top-level organisational unit of the Custodian ecosystem.

What is a domain?

A domain corresponds to one of the six tracked project areas:

Slug	Project
`custodian`	The Custodian agent system itself
`railiance`	DevOps & infrastructure reliability
`markitect`	Knowledge artifact management
`coulomb_social`	Co-creation marketplace
`personhood`	Rights & obligations framework
`foerster_capabilities`	Agency capability taxonomy

Each domain has a slug (URL-friendly identifier), a human-readable name, an optional description, and a status.

Domain statuses

Status	Meaning
active	Live domain — topics, workstreams, and tasks are being tracked
archived	Soft-deleted; no active work. Fails to archive if active topics exist

KPI row

Four counters at the top of the page:

Counter	Meaning
Total domains	All registered domains regardless of status
Active	Domains with status `active`
Total repos	Sum of all registered repositories across all domains
Newest domain	Name of the most recently created domain

Domain cards

One card per domain showing:

Slug — monospace identifier
Status badge — green active or grey archived
Name — display name
Description — first 160 characters
Repos — list of registered repositories for this domain, each showing name, local path, and remote URL

Managing domains

Via MCP:

create_domain(slug="my_project", name="My Project", description="…")
rename_domain(slug="old_slug", new_slug="new_slug", new_name="New Name")
archive_domain(slug="my_project")   # fails if active topics exist

Via Makefile:

make add-domain SLUG=my_project NAME="My Project"
make rename-domain OLD_SLUG=my_project NEW_SLUG=myproject NEW_NAME="My Project"

Domains are never hard-deleted — only archived.

2.1 KiB Raw Blame History