Metadata-Version: 2.5
Name: szl-lyte-enterprise
Version: 4.0.0
Summary: Governed business-observability Signal Lattice
Project-URL: Homepage, https://github.com/szl-holdings/lyte-services
Project-URL: Source, https://github.com/szl-holdings/lyte-services
Project-URL: Issues, https://github.com/szl-holdings/lyte-services/issues
Project-URL: Changelog, https://github.com/szl-holdings/lyte-services/releases
Author: SZL Holdings
License: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: ai-agents,business-observability,governed-ai,observability,opentelemetry,receipts,sre
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Monitoring
Requires-Python: <3.15,>=3.12
Requires-Dist: alembic==1.20.1
Requires-Dist: fastapi==0.162.2
Requires-Dist: httpx==0.28.1
Requires-Dist: opentelemetry-api==1.45.2
Requires-Dist: opentelemetry-instrumentation-fastapi==0.66b2
Requires-Dist: opentelemetry-sdk==1.45.2
Requires-Dist: orjson==3.13.0
Requires-Dist: prometheus-client==0.26.0
Requires-Dist: psycopg[binary]==3.3.8
Requires-Dist: pydantic-settings==2.16.2
Requires-Dist: pydantic==2.14.3
Requires-Dist: pyjwt[crypto]==2.15.1
Requires-Dist: sqlalchemy==2.1.8
Requires-Dist: uvicorn[standard]==0.54.0
Provides-Extra: browser
Requires-Dist: playwright==1.64.1; extra == 'browser'
Requires-Dist: websockets==17.4; extra == 'browser'
Provides-Extra: granite
Requires-Dist: granite-tsfm==0.3.12; extra == 'granite'
Requires-Dist: pandas==3.1.1; extra == 'granite'
Requires-Dist: torch==2.11.0; extra == 'granite'
Provides-Extra: test
Requires-Dist: packaging==26.3; extra == 'test'
Requires-Dist: pytest-asyncio==1.4.1.post1; extra == 'test'
Requires-Dist: pytest-cov==7.1.0; extra == 'test'
Requires-Dist: pytest==9.2.0; extra == 'test'
Requires-Dist: pyyaml==6.0.3; extra == 'test'
Requires-Dist: ruff==0.17.4; extra == 'test'
Description-Content-Type: text/markdown

---
title: Lyte Enterprise Signal Lattice
emoji: 🔷
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: apache-2.0
suggested_hardware: cpu-basic
short_description: Governed observability for services, journeys, and AI agents
tags:
  - observability
  - business-observability
  - opentelemetry
  - ai-agents
  - sre
  - governed-ai
---

<!-- szl:header v1 -->
<!-- Native identity: szl-brand@4309f6fce89179331b0b3ed8c99494e76c5be256; Orbit v2 icon. -->
<p>
  <a href="https://github.com/szl-holdings">
    <img src="https://raw.githubusercontent.com/szl-holdings/szl-brand/4309f6fce89179331b0b3ed8c99494e76c5be256/kit/logos/orbit-v2/suite/szl-icon-32.svg" alt="SZL Holdings — Orbit v2" width="32" height="32" />
  </a>
</p>

**Control before action. Evidence after.**

