13 KiB
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.mdsummary: 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.mdsummary: Изолировать test-only traversal syscall counter и вернуть прход default-parallelcargo test -p crank-artifacts --test reconciliation. evidence: Process-globalTRAVERSAL_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.mdsummary: Изолировать process-global fault seams и traversal counters, чтобы reconciliation suite стабильно проходил с default parallelism. evidence: Blind review воспроизвёл шесть падений при обычном parallelcargo 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.mdsummary: Сделать 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.mdsummary: Убрать календарную зависимость из 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.mdsummary: Учитывать 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.mdsummary: Сделать 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.mdsummary: Запускать 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.mdsummary: Сделать аварийный 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.mdsummary: Добавить 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.mdsummary: Закрыть 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.mdsummary: Сохранять 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.mdsummary: Укрепить cleanup import jobs против повреждённых legacypreview_payload. evidence:jsonb_array_elementsвызывается без проверки array-типа, а tolerant cleanup принимает любой boundedsource_id, поэтому corrupt payload может сорвать sweep либо отсоединить посторонний source того же workspace. -
source_spec:
_bmad-output/implementation-artifacts/spec-2-9-http-contract.mdsummary: Проверять 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.mdsummary: Определить сохранение либо явный 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