taskchampion-rb 0.9.4 → 0.9.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85a9e4bbadf210738f7323d195f86ce65f38a0a15ad050c44d80d9fd1a89b65b
-  data.tar.gz: '01859bba67a308f7099e7a71c1dac97b7183b7f5f86c6d687bb5a0306855a914'
+  metadata.gz: 4d630eddac8dfcb822f6e7f09d61f47abf4bc7597cc2d5cc127b53bff7a6a2f2
+  data.tar.gz: 7fbf3649576f7b77114f67fb9ea04c5018d06ba27dc0746b74a35a67c8af1cb5
 SHA512:
-  metadata.gz: fe76184011726622973acbf7e642d8f5eba2c216f352aeefd03abbeb4d158300a813cae42409fd205c4a4fca0f030ac194bd7a2bab738bb5a763790657da1e59
-  data.tar.gz: f1c4953a7cb01a93b3a7b82163e8f6b6ed52452d21f9df049da7189f45e1bdbea81233ce79762d0525a512cd48cde44312d3ecb5cafcc611a75175b347c80ab0
+  metadata.gz: a412f351c3b06ba461ae2404bad35c2944cbd25245e7f7ed7415e8d97647fd21c397c15b538064530481029ce10be0a37d0ad75156f6907cb515ea89fa66382e
+  data.tar.gz: b428ea2050a5286a05a6c73037434874161c7cc4c3df0784c1741b53fffc47918819a88c1aae537ebde2ca5466b46be071905aebffc2995034ad9a3784337996

data/.ruby-version

@@ -1 +1 @@
-3.2.0
+3.3.9

data/CHANGELOG.md

@@ -1,4 +1,91 @@
-## [Unreleased]
+## [0.9.6] - 2026-10-22
+
+- Update `rb-sys` to 0.9.130 (pulling in `bindgen` 0.72.1) in
+  `Cargo.lock`. The previously locked `bindgen` 0.69.5 cannot parse
+  Ruby's `rb_data_type_struct` with libclang 22, as shipped on Ubuntu
+  26.04, so `magnus` failed to compile there.
+- Drop the stale Ruby 3.5 preview from the CI matrix; CI now tests 3.3
+  and 3.4. Ruby 4.0 is not yet supported (`magnus` 0.7 does not build
+  against it).
+
+## [0.9.5] - 2026-09-10
+
+- Drop support for Ruby 3.2 (reached EOL March 2026). Minimum supported
+  Ruby is now 3.3.
+- Enable the `bundled` feature of the `taskchampion` crate so SQLite is
+  compiled from source into the extension. Previously `default-features
+  = false` dropped `bundled`, making the build link against system
+  SQLite and fail with `cannot find -lsqlite3` on any host without
+  `libsqlite3-dev` installed.
+- Expand README build prerequisites: `clang`/`libclang-dev` (needed by
+  `rb-sys` bindgen) on Linux, `xcode-select --install` on macOS, and
+  note that the Rust toolchain is optional since `rb-sys` bootstraps
+  one.
+
+## [0.9.4] - 2026-07-11
+
+- Include the full cause chain in sync error messages. TaskChampion
+  wraps sync failures in an anyhow context, and the default `Display`
+  previously printed only the outermost line ("Failed to synchronize
+  with server"), hiding the real cause. `Error::Other` is now formatted
+  with anyhow's alternate format so the full chain (HTTP status,
+  connection errors, server rejections) reaches Ruby.
+- Add `server-gcp` feature flag, required for `ServerConfig::Gcp` used
+  by `sync_gcp`
+- Fix order-dependent annotation test
+
+## [0.9.3] - 2026-05-30
+
+- Add `Task#set_modified` method, consistent with `set_entry`
+- Move docs
+- Change taskchampion dependency to enable `server-sync` feature
+
+## [0.9.2] - 2026-05-22
+
+- Fix all Rust compiler warnings
+
+## [0.9.1] - 2026-05-22
+
+- Fix error mapping to use `taskchampion::Error` enum variants instead
+  of heuristic message-content matching. Adds
+  `Taskchampion::OutOfSyncError < SyncError` for the `OutOfSync`
+  sentinel, signaling an irrecoverable divergence that requires a full
+  re-sync rather than a retry
+
+## [0.9.0] - 2025-10-17
+
+- Add remove and update annotations support
+
+## [0.8.0] - 2025-09-24
+
+- Add undo/history functionality with operation tracking
+- Add `set_timestamp` and `get_timestamp` methods for custom date
+  fields
+- Fix RuboCop errors
+
+## [0.7.0] - 2025-08-18
+
+- Add `set_entry` method to `Task`
+- Fix RuboCop errors
+
+## [0.6.0] - 2025-08-14
+
+- Add pending task support to `Replica`
+
+## [0.5.0] - 2025-08-14
+
+- Implement `done` status handling
+
+Note: v0.4.0 was tagged against the same commit as v0.5.0 and carries
+no distinct changes; treat v0.5.0 as its replacement.
+
+## [0.3.0] - 2025-08-14
+
+- Rename gem to `taskchampion-rb`
+- Implement `TaskData`
+- Rename `tasks` to `all_tasks`
+- Support Windows and ARM builds
+- Drop support for Ruby versions below 3.2
 
 ## [0.2.0] - 2025-08-11
 

data/Cargo.lock

@@ -115,20 +115,18 @@ checksum = "0e050f626429857a27ddccb31e0aca21356bfa709c04041aefddac081a8f068a"
 
 [[package]]
 name = "bindgen"
-version = "0.69.5"
+version = "0.72.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "271383c67ccabffb7381723dea0672a673f292304fcb45c01cc648c7a8d58088"
+checksum = "993776b509cfb49c750f11b8f07a46fa23e0a1386ffc01fb1e7d343efc387895"
 dependencies = [
  "bitflags",
  "cexpr",
  "clang-sys",
  "itertools",
- "lazy_static",
- "lazycell",
  "proc-macro2",
  "quote",
  "regex",
- "rustc-hash 1.1.0",
+ "rustc-hash",
  "shlex",
  "syn",
 ]
@@ -862,12 +860,6 @@ version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
 
-[[package]]
-name = "lazycell"
-version = "1.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "830d08ce1d1d941e6b30645f1a0eb5643013d835ce3779a5fc208261dbe10f55"
-
 [[package]]
 name = "libc"
 version = "0.2.174"
@@ -881,7 +873,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "07033963ba89ebaf1584d767badaa2e8fcec21aedea6b8c0346d487d49c28667"
 dependencies = [
  "cfg-if",
- "windows-targets 0.53.3",
+ "windows-targets 0.52.6",
 ]
 
 [[package]]
@@ -890,6 +882,7 @@ version = "0.30.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2e99fb7a497b1e3339bc746195567ed8d3e24945ecd636e3619d20b9de9e9149"
 dependencies = [
+ "cc",
  "pkg-config",
  "vcpkg",
 ]
@@ -1162,7 +1155,7 @@ dependencies = [
  "pin-project-lite",
  "quinn-proto",
  "quinn-udp",
- "rustc-hash 2.1.1",
+ "rustc-hash",
  "rustls",
  "socket2",
  "thiserror 2.0.12",
@@ -1182,7 +1175,7 @@ dependencies = [
  "lru-slab",
  "rand",
  "ring",
- "rustc-hash 2.1.1",
+ "rustc-hash",
  "rustls",
  "rustls-pki-types",
  "slab",
@@ -1252,18 +1245,18 @@ dependencies = [
 
 [[package]]
 name = "rb-sys"
-version = "0.9.116"
+version = "0.9.130"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7059846f68396df83155779c75336ca24567741cb95256e6308c9fcc370e8dad"
+checksum = "02faf625bb10ba893e3ae620f19c9fb1b5f8fcae0fe4eb86bb3f2230fad75edb"
 dependencies = [
  "rb-sys-build",
 ]
 
 [[package]]
 name = "rb-sys-build"
-version = "0.9.116"
+version = "0.9.130"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ac217510df41b9ffc041573e68d7a02aaff770c49943c7494441c4b224b0ecd0"
+checksum = "05be6f9c86fe5482808162826f6c047d093b3670582296c770de1d94f8066694"
 dependencies = [
  "bindgen",
  "lazy_static",
@@ -1405,12 +1398,6 @@ dependencies = [
  "smallvec",
 ]
 
-[[package]]
-name = "rustc-hash"
-version = "1.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
-
 [[package]]
 name = "rustc-hash"
 version = "2.1.1"

data/README.md

@@ -2,26 +2,34 @@
 
 Ruby bindings for TaskChampion, the task database that powers Taskwarrior.
 
-## Ruby Version Support (2025-08-12)
+## Ruby Version Support (2026-09-10)
 
-This gem supports Ruby 3.2 and later. We follow Ruby's end-of-life (EOL) schedule and drop support for Ruby versions that have reached EOL.
+This gem supports Ruby 3.3 and later. We follow Ruby's end-of-life (EOL) schedule and drop support for Ruby versions that have reached EOL.
 
-- **Ruby 3.2**: Supported (EOL: March 2026)
-- **Ruby 3.3**: Supported (Current stable)
-- **Ruby 3.4**: Supported
-- **Ruby 3.0-3.1**: Not supported (reached EOL)
+- **Ruby 3.3**: Supported
+- **Ruby 3.4**: Supported (Current stable)
+- **Ruby 3.5**: Supported
+- **Ruby 3.0-3.2**: Not supported (reached EOL)
 
 ## Installation
 
 ### Prerequisites
 
-1. Ruby 3.2 or later
-2. Rust toolchain (install from https://rustup.rs/)
+1. Ruby 3.3 or later
+2. A C compiler and `clang`/`libclang` development headers — `rb-sys` runs
+   libclang over Ruby's headers to generate FFI bindings during `rake compile`.
+   - **Debian/Ubuntu:** `sudo apt install clang libclang-dev`
+   - **macOS:** `xcode-select --install`
+3. Rust toolchain (optional — if `cargo` is not found, `rb-sys` bootstraps its
+   own rustup + toolchain during the build). To install it yourself:
 
 ```bash
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 ```
 
+> SQLite is compiled from source into the extension (the `bundled` feature), so
+> no system SQLite / `libsqlite3-dev` is required.
+
 ### Building from source
 
 ```bash

data/docs/post_upstream_fix_migration.md

@@ -0,0 +1,147 @@
+# Migration plan: once the upstream `taskchampion` sync-error fix lands
+
+## Context
+
+`Replica::sync()` in the upstream `taskchampion` crate currently routes
+every sync failure through `anyhow::Context`, which erases the typed
+`Error` variant (`Database`, `Server`, `OutOfSync`, `Usage`) and
+re-boxes it as the catch-all `Error::Other` — regardless of what
+actually failed. See `upstream_issue_draft.md` at the root of this
+checkout of `~/Sites/reference/taskchampion` for the full writeup filed
+against `GothenburgBitFactory/taskchampion`.
+
+This document tracks what changes in `taskchampion-rb` once that
+upstream issue is fixed and released (or once we point at a patched
+fork, whichever comes first).
+
+## What does *not* need to change
+
+`ext/taskchampion/src/error.rs`'s `map_taskchampion_error` already has
+the correct match arms:
+
+```rust
+match error {
+    Error::Database(msg) => Error::new(storage_error(), msg),
+    Error::Server(msg)   => Error::new(sync_error(), msg),
+    Error::OutOfSync     => Error::new(out_of_sync_error(), "..."),
+    Error::Usage(msg)    => Error::new(validation_error(), msg),
+    Error::Other(err)    => Error::new(storage_error(), format!("{err:#}")),
+}
+```
+
+These arms have been correct since `0.9.1` ("Fix error mapping to use
+enum variants") — they've simply been dead code for sync failures
+specifically, because `Replica::sync()` never handed them a real
+`Server`/`OutOfSync` value to match against. No changes needed here.
+
+## What does need to change
+
+### 1. Bump the pinned crate dependency
+
+`ext/taskchampion/Cargo.toml`:
+
+```toml
+taskchampion = { version = "2.0", default-features = false, features = ["server-sync", "server-gcp"] }
+```
+
+Once the fix ships in a crates.io release, bump `"2.0"` to whatever
+version includes it. If we go the fork route first (patch applied
+locally, upstream PR still pending review), point at the fork instead:
+
+```toml
+taskchampion = { git = "https://github.com/<you>/taskchampion", branch = "preserve-sync-error-variant", default-features = false, features = ["server-sync", "server-gcp"] }
+```
+
+Swap back to the crates.io version once/if the PR merges and releases.
+
+Run `cargo update -p taskchampion` (or `bundle exec rake compile`,
+which will pull in the new `Cargo.lock` resolution) and recompile.
+
+### 2. This is a breaking change for consumers — bump to 0.10.0
+
+`Taskchampion::StorageError` and `Taskchampion::SyncError` are
+**siblings** under `Taskchampion::Error`, not superclass/subclass:
+
+```
+Taskchampion::Error
+├── Taskchampion::StorageError
+└── Taskchampion::SyncError
+    └── Taskchampion::OutOfSyncError
+```
+
+Today, every `sync_to_remote`/`sync_to_local`/`sync_to_gcp` failure
+raises `StorageError`. After this fix, connection/network/out-of-sync
+failures will raise `SyncError` or `OutOfSyncError` instead. Any
+consumer code doing `rescue Taskchampion::StorageError` specifically
+around a sync call — expecting it to catch sync failures — will
+silently stop catching them.
+
+Per semver for a pre-1.0 gem, this warrants a **minor** version bump
+(`0.9.4` → `0.10.0`), not a jump to `1.0.0`. See the CHANGELOG entry
+below.
+
+### 3. Update `docs/TaskchampionRbErrors.md`
+
+This file already documents `SyncError`/`OutOfSyncError` as reachable
+via `Error::Server`/`Error::OutOfSync` — that documentation is
+currently aspirational/inaccurate for sync failures specifically. Once
+the fix lands, it becomes correct; no wording changes should be
+needed, but re-verify the examples still match actual raised messages
+(the message text may shift slightly depending on how the upstream fix
+formats the wrapped context — see caveat below).
+
+### 4. Verify existing tests still pass, add classification coverage
+
+Existing tests are already forward-compatible:
+
+- `test/integration/test_sync_operations.rb:150`
+  (`test_sync_error_handling`) asserts
+  `Taskchampion::StorageError, Taskchampion::SyncError` (either) — no
+  change needed.
+- `test/integration/test_sync_operations.rb`
+  (`test_remote_sync_error_includes_underlying_cause`, added in
+  `61130f5`) asserts the base `Taskchampion::Error` and matches on
+  message content — no change needed, but re-run it: the exact message
+  format may shift if the upstream fix wraps the inner message
+  differently than our expectation
+  (`"Failed to synchronize with server: <cause>"`).
+
+Add new coverage once the fix lands:
+
+- A test that a genuinely out-of-sync replica (server has diverged,
+  e.g. by resetting the sync server's storage under a replica that has
+  already synced) raises `Taskchampion::OutOfSyncError` specifically,
+  not just `StorageError`/`SyncError`.
+- A test that a connection failure (as in the existing
+  `test_remote_sync_error_includes_underlying_cause`) raises
+  `Taskchampion::SyncError` specifically, not `StorageError`.
+
+### 5. CHANGELOG entry
+
+Add to `[Unreleased]` (or a new `[0.10.0]` section once released):
+
+```markdown
+## [0.10.0] - YYYY-MM-DD
+
+### Changed
+- **Breaking:** sync failures now raise `Taskchampion::SyncError` or
+  `Taskchampion::OutOfSyncError` instead of `Taskchampion::StorageError`,
+  now that upstream `taskchampion` preserves the typed error variant
+  through `Replica::sync()` instead of erasing it via `anyhow::Context`.
+  Code that rescues `Taskchampion::StorageError` specifically around a
+  sync call should rescue `Taskchampion::SyncError` (or the common
+  base `Taskchampion::Error`) instead.
+```
+
+## Downstream: bravo / wt_engine
+
+Once `taskchampion-rb` is bumped in `bravo`'s and `wt_engine`'s
+`Gemfile.lock`, `Wt::SyncEventProcessor`'s failure path
+(`engines/wt_engine/app/jobs/wt/sync_event_processor.rb`) and
+`Tc::Sync#with_rescue` (`engines/wt_engine/app/services/tc/sync.rb`)
+both use bare `rescue => e` / catch any `StandardError`, so they are
+unaffected by the exception-class change — no code changes required
+there. The benefit is purely in Sentry: `Taskchampion::OutOfSyncError`
+and `Taskchampion::SyncError` will appear as distinct issues/fingerprints
+instead of one generic `StorageError` bucket, without needing any
+message-string parsing to distinguish them.

data/ext/taskchampion/Cargo.toml

@@ -12,7 +12,9 @@ crate-type = ["cdylib"]
 [dependencies]
 magnus = { version = "0.7", features = ["rb-sys"] }
 rb-sys = "0.9.103"
-taskchampion = { version = "2.0", default-features = false, features = ["server-sync", "server-gcp"] }
+# `bundled` compiles SQLite from source into the extension so the build does not
+# depend on the host having libsqlite3-dev / a compatible system SQLite.
+taskchampion = { version = "2.0", default-features = false, features = ["bundled", "server-sync", "server-gcp"] }
 chrono = "0.4"
 uuid = "1.0"
 

data/lib/taskchampion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Taskchampion
-  VERSION = "0.9.4"
+  VERSION = "0.9.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: taskchampion-rb
 version: !ruby/object:Gem::Version
-  version: 0.9.4
+  version: 0.9.6
 platform: ruby
 authors:
 - Tim Case
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-11 00:00:00.000000000 Z
+date: 2026-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rb_sys
@@ -51,6 +51,7 @@ files:
 - docs/errors.md
 - docs/phase_3_plan.md
 - docs/plan.md
+- docs/post_upstream_fix_migration.md
 - example.md
 - examples/basic_usage.rb
 - examples/pending_tasks.rb
@@ -91,14 +92,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: 3.3.11
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Ruby bindings for TaskChampion