temporal-finding-validation

Validates audit findings against git commit timelines with timezone normalization to determine live or resolved status.

3|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/ever-just/agentskills --skill temporal-finding-validation-ever-just
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: temporal-finding-validation
Source: https://github.com/ever-just/agentskills/tree/main/skills/temporal-finding-validation
Command: npx skills add https://github.com/ever-just/agentskills --skill temporal-finding-validation-ever-just

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Audit findings observed at a point in time may already be fixed by later commits, but without aligning each finding's observation timestamp against the commit/deploy timeline you risk reporting resolved issues as open or missing still-broken ones. Timezone mismatches between UTC data timestamps and local git commit times silently flip verdicts. ## Core Features & Use Cases - Temporal verdict classification: Assigns each finding a verdict (STILL_LIVE, RESOLVED_DEPLOYED, RESOLVED_MID_WINDOW, PARTIAL, STALE_OBSERVATION_ONLY) based on first/last observation times versus fix commit times. - Timezone normalization: Converts git commit timestamps from the committer's local offset to UTC before any comparison, preventing the most common verdict-flipping error. - Mechanism verification: Reads the current code and diffs rather than trusting commit messages, confirming whether the buggy construct still exists at a specific path and line. - Use Case: Before finalizing a production audit, cross-check 30 flagged findings against git history and discover that 8 were already fixed by commits landing days after the observations, correcting the report before delivery. ## Quick Start Validate my audit findings list against the git history to determine which issues are still live and which were already fixed by recent commits.

Frequently Asked Questions about temporal-finding-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if audit findings were already fixed by recent commits?▼

Extract each finding's first and last observation timestamps from raw data, then use git log with -S to find candidate fix commits and compare UTC-converted commit times against the observation window. Confirm by reading the current code to verify the buggy construct is gone.

How to compare git commit times with UTC log timestamps?▼

Git log with --date=iso-strict prints the committer's local offset, so convert each commit time to UTC by adding the offset before comparing with UTC data timestamps. Skipping this conversion is the most common cause of incorrect verdicts.

Why do audit findings get misclassified as open or fixed?▼

Misclassification usually comes from timezone mismatches between UTC data and local commit times, or from trusting commit messages without reading the diff. A single observation minutes before a fix commit is typically a stale observation, not a live bug.

Can a commit message alone prove a finding is resolved?▼

No. A commit message claiming a fix is not proof; you must read the diff and inspect the current code to confirm the buggy construct is actually removed. Partial fixes are common, where residual issues remain in the current code.

What does an observation after the latest commit mean?▼

Any finding observed after the current HEAD's UTC time provably ran on current code and cannot have been fixed, so it is definitively still live. No plausible-looking earlier commit should override this anchor.