Registry Auditor Tool

Overview

Automated audit and repair tool for the Langfuse prompt registry. Hydrates lifecycle labels, backfills missing metadata on gene prompts, and repairs broken production prompts with fallback templates.

Available Operations

Label Hydration

• Labels - Promote all latest-only prompts to appropriate lifecycle labels
• Automatically determines label based on prompt name (production, staging, experimental)
• Idempotent: skips prompts that already have multiple labels

Metadata Backfill

• Metadata - Backfill missing metadata fields on gene-* prompts
• Required fields: model_family, provider, latency_tier, status
• Only targets gene prompts; skips agents and other types

Broken Prompt Repair

• Repair - Re-initialize broken production prompts with fallback templates
• Requires force: true for destructive operations
• Creates minimal but valid prompt structure

Full Audit

• All - Run all three operations in sequence
• Default operation when none specified

Parameters

Parameter	Type	Required	Description
operation	string	No	One of: labels, metadata, repair, all (default: all)
dryRun	boolean	No	Preview changes without applying (default: false)
force	boolean	No	Enable destructive operations like repair (default: false)

Safety Modes

• Dry Run (dryRun: true): Preview all changes without applying any
• Force (force: true): Required for broken prompt repair operations
• Default mode is safe: no changes applied without explicit dryRun=false

Use Cases

• Initial registry hydration after setup
• Periodic health checks on prompt registry
• Recovering from corrupted or incomplete prompt deployments
• Standardizing metadata across all gene prompts