agentgui 1.0.1044 → 1.0.1046

package/.claude/workflows/gui-claude-code-parity.js

@@ -11,7 +11,7 @@ export const meta = {
 
 // Shared grounding. Nine sweeps have shipped; this one hunts whether what shipped LOOKS and FEELS like the Claude Code web GUI.
 const GROUND =
-  ' GROUND IN REAL SOURCE (read, do not guess - nine sweeps HAVE shipped: jank audit, redesign, polish, cohesion, completion, logic-predictability; the app already has a three-column WorkspaceShell, a ConversationList rail, a full-CRUD Files manager, a SessionDashboard live view, a ContextPane, structured tool cards, per-block code copy, hash routing, edit/retry/export/followups): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js,form-primitives.js,theme-toggle.js} + dist CSS {app-shell.css,chat.css}; server c:\\dev\\agentgui\\lib\\http-handler.js + server.js; the fsbrowse reference is c:\\dev\\fsbrowse. AGENTS.md + the PUNCHLIST-*.md files record what already landed - do NOT re-report it; hunt what still looks primitive or feels un-Claude-Code.' +
+  ' GROUND IN REAL SOURCE (read, do not guess - nine sweeps HAVE shipped: jank audit, redesign, polish, cohesion, completion, logic-predictability; the app already has a three-column WorkspaceShell, a ConversationList rail, a full-CRUD Files manager, a SessionDashboard live view, a ContextPane, structured tool cards, per-block code copy, hash routing, edit/retry/export/followups): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js,form-primitives.js,theme-toggle.js} + dist CSS {app-shell.css,chat.css}; server c:\\dev\\agentgui\\lib\\http-handler.js + server.js; the fsbrowse reference is c:\\dev\\fsbrowse. AGENTS.md records what already landed - do NOT re-report it; hunt what still looks primitive or feels un-Claude-Code.' +
   ' POLICY: fully-destructive run - reshape anything; ALL visual/component/layout work lands in the KIT as defaults/props/CSS; the app keeps state+callback wiring only; NEVER add new index.html !important overrides; use kit design tokens (CSS vars) not raw hex; NO decorative glyphs (ASCII words + CSS .status-dot-disc) but KEEP the typographic set middot/ellipsis/em-en-dash; any server mutation stays confineToRoots realpath-confined; every visual change must preserve a11y (roles/aria/focus rings/44x44 touch/keyboard), responsive behavior (420px to wide desktop, no h-scroll), reduced-motion guards on any new animation, and explicit empty/loading/error composition.';
 
 const LENSES = [
@@ -65,7 +65,7 @@ const verified = await pipeline(
     agent(
       'Adversarially verify this Claude-Code-web design-language finding against the REAL source (read the cited files - do not trust the claim). '
       + 'KEPT-TYPOGRAPHY GUARD: middot, ellipsis, em/en-dash are intentional product typography - flagging one of those as a decorative glyph is NOT a real finding (real=false). '
-      + 'A finding is real only if the gap genuinely exists in the shipped source AND was not already fixed by a prior sweep (check the PUNCHLIST-*.md files / AGENTS.md) AND the proposed fix is sound, lands in the right place (kit vs app vs server, visual work in the KIT not the app), uses tokens not hex, preserves a11y + reduced-motion + responsive, and any server mutation stays confinement-safe. '
+      + 'A finding is real only if the gap genuinely exists in the shipped source AND was not already fixed by a prior sweep (check AGENTS.md) AND the proposed fix is sound, lands in the right place (kit vs app vs server, visual work in the KIT not the app), uses tokens not hex, preserves a11y + reduced-motion + responsive, and any server mutation stays confinement-safe. '
       + 'Reject vague taste-only findings with no concrete source-grounded fix. '
       + 'Finding: ' + JSON.stringify(g),
       { label: 'verify:' + (g.title || '').slice(0, 32), phase: 'Verify', schema: VERDICT_SCHEMA }

package/.claude/workflows/gui-completion.js

@@ -11,7 +11,7 @@ export const meta = {
 
 // Shared grounding. Seven sweeps have shipped; this one hunts what they SKIPPED.
 const GROUND =
-  ' GROUND IN REAL SOURCE (read, do not guess - seven polish/cohesion sweeps HAVE shipped; hunt what they SKIPPED): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js} + {app-shell.css,chat.css}; server c:\\dev\\agentgui\\lib\\http-handler.js (confineToRoots helper) + lib\\routes-upload.js (legacy, conversationId-keyed) + server.js. The fsbrowse full file manager at c:\\dev\\fsbrowse (index.js checkPermissions/rename/delete/mkdir/upload + public/app.js hash routing/stepViewer) is the file-management bar. PUNCHLIST-COHESION.md + AGENTS.md record the documented scope cuts: file rename/delete (read-only), upload (legacy endpoint not reusable), retry last-turn-only, dir deep-links never landed, followups static-only.' +
+  ' GROUND IN REAL SOURCE (read, do not guess - seven polish/cohesion sweeps HAVE shipped; hunt what they SKIPPED): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js} + {app-shell.css,chat.css}; server c:\\dev\\agentgui\\lib\\http-handler.js (confineToRoots helper) + lib\\routes-upload.js (legacy, conversationId-keyed) + server.js. The fsbrowse full file manager at c:\\dev\\fsbrowse (index.js checkPermissions/rename/delete/mkdir/upload + public/app.js hash routing/stepViewer) is the file-management bar. AGENTS.md records the documented scope cuts: file rename/delete (read-only), upload (legacy endpoint not reusable), retry last-turn-only, dir deep-links never landed, followups static-only.' +
   ' POLICY: this is a fully-destructive run - scope cuts may be REVERSED, but every new mutation endpoint MUST be confineToRoots realpath-confined (403 out-of-roots + traversal + symlink-escape) and witnessed. ALL visual/component work lands in the KIT as defaults/props; app keeps state+callback wiring; NEVER new index.html !important overrides; kit tokens not hex; NO decorative glyphs (ASCII words + CSS .status-dot-disc) but KEEP middot/ellipsis/em-en-dash; every new surface needs a11y (roles/aria/focus/44x44/keyboard), responsive (420px), explicit empty/loading/error states, and plain-language error copy.';
 
 const LENSES = [

package/.claude/workflows/gui-logic-predictability.js

@@ -11,7 +11,7 @@ export const meta = {
 
 // Shared grounding. Eight sweeps have shipped; this one audits whether what shipped OPERATES logically and predictably.
 const GROUND =
-  ' GROUND IN REAL SOURCE (read, do not guess - eight sweeps HAVE shipped: jank audit, redesign, polish, cohesion, completion; the Files manager has full CRUD, hash routing carries tab/sid/dir/file/q/project/section, conversation has edit/retry/export/followups, resilience has ws-grace/health-reprobe/install-hints): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js,forms.js} + {app-shell.css,chat.css}; server c:\\dev\\agentgui\\lib\\http-handler.js + lib\\ws-handlers-util.js + server.js. PUNCHLIST-COMPLETION.md + PUNCHLIST-COHESION.md + AGENTS.md record what already landed - do NOT re-report it; hunt what still operates illogically or unpredictably.' +
+  ' GROUND IN REAL SOURCE (read, do not guess - eight sweeps HAVE shipped: jank audit, redesign, polish, cohesion, completion; the Files manager has full CRUD, hash routing carries tab/sid/dir/file/q/project/section, conversation has edit/retry/export/followups, resilience has ws-grace/health-reprobe/install-hints): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js,forms.js} + {app-shell.css,chat.css}; server c:\\dev\\agentgui\\lib\\http-handler.js + lib\\ws-handlers-util.js + server.js. AGENTS.md records what already landed - do NOT re-report it; hunt what still operates illogically or unpredictably.' +
   ' POLICY: fully-destructive run - reshape anything; ALL visual/component work lands in the KIT as defaults/props; app keeps state+callback wiring; NEVER new index.html !important overrides; kit tokens not hex; NO decorative glyphs (ASCII words + CSS .status-dot-disc) but KEEP middot/ellipsis/em-en-dash; any server mutation stays confineToRoots realpath-confined; every change needs a11y (roles/aria/focus/44x44/keyboard), responsive (420px), explicit empty/loading/error states, plain-language copy.';
 
 const LENSES = [
@@ -65,7 +65,7 @@ const verified = await pipeline(
     agent(
       'Adversarially verify this GUI logic/predictability finding against the REAL source (read the cited files - do not trust the claim). '
       + 'KEPT-TYPOGRAPHY GUARD: middot, ellipsis, em/en-dash are intentional product typography - flagging one of those as a decorative glyph is NOT a real finding (real=false). '
-      + 'A finding is real only if the behavior genuinely exists in the shipped source AND was not already fixed by a prior sweep (check PUNCHLIST-COMPLETION.md / PUNCHLIST-COHESION.md / AGENTS.md) AND the proposed fix is sound, lands in the right place (kit vs app vs server), and any server mutation stays confinement-safe. '
+      + 'A finding is real only if the behavior genuinely exists in the shipped source AND was not already fixed by a prior sweep (check AGENTS.md) AND the proposed fix is sound, lands in the right place (kit vs app vs server), and any server mutation stays confinement-safe. '
       + 'Reject vague findings with no concrete source-grounded fix. '
       + 'Finding: ' + JSON.stringify(g),
       { label: 'verify:' + (g.title || '').slice(0, 32), phase: 'Verify', schema: VERDICT_SCHEMA }

package/.claude/workflows/gui-screen-realestate.js

@@ -10,7 +10,7 @@ export const meta = {
 };
 
 const GROUND =
-  ' GROUND IN REAL SOURCE (read, do not guess - TEN sweeps HAVE shipped incl the 10th-run Claude-Code-web parity: flat full-width chat turns (.chat-msg-flat), calm rounded-rect composer, bordered tool cards, .ws-main content gutter + mainFlush, folder icons, live command-center with status buckets/breakdown/heartbeat/select-all, motion easing): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js,form-primitives.js} + colors_and_type.css + app-shell.css + chat.css; server c:\\dev\\agentgui\\lib\\http-handler.js. KEY current widths: .ws-shell --ws-rail-w 232px, --ws-sessions-w 296px, --ws-pane-w 320px (≈848px of chrome before content); .ws-main padding var(--space-4) var(--space-5); chat thread caps at --measure 68ch; --space scale 4/8/16/24/32px. AGENTS.md + PUNCHLIST-*.md record what already landed - do NOT re-report it; hunt WASTED SPACE and LOW DENSITY.' +
+  ' GROUND IN REAL SOURCE (read, do not guess - TEN sweeps HAVE shipped incl the 10th-run Claude-Code-web parity: flat full-width chat turns (.chat-msg-flat), calm rounded-rect composer, bordered tool cards, .ws-main content gutter + mainFlush, folder icons, live command-center with status buckets/breakdown/heartbeat/select-all, motion easing): agentgui front-end c:\\dev\\agentgui\\site\\app\\js\\app.js + backend.js + index.html; kit c:\\dev\\anentrypoint-design\\src\\components\\{shell.js,sessions.js,agent-chat.js,chat.js,files.js,files-modals.js,context-pane.js,content.js,form-primitives.js} + colors_and_type.css + app-shell.css + chat.css; server c:\\dev\\agentgui\\lib\\http-handler.js. KEY current widths: .ws-shell --ws-rail-w 232px, --ws-sessions-w 296px, --ws-pane-w 320px (≈848px of chrome before content); .ws-main padding var(--space-4) var(--space-5); chat thread caps at --measure 68ch; --space scale 4/8/16/24/32px. AGENTS.md records what already landed - do NOT re-report it; hunt WASTED SPACE and LOW DENSITY.' +
   ' POLICY: fully-destructive run - reshape anything; ALL visual/layout/density work lands in the KIT as defaults/props/CSS; the app keeps state+callback wiring only; NEVER add new index.html !important overrides; use kit design tokens (CSS vars) not raw hex; NO decorative glyphs (ASCII words + CSS .status-dot-disc) but KEEP the typographic set middot/ellipsis/em-en-dash; any server mutation stays confineToRoots realpath-confined; preserve a11y (roles/aria/focus rings/44x44 touch where pointer is coarse/keyboard), responsive behavior (420px to ultrawide, no h-scroll), reduced-motion guards, and explicit empty/loading/error composition. Density must NOT sacrifice readability or a11y minimums.';
 
 const LENSES = [
@@ -64,7 +64,7 @@ const verified = await pipeline(
     agent(
       'Adversarially verify this screen-real-estate / density / SDK-as-application finding against the REAL source (read the cited files - do not trust the claim). '
       + 'KEPT-TYPOGRAPHY GUARD: middot, ellipsis, em/en-dash are intentional product typography - flagging one as a decorative glyph is NOT a real finding (real=false). '
-      + 'A finding is real only if the gap genuinely exists in the shipped source AND was not already fixed by a prior sweep (check the PUNCHLIST-*.md files / AGENTS.md) AND the fix is sound, lands in the right place (visual/layout in the KIT not the app), uses tokens not hex, and preserves a11y minimums + readability + responsive (no new h-scroll) + reduced-motion. '
+      + 'A finding is real only if the gap genuinely exists in the shipped source AND was not already fixed by a prior sweep (check AGENTS.md) AND the fix is sound, lands in the right place (visual/layout in the KIT not the app), uses tokens not hex, and preserves a11y minimums + readability + responsive (no new h-scroll) + reduced-motion. '
       + 'Reject density changes that would harm readability/touch-targets/contrast, and reject vague taste-only findings with no concrete source-grounded fix. '
       + 'Finding: ' + JSON.stringify(g),
       { label: 'verify:' + (g.title || '').slice(0, 32), phase: 'Verify', schema: VERDICT_SCHEMA }

package/.gm/prd.yml

@@ -2933,3 +2933,28 @@
   notes: push kit + agentgui changes, confirm CI green both repos
   status: completed
   witness: 'Both repos pushed and CI green: agentgui git_finalize sha e1949a4 (Publish and Release, Deploy GH Pages, Test, Auto-Declaudeify all conclusion=success per gh run list); design repo rebased onto origin/main (bb31857) and pushed sha 4de1771 (Publish 247420 to npm, Deploy GH Pages both conclusion=success). .gm/exec-spool/.ci-validated updated via fs_write to head_sha e1949a42f94d614a1d178a807c4a14ca84ca04cb (current agentgui HEAD, confirmed via git_status/git rev-parse HEAD match).'
+- id: cleanup-verify-punchlist-usage
+  subject: Verify whether PUNCHLIST-*.md files are load-bearing before deleting
+  notes: codesearch found 2 workflow scripts (gui-logic-predictability.js, gui-completion.js) reference PUNCHLIST-COMPLETION.md/PUNCHLIST-COHESION.md by name in agent prompts as content to check against, to avoid re-reporting already-fixed findings - not dead references. This changes the original hand-off assumption; must update those 2 prompts to point at AGENTS.md (which has the same history, denser and current) before deleting the files, not delete blind.
+  status: completed
+  witness: 'grep -rln PUNCHLIST .claude/workflows/*.js found 4 scripts (not 2): gui-claude-code-parity.js, gui-completion.js, gui-logic-predictability.js, gui-screen-realestate.js - all reference PUNCHLIST-*.md by name/glob in agent prompts to avoid re-reporting already-fixed findings. Confirmed load-bearing, not dead filename references.'
+- id: cleanup-delete-dead-punchlist-files
+  subject: Delete the 10 stale PUNCHLIST-*.md files after workflow refs are updated
+  notes: PUNCHLIST-COHESION.md, PUNCHLIST-COMPLETION.md, PUNCHLIST-DENSITY.md, PUNCHLIST-DESIGN-14.md, PUNCHLIST-DESIGN-15.md, PUNCHLIST-DESIGN.md, PUNCHLIST-LOGIC.md, PUNCHLIST-PARITY.md, PUNCHLIST-POLISH.md, PUNCHLIST-UX.md - all findings already resolved+merged, all runs already summarized in AGENTS.md history. ~440KB of stale historical documentation violating the project's own Documentation Policy (git log/CHANGELOG carries history, not standing docs).
+  status: completed
+  witness: git rm removed all 10 PUNCHLIST-*.md files (COHESION/COMPLETION/DENSITY/DESIGN/DESIGN-14/DESIGN-15/LOGIC/PARITY/POLISH/UX). Confirmed 0 remaining live-code references (grep -rln PUNCHLIST *.js *.yml *.json returns only .gm/prd.yml this session's own rows, and AGENTS.md/CHANGELOG.md's narrative past-tense mentions which are fine per Documentation Policy). Syntax of all 4 edited workflow scripts verified valid via node Function() wrap (top-level return is legal in the real Workflow-tool execution context, not standalone node).
+- id: cleanup-scan-other-workflow-scripts-for-refs
+  subject: Scan all .claude/workflows/*.js files (not just the 2 found) for any other PUNCHLIST-*.md references before deleting
+  notes: Only checked gui-logic-predictability.js and gui-completion.js via codesearch hit; must confirm no other workflow script (gui-audit.js, gui-cohesion.js, gui-overhaul.js, gui-predictability-polish.js, gui-screen-realestate.js, gui-claude-code-parity.js, gui-ux-craft.js, gui-ai-tell-sweep.js, gui-design-consolidation.js) references any of the other 8 files being deleted (PUNCHLIST-DENSITY/DESIGN/DESIGN-14/DESIGN-15/PARITY/POLISH/UX).
+  status: completed
+  witness: grep -rln PUNCHLIST .claude/workflows/*.js -> found gui-claude-code-parity.js and gui-screen-realestate.js in addition to the 2 already known (gui-completion.js, gui-logic-predictability.js). All 4 identified; rescoping cleanup-update-workflow-refs to cover all 4 files.
+- id: cleanup-commit-push-verify
+  subject: Commit the punchlist cleanup + workflow-ref update, push, witness CI green
+  notes: agentgui-only change (workflow scripts + doc deletion), no kit involvement expected unless scan in cleanup-scan-other-workflow-scripts-for-refs finds a kit-side workflow reference.
+  status: completed
+  witness: 'Pushed 0e6c218. All 4 CI workflows green: Deploy GH Pages, Publish and Release, Auto-Declaudeify, Test (bun test.js 28/28 pass). No kit repo touched this pass (workflow scripts + doc deletion only, agentgui-only).'
+- id: cleanup-update-workflow-refs
+  subject: Update gui-logic-predictability.js and gui-completion.js to reference AGENTS.md instead of the PUNCHLIST-*.md files being deleted
+  notes: Both scripts' agent prompts say 'check PUNCHLIST-COMPLETION.md / PUNCHLIST-COHESION.md / AGENTS.md'; edit both prompts this session so they say 'check AGENTS.md' only, before the PUNCHLIST files are deleted, so no workflow prompt references a nonexistent file.
+  status: completed
+  witness: grep -rn PUNCHLIST .claude/workflows/*.js returns 0 matches after editing gui-logic-predictability.js (2 edits), gui-completion.js (1 edit), gui-claude-code-parity.js (2 edits), gui-screen-realestate.js (2 edits) to reference AGENTS.md alone.

package/package.json

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