chore: prepare release 2.5.0

Author: jamiebrynes7

docs/docs/changelog.md

@@ -10,7 +10,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
+## v2.5.0 (2026-01-25)
 
 ### ✨ Features
 

docs/versioned_docs/version-2.5.0/changelog.md

@@ -0,0 +1,2 @@
+label: Commands
+position: 4

docs/versioned_docs/version-2.5.0/commands/_category_.yml

@@ -0,0 +1,27 @@
+---
+sidebar_position: 1
+---
+
+# Add task
+
+![](./add-task-modal.png)
+
+The 'Add task' set of commands open up a modal that allows you to configure and send tasks to Todoist from Obsidian. Any text selected will be used to pre-populate the task content.
+
+There are a few variants of the command:
+
+- 'Add task', the basic version
+- 'Add task with current page in task content', this option will append a link to the current page in the task content before it sends it to Obsidian. The modal will inform you it will do this, but the link is not shown to keep the modal clean.
+- 'Add task with current page in task description', this option will append a link to the current page in the task description before it sends it to Obsidian. The modal will inform you it will do this, but the link is not shown to keep the modal clean.
+
+## Copy markdown link after creating task
+
+The 'Add task' button in the modal is a split button with a dropdown menu. You can click the dropdown arrow to choose between three actions:
+
+- **Add task** - Creates the task without copying anything
+- **Add task and copy link (app)** - Creates the task and copies a markdown link with an app URI (`todoist://task?id=...`)
+- **Add task and copy link (web)** - Creates the task and copies a markdown link with a web URL (`https://todoist.com/app/project/...`)
+
+The copied text format is `task content [Todoist](url)`, which you can paste directly into your Obsidian notes. If you have "append link to content" enabled, an Obsidian backlink to the current page will also be included. The link will open the task in Todoist when clicked.
+
+You can set your preferred default action in the plugin settings under "Task creation" → "Default add task action".

docs/versioned_docs/version-2.5.0/commands/add-task-modal.png

@@ -0,0 +1,12 @@
+---
+sidebar_position: 2
+---
+
+# Sync with Todoist
+
+The 'Sync with Todoist' command forces the plugin to re-synchronize your labels, projects, and sections with Todoist. This can be useful if you see "Unknown Project", "Unknown Section", or "Unknown Label" in any rendered tasks.
+
+The plugin pulls this information at startup, but will not refresh it automatically because:
+
+- its expected that these don't change frequently
+- to help avoid hitting the Todoist API rate limit

docs/versioned_docs/version-2.5.0/commands/add-task.md

