From 9055c31ee774347e576a7aa10bc1de9f8e87f1a5 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Tue, 27 Jan 2026 16:21:05 +0100
Subject: [PATCH] release: version 3.17.0 - Tasks API limitations documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Version bump from 3.16.0 to 3.17.0 with Tasks API field visibility
limitations integration.

Changes:
- VERSION: 3.16.0 → 3.17.0
- CHANGELOG.md: Moved [Unreleased] to [3.17.0] - 2026-01-27
- README.md: Updated version footer, resource evaluations count (22)
- guide/cheatsheet.md: Updated version headers
- guide/ultimate-guide.md: Updated version
- machine-readable/reference.yaml: Updated version + date

Release highlights:
- 🚨 CRITICAL: Tasks API limitations documented (Gang Rui analysis)
  * TaskList field visibility constraints
  * 11x-51x cost overhead for N tasks
  * 3 workaround patterns provided
  * Prevents user frustration, maintains guide credibility

- 📊 Stats: 22 resource evaluations, 493 lines added
- 🎯 Impact: All Tasks API users (v2.1.16+) benefit from transparency

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 CHANGELOG.md                    | 2 ++
 README.md                       | 4 ++--
 VERSION                         | 2 +-
 guide/cheatsheet.md             | 4 ++--
 guide/ultimate-guide.md         | 4 ++--
 machine-readable/reference.yaml | 4 ++--
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8d766ad..942cb6b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Unreleased]
 
+## [3.17.0] - 2026-01-27
+
 ### Added
 
 - **Tasks API field visibility limitations** (Gang Rui analysis, 2026-01-27)
diff --git a/README.md b/README.md
index 93e964c..e48af75 100644
--- a/README.md
+++ b/README.md
@@ -395,7 +395,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv
 
 **Status**: Research preview (Pro $20/mo or Max $100-200/mo, macOS only, **VPN incompatible**)
 
-**Archive**: Historical versions available in git history (pre-v3.16.0)
+**Archive**: Historical versions available in git history (pre-v3.17.0)
 
 </details>
 
@@ -465,7 +465,7 @@ Licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
 
 ---
 
-*Version 3.16.0 | January 2026 | Crafted with Claude*
+*Version 3.17.0 | January 2026 | Crafted with Claude*
 
 <!-- SEO Keywords -->
 <!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,
diff --git a/VERSION b/VERSION
index 1eeac12..3f67e25 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.16.0
+3.17.0
diff --git a/guide/cheatsheet.md b/guide/cheatsheet.md
index 73c7ab2..d22f3c1 100644
--- a/guide/cheatsheet.md
+++ b/guide/cheatsheet.md
@@ -6,7 +6,7 @@
 
 **Written with**: Claude (Anthropic)
 
-**Version**: 3.16.0 | **Last Updated**: January 2026
+**Version**: 3.17.0 | **Last Updated**: January 2026
 
 ---
 
@@ -484,4 +484,4 @@ where.exe claude; claude doctor; claude mcp list
 
 **Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
 
-*Last updated: January 2026 | Version 3.16.0*
+*Last updated: January 2026 | Version 3.17.0*
diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md
index f8118f4..aa0b757 100644
--- a/guide/ultimate-guide.md
+++ b/guide/ultimate-guide.md
@@ -10,7 +10,7 @@
 
 **Last updated**: January 2026
 
-**Version**: 3.16.0
+**Version**: 3.17.0
 
 ---
 
@@ -15493,4 +15493,4 @@ We'll evaluate and add it to this section if it meets quality criteria.
 
 **Contributions**: Issues and PRs welcome.
 
-**Last updated**: January 2026 | **Version**: 3.16.0
+**Last updated**: January 2026 | **Version**: 3.17.0
diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml
index cba1b3f..4f27b43 100644
--- a/machine-readable/reference.yaml
+++ b/machine-readable/reference.yaml
@@ -3,7 +3,7 @@
 # Source: guide/ultimate-guide.md
 # Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
 
-version: "3.16.0"
+version: "3.17.0"
 updated: "2026-01-27"
 
 # ════════════════════════════════════════════════════════════════
@@ -789,7 +789,7 @@ ecosystem:
       - "Cross-links modified → Update all 4 repos"
     history:
       - date: "2026-01-20"
-        event: "Code Landing sync v3.16.0, 66 templates, cross-links"
+        event: "Code Landing sync v3.17.0, 66 templates, cross-links"
         commit: "5b5ce62"
       - date: "2026-01-20"
         event: "Cowork Landing fix (paths, README, UI badges)"