@timurproko/a1 0.1.8-dev.260 → 0.1.8-dev.269

package/dist/integrations/pi/engine/windows-filesystem-hygiene.d.ts

@@ -0,0 +1,21 @@
+import { type InlineExtension } from "@earendil-works/pi-coding-agent";
+interface FileMetadata {
+    isFile(): boolean;
+    isSymbolicLink(): boolean;
+}
+interface CleanupFileSystem {
+    lstat(path: string): Promise<FileMetadata>;
+    unlink(path: string): Promise<void>;
+}
+interface CleanupPaths {
+    dirname(path: string): string;
+    join(...paths: string[]): string;
+    resolve(...paths: string[]): string;
+}
+export interface WindowsNulCleanupOptions {
+    readonly platform?: NodeJS.Platform;
+    readonly fileSystem?: CleanupFileSystem;
+    readonly paths?: CleanupPaths;
+}
+export declare function createWindowsNulCleanupExtension(options?: WindowsNulCleanupOptions): InlineExtension | null;
+export {};

package/dist/integrations/pi/engine/windows-filesystem-hygiene.js

@@ -0,0 +1,55 @@
+import { isBashToolResult, isEditToolResult, isWriteToolResult, } from "@earendil-works/pi-coding-agent";
+import { lstat, unlink } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+const DEFAULT_FILE_SYSTEM = { lstat, unlink };
+const DEFAULT_PATHS = { dirname, join, resolve };
+const SIMPLE_CD = /(?:^|[;&|\n])\s*cd\s+(?:"([^"\r\n]+)"|'([^'\r\n]+)'|([^\s;&|]+))/;
+export function createWindowsNulCleanupExtension(options = {}) {
+    if ((options.platform ?? process.platform) !== "win32")
+        return null;
+    const fileSystem = options.fileSystem ?? DEFAULT_FILE_SYSTEM;
+    const paths = options.paths ?? DEFAULT_PATHS;
+    return {
+        name: "windows-nul-file-cleanup",
+        factory: pi => registerNulCleanup(pi, fileSystem, paths),
+    };
+}
+function registerNulCleanup(pi, fileSystem, paths) {
+    const cleanDirectory = async (directory) => {
+        const candidate = paths.join(directory, "nul");
+        try {
+            const metadata = await fileSystem.lstat(candidate);
+            if (metadata.isFile() && !metadata.isSymbolicLink())
+                await fileSystem.unlink(candidate);
+        }
+        catch {
+            return;
+        }
+    };
+    pi.on("session_start", async (_event, ctx) => {
+        await cleanDirectory(ctx.cwd);
+    });
+    pi.on("tool_result", async (event, ctx) => {
+        const directories = new Set([ctx.cwd]);
+        if (isBashToolResult(event)) {
+            const command = stringInput(event.input, "command");
+            const target = command === null ? null : simpleCdTarget(command);
+            if (target !== null)
+                directories.add(paths.resolve(ctx.cwd, target));
+        }
+        if (isWriteToolResult(event) || isEditToolResult(event)) {
+            const target = stringInput(event.input, "path");
+            if (target !== null)
+                directories.add(paths.dirname(paths.resolve(ctx.cwd, target)));
+        }
+        await Promise.all(Array.from(directories, cleanDirectory));
+    });
+}
+function simpleCdTarget(command) {
+    const match = SIMPLE_CD.exec(command);
+    return match?.[1] ?? match?.[2] ?? match?.[3] ?? null;
+}
+function stringInput(input, key) {
+    const value = input[key];
+    return typeof value === "string" && value.length > 0 ? value : null;
+}

package/dist/integrations/pi/session-ui/session-shell-root.d.ts

@@ -92,7 +92,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     applyTranscriptBlock(block: OwnedUiSessionViewModel["transcript"][number]): void;
     render(width: number): readonly string[];
     viewportFrameDescriptor(): TranscriptViewportFrameDescriptor | null;
-    /** Visible rows of the transient working-status tail, for rendering evidence. */
+    /** Visible non-selectable Steering, alignment, and Working rows, for rendering evidence. */
     viewportTransientTailRowCount(): number;
     hasActiveSelection(): boolean;
     setViewportConfig(config: OwnedUiViewportSettings): void;

package/dist/integrations/pi/session-ui/session-shell-root.js

@@ -45,7 +45,6 @@ export class OwnedUiSessionShellRoot {
     #dockInputReuseEnabled;
     #dockInputCandidate = false;
     #dockInputSnapshot;
-    #dockInputStatusSignature;
     #visibleViewportSnapshot;
     #fullViewportCompositions = 0;
     #dockOnlyViewportCompositions = 0;
@@ -232,14 +231,18 @@ export class OwnedUiSessionShellRoot {
         // intentional final gutter after their right-aligned timestamp.
         const documentWidth = width;
         const document = this.#renderDocumentLayout(documentWidth);
+        const steeringRows = this.#renderQueued(width);
         const statusRows = this.#renderStatus(width);
-        const statusSignature = statusRows.length === 0 ? undefined : `${statusRows.length}\u0000${statusRows.join("\u0000")}`;
+        const transientSignature = transientRowsSignature(steeringRows, statusRows);
         const snapshot = this.#visibleViewportSnapshot;
         const dockInputCandidate = this.#dockInputCandidate;
         const dockInputSnapshot = dockInputCandidate ? this.#dockInputSnapshot : undefined;
-        const dockInputStatusSignature = dockInputCandidate ? this.#dockInputStatusSignature : statusSignature;
-        // Invariant: queued rows stay docked while live Working rows form one scrollable tail.
-        const scrollRows = [...document.rows, ...statusRows];
+        const dockInputTransientSignature = dockInputCandidate
+            ? dockInputSnapshot?.transientSignature ?? transientSignature
+            : transientSignature;
+        // Invariant: pending Steering and live Working rows share one non-selectable
+        // viewport tail; only non-working status, widgets, input, and footer stay docked.
+        const scrollRows = [...document.rows, ...steeringRows, ...statusRows];
         const dockRows = dock.rows;
         const selectableDocumentRowCount = document.rows.length;
         const dockStartRow = height - dockRows.length + 1;
@@ -256,7 +259,7 @@ export class OwnedUiSessionShellRoot {
             && snapshot.width === width
             && snapshot.height === height
             && snapshot.documentRows === (dockInputSnapshot?.documentRows ?? scrollRows)
-            && snapshot.statusSignature === dockInputStatusSignature
+            && snapshot.transientSignature === dockInputTransientSignature
             && snapshot.promptAnchors === (dockInputSnapshot?.promptAnchors ?? document.promptAnchors)
             && snapshot.dockLength === dockRows.length
             && snapshot.inputSurface === (dockInputSnapshot?.inputSurface ?? this.#inputSurface)
@@ -264,9 +267,9 @@ export class OwnedUiSessionShellRoot {
             && snapshot.selectionRevision === (dockInputSnapshot?.selectionRevision ?? this.#viewportController.selectionRevision)
             ? this.#viewportController.composeDockOnly(dockRows, width, height)
             : null;
-        // Performance: a still-active spinner can tick before its first delayed presentation.
-        // Its newest tail signature is recomputed below and therefore cannot hide that change.
-        if (frame !== null && dockInputStatusSignature !== statusSignature)
+        // Performance: a spinner tick or queue update can race the input-triggered
+        // render. Recompute the complete transient signature before reusing rows.
+        if (frame !== null && dockInputTransientSignature !== transientSignature)
             frame = null;
         if (frame === null) {
             frame = this.#viewportController.compose({
@@ -274,15 +277,16 @@ export class OwnedUiSessionShellRoot {
                 ...(this.#viewportController.transcriptPointerSelecting
                     ? { paintDocumentRow: heldNativeHyperlinkStyle }
                     : {}),
-                // Invariant: selection and copying stop at the real document tail; live Working
-                // rows remain transient presentation chrome at every fit boundary.
+                // Invariant: selection and copying stop at the real document tail; Steering,
+                // fitting alignment, and live Working remain transient presentation chrome.
                 selectableDocumentRowCount,
+                bottomAlignedTailRowCount: statusRows.length,
                 dockRows,
                 promptAnchors: document.promptAnchors,
                 width,
                 height,
-                // Invariant: the control belongs immediately above the complete dock,
-                // never on top of a queued or Working row.
+                // Invariant: the control belongs immediately above the complete dock and
+                // floats over transient viewport content rather than consuming a dock row.
                 bottomControlRow: Math.max(0, height - Math.min(height, dockRows.length) - 1),
                 theme: this.#viewportTheme,
             });
@@ -294,8 +298,7 @@ export class OwnedUiSessionShellRoot {
             width,
             height,
             documentRows: scrollRows,
-            statusSignature,
-            dockInputStatusSignature,
+            transientSignature,
             promptAnchors: document.promptAnchors,
             dockLength: dockRows.length,
             inputSurface: this.#inputSurface,
@@ -308,7 +311,7 @@ export class OwnedUiSessionShellRoot {
     viewportFrameDescriptor() {
         return this.#viewportController.frame?.descriptor ?? null;
     }
-    /** Visible rows of the transient working-status tail, for rendering evidence. */
+    /** Visible non-selectable Steering, alignment, and Working rows, for rendering evidence. */
     viewportTransientTailRowCount() {
         return this.#viewportController.frame?.hits.transientTail.length ?? 0;
     }
@@ -338,7 +341,7 @@ export class OwnedUiSessionShellRoot {
         return this.#renderDockLayout(width).rows;
     }
     #renderDockLayout(width) {
-        const queued = this.#view.editor.queuedSubmissions.length === 0 ? [] : this.#queued.render(width);
+        const queued = this.#customViewport ? [] : this.#renderQueued(width);
         const statusRows = this.#customViewport ? this.#status.renderDock(width) : this.#renderStatus(width);
         const transientRows = [...queued, ...statusRows];
         const aboveWidgets = this.#renderWidgets("aboveEditor", width);
@@ -352,6 +355,9 @@ export class OwnedUiSessionShellRoot {
             inputRows: input.length,
         };
     }
+    #renderQueued(width) {
+        return this.#view.editor.queuedSubmissions.length === 0 ? [] : this.#queued.render(width);
+    }
     layoutRoot() {
         const document = layoutPort(width => this.#renderDocument(width), () => this.invalidate());
         const queued = layoutPort(width => this.#view.editor.queuedSubmissions.length === 0 ? [] : this.#queued.render(width), () => this.#queued.invalidate());
@@ -781,14 +787,15 @@ export class OwnedUiSessionShellRoot {
     }
     #captureDockInputSnapshot() {
         const width = Math.max(1, this.#componentRuntime.getColumns());
+        const steeringRows = this.#renderQueued(width);
         const statusRows = this.#renderStatus(width);
-        this.#dockInputStatusSignature = statusRows.length === 0 ? undefined : `${statusRows.length}\u0000${statusRows.join("\u0000")}`;
+        const transientSignature = transientRowsSignature(steeringRows, statusRows);
         const snapshot = this.#visibleViewportSnapshot;
         this.#dockInputSnapshot = snapshot === undefined
             ? undefined
             : {
                 documentRows: snapshot.documentRows,
-                statusSignature: this.#dockInputStatusSignature,
+                transientSignature,
                 promptAnchors: snapshot.promptAnchors,
                 inputSurface: this.#inputSurface,
                 viewportRevision: this.#viewportController.presentationRevision,
@@ -824,7 +831,6 @@ export class OwnedUiSessionShellRoot {
         this.#visibleViewportSnapshot = undefined;
         this.#dockInputCandidate = false;
         this.#dockInputSnapshot = undefined;
-        this.#dockInputStatusSignature = undefined;
         if (this.#inputSurface !== this.editor)
             this.#inputSurface.dispose?.();
         this.#extensionHeader?.dispose?.();
@@ -1156,3 +1162,6 @@ function isPackageExtensionSource(sourceInfo) {
     const source = sourceInfo?.source ?? "";
     return source.startsWith("npm:") || source.startsWith("git:");
 }
+function transientRowsSignature(steeringRows, statusRows) {
+    return `${steeringRows.length}\u0000${steeringRows.join("\u0000")}\u0001${statusRows.length}\u0000${statusRows.join("\u0000")}`;
+}

package/dist/native/darwin-arm64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-09-06T12:29:18.472Z",
+  "builtAt": "2026-09-06T14:17:35.764Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "dc03605e5780e2aeebb4ecafd62868dc673e22ddd38b024a369aff704ff136dc",

package/dist/native/linux-x64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-06T12:29:19.551Z",
+  "builtAt": "2026-09-06T14:17:46.307Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "ee8a00eaaf79c707459bbbfb52518e9739314967049fbe5fa625f36ce33db9ee",

package/dist/native/win32-x64/manifest.json

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-06T12:30:04.599Z",
+  "builtAt": "2026-09-06T14:18:04.630Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "ce28943a65f5bdd6fd5a2c8b7d513a87402652e9c9089fb3a0b6323083fdd9d2",
+    "sha256": "d78243dd7f7852c64abc40b2b544039eaa9eba0d1f0bd42317002a97e2e84c7b",
     "size": 177664
   },
   "provenance": {

package/dist/runtime-payload-inventory.json

@@ -5,6 +5,7 @@
     "bin/guardian.js",
     "bin/supervisor.js",
     "bin/ui.js",
+    "bin/update-recovery.js",
     "bin/warmup.js"
   ],
   "declaredAssets": [

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

@@ -24,6 +24,8 @@ export interface TranscriptViewportFrameInput {
     readonly paintDocumentRow?: (row: string) => string;
     /** Leading document rows that participate in pointer selection and copying. */
     readonly selectableDocumentRowCount?: number;
+    /** Final transient rows to bottom-align with unused viewport space while content fits. */
+    readonly bottomAlignedTailRowCount?: number;
     readonly dockRows: readonly string[];
     readonly promptAnchors: readonly TranscriptPromptAnchor[];
     readonly width: number;
@@ -86,6 +88,12 @@ export interface TranscriptViewportFrameDescriptor {
     };
     readonly previousFollowingEnd: boolean | null;
     readonly followingEnd: boolean;
+    /** Complete non-selectable 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;
+    /** Live status rows at the end of the transient suffix. */
+    readonly bottomAlignedTailRowCount: number;
     readonly verticalShiftRows: number;
     readonly safeVerticalShift: boolean;
     /** Monotonic interaction revision used to reject stale selection evidence. */

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

@@ -240,7 +240,19 @@ export class TranscriptViewport {
         const previousDescriptor = this.#frame?.descriptor ?? null;
         const dock = input.dockRows.length > height ? input.dockRows.slice(-height) : [...input.dockRows];
         const viewportHeight = Math.max(0, height - dock.length);
-        this.#maxScroll = Math.max(0, input.documentRows.length - viewportHeight);
+        const bottomAlignedTailRowCount = clamp(input.bottomAlignedTailRowCount ?? 0, 0, input.documentRows.length);
+        const transientAlignmentGapRows = bottomAlignedTailRowCount > 0
+            ? Math.max(0, viewportHeight - input.documentRows.length)
+            : 0;
+        const tailStart = input.documentRows.length - bottomAlignedTailRowCount;
+        const documentRows = transientAlignmentGapRows === 0
+            ? input.documentRows
+            : [
+                ...input.documentRows.slice(0, tailStart),
+                ...Array.from({ length: transientAlignmentGapRows }, () => ""),
+                ...input.documentRows.slice(tailStart),
+            ];
+        this.#maxScroll = Math.max(0, documentRows.length - viewportHeight);
         if (this.#followingEnd)
             this.#scrollTop = this.#maxScroll;
         else
@@ -250,7 +262,7 @@ export class TranscriptViewport {
         if (this.#followingEnd)
             this.#newMessages = 0;
         const geometry = scrollbarGeometry({
-            contentLength: input.documentRows.length,
+            contentLength: documentRows.length,
             viewportHeight,
             scroll: this.#scrollTop,
             // Compatibility: the session rail deliberately starts one line below the viewport top.
@@ -266,7 +278,7 @@ export class TranscriptViewport {
             now: input.now ?? Date.now(),
         });
         const contentWidth = presentation.reservesSpace ? Math.max(1, width - 1) : width;
-        this.#documentRows = input.documentRows;
+        this.#documentRows = documentRows;
         this.#selectableDocumentRowCount = clamp(input.selectableDocumentRowCount ?? input.documentRows.length, 0, input.documentRows.length);
         this.#promptAnchors = input.promptAnchors;
         this.#contentWidth = contentWidth;
@@ -278,7 +290,7 @@ export class TranscriptViewport {
         trimCache(this.#finalRowCache, cacheLimit);
         const paintId = this.#functionId(paintDocumentRow);
         const paintRecomputedRows = new Set();
-        const visible = input.documentRows
+        const visible = documentRows
             .slice(this.#scrollTop, this.#scrollTop + viewportHeight)
             .map((row, index) => {
             const painted = cachedString(this.#paintedRowCache, `${paintId}\u0000${row}`, cacheLimit, () => paintDocumentRow(row));
@@ -366,7 +378,7 @@ export class TranscriptViewport {
         }
         const nextDocumentRange = {
             start: this.#scrollTop,
-            end: Math.min(input.documentRows.length, this.#scrollTop + viewportHeight),
+            end: Math.min(documentRows.length, this.#scrollTop + viewportHeight),
         };
         const previousDocumentRange = previousDescriptor?.nextDocumentRange ?? null;
         const sameGeometry = previousDescriptor !== null
@@ -391,6 +403,9 @@ export class TranscriptViewport {
             nextDocumentRange,
             previousFollowingEnd: previousDescriptor?.followingEnd ?? null,
             followingEnd: this.#followingEnd,
+            transientRowCount: Math.max(0, documentRows.length - this.#selectableDocumentRowCount),
+            transientAlignmentGapRows,
+            bottomAlignedTailRowCount,
             verticalShiftRows,
             safeVerticalShift,
             selectionRevision: composingSelectionRevision,
@@ -416,7 +431,7 @@ export class TranscriptViewport {
             },
             sticky: stickyActive ? { row: 1, target: governing.firstRow, width: contentWidth } : null,
             bottom: bottomHit,
-            transientTail: Array.from({ length: Math.max(0, Math.min(input.documentRows.length, this.#scrollTop + viewportHeight) - Math.max(this.#scrollTop, this.#selectableDocumentRowCount)) }, (_row, index) => Math.max(this.#scrollTop, this.#selectableDocumentRowCount) - this.#scrollTop + index + 1),
+            transientTail: Array.from({ length: Math.max(0, Math.min(documentRows.length, this.#scrollTop + viewportHeight) - Math.max(this.#scrollTop, this.#selectableDocumentRowCount)) }, (_row, index) => Math.max(this.#scrollTop, this.#selectableDocumentRowCount) - this.#scrollTop + index + 1),
         };
         const frame = {
             rows: frameRows,
@@ -462,6 +477,9 @@ export class TranscriptViewport {
             nextDocumentRange: previous.descriptor.nextDocumentRange,
             previousFollowingEnd: previous.followingEnd,
             followingEnd: previous.followingEnd,
+            transientRowCount: previous.descriptor.transientRowCount,
+            transientAlignmentGapRows: previous.descriptor.transientAlignmentGapRows,
+            bottomAlignedTailRowCount: previous.descriptor.bottomAlignedTailRowCount,
             verticalShiftRows: 0,
             safeVerticalShift: false,
             selectionRevision: this.#selectionRevision,
@@ -587,6 +605,12 @@ export function assertTranscriptViewportFrameDescriptor(descriptor) {
     assertDocumentRange(descriptor.nextDocumentRange, "next");
     if (descriptor.previousDocumentRange !== null)
         assertDocumentRange(descriptor.previousDocumentRange, "previous");
+    if (!Number.isSafeInteger(descriptor.transientRowCount) || descriptor.transientRowCount < 0
+        || !Number.isSafeInteger(descriptor.transientAlignmentGapRows) || descriptor.transientAlignmentGapRows < 0
+        || !Number.isSafeInteger(descriptor.bottomAlignedTailRowCount) || descriptor.bottomAlignedTailRowCount < 0
+        || descriptor.transientAlignmentGapRows + descriptor.bottomAlignedTailRowCount > descriptor.transientRowCount) {
+        throw new TypeError("viewport frame descriptor transient geometry is invalid");
+    }
     if (!Number.isSafeInteger(descriptor.verticalShiftRows))
         throw new TypeError("viewport frame descriptor shift is invalid");
     if (descriptor.previousDocumentRange === null && descriptor.verticalShiftRows !== 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.1.8-dev.260",
+  "version": "0.1.8-dev.269",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "packageManager": "npm@11.13.0",