Develop

npm test              # the CLI against test/fixture.html in a headless Chrome, and init/uninstall in temp folders
npm run build:skill   # after editing skill/page-as-data.md: refresh the Claude Code plugin copy

To release, bump the version, commit, and push an annotated tag named after the package. The monorepo's publish workflow runs this package's tests, then publishes to npm with provenance. It needs an NPM_TOKEN repository secret.

npm version patch --no-git-tag-version   # also updates .claude-plugin/plugin.json and the plugin's SKILL.md
git commit -am "Release page-as-data <version>"
git tag -a page-as-data@v<version> -m "page-as-data <version>"
git push --follow-tags

The fixture plants one of each bug, next to a look-alike that is not a bug, and the tests check both: every bug found, no look-alike reported.

The diagram is built from docs/diagram/how-it-helps.py with drawing-architecture-diagrams.