Principia to Domus Migration Report

Overview

Migration from monolithic Principia PKMS (02_Assets + 03_Captures) to distributed domus-* Antora ecosystem.

Philosophy: Graduate from single-repo knowledge base to enterprise-grade multi-repo documentation with hub-spoke aggregation.

Migration Status

Completed Migrations

Source (Principia) Destination (domus-*) Lines Status

03_Captures/

domus-captures

~15,000

COMPLETE

PRJ-ISE-HOME-LINUX-ANTORA

domus-ise-linux

22,043

COMPLETE

PRJ-NETAPI-ANTORA

domus-netapi-docs

24,102

COMPLETE

PRJ-SECRETS + OPS-SECRETS-MANAGEMENT

domus-secrets-ops

6,170

COMPLETE

Infrastructure runbooks

domus-infra-ops

21,089

COMPLETE

Linux operations

domus-linux-ops

27,867

COMPLETE

Hub/aggregator

domus-docs

 — 

COMPLETE

Gabriel’s learning

domus-gabriel-docs

 — 

NEW

Total migrated: ~116,000+ lines of documentation

Pending Migrations

Source (Principia) Lines Suggested domus-* Priority

PRJ-PKI-HOME

4,938

domus-pki-ops

HIGH

PED-VIOLIN-ANTORA

2,001

domus-violin

MEDIUM

OPS-SIEM-QRADAR

1,954

domus-siem-ops

HIGH

PRJ-PFSENSE-HOME

1,936

domus-firewall-ops

MEDIUM

PRJ-DOTFILES

1,697

domus-dotfiles

LOW

PED-CELLO

1,460

domus-cello

MEDIUM

PRJ-HOME-NETWORK

1,439

Merge → domus-infra-ops

LOW

PRJ-AERC-ANTORA

982

domus-email-ops

LOW

Not Migrating (Remain in Principia)

Category Reason

ARS-* (Archives)

Reference material, not active documentation

DIS-* (Disciplines)

Academic study notes, personal learning

LRN-* (Learning)

Course materials, certifications prep

PER-* (Personal)

Private documents, finances, health

TAB-* (Tables)

Working tables, inbox, kanban

FDY-* (Foundry)

Experimental, lab work

Architecture

Hub-Spoke Model

                    ┌─────────────────┐
                    │   domus-docs    │
                    │   (Hub/Aggregator)│
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│domus-captures │  │domus-ise-linux│  │domus-infra-ops│
│  (chronicles) │  │   (802.1X)    │  │(infrastructure)│
└───────────────┘  └───────────────┘  └───────────────┘
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│domus-netapi   │  │domus-secrets  │  │domus-linux-ops│
│    (CLI)      │  │   (dsec)      │  │  (workstation)│
└───────────────┘  └───────────────┘  └───────────────┘

Component Registry

Repository Antora Component URL

domus-docs

home

docs.domusdigitalis.dev

domus-captures

captures

captures.domusdigitalis.dev

domus-ise-linux

prj-ise-home-linux

 — 

domus-infra-ops

infra-ops

 — 

domus-linux-ops

linux-ops

 — 

domus-netapi-docs

netapi

 — 

domus-secrets-ops

secrets-infrastructure

 — 

domus-gabriel-docs

gabriel-docs

 — 

Remotes Strategy

Each domus-* repo pushes to three remotes:

  • origin: GitHub (public/primary)

  • gitlab: GitLab (mirror)

  • gitea: Self-hosted Gitea (internal backup)

Migration Procedure

To migrate a Principia project:

# 1. Create new domus-* repo
mkdir domus-<name>
cd domus-<name>
git init

# 2. Copy Antora structure
cp -r ../domus-captures/{Makefile,package.json,docs,supplemental-ui} .

# 3. Update antora.yml
# - Change component name
# - Update title, version

# 4. Copy content from Principia
cp -r ~/Principia/02_Assets/PRJ-<NAME>-ANTORA/docs/asciidoc/modules/* docs/modules/

# 5. Add partials include to all docs
# include::partial$attributes.adoc[]

# 6. Test build
make

# 7. Setup remotes
git remote add origin git@github.com:EvanusModestus/domus-<name>.git
git remote add gitlab git@gitlab.com:EvanusModestus/domus-<name>.git
git remote add gitea ssh://git@gitea-01.inside.domusdigitalis.dev:2222/evanusmodestus/domus-<name>.git

# 8. Push
git add -A && git commit -m "feat: Initial migration from Principia"
git push -u origin main && git push gitlab main && git push gitea main

Principia Inventory

Total projects in 02_Assets/: 261

Prefix Count Description

PRJ-

~50

Active projects (primary migration candidates)

ARS-

~80

Archives/reference (stay in Principia)

OPS-

~20

Operations runbooks (selective migration)

PED-

~5

Pedagogy/teaching (migrate music projects)

LRN-

~25

Learning/courses (stay in Principia)

PER-

~15

Personal (never migrate)

DIS-

~20

Disciplines (stay in Principia)

Others

~46

Various (case-by-case)

Session Log: 2026-02-07

Infrastructure Completed

Item Details

Cloudflare Pages (domus-docs)

Deployed to docs.domusdigitalis.dev with Zero Trust auth

Deploy Hooks

GitHub webhooks on all 5 content repos → auto-rebuild on push

Lunr Search

Enabled with styled dropdown (dark/light/catppuccin themes)

Theme System

3 themes (Dark, Catppuccin Mocha, Light) with toggle button

Windows DC Runbook

domus-infra-ops/runbooks/windows-dc-core.adoc - 7-phase migration guide

domus-captures Updates

  • Synced theme with domus-docs (custom.css)

  • Added Lunr search scripts to footer-scripts.hbs

  • Added theme toggle, copy buttons, scroll-to-top

  • Build script ready for Cloudflare Pages (./build.sh)

Repos with Deploy Hooks

All push to these repos trigger automatic docs.domusdigitalis.dev rebuild:

  • domus-infra-ops

  • domus-ise-linux

  • domus-netapi-docs

  • domus-secrets-ops

  • domus-linux-ops

Next Steps

  1. [ ] Deploy domus-captures to Cloudflare Pages (captures.domusdigitalis.dev)

  2. [ ] Migrate PRJ-PKI-HOME → domus-pki-ops

  3. [ ] Migrate OPS-SIEM-QRADAR → domus-siem-ops

  4. [ ] Migrate PRJ-PFSENSE-HOME → domus-firewall-ops

  5. [ ] Migrate PED-VIOLIN-ANTORA → domus-violin

  6. [ ] Setup domus-gabriel-docs for Gabriel’s learning journey

Report generated: 2026-02-07 Last updated: 2026-02-07 (Session with Claude)