chore(docs-site): add dev shortcut and fix hero heading clipping (#190)

* chore(docs-site): add dev shortcut and fix hero heading clipping

- Add `pnpm docs` script that frees port 3000 then runs the docs-site
  dev server, so the docs preview is one command away.
- Bump hero heading line-height to 1.2 and add 0.15em bottom padding
  so the gradient text-clip no longer cuts off descenders.
- Sync auto-generated next-env.d.ts to the current Next types path.

* fix(ci): unblock CI on docs-font branch

- Add lsof to knip ignoreBinaries so the new `pnpm docs` script
  (which uses `lsof -ti:3000` to free port 3000) does not trip
  the Unlisted binaries check.
- Make CLI version assertions read @ktx/cli/package.json at runtime
  instead of hardcoding 0.0.0-private. The 0.4.0 release commit on
  main bumped the package version, breaking 18 hardcoded test cases
  in index.test.ts and admin-reindex.test.ts; reading the version
  dynamically keeps the suite green across future version bumps.

* fix ci release version fixtures

docs-site/content/docs/getting-started/introduction.mdx

@@ -16,8 +16,9 @@ import { ProductMechanics } from "@/components/product-mechanics";
         backgroundClip: 'text',
         color: 'transparent',
         WebkitTextFillColor: 'transparent',
-        lineHeight: '1.1',
+        lineHeight: '1.2',
         letterSpacing: '0',
+        paddingBottom: '0.15em',
       }}
     >
       Make analytics context usable by agents

docs-site/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

knip.json

@@ -86,7 +86,7 @@
     "**/*.gen.ts",
     "**/*.generated.ts"
   ],
-  "ignoreBinaries": ["uv"],
+  "ignoreBinaries": ["uv", "lsof"],
   "ignoreIssues": {
     "packages/cli/src/clack.ts": ["exports"],
     "packages/cli/src/commands/connection-metabase-setup.ts": ["exports", "types"],

package.json

@@ -23,6 +23,7 @@
     "dead-code:biome": "biome ci . --formatter-enabled=false --assist-enabled=false",
     "dead-code:fix": "biome check . --formatter-enabled=false --assist-enabled=false --write && knip --fix --format",
     "dead-code:knip": "knip --reporter compact",
+    "docs": "kill $(lsof -ti:3000) 2>/dev/null; pnpm --filter ktx-docs run dev",
     "ktx": "node scripts/run-ktx.mjs",
     "link:dev": "node scripts/link-dev-cli.mjs",
     "native:rebuild": "pnpm -r rebuild better-sqlite3",

scripts/local-embeddings-runtime-smoke.test.mjs

@@ -12,7 +12,6 @@ import {
   publicKtxTarballName,
   validateEmbeddingResponse,
 } from './local-embeddings-runtime-smoke.mjs';
-
 const PUBLIC_TARBALL_NAME = `kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`;
 const OTHER_PUBLIC_TARBALL_NAME = 'kaelio-ktx-9.9.9.tgz';