@guiho/mirror 3.2.1 → 3.3.0-alpha.1

package/library/cli.js

@@ -1,416 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { defineCommand, runMain } from 'citty';
-import { readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { ensureMirrorAgentsInstructions, installMirrorSkill, runMirrorAgentAutomation } from './agents.js';
-import { MirrorError } from './errors.js';
-import { readCurrentVersion, resolveProjectName } from './adapters.js';
-import { configPathForDisplay, discoverMirrorConfig, loadMirrorConfig, relativeFromCwd, writeInitConfigFromAnswers } from './config.js';
-import { executeVersionPlan } from './executor.js';
-import { parseMirrorCliOptions } from './flags.js';
-import { createReadlineInitPrompter, isInteractiveInit, resolveInitAnswers } from './init.js';
-import { buildVersionPlan, validateMirrorConfig } from './plan.js';
-import { mirrorBanner, reportAgentsInstructions, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportSkillInstall, reportValue, } from './reporter.js';
-import { resolveNextVersion } from './version.js';
-import { runHooks, runHooksQuiet, hookEnvFromConfig, hookEnvForPlan, hookEnvForResult } from './hooks.js';
-const mirrorVersion = readInstalledVersion();
-const globalArgs = {
-    config: { type: 'string', description: 'Path to mirror.config.toml' },
-    cwd: { type: 'string', description: 'Run as if Mirror started in this directory' },
-    format: { type: 'enum', options: ['text', 'json'], default: 'text', description: 'Output format' },
-    'no-color': { type: 'boolean', description: 'Disable color output' },
-    verbose: { type: 'boolean', description: 'Show full error details and stack traces' },
-};
-const overrideArgs = {
-    ...globalArgs,
-    source: { type: 'enum', options: ['package.json', 'jsr.json', 'git'], description: 'Override version source' },
-    output: { type: 'string', description: 'Override version output. Repeat or comma-separate values.' },
-    'package-file': { type: 'string', description: 'Override package.json path' },
-    'jsr-file': { type: 'string', description: 'Override jsr.json path' },
-    preid: { type: 'string', description: 'Override prerelease identifier' },
-};
-const applyArgs = {
-    ...overrideArgs,
-    'dry-run': { type: 'boolean', alias: 'dy', description: 'Build and print the plan without applying it' },
-    commit: { type: 'boolean', description: 'Create a release commit when file outputs changed' },
-    push: { type: 'boolean', description: 'Create the release commit when needed, then push release refs' },
-    'allow-dirty': { type: 'boolean', description: 'Allow release in a dirty Git worktree' },
-    yes: { type: 'boolean', alias: 'y', description: 'Apply without interactive confirmation' },
-};
-const targetArg = {
-    target: { type: 'positional', description: 'Release target or exact semantic version', required: true },
-};
-export const createMirrorCommand = () => defineCommand({
-    meta: {
-        name: 'mirror',
-        version: mirrorVersion,
-        description: 'Open source project versioning for Bun, npm, JSR, and Git.',
-    },
-    args: globalArgs,
-    subCommands: {
-        init: createInitCommand(),
-        config: createConfigCommand(),
-        agents: createAgentsCommand(),
-        version: createVersionCommand(),
-    },
-});
-export const runMirrorCli = async (rawArgs = process.argv.slice(2)) => {
-    const effectiveArgs = rawArgs.length === 0 ? ['--help'] : rawArgs;
-    const verbose = effectiveArgs.includes('--verbose');
-    const restoreColorOutput = effectiveArgs.includes('--no-color') ? stripColorFromProcessOutput() : () => { };
-    try {
-        if (effectiveArgs.includes('--no-color'))
-            process.env['NO_COLOR'] = '1';
-        if (rawArgs.length === 0) {
-            await prepareAgents({});
-        }
-        if (effectiveArgs.includes('--help')) {
-            const parsed = parseMirrorCliOptions(effectiveArgs);
-            const cwd = resolve(parsed.cwd ?? process.cwd());
-            const discovery = await discoverMirrorConfig(cwd, parsed.config);
-            const configDisplay = discovery.path ? relativeFromCwd(cwd, discovery.path) : '';
-            process.stdout.write(mirrorBanner(configDisplay));
-        }
-        if (rawArgs.length === 0) {
-            process.on('exit', () => {
-                process.stdout.write([
-                    'EXAMPLES',
-                    '',
-                    '  mirror version current                 # Print the current version',
-                    '  mirror version plan patch              # Preview a patch release plan',
-                    '  mirror version apply minor --commit    # Apply a minor release with commit',
-                    '  mirror version plan patch --output=package.json,jsr.json,git  # Plan with package, jsr, and git',
-                    '  mirror agents install local            # Install guiho-as-mirror in this project',
-                    '  mirror agents instructions             # Insert Mirror guidance into AGENTS.md',
-                    '  mirror config schema                   # Print the configuration file reference',
-                    '',
-                ].join('\n') + '\n');
-            });
-        }
-        let capturedError = undefined;
-        const originalConsoleError = console.error;
-        console.error = (...args) => {
-            if (args.length > 0 && args[0] instanceof Error) {
-                capturedError = args[0];
-                return;
-            }
-            originalConsoleError(...args);
-        };
-        const originalProcessExit = process.exit;
-        let exitCode;
-        process.exit = ((code) => {
-            if (code !== 0 && capturedError) {
-                exitCode = code;
-                return undefined;
-            }
-            originalProcessExit(code);
-        });
-        try {
-            await runMain(createMirrorCommand(), { rawArgs: effectiveArgs });
-        }
-        finally {
-            console.error = originalConsoleError;
-            process.exit = originalProcessExit;
-        }
-        if (capturedError) {
-            handleCliError(capturedError, verbose, exitCode);
-        }
-    }
-    catch (error) {
-        handleCliError(error, verbose);
-    }
-    finally {
-        restoreColorOutput();
-    }
-};
-const handleCliError = (error, verbose, exitCode) => {
-    if (error instanceof MirrorError) {
-        console.error(`error: ${error.message}`);
-        if (verbose)
-            console.error(error.stack);
-        process.exit(error.exitCode);
-    }
-    if (error instanceof Error) {
-        console.error(`error: ${error.message}`);
-        if (verbose)
-            console.error(error.stack);
-    }
-    else {
-        console.error('error: An unexpected error occurred.');
-        if (verbose)
-            console.error(error);
-    }
-    process.exit(exitCode ?? 1);
-};
-const createInitCommand = () => defineCommand({
-    meta: { name: 'init', description: 'Create or update a Mirror configuration file.' },
-    args: {
-        ...globalArgs,
-        source: { type: 'positional', required: false, description: 'Version source: package.json, jsr.json, or git' },
-        output: { type: 'string', description: 'Version outputs. Repeat or comma-separate package.json, jsr.json, git.' },
-        'package-file': { type: 'string', description: 'Path to package.json' },
-        'jsr-file': { type: 'string', description: 'Path to jsr.json' },
-        auxiliary: { type: 'string', description: 'Auxiliary package.json paths. Repeat or comma-separate values.' },
-        'tag-template': { type: 'string', description: 'Git tag template' },
-        name: { type: 'string', description: 'Explicit project name' },
-        preid: { type: 'string', description: 'Default prerelease identifier' },
-        commit: { type: 'boolean', description: 'Create release commits' },
-        push: { type: 'boolean', description: 'Push release refs' },
-        'non-interactive': { type: 'boolean', description: 'Skip interactive prompts and use flags + defaults' },
-        yes: { type: 'boolean', description: 'Overwrite an existing mirror.config.toml with generated defaults' },
-    },
-    async run(context) {
-        const options = cliOptions(context.rawArgs, context.args);
-        const cwd = resolve(options.cwd ?? process.cwd());
-        const positionalSource = adapterArg(context.args['source']);
-        const commitProvided = context.rawArgs.includes('--commit');
-        const pushProvided = context.rawArgs.includes('--push');
-        const flags = {
-            source: options.source ?? positionalSource,
-            output: options.output,
-            packagePath: options.packageFile,
-            auxiliaryPaths: options.auxiliary,
-            jsrPath: options.jsrFile,
-            tagTemplate: options.tagTemplate,
-            name: options.name,
-            prereleaseId: options.preid,
-            commit: commitProvided ? options.commit : undefined,
-            push: pushProvided ? options.push : undefined,
-        };
-        const interactive = isInteractiveInit(options);
-        const prompter = interactive ? createReadlineInitPrompter() : undefined;
-        try {
-            const answers = await resolveInitAnswers(flags, cwd, prompter);
-            const path = await writeInitConfigFromAnswers(answers, cwd, Boolean(options.yes));
-            process.stdout.write(reportValue(`created ${path}`, options.format));
-        }
-        finally {
-            await prompter?.close();
-        }
-    },
-});
-const createConfigCommand = () => defineCommand({
-    meta: { name: 'config', description: 'Inspect and validate Mirror configuration.' },
-    subCommands: {
-        show: defineCommand({
-            meta: { name: 'show', description: 'Print the resolved configuration.' },
-            args: overrideArgs,
-            async run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                await prepareAgents(options);
-                const config = await loadMirrorConfig(options);
-                if (options.format !== 'json')
-                    process.stdout.write(mirrorBanner(configPathForDisplay(config)));
-                process.stdout.write(reportConfig(config, options.format));
-            },
-        }),
-        check: defineCommand({
-            meta: { name: 'check', description: 'Validate the resolved configuration.' },
-            args: overrideArgs,
-            async run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                await prepareAgents(options);
-                await validateMirrorConfig(options);
-                process.stdout.write(reportValue('ok', options.format));
-            },
-        }),
-        schema: defineCommand({
-            meta: { name: 'schema', description: 'Print the configuration file reference.' },
-            args: globalArgs,
-            run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                if (options.format !== 'json')
-                    process.stdout.write(mirrorBanner());
-                process.stdout.write(reportConfigSchema(options.format));
-            },
-        }),
-    },
-});
-const createAgentsCommand = () => defineCommand({
-    meta: { name: 'agents', description: 'Install Mirror agent skills and AGENTS.md instructions.' },
-    subCommands: {
-        install: defineCommand({
-            meta: { name: 'install', description: 'Install the guiho-as-mirror agent skill.' },
-            subCommands: {
-                local: createInstallSkillCommand('local'),
-                global: createInstallSkillCommand('global'),
-            },
-        }),
-        instructions: defineCommand({
-            meta: { name: 'instructions', description: 'Insert GUIHO Mirror semantic versioning guidance into AGENTS.md.' },
-            args: globalArgs,
-            async run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                const result = await ensureMirrorAgentsInstructions(resolve(options.cwd ?? process.cwd()), true);
-                process.stdout.write(reportAgentsInstructions(result, options.format));
-            },
-        }),
-    },
-});
-const createInstallSkillCommand = (scope) => defineCommand({
-    meta: { name: scope, description: `Install the guiho-as-mirror skill ${scope}.` },
-    args: globalArgs,
-    async run(context) {
-        const options = cliOptions(context.rawArgs, context.args);
-        const result = await installMirrorSkill(scope, { cwd: resolve(options.cwd ?? process.cwd()) });
-        process.stdout.write(reportSkillInstall(result, options.format));
-    },
-});
-const createVersionCommand = () => defineCommand({
-    meta: { name: 'version', description: 'Read, plan, and apply version changes.' },
-    subCommands: {
-        current: defineCommand({
-            meta: { name: 'current', description: 'Print the current project version.' },
-            args: overrideArgs,
-            async run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                await prepareAgents(options);
-                const config = await loadMirrorConfig(options);
-                const projectName = await resolveProjectName(config);
-                process.stdout.write(reportValue(await readCurrentVersion(config, projectName), options.format));
-            },
-        }),
-        next: defineCommand({
-            meta: { name: 'next', description: 'Print the next version without checking outputs.' },
-            args: { ...overrideArgs, ...targetArg },
-            async run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                await prepareAgents(options);
-                const config = await loadMirrorConfig(options);
-                const projectName = await resolveProjectName(config);
-                const currentVersion = await readCurrentVersion(config, projectName);
-                process.stdout.write(reportValue(resolveNextVersion(currentVersion, String(context.args['target']), config.version.prereleaseId), options.format));
-            },
-        }),
-        plan: defineCommand({
-            meta: { name: 'plan', description: 'Print the release plan without writing anything.' },
-            args: { ...overrideArgs, ...targetArg },
-            async run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                await prepareAgents(options);
-                const plan = await buildVersionPlan(String(context.args['target']), options);
-                if (options.format !== 'json')
-                    process.stdout.write(mirrorBanner(plan.configPath ? plan.configPath : ''));
-                process.stdout.write(reportPlan(plan, options.format));
-            },
-        }),
-        apply: defineCommand({
-            meta: { name: 'apply', description: 'Apply the release plan.' },
-            args: { ...applyArgs, ...targetArg },
-            async run(context) {
-                const options = cliOptions(context.rawArgs, context.args);
-                await prepareAgents(options);
-                const target = String(context.args['target']);
-                const config = await loadMirrorConfig(options);
-                const hooks = config.hooks;
-                const hookResults = [];
-                const baseEnv = hookEnvFromConfig(config, target);
-                try {
-                    await runHooks('before:everything', hooks['before:everything'], baseEnv, config.cwd);
-                }
-                catch (error) {
-                    hookResults.push({ name: 'before:everything', commands: hooks['before:everything'] ?? [], status: 'failure', durationMs: 0, exitCode: error instanceof Error ? 1 : 1, stderr: error instanceof Error ? error.message : String(error) });
-                    throw error;
-                }
-                try {
-                    await runHooks('before:plan', hooks['before:plan'], baseEnv, config.cwd);
-                    const plan = await buildVersionPlan(target, options);
-                    const planEnv = hookEnvForPlan(plan, target);
-                    await runHooks('after:plan', hooks['after:plan'], planEnv, config.cwd);
-                    if (options.format !== 'json')
-                        process.stdout.write(mirrorBanner(plan.configPath ? plan.configPath : ''));
-                    if (options.format !== 'json')
-                        process.stdout.write(reportPlan(plan, options.format));
-                    await runHooks('before:apply', hooks['before:apply'], planEnv, config.cwd);
-                    try {
-                        const result = await executeVersionPlan(plan, options, hooks, target);
-                        result.hookResults = hookResults;
-                        process.stdout.write(options.format === 'json' ? reportExecution(result, options.format) : reportExecutionSummary(result, options.format));
-                    }
-                    finally {
-                        const resultEnv = hookEnvForResult(plan, target, true, Boolean(options.dryRun));
-                        await runHooksQuiet('after:apply', hooks['after:apply'], resultEnv, config.cwd, hookResults);
-                    }
-                }
-                finally {
-                    await runHooksQuiet('after:everything', hooks['after:everything'], baseEnv, config.cwd, hookResults);
-                }
-            },
-        }),
-    },
-});
-const cliOptions = (rawArgs, args) => {
-    const parsed = parseMirrorCliOptions(rawArgs);
-    return {
-        ...parsed,
-        config: parsed.config ?? stringArg(args['config']),
-        cwd: parsed.cwd ?? stringArg(args['cwd']),
-        format: parsed.format ?? (args['format'] === 'json' ? 'json' : 'text'),
-        source: parsed.source ?? adapterArg(args['source']),
-        output: parsed.output ?? outputArg(args['output']),
-        packageFile: parsed.packageFile ?? stringArg(args['packageFile']),
-        jsrFile: parsed.jsrFile ?? stringArg(args['jsrFile']),
-        auxiliary: parsed.auxiliary ?? outputListArg(args['auxiliary']),
-        tagTemplate: parsed.tagTemplate ?? stringArg(args['tagTemplate']),
-        name: parsed.name ?? stringArg(args['name']),
-        preid: parsed.preid ?? stringArg(args['preid']),
-        dryRun: parsed.dryRun || args['dryRun'] === true,
-        commit: parsed.commit || args['commit'] === true,
-        push: parsed.push || args['push'] === true,
-        allowDirty: parsed.allowDirty || args['allowDirty'] === true,
-        nonInteractive: parsed.nonInteractive || args['nonInteractive'] === true,
-        yes: parsed.yes || args['yes'] === true,
-        verbose: parsed.verbose || args['verbose'] === true,
-    };
-};
-const stringArg = (value) => (typeof value === 'string' ? value : undefined);
-const outputListArg = (value) => {
-    if (typeof value !== 'string')
-        return undefined;
-    const values = value.split(',').map((item) => item.trim()).filter(Boolean);
-    return values.length > 0 ? values : undefined;
-};
-const adapterArg = (value) => {
-    if (value === 'package.json' || value === 'jsr.json' || value === 'git')
-        return value;
-    return undefined;
-};
-const outputArg = (value) => {
-    if (typeof value !== 'string')
-        return undefined;
-    const values = value.split(',').map((item) => item.trim()).filter(Boolean);
-    if (values.length === 0)
-        return undefined;
-    return values.map((item) => {
-        const adapter = adapterArg(item);
-        if (!adapter)
-            throw new MirrorError(`Invalid --output value: ${item}`);
-        return adapter;
-    });
-};
-const prepareAgents = async (options) => {
-    await runMirrorAgentAutomation(options, (message) => console.error(message));
-};
-function readInstalledVersion() {
-    try {
-        const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
-        return typeof packageJson['version'] === 'string' ? packageJson['version'] : '0.0.0';
-    }
-    catch {
-        return '0.0.0';
-    }
-}
-const stripAnsi = (value) => value.replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, '');
-const stripColorFromProcessOutput = () => {
-    const originalLog = console.log;
-    const originalError = console.error;
-    console.log = (...values) => originalLog(...values.map(stripAnsiValue));
-    console.error = (...values) => originalError(...values.map(stripAnsiValue));
-    return () => {
-        console.log = originalLog;
-        console.error = originalError;
-    };
-};
-const stripAnsiValue = (value) => (typeof value === 'string' ? stripAnsi(value) : value);

