build: add publish-readiness gates

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": ["@changesets/cli/changelog", null],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.changeset/fresh-publish-gates.md

@@ -0,0 +1,15 @@
+---
+"@agent-trail/adapter-kit": patch
+"@agent-trail/adapters": patch
+"@agent-trail/catalog": patch
+"@agent-trail/core": patch
+"@agent-trail/redact": patch
+"@agent-trail/render-model": patch
+"@agent-trail/schema": patch
+"@agent-trail/sessions": patch
+"@agent-trail/source-schemas": patch
+"@agent-trail/store": patch
+"@agent-trail/types": patch
+---
+
+Add publish-readiness checks and package metadata for SDK release preparation.

.github/PULL_REQUEST_TEMPLATE.md

@@ -13,6 +13,7 @@
 - [ ] No public contract change
 - [ ] Spec or schema change
 - [ ] Public package API change
+- [ ] Changeset added or explicitly not needed
 - [ ] CLI behavior change
 - [ ] Public URL or docs behavior change
 

.github/workflows/guardrails.yml

@@ -19,7 +19,14 @@ jobs:
     steps:
       - uses: actions/checkout@9f698171ed81b15d1823a05fc7211befd50c8ae0 # v6.0.3
         with:
+          fetch-depth: 0
           persist-credentials: false
       - uses: jdx/mise-action@dba19683ed58901619b14f395a24841710cb4925 # v4.1.0
+      - name: Install dependencies
+        if: github.event_name == 'pull_request'
+        run: mise run install
+      - name: Check changeset status
+        if: github.event_name == 'pull_request'
+        run: mise x -- bun run check:changesets
       - name: Run repository checks
         run: mise run check

.github/workflows/pkg-pr-new.yml

@@ -0,0 +1,33 @@
+name: pkg-pr-new
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+permissions:
+  contents: read
+  pull-requests: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  preview:
+    if: github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9f698171ed81b15d1823a05fc7211befd50c8ae0 # v6.0.3
+        with:
+          persist-credentials: false
+          ref: ${{ github.event.pull_request.head.sha }}
+      - uses: jdx/mise-action@dba19683ed58901619b14f395a24841710cb4925 # v4.1.0
+      - name: Install dependencies
+        run: mise run install
+      - name: Build packages
+        run: bun run build:declarations
+      - name: Publish preview packages
+        run: bun run preview:packages

package.json

@@ -7,26 +7,36 @@
     "packages/*"
   ],
   "scripts": {
-    "check": "bun run --parallel check:biome check:types test check:exports check:spec check:source-types check:api check:fallow",
-    "check:api": "bun run build:declarations && bun run scripts/check-api.ts",
+    "check": "bun run build:declarations && bun run --parallel check:biome check:types test check:exports check:spec check:source-types check:api:reports check:publish:packed check:fallow",
+    "check:api": "bun run build:declarations && bun run check:api:reports",
+    "check:api:reports": "bun run scripts/check-api.ts",
     "check:biome": "biome check .",
+    "check:changesets": "changeset status --since=origin/main",
+    "check:declaration-dependent": "bun run build:declarations && bun run --parallel check:api:reports check:publish:packed",
     "check:exports": "bun run scripts/check-exports.ts",
     "check:fallow": "fallow --fail-on-issues --format compact",
+    "check:publish": "bun run build:declarations && bun run check:publish:packed",
+    "check:publish:packed": "bun run scripts/check-publish-readiness.ts",
     "check:spec": "bun run scripts/check-spec-artifacts.ts",
     "check:source-types": "bun run scripts/generate-source-types.ts --check",
     "check:types": "tsc --noEmit",
     "build:declarations": "bun run scripts/build-api-declarations.ts",
     "generate:source-types": "bun run scripts/generate-source-types.ts",
     "generate:types": "bun run scripts/generate-types.ts",
+    "preview:packages": "pkg-pr-new publish './packages/*' --bun --packageManager bun,npm",
     "vendor:spec": "bun run scripts/vendor-spec.ts",
-    "test": "bun test"
+    "test": "bun test --parallel=4"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.3",
     "@biomejs/biome": "2.5.0",
+    "@changesets/cli": "2.31.0",
     "@microsoft/api-extractor": "7.58.9",
     "@types/bun": "1.3.14",
     "fallow": "2.95.0",
     "json-schema-to-typescript": "15.0.4",
+    "pkg-pr-new": "0.0.75",
+    "publint": "0.3.21",
     "typescript": "6.0.3"
   }
 }

