Files
crank/_bmad-output/implementation-artifacts/deferred-work.md
T

107 lines
13 KiB
Markdown
Raw 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.
# Deferred Work
## Deferred from: verification of 2-7-openapi-normalizedir (2026-08-29)
- `just rust-code-health` остаётся красным только из-за двух файлов baseline Story 2.1, не изменённых Story 2.7: `crates/crank-artifacts/src/housekeeping.rs` (1119 строк) и `crates/crank-artifacts/tests/artifact_store.rs` (1103 строки). Все production/test-файлы Story 2.7 меньше лимита 1000 строк; требуется отдельный механический split artifact-store модулей без смешивания с NormalizedIR diff.
## Deferred from: code review of 1-1-capability-inventory.md (2026-08-08)
- RESOLVED 2026-08-08 — `event-listener` обновлён с 5.4.1 до 5.4.2 в рамках review remediation после уточнения владельца; RUSTSEC-2026-0221 устранён, полный `just verify` прошёл.
## Deferred from: code review of 1-4-versioned-migration-authority.md (2026-08-09)
- Изменение `Cargo.lock` для `event-listener` не относится к Story 1.4: это ранее одобренная и уже закрытая security remediation Story 1.1. В evidence Story 1.4 нужно явно атрибутировать этот baseline, а не повторно менять lockfile.
## Deferred from: code review of 1-10-lifecycle-auth-profiles-machine-keys.md (2026-08-21)
- Auth Profiles have no lifecycle status for retired/disabled profiles (`crates/crank-community-mcp/src/app.rs:1007`). Deferred because current Story 1.10 can enforce Secret/key terminal state, while AuthProfile status/tombstone semantics require a broader domain/storage lifecycle change and migration.
## Deferred from: code review of 1-10-lifecycle-auth-profiles-machine-keys.md (2026-08-24)
- Secret deletion currently hard-deletes encrypted versions and the Admin API has no explicit disable/tombstone operation (`crates/crank-registry/src/postgres/secret.rs:315`). Durable Secret tombstones, disable/restore transitions and retention policy require a broader schema lifecycle change.
- Credential lifecycle mutations commit before the best-effort audit sink is called (`apps/admin-api/src/service.rs:317`). Atomic audit delivery requires a durable transactional outbox and cross-cutting persistence/worker design.
- source_spec: `_bmad-output/implementation-artifacts/spec-2-3-artifact-filesystem-reconciliation.md`
summary: Story 2.4 реализует PostgreSQL claim/recheck/finalize protocol, crash recovery coordinator и bounded Admin scheduling.
evidence: DB authority и background orchestration являются отдельным independently reviewable goal, зависящим от готовых filesystem capabilities 2.1b2a.
## Resolved at completion of Story 2.1 (2026-08-29)
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-3-artifact-filesystem-reconciliation.md`
summary: Изолировать test-only traversal syscall counter и вернуть прход default-parallel `cargo test -p crank-artifacts --test reconciliation`.
evidence: Process-global `TRAVERSAL_CALLS` сбрасывается и читается exact-budget тестом одновременно с другими reconciliation tests; production scanner не затронут, а serial repository verification проходит.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-4-artifact-claim-recovery.md`
summary: Изолировать process-global fault seams и traversal counters, чтобы reconciliation suite стабильно проходил с default parallelism.
evidence: Blind review воспроизвёл шесть падений при обычном parallel `cargo test`; согласованная serial verification проходит, production scanner и coordinator этим test-only race не затронуты.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-5-openapi-upload-preview.md`
summary: Сделать replay ответа OpenAPI apply идентичным первому ответу, когда selected_operation_keys содержит отсутствующие operation keys.
evidence: Локальные skipped entries формируются в AdminService и не входят в сохранённый ImportJobApplyResult; завершённая job при повторе поэтому возвращает только сохранённые created/conflict результаты. Поведение существовало до verified-source изменения и требует отдельного уточнения create/apply response semantics.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-5-openapi-upload-preview.md`
summary: Убрать календарную зависимость из reconciliation_claims_are_fenced_global_and_allow_verified_revival.
evidence: Тест использует detached_at 2026-08-27T10:02:00Z и ожидает попадание в 24-часовой grace относительно реального database clock; 2026-08-28 он стабильно возвращает другой outcome. Изолированный повтор воспроизводит падение, а OpenAPI/Story 2.5 пути этот тест не затрагивает.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-6-openapi-upload-ui-evidence.md`
summary: Учитывать quality weights и порядок предпочтения в Accept-Language для OpenAPI upload diagnostics.
evidence: `openapi_upload_locale` выбирает RU при любом диапазоне `ru`, включая `ru;q=0` после предпочтительного `en`, поэтому может вернуть язык, который клиент явно запретил.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-6-openapi-upload-ui-evidence.md`
summary: Сделать cleanup expired OpenAPI jobs и dangling sources исчерпывающим при объёме больше одного batch.
evidence: `delete_expired_import_jobs` обрабатывает не более `IMPORT_JOB_CLEANUP_BATCH` записей за вызов и не повторяет выборку, поэтому startup оставляет хвост при backlog больше 128.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-6-openapi-upload-ui-evidence.md`
summary: Запускать lifecycle cleanup OpenAPI artifacts периодически на тихом долгоживущем Admin API.
evidence: cleanup вызывается на startup и при preview/apply; без нового import traffic истёкшие jobs и sources могут оставаться дольше retention window.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-6-openapi-upload-ui-evidence.md`
summary: Сделать аварийный detach OpenAPI source надёжным при cancellation и остановке runtime.
evidence: `SourceDetachGuard::drop` запускает fire-and-forget task и игнорирует результат; shutdown или transient DB failure могут оставить active source до последующего reconciliation.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-6-openapi-upload-ui-evidence.md`
summary: Добавить process-level startup recovery test для dangling OpenAPI source.
evidence: текущие integration tests вызывают registry cleanup напрямую; удаление startup-вызова из `main.rs` не будет обнаружено.
- RESOLVED 2026-08-29 — source_spec: `_bmad-output/implementation-artifacts/spec-2-6-openapi-upload-ui-evidence.md`
summary: Закрыть race между чтением Pending import job и detach source конкурентным успешным apply.
evidence: второй запрос может прочитать Pending до завершения первого, а затем увидеть уже detached source и вернуть source-unavailable вместо replay canonical result.
- source_spec: `_bmad-output/implementation-artifacts/spec-2-6-openapi-upload-ui-evidence.md`
summary: Сохранять unknown-operation skips в canonical OpenAPI apply result для идентичного replay.
evidence: unknown selected keys добавляются только в локальный response, но не в `ImportJobApplyResult`, поэтому completed fast path их не воспроизводит.
- source_spec: `_bmad-output/implementation-artifacts/spec-ci-community-scope-marker.md`
summary: Укрепить cleanup import jobs против повреждённых legacy `preview_payload`.
evidence: `jsonb_array_elements` вызывается без проверки array-типа, а tolerant cleanup принимает любой bounded `source_id`, поэтому corrupt payload может сорвать sweep либо отсоединить посторонний source того же workspace.
- source_spec: `_bmad-output/implementation-artifacts/spec-2-9-http-contract.md`
summary: Проверять undeclared path placeholders в некорректных OpenAPI specifications (review B8, pre-existing).
evidence: Проверка parameter→placeholder не проверяет обратное направление; baseline adapter оставляет placeholder без объявленного параметра. Нужна отдельная malformed-spec regression и согласованная точная диагностика.
- source_spec: `_bmad-output/implementation-artifacts/spec-2-9-http-contract.md`
summary: Определить сохранение либо явный blocker для object/array schema defaults в normalized IR (review E8, pre-existing).
evidence: normalized_literal и до Story 2.9 представлял только scalar defaults; compound defaults пропадают. Нужны совместимый IR contract и roundtrip fixtures, не изменение replay старых jobs.
### DW-1: Проверить credential URL query, если поддерживаемый downstream consumer использует semicolon separator.
origin: spec-deferred fd22e0cb4a86
location: crates/crank-import/src/rest/metadata_findings.rs::query_has_secret_parameter
source_spec: `spec-2-10-security-schemes-secrets.md`
reason: BH-F7, maybe-false: scanner использует form_urlencoded с &; конкретный поддерживаемый consumer, который интерпретирует ; как границу credential parameter, не показан. Нужны consumer/config и wire regression для установления фактического поведения. Это новая unverified гипотеза, не статус существующей записи ledger.
status: open
### DW-2: Проверить credential URL query для поддерживаемого proxy/server с повторным percent decoding имени.
origin: spec-deferred 69f3c5c359cf
location: crates/crank-import/src/rest/metadata_findings.rs::query_has_secret_parameter
source_spec: `spec-2-10-security-schemes-secrets.md`
reason: BH-F8, maybe-false: текущая проверка совпадает с однократным form decoding; reachable proxy/server со вторым decoding не продемонстрирован. Нужны конкретный consumer/config и wire regression. Это новая unverified гипотеза, не статус существующей записи ledger.
status: open
### DW-3: Проверить AC-11 Reference preview p95 после deploy Story 2.12 на crank.itexp.me.
origin: user-deferred 2026-10-03
location: apps/ui/tests/e2e/openapi-preview-reference.spec.js; docs/openapi-import.md
source_spec: `spec-2-12-preview-partial-mode.md`
reason: Пользователь разрешил закрыть Story 2.12 и перенести оставшийся внешний benchmark в deferred work. Функциональные проверки, bounded DOM до 2000 candidates, API/registry suites, Playwright 40 scenarios и полный just verify PASS. Фактический end-to-end Reference p95 ≤2 s не измерен; local mocked handler samples его не подтверждают. Существующий deployment crank.itexp.me отвечает, но проверенный опубликованный UI ещё не содержит partial mode/revalidation этой story; покупать новый стенд не требуется.
acceptance: После штатного merge/deploy подтвердить deployed revision/image digest, проверить фактические Reference environment параметры и отдельное размещение browser/load-generator, получить авторизованную test session и выполнить готовый harness с 20 real preview samples. Сохранить sanitized environment, raw samples и p95; при соответствии Reference условиям и p95 ≤2000 ms приложить evidence и закрыть DW-3, иначе исправить производительность либо явно зафиксировать отличие окружения без ложного PASS.
status: open