@reticlehq/browser 2.13.1 → 2.14.0

package/dist/presenter/presenter-glow.js

@@ -1,15 +1,6 @@
 import { PresenterMode } from '@reticlehq/core';
 import { nativeSetTimeout, nativeClearTimeout } from '../timers/native-timers.js';
 import { GlowPhase, BorderMode, DATA_BUSY, BUSY_ON, BUSY_OFF, GLOW_ON, GLOW_OFF, DATA_ON, } from './presenter-config.js';
-/**
- * The glow / activity state machine - drives the border shimmer + synthetic-cursor visibility from
- * agent-activity timing. Extracted from presenter.ts so the controller file stays under the size cap;
- * behavior is byte-for-byte the same. It holds references to the same `#glow`/`#cursor` nodes the
- * Presenter does (both call setAttribute on those elements - the Presenter owns the SESSION border via
- * data-on; this owns the BUSY shimmer via data-busy). A burst flips the glow IN once, holds it (the
- * slow reticle-pulse keeps breathing - no per-action restart/strobe), then fades it OUT once after a quiet
- * window.
- */
 export class GlowController {
     #phase = GlowPhase.IDLE;
     #lastActivityMs = 0;
@@ -29,38 +20,28 @@ export class GlowController {
         this.#borderMode = deps.borderMode;
         this.#setMode = deps.setMode;
     }
-    /** Wire the glow + cursor elements after the Presenter mounts the DOM. */
     setElements(glow, cursor) {
         this.#glow = glow;
         this.#cursor = cursor;
     }
-    /** Current glow phase (test/diagnostic accessor). */
     phase() {
         return this.#phase;
     }
-    /** Last activity timestamp - read by the Presenter's liveness heartbeat. */
     lastActivityMs() {
         return this.#lastActivityMs;
     }
-    /** Set the activity baseline WITHOUT entering busy (sessionStart / revive). */
     resetActivity(ms) {
         this.#lastActivityMs = ms;
     }
-    /**
-     * Record agent activity. Idempotent while busy - only the first activity from idle/fading flips the
-     * glow on (no strobe). `ms` lets log read the clock exactly once per row.
-     */
     markActivity(ms = this.#now()) {
         this.#lastActivityMs = ms;
         if (this.#phase === GlowPhase.IDLE || this.#phase === GlowPhase.FADING)
             this.#enterBusy();
         this.#armIdleCheck();
     }
-    /** Re-arm the quiet-window idle check (kept for reticle.ts's finally block). */
     scheduleIdle() {
         this.#armIdleCheck();
     }
-    /** Clear both timers (called from Presenter.destroy). */
     teardown() {
         if (this.#idleCheckTimer !== undefined)
             nativeClearTimeout(this.#idleCheckTimer);
@@ -76,14 +57,11 @@ export class GlowController {
         }
         this.#phase = GlowPhase.BUSY;
         if (this.#borderMode === BorderMode.SESSION) {
-            // Session mode: modulate only the shimmer; the base border (data-on) stays session-owned.
             this.#glow?.setAttribute(DATA_BUSY, BUSY_ON);
         }
         else {
-            // back-compat: the busy machine owns the base border.
             this.#glow?.setAttribute(DATA_ON, GLOW_ON);
         }
-        // The HUD/log is session-owned (sessionStart/End), NOT toggled here - it stays put on idle.
         this.#cursor?.setAttribute(DATA_ON, GLOW_ON);
     }
     #armIdleCheck() {
@@ -97,7 +75,6 @@ export class GlowController {
             return;
         const quietFor = this.#now() - this.#lastActivityMs;
         if (quietFor < this.#idleAfterMs) {
-            // Activity landed during the wait; re-arm for only the remaining quiet time.
             this.#idleCheckTimer = nativeSetTimeout(() => this.#checkIdle(), this.#idleAfterMs - quietFor);
             return;
         }
@@ -106,16 +83,13 @@ export class GlowController {
     #beginFade() {
         this.#phase = GlowPhase.FADING;
         if (this.#borderMode === BorderMode.SESSION) {
-            // Session mode: relax the shimmer only; the base border stays on.
             this.#glow?.setAttribute(DATA_BUSY, BUSY_OFF);
         }
         else {
-            // back-compat: fade the base border out.
             this.#glow?.setAttribute(DATA_ON, GLOW_OFF);
         }
-        // Do NOT hide the HUD/log on idle - it persists for the whole session (sessionStart/End).
         this.#cursor?.setAttribute(DATA_ON, GLOW_OFF);
-        this.#setMode(PresenterMode.IDLE); // clear the READING/ACTING chip when going quiet
+        this.#setMode(PresenterMode.IDLE);
         this.#fadeTimer = nativeSetTimeout(() => {
             this.#fadeTimer = undefined;
             if (this.#phase === GlowPhase.FADING)

package/dist/presenter/presenter-heroicons-data.d.ts

@@ -1,5 +1,3 @@
-/** Generated by scripts/embed-heroicons.mjs - do not edit by hand. */
-/** Heroicons outline - MIT, https://heroicons.com */
 declare const BODIES: {
     view: string;
     pointer: string;
@@ -21,14 +19,8 @@ declare const BODIES: {
     'caret-right': string;
     annotate: string;
 };
-/**
- * No `as const` on the values: it would inline every icon's path data into the emitted `.d.ts` as a
- * literal type, publishing the whole icon set twice for type information no caller can use. The KEYS
- * are still literal, which is the part `HeroIconBodyKey` needs.
- */
 export declare const HERO_ICON_BODIES: Record<keyof typeof BODIES, string>;
 export type HeroIconBodyKey = keyof typeof BODIES;
-/** Solid variants for toolbar toggles - shown when data-active="1". */
 declare const SOLID_BODIES: {
     chart: string;
     annotate: string;

package/dist/presenter/presenter-heroicons-data.js

@@ -1,5 +1,3 @@
-/** Generated by scripts/embed-heroicons.mjs - do not edit by hand. */
-/** Heroicons outline - MIT, https://heroicons.com */
 const BODIES = {
     view: '<g><path d="M15 12a3 3 0 1 1-6 0a3 3 0 0 1 6 0"/><path d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7c-1.274 4.057-5.064 7-9.542 7s-8.268-2.943-9.542-7"/></g>',
     pointer: '<path d="M15.042 21.672L13.684 16.6m0 0l-2.51 2.225l.569-9.47l5.227 7.917l-3.286-.672ZM12 2.25V4.5m5.834.166l-1.591 1.591M20.25 10.5H18M7.757 14.743l-1.59 1.59M6 10.5H3.75m4.007-4.243l-1.59-1.59"/>',
@@ -21,13 +19,7 @@ const BODIES = {
     'caret-right': '<path d="m9 5l7 7l-7 7"/>',
     annotate: '<path d="m16.862 4.487l1.687-1.688a1.875 1.875 0 1 1 2.652 2.652L10.582 16.07a4.5 4.5 0 0 1-1.897 1.13L6 18l.8-2.685a4.5 4.5 0 0 1 1.13-1.897l8.932-8.931Zm0 0L19.5 7.125M18 14v4.75A2.25 2.25 0 0 1 15.75 21H5.25A2.25 2.25 0 0 1 3 18.75V8.25A2.25 2.25 0 0 1 5.25 6H10"/>',
 };
-/**
- * No `as const` on the values: it would inline every icon's path data into the emitted `.d.ts` as a
- * literal type, publishing the whole icon set twice for type information no caller can use. The KEYS
- * are still literal, which is the part `HeroIconBodyKey` needs.
- */
 export const HERO_ICON_BODIES = BODIES;
-/** Solid variants for toolbar toggles - shown when data-active="1". */
 const SOLID_BODIES = {
     chart: '<path fill="currentColor" d="M2 11a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1zm6-4a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1zm6-3a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v12a1 1 0 0 1-1 1h-2a1 1 0 0 1-1-1z"/>',
     annotate: '<path fill="currentColor" fill-rule="evenodd" d="m5.433 13.916l1.262-3.154a4 4 0 0 1 .885-1.343L14.5 2.5a2.121 2.121 0 1 1 3 3l-6.92 6.919c-.383.383-.84.684-1.343.885l-3.154 1.262a.5.5 0 0 1-.65-.65ZM2.5 5.75c0-.69.56-1.25 1.25-1.25H10A.75.75 0 0 0 10 3H3.75A2.75 2.75 0 0 0 1 5.75v10.5A2.75 2.75 0 0 0 3.75 19h10.5A2.75 2.75 0 0 0 17 16.25V10a.75.75 0 0 0-1.5 0v6.25c0 .69-.56 1.25-1.25 1.25H3.75c-.69 0-1.25-.56-1.25-1.25V5.75Z" clip-rule="evenodd"/>',

package/dist/presenter/presenter-hud-chrome.d.ts

@@ -1,17 +1,7 @@
-/** Shared polished-black surfaces used across HUD chrome panels. */
 export declare const HUD_SURFACE_CLASS = "reticle-hud-surface";
-/** Layered near-black base — no embedded image assets. */
 export declare const HUD_SURFACE_FILL: string;
 export declare const HUD_SURFACE_PAINT: string;
 export declare const HUD_DROP_SHADOW: string;
 export declare const HUD_CHROME_CSS: string;
-/** Inset well for the activity log — sits inside the chat card. */
 export declare const HUD_LOG_WELL_CLASS = "reticle-hud-log-well";
-/**
- * The activity feed sits ON the panel, not in a black box cut out of it.
- *
- * The inset well was a second surface inside a surface - two borders, two backgrounds - and it made
- * the panel read as a container rather than as one card. It also grew and shrank with its content,
- * so the panel resized on every row; the height is fixed now and the feed scrolls inside it.
- */
 export declare const HUD_LOG_WELL_CSS: string;

package/dist/presenter/presenter-hud-chrome.js

@@ -1,6 +1,4 @@
-/** Shared polished-black surfaces used across HUD chrome panels. */
 export const HUD_SURFACE_CLASS = 'reticle-hud-surface';
-/** Layered near-black base — no embedded image assets. */
 export const HUD_SURFACE_FILL = `linear-gradient(165deg,#121218 0%,#09090c 42%,#000 100%)`;
 export const HUD_SURFACE_PAINT = `background:${HUD_SURFACE_FILL};box-shadow:inset 0 1px 0 rgba(255,255,255,.09),0 0 0 1px rgba(255,255,255,.09);`;
 export const HUD_DROP_SHADOW = '0 16px 40px rgba(0,0,0,.58),0 0 0 1px rgba(255,255,255,.08)';
@@ -18,15 +16,7 @@ export const HUD_CHROME_CSS = `
     linear-gradient(180deg,rgba(255,255,255,.035) 0%,transparent 36%,rgba(0,0,0,.12) 100%);
 }
 .${HUD_SURFACE_CLASS} > *{position:relative;z-index:2;}`;
-/** Inset well for the activity log — sits inside the chat card. */
 export const HUD_LOG_WELL_CLASS = 'reticle-hud-log-well';
-/**
- * The activity feed sits ON the panel, not in a black box cut out of it.
- *
- * The inset well was a second surface inside a surface - two borders, two backgrounds - and it made
- * the panel read as a container rather than as one card. It also grew and shrank with its content,
- * so the panel resized on every row; the height is fixed now and the feed scrolls inside it.
- */
 export const HUD_LOG_WELL_CSS = `
 .${HUD_LOG_WELL_CLASS}{
   /* A settled height, but still allowed to shrink: pinned with flex:none it pushed the composer

package/dist/presenter/presenter-icons.d.ts

@@ -1,5 +1,4 @@
 import { type HeroIconBodyKey, type HeroIconSolidBodyKey } from './presenter-heroicons-data.js';
-/** Presenter icon keys used by the HUD. */
 export declare const PresenterIcon: {
     readonly VIEW: "view";
     readonly POINTER: "pointer";
@@ -22,7 +21,6 @@ export declare const PresenterIcon: {
     readonly ANNOTATE: "annotate";
 };
 export type PresenterIconName = (typeof PresenterIcon)[keyof typeof PresenterIcon];
-/** Shared HUD icon sizes (px) - one knob for visual density. */
 export declare const PRESENTER_ICON_SIZE: {
     readonly CHIP: 11;
     readonly LOG: 11;
@@ -34,11 +32,7 @@ export declare const PRESENTER_ICON_SIZE: {
     readonly TOOLBAR: 18;
     readonly FAB: 22;
 };
-/** Create an inline Heroicons outline SVG (24px grid, currentColor stroke). */
 export declare function hiIcon(name: HeroIconBodyKey, sizePx?: number): HTMLSpanElement;
-/** Replace a parent's children with a Heroicon. */
 export declare function setHiIcon(parent: HTMLElement, name: HeroIconBodyKey, sizePx?: number): void;
-/** Inline SVG markup for static HUD templates - survives mount order and dep-cache staleness. */
 export declare function hiIconHtml(name: HeroIconBodyKey, sizePx?: number): string;
-/** Outline + solid pair for toolbar toggles - solid layer shows when the button is active. */
 export declare function hiToggleIconHtml(name: HeroIconSolidBodyKey, sizePx?: number): string;

package/dist/presenter/presenter-icons.js

@@ -1,5 +1,4 @@
 import { HERO_ICON_BODIES, HERO_ICON_SOLID_BODIES, } from './presenter-heroicons-data.js';
-/** Presenter icon keys used by the HUD. */
 export const PresenterIcon = {
     VIEW: 'view',
     POINTER: 'pointer',
@@ -21,7 +20,6 @@ export const PresenterIcon = {
     CARET_RIGHT: 'caret-right',
     ANNOTATE: 'annotate',
 };
-/** Shared HUD icon sizes (px) - one knob for visual density. */
 export const PRESENTER_ICON_SIZE = {
     CHIP: 11,
     LOG: 11,
@@ -61,7 +59,6 @@ function buildSvg(name, sizePx) {
     svgCache.set(cacheKey, svg);
     return document.importNode(svg, true);
 }
-/** Create an inline Heroicons outline SVG (24px grid, currentColor stroke). */
 export function hiIcon(name, sizePx = 16) {
     const wrap = document.createElement('span');
     wrap.className = 'reticle-hi-icon';
@@ -71,11 +68,9 @@ export function hiIcon(name, sizePx = 16) {
     wrap.appendChild(buildSvg(name, sizePx));
     return wrap;
 }
-/** Replace a parent's children with a Heroicon. */
 export function setHiIcon(parent, name, sizePx = 16) {
     parent.replaceChildren(hiIcon(name, sizePx));
 }
-/** Inline SVG markup for static HUD templates - survives mount order and dep-cache staleness. */
 export function hiIconHtml(name, sizePx = 16) {
     const body = HERO_ICON_BODIES[name];
     if (body === undefined) {
@@ -83,7 +78,6 @@ export function hiIconHtml(name, sizePx = 16) {
     }
     return `<span class="reticle-hi-icon" aria-hidden="true" style="width:${String(sizePx)}px;height:${String(sizePx)}px"><svg xmlns="${SVG_NS}" viewBox="${HERO_VIEWBOX}" width="${String(sizePx)}" height="${String(sizePx)}" fill="none">${body}</svg></span>`;
 }
-/** Outline + solid pair for toolbar toggles - solid layer shows when the button is active. */
 export function hiToggleIconHtml(name, sizePx = 16) {
     const outline = HERO_ICON_BODIES[name];
     const solid = HERO_ICON_SOLID_BODIES[name];

package/dist/presenter/presenter-log.d.ts

@@ -1,5 +1,4 @@
 import { PresenterMode } from '@reticlehq/core';
-/** Activity-log entry kinds (presenter-only UI; never a wire string). */
 export declare const LOG_KIND: {
     readonly READ: "read";
     readonly ACT: "act";
@@ -7,58 +6,21 @@ export declare const LOG_KIND: {
     readonly HUMAN: "human";
 };
 export type LogKind = (typeof LOG_KIND)[keyof typeof LOG_KIND];
-/** Act-row outcome glyph keys (presenter-only UI). */
 export declare const LOG_RESULT: {
     readonly PASS: "pass";
     readonly FAIL: "fail";
 };
 export type LogResult = (typeof LOG_RESULT)[keyof typeof LOG_RESULT];
-/** HUD chip copy keyed by presenter mode (UI text, browser-local - not a wire string). */
 export declare const CHIP_LABEL: Record<PresenterMode, string>;
 export declare const DATA_RETICLE_LOG = "data-reticle-log";
-/**
- * The attribute on ONE log line's timestamp. Deliberately not `data-reticle-log-ts`: that name is
- * the overlay-level SETTING (show timestamps y/n) and the overlay root carries it, so a bare
- * `[data-reticle-log-ts]{opacity:.85}` here matched the overlay itself and made the entire HUD -
- * chat panel included - 85% transparent, with the page legible straight through it.
- */
 export declare const LOG_TIME_ATTR = "data-reticle-log-time";
-/** CSS for the log feed (injected with the rest of the presenter stylesheet; vars inherit from the card). */
 export declare const LOG_CSS: string;
-/**
- * Pin the feed to its newest row.
- *
- * Called on append AND when the chat is opened, because a hidden panel has no layout: rows added
- * while it was minimised could not scroll it, so opening it showed the OLDEST row and the latest
- * activity - the reason to open it - was somewhere below the fold.
- */
 export declare function scrollLogToLatest(container: HTMLElement): void;
-/**
- * Pin the feed to its newest row once the panel has actually laid out.
- *
- * A single frame is not enough on open: the rows carry `content-visibility:auto`, so their real
- * heights arrive after the first paint and `scrollHeight` keeps growing under a scroll that has
- * already happened - the feed landed a third of the way down instead of at the end. Two frames
- * plus one settle pass costs nothing and lands on the last row.
- */
 export declare function settleLogAtLatest(container: HTMLElement): void;
-/** Handle returned from logRow/Presenter.log so the caller can stamp the outcome glyph later. */
 export interface LogHandle {
     result(r: LogResult): void;
 }
-/** Clamp a logMax option to a sane positive integer, falling back to the default. */
 export declare function clampLogMax(n: number | undefined): number;
-/**
- * Pure, human-readable duration ("3s", "47s", "2m", "1h 4m") - no clock read, so it stays
- * deterministic in tests. Used for both the per-row timestamp (time since session start) and the
- * live "idle · {duration} since last action" heartbeat. Sub-second reads as "0s".
- */
 export declare function humanDuration(ms: number): string;
-/** Per-row timestamp: time since the session's first row, human-readable (e.g. "2m", not "+132.4s"). */
 export declare function formatElapsed(ms: number): string;
-/**
- * Build a log row from text (already trimmed) + a +elapsed timestamp, append it to the container,
- * prune to logMax, auto-scroll to newest, and return a handle to stamp the outcome glyph later.
- * Uses createElement/textContent (never innerHTML) so arbitrary narration text can't inject markup.
- */
 export declare function appendLogRow(container: HTMLElement, kind: LogKind, text: string, ts: string, logMax: number): LogHandle;

package/dist/presenter/presenter-log.js

@@ -1,33 +1,24 @@
 import { PresenterMode } from '@reticlehq/core';
 import { nativeSetTimeout } from '../timers/native-timers.js';
 import { PresenterIcon, PRESENTER_ICON_SIZE, hiIcon, } from './presenter-icons.js';
-// Activity-log UI for the presenter HUD: a persistent, timestamped, scrollable transcript of
-// every read/act/narration. All strings here are presenter-only UI (chips, glyphs, attrs) - they
-// never cross the browser↔bridge↔agent wire, so they stay as named consts (not protocol consts).
-// All nodes carry data-reticle-* attrs so they're excluded from snapshots (see dom-ignore.ts).
-/** Default cap on accumulated activity-log rows (bounds DOM). Presenter-local UI tunable. */
 const DEFAULT_LOG_MAX = 50;
-/** Activity-log entry kinds (presenter-only UI; never a wire string). */
 export const LOG_KIND = {
     READ: 'read',
     ACT: 'act',
     NARRATION: 'narration',
     HUMAN: 'human',
 };
-/** Act-row outcome glyph keys (presenter-only UI). */
 export const LOG_RESULT = { PASS: 'pass', FAIL: 'fail' };
 const LOG_CHIP = { read: 'READ', act: 'ACT', narration: '', human: '' };
 const LOG_CHIP_ICON = {
     read: PresenterIcon.VIEW,
     act: PresenterIcon.POINTER,
 };
-/** HUD chip copy keyed by presenter mode (UI text, browser-local - not a wire string). */
 export const CHIP_LABEL = {
     [PresenterMode.IDLE]: '',
     [PresenterMode.READING]: 'READING',
     [PresenterMode.ACTING]: 'ACTING',
 };
-/** Map a log kind to the data-mode that styles its chip (narration/human show no chip). */
 const LOG_CHIP_MODE = {
     read: PresenterMode.READING,
     act: PresenterMode.ACTING,
@@ -38,21 +29,13 @@ const RESULT_GLYPH = { pass: '', fail: 'Fail' };
 const RESULT_CLASS = { pass: 'reticle-pass', fail: 'reticle-fail' };
 export const DATA_RETICLE_LOG = 'data-reticle-log';
 const DATA_RETICLE_LOG_ROW = 'data-reticle-log-row';
-/**
- * The attribute on ONE log line's timestamp. Deliberately not `data-reticle-log-ts`: that name is
- * the overlay-level SETTING (show timestamps y/n) and the overlay root carries it, so a bare
- * `[data-reticle-log-ts]{opacity:.85}` here matched the overlay itself and made the entire HUD -
- * chat panel included - 85% transparent, with the page legible straight through it.
- */
 export const LOG_TIME_ATTR = 'data-reticle-log-time';
 const DATA_KIND = 'data-kind';
 const LOG_TEXT_CLASS = 'reticle-log-text';
 const LOG_RES_CLASS = 'reticle-res';
 const LOG_CHIP_CLASS = 'reticle-chip';
 const LOG_EMPTY_HINT = 'Agent activity will appear here';
-/** How long to keep re-pinning the feed after the panel opens, while rows render their real size. */
 const LOG_SETTLE_MS = 160;
-/** CSS for the log feed (injected with the rest of the presenter stylesheet; vars inherit from the card). */
 export const LOG_CSS = `
 [data-reticle-log]{flex:1;min-height:0;overflow-y:auto;overscroll-behavior:contain;pointer-events:auto;touch-action:pan-y;
   display:flex;flex-direction:column;
@@ -92,24 +75,9 @@ export const LOG_CSS = `
   border-radius:16px 16px 4px 16px;box-shadow:inset 0 1px 0 rgba(255,255,255,.08);}
 [data-reticle-log-row][data-kind="human"] .reticle-log-text{color:var(--reticle-fg);font-size:12px;line-height:1.45;}
 `;
-/**
- * Pin the feed to its newest row.
- *
- * Called on append AND when the chat is opened, because a hidden panel has no layout: rows added
- * while it was minimised could not scroll it, so opening it showed the OLDEST row and the latest
- * activity - the reason to open it - was somewhere below the fold.
- */
 export function scrollLogToLatest(container) {
     container.scrollTop = container.scrollHeight;
 }
-/**
- * Pin the feed to its newest row once the panel has actually laid out.
- *
- * A single frame is not enough on open: the rows carry `content-visibility:auto`, so their real
- * heights arrive after the first paint and `scrollHeight` keeps growing under a scroll that has
- * already happened - the feed landed a third of the way down instead of at the end. Two frames
- * plus one settle pass costs nothing and lands on the last row.
- */
 export function settleLogAtLatest(container) {
     scrollLogToLatest(container);
     requestAnimationFrame(() => {
@@ -118,17 +86,11 @@ export function settleLogAtLatest(container) {
     });
     nativeSetTimeout(() => scrollLogToLatest(container), LOG_SETTLE_MS);
 }
-/** Clamp a logMax option to a sane positive integer, falling back to the default. */
 export function clampLogMax(n) {
     if (n === undefined || !Number.isFinite(n) || n <= 0)
         return DEFAULT_LOG_MAX;
     return Math.floor(n);
 }
-/**
- * Pure, human-readable duration ("3s", "47s", "2m", "1h 4m") - no clock read, so it stays
- * deterministic in tests. Used for both the per-row timestamp (time since session start) and the
- * live "idle · {duration} since last action" heartbeat. Sub-second reads as "0s".
- */
 export function humanDuration(ms) {
     const s = Math.max(0, Math.floor(ms / 1000));
     if (s < 60)
@@ -139,19 +101,13 @@ export function humanDuration(ms) {
     const h = Math.floor(m / 60);
     return 0 === m % 60 ? `${h}h` : `${h}h ${m % 60}m`;
 }
-/** Per-row timestamp: time since the session's first row, human-readable (e.g. "2m", not "+132.4s"). */
 export function formatElapsed(ms) {
     return humanDuration(ms);
 }
-/**
- * Build a log row from text (already trimmed) + a +elapsed timestamp, append it to the container,
- * prune to logMax, auto-scroll to newest, and return a handle to stamp the outcome glyph later.
- * Uses createElement/textContent (never innerHTML) so arbitrary narration text can't inject markup.
- */
 export function appendLogRow(container, kind, text, ts, logMax) {
     const row = document.createElement('div');
     row.setAttribute(DATA_RETICLE_LOG_ROW, '');
-    row.setAttribute(DATA_KIND, kind); // styles the human row as an accent chat bubble
+    row.setAttribute(DATA_KIND, kind);
     const tsEl = document.createElement('span');
     tsEl.setAttribute(LOG_TIME_ATTR, '');
     tsEl.textContent = ts;

package/dist/presenter/presenter-report-copy.d.ts

@@ -1,49 +1,15 @@
 import { type ImpactScope, type ImpactSnapshot } from '@reticlehq/core';
-/**
- * What the report SAYS, kept away from how it looks.
- *
- * The wording here is the product's only claim about its own worth, so it is written once, in one
- * place, and tested. Two audiences, two registers:
- *
- *  - The REPORT is private. It is the user's own data, so it can carry everything, estimates
- *    included, as long as each estimate shows what it is measured against.
- *  - The SHARE card is public, and the research on developer stat-cards is blunt about what happens
- *    to a public card that leads with vendor savings: estimated token/time savings are the most
- *    mocked class of number in AI tooling (JetBrains measured ~10% against a viral 65% claim), and
- *    percentiles without a denominator get called misleading. So the card leads with what the
- *    user's own setup CAUGHT, and publishes its unknowns - the credibility move, and the thing a
- *    scoreboard would never do.
- */
-/** Reticle's own links, as they appear in the report footer. */
 export declare const REPORT_LINKS: {
     readonly DOCS: "https://docs.reticle.sh";
     readonly SITE: "https://reticle.sh";
     readonly GITHUB: "https://github.com/reticlehq/reticle";
     readonly DISCORD: "https://discord.gg/BwAbzv9ZRz";
 };
-/**
- * The X handle used for `via=` on a share.
- *
- * Empty until somebody who owns the account fills it in, and the share URL omits the parameter
- * while it is - a guessed handle credits a stranger, and there is no way for code to know.
- */
 export declare const SHARE_VIA_HANDLE = "";
 export declare const REPORT_TEXT: {
     readonly TITLE: "Impact";
     readonly PROJECT: "This project";
     readonly GLOBAL: "Everything on this machine";
-    /**
-     * What `counts.failed` actually is: a verdict whose declared consequence did not hold.
-     *
-     * It used to read "defects caught before you saw them", which overclaims in the one direction a
-     * verification tool must never overclaim. A failed verdict is not proof of a defect in the app —
-     * it is equally the shape of an assertion that was wrong. Measured in the field: an agent
-     * asserted a clean console on an app with ordinary dev-mode logging, the verdict went red, and
-     * the panel reported a defect nobody had found.
-     *
-     * The honest word is what Reticle DID: it refused to pass them. That is true of the assertion
-     * error and the real bug alike, and it still reads as the tool having done its job.
-     */
     readonly HERO_DEFECTS: "checks Reticle refused to pass";
     readonly VERDICTS: "Verdicts";
     readonly PASSED: "passed";
@@ -61,21 +27,14 @@ export declare const REPORT_TEXT: {
     readonly ESTIMATE_TAG: "estimate";
     readonly CHART: "Verdicts, last 30 days";
     readonly DEFECTS: "What broke";
-    readonly DEFECTS_MORE: "Manage all of them on the dashboard";
-    /**
-     * What an UNLINKED user is told, and the only place the product tells them.
-     *
-     * The dashboard link renders only when `dashboardUrl` exists, which means only once a repo is
-     * already linked — so the person most likely to want one, watching this record climb on their own
-     * machine, was never told it existed. The single mention anywhere else is a daemon log line.
-     *
-     * Stated as a FACT about where the record lives, not as a pitch. It sits at the foot of a panel
-     * somebody opened on purpose, so it informs rather than interrupts, and it appears only once
-     * there is a verdict worth keeping — an offer to preserve nothing is just an advert.
-     */
+    readonly DEFECTS_MORE: "Manage all of them on the dashboard — triage, assign, and push to GitHub";
+    readonly DEFECT_LINK_TITLE: "Open on the dashboard to triage or push to GitHub";
     readonly LOCAL_ONLY: "This record stops at this machine.";
     readonly LOCAL_ONLY_ACTION: "reticle login";
     readonly LOCAL_ONLY_TAIL: "keeps it, and lets a team see it.";
+    readonly UNLINKED: "Signed in, but this repo is not linked.";
+    readonly UNLINKED_ACTION: "reticle link";
+    readonly UNLINKED_TAIL: "sends this record to your workspace.";
     readonly DEFECTS_NONE: "Nothing has failed a declared consequence yet.";
     readonly EMPTY: "Nothing recorded yet. Drive the app once and this fills in.";
     readonly SHARE: "Share";
@@ -83,30 +42,10 @@ export declare const REPORT_TEXT: {
     readonly COPIED: "Copied";
     readonly REFER: "Send to a friend";
 };
-/** "4.2k", "1.3M" - a number a person reads at a glance rather than counts digits in. */
 export declare function compactNumber(n: number): string;
-/** "2h 14m", "47m", "38s" - the same duration vocabulary the activity strip uses. */
 export declare function compactDuration(ms: number): string;
-/**
- * The post itself.
- *
- * Leads with defects caught, then the verdict split INCLUDING unknowns, then the superlative. No
- * estimated savings, no percentile, no leaderboard: those are the four things the evidence says get
- * a dev-tool card mocked rather than shared.
- */
 export declare function buildShareText(scope: ImpactScope, projectName?: string): string;
-/** X share intent. `via` is omitted while no handle is configured. */
 export declare function buildXShareUrl(text: string): string;
-/**
- * LinkedIn share.
- *
- * `share-offsite` takes a url and NOTHING else - the title/summary parameters were deprecated in
- * 2018 and are ignored, so the caption has to reach the composer some other way. The report copies
- * it to the clipboard before opening this, which is the only path that works without asking the
- * user for posting permissions.
- */
 export declare function buildLinkedInShareUrl(): string;
-/** What a referral says: the tool, not the sender's numbers. */
 export declare function buildReferralText(): string;
-/** Narrow an unknown push payload to a snapshot. Invalid shapes are ignored, never rendered. */
 export declare function parseImpactSnapshot(value: unknown): ImpactSnapshot | undefined;