Catàleg de mòduls del backend

Owned Python modules parsed without importing the application. Counts describe top-level declarations and are navigation aids, not complexity scores.

Regenera amb python pipeline/skills/technical_documentation/scripts/generate.py.

Grups de mòduls

Grup	Mòduls	Línies
agent	53	9510
api	38	13306
app	8	822
application root	2	55
config	13	1382
data	2	214
domains	530	108704
mcp	3	429
migrations	39	2301
models	12	1219
platform	13	1377
scheduler	8	1369
scripts	2	69
security	6	948
services	238	47673
sync	1	1
utils	7	865

Total: 975 modules and 190244 source lines.

agent

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/agent/__init__.py	0	0	0	0	0	No module docstring
backend/agent/action_confirmations.py	775	0	28	0	22	Persistent, scope-bound confirmations for consequential agent actions.
backend/agent/activity_tools.py	53	0	3	0	3	Scoped inspection of schedules and execution outcomes, without self-grants.
backend/agent/agent_context.py	199	1	1	0	2	Attached context sources for a Cognition agent.
backend/agent/calendar_tools.py	121	0	6	5	5	Governed adapters for exact calendar reads and external mutations.
backend/agent/contact_tools.py	158	0	6	0	4	Governed adapters for local contact maintenance.
backend/agent/context_safety.py	46	0	2	0	2	Boundaries for untrusted evidence supplied to the agent.
backend/agent/context_sources/__init__.py	42	1	2	0	1	Catalogue of large searchable sources an agent can attach (phase 3).
backend/agent/context_sources/boe.py	174	0	6	0	4	BOE adapter: search the Spanish official gazette through its open API.
backend/agent/conversation_memory.py	27	0	1	0	1	Deterministic, bounded conversation-memory compaction.
backend/agent/directive_tools.py	90	0	4	0	4	No module docstring
backend/agent/evals/__init__.py	1	0	0	0	0	Deterministic evaluation corpus for the universal agent contract.
backend/agent/evals/response_runner.py	99	0	5	0	3	Run deterministic final-response quality evaluations without a model.
backend/agent/evals/runner.py	144	0	5	0	3	Run the deterministic universal-turn evaluation corpus.
backend/agent/factory.py	257	0	5	1	5	Compatibility facade for the canonical :mod:backend.domains.agent package.
backend/agent/feature_tool_support.py	56	0	4	0	3	Authenticated scope and bounded results for optional feature adapters.
backend/agent/generated_tools/__init__.py	3	0	0	0	0	No module docstring
backend/agent/generated_tools/creator.py	226	0	4	0	4	Tool Creator: The meta-tool that allows the agent to create new tools.
backend/agent/generated_tools/dry_run.py	145	2	1	0	3	Dry-Run Wrapper: Preview external operations before execution.
backend/agent/generated_tools/learning_loop.py	218	2	0	0	2	Learning Loop: Auto-correction and knowledge preservation for tool development.
backend/agent/generated_tools/loader.py	106	1	0	0	1	Tool Loader: Dynamically loads approved tools at runtime.
backend/agent/generated_tools/registry.py	264	3	0	0	1	Tool Registry: Persistent storage and lookup for generated tools.
backend/agent/generated_tools/sandbox_runner.py	188	1	5	0	3	Run approved generated tools in a short-lived restricted subprocess.
backend/agent/generated_tools/validator.py	33	0	0	0	0	Compatibility exports for generated-tool validation.
backend/agent/generated_tools/verification_sandbox.py	118	4	0	0	4	Run generated-tool tests in a short-lived subprocess sandbox.
backend/agent/gnosi_tools.py	158	1	0	0	1	Compatibility facade for stable first-party Gnosi tools.
backend/agent/internal_sources.py	571	0	22	0	10	Scoped read adapters for first-party Gnosi data modules.
backend/agent/job_tools.py	87	0	7	0	6	Governed tools for provider-neutral durable capability jobs.
backend/agent/json_tool_model.py	64	1	0	0	0	Validated tool transport for models without native function calling.
backend/agent/literature_tools.py	132	0	8	1	8	Governed academic discovery and local review inspection adapters.
backend/agent/llm_wiki_tools.py	120	0	4	0	4	Governed agent adapters for the built-in LLM Wiki plugin.
backend/agent/mail_tools.py	164	0	10	8	8	Governed adapters for exact mail reads and mutations.
backend/agent/media_tools.py	92	0	3	3	3	Bounded gallery adapters over the existing media endpoints.
backend/agent/memory.py	192	2	4	0	3	Lazy compatibility stores for legacy Chroma-backed Agent memory.
backend/agent/model_catalog.py	623	0	27	0	22	Provider → model catalog for the model-comparison activation workflow.
backend/agent/model_reliability.py	235	0	10	0	5	Why a model call failed, recorded as evidence per provider:model.
backend/agent/model_router.py	552	1	13	0	12	Data-driven, budget-aware model router.
backend/agent/notebook_tools.py	155	0	10	0	10	Assignable notebook lifecycle and evidence tools with workspace ACLs.
backend/agent/notion_tools.py	71	0	5	5	5	Governed adapters for connected Notion discovery and exact cloning.
backend/agent/planning_resource_tools.py	81	0	5	5	5	Planning resource mutations backed by the canonical validated endpoints.
backend/agent/planning_tools.py	167	0	13	12	12	Governed tools over Gnosi's authoritative project-planning services.
backend/agent/provider_resilience.py	263	2	4	0	5	Provider failover that is safe for cached, request-independent workflows.
backend/agent/reader_tools.py	302	0	17	0	14	Governed tools for inspecting and analysing Gnosi Reader content.
backend/agent/recovery.py	48	1	2	0	2	Safe, bounded recovery metadata for failed agent turns.
backend/agent/semantic_interpreter.py	113	0	5	0	3	Bounded, multilingual interpretation before capability routing.
backend/agent/social_tools.py	145	0	9	7	8	Governed adapters for Gnosi social reading, composition, and publishing.
backend/agent/system_tools.py	430	0	13	0	13	No module docstring
backend/agent/tools.py	83	0	2	0	2	No module docstring
backend/agent/translation_tools.py	64	0	3	3	3	Governed adapters for the existing idempotent translation workflows.
backend/agent/turn_contract.py	72	0	0	0	0	Compatibility exports for governed turn planning and verification.
backend/agent/vault_admin_tools.py	345	0	11	0	10	Governed adapters for Vault schema discovery and page organization.
backend/agent/vault_tools.py	493	0	16	0	15	Knowledge tool belt: gives the agent HANDS on the vault (not just search).
backend/agent/web_context.py	145	0	3	0	3	Fetching web pages attached to an agent's context (phase 2).

api

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/api/__init__.py	30	0	0	0	0	No module docstring
backend/api/agent_routes.py	209	1	0	0	1	Compatibility facade for the modular agent HTTP routes.
backend/api/agent_skills_routes.py	194	1	0	0	1	Compatibility facade for governed agent configuration APIs.
backend/api/ai_routes.py	754	3	14	9	10	No module docstring
backend/api/analytics_routes.py	378	0	12	7	12	No module docstring
backend/api/auth_routes.py	384	7	11	0	11	Auth endpoints — register / login / logout / me.
backend/api/calendar_routes.py	692	0	30	22	20	No module docstring
backend/api/collab_routes.py	246	2	3	1	4	Real-time collaboration — presence + per-page message relay.
backend/api/config_routes.py	13	0	0	0	0	Compatibility facade for the configuration settings router.
backend/api/contacts_routes.py	316	0	9	7	1	No module docstring
backend/api/credentials_routes.py	30	0	0	0	0	Compatibility facade for the secure credentials router.
backend/api/env_routes.py	22	0	0	0	0	Compatibility facade for the local environment router.
backend/api/google_auth_routes.py	342	3	7	4	1	No module docstring
backend/api/handwriting_routes.py	149	4	4	4	3	LOCAL handwriting recognition endpoint (ink → text) using TrOCR.
backend/api/identity_routes.py	83	0	4	2	1	No module docstring
backend/api/integrations_routes.py	566	0	17	12	16	No module docstring
backend/api/literature_routes.py	740	0	34	15	0	HTTP contracts for academic search and systematic literature review.
backend/api/mail_routes.py	309	0	7	7	6	Compatibility facade and composition boundary for the mail domain.
backend/api/meeting_routes.py	100	2	4	2	3	Endpoints for the AI meeting notetaker.
backend/api/microsoft_auth_routes.py	291	3	6	3	0	Microsoft OAuth2 authentication routes.
backend/api/notebook_routes.py	364	0	16	2	1	HTTP contracts for the grounded notebook workspace.
backend/api/notion_oauth_routes.py	222	2	13	4	3	OAuth 2.1 to Notion's hosted MCP (mcp.notion.com) — for recreating views.
backend/api/notion_routes.py	756	23	27	13	12	Compatibility-preserving FastAPI surface for the typed Notion domain.
backend/api/planning_routes.py	766	0	29	24	11	API for normalized project-planning resources and allocation reports.
backend/api/public_routes.py	458	12	14	1	10	Gnosi's public API with Personal Access Token (PAT) authentication.
backend/api/reader.py	75	0	0	0	0	Compatibility facade for the Reader HTTP API.
backend/api/scheduler_routes.py	135	1	6	6	6	No module docstring
backend/api/share_routes.py	249	6	7	4	5	External share links for single vault pages (Notion-style).
backend/api/social_routes.py	740	0	21	18	20	No module docstring
backend/api/system_routes.py	714	1	25	9	25	HTTP routes for system notifications, status and filesystem access.
backend/api/tools_routes.py	187	4	6	5	6	API Routes for Generated Tools Management.
backend/api/vault_graph_routes.py	146	1	5	1	3	No module docstring
backend/api/vault_routes.py	739	0	2	0	0	No module docstring
backend/api/vault_templates_routes.py	322	7	10	0	8	Vault template catalog, creation, export, and moderated submission routes.
backend/api/vault_views_routes.py	404	4	9	3	7	vault_views_routes.py — API to manage per-page views.
backend/api/vaults_routes.py	429	6	11	0	10	Vaults API (personal multi-vault mode): list, create and choose vaults.
backend/api/virtual_fields.py	711	0	35	0	29	Virtual fields: derived properties computed by the backend at read-time.
backend/api/workspace_routes.py	41	0	0	0	0	Compatibility facade for the workspace domain router.

app

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/app/__init__.py	5	0	0	0	0	FastAPI composition for the Gnosi backend.
backend/app/desktop_instance.py	45	1	0	0	1	Correlate desktop readiness with its spawned process without changing JSON.
backend/app/errors.py	68	0	3	2	3	Global HTTP error translation and private diagnostic notification.
backend/app/factory.py	92	0	4	2	3	Typed construction of the Gnosi FastAPI application.
backend/app/health_contracts.py	54	3	0	0	3	Typed response contracts for liveness and Google OAuth diagnostics.
backend/app/lifespan.py	354	1	13	5	14	Application startup, maintenance and shutdown lifecycle.
backend/app/middleware.py	35	0	1	0	1	Ordered middleware composition for Gnosi's FastAPI application.
backend/app/routes.py	169	0	1	0	1	Single ordered registry for every public Gnosi router.

application root

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/__init__.py	0	0	0	0	0	No module docstring
backend/server.py	55	0	0	0	0	Stable Uvicorn and Electron entrypoint for the Gnosi backend.

config

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/config/__init__.py	0	0	0	0	0	No module docstring
backend/config/app_config.py	277	1	9	0	9	No module docstring
backend/config/data_dir.py	104	0	4	0	4	Canonical per-device data directory resolution for Gnosi 3.x.
backend/config/desktop_server.py	18	0	1	0	1	Keep Electron's private listener separate from configured native services.
backend/config/directory_preparation.py	65	1	0	0	1	Briefly reuse successful directory preparation, never content or access checks.
backend/config/env_config.py	271	0	16	0	12	Environment loading with explicit Gnosi 3.x precedence and boundaries.
backend/config/logger_config.py	42	0	2	0	1	No module docstring
backend/config/mcp_config.py	8	0	0	0	0	No module docstring
backend/config/paths_config.py	239	0	4	0	1	No module docstring
backend/config/schema_keys.py	139	0	2	0	2	Candidate keys and aliases for data extraction from JSON and local Markdown.
backend/config/startup_vault.py	89	0	4	2	2	Materialize startup-critical Vault files before app imports.
backend/config/validation_runtime.py	35	0	1	0	1	Explicit, fail-closed isolation for disposable runtime acceptance probes.
backend/config/yaml_cache.py	95	1	1	0	1	Reuse decoded configuration while checking the file on every read.

data

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/data/db.py	132	2	4	0	5	No module docstring
backend/data/management_db.py	82	1	4	0	2	No module docstring

