Files
Alex 574f96341e 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.
2026-09-07 10:20:43 +01:00

39 lines
1.1 KiB
Python

"""Shared chunk-label derivation for retrievers."""
from __future__ import annotations
import os
from typing import Any, Dict
def labels_from_metadata(
metadata: Dict[str, Any], text: str, fallback_source: str
) -> Dict[str, str]:
"""Derive ``title``/``source``/``filename`` from a chunk's metadata.
Falls back to the chunk text for the title and to ``fallback_source`` (the
vectorstore/source id) when metadata carries no source. Used by both
ClassicRAG and GraphRAG so citation labels stay identical across retrievers.
"""
metadata = metadata or {}
title = metadata.get("title", metadata.get("post_title", text))
if not isinstance(title, str):
title = str(title)
title = title.split("/")[-1]
filename = (
metadata.get("filename")
or metadata.get("file_name")
or metadata.get("source")
)
if isinstance(filename, str):
filename = os.path.basename(filename) or filename
else:
filename = title
if not filename:
filename = title
source = metadata.get("source") or fallback_source
return {"title": title, "source": source, "filename": filename}