pum-agent 0.2.34-beta.1 → 0.2.35-beta.1

package/README.md

@@ -88,6 +88,7 @@ PUM uses [pi](https://github.com/earendil-works/pi) for the agent loop and
 | [Safety](docs/security.md) | Filesystem sandbox, Check mode, native sandbox, outer sandbox |
 | [Appearance](docs/appearance.md) | Transcript detail, themes, Markdown, animation, title |
 | [Configuration](docs/configuration.md) | Where PUM stores things, and what |
+| [Request diagnostics](docs/request-diagnostics.md) | Opt-in safe request reports; transport signals are not server cache hits |
 
 ## Requirements
 
@@ -119,6 +120,10 @@ bun run start
 Use `bun run start -r` to resume the latest session for the current directory,
 and `/login` to add or update a provider later.
 Inside the TUI, `/history` or its alias `/resume` opens the saved-session browser.
+For local request debugging, start with `PUM_REQUEST_DIAGNOSTICS=1 bun run start`
+and use `/diagnostics` in the selected transcript. Headless runs emit the safe
+report on stderr only. Diagnostics stay in bounded process memory, not session
+files, and do not establish provider cache hits. See [Request diagnostics](docs/request-diagnostics.md).
 
 Agents have separate context tools: `history` searches and reads the active session
 transcript. `get_context_remaining` reports the context budget. `new_context`
@@ -159,8 +164,11 @@ git diff --check
 Run the TUI from the repository root with `bun run start`, and refresh the
 README images with `bun run scripts/capture-screenshots.tsx`. Use a throwaway
 `PUM_DIR` for local integration tests, and capture TUI output through `tmux`
-rather than piping standard output. [AGENTS.md](AGENTS.md) holds the
-architecture, the locked decisions, and the TUI test guidance.
+rather than piping standard output. [AGENTS.md](AGENTS.md) holds the mandatory
+security/workflow core and routes to the [indexed current contracts](docs/agent-guidance/README.md),
+[source layout](docs/agent-guidance/layout.md), and [TUI test guidance](docs/agent-guidance/testing.md).
+Detailed rules remain mandatory; [historical research](docs/agent-guidance/historical-references.md)
+is clearly separated from current authority.
 
 ## Release status
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pum-agent",
-  "version": "0.2.34-beta.1",
+  "version": "0.2.35-beta.1",
   "description": "A compact terminal coding agent powered by pi and OpenTUI.",
   "license": "MIT",
   "type": "module",

package/src/animation.tsx

@@ -60,9 +60,9 @@ export const CARET_FADE_STEPS = 16;
 const ease = (t: number) => (1 - Math.cos(Math.max(0, Math.min(1, t)) * Math.PI)) / 2;
 
 /**
- * The caret dissolves into the background instead of switching off. The block
- * glyph stays in place for the whole cycle, so the row's width never changes
- * and no glyph swap can rewrite the text underneath it.
+ * The caret's brightness envelope. Opaque backgrounds use a smooth fade;
+ * unknown (transparent) backgrounds use its midpoint as a blink threshold.
+ * Both keep one cell occupied so the row's width never changes.
  */
 export function caretAlpha(elapsedMs: number): number {
   const phase = (((elapsedMs % CARET_PERIOD_MS) + CARET_PERIOD_MS) % CARET_PERIOD_MS)
@@ -504,7 +504,7 @@ export function useShimmerText(opts: {
     const stop = subscribe((elapsedMs) => {
       if (!ref.current) return;
       const styled = shimmer(latest.current, base, hi, elapsedMs);
-      if (caret) styled.chunks.push(fg(mixLight(behind, hi, caretAlpha(elapsedMs)))(CARET));
+      if (caret) styled.chunks.push(caretChunk(behind, hi, caretAlpha(elapsedMs)));
       ref.current.content = styled;
     });
     return () => {
@@ -521,7 +521,18 @@ export function useShimmerText(opts: {
   return ref;
 }
 
-/** Own styled text and append a width-stable fading caret while active. */
+/**
+ * Transparent has no RGB background to fade toward. Its zero RGB channels are
+ * not the terminal's colour, and terminal foreground alpha is not a portable
+ * way to recover that colour. Blink a width-stable space instead. Opaque custom
+ * backgrounds retain the smooth linear-light fade; neither path paints a bg.
+ */
+export function caretChunk(background: RGBA, lit: RGBA, strength: number): TextChunk {
+  if (background.a < 1) return fg(lit)(strength >= 0.5 ? CARET : " ");
+  return fg(mixLight(background, lit, strength))(CARET);
+}
+
+/** Own styled text and append a width-stable caret while active. */
 export function useBlinkingText(opts: {
   chunks: TextChunk[];
   contentKey: string;
@@ -543,8 +554,10 @@ export function useBlinkingText(opts: {
 
   const paint = useCallback(() => {
     if (!ref.current) return;
-    const color = mixLight(behind, lit, caretStep.current / CARET_FADE_STEPS);
-    ref.current.content = new StyledText([...latest.current, fg(color)(CARET)]);
+    ref.current.content = new StyledText([
+      ...latest.current,
+      caretChunk(behind, lit, caretStep.current / CARET_FADE_STEPS),
+    ]);
   }, [behind, lit]);
 
   useEffect(() => {