[G10-01] ADR draft: AST parser decision boundary #102

New issue

Open

opened 2026-05-28 01:16:14 +02:00 by codex · 0 comments

codex commented

2026-05-28 01:16:14 +02:00

Collaborator

Suggested executor: Gemini 3.5 Flash.

Wave: G10 — Backlog-only Research

Goal

Draft an ADR defining when fallow-ts should adopt an AST parser dependency.

Expected files

decisions/0005-*.md or next available ADR

Acceptance criteria

ADR lists triggers for adding parser dependency.
ADR lists options such as Babel, ts-morph, TypeScript compiler API, and no-deps mode.
No parser implementation in this PR.

Guardrails

One issue = one PR.
Add or update a behavior/golden test before changing behavior.
No runtime dependencies.
No new analyzer categories unless the issue explicitly says so.
Keep changes small; do not refactor src/analyze.ts broadly.

Verification

Run npm run build && npm test && git diff --check.

Notes

Backlog-only; Gemini may draft docs, not implement parser migration.

Suggested executor: Gemini 3.5 Flash. Wave: G10 — Backlog-only Research ## Goal Draft an ADR defining when fallow-ts should adopt an AST parser dependency. ## Expected files - `decisions/0005-*.md or next available ADR` ## Acceptance criteria - ADR lists triggers for adding parser dependency. - ADR lists options such as Babel, ts-morph, TypeScript compiler API, and no-deps mode. - No parser implementation in this PR. ## Guardrails - One issue = one PR. - Add or update a behavior/golden test before changing behavior. - No runtime dependencies. - No new analyzer categories unless the issue explicitly says so. - Keep changes small; do not refactor `src/analyze.ts` broadly. ## Verification - Run `npm run build && npm test && git diff --check`. ## Notes - Backlog-only; Gemini may draft docs, not implement parser migration.