added macro support

PROJECT.md

@@ -35,6 +35,9 @@ interaction, conventional shortcuts, UTF-8, and modern durability.
   assignment, aliases/abbreviations, incremental structure, and named live views.
 - Period reviews from the Los Angeles Times and HUMANIST archives corroborate
   long notes, free-form entry, priorities, Boolean reports, and automatic filing.
+- The preserved Agenda 2.0 Help file documents the Macro Manager, Learn workflow,
+  note-style Macro Editor, complete brace-command catalog, variables, special
+  values, error/break handlers, key notation, macro menus, and manager indicators.
 
 Research URLs:
 
@@ -42,6 +45,7 @@ Research URLs:
 - https://lock.cmpxchg8b.com/lotusagenda.html
 - https://www.bobnewell.net/agenda/agfaq.txt.html
 - https://www.bobnewell.net/agenda/atlantic.txt.html
+- https://www.bobnewell.net/agenda/AgendaHelp.htm
 - https://dhhumanist.org/archives/Virginia/v02/0410.html
 - https://www.latimes.com/archives/la-xpm-1988-07-28-fi-9745-story.html
 
@@ -93,6 +97,20 @@ Research URLs:
 - [x] Text and iCalendar import; view-scoped CSV, JSON, Markdown, styled HTML,
   and iCalendar export with notes, categories, dates, priority, completion, and
   recurring `RRULE` schedules.
+- [x] Document-local Agenda macro programs with raw keystroke playback; named and
+  modified key commands; local and persistent global variables; arithmetic and
+  string expressions; branches, loops, cross-macro calls, error/break handlers;
+  input boxes, messages, horizontal/vertical menus; special context variables;
+  AUTOEXEC; and attachable keyboard shortcuts.
+- [x] Agenda-inspired Macro Manager (`Ctrl-G`, with legacy `Alt-F3` alias) with
+  add/edit/run/delete/key binding
+  and replace/append Learn recording. Recordings operate across the live TUI,
+  show a LEARN indicator, and stop/save from anywhere with `Ctrl-G`; plain `a`
+  replaces the unreliable modified-function-key append gesture.
+- [x] Responsive full-screen Macro Editor with original-style `F5` return/save,
+  `Esc` cancellation and terminal-safe `Ctrl-V` key capture, plus modern cursor editing and
+  syntax highlighting for commands, labels, variables, values, comments,
+  delimiters, and malformed source.
 - [x] Demo data, CLI help, README, MIT license, and unit/integration tests.
 
 ## Supported with a modern interpretation
@@ -110,7 +128,8 @@ Research URLs:
   filesystem backup tools also work on `.agnd` files.
 - [x] Clipboard/accessory capture: terminal paste into the new-item form replaces
   the DOS resident accessory.
-- [x] Macros: conventional keys and direct commands replace keystroke-replay macros.
+- [x] Macros retain Agenda's compact hybrid of literal keystrokes and `{COMMAND}`
+  entries while applying those actions to Rogue Agenda's modern TUI.
 
 ## Delayed / unsupported
 
@@ -121,8 +140,14 @@ a larger follow-on implementation:
   view columns support `sum`, `avg`, `count`, `min`, and `max` aggregates.
 - [ ] Rich-text/font markers, printer control sequences, page-layout preview, and
   named printer configurations.
-- [ ] Lotus Metro/List Manager/STF compatibility, DOS accessories, and Agenda macro
-  compatibility (explicitly outside the project's format-compatibility goal).
+- [ ] Lotus Metro/List Manager/STF compatibility, DOS accessories, and import of
+  external legacy `.MAC` files (outside the project's format-compatibility goal).
+- [ ] Historic macro protection, hidden-list indicators, external source-file
+  attachment, and per-screen run restrictions. Macro source, Learn recording,
+  execution, key binding, AUTOEXEC, and persistent variables are already native.
+- [ ] DOS macro single-stepping/speed/frozen-window effects and an internal
+  clipboard bridge. Their command syntax and `#CLIPBOARD` value are recognized;
+  screen-pacing directives are safe no-ops and the clipboard currently reads empty.
 - [ ] Password encryption. A description field is supported by schema metadata;
   weak historic password protection will not be imitated without real encryption.
 - [ ] Desktop notifications while the application is closed. Due alarms are shown