@guiho/mirror 3.1.1 → 3.2.0

package/CHANGELOG.md

@@ -5,12 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.2.0] - 2026-06-07
+
+### Added
+
+- Added auxiliary package outputs via `[package].auxiliary_paths` so extra `package.json` files mirror the main package version.
+- Added an interactive `mirror init` wizard (TTY-only) with defaults you accept by pressing Enter, plus flags for every answer and `--non-interactive` for automation.
+- Added new `mirror init` flags: `--output`, `--auxiliary`, `--tag-template`, `--name`, `--commit`, `--push`, `--non-interactive`.
+- Added a JSON Schema for `mirror.config.toml`, shipped at `schema/mirror.config.schema.json` and printable via `mirror config schema --format json`.
+- Generated config files now include a `#:schema` directive for editor autocomplete.
+
+### Changed
+
+- `mirror init` now reconciles an existing `mirror.config.toml` (adds missing defaults) instead of failing, and `--yes` overwrites with generated defaults.
+
 ## [3.1.1] - 2026-06-07
 
 ### Changed
 
 - Changed Mirror skill installation paths to the standard `.agents/skills` and `~/.agents/skills` directories.
 - Changed automatic skill installation to global-only by default while keeping explicit local installation available through `mirror agents install local`.
+- Changed no-argument `mirror` startup to run configured agent setup before showing help.
 - Updated documentation, schema text, and tests to describe the standard agent skill directories.
 
 ## [3.1.0] - 2026-06-07

package/DOCS.md

@@ -160,7 +160,15 @@ Version and config commands accept runtime overrides.
 
 ### `mirror init`
 
-Creates `mirror.config.toml` in the current working directory.
+Creates `mirror.config.toml` in the current working directory. When a configuration file already exists, `mirror init` reconciles missing default keys into it without overwriting user-configured values. Use `--yes` only when you intentionally want to replace the file with freshly generated defaults.
+
+On an interactive terminal, `mirror init` runs a step-by-step wizard for the core fields (version source, outputs, package path, auxiliary package paths, jsr path, git tag template, commit, push). Each prompt shows a default that you accept by pressing Enter. Defaults are source `package.json` and outputs `package.json` + `git`.
+
+Every answer also has a flag, so the command runs fully non-interactively when flags are provided. In non-TTY environments (CI, AI agents) or with `--non-interactive`/`--yes`, Mirror skips prompts and uses flags + defaults instead of waiting for input.
+
+Init flags: `--source`, `--output`, `--package-file`, `--jsr-file`, `--auxiliary`, `--tag-template`, `--name`, `--preid`, `--commit`, `--push`, `--non-interactive`, `--yes`.
+
+Generated configuration files start with a `#:schema` directive pointing at the bundled JSON Schema (`./node_modules/@guiho/mirror/schema/mirror.config.schema.json`) so editors with Taplo / Even Better TOML provide autocomplete and validation.
 
 ```bash
 mirror init package.json
@@ -182,7 +190,7 @@ mirror config schema
 
 - `show`: Prints the resolved configuration after defaults and CLI overrides.
 - `check`: Validates configuration, adapter files, Git availability, and supported Git tag templates.
-- `schema`: Prints the configuration reference.
+- `schema`: Prints the configuration reference. `--format json` prints a JSON Schema for editor autocomplete; the same schema ships at `schema/mirror.config.schema.json`.
 
 ### `mirror agents`
 
@@ -245,6 +253,7 @@ prerelease_id = "alpha"
 
 [package]
 path = "package.json"
+auxiliary_paths = []
 
 [jsr]
 path = "jsr.json"
@@ -285,6 +294,9 @@ Exactly one source is used. Multiple outputs are allowed.
 ### `[package]`
 
 - `path`: Optional path to `package.json`. Default: `package.json`.
+- `auxiliary_paths`: Optional array of extra `package.json` files that mirror the main package version. Default: `[]`.
+
+The main package path remains the source of truth for package version reads and project name reads. Auxiliary package files are write-only mirrors: when `package.json` is in `[version].output`, Mirror plans and writes the same next version to each auxiliary package file and includes those files in release commits.
 
 ### `[jsr]`
 
@@ -319,7 +331,7 @@ Mirror uses standard agent skill directories:
 
 Mirror can self-provision AI-agent instructions for projects that use standard agent skill directories.
 
-When automation is enabled, project commands check for `AGENTS.md` and for global `guiho-as-mirror` skill installation. If guidance is missing, Mirror notifies the user and writes the missing global skill or AGENTS section. Mirror does not automatically write a local skill file; local installation is explicit.
+When automation is enabled, project commands check for `AGENTS.md` and for global `guiho-as-mirror` skill installation. If guidance is missing, Mirror notifies the user and writes the missing global skill or AGENTS section. Running `mirror` with no arguments performs this configured setup before showing help. Mirror does not automatically write a local skill file; local installation is explicit.
 
 Automation is controlled by `[agents]`.
 
@@ -414,7 +426,9 @@ The API uses the same configuration discovery and safety rules as the CLI.
 - `source/guiho-mirror.ts`: public library export surface.
 - `source/guiho-mirror-bin.ts`: CLI binary entrypoint.
 - `source/cli.ts`: citty command tree, CLI argument mapping, and process-facing error handling.
-- `source/config.ts`: TOML discovery, schema validation, defaulting, init config generation, and override merge.
+- `source/config.ts`: TOML discovery, schema validation, defaulting, init config generation, init reconciliation, and override merge.
+- `source/init.ts`: init answer resolution, interactive prompts (TTY-only), and defaults.
+- `source/schema.ts`: JSON Schema for `mirror.config.toml` and the `#:schema` reference.
 - `source/types.ts`: public and internal TypeScript types.
 - `source/version.ts`: semver target validation and next-version resolution.
 - `source/adapters.ts`: package, JSR, and Git read/write primitives.
