@guiho/mirror 3.2.0 → 3.3.0-alpha.1

package/schema/mirror.config.schema.json

@@ -143,6 +143,237 @@
           "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": {
+        "before_everything": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the before:everything lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the before:everything lifecycle point."
+            }
+          ]
+        },
+        "after_everything": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the after:everything lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the after:everything lifecycle point."
+            }
+          ]
+        },
+        "before_plan": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the before:plan lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the before:plan lifecycle point."
+            }
+          ]
+        },
+        "after_plan": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the after:plan lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the after:plan lifecycle point."
+            }
+          ]
+        },
+        "before_apply": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the before:apply lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the before:apply lifecycle point."
+            }
+          ]
+        },
+        "after_apply": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the after:apply lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the after:apply lifecycle point."
+            }
+          ]
+        },
+        "before_write": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the before:write lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the before:write lifecycle point."
+            }
+          ]
+        },
+        "after_write": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the after:write lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the after:write lifecycle point."
+            }
+          ]
+        },
+        "before_commit": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the before:commit lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the before:commit lifecycle point."
+            }
+          ]
+        },
+        "after_commit": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the after:commit lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the after:commit lifecycle point."
+            }
+          ]
+        },
+        "before_tag": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the before:tag lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the before:tag lifecycle point."
+            }
+          ]
+        },
+        "after_tag": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the after:tag lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the after:tag lifecycle point."
+            }
+          ]
+        },
+        "before_push": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the before:push lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the before:push lifecycle point."
+            }
+          ]
+        },
+        "after_push": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "A single shell command to run at the after:push lifecycle point."
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Multiple shell commands to run sequentially at the after:push lifecycle point."
+            }
+          ]
+        }
+      }
     }
   }
 }

package/scripts/install-package.ts

@@ -0,0 +1,70 @@
+#!/usr/bin/env bun
+/**
+ * Package-manager install helper for GUIHO Mirror.
+ *
+ * This script uses Bun APIs only. It downloads the platform-native Mirror binary
+ * into `vendor/mirror`. Package-manager installs use the small Bun launcher in
+ * `scripts/mirror-bin.ts`; direct installers remain the no-Bun runtime path.
+ */
+
+type PackageJson = {
+  version?: string
+  repository?: string | { url?: string }
+}
+
+const packageJson = await Bun.file(new URL('../package.json', import.meta.url)).json() as PackageJson
+const sourceEntrypoint = Bun.file(new URL('../source/guiho-mirror-bin.ts', import.meta.url))
+
+if (await sourceEntrypoint.exists()) {
+  console.log('source checkout detected; skipping native binary download')
+  process.exit(0)
+}
+
+const version = process.env['MIRROR_VERSION'] ?? packageJson.version ?? 'latest'
+const repo = process.env['MIRROR_REPO'] ?? 'CGuiho/mirror'
+const asset = detectAsset()
+const bundledAsset = Bun.file(new URL(`../bin/${asset}`, import.meta.url))
+const destination = new URL('../vendor/mirror', import.meta.url)
+
+if (await bundledAsset.exists()) {
+  await Bun.write(destination, bundledAsset)
+  console.log(`installed bundled GUIHO Mirror native binary: ${asset}`)
+  process.exit(0)
+}
+
+const tag = version === 'latest' ? 'latest' : `@guiho/mirror@${version}`
+const url = tag === 'latest'
+  ? `https://github.com/${repo}/releases/latest/download/${asset}`
+  : `https://github.com/${repo}/releases/download/${encodeURIComponent(tag)}/${asset}`
+
+const response = await fetch(url)
+
+if (!response.ok) {
+  console.error(`error: failed to download ${url}`)
+  console.error(`status: ${response.status} ${response.statusText}`)
+  process.exit(1)
+}
+
+await Bun.write(destination, response)
+console.log(`installed GUIHO Mirror native binary: ${asset}`)
+
+function detectAsset() {
+  const os = detectOs()
+  const arch = detectArch()
+  return `guiho-mirror-${os}-${arch}${os === 'windows' ? '.exe' : ''}`
+}
+
+function detectOs() {
+  if (process.platform === 'linux') return 'linux'
+  if (process.platform === 'darwin') return 'macos'
+  if (process.platform === 'win32') return 'windows'
+  console.error(`error: unsupported OS: ${process.platform}`)
+  process.exit(1)
+}
+
+function detectArch() {
+  if (process.arch === 'x64') return 'x64'
+  if (process.arch === 'arm64') return 'arm64'
+  console.error(`error: unsupported architecture: ${process.arch}`)
+  process.exit(1)
+}

