doc-updater

Doc Updater

Generates and updates docs/CODEMAPS/ — token-lean architecture snapshots for each service layer. Designed to run after significant code changes to keep codemaps fresh for sub-agents and new sessions.

Iron Law: Codemaps must reflect current code, not aspirational architecture. Read the actual files before writing the codemap. A stale codemap is worse than no codemap.

Scope

Generates codemaps for detected services:

Codemap File	Detected By	Stack
docs/CODEMAPS/spring-api.md	pom.xml with spring-boot	Java 21 / Spring Boot 3.5.x / WebFlux / R2DBC
docs/CODEMAPS/nestjs-api.md	package.json with @nestjs/core	NestJS 11.17.x / Fastify / Prisma / TypeScript 5.9.x
docs/CODEMAPS/angular-spa.md	angular.json	Angular 21.x / daisyUI / TailwindCSS
docs/CODEMAPS/flutter-mobile.md	pubspec.yaml with flutter:	Flutter 3.41.x / Dart 3.10.9 / Riverpod
docs/CODEMAPS/python-api.md	pyproject.toml with fastapi	Python 3.14 / FastAPI 0.135.2 / Pydantic v2
docs/CODEMAPS/architecture.md	Always	Cross-service integration map

Codemap Format

Each file must stay under 1000 tokens (~700 words):

# {Service} Codemap
**Updated:** {ISO-8601 date}  **Stack:** {tech + version}

## Entry Points
- `{file}:{line}` — {one-line description}

## Key Modules / Features
- `{path}/` — {one-line description}

## Shared Utilities
- `{file}` — {one-line description}

## External Dependencies
- {dependency}: {how it's used}

## Data Flow
{1-3 line prose: request path through the stack}

## Known Constraints
- {non-obvious architectural decisions}

Process

1. Detect — check for stack indicator files in project root and subdirs

# Stack detection commands
ls pom.xml 2>/dev/null && grep -q "spring-boot" pom.xml && echo "spring-api detected"
ls package.json 2>/dev/null && grep -q "@nestjs/core" package.json && echo "nestjs detected"
ls angular.json 2>/dev/null && echo "angular detected"
ls pubspec.yaml 2>/dev/null && grep -q "flutter:" pubspec.yaml && echo "flutter detected"
ls pyproject.toml 2>/dev/null && grep -q "fastapi" pyproject.toml && echo "python-api detected"