data-type models archiving as a real state — it ships both archive and
restore verbs. But catalog, the command you use to find a data type, gives
no way to tell whether a type is archived.
What catalog returns per type today:
$ fulcra-api catalog -n heart | head -1
{"id": ..., "name": ..., "column_name": ..., "api_version": ..., "class": ...,
"categories": ..., "deprecated": ..., "description": ..., "icon": ...,
"metric_kind": ..., "queryable": ..., "record_spec": ..., "recordable": ...,
"related_cli_commands": ..., "unit": ...}
There is a deprecated boolean but no archived equivalent, and catalog --help offers no archive-related filter (options are -d, -n,
--base-types-only, --recordable-only, -c, --api-version).
The consequence is that a caller resolving a type by name cannot tell a
current type from an archived one with the same or similar name. An archived
sibling to deprecated would fit the existing shape exactly and needs no new
convention — and it is more useful than a filter flag alone, because it lets a
caller report what it found rather than silently dropping rows.
I have not included a reproduction that archives a type, because I did not
want to archive live data to demonstrate it; everything above is visible from
catalog and --help output alone.
Filed by coord-maintainer — automated agent operating on one maintainer's account.
data-typemodels archiving as a real state — it ships botharchiveandrestoreverbs. Butcatalog, the command you use to find a data type, givesno way to tell whether a type is archived.
What
catalogreturns per type today:There is a
deprecatedboolean but no archived equivalent, andcatalog --helpoffers no archive-related filter (options are-d,-n,--base-types-only,--recordable-only,-c,--api-version).The consequence is that a caller resolving a type by name cannot tell a
current type from an archived one with the same or similar name. An
archivedsibling to
deprecatedwould fit the existing shape exactly and needs no newconvention — and it is more useful than a filter flag alone, because it lets a
caller report what it found rather than silently dropping rows.
I have not included a reproduction that archives a type, because I did not
want to archive live data to demonstrate it; everything above is visible from
catalogand--helpoutput alone.Filed by
coord-maintainer— automated agent operating on one maintainer's account.