Sync with GitHub, license metadata from LICENSE files, commercial license notice
Browse filesmetadata license: None -> apache-2.0
README: License section kept (already accurate)
README: GitHub source link added
README.md
CHANGED
|
@@ -1,139 +1,147 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
| 19 |
-
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
|
| 26 |
-
|
| 27 |
-
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
|
| 32 |
-
|
| 33 |
-
|
| 34 |
-
|
| 35 |
-
|
| 36 |
-
|
| 37 |
-
|
| 38 |
-
|
| 39 |
-
|
| 40 |
-
|
| 41 |
-
- **
|
| 42 |
-
|
| 43 |
-
|
| 44 |
-
|
| 45 |
-
|
| 46 |
-
``
|
| 47 |
-
|
| 48 |
-
|
| 49 |
-
|
| 50 |
-
|
| 51 |
-
|
| 52 |
-
|
| 53 |
-
|
| 54 |
-
|
| 55 |
-
|
| 56 |
-
|
| 57 |
-
│ ├──
|
| 58 |
-
│
|
| 59 |
-
|
| 60 |
-
├──
|
| 61 |
-
│ ├──
|
| 62 |
-
│
|
| 63 |
-
|
| 64 |
-
│
|
| 65 |
-
├──
|
| 66 |
-
├──
|
| 67 |
-
|
| 68 |
-
├──
|
| 69 |
-
├──
|
| 70 |
-
├──
|
| 71 |
-
├──
|
| 72 |
-
└──
|
| 73 |
-
|
| 74 |
-
|
| 75 |
-
#
|
| 76 |
-
|
| 77 |
-
|
| 78 |
-
|
| 79 |
-
|
| 80 |
-
|
| 81 |
-
|
| 82 |
-
|
| 83 |
-
|
| 84 |
-
|
| 85 |
-
|
| 86 |
-
|
| 87 |
-
|
| 88 |
-
|
| 89 |
-
|
| 90 |
-
|
| 91 |
-
|
| 92 |
-
|
| 93 |
-
|
| 94 |
-
|
| 95 |
-
|
| 96 |
-
|
| 97 |
-
```
|
| 98 |
-
|
| 99 |
-
|
| 100 |
-
|
| 101 |
-
|
| 102 |
-
|
| 103 |
-
|
| 104 |
-
|
| 105 |
-
|
| 106 |
-
#
|
| 107 |
-
|
| 108 |
-
#
|
| 109 |
-
|
| 110 |
-
|
| 111 |
-
|
| 112 |
-
|
| 113 |
-
|
| 114 |
-
|
| 115 |
-
|
| 116 |
-
|
| 117 |
-
|
| 118 |
-
|
| 119 |
-
|
| 120 |
-
|
| 121 |
-
|
| 122 |
-
|
| 123 |
-
|
| 124 |
-
|
| 125 |
-
|
| 126 |
-
|
| 127 |
-
|
| 128 |
-
|
| 129 |
-
|
| 130 |
-
|
|
| 131 |
-
|
|
| 132 |
-
| `
|
| 133 |
-
| `
|
| 134 |
-
| `
|
| 135 |
-
| `
|
| 136 |
-
|
| 137 |
-
|
| 138 |
-
|
| 139 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
tags:
|
| 4 |
+
- snapkitty
|
| 5 |
+
---
|
| 6 |
+
|
| 7 |
+
> Source: [github.com/SNAPKITTYWEST/agentos](https://github.com/SNAPKITTYWEST/agentos)
|
| 8 |
+
|
| 9 |
+
# AGENTOS
|
| 10 |
+
|
| 11 |
+
**SOVEREIGN COMPUTE ORCHESTRATION HOST — THE SUBSTRATE THAT HOLDS THE SWARM TOGETHER.**
|
| 12 |
+
|
| 13 |
+
`agentos` is the production repository for the SnapKitty Agent OS: the packaging, runtime,
|
| 14 |
+
policy, and CI fabric that wraps the constellation of sovereign-compute repos. It hosts the
|
| 15 |
+
**Sovereign Daemon** (Go), the **agentos-frontend** (Next.js operator console), **Nix**
|
| 16 |
+
reproducible build modules, **Prolog** trust/policy gates, SBOM + WORM verification scripts,
|
| 17 |
+
and the GitHub Actions pipelines that gate every merge. The `AGENTS.md` in this repo is the
|
| 18 |
+
canonical articulation of the Agent OS philosophy — inverted skills memory, the P/NP swarm,
|
| 19 |
+
and the Bifrost WORM trust root.
|
| 20 |
+
|
| 21 |
+
## OVERVIEW
|
| 22 |
+
|
| 23 |
+
| Aspect | Value |
|
| 24 |
+
|--------|-------|
|
| 25 |
+
| Operator | Ahmad Ali Parr · SnapKitty Collective |
|
| 26 |
+
| Trust Root | Bifrost WORM Chain (audit `4b565498-9afc-4782-af4a-c6b11a5d0058`) |
|
| 27 |
+
| Logic Layer | TypeScript / WASM (deterministic, verifiable) |
|
| 28 |
+
| Solving Model | P/NP Swarm — claim → solve → submit → verify → converge |
|
| 29 |
+
| License | Apache-2.0 |
|
| 30 |
+
|
| 31 |
+
## WHAT IT IS
|
| 32 |
+
|
| 33 |
+
`agentos` is **not** an agent framework — it is the repo-as-substrate. Every other SnapKitty
|
| 34 |
+
repo (resonance-math, qec-discovery, math-skills, prism-skills, axiom-proof, …) is a solver
|
| 35 |
+
node that plugs into this constellation. This repo supplies the shared infrastructure:
|
| 36 |
+
|
| 37 |
+
- **Sovereign Daemon** (`src/sovereign-daemon`, Go) — a lightweight service exposing
|
| 38 |
+
`/v1/env/validate`, `/v1/pipeline/execute`, `/v1/artifact/sign`, `/v1/daemon/status`, and
|
| 39 |
+
model-catalog endpoints (`/v1/ollama/models`, `/v1/vllm/models`) over a Unix socket and
|
| 40 |
+
localhost `:8080`. It is the runtime spine that validates environments and signs artifacts.
|
| 41 |
+
- **agentos-frontend** (Next.js 14 + React 18 + Tailwind) — the operator console that renders
|
| 42 |
+
the sovereign state, memory buckets, and swarm status to humans.
|
| 43 |
+
- **Nix modules** (`nix/`) — reproducible packaging: `bifrost.nix`, `daemon.nix`,
|
| 44 |
+
`prolog.nix`, `gitbash-meta.nix`, the `sovereign-overlay.nix`, and the
|
| 45 |
+
`snapkitty-daemon` / `snapkitty-installer` packages.
|
| 46 |
+
- **Prolog policies** (`policies/`) — executable trust + supply-chain gates:
|
| 47 |
+
`trust_deed.pl` (who is trusted), `snapkitty_bom.pl` (the Bill of Materials module that
|
| 48 |
+
emits JSON for the MSYS2/MinGW/swi-prolog runtime), and `pipeline_policy.pl`.
|
| 49 |
+
- **Scripts** (`scripts/`) — `build-all.sh`, `generate-sbom.sh`, `verify-worm.sh`.
|
| 50 |
+
- **Workflows** (`workflows/`) — `verify.yml`, `extract.yml`, `pnp_verify.yml`, `audit.yml`.
|
| 51 |
+
|
| 52 |
+
## ARCHITECTURE / COMPONENTS
|
| 53 |
+
|
| 54 |
+
```
|
| 55 |
+
agentos/
|
| 56 |
+
├── src/sovereign-daemon/ # Go daemon: env validate, pipeline execute, artifact sign, model catalogs
|
| 57 |
+
│ ├── main.go # HTTP + unix-socket server, /v1/* endpoints
|
| 58 |
+
│ └── go.mod
|
| 59 |
+
├── agentos-frontend/ # Next.js 14 operator console (React 18, Tailwind 3, TS 5)
|
| 60 |
+
│ ├── pages/index.html
|
| 61 |
+
│ ├── app/ css/ js/ data/ # UI source, metadata.json
|
| 62 |
+
│ └── package.json
|
| 63 |
+
├── nix/ # Reproducible Nix packaging
|
| 64 |
+
│ ├── lib/bom.nix
|
| 65 |
+
│ ├── modules/{bifrost,daemon,prolog,gitbash-meta}.nix
|
| 66 |
+
│ ├── overlays/sovereign-overlay.nix
|
| 67 |
+
│ └── packages/{snapkitty-daemon,snapkitty-installer}/default.nix
|
| 68 |
+
├── policies/ # Prolog trust + supply-chain gates
|
| 69 |
+
│ ├── trust_deed.pl # deed_trusted/1 facts
|
| 70 |
+
│ ├── snapkitty_bom.pl # SWI-Prolog BoM module → JSON
|
| 71 |
+
│ ├── pipeline_policy.pl
|
| 72 |
+
│ └── metadata.json
|
| 73 |
+
├── scripts/ # build-all.sh, generate-sbom.sh, verify-worm.sh
|
| 74 |
+
├── docs/ # Generated static docs (html/js/css)
|
| 75 |
+
├── dotfiles/ # .bashrc.d + home dotfiles for sovereign env
|
| 76 |
+
├── tests/agentos.test.mjs # Node test suite (plasma gate, skills, pnp verifier)
|
| 77 |
+
├── workflows/ # verify / extract / pnp_verify / audit CI
|
| 78 |
+
├── AGENTS.md # Canonical Agent OS spec (P/NP swarm, inverted skills)
|
| 79 |
+
├── package.json # npm scripts: verify:all, context:bootstrap, pnp:*
|
| 80 |
+
└── LICENSE # Apache-2.0
|
| 81 |
+
```
|
| 82 |
+
|
| 83 |
+
## HOW IT FITS THE CONSTELLATION
|
| 84 |
+
|
| 85 |
+
`agentos` is the **trust + delivery core** of the sovereign-compute constellation:
|
| 86 |
+
|
| 87 |
+
- **Bifrost WORM Chain** — the audit anchor (`4b565498…`) that every sealed artifact,
|
| 88 |
+
memory bucket, and theorem references. `scripts/verify-worm.sh` expresses the WORM
|
| 89 |
+
verification contract this repo enforces across sibling repos.
|
| 90 |
+
- **Plasma Gate / Ed25519** — `verify:plasma` and the test suite assert the Ed25519-enforced
|
| 91 |
+
gate before any artifact is trusted; `metadata.json` files across the org carry
|
| 92 |
+
`"plasma_gate": "Ed25519_Enforced"`.
|
| 93 |
+
- **P/NP Swarm** — `pnp_verify.yml` runs the P-time verifier over any `solution_pool` push.
|
| 94 |
+
Agents claim problems, compute NP-hard witnesses, and the repo verifies in deterministic
|
| 95 |
+
P-time before a problem converges and the universe-sum advances.
|
| 96 |
+
- **Inverted Skills Memory** — the `AGENTS.md` defines skills as sealed GitBucket memories
|
| 97 |
+
with a `verifyFn`, not code; the test suite (`tests/agentos.test.mjs`) exercises
|
| 98 |
+
`loadSkill`, `verifySkills`, and the ledger/borrow skills.
|
| 99 |
+
- **3-witness verification** — trust is established by Plasma Gate (Ed25519) + P/NP
|
| 100 |
+
verifier + skill seal. `Ω ← TRUST ∧ CODE`: a node is trustworthy only when the
|
| 101 |
+
cryptographic gate and the verified code agree.
|
| 102 |
+
|
| 103 |
+
## BUILD / USAGE / INSTALL
|
| 104 |
+
|
| 105 |
+
```bash
|
| 106 |
+
# Node tooling (verification gates, context, swarm client)
|
| 107 |
+
npm ci
|
| 108 |
+
npm test # agentos.test.mjs — plasma gate, skills, pnp verifier
|
| 109 |
+
npm run verify:all # plasma + pnp + skills + apl/fortran source checks
|
| 110 |
+
npm run context:bootstrap # load GitBucket memories into local index
|
| 111 |
+
|
| 112 |
+
# Sovereign Daemon (Go)
|
| 113 |
+
cd src/sovereign-daemon && go run . serve --socket /run/user/1000/snapkitty.sock
|
| 114 |
+
# → listens on unix socket + http://localhost:8080 (env validate, pipeline, sign, status)
|
| 115 |
+
|
| 116 |
+
# Frontend console (Next.js 14)
|
| 117 |
+
cd agentos-frontend && npm install && npm run dev # http://localhost:3000
|
| 118 |
+
|
| 119 |
+
# Reproducible Nix build
|
| 120 |
+
nix build .#snapkitty-daemon
|
| 121 |
+
nix build .#snapkitty-installer
|
| 122 |
+
|
| 123 |
+
# Supply chain + WORM
|
| 124 |
+
bash scripts/generate-sbom.sh
|
| 125 |
+
bash scripts/verify-worm.sh
|
| 126 |
+
```
|
| 127 |
+
|
| 128 |
+
## KEY FILES REFERENCE
|
| 129 |
+
|
| 130 |
+
| File | Purpose |
|
| 131 |
+
|------|---------|
|
| 132 |
+
| `src/sovereign-daemon/main.go` | Sovereign Daemon: `/v1/*` endpoints, env/pipeline/sign/status + model catalogs |
|
| 133 |
+
| `agentos-frontend/package.json` | Next.js 14 operator console dependency set |
|
| 134 |
+
| `nix/modules/bifrost.nix` | Bifrost WORM trust-root Nix module |
|
| 135 |
+
| `nix/modules/daemon.nix` | Daemon packaging module |
|
| 136 |
+
| `policies/snapkitty_bom.pl` | SWI-Prolog Bill-of-Materials module → JSON |
|
| 137 |
+
| `policies/trust_deed.pl` | Trusted-operator/deed facts for the pipeline gate |
|
| 138 |
+
| `scripts/verify-worm.sh` | WORM chain append-only verification contract |
|
| 139 |
+
| `workflows/verify.yml` | CI: npm ci → test → verify:all on push/PR |
|
| 140 |
+
| `workflows/pnp_verify.yml` | CI: P-time verification of P/NP solution pool pushes |
|
| 141 |
+
| `workflows/audit.yml` | Scheduled full audit (build + verify:all + bootstrap) |
|
| 142 |
+
| `AGENTS.md` | Canonical SnapKitty Agent OS spec (P/NP swarm, inverted skills) |
|
| 143 |
+
| `package.json` | npm scripts: `verify:all`, `context:*`, `pnp:*`, `swarm` |
|
| 144 |
+
|
| 145 |
+
## LICENSE
|
| 146 |
+
|
| 147 |
+
Apache-2.0. Authored by Ahmad Ali Parr · SnapKitty Collective · the-49th-call SNAPKITTYWEST · 2026.
|