@angelmsger/fx 0.18.1 → 0.19.0

package/dist/domain/release/version.js

@@ -1,10 +1,12 @@
 // The version a repository declares for itself, from VERSION or a dependency file.
 // It finds the written declaration without running a build that might compute another.
 // VERSION is plain text; structured metadata uses the readers below.
+import path from 'node:path';
 import { parse } from 'smol-toml';
 // A Gradle build often keeps its version beside the build file.
 export const GRADLE_PROPERTIES = 'gradle.properties';
 export const ROOT_VERSION = 'VERSION';
+// Reader order is the automatic declaration discovery order.
 export const VERSION_READERS = {
     [ROOT_VERSION]: (text) => text,
     'package.json': packageVersion,
@@ -15,12 +17,49 @@ export const VERSION_READERS = {
     [GRADLE_PROPERTIES]: propertiesVersion,
 };
 export function declaredVersion(file, text) {
-    const reader = VERSION_READERS[file];
+    const name = path.posix.basename(file);
+    if (!Object.hasOwn(VERSION_READERS, name))
+        return undefined;
+    const reader = VERSION_READERS[name];
     if (reader === undefined)
         return undefined;
     const version = reader(text)?.trim();
     return version === undefined || version === '' ? undefined : version;
 }
+// Field names are structural paths, except plain text (text) and Gradle/properties
+// assignments (version). A POM property records the field actually carrying the value.
+export function versionDeclaration(file, text) {
+    const name = path.posix.basename(file);
+    const value = declaredVersion(file, text);
+    if (value === undefined)
+        return undefined;
+    if (name === 'package.json') {
+        const doc = JSON.parse(text);
+        return { file, field: '/version', value, package_name: stringAt(doc, ['name']) ?? null };
+    }
+    if (name === 'pyproject.toml') {
+        const doc = parse(text);
+        const table = stringAt(doc, ['project', 'version']) === undefined ? ['tool', 'poetry'] : ['project'];
+        return {
+            file,
+            field: `/${[...table, 'version'].join('/')}`,
+            value,
+            package_name: stringAt(doc, [...table, 'name']) ?? null,
+        };
+    }
+    if (name === 'pom.xml') {
+        const values = pomValues(text);
+        const field = values.has('project/version') ? 'project/version' : 'project/parent/version';
+        const property = /^\$\{([\w.-]+)\}$/.exec(values.get(field) ?? '')?.[1];
+        return {
+            file,
+            field: `/${property === undefined ? field : `project/properties/${property}`}`,
+            value,
+            package_name: values.get('project/artifactId') ?? null,
+        };
+    }
+    return { file, field: name === ROOT_VERSION ? 'text' : 'version', value, package_name: null };
+}
 function packageVersion(text) {
     try {
         const doc = JSON.parse(text);
@@ -53,14 +92,14 @@ function stringAt(doc, path) {
     return typeof at === 'string' ? at : undefined;
 }
 // The project's own <version>, else the one it inherits from <parent>; a single
-// ${property} is resolved from the project's <properties>, as CI-friendly versions use.
+// ${property} is resolved from the project's <properties>. Composite and recursive
+// expressions are unreadable because fx does not run Maven's expression evaluator.
 function pomVersion(text) {
     const values = pomValues(text);
     const version = values.get('project/version') ?? values.get('project/parent/version');
     const property = version === undefined ? undefined : /^\$\{([\w.-]+)\}$/.exec(version)?.[1];
-    if (property === undefined)
-        return version;
-    return values.get(`project/properties/${property}`) ?? version;
+    const resolved = property === undefined ? version : values.get(`project/properties/${property}`);
+    return resolved === undefined || resolved.includes('${') ? undefined : resolved;
 }
 // The text of every element, keyed by its path from the root.
 function pomValues(text) {

package/dist/domain/release/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/domain/release/version.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/domain/release/version.ts"],"names":[],"mappings":"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"}

package/dist/domain/release/window.js

@@ -1,4 +1,4 @@
-// A look-back window as people write it (`14d`, `48h`, `2w`), in milliseconds.
+// Relative look-back syntax and reproducible, timezone-qualified half-open ranges.
 import { DevkitError } from '../errors.js';
 const UNIT_MS = {
     h: 60 * 60 * 1000,
@@ -6,12 +6,13 @@ const UNIT_MS = {
     w: 7 * 24 * 60 * 60 * 1000,
 };
 const PATTERN = /^(\d+)([hdw])$/;
+const INSTANT = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d+))?(Z|[+-]\d{2}:\d{2})$/;
 export function parseWindow(text) {
     const m = PATTERN.exec(text.trim());
     if (m === null || m[1] === undefined || m[2] === undefined)
         return undefined;
-    const amount = Number(m[1]);
-    return amount === 0 ? undefined : amount * (UNIT_MS[m[2]] ?? 0);
+    const ms = Number(m[1]) * (UNIT_MS[m[2]] ?? 0);
+    return ms > 0 && Number.isSafeInteger(ms) ? ms : undefined;
 }
 export function isWindow(text) {
     return parseWindow(text) !== undefined;
@@ -25,4 +26,67 @@ export function windowMs(text) {
         nextSteps: ['fx release check --since 14d'],
     });
 }
+// Check calendar components before parsing. Provider timestamps may carry microseconds;
+// comparisons truncate fractional seconds to milliseconds and never round into the next bound.
+export function instantMs(text) {
+    const match = INSTANT.exec(text);
+    if (match === null)
+        return undefined;
+    const [year, month, day, hour, minute, second] = match.slice(1, 7).map(Number);
+    if (year === undefined || month === undefined || day === undefined)
+        return undefined;
+    const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+    const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
+    if (days === undefined ||
+        day < 1 ||
+        day > days ||
+        (hour ?? 24) > 23 ||
+        (minute ?? 60) > 59 ||
+        (second ?? 60) > 59)
+        return undefined;
+    const zone = match[8] ?? '';
+    if (zone !== 'Z' && (Number(zone.slice(1, 3)) > 23 || Number(zone.slice(4)) > 59))
+        return undefined;
+    const fraction = match[7];
+    const millis = fraction === undefined ? '' : `.${fraction.slice(0, 3).padEnd(3, '0')}`;
+    const ms = Date.parse(`${text.slice(0, 19)}${millis}${zone}`);
+    return Number.isFinite(ms) ? ms : undefined;
+}
+export function resolveRange(input, now) {
+    if (input.start !== undefined || input.end !== undefined) {
+        if (input.since !== undefined)
+            throw badRange('Use either since or start/end, not both');
+        if (input.start === undefined || input.end === undefined)
+            throw badRange('Both start and end are required');
+        return absoluteRange(input.start, input.end);
+    }
+    const end = now.getTime();
+    const start = end - windowMs(input.since ?? '14d');
+    if (!Number.isFinite(end) || !Number.isFinite(new Date(start).getTime()))
+        throw badRange('The relative window is outside the supported date range');
+    return absoluteRange(new Date(start).toISOString(), now.toISOString());
+}
+export function absoluteRange(start, end) {
+    const floor = instantMs(start);
+    const ceiling = instantMs(end);
+    if (floor === undefined || ceiling === undefined)
+        throw badRange('Start and end must be ISO timestamps with an explicit timezone');
+    if (floor >= ceiling)
+        throw badRange('Start must be earlier than end');
+    return {
+        start: new Date(floor).toISOString(),
+        end: new Date(ceiling).toISOString(),
+        bounds: '[start,end)',
+    };
+}
+export function isWithinRange(date, range) {
+    const at = date === null ? undefined : instantMs(date);
+    return at !== undefined && at >= Date.parse(range.start) && at < Date.parse(range.end);
+}
+function badRange(message) {
+    return new DevkitError('usage', 'BAD_TIME_RANGE', message, {
+        hint: 'Use a positive relative window or two timezone-qualified ISO timestamps.',
+        nextSteps: ['fx release check --help'],
+    });
+}
 //# sourceMappingURL=window.js.map

package/dist/domain/release/window.js.map

@@ -1 +1 @@
-{"version":3,"file":"window.js","sourceRoot":"","sources":["../../../src/domain/release/window.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,OAAO,GAAqC;IAChD,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACtB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC3B,CAAC;AAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,mBAAmB,EAAE;QACvE,IAAI,EAAE,2CAA2C;QACjD,SAAS,EAAE,CAAC,8BAA8B,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../../src/domain/release/window.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,OAAO,GAAqC;IAChD,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACtB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC3B,CAAC;AACF,MAAM,OAAO,GAAG,gBAAgB,CAAC;AACjC,MAAM,OAAO,GAAG,kFAAkF,CAAC;AAcnG,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7E,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,mBAAmB,EAAE;QACvE,IAAI,EAAE,2CAA2C;QACjD,SAAS,EAAE,CAAC,8BAA8B,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC;AAED,wFAAwF;AACxF,+FAA+F;AAC/F,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/E,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACrF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACrF,IACE,IAAI,KAAK,SAAS;QAClB,GAAG,GAAG,CAAC;QACP,GAAG,GAAG,IAAI;QACV,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,EAAE;QACjB,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,EAAE;QACnB,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,EAAE;QAEnB,OAAO,SAAS,CAAC;IACnB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/E,OAAO,SAAS,CAAC;IACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACvF,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,GAAS;IACvD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,QAAQ,CAAC,yCAAyC,CAAC,CAAC;QACzF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YACtD,MAAM,QAAQ,CAAC,iCAAiC,CAAC,CAAC;QACpD,OAAO,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACtE,MAAM,QAAQ,CAAC,yDAAyD,CAAC,CAAC;IAC5E,OAAO,aAAa,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,GAAW;IACtD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAC9C,MAAM,QAAQ,CAAC,gEAAgE,CAAC,CAAC;IACnF,IAAI,KAAK,IAAI,OAAO;QAAE,MAAM,QAAQ,CAAC,gCAAgC,CAAC,CAAC;IACvE,OAAO;QACL,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;QACpC,GAAG,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;QACpC,MAAM,EAAE,aAAa;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,KAAgB;IACjE,MAAM,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,KAAK,SAAS,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE;QACzD,IAAI,EAAE,0EAA0E;QAChF,SAAS,EAAE,CAAC,yBAAyB,CAAC;KACvC,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/report.js

@@ -11,6 +11,7 @@ export function finding(group, id, level, message, extra = {}) {
         ...(extra.handoff === undefined ? {} : { handoff: extra.handoff }),
         ...(extra.evidence === undefined ? {} : { evidence: extra.evidence }),
         ...(extra.failure === undefined ? {} : { failure: extra.failure }),
+        ...(extra.failures === undefined ? {} : { failures: extra.failures }),
         ...(extra.required === undefined ? {} : { required: extra.required }),
         ...(extra.actions === undefined ? {} : { actions: extra.actions }),
     };

package/dist/domain/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/domain/report.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AA4C7E,MAAM,UAAU,OAAO,CACrB,KAAQ,EACR,EAAU,EACV,KAAY,EACZ,OAAe,EACf,QAAsB,EAAE;IAExB,OAAO;QACL,KAAK;QACL,EAAE;QACF,KAAK;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS;QACrC,OAAO;QACP,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QACtD,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAA4B;IACpD,MAAM,OAAO,GAA0B,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACnE,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4EAA4E;AAC5E,+DAA+D;AAC/D,SAAS,OAAO,CACd,MAAoB,EACpB,QAA+B;IAE/B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,MAAoB,EACpB,QAA+B;IAE/B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC;QAC5C,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC;QAC3D,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;QAC3B,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAwB;IAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/domain/report.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angelmsger/fx",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "Manifest-driven multi-repository workspaces for people and coding agents",
   "license": "Apache-2.0",
   "type": "module",

package/skills/fx-workspace/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fx-workspace
-version: 0.18.1
+version: 0.19.0
 description: 'Use only when the user explicitly asks for the fx workspace CLI or manifest, or the current task is inside an fx-managed workspace or routed by its fx-derived AGENTS.md. Drive workspace init and sync, repository status and selection, manifest validation and editing, companion tools and login, doctor, agent Skills, repository ownership, environment coordinates and readiness through can/where, and release checks across dependencies, branches, builds and errors. Do not use for generic Sentry, OpenObserve, Jenkins, Kubernetes, logs, errors or builds outside an fx-managed workspace.'
 metadata:
   requires:

package/skills/fx-workspace/references/commands.md

@@ -163,6 +163,38 @@ returns the corresponding explicit queries instead of an unrelated fuzzy area.
 
 `fx repo show <repo>` — the resolved entry, disk state and URLs, plus `owners`: `[]` when the members document names nobody, `null` when the workspace has no members document at all, else items of `area`, `lead`, `scenario`, `devLead`, `roles`, every person as `{id, name, email}` (name and email `null` when the id is not in the document, `all` included); `contact` is the project's contact. Its `next_steps` use the canonical repository name and explicit workspace to select an unpicked repository and synchronize missing shared checkouts; inspection itself never changes selection or downloads files.
 
+`ownership_evidence` is an additional scope-aware projection. It carries `as_of`,
+`basis: current_members_document`, `historical_snapshot: false`, `coverage`,
+`items` and `has_more: false`. Each item retains the repository-linked area/scenario,
+context, named people, responsibility teams and collective assignments. A person's
+status, mentor and leader remain explicit current facts. `--as-of YYYY-MM-DD`
+filters declared relationship intervals, defaulting to today in UTC; it does not
+reconstruct old membership documents. `not_configured` means no members document,
+`not_covered` means no linked scope, and a checked scope can still say
+`no_relationships`. Do not expand collective `all` or infer an assignee from Git
+authors. A team workflow selects an owner from applicable responsibility evidence.
+
+`fx repo version <repo>` reads pinned version history for any known repository,
+even one excluded from the release checklist. `version_evidence` carries
+`requested_ref`, `resolved_sha`, `declaration`, `last_change`, `coverage`,
+`commits_read`, `termination`, `next_sha` and structured `failures`.
+`declaration` is `{file, field, package_name, value}`. `last_change` identifies the
+commit, committer time, old/new values, `history_mode: first_parent` and whether
+this is a field change or actual root declaration. A dependency edit is not a
+version-field change. Source path, field and package identity stay fixed during
+the walk; renamed files, shallow/missing parents and exhausted budgets remain
+incomplete. `next_sha` describes a stop point, not an automatic resume mechanism.
+The optional `baseline_evidence` pins both refs and compares their declarations
+and complete commit range. `evidence_complete` covers both requested facets.
+Use the command's help for ref, path, baseline and history-budget options.
+
+Automatic declaration discovery skips dependency-only files such as
+`requirements.txt`. A present but unreadable supported source remains incomplete;
+only the documented Gradle fallback selects adjacent `gradle.properties`.
+Maven versions must be literals or one project property resolved to a literal.
+Composite, nested or unresolved expressions retain
+`VERSION_DECLARATION_UNREADABLE`; they are not concrete versions.
+
 ### Diagnostic reports
 
 Login and doctor reject unknown explicit tool/environment selectors before setup
@@ -174,7 +206,7 @@ same ambiguous setup. Doctor marks its missing verification as incomplete.
 `fx doctor` returns `preparation`, diagnostic `coverage` (`complete` or `incomplete`),
 `summary {ok, warn, fail}` and `findings[]`. The preparation verdict owns task completion;
 optional host activation can remain unverified. An incomplete verdict exits 12.
-`fx release check` returns `ok`, `complete`, summary and findings and exits zero when its
+`fx release check` returns `ok`, `complete`, `evidence_complete`, summary and findings and exits zero when its
 checklist was produced. Findings carry group, id, level, coverage, message, fix and
 handoff; caught query errors also carry a structured `failure` with recovery, retained
 in compact JSON. Full results also carry evidence. Incomplete checks are not passes:
@@ -198,33 +230,59 @@ repair rows; use `--details` to inspect all attempts. Each attempt is
 structured recovery errors before post-repair findings are collected.
 `completed` means the repair ran, not that the subsequent check passed.
 
-`fx release check [<repo>...] [--tag] [--only deps,merge,ci,errors] [--env] [--since]
-[--jobs]` covers repositories selected by manifest release policy; `fx release` is its
+`fx release check` covers repositories selected by manifest release policy; `fx release` is its
 compatibility name. It is read-only: it never merges, tags, publishes or deploys.
+Use `--help` for selection, absolute/relative error windows and optional version
+history, historical baseline and version-path overrides. Override keys must name
+selected repositories; use a separate invocation for multiple packages in one repo.
 
-Each `repos[]` entry is `{name, source, target, version_file, unmerged, note,
-unanswered}`. `source`
+Each `repos[]` entry includes `name`, `source`, `target`, `version_file`, `unmerged`,
+`note` and `unanswered`, plus `range`, `version_evidence`, `baseline_evidence` and
+`facet_coverage`. `source`
 and `target` are the branch heads `{branch, sha, date, message, version}`; `version` is
-what the repository's dependency file declares at that commit, null when it declares
-none. `target` is null for a repository releasing from one branch, and both are null
+what the selected root `VERSION` or package metadata declares at that commit, null
+when unknown. `target` is null for a repository releasing from one branch, and both are null
 when the code host was not asked or did not answer, which the findings explain.
 `unmerged` is `{commits, authors}`: how many people's commits the source has that the
 target lacks, and how many people wrote them; null when not compared. To read those
 commits, ask the code host's own CLI for the range from `target.sha` to `source.sha`;
 `fx repo show <repo>` gives where the repository lives on the host. `unanswered[]` lists
-each question to the code host that failed as `{field, reason}`, where `field` is the
+each question to the code host that failed as `{field, reason, error}`, where `error`
+retains structured recovery and `field` is the
 value left null (`version_file`, `source.commit`, `source.version`, `target.commit`,
 `target.version`, `unmerged`); a null without an entry means the repository declares
 none.
 
+`version_evidence` uses the standalone version contract above. `baseline_evidence`
+is `{baseline, head, commits, coverage, failures}`. The default JSON summary replaces
+the commit array with `commits_count` and an omitted count; `--details` or explicit
+`--fields` retains the full array. Failures remain visible. Each snapshot has
+`requested_ref`, `resolved_sha` and `declaration`. Its commits include bots and
+merges since the caller's baseline, independently of `unmerged`. A version-field
+change, tag or source declaration does not establish an artifact build, publication
+or deployment. fx does not infer a next minor version.
+
+`facet_coverage` distinguishes `checked`, `incomplete`, `not_requested` and
+`not_applicable` for `declaration`, `version_history`, `baseline` and `errors`.
+Error findings also retain a top-level `failures` array in summary output, with
+structured error codes, retryability and recovery steps. Detailed error candidates
+keep the latest metadata observation per ID; a resolved/ignored detail can follow
+an unresolved list result and is excluded from the fresh-issue verdict.
+
+`evidence_complete` additionally covers requested facts and unanswered questions;
+it does not redefine `ok` or check coverage `complete`. The report's `observed_at`
+is one command-start timestamp. Absolute ranges normalize to UTC and use
+`[start,end)`; relative policies share this observation time but can use different
+durations. The top-level `range` is null when per-repository ranges differ.
+
 Evidence is grouped by check:
 
-| Group    | Evidence                                                                                                                                  |
-| -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `merge`  | `source`, `target`, `ahead[]`, `behind[]`, `filtered`, `unknown[]` directions; commits have `sha`, `author {id, name}`, `date`, `message` |
-| `deps`   | `file`, `offending[] {name, version, section, runtime}`                                                                                   |
-| `ci`     | `builds[] {side, env, branch, path, number, status, started_at, url, commit, head, current}`; null `path` means no declared job           |
-| `errors` | `env`, `slug`, `since`, `capped`, `undated`, `issues[] {short_id, title, level, first_seen, last_seen, count, url}`                       |
+| Group    | Evidence                                                                                                                                   |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `merge`  | `source`, `target`, `ahead[]`, `behind[]`, `filtered`, `unknown[]` directions; commits have `sha`, `author {id, name}`, `date`, `message`  |
+| `deps`   | `file`, `offending[] {name, version, section, runtime}`                                                                                    |
+| `ci`     | `builds[] {side, env, branch, path, number, status, started_at, url, commit, head, current}`; null `path` means no declared job            |
+| `errors` | `query_context`, `env`, `slug`, `since`, `capped`, `undated`, legacy fresh `issues[]`, and complete candidate metadata in `error_evidence` |
 
 CI `current` compares the commit the build checked out, `commit`, with the branch head
 `head` when the platform names it. A null `commit` (Jenkins before jenkins-cli 0.12.0)
@@ -233,13 +291,50 @@ freshness heuristic, not revision verification; use the companion's build detail
 when the task requires an exact commit match.
 The full report's merge/dependency/issue evidence is available with `--details`.
 
+Every errors finding includes `evidence.query_context`, even when authentication
+or collection fails or the check is not applicable. It is
+`{repository, environment, range, observed_at, source}`; `source` is
+`{platform, provider, coordinate_fingerprint}` or null for an unavailable or
+explicitly uncovered coordinate. The fingerprint preserves the provider's query
+identity before authentication without exposing arbitrary vars.
+
+Sentry query fingerprints identify the configured endpoint, organization and
+project selector, so repository aliases for one project retain the same source
+identity. Repository and environment are bound separately in `query_context`.
+Other tracker providers may supply their own query fingerprint; without it, the
+full canonical coordinate fingerprint is retained conservatively.
+
+For an audited retry, match the repository, environment, normalized range and
+non-null source identity before superseding an earlier failure; keep both
+observation times. A different server, organization, project or period is another
+query. Each attempt remains separate and is not an atomic remote snapshot.
+
+`error_evidence` retains every collected candidate returned by an unresolved
+query and active in the range, including older issues. It carries `items`, `range`, `observed_at`,
+`pages_read`, `has_more`, optional `next`, `coverage`, `failures` and
+`truncation_reason`. Inspect these before treating a query as complete. fx follows
+pagination internally; there is no public cursor-resume flag. Keep the same
+absolute bounds when retrying or investigating a continuation with the companion.
+Lifetime first-seen comes from issue detail; `lifetime_first_seen` and
+`first_seen_scope` never use window/list dates as a fallback. Missing details
+remain unknown. `list_first_seen` has unknown scope and `window_first_seen` stays
+separate. `count_scope: unknown` prevents treating counts as newly occurring
+events. `status_scope: current` describes each item's actual `status_observed_at`,
+not state at the historical window; the aggregate status time is null. Assignee
+is read metadata, not a selected or newly assigned owner. The legacy verdict
+counts lifetime first appearances only; old regressions require separate review.
+
 Uncovered explicit repositories yield `REPO_NOT_COVERED`, unmatched tags
 `TAG_NOT_FOUND`, unknown environments `ENV_NOT_FOUND`, and an empty checklist
 `CHECKLIST_EMPTY`. `--since` accepts windows such as `14d`, `48h` or `2w`;
-invalid windows yield `BAD_SINCE`. Missing platform responses/jobs, undated
+invalid windows yield `BAD_SINCE`. Mixing relative and absolute bounds, missing a
+bound or invalid timezone-qualified timestamps yields `BAD_TIME_RANGE`.
+Missing platform responses/jobs, undated
 issues and builds that cannot be dated against the branch head warn rather
-than prove readiness. `RELEASE_OK` / `RELEASE_FAILURES` are closing notices;
-inspect report coverage even when the notice says OK.
+than prove readiness. Closing notices distinguish `RELEASE_FAILURES` for confirmed
+failures, `RELEASE_INCOMPLETE` for missing check coverage without confirmed failures,
+and `RELEASE_OK` for complete checks without failures. Inspect `evidence_complete`
+separately for requested repository facts.
 
 ### Update notices
 

package/skills/fx-workspace/references/workspace-tasks.md

@@ -36,7 +36,9 @@ covered by the [Skill reference](commands.md#standalone-companion-skill).
   Optional activation stays separate. Doctor's `coverage` describes diagnostics.
 - For `release check`, inspect `ok`, coverage `complete`, warning/failure findings and
   `repos[]`, what each repository would ship. It can exit zero with failures and does
-  not publish anything.
+  not publish anything. `evidence_complete` also covers requested declaration,
+  version-history and baseline facts; inspect per-repository `facet_coverage` and
+  structured failures before relying on missing data.
 - For `login`, retain `summary`, `problems` and step recovery fields. `handoff`
   needs input; `blocked` has an unfinished prerequisite; `not_started` was not attempted.
 - Read partial stdout after a nonzero exit. It preserves completed effects and
@@ -130,25 +132,26 @@ do not use a similarly named area as a substitute. Missing account keys are unkn
 not confirmed accounts. Responsibility evidence supports a proposal; changing an
 existing work-item owner must still follow the user's requested scope.
 
-| Task                                       | Entry                                                                                    |
-| ------------------------------------------ | ---------------------------------------------------------------------------------------- |
-| Discover or repair workspace identity      | `fx workspace list/show`; `workspace relocate/rebind/unregister --dry-run`               |
-| Choose an exact repository/environment set | `fx repo select <names...>`; `fx env select <names...>`; `--all` or `--none`             |
-| Inspect checkouts                          | `fx status`; `--fetch` refreshes remote comparisons                                      |
-| Update selected repositories/resources     | `fx sync --dry-run`; use `--only` to narrow stages                                       |
-| Select repositories or environments        | `fx repo pick/unpick`; `fx env pick/unpick`                                              |
-| Inspect one repository and owners          | `fx repo show <repo>`; `fx member show <name>`                                           |
-| Find service diagnostics                   | `fx where <repo> --env <env>`                                                            |
-| Check tools/access                         | `fx can <capability-or-tool>`; `fx doctor --tool <tool>`                                 |
-| Inspect repository release criteria        | `fx release check <repo> --only merge --details`                                         |
-| Install/update a companion and its Skill   | `fx tool install <tool> --dry-run`; `fx tool update <tool>\|--all --dry-run`             |
-| Review tool provenance                     | `fx tool history [tool]`; `fx tool inventory`                                            |
-| Inspect host resources                     | `fx agent skills`; `fx hook list`; `fx mcp list/show`                                    |
-| Inspect declarations                       | `fx manifest validate --strict`; `fx manifest explain '<path>'`; `fx manifest providers` |
-| Edit/render shared facts                   | `fx manifest repo-set`; `fx manifest record-probe`; `fx manifest render --check`         |
-| Import existing checkouts                  | `fx manifest import <dir> --format json`                                                 |
-| Contribute selected source files           | `fx source push <paths...> --issue <id> --title <title> --dry-run`                       |
-| Inspect personal settings                  | `fx config list`; `fx config get <key> --explain`                                        |
+| Task                                                | Entry                                                                                            |
+| --------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| Discover or repair workspace identity               | `fx workspace list/show`; `workspace relocate/rebind/unregister --dry-run`                       |
+| Choose an exact repository/environment set          | `fx repo select <names...>`; `fx env select <names...>`; `--all` or `--none`                     |
+| Inspect checkouts                                   | `fx status`; `--fetch` refreshes remote comparisons                                              |
+| Update selected repositories/resources              | `fx sync --dry-run`; use `--only` to narrow stages                                               |
+| Select repositories or environments                 | `fx repo pick/unpick`; `fx env pick/unpick`                                                      |
+| Inspect one repository and owners                   | `fx repo show <repo>`; `fx member show <name>`                                                   |
+| Find service diagnostics                            | `fx where <repo> --env <env>`                                                                    |
+| Check tools/access                                  | `fx can <capability-or-tool>`; `fx doctor --tool <tool>`                                         |
+| Inspect repository release criteria                 | `fx release check <repo> --only merge --details`                                                 |
+| Inspect a written version and its last field change | `fx repo version <repo>`; use `--help` for pinned refs, nested packages and historical baselines |
+| Install/update a companion and its Skill            | `fx tool install <tool> --dry-run`; `fx tool update <tool>\|--all --dry-run`                     |
+| Review tool provenance                              | `fx tool history [tool]`; `fx tool inventory`                                                    |
+| Inspect host resources                              | `fx agent skills`; `fx hook list`; `fx mcp list/show`                                            |
+| Inspect declarations                                | `fx manifest validate --strict`; `fx manifest explain '<path>'`; `fx manifest providers`         |
+| Edit/render shared facts                            | `fx manifest repo-set`; `fx manifest record-probe`; `fx manifest render --check`                 |
+| Import existing checkouts                           | `fx manifest import <dir> --format json`                                                         |
+| Contribute selected source files                    | `fx source push <paths...> --issue <id> --title <title> --dry-run`                               |
+| Inspect personal settings                           | `fx config list`; `fx config get <key> --explain`                                                |
 
 Match the returned row by `capability`, not by a platform name from another manifest.
 `fx can` without a target lists every capability with its scope, what it is for and
@@ -171,6 +174,17 @@ Use `--format json` for results and `--help` for exact arguments. The table's
 help and completion prefer canonical names while preserving compatibility aliases.
 `release check` evaluates a checklist; it does not publish packages or deploy services.
 
+For release preparation, set the error window explicitly when dates matter and
+keep the normalized `[start,end)` range from the report. Request version history
+or a historical baseline when deciding whether the written version changed;
+current-branch `unmerged` is not the range since the last release. Read all error
+candidates from `error_evidence`, not only the legacy fresh-issue list. Distinguish
+lifetime first-seen from window dates, and current status from historical state.
+Do not turn unknown count scope into new-event counts or partial pagination into
+absence. Use `repo show` responsibility evidence and scoped member queries when
+a team workflow needs an assignee. Team policy decides final ownership, release
+intent and the next version; generic evidence does not make those decisions.
+
 ## What sync will and will not do
 
 Sync clones missing repositories and fast-forwards eligible clean branches. When