agents-handoff 0.0.0-stage → 2.0.3

package/install/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog — agents-handoff
+
+The installer is a separate package from the skill. It follows the same
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format and Semantic Versioning.
+
+## [1.1.0] — 2026-10-09
+
+First release published to npm. `npx agents-handoff` now installs the skill on a
+machine that has neither a checkout nor an unpacked archive.
+
+### Added
+
+- A download path for the published package. When no skill tree sits beside the installer, the
+  archive for the requested version is fetched from
+  `https://codeload.github.com/Alot1z/agent-handoff/tar.gz` and unpacked; the same install
+  manifest then copies out of it, so an installed copy is identical either way.
+  `--version latest` resolves the newest release tag and falls back to the `main` branch,
+  saying so, when the repository has no release object.
+- An install that cannot resolve a source file fails with the missing paths and the count,
+  instead of warning per file and reporting success.
+
+### Changed
+
+- Install sources are written in the shipped tree's terms and resolved against both layouts
+  (shipped first, `repo-upstream/` second), so one manifest installs the same files from a
+  clone, a release archive, and a fetched archive.
+- The version reported after an install is read back from the installed `SKILL.md`, and the
+  fallback version used before a tree exists is parsed from `SKILL.md` too. The shipped suite
+  asserts the two agree, so a release cannot install under the previous version number.
+
+### Fixed
+
+- `README.md`, `LICENSE` and the twelve guides installed as nothing outside the development
+  tree: they were addressed under `repo-upstream/<path>`, which only that tree has.
+- `repository` pointed at a repository that does not serve this package; `homepage` and `bugs`
+  were missing.
+
+## [1.0.0] — 2026-10-08
+
+### Added
+
+- `install` (default), `update`, `remove`, `verify`, `list` and `where`.
+- Location targets `global`, `local` and `project`, with `--path` for an exact directory.
+- Global root resolution instead of a hard-coded path: an account-skill store that already
+  holds `agents-handoff`, else `~/.agents/skills`, else an account-skill store found on the
+  machine, else `~/.agents/skills`, created on install. `where` prints the resolved root and
+  the rule that chose it. `AGENT_HANDOFF_GLOBAL_DIR` overrides it.
+- `--version` to install a specific version, and `--force` to skip confirmations.

package/install/README.md

@@ -0,0 +1,76 @@
+# agents-handoff
+
+npx installer for the agents-handoff skill.
+
+## Quick start
+
+```bash
+npx agents-handoff
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `install` | Install the skill (default) |
+| `update` | Update to latest or specified version |
+| `remove` | Remove the installation |
+| `verify` | Verify installation integrity |
+| `list` | List all installed locations |
+| `where` | Show the resolved global root and why it was chosen |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--location L` | Install location: `global` (default), `local`, `project` |
+| `--path P` | Custom installation path |
+| `--version V` | Version to install: `latest` (default) or specific version |
+| `--force`, `-f` | Skip confirmations, overwrite existing |
+
+## Examples
+
+```bash
+# Install to global location
+npx agents-handoff
+
+# Install to project-local
+npx agents-handoff --location project
+
+# Update to latest
+npx agents-handoff --update
+
+# Remove without confirmation
+npx agents-handoff --remove --force
+
+# Verify installation
+npx agents-handoff --verify
+
+# Show all installations
+npx agents-handoff --list
+
+# Show which global root was chosen, and why
+npx agents-handoff where
+```
+
+## Locations
+
+- **global**: resolved, not hard-coded — an account-skill root that already holds
+  `agents-handoff`, else `~/.agents/skills`, else any account-skill store found on this
+  machine (`<store>/<account-id>/<profile-id>/agents-handoff/`), else `~/.agents/skills`,
+  created on install. See it resolved:
+  `npx agents-handoff where`. Override with `AGENT_HANDOFF_GLOBAL_DIR`, or target an
+  exact path with `--path`.
+- **local**: `./local/skills/agents-handoff/`
+- **project**: `./skills/agents-handoff/` (only detected if in a git repo)
+
+## Requirements
+
+- Node.js >= 18.0.0
+- curl, wget, or native fetch for downloading
+
+## Development
+
+This installer is part of the agents-handoff skill source code.
+
+See the [agents-handoff docs](https://github.com/Alot1z/agent-handoff/tree/main/docs) for more.