# llama.cpp upstream assumptions

This directory records the reproducible source dependency boundary for the
pinned llama.cpp checkout used by the distributed GGUF runtime program.

Pinned upstream commit:

- `b3c9d1b846cc80a6360adb6aeaa4fcd8c4c8dcac`

Pinned upstream repository:

- `https://github.com/ggml-org/llama.cpp.git`

Assumptions checked by the build script:

- The checkout is exactly the pinned commit above.
- The upstream source tree still ships `LICENSE`, `AUTHORS`, and
  `CMakeLists.txt` at the repository root.
- The project-owned worker scaffold is built from
  `examples/meshnet-worker/`, which is introduced by the patch stack below.
- The upstream license and attribution notices are preserved in the build
  output by copying the root `LICENSE` and `AUTHORS` files into the worker
  staging directory.

Compatibility notes:

- The current patch stack does not modify upstream llama.cpp runtime code yet.
  It adds a project-owned worker scaffold that can be built reproducibly from
  the pinned source checkout.
- Later stories extend this boundary with actual llama.cpp execution patches.

Failure mode:

- If the checkout commit does not match the pin, the build script fails with a
  clear pin-mismatch error before patch application or compilation starts.