package/library/config.d.ts

@@ -1,18 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorAdapterName, MirrorCliOptions, MirrorConfig, MirrorConfigDiscovery, MirrorInitAnswers, MirrorRawConfig } from './types.js';
-export declare const resolveMirrorPath: (cwd: string, path: string) => string;
-export declare const relativeFromCwd: (cwd: string, path: string) => string;
-export declare const discoverMirrorConfig: (cwd: string, explicitPath?: string) => Promise<MirrorConfigDiscovery>;
-export declare const readConfigFile: (path: string) => Promise<MirrorRawConfig>;
-export declare const loadMirrorConfig: (options?: MirrorCliOptions) => Promise<MirrorConfig>;
-export declare const normalizeMirrorConfig: (raw: MirrorRawConfig, cwd: string, configPath: string | undefined, options?: MirrorCliOptions) => MirrorConfig;
-export declare const defaultInitAnswersForSource: (kind: MirrorAdapterName, cwd: string) => MirrorInitAnswers;
-export declare const generateInitConfig: (answers: MirrorInitAnswers, cwd: string) => string;
-export declare const createInitConfig: (kind: MirrorAdapterName, cwd: string) => string;
-export declare const writeInitConfig: (kind: MirrorAdapterName, cwd: string, overwrite?: boolean) => Promise<string>;
-export declare const writeInitConfigFromAnswers: (answers: MirrorInitAnswers, cwd: string, overwrite?: boolean) => Promise<string>;
-export declare const reconcileInitConfig: (existingContent: string, defaultsContent: string) => string;
-export declare const configPathForDisplay: (config: MirrorConfig) => string;
-//# sourceMappingURL=config.d.ts.map

