@aragon-agent/cli 0.5.4 → 0.5.8

package/dist/ui/use-startup-notices.js

@@ -25,7 +25,21 @@ import { getLogger } from '../logging/logger.js';
  */
 const MOUSE_SELECTION_NOTICE = 'Mouse wheel scrolls the transcript. Hold Shift to select text, ' +
     'or turn it off with `aragon config set mouse false`.';
-export function useStartupNotices(dispatch, mouseNotice) {
+/**
+ * The §5.1 notice (tui-render-performance). Shown once per run, and only when
+ * the user's own `transcriptRetain` was below `transcriptWindow`.
+ *
+ * The raise itself is not negotiable — retaining fewer entries than the horizon
+ * can scroll to makes part of that horizon permanently unreachable — but doing
+ * it in silence would leave a user staring at a `/perf` line that disagrees with
+ * the number in their own config file and no way to connect the two.
+ */
+function retainRaisedNotice(requested, resolved) {
+    return (`transcriptRetain ${requested} is below transcriptWindow ${resolved}; using ${resolved} ` +
+        'so the whole scroll horizon stays reachable. Lower transcriptWindow too if you meant ' +
+        'to cap memory.');
+}
+export function useStartupNotices(dispatch, mouseNotice, retainNotice) {
     // The sink gives up after repeated write failures (a read-only log directory,
     // a full disk). Silently logging nothing is exactly the state a user must not
     // discover later, from an empty file, while trying to explain a bug.
@@ -62,4 +76,24 @@ export function useStartupNotices(dispatch, mouseNotice) {
         dispatch({ type: 'notice', level: 'info', text: MOUSE_SELECTION_NOTICE });
         noticeRef.current?.onSeen();
     }, [mouseEnabled, dispatch]);
+    // A `warn` notice rather than a toast: it is about a value the user typed, so
+    // it belongs in the transcript where it can be scrolled back to, not in a row
+    // that expires. DEPENDS ON THE TWO SCALARS, never on the options object —
+    // `App` builds that literal during render, and depending on it would re-run
+    // this effect on every frame of the session.
+    const retainRequested = retainNotice?.requested;
+    const retainResolved = retainNotice?.resolved;
+    const retainNoticeShown = useRef(false);
+    useEffect(() => {
+        if (retainRequested === undefined || retainResolved === undefined)
+            return;
+        if (retainNoticeShown.current)
+            return;
+        retainNoticeShown.current = true;
+        dispatch({
+            type: 'notice',
+            level: 'warn',
+            text: retainRaisedNotice(retainRequested, retainResolved),
+        });
+    }, [retainRequested, retainResolved, dispatch]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aragon-agent/cli",
-  "version": "0.5.4",
+  "version": "0.5.8",
   "description": "AragonAgent CLI — a Claude-Code / Codex-style interactive terminal UI (TUI) on top of the @aragon-agent/core engine. Installable and runnable via npm / npx.",
   "license": "MIT",
   "author": "AragonAgent contributors",
@@ -46,12 +46,13 @@
   "scripts": {
     "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json && node scripts/prepend-shebang.mjs",
     "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
     "test": "vitest run",
     "start": "node dist/cli.js",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@aragon-agent/core": "^0.2.4",
+    "@aragon-agent/core": "^0.2.8",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.0.0",
     "commander": "^12.1.0",