@detergent-software/atk 8.0.1 → 8.0.2-dev.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [8.0.2-dev.1](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv8.0.1&targetVersion=GTv8.0.2-dev.1) (2026-10-01)
+
+### Documentation
+
+* **cli:** describe the Azure Pipelines release with npm staging ([ba1e08a](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/ba1e08a12f9d96a2e3101ab28a82f66460ebfbd2))
+
 ## [8.0.1](https://github.com/EmergentSoftware/agentic-toolkit-cli/compare/v8.0.0...v8.0.1) (2026-10-01)
 
 ### Bug Fixes

package/README.md

@@ -302,15 +302,19 @@ atk config org --reset
 
 ### Setup
 
+The CLI lives in `apps/cli` of the `Emergent.AgenticToolkit` monorepo in Azure DevOps. Install from the repository root (pnpm workspace), then run the commands from `apps/cli` or with `pnpm -C apps/cli <command>`:
+
 ```bash
-git clone https://github.com/EmergentSoftware/agentic-toolkit-cli.git
-cd agentic-toolkit-cli
+git clone https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit
+cd Emergent.AgenticToolkit
 pnpm install
-pnpm build
+pnpm -C apps/cli build
 ```
 
 ### Commands
 
+Run from `apps/cli`:
+
 ```bash
 pnpm dev              # Watch mode (tsc --watch)
 pnpm build            # Full TypeScript build
@@ -357,20 +361,19 @@ All commits must follow the Conventional Commits format. The commit type determi
 | `chore:`                      | No release      | `chore: update dev dependencies`    |
 | `feat!:` / `BREAKING CHANGE:` | Major (`x.0.0`) | `feat!: redesign config format`     |
 
-#### Commitlint
+Only commits that change files under `apps/cli/` count toward a CLI release. Commits elsewhere in the monorepo (the API, infra, pipelines) never release the CLI.
 
-Commit messages are validated by [commitlint](https://commitlint.js.org/) (extending `@commitlint/config-conventional`) in two places:
+#### Commitlint
 
-- **Locally** — via a commit-msg Git hook that checks messages before they are committed
-- **CI** — the Validate workflow lints all commit messages in a PR against the base branch
+Commit messages are validated by [commitlint](https://commitlint.js.org/) (extending `@commitlint/config-conventional`, config at the repository root). The `atk-ci` pipeline lints every commit in a pull request. Non-conforming commits fail the PR build.
 
-Non-conforming commits will be rejected.
+Complete pull requests with **Merge (no fast-forward)**, not squash. The squash commit message (`Merged PR 1234: …`) is not a conventional commit, so semantic-release would ignore the change.
 
 #### Semantic Release
 
-[semantic-release](https://semantic-release.gitbook.io/) automates versioning, changelog generation, npm publishing, git tagging, and GitHub Releases based on commit messages. No manual version bumps are needed — the version in `package.json` is managed entirely by the pipeline.
+[semantic-release](https://semantic-release.gitbook.io/) automates versioning, changelog generation and git tagging from commit messages. No manual version bumps are needed: the pipeline manages the version in `package.json`.
 
-The release workflow runs on two branches:
+The `atk-cli-release` Azure Pipeline (`pipelines/release-cli.yml`) runs on push to two branches:
 
 | Branch    | Trigger                  | npm Tag  | Version Format | Example       |
 | --------- | ------------------------ | -------- | -------------- | ------------- |
@@ -379,17 +382,25 @@ The release workflow runs on two branches:
 
 **Pipeline steps:**
 
-1. **Release** — on push to `main` or `develop`, invokes `semantic-release` which:
-   - Analyzes commits since the last release to determine the version bump
+1. Lint, type check, test and build the CLI.
+2. Run `semantic-release`, which:
+   - Analyzes the `apps/cli/` commits since the last release to determine the version bump
    - Generates release notes grouped by type (Features, Bug Fixes, Performance, etc.)
-   - Updates `CHANGELOG.md`
-   - Publishes the package to npm
-   - Creates a git tag and GitHub Release
-   - Commits the updated changelog and `package.json` version
+   - Updates `CHANGELOG.md` and the `package.json` version, commits them as `chore(release): x.y.z [skip ci]` and tags `vx.y.z`
+3. **Stage** the version on npm with `npm stage publish`. The run summary prints the stage id.
+
+A staged version is not installable until an npm maintainer approves it with two-factor authentication:
+
+```bash
+npm stage view <stage-id>                   # inspect it first
+npm stage approve <stage-id> --otp=<code>   # publish it to the dist-tag
+```
+
+Rejecting a stage (`npm stage reject <stage-id> --otp=<code>`) leaves its git tag in place, so the next release takes the next number. Never delete release tags.
 
 #### PR Validation
 
-Pull requests targeting `main` or `develop` run linting, type checking, tests, and commitlint.
+Pull requests targeting `main` or `develop` that touch `apps/cli/` run the `atk-cli-ci` pipeline: linting, type checking, tests, build, and a check that every release tag still has a `CHANGELOG.md` section. Keep both sides' `CHANGELOG.md` sections when merging `main` back into `develop`.
 
 ## Tech Stack
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@detergent-software/atk",
-	"version": "8.0.1",
+	"version": "8.0.2-dev.1",
 	"description": "Agentic Tool Kit — CLI for managing AI coding tool assets.",
 	"type": "module",
 	"bin": {
@@ -28,7 +28,8 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/EmergentSoftware/agentic-toolkit-cli.git"
+		"url": "https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit",
+		"directory": "apps/cli"
 	},
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org",
@@ -37,13 +38,6 @@
 	"engines": {
 		"node": ">=24.0.0"
 	},
-	"packageManager": "pnpm@10.5.2",
-	"pnpm": {
-		"patchedDependencies": {
-			"pastel@4.0.0": "patches/pastel@4.0.0.patch",
-			"ink-testing-library": "patches/ink-testing-library.patch"
-		}
-	},
 	"dependencies": {
 		"@azure/msal-node": "^6.0.0",
 		"chalk": "^5.4.0",
@@ -58,12 +52,12 @@
 		"zod": "^4.0.0"
 	},
 	"devDependencies": {
-		"@commitlint/cli": "^20.4.2",
-		"@commitlint/config-conventional": "^20.4.2",
 		"@eslint/js": "^9.0.0",
 		"@hey-api/openapi-ts": "0.99.0",
 		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/commit-analyzer": "^13.0.1",
 		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/release-notes-generator": "^14.1.0",
 		"@testing-library/react": "^16.0.0",
 		"@types/diff": "^7.0.0",
 		"@types/node": "^24.0.0",