architecture.md — full rewrite to reflect current v2 state:
- Accurate component map and pipeline stages
- Session lifecycle (server-side files, cookie signing, rotation)
- Multi-account DocuSign support flow
- Audit log record schema
- Batch job in-memory state caveat documented
- Security design table (log sanitizer, session signing, PDF checksums)
- Known limitations table (retry gaps, shard config, CI fixtures)
PRODUCT-SPEC.md — remove phantom migration_service.py and pdf_coords.py
that were in the original spec but never implemented; document where
pipeline orchestration actually lives
README.md — add Production deployment section covering:
- Reverse proxy / HTTPS requirement for OAuth callbacks
- Required env vars table
- SESSION_SECRET_KEY rotation procedure
- Adobe shard configuration (EU2 / NA1 / others via ADOBE_SIGN_BASE_URL)
- DocuSign sandbox-to-production switch
- Session store maintenance (stale file cleanup)
field-mapping.md — add Multi-Document Templates section explaining
documentId assignment, page number behaviour, and the known limitation
for multi-doc templates where page numbers are not rebased per document
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Reflects all implementation from this session: 7 post-redesign bug fixes
(routing, polling, branding, verification role names, conditional parent 400s,
failure UX, template detail history expand), and Phase 23 structured field
issue reporting end-to-end. Test count updated to 119/119.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Full UI redesign plan covering 9 phases: app shell, project/customer context,
templates view with readiness badges, migration workflow, issues view,
verification (with new verify API), history/audit, settings, and smoke test
checklist. Only backend additions are Phase 16 (blockers/warnings in status
endpoint) and Phase 19 (verify router). All other phases are frontend-only.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Embedded the official Docusign full-color vector logo sourced from
Wikimedia Commons (Docusign_Full_Color.svg, viewBox 0 0 1200 241.4).
Wordmark paths changed to fill="#FFFFFF" for visibility on the Inkwell
(#130032) nav bar; Nexus icon retains brand colors (Cobalt #4C00FF,
Poppy #FF5252, white document shape). Brand name corrected to "docusign"
(capital D, lowercase s per 2024 rebrand).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
README.md — rewritten to reflect actual usage: setup, auth flows, CLI
commands for all three scripts, and links to field-mapping and quirks docs.
tests/PLATFORM-QUIRKS.md — documents confirmed bugs and API quirks found
during development: numberTabs rendering as text+validation (DocuSign API
bug), multi-location field fix, zero-width tab fix, Company/Title contentType
SIGNER_ prefix variant from Adobe Sign API.
tests/ — SCENARIOS, EDGE-CASES, FIELD-TYPE-REGRESSION test planning docs.
validation/ — research notes: field eval, mapping ambiguity log, decision
log, conditional logic analysis, round-trip eval, DocuSign ingest eval.
docs/architecture.md — system architecture overview.
api-samples.md — annotated Adobe Sign API response examples.
PRODUCT-SPEC.md — product requirements and migration scope definition.
sample-templates/ — JSON fixtures (NDA, onboarding, sales contract) for
offline testing; PDFs excluded from version control.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Paul Huliganga