Skip to content

docs: README in remaining component bricks (final sweep)#925

Merged
bjagg merged 1 commit into
LIF-Initiative:mainfrom
bjagg:docs/readmes-remaining-components
May 16, 2026
Merged

docs: README in remaining component bricks (final sweep)#925
bjagg merged 1 commit into
LIF-Initiative:mainfrom
bjagg:docs/readmes-remaining-components

Conversation

@bjagg
Copy link
Copy Markdown
Contributor

@bjagg bjagg commented May 16, 2026

Summary

Tier 1 README sweep, batch 4 of 4 — closes out the goal of "every directory that has at least a file or two has a README". Adds 26 short READMEs across the remaining component bricks and a few subdirectories.

Coverage

  • Auth + middleware: api_key_auth, auth
  • Data plumbing: composer, datatypes, exceptions, logging, mongodb_connection, string_utils
  • Schema + config: lif_schema_config, openapi_schema_parser, openapi_to_graphql, schema_state_manager
  • Source-adapter framework: data_source_adapters + two adapter subdirs (lif_to_lif_adapter, example_data_source_rest_api_to_lif_adapter)
  • Identity mapper trio: identity_mapper_service, identity_mapper_storage, identity_mapper_storage_sql
  • Service-specific bricks: example_data_source_service, graphql_client, langchain_agent (+ prompts/), semantic_search_service, translator
  • Tenant routing pure helpers: tenant_routing
  • Subdirs: langchain_agent/prompts (5 prompt templates), mdr_client/resources (bundled OpenAPI snapshot)

Wrapping up the sweep

Batch PR Scope
1 #922 11 bases
2 #923 5 MDR components
3 #924 7 query/orchestration components
4 this PR 26 remaining components + subdirs

After this merges, the only missing README under bases/lif/ is learner_data_export_api/ — which will land with cbeach's open PR #920.

Test plan

  • uv run pre-commit run cspell --files <new READMEs> passes
  • Spot-check the "Used by" lists after merge
  • Render check on GitHub: tables, cross-links between READMEs

🤖 Generated with Claude Code

Adds short READMEs to the 26 remaining bricks under components/lif/
and its sub-directories. Same template as PRs LIF-Initiative#922, LIF-Initiative#923, LIF-Initiative#924:
purpose, public surface, file layout where the brick has multiple
modules, and the list of consumers.

Covers:
- Auth + middleware: api_key_auth, auth
- Data plumbing: composer, datatypes, exceptions, logging,
  mongodb_connection, string_utils
- Schema + config: lif_schema_config, openapi_schema_parser,
  openapi_to_graphql, schema_state_manager
- Source-adapter framework: data_source_adapters (+ two adapter
  subdirs: lif_to_lif_adapter and
  example_data_source_rest_api_to_lif_adapter)
- Identity mapper trio: identity_mapper_service,
  identity_mapper_storage, identity_mapper_storage_sql
- Service-specific: example_data_source_service, graphql_client,
  langchain_agent (+ prompts/), semantic_search_service, translator
- Tenant routing pure helpers: tenant_routing
- Subdirs: langchain_agent/prompts (5 prompt templates),
  mdr_client/resources (bundled OpenAPI snapshot)

cspell: add getenv, inlines, isinstance.

Closes out the Tier 1 README sweep across bases/ and components/.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant