Groundwork adapter
A dependency-free scientific package for one admitted kinetics template:
C(t) = A * (exp(-ke*t) - exp(-ka*t)), with hours, mg/L, positive ordered
rates, x(0)=1, and c(0)=0. Qualified native runtime: CPython 3.11.
It compares two frozen parameter vectors on a reviewed finite grid. The
numerical tier provides finite binary64 diagnostics with an exact-input boundary.
The exact tier uses a fixed rational exponential enclosure rule, freshly checks
both candidates against every included historical hard bound, and applies the
strict margin abs(p1-p2)-e1-e2-2*eta > 0. Its certificate is specific to this
analytic template. It is not a general ODE checker or a global design optimizer.
Two matching candidates and an explicit positive future hard allowance are required. A checked time can rule out fitting both selected choices; a datum can exclude either or both. None of this establishes physical truth, instrument precision, the entire compatible parameter set, or the original interval claim.
Install and check
From the repository root, using CPython 3.11:
python3 -m pip install --no-deps ./packages/groundwork_adapter
python3 -m unittest discover -s packages/groundwork_adapter/tests -v
python3 -m groundwork_adapter capabilities
For source-only development, prefix commands with
PYTHONPATH=packages/groundwork_adapter. Build tooling is separate from the
zero-dependency runtime. No network, account, numerical solver, or provider SDK
is required for scientific work or replay.
Run and replay the complete synthetic example
All supplied examples are synthetic. Their workflow IDs are fixture IDs, not real approvals. The backend must validate real approval and operation scope.
python3 -m groundwork_adapter run \
packages/groundwork_adapter/fixtures/checked_success.request.json \
--anchors packages/groundwork_adapter/fixtures/checked_success.anchors.json \
--output /tmp/groundwork-example.bundle.json
python3 -m groundwork_adapter replay /tmp/groundwork-example.bundle.json \
--anchors packages/groundwork_adapter/fixtures/checked_success.anchors.json
The output destination must not already exist. Anchors are separate expected
identities supplied by the caller; for real review, obtain them through a trusted
channel. Replacing both a packet and its anchor does not prove authorship or
honest data collection. A source-version mismatch returns unsupported_runtime:
prepare the recorded package version, rather than importing anything named by
the artifact. Missing evidence returns incomplete_export.
run supports fresh candidate construction from a request file. Python callers
can also supply bounded artifact bytes to reuse an existing matching pair. A
numerical-only bundle can pass record-integrity checks but returns scientific
replay unsupported; it never receives an exact badge.
Python integration
from groundwork_adapter import create_suggestion, normalize_problem, normalize_design
problem = normalize_problem(reviewed_problem_projection)
design = normalize_design(frozen_design_projection, problem)
bundle_bytes = create_suggestion(
problem.to_payload(), design.to_payload(),
expected_problem_digest=approved_problem_digest,
expected_design_digest=approved_design_digest,
workflow={"plan_id": plan_id, "approval_id": approval_id,
"operation_id": operation_id, "execution_id": execution_id},
)
These are package-local scientific projections, not competing application transport DTOs. Owner 2 maintains the shared transport schema, authorization, durable records and hard process supervision. The adapter supplies cooperative cancellation and cannot authorize work. Publish a checked report and its complete bytes atomically. Owner 3 consumes typed tiers and the fixed interpretation selector; browser replay remains unavailable. Owner 4 qualifies deployment.
The problem identity includes row order, excluded rows, notes and provenance.
The design identity includes candidate vectors/IDs/artifact associations, grid,
allowance and origin, policies and limits. New values normalize to reduced n/d.
The bundle identity excludes only its named top-level suggestion_digest field.
Raw artifact SHA-256 hashes remain separate from DB-SC-1 semantic identities.
Evidence and release
- Scientific integration contract
- Exact analytic argument
- Automated second-reader review
- Executed fixture ledger
- Validation and publishing handoff
Regenerate fixtures after any package code change:
python3 packages/groundwork_adapter/scripts/generate_fixtures.py
The partial fixture uses a deterministic cancellation callback; rerunning its request through the CLI without that callback produces a new completed result. Timing strings in the fixture ledger are observations, not latency guarantees. The release is intentionally narrow: no provider calls, browser verification, application routes, equipment control, or hosting are included.
Metadata
Release files for groundwork-adapter 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| groundwork_adapter-0.1.0.tar.gz | 79.3 kB | Without provenance | Details for groundwork_adapter-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| groundwork_adapter-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for groundwork_adapter-0.1.0-py3-none-any.whl |
Total release size: 118.0 kB
Release files / groundwork_adapter-0.1.0.tar.gz
| Download URL | groundwork_adapter-0.1.0.tar.gz |
|---|---|
| Size | 79.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dbe709e86446bbd21d092aba3ebd295ea608def65d1e2f0af6942772dfa9b001
|
|
BLAKE2b-256 checksum How to use checksums |
248e5a442b191f8676e7853e71cb42e2bc81d5571aa8d7622325f92b2b82d463
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.17
|
Release files / groundwork_adapter-0.1.0-py3-none-any.whl
| Download URL | groundwork_adapter-0.1.0-py3-none-any.whl |
|---|---|
| Size | 38.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a61742583c8c1e8fdf99c721f92059f2bcdf568c1761fe7cd865a2ead65c7c71
|
|
BLAKE2b-256 checksum How to use checksums |
a4cad51d101bc0a0298ed158eb2caa3d7d3b0ae8f8b2481f371217e6ca104caa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.17
|
Security for groundwork-adapter 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.