Skip to main content

Governed infrastructure-operations profile and RExecOp domain package over GovEngine and SCLite.

Project description

Tecrax

Tecrax is a governed infrastructure-operations runtime/profile built on GovEngine and SCLite.

Current published baseline: tecrax==0.3.4a0 (PyPI), depending on govengine>=0.15.0,<0.16, sclite-core>=1.0.4,<1.1, and rexecop>=0.2.5a0,<0.3.

This package provides:

  • RExecOp domain profile — bundled YAML profile with intents, workflows, connectors, and validation rules (entry point rexecop.profiles:tecrax).
  • Local fixture review — dry-run proof slice without live infrastructure.
  • Read-only host inventory profile — fixed SSH command shapes and bounded normalization for operator-configured Ubuntu inventory.
  • Verified read-only service slices — NTP synchronization over fixed SSH commands and bounded Zabbix API version health through RExecOp http_api.
  • Monitoring-host reaction pack — deterministic domain findings map only to existing read-only intents; unknown states escalate without a free-form action.

It does not execute infrastructure changes or manage credentials. Live SSH execution is performed by RExecOp only from explicit operator configuration outside this package.

Planned foundation:

Tecrax -> GovEngine -> SCLite
  • SCLite owns lifecycle/proof/review artifacts.
  • GovEngine owns deterministic governed-runtime kernel mechanics.
  • Tecrax owns the infrastructure-operations profile semantics, fixture review payloads, UX, and future host integrations when those boundaries are mature.

RExecOp profile

Install tecrax alongside rexecop to register the domain profile:

pip install rexecop tecrax
rexecop profile list

The profile root is exposed via tecrax:profile_root (directory src/tecrax/profile/).

Deterministic reactions

Tecrax owns the monitoring vocabulary and rules in src/tecrax/profile/reactions/reaction_pack.yaml. Build a canonical observation from a bounded diagnose_monitoring_host result, then pass it to RExecOp:

tecrax reaction-observation \
  --input diagnosis.json \
  --operation op-source \
  --target monitoring-host-01 > observation.json

rexecop reaction-plan \
  --profile tecrax \
  --env /path/outside/repo/environment.yaml \
  --observation observation.json \
  --target monitoring-host-01

The first release is deliberately read-only. It can re-run bounded host inventory, NTP, or Zabbix checks; a healthy observation is no_op, and an unclassified state is escalate. RExecOp owns deterministic mechanics and lifecycle, GovEngine owns admission, and SCLite owns the evidence chain.

Local fixture proof

tecrax fixture-review --service demo-web

The command emits a public-safe fixture review payload. It uses GovEngine profile/planning/supervision/runtime-review contracts and binds its fixture receipt through an SCLite artifact descriptor. It has no live runner, host inventory, credential path, or infrastructure adapter.

The 0.3.3-alpha line adds the profile-owned read-only reaction pack over RExecOp 0.2.5a0 and SCLite 1.0.4. It does not add a second policy engine, lifecycle runner, or truth layer.

Validation

python scripts/validate_public_truth.py
python -m pytest -q

The validator keeps this package as a second-host proof surface only. Any future infrastructure runner, inventory, credential, scheduler, or carrier-adapter claim must be backed by code and tests before it becomes public truth.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tecrax-0.3.4a0.tar.gz (23.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tecrax-0.3.4a0-py3-none-any.whl (24.2 kB view details)

Uploaded Python 3

File details

Details for the file tecrax-0.3.4a0.tar.gz.

File metadata

  • Download URL: tecrax-0.3.4a0.tar.gz
  • Upload date:
  • Size: 23.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for tecrax-0.3.4a0.tar.gz
Algorithm Hash digest
SHA256 261b9426d814c5c80d9198d2399a83644734aef4643ea0a3bfd203337bed4794
MD5 c5f92ab160c55d202f98176fc0fdecc6
BLAKE2b-256 9fbbf4a00fecad214f89a467a4c9cdffb3978de33b62a4a4cfd475155fe7ebc0

See more details on using hashes here.

File details

Details for the file tecrax-0.3.4a0-py3-none-any.whl.

File metadata

  • Download URL: tecrax-0.3.4a0-py3-none-any.whl
  • Upload date:
  • Size: 24.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for tecrax-0.3.4a0-py3-none-any.whl
Algorithm Hash digest
SHA256 f01a07f5a38ded687a6ab0a5bf40929b56652860be1b0e1150a246ecd30c11c6
MD5 3d5b716ad536243f4af0bc3d04f9e1a2
BLAKE2b-256 ae2254e9d2b5ba7fea0d92361a54345112b1636c5d1ba045ac720b88f0c1a12d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page