weft-rag

Weft — a RAG engine built as a microkernel. This is the default install: the packs that index a directory and answer a question about it, and the weft command.

The distribution is weft-rag; the command is weft — the name weft belongs to an unrelated project on PyPI, so what you install and what you run are spelled differently:

uvx --from weft-rag weft --help

What is in it, and what is not

Twenty-one packs ship here and each keeps its own identity: weft plugins list prints one row per pack, and weft.toml configures one at a time — [packs.store], not [packs.weft-rag].

One distribution publishes beside this one, and it is separate for a single reason:

Six packs that used to be their own distributions now ship inside this wheel instead, each behind an extra that keeps its outside library declinable — G19, 2026-09-09:

weft-rag[all] installs every one of those libraries at once. graph — the Postgres-backed graph-traversal pack added at ledger task 11.5 — was never a separate distribution either and needs no extra.

None of these seven packs is needed to index a directory and query it. A pack neither we nor you wrote installs beside this wheel on exactly the same terms and is discovered the same way, with no edit to anything here — that is the extension model, not a courtesy.

See docs/09-release.md §1 for why this is one wheel rather than many — fourteen packs at G10 (2026-08-22), six more folded in by G19 (2026-09-09).

What installing this trusts

A pack runs with your full privileges, and installing one is trusting it. Weft discovers packs through Python entry points and calls their register() in this process, so a pack can do anything the interpreter can do. That is stated rather than mitigated, because the mitigations are not available: signature verification, sandboxing, per-pack privilege separation, and any defence against a pack that is hostile once running are all out of reach without a process boundary, which Weft does not have.

What Weft does give you is visibility and refusal, not containment:

• weft plugins doctor names every distribution that is installed, at what version, and what each one discloses about the network, filesystem and subprocess access it uses. A disclosure is what the pack says about itself; nothing checks it.
• [packs] allow in weft.toml is an exhaustive pin. Anything not listed is never imported — refusal before any of its code runs, which is the one control that does work without a process boundary.

A control that looked like enforcement but was not would be worse than an acknowledged gap, because people build policy on it. docs/02-extension-model.md §2 is the argument in full.