# Spec reference: docs/specification.md ~lines 10133-10143, 24548-24632
schema_version: "1.0"
name: file
description: "Cross-layer file identity linking equivalent physical files"
resource_kind: virtual
sandbox_strategy: none
user_addable: false
built_in: true
cli_args: []
parent_types: []
child_types: ["fs-file", "git-tree-entry"]
capabilities:
  read: false
  write: false
  sandbox: false
  checkpoint: false
equivalence:
  criteria:
    - content_hash
    - filename
    - permissions
  description: "Two physical resources are equivalent when they share the same content bytes (SHA-256), filename, and permissions"
handler: null