domains

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/domains/__init__.py	1	0	0	0	0	Gnosi backend domain packages.
backend/domains/agent/__init__.py	1	0	0	0	0	Agent domain services and workflow composition.
backend/domains/agent/context.py	688	0	20	0	20	Deterministic context planning and server-owned tool calls.
backend/domains/agent/context_core_tools.py	312	1	1	0	1	Core read and search tools for attached context references.
backend/domains/agent/context_filters.py	94	0	4	0	1	Exact field predicates over authorized inventory records.
backend/domains/agent/context_inventory_tools.py	567	1	2	0	2	Exhaustive deterministic inventory tool for attached Vault context.
backend/domains/agent/context_matching.py	356	0	11	0	10	Deterministic matching for attached Vault inventories.
backend/domains/agent/context_notebook_tools.py	157	0	1	0	1	Tools closed over grounded notebook context references.
backend/domains/agent/context_reader_tools.py	178	0	2	0	1	Tools closed over one attached Reader scope.
backend/domains/agent/context_refs.py	233	0	6	0	4	Normalization and descriptions for attached context references.
backend/domains/agent/context_storage.py	487	0	28	0	10	Vault-backed readers for attached context references.
backend/domains/agent/context_tools.py	45	0	1	0	1	Runtime tools closed over an attached context scope.
backend/domains/agent/exact_actions.py	83	0	3	0	1	Prepare bounded exact assignments from current user text and Vault evidence.
backend/domains/agent/generated_tools/__init__.py	1	0	0	0	0	Governed generated-tool validation owned by the agent domain.
backend/domains/agent/generated_tools/validator.py	331	3	0	0	1	Security validation for generated agent tools.
backend/domains/agent/gnosi_confirmations.py	361	0	7	0	6	Preparation tools for consequential first-party actions.
backend/domains/agent/gnosi_dispatch.py	29	0	1	1	1	Executor for claimed first-party confirmations.
backend/domains/agent/gnosi_dispatch_basic.py	226	0	8	8	0	Confirmed handlers for pages, contacts, mail and calendars.
backend/domains/agent/gnosi_dispatch_rows.py	224	0	7	2	0	Confirmed handlers for deterministic row rewrites.
backend/domains/agent/gnosi_dispatch_tables.py	303	0	8	5	0	Confirmed handlers for table, history, trash and schema operations.
backend/domains/agent/gnosi_integrations.py	390	0	12	8	11	First-party calendar, mail and contacts tools.
backend/domains/agent/gnosi_mutation.py	64	0	2	0	2	Cross-process page mutation lock.
backend/domains/agent/gnosi_support.py	616	1	30	2	11	Shared deterministic helpers for first-party Gnosi tools.
backend/domains/agent/gnosi_vault_tools.py	388	0	15	0	14	Vault read and explicit-write tools.
backend/domains/agent/intent.py	323	0	5	0	4	Deterministic multilingual intent and authorization classification.
backend/domains/agent/llm.py	556	0	21	0	7	Typed language-model selection and provider adapters.
backend/domains/agent/messages.py	229	0	9	0	2	Bounded projection of durable agent messages into provider prompts.
backend/domains/agent/operation_graph.py	94	0	2	0	0	Structured operations with optional governed read tools.
backend/domains/agent/policy.py	403	1	11	0	11	Request-scoped agent state, cancellation and governed tool policy.
backend/domains/agent/responses.py	481	0	14	0	14	Deterministic, localized rendering of trusted agent tool results.
backend/domains/agent/routes/__init__.py	1	0	0	0	0	Modular HTTP routes for the agent domain.
backend/domains/agent/routes/attachments.py	215	0	9	2	4	No module docstring
backend/domains/agent/routes/chat_error_messages.py	91	0	1	0	0	User-facing stream failures in the application's four languages.
backend/domains/agent/routes/chat_route.py	529	0	6	3	1	No module docstring
backend/domains/agent/routes/chat_stream.py	293	0	4	2	0	Orchestration for the public NDJSON agent event stream.
backend/domains/agent/routes/chat_stream_errors.py	275	0	4	2	0	Failure translation and cleanup for agent event streams.
backend/domains/agent/routes/chat_stream_state.py	98	1	0	0	0	Mutable request-local state for one agent event stream.
backend/domains/agent/routes/chat_stream_updates.py	317	0	7	1	0	Workflow update translation for the public agent event stream.
backend/domains/agent/routes/checkpoints.py	348	1	14	1	7	No module docstring
backend/domains/agent/routes/confirmations.py	558	0	16	9	10	No module docstring
backend/domains/agent/routes/contracts.py	255	10	0	0	3	No module docstring
backend/domains/agent/routes/learning_context.py	31	0	1	0	0	Resolve only the caller's project and explicitly requested memories for a turn.
backend/domains/agent/routes/misc.py	197	2	6	6	8	No module docstring
backend/domains/agent/routes/response_models.py	120	16	0	0	0	No module docstring
backend/domains/agent/routes/router.py	3	0	0	0	0	No module docstring
backend/domains/agent/routes/runs.py	286	8	16	2	0	Authenticated access to principal operation activity and explicit retries.
backend/domains/agent/routes/sessions.py	257	0	4	4	3	No module docstring
backend/domains/agent/routes/shared.py	193	1	8	0	5	No module docstring
backend/domains/agent/routes/state.py	3	0	0	0	0	No module docstring
backend/domains/agent/routes/task_evaluations.py	132	0	8	1	0	Administrator-only previews and explicit checks of active candidate routes.
backend/domains/agent/routes/workflow.py	181	0	1	1	1	No module docstring
backend/domains/agent/row_titles.py	35	0	2	0	2	Use the table's visible title field for confirmed row edits.
backend/domains/agent/runtime_tools.py	581	0	18	0	17	Typed agent capability resolution, metadata and tool selection.
backend/domains/agent/sources/__init__.py	1	0	0	0	0	Scoped read adapters for first-party agent sources.
backend/domains/agent/sources/integrations.py	158	0	7	0	3	Mail, calendar and contacts read adapters.
backend/domains/agent/sources/mail.py	175	0	7	0	1	Mail context reads retain both account and folder identity.
backend/domains/agent/sources/optional.py	267	0	17	0	3	Social, meeting and Notion read adapters.
backend/domains/agent/sources/planning.py	190	0	9	0	1	Project-planning read adapter.
backend/domains/agent/sources/reader.py	227	0	5	0	1	Reader inventory, search and exact-read adapters.
backend/domains/agent/sources/references.py	144	0	8	0	1	Vault reference-library read adapter.
backend/domains/agent/sources/scopes.py	393	0	15	0	6	Normalization and containment for internal source scopes.
backend/domains/agent/stream_protocol.py	318	1	8	5	2	Versioned, bounded protocol for streamed agent events.
backend/domains/agent/structured_output.py	83	0	3	0	3	Provider-enforced JSON for OpenRouter operations, with local validation retained.
backend/domains/agent/table_schema.py	44	0	2	0	1	Exact schema requests and responses, independent of record search.
backend/domains/agent/team_help.py	141	3	4	0	1	Optional, bounded handoff from an assistant to its configured team.
backend/domains/agent/title_context.py	58	0	4	0	2	Resolve human title targets and the selected embedded view before planning.
backend/domains/agent/title_edit_contract.py	119	4	1	0	1	Bounded title transformations: model proposals are data, never executable code.
backend/domains/agent/title_followups.py	48	0	3	0	1	Parse literal follow-up operands and verify illustrative examples as data.
backend/domains/agent/title_replacements.py	247	0	13	0	8	Exact human title substitutions over one server-resolved active view.
backend/domains/agent/title_wording.py	35	0	1	0	1	Finite scope grammar for literal substitutions in the current view's titles.
backend/domains/agent/tool_runtime.py	253	0	12	0	5	Runtime contract for bounded, observable agent tool calls.
backend/domains/agent/turn_citations.py	552	1	12	0	5	Citation extraction and validation for governed agent turns.
backend/domains/agent/turn_evidence.py	343	1	9	0	1	Deterministic evidence verification for governed agent turns.
backend/domains/agent/turn_planning.py	472	0	7	0	4	Provider-independent planning for governed agent turns.
backend/domains/agent/workflow.py	292	1	5	1	6	Agent workflow coordination and compatibility-preserving dependencies.
backend/domains/agent/workflow_nodes.py	782	4	0	0	3	LangGraph nodes for the agent workflow.
backend/domains/agent/workflow_setup.py	773	4	16	1	20	Typed preparation stages for the agent workflow coordinator.
backend/domains/agent/write_intent.py	537	0	8	0	5	Fail-closed multilingual authorization intent.
backend/domains/analytics/__init__.py	1	0	0	0	0	Analytics-domain contracts and services.
backend/domains/analytics/schemas.py	93	10	0	0	10	Public request and response contracts for workspace analytics.
backend/domains/calendar/__init__.py	1	0	0	0	0	Calendar domain.
backend/domains/calendar/api_contracts.py	59	5	0	0	5	Explicit request contracts for the public Calendar API.
backend/domains/calendar/geocoding.py	99	0	2	1	2	Provider-neutral Photon address lookup for Calendar.
backend/domains/calendar/google.py	393	0	12	0	8	No module docstring
backend/domains/calendar/mutations.py	102	0	5	1	1	Calendar mutation helpers independent from FastAPI transport concerns.
backend/domains/calendar/runtime.py	286	1	8	0	2	Provider-neutral calendar loading, caching, and Vault event projection.
backend/domains/calendar/schemas.py	259	27	0	0	13	Pydantic contracts for the public Calendar API.
backend/domains/calendar/timing.py	126	1	4	1	0	Private opt-in timings for GET /calendar/calendars and /calendar/events.
backend/domains/configuration/__init__.py	1	0	0	0	0	Configuration domain.
backend/domains/configuration/agent/__init__.py	1	0	0	0	0	Configuration APIs for governed agent skills and capabilities.
backend/domains/configuration/agent/catalog_models.py	155	19	0	0	3	Typed JSON responses for governed skill catalogs and automations.
backend/domains/configuration/agent/catalog_routes.py	672	0	26	0	4	Catalog, assignment and automation routes for agent skills.
backend/domains/configuration/agent/contracts.py	93	7	0	0	7	Request contracts for governed agent configuration APIs.
backend/domains/configuration/agent/governance_models.py	248	29	0	0	0	Typed JSON responses for agent governance and quality endpoints.
backend/domains/configuration/agent/governance_routes.py	602	0	28	1	17	Governance and quality routes for agent capabilities.
backend/domains/configuration/agent/learning_project_routes.py	73	0	5	0	0	User-scoped project context for learning and reusing procedures.
backend/domains/configuration/agent/learning_routes.py	163	0	6	2	5	Conversation-derived skill drafts, explicit adoption and bounded trials.
backend/domains/configuration/agent/router.py	5	0	0	0	0	Shared router singleton for governed agent configuration APIs.
backend/domains/configuration/ai/__init__.py	1	0	0	0	0	AI configuration domain routes and contracts.
backend/domains/configuration/ai/budget.py	25	0	1	0	1	Normalize model registry budget settings.
backend/domains/configuration/ai/content_routes.py	171	4	5	2	3	Typed AI content-generation routes used by the Vault editor.
backend/domains/configuration/ai/contracts.py	407	32	0	0	25	Public request and response contracts for AI registry and usage APIs.
backend/domains/configuration/ai/model_bindings.py	44	0	2	0	0	Explicit model bindings and safe confirmation of their removal.
backend/domains/configuration/ai/model_metadata_routes.py	18	0	1	1	1	Read-only model metadata used by assistant settings.
backend/domains/configuration/ai/model_parameter_routes.py	29	0	1	1	0	Review configured model parameters within the AI settings domain.
backend/domains/configuration/ai/registry_revision.py	9	0	1	0	0	Optimistic revision for model and budget edits from independent clients.
backend/domains/configuration/ai/usage_routes.py	97	0	5	5	2	Authenticated, provider-independent consumption dashboard.
backend/domains/configuration/api/__init__.py	1	0	0	0	0	Configuration HTTP APIs.
backend/domains/configuration/api/credentials.py	216	0	5	5	5	No module docstring
backend/domains/configuration/api/environment.py	182	0	4	2	4	No module docstring
backend/domains/configuration/api/plugin_lifecycle.py	249	1	10	4	2	Dependency-aware plugin lifecycle and runtime transitions.
backend/domains/configuration/api/plugin_models.py	229	29	0	0	23	Pydantic contracts for the plugin configuration API.
backend/domains/configuration/api/plugin_routes.py	201	1	1	0	2	Route composition for the plugin API.
backend/domains/configuration/api/plugins.py	703	1	48	23	30	HTTP adapters for built-in and third-party plugin configuration.
backend/domains/configuration/api/settings.py	374	0	22	5	16	No module docstring
backend/domains/configuration/config_response_cache.py	104	2	0	0	1	Thread-safe cache for sanitized configuration responses.
backend/domains/configuration/credential_schemas.py	41	4	0	0	0	Public schemas for secret-safe credential management.
backend/domains/configuration/environment_schemas.py	21	3	0	0	3	Public request and response contracts for local environment settings.
backend/domains/configuration/llm_wiki.py	334	1	10	1	2	Validation and persistence workflow for LLM Wiki configuration.
backend/domains/configuration/llm_wiki_records.py	294	1	12	0	3	Normalization and migration of managed LLM Wiki page records.
backend/domains/configuration/llm_wiki_schema.py	456	1	13	0	3	Idempotent Brain schema and source-relation consolidation.
backend/domains/configuration/plugin_state.py	134	3	3	0	2	Single owner for per-vault plugin state and mutation locks.
backend/domains/configuration/settings_schemas.py	29	4	0	0	4	Public contracts for the application configuration document.
backend/domains/configuration/source_sections_schema.py	72	0	1	0	1	Idempotent relation and backing table for each Brain's source structure.
backend/domains/contacts/__init__.py	1	0	0	0	0	Contacts-domain contracts and services.
backend/domains/contacts/schemas.py	128	10	0	0	10	Public request and response contracts for contacts.
backend/domains/genograms/__init__.py	1	0	0	0	0	Shared, portable family networks and genogram projections.
backend/domains/genograms/contracts.py	111	10	0	0	0	Versioned genogram HTTP and saved-view contracts.
backend/domains/genograms/locking.py	47	0	1	0	0	Serialize family mutations across threads and local server workers.
backend/domains/genograms/model.py	208	1	4	0	1	Pure validation and bounded projection; never infer undocumented facts.
backend/domains/genograms/routes.py	60	0	4	3	0	Authenticated, per-Vault preparation and read-only graph projection.
backend/domains/genograms/schema.py	86	0	4	0	0	Portable table schemas identified by stable IDs, independent of labels.
backend/domains/genograms/storage.py	233	0	12	0	2	Vault adapter and serialized validation around canonical Markdown writes.
backend/domains/graph/__init__.py	5	0	0	0	0	Graph domain.
backend/domains/graph/adapters.py	16	0	1	0	1	Localized boundaries for graph libraries that do not publish type metadata.
backend/domains/graph/cache_inputs.py	225	1	12	0	6	Complete graph inputs used for bounded response-cache revalidation.
backend/domains/graph/edges.py	189	0	9	0	2	Structural, relation and body-link edge construction.
backend/domains/graph/nodes.py	224	0	9	0	6	Page-node loading, cache reuse and graph insertion.
backend/domains/graph/projection.py	126	0	4	0	3	Projection of the canonical graph into the stable frontend payload.
backend/domains/graph/scanning.py	336	0	11	0	9	No module docstring
backend/domains/graph/schemas.py	75	6	0	0	6	Public response contracts for the heterogeneous vault graph.
backend/domains/graph/service.py	563	1	0	0	1	Canonical graph service orchestration.
backend/domains/graph/timing.py	56	1	3	0	0	Optional per-request graph timings, containing no vault or page content.
backend/domains/identity/__init__.py	1	0	0	0	0	Identity-domain contracts and storage services.
backend/domains/identity/schemas.py	32	3	0	0	3	Public request and response contracts for the local identity profile.
backend/domains/integrations/__init__.py	2	0	0	0	0	Provider-neutral integration domain contracts.
backend/domains/integrations/contracts.py	71	9	0	0	3	Public contracts for masked, provider-neutral integration settings.
backend/domains/literature/__init__.py	49	0	0	0	0	Canonical academic literature domain.
backend/domains/literature/connectors/__init__.py	1	0	0	0	0	Typed academic connector adapters and orchestration.
backend/domains/literature/connectors/commercial.py	322	0	4	4	0	Credentialed commercial academic provider adapters.
backend/domains/literature/connectors/crossref.py	216	0	4	3	1	Crossref and DataCite provider adapters.
backend/domains/literature/connectors/dispatcher.py	132	0	3	2	3	Connector dispatch, enrichment, and worker bridging.
backend/domains/literature/connectors/generic.py	207	1	8	2	1	Declarative custom JSON repository adapter.
backend/domains/literature/connectors/graphs.py	263	0	8	4	2	OpenAlex and Semantic Scholar graph adapters.
backend/domains/literature/connectors/normalization.py	207	0	9	0	3	Canonical normalization shared by academic provider adapters.
backend/domains/literature/connectors/public.py	571	0	8	8	0	Public and open academic repository adapters.
backend/domains/literature/connectors/runtime.py	99	6	2	0	2	Typed late-bound compatibility seam for academic connector adapters.
backend/domains/literature/connectors/transport.py	278	1	11	4	7	Bounded transport, SSRF protection, and request auditing.
backend/domains/literature/connectors/xml.py	215	0	6	2	3	XML, arXiv, and OAI-PMH provider adapters.
backend/domains/literature/repositories.py	746	0	14	1	4	Academic repository catalog and configuration.
backend/domains/literature/review_logic.py	289	0	10	0	4	Pure systematic-review workflow, PRISMA, and export logic.
backend/domains/literature/schemas.py	631	60	0	0	2	Typed HTTP response contracts for literature workflows.
backend/domains/literature/search.py	655	0	17	3	3	Federated and indexed academic search orchestration.
backend/domains/literature/state.py	33	0	0	0	0	Shared mutable state for federated literature workflows.
backend/domains/literature/storage.py	70	0	8	0	0	Vault-native files and local SQLite storage for literature workflows.
backend/domains/literature/sync.py	509	0	11	0	4	Durable academic repository and saved-review synchronization.
backend/domains/llm_wiki/__init__.py	1	0	0	0	0	Typed LLM Wiki extraction and provenance domains.
backend/domains/llm_wiki/brain_fields.py	42	0	2	0	0	Read Brain fields through stable roles and immutable property IDs.
backend/domains/llm_wiki/chunking.py	134	0	7	0	0	Structure-aware, bounded primary chunks with separately labelled neighbours.
backend/domains/llm_wiki/citation_rendering.py	87	0	4	0	0	Deterministic source locators and citation links for generated reading notes.
backend/domains/llm_wiki/classification_repair.py	108	0	4	0	1	Bounded, resumable classification of existing notes through the principal agent.
backend/domains/llm_wiki/contextual_reading.py	394	1	1	0	0	Bounded execution of the process-source skill, with durable phase checkpoints.
backend/domains/llm_wiki/dimensions.py	225	1	7	0	5	Typed LLM Wiki dimension mapping and option normalization.
backend/domains/llm_wiki/directed_reading.py	304	0	7	0	0	Durable JSON actions over immutable source passages and validated draft notes.
backend/domains/llm_wiki/documents.py	432	4	13	0	12	Document and media adapters for LLM Wiki source extraction.
backend/domains/llm_wiki/field_assignments.py	72	0	3	0	2	Writable reading-note fields and deterministic value conversion.
backend/domains/llm_wiki/field_catalogs.py	49	0	2	0	1	Localized option catalogs and semantic values for generated Brain notes.
backend/domains/llm_wiki/field_retirement.py	169	0	4	0	1	Pure, versioned retirement of obsolete Brain field bindings and references.
backend/domains/llm_wiki/idea_classification.py	77	0	6	0	1	Default idea assignment and provenance for editable reading-note metadata.
backend/domains/llm_wiki/index_rendering.py	394	2	12	0	4	Typed rendering for managed LLM Wiki resource and dimension indexes.
backend/domains/llm_wiki/ingestion.py	476	7	9	0	2	Typed blocking orchestration for durable LLM Wiki ingestion.
backend/domains/llm_wiki/legacy_ports.py	95	0	11	0	1	Typed late-bound ports for historical Vault facade collaborators.
backend/domains/llm_wiki/lint_contracts.py	99	10	0	0	10	Records constructed by deterministic Brain checks, not persisted page schemas.
backend/domains/llm_wiki/media_structure.py	95	0	3	0	1	Native PDF bookmarks and media chapter metadata, without inferred divisions.
backend/domains/llm_wiki/migration_files.py	163	0	12	0	2	Verified backups and compare-before-write files for the Brain field migration.
backend/domains/llm_wiki/note_migration.py	554	0	13	0	0	Preview, classify, apply or roll back the explicit Brain note-field migration.
backend/domains/llm_wiki/options.py	24	0	1	0	1	Existing categorical values shared by Knowledge settings and processing.
backend/domains/llm_wiki/origins.py	161	0	5	0	4	Stable origin identity, deduplication, and LLM chunking.
backend/domains/llm_wiki/pdf_extraction_cache.py	63	0	5	0	1	Reuse complete PDF extraction by exact file bytes, including its OCR result.
backend/domains/llm_wiki/pdf_highlight_selection.py	51	0	2	0	1	Rank grounded quotations for a sparse reading aid, independently of citations.
backend/domains/llm_wiki/pdf_quote_matching.py	80	2	6	0	2	Full-span PDF matching with explicit ambiguity; never accept a quote prefix.
backend/domains/llm_wiki/planning.py	239	0	8	0	4	Typed planning and grounding rules for LLM Wiki ingestion.
backend/domains/llm_wiki/reading_action_contracts.py	121	0	4	0	3	Typed action payloads; source identity, coverage and citations are checked locally.
backend/domains/llm_wiki/reading_batch_recovery.py	65	1	5	0	3	Reduce automatic delivery after output exhaustion without altering evidence.
backend/domains/llm_wiki/reading_batch_repairs.py	69	0	2	0	0	Compose immutable per-plan patches into one bounded batch repair.
backend/domains/llm_wiki/reading_contracts.py	110	2	4	0	2	Deterministic evidence and coverage gates for skill-generated reading plans.
backend/domains/llm_wiki/reading_dimension_repairs.py	154	0	4	0	2	Repair memory, classification and references together without rewriting notes.
backend/domains/llm_wiki/reading_identity.py	49	0	5	0	1	Stable reading identities: preserve source order, ignore mapping insertion order.
backend/domains/llm_wiki/reading_memory.py	56	0	2	0	1	Reconstruct global reading memory from all plans in a legacy checkpoint.
backend/domains/llm_wiki/reading_memory_repairs.py	63	1	3	0	1	Require an explicit memory correction while preserving the original draft.
backend/domains/llm_wiki/reading_quality.py	75	0	3	0	2	Mechanical publication checks; these do not certify semantic correctness.
backend/domains/llm_wiki/reading_references.py	57	0	4	0	1	Restore only unambiguous omitted segment digests; never rewrite evidence.
backend/domains/llm_wiki/reading_repairs.py	126	0	6	0	0	Repair rejected references without asking a model to rewrite valid notes.
backend/domains/llm_wiki/reading_skill.py	30	0	0	0	0	The process-source skill's shared, versioned reading methodology.
backend/domains/llm_wiki/recovery.py	131	0	4	0	2	Bounded retries for one Brain planning call, without provider switching.
backend/domains/llm_wiki/search_index.py	373	3	14	0	11	Typed rebuildable lexical and vector indexes for LLM Wiki.
backend/domains/llm_wiki/section_assignment.py	91	0	5	0	3	Single, source-scoped section relations and their derived filter ancestry.
backend/domains/llm_wiki/semantic_context.py	91	0	9	0	2	Deterministic grouping and lexical retrieval over immutable reading evidence.
backend/domains/llm_wiki/semantic_contracts.py	164	0	10	0	1	Small interpretation contracts; the application binds all persistent identities.
backend/domains/llm_wiki/semantic_map_reduction.py	118	1	5	0	4	Contract summaries without recursively splitting summaries into more calls.
backend/domains/llm_wiki/semantic_map_windows.py	51	1	3	0	0	Split only incomplete map windows, preserving complete cached siblings.
backend/domains/llm_wiki/semantic_quote_contracts.py	69	0	5	0	2	Constrain primary evidence before generation without duplicating field schemas.
backend/domains/llm_wiki/semantic_quote_selection.py	168	1	2	0	1	Use immutable quote choices on the first call and every correction alike.
backend/domains/llm_wiki/semantic_reading.py	238	1	1	0	0	Application-directed reading: interpret text, then verify it as a whole.
backend/domains/llm_wiki/semantic_repairs.py	122	0	4	0	2	One bounded repair of invalid passage interpretations; preserve valid work.
backend/domains/llm_wiki/semantic_review.py	83	0	1	0	0	Source-grounded joint review with sparse semantic replacements, never a rewrite loop.
backend/domains/llm_wiki/semantic_review_evidence.py	92	0	5	0	1	Bounded local evidence lookup; requests never invent or shorten originals.
backend/domains/llm_wiki/semantic_review_execution.py	244	1	8	0	1	Two independent reviews with one coordinator and inherited spending scope.
backend/domains/llm_wiki/source_sections.py	99	0	1	0	1	Persist source-owned section rows through the existing Vault page writer.
backend/domains/llm_wiki/source_structure.py	112	1	6	0	5	Original heading paths, independent of note order and evidence locators.
backend/domains/llm_wiki/suggestion_localization.py	44	0	3	0	0	Validate and cache display translations without changing proposal evidence.
backend/domains/llm_wiki/writing.py	554	5	16	0	2	Typed, deterministic persistence for generated LLM Wiki reading notes.
backend/domains/mail/__init__.py	1	0	0	0	0	Mail domain.
backend/domains/mail/cache.py	109	2	7	0	1	Bounded process-local mail caches.
backend/domains/mail/composition.py	18	0	0	0	0	Deterministic composition of the mail router.
backend/domains/mail/connectors/__init__.py	1	0	0	0	0	External connectors used by the mail and content workflows.
backend/domains/mail/connectors/_drupal_values.py	50	0	6	0	6	Native operations on opaque Drupal values; no application schema assertions.
backend/domains/mail/connectors/drupal.py	612	2	23	9	18	Drupal sync client (JSON:API + custom n8n_helper endpoints).
backend/domains/mail/ingestion/__init__.py	1	0	0	0	0	Mail and feed ingestion services.
backend/domains/mail/ingestion/feeds.py	145	0	6	0	2	No module docstring
backend/domains/mail/ingestion/newsletters.py	476	0	16	0	10	Newsletter ingestion via POP3 (STARTTLS).
backend/domains/mail/providers/__init__.py	1	0	0	0	0	Mail-provider adapters.
backend/domains/mail/providers/common.py	43	0	2	0	0	Shared mail-provider normalization helpers.
backend/domains/mail/providers/gmail.py	320	0	7	0	1	Gmail API adapter for the mail domain.
backend/domains/mail/providers/hybrid.py	616	0	16	0	6	Hybrid Mail Service — queries the Gmail API and IMAP directly without a vault.
backend/domains/mail/repositories/__init__.py	1	0	0	0	0	Mail persistence repositories.
backend/domains/mail/repositories/vault.py	198	0	10	0	8	Vault-backed mail persistence helpers.
backend/domains/mail/routes/__init__.py	1	0	0	0	0	Mail HTTP route handlers.
backend/domains/mail/routes/actions.py	259	0	9	5	2	Canonical mail actions.
backend/domains/mail/routes/attachments.py	144	0	3	3	2	Canonical mail attachment routes.
backend/domains/mail/routes/compose.py	736	0	19	12	6	Canonical mail compose.
backend/domains/mail/routes/messages.py	533	0	9	9	7	Canonical mail messages.
backend/domains/mail/routes/remote_images.py	39	1	1	1	1	Mail-only route for bounded recovery of blocked remote raster images.
backend/domains/mail/routes/tags.py	354	0	16	0	0	Canonical mail tags.
backend/domains/mail/routes/views.py	112	0	5	0	0	Canonical mail views.
backend/domains/mail/routing.py	12	0	0	0	0	Canonical mail router registration object.
backend/domains/mail/schemas.py	462	52	0	0	11	Pydantic contracts for the public Mail API.
backend/domains/mail/services/__init__.py	1	0	0	0	0	Mail-domain application services.
backend/domains/mail/services/accounts.py	37	0	3	0	1	Mail account and provider selection helpers.
backend/domains/mail/services/analysis.py	391	2	17	3	7	Bounded execution helpers for user-triggered mail analysis.
backend/domains/mail/services/analysis_cache.py	185	1	9	0	4	Bounded local persistence for the last valid mail analysis result.
backend/domains/mail/services/attachments.py	259	0	4	4	4	Canonical mail attachment service.
backend/domains/mail/services/local_analysis.py	395	4	15	0	1	Conservative local extraction of literal entities from mail content.
backend/domains/mail/services/remote_image_cache.py	519	2	20	0	9	Durable, URL-free cache storage for verified remote mail images.
backend/domains/mail/services/remote_images.py	596	7	15	8	8	Durable, SSRF-hardened recovery for remote mail raster images.
backend/domains/mail/sync/__init__.py	1	0	0	0	0	Mail synchronization services.
backend/domains/mail/sync/idle.py	366	2	0	0	2	IMAP IDLE service: push notifications when new messages arrive.
backend/domains/mail/sync/imap_core.py	543	1	3	0	0	IMAP pull synchronization and vault persistence.
backend/domains/mail/sync/imap_mutations.py	596	1	3	0	0	IMAP server mutation operations.
backend/domains/mail/sync/imap_protocol.py	185	0	5	0	3	IMAP protocol normalization and folder discovery.
backend/domains/mail/sync/imap_service.py	49	1	0	0	1	IMAP mail sync service.
backend/domains/mail/sync/smtp.py	115	0	1	0	1	SMTP delivery for configured IMAP-compatible accounts.
backend/domains/mail/tag_identity.py	69	1	3	0	3	Stable persistence identities for mail-tag associations.
backend/domains/media/__init__.py	1	0	0	0	0	Media-center domain services.
backend/domains/media/index_refresh.py	259	3	9	0	4	Serve the last complete media index while a bounded refresh runs.
backend/domains/media/metadata.py	168	1	8	0	7	Vault-synchronized user metadata for media files.
backend/domains/media/query.py	397	2	10	0	7	Filtering, sorting, pagination, and file selection for media roots.
backend/domains/media/roots.py	251	1	11	0	7	Media-root resolution and lazy folder-tree traversal.
backend/domains/media/scan_cache.py	297	2	10	0	9	Recursive media scanning with in-memory and persistent TTL caches.
backend/domains/media/types.py	157	16	0	0	16	Shared typed contracts for the media-center domain.
backend/domains/media/uploads.py	240	6	5	0	10	Contained media uploads, EXIF extraction, and API file serialization.
backend/domains/media/views.py	198	1	9	0	9	Vault-synchronized saved filters and sort views for media browsing.
backend/domains/notebooks/__init__.py	49	0	0	0	0	Canonical grounded-notebook domain.
backend/domains/notebooks/analysis.py	384	0	8	0	1	Durable whole-notebook analysis workers.
backend/domains/notebooks/catalog.py	335	0	12	0	3	Vault Resource discovery and filtering for grounded notebooks.
backend/domains/notebooks/chat.py	232	0	4	0	3	Notebook conversation scope and agent context resolution.
backend/domains/notebooks/evidence.py	301	0	9	0	2	Search and citation retrieval over pinned notebook evidence.
backend/domains/notebooks/ingest_storage.py	272	0	4	0	1	SQLite writes and revision copies for notebook ingestion.
backend/domains/notebooks/ingestion.py	682	2	14	0	1	Durable ingestion workers for grounded notebook evidence.
backend/domains/notebooks/repository.py	226	0	14	0	5	Persistence and authorization primitives for grounded notebooks.
backend/domains/notebooks/resources.py	365	0	13	0	3	Resource fingerprinting, refresh detection and revision retention.
backend/domains/notebooks/schemas.py	320	27	0	0	27	Public request and response contracts for the Notebooks domain.
backend/domains/notebooks/service.py	569	0	14	0	2	Notebook lifecycle and refresh orchestration.
backend/domains/notebooks/state.py	62	1	0	0	1	Shared process state for grounded notebook services.
backend/domains/notion/__init__.py	1	0	0	0	0	Typed Notion import, clone and embedded-view domain.
backend/domains/notion/clone.py	336	1	17	0	10	Typed exact-clone domain for Notion → Gnosi.
backend/domains/notion/clone_runtime.py	528	4	16	0	1	Typed phase orchestration for the exact Notion clone.
backend/domains/notion/discovery.py	130	1	4	0	2	Typed discovery of loose pages and linked Notion databases.
backend/domains/notion/importer.py	685	2	24	0	12	Typed Notion importer domain (public REST API → Gnosi Vault).
backend/domains/notion/route_clone.py	367	3	3	0	1	Typed filesystem and registry adapter for the Notion clone route.
backend/domains/notion/verification.py	130	2	5	0	1	Typed read-only verification of an exact Notion clone.
backend/domains/notion/view_recreator.py	629	0	28	0	18	Typed recreator of embedded Notion views (Phase 2, via hosted MCP).
backend/domains/planning/__init__.py	1	0	0	0	0	Public contracts for the project-planning domain.
backend/domains/planning/schemas.py	473	46	0	0	46	Pydantic contracts for the public project-planning API.
backend/domains/plugins/__init__.py	5	0	0	0	0	Typed third-party plugin lifecycle and sandbox domain.
backend/domains/plugins/contracts.py	189	2	9	0	4	Plugin manifest contracts and validation.
backend/domains/plugins/packages.py	211	0	11	0	4	Safe installation, removal and deterministic packaging of plugins.
backend/domains/plugins/permissions.py	52	0	3	0	3	Pure permission-state operations for third-party plugins.
backend/domains/plugins/sandbox.py	394	6	11	0	7	Restricted Node subprocess execution for third-party plugins.
backend/domains/plugins/storage.py	162	1	7	0	6	Installed plugin paths, manifests, discovery and provenance.
backend/domains/reader/__init__.py	21	0	0	0	0	Canonical Reader domain.
backend/domains/reader/analysis.py	344	0	12	0	0	Snapshot, map/reduce and report rendering for Reader analyses.
backend/domains/reader/analysis_routes.py	171	1	8	0	9	Reader inventory and durable-analysis HTTP routes.
backend/domains/reader/backfill_routes.py	175	1	4	0	4	Reader full-content extraction and backfill HTTP routes.
backend/domains/reader/internal_sources.py	54	0	5	0	5	Typed boundary around the legacy Reader helpers owned by the agent domain.
backend/domains/reader/podcast_routes.py	130	0	5	0	5	Reader podcast generation and download HTTP routes.
backend/domains/reader/routes.py	514	1	16	1	16	No module docstring
backend/domains/reader/routing.py	28	0	1	0	1	Shared runtime contract for Reader route modules.
backend/domains/reader/schemas.py	199	18	0	0	18	Public request and response contracts for the Reader domain.
backend/domains/reader/service.py	678	0	21	0	8	Durable Reader analysis lifecycle and retry orchestration.
backend/domains/reader/state.py	49	1	0	0	1	Shared state and limits for durable Reader analyses.
backend/domains/reader/storage.py	200	0	18	0	0	Durable Reader job, snapshot and checkpoint storage.
backend/domains/social/__init__.py	1	0	0	0	0	Social publishing domain boundaries.
backend/domains/social/configuration.py	81	0	5	0	4	Blocking configuration helpers for the social domain.
backend/domains/social/schemas.py	171	21	0	0	2	Pydantic contracts for the public social API.
backend/domains/social/vault_ports.py	84	0	7	3	0	Typed late-bound Vault ports for social publication persistence.
backend/domains/system/__init__.py	1	0	0	0	0	System-domain contracts and services.
backend/domains/system/schemas.py	132	15	0	0	15	Public request and response contracts for the System domain.
backend/domains/vault/__init__.py	5	0	0	0	0	Vault domain boundaries.
backend/domains/vault/annotations/__init__.py	1	0	0	0	0	Vault domain package.
backend/domains/vault/annotations/pdf_routes.py	190	6	5	0	1	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/api/__init__.py	1	0	0	0	0	HTTP adapters for the vault domain.
backend/domains/vault/api/configuration_routes.py	306	0	18	4	7	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/api/core_composition.py	149	5	0	0	1	Narrow late-bound collaborators for page creation and daily-note routing.
backend/domains/vault/api/core_routes.py	443	2	21	6	17	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/api/history.py	200	1	8	4	7	HTTP adapter for vault page history.
backend/domains/vault/api/pages_commands.py	208	4	2	0	5	HTTP registration for vault page mutation services.
backend/domains/vault/api/pages_duplicate.py	127	1	4	1	1	HTTP adapter for duplicating a vault page.
backend/domains/vault/api/pages_queries.py	616	3	20	12	15	Read-only HTTP adapters for vault pages and previews.
backend/domains/vault/api/trash.py	346	1	10	5	9	HTTP adapter and retention job for soft-deleted vault pages.
backend/domains/vault/assets/__init__.py	1	0	0	0	0	Vault asset uploads, icon storage, and image-serving HTTP adapters.
backend/domains/vault/assets/api.py	284	1	21	8	14	HTTP adapters and route registration for vault assets.
backend/domains/vault/assets/persistence.py	338	2	20	0	3	Persistence and cleanup of table property asset values.
backend/domains/vault/assets/quarantine.py	379	1	20	0	10	Crash-safe quarantine lifecycle for table-owned asset trees.
backend/domains/vault/assets/schemas.py	53	6	0	0	4	Frozen request schemas for vault asset routes.
backend/domains/vault/assets/service.py	310	1	9	4	10	Application services for vault assets and icons.
backend/domains/vault/assets/state.py	74	1	1	0	2	Single owners for mutable vault-asset state.
backend/domains/vault/assets/table_paths.py	412	2	24	0	12	Table-scoped asset path and directory lifecycle.
backend/domains/vault/citations/__init__.py	1	0	0	0	0	Vault citations and bibliographic references domain.
backend/domains/vault/citations/authors.py	161	0	5	0	0	Author normalization and Recursos-to-CSL mapping.
backend/domains/vault/citations/cover_metadata.py	97	1	4	0	4	Optional page covers from bibliographic providers and publisher metadata.
backend/domains/vault/citations/export_composition.py	60	1	0	0	1	Single typed view of the remaining citation-export facade seam.
backend/domains/vault/citations/export_contracts.py	39	4	0	0	0	Lossless records consumed by citation export's legacy composition seam.
backend/domains/vault/citations/export_routes.py	620	0	47	1	17	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/citations/exporting.py	230	2	8	2	5	Pandoc-backed Vault page export with resolved CSL citations.
backend/domains/vault/citations/formatting.py	529	10	9	0	5	CSL item construction and Pandoc formatting routes.
backend/domains/vault/citations/io_api.py	454	8	5	1	2	Bibliographic import/export and CSL catalog HTTP adapters.
backend/domains/vault/citations/keys.py	198	0	8	0	0	Deterministic Better BibTeX-style citation keys.
backend/domains/vault/citations/keys_api.py	57	2	1	0	1	Citation-key generation HTTP adapter.
backend/domains/vault/citations/lookup_routes.py	787	4	33	6	26	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/citations/metadata_lookup.py	226	2	9	6	3	Read-only metadata resolution for external reference identifiers.
backend/domains/vault/citations/normalizers/__init__.py	39	0	0	0	0	Typed normalizers from external citation payloads to Zotero items.
backend/domains/vault/citations/normalizers/arxiv.py	64	0	3	0	1	arXiv Atom payload normalization.
backend/domains/vault/citations/normalizers/crossref.py	112	0	5	0	1	Crossref payload normalization.
backend/domains/vault/citations/normalizers/html.py	178	0	9	0	2	HTML metadata normalization for citation capture.
backend/domains/vault/citations/normalizers/identifiers.py	25	0	2	0	0	Pure DOI and ISBN normalization for citation capture.
backend/domains/vault/citations/normalizers/names.py	50	0	2	0	2	Creator-name normalization shared by citation providers.
backend/domains/vault/citations/normalizers/open_library.py	82	0	5	0	1	Open Library payload normalization.
backend/domains/vault/citations/normalizers/pubmed.py	73	0	4	0	1	PubMed E-utilities payload normalization.
backend/domains/vault/citations/normalizers/types.py	11	0	0	0	0	Shared citation-normalizer value types.
backend/domains/vault/citations/pdf_fallback.py	77	1	2	0	2	Fallback reference metadata derived from a PDF and its filename.
backend/domains/vault/citations/reference_configuration.py	103	1	5	0	2	Canonical reference-table designation and legacy auto-adoption.
backend/domains/vault/citations/references_api.py	209	4	2	0	4	Designated references-table HTTP composition.
backend/domains/vault/citations/request_contracts.py	89	6	1	0	7	Compatibility-preserving request contracts for citation HTTP routes.
backend/domains/vault/citations/search.py	445	3	14	0	0	Citation-key indexing, search and resolution routes.
backend/domains/vault/citations/state.py	32	2	0	0	0	Single owner for the per-vault citation-key index.
backend/domains/vault/citations/title_regex.py	22	0	1	0	1	Typed regex adapter retaining native errors for historical raw titles.
backend/domains/vault/citations/web_capture.py	119	1	3	1	2	Read-only Zotero translation-server web capture orchestration.
backend/domains/vault/comments/__init__.py	15	0	0	0	0	Vault page and inline comment domain.
backend/domains/vault/comments/api.py	301	1	2	0	0	HTTP registration for page and inline comments.
backend/domains/vault/comments/composition.py	66	0	5	0	0	Checked comment composition invoked at the historical registration point.
backend/domains/vault/comments/repository.py	106	1	5	0	0	Filesystem repositories for page and inline comments.
backend/domains/vault/comments/schemas.py	69	8	0	0	0	Public request contracts for vault comments.
backend/domains/vault/comments/state.py	18	0	0	0	0	Single process-wide lock ownership for vault comments.
backend/domains/vault/daily/__init__.py	1	0	0	0	0	Daily-note domain services.
backend/domains/vault/daily/contracts.py	22	2	0	0	1	Public response contracts for Vault daily notes.
backend/domains/vault/daily/service.py	308	1	10	2	9	Provider-neutral daily-note discovery and atomic get-or-create workflows.
backend/domains/vault/drawings/__init__.py	1	0	0	0	0	Vault drawing persistence services.
backend/domains/vault/drawings/composition.py	73	1	1	0	2	Narrow, lazy compatibility collaborators for drawing and history routes.
backend/domains/vault/drawings/routes.py	186	4	7	4	10	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/drawings/service.py	246	4	9	4	9	Provider-neutral persistence for Tldraw and legacy Excalidraw documents.
backend/domains/vault/drupal/__init__.py	21	0	0	0	0	Typed Vault-to-Drupal synchronization domain.
backend/domains/vault/drupal/composition.py	380	0	27	8	25	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/drupal/core.py	117	0	5	0	5	Pure Drupal field and identity mappings for Vault rows.
backend/domains/vault/drupal/fields.py	215	2	4	4	1	Build Drupal attributes and relationships from Vault table mappings.
backend/domains/vault/drupal/languages.py	223	5	7	4	6	Drupal language and translatable-field discovery with owned caches.
backend/domains/vault/drupal/markdown.py	125	1	4	0	4	Gnosi Markdown preprocessing for Drupal rich-text fields.
backend/domains/vault/drupal/matching.py	137	1	2	1	1	Match existing Drupal nodes to unsynchronized Vault rows by title.
backend/domains/vault/drupal/media.py	335	4	8	1	6	Local file resolution and web-safe media preparation for Drupal.
backend/domains/vault/drupal/service.py	720	6	14	10	3	Orchestrate idempotent Vault-row synchronization to Drupal.
backend/domains/vault/facade_bridge.py	40	0	4	0	3	Compatibility export registry for the historical Vault API facade.
backend/domains/vault/files/__init__.py	1	0	0	0	0	Vault file serving, local links, uploads, and physical deletion.
backend/domains/vault/files/api.py	416	1	24	9	19	HTTP adapters and route registration for vault file workflows.
backend/domains/vault/files/contracts.py	57	4	0	0	4	Public JSON response contracts for Vault file insertion workflows.
backend/domains/vault/files/host_trash.py	39	0	1	0	1	Host adapter for recoverable physical-file deletion.
backend/domains/vault/files/local_service.py	386	4	10	4	13	Services for local-file tokens, portable links, and physical deletion.
backend/domains/vault/files/property_service.py	225	1	7	1	8	Property-file destination, upload, naming, and response services.
backend/domains/vault/files/request_contracts.py	42	4	0	0	4	Compatibility-preserving request contracts for Vault file routes.
backend/domains/vault/files/route_composition.py	436	0	13	2	11	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/files/serving.py	255	0	7	3	7	Contained and cloud-aware vault file streaming.
backend/domains/vault/files/state.py	111	2	0	0	2	Single owners for mutable vault-file state.
backend/domains/vault/files/thumbnails.py	194	1	5	1	6	QuickLook thumbnail resolution and streaming.
backend/domains/vault/history/__init__.py	5	0	0	0	0	Version history for vault pages.
backend/domains/vault/history/repository.py	133	1	0	0	1	Filesystem repository for forward-only vault page history.
backend/domains/vault/knowledge/__init__.py	1	0	0	0	0	Vault domain package.
backend/domains/vault/knowledge/aliases.py	28	0	1	0	0	Knowledge URLs share the historical handlers and their authorization guards.
backend/domains/vault/knowledge/config_routes.py	329	0	11	8	10	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/knowledge/contracts.py	171	16	0	0	5	Public contracts for selecting the Vault Brain table.
backend/domains/vault/knowledge/jobs_routes.py	705	29	18	13	30	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/knowledge/native_calls.py	24	1	1	0	2	Narrow native calls whose lookup order is part of the Knowledge contract.
backend/domains/vault/knowledge/schema_service.py	541	0	25	0	13	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/links/__init__.py	5	0	0	0	0	Vault wikilink, backlink and mention domain.
backend/domains/vault/links/api/__init__.py	5	0	0	0	0	HTTP adapters for the vault links domain.
backend/domains/vault/links/api/dependencies.py	49	2	0	0	0	Narrow composition ports used by link HTTP adapters.
backend/domains/vault/links/api/mentions.py	287	0	7	0	0	Unlinked-mention discovery and link action HTTP adapters.
backend/domains/vault/links/api/navigation.py	344	0	8	0	0	Reverse-link observability and navigation HTTP adapters.
backend/domains/vault/links/api/overview.py	51	0	1	0	0	Global and alias index HTTP registration.
backend/domains/vault/links/api/preview.py	169	1	4	1	1	Safe external-link preview HTTP adapter.
backend/domains/vault/links/document_cache.py	279	2	10	0	10	Persistent mtime-keyed body and parsed-document caches for Vault links.
backend/domains/vault/links/document_inventory.py	148	2	6	0	3	Cached inventory of Markdown pages and dashboards eligible for linking.
backend/domains/vault/links/index_service.py	565	2	16	0	0	Reverse-link index services and persistence.
backend/domains/vault/links/parsing.py	215	0	12	0	0	Pure parsing operations for wikilinks and unlinked mentions.
backend/domains/vault/links/relation_sync.py	188	1	4	0	4	Filesystem orchestration for bidirectional Vault relation synchronization.
backend/domains/vault/links/runtime.py	558	0	43	0	22	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/links/schemas.py	109	13	0	0	5	Public request contracts for vault links.
backend/domains/vault/links/state.py	93	4	0	0	1	Single process-wide owner for the reverse-link index.
backend/domains/vault/links/titles.py	26	0	2	0	0	Readable reference labels without changing stored page identities.
backend/domains/vault/media/__init__.py	1	0	0	0	0	Vault domain package.
backend/domains/vault/media/composition.py	93	1	2	0	3	Typed late-bound ports for the remaining historical Vault collaborators.
backend/domains/vault/media/contracts.py	79	6	0	0	1	Direct-call media payloads, separate from HTTP response validation.
backend/domains/vault/media/routes.py	473	2	30	14	14	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/media/schemas.py	126	13	0	0	3	Typed JSON contracts for the Vault media browser.
backend/domains/vault/media/unsplash_payload.py	39	0	2	0	1	Read the provider JSON shape without coercing returned field values.
backend/domains/vault/pages/__init__.py	5	0	0	0	0	Page catalog, persistence, preview and indexing boundaries.
backend/domains/vault/pages/cache.py	151	0	10	1	10	Concurrency and short-lived caches for vault page operations.
backend/domains/vault/pages/create_service.py	220	1	5	1	3	Application service for creating one vault page.
backend/domains/vault/pages/creation_callbacks.py	63	1	2	0	0	Explicit recovery allowlist; persisted names never select importable code.
backend/domains/vault/pages/creation_inputs.py	211	1	7	0	2	Typed replay data; never deserialize code or silently accept stale documents.
backend/domains/vault/pages/creation_recovery.py	260	1	10	1	3	Continue only recorded, unstarted work after a terminated page creation.
backend/domains/vault/pages/creation_requests.py	336	1	5	2	0	Local durable receipts for page creation, independent of cloud storage.
backend/domains/vault/pages/creation_steps.py	136	3	0	0	2	Durable checkpoints around side effects, including the uncertain crash gap.
backend/domains/vault/pages/disk_cache.py	40	0	3	0	1	Validate derived page-index data before it is published to shared state.
backend/domains/vault/pages/foundation.py	745	0	44	0	28	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/pages/foundation_values.py	32	0	2	0	2	Native page-document operations on values without a declared schema.
backend/domains/vault/pages/identifiers.py	32	0	2	0	2	Validation for page and history identifiers used in filesystem paths.
backend/domains/vault/pages/index_entries.py	352	2	13	0	9	Typed page-index entry construction.
backend/domains/vault/pages/index_service.py	736	1	32	0	11	Vault page-index discovery, refresh and snapshot services.
backend/domains/vault/pages/markdown_writer.py	201	1	7	0	2	Canonical Markdown writer with identity and sidecar loss guards.
backend/domains/vault/pages/metadata_mutations.py	488	2	18	3	5	Bulk metadata mutations for Vault pages and table templates.
backend/domains/vault/pages/patch_helpers.py	304	1	10	0	6	Filesystem, metadata and cache helpers for partial page updates.
backend/domains/vault/pages/patch_service.py	232	1	1	1	1	Application service for partial vault page updates.
backend/domains/vault/pages/preview_routes.py	521	0	15	5	6	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/pages/resolver.py	259	1	12	0	4	Resolve stable page identifiers to current Vault file paths.
backend/domains/vault/pages/runtime.py	585	3	31	0	14	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/pages/save_helpers.py	217	1	9	0	5	Filesystem and metadata helpers for complete page saves.
backend/domains/vault/pages/save_service.py	206	2	2	1	2	Application service for complete vault page saves.
backend/domains/vault/pages/state.py	58	2	0	0	2	Single in-process state owner for vault page operations.
backend/domains/vault/pages/sync_routes.py	259	7	13	4	5	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/pages/tags.py	141	4	7	1	5	Aggregate portable and semantic table tags across Vault pages.
backend/domains/vault/registry/__init__.py	6	0	0	0	0	Vault registry ownership and HTTP-independent operations.
backend/domains/vault/registry/api.py	88	1	3	2	1	HTTP-independent handlers for the vault registry endpoints.
backend/domains/vault/registry/contracts.py	60	6	0	0	5	Public contracts for opening local Vault resources through the host OS.
backend/domains/vault/registry/defaults.py	95	1	3	0	1	Guarded initialization of a new vault registry.
backend/domains/vault/registry/names.py	198	0	9	0	7	Canonical table and view naming rules stored in the registry.
backend/domains/vault/registry/records.py	23	1	2	0	3	Identity-preserving guards for open registry and extension records.
backend/domains/vault/registry/repository.py	306	3	0	0	1	Resilient persistence for the per-vault registry.
backend/domains/vault/registry/runtime.py	659	0	38	4	26	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/registry/state.py	28	1	0	0	1	Single process-wide owner for registry caches and synchronization.
backend/domains/vault/schemas/__init__.py	17	0	0	0	0	Typed request and response schemas for the vault domain.
backend/domains/vault/schemas/history.py	33	3	0	0	0	Public contracts for immutable vault page history.
backend/domains/vault/schemas/pages.py	258	23	0	0	11	Page API schemas owned by the vault domain.
backend/domains/vault/schemas/tags.py	23	3	0	0	0	Public response contracts for the aggregated vault tag index.
backend/domains/vault/schemas/trash.py	64	6	0	0	0	Public contracts for vault title resolution and recoverable trash.
backend/domains/vault/tables/__init__.py	1	0	0	0	0	Vault databases, tables, properties and option catalogs.
backend/domains/vault/tables/api.py	131	1	7	4	0	Database and table collection operations.
backend/domains/vault/tables/catalogs/__init__.py	73	0	0	0	0	Typed option catalogs, semantic roles and status seeds.
backend/domains/vault/tables/catalogs/core.py	132	0	10	0	5	Option normalization and property-level catalog access.
backend/domains/vault/tables/catalogs/global_status.py	131	0	9	0	1	Maintenance of explicitly shared status catalogs.
backend/domains/vault/tables/catalogs/roles.py	109	0	6	0	2	Semantic role discovery and assignment for table properties.
backend/domains/vault/tables/catalogs/seeds.py	156	0	8	0	3	Per-table option normalization and feature-aware status seeds.
backend/domains/vault/tables/catalogs/types.py	20	1	0	0	1	Shared option-catalog value types.
backend/domains/vault/tables/composition.py	39	1	0	0	1	Typed dependency composition for table rows, schemas and saved views.
backend/domains/vault/tables/contracts.py	135	13	0	0	8	Public HTTP contracts for vault registry collections.
backend/domains/vault/tables/folders.py	159	1	8	0	4	Physical Vault-folder lifecycle for tables.
backend/domains/vault/tables/formula_recalculation.py	213	2	10	0	2	Serialized recomputation of formulas that depend on other table rows.
backend/domains/vault/tables/legacy_composition.py	567	0	6	0	3	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/tables/lifecycle.py	557	4	17	3	0	Table creation, deletion and rename services.
backend/domains/vault/tables/options.py	607	2	23	8	5	Shared option catalogs and row-value rewrites.
backend/domains/vault/tables/routes.py	584	0	44	25	26	FastAPI boundary for databases, table rows, views and folder schemas.
backend/domains/vault/tables/rows.py	446	2	17	0	11	Table row discovery, context resolution and read enrichment.
backend/domains/vault/tables/rules/__init__.py	6	0	0	0	0	Typed database formulas, rollups, lookups and automations.
backend/domains/vault/tables/rules/automations.py	117	0	7	0	2	Property-change triggers and metadata automation actions.
backend/domains/vault/tables/rules/definitions.py	268	0	13	0	2	Extraction and dependency ordering of formulas and rollups.
backend/domains/vault/tables/rules/engine.py	510	1	4	0	2	Stateful facade over typed database-rule domain services.
backend/domains/vault/tables/rules/records.py	313	0	16	0	4	Registry, frontmatter and cross-record access for database rules.
backend/domains/vault/tables/rules/rollups.py	206	0	12	0	2	Related-row collection and rollup aggregation.
backend/domains/vault/tables/rules/types.py	54	3	0	0	1	Ports and shared value types for database rule evaluation.
backend/domains/vault/tables/schema.py	433	1	20	1	7	Table schema revisions and property mutation rules.
backend/domains/vault/tables/security.py	18	0	1	0	1	Narrow typed access to the workspace authorization composition boundary.
backend/domains/vault/tables/status_options.py	127	1	6	0	2	Best-effort persistence of status values created by action rules.
backend/domains/vault/translation/__init__.py	19	0	0	0	0	Typed Vault translation workflows and compatibility-neutral services.
backend/domains/vault/translation/adapters.py	77	0	3	0	3	Lazy optional-provider adapters for Vault translation workflows.
backend/domains/vault/translation/http_values.py	19	0	1	0	1	Text narrowing at JSON request boundaries, without coercing malformed input.
backend/domains/vault/translation/lifecycle.py	387	1	12	3	11	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/translation/lookup.py	131	1	3	2	2	Translation-child discovery with cloud-file recovery.
backend/domains/vault/translation/metadata_io.py	123	1	4	0	2	Minimal metadata writes used by translation lifecycle effects.
backend/domains/vault/translation/page_service.py	237	1	5	2	1	Typed translation workflow for standalone Vault pages.
backend/domains/vault/translation/request_contracts.py	93	9	1	0	2	Compatibility-preserving request contracts for Vault skill routes.
backend/domains/vault/translation/routes.py	707	12	12	11	18	Typed Vault domain extracted from the historical route facade.
backend/domains/vault/translation/row_service.py	591	2	12	5	1	Typed, idempotent translation workflow for table rows.
backend/domains/vault/translation/staleness.py	176	2	5	0	2	Propagation of translation staleness after source-page edits.
backend/domains/vault/translation/types.py	80	4	0	0	3	Shared strict contracts for Vault translation services.
backend/domains/vault/trash/__init__.py	5	0	0	0	0	Soft-delete persistence for vault pages.
backend/domains/vault/trash/purge.py	166	2	7	0	2	Permanent trash purge and best-effort trace cleanup.
backend/domains/vault/trash/repository.py	236	2	2	0	3	Filesystem repository for soft-deleted vault pages.
backend/domains/vault/views/__init__.py	1	0	0	0	0	Vault saved views and legacy folder schemas.
backend/domains/vault/views/api.py	275	1	11	7	0	Saved-view operations backed by the central registry.
backend/domains/vault/views/contracts.py	67	7	0	0	1	Public HTTP contracts for saved Vault views.
backend/domains/vault/views/filters.py	298	0	18	0	2	Saved-view filter evaluation with frontend-compatible coercion.
backend/domains/vault/views/row_resolution.py	194	0	12	0	3	Saved-view filtering, sorting and in-memory joins.
backend/domains/vault/views/runtime_types.py	41	0	0	0	0	Shared in-memory types for saved-view evaluation and snapshots.
backend/domains/vault/views/schema.py	78	2	3	2	1	Backward-compatible folder schema persistence.
backend/domains/vault/views/snapshot_markup.py	210	0	18	0	5	Markdown syntax for persisted saved-view definitions and snapshots.
backend/domains/vault/views/snapshot_materialization.py	239	0	11	0	2	Idempotent materialization of saved-view results into Markdown.
backend/domains/vault/views/snapshots.py	468	2	15	0	8	Materialized Markdown snapshots for saved table views.
backend/domains/vault/views/sorting.py	118	0	6	0	3	Frontend-compatible saved-view row sorting.
backend/domains/workspace/__init__.py	1	0	0	0	0	Workspace domain.
backend/domains/workspace/api/__init__.py	1	0	0	0	0	Workspace HTTP API.
backend/domains/workspace/api/routes.py	444	0	11	11	0	No module docstring
backend/domains/workspace/api/schemas.py	21	2	0	0	2	Public response contracts for workspace membership administration.

