Documentation and header comments that no longer match the code

Đang mở
#2,725 5 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 5 ngày

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

Đánh giá

Độ khó
3/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
55/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
markdown, shell, typescript
Lĩnh vực
documentation

Hướng nghiên cứu

This is a batch of about 40 stale doc and comment claims, each with a file and line plus the code that contradicts it. Pick a single row, such as the DriftReminder budget in LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:257 checked against hooks/DriftReminder.hook.ts:28, and confirm the code still says what the issue reports. Correct only the doc text to match the code, and split the batch into several pull requests grouped by file. Done means each row you take is fixed and the stated evidence no longer conflicts with the source.

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

Mô tả

[!NOTE]
🤖 Paulino (AI assistant) responding on behalf of Dr. Paulo

Summary

Each line was checked against the release code. The evidence is in the last column.

line what it says that is not so evidence
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:257 DriftReminder has a 1-per-5-turns budget with dedupe "Every turn, no rate limit" (hooks/DriftReminder.hook.ts:28)
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:378 DeployRegistrationGate blocks end-of-turn it is in ADVISORY_GATES (hooks/StopGates.hook.ts:112)
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:388 review-state.json is mirrored for the statusline nothing under LIFEOS/STATUSLINE reads it
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:486 ISAStaleWriteGuard is a PostToolObserver member retired 2026-10-24 (hooks/PostToolObserver.hook.ts:15)
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:1469 AlgorithmNudge does skill-routing and depth on prompt submit those rows were cut (hooks/AlgorithmNudge.hook.ts:829-833)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:152 MemoryRetriever is a pure function it writes generation and index files (LIFEOS/TOOLS/MemoryRetriever.ts:969-972)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:166 the reviewer needs idle_minutes >= 2 no idle condition (hooks/MemoryReviewFire.hook.ts:366); same at LIFEOS/DOCUMENTATION/LifeosSystemArchitecture.md:336
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:251 cap pressure warns at >=44/48 warns at >=46 (LIFEOS/TOOLS/MemoryHealthCheck.ts:422)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:313 KNOWLEDGE holds People / Companies / Ideas / Research six types (LIFEOS/TOOLS/KnowledgeSchema.ts:37)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:409 5 object types six, with book (LIFEOS/TOOLS/KnowledgeSchema.ts:37)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:416 _index.md has a seedlings section it has "Low Quality (need development)" (LIFEOS/TOOLS/KnowledgeHarvester.ts:726-728)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:719 LearningPatternSynthesis does not read the live feedback ledger it reads Errata (LIFEOS/TOOLS/LearningPatternSynthesis.ts:97)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:728 ActivityParser is analysis only --generate writes a file (LIFEOS/TOOLS/ActivityParser.ts:646-647)
skills/Cortex/References/CompleteGuide.md:438 ContextSearch searches five sources six, with project ISAs (skills/Cortex/Tools/ContextSearch.ts:70)
skills/Cortex/References/CompleteGuide.md:469 JSONL search stays in this install's conversation dir it searches every project dir (skills/Cortex/Tools/ContextSearch.ts:550-556)
LIFEOS/TOOLS/Services.ts:129 the deriver regenerates Data-Plane pages its plist runs LearningPatternSynthesis --hypothesize (LIFEOS/PULSE/com.lifeos.deriver.plist:12-13)
LIFEOS/TOOLS/Services.ts:180 DerivedSync regenerates Data-Plane pages those rebuilds were retired 2026-10-14 (LIFEOS/TOOLS/DerivedSync.ts:7-9)
LIFEOS/TOOLS/Services.ts:218 CommitmentSweep sweeps commitments and reminders it queries only Type:commitment (LIFEOS/TOOLS/CommitmentSweep.ts:117)
LIFEOS/TOOLS/WorkSweep.ts:15, LIFEOS/TOOLS/CommitmentSweep.ts:15, LIFEOS/TOOLS/UsageAggregator.ts:13, LIFEOS/PULSE/modules/usage.ts:14, LIFEOS/TOOLS/InstallDerivedSync.ts:4, LIFEOS/DOCUMENTATION/Work/WorkSystem.md:85 only launchd runs them the installers also create systemd user units on Linux (LIFEOS/TOOLS/InstallUsageAggregator.ts:112-136)
CLAUDE.template.md:111 the statusline reads LIFEOS_STATE.json it reads USER/STATE/current.json (LIFEOS/STATUSLINE/sections/StateRow.ts:65)
LIFEOS/TOOLS/AgentState.ts:11 AgentWatchdog and CarrierProbe consume agent-starts.json CarrierProbe never names it; AgentWatchdog reads subagent-starts.json (LIFEOS/TOOLS/AgentWatchdog.ts:46)
LIFEOS/DOCUMENTATION/Skills/SkillSystem.md:342 FailureToCase turns execution.jsonl into cases it takes --prompt/--banned/--expect and never reads that file
LIFEOS/DOCUMENTATION/Tools/Tools.md:748 "INSTALL.md § Capability check" no such section; there is "Capability gate" (skills/LifeOS/INSTALL.md:35)
hooks/README.md:286 WorkCompletionLearning depends on the Inference API no inference call (hooks/WorkCompletionLearning.hook.ts:60-65)
hooks/README.md:496 WorkCompletionLearning uses learning-readback.ts its only importer is hooks/LoadContext.hook.ts:50
AlgorithmUpgrade.md:30 (step 2d) reads ROOT_CAUSE_ANALYSIS.md no tool writes it; LIFEOS/TOOLS/MemoryRetriever.ts:276 only skips it
LIFEOS/TOOLS/MemoryHealthCheck.ts:398 the next write silently erases the invalid entry with a ledger head the write is refused (LIFEOS/TOOLS/MemoryWriter.ts:976-988)
LIFEOS/ROUTER/Depth.ts:6 AlgorithmNudge's depth row is a consumer that row was cut (hooks/AlgorithmNudge.hook.ts:829-833)
hooks/AlgorithmNudge.hook.ts:8, hooks/AlgorithmNudge.hook.ts:36, hooks/AlgorithmNudge.hook.ts:49, hooks/AlgorithmNudge.hook.ts:55 the header documents the routing, depth and doctrine rows run() no longer emits them (hooks/AlgorithmNudge.hook.ts:829-833)
derived-artifacts.json:17 the per-turn AlgorithmNudge refreshes skill-usewhen-index.json loadIndex() has no caller (hooks/AlgorithmNudge.hook.ts:691); only --rebuild-index writes it
hooks/StopGates.hook.ts:20 the first blocking gate wins all blocking reasons are joined (hooks/StopGates.hook.ts:136)
hooks/VoiceCompletion.hook.ts:15 the main-session check reads kitty-sessions/{sessionId}.json it checks CLAUDE_CODE_AGENT_TASK_ID (hooks/VoiceCompletion.hook.ts:38-40)
hooks/lib/transcript-evidence.ts:13 the module fails open and never blocks a Stop strict mode throws TranscriptUnreadableError (hooks/lib/transcript-evidence.ts:78)
hooks/lib/context-reduction-core.ts:8 the shell hook stays the command-hook path ContextReduction.hook.sh is retired (RETIREMENTS.json:3247)
LIFEOS/TOOLS/ProseInCode.ts:20 default scan is hooks, LIFEOS, skills, test DEFAULT_SCAN differs and skips tests (LIFEOS/TOOLS/ProseInCode.ts:32)
LIFEOS/TOOLS/IntegrityCheck.ts:1183-1187 fetch-timeouts is file-level and non-blocking it judges each call (LIFEOS/TOOLS/IntegrityCheck.ts:1391) with a budget of 0 (LIFEOS/TOOLS/IntegrityCheck.ts:305)
LIFEOS/TOOLS/GetCounts.ts:18 LIFEOS_StatusLine.sh must use GetCounts the statusline renderer never calls it; only Banner.ts does
Ngôn ngữ chính
TypeScript
Star
19.9k
Fork
2.5k
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

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

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: 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 danielmiessler/LifeOS

Tất cả issue của danielmiessler/LifeOS

Issue tương tự

Thêm issue về TypeScript

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.