Skip to content

Document versioning and release, and align repository layout - #6

Merged
showxu merged 1 commit into
masterfrom
maintenance
Oct 4, 2026
Merged

showxu merged 1 commit into
masterfrom
maintenance

Conversation

@showxu

@showxu showxu commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

Docs

  • New Documentation/Architecture/VersioningAndRelease.md: the manifest owns the version, the exporter is a maintainer tool that isn't shipped, and cli-tree.json pins the formatter's version and help digest. CI builds candidates; tagging, acceptance and publication are manual.
  • .github/RELEASE.md moves to Documentation/Reference/Release.md. It now names the credentials notify-catalog.yml actually reads (vars.CATALOG_APP_CLIENT_ID, secrets.CATALOG_APP_PRIVATE_KEY).
  • New CHANGELOG.md with 1.0.0, taken from the GitHub Release.
  • CONTRIBUTING.md lists the checks CI runs. Package.md states the argument-parser role as a current fact instead of edit history. Public docs no longer point to .agent/. AGENTS.md follows the current canonical template.

Package

  • [compatibility] minimum_host = '1.1.0'. v1.1.0 is the first App release with PluginManifest, and it already parses dependencies, file-backed CLI trees and dependency executables. This takes effect with the next release.
  • Scripts/build_package.py skips dot-files, __pycache__ and .pyc/.pyo, and a new test checks that stray files leave the archive bytes unchanged.

CI

  • validate.yml is renamed to ci.yml. Existing job names are unchanged, push runs are limited to master (PR branches ran twice), and actions are pinned by full SHA.
  • New minimum-python job runs the package tests and build on Python 3.11, the minimum the README documents.
  • Adds .github/CODEOWNERS.

Validation: Python tests pass on 3.14 and 3.11; validate_canonical_target.py passes. Swift sources are unchanged.

Versioning and release rules now live in
Documentation/Architecture/VersioningAndRelease.md, and the release and
catalog notification guide moves from .github/RELEASE.md to
Documentation/Reference/Release.md. The guide names the credentials the
notification workflow actually reads, CATALOG_APP_CLIENT_ID and
CATALOG_APP_PRIVATE_KEY. CHANGELOG.md records the published release.

The manifest declares Computer MCP 1.1.0 as its minimum host: it is the
first release that reads plugin manifests, and it parses every field this
package uses.

The builder skips hidden files and Python caches, so a local .DS_Store no
longer changes the archive, and a test covers it.

The workflow is renamed to ci.yml with unchanged job names, push runs are
limited to master, actions are pinned by full SHA, and a Python 3.11 job
backs the documented minimum package interpreter. CODEOWNERS is added,
AGENTS.md follows the current canonical agent guide, CONTRIBUTING lists
the checks CI runs, and public docs state current facts without edit
history or local agent directories.
@showxu
showxu merged commit 6d73beb into master Oct 4, 2026
3 checks passed
@showxu
showxu deleted the maintenance branch October 4, 2026 20:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant