episode: Paper Dynasty card-creation needs a dedicated API query CLI tool

episodes/2026-02-22.md

@@ -20,3 +20,7 @@ Errors encountered (5):
 - **Summary:** Errors encountered (2):
   - Exit code 1
 To
+
+## 09:44 - Paper Dynasty card-creation needs a dedicated API query CLI tool
+- **Type:** decision
+- **Tags:** paper-dynasty, cli, tooling, future-work, card-creation

graph/decisions/paper-dynasty-card-creation-needs-a-dedicated-api-query-cli-78c597.md

@@ -0,0 +1,36 @@
+---
+id: 78c597d0-51ac-459c-9d2d-b785f3fcd362
+type: decision
+title: "Paper Dynasty card-creation needs a dedicated API query CLI tool"
+tags: [paper-dynasty, cli, tooling, future-work, card-creation]
+importance: 0.7
+confidence: 0.8
+created: "2026-02-22T15:44:17.612480+00:00"
+updated: "2026-02-22T15:44:17.612480+00:00"
+---
+
+# Paper Dynasty Card-Creation: Missing API Query CLI
+
+## Context
+
+The `card-creation` project has a `pd-cards` CLI for card generation workflows, but lacks a general-purpose API query tool for interacting with the Paper Dynasty API directly (listing players by cardset, filtering, inspection, validation, etc.).
+
+## Problem
+
+Currently all API queries go through raw Python calls via `db_calls.py`, which is error-prone. In at least one session, this led to using the wrong query parameter name (`cardset` instead of `cardset_id`), causing silent failures that returned 13,500+ unfiltered records.
+
+## Comparison
+
+Major Domo has a mature CLI at `~/.claude/skills/paper-dynasty/cli.py` (the `paperdomo` command) that handles auth, output formatting, and error handling well. The PD card-creation project has no equivalent.
+
+## Decision / Future Work
+
+Build out a dedicated CLI for PD card-creation API operations:
+- Player queries by cardset, description, name
+- Cardset inspection and validation
+- General API debugging utilities
+
+This should be added to the `pd_cards/` CLI package or as a new standalone skill.
+
+## Tags
+paper-dynasty, cli, tooling, future-work