Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

The headless guide teaches a chained do command the default belt refuses

Đang mở
#1,447 0 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ó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
78/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
go
Lĩnh vực
cli, documentation, testing-qa

Hướng nghiên cứu

Start at docs/HEADLESS.md:561 and compare its chained do command with cmd/codeaf/do.go:3430 and runRoadRefusesStore. Run the deterministic unset-belt and node-belt commands in a throwaway repository, then verify the complete documented chain produces persisted state with exit code 0. Done means the guide states which belt each command demonstrates, a docs command check catches the invalid unset-belt combination, and the change entry records the default-belt invalidation.

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

Mô tả

area:headless bug sev:serious

Found on santos/dev2 at 008363c98 (#1410). It reaches dev when #1410 merges.

What happened

The section for a sequence of tasks that remember one another tells a reader to run codeaf do "$task" --db "$RUN/store/graph.db" --dir "$RUN/repo" …. On the default belt, --db exits 1 with --db names a store only the older engine works in; … Drop --db, or set CODEAF_TASK_BELT=node to run this on the older engine. No change entry's invalidates tells readers that the documented default changed.

Replication

Deterministic (no model). Create a throwaway repository with R=$(mktemp -d) && git -C "$R" init -q; run codeaf do noop --dir "$R" --db "$R/graph.db" --json with CODEAF_TASK_BELT unset. It exits 1 at flag validation. Set CODEAF_TASK_BELT=node and the flag passes validation. Use OPENROUTER_API_KEY=<any non-empty value> only if continuing to a model call.

Where

docs/HEADLESS.md:561 supplies the command; cmd/codeaf/do.go:3430, runRoadRefusesStore, supplies the refusal at 008363c98.

The fix

Make the guide explicitly select the older engine for durable --db chains, or provide an equivalent supported chain for the default belt. State which behavior each command demonstrates.

Acceptance

  • e2e: a reader can copy the guide's complete chain into a fresh repository and receive the documented persisted state, with exit code 0.
  • Unit: a docs command check catches an unset-belt invocation combining do and --db.
  • Update the manual's headless account and add the default-belt change to a change entry's invalidates.
Ngôn ngữ chính
Go
Star
115
Fork
14
Merge trung bình
9 giờ 38 phút
Pull request đã merge (30 ngày)
730

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

Chúng tôi chưa kiểm tra các tệp thiết lập môi trường của dự án này. Hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 Agent-Field/CodeAF

Tất cả issue của Agent-Field/CodeAF

Issue tương tự

Thêm issue về Go

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.