Skip to content

spike(flatpak): add MVP manifest scaffold#48

Merged
TimInTech merged 1 commit into
mainfrom
spike/flatpak-manifest-mvp
Jul 6, 2026
Merged

spike(flatpak): add MVP manifest scaffold#48
TimInTech merged 1 commit into
mainfrom
spike/flatpak-manifest-mvp

Conversation

@TimInTech

Copy link
Copy Markdown
Owner

Ziel

Dieser PR ergänzt einen experimentellen Flatpak-MVP-Scaffold für Blitztext Linux im bestehenden Repository. Ziel ist nur ein lokaler Packaging-Spike, kein Release- oder Flathub-Setup.

Scope

Enthalten:

  • packaging/flatpak/io.github.TimInTech.BlitztextLinux.yaml
  • packaging/flatpak/blitztext-linux.sh
  • packaging/flatpak/requirements-flatpak.txt
  • packaging/flatpak/README.md

Der MVP fokussiert:

  • GUI-Start innerhalb einer Flatpak-Sandbox
  • Qt-Clipboard-Fallback
  • PulseAudio-Aufnahme
  • OpenAI-Cloud-Aufrufe

Bewusst nicht enthalten:

  • globale Hotkeys über evdev/input
  • ydotool-Auto-Paste
  • lokale Whisper/Torch-Transkription im Flatpak-Build
  • Desktop-Datei, AppStream, Icon oder Flathub-Einreichung
  • Release, Tag oder Version-Bump

Grenzen

Das Manifest ist für lokale MVP-Tests gedacht und noch nicht Flathub-konform. Insbesondere sind pip-/Netzwerkabhängigkeiten und vendored Sources noch nicht final gelöst.

Ein vollständiger Build wurde bewusst nicht ausgeführt, weil dafür größere Runtime-/Build-Downloads nötig wären.

Verifikation

Lokal grün:

  • python3 -m compileall app tests
  • QT_QPA_PLATFORM=offscreen WHISPER_GUI_TESTS=1 python -m pytest -q
  • bash -n scripts/install.sh
  • bash -n scripts/verify.sh
  • git diff --check
  • Secret-Scan negativ
  • flatpak-builder --show-manifest OK
  • flatpak-builder --show-deps OK

Rollback

Vor Merge: Branch/PR schließen und Branch löschen.

Nach Merge: Squash-Commit per git revert <squash-commit> zurücknehmen.

GUI-only MVP scope: Qt6 shell, Qt clipboard fallback, PulseAudio
recording, OpenAI cloud calls. Global hotkeys (evdev) and ydotool
auto-paste stay visibly disabled inside the sandbox, matching the
existing graceful-degradation code from PR #47. Local Whisper/torch
transcription is deferred to keep the build check lightweight.

Structural validation only (--show-manifest/--show-deps); no full
flatpak-builder run since org.kde.Platform//6.8 + Sdk would need a
~1.5 GB download not in scope for this spike.
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Copy link
Copy Markdown
Owner Author

@codex please review this PR.

Focus only on the Flatpak MVP spike scope:

  • packaging/flatpak/io.github.TimInTech.BlitztextLinux.yaml
  • packaging/flatpak/blitztext-linux.sh
  • packaging/flatpak/requirements-flatpak.txt
  • packaging/flatpak/README.md

Please check:

  1. Manifest plausibility for a local Flatpak MVP, not Flathub readiness.
  2. Launcher path correctness inside /app/share/blitztext-linux.
  3. Dependency scope: PyQt6 + OpenAI only, no Whisper/Torch bundle.
  4. Sandbox boundary claims: GUI, Qt Clipboard fallback, PulseAudio, OpenAI cloud calls.
  5. Explicitly disabled/non-goals: global hotkeys, ydotool auto-paste, desktop/AppStream/icon, release, tag, version bump.
  6. Any secret-risk or misleading documentation claims.

Do not make changes. Please return blockers vs non-blockers and the smallest safe next step.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Copy link
Copy Markdown
Owner Author

@codex please retry the code review for this PR.

Credits/auto top-up should now be active. Please review only the Flatpak MVP spike scope and do not make changes.

Focus:

  • packaging/flatpak/io.github.TimInTech.BlitztextLinux.yaml
  • packaging/flatpak/blitztext-linux.sh
  • packaging/flatpak/requirements-flatpak.txt
  • packaging/flatpak/README.md

Return blockers vs non-blockers and the smallest safe next step.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@TimInTech TimInTech merged commit 646f471 into main Jul 6, 2026
7 checks passed
@TimInTech TimInTech deleted the spike/flatpak-manifest-mvp branch July 6, 2026 10:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant