Skip to content

feat(analysis): bind provenance-is-not-transition refusals to an analysis-run profile - #426

Draft
seonghobae wants to merge 1 commit into
mainfrom
feat/citation-edge-analysis-run-gap-004
Draft

feat(analysis): bind provenance-is-not-transition refusals to an analysis-run profile#426
seonghobae wants to merge 1 commit into
mainfrom
feat/citation-edge-analysis-run-gap-004

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Summary

GAP-004 leftover / ADR 0064. Bind existing citation_edge::refuse_provenance_as_transition to a cutoff-safe citation_edge_v1 analysis-run profile (tepp.citation_edge.v1).

Not GPU. Not MCMC. Not topic birth/split/merge. Not implemented-main.

Distinct from live slices

Does not duplicate #425 (interpretation-run CLI), #424 (project-history collection GET), #423 (lineage-criterion), #422 (corpus-background), #421 (modality-source), #420 (project-history CLI), #419 (prompt-source), #418 (style-source), #417 (export-retrieval CLI), #416 (copy-identity), #415 (method-effects), #414 (temporal-context CLI), #413 (case-deletion), #412 (composed fitted-K+lineage), #411 (export GET), #351 (Leiden), or Driver p.16 std-family micro-PRs.

Verification

  • cargo test -p analysis_engine
  • cargo clippy -p analysis_engine --all-targets -- -D warnings
  • python3 scripts/validate_documentation.py

Merge gate

Two independent current-head APPROVEs required. Author/bot COMMENTED is not independent APPROVE. Exact-head Checks on this SHA only. Predecessor Checks do not transfer. Do not self-approve. Do not merge without two independent approvals.


Devin Review

…ysis-run profile

GAP-004 leftover / ADR 0064. Bind existing citation_edge
refuse_provenance_as_transition to cutoff-safe citation_edge_v1.
edge_kind_recovery_rate stays library-side. Distinct from
lineage-criterion (#423), corpus-background (#422), modality-source
(#421), prompt-source (#419), style-source (#418), copy-identity
(#416), and method-effects (#415). Not GPU, not MCMC, and not topic
birth/split/merge.
@coderabbitai

coderabbitai Bot commented Aug 31, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 4 minutes.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 57a654b8-f3f7-43d5-acde-90b8069fe5bd

📥 Commits

Reviewing files that changed from the base of the PR and between 1bc02f5 and 4f58b8a.

⛔ Files ignored due to path filters (1)
  • Cargo.lock is excluded by !**/*.lock
📒 Files selected for processing (10)
  • CHANGELOG.md
  • DOCUMENTATION.md
  • crates/analysis_engine/Cargo.toml
  • crates/analysis_engine/src/citation_edge_artifact.rs
  • crates/analysis_engine/src/lib.rs
  • crates/analysis_engine/tests/citation_edge_execution_contract.rs
  • docs/TRACEABILITY.md
  • docs/adr/0064-citation-edge-analysis-run.md
  • docs/adr/README.md
  • docs/doctoring/citation-edge-analysis-run.md

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

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

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 1 potential issue.

Devin Review

Comment on lines +25 to +28
pub struct CitationEdgeDocument {
document_id: String,
kind: ProvenanceKind,
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 Future evidence enters historical censuses

CitationEdgeDocument carries no availability time, so execute_citation_edge_run cannot exclude documents unavailable at the requested cutoff. Historical censuses can include future evidence.

Prompt for agents
The citation-edge profile is publicly described as cutoff-safe, but CitationEdgeDocument contains only document_id and kind. Add validated availability metadata or another immutable eligibility proof to each input row, then make execute_citation_edge_run enforce availability at or before knowledge_cutoff before counting. Define whether late rows are excluded or rejected consistently with the analysis-engine cutoff contract, preserve duplicate checks for the admitted set as appropriate, and add integration tests proving evidence after the cutoff cannot enter the artifact.
Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant