neuron-tai/packages/node/native/llama/UPSTREAM_ASSUMPTIONS.md

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.