[Product](https://a-11-oy.com) · [Proof](https://a11oy.net) · [GitHub organization](https://github.com/szl-holdings)
<!-- /szl:header -->

<!-- Native identity: szl-brand@4309f6fce89179331b0b3ed8c99494e76c5be256; Orbit v2 icon sha256 6e2b7d72a3af3d9602b79de41df0194ede6496a9661f057108ec224c0efc92e6. -->

# Lyte Enterprise

Explore service, delivery, cost and risk signals through an auditable evidence and decision chain.

**Artifact:** Enterprise signal application · **Stage:** Sample and real-data modes separated

[Explore in Command Lab](https://huggingface.co/spaces/SZLHOLDINGS/szl-command-lab) · [Build](https://github.com/szl-holdings/lyte-services) · [Evidence](https://github.com/szl-holdings/lyte-services/blob/a456ac76d6fb2162981669cfe297b16bfcd9322d/README.md)

## Before you use it

- The public enterprise scenario is SAMPLE / MODELED; real-data mode must not silently substitute it.
- Verify source coverage, readiness and each result’s truth label before operational use.

## Verify locally

CI and the container install complete hash-locked dependency closures
(`requirements/ci/test.txt`, `requirements/ci/runtime.txt`); the same commands
work locally on Python 3.12–3.14:

```bash
python -m venv .venv
. .venv/bin/activate   # Windows PowerShell: .venv\Scripts\Activate.ps1
python -m pip install --require-hashes --only-binary=:all: --requirement requirements/ci/test.txt
python -m pip install --no-deps --editable .
python -m pytest
LYTE_ENV=development LYTE_DEMO_MODE=true uvicorn lyte.app:app --host 127.0.0.1 --port 7860
```

Six PostgreSQL contract tests skip unless `LYTE_TEST_POSTGRES_URL` is set
(CI's `database-migrations` job sets it), and seven Granite adapter tests skip
unless pandas is installed (`requirements/ci/granite-adapter.txt`, CI's
`granite-adapter` job). Outside the container image, `/api/live`
and `/build-receipt.json` answer HTTP 503 by design: no build receipt exists
until the image build generates one, and `/readyz` reports it as
`MISSING_OPTIONAL_LOCAL`. The retained technical body below documents the
original flow with `requirements-test.txt`, which pins the same top-level
versions without hashes.

<details>
<summary>Technical details and original evidence</summary>

The retained source below is exact and may contain historical observations. Its dates, use restrictions, licenses and evidence boundaries continue to apply.

<!-- SZL-PRESERVED-TECHNICAL-BODY:START -->

# Lyte Enterprise Signal Lattice

**See what is changing. Know what it costs. Act with proof.**

Lyte connects service reliability, customer journeys, AI-agent operations,
delivery, cost, revenue, service impact, and risk to an auditable evidence and
decision chain. The public product includes a deterministic `SAMPLE / MODELED`
enterprise scenario; real-data mode never silently substitutes sample data.

## What is operational

- Service, journey, agent, incident, decision, outcome, and evidence views over
  tenant/workspace-scoped append-only PostgreSQL or local SQLite persistence.
- Explicit formulas with units, input truth labels, evidence references, and
  `UNAVAILABLE` results when required inputs are absent.
- A bounded OpenTelemetry JSON subset, signed governed events, and a read-only,
  repository-allowlisted GitHub Actions connector.
- Durable idempotency, hash-chained receipts, replay protection, Second Brain,
  Living Anatomy traces, deterministic Ask Lyte, and Hatun review.
- An original five-scene Signal Lattice with keyboard navigation, text/table
  alternatives, responsive layouts, reduced-motion, and forced-colors support.
- Exact source identity, health/readiness, Prometheus metrics, migration gates,
  a non-root container, and a vendor-neutral open benchmark harness.

## Run locally

```bash
python -m venv .venv
. .venv/bin/activate
python -m pip install --requirement requirements-test.txt --editable .
export LYTE_ENV=development
export LYTE_DEMO_MODE=true
uvicorn lyte.app:app --host 127.0.0.1 --port 7860
python -m pytest
```

Windows PowerShell activation is `.venv\\Scripts\\Activate.ps1`; use `$env:`
for environment variables. Open `http://127.0.0.1:7860` for the Signal Lattice
or `/docs` for the OpenAPI surface.

Build the exact checked-out revision:

```bash
revision="$(git rev-parse HEAD)"
docker build --build-arg "LYTE_SOURCE_REVISION=${revision}" -t "szl-lyte:${revision}" .
docker run --rm -p 7860:7860 -v lyte-data:/data "szl-lyte:${revision}"
```

The image stamps the exact 40-character source revision, generates a canonical
`/app/build-receipt.json` over the closed application payload, and runs with
`LYTE_REQUIRE_BUILD_RECEIPT=true`. Runtime readiness rehashes that payload; a
missing, malformed, stale, or source-mismatched receipt returns HTTP 503. The
receipt covers application files copied by the Dockerfile, not installed
dependency bytes or the entire OCI image. Publication evidence must separately
bind its receipt digest and provider commit to the admitted source revision.

Production requires `DATABASE_URL` with PostgreSQL plus `OIDC_ISSUER`,
`OIDC_AUDIENCE`, and `OIDC_JWKS_URL`. Run `alembic upgrade head` before the
application and set `LYTE_ENV=production`, `LYTE_DEMO_MODE=false`, and
`LYTE_DEV_AUTH_ENABLED=false`. The application then refuses SQLite, incomplete
OIDC configuration, developer credentials, implicit demo data, and unbound
deployment source identity.

Authenticated local mutations are available only when
`LYTE_DEV_AUTH_ENABLED=true` is paired with an explicit 32-character or longer
token plus `LYTE_DEV_TENANT_ID` and `LYTE_DEV_WORKSPACE_ID`. This mode is
forbidden in production.

## Public API

Operations and proof:

- `/healthz` for process liveness
- `/readyz` for fail-closed source, payload-receipt, route, database, and schema readiness
- `/api/live` for application-owned live attestation
- `/build-receipt.json` for the exact immutable application payload receipt
- `/metrics` and `/api/lyte/v2/metrics` for the application metrics registry
- `/api/build-info`, `/.well-known/szl-source.json`

Lyte v2:

- `/api/lyte/v2/catalog`, `/capabilities`, `/anatomy`, `/formulas`, `/sources`
- governed GitHub Actions, OTLP JSON subset, and signed-event ingestion
- services, journeys, outcomes, agents, incidents, decisions, and playback
- deterministic Ask Lyte, tenant-scoped Second Brain, receipts, and Hatun review
- administrator-only exact-scope provisioning with an atomic creation receipt

The fixed public `SAMPLE` scope is read-only. Every durable mutation requires a
verified tenant/workspace principal and an operator or administrator role.

## Authority and truth boundary

Hatun can return only `REVIEW`, `ABSTAIN`, or `DENY`. It cannot authorize or
execute. Formula output is advisory, Lambda remains **Conjecture 1**, production
effectors are disabled, and correlation is not causation. Raw session tokens,
bearer credentials, prompts, responses, and known sensitive telemetry values are
not persisted.

Each product value remains labeled `MEASURED`, `REPORTED`, `MODELED`, `SAMPLE`,
`ROADMAP`, or `UNAVAILABLE`. Benchmark conclusions use a separate controlled
label set and do not claim competitive superiority without like-for-like data.

Canonical source: `szl-holdings/lyte-services`. Canonical public surface:
[`SZLHOLDINGS/lyte`](https://huggingface.co/spaces/SZLHOLDINGS/lyte). Publication
flows only through the protected A11oy single writer from an exact merged source
revision; provider readiness alone is not product-operational proof.

See [`docs/enterprise/ARCHITECTURE.md`](docs/enterprise/ARCHITECTURE.md),
[`docs/enterprise/DEPLOYMENT.md`](docs/enterprise/DEPLOYMENT.md), and
[`docs/enterprise/PROOF_BEFORE_PITCH.md`](docs/enterprise/PROOF_BEFORE_PITCH.md).

<!-- SZL-PRESERVED-TECHNICAL-BODY:END -->

</details>

Estate on Hugging Face: models, datasets and Spaces are published under the [SZLHOLDINGS](https://huggingface.co/SZLHOLDINGS) org.
