107 lines
13 KiB
Markdown
107 lines
13 KiB
Markdown
# 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
|