Full framework overhaul: 100% parity + open-source packaging

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,50 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Run command '...'
+3. See error
+
+**Expected behavior**: What you expected to happen
+
+**Actual behavior**: What actually happened
+
+## Environment
+
+- **Python version**: [e.g., 3.10.0]
+- **DevArch version**: [e.g., 0.2.0]
+- **Operating system**: [e.g., macOS 14.0, Ubuntu 22.04]
+- **Git version**: [e.g., 2.40.0]
+
+## Error Messages
+
+If applicable, paste the full error message or traceback:
+
+```
+[paste error here]
+```
+
+## Context
+
+Additional context about the problem:
+
+- [ ] I've searched for similar issues
+- [ ] I've checked the documentation
+- [ ] I'm able to reproduce this consistently
+
+## Additional Information
+
+Any other relevant information, screenshots, or files that help explain the problem.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://github.com/Pastorsimon1798/devarch-framework/blob/main/README.md
+    about: Check the documentation for usage guides and examples
+  - name: Contributing Guide
+    url: https://github.com/Pastorsimon1798/devarch-framework/blob/main/CONTRIBUTING.md
+    about: Learn how to contribute to DevArch Framework

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,47 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+
+A clear and concise description of the feature you'd like to see added.
+
+## Use Case
+
+Describe the problem or use case this feature would solve. Why would this be useful?
+
+**Example**: "When analyzing repositories with X, I need Y so that Z"
+
+## Proposed Solution
+
+How do you envision this feature working? Include:
+
+- User interface or CLI changes
+- Configuration options (if any)
+- Expected behavior
+- Edge cases to consider
+
+## Alternatives
+
+What alternative solutions have you considered? Why wouldn't they work as well?
+
+## Impact
+
+Who would benefit from this feature and how?
+
+## Priority
+
+How important is this feature to you?
+
+- [ ] Critical (blocking my work)
+- [ ] High (really need this)
+- [ ] Medium (nice to have)
+- [ ] Low (minor enhancement)
+
+## Additional Context
+
+Any other relevant information, examples, or mockups.

.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run tests
+      run: |
+        pytest -v
+
+    - name: Run demo (basic smoke test)
+      run: |
+        devarch demo --force --build-db
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Check Python syntax
+      run: |
+        python -m py_compile archaeology/*.py
+        python -m py_compile archaeology/**/*.py
+      continue-on-error: true

.gitignore

@@ -0,0 +1,102 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS-specific
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Project-specific
+*.db
+*.db-shm
+*.db-wal
+*.sqlite
+*.sqlite3
+
+# Exceptions: keep demo database
+!projects/demo-project/output/*.db
+!projects/demo-project/output/*.sqlite
+
+# oh-my-claudecode state
+.omc/
+
+# Claude Code state
+.claude/
+
+# Temporary files
+*.tmp
+*.bak
+*.log
+*.cache
+
+# Analysis outputs (keep source, ignore generated)
+projects/*/output/
+!projects/*/output/.gitkeep

CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to DevArch Framework will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-05-03
+
+### Added
+- **Complete CLI** with 19 commands for full archaeology workflow
+- **6 Analysis Vectors**: SDLC Gap Finder, ML Pattern Mapper, Agentic Workflow Analyzer, Formal Terms Mapper, Source Archaeologist, YouTube Correlator
+- **Era System**: Detect and track distinct phases in repository evolution
+  - Era scanner with semantic pattern matching
+  - Era cascade for propagating labels across files
+  - Era mapper for visualizing era boundaries
+- **Signal Detection**: 5 heuristics for identifying noteworthy patterns
+  - Temporal gaps in commit activity
+  - Velocity shifts in development pace
+  - Author changes and collaboration patterns
+  - Scope changes in file modifications
+  - External data correlations
+- **Audit System**: Severity-based validation (CRITICAL, HIGH, MEDIUM, LOW)
+- **Multi-Project Sync**: Aggregate findings across multiple repositories
+- **Visualization**: Template-based HTML report generation
+- **Demo Generation**: Create synthetic projects for testing
+- **Database Inspection**: Datasette integration for interactive exploration
+- **Supplementary Data**: Correlate external data (fitness, YouTube, calendar)
+- **Local Pipeline**: Inspect GitHub Actions pipelines locally
+- **Public Case Study**: Export sanitized versions for sharing
+
+### Changed
+- Improved error handling throughout the CLI
+- Enhanced database schema for better query performance
+- Updated analysis vector templates for consistency
+
+### Fixed
+- Era detection false positives in semantic scanning
+- Signal detection edge cases for sparse repositories
+- Database migration issues between versions
+
+## [0.1.0] - 2026-04-XX
+
+### Added
+- Initial release
+- Basic git history mining
+- SQLite database storage
+- Signal detection framework
+- Analysis vector system
+- CLI scaffolding
+
+[Unreleased]: https://github.com/Pastorsimon1798/devarch-framework/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/Pastorsimon1798/devarch-framework/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/Pastorsimon1798/devarch-framework/releases/tag/v0.1.0