feat(obs-integration): add OBS integration plugin

obs-integration/README.md

@@ -0,0 +1,95 @@
+# OBS Integration
+
+Manage openSUSE Build Service projects and packages from Noctalia. The bar
+widget toggles a panel for browsing your projects, checking out packages,
+editing metadata and files, and triggering rebuilds on OBS — without leaving
+the shell.
+
+## Plugin
+
+| Field | Value |
+| --- | --- |
+| ID | `neyfua/obs-integration` |
+| Entries | Bar widget: `obs-integrate`; panel: `panel` |
+
+## Requirements
+
+Install the openSUSE Build Service `osc` CLI on `PATH` and configure your
+credentials in `~/.config/osc/oscrc` (for example with `osc apiservice` setup
+or by copying a working `oscrc`). The plugin shells out to `osc` for every
+operation, so all authentication stays in your normal OBS configuration.
+
+## Usage
+
+Add the `obs-integrate` widget to a bar. Left-click it to open the panel.
+
+Open the panel directly with:
+
+```sh
+noctalia msg panel-toggle neyfua/obs-integration:panel
+```
+
+### My Projects
+
+The panel opens on **My Projects**: every project you maintain, plus every
+project where you are listed as a package maintainer on OBS. Search filters the
+list, and the sort button toggles A-Z / Z-A order. The pen icon edits the
+project metadata (`osc meta prj -e`).
+
+### Inside a project
+
+Click a project to list its packages. A package's icon turns **primary** when
+that package is checked out in your local directory. Click a package to open
+its actions:
+
+- **Checkout package** — `osc co` in the configured checkout directory
+  (hidden once the package is already checked out).
+- **Edit files** — expandable list of editable sources: `_service` and the
+  package's `.spec` open in your `$EDITOR`; the `.changes` file runs
+  `osc vc`.
+- **Files** — lists every non-dotfile in the checkout. Each file has a remove
+  button; below the list, **Add/Remove** runs `osc ar` asynchronously in the
+  panel. **Commit** runs `osc status` first; if pending changes exist it
+  opens a terminal with `osc ci` so you can edit the commit message, otherwise
+  the commit runs asynchronously in the panel.
+- **Service Local Run** — runs `osc service r` in the checkout, executing the
+  package's source-service scripts locally (local side effects: the `_service`
+  scripts can modify files in the checkout).
+- **Service Manual Run** — runs `osc service mr` in the checkout, running the
+  source-service scripts locally in "manual" mode (local side effects, like
+  Service Local Run).
+- **Service Run All** — runs `osc service ra` in the checkout, running all
+  source-service scripts locally. Requires a confirmation click (turns
+  **secondary** with a **check** glyph) before it executes.
+- **Service Remote Run** — runs `osc service rr` on the OBS server for the
+  package on the remote project. No local code executes; the request triggers
+  server-side service runs, and a confirmation is not required.
+- **Rebuild package** — pick an architecture (or **All**) and trigger
+  `osc rebuild`. Confirmation is required before it runs.
+- **Edit package meta** — `osc meta pkg -e` in a terminal.
+- **Remove package** — deletes the checkout from disk only (never touches the
+  OBS project); confirm before it runs. If it was the last package in the
+  project directory, the directory is removed too.
+
+### Sticky navigation
+
+The panel reopens where you left off — inside the same project or package.
+
+## Settings
+
+| Setting | Type | Default | Description |
+| --- | --- | --- | --- |
+| `checkout_dir` | `string` | `~/OBS` | Base directory where packages are checked out. Packages land in `<checkout_dir>/<project>/<package>`. |
+| `show_label` | `bool` | `false` | Show the "OBS" label next to the bar icon. |
+
+## Notes
+
+The plugin runs the `osc` CLI with your existing credentials — it stores
+nothing itself beyond a small cache of project/package listings and your last
+navigated view. Removal is local-only and never modifies the OBS project.
+Most operations (rebuilds, service runs, updates, add/remove) run
+asynchronously and display their output directly in the panel. The Commit
+operation opens a terminal only when `osc status` reports pending changes;
+otherwise, it runs asynchronously in the panel. Confirmation prompts precede
+destructive and side-effecting operations: Rebuild package, Remove package,
+and Service Run All.