@timurproko/a1 0.1.1-dev.7 → 0.1.1-dev.9

package/dist/src/product-identity.json

@@ -86,13 +86,13 @@
         "piEventFrameParitySchema": "a1-pi-event-frame-parity-v1"
     },
     "artifacts": {
-        "cliEntry": "bin/a1.js",
-        "supervisorEntry": "bin/a1-supervisor.js",
-        "guardianEntry": "bin/a1-guardian.js",
-        "uiEntry": "bin/a1-ui.js",
-        "nativeExecutable": "a1-terminal-host",
-        "nativeCrate": "a1-terminal-host",
-        "processGuardianExecutable": "a1-process-guardian",
+        "cliEntry": "bin/cli.js",
+        "supervisorEntry": "bin/supervisor.js",
+        "guardianEntry": "bin/guardian.js",
+        "uiEntry": "bin/ui.js",
+        "nativeExecutable": "terminal-host",
+        "nativeCrate": "terminal-host",
+        "processGuardianExecutable": "process-guardian",
         "releaseTarballStem": "timurproko-a1",
         "diagnosticStem": "a1"
     }

package/docs/architecture/process-guardian-provenance.md

@@ -1,6 +1,6 @@
 # Process guardian provenance
 
-A1 launch-instance containment uses a standalone native executable named `a1-process-guardian`. The approved implementation is a separate Rust crate at `native/process-guardian`; it is not a Node-API addon and does not reuse or resume the held composed terminal-host implementation.
+A1 launch-instance containment uses a standalone native executable named `process-guardian`. The approved implementation is a separate Rust crate at `native/process-guardian`; it is not a Node-API addon and does not reuse or resume the held composed terminal-host implementation.
 
 ## Boundary
 
@@ -13,10 +13,10 @@ On Windows it uses `windows-sys 0.61.2` to create a Job Object, enables `JOB_OBJ
 Release builds place the exact executable at:
 
 ```text
-dist/native/win32-x64/a1-process-guardian.exe
-dist/native/linux-x64/a1-process-guardian
-dist/native/darwin-x64/a1-process-guardian
-dist/native/darwin-arm64/a1-process-guardian
+dist/native/win32-x64/process-guardian.exe
+dist/native/linux-x64/process-guardian
+dist/native/darwin-x64/process-guardian
+dist/native/darwin-arm64/process-guardian
 ```
 
 Each supported artifact must be named in the release integrity manifest with target triple, crate version, guardian protocol version, SHA-256, byte size, build provenance, and signature/attestation status. A missing, altered, incompatible, or wrong-platform artifact is a concise unsupported-containment launch error; A1 never silently falls back to PID-only cleanup.

package/docs/architecture/toolchain.md

@@ -65,15 +65,15 @@ This mandatory candidate workflow checks documented package-root exports and the
 npm run sync:pi-ui
 ```
 
-This optional, mutating presentation-maintenance workflow regenerates component and event-frame parity evidence when maintainers deliberately adopt upstream UI changes. Review generated diffs, attribution, source-ledger records, and terminal parity before committing them. It is never an engine candidate acceptance gate and is not run by `check`, `prepack`, or release publication.
+This optional, mutating presentation-maintenance workflow regenerates component and event-frame parity evidence when maintainers deliberately adopt upstream UI changes. Review generated diffs, attribution, and source-ledger records before committing them. It is never an engine candidate acceptance gate and is not run by `check`, `prepack`, or release publication.
 
-`npm run test:pi-terminal-parity` remains an explicit presentation acceptance command. `node scripts/check-pinned-pi-source-ledger.mjs` validates accepted provenance; its `--engine-only` mode validates the ownership partition without comparing private upstream source.
+Presentation acceptance is the reader comparing `a1 pi` with pinned Pi. `node scripts/check-pinned-pi-source-ledger.mjs` validates accepted provenance; its `--engine-only` mode validates the ownership partition without comparing private upstream source.
 
 ## Preview publication
 
 A preview candidate must use a unique `-dev.N` version and exact manually accepted bytes. Publication packs once, binds evidence to source commit/version/integrity, runs applicable non-desktop gates, publishes under npm `next`, and verifies registry identity. It must keep `latest` unchanged and record physical/cross-platform certification as deferred.
 
