@guiho/mirror 3.2.1 → 3.3.0-alpha.1

package/library/hooks.js

@@ -1,122 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-import { MirrorError } from './errors.js';
-const execAsync = (command, options) => promisify(exec)(command, {
-    cwd: options.cwd,
-    env: { ...process.env, ...options.env },
-    maxBuffer: 10 * 1024 * 1024,
-});
-export const mirrorHookNames = [
-    'before:everything', 'after:everything',
-    'before:plan', 'after:plan',
-    'before:apply', 'after:apply',
-    'before:write', 'after:write',
-    'before:commit', 'after:commit',
-    'before:tag', 'after:tag',
-    'before:push', 'after:push',
-];
-const hookNameSet = new Set(mirrorHookNames);
-export const normalizeHooksConfig = (raw) => {
-    if (!raw || typeof raw !== 'object')
-        return {};
-    const config = {};
-    for (const [key, value] of Object.entries(raw)) {
-        const name = key.replaceAll('_', ':');
-        if (!hookNameSet.has(name))
-            continue;
-        const commands = typeof value === 'string' ? [value] : value;
-        config[name] = commands;
-    }
-    return config;
-};
-export const runHooks = async (name, commands, env, cwd) => {
-    if (!commands || commands.length === 0)
-        return undefined;
-    const start = Date.now();
-    for (let i = 0; i < commands.length; i++) {
-        const command = commands[i];
-        if (!command)
-            continue;
-        try {
-            await execAsync(command, { cwd, env });
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            const exitCode = typeof error['code'] === 'number' ? error['code'] : 1;
-            throw new MirrorError(`Hook '${name}' failed (exit code ${exitCode}): ${command}\n${message}`, Number(exitCode));
-        }
-    }
-    return {
-        name,
-        commands,
-        status: 'success',
-        durationMs: Date.now() - start,
-        exitCode: 0,
-    };
-};
-export const runHooksQuiet = async (name, commands, env, cwd, results) => {
-    if (!commands || commands.length === 0)
-        return;
-    try {
-        await runHooks(name, commands, env, cwd);
-        results.push({ name, commands, status: 'success', durationMs: 0, exitCode: 0 });
-    }
-    catch (error) {
-        const exitCode = error instanceof MirrorError ? error.exitCode ?? 1 : 1;
-        results.push({ name, commands, status: 'failure', durationMs: 0, exitCode, stderr: error instanceof Error ? error.message : String(error) });
-    }
-};
-export const runActionHooks = async (name, commands, env, cwd, options) => {
-    if (options.dryRun || !commands || commands.length === 0)
-        return undefined;
-    return runHooks(name, commands, env, cwd);
-};
-export const hookEnvFromConfig = (config, target) => ({
-    MIRROR_CWD: config.cwd,
-    MIRROR_CONFIG_PATH: config.configPath ?? '',
-    MIRROR_SOURCE: config.version.source,
-    MIRROR_OUTPUT: config.version.output.join(','),
-    MIRROR_TARGET: target,
-});
-export const hookEnvForPlan = (plan, target) => ({
-    MIRROR_CWD: plan.cwd,
-    MIRROR_CONFIG_PATH: plan.configPath ?? '',
-    MIRROR_SOURCE: plan.source,
-    MIRROR_OUTPUT: plan.output.join(','),
-    MIRROR_TARGET: target,
-    MIRROR_CURRENT: plan.currentVersion,
-    MIRROR_NEXT: plan.nextVersion,
-    MIRROR_PROJECT_NAME: plan.project.name ?? '',
-    MIRROR_GIT_TAG: plan.gitTag ?? '',
-    MIRROR_FILE_PATHS: plan.fileOutputPaths.join(','),
-    MIRROR_COMMIT_ENABLED: String(plan.commitEnabled),
-    MIRROR_PUSH_ENABLED: String(plan.pushEnabled),
-});
-export const hookEnvForAction = (plan, target, action) => {
-    const env = hookEnvForPlan(plan, target);
-    if (action.type === 'write-file') {
-        env['MIRROR_FILE_PATH'] = action.path;
-        env['MIRROR_FILE_CURRENT'] = action.currentVersion;
-        env['MIRROR_FILE_NEXT'] = action.nextVersion;
-    }
-    if (action.type === 'git-commit') {
-        env['MIRROR_COMMIT_MSG'] = action.message;
-        env['MIRROR_COMMIT_PATHS'] = action.paths.join(' ');
-    }
-    if (action.type === 'git-tag') {
-        env['MIRROR_TAG'] = action.tag;
-    }
-    if (action.type === 'git-push') {
-        env['MIRROR_INCLUDE_COMMIT'] = String(action.includeCommit);
-        env['MIRROR_INCLUDE_TAGS'] = String(action.includeTags);
-    }
-    return env;
-};
-export const hookEnvForResult = (plan, target, applied, dryRun) => ({
-    ...hookEnvForPlan(plan, target),
-    MIRROR_APPLIED: String(applied),
-    MIRROR_DRY_RUN: String(dryRun),
-});

