Repository navigation
chore: packages/core(1272e81d 以降に足された分)の無駄なコメントを消す - #4401
Merged
Merged
Conversation
This was referenced Oct 10, 2026
This was referenced Oct 10, 2026
takecchi
added a commit
that referenced
this pull request
Oct 10, 2026
packages/core の残り(store.ts ほか4ファイル)の無駄なコメントを、承認済みの基準(R2)で削る。Refs #3710
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #3710
packages/coreで、2026-10-09 の到達点の報告の時点(1272e81d)より後に足されたコメントを整理した。コメントだけの変更で、コードは変えていない。基準と、その根拠
AGENTS.md の「情報の置き場所」に従う(R2 と同じ基準)。コードのコメントには Why not(単純にすると壊れる理由)だけを残す。How はコードで、What は試験の名前で、Why はコミットログで表す。Issue 番号・経緯・移設の記録は消す。lint を無効にするコメントや道具への指示は残す。
オーナーの承認(クローンの手元の記録から):
f6e6bad8「この基準で全体に広げてよい」範囲
git diff 1272e81d origin/main -- packages/coreで足された、行頭がコメントの行(157行)manager.ts・schema.ts・tools.ts・workspace-swap-hints.tsstore.tsは、新しく足されたeventReceiptsの doc だけを縮めた。申し送りにあった「もう一段縮める」は、この PR には含めていない。既存の契約の doc を読み直す量が大きいので、別の PR に分ける残したもの・消したもの(主なもの)
#4339・#4355・#4357・#4358・#4377・#4391・#4394・#2987・#3531・#4284・#4263)、経緯の段落(commitment-remove-for-conversation-contract.tsの「経緯(会話を論理削除しても、台帳のクローンの行と、台帳へ積んだときの日誌の写しから本文が読める(#4219 の漏れ・要判断) #4355)」)、試験の冒頭で試験の名前を言い直していた段落、公開の型の欄を言い直していた doc(EventReceiptの各欄など)REPLY_MESSAGE_SEPARATORを SSE に入れない理由selfの台帳の行も消す理由binaryで形だけの規則を見ない理由/* この検証では使わない */(空の関数の lint 避け)、eslint-disable-next-line、道具の挙動と安全の理由(manager-tools.tsの token が守りの本体であること、など)確かめたこと
removeComments: trueで回し、origin/mainの版と比べた。差を拾えることも確かめた: 同じ道具で1272e81dのclone.tsと比べるとDIFFになるgrep -F/readFileSyncの形で読んでいる箇所はscripts/conversation-window-single-source.test.tsだけだった。これはコードの形(journal.listの手組み)を見る歯で、コメントは見ていないnpx prettier --check(変えた24ファイル)通過、pnpm --filter @alteroid/core typecheckexit 0、vitest run src/clone-reply-segment-separator.test.ts→Tests 8 passed (8)確かめていないこと
clone-follow-up-reply-order.test.tsのqueuedの位置の理由、clone-reply-segment-separator.test.tsの切り詰めと Web の行の理由)は残したAlteroid-Issue-Done: none