mcp

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/mcp/__init__.py	0	0	0	0	0	No module docstring
backend/mcp/client.py	310	3	1	1	2	Async JSON-RPC client and multi-server routing for stdio MCP connectors.
backend/mcp/http_client.py	119	1	2	0	3	MCP client over HTTP (streamable) with Bearer OAuth.

migrations

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/migrations/__init__.py	1	0	0	0	0	Versioned, recoverable schema migrations for Gnosi-owned databases.
backend/migrations/alembic/env.py	27	0	1	0	1	Shared online-only Alembic environment for independent schema branches.
backend/migrations/alembic/versions/actions_0001.py	34	0	2	0	0	Create the initial governed-action confirmation store.
backend/migrations/alembic/versions/actions_0002.py	39	0	2	0	0	Track the execution lease claim time for governed actions.
backend/migrations/alembic/versions/automations_0001.py	42	0	2	0	0	Create governed capability automation definitions and run history.
backend/migrations/alembic/versions/automations_0002.py	16	0	2	0	0	Preserve existing interval automations and add calendar schedules.
backend/migrations/alembic/versions/capability_audit_0001.py	29	0	2	0	0	Create the governed capability audit log.
backend/migrations/alembic/versions/evaluations_0001.py	37	0	2	0	0	Create the initial model-evaluation metadata store.
backend/migrations/alembic/versions/health_0001.py	27	0	2	0	0	Create the capability-health history store.
backend/migrations/alembic/versions/jobs_0001.py	27	0	2	0	0	Create the durable agent-job queue.
backend/migrations/alembic/versions/literature_0001.py	64	0	2	0	0	Create the durable academic literature and OAI index.
backend/migrations/alembic/versions/management_0001.py	106	0	2	0	0	Create the legacy Gnosi management schema.
backend/migrations/alembic/versions/management_0002.py	33	0	2	0	0	Add the first generation of access and authentication columns.
backend/migrations/alembic/versions/management_0003.py	34	0	2	0	0	Add explicit account provenance.
backend/migrations/alembic/versions/management_0004.py	23	0	2	0	0	Add stable vault slugs for Gnosi 2.0.6.
backend/migrations/alembic/versions/management_0005.py	22	0	2	0	0	Repair the missing vault-slug index on upgraded 2.0.6 databases.
backend/migrations/alembic/versions/notebooks_0001.py	102	0	2	0	0	Create the initial grounded-notebooks repository.
backend/migrations/alembic/versions/notebooks_0002.py	35	0	2	0	0	Persist URL validators and the last URL validation time.
backend/migrations/alembic/versions/notebooks_0003.py	61	0	2	0	0	Add notebook refresh progress, cancellation and retention state.
backend/migrations/alembic/versions/notebooks_0004.py	31	0	2	0	0	Persist the selected source set for notebook analyses.
backend/migrations/alembic/versions/notebooks_0005.py	26	0	2	0	0	Add notebook group visibility state.
backend/migrations/alembic/versions/personal_memory_0001.py	27	0	2	0	0	Create the explicit personal-memory store.
backend/migrations/alembic/versions/personal_memory_0002.py	28	0	2	0	0	Scope memories and persist private learning projects and session bindings.
backend/migrations/alembic/versions/quality_0001.py	43	0	2	0	0	Create privacy-safe agent quality telemetry stores.
backend/migrations/alembic/versions/replay_0001.py	22	0	2	0	0	Create the deterministic agent replay event store.
backend/migrations/alembic/versions/semantic_memory_0001.py	27	0	2	0	0	Create the scoped semantic-association store.
backend/migrations/alembic/versions/stream_journal_0001.py	22	0	2	0	0	Create the resumable agent-stream journal.
backend/migrations/alembic/versions/tool_registry_0001.py	25	0	2	0	0	Create the generated-tool approval registry.
backend/migrations/alembic/versions/turns_0001.py	20	0	2	0	0	Create the idempotent agent-turn claim store.
backend/migrations/alembic/versions/vault_0001.py	84	0	2	0	0	Create the legacy per-vault relational schema.
backend/migrations/alembic/versions/vault_0002.py	23	0	2	0	0	Persist full Reader article content.
backend/migrations/alembic/versions/vault_0003.py	29	0	2	0	0	Add stable managed keys for PDF annotations.
backend/migrations/alembic/versions/vault_0004.py	118	0	4	0	0	Scope persisted mail-tag associations by provider message identity.
backend/migrations/alembic/versions/vault_0005.py	28	0	2	0	0	Index Reader lists by date, read state and source without changing articles.
backend/migrations/alembic/versions/vault_0006.py	23	0	2	0	0	Cover Reader inventory aggregation without opening article bodies.
backend/migrations/coordinator.py	89	1	4	0	5	Explicit ownership map and startup coordinator for Gnosi SQLite stores.
backend/migrations/families.py	104	1	1	0	2	Stable identities for each Gnosi-owned Alembic revision line.
backend/migrations/runner.py	421	2	21	0	7	Guarded Alembic runner for Gnosi-owned SQLite databases.
backend/migrations/schema_audit.py	352	0	16	0	6	Inventory SQLite schemas without reading application row values.

