@timurproko/a1 0.1.8-dev.182 → 0.1.8-dev.218

package/bin/cli.js

@@ -5,7 +5,7 @@ const { fileURLToPath } = await import("node:url");
 const { readFile } = await import("node:fs/promises");
 const { cliCapabilities, dispatchCli } = await import("../dist/cli/index.js");
 
-// Which commands this build exposes follows from the build's own version, so a
+// Compatibility: which commands this build exposes follows from the build's own version, so a
 // released a1 cannot be argued into offering the development profiles.
 const capabilities = cliCapabilities(JSON.parse(await readFile(new URL("package.json", packageRoot), "utf8")).version);
 
@@ -16,7 +16,7 @@ process.exitCode = await dispatchCli(process.argv.slice(2), {
       import("../dist/foundation/release/index.js"),
       import("./module-identity.js"),
     ]);
-    // Self-heal the installed tree before the release store copies it: npm 12
+    // Compatibility: self-heal the installed tree before the release store copies it: npm 12
     // blocks install scripts by default, so the postinstall that normally
     // repairs module identity may never have run (see bin/module-identity.js).
     const packageRootPath = fileURLToPath(packageRoot);

package/bin/sync-pi-tui-proxy.js

@@ -35,7 +35,7 @@ const RE_EXPORT_LINE = /^export \* from "[^"]+";$/m;
  * pinned Pi resolves. Returns a discriminated outcome; never throws.
  */
 export function syncPiTuiProxy(packageRoot) {
-  // resolvePinnedPiTui answers with a canonical real path, so the directory the
+  // Platform: resolvePinnedPiTui answers with a canonical real path, so the directory the
   // relative specifier is computed from must be canonical too (Windows short
   // names, symlinked installs).
   const canonicalRoot = canonical(packageRoot);

package/bin/ui.js

@@ -3,7 +3,7 @@
 const { assertSinglePiTuiModuleAtLaunch } = await import("./module-identity.js");
 const { fileURLToPath } = await import("node:url");
 
-// Before the composition loads pinned Pi's terminal stack: confirm A1 and Pi
+// Compatibility: before the composition loads pinned Pi's terminal stack: confirm A1 and Pi
 // resolve it to the same copy, so extensions and the owned UI share one module
 // identity (see bin/module-identity.js for the full story). Nothing is repaired
 // here — A1's package manifest decides which copy wins, and this only reports

package/dist/cli/dispatch.js

@@ -85,7 +85,7 @@ export function parseCliCommand(arguments_, capabilities) {
         return parseUpdate(rest);
     if (command?.startsWith("update:"))
         return { kind: "noop" };
-    // Unsupported and reserved command spaces are deliberately quiet. Help is
+    // Rationale: unsupported and reserved command spaces are deliberately quiet. Help is
     // explicit, and a typo must never start an interactive or maintenance path.
     return { kind: "noop" };
 }
@@ -98,7 +98,7 @@ function parseUpdate(rest) {
     if (rest.length === 0)
         return { kind: "update", channel: "stable" };
     const [selector, ...values] = rest;
-    // Removed compatibility notation is unsupported rather than deprecated.
+    // Compatibility: removed notation is unsupported rather than deprecated.
     if (selector === "self")
         return { kind: "noop" };
     if (selector === "--develop") {
@@ -121,7 +121,7 @@ function parseUpdate(rest) {
         return pinnedPiUpdateError();
     if (selector !== undefined && selector.startsWith("-"))
         return unknownOption(selector, "update");
-    // Positional update targets are reserved for a future A1-native plugin model.
+    // Rationale: positional update targets are reserved for a future A1-native plugin model.
     return { kind: "noop" };
 }
 function isDevelopmentTarget(target) {

package/dist/cli/packages.js

@@ -40,7 +40,7 @@ async function runVerb(port, request) {
     return request.verb === "install" ? await port.install(request.source) : await port.remove(request.source);
 }
 export function renderPackageOutcome(outcome, profileRoot, style = chalk) {
-    // Model refresh remains an A1 top-level command. The `a1 pi` compatibility
+    // Compatibility: model refresh remains an A1 top-level command. The `a1 pi` compatibility
     // transcript applies to package operations only.
     if (outcome.operation === "refresh-models") {
         if (outcome.status === "failed") {

package/dist/cli/version-stats.js

@@ -20,7 +20,7 @@ export async function runVersionStats(options) {
         output.stderr(`${PRODUCT_TEXT.diagnostic(`could not read its installed version: ${message(error)}`)}\n`);
         return 1;
     }
-    // Match Pi's release behavior: stable builds print only their installed version.
+    // Compatibility: match Pi's release behavior: stable builds print only their installed version.
     // Development builds retain channel visibility for preview comparison and updates.
     if (prerelease(installed) === null) {
         output.stdout(`${installed}\n`);
@@ -32,7 +32,7 @@ export async function runVersionStats(options) {
         output.stderr(`${PRODUCT_TEXT.diagnostic(`could not resolve npm dist-tags: ${remote.error}`)}\n`);
     return 0;
 }
-// npm view respects the user's .npmrc registry and proxy, so it stays primary; the direct
+// Rationale: npm view respects the user's .npmrc registry and proxy, so it stays primary; the direct
 // registry fetch below covers npm CLI versions whose --json output shape we cannot parse.
 async function queryDistTags(runner, fetcher) {
     const fromNpm = await queryDistTagsViaNpm(runner);
@@ -55,7 +55,7 @@ async function queryDistTagsViaNpm(runner) {
         return unavailable(`npm exited with status ${result.code ?? "unknown"}`);
     try {
         const parsed = JSON.parse(result.stdout);
-        // npm 12 wraps `npm view <pkg> dist-tags --json` output in a one-element array; older npm returns the bare object.
+        // Compatibility: npm 12 wraps `npm view <pkg> dist-tags --json` output in a one-element array; older npm returns the bare object.
         const metadata = Array.isArray(parsed) && parsed.length === 1 ? parsed[0] : parsed;
         return parseDistTags(metadata, "npm");
     }

package/dist/composition/owned-ui.js

@@ -26,7 +26,7 @@ export async function composeOwnedUi(options = {}) {
             store: new OwnedUiSettingsStore({ configDir: resolveProductPaths().configDir, profileId: options.profileId }),
             agentProvider: () => adapter.settingsPort(),
         });
-    // Bare A1 intentionally ships one visual target while its UI is being completed:
+    // Compatibility: bare A1 intentionally ships one visual target while its UI is being completed:
     // dark, regardless of terminal detection or a previously stored Pi theme. The
     // comparison profile keeps Pi's configured theme behavior and settings surface.
     applyConfiguredPiTheme(ownedSurfaces ? "dark" : adapter.configuredTheme());

package/dist/composition/settings-route-host.js

@@ -61,13 +61,15 @@ 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
+        // Rationale: 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
+        // Rationale: 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}`,
+        // Rationale: physical review requires the shared value menu to read as a floating
+        // product surface instead of blending into the settings rows behind it.
+        highlight: (text) => `\u001b[48;2;82;82;82m\u001b[97m${text}\u001b[39m\u001b[49m`,
+        panel: (text) => `\u001b[48;2;55;55;55m${text}\u001b[49m`,
     };
 }

package/dist/features/launch/development-launch.js

@@ -12,7 +12,7 @@ export function resolveDevelopmentLaunchEnvironment(canonicalPackageRoot, releas
     const selectedDevelopmentRoot = source[PRODUCT_IDENTITY.environment.developmentRoot];
     const developmentRoot = resolve(selectedDevelopmentRoot
         ?? join(checkoutRoot, releaseId, "instances", instanceId));
-    // Runtime/data remain instance-isolated, but product settings are user
+    // Rationale: runtime/data remain instance-isolated, but product settings are user
     // preferences and must survive a fresh local launch (and a rebuilt candidate).
     // An explicit development root retains its historical self-contained policy.
     const persistentConfigDir = selectedDevelopmentRoot

package/dist/features/owned-ui/customization.d.ts

@@ -12,6 +12,7 @@ export interface OwnedCommandHandlerContext {
     readonly correlationId: string;
 }
 export type OwnedCommandHandler = (context: OwnedCommandHandlerContext) => OwnedUiCommand | Promise<OwnedUiCommand>;
+/** Registers owned UI commands and assigns a monotonic correlation identifier to each dispatch. */
 export declare class OwnedCommandSurface {
     #private;
     register(name: string, handler: OwnedCommandHandler): () => void;
@@ -22,6 +23,7 @@ export interface ResolvedOwnedUiSlot {
     readonly customization: OwnedUiCustomization;
     readonly implementation: OwnedUiSlotImplementation;
 }
+/** Resolves one customization per slot by precedence and version while preserving registration identity. */
 export declare class OwnedUiCustomizationRegistry {
     #private;
     register(customization: OwnedUiCustomization, implementation: OwnedUiSlotImplementation): () => void;

package/dist/features/owned-ui/customization.js

@@ -1,4 +1,5 @@
 import { assertOwnedUiCustomization, } from "../../contracts/owned-ui/index.js";
+/** Registers owned UI commands and assigns a monotonic correlation identifier to each dispatch. */
 export class OwnedCommandSurface {
     #handlers = new Map();
     #sequence = 0;
@@ -17,6 +18,7 @@ export class OwnedCommandSurface {
         return handler({ sessionId, correlationId: `ui-command-${this.#sequence}` });
     }
 }
+/** Resolves one customization per slot by precedence and version while preserving registration identity. */
 export class OwnedUiCustomizationRegistry {
     #registrations = new Map();
     register(customization, implementation) {

package/dist/features/owned-ui/diagnostics.d.ts

@@ -17,6 +17,7 @@ export interface OwnedUiDiagnosticsSnapshot {
     readonly resources: OwnedUiResourceObservation | null;
     readonly terminalRestorationFailed: boolean;
 }
+/** Retains bounded, redacted UI diagnostics together with frame and resource observations. */
 export declare class OwnedUiDiagnosticsRecorder {
     #private;
     readonly maximumEntries: number;

package/dist/features/owned-ui/diagnostics.js

@@ -1,3 +1,4 @@
+/** Retains bounded, redacted UI diagnostics together with frame and resource observations. */
 export class OwnedUiDiagnosticsRecorder {
     maximumEntries;
     #entries = [];

package/dist/features/owned-ui/project-trust-prompt.d.ts

@@ -4,17 +4,22 @@ export interface OwnedProjectTrustPromptRequest {
     readonly defaultDecision: "ask" | "always" | "never";
 }
 export type OwnedProjectTrustPrompt = (request: OwnedProjectTrustPromptRequest) => Promise<boolean | null>;
+interface RawTtyInput extends Readable {
+    readonly isTTY?: boolean;
+    readonly isRaw?: boolean;
+    setRawMode?(enabled: boolean): this;
+}
 export interface ConsoleProjectTrustPromptOptions {
-    readonly input?: Readable & {
-        readonly isTTY?: boolean;
-    };
+    readonly input?: RawTtyInput;
     readonly output?: Writable & {
         readonly isTTY?: boolean;
+        readonly columns?: number;
     };
 }
 /**
- * Minimal pre-session surface. It depends only on the parent terminal and fixed
- * A1 wording, so no project setting, theme, extension, prompt, or skill can
- * execute before the decision.
+ * Pre-resource startup selector. It uses only fixed product wording and terminal
+ * controls: no project setting, theme, extension, prompt, package, or skill is
+ * consulted before the trust result exists.
  */
 export declare function createConsoleProjectTrustPrompt(options?: ConsoleProjectTrustPromptOptions): OwnedProjectTrustPrompt;
+export {};

package/dist/features/owned-ui/project-trust-prompt.js

@@ -1,8 +1,18 @@
-import { createInterface } from "node:readline/promises";
+const ENTER_ALTERNATE_SCREEN = "\u001b[?1049h";
+const LEAVE_ALTERNATE_SCREEN = "\u001b[?1049l";
+const HIDE_CURSOR = "\u001b[?25l";
+const SHOW_CURSOR = "\u001b[?25h";
+const CLEAR_HOME = "\u001b[2J\u001b[H";
+const ACCENT = "\u001b[38;2;138;190;183m";
+const MUTED = "\u001b[38;2;128;128;128m";
+const DIM = "\u001b[38;2;102;102;102m";
+const RESET_FG = "\u001b[39m";
+const BOLD = "\u001b[1m";
+const RESET_BOLD = "\u001b[22m";
 /**
- * Minimal pre-session surface. It depends only on the parent terminal and fixed
- * A1 wording, so no project setting, theme, extension, prompt, or skill can
- * execute before the decision.
+ * Pre-resource startup selector. It uses only fixed product wording and terminal
+ * controls: no project setting, theme, extension, prompt, package, or skill is
+ * consulted before the trust result exists.
  */
 export function createConsoleProjectTrustPrompt(options = {}) {
     const input = options.input ?? process.stdin;
@@ -11,22 +21,129 @@ export function createConsoleProjectTrustPrompt(options = {}) {
         if (input.isTTY !== true || output.isTTY !== true) {
             throw new Error("an interactive terminal is unavailable");
         }
-        const reader = createInterface({ input, output, terminal: true });
+        const wasRaw = input.isRaw === true;
+        let selected = 0;
+        let restored = false;
+        const restore = () => {
+            if (restored)
+                return;
+            restored = true;
+            input.setRawMode?.(wasRaw);
+            output.write(`${CLEAR_HOME}${SHOW_CURSOR}${LEAVE_ALTERNATE_SCREEN}`);
+        };
+        const render = () => {
+            const width = Math.max(20, output.columns ?? 80);
+            const lines = [
+                `${BOLD}${ACCENT}Trust project folder?${RESET_FG}${RESET_BOLD}`,
+                cwd,
+                "",
+                "This allows A1 to load project settings and resources, install missing project packages, and execute project extensions.",
+                "",
+                optionRow("Trust", selected === 0),
+                optionRow("Do not trust", selected === 1),
+                "",
+                `${DIM}  ↑/↓ to navigate · Enter to select · Esc to cancel${RESET_FG}`,
+            ];
+            output.write(`${CLEAR_HOME}${lines.map(line => clipAnsiSafe(line, width)).join("\n")}`);
+        };
         try {
-            output.write(`\nA1 found project-local settings or executable resources in:\n${cwd}\n`);
-            output.write("Trusting permits project settings, skills, prompts, packages, themes, and extensions to load.\n");
-            for (let attempt = 0; attempt < 3; attempt += 1) {
-                const answer = (await reader.question("Trust this project for this and future launches? [y/N] ")).trim().toLowerCase();
-                if (answer === "y" || answer === "yes")
-                    return true;
-                if (answer === "" || answer === "n" || answer === "no")
-                    return false;
-                output.write("Enter y or n.\n");
-            }
-            return null;
+            output.write(`${ENTER_ALTERNATE_SCREEN}${HIDE_CURSOR}`);
+            input.setRawMode?.(true);
+            render();
+            return await new Promise((resolve, reject) => {
+                let settled = false;
+                const finish = (value) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    cleanup();
+                    restore();
+                    resolve(value);
+                };
+                const fail = (error) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    cleanup();
+                    restore();
+                    reject(error);
+                };
+                const onData = (chunk) => {
+                    const data = chunk.toString();
+                    for (let index = 0; index < data.length;) {
+                        if (data.startsWith("\u001b[A", index)) {
+                            selected = 0;
+                            index += 3;
+                            render();
+                            continue;
+                        }
+                        if (data.startsWith("\u001b[B", index) || data[index] === "\t") {
+                            selected = selected === 0 ? 1 : 0;
+                            index += data[index] === "\t" ? 1 : 3;
+                            render();
+                            continue;
+                        }
+                        const key = data[index] ?? "";
+                        index += 1;
+                        if (key === "\r" || key === "\n") {
+                            finish(selected === 0);
+                            return;
+                        }
+                        if (key === "\u001b" || key === "\u0003") {
+                            finish(null);
+                            return;
+                        }
+                        // Compatibility: retain y/n aliases for terminals or automation that cannot send
+                        // navigation keys; the visible interaction remains selector-first.
+                        if (key === "y" || key === "Y") {
+                            finish(true);
+                            return;
+                        }
+                        if (key === "n" || key === "N") {
+                            finish(false);
+                            return;
+                        }
+                    }
+                };
+                const onEnd = () => finish(null);
+                const onError = (error) => fail(error);
+                const cleanup = () => {
+                    input.off("data", onData);
+                    input.off("end", onEnd);
+                    input.off("error", onError);
+                };
+                input.on("data", onData);
+                input.once("end", onEnd);
+                input.once("error", onError);
+                input.resume();
+            });
         }
         finally {
-            reader.close();
+            restore();
         }
     };
 }
+function optionRow(label, selected) {
+    return selected
+        ? `${ACCENT}→ ${label}${RESET_FG}`
+        : `  ${label}`;
+}
+/** Avoid replaying or manufacturing control payloads while keeping fixed SGR. */
+function clipAnsiSafe(line, width) {
+    let visible = 0;
+    let output = "";
+    for (let index = 0; index < line.length && visible < width;) {
+        if (line[index] === "\u001b") {
+            const match = line.slice(index).match(/^\u001b\[[0-9;:]*m/);
+            if (match !== null) {
+                output += match[0];
+                index += match[0].length;
+                continue;
+            }
+        }
+        output += line[index];
+        index += 1;
+        visible += 1;
+    }
+    return `${output}${RESET_FG}${RESET_BOLD}`;
+}