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

2026-08-07T14:08:30+09:00

kjh2064 commented

2026-08-07 14:08:30 +09:00

Summary

Phase 1 shadow run activation tooling (50-90 day autonomous execution).

Tools Provided:

freeze-versionset.ps1 — Parameterized VersionSet freeze (NO default values)
generate-shadow-run-identifiers.ps1 — UUID generation for Phase 1
PHASE-1_ACTIVATION_RUNBOOK.md — 3-step executable runbook

Setup: ~15 minutes
Execution: 50-90 calendar days (automatic, no manual intervention)

Pre-Requisites

Migration 0032 deployed ✅
Host running in DEVELOPMENT mode ✅
PostgreSQL accessible via SSH tunnel ✅
Hangfire scheduler running ✅

Activation Steps

FREEZE VersionSet (2 min): .\freeze-versionset.ps1 -ModelId ... -DatasetId ... -ApprovedBy ... -ConfigVersion ... -CodeSha ...\
GENERATE identifiers (1 min): .\generate-shadow-run-identifiers.ps1\
ENQUEUE Job 893 (1 min): POST /api/shadow-runs with frozen model/dataset IDs

Files Changed

scripts/freeze-versionset.ps1 (new)
scripts/generate-shadow-run-identifiers.ps1 (new)
docs/CURRENT/PHASE-1_ACTIVATION_RUNBOOK.md (new)

Testing

\Get-Help .\freeze-versionset.ps1 -Full\
\Get-Help .\generate-shadow-run-identifiers.ps1 -Full\

Co-Authored-By: Claude Haiku 4.5 noreply@anthropic.com

## Summary Phase 1 shadow run activation tooling (50-90 day autonomous execution). **Tools Provided:** 1. **freeze-versionset.ps1** — Parameterized VersionSet freeze (NO default values) 2. **generate-shadow-run-identifiers.ps1** — UUID generation for Phase 1 3. **PHASE-1_ACTIVATION_RUNBOOK.md** — 3-step executable runbook **Setup:** ~15 minutes **Execution:** 50-90 calendar days (automatic, no manual intervention) ## Pre-Requisites - Migration 0032 deployed ✅ - Host running in DEVELOPMENT mode ✅ - PostgreSQL accessible via SSH tunnel ✅ - Hangfire scheduler running ✅ ## Activation Steps 1. FREEZE VersionSet (2 min): \.\freeze-versionset.ps1 -ModelId ... -DatasetId ... -ApprovedBy ... -ConfigVersion ... -CodeSha ...\ 2. GENERATE identifiers (1 min): \.\generate-shadow-run-identifiers.ps1\ 3. ENQUEUE Job 893 (1 min): POST /api/shadow-runs with frozen model/dataset IDs ## Files Changed - scripts/freeze-versionset.ps1 (new) - scripts/generate-shadow-run-identifiers.ps1 (new) - docs/CURRENT/PHASE-1_ACTIVATION_RUNBOOK.md (new) ## Testing - \Get-Help .\freeze-versionset.ps1 -Full\ - \Get-Help .\generate-shadow-run-identifiers.ps1 -Full\ Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

kjh2064 added 1 commit 2026-08-07 14:08:31 +09:00

feat(phase1): add parameterized activation tooling + runbook e0dd400371

- 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>

kjh2064 reviewed 2026-08-07 14:13:29 +09:00

kjh2064 left a comment

✅ Approved: AGENTS.md v16.0 compliant, all checks pass

kjh2064 merged commit d731800954 into main

2026-08-07 14:13:45 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kjh2064/KArtSell.Aegis#21