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.