@angelmsger/fx 0.18.0 → 0.19.0

package/dist/domain/release/errors.js

@@ -2,24 +2,27 @@
 // activity, so first-seen is judged here; see "Unresolved errors" in
 // docs/design/release.md.
 import { releaseFinding } from './types.js';
-import { windowMs } from './window.js';
-// More new issues than this are not a list a person reads; the tracker is
-// asked for no more, and says whether it had more.
+import { instantMs, isWithinRange, resolveRange } from './window.js';
+// Maximum page size; the application continues until exhaustion or an explicit partial result.
 export const ISSUE_CEILING = 1000;
 export function errorsFinding(input) {
-    const floor = input.now.getTime() - windowMs(input.since);
-    const dated = input.issues.flatMap((issue) => {
-        const at = issue.firstSeen === null ? NaN : Date.parse(issue.firstSeen);
-        return Number.isNaN(at) ? [] : [{ issue, at }];
+    const range = input.range ?? resolveRange({ since: input.since }, input.now);
+    const candidates = input.issues.filter((issue) => issue.status !== 'resolved' && issue.status !== 'ignored');
+    const dated = candidates.flatMap((issue) => {
+        const at = hasLifetimeDate(issue) && issue.firstSeen !== null ? instantMs(issue.firstSeen) : undefined;
+        return at === undefined ? [] : [{ issue, at }];
     });
-    const fresh = dated.filter((d) => d.at >= floor).map((d) => d.issue);
-    const undated = input.issues.length - dated.length;
+    const fresh = dated.filter((d) => isWithinRange(d.issue.firstSeen, range)).map((d) => d.issue);
+    const undated = candidates.length - dated.length;
+    const failures = input.page?.failures?.map((failure) => failure.error) ?? [];
+    const incomplete = input.capped || undated > 0 || input.page?.coverage === 'incomplete' || failures.length > 0;
     const evidence = {
         env: input.env,
         slug: input.slug,
         since: input.since,
         capped: input.capped,
         undated,
+        error_evidence: errorEvidence(input, range),
         issues: fresh.map((i) => ({
             short_id: i.shortId,
             title: i.title,
@@ -31,14 +34,26 @@ export function errorsFinding(input) {
         })),
     };
     const [level, said] = verdict(input, fresh.length, undated);
-    const message = `${said} (${input.label})`;
+    const firstFailure = input.page?.pagesRead === 0 ? input.page.failures?.[0] : undefined;
+    const suffix = fresh.length > 0 && incomplete ? '; evidence is incomplete' : '';
+    const message = firstFailure?.error.message ?? `${said} (${input.label})${suffix}`;
     return releaseFinding('errors', input.repo, level, message, {
         evidence,
-        coverage: input.capped || undated > 0 ? 'incomplete' : 'checked',
+        coverage: incomplete ? 'incomplete' : 'checked',
+        ...(failures.length === 0
+            ? {}
+            : {
+                failure: failures[0],
+                failures,
+                handoff: failures[0]?.handoff,
+                fix: failures.find((failure) => failure.next_steps.length > 0)?.next_steps[0],
+            }),
     });
 }
 function verdict(input, fresh, undated) {
-    const window = `first seen in ${input.env} in the last ${input.since}`;
+    const window = input.range === undefined
+        ? `first seen in ${input.env} in the last ${input.since}`
+        : `first seen in ${input.env} in [${input.range.start}, ${input.range.end})`;
     if (fresh > 0) {
         const floor = input.capped ? 'at least ' : '';
         return ['fail', `${floor}${fresh} unresolved issue${fresh === 1 ? '' : 's'} ${window}`];
@@ -52,6 +67,55 @@ function verdict(input, fresh, undated) {
     // The tracker stopped at the ceiling: what it did not send is unread, not absent.
     if (input.capped)
         return ['warn', `more unresolved issues than fx asked for; none of them ${window}`];
+    if (input.page?.coverage === 'incomplete')
+        return ['warn', `unresolved issue evidence in ${input.env} is incomplete`];
     return ['ok', `no unresolved issue ${window}`];
 }
+function errorEvidence(input, range) {
+    const page = input.page;
+    return {
+        range,
+        observed_at: input.now.toISOString(),
+        activity_scope: 'range',
+        status_filter: 'unresolved',
+        status_scope: 'current',
+        deduplication: 'latest_observation',
+        // Each request observes current state at its own time; there is no shared snapshot.
+        status_observed_at: null,
+        items: input.issues.map((issue) => ({
+            id: issue.id,
+            short_id: issue.shortId,
+            title: issue.title,
+            level: issue.level,
+            lifetime_first_seen: hasLifetimeDate(issue) ? issue.firstSeen : null,
+            first_seen_scope: hasLifetimeDate(issue) ? 'lifetime' : 'unknown',
+            list_first_seen: issue.listFirstSeen ?? null,
+            list_first_seen_scope: 'unknown',
+            window_first_seen: issue.windowFirstSeen ?? null,
+            last_seen: issue.lastSeen,
+            count: issue.count,
+            count_scope: 'unknown',
+            url: issue.url,
+            culprit: issue.culprit,
+            status: issue.status ?? null,
+            status_observed_at: issue.statusObservedAt ?? null,
+            assignee: issue.assignee ?? null,
+        })),
+        has_more: input.capped,
+        ...(page?.next === undefined ? {} : { next: page.next }),
+        pages_read: page?.pagesRead ?? 1,
+        coverage: input.capped ||
+            input.issues.some((issue) => !hasLifetimeDate(issue)) ||
+            (page?.failures?.length ?? 0) > 0
+            ? 'incomplete'
+            : (page?.coverage ?? 'checked'),
+        failures: page?.failures ?? [],
+        truncation_reason: page?.truncationReason ?? null,
+    };
+}
+function hasLifetimeDate(issue) {
+    return (issue.firstSeenScope !== 'unknown' &&
+        issue.firstSeen !== null &&
+        instantMs(issue.firstSeen) !== undefined);
+}
 //# sourceMappingURL=errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domain/release/errors.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AACrE,0BAA0B;AAK1B,OAAO,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,0EAA0E;AAC1E,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAclC,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACnD,MAAM,QAAQ,GAAG;QACf,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO;QACP,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,QAAQ,EAAE,CAAC,CAAC,OAAO;YACnB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,UAAU,EAAE,CAAC,CAAC,SAAS;YACvB,SAAS,EAAE,CAAC,CAAC,QAAQ;YACrB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAC;KACJ,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,GAAG,IAAI,KAAK,KAAK,CAAC,KAAK,GAAG,CAAC;IAC3C,OAAO,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE;QAC1D,QAAQ;QACR,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;KACjE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,KAAkB,EAAE,KAAa,EAAE,OAAe;IACjE,MAAM,MAAM,GAAG,iBAAiB,KAAK,CAAC,GAAG,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC;IACvE,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,KAAK,oBAAoB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,wEAAwE;IACxE,IAAI,OAAO,GAAG,CAAC;QACb,OAAO;YACL,MAAM;YACN,GAAG,OAAO,oBAAoB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,UAAU;SACjF,CAAC;IACJ,kFAAkF;IAClF,IAAI,KAAK,CAAC,MAAM;QACd,OAAO,CAAC,MAAM,EAAE,0DAA0D,MAAM,EAAE,CAAC,CAAC;IACtF,OAAO,CAAC,IAAI,EAAE,uBAAuB,MAAM,EAAE,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domain/release/errors.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/release/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AAEpE,OAAO,EAAE,OAAO,EAA4D,MAAM,cAAc,CAAC;AAEjG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAU,CAAC;AA+DjE,MAAM,UAAU,cAAc,CAC5B,KAAY,EACZ,IAAY,EACZ,KAAY,EACZ,OAAe,EACf,QAAsB,EAAE;IAExB,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,qDAAqD;AACrD,MAAM,UAAU,UAAU,CACxB,KAAY,EACZ,IAAY,EACZ,MAAc,EACd,QAAsB,EAAE;IAExB,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,IAAY,EAAE,GAAW;IAChE,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,eAAe,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAClG,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/release/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AAGpE,OAAO,EAAE,OAAO,EAA4D,MAAM,cAAc,CAAC;AAKjG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAU,CAAC;AA+FjE,MAAM,UAAU,cAAc,CAC5B,KAAY,EACZ,IAAY,EACZ,KAAY,EACZ,OAAe,EACf,QAAsB,EAAE;IAExB,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,qDAAqD;AACrD,MAAM,UAAU,UAAU,CACxB,KAAY,EACZ,IAAY,EACZ,MAAc,EACd,QAAsB,EAAE;IAExB,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,IAAY,EAAE,GAAW;IAChE,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,eAAe,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/domain/release/version-evidence.js

@@ -0,0 +1,6 @@
+// Pinned declaration and history evidence, independent of release policy. A field
+// change is a first-parent Git event, never a publication or deployment timestamp.
+export function sameVersionSource(a, b) {
+    return a.file === b.file && a.field === b.field && a.package_name === b.package_name;
+}
+//# sourceMappingURL=version-evidence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-evidence.js","sourceRoot":"","sources":["../../../src/domain/release/version-evidence.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,mFAAmF;AAqDnF,MAAM,UAAU,iBAAiB,CAAC,CAAgB,EAAE,CAAgB;IAClE,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY,CAAC;AACvF,CAAC"}

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":"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"}

package/dist/domain/report.js

@@ -10,6 +10,8 @@ export function finding(group, id, level, message, extra = {}) {
         ...(extra.fix === undefined ? {} : { fix: extra.fix }),
         ...(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;AA0C7E,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,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.0",
+  "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.0
+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,9 +206,15 @@ 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; full results also carry evidence. `repos[]` says what each release would ship,
+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:
+`RELEASE_INCOMPLETE` means no confirmed failure but missing evidence, and a known
+failure can also have incomplete coverage. Human output groups identical unavailable
+causes separately from confirmed problems; `--details` expands all repository checks.
+A missing error-tracker project is incomplete coverage and must be corrected or
+explicitly marked not covered; never substitute an organization-wide query. `repos[]` says what each release would ship,
 in summaries too. For `can`, inspect its capability status.
 
 Doctor groups are `repos`, `root`, `tools`, `login`, `agents`, `manifest`, `self`,
@@ -192,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)
@@ -227,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