001-gdrive-url-header #3

Peter.Morton · 2026-03-27T16:08:00-05:00

Peter.Morton commented

2026-03-27 16:08:00 -05:00

Updated so that each document export request provides a HTTP header with this original source URL

Peter.Morton added 3 commits 2026-03-27 16:08:02 -05:00

Updated speckit to v0.4.3 2641afaabe

feat: Add X-Verint-KAB-Original-URL header to document exports 9286ee8927

Adds HTTP response header containing original Google Drive URL
for exported documents to enable content traceability and auditing.

- Adds X-Verint-KAB-Original-URL header to successful export responses
- Header format: https://drive.google.com/file/d/{fileId}
- Present for all export formats (PDF, DOCX, plain text)
- Header omitted on error responses (4xx/5xx)
- 18 new tests (9 contract + 9 integration)
- Zero new dependencies
- Performance: 0.000019ms overhead per request

Implements:
- FR-001: Header present on successful exports (200 OK)
- FR-002: Header absent on error responses
- FR-003: Standard header name X-Verint-KAB-Original-URL
- FR-004: Standard URL format with file ID
- FR-005: Uses validated document.id from Google Drive API
- FR-006: Header present regardless of file accessibility
- FR-007: Consistent across all export formats
- FR-008: Minimal performance impact (< 5ms requirement)

Testing:
- Contract tests validate header presence, format, and error handling
- Integration tests verify behavior across formats and permissions
- All 18 tests passing
- 100% requirements coverage

Documentation:
- Feature specification (specs/001-gdrive-url-header/spec.md)
- Implementation plan (plan.md)
- Technical research (research.md)
- Data model (data-model.md)
- API contract (contracts/response-headers.md)
- User guide (quickstart.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

docs: Update README with X-Verint-KAB-Original-URL header feature 4112685b69

- Add Source URL Header to features list
- Document /documents/{documentId} endpoint
- Add X-Verint-KAB-Original-URL header to response headers section
- Include curl examples for document export with header inspection
- Add documentation links for new feature spec and API contract

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Peter.Morton merged commit 7a89598928 into main

2026-03-27 16:08:14 -05:00

Peter.Morton referenced this issue from a commit

2026-03-27 16:08:15 -05:00

Merge pull request '001-gdrive-url-header' (#3) from 001-gdrive-url-header into main

Peter.Morton deleted branch 001-gdrive-url-header

2026-03-27 16:08:15 -05:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: verint.com/google-drive-content-adapter#3