package/library/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../source/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EAEjB,eAAe,EAChB,MAAM,YAAY,CAAA;AAQnB,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,WAAmD,CAAA;AAE9G,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,WAGxD,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAU,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,qBAAqB,CAa5G,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,eAAe,CAe1E,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAU,UAAS,gBAAqB,KAAG,OAAO,CAAC,YAAY,CAO3F,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,YAAY,MAAM,GAAG,SAAS,EAC9B,UAAS,gBAAqB,KAC7B,YA2DF,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,MAAM,iBAAiB,EAAE,KAAK,MAAM,KAAG,iBAWjF,CAAA;AAEF,eAAO,MAAM,kBAAkB,GAAI,SAAS,iBAAiB,EAAE,KAAK,MAAM,WAsCzE,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,iBAAiB,EAAE,KAAK,MAAM,WAAoE,CAAA;AAEzI,eAAO,MAAM,eAAe,GAAU,MAAM,iBAAiB,EAAE,KAAK,MAAM,EAAE,mBAAiB,oBACT,CAAA;AAEpF,eAAO,MAAM,0BAA0B,GAAU,SAAS,iBAAiB,EAAE,KAAK,MAAM,EAAE,mBAAiB,oBAW1G,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,iBAAiB,MAAM,EAAE,iBAAiB,MAAM,WAyBnF,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,QAAQ,YAAY,WAAoF,CAAA"}