feat: improve docs running

apps/api/package.json

@@ -34,8 +34,8 @@
     "@agentic/platform-hono": "workspace:*",
     "@agentic/platform-types": "workspace:*",
     "@agentic/platform-validators": "workspace:*",
-    "@dicebear/collection": "^9.2.3",
+    "@dicebear/collection": "catalog:",
-    "@dicebear/core": "^9.2.3",
+    "@dicebear/core": "catalog:",
     "@fisch0920/drizzle-orm": "catalog:",
     "@fisch0920/drizzle-zod": "catalog:",
     "@hono/node-server": "catalog:",

apps/web/package.json

@@ -25,7 +25,7 @@
     "@agentic/platform-core": "workspace:*",
     "@agentic/platform-types": "workspace:*",
     "@agentic/platform-validators": "workspace:*",
-    "@date-fns/utc": "^2.1.0",
+    "@date-fns/utc": "catalog:",
     "@number-flow/react": "catalog:",
     "@pmndrs/assets": "catalog:",
     "@radix-ui/react-dropdown-menu": "catalog:",
@@ -45,7 +45,7 @@
     "canvas-confetti": "catalog:",
     "class-variance-authority": "catalog:",
     "clsx": "catalog:",
-    "date-fns": "^4.1.0",
+    "date-fns": "catalog:",
     "hast-util-to-jsx-runtime": "catalog:",
     "ky": "catalog:",
     "lucide-react": "catalog:",

docs/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "docs",
+  "private": true,
+  "author": "Travis Fischer <travis@transitivebullsh.it>",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/transitive-bullshit/agentic.git"
+  },
+  "type": "module",
+  "scripts": {
+    "docs": "mint dev",
+    "test": "run-s test:*",
+    "test:broken-links": "mint broken-links"
+  },
+  "devDependencies": {
+    "mint": "catalog:"
+  }
+}

package.json

@@ -7,7 +7,7 @@
     "type": "git",
     "url": "git+https://github.com/transitive-bullshit/agentic.git"
   },
-  "packageManager": "pnpm@10.12.3",
+  "packageManager": "pnpm@10.12.4",
   "engines": {
     "node": ">=20"
   },
