jeffryandClaude Opus 5
d3fec24bc6
loom's .usages.md for this page found the hole. The docs site depends on the command surface — its README and publish script tell a person to type loomctl external add loom/<repo> <doc>.md — and this page explicitly does not promise it. Nothing parses the command, which is exactly why no check would catch a rename: the thing that moved is not a document anybody adopted. The answer is not to promise the surface, which would freeze the CLI. It is to promise that a change to it lands on this page — which consumers already lock — so a rename reports 200 the day it happens. The exclusion goes from "you are on your own" to "you will be told", and it costs one append-only section. Same shape as a supersession in the event log: the record is not that the thing never changes, it is that the change is findable by whoever depended on it. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018UTxuSizozEA8yDitPuris
70 lines
3.4 KiB
Markdown
70 lines
3.4 KiB
Markdown
<!-- Generated by `loomctl orient`. Safe to overwrite; nobody typed it.
|
|
Regenerate after adopting a document or reconciling a change. -->
|
|
|
|
# What this repository depends on
|
|
|
|
Copies of other people's documents are kept under `.loom/externals/`, at a path
|
|
that says where each came from. **They are copies: do not edit them.** Anything
|
|
you want to say about one goes in a file *beside* it, never into it.
|
|
|
|
Three moves, and each has a document that owns the rule:
|
|
|
|
- **A copy is wrong, or you needed something it does not say** — write it in
|
|
`<name>.gaps.md` beside the copy.
|
|
- **What of ours depends on a copy** — write it in `<name>.usages.md` beside it.
|
|
- **A source changed** — `loomctl external check` says so and stages the new copy;
|
|
`loomctl external apply` takes it. Neither edits anything on its own.
|
|
|
|
## `git.hypertheory-labs.dev/jeffry/homelab-cluster/gitea.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/jeffry/homelab-cluster/raw/branch/main/.loom/published/gitea.md
|
|
- what of ours depends on it: `.loom/externals/git.hypertheory-labs.dev/jeffry/homelab-cluster/gitea.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/annotating/annotating.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/annotating/raw/branch/main/.loom/published/annotating.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
- what we expected and did not find: `.loom/externals/git.hypertheory-labs.dev/loom/annotating/annotating.gaps.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/loom-directory.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/loom-directory.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/publication.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/publication.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/recording-decisions.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/recording-decisions.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/sibling-facets.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/sibling-facets.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/starting.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/starting.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/cart/cart.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/cart/raw/branch/main/.loom/published/cart.md
|
|
- what of ours depends on it: `.loom/externals/git.hypertheory-labs.dev/loom/cart/cart.usages.md`
|
|
- what we expected and did not find: `.loom/externals/git.hypertheory-labs.dev/loom/cart/cart.gaps.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/externals/externals.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/externals/raw/branch/main/.loom/published/externals.md
|
|
- what of ours depends on it: `.loom/externals/git.hypertheory-labs.dev/loom/externals/externals.usages.md`
|
|
|
|
## This repository publishes
|
|
|
|
See `.loom/published/`. What is handed over for others to depend on is
|
|
there; the rest of the repository is not hidden, it is simply not what
|
|
anybody depends on.
|