ArchMAP Roadmap¶

Released¶

Per-import unresolved tracking — importsTotal, importsResolved, unresolvedImports per file; metrics.unresolvedImports in graph report.
--show-unresolved[=N] — list imports that failed to resolve (file + specifier).
Coupling budgets — [analysis.budgets] in .archmap.toml + --fail-on-budget-violations CI gate + --max-outgoing-per-file / --max-incoming-per-file CLI overrides.
--ignore-external — strip external package nodes and their edges; metrics recomputed on the filtered graph.
--summary-format {text,table,markdown} — flexible terminal summary output.
SVG XSS fix — health grade XML-escaped in /api/badge response.
Web UI — dedicated gear-icon Config button; logo restored to Graph view navigation.

Parser resolution rate — resolutionRate metric in all reports. CLI warns when < 70%. --min-resolution-rate PCT gate for CI.
Shell completion — archmap --print-completion bash|zsh|fish. Install: pip install archmap[completion].
Web UI PNG export — Download button in canvas toolbar, 2× scale, zero deps. ✅
Docker image — ghcr.io/kaua-kgzin/archmap:latest published automatically on each release via GitHub Actions. ✅
i18n — 6 languages — English, Português (Brasil), Español, Français, Deutsch, 中文 (简体). Instant switch, persisted.
Config panel — Interface/General/Graph/LLM Advisor/Scan Languages. All persisted in localStorage.
LLM config persistence — Provider, model, base URL, API key saved; auto-save mode.

/api/badge — dynamic SVG health badge endpoint for README embedding (GET /api/badge).
/api/advise — server-side LLM advisor endpoint; Web UI AI Advisor panel now has an interactive form with Ollama/Claude/OpenAI/custom provider support.

archmap trace <entrypoint> — BFS reachability from any file: dependency tree by depth, coverage %, --unreachable, --max-depth.
archmap advise — LLM-powered architectural advisor supporting Claude, OpenAI, Ollama, and any OpenAI-compatible local endpoint (LM Studio, etc.) — zero new runtime deps.
archmap init --from-analysis — derives .archmap.toml layer rules from the actual dependency graph (not just directory names).
archmap diff --snapshot-a/--snapshot-b — compare two saved JSON snapshots without git refs.
VS Code extension (vscode-extension/) — inline diagnostics, health score status bar, trace webview, web UI launcher.
Web UI — Trace view: BFS client-side with depth-colored graph highlight and coverage stats.
Web UI — AI Advisor view: top issue cards and CLI command reference per provider.

Web UI multi-view navigation: nav rail (Graph/Insights/Rules & Layers), Layer Diagram tab, Dependency Matrix tab.

Web UI complete visual refresh (Inter + JetBrains Mono, indigo design system, health gauge, KPI tiles).
Cytoscape bundled locally — removes CDN dependency and fixes CSP.
CI fixes for Windows EXE build and PyPI trusted publisher.

Public Python API — Define and document a stable programmatic surface (from archmap import analyze_project, ArchMapConfig, AnalysisResult). Add __all__ to public modules, document with MkDocs examples, establish a deprecation policy (DeprecationWarning + semver). Unlocks IDE plugins, pytest integrations, and custom CI tooling beyond the CLI.
mypy enforcement (blocking) — Graduate mypy from non-blocking (infrastructure only, v0.8.x) to a hard CI gate. Expand typed coverage module by module until --strict is feasible on the full src/archmap/ tree.
Version bump to v1.0.0 — Finalize the public API contract, write a migration guide from 0.x, and tag the first stable release.

Plugin SDK for custom parsers and analyzers via entry points.
Change coupling detector via git log analysis.
Multi-repo topology support.
WebSocket-based live UI refresh.
GraphML and Graphviz DOT export formats.
Tree-sitter based parsers — ✅ Done. Optional [tree-sitter] extra ships AST-based parsers for all 9 languages; regex fallback preserved when the extra is not installed.
Property-based testing (Hypothesis) — Add hypothesis to dev deps and use it on all language parsers. The parser must never crash on any valid unicode input.
Mutation testing (mutmut) — Apply mutation testing to core analysis modules (cycle_detector.py, risk_analyzer.py, complexity_analyzer.py).
Homebrew formula — Distribute as a Homebrew tap for macOS users (brew install kaua-kgzin/tap/archmap).
Web UI accessibility (a11y) — Audit and fix WCAG 2.1 AA compliance: color contrast, keyboard navigation, focus management, ARIA labels for the Cytoscape.js graph.
SVG export — Add a "Download SVG" button using Cytoscape.js's cy.svg() API.
API stability policy — Publish a formal versioning contract: public vs. internal modules, deprecation timeline.

These are ongoing commitments rather than versioned deliverables. They run in parallel with every release cycle.

Supply chain audit — pip-audit runs in CI on every push (implemented in v0.8.x). Dependabot watches Python deps, npm deps, and GitHub Actions pins on a weekly schedule. No manual audit cadence required.
Architectural self-check (dogfooding) — CI runs archmap analyze src/archmap/ --fail-on-cycles on every push. ArchMAP must pass its own analysis. The health score threshold (--min-health) is raised incrementally as the codebase improves, making the gate self-tightening.
mypy coverage expansion — Type annotations are added incrementally to every new or modified file. The mypy CI step starts non-blocking (infrastructure, v0.8.x) and transitions to a hard gate (v0.9.x) once baseline coverage is established. No new untyped functions merged after v0.9.0.
Documentation freshness — Every CLI flag, JSON output field, and .archmap.toml key introduced in a PR must be documented in the same PR. The MkDocs build runs with --strict in CI; broken references fail the docs workflow.
Parser parity — As new language features are introduced (e.g., Python 3.12+ type parameter syntax, TypeScript 5.x satisfies operator), parser regression tests are added before the parser update is merged. No silent parser regressions.