@indy2kro/agentenv 1.0.1 → 1.0.2

package/dist/ui/spinner.d.ts

@@ -14,12 +14,24 @@ export interface Spinner {
     stop(): Spinner;
 }
 export type SpinnerFactory = (text: string) => Spinner;
+/** Force the animated spinner on/off; pass undefined to restore auto-detection. Wired to --no-spinner. */
+export declare function setSpinnerEnabled(enabled: boolean | undefined): void;
+/**
+ * Whether to animate: off under TERM=dumb or CI (most CI systems set
+ * CI=true; the animation floods a non-interactive log with redraw frames),
+ * unless --no-spinner/setSpinnerEnabled() overrides either way.
+ */
+export declare function isSpinnerEnabled(): boolean;
 /**
  * Run fn() under a spinner labeled `label`, resolving succeed/fail from the
  * result's `success` field. `-q/--quiet` swaps in a no-op spinner so quiet
- * output is actually silent even on a TTY. `fn` receives the spinner itself
- * so a long inner step can `stop()` it before printing raw output and
- * `start()` it again afterwards.
+ * output is actually silent even on a TTY; `--no-spinner`/TERM=dumb/CI swap
+ * the *real* (ora) spinner for a static, non-animated one that still prints
+ * the label and succeed/fail lines — an explicitly injected `spinnerFactory`
+ * (as every test passes) is never second-guessed by that auto-detection,
+ * since a test double has no animation to disable in the first place. `fn`
+ * receives the spinner itself so a long inner step can `stop()` it before
+ * printing raw output and `start()` it again afterwards.
  */
 export declare function withSpinner<T extends {
     success: boolean;

package/dist/ui/spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,OAAO;IACtB,KAAK,IAAI,OAAO,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,kNAAkN;IAClN,IAAI,IAAI,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAWvD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,cAAc,GAAE,cAAsC,GACrD,OAAO,CAAC,CAAC,CAAC,CAYZ"}
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,OAAO;IACtB,KAAK,IAAI,OAAO,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,kNAAkN;IAClN,IAAI,IAAI,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAiCvD,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,cAAc,GAAE,cAAsC,GACrD,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/dist/ui/spinner.js

@@ -8,6 +8,7 @@
  */
 import ora from 'ora';
 import { isQuiet } from './output.js';
+import { colorizeLine, failGlyph, successGlyph } from './theme.js';
 const defaultSpinnerFactory = (text) => ora(text);
 const quietSpinner = {
     start: () => quietSpinner,
@@ -15,15 +16,62 @@ const quietSpinner = {
     fail: () => quietSpinner,
     stop: () => quietSpinner,
 };
+/** A non-animated stand-in: prints the label once, then a plain succeed/fail line — no redrawing. */
+function staticSpinner(label) {
+    const spinner = {
+        start: () => {
+            console.log(label);
+            return spinner;
+        },
+        succeed: (text) => {
+            console.log(colorizeLine(`${successGlyph()} ${text ?? label}`));
+            return spinner;
+        },
+        fail: (text) => {
+            console.log(colorizeLine(`${failGlyph()} ${text ?? label}`));
+            return spinner;
+        },
+        stop: () => spinner,
+    };
+    return spinner;
+}
+let spinnerOverride;
+/** Force the animated spinner on/off; pass undefined to restore auto-detection. Wired to --no-spinner. */
+export function setSpinnerEnabled(enabled) {
+    spinnerOverride = enabled;
+}
+/**
+ * Whether to animate: off under TERM=dumb or CI (most CI systems set
+ * CI=true; the animation floods a non-interactive log with redraw frames),
+ * unless --no-spinner/setSpinnerEnabled() overrides either way.
+ */
+export function isSpinnerEnabled() {
+    if (spinnerOverride !== undefined)
+        return spinnerOverride;
+    return process.env.TERM !== 'dumb' && !process.env.CI;
+}
 /**
  * Run fn() under a spinner labeled `label`, resolving succeed/fail from the
  * result's `success` field. `-q/--quiet` swaps in a no-op spinner so quiet
- * output is actually silent even on a TTY. `fn` receives the spinner itself
- * so a long inner step can `stop()` it before printing raw output and
- * `start()` it again afterwards.
+ * output is actually silent even on a TTY; `--no-spinner`/TERM=dumb/CI swap
+ * the *real* (ora) spinner for a static, non-animated one that still prints
+ * the label and succeed/fail lines — an explicitly injected `spinnerFactory`
+ * (as every test passes) is never second-guessed by that auto-detection,
+ * since a test double has no animation to disable in the first place. `fn`
+ * receives the spinner itself so a long inner step can `stop()` it before
+ * printing raw output and `start()` it again afterwards.
  */
 export async function withSpinner(label, fn, spinnerFactory = defaultSpinnerFactory) {
-    const factory = isQuiet() ? () => quietSpinner : spinnerFactory;
+    let factory;
+    if (isQuiet()) {
+        factory = () => quietSpinner;
+    }
+    else if (spinnerFactory === defaultSpinnerFactory && !isSpinnerEnabled()) {
+        factory = staticSpinner;
+    }
+    else {
+        factory = spinnerFactory;
+    }
     const spinner = factory(label).start();
     try {
         const result = await fn(spinner);

package/dist/ui/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAYtC,MAAM,qBAAqB,GAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAuB,CAAC;AAExF,MAAM,YAAY,GAAY;IAC5B,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY;IACzB,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY;IAC3B,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY;IACxB,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,EAAoC,EACpC,iBAAiC,qBAAqB;IAEtD,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,GAAY,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;YACtC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAYnE,MAAM,qBAAqB,GAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAuB,CAAC;AAExF,MAAM,YAAY,GAAY;IAC5B,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY;IACzB,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY;IAC3B,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY;IACxB,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY;CACzB,CAAC;AAEF,qGAAqG;AACrG,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,GAAG,EAAE;YACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,YAAY,EAAE,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAC7D,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;KACpB,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,IAAI,eAAoC,CAAC;AAEzC,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,eAAe,GAAG,OAAO,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC;IAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,EAAoC,EACpC,iBAAiC,qBAAqB;IAEtD,IAAI,OAAuB,CAAC;IAC5B,IAAI,OAAO,EAAE,EAAE,CAAC;QACd,OAAO,GAAG,GAAY,EAAE,CAAC,YAAY,CAAC;IACxC,CAAC;SAAM,IAAI,cAAc,KAAK,qBAAqB,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC3E,OAAO,GAAG,aAAa,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,cAAc,CAAC;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;YACtC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/ui/theme.d.ts

@@ -12,11 +12,37 @@ export declare const theme: {
     fail: (text: string) => string;
     warn: (text: string) => string;
 };
+export interface AsciiDetectionEnv {
+    /** Overrides process.env.AGENTENV_ASCII ("1"/"true" forces ASCII, "0"/"false" forces Unicode). */
+    forceAscii?: string;
+    term?: string;
+    platform?: NodeJS.Platform;
+    getWindowsCodePage?: () => number | undefined;
+}
+/**
+ * True when the console likely can't render ✓/✗/✅/⚠️/❌ reliably: an explicit
+ * AGENTENV_ASCII override, TERM=dumb, or (on Windows) an active code page
+ * other than 65001 (UTF-8) — legacy `conhost` defaults to the OS locale's
+ * code page (437 on a US system), which renders these as mojibake.
+ */
+export declare function useAsciiGlyphs(env?: AsciiDetectionEnv): boolean;
+/** useAsciiGlyphs() for the real process environment, probed once per process and cached. */
+export declare function asciiGlyphsEnabled(): boolean;
+/** Test-only: clear the cached ascii-mode detection so a new environment can be probed. */
+export declare function resetAsciiGlyphsCache(): void;
+/** The glyph agentenv prints for a passing/configured check. */
+export declare function successGlyph(): string;
+/** The glyph agentenv prints for a failing/missing check. */
+export declare function failGlyph(): string;
+/** The glyph agentenv prints for a tool/agent this platform doesn't support. */
+export declare function unsupportedGlyph(): string;
+export declare const DRIFT_GLYPH = "!";
 /**
  * Colorize a pre-formatted message line by its leading status glyph (or a
  * "warning:" substring), so command output built elsewhere in the pipeline
  * (mise, adapters, integrations) gets consistent coloring without every
- * producer needing to know about chalk.
+ * producer needing to know about chalk. Recognizes both the Unicode and
+ * ASCII-fallback glyph forms, regardless of which mode produced the line.
  */
 export declare function colorizeLine(line: string): string;
 //# sourceMappingURL=theme.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED,eAAO,MAAM,KAAK;oBACA,MAAM;iBACT,MAAM;gBACP,MAAM;eACP,MAAM;iBACJ,MAAM;iBACN,MAAM;CACpB,CAAC;AAOF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED,eAAO,MAAM,KAAK;oBACA,MAAM;iBACT,MAAM;gBACP,MAAM;eACP,MAAM;iBACJ,MAAM;iBACN,MAAM;CACpB,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC/C;AAiBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,iBAAsB,GAAG,OAAO,CAanE;AAID,6FAA6F;AAC7F,wBAAgB,kBAAkB,IAAI,OAAO,CAG5C;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAGD,eAAO,MAAM,WAAW,MAAM,CAAC;AAK/B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBjD"}

package/dist/ui/theme.js

@@ -4,6 +4,7 @@
  * is the only override this CLI needs (wired to --no-color in index.ts).
  */
 import chalk from 'chalk';
+import { execFileSync } from 'child_process';
 export function setColorEnabled(enabled) {
     if (!enabled)
         chalk.level = 0;
@@ -16,27 +17,91 @@ export const theme = {
     fail: (text) => chalk.red(text),
     warn: (text) => chalk.yellow(text),
 };
-const SUCCESS_GLYPH = '✓';
-const FAIL_GLYPH = '✗';
-const DRIFT_GLYPH = '!';
-const UNSUPPORTED_GLYPH = '·';
+/** The active Windows console code page (e.g. 437, 65001), or undefined if `chcp` can't be read. */
+function detectWindowsCodePage() {
+    try {
+        const output = execFileSync('chcp.com', [], {
+            encoding: 'utf8',
+            timeout: 1000,
+            windowsHide: true,
+        });
+        const match = /(\d+)/.exec(output);
+        return match ? Number(match[1]) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * True when the console likely can't render ✓/✗/✅/⚠️/❌ reliably: an explicit
+ * AGENTENV_ASCII override, TERM=dumb, or (on Windows) an active code page
+ * other than 65001 (UTF-8) — legacy `conhost` defaults to the OS locale's
+ * code page (437 on a US system), which renders these as mojibake.
+ */
+export function useAsciiGlyphs(env = {}) {
+    const forceAscii = env.forceAscii ?? process.env.AGENTENV_ASCII;
+    if (forceAscii === '1' || forceAscii === 'true')
+        return true;
+    if (forceAscii === '0' || forceAscii === 'false')
+        return false;
+    if ((env.term ?? process.env.TERM) === 'dumb')
+        return true;
+    if ((env.platform ?? process.platform) === 'win32') {
+        const codePage = (env.getWindowsCodePage ?? detectWindowsCodePage)();
+        if (codePage !== undefined && codePage !== 65001)
+            return true;
+    }
+    return false;
+}
+let cachedAsciiGlyphs;
+/** useAsciiGlyphs() for the real process environment, probed once per process and cached. */
+export function asciiGlyphsEnabled() {
+    if (cachedAsciiGlyphs === undefined)
+        cachedAsciiGlyphs = useAsciiGlyphs();
+    return cachedAsciiGlyphs;
+}
+/** Test-only: clear the cached ascii-mode detection so a new environment can be probed. */
+export function resetAsciiGlyphsCache() {
+    cachedAsciiGlyphs = undefined;
+}
+/** The glyph agentenv prints for a passing/configured check. */
+export function successGlyph() {
+    return asciiGlyphsEnabled() ? '[ok]' : '✓';
+}
+/** The glyph agentenv prints for a failing/missing check. */
+export function failGlyph() {
+    return asciiGlyphsEnabled() ? '[FAIL]' : '✗';
+}
+/** The glyph agentenv prints for a tool/agent this platform doesn't support. */
+export function unsupportedGlyph() {
+    return asciiGlyphsEnabled() ? '[-]' : '·';
+}
+// Already ASCII-safe; kept as a named export so callers don't hardcode '!'.
+export const DRIFT_GLYPH = '!';
+const UNICODE_GLYPHS = { success: '✓', fail: '✗', unsupported: '·' };
+const ASCII_GLYPHS = { success: '[ok]', fail: '[FAIL]', unsupported: '[-]' };
 /**
  * Colorize a pre-formatted message line by its leading status glyph (or a
  * "warning:" substring), so command output built elsewhere in the pipeline
  * (mise, adapters, integrations) gets consistent coloring without every
- * producer needing to know about chalk.
+ * producer needing to know about chalk. Recognizes both the Unicode and
+ * ASCII-fallback glyph forms, regardless of which mode produced the line.
  */
 export function colorizeLine(line) {
     const trimmed = line.trimStart();
-    if (trimmed.startsWith(SUCCESS_GLYPH))
+    if (trimmed.startsWith(UNICODE_GLYPHS.success) || trimmed.startsWith(ASCII_GLYPHS.success)) {
         return theme.ok(line);
-    if (trimmed.startsWith(FAIL_GLYPH))
+    }
+    if (trimmed.startsWith(UNICODE_GLYPHS.fail) || trimmed.startsWith(ASCII_GLYPHS.fail)) {
         return theme.fail(line);
+    }
     if (trimmed.startsWith(DRIFT_GLYPH) || line.toLowerCase().includes('warning:')) {
         return theme.warn(line);
     }
-    if (trimmed.startsWith(UNSUPPORTED_GLYPH))
+    if (trimmed.startsWith(UNICODE_GLYPHS.unsupported) ||
+        trimmed.startsWith(ASCII_GLYPHS.unsupported)) {
         return theme.dim(line);
+    }
     return line;
 }
 //# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,IAAI,CAAC,OAAO;QAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAChD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACtC,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;CAC3C,CAAC;AAEF,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"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"}

package/dist/utils/fs-retry.d.ts

@@ -33,6 +33,22 @@ export declare function isRetryableWriteError(err: unknown): boolean;
  * (EBUSY/EPERM). Throws when the write ultimately cannot succeed.
  */
 export declare function writeFileWithRetry(filePath: string, content: string, opts?: WriteRetryOptions, fsImpl?: RetryFs): void;
+/**
+ * Back up `filePath`'s current content to `<filePath>.agentenv-backup` the
+ * first time agentenv is about to modify a file it did not create — a
+ * user-global file like ~/.claude/settings.json or a pre-existing user-scope
+ * CLAUDE.md/AGENTS.md. Tier 0's shell-fix writes to these same kinds of
+ * files already have an undo path (shell-fix-state.json); the adapters'
+ * writes did not.
+ *
+ * Never overwrites an existing backup — once one exists it holds the user's
+ * true pre-agentenv content, and a later call (a second `apply`) must not
+ * clobber it with agentenv's own already-modified content. A no-op when
+ * `filePath` doesn't exist yet (nothing to back up: this is a fresh file
+ * agentenv is creating, not modifying). Backing up is advisory: a failure
+ * here (e.g. a locked filesystem) must never block the real write.
+ */
+export declare function backupBeforeFirstEdit(filePath: string): void;
 export interface WriteVerifyResult {
     success: boolean;
     message: string;

package/dist/utils/fs-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-retry.d.ts","sourceRoot":"","sources":["../../src/utils/fs-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,eAAO,MAAM,cAAc,EAAE,OAS5B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK3D;AAOD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,EAC5B,MAAM,GAAE,OAAwB,GAC/B,IAAI,CAcN;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,EAC5B,MAAM,GAAE,OAAwB,GAC/B,iBAAiB,CAwBnB"}
+{"version":3,"file":"fs-retry.d.ts","sourceRoot":"","sources":["../../src/utils/fs-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,eAAO,MAAM,cAAc,EAAE,OAS5B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK3D;AAOD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,EAC5B,MAAM,GAAE,OAAwB,GAC/B,IAAI,CAcN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS5D;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,EAC5B,MAAM,GAAE,OAAwB,GAC/B,iBAAiB,CAwBnB"}

package/dist/utils/fs-retry.js

@@ -61,6 +61,34 @@ export function writeFileWithRetry(filePath, content, opts = {}, fsImpl = defaul
         }
     }
 }
+/**
+ * Back up `filePath`'s current content to `<filePath>.agentenv-backup` the
+ * first time agentenv is about to modify a file it did not create — a
+ * user-global file like ~/.claude/settings.json or a pre-existing user-scope
+ * CLAUDE.md/AGENTS.md. Tier 0's shell-fix writes to these same kinds of
+ * files already have an undo path (shell-fix-state.json); the adapters'
+ * writes did not.
+ *
+ * Never overwrites an existing backup — once one exists it holds the user's
+ * true pre-agentenv content, and a later call (a second `apply`) must not
+ * clobber it with agentenv's own already-modified content. A no-op when
+ * `filePath` doesn't exist yet (nothing to back up: this is a fresh file
+ * agentenv is creating, not modifying). Backing up is advisory: a failure
+ * here (e.g. a locked filesystem) must never block the real write.
+ */
+export function backupBeforeFirstEdit(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return;
+        const backupPath = `${filePath}.agentenv-backup`;
+        if (fs.existsSync(backupPath))
+            return;
+        fs.copyFileSync(filePath, backupPath);
+    }
+    catch {
+        // Advisory only — never block the real write on a failed backup.
+    }
+}
 /**
  * Write `content` and confirm it persisted: the file must exist after the
  * write, and, for non-empty content, be non-empty. Any mismatch is reported as

package/dist/utils/fs-retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-retry.js","sourceRoot":"","sources":["../../src/utils/fs-retry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs-retry.js","sourceRoot":"","sources":["../../src/utils/fs-retry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indy2kro/agentenv",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "CLI for configuring a consistent, capable shell environment for AI coding agents",
   "type": "module",
   "main": "dist/index.js",
@@ -27,6 +27,7 @@
     "start": "ts-node src/index.ts",
     "dev": "ts-node-dev src/index.ts",
     "test": "npm run build && cd dist && node --test",
+    "test:coverage": "npm run build && cd dist && node --experimental-test-coverage --test-coverage-lines=80 --test-coverage-branches=75 --test-coverage-functions=80 --test",
     "smoke": "npm run build && node scripts/smoke.mjs",
     "smoke:real": "npm run build && node scripts/smoke.mjs --real",
     "lint": "eslint src --max-warnings 0",