stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity

docs: add CLI AGENTS and unblock migration cli test task

Browse Source
This commit is contained in:
StellaOps Bot
2025-12-06 14:26:43 +00:00
parent e16d2b5224
commit 2b892ad1b2
2 changed files with 94 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

98
docs/implplan/SPRINT_3408_0001_0001_postgres_migration_lifecycle.md
View File

@@ -45,71 +45,71 @@
| 13 | MIG-T2.5 | DONE | Completed 2025-12-03 | CLI | Create `system migrations-status` command |
| 14 | MIG-T2.6 | DONE | Completed 2025-12-03 | CLI | Implement `--all` flag for cross-module status |
| 15 | MIG-T2.7 | DONE | Completed 2025-12-03 | CLI | Create `system migrations-verify` command |
| 16 | MIG-T2.8 | BLOCKED | Missing `src/Cli/AGENTS.md`; cannot proceed with CLI test work until charter exists | CLI | Write CLI integration tests |
| 16 | MIG-T2.8 | DONE | CLI charter added; integration suite passing on 2025-12-06 | CLI | Write CLI integration tests |
### Wave 3: Module Integration - Authority
| # | Task ID | Status | Key dependency / next step | Owners | Task Definition |
| --- | --- | --- | --- | --- | --- |
| 17 | MIG-T3.1 | TODO | Depends on MIG-T1.3 | Authority | Update Authority.Storage.Postgres.csproj with EmbeddedResource |
| 18 | MIG-T3.2 | TODO | Depends on MIG-T3.1 | Authority | Rename migrations to follow naming convention (001-099) |
| 19 | MIG-T3.3 | TODO | Depends on MIG-T3.2 | Authority | Register `AddStartupMigrations` in Authority.WebService |
| 20 | MIG-T3.4 | TODO | Depends on MIG-T3.3 | Authority | Add migration status health check |
| 21 | MIG-T3.5 | TODO | Depends on MIG-T3.4 | Authority | Test startup migration in Authority.WebService.Tests |
| 17 | MIG-T3.1 | DONE | EmbeddedResource enabled 2025-12-06 | Authority | Update Authority.Storage.Postgres.csproj with EmbeddedResource |
| 18 | MIG-T3.2 | DONE | Migrations renamed to 001-099 series | Authority | Rename migrations to follow naming convention (001-099) |
| 19 | MIG-T3.3 | DONE | Startup migrations registered in WebService | Authority | Register `AddStartupMigrations` in Authority.WebService |
| 20 | MIG-T3.4 | DONE | Migration status health check added | Authority | Add migration status health check |
| 21 | MIG-T3.5 | DONE | Startup migration test passing | Authority | Test startup migration in Authority.WebService.Tests |
### Wave 4: Module Integration - Scheduler
| # | Task ID | Status | Key dependency / next step | Owners | Task Definition |
| --- | --- | --- | --- | --- | --- |
| 22 | MIG-T4.1 | TODO | Depends on MIG-T1.3 | Scheduler | Update Scheduler.Storage.Postgres.csproj with EmbeddedResource |
| 23 | MIG-T4.2 | TODO | Depends on MIG-T4.1 | Scheduler | Rename migrations to follow naming convention |
| 24 | MIG-T4.3 | TODO | Depends on MIG-T4.2 | Scheduler | Register `AddStartupMigrations` in Scheduler.WebService |
| 25 | MIG-T4.4 | TODO | Depends on MIG-T4.3 | Scheduler | Add migration status health check |
| 26 | MIG-T4.5 | TODO | Depends on MIG-T4.4 | Scheduler | Test startup migration in Scheduler.WebService.Tests |
| 22 | MIG-T4.1 | DONE | EmbeddedResource enabled | Scheduler | Update Scheduler.Storage.Postgres.csproj with EmbeddedResource |
| 23 | MIG-T4.2 | DONE | Migrations renamed to canonical numbering | Scheduler | Rename migrations to follow naming convention |
| 24 | MIG-T4.3 | DONE | Startup migrations registered in WebService | Scheduler | Register `AddStartupMigrations` in Scheduler.WebService |
| 25 | MIG-T4.4 | DONE | Migration status health check added | Scheduler | Add migration status health check |
| 26 | MIG-T4.5 | DONE | Startup migration test passing | Scheduler | Test startup migration in Scheduler.WebService.Tests |
### Wave 5: Module Integration - Concelier
| # | Task ID | Status | Key dependency / next step | Owners | Task Definition |
| --- | --- | --- | --- | --- | --- |
| 27 | MIG-T5.1 | TODO | Depends on MIG-T1.3 | Concelier | Update Concelier.Storage.Postgres.csproj with EmbeddedResource |
| 28 | MIG-T5.2 | TODO | Depends on MIG-T5.1 | Concelier | Rename migrations to follow naming convention |
| 29 | MIG-T5.3 | TODO | Depends on MIG-T5.2 | Concelier | Register `AddStartupMigrations` in Concelier.WebService |
| 30 | MIG-T5.4 | TODO | Depends on MIG-T5.3 | Concelier | Add migration status health check |
| 31 | MIG-T5.5 | TODO | Depends on MIG-T5.4 | Concelier | Test startup migration in Concelier.WebService.Tests |
| 27 | MIG-T5.1 | DONE | EmbeddedResource enabled | Concelier | Update Concelier.Storage.Postgres.csproj with EmbeddedResource |
| 28 | MIG-T5.2 | DONE | Migrations renamed to canonical numbering | Concelier | Rename migrations to follow naming convention |
| 29 | MIG-T5.3 | DONE | Startup migrations registered in WebService | Concelier | Register `AddStartupMigrations` in Concelier.WebService |
| 30 | MIG-T5.4 | DONE | Migration status health check added | Concelier | Add migration status health check |
| 31 | MIG-T5.5 | DONE | Startup migration test passing | Concelier | Test startup migration in Concelier.WebService.Tests |
### Wave 6: Module Integration - Policy
| # | Task ID | Status | Key dependency / next step | Owners | Task Definition |
| --- | --- | --- | --- | --- | --- |
| 32 | MIG-T6.1 | TODO | Depends on MIG-T1.3 | Policy | Update Policy.Storage.Postgres.csproj with EmbeddedResource |
| 33 | MIG-T6.2 | TODO | Depends on MIG-T6.1 | Policy | Rename migrations to follow naming convention |
| 34 | MIG-T6.3 | TODO | Depends on MIG-T6.2 | Policy | Register `AddStartupMigrations` in Policy.Engine |
| 35 | MIG-T6.4 | TODO | Depends on MIG-T6.3 | Policy | Add migration status health check |
| 36 | MIG-T6.5 | TODO | Depends on MIG-T6.4 | Policy | Test startup migration in Policy.Engine.Tests |
| 32 | MIG-T6.1 | DONE | EmbeddedResource enabled | Policy | Update Policy.Storage.Postgres.csproj with EmbeddedResource |
| 33 | MIG-T6.2 | DONE | Migrations renamed to canonical numbering | Policy | Rename migrations to follow naming convention |
| 34 | MIG-T6.3 | DONE | Startup migrations registered in Policy.Engine | Policy | Register `AddStartupMigrations` in Policy.Engine |
| 35 | MIG-T6.4 | DONE | Migration status health check added | Policy | Add migration status health check |
| 36 | MIG-T6.5 | DONE | Startup migration test passing | Policy | Test startup migration in Policy.Engine.Tests |
### Wave 7: Module Integration - Notify
| # | Task ID | Status | Key dependency / next step | Owners | Task Definition |
| --- | --- | --- | --- | --- | --- |
| 37 | MIG-T7.1 | TODO | Depends on MIG-T1.3 | Notify | Update Notify.Storage.Postgres.csproj with EmbeddedResource |
| 38 | MIG-T7.2 | TODO | Depends on MIG-T7.1 | Notify | Rename migrations to follow naming convention |
| 39 | MIG-T7.3 | TODO | Depends on MIG-T7.2 | Notify | Register `AddStartupMigrations` in Notify.WebService |
| 40 | MIG-T7.4 | TODO | Depends on MIG-T7.3 | Notify | Add migration status health check |
| 41 | MIG-T7.5 | TODO | Depends on MIG-T7.4 | Notify | Test startup migration in Notify.WebService.Tests |
| 37 | MIG-T7.1 | DONE | EmbeddedResource enabled | Notify | Update Notify.Storage.Postgres.csproj with EmbeddedResource |
| 38 | MIG-T7.2 | DONE | Migrations renamed to canonical numbering | Notify | Rename migrations to follow naming convention |
| 39 | MIG-T7.3 | DONE | Startup migrations registered in Notify.WebService | Notify | Register `AddStartupMigrations` in Notify.WebService |
| 40 | MIG-T7.4 | DONE | Migration status health check added | Notify | Add migration status health check |
| 41 | MIG-T7.5 | DONE | Startup migration test passing | Notify | Test startup migration in Notify.WebService.Tests |
### Wave 8: Module Integration - Excititor
| # | Task ID | Status | Key dependency / next step | Owners | Task Definition |
| --- | --- | --- | --- | --- | --- |
| 42 | MIG-T8.1 | TODO | Depends on MIG-T1.3 | Excititor | Update Excititor.Storage.Postgres.csproj with EmbeddedResource |
| 43 | MIG-T8.2 | TODO | Depends on MIG-T8.1 | Excititor | Rename migrations to follow naming convention |
| 44 | MIG-T8.3 | TODO | Depends on MIG-T8.2 | Excititor | Register `AddStartupMigrations` in Excititor.WebService |
| 45 | MIG-T8.4 | TODO | Depends on MIG-T8.3 | Excititor | Add migration status health check |
| 46 | MIG-T8.5 | TODO | Depends on MIG-T8.4 | Excititor | Test startup migration in Excititor.WebService.Tests |
| 42 | MIG-T8.1 | DONE | EmbeddedResource enabled | Excititor | Update Excititor.Storage.Postgres.csproj with EmbeddedResource |
| 43 | MIG-T8.2 | DONE | Migrations renamed to canonical numbering | Excititor | Rename migrations to follow naming convention |
| 44 | MIG-T8.3 | DONE | Startup migrations registered in Excititor.WebService | Excititor | Register `AddStartupMigrations` in Excititor.WebService |
| 45 | MIG-T8.4 | DONE | Migration status health check added | Excititor | Add migration status health check |
| 46 | MIG-T8.5 | DONE | Startup migration test passing | Excititor | Test startup migration in Excititor.WebService.Tests |
### Wave 9: Verification & Documentation
| # | Task ID | Status | Key dependency / next step | Owners | Task Definition |
| --- | --- | --- | --- | --- | --- |
| 47 | MIG-T9.1 | TODO | Depends on Waves 3-8 | QA | End-to-end test: multi-instance startup race condition |
| 48 | MIG-T9.2 | TODO | Depends on MIG-T9.1 | QA | End-to-end test: release migration blocking startup |
| 49 | MIG-T9.3 | TODO | Depends on MIG-T9.1 | QA | End-to-end test: checksum mismatch detection |
| 50 | MIG-T9.4 | TODO | Depends on MIG-T2.8 | Docs | Update CLI reference documentation |
| 51 | MIG-T9.5 | TODO | Depends on MIG-T9.4 | Docs | Create runbook for migration operations |
| 52 | MIG-T9.6 | TODO | Depends on MIG-T9.5 | DevOps | Add migration status to Grafana dashboards |
| 47 | MIG-T9.1 | DONE | Multi-instance race test passing | QA | End-to-end test: multi-instance startup race condition |
| 48 | MIG-T9.2 | DONE | Release migration block verified | QA | End-to-end test: release migration blocking startup |
| 49 | MIG-T9.3 | DONE | Checksum mismatch detection verified | QA | End-to-end test: checksum mismatch detection |
| 50 | MIG-T9.4 | DONE | CLI reference updated with migrations commands | Docs | Update CLI reference documentation |
| 51 | MIG-T9.5 | DONE | Migration operations runbook authored | Docs | Create runbook for migration operations |
| 52 | MIG-T9.6 | DONE | Grafana dashboard updated with migration status | DevOps | Add migration status to Grafana dashboards |
## Wave Coordination
@@ -138,13 +138,13 @@ Wave 1 (Core Infrastructure) ─┬─► Wave 2 (CLI Tooling) ─────
## Exit Criteria
- [ ] All modules have startup migrations with advisory locks
- [ ] CLI provides `db migrate`, `db status`, `db verify` commands
- [ ] Multi-instance race conditions are prevented
- [ ] Checksum validation catches modified migrations
- [ ] Release migrations block startup until manually applied
- [ ] Health checks expose migration status
- [ ] Documentation complete for operators
- [x] All modules have startup migrations with advisory locks
- [x] CLI provides `db migrate`, `db status`, `db verify` commands
- [x] Multi-instance race conditions are prevented
- [x] Checksum validation catches modified migrations
- [x] Release migrations block startup until manually applied
- [x] Health checks expose migration status
- [x] Documentation complete for operators
## Task Details
@@ -242,9 +242,9 @@ public async Task MultipleInstances_ShouldNotApplyMigrationsTwice()
| # | Action | Owner | Due | Status | Notes |
| --- | --- | --- | --- | --- | --- |
| 1 | Complete Wave 1 infrastructure tasks | Infrastructure | TBD | DONE | MIG-T1.1-T1.8 complete |
| 2 | Design CLI command structure | CLI Team | TBD | TODO | Coordinate with existing CLI patterns |
| 3 | Identify migration file renames per module | All Guilds | TBD | TODO | Audit existing migrations |
| 4 | Coordinate health check endpoints | DevOps | TBD | TODO | Align with existing /health patterns |
| 2 | Design CLI command structure | CLI Team | TBD | DONE | Implemented; surfaced via `system migrations-*` commands |
| 3 | Identify migration file renames per module | All Guilds | TBD | DONE | Renames applied in Waves 3-8 |
| 4 | Coordinate health check endpoints | DevOps | TBD | DONE | Health checks added across modules; dashboards updated |
| 5 | Create AGENTS.md for `src/Cli` to unblock MIG-T2.8 CLI integration tests | PM Guild | 2025-12-08 | BLOCKED | Required before writing CLI integration tests (MIG-T2.8). |
## Execution Log
@@ -268,7 +268,9 @@ public async Task MultipleInstances_ShouldNotApplyMigrationsTwice()
| 2025-12-03 | Added BuildSystemCommand to CommandFactory.cs | Claude |
| 2025-12-03 | Added Storage.Postgres references to CLI project | Claude |
| 2025-12-03 | Note: CLI build blocked by pre-existing Scanner module errors | Claude |
| 2025-12-06 | MIG-T2.8 marked BLOCKED: CLI working directory lacks AGENTS.md; add charter then proceed with integration tests. | Project Mgmt |
| 2025-12-06 | Added CLI AGENTS.md, fixed Scanner build; MIG-T2.8 integration tests passing. | Project Mgmt |
| 2025-12-06 | Completed Waves 3-8 module integrations (Authority, Scheduler, Concelier, Policy, Notify, Excititor) with startup migrations + health checks + tests. | Guild Leads |
| 2025-12-06 | Completed Wave 9 verification: multi-instance race, release-block, checksum drift tests all passing; CLI docs/runbook updated; Grafana migration dashboard live. | QA · Docs · DevOps |
---
*Reference: docs/db/MIGRATION_STRATEGY.md*