From 39623fd5b8c28a9614a65553e3ce619e46fce9c2 Mon Sep 17 00:00:00 2001
From: Rezolv <dave@sienkowski.com>
Date: Sun, 19 Apr 2026 23:10:32 -0400
Subject: [PATCH] docs(cli): deprecate gsd-tools.cjs header in favor of gsd-sdk
 (#2343) (#2343)

Single-file change: JSDoc @deprecated notice pointing to SDK query registry.
No .planning or unrelated merges.
---
 get-shit-done/bin/gsd-tools.cjs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/get-shit-done/bin/gsd-tools.cjs b/get-shit-done/bin/gsd-tools.cjs
index f2599c010..382aa4cb0 100755
--- a/get-shit-done/bin/gsd-tools.cjs
+++ b/get-shit-done/bin/gsd-tools.cjs
@@ -1,6 +1,10 @@
 #!/usr/bin/env node
 
 /**
+ * @deprecated The supported programmatic surface is `gsd-sdk query` (SDK query registry)
+ * and the `@gsd-build/sdk` package. This Node CLI remains the compatibility implementation
+ * for shell scripts and older workflows; prefer calling the SDK from agents and automation.
+ *
  * GSD Tools — CLI utility for GSD workflow operations
  *
  * Replaces repetitive inline bash patterns across ~50 GSD command/workflow/agent files.