szl-holdings/szl-cookbook

ARCHIVED duplicate/hologram. Canonical: https://github.com/szl-holdings/szl-forge

0

stars

129

commits

TypeScript

primary language

Aug 31, 2026

updated

a-11-oy.com
agentic-ai
ai
ai-governance
airgap
anthropic
compliance
defense-tech
developer-tools
doctrine-v11
dsse
engineering
examples
governance
governed-ai
recipes
skills
szl-holdings
tutorials
uds
Browse cluster: Policy-as-Code and Kubernetes Governance

README

ARCHIVED 2026-08-26. Canonical: https://github.com/szl-holdings/szl-forge (per repo description); former docs-site content consolidated into https://github.com/szl-holdings/a11oy-net. Statements below are historical, kept for provenance.

SZL Holdings · Doctrine v11 · Λ = Conjecture 1 (advisory, never "green"/theorem) · canonical a-11-oy.com

License Doctrine v11 LOCKED DOI CI Security Policy

SZL Cookbook

DEPRECATED — recipe pages migrated to szl-holdings/docs-site (published through GitHub Pages). This repo remains active only as the source of record for runnable code trees; it is not archived. See DEPRECATED.md.

The first-touch resource for using the SZL platform. Worked recipes with explicit evidence states and runnable code where the repository includes it.

Recipes · Quickstart · Products · Honesty · Cite

Doctrine v11 LOCKED Λ = Conjecture 1 SLSA L1 License: Apache 2.0 DOI

Hugging Face · GitHub Org · Canonical Cookbook

receipts.in ≡ receipts.out


What this is

The SZL Cookbook is to the SZL platform what the Anthropic Cookbook, OpenAI Cookbook, and Hugging Face Cookbook are to theirs: a library of copy-paste-able recipes that show, concretely, how to use the products. Here the products are the two SZL platforms — a11oy (the governed command platform) and killinchu (drones & vessels). Each recipe owns its evidence state; the catalog does not make a blanket live claim.

Choose your route

AudienceStart hereOwnership
DeveloperRecipes and the checked-in code treesRun code from this repository; read the maintained narrative in the canonical docs site
EvaluatorVerify a receipt end-to-endCheck the named artifact and command; do not infer results for other recipes
InvestorCanonical Cookbook and SZL evidenceUse the published route for product context and evidence boundaries

Recipe state contract

  • LIVE: an observed runtime-backed result with a named source and observation time.
  • SAMPLE: example input, configuration, or expected-output shape; safe to inspect, not runtime evidence.
  • SIMULATED: mocked or synthetic execution, including deterministic demonstrations.
  • UNAVAILABLE: the required endpoint, artifact, or dependency did not produce a usable result.

A runnable command is not proof that it was run. Historical transcripts remain historical until their source and timestamp are refreshed.

The signature first recipe — Verify a receipt end-to-end — cryptographically validates a real ECDSA-P256 DSSE signature from the public szl-lake dataset in under a minute, with zero credentials. That is the whole promise of the platform, made runnable.


⚡ Quickstart (60 seconds)

import base64, json, urllib.request
from cryptography.hazmat.primitives.asymmetric import ec
from cryptography.hazmat.primitives.asymmetric.utils import Prehashed
from cryptography.hazmat.primitives import hashes, serialization

LAKE = "https://huggingface.co/datasets/SZLHOLDINGS/szl-lake/resolve/main"
r = json.loads(urllib.request.urlopen(f"{LAKE}/khipu/a11oy_receipts.ndjson").readline())
pub = serialization.load_pem_public_key(
    urllib.request.urlopen("https://raw.githubusercontent.com/szl-holdings/.github/main/cosign.pub").read())

pub.verify(base64.b64decode(r["dsse_sig"]), bytes.fromhex(r["dsse_pae_sha256"]),
           ec.ECDSA(Prehashed(hashes.SHA256())))        # raises if invalid
print("VALID:", r["receipt_id"][:16], "signed by", r["dsse_keyid"])
# => VALID: 4c9c3f2b8d6452d9 signed by szlholdings-cosign

Full recipe: 01 — Verify a receipt end-to-end.


📖 Recipes

Each recipe has a hero hook + headline number, quickstart code, a full walkthrough, a BibTeX block, and "see also" links. Recipes marked live run against the deployed Spaces today.

