RefMint 0.1.0-alpha.3 — lookup workflows and PDF example

RefMint 0.1.0-alpha.3 — evaluate the lookup workflow

This alpha adds a concrete way to evaluate an extra reference before adopting it.
Runtime JavaScript and TypeScript APIs are unchanged from alpha.2; the existing-ID v1
wire contract remains frozen. There are still zero runtime dependencies.

• Compare existing hostname/invoice-number lookup, a five-character local alias and
  RefMint on the same records, including partial input, typos and another valid code.
• Download the sample PDF and use its three identifiers in the local lookup form.
  Verification extracts the text from the PDF itself and resolves the same invoice.
  Original invoice numbering, leading zeros and regulated identifiers stay separate.
• Inspect all 54 selected synthetic cases (2 workflows × 3 routes × 9 cases), including
  costs that favor current identifiers. Fleet codes in this sample have 49 printed
  characters versus an 8-character hostname or 5-character alias; the invoice code has
  21 versus a 15-character number or 5-character alias.
• Read when RefMint is unnecessary and how alpha API status differs from a frozen wire
  format. A checksum does not authenticate, authorize, or prove the intended record.

These fixtures are not real support data, a human-entry study, or an upstream integration.
No reduction in support time or new performance improvement is claimed. Existing size
and timing reports retain their original alpha.2 date/environment because runtime hashes
are unchanged; the carried-forward measurement version is explicit.

npm install refmint@alpha
# Pin exactly:
npm install --save-exact refmint@0.1.0-alpha.3

The same verified .tgz is published on npm and attached here. alpha is the intended
installation tag; no stable version is being declared. Node.js 22+ and ES modules are
required for Node consumers. The npm package includes runtime, declarations and docs;
forms, tests and PDF-generation tools live in the tagged source.

To run the workflow from the tagged source:

pnpm install --frozen-lockfile --ignore-scripts
pnpm build
pnpm test:workflows
pnpm demo

Open http://127.0.0.1:4173/workflows/ and download the sample PDF from the form.

Validation: 39 Node tests, TypeScript, 54 fixture cases, existing Bech32m comparison
(28 scenarios and 1,576 mutations per adapter), two HTTP tests, offline package
installation, 21 Chromium/Firefox/WebKit tests, and PDF extraction/lookup in CI.
CI covers Node 22/24/26 and Linux/Windows/macOS. A fresh npm installation and archive
integrity are checked after publication. SHA256SUMS.txt covers all attached artifacts.

npm ·
Workflow and limits ·
All outcomes ·
When not to use RefMint

Release commit: 0a16b09cf3e95a40a88219ccfdde0cd738d53924. All seven CI jobs passed.

Published and verified on 28 October 2026. The fresh npm install, public imports, eight existing-ID round trips and archive hash checks passed; details are in verification.json. The alpha dist-tag points to this release; the existing latest tag was left unchanged.