pal-e-docs

Phase 8e: SDK Integration Tests

phase-postgres-8e-integration-tests Phase

Project
Goal: Add integration tests that run the SDK against the live pal-e-docs service, verifying all 8 endpoint families work end-to-end. These tests become the foundation for Phase 8g (CI smoke tests).
Owner: Dev agent
Repo: forgejo_admin/pal-e-docs-sdk
Depends on: 8b, 8c, 8d (all completed)

Scope

8 endpoint families × key methods = ~20-30 integration tests in tests/integration/. Read-only tests against known production data. No destructive operations (no delete, no create that leaves garbage).

Endpoint Families

Family Mixin Key Methods to Test
Notes NotesMixin get_note, list_notes
Search SearchMixin search_notes
Tags TagsMixin list_tags
Projects ProjectsMixin list_projects, get_project
Links LinksMixin get_note_links
Repos ReposMixin list_repos
Blocks BlocksMixin get_note_toc, get_note_blocks, get_section
Sprints SprintsMixin list_sprints, get_sprint, get_sprint_board, get_backlog

Baseline Assertions

  • Notes count > 270
  • Blocks count > 5000 (Phase 7c backfill)
  • Search for "CNPG" returns sop-secrets-management
  • TOC for the plan note has > 8 headings
  • Sprint 2 exists and has items

Test Infrastructure

  • tests/integration/conftest.py — live_client fixture using PALDOCS_BASE_URL env var
  • pytest.ini or pyproject.toml marker: integration so unit tests still run fast without the env var
  • Run command: PALDOCS_BASE_URL=https://pal-e-docs.tail5b443a.ts.net pytest tests/integration/ -v
  • phase-postgres-8-mcp-optimization — parent phase with example tests
  • qa-phase7c-backfill-2026-03-07 — baseline data the tests verify