@@ -516,7 +530,11 @@ Run `mirror init package.json`, `mirror init jsr.json`, or `mirror init git` fro
 
 ### Adapter file not found
 
-Check `[package].path` or `[jsr].path`, or pass `--package-file` or `--jsr-file`.
+Check `[package].path`, `[package].auxiliary_paths`, or `[jsr].path`, or pass `--package-file` or `--jsr-file`.
+
+### Auxiliary package version did not change
+
+Ensure `package.json` is present in `[version].output` and the file is listed in `[package].auxiliary_paths`.
 
 ### Unsupported Git tag template
 

package/README.md

@@ -73,16 +73,18 @@ Adapters connect Mirror to different versioning ecosystems:
 Mirror provides a concise CLI with three main command groups:
 
 #### `mirror init`
-Creates a `mirror.config.toml` file in the current directory.
-- `mirror init package.json`
-- `mirror init jsr.json`
-- `mirror init git`
+Creates or reconciles a `mirror.config.toml` file in the current directory. On an interactive terminal, `mirror init` asks step-by-step questions (version source, outputs, package path, auxiliary paths, tag template, commit/push) with defaults you accept by pressing Enter. Pass flags to answer non-interactively, and in CI / non-TTY environments it uses flags + defaults without prompting.
+- `mirror init` (interactive wizard, or flags + defaults when non-interactive)
+- `mirror init package.json` / `mirror init jsr.json` / `mirror init git` (source shortcut)
+- Flags: `--source`, `--output`, `--package-file`, `--jsr-file`, `--auxiliary`, `--tag-template`, `--name`, `--preid`, `--commit`, `--push`, `--non-interactive`, `--yes`
+
+Defaults: source `package.json`, outputs `package.json` + `git`.
 
 #### `mirror config`
 Validates and inspects configuration.
 - `mirror config show`: Prints the resolved configuration.
 - `mirror config check`: Validates configuration without output.
-- `mirror config schema`: Prints the comprehensive configuration reference.
+- `mirror config schema`: Prints the comprehensive configuration reference. Use `--format json` to print a JSON Schema for editor autocomplete.
 
 #### `mirror agents`
 Installs Mirror-aware agent guidance for projects that use AI coding agents.
@@ -118,6 +120,7 @@ prerelease_id = "alpha"                # Optional. e.g., creates 1.0.1-alpha.0
 
 [package]
 path = "package.json"                  # Optional. Override path to package.json
+auxiliary_paths = []                    # Optional. Extra package.json files that mirror the main version
 
 [jsr]
 path = "jsr.json"                      # Optional. Override path to jsr.json
@@ -137,7 +140,7 @@ auto_skill_install = true              # Optional. Install guiho-as-mirror globa
 
 ### Agent Automation
 
