layer-scan 0.1.0__tar.gz

layer_scan-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,57 @@
+name: Bug Report
+description: Report a bug in layer-scan
+labels: [bug]
+body:
+  - type: input
+    id: version
+    attributes:
+      label: layer-scan version
+      description: Output of `layer-scan version`
+      placeholder: "0.1.0"
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      description: Output of `python --version`
+      placeholder: "3.12.0"
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      placeholder: "Ubuntu 22.04 / Windows 11 / macOS 14"
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps to trigger the bug
+      placeholder: |
+        1. Install layer-scan
+        2. Run `layer-scan scan --model ...`
+        3. See error
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What you expected to happen
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: What actually happened (include error messages / tracebacks)
+    validations:
+      required: true
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      description: Model name, backend, GPU info, or anything else relevant

layer_scan-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,23 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: usecase
+    attributes:
+      label: Use case
+      description: What problem does this solve? Who benefits?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: How should it work? Include CLI examples if applicable.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches you considered and why they don't work

layer_scan-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,23 @@
+## Type
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactoring
+- [ ] Documentation
+- [ ] CI/CD
+
+## Summary
+
+<!-- Brief description of what this PR does -->
+
+## Test plan
+
+- [ ] New tests added / existing tests updated
+- [ ] `pytest -m smoke` passes
+- [ ] `pytest -m "not slow"` passes
+- [ ] `ruff check .` passes
+
+## Documentation
+
+- [ ] README updated (if user-facing change)
+- [ ] CHANGELOG updated

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

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install ruff
+      - run: ruff check .
+
+  smoke:
+    runs-on: ubuntu-latest
+    needs: lint
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]"
+      - run: pytest -m smoke -v
+
+  test:
+    runs-on: ubuntu-latest
+    needs: smoke
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest --cov --cov-report=xml -m "not slow" -v
+      - uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.12'
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false

layer_scan-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install hatch
+      - run: hatch build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: build
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

layer_scan-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.ruff_cache/
+results/
+*.html
+!README.md
+.venv/
+venv/
+.env
+.coverage
+htmlcov/

layer_scan-0.1.0/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project 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).
+
+## [0.1.0] - 2026-03-11
+
+### Added
+
+- Core scanning engine with configurable (i, j) layer duplication
+- Logit distribution scoring (deterministic, no sampling)
+- Three built-in probes: math, eq (emotional intelligence), json (format compliance)
+- Custom probe support via JSON files
+- Two inference backends: HuggingFace Transformers and ExLlamaV2
+- Interactive Plotly HTML heatmap visualization
+- mergekit passthrough YAML export (`--export-mergekit`)
+- Sparse-first two-pass scanning (`--sparse-first`)
+- CLI with `scan`, `probes`, and `version` commands
+- Input validation for ScanConfig parameters
+- Comprehensive test suite (smoke, black-box, white-box, boundary, stress)
+- CI/CD with GitHub Actions (lint, test, PyPI publish)

layer_scan-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,40 @@
+# 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, caste, color, 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 sexual attention or advances
+* Trolling, insulting or 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
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers. All complaints will be reviewed and
+investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.1, available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.

layer_scan-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,64 @@
+# Contributing to layer-scan
+
+Thank you for your interest in contributing!
+
+## Development setup
+
+```bash
+git clone https://github.com/layer-scan/layer-scan.git
+cd layer-scan
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Running tests
+
+```bash
+# Smoke tests (fast, <10s)
+pytest -m smoke
+
+# All tests except slow
+pytest -m "not slow"
+
+# Full suite including stress tests
+pytest
+
+# With coverage
+pytest --cov --cov-report=term-missing
+```
+
+## Code style
+
+We use [Ruff](https://docs.astral.sh/ruff/) for linting and formatting:
+
+```bash
+ruff check .
+ruff format .
+```
+
+Configuration is in `pyproject.toml` (target: Python 3.10, line length: 100).
+
+## Pull request process
+
+1. Fork the repo and create a feature branch
+2. Write tests first (TDD encouraged)
+3. Ensure `ruff check .` passes
+4. Ensure `pytest -m "not slow"` passes
+5. Update CHANGELOG.md under `[Unreleased]`
+6. Open a PR with the provided template
+
+## Adding a new probe
+
+1. Create `src/layer_scan/probes/your_probe.py`
+2. Subclass `Probe` from `layer_scan.probes.base`
+3. Implement `name`, `description`, `get_samples()`, `get_score_token_ids()`
+4. Register in `cli.py` `_load_probe()` builtin_probes dict
+5. Add tests in `tests/test_probes.py`
+
+## Adding a new backend
+
+1. Create `src/layer_scan/backends/your_backend.py`
+2. Subclass `Backend` from `layer_scan.backends.base`
+3. Implement `load()`, `get_total_layers()`, `get_tokenizer()`, `forward_with_duplication()`
+4. Register in `cli.py` `_load_backend()`
+5. Add tests in `tests/test_backends.py`

layer_scan-0.1.0/LICENSE

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

layer_scan-0.1.0/NOTICE

@@ -0,0 +1,14 @@
+Copyright (c) 2026 XXO47OXX
+Licensed under MIT License
+
+Original Design & First Published: 2026-03-11
+Provenance Identifier: LS-XXO47OXX-a3f7c9e1-2026
+
+This project is the original implementation of:
+- Logit distribution scoring for layer duplication evaluation (no sampling, deterministic)
+- Full (i,j) configuration space automatic scanning for RYS-style layer duplication
+- Task-specific probe system with cross-probe heatmap comparison
+- One-click mergekit passthrough YAML export from scan results
+
+If you fork or create derivative works, please retain this NOTICE file
+and attribute the original repository: https://github.com/XXO47OXX/layer-scan