models

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/models/__init__.py	15	0	0	0	0	No module docstring
backend/models/_datetime_utils.py	41	0	3	0	1	Helpers to ensure datetime fields always come out with timezone
backend/models/agent_skills.py	323	11	2	0	11	Typed contracts for agent skills and governed tools.
backend/models/calendar.py	22	1	0	0	1	No module docstring
backend/models/contact.py	135	8	0	0	0	No module docstring
backend/models/mail.py	85	4	0	0	0	No module docstring
backend/models/management.py	230	17	0	0	2	No module docstring
backend/models/notification.py	47	4	0	0	0	No module docstring
backend/models/pdf_annotation.py	69	1	0	0	0	Persistent annotations for PDFs opened in the Vault viewer.
backend/models/reader.py	134	11	0	0	3	No module docstring
backend/models/scheduled_post.py	34	3	0	0	3	Scheduled Posts Model
backend/models/scheduler.py	84	7	0	0	5	No module docstring

platform

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/platform/__init__.py	1	0	0	0	0	Provider-neutral adapters shared by Gnosi domains.
backend/platform/files/__init__.py	140	0	3	0	2	Abstraction layer for cloud-on-demand storage providers.
backend/platform/files/base.py	142	1	0	0	1	Base interface for cloud-on-demand storage providers.
backend/platform/files/coordinated.py	73	0	4	1	3	Bounded, read-only access to macOS File Provider files.
backend/platform/files/dropbox.py	12	1	0	0	1	Dropbox adapter for macOS File Provider based folders.
backend/platform/files/gdrive.py	54	1	0	0	1	GoogleDriveProvider: vault over Google Drive (Drive for Desktop, macOS).
backend/platform/files/icloud.py	49	1	0	0	1	iCloudDriveProvider: vault over iCloud Drive with the macOS File Provider.
backend/platform/files/local.py	28	1	0	0	1	LocalProvider: vault on pure local disk, without files-on-demand.
backend/platform/files/nextcloud.py	107	1	0	0	1	NextCloudProvider: vault over NextCloud Virtual Files (EXPERIMENTAL).
backend/platform/files/on_demand.py	469	1	3	0	4	Provider-neutral support for vaults with files on demand.
backend/platform/files/onedrive.py	90	1	0	0	1	OneDrive adapter for the provider-neutral files-on-demand runtime.
backend/platform/notifications.py	179	5	1	0	6	Provider-neutral notification channels for local Gnosi operations.
backend/platform/translation_server.py	33	0	1	0	1	HTTP transport adapter for the optional Zotero translation server.

