@slicedearth/whoisleuth-cli 2.3.0 → 2.5.1

package/packages/investigation/storefront-review.mjs

@@ -0,0 +1,70 @@
+import { array, boolean, domain, enumeration, exact, HEX_DIGEST_RE, iso, text } from "../evidence/artifact-structure.mjs";
+import { pageObservationOrigin } from "./page-behaviour.mjs";
+import { CONTEXT_REVIEW_SCHEMA, CONTEXT_REVIEW_VERSION, MAX_CONTEXT_RECORDS } from "../contracts/context-review.mjs";
+export { STOREFRONT_INPUT_SCHEMA, STOREFRONT_INPUT_VERSION } from "../contracts/context-review.mjs";
+export const STOREFRONT_FIELDS = [
+    { id: 'brandNames', label: 'Displayed brand names', treatment: 'text' },
+    { id: 'contactDomains', label: 'Published contact domains', treatment: 'domain' },
+    { id: 'policyHashes', label: 'Policy text SHA-256 digests', treatment: 'hash' },
+    { id: 'checkoutOrigins', label: 'Checkout destinations', treatment: 'origin' },
+    { id: 'paymentMethods', label: 'Advertised payment methods', treatment: 'text' },
+    { id: 'assetHashes', label: 'Distinctive asset SHA-256 digests', treatment: 'hash' },
+];
+export function readStorefrontObservation(raw) {
+    const row = exact(raw, ['hostname', 'observedAt', 'source', ...STOREFRONT_FIELDS.map(field => field.id)], 'Storefront observation');
+    domain(row.hostname, 'Storefront hostname');
+    iso(row.observedAt, 'Storefront observation time');
+    const fields = {};
+    let count = 0;
+    for (const field of STOREFRONT_FIELDS) {
+        if (row[field.id] === null) {
+            fields[field.id] = null;
+            continue;
+        }
+        const values = array(row[field.id], field.label, MAX_CONTEXT_RECORDS);
+        count += values.length;
+        if (count > MAX_CONTEXT_RECORDS)
+            throw new TypeError('A storefront observation exceeds the aggregate evidence-item bound.');
+        fields[field.id] = [...new Set(values.map(value => {
+                const candidate = text(value, field.label, 500);
+                if (field.treatment === 'domain')
+                    domain(candidate, field.label);
+                if (field.treatment === 'hash' && !HEX_DIGEST_RE.test(candidate))
+                    throw new TypeError('Storefront digests must be lowercase hexadecimal SHA-256.');
+                if (field.treatment === 'origin' && pageObservationOrigin(candidate) !== candidate)
+                    throw new TypeError('Checkout observations retain HTTP(S) origins only.');
+                return candidate;
+            }))].sort();
+    }
+    return { hostname: row.hostname, observedAt: row.observedAt, source: text(row.source, 'Storefront source', 500), ...fields };
+}
+export function reviewStorefront(raw, reviewedAt) {
+    iso(reviewedAt, 'Review time');
+    const input = exact(raw, ['official', 'candidate', 'authorisedComparator', 'resellerStatus', 'resellerSource'], 'Storefront comparison');
+    boolean(input.authorisedComparator, 'Comparator authority');
+    if (!input.authorisedComparator)
+        throw new TypeError('Confirm that the official comparator is owned or authorised for this review.');
+    const official = readStorefrontObservation(input.official), candidate = readStorefrontObservation(input.candidate);
+    if (official.hostname === candidate.hostname)
+        throw new TypeError('Select a different candidate hostname for storefront comparison.');
+    const reseller = enumeration(input.resellerStatus, ['authorised', 'not_authorised', 'unknown'], 'Reseller status');
+    const resellerSource = input.resellerSource === null ? null : text(input.resellerSource, 'Reseller evidence', 500);
+    if (reseller !== 'unknown' && !resellerSource)
+        throw new TypeError('A reseller-status declaration needs its source or authority reference.');
+    const observations = [];
+    let missing = 0;
+    for (const field of STOREFRONT_FIELDS) {
+        const left = official[field.id], right = candidate[field.id];
+        if (left === null || right === null)
+            missing++;
+        const shared = left && right ? right.filter(value => left.includes(value)) : [];
+        observations.push({ label: field.label, state: left === null || right === null ? 'unknown' : 'observed',
+            detail: `Official: ${left === null ? 'not reviewed' : left.length ? left.join(', ') : 'no values recorded'}. Candidate: ${right === null ? 'not reviewed' : right.length ? right.join(', ') : 'no values recorded'}. ${left !== null && right !== null ? `Exact shared values: ${shared.length}.` : 'No comparison established.'}`,
+            source: `${official.hostname} · ${official.source} · ${official.observedAt} / ${candidate.hostname} · ${candidate.source}`, observedAt: candidate.observedAt, hostname: candidate.hostname });
+    }
+    observations.push({ label: 'Reseller or affiliate authority', state: reseller === 'unknown' ? 'unknown' : 'reported', detail: reseller.replaceAll('_', ' '), source: resellerSource ?? 'No authority evidence supplied', observedAt: null, hostname: candidate.hostname });
+    return { schema: CONTEXT_REVIEW_SCHEMA, version: CONTEXT_REVIEW_VERSION, kind: 'storefront', reviewedAt, title: 'Storefront comparison', state: missing ? 'partial' : 'reviewed',
+        summary: `${candidate.hostname} compared with the authorised reference ${official.hostname}; evidence categories missing one side: ${missing}.`, observations,
+        nextSteps: ['Check reseller, affiliate and regional-store authority before preparing a complaint.', 'Retain the source pages and distinctive assets privately; select relevant findings in the Case response packet.', 'Use the observed checkout platform and the rights or policy evidence to choose a reporting route. Do not enter payment information or submit an order.'],
+        limitations: ['This compares analyst-supplied observations. It does not collect a page, verify a merchant, submit a payment or issue a scam score.', 'Shared wording, assets and payment providers can have legitimate explanations. Digests establish byte equality only when inputs were captured consistently; missing observations do not establish absence.'] };
+}

package/packages/monitoring/analyst-review-state.mjs

@@ -1,3 +1,5 @@
+import { sha256IdentityHex } from "../evidence/record-identity.mjs";
+import { normalizeExplicitIsoTimestamp } from "../evidence/observation.mjs";
 /**
  * Canonical, framework-independent analyst review identity and lifecycle.
  *
@@ -7,7 +9,12 @@
  */
 import { ANALYST_REVIEW_DISPOSITIONS, ANALYST_REVIEW_EVIDENCE_FAMILIES, ANALYST_REVIEW_STATE_SCHEMA, ANALYST_REVIEW_STATE_SCHEMA_VERSION, MAX_ANALYST_REVIEW_ASSOCIATIONS, MAX_ANALYST_REVIEW_HISTORY, MAX_ANALYST_REVIEW_IDENTITY_BYTES, MAX_ANALYST_REVIEW_ITEMS, MAX_ANALYST_REVIEW_RATIONALE_LENGTH, MAX_ANALYST_REVIEW_STATE_BYTES, MAX_ANALYST_REVIEW_STATE_RECORDS, } from "../contracts/analyst-review-state-contract.mjs";
 export * from "../contracts/analyst-review-state-contract.mjs";
+export { ANALYST_REVIEW_AGING_AFTER_DAYS, ANALYST_REVIEW_STALE_AFTER_DAYS, analystReviewAgeAt } from "../evidence/review-age.mjs";
+export function analystReviewCanResolve(item) {
+    return item.completeness === 'complete' && (item.age === 'current' || item.age === 'aging');
+}
 const CONTROL_RE = /[\u0000-\u001f\u007f]/u;
+const RATIONALE_INPUT_CONTROL_RE = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u;
 const SAFE_REFERENCE_RE = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u;
 const SAFE_SUBJECT_RE = /^review:[a-z0-9_]{1,40}:[a-f0-9]{64}$/u;
 const SAFE_FINGERPRINT_RE = /^material:[a-f0-9]{64}$/u;
@@ -122,28 +129,24 @@ export function assertAnalystReviewInputGraph(value) {
         }
     }
 }
