Per-Aspera-LLC · perasperaactual · May 15, 2026 · May 15, 2026 · May 15, 2026
diff --git a/.changeset/fix-js-yaml-override-conflict.md b/.changeset/fix-js-yaml-override-conflict.md
@@ -0,0 +1,5 @@
+---
+"@stackwright/cli": patch
+---
+
+Fix js-yaml version override conflict in pnpm overrides that caused `yaml.safeLoad is removed` errors when running `changeset pre exit` in CI. The global `js-yaml: >=4.1.1` override was stomping the scoped `read-yaml-file>js-yaml: ^3` override, forcing js-yaml v4 into read-yaml-file which doesn't support it.
diff --git a/.changeset/pre.json b/.changeset/pre.json
@@ -23,10 +23,14 @@
   },
   "changesets": [
     "collection-provider-interfaces-to-types",
+    "collections-types-cleanup",
     "fix-cli-bundle-workspace-deps",
     "fix-core-dts-zod-compat",
+    "fix-js-yaml-override-conflict",
     "fix-scaffold-template-versions",
     "fix-types-prebuild-plugin-zod-compat",
+    "generate-agent-docs-interfaces",
+    "hookhandler-reexport",
     "remove-workspace-prepublish-guard",
     "scaffold-hook-interfaces-to-types",
     "workspace-publish-guards",

diff --git a/package.json b/package.json
@@ -93,11 +93,10 @@
             "@hono/node-server": ">=1.19.13",
             "basic-ftp": ">=5.3.1",
             "express-rate-limit": ">=8.2.2",
-	    "uuid": ">=14.0.0",
-	    "fast-uri": ">=3.1.2",
-	    "js-yaml": ">=4.1.1",
-	    "read-yaml-file>js-yaml": "^3",
-	    "postcss": ">=8.5.10"
+            "uuid": ">=14.0.0",
+            "fast-uri": ">=3.1.2",
+            "read-yaml-file>js-yaml": "^3",
+            "postcss": ">=8.5.10"
         },
         "onlyBuiltDependencies": [
             "@swc/core",

diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @stackwright/cli
 
+## 0.8.5-alpha.1
+
+### Patch Changes
+
+- 182a4da: Fix js-yaml version override conflict in pnpm overrides that caused `yaml.safeLoad is removed` errors when running `changeset pre exit` in CI. The global `js-yaml: >=4.1.1` override was stomping the scoped `read-yaml-file>js-yaml: ^3` override, forcing js-yaml v4 into read-yaml-file which doesn't support it.
+- e6b3459: feat(cli): generate-agent-docs now emits an interface contracts table
+
+  A new auto-generated section in AGENTS.md documents the TypeScript interface
+  contracts defined in `@stackwright/types`:
+  - CollectionProvider, CollectionEntry, CollectionListOptions, CollectionListResult
+  - ScaffoldHookContext, ScaffoldHook, HookHandler, ScaffoldHookType
+
+  The section is delimited by `<!-- stackwright:interface-table:start/end -->` markers
+  and updated by `pnpm stackwright -- generate-agent-docs` alongside the existing
+  content-type-table. This completes Phase 1 step 8 of the types-hierarchy-refactor.
+
 ## 0.8.5-alpha.0
 
 ### Patch Changes

diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@stackwright/cli",
-  "version": "0.8.5-alpha.0",
+  "version": "0.8.5-alpha.1",
   "description": "CLI for Stackwright framework",
   "license": "MIT",
   "repository": {

diff --git a/packages/collections/CHANGELOG.md b/packages/collections/CHANGELOG.md
@@ -1,5 +1,19 @@
 # @stackwright/collections
 
+## 0.1.1-alpha.4
+
+### Patch Changes
+
+- e6b3459: chore(collections): remove duplicate CollectionProvider definitions
+
+  `file-collection-provider.ts` now imports `CollectionProvider`, `CollectionEntry`,
+  `CollectionListOptions`, and `CollectionListResult` directly from `@stackwright/types`
+  rather than from the local `./types` file.
+
+  `types.ts` is converted to a re-export shim so any unexpected downstream imports
+  remain backward-compatible. This completes the Phase 1 cleanup from the
+  types-hierarchy-refactor.
+
 ## 0.1.1-alpha.3
 
 ### Patch Changes

diff --git a/packages/collections/package.json b/packages/collections/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@stackwright/collections",
-  "version": "0.1.1-alpha.3",
+  "version": "0.1.1-alpha.4",
   "description": "CollectionProvider interface and file-backed implementation for Stackwright",
   "license": "MIT",
   "repository": {

diff --git a/packages/hooks-registry/CHANGELOG.md b/packages/hooks-registry/CHANGELOG.md
@@ -1,5 +1,20 @@
 # @stackwright/hooks-registry
 
+## 0.1.1-alpha.3
+
+### Patch Changes
+
+- e6b3459: fix(scaffold-core): export HookHandler type from hooks-registry and scaffold-core
+
+  `HookHandler` is the canonical type alias for scaffold hook handler functions,
+  defined in `@stackwright/types`. It was re-exported by `hooks-registry/src/hooks.ts`
+  but not forwarded through `index.ts`, making it unavailable via the public package
+  import paths.
+
+  Both `@stackwright/hooks-registry` and `@stackwright/scaffold-core` now re-export
+  `HookHandler` alongside the other scaffold hook types. This completes Phase 1 step 4
+  of the types-hierarchy-refactor.
+
 ## 0.1.1-alpha.2
 
 ### Patch Changes

diff --git a/packages/hooks-registry/package.json b/packages/hooks-registry/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@stackwright/hooks-registry",
-    "version": "0.1.1-alpha.2",
+    "version": "0.1.1-alpha.3",
     "description": "Singleton registry for scaffold hooks - survives module boundary crossings",
     "license": "MIT",
     "repository": {

diff --git a/packages/launch-stackwright/CHANGELOG.md b/packages/launch-stackwright/CHANGELOG.md
@@ -1,5 +1,15 @@
 # launch-stackwright
 
+## 0.2.5-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [182a4da]
+- Updated dependencies [e6b3459]
+- Updated dependencies [e6b3459]
+  - @stackwright/cli@0.8.5-alpha.1
+  - @stackwright/scaffold-core@0.3.1-alpha.3
+
 ## 0.2.5-alpha.2
 
 ### Patch Changes

diff --git a/packages/launch-stackwright/package.json b/packages/launch-stackwright/package.json
@@ -1,6 +1,6 @@
 {
   "name": "launch-stackwright",
-  "version": "0.2.5-alpha.2",
+  "version": "0.2.5-alpha.3",
   "description": "Launch a new Stackwright project with the otter raft ready to build",
   "license": "MIT",
   "repository": {

diff --git a/packages/mcp/CHANGELOG.md b/packages/mcp/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @stackwright/mcp
 
+## 0.4.5-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [182a4da]
+- Updated dependencies [e6b3459]
+  - @stackwright/cli@0.8.5-alpha.1
+
 ## 0.4.5-alpha.3
 
 ### Patch Changes

diff --git a/packages/mcp/package.json b/packages/mcp/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@stackwright/mcp",
-    "version": "0.4.5-alpha.3",
+    "version": "0.4.5-alpha.4",
     "description": "MCP server for Stackwright — exposes content types, page management, and validation as agent tools",
     "license": "MIT",
     "repository": {

diff --git a/packages/scaffold-core/CHANGELOG.md b/packages/scaffold-core/CHANGELOG.md
@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.3.1-alpha.3
+
+### Patch Changes
+
+- e6b3459: fix(scaffold-core): export HookHandler type from hooks-registry and scaffold-core
+
+  `HookHandler` is the canonical type alias for scaffold hook handler functions,
+  defined in `@stackwright/types`. It was re-exported by `hooks-registry/src/hooks.ts`
+  but not forwarded through `index.ts`, making it unavailable via the public package
+  import paths.
+
+  Both `@stackwright/hooks-registry` and `@stackwright/scaffold-core` now re-export
+  `HookHandler` alongside the other scaffold hook types. This completes Phase 1 step 4
+  of the types-hierarchy-refactor.
+
+- Updated dependencies [e6b3459]
+  - @stackwright/hooks-registry@0.1.1-alpha.3
+
 ## 0.3.1-alpha.2
 
 ### Patch Changes

diff --git a/packages/scaffold-core/package.json b/packages/scaffold-core/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@stackwright/scaffold-core",
-    "version": "0.3.1-alpha.2",
+    "version": "0.3.1-alpha.3",
     "description": "Scaffold hooks system for Stackwright - enables extensible post-scaffold processing",
     "license": "MIT",
     "repository": {

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml