Skip to main content

Wheelshop

@bixu/wheelshopv2026.10.22.1· MIT(was none)· 1mo agoBEHAVIORSSKILLSACCEPTED WARNINGS
01README

Trust-gate auditor for npm/jsr packages used inside swamp extension models, plus survey, smoosh and prior-art attribution for building extensions from parts of community swamp extensions

02Behaviors1
@bixu/wheelshopv2026.10.13.3wheelshop.ts

Global Arguments

ArgumentTypeDescription
cacheDir?stringDirectory for the 24h fetch cache
cacheTtlHours?numberHow long cached registry responses stay fresh, in hours
fn evaluate(packages: array, runtime?: enum, unsafe?: boolean)
Audit a list of candidate npm/jsr packages against trust gates (license, downloads, vulnerabilities, recency, types) and return ranked verdicts. Agents handle discovery and semantic relevance; this method only handles gating and scoring. If every candidate fails the gates, returns action='ask_user' so the agent knows to prompt a human.
ArgumentTypeDescription
packagesarrayCandidate packages to evaluate. Pick these yourself by searching npm/jsr and reading descriptions for semantic fit before calling.
runtime?enumTarget runtime — affects scoring; JSR candidates get a small boost when 'deno' or 'both'
unsafe?booleanMark every candidate approved even when blockers are present (DO NOT enable without explicit user approval)
fn attribute(manifestPath: string, sources: array)
Record prior art for an extension built from parts of community swamp extensions. Writes prior-art.yaml beside the manifest, then checks the manifest ships it, each derived file carries a 'Derived from <ext>@<version>' header, LICENSE.txt names each source, and each source license is permissive. Returns action='fix' with blockers when attribution is incomplete.
ArgumentTypeDescription
manifestPathstringPath to the derived extension's manifest.yaml (paths.base: manifest)
sourcesarrayEvery community extension that code was taken from
fn survey(query: string, limit?: number)
Survey the community swamp extensions for a domain through the swamp CLI (`extension search` + `extension info`). Ranks them (name matches the query, then official, then health: yanked, deprecated, superseded, stale, no repository), suggests the base to build on, marks which licenses allow copying code, and reports each candidate's method overlap with the base (likelyRedundant at 100%). Licenses missing from the registry are read from pulled copies at the latest version.
ArgumentTypeDescription
querystringDomain to survey, as for `swamp extension search` (e.g. 'tailscale')
limit?numberMaximum search results to inspect
fn smoosh(outDir: string, name: string, description: string, base: string, sources: array)
Build a derived extension from files of pulled community extensions. Copies each file from its pulled copy, adds a 'Derived from' header, swaps model types per `retarget`, rewires relative imports, appends each source's license to LICENSE.txt, merges the manifest (base as a dependency), then runs the `attribute` checks. Never overwrites a derived file that has been edited; it is kept and reported. Returns action='fix' with blockers for what still needs a human or agent, e.g. needs-adaptation whe
ArgumentTypeDescription
outDirstringDirectory of the derived extension, e.g. model/tailscale-community
namestringDerived extension name, e.g. '@bixu/tailscale-community'
descriptionstringManifest description
basestringExtension the derived one builds on, added to dependencies
sourcesarrayPulled community extensions to take files from

Resources

evaluation(1d)— Trust-gate audit of a single candidate package
evaluationSummary(1d)— Summary of an evaluate run across multiple candidates
attribution(1d)— Prior-art record and attribution check for a derived extension
survey(1d)— Ranked community extensions for a domain, a suggested base, and method overlap
smoosh(1d)— Files written or kept, and remaining blockers, for a smooshed extension
03Skills1
swamp-wheelshop1 file
04Previous Versions6
2026.10.13.3

Beta (PR #53): survey ranks a domain's community extensions via the swamp CLI; smoosh builds a derived extension from pulled sources with prior art recorded.

Modified 1 behaviors

2026.06.07.1

DO NOT USE 2026.06.07.0 (yanked — bundled wrong source). 2026.06.07.1 ships the intended redesign. BREAKING vs 2026.05.04.x: search and audit removed. Use evaluate({ packages, runtime, unsafe }) — agents now own discovery and pick candidates from npm/jsr by reading descriptions; wheelshop only audits the list against trust gates (license, downloads, vulnerabilities, recency, types, maintainers). JSR is a first-class registry alongside npm via per-package registry field. Bundled swamp-wheelshop skill teaches the new agent-side flow.

Modified 1 behaviors. Added 1 skills

2026.06.07.0yanked

BREAKING: search and audit removed. Use evaluate({ packages, runtime, unsafe }) — agents now own discovery and pick candidates from npm/jsr by reading descriptions; wheelshop only audits the list against trust gates (license, downloads, vulnerabilities, recency, types, maintainers). JSR is a first-class registry alongside npm via per-package registry field. Bundled swamp-wheelshop skill teaches the new agent-side flow.

Added 1 skills

2026.05.04.3
2026.05.04.2
2026.05.04.1
05Stats
A
100 / 100
Downloads
1,962
Archive size
63.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

07Platforms
08Labels