package/scripts/mirror-bin.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env bun
+/**
+ * Small package-manager launcher for the downloaded native Mirror binary.
+ */
+
+const binaryPath = new URL('../vendor/mirror', import.meta.url)
+const binary = Bun.file(binaryPath)
+
+if (!(await binary.exists())) {
+  console.error('error: GUIHO Mirror native binary is missing. Reinstall @guiho/mirror or run `bun run scripts/install-package.ts`.')
+  process.exit(1)
+}
+
+const proc = Bun.spawn([binaryPath.pathname, ...process.argv.slice(2)], {
+  stdin: 'inherit',
+  stdout: 'inherit',
+  stderr: 'inherit',
+})
+
+process.exit(await proc.exited)

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

@@ -5,7 +5,7 @@ description: Use this skill whenever the user asks to version, bump, release, ta
 
 # GUIHO Mirror
 
-GUIHO Mirror is a deterministic CLI and TypeScript library for semantic project versioning. It reads one version source, calculates the next semantic version, builds a transparent read-only plan, and applies the plan to configured outputs such as `package.json`, `jsr.json`, and Git tags.
+GUIHO Mirror is a deterministic CLI for semantic project versioning. It reads one version source, calculates the next semantic version, builds a transparent read-only plan, and applies the plan to configured outputs such as `package.json`, `jsr.json`, and Git tags.
 
 ```text
 source -> version engine -> plan -> outputs
@@ -23,7 +23,7 @@ Choose the Mirror command in this order:
 
 When unsure, run a cheap availability check (`bun @guiho/mirror --help`, `mirror --help`, or `bunx @guiho/mirror --help`) and then reuse the working command consistently. Run `mirror --help` or `mirror <command> --help` for command-specific details when needed.
 
-Mirror runs on Node >= 20 at runtime, Bun, and Deno. Bun is the recommended development tool for the Mirror project itself. Git is required only for Git-based workflows: `source = "git"`, `output = ["git"]`, commits, tags, or pushes.
+Mirror ships as a Bun-compiled native CLI binary. The installed `mirror` command should not require Node.js or Bun at runtime. Bun is required for Mirror project development and binary compilation. Git is required only for Git-based workflows: `source = "git"`, `output = ["git"]`, commits, tags, or pushes.
 
 ## Release Workflow
 
@@ -177,33 +177,6 @@ mirror version apply <target> --yes
 
 Supported targets are `major`, `premajor`, `minor`, `preminor`, `patch`, `prepatch`, `prerelease`, or an exact semantic version such as `2.0.0`.
 
-## TypeScript API
-
-When the user wants automation code rather than CLI usage, use the typed API:
-
-```ts
-import { applyVersionPlan, buildVersionPlan, executeVersionPlan } from '@guiho/mirror';
-
-const plan = await buildVersionPlan('patch', { cwd: process.cwd() });
-
-console.log(plan.currentVersion);
-console.log(plan.nextVersion);
-console.log(plan.actions);
-
-await executeVersionPlan(plan, { dryRun: false, yes: true });
-
-await applyVersionPlan('minor', { cwd: process.cwd(), yes: true });
-```
-
-For reading state:
-
-```ts
-import { loadMirrorConfig, readCurrentVersion } from '@guiho/mirror';
-
-const config = await loadMirrorConfig({ cwd: process.cwd() });
-const version = await readCurrentVersion(config);
-```
-
 ## Mirror Project Development
 
 When working inside the Mirror project repository itself, run development commands from the `mirror/` directory:

package/library/adapters.d.ts

@@ -1,32 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorConfig, MirrorJsonObject } from './types.js';
-export declare const ensureGitAvailable: () => Promise<void>;
-export declare const supportedGitTagTemplates: readonly ["v{version}", "{name}@{version}", "{name}/v{version}"];
-export declare const readPackageJson: (path: string) => Promise<MirrorJsonObject>;
-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>;
-export declare const readGitVersion: (config: MirrorConfig, projectName?: string) => Promise<string>;
-export declare const renderGitTag: (template: string, version: string, projectName?: string) => string;
-export declare const versionFromTag: (template: string, tag: string, projectName?: string) => string | undefined;
-export declare const assertSupportedGitTagTemplate: (template: string) => void;
-export declare const isGitRepository: (cwd: string) => Promise<boolean>;
-export declare const isGitDirty: (cwd: string) => Promise<boolean>;
-export declare const createGitCommit: (cwd: string, paths: string[], message: string) => Promise<void>;
-export declare const createGitTag: (cwd: string, tag: string) => Promise<void>;
-export declare const pushGitRefs: (cwd: string, includeCommit: boolean, includeTags: boolean) => Promise<void>;
-//# sourceMappingURL=adapters.d.ts.map

package/library/adapters.d.ts.map

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

@@ -1,210 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import { execFile } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { readFile, writeFile } from 'node:fs/promises';
-import { promisify } from 'node:util';
-import { MirrorError } from './errors.js';
-import { assertValidSemver, sortSemverDescending } from './version.js';
-import { resolveMirrorPath } from './config.js';
-const execFileAsync = promisify(execFile);
-let gitChecked = false;
-let gitExists = false;
-const checkGitAvailable = async () => {
-    if (gitChecked)
-        return gitExists;
-    gitChecked = true;
-    try {
-        await execFileAsync('git', ['--version']);
-        gitExists = true;
-    }
-    catch {
-        gitExists = false;
-    }
-    return gitExists;
-};
-export const ensureGitAvailable = async () => {
-    if (!(await checkGitAvailable())) {
-        throw new MirrorError('Git executable not found. Git is required when using git as a source or output.');
-    }
-};
-const gitNotFoundMessage = 'Git executable not found. Git is required when using git as a source or output.';
-const runGit = async (cwd, args) => {
-    if (!(await checkGitAvailable())) {
-        throw new MirrorError(gitNotFoundMessage);
-    }
-    try {
-        const { stdout } = await execFileAsync('git', args, { cwd });
-        return stdout;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new MirrorError(`Git command failed: git ${args.join(' ')}\n${message}`);
-    }
-};
-export const supportedGitTagTemplates = ['v{version}', '{name}@{version}', '{name}/v{version}'];
-export const readPackageJson = async (path) => readJsonObject(path, 'package.json');
-export const readJsrJson = async (path) => readJsonObject(path, 'jsr.json');
-export const writeJsonObject = async (path, object) => {
-    await writeFile(path, `${JSON.stringify(object, null, 2)}\n`, 'utf8');
-};
-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')) {
-        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'))
-        await ensureGitRepository(config.cwd);
-};
-export const resolveProjectName = async (config) => {
-    if (config.project.name)
-        return config.project.name;
-    if (config.project.nameSource === 'package.json')
-        return readPackageName(config);
-    if (config.project.nameSource === 'jsr.json')
-        return readJsrName(config);
-    return undefined;
-};
-export const readCurrentVersion = async (config, projectName) => {
-    if (config.version.source === 'package.json')
-        return readPackageVersion(config);
-    if (config.version.source === 'jsr.json')
-        return readJsrVersion(config);
-    return readGitVersion(config, projectName);
-};
-export const readGitVersion = async (config, projectName) => {
-    await ensureGitAvailable();
-    await ensureGitRepository(config.cwd);
-    const tagsOutput = await runGit(config.cwd, ['-C', config.cwd, 'tag', '--list']);
-    const versions = tagsOutput
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean)
-        .map((tag) => versionFromTag(config.git.tagTemplate, tag, projectName))
-        .filter((version) => Boolean(version));
-    if (versions.length === 0)
-        throw new MirrorError(`No Git tags match template: ${config.git.tagTemplate}`);
-    return sortSemverDescending(versions)[0] ?? '';
-};
-export const renderGitTag = (template, version, projectName) => {
-    assertSupportedGitTagTemplate(template);
-    assertValidSemver(version, 'Git tag version');
-    if (template.includes('{name}') && !projectName)
-        throw new MirrorError(`Tag template requires a project name: ${template}`);
-    return template.replaceAll('{version}', version).replaceAll('{name}', projectName ?? '');
-};
-export const versionFromTag = (template, tag, projectName) => {
-    assertSupportedGitTagTemplate(template);
-    if (template.includes('{name}') && !projectName)
-        throw new MirrorError(`Tag template requires a project name: ${template}`);
-    const escapedTemplate = escapeRegex(template)
-        .replaceAll('\\{version\\}', '(?<version>.+)')
-        .replaceAll('\\{name\\}', escapeRegex(projectName ?? ''));
-    const match = new RegExp(`^${escapedTemplate}$`).exec(tag);
-    const version = match?.groups?.['version'];
-    if (!version)
-        return undefined;
-    try {
-        assertValidSemver(version, 'Git tag version');
-        return version;
-    }
-    catch {
-        return undefined;
-    }
-};
-export const assertSupportedGitTagTemplate = (template) => {
-    if (!supportedGitTagTemplates.includes(template)) {
-        throw new MirrorError(`Unsupported Git tag template: ${template}. Expected v{version}, {name}@{version}, or {name}/v{version}.`);
-    }
-};
-export const isGitRepository = async (cwd) => {
-    if (!(await checkGitAvailable()))
-        return false;
-    try {
-        await execFileAsync('git', ['-C', cwd, 'rev-parse', '--is-inside-work-tree']);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-export const isGitDirty = async (cwd) => {
-    const output = await runGit(cwd, ['-C', cwd, 'status', '--porcelain']);
-    return output.trim().length > 0;
-};
-export const createGitCommit = async (cwd, paths, message) => {
-    await ensureGitAvailable();
-    for (const path of paths)
-        await runGit(cwd, ['-C', cwd, 'add', path]);
-    await runGit(cwd, ['-C', cwd, 'commit', '-m', message]);
-};
-export const createGitTag = async (cwd, tag) => {
-    await ensureGitAvailable();
-    await runGit(cwd, ['-C', cwd, 'tag', tag, '-m', `Release ${tag}`]);
-};
-export const pushGitRefs = async (cwd, includeCommit, includeTags) => {
-    await ensureGitAvailable();
-    if (includeCommit)
-        await runGit(cwd, ['-C', cwd, 'push']);
-    if (includeTags)
-        await runGit(cwd, ['-C', cwd, 'push', '--tags']);
-};
-const readJsonObject = async (path, label) => {
-    ensureFile(path, label);
-    const content = await readFile(path, 'utf8');
-    let json;
-    try {
-        json = JSON.parse(content);
-    }
-    catch {
-        throw new MirrorError(`${label} must contain valid JSON: ${path}`);
-    }
-    if (typeof json !== 'object' || json === null || Array.isArray(json))
-        throw new MirrorError(`${label} must contain a JSON object: ${path}`);
-    return json;
-};
-const readVersionField = async (path, label) => {
-    const json = await readJsonObject(path, label);
-    const version = json['version'];
-    if (typeof version !== 'string')
-        throw new MirrorError(`${label} must contain a string version field: ${path}`);
-    assertValidSemver(version, `${label} version`);
-    return version;
-};
-const readNameField = async (path, label) => {
-    const json = await readJsonObject(path, label);
-    const name = json['name'];
-    if (typeof name !== 'string' || name.length === 0)
-        throw new MirrorError(`${label} must contain a string name field: ${path}`);
-    return name;
-};
-const writeVersionField = async (path, label, nextVersion) => {
-    const json = await readJsonObject(path, label);
-    json['version'] = nextVersion;
-    await writeJsonObject(path, json);
-};
-const ensureFile = (path, label) => {
-    if (!existsSync(path))
-        throw new MirrorError(`${label} file not found: ${path}`);
-};
-const ensureGitRepository = async (cwd) => {
-    await ensureGitAvailable();
-    if (!(await isGitRepository(cwd)))
-        throw new MirrorError(`Not a Git repository: ${cwd}`);
-};
-const usesAdapter = (config, adapter) => config.version.source === adapter || config.version.output.includes(adapter);
-const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');

package/library/agents.d.ts

@@ -1,27 +0,0 @@
-/**
- * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
- */
-import type { MirrorAgentAutomationResult, MirrorAgentSettings, MirrorAgentsInstructionsResult, MirrorCliOptions, MirrorSkillInstallResult, MirrorSkillInstallScope } from './types.js';
-export declare const mirrorSkillName = "guiho-as-mirror";
-export declare const mirrorAgentsSectionHeading = "## Semantic Project Versioning -- GUIHO Mirror";
-export declare const defaultMirrorAgentSettings: MirrorAgentSettings;
-export declare const mirrorAgentsSection = "## Semantic Project Versioning -- GUIHO Mirror\n\nInvoke the guiho-as-mirror agent skill every time the user wants to bump, tag, release, plan, initialize, configure, or troubleshoot semantic project versioning with GUIHO Mirror.\n\nBefore editing release docs or changelogs, inspect mirror.config.toml. If [agents].write_changelog is false, skip changelog edits. If it is missing or true, changelog edits are allowed when the project has a changelog.\n\nUse [agents].changelog_path as the changelog file path. If it is missing, use CHANGELOG.md in the project root.\n";
-type MirrorSkillPathOptions = {
-    cwd?: string;
-    homeDirectory?: string;
-};
-type MirrorSkillInstallOptions = MirrorSkillPathOptions & {
-    overwrite?: boolean;
-};
-type MirrorAgentAutomationOptions = MirrorCliOptions & {
-    homeDirectory?: string;
-};
-export declare const resolveMirrorSkillPath: (scope: MirrorSkillInstallScope, options?: MirrorSkillPathOptions) => string;
-export declare const isMirrorSkillInstalled: (scope: MirrorSkillInstallScope, options?: MirrorSkillPathOptions) => boolean;
-export declare const installMirrorSkill: (scope: MirrorSkillInstallScope, options?: MirrorSkillInstallOptions) => Promise<MirrorSkillInstallResult>;
-export declare const ensureMirrorAgentsInstructions: (cwd: string, create?: boolean) => Promise<MirrorAgentsInstructionsResult>;
-export declare const findAgentsFile: (cwd: string) => string | undefined;
-export declare const resolveMirrorAgentSettings: (options?: MirrorCliOptions) => Promise<MirrorAgentSettings>;
-export declare const runMirrorAgentAutomation: (options?: MirrorAgentAutomationOptions, notify?: (message: string) => void) => Promise<MirrorAgentAutomationResult>;
-export {};
-//# sourceMappingURL=agents.d.ts.map

package/library/agents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../source/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,eAAe,oBAAoB,CAAA;AAChD,eAAO,MAAM,0BAA0B,mDAAmD,CAAA;AAE1F,eAAO,MAAM,0BAA0B,EAAE,mBAKxC,CAAA;AAED,eAAO,MAAM,mBAAmB,6jBAO/B,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,KAAK,yBAAyB,GAAG,sBAAsB,GAAG;IACxD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,KAAK,4BAA4B,GAAG,gBAAgB,GAAG;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,OAAO,uBAAuB,EAAE,UAAS,sBAA2B,WAI1G,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,OAAO,uBAAuB,EAAE,UAAS,sBAA2B,YACvD,CAAA;AAEpD,eAAO,MAAM,kBAAkB,GAC7B,OAAO,uBAAuB,EAC9B,UAAS,yBAA8B,KACtC,OAAO,CAAC,wBAAwB,CAelC,CAAA;AAED,eAAO,MAAM,8BAA8B,GAAU,KAAK,MAAM,EAAE,gBAAc,KAAG,OAAO,CAAC,8BAA8B,CAkBxH,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAWrD,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAU,UAAS,gBAAqB,KAAG,OAAO,CAAC,mBAAmB,CAa5G,CAAA;AAED,eAAO,MAAM,wBAAwB,GACnC,UAAS,4BAAiC,EAC1C,SAAQ,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,KAC3C,OAAO,CAAC,2BAA2B,CAkBrC,CAAA"}