Skip to content

chore(seo): npm + GitHub discoverability metadata (0.6.1)#65

Merged
officialCodeWork merged 1 commit into
mainfrom
chore/seo-metadata
Jul 20, 2026
Merged

chore(seo): npm + GitHub discoverability metadata (0.6.1)#65
officialCodeWork merged 1 commit into
mainfrom
chore/seo-metadata

Conversation

@officialCodeWork

Copy link
Copy Markdown
Owner

SEO / discoverability pass — ships as 0.6.1

npm registry metadata is immutable per version, so none of this reaches npm until a new version is published. Hence a metadata-only patch release.

What was wrong (verified against the live registry)

  • No repository, homepage, or bugs — npm rendered no source link, forfeiting quality-score credit, referral traffic, and link equity to Google.
  • No MCP/AI keywords at all, despite shipping an MCP server (ui-lineage-mcp) — the fastest-growing search cluster, and where the closest competitors (trace-mcp, Agentation, OpenTrace) are positioned.
  • No LICENSE file, though package.json declared MIT — GitHub showed no license, npm quality lost a point.
  • No GitHub topics (zero), and no repo homepage.

npm (packages/cli)

  • description rewritten to lead with what people actually search: React & TypeScript static analysis, data lineage, MCP, AI coding agents.
  • keywords 9 → 20 — added the MCP/AI cluster (mcp, mcp-server, model-context-protocol, ai-agents, codebase-context, llm, claude) plus typescript, code-analysis, dependency-graph, impact-analysis.
  • added repository (with monorepo directory), homepage, bugs.
  • added LICENSE, now shipping in the tarball (21 → 22 files).

README — the npm page body, and what Google indexes

  • Keyword-bearing H1; npm / downloads / license / node badges.
  • MCP server surfaced in the intro (naming Claude Code, Cursor, Windsurf) instead of being buried mid-document.
  • New "Use it to" section written around real search intents (give an AI agent context · where does this number come from · scope a change · onboard · triage a ticket).

GitHub

Repo description aligned with npm, homepage set, and 15 topics added.

Verification

No functional change: eval 341/0/0 · determinism 1.000, full unit suite, typecheck and lint all green; packed bin reports 0.6.1; npm pack clean.

npm publish left to the maintainer — required for any of this to take effect on the registry.

🤖 Generated with Claude Code

Registry metadata is immutable per version, so the SEO work ships as a
metadata-only patch release.

npm (packages/cli — the published `ui-lineage`):
- description rewritten to lead with the terms people search (React &
  TypeScript static analysis, data lineage, MCP, AI coding agents).
- keywords 9 -> 20, adding the previously-absent MCP/AI cluster (mcp,
  mcp-server, model-context-protocol, ai-agents, codebase-context, llm,
  claude) plus typescript, code-analysis, dependency-graph, impact-analysis.
- added repository (with monorepo `directory`), homepage, and bugs — these were
  missing entirely, so npm rendered no source link and forfeited quality-score
  credit and link equity.
- added LICENSE (MIT was declared in package.json but no file existed); it now
  ships in the tarball (22 files).

README (the npm package page, and what Google indexes):
- keyword-bearing H1, npm/downloads/license/node badges.
- MCP server surfaced in the intro with the clients it works with, instead of
  being buried mid-document.
- new "Use it to" section written around real search intents.

GitHub: repo description aligned with npm, homepage set, and 15 topics added
(there were none).

No functional change: eval 341/0/0 + determinism 1.000, full suite, typecheck
and lint all green; packed bin reports 0.6.1.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@officialCodeWork
officialCodeWork merged commit 269e845 into main Jul 20, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants