Method switch_view

atomic-repository/src/repository/switch.rs:91–300

Switch to a different view and update the working copy. This is the primary method for switching views. It: 1. Validates the view exists 2. Updates the current view pointer 3. Materializes the working copy to match the new view's state # Arguments `view` - The name of the view to switch to # Returns Statistics about the materialize operation (files written, etc.) # Errors Returns an error i

(&mut self, view: &str)

    /// println!("Updated {} files", result.files_written);
    /// ```
    pub fn switch_view(&mut self, view: &str) -> Result<MaterializeResult, RepositoryError> {
        let old_view_name = self.current_view.clone();

        // Compute files visible on the OLD view.
        let old_files = self.visible_file_paths(&old_view_name)?;

        // Apply only the small set of view-scoped TREE operations and publish
        // the new pointer while holding the same database write lock. A marker
        // makes the transition recoverable if the process exits mid-switch.
        let deferred_paths = self.align_deferred_tree_and_publish_view(view)?;

        // Compute files visible on the NEW view.
        let new_files = self.visible_file_paths(view)?;

        if std::env::var_os("ATOMIC_TRACE_SWITCH").is_some() {
            eprintln!("[switch] {} -> {}", old_view_name, view);
            eprintln!(
                "[switch] old_files={} new_files={}",
                old_files.len(),
                new_files.len()
            );
            for f in old_files.difference(&new_files) {
                eprintln!("[switch] REMOVE (old only): {}", f);
            }
            for f in new_files.difference(&old_files) {
                eprintln!("[switch] ADD (new only): {}", f);
            }
        }

        let working_copy = FileSystem::from_root(&self.root);

        // ── Phase 1: Shelve ignored files into the OLD view's workspace ──
        //
        // All ignored files are shelved per-view EXCEPT paths listed in
        // `[workspace] expose` in `.atomic/config.toml`.  Exposed paths
        // persist across all views (tool configs like .opencode/, .vscode/).
        //
        // This uses `rename()` which is O(1) on the same filesystem —
        // no data is copied, just inode pointers are updated.
        //
        // The rule:
        //   - Tracked files      → managed by the graph (phases 2-4)
        //   - Untracked, ignored, exposed  → left alone (persists across views)
        //   - Untracked, ignored, NOT exposed → shelved/restored per-view (phases 1 & 5)
        //   - Untracked, novel   → user's undecided work, left alone
        let old_ws = workspace_path(&self.dot_dir, &old_view_name);
        ensure_workspace_dir(&self.dot_dir, &old_view_name)?;

        let repo_expose = atomic_config::RepoConfig::load(&self.config_path())
            .unwrap_or_default()
            .workspace
            .expose;
        let global_expose = atomic_config::GlobalConfig::load()
            .map(|c| c.workspace.expose)
            .unwrap_or_default();

        // Merge global + repo-local expose patterns (deduplicated)
        let mut expose_patterns = global_expose;