Review or purge a project's memory
As runners work on a project, Jaah keeps what they learn as memory units that later tasks are given. Review them now and then: retire a unit that is wrong or out of date, and purge one that should never have been kept, such as a pasted token.
Who can do this: anyone who can view the project can read its memory, while the organization's plan includes it. Retire and Purge need permission to edit the project.
Find a unit
- In the sidebar, select Audit, then the Memory tab.
- Pick the project in the Project filter, or press a unit's project name.
- The project's whole memory view opens.
- Narrow the list:
- Search: a word from the title or text, or the unit's number, such as
mem-12. - Kind: codemap, gotcha, recipe, env or qa.
- Status: opens on Live, the units still in play. Pick All for every unit, or Held for the ones kept from tasks until the canon check clears them.
- Repository: one repository's units, on a project with more than one.
- Search: a word from the title or text, or the unit's number, such as
- Pick a Sort to rank by use: Injected, Seen, Used or Wrong. Newest is the default.
- Read each row's facts: Trust (0 to 1), and how many tasks had the unit Injected, Seen, Used or flagged it Wrong. Injected means it was put in the task's prompt; Seen, shown at session start or beside a file the runner touched; Used, read or cited by the runner; Wrong, flagged as wrong. Hover a fact to see its meaning. Select Body, or the title, to read the whole unit.
A unit with a high Wrong count, or one given to many tasks that none Used, is a good one to retire.
Retire a unit
- Find the unit, as above.
- Select Retire on its row.
- Check the message that it was retired. Under Live it drops out of the list; under All it reads retired.
A retired unit is no longer given to tasks, but it is still stored.
Purge a unit
Purge only a unit that holds sensitive data. It cannot be undone.
- Find the unit, as above.
- Select ⋯ on its row, then Purge.
- Read the confirm: it names the unit's number, kind and title.
- Select Purge.
- Check the message: it names the unit and how many stored prompts were scrubbed of it.
Purging deletes the unit and removes it from every stored runner prompt.
When memory isn't in your plan
The tab then says Memory (what runners learn on this project) isn't in your plan. and who can turn it on. You see it only if you can edit the project. You can still erase a unit you know the number of:
- Open Audit > Memory with the project picked, as above.
- Type the unit's number in Unit, such as
mem-12. - Select Purge.
- Select Purge again in the confirm.
- Check the message naming the unit and the prompts scrubbed.
How memory is built and used is in How projects work. Every item on the tab is in the Audit reference.