devarch 0.2.0__tar.gz

devarch-0.2.0/.github/workflows/release-artifacts.yml

@@ -0,0 +1,33 @@
+name: release-artifacts
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install release dependencies
+        run: python -m pip install --upgrade pip build twine
+
+      - name: Build release artifacts
+        run: python scripts/build_release.py
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: devarch-release-artifacts
+          path: dist/
+          if-no-files-found: error

devarch-0.2.0/.gitignore

@@ -0,0 +1,37 @@
+# Python bytecode and caches
+__pycache__/
+*.py[cod]
+*.pyd
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Packaging and build outputs
+build/
+dist/
+*.egg-info/
+*.whl
+
+# Test and lint caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Dev Archaeologist generated state and reports
+.devarch/
+devarch-report.json
+devarch-report.md
+devarch-report.markdown
+devarch-report.html
+devarch-report.pdf
+
+# OS and editor noise
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/

devarch-0.2.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Dev Archaeologist Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

devarch-0.2.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+recursive-include assets *.png
+global-exclude __pycache__ *.py[cod] .DS_Store Thumbs.db

devarch-0.2.0/PKG-INFO

@@ -0,0 +1,317 @@
+Metadata-Version: 2.4
+Name: devarch
+Version: 0.2.0
+Summary: Dev Archaeologist: excavate dead code, technical debt, and forgotten artifacts in software projects.
+Author: magnexis
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: typer>=0.12.3
+Requires-Dist: rich>=13.7.1
+Requires-Dist: pathspec>=0.12.1
+Requires-Dist: radon>=6.0.1 ; extra == "extended"
+Requires-Dist: networkx>=3.3 ; extra == "extended"
+Requires-Dist: gitpython>=3.1.43 ; extra == "extended"
+Requires-Dist: tree-sitter>=0.22.3 ; extra == "extended"
+Requires-Dist: reportlab>=4.2.2 ; extra == "pdf"
+Requires-Dist: pytest>=8.2.2 ; extra == "test"
+Provides-Extra: extended
+Provides-Extra: pdf
+Provides-Extra: test
+
+# Dev Archaeologist
+
+<p align="center">
+  <img src="assets/devarch-logo.png" alt="Dev Archaeologist logo" width="220">
+</p>
+
+<p align="center">
+  <em>Software archaeology and repository intelligence from Magnexis<img src="assets/magnexis-logo.png" alt="Magnexis logo" width="35"></em>
+</p>
+
+
+<p align="center">
+  <a href="#install"><img alt="Python 3.12+" src="https://img.shields.io/badge/Python-3.12%2B-blue.svg"></a>
+  <a href="#license"><img alt="MIT License" src="https://img.shields.io/badge/License-MIT-green.svg"></a>
+  <a href="#use"><img alt="CLI" src="https://img.shields.io/badge/CLI-devarch-8A6A3A.svg"></a>
+  <a href="#project-overview"><img alt="Magnexis" src="https://img.shields.io/badge/Brand-Magnexis-1F1F1F.svg"></a>
+  <a href="#release-artifacts"><img alt="Build sdist" src="https://img.shields.io/badge/Build-sdist%20%2B%20wheel-5E4B35.svg"></a>
+  <a href="#release-artifacts"><img alt="Release zip" src="https://img.shields.io/badge/Build-release%20zip-444444.svg"></a>
+  <a href="#release-artifacts"><img alt="Release manifest" src="https://img.shields.io/badge/Build-manifest%20%2B%20checksums-B8894D.svg"></a>
+  <a href="#project-overview"><img alt="Version" src="https://img.shields.io/badge/Version-0.2.0-444444.svg"></a>
+</p>
+
+Dev Archaeologist is a Magnexis-built Python CLI for excavating hidden technical debt, structural decay, and forgotten implementation artifacts in software repositories.
+
+It treats every codebase like an archaeological dig site and helps you answer questions like:
+
+- What code is ancient and likely abandoned?
+- Where is the repository accumulating risk?
+- Which files are structural weak points?
+- What can be safely removed, refactored, or archived?
+- How is the project evolving over time?
+
+## Project Overview
+
+The tool scans a repository and turns the results into a rich, terminal-first excavation report.
+
+It can surface:
+
+- dead code
+- ancient files
+- TODO, FIXME, HACK, BUG, TEMP, and XXX markers
+- duplicated logic
+- unused assets and empty directories
+- suspicious backup-style filenames
+- oversized, complex "monster" files
+- dependency hotspots and fragile chains
+- architectural drift and release readiness issues
+- remediation suggestions with estimated effort
+
+The design goals are:
+
+- strong terminal UX
+- modular analyzers
+- readable artifact reports
+- release-friendly packaging
+- future plugin support
+
+## Magnexis Brand
+
+Dev Archaeologist is presented as part of the Magnexis tooling line.
+
+Brand cues used in this repository:
+
+- the archaeological emblem in the project logo
+- the Magnexis name treatment in the README header
+- the Magnexis mark used as a small brand seal
+- a dedicated brand badge in the top badge row
+- consistent earth-toned release and CLI styling
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install devarch
+```
+
+Install with optional extras:
+
+```bash
+pip install devarch[extended]
+pip install devarch[release]
+pip install devarch[test]
+```
+
+The `release` extra is useful if you want to build local distributions.
+
+## Quick Start
+
+Run a full excavation over the current directory:
+
+```bash
+devarch scan .
+```
+
+List every available command:
+
+```bash
+devarch help
+```
+
+Generate a markdown report:
+
+```bash
+devarch export markdown
+```
+
+Generate a PDF report:
+
+```bash
+devarch report pdf
+```
+
+## Release Artifacts
+
+Dev Archaeologist includes a repeatable release build flow for local packaging and CI artifact generation.
+
+Build the release bundle locally:
+
+```bash
+pip install .[release]
+python scripts/build_release.py
+```
+
+This produces the following artifacts in `dist/`:
+
+- `*.whl` for Python wheel distribution
+- `*.tar.gz` for source distribution
+- `*-release.zip` for a bundled release archive
+- `release-manifest.json` for artifact metadata
+- `SHA256SUMS.txt` for checksum verification
+
+The zip bundle is convenient for sharing the release set as a single downloadable package.
+
+See [RELEASE_NOTES.md](RELEASE_NOTES.md) for the full release summary and artifact inventory.
+
+## Command Reference
+
+### Core excavation
+
+```bash
+devarch scan .
+devarch help
+devarch ancient .
+devarch dead-code .
+devarch todos .
+devarch duplicates .
+devarch monsters .
+devarch ruins .
+devarch suspicious .
+devarch inspect src/app.py
+devarch trace auth
+devarch evidence auth
+devarch bugmark src/app.py --line 128
+devarch errorcode "ModuleNotFoundError: No module named 'rich'"
+```
+
+### Repository intelligence
+
+```bash
+devarch dependencies .
+devarch genealogy .
+devarch civilizations .
+devarch debt .
+devarch timeline .
+devarch personality .
+devarch forecast .
+devarch explore .
+devarch investigate .
+devarch weaknesses .
+devarch quake .
+devarch architecture .
+devarch contributors .
+devarch mutations .
+devarch map .
+devarch survival .
+devarch notes .
+```
+
+### Forensic helpers
+
+```bash
+devarch investigate .
+devarch inspect src/app.py
+devarch trace auth
+devarch evidence auth
+devarch bugmark src/app.py --line 128
+devarch errorcode "ModuleNotFoundError: No module named 'rich'"
+```
+
+### Recovery and maintenance
+
+```bash
+devarch plan .
+devarch delete-check src/legacy_auth.py
+devarch refactor .
+devarch routes .
+devarch configs .
+devarch migrations .
+devarch deps .
+devarch drift .
+devarch pr-report .
+devarch status .
+devarch baseline .
+devarch regressions .
+devarch budget .
+devarch release-check .
+devarch ownership .
+devarch dependency-health .
+devarch cleanup .
+devarch standards .
+devarch history .
+devarch recommend .
+devarch prescribe .
+devarch repair-plan .
+```
+
+### Reporting
+
+```bash
+devarch export json
+devarch export markdown
+devarch export html
+devarch report markdown
+devarch report html
+devarch report pdf
+```
+
+## Output Philosophy
+
+Each finding is designed to be actionable instead of just descriptive.
+
+Typical output includes:
+
+- problem
+- evidence
+- impact
+- confidence
+- recommended fix
+- estimated effort
+- risk level
+
+That makes the tool useful not just for audits, but also for cleanup planning, code review, and release preparation.
+
+## Plugin Architecture
+
+Dev Archaeologist exposes a lightweight plugin registry via the `devarch.plugins` entry-point group so future extensions can hook into the excavation pipeline.
+
+Planned extension areas include:
+
+- `devarch-plugin-security`
+- `devarch-plugin-ai`
+- `devarch-plugin-performance`
+
+## Development
+
+Project layout:
+
+```text
+devarch/
+├── analyzers/
+├── cli/
+├── reports/
+├── scanner/
+├── utils/
+└── tests/
+```
+
+Useful commands:
+
+```bash
+python -m pytest -q
+python -m compileall devarch
+python scripts/build_release.py
+```
+
+## Repository Maintenance
+
+The maintenance engine supports:
+
+- baseline snapshots
+- regression detection
+- debt budgets
+- release readiness checks
+- ownership analysis
+- dependency health monitoring
+- cleanup recommendations
+- standards checks
+- health history
+- remediation prescriptions
+
+## License
+
+MIT
+

devarch-0.2.0/README.md

@@ -0,0 +1,294 @@
+# Dev Archaeologist
+
+<p align="center">
+  <img src="assets/devarch-logo.png" alt="Dev Archaeologist logo" width="220">
+</p>
+
+<p align="center">
+  <em>Software archaeology and repository intelligence from Magnexis<img src="assets/magnexis-logo.png" alt="Magnexis logo" width="35"></em>
+</p>
+
+
+<p align="center">
+  <a href="#install"><img alt="Python 3.12+" src="https://img.shields.io/badge/Python-3.12%2B-blue.svg"></a>
+  <a href="#license"><img alt="MIT License" src="https://img.shields.io/badge/License-MIT-green.svg"></a>
+  <a href="#use"><img alt="CLI" src="https://img.shields.io/badge/CLI-devarch-8A6A3A.svg"></a>
+  <a href="#project-overview"><img alt="Magnexis" src="https://img.shields.io/badge/Brand-Magnexis-1F1F1F.svg"></a>
+  <a href="#release-artifacts"><img alt="Build sdist" src="https://img.shields.io/badge/Build-sdist%20%2B%20wheel-5E4B35.svg"></a>
+  <a href="#release-artifacts"><img alt="Release zip" src="https://img.shields.io/badge/Build-release%20zip-444444.svg"></a>
+  <a href="#release-artifacts"><img alt="Release manifest" src="https://img.shields.io/badge/Build-manifest%20%2B%20checksums-B8894D.svg"></a>
+  <a href="#project-overview"><img alt="Version" src="https://img.shields.io/badge/Version-0.2.0-444444.svg"></a>
+</p>
+
+Dev Archaeologist is a Magnexis-built Python CLI for excavating hidden technical debt, structural decay, and forgotten implementation artifacts in software repositories.
+
+It treats every codebase like an archaeological dig site and helps you answer questions like:
+
+- What code is ancient and likely abandoned?
+- Where is the repository accumulating risk?
+- Which files are structural weak points?
+- What can be safely removed, refactored, or archived?
+- How is the project evolving over time?
+
+## Project Overview
+
+The tool scans a repository and turns the results into a rich, terminal-first excavation report.
+
+It can surface:
+
+- dead code
+- ancient files
+- TODO, FIXME, HACK, BUG, TEMP, and XXX markers
+- duplicated logic
+- unused assets and empty directories
+- suspicious backup-style filenames
+- oversized, complex "monster" files
+- dependency hotspots and fragile chains
+- architectural drift and release readiness issues
+- remediation suggestions with estimated effort
+
+The design goals are:
+
+- strong terminal UX
+- modular analyzers
+- readable artifact reports
+- release-friendly packaging
+- future plugin support
+
+## Magnexis Brand
+
+Dev Archaeologist is presented as part of the Magnexis tooling line.
+
+Brand cues used in this repository:
+
+- the archaeological emblem in the project logo
+- the Magnexis name treatment in the README header
+- the Magnexis mark used as a small brand seal
+- a dedicated brand badge in the top badge row
+- consistent earth-toned release and CLI styling
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install devarch
+```
+
+Install with optional extras:
+
+```bash
+pip install devarch[extended]
+pip install devarch[release]
+pip install devarch[test]
+```
+
+The `release` extra is useful if you want to build local distributions.
+
+## Quick Start
+
+Run a full excavation over the current directory:
+
+```bash
+devarch scan .
+```
+
+List every available command:
+
+```bash
+devarch help
+```
+
+Generate a markdown report:
+
+```bash
+devarch export markdown
+```
+
+Generate a PDF report:
+
+```bash
+devarch report pdf
+```
+
+## Release Artifacts
+
+Dev Archaeologist includes a repeatable release build flow for local packaging and CI artifact generation.
+
+Build the release bundle locally:
+
+```bash
+pip install .[release]
+python scripts/build_release.py
+```
+
+This produces the following artifacts in `dist/`:
+
+- `*.whl` for Python wheel distribution
+- `*.tar.gz` for source distribution
+- `*-release.zip` for a bundled release archive
+- `release-manifest.json` for artifact metadata
+- `SHA256SUMS.txt` for checksum verification
+
+The zip bundle is convenient for sharing the release set as a single downloadable package.
+
+See [RELEASE_NOTES.md](RELEASE_NOTES.md) for the full release summary and artifact inventory.
+
+## Command Reference
+
+### Core excavation
+
+```bash
+devarch scan .
+devarch help
+devarch ancient .
+devarch dead-code .
+devarch todos .
+devarch duplicates .
+devarch monsters .
+devarch ruins .
+devarch suspicious .
+devarch inspect src/app.py
+devarch trace auth
+devarch evidence auth
+devarch bugmark src/app.py --line 128
+devarch errorcode "ModuleNotFoundError: No module named 'rich'"
+```
+
+### Repository intelligence
+
+```bash
+devarch dependencies .
+devarch genealogy .
+devarch civilizations .
+devarch debt .
+devarch timeline .
+devarch personality .
+devarch forecast .
+devarch explore .
+devarch investigate .
+devarch weaknesses .
+devarch quake .
+devarch architecture .
+devarch contributors .
+devarch mutations .
+devarch map .
+devarch survival .
+devarch notes .
+```
+
+### Forensic helpers
+
+```bash
+devarch investigate .
+devarch inspect src/app.py
+devarch trace auth
+devarch evidence auth
+devarch bugmark src/app.py --line 128
+devarch errorcode "ModuleNotFoundError: No module named 'rich'"
+```
+
+### Recovery and maintenance
+
+```bash
+devarch plan .
+devarch delete-check src/legacy_auth.py
+devarch refactor .
+devarch routes .
+devarch configs .
+devarch migrations .
+devarch deps .
+devarch drift .
+devarch pr-report .
+devarch status .
+devarch baseline .
+devarch regressions .
+devarch budget .
+devarch release-check .
+devarch ownership .
+devarch dependency-health .
+devarch cleanup .
+devarch standards .
+devarch history .
+devarch recommend .
+devarch prescribe .
+devarch repair-plan .
+```
+
+### Reporting
+
+```bash
+devarch export json
+devarch export markdown
+devarch export html
+devarch report markdown
+devarch report html
+devarch report pdf
+```
+
+## Output Philosophy
+
+Each finding is designed to be actionable instead of just descriptive.
+
+Typical output includes:
+
+- problem
+- evidence
+- impact
+- confidence
+- recommended fix
+- estimated effort
+- risk level
+
+That makes the tool useful not just for audits, but also for cleanup planning, code review, and release preparation.
+
+## Plugin Architecture
+
+Dev Archaeologist exposes a lightweight plugin registry via the `devarch.plugins` entry-point group so future extensions can hook into the excavation pipeline.
+
+Planned extension areas include:
+
+- `devarch-plugin-security`
+- `devarch-plugin-ai`
+- `devarch-plugin-performance`
+
+## Development
+
+Project layout:
+
+```text
+devarch/
+├── analyzers/
+├── cli/
+├── reports/
+├── scanner/
+├── utils/
+└── tests/
+```
+
+Useful commands:
+
+```bash
+python -m pytest -q
+python -m compileall devarch
+python scripts/build_release.py
+```
+
+## Repository Maintenance
+
+The maintenance engine supports:
+
+- baseline snapshots
+- regression detection
+- debt budgets
+- release readiness checks
+- ownership analysis
+- dependency health monitoring
+- cleanup recommendations
+- standards checks
+- health history
+- remediation prescriptions
+
+## License
+
+MIT

devarch-0.2.0/devarch/__init__.py

@@ -0,0 +1,4 @@
+"""Dev Archaeologist package."""
+
+from .version import __version__
+