@guiho/mirror 3.2.0 → 3.2.1

package/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.1] - 2026-06-09
+
+### Added
+
+- Added lifecycle hooks with before/after hook points around planning, applying, writing, committing, tagging, pushing, and the full execution flow.
+
+### Changed
+
+- Wrapped the generated Mirror `AGENTS.md` guidance in `BEGIN/END GUIHO MIRROR` markers that tell agents not to edit the Mirror-managed block.
+- Made Mirror AGENTS guidance detection whitespace-insensitive so markdown formatting that only adds or removes blank lines does not duplicate the section.
+- Updated hook tests to use the active Bun runtime instead of requiring a separate `node` binary on `PATH`.
+
 ## [3.2.0] - 2026-06-07
 
 ### Added

package/DOCS.md

@@ -204,7 +204,7 @@ mirror agents instructions
 
 - `install local`: Writes `.agents/skills/guiho-as-mirror/SKILL.md` in the project.
 - `install global`: Writes `~/.agents/skills/guiho-as-mirror/SKILL.md`.
-- `instructions`: Creates or updates `AGENTS.md` with the GUIHO Mirror semantic versioning section.
+- `instructions`: Creates or updates `AGENTS.md` with the protected GUIHO Mirror semantic versioning section.
 
 Global skill installation uses the user home directory. Tests and automation can override that home root with `MIRROR_AGENT_HOME`.
 
@@ -340,7 +340,7 @@ Automation is controlled by `[agents]`.
 - Disable changelog edits by agents with `write_changelog = false`.
 - Direct agents to the correct changelog with `changelog_path = "path/to/CHANGELOG.md"`.
 
-The generated AGENTS section instructs agents to invoke `guiho-as-mirror` for versioning work, inspect `mirror.config.toml`, respect `write_changelog`, and use `changelog_path` for changelog edits. Use `mirror agents install local` only when a project-local skill copy is desired explicitly.
+The generated AGENTS section is wrapped in `<!-- BEGIN GUIHO MIRROR - DO NOT EDIT THIS SECTION -->` and `<!-- END GUIHO MIRROR -->` markers so agents know the block is Mirror-managed. It instructs agents to invoke `guiho-as-mirror` for versioning work, inspect `mirror.config.toml`, respect `write_changelog`, and use `changelog_path` for changelog edits. Mirror detects the existing block with whitespace-insensitive matching so markdown formatting that only adds or removes blank lines does not duplicate the section. Use `mirror agents install local` only when a project-local skill copy is desired explicitly.
 
 ## Release Safety Rules
 
@@ -355,6 +355,110 @@ Mirror intentionally separates planning from mutation.
 
 `mirror version apply` refuses to mutate unless `--yes` is passed, unless `--dry-run` is used.
 
+## Lifecycle Hooks
+
+Mirror supports lifecycle hooks that run shell commands at defined points during `mirror version apply`. Hooks are configured in the `[hooks]` section of `mirror.config.toml`.
+
+### Lifecycle Tree
+
+```
+before:everything              # Runs once, before anything else
+  │
+  ├─ before:plan               # Runs before buildVersionPlan()
+  │    buildVersionPlan()      # Plan construction (read-only)
+  │    after:plan              # Runs after plan is built
+  │
+  ├─ before:apply              # Runs before executeVersionPlan()
+  │    │
+  │    ├─ before:write         # Runs before each file-write batch
+  │    │    write-file(s)      # Mutate package.json / jsr.json
+  │    │    after:write        # Runs after all file writes
+  │    │
+  │    ├─ before:commit        # Runs before git commit
+  │    │    git-commit         # git add + git commit
+  │    │    after:commit       # Runs after git commit
+  │    │
+  │    ├─ before:tag           # Runs before git tag
+  │    │    git-tag            # git tag -m "..."
+  │    │    after:tag          # Runs after git tag
+  │    │
+  │    ├─ before:push          # Runs before git push
+  │    │    git-push           # git push + git push --tags
+  │    │    after:push         # Runs after git push
+  │    │
+  │    after:apply             # Runs after executeVersionPlan() completes (always runs)
+  │
+  after:everything             # Runs once, after everything else (always runs)
+```
+
+### Hook Configuration
+
+```toml
+[hooks]
+before_everything = "npm run typecheck"
+after_everything  = "echo 'Release complete!'"
+
+before_plan = ["npm run lint", "npm run typecheck"]
+after_plan  = "echo 'Plan is ready'"
+
+before_apply = "npm run build"
+after_apply  = "node scripts/notify-release.js"
+
+before_write  = "echo 'Writing version files...'"
+after_write   = "echo 'Files written'"
+
+before_commit = ["npm run format", "echo 'Committing...'"]
+after_commit  = "echo 'Committed'"
+
+before_tag   = "echo 'Tagging release...'"
+after_tag    = "echo 'Tagged'"
+
+before_push  = "echo 'Pushing...'"
+after_push   = "echo 'Pushed'"
+```
+
+- Each hook key maps to a string (single command) or array of strings (multiple commands run sequentially).
+- Hook names use underscores (`before_everything`) in TOML, which normalizes to colon form (`before:everything`) internally.
+- Hook commands run in the project root directory through the default platform shell.
+- Action-level hooks (`before:write`, `before:commit`, `before:tag`, `before:push` and their `after:` variants) fire only when the corresponding action is part of the plan.
+- Hooks are skipped during `--dry-run`.
+
+### Hook Error Handling
+
+- When a hook exits with a non-zero code, Mirror stops the pipeline and reports the failure.
+- `after:apply` and `after:everything` always run, even when a prior hook or action failed. This ensures cleanup and notification hooks fire reliably.
+
+### Hook Environment Variables
+
+Every hook receives `MIRROR_*` environment variables with release context:
+
+| Variable               | Scope        | Description                                           |
+|------------------------|--------------|-------------------------------------------------------|
+| `MIRROR_CWD`           | Always       | Project root directory                                |
+| `MIRROR_CONFIG_PATH`   | Always       | Path to resolved `mirror.config.toml`                 |
+| `MIRROR_SOURCE`        | Always       | Version source adapter                                |
+| `MIRROR_OUTPUT`        | Always       | Comma-separated output adapters                       |
+| `MIRROR_TARGET`        | Always       | The release target argument                           |
+| `MIRROR_CURRENT`       | Plan+        | Current version string                                |
+| `MIRROR_NEXT`          | Plan+        | Next version string                                   |
+| `MIRROR_PROJECT_NAME`  | Plan+        | Resolved project name                                 |
+| `MIRROR_GIT_TAG`       | Plan+        | Rendered git tag (if git output)                      |
+| `MIRROR_FILE_PATHS`    | Plan+        | Comma-separated file output paths                     |
+| `MIRROR_COMMIT_ENABLED`| Plan+        | `true`/`false`                                        |
+| `MIRROR_PUSH_ENABLED`  | Plan+        | `true`/`false`                                        |
+| `MIRROR_FILE_PATH`     | Write        | Path being written to                                 |
+| `MIRROR_FILE_CURRENT`  | Write        | Current version in the file                           |
+| `MIRROR_FILE_NEXT`     | Write        | Next version being written                            |
+| `MIRROR_COMMIT_MSG`    | Commit       | Commit message                                        |
+| `MIRROR_COMMIT_PATHS`  | Commit       | Space-separated paths being committed                 |
+| `MIRROR_TAG`           | Tag          | Git tag being created                                 |
+| `MIRROR_INCLUDE_COMMIT`| Push         | `true`/`false`                                        |
+| `MIRROR_INCLUDE_TAGS`  | Push         | `true`/`false`                                        |
+| `MIRROR_APPLIED`       | Results      | `true`/`false` (whether execution actually applied)    |
+| `MIRROR_DRY_RUN`       | Results      | `true`/`false`                                        |
+
+"Plan+" means the variable is available starting from `before:plan` and all later hooks. "Write", "Commit", "Tag", and "Push" mean the variable is available at the corresponding action-level hooks. "Results" means `after:apply` and `after:everything`.
+
 ## Recommended Agent Release Workflow
 
 When an AI coding agent prepares a Mirror-managed release, it should follow this sequence.
@@ -434,6 +538,7 @@ The API uses the same configuration discovery and safety rules as the CLI.
 - `source/adapters.ts`: package, JSR, and Git read/write primitives.
 - `source/plan.ts`: validation and read-only release plan construction.
 - `source/executor.ts`: mutation layer for file writes, Git commits, tags, and pushes.
+- `source/hooks.ts`: lifecycle hook configuration, execution, and environment variable construction.
 - `source/reporter.ts`: text and JSON report formatting.
 - `source/agents.ts`: agent skill installation and AGENTS.md guidance automation.
 - `source/errors.ts`: user-facing errors with stable exit codes.

package/jsr.json

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

package/library/agents.d.ts

@@ -3,9 +3,11 @@
  */
 import type { MirrorAgentAutomationResult, MirrorAgentSettings, MirrorAgentsInstructionsResult, MirrorCliOptions, MirrorSkillInstallResult, MirrorSkillInstallScope } from './types.js';
 export declare const mirrorSkillName = "guiho-as-mirror";
