Metadata-Version: 2.4
Name: szl-frontier-control-plane
Version: 0.6.0
Summary: Evidence-first Hugging Face frontier release intelligence for SZL Holdings
Author: SZL Holdings
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/szl-holdings/szl-frontier
Project-URL: Source, https://github.com/szl-holdings/szl-frontier
Project-URL: Issues, https://github.com/szl-holdings/szl-frontier/issues
Project-URL: Changelog, https://github.com/szl-holdings/szl-frontier/releases
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Provides-Extra: test
Dynamic: license-file

---
title: "SZL Frontier"
emoji: "🧭"
colorFrom: gray
colorTo: yellow
sdk: docker
app_port: 7860
pinned: true
license: apache-2.0
short_description: "Memory Covenant v0.3 — deny-by-default governed memory plane"
tags:
  - governance
  - agentic-ai
  - doctrine-v11
  - a11oy
  - memory-covenant
  - apache-2.0
szl:
  source_repo: szl-holdings/szl-frontier
  proof_url: https://github.com/szl-holdings/szl-frontier
  lifecycle: EVALUATION
---

<!-- 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. -->
<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>

<p><small>Orbit v2 artwork © SZL Holdings · <a href="https://github.com/szl-holdings/szl-brand/blob/4309f6fce89179331b0b3ed8c99494e76c5be256/kit/LICENSE">CC BY 4.0</a>. The SZL name and mark remain trademarks; source-code and data licenses remain as declared.</small></p>

# SZL Frontier

Explore a governed memory plane with explicit source, policy and receipt boundaries.

**Artifact:** Memory and frontier orchestration application · **Software:** OPERATIONAL · **Stage:** Production HOLD

