# Treat the Knowledge Corpus Like a Software Release

Package and evaluate knowledge collections with source identity, reproducible questions, recovery checks and explicit limits on NFT and settlement claims.

Canonical HTML: <https://damagebdd.com/articles/versioned_knowledge_releases.html>



<a id="the-latest-index-is-not-enough-to-reproduce-an-answer"></a>

## “The latest index” is not enough to reproduce an answer

Imagine two assistants answering the same operational question from
apparently identical collections. One contains last week's runbook. The
other contains a revised procedure and an old duplicate. Comparing their
models will not explain the difference until the team identifies the data
each assistant actually used.

For an AI platform team or specialist curator, the useful offer is a
versioned knowledge release: a selected corpus, a recorded transformation,
an identifiable artifact and an evaluation set. ECAI's indexing and artifact
work can be assessed against that delivery problem.

This is a nearer-term proposition than an automated marketplace for
intelligence. The customer can inspect an index release before deciding
whether any token or contract representation adds value.


<a id="separate-selection-processing-and-publication"></a>

## Separate selection, processing and publication

The [Wikimedia guide](ecai_wikipedia_indexing.md) describes selecting a public
reference collection, while the [indexing guide](ecai_indexing_workflows.md)
describes chunking, disk-oriented paths and managed work. The
[artifact guide](ecai_index_nfts.md) describes manifests, file digests,
source/pipeline identity and optional publication.

Those stages solve different problems. A reliable queue does not establish
that the selected sources are useful. A manifest does not establish that a
consumer can load the artifact. A token does not establish that either has
been tested.

For a first release, write down why each source belongs in the collection.
Retain attribution and applicable reuse terms. An index or NFT does not grant
new rights to the underlying material. Keep sensitive collections on the
separate [private path](ecai_private_knowledge.md) rather than assuming a
public artifact becomes confidential because an assistant reads it.


<a id="freeze-the-questions-before-comparing-retrieval"></a>

## Freeze the questions before comparing retrieval

Build a small question set with expected records, known ambiguities and
questions the corpus cannot answer. Record the source versions and the
retrieval configuration alongside the expected outcomes.

Compare precision, missing-record behaviour, startup time, query latency and
storage cost on the same machine and corpus. These are proposed measurements,
not existing benchmark results. Include an ordinary search baseline so a
specialised implementation must demonstrate its value rather than receive
credit for its terminology.

When releasing a successor, keep the old question set and add cases that
exercise the new material. Record whether an answer changed because the
source changed, the processing changed or the query path changed. That is
more useful than one composite score with no explanation.


<a id="make-clean-consumer-recovery-part-of-delivery"></a>

## Make clean-consumer recovery part of delivery

Have a second environment retrieve only the declared release files and
attempt to load the index. Compare the files with the manifest and run the
fixed questions. Then interrupt indexing and exercise the documented recovery
procedure before accepting the producer workflow.

The readable [search-server source](https://raw.githubusercontent.com/DamageBDD/DamageBDD/develop/apps/ecai/src/ecai_search_server.erl)
selects a snapshot or configured context file and retains its existing
context if loading fails. That makes failure visibility and expected-context
checks important: a process still running does not establish that it loaded
the intended release.

The dated [search-evidence guide](ecai_search_evidence.md) records integrity
and filtering limitations. The [7 October
review](integration_status_2026_10_07.md) did not close them. Recheck those findings on the release being
evaluated; do not silently turn an old warning into either a new guarantee
or a claim about code that has not been fetched.


<a id="keep-artifact-identity-separate-from-payment"></a>

## Keep artifact identity separate from payment

The dated NFT guide distinguishes completed artifact metadata from an
indexing-job token. It records a dry-run mint helper and a separate chunk-job
payment placeholder. A local “paid” state is not a settlement receipt.

A credible pilot can stop at successful delivery of a reusable collection.
A later paid-work integration needs confirmed transaction handling,
idempotency, acceptance policy and recovery from partial failure. Do not
present those as solved because the artifact itself has a digest.


<a id="implementation-and-evaluation-boundary"></a>

## Implementation and evaluation boundary

The opportunity is evaluated through the linked implementation guides and
selected readable source. No corpus build, clean-consumer recovery, mint or
payment was run for this article. The latest repository tree was not
available for a complete recheck.

Begin with one [public fixture collection](ecai_wikipedia_indexing.md) or one
approved internal corpus. Make its identity and usefulness reproducible before
making it larger or attaching an economy to it.