packages/adapter-kit/package.json

@@ -25,13 +25,13 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/agent-trail/agent-trail.git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
     "directory": "packages/adapter-kit"
   },
   "bugs": {
-    "url": "https://github.com/agent-trail/agent-trail/issues"
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
   },
-  "homepage": "https://github.com/agent-trail/agent-trail#readme",
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
   "engines": {
     "node": ">=20"
   },

packages/adapters/package.json

@@ -22,13 +22,13 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/agent-trail/agent-trail.git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
     "directory": "packages/adapters"
   },
   "bugs": {
-    "url": "https://github.com/agent-trail/agent-trail/issues"
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
   },
-  "homepage": "https://github.com/agent-trail/agent-trail#readme",
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
   "engines": {
     "node": ">=20"
   },

packages/catalog/package.json

@@ -17,5 +17,17 @@
       "default": "./dist/index.js"
     },
     "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
+    "directory": "packages/catalog"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
+  },
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
+  "engines": {
+    "node": ">=20"
   }
 }

packages/core/package.json

@@ -31,5 +31,17 @@
     "@agent-trail/types": "workspace:*",
     "ajv": "8.20.0",
     "json-canonicalize": "2.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
+  },
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
+  "engines": {
+    "node": ">=20"
   }
 }

packages/redact/package.json

@@ -23,5 +23,17 @@
     "@redactpii/node": "1.0.17",
     "safe-regex2": "5.1.1",
     "yaml": "2.9.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
+    "directory": "packages/redact"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
+  },
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
+  "engines": {
+    "node": ">=20"
   }
 }

packages/schema/package.json

@@ -24,5 +24,17 @@
     },
     "./fixtures/validation/*": "./fixtures/validation/*",
     "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
+    "directory": "packages/schema"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
+  },
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
+  "engines": {
+    "node": ">=20"
   }
 }

packages/source-schemas/package.json

@@ -50,13 +50,13 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/agent-trail/agent-trail.git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
     "directory": "packages/source-schemas"
   },
   "bugs": {
-    "url": "https://github.com/agent-trail/agent-trail/issues"
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
   },
-  "homepage": "https://github.com/agent-trail/agent-trail#readme",
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
   "engines": {
     "node": ">=20"
   }

packages/store/package.json

@@ -21,5 +21,17 @@
   "dependencies": {
     "@agent-trail/catalog": "workspace:*",
     "@agent-trail/core": "workspace:*"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
+    "directory": "packages/store"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
+  },
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
+  "engines": {
+    "node": ">=20"
   }
 }

packages/types/package.json

@@ -16,5 +16,17 @@
       "types": "./dist/index.d.ts"
     },
     "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-trail/typescript-sdk.git",
+    "directory": "packages/types"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-trail/typescript-sdk/issues"
+  },
+  "homepage": "https://github.com/agent-trail/typescript-sdk#readme",
+  "engines": {
+    "node": ">=20"
   }
 }

packages/types/src/index.ts

@@ -1,9 +1,11 @@
-export type * from "./generated";
+import type { SemanticMetadata, SourceMetadata, TaskPlanItem } from "./generated.js";
+
+export type * from "./generated.js";
 export type {
   AgentTrailV010 as TrailRecord,
   Entry as TrailEntry,
   Header as SessionHeader,
-} from "./generated";
-export type AgentName = NonNullable<import("./generated").SourceMetadata["agent"]>;
-export type ToolKind = NonNullable<import("./generated").SemanticMetadata["tool_kind"]>;
-export type TaskPlanStatus = import("./generated").TaskPlanItem["status"];
+} from "./generated.js";
+export type AgentName = NonNullable<SourceMetadata["agent"]>;
+export type ToolKind = NonNullable<SemanticMetadata["tool_kind"]>;
+export type TaskPlanStatus = TaskPlanItem["status"];