@astrosheep/square 0.3.57 → 0.3.61

package/dist/list.js

@@ -5,6 +5,7 @@ import { closeOpenSquare } from './open-square.js';
 import { listPresentation } from './views.js';
 import { formatRelativeTime } from './time.js';
 import { participantIdentity, quoteShell } from './presentation.js';
+import { style } from './tty-style.js';
 const DEFAULT_LIST_DEPTH = 4;
 const MAX_LIST_DEPTH = 16;
 const DEFAULT_LIST_LIMIT = 20;
@@ -84,35 +85,37 @@ function renderSquareList(items, stopped, depth, limit, after) {
     const page = after === undefined ? items : items.filter((item) => item.path.localeCompare(after) > 0);
     const shownItems = page.slice(0, limit);
     if (items.length === 0) {
-        return [`(no squares found)`, ...(stopped ? [`○ discovery stopped after examining ${LIST_DISCOVERY_BUDGET} filesystem entries; results may be incomplete`] : [])].join('\n') + '\n';
+        return [`(no squares found)`, ...(stopped ? [style('dim', `○ the walk stopped early — deeper squares may still be hiding`)] : [])].join('\n') + '\n';
     }
     const now = Date.now();
     const lines = ['squares'];
     for (const item of shownItems) {
-        lines.push(`${item.activities > 0 ? '●' : '○'} ${characterPreview(item.path)} · ${formatRelativeTime(item.lastActiveAt, now)} · ${item.participants.length} in square · ${item.activities} activities`);
+        const glyph = item.activities > 0 ? '●' : style('dim', '○');
+        lines.push(`${glyph} ${characterPreview(item.path)}${style('dim', ` · ${formatRelativeTime(item.lastActiveAt, now)} · ${item.participants.length} in the square · ${item.activities} ${item.activities === 1 ? 'activity' : 'activities'}`)}`);
         const shownContext = item.context.slice(0, CONTEXT_PREVIEW_LINES);
         if (shownContext.length === 0) {
-            lines.push('  context · (none)');
+            lines.push(`  ${style('dim', 'context')} · (none)`);
         }
         else {
-            shownContext.forEach((line, index) => lines.push(`  ${index === 0 ? 'context' : '       '} · ${characterPreview(line)}`));
+            shownContext.forEach((line, index) => lines.push(`  ${index === 0 ? style('dim', 'context') : '       '} · ${characterPreview(line)}`));
             const hiddenContext = item.context.length - shownContext.length;
             if (hiddenContext > 0)
-                lines.push(`          · … ${hiddenContext} more ${hiddenContext === 1 ? 'line' : 'lines'}`);
+                lines.push(style('dim', `          · … ${hiddenContext} more ${hiddenContext === 1 ? 'line' : 'lines'}`));
         }
         const shownParticipants = item.participants.slice(0, PARTICIPANT_PREVIEW_COUNT);
         const hiddenParticipants = item.participants.length - shownParticipants.length;
-        lines.push(`  participants · ${shownParticipants.length === 0 ? 'nobody' : shownParticipants.map((participant) => participantIdentity(characterPreview(participant))).join(' · ')}${hiddenParticipants > 0 ? ` · … ${hiddenParticipants} more` : ''}`);
+        const participantNames = shownParticipants.length === 0 ? 'nobody' : shownParticipants.map((participant) => participantIdentity(characterPreview(participant))).join(' · ');
+        lines.push(`  ${style('dim', 'participants')} · ${participantNames}${hiddenParticipants > 0 ? style('dim', ` · … ${hiddenParticipants} more`) : ''}`);
     }
     const hiddenItems = page.length - shownItems.length;
     if (hiddenItems > 0) {
         const cursor = shownItems.at(-1)?.path;
-        lines.push(stopped ? '  … more squares' : `  … ${hiddenItems} more ${hiddenItems === 1 ? 'square' : 'squares'}`);
+        lines.push(style('dim', stopped ? '  … more squares' : `  … ${hiddenItems} more ${hiddenItems === 1 ? 'square' : 'squares'}`));
         if (cursor !== undefined)
-            lines.push(`» square list --depth ${depth} --limit ${limit} --after ${quoteShell(cursor)}`);
+            lines.push(`square list --depth ${depth} --limit ${limit} --after ${quoteShell(cursor)}`);
     }
     if (stopped)
-        lines.push(`○ discovery stopped after examining ${LIST_DISCOVERY_BUDGET} filesystem entries; results may be incomplete`);
+        lines.push(style('dim', `○ the walk stopped early — deeper squares may still be hiding`));
     return lines.join('\n') + '\n';
 }
 function parseListOptions(args, usage) {

package/dist/notifications.js

@@ -102,28 +102,28 @@ export async function createDefaultWakeTransport(hostLedger, clock, env = proces
     const adapters = await defaultWakeAdapters();
     return createWakeTransport(env.SQUARE_DISABLE_PASEO_WAKE === '1' ? adapters.filter((adapter) => adapter.kind !== 'paseo') : adapters, hostLedger, clock);
 }
-async function wakeRequestIsCurrent(request, hostLedger, now) {
+async function wakeRequestCurrentness(request, hostLedger, now) {
     const activity = parseActivityId(request.activity);
     if (activity === undefined)
-        return false;
+        return { current: false, activityPending: false, sessionBound: false, routePublished: false, observationAvailable: true };
     let square;
     try {
         square = await openSquare(request.location, { hostLedger });
         const current = await observeSquare({ artifact: square.artifact, hostLedger, location: request.location, now });
-        const pending = current.pending.some((entry) => nameKey(entry.recipient) === nameKey(request.participant)
+        const activityPending = current.pending.some((entry) => nameKey(entry.recipient) === nameKey(request.participant)
             && entry.notifications.some((notification) => notification.item.index === activity));
-        const bound = current.bindings.some((binding) => nameKey(binding.participant) === nameKey(request.route.participant)
+        const sessionBound = current.bindings.some((binding) => nameKey(binding.participant) === nameKey(request.route.participant)
             && binding.sessionId === request.route.sessionId
             && binding.location === request.route.location);
-        const published = (current.state.routes ?? []).some((route) => route.location === request.route.location
+        const routePublished = (current.state.routes ?? []).some((route) => route.location === request.route.location
             && nameKey(route.participant) === nameKey(request.route.participant)
             && route.sessionId === request.route.sessionId
             && route.kind === request.route.kind
             && JSON.stringify(route.address) === JSON.stringify(request.route.address));
-        return pending && bound && published;
+        return { current: activityPending && sessionBound && routePublished, activityPending, sessionBound, routePublished, observationAvailable: true };
     }
     catch {
-        return false;
+        return { current: false, activityPending: false, sessionBound: false, routePublished: false, observationAvailable: false };
     }
     finally {
         if (square !== undefined)
@@ -151,15 +151,32 @@ export function createWakeTransport(adapters, hostLedger, clock) {
             if (adapter === undefined)
                 return { outcome: 'not-capable', diagnostic: `no adapter for ${request.route.kind}` };
             try {
-                const result = await adapter.dispatch(request.route.address, renderWakePayload(request), async () => (await (beforeSend ?? (async () => true))()) && await wakeRequestIsCurrent(request, hostLedger, clock()), timeoutMs);
+                let revalidation;
+                const result = await adapter.dispatch(request.route.address, renderWakePayload(request), async () => {
+                    if (!(await (beforeSend ?? (async () => true))()))
+                        return false;
+                    revalidation = await wakeRequestCurrentness(request, hostLedger, clock());
+                    return revalidation.current;
+                }, timeoutMs);
                 if (result.outcome === 'accepted')
                     return { outcome: 'accepted' };
                 if (result.outcome === 'failed')
-                    return { outcome: 'failed', message: result.message };
+                    return { outcome: 'failed', ...(result.signature === undefined ? {} : { signature: result.signature }), message: result.message, ...(result.diagnostic === undefined ? {} : { diagnostic: result.diagnostic }) };
                 if (result.outcome === 'unavailable')
-                    return { outcome: 'failed', message: result.message, unavailable: true, ...(result.retainRoute === true ? { retainRoute: true } : {}), ...(result.routeStale === true ? { routeStale: true } : {}) };
+                    return { outcome: 'failed', signature: result.signature, message: result.message, ...(result.diagnostic === undefined ? {} : { diagnostic: result.diagnostic }), unavailable: true, ...(result.retainRoute === true ? { retainRoute: true } : {}), ...(result.routeStale === true ? { routeStale: true } : {}) };
                 if (result.outcome === 'unknown')
-                    return { outcome: 'unknown', diagnostic: result.message };
+                    return { outcome: 'unknown', ...(result.signature === undefined ? {} : { signature: result.signature }), ...(result.message === undefined ? {} : { message: result.message }), ...(result.diagnostic === undefined ? {} : { diagnostic: result.diagnostic }) };
+                if (result.outcome === 'cancelled' && revalidation !== undefined && !revalidation.current) {
+                    return {
+                        outcome: 'failed',
+                        signature: 'pre_send_revalidation_failed',
+                        message: revalidation.observationAvailable
+                            ? 'Wake was not sent because current attention, session binding, or route no longer matches.'
+                            : 'Wake was not sent because current Square delivery state could not be verified.',
+                        diagnostic: revalidation,
+                        unavailable: true,
+                    };
+                }
                 return { outcome: 'unknown', diagnostic: 'wake dispatch cancelled' };
             }
             catch (error) {

package/dist/ports.d.ts

@@ -69,6 +69,8 @@ export type WakeOutcome = {
 } | {
     readonly outcome: 'failed';
     readonly message?: string;
+    readonly signature?: string;
+    readonly diagnostic?: unknown;
     readonly attemptN?: number;
     readonly unavailable?: boolean;
     readonly retainRoute?: boolean;
@@ -78,7 +80,9 @@ export type WakeOutcome = {
     readonly diagnostic?: string;
 } | {
     readonly outcome: 'unknown';
-    readonly diagnostic?: string;
+    readonly signature?: string;
+    readonly message?: string;
+    readonly diagnostic?: unknown;
     readonly attemptN?: number;
 };
 export interface SquareObservation {

package/dist/presentation.d.ts

@@ -6,6 +6,8 @@ export type WatchStatus = 'stale' | 'empty-now' | 'quorum' | 'capped';
 interface HeaderOptions {
     participantCount?: number;
     held?: boolean;
+    /** Refusal bodies go to stderr, which stays literal even when it is a TTY. */
+    plain?: boolean;
 }
 interface ParticipantOutputOptions {
     squarePath: string;
@@ -46,6 +48,11 @@ interface WatchStatusOptions extends ParticipantOutputOptions {
 }
 export declare function displayPath(squarePath: string, cwd?: string): string;
 export declare function withPathOutput(squarePath: string, body?: string, opts?: HeaderOptions): string;
+/** The same header/blank/body layout as withPathOutput, for refusal bodies written to stderr. */
+export declare function formatRefusal(squarePath: string, bodyLines: string[], opts?: {
+    participantCount?: number;
+    held?: boolean;
+}): string;
 export declare function quoteShell(value: string): string;
 export declare function commandPrefix(squarePath: string): string;
 export declare function participantCommandPrefix(squarePath: string, name: string): string;

package/dist/presentation.js

@@ -3,16 +3,18 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { participantIdentity } from './participant-identity.js';
 export { participantIdentity } from './participant-identity.js';
-import { audienceIncludes, audienceOf, MAX_IDENTITY_SET_SIZE } from './square-core.js';
+import { audienceIncludes, audienceOf, MAX_IDENTITY_SET_SIZE, replayLandedAudiences } from './square-core.js';
 import { perceiveActivity } from './delivery.js';
-import { actId, publicActs, readCursor, rosterNames, sayNumberFor } from './runtime.js';
+import { actId, presenceAnchor, publicActs, rosterNames, sayNumberFor } from './runtime.js';
 import { formatDuration, formatRelativeTime, formatTimestamp } from './time.js';
 import { compareParticipantActivity } from './decisions.js';
 import { grepSnippet } from './search.js';
+import { style } from './tty-style.js';
 function headerLine(squarePath, opts = {}) {
     const count = opts.participantCount ?? 0;
     const heldSuffix = opts.held ? ' — a hand is raised' : '';
-    return `· the square at ${displayPath(squarePath)} — ${count} in the square${heldSuffix}`;
+    const line = `· ${displayPath(squarePath)} — ${count} in the square${heldSuffix}`;
+    return opts.plain === true ? line : style('dim', line);
 }
 export function displayPath(squarePath, cwd = process.cwd()) {
     if (!path.isAbsolute(squarePath))
@@ -32,6 +34,14 @@ export function displayPath(squarePath, cwd = process.cwd()) {
 export function withPathOutput(squarePath, body = '', opts = {}) {
     return [headerLine(squarePath, opts), ...(body === '' ? [] : ['', body])].join('\n') + '\n';
 }
+/** The same header/blank/body layout as withPathOutput, for refusal bodies written to stderr. */
+export function formatRefusal(squarePath, bodyLines, opts = {}) {
+    const body = bodyLines.join('\n');
+    // A refusal with no known count stays bare rather than claiming "0 in the square".
+    if (opts.participantCount === undefined)
+        return body === '' ? '' : `${body}\n`;
+    return withPathOutput(squarePath, body, { ...opts, plain: true });
+}
 export function quoteShell(value) {
     return `'${value.replace(/'/g, `'\\''`)}'`;
 }
@@ -43,10 +53,10 @@ export function participantCommandPrefix(squarePath, name) {
 }
 /** Blocked actions end with a full copy-pasteable recovery command. */
 export function joinRecoveryCommand(squarePath, name) {
-    return `» ${participantCommandPrefix(squarePath, name)} join`;
+    return `${participantCommandPrefix(squarePath, name)} join`;
 }
 export function participantsRecoveryCommand(squarePath) {
-    return `» ${commandPrefix(squarePath)} participants`;
+    return `${commandPrefix(squarePath)} participants`;
 }
 function formatAge(ms) {
     if (ms === undefined)
@@ -68,6 +78,10 @@ function presenceGlyph(participant) {
         return '●';
     return '○';
 }
+function styledPresenceGlyph(participant) {
+    const glyph = presenceGlyph(participant);
+    return glyph === '○' ? style('dim', glyph) : glyph;
+}
 function presenceText(participant, now) {
     if (participant.state === 'done') {
         return participant.lastActiveAt === undefined ? 'stepped out of the square' : `stepped out of the square · ${formatRelativeTime(participant.lastActiveAt, now)}`;
@@ -86,17 +100,17 @@ export function renderPresenceLines(participants, now, limit = 5) {
         .sort(compareParticipantActivity);
     const shown = recent.slice(0, limit);
     if (shown.length === 0)
-        return ['  ○ nobody nearby'];
-    const lines = shown.map((p) => `  ${presenceGlyph(p)} ${participantIdentity(p.name)} · ${presenceText(p, now)}`);
+        return [style('dim', '  ○ nobody nearby')];
+    const lines = shown.map((p) => `  ${styledPresenceGlyph(p)} ${participantIdentity(p.name)}${style('dim', ` · ${presenceText(p, now)}`)}`);
     const remaining = recent.length - shown.length;
     if (remaining > 0)
-        lines.push(`  ○ …and ${remaining} more`);
+        lines.push(style('dim', `  ○ … ${remaining} more nearby`));
     return lines;
 }
 const EXPRESS_HINTS = [
     '*asterisks* are your body — *slams table*, *sketches in the air*, *shrugs*',
     "you're standing in a square — words and gestures both land",
-    'the square is for conversation — share thoughts and engage with others, beyond status updates and empty acknowledgments',
+    'the square runs on conversation — say things that move it, not nods that fill it',
 ];
 export function expressHintLine(ownActivityCount) {
     if (ownActivityCount !== 1 && ownActivityCount % 5 !== 0)
@@ -119,7 +133,7 @@ export function truncateExternalDiagnostic(diagnostic) {
 }
 function previewBody(body, maxLen = BODY_PREVIEW_LENGTH) {
     const preview = truncateChars(body, maxLen);
-    return preview.remaining === 0 ? preview.text : `${preview.text}\n… ${preview.remaining} more chars`;
+    return preview.remaining === 0 ? preview.text : `${preview.text}\n${style('dim', `… ${preview.remaining} more chars`)}`;
 }
 const UNREAD_PREVIEW_CHARS = 120;
 export function previewActivityBody(body) {
@@ -127,7 +141,7 @@ export function previewActivityBody(body) {
     if (compact === '')
         return '(empty)';
     const preview = truncateChars(compact, UNREAD_PREVIEW_CHARS);
-    return preview.remaining === 0 ? preview.text : `${preview.text}… (+${preview.remaining} chars)`;
+    return preview.remaining === 0 ? preview.text : `${preview.text}${style('dim', `… (+${preview.remaining} chars)`)}`;
 }
 export function renderRoomChangeText(event) {
     const actor = event.actor ?? 'someone';
@@ -166,7 +180,7 @@ export function renderEventCli(event, opts = {}) {
         case 'hold':
             return `· ${renderRoomChangeText(event)}`;
         case 'resume':
-            return `✓ ${renderRoomChangeText(event)}`;
+            return `${style('release', '✓')} ${renderRoomChangeText(event)}`;
         case 'listen':
         case 'ignore':
             return `· ${renderRoomChangeText(event)}`;
@@ -177,11 +191,12 @@ export function renderEventCli(event, opts = {}) {
                 ? ` · calls your name across the square — ${participantIdentity(mention)}`
                 : '';
             const replySuffix = event.reply === undefined ? '' : ` · replies to ${actId(event.reply)}`;
-            return `● ${participantIdentity(event.actor)} #${opts.actNumber ?? 1} · ${actId(event)} · ${formatRelativeTime(event.at, now)}${mentionSuffix}${replySuffix}${bodySuffix(body)}`;
+            const meta = ` #${opts.actNumber ?? 1} · ${actId(event)} · ${formatRelativeTime(event.at, now)}${mentionSuffix}${replySuffix}`;
+            return `● ${participantIdentity(event.actor)}${style('dim', meta)}${bodySuffix(body)}`;
         }
         case 'done': {
             const body = renderedBody(event.body, maxBody);
-            return `○ ${participantIdentity(event.actor)} stepped out of the square — done · ${actId(event)} · ${formatRelativeTime(event.at, now)}${bodySuffix(body)}`;
+            return `${style('dim', '○')} ${participantIdentity(event.actor)} stepped out of the square — done${style('dim', ` · ${actId(event)} · ${formatRelativeTime(event.at, now)}`)}${bodySuffix(body)}`;
         }
         case 'read':
             return '';
@@ -190,8 +205,9 @@ export function renderEventCli(event, opts = {}) {
 function renderPresenceOnlySay(event, opts = {}) {
     const audience = audienceOf(event);
     const targets = audience.kind === 'bell' ? [] : audience.names;
+    const meta = style('dim', ` #${opts.actNumber ?? 1} · ${actId(event)} · ${formatRelativeTime(event.at, opts.now)}`);
     if (targets.length === 0) {
-        return `● ${participantIdentity(event.actor)} #${opts.actNumber ?? 1} · ${actId(event)} · ${formatRelativeTime(event.at, opts.now)}`;
+        return `● ${participantIdentity(event.actor)}${meta}`;
     }
     const visibleTargets = targets.slice(0, MAX_IDENTITY_SET_SIZE).map((name) => participantIdentity(name));
     const remainingTargets = targets.length - visibleTargets.length;
@@ -199,7 +215,7 @@ function renderPresenceOnlySay(event, opts = {}) {
         ...visibleTargets,
         ...(remainingTargets === 0 ? [] : [`${remainingTargets} ${remainingTargets === 1 ? 'other' : 'others'}`]),
     ].join(' and ')}`;
-    return `● ${participantIdentity(event.actor)} #${opts.actNumber ?? 1} · ${actId(event)} · ${formatRelativeTime(event.at, opts.now)}\n  talked to${dest}`;
+    return `● ${participantIdentity(event.actor)}${meta}\n${style('dim', `  talked to${dest}`)}`;
 }
 export function renderAmbientEvent(event, viewer, opts = {}) {
     if (event.kind !== 'say')
@@ -216,7 +232,7 @@ export function renderAmbientEvent(event, viewer, opts = {}) {
     return renderEventCli(event, opts);
 }
 function draftSavedLines(draftPath) {
-    return draftPath === undefined ? [] : [`· draft kept: ${draftPath}`];
+    return draftPath === undefined ? [] : [style('dim', `· draft kept: ${draftPath}`)];
 }
 function withDraftInput(command, draftPath) {
     return draftPath === undefined ? command : `${command} < ${quoteShell(draftPath)}`;
@@ -229,15 +245,15 @@ function renderUnreadSummary(opts) {
             ...item.previews.slice(-1).map((preview) => {
                 const rendered = renderAmbientEvent(preview.act, opts.viewer, { actNumber: preview.number, perception: preview.perception });
                 if (rendered === '')
-                    return `  · ${participantIdentity(item.name)} spoke — ${formatAge(item.latestActivityAgeMs)} ago`;
+                    return style('dim', `  · ${participantIdentity(item.name)} spoke — ${formatAge(item.latestActivityAgeMs)} ago`);
                 if (preview.perception === 'presence') {
-                    return `  · ${participantIdentity(item.name)} spoke — ${formatAge(item.latestActivityAgeMs)} ago · ${rendered.replace(/\n/g, ' ')}`;
+                    return style('dim', `  · ${participantIdentity(item.name)} spoke — ${formatAge(item.latestActivityAgeMs)} ago · ${rendered.replace(/\n/g, ' ')}`);
                 }
-                return `  · ${participantIdentity(item.name)} spoke — ${formatAge(item.latestActivityAgeMs)} ago · "${previewActivityBody(preview.act.body)}"`;
+                return style('dim', `  · ${participantIdentity(item.name)} spoke — ${formatAge(item.latestActivityAgeMs)} ago · "${previewActivityBody(preview.act.body)}"`);
             }),
         ]),
-        ...(remainingSummaries === 0 ? [] : [`  · ${remainingSummaries} more participants have unread activity`]),
-        ...opts.roomChanges.map((act) => `  · ${renderRoomChangeText(act)}`),
+        ...(remainingSummaries === 0 ? [] : [style('dim', `  · ${remainingSummaries} more participants have unread activity`)]),
+        ...opts.roomChanges.map((act) => style('dim', `  · ${renderRoomChangeText(act)}`)),
     ];
 }
 export function renderPendingFeed(history, publicItems, roomChanges, viewer = '', squareState) {
@@ -261,12 +277,12 @@ export function renderPendingFeed(history, publicItems, roomChanges, viewer = ''
 export function renderActivityBlocked(opts) {
     const readNowCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} catch --now`;
     return withPathOutput(opts.squarePath, [
-        "✕ your activity doesn't land — the square moved behind your back",
+        `${style('blocked', '✕')} your activity doesn't land — the square moved behind your back`,
         ...renderUnreadSummary({ activitySummaries: opts.activitySummaries, roomChanges: opts.unreadRoomChanges, viewer: opts.name }),
         ...draftSavedLines(opts.draftPath),
-        `» ${readNowCommand}`,
+        `${readNowCommand}`,
         '  take it in, then express again',
-        `» ${withDraftInput(opts.forceCommand, opts.draftPath)}`,
+        `${withDraftInput(opts.forceCommand, opts.draftPath)}`,
         '  only if you truly mean to express over unread activity',
     ].join('\n'), { participantCount: opts.participantCount, held: opts.held });
 }
@@ -280,16 +296,16 @@ export function renderExpressNoWait(opts) {
     const retryCommand = opts.forceCommand;
     const lines = opts.reason === 'throttled'
         ? [
-            '✕ the square is packed',
+            `${style('blocked', '✕')} the square is packed`,
             `  · next opening in ${formatDuration(opts.delayMs)}`,
             ...draftSavedLines(opts.draftPath),
-            `» ${withDraftInput(retryCommand, opts.draftPath)}`,
+            `${withDraftInput(retryCommand, opts.draftPath)}`,
         ]
         : [
-            "✕ your activity doesn't land — a hand is raised",
-            `  · ${opts.holdReason ?? 'the square holds its breath'}`,
+            `${style('blocked', '✕')} your activity doesn't land — a hand is raised`,
+            style('dim', `  · ${opts.holdReason ?? 'the square holds its breath'}`),
             ...draftSavedLines(opts.draftPath),
-            `» ${withDraftInput(retryCommand, opts.draftPath)}`,
+            `${withDraftInput(retryCommand, opts.draftPath)}`,
         ];
     return withPathOutput(opts.squarePath, lines.join('\n'), { participantCount: opts.participantCount, held: opts.held });
 }
@@ -302,32 +318,24 @@ export function renderPublicTail(squareState, events, lastN, now, viewer = '') {
         .filter(Boolean)
         .join('\n\n');
 }
-function lastPresenceAnchor(squareState, name) {
-    const cursor = readCursor(squareState, name);
-    for (let i = squareState.acts.length - 1; i >= 0; i--) {
-        const event = squareState.acts[i];
-        const index = event.index;
-        if (index > cursor)
-            continue;
-        if (event.kind === 'say' || event.kind === 'done')
-            return index;
-    }
-    return -1;
+function lastPresenceAnchor(squareState, name, landed) {
+    return presenceAnchor(squareState, name, landed);
 }
 export function renderPresenceAnchor(names) {
     const visibleNames = names.slice(0, MAX_IDENTITY_SET_SIZE);
     const participants = visibleNames.map((name) => participantIdentity(name)).join(', ');
     const remaining = names.length - visibleNames.length;
     const suffix = remaining === 0 ? '' : ` and ${remaining} more`;
-    return names.length === 1 ? `→ ${participants} was here` : `→ ${participants}${suffix} were here`;
+    return style('dim', names.length === 1 ? `→ ${participants} was here` : `→ ${participants}${suffix} were here`);
 }
 export function renderActivitiesView(squareState, visible, lastN, noTruncate, squarePath, viewer = '', mode = 'ambient') {
     const publicVisible = visible.filter((act) => act.kind === 'say' || act.kind === 'done');
     const shown = lastN == null ? publicVisible : publicVisible.slice(-lastN);
     const previewLen = noTruncate ? undefined : BODY_PREVIEW_LENGTH;
     const markers = new Map();
+    const landed = replayLandedAudiences(squareState.acts);
     for (const participant of rosterNames(squareState)) {
-        const anchor = lastPresenceAnchor(squareState, participant);
+        const anchor = lastPresenceAnchor(squareState, participant, landed);
         if (anchor >= 0)
             markers.set(anchor, [...(markers.get(anchor) ?? []), participant]);
     }
@@ -351,15 +359,13 @@ export function renderActivitiesView(squareState, visible, lastN, noTruncate, sq
     if (previewLen !== undefined) {
         const truncated = shown.some((act) => act.kind === 'say' && act.body.length > previewLen && (mode === 'archive' || perceiveActivity(squareState, act, viewer) === 'full'));
         if (truncated)
-            chunks.push(`» ${commandPrefix(squarePath)} history --no-truncate`);
+            chunks.push(`${commandPrefix(squarePath)} history --no-truncate`);
     }
     return chunks.join('\n\n');
 }
 const GREP_PREVIEW_CHARS = 160;
 function highlightGrepMatch(text) {
-    if (!process.stdout.isTTY || process.env.NO_COLOR !== undefined || text === '')
-        return text;
-    return `\x1b[38;5;222m\x1b[1m${text}\x1b[0m`;
+    return style('match', text);
 }
 export function renderGrepActivitiesView(visible, totalMatches, noTruncate, squarePath, pattern, fixed = false, perception) {
     const publicVisible = visible.filter((act) => act.kind === 'say' || act.kind === 'done');
@@ -370,19 +376,20 @@ export function renderGrepActivitiesView(visible, totalMatches, noTruncate, squa
     let truncated = false;
     for (const act of publicVisible) {
         const rawBody = act.body ?? '';
+        const header = `${style('dim', actId(act.index))} · ${act.actor === undefined ? 'unknown' : participantIdentity(act.actor)} · ${style('dim', formatTimestamp(act.at))}`;
         if (perception?.(act) === 'presence') {
-            chunks.push(`${actId(act.index)} · ${act.actor === undefined ? 'unknown' : participantIdentity(act.actor)} · ${formatTimestamp(act.at)}`);
+            chunks.push(header);
             continue;
         }
         if (noTruncate === true) {
             const body = rawBody.split('\n').map((line) => `  ${line}`).join('\n');
-            chunks.push(`${actId(act.index)} · ${act.actor === undefined ? 'unknown' : participantIdentity(act.actor)} · ${formatTimestamp(act.at)}\n${body}`);
+            chunks.push(`${header}\n${body}`);
             continue;
         }
         const snippet = grepSnippet(rawBody, pattern, GREP_PREVIEW_CHARS, fixed);
         if (snippet === undefined) {
             const preview = previewBody(rawBody, GREP_PREVIEW_CHARS);
-            chunks.push(`${actId(act.index)} · ${act.actor === undefined ? 'unknown' : participantIdentity(act.actor)} · ${formatTimestamp(act.at)}${preview === '' ? '' : `\n  ${preview}`}`);
+            chunks.push(`${header}${preview === '' ? '' : `\n  ${preview}`}`);
             continue;
         }
         const clippedBefore = snippet.beforeOmitted > 0;
@@ -390,15 +397,15 @@ export function renderGrepActivitiesView(visible, totalMatches, noTruncate, squa
         truncated ||= clippedBefore || clippedAfter;
         const text = `${clippedBefore ? '… ' : ''}${snippet.before}${highlightGrepMatch(snippet.match)}${snippet.after}${clippedAfter ? ' …' : ''}`;
         const omitted = clippedBefore || clippedAfter
-            ? `\n  · ${snippet.beforeOmitted} chars before · ${snippet.afterOmitted} chars after`
+            ? `\n${style('dim', `  · ${snippet.beforeOmitted} chars before · ${snippet.afterOmitted} chars after`)}`
             : '';
-        chunks.push(`${actId(act.index)} · ${act.actor === undefined ? 'unknown' : participantIdentity(act.actor)} · ${formatTimestamp(act.at)}\n  ${text.trim()}${omitted}`);
+        chunks.push(`${header}\n  ${text.trim()}${omitted}`);
     }
     if (publicVisible.length === 1) {
-        chunks.push(`» ${commandPrefix(squarePath)} history --at ${actId(publicVisible[0].index)} -C 2${truncated ? ' --no-truncate' : ''}`);
+        chunks.push(`${commandPrefix(squarePath)} history --at ${actId(publicVisible[0].index)} -C 2${truncated ? ' --no-truncate' : ''}`);
     }
     else if (truncated && publicVisible.length > 1) {
-        chunks.push(`» ${commandPrefix(squarePath)} history --at ${actId(publicVisible[0].index)} -C 2 --no-truncate`);
+        chunks.push(`${commandPrefix(squarePath)} history --at ${actId(publicVisible[0].index)} -C 2 --no-truncate`);
     }
     return chunks.join('\n\n');
 }
@@ -406,9 +413,10 @@ function renderActivityLimitBody(opts) {
     const countText = opts.count !== undefined && opts.hardCap !== undefined ? ` (${opts.count}/${opts.hardCap})` : '';
     const doneCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} done -`;
     return [
-        `✕ your activity doesn't land — the cap is reached${countText}`,
+        `${style('blocked', '✕')} your activity doesn't land — the cap is reached${countText}`,
         ...draftSavedLines(opts.draftPath),
-        `» ${withDraftInput(doneCommand, opts.draftPath)}`,
+        `${withDraftInput(doneCommand, opts.draftPath)}`,
+        '  your draft becomes your final note',
     ].join('\n');
 }
 export function renderActivityLimit(opts) {
@@ -416,17 +424,17 @@ export function renderActivityLimit(opts) {
 }
 export function renderWatchAlreadyActive(opts) {
     return [
-        '✕ you are already catching',
+        `${style('blocked', '✕')} you are already catching`,
         `  · an active catch is already running for ${participantIdentity(opts.name)}`,
-        '  · wait for it to finish before starting another catch',
-        `» ${commandPrefix(opts.squarePath)} participants`,
+        '  · --replace lets a new catch take over',
+        `${participantCommandPrefix(opts.squarePath, opts.name)} catch --idle 30m --replace`,
     ].join('\n');
 }
 export function renderWatchForceTakeover(_opts) {
     return '✓ your new catch takes over';
 }
 export function renderWatchReplaceMissing(_opts) {
-    return '⚠ nothing to replace — no active catch was running; your catch started normally';
+    return '· no catch stood here — yours takes the spot';
 }
 export function renderWatchReplaced(_opts) {
     return '✕ a newer catch took over';
@@ -443,26 +451,26 @@ export function renderWatchStatus(opts) {
         case 'empty-now': {
             const prefix = participantCommandPrefix(opts.squarePath, opts.name);
             const quiet = opts.status === 'stale' && opts.idleMs !== undefined
-                ? `○ ${formatDuration(opts.idleMs)} of quiet — nothing new for you`
-                : '○ only footsteps in the square — nothing new for you';
+                ? style('dim', `○ ${formatDuration(opts.idleMs)} of quiet — nothing new for you`)
+                : style('dim', '○ only footsteps in the square — nothing new for you');
             return [
                 quiet,
                 ...(opts.showCatchHint === false
                     ? []
-                    : [`» ${prefix} catch --idle 30m`, `  glance: ${prefix} catch --now`]),
+                    : [`${prefix} catch --idle 30m`, `  glance: ${prefix} catch --now`]),
                 ...presenceLines,
             ].join('\n');
         }
         case 'quorum':
-            return ['✓ everyone else has left — the square is yours alone', `» ${participantCommandPrefix(opts.squarePath, opts.name)} done -`].join('\n');
+            return [`${style('release', '✓')} everyone else has left — the square is yours alone`, `${participantCommandPrefix(opts.squarePath, opts.name)} done -`].join('\n');
         case 'capped':
-            return ['✕ nothing left in you — the cap is reached', `» ${participantCommandPrefix(opts.squarePath, opts.name)} done -`].join('\n');
+            return [`${style('blocked', '✕')} nothing left in you — the cap is reached`, `${participantCommandPrefix(opts.squarePath, opts.name)} done -`].join('\n');
     }
 }
 function renderRoomChanges(changes) {
     if (changes.length === 0)
         return '';
-    return ['▲ while your back was turned', ...changes.map((act) => `  · ${renderRoomChangeText(act)}`)].join('\n');
+    return [`${style('changed', '▲')} while your back was turned`, ...changes.map((act) => `  · ${renderRoomChangeText(act)}`)].join('\n');
 }
 export function renderDoctorClean() {
     return '✓ no problems found';
@@ -481,7 +489,7 @@ export function renderWatchOutput(history, publicItems, roomChanges, opts) {
             quiet,
             ...(opts.showCatchHint === false
                 ? []
-                : [`» ${prefix} catch --idle 30m`, `  glance: ${prefix} catch --now`]),
+                : [`${prefix} catch --idle 30m`, `  glance: ${prefix} catch --now`]),
         ].join('\n'));
     }
     const publicIndexes = new Set(publicItems.map((item) => item.index));

package/dist/registry.js

@@ -101,7 +101,7 @@ export async function claimSessionParticipant(squarePath, name, env = process.en
         epoch: 1,
     }, 'local');
     if (result.status === 'busy')
-        throw new SquareError('already_joined', `${name} is already bound to another session`);
+        throw new SquareError('already_joined', `✕ ${name} already stands here — another session holds the name`);
     if (result.status === 'degraded')
         throw result.error;
     const epoch = presenceEpoch(result.record) || (result.status === 'acquired' ? 1 : 0);
@@ -203,7 +203,7 @@ export async function releaseSessionParticipant(squarePath, name, env = process.
 export async function bindCurrentParticipant(squarePath, name, env = process.env) { if (squareAssignedParticipantName(env) !== name)
     throw new SquareError('invalid_args', `The current session is not assigned ${name}`); const sessionId = await localParticipantOwner(squarePath, name, env); if (sessionId !== undefined)
     return { created: false, sessionId }; if ((await lookupParticipant(squarePath, name, Date.now(), env)).at(0) !== undefined)
-    throw new SquareError('already_joined', `${name} is already bound to another session`); await recordLocalJoin(name, squarePath, env); const currentSessionId = await localParticipantOwner(squarePath, name, env); if (currentSessionId === undefined)
+    throw new SquareError('already_joined', `✕ ${name} already stands here — another session holds the name`); await recordLocalJoin(name, squarePath, env); const currentSessionId = await localParticipantOwner(squarePath, name, env); if (currentSessionId === undefined)
     throw new Error(`Current participant binding did not commit for ${name}`); return { created: true, sessionId: currentSessionId }; }
 export async function unbindCurrentParticipant(squarePath, name, env = process.env) { const identities = new Set(localSessionIdentities(env).map((identity) => identity.sessionId)); const current = (await lookupParticipant(squarePath, name, Date.now(), env)).filter((binding) => identities.has(binding.sessionId)); for (const binding of current)
     await recordSessionDone(binding.sessionId, binding.name, binding.squarePath, binding.channel, env); return current.length > 0; }

package/dist/runtime.d.ts

@@ -38,6 +38,14 @@ export declare function observationFor(squareState: SquareState, name: string, i
 export declare function recordObservation(squareState: SquareState, name: string, index: number, state: ObservationState, at?: number): boolean;
 export declare function readCursor(squareState: SquareState, name: string, landed?: LandedAudienceReplay): number;
 export declare function latestActIndex(acts: StoredAct[]): number;
+/**
+ * "Was here" is a claim of presence, so it rides on evidence: the participant's own acts
+ * and seen receipts after their latest join. Anything else — in particular acts merely
+ * not addressed to them — says nothing about where they actually were.
+ */
+export declare function presenceEvidenceCursor(squareState: SquareState, name: string, landed?: LandedAudienceReplay): number;
+/** The last public act the participant was verifiably present for, or -1 when there is no evidence. */
+export declare function presenceAnchor(squareState: SquareState, name: string, landed?: LandedAudienceReplay): number;
 export declare function freshWatchLease(squareState: SquareState, name: string, at?: number): WatchLease | undefined;
 export declare function watchLease(squareState: SquareState, name: string): WatchLease | undefined;
 export declare function writeWatchLease(squareState: SquareState, name: string, lease: WatchLease): void;