6.1.0

Added

• Skill source bundles can now include host-independent text files under scripts/**. Their relative paths are preserved in canonical packages and host materializations, and install, update, doctor, and prune manage their integrity. Agent Distribution does not execute scripts or manage interpreter selection or executable permissions.

6.0.0

Changed

• Breaking: authored source uses schema version 4: place bundle.json, skills/<category>/<skill>, and agents/<agent> directly under the source root. The legacy source layout is not accepted by the new builder.
• Breaking: agent-distribution build now requires --source and --output; --root has been removed. Generate an untracked output such as artifacts/agent-distribution before packing. The output directory name must be agent-distribution.
• Breaking: public build services now take distinct AbsolutePath sourceRoot and AbsolutePath outputRoot parameters.
• The GitHub verify Action builds its bundled CLI source into runner temporary storage. It validates a source bundle and does not synchronize, commit, or package generated output.

Removed

• Removed the generated-output synchronization workflow and the sync and release Actions.

Fixed

• Package verification can build the CLI from a fresh checkout using the restored artifacts path.

5.0.0

Merge pull request #74 from mackysoft/fix/release-pr-bundle-guard

fix(release): release PRのbundle版を検証する

4.0.0

Merge pull request #67 from mackysoft/feature/remove-agent-categories

refactor(agents)!: カテゴリ契約を削除する

3.0.0

Highlights

Agent Distribution 3.0 extends the distribution foundation from skills to custom agents. One schema 2 catalog can now ship both artifact kinds, with Agent → Skill as the only distribution dependency direction. Custom-agent artifacts are materialized for Codex, Claude Code, and GitHub Copilot.

This is the first release under the Agent Distribution identity.

Added

• Added schema 2 source and canonical bundle contracts with separate skills and agents namespaces.
• Added custom-agent list, export, install, update, uninstall, prune, and doctor operations, including transitive Skill dependency resolution.
• Added host-specific custom-agent adapters and target policies for Codex, Claude Code, and GitHub Copilot while keeping AGENT.md.template host-independent.
• Added external package-consumer verification for the library, hosted runtime, ConsoleAppFramework integration, standalone tool, and custom-agent export and installation on all three hosts.

Changed

• Breaking: Renamed the repository, NuGet package IDs, namespaces, assemblies, CLI executable, catalog identity, and managed state paths from Agent Skills to Agent Distribution.
• Breaking: Changed host literals to codex, claude-code, and github-copilot; previous host literals are not accepted as compatibility aliases.
• Breaking: The standalone command surface is now agent-distribution skills <operation> and agent-distribution agents <operation>. Embedded ConsoleAppFramework integration registers the sibling skills and agents resource groups at the product command root.
• Changed public path boundaries to typed MackySoft.FileSystem contracts and physical filesystem operations to MackySoft.FileSystem.Physical 0.2.1.

Removed

• Removed the previous MackySoft.AgentSkills identity. The new packages do not provide namespace, assembly, command, host-literal, or state-path aliases.
• Removed configurable parent command roots and other compatibility layers that duplicated or obscured the canonical contracts.

Migration

1. Replace MackySoft.AgentSkills with MackySoft.AgentDistribution.
2. Replace MackySoft.AgentSkills.Cli, .Hosting, and .ConsoleAppFramework with the corresponding MackySoft.AgentDistribution.* package IDs. Update all four packages together to 3.0.0.
3. Replace MackySoft.AgentSkills namespaces with MackySoft.AgentDistribution, and replace the agent-skills tool command with agent-distribution.
4. Add the explicit skills or agents resource group to standalone commands and update host literals to codex, claude-code, or github-copilot.
5. Update GitHub Action references to mackysoft/agent-distribution/actions/verify@3.0.0 and mackysoft/agent-distribution/actions/sync@3.0.0.
6. Review existing managed installations before the first 3.0 operation. Previous state paths are not treated as aliases for the new Agent Distribution state.

Included changes

• Added the custom-agent distribution foundation. (#65)
• Renamed the repository and all published identities to Agent Distribution. (#66)

Full Changelog: 2.0.0...3.0.0

2.0.0

Highlights

Agent Skills 2.0 makes bundle version changes explicit and scopes default skill installations by catalog. Product-owned catalogs can coexist under a host's skill root, while existing managed flat installations continue to be detected and updated in place.

Added

• Added --skill-bundle-version to agent-skills build and skill-bundle-version to the sync Action for selecting an exact current or next bundle version.
• Added catalog-scoped default installation directories for OpenAI / Codex and GitHub Copilot CLI.
• Added target selection across host-declared current and compatible locations, including structured failures for duplicate catalog installations, cross-catalog skill-name collisions, and unsafe paths.

Changed

• Breaking: Public bundle and manifest APIs now expose SkillBundleVersion instead of int.
• Breaking: Installation operations now require a catalog ID so install, update, uninstall, prune, and doctor resolve the same catalog-owned target.
• Changed normal bundle builds to preserve the version authored in bundle.json. Content changes no longer advance the bundle version implicitly.
• Changed new default installations to use a catalog subdirectory. Existing managed flat installations are reused without creating a duplicate installation.

Fixed

• Fixed first-time explicit-version publication when no generated bundle exists.
• Fixed publication failure and cancellation handling so generated output is restored or removed atomically.

Migration

1. Update MackySoft.AgentSkills, MackySoft.AgentSkills.Hosting, MackySoft.AgentSkills.ConsoleAppFramework, and MackySoft.AgentSkills.Cli together to 2.0.0.
2. Replace public integer bundle-version usage with SkillBundleVersion.
3. Supply the catalog ID when invoking installation and doctor services.
4. Update Action references to mackysoft/agent-skills/actions/verify@2.0.0 and mackysoft/agent-skills/actions/sync@2.0.0. Pass skill-bundle-version only when intentionally advancing or reconciling to an exact version.
5. Existing managed flat installations require no manual move. New default installations are created under the catalog-scoped location.

Included changes

• Added explicit bundle version targeting. (#62)
• Made first-time bundle publication transactional. (#63)
• Added catalog-scoped installation target selection. (#64)

Full Changelog: 1.0.0...2.0.0

1.0.0

Highlights

Agent Skills 1.0 establishes a canonical, category-based bundle workflow for defining, generating, shipping, and validating product-owned skills. Product repositories can keep authored definitions separate from generated packages, let the CLI reconcile bundle versions, and automate generation through the provided GitHub Actions.

Added

• Added canonical skill bundles with a source bundle.json, fixed-depth definitions/<category>/<skill-name> inputs, a generated bundle descriptor, complete package manifests, and deterministic digests.
• Added agent-skills build --root <path>. It reconciles source definitions, generated output, and skillBundleVersion; --check validates the same contract without writing files.
• Added separate verify and sync composite GitHub Actions. verify performs read-only source and generated-output validation. sync can generate changed output, advance the bundle version, create a github-actions[bot] commit, and push it to the current branch.
• Added the bundled basic/agent-skills-packaging skill and its public source-definition contract for adding, updating, and reviewing skills in Agent Skills products.
• Added typed bundle, category, host, and SHA-256 contracts, including SkillCategory, SkillHostKind, and Sha256Digest.
• Added public documentation for the source bundle.json and skill.json shapes, generated bundle and manifest metadata, and their ownership boundaries.

Changed

• Breaking: Replaced tiers with categories throughout source definitions, generated manifests, CLI selectors, Hosting requests, operation reports, and Core APIs. Use --category and the category-based APIs instead of --tier and tier types.
• Breaking: Source definitions now use definitions/<category>/<skill-name>. Category and skill name are derived from the directory structure, and references are derived from files under references; they are no longer repeated in skill.json.
• Breaking: Generated packages now require a root generated/bundle.json. Catalog identity, bundle version, and available categories are read from the shipped generated bundle instead of being configured separately by product code.
• Breaking: The build command now accepts one bundle --root instead of separate --definitionsRoot and --generatedRoot values. The generator replaces the complete generated bundle; generated files must not be edited manually.
• Breaking: AgentSkillsCommandRuntimeOptions.CatalogId and .Tiers were removed. Hosting consumers now configure the product and package location while catalog and category data come from the generated bundle.
• Breaking: Public request, report, host, digest, and manifest models now enforce their invariants through immutable and typed contracts. Code that constructed or deconstructed the previous record models, consumed tier properties, or treated host and digest values as strings must migrate to the 1.0 APIs.
• Breaking: Pre-1.0 generated and installed manifests containing tier are no longer accepted.
• Changed list without selectors to return every category in the shipped bundle. Other standard operations still require --category, --skill, or both.

Fixed

• Fixed operation and doctor reports so custom product emitters can obtain the normalized project repository root directly from the report. Doctor reports now also include host-specific reload guidance without requiring access to internal host adapters.

Migration

1. Update all MackySoft.AgentSkills NuGet package references and the MackySoft.AgentSkills.Cli local tool reference together to 1.0.0.
2. Add skills/bundle.json with an initial skillBundleVersion of 1. Move each definition to skills/definitions/<category>/<skill-name>, move catalog and bundle-wide values to bundle.json, and keep only schemaVersion, displayName, description, and dependencies in each skill.json.
3. Delete the old generated package set and run agent-skills build --root skills. Ship the complete new skills/generated directory, including its root bundle.json.
4. Remove CatalogId and Tiers assignments from Hosting registration. Update tier-based requests, reports, selectors, custom emitters, and manifest consumers to the category-based and typed 1.0 contracts.
5. Before replacing an existing product CLI, uninstall managed skills with the pre-1.0 CLI or remove their old managed skill directories. Tier-based installed manifests cannot be updated in place by 1.0.
6. Use actions/verify@1.0.0 for read-only checks. Use actions/sync@1.0.0 only in a branch workflow that grants contents: write and permits the bot to push to that branch.

Included changes

• Added and refined the Agent Skills packaging skill. (#58)
• Introduced the category-based 1.0 bundle contract and synchronization Actions. (#59)
• Completed operation and doctor report context for product-owned emitters. (#60)
• Published bundle metadata contracts and self-hosted the synchronization workflow. (#61)

Full Changelog: 0.8.2...1.0.0

0.8.2

Fixed

• Fixed generated ConsoleAppFramework command source formatting so product CLI projects can pass format checks after restoring MackySoft.AgentSkills.ConsoleAppFramework from NuGet.org.

Documentation

• Updated README package examples to use 0.8.2.

0.8.1

Added

• Added a repository-root resolver option to the hosting runtime so product CLIs can keep their own default project-root behavior when --repository-root is omitted.

Fixed

• Fixed ConsoleAppFramework integration so product CLI projects can build generated Agent Skills commands without duplicate generated source files.
• Fixed skills doctor for empty tier or skill selections so it reports a healthy empty result instead of a missing target.
• Fixed tier selection validation to reject values with extra whitespace instead of silently normalizing them.

Documentation

• Clarified product CLI setup for Hosting and ConsoleAppFramework integration, including command-root registration and product-owned compatibility decisions.

0.8.0

Added

• Added MackySoft.AgentSkills.Hosting, a reusable command runtime for product CLIs. It provides DI registration and product-neutral results for standard Agent Skills operations: list, export, install, update, uninstall, prune, and doctor.
• Added MackySoft.AgentSkills.ConsoleAppFramework, a source integration package for ConsoleAppFramework-based CLIs. Products can call RegisterAgentSkillsCommands() to add the standard Agent Skills command group to their existing app builder.
• Added managed orphan pruning. Products can remove installed managed skills that belong to the configured catalog but are no longer present in the current catalog, while preserving unmanaged targets and current catalog members.
• Added product-neutral command result types and command metadata for CLIs that need custom output envelopes or pre-dispatch command validation.

Changed

• Breaking: Renamed the public target-state enum from MackySoft.AgentSkills.Installation.State.SkillInstalledTargetStateKind to MackySoft.AgentSkills.Shared.SkillTargetStateKind. The enum now also includes RemovedFromCatalog for prune results.
• Added shared literal conversion APIs under MackySoft.AgentSkills.Shared.Text for code that needs to convert Agent Skills enum values to their canonical report and command literals.

Removed

• Breaking: Removed MackySoft.AgentSkills.OperationReports.Literals.SkillLiteralCodec. Code that used it should use MackySoft.AgentSkills.Shared.Text.ContractLiteralCodec with the relevant enum type instead.