Shirabe Reader is the GPL-3.0 browser extension for Shirabe. Source lives here. The Rails backend lives in lostcoords/shirabe; API and card packages live in lostcoords/shirabe-sdk.
Use Jujutsu when .jj/ exists. Use dav-mode only when the user explicitly requests it. Preserve other agents' work.
npm ciinstalls pinned dependencies.npm run checkchecks browser source and test types.npm testruns the Node suites and watcher checks in parallel.npm run build:firefoxandnpm run build:chromebuild production packages.npm run watch:chromewatches source without launching or controlling a browser.npm run verify:installed:chromeruns the installed-extension harness in headless Chromium.npm run package:firefoxandnpm run package:chromeverify and package production output. SetPOSTHOG_PROJECT_TOKENfor production packaging.
Consume released @shirabe-org/api and @shirabe-org/card packages. npm run sdk:link temporarily links a sibling SDK for local work; npm ci restores registry packages.
Language resources and tokenizer corpus snapshots are imported from Shirabe. Run bin/reader sync-contract in Shirabe to update them, and bin/reader check-contract there to verify equality. Commit both repositories when these inputs change.
npm test runs the corpora against a committed slice of the real dictionary pack. Set SHIRABE_PACK to a full pack's absolute path to run against it instead; npm run fixture-pack -- <full pack> recuts the slice. Rails parity scripts accept SHIRABE_PATH; combined audits accept SHIRABE_WEB_AUDIT and divergence sweeps accept SHIRABE_WEB_EXPORT.
Prefer APIs, CLIs, and headless tests. Do not activate native apps or send system-wide input without explicit permission. Preserve the user's clipboard and do not play test audio. Use the configured browser skill for visible browser work and stay in its owned session.
tools/pack-builder owns the Ruby offline pack writer. Run its standalone tests with BUNDLE_GEMFILE=tools/pack-builder/Gemfile bundle exec ruby -Itools/pack-builder/lib tools/pack-builder/test/builder_test.rb. Rails owns source queries and permissions; this library must not import Rails or ActiveRecord.