Catalog facts for agent memory

[bradhe]

This PR integrates catalog facts from the API into the CLI to give agents memory about data stored in a catalog. This is just an experimental feature to see how it improves (or not) workloads.

Example

╰─$ cargo run -- catalogs facts set soft-delete --statement "deleted_at means that an element was soft deleted" --scope column --object bronze.runs.deleted_at --confidence confirmed --source human
Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.46s
Running `target/debug/tower catalogs facts set soft-delete --statement 'deleted_at means that an element was soft deleted' --scope column --object bronze.runs.deleted_at --confidence confirmed --source human`
error: the following required arguments were not provided:
<fact_name>
Usage: tower catalogs facts set --statement <statement> --scope <scope> --object <object> --confidence <confidence> --source <source> <catalog_name> <fact_name>
For more information, try '--help'.
$ cargo run -- catalogs facts set default runs-soft-delete --statement "deleted_at means that an element was soft deleted" --scope column --object bronze.runs.deleted_at --confidence confirmed --source human ✔ Saving fact... Done!
Success! Fact 'runs-soft-delete' saved in catalog 'default'
$ cargo run -- catalogs facts list default
✔ Listing facts... Done!
Name Scope Object Confidence Statement -----------------------------------------------------------------------------------------------------------------
runs-soft-delete column bronze.runs.deleted_at confirmed deleted_at means that an element was soft deleted error: unexpected argument '-f' found
tip: to pass '-f' as a value, use '-- -f'
Usage: tower catalogs facts list [OPTIONS] <catalog_name>
For more information, try '--help'.
$ cargo run -- catalogs facts list default -j
[
{
"confidence": "confirmed",
"created_at": "2026-07-22T15:08:32.817697Z",
"name": "runs-soft-delete",
"object": "bronze.runs.deleted_at",
"scope": "column",
"source": "human",
"statement": "deleted_at means that an element was soft deleted",
"updated_at": "2026-07-22T15:08:32.817697Z"
}
]

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 982bee0e-58b7-42a1-8c32-4cc36f83071f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch features/catalog-facts

---

_{Comment @coderabbitai help to get the list of available commands.}

[sammuti]

facts has a specific meaning when it comes to data analytics so I would presume this command name is confusing to both humans(like me :D) and ai. Perhaps a better name is meta or ai-context

[bradhe]

Yeah maybe we want to disambiguate this from fact tables in a data warehousing context. I'll take a quick look at this.