Skip to content

docs(contacts): document import wizard safety boundaries and QA handoff - #1887

Open
prissca wants to merge 2 commits into
Stellar-Mail:mainfrom
prissca:fix/issue-995-contacts-import-docs
Open

docs(contacts): document import wizard safety boundaries and QA handoff#1887
prissca wants to merge 2 commits into
Stellar-Mail:mainfrom
prissca:fix/issue-995-contacts-import-docs

Conversation

@prissca

@prissca prissca commented Jul 26, 2026

Copy link
Copy Markdown

Summary

Documentation-only, per this issue's acceptance criteria:

  • document ownership across the existing src/features/contacts/import/ implementation
  • describe the ImportedContactRow data contract and user-facing wizard states
  • record safety boundaries for client-side parsing, malformed rows, fuzzy matches, retention, demo data, and contact-policy writes
  • link the existing import unit tests and add a lightweight manual QA checklist

The issue's suggested filenames no longer match the live module layout, so this handoff links directly to the current implementation and tests instead of introducing a parallel architecture.

Validation

  • npm exec -- vitest run tests/unit/import — 4 files and 63 tests passed
  • git diff --check
  • TypeScript and full-repository lint were attempted but exceeded the local 120-second execution limit

Closes #995

Obiajulu-gif and others added 2 commits July 26, 2026 20:18
…ff (closes Stellar-Mail#995)

Adds src/features/contacts/README.md following the same contributor
handoff format already used for audit-log and other feature folders:
what each file in import/ owns, the ImportedContactRow data contract,
safety notes (client-side-only parsing, malformed rows surfaced not
dropped, fuzzy matches require manual confirmation, retention policy
scope, no real user data in dev/demos), user-facing states, and a
lightweight manual QA checklist. Also notes the current lack of
automated test coverage for csvParser.ts/identityMatcher.ts rather than
silently omitting it.

No code changes — this issue is documentation-only per its acceptance
criteria.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@prissca
prissca marked this pull request as draft July 27, 2026 04:20
@kryputh
kryputh marked this pull request as ready for review July 27, 2026 05:27
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Existing app][Contacts Import] Document safety boundaries and contributor handoff

2 participants