Source command

[danielrothmann]

This PR introduced as new CLI command that I thought would be useful when working with agents. Commonly, an agent will successfully query data about entities, but if those are then to be edited, a workspace-wide grep needs to be performed to find the source file to edit.

firm source helps this process along by explicitly getting the source file path for a given entity or schema. This helps reduce ambiguity when combining CLI and raw-DSL workflows.

We achieve this in a simple way by searching parsed DSL from the workspace. This can be achieved before workspace + graph is built. So long as workspaces aren't huge, I'm thinking this is performant enough for a one-off without mixing concerns by storing source paths in internal data models.

Reference:

firm source <target_type> <target_id>

Arguments:

• target_type - Entity type (e.g., person, organization) or schema
• target_id - Entity ID or schema name

Examples:

# Find where a person entity is defined
firm source person john_doe

# Find where an organization is defined
firm source organization acme_corp

# Find where a schema is defined
firm source schema project