Rename @inth/docs to leadtype by KayleeWilliams · Pull Request #12 · inthhq/leadtype

KayleeWilliams · 2026-05-09T02:16:35Z

Summary

Rebrand the package to its flat unscoped npm name: @inth/docs → leadtype.
Move the workspace from packages/docs/ → packages/leadtype/ (history preserved via git mv) and the agent skill from .agents/skills/inth-docs/ → .agents/skills/leadtype/.
Update every consumer surface: subpath imports (leadtype/remark, leadtype/search/vercel, …), env vars (INTH_DOCS_AGENT_BASE_URL → LEADTYPE_AGENT_BASE_URL, INTH_DOCS_VERBOSE → LEADTYPE_VERBOSE), logger prefix ([leadtype]), data-inth-* HTML attrs + matching CSS selectors, docs site display branding (Leadtype), and tsconfig path mappings.
Two stray references corrected from leadtype-lint (kebab) to leadtype lint (the actual subcommand). docs/methodology.mdx keeps "We built it at Inth" as historical attribution.

Test plan

bun install — workspace symlink resolves to leadtype
bun run check-types — both leadtype and example pass
bun run --filter leadtype test — 97/97 pass
bun run --filter leadtype build — emits dist + regenerates packaged docs with LEADTYPE_AGENT_BASE_URL
bun run --filter example pipeline:build — MDX conversion, LLM generation, and search index all regenerate correctly
bun run check — clean (auto-fix reordered 4 import blocks)
CI green
Spot-check the dev server (bun run dev) and confirm the docs site renders with the new "Leadtype" branding

Rebrand the package to its flat unscoped npm name. Renames the workspace dir packages/docs → packages/leadtype, the agent skill, all imports + subpath exports, env vars (INTH_DOCS_AGENT_BASE_URL → LEADTYPE_AGENT_BASE_URL, INTH_DOCS_VERBOSE → LEADTYPE_VERBOSE), data-inth-* attrs + matching CSS selectors, logger prefix, and docs site display branding.

coderabbitai · 2026-05-09T02:16:48Z

📝 Walkthrough

Summary by CodeRabbit

Release Notes

Documentation
- Updated all documentation and guides to reference the rebranded leadtype package instead of @inth/docs, including installation, CLI commands, and integration examples.
- Updated environment variable from INTH_DOCS_AGENT_BASE_URL to LEADTYPE_AGENT_BASE_URL.
Refactor
- Rebranded package from @inth/docs to leadtype across all entry points and configurations.
- Updated internal naming conventions (temporary directories, logging prefixes, data attributes) to use leadtype namespace.

Walkthrough

This PR performs a complete package rename from @inth/docs to leadtype across the entire repository. All imports, environment variables, CLI commands, DOM data attributes, documentation, tests, and configuration files are updated to reflect the new package identity. The internal logger is relocated and renamed, and all module paths are consolidated under the leadtype namespace.

Changes

Package Rename & Module Configuration

Layer / File(s)	Summary
Package Metadata `packages/leadtype/package.json`, `package.json`, `tsconfig.json`	Package name changed from `@inth/docs` to `leadtype`. TypeScript path aliases updated to resolve `leadtype/*` modules. Root-level and app-level dependencies switch from `@inth/docs` to `leadtype`.
CLI & Logger `packages/leadtype/src/cli.ts`, `packages/leadtype/src/cli/generate.ts`, `packages/leadtype/src/internal/logger.ts`, `packages/docs/src/internal/logger.ts`	CLI help text updated to reference `leadtype` commands. Logger moved from `packages/docs` to `packages/leadtype` with `[leadtype]` prefix and `LEADTYPE_VERBOSE` environment variable.
Documentation & Workflow `.agents/skills/leadtype/SKILL.md`, `.github/workflows/bench.yml`, `README.md`	Agent skill guide and CI workflow updated to target `packages/leadtype`. Root README rebranded with `leadtype` entry points and `LEADTYPE_AGENT_BASE_URL` environment variable.

Example Application Integration

Layer / File(s)	Summary
App Configuration `apps/example/package.json`, `apps/example/tsconfig.json`	Workspace scripts and dependencies switch to `leadtype` filter. Path aliases updated to `leadtype/*` module mappings.
App Scripts `apps/example/scripts/bench.ts`, `apps/example/scripts/convert-real.ts`, `apps/example/scripts/llm-generate.ts`, `apps/example/scripts/mdx-convert.ts`, `apps/example/scripts/search-generate.ts`, `apps/example/scripts/test-.ts`	All imports switch from `@inth/docs/` to `leadtype/`. Environment variable `LEADTYPE_AGENT_BASE_URL` replaces `INTH_DOCS_AGENT_BASE_URL`.
App Library & Routes `apps/example/src/lib/docs.ts`, `apps/example/src/lib/search.ts`, `apps/example/src/mdx-components.tsx`, `apps/example/src/routes/__root.tsx`, `apps/example/src/routes/api/docs/ask.ts`, `apps/example/src/routes/api/docs/search.ts`, `apps/example/src/routes/index.tsx`, `apps/example/src/routes/playground.tsx`	Type imports and search utilities source changed from `@inth/docs/` to `leadtype/`. Product name in route handlers changed to `"leadtype"`. Home page text and playground recipes updated.

Component & Styling Updates

Layer / File(s)	Summary
MDX Components `apps/example/src/components/docs-mdx/*`	All `data-inth-` attributes renamed to `data-leadtype-` for accordion, callout, cards, tabs, examples, selectors, steps, type-table, topic-switcher, and mermaid components. Component logic and props remain unchanged.
Site Components `apps/example/src/components/site-header.tsx`, `site-footer.tsx`	Header link label and footer text changed from `@inth/docs` to `leadtype`. NPM package URL updated to leadtype package.
Styles `apps/example/src/styles.css`	All CSS selectors using `[data-inth-]` attributes renamed to `[data-leadtype-]` for all variants and subcomponents across the entire component suite.

Documentation & Tests

Layer / File(s)	Summary
Docs Pages `docs/.mdx`, `docs/guides/.mdx`	All frontmatter, code examples, and CLI commands updated to use `leadtype` package, `leadtype/*` imports, `npx leadtype` commands, and `LEADTYPE_AGENT_BASE_URL` environment variable. Package README also updated with renamed entry points and provider guidance.
Test Files `packages/leadtype/src/*.test.ts`, `apps/example/tests/e2e/smoke.e2e.ts`	Temporary directory prefixes updated to use `leadtype-` naming (e.g., `leadtype-cli-`, `leadtype-lint-`, `leadtype-search-`). Product name assertions changed to `"leadtype"`. E2E smoke tests updated to expect `leadtype` text and imports in page assertions.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

inthhq/docs#6: Adds the MDX components (Accordion, Example, TopicSwitcher) and remark plugin infrastructure that this PR renames and updates with new data-attribute schemes.
inthhq/docs#7: Restructures the search provider exports and streamDocsAnswer imports that this PR migrates from @inth/docs/search to leadtype/search.
inthhq/docs#1: Adds the internal logger for @inth/docs that this PR relocates and renames to the leadtype namespace.

🐰 A rename so grand, from inth to lead,
leadtype now blooms where docs once read,
Each data attribute hops in place,
As brand-new pathways light the space! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 10.34% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Rename `@inth/docs` to leadtype' clearly and concisely summarizes the main change—a comprehensive rebranding of the package from `@inth/docs` to leadtype across the entire codebase.
Description check	✅ Passed	The description is well-organized and directly related to the changeset, providing clear context about the rebranding effort including directory moves, import/env var updates, and thorough test plan verification.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/example/scripts/llm-generate.ts`:
- Line 31: Restore a short transitional fallback so legacy env var
INTH_DOCS_AGENT_BASE_URL is used if LEADTYPE_AGENT_BASE_URL is not set: update
the expression that builds the agent base URL (where
process.env.LEADTYPE_AGENT_BASE_URL is referenced) to fall back to
process.env.INTH_DOCS_AGENT_BASE_URL?.trim() (with a deprecation comment/log)
before falling through to the other defaults, ensuring you call .trim() and
treat an empty string as unset so existing CI/local setups don’t silently
generate wrong doc links.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 020528c9-ea93-4d81-8784-c950c851335e

📥 Commits

Reviewing files that changed from the base of the PR and between 2e58b63 and 29503dd.

⛔ Files ignored due to path filters (4)

apps/example/src/generated/docs-nav.json is excluded by !**/generated/**
apps/example/src/generated/docs-search-content.json is excluded by !**/generated/**
apps/example/src/generated/docs-search-index.json is excluded by !**/generated/**
bun.lock is excluded by !**/*.lock

📒 Files selected for processing (130)

.agents/skills/leadtype/SKILL.md
.github/workflows/bench.yml
README.md
apps/example/package.json
apps/example/scripts/bench.ts
apps/example/scripts/convert-real.ts
apps/example/scripts/llm-generate-real.ts
apps/example/scripts/llm-generate.ts
apps/example/scripts/mdx-convert.ts
apps/example/scripts/search-generate.ts
apps/example/scripts/test-pipeline.ts
apps/example/scripts/test-real.ts
apps/example/src/components/docs-mdx/accordion.tsx
apps/example/src/components/docs-mdx/callout.tsx
apps/example/src/components/docs-mdx/card.tsx
apps/example/src/components/docs-mdx/command-tabs.tsx
apps/example/src/components/docs-mdx/example.tsx
apps/example/src/components/docs-mdx/mermaid.tsx
apps/example/src/components/docs-mdx/selector.tsx
apps/example/src/components/docs-mdx/steps.tsx
apps/example/src/components/docs-mdx/tabs.tsx
apps/example/src/components/docs-mdx/topic-switcher.tsx
apps/example/src/components/docs-mdx/type-table.tsx
apps/example/src/components/site-footer.tsx
apps/example/src/components/site-header.tsx
apps/example/src/lib/docs.ts
apps/example/src/lib/search.ts
apps/example/src/mdx-components.tsx
apps/example/src/routes/__root.tsx
apps/example/src/routes/api/docs/ask.ts
apps/example/src/routes/api/docs/search.ts
apps/example/src/routes/index.tsx
apps/example/src/routes/playground.tsx
apps/example/src/styles.css
apps/example/tests/e2e/smoke.e2e.ts
apps/example/tsconfig.json
docs/components.mdx
docs/convert.mdx
docs/docs.config.ts
docs/guides/bundle-package-docs.mdx
docs/guides/connect-docs-site.mdx
docs/index.mdx
docs/lint.mdx
docs/llm.mdx
docs/methodology.mdx
docs/remark.mdx
docs/search.mdx
package.json
packages/docs/src/internal/logger.ts
packages/leadtype/.gitignore
packages/leadtype/README.md
packages/leadtype/biome.jsonc
packages/leadtype/package.json
packages/leadtype/scripts/generate-docs.ts
packages/leadtype/src/cli.test.ts
packages/leadtype/src/cli.ts
packages/leadtype/src/cli/generate.ts
packages/leadtype/src/convert/convert.ts
packages/leadtype/src/convert/index.ts
packages/leadtype/src/index.ts
packages/leadtype/src/internal/docs-context.test.ts
packages/leadtype/src/internal/docs-context.ts
packages/leadtype/src/internal/logger.ts
packages/leadtype/src/internal/package-surface.test.ts
packages/leadtype/src/lint/cli.ts
packages/leadtype/src/lint/index.ts
packages/leadtype/src/lint/lint.test.ts
packages/leadtype/src/lint/reporters.ts
packages/leadtype/src/lint/runner.ts
packages/leadtype/src/lint/schema.ts
packages/leadtype/src/llm/index.ts
packages/leadtype/src/llm/llm.test.ts
packages/leadtype/src/llm/llm.ts
packages/leadtype/src/remark/index.ts
packages/leadtype/src/remark/libs/attributes.ts
packages/leadtype/src/remark/libs/content-processor.ts
packages/leadtype/src/remark/libs/generic-processor.ts
packages/leadtype/src/remark/libs/guards.ts
packages/leadtype/src/remark/libs/index.ts
packages/leadtype/src/remark/libs/node-creators.ts
packages/leadtype/src/remark/libs/text.ts
packages/leadtype/src/remark/libs/types.ts
packages/leadtype/src/remark/plugins/accordion.remark.ts
packages/leadtype/src/remark/plugins/callout.remark.ts
packages/leadtype/src/remark/plugins/cards.remark.ts
packages/leadtype/src/remark/plugins/command-tabs.remark.ts
packages/leadtype/src/remark/plugins/details.remark.ts
packages/leadtype/src/remark/plugins/doc-placeholders.remark.ts
packages/leadtype/src/remark/plugins/example.remark.ts
packages/leadtype/src/remark/plugins/include.remark.ts
packages/leadtype/src/remark/plugins/link-icon.remark.ts
packages/leadtype/src/remark/plugins/mermaid.remark.ts
packages/leadtype/src/remark/plugins/remove-imports.remark.ts
packages/leadtype/src/remark/plugins/remove-jsx-comments.remark.ts
packages/leadtype/src/remark/plugins/section.remark.ts
packages/leadtype/src/remark/plugins/steps.remark.ts
packages/leadtype/src/remark/plugins/tabs.remark.ts
packages/leadtype/src/remark/plugins/toc-extract.remark.ts
packages/leadtype/src/remark/plugins/topic-switcher.remark.ts
packages/leadtype/src/remark/plugins/type-table.remark.ts
packages/leadtype/src/remark/remark-output.test.ts
packages/leadtype/src/search/ai-index.ts
packages/leadtype/src/search/answer-stream.test.ts
packages/leadtype/src/search/answer-stream.ts
packages/leadtype/src/search/bash-index.ts
packages/leadtype/src/search/bash.ts
packages/leadtype/src/search/cloudflare-index.ts
packages/leadtype/src/search/cloudflare.test.ts
packages/leadtype/src/search/cloudflare.ts
packages/leadtype/src/search/docs-bash.test.ts
packages/leadtype/src/search/docs-bash.ts
packages/leadtype/src/search/index.ts
packages/leadtype/src/search/node-index.ts
packages/leadtype/src/search/node.test.ts
packages/leadtype/src/search/node.ts
packages/leadtype/src/search/search.test.ts
packages/leadtype/src/search/search.ts
packages/leadtype/src/search/tanstack-bash.test.ts
packages/leadtype/src/search/tanstack-bash.ts
packages/leadtype/src/search/tanstack-index.ts
packages/leadtype/src/search/tanstack.test.ts
packages/leadtype/src/search/tanstack.ts
packages/leadtype/src/search/vercel-bash.test.ts
packages/leadtype/src/search/vercel-bash.ts
packages/leadtype/src/search/vercel-index.ts
packages/leadtype/src/search/vercel.test.ts
packages/leadtype/src/search/vercel.ts
packages/leadtype/tsconfig.json
packages/leadtype/tsup.config.ts
tsconfig.json

💤 Files with no reviewable changes (1)

packages/docs/src/internal/logger.ts

📜 Review details

🧰 Additional context used

📓 Path-based instructions (6)

**/*.{ts,tsx}