@@ -15,7 +15,7 @@
   "scripts": {
     "build": "turbo build --filter=!web",
     "dev": "turbo dev --continue --filter=!./examples/*",
-    "docs": "cd docs && mint dev",
+    "docs": "turbo run docs",
     "clean": "turbo clean",
     "fix": "run-s fix:*",
     "fix:format": "prettier --write \"**/*.{js,ts,tsx}\"",
@@ -41,7 +41,6 @@
     "eslint-plugin-drizzle": "catalog:",
     "knip": "catalog:",
     "lint-staged": "catalog:",
-    "mint": "^4.1.97",
     "npm-run-all2": "catalog:",
     "only-allow": "catalog:",
     "prettier": "catalog:",

packages/core/package.json

@@ -27,7 +27,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@sindresorhus/slugify": "^2.2.1",
+    "@sindresorhus/slugify": "catalog:",
     "decircular": "catalog:",
     "is-obj": "catalog:",
     "parse-json": "catalog:",

pnpm-workspace.yaml

@@ -3,58 +3,67 @@ packages:
   - apps/*
   - examples/*
   - packages/fixtures/valid/*
-
+  - docs
+ignoredBuiltDependencies:
+  - "@fisch0920/config"
+  - puppeteer
+onlyBuiltDependencies:
+  - "@sentry/cli"
 catalog:
-  '@agentic/core': ^7.6.7
+  "@agentic/core": ^7.6.7
-  '@agentic/serper': ^7.6.7
+  "@agentic/serper": ^7.6.7
-  '@ai-sdk/openai': ^1.3.22
+  "@ai-sdk/openai": ^1.3.22
-  '@apideck/better-ajv-errors': ^0.3.6
+  "@apideck/better-ajv-errors": ^0.3.6
-  '@clack/prompts': 0.11.0
+  "@clack/prompts": 0.11.0
-  '@cloudflare/workers-types': ^4.20250620.0
+  "@cloudflare/workers-types": ^4.20250620.0
-  '@commander-js/extra-typings': ^14.0.0
+  "@commander-js/extra-typings": ^14.0.0
-  '@dotenvx/dotenvx': ^1.45.1
+  "@date-fns/utc": ^2.1.0
-  '@edge-runtime/vm': ^5.0.0
+  "@dicebear/collection": ^9.2.3
-  '@fisch0920/config': ^1.1.3
+  "@dicebear/core": ^9.2.3
-  '@fisch0920/drizzle-orm': ^0.43.7
+  "@dotenvx/dotenvx": ^1.45.1
-  '@fisch0920/drizzle-zod': ^0.7.9
+  "@edge-runtime/vm": ^5.0.0
-  '@hono/mcp': ^0.1.0
+  "@fisch0920/config": ^1.1.3
-  '@hono/node-server': 1.14.4
+  "@fisch0920/drizzle-orm": ^0.43.7
-  '@hono/sentry': ^1.2.2
+  "@fisch0920/drizzle-zod": ^0.7.9
-  '@hono/zod-openapi': ^0.19.8
+  "@hono/mcp": ^0.1.0
-  '@hono/zod-validator': ^0.7.0
+  "@hono/node-server": 1.14.4
-  '@modelcontextprotocol/sdk': ^1.13.0
+  "@hono/sentry": ^1.2.2
-  '@number-flow/react': ^0.5.10
+  "@hono/zod-openapi": ^0.19.8
-  '@paralleldrive/cuid2': ^2.2.2
+  "@hono/zod-validator": ^0.7.0
-  '@pmndrs/assets': ^1.7.0
+  "@modelcontextprotocol/sdk": ^1.13.0
-  '@radix-ui/react-dropdown-menu': ^2.1.15
+  "@number-flow/react": ^0.5.10
-  '@radix-ui/react-label': ^2.1.7
+  "@paralleldrive/cuid2": ^2.2.2
-  '@radix-ui/react-slot': ^1.2.3
+  "@pmndrs/assets": ^1.7.0
-  '@radix-ui/react-tabs': ^1.1.12
+  "@radix-ui/react-dropdown-menu": ^2.1.15
-  '@radix-ui/react-tooltip': ^1.2.7
+  "@radix-ui/react-label": ^2.1.7
-  '@react-email/components': ^0.1.0
+  "@radix-ui/react-slot": ^1.2.3
-  '@react-three/cannon': ^6.6.0
+  "@radix-ui/react-tabs": ^1.1.12
-  '@react-three/drei': ^10.2.0
+  "@radix-ui/react-tooltip": ^1.2.7
-  '@react-three/fiber': ^9.1.2
+  "@react-email/components": ^0.1.0
-  '@react-three/postprocessing': ^3.0.4
+  "@react-three/cannon": ^6.6.0
-  '@react-three/rapier': ^2.1.0
+  "@react-three/drei": ^10.2.0
-  '@redocly/openapi-core': ^1.34.3
+  "@react-three/fiber": ^9.1.2
-  '@sentry/cli': ^2.46.0
+  "@react-three/postprocessing": ^3.0.4
-  '@sentry/cloudflare': ^9.30.0
+  "@react-three/rapier": ^2.1.0
-  '@sentry/core': ^9.30.0
+  "@redocly/openapi-core": ^1.34.3
-  '@sentry/node': ^9.30.0
+  "@sentry/cli": ^2.46.0
-  '@standard-schema/spec': ^1.0.0
+  "@sentry/cloudflare": ^9.30.0
-  '@tailwindcss/postcss': ^4.1.10
+  "@sentry/core": ^9.30.0
-  '@tailwindcss/typography': ^0.5.16
+  "@sentry/node": ^9.30.0
-  '@tanstack/react-form': ^1.12.3
+  "@sindresorhus/slugify": ^2.2.1
-  '@tanstack/react-query': ^5.80.10
+  "@standard-schema/spec": ^1.0.0
-  '@tanstack/react-query-devtools': ^5.80.10
+  "@tailwindcss/postcss": ^4.1.10
-  '@types/canvas-confetti': ^1.9.0
+  "@tailwindcss/typography": ^0.5.16
-  '@types/ms': ^2.1.0
+  "@tanstack/react-form": ^1.12.3
-  '@types/node': ^24.0.4
+  "@tanstack/react-query": ^5.80.10
-  '@types/react': ^19.1.8
+  "@tanstack/react-query-devtools": ^5.80.10
-  '@types/react-dom': ^19.1.6
+  "@types/canvas-confetti": ^1.9.0
-  '@types/semver': ^7.7.0
+  "@types/ms": ^2.1.0
-  '@types/three': ^0.177.0
+  "@types/node": ^24.0.6
+  "@types/react": ^19.1.8
+  "@types/react-dom": ^19.1.6
+  "@types/semver": ^7.7.0
+  "@types/three": ^0.177.0
   agents: ^0.0.95
   ai: ^4.3.15
   ajv: ^8.17.1
@@ -69,6 +78,7 @@ catalog:
   clsx: ^2.1.1
   commander: ^14.0.0
   conf: ^14.0.0
+  date-fns: ^4.1.0
   decamelize: ^6.0.0
   decircular: ^1.0.0
   del-cli: ^6.0.0
@@ -76,7 +86,7 @@ catalog:
   drizzle-kit: ^0.31.1
   drizzle-orm: ^0.44.2
   email-validator: ^2.0.4
-  eslint: ^9.29.0
+  eslint: ^9.30.0
   eslint-plugin-drizzle: ^0.2.3
   eventid: ^2.0.1
   exit-hook: 4.0.0
@@ -93,6 +103,7 @@ catalog:
   ky: 1.8.1
   lint-staged: ^16.1.2
   lucide-react: ^0.518.0
+  mint: ^4.1.97
   motion: ^12.18.1
   ms: ^2.1.3
   next: ^15.3.4
@@ -112,7 +123,7 @@ catalog:
   postcss: ^8.5.6
   postgres: ^3.4.7
   posthog-js: ^1.255.0
-  prettier: ^3.6.0
+  prettier: ^3.6.2
   react: ^19.1.0
   react-dom: ^19.1.0
   react-email: ^4.0.16
@@ -145,9 +156,3 @@ catalog:
   zod: ^3.25.67
   zod-to-json-schema: ^3.24.5
   zod-validation-error: ^3.5.2
-
-ignoredBuiltDependencies:
-  - '@fisch0920/config'
-
-onlyBuiltDependencies:
-  - '@sentry/cli'

readme.md

@@ -17,21 +17,11 @@
   - webapp
     - consider a PrettyJson component which displays json but links to resources
   - stripe
-    - stripe checkout for changing plans? (need to at least be able to upgrade)
+    - double check stripe upgrade flow and add fireworks
     - should we bypass stripe for `free` plans to increase conversions?
   - handle browser back/forward with `?next=`
   - add some social proof to signup page
   - empty dashboard; add some CTAs
-- **API gateway**
-  - oauth flow
-    - https://docs.scalekit.com/guides/mcp/oauth
-    - custom oauth flow might need to use separate domains per project instead of separate pathnames?
-      - since the .well-known routes and standard oauth 2.1 routes are all at the top-level?
-  - **e2e tests for usage tracking and reporting**
-- marketplace
-  - may need a different flag besides `private` for inclusion on the marketplace
-    - projects may be public but not accepted into the marketplace?
-    - => **punt on this for mvp**
 - docs
   - main readme
   - sub readmes
@@ -42,9 +32,20 @@
 - simplify `AgenticToolClient` and only require one package per TS LLM SDK
   - `createAISDKToolsFromIdentifier(projectIdentifier)`
 - add really strict free rate-limits to `@agentic/search`
+-
 
 ## TODO: Post-MVP
 
+- **API gateway**
+  - oauth flow
+    - https://docs.scalekit.com/guides/mcp/oauth
+    - custom oauth flow might need to use separate domains per project instead of separate pathnames?
+      - since the .well-known routes and standard oauth 2.1 routes are all at the top-level?
+  - **e2e tests for usage tracking and reporting**
+- marketplace
+  - may need a different flag besides `private` for inclusion on the marketplace
+    - projects may be public but not accepted into the marketplace?
+    - => **punt on this for mvp**
 - **website**
   - llms.txt and llms.txt for all projects
 - first-party deployment hosting

turbo.json

@@ -35,6 +35,10 @@
     "dev": {
       "cache": false,
       "persistent": true
+    },
+    "docs": {
+      "cache": false,
+      "persistent": true
     }
   }
 }