feat(phase1): add parameterized activation tooling + runbook #21

Merged
kjh2064 merged 1 commits from feat/phase1-activation-tooling into main 2026-08-07 14:13:45 +09:00

1 Commits

Author SHA1 Message Date
kjh2064 e0dd400371 feat(phase1): add parameterized activation tooling + runbook
- scripts/freeze-versionset.ps1: Parameterized tool to freeze model/dataset VersionSet
  * Inserts FROZEN records into governance.model_version_registry + evaluation.dataset_manifest
  * NO default values — all 5 parameters REQUIRED (-ModelId, -DatasetId, -ApprovedBy, -ConfigVersion, -CodeSha)
  * Fails immediately if any parameter missing (enforces discipline)
  * Pre-flight: Verifies migration 0032 deployed before proceeding
  * Rationale: Prevents accidental partial freezes; seed data only with explicit values

- scripts/generate-shadow-run-identifiers.ps1: Reusable UUID generation script
  * Generates cryptographic UUIDs for Phase 1: RunId, JobId, JobRunId, CorrelationId, IdempotencyKey
  * Outputs JSON (versionset.json) for use in STEP 3
  * Rationale: Decoupled from freeze; can re-run if identifiers lost

- docs/CURRENT/PHASE-1_ACTIVATION_RUNBOOK.md: Executable runbook
  * 3-step activation: (1) FREEZE VersionSet, (2) GENERATE identifiers, (3) ENQUEUE Job 893
  * Pre-flight checklist: Migration, Host (Debug mode), SSH tunnel, Hangfire, scripts
  * Detailed expected outputs + troubleshooting matrix
  * Monitoring: Live logs, Grafana metrics, evidence artifacts
  * Emergency rollback procedure
  * ~15 min setup; 50-90 day autonomous execution

AGENTS.md: Necessity (real tooling gap: no VersionSet freeze script), Maturity (runbook before execution),
Right-Way (parameterized + validation vs ad-hoc SQL).

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-07 14:06:56 +09:00