vigiles 12.1.0 → 12.3.0

package/dist/audit-report.d.ts

@@ -13,6 +13,7 @@
  */
 import { type AuditScore } from "./audit-score.js";
 import { type Recommendation } from "./optimize.js";
+import type { LedgerSummary } from "./observe.js";
 import type { AdoptabilityResult } from "./adoptability.js";
 import type { ScanReport, MarketplaceInfo } from "./scan.js";
 import type { PluginScore } from "./leaderboard.js";
@@ -95,10 +96,20 @@ export interface AuditReport {
      * at least one adoptable surface. Additive/optional — schema version unchanged.
      */
     readonly adoptable?: Adoptable;
+    /**
+     * The flight-recorder summary — what the harness actually DID in real sessions
+     * (hook/agent decisions, counts, recent denials), read off `.vigiles/runs.jsonl`.
+     * Present only when the local ledger has records. Additive/optional — schema
+     * version unchanged. The CLI reads + summarizes the ledger and passes it in, so
+     * the pure builder stays fs-free.
+     */
+    readonly observations?: LedgerSummary;
 }
 export interface BuildAuditReportOptions {
     readonly harness: string;
     readonly vigilesVersion: string;
+    /** The flight-recorder summary from the local ledger (omit when empty). */
+    readonly observations?: LedgerSummary;
     /**
      * The repo-relative paths of surfaces that exist but have no `.spec.ts` yet,
      * computed by the CLI's layout-aware `discoverAdoptableSurfaces` (so the pure

package/dist/audit-report.js

@@ -70,6 +70,7 @@ function buildAuditReport(report, opts) {
             untested: report.untested,
         },
         ...(adoptable ? { adoptable } : {}),
+        ...(opts.observations ? { observations: opts.observations } : {}),
     };
 }
 /** Assemble the versioned {@link LeaderboardReport} — pure, no clock. */