Four iam shell commands have no recipe after the stale documents were deleted

Table of Contents

This page is a capture in the inbox bucket of the product backlog — a pre-sprint idea, not yet pulled into a sprint as a story.

1. What

Four iam shell commands now have no recipe at all: accounts info, accounts history, accounts logout and tenants history. Each was documented only by one of the seventeen stale hand-written recipe documents deleted on 2026-09-26, so removing the stale pages took the only literate description of these four with them. The commands themselves work; what is missing is a recipe.

2. Why

The deletion was right – those pages carried the sign-in and the fixtures of the 2026-05 session they were captured in, so a fresh environment refused every one of them, and a recipe that cannot be replayed is not documentation. But the cost is real and was recorded rather than glossed: the iam commands without a recipe went from six to ten.

The replacement is not a copy of the deleted page. A recipe that survives a fresh database has to create what it reads – the account it inspects, the tenant whose history it lists – or read something the seeds guarantee, which is the shape the surviving generated recipes already have: one command, signed in through accounts login, carrying no fixtures of its own.

3. References

  • The deletion and the resulting census: the S02 and V04 rows of Bring ores.iam to the clean standard, and build/audit_iam/command_recipe_census.py, which lists every registered command with no recipe invoking it.
  • projects/ores.shell/application/src/app/commands/accounts_commands.cpp and tenants_commands.cpp – the hand-written units that own these four commands.

4. See also

Emacs 29.3 (Org mode 9.6.15)