Skip to content

feat(npm): add versions command, test suite, and expanded README - #414

Open
sreeramakhil wants to merge 3 commits into
agentrhq:mainfrom
sreeramakhil:feat/npm-plugin-versions-and-tests
Open

feat(npm): add versions command, test suite, and expanded README#414
sreeramakhil wants to merge 3 commits into
agentrhq:mainfrom
sreeramakhil:feat/npm-plugin-versions-and-tests

Conversation

@sreeramakhil

Copy link
Copy Markdown

Description

Adds Reddit as the 7th research source to webcmd omnisearch research and wires it into the verdict aggregator. Uses Reddit's public JSON API (reddit.com/search.json), requiring no auth or API keys. Includes robust validation to handle malformed posts or invalid timestamps safely.

Related issue: None

Type of Change

  • 🐛 Bug fix
  • ✨ New feature
  • 🌐 New site adapter
  • 📝 Documentation
  • ♻️ Refactor
  • 🔧 CI / build / tooling

Checklist

  • I ran the checks relevant to this PR
  • I updated tests or docs if needed
  • I included output or screenshots when useful
  • If I edited skill-src/, I ran make build and committed skills/

Adapter Notes

  • Updated generated or lean docs when command discoverability changed
  • Used positional args for the command's primary subject unless a named flag is clearly better
  • Normalized expected adapter failures to CliError subclasses instead of raw Error

Screenshots / Output

$ npx vitest run plugins/omnisearch/test/research.test.js

 RUN  v4.1.4 C:/Users/akhil/OneDrive/Desktop/holidays/webcmd

 ✓  plugin  plugins/omnisearch/test/research.test.js (11 tests) 30ms
   ✓ redditSearch (5)                                   
     ✓ returns normalized rows from Reddit JSON API 29ms
     ✓ falls back to permalink when url field is absent 1ms
     ✓ returns empty array when Reddit returns no children 1ms
     ✓ returns empty string for createdAt when created_utc is invalid 0ms
     ✓ hits the correct Reddit search endpoint 1ms
   ✓ omnisearch research with reddit source (3)              
     ✓ returns Reddit rows when sources=reddit 1ms
     ✓ includes reddit in default sources 0ms
     ✓ handles reddit failure gracefully when other sources succeed 1ms
   ✓ omnisearch research — limit enforcement (1)
     ✓ honors the total limit when research is narrowed to one source 1ms

 Test Files  1 passed (1)
      Tests  11 passed (11)
   Duration  379ms

- Add webcmd npm versions <name> command that lists all published
  versions of a package newest-first, with publishedAt, isLatest flag,
  and a direct npmjs.com URL per version. Mirrors the pypi releases cmd.

- Add optional 
equest parameter to
pmFetch in utils.js so commands
  can inject a fake fetch function in tests without patching globals
  (matches the pattern used in the pypi plugin).

- Add test/npm.test.js with 14 tests covering all four commands:
  package, versions, downloads, search. Includes happy paths, empty
  result / 404 handling, input validation, and a contract test asserting
  browser: false for every registered command.

- Expand README.md with a full command table (including the new versions
  command), argument descriptions, and copy-paste examples for all four
  commands.
Slicing publishedAt to 10 chars before sorting caused versions
published on the same calendar date to lose sub-day precision,
producing non-deterministic newest-first ordering.

Fix: sort on the raw full timestamp first, then format to date-only
inside .map(). Add a regression test with two versions sharing the
same date (08:00 and 14:00) to pin the correct ordering.
… entries

A version key can exist in body.time without a matching entry in
body.versions (e.g. yanked or unpublished releases). The previous code
returned bogus rows for those keys with an invalid URL and misleading
date.

Fix: cross-filter timeMap entries against body.versions so only keys
that exist in both are returned. Also guard that the timestamp is a
string before sorting.

Update the same-day regression fixture to include matching body.versions
entries and add a time-only ghost key (0.0.1-ghost) to assert it is
excluded from results.
@github-actions

Copy link
Copy Markdown
Contributor

🟠 Maintainer review suggested — low confidence

The automated review could not reach a fully supported conclusion.

Limitations

  • The automated review returned an invalid structured result.

This review is advisory and does not block merging.

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.

1 participant