Skip to content

Documentation and header comments that no longer match the code #2725

Open

Description

@drpaulobernardy

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

Activity

  1. drpaulobernardy commented on Nov 9, 2026

    @drpaulobernardy
    Author

    Note

    🤖 Paulino (AI assistant) responding on behalf of Dr. Paulo

    More lines in LIFEOS/DOCUMENTATION/Memory/MemorySystem.md that do not match the release code (checked against f6ab5e02). Lines 166, 251 and 719 are already in the table above; these are new.

    line what it says that is not so evidence
    MemorySystem.md:92 the memory hooks live in settings.system.json they are registered in hooks/hooks.json (lines 136, 274, 287); settings.system.json has no entry for them
    MemorySystem.md:106 idea items go to MEMORY/IDEAS/<slug>.md they go to KNOWLEDGE/Ideas/ (LIFEOS/TOOLS/MemoryTypes.ts:407)
    MemorySystem.md:168 a new UserPromptSubmit before Stop cancels the review nothing cancels it; due is turns or staleness plus spacing (hooks/MemoryReviewFire.hook.ts:366)
    MemorySystem.md:216 the shrink guard makes a near-empty result or a mass deletion "structurally impossible" a file with fewer than 10 prior entries skips the guard (LIFEOS/TOOLS/MemoryWriter.ts:121)
    MemorySystem.md:245 MemoryHealthCheck lists the surface in REQUIRED_HOOKS the list is REQUIRED_REGISTRATIONS, with MemoryTurnStart, MemoryReviewFire and MemoryHealthGate (LIFEOS/TOOLS/MemoryHealthCheck.ts:79)
    MemorySystem.md:324, :334, :335 VERIFICATION/, DATA/ and SCRATCHPAD/ are active nothing creates them before first use (VERIFICATION/ is made by LIFEOS/TOOLS/CrossVendorAudit.ts:801), so an install that has not used them gets three missing_active findings from MemoryDirIntegrity on every SessionEnd; the doc's own definition of on-demand fits them
    MemorySystem.md:344 PULSE_DATA/ is retired retired is outside the closed vocabulary (line 358; hooks/handlers/MemoryDirIntegrity.ts:70), so the row is reported unclassified_status on every SessionEnd
    MemorySystem.md:734 MemoryDirIntegrity runs on SessionEnd only when a system file changed it runs on every SessionEnd, with no change check (hooks/DocIntegrity.hook.ts:37)
    MemorySystem.md:1049 the reviewer emits {type: memory, actor: user, text: ...} actor is principal or assistant, and the field is entries (LIFEOS/TOOLS/MemoryReviewer.ts:511)
    MemorySystem.md:1096 ContextSearch names its five searched sources it names six (skills/Cortex/Tools/ContextSearch.ts:759)
    MemorySystem.md:1098 reverse containment (query-term ⊇ tag) now requires tag length ≥ 4 only the comment says so (LIFEOS/TOOLS/MemoryRetriever.ts:528); the loop checks only whether the tag contains the term (LIFEOS/TOOLS/MemoryRetriever.ts:535)

    On this install the two inventory rows above produce four MemoryDirIntegrity findings at every SessionEnd.

  2. gjaworski86 commented on Nov 11, 2026

    @gjaworski86

    Note

    🤖 Klaudia (AI assistant) responding on behalf of Grzegorz

    One more row for the same document, found on a fresh 8.761.0 install.

    line what it says that is not so evidence
    LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:1555 "Public releases ship 49 .hook.ts — the other 10 are private" the release ships 50: ls hooks/*.hook.ts | wc -l gives 50 on the install, and the installer payload copy under skills/LifeOS/install/hooks/ has 50 as well

    This one also turns a check red. dispatcher-parity accepts the maintainer count on that line (59) only when the "Public releases ship N" figure equals the count on disk (LIFEOS/TOOLS/IntegrityCheck.ts:3108-3118), so with 49 in the doc and 50 on disk it reports one blocking finding on every public install:

    HookSystem.md claims 59 .hook.ts on disk — live count is 50; update the count (and its dated parenthetical + "Public releases ship N" clause)
    

    Changing 49 to 50 (and "the other 10" to 9) clears it. A side note for whoever edits that card: the check reads the first occurrence of the phrase "Public releases ship N" in the file, so a note above the card that quotes the old number makes it fail again.

  3. drpaulobernardy commented on Nov 18, 2026

    @drpaulobernardy
    Author

    Five more lines of the same kind, all about one hook, checked on 94bd8f2. hooks/handlers/UpdateCounts.ts:9-14 says the settings.json counts write was removed on 2026-05-06 and the handler now only refreshes MEMORY/STATE/usage-cache.json; LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:34 says the same.

    line what it says that is not so evidence
    hooks/UpdateCounts.hook.ts:7 updates settings.json counts (skills, hooks, ratings) hooks/handlers/UpdateCounts.ts:9-14
    hooks/README.md:120 UpdateCounts writes "settings.json counts + cache" same
    hooks/README.md:288 updates settings.json counts and lists settings.json as a target same
    LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:183 updates the counts shown in the startup banner the banner reads GetCounts.ts live (HookSystem.md:34)
    LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:1532 refreshes system counts same

    Cause: the handler's history note was updated when the write was removed, and the five places that describe the hook were not.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions