Release v0.5.0

Reviewed-on: #6
Co-authored-by: Julien Fastré <julien.fastre@champs-libres.coop>
Co-committed-by: Julien Fastré <julien.fastre@champs-libres.coop>

.changes/unreleased/Added-20251112-201311.yaml

@@ -1,3 +0,0 @@
-kind: Added
-body: Add a web extension
-time: 2025-11-12T20:13:11.961655215+01:00

.changes/v0.5.0.md

@@ -0,0 +1,4 @@
+## v0.5.0 - 2025-11-13
+### Added
+* Add a web extension
+* Install using package manager, with CI generating the package

CHANGELOG.md

@@ -6,6 +6,11 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 and is generated by [Changie](https://github.com/miniscruff/changie).
 
 
+## v0.5.0 - 2025-11-13
+### Added
+* Add a web extension
+* Install using package manager, with CI generating the package
+
 ## v0.4.1 - 2025-10-25
 ### Fixed
 * Fix dependencies

Cargo.lock

@@ -174,7 +174,7 @@ dependencies = [
 
 [[package]]
 name = "cl-cli"
-version = "0.5.0-alpha16"
+version = "0.5.0"
 dependencies = [
  "clap",
  "gitlab",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cl-cli"
-version = "0.5.0-alpha16"
+version = "0.5.0"
 edition = "2021"
 license = "GPL-3.0-or-later"
 description = "Some helpers scripts for Champs-Libres"

README.md

@@ -6,23 +6,49 @@ Currently:
 
 - convert a gitlab issue to a work package
 
-## Install & configure
+## Install
 
-### Install
+There are two components to install:
 
-Download the most recent binaries at https://gitea.champs-libres.be/julienfastre/cl-cli/releases
+- a firefox add-ons;
+- some binaries on the host machine
 
-Once downloaded, install it:
+### Install firefox add-on
 
-```
+Using firefox, download the `.xpi` file from the [release page](https://gitea.champs-libres.be/julienfastre/cl-cli/releases) of the `julienfastre/cl-cli` repository.
-# this will install the command globally with the name "cl-cli"
-sudo install cl-cli /usr/local/bin/cl-cli
 
-# this will install the command globally with the name "cl"
+### Install cl-cli binaries
-sudo install cl-cli /usr/local/bin/cl
+
+#### Using package manager
+
+A debian package is published and stored on gitea.
+
+
+
+```bash
+# download the gpg key
+sudo curl https://gitea.champs-libres.be/api/packages/julienfastre/debian/repository.key -o /etc/apt/keyrings/gitea-julienfastre.asc
+
+# add the package repository. You must adapt the $distribution (see below)
+echo "deb [signed-by=/etc/apt/keyrings/gitea-julienfastre.asc] https://gitea.champs-libres.be/api/packages/julienfastre/debian $distribution main" | sudo tee -a /etc/apt/sources.list.d/gitea.list
+
+# update
+sudo apt update
+
+# install
+sudo apt install cl-cli
 ```
 
-### Configure
+Available distributions:
+
+- Ubuntu 24..04: noble
+- Ubuntu 25.04: plucky
+- Ubuntu: 25.10: questing
+
+**Note:** The package is very simple, there are very few dependencies, and there isn't any difference between them for now.
+
+
+## Configure
 
 Copy the file [config.toml.dist](./config.toml.dist) as a template, and
 save it at the path `$HOME/.config/cl-cli/config.toml`:
@@ -33,14 +59,19 @@ cp config.toml $HOME/.config/cl-cli/config.toml
 editor $HOME/.config/cl-cli/config.toml
 ```
 
-Then, fill it with the required configuration options (gitlab and openproject token).
+Then, fill it with the required configuration options:
+
+- gitea personal access token: 
+
+    ![configuration screenshort](./docs/configuration/gitea_screenshot_configure_pat.png)
+- Gitlab: [Create an access token](https://gitlab.com/-/user_settings/personal_access_tokens?name=cl-cli&scopes=api,read_user) With the "api" and "read_user" scopes
+- [Openproject](https://champs-libres.openproject.com/my/access_tokens)
 
 
-## Usage
+## Usage as CLI
 
 ### Convert a gitlab issue into a work package
 
-
 ```bash
 cl-cli planning i2work https://gitlab.com/Chill-Projet/chill-bundles/-/issues/240 chill
 ```

web-extension/cl/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Champs-Libres Helper",
-  "version": "0.4",
+  "version": "0.5.0",
   "browser_specific_settings": {
     "gecko": {
       "id": "helper@champs-libres-coop",

web-extension/cl/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-extension",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "",
   "main": "index.js",
   "scripts": {