37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
---
|
|
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
|