jmagly Provenance Validate Command
Validate provenance records against the PROV schema and verify chain integrity.
Instructions
When invoked, validate provenance:
Load records
- Scan
.aiwg/research/provenance/records/for all.prov.yamlfiles - If specific path provided, validate only that record
- Scan
Schema validation
- Validate each record against
@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/provenance/prov-record.yaml - Check required fields: entity.id, activity.id, agent.id
- Verify URN format compliance
- Verify timestamps are valid ISO-8601
- Validate each record against
Entity resolution
- For each entity URN, verify the referenced file exists
- Flag orphaned records (file deleted but provenance remains)
- Detect untracked artifacts (files in tracked directories without provenance)
Chain integrity
- Verify wasDerivedFrom sources exist and have their own provenance
- Check bidirectional links (forward references have matching back-references)
- Detect broken chains (missing intermediate records)
Completeness check
- Scan
.aiwg/directories for artifacts without provenance records - Calculate coverage percentage
- List untracked artifacts
- Scan
Fix mode (--fix)
- Remove orphaned provenance records
- Create stub records for untracked artifacts
- Add missing bidirectional references
Report
- Display validation results table
- Show pass/fail/warning counts
- List specific issues with remediation steps
Arguments
[path]- Specific record or directory to validate (default: all records)--all- Validate all records and check completeness--strict- Treat warnings as errors--fix- Auto-fix issues where possible--report [path]- Save validation report to file
References
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/provenance-manager.md - Provenance Manager agent
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/provenance/prov-record.yaml - PROV record schema
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/provenance-tracking.md - Provenance tracking rules