@flighthq/capture 0.3.1-next.575.c1f8e01 → 0.3.1-next.616.aa7ae7f

package/dist/captureBaseline.d.ts

@@ -1,4 +1,4 @@
-import type { CaptureBaseline, CaptureColumnBaseline } from '@flighthq/types/contract';
+import type { CaptureBaseline, CaptureBaselineField, CaptureBaselineProvenance, CaptureBaselineProvenanceField } from '@flighthq/types/contract';
 /** Allocates an empty baseline record. Columns are added via setCaptureBaselineField. */
 export declare function createCaptureBaseline(): CaptureBaseline;
 /**
@@ -12,7 +12,10 @@ export declare function formatCaptureBaseline(baseline: Readonly<CaptureBaseline
  * The value of one column's field, or `null` when the column or field is absent. `field` is
  * `'fingerprint'` or `'sha256'`.
  */
-export declare function getCaptureBaselineField(baseline: Readonly<CaptureBaseline>, column: string, field: keyof CaptureColumnBaseline): string | null;
+export declare function getCaptureBaselineField(baseline: Readonly<CaptureBaseline>, column: string, field: CaptureBaselineField): string | null;
+/** What produced ONE of a column's values — `field` names which. `null` when that value is absent or
+ * predates provenance recording, which reads as UNKNOWN provenance and never as agreement. */
+export declare function getCaptureBaselineProvenance(baseline: Readonly<CaptureBaseline>, column: string, field: CaptureBaselineProvenanceField): CaptureBaselineProvenance | null;
 /**
  * Parses the text form produced by formatCaptureBaseline. Returns `null` for malformed input — invalid
  * JSON, or a top-level value that is not a plain object — so a corrupt baseline reads as "no baseline"
@@ -20,5 +23,7 @@ export declare function getCaptureBaselineField(baseline: Readonly<CaptureBaseli
  */
 export declare function parseCaptureBaseline(text: string): CaptureBaseline | null;
 /** Sets one column's field to `value`, creating the column entry if it does not yet exist. */
-export declare function setCaptureBaselineField(baseline: CaptureBaseline, column: string, field: keyof CaptureColumnBaseline, value: string): void;
+export declare function setCaptureBaselineField(baseline: CaptureBaseline, column: string, field: CaptureBaselineField, value: string): void;
+/** Records what produced ONE of a column's values, creating the column entry if it does not yet exist. */
+export declare function setCaptureBaselineProvenance(baseline: CaptureBaseline, column: string, field: CaptureBaselineProvenanceField, provenance: Readonly<CaptureBaselineProvenance>): void;
 //# sourceMappingURL=captureBaseline.d.ts.map

