Files
bsodfather 54ce770682
CI / Rust Checks (pull_request) Failing after 13m41s
CI / UI Checks (pull_request) Skipped
CI / Frontend E2E (pull_request) Skipped
CI / Community Image Smoke (pull_request) Skipped
CI / Deploy (pull_request) Skipped
Community Release / release (push) Failing after 13m33s
feat(epic3): deliver the accepted Epic 3 scope through Story 3.17
Recovery delivery of the accumulated, TL-accepted Epic 3 work that had never been
committed to Git (stories 3.6-3.17, see the crank board). Story 3.18 is not accepted
yet and is deliberately excluded: its logging surface, its capability registration,
its oracle projections and its tests are not part of this tree.

Accepted scope
- 3.6 typed static Resource Drafts; 3.7 publication and exact binding of static
  Resource Versions; 3.8 MCP discovery/read and revocation of static Resources;
- 3.9 Resource import/export in API and UI plus TLS dependency maintenance;
  3.10 REST-backed Resource templates; 3.11 shared REST read runtime and the MCP
  revision/capability foundation;
- 3.12 parameterised Prompt Drafts with preview; 3.13 Prompt publication and exact
  version binding to Agents; 3.14 MCP prompts; 3.15 Prompt import/export;
- 3.16 composite Prompts with published Resources (dependency content scan plus
  dynamic read through the accepted 3.11 runtime, admin preview and MCP prompts/get);
- 3.17 bounded MCP completion suggestions from typed published schemas and the
  resources/list admission fix for bound template publications.

Accepted evidence being reused (unchanged code paths)
- 3.16 candidate: core 7, admin-api 22, registry 4, mcp-server 4, UI 6; one final
  `just verify` run 1651 passed / 0 failed / 2 ignored.
- 3.17 candidate: full run 1672 passed / 0 failed / 2 ignored, QA targeted reruns and
  a real MCP Inspector 2.12.0 client smoke.

Delivery engineering in this commit
- CI: one event per change (feature branches are gated by their pull request, push
  runs only on main), story events run the changed packages, the full workspace suite
  stays the feature/release gate; no cache/sharding without a measured runner check.
- Release: the packaged archives, checksums and SBOM are now uploaded to the Gitea
  release entry of the tag instead of dying with the runner workspace.

Not included on purpose: Story 3.18 work, build caches, runtime databases, local
credentials and scratch evidence.

Refs: crank kanban t_e39d7263; baseline 1b6db09bd1.
2026-10-25 09:08:22 +00:00

113 lines
5.1 KiB
Rust
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! ATDD (RED) для Story 3.6 «Сохранять typed static Resource Drafts» — таргет A (реальный HTTP).
//!
//! Источники: SPEC v4 `resource-drafts-story36-spec.md` (run85) §2 (mapping AC → имена тестов),
//! §3 (D-3…D-20), §7 (команды и oracles); QA test-design run77; `epics.md`:2465–2521;
//! `docs/acceptance-test-plan.md`:1014–1021.
//!
//! Состояние на момент написания: Admin API Resources, typed модель и таблицы V16 отсутствуют,
//! поэтому каждый RED ниже — поведенческое расхождение на реальном HTTP-ответе (404 от
//! fallback-роутера там, где контракт требует 201/400/409/413/422/428), а не ошибка компиляции
//! или setup. Работоспособность самого харнесса (сессия, CSRF, multipart) доказывает контроль
//! `story36_at02_control_existing_session_and_multipart_harness_are_functional` на существующем
//! роуте `imports/openapi/preview`.
//!
//! Файл разбит на подмодули (`tests/integration/resources/**`) из-за health-лимита 1000 строк
//! (TL run103 R-F): сценарий Draft-flow, матрица авторизации, ограничения содержимого и
//! обновления/приоритеты кодов (P2/R-E) лежат рядом и используют общие фикстуры ниже.
//!
//! Фильтр запуска: `cargo test -p admin-api --test integration story36_ -- --test-threads=1`.
//! Проверки, требующие production-интерфейсов (домен D, реестр P, адаптер V, счётчики put/read),
//! и захват logs/spans/metrics перечислены в отчёте стадии как BUILD-only GAP.
mod helpers;
mod telemetry;
mod archive;
mod authorization;
mod content_limits;
mod draft_flow;
mod draft_updates;
mod portability;
mod portability_extra;
mod publication;
mod revocation;
mod revocation_failures;
mod revocation_persistence;
mod revocation_preservation;
mod revocation_security;
mod template;
use helpers::{get_card, read_content, table_row_count};
use serde_json::{Value, json};
/// Метаданные обновления: только изменяемые поля + precondition (D-16).
fn update_metadata(
description: &str,
mime_type: &str,
sensitivity: &str,
expected_updated_at: &str,
) -> Value {
json!({
"description": description,
"mime_type": mime_type,
"sensitivity": sensitivity,
"expected_updated_at": expected_updated_at,
})
}
/// PUT с точным JSON метаданных: нужен там, где проверяется presence/тип ключа.
async fn put_draft_raw(
client: &reqwest::Client,
server: impl AsRef<str>,
resource_id: &str,
metadata: &Value,
content: &[u8],
mime: &str,
) -> (reqwest::StatusCode, String, Value) {
let server = server.as_ref();
helpers::read_response(
client
.put(format!("{server}/resources/{resource_id}"))
.multipart(helpers::draft_form(metadata, content, "draft.bin", mime))
.send()
.await
.expect("draft update request must complete"),
)
.await
}
/// Полное наблюдаемое состояние черновика после отказа (R-E).
///
/// Карточка сравнивается целиком, а не по отдельным полям: `uri`/`name`/`kind`/`status`/
/// `description`/MIME/size/digest/sensitivity/версия и `updated_at` входят в одно значение,
/// поэтому «отказ» доказывается неизменностью всего состояния, а не только статусом ответа.
/// Дополнительно наблюдаются точные bytes и итоги строк/owning-ссылок.
#[derive(Debug, PartialEq)]
struct DraftState {
card: Value,
bytes: Vec<u8>,
resources: i64,
versions: i64,
owning_refs: i64,
/// F7 (TL run109): четвёртое отношение V16 — `artifact_blobs`. Без него
/// «откат не добавил строк» остаётся неполным наблюдением четырёх отношений.
blobs: i64,
}
async fn observe_draft_state(
registry: &crank_registry::PostgresRegistry,
client: &reqwest::Client,
server: impl AsRef<str>,
resource_id: &str,
) -> DraftState {
let server = server.as_ref();
DraftState {
card: get_card(client, server, resource_id).await,
bytes: read_content(client, server, resource_id).await,
resources: table_row_count(registry.pool(), "resources").await,
versions: table_row_count(registry.pool(), "resource_versions").await,
owning_refs: table_row_count(registry.pool(), "artifact_sources").await,
blobs: table_row_count(registry.pool(), "artifact_blobs").await,
}
}