Package com.tnsai.intelligence.rag.temporal

Class TemporalMetadata

java.lang.Object

com.tnsai.intelligence.rag.temporal.TemporalMetadata

public final class TemporalMetadata
extends Object

Canonical input and provenance metadata keys for temporal retrieval.

Loaders provide TIMESTAMP as an ISO-8601 instant. The Role binding assigns SOURCE; the remaining keys describe how temporal scoring affected each returned result.

Since:

0.13.0

Field Summary

Fields

Modifier and Type	Field	Description
static final String	AGE_SECONDS	Whole seconds between the document timestamp and retrieval time.
static final String	CONTENT_SCORE	Relevance score produced by the child strategy before time decay.
static final String	DATED	Whether the document supplied a canonical timestamp.
static final String	DECAY	Exponential time-decay value between zero and one.
static final String	FUTURE_SKEW_SECONDS	Whole seconds by which a tolerated timestamp was in the future.
static final String	SCORE_FACTOR	Bounded multiplier applied to the content score.
static final String	SOURCE	Source group used by annotation-level source fencing.
static final String	STATUS	Temporal classification: DATED, UNDATED, or FUTURE_CLAMPED.
static final String	STATUS_DATED	Status for a timestamp at or before the retrieval clock.
static final String	STATUS_FUTURE_CLAMPED	Status for a small tolerated future-clock skew.
static final String	STATUS_UNDATED	Status for a document without timestamp metadata.
static final String	TIMESTAMP	Canonical document timestamp, parsed with Instant.parse.

Method Summary

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

TIMESTAMP

public static final String TIMESTAMP

Canonical document timestamp, parsed with Instant.parse.

See Also:

• Constant Field Values

SOURCE

public static final String SOURCE

Source group used by annotation-level source fencing.

See Also:

• Constant Field Values

CONTENT_SCORE

public static final String CONTENT_SCORE

Relevance score produced by the child strategy before time decay.

See Also:

• Constant Field Values

DECAY

public static final String DECAY

Exponential time-decay value between zero and one.

See Also:

• Constant Field Values

SCORE_FACTOR

public static final String SCORE_FACTOR

Bounded multiplier applied to the content score.

See Also:

• Constant Field Values

AGE_SECONDS

public static final String AGE_SECONDS

Whole seconds between the document timestamp and retrieval time.

See Also:

• Constant Field Values

DATED

public static final String DATED

Whether the document supplied a canonical timestamp.

See Also:

• Constant Field Values

STATUS

public static final String STATUS

Temporal classification: DATED, UNDATED, or FUTURE_CLAMPED.

See Also:

• Constant Field Values

FUTURE_SKEW_SECONDS

public static final String FUTURE_SKEW_SECONDS

Whole seconds by which a tolerated timestamp was in the future.

See Also:

• Constant Field Values

STATUS_DATED

public static final String STATUS_DATED

Status for a timestamp at or before the retrieval clock.

See Also:

• Constant Field Values

STATUS_UNDATED

public static final String STATUS_UNDATED

Status for a document without timestamp metadata.

See Also:

• Constant Field Values

STATUS_FUTURE_CLAMPED

public static final String STATUS_FUTURE_CLAMPED

Status for a small tolerated future-clock skew.

See Also:

• Constant Field Values