Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion API_REFERENCE.MD
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Nexus Unity API Reference

Version: `1.4.1`
Version: `1.4.2`

Nexus Unity exposes two supported public API surfaces:

Expand Down
12 changes: 10 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,20 @@ All notable public changes to Nexus Unity are documented here.

## [Unreleased]

### Fixed
- Removed direct Unity Project Auditor package dependencies and made Unity Project Auditor execution optional, so clean installs avoid duplicate immutable `.meta` GUID warnings and `Could not find any registered modules` Console spam.
## [1.4.2] - 2026-06-13

### Added
- Added Python unit coverage for MCP bridge schema shape and type expectations.

### Changed
- Expanded the `unity_hierarchy_manager` MCP schema into per-action shapes with clearer required parameters and aliases.
- Refined Python MCP bridge routing with shared JSON-RPC payload types and more structured handler code.
- Added a repository mailmap entry for `air17` so local Git contributor reports resolve historical `air17@github.com` commits to the GitHub account's canonical no-reply identity.

### Fixed
- Removed direct Unity Project Auditor package dependencies and made Unity Project Auditor execution optional, so clean installs avoid duplicate immutable `.meta` GUID warnings and `Could not find any registered modules` Console spam.
- Fixed bridge-side compilation wait timeout handling after asset refresh and tightened test-result polling payload handling.

## [1.4.1] - 2026-06-12

### Fixed
Expand Down
10 changes: 5 additions & 5 deletions DOCUMENTATION.MD
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Nexus Unity Technical Documentation

Version: `1.4.1`
Version: `1.4.2`

Nexus Unity is a Unity Editor automation package with two public interfaces:

Expand Down Expand Up @@ -202,7 +202,7 @@ Before release, maintainers should run a public API stress audit that compares r

- Public repo: `https://github.com/ForkHorizon/NexusUnity.git`.
- Package id: `com.forkhorizon.nexus.unity`.
- Public release version: `1.4.1`.
- Public release version: `1.4.2`.
- License: `GPL-3.0-only`.
- Required release docs: `SECURITY.md`, `CONTRIBUTING.md`, and `RELEASE.md`.
- Repository funding metadata lives in `.github/FUNDING.yml` and configures the GitHub Sponsor button for `Daliys`.
Expand All @@ -214,17 +214,17 @@ Before release, maintainers should run a public API stress audit that compares r

Nexus Unity follows semantic versioning for public releases, but the development branch should not bump the package version for every merged fix. Keep `package.json` and visible docs at the latest shipped public version until a release is being prepared.

Unity Package Manager requires `MAJOR.MINOR.PATCH` values in `package.json`, and GitHub release tags and titles use the same semantic version. Use forms like `1.4.1` for the package version, `v1.4.1` for tags, and `1.4.1` for release titles.
Unity Package Manager requires `MAJOR.MINOR.PATCH` values in `package.json`, and GitHub release tags and titles use the same semantic version. Use forms like `1.4.2` for the package version, `v1.4.2` for tags, and `1.4.2` for release titles.

During normal development:

- Add all user-visible API, behavior, docs, and validation changes to `[Unreleased]` in `CHANGELOG.md`.
- Do not change `package.json` from `1.4.1` unless the change is part of a release-preparation commit.
- Do not change `package.json` from `1.4.2` unless the change is part of a release-preparation commit.
- Prefer compatibility fixes over breaking changes; if a breaking change is unavoidable, document the migration path before release.

During release preparation:

- Choose the next semantic version based on accumulated changes.
- Move `[Unreleased]` entries into the new dated release section.
- Update `package.json`, README badges/install examples, `DOCUMENTATION.MD`, and `API_REFERENCE.MD`.
- Tag the release with the matching semantic GitHub version, for example `v1.4.1` for package version `1.4.1`.
- Tag the release with the matching semantic GitHub version, for example `v1.4.2` for package version `1.4.2`.
14 changes: 8 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
# Nexus Unity

