Folder

---

Object Hierarchy:

Description:

Content:

Properties:

• public bool background_recurse { get; set; }
  Whether to use background (idle callback) processing for recursive folder scanning. Default: true (use background processing for better UI responsiveness)
• public FolderFiles children { get; set; }
  List of children (files and subfolders) - used for tree view hierarchy. Implements ListModel interface with add/remove methods.
• public int64 last_check_time { get; set; }
  Last check time for this folder (prevents re-checking during recursive scans).
• public int64 last_viewed { get; set; }
  Unix timestamp of last view (stored in database, default: 0, used for projects).
• public ProjectFiles project_files { get; set; }
  ListStore of all files in project (used by dropdowns).

Creation methods:

• public Folder (ProjectManager manager)
  Constructor.
• public Folder.new_from_info (ProjectManager manager, Folder? parent, FileInfo info, string path)
  Named constructor: Create a Folder from FileInfo.

Methods:

• public ArrayList<Folder> build_roots () throws Error
  Build list of root directories that need write access for bubblewrap sandboxing.
• public void clear_data ()
  Clears all in-memory data for this folder to free memory.
• public void enumerate_directory_contents (File dir, ArrayList<FileBase> new_items) throws Error
  Enumerate directory contents and create FileBase objects for all items found.
• public async void load_files_from_db ()
  Load project files from database.
• public async Folder? make_children (string file_path) throws Error
  Creates child folders recursively until reaching the target file path.
• public string project_description ()
  Project-level description from vector_metadata (ProjectAnalysis). Uses this.manager.db. Caller guarantees manager.db and id are set. When multiple project rows exist (e.g. from repeated --project-summary runs), returns the most recent (highest id).
• public async void read_dir (int64 check_time, bool recurse = false) throws Error
  Load children from filesystem for this folder. Handles async file enumeration, symlink resolution, and updates Folder.children. Excludes .git directories and other hidden/system folders.
• public void refresh_review ()
  Refresh review_files list.
• public override string to_summary (HashMap<int,VectorMetadata> keymap, string indent)

Inherited Members: