@guiho/mirror 3.2.0 → 3.3.0-alpha.1

package/library/agents.js

@@ -1,200 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { existsSync } from 'node:fs';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, resolve } from 'node:path';
-import { MirrorError } from './errors.js';
-import { discoverMirrorConfig, resolveMirrorPath } from './config.js';
-export const mirrorSkillName = 'guiho-as-mirror';
-export const mirrorAgentsSectionHeading = '## Semantic Project Versioning -- GUIHO Mirror';
-export const defaultMirrorAgentSettings = {
-    writeChangelog: true,
-    changelogPath: 'CHANGELOG.md',
-    autoAgentsMd: true,
-    autoSkillInstall: true,
-};
-export const mirrorAgentsSection = `${mirrorAgentsSectionHeading}
-
-Invoke the guiho-as-mirror agent skill every time the user wants to bump, tag, release, plan, initialize, configure, or troubleshoot semantic project versioning with GUIHO Mirror.
-
-Before editing release docs or changelogs, inspect mirror.config.toml. If [agents].write_changelog is false, skip changelog edits. If it is missing or true, changelog edits are allowed when the project has a changelog.
-
-Use [agents].changelog_path as the changelog file path. If it is missing, use CHANGELOG.md in the project root.
-`;
-export const resolveMirrorSkillPath = (scope, options = {}) => {
-    if (scope === 'local')
-        return resolve(options.cwd ?? process.cwd(), '.agents', 'skills', mirrorSkillName, 'SKILL.md');
-    return resolve(resolveMirrorAgentHome(options.homeDirectory), '.agents', 'skills', mirrorSkillName, 'SKILL.md');
-};
-export const isMirrorSkillInstalled = (scope, options = {}) => existsSync(resolveMirrorSkillPath(scope, options));
-export const installMirrorSkill = async (scope, options = {}) => {
-    const path = resolveMirrorSkillPath(scope, options);
-    const exists = existsSync(path);
-    if (exists && options.overwrite === false)
-        return { scope, path, installed: false, updated: false };
-    const content = await readBundledMirrorSkill();
-    const current = exists ? await readFile(path, 'utf8') : undefined;
-    if (current === content)
-        return { scope, path, installed: false, updated: false };
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(path, content, 'utf8');
-    return { scope, path, installed: !exists, updated: exists };
-};
-export const ensureMirrorAgentsInstructions = async (cwd, create = false) => {
-    const path = findAgentsFile(cwd) ?? resolve(cwd, 'AGENTS.md');
-    const exists = existsSync(path);
-    if (!exists && !create)
-        return { path, exists: false, changed: false };
-    if (!exists) {
-        await writeFile(path, `# Project Agents\n\n${mirrorAgentsSection}\n`, 'utf8');
-        return { path, exists: true, changed: true };
-    }
-    const content = await readFile(path, 'utf8');
-    if (content.includes(mirrorAgentsSectionHeading))
-        return { path, exists: true, changed: false };
-    const nextContent = `${content.trimEnd()}\n\n${mirrorAgentsSection}\n`;
-    await writeFile(path, nextContent, 'utf8');
-    return { path, exists: true, changed: true };
-};
-export const findAgentsFile = (cwd) => {
-    let current = resolve(cwd);
-    while (true) {
-        const path = resolve(current, 'AGENTS.md');
-        if (existsSync(path))
-            return path;
-        const parent = dirname(current);
-        if (parent === current)
-            return undefined;
-        current = parent;
-    }
-};
-export const resolveMirrorAgentSettings = async (options = {}) => {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const discovered = await discoverMirrorConfig(cwd, options.config);
-    if (!discovered.raw)
-        return { ...defaultMirrorAgentSettings };
-    if (discovered.raw.schema !== 1)
-        throw new MirrorError('Unsupported or missing configuration schema. Expected `schema = 1`.');
-    return {
-        writeChangelog: optionalBoolean(discovered.raw.agents?.write_changelog, 'agents.write_changelog') !== false,
-        changelogPath: optionalString(discovered.raw.agents?.changelog_path, 'agents.changelog_path') ?? 'CHANGELOG.md',
-        autoAgentsMd: optionalBoolean(discovered.raw.agents?.auto_agents_md, 'agents.auto_agents_md') !== false,
-        autoSkillInstall: optionalBoolean(discovered.raw.agents?.auto_skill_install, 'agents.auto_skill_install') !== false,
-    };
-};
-export const runMirrorAgentAutomation = async (options = {}, notify = () => { }) => {
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const settings = await resolveMirrorAgentSettings(options);
-    const result = { settings };
-    if (settings.autoAgentsMd)
-        result.agentsMd = await ensureMirrorAgentsInstructions(cwd, false);
-    if (settings.autoSkillInstall) {
-        const scope = 'global';
-        if (!isMirrorSkillInstalled(scope, { cwd, homeDirectory: options.homeDirectory })) {
-            const path = resolveMirrorSkillPath(scope, { cwd, homeDirectory: options.homeDirectory });
-            notify(`notice: ${mirrorSkillName} skill not found ${scope}; Mirror is installing it at ${path}`);
-            result.globalSkill = await installMirrorSkill(scope, { cwd, homeDirectory: options.homeDirectory, overwrite: false });
-        }
-    }
-    return result;
-};
-const readBundledMirrorSkill = async () => {
-    try {
-        return await readFile(new URL('../skills/guiho-as-mirror/SKILL.md', import.meta.url), 'utf8');
-    }
-    catch {
-        return embeddedMirrorSkillContent;
-    }
-};
-const resolveMirrorAgentHome = (homeDirectory) => {
-    const value = homeDirectory ?? process.env['MIRROR_AGENT_HOME'] ?? homedir();
-    return resolveMirrorPath(process.cwd(), value);
-};
-const optionalBoolean = (value, key) => {
-    if (value === undefined)
-        return undefined;
-    if (typeof value !== 'boolean')
-        throw new MirrorError(`Invalid ${key}. Expected true or false.`);
-    return value;
-};
-const optionalString = (value, key) => {
-    if (value === undefined)
-        return undefined;
-    if (typeof value !== 'string')
-        throw new MirrorError(`Invalid ${key}. Expected a string.`);
-    return value;
-};
-const embeddedMirrorSkillContent = [
-    '---',
-    'name: guiho-as-mirror',
-    'description: Use this skill whenever the user asks to version, bump, release, tag, initialize, configure, or troubleshoot a project with GUIHO Mirror. This includes Bun, npm, JSR, package.json, jsr.json, Git tag, semantic versioning, changelog, release-plan, prerelease, and what version comes next workflows.',
-    '---',
-    '',
-    '# GUIHO Mirror',
-    '',
-    'GUIHO Mirror is a deterministic CLI and TypeScript library for semantic project versioning. Use it instead of ad hoc version edits, manual package-manager version commands, or manual release tags.',
-    '',
-    '## Command Selection',
-    '',
-    '1. Use `bun @guiho/mirror` when the package is installed locally and Bun is available.',
-    '2. Use `mirror` when a global binary is available.',
-    '3. Use `bunx @guiho/mirror` when running without installation.',
-    '',
-    'Run `mirror --help` or `mirror <command> --help` for command-specific details when needed.',
-    '',
-    '## Release Workflow',
-    '',
-    'When the user asks to bump, release, tag, or version a project, follow this sequence:',
-    '',
-    '1. Confirm the target and project root. Supported targets are `major`, `premajor`, `minor`, `preminor`, `patch`, `prepatch`, `prerelease`, or an exact semver like `2.0.0`.',
-    '2. Run `<mirror> config show` and read `[git].allow_dirty`, `[agents].write_changelog`, and `[agents].changelog_path`.',
-    '3. If `allow_dirty = false` or absent, check `git status --short` and stop if the worktree is dirty.',
-    '4. Run the project type checker, commonly `bun run typecheck`.',
-    '5. Run the project test suite, commonly `bun test`.',
-    '6. Run `<mirror> version plan <target>` and use the planned next version as the source of truth.',
-    '7. Update release documentation only when it is part of the project release process.',
-    '8. If `[agents].write_changelog = false`, skip changelog edits. Otherwise update `[agents].changelog_path`, defaulting to `CHANGELOG.md` in the project root, and summarize only real changes.',
-    '9. Commit release-preparation changes before applying the version bump.',
-    '10. Run `<mirror> version apply <target> --yes`. Include `--commit` when file outputs and Git tag output are combined unless config already enables commits or push.',
-    '',
-    '## Safety Rules',
-    '',
-    '- Never skip `version plan`.',
-    '- Never hand-edit `package.json` or `jsr.json` version fields as a Mirror substitute.',
-    '- Never create Git tags manually for a Mirror-managed release unless recovering intentionally.',
-    '- Do not apply a version bump after failed typecheck or tests.',
-    '- Do not push release refs unless explicitly requested or configured.',
-    '- When plan output is surprising, stop and explain the mismatch.',
-    '',
-    '## Initialization Workflow',
-    '',
-    'Use `mirror init package.json`, `mirror init jsr.json`, or `mirror init git`, then validate with `mirror config check`, inspect with `mirror config show`, and test with `mirror version current` plus `mirror version plan patch`.',
-    '',
-    '## Configuration Reference',
-    '',
-    'Mirror searches for configuration via `--config <path>`, `./mirror.config.toml`, or `./config/mirror.config.toml`.',
-    '',
-    'Common configuration keys: `[version].source`, `[version].output`, `[version].prerelease_id`, `[git].tag_template`, `[git].commit`, `[git].push`, `[git].allow_dirty`, `[agents].write_changelog`, `[agents].changelog_path`, `[agents].auto_agents_md`, and `[agents].auto_skill_install`.',
-    '',
-    'Agent automation options default to true. Set `write_changelog = false` to tell agents to skip changelog edits, `changelog_path = "docs/CHANGELOG.md"` to specify the changelog file, `auto_agents_md = false` to stop Mirror from inserting its AGENTS.md section, and `auto_skill_install = false` to stop Mirror from installing `guiho-as-mirror` globally when missing.',
-    '',
-    '## CLI Reference',
-    '',
-    '- `mirror config show`',
-    '- `mirror config check`',
-    '- `mirror config schema`',
-    '- `mirror agents install local`',
-    '- `mirror agents install global`',
-    '- `mirror agents instructions`',
-    '- `mirror version current`',
-    '- `mirror version next <target>`',
-    '- `mirror version plan <target>`',
-    '- `mirror version apply <target> --yes`',
-    '',
-    '## Response Style',
-    '',
-    'When reporting a Mirror release result, include the target, current version, planned next version, typecheck/test status, docs or changelog files changed, final apply command, and whether commits, tags, or pushes were created.',
-    '',
-].join('\n');

