mnemospark-backend

Documentation: The canonical product and API docs live in the separate mnemospark-docs repository (single source of truth). This repo no longer includes a .company docs subdirectory; clone or open mnemospark-docs directly when working on documentation.

Repository layout

• Production backend surface (active):
  • template.yaml (main SAM stack)
  • services/ (live Lambda handlers and shared code)
  • tests/ (active unit/integration suites for live endpoints and housekeeping)
  • docs/ (OpenAPI + endpoint docs for supported routes)
• Archived legacy proofs-of-concept (non-production):
  • archive/examples/ (early SAM examples retained for historical reference only)

Observability stack validation and deploy

The root template.yaml now includes observability resources for API Gateway and Lambda logs, CloudWatch alarms, and CloudTrail.

Validate

source /workspace/.venv/bin/activate
sam validate --template /workspace/template.yaml
aws cloudformation validate-template --template-body file:///workspace/template.yaml

Create a reviewable change set (no execute)

source /workspace/.venv/bin/activate
sam build --template-file /workspace/template.yaml
sam deploy \
  --template-file .aws-sam/build/template.yaml \
  --stack-name <stack-name> \
  --capabilities CAPABILITY_IAM CAPABILITY_AUTO_EXPAND \
  --parameter-overrides StageName=prod \
  --resolve-s3 \
  --no-execute-changeset