refactor: rename the application package to docsgpt

The backend import package is now docsgpt, the name it will carry on PyPI;
application was far too generic to install into anyone's site-packages.
git mv plus a mechanical rewrite of every import, dotted string and path
reference: 734 Python files, the compose files, Dockerfile, workflows, docs,
setup scripts, devcontainer, k8s manifests, vscode config, pytest and coverage
config, .gitignore. Behaviour is unchanged.

Kept for one release:
- A top-level application package whose meta-path finder resolves
  application.x.y to the already-imported docsgpt.x.y object, so old imports
  and entry points (celery -A application.app.celery,
  uvicorn application.asgi:asgi_app) keep working with a FutureWarning.
- Celery registers every application.* task name as an alias of its
  docsgpt.* task on start-up, so messages queued by the previous release still
  run. The redbeat key prefix moves to redbeat:docsgpt:v2: so schedule entries
  the previous release wrote are left unread instead of firing twice.

The backend image builds from the repository root (docker build -f
docsgpt/Dockerfile .) so it can ship the alias package; a root .dockerignore
allow-lists docsgpt/ and application/ and keeps caches, local data, .env
files, the sample index files and the Dockerfile out. Compose and the image
workflows point at the new context.

tests/api/answer/services/compression/test_compression_reuse.py

@@ -14,16 +14,16 @@ from unittest.mock import MagicMock, patch
 
 import pytest
 
-from application.api.answer.services.compression import CompressionService
-from application.api.answer.services.compression.orchestrator import (
+from docsgpt.api.answer.services.compression import CompressionService
+from docsgpt.api.answer.services.compression.orchestrator import (
     CompressionOrchestrator,
 )
-from application.api.answer.services.compression.threshold_checker import (
+from docsgpt.api.answer.services.compression.threshold_checker import (
     CompressionThresholdChecker,
 )
-from application.api.answer.services.compression.token_counter import TokenCounter
-from application.api.answer.services.compression.types import CompressionResult
-from application.api.answer.services.conversation_service import (
+from docsgpt.api.answer.services.compression.token_counter import TokenCounter
+from docsgpt.api.answer.services.compression.types import CompressionResult
+from docsgpt.api.answer.services.conversation_service import (
     COMPRESSION_SUMMARY_PROMPT,
 )
 
@@ -106,16 +106,16 @@ class TestTurnStartReuse:
         assert result.last_compression_at is None
 
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_provider_from_model_id",
+        "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id",
         return_value="openai",
     )
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_api_key_for_provider",
+        "docsgpt.api.answer.services.compression.orchestrator.get_api_key_for_provider",
         return_value="sk",
     )
-    @patch("application.api.answer.services.compression.orchestrator.LLMCreator")
-    @patch("application.api.answer.services.compression.orchestrator.CompressionService")
-    @patch("application.api.answer.services.compression.orchestrator.settings")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.LLMCreator")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.CompressionService")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.settings")
     def test_over_threshold_compresses_only_the_tail(
         self,
         mock_settings,
@@ -172,7 +172,7 @@ class TestEffectiveTokenCount:
         )
 
     @patch(
-        "application.api.answer.services.compression.threshold_checker.get_token_limit",
+        "docsgpt.api.answer.services.compression.threshold_checker.get_token_limit",
         return_value=1000,
     )
     def test_should_compress_uses_effective_count(self, _limit):
@@ -252,7 +252,7 @@ class TestSummaryRowMarker:
     who types the label text as a question keeps that turn."""
 
     def test_marked_row_is_a_summary_row(self):
-        from application.api.answer.services.compression.types import (
+        from docsgpt.api.answer.services.compression.types import (
             COMPRESSION_SUMMARY_MARKER,
             is_compression_summary_row,
         )
@@ -261,7 +261,7 @@ class TestSummaryRowMarker:
         assert is_compression_summary_row(row) is True
 
     def test_legacy_row_without_metadata_is_a_summary_row(self):
-        from application.api.answer.services.compression.types import is_compression_summary_row
+        from docsgpt.api.answer.services.compression.types import is_compression_summary_row
 
         assert is_compression_summary_row({"prompt": COMPRESSION_SUMMARY_PROMPT, "response": "S"}) is True
         assert is_compression_summary_row(
@@ -269,7 +269,7 @@ class TestSummaryRowMarker:
         ) is True
 
     def test_user_turn_with_the_label_text_is_kept(self):
-        from application.api.answer.services.compression.types import is_compression_summary_row
+        from docsgpt.api.answer.services.compression.types import is_compression_summary_row
 
         real_turn = {
             "prompt": COMPRESSION_SUMMARY_PROMPT,
@@ -309,16 +309,16 @@ class TestIncrementalTailExcludesSummaryRows:
             svc.compress_conversation(conv, compress_up_to_index=2, start_index=2)
 
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_provider_from_model_id",
+        "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id",
         return_value="openai",
     )
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_api_key_for_provider",
+        "docsgpt.api.answer.services.compression.orchestrator.get_api_key_for_provider",
         return_value="sk",
     )
-    @patch("application.api.answer.services.compression.orchestrator.LLMCreator")
-    @patch("application.api.answer.services.compression.orchestrator.CompressionService")
-    @patch("application.api.answer.services.compression.orchestrator.settings")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.LLMCreator")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.CompressionService")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.settings")
     def test_orchestrator_reuses_summary_when_only_summary_rows_follow_the_point(
         self, mock_settings, MockCompressionService, MockLLMCreator, _key, _provider,
         orchestrator, conversation_service, threshold_checker,
@@ -355,16 +355,16 @@ class TestAbsolutePersistIndex:
         assert metadata.query_index == 19
 
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_provider_from_model_id",
+        "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id",
         return_value="openai",
     )
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_api_key_for_provider",
+        "docsgpt.api.answer.services.compression.orchestrator.get_api_key_for_provider",
         return_value="sk",
     )
-    @patch("application.api.answer.services.compression.orchestrator.LLMCreator")
-    @patch("application.api.answer.services.compression.orchestrator.CompressionService")
-    @patch("application.api.answer.services.compression.orchestrator.settings")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.LLMCreator")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.CompressionService")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.settings")
     def test_mid_execution_builds_on_the_carried_summary_and_persists_the_absolute_index(
         self, mock_settings, MockCompressionService, MockLLMCreator, _key, _provider,
         orchestrator, conversation_service,
@@ -461,16 +461,16 @@ class TestUnusableSavedPoints:
         assert [q["prompt"] for q in recent] == ["q2", "q3", "q4"]
 
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_provider_from_model_id",
+        "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id",
         return_value="openai",
     )
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_api_key_for_provider",
+        "docsgpt.api.answer.services.compression.orchestrator.get_api_key_for_provider",
         return_value="sk",
     )
-    @patch("application.api.answer.services.compression.orchestrator.LLMCreator")
-    @patch("application.api.answer.services.compression.orchestrator.CompressionService")
-    @patch("application.api.answer.services.compression.orchestrator.settings")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.LLMCreator")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.CompressionService")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.settings")
     def test_recompression_starts_after_the_latest_usable_point(
         self, mock_settings, MockCompressionService, MockLLMCreator, _key, _provider,
         orchestrator, conversation_service, threshold_checker,

tests/api/answer/services/compression/test_message_builder.py

@@ -1,9 +1,9 @@
-"""Tests for application/api/answer/services/compression/message_builder.py"""
+"""Tests for docsgpt/api/answer/services/compression/message_builder.py"""
 
 
 import pytest
 
-from application.api.answer.services.compression.message_builder import MessageBuilder
+from docsgpt.api.answer.services.compression.message_builder import MessageBuilder
 
 
 @pytest.mark.unit

tests/api/answer/services/compression/test_orchestrator.py

@@ -1,13 +1,13 @@
-"""Tests for application/api/answer/services/compression/orchestrator.py"""
+"""Tests for docsgpt/api/answer/services/compression/orchestrator.py"""
 
 from unittest.mock import MagicMock, patch
 
 import pytest
 
-from application.api.answer.services.compression.orchestrator import (
+from docsgpt.api.answer.services.compression.orchestrator import (
     CompressionOrchestrator,
 )
-from application.api.answer.services.compression.types import (
+from docsgpt.api.answer.services.compression.types import (
     CompressionMetadata,
     CompressionResult,
 )
@@ -172,14 +172,14 @@ class TestCompressIfNeeded:
 @pytest.mark.unit
 class TestPerformCompression:
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_provider_from_model_id"
+        "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id"
     )
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_api_key_for_provider"
+        "docsgpt.api.answer.services.compression.orchestrator.get_api_key_for_provider"
     )
-    @patch("application.api.answer.services.compression.orchestrator.LLMCreator")
-    @patch("application.api.answer.services.compression.orchestrator.CompressionService")
-    @patch("application.api.answer.services.compression.orchestrator.settings")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.LLMCreator")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.CompressionService")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.settings")
     def test_successful_compression(
         self,
         mock_settings,
@@ -228,13 +228,13 @@ class TestPerformCompression:
         mock_svc_instance.compress_and_save.assert_called_once()
 
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_provider_from_model_id"
+        "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id"
     )
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_api_key_for_provider"
+        "docsgpt.api.answer.services.compression.orchestrator.get_api_key_for_provider"
     )
-    @patch("application.api.answer.services.compression.orchestrator.LLMCreator")
-    @patch("application.api.answer.services.compression.orchestrator.settings")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.LLMCreator")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.settings")
     def test_uses_compression_model_override(
         self,
         mock_settings,
@@ -253,7 +253,7 @@ class TestPerformCompression:
         conversation = {"queries": [{"prompt": "q", "response": "r"}], "agent_id": "a"}
 
         with patch(
-            "application.api.answer.services.compression.orchestrator.CompressionService"
+            "docsgpt.api.answer.services.compression.orchestrator.CompressionService"
         ) as MockCS:
             mock_svc = MagicMock()
             mock_svc.compress_and_save.return_value = MagicMock(
@@ -280,14 +280,14 @@ class TestPerformCompression:
             )
 
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_provider_from_model_id"
+        "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id"
     )
     @patch(
-        "application.api.answer.services.compression.orchestrator.get_api_key_for_provider"
+        "docsgpt.api.answer.services.compression.orchestrator.get_api_key_for_provider"
     )
-    @patch("application.api.answer.services.compression.orchestrator.LLMCreator")
-    @patch("application.api.answer.services.compression.orchestrator.CompressionService")
-    @patch("application.api.answer.services.compression.orchestrator.settings")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.LLMCreator")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.CompressionService")
+    @patch("docsgpt.api.answer.services.compression.orchestrator.settings")
     def test_no_queries_returns_no_compression(
         self,
         mock_settings,
@@ -327,9 +327,9 @@ class TestPerformCompression:
         }
 
         with patch(
-            "application.api.answer.services.compression.orchestrator.settings"
+            "docsgpt.api.answer.services.compression.orchestrator.settings"
         ) as mock_settings, patch(
-            "application.api.answer.services.compression.orchestrator.get_provider_from_model_id",
+            "docsgpt.api.answer.services.compression.orchestrator.get_provider_from_model_id",
             side_effect=RuntimeError("provider error"),
         ):
             mock_settings.COMPRESSION_MODEL_OVERRIDE = None

tests/api/answer/services/compression/test_service.py

@@ -1,11 +1,11 @@
-"""Tests for application/api/answer/services/compression/service.py"""
+"""Tests for docsgpt/api/answer/services/compression/service.py"""
 
 from unittest.mock import MagicMock, patch
 
 import pytest
 
-from application.api.answer.services.compression.service import CompressionService
-from application.api.answer.services.compression.types import CompressionMetadata
+from docsgpt.api.answer.services.compression.service import CompressionService
+from docsgpt.api.answer.services.compression.types import CompressionMetadata
 
 
 @pytest.fixture
@@ -48,11 +48,11 @@ def sample_conversation():
 
 @pytest.mark.unit
 class TestCompressionServiceInit:
-    @patch("application.api.answer.services.compression.service.settings")
+    @patch("docsgpt.api.answer.services.compression.service.settings")
     def test_default_prompt_builder(self, mock_settings, mock_llm):
         mock_settings.COMPRESSION_PROMPT_VERSION = "v1.0"
         with patch(
-            "application.api.answer.services.compression.service.CompressionPromptBuilder"
+            "docsgpt.api.answer.services.compression.service.CompressionPromptBuilder"
         ):
             svc = CompressionService(llm=mock_llm, model_id="gpt-4")
             assert svc.llm is mock_llm
@@ -81,7 +81,7 @@ class TestCompressConversation:
         )
 
         with patch(
-            "application.api.answer.services.compression.service.TokenCounter"
+            "docsgpt.api.answer.services.compression.service.TokenCounter"
         ) as MockTC:
             MockTC.count_query_tokens.return_value = 1000
             MockTC.count_message_tokens.return_value = 100
@@ -144,7 +144,7 @@ class TestCompressConversation:
         )
 
         with patch(
-            "application.api.answer.services.compression.service.TokenCounter"
+            "docsgpt.api.answer.services.compression.service.TokenCounter"
         ) as MockTC:
             MockTC.count_query_tokens.return_value = 500
             MockTC.count_message_tokens.return_value = 50
@@ -170,7 +170,7 @@ class TestCompressConversation:
         )
 
         with patch(
-            "application.api.answer.services.compression.service.TokenCounter"
+            "docsgpt.api.answer.services.compression.service.TokenCounter"
         ) as MockTC:
             MockTC.count_query_tokens.return_value = 1000
             MockTC.count_message_tokens.return_value = 0
@@ -195,7 +195,7 @@ class TestCompressConversation:
         )
 
         with patch(
-            "application.api.answer.services.compression.service.TokenCounter"
+            "docsgpt.api.answer.services.compression.service.TokenCounter"
         ) as MockTC:
             MockTC.count_query_tokens.return_value = 100
             with pytest.raises(RuntimeError, match="LLM error"):
@@ -222,7 +222,7 @@ class TestCompressAndSave:
         )
 
         with patch(
-            "application.api.answer.services.compression.service.TokenCounter"
+            "docsgpt.api.answer.services.compression.service.TokenCounter"
         ) as MockTC:
             MockTC.count_query_tokens.return_value = 500
             MockTC.count_message_tokens.return_value = 50
@@ -487,7 +487,7 @@ class TestBoundRecentQueries:
         self, mock_llm, monkeypatch
     ):
         monkeypatch.setattr(
-            "application.api.answer.services.compression.service.settings.COMPRESSION_RECENT_FIELD_MAX_TOKENS",
+            "docsgpt.api.answer.services.compression.service.settings.COMPRESSION_RECENT_FIELD_MAX_TOKENS",
             50,
             raising=False,
         )
@@ -507,7 +507,7 @@ class TestBoundRecentQueries:
 
     def test_oversized_tool_result_is_trimmed(self, mock_llm, monkeypatch):
         monkeypatch.setattr(
-            "application.api.answer.services.compression.service.settings.COMPRESSION_RECENT_FIELD_MAX_TOKENS",
+            "docsgpt.api.answer.services.compression.service.settings.COMPRESSION_RECENT_FIELD_MAX_TOKENS",
             50,
             raising=False,
         )
@@ -536,7 +536,7 @@ class TestBoundRecentQueries:
 
     def test_zero_cap_disables_bounding(self, mock_llm, monkeypatch):
         monkeypatch.setattr(
-            "application.api.answer.services.compression.service.settings.COMPRESSION_RECENT_FIELD_MAX_TOKENS",
+            "docsgpt.api.answer.services.compression.service.settings.COMPRESSION_RECENT_FIELD_MAX_TOKENS",
             0,
             raising=False,
         )

tests/api/answer/services/compression/test_threshold_checker.py

@@ -7,18 +7,18 @@ import pytest
 class TestCompressionThresholdChecker:
 
     def _make_checker(self, pct=0.7):
-        from application.api.answer.services.compression.threshold_checker import (
+        from docsgpt.api.answer.services.compression.threshold_checker import (
             CompressionThresholdChecker,
         )
 
         return CompressionThresholdChecker(threshold_percentage=pct)
 
     @patch(
-        "application.api.answer.services.compression.threshold_checker.get_token_limit",
+        "docsgpt.api.answer.services.compression.threshold_checker.get_token_limit",
         return_value=8000,
     )
     @patch(
-        "application.api.answer.services.compression.threshold_checker.TokenCounter.count_message_tokens",
+        "docsgpt.api.answer.services.compression.threshold_checker.TokenCounter.count_message_tokens",
         return_value=6000,
     )
     def test_check_message_tokens_above_threshold(self, mock_count, mock_limit):
@@ -26,11 +26,11 @@ class TestCompressionThresholdChecker:
         assert checker.check_message_tokens([{"role": "user"}], "gpt-4") is True
 
     @patch(
-        "application.api.answer.services.compression.threshold_checker.get_token_limit",
+        "docsgpt.api.answer.services.compression.threshold_checker.get_token_limit",
         return_value=8000,
     )
     @patch(
-        "application.api.answer.services.compression.threshold_checker.TokenCounter.count_message_tokens",
+        "docsgpt.api.answer.services.compression.threshold_checker.TokenCounter.count_message_tokens",
         return_value=1000,
     )
     def test_check_message_tokens_below_threshold(self, mock_count, mock_limit):
@@ -38,7 +38,7 @@ class TestCompressionThresholdChecker:
         assert checker.check_message_tokens([{"role": "user"}], "gpt-4") is False
 
     @patch(
-        "application.api.answer.services.compression.threshold_checker.TokenCounter.count_message_tokens",
+        "docsgpt.api.answer.services.compression.threshold_checker.TokenCounter.count_message_tokens",
         side_effect=Exception("Token error"),
     )
     def test_check_message_tokens_exception_returns_false(self, mock_count):

tests/api/answer/services/compression/test_types.py

@@ -1,10 +1,10 @@
-"""Tests for application/api/answer/services/compression/types.py"""
+"""Tests for docsgpt/api/answer/services/compression/types.py"""
 
 from datetime import datetime, timezone
 
 import pytest
 
-from application.api.answer.services.compression.types import (
+from docsgpt.api.answer.services.compression.types import (
     CompressionMetadata,
     CompressionResult,
 )