tegwick
8447943dc0
Add import_content_tree management command and import_tree helper for ADR-0004 sample trees. Document reichelag rehearsal lossiness; mark T02/T04 and the bubble exit workplan finished.
3.3 KiB
3.3 KiB
Migration rehearsal — reichelag sample (2026-08-13)
| Field | Value |
|---|---|
| Workplan | CSOC-WP-0001-T04 |
| Depends on | CSOC-WP-0006 PageOps landing pad |
| Source (local only) | ~/.config/coulomb-social/auth/exports/corpus-202608131015057/trees/reichelag/ |
| Destination | CONTENT_ROOT/spaces/reichelag/ (local; not committed) |
| Command | manage.py import_content_tree |
Do not commit source trees or imported content — private business notes.
Command
export CONTENT_ROOT="$PWD/var/content-rehearsal" # or default var/content
uv run python manage.py migrate
# sign-in once or ensure a Member exists for --member-subject
uv run python manage.py import_content_tree \
~/.config/coulomb-social/auth/exports/corpus-202608131015057/trees/reichelag \
--tenant tenant:coulomb \
--member-subject <your-oidc-subject> \
--replace
Dry-run:
uv run python manage.py import_content_tree PATH/TO/tree --dry-run
Result (this run)
| Metric | Value |
|---|---|
| Pages copied | 30 (1 index + 29 articles) |
| Assets copied | 29 (logo/visual images) |
| Space row | Created reichelag title ReichelAG |
| Render path | load_space_page → source=content-plane |
| Index title | ReichelAG |
| Sample page | frontmatter title + markdown body render OK |
| Visual files | Present under assets/ for pages that declare them |
Lossiness and residuals
| Gap | Severity | Note |
|---|---|---|
Bubble Slug vs export slug |
low | Bubble space slug was new-space-36; export/tree uses friendly reichelag |
| Space display title | medium | Not first-class on custom.space; taken from index frontmatter / guess |
| Membership list | medium | Only local owner from --member-subject; Bubble members_list_user not mapped to NetKingdom |
| Parent/article graph | medium | Frontmatter parent kept as opaque bubble id; no outline/include graph yet |
| Full corpus coverage | high | Only one dense sample tree; 70 other spaces not imported; many spaces have incomplete article dumps |
| Chunk / Research UI | deferred | Bubble pg_chunk / Research surfaces not in tree |
| Workflows / privacy flags | deferred | isprivate_boolean not enforced in rebuild authz beyond tenant membership |
| Identity | blocked elsewhere | Member transfer assist / public registration (CSOC-IN-0001) |
| Production path | deferred | Rehearsal is local CONTENT_ROOT; cluster import needs operator CONTENT_ROOT volume + tenant choice |
What worked losslessly (for this tree)
- Page Title / Abstractor / Visual frontmatter → PageOps + Space index fields
- Markdown body → content-plane render (bleach markdown pipeline)
- Relative visual assets under
assets/ - Page list via
list_pages - Idempotent re-import with
--replace
Acceptance against CSOC-WP-0001
- At least one migration rehearsal run
- Residual gaps listed (above)
- Bulk multi-space import + NK membership map — residual
- Apex cutover — still gated on product parity + self-registration
Related
- Export progress:
docs/migration/export-progress-2026-08-13.md - Field map:
docs/migration/field-map-from-session-2026-08-13.md - PageOps:
coulomb_social/apps/spaces/pageops.py,import_tree.py - Stage-1 cut:
docs/decisions/2026-08-12-feature-cut-stage-1.md