package/library/init.d.ts

@@ -1,12 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorAdapterName, MirrorInitAnswers, MirrorInitFlags, MirrorInitPrompter } from './types.js';
-export declare const parseAdapterList: (value: string) => MirrorAdapterName[];
-export declare const resolveInitAnswers: (flags: MirrorInitFlags, cwd: string, prompter?: MirrorInitPrompter) => Promise<MirrorInitAnswers>;
-export declare const isInteractiveInit: (options: {
-    yes?: boolean;
-    nonInteractive?: boolean;
-}) => boolean;
-export declare const createReadlineInitPrompter: () => MirrorInitPrompter;
-//# sourceMappingURL=init.d.ts.map

package/library/init.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../source/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAI3G,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,iBAAiB,EAQjE,CAAA;AAQD,eAAO,MAAM,kBAAkB,GAC7B,OAAO,eAAe,EACtB,KAAK,MAAM,EACX,WAAW,kBAAkB,KAC5B,OAAO,CAAC,iBAAiB,CAkD3B,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,SAAS;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,YACG,CAAA;AAEzF,eAAO,MAAM,0BAA0B,QAAO,kBAmB7C,CAAA"}

package/library/init.js

@@ -1,100 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { createInterface } from 'node:readline/promises';
-import { basename } from 'node:path';
-const adapterValues = new Set(['package.json', 'jsr.json', 'git']);
-export const parseAdapterList = (value) => {
-    const values = value
-        .split(',')
-        .map((item) => item.trim())
-        .filter(Boolean)
-        .filter((item) => adapterValues.has(item));
-    return [...new Set(values)];
-};
-const parsePathList = (value) => value
-    .split(',')
-    .map((item) => item.trim())
-    .filter(Boolean);
-export const resolveInitAnswers = async (flags, cwd, prompter) => {
-    const source = flags.source ?? (await askAdapter(prompter, 'Version source (package.json, jsr.json, git)', 'package.json'));
-    const output = flags.output ?? (await askAdapterList(prompter, 'Version outputs (comma separated)', ['package.json', 'git']));
-    const usesPackage = source === 'package.json' || output.includes('package.json');
-    const usesJsr = source === 'jsr.json' || output.includes('jsr.json');
-    const usesGit = source === 'git' || output.includes('git');
-    const hasFileOutput = output.includes('package.json') || output.includes('jsr.json');
-    const packagePath = usesPackage
-        ? flags.packagePath ?? (prompter ? await prompter.text('package.json path', 'package.json') : 'package.json')
-        : 'package.json';
-    const auxiliaryPaths = usesPackage
-        ? flags.auxiliaryPaths ??
-            (prompter ? parsePathList(await prompter.text('Auxiliary package.json paths (comma separated, blank for none)', '')) : [])
-        : [];
-    const jsrPath = usesJsr
-        ? flags.jsrPath ?? (prompter ? await prompter.text('jsr.json path', 'jsr.json') : 'jsr.json')
-        : 'jsr.json';
-    const name = flags.name ?? (source === 'git' ? basename(cwd) : undefined);
-    const nameAvailable = source === 'package.json' || source === 'jsr.json' || Boolean(name);
-    const defaultTagTemplate = nameAvailable ? '{name}@{version}' : 'v{version}';
-    const tagTemplate = usesGit
-        ? flags.tagTemplate ?? (prompter ? await prompter.text('Git tag template', defaultTagTemplate) : defaultTagTemplate)
-        : defaultTagTemplate;
-    const defaultCommit = usesGit && hasFileOutput;
-    const commit = flags.commit ?? (usesGit && prompter ? await prompter.confirm('Create release commits?', defaultCommit) : defaultCommit);
-    const push = flags.push ?? (usesGit && prompter ? await prompter.confirm('Push release refs?', false) : false);
-    const prereleaseId = flags.prereleaseId ?? '';
-    return {
-        source,
-        output,
-        packagePath,
-        auxiliaryPaths,
-        jsrPath,
-        name,
-        prereleaseId,
-        tagTemplate,
-        commit,
-        push,
-    };
-};
-export const isInteractiveInit = (options) => Boolean(process.stdin.isTTY) && options.yes !== true && options.nonInteractive !== true;
-export const createReadlineInitPrompter = () => {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    return {
-        async text(question, defaultValue) {
-            const suffix = defaultValue.length > 0 ? ` [${defaultValue}]` : ' [none]';
-            const answer = (await rl.question(`${question}${suffix}: `)).trim();
-            return answer.length > 0 ? answer : defaultValue;
-        },
-        async confirm(question, defaultValue) {
-            const suffix = defaultValue ? ' [Y/n]' : ' [y/N]';
-            const answer = (await rl.question(`${question}${suffix}: `)).trim().toLowerCase();
-            if (answer.length === 0)
-                return defaultValue;
-            return answer === 'y' || answer === 'yes';
-        },
-        close() {
-            rl.close();
-        },
-    };
-};
-const askAdapter = async (prompter, question, defaultValue) => {
-    if (!prompter)
-        return defaultValue;
-    for (let attempt = 0; attempt < 3; attempt += 1) {
-        const answer = (await prompter.text(question, defaultValue)).trim();
-        if (adapterValues.has(answer))
-            return answer;
-    }
-    return defaultValue;
-};
-const askAdapterList = async (prompter, question, defaultValue) => {
-    if (!prompter)
-        return defaultValue;
-    for (let attempt = 0; attempt < 3; attempt += 1) {
-        const answer = await prompter.text(question, defaultValue.join(', '));
-        const parsed = parseAdapterList(answer);
-        if (parsed.length > 0)
-            return parsed;
-    }
-    return defaultValue;
-};

