Skip to content

docs: refresh MAP.md and README for map/dup initiative#165

Merged
srobinson merged 2 commits into
mainfrom
docs/map-readme-refresh
Jun 17, 2026
Merged

docs: refresh MAP.md and README for map/dup initiative#165
srobinson merged 2 commits into
mainfrom
docs/map-readme-refresh

Conversation

@srobinson

Copy link
Copy Markdown
Owner

Final docs round of the fmm map/dup initiative. Regenerates MAP.md per MAP.SKILL.md and brings README.md current for the user-visible commands/flags shipped this session. Docs-only; no code changes.

MAP.md (regenerated at 29990d0, was 805ae4c)

  • Real cycles surfaced. fmm cycles now hides module-hierarchy facades by default, so the Seams section shows genuine coupling: resolver/deno.rs ↔ resolver/workspace.rs (real mutual use) and format/search_formatters.rs ↔ cli/commands/dupes.rs (a by-name matcher artifact — search_formatters imports crate::dupes::DupeClustersResult from core's dupes.rs, and the basename collision with the CLI's dupes.rs draws a phantom core → cli edge that cannot be a real import).
  • Duplication candidates subsection added to Health via fmm dupes (8 clusters; the signature_end_byte triplication is the genuinely consolidatable one; VERSION and the per-language trait impls are candidates, not verdicts).
  • Trait method signatures in the boundary descriptions (via fmm outline), reverse-transitive blast radius (via fmm deps --reverse --transitive), and precise importers (via fmm glossary --exact).
  • Refreshed topology (434 files / 67,011 LOC), the new fmm-core dupes module, and GitMeta on the FmmStore port.

README.md (minimal, accurate)

  • New fmm cycles and fmm dupes commands; new fmm_dupe_clusters MCP tool (10 → 11 tools).
  • New flags: exports --filter {all|source|tests}, glossary --exact, deps --reverse --transitive, generate --sha/--no-git.
  • fmm status now reports git metadata; fmm cycles default-behavior change documented.

MAP.SKILL.md (small accuracy tweak)

  • Duplication section now points at the shipped fmm dupes repo-wide scan instead of describing it as a planned primitive.

Every command/flag documented was verified against fmm <cmd> --help. Code referenced by path + symbol, never line numbers.

Regenerate MAP.md at 29990d0 (was 805ae4c): real runtime cycles now
surfaced (resolver deno<->workspace genuine; search_formatters<->dupes a
by-name matcher artifact), fmm dupes duplication-candidates subsection,
trait method signatures, reverse-transitive blast radius, refreshed
topology (434 files / 67,011 LOC) and the new fmm-core dupes module.

README: new fmm cycles/dupes commands, fmm_dupe_clusters MCP tool (10 ->
11 tools), exports --filter / glossary --exact / deps --reverse
--transitive / generate --sha/--no-git flags, status git metadata, and
the cycles default-behavior change.

MAP.SKILL.md: duplication section now points at the shipped fmm dupes
repo-wide scan instead of describing it as a planned primitive.
@srobinson srobinson enabled auto-merge (squash) June 17, 2026 14:09
@srobinson srobinson merged commit c3772bf into main Jun 17, 2026
1 check passed
@srobinson srobinson deleted the docs/map-readme-refresh branch June 17, 2026 14:16
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