US Brand Evidence Chronology Builder

Build a deterministic US brand evidence chronology from 1-30 closed, normalized evidence rows and an explicit asOf UTC timestamp. The Actor is a local, offline-friendly machine workflow: it sorts submitted facts, marks same-time groups, reports future-dated IDs and basic timestamp warnings, and emits exact counts with stable SHA-256 digests.

What it does

Each row contains only evidenceId, eventType, effectiveAt, observedAt, sourceUrl, and fact. effectiveAt may be null when the submitted row has no effective timestamp. The chronology is sorted by effectiveAt, then observedAt, then evidenceId; rows without effectiveAt sort last. Equal (effectiveAt, observedAt) pairs receive a stable tg-* same-time group ID.

The report marks a row future-dated when its effective or observed timestamp is after asOf. Warnings cover missing effective time, effective time after observation, effective time after asOf, and observation after asOf. The Actor copies submitted facts and URLs. It does not resolve a brand, infer identity, verify a source, infer truth, score evidence, or interpret the fact.

Exact task

The public Task uses fixed timestamps and two rows, so it never reads the current clock. Its input is the same runnable payload shown in the Actor input example, and its deterministic report is available through the run Dataset and OUTPUT record.

Runtime and delivery

The runtime uses Apify SDK 3.7.2, pay-per-event pricing, one confirmed apify-actor-start, and at most one result-found event. It confirms the buyer cap before work, performs exactly one pushData(report, "result-found"), verifies the result counter, and then writes the successful report to KVS key OUTPUT. Validation, budget, push, charge, or output uncertainty writes only the small documented error object when that KVS write succeeds and fails the run; it never claims success.

The result is bounded below 32 KiB. There is no network request, proxy, API key, BYOK, child run, Dataset input, state, replay, queue, cron, or current-clock read. No icon is included in this local builder.

Pricing tiers

Tier	Actor start	Result	Discount
FREE	$0.005000	$0.010000	0%
BRONZE	$0.004750	$0.009500	5%
SILVER	$0.004500	$0.009000	10%
GOLD	$0.004250	$0.008500	15%
PLATINUM	$0.004100	$0.008200	18%
DIAMOND	$0.004000	$0.008000	20%

Public references

These five public references were checked during the local build and describe the runtime, storage, schema, and timestamp conventions:

1. Apify JavaScript SDK
2. Apify Actors
3. Apify Dataset storage
4. JSON Schema specification
5. RFC 3339

Contract files

The three Apify schemas are in .actor/: input, Dataset, and output. Normative input and report schemas, limits, and pricing are in contract/. SPEC.md is the implementation contract for this local builder.

Related Actors

Use these public Actors to collect, normalize, compare, and act on evidence before or after building a chronology:

Actor	What it adds
US Brand Federal Award Snapshot	Collects bounded official federal-award evidence for a brand workflow.
US Brand Offer Evidence Normalizer	Normalizes buyer-supplied offer observations into stable evidence rows.
US Brand Evidence Snapshot Diff	Compares two normalized evidence snapshots after chronology preparation.
US Brand Signal Metrics Aggregator	Summarizes normalized signal rows into deterministic portfolio metrics.
US Brand Action Queue	Converts reviewed evidence into a bounded, ordered follow-up queue.

These are separate public products. This Actor does not call them or create hidden child-run charges.