@atlaskit/ads-mcp 1.7.3 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @atlaskit/ads-mcp
 
+## 1.8.0
+
+### Minor Changes
+
+- [`7b42e3dbea8db`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/7b42e3dbea8db) -
+  Add an opt-in `includeMetadata` option to ADS MCP token search so callers can retrieve token usage
+  guidelines while existing searches remain compact by default.
+
+  ```ts
+  import { searchTokensTool } from '@atlaskit/ads-mcp/tools/search-tokens';
+
+  await searchTokensTool({
+  	terms: ['border.width.focused'],
+  	includeMetadata: true,
+  });
+  ```
+
+  Metadata-inclusive results contain the existing `name` and `exampleValue` fields plus
+  `usageGuidelines`:
+
+  ```json
+  {
+  	"name": "border.width.focused",
+  	"exampleValue": "0.125rem",
+  	"usageGuidelines": {
+  		"usage": "Controls the thickness of borders/dividers. Use to standardize border widths throughout UI.",
+  		"cssProperties": ["border-width"]
+  	}
+  }
+  ```
+
+## 1.7.4
+
+### Patch Changes
+
+- [`b1775a76f7dfe`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b1775a76f7dfe) -
+  Regenerate the ADS and Atlaskit MCP structured-content catalogs and document their AFM-to-skills
+  distribution workflow.
+- Updated dependencies
+
 ## 1.7.3
 
 ### Patch Changes

package/README.md

@@ -466,14 +466,17 @@ yarn workspace @af/ads-ai-tooling codegen
 ```
 
 2. Commit updated generated MCP outputs in this package.
-3. Create and ship the `@atlaskit/ads-mcp` changeset/release as usual.
-4. Wait for the package publish.
-5. Renovate should bump it in
+3. Add a `platform/.changeset/*.md` entry for `@atlaskit/ads-mcp` in the same PR. Use `patch` for
+   catalog or documentation refreshes; use `minor` or `major` when the package API changes.
+4. Create and ship the `@atlaskit/ads-mcp` release as usual.
+5. Wait for the package publish.
+6. Renovate should bump it in
    [atlassian-mcp-micros](https://bitbucket.org/atlassian/atlassian-mcp-micros/).
-6. Redeploy `atlassian-mcp-micros` after the bump lands (async pipeline).
+7. Redeploy `atlassian-mcp-micros` after the bump lands (async pipeline).
 
-For other generated targets (skills/DESIGN.md/offerings), follow `platform/tmp/*-instructions.md`
-and the destination README in `atlassian/skills`.
+For generated skills and DESIGN.md output, use the cross-repository sync workflow in
+`packages/design-system/ai-tooling/README.md`, then follow the destination README in
+`atlassian/skills`. The codegen runner does not create instruction files under `platform/tmp/`.
 
 ## FAQs