346cc5f6fb
Merge remote-tracking branch 'origin/main'
...
# Conflicts:
# manage_docs.py
# requirements.txt
2026-01-22 17:25:31 +05:30
f7f9744e47
docs-and-mcps ( #1 )
...
Reviewed-on: #1
Co-authored-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com >
Co-committed-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com >
2026-01-22 11:28:23 +00:00
9d1635c043
added mcp
2026-01-19 22:44:54 +05:30
32c2c07aa2
removed mcp
2026-01-19 22:26:49 +05:30
d0978cea99
added mcp server file
2026-01-19 18:33:43 +05:30
93b3718320
cleanup
2026-01-19 18:33:30 +05:30
6a4aece659
feat(docs): add MCP artifact generation to manage_docs CLI
...
- Introduced `build_mcp` command to generate docs-only MCP artifacts
- Reuses existing MkDocs + mkdocstrings pipeline (no code introspection)
- Extracts `:::` mkdocstrings directives from generated Markdown
- Emits structured MCP output:
- `mcp/index.json` (project metadata)
- `mcp/nav.json` (page → module mapping)
- `mcp/modules/*.json` (per-module references)
- Preserves all existing commands and behavior (`generate`, `build`, `serve`)
- Avoids source code exposure; MCP output is derived solely from documentation
This enables a clean docs → MCP → MCP server workflow suitable for AI IDE integration.
2026-01-19 18:22:59 +05:30
3636e6edc8
added credentials in docs
2026-01-18 18:39:11 +05:30
b6f64615ae
doc changes
continuous-integration/drone/tag Build is passing
2026-01-10 16:50:33 +05:30
9e534ed961
feat(auth): introduce credential store abstraction and refactor Google auth
...
- Add generic CredentialStore abstraction for credential persistence
- Introduce pickle- and Redis-backed credential store implementations
- Refactor Google OAuth provider to delegate persistence to CredentialStore
- Make auth providers generic over credential type for stricter contracts
- Update package documentation to reflect credential lifecycle vs persistence split
- Add credentials module to public API surface
- Harden .gitignore to exclude credential and token artifacts
This release removes node-local persistence assumptions, enables
distributed-safe authentication, and formalizes credential storage as
a first-class extension point.
2026-01-10 16:45:38 +05:30
985194cd5b
docs(api): update package docs for credential store–based auth design
...
- Update package-level documentation to reflect credential persistence
as a first-class concept
- Replace token_path-based examples with CredentialStore usage
- Add credentials module to documented public API surface
- Clarify auth vs credential persistence responsibilities
- Align design guarantees with distributed-safe authentication model
2026-01-10 16:44:20 +05:30
91eab636bb
ignore client_secret, credentials and token files
2026-01-10 16:42:09 +05:30
4e63c36199
refactor(auth): type auth providers and decouple Google auth from disk storage
...
- Make MailIntakeAuthProvider generic over credential type to enforce
typed auth contracts between providers and adapters
- Refactor Google OAuth provider to use CredentialStore abstraction
instead of filesystem-based pickle persistence
- Remove node-local state assumptions from Google auth implementation
- Clarify documentation to distinguish credential lifecycle from
credential persistence responsibilities
This change enables distributed-safe authentication providers and
allows multiple credential persistence strategies without modifying
auth logic.
2026-01-10 16:40:51 +05:30
24b3b04cfe
correct packages find include
continuous-integration/drone/tag Build is passing
2026-01-09 17:54:04 +05:30
08136d8a64
correct packages find include
continuous-integration/drone/tag Build is failing
2026-01-09 17:51:27 +05:30
677ead8ef5
fixed tests to use correct imports
continuous-integration/drone/tag Build is failing
2026-01-09 17:44:42 +05:30
4cf5110684
fixed imports in mail_intake
2026-01-09 17:44:31 +05:30
77dabf8df8
added .drone.yml
2026-01-09 17:41:53 +05:30
b14ffe9e44
docs(mail_intake): add MkDocs navigation and API reference document structure
...
- docs(mkdocs.yml): define navigation structure for mail_intake modules
- docs(mkdocs.yml): configure mkdocstrings for Python API rendering
- docs(docs): add documentation root and mail_intake index page
- docs(docs): add adapters documentation pages with mkdocstrings directives
- docs(docs): add auth documentation pages with mkdocstrings directives
- docs(docs): add ingestion documentation pages with mkdocstrings directives
- docs(docs): add models documentation pages with mkdocstrings directives
- docs(docs): add parsers documentation pages with mkdocstrings directives
- docs(docs): add config and exceptions documentation pages
2026-01-09 17:41:10 +05:30
f22af90e98
docs(mail_intake): add comprehensive docstrings across ingestion, adapters, auth, and parsing layers
...
- docs(mail_intake/__init__.py): document module-based public API and usage patterns
- docs(mail_intake/ingestion/reader.py): document high-level ingestion orchestration
- docs(mail_intake/adapters/base.py): document adapter contract for mail providers
- docs(mail_intake/adapters/gmail.py): document Gmail adapter implementation and constraints
- docs(mail_intake/auth/base.py): document authentication provider contract
- docs(mail_intake/auth/google.py): document Google OAuth authentication provider
- docs(mail_intake/models/message.py): document canonical email message model
- docs(mail_intake/models/thread.py): document canonical email thread model
- docs(mail_intake/parsers/body.py): document message body extraction logic
- docs(mail_intake/parsers/headers.py): document message header normalization utilities
- docs(mail_intake/parsers/subject.py): document subject normalization utilities
- docs(mail_intake/config.py): document global configuration model
- docs(mail_intake/exceptions.py): document library exception hierarchy
2026-01-09 17:40:25 +05:30
dbfef295b8
added google packages
2026-01-09 17:40:14 +05:30
505950eafa
also generate index.md for __init__.py files
2026-01-09 17:07:32 +05:30
3a550ab576
manage_docs cli
2026-01-09 17:03:59 +05:30
44d36575c6
added mkdocs packages
2026-01-09 17:03:43 +05:30
b18b717c52
added mkdocs packages
2026-01-09 16:42:35 +05:30
412a9c7bec
lib init
2026-01-03 05:21:55 +05:30
278f0a3d40
init
2026-01-03 05:20:14 +05:30
