README.org

#+TITLE: Nekomata 猫又
#+SUBTITLE: Infrastructure that rewrites itself.
#+AUTHOR: Ahmad Ali Parr × SnapKitty Collective
#+LICENSE: AGPL-3.0

* What is Nekomata?

Nekomata is the first AI-native container engine built from first principles.
Not a Kubernetes alternative. A Kubernetes replacement.

The Nekomata (猫又) is a supernatural cat with two tails: code and data.
In Common Lisp, these are the same thing. Infrastructure is code.
Code is alive. It evaluates. It transforms. It rewrites itself.

* Why not Kubernetes?

Kubernetes was designed in 2014, before LLMs, before sparse MoEs,
before we understood that code should be data. It is a YAML configuration
engine running on a distributed key-value store. It is 50B of technical
debt masquerading as infrastructure.

* First Principles

| Kubernetes Assumption        | Nekomata First Principle              |
|------------------------------+---------------------------------------|
| Infrastructure is YAML       | Infrastructure is s-expressions       |
| Monolithic control plane     | Sparse mixture of experts             |
| Immutable containers         | Live REPL injection                   |
| Reactive watch loops         | Predictive LLM→ASM compilation        |
| Networking is afterthought   | Regex mathematics at socket layer     |

* Quick Start

#+BEGIN_SRC lisp
(ql:quickload :nekod)
(nekod:nekomata-main)
#+END_SRC

* Container DSL

Infrastructure expressed as s-expressions. A container is a Lisp form.
It evaluates. It transforms. It rewrites itself.

#+BEGIN_SRC lisp
(nekod:define-container my-app
  :image "nginx:latest"
  :ports '((8080 . 80))
  :env '((:NODE_ENV . "production"))
  :restart-policy :always)
#+END_SRC

* Self-Healing with Failover Chains

#+BEGIN_SRC lisp
(nekod:with-failover my-app my-app-replica my-app-standby)
#+END_SRC

* Repo Layout

#+BEGIN_EXAMPLE
nekod/
├── nekod.asd          ← ASDF system definition
├── core/
│   ├── package.lisp      ← Package definitions
│   ├── conditions.lisp   ← Error hierarchy + restarts
│   ├── sexpr-infra.lisp  ← Container DSL macros + JSON serialization
│   ├── eval-loop.lisp    ← Nekomata REPL
│   ├── image-persist.lisp← State snapshot save/restore
│   └── nekomata.lisp     ← Top-level entry point + registry
└── docker/
    ├── unix-sock.lisp    ← Raw Unix socket interface
    ├── protocol.lisp     ← HTTP/1.1-over-Unix encoder/decoder
    ├── container.lisp    ← Container lifecycle (create/start/stop/kill/list)
    ├── image.lisp        ← Image management (pull/list/tag/prune)
    ├── network.lisp      ← Network management (create/connect/disconnect)
    ├── volume.lisp       ← Volume management (create/mount/prune)
    └── inspect.lisp      ← Container and stats inspection
#+END_EXAMPLE

* License

AGPL-3.0 — Free to use, modify, and distribute.
Cloud providers who SaaS-ify this must contribute back.
This is the poison pill.