Class PaperKnowledgeCard

quantmind/knowledge/paper.py:34–52

Distilled summary card of a `Paper`. The store layer keys this off ``paper_id`` so the card and its tree can be retrieved together. The card is the right shape for tagging, filtering, and dashboard surfaces; deep questions go to the tree.

    CHUNK_SET = "paper_chunk_set"
    GLOBAL_SUMMARY = "paper_summary"
    STRUCTURE_TREE = "paper_structure_tree"


def _stable_hash(value: object) -> str:
    """Return a deterministic SHA-256 hash for one JSON-compatible value."""
    payload = json.dumps(
        value,
        ensure_ascii=False,
        separators=(",", ":"),
        sort_keys=True,
    )
    return hashlib.sha256(payload.encode("utf-8")).hexdigest()


def _text_hash(value: str) -> str:
    return hashlib.sha256(value.encode("utf-8")).hexdigest()


def _paper_source_id(content_hash: str) -> UUID:
    return uuid5(NAMESPACE_URL, f"quantmind:paper-source:{content_hash}")