Method log

atomic-repository/src/repository/history.rs:36–90

Get a forward history log for the current view. For **draft** views, only changes that are "new" on this view are returned — inherited changes from ancestor views are filtered out. Pass `--all` (via [`HistoryOptions::include_inherited`]) to see the full change log including inherited entries. Returns an iterator over history entries starting from the given sequence number and proceeding forward

(
        &self,
        options: HistoryOptions,
    )

    /// }
    /// ```
    pub fn log(
        &self,
        options: HistoryOptions,
    ) -> Result<Vec<crate::history::HistoryEntry>, RepositoryError> {
        let txn = self
            .pristine
            .read_txn()
            .map_err(|e| RepositoryError::Database(e.to_string()))?;

        let view_name = options.view.as_deref().unwrap_or(&self.current_view);
        let view = txn
            .get_view(view_name)
            .map_err(|e| RepositoryError::Database(e.to_string()))?
            .ok_or_else(|| RepositoryError::ViewNotFound {
                name: view_name.to_string(),
            })?;

        // For draft views, build a set of ancestor change NodeIds so we
        // can filter out inherited entries.  This makes `atomic log` on a
        // draft view show only "what's new" rather than the full history
        // of every ancestor view.
        let ancestor_ids: Option<HashSet<NodeId>> =
            if view.kind.is_draft() && !options.include_inherited {
                Some(Self::collect_ancestor_change_ids(&txn, &view)?)
            } else {
                None
            };

        let iter = crate::history::log(&txn, &view, &options)
            .map_err(|e| RepositoryError::Database(e.to_string()))?;

        // Collect entries, loading headers if requested
        let mut entries = Vec::new();
        for result in iter {
            let mut entry = result.map_err(|e| RepositoryError::Database(e.to_string()))?;

            // Skip inherited entries on draft views
            if let Some(ref ids) = ancestor_ids {
                if ids.contains(&entry.node_id) {
                    continue;
                }
            }

            // Load header if requested
            if options.load_headers {
                if let Ok(change) = self.load_change(&entry.hash) {
                    entry = entry.with_change_header(change.hashed.header.clone());
                }
            }

            entries.push(entry);
        }

        Ok(entries)
    }

    /// Get the full **effective** change set of a view in dependency order.
    ///