leglas 0.4.0 → 0.5.0

package/README.md

@@ -15,7 +15,7 @@
 </p>
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/pr-assets/rail-single.jpg" width="900" alt="The Leglas interface: a rail of three design directions on the left, and the selected one running as the real app filling the rest of the window" />
+  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/main/.github/assets/screenshots/rail-single.jpg" width="900" alt="The Leglas interface: a rail of three design directions on the left, and the selected one running as the real app filling the rest of the window" />
 </p>
 
 <p align="center"><i>Every direction in the rail, the selected one running as your actual app. Arrow keys flip between them.</i></p>
@@ -46,7 +46,7 @@ and sessions that clean up after themselves.
 ## What you can do with Leglas
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/pr-assets/compare-artboards.jpg" width="900" alt="The Leglas interface: a rail of three design directions on the left, and two of them running side by side as the real app, each labelled with its name." />
+  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/main/.github/assets/screenshots/compare-artboards.jpg" width="900" alt="The Leglas interface: a rail of three design directions on the left, and two of them running side by side as the real app, each labelled with its name." />
 </p>
 
 <p align="center"><i>Two directions for the same page, running side by side as the actual app.</i></p>
@@ -177,13 +177,26 @@ directly above the field. Your agent drains the queue with `npx leglas requests
 it with `--clear`. Leglas runs no model of its own; your agent already
 knows your conventions and your taste.
 
+Most of what you would type into that field is the part describing where
+the problem is, so you can point at it instead. Press `A` and the preview
+becomes a picker: hovering outlines the element under the pointer,
+clicking drops a numbered pin that takes a note, and dragging marks an
+area and names every element inside it. The page still scrolls, so the
+thing three screens down is as easy to mark as the headline. Annotations
+are a request on their own, so the field can stay empty; leave three and
+send once. Each one carries the element's own words, its tag and classes,
+a path and the box it filled, and the request tells your agent which of
+those to trust first, because the design moves under them by design. One
+whose element has since gone turns amber rather than pointing confidently
+at the wrong thing.
+
 The line under the field is the whole status: whether anything is
 listening, what you have queued, and when it has been picked up.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/pr-assets/field-idle.png" width="290" alt="The change field reading: Enter queues it for npx leglas requests" />
-  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/pr-assets/field-queued.png" width="290" alt="The change field reading: one change queued for your agent" />
-  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/pr-assets/field-pickedup.png" width="290" alt="The change field reading: Your agent is on it" />
+  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/main/.github/assets/screenshots/field-idle.png" width="290" alt="The change field reading: Enter queues it for npx leglas requests" />
+  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/main/.github/assets/screenshots/field-queued.png" width="290" alt="The change field reading: one change queued for your agent" />
+  <img src="https://raw.githubusercontent.com/FredAmartey/leglas/main/.github/assets/screenshots/field-pickedup.png" width="290" alt="The change field reading: Your agent is on it" />
 </p>
 
 <p align="center"><i>Nothing waiting, then a request queued, then an agent that has taken it.</i></p>
@@ -286,8 +299,11 @@ trace.
 ## The interface
 
 Directions live in a rail on the left. The stage shows the active one in
-a framed viewport at Full, 1440, 834, or 390 wide. Rename, reorder, hide,
-and tag directions from the rail; layout is saved per project and
+a framed viewport at Full, 1440, 834 or 390 wide. Rename, reorder, hide
+and tag directions from the rail. Open the removed list to restore a
+direction, delete one permanently or clear the full list. Machine-local
+directions are removed from `.leglas/previews.json`; shared project config
+and preview source files stay untouched. Layout is saved per project and
 survives restarts and port changes.
 
 Flipping shows a difference over time. A split shows it at once, which is
@@ -305,8 +321,9 @@ drawn at and the scale it is shown at. If you want the narrow rendering,
 that is what the tools popover's "Scale each side to fit" switch is for.
 
 Arrows move between directions, `1` to `9` jump straight to one, `R` asks
-for a change to the one you are on, `Cmd K` (`Ctrl K` elsewhere) searches
-and `B` collapses the rail. Press `?` for the whole keymap.
+for a change to the one you are on, `A` annotates the design itself,
+`Cmd K` (`Ctrl K` elsewhere) searches and `B` collapses the rail. Press `?`
+for the whole keymap.
 
 A small tools widget floats over the stage and can be dragged to any
 corner, because a floating control has a habit of sitting exactly where
@@ -343,6 +360,7 @@ leglas keep <title>        Keep a winner and end the exploration
   --count <n>          (explore) How many directions, default 3
   --based-on <title>     (explore) Variants of an existing direction instead of new ones
   --based-on <title>     (add) The direction this preview is a variant of; groups the family
+  --asked-for <text>     (add) The change that was asked for, in the words that were typed
   --change <path>      (classify) A file the direction creates or wires up
   --rewrite <path>     (classify) An existing file whose behaviour must change
   --note <text>        (add) Second line under the title

package/dist/args.d.ts

@@ -17,6 +17,8 @@ export type AddPreview = {
     file: string | undefined;
     /** The direction this preview is a variant of; the rail groups them. */
     basedOn: string | undefined;
+    /** The change that was asked for, in the words that were typed. */
+    askedFor: string | undefined;
 };
 export type ClassifyChange = {
     path: string;