#RecipeProductStatus
01Verify a receipt end-to-enda11oylive, sig verifies
02Deploy the SZL mesh UDS bundlea11oy · killinchuneeds GHCR token
03Fine-tune a customer compliance regimea11oylive
04Drone counter-UAS verdictkillinchulive
05Memory-attested reasoninga11oylive
06Verify cosign + Rekor for SLSA L1a11oy · killinchupublic Rekor
07Build your own domain packa11oyrunnable template
08Receipt knot algebra (Reidemeister R1/R2/R3)a11oyrunnable (this repo)
09PAC-Bayes confidence margina11oyrunnable (this repo)
10Cardano-anchored DSSE blood ledgera11oydemo path live; mainnet needs founder creds
11Kitaev surface drift detectionkillinchu · a11oylive
12Doctrine ledger query (749/14/163)a11oy · killinchulive
13Build a UDS bundle from scratcha11oy · killinchuneeds cluster
14Replicate the Walrus α-gap measurementkillinchulive decoders
15Air-gapped installa11oy · killinchuneeds cluster
16CALPHAD inverse-discoverya11oylive
17E8 lattice receipt verificationa11oylive
18Governed materials predictiona11oylive
19Inverse-PINN physics discoverya11oylive
20Evidence pack for auditorsa11oylive

Bonus engineering recipes (TypeScript + Lean, shipped in-repo): knot-calculus-v1 · anatomy-evolved-v1 · plus 9 claude-code skills.


🧩 The two products

SZL ships two products on one governed substrate. Each platform is composed of internal capabilities — a reasoning core (memory-attested inference), a policy gate (deny-by-default governance), and an operator console (the nervous system that drives them) — all emitting the same locked-doctrine receipts.

ProductRoleSpaceCookbook recipes
a11oy 🔬Governed command platform — reasoning + policy + operator on one receipt substrateSpace01, 02, 03, 05, 06, 07, 08, 09, 10, 12
killinchu 🦅Drones & vessels — counter-UAS Λ-gate (Remote-ID/ADS-B/MAVLink)Space04, 06, 11, 12, 13, 14

Each product exposes /v1/honest reporting the same locked doctrine.


🤝 Used by

The cookbook recipes are the customer first-touch path into the SZL platform. They are referenced from:

Adopting the cookbook in your own evaluation? Open a PR adding your project here.


🔍 Honesty policy

Every recipe shows only what actually works end-to-end against the live products. Where a step needs founder credentials or a private resource, it says so plainly:

  • Λ is Conjecture 1, not a theorem (open CAUCHY_ND sorry + missing symmetry axiom). No recipe claims otherwise.
  • Doctrine 749/14/163 is LOCKED at kernel c7c0ba17. The cookbook references these artifacts; it never changes them.
  • SLSA L1 (honest) — image signing is keyless cosign + public Rekor (recipe 06). Live-Space runtime receipt signatures are still PLACEHOLDER (Sigstore CI pending); the lake receipt used in recipe 01 carries a real signature that verifies.
  • Cardano anchoring is demo-seeded, not on-chain mainnet; testnet/mainnet submission needs founder credentials (recipe 10).
  • Telemetry (Remote-ID/ADS-B/MAVLink) is unauthenticated — decoded fields are claims, never ground truth (recipe 04).

🧪 Run the in-repo demos

# Knot calculus + PAC-Bayes (recipes 08, 09)
cd recipes/knot-calculus-v1/code && npm install && npx tsx tests/demo.ts

# Anatomy-evolved smoke tests
cd recipes/anatomy-evolved-v1/code && npm install && npm run test:smoke

📚 Cite the cookbook