package/library/plan.d.ts

@@ -1,10 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorCliOptions, MirrorConfig, MirrorVersionPlan } from './types.js';
-export declare const validateMirrorConfig: (options?: MirrorCliOptions) => Promise<MirrorConfig>;
-export declare const buildVersionPlan: (target: string, options?: MirrorCliOptions) => Promise<MirrorVersionPlan>;
-export declare const resolveFileOutputPaths: (config: MirrorConfig) => string[];
-export declare const releaseLabel: (version: string, projectName?: string) => string;
-export declare const planPathForDisplay: (plan: MirrorVersionPlan, path: string) => string;
-//# sourceMappingURL=plan.d.ts.map

package/library/plan.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../source/plan.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAA2B,MAAM,YAAY,CAAA;AAM5G,eAAO,MAAM,oBAAoB,GAAU,UAAS,gBAAqB,KAAG,OAAO,CAAC,YAAY,CAW/F,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,EAAE,UAAS,gBAAqB,KAAG,OAAO,CAAC,iBAAiB,CA8DhH,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,YAAY,aAU1D,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,cAAc,MAAM,WAAgE,CAAA;AAElI,eAAO,MAAM,kBAAkB,GAAI,MAAM,iBAAiB,EAAE,MAAM,MAAM,WAAoC,CAAA"}

