chore(repo): restore README.md and add package-lock.json for launch readiness

[jgoldfoot]

Critical fixes for community launch:

• Restore README.md content (was accidentally emptied)
• Add package-lock.json for reproducible npm ci installs
• Remove package-lock.json from .gitignore (best practice for libraries)

These files are required for:

• GitHub visitors to understand the project (README)
• CI/CD workflows to run npm ci successfully (package-lock.json)
• Consistent dependency installation across environments

🤖 Generated with Claude Code

Description

Related Issue

Fixes #

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to
  not work as expected)
• Documentation update
• Code quality improvement (refactoring, formatting, etc.)
• Performance improvement
• Test coverage improvement

Changes Made

Testing

Test Commands Run

# List the commands you used to test your changes
npm test
npm run lint

Test Results

• All existing tests pass
• New tests added and passing
• Manual testing completed

Testing Checklist

• Tested on multiple URLs (if applicable)
• Tested edge cases
• Tested error handling
• Verified backward compatibility

Examples

Before

# How it worked before

After

# How it works now

Screenshots

Documentation

• README.md updated
• Documentation in docs/ updated
• Code comments added/updated
• Examples updated or added
• CHANGELOG.md will be updated (maintainer will handle)

Breaking Changes

Performance Impact

• No performance impact
• Improves performance
• May impact performance (explain below)

Dependencies

• No new dependencies
• New dependencies added (list below with justification)

Checklist

Code Quality

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings or errors
• I have run npm run lint and fixed all issues

Testing

• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• I have tested my changes manually

Documentation

• I have made corresponding changes to the documentation
• I have updated examples if applicable
• I have added inline code comments where necessary

Process

• I have read the CONTRIBUTING guidelines
• My commit messages follow the project conventions
• I have rebased my branch on the latest main
• This PR has a clear, descriptive title

Additional Notes

Questions for Reviewers

---

For Maintainers:

• CHANGELOG.md updated
• Version bumped (if applicable)
• Release notes prepared (if applicable)