;; Title: Miniforge.ai
;; Subtitle: An agentic SDLC / fleet-control platform
;; Author: Christopher Lester
;; Line: Founder, Miniforge.ai (project)
;; Copyright 2025-2026 Christopher Lester (christopher@miniforge.ai)
;;
;; Licensed under the Apache License, Version 2.0 (the "License");
;; you may not use this file except in compliance with the License.
;; You may obtain a copy of the License at
;;
;;     http://www.apache.org/licenses/LICENSE-2.0
;;
;; Unless required by applicable law or agreed to in writing, software
;; distributed under the License is distributed on an "AS IS" BASIS,
;; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
;; See the License for the specific language governing permissions and
;; limitations under the License.

(ns ai.miniforge.algorithms.interface
  "Public API for miniforge algorithms component.

   Provides canonical implementations of common algorithms used across
   miniforge components, including graph traversal and data structures."
  (:require
   [ai.miniforge.algorithms.graph :as graph]))

;------------------------------------------------------------------------------ Graph Algorithms

(def dfs
  "Simple canonical depth-first search traversal.

   See ai.miniforge.algorithms.graph/dfs for full documentation."
  graph/dfs)

(def dfs-find
  "Find first node matching a predicate using DFS.

   See ai.miniforge.algorithms.graph/dfs-find for full documentation."
  graph/dfs-find)

(def dfs-validate-graph
  "Validate graph structure (cycles, missing nodes) using DFS.

   See ai.miniforge.algorithms.graph/dfs-validate-graph for full documentation."
  graph/dfs-validate-graph)

(def dfs-collect
  "Collect all values from DFS traversal.

   See ai.miniforge.algorithms.graph/dfs-collect for full documentation."
  graph/dfs-collect)
