Fold span grounding into EventMention (#170 / GAP-007)

[seonghobae]

Product slice

Issue #170 / GAP-007 asked for one calibrated TDT + CHRONOS product workflow. On current protected main (c482ccea), event_core already has isolated mention/instance types plus first-story FAR/miss, link P/R, tracking P/R, WindowDiff/Pk, schema-slot P/R, and CHRONOS Brier scoring.

The missing #170 contract implemented here is span-grounded EventMention:

• EventMention is the only constructible mention type; there is no second unused mention type that can be built without a span
• each mention cites one exact SourceSpan, document identity, six-clock evidence, extractor/model version, and proposed/reviewed status
• surface text is the document substring at that span
• availability after knowledge cutoff fails closed; delayed reporting at or before cutoff is kept
• reviewed status is inspection, not instance promotion
• link, track, instance, registry, and first-story consumers construct grounded mentions
• exact-extent precision/recall recover known ACE extents (occupancy RMSE 0) and beat a whole-document extractor (RMSE 1)

This is not another identity gate and does not reimplement #226/#230/#231/#232/#239. Other-agent #235/#236/#237/#238/#240/#241 are left alone. psychometric_core and network_analysis are identical to origin/main. Workspace 0.2.0 versions are inherited from main. The EventMention CHANGELOG line stays under [Unreleased].

Remaining #170 work

Unified TDT/CHRONOS workflow composition, Allen/CHRONOS interval consistency, persistence, and versioned JSON/JSON-LD/GraphML exports.

Verification

• Rebased onto origin/main c482ccea
• cargo fmt -- --check is clean
• cargo check --workspace --tests compiles
• cargo test -p event_core passed
• event_core authored LCOV: mention.rs 131/131, span_mention.rs 170/170, error.rs 147/147

Draft until exact-head TEPP product CI is green (Format/lint/test/rustdoc, production line/branch coverage, live-postgres, Repository contracts and Python branch coverage, Validate planning).

Sources

Doddington et al. (2004) ACE extent mapping; Allan (2002) detection-vs-instance; Jensen & Snodgrass (1999) availability vs event time. Numeric provenance: docs/doctoring/span-grounded-mentions.md.

  

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}