Skip to content

fix(tools): point the stale-map line at ix map --remap - #37

Merged
KageBinary merged 1 commit into
mainfrom
fix/stale-map-wording
Oct 25, 2026
Merged

KageBinary merged 1 commit into
mainfrom
fix/stale-map-wording

Conversation

@KageBinary

Copy link
Copy Markdown
Collaborator

When ix reports the architecture map stale, ix-subsystems and ix-map added a line ending "— a background refresh is running." That isn't always true: Ix also reports a stale map when background refresh is off (IX_MAP_BACKGROUND_REFRESH=0), when the last refresh failed, or when it couldn't start. On the llm path the line also replaces Ix's own diagnostic code=map_stale record, so its "Run ix map --remap" remedy was lost.

The line (mapStaleLine in runtime/map-stale.ts) now reads:

  • _Map is stale (regions as of map rev N, M files); recent edits may not be reflected — run `ix map --remap` to refresh it now._ (1 file when singular)
  • _Map is stale; recent edits may not be reflected — run `ix map --remap` to refresh it now._ when Ix gives no regions_as_of

Updated the assertions in tests/map-stale.test.ts, tests/success-fixtures.test.ts and the quote in TOOL_CONTRACT.md. Added the unit cases a review found missing: two map_stale records, a record that isn't the first line, and a 1-file map (parse and render).

Tests (Bun 1.4.2): bun install --frozen-lockfile, bun run typecheck clean, bun test 358 pass / 11 skip (live/real-ix suites, env-gated) / 0 fail.

No version change.

🤖 Generated with Claude Code

The stale-map line said "a background refresh is running", which is not
always true: Ix also reports a stale map when background refresh is off
(IX_MAP_BACKGROUND_REFRESH=0), when the last refresh failed, or when it
could not start. On the llm path the line also replaces Ix's own
map_stale record, whose "Run ix map --remap" remedy was lost. The line
now gives that remedy instead.

Adds unit cases for two map_stale records, a record that is not the
first line, and a 1-file map.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@KageBinary
KageBinary merged commit 3027206 into main Oct 25, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant