Skip to content

catalog should expose an archived field alongside deprecated #89

Description

@ashfulcra

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions