@indy2kro/agentenv 0.3.0 → 0.3.2

package/dist/ui/report.d.ts

@@ -0,0 +1,35 @@
+import type { ResultSeverity } from './output.js';
+/**
+ * Minimal shape of a `validateConfig` result, so this module never needs to
+ * depend on the schema layer.
+ */
+export interface ValidationReportView {
+    errors: string[];
+    warnings: string[];
+}
+/** The one config-path line every mutating command prints after resolving its file. */
+export declare function printConfigPath(configPath: string): void;
+/** Warnings + errors in the shared `warning:` / `error:` shape (colored). */
+export declare function printValidation(report: ValidationReportView): void;
+/**
+ * Shared validation gate: print warnings/errors, and when invalid print the
+ * given "not applying" line and return false. Callers set the exit code.
+ */
+export declare function reportValidation(report: ValidationReportView, notApplying: string): boolean;
+/** Apply/setup result tail: colorized messages, then themed errors. */
+export declare function printMessages(messages: string[], errors: string[]): void;
+/**
+ * Human duration for the end-of-run line: sub-second in whole milliseconds,
+ * otherwise seconds to one decimal (or `Xm Ys` past a minute). Non-finite and
+ * negative inputs clamp to `0ms` so callers never print `NaN`.
+ */
+export declare function formatDuration(ms: number): string;
+/** End-of-run timing phrase: `failed in …` for a fail outcome, else `finished in …`. */
+export declare function timingPhrase(severity: ResultSeverity, ms: number): string;
+/**
+ * Shared result-box line, gated by TTY/quiet exactly like every other result.
+ * When `elapsedMs` is given, a timing line is appended (always printed, so a
+ * piped/CI run still records how long the command took).
+ */
+export declare function printResult(severity: ResultSeverity, headline: string, summary?: string, elapsedMs?: number): void;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/ui/report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAGlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAO3F;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAGxE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAKN"}

package/dist/ui/report.js

@@ -0,0 +1,64 @@
+import { colorizeLine, theme } from './theme.js';
+import { resolveResultLine } from './output.js';
+/** The one config-path line every mutating command prints after resolving its file. */
+export function printConfigPath(configPath) {
+    console.log(`Config: ${configPath}`);
+}
+/** Warnings + errors in the shared `warning:` / `error:` shape (colored). */
+export function printValidation(report) {
+    for (const warning of report.warnings)
+        console.log(theme.warn(`warning: ${warning}`));
+    for (const error of report.errors)
+        console.error(theme.fail(`error: ${error}`));
+}
+/**
+ * Shared validation gate: print warnings/errors, and when invalid print the
+ * given "not applying" line and return false. Callers set the exit code.
+ */
+export function reportValidation(report, notApplying) {
+    printValidation(report);
+    if (report.errors.length > 0) {
+        console.error(theme.fail(notApplying));
+        return false;
+    }
+    return true;
+}
+/** Apply/setup result tail: colorized messages, then themed errors. */
+export function printMessages(messages, errors) {
+    for (const message of messages)
+        console.log(colorizeLine(message));
+    for (const error of errors)
+        console.error(theme.fail(error));
+}
+/**
+ * Human duration for the end-of-run line: sub-second in whole milliseconds,
+ * otherwise seconds to one decimal (or `Xm Ys` past a minute). Non-finite and
+ * negative inputs clamp to `0ms` so callers never print `NaN`.
+ */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms <= 0)
+        return '0ms';
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    const seconds = ms / 1000;
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const wholeSeconds = Math.floor(seconds);
+    return `${Math.floor(wholeSeconds / 60)}m ${wholeSeconds % 60}s`;
+}
+/** End-of-run timing phrase: `failed in …` for a fail outcome, else `finished in …`. */
+export function timingPhrase(severity, ms) {
+    return `${severity === 'fail' ? 'failed' : 'finished'} in ${formatDuration(ms)}`;
+}
+/**
+ * Shared result-box line, gated by TTY/quiet exactly like every other result.
+ * When `elapsedMs` is given, a timing line is appended (always printed, so a
+ * piped/CI run still records how long the command took).
+ */
+export function printResult(severity, headline, summary, elapsedMs) {
+    console.log(`\n${resolveResultLine({ severity, headline, summary })}\n`);
+    if (elapsedMs !== undefined) {
+        console.log(`${timingPhrase(severity, elapsedMs)}\n`);
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/ui/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/ui/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAYhD,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,MAA4B;IAC1D,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC;IACtF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA4B,EAAE,WAAmB;IAChF,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,MAAgB;IAChE,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;IAC5C,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1B,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,KAAK,YAAY,GAAG,EAAE,GAAG,CAAC;AACnE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAC,QAAwB,EAAE,EAAU;IAC/D,OAAO,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,OAAO,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,QAAwB,EACxB,QAAgB,EAChB,OAAgB,EAChB,SAAkB;IAElB,OAAO,CAAC,GAAG,CAAC,KAAK,iBAAiB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/ui/spinner.d.ts

@@ -10,14 +10,18 @@ export interface Spinner {
     start(): Spinner;
     succeed(text?: string): Spinner;
     fail(text?: string): Spinner;
+    /** Pause rendering without a succeed/fail glyph, so a caller can print raw output (e.g. streamed mise install progress) without the spinner fighting it for the terminal line, then `start()` again to resume. */
+    stop(): Spinner;
 }
 export type SpinnerFactory = (text: string) => Spinner;
 /**
  * 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.
+ * 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.
  */
 export declare function withSpinner<T extends {
     success: boolean;
-}>(label: string, fn: () => Promise<T>, spinnerFactory?: SpinnerFactory): Promise<T>;
+}>(label: string, fn: (spinner: Spinner) => Promise<T>, spinnerFactory?: SpinnerFactory): Promise<T>;
 //# sourceMappingURL=spinner.d.ts.map

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;CAC9B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAUvD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,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;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"}

package/dist/ui/spinner.js

@@ -13,17 +13,20 @@ const quietSpinner = {
     start: () => quietSpinner,
     succeed: () => quietSpinner,
     fail: () => quietSpinner,
+    stop: () => quietSpinner,
 };
 /**
  * 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.
+ * 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.
  */
 export async function withSpinner(label, fn, spinnerFactory = defaultSpinnerFactory) {
     const factory = isQuiet() ? () => quietSpinner : spinnerFactory;
     const spinner = factory(label).start();
     try {
-        const result = await fn();
+        const result = await fn(spinner);
         if (result.success)
             spinner.succeed(label);
         else

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;AAUtC,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;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,EAAoB,EACpB,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,EAAE,CAAC;QAC1B,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;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indy2kro/agentenv",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "CLI for configuring a consistent, capable shell environment for AI coding agents",
   "type": "module",
   "main": "dist/index.js",