@timurproko/a1 0.1.8-dev.0b6d8cc → 0.1.8-dev.121

package/docs/manual-owned-ui-checkpoint.md

@@ -0,0 +1,52 @@
+# Manual owned-UI checkpoint
+
+This checkpoint is user-controlled. Tests and coding agents must not launch or focus a terminal, inject desktop input, resize windows, close applications, or clean up workstation processes.
+
+## Prepare an exact candidate
+
+From the candidate checkout, pack once and install that tarball into a disposable prefix:
+
+```powershell
+npm ci
+npm run build
+npm pack --ignore-scripts --pack-destination .artifacts/manual-owned-ui
+npm install --prefix .artifacts/manual-owned-ui/install --ignore-scripts .artifacts/manual-owned-ui/<exact-tarball>.tgz
+```
+
+Use isolated A1 control state:
+
+```powershell
+$manualRoot = (Resolve-Path ".artifacts/manual-owned-ui").Path
+$env:A1_CONFIG_DIR = "$manualRoot\state\config"
+$env:A1_DATA_DIR = "$manualRoot\state\data"
+$env:A1_RUNTIME_DIR = "$manualRoot\state\runtime"
+$env:A1_DATABASE_PATH = "$manualRoot\state\data\control.sqlite3"
+```
+
+Run each installed launch form yourself:
+
+```powershell
+& ".artifacts/manual-owned-ui/install/node_modules/.bin/a1.cmd"
+& ".artifacts/manual-owned-ui/install/node_modules/.bin/a1.cmd" pi
+& ".artifacts/manual-owned-ui/install/node_modules/.bin/a1.cmd" sandbox
+```
+
+All three commands use the same A1-owned rendering and input pipeline. Bare `a1` enables A1-owned screens. `a1 pi` withholds those screens and reads the ordinary Pi profile. `a1 sandbox` also withholds them and reads the isolated sandbox profile. Confirm that files created through `/settings`, `/login`, sessions, and resource directories remain under the selected profile root.
+
+Physical automation is not part of this repository baseline. Future certification tooling may run only on dedicated disposable workers or VMs with exclusive test desktops, never on this workstation.
+
+## Compare bare A1 with `a1 pi`
+
+Use the same terminal, working directory, dimensions, environment, and equivalent profile resources. Bare A1 and the comparison profile intentionally use separate profile roots.
+
+- [ ] Startup resources, logo, notices, spacing, editor, and footer match.
+- [ ] Text, Unicode, emoji, styles, cursor, and layout match.
+- [ ] Rapid typing has no visible delay or dropped or duplicated characters.
+- [ ] Ctrl+C, Ctrl+P, arrows, paste, focus, dialogs, mouse, and wheel behave correctly.
+- [ ] Selection, copy, clipboard, scrollback, and resize behave correctly.
+- [ ] Normal and error exits return a usable parent prompt.
+- [ ] Parent typing, cursor movement, Backspace, Delete, and submission work after exit.
+
+Report failures with bare-versus-comparison behavior, platform and terminal versions, exact command, reproducibility, and optional manually captured evidence.
+
+For recovery, use `a1 pi`; do not use the removed `a1 ui` command. `a1 sandbox` remains profile isolation rather than a security boundary. Manual acceptance can authorize an exact uncertified development preview after non-desktop gates pass. It does not certify stable presentation parity or platform support.

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

@@ -29,7 +29,7 @@ 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
+A directly launched `node scripts/development/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.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.1.8-dev.0b6d8cc",
+  "version": "0.1.8-dev.121",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "packageManager": "npm@11.13.0",
@@ -25,38 +25,40 @@
   },
   "scripts": {
     "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",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/development/build-process-guardian.mjs",
+    "build:process-guardian": "node scripts/development/build-process-guardian.mjs",
     "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",
+    "check:architecture": "node scripts/governance/check-architecture.mjs && node scripts/governance/product-identifier-policy.mjs --check && node scripts/governance/check-product-identity-boundaries.mjs && node scripts/governance/check-package-identity.mjs && node scripts/governance/check-pinned-pi-source-ledger.mjs && node scripts/governance/check-terminal-host-provenance.mjs",
+    "check:customization-ready": "node scripts/governance/check-owned-ui-customization-prerequisites.mjs",
+    "check:deprecated": "node scripts/governance/check-deprecated-dependencies.mjs",
     "branches:prune": "node scripts/prune-merged-branches.mjs",
     "check": "npm run test:fast",
-    "release": "node scripts/release.mjs",
+    "develop": "node scripts/development/develop.mjs",
+    "release": "node scripts/release/release.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-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",
+    "test:fast": "node scripts/release/run-validation-tier.mjs typecheck fast",
+    "test:scope": "node scripts/release/run-validation-tier.mjs",
+    "test:full": "node scripts/release/run-validation-tier.mjs full-release",
+    "test:release": "node scripts/release/run-release-gates.mjs",
+    "test:terminal-host": "node scripts/development/run-terminal-host-probe.mjs",
+    "test:pi-engine-conformance": "vitest run test/integrations/pi/engine/conformance.test.ts test/integrations/pi/engine/runtime-integration.test.ts test/integrations/pi/engine/session-integration.test.ts",
+    "report:pi-engine-conformance": "npm run build --silent && node scripts/pi/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/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",
+    "update:pi-component-parity": "tsx scripts/pi/update-pi-component-parity.ts",
+    "update:pi-event-frame-parity": "tsx scripts/pi/update-pi-event-frame-parity.ts",
+    "proof:terminal-host": "node scripts/development/run-terminal-host.mjs",
+    "start": "npm run build && node scripts/development/dev-launch.mjs",
+    "start:pi": "npm run build && node scripts/development/dev-launch.mjs pi",
+    "start:sandbox": "npm run build && node scripts/development/dev-launch.mjs sandbox",
+    "prepack": "node scripts/release/prepack-gate.mjs",
     "prepublishOnly": "npm run test:release",
     "prepare": "npm run build",
-    "update:pi-settings-metadata": "node scripts/update-pi-settings-metadata.mjs"
+    "update:pi-settings-metadata": "node scripts/pi/update-pi-settings-metadata.mjs"
   },
   "dependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",
     "@earendil-works/pi-tui": "0.84.2",
+    "chalk": "5.6.2",
     "cross-spawn": "7.0.6",
     "grok-mermaid": "0.2.2",
     "semver": "7.8.5"

package/dist/src/composition/index.d.ts

@@ -1,48 +0,0 @@
-import { type AgentEnginePort } from "../foundation/agent-engine-contracts/index.js";
-import { type PiEngineAdapter } from "../foundation/pi-engine-adapter/index.js";
-import { type OwnedUiApplicationPort, type PresentationComponentPort, type PresentationRuntimePort, type PresentationTerminalPort } from "../foundation/presentation-contracts/index.js";
-import { OwnedUiSettingsSession } from "../foundation/owned-ui-settings/index.js";
-import type { UiRouteHost } from "../foundation/pi-owned-ui-integration/index.js";
-export interface ProcessCompositionOptions {
-    readonly cwd?: string;
-    readonly sessionId?: string;
-    readonly engine?: AgentEnginePort;
-    readonly presentationFactory?: (root: PresentationComponentPort, terminal: PresentationTerminalPort) => PresentationRuntimePort;
-    readonly createPiAdapter?: () => Promise<PiEngineAdapter>;
-}
-export interface OwnedUiCompositionOptions {
-    readonly cwd?: string;
-    readonly terminal?: PresentationTerminalPort;
-    readonly createPiAdapter?: () => Promise<PiEngineAdapter>;
-    /**
-     * A1 profile whose settings this session reads and writes. Omitted keeps the
-     * session settings-free, which is what the pinned comparison paths use.
-     */
-    readonly profileId?: string;
-    /**
-     * Whether A1's own surfaces are reachable. Withheld for the rendering parity
-     * comparison, which measures this composition against pinned Pi and so must
-     * present Pi's interface and nothing of A1's own. It is the same composition
-     * either way: a parity run built beside the product would measure itself.
-     */
-    readonly ownedSurfaces?: "on" | "off";
-}
-export interface OwnedUiComposition {
-    readonly application: OwnedUiApplicationPort;
-    /** Present when a profile was supplied, so the caller can resolve settings before start. */
-    readonly settings: OwnedUiSettingsSession | null;
-}
-export declare function composeOwnedUiApplication(options?: OwnedUiCompositionOptions): Promise<OwnedUiApplicationPort>;
-export declare function composeOwnedUi(options?: OwnedUiCompositionOptions): Promise<OwnedUiComposition>;
-export interface ProcessComposition {
-    readonly engine: AgentEnginePort;
-    createPresentation(root: PresentationComponentPort, terminal: PresentationTerminalPort): PresentationRuntimePort;
-    dispose(): Promise<void>;
-}
-export declare function composeProcess(options?: ProcessCompositionOptions): Promise<ProcessComposition>;
-/**
- * Registers the A1-owned screens and adapts the app host to the shell's route
- * seam. The shell mounts whatever surface it is handed and forwards keys; it
- * never learns what an app is.
- */
-export declare function createOwnedRouteHost(settings: OwnedUiSettingsSession): UiRouteHost;

package/dist/src/composition/index.js

@@ -1,258 +0,0 @@
-import { AGENT_ENGINE_CONTRACT_VERSION, assertAgentCapabilityContract, assertAgentCommand, } from "../foundation/agent-engine-contracts/index.js";
-import { createPiEngineAdapter } from "../foundation/pi-engine-adapter/index.js";
-import { createPiPresentationRuntime, createPiTerminalBridge } from "../foundation/pi-tui-runtime-adapter/index.js";
-import { assertPresentationComponent, assertPresentationRuntime, } from "../foundation/presentation-contracts/index.js";
-import { OwnedUiSessionShell } from "../foundation/pi-owned-ui-integration/index.js";
-import { OwnedUiSettingsSession, OwnedUiSettingsStore } from "../foundation/owned-ui-settings/index.js";
-import { UiAppHost, UiAppRegistry } from "../foundation/ui-apps/index.js";
-import { applyConfiguredPiTheme, getAvailablePiThemes, piTheme } from "../foundation/pi-component-adapter/index.js";
-import { faint } from "../foundation/ui-components/index.js";
-import { SETTINGS_APP_ID, SETTINGS_ROUTE, SettingsApp } from "../features/owned-ui/index.js";
-import { resolveProductPaths } from "../foundation/lifecycle/index.js";
-const CAPABILITIES = {
-    contractVersion: AGENT_ENGINE_CONTRACT_VERSION,
-    commands: ["prompt", "steer", "follow-up", "abort", "retry", "compact", "bash", "replace-session"],
-    events: ["lifecycle", "content", "command-outcome", "snapshot-invalidated", "diagnostic"],
-    snapshots: { supported: true, maxBytes: 1024 * 1024 },
-};
-export async function composeOwnedUiApplication(options = {}) {
-    return (await composeOwnedUi(options)).application;
-}
-export async function composeOwnedUi(options = {}) {
-    const cwd = options.cwd ?? process.cwd();
-    const adapter = options.createPiAdapter
-        ? await options.createPiAdapter()
-        : await createPiEngineAdapter({ cwd, availableThemes: () => getAvailablePiThemes().map(theme => theme.name) });
-    const settings = options.profileId === undefined
-        ? null
-        : new OwnedUiSettingsSession({
-            store: new OwnedUiSettingsStore({ configDir: resolveProductPaths().configDir, profileId: options.profileId }),
-            agentProvider: () => adapter.settingsPort(),
-        });
-    // Before anything is drawn, so every surface uses the configured theme rather
-    // than the one guessed from the terminal's background.
-    applyConfiguredPiTheme(adapter.configuredTheme());
-    const routeHost = settings === null || options.ownedSurfaces === "off" ? null : createOwnedRouteHost(settings);
-    const shell = new OwnedUiSessionShell({
-        backend: adapter,
-        cwd,
-        ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-        ...(routeHost === null ? {} : { routeHost }),
-    });
-    const application = {
-        get disposed() { return adapter.disposed; },
-        start: () => shell.start(),
-        flush: () => adapter.flushEvents(),
-        waitUntilStopped: () => shell.waitUntilStopped(),
-        dispose: () => shell.dispose(),
-    };
-    return { application, settings };
-}
-export async function composeProcess(options = {}) {
-    let engine = options.engine;
-    if (!engine) {
-        const adapter = options.createPiAdapter
-            ? await options.createPiAdapter()
-            : await createPiEngineAdapter({
-                ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
-                ...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),
-            });
-        engine = new PiAgentEngineBridge(adapter, options.cwd ?? process.cwd());
-    }
-    assertAgentCapabilityContract(engine.capabilities);
-    if (typeof engine.createSession !== "function" || typeof engine.dispose !== "function")
-        throw new TypeError("composed engine does not satisfy the neutral engine port");
-    const presentations = new Set();
-    let disposed = false;
-    return {
-        engine,
-        createPresentation(root, terminal) {
-            if (disposed)
-                throw new Error("process composition is disposed");
-            assertPresentationComponent(root);
-            const runtime = options.presentationFactory?.(root, terminal) ?? createPiPresentationRuntime(root, terminal);
-            assertPresentationRuntime(runtime);
-            presentations.add(runtime);
-            return runtime;
-        },
-        async dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            const failures = [];
-            for (const runtime of [...presentations].reverse())
-                await runtime.stop().catch(error => failures.push(error));
-            await engine.dispose().catch(error => failures.push(error));
-            if (failures.length)
-                throw new AggregateError(failures, "process composition disposal failed");
-        },
-    };
-}
-class PiAgentEngineBridge {
-    adapter;
-    cwd;
-    capabilities = CAPABILITIES;
-    #session;
-    constructor(adapter, cwd) {
-        this.adapter = adapter;
-        this.cwd = cwd;
-    }
-    async createSession(input) {
-        if (this.#session)
-            return this.#session;
-        if (input.cwd !== this.cwd)
-            throw new TypeError("composed Pi engine cannot change working directory");
-        await this.adapter.start();
-        this.#session = new PiAgentSessionBridge(this.adapter, input.sessionId);
-        return this.#session;
-    }
-    async dispose() { await this.adapter.dispose(); }
-}
-class PiAgentSessionBridge {
-    adapter;
-    sessionId;
-    capabilities = CAPABILITIES;
-    lifecycle = "starting";
-    #listeners = new Set();
-    #unsubscribe;
-    constructor(adapter, sessionId) {
-        this.adapter = adapter;
-        this.sessionId = sessionId;
-        this.#unsubscribe = adapter.onEvent(event => {
-            const converted = convertEvent(event);
-            if (!converted)
-                return;
-            if (converted.type === "lifecycle")
-                this.lifecycle = converted.lifecycle;
-            for (const listener of this.#listeners)
-                listener(converted);
-        });
-        this.lifecycle = toLifecycle(adapter.snapshot().view.lifecycle);
-    }
-    async execute(command) {
-        assertAgentCommand(command, this.capabilities);
-        if (command.sessionId !== this.sessionId)
-            return "rejected";
-        if (command.type === "bash") {
-            const result = await this.adapter.executeBashWorkflow(command.command, false);
-            return !result.cancelled && result.exitCode === 0 ? "completed" : result.cancelled ? "cancelled" : "failed";
-        }
-        const owned = toOwnedCommand(command);
-        const result = await this.adapter.execute(owned);
-        return result.outcome === "timed-out" ? "failed" : result.outcome;
-    }
-    subscribe(listener) { this.#listeners.add(listener); return () => this.#listeners.delete(listener); }
-    async snapshot() {
-        const snapshot = this.adapter.snapshot();
-        return {
-            contractVersion: AGENT_ENGINE_CONTRACT_VERSION,
-            snapshotId: snapshot.snapshotId,
-            sessionId: this.sessionId,
-            revision: snapshot.view.revision,
-            sequence: snapshot.sequence,
-            lifecycle: toLifecycle(snapshot.view.lifecycle),
-            content: snapshot.view.transcript.map(toMessage),
-            activeCommandIds: snapshot.view.activeCommandIds,
-            capabilities: this.capabilities,
-        };
-    }
-    async dispose() { this.#unsubscribe(); this.#listeners.clear(); await this.adapter.dispose(); this.lifecycle = "stopped"; }
-}
-function toOwnedCommand(command) {
-    const base = { correlationId: command.commandId, sessionId: command.sessionId };
-    if (command.type === "replace-session")
-        return command.source.kind === "new" ? { ...base, type: "new-session" } : { ...base, type: "resume-session", sessionPath: command.source.sessionPath };
-    if (command.type === "prompt" || command.type === "steer" || command.type === "follow-up")
-        return { ...base, type: command.type, text: command.text };
-    return { ...base, type: command.type };
-}
-function convertEvent(event) {
-    const base = { contractVersion: AGENT_ENGINE_CONTRACT_VERSION, sessionId: event.sessionId, sequence: event.sequence };
-    if (event.type === "session-lifecycle")
-        return { ...base, type: "lifecycle", lifecycle: toLifecycle(event.lifecycle), reason: event.reason };
-    if (event.type === "transcript-block")
-        return { ...base, type: "content", content: toMessage(event.block) };
-    if (event.type === "command-outcome")
-        return { ...base, type: "command-outcome", commandId: event.correlationId, outcome: event.outcome === "timed-out" ? "failed" : event.outcome, diagnostic: event.diagnostic };
-    if (event.type === "diagnostic")
-        return { ...base, type: "diagnostic", code: event.diagnostic.code, message: event.diagnostic.message, recoverable: event.diagnostic.recoverable };
-    if (event.type === "session-view")
-        return { ...base, type: "snapshot-invalidated", expectedRevision: event.view.revision };
-    return null;
-}
-function toLifecycle(lifecycle) {
-    return lifecycle === "suspended" ? "ready" : lifecycle;
-}
-function toMessage(block) {
-    const role = block.kind === "user" ? "user" : block.kind === "system" ? "system" : block.kind === "tool-call" || block.kind === "tool-result" ? "tool" : "assistant";
-    return { id: block.id, role, status: block.status === "live" ? "streaming" : "final", content: [{ kind: "text", text: block.text }] };
-}
-/**
- * Registers the A1-owned screens and adapts the app host to the shell's route
- * seam. The shell mounts whatever surface it is handed and forwards keys; it
- * never learns what an app is.
- */
-export function createOwnedRouteHost(settings) {
-    const registry = new UiAppRegistry();
-    registry.register({ id: SETTINGS_APP_ID, route: SETTINGS_ROUTE, create: () => new SettingsApp(settings) });
-    return {
-        claims: route => registry.forRoute(route) !== null,
-        open: route => {
-            const registration = registry.forRoute(route);
-            if (registration === null)
-                return null;
-            let size = { width: 80, height: 24 };
-            let frame = [];
-            let closed = false;
-            let onRender = () => undefined;
-            let onExit = () => undefined;
-            const host = new UiAppHost({
-                registry,
-                closeOnInterrupt: true,
-                theme: pinnedTheme(),
-                surface: {
-                    size: () => size,
-                    requestRender: () => onRender(),
-                    exit: () => onExit(),
-                    present: lines => {
-                        if (lines === null)
-                            closed = true;
-                        else
-                            frame = lines;
-                    },
-                },
-            });
-            host.open(registration.id);
-            const surface = {
-                id: registration.id,
-                render: (width, height) => {
-                    size = { width, height };
-                    host.render();
-                    return frame.length === height ? frame : [...frame.slice(0, height), ...Array(Math.max(0, height - frame.length)).fill("")];
-                },
-                handleInput: data => host.handleInput(data).consumed,
-                handleMouse: event => host.handleMouse(event).consumed,
-                isClosed: () => closed || !host.isPresenting,
-                close: () => host.close(),
-                onRenderRequested: listener => { onRender = listener; },
-                onExitRequested: listener => { onExit = listener; },
-            };
-            return surface;
-        },
-    };
-}
-/** Maps A1 UI tokens onto the pinned Pi theme so owned screens match the shell. */
-function pinnedTheme() {
-    return {
-        fg: (token, text) => piTheme().fg(token, text),
-        bold: (text) => piTheme().bold(text),
-        // Unpainted, so a list reads against the terminal the reader actually has
-        // rather than against the background the configured theme was built for.
-        plain: (text) => text,
-        // Quiet, and quieter again: the terminal's own faint attribute over the
-        // dimmest colour the theme has.
-        disabled: (text) => faint(piTheme().fg("dim", text)),
-        highlight: (text) => `${text}`,
-        panel: (text) => `${text}`,
-    };
-}

package/dist/src/foundation/lifecycle/paths.d.ts

@@ -1,10 +0,0 @@
-export interface ProductPaths {
-    readonly configDir: string;
-    readonly dataDir: string;
-    readonly runtimeDir: string;
-    readonly databasePath: string;
-    readonly endpoint: string;
-    readonly endpointMetadataPath: string;
-    readonly supervisorLogPath: string;
-}
-export declare function resolveProductPaths(environment?: NodeJS.ProcessEnv, hostPlatform?: NodeJS.Platform, fallbackHome?: string): ProductPaths;

package/dist/src/foundation/supervision/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./main.js";
-export * from "./server.js";
-export { resolveProductPaths, type ProductPaths } from "../lifecycle/index.js";

package/dist/src/foundation/supervision/index.js

@@ -1,3 +0,0 @@
-export * from "./main.js";
-export * from "./server.js";
-export { resolveProductPaths } from "../lifecycle/index.js";

package/dist/src/foundation/supervision/paths.d.ts

@@ -1 +0,0 @@
-export { resolveProductPaths, type ProductPaths } from "../lifecycle/index.js";

package/dist/src/foundation/supervision/paths.js

@@ -1 +0,0 @@
-export { resolveProductPaths } from "../lifecycle/index.js";

package/docs/manual-transparent-checkpoint.md

@@ -1,53 +0,0 @@
-# Manual owned-UI and transparent fallback checkpoint
-
-This checkpoint is user-controlled. Tests and coding agents must not launch or focus a terminal, inject desktop input, resize windows, close applications, or clean up workstation processes.
-
-## Prepare an exact candidate
-
-From the candidate checkout, pack once and install that tarball into a disposable prefix:
-
-```powershell
-npm ci
-npm run build
-npm pack --ignore-scripts --pack-destination artifacts/manual-transparent
-npm install --prefix artifacts/manual-transparent/install --ignore-scripts artifacts/manual-transparent/<exact-tarball>.tgz
-```
-
-Use isolated A1 control state:
-
-```powershell
-$manualRoot = (Resolve-Path "artifacts/manual-transparent").Path
-$env:A1_CONFIG_DIR = "$manualRoot\state\config"
-$env:A1_DATA_DIR = "$manualRoot\state\data"
-$env:A1_RUNTIME_DIR = "$manualRoot\state\runtime"
-$env:A1_DATABASE_PATH = "$manualRoot\state\data\control.sqlite3"
-```
-
-Run the installed candidate yourself:
-
-```powershell
-& "artifacts/manual-transparent/install/node_modules/.bin/a1.cmd"
-```
-
-Test each installed launch form separately: bare `a1` (the owned UI), `a1 pi` (the untouched comparison oracle), and `a1 sandbox` (the unchanged isolated vanilla profile). Confirm that files created through `/settings`, `/login`, sessions, and resource directories remain under the selected profile root. Generic transparent-fallback testing may set `A1_TERMINAL_EXECUTABLE` and a JSON array in `A1_TERMINAL_ARGUMENTS_JSON`.
-
-Physical automation is not part of this repository baseline. Future certification tooling may run only on dedicated disposable workers or VMs with exclusive test desktops, never on this workstation.
-
-## Compare bare A1 with `a1 pi`
-
-Use the same terminal, working directory, dimensions, environment, and equivalent profile resources. Bare A1 and the untouched oracle intentionally use separate profile roots.
-
-- [ ] Startup resources, logo, notices, spacing, editor, and footer match.
-- [ ] Text, Unicode, emoji, styles, cursor, and layout match.
-- [ ] Rapid typing has no visible A1 delay or dropped/duplicated characters.
-- [ ] Ctrl+C, Ctrl+P, arrows, paste, focus, dialogs, mouse, and wheel match.
-- [ ] Selection, copy, clipboard, scrollback, and resize match.
-- [ ] Normal and error exits preserve child output and return a usable parent prompt.
-- [ ] Parent typing, cursor movement, Backspace, Delete, and submission work after exit.
-- [ ] A missing executable reports a concise spawn failure without affecting other applications.
-
-Report failures with direct-versus-A1 behavior, platform/terminal versions, exact command, reproducibility, and optional manually captured evidence.
-
-For recovery, use `a1 pi`; do not use the removed `a1 ui` command. `a1 sandbox` remains profile isolation rather than a security boundary.
-
-Manual acceptance can authorize an exact uncertified npm `next` preview after non-desktop gates pass. It does not certify stable terminal parity or platform support.