scheduler

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/scheduler/__init__.py	1	0	0	0	0	No module docstring
backend/scheduler/bounded_executor.py	138	4	0	0	2	Bounded daemon worker pool dedicated to scheduled application work.
backend/scheduler/contracts.py	28	2	0	0	2	Typed scheduler configuration contracts.
backend/scheduler/literature_tasks.py	53	0	3	0	3	Vault-aware scheduler adapters for academic literature maintenance.
backend/scheduler/manager.py	800	1	0	0	1	Manage scheduled tasks using APScheduler.
backend/scheduler/notifications.py	7	0	0	0	0	Compatibility facade for the scheduler notification boundary.
backend/scheduler/startup_policy.py	23	0	2	0	2	Startup policy for automatic scheduler dispatch.
backend/scheduler/task_handlers.py	319	1	9	0	10	Large scheduler task handlers kept outside the lifecycle manager.

scripts

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/scripts/__init__.py	0	0	0	0	0	No module docstring
backend/scripts/refresh_model_catalog.py	69	0	2	0	0	Regenerate the vendored model catalog from models.dev.

security

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/security/__init__.py	4	0	0	0	0	No module docstring
backend/security/ai_credentials.py	406	0	13	0	5	No module docstring
backend/security/egress_policy.py	31	0	1	0	0	Conservative URL egress checks for generated/connector tools.
backend/security/keychain_manager.py	482	1	2	0	3	Keychain Manager - Secure credentials storage using macOS Keychain.
backend/security/plugin_trust_root.py	6	0	0	0	0	Public trust root shared by plugin runtime and official release tooling.
backend/security/secret_redaction.py	19	0	1	0	0	Redact common credentials before errors, spans or tool output are persisted.

