@timurproko/a1 0.2.5 → 0.2.6-dev.727

package/dist/ui/components/prompt-input.d.ts

@@ -10,6 +10,8 @@ export interface PromptInputBody {
     readonly topRule?: string | undefined;
     readonly bottomRule?: string | undefined;
     readonly after?: readonly string[];
+    /** Outer indentation for after-body rows; defaults to the prompt prefix width. */
+    readonly afterIndent?: number;
 }
 export interface PromptInputMetrics {
     readonly measure: (text: string) => number;

package/dist/ui/components/prompt-input.js

@@ -31,6 +31,10 @@ export class PromptInput {
             return [];
         const { prefixWidth, innerWidth } = this.geometry(width, padding, promptGlyph);
         const body = renderBody(innerWidth);
+        const requestedAfterIndent = body.afterIndent ?? prefixWidth;
+        const afterIndent = Number.isFinite(requestedAfterIndent)
+            ? Math.min(width, Math.max(0, Math.floor(requestedAfterIndent)))
+            : prefixWidth;
         const fit = (row) => {
             const clipped = this.metrics.truncate(row, width);
             return clipped + " ".repeat(Math.max(0, width - this.metrics.measure(clipped)));
@@ -45,7 +49,7 @@ export class PromptInput {
             ...(ruled ? [rule(body.topRule)] : []),
             ...rows,
             ...(ruled ? [rule(body.bottomRule)] : []),
-            ...(body.after ?? []).map(row => fit(`${" ".repeat(prefixWidth)}${row}`)),
+            ...(body.after ?? []).map(row => fit(`${" ".repeat(afterIndent)}${row}`)),
         ];
     }
 }

package/dist/ui/components/text-selection.d.ts

@@ -56,7 +56,7 @@ export declare function releaseTextSelection(selection: TextSelection | undefine
 export declare function textSelectionLineExtendColumn(selection: TextSelection, line: number, contentWidth: number): number;
 /** Resolves a reported one-based pointer cell to the complete grapheme it intersects. */
 export declare function textSelectionPointAt(line: number, column: number, lineText: string): TextSelectionPoint;
-export declare function textSelectionText(selection: OrderedTextSelection, rows: readonly string[], lineContent?: (line: number) => TextSelectionLineContent | undefined): string;
+export declare function textSelectionText(selection: OrderedTextSelection, rows: readonly string[], lineContent?: (line: number) => TextSelectionLineContent | undefined, includeLine?: (line: number) => boolean): string;
 /** Returns the plain cells covered by [from,to), expanding at grapheme edges. */
 export declare function plainTextBetweenColumns(line: string, from: number, to: number): string;
 export declare function usefulTextLineContent(line: string, from?: number): TextSelectionLineContent;

package/dist/ui/components/text-selection.js

@@ -111,9 +111,11 @@ export function textSelectionPointAt(line, column, lineText) {
     }
     return { line, column, from: target, to: target + 1 };
 }
-export function textSelectionText(selection, rows, lineContent) {
+export function textSelectionText(selection, rows, lineContent, includeLine = () => true) {
     const parts = [];
     for (let line = selection.start.line; line <= selection.end.line && line < rows.length; line += 1) {
+        if (!includeLine(line))
+            continue;
         const plain = stripAnsi(rows[line] ?? "");
         const content = lineContent?.(line);
         if (content?.selectable === false) {

package/dist/ui/components/theme.d.ts

@@ -8,6 +8,8 @@ export interface UiTheme {
      * into a dark terminal, which is how the engine leaves its lists too.
      */
     plain(text: string): string;
+    /** Optional palette preview used by controls that choose the active accent. */
+    accentPreview?(color: string, text: string): string | null;
     /** Selection background for an active list item or floating-surface row. */
     highlight(text: string): string;
     /** A control that is present but cannot act: quieter than quiet text. */

package/dist/ui/components/transcript-viewport.d.ts

@@ -25,7 +25,7 @@ export interface TranscriptViewportFrameInput {
     readonly documentRows: readonly string[];
     /** Optional paint-only transform; semantic selection and copying keep documentRows exact. */
     readonly paintDocumentRow?: (row: string) => string;
-    /** Leading document rows that participate in pointer selection and copying. */
+    /** Leading persistent document rows; later transient rows remain selectable visible-frame content. */
     readonly selectableDocumentRowCount?: number;
     /**
      * First document row owned by the block that is currently streaming, if any. Rows from
@@ -84,7 +84,7 @@ export interface TranscriptViewportHitRegions {
         readonly columnStart: number;
         readonly columnEnd: number;
     } | null;
-    /** Transient non-selectable document-tail rows currently visible in the viewport. */
+    /** Transient non-persistent document-tail rows currently visible in the viewport. */
     readonly transientTail: readonly number[];
 }
 export interface TranscriptViewportFrameDescriptor {
@@ -109,7 +109,7 @@ export interface TranscriptViewportFrameDescriptor {
     };
     readonly previousFollowingEnd: boolean | null;
     readonly followingEnd: boolean;
-    /** Complete non-selectable suffix, including pending steering, alignment, and status rows. */
+    /** Complete non-persistent suffix, including pending steering, alignment, and status rows. */
     readonly transientRowCount: number;
     /** Flexible rows inserted before the bottom-aligned live status while content fits. */
     readonly transientAlignmentGapRows: number;
@@ -164,7 +164,9 @@ export declare class TranscriptViewport {
     get hasSelection(): boolean;
     /** True when the active gesture began on transcript rows rather than the dock. */
     get selectionFromContent(): boolean;
-    pressSelection(column: number, frameRow: number, now?: number): boolean;
+    pressSelection(column: number, frameRow: number, now?: number, options?: {
+        readonly continueMultiClick?: boolean;
+    }): boolean;
     extendSelection(column: number, frameRow: number, now?: number, autoScroll?: boolean): boolean;
     releaseSelection(): boolean;
     clearSelection(): boolean;

package/dist/ui/components/transcript-viewport.js

@@ -1,4 +1,4 @@
-import { MAX_COPY_SOURCE_UNITS } from "./selection-copy.js";
+import { MAX_COPY_SOURCE_UNITS, selectionCopyLineContent } from "./selection-copy.js";
 import { isThumbRow, scrollbarGeometry, scrollbarPresentation, } from "./scrollbar.js";
 import { backgroundSgrSpan, overlaySpan } from "./spans.js";
 import { faint, truncateToWidth, displayWidth, stripAnsi } from "./text.js";
@@ -8,8 +8,13 @@ const CONTROL_STYLE_RESET = "\u001b]8;;\u001b\\\u001b[0m";
 // the row surface painted beneath its dedicated, non-semantic gutter.
 const GUTTER_DECORATION_RESET = "\u001b]8;;\u001b\\\u001b[22;23;24;25;27;28;29;39;54;55m";
 const IDENTITY_ROW = (row) => row;
-function documentSelectionAnchor(row, source) {
-    return { kind: "document", row, source, identity: stripAnsi(source).trimEnd() };
+function documentSelectionAnchor(row, source, liveFromBottom) {
+    return { kind: "document", row, source, identity: stripAnsi(source).trimEnd(), liveFromBottom };
+}
+function viewportSelectionAnchor(row, source, selectableDocumentRowCount, documentRowCount) {
+    return row < selectableDocumentRowCount
+        ? documentSelectionAnchor(row, source)
+        : { kind: "transient", fromBottom: documentRowCount - row - 1 };
 }
 const DEFAULT_CONFIG = {
     scrollbarAppearance: "auto",
@@ -53,6 +58,7 @@ export class TranscriptViewport {
     #previousVisibleStates = [];
     #documentRows = [];
     #selectableDocumentRowCount = 0;
+    #liveTailStartRow;
     #promptAnchors = [];
     #contentWidth = 0;
     #selectionWidth = 0;
@@ -91,7 +97,7 @@ export class TranscriptViewport {
     get hasSelection() { return orderedTextSelection(this.#selection) !== undefined; }
     /** True when the active gesture began on transcript rows rather than the dock. */
     get selectionFromContent() { return this.#selectionAnchors !== undefined && this.#selectionAnchors.anchor.kind !== "dock"; }
-    pressSelection(column, frameRow, now = Date.now()) {
+    pressSelection(column, frameRow, now = Date.now(), options = {}) {
         const frameHeight = this.#frame?.rows.length ?? 0;
         const selectionWidth = frameRow <= (this.#frame?.hits.viewportHeight ?? 0)
             ? this.#contentWidth
@@ -105,7 +111,7 @@ export class TranscriptViewport {
             contentWidth: selectionWidth,
             lineText: this.#selectionRows[line] ?? "",
             lineContent: usefulTextLineContent(this.#selectionRows[line] ?? ""),
-            ...(this.#selectionClick === undefined ? {} : { previousClick: this.#selectionClick }),
+            ...(options.continueMultiClick !== false && this.#selectionClick !== undefined ? { previousClick: this.#selectionClick } : {}),
             now,
         });
         this.#selection = pressed.selection;
@@ -176,7 +182,29 @@ export class TranscriptViewport {
         const selection = this.#visibleSelection();
         if (selection === undefined)
             return null;
-        const text = textSelectionText(selection, this.#selectionRows, line => usefulTextLineContent(this.#selectionRows[line] ?? ""));
+        // Invariant: the blue range spans the complete frame, but automatic and Ctrl+C frame copy
+        // admit only persistent transcript rows. Transient status, suggestions, input, and footer
+        // chrome remain visually selectable without becoming clipboard payload.
+        const copiedLines = Array.from({ length: Math.max(0, selection.end.line - selection.start.line + 1) }, (_value, index) => selection.start.line + index).filter(line => {
+            const anchor = this.#selectionRowAnchors[line];
+            return anchor?.kind === "document" && anchor.row < this.#selectableDocumentRowCount;
+        });
+        if (copiedLines.length === 0)
+            return null;
+        // Rationale: a prompt selected by itself uses semantic prompt text. Once surrounding transcript text
+        // participates, preserve the prompt's visible prefix, alignment, and timestamp in the bulk range.
+        const prompt = this.#promptAnchors.find(candidate => copiedLines.every(line => {
+            const anchor = this.#selectionRowAnchors[line];
+            return anchor?.kind === "document" && anchor.row >= candidate.firstRow && anchor.row <= candidate.lastRow;
+        }));
+        const included = new Set(copiedLines);
+        const text = textSelectionText(selection, this.#selectionRows, line => {
+            const row = this.#selectionRows[line] ?? "";
+            const anchor = this.#selectionRowAnchors[line];
+            return prompt !== undefined && anchor?.kind === "document"
+                ? selectionCopyLineContent(row, anchor.row === prompt.firstRow ? "first" : "continuation")
+                : usefulTextLineContent(row);
+        }, line => included.has(line));
         return text.length === 0 ? null : text;
     }
     /** Captures visible selected text, not off-screen history. */
@@ -188,6 +216,8 @@ export class TranscriptViewport {
         if (text === null)
             return null;
         text = text.trim();
+        if (text.length === 0)
+            return null;
         const normalized = {
             start: { line: 0, column: 0 },
             end: { line: 0, column: Number.MAX_SAFE_INTEGER },
@@ -280,6 +310,7 @@ export class TranscriptViewport {
         this.#previousVisibleStates = [];
         this.#documentRows = [];
         this.#selectableDocumentRowCount = 0;
+        this.#liveTailStartRow = undefined;
         this.#promptAnchors = [];
         this.#contentWidth = 0;
         this.#selectionWidth = 0;
@@ -340,6 +371,9 @@ export class TranscriptViewport {
         const contentWidth = presentation.reservesSpace ? Math.max(1, width - 1) : width;
         this.#documentRows = documentRows;
         this.#selectableDocumentRowCount = clamp(input.selectableDocumentRowCount ?? input.documentRows.length, 0, input.documentRows.length);
+        this.#liveTailStartRow = input.liveTailStartRow === undefined || !Number.isSafeInteger(input.liveTailStartRow)
+            ? undefined
+            : clamp(input.liveTailStartRow, 0, this.#selectableDocumentRowCount);
         this.#promptAnchors = input.promptAnchors;
         this.#contentWidth = contentWidth;
         // Invariant: dock rows remain selectable at full width; scrollable source rows
@@ -389,7 +423,7 @@ export class TranscriptViewport {
         const visibleAnchors = Array.from({ length: viewportHeight }, (_value, row) => {
             const documentRow = this.#scrollTop + row;
             return documentRow < documentRows.length
-                ? documentSelectionAnchor(documentRow, documentRows[documentRow] ?? "")
+                ? viewportSelectionAnchor(documentRow, documentRows[documentRow] ?? "", this.#selectableDocumentRowCount, documentRows.length)
                 : { kind: "screen", row, source: this.#selectionRows[row] ?? "" };
         });
         // Invariant: a pinned prompt is chrome over its hidden source row, which clips like off-screen rows.
@@ -486,7 +520,7 @@ export class TranscriptViewport {
                 // Invariant: floating control styling is applied only after the row and
                 // gutter surfaces are resolved, so its inline background cannot leak.
                 const withControl = rowControl === null ? withRail : overlaySpan(withRail, rowControl.left, rowControl.right, rowControl.text);
-                return overlayWidth === 0 ? withControl : overlaySpan(padRowPreservingBackground(withControl, width), overlayLimit - overlayWidth, overlayLimit, `${CONTROL_STYLE_RESET}${overlayText}`);
+                return overlayWidth === 0 ? withControl : overlaySpan(padRowPreservingBackground(withControl, width), overlayLimit - overlayWidth, overlayLimit, `${GUTTER_DECORATION_RESET}${overlayText}`, { inheritStartStyle: true });
             });
             rowRecomputed ||= !final.reused;
             frameRows[row] = final.value;
@@ -643,17 +677,30 @@ export class TranscriptViewport {
             return undefined;
         if (line < this.#viewportHeight) {
             const existing = this.#selectionRowAnchors[line];
-            if (this.#frame?.scrollTop === this.#scrollTop)
-                return existing;
+            if (this.#frame?.scrollTop === this.#scrollTop) {
+                return existing?.kind === "document"
+                    ? this.#interactionDocumentAnchor(existing.row, existing.source)
+                    : existing;
+            }
             // Concurrency: selection edge auto-scroll updates scrollTop before the next frame is
             // composed. Resolve ordinary viewport rows from that latest position instead of stale paint.
             const documentRow = this.#scrollTop + line;
             if (documentRow >= 0 && documentRow < this.#documentRows.length) {
-                return documentSelectionAnchor(documentRow, this.#documentRows[documentRow] ?? "");
+                return documentRow < this.#selectableDocumentRowCount
+                    ? this.#interactionDocumentAnchor(documentRow, this.#documentRows[documentRow] ?? "")
+                    : viewportSelectionAnchor(documentRow, this.#documentRows[documentRow] ?? "", this.#selectableDocumentRowCount, this.#documentRows.length);
             }
         }
         return this.#selectionRowAnchors[line];
     }
+    #interactionDocumentAnchor(row, source) {
+        const liveFromBottom = this.#liveTailStartRow !== undefined
+            && row >= this.#liveTailStartRow
+            && row < this.#selectableDocumentRowCount
+            ? this.#selectableDocumentRowCount - row - 1
+            : undefined;
+        return documentSelectionAnchor(row, source, liveFromBottom);
+    }
     #projectSelection(documentRows, dockRows, height) {
         const selection = this.#selection;
         const anchors = this.#selectionAnchors;
@@ -672,9 +719,16 @@ export class TranscriptViewport {
                     ? undefined
                     : { line: anchor.row, anchor };
             }
+            if (anchor.kind === "transient") {
+                const documentRow = documentRows.length - anchor.fromBottom - 1;
+                if (documentRow < this.#selectableDocumentRowCount || documentRow >= documentRows.length)
+                    return undefined;
+                const visible = this.#selectionRowAnchors.findIndex(candidate => candidate?.kind === "transient" && candidate.fromBottom === anchor.fromBottom);
+                return visible < 0 ? undefined : { line: visible, anchor };
+            }
             if (anchor.row >= 0 && anchor.row < documentRows.length
                 && stripAnsi(documentRows[anchor.row] ?? "").trimEnd() === anchor.identity) {
-                const current = documentSelectionAnchor(anchor.row, documentRows[anchor.row] ?? "");
+                const current = documentSelectionAnchor(anchor.row, documentRows[anchor.row] ?? "", anchor.liveFromBottom);
                 const visible = this.#selectionRowAnchors.findIndex(candidate => candidate?.kind === "document"
                     && candidate.row === current.row && candidate.identity === current.identity);
                 return { line: visible >= 0 ? visible : current.row - this.#scrollTop, anchor: current };
@@ -684,9 +738,29 @@ export class TranscriptViewport {
             const visibleMatches = this.#selectionRowAnchors
                 .map((candidate, line) => ({ candidate, line }))
                 .filter((entry) => entry.candidate?.kind === "document" && entry.candidate.identity === anchor.identity);
-            return visibleMatches.length === 1
-                ? { line: visibleMatches[0].line, anchor: visibleMatches[0].candidate }
-                : undefined;
+            if (visibleMatches.length === 1) {
+                const match = visibleMatches[0];
+                return {
+                    line: match.line,
+                    anchor: documentSelectionAnchor(match.candidate.row, match.candidate.source, anchor.liveFromBottom),
+                };
+            }
+            // Concurrency: a streaming chunk may replace or reflow the pointer's current live-tail
+            // row before the next motion report. During the held gesture only, retain its distance
+            // from the persistent tail; release restores identity-only projection.
+            if (selection.selecting && anchor.liveFromBottom !== undefined && this.#liveTailStartRow !== undefined) {
+                const documentRow = this.#selectableDocumentRowCount - anchor.liveFromBottom - 1;
+                if (documentRow >= this.#liveTailStartRow && documentRow < this.#selectableDocumentRowCount) {
+                    const visible = this.#selectionRowAnchors.findIndex(candidate => candidate?.kind === "document" && candidate.row === documentRow);
+                    if (visible >= 0) {
+                        return {
+                            line: visible,
+                            anchor: documentSelectionAnchor(documentRow, documentRows[documentRow] ?? "", anchor.liveFromBottom),
+                        };
+                    }
+                }
+            }
+            return undefined;
         };
         const projectedAnchor = project(anchors.anchor);
         const projectedHead = project(anchors.head);
@@ -704,7 +778,11 @@ export class TranscriptViewport {
         };
     }
     #visibleSelection() {
-        const rows = this.#selectionAnchors?.anchor.kind === "document" ? this.#viewportHeight : this.#selectionRows.length;
+        const anchors = this.#selectionAnchors;
+        const crossesDock = anchors?.anchor.kind === "dock" || anchors?.head.kind === "dock";
+        // Invariant: mixed viewport/dock ranges project across the same complete frame regardless
+        // of origin. Document-only ranges remain clipped to the scrollable viewport when off-screen.
+        const rows = crossesDock ? this.#selectionRows.length : this.#viewportHeight;
         return visibleTextSelection(orderedTextSelection(this.#selection), rows, this.#firstSelectableRow);
     }
     #updateCopyableSelection() {

package/dist/ui/components/value-menu.d.ts

@@ -7,6 +7,8 @@ import type { UiTheme } from "./theme.js";
 export interface ValueMenuState {
     /** Values offered, as they should read. */
     readonly choices: readonly string[];
+    /** Optional already-painted square previews, aligned before each choice label. */
+    readonly previews?: readonly string[];
     /** The value in effect, marked rather than highlighted. */
     readonly current: string | null;
     /** The entry picked by a key or the pointer, or -1 while none is. */

package/dist/ui/components/value-menu.js

@@ -8,10 +8,12 @@ export function valueMenuFrame(state, anchor, layout) {
     const top = below + state.choices.length <= bodyBottom
         ? below
         : Math.max(bodyTop, anchor.screenRow - state.choices.length);
-    const width = Math.max(...state.choices.map(choice => displayWidth(choice) + 4), 6);
-    // Invariant: each row reserves two cells for its effective-value mark. Place those
-    // cells before the anchor so visible choice text starts in the source value column.
-    const column = Math.min(Math.max(0, anchor.valueColumn - 2), Math.max(0, layout.surfaceWidth - width - layout.reservedRight));
+    const previewWidth = Math.max(0, ...(state.previews ?? []).map(displayWidth));
+    const previewColumns = previewWidth === 0 ? 0 : previewWidth + 1;
+    const width = Math.max(...state.choices.map(choice => displayWidth(choice) + previewColumns + 4), 6);
+    // Invariant: rows reserve two cells for the effective-value mark and, when present,
+    // a preview plus one gap. Choice text remains aligned with the source value column.
+    const column = Math.min(Math.max(0, anchor.valueColumn - 2 - previewColumns), Math.max(0, layout.surfaceWidth - width - layout.reservedRight));
     return { top, column, width, rows: state.choices.length };
 }
 /** Draws the menu over the rows behind it, leaving them otherwise untouched. */
@@ -24,11 +26,14 @@ export function renderValueMenu(lines, state, frame, theme) {
         const active = index === state.index;
         const paint = active ? theme.highlight : theme.panel;
         const current = choice === state.current;
-        const tail = padToWidth(`${current ? " " : "  "}${choice} `, frame.width - (current ? 1 : 0));
-        // Invariant: the effective-value check uses the same accent as modal marks, while
-        // the rest of an active row keeps its highlighted foreground and background.
+        const previews = state.previews ?? [];
+        const previewWidth = Math.max(0, ...previews.map(displayWidth));
+        const preview = previewWidth === 0 ? "" : `${padToWidth(previews[index] ?? "", previewWidth)} `;
+        // Invariant: the current-value check stays on ordinary text while the optional
+        // square carries the palette color; the row treatment supplies only its surface.
+        const tail = padToWidth(`${current ? " " : "  "}${preview}${choice} `, frame.width - (current ? 1 : 0));
         const painted = current
-            ? `${paint(theme.fg("accent", "✓"))}${paint(tail)}`
+            ? `${paint(theme.fg("text", "✓"))}${paint(tail)}`
             : paint(tail);
         output[target] = overlaySpan(output[target] ?? "", frame.column, frame.column + frame.width, painted);
     });

package/dist/ui/settings/declarations.d.ts

@@ -1,4 +1,4 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 10;
+export declare const OWNED_UI_SETTINGS_VERSION = 12;
 export type OwnedUiSettingValue = string | number | boolean;
 export type OwnedUiSettingApplication = "live" | "restart";
 export interface OwnedUiSettingDeclaration {
@@ -20,18 +20,6 @@ export interface OwnedUiSettingDeclaration {
  * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
  */
 export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
-    readonly quitAnimation: Readonly<{
-        id: "quitAnimation";
-        label: "Quit animation";
-        section: Readonly<{
-            id: "generic";
-            title: "Generic";
-        }>;
-        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.";
-        application: "live";
-        defaultValue: true;
-        allowedValues: readonly [true, false];
-    }>;
     readonly updateCheck: Readonly<{
         id: "updateCheck";
         label: "Update check";
@@ -44,6 +32,30 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: true;
         allowedValues: readonly [true, false];
     }>;
+    readonly accentColor: Readonly<{
+        id: "accentColor";
+        label: "Accent color";
+        section: Readonly<{
+            id: "appearance";
+            title: "Appearance";
+        }>;
+        description: "Color used by highlighted interface controls, list markers, and tonal interface surfaces.";
+        application: "live";
+        defaultValue: "purple";
+        allowedValues: readonly ["purple", "blue", "cyan", "green", "orange", "pink"];
+    }>;
+    readonly quitAnimation: Readonly<{
+        id: "quitAnimation";
+        label: "Quit animation";
+        section: Readonly<{
+            id: "appearance";
+            title: "Appearance";
+        }>;
+        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.";
+        application: "live";
+        defaultValue: true;
+        allowedValues: readonly [true, false];
+    }>;
     readonly scrollbarAppearance: Readonly<{
         id: "scrollbarAppearance";
         label: "Scrollbar mode";
@@ -111,7 +123,7 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
             id: "agent";
             title: "Agent";
         }>;
-        description: "Predict likely next prompts with one additional background request using the selected model.";
+        description: "Predict likely next prompts with one background request, plus one bounded recovery request when needed, using the selected model.";
         application: "live";
         defaultValue: true;
         allowedValues: readonly [true, false];

package/dist/ui/settings/declarations.js

@@ -1,8 +1,12 @@
-export const OWNED_UI_SETTINGS_VERSION = 10;
+export const OWNED_UI_SETTINGS_VERSION = 12;
+const UI_ACCENT_COLOR_CHOICES = Object.freeze([
+    "purple", "blue", "cyan", "green", "orange", "pink",
+]);
 const MAX_ID_LENGTH = 64;
 const ID_PATTERN = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/;
 /** Declared first so the settings screen opens on it; sections follow first-declaration order. */
 const GENERIC_SECTION = Object.freeze({ id: "generic", title: "Generic" });
+const APPEARANCE_SECTION = Object.freeze({ id: "appearance", title: "Appearance" });
 const SCROLL_SECTION = Object.freeze({ id: "scroll", title: "Scroll" });
 const AGENT_SECTION = Object.freeze({ id: "agent", title: "Agent" });
 /**
@@ -10,15 +14,6 @@ const AGENT_SECTION = Object.freeze({ id: "agent", title: "Agent" });
  * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
  */
 export const OWNED_SETTING_DECLARATIONS = Object.freeze({
-    quitAnimation: Object.freeze({
-        id: "quitAnimation",
-        label: "Quit animation",
-        section: GENERIC_SECTION,
-        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.",
-        application: "live",
-        defaultValue: true,
-        allowedValues: Object.freeze([true, false]),
-    }),
     updateCheck: Object.freeze({
         id: "updateCheck",
         label: "Update check",
@@ -28,6 +23,24 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),
     }),
+    accentColor: Object.freeze({
+        id: "accentColor",
+        label: "Accent color",
+        section: APPEARANCE_SECTION,
+        description: "Color used by highlighted interface controls, list markers, and tonal interface surfaces.",
+        application: "live",
+        defaultValue: "purple",
+        allowedValues: UI_ACCENT_COLOR_CHOICES,
+    }),
+    quitAnimation: Object.freeze({
+        id: "quitAnimation",
+        label: "Quit animation",
+        section: APPEARANCE_SECTION,
+        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.",
+        application: "live",
+        defaultValue: true,
+        allowedValues: Object.freeze([true, false]),
+    }),
     scrollbarAppearance: Object.freeze({
         id: "scrollbarAppearance",
         label: "Scrollbar mode",
@@ -77,7 +90,7 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         id: "promptSuggestions",
         label: "Prompt suggestions",
         section: AGENT_SECTION,
-        description: "Predict likely next prompts with one additional background request using the selected model.",
+        description: "Predict likely next prompts with one background request, plus one bounded recovery request when needed, using the selected model.",
         application: "live",
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),

package/dist/ui/settings/migrations.js

@@ -81,6 +81,22 @@ export const OWNED_UI_SETTINGS_MIGRATIONS = Object.freeze([
             return { ...values };
         },
     }),
+    Object.freeze({
+        to: 11,
+        description: "Introduce semantic accent selection with the active-theme default.",
+        migrate(values) {
+            return { ...values };
+        },
+    }),
+    Object.freeze({
+        to: 12,
+        description: "Rename the inherited default accent choice to explicit purple.",
+        migrate(values) {
+            return values.accentColor === "default"
+                ? { ...values, accentColor: "purple" }
+                : { ...values };
+        },
+    }),
 ]);
 export function assertOwnedUiSettingsMigrations(migrations, currentVersion = OWNED_UI_SETTINGS_VERSION) {
     const firstProduced = currentVersion - migrations.length + 1;

package/docs/architecture/project-structure.md

@@ -92,18 +92,19 @@ Build output mirrors the production namespaces directly under ignored `dist/`, w
 
 Every task worktree must be created at `{working-dir}/.worktrees/<task-id>`, where `{working-dir}` is the agent session's initial working directory. The `.worktrees` directory is inside that working directory, not beside it. For working directory `D:/Git/a1`, `D:/Git/a1/.worktrees/<task-id>` is correct and `D:/Git/a1-<task-id>` is forbidden.
 
-From the initial working directory, create the task branch and worktree, run `a1 session link-worktree <absolute-worktree>` from the owning A1 session, and continue to address it explicitly:
+From the initial working directory, run `a1 session worktrees` to inspect cooperative live ownership before selecting an existing checkout. A `busy` or `unverifiable` worktree is unavailable. An `available` checkout may be reused only when its exact branch, OpenSpec change, and pull request match the requested stream and atomic `a1 session link-worktree <absolute-worktree>` succeeds; names, similar files, recency, cleanliness, and ancestry are not ownership evidence. Otherwise create a fresh task branch/worktree, link it from the owning A1 session, and continue to address it explicitly:
 
 ```sh
+a1 session worktrees
 git fetch origin develop
 git worktree add -b <type>/<short-description> .worktrees/<task-id> origin/develop
 a1 session link-worktree <absolute-worktree>
 git -C .worktrees/<task-id> status
 ```
 
-A successful link response confirming the exact canonical worktree is required before planning, implementation, test, or delivery-documentation edits. If linking fails or confirms another path, stop task edits and report the blocker instead of continuing with primary-checkout footer metadata. A session resuming an existing delivery or switching streams links the exact owned worktree before editing it.
+Inventory is read-only and advisory because another runtime may win a later race. A successful link response confirming the exact canonical worktree is required before planning, implementation, test, or delivery-documentation edits. If inventory or linking fails, reports a live/unverifiable owner, loses a race, or confirms another path, stop task edits and report the blocker; use a separate fresh worktree rather than overriding, unlinking, or recovering that owner. A session resuming an existing delivery or switching streams atomically claims and links the exact worktree before editing it.
 
-The association switches bare A1's footer repository context and pull-request discovery; it does not change process or tool cwd and does not register, claim, release, or authorize cleanup of the worktree. Repository commands therefore keep an explicit worktree path. The primary worktree stays on `develop` for integration and must not be used for task edits. Do not edit, adopt, move, or remove another session's worktree.
+The link acquires a cooperative live-session editing claim and switches bare A1's footer repository context and pull-request discovery. It does not change process or tool cwd, create a Git worktree lock, or register, release, or authorize cleanup. Clean unlink/disposal releases live editing authority; a crashed owner becomes reusable only after exact process death is verified. Repository commands therefore keep an explicit worktree path. The primary worktree stays on `develop` for integration and must not be used for task edits. Do not edit, adopt, move, or remove another session's worktree.
 
 An agent that directly chooses a transient file path for a PR/comment body, command payload, captured output, temporary patch/diff, or ad hoc log must place it beneath the linked worktree's exact `.artifacts/` root, never the primary checkout, another worktree, OS temp, home/desktop, or a sibling path. Such scratch remains ignored, unstaged, uncommitted, disposable, non-authoritative, and secret-free. This repository path rule does not relocate storage internally selected by tools, product runtime code, or hermetic tests.