ContractSpec
ContractSpecOpen spec system
Menu

Choose your entry point

ProductTemplatesPricingDocsChangelogGitHub
Start with OSSExplore Studio
Back to changelog index

3.7.20

Apr 19, 2026 · 2 packages · 3 unique changes · 1 release entry

libs

Release summaries

  • knowledge-indexed-payload-hardening

    Persist canonical knowledge payload text during indexing and align the retrieval/query docs with the corrected behavior.

    maintainer

    The knowledge ingestion/query path now persists fragment text into vector payloads, package tests cover the corrected behavior, and the knowledge doc surfaces were refreshed.

    integrator

    Consumers of `@contractspec/lib.knowledge` no longer need to copy fragment text into metadata for retrieval and RAG queries to work.

Migration guide

  • Remove custom knowledge payload text shims

    Stop copying fragment text into metadata solely to make downstream retrieval/query flows return readable content.

    When: When a consumer previously worked around missing indexed text by injecting `text` into fragment metadata before upsert.

    1. Upgrade to the patched `@contractspec/lib.knowledge` release.
    2. Remove any pre-upsert metadata workaround that duplicates `fragment.text` into `metadata.text`.

Upgrade steps

  • Verify indexed knowledge payloads expose canonical text

    manual

    Check that vector payloads now include `payload.text` and that retrieval/query flows surface readable snippets without custom metadata shims.

    Packages: @contractspec/lib.knowledge, @contractspec/lib.contracts-spec

    1. Re-run the ingestion flow that feeds your knowledge index.
    2. Inspect the stored vector payloads or downstream references for canonical `payload.text` content.

Unique release changes

  • - Check that vector payloads now include `payload.text` and that retrieval/query flows surface readable snippets without custom metadata shims.

    2 packages · 2 occurrences

  • - Persist canonical knowledge payload text during indexing and align the retrieval/query docs with the corrected behavior.

    2 packages · 2 occurrences

  • - Stop copying fragment text into metadata solely to make downstream retrieval/query flows return readable content.

    2 packages · 2 occurrences

Impacted packages

  • @contractspec/lib.contracts-spec

    Layer: libs · 3 changes

  • @contractspec/lib.knowledge

    Layer: libs · 3 changes