83 lines
2.1 KiB
Markdown
83 lines
2.1 KiB
Markdown
|
---
|
||
|
|
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:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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.*
|