Problem
agent-docs/lit-muscle-memory-gotchas.md (the SSR-contract section) points to "See `packages/core/src/render-server.js` around line 357", but the pre-render lifecycle code it refers to now lives at ~line 419, a ~60-line drift. The claim itself is still accurate; only the embedded line number has rotted.
Hard-coded line numbers in prose docs rot every time the referenced file changes, and nothing flags the drift. This was caught during a full re-verification of lit-muscle-memory-gotchas.md against the current source (every other claim in that file checked out against @webjsdev/core/src + check.js; this stale line ref was the only issue).
Design / approach
- Fix the immediate reference in
lit-muscle-memory-gotchas.md: drop the line number and refer to the function/symbol instead (e.g. "see the pre-render pass in render-server.js"), which stays correct as the file moves.
- Sweep the rest of
agent-docs/*.md (and nested AGENTS.md files) for other around line N / :N style hard references with grep -nE 'line [0-9]+|\.js:[0-9]+' and replace them with symbol/function-name references the same way.
- Prefer naming the function, rule, or exported symbol over a line number anywhere a doc points into source, so references survive refactors.
Acceptance criteria
Problem
agent-docs/lit-muscle-memory-gotchas.md(the SSR-contract section) points to "See `packages/core/src/render-server.js` around line 357", but the pre-render lifecycle code it refers to now lives at ~line 419, a ~60-line drift. The claim itself is still accurate; only the embedded line number has rotted.Hard-coded line numbers in prose docs rot every time the referenced file changes, and nothing flags the drift. This was caught during a full re-verification of
lit-muscle-memory-gotchas.mdagainst the current source (every other claim in that file checked out against@webjsdev/core/src+check.js; this stale line ref was the only issue).Design / approach
lit-muscle-memory-gotchas.md: drop the line number and refer to the function/symbol instead (e.g. "see the pre-render pass inrender-server.js"), which stays correct as the file moves.agent-docs/*.md(and nestedAGENTS.mdfiles) for otheraround line N/:Nstyle hard references withgrep -nE 'line [0-9]+|\.js:[0-9]+'and replace them with symbol/function-name references the same way.Acceptance criteria
render-server.js"around line 357" reference inlit-muscle-memory-gotchas.mdno longer cites a line numberagent-docs/*.mdare replaced with symbol/function references (or confirmed none remain)