Skip to main content

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

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)

Source distribution for groundwork-adapter 0.1.0
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)

Table of built distributions (wheels) for groundwork-adapter 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page