Dependency Purpose Annotator

Correct scoped imports, parse Python AST evidence, separate standard/local modules, and add reviewed purposes, mappings, exceptions and baseline diffs.

dependency-purpose examples/sample.json --format json

Input may include import_mappings such as {"PIL":"Pillow"}, purposes and exceptions as dependency-name-to-text objects, plus baseline containing a prior JSON report. Evidence includes source line numbers. Python standard-library imports and local root/src modules are reported separately. JavaScript token scanning supports static ESM, side-effect imports, require and literal dynamic imports while skipping comments and string contents. Computed imports, custom aliases, regex literals and advanced bundler resolution remain outside this conservative static analysis. An exception records the operator's rationale; it never proves runtime use or deletes a dependency.

python -m pip install .
dependency-purpose examples/sample.json
dependency-purpose examples/sample.json --format json --output report.json

The example documents the v1 input shape. Existing report files are never overwritten. Source inputs are read-only except where the documented purpose explicitly creates a new output artifact.