KArtSell.Aegis/docs/CURRENT/AEG-VS-00-05_JOBRUN_SCHEMA_DECISION_REQUIRED.md

AEG-VS-00-05 — JobRun schema decision required

Source / Assumption / Unknown / Decision Required

• Source: src/KArtSell.BuildingBlocks/Reliability/DapperJobRunRepository.cs, JobRun.cs, src/KArtSell.DbMigrator/ migration inventory, and WBS acceptance evidence.
• Assumption: building_blocks.job_run is intended to be the durable JobRun store for scope, idempotency, watermark, VersionSet, hashes, status, heartbeat, and trace correlation.
• Unknown: approved authoritative schema owner, retention policy, append/correction history model, operational indexes beyond the existing baseline, and test database connection.
• Decision Required: DBA/Data/Ops must approve the existing baseline contract and any follow-up migration before changing 0014 or later. No AI-generated migration is approved by this note.

Finding

DapperJobRunRepository issues insert/update statements against building_blocks.job_run. The authoritative migration input db/migrations/0000_building_blocks.sql creates the table, and src/KArtSell.DbMigrator/KArtSell.DbMigrator.csproj includes db/migrations/**/*.sql in the migration bundle. The existing WBS tracker and acceptance artifact claim AEG-VS-00-05 completed, but no preserved fresh/upgrade/re-run/failure migration evidence for this table was found.

Safe disposition

• Reclassify AEG-VS-00-05 as IN_PROGRESS; do not claim async JobRun completion.
• Do not add a guessed follow-up migration, status constraint, index, retention rule, or production database mutation.
• Keep automatic order/KIS capabilities disabled.
• Next approved Slice must define contract/schema/tests first, then rehearse fresh install, upgrade, re-run, and failure paths against the approved test database.

Execution evidence — 2026-08-12

Command: dotnet test tests/KArtSell.Integration.Tests/KArtSell.Integration.Tests.csproj --no-restore -c Release --filter FullyQualifiedName~DbUpMigrationTests

• Result: 12 tests failed during InitializeAsync because PostgreSQL at 127.0.0.1:5432 refused the connection.
• The test harness targeted its approved isolated database path, but no database mutation or schema assertion was reached.
• This is environment-unavailable evidence, not evidence that building_blocks.job_run exists or is absent.
• dotnet test tests/KArtSell.ArchitectureTests/KArtSell.ArchitectureTests.csproj --no-restore -c Release: 16/16 passed, including a static repository-to-baseline-column contract check. This is source-level drift evidence only and does not replace DB rehearsal.