package/library/plan.js

@@ -1,85 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { relative } from 'node:path';
-import { MirrorError } from './errors.js';
-import { loadMirrorConfig, relativeFromCwd, resolveMirrorPath } from './config.js';
-import { ensureAdapterFiles, readCurrentVersion, readJsrVersionFile, readPackageVersionFile, renderGitTag, resolveProjectName } from './adapters.js';
-import { resolveNextVersion } from './version.js';
-export const validateMirrorConfig = async (options = {}) => {
-    const config = await loadMirrorConfig(options);
-    await ensureAdapterFiles(config);
-    const projectName = await resolveProjectName(config);
-    if (config.version.source === 'git' || config.version.output.includes('git')) {
-        renderGitTag(config.git.tagTemplate, '0.0.0', projectName);
-    }
-    return config;
-};
-export const buildVersionPlan = async (target, options = {}) => {
-    const config = await validateMirrorConfig(options);
-    const projectName = await resolveProjectName(config);
-    const currentVersion = await readCurrentVersion(config, projectName);
-    const nextVersion = resolveNextVersion(currentVersion, target, config.version.prereleaseId);
-    const fileOutputPaths = resolveFileOutputPaths(config);
-    const commitEnabled = config.git.commit;
-    const pushEnabled = config.git.push;
-    const actions = [];
-    for (const path of fileOutputPaths) {
-        const adapter = path === resolveMirrorPath(config.cwd, config.jsr.path) ? 'jsr.json' : 'package.json';
-        actions.push({
-            type: 'write-file',
-            adapter,
-            path,
-            currentVersion: adapter === 'package.json' ? await readPackageVersionFile(path) : await readJsrVersionFile(path),
-            nextVersion,
-        });
-    }
-    const gitTag = config.version.output.includes('git') ? renderGitTag(config.git.tagTemplate, nextVersion, projectName) : undefined;
-    if (fileOutputPaths.length > 0 && gitTag && !commitEnabled && !pushEnabled) {
-        throw new MirrorError('Git tag output with file outputs requires --commit or --push so the tag points at the version commit.');
-    }
-    if (commitEnabled && fileOutputPaths.length > 0) {
-        actions.push({
-            type: 'git-commit',
-            message: releaseLabel(nextVersion, projectName),
-            paths: fileOutputPaths.map((path) => relative(config.cwd, path)),
-        });
-    }
-    if (gitTag)
-        actions.push({ type: 'git-tag', tag: gitTag });
-    if (pushEnabled) {
-        actions.push({
-            type: 'git-push',
-            includeCommit: fileOutputPaths.length > 0,
-            includeTags: Boolean(gitTag),
-        });
-    }
-    return {
-        cwd: config.cwd,
-        configPath: config.configPath,
-        source: config.version.source,
-        output: config.version.output,
-        currentVersion,
-        nextVersion,
-        project: { name: projectName },
-        commitEnabled,
-        pushEnabled,
-        allowDirty: config.git.allowDirty,
-        fileOutputPaths,
-        gitTag,
-        actions,
-    };
-};
-export const resolveFileOutputPaths = (config) => {
-    const paths = [];
-    if (config.version.output.includes('package.json')) {
-        paths.push(resolveMirrorPath(config.cwd, config.package.path));
-        for (const path of config.package.auxiliaryPaths)
-            paths.push(resolveMirrorPath(config.cwd, path));
-    }
-    if (config.version.output.includes('jsr.json'))
-        paths.push(resolveMirrorPath(config.cwd, config.jsr.path));
-    return [...new Set(paths)];
-};
-export const releaseLabel = (version, projectName) => (projectName ? `${projectName}@${version}` : `v${version}`);
-export const planPathForDisplay = (plan, path) => relativeFromCwd(plan.cwd, path);

