srmech 0.1.0__tar.gz

srmech-0.1.0/.gitignore

@@ -0,0 +1,140 @@
+# PlatformIO
+.pio/
+.vscode/
+.vscode/.browse.c_cpp.db*
+.vscode/c_cpp_properties.json
+.vscode/launch.json
+
+# Build outputs
+build/
+build_output.log
+
+# MkDocs build output (mlehaptics docs site)
+/site/
+
+# ESP-IDF
+sdkconfig
+sdkconfig.old
+sdkconfig.defaults
+
+# ESP-IDF Component Manager
+managed_components/
+dependencies.lock
+
+# Editor files
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+.pytest_cache/
+.venv/
+
+# Temporary files
+*.tmp
+*.bak
+*.log
+
+# Documentation build outputs
+docs/_build/
+docs/html/
+docs/latex/
+
+# Google Drive sync files
+.tmp.driveupload
+.tmp.drivedownload
+
+# Windows
+Thumbs.db
+desktop.ini
+
+# Claude Code
+.claude/
+nul
+
+# Temporary source files
+temp_*.c
+
+# serial logs
+serial_log*.txt
+
+# freecad backup
+*.FCBak
+
+
+
+
+src/CMakeLists.txt
+
+docs/chess-maths/stockfish/
+docs/chess-maths/.pgn_cache/
+docs/antikythera-maths/research/_cache/
+docs/chess-maths/**/*.7z
+docs/chess-maths/results/*_logs/
+docs/chess-maths/results/delta_sigma_*/
+docs/chess-maths/results/*/
+docs/othello-maths/edax*/
+
+# antikythera-maths skyfield ephemeris cache (de421.bsp ~15MB; downloaded on demand)
+docs/antikythera-maths/skyfield_data/
+
+# Large .spectralz binaries that exceed GitHub file-size limits
+# (keep smaller corpora like barcelona.spectralz, wc2005.spectralz;
+# regenerate the big ones on demand via `othello_spectral.cli encode-pgn`).
+docs/othello-maths/results/all2025.spectralz
+docs/othello-maths/results/apr2026.spectralz
+
+# Generated C encoder table header (regenerate via
+# `python -m othello_spectral.codegen.emit_c_tables`).
+docs/othello-maths/research/othello_spectral/c_encoder/include/othello_spectral_tables.h
+
+# Compiled C encoder (rebuild via clang invocation in c_encoder/README.md)
+docs/othello-maths/research/othello_spectral/c_encoder/encode_cli
+docs/othello-maths/research/othello_spectral/c_encoder/encode_cli.exe
+
+# Compiled C encoder DLL (rebuild via clang -shared per c_encoder/README.md)
+docs/othello-maths/research/othello_spectral/c_encoder/othello_spectral.dll
+docs/othello-maths/research/othello_spectral/c_encoder/othello_spectral.so
+docs/othello-maths/research/othello_spectral/c_encoder/othello_spectral.dylib
+
+# Windows import library from clang -shared (alongside .dll)
+docs/othello-maths/research/othello_spectral/c_encoder/othello_spectral.lib
+
+# Process stdout logs from background runs (regenerate by rerunning)
+docs/othello-maths/results/*_log.txt
+
+# Windows import lib from encode_cli.exe build
+docs/othello-maths/research/othello_spectral/c_encoder/encode_cli.lib
+*.bsp
+
+*.bsp.download
+skyfield_data/
+
+# ephemerides-spectral native C build output (rebuild via `cmake --build
+# ../build` then `cp ../build/ephemerides_spectral.dll
+# ephemerides_spectral/_native/`). Per-platform; not portable; not
+# shipped in source.
+docs/antikythera-maths/ephemerides-spectral/python/ephemerides_spectral/_native/
+
+# linuxdoom-1.10 build artifacts and CVS metadata (vendored from 1997
+# id Software cvsroot; per-platform .o files should not be tracked).
+docs/antikythera-maths/doom-spectral/source/linuxdoom-1.10/linux/*.o
+docs/antikythera-maths/doom-spectral/source/linuxdoom-1.10/linux/linuxxdoom
+docs/antikythera-maths/doom-spectral/source/linuxdoom-1.10/CVS/
+docs/antikythera-maths/doom-spectral/source/ipx/CVS/
+docs/antikythera-maths/doom-spectral/source/sersrc/CVS/
+docs/antikythera-maths/doom-spectral/source/sndserv/CVS/
+
+# Datasets downloaded from external repositories (Dryad, etc.) — fetched on
+# demand by scripts/fetch_*.py; not redistributed in this repo.
+/data/
+
+# Per-run logs from spike scripts.
+/logs/
+*.o

srmech-0.1.0/CHANGELOG.md

@@ -0,0 +1,29 @@
+# srmech changelog
+
+All notable changes to this package will be documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this package uses semantic versioning.
+
+## [Unreleased]
+
+## [0.1.0] - 2026-05-13
+
+### Added
+
+- **Initial extract of the AMSC framework from `ephemerides-spectral`** as part of Task #197 (AMSC-to-srmech refactor, Phase 2). The framework lives under `srmech.amsc.*`:
+  - `srmech.amsc.format` — Mathematical Provenance Record (MPR) v1 format: `MPRRecord` dataclass, NDJSON streaming IO (`read_ndjson` / `write_ndjson`), `validate_mpr_record`, `sha256_bytes`, schema-version + mandatory-field constants.
+  - `srmech.amsc.descriptor` — descriptor TOML loader: `Descriptor`, `load_descriptor`, `discover_descriptors`, `render_template` (deliberately minimal name-substitution + Python format-spec; no Jinja), `descriptor_hash` (canonical-serialised), `DescriptorValidationError`.
+  - `srmech.amsc.catalog` — universal bridge surface: `list_attested_sources` (with `adapter_class` filter), `get_attested_dataset` (paginated, T0+T1+T2+T3 tiered), `get_attested_descriptor`, `attestation_audit`, `iter_attested_dataset`, T2 local-kernel overlay (`use_local_kernel` / `clear_local_kernel` / `get_local_kernel_state`).
+  - `srmech.amsc.gap_suggester` — schema-gap-driven trigger (`suggest_gap_collections`); the lazy-imported classifier + probe sources are ephemerides-specific and remain in ephemerides-spectral.
+  - `srmech.amsc.adapters` — six adapter modules: `html_scraper`, `json_api`, `csv_bulk`, `netcdf_grid` (stub), `geotiff_bbox` (stub), `literature_curated`; plus `_base.py` (`ADAPTERS` registry, `attest`, `parser_rule_hash`, `run` composer).
+- **`register_attested_root(path, *, source)`** — the load-bearing cross-package API added in `srmech.amsc.catalog`. Downstream packages whose catalog SSOTs live outside `srmech/amsc/attested/` push their roots at package-import time; subsequent `_descriptors()` calls enumerate the union of srmech's own root + all registered roots in registration order. Conflict policy: first-registered wins with a warning.
+- **`list_registered_roots()`** — introspection of currently-registered roots (srmech's own + every external). Used by tests and diagnostic output.
+- **`srmech/amsc/attested/`** — empty SSOT subtree reserved for future srmech-primary catalogs (e.g. the `citations_curated` catalog planned for Spike #23).
+- **CI workflows** under `.github/workflows/`:
+  - `srmech-ci.yml` — pytest on push/PR against `docs/srmech/python/**`, 4-cell matrix (Ubuntu/macOS/Windows × Py3.12 + Ubuntu × Py3.10 floor).
+  - `srmech-publish.yml` — build sdist + py3-none-any wheel on `srmech-v*` tag, publish to PyPI via trusted OIDC; manual workflow_dispatch can target TestPyPI.
+  - `srmech-autotag.yml` — autotag on `pyproject.toml` version bump.
+
+### Notes
+
+- **Phase 2 is purely additive.** No ephemerides-spectral files are touched. Phase 3 (separate PR, not yet open) will rewire ephemerides-spectral's bridge to import from `srmech.amsc.*`; the byte-identical-wheel parity gate from the Phase 1 scope document applies there, not here.
+- **Cross-package gap_suggester deviation.** `srmech.amsc.gap_suggester.suggest_gap_collections()` lazy-imports `.dynamical_regime_catalog` and `.dynamical_regime_probes_data`, which are ephemerides-specific and not shipped by srmech. Calling the function from a context where those modules aren't reachable (e.g. srmech in isolation, no ephemerides installed) will raise `ImportError` at call time. The Phase 1 scope did not flag this; ephemerides-spectral consumers (the only known caller) are unaffected because the relative imports resolve inside ephemerides's `_research/` mirror until Phase 3, then via Phase 3's import-swap.
+- **`parser_version` stamp.** Changed from `"ephemerides-spectral X.Y.Z"` to `"srmech X.Y.Z"` in T3 live-fetch attestation blocks: srmech is now the parser. Committed NDJSON files retain whatever `parser_version` was stamped at collection time; only future T3 runs differ. No effect on the Phase 3 wheel parity gate (T3 is runtime, not committed bytes).

srmech-0.1.0/LICENSE

@@ -0,0 +1,63 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose

srmech-0.1.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: srmech
+Version: 0.1.0
+Summary: Spectral-resonance mechanism research package: home of the Attested Multi-Source Collector (AMSC) framework — Mathematical Provenance Record v1 on-disk format, descriptor TOML loader, six adapters (html/json/csv/netcdf/geotiff/literature), universal catalog bridge with register_attested_root cross-package overlay, and schema-gap-driven trigger. Pure Python.
+Project-URL: Homepage, https://github.com/lemonforest/mlehaptics/tree/main/docs/srmech/python
+Project-URL: Repository, https://github.com/lemonforest/mlehaptics
+Project-URL: Issues, https://github.com/lemonforest/mlehaptics/issues
+Project-URL: Changelog, https://github.com/lemonforest/mlehaptics/blob/main/docs/srmech/python/CHANGELOG.md
+Project-URL: Research notebook, https://github.com/lemonforest/mlehaptics/blob/main/docs/srmech/srmech_research_notebook.md
+Author: Steven Kirkland
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Keywords: attested,ground-proof,mechanism,ndjson,provenance,research,spectral-resonance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Provides-Extra: collectors
+Requires-Dist: beautifulsoup4>=4.11; extra == 'collectors'
+Requires-Dist: requests>=2.28; extra == 'collectors'
+Provides-Extra: dev
+Requires-Dist: beautifulsoup4>=4.11; extra == 'dev'
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: hatchling>=1.18; extra == 'dev'
+Requires-Dist: jsonschema>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: requests>=2.28; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: tests
+Requires-Dist: pytest>=7.0; extra == 'tests'
+Provides-Extra: validation
+Requires-Dist: jsonschema>=4.0; extra == 'validation'
+Description-Content-Type: text/markdown
+
+# srmech
+
+**Status:** v0.1.0 (Phase 2 bootstrap — Task #197 of the AMSC-to-srmech refactor)
+
+`srmech` (spectral-resonance mechanism) is a research package. As of v0.1.0 it ships the **Attested Multi-Source Collector (AMSC) framework** — the Mathematical Provenance Record (MPR) v1 on-disk format, descriptor TOML loader, six fetch/parse adapters, and a universal catalog bridge surface that downstream packages register their own catalog SSOTs with at import time.
+
+The package was extracted from `ephemerides-spectral`'s `_research/` mirror in Task #197 so that other spectral-research packages can consume the AMSC framework without depending on ephemerides-spectral. The catalog SSOTs themselves do NOT migrate — each downstream package registers its own root via `srmech.amsc.catalog.register_attested_root(path, source=...)`.
+
+## Public API
+
+```python
+from srmech.amsc import (
+    MPRRecord, MPR_SCHEMA_VERSION, read_ndjson, write_ndjson, sha256_bytes,
+    Descriptor, load_descriptor, discover_descriptors, render_template, descriptor_hash,
+    list_attested_sources, get_attested_dataset, get_attested_descriptor,
+    attestation_audit, register_attested_root, list_registered_roots,
+    use_local_kernel, clear_local_kernel, get_local_kernel_state,
+)
+```
+
+## Cross-package catalog registration
+
+The load-bearing API for cross-package use:
+
+```python
+from pathlib import Path
+from srmech.amsc import catalog as _amsc_catalog
+
+_amsc_catalog.register_attested_root(
+    Path(__file__).resolve().parent / "_research" / "attested",
+    source="ephemerides-spectral",
+)
+```
+
+Call this once at package-import time. Subsequent `list_attested_sources()`, `get_attested_dataset()`, etc. enumerate the union of srmech's own `amsc/attested/` plus every registered root, in registration order. Duplicate `source_key` resolves first-registered-wins with a warning.
+
+## Adapter classes
+
+Six adapters cover the realistic source space:
+
+| adapter | class | network? |
+|---|---|---|
+| `html_scraper` | fetched | yes (BeautifulSoup) |
+| `json_api` | fetched | yes (paginated JSON) |
+| `csv_bulk` | fetched | yes (CSV/XYZ bulk) |
+| `netcdf_grid` | fetched | stub (gated behind extras) |
+| `geotiff_bbox` | fetched | stub (gated behind extras) |
+| `literature_curated` | curated | no (NDJSON committed directly) |
+
+The `curated` class never touches the network: rows are committed as data-only NDJSON and srmech synthesises full MPR attestation blocks at read time from each row's per-row DOI.
+
+## Install
+
+```bash
+pip install srmech                  # core (no jsonschema, no network adapters)
+pip install srmech[validation]      # adds jsonschema for strict data-block validation
+pip install srmech[collectors]      # adds requests + beautifulsoup4 for fetched adapters
+pip install srmech[dev]             # everything
+```
+
+## License
+
+GPL-3.0-or-later. See [LICENSE](LICENSE).

srmech-0.1.0/README.md

@@ -0,0 +1,63 @@
+# srmech
+
+**Status:** v0.1.0 (Phase 2 bootstrap — Task #197 of the AMSC-to-srmech refactor)
+
+`srmech` (spectral-resonance mechanism) is a research package. As of v0.1.0 it ships the **Attested Multi-Source Collector (AMSC) framework** — the Mathematical Provenance Record (MPR) v1 on-disk format, descriptor TOML loader, six fetch/parse adapters, and a universal catalog bridge surface that downstream packages register their own catalog SSOTs with at import time.
+
+The package was extracted from `ephemerides-spectral`'s `_research/` mirror in Task #197 so that other spectral-research packages can consume the AMSC framework without depending on ephemerides-spectral. The catalog SSOTs themselves do NOT migrate — each downstream package registers its own root via `srmech.amsc.catalog.register_attested_root(path, source=...)`.
+
+## Public API
+
+```python
+from srmech.amsc import (
+    MPRRecord, MPR_SCHEMA_VERSION, read_ndjson, write_ndjson, sha256_bytes,
+    Descriptor, load_descriptor, discover_descriptors, render_template, descriptor_hash,
+    list_attested_sources, get_attested_dataset, get_attested_descriptor,
+    attestation_audit, register_attested_root, list_registered_roots,
+    use_local_kernel, clear_local_kernel, get_local_kernel_state,
+)
+```
+
+## Cross-package catalog registration
+
+The load-bearing API for cross-package use:
+
+```python
+from pathlib import Path
+from srmech.amsc import catalog as _amsc_catalog
+
+_amsc_catalog.register_attested_root(
+    Path(__file__).resolve().parent / "_research" / "attested",
+    source="ephemerides-spectral",
+)
+```
+
+Call this once at package-import time. Subsequent `list_attested_sources()`, `get_attested_dataset()`, etc. enumerate the union of srmech's own `amsc/attested/` plus every registered root, in registration order. Duplicate `source_key` resolves first-registered-wins with a warning.
+
+## Adapter classes
+
+Six adapters cover the realistic source space:
+
+| adapter | class | network? |
+|---|---|---|
+| `html_scraper` | fetched | yes (BeautifulSoup) |
+| `json_api` | fetched | yes (paginated JSON) |
+| `csv_bulk` | fetched | yes (CSV/XYZ bulk) |
+| `netcdf_grid` | fetched | stub (gated behind extras) |
+| `geotiff_bbox` | fetched | stub (gated behind extras) |
+| `literature_curated` | curated | no (NDJSON committed directly) |
+
+The `curated` class never touches the network: rows are committed as data-only NDJSON and srmech synthesises full MPR attestation blocks at read time from each row's per-row DOI.
+
+## Install
+
+```bash
+pip install srmech                  # core (no jsonschema, no network adapters)
+pip install srmech[validation]      # adds jsonschema for strict data-block validation
+pip install srmech[collectors]      # adds requests + beautifulsoup4 for fetched adapters
+pip install srmech[dev]             # everything
+```
+
+## License
+
+GPL-3.0-or-later. See [LICENSE](LICENSE).

srmech-0.1.0/pyproject.toml

@@ -0,0 +1,111 @@
+# srmech — spectral-resonance mechanism research package.
+#
+# Phase 2 (Task #197) ships srmech as the new home of the Attested
+# Multi-Source Collector (AMSC) framework, previously living inside
+# ephemerides-spectral's _research/ mirror. Pure Python; no native
+# binary; one wheel (py3-none-any).
+#
+# See docs/srmech/notes/task_197_phase_1_amsc_refactor_scope_2026-05-13.md
+# (on branch refactor/amsc-to-srmech-phase-1-scope) for the design
+# document. Phase 3 (planned) rewires ephemerides-spectral's bridge
+# to import from srmech.amsc.* instead of its in-tree mirror.
+
+[build-system]
+requires = ["hatchling>=1.18"]
+build-backend = "hatchling.build"
+
+[project]
+name = "srmech"
+version = "0.1.0"
+description = "Spectral-resonance mechanism research package: home of the Attested Multi-Source Collector (AMSC) framework — Mathematical Provenance Record v1 on-disk format, descriptor TOML loader, six adapters (html/json/csv/netcdf/geotiff/literature), universal catalog bridge with register_attested_root cross-package overlay, and schema-gap-driven trigger. Pure Python."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "GPL-3.0-or-later"
+authors = [{ name = "Steven Kirkland" }]
+keywords = [
+    "spectral-resonance",
+    "mechanism",
+    "attested",
+    "provenance",
+    "ndjson",
+    "ground-proof",
+    "research",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering",
+    "Typing :: Typed",
+]
+# Runtime deps are minimal: jsonschema is optional (the format module
+# falls back to a `required`-fields-only check when jsonschema is not
+# installed). TOML parsing uses stdlib `tomllib` on Python 3.11+; the
+# 3.10 path requires `tomli` (declared as a conditional dep here).
+dependencies = [
+    "tomli>=2.0; python_version<'3.11'",
+]
+
+[project.optional-dependencies]
+# Validation extra: enables strict per-source JSON Schema checks
+# inside `validate_mpr_record` when `data_schemas` is supplied.
+validation = ["jsonschema>=4.0"]
+# Collector extra: deps needed by the `fetched`-class adapters
+# (html_scraper / json_api / csv_bulk). netcdf_grid + geotiff_bbox
+# stubs raise NotImplementedError unless their own extras are
+# installed (left as a follow-up; not blocking Phase 2).
+collectors = [
+    "requests>=2.28",
+    "beautifulsoup4>=4.11",
+]
+# Tests extra: runs srmech's own pytest suite.
+tests = ["pytest>=7.0"]
+# Dev extra: everything plus build tooling.
+dev = [
+    "pytest>=7.0",
+    "build",
+    "twine",
+    "hatchling>=1.18",
+    "jsonschema>=4.0",
+    "requests>=2.28",
+    "beautifulsoup4>=4.11",
+]
+
+[project.urls]
+Homepage = "https://github.com/lemonforest/mlehaptics/tree/main/docs/srmech/python"
+Repository = "https://github.com/lemonforest/mlehaptics"
+Issues = "https://github.com/lemonforest/mlehaptics/issues"
+Changelog = "https://github.com/lemonforest/mlehaptics/blob/main/docs/srmech/python/CHANGELOG.md"
+"Research notebook" = "https://github.com/lemonforest/mlehaptics/blob/main/docs/srmech/srmech_research_notebook.md"
+
+[tool.hatch.build.targets.wheel]
+# Include the `srmech` package directory; py.typed marker is included
+# by virtue of being inside the package.
+packages = ["srmech"]
+
+[tool.hatch.build.targets.wheel.force-include]
+# Future srmech-primary catalogs land under srmech/amsc/attested/.
+# Phase 2 ships an empty subtree (just __init__.py); Spike #23 adds
+# the first catalog. Hatchling picks up the __init__.py automatically
+# via `packages`; this force-include slot is reserved for the eventual
+# descriptor.toml + row.ndjson + row.schema.json data files that
+# packages= alone wouldn't include.
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "srmech/**",
+    "tests/**",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "pyproject.toml",
+]
+exclude = [
+    "**/__pycache__",
+    "**/*.pyc",
+]

srmech-0.1.0/srmech/__init__.py

@@ -0,0 +1,26 @@
+"""srmech — spectral-resonance mechanism research package.
+
+Phase 2 (Task #197) ships srmech as the home of the Attested
+Multi-Source Collector (AMSC) framework — previously living inside
+ephemerides-spectral's ``_research/`` mirror. The framework is the
+mechanical-provenance discipline (every ground-proof row carries
+mandatory attestation) generalised so downstream packages can
+declare their own catalog SSOTs and consume them through one universal
+bridge surface (``srmech.amsc.catalog``).
+
+The Phase 3 cutover (planned) rewires ephemerides-spectral's bridge
+to import from ``srmech.amsc.*`` instead of its in-tree mirror; the
+catalog SSOTs do NOT migrate (ephemerides's 19 catalogs stay where
+they are, registered into srmech via
+``register_attested_root(path, source=...)`` at package-import time).
+
+Public surfaces
+---------------
+* ``srmech.amsc`` — Attested Multi-Source Collector framework.
+* ``srmech.__version__`` — package version string (SSOT in
+  ``srmech.version``).
+"""
+
+from .version import __version__
+
+__all__ = ["__version__"]

srmech-0.1.0/srmech/amsc/__init__.py

@@ -0,0 +1,87 @@
+"""Attested Multi-Source Collector (AMSC) framework.
+
+The framework's modules and their public re-exports:
+
+* :mod:`srmech.amsc.format` — Mathematical Provenance Record (MPR) v1
+  on-disk format (``MPRRecord``, NDJSON IO, ``sha256_bytes``).
+* :mod:`srmech.amsc.descriptor` — descriptor TOML loader
+  (``Descriptor``, ``load_descriptor``, ``discover_descriptors``,
+  ``render_template``, ``descriptor_hash``).
+* :mod:`srmech.amsc.catalog` — universal bridge surface
+  (``list_attested_sources``, ``get_attested_dataset``,
+  ``get_attested_descriptor``, ``attestation_audit``,
+  ``register_attested_root``, T2 local-kernel overlay).
+* :mod:`srmech.amsc.gap_suggester` — schema-gap-driven trigger.
+* :mod:`srmech.amsc.adapters` — adapter implementations
+  (html_scraper, json_api, csv_bulk, netcdf_grid, geotiff_bbox,
+  literature_curated).
+
+The ergonomic re-exports below let consumers ``from srmech.amsc
+import MPRRecord, Descriptor`` etc. without reaching into each
+submodule.
+"""
+
+from __future__ import annotations
+
+from .catalog import (
+    attestation_audit,
+    clear_local_kernel,
+    get_attested_dataset,
+    get_attested_descriptor,
+    get_local_kernel_state,
+    iter_attested_dataset,
+    list_attested_sources,
+    list_registered_roots,
+    register_attested_root,
+    use_local_kernel,
+)
+from .descriptor import (
+    Descriptor,
+    DescriptorValidationError,
+    descriptor_hash,
+    discover_descriptors,
+    load_descriptor,
+    render_template,
+)
+from .format import (
+    MANDATORY_ATTESTATION_FIELDS,
+    MANDATORY_RENDERING_FIELDS,
+    MPR_SCHEMA_VERSION,
+    MPRRecord,
+    MPRValidationError,
+    read_ndjson,
+    sha256_bytes,
+    validate_mpr_record,
+    write_ndjson,
+)
+
+__all__ = [
+    # format
+    "MANDATORY_ATTESTATION_FIELDS",
+    "MANDATORY_RENDERING_FIELDS",
+    "MPR_SCHEMA_VERSION",
+    "MPRRecord",
+    "MPRValidationError",
+    "read_ndjson",
+    "sha256_bytes",
+    "validate_mpr_record",
+    "write_ndjson",
+    # descriptor
+    "Descriptor",
+    "DescriptorValidationError",
+    "descriptor_hash",
+    "discover_descriptors",
+    "load_descriptor",
+    "render_template",
+    # catalog
+    "attestation_audit",
+    "clear_local_kernel",
+    "get_attested_dataset",
+    "get_attested_descriptor",
+    "get_local_kernel_state",
+    "iter_attested_dataset",
+    "list_attested_sources",
+    "list_registered_roots",
+    "register_attested_root",
+    "use_local_kernel",
+]