[![Tag](https://img.shields.io/github/v/tag/ForkHorizon/NexusUnity?sort=semver&label=release)](https://github.com/ForkHorizon/NexusUnity/releases/tag/v1.4.1)
[![Tag](https://img.shields.io/github/v/tag/ForkHorizon/NexusUnity?sort=semver&label=release)](https://github.com/ForkHorizon/NexusUnity/releases/tag/v1.4.2)
[![License: GPL-3.0-only](https://img.shields.io/badge/license-GPL--3.0--only-blue.svg)](LICENSE.md)
[![Unity](https://img.shields.io/badge/Unity-6000.0%2B-black?logo=unity)](package.json)
[![Validate package](https://github.com/ForkHorizon/NexusUnity/actions/workflows/validate.yml/badge.svg)](https://github.com/ForkHorizon/NexusUnity/actions/workflows/validate.yml)

Nexus Unity is an open source Unity Editor automation package. It runs a local JSON-RPC server inside the Unity Editor and exposes scene, asset, code, log, test, inspection, and UI automation tools to trusted local developer workflows.

- Package id: `com.forkhorizon.nexus.unity`
- Version: `1.4.1`
- Version: `1.4.2`
- License: `GPL-3.0-only`
- Public repository: `https://github.com/ForkHorizon/NexusUnity.git`

## Status

Active public release. Current version: `1.4.1`.
Active public release. Current version: `1.4.2`.

The public API is maintained for local Unity Editor automation workflows, while new tools and bridge improvements are tracked under `[Unreleased]` in `CHANGELOG.md` until the next tagged release.

Expand Down Expand Up @@ -48,7 +48,7 @@ https://github.com/ForkHorizon/NexusUnity.git
For reproducible installs, pin the public release tag:

```text
https://github.com/ForkHorizon/NexusUnity.git#v1.4.1
https://github.com/ForkHorizon/NexusUnity.git#v1.4.2
```

Nexus Unity does not declare Unity Project Auditor packages. Its lint tool always runs Nexus style and scene checks, and only includes Unity Project Auditor findings when the host project explicitly has compatible Project Auditor rules installed.
Expand Down Expand Up @@ -244,9 +244,9 @@ For integration tests, open the Unity project, start the Nexus Unity server from

## Development Versioning

Do not bump `package.json` for every change while development is unreleased. Keep the package at the latest public release version, currently `1.4.1`, and record user-visible work under `[Unreleased]` in `CHANGELOG.md`.
Do not bump `package.json` for every change while development is unreleased. Keep the package at the latest public release version, currently `1.4.2`, and record user-visible work under `[Unreleased]` in `CHANGELOG.md`.

When maintainers prepare a release, move the accumulated `[Unreleased]` entries to the new version section, update `package.json` and the visible version strings in `README.md`, `DOCUMENTATION.MD`, and `API_REFERENCE.MD`, then tag the release. Unity Package Manager and GitHub releases both use semantic `MAJOR.MINOR.PATCH` versions such as `1.4.1` and `v1.4.1`. Reserve patch bumps for urgent compatible hotfixes.
When maintainers prepare a release, move the accumulated `[Unreleased]` entries to the new version section, update `package.json` and the visible version strings in `README.md`, `DOCUMENTATION.MD`, and `API_REFERENCE.MD`, then tag the release. Unity Package Manager and GitHub releases both use semantic `MAJOR.MINOR.PATCH` versions such as `1.4.2` and `v1.4.2`. Reserve patch bumps for urgent compatible hotfixes.

## Community

Expand All @@ -256,6 +256,8 @@ To support ongoing development, use the repository Sponsor button configured thr

## Release Notes

The `1.4.2` patch removes direct Unity Project Auditor dependencies to avoid clean-install Console spam, keeps Nexus lint checks available without Project Auditor rules, and tightens the Python MCP bridge schemas, routing types, and compile/test polling behavior.

The `1.4.1` patch adds the missing package folder `.meta` files (`docs/`, `docs/assets/`, `Editor/tests/`) so fresh installs no longer log "no meta file" warnings, and hardens the pre-push `.meta` validation to check the git-tracked tree and every folder.

The `1.4.0` release adds Claude Code project setup, improves Windows/Linux MCP client detection, refactors the Python bridge transport/logging layers, adds bridge unit tests and CI coverage, and updates external PR validation/replay guidance.
Expand Down
6 changes: 3 additions & 3 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ This checklist is for publishing `com.forkhorizon.nexus.unity` as an open source
- Package id: `com.forkhorizon.nexus.unity`
- Public repository: `https://github.com/ForkHorizon/NexusUnity.git`
- License: `GPL-3.0-only`
- Current public version: `1.4.1`
- Current public version: `1.4.2`
- Minimum Unity version: `6000.0`

## Development Versioning
Expand All @@ -27,7 +27,7 @@ Use `CHANGELOG.md` as the source of truth during development:
- Keep compatibility notes and migration guidance in the docs while the work is unreleased.
- Prepare the next semantic version only when cutting a release branch or release commit.

Unity Package Manager requires `MAJOR.MINOR.PATCH` in `package.json`, for example `1.4.1`. GitHub release tags, titles, and announcements use the same semantic version: `v1.4.1` for tags and `1.4.1` for release titles.
Unity Package Manager requires `MAJOR.MINOR.PATCH` in `package.json`, for example `1.4.2`. GitHub release tags, titles, and announcements use the same semantic version: `v1.4.2` for tags and `1.4.2` for release titles.

When preparing the release, choose the version by semantic versioning:

Expand All @@ -39,7 +39,7 @@ When preparing the release, choose the version by semantic versioning:

1. Verify `Assets/NexusUnity/package.json`:
- `name` is `com.forkhorizon.nexus.unity`.
- `version` matches the Unity package version, such as `1.4.1`.
- `version` matches the Unity package version, such as `1.4.2`.
- `license` is `GPL-3.0-only`.
- Repository, documentation, changelog, and license URLs point to the public repository.
2. Verify docs:
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "com.forkhorizon.nexus.unity",
"version": "1.4.1",
"version": "1.4.2",
"displayName": "Nexus Unity",
"description": "Open source Unity Editor automation server for local AI tools and developer workflows.",
"unity": "6000.0",
Expand Down
Loading