Journal Source Research

Journal Source Research

Use this Journal sub-skill when a claim needs source context beyond local static rows: current ClinVar assertion, gene mechanism, inheritance, penetrance, guideline evidence, population tension, or literature/source conflict.

Goal

Review focused public targets and write reviewed findings back into the local evidence DB before using them in final interpretation. In capability discovery, these tools are part of journal because they create reusable investigation memory rather than a separate evidence category.

Works with Active Genome Index context and public-only context. If Active Genome Index context exists, use its evidence DB for user-specific context. With public-only context, use the shared evidence DB and frame the answer as public-target source review.

Convention: See skills/conventions/evidence-quality.md. Convention: See skills/_output-rules.md.

Contract

Contract:

• External research uses selected public targets only.
• API-backed sources are marked in tool dependencyContract.externalNetwork; local source files are marked in dependencyContract.localResources. If an API source is unavailable, the tool returns source_unavailable.
• Reviewed source findings are written back before final interpretation.
• Shared evidence is reusable public-target knowledge.
• Private evidence is reserved for user-specific combinations and context.
• Public-only answers describe public-target evidence.

Cross-Capability Synthesis

A scope-limited result from this capability is not a final user-facing answer when other Genomi capabilities can contribute orthogonal evidence to the same question. Returning "cannot answer" while applicable capabilities remain unexamined is a host-agent failure mode.

Tools

gnomad.fetch_population_frequency

Fetch reusable gnomAD public population frequency for one allele and write it into evidence storage.

Use when: gnomAD population frequency would change interpretation of an exact public allele or candidate variant.

Why necessary: gnomAD allele frequency changes interpretation; common and rare variants should not be discussed the same way.

Result semantics: Writes reusable aggregate public gnomAD frequency rows using selected public allele data.

research.build_target_packet

Build a target-centric evidence packet after the agent identifies the user's target.

Use when: The agent has selected a gene, drug, condition, topic, or allele and needs local/source context for synthesis.

Why necessary: A target packet keeps gene, drug, condition, topic, and allele context grouped before synthesis.

Result semantics: Returns context and source candidates for agent synthesis.

research.list_sources

List source catalogs relevant to a target type or one source ID.

Use when: choosing public source families for a target type or inspecting one source contract.

Why necessary: Source choice is part of the evidence contract; agents need to know which public adapters fit a target.

Result semantics: Returns source adapter and focused-review contracts for the host agent's selected public target.

research.query

Retrieve reviewed research for an exact target from local evidence storage.

Use when: the agent needs stored reviewed research for one exact target.

Why necessary: Exact-target research retrieval prevents agents from relying on vague memory of prior reviews.

research.record

Store reviewed source findings or tool-returned record_research_payloads in evidence storage with explicit shared/private scope.

Use when: Use after the agent has a reviewed source finding or tool-returned research payload that should be stored with scope.

Why necessary: Reviewed findings need durable, scoped storage so later answers can reuse source-backed evidence.

Result semantics: Writes reviewed public-target or private user-specific findings according to scope; private scope requires an active/private evidence DB.