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

13 KiB
Raw Blame History

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