Repository navigation
chore: packages/core(store.ts と、#4401 で外した4ファイル)の無駄なコメントを消す - #4412
Merged
Merged
Conversation
Closed
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の残りを整理した。コメントだけの変更で、コードは変えていない。中身は2つある。manager.ts・schema.ts・tools.ts・workspace-swap-hints.ts)のうち、1272e81dより後に足されたコメント(約20行)。chore: packages/core(1272e81d 以降に足された分)の無駄なコメントを消す #4401 の時点では、open の fix: pids が尽きて git を起こせなかった回の未 push 観測が、前に取れていた枝名を台帳から消さないようにする #4398 がこれらに触っていたので外していた。fix: pids が尽きて git を起こせなかった回の未 push 観測が、前に取れていた枝名を台帳から消さないようにする #4398 は 2026-10-10T02:42Z にマージ済みであるstore.tsの「もう一段縮める」基準と、その根拠
#4401〜#4405 と同じ。AGENTS.md の「情報の置き場所」に従い、コードのコメントには Why not(単純にすると壊れる理由)だけを残す。How はコードで、What は試験の名前で、Why はコミットログで表す。Issue 番号・経緯は消す。
オーナーの承認(クローンの手元の記録から):
f6e6bad8「この基準で全体に広げてよい」store.ts
store.ts は storage-fs / storage-pg / インメモリの3実装が実装する契約の正本なので、契約の条件は What に見えても残す側に倒した。 一段で削ったのは −31 行で、控えめである。
WriteMemoryOptions・JournalPage・PendingInboxEvent・Storesなど12か所)#662)describeUnreadable*5つの「0件のときは何も出さない」の重ね書きensureTrailingNewlineを通す理由: 複製すると実装ごとに読み戻しがずれるためreadTailがread()を使わない理由: 起動のたびの拾い直しが全文をヒープへ載せると OOM になるifMatch・「省略可能にしないこと」の各項instanceofで見分ける系の doc[sdk-verbatim …]の印EnvProfileEntryのscopeの説明。.claude/skills/env-profile/SKILL.mdが根拠として指しているたたき台は作業者が作り、私が差分を全行読んで、上の2か所を戻した。その手直しは2つ目のコミットに入っている(コミットの件名は3ファイルの名前しか挙げていない)。
4ファイル
#1266・#2987・#4355・#4394)externalOutputLimitsの上の型の言い直しwhereの欄の言い直しJob.externalOutputsを写すだけ、の docrescueNotPushedDetailの dockeptPerJobの上(古いほうから落としてよい理由)nullで上書きしない理由(manager.ts)schema.ts)tools.ts。変更なし)確かめたこと
removeComments: trueで回し、origin/mainの版と比べた)npx prettier --check(変えた4ファイル)→ exit 0pnpm --filter @alteroid/core typecheck→ exit 0確かめていないこと
Alteroid-Issue-Done: none