Audit: ensure terraphim 1Password crate is on par with 1Password JavaScript library #503
Description
We should validate that the internal/external terraphim 1Password Rust crate is feature-compatible with the official 1Password JavaScript library (API surface, auth flows, and supported operations).
Goals
- Confirm parity (or document intentional gaps) vs the 1Password JS SDK/library.
- Identify missing endpoints/features and add them (or clearly mark out-of-scope).
- Ensure docs/examples match expected usage.
Suggested checklist
- Identify the exact JS library/SDK + version we are comparing against (link to docs/changelog).
- Enumerate JS API surface (auth, vaults, items, documents/files, attachments, events/auditing if applicable).
- Map Rust crate modules/functions to JS equivalents; produce a coverage matrix.
- Verify supported auth flows: service account / connect server / CLI-based auth (whichever applies), token refresh, env var support.
- Error handling parity: error codes, retry/backoff, rate limiting.
- Types/parsing: item fields, custom sections, references, file metadata.
- Add/expand integration tests that mirror JS examples.
- Update README/docs in terraphim-ai to reflect supported features + example snippets.
Acceptance criteria
- Coverage matrix exists in-repo (docs/ or issue comment) with clear gaps + plan.
- Any missing required features are implemented or explicitly scoped out.
- Tests + docs updated accordingly.