Detect Structural Drift From Audit History

v20260707

harness-drift-from-history

This tool simplifies the process of detecting structural drift by combining audit listing, fresh auditing, and trend diffing into a single command. It finds the most recent audit record, runs a current audit against the repository, and compares the two using structural similarity metrics. It alerts when the structural distance falls below a specified threshold, helping maintain code consistency over time.

Bash Auditing Drift Detection CI/CD

Get Skill

353 downloads

Overview

The natural ops question after running oia-audit weekly is "did anything drift?" Before this skill, the answer required a three-step sequence:

npx ruflo metaharness audit-list --format json   # → pick a key by hand
npx ruflo metaharness oia-audit --format json > /tmp/curr.json
npx ruflo metaharness audit-trend \
  --baseline-key <picked-key> --current /tmp/curr.json \
  --alert-on-distance-below 0.95

This skill collapses it into one command:

npx ruflo metaharness drift-from-history --threshold 0.95

What it does

Lists records from metaharness-audit namespace via audit-list.mjs
Picks the most recent record by startedAt (or --baseline-since 7d skips anything newer than 7 days)
Runs a fresh oia-audit against the current path
Diffs the two via audit-trend, applying --alert-on-distance-below ${threshold}
Returns the structured drift report

Architectural constraint inheritance (ADR-150)

Constraint	How drift-from-history satisfies it
Removable	Pure subprocess composition over existing scripts — no new `@metaharness/*` import
Optional	If oia-audit reports `degraded:true`, this skill exits 3 with a degraded payload
Graceful	Empty audit history → exit 2 with hint to seed it; never crashes
CI-gate	Smoke step 17z16 anchors the dispatcher entry + subcommand listing

Exit codes

0 — similarity ≥ threshold (or threshold not crossed)
1 — drift detected: similarity < threshold (alert fired)
2 — config error (no history, audit-list failed)
3 — upstream metaharness absent (degraded payload returned)

Example

$ npx ruflo metaharness drift-from-history --threshold 0.95
# drift-from-history

Baseline:        audit-2026-06-16T22-58-47-840Z
Current:         2026-06-16T23:05:02.231Z

Structural similarity: 1 (near-identical)
Distance:              0

✓ similarity ≥ 0.95 — OK

Implementation

scripts/drift-from-history.mjs

Info

Category Development

Name harness-drift-from-history

Version v20260707

Size 2.49KB

Source ruvnet/ruflo

Updated At 2026-07-09