@@ -0,0 +1,86 @@
+---
+sidebar_position: 5
+---
+
+# Configuration
+
+There are a number of options that allow you to configure the behaviour of the plugin. These are listed below, but the settings page also gives brief descriptions.
+
+## General
+
+### Todoist API token
+
+The API token used to connect to Todoist. This is stored in your vault at `.obsidian/todoist-token`. If you synchronize your vault, I recommend that you do _not_ sync this file for security reasons.
+
+## Auto-refresh
+
+### Auto-refresh enabled
+
+When enabled, all queries will auto-refresh themselves according to the interval in the settings.
+
+### Auto-refresh interval
+
+This defines, in seconds, the interval between automatic refreshes. This is only used when:
+
+- the auto-refresh is enabled in the settings
+- the query does not define an explicit interval
+
+## Rendering
+
+### Task fade animation
+
+When enabled, tasks will fade-in or fade-out when tasks are added or removed respectively. Just some eye candy if you like that.
+
+### Render date icon
+
+When enabled, queries will render an icon accompanying the due date.
+
+### Render project & section icon
+
+When enabled, queries will render an icon accompanying the project & section.
+
+### Render labels icon
+
+When enabled, queries will render an icon accompanying the labels.
+
+## Task creation
+
+### Add parenthesis to page links
+
+When enabled, page links added to tasks created via the [command](./commands/add-task) will be wrapped in parenthesis. This may help identifying links if you primarily use Todoist on mobile platforms.
+
+### Add task button adds page link
+
+When enabled, the embedded add task button in queries will add a link to the page to the task in the specified place. This behaviour can also be disabled completely.
+
+### Default due date
+
+This defines the default due date assigned to tasks created via [commands](./commands/add-task). This can be one of: none, today, or tomorrow.
+
+### Default project
+
+This defines the default project assigned to tasks created via [commands](./commands/add-task). This can be configured to any of your projects, or the Inbox.
+
+If the project referenced here no longer exists, you will get a warning when opening the task creation modal and the Inbox will be used instead.
+
+### Default labels
+
+This defines the default labels assigned to tasks created via [commands](./commands/add-task). You can select zero, one, or multiple labels to be automatically applied to new tasks.
+
+If any of the selected labels no longer exist in Todoist, you will get a warning when opening the task creation modal and they will be skipped.
+
+### Default add task action
+
+This setting controls the default action for the 'Add task' button in the task creation modal. You can choose between:
+
+- **Add task** - Creates the task without copying a link
+- **Add task and copy link (app)** - Creates the task and copies a markdown-formatted link using the Todoist app URI
+- **Add task and copy link (web)** - Creates the task and copies a markdown-formatted link using the Todoist web URL
+
+This sets the initial button action when opening the modal, but you can change it per-task using the split button dropdown. See the [Add task command documentation](./commands/add-task#copy-markdown-link-after-creating-task) for more details.
+
+## Advanced
+
+### Debug logging
+
+When enabled, the plugin will print extra information to the Developer Tools console. You generally do not need to enable this.

docs/versioned_docs/version-2.5.0/commands/sync-with-todoist.md

@@ -0,0 +1,2 @@
+label: Contributing
+position: 6

docs/versioned_docs/version-2.5.0/configuration.md

@@ -0,0 +1,57 @@
+# General
+
+## Prerequisites
+
+This plugin is built using Typescript and React. You will need the following tools installed to build and run the plugin:
+
+- [`git`](https://git-scm.com/downloads)
+- [`npm`](https://nodejs.org/en/download/)
+
+Alternatively, if you use Nix, there is a flake and a `.envrc` to load the development environment for you. Simply run `direnv allow` to load the environment.
+
+## Building
+
+The plugin source is contained entirely within the `plugin` directory. To build the plugin:
+
+1. Run `cd plugin`
+2. Run `npm install` to pull down the required dependencies
+3. Run `npm run dev` to build the plugin.
+
+By default, this will build the plugin into `plugin/dist/`. You can manually copy the files an Obsidian vault for testing. For a smoother iteration cycle, you can tell the build process where it should place the output. The build process looks for the `VITE_OBSIDIAN_VAULT` environment variable to find a target vault.
+
+A simple way to configure this once is:
+
+1. Create a file at `plugin/.env.local`. This file is automatically loaded by the build script.
+2. Add a line to this file setting the environment variable. For example:
+
+   ```sh
+   export VITE_OBSIDIAN_VAULT=/Users/jamiebrynes/Documents/my-vault
+   ```
+
+## Running tests
+
+Its generally a good idea to write tests to ensure that the plugin's functionality is correct. The test suite is, at the time of writing, limited - but it can be useful for developing functionality against a set of tests. To run _all_ tests, from the `plugin` directory:
+
+```
+npm run test
+```
+
+Alternatively, to run a subset of tests, you can pass in a path to filter the tests ran:
+
+```
+npm run test ./src/utils
+```
+
+## Linting
+
+This plugin uses [BiomeJS](https://biomejs.dev/) to format and lint our Typescript. This ensures a consistent code style across the plugin. To check the formatting, from the `plugin` directory, run:
+
+```
+npm run lint:check
+```
+
+Biome can also format code to fix most issues. Note this will modify files on disk:
+
+```
+npm run lint:fix
+```

docs/versioned_docs/version-2.5.0/contributing/_category_.yml

@@ -0,0 +1,17 @@
+# Release Process
+
+This is a brief guide on how to release a new version of the plugin.
+
+1. Update changelog with release version + date.
+2. If minor or major release, cut a new version of the docs with `npm run bump-version -- ${VERSION}` in the `docs` directory.
+3. Update the versions in:
+    1. `manifest.json`
+    2. `package.json`
+    3. `versions.json`
+4. Open a PR + merge
+5. Tag the release with `git tag -a ${VERSION}` and push the tag with `git push origin ${VERSION}`
+6. Wait for the release build to complete.
+7. Update the generated release with the changelog and publish.
+8. Test the update in Obsidian.
+
+Note that between steps 4 and 6, there is a period of time where the plugin's `manifest.json` specified version does not have a release associated with it. This only lasts a minute or two, so the impact should be minimal.