-The GitHub trusted-publishing workflow is `.github/workflows/publish-next.yml`. Stable publication remains a separate release process from a clean tagged `master` commit after all mandatory platform gates pass.
+The GitHub trusted-publishing workflow is `.github/workflows/npm-publish.yml`. Stable publication remains a separate release process from a clean tagged `master` commit after all mandatory platform gates pass.
 
 ## A1 state paths
 

package/docs/ci-release-runbook.md

@@ -22,10 +22,18 @@ Need more coverage for a risky preview? Dispatch the candidate with `full: true`
 
 ## Publish a preview to npm `next`
 
+One command from a clean `develop` checkout runs the whole chain — candidate build, publish, registry verification:
+
+```sh
+npm run release:next
+```
+
+It dispatches the same trusted workflows below and never publishes local bytes. The manual steps remain the reference path:
+
 1. Make sure `Development validation required` is green on the `develop` tip.
 2. Dispatch **Build npm next candidate** with the exact commit and `confirm_candidate=build-uncertified-next-candidate`.
 3. Check the resulting `candidate-evidence.json`: gates passed, package integrity matches.
-4. Approve the `npm-next` environment and dispatch **Publish npm next** with the candidate run id.
+4. Approve the `npm-publish` environment and dispatch **Publish npm next** with the candidate run id.
 
 The publisher uploads the exact validated tarball — it never rebuilds. Candidates expire after 14 days; an expired or mismatched artifact means building a new candidate, not patching the old one.
 
@@ -35,7 +43,7 @@ The publisher uploads the exact validated tarball — it never rebuilds. Candida
 2. Dispatch **Build stable candidate** — it packs once and validates the same bytes on all three platforms.
 3. Dispatch **Certify stable physical platforms** on the dedicated isolated workers (they set `PHYSICAL_WORKER_ISOLATED=true` and run under the `stable-physical` environment). Never run physical host probes on a developer workstation.
 4. Dispatch **Certify stable candidate** with both run ids. `Stable candidate required` passes only when every verdict binds the same commit, version, and digest.
-5. Merge that exact commit to `master`, tag it `v<version>`, and dispatch **Publish npm stable**, then approve `npm-stable`.
+5. Merge that exact commit to `master`, tag it `v<version>`, and dispatch **Publish npm stable**, then approve `npm-publish`.
 
 Stable artifacts expire after 30 days. The same rule as previews applies: publication still requires exact certified bytes. Never upload locally rebuilt bytes, and never route around certification by rebuilding inside a publisher.
 

package/docs/manual-terminal-colour-check.md

@@ -0,0 +1,55 @@
+# Terminal colour check
+
+## What can go wrong
+
+Every colour the interface draws is 24-bit: the pinned dark theme's accent is
+`#8abeb7`, its border `#5f87ff`, its headings `#f0c674`. On Windows, Node decides
+once at startup whether it may send those sequences to the terminal at all. It
+asks the console to enable virtual terminal processing; when that fails it renders
+ANSI itself, and its renderer knows only the sixteen SGR colours. Each 24-bit
+colour is then replaced by the terminal's nearest palette entry, so the whole
+interface shifts at once — accent to the terminal's cyan, headings to its yellow —
+while the application still writes exactly the bytes it always wrote.
+
+That decision is made per process, from the console handle the process was given,
+and every process it launches inherits the result. It is a property of how the
+session was started, not of what is drawn.
+
+## Launching so colour survives
+
+The installed command is an npm shim — a shell script that `exec`s Node — and that
+shape keeps 24-bit colour. So does `pi`, for the same reason.
+
+- Installed: `a1`, `a1 pi`
+- From a checkout: `scripts/dev` and `scripts/dev pi`
+
+`npm start` and `npm run start:pi` build first and then launch through the same
+entry, but a package manager on Windows hands the script to `cmd.exe`, which can
+leave the launch without a terminal on its input; the launcher says so and stops
+rather than opening a session that closes as it starts. Running `scripts/dev`
+from the shell is the direct path.
+
+A directly launched `node scripts/start-local.mjs` under Git Bash does not, and
+neither does a directly launched `node …/pi/dist/cli.js`: the collapse belongs to
+the launch, not to either application.
+
+## Checking a terminal
+
+```
+node scripts/check-terminal-colour.mjs
+```
+
+It prints the same colour as 24-bit, as a 256-colour index, and as the terminal's
+own palette entry. When the first block is indistinguishable from the third, this
+launch collapses colour and any comparison made in it is a comparison of two wrong
+screens.
+
+## What the gates hold
+
+- `test/features/launch/terminal-colour-fidelity.test.ts` holds the emitted bytes:
+  the pinned palette resolves to 24-bit sequences, a 256-colour terminal stays on
+  indices, and the launch chain keeps inheriting the terminal it was started from
+  rather than opening a console of its own.
+- The reader compares `a1 pi` with pinned Pi in the same terminal. Run the colour
+  check first: a launch that collapses colour makes both sessions equally wrong, so
+  they would agree with each other and disagree with what a user sees.

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.1.1-dev.7",
+  "version": "0.1.1-dev.9",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "packageManager": "npm@11.13.0",
   "bin": {
-    "a1": "bin/a1.js"
+    "a1": "bin/cli.js"
   },
   "files": [
     "bin",
@@ -21,32 +21,33 @@
     "clean": "node scripts/clean.mjs",
     "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/build-process-guardian.mjs",
     "build:process-guardian": "node scripts/build-process-guardian.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsgo -p tsconfig.json --noEmit",
     "check:architecture": "node scripts/check-architecture.mjs && node scripts/product-identifier-policy.mjs --check && node scripts/check-product-identity-boundaries.mjs && node scripts/check-package-identity.mjs && node scripts/check-pinned-pi-source-ledger.mjs && node scripts/check-terminal-host-provenance.mjs",
     "check:customization-ready": "node scripts/check-owned-ui-customization-prerequisites.mjs",
     "check:deprecated": "node scripts/check-deprecated-dependencies.mjs",
     "branches:prune": "node scripts/prune-merged-branches.mjs",
     "check": "npm run test:fast",
     "publish:next": "tsx scripts/publish-next.ts",
+    "release:next": "node scripts/release-next.mjs",
     "test": "npm run test:fast",
     "test:fast": "node scripts/run-validation-tier.mjs typecheck fast",
     "test:scope": "node scripts/run-validation-tier.mjs",
     "test:full": "node scripts/run-validation-tier.mjs full-release",
     "test:release": "node scripts/run-release-gates.mjs",
     "test:terminal-host": "node scripts/run-terminal-host-probe.mjs",
-    "test:pi-terminal-parity": "npm run build --silent && node scripts/run-pi-terminal-parity.mjs",
     "test:pi-engine-conformance": "vitest run test/foundation/pi-engine-adapter/conformance.test.ts test/foundation/pi-engine-adapter/runtime-integration.test.ts test/foundation/pi-engine-adapter/session-integration.test.ts",
     "report:pi-engine-conformance": "npm run build --silent && node scripts/run-pi-engine-conformance.mjs",
     "sync:pi-ui": "npm run update:pi-component-parity && npm run update:pi-event-frame-parity && npm run update:pi-settings-metadata",
     "update:pi-component-parity": "tsx scripts/update-pi-component-parity.ts",
     "update:pi-event-frame-parity": "tsx scripts/update-pi-event-frame-parity.ts",
     "proof:terminal-host": "node scripts/run-terminal-host.mjs",
-    "start": "npm run build && node scripts/start-local.mjs",
+    "start": "npm run build && node scripts/dev-launch.mjs",
+    "start:pi": "npm run build && node scripts/dev-launch.mjs pi",
+    "start:sandbox": "npm run build && node scripts/dev-launch.mjs sandbox",
     "prepack": "node scripts/prepack-gate.mjs",
     "prepublishOnly": "npm run test:release",
     "prepare": "npm run build",
-    "update:pi-settings-metadata": "node scripts/update-pi-settings-metadata.mjs",
-    "clean:worktrees": "node scripts/clean-worktrees.mjs"
+    "update:pi-settings-metadata": "node scripts/update-pi-settings-metadata.mjs"
   },
   "dependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",
