@guiho/mirror 3.2.0 → 3.3.0-alpha.1

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,14 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorAgentsInstructionsResult, MirrorConfig, MirrorExecutionResult, MirrorFormat, 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;
-//# 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,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,WAyC/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,WAG3F,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,qBAAqB,EAAE,SAAQ,YAAqB,WAgBlG,CAAA"}

package/library/reporter.js

@@ -1,156 +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.',
-        '',
-    ].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`;
-    return `${reportPlan(result.plan, 'text')}applied: ${String(result.applied)}\ndry_run: ${String(result.dryRun)}\n`;
-};
-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}`);
-    return `${lines.join('\n')}\n`;
-};

package/library/schema.d.ts

@@ -1,133 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-export declare const mirrorConfigSchemaReference = "./node_modules/@guiho/mirror/schema/mirror.config.schema.json";
-export declare const mirrorConfigJsonSchema: {
-    readonly $schema: "http://json-schema.org/draft-07/schema#";
-    readonly $id: "https://guiho.co/schema/mirror.config.schema.json";
-    readonly title: "GUIHO Mirror Configuration";
-    readonly description: "Configuration schema for mirror.config.toml.";
-    readonly type: "object";
-    readonly required: readonly ["schema", "version"];
-    readonly additionalProperties: false;
-    readonly properties: {
-        readonly schema: {
-            readonly const: 1;
-            readonly description: "Configuration schema version. Must be 1.";
-        };
-        readonly project: {
-            readonly type: "object";
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly name: {
-                    readonly type: "string";
-                    readonly description: "Explicit project name.";
-                };
-                readonly name_source: {
-                    readonly enum: readonly ["package.json", "jsr.json"];
-                    readonly description: "Adapter used to read the project name.";
-                };
-            };
-        };
-        readonly version: {
-            readonly type: "object";
-            readonly additionalProperties: false;
-            readonly required: readonly ["source", "output"];
-            readonly properties: {
-                readonly scheme: {
-                    readonly const: "semver";
-                    readonly description: "Versioning scheme. Only \"semver\" is supported.";
-                };
-                readonly source: {
-                    readonly enum: readonly ["package.json", "jsr.json", "git"];
-                    readonly description: "Adapter Mirror reads the current version from.";
-                };
-                readonly output: {
-                    readonly type: "array";
-                    readonly minItems: 1;
-                    readonly items: {
-                        readonly enum: readonly ["package.json", "jsr.json", "git"];
-                    };
-                    readonly description: "Adapters Mirror writes the next version to.";
-                };
-                readonly prerelease_id: {
-                    readonly type: "string";
-                    readonly description: "Default prerelease identifier, for example \"alpha\".";
-                };
-            };
-        };
-        readonly package: {
-            readonly type: "object";
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly path: {
-                    readonly type: "string";
-                    readonly description: "Path to the main package.json.";
-                };
-                readonly auxiliary_paths: {
-                    readonly type: "array";
-                    readonly items: {
-                        readonly type: "string";
-                    };
-                    readonly description: "Extra package.json files that mirror the main package version.";
-                };
-            };
-        };
-        readonly jsr: {
-            readonly type: "object";
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly path: {
-                    readonly type: "string";
-                    readonly description: "Path to jsr.json.";
-                };
-            };
-        };
-        readonly git: {
-            readonly type: "object";
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly tag_template: {
-                    readonly enum: readonly ["v{version}", "{name}@{version}", "{name}/v{version}"];
-                    readonly description: "Git tag format.";
-                };
-                readonly commit: {
-                    readonly type: "boolean";
-                    readonly description: "Create release commits.";
-                };
-                readonly push: {
-                    readonly type: "boolean";
-                    readonly description: "Push release refs.";
-                };
-                readonly allow_dirty: {
-                    readonly type: "boolean";
-                    readonly description: "Allow release in a dirty Git worktree.";
-                };
-            };
-        };
-        readonly agents: {
-            readonly type: "object";
-            readonly additionalProperties: false;
-            readonly properties: {
-                readonly write_changelog: {
-                    readonly type: "boolean";
-                    readonly description: "Tell agents whether changelog edits are allowed.";
-                };
-                readonly changelog_path: {
-                    readonly type: "string";
-                    readonly description: "Changelog file path for agents.";
-                };
-                readonly auto_agents_md: {
-                    readonly type: "boolean";
-                    readonly description: "Insert Mirror guidance into AGENTS.md when present.";
-                };
-                readonly auto_skill_install: {
-                    readonly type: "boolean";
-                    readonly description: "Install guiho-as-mirror globally when missing.";
-                };
-            };
-        };
-    };
-};
-export declare const renderMirrorConfigJsonSchema: () => string;
-//# sourceMappingURL=schema.d.ts.map

package/library/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../source/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,2BAA2B,kEAAkE,CAAA;AAE1G,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0HzB,CAAA;AAEV,eAAO,MAAM,4BAA4B,cAA+D,CAAA"}

package/library/schema.js

@@ -1,128 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-export const mirrorConfigSchemaReference = './node_modules/@guiho/mirror/schema/mirror.config.schema.json';
-export const mirrorConfigJsonSchema = {
-    $schema: 'http://json-schema.org/draft-07/schema#',
-    $id: 'https://guiho.co/schema/mirror.config.schema.json',
-    title: 'GUIHO Mirror Configuration',
-    description: 'Configuration schema for mirror.config.toml.',
-    type: 'object',
-    required: ['schema', 'version'],
-    additionalProperties: false,
-    properties: {
-        schema: {
-            const: 1,
-            description: 'Configuration schema version. Must be 1.',
-        },
-        project: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                name: {
-                    type: 'string',
-                    description: 'Explicit project name.',
-                },
-                name_source: {
-                    enum: ['package.json', 'jsr.json'],
-                    description: 'Adapter used to read the project name.',
-                },
-            },
-        },
-        version: {
-            type: 'object',
-            additionalProperties: false,
-            required: ['source', 'output'],
-            properties: {
-                scheme: {
-                    const: 'semver',
-                    description: 'Versioning scheme. Only "semver" is supported.',
-                },
-                source: {
-                    enum: ['package.json', 'jsr.json', 'git'],
-                    description: 'Adapter Mirror reads the current version from.',
-                },
-                output: {
-                    type: 'array',
-                    minItems: 1,
-                    items: { enum: ['package.json', 'jsr.json', 'git'] },
-                    description: 'Adapters Mirror writes the next version to.',
-                },
-                prerelease_id: {
-                    type: 'string',
-                    description: 'Default prerelease identifier, for example "alpha".',
-                },
-            },
-        },
-        package: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Path to the main package.json.',
-                },
-                auxiliary_paths: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Extra package.json files that mirror the main package version.',
-                },
-            },
-        },
-        jsr: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Path to jsr.json.',
-                },
-            },
-        },
-        git: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                tag_template: {
-                    enum: ['v{version}', '{name}@{version}', '{name}/v{version}'],
-                    description: 'Git tag format.',
-                },
-                commit: {
-                    type: 'boolean',
-                    description: 'Create release commits.',
-                },
-                push: {
-                    type: 'boolean',
-                    description: 'Push release refs.',
-                },
-                allow_dirty: {
-                    type: 'boolean',
-                    description: 'Allow release in a dirty Git worktree.',
-                },
-            },
-        },
-        agents: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                write_changelog: {
-                    type: 'boolean',
-                    description: 'Tell agents whether changelog edits are allowed.',
-                },
-                changelog_path: {
-                    type: 'string',
-                    description: 'Changelog file path for agents.',
-                },
-                auto_agents_md: {
-                    type: 'boolean',
-                    description: 'Insert Mirror guidance into AGENTS.md when present.',
-                },
-                auto_skill_install: {
-                    type: 'boolean',
-                    description: 'Install guiho-as-mirror globally when missing.',
-                },
-            },
-        },
-    },
-};
-export const renderMirrorConfigJsonSchema = () => `${JSON.stringify(mirrorConfigJsonSchema, null, 2)}\n`;