the README had drifted into being wrong; make it short and true
It still said Not built, listed pull and reachable — neither of which exists — and claimed everything was decided in one round. Written at a conversion and never touched again. Deliberately does not enumerate the commands, because a prose command list is exactly what went stale. It points at --help, which is the documentation surface we already decided on and which cannot drift from the binary. Worth noticing rather than logging: check catches documents that drift from their publisher, and nothing catches ours drifting from our own code. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018UTxuSizozEA8yDitPuris
This commit is contained in:
@@ -1,17 +1,18 @@
|
|||||||
# loom-cli
|
# loom-cli
|
||||||
|
|
||||||
**Not built.** *A small tool for the operations a person should not do by hand:
|
**`loomctl` fetches the documents this repository depends on, and tells you when
|
||||||
fetch a document you depend on, and find out when it changed.*
|
they change.** It reports; it never repairs.
|
||||||
|
|
||||||
**The design is in [`.loom/event-log.md`](.loom/event-log.md)**, *not in a spec.*
|
```
|
||||||
**Every entry says what was decided and the belief that could turn out false**, so
|
go build -o loomctl .
|
||||||
you can see which parts are load-bearing and which were guesses. *Everything
|
./loomctl --help
|
||||||
tagged `osprey` was decided in one round.*
|
```
|
||||||
|
|
||||||
**Three commands.** *`pull` adopts a document and writes its lock; `check` asks
|
`check` only reads. Nothing here writes over the network, so a credential it is
|
||||||
every publisher whether their copy has moved; `reachable` asks whether somebody
|
given never needs write scope.
|
||||||
who is not you can fetch what you published.* **None of them repairs anything.**
|
|
||||||
|
|
||||||
**`bedrock` and `externals`, under [`.loom/externals/`](.loom/externals/), are not
|
**Why it is the way it is:** [`.loom/event-log.md`](.loom/event-log.md). Every
|
||||||
discardable.** *Read them as given — accommodating them is what makes this a loom
|
entry says what was decided and the belief that could turn out to be false.
|
||||||
tool rather than some other thing.*
|
|
||||||
|
**What it depends on, and what we could not tell from those documents:**
|
||||||
|
[`.loom/externals/`](.loom/externals/) — the `.gaps.md` files beside each one.
|
||||||
|
|||||||
Reference in New Issue
Block a user