@guiho/mirror 3.1.1 → 3.2.0

package/library/executor.js

@@ -2,8 +2,7 @@
  * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
  */
 import { MirrorError } from './errors.js';
-import { createGitCommit, createGitTag, isGitDirty, isGitRepository, pushGitRefs, writeJsrVersion, writePackageVersion } from './adapters.js';
-import { loadMirrorConfig } from './config.js';
+import { createGitCommit, createGitTag, isGitDirty, isGitRepository, pushGitRefs, writeJsrVersionFile, writePackageVersionFile } from './adapters.js';
 import { buildVersionPlan } from './plan.js';
 export const applyVersionPlan = async (target, options = {}) => {
     const plan = await buildVersionPlan(target, options);
@@ -17,12 +16,11 @@ export const executeVersionPlan = async (plan, options = {}) => {
     }
     if (!options.yes)
         throw new MirrorError('Refusing to apply without confirmation. Pass --yes to apply the plan.');
-    const config = await loadMirrorConfig(options);
-    if (config.version.output.includes('package.json'))
-        await writePackageVersion(config, plan.nextVersion);
-    if (config.version.output.includes('jsr.json'))
-        await writeJsrVersion(config, plan.nextVersion);
     for (const action of plan.actions) {
+        if (action.type === 'write-file' && action.adapter === 'package.json')
+            await writePackageVersionFile(action.path, plan.nextVersion);
+        if (action.type === 'write-file' && action.adapter === 'jsr.json')
+            await writeJsrVersionFile(action.path, plan.nextVersion);
         if (action.type === 'git-commit')
             await createGitCommit(plan.cwd, action.paths, action.message);
         if (action.type === 'git-tag')

package/library/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../source/flags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAqB,gBAAgB,EAAgB,MAAM,YAAY,CAAA;AAenF,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,KAAG,gBAuDzD,CAAA"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../source/flags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAqB,gBAAgB,EAAgB,MAAM,YAAY,CAAA;AAenF,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,KAAG,gBAkEzD,CAAA"}

package/library/flags.js

@@ -2,7 +2,7 @@
  * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
  */
 import { MirrorError } from './errors.js';
-const booleanFlags = new Set(['dry-run', 'commit', 'push', 'allow-dirty', 'yes', 'no-color', 'verbose', 'help', 'version']);
+const booleanFlags = new Set(['dry-run', 'commit', 'push', 'allow-dirty', 'non-interactive', 'yes', 'no-color', 'verbose', 'help', 'version']);
 const adapterNames = new Set(['package.json', 'jsr.json', 'git']);
 const shortFlagAliases = {
     '-dy': '--dry-run',
@@ -38,6 +38,12 @@ export const parseMirrorCliOptions = (rawArgs) => {
             parsed['output'] = [...(Array.isArray(current) ? current : current ? [String(current)] : []), ...nextValues];
             continue;
         }
+        if (key === 'auxiliary') {
+            const nextValues = value.split(',').map((item) => item.trim()).filter(Boolean);
+            const current = parsed['auxiliary'];
+            parsed['auxiliary'] = [...(Array.isArray(current) ? current : current ? [String(current)] : []), ...nextValues];
+            continue;
+        }
         parsed[key] = value;
     }
     return {
@@ -49,11 +55,15 @@ export const parseMirrorCliOptions = (rawArgs) => {
         output: Array.isArray(parsed['output']) ? parsed['output'].map((value) => assertAdapter(value, '--output')) : undefined,
         packageFile: typeof parsed['packageFile'] === 'string' ? parsed['packageFile'] : undefined,
         jsrFile: typeof parsed['jsrFile'] === 'string' ? parsed['jsrFile'] : undefined,
+        auxiliary: Array.isArray(parsed['auxiliary']) ? parsed['auxiliary'].map((value) => String(value)) : undefined,
+        tagTemplate: typeof parsed['tagTemplate'] === 'string' ? parsed['tagTemplate'] : undefined,
+        name: typeof parsed['name'] === 'string' ? parsed['name'] : undefined,
         preid: typeof parsed['preid'] === 'string' ? parsed['preid'] : undefined,
         dryRun: parsed['dryRun'] === true,
         commit: parsed['commit'] === true,
         push: parsed['push'] === true,
         allowDirty: parsed['allowDirty'] === true,
+        nonInteractive: parsed['nonInteractive'] === true,
         yes: parsed['yes'] === true,
         verbose: parsed['verbose'] === true,
     };

package/library/guiho-mirror.d.ts

@@ -1,13 +1,15 @@
 /**
  * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
  */
-export type { MirrorAdapterName, MirrorCliOptions, MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorAgentAutomationResult, MirrorAgentSettings, MirrorAgentsInstructionsResult, MirrorRawConfig, MirrorSkillInstallResult, MirrorSkillInstallScope, MirrorVersionPlan, MirrorVersionPlanAction, MirrorVersionTarget, } from './types.js';
+export type { MirrorAdapterName, MirrorCliOptions, MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorAgentAutomationResult, MirrorAgentSettings, MirrorAgentsInstructionsResult, MirrorInitAnswers, MirrorInitFlags, MirrorInitPrompter, MirrorRawConfig, MirrorSkillInstallResult, MirrorSkillInstallScope, MirrorVersionPlan, MirrorVersionPlanAction, MirrorVersionTarget, } from './types.js';
 export { MirrorError, invariant } from './errors.js';
 export { parseMirrorCliOptions } from './flags.js';
 export { defaultMirrorAgentSettings, ensureMirrorAgentsInstructions, findAgentsFile, installMirrorSkill, isMirrorSkillInstalled, mirrorAgentsSection, mirrorAgentsSectionHeading, mirrorSkillName, resolveMirrorAgentSettings, resolveMirrorSkillPath, runMirrorAgentAutomation, } from './agents.js';
-export { createInitConfig, discoverMirrorConfig, loadMirrorConfig, normalizeMirrorConfig, writeInitConfig } from './config.js';
+export { createInitConfig, defaultInitAnswersForSource, discoverMirrorConfig, generateInitConfig, loadMirrorConfig, normalizeMirrorConfig, reconcileInitConfig, writeInitConfig, writeInitConfigFromAnswers, } from './config.js';
+export { createReadlineInitPrompter, isInteractiveInit, parseAdapterList, resolveInitAnswers } from './init.js';
+export { mirrorConfigJsonSchema, mirrorConfigSchemaReference, renderMirrorConfigJsonSchema } from './schema.js';
 export { assertValidSemver, isMirrorReleaseTarget, mirrorReleaseTargets, resolveNextVersion, sortSemverDescending } from './version.js';
-export { createGitCommit, createGitTag, ensureAdapterFiles, ensureGitAvailable, assertSupportedGitTagTemplate, isGitDirty, isGitRepository, readCurrentVersion, readGitVersion, readJsrName, readJsrVersion, readPackageName, readPackageVersion, renderGitTag, resolveProjectName, supportedGitTagTemplates, versionFromTag, writeJsrVersion, writePackageVersion, } from './adapters.js';
+export { createGitCommit, createGitTag, ensureAdapterFiles, ensureGitAvailable, assertSupportedGitTagTemplate, isGitDirty, isGitRepository, readCurrentVersion, readGitVersion, readJsrName, readJsrVersion, readJsrVersionFile, readPackageName, readPackageVersion, readPackageVersionFile, renderGitTag, resolveProjectName, supportedGitTagTemplates, versionFromTag, writeJsrVersion, writeJsrVersionFile, writePackageVersion, writePackageVersionFile, } from './adapters.js';
 export { buildVersionPlan, releaseLabel, resolveFileOutputPaths, validateMirrorConfig } from './plan.js';
 export { applyVersionPlan, executeVersionPlan } from './executor.js';
 export { mirrorBanner, reportAgentsInstructions, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportSkillInstall, reportValue, } from './reporter.js';

package/library/guiho-mirror.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guiho-mirror.d.ts","sourceRoot":"","sources":["../source/guiho-mirror.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC9H,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACvI,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,6BAA6B,EAC7B,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACxG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,WAAW,GACZ,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"guiho-mirror.d.ts","sourceRoot":"","sources":["../source/guiho-mirror.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,0BAA0B,GAC3B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAC/G,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC/G,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACvI,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,6BAA6B,EAC7B,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACxG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,WAAW,GACZ,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/library/guiho-mirror.js

@@ -4,9 +4,11 @@
 export { MirrorError, invariant } from './errors.js';
 export { parseMirrorCliOptions } from './flags.js';
 export { defaultMirrorAgentSettings, ensureMirrorAgentsInstructions, findAgentsFile, installMirrorSkill, isMirrorSkillInstalled, mirrorAgentsSection, mirrorAgentsSectionHeading, mirrorSkillName, resolveMirrorAgentSettings, resolveMirrorSkillPath, runMirrorAgentAutomation, } from './agents.js';
-export { createInitConfig, discoverMirrorConfig, loadMirrorConfig, normalizeMirrorConfig, writeInitConfig } from './config.js';
+export { createInitConfig, defaultInitAnswersForSource, discoverMirrorConfig, generateInitConfig, loadMirrorConfig, normalizeMirrorConfig, reconcileInitConfig, writeInitConfig, writeInitConfigFromAnswers, } from './config.js';
+export { createReadlineInitPrompter, isInteractiveInit, parseAdapterList, resolveInitAnswers } from './init.js';
+export { mirrorConfigJsonSchema, mirrorConfigSchemaReference, renderMirrorConfigJsonSchema } from './schema.js';
 export { assertValidSemver, isMirrorReleaseTarget, mirrorReleaseTargets, resolveNextVersion, sortSemverDescending } from './version.js';
-export { createGitCommit, createGitTag, ensureAdapterFiles, ensureGitAvailable, assertSupportedGitTagTemplate, isGitDirty, isGitRepository, readCurrentVersion, readGitVersion, readJsrName, readJsrVersion, readPackageName, readPackageVersion, renderGitTag, resolveProjectName, supportedGitTagTemplates, versionFromTag, writeJsrVersion, writePackageVersion, } from './adapters.js';
+export { createGitCommit, createGitTag, ensureAdapterFiles, ensureGitAvailable, assertSupportedGitTagTemplate, isGitDirty, isGitRepository, readCurrentVersion, readGitVersion, readJsrName, readJsrVersion, readJsrVersionFile, readPackageName, readPackageVersion, readPackageVersionFile, renderGitTag, resolveProjectName, supportedGitTagTemplates, versionFromTag, writeJsrVersion, writeJsrVersionFile, writePackageVersion, writePackageVersionFile, } from './adapters.js';
 export { buildVersionPlan, releaseLabel, resolveFileOutputPaths, validateMirrorConfig } from './plan.js';
 export { applyVersionPlan, executeVersionPlan } from './executor.js';
 export { mirrorBanner, reportAgentsInstructions, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportSkillInstall, reportValue, } from './reporter.js';

package/library/init.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -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.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,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

@@ -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".',

package/library/schema.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @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

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

package/library/schema.js

@@ -0,0 +1,128 @@
+/**
+ * @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`;

package/library/types.d.ts

@@ -22,6 +22,7 @@ export type MirrorRawConfig = Partial<{
     }>;
     package: Partial<{
         path: string;
+        auxiliary_paths: string[];
     }>;
     jsr: Partial<{
         path: string;
@@ -55,6 +56,7 @@ export type MirrorConfig = {
     };
     package: {
         path: string;
+        auxiliaryPaths: string[];
     };
     jsr: {
         path: string;
@@ -82,14 +84,47 @@ export type MirrorCliOptions = {
     output?: MirrorAdapterName[];
     packageFile?: string;
     jsrFile?: string;
+    auxiliary?: string[];
+    tagTemplate?: string;
+    name?: string;
     preid?: string;
     dryRun?: boolean;
     commit?: boolean;
     push?: boolean;
     allowDirty?: boolean;
+    nonInteractive?: boolean;
     yes?: boolean;
     verbose?: boolean;
 };
+export type MirrorInitAnswers = {
+    source: MirrorAdapterName;
+    output: MirrorAdapterName[];
+    packagePath: string;
+    auxiliaryPaths: string[];
+    jsrPath: string;
+    name?: string;
+    prereleaseId: string;
+    tagTemplate: string;
+    commit: boolean;
+    push: boolean;
+};
+export type MirrorInitFlags = Partial<{
+    source: MirrorAdapterName;
+    output: MirrorAdapterName[];
+    packagePath: string;
+    auxiliaryPaths: string[];
+    jsrPath: string;
+    name: string;
+    prereleaseId: string;
+    tagTemplate: string;
+    commit: boolean;
+    push: boolean;
+}>;
+export type MirrorInitPrompter = {
+    text(question: string, defaultValue: string): Promise<string>;
+    confirm(question: string, defaultValue: boolean): Promise<boolean>;
+    close(): Promise<void> | void;
+};
 export type MirrorConfigDiscovery = {
     path?: string;
     raw?: MirrorRawConfig;