File Operations Blueprint

Cross-platform file reading and writing

   
Feature file-operations
Category Data
Version 1.0.0
Tags data, godot
YAML Source View on GitHub
JSON API file-operations.json

Actors

ID Name Type Description
game_engine Godot Engine system  

Rules

  • implementation:
    • description: Feature implemented in C++ engine core
  • platform_agnostic:
    • description: Works across desktop, web, mobile platforms

Outcomes

File_reading (Priority: 1)

Given:

  • Read file contents as string or bytes is requested

Then:

  • transition_state field: status from: idle to: active

Result: Read file contents as string or bytes completed

File_writing (Priority: 2)

Given:

  • Write data to file with overwrite protection is requested

Then:

  • transition_state field: status from: idle to: active

Result: Write data to file with overwrite protection completed

File_existence (Priority: 3)

Given:

  • Check if file exists is requested

Then:

  • transition_state field: status from: idle to: active

Result: Check if file exists completed

File_deletion (Priority: 4)

Given:

  • Delete file from disk is requested

Then:

  • transition_state field: status from: idle to: active

Result: Delete file from disk completed

File_properties (Priority: 5)

Given:

  • Get file size and modification time is requested

Then:

  • transition_state field: status from: idle to: active

Result: Get file size and modification time completed

AGI Readiness

Goals

Reliable File Operations

Cross-platform file reading and writing

Success Metrics:

Metric Target Measurement
data_accuracy 100% Records matching source of truth
duplicate_rate 0% Duplicate records detected post-creation

Constraints:

  • performance (non-negotiable): Data consistency must be maintained across concurrent operations

Autonomy

Level: supervised

Tradeoffs

Prefer Over Reason
data_integrity performance data consistency must be maintained across all operations

Safety

Action Permission Cooldown Max Auto
file_reading autonomous - -
file_writing autonomous - -
file_existence autonomous - -
file_deletion human_required - -
file_properties autonomous - -
Extensions (framework-specific hints) ```yaml tech_stack: language: C++ runtime: Godot 4.x ```