FAQ / Troubleshooting

Why are my assets not creating relationships automatically? Make sure the column header exactly matches the target CSV filename. If you want a different relation type or target, use the explicit [[retype_relation]] directive in a model.

Why is an automatic relationship forming when I don’t want it to? Auto-linking runs if a property name matches a known resource type. If you want to prevent this, prefix the property name with an underscore (_) in your CSV header or model property.

My numeric values are acting like floats instead of strings. Rescile auto-converts values like “true” to booleans and “1.0” to floats. If you need them to stay strings (like a version number), prefix the CSV column header or the model property name with a tilde (~).

How do I view orphaned resources? Run the rescile-ce binary without --remove-orphaned-assets. Orphans will appear in the graph, usually resulting from CSV rows that were never linked by models.

Why is my match_on condition failing for complex JSON? Ensure you are using the expression operator with the jmespath filter. Simple value checks do not deeply parse JSON objects.

I updated my asset but the graph didn’t update in the UI. By default, rescile-ce serve watches local files and hot-reloads. If you modify a remote module’s git repo, you must restart or pull the latest changes.

How should I handle secrets or passwords in the graph? Cryptographic material and secrets should not be stored as plaintext properties in your assets or models. Instead, Rescile promotes a Graph-Native Secrets Architecture. You should create logical secret nodes and link them to vault nodes using a STORED_IN edge. Your generated output artifacts (like shell scripts or Terraform) can then query the graph for the vault path and fetch the secret securely at execution time. See the Secrets Architecture reference for examples.