Conversation log (summarized)

Related: 00-home

Phase 1 — SDK foundation

  • Modular Python SDK + CLI for Villa Market backend
  • TDD structure: auth, orders, validation, payments
  • Design and testing docs: docs/DESIGN.md, docs/TESTING.md

    • Phase 2 — Cognito and secrets

  • Dev app client villa-backend-sdk-dev on pool villaMembers2
  • .env.example for public IDs; secret in .env / Cursor Secrets / GitHub Actions
  • Clarified Client Secret ID ≠ client secret value
  • SignUp / confirm_sign_up for user registration without IAM admin

    • Phase 3 — Live integration testing

  • Shared test account villa-sdk-test@villamarket.dev
  • Session fixture logs in (or SignUp) and attaches JWT to HTTP calls
  • Scripts: provision_cognito_test_user.py, smoke_test_cognito_login.py
  • docs/COGNITO_TEST.md

    • Phase 4 — Usage documentation

  • docs/MANUAL.md — full user guide
  • S3-hosted site: villa-market-backend-sdk-manual bucket
  • scripts/build_manual_site.py, deploy_manual_s3.py
  • README links to hosted manual

    • Phase 5 — PyPI and token verification

  • Published as **villa-market-backend-sdk** (v0.2.0 → v0.2.1)
  • verify_id_token(), is_id_token_valid(), CLI villa auth verify-token
  • JWKS verification via PyJWT

    • Phase 6 — Knowledge base (this folder)

  • Obsidian-style notes under docs/knowledge/
  • Agent-optimized AGENTS.md at repo root
  • Wikilinks between notes; included in S3 site build

    • Open items

  • GitHub deploy-docs workflow needs AWS credentials in repo secrets
  • Integration CI needs VILLA_COGNITO_CLIENT_SECRET