@misc{szl_cookbook_2026,
  title        = {SZL Cookbook: Worked recipes for the SZL governed platform},
  author       = {{SZL Holdings}},
  year         = {2026},
  howpublished = {\url{https://github.com/szl-holdings/szl-cookbook}},
  doi          = {10.5281/zenodo.20434308},
  note         = {Doctrine v11 LOCKED 749/14/163, kernel c7c0ba17, Λ = Conjecture 1, SLSA L1 (honest).}
}

See CITATION.cff for the machine-readable citation.


Apache-2.0 · Doctrine v11 LOCKED — 749/14/163 — kernel c7c0ba17 · Λ = Conjecture 1 · SLSA L1 (honest)

Contributors

szl-holdings/szl-cookbook

ARCHIVED duplicate/hologram. Canonical: https://github.com/szl-holdings/szl-forge

0

stars

129

commits

TypeScript

primary language

Aug 31, 2026

updated

a-11-oy.com
agentic-ai
ai
ai-governance
airgap
anthropic
compliance
defense-tech
developer-tools
doctrine-v11
dsse
engineering
examples
governance
governed-ai
recipes
skills
szl-holdings
tutorials
uds
Browse cluster: Policy-as-Code and Kubernetes Governance

README

ARCHIVED 2026-08-26. Canonical: https://github.com/szl-holdings/szl-forge (per repo description); former docs-site content consolidated into https://github.com/szl-holdings/a11oy-net. Statements below are historical, kept for provenance.

SZL Holdings · Doctrine v11 · Λ = Conjecture 1 (advisory, never "green"/theorem) · canonical a-11-oy.com

License Doctrine v11 LOCKED DOI CI Security Policy

SZL Cookbook

DEPRECATED — recipe pages migrated to szl-holdings/docs-site (published through GitHub Pages). This repo remains active only as the source of record for runnable code trees; it is not archived. See DEPRECATED.md.

The first-touch resource for using the SZL platform. Worked recipes with explicit evidence states and runnable code where the repository includes it.

Recipes · Quickstart · Products · Honesty · Cite

Doctrine v11 LOCKED Λ = Conjecture 1 SLSA L1 License: Apache 2.0 DOI

Hugging Face · GitHub Org · Canonical Cookbook

receipts.in ≡ receipts.out


What this is

The SZL Cookbook is to the SZL platform what the Anthropic Cookbook, OpenAI Cookbook, and Hugging Face Cookbook are to theirs: a library of copy-paste-able recipes that show, concretely, how to use the products. Here the products are the two SZL platforms — a11oy (the governed command platform) and killinchu (drones & vessels). Each recipe owns its evidence state; the catalog does not make a blanket live claim.

Choose your route

AudienceStart hereOwnership
DeveloperRecipes and the checked-in code treesRun code from this repository; read the maintained narrative in the canonical docs site
EvaluatorVerify a receipt end-to-endCheck the named artifact and command; do not infer results for other recipes
InvestorCanonical Cookbook and SZL evidenceUse the published route for product context and evidence boundaries

Recipe state contract

  • LIVE: an observed runtime-backed result with a named source and observation time.
  • SAMPLE: example input, configuration, or expected-output shape; safe to inspect, not runtime evidence.
  • SIMULATED: mocked or synthetic execution, including deterministic demonstrations.
  • UNAVAILABLE: the required endpoint, artifact, or dependency did not produce a usable result.

A runnable command is not proof that it was run. Historical transcripts remain historical until their source and timestamp are refreshed.

The signature first recipe — Verify a receipt end-to-end — cryptographically validates a real ECDSA-P256 DSSE signature from the public szl-lake dataset in under a minute, with zero credentials. That is the whole promise of the platform, made runnable.


⚡ Quickstart (60 seconds)

import base64, json, urllib.request
from cryptography.hazmat.primitives.asymmetric import ec
from cryptography.hazmat.primitives.asymmetric.utils import Prehashed
from cryptography.hazmat.primitives import hashes, serialization

LAKE = "https://huggingface.co/datasets/SZLHOLDINGS/szl-lake/resolve/main"
r = json.loads(urllib.request.urlopen(f"{LAKE}/khipu/a11oy_receipts.ndjson").readline())
pub = serialization.load_pem_public_key(
    urllib.request.urlopen("https://raw.githubusercontent.com/szl-holdings/.github/main/cosign.pub").read())

pub.verify(base64.b64decode(r["dsse_sig"]), bytes.fromhex(r["dsse_pae_sha256"]),
           ec.ECDSA(Prehashed(hashes.SHA256())))        # raises if invalid
print("VALID:", r["receipt_id"][:16], "signed by", r["dsse_keyid"])
# => VALID: 4c9c3f2b8d6452d9 signed by szlholdings-cosign

Full recipe: 01 — Verify a receipt end-to-end.


📖 Recipes

Each recipe has a hero hook + headline number, quickstart code, a full walkthrough, a BibTeX block, and "see also" links. Recipes marked live run against the deployed Spaces today.

#RecipeProductStatus
01Verify a receipt end-to-enda11oylive, sig verifies
02Deploy the SZL mesh UDS bundlea11oy · killinchuneeds GHCR token
03Fine-tune a customer compliance regimea11oylive
04Drone counter-UAS verdictkillinchulive
05Memory-attested reasoninga11oylive
06Verify cosign + Rekor for SLSA L1a11oy · killinchupublic Rekor
07Build your own domain packa11oyrunnable template
08Receipt knot algebra (Reidemeister R1/R2/R3)a11oyrunnable (this repo)
09PAC-Bayes confidence margina11oyrunnable (this repo)
10Cardano-anchored DSSE blood ledgera11oydemo path live; mainnet needs founder creds
11Kitaev surface drift detectionkillinchu · a11oylive
12Doctrine ledger query (749/14/163)a11oy · killinchulive
13Build a UDS bundle from scratcha11oy · killinchuneeds cluster
14Replicate the Walrus α-gap measurementkillinchulive decoders
15Air-gapped installa11oy · killinchuneeds cluster
16CALPHAD inverse-discoverya11oylive
17E8 lattice receipt verificationa11oylive
18Governed materials predictiona11oylive
19Inverse-PINN physics discoverya11oylive
20Evidence pack for auditorsa11oylive

Bonus engineering recipes (TypeScript + Lean, shipped in-repo): knot-calculus-v1 · anatomy-evolved-v1 · plus 9 claude-code skills.


🧩 The two products

SZL ships two products on one governed substrate. Each platform is composed of internal capabilities — a reasoning core (memory-attested inference), a policy gate (deny-by-default governance), and an operator console (the nervous system that drives them) — all emitting the same locked-doctrine receipts.

ProductRoleSpaceCookbook recipes
a11oy 🔬Governed command platform — reasoning + policy + operator on one receipt substrateSpace01, 02, 03, 05, 06, 07, 08, 09, 10, 12
killinchu 🦅Drones & vessels — counter-UAS Λ-gate (Remote-ID/ADS-B/MAVLink)Space04, 06, 11, 12, 13, 14

Each product exposes /v1/honest reporting the same locked doctrine.


🤝 Used by

The cookbook recipes are the customer first-touch path into the SZL platform. They are referenced from:

Adopting the cookbook in your own evaluation? Open a PR adding your project here.


🔍 Honesty policy

Every recipe shows only what actually works end-to-end against the live products. Where a step needs founder credentials or a private resource, it says so plainly:

  • Λ is Conjecture 1, not a theorem (open CAUCHY_ND sorry + missing symmetry axiom). No recipe claims otherwise.
  • Doctrine 749/14/163 is LOCKED at kernel c7c0ba17. The cookbook references these artifacts; it never changes them.
  • SLSA L1 (honest) — image signing is keyless cosign + public Rekor (recipe 06). Live-Space runtime receipt signatures are still PLACEHOLDER (Sigstore CI pending); the lake receipt used in recipe 01 carries a real signature that verifies.
  • Cardano anchoring is demo-seeded, not on-chain mainnet; testnet/mainnet submission needs founder credentials (recipe 10).
  • Telemetry (Remote-ID/ADS-B/MAVLink) is unauthenticated — decoded fields are claims, never ground truth (recipe 04).

🧪 Run the in-repo demos

# Knot calculus + PAC-Bayes (recipes 08, 09)
cd recipes/knot-calculus-v1/code && npm install && npx tsx tests/demo.ts

# Anatomy-evolved smoke tests
cd recipes/anatomy-evolved-v1/code && npm install && npm run test:smoke

📚 Cite the cookbook

@misc{szl_cookbook_2026,
  title        = {SZL Cookbook: Worked recipes for the SZL governed platform},
  author       = {{SZL Holdings}},
  year         = {2026},
  howpublished = {\url{https://github.com/szl-holdings/szl-cookbook}},
  doi          = {10.5281/zenodo.20434308},
  note         = {Doctrine v11 LOCKED 749/14/163, kernel c7c0ba17, Λ = Conjecture 1, SLSA L1 (honest).}
}

See CITATION.cff for the machine-readable citation.


Apache-2.0 · Doctrine v11 LOCKED — 749/14/163 — kernel c7c0ba17 · Λ = Conjecture 1 · SLSA L1 (honest)

Contributors

Languages

TypeScript

70.2%

Shell

27.3%

Lean

2.4%