Hartmut
4a5edeef3e
CI / Unit Tests (pull_request) Successful in 5m46s
CI / Lint (pull_request) Failing after 3m49s
CI / E2E Tests (pull_request) Has been skipped
CI / Fresh-Linux Docker Deploy (pull_request) Has been skipped
CI / Assistant Split Regression (pull_request) Failing after 35s
CI / Architecture Guardrails (pull_request) Failing after 2m14s
CI / Typecheck (pull_request) Successful in 4m22s
CI / Build (pull_request) Has been skipped
CI / Release Images (pull_request) Has been skipped
- @capakraken/* → @nexus/* across 12 packages (root + 11 workspaces),
1551 import lines migrated via codemod
- User-visible brand strings renamed (emails, page titles, PWA
manifest, mobile header, MFA backup-codes header, tooltips, signin
page, invite page, weekly digest, install prompt)
- TOTP issuer "CapaKraken" → "Nexus" (existing secrets still valid;
re-enrollment relabels them in users' authenticator apps)
- Function rename: assertCapaKrakenDbTarget → assertNexusDbTarget
- LocalStorage migration shim in apps/web/src/app/layout.tsx copies
capakraken_* → nexus_* on first load (guarded by nexus_migrated_v1
sentinel; runs once per browser, then never again)
- Service-worker cache name capakraken-v2 → nexus-v2 with one-time
caches.delete('capakraken-v2') from the same shim
- Email-domain fixtures @capakraken.{dev,app} → @nexus.{dev,app} in
seed data, e2e specs, SMTP default fallback
- Dockerfile.dev / Dockerfile.prod / all .github/workflows/*.yml
pnpm --filter @capakraken/* → @nexus/*
- README, CLAUDE.md, LEARNINGS.md, all docs/*.md, .env.example,
tooling/deploy/.env.production.example brand sweep
Phase 1 deliberately leaves untouched (handled in Phase 3 cutover):
- PostgreSQL DB name "capakraken" and POSTGRES_USER "capakraken"
- Volume names capakraken_pgdata etc.
- Compose project name "capakraken" / "capakraken-prod"
- db-target-guard default expectedDatabase
- env-var CAPAKRAKEN_EXPECTED_DB_NAME
- Container DNS names in docker-compose.ci.yml
Quality gates green: pnpm typecheck (7/7), pnpm test:unit (7/7),
pnpm lint (0 errors), check:exports/imports/architecture all pass.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
46 lines
5.3 KiB
Markdown
46 lines
5.3 KiB
Markdown
# Documentation Index
|
|
|
|
**Date:** 2026-03-12
|
|
**Purpose:** Single entry point for active Nexus product and technical documentation.
|
|
|
|
## Canonical Documents
|
|
|
|
| Topic | File | Use |
|
|
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
|
| AI excellence due diligence | [ai-excellence-due-diligence-roadmap.md](/home/hartmut/Documents/Copilot/nexus/docs/ai-excellence-due-diligence-roadmap.md) | Frank quality assessment and cleanup roadmap toward a showcase AI-built project |
|
|
| Showcase quality backlog | [showcase-quality-backlog.md](/home/hartmut/Documents/Copilot/nexus/docs/showcase-quality-backlog.md) | Consolidated working backlog for the current quality and maintainability north star |
|
|
| Parallel worktree hygiene | [parallel-worktree-hygiene.md](/home/hartmut/Documents/Copilot/nexus/docs/parallel-worktree-hygiene.md) | Keep parallel worker slices isolated and the worktree reviewable |
|
|
| Target CI/CD architecture | [cicd-target-architecture.md](/home/hartmut/Documents/Copilot/nexus/docs/cicd-target-architecture.md) | Canonical image-based build, deploy, and rollback flow |
|
|
| Active roadmap and open gaps | [product-roadmap.md](/home/hartmut/Documents/Copilot/nexus/docs/product-roadmap.md) | Primary backlog and current delivery order |
|
|
| Estimating system design | [estimating-extension-design.md](/home/hartmut/Documents/Copilot/nexus/docs/estimating-extension-design.md) | Workbook analysis, field mapping, and implementation plan |
|
|
| Dispo import implementation | [dispo-import-implementation.md](/home/hartmut/Documents/Copilot/nexus/docs/dispo-import-implementation.md) | Clean-slate Dispo v2 import design, mapping rules, staging flow, and commit policy |
|
|
| Dispo import ticket pack | [dispo-import-implementation-tickets.md](/home/hartmut/Documents/Copilot/nexus/docs/dispo-import-implementation-tickets.md) | Worker-ready delivery slices, dependencies, and acceptance criteria for the Dispo import |
|
|
| Demand/assignment cutover guide | [demand-assignment-migration-cutover.md](/home/hartmut/Documents/Copilot/nexus/docs/demand-assignment-migration-cutover.md) | Go/no-go criteria, staged cutover, and readiness artifact policy |
|
|
| Strategic architecture direction | [v2-architecture-proposal-2026-03-11.md](/home/hartmut/Documents/Copilot/nexus/research/v2-architecture-proposal-2026-03-11.md) | Longer-horizon architecture target |
|
|
| Implementation history | [LEARNINGS.md](/home/hartmut/Documents/Copilot/nexus/LEARNINGS.md) | Append-only decisions and lessons |
|
|
| Agent/project guidance | [CLAUDE.md](/home/hartmut/Documents/Copilot/nexus/CLAUDE.md) | Working conventions and quality gates |
|
|
|
|
## Archive Policy
|
|
|
|
Older plan and proposal markdown files stay in the repository only as archive notes when:
|
|
|
|
- the feature is already implemented enough to leave the active backlog
|
|
- the content was merged into a canonical document
|
|
- the file still has historical value, but should not drive current work
|
|
|
|
Archive-note files should point back to the relevant canonical document instead of carrying parallel backlog state.
|
|
|
|
## Current Archive Notes
|
|
|
|
All archived markdown plan and proposal files now live under `docs/old-markdowns/`.
|
|
|
|
- [plan.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/plan.md)
|
|
- [rename-nexus-to-nexus-plan.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/rename-nexus-to-nexus-plan.md)
|
|
- [PLAN_SKILLMATRIX.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/PLAN_SKILLMATRIX.md)
|
|
- [refactor-sprint-plan.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/refactor-sprint-plan.md)
|
|
- [estimating-field-mapping.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/estimating-field-mapping.md)
|
|
- [cgi-breakdown-implementation-proposal.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/cgi-breakdown-implementation-proposal.md)
|
|
- [architecture-evaluation-2026-03-06.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/architecture-evaluation-2026-03-06.md)
|
|
- [perf-audit-2026-03-09.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/perf-audit-2026-03-09.md)
|
|
- [review-report-2026-03-15-computation-graph.md](/home/hartmut/Documents/Copilot/nexus/docs/old-markdowns/review-report-2026-03-15-computation-graph.md)
|