Skip to content

docs: improve package discoverability for AI agents + bump to 0.8.1#69

Merged
stevenobiajulu merged 2 commits intomainfrom
docs-improve-package-discoverability-20260402
Apr 2, 2026
Merged

docs: improve package discoverability for AI agents + bump to 0.8.1#69
stevenobiajulu merged 2 commits intomainfrom
docs-improve-package-discoverability-20260402

Conversation

@stevenobiajulu
Copy link
Copy Markdown
Member

Summary

  • SECURITY.md: updated email to security@usejunior.com, expanded scope, added disclosure policy and local-first note
  • package.json keywords + descriptions: 37 intent-based keywords on both safe-docx and docx-mcp (redline, contract, legal, markup, ai-agent, local-first, safedocx, etc.) plus search-optimized descriptions
  • README.md: Trusted By section (anonymized), MCP tool-call agent example, MCP Quickstart, live maintenance + MIT license badges
  • Localized READMEs (es/zh/pt-br/de): same new sections with translated prose
  • docx-mcp README: one-line pointer to canonical @usejunior/safe-docx install
  • Release runbook: added PulseMCP, mcp.so, mcpmarket.com as registry targets
  • Version bump: 0.8.0 → 0.8.1

Ref: proposals/trust-surface/improve-safedocx-package-discoverability/

Test plan

  • node scripts/bump_version.mjs --check confirms version sync
  • npm run lint --workspaces --if-present passes
  • Badges render correctly on GitHub README preview
  • npm description fields render correctly after publish

SafeDocx is invisible to intent-based searches — AI agents building
Word-editing workflows never find us. This adds discoverability signals
across the repo:

- SECURITY.md: updated email to security@usejunior.com, expanded scope
  to cover all npm packages/MCP/CLI, added disclosure policy and
  local-first architecture note
- package.json (safe-docx + docx-mcp): intent-based keywords (redline,
  contract, legal, markup, ai-agent, local-first, etc.) and
  search-optimized descriptions
- README.md: added Trusted By section (anonymized Am Law top-10 firm,
  150-lawyer firm, Gemini CLI), MCP tool-call agent example, MCP
  Quickstart for Claude Code/Desktop/Gemini CLI, live maintenance
  badges (npm version, MIT license, last commit, issues closed)
- Localized READMEs (es/zh/pt-br/de): same sections with translated prose
- docx-mcp README: one-line pointer to canonical install via safe-docx
- Release runbook: added PulseMCP, mcp.so, mcpmarket.com as targets

Ref: proposals/trust-surface/improve-safedocx-package-discoverability/
@stevenobiajulu stevenobiajulu enabled auto-merge (squash) April 2, 2026 20:49
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 2, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
site Ready Ready Preview, Comment Apr 2, 2026 8:49pm

Request Review

@github-actions github-actions bot added the docs label Apr 2, 2026
@stevenobiajulu stevenobiajulu merged commit 11ef49b into main Apr 2, 2026
20 checks passed
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 2, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant