@guiho/mirror 3.1.2 → 3.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@guiho/mirror",
   "description": "Open source project versioning for Bun, npm, JSR, and Git.",
-  "version": "3.1.2",
+  "version": "3.2.0",
   "type": "module",
   "main": "./library/guiho-mirror.js",
   "types": "./library/guiho-mirror.d.ts",
@@ -18,6 +18,7 @@
     "README.md",
     "library/",
     "skills/",
+    "schema/",
     "docs/",
     "jsr.json",
     "CHANGELOG.md",

package/schema/mirror.config.schema.json

@@ -0,0 +1,148 @@
+{
+  "$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."
+        }
+      }
+    }
+  }
+}

package/skills/guiho-as-mirror/SKILL.md

@@ -101,13 +101,14 @@ When the user asks to set up Mirror in a project:
    - Use `package.json` for npm/Bun package versioning.
    - Use `jsr.json` for JSR package versioning.
    - Use `git` when tags are the source of truth.
-2. Run one of:
-   - `<mirror> init package.json`
-   - `<mirror> init jsr.json`
-   - `<mirror> init git`
-3. Review `mirror.config.toml` with the user if outputs, tag templates, commits, or pushes need customization.
-4. Validate with `<mirror> config check` and inspect with `<mirror> config show`.
-5. Run `<mirror> version current` and a harmless `<mirror> version plan patch` to confirm the lifecycle works.
+2. Run `<mirror> init` (interactive wizard) or pass flags to answer non-interactively.
+   - `<mirror> init package.json`, `<mirror> init jsr.json`, or `<mirror> init git` set the source directly.
+   - Flags: `--source`, `--output`, `--package-file`, `--jsr-file`, `--auxiliary`, `--tag-template`, `--name`, `--preid`, `--commit`, `--push`, `--non-interactive`, `--yes`.
+   - Defaults are source `package.json` and outputs `package.json` + `git`. For agents and CI, always pass flags or `--non-interactive` so init never waits for prompts.
+3. If `mirror.config.toml` already exists, `init` reconciles missing defaults without overwriting user-configured values.
+4. Review `mirror.config.toml` with the user if outputs, auxiliary package paths, tag templates, commits, or pushes need customization.
+5. Validate with `<mirror> config check` and inspect with `<mirror> config show`.
+6. Run `<mirror> version current` and a harmless `<mirror> version plan patch` to confirm the lifecycle works.
 
 ## Configuration Reference
 
@@ -128,6 +129,7 @@ prerelease_id = "alpha"
 
 [package]
 path = "package.json"
+auxiliary_paths = []
 
 [jsr]
 path = "jsr.json"
@@ -147,6 +149,8 @@ auto_skill_install = true
 
 Supported version sources and outputs are `package.json`, `jsr.json`, and `git`. Supported Git tag templates are `v{version}`, `{name}@{version}`, and `{name}/v{version}`.
 
+Use `[package].auxiliary_paths` for extra package.json files that should mirror the main package version when `package.json` is in `[version].output`.
+
 Agent automation options default to true. Set `write_changelog = false` to tell agents to skip changelog edits, `changelog_path = "docs/CHANGELOG.md"` to specify the changelog file, `auto_agents_md = false` to stop Mirror from inserting its AGENTS.md section, and `auto_skill_install = false` to stop Mirror from installing `guiho-as-mirror` globally when missing.
 
 ## CLI Reference
@@ -154,12 +158,14 @@ Agent automation options default to true. Set `write_changelog = false` to tell
 Common commands:
 
 ```bash
+mirror init
 mirror init package.json
 mirror init jsr.json
 mirror init git
 mirror config show
 mirror config check
 mirror config schema
+mirror config schema --format json
 mirror agents install local
 mirror agents install global
 mirror agents instructions