Skip to content

Scope and Non-Goals

bijux-canon-index owns governed vector execution. Its scope begins when documents and vectors have stable identity and ends with ordered retrieval results whose request, artifact, backend, cost, provenance, and replay posture are recorded.

flowchart LR
    prepared["identified documents + vectors"]
    artifact["immutable execution artifact"]
    contract["intent + mode + budget"]
    backend["capability-selected execution"]
    result["results + provenance + replay"]
    interpretation["claim interpretation"]

    prepared --> artifact --> contract --> backend --> result --> interpretation

In scope

  • deterministic and non-deterministic execution contracts, intent, mode, budgets, metrics, result counts, and randomness policy;
  • immutable artifact materialization over ordered vectors, corpus identity, scoring version, construction parameters, and index configuration;
  • backend and plugin capability discovery, selection, registration, and conformance;
  • exact scoring, stable tie ordering, bounded ANN candidate execution, optional exact rescoring, witnesses, and approximation evidence;
  • execution identities, fingerprints, cost, run lifecycle, explanation, comparison, drift, and replay;
  • local ledger, file-backed run records, vector-store adapters, CLI module, HTTP v1, and strict schema boundaries.

Non-goals

Not owned here Owning boundary
Source parsing, normalization, chunk semantics, or original-text mapping bijux-canon-ingest
Embedding model fitness for a scientific or business domain model evaluation supplied by the caller
Whether retrieved evidence supports a claim bijux-canon-reason
Role order, convergence, or agent lifecycle bijux-canon-agent
End-to-end flow acceptance, tenant authority, or workflow replay bijux-canon-runtime
Authentication, transport security, distributed locks, or backend credential policy deploying system
Identical results across exact and approximate backends no such contract; divergence must remain explicit

Supported-surface boundary

The source tree includes adapters and plugin examples whose presence exceeds the v1 support contract. Remote backends, asynchronous orchestration, and streaming search are excluded from v1. The pgvector adapter is experimental and outside the v1 freeze. Capability discovery and conformance establish availability; imports alone do not.

Scope test

A change belongs here when it alters what vector execution was authorized, which backend could satisfy it, how results were ranked, or what evidence is required to explain and replay that operation. It does not belong here when it changes source representation or interprets a retrieved span as a supported conclusion.

An ExecutionArtifact proves an execution context, not corpus completeness, semantic relevance, or truth. See the capability map for implemented authority and known limitations for backend, quality, budget, persistence, and security boundaries.