package/dist/captureBaseline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"captureBaseline.d.ts","sourceRoot":"","sources":["../src/captureBaseline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,yFAAyF;AACzF,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,MAAM,CAWjF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,qBAAqB,GACjC,MAAM,GAAG,IAAI,CAEf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASzE;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,qBAAqB,EAClC,KAAK,EAAE,MAAM,GACZ,IAAI,CAEN"}
+{"version":3,"file":"captureBaseline.d.ts","sourceRoot":"","sources":["../src/captureBaseline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,8BAA8B,EAE/B,MAAM,0BAA0B,CAAC;AAElC,yFAAyF;AACzF,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,MAAM,CAejF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,GAC1B,MAAM,GAAG,IAAI,CAEf;AAED;8FAC8F;AAC9F,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,8BAA8B,GACpC,yBAAyB,GAAG,IAAI,CAElC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASzE;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM,GACZ,IAAI,CAEN;AAED,0GAA0G;AAC1G,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,8BAA8B,EACrC,UAAU,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAC9C,IAAI,CAEN"}

package/dist/captureBaseline.js

@@ -19,6 +19,12 @@ export function formatCaptureBaseline(baseline) {
             out.sourceHash = entry.sourceHash;
         if (entry.sha256 !== undefined)
             out.sha256 = entry.sha256;
+        // Provenance is emitted LAST so adding it to a column leaves every existing line in place and the
+        // diff is one appended block rather than a rewrite of the record.
+        if (entry.fingerprintProvenance !== undefined)
+            out.fingerprintProvenance = entry.fingerprintProvenance;
+        if (entry.sha256Provenance !== undefined)
+            out.sha256Provenance = entry.sha256Provenance;
         sorted[column] = out;
     }
     return JSON.stringify(sorted, null, 2) + '\n';
@@ -30,6 +36,11 @@ export function formatCaptureBaseline(baseline) {
 export function getCaptureBaselineField(baseline, column, field) {
     return baseline[column]?.[field] ?? null;
 }
+/** What produced ONE of a column's values — `field` names which. `null` when that value is absent or
+ * predates provenance recording, which reads as UNKNOWN provenance and never as agreement. */
+export function getCaptureBaselineProvenance(baseline, column, field) {
+    return baseline[column]?.[provenanceMember(field)] ?? null;
+}
 /**
  * Parses the text form produced by formatCaptureBaseline. Returns `null` for malformed input — invalid
  * JSON, or a top-level value that is not a plain object — so a corrupt baseline reads as "no baseline"
@@ -51,4 +62,11 @@ export function parseCaptureBaseline(text) {
 export function setCaptureBaselineField(baseline, column, field, value) {
     (baseline[column] ??= {})[field] = value;
 }
+/** Records what produced ONE of a column's values, creating the column entry if it does not yet exist. */
+export function setCaptureBaselineProvenance(baseline, column, field, provenance) {
+    (baseline[column] ??= {})[provenanceMember(field)] = { ...provenance };
+}
+function provenanceMember(field) {
+    return field === 'fingerprint' ? 'fingerprintProvenance' : 'sha256Provenance';
+}
 //# sourceMappingURL=captureBaseline.js.map

package/dist/captureBaseline.js.map

@@ -1 +1 @@
-{"version":3,"file":"captureBaseline.js","sourceRoot":"","sources":["../src/captureBaseline.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,MAAM,UAAU,qBAAqB;IACnC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAmC;IACvE,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,GAAG,GAA0B,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACzE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACtE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAmC,EACnC,MAAc,EACd,KAAkC;IAElC,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxF,OAAO,MAAyB,CAAC;AACnC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,uBAAuB,CACrC,QAAyB,EACzB,MAAc,EACd,KAAkC,EAClC,KAAa;IAEb,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"captureBaseline.js","sourceRoot":"","sources":["../src/captureBaseline.ts"],"names":[],"mappings":"AAQA,yFAAyF;AACzF,MAAM,UAAU,qBAAqB;IACnC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAmC;IACvE,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,GAAG,GAA0B,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACzE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACtE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1D,kGAAkG;QAClG,kEAAkE;QAClE,IAAI,KAAK,CAAC,qBAAqB,KAAK,SAAS;YAAE,GAAG,CAAC,qBAAqB,GAAG,KAAK,CAAC,qBAAqB,CAAC;QACvG,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS;YAAE,GAAG,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAmC,EACnC,MAAc,EACd,KAA2B;IAE3B,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED;8FAC8F;AAC9F,MAAM,UAAU,4BAA4B,CAC1C,QAAmC,EACnC,MAAc,EACd,KAAqC;IAErC,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxF,OAAO,MAAyB,CAAC;AACnC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,uBAAuB,CACrC,QAAyB,EACzB,MAAc,EACd,KAA2B,EAC3B,KAAa;IAEb,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AAC3C,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,4BAA4B,CAC1C,QAAyB,EACzB,MAAc,EACd,KAAqC,EACrC,UAA+C;IAE/C,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAqC;IAC7D,OAAO,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,kBAAkB,CAAC;AAChF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/capture",
-  "version": "0.3.1-next.575.c1f8e01",
+  "version": "0.3.1-next.616.aa7ae7f",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/bitmap": "0.3.1-next.575.c1f8e01",
-    "@flighthq/types": "0.3.1-next.575.c1f8e01"
+    "@flighthq/bitmap": "0.3.1-next.616.aa7ae7f",
+    "@flighthq/types": "0.3.1-next.616.aa7ae7f"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/captureBaseline.test.ts

@@ -4,8 +4,10 @@ import {
   createCaptureBaseline,
   formatCaptureBaseline,
   getCaptureBaselineField,
+  getCaptureBaselineProvenance,
   parseCaptureBaseline,
   setCaptureBaselineField,
+  setCaptureBaselineProvenance,
 } from './captureBaseline';
 
 describe('createCaptureBaseline', () => {
@@ -72,6 +74,31 @@ describe('getCaptureBaselineField', () => {
   });
 });
 
+describe('getCaptureBaselineProvenance', () => {
+  it('reads back what was recorded', () => {
+    const baseline = createCaptureBaseline();
+    setCaptureBaselineProvenance(baseline, 'webgl', 'sha256', PROVENANCE);
+    expect(getCaptureBaselineProvenance(baseline, 'webgl', 'sha256')).toEqual(PROVENANCE);
+  });
+
+  it('does NOT answer for the other value — one provenance per independently-written field', () => {
+    const baseline = createCaptureBaseline();
+    setCaptureBaselineProvenance(baseline, 'webgl', 'sha256', PROVENANCE);
+    // fingerprint is written by a DIFFERENT pass. A sha256 stamp must not read as covering it, or the
+    // record reports agreement it never established.
+    expect(getCaptureBaselineProvenance(baseline, 'webgl', 'fingerprint')).toBeNull();
+    expect(getCaptureBaselineProvenance(baseline, 'webgl', 'sha256')).toEqual(PROVENANCE);
+  });
+
+  it('reads a column written before provenance existed as UNKNOWN, not as agreement', () => {
+    const baseline = createCaptureBaseline();
+    setCaptureBaselineField(baseline, 'webgl', 'sha256', 'abc');
+    // null is the whole staging decision: a legacy record must not read as "produced the same way".
+    expect(getCaptureBaselineProvenance(baseline, 'webgl', 'sha256')).toBeNull();
+    expect(getCaptureBaselineProvenance(baseline, 'absent', 'sha256')).toBeNull();
+  });
+});
+
 describe('parseCaptureBaseline', () => {
   it('round-trips format output to a stable, equal record', () => {
     const baseline = createCaptureBaseline();
@@ -114,3 +141,23 @@ describe('setCaptureBaselineField', () => {
     expect(getCaptureBaselineField(baseline, 'canvas', 'fingerprint')).toBe('1:ffffff');
   });
 });
+
+describe('setCaptureBaselineProvenance', () => {
+  it('creates the column and leaves the other fields alone', () => {
+    const baseline = createCaptureBaseline();
+    setCaptureBaselineField(baseline, 'webgl', 'sha256', 'abc');
+    setCaptureBaselineProvenance(baseline, 'webgl', 'sha256', PROVENANCE);
+    expect(getCaptureBaselineField(baseline, 'webgl', 'sha256')).toBe('abc');
+    expect(getCaptureBaselineProvenance(baseline, 'webgl', 'sha256')).toEqual(PROVENANCE);
+  });
+
+  it('copies rather than aliasing, so a later caller mutation cannot rewrite the record', () => {
+    const baseline = createCaptureBaseline();
+    const source = { ...PROVENANCE };
+    setCaptureBaselineProvenance(baseline, 'webgl', 'sha256', source);
+    source.frames = 99;
+    expect(getCaptureBaselineProvenance(baseline, 'webgl', 'sha256')?.frames).toBe(PROVENANCE.frames);
+  });
+});
+
+const PROVENANCE = { frames: 1, sourceHash: 'a1b2c3', targetKind: 'webgl', verifyPublished: true, warmupFrames: 0 };