# mapping-codebases - Changelog

All notable changes to the `mapping-codebases` skill are documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

## [0.8.0] - 2026-03-31

### Added

- mapping-codebases v0.8.0 — C support + doc comments, line ranges, constants, enum variants (#510)

### Other

- Regenerate _MAP.md files after @lat: backlink insertion (#504)
- Lattice v2: bidirectional source-anchored knowledge graph (#503)

## [0.7.1] - 2026-03-24

### Added

- use bundled parsers first, curl as fallback
- bundle markdown parser
- bundle html parser
- bundle java parser
- bundle ruby parser
- bundle rust parser
- bundle go parser
- bundle tsx parser
- bundle typescript parser
- bundle javascript parser
- bundle python parser
- add mapping-features skill for behavioral web app documentation (#432)

### Fixed

- curl fallback for tree-sitter parser download
- document actual sample_firehose() return format and add missing bsky utility exports

## [0.7.0] - 2026-02-28

### Added

- add TS signatures, export defaults, Go/Rust/Ruby methods, verbose flag
- fix three issues - aliases, expansion threshold, return format (v3.7.0)

## [0.7.0] - 2026-02-28

### Added

- TypeScript: full function/method signatures with parameters and return types (#234)
- TypeScript: `export default` function, class, and identifier declarations (#233)
- TypeScript: `export interface` and `export const/let` declarations
- Go: receiver method extraction nested under their types (#235)
- Go: function signatures with parameters and return types
- Rust: `impl` block method extraction nested under structs/enums (#235)
- Rust: function/method signatures with parameters and return types
- Ruby: methods nested under classes/modules instead of flat listing (#235)
- Ruby: `singleton_method` extraction (e.g., `self.format`)
- Ruby: method parameter signatures
- `--verbose` / `-v` flag for debug output (#236)

## [0.6.0] - 2026-02-03

### Added

- Add/Update skill: mapping-codebases
- Add 'interaction' memory type to remembering skill
## 0.9.0 — 2026-07-26

Deprecated. Superseded by tree-sitting, which does the same AST extraction at
runtime without persisting _MAP.md artifacts. `scripts/codemap.py`, `parsers/`,
and `README.md` removed; release mapping-codebases-v0.8.0 is the archive.

---
name: mapping-codebases
description: DEPRECATED — superseded by tree-sitting. This skill generated persistent _MAP.md files; tree-sitting does the same AST extraction at runtime (~700ms for 250 files) with no artifact to write, commit, or keep in sync. Use tree-sitting for "map this codebase", "explore repo", "understand structure", or any code navigation task. The final working version is archived at release mapping-codebases-v0.8.0.
metadata:
  version: 0.9.0
---

# Mapping Codebases (deprecated)

Use [tree-sitting](../tree-sitting/SKILL.md) instead.

## Why

This skill wrote `_MAP.md` files to disk — a persisted symbol inventory per
directory, generated once and read many times. That tradeoff made sense when
scanning was expensive. It isn't: tree-sitting parses a 250-file repo in about
700ms and answers queries against the in-memory AST in under a millisecond.

A persisted map costs what a runtime scan does not — it goes stale, it needs
regenerating, it gets committed, and it must be excluded from every other tool
that walks the tree. Nothing was gained for that.

## Replacement commands

```bash
TREESIT=/mnt/skills/user/tree-sitting/scripts/treesit.py

# Was: codemap.py /path/to/repo          → root orientation
python3 $TREESIT /path/to/repo

# Was: reading every _MAP.md in the tree → full inventory
python3 $TREESIT /path/to/repo --depth=-1 --detail=sparse

# Was: grepping _MAP.md for a symbol     → direct lookup
python3 $TREESIT /path/to/repo --no-tree 'find:parse_input'
```

## The archived version

The last working release is
[mapping-codebases-v0.8.0](https://github.com/oaustegard/claude-skills/releases/tag/mapping-codebases-v0.8.0)
(2026-03-31). It carries `scripts/codemap.py` and the eleven bundled
`parsers/*.so` grammars. The release is the snapshot; nothing in this directory
reproduces it.

Note that v0.8.0 ships a latent bug: `codemap.py:1216` calls an unimported
`get_parser()` inside a `try` swallowed by a bare `except Exception`, so HTML
inline-JavaScript symbol extraction silently returned nothing. It will not be
fixed.