Capability ID|Capability|Maturity|Source owner|Consumer|Focused test|Lifecycle test|User doc|Source-to-sink trace
CAP-PGVECTOR-DENSE-SQL|Dense vector SQL type, casts, operators, aggregates|stable|crates/context-pg/src/vector.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/vector_compatibility.rs#pgvector_dense_input_output_and_dims_cases|crates/context-pg/src/pg_tests/vector_variant_typmods.rs#pgvector_dense_typmods_reject_dimension_mismatches_with_sqlstate|docs/user_guide/api_reference.md|vector input and typmod enforcement feed operators aggregates and table search
CAP-EXACT-SEARCH|Exact vector search over arrays and registered tables|stable|crates/context-pg/src/vector.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/vector_search.rs#exact_search_returns_ranked_rows_with_stable_tie_breaks|tests/heavy/large_exact_search.sh#large_exact_oracle_match|docs/user_guide/vector_search.md|validated vectors and registered source metadata feed exact scoring and visible ranked rows
CAP-COLLECTIONS|Collections over PostgreSQL source tables|stable|crates/context-pg/src/catalog.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/collection_catalog.rs#create_collection_records_catalog_metadata|crates/context-pg/src/pg_tests/transaction_rollback.rs#rolled_back_create_collection_leaves_no_catalog_row|docs/user_guide/collections.md|collection catalog metadata resolves authoritative PostgreSQL source relations for consumers
CAP-POINT-MAPPINGS|Point upsert and delete mappings|stable|crates/context-pg/src/points.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/point_mapping.rs#upsert_points_assigns_stable_point_ids|crates/context-pg/src/pg_tests/transaction_rollback.rs#rolled_back_upsert_points_leaves_no_point_rows|docs/user_guide/collections.md|source keys map to logical point IDs and active mappings gate result hydration
CAP-FILTERS|Filter JSON over ordinary columns and JSONB paths|stable|crates/context-filter/src/lib.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/count.rs#count_uses_shared_filter_plan_for_ordinary_columns|tests/heavy/rls_acl_boundary.sh#expect_search_denied|docs/user_guide/filters.md|typed filter AST renders bound SQL predicates consumed by exact table queries
CAP-SCROLL-COUNT-FACET|Scroll, count, and facet|stable|crates/context-pg/src/table_search.rs|crates/context-pg/src/lib.rs|crates/context-pg/src/pg_tests/scroll.rs#scroll_returns_stable_point_id_pages|crates/context-pg/src/pg_tests/facet.rs#facet_counts_filtered_column_values_over_active_points|docs/user_guide/api_reference.md|shared visible point and filter plans feed bounded scroll count and facet projections
CAP-HYBRID|Dense plus lexical hybrid query|stable|crates/context-pg/src/hybrid_query.rs|crates/context-hybrid/src/lib.rs|crates/context-pg/src/pg_tests/hybrid_query.rs#hybrid_query_fuses_dense_and_lexical_branches|crates/context-pg/src/pg_tests/hybrid_query.rs#hybrid_query_excludes_deleted_points_from_both_branches|docs/user_guide/hybrid_retrieval.md|dense and registered lexical candidates feed deterministic reciprocal-rank fusion
CAP-OBSERVABILITY|Telemetry and operational status functions|stable|crates/context-pg/src/query_stats_async.rs|crates/context-pg/src/query_stats.rs|crates/context-pg/src/pg_tests/query_stats.rs#automatic_query_stats_capture_strategy_work_and_source_updates|tests/heavy/automatic_observability.sh#automatic_observability_worker_idled|docs/user_guide/operations.md|executor diagnostics and terminal PostgreSQL errors feed a bounded nonblocking queue whose database worker persists membership-filtered strategy work completion lifecycle and latency rollups without application data
CAP-MODEL-MIGRATIONS|Profile-backed embedding migrations|experimental|crates/context-pg/src/embedding_profiles.rs|crates/context-pg/src/embedding_migrations.rs|crates/context-pg/src/pg_tests/embedding_migrations.rs#embedding_migration_tracks_profile_backfill_progress|crates/context-pg/src/pg_tests/embedding_migrations.rs#embedding_migration_rejects_progress_past_total|docs/user_guide/multi_model.md|immutable source and target profiles constrain migration records and bounded progress updates
CAP-HNSW-AM|HNSW access method|experimental|crates/context-pg/src/hnsw_am.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/vector_variant_compatibility.rs#non_dense_hnsw_opclasses_match_exact_oracles_with_bounded_candidates|tests/heavy/crash_restart_hnsw.sh#bit_jaccard|docs/user_guide/indexes.md|metric-bound PostgreSQL AM callbacks persist dense half sparse and bit graph pages for L2 negative-inner-product cosine L1 Hamming or Jaccard; ordered scans consume bounded graph candidates and exact-recheck float8 Jaccard ordering
CAP-FILTERED-ANN|Filtered ANN serving|experimental|crates/context-pg/src/table_search.rs|crates/context-pg/src/hnsw_am.rs|crates/context-pg/src/pg_tests/hnsw_serving.rs#hnsw_mask_candidate_limit_guc_raises_the_masked_scan_budget_above_the_default|tests/heavy/filtered_ann_recall.sh#filtered_ann_public_tenant_recheck_passing|docs/user_guide/vector_search.md|the public JSON-filter search resolves an attached HNSW index, materializes bounded filter-matching heap-TID batches, traverses persisted graph pages with reusable masks, then rechecks visible point mappings, predicates, and exact scores against authoritative source rows
CAP-PGVECTOR-HALFVEC|SQL halfvec|experimental|crates/context-pg/src/vector_variants.rs|crates/context-pg/src/hnsw_am.rs|crates/context-pg/src/pg_tests/vector_variant_compatibility.rs#non_dense_hnsw_opclasses_match_exact_oracles_with_bounded_candidates|tests/heavy/crash_restart_hnsw.sh#half_cosine|docs/user_guide/pgvector_migration.md|half precision SQL values feed exact operators aggregates and explicit L2 inner-product cosine and L1 ANN opclasses
CAP-PGVECTOR-SPARSEVEC|SQL sparsevec|experimental|crates/context-pg/src/vector_variants.rs|crates/context-pg/src/hnsw_am.rs|crates/context-pg/src/pg_tests/vector_variant_compatibility.rs#non_dense_hnsw_opclasses_match_exact_oracles_with_bounded_candidates|tests/heavy/crash_restart_hnsw.sh#sparse_cosine|docs/user_guide/vector_search.md|canonical sparse values feed exact metrics named table search and explicit L2 inner-product cosine and L1 ANN opclasses
CAP-PGVECTOR-BIT|SQL bit vectors|experimental|crates/context-pg/src/vector_variants.rs|crates/context-pg/src/hnsw_am.rs|crates/context-pg/src/pg_tests/vector_variant_compatibility.rs#non_dense_hnsw_opclasses_match_exact_oracles_with_bounded_candidates|tests/heavy/crash_restart_hnsw.sh#bit_jaccard|docs/user_guide/pgvector_migration.md|checked bit values feed exact Hamming and Jaccard SQL plus explicit metric-bound ANN opclasses with exact Jaccard order-by recheck
CAP-QUANTIZATION|SQL quantization APIs|stable|crates/context-codec/src/spec.rs#pub struct CodecSpec|crates/context-pg/src/hnsw_am_graph_read.rs#PreparedQuantizedQuery|crates/context-pg/src/pg_tests/hnsw_am.rs#quantized_dense_metrics_preserve_native_orderby_types_and_exact_rerank|tests/heavy/quantized_hnsw_1m.sh#P5 quantized HNSW 1M gate passed|docs/user_guide/indexes.md|revision-bound scalar product or binary encodings feed page-native segmented packed shared or mapped HNSW candidate traversal and authoritative source-vector exact rerank
CAP-NAMED-DENSE|Named dense vector registration and search|stable|crates/context-pg/src/vector_catalog.rs|crates/context-pg/src/table_search/named.rs|crates/context-pg/src/pg_tests/vector_registration.rs#register_vector_records_checked_vector_column_metadata|crates/context-pg/src/pg_tests/client_examples.rs#named_dense_sparse_vector_example_uses_current_sql_surfaces|docs/user_guide/collections.md|registered name column dimension and metric resolve the selected dense search consumer
CAP-VECTOR-CONFIG|Per-vector dense index and quantization metadata|experimental|crates/context-pg/src/vector_catalog.rs|crates/context-pg/src/table_search/named.rs|crates/context-pg/src/pg_tests/vector_registration.rs#configure_vector_records_per_vector_options_and_status|crates/context-pg/src/pg_tests/vector_registration.rs#configure_vector_rejects_invalid_metadata_with_sqlstates|docs/user_guide/collections.md|validated per-vector metadata is stored; build-to-scan consumption remains post-V1 work under the public Quantized HNSW roadmap section
CAP-NAMED-SPARSE|Named sparse vectors per collection|experimental|crates/context-pg/src/vector_catalog.rs|crates/context-pg/src/retrieval/sparse.rs|crates/context-pg/src/pg_tests/vector_search.rs#named_sparse_ann_exactly_rechecks_bounded_hnsw_candidates|tests/heavy/named_sparse_ann_lifecycle.sh#named_sparse_ann_restart_complete|docs/user_guide/collections.md|registered sparse name column dimension metric and validated HNSW binding feed bounded ANN candidates filtered masks exact fallback and authoritative sparse rerank
CAP-LATE-INTERACTION|Multi-vector and late-interaction query|experimental|crates/context-pg/src/late_interaction_catalog.rs|crates/context-pg/src/hybrid_query/late_interaction_ann.rs|crates/context-pg/src/pg_tests/late_interaction_owned.rs#owned_late_interaction_source_dml_updates_tokens_in_the_same_transaction|tests/heavy/late_interaction_ann_serving.sh#late_interaction_owned_restart_recheck|docs/user_guide/vector_search.md|authoritative source vector arrays transactionally maintain collection-owned token rows and HNSW generations whose candidates are deduplicated source-rechecked and exact-MaxSim reranked
CAP-RECOMMEND|Recommendation search|stable|crates/context-pg/src/table_search/recommend.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/recommendation.rs#recommend_from_positive_point_ids_excludes_examples_and_ranks_exactly|crates/context-pg/src/pg_tests/recommendation.rs#recommend_rejects_deleted_point_examples|docs/user_guide/vector_search.md|visible example points or raw vectors form a query consumed by exact ranked search
CAP-DISCOVER|Discovery or explore search|stable|crates/context-pg/src/table_search/recommend.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/discovery.rs#discover_returns_farthest_active_points_from_context_centroid|crates/context-pg/src/pg_tests/discovery.rs#discover_rejects_deleted_context_points|docs/user_guide/vector_search.md|visible context points form a centroid consumed by deterministic diversity ranking
CAP-QUERY-CONSTRUCTORS|Query constructors and composite execution|stable|crates/context-query/src/executor.rs|crates/context-pg/src/query_builders.rs|crates/context-query/tests/composite_execution.rs#prefetch_reserves_candidate_work_per_leaf|crates/context-pg/src/pg_tests/query_builders.rs#execute_query_composes_all_named_postgres_sources|docs/user_guide/vector_search.md|validated plans execute through globally budgeted typed adapters for named and filtered dense, quantized mapped HNSW, named sparse, full-text, owned late-interaction, recommendation, discovery, and lookup sources with exact recheck before fusion
CAP-GROUPED-SEARCH|Grouped search|stable|crates/context-pg/src/table_search/grouped.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/grouped_search.rs#grouped_search_returns_nearest_rows_per_registered_column_group|crates/context-pg/src/pg_tests/grouped_search.rs#grouped_search_selects_named_dense_vector|docs/user_guide/collections.md|registered group fields consume visible exact results and enforce deterministic per-group limits
CAP-PAYLOAD-MUTATIONS|Payload mutation helpers|stable|crates/context-pg/src/payload_mutations.rs|crates/context-pg/src/payload_catalog.rs|crates/context-pg/src/pg_tests/payload_mutations.rs#set_payload_updates_jsonb_paths_and_typed_columns|crates/context-pg/src/pg_tests/payload_mutations.rs#set_payload_rejects_unknown_points_without_partial_updates|docs/user_guide/collections.md|registered payload metadata renders bounded authoritative source-table mutations
CAP-BULK-POINTS|Bulk point backfill APIs|stable|crates/context-pg/src/points.rs|crates/context-pg/src/catalog.rs|crates/context-pg/src/pg_tests/point_mapping.rs#backfill_points_scans_source_table_in_bounded_batches|crates/context-pg/src/pg_tests/transaction_rollback.rs#rolled_back_upsert_points_leaves_no_point_rows|docs/user_guide/collections.md|bounded source scans feed idempotent point mapping batches and progress diagnostics
CAP-IVFFLAT|IVFFlat|experimental|crates/context-index/src/ivf.rs|crates/context-pg/src/ivfflat_am.rs|crates/context-pg/src/pg_tests/ivfflat_am.rs#ivfflat_sq8_and_pq_use_compact_codes_with_exact_source_order|tests/heavy/ivfflat_lifecycle.sh#ivfflat_dump_restore_verified|docs/user_guide/indexes.md|deterministic trained centroids and page-native list extents feed bounded full-precision or shared-codec candidates while PostgreSQL visibility and exact source operators remain authoritative through DML vacuum reindex crash replay and replication
CAP-PGVECTOR-MIGRATION|pgvector migration and compatibility|stable|crates/context-pg/src/pgvector_compat.rs|crates/context-pg/src/pgvector_ownership/execution.rs|scripts/check-pgvector-name-facade.sh#pgvector name facade verification passed|scripts/check-pgvector-ownership-conversion.sh#pgvector ownership conversion verification passed|docs/user_guide/pgvector_coexist.md|the published compatibility inventory selects explicit main-owned bindings or conflict-safe facade names; certified pgvector HNSW and IVFFlat definitions rebuild through validated native indexes while exact checks rollback and finalization preserve PostgreSQL ownership boundaries
CAP-POSTGRES-NATIVE|PostgreSQL-native ACL, RLS, transactions, and backups|intentionally different|crates/context-pg/src/catalog_schema.rs|crates/context-pg/src/table_search.rs|crates/context-pg/src/pg_tests/transaction_rollback.rs#rolled_back_create_collection_leaves_no_catalog_row|tests/heavy/rls_acl_boundary.sh#expect_search_denied|docs/user_guide/security.md|PostgreSQL privileges visibility transactions WAL and backup remain authoritative end to end
CAP-REBUILDABLE-ARTIFACTS|Rebuildable acceleration artifacts|intentionally different|crates/context-storage/src/mmap_file.rs|crates/context-pg/src/table_search/candidate_recheck.rs|crates/context-pg/src/pg_tests/table_search_mmap_hnsw.rs#source_built_mmap_graph_is_navigable|tests/heavy/mapped_hnsw_lifecycle_cleanup.sh#mapped_hnsw_drop_marker_restart_preserved|docs/user_guide/storage.md|checksummed immutable graph generations are OS-mapped with bounded-copy decoding reader lifetime validation source rechecks and crash-safe replacement retirement and cleanup
CAP-LEXICAL-RETRIEVAL|PostgreSQL-native lexical retrieval|stable|crates/context-pg/src/lexical_catalog.rs|crates/context-pg/src/retrieval/lexical.rs|crates/context-pg/src/pg_tests/lexical_query.rs#plain_lexical_queries_match_the_direct_postgresql_oracle|crates/context-pg/src/pg_tests/lexical_index.rs#indexed_and_exact_lexical_paths_return_the_same_results|docs/user_guide/lexical_retrieval.md|registered tsvector sources feed bounded GIN or GiST candidate probes and authoritative source recheck
CAP-FUZZY-RETRIEVAL|Trigram fuzzy retrieval|experimental|crates/context-pg/src/lexical_catalog.rs|crates/context-pg/src/retrieval/lexical.rs|crates/context-pg/src/pg_tests/lexical_trigram.rs#fuzzy_modes_apply_their_native_similarity_function|crates/context-pg/src/pg_tests/lexical_trigram.rs#indexed_and_exact_fuzzy_paths_agree|docs/user_guide/lexical_retrieval.md|registered pg_trgm sources feed bounded GIN or GiST candidate probes with scoped thresholds and authoritative source recheck
CAP-ADAPTIVE-DIMENSION|Adaptive-dimension Matryoshka retrieval|experimental|crates/context-core/src/matryoshka.rs|crates/context-pg/src/retrieval/mod.rs|crates/context-pg/src/pg_tests/adaptive_dimension.rs#adaptive_every_declared_prefix_returns_the_full_vector_exact_answer|tests/heavy/adaptive_prefix_recall.sh#adaptive_prefix_recall|docs/user_guide/adaptive_dimension.md|certified prefixes drive bounded candidate generation while full authoritative dimensions drive final ranking
CAP-MULTI-MODEL|Version-safe multi-model retrieval|stable|crates/context-query/src/multi_profile.rs|crates/context-pg/src/multi_model.rs|crates/context-query/tests/multi_profile.rs#raw_scores_never_change_cross_profile_fusion_order|tests/heavy/multi_model_rls_acl.sh#multi_model_rls_acl|docs/user_guide/multi_model.md|immutable version-bound profile branches feed bounded rank-only weighted RRF after equivalent PostgreSQL filters ACL RLS and authoritative source rechecks; the frozen equal-weight held-out contract passes at one million rows on PostgreSQL 17 and 18
CAP-SEMANTIC-RERANK|Provider-neutral semantic reranking|experimental|crates/context-query/src/rerank_envelope.rs|crates/context-pg/src/semantic_rerank.rs|crates/context-pg/src/pg_tests/semantic_rerank/preparation.rs#semantic_rerank_prepare_and_finalize_recheck_authority_and_order|tests/heavy/semantic_rerank_contract.sh#semantic_rerank_contract|docs/user_guide/semantic_reranking.md|bounded authorized text envelopes feed an external digest-verified worker whose untrusted scores are accepted only for released occurrences before current source hash version filter ACL and RLS recheck; local PG17 and PG18 certification passes while hosted Darwin and Linux arm64 and x86_64 worker evidence remains pending
CAP-AUTOMATIC-CHUNKING|Automatic document chunking|experimental|crates/context-build/src/token_chunking.rs|crates/context-pg/src/document_chunking.rs|crates/context-pg/src/pg_tests/document_chunking.rs#automatic_chunking_publishes_only_complete_source_linked_generations|tests/heavy/document_chunking_worker.sh#automatic_chunking_throughput|docs/user_guide/automatic_chunking.md|bounded plain text Markdown and HTML worker output is canonically revalidated against current authoritative source rows before complete source-linked chunk and fake-embedding generations become current through fenced atomic publication; both frozen PG17 and PG18 1M source-cardinality lanes miss the 1000 chunks-per-second Stable floor, so promotion remains a measured no-go
CAP-EXACT-FIRST-READINESS|Exact-first readiness|experimental|crates/context-core/src/exact_first.rs|crates/context-pg/src/exact_first.rs|crates/context-pg/src/pg_tests/exact_first.rs#exact_first_registration_is_idempotent_and_immediately_exact|tests/heavy/exact_first_readiness.sh#exact_first_decision|docs/user_guide/exact_first_readiness.md|complete invoker-authoritative dense exact search is available at registration commit while explicit immutable plans and fenced top-level concurrent index builds can change only optimization readiness; both frozen PG17 and PG18 10M lanes preserve exactness and recall but miss latency and temp ceilings, so Stable promotion is a measured no-go
CAP-LAZY-HNSW-CURSOR|Lazy HNSW cursor|internal|crates/context-index/src/hnsw_hierarchy/cursor.rs|crates/context-pg/src/hnsw_am_graph_scan.rs|crates/context-index/tests/hnsw_lazy_cursor.rs#arbitrary_pause_resume_batches_match_the_eager_wrapper|tests/heavy/lazy_hnsw_cursor.sh#lazy_hnsw_cursor_certification|docs/user_guide/lazy_hnsw_cursor.md|query-owned cursor controls feed a statement-local pure HNSW frontier whose eager compatibility drain is consumed unchanged by page mapped segmented delta and exact PostgreSQL recheck paths
CAP-VIRTUAL-BEAM|Virtual beam engine|internal|crates/context-query/src/beam/engine.rs|crates/context-query/src/beam/output.rs|crates/context-query/src/beam/tests.rs#graph_off_seed_selection_matches_the_exhaustive_oracle|tests/heavy/virtual_beam.sh#virtual_beam_certification|docs/user_guide/virtual_beam.md|authorized vector seed occurrences feed bounded provider batches and deterministic arena dominance cycle pruning exact-score ordering and evidence-path reconstruction while topology expansion remains rejected
