cowork-bot: merge master into cowork/improve-deadcode; resolve conflicts toward canonical scanner/tests

Author: cowork-bot

.github/CODEOWNERS

@@ -0,0 +1,25 @@
+# Code Owners for DeadCode repository
+# These individuals/teams are automatically requested for review on PRs
+
+# Global owners
+* @Coding-Dev-Tools/engineers
+
+# Python package
+src/deadcode/ @Coding-Dev-Tools/engineers
+
+# Tests
+tests/ @Coding-Dev-Tools/engineers
+
+# CI/CD workflows
+.github/workflows/ @Coding-Dev-Tools/engineers
+
+# Documentation
+README.md @Coding-Dev-Tools/marketing
+CHANGELOG.md @Coding-Dev-Tools/marketing
+CONTRIBUTING.md @Coding-Dev-Tools/engineers
+SECURITY.md @Coding-Dev-Tools/engineers
+AGENTS.md @Coding-Dev-Tools/engineers
+
+# Configuration
+pyproject.toml @Coding-Dev-Tools/engineers
+.deadcode.yml @Coding-Dev-Tools/engineers

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+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 command '...'
+2. With input '...'
+3. See error
+
+**Expected Behavior**
+A clear and concise description of what you expected to happen.
+
+**Environment (please complete):**
+- OS: [e.g. Ubuntu 22.04, macOS 14, Windows 11]
+- Python version: [e.g. 3.10, 3.12]
+- deadcode version: [e.g. 0.1.1]
+
+**Additional Context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: "[FEATURE] "
+labels: enhancement
+assignees: ""
+---
+
+**Is your feature request related to a problem?**
+A clear and concise description of what the problem is.
+
+**Describe the Solution**
+A clear and concise description of what you want to happen.
+
+**Describe Alternatives**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional Context**
+Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Description
+
+<!-- Briefly describe the changes in this PR -->
+
+## Type of Change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Documentation update
+- [ ] CI/CD improvement
+- [ ] Refactoring
+- [ ] Dependency update
+
+## How Has This Been Tested?
+
+- [ ] `pytest tests/ -v` passes
+- [ ] `ruff check .` passes
+
+## Checklist
+
+- [ ] My code follows the project's style guidelines
+- [ ] I have added tests that prove my fix/feature works
+- [ ] All existing tests pass
+- [ ] I have updated documentation as needed
+
+## Related Issues
+
+<!-- Link to any related issues: Fixes #123, Closes #456 -->

.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
@@ -36,14 +36,15 @@ jobs:
         run: ruff check .
 
       - name: Run tests
-        run: python -m pytest tests/ -x -q
+        run: python -m pytest tests/ -q --cov=deadcode --cov-report=term-missing
 
   publish:
     needs: test
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
     runs-on: ubuntu-latest
     permissions:
       id-token: write
+      contents: read
 
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
@@ -62,4 +63,4 @@ jobs:
         run: python -m build
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b

AGENTS.md

@@ -0,0 +1,30 @@
+# deadcode
+
+## Purpose
+CLI tool to detect and auto-remove unused exports, dead routes, and orphaned CSS in TypeScript/React/Next.js projects.
+
+## Build & Test Commands
+- Install: `pip install -e .` or `pip install git+https://github.com/Coding-Dev-Tools/deadcode.git`
+- Test: `pytest tests/` (or `python -m pytest tests/ -v --tb=short`)
+- Lint: `ruff check src/ tests/`
+- Format: `ruff format src/ tests/`
+- Build: `pip install build twine && python -m build && twine check dist/*`
+- CLI check: `deadcode --help`
+
+## Architecture
+Key directories:
+- `src/deadcode/` — Main package (CLI, scanner, config)
+- `tests/` — Test suite
+- `.github/workflows/` — CI/CD (auto-code-review.yml, ci.yml, publish.yml)
+
+## Conventions
+- Language: Python 3.10+
+- Test framework: pytest (with coverage)
+- CI: GitHub Actions (matrix: Python 3.10, 3.11, 3.12, 3.13)
+- Linting/formatting: ruff (line-length 120, target py310)
+- Package layout: src/ layout with setuptools
+- Type checking: py.typed included
+- Dependencies: click, rich, pathspec, pyyaml
+- CLI entry point: deadcode.cli:cli
+- Default branch: master
+- Branch naming: `improve/<repo>-<timestamp>` for structural fixes

CONTRIBUTING.md

@@ -8,14 +8,15 @@ Thanks for your interest in contributing!
 2. Create a virtual environment: python -m venv .venv && source .venv/bin/activate
 3. Install dev dependencies: pip install -e ".[dev]"
 4. Run tests: pytest tests/ -v
-5. Lint: uff check src/
+5. Lint: ruff check src/
+6. Run ruff format src/ --check before committing
 
 ## Pull Requests
 
 - Fork the repo and create a feature branch
 - Add tests for any new functionality
 - Ensure all existing tests pass
-- Run uff check src/ --fix before committing
+- Run ruff check src/ --fix before committing
 - Keep PRs focused on a single change
 
 ## Reporting Issues
@@ -32,4 +33,4 @@ Thanks for your interest in contributing!
 
 ## License
 
-By contributing, you agree your work will be licensed under the same license as this project.
+By contributing, you agree your work will be licensed under the same license as this project.

README.md

@@ -76,8 +76,8 @@ deadcode stats
 - **Unused export detection** — finds functions, types, classes, interfaces, enums, and consts that are exported but never imported within your project
 - **Dead route detection** — detects unreachable page components in Next.js App Router projects
 - **Orphaned CSS detection** — finds CSS module classes that are defined but never referenced in TSX/JSX files
-- **Safe auto-removal** — `--dry-run` preview mode shows exactly what will be deleted before making changes
-- **Full-project AST analysis** — regex-based scanning covers export/import patterns, route detection, CSS class usage, and component references across your entire codebase
+- **Safe auto-removal** — `--dry-run` preview shows exactly what will be deleted first; `remove` only blanks self-contained single-line findings and skips (with a warning) anything spanning multiple lines, so it never leaves half-deleted, broken code
+- **Full-project scanning** — fast regex-based scanning covers export/import patterns, route detection, CSS class usage, and component references across your entire codebase (no AST/tree-sitter — deliberately dependency-free and quick)
 - **Monorepo support** — handles large projects efficiently with ignore patterns
 - **CI integration** — JSON output for automated pipelines and gating
 

conftest.py

@@ -1,4 +1,5 @@
 """pytest configuration — add project src to Python path."""
+
 import site
 import sys
 from pathlib import Path

package.json

@@ -1,7 +1,7 @@
 {
   "name": "deadcode-cli",
   "version": "0.1.1",
-  "description": "Find unused/dead code in Python projects. Static analysis tool to identify orphaned functions, classes, and imports.",
+  "description": "Find unused/dead code in TypeScript, React, and Next.js projects. Scans for orphaned exports, dead routes, unreferenced components, and unused CSS module classes.",
   "author": "Revenue Holdings <engineering@revenueholdings.dev>",
   "license": "MIT",
   "repository": {
@@ -38,6 +38,7 @@
   "engines": {
     "node": ">=16.0.0"
   },
+  "preferGlobal": true,
   "publishConfig": {
     "access": "public"
   }