services

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/services/__init__.py	0	0	0	0	0	No module docstring
backend/services/academic_connectors.py	172	0	1	0	1	Compatibility facade for typed academic connector adapters.
backend/services/action_rules.py	292	0	10	0	7	Declarative action rules per table (table.action_rules block).
backend/services/active_vault_middleware.py	321	1	12	3	8	Resolve canonical vault API routes and propagate the active vault context.
backend/services/agent_behavior.py	78	0	8	0	2	Readable, versioned behavior resources and data-only operation requests.
backend/services/agent_behavior_bindings.py	61	0	3	0	1	Resolve assigned personal procedures without changing canonical permissions.
backend/services/agent_cancellation.py	201	1	11	1	10	Cooperative cancellation for streamed agent turns.
backend/services/agent_capability_conformance.py	81	0	3	0	0	Versioned conformance reporting for governed skills and tools.
backend/services/agent_capability_contract.py	62	0	2	0	2	Versioned extension contract for governed agent capabilities.
backend/services/agent_capability_health.py	258	0	13	0	7	Persistent, bounded health checks for governed runtime capabilities.
backend/services/agent_catalog_models.py	30	2	0	0	2	Immutable catalog registration and resolved runtime capability values.
backend/services/agent_commands.py	50	0	3	0	0	Explicit per-turn agent selection; command text is never an authority grant.
backend/services/agent_context_budget.py	73	2	3	0	1	Offline token accounting with an explicit conservative fallback.
backend/services/agent_correction_contracts.py	116	1	4	0	1	Conservative local reference checks for fully quoted proofreading requests.
backend/services/agent_correction_output.py	74	1	1	0	0	Check explicit references locally; repair once with the same frozen executor.
backend/services/agent_diagnostics.py	46	0	1	0	0	Explicit model diagnostics using the common transport and usage ledger.
backend/services/agent_document_work.py	160	0	5	0	1	Shared, replayable read-only action loop for complete source synthesis.
backend/services/agent_evidence_security.py	58	0	2	0	1	Bounded semantic taint analysis for untrusted agent evidence.
backend/services/agent_execution.py	634	0	24	5	8	One principal-agent executor for application operations and graph streams.
backend/services/agent_execution_models.py	77	4	0	0	0	Transport-independent contracts for principal-agent operations.
backend/services/agent_execution_scope.py	137	0	8	1	3	Bind authenticated application scope before crossing threads or transports.
backend/services/agent_execution_store.py	346	0	21	0	9	Private, scope-bound execution records shared by every application entrypoint.
backend/services/agent_execution_trace.py	202	0	13	0	1	Scoped immutable execution events; source documents and checkpoints live elsewhere.
backend/services/agent_learning_capture.py	73	0	2	0	0	Capture only explicit first-person memory requests in the current user message.
backend/services/agent_learning_generation.py	129	1	5	0	0	Bounded, tool-free learning drafts and second-case trials on the configured model.
backend/services/agent_learning_models.py	124	15	0	0	0	Bounded, portable contracts for conversation learning.
backend/services/agent_learning_packages.py	38	0	2	0	0	Portable learning metadata and its bounded runtime instruction projection.
backend/services/agent_learning_projects.py	130	0	8	0	1	Private project context and conversation bindings for agent learning.
backend/services/agent_learning_review.py	50	0	3	0	0	Exact criterion identity and observable evidence for text-only trials.
backend/services/agent_model_decisions.py	190	1	6	0	3	Optional decision adapters. They advise; Gnosi owns the allowed routes.
backend/services/agent_model_evaluations.py	138	0	5	0	2	Explicit privacy-safe evaluations for configured agent models.
backend/services/agent_model_strategy.py	252	0	7	0	5	Profile-owned model routing for Gnosi agents.
backend/services/agent_observability.py	130	0	8	0	1	Privacy-preserving local spans for end-to-end agent diagnostics.
backend/services/agent_operation_catalog.py	95	0	4	0	1	Reusable methodology for application operations, published in the skill catalog.
backend/services/agent_output_repair.py	14	1	0	0	0	Operation-owned, immutable partial repairs inside the existing call budget.
backend/services/agent_personal_memory.py	231	0	12	0	0	Explicit, editable long-term memory for Gnosi agents.
backend/services/agent_quality_telemetry.py	541	0	18	0	3	Privacy-safe agent quality signals and reviewable evaluation candidates.
backend/services/agent_replay.py	94	0	5	0	1	Privacy-safe turn replay metadata for diagnosing agent behavior.
backend/services/agent_response_quality.py	162	0	5	0	3	Deterministic response-quality and evidence-conflict evaluation.
backend/services/agent_role_evaluations.py	270	4	4	0	0	Versioned synthetic role tests and an isolated three-strategy laboratory.
backend/services/agent_routing_policy.py	71	0	4	0	2	Hard constraints shared by internal and external model selectors.
backend/services/agent_run_middleware.py	35	1	1	0	0	Expose execution correlation without changing functional response bodies.
backend/services/agent_semantic_memory.py	171	0	8	0	6	Reviewable Vault-scoped vocabulary associations for agent retrieval.
backend/services/agent_skill_assignments.py	332	4	2	0	5	Revision-aware agent skill assignments and legacy migration.
backend/services/agent_skill_catalog.py	791	4	21	0	15	Effective catalogs and runtime resolution for agent skills and tools.
backend/services/agent_specialized_tools.py	149	0	8	0	4	Specialized inference engines registered and audited as principal tools.
backend/services/agent_stream_journal.py	112	0	7	0	0	Short-lived encrypted replay journal for accepted agent streams.
backend/services/agent_stream_protocol.py	21	0	0	0	0	Compatibility exports for the agent-domain stream protocol.
backend/services/agent_task_cases.py	141	1	2	0	0	Public, versioned fixtures for bot functions; no private documents or tools.
backend/services/agent_task_evaluation_models.py	100	7	0	0	0	Contracts for explicit, bounded and reusable bot-function checks.
backend/services/agent_task_evaluations.py	211	0	11	0	1	Reuse scoped checks before spending; save each result before the next call.
backend/services/agent_team_actions.py	78	0	6	0	2	Resolve action executors from callable tools and the activated skill grant.
backend/services/agent_team_context.py	96	0	5	0	1	Small routing evidence; executors still receive the original conversation.
backend/services/agent_team_continuation.py	100	0	4	0	1	Reuse a verified text specialist for narrowly unambiguous follow-up edits.
backend/services/agent_team_contracts.py	193	0	11	0	2	Local operation and output checks for the coordinator's untrusted plan.
backend/services/agent_team_evaluations.py	62	0	2	0	1	Metadata-only measurements for comparing the same tasks across team policies.
backend/services/agent_team_models.py	169	12	0	0	0	Explicit, additive contracts for governed agent teams.
backend/services/agent_team_output.py	63	2	0	0	1	Validate a delegated result before its run completes; repair without actions.
backend/services/agent_team_planning.py	90	0	1	1	0	Choose an existing route, a verified continuation, or a compact director plan.
backend/services/agent_team_planning_schema.py	39	0	2	0	1	Minimize planning metadata without removing executable constraints.
backend/services/agent_team_policy.py	126	0	6	0	2	Model-free eligibility and economic routing. Labels never grant capabilities.
backend/services/agent_team_resume.py	45	0	1	1	0	Resume a frozen team plan without regenerating or replaying completed work.
backend/services/agent_team_retention.py	35	0	2	0	0	Reviewable retention evidence; task instructions never become permanent defaults.
backend/services/agent_team_routing.py	102	0	3	0	2	Capability descriptions and intact conversation context for team routing.
backend/services/agent_team_runtime.py	561	0	20	4	2	Teams execute through the canonical executor, never through provider clients.
backend/services/agent_team_store.py	131	0	6	0	1	Private team artifacts, scoped through the owning execution record.
backend/services/agent_team_usage.py	77	0	3	0	1	Report coordinated usage once, without counting job rollups a second time.
backend/services/agent_title_continuation.py	133	0	4	0	3	Carry a verified title action across turns without inferring new write scope.
backend/services/agent_tool_identity.py	7	0	1	0	1	Technical tool identities, independent of translated display labels.
backend/services/agent_view_edit.py	82	0	2	2	1	Interpret view edits once, then let the existing team prepare a checked preview.
backend/services/agent_work_samples.py	200	0	8	0	0	Original, public work samples. No private data or production side effects.
backend/services/ai_usage_dashboard.py	191	1	9	0	0	Filtered projections and CSV for the provider-independent usage ledger.
backend/services/ai_usage_ledger.py	178	0	6	0	3	Durable metadata-only accounting shared by every model provider.
backend/services/ai_usage_openrouter.py	92	0	4	0	0	Reconcile billed costs through metadata-only GETs, outside model execution.
backend/services/ai_usage_transport.py	256	3	7	0	1	Observe raw provider responses before LangChain/tool output conversion.
backend/services/article_extractor.py	137	0	2	0	2	Full-text extraction for RSS articles whose feed only ships an excerpt.
backend/services/artificial_analysis.py	744	1	31	0	27	Artificial Analysis model-comparison feed.
backend/services/audio_summarizer.py	563	2	19	0	17	Generate the daily Reader podcast script and publish its audio atomically.
backend/services/auth_public_surface.py	213	1	5	2	5	The set of endpoints that must stay reachable without a session.
backend/services/auth_service.py	674	0	26	0	24	Authentication service — JWT cookies + bcrypt password hashing.
backend/services/automation_history.py	21	0	1	0	0	Scoped, paginated automation history for the activity centre.
backend/services/automation_schedule.py	56	1	1	0	1	Calendar schedules with explicit timezone and DST semantics.
backend/services/builtin_plugins.py	265	0	7	0	6	Registry and state rules for Gnosi's optional built-in capabilities.
backend/services/button_action_contracts.py	113	1	6	0	0	Contracts for generated table buttons, using the actual editable fields.
backend/services/button_field_execution.py	229	1	9	0	2	Resolve and persist a generated value against the current table schema.
backend/services/button_page_mutations.py	60	0	1	1	0	Apply validated button changes through the canonical page mutation workflow.
backend/services/button_relation_context.py	55	1	2	0	0	Frozen destination candidates for generated relations, checked before save.
backend/services/button_skill_execution.py	50	0	3	0	0	Execute a selected skill against a row with a typed, bounded write contract.
backend/services/calendar_event_aggregation.py	89	2	2	0	2	Bounded, provider-neutral loading of independent calendar accounts.
backend/services/capability_audit.py	239	0	8	0	3	Bounded metadata-only audit log for governed capability execution.
backend/services/capability_automations.py	479	1	17	3	4	Durable, budgeted automation definitions for governed agent skills.
backend/services/capability_jobs.py	236	1	16	0	5	Provider-neutral facade for durable Gnosi capability jobs.
backend/services/capture_contracts.py	71	1	3	0	0	Validated Cornell content, separate from source metadata and warnings.
backend/services/contacts_service.py	213	1	0	0	0	No module docstring
backend/services/contacts_sync_engine.py	751	4	2	0	3	No module docstring
backend/services/content_revision.py	55	0	3	0	2	Stable content revisions for confirmed filesystem operations.
backend/services/context_vars.py	36	0	2	0	1	No module docstring
backend/services/csl_styles.py	135	1	3	0	4	Management of CSL files on disk — listing and upload.
backend/services/csl_type_resolver.py	205	0	5	0	4	Resolves the Vault's "Item Type" field across its value spaces.
backend/services/data_dir_migration.py	598	2	30	0	12	Journaled and recoverable migration of Gnosi's per-device data directory.
backend/services/desktop_vault_discovery.py	80	0	1	0	1	Register existing libraries in the explicitly selected desktop container.
backend/services/drupal_sync_service.py	71	0	0	0	0	Compatibility facade for the canonical Drupal connector.
backend/services/durable_job_queue.py	249	0	19	0	8	Small SQLite-backed queue for restart-safe background capabilities.
backend/services/durable_job_worker.py	288	2	7	0	4	Process-local dispatcher for the durable capability queue.
backend/services/feature_ai_contributions.py	115	0	1	0	0	Catalogue coverage for newer first-party application features.
backend/services/feature_tool_availability.py	33	0	1	0	1	Recheck optional feature availability for each scoped catalogue snapshot.
backend/services/feed_ingester.py	28	0	1	0	0	Compatibility facade for feed ingestion.
backend/services/field_resolver.py	285	0	15	0	11	Field resolution by immutable ID or name (compatibility layer).
backend/services/files_provider/__init__.py	29	0	0	0	0	Compatibility facade for the provider-neutral file platform.
backend/services/files_provider/base.py	5	0	0	0	0	Compatibility facade for :mod:backend.platform.files.base.
backend/services/files_provider/dropbox.py	5	0	0	0	0	Compatibility facade for :mod:backend.platform.files.dropbox.
backend/services/files_provider/gdrive.py	5	0	0	0	0	Compatibility facade for :mod:backend.platform.files.gdrive.
backend/services/files_provider/icloud.py	5	0	0	0	0	Compatibility facade for :mod:backend.platform.files.icloud.
backend/services/files_provider/local.py	5	0	0	0	0	Compatibility facade for :mod:backend.platform.files.local.
backend/services/files_provider/nextcloud.py	5	0	0	0	0	Compatibility facade for :mod:backend.platform.files.nextcloud.
backend/services/files_provider/on_demand.py	15	0	0	0	0	Compatibility facade for :mod:backend.platform.files.on_demand.
backend/services/files_provider/onedrive.py	15	0	0	0	0	Compatibility facade for :mod:backend.platform.files.onedrive.
backend/services/frontmatter_fallback.py	66	0	1	0	1	Tolerant frontmatter parser for when yaml.safe_load fails.
backend/services/fx_rates.py	219	1	9	0	5	USD → user-currency conversion for the AI spend cap.
backend/services/generated_tool_contributions.py	165	0	6	0	2	Expose approved generated tools to skills without granting them globally.
backend/services/gnosi_ai_contributions.py	665	1	9	0	2	Governed core skills and tools for first-party Gnosi operations.
backend/services/google_calendar_service.py	113	0	6	0	0	Compatibility facade for the canonical Google Calendar adapter.
backend/services/google_contacts_service.py	350	0	7	0	7	No module docstring
backend/services/google_mail_service.py	374	0	13	0	11	No module docstring
backend/services/graph_service.py	44	0	0	0	0	Compatibility facade for the graph domain.
backend/services/handwriting.py	363	1	14	0	7	Handwriting recognition (ink → text) LOCAL with TrOCR.
backend/services/handwriting_download.py	251	3	9	0	2	Explicit, observable and cancellable TrOCR downloads, without loading weights.
backend/services/hybrid_calendar_service.py	566	1	22	0	8	Hybrid Calendar Service — queries Google Calendar and CalDAV directly without a vault.
backend/services/hybrid_mail_service.py	89	0	0	0	0	Compatibility facade for the canonical hybrid mail provider adapters.
backend/services/imap_idle_service.py	17	0	0	0	0	Compatibility facade for the canonical IMAP IDLE service.
backend/services/imap_mail_sync_service.py	35	0	0	0	0	Compatibility facade for the canonical IMAP synchronization service.
backend/services/import_dedup.py	140	0	5	0	3	Deduplication in POST /import-references.
backend/services/integration_manager.py	510	1	0	0	0	No module docstring
backend/services/json_contracts.py	38	0	1	0	0	JSON contract validation independent of optional format-checking packages.
backend/services/library_paths.py	29	0	2	0	2	SINGLE resolution of the attachments folder: ALWAYS <vault>/Library.
backend/services/literature_ai_contracts.py	58	0	2	0	1	Output contracts supplied to the governed literature executor.
backend/services/literature_ai_service.py	146	0	8	0	2	Explicit, audited AI assistance for literature workflows.
backend/services/literature_import_service.py	275	0	8	1	6	Atomic AcademicWork import into the designated Resources table.
backend/services/literature_models.py	437	0	21	0	10	Canonical academic-work normalization and deterministic deduplication.
backend/services/literature_review_service.py	787	0	24	10	3	Vault-native systematic-review records, blind decisions, and exports.
backend/services/literature_service.py	144	0	0	0	0	Compatibility facade for the canonical literature domain.
backend/services/llm_wiki.py	724	1	26	0	12	Incremental Zettelkasten ingestion for Gnosi's built-in LLM Wiki.
backend/services/llm_wiki_actions.py	255	2	5	1	6	Application actions shared by LLM Wiki HTTP routes and agent tools.
backend/services/llm_wiki_agent.py	219	1	8	0	9	Lifecycle and protection rules for the built-in LLM Wiki agent profile.
backend/services/llm_wiki_ai_contributions.py	255	0	4	0	2	Declarative agent skills and governed tools contributed by LLM Wiki.
backend/services/llm_wiki_assist.py	183	0	7	0	4	Accessible editing for the Brain Inbox (F6).
backend/services/llm_wiki_config.py	514	0	30	0	13	Per-vault configuration for the built-in LLM Wiki ("Brain") plugin.
backend/services/llm_wiki_extractors.py	751	1	35	0	10	Ordered, provenance-preserving source extraction for LLM Wiki.
backend/services/llm_wiki_generation.py	41	0	4	0	2	Run Brain model work with the selected profile and its editable skills.
backend/services/llm_wiki_indices.py	780	0	47	0	17	Deterministic managed indexes and logs for the LLM Wiki Brain table.
backend/services/llm_wiki_lint.py	320	0	13	0	9	LLM Wiki (Brain) lint — the "Lint" operation of Karpathy's pattern.
backend/services/llm_wiki_pdf_annotations.py	558	7	17	0	9	Persistent PDF highlights generated from grounded LLM Wiki citations.
backend/services/llm_wiki_reading_runtime.py	237	1	3	0	2	Freeze one governed profile, model and skill for an entire source job.
backend/services/llm_wiki_storage.py	521	0	31	0	13	Durable jobs, provenance manifests, and evidence snapshots for LLM Wiki.
backend/services/llm_wiki_suggestions.py	330	0	14	0	11	Read-only connection proposals for the Brain.
backend/services/lookup_normalizers.py	49	0	0	0	0	Compatibility facade for pure citation lookup normalizers.
backend/services/mail_ingester.py	69	0	1	0	0	Compatibility facade for newsletter ingestion.
backend/services/mail_inline_images.py	349	3	11	0	10	Converts vault images referenced in an email body into inline
backend/services/mail_metadata_manager.py	67	1	0	0	0	No module docstring
backend/services/marketplace_http.py	109	2	2	0	3	Bounded public HTTP access for marketplace indexes and packages.
backend/services/marketplace_submission.py	85	1	2	0	3	Optional broker client for moderated marketplace submissions.
backend/services/mcp_tool_contributions.py	103	0	3	0	1	Governed read-only MCP tools exposed for explicit skill composition.
backend/services/media_service.py	574	1	1	0	1	No module docstring
backend/services/meeting_contracts.py	85	0	4	0	0	Meeting excerpts with explicit source evidence and localized presentation.
backend/services/meeting_notes.py	337	0	13	0	3	Private durable meeting jobs: local transcription, validated excerpts, canonical page.
backend/services/meeting_reminders.py	320	0	15	0	4	AI-powered meeting reminder engine (agenda).
backend/services/microsoft_mail_service.py	503	0	21	0	9	Microsoft Graph API mail service.
backend/services/model_billing.py	140	2	4	0	3	Official provider plan evidence for comparison, never inference accounting.
backend/services/model_parameter_review.py	86	2	1	0	0	Per-model parameter source review. Supplied URLs are never fetched by the server.
backend/services/model_parameter_seed.py	201	2	0	0	0	Reviewed manufacturer parameter disclosures; billions (10^9).
backend/services/model_parameters.py	232	0	16	0	1	Bounded official-source parameter refresh; no guesses from model names.
backend/services/model_reasoning.py	122	0	7	0	2	Provider-declared reasoning choices and profile-scoped request settings.
backend/services/model_role_suitability.py	112	2	3	0	0	Independent role assessments with explicit provenance and untested abilities.
backend/services/notebook_service.py	210	0	0	0	0	Compatibility facade for the canonical notebooks domain.
backend/services/notion_attachments.py	198	0	8	0	6	Downloading Notion attachments (clone) → local Vault, with path rewriting.
backend/services/notion_clone.py	129	0	2	0	1	Compatibility facade for the typed exact-clone domain.
backend/services/notion_clone_verify.py	251	0	8	0	5	Health check of a Notion clone (Notion ↔ vault clone).
backend/services/notion_importer.py	62	0	0	0	0	Compatibility facade for the typed Notion importer domain.
backend/services/notion_mcp.py	224	0	12	0	5	Access to Notion's hosted MCP (for view recreation — Phase 2).
backend/services/notion_mcp_md.py	336	1	15	0	9	Converter from Notion MCP's rich Markdown → Gnosi Markdown (for the exact CLONE).
backend/services/notion_schema_config.py	96	0	3	0	3	Notion schema conversion ↔ SchemaConfigModal format (configurable import/clone).
backend/services/notion_view_recreator.py	63	0	0	0	0	Compatibility facade for the typed Notion view-recreation domain.
backend/services/oauth2_helpers.py	184	1	5	0	6	OAuth2 helpers shared by IMAP+XOAUTH2 and SMTP+XOAUTH2.
backend/services/option_catalogs.py	77	0	0	0	0	Compatibility facade for table option catalogs and semantic roles.
backend/services/optional_module_capabilities.py	13	0	1	0	1	Side-effect-free availability checks for optional Python modules.
backend/services/page_sidecar.py	221	0	11	0	11	Sidecar I/O for internal page metadata.
backend/services/path_resolver.py	93	1	0	0	1	No module docstring
backend/services/planning_engine.py	487	2	14	0	14	Deterministic, rebuildable scheduling for Gnosi project planning.
backend/services/planning_scheduler.py	197	2	8	0	5	Coalesced, ETag-safe project schedule refreshes triggered by page changes.
backend/services/plugin_access.py	73	0	3	1	3	FastAPI guards for optional per-vault capabilities.
backend/services/plugin_agent_profiles.py	164	0	6	0	1	Editable, plugin-owned profiles for standalone application operations.
backend/services/plugin_ai_contributions.py	500	0	16	0	6	Governed AI contributions from installed third-party plugins.
backend/services/plugin_catalog.py	251	0	10	0	7	Plugin catalog/gallery (phase 2.2 of plugin_system.md).
backend/services/plugin_dispatcher.py	341	0	13	0	7	Dispatcher: joins the event bus with the data sandbox (phase 3).
backend/services/plugin_events.py	109	0	3	0	3	Vault event bus for data plugins (phase 3).
backend/services/plugin_field_migration.py	22	0	2	0	1	Register required plugin fields when enabling an existing integration.
backend/services/plugin_fields.py	97	0	4	0	2	Stable, renameable field contracts owned by plugins.
backend/services/plugin_sandbox.py	96	0	4	0	3	Compatibility facade for the restricted third-party plugin sandbox.
backend/services/plugin_signing.py	167	0	8	0	6	Plugin signing and trust (phase 3 of plugin_system.md).
backend/services/plugin_system.py	256	0	14	0	12	Compatibility facade for the typed third-party plugin domain.
backend/services/principal_agent_migration.py	119	0	3	0	0	Idempotent, backed-up migration from feature-owned agents to the principal.
backend/services/project_planning.py	481	3	14	0	12	Vault-scoped storage and pure calculations for project planning resources.
backend/services/provider_health.py	87	1	6	0	5	Process-local provider circuit breaker with bounded cooldowns.
backend/services/public_evaluation_contract.py	113	0	7	0	0	Portable public-test contract, also reviewed in ismigar.github.io.
backend/services/reader_analysis.py	125	0	0	0	0	Compatibility facade for the canonical Reader analysis domain.
backend/services/reading_budget.py	116	1	8	0	1	Durable per-book reservations: a retry or resumed worker cannot reset spending.
backend/services/reading_estimate.py	125	0	2	0	0	Read-only source preflight; includes repeated context, output and repair allowance.
backend/services/reading_semantic_estimate.py	65	0	1	0	0	Offline phase estimates for the deterministic reader, including joint review.
backend/services/recursos_zotero_mapping.py	71	0	1	0	1	Bidirectional mapping between Recursos columns and Zotero fields.
backend/services/reference_config_migration.py	292	2	12	0	6	Explicit, recoverable migration of legacy references JSON into local data.
backend/services/reference_migration_io.py	157	2	9	0	10	Private, no-clobber filesystem primitives for reference configuration migration.
backend/services/reference_table_config.py	95	0	4	0	4	Storage for the Vault's "References Table" designation.
backend/services/references_io.py	634	0	24	0	15	Import/Export BibTeX and RIS ↔ Recursos fields (Gnosi).
backend/services/relation_links.py	185	0	10	0	5	Relation wikilinks in the frontmatter — shared helpers.
backend/services/relation_sync.py	144	0	5	0	4	Bidirectional relation sync — pure logic.
backend/services/rule_engine.py	84	1	6	0	1	Compatibility facade for typed database formulas, rollups and automations.
backend/services/shared_task_evaluations.py	205	2	7	0	1	Read a bounded public bank; export only new, reproducible public samples.
backend/services/social_clients.py	606	4	0	0	4	Social Network API Clients
backend/services/social_compose.py	145	0	6	0	3	AI layer for composing social media posts.
backend/services/social_store.py	205	0	6	4	6	Persistence of social posts in a Vault table.
backend/services/structured_output_diagnostics.py	41	0	2	0	1	Bound repair diagnostics without repeating documents or entire JSON schemas.
backend/services/table_system_dates.py	278	0	10	0	6	System creation and modification date fields for Vault tables.
backend/services/tool_runtime.py	35	0	0	0	0	Compatibility exports for the agent-domain tool runtime.
backend/services/transcription.py	151	5	6	0	2	Local audio transcription with faster-whisper (CTranslate2, WITHOUT torch).
backend/services/translation_helpers.py	358	0	15	0	14	Pure helpers for content translation (translate_row / translate_page skills).
backend/services/translation_index.py	104	0	6	0	4	Local translation index for translate-row idempotency.
backend/services/turn_idempotency.py	60	0	3	0	0	Durable turn claims preventing duplicate concurrent execution.
backend/services/user_skill_store.py	321	4	3	0	4	Portable per-vault storage for user-authored declarative skills.
backend/services/vault_file_index.py	606	4	16	0	20	vault_file_index.py — Vault file/folder name index.
backend/services/vault_mail_sync_service.py	223	1	0	0	0	No module docstring
backend/services/vault_routing.py	95	0	6	0	6	Canonical vault slug helpers shared by routing and management APIs.
backend/services/vault_templates.py	578	1	22	0	11	Verified Vault template catalogs, packages, exports, and installation.
backend/services/vault_warmup.py	166	0	4	1	4	Recover cloud placeholders for all .gnosi metadata in the background.
backend/services/view_snapshot.py	187	0	6	0	2	Compatibility facade for persisted saved-view snapshots and row evaluation.
backend/services/web_clipper.py	266	0	9	0	6	Web Clipper as a configurable plugin: destination table and field mapping.
backend/services/workspace_service.py	445	2	12	0	11	No module docstring
backend/services/zotero_schema.py	558	0	0	0	0	GENERATED — DO NOT EDIT. Source: pipeline/skills/zotero_schema/schema.json. Regenerate with pipeline/skills/zotero_schema/scripts/build_constants.py.
backend/services/zotero_to_recursos_mapper.py	163	0	3	0	3	Declarative Zotero item → Recursos columns dict mapper.

sync

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/sync/__init__.py	1	0	0	0	0	No module docstring

utils

Mòdul	Línies	Classes	Funcions	Asíncrones	Declaracions documentades	Indici de propòsit
backend/utils/cache.py	104	1	0	0	1	Thread-safe in-memory cache with TTL and bounded size.
backend/utils/errors.py	49	0	1	0	1	Safe error handling helpers for HTTP responses.
backend/utils/http_retry.py	54	0	1	0	1	Tolerant parsing of the HTTP Retry-After header (RFC 7231).
backend/utils/metadata_io.py	112	1	6	0	4	Bounded, read-only cloud hydration for Vault metadata.
backend/utils/open_values.py	99	1	14	0	14	Native operations on opaque extension values, without schema assertions.
backend/utils/request_profile.py	202	1	3	0	2	Bounded, opt-in Python stack metadata for one application-owned request.
backend/utils/safe_io.py	245	0	11	0	11	safe_io.py — Atomic and cloud-safe filesystem helpers.