package/library/cli.d.ts

@@ -1,29 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-export declare const createMirrorCommand: () => import("citty").CommandDef<{
-    config: {
-        type: "string";
-        description: string;
-    };
-    cwd: {
-        type: "string";
-        description: string;
-    };
-    format: {
-        type: "enum";
-        options: string[];
-        default: string;
-        description: string;
-    };
-    'no-color': {
-        type: "boolean";
-        description: string;
-    };
-    verbose: {
-        type: "boolean";
-        description: string;
-    };
-}>;
-export declare const runMirrorCli: (rawArgs?: string[]) => Promise<void>;
-//# sourceMappingURL=cli.d.ts.map

package/library/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4DH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAc5B,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,kBAA+B,kBAwEjE,CAAA"}

package/library/cli.js

@@ -1,387 +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';
-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 plan = await buildVersionPlan(String(context.args['target']), options);
-                if (options.format !== 'json')
-                    process.stdout.write(mirrorBanner(plan.configPath ? plan.configPath : ''));
-                if (options.format !== 'json')
-                    process.stdout.write(reportPlan(plan, options.format));
-                const result = await executeVersionPlan(plan, options);
-                process.stdout.write(options.format === 'json' ? reportExecution(result, options.format) : reportExecutionSummary(result, options.format));
-            },
-        }),
-    },
-});
-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;AAOnB,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,YAyDF,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"}