Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions agents/conductors/eyes/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,8 +28,11 @@ in the `/eyes` skill. Default instance: the lens visualization project repo,
**`lens/autolens_visualization`**; the galaxy project repo
**`galaxy/autogalaxy_visualization`** is the second registered instance
(`--instance galaxy`), then **`fit/autofit_visualization`** (`--instance fit`)
and **`cti/autocti_visualization`** (`--instance cti`). `autolens_workspace_test` remains a
secondary instance (its `gallery/` harness is retired by PyAutoEyes phase 5).
and **`cti/autocti_visualization`** (`--instance cti`). These four registered
instances are the only Eyes targets: `autolens_workspace_test`'s `gallery/`
harness was retired in PyAutoEyes phase 5 (PyAutoEyes#6), and its
`scripts/<domain>/visualization/` scripts remain ordinary workspace_test
regression scripts, not an instance.

Two layers (human decision 2026-09-28): **project repos**
`<lib>_visualization` (four today: `lens/autolens_visualization`,
Expand Down
33 changes: 28 additions & 5 deletions docs/organs/eyes.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ Heart: the Heart says whether the software is *healthy*; the Eyes show what it

**Repo:** [PyAutoLabs/PyAutoEyes](https://github.com/PyAutoLabs/PyAutoEyes)

**Dashboard:** <https://pyautolabs.github.io/PyAutoEyes/>

## The defining function: seeing

Every PyAuto library draws, on one shared plotting API — and the figures a
Expand All @@ -37,6 +39,12 @@ instance, its library and its domains, and the board shows each one's figure
count, stale renders, gaps and open critiques — the single point of contact
for the visual behaviour of the whole ecosystem.

Beside the board, the organ publishes two machine surfaces: `badge.json`, a
one-line headline, and `state.json`, the organ-cockpit feed (contract v1 in
`PyAutoBrain/board/state_schema.json`). The feed is what puts the Eyes on the
[organ cockpit](https://pyautolabs.github.io/cockpit/) alongside the other
organs.

## The driver split

The project repos *render and hold* figures and the Eyes *show* them; neither
Expand All @@ -63,8 +71,23 @@ inherently yours. You do not fork this repo's figures; you create your own
Eyes with the same shape, over your own libraries' visualization project
repos.

The birth of this organ is tracked in the `pyautoeyes-birth` epic
([PyAutoMind#437](https://github.com/PyAutoLabs/PyAutoMind/issues/437) is
phase 0). Phase 1a (PyAutoMind#446) moved the lens gallery back into its own
project repo, `autolens_visualization`, with the tracked manifest; phase 1b
strips the organ to the dashboard skeleton and adds the registry.
The organ was born through the `pyautoeyes-birth` epic:

- **Phase 0** ([PyAutoMind#437](https://github.com/PyAutoLabs/PyAutoMind/issues/437))
added the organ row to the body map.
- **Phase 1a** ([PyAutoMind#446](https://github.com/PyAutoLabs/PyAutoMind/issues/446))
moved the lens gallery back into its own project repo,
`autolens_visualization`, with the tracked manifest.
- **Phase 1b** ([PyAutoMind#448](https://github.com/PyAutoLabs/PyAutoMind/issues/448))
stripped the organ to the dashboard skeleton and added the registry.
- **Phase 2** ([PyAutoMind#451](https://github.com/PyAutoLabs/PyAutoMind/issues/451))
built the dashboard, the conductor's registry reading and the Brain board chip.
- **Phase 3** ([PyAutoMind#452](https://github.com/PyAutoLabs/PyAutoMind/issues/452))
registered the galaxy instance, `autogalaxy_visualization`.
- **Phase 4** ([PyAutoMind#455](https://github.com/PyAutoLabs/PyAutoMind/issues/455))
registered the fit and CTI instances, `autofit_visualization` and
`autocti_visualization`.
- **Phase 5** ([PyAutoEyes#6](https://github.com/PyAutoLabs/PyAutoEyes/issues/6))
retired the pre-organ `autolens_workspace_test/gallery/` harness, linked the
dashboard from the public surfaces and lit the Eyes card on the organ
cockpit with `state.json`.
9 changes: 6 additions & 3 deletions skills/eyes/eyes.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,12 @@ Shared routing context: `PyAutoBrain/skills/COMMANDS.md`. The default
visualization instance is the lens visualization project repo,
**`lens/autolens_visualization`**; the galaxy project repo
**`galaxy/autogalaxy_visualization`** is the second instance, then
**`fit/autofit_visualization`** and **`cti/autocti_visualization`**. `autolens_workspace_test` (the original
reference instance from epic PyAutoBrain#117 Phase 1) remains a secondary
instance; pass a different instance root to review another project.
**`fit/autofit_visualization`** and **`cti/autocti_visualization`**. These four
registered instances are the only Eyes targets. `autolens_workspace_test` (the
original reference instance from epic PyAutoBrain#117 Phase 1) is no longer an
instance: its `gallery/` harness was retired in PyAutoEyes phase 5
(PyAutoEyes#6), and its visualization scripts remain ordinary workspace_test
regression scripts. Pass a different instance root to review another project.

Two layers (human decision 2026-09-28): **project repos**
`<lib>_visualization` (four today: `lens/autolens_visualization`,
Expand Down
Loading