SNAPKITTYWEST commited on
Commit
2fff7f0
·
verified ·
1 Parent(s): c5f93fc

Sync with GitHub, license metadata from LICENSE files, commercial license notice

Browse files

metadata license: None -> apache-2.0
README: License section kept (already accurate)
README: GitHub source link added

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