Skip to content

README.md

Latest commit

 

History

History
74 lines (45 loc) · 3.46 KB

README.md

File metadata and controls

74 lines (45 loc) · 3.46 KB
Raw

English · Русский · Português do Brasil

aset-python-sqlite

A minimal, non-normative Python + SQLite reference implementation conforming to the implementation-neutral ASET Seed Compatibility Standard.

Status

  • NORMATIVE=false
  • PRODUCTION_READY=false
  • Profile: ASET-PYTHON-SQLITE-REFERENCE-V1
  • Conformance target: ASET-SEED-COMPATIBILITY-STANDARD@seed-0.3.0-alpha.3
  • Seed release: seed-0.3.0-alpha.3
  • Seed commit: 633c130187b2a2bb42f24cfd66662d475de385d2
  • Canon package: sha256:c5d48a418466ea7a60fccb7161adbd5ad568174bbc9a28fc03fd7e6e77955d31
  • Conformance Kit: sha256:5ecf9b93377a062b8772b4b4b44b4d76a0997d8ba98e8711e717456abbe583db
  • Mandatory conformance: 25/25
  • Semantic authority: the externally pinned ASET machine-readable canon
  • Implementation precedence: none

Python and SQLite do not define ASET. The implementation is bound to the exact released Seed through canon.lock.json, executable external conformance, and runtime database metadata. A database created for another Seed identity is rejected rather than silently migrated.

Implemented Seed surface

The semantic kernel implements only the released minimal resolution surface:

  • REGISTER_REQUEST
  • SUBMIT_RESOLUTION
  • EVALUATE_RESOLUTION
  • derived results UNKNOWN, ALLOW, BLOCK

The SQLite profile adds durability, serialized writers, hash-chained operation audit, integrity checks and backup. These are implementation-profile properties, not Seed semantics. The runtime does not perform application-specific external effects when a resolution is ALLOW.

Install

python -m venv .venv
. .venv/bin/activate
python -m pip install -e .

Test against the exact ASET Seed

For local development, an exact ASET checkout or an extracted official Conformance Kit can be supplied:

python tools/profile_gate.py --canon-root ../ASET

CI downloads the immutable seed-0.3.0-alpha.3 Compatibility Standard release assets and verifies the locked Conformance Kit SHA-256 before running conformance. The specification-owned external runner invokes python -m aset_python_sqlite.adapter and determines the conformance verdict. The adapter never declares itself conformant.

Runtime example

Create a database with an explicit initial Seed store:

aset-python-sqlite --database seed.db init --store initial-store.json

Execute a Seed operation:

aset-python-sqlite --database seed.db execute --operation operation.json

Inspect the derived result without mutating Seed state:

aset-python-sqlite --database seed.db evaluate res.1

Show the exact Seed binding compiled into the implementation:

aset-python-sqlite binding

Release assurance

python tools/profile_gate.py --canon-root ../ASET verifies repository manifest parity, profile traceability, the exact Seed lock, specification-owned external conformance, deterministic source-archive construction, wheel construction and isolated black-box runtime checks.

A release must not be published unless PYTHON_SQLITE_PROFILE_GATE=PASS and BLACKBOX_RELEASE_AUDIT=PASS.

Rights and licence

Licensed under Apache License 2.0. Copyright and authorship remain with Dzmitry Prychyna unless expressly assigned in writing. See LICENSE, NOTICE, ORIGIN.json, BACKGROUND_IP_NOTICE.md, AUTHORS.md and TRADEMARKS.md.