# SQL protocol knowledge base for 1C configuration storage

This directory is the durable, evidence-first record for the 1C SQL adapter.
It complements [the general format specification](../1c-sql-format-spec.md).
Do not put all observations into one chronological note: add a fact to the
document for its layer, object type, codec, operation, or experiment.

## Non-negotiable runtime rule

The adapter works **only through SQL**. It may decode and encode only what was
observed in the target database and proven by round-trip checks. It must never
invent a metadata object, physical path, BSL fragment, form element, join,
codec, or cryptographic value. Unknown or ambiguous work returns an explicit
unsupported/protocol-incomplete result.

The Configurator remains a human-operated consumer of the saved-state overlay.
The adapter does not start it, automate it, or claim to change its in-memory
state.

## Map

- [Rules and evidence discipline](rules/evidence-and-safety.md)
- [Agent contract: do not invent](rules/agent-contract.md)
- [Configuration SQL layers](layers/configuration-storage.md)
- [Extension saved-state overlay](extensions/saved-state-overlay.md)
- [Common form and BSL module handling](objects/common-form-module.md)
- [Object component graph and child selectors](objects/component-graph.md)
- [Report object-module carrier](objects/report-object-module.md)
- [Payload envelope codec](codecs/payload-envelope.md)
- [`__configinfo` map and service atom](codecs/configinfo.md)
- [Configurator refresh behaviour](operations/configurator-cache.md)
- [Reproducible `upo_test/test2` experiment](experiments/upo-test-test2.md)
- [Known dead ends and prohibited shortcuts](research/known-dead-ends.md)
- [Template for the next experiment](templates/experiment-record.md)
- [Current adapter component map](implementation/adapter-components.md)

## Maintenance rule

After every material protocol investigation, record all three outcomes:

1. proven direction and the exact evidence;
2. failed direction and why it failed;
3. remaining unknowns and the next safe experiment.

Keep raw payloads and credentials out of git. Reference private learning
artifacts by opaque ID or SHA-1 only.