@@ -59,6 +60,7 @@
     "@types/cross-spawn": "6.0.6",
     "@types/node": "24.2.1",
     "@types/semver": "7.8.0",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "@xterm/headless": "6.0.0",
     "node-pty": "1.1.0",
     "tsx": "4.20.3",

package/dist/src/composition/transparent-runtime.d.ts

@@ -1,6 +0,0 @@
-import type { LaunchProfileId } from "../foundation/lifecycle/index.js";
-export declare function selectTransparentChild(environment?: NodeJS.ProcessEnv, executable?: string, compositionUrl?: string): {
-    readonly executable: string;
-    readonly arguments: readonly string[];
-};
-export declare function runSelectedTransparentRuntime(profileId: Exclude<LaunchProfileId, "a1">, environment?: NodeJS.ProcessEnv): Promise<number>;

package/dist/src/composition/transparent-runtime.js

@@ -1,19 +0,0 @@
-import { fileURLToPath } from "node:url";
-import { runTransparentForeground } from "../foundation/transparent-terminal/index.js";
-export function selectTransparentChild(environment = process.env, executable = process.execPath, compositionUrl = import.meta.url) {
-    const entry = fileURLToPath(new URL("../foundation/pi-engine-adapter/public-main-entry.js", compositionUrl));
-    return { executable, arguments: [entry, ...parseSelectedArguments(environment.A1_LAUNCH_ARGUMENTS_JSON)] };
-}
-export async function runSelectedTransparentRuntime(profileId, environment = process.env) {
-    const child = selectTransparentChild(environment);
-    return await runTransparentForeground({ profileId, environment, ...child });
-}
-function parseSelectedArguments(source) {
-    if (!source)
-        return [];
-    const value = JSON.parse(source);
-    if (!Array.isArray(value) || value.some(item => typeof item !== "string")) {
-        throw new TypeError("A1_LAUNCH_ARGUMENTS_JSON must be a JSON array of strings");
-    }
-    return value;
-}

package/dist/src/foundation/transparent-terminal/command-resolution.d.ts

@@ -1,13 +0,0 @@
-export interface ResolvedTransparentCommand {
-    readonly executable: string;
-    readonly arguments: readonly string[];
-    readonly source: "exact" | "path" | "npm-windows-shim";
-}
-export interface TransparentCommandResolutionOptions {
-    readonly platform?: NodeJS.Platform;
-    readonly cwd: string;
-    readonly environment: Readonly<Record<string, string>>;
-    readonly nodeExecutable?: string;
-}
-/** Resolve a command without invoking a command interpreter. */
-export declare function resolveTransparentCommand(executable: string, arguments_: readonly string[], options: TransparentCommandResolutionOptions): Promise<ResolvedTransparentCommand>;

package/dist/src/foundation/transparent-terminal/command-resolution.js

