# Interlock

> Adaptive application infrastructure. Write units of code (JS, JSX, Java, HTML, assets), sync them from git, and run them inside your own host's JVM. This corpus documents the model and, more importantly, every rule that will bite you, each one paired with the failure it prevents and the literal error text you would otherwise search for.

For the whole corpus in a single fetch, in dependency order:
https://docs.interlock.sh/llms-full.txt

To generate this project's agent skills:
https://docs.interlock.sh/skills.json

## Docs

- [Start here](https://docs.interlock.sh/start.md): What Interlock is, the shape of a project, and the first unit that works.
- [The model](https://docs.interlock.sh/units.md): What a unit is: ids are paths, envs promote, the handler contract, library units, the per-unit store.
- [Java units importing Java units](https://docs.interlock.sh/java.md): Directory is package. Resolution is javac's sourcepath, not a shared classloader, and each importer gets its own compiled copy.
- [Embedding the SDK in a host](https://docs.interlock.sh/host.md): Wiring, compile anchors, trust and the shadow boundary, context vs session, requests and responses, Refusal.
- [Quarkus and Panache entities](https://docs.interlock.sh/quarkus.md): Quarkus builds every entity twice and the JVM loads the transformed copy. The entity accessor rule, measured. The most expensive page here.
- [Testing](https://docs.interlock.sh/testing.md): The two-second compile gate, the unit-harness test, assert effects not status codes, and why every measurement needs a control arm.
- [Operating a project](https://docs.interlock.sh/operating.md): .interlock-key binds a tree to a project, the sync index is the base, and how conflicts surface.
- [Durable tasks and workers](https://docs.interlock.sh/tasks.md): Submit work once, run it on outbound-only Java or Node workers, and understand leases, retries, cancellation and unknown outcomes.
- [Search over your own data](https://docs.interlock.sh/search.md): An index inside your own JVM, a synonym graph that knows what your things are, and results that say when they cannot be trusted.
- [Self-hosted AI workers](https://docs.interlock.sh/self-hosted-ai.md): Install Qwen on your Mac or Linux hardware, choose an explicit route policy, and operate recoverable AI runs.
- [Model fleets](https://docs.interlock.sh/model-fleet.md): Scaffold a model project, enroll narrow trainer and inference machines once, and operate verified self-updating workers.
- [Failure catalogue](https://docs.interlock.sh/failures.md): Symptom to cause to fix. Start here if you arrived by pasting an error.
- [Reference](https://docs.interlock.sh/reference.md): The flat API surface: Request, Interlock, Store, Result, Refusal, handler contracts.
- [Verify a host](https://docs.interlock.sh/verify.md): The eight commands that prove a host is wired correctly, in order. /start tells you to run these, so they belong in the corpus.

## Notes

- Every page is available as raw markdown at the same path plus `.md`.
- Rules state what was MEASURED and what is INFERRED. Measurements name their version and include the command to re-run them.
- Start at /failures.md if you arrived with an error message.