package/library/reporter.d.ts

@@ -1,15 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorAgentsInstructionsResult, MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorHookResult, MirrorSkillInstallResult, MirrorVersionPlan } from './types.js';
-export declare const mirrorBanner: (configPath?: string) => string;
-export declare const reportValue: (value: unknown, format?: MirrorFormat) => string;
-export declare const reportConfig: (config: MirrorConfig, format?: MirrorFormat) => string;
-export declare const reportConfigSchema: (format?: MirrorFormat) => string;
-export declare const reportSkillInstall: (result: MirrorSkillInstallResult, format?: MirrorFormat) => string;
-export declare const reportAgentsInstructions: (result: MirrorAgentsInstructionsResult, format?: MirrorFormat) => string;
-export declare const reportPlan: (plan: MirrorVersionPlan, format?: MirrorFormat) => string;
-export declare const reportExecution: (result: MirrorExecutionResult, format?: MirrorFormat) => string;
-export declare const reportExecutionSummary: (result: MirrorExecutionResult, format?: MirrorFormat) => string;
-export declare const reportHookResults: (results: MirrorHookResult[]) => string;
-//# sourceMappingURL=reporter.d.ts.map

package/library/reporter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../source/reporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,8BAA8B,EAC9B,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,WAW/C,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,SAAQ,YAAqB,WAGxE,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,QAAQ,YAAY,EAAE,SAAQ,YAAqB,WAoB/E,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAQ,YAAqB,WAyD/D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,QAAQ,wBAAwB,EAAE,SAAQ,YAAqB,WAWjG,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,QAAQ,8BAA8B,EAAE,SAAQ,YAAqB,WAS7G,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,MAAM,iBAAiB,EAAE,SAAQ,YAAqB,WAyBhF,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,qBAAqB,EAAE,SAAQ,YAAqB,WAK3F,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,qBAAqB,EAAE,SAAQ,YAAqB,WAkBlG,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,SAAS,gBAAgB,EAAE,WAG5D,CAAA"}

package/library/reporter.js

