feat: initial CodeMap implementation

Signed-off-by: Damian Skrzyński <polprog.tech@gmail.com>

Author: polprog-dev

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug Report
+about: Report a bug in CodeMap
+title: "[Bug] "
+labels: bug
+assignees: ""
+---
+
+## Describe the Bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. Run `codemap ...`
+2. With this repository/project: (describe or link)
+3. Observe the error
+
+## Expected Behavior
+
+A clear description of what you expected to happen.
+
+## Actual Behavior
+
+What actually happened. Include full command output if possible.
+
+## Environment
+
+- **OS:** (e.g., macOS 14, Ubuntu 22.04)
+- **Python version:** (e.g., 3.12.1)
+- **CodeMap version:** (run `codemap --help`)
+- **Installation method:** (pip install, editable, etc.)
+
+## Additional Context
+
+Add any other context, repository examples, screenshots, or logs.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+title: "[Feature] "
+labels: enhancement
+assignees: ""
+---
+
+## Problem / Motivation
+
+Describe the problem or need this feature would address.
+
+## Proposed Solution
+
+A clear description of what you'd like to happen.
+
+## Alternatives Considered
+
+Any alternative solutions or workarounds you've considered.
+
+## Additional Context
+
+Examples, mockups, or references to similar features in other tools.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,32 @@
+## Description
+
+Brief description of what this PR does.
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+
+## Changes Made
+
+- Change 1
+- Change 2
+
+## How to Test
+
+Steps to verify this change:
+
+1. `pip install -e ".[dev]"`
+2. `pytest`
+3. (any specific commands to test the change)
+
+## Checklist
+
+- [ ] My code follows the project's architecture (domain/application/infrastructure/cli layers)
+- [ ] I have added tests that cover my changes
+- [ ] All new and existing tests pass (`pytest`)
+- [ ] I have updated documentation if needed
+- [ ] My changes produce no new linting warnings (`ruff check src/ tests/`)

.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: python -m ruff check src/ tests/
+
+      - name: Format check
+        run: python -m ruff format --check src/ tests/
+
+      - name: Type check
+        run: python -m mypy src/codemap/ --ignore-missing-imports
+
+      - name: Run tests
+        run: python -m pytest tests/ -v --tb=short

.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing / Coverage
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+
+# CodeMap outputs
+codemap_output/
+*.codemap.json
+*.codemap.html

CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to CodeMap will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-03-15
+
+### Added
+
+- Initial release of CodeMap
+- Framework-agnostic repository scanning for Python, JavaScript, TypeScript, JSX, TSX
+- Module-level dependency extraction with fan-in/fan-out metrics
+- Git-based ownership analysis with batch `git log` operations (2 calls regardless of repo size)
+- Churn and hotspot detection (high churn × high coupling = risk)
+- Interactive HTML visualization with D3.js force-directed graph
+- Six layout modes: Force, Tree, Radial, Cluster, Flow, Manual
+- Five display modes: Overview, Readable, Focus, Presentation, Spacious
+- Five color modes: Language, Group, Churn, Risk, Contributors
+- Theme selector: Dark, Light, System (persisted in localStorage)
+- Complete Polish (PL) and English (EN) UI localization
+- Focused single-node exploration with dropdown selection (Local, Dependencies, Reverse, Impact, Flow)
+- Manual layout mode with drag-and-drop, save/restore via localStorage
+- Node notes/annotations with modal editor
+- Minimap for large-graph navigation
+- Large-graph progressive loading: collapsed clusters, click-to-expand, adaptive simulation
+- Fast/Quality performance toggle for large graphs (>200 nodes)
+- `--fast` CLI flag to skip git analysis for speed
+- Real-time progress reporting with Rich spinners and stage labels
+- Graceful `Ctrl+C` cancellation for all commands
+- JSON, HTML, and PDF output formats
+- Terminal report renderer
+- CI workflow with lint (ruff), format check, type checking (mypy), and tests
+- 136 tests covering rendering, CLI, analysis, scanning, and infrastructure
+- Comprehensive documentation: README, architecture, contributing guide

CODE_OF_CONDUCT.md

@@ -0,0 +1,39 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers. All complaints will be reviewed and
+investigated and will result in a response that is deemed necessary and
+appropriate to the circumstances.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.