+export declare const mirrorAgentsSectionStartMarker = "<!-- BEGIN GUIHO MIRROR - DO NOT EDIT THIS SECTION -->";
+export declare const mirrorAgentsSectionEndMarker = "<!-- END GUIHO 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";
+export declare const mirrorAgentsSection: string;
 type MirrorSkillPathOptions = {
     cwd?: string;
     homeDirectory?: string;

package/library/agents.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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,8BAA8B,2DAA2D,CAAA;AACtG,eAAO,MAAM,4BAA4B,8BAA8B,CAAA;AACvE,eAAO,MAAM,0BAA0B,mDAAmD,CAAA;AAE1F,eAAO,MAAM,0BAA0B,EAAE,mBAKxC,CAAA;AAWD,eAAO,MAAM,mBAAmB,QAEA,CAAA;AAEhC,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"}

package/library/agents.js

@@ -8,6 +8,8 @@ import { dirname, resolve } from 'node:path';
 import { MirrorError } from './errors.js';
 import { discoverMirrorConfig, resolveMirrorPath } from './config.js';
 export const mirrorSkillName = 'guiho-as-mirror';
+export const mirrorAgentsSectionStartMarker = '<!-- BEGIN GUIHO MIRROR - DO NOT EDIT THIS SECTION -->';
+export const mirrorAgentsSectionEndMarker = '<!-- END GUIHO MIRROR -->';
 export const mirrorAgentsSectionHeading = '## Semantic Project Versioning -- GUIHO Mirror';
 export const defaultMirrorAgentSettings = {
     writeChangelog: true,
@@ -15,7 +17,7 @@ export const defaultMirrorAgentSettings = {
     autoAgentsMd: true,
     autoSkillInstall: true,
 };
-export const mirrorAgentsSection = `${mirrorAgentsSectionHeading}
+const mirrorAgentsSectionBody = `${mirrorAgentsSectionHeading}
 
 Invoke 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.
 
@@ -23,6 +25,9 @@ Before editing release docs or changelogs, inspect mirror.config.toml. If [agent
 
 Use [agents].changelog_path as the changelog file path. If it is missing, use CHANGELOG.md in the project root.
 `;
+export const mirrorAgentsSection = `${mirrorAgentsSectionStartMarker}
+${mirrorAgentsSectionBody.trimEnd()}
+${mirrorAgentsSectionEndMarker}`;
 export const resolveMirrorSkillPath = (scope, options = {}) => {
     if (scope === 'local')
         return resolve(options.cwd ?? process.cwd(), '.agents', 'skills', mirrorSkillName, 'SKILL.md');
@@ -52,7 +57,7 @@ export const ensureMirrorAgentsInstructions = async (cwd, create = false) => {
         return { path, exists: true, changed: true };
     }
     const content = await readFile(path, 'utf8');
-    if (content.includes(mirrorAgentsSectionHeading))
+    if (hasMirrorAgentsSection(content))
         return { path, exists: true, changed: false };
     const nextContent = `${content.trimEnd()}\n\n${mirrorAgentsSection}\n`;
     await writeFile(path, nextContent, 'utf8');
@@ -126,6 +131,13 @@ const optionalString = (value, key) => {
         throw new MirrorError(`Invalid ${key}. Expected a string.`);
     return value;
 };
+const hasMirrorAgentsSection = (content) => {
+    const normalizedContent = normalizeMirrorAgentsSection(content);
+    return [mirrorAgentsSection, mirrorAgentsSectionBody].some((section) => {
+        return normalizedContent.includes(normalizeMirrorAgentsSection(section));
+    });
+};
+const normalizeMirrorAgentsSection = (content) => content.replace(/\s+/g, ' ').trim();
 const embeddedMirrorSkillContent = [
     '---',
     'name: guiho-as-mirror',

package/library/cli.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6DH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAc5B,CAAA;AAEJ,eAAO,MAAM,YAAY,GAAU,kBAA+B,kBAwEjE,CAAA"}

package/library/cli.js

@@ -14,6 +14,7 @@ import { createReadlineInitPrompter, isInteractiveInit, resolveInitAnswers } fro
 import { buildVersionPlan, validateMirrorConfig } from './plan.js';
 import { mirrorBanner, reportAgentsInstructions, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportSkillInstall, reportValue, } from './reporter.js';
 import { resolveNextVersion } from './version.js';
+import { runHooks, runHooksQuiet, hookEnvFromConfig, hookEnvForPlan, hookEnvForResult } from './hooks.js';
 const mirrorVersion = readInstalledVersion();
 const globalArgs = {
     config: { type: 'string', description: 'Path to mirror.config.toml' },
@@ -301,13 +302,41 @@ const createVersionCommand = () => defineCommand({
             async run(context) {
                 const options = cliOptions(context.rawArgs, context.args);
                 await prepareAgents(options);
-                const plan = await buildVersionPlan(String(context.args['target']), options);
-                if (options.format !== 'json')
-                    process.stdout.write(mirrorBanner(plan.configPath ? plan.configPath : ''));
-                if (options.format !== 'json')
-                    process.stdout.write(reportPlan(plan, options.format));
-                const result = await executeVersionPlan(plan, options);
-                process.stdout.write(options.format === 'json' ? reportExecution(result, options.format) : reportExecutionSummary(result, options.format));
+                const target = String(context.args['target']);
+                const config = await loadMirrorConfig(options);
+                const hooks = config.hooks;
+                const hookResults = [];
+                const baseEnv = hookEnvFromConfig(config, target);
+                try {
+                    await runHooks('before:everything', hooks['before:everything'], baseEnv, config.cwd);
+                }
+                catch (error) {
+                    hookResults.push({ name: 'before:everything', commands: hooks['before:everything'] ?? [], status: 'failure', durationMs: 0, exitCode: error instanceof Error ? 1 : 1, stderr: error instanceof Error ? error.message : String(error) });
+                    throw error;
+                }
+                try {
+                    await runHooks('before:plan', hooks['before:plan'], baseEnv, config.cwd);
+                    const plan = await buildVersionPlan(target, options);
+                    const planEnv = hookEnvForPlan(plan, target);
+                    await runHooks('after:plan', hooks['after:plan'], planEnv, config.cwd);
+                    if (options.format !== 'json')
+                        process.stdout.write(mirrorBanner(plan.configPath ? plan.configPath : ''));
+                    if (options.format !== 'json')
+                        process.stdout.write(reportPlan(plan, options.format));
+                    await runHooks('before:apply', hooks['before:apply'], planEnv, config.cwd);
+                    try {
+                        const result = await executeVersionPlan(plan, options, hooks, target);
+                        result.hookResults = hookResults;
+                        process.stdout.write(options.format === 'json' ? reportExecution(result, options.format) : reportExecutionSummary(result, options.format));
+                    }
+                    finally {
+                        const resultEnv = hookEnvForResult(plan, target, true, Boolean(options.dryRun));
+                        await runHooksQuiet('after:apply', hooks['after:apply'], resultEnv, config.cwd, hookResults);
+                    }
+                }
+                finally {
+                    await runHooksQuiet('after:everything', hooks['after:everything'], baseEnv, config.cwd, hookResults);
+                }
             },
         }),
     },

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,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"}
+{"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;AAQnB,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,YA2DF,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

@@ -7,6 +7,7 @@ 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';
+import { normalizeHooksConfig } from './hooks.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));
@@ -73,6 +74,7 @@ export const normalizeMirrorConfig = (raw, cwd, configPath, options = {}) => {
     const changelogPath = optionalString(raw.agents?.changelog_path, 'agents.changelog_path') ?? 'CHANGELOG.md';
     const autoAgentsMd = optionalBoolean(raw.agents?.auto_agents_md, 'agents.auto_agents_md') !== false;
     const autoSkillInstall = optionalBoolean(raw.agents?.auto_skill_install, 'agents.auto_skill_install') !== false;
+    const hooks = normalizeHooksConfig(raw.hooks);
     return {
         schema: 1,
         cwd,
@@ -106,6 +108,7 @@ export const normalizeMirrorConfig = (raw, cwd, configPath, options = {}) => {
             autoAgentsMd,
             autoSkillInstall,
         },
+        hooks,
     };
 };
 export const defaultInitAnswersForSource = (kind, cwd) => ({

package/library/executor.d.ts

@@ -1,7 +1,7 @@
 /**
  * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
  */
-import type { MirrorCliOptions, MirrorExecutionResult } from './types.js';
+import type { MirrorCliOptions, MirrorExecutionResult, MirrorHooksConfig } from './types.js';
 export declare const applyVersionPlan: (target: string, options?: MirrorCliOptions) => Promise<MirrorExecutionResult>;
-export declare const executeVersionPlan: (plan: MirrorExecutionResult["plan"], options?: MirrorCliOptions) => Promise<MirrorExecutionResult>;
+export declare const executeVersionPlan: (plan: MirrorExecutionResult["plan"], options?: MirrorCliOptions, hooks?: MirrorHooksConfig, target?: string) => Promise<MirrorExecutionResult>;
 //# sourceMappingURL=executor.d.ts.map

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;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"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../source/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAM5F,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,EAC9B,QAAQ,iBAAiB,EACzB,eAAyB,KACxB,OAAO,CAAC,qBAAqB,CAoC/B,CAAA"}

package/library/executor.js

@@ -4,29 +4,45 @@
 import { MirrorError } from './errors.js';
 import { createGitCommit, createGitTag, isGitDirty, isGitRepository, pushGitRefs, writeJsrVersionFile, writePackageVersionFile } from './adapters.js';
 import { buildVersionPlan } from './plan.js';
+import { hookEnvForAction, runActionHooks } from './hooks.js';
 export const applyVersionPlan = async (target, options = {}) => {
     const plan = await buildVersionPlan(target, options);
     return executeVersionPlan(plan, options);
 };
-export const executeVersionPlan = async (plan, options = {}) => {
+export const executeVersionPlan = async (plan, options = {}, hooks, target = plan.nextVersion) => {
+    const hookResults = [];
     if (options.dryRun)
-        return { plan, applied: false, dryRun: true };
+        return { plan, applied: false, dryRun: true, hookResults };
     if (!plan.allowDirty && (await isGitRepository(plan.cwd)) && (await isGitDirty(plan.cwd))) {
         throw new MirrorError('Git worktree is dirty. Commit changes or pass --allow-dirty.');
     }
     if (!options.yes)
         throw new MirrorError('Refusing to apply without confirmation. Pass --yes to apply the plan.');
     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')
+        const actionEnv = hookEnvForAction(plan, target, action);
+        if (action.type === 'write-file') {
+            await runActionHooks('before:write', hooks?.['before:write'], actionEnv, plan.cwd, options);
+            if (action.adapter === 'package.json')
+                await writePackageVersionFile(action.path, plan.nextVersion);
+            if (action.adapter === 'jsr.json')
+                await writeJsrVersionFile(action.path, plan.nextVersion);
+            await runActionHooks('after:write', hooks?.['after:write'], actionEnv, plan.cwd, options);
+        }
+        if (action.type === 'git-commit') {
+            await runActionHooks('before:commit', hooks?.['before:commit'], actionEnv, plan.cwd, options);
             await createGitCommit(plan.cwd, action.paths, action.message);
-        if (action.type === 'git-tag')
+            await runActionHooks('after:commit', hooks?.['after:commit'], actionEnv, plan.cwd, options);
+        }
+        if (action.type === 'git-tag') {
+            await runActionHooks('before:tag', hooks?.['before:tag'], actionEnv, plan.cwd, options);
             await createGitTag(plan.cwd, action.tag);
-        if (action.type === 'git-push')
+            await runActionHooks('after:tag', hooks?.['after:tag'], actionEnv, plan.cwd, options);
+        }
+        if (action.type === 'git-push') {
+            await runActionHooks('before:push', hooks?.['before:push'], actionEnv, plan.cwd, options);
             await pushGitRefs(plan.cwd, action.includeCommit, action.includeTags);
+            await runActionHooks('after:push', hooks?.['after:push'], actionEnv, plan.cwd, options);
+        }
     }
-    return { plan, applied: true, dryRun: false };
+    return { plan, applied: true, dryRun: false, hookResults };
 };

package/library/guiho-mirror.d.ts

@@ -1,10 +1,10 @@
 /**
  * @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, MirrorInitAnswers, MirrorInitFlags, MirrorInitPrompter, MirrorRawConfig, MirrorSkillInstallResult, MirrorSkillInstallScope, MirrorVersionPlan, MirrorVersionPlanAction, MirrorVersionTarget, } from './types.js';
+export type { MirrorAdapterName, MirrorCliOptions, MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorAgentAutomationResult, MirrorAgentSettings, MirrorAgentsInstructionsResult, MirrorHookCommand, MirrorHookName, MirrorHookResult, MirrorHooksConfig, 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 { defaultMirrorAgentSettings, ensureMirrorAgentsInstructions, findAgentsFile, installMirrorSkill, isMirrorSkillInstalled, mirrorAgentsSection, mirrorAgentsSectionEndMarker, mirrorAgentsSectionHeading, mirrorAgentsSectionStartMarker, mirrorSkillName, resolveMirrorAgentSettings, resolveMirrorSkillPath, runMirrorAgentAutomation, } from './agents.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';
@@ -12,6 +12,7 @@ export { assertValidSemver, isMirrorReleaseTarget, mirrorReleaseTargets, resolve
 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 { hookEnvFromConfig, hookEnvForAction, hookEnvForPlan, hookEnvForResult, mirrorHookNames, normalizeHooksConfig, runHooks, runHooksQuiet, } from './hooks.js';
 export { mirrorBanner, reportAgentsInstructions, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportSkillInstall, reportValue, } from './reporter.js';
 export { createMirrorCommand, runMirrorCli } from './cli.js';
 //# sourceMappingURL=guiho-mirror.d.ts.map

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,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"}
+{"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,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,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,4BAA4B,EAC5B,0BAA0B,EAC1B,8BAA8B,EAC9B,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,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAA;AACnB,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

@@ -3,7 +3,7 @@
  */
 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 { defaultMirrorAgentSettings, ensureMirrorAgentsInstructions, findAgentsFile, installMirrorSkill, isMirrorSkillInstalled, mirrorAgentsSection, mirrorAgentsSectionEndMarker, mirrorAgentsSectionHeading, mirrorAgentsSectionStartMarker, mirrorSkillName, resolveMirrorAgentSettings, resolveMirrorSkillPath, runMirrorAgentAutomation, } from './agents.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';
@@ -11,5 +11,6 @@ export { assertValidSemver, isMirrorReleaseTarget, mirrorReleaseTargets, resolve
 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 { hookEnvFromConfig, hookEnvForAction, hookEnvForPlan, hookEnvForResult, mirrorHookNames, normalizeHooksConfig, runHooks, runHooksQuiet, } from './hooks.js';
 export { mirrorBanner, reportAgentsInstructions, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportSkillInstall, reportValue, } from './reporter.js';
 export { createMirrorCommand, runMirrorCli } from './cli.js';

package/library/hooks.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { MirrorCliOptions, MirrorConfig, MirrorHookCommand, MirrorHookName, MirrorHookResult, MirrorHooksConfig, MirrorVersionPlan, MirrorVersionPlanAction } from './types.js';
+export declare const mirrorHookNames: MirrorHookName[];
+export declare const normalizeHooksConfig: (raw: Record<string, MirrorHookCommand> | undefined) => MirrorHooksConfig;
+export declare const runHooks: (name: MirrorHookName, commands: string[] | undefined, env: Record<string, string>, cwd: string) => Promise<MirrorHookResult | undefined>;
+export declare const runHooksQuiet: (name: MirrorHookName, commands: string[] | undefined, env: Record<string, string>, cwd: string, results: MirrorHookResult[]) => Promise<void>;
+export declare const runActionHooks: (name: MirrorHookName, commands: string[] | undefined, env: Record<string, string>, cwd: string, options: MirrorCliOptions) => Promise<MirrorHookResult | undefined>;
+export declare const hookEnvFromConfig: (config: MirrorConfig, target: string) => Record<string, string>;
+export declare const hookEnvForPlan: (plan: MirrorVersionPlan, target: string) => Record<string, string>;
+export declare const hookEnvForAction: (plan: MirrorVersionPlan, target: string, action: MirrorVersionPlanAction) => Record<string, string>;
+export declare const hookEnvForResult: (plan: MirrorVersionPlan, target: string, applied: boolean, dryRun: boolean) => Record<string, string>;
+//# sourceMappingURL=hooks.d.ts.map

package/library/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../source/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAUpL,eAAO,MAAM,eAAe,EAAE,cAAc,EAQ3C,CAAA;AAID,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,SAAS,KAAG,iBAezF,CAAA;AAED,eAAO,MAAM,QAAQ,GACnB,MAAM,cAAc,EACpB,UAAU,MAAM,EAAE,GAAG,SAAS,EAC9B,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,KAAK,MAAM,KACV,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAwBtC,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,MAAM,cAAc,EACpB,UAAU,MAAM,EAAE,GAAG,SAAS,EAC9B,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,KAAK,MAAM,EACX,SAAS,gBAAgB,EAAE,KAC1B,OAAO,CAAC,IAAI,CAUd,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,MAAM,cAAc,EACpB,UAAU,MAAM,EAAE,GAAG,SAAS,EAC9B,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,KAAK,MAAM,EACX,SAAS,gBAAgB,KACxB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAItC,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,QAAQ,YAAY,EAAE,QAAQ,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAM5F,CAAA;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,iBAAiB,EAAE,QAAQ,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAa5F,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,iBAAiB,EAAE,QAAQ,MAAM,EAAE,QAAQ,uBAAuB,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAwBhI,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,iBAAiB,EAAE,QAAQ,MAAM,EAAE,SAAS,OAAO,EAAE,QAAQ,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAIjI,CAAA"}

package/library/hooks.js

@@ -0,0 +1,122 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { MirrorError } from './errors.js';
+const execAsync = (command, options) => promisify(exec)(command, {
+    cwd: options.cwd,
+    env: { ...process.env, ...options.env },
+    maxBuffer: 10 * 1024 * 1024,
+});
+export const mirrorHookNames = [
+    'before:everything', 'after:everything',
+    'before:plan', 'after:plan',
+    'before:apply', 'after:apply',
+    'before:write', 'after:write',
+    'before:commit', 'after:commit',
+    'before:tag', 'after:tag',
+    'before:push', 'after:push',
+];
+const hookNameSet = new Set(mirrorHookNames);
+export const normalizeHooksConfig = (raw) => {
+    if (!raw || typeof raw !== 'object')
+        return {};
+    const config = {};
+    for (const [key, value] of Object.entries(raw)) {
+        const name = key.replaceAll('_', ':');
+        if (!hookNameSet.has(name))
+            continue;
+        const commands = typeof value === 'string' ? [value] : value;
+        config[name] = commands;
+    }
+    return config;
+};
+export const runHooks = async (name, commands, env, cwd) => {
+    if (!commands || commands.length === 0)
+        return undefined;
+    const start = Date.now();
+    for (let i = 0; i < commands.length; i++) {
+        const command = commands[i];
+        if (!command)
+            continue;
+        try {
+            await execAsync(command, { cwd, env });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const exitCode = typeof error['code'] === 'number' ? error['code'] : 1;
+            throw new MirrorError(`Hook '${name}' failed (exit code ${exitCode}): ${command}\n${message}`, Number(exitCode));
+        }
+    }
+    return {
+        name,
+        commands,
+        status: 'success',
+        durationMs: Date.now() - start,
+        exitCode: 0,
+    };
+};
+export const runHooksQuiet = async (name, commands, env, cwd, results) => {
+    if (!commands || commands.length === 0)
+        return;
+    try {
+        await runHooks(name, commands, env, cwd);
+        results.push({ name, commands, status: 'success', durationMs: 0, exitCode: 0 });
+    }
+    catch (error) {
+        const exitCode = error instanceof MirrorError ? error.exitCode ?? 1 : 1;
+        results.push({ name, commands, status: 'failure', durationMs: 0, exitCode, stderr: error instanceof Error ? error.message : String(error) });
+    }
+};
+export const runActionHooks = async (name, commands, env, cwd, options) => {
+    if (options.dryRun || !commands || commands.length === 0)
+        return undefined;
+    return runHooks(name, commands, env, cwd);
+};
+export const hookEnvFromConfig = (config, target) => ({
+    MIRROR_CWD: config.cwd,
+    MIRROR_CONFIG_PATH: config.configPath ?? '',
+    MIRROR_SOURCE: config.version.source,
+    MIRROR_OUTPUT: config.version.output.join(','),
+    MIRROR_TARGET: target,
+});
+export const hookEnvForPlan = (plan, target) => ({
+    MIRROR_CWD: plan.cwd,
+    MIRROR_CONFIG_PATH: plan.configPath ?? '',
+    MIRROR_SOURCE: plan.source,
+    MIRROR_OUTPUT: plan.output.join(','),
+    MIRROR_TARGET: target,
+    MIRROR_CURRENT: plan.currentVersion,
+    MIRROR_NEXT: plan.nextVersion,
+    MIRROR_PROJECT_NAME: plan.project.name ?? '',
+    MIRROR_GIT_TAG: plan.gitTag ?? '',
+    MIRROR_FILE_PATHS: plan.fileOutputPaths.join(','),
+    MIRROR_COMMIT_ENABLED: String(plan.commitEnabled),
+    MIRROR_PUSH_ENABLED: String(plan.pushEnabled),
+});
+export const hookEnvForAction = (plan, target, action) => {
+    const env = hookEnvForPlan(plan, target);
+    if (action.type === 'write-file') {
+        env['MIRROR_FILE_PATH'] = action.path;
+        env['MIRROR_FILE_CURRENT'] = action.currentVersion;
+        env['MIRROR_FILE_NEXT'] = action.nextVersion;
+    }
+    if (action.type === 'git-commit') {
+        env['MIRROR_COMMIT_MSG'] = action.message;
+        env['MIRROR_COMMIT_PATHS'] = action.paths.join(' ');
+    }
+    if (action.type === 'git-tag') {
+        env['MIRROR_TAG'] = action.tag;
+    }
+    if (action.type === 'git-push') {
+        env['MIRROR_INCLUDE_COMMIT'] = String(action.includeCommit);
+        env['MIRROR_INCLUDE_TAGS'] = String(action.includeTags);
+    }
+    return env;
+};
+export const hookEnvForResult = (plan, target, applied, dryRun) => ({
+    ...hookEnvForPlan(plan, target),
+    MIRROR_APPLIED: String(applied),
+    MIRROR_DRY_RUN: String(dryRun),
+});

package/library/reporter.d.ts

@@ -1,7 +1,7 @@
 /**
  * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
  */
-import type { MirrorAgentsInstructionsResult, MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorSkillInstallResult, MirrorVersionPlan } from './types.js';
+import type { MirrorAgentsInstructionsResult, MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorHookResult, MirrorSkillInstallResult, MirrorVersionPlan } from './types.js';
 export declare const mirrorBanner: (configPath?: string) => string;
 export declare const reportValue: (value: unknown, format?: MirrorFormat) => string;
 export declare const reportConfig: (config: MirrorConfig, format?: MirrorFormat) => string;
@@ -11,4 +11,5 @@ export declare const reportAgentsInstructions: (result: MirrorAgentsInstructions
 export declare const reportPlan: (plan: MirrorVersionPlan, format?: MirrorFormat) => string;
 export declare const reportExecution: (result: MirrorExecutionResult, format?: MirrorFormat) => string;
 export declare const reportExecutionSummary: (result: MirrorExecutionResult, format?: MirrorFormat) => string;
+export declare const reportHookResults: (results: MirrorHookResult[]) => string;
 //# sourceMappingURL=reporter.d.ts.map

package/library/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../source/reporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,8BAA8B,EAC9B,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,YAAY,CAAA;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"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../source/reporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,8BAA8B,EAC9B,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,WAW/C,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,SAAQ,YAAqB,WAGxE,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,QAAQ,YAAY,EAAE,SAAQ,YAAqB,WAoB/E,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAQ,YAAqB,WAyD/D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,QAAQ,wBAAwB,EAAE,SAAQ,YAAqB,WAWjG,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,QAAQ,8BAA8B,EAAE,SAAQ,YAAqB,WAS7G,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,MAAM,iBAAiB,EAAE,SAAQ,YAAqB,WAyBhF,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,qBAAqB,EAAE,SAAQ,YAAqB,WAK3F,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,qBAAqB,EAAE,SAAQ,YAAqB,WAkBlG,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,SAAS,gBAAgB,EAAE,WAG5D,CAAA"}

package/library/reporter.js

@@ -78,6 +78,22 @@ export const reportConfigSchema = (format = 'text') => {
         '  auto_agents_md = true | false             Optional. Insert Mirror guidance into AGENTS.md when present. Default: true.',
         '  auto_skill_install = true | false         Optional. Install guiho-as-mirror globally when missing. Default: true.',
         '',
+        '  [hooks]',
+        '  before_everything = "<command>"           Optional. Shell command(s) before any release work.',
+        '  after_everything = "<command>"            Optional. Shell command(s) after all release work (always runs).',
+        '  before_plan = "<command>"                 Optional. Shell command(s) before building the release plan.',
+        '  after_plan = "<command>"                  Optional. Shell command(s) after the plan is built.',
+        '  before_apply = "<command>"                Optional. Shell command(s) before executing the plan.',
+        '  after_apply = "<command>"                 Optional. Shell command(s) after plan execution (always runs).',
+        '  before_write = "<command>"                Optional. Shell command(s) before writing version files.',
+        '  after_write = "<command>"                 Optional. Shell command(s) after writing version files.',
+        '  before_commit = "<command>"               Optional. Shell command(s) before creating a release commit.',
+        '  after_commit = "<command>"                Optional. Shell command(s) after creating a release commit.',
+        '  before_tag = "<command>"                  Optional. Shell command(s) before creating a release tag.',
+        '  after_tag = "<command>"                   Optional. Shell command(s) after creating a release tag.',
+        '  before_push = "<command>"                 Optional. Shell command(s) before pushing release refs.',
+        '  after_push = "<command>"                  Optional. Shell command(s) after pushing release refs.',
+        '',
     ].join('\n');
 };
 export const reportSkillInstall = (result, format = 'text') => {
@@ -135,7 +151,10 @@ export const reportPlan = (plan, format = 'text') => {
 export const reportExecution = (result, format = 'text') => {
     if (format === 'json')
         return `${JSON.stringify(result, null, 2)}\n`;
-    return `${reportPlan(result.plan, 'text')}applied: ${String(result.applied)}\ndry_run: ${String(result.dryRun)}\n`;
+    let out = `${reportPlan(result.plan, 'text')}applied: ${String(result.applied)}\ndry_run: ${String(result.dryRun)}\n`;
+    if (result.hookResults && result.hookResults.length > 0)
+        out += reportHookResults(result.hookResults);
+    return out;
 };
 export const reportExecutionSummary = (result, format = 'text') => {
     if (format === 'json')
@@ -152,5 +171,12 @@ export const reportExecutionSummary = (result, format = 'text') => {
         lines.push(`files: ${files}`);
     if (result.plan.gitTag)
         lines.push(`tag: ${result.plan.gitTag}`);
+    let out = `${lines.join('\n')}\n`;
+    if (result.hookResults && result.hookResults.length > 0)
+        out += reportHookResults(result.hookResults);
+    return out;
+};
+export const reportHookResults = (results) => {
+    const lines = results.map((r) => `hooks: ${r.name} ${r.status}${r.exitCode ? ` (exit ${r.exitCode})` : ''}`);
     return `${lines.join('\n')}\n`;
 };

package/library/schema.d.ts

@@ -127,6 +127,37 @@ export declare const mirrorConfigJsonSchema: {
                 };
             };
         };
+        readonly hooks: {
+            readonly type: "object";
+            readonly description: "Lifecycle hook commands that run at defined points during version apply.";
+            readonly additionalProperties: {
+                readonly oneOf: readonly [{
+                    readonly type: "string";
+                    readonly description: "A single shell command.";
+                }, {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Multiple shell commands run sequentially.";
+                }];
+            };
+            readonly properties: {
+                [k: string]: {
+                    oneOf: ({
+                        type: string;
+                        description: string;
+                        items?: undefined;
+                    } | {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        description: string;
+                    })[];
+                };
+            };
+        };
     };
 };
 export declare const renderMirrorConfigJsonSchema: () => string;

package/library/schema.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../source/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,2BAA2B,kEAAkE,CAAA;AAE1G,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJzB,CAAA;AAEV,eAAO,MAAM,4BAA4B,cAA+D,CAAA"}

package/library/schema.js

@@ -123,6 +123,30 @@ export const mirrorConfigJsonSchema = {
                 },
             },
         },
+        hooks: {
+            type: 'object',
+            description: 'Lifecycle hook commands that run at defined points during version apply.',
+            additionalProperties: {
+                oneOf: [
+                    { type: 'string', description: 'A single shell command.' },
+                    { type: 'array', items: { type: 'string' }, description: 'Multiple shell commands run sequentially.' },
+                ],
+            },
+            properties: Object.fromEntries([
+                'before_everything', 'after_everything',
+                'before_plan', 'after_plan',
+                'before_apply', 'after_apply',
+                'before_write', 'after_write',
+                'before_commit', 'after_commit',
+                'before_tag', 'after_tag',
+                'before_push', 'after_push',
+            ].map((key) => [key, {
+                    oneOf: [
+                        { type: 'string', description: `A single shell command to run at the ${key.replaceAll('_', ':')} lifecycle point.` },
+                        { type: 'array', items: { type: 'string' }, description: `Multiple shell commands to run sequentially at the ${key.replaceAll('_', ':')} lifecycle point.` },
+                    ],
+                }])),
+        },
     },
 };
 export const renderMirrorConfigJsonSchema = () => `${JSON.stringify(mirrorConfigJsonSchema, null, 2)}\n`;

package/library/types.d.ts

@@ -8,6 +8,18 @@ export type MirrorFormat = 'text' | 'json';
 export type MirrorVersionTarget = ReleaseType | string;
 export type MirrorJsonObject = Record<string, unknown>;
 export type MirrorSkillInstallScope = 'local' | 'global';
+export type MirrorHookName = 'before:everything' | 'after:everything' | 'before:plan' | 'after:plan' | 'before:apply' | 'after:apply' | 'before:write' | 'after:write' | 'before:commit' | 'after:commit' | 'before:tag' | 'after:tag' | 'before:push' | 'after:push';
+export type MirrorHookCommand = string | string[];
+export type MirrorHooksConfig = Partial<Record<MirrorHookName, string[]>>;
+export type MirrorHookResult = {
+    name: MirrorHookName;
+    commands: string[];
+    status: 'success' | 'failure' | 'skipped';
+    durationMs: number;
+    exitCode?: number;
+    stdout?: string;
+    stderr?: string;
+};
 export type MirrorRawConfig = Partial<{
     schema: number;
     project: Partial<{
@@ -39,6 +51,7 @@ export type MirrorRawConfig = Partial<{
         auto_agents_md: boolean;
         auto_skill_install: boolean;
     }>;
+    hooks: Record<string, MirrorHookCommand>;
 }>;
 export type MirrorConfig = {
     schema: 1;
@@ -68,6 +81,7 @@ export type MirrorConfig = {
         allowDirty: boolean;
     };
     agents: MirrorAgentSettings;
+    hooks: MirrorHooksConfig;
 };
 export type MirrorAgentSettings = {
     writeChangelog: boolean;
@@ -186,5 +200,6 @@ export type MirrorExecutionResult = {
     plan: MirrorVersionPlan;
     applied: boolean;
     dryRun: boolean;
+    hookResults?: MirrorHookResult[];
 };
 //# sourceMappingURL=types.d.ts.map

package/library/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../source/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../source/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@guiho/mirror",
   "description": "Open source project versioning for Bun, npm, JSR, and Git.",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "type": "module",
   "main": "./library/guiho-mirror.js",
   "types": "./library/guiho-mirror.d.ts",

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."
+            }
+          ]
+        }
+      }
     }
   }
 }