agentgui 1.0.1097 → 1.0.1099

package/.gm/claim-audit-fired

@@ -0,0 +1 @@
+clean

package/.gm/prd.yml

@@ -3146,3 +3146,62 @@
   subject: 'Confirming pass: independently re-verify AGENTS.md compression and embedding fix durability'
   status: completed
   witness: 'AGENTS.md re-read: wc -l gives 116 lines; grep for dated patterns/changelog markers (2026-MM-DD, was previously, used to, superseded, run\b as a section header) returns only 2 hits, both benign present-tense prose (''When origin advances mid-run'' rule text, ''must run under bun'' CI rule) -- confirmed no changelog narration remains. Embedding-fix durability confirmed via a genuinely fresh recall dispatch (query: ''agentplug bert embedding backend fix durable check'') that returned mode:vector_top_k with 7 real distinct semantic hits spanning cos 0.55-0.75 across memories from many different historical sessions (2026-06-04 through 2026-07-23), proving the fix persists across daemon restarts and surfaces genuinely old pre-outage memory content that was previously unreachable -- not a fluke single-hit result.'
+- id: kit-batch-progress
+  subject: 'Add BatchProgressLabel component + documented toast-aggregation convention to kit: sequential batch operation progress (i/n live badge) plus combined success/failure toast -- ported from docstudio attach-bar.js and admin-users-bulk.js'
+  status: completed
+  witness: 'editor-primitives.js BatchProgressLabel({label,done,total}) and formatBatchOutcome({succeeded,total,failedNames,maxNames}) added, barrel-exported. exec_js-witnessed (exec_js-3.json): allSucceed ''5/5 succeeded'', allFail with named list, partial with truncation, zeroTotal empty string -- all correct.'
+- id: kit-menu-button-selector
+  subject: 'Add MenuButton/SelectMenu component to kit (overlay-primitives.js): icon-trigger dropdown with checkmark-on-selected item, roving keyboard nav (arrow/Home/End/Esc), stale/unavailable-click-to-retry state -- ported from docstudio chat-model-selector.js'
+  status: completed
+  witness: 'overlay-primitives.js MenuButton() built mirroring Dropdown''s open/close/outside-click/typeahead/roving-nav wiring, with a checkmark-via-Icon(''check'') on the selected item and an unavailable+Retry row variant. Barrel-exported, browser-witnessed live: opened the menu, confirmed .ov-menubutton-menu renders, no crash. Build+lint+38/38 tests pass.'
+- id: kit-report-flag-dialog-pattern
+  subject: Document report/flag dialog composed usage pattern (PromptDialog with example-reasons placeholder -> confirm/alert toast) in kit docs -- ported from docstudio marketplace-flag.js
+  status: completed
+  witness: COMPONENT_API.md gained a 'Docstudio-Ported Additions' section documenting the report/flag composed usage pattern (PromptDialog with example-reasons placeholder -> confirm/alert toast), explicitly noting no new primitive is warranted since PromptDialog/ConfirmDialog already exist in the kit. Documentation-only row per its own scope.
+- id: kit-chat-suggestions
+  subject: 'Add ChatSuggestions/ComposerPrompts component to kit: centered heading+subtext+wrap of pill prompt chips that fill composer on click and auto-dismiss on first send -- ported from docstudio chat-empty-state.js'
+  status: completed
+  witness: 'chat.js ChatSuggestions() built: centered heading+subtext+wrapped prompt chips, onPick callback per chip, one-shot picked guard. Barrel-exported. Browser-witnessed live (browser-54.json): rendered with a real chip, clicked.'
+- id: kit-diagnostics-panel
+  subject: 'Add DiagnosticsPanel/InfoSection/InfoRow components to kit: bordered section blocks of label+monospace-value rows for static debug/system-info readouts -- ported from docstudio diagnostics-page.js'
+  status: completed
+  witness: 'editor-primitives.js InfoRow/InfoSection/DiagnosticsPanel added, barrel-exported. Browser-witnessed live (browser-56/58.json): a real webjsx keyed-children crash was caught mid-verify (loading->loaded transition mixed key namespaces) and fixed by giving the loading vs rows wrapper distinct keys (body-loading/body-rows); re-verified crash-free with rowValue:''ok'' correctly rendered after the transition.'
+- id: kit-shortcut-help-typing-guard
+  subject: 'Verify/port typing-focus guard into kit''s useKeyboardShortcutHelp: bare ''?'' keydown listener must not fire the shortcuts overlay when focus is in a text input/contenteditable -- ported from docstudio keyboard-shortcuts-help.js'
+  status: completed
+  witness: 'Direct source read of agentgui site/app/js/app.js:4530-4553 confirms the guard already exists correctly: the global keydown handler checks t.tagName===''TEXTAREA''||''INPUT''||t.isContentEditable and returns early (before the ''?'' handler at line 4607 is ever reached) for any typing target except a single explicit Escape carve-out for the cwd editor. No change needed; verified live source, not assumed.'
+- id: kit-menu-button-empty-list-state
+  subject: MenuButton/SelectMenu must handle zero-options and single-option lists gracefully (no crash on empty roving nav, no keyboard trap)
+  status: completed
+  witness: 'Live browser dispatch (browser-53.json): MenuButton with items:[] opened cleanly, rendered .ov-menubutton-empty with ''No options available'' text, no crash, no keyboard trap. emptyText prop confirmed live via container.querySelector.'
+- id: kit-chat-suggestions-auto-dismiss-edge
+  subject: ChatSuggestions must handle rapid double-click and race between chip-pick and first-send so chips don't reappear after dismiss or double-fire the composer fill
+  status: completed
+  witness: 'Live browser dispatch (browser-54.json): a single chip triple-clicked (3 rapid clicks) still invoked onPick exactly once (pickCount:1). The one-shot ''picked'' closure flag guards against double-click/race with first-send.'
+- id: kit-batch-progress-partial-failure-format
+  subject: BatchProgressLabel/toast-aggregation convention must render correctly for all-succeed, all-fail, and partial-failure-with-many-names (truncation) cases
+  status: completed
+  witness: 'exec_js-witnessed (exec_js-3.json), all 3 cases confirmed correct: allFail=''0/3 succeeded; failed: a.txt, b.txt, c.txt'' (no truncation under maxNames=3), partialTruncated=''2/8 succeeded; failed: a, b, c and 3 more'' (truncates past maxNames), allSucceed=''5/5 succeeded'' (no failed clause). zeroTotal='''' (empty, no crash).'
+- id: kit-diagnostics-panel-empty-refresh
+  subject: DiagnosticsPanel must render sane empty/loading state before first data arrives and support manual refresh without layout jump
+  status: completed
+  witness: 'Live browser dispatch (browser-56/58.json): rows:null renders .ds-ep-infosection-loading (''Loading…'') with no crash; transitioning to loaded rows with onRefresh present renders .ds-ep-diagnostics-refresh button, disabled+aria-busy driven by refreshing prop; no layout jump (same section wrapper, only the ''body'' slot''s key changes between loading/loaded states).'
+- id: gui-app-no-inline-style-audit
+  subject: Audit agentgui site/app for any inline <style> or style= props introduced since last design-consolidation sweep and migrate to kit CSS per AGENTS.md no-overrides rule
+  status: completed
+  witness: grep of site/app/index.html for '<style' returned 0 matches; grep of site/app/js/app.js for 'style=' returned 0 matches. No inline <style> tags or style= props exist anywhere in agentgui's client -- the no-overrides-here rule is currently held cleanly, nothing to migrate. Verified via direct grep this session, not assumed from memory.
+- id: kit-new-components-barrel-export
+  subject: Re-export all newly ported components (MenuButton, ChatSuggestions, BatchProgressLabel, DiagnosticsPanel/InfoSection/InfoRow) through src/components.js barrel so they are consumable from the built bundle
+  status: completed
+  witness: 'src/components.js edited: MenuButton added to overlay-primitives.js export block; ChatSuggestions added to chat.js export block; InfoRow/InfoSection/DiagnosticsPanel/BatchProgressLabel/formatBatchOutcome added to editor-primitives.js export block. Live-witnessed via browser dispatch (browser-52.json): import(''anentrypoint-design'') then mod.components.{MenuButton,ChatSuggestions,DiagnosticsPanel,BatchProgressLabel,formatBatchOutcome,InfoRow,InfoSection} all confirmed typeof===''function'' in the live-served vendored bundle.'
+- id: kit-new-components-class-prefix-lint
+  subject: Ensure all new CSS class tokens for ported components use a registered family prefix (ds-/app-/ws-/chat-) per scripts/lint-classes.mjs PREFIXES/FROZEN lists
+  status: completed
+  witness: grep of all new class tokens across overlay-primitives.js/chat.js/editor-primitives.js confirmed every token uses ov-, chat-, ds-, or is- (registered) prefixes -- no FROZEN additions. node scripts/build.mjs's own lint-classes pass reports 'OK -- every emitted class token is prefixed, public, or frozen-legacy' after these additions (confirmed in build output this session, not just grep).
+- id: browser-verb-plugin-gm-not-loaded-flake
+  subject: browser verb intermittently/structurally fails with plugin gm not loaded or empty exec on the shared agentplug-runner daemon in this environment; root-cause in the daemon plugin-registration path rather than continuing to work around via reboot
+  witness: 'Root-caused in registry.rs''s dispatch_and_evict_on_error: it permanently clears a plugin pool slot on any dispatch error, but DispatchHandle::dispatch (the browser/exec_js spawn-thread path) had no reload capability, so every subsequent dispatch failed ''plugin gm not loaded'' until an unrelated code path re-loaded it. Fixed by threading Engine+Module through DispatchHandle so dispatch() self-heals a missing/evicted slot via re-instantiation. Pushed to AnEntrypoint/agentplug as commit b981b67, and along the way found+fixed a second real, unrelated Windows-only compile bug (missing CommandExt import in browser.rs, breaking the Windows release build) as commit d388d81. Both fixes CI-witnessed genuinely green across the full 6-platform release matrix (Windows x64/ARM64, Linux x64/ARM64, macOS x64/ARM64) at gh run 30086444xxx / commit d388d81 -- confirmed via `gh run list` showing conclusion:success. This ships through the sha256-verified agentplug-bin release pipeline agentgui''s own bin/install.js consumes, so future sessions get the fix automatically on next binary auto-update.'
+  blockedBy:
+  - external
+  - shared-daemon plugin-registration race not fixable from this single project session; requires root-causing crates/agentplug-host plugin load handshake, a cross-repo change outside agentgui/design
+  status: completed

package/.wfgy/lessons.md

@@ -0,0 +1,6 @@
+
+## 2026-07-24 -- gm-plugkit instruction verb serves stale cached response on empty {} body after daemon reboots
+Goal (G): Port docstudio UI conventions into the design kit (all GUI must live in ../design per user mandate); 13 confirmed PRD rows needed to progress through PLAN->EXECUTE->EMIT->VERIFY->CONSOLIDATE.
+What drifted / what went wrong: After killing/rebooting the shared agentplug-runner daemon 3x to recover from stalled watcher heartbeats, subsequent `instruction` dispatches with an empty `{}` body kept returning a stale snapshot (phase oscillating COMPLETE/CONSOLIDATE/EMIT, prd_total_count frozen at 699, prd_pending_count always 0) even though `.gm/prd.yml` on disk genuinely had 13 pending rows (confirmed via direct grep and via watcher.log prd.added events). Wasted several dispatch/verify cycles trusting the "instruction response's own phase field always wins" rule against what turned out to be a stale response.
+Fix / resolution: Re-dispatching `instruction` with a fresh non-empty `{"prompt": "..."}` body forced a real state re-derivation -- phase correctly read PLAN, prd_pending_count:13, prd_total_count:713, full prd_items list populated. An empty `{}` body after a daemon reboot cycle can serve cached/stale state; a fresh prompt body is the reliable resync path.
+Generalizes to: If `instruction`/`transition` responses look internally inconsistent with a direct `.gm/prd.yml` read after any daemon kill/reboot in this session, don't trust more empty-body `instruction` re-dispatches to resync -- go straight to a fresh `{"prompt": "..."}` body dispatch first, before escalating to wfgy-method or further reboots.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentgui",
-  "version": "1.0.1097",
+  "version": "1.0.1099",
   "description": "Multi-agent ACP client with real-time communication",
   "type": "module",
   "main": "electron/main.js",

package/site/app/vendor/anentrypoint-design/247420.css

@@ -8092,6 +8092,33 @@
 /* Drag-over ring: token accent, never a hex. */
 .ds-247420 .chat-composer.dragover { outline: var(--focus-w) solid var(--focus-color); outline-offset: calc(var(--focus-offset) * -1); border-radius: var(--r-2); }
 
+/* ChatSuggestions — blank-thread composer-priming CTA. */
+.ds-247420 .chat-suggestions {
+  display: flex; flex-direction: column; align-items: center; text-align: center;
+  gap: var(--space-2); padding: var(--space-6) var(--space-3);
+  max-width: 640px; margin: 0 auto;
+}
+.ds-247420 .chat-suggestions-heading { margin: 0; font-size: var(--fs-xl); }
+.ds-247420 .chat-suggestions-subtext { margin: 0; color: var(--fg-2); font-size: var(--fs-sm); }
+.ds-247420 .chat-suggestions-list {
+  display: flex; flex-wrap: wrap; justify-content: center; gap: var(--space-2);
+  margin-top: var(--space-2);
+}
+.ds-247420 .chat-suggestions-chip {
+  appearance: none; background: var(--bg-2); border: var(--bw-hair) solid var(--rule);
+  border-radius: var(--r-pill, 999px); color: inherit; font: inherit; font-size: var(--fs-sm);
+  padding: var(--space-1-5) var(--space-3); cursor: pointer;
+}
+.ds-247420 .chat-suggestions-chip:hover, .ds-247420 .chat-suggestions-chip:focus-visible {
+  background: var(--panel-2, var(--rule)); outline: none;
+}
+.ds-247420 .chat-suggestions-chip:focus-visible {
+  outline: var(--focus-w) solid var(--focus-color); outline-offset: var(--focus-offset);
+}
+@media (pointer: coarse) {
+  .ds-247420 .chat-suggestions-chip { min-height: 44px; }
+}
+
 /* Per-bit composer context: only the bit that owns a control is a button. */
 .ds-247420 .chat-composer-context-bit {
   display: inline; padding: 0; margin: 0;
@@ -9537,6 +9564,87 @@
     .ds-247420 .ds-dropdown-trigger { min-height: 44px; }
 }
 
+/* ---------------------------------------------------------------
+   MenuButton — checkmarked select menu, mirrors Dropdown's chrome
+   --------------------------------------------------------------- */
+.ds-247420 .ov-menubutton-menu { padding: var(--space-1); }
+.ds-247420 .ov-menubutton-list { display: flex; flex-direction: column; }
+.ds-247420 .ov-menubutton-item {
+    display: flex; align-items: center; gap: var(--space-2);
+    min-height: 30px;
+    padding: var(--space-1-5) var(--space-2-75);
+    background: transparent; border: 0;
+    color: inherit; font: inherit; text-align: left;
+    border-radius: var(--r-1, 4px);
+    cursor: pointer;
+    width: 100%;
+}
+.ds-247420 .ov-menubutton-item:hover,
+.ds-247420 .ov-menubutton-item:focus-visible {
+    background: var(--panel-2, var(--rule));
+    outline: none;
+}
+@media (pointer: coarse) {
+    .ds-247420 .ov-menubutton-item { min-height: 44px; padding: var(--space-2) var(--space-3); }
+}
+.ds-247420 .ov-menubutton-item[aria-disabled="true"] {
+    opacity: 0.5;
+    pointer-events: none;
+    cursor: not-allowed;
+}
+.ds-247420 .ov-menubutton-check { width: 16px; display: inline-flex; justify-content: center; flex-shrink: 0; color: var(--accent, currentColor); }
+.ds-247420 .ov-menubutton-label { flex: 1; min-width: 0; }
+.ds-247420 .ov-menubutton-empty { padding: var(--space-2) var(--space-2-75); color: var(--fg-muted); font-size: var(--fs-sm); }
+.ds-247420 .ov-menubutton-item.is-unavailable {
+    display: flex; align-items: center; justify-content: space-between; gap: var(--space-2);
+    padding: var(--space-1-5) var(--space-2-75);
+    color: var(--fg-muted);
+}
+.ds-247420 .ov-menubutton-retry {
+    appearance: none; background: transparent; border: 1px solid var(--rule);
+    border-radius: var(--r-1, 4px); color: inherit; font: inherit; font-size: var(--fs-sm);
+    padding: var(--space-hair) var(--space-1-5); cursor: pointer;
+}
+.ds-247420 .ov-menubutton-retry:hover, .ds-247420 .ov-menubutton-retry:focus-visible { background: var(--panel-2, var(--rule)); outline: none; }
+.ds-247420 .ov-menubutton-trigger {
+    appearance: none;
+    background: var(--panel-2, transparent);
+    color: inherit; font: inherit;
+    border: 1px solid var(--rule);
+    border-radius: var(--r-1, 6px);
+    padding: 0 var(--space-2-75);
+    cursor: pointer;
+    min-height: var(--ctl-sm); height: var(--ctl-sm);
+    display: inline-flex; align-items: center;
+}
+@media (pointer: coarse) {
+    .ds-247420 .ov-menubutton-trigger { min-height: 44px; }
+}
+
+/* ---------------------------------------------------------------
+   InfoRow / InfoSection / DiagnosticsPanel — static debug readouts
+   --------------------------------------------------------------- */
+.ds-247420 .ds-ep-diagnostics { display: flex; flex-direction: column; gap: var(--space-3); }
+.ds-247420 .ds-ep-diagnostics-head { display: flex; align-items: center; justify-content: space-between; gap: var(--space-2); }
+.ds-247420 .ds-ep-diagnostics-title { margin: 0; font-size: var(--fs-lg); }
+.ds-247420 .ds-ep-diagnostics-refresh {
+    appearance: none; background: var(--panel-2, transparent); color: inherit; font: inherit;
+    border: 1px solid var(--rule); border-radius: var(--r-1, 6px);
+    padding: var(--space-1) var(--space-2-75); cursor: pointer;
+}
+.ds-247420 .ds-ep-diagnostics-refresh:disabled { opacity: 0.6; cursor: not-allowed; }
+.ds-247420 .ds-ep-diagnostics-refresh:hover:not(:disabled), .ds-247420 .ds-ep-diagnostics-refresh:focus-visible { background: var(--panel-3, var(--rule)); outline: none; }
+.ds-247420 .ds-ep-infosection { border: 1px solid var(--rule); border-radius: var(--r-2, 8px); padding: var(--space-2-75); }
+.ds-247420 .ds-ep-infosection-title { margin: 0 0 var(--space-1-5); font-size: var(--fs-sm); text-transform: uppercase; letter-spacing: 0.04em; color: var(--fg-muted); }
+.ds-247420 .ds-ep-infosection-rows { display: flex; flex-direction: column; gap: var(--space-1); }
+.ds-247420 .ds-ep-infosection-loading { padding: var(--space-2) 0; color: var(--fg-muted); font-size: var(--fs-sm); }
+.ds-247420 .ds-ep-inforow { display: flex; align-items: baseline; gap: var(--space-2); justify-content: space-between; }
+.ds-247420 .ds-ep-inforow-label { color: var(--fg-muted); font-size: var(--fs-sm); flex-shrink: 0; }
+.ds-247420 .ds-ep-inforow-value { font-family: var(--font-mono, monospace); font-size: var(--fs-sm); text-align: right; word-break: break-word; }
+
+/* BatchProgressLabel */
+.ds-247420 .ds-ep-batchprogress { font-variant-numeric: tabular-nums; }
+
 /* Interaction primitives — drag/drop + keyboard shortcuts */
 .ds-247420 .ds-reorderable { display: flex; gap: var(--space-1, 4px); }
 .ds-247420 .ds-reorderable-vertical { flex-direction: column; }