@guiho/mirror 3.1.2 → 3.2.1

package/library/init.js

@@ -0,0 +1,100 @@
+/**
+ * @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.map

@@ -1 +1 @@
-{"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,CA4DhH,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,YAAY,aAO1D,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"}
+{"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

@@ -4,7 +4,7 @@
 import { relative } from 'node:path';
 import { MirrorError } from './errors.js';
 import { loadMirrorConfig, relativeFromCwd, resolveMirrorPath } from './config.js';
-import { ensureAdapterFiles, readCurrentVersion, renderGitTag, resolveProjectName } from './adapters.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);
@@ -25,11 +25,12 @@ export const buildVersionPlan = async (target, options = {}) => {
     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.endsWith(config.package.path) ? 'package.json' : 'jsr.json',
+            adapter,
             path,
-            currentVersion,
+            currentVersion: adapter === 'package.json' ? await readPackageVersionFile(path) : await readJsrVersionFile(path),
             nextVersion,
         });
     }
@@ -71,11 +72,14 @@ export const buildVersionPlan = async (target, options = {}) => {
 };
 export const resolveFileOutputPaths = (config) => {
     const paths = [];
-    if (config.version.output.includes('package.json'))
+    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 paths;
+    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,7 +1,7 @@
 /**
  * @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';
+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;
@@ -11,4 +11,5 @@ export declare const reportAgentsInstructions: (result: MirrorAgentsInstructions
 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 +1 @@
-{"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;AAGnB,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,WAmB/E,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAQ,YAAqB,WAwC/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"}
+{"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

@@ -2,6 +2,7 @@
  * @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';
@@ -25,6 +26,7 @@ export const reportConfig = (config, format = 'text') => {
         `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)}`,
@@ -39,7 +41,7 @@ export const reportConfig = (config, format = 'text') => {
 };
 export const reportConfigSchema = (format = 'text') => {
     if (format === 'json') {
-        return `${JSON.stringify({ schema: 'See text output for full reference.' }, null, 2)}\n`;
+        return renderMirrorConfigJsonSchema();
     }
     return [
         'MIRROR CONFIGURATION SCHEMA (mirror.config.toml)',
@@ -58,6 +60,7 @@ export const reportConfigSchema = (format = 'text') => {
         '',
         '  [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".',
@@ -75,6 +78,22 @@ export const reportConfigSchema = (format = 'text') => {
         '  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') => {
@@ -132,7 +151,10 @@ export const reportPlan = (plan, format = 'text') => {
 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`;
+    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')
@@ -149,5 +171,12 @@ export const reportExecutionSummary = (result, format = 'text') => {
         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`;
 };

package/library/schema.d.ts

@@ -0,0 +1,164 @@
+/**
+ * @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.";
+                };
+            };
+        };
+        readonly hooks: {
+            readonly type: "object";
+            readonly description: "Lifecycle hook commands that run at defined points during version apply.";
+            readonly additionalProperties: {
+                readonly oneOf: readonly [{
+                    readonly type: "string";
+                    readonly description: "A single shell command.";
+                }, {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Multiple shell commands run sequentially.";
+                }];
+            };
+            readonly properties: {
+                [k: string]: {
+                    oneOf: ({
+                        type: string;
+                        description: string;
+                        items?: undefined;
+                    } | {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        description: string;
+                    })[];
+                };
+            };
+        };
+    };
+};
+export declare const renderMirrorConfigJsonSchema: () => string;
+//# sourceMappingURL=schema.d.ts.map

package/library/schema.d.ts.map

@@ -0,0 +1 @@
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJzB,CAAA;AAEV,eAAO,MAAM,4BAA4B,cAA+D,CAAA"}

package/library/schema.js

@@ -0,0 +1,152 @@
+/**
+ * @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.',
+                },
+            },
+        },
+        hooks: {
+            type: 'object',
+            description: 'Lifecycle hook commands that run at defined points during version apply.',
+            additionalProperties: {
+                oneOf: [
+                    { type: 'string', description: 'A single shell command.' },
+                    { type: 'array', items: { type: 'string' }, description: 'Multiple shell commands run sequentially.' },
+                ],
+            },
+            properties: Object.fromEntries([
+                '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',
+            ].map((key) => [key, {
+                    oneOf: [
+                        { type: 'string', description: `A single shell command to run at the ${key.replaceAll('_', ':')} lifecycle point.` },
+                        { type: 'array', items: { type: 'string' }, description: `Multiple shell commands to run sequentially at the ${key.replaceAll('_', ':')} lifecycle point.` },
+                    ],
+                }])),
+        },
+    },
+};
+export const renderMirrorConfigJsonSchema = () => `${JSON.stringify(mirrorConfigJsonSchema, null, 2)}\n`;