-Mirror is designed to be safely used by AI agents. Project commands automatically check for `AGENTS.md` and the `guiho-as-mirror` skill, then add the Mirror guidance or install the missing skill when automation is enabled.
+Mirror is designed to be safely used by AI agents. Project commands automatically check for `AGENTS.md` and the `guiho-as-mirror` skill, then add the Mirror guidance or install the missing skill when automation is enabled. Running `mirror` with no arguments also performs this configured agent setup before showing help.
 
 Set `write_changelog = false` when agents should skip changelog edits during release preparation. Set `changelog_path = "docs/CHANGELOG.md"` when the changelog is not at the project root. Set `auto_agents_md = false` to opt out of automatic guidance insertion, or `auto_skill_install = false` to opt out of automatic global skill installation.
 

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiho/mirror",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "exports": "./source/guiho-mirror.ts",
   "publish": {
     "include": [

package/library/adapters.d.ts

@@ -9,10 +9,14 @@ export declare const readJsrJson: (path: string) => Promise<MirrorJsonObject>;
 export declare const writeJsonObject: (path: string, object: MirrorJsonObject) => Promise<void>;
 export declare const readPackageVersion: (config: MirrorConfig) => Promise<string>;
 export declare const readJsrVersion: (config: MirrorConfig) => Promise<string>;
+export declare const readPackageVersionFile: (path: string) => Promise<string>;
+export declare const readJsrVersionFile: (path: string) => Promise<string>;
 export declare const readPackageName: (config: MirrorConfig) => Promise<string>;
 export declare const readJsrName: (config: MirrorConfig) => Promise<string>;
 export declare const writePackageVersion: (config: MirrorConfig, nextVersion: string) => Promise<void>;
 export declare const writeJsrVersion: (config: MirrorConfig, nextVersion: string) => Promise<void>;
+export declare const writePackageVersionFile: (path: string, nextVersion: string) => Promise<void>;
+export declare const writeJsrVersionFile: (path: string, nextVersion: string) => Promise<void>;
 export declare const ensureAdapterFiles: (config: MirrorConfig) => Promise<void>;
 export declare const resolveProjectName: (config: MirrorConfig) => Promise<string | undefined>;
 export declare const readCurrentVersion: (config: MirrorConfig, projectName?: string) => Promise<string>;

package/library/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../source/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAsBhE,eAAO,MAAM,kBAAkB,qBAI9B,CAAA;AAiBD,eAAO,MAAM,wBAAwB,kEAAmE,CAAA;AAExG,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAyC,CAAA;AACtH,eAAO,MAAM,WAAW,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAqC,CAAA;AAE9G,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,EAAE,QAAQ,gBAAgB,kBAE3E,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,oBAAyF,CAAA;AACtJ,eAAO,MAAM,cAAc,GAAU,QAAQ,YAAY,oBAAiF,CAAA;AAC1I,eAAO,MAAM,eAAe,GAAU,QAAQ,YAAY,oBAAsF,CAAA;AAChJ,eAAO,MAAM,WAAW,GAAU,QAAQ,YAAY,oBAA8E,CAAA;AAEpI,eAAO,MAAM,mBAAmB,GAAU,QAAQ,YAAY,EAAE,aAAa,MAAM,kBACiB,CAAA;AAEpG,eAAO,MAAM,eAAe,GAAU,QAAQ,YAAY,EAAE,aAAa,MAAM,kBACa,CAAA;AAE5F,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,kBAI5D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,gCAK5D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,EAAE,cAAc,MAAM,oBAIlF,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,QAAQ,YAAY,EAAE,cAAc,MAAM,oBAe9E,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,EAAE,cAAc,MAAM,WAOnF,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,KAAK,MAAM,EAAE,cAAc,MAAM,uBAmBjF,CAAA;AAED,eAAO,MAAM,6BAA6B,GAAI,UAAU,MAAM,SAI7D,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,KAAK,MAAM,qBAQhD,CAAA;AAED,eAAO,MAAM,UAAU,GAAU,KAAK,MAAM,qBAG3C,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,KAAK,MAAM,EAAE,OAAO,MAAM,EAAE,EAAE,SAAS,MAAM,kBAIlF,CAAA;AAED,eAAO,MAAM,YAAY,GAAU,KAAK,MAAM,EAAE,KAAK,MAAM,kBAG1D,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,EAAE,eAAe,OAAO,EAAE,aAAa,OAAO,kBAI1F,CAAA"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../source/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAsBhE,eAAO,MAAM,kBAAkB,qBAI9B,CAAA;AAiBD,eAAO,MAAM,wBAAwB,kEAAmE,CAAA;AAExG,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAyC,CAAA;AACtH,eAAO,MAAM,WAAW,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAqC,CAAA;AAE9G,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,EAAE,QAAQ,gBAAgB,kBAE3E,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,oBAAyF,CAAA;AACtJ,eAAO,MAAM,cAAc,GAAU,QAAQ,YAAY,oBAAiF,CAAA;AAC1I,eAAO,MAAM,sBAAsB,GAAU,MAAM,MAAM,oBAA2C,CAAA;AACpG,eAAO,MAAM,kBAAkB,GAAU,MAAM,MAAM,oBAAuC,CAAA;AAC5F,eAAO,MAAM,eAAe,GAAU,QAAQ,YAAY,oBAAsF,CAAA;AAChJ,eAAO,MAAM,WAAW,GAAU,QAAQ,YAAY,oBAA8E,CAAA;AAEpI,eAAO,MAAM,mBAAmB,GAAU,QAAQ,YAAY,EAAE,aAAa,MAAM,kBACiB,CAAA;AAEpG,eAAO,MAAM,eAAe,GAAU,QAAQ,YAAY,EAAE,aAAa,MAAM,kBACa,CAAA;AAE5F,eAAO,MAAM,uBAAuB,GAAU,MAAM,MAAM,EAAE,aAAa,MAAM,kBAAyD,CAAA;AACxI,eAAO,MAAM,mBAAmB,GAAU,MAAM,MAAM,EAAE,aAAa,MAAM,kBAAqD,CAAA;AAEhI,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,kBAO5D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,gCAK5D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,QAAQ,YAAY,EAAE,cAAc,MAAM,oBAIlF,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,QAAQ,YAAY,EAAE,cAAc,MAAM,oBAe9E,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,EAAE,cAAc,MAAM,WAOnF,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,KAAK,MAAM,EAAE,cAAc,MAAM,uBAmBjF,CAAA;AAED,eAAO,MAAM,6BAA6B,GAAI,UAAU,MAAM,SAI7D,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,KAAK,MAAM,qBAQhD,CAAA;AAED,eAAO,MAAM,UAAU,GAAU,KAAK,MAAM,qBAG3C,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,KAAK,MAAM,EAAE,OAAO,MAAM,EAAE,EAAE,SAAS,MAAM,kBAIlF,CAAA;AAED,eAAO,MAAM,YAAY,GAAU,KAAK,MAAM,EAAE,KAAK,MAAM,kBAG1D,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,EAAE,eAAe,OAAO,EAAE,aAAa,OAAO,kBAI1F,CAAA"}

package/library/adapters.js

@@ -51,13 +51,20 @@ export const writeJsonObject = async (path, object) => {
 };
 export const readPackageVersion = async (config) => readVersionField(resolveMirrorPath(config.cwd, config.package.path), 'package.json');
 export const readJsrVersion = async (config) => readVersionField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json');
+export const readPackageVersionFile = async (path) => readVersionField(path, 'package.json');
+export const readJsrVersionFile = async (path) => readVersionField(path, 'jsr.json');
 export const readPackageName = async (config) => readNameField(resolveMirrorPath(config.cwd, config.package.path), 'package.json');
 export const readJsrName = async (config) => readNameField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json');
 export const writePackageVersion = async (config, nextVersion) => writeVersionField(resolveMirrorPath(config.cwd, config.package.path), 'package.json', nextVersion);
 export const writeJsrVersion = async (config, nextVersion) => writeVersionField(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json', nextVersion);
+export const writePackageVersionFile = async (path, nextVersion) => writeVersionField(path, 'package.json', nextVersion);
+export const writeJsrVersionFile = async (path, nextVersion) => writeVersionField(path, 'jsr.json', nextVersion);
 export const ensureAdapterFiles = async (config) => {
-    if (usesAdapter(config, 'package.json'))
+    if (usesAdapter(config, 'package.json')) {
         ensureFile(resolveMirrorPath(config.cwd, config.package.path), 'package.json');
+        for (const path of config.package.auxiliaryPaths)
+            ensureFile(resolveMirrorPath(config.cwd, path), 'package.json');
+    }
     if (usesAdapter(config, 'jsr.json'))
         ensureFile(resolveMirrorPath(config.cwd, config.jsr.path), 'jsr.json');
     if (usesAdapter(config, 'git'))

package/library/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2DH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAc5B,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,kBAA+B,kBAoEjE,CAAA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4DH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAc5B,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,kBAA+B,kBAwEjE,CAAA"}

package/library/cli.js

@@ -7,9 +7,10 @@ import { resolve } from 'node:path';
 import { ensureMirrorAgentsInstructions, installMirrorSkill, runMirrorAgentAutomation } from './agents.js';
 import { MirrorError } from './errors.js';
 import { readCurrentVersion, resolveProjectName } from './adapters.js';
-import { configPathForDisplay, discoverMirrorConfig, loadMirrorConfig, relativeFromCwd, writeInitConfig } from './config.js';
+import { configPathForDisplay, discoverMirrorConfig, loadMirrorConfig, relativeFromCwd, writeInitConfigFromAnswers } from './config.js';
 import { executeVersionPlan } from './executor.js';
 import { parseMirrorCliOptions } from './flags.js';
+import { createReadlineInitPrompter, isInteractiveInit, resolveInitAnswers } from './init.js';
 import { buildVersionPlan, validateMirrorConfig } from './plan.js';
 import { mirrorBanner, reportAgentsInstructions, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportSkillInstall, reportValue, } from './reporter.js';
 import { resolveNextVersion } from './version.js';
@@ -61,6 +62,9 @@ export const runMirrorCli = async (rawArgs = process.argv.slice(2)) => {
     try {
         if (effectiveArgs.includes('--no-color'))
             process.env['NO_COLOR'] = '1';
+        if (rawArgs.length === 0) {
+            await prepareAgents({});
+        }
         if (effectiveArgs.includes('--help')) {
             const parsed = parseMirrorCliOptions(effectiveArgs);
             const cwd = resolve(parsed.cwd ?? process.cwd());
@@ -140,23 +144,50 @@ const handleCliError = (error, verbose, exitCode) => {
     process.exit(exitCode ?? 1);
 };
 const createInitCommand = () => defineCommand({
-    meta: { name: 'init', description: 'Create a Mirror configuration file.' },
-    subCommands: {
-        'package.json': createInitKindCommand('package.json'),
-        'jsr.json': createInitKindCommand('jsr.json'),
-        git: createInitKindCommand('git'),
-    },
-});
-const createInitKindCommand = (kind) => defineCommand({
-    meta: { name: kind, description: `Create ${kind} project configuration.` },
+    meta: { name: 'init', description: 'Create or update a Mirror configuration file.' },
     args: {
         ...globalArgs,
-        yes: { type: 'boolean', description: 'Overwrite existing mirror.config.toml' },
+        source: { type: 'positional', required: false, description: 'Version source: package.json, jsr.json, or git' },
+        output: { type: 'string', description: 'Version outputs. Repeat or comma-separate package.json, jsr.json, git.' },
+        'package-file': { type: 'string', description: 'Path to package.json' },
+        'jsr-file': { type: 'string', description: 'Path to jsr.json' },
+        auxiliary: { type: 'string', description: 'Auxiliary package.json paths. Repeat or comma-separate values.' },
+        'tag-template': { type: 'string', description: 'Git tag template' },
+        name: { type: 'string', description: 'Explicit project name' },
+        preid: { type: 'string', description: 'Default prerelease identifier' },
+        commit: { type: 'boolean', description: 'Create release commits' },
+        push: { type: 'boolean', description: 'Push release refs' },
+        'non-interactive': { type: 'boolean', description: 'Skip interactive prompts and use flags + defaults' },
+        yes: { type: 'boolean', description: 'Overwrite an existing mirror.config.toml with generated defaults' },
     },
     async run(context) {
         const options = cliOptions(context.rawArgs, context.args);
-        const path = await writeInitConfig(kind, options.cwd ?? process.cwd(), Boolean(options.yes));
-        process.stdout.write(reportValue(`created ${path}`, options.format));
+        const cwd = resolve(options.cwd ?? process.cwd());
+        const positionalSource = adapterArg(context.args['source']);
+        const commitProvided = context.rawArgs.includes('--commit');
+        const pushProvided = context.rawArgs.includes('--push');
+        const flags = {
+            source: options.source ?? positionalSource,
+            output: options.output,
+            packagePath: options.packageFile,
+            auxiliaryPaths: options.auxiliary,
+            jsrPath: options.jsrFile,
+            tagTemplate: options.tagTemplate,
+            name: options.name,
+            prereleaseId: options.preid,
+            commit: commitProvided ? options.commit : undefined,
+            push: pushProvided ? options.push : undefined,
+        };
+        const interactive = isInteractiveInit(options);
+        const prompter = interactive ? createReadlineInitPrompter() : undefined;
+        try {
+            const answers = await resolveInitAnswers(flags, cwd, prompter);
+            const path = await writeInitConfigFromAnswers(answers, cwd, Boolean(options.yes));
+            process.stdout.write(reportValue(`created ${path}`, options.format));
+        }
+        finally {
+            await prompter?.close();
+        }
     },
 });
 const createConfigCommand = () => defineCommand({
@@ -292,16 +323,26 @@ const cliOptions = (rawArgs, args) => {
         output: parsed.output ?? outputArg(args['output']),
         packageFile: parsed.packageFile ?? stringArg(args['packageFile']),
         jsrFile: parsed.jsrFile ?? stringArg(args['jsrFile']),
+        auxiliary: parsed.auxiliary ?? outputListArg(args['auxiliary']),
+        tagTemplate: parsed.tagTemplate ?? stringArg(args['tagTemplate']),
+        name: parsed.name ?? stringArg(args['name']),
         preid: parsed.preid ?? stringArg(args['preid']),
         dryRun: parsed.dryRun || args['dryRun'] === true,
         commit: parsed.commit || args['commit'] === true,
         push: parsed.push || args['push'] === true,
         allowDirty: parsed.allowDirty || args['allowDirty'] === true,
+        nonInteractive: parsed.nonInteractive || args['nonInteractive'] === true,
         yes: parsed.yes || args['yes'] === true,
         verbose: parsed.verbose || args['verbose'] === true,
     };
 };
 const stringArg = (value) => (typeof value === 'string' ? value : undefined);
+const outputListArg = (value) => {
+    if (typeof value !== 'string')
+        return undefined;
+    const values = value.split(',').map((item) => item.trim()).filter(Boolean);
+    return values.length > 0 ? values : undefined;
+};
 const adapterArg = (value) => {
     if (value === 'package.json' || value === 'jsr.json' || value === 'git')
         return value;

package/library/config.d.ts

@@ -1,14 +1,18 @@
 /**
  * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
  */
-import type { MirrorAdapterName, MirrorCliOptions, MirrorConfig, MirrorConfigDiscovery, MirrorRawConfig } from './types.js';
+import type { MirrorAdapterName, MirrorCliOptions, MirrorConfig, MirrorConfigDiscovery, MirrorInitAnswers, MirrorRawConfig } from './types.js';
 export declare const resolveMirrorPath: (cwd: string, path: string) => string;
 export declare const relativeFromCwd: (cwd: string, path: string) => string;
 export declare const discoverMirrorConfig: (cwd: string, explicitPath?: string) => Promise<MirrorConfigDiscovery>;
 export declare const readConfigFile: (path: string) => Promise<MirrorRawConfig>;
 export declare const loadMirrorConfig: (options?: MirrorCliOptions) => Promise<MirrorConfig>;
 export declare const normalizeMirrorConfig: (raw: MirrorRawConfig, cwd: string, configPath: string | undefined, options?: MirrorCliOptions) => MirrorConfig;
+export declare const defaultInitAnswersForSource: (kind: MirrorAdapterName, cwd: string) => MirrorInitAnswers;
+export declare const generateInitConfig: (answers: MirrorInitAnswers, cwd: string) => string;
 export declare const createInitConfig: (kind: MirrorAdapterName, cwd: string) => string;
 export declare const writeInitConfig: (kind: MirrorAdapterName, cwd: string, overwrite?: boolean) => Promise<string>;
+export declare const writeInitConfigFromAnswers: (answers: MirrorInitAnswers, cwd: string, overwrite?: boolean) => Promise<string>;
+export declare const reconcileInitConfig: (existingContent: string, defaultsContent: string) => string;
 export declare const configPathForDisplay: (config: MirrorConfig) => string;
 //# sourceMappingURL=config.d.ts.map

package/library/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../source/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EAErB,eAAe,EAChB,MAAM,YAAY,CAAA;AAMnB,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,WAAmD,CAAA;AAE9G,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,WAGxD,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAU,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,qBAAqB,CAa5G,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,eAAe,CAe1E,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAU,UAAS,gBAAqB,KAAG,OAAO,CAAC,YAAY,CAO3F,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,YAAY,MAAM,GAAG,SAAS,EAC9B,UAAS,gBAAqB,KAC7B,YAuDF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,iBAAiB,EAAE,KAAK,MAAM,WAuFpE,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,MAAM,iBAAiB,EAAE,KAAK,MAAM,EAAE,mBAAiB,oBAO5F,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,QAAQ,YAAY,WAAoF,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../source/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EAEjB,eAAe,EAChB,MAAM,YAAY,CAAA;AAOnB,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,WAAmD,CAAA;AAE9G,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,WAGxD,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAU,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,qBAAqB,CAa5G,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,eAAe,CAe1E,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAU,UAAS,gBAAqB,KAAG,OAAO,CAAC,YAAY,CAO3F,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,YAAY,MAAM,GAAG,SAAS,EAC9B,UAAS,gBAAqB,KAC7B,YAyDF,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,MAAM,iBAAiB,EAAE,KAAK,MAAM,KAAG,iBAWjF,CAAA;AAEF,eAAO,MAAM,kBAAkB,GAAI,SAAS,iBAAiB,EAAE,KAAK,MAAM,WAsCzE,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,iBAAiB,EAAE,KAAK,MAAM,WAAoE,CAAA;AAEzI,eAAO,MAAM,eAAe,GAAU,MAAM,iBAAiB,EAAE,KAAK,MAAM,EAAE,mBAAiB,oBACT,CAAA;AAEpF,eAAO,MAAM,0BAA0B,GAAU,SAAS,iBAAiB,EAAE,KAAK,MAAM,EAAE,mBAAiB,oBAW1G,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,iBAAiB,MAAM,EAAE,iBAAiB,MAAM,WAyBnF,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,QAAQ,YAAY,WAAoF,CAAA"}

package/library/config.js

@@ -6,6 +6,7 @@ import { readFile, writeFile } from 'node:fs/promises';
 import { basename, isAbsolute, join, relative, resolve } from 'node:path';
 import { parse as parseToml } from 'smol-toml';
 import { MirrorError } from './errors.js';
+import { mirrorConfigSchemaReference } from './schema.js';
 const adapters = new Set(['package.json', 'jsr.json', 'git']);
 const projectNameSources = new Set(['package.json', 'jsr.json']);
 export const resolveMirrorPath = (cwd, path) => (isAbsolute(path) ? path : resolve(cwd, path));
@@ -62,6 +63,7 @@ export const normalizeMirrorConfig = (raw, cwd, configPath, options = {}) => {
     const projectName = optionalString(raw.project?.name, 'project.name');
     const prereleaseId = options.preid ?? optionalString(raw.version?.prerelease_id, 'version.prerelease_id') ?? '';
     const packagePath = options.packageFile ?? optionalString(raw.package?.path, 'package.path') ?? 'package.json';
+    const packageAuxiliaryPaths = assertStringArray(raw.package?.auxiliary_paths, 'package.auxiliary_paths');
     const jsrPath = options.jsrFile ?? optionalString(raw.jsr?.path, 'jsr.path') ?? 'jsr.json';
     const tagTemplate = optionalString(raw.git?.tag_template, 'git.tag_template') ?? 'v{version}';
     const gitCommit = optionalBoolean(raw.git?.commit, 'git.commit') === true;
@@ -87,6 +89,7 @@ export const normalizeMirrorConfig = (raw, cwd, configPath, options = {}) => {
         },
         package: {
             path: packagePath,
+            auxiliaryPaths: packageAuxiliaryPaths,
         },
         jsr: {
             path: jsrPath,
@@ -105,98 +108,90 @@ export const normalizeMirrorConfig = (raw, cwd, configPath, options = {}) => {
         },
     };
 };
-export const createInitConfig = (kind, cwd) => {
-    const projectName = basename(cwd);
-    if (kind === 'package.json') {
-        return `schema = 1
-
-[project]
-name_source = "package.json"
-
-[version]
-scheme = "semver"
-source = "package.json"
-output = ["package.json"]
-prerelease_id = ""
-
-[package]
-path = "package.json"
-
-[jsr]
-path = "jsr.json"
-
-[git]
-tag_template = "{name}@{version}"
-commit = false
-push = false
-allow_dirty = false
-
-[agents]
-write_changelog = true
-changelog_path = "CHANGELOG.md"
-auto_agents_md = true
-auto_skill_install = true
-`;
-    }
-    if (kind === 'jsr.json') {
-        return `schema = 1
-
-[project]
-name_source = "jsr.json"
-
-[version]
-scheme = "semver"
-source = "jsr.json"
-output = ["jsr.json"]
-prerelease_id = ""
-
-[jsr]
-path = "jsr.json"
-
-[git]
-tag_template = "{name}@{version}"
-commit = false
-push = false
-allow_dirty = false
-
-[agents]
-write_changelog = true
-changelog_path = "CHANGELOG.md"
-auto_agents_md = true
-auto_skill_install = true
-`;
-    }
-    return `schema = 1
-
-[project]
-name = "${projectName}"
-
-[version]
-scheme = "semver"
-source = "git"
-output = ["git"]
-prerelease_id = ""
-
-[git]
-tag_template = "v{version}"
-commit = false
-push = false
-allow_dirty = false
-
-[agents]
-write_changelog = true
-changelog_path = "CHANGELOG.md"
-auto_agents_md = true
-auto_skill_install = true
-`;
-};
-export const writeInitConfig = async (kind, cwd, overwrite = false) => {
+export const defaultInitAnswersForSource = (kind, cwd) => ({
+    source: kind,
+    output: kind === 'git' ? ['git'] : [kind, 'git'],
+    packagePath: 'package.json',
+    auxiliaryPaths: [],
+    jsrPath: 'jsr.json',
+    name: kind === 'git' ? basename(cwd) : undefined,
+    prereleaseId: '',
+    tagTemplate: '{name}@{version}',
+    commit: kind !== 'git',
+    push: false,
+});
+export const generateInitConfig = (answers, cwd) => {
+    const lines = [];
+    lines.push(`#:schema ${mirrorConfigSchemaReference}`);
+    lines.push('');
+    lines.push('schema = 1');
+    lines.push('');
+    lines.push('[project]');
+    if (answers.source === 'package.json')
+        lines.push('name_source = "package.json"');
+    else if (answers.source === 'jsr.json')
+        lines.push('name_source = "jsr.json"');
+    else
+        lines.push(`name = "${answers.name ?? basename(cwd)}"`);
+    lines.push('');
+    lines.push('[version]');
+    lines.push('scheme = "semver"');
+    lines.push(`source = "${answers.source}"`);
+    lines.push(`output = [${answers.output.map((value) => `"${value}"`).join(', ')}]`);
+    lines.push(`prerelease_id = "${answers.prereleaseId}"`);
+    lines.push('');
+    lines.push('[package]');
+    lines.push(`path = "${answers.packagePath}"`);
+    lines.push(`auxiliary_paths = [${answers.auxiliaryPaths.map((value) => `"${value}"`).join(', ')}]`);
+    lines.push('');
+    lines.push('[jsr]');
+    lines.push(`path = "${answers.jsrPath}"`);
+    lines.push('');
+    lines.push('[git]');
+    lines.push(`tag_template = "${answers.tagTemplate}"`);
+    lines.push(`commit = ${String(answers.commit)}`);
+    lines.push(`push = ${String(answers.push)}`);
+    lines.push('allow_dirty = false');
+    lines.push('');
+    lines.push('[agents]');
+    lines.push('write_changelog = true');
+    lines.push('changelog_path = "CHANGELOG.md"');
+    lines.push('auto_agents_md = true');
+    lines.push('auto_skill_install = true');
+    return `${lines.join('\n')}\n`;
+};
+export const createInitConfig = (kind, cwd) => generateInitConfig(defaultInitAnswersForSource(kind, cwd), cwd);
+export const writeInitConfig = async (kind, cwd, overwrite = false) => writeInitConfigFromAnswers(defaultInitAnswersForSource(kind, cwd), cwd, overwrite);
+export const writeInitConfigFromAnswers = async (answers, cwd, overwrite = false) => {
     const path = join(cwd, 'mirror.config.toml');
-    if (existsSync(path) && !overwrite)
-        throw new MirrorError(`Configuration already exists: ${path}`);
-    await writeFile(path, createInitConfig(kind, cwd), 'utf8');
+    const generated = generateInitConfig(answers, cwd);
+    if (existsSync(path) && !overwrite) {
+        await writeFile(path, reconcileInitConfig(await readFile(path, 'utf8'), generated), 'utf8');
+        return path;
+    }
+    await writeFile(path, generated, 'utf8');
     return path;
 };
+export const reconcileInitConfig = (existingContent, defaultsContent) => {
+    const existingRaw = parseConfigContent(existingContent, 'existing configuration');
+    const defaultsRaw = parseConfigContent(defaultsContent, 'default configuration');
+    const additions = [];
+    for (const [sectionName, defaultSection] of Object.entries(defaultsRaw)) {
+        if (!isRecord(defaultSection))
+            continue;
+        const existingSection = existingRaw[sectionName];
+        if (!isRecord(existingSection)) {
+            additions.push(renderTomlSection(sectionName, defaultSection));
+            continue;
+        }
+        const missingValues = Object.fromEntries(Object.entries(defaultSection).filter(([key]) => existingSection[key] === undefined));
+        if (Object.keys(missingValues).length > 0)
+            existingContent = insertTomlValuesIntoSection(existingContent, sectionName, missingValues);
+    }
+    if (additions.length === 0)
+        return existingContent;
+    return `${existingContent.trimEnd()}\n\n${additions.join('\n\n')}\n`;
+};
 export const configPathForDisplay = (config) => (config.configPath ? relativeFromCwd(config.cwd, config.configPath) : '(none)');
 const assertAdapter = (value, key) => {
     if (typeof value !== 'string' || !adapters.has(value))
@@ -213,6 +208,17 @@ const assertOutput = (value) => {
         throw new MirrorError('Invalid or missing version.output. Expected at least one output adapter.');
     return value.map((item) => assertAdapter(item, 'version.output'));
 };
+const assertStringArray = (value, key) => {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        throw new MirrorError(`Invalid ${key}. Expected an array of strings.`);
+    return value.map((item) => {
+        if (typeof item !== 'string' || item.length === 0)
+            throw new MirrorError(`Invalid ${key}. Expected an array of strings.`);
+        return item;
+    });
+};
 const dedupeAdapters = (value) => [...new Set(value)];
 const optionalString = (value, key) => {
     if (value === undefined)
@@ -229,3 +235,43 @@ const optionalBoolean = (value, key) => {
     return value;
 };
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const parseConfigContent = (content, label) => {
+    let parsed;
+    try {
+        parsed = parseToml(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new MirrorError(`Invalid TOML in ${label}:\n${message}`);
+    }
+    if (!isRecord(parsed))
+        throw new MirrorError(`Invalid ${label}. Expected a TOML object.`);
+    return parsed;
+};
+const renderTomlSection = (sectionName, values) => {
+    const lines = [`[${sectionName}]`];
+    for (const [key, value] of Object.entries(values)) {
+        lines.push(`${key} = ${renderTomlValue(value)}`);
+    }
+    return lines.join('\n');
+};
+const insertTomlValuesIntoSection = (content, sectionName, values) => {
+    const lines = content.split(/\r?\n/);
+    const sectionIndex = lines.findIndex((line) => line.trim() === `[${sectionName}]`);
+    if (sectionIndex === -1)
+        return `${content.trimEnd()}\n\n${renderTomlSection(sectionName, values)}\n`;
+    const nextSectionIndex = lines.findIndex((line, index) => index > sectionIndex && /^\[[^\]]+]\s*$/.test(line.trim()));
+    const insertIndex = nextSectionIndex === -1 ? lines.length : nextSectionIndex;
+    const renderedValues = Object.entries(values).map(([key, value]) => `${key} = ${renderTomlValue(value)}`);
+    lines.splice(insertIndex, 0, ...renderedValues);
+    return lines.join('\n');
+};
+const renderTomlValue = (value) => {
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (Array.isArray(value))
+        return `[${value.map(renderTomlValue).join(', ')}]`;
+    throw new MirrorError('Cannot render unsupported init configuration value.');
+};

package/library/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../source/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAMzE,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,EAAE,UAAS,gBAAqB,KAAG,OAAO,CAAC,qBAAqB,CAIpH,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,MAAM,qBAAqB,CAAC,MAAM,CAAC,EACnC,UAAS,gBAAqB,KAC7B,OAAO,CAAC,qBAAqB,CAmB/B,CAAA"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../source/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAKzE,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,EAAE,UAAS,gBAAqB,KAAG,OAAO,CAAC,qBAAqB,CAIpH,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,MAAM,qBAAqB,CAAC,MAAM,CAAC,EACnC,UAAS,gBAAqB,KAC7B,OAAO,CAAC,qBAAqB,CAgB/B,CAAA"}