From 26b021cf512a15e601779409ae902a08c3457099 Mon Sep 17 00:00:00 2001 From: Cal Corum Date: Sun, 22 Feb 2026 09:44:17 -0600 Subject: [PATCH] store: Paper Dynasty card-creation needs a dedicated API query CLI tool --- ...-needs-a-dedicated-api-query-cli-78c597.md | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 graph/decisions/paper-dynasty-card-creation-needs-a-dedicated-api-query-cli-78c597.md diff --git a/graph/decisions/paper-dynasty-card-creation-needs-a-dedicated-api-query-cli-78c597.md b/graph/decisions/paper-dynasty-card-creation-needs-a-dedicated-api-query-cli-78c597.md new file mode 100644 index 00000000000..d07311fccdf --- /dev/null +++ b/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