mif-dal 0.1.0__tar.gz

mif_dal-0.1.0/.coveragerc

@@ -0,0 +1,9 @@
+[coverage:run]
+source = dal
+
+[coverage:report]
+exclude_lines =
+    pragma: no cover
+    if TYPE_CHECKING:
+    def __repr__
+show_missing = True

mif_dal-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,124 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  lint:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+
+    - name: Set up Python
+      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install ruff mypy
+        pip install -e ".[dev]"
+
+    - name: Lint with ruff
+      run: ruff check dal tests
+
+    - name: Type check with mypy
+      run: mypy dal
+
+  test:
+    name: Test Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run tests (without network — Kraken/Yahoo/Dukascopy require real access)
+      run: pytest tests/ -v --cov=dal --cov-report=xml --cov-report=term-missing
+
+    - name: Upload coverage
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+      uses: codecov/codecov-action@1e68e06f1dbfde0e4cefc87efeba9e4643565303  # v4
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-mif-dal
+        fail_ci_if_error: false
+      continue-on-error: true
+
+  build:
+    name: Build Distribution
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+
+    steps:
+    - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+
+    - name: Set up Python
+      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+      with:
+        python-version: '3.11'
+
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Build package
+      run: python -m build
+
+    - name: Check package
+      run: twine check dist/*
+
+    - name: Upload artifacts
+      uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882  # v4
+      with:
+        name: dist
+        path: dist/
+
+  security:
+    name: Security Check
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+
+    - name: Set up Python
+      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install safety bandit
+        pip install -e .
+
+    - name: Run safety check
+      run: safety check --json
+      continue-on-error: true
+
+    - name: Run bandit security check
+      run: bandit -r dal -ll
+      continue-on-error: true

mif_dal-0.1.0/.github/workflows/mif-dal-publish.yml

@@ -0,0 +1,31 @@
+name: Publish mif-dal to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build frontend
+        run: python -m pip install --upgrade build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # release/v1

mif_dal-0.1.0/.gitignore

@@ -0,0 +1,104 @@
+# ─── Python ──────────────────────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyd
+
+# 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
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# ─── Tests & Coverage ────────────────────────────────────────────────────────
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.ruff_cache/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ─── Nix ─────────────────────────────────────────────────────────────────────
+result
+result-*
+.direnv/
+*.nix
+*.lock
+
+# ─── Halo ─────────────────────────────────────────────────────────────────────
+halo/
+which_github.sh
+
+# ─── uv ──────────────────────────────────────────────────────────────────────
+# uv.lock est versionné — ne pas ignorer
+# .python-version peut être ignoré si géré par flake.nix
+.python-version
+
+# ─── Backups et temporaires ───────────────────────────────────────────────────
+*.bak
+*.old
+*.orig
+*.tmp
+*~
+.DS_Store
+Thumbs.db
+
+# ─── IDE ─────────────────────────────────────────────────────────────────────
+.idea/
+.vscode/
+*.swp
+*.swo
+.ropeproject
+
+# ─── Données de cache DAL ────────────────────────────────────────────────────
+# Le cache local est généré à l'exécution — ne pas versionner
+.dal_cache/
+dal_cache/
+
+# ─── Dukascopy — données téléchargées ────────────────────────────────────────
+dukascopy/data/
+*.csv.gz
+# Note : les fixtures CSV de test dans tests/ sont versionnées
+
+# ─── Secrets et credentials ──────────────────────────────────────────────────
+.env
+.env.*
+!.env.example
+*.key
+*.pem
+
+# ─── Artefacts de build PyPI ─────────────────────────────────────────────────
+dist/
+*.whl
+*.tar.gz
+
+# ─── Logs ────────────────────────────────────────────────────────────────────
+*.log
+logs/

mif_dal-0.1.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to mif-dal are documented here.
+
+## [0.1.0] — 2026-07-09
+
+### Added
+- `DALHandoff` — frozen dataclass, 15 fields, `assembly_hash`, AQI
+- Exception hierarchy: `DALError`, `DALConfigError`, `DALVersionError`,
+  `DALHandoffError`
+- `DALConfig` (cache_dir, request_timeout)
+- `pipeline.assemble_handoff()` — S3 hash + S4 DQF gate + S5 emission
+- `resolve_and_fetch()` — S1 source resolution + retry/fallback +
+  S2 completeness + AQI calculation with floor
+- `KrakenAdapter` — public REST API, OHLCV daily, PAXG/BTC
+- `YahooAdapter` — yfinance ≥ 1.3.0, MultiIndex handling
+- `DukascopyAdapter` — subprocess, detection via `--help`
+- `InMemorySource` — deterministic adapter for tests, failure simulation
+- `validate_environment.py` — GO/NO-GO for NixOS / Colab / Windows
+- `validate_dal_state.py` — GO/NO-GO 5-check script
+
+### Fixed
+- DQF has no FAIL status — mapping corrected to VOID + `case _` guard
+- AQI floor `max(0, ...)` — formula could produce negative values
+- `DALHandoff frozen=True` — `source_manifest` as `tuple`, not `list`
+- `calendar` required in `get_diagnostic_stream` (DALHandoff invariant)
+- Dukascopy detection via `--help` (not `--version` — upstream exit-1 bug)
+
+### Known issues
+- TD-008: AQI gravities (0.20/0.10/0.05/0.30) not empirically calibrated
+- TD-012: dukascopy-node PATH unstable in NixOS nix-shell (test xfail)

mif_dal-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,354 @@
+# Contributing to MIF-DAL
+
+Thank you for your interest in contributing to MIF-DAL (Data Abstraction Layer)!
+
+This document provides guidelines and best practices for contributing.
+
+---
+
+## Code of Conduct
+
+### Our Pledge
+
+We pledge to make participation in MIF-DAL a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+### Our Standards
+
+**Positive Behavior**:
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards others
+
+**Unacceptable Behavior**:
+- Harassment, trolling, or insulting comments
+- Personal or political attacks
+- Publishing others' private information
+- Other conduct inappropriate in a professional setting
+
+### Enforcement
+
+Instances of abusive behavior may be reported to the project maintainers. All complaints will be reviewed and investigated promptly and fairly.
+
+---
+
+## How Can I Contribute?
+
+### Reporting Bugs
+
+**Before Submitting**:
+1. Check existing issues
+2. Verify with latest version
+3. Gather reproduction steps
+
+**Bug Report Template**:
+```markdown
+**Environment**:
+- MIF-DAL Version: 0.1.0
+- Python Version: 3.11
+- OS: NixOS 25.11
+
+**Description**:
+Clear description of the bug.
+
+**Reproduction Steps**:
+1. Step 1
+2. Step 2
+3. Step 3
+
+**Expected Behavior**:
+What should happen.
+
+**Actual Behavior**:
+What actually happens.
+
+**Error Output**:
+```
+[Paste full error traceback]
+```
+```
+
+---
+
+### Suggesting Features
+
+**Feature Request Template**:
+```markdown
+**Problem Statement**:
+What problem does this feature solve?
+
+**Proposed Solution**:
+Describe your proposed feature.
+
+**Alternatives Considered**:
+What other solutions did you consider?
+
+**Use Case**:
+Real-world scenario where this is useful.
+```
+
+---
+
+### Submitting Pull Requests
+
+We welcome code contributions! Follow these steps:
+
+1. **Clone Repository**
+   ```bash
+   git clone git@github.com:symbioticode/mif-dal.git
+   cd mif-dal
+   ```
+
+2. **Create Branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   # or
+   git checkout -b fix/your-bug-fix
+   ```
+
+3. **Make Changes**
+   - Read `halo/project_instructions.md` first
+   - Read `halo/anamnese_state.yaml` for current project state
+   - Follow specs in `docs/DAL_SPECIFICATION_v1.0.md`
+   - Write code
+   - Add tests
+   - Update documentation
+
+4. **Test Locally**
+   ```bash
+   ./scripts/dev.sh check
+   ```
+
+5. **Commit Changes**
+   ```bash
+   git add .
+   git commit -m "feat: add amazing feature"
+   ```
+
+   Follow [Conventional Commits](https://www.conventionalcommits.org/):
+   - `feat:` New feature
+   - `fix:` Bug fix
+   - `docs:` Documentation only
+   - `test:` Adding tests
+   - `refactor:` Code refactoring
+   - `perf:` Performance improvement
+   - `chore:` Maintenance tasks
+
+6. **Push Branch**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+7. **Open Pull Request**
+   - Go to GitHub repository
+   - Click "New Pull Request"
+   - Fill out PR template
+   - Request review
+
+---
+
+## Development Setup
+
+### Requirements
+
+- Python 3.11+
+- NixOS 25.11 (recommended) or Linux with glibc
+- git
+
+### Installation
+
+```bash
+# Clone repository
+git clone git@github.com:symbioticode/mif-dal.git
+cd mif-dal
+
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate
+
+# Install in editable mode with dev dependencies
+pip install -e ".[dev]"
+
+# Verify installation
+./scripts/dev.sh check
+```
+
+### Development Tools
+
+**Installed Automatically**:
+- `pytest`: Testing framework
+- `pytest-cov`: Coverage reporting
+- `ruff`: Fast linting
+- `mypy`: Type checking
+
+**Commands**:
+```bash
+# Run all gates (ruff + mypy + pytest)
+./scripts/dev.sh check
+
+# Run tests only
+pytest tests/ -v
+
+# Run tests with coverage
+pytest tests/ --cov=dal --cov-report=html
+
+# Lint code
+ruff check dal tests scripts
+
+# Type check
+mypy dal
+```
+
+---
+
+## Pull Request Process
+
+### Before Submitting
+
+**Checklist**:
+- [ ] `./scripts/dev.sh check` passes (ruff + mypy + pytest)
+- [ ] `python scripts/adversarial_dal_check_p3.py` — 65/65 PASS
+- [ ] New tests added (if applicable)
+- [ ] Documentation updated (if applicable)
+- [ ] Commit messages follow convention
+- [ ] PR description is clear
+
+### PR Template
+
+```markdown
+## Description
+Brief description of changes.
+
+## Type of Change
+- [ ] Bug fix (non-breaking)
+- [ ] New feature (non-breaking)
+- [ ] Breaking change
+- [ ] Documentation update
+
+## Related Issues
+Fixes #123
+
+## Changes Made
+- Change 1
+- Change 2
+- Change 3
+
+## Testing
+How was this tested?
+
+## Checklist
+- [ ] dev.sh check passes
+- [ ] adversarial check 65/65
+- [ ] Code follows style guide
+- [ ] Documentation updated
+- [ ] No breaking changes (or documented)
+```
+
+### Review Process
+
+1. **Maintainer Review**: 1-3 days
+2. **Feedback**: Address comments
+3. **Approval**: At least 1 maintainer approval
+4. **Merge**: Squash and merge to main
+
+---
+
+## Coding Standards
+
+### Style Guide
+
+**Python Style**: PEP 8 + Ruff
+
+**Key Rules**:
+- Line length: 100 characters
+- Indentation: 4 spaces
+- Quotes: Double quotes for strings
+- Imports: Sorted (ruff)
+
+### Docstrings
+
+**Format**: Google Style
+
+**Required**:
+- Module docstring
+- Class docstring
+- Public method docstring
+
+### Type Hints
+
+**Required** for:
+- Function parameters
+- Function return types
+- Class attributes
+
+---
+
+## Testing Guidelines
+
+### Test Structure
+
+```
+tests/
+├── unit/                  # Unit tests (isolate components)
+│   ├── test_handoff.py
+│   ├── test_pipeline.py
+│   └── ...
+├── integration/           # Integration tests (end-to-end)
+│   ├── test_dal.py
+│   └── test_sources.py
+└── conftest.py           # Pytest fixtures
+```
+
+### Coverage Requirements
+
+- **Minimum**: 80% overall
+- **Target**: 93%+ (current baseline)
+- **Critical paths**: 100%
+
+**Check Coverage**:
+```bash
+pytest tests/ --cov=dal --cov-report=html
+```
+
+---
+
+## Documentation
+
+### Documentation Types
+
+1. **Code Documentation**: Docstrings (required)
+2. **API Reference**: `docs/API.md`
+3. **Architecture**: `docs/ARCHITECTURE.md`
+4. **Specification**: `docs/DAL_SPECIFICATION_v1.0.md`
+
+### Updating Documentation
+
+**When to Update**:
+- New feature → Add example + API docs
+- Bug fix → Update existing docs if wrong
+- Breaking change → Update all affected docs
+
+---
+
+## Project Architecture
+
+MIF-DAL follows the Metric Integrity Framework pipeline:
+
+```
+Source Adapters → Resolver → Pipeline → DALHandoff → Caller
+     (fetch)    (fallback)  (DQF gate)   (frozen)
+```
+
+Key architectural decisions are documented in `halo/anamnese_state.yaml` (section `decisions_immuables`). Do not modify them without escalation.
+
+---
+
+## Questions?
+
+- **GitHub Issues**: Report bugs, request features
+- **Email**: corail.synergia@proton.me
+
+---
+
+**Thank you for contributing to MIF-DAL!**

mif_dal-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 symbiotic code ~
+
+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.