@@ -1,72 +0,0 @@
-import { access, readFile } from "node:fs/promises";
-import { extname, isAbsolute, resolve } from "node:path";
-/** Resolve a command without invoking a command interpreter. */
-export async function resolveTransparentCommand(executable, arguments_, options) {
-    const platform = options.platform ?? process.platform;
-    return platform === "win32"
-        ? await resolveWindowsCommand(executable, arguments_, options)
-        : { executable, arguments: [...arguments_], source: "exact" };
-}
-async function resolveWindowsCommand(command, commandArguments, options) {
-    const resolved = await resolveWindowsPathCommand(command, options.cwd, options.environment);
-    const selected = resolved ?? throwCommandNotFound(command);
-    if (extname(selected).toLowerCase() !== ".cmd") {
-        return { executable: selected, arguments: [...commandArguments], source: "path" };
-    }
-    return await unwrapNpmWindowsShim(selected, commandArguments, options.nodeExecutable ?? process.execPath);
-}
-async function resolveWindowsPathCommand(executable, cwd, environment) {
-    const hasPath = isAbsolute(executable) || executable.includes("/") || executable.includes("\\");
-    const roots = hasPath ? [cwd] : windowsPath(environment).split(";").filter(Boolean);
-    const extension = extname(executable);
-    const extensions = extension ? [""] : windowsExecutableExtensions(environment);
-    for (const root of roots) {
-        const base = hasPath ? resolve(cwd, executable) : resolve(root.replace(/^"|"$/g, ""), executable);
-        for (const suffix of extensions) {
-            const candidate = `${base}${suffix}`;
-            if (await isFile(candidate))
-                return candidate;
-        }
-    }
-    return null;
-}
-async function unwrapNpmWindowsShim(shimPath, arguments_, fallbackNodeExecutable) {
-    const source = (await readFile(shimPath, "utf8")).replace(/^\uFEFF/, "");
-    const targetMatch = source.match(/"%_prog%"\s+"%dp0%\\([^"\r\n]+)"\s+%\*/i);
-    if (!targetMatch?.[1]) {
-        throw Object.assign(new Error(`transparent launch refuses arbitrary Windows command script ${shimPath}; configure an executable binary instead`), { code: "UNSUPPORTED_WINDOWS_COMMAND_SHIM" });
-    }
-    const shimRoot = resolve(shimPath, "..");
-    const target = resolve(shimRoot, targetMatch[1].replaceAll("\\", "/"));
-    if (!await isFile(target))
-        throw Object.assign(new Error(`npm command shim target is missing: ${target}`), { code: "ENOENT" });
-    const localNode = resolve(shimRoot, "node.exe");
-    const nodeExecutable = await isFile(localNode) ? localNode : fallbackNodeExecutable;
-    return {
-        executable: nodeExecutable,
-        arguments: [target, ...arguments_],
-        source: "npm-windows-shim",
-    };
-}
-function throwCommandNotFound(command) {
-    throw Object.assign(new Error(`spawn ${command} ENOENT`), { code: "ENOENT" });
-}
-function windowsPath(environment) {
-    return environment.Path ?? environment.PATH ?? "";
-}
-function windowsExecutableExtensions(environment) {
-    const source = environment.PATHEXT ?? ".COM;.EXE;.BAT;.CMD";
-    return [...new Set(source.split(";").filter(Boolean).flatMap(value => {
-            const extension = value.startsWith(".") ? value : `.${value}`;
-            return [extension, extension.toLowerCase()];
-        }))];
-}
-async function isFile(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/dist/src/foundation/transparent-terminal/foreground-broker.d.ts

@@ -1,24 +0,0 @@
-import type { NativeProcessIdentity, TransparentTerminalLaunchProfile, TransparentTerminalLifecycleOutcome } from "../lifecycle/index.js";
-export type TransparentStopReason = "owner-disconnect" | "user-request" | "update";
-export interface TransparentChildHandle {
-    readonly processIdentity: NativeProcessIdentity;
-    readonly outcome: Promise<TransparentTerminalLifecycleOutcome>;
-    stop(reason: TransparentStopReason): Promise<TransparentTerminalLifecycleOutcome>;
-}
-export interface TransparentNativeLauncher {
-    launch(profile: TransparentTerminalLaunchProfile): Promise<TransparentChildHandle>;
-}
-export interface ForegroundBrokerRequest {
-    readonly profile: TransparentTerminalLaunchProfile;
-    readonly stopRequested?: Promise<TransparentStopReason>;
-}
-export interface ForegroundBrokerResult {
-    readonly processIdentity: NativeProcessIdentity | null;
-    readonly outcome: TransparentTerminalLifecycleOutcome;
-}
-/**
- * Waits for one directly attached child. Launch-instance registration and
- * process-tree containment belong to the outer profile-neutral guardian.
- * Ordinary terminal data never enters this object.
- */
-export declare function runForegroundBroker(request: ForegroundBrokerRequest, launcher: TransparentNativeLauncher): Promise<ForegroundBrokerResult>;

package/dist/src/foundation/transparent-terminal/foreground-broker.js

@@ -1,30 +0,0 @@
-import { assertNativeProcessIdentity, assertTransparentTerminalLaunchProfile } from "../lifecycle/index.js";
-/**
- * Waits for one directly attached child. Launch-instance registration and
- * process-tree containment belong to the outer profile-neutral guardian.
- * Ordinary terminal data never enters this object.
- */
-export async function runForegroundBroker(request, launcher) {
-    assertTransparentTerminalLaunchProfile(request.profile);
-    let handle;
-    try {
-        handle = await launcher.launch(request.profile);
-        assertNativeProcessIdentity(handle.processIdentity);
-    }
-    catch (error) {
-        return {
-            processIdentity: null,
-            outcome: { kind: "spawn-error", message: errorMessage(error), code: errorCode(error) },
-        };
-    }
-    const outcome = request.stopRequested
-        ? await Promise.race([handle.outcome, request.stopRequested.then(async (reason) => await handle.stop(reason))])
-        : await handle.outcome;
-    return { processIdentity: handle.processIdentity, outcome };
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function errorCode(error) {
-    return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : null;
-}

package/dist/src/foundation/transparent-terminal/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./command-resolution.js";
-export * from "./foreground-broker.js";
-export * from "./main.js";
-export * from "./native-launcher.js";

package/dist/src/foundation/transparent-terminal/index.js

@@ -1,4 +0,0 @@
-export * from "./command-resolution.js";
-export * from "./foreground-broker.js";
-export * from "./main.js";
-export * from "./native-launcher.js";

package/dist/src/foundation/transparent-terminal/main.d.ts

@@ -1,9 +0,0 @@
-import { type LaunchProfileId } from "../lifecycle/index.js";
-export interface TransparentForegroundOptions {
-    readonly environment?: NodeJS.ProcessEnv;
-    readonly profileId?: LaunchProfileId;
-    readonly cwd?: string;
-    readonly executable: string;
-    readonly arguments: readonly string[];
-}
-export declare function runTransparentForeground(options: TransparentForegroundOptions): Promise<number>;

package/dist/src/foundation/transparent-terminal/main.js

@@ -1,87 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { realpath } from "node:fs/promises";
-import { resolve } from "node:path";
-import { assertLaunchProfileId } from "../lifecycle/index.js";
-import { runForegroundBroker } from "./foreground-broker.js";
-import { createPlatformTransparentLauncher } from "./native-launcher.js";
-export async function runTransparentForeground(options) {
-    const environment = { ...(options.environment ?? process.env) };
-    const profileId = options.profileId ?? environment.A1_LAUNCH_PROFILE ?? "a1";
-    assertLaunchProfileId(profileId);
-    const profile = await launchProfile(environment, options, profileId);
-    const stop = stopSignal();
-    try {
-        const result = await runForegroundBroker({ profile, stopRequested: stop.requested }, createPlatformTransparentLauncher());
-        if (result.outcome.kind === "exited")
-            return result.outcome.exitCode;
-        if (result.outcome.kind === "signaled")
-            return 1;
-        if (result.outcome.kind === "stopped" || result.outcome.kind === "detached")
-            return 0;
-        throw Object.assign(new Error(result.outcome.message), { code: result.outcome.code ?? undefined });
-    }
-    finally {
-        stop.dispose();
-    }
-}
-async function launchProfile(environment, options, profileId) {
-    const executable = options.executable;
-    const arguments_ = options.arguments;
-    const cwd = await realpath(options.cwd ?? process.cwd());
-    const terminalType = environment.TERM?.trim() || "xterm-256color";
-    return {
-        id: `${profileId}-transparent-${randomUUID()}`,
-        terminalCapability: "transparent",
-        executable,
-        arguments: arguments_,
-        cwd,
-        environment: selectedChildEnvironment(environment),
-        terminalType,
-        dimensions: terminalDimensions(environment),
-        ownerDisconnect: "stop",
-        recovery: "none",
-        surface: "none",
-        visualReconnection: "none",
-    };
-}
-function selectedChildEnvironment(environment) {
-    const selected = {};
-    for (const [name, value] of Object.entries(environment)) {
-        if (value !== undefined && !name.startsWith("A1_"))
-            selected[name] = value;
-    }
-    return selected;
-}
-function terminalDimensions(environment) {
-    const columns = positiveInteger(environment.COLUMNS) ?? 80;
-    const rows = positiveInteger(environment.LINES) ?? 24;
-    return { columns: Math.min(500, Math.max(2, columns)), rows: Math.min(300, Math.max(1, rows)) };
-}
-function positiveInteger(value) {
-    const parsed = Number(value);
-    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
-}
-function stopSignal() {
-    let resolveStop;
-    let settled = false;
-    const requested = new Promise(resolve => { resolveStop = resolve; });
-    const request = (reason) => {
-        if (settled)
-            return;
-        settled = true;
-        resolveStop(reason);
-    };
-    const onSigterm = () => request("user-request");
-    // The attached child shares foreground signal delivery. Keep the broker alive
-    // without translating or forwarding Ctrl+C.
-    const onSigint = () => undefined;
-    process.once("SIGTERM", onSigterm);
-    process.on("SIGINT", onSigint);
-    return {
-        requested,
-        dispose() {
-            process.off("SIGTERM", onSigterm);
-            process.off("SIGINT", onSigint);
-        },
-    };
-}

package/dist/src/foundation/transparent-terminal/native-launcher.d.ts

@@ -1,25 +0,0 @@
-import { type ChildProcess, type SpawnOptions } from "node:child_process";
-import type { TransparentTerminalLaunchProfile } from "../lifecycle/index.js";
-import type { TransparentChildHandle, TransparentNativeLauncher } from "./foreground-broker.js";
-export interface NativeSpawnAdapter {
-    resolveCommand(profile: TransparentTerminalLaunchProfile): Promise<{
-        readonly executable: string;
-        readonly arguments: readonly string[];
-    }>;
-    spawn(executable: string, arguments_: readonly string[], options: SpawnOptions): ChildProcess;
-    observeStartIdentity(child: ChildProcess): Promise<string>;
-    identityMatches(child: ChildProcess, expectedStartIdentity: string): Promise<boolean>;
-    stop(child: ChildProcess, force: boolean): Promise<void>;
-    waitForExit(child: ChildProcess, timeoutMs: number): Promise<boolean>;
-}
-export declare function createPlatformTransparentLauncher(platform?: NodeJS.Platform, adapter?: NativeSpawnAdapter): TransparentNativeLauncher;
-export declare class WindowsTransparentLauncher implements TransparentNativeLauncher {
-    private readonly adapter;
-    constructor(adapter?: NativeSpawnAdapter);
-    launch(profile: TransparentTerminalLaunchProfile): Promise<TransparentChildHandle>;
-}
-export declare class UnixTransparentLauncher implements TransparentNativeLauncher {
-    private readonly adapter;
-    constructor(adapter?: NativeSpawnAdapter);
-    launch(profile: TransparentTerminalLaunchProfile): Promise<TransparentChildHandle>;
-}