[EricNGOntos]

Summary

• URL jobs now use an explicit file_name instead of the URL basename original.md.
• Publication builds sections from pre-split path parts, so titles that contain / or / stay one section.
• No API, worker, migration, or env-var change.

Verification

• make check (ruff + pyright): passed
• pytest apps/api/tests/unit/test_document_ingestion_filename.py: 4 passed
• pytest packages/shared-python/shared/tests/test_path_segments.py: 8 passed
• Did not re-ingest the original Hipo plan document on a live API

Deployment Notes

• No new environment variables
• No database migrations
• Existing published snapshots stay as-is; Hipo already compensates for old original.md / ∕ snapshots. New ingest after this API ships writes the real file name.

Checklist

• Tests were added or updated when behavior changed
• Public docs, examples, or OpenAPI contracts were updated when needed
• Database migrations are idempotent and safe to deploy
• Logs, errors, and validation paths avoid leaking secrets or user data
• The pull request description explains any breaking or user-visible change

Test plan

• Create a URL job with source_url ending in original.md and file_name set to the real document name; confirm published source_file_name and root chunk path use the real name
• Ingest a heading that contains user/assistant; confirm one section, not two
• Ingest a heading that contains MD / TXT; confirm one section

Made with Cursor