Project memory / Page 45 of 70
This page is one part of The Ishoo manual. The complete manual is a single page, short enough to read in one go: ishoo.app/docs/
Citation checks
Ishoo checks citations of rules and decisions. When an issue, comment or landing note cites a repealed rule or superseded decision, Ishoo names its replacement in one line, without refusing. Looking up a rule or decision also lists every file and issue that cites it.
Rules and decisions change; the text that quotes them doesn't. An issue filed in spring says “per DEC-1”; by autumn DEC-1 is superseded, and an agent reading the issue follows advice nobody holds any more. Citation checks catch that the moment it's written.
What counts as a citation#
- Rule addresses: an area name, a dot and a number, such as
landing.7. Only real area names count, sov1.2orbeta.10in ordinary text are left alone. - Decision numbers:
DEC-and a number, however it's padded.DEC-7andDEC-07are the same decision.
The nudge#
Filing an issue, editing one, commenting, and landing all check the text they write. A citation of something replaced gets one line in the reply:
ISS-01 cites DEC-1, which is superseded; see DEC-02. Cite the current one unless you mean the history.
ISS-01 cites beta.1, which is repealed; see beta.2. Cite the current one unless you mean the history.It's never a refusal. Sometimes the old record is exactly what's meant, as in “this reverses what DEC-1 chose”. The agent reads the line and decides.
Who cites this?#
ishoo_find with a rule or decision as its id lists everything that cites it: tracked files by path and line, and issues by id. Matching is word-exact, so a search for beta.1 doesn't hit beta.10. Use it before you repeal or supersede something, to see what will need a new citation.
This list is found when asked, with one git grep over the project and a pass over the store. There's no citation index to keep current, so it can't be wrong about a file that changed a minute ago.