@guiho/mirror 3.2.1 → 3.3.0-alpha.1

package/library/adapters.js

@@ -1,210 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { execFile } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { readFile, writeFile } from 'node:fs/promises';
-import { promisify } from 'node:util';
-import { MirrorError } from './errors.js';
-import { assertValidSemver, sortSemverDescending } from './version.js';
-import { resolveMirrorPath } from './config.js';
-const execFileAsync = promisify(execFile);
-let gitChecked = false;
-let gitExists = false;
-const checkGitAvailable = async () => {
-    if (gitChecked)
-        return gitExists;
-    gitChecked = true;
-    try {
-        await execFileAsync('git', ['--version']);
-        gitExists = true;
-    }
-    catch {
-        gitExists = false;
-    }
-    return gitExists;
-};
-export const ensureGitAvailable = async () => {
-    if (!(await checkGitAvailable())) {
-        throw new MirrorError('Git executable not found. Git is required when using git as a source or output.');
-    }
-};
-const gitNotFoundMessage = 'Git executable not found. Git is required when using git as a source or output.';
-const runGit = async (cwd, args) => {
-    if (!(await checkGitAvailable())) {
-        throw new MirrorError(gitNotFoundMessage);
-    }
-    try {
-        const { stdout } = await execFileAsync('git', args, { cwd });
-        return stdout;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new MirrorError(`Git command failed: git ${args.join(' ')}\n${message}`);
-    }
-};
-export const supportedGitTagTemplates = ['v{version}', '{name}@{version}', '{name}/v{version}'];
-export const readPackageJson = async (path) => readJsonObject(path, 'package.json');
-export const readJsrJson = async (path) => readJsonObject(path, 'jsr.json');
-export const writeJsonObject = async (path, object) => {
-    await writeFile(path, `${JSON.stringify(object, null, 2)}\n`, 'utf8');
-};
-export const readPackageVersion = async (config) => readVersionField(resolveMirrorPath(config.cwd, config.package.path), 'package.json');
-export const readJsrVersion = async (config) => readVersionField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json');
-export const readPackageVersionFile = async (path) => readVersionField(path, 'package.json');
-export const readJsrVersionFile = async (path) => readVersionField(path, 'jsr.json');
-export const readPackageName = async (config) => readNameField(resolveMirrorPath(config.cwd, config.package.path), 'package.json');
-export const readJsrName = async (config) => readNameField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json');
-export const writePackageVersion = async (config, nextVersion) => writeVersionField(resolveMirrorPath(config.cwd, config.package.path), 'package.json', nextVersion);
-export const writeJsrVersion = async (config, nextVersion) => writeVersionField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json', nextVersion);
-export const writePackageVersionFile = async (path, nextVersion) => writeVersionField(path, 'package.json', nextVersion);
-export const writeJsrVersionFile = async (path, nextVersion) => writeVersionField(path, 'jsr.json', nextVersion);
-export const ensureAdapterFiles = async (config) => {
-    if (usesAdapter(config, 'package.json')) {
-        ensureFile(resolveMirrorPath(config.cwd, config.package.path), 'package.json');
-        for (const path of config.package.auxiliaryPaths)
-            ensureFile(resolveMirrorPath(config.cwd, path), 'package.json');
-    }
-    if (usesAdapter(config, 'jsr.json'))
-        ensureFile(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json');
-    if (usesAdapter(config, 'git'))
-        await ensureGitRepository(config.cwd);
-};
-export const resolveProjectName = async (config) => {
-    if (config.project.name)
-        return config.project.name;
-    if (config.project.nameSource === 'package.json')
-        return readPackageName(config);
-    if (config.project.nameSource === 'jsr.json')
-        return readJsrName(config);
-    return undefined;
-};
-export const readCurrentVersion = async (config, projectName) => {
-    if (config.version.source === 'package.json')
-        return readPackageVersion(config);
-    if (config.version.source === 'jsr.json')
-        return readJsrVersion(config);
-    return readGitVersion(config, projectName);
-};
-export const readGitVersion = async (config, projectName) => {
-    await ensureGitAvailable();
-    await ensureGitRepository(config.cwd);
-    const tagsOutput = await runGit(config.cwd, ['-C', config.cwd, 'tag', '--list']);
-    const versions = tagsOutput
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean)
-        .map((tag) => versionFromTag(config.git.tagTemplate, tag, projectName))
-        .filter((version) => Boolean(version));
-    if (versions.length === 0)
-        throw new MirrorError(`No Git tags match template: ${config.git.tagTemplate}`);
-    return sortSemverDescending(versions)[0] ?? '';
-};
-export const renderGitTag = (template, version, projectName) => {
-    assertSupportedGitTagTemplate(template);
-    assertValidSemver(version, 'Git tag version');
-    if (template.includes('{name}') && !projectName)
-        throw new MirrorError(`Tag template requires a project name: ${template}`);
-    return template.replaceAll('{version}', version).replaceAll('{name}', projectName ?? '');
-};
-export const versionFromTag = (template, tag, projectName) => {
-    assertSupportedGitTagTemplate(template);
-    if (template.includes('{name}') && !projectName)
-        throw new MirrorError(`Tag template requires a project name: ${template}`);
-    const escapedTemplate = escapeRegex(template)
-        .replaceAll('\\{version\\}', '(?<version>.+)')
-        .replaceAll('\\{name\\}', escapeRegex(projectName ?? ''));
-    const match = new RegExp(`^${escapedTemplate}$`).exec(tag);
-    const version = match?.groups?.['version'];
-    if (!version)
-        return undefined;
-    try {
-        assertValidSemver(version, 'Git tag version');
-        return version;
-    }
-    catch {
-        return undefined;
-    }
-};
-export const assertSupportedGitTagTemplate = (template) => {
-    if (!supportedGitTagTemplates.includes(template)) {
-        throw new MirrorError(`Unsupported Git tag template: ${template}. Expected v{version}, {name}@{version}, or {name}/v{version}.`);
-    }
-};
-export const isGitRepository = async (cwd) => {
-    if (!(await checkGitAvailable()))
-        return false;
-    try {
-        await execFileAsync('git', ['-C', cwd, 'rev-parse', '--is-inside-work-tree']);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-export const isGitDirty = async (cwd) => {
-    const output = await runGit(cwd, ['-C', cwd, 'status', '--porcelain']);
-    return output.trim().length > 0;
-};
-export const createGitCommit = async (cwd, paths, message) => {
-    await ensureGitAvailable();
-    for (const path of paths)
-        await runGit(cwd, ['-C', cwd, 'add', path]);
-    await runGit(cwd, ['-C', cwd, 'commit', '-m', message]);
-};
-export const createGitTag = async (cwd, tag) => {
-    await ensureGitAvailable();
-    await runGit(cwd, ['-C', cwd, 'tag', tag, '-m', `Release ${tag}`]);
-};
-export const pushGitRefs = async (cwd, includeCommit, includeTags) => {
-    await ensureGitAvailable();
-    if (includeCommit)
-        await runGit(cwd, ['-C', cwd, 'push']);
-    if (includeTags)
-        await runGit(cwd, ['-C', cwd, 'push', '--tags']);
-};
-const readJsonObject = async (path, label) => {
-    ensureFile(path, label);
-    const content = await readFile(path, 'utf8');
-    let json;
-    try {
-        json = JSON.parse(content);
-    }
-    catch {
-        throw new MirrorError(`${label} must contain valid JSON: ${path}`);
-    }
-    if (typeof json !== 'object' || json === null || Array.isArray(json))
-        throw new MirrorError(`${label} must contain a JSON object: ${path}`);
-    return json;
-};
-const readVersionField = async (path, label) => {
-    const json = await readJsonObject(path, label);
-    const version = json['version'];
-    if (typeof version !== 'string')
-        throw new MirrorError(`${label} must contain a string version field: ${path}`);
-    assertValidSemver(version, `${label} version`);
-    return version;
-};
-const readNameField = async (path, label) => {
-    const json = await readJsonObject(path, label);
-    const name = json['name'];
-    if (typeof name !== 'string' || name.length === 0)
-        throw new MirrorError(`${label} must contain a string name field: ${path}`);
-    return name;
-};
-const writeVersionField = async (path, label, nextVersion) => {
-    const json = await readJsonObject(path, label);
-    json['version'] = nextVersion;
-    await writeJsonObject(path, json);
-};
-const ensureFile = (path, label) => {
-    if (!existsSync(path))
-        throw new MirrorError(`${label} file not found: ${path}`);
-};
-const ensureGitRepository = async (cwd) => {
-    await ensureGitAvailable();
-    if (!(await isGitRepository(cwd)))
-        throw new MirrorError(`Not a Git repository: ${cwd}`);
-};
-const usesAdapter = (config, adapter) => config.version.source === adapter || config.version.output.includes(adapter);
-const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');

package/library/agents.d.ts

@@ -1,29 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorAgentAutomationResult, MirrorAgentSettings, MirrorAgentsInstructionsResult, MirrorCliOptions, MirrorSkillInstallResult, MirrorSkillInstallScope } from './types.js';
-export declare const mirrorSkillName = "guiho-as-mirror";
-export declare const mirrorAgentsSectionStartMarker = "<!-- BEGIN GUIHO MIRROR - DO NOT EDIT THIS SECTION -->";
-export declare const mirrorAgentsSectionEndMarker = "<!-- END GUIHO MIRROR -->";
-export declare const mirrorAgentsSectionHeading = "## Semantic Project Versioning -- GUIHO Mirror";
-export declare const defaultMirrorAgentSettings: MirrorAgentSettings;
-export declare const mirrorAgentsSection: string;
-type MirrorSkillPathOptions = {
-    cwd?: string;
-    homeDirectory?: string;
-};
-type MirrorSkillInstallOptions = MirrorSkillPathOptions & {
-    overwrite?: boolean;
-};
-type MirrorAgentAutomationOptions = MirrorCliOptions & {
-    homeDirectory?: string;
-};
-export declare const resolveMirrorSkillPath: (scope: MirrorSkillInstallScope, options?: MirrorSkillPathOptions) => string;
-export declare const isMirrorSkillInstalled: (scope: MirrorSkillInstallScope, options?: MirrorSkillPathOptions) => boolean;
-export declare const installMirrorSkill: (scope: MirrorSkillInstallScope, options?: MirrorSkillInstallOptions) => Promise<MirrorSkillInstallResult>;
-export declare const ensureMirrorAgentsInstructions: (cwd: string, create?: boolean) => Promise<MirrorAgentsInstructionsResult>;
-export declare const findAgentsFile: (cwd: string) => string | undefined;
-export declare const resolveMirrorAgentSettings: (options?: MirrorCliOptions) => Promise<MirrorAgentSettings>;
-export declare const runMirrorAgentAutomation: (options?: MirrorAgentAutomationOptions, notify?: (message: string) => void) => Promise<MirrorAgentAutomationResult>;
-export {};
-//# sourceMappingURL=agents.d.ts.map

package/library/agents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../source/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,eAAe,oBAAoB,CAAA;AAChD,eAAO,MAAM,8BAA8B,2DAA2D,CAAA;AACtG,eAAO,MAAM,4BAA4B,8BAA8B,CAAA;AACvE,eAAO,MAAM,0BAA0B,mDAAmD,CAAA;AAE1F,eAAO,MAAM,0BAA0B,EAAE,mBAKxC,CAAA;AAWD,eAAO,MAAM,mBAAmB,QAEA,CAAA;AAEhC,KAAK,sBAAsB,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,KAAK,yBAAyB,GAAG,sBAAsB,GAAG;IACxD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,KAAK,4BAA4B,GAAG,gBAAgB,GAAG;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,OAAO,uBAAuB,EAAE,UAAS,sBAA2B,WAI1G,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,OAAO,uBAAuB,EAAE,UAAS,sBAA2B,YACvD,CAAA;AAEpD,eAAO,MAAM,kBAAkB,GAC7B,OAAO,uBAAuB,EAC9B,UAAS,yBAA8B,KACtC,OAAO,CAAC,wBAAwB,CAelC,CAAA;AAED,eAAO,MAAM,8BAA8B,GAAU,KAAK,MAAM,EAAE,gBAAc,KAAG,OAAO,CAAC,8BAA8B,CAkBxH,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAWrD,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAU,UAAS,gBAAqB,KAAG,OAAO,CAAC,mBAAmB,CAa5G,CAAA;AAED,eAAO,MAAM,wBAAwB,GACnC,UAAS,4BAAiC,EAC1C,SAAQ,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,KAC3C,OAAO,CAAC,2BAA2B,CAkBrC,CAAA"}

package/library/agents.js

@@ -1,212 +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 mirrorAgentsSectionStartMarker = '<!-- BEGIN GUIHO MIRROR - DO NOT EDIT THIS SECTION -->';
-export const mirrorAgentsSectionEndMarker = '<!-- END GUIHO MIRROR -->';
-export const mirrorAgentsSectionHeading = '## Semantic Project Versioning -- GUIHO Mirror';
-export const defaultMirrorAgentSettings = {
-    writeChangelog: true,
-    changelogPath: 'CHANGELOG.md',
-    autoAgentsMd: true,
-    autoSkillInstall: true,
-};
-const mirrorAgentsSectionBody = `${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 mirrorAgentsSection = `${mirrorAgentsSectionStartMarker}
-${mirrorAgentsSectionBody.trimEnd()}
-${mirrorAgentsSectionEndMarker}`;
-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 (hasMirrorAgentsSection(content))
-        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 hasMirrorAgentsSection = (content) => {
-    const normalizedContent = normalizeMirrorAgentsSection(content);
-    return [mirrorAgentsSection, mirrorAgentsSectionBody].some((section) => {
-        return normalizedContent.includes(normalizeMirrorAgentsSection(section));
-    });
-};
-const normalizeMirrorAgentsSection = (content) => content.replace(/\s+/g, ' ').trim();
-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;AA6DH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAc5B,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,kBAA+B,kBAwEjE,CAAA"}