Feature/source package rf

[embtom]

• deb_source: cache parsed changelog; invalidate after git checkout in reset_source_tree
• debuild: pass -sa flag to always include orig tarball in .changes for source/full builds
• apt: improve binary and source package existence detection with per-file [EXISTS]/[MISSING] logging
• AptManager: reorganise class into logical sections (repository, installation, existence checks, private helpers)
• log: add error logging for failed package upload
• Source package upload no longer fails when .orig.tar.* is absent from .changes on non-first revisions

[github-actions]

☂️ Code Coverage

current status: ✅

Overall Coverage

Statements	Covered	Coverage	Threshold	Status
1697	1371	81%	0%	🟢

New Files

No new covered files...

Modified Files

No covered modified files...

updated for commit: 2d49bea by action🐍

[Copilot]

Pull request overview

This PR enhances the packtly-builder pipeline around source package handling (notably pristine-tar workflows), while also improving developer/container ergonomics (fixed-path venv, optional custom CA certs) and updating documentation to match the expanded workflow.

Changes:

• Added/updated Debian source build logic (GitPython-backed repo detection, pristine-tar branch handling) and introduced a focused test suite for this behavior.
• Standardized Poetry/venv behavior in containers and dev tooling (fixed /opt/venv, Poetry configured not to create per-project venvs).
• Improved operational/dev UX: optional corporate CA injection in the base image, VS Code task tweaks, and a significantly expanded README.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
Readme.md	Expanded usage docs, pipeline explanation, and CLI options/modes.
packtly-builder/tooling/pyproject.toml	Adds GitPython dependency used by updated source build logic.
packtly-builder/tooling/poetry.toml	Forces Poetry to install into an existing venv (no auto-created venv).
packtly-builder/tooling/packtly_builder_tooling/tests/test_deb_source.py	New tests covering quilt/native logic and git/pristine-tar handling.
packtly-builder/tooling/packtly_builder_tooling/parts/deb_source.py	Refactors git operations to GitPython and adds repo caching/helpers.
packtly-builder/tooling/packtly_builder_tooling/parts/aptly.py	Minor formatting-only change to connection error raising.
packtly-builder/tooling/packtly_builder_tooling/parts/apt.py	Minor formatting-only change in DSC parsing condition.
packtly-builder/tooling/justfile	Adjusts prepare flow and removes local Poetry venv config step.
packtly-builder/containers/Containerfile	Adds python venv support, fixed-path venv, and optional custom CA cert installation.
packtly-builder/containers/conf/ca-certificates/.gitkeep	Documents how to add custom CA certs for image builds.
packtly-builder/containers/conf/ca-certificates/.gitignore	Prevents committing actual .crt files.
.vscode/tasks.json	Switches to a shell-based just task with explicit working directory.
.vscode/settings.json	Updates Python interpreter path to the new fixed venv location.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.