hlx6: Require target revision precondition for atomic version fidelity

Đang mở
  • Có gì không ổn?
#325 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
12/100
Loại issue
Lỗi
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Sôi nổi
Công nghệ
git, javascript
Lĩnh vực
backend, content

Hướng nghiên cứu

The payload names no source files, tests or entry points, so there is no obvious first file to open. The issue is a child of tracking issue #323 and depends on a separate delivery/ordering design (item 1) and on fixing project permissions. Done would mean specified revision fidelity, ordering, retry and duplicate handling, with tests for rapid and reordered edits. Confirm the design with the maintainers before starting.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Remaining follow-up after #336

#336 shipped best-effort VERSION verification in v1.16.1: capture the immutable DA snapshot, compare target content before creating a version, and verify the returned saved version afterwards. Missing snapshots, content mismatches and unexpected locations are explicit failures with recovery evidence. Unknown mutation outcomes are not blindly retried.

Unresolved limitation

The target VERSION endpoint does not accept a caller revision precondition. A concurrent target edit between the preflight GET and VERSION POST can therefore create an incorrect historical version. Postflight verification can detect the mismatch but cannot prevent or undo it. Raw content transformations can also cause conservative verification failures.

Remaining work

  • Coordinate target API support in adobe/helix-api-service for conditional version creation tied to the revision/content verified by the caller.
  • Wire the supported precondition into DA and explicitly handle precondition failures without blindly repeating an uncertain version creation.
  • Test an edit between preflight verification and VERSION creation: no incorrect historical snapshot should be created or reported as successful.
  • Define comparison semantics for transformed HTML and retain existing diagnostic/recovery evidence.

This is a forward-looking correctness follow-up, not a request to replay historical failures. The user reported manual cleanup completed on 2026-11-05; that does not resolve this concurrency limitation. Original investigation and scope decisions remain in #323 and its history.

Ngôn ngữ chính
JavaScript
Star
6
Fork
18
Merge trung bình
9 giờ 30 phút
Pull request đã merge (30 ngày)
3

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của adobe/da-admin

Tất cả issue của adobe/da-admin

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.