@thymian/common-cli 0.0.0-PLACEHOLDER

package/dist/error-cache.d.ts

@@ -0,0 +1,31 @@
+import type { Command } from '@oclif/core';
+import type { BaseCliRunCommand } from './base-cli-run-command.js';
+import type { ThymianBaseCommand } from './thymian-base-command.js';
+export type CachedError = {
+    name: string;
+    message: string;
+    stack?: string | undefined;
+    cause?: unknown | undefined;
+    commandName: string;
+    timestamp: number;
+    argv: string[];
+    version: {
+        architecture: string;
+        cliVersion: string;
+        nodeVersion: string;
+        osVersion?: string;
+    };
+    pluginVersions: {
+        name: string;
+        version: string;
+    }[];
+};
+export declare class ErrorCache {
+    private readonly dir;
+    constructor(dir: string);
+    write(error: CachedError): Promise<void>;
+    read(): Promise<CachedError | undefined>;
+    reset(): Promise<void>;
+    static forCommand(command: ThymianBaseCommand<typeof Command> | BaseCliRunCommand<typeof Command>): ErrorCache;
+}
+//# sourceMappingURL=error-cache.d.ts.map

package/dist/error-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-cache.d.ts","sourceRoot":"","sources":["../src/error-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;CACL,CAAC;AAEF,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAElC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAYxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,MAAM,CAAC,UAAU,CACf,OAAO,EACH,kBAAkB,CAAC,OAAO,OAAO,CAAC,GAClC,iBAAiB,CAAC,OAAO,OAAO,CAAC,GACpC,UAAU;CAGd"}

package/dist/error-cache.js

@@ -0,0 +1,36 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export class ErrorCache {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    async write(error) {
+        const cacheFile = path.join(this.dir, 'last_error.json');
+        try {
+            await fs.mkdir(this.dir, { recursive: true });
+            await fs.writeFile(cacheFile, JSON.stringify(error));
+        }
+        catch (err) {
+            /* empty */
+        }
+    }
+    async read() {
+        const cacheFile = path.join(this.dir, 'last_error.json');
+        try {
+            const error = await fs.readFile(cacheFile, 'utf-8');
+            return JSON.parse(error);
+        }
+        catch (e) {
+            return undefined;
+        }
+    }
+    async reset() {
+        const cacheFile = path.join(this.dir, 'last_error.json');
+        await fs.unlink(cacheFile);
+    }
+    static forCommand(command) {
+        return new ErrorCache(command.config.cacheDir);
+    }
+}
+//# sourceMappingURL=error-cache.js.map

package/dist/error-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-cache.js","sourceRoot":"","sources":["../src/error-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA2BlC,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE5C,KAAK,CAAC,KAAK,CAAC,KAAkB;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9C,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEpD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAEzD,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,UAAU,CACf,OAEqC;QAErC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/feedback.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from '@oclif/core';
+import type { BaseCliRunCommand } from './base-cli-run-command.js';
+import type { ThymianBaseCommand } from './thymian-base-command.js';
+export declare class Feedback {
+    private readonly onRun;
+    private wasRun;
+    constructor(initial: boolean, onRun: () => Promise<unknown>);
+    run(): Promise<void>;
+    error(): Promise<void>;
+    shouldPrintFeedback(): boolean;
+    static forCommand(command: ThymianBaseCommand<typeof Command> | BaseCliRunCommand<typeof Command>): Feedback;
+}
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,qBAAa,QAAQ;IAKjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,MAAM,CAAS;gBAGrB,OAAO,EAAE,OAAO,EACC,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IAK1C,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,mBAAmB,IAAI,OAAO;IAI9B,MAAM,CAAC,UAAU,CACf,OAAO,EACH,kBAAkB,CAAC,OAAO,OAAO,CAAC,GAClC,iBAAiB,CAAC,OAAO,OAAO,CAAC,GACpC,QAAQ;CAMZ"}

package/dist/feedback.js

@@ -0,0 +1,30 @@
+export class Feedback {
+    onRun;
+    wasRun = false;
+    constructor(initial, onRun) {
+        this.onRun = onRun;
+        this.wasRun = initial;
+    }
+    async run() {
+        if (this.wasRun) {
+            return;
+        }
+        if (this.shouldPrintFeedback()) {
+            this.wasRun = true;
+            await this.onRun();
+        }
+    }
+    async error() {
+        if (!this.wasRun) {
+            await this.onRun();
+        }
+    }
+    // print the feedback hint in 20% of the cases
+    shouldPrintFeedback() {
+        return Math.random() < 0.2;
+    }
+    static forCommand(command) {
+        return new Feedback(command.jsonEnabled() || command.shouldSuppressFeedback(), () => command.config.runHook('thymian.feedback', {}));
+    }
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,QAAQ;IAKA;IAJX,MAAM,GAAG,KAAK,CAAC;IAEvB,YACE,OAAgB,EACC,KAA6B;QAA7B,UAAK,GAAL,KAAK,CAAwB;QAE9C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,mBAAmB;QACjB,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,UAAU,CACf,OAEqC;QAErC,OAAO,IAAI,QAAQ,CACjB,OAAO,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,sBAAsB,EAAE,EACzD,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CACrD,CAAC;IACJ,CAAC;CACF"}

package/dist/flags/filter-flag.d.ts

@@ -0,0 +1,20 @@
+import { type HttpFilterExpression } from '@thymian/core';
+export declare const filters: {
+    method: (method?: import("@thymian/core").HttpMethod) => import("@thymian/core").RequestFilterExpression;
+    statusCode: (value: string) => import("@thymian/core").ResponseFilterExpression;
+    responseHeader: (header?: import("@thymian/core").HttpHeader, value?: unknown) => import("@thymian/core").ResponseFilterExpression;
+    requestHeader: (header: import("@thymian/core").HttpHeader, value?: unknown) => import("@thymian/core").RequestFilterExpression;
+    path: (path?: string) => import("@thymian/core").RequestFilterExpression;
+    port: (value: string) => import("@thymian/core").RequestFilterExpression;
+    protocol: (value: string) => import("@thymian/core").RequestFilterExpression;
+    origin: (origin?: string) => import("@thymian/core").RequestFilterExpression;
+    authorization: (value: string) => import("@thymian/core").RequestFilterExpression;
+    responseMediaType: (mediaType: string) => import("@thymian/core").ResponseFilterExpression;
+    requestMediaType: (mediaType: string) => import("@thymian/core").RequestFilterExpression;
+};
+export declare function parseFilterExpression(input: string): HttpFilterExpression;
+export declare const filterFlag: import("@oclif/core/interfaces").FlagDefinition<HttpFilterExpression, import("@oclif/core/interfaces").CustomOptions, {
+    multiple: true;
+    requiredOrDefaulted: false;
+}>;
+//# sourceMappingURL=filter-flag.d.ts.map

package/dist/flags/filter-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-flag.d.ts","sourceRoot":"","sources":["../../src/flags/filter-flag.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EAW1B,MAAM,eAAe,CAAC;AAevB,eAAO,MAAM,OAAO;;;;;;;;;;;;CA8B+C,CAAC;AAUpE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAoBzE;AAED,eAAO,MAAM,UAAU;;;EASrB,CAAC"}

package/dist/flags/filter-flag.js

@@ -0,0 +1,63 @@
+import { Errors, Flags } from '@oclif/core';
+import { authorization, method, origin, path, port, protocol, requestHeader, requestMediaType, responseHeader, responseMediaType, statusCode, } from '@thymian/core';
+const filterRegexp = /^(.*):(.*)$/;
+function toNumberOrThrow(value) {
+    const code = Number(value);
+    if (isNaN(code)) {
+        throw new Errors.CLIError(`Invalid status code: ${value}. Must be a number.`);
+    }
+    return code;
+}
+export const filters = {
+    method,
+    statusCode: (value) => statusCode(toNumberOrThrow(value)),
+    responseHeader,
+    requestHeader,
+    path,
+    port: (value) => port(toNumberOrThrow(value)),
+    protocol: (value) => {
+        if (value !== 'http' && value !== 'https') {
+            throw new Errors.CLIError(`Protocol must be either 'http' or 'https', got: ${value}`);
+        }
+        return protocol(value);
+    },
+    origin,
+    authorization: (value) => {
+        if (value === 'true') {
+            return authorization(true);
+        }
+        if (value === 'false') {
+            return authorization(false);
+        }
+        throw new Errors.CLIError(`Authorization must be either 'true' or 'false', got: ${value}`);
+    },
+    responseMediaType,
+    requestMediaType,
+};
+const availableFilters = Object.keys(filters);
+function isAvailableFilter(name) {
+    return availableFilters.includes(name);
+}
+export function parseFilterExpression(input) {
+    if (!filterRegexp.test(input)) {
+        throw new Errors.CLIError(`Invalid filter: ${input}. Use format <filter>:<value>.`);
+    }
+    const [filter, ...values] = input.split(':');
+    if (typeof filter === 'undefined') {
+        throw new Errors.CLIError(`Filter cannot be undefined.`);
+    }
+    if (!isAvailableFilter(filter)) {
+        throw new Errors.CLIError(`Unknown filter: ${filter}. Available filters: ${availableFilters.join(', ')}.`);
+    }
+    return filters[filter](values.join(':'));
+}
+export const filterFlag = Flags.custom({
+    description: 'Filter transactions by properties. Use multiple times for AND. Available filters: ' +
+        availableFilters.join(''),
+    multiple: true,
+    helpValue: 'filter:value',
+    charAliases: ['f'],
+    helpGroup: 'BASE',
+    parse: async (input) => parseFilterExpression(input),
+});
+//# sourceMappingURL=filter-flag.js.map

package/dist/flags/filter-flag.js.map

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

package/dist/flags/option-flag.d.ts

@@ -0,0 +1,39 @@
+export interface PluginOptionOverride {
+    pluginName: string;
+    path: (string | number)[];
+    value: unknown;
+}
+/**
+ * Parse a single `-o` flag value into a structured override.
+ *
+ * Format: `<pluginName>.<property.path[index]...>=<value>`
+ *
+ * The plugin name may be scoped (`@scope/name`). The first `.` after
+ * the plugin name separates it from the property path.  The property
+ * path supports arbitrarily deep nesting via dot notation and bracket
+ * array indexing, following the Helm `--set` convention:
+ *
+ *   @thymian/plugin-reporter.formatters.text.summaryOnly=true
+ *   @thymian/plugin-sampler.items[0].name=Authorization
+ */
+export declare function parseOptionFlag(input: string): PluginOptionOverride;
+/**
+ * Parse a dotted property path that may contain bracket-based array
+ * indices into an array of string keys and numeric indices.
+ *
+ * Examples:
+ *   `formatters.text.summaryOnly`  →  ['formatters', 'text', 'summaryOnly']
+ *   `items[0].name`                →  ['items', 0, 'name']
+ *   `a[1][2].b`                    →  ['a', 1, 2, 'b']
+ */
+export declare function parsePropertyPath(path: string): (string | number)[];
+/**
+ * Set a deeply nested value on an object, creating intermediate objects
+ * or arrays as needed based on the path segments.
+ */
+export declare function deepSet(obj: Record<string, unknown>, path: (string | number)[], value: unknown): void;
+export declare const optionFlag: import("@oclif/core/interfaces").FlagDefinition<PluginOptionOverride, import("@oclif/core/interfaces").CustomOptions, {
+    multiple: true;
+    requiredOrDefaulted: false;
+}>;
+//# sourceMappingURL=option-flag.d.ts.map

package/dist/flags/option-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-flag.d.ts","sourceRoot":"","sources":["../../src/flags/option-flag.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAwBnE;AA8CD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CA0CnE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACzB,KAAK,EAAE,OAAO,GACb,IAAI,CAiBN;AAED,eAAO,MAAM,UAAU;;;EASrB,CAAC"}

package/dist/flags/option-flag.js

@@ -0,0 +1,144 @@
+import { Errors, Flags } from '@oclif/core';
+import { safeParse } from '../safe-parse.js';
+/**
+ * Parse a single `-o` flag value into a structured override.
+ *
+ * Format: `<pluginName>.<property.path[index]...>=<value>`
+ *
+ * The plugin name may be scoped (`@scope/name`). The first `.` after
+ * the plugin name separates it from the property path.  The property
+ * path supports arbitrarily deep nesting via dot notation and bracket
+ * array indexing, following the Helm `--set` convention:
+ *
+ *   @thymian/plugin-reporter.formatters.text.summaryOnly=true
+ *   @thymian/plugin-sampler.items[0].name=Authorization
+ */
+export function parseOptionFlag(input) {
+    const eqIdx = input.indexOf('=');
+    if (eqIdx === -1) {
+        throw new Errors.CLIError(`Invalid option format: "${input}". Expected <pluginName>.<property>=<value>.`);
+    }
+    const fullKey = input.slice(0, eqIdx);
+    const rawValue = input.slice(eqIdx + 1);
+    const { pluginName, propertyPath } = splitPluginNameAndPath(fullKey);
+    if (!pluginName || propertyPath.length === 0) {
+        throw new Errors.CLIError(`Invalid option format: "${input}". Expected <pluginName>.<property>=<value>.`);
+    }
+    return {
+        pluginName,
+        path: propertyPath,
+        value: safeParse(rawValue),
+    };
+}
+/**
+ * Split a full key like `@thymian/plugin-reporter.formatters.text.path` into
+ * the plugin name (`@thymian/plugin-reporter`) and the property path segments
+ * (`['formatters', 'text', 'path']`).
+ *
+ * Scoped packages (`@scope/name`) are handled: the plugin name extends
+ * up to and including the segment that contains a `/`.
+ */
+function splitPluginNameAndPath(fullKey) {
+    const firstDot = fullKey.indexOf('.');
+    if (firstDot === -1) {
+        return { pluginName: fullKey, propertyPath: [] };
+    }
+    // For scoped packages (@scope/name), the plugin name extends past the
+    // first dot when the portion before the first dot starts with '@' and
+    // does not yet contain a '/'.
+    let pluginName;
+    let rest;
+    const beforeDot = fullKey.slice(0, firstDot);
+    if (beforeDot.startsWith('@') && !beforeDot.includes('/')) {
+        // Scoped: `@scope` — need to find the next `.` after the `/`
+        const slashIdx = fullKey.indexOf('/');
+        if (slashIdx === -1) {
+            return { pluginName: fullKey, propertyPath: [] };
+        }
+        const dotAfterSlash = fullKey.indexOf('.', slashIdx);
+        if (dotAfterSlash === -1) {
+            return { pluginName: fullKey, propertyPath: [] };
+        }
+        pluginName = fullKey.slice(0, dotAfterSlash);
+        rest = fullKey.slice(dotAfterSlash + 1);
+    }
+    else {
+        pluginName = beforeDot;
+        rest = fullKey.slice(firstDot + 1);
+    }
+    return { pluginName, propertyPath: parsePropertyPath(rest) };
+}
+/**
+ * Parse a dotted property path that may contain bracket-based array
+ * indices into an array of string keys and numeric indices.
+ *
+ * Examples:
+ *   `formatters.text.summaryOnly`  →  ['formatters', 'text', 'summaryOnly']
+ *   `items[0].name`                →  ['items', 0, 'name']
+ *   `a[1][2].b`                    →  ['a', 1, 2, 'b']
+ */
+export function parsePropertyPath(path) {
+    const segments = [];
+    let current = '';
+    for (let i = 0; i < path.length; i++) {
+        const ch = path[i];
+        if (ch === '.') {
+            if (current) {
+                segments.push(current);
+                current = '';
+            }
+        }
+        else if (ch === '[') {
+            if (current) {
+                segments.push(current);
+                current = '';
+            }
+            const closeBracket = path.indexOf(']', i + 1);
+            if (closeBracket === -1) {
+                throw new Errors.CLIError(`Invalid property path: "${path}". Unclosed bracket at position ${i}.`);
+            }
+            const indexStr = path.slice(i + 1, closeBracket);
+            const index = Number(indexStr);
+            if (!Number.isInteger(index) || index < 0) {
+                throw new Errors.CLIError(`Invalid array index "[${indexStr}]" in property path: "${path}". Array indices must be non-negative integers.`);
+            }
+            segments.push(index);
+            i = closeBracket;
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current) {
+        segments.push(current);
+    }
+    return segments;
+}
+/**
+ * Set a deeply nested value on an object, creating intermediate objects
+ * or arrays as needed based on the path segments.
+ */
+export function deepSet(obj, path, value) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let current = obj;
+    for (let i = 0; i < path.length - 1; i++) {
+        const segment = path[i];
+        const nextSegment = path[i + 1];
+        if (current[segment] === undefined || current[segment] === null) {
+            current[segment] = typeof nextSegment === 'number' ? [] : {};
+        }
+        current = current[segment];
+    }
+    const lastSegment = path[path.length - 1];
+    current[lastSegment] = value;
+}
+export const optionFlag = Flags.custom({
+    description: 'Override plugin options. Format: <pluginName>.<property.path>=<value>. ' +
+        'Supports nested paths (dot notation) and array indices (bracket notation).',
+    multiple: true,
+    helpValue: '<plugin>.<path>=<value>',
+    charAliases: ['o'],
+    helpGroup: 'BASE',
+    parse: async (input) => parseOptionFlag(input),
+});
+//# sourceMappingURL=option-flag.js.map

package/dist/flags/option-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-flag.js","sourceRoot":"","sources":["../../src/flags/option-flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQ7C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,2BAA2B,KAAK,8CAA8C,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAExC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAErE,IAAI,CAAC,UAAU,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,2BAA2B,KAAK,8CAA8C,CAC/E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU;QACV,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAAC,OAAe;IAI7C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,sEAAsE;IACtE,sEAAsE;IACtE,8BAA8B;IAC9B,IAAI,UAAkB,CAAC;IACvB,IAAI,IAAY,CAAC;IAEjB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7C,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrD,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAC7C,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,SAAS,CAAC;QACvB,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,2BAA2B,IAAI,mCAAmC,CAAC,GAAG,CACvE,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,yBAAyB,QAAQ,yBAAyB,IAAI,iDAAiD,CAChH,CAAC;YACJ,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC,GAAG,YAAY,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,GAA4B,EAC5B,IAAyB,EACzB,KAAc;IAEd,8DAA8D;IAC9D,IAAI,OAAO,GAAQ,GAAG,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAEjC,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAChE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAC3C,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAuB;IAC3D,WAAW,EACT,yEAAyE;QACzE,4EAA4E;IAC9E,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,yBAAyB;IACpC,WAAW,EAAE,CAAC,GAAG,CAAC;IAClB,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,KAAK,EAAE,KAAa,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;CACvD,CAAC,CAAC"}

package/dist/flags/rule-set-flag.d.ts

@@ -0,0 +1,5 @@
+export declare const ruleSetFlag: import("@oclif/core/interfaces").FlagDefinition<string, import("@oclif/core/interfaces").CustomOptions, {
+    multiple: true;
+    requiredOrDefaulted: false;
+}>;
+//# sourceMappingURL=rule-set-flag.d.ts.map

package/dist/flags/rule-set-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-set-flag.d.ts","sourceRoot":"","sources":["../../src/flags/rule-set-flag.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW;;;EAOtB,CAAC"}

package/dist/flags/rule-set-flag.js

@@ -0,0 +1,9 @@
+import { Flags } from '@oclif/core';
+export const ruleSetFlag = Flags.custom({
+    description: 'Add a rule set package to use for validation (e.g. @thymian/rules-rfc-9110). Can be specified multiple times.',
+    multiple: true,
+    helpValue: 'package-name',
+    helpGroup: 'BASE',
+    parse: async (input) => input,
+});
+//# sourceMappingURL=rule-set-flag.js.map

package/dist/flags/rule-set-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-set-flag.js","sourceRoot":"","sources":["../../src/flags/rule-set-flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAS;IAC9C,WAAW,EACT,+GAA+G;IACjH,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,cAAc;IACzB,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK;CAC9B,CAAC,CAAC"}

package/dist/flags/spec-flag.d.ts

@@ -0,0 +1,11 @@
+import type { SpecificationInput } from '@thymian/core';
+/**
+ * Parse a `--spec` flag value of the format `<type>:<location>` into a SpecificationInput.
+ * Both type and location are required.
+ */
+export declare function parseSpecFlag(input: string): SpecificationInput;
+export declare const specFlag: import("@oclif/core/interfaces").FlagDefinition<SpecificationInput, import("@oclif/core/interfaces").CustomOptions, {
+    multiple: true;
+    requiredOrDefaulted: false;
+}>;
+//# sourceMappingURL=spec-flag.d.ts.map

package/dist/flags/spec-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-flag.d.ts","sourceRoot":"","sources":["../../src/flags/spec-flag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAmB/D;AAED,eAAO,MAAM,QAAQ;;;EAOnB,CAAC"}

package/dist/flags/spec-flag.js

@@ -0,0 +1,25 @@
+import { Errors, Flags } from '@oclif/core';
+/**
+ * Parse a `--spec` flag value of the format `<type>:<location>` into a SpecificationInput.
+ * Both type and location are required.
+ */
+export function parseSpecFlag(input) {
+    const colonIndex = input.indexOf(':');
+    if (colonIndex === -1) {
+        throw new Errors.CLIError(`Invalid --spec format: "${input}". Expected format: <type>:<location> (e.g. openapi:./openapi.yaml).`);
+    }
+    const type = input.slice(0, colonIndex);
+    const location = input.slice(colonIndex + 1);
+    if (!type || !location) {
+        throw new Errors.CLIError(`Invalid --spec format: "${input}". Expected format: <type>:<location> (e.g. openapi:./openapi.yaml).`);
+    }
+    return { type, location };
+}
+export const specFlag = Flags.custom({
+    description: 'Specification input in the format <type>:<location> (e.g. openapi:./openapi.yaml).',
+    multiple: true,
+    helpValue: 'type:location',
+    helpGroup: 'BASE',
+    parse: async (input) => parseSpecFlag(input),
+});
+//# sourceMappingURL=spec-flag.js.map

package/dist/flags/spec-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-flag.js","sourceRoot":"","sources":["../../src/flags/spec-flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAG5C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,2BAA2B,KAAK,sEAAsE,CACvG,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAE7C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,2BAA2B,KAAK,sEAAsE,CACvG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAqB;IACvD,WAAW,EACT,oFAAoF;IACtF,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,eAAe;IAC1B,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC"}

package/dist/flags/traffic-flag.d.ts

@@ -0,0 +1,10 @@
+import type { TrafficInput } from '@thymian/core';
+/**
+ * Parse a `--traffic` flag value of the format `<type>:<location>` into a TrafficInput.
+ */
+export declare function parseTrafficFlag(input: string): TrafficInput;
+export declare const trafficFlag: import("@oclif/core/interfaces").FlagDefinition<TrafficInput, import("@oclif/core/interfaces").CustomOptions, {
+    multiple: true;
+    requiredOrDefaulted: false;
+}>;
+//# sourceMappingURL=traffic-flag.d.ts.map

package/dist/flags/traffic-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic-flag.d.ts","sourceRoot":"","sources":["../../src/flags/traffic-flag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAmB5D;AAED,eAAO,MAAM,WAAW;;;EAOtB,CAAC"}

package/dist/flags/traffic-flag.js

@@ -0,0 +1,24 @@
+import { Errors, Flags } from '@oclif/core';
+/**
+ * Parse a `--traffic` flag value of the format `<type>:<location>` into a TrafficInput.
+ */
+export function parseTrafficFlag(input) {
+    const colonIndex = input.indexOf(':');
+    if (colonIndex === -1) {
+        throw new Errors.CLIError(`Invalid --traffic format: "${input}". Expected format: <type>:<location> (e.g. har:./traffic.har).`);
+    }
+    const type = input.slice(0, colonIndex);
+    const location = input.slice(colonIndex + 1);
+    if (!type || !location) {
+        throw new Errors.CLIError(`Invalid --traffic format: "${input}". Expected format: <type>:<location> (e.g. har:./traffic.har).`);
+    }
+    return { type, location };
+}
+export const trafficFlag = Flags.custom({
+    description: 'Traffic input in the format <type>:<location> (e.g. har:./traffic.har).',
+    multiple: true,
+    helpValue: 'type:location',
+    helpGroup: 'BASE',
+    parse: async (input) => parseTrafficFlag(input),
+});
+//# sourceMappingURL=traffic-flag.js.map

package/dist/flags/traffic-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic-flag.js","sourceRoot":"","sources":["../../src/flags/traffic-flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAG5C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,8BAA8B,KAAK,iEAAiE,CACrG,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAE7C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,MAAM,CAAC,QAAQ,CACvB,8BAA8B,KAAK,iEAAiE,CACrG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAe;IACpD,WAAW,EACT,yEAAyE;IAC3E,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,eAAe;IAC1B,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC;CAChD,CAAC,CAAC"}

package/dist/get-config.d.ts

@@ -0,0 +1,20 @@
+import type { ThymianConfig } from './thymian-config.js';
+export interface GetConfigOptions {
+    /**
+     * Explicit config file path provided via `--config` flag.
+     * When set, the file MUST exist — a missing file is a hard error (exit 2).
+     */
+    configPath?: string;
+    /** Working directory for file resolution. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Resolve and load a Thymian configuration.
+ *
+ * Resolution chain:
+ * 1. If `configPath` is given (explicit `--config`), load that file or error.
+ * 2. Otherwise probe cwd for well-known config file names.
+ * 3. If no file is found, return `defaultConfig`.
+ */
+export declare function getConfig(options?: GetConfigOptions): Promise<ThymianConfig>;
+//# sourceMappingURL=get-config.d.ts.map

package/dist/get-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-config.d.ts","sourceRoot":"","sources":["../src/get-config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,CA2BxB"}