← к элементу · к схеме
UEPR ADB
| Продукт | ai_docs_broker |
|---|
| Контур | dev |
|---|
| Тип документа | UEPR |
|---|
| Координаты чтения | {"op": "get_document", "env": "dev", "product": "ai_docs_broker", "doc_type": "UEPR", "latest": true} |
|---|
| Версия | 0.9.0a33-dev12 |
|---|
| SHA-256 | 45d60515529a4a4ad0bf0f72604fe09edce152ae73ed06e9b1aa85311d02046f
сверено
|
|---|
| Размер | 23384 байт |
|---|
Полный текст
# ai_docs_broker: UEPR 0.9.0a33-dev12
## §CHANGELOG 0.9.0a33-dev12 относительно 0.9.0a33-dev11
Полная редакция по поручению Оператора о закрытии сессии. Составлена 2026-09-21T18:22:32.925041+00:00. Актуализированы результаты документного цикла, незавершённые задачи и границы доказательств; прежняя полная редакция сохранена побайтово в историческом приложении. Эта редакция не является delta или новым отдельным планом.
## Область и границы действующей редакции
Работа: документное закрытие ИИ-Арх ai_docs_broker / heavy02 / dev по поручению Оператора. Сессия 920f3491-21a3-40db-bcee-1f081dc4d0ad. Новая полная редакция не означает новый deploy, приёмку продукта, выполнение Live Scenario или внедрение одобренного кода. Архив ADB не читался и не изменялся. Исторические байты предшественника сохранены ниже целиком; NON-ACTIVE HISTORY не является маршрутом current, очередью или сегодняшним вердиктом.
Постоянные ссылки на документы имеют ровно пять полей: op=get_document, env, product, doc_type, latest=true. Actor добавляется при вызове. ID, версии, SHA и размер ниже являются датированным evidence, не заменой JSON-ссылки. Гайд Пользователя любого продукта находится только в prod, независимо от среды его runtime. Для нескольких логических серий одного типа сначала list_documents и проверка серии/узла/диапазона; неоднозначный latest запрещено автоматически считать нужным документом.
Разрешены эта актуализация и read-only сверка. Не разрешены новым поручением: deployment, изменение кода или схемы, массовая миграция, удаление файлов/продуктов/записей, перезапуск исполнителей, закрытие чужих окон, снятие заморозки Техдолга. Все 20 существующих незакрытых TD-ID и их статусы сохраняются. Новые документные наблюдения не являются переоценкой замороженных статусов.
## Фактическое состояние и предел доказательств
Read-only API при закрытии: health сообщает 0.9.0a33, DB reachable, migration040/behind=0, started_at=2026-09-21T08:42:41.258Z. Для dev/ai_docs_broker/heavy02 реестр показывает один active deploy123, wheel150, version0.9.0a33, SHA-256 f667bce4f4e0f90b4a50b70b464e761b59831573b8e1f7b7734d055ba490b8f2, release a82e637c-b2ff-4e37-ad6d-2dde5c529e04; registered_at=2026-09-21T08:41:37.544Z. Prod active deploy для этой пары не найден. Это реестровое состояние, а не повторное доказательство узловых PID/путей/байтов установленного wheel.
Прежнее описание «accepted a26 / installed wheel132 / LS72 RED / validation NOT_RUN» относится к более раннему этапу и не используется как current. При этом наличие нового active deploy не доказывает автоматически соблюдение всех гейтов ЖЦ. В этой сессии новый runtime-кандидат не создавался и продукт заново не принимался.
Live Scenario runs73/74 для wheel150 зарегистрированы green, passed103/failed0/total135, но comments содержат 32 BLOCKED. Validation run85 зарегистрирован green, passed103/failed0/total103, validator=coder-adba33. Требуются сопоставление знаменателей, карточек и доказательство независимости требуемой ai_validation. Старый отчёт не переписывается под ожидаемые цифры; статус реестра не скрывается и не выдаётся за новую приёмку. Связь: TD-2026-09-19-04.
ROO в исследовании guard подтвердил installed0.9.0a33, но отметил более старые source/dist. До реализации надо доказать соответствие исходников wheel150, а не устанавливать найденное дерево. Source revision из прежнего UEPR сохранён как историческое утверждение, не новое подтверждение provenance.
## Текущие поля UEPR
Значения service/PID/paths/shared_libs ниже сохранены из прежнего узлового наблюдения; повторно на узле не проверялись. Историческая аттестация вынесена отдельно, текущая документная коррекция не наследует её GREEN.
```yaml
uepr_version: '4'
product: ai_docs_broker
role: dev-node product broker (Ring-0 agent)
uepr:
product_version: 0.9.0a33
product_version_scope: physically_installed_and_active_dev_deploy
product_version_provenance: runtime.package_version observed via public get_document/health; active deploy 123
execution:
env: dev
node: heavy02
topology:
mode: dev_only
dev_node: heavy02
execution_endpoint:
listens_on: []
ontology_ring: ring0
transport: h2.ai_docs_broker.request
user_access:
allowed_envs:
- dev
user_guide:
required: true
canonical_env: prod
lookup: '{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Пользователя","latest":true}'
document_version: '0.44'
document_sha256: 55cc1ee7508a70166123469ed5f3a549e0e50507ac9bec6554d7da1d7bc9a520
documents:
- product: ai_docs_broker
env: prod
doc_type: Гайд Пользователя
lookup: '{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Пользователя","latest":true}'
version: '0.44'
doc_id: 1088
files_id: ee82c264-7100-4aed-85d6-c77fe7fc1ede
sha256: 55cc1ee7508a70166123469ed5f3a549e0e50507ac9bec6554d7da1d7bc9a520
size: 207135
parent_doc_id: 1073
- product: adb_meta
env: dev
doc_type: Стандарт
version: '0.1'
doc_id: 1006
files_id: 51089f15-3681-4525-a098-55eb70930819
sha256: 119177fef3f5b3ae565e9593439950939f9d1784f648b2e50ddb8b6af1eacea2
size: 7987
parent_doc_id: null
evidence_status: historical_reference_not_current_route
documentation:
ontology:
lookup: '{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Онтология","latest":true}'
document_version: v0.25
document_sha256: d235d0796c00a5a51d716431c7dbf310908e73cc1fdd2e712819091d35f76d97
uepr_audit:
lookup: '{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Аудит UEPR","latest":true}'
assessment_scope: current_documentary_revision; full_independent_runtime_audit_not_run
source:
ref: a33r2 (ADB-A33-LIFECYCLE-CLEAR)
revision: a83e15b6d236c113e347a77121b348a0cdefad22bba6a2c2107e856daf878e5a
wheel:
filename: ai_docs_broker-0.9.0a33-py3-none-any.whl
version: 0.9.0a33
sha256: f667bce4f4e0f90b4a50b70b464e761b59831573b8e1f7b7734d055ba490b8f2
size: 302495
artifact_ref: owui_file_id:fc9db9ff-e0c5-4198-a0f7-03df5284f583
adb_wheel_id: 150
deploy:
deploy_id: '123'
wheel_id: '150'
status: active
registered_at: '2026-09-21T08:41:37.544Z'
release_id: a82e637c-b2ff-4e37-ad6d-2dde5c529e04
runtime:
interpreter: C:\H2\ai_Docs_broker\.venv\Scripts\python.exe
interpreter_version: 3.14.3
venv_root: C:\H2\ai_Docs_broker\.venv
working_dir: C:\H2\ai_Docs_broker
package_version: 0.9.0a33
wheel_sha256: f667bce4f4e0f90b4a50b70b464e761b59831573b8e1f7b7734d055ba490b8f2
shared_libs:
- name: h2_shared
version: 0.56.80
sha256: 709762bdd328a124109a63f45c796bd4e2e960b77daef1dc95413e653dd000fa
- name: pymysql
version: 1.2.0
sha256: ccd6a6c1edebfd58d3952fb3d1baa5a4d4f872518f8d22de2a17c6f10ddf659f
- name: cryptography
version: 50.0.1
sha256: 9ad86e52b4dde0544e0a9518ad322a863cfab3a4fd763019ad5ee7675a0c9b6a
- name: nats-py
version: 2.16.0
sha256: not_captured
- name: mariadb
version: 1.1.14
sha256: not_captured
service:
name: h2-ai_docs_broker
entrypoint: -m ai_docs_broker
application: C:\H2\ai_Docs_broker\.venv\Scripts\python.exe
app_directory: C:\H2\ai_Docs_broker
autostart: SERVICE_AUTO_START
object_name: LocalSystem
pid: 64564
parent_pid: 1584
last_restart_at: '2026-09-21T08:42:41.258Z'
listens_on: []
log_paths:
stdout: C:\H2\ai_Docs_broker\logs\svc_stdout.log
stderr: C:\H2\ai_Docs_broker\logs\svc_stderr.log
paths:
source_dir: C:\H2\ai_Docs_broker
tests_dir: C:\H2\ai_Docs_broker\tests
wheel_local: C:\H2\ai_Docs_broker\dist
installed_package: C:\H2\ai_Docs_broker\.venv\Lib\site-packages\ai_docs_broker
migrations_dir: C:\H2\ai_Docs_broker\src\ai_docs_broker\migrations
dependencies:
- name: nats
kind: message-bus
subjects:
- h2.ai_docs_broker.request
reachable: true
- name: mariadb
kind: relational
head_migration: 040_caller_events_session_type_enum
behind: 0
secrets:
required:
- AGENT_ROOT
- MARIADB_AI_DOCS_BROKER_URL
- MARIADB_AUDIT_URL
- ADB_KEK
- ADB_BOOTSTRAP_SECRET
- ADB_HMAC_REQUIRE_SECRETS
live_validation:
required: true
scenario_document_version: v0.19
scenario_document_sha256: fb156e9ed60a3645c5810acec5247551c0dad437501b645460f8c7af4105fae5
run_id: '73'
result: green
lookup: '{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Live Scenario","latest":true}'
evidence_scope: historical run73; registry green does not resolve total135 versus passed103 and32BLOCKED
historical_attestation:
state: green
verified_at: '2026-09-21T09:02:30.000Z'
verifier: AI-coder ADB-A33-LIFECYCLE-CLEAR-20260921-4386ecf4 (release a82e637c)
attestation:
state: not_verifiable
scope: documentary_closure_not_runtime_acceptance
reason: LS coverage and independent validation unresolved
observed_at: '2026-09-21T18:22:32.931754+00:00'
declared_divergence:
- kind: source_dist_provenance_unresolved
observed_by: ROO concept research
state: not_reverified_at_closure
```
## Проверенные документные зависимости
- `{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Пользователя","latest":true}`: version `0.44`, doc 1088, SHA-256 `55cc1ee7508a70166123469ed5f3a549e0e50507ac9bec6554d7da1d7bc9a520`, size 207135 bytes; observed_at 2026-09-21T18:03:49.278017+00:00.
- `{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Онтология","latest":true}`: version `v0.25`, doc 1087, SHA-256 `d235d0796c00a5a51d716431c7dbf310908e73cc1fdd2e712819091d35f76d97`, size 93334 bytes; observed_at 2026-09-21T18:05:36.195033+00:00.
- `{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Аудита","latest":true}`: version `v0.2.5`, doc 1046, SHA-256 `8303165585b8e7b36473ef554ab8c658713ac24e63565708f24c2bc5a83e29d5`, size 26602 bytes; observed_at 2026-09-21T18:04:08.263131+00:00.
- `{"op":"get_document","env":"prod","product":"adb_meta","doc_type":"Гайд UEPR","latest":true}`: version `v0.15`, doc 1039, SHA-256 `276b2468fa5a53559872c5f6a3ab226c940d03a0b254e81483fa3cada02ce789`, size 70224 bytes; observed_at 2026-09-21T18:04:11.159133+00:00.
- `{"op":"get_document","env":"prod","product":"adb_meta","doc_type":"Гайд ЖЦ ИТ-продукта H2","latest":true}`: version `v0.8`, doc 1084, SHA-256 `06662711199f4bccc3db0e73200fbc0b649018a5abfc7e3fa3e6d96eae8a2509`, size 24838 bytes; observed_at 2026-09-21T18:04:16.408954+00:00.
---
## NON-ACTIVE HISTORY: полные неизменённые байты предшественника
Предшественник doc1065, version0.9.0a33-dev11, SHA-256 7eed348b9609e57f04eb78c4caebb373fabeba7052b8c6f44ebccef625f093e0, size10079. Следующий текст сохраняется как датированное свидетельство и прежние подробные критерии. Старые адреса/статусы здесь не являются текущими указаниями. Никакой архивный API для этого приложения не использовался.
# UEPR ai_docs_broker (a33, dev/heavy02) — dev11 (адреса пользовательского гайда prod/latest)
## §CHANGELOG 0.9.0a33-dev11 относительно 0.9.0a33-dev10 (2026-09-21)
Полная новая редакция по решению Оператора: исправлены действующие ссылки и правила размещения Гайда Пользователя. Для любого продукта этот тип хранится только в prod, независимо от dev-only/dev-and-prod runtime. Постоянная ссылка содержит ровно op, env, product, doc_type и latest:true, без версии, ID и Files URL:
```json
{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Пользователя","latest":true}
```
Поле actor добавляется вызывающей стороной по контракту ADB; это не часть постоянных координат документа. После lookup проверяются возвращённые метаданные и двоичный SHA-256.
Коррекция относится только к документации: runtime, wheel, deploy, сценарии и прежние результаты проверок не менялись и заново не аттестованы. Датированные снимки, ID/версии/SHA в доказательствах и исторические приложения не являются текущими ссылками; они сохраняются как свидетельства своего времени. Прежние требования искать или публиковать пользовательский гайд в dev больше не действуют. Описания старых guard a26/a30 не доказывают сегодняшнюю реализацию; наличие нормативного правила не объявляется успешным runtime-тестом.
- task_id: GUIDE-FACADE-FIX-20260921-723d44ea
- generated_utc: 2026-09-21T11:37:00.000Z
- predecessor: doc 960 (version 0.9.0a33-dev9, sha256 87557593…9af4c3) — this revision
updates ONLY `§documents` with the new Guide/Standard Files IDs; §wheel/§deploy/§runtime
are unchanged (wheel not changed in this cycle).
- Accepted active dev deploy: deploy_id=123 wheel_id=150 version=0.9.0a33
sha256=f667bce4f4e0f90b4a50b70b464e761b59831573b8e1f7b7734d055ba490b8f2
release_id=a82e637c-b2ff-4e37-ad6d-2dde5c529e04.
- prod active deploy for this pair = 0 → topology `dev_only`. Nothing changed in prod.
```yaml
uepr_version: "4"
product: ai_docs_broker
role: "dev-node product broker (Ring-0 agent)"
uepr:
product_version: "0.9.0a33"
product_version_scope: "physically_installed_and_active_dev_deploy"
product_version_provenance: "runtime.package_version observed via public get_document/health; active deploy 123"
execution:
env: "dev"
node: "heavy02"
topology:
mode: "dev_only"
dev_node: "heavy02"
execution_endpoint:
listens_on: [] # broker uses NATS request/reply only; no TCP listen socket
ontology_ring: "ring0"
transport: "h2.ai_docs_broker.request"
user_access:
allowed_envs: ["dev"]
user_guide:
required: true
canonical_env: "prod"
lookup: '{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Пользователя","latest":true}'
document_version: "0.42"
document_sha256: "934deba6bd5c6b6a00e8baa03c966aee60b047ea39d9aa471ec45f6b5d3d2ec6"
documents: # dev10: only this section changed (parent doc 960)
- product: ai_docs_broker
env: prod
doc_type: "Гайд Пользователя"
lookup: '{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Пользователя","latest":true}'
version: "0.42"
doc_id: 1040
files_id: "c97382a1-ba0f-4c53-b748-51bcf2a2295d"
sha256: "934deba6bd5c6b6a00e8baa03c966aee60b047ea39d9aa471ec45f6b5d3d2ec6"
size: 197107
parent_doc_id: 1034
- product: adb_meta
env: dev
doc_type: "Стандарт"
version: "0.1"
doc_id: 1006
files_id: "51089f15-3681-4525-a098-55eb70930819"
sha256: "119177fef3f5b3ae565e9593439950939f9d1784f648b2e50ddb8b6af1eacea2"
size: 7987
parent_doc_id: null
documentation:
ontology:
lookup: '{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Онтология","latest":true}'
document_version: "v0.23"
document_sha256: "eae36caf1b9fad021bd3ecab0aeda651734ce3a73f7af796c9385eff28346c74"
uepr_audit:
lookup: '{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Аудит UEPR","latest":true}'
document_version: "0.9.0a33-dev9"
source:
ref: "a33r2 (ADB-A33-LIFECYCLE-CLEAR)"
revision: "a83e15b6d236c113e347a77121b348a0cdefad22bba6a2c2107e856daf878e5a"
wheel:
filename: "ai_docs_broker-0.9.0a33-py3-none-any.whl"
version: "0.9.0a33"
sha256: "f667bce4f4e0f90b4a50b70b464e761b59831573b8e1f7b7734d055ba490b8f2"
size: 302495
artifact_ref: "owui_file_id:fc9db9ff-e0c5-4198-a0f7-03df5284f583"
adb_wheel_id: 150
deploy:
deploy_id: "123"
wheel_id: "150"
status: "active"
registered_at: "2026-09-21T08:41:37.544Z"
release_id: "a82e637c-b2ff-4e37-ad6d-2dde5c529e04"
runtime:
interpreter: "C:\\H2\\ai_Docs_broker\\.venv\\Scripts\\python.exe"
interpreter_version: "3.14.3"
venv_root: "C:\\H2\\ai_Docs_broker\\.venv"
working_dir: "C:\\H2\\ai_Docs_broker"
package_version: "0.9.0a33"
wheel_sha256: "f667bce4f4e0f90b4a50b70b464e761b59831573b8e1f7b7734d055ba490b8f2"
shared_libs:
- {name: h2_shared, version: "0.56.80", sha256: "709762bdd328a124109a63f45c796bd4e2e960b77daef1dc95413e653dd000fa"}
- {name: pymysql, version: "1.2.0", sha256: "ccd6a6c1edebfd58d3952fb3d1baa5a4d4f872518f8d22de2a17c6f10ddf659f"}
- {name: cryptography, version: "50.0.1", sha256: "9ad86e52b4dde0544e0a9518ad322a863cfab3a4fd763019ad5ee7675a0c9b6a"}
- {name: nats-py, version: "2.16.0", sha256: "not_captured"}
- {name: mariadb, version: "1.1.14", sha256: "not_captured"}
service:
name: "h2-ai_docs_broker"
entrypoint: "-m ai_docs_broker"
application: "C:\\H2\\ai_Docs_broker\\.venv\\Scripts\\python.exe"
app_directory: "C:\\H2\\ai_Docs_broker"
autostart: "SERVICE_AUTO_START"
object_name: "LocalSystem"
pid: 64564
parent_pid: 1584
last_restart_at: "2026-09-21T08:42:41.258Z"
listens_on: []
log_paths:
stdout: "C:\\H2\\ai_Docs_broker\\logs\\svc_stdout.log"
stderr: "C:\\H2\\ai_Docs_broker\\logs\\svc_stderr.log"
paths:
source_dir: "C:\\H2\\ai_Docs_broker"
tests_dir: "C:\\H2\\ai_Docs_broker\\tests"
wheel_local: "C:\\H2\\ai_Docs_broker\\dist"
installed_package: "C:\\H2\\ai_Docs_broker\\.venv\\Lib\\site-packages\\ai_docs_broker"
migrations_dir: "C:\\H2\\ai_Docs_broker\\src\\ai_docs_broker\\migrations"
dependencies:
- name: nats
kind: "message-bus"
subjects: ["h2.ai_docs_broker.request"]
reachable: true
- name: mariadb
kind: "relational"
head_migration: "040_caller_events_session_type_enum"
behind: 0
secrets:
required: # NAMES ONLY — values never read/logged
- AGENT_ROOT
- MARIADB_AI_DOCS_BROKER_URL
- MARIADB_AUDIT_URL
- ADB_KEK
- ADB_BOOTSTRAP_SECRET
- ADB_HMAC_REQUIRE_SECRETS
live_validation:
required: true
scenario_document_version: "v0.19"
scenario_document_sha256: "fb156e9ed60a3645c5810acec5247551c0dad437501b645460f8c7af4105fae5"
run_id: "73"
result: "green"
lookup: '{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Live Scenario","latest":true}'
attestation:
state: "green"
verified_at: "2026-09-21T09:02:30.000Z"
verifier: "AI-coder ADB-A33-LIFECYCLE-CLEAR-20260921-4386ecf4 (release a82e637c)"
```
## Machine fields filled vs dev8
Dev8 left `runtime.interpreter`, `runtime.venv_root`, `runtime.working_dir`,
`runtime.shared_libs[]`, `service.*`, `paths.*`, `dependencies[]`,
`execution_endpoint.listens_on`, `role`, `secrets.required[]` as `null` with the
reason "dev-UEPR machine fields absent". This dev9 fills them from observed node
facts (no inference; every path checked `Test-Path=true`).
## Candidate vs accepted (explicit)
- accepted active deploy: deploy_id=123 wheel_id=150 version=0.9.0a33
sha256=f667bce4f4e0f90b4a50b70b464e761b59831573b8e1f7b7734d055ba490b8f2
release_id=a82e637c-b2ff-4e37-ad6d-2dde5c529e04 (registered 2026-09-21T08:41:37Z).
- superseded: deploy_id=96 wheel_id=109 version=0.9.0a26
sha256=2763747f218e947d042bf0f77f708a3c885d7050bb9ffbc9dc792c3d86c3a803.
- runtime package == active deploy wheel version (0.9.0a33). LS-117 divergence cleared.
## References (exact 64-hex coordinates; no shorthand)
- Текущий пользовательский гайд: `{"op":"get_document","env":"prod","product":"ai_docs_broker","doc_type":"Гайд Пользователя","latest":true}`. Evidence 2026-09-21: version=0.42, id=1040, sha256=934deba6bd5c6b6a00e8baa03c966aee60b047ea39d9aa471ec45f6b5d3d2ec6, size=197107; это метаданные проверенного ответа, не постоянная ссылка.
- dev adb_meta facade standard: id=1006 version=0.1 sha256=119177fef3f5b3ae565e9593439950939f9d1784f648b2e50ddb8b6af1eacea2 size=7987
- dev ontology: id=588 version=v0.23 sha256=eae36caf1b9fad021bd3ecab0aeda651734ce3a73f7af796c9385eff28346c74 size=89601
- prod Audit guide: id=888 version=0.2.4 sha256=02e37c658499fd89d5822502faaecfbd7b73d5d64aedbf6337465da3aae6790b size=24361
- prod UEPR norm: id=955 version=0.13 sha256=7cdc8bc0191babc6464edc3ea8fb561582822fa23607e110f747aba1e37562ae
- lifecycle guide: id=830 version=v0.6 sha256=bbf1f52be49288ddfa7ff33d0e38a852c408bca6b04a322d721e43409a99226a