[Open Frontier](https://huggingface.co/spaces/SZLHOLDINGS/szl-frontier) · [Build](https://github.com/szl-holdings/szl-frontier) · [Source identity](https://szlholdings-szl-frontier.hf.space/deployment.json) · [Proof registry](https://a11oy.net)

## Before you use it

- The demo uses software gates and simulated read-only intel; those are not Lean proofs or operational intelligence.
- Retrieval indexes are not model weights, and approval cannot lift a hard deny.
- The source defines 24 software release gates in `src/lib/covenant/gates.ts`: g1–g10 in round 1, g11–g15 in round 2, g16–g20 in round 3 and g21–g24 in round 4. In the retained table below, "20/20" is the total for rounds 1–3, not round 1 alone.

## Verify from source

Node 22 and Python 3.11 or newer; CI uses Python 3.12. From a clone:

```bash
npm ci
npm run typecheck
npm test
node scripts/generate-frontier-release-manifest.mjs --check
PYTHONPATH=python python3 -m unittest discover -s python/tests
python3 -m unittest discover -s tools -p 'test_*.py'
npm run build
```

`npm test` runs every `scripts/**/*.test.mjs` file, then the TypeScript unit tests. Three brand-check tests pin platform prompt files that are not part of this repository, so they report a skip that names them. The CI `verify` job also runs the suites in `python/payload` and `python/wave5`.

The Python control plane is the package `szl-frontier-control-plane` with the CLI `szl-frontier`. It reads the committed manifest, register and skill files, so install it from the clone and run it from the repository root:

```bash
python3 -m pip install -e '.[test]'
szl-frontier list --min-score 70
```

Outside a checkout the CLI starts, but commands that need committed files exit 2 with a refusal. Point them at the files instead, for example `szl-frontier --manifest PATH list`.

<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 -->

> **SZL Holdings** · Doctrine v11 · Λ = Conjecture 1 (never a theorem) · canonical [a-11-oy.com](https://a-11-oy.com)

# SZL Frontier

Governed memory plane and frontier orchestrator. Deny by default. Every write, recall, ingest, model route, intel tasking, and action is sealed as a receipt. Approval cannot lift a hard deny.

This repository is **source** for the Memory Covenant organ. It is not a second a11oy flagship. Product origin remains [a-11-oy.com](https://a-11-oy.com). Proof registry remains [a11oy.net](https://a11oy.net).

## Yachay · second brain (v0.4)

Fold of [szl-holdings/szl-second-brain](https://github.com/szl-holdings/szl-second-brain) into this organ. **Not a second flagship.**

| Claim | Status |
|---|---|
| Public projection | **575 chunks loaded** (SOFTWARE) |
| Navigator | **NAVIGATE or ABSTAIN** — never invents a nodeId |
| Pulse | **LIVE** while the plane is open (citation frequency, not weights) |
| Learning traces | Sealed through the Memory Covenant every fifth pulse |
| Private 9464-node graph | **Unpublished · 0 admitted to gradients** |
| Index is model weights | **false** |
| LIVE retrieval | **Never fabricated** |

Query `private 9464-node graph` and it **ABSTAINS**. That is the brain working.

Round 4 software gates (g21–g24) are part of the 24/24 set.

| Round | What | Result |
|---|---|---|
| 1 | Memory Covenant isolation, tombstones, provenance, injection quarantine, derived index | **20/20 software gates** |
| 2 | Ingest, intel approval, embedding-generation isolation | **held** |
| 3 | Controlled actions + adversary campaign; hard denials hold under approval | **held** |

These are **software release tests**, not Lean locked-8. Λ uniqueness remains **Conjecture 1**.

## Invariant

**No memory enters or leaves an agent context without identity, purpose, policy evaluation, provenance, lifecycle, and a sealed receipt.**

Default effect is deny. vxdb is a **derived index role**, not the system of record. The live demo uses a deterministic lexhash embedder (`szl-lexhash-v1`). It does not claim a running vxdb server.

## Honest posture

| Claim | Status |
|---|---|
| Deny-by-default Memory Gateway | **LIVE** (in-process covenant engine) |
| SHA-256 receipt chain | **LIVE** |
| Cross-tenant isolation | **LIVE** (software gates) |
| Human approval for bounded ingest/action | **LIVE** |
| Hard deny: recon / foreign-write / weaponize | **LIVE** — approval cannot lift |
| Shadowbroker | **Simulated read-only connector** — no packets, no targeting |
| vxdb 0.5.1 embedded | **ROLE / REFERENCE** — not a live server in this tree |
| Lean locked-8 | **Does not apply here** — see [lutar-lean](https://github.com/szl-holdings/lutar-lean) |
| Λ | **Conjecture 1** |
| FedRAMP / ATO | **Not claimed** |

## Sequence

1. Memory plane
2. Governed ingest
3. Model registry (embedding generations do not mix)
4. Read-only intel connector
5. Controlled action adapter
6. Continuous adversarial governance tests

## Five superpowers

1. Governed recall
2. Provenance seal
3. Tenant / domain isolation
4. Derived reindex
5. Human-gated action (approval ≠ escalation)

## Run

```bash
npm ci
npm run typecheck
npm run build
npm run dev
```

Hugging Face Space builds this tree with the root `Dockerfile` on port **7860**.

The offline [`research` validator](docs/RESEARCH_VALIDATOR.md) checks model-proposed
experiments against exact local evidence and a clean source revision. It emits
evaluation-only results and never authorizes a release.

## Pins

| Pin | Value |
|---|---|
| Product origin | [a-11-oy.com](https://a-11-oy.com) |
| Proof registry | [a11oy.net](https://a11oy.net) |
| Source | [szl-holdings/szl-frontier](https://github.com/szl-holdings/szl-frontier) (writes this Space and the covenant dataset) |
| Doctrine | v11 LOCKED |
| Λ | Conjecture 1 (OPEN) |
| Kernel | `c7c0ba17` (lutar-lean; not re-proven here) |
| License | Apache-2.0 |
| Hugging Face | [SZLHOLDINGS/szl-frontier](https://huggingface.co/spaces/SZLHOLDINGS/szl-frontier) |

## Estate

The [outside-seat verifier](docs/ESTATE_OUTSIDE_SEAT.md) records public estate
metadata, pinned upstream artifacts, card contradictions and source-age findings.
Its offline controls run in required CI; its nightly observer preserves receipts
and raw response evidence even when estate findings fail the run. Observation
does not change the production HOLD.

Source: [szl-holdings/szl-frontier](https://github.com/szl-holdings/szl-frontier) · [a11oy](https://github.com/szl-holdings/a11oy) · [immune](https://github.com/szl-holdings/immune) · [lutar-lean](https://github.com/szl-holdings/lutar-lean) · [🤗 SZLHOLDINGS](https://huggingface.co/SZLHOLDINGS)

---

<sub>SZL Holdings · Doctrine v11 · Λ = Conjecture 1 · not a second flagship · no production ATO · trust never 100%</sub>

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

</details>
