Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン
#1,447 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
78/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
go

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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.
主要言語
Go
スター
115
フォーク
14
平均マージ
9時間 38分
マージ済み PR(30日)
730

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Agent-Field/CodeAF のほかの issue

Agent-Field/CodeAF の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。