-function boundedText(value, maximum, label, required = true) {
-    if (typeof value !== 'string' || value.length > maximum * 4 || CONTROL_RE.test(value)) {
-        if (!required && (value === null || value === undefined || value === ''))
-            return '';
+function boundedRationale(value, label, formInput = false) {
+    const maximum = MAX_ANALYST_REVIEW_RATIONALE_LENGTH;
+    const controls = formInput ? RATIONALE_INPUT_CONTROL_RE : CONTROL_RE;
+    if (typeof value !== 'string' || value.length > maximum * 4 || controls.test(value)) {
         throw inputError(`${label} is invalid`);
     }
+    // Forms may contain ordinary line breaks; stored rationale remains single-line.
     const normalized = value.replace(/\s+/gu, ' ').trim();
-    if ((required && !normalized) || normalized.length > maximum)
+    if (!normalized || normalized.length > maximum)
         throw inputError(`${label} is invalid`);
     return normalized;
 }
 function timestamp(value, label, nullable = false) {
     if (nullable && (value === null || value === undefined || value === ''))
         return null;
-    if (typeof value !== 'string' || value.length > 64 || CONTROL_RE.test(value))
-        throw inputError(`${label} is invalid`);
-    const parsed = Date.parse(value);
-    if (!Number.isFinite(parsed))
-        throw inputError(`${label} must use an explicit valid date and time`);
-    const normalized = new Date(parsed).toISOString();
-    if (!/(?:Z|[+-]\d{2}:\d{2})$/u.test(value))
-        throw inputError(`${label} must use an explicit timezone`);
+    const normalized = normalizeExplicitIsoTimestamp(value);
+    if (!normalized)
+        throw inputError(`${label} must use an explicit valid date, time and timezone`);
     return normalized;
 }
 function referenceList(value, label) {
@@ -181,7 +184,7 @@ function normalizeSnapshot(raw, label) {
     const normalized = {
         reviewedFingerprint: fingerprint(value.reviewedFingerprint, `${label}.reviewedFingerprint`),
         disposition: normalizedDisposition,
-        rationale: boundedText(value.rationale, MAX_ANALYST_REVIEW_RATIONALE_LENGTH, `${label}.rationale`),
+        rationale: boundedRationale(value.rationale, `${label}.rationale`),
         reviewedAt: timestamp(value.reviewedAt, `${label}.reviewedAt`),
         reviewDueAt: timestamp(value.reviewDueAt, `${label}.reviewDueAt`, true),
         expiresAt: timestamp(value.expiresAt, `${label}.expiresAt`, true),
@@ -278,7 +281,7 @@ export function normalizeAnalystReviewStateStore(raw) {
         records,
     };
     if (byteLength(JSON.stringify(store)) > MAX_ANALYST_REVIEW_STATE_BYTES) {
-        throw new Error('Analyst review state exceeds the 512 KiB browser-local storage limit.');
+        throw new Error('Analyst review state exceeds the 512 KiB workspace storage limit.');
     }
     return store;
 }
@@ -323,75 +326,8 @@ export function canonicalAnalystReviewIdentityJson(parts) {
     }
     return source;
 }
-const SHA256_CONSTANTS = Object.freeze([
-    0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
-    0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
-    0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
-    0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
-    0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
-    0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
-    0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
-    0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
-]);
-function rotateRight(value, bits) {
-    return (value >>> bits) | (value << (32 - bits));
-}
-function sha256Hex(bytes) {
-    // This digest is a collision-resistant record identity, not a password,
-    // signature, MAC, or substitute for the platform cryptography used there.
-    const paddedLength = Math.ceil((bytes.byteLength + 9) / 64) * 64;
-    const padded = new Uint8Array(paddedLength);
-    padded.set(bytes);
-    padded[bytes.byteLength] = 0x80;
-    const view = new DataView(padded.buffer);
-    const bitLength = bytes.byteLength * 8;
-    view.setUint32(paddedLength - 8, Math.floor(bitLength / 0x1_0000_0000), false);
-    view.setUint32(paddedLength - 4, bitLength >>> 0, false);
-    const state = new Uint32Array([
-        0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a,
-        0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,
-    ]);
-    const words = new Uint32Array(64);
-    for (let offset = 0; offset < paddedLength; offset += 64) {
-        for (let index = 0; index < 16; index += 1)
-            words[index] = view.getUint32(offset + index * 4, false);
-        for (let index = 16; index < 64; index += 1) {
-            const left = words[index - 15];
-            const right = words[index - 2];
-            const sigma0 = rotateRight(left, 7) ^ rotateRight(left, 18) ^ (left >>> 3);
-            const sigma1 = rotateRight(right, 17) ^ rotateRight(right, 19) ^ (right >>> 10);
-            words[index] = (words[index - 16] + sigma0 + words[index - 7] + sigma1) >>> 0;
-        }
-        let [a, b, c, d, e, f, g, h] = state;
-        for (let index = 0; index < 64; index += 1) {
-            const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
-            const choice = (e & f) ^ (~e & g);
-            const first = (h + sum1 + choice + SHA256_CONSTANTS[index] + words[index]) >>> 0;
-            const sum0 = rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22);
-            const majority = (a & b) ^ (a & c) ^ (b & c);
-            const second = (sum0 + majority) >>> 0;
-            h = g;
-            g = f;
-            f = e;
-            e = (d + first) >>> 0;
-            d = c;
-            c = b;
-            b = a;
-            a = (first + second) >>> 0;
-        }
-        state[0] = (state[0] + a) >>> 0;
-        state[1] = (state[1] + b) >>> 0;
-        state[2] = (state[2] + c) >>> 0;
-        state[3] = (state[3] + d) >>> 0;
-        state[4] = (state[4] + e) >>> 0;
-        state[5] = (state[5] + f) >>> 0;
-        state[6] = (state[6] + g) >>> 0;
-        state[7] = (state[7] + h) >>> 0;
-    }
-    return [...state].map((value) => value.toString(16).padStart(8, '0')).join('');
-}
 function stableHash(parts) {
-    return sha256Hex(new TextEncoder().encode(canonicalAnalystReviewIdentityJson(parts)));
+    return sha256IdentityHex(new TextEncoder().encode(canonicalAnalystReviewIdentityJson(parts)));
 }
 export function analystReviewSubjectKey(evidenceFamily, stableParts) {
     if (!FAMILY_VALUES.has(evidenceFamily))
@@ -421,6 +357,11 @@ function snapshotIdentity(snapshot) {
         snapshot.expiresAt,
     ]);
 }
+export function analystReviewDecisionIdentity(subjectKey, snapshot) {
+    if (!SAFE_SUBJECT_RE.test(subjectKey))
+        throw inputError('Review subject identity is invalid');
+    return `decision:${stableHash([subjectKey, snapshotIdentity(snapshot)])}`;
+}
 function mergedReviewHistory(current, other) {
     const currentIdentity = snapshotIdentity(currentSnapshot(current));
     const byIdentity = new Map();
@@ -445,10 +386,10 @@ export function setAnalystReviewDecision(raw, item, input) {
     }
     if (!DISPOSITION_VALUES.has(input.disposition))
         throw new TypeError('Choose a valid Review Item disposition.');
-    if (input.disposition === 'resolved' && (item.completeness !== 'complete' || item.age === 'stale')) {
-        throw new Error('Partial, inconclusive, or stale evidence cannot resolve a Review Item. Refresh or attach current complete evidence first.');
+    if (input.disposition === 'resolved' && !analystReviewCanResolve(item)) {
+        throw new Error('Partial, inconclusive, stale or undated evidence cannot resolve a Review Item. Refresh or attach current complete evidence first.');
     }
-    const rationale = boundedText(input.rationale, MAX_ANALYST_REVIEW_RATIONALE_LENGTH, 'rationale');
+    const rationale = boundedRationale(input.rationale, 'rationale', true);
     const reviewedAt = timestamp(input.reviewedAt ?? new Date().toISOString(), 'reviewedAt');
     const expiresAt = timestamp(input.expiresAt, 'expiresAt', true);
     const reviewDueAt = timestamp(input.reviewDueAt, 'reviewDueAt', true);
@@ -492,7 +433,14 @@ export function analystReviewLifecycle(item, raw, nowRaw = new Date().toISOStrin
     if (!decision) {
         return { state: 'open', effectiveDisposition: 'open', decision: null, reason: 'No analyst lifecycle decision is retained.', expired: false, invalidated: false, recurred: false, reviewDue: false };
     }
-    const now = timestamp(nowRaw, 'now');
+    const now = normalizeExplicitIsoTimestamp(nowRaw);
+    if (!now || Date.parse(now) < Date.parse(decision.reviewedAt)) {
+        return {
+            state: 'invalidated', effectiveDisposition: 'open', decision,
+            reason: 'The review clock is unavailable or earlier than the retained decision. Its disposition cannot hide current work.',
+            expired: false, invalidated: true, recurred: decision.disposition !== 'open', reviewDue: false,
+        };
+    }
     const invalidated = decision.reviewedFingerprint !== item.materialFingerprint;
     const expired = decision.expiresAt !== null && Date.parse(decision.expiresAt) <= Date.parse(now);
     const reviewDue = decision.reviewDueAt !== null && Date.parse(decision.reviewDueAt) <= Date.parse(now);
@@ -518,10 +466,10 @@ export function analystReviewLifecycle(item, raw, nowRaw = new Date().toISOStrin
             expired: false, invalidated: false, recurred: true, reviewDue: true,
         };
     }
-    if (decision.disposition === 'resolved' && (item.completeness !== 'complete' || item.age === 'stale')) {
+    if (decision.disposition === 'resolved' && !analystReviewCanResolve(item)) {
         return {
             state: 'invalidated', effectiveDisposition: 'open', decision,
-            reason: 'The current evidence is partial, inconclusive, or stale, so the retained resolved decision cannot close this item.',
+            reason: 'The current evidence is partial, inconclusive, stale or undated, so the retained resolved decision cannot close this item.',
             expired: false, invalidated: true, recurred: true, reviewDue,
         };
     }
@@ -607,7 +555,7 @@ function normalizeDevelopmentSnapshot(raw, label) {
     return {
         reviewedFingerprint: developmentFingerprint(value.reviewedFingerprint, `${label}.reviewedFingerprint`),
         disposition: disposition(value.disposition, `${label}.disposition`),
-        rationale: boundedText(value.rationale, MAX_ANALYST_REVIEW_RATIONALE_LENGTH, `${label}.rationale`),
+        rationale: boundedRationale(value.rationale, `${label}.rationale`),
         reviewedAt,
         reviewDueAt: reviewDueAt && Date.parse(reviewDueAt) > Date.parse(reviewedAt) ? reviewDueAt : null,
         expiresAt: expiresAt && Date.parse(expiresAt) > Date.parse(reviewedAt) ? expiresAt : null,

package/packages/workspace/brand-profile-model.mjs

@@ -1,11 +1,16 @@
 // Pure Brand Profile normalization and storage model. The browser wrapper owns
 // persistence and downloads; this module owns schema migration, semantic field
 // bounds, import merging, and exact serialized-byte accounting.
-import { normalizeDomain } from "../cases/case-model.mjs";
+import { normalizeDomain } from "../evidence/domain-name.mjs";
 import { normalizeExplicitIsoTimestamp } from "../evidence/observation.mjs";
+import { canonicalDomainControlRecords, normalizeDeclaredDomainControlRecordModes, normalizeDomainControlRecordModes } from "../evidence/domain-control-runtime.mjs";
+import { DOMAIN_CONTROL_RECORD_LIST_FIELDS } from "../contracts/domain-control-manifest.mjs";
+import { latestObservationCohort } from "../evidence/latest-observations.mjs";
+import { MAX_IDENTITY_DIGEST_BYTES, sha256IdentityHex } from "../evidence/record-identity.mjs";
+import { DOMAIN_POSTURE_COMPARISON_VERSION, MAX_POSTURE_CHECKS, MAX_POSTURE_CHECK_RECORDS, MAX_POSTURE_RECORD_LENGTH, normalizeDomainPostureSourceContext, normalizeDomainPostureProfileContext } from "../evidence/domain-posture-context.mjs";
 import { normalizeOpaqueReferenceId } from "../cases/opaque-reference-id.mjs";
 import { normalizePageBaseline } from "./page-baseline.mjs";
-import { isInformativePerceptualHash as isInformativeFaviconHash } from "../../lib/perceptual-hash-comparison.mjs";
+import { isInformativePerceptualHash as isInformativeFaviconHash } from "../analysis/perceptual-hash-comparison.mjs";
 import { assertWorkspaceDeclaredVersion, assertWorkspaceInputGraph, assertWorkspacePortableVersion, ordinaryWorkspaceRecord } from "./hostile-input.mjs";
 import { BRAND_PROFILE_SCHEMA, BRAND_PROFILE_SCHEMA_VERSION, MAX_DESIRED_POSTURE_BASELINES, MAX_DESIRED_POSTURE_CHANGE_WINDOWS, MAX_DESIRED_POSTURE_OBSERVATIONS, MAX_DESIRED_POSTURE_RECORDS, MAX_DESIRED_POSTURE_SUPPRESSIONS, MAX_DKIM_SELECTOR_LENGTH, MAX_DKIM_SELECTORS, MAX_OFFICIAL_CHANNELS, MAX_PROFILES, MAX_PROFILE_DOMAIN_LENGTH, MAX_PROFILE_NAME_LENGTH, MAX_PROFILE_STORE_BYTES, MAX_PROFILE_TEXT_LENGTH, MAX_PROFILE_TLD_LENGTH, MAX_PROFILE_URL_LENGTH, MAX_PROFILE_VALUE_INPUTS, MAX_PROFILE_VALUES, MAX_PROTECTION_ATTESTATIONS, MAX_RIGHTS_REFERENCES, SUPPORTED_BRAND_PROFILE_SCHEMA_VERSIONS, } from "../contracts/workspace-portability.mjs";
 export { BRAND_PROFILE_SCHEMA, BRAND_PROFILE_SCHEMA_VERSION, MAX_DESIRED_POSTURE_BASELINES, MAX_DESIRED_POSTURE_CHANGE_WINDOWS, MAX_DESIRED_POSTURE_OBSERVATIONS, MAX_DESIRED_POSTURE_RECORDS, MAX_DESIRED_POSTURE_SUPPRESSIONS, MAX_DKIM_SELECTOR_LENGTH, MAX_DKIM_SELECTORS, MAX_OFFICIAL_CHANNELS, MAX_PROFILES, MAX_PROFILE_DOMAIN_LENGTH, MAX_PROFILE_NAME_LENGTH, MAX_PROFILE_STORE_BYTES, MAX_PROFILE_TEXT_LENGTH, MAX_PROFILE_TLD_LENGTH, MAX_PROFILE_URL_LENGTH, MAX_PROFILE_VALUE_INPUTS, MAX_PROFILE_VALUES, MAX_PROTECTION_ATTESTATIONS, MAX_RIGHTS_REFERENCES, SUPPORTED_BRAND_PROFILE_SCHEMA_VERSIONS, } from "../contracts/workspace-portability.mjs";
@@ -118,6 +123,32 @@ export function normalizeProfileDomains(value) {
 export function normalizeProfileTextValues(value) {
     return normalizeList(value, (item) => boundedText(item));
 }
+export const MAX_ALLOWLIST_DRAFT_CHARACTERS = (MAX_PROFILE_DOMAIN_LENGTH + 2) * MAX_PROFILE_VALUE_INPUTS;
+/** Admit the complete submitted list or leave the draft unchanged. */
+export function addBrandAllowlistValues(profile, kind, current, raw) {
+    if (raw.length > MAX_ALLOWLIST_DRAFT_CHARACTERS)
+        throw new RangeError('The submitted allowlist text is too large.');
+    const inputs = raw.split(/[\n,]+/u).map((item) => item.trim()).filter(Boolean);
+    if (inputs.length > MAX_PROFILE_VALUE_INPUTS)
+        throw new RangeError(`Review at most ${MAX_PROFILE_VALUE_INPUTS} entries at a time.`);
+    const next = new Map(current.map((value) => [value.toLowerCase(), value]));
+    const trusted = new Set([...profile.officialDomains, ...profile.approvedPartnerDomains]);
+    for (const [index, input] of inputs.entries()) {
+        const value = kind === 'domains' ? normalizeProfileDomains([input])[0] : normalizeProfileTextValues([input])[0];
+        if (!value || (kind === 'registrars' && input.replace(/\s+/gu, ' ').length > MAX_PROFILE_TEXT_LENGTH)) {
+            throw new TypeError(`Allowlist entry ${index + 1} is invalid or too long. No entries were added.`);
+        }
+        if (kind === 'domains' && trusted.has(value))
+            continue;
+        if (!next.has(value.toLowerCase()))
+            next.set(value.toLowerCase(), value);
+    }
+    if (next.size > MAX_PROFILE_VALUES)
+        throw new RangeError(`This list would contain ${next.size} entries; the current profile supports ${MAX_PROFILE_VALUES}. No entries were added.`);
+    if (next.size === current.length)
+        throw new TypeError('No new entries remain after excluding existing and trusted values.');
+    return [...next.values()];
+}
 export function normalizeProfileTlds(value) {
     return normalizeList(value, normalizeTld);
 }
@@ -159,6 +190,30 @@ export function normalizeProtectionAttestations(value) {
     }
     return output;
 }
+/** Only submitted, validated reviews acquire a new analyst-review clock. */
+export function reviewProtectionAttestations(existing, reviews, nowIso) {
+    const assertedAt = timestamp(nowIso, null);
+    if (!assertedAt)
+        throw new TypeError('The account-control review time is invalid.');
+    if (reviews.length > MAX_PROTECTION_ATTESTATIONS)
+        throw new RangeError('Too many account-control reviews were submitted.');
+    const next = new Map(existing.map((item) => [item.control, { ...item }]));
+    const seen = new Set();
+    for (const review of reviews) {
+        if (!PROTECTION_ATTESTATION_CONTROL_SET.has(review.control) || seen.has(review.control)
+            || !PROTECTION_ATTESTATION_STATES.has(review.state))
+            throw new TypeError('An account-control review is invalid or repeated.');
+        const expiresAt = review.expiresAt === null ? null : timestamp(review.expiresAt, null);
+        if (review.expiresAt !== null && !expiresAt)
+            throw new TypeError('Enter a valid account-control expiry date.');
+        if (typeof review.note !== 'string' || CONTROL_RE.test(review.note)
+            || review.note.replace(/\s+/gu, ' ').trim().length > MAX_PROFILE_TEXT_LENGTH)
+            throw new TypeError(`Account-control notes must contain at most ${MAX_PROFILE_TEXT_LENGTH} characters and no control characters.`);
+        seen.add(review.control);
+        next.set(review.control, { control: review.control, state: review.state, assertedAt, expiresAt, note: boundedText(review.note) });
+    }
+    return [...next.values()];
+}
 function normalizeDesiredPostureRecords(value, normalizer) {
     if (!Array.isArray(value))
         return [];
@@ -176,9 +231,10 @@ function normalizeDesiredPostureRecords(value, normalizer) {
 }
 function normalizeDesiredPostureObservation(value) {
     const candidate = record(value);
-    const observedAt = timestamp(candidate.observedAt, null);
-    if (!observedAt || !Array.isArray(candidate.checks))
+    const observedAt = normalizeExplicitIsoTimestamp(candidate.observedAt) ?? '';
+    if (!Array.isArray(candidate.checks))
         return null;
+    const context = normalizeDomainPostureProfileContext(candidate.context);
     const checks = [];
     const seen = new Set();
     for (const item of candidate.checks.slice(0, 64)) {
@@ -190,28 +246,88 @@ function normalizeDesiredPostureObservation(value) {
             || !POSTURE_CHECK_STATUSES.has(check.status))
             continue;
         seen.add(id);
+        if (check.sourceContext !== undefined && !Array.isArray(check.records))
+            throw new TypeError('Source-qualified posture records must be an array.');
+        const inputRecords = Array.isArray(check.records) ? check.records : [];
+        const records = [];
+        for (const item of inputRecords.slice(0, MAX_POSTURE_CHECK_RECORDS)) {
+            if (typeof item === 'string' && item.length <= MAX_POSTURE_RECORD_LENGTH && !CONTROL_RE.test(item))
+                records.push(item);
+        }
+        const omitted = Math.max(0, inputRecords.length - records.length);
+        const source = normalizeDomainPostureSourceContext(check.sourceContext);
+        const sourceContext = source && omitted ? {
+            ...source,
+            state: source.state === 'unavailable' ? 'unavailable' : 'partial',
+            omittedRecords: source.omittedRecords === null ? null : Math.min(Number.MAX_SAFE_INTEGER, source.omittedRecords + omitted),
+        } : source;
         checks.push({
             id,
             status: check.status,
-            records: normalizeDesiredPostureRecords(check.records),
+            records,
+            ...(sourceContext ? { sourceContext } : {}),
         });
-        if (checks.length >= 32)
+        if (checks.length >= MAX_POSTURE_CHECKS)
             break;
     }
-    return checks.length ? { observedAt, checks } : null;
+    const omittedChecks = Math.max(0, candidate.checks.length - checks.length)
+        + (Number.isSafeInteger(candidate.omittedChecks) && Number(candidate.omittedChecks) > 0 ? Number(candidate.omittedChecks) : 0);
+    return checks.length ? { observedAt, ...(context ? { context } : {}), checks, ...(omittedChecks ? { omittedChecks: Math.min(Number.MAX_SAFE_INTEGER, omittedChecks) } : {}) } : null;
 }
-function normalizeDesiredPostureObservationHistory(value, previous) {
+export function normalizeDesiredPostureObservationHistory(value, previous) {
     const candidates = Array.isArray(value) ? value : previous ? [previous] : [];
     const byTime = new Map();
     for (const item of candidates.slice(0, MAX_DESIRED_POSTURE_OBSERVATIONS * 4)) {
         const normalized = normalizeDesiredPostureObservation(item);
-        if (normalized)
-            byTime.set(normalized.observedAt, normalized);
+        if (!normalized)
+            continue;
+        if (new TextEncoder().encode(JSON.stringify(normalized)).byteLength > MAX_IDENTITY_DIGEST_BYTES) {
+            throw new RangeError('Record identity exceeds its byte limit.');
+        }
+        const cohort = byTime.get(normalized.observedAt) ?? [];
+        cohort.push(normalized);
+        byTime.set(normalized.observedAt, cohort);
     }
-    return [...byTime.values()]
-        .sort((left, right) => Date.parse(left.observedAt) - Date.parse(right.observedAt))
+    return [...byTime.entries()]
+        .sort(([left], [right]) => !left ? 1 : !right ? -1 : Date.parse(left) - Date.parse(right))
+        .flatMap(([, cohort]) => {
+        // Different capture times already distinguish observations. Digest-based
+        // deduplication and ordering remain necessary only within a tied cohort.
+        if (cohort.length === 1)
+            return cohort;
+        const byIdentity = new Map(cohort.map((observation) => [desiredPostureObservationIdentity(observation), observation]));
+        return [...byIdentity.entries()].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+            .map(([, observation]) => observation);
+    })
         .slice(-MAX_DESIRED_POSTURE_OBSERVATIONS);
 }
+export function desiredPostureObservationIdentity(observation) {
+    return sha256IdentityHex(new TextEncoder().encode(JSON.stringify(observation)));
+}
+export function desiredPostureObservations(baseline) {
+    return baseline.observationHistory?.length ? baseline.observationHistory : baseline.previousObservation ? [baseline.previousObservation] : [];
+}
+export function currentDesiredPostureObservation(baseline) {
+    const history = desiredPostureObservations(baseline);
+    const cohort = latestObservationCohort(history, (item) => item.observedAt);
+    return {
+        observation: !cohort.undated.length && cohort.latest.length === 1 ? cohort.latest[0] : null,
+        candidates: [...cohort.latest, ...cohort.undated],
+        limitation: cohort.undated.length ? 'Retained observations include an unknown capture time; no unique latest review is selected.'
+            : cohort.latest.length > 1 ? 'Distinct observations share the latest capture time; no unique latest review is selected.' : null,
+    };
+}
+export function brandPostureCollectionFingerprint(profile) {
+    return sha256IdentityHex(new TextEncoder().encode(JSON.stringify([
+        profile.id, [...profile.officialDomains].sort(), profile.mailProtectionProfile,
+        [...profile.dkimSelectors].sort(), [...profile.retiredDkimSelectors].sort(),
+    ])));
+}
+export function brandPostureObservationContext(profile, domain) {
+    if (!profile.officialDomains.includes(domain))
+        throw new TypeError('Posture observation target is not an official domain of this profile.');
+    return { version: DOMAIN_POSTURE_COMPARISON_VERSION, domain, profileId: profile.id, profileFingerprint: brandPostureCollectionFingerprint(profile) };
+}
 function deterministicChangeWindowId(seed) {
     const states = [0x811c9dc5, 0x9e3779b9, 0x85ebca6b, 0xc2b2ae35];
     const factors = [0x01000193, 0x85ebca6b, 0xc2b2ae35, 0x27d4eb2f];
@@ -270,6 +386,23 @@ function normalizeTlsSanPatterns(value) {
     }
     return [...output].sort();
 }
+function normalizeBaselineRecords(candidate) {
+    const records = {
+        nameservers: normalizeDesiredPostureRecords(candidate.nameservers, (entry) => normalizeDomain(entry)),
+        ds: normalizeDesiredPostureRecords(candidate.ds),
+        mx: normalizeDesiredPostureRecords(candidate.mx),
+        caa: normalizeDesiredPostureRecords(candidate.caa),
+    };
+    if (!Object.hasOwn(candidate, 'recordModes'))
+        return records;
+    const recordModes = normalizeDeclaredDomainControlRecordModes(candidate.recordModes);
+    for (const field of DOMAIN_CONTROL_RECORD_LIST_FIELDS) {
+        if (Object.hasOwn(recordModes, field))
+            records[field] = canonicalDomainControlRecords(candidate[field], field);
+    }
+    normalizeDomainControlRecordModes(recordModes, records);
+    return { ...records, recordModes };
+}
 export function normalizeDesiredPostureBaselines(value, officialDomains, fallbackNow = new Date().toISOString(), identityScope = '') {
     if (!Array.isArray(value))
         return [];
@@ -306,10 +439,7 @@ export function normalizeDesiredPostureBaselines(value, officialDomains, fallbac
         output.push({
             version: 1,
             domain,
-            nameservers: normalizeDesiredPostureRecords(candidate.nameservers, (entry) => normalizeDomain(entry)),
-            ds: normalizeDesiredPostureRecords(candidate.ds),
-            mx: normalizeDesiredPostureRecords(candidate.mx),
-            caa: normalizeDesiredPostureRecords(candidate.caa),
+            ...normalizeBaselineRecords(candidate),
             tlsIssuer: boundedText(candidate.tlsIssuer, MAX_PROFILE_TEXT_LENGTH),
             tlsSanPatterns: normalizeTlsSanPatterns(candidate.tlsSanPatterns),
             tlsSpkiSha256: typeof candidate.tlsSpkiSha256 === 'string' && SHA256_RE.test(candidate.tlsSpkiSha256)
@@ -329,7 +459,7 @@ export function normalizeDesiredPostureBaselines(value, officialDomains, fallbac
             approvedChangeWindows: normalizeDesiredPostureChangeWindows(candidate.approvedChangeWindows, `${identityScope}\u001f${domain}`),
             suppressions,
             note: boundedText(candidate.note, MAX_PROFILE_TEXT_LENGTH),
-            previousObservation: observationHistory.at(-1) ?? previousObservation,
+            previousObservation: currentDesiredPostureObservation({ observationHistory, previousObservation }).observation,
             observationHistory,
             updatedAt: timestamp(candidate.updatedAt, fallback),
         });
@@ -510,7 +640,7 @@ export function brandProfileStoreVersion(raw) {
 }
 /** Normalize an internal profile collection or current stored envelope. */
 export function normalizeBrandProfileStore(raw) {
-    assertWorkspaceInputGraph(raw, 'Brand Profile store');
+    assertWorkspaceInputGraph(raw, 'Brand Profile store', { maximumBytes: MAX_PROFILE_STORE_BYTES });
     assertWorkspaceDeclaredVersion(raw, 'Brand Profile store');
     const sourceVersion = brandProfileStoreVersion(raw);
     if (!Array.isArray(raw) && sourceVersion !== null
@@ -532,6 +662,10 @@ export function normalizeBrandProfileStore(raw) {
     }
     return { version: BRAND_PROFILE_SCHEMA_VERSION, profiles: [...byId.values()] };
 }
+/** New authored/imported records receive an identity only at the mutation boundary. */
+export function createBrandProfileId() {
+    return crypto.randomUUID ? crypto.randomUUID() : `bp-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
 export function serializeBrandProfileStore(profiles) {
     return JSON.stringify(assertBrandProfileStoreBudget(profiles));
 }
@@ -546,8 +680,8 @@ export function assertBrandProfileStoreBudget(profiles) {
     return store;
 }
 export function mergeBrandProfiles(localRaw, importedRaw, options = {}) {
-    assertWorkspaceInputGraph(localRaw, 'Local Brand Profile store');
-    assertWorkspaceInputGraph(importedRaw, 'Imported Brand Profile document');
+    const local = normalizeBrandProfileStore(localRaw).profiles;
+    assertWorkspaceInputGraph(importedRaw, 'Imported Brand Profile document', { maximumBytes: MAX_PROFILE_STORE_BYTES });
     assertWorkspacePortableVersion(importedRaw, BRAND_PROFILE_SCHEMA_VERSION, 'Imported Brand Profile document');
     const imported = record(importedRaw);
     if (imported.schema !== BRAND_PROFILE_SCHEMA) {
@@ -579,7 +713,6 @@ export function mergeBrandProfiles(localRaw, importedRaw, options = {}) {
         if (id && name)
             retainIdName(id, name);
     }
-    const local = normalizeBrandProfileStore(localRaw).profiles;
     for (const profile of local)
         retainIdName(profile.id, profile.name);
     const byName = new Map(local.map((profile) => [profile.name.toLowerCase(), profile]));
@@ -594,9 +727,14 @@ export function mergeBrandProfiles(localRaw, importedRaw, options = {}) {
         if (rawId && rawName)
             retainIdName(rawId, rawName);
         const existing = rawName ? byName.get(rawName.toLowerCase()) : null;
+        const incomingUpdatedAt = timestamp(value.updatedAt, null);
+        if (existing && (!incomingUpdatedAt || incomingUpdatedAt <= existing.updatedAt)) {
+            skipped++;
+            continue;
+        }
         const profile = normalizeBrandProfile(item, {
             existing,
-            touch: Boolean(existing),
+            touch: false,
             nowIso: options.nowIso,
             makeId: options.makeId,
         });

package/packages/workspace/bulk-columns.mjs

@@ -0,0 +1,17 @@
+/** Optional result columns. Domain identity and actions are always available. */
+export const BULK_RESULT_COLUMNS = Object.freeze([
+    { id: 'registration', label: 'Registration' },
+    { id: 'risk', label: 'Risk' },
+    { id: 'website', label: 'Website' },
+    { id: 'registrar', label: 'Registrar' },
+    { id: 'mutation', label: 'Mutation' },
+    { id: 'review', label: 'Review' },
+    { id: 'case', label: 'Case' },
+]);
+export const DEFAULT_BULK_RESULT_COLUMNS = Object.freeze(BULK_RESULT_COLUMNS.map((column) => column.id));
+export function normalizeBulkResultColumns(value) {
+    // Missing choices preserve the full presentation used by public version 1.
+    if (!Array.isArray(value))
+        return [...DEFAULT_BULK_RESULT_COLUMNS];
+    return BULK_RESULT_COLUMNS.filter((column) => value.includes(column.id)).map((column) => column.id);
+}