@@ -1,182 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { configPathForDisplay, relativeFromCwd } from './config.js';
-import { renderMirrorConfigJsonSchema } from './schema.js';
-export const mirrorBanner = (configPath) => {
-    const noColor = process.env['NO_COLOR'] === '1';
-    const title = noColor ? '🪞  GUIHO Mirror' : '\x1b[1;36m🪞  GUIHO Mirror\x1b[0m';
-    if (configPath === undefined)
-        return `\n${title}\n\n`;
-    const dim = noColor ? '' : '\x1b[2m';
-    const reset = noColor ? '' : '\x1b[0m';
-    const status = configPath ? configPath : '(none)';
-    return `\n${title}\n\n${dim}config: ${status}${reset}\n\n`;
-};
-export const reportValue = (value, format = 'text') => {
-    if (format === 'json')
-        return `${JSON.stringify(value, null, 2)}\n`;
-    return `${String(value)}\n`;
-};
-export const reportConfig = (config, format = 'text') => {
-    if (format === 'json')
-        return `${JSON.stringify(config, null, 2)}\n`;
-    return [
-        `config: ${configPathForDisplay(config)}`,
-        `source: ${config.version.source}`,
-        `output: ${config.version.output.join(', ')}`,
-        `package: ${config.package.path}`,
-        `package_auxiliary: ${config.package.auxiliaryPaths.join(', ') || '(none)'}`,
-        `jsr: ${config.jsr.path}`,
-        `tag_template: ${config.git.tagTemplate}`,
-        `commit: ${String(config.git.commit)}`,
-        `push: ${String(config.git.push)}`,
-        `allow_dirty: ${String(config.git.allowDirty)}`,
-        `write_changelog: ${String(config.agents.writeChangelog)}`,
-        `changelog_path: ${config.agents.changelogPath}`,
-        `auto_agents_md: ${String(config.agents.autoAgentsMd)}`,
-        `auto_skill_install: ${String(config.agents.autoSkillInstall)}`,
-        '',
-    ].join('\n');
-};
-export const reportConfigSchema = (format = 'text') => {
-    if (format === 'json') {
-        return renderMirrorConfigJsonSchema();
-    }
-    return [
-        'MIRROR CONFIGURATION SCHEMA (mirror.config.toml)',
-        '',
-        '  schema = 1                                Required. Schema version. Must be 1.',
-        '',
-        '  [project]',
-        '  name = "<string>"                         Optional. Explicit project name.',
-        '  name_source = "package.json" | "jsr.json" Optional. Read project name from this adapter.',
-        '',
-        '  [version]',
-        '  scheme = "semver"                         Required. Only "semver" is supported.',
-        '  source = "package.json" | "jsr.json" | "git"  Required. Adapter to read the current version from.',
-        '  output = ["package.json", "jsr.json", "git"]  Required. Adapters to write the next version to.',
-        '  prerelease_id = "<string>"                Optional. Default prerelease identifier (e.g. "alpha").',
-        '',
-        '  [package]',
-        '  path = "<path>"                           Optional. Path to package.json. Default: "package.json".',
-        '  auxiliary_paths = ["<path>"]              Optional. Extra package.json files that mirror the main package version.',
-        '',
-        '  [jsr]',
-        '  path = "<path>"                           Optional. Path to jsr.json. Default: "jsr.json".',
-        '',
-        '  [git]',
-        '  tag_template = "<template>"               Optional. Git tag format. Default: "v{version}".',
-        '                                            Supported: "v{version}", "{name}@{version}", "{name}/v{version}".',
-        '  commit = true | false                     Optional. Create release commits. Default: false.',
-        '  push = true | false                       Optional. Push release refs. Default: false.',
-        '  allow_dirty = true | false                Optional. Allow dirty Git worktree. Default: false.',
-        '',
-        '  [agents]',
-        '  write_changelog = true | false            Optional. Tell agents to write changelog entries. Default: true.',
-        '  changelog_path = "<path>"                 Optional. Changelog file path for agents. Default: "CHANGELOG.md".',
-        '  auto_agents_md = true | false             Optional. Insert Mirror guidance into AGENTS.md when present. Default: true.',
-        '  auto_skill_install = true | false         Optional. Install guiho-as-mirror globally when missing. Default: true.',
-        '',
-        '  [hooks]',
-        '  before_everything = "<command>"           Optional. Shell command(s) before any release work.',
-        '  after_everything = "<command>"            Optional. Shell command(s) after all release work (always runs).',
-        '  before_plan = "<command>"                 Optional. Shell command(s) before building the release plan.',
-        '  after_plan = "<command>"                  Optional. Shell command(s) after the plan is built.',
-        '  before_apply = "<command>"                Optional. Shell command(s) before executing the plan.',
-        '  after_apply = "<command>"                 Optional. Shell command(s) after plan execution (always runs).',
-        '  before_write = "<command>"                Optional. Shell command(s) before writing version files.',
-        '  after_write = "<command>"                 Optional. Shell command(s) after writing version files.',
-        '  before_commit = "<command>"               Optional. Shell command(s) before creating a release commit.',
-        '  after_commit = "<command>"                Optional. Shell command(s) after creating a release commit.',
-        '  before_tag = "<command>"                  Optional. Shell command(s) before creating a release tag.',
-        '  after_tag = "<command>"                   Optional. Shell command(s) after creating a release tag.',
-        '  before_push = "<command>"                 Optional. Shell command(s) before pushing release refs.',
-        '  after_push = "<command>"                  Optional. Shell command(s) after pushing release refs.',
-        '',
-    ].join('\n');
-};
-export const reportSkillInstall = (result, format = 'text') => {
-    if (format === 'json')
-        return `${JSON.stringify(result, null, 2)}\n`;
-    return [
-        'skill: guiho-as-mirror',
-        `scope: ${result.scope}`,
-        `path: ${result.path}`,
-        `installed: ${String(result.installed)}`,
-        `updated: ${String(result.updated)}`,
-        '',
-    ].join('\n');
-};
-export const reportAgentsInstructions = (result, format = 'text') => {
-    if (format === 'json')
-        return `${JSON.stringify(result, null, 2)}\n`;
-    return [
-        `agents_md: ${result.path}`,
-        `exists: ${String(result.exists)}`,
-        `changed: ${String(result.changed)}`,
-        '',
-    ].join('\n');
-};
-export const reportPlan = (plan, format = 'text') => {
-    if (format === 'json')
-        return `${JSON.stringify(plan, null, 2)}\n`;
-    const lines = [
-        `current: ${plan.currentVersion}`,
-        `next: ${plan.nextVersion}`,
-        `source: ${plan.source}`,
-        `output: ${plan.output.join(', ')}`,
-    ];
-    if (plan.project.name)
-        lines.push(`project: ${plan.project.name}`);
-    if (plan.configPath)
-        lines.push(`config: ${relativeFromCwd(plan.cwd, plan.configPath)}`);
-    if (plan.fileOutputPaths.length > 0)
-        lines.push(`files: ${plan.fileOutputPaths.map((path) => relativeFromCwd(plan.cwd, path)).join(', ')}`);
-    if (plan.gitTag)
-        lines.push(`tag: ${plan.gitTag}`);
-    lines.push('actions:');
-    for (const action of plan.actions) {
-        if (action.type === 'write-file')
-            lines.push(`- write ${relativeFromCwd(plan.cwd, action.path)}: ${action.currentVersion} -> ${action.nextVersion}`);
-        if (action.type === 'git-commit')
-            lines.push(`- commit ${action.message}`);
-        if (action.type === 'git-tag')
-            lines.push(`- tag ${action.tag}`);
-        if (action.type === 'git-push')
-            lines.push(`- push commit=${String(action.includeCommit)} tags=${String(action.includeTags)}`);
-    }
-    return `${lines.join('\n')}\n`;
-};
-export const reportExecution = (result, format = 'text') => {
-    if (format === 'json')
-        return `${JSON.stringify(result, null, 2)}\n`;
-    let out = `${reportPlan(result.plan, 'text')}applied: ${String(result.applied)}\ndry_run: ${String(result.dryRun)}\n`;
-    if (result.hookResults && result.hookResults.length > 0)
-        out += reportHookResults(result.hookResults);
-    return out;
-};
-export const reportExecutionSummary = (result, format = 'text') => {
-    if (format === 'json')
-        return `${JSON.stringify(result, null, 2)}\n`;
-    const outputs = result.plan.output.join(', ');
-    const files = result.plan.fileOutputPaths.map((path) => relativeFromCwd(result.plan.cwd, path)).join(', ');
-    const lines = [
-        `applied: ${String(result.applied)}`,
-        `dry_run: ${String(result.dryRun)}`,
-        `version: ${result.plan.nextVersion}`,
-        `outputs: ${outputs}`,
-    ];
-    if (files)
-        lines.push(`files: ${files}`);
-    if (result.plan.gitTag)
-        lines.push(`tag: ${result.plan.gitTag}`);
-    let out = `${lines.join('\n')}\n`;
-    if (result.hookResults && result.hookResults.length > 0)
-        out += reportHookResults(result.hookResults);
-    return out;
-};
-export const reportHookResults = (results) => {
-    const lines = results.map((r) => `hooks: ${r.name} ${r.status}${r.exitCode ? ` (exit ${r.exitCode})` : ''}`);
-    return `${lines.join('\n')}\n`;
-};