dlin-cli 0.1.0__tar.gz → 0.1.1__tar.gz

dlin_cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.1] - 2026-03-30
+
+### Features
+
+- Add `--collapse=focal` mode for BFS-aware lineage simplification, and preserve focus models during collapse (#22, #23)
+
+## [0.1.0] - 2026-03-28
+
+Initial release of **dlin**.

{dlin_cli-0.1.0 → dlin_cli-0.1.1}/Cargo.lock

@@ -231,7 +231,7 @@ checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
 
 [[package]]
 name = "dlin"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "clap",

{dlin_cli-0.1.0 → dlin_cli-0.1.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dlin"
-version = "0.1.0"
+version = "0.1.1"
 edition = "2024"
 description = "A fast CLI tool for dbt model lineage analysis"
 license = "MIT"

{dlin_cli-0.1.0 → dlin_cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dlin-cli
-Version: 0.1.0
+Version: 0.1.1
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -87,6 +87,30 @@ dlin list -o json --json-fields unique_id,file_path
 git diff --name-only main | dlin graph -o json
 ```
 
+## AI agent integration
+
+No MCP server or tool configuration needed.
+Just install dlin and add the following to your `AGENTS.md`, `CLAUDE.md`, or system prompt:
+
+````md
+## dbt project structure analysis
+
+Use `dlin` to explore dbt model dependencies.
+Do NOT grep/cat/find through SQL files.
+
+```bash
+dlin summary                                           # Project overview (start here)
+dlin graph <model> -u 2 -d 1 -q                        # Upstream/downstream lineage
+dlin impact <model>                                    # Downstream impact with severity
+dlin list -o json --json-fields unique_id,sql_content  # Read SQL content
+git diff --name-only main | dlin graph -q              # Lineage of changed files
+```
+
+For full option reference: `dlin --help`, `dlin graph --help`, etc.
+````
+
+The key line is **"Do NOT grep/cat/find through SQL files"** — without it, agents default to familiar tools. `dlin --help` is designed for tool discovery, so the prompt can stay minimal.
+
 ## Features
 
 - **No dependencies**: single binary, no Python, no `manifest.json`
@@ -101,11 +125,15 @@ dlin outputs Mermaid flowcharts that render natively on GitHub, GitLab, Notion,
 
 ### Simplified graphs with `--collapse`
 
-Automatically remove intermediate nodes to see just the endpoints — sources, leaf models, and exposures are kept; everything in between becomes transitive "(via N)" edges:
+Automatically remove intermediate nodes to see just the endpoints (nodes with no predecessors or no successors); everything in between becomes transitive "(via N)" edges:
 
 ```sh
 # Collapse intermediate models — only endpoints remain
 dlin graph --collapse -o mermaid
+
+# Focal mode: keep only sources, exposures, and specified focus models
+# (ignores BFS window pseudo-endpoints — ideal with -u/-d limits)
+dlin graph orders --collapse=focal -u 3 -o mermaid
 ```
 
 ```mermaid
@@ -135,7 +163,7 @@ flowchart LR
     class source_raw_payments source
 ```
 
-Combine with `--group-by` to collapse per group instead of globally — for example, `--collapse --group-by directory` keeps the entry/exit models of each directory.
+Positional focus models are always preserved during collapse, so `dlin graph orders --collapse` keeps `orders` even if it would otherwise be intermediate.
 
 ### Pipe to build focused diagrams
 
@@ -213,8 +241,8 @@ Combines well with `--collapse` to show rich detail on fewer endpoint nodes.
 
 ```sh
 dlin graph orders -u 2 -d 1                            # focus on specific model
-dlin graph -o mermaid --collapse --group-by node-type  # collapse per node type layer
 dlin graph -o mermaid --collapse --show-columns        # columns in collapsed nodes
+dlin graph orders --collapse=focal -u 3 -o mermaid    # focal: sources + exposures + orders
 dlin graph -o mermaid --group-by directory             # group by directory
 dlin graph -o mermaid --direction tb                   # top-to-bottom layout
 dlin graph --node-type source,exposure                 # filter by node type

{dlin_cli-0.1.0 → dlin_cli-0.1.1}/README.md

@@ -65,6 +65,30 @@ dlin list -o json --json-fields unique_id,file_path
 git diff --name-only main | dlin graph -o json
 ```
 
+## AI agent integration
+
+No MCP server or tool configuration needed.
+Just install dlin and add the following to your `AGENTS.md`, `CLAUDE.md`, or system prompt:
+
+````md
+## dbt project structure analysis
+
+Use `dlin` to explore dbt model dependencies.
+Do NOT grep/cat/find through SQL files.
+
+```bash
+dlin summary                                           # Project overview (start here)
+dlin graph <model> -u 2 -d 1 -q                        # Upstream/downstream lineage
+dlin impact <model>                                    # Downstream impact with severity
+dlin list -o json --json-fields unique_id,sql_content  # Read SQL content
+git diff --name-only main | dlin graph -q              # Lineage of changed files
+```
+
+For full option reference: `dlin --help`, `dlin graph --help`, etc.
+````
+
+The key line is **"Do NOT grep/cat/find through SQL files"** — without it, agents default to familiar tools. `dlin --help` is designed for tool discovery, so the prompt can stay minimal.
+
 ## Features
 
 - **No dependencies**: single binary, no Python, no `manifest.json`
@@ -79,11 +103,15 @@ dlin outputs Mermaid flowcharts that render natively on GitHub, GitLab, Notion,
 
 ### Simplified graphs with `--collapse`
 
-Automatically remove intermediate nodes to see just the endpoints — sources, leaf models, and exposures are kept; everything in between becomes transitive "(via N)" edges:
+Automatically remove intermediate nodes to see just the endpoints (nodes with no predecessors or no successors); everything in between becomes transitive "(via N)" edges:
 
 ```sh
 # Collapse intermediate models — only endpoints remain
 dlin graph --collapse -o mermaid
+
+# Focal mode: keep only sources, exposures, and specified focus models
+# (ignores BFS window pseudo-endpoints — ideal with -u/-d limits)
+dlin graph orders --collapse=focal -u 3 -o mermaid
 ```
 
 ```mermaid
@@ -113,7 +141,7 @@ flowchart LR
     class source_raw_payments source
 ```
 
-Combine with `--group-by` to collapse per group instead of globally — for example, `--collapse --group-by directory` keeps the entry/exit models of each directory.
+Positional focus models are always preserved during collapse, so `dlin graph orders --collapse` keeps `orders` even if it would otherwise be intermediate.
 
 ### Pipe to build focused diagrams
 
@@ -191,8 +219,8 @@ Combines well with `--collapse` to show rich detail on fewer endpoint nodes.
 
 ```sh
 dlin graph orders -u 2 -d 1                            # focus on specific model
-dlin graph -o mermaid --collapse --group-by node-type  # collapse per node type layer
 dlin graph -o mermaid --collapse --show-columns        # columns in collapsed nodes
+dlin graph orders --collapse=focal -u 3 -o mermaid    # focal: sources + exposures + orders
 dlin graph -o mermaid --group-by directory             # group by directory
 dlin graph -o mermaid --direction tb                   # top-to-bottom layout
 dlin graph --node-type source,exposure                 # filter by node type

{dlin_cli-0.1.0 → dlin_cli-0.1.1}/src/cli.rs

@@ -68,6 +68,14 @@ pub struct Cli {
     pub command: Command,
 }
 
+#[derive(Debug, Clone, Copy, PartialEq, Eq, clap::ValueEnum)]
+pub enum CollapseMode {
+    /// Keep topological endpoints (in-degree=0 or out-degree=0) and focus models
+    Endpoints,
+    /// Keep only source/exposure nodes and focus models (ignores BFS window boundaries)
+    Focal,
+}
+
 #[derive(Debug, Clone, Copy, PartialEq, Eq, clap::ValueEnum)]
 pub enum GroupBy {
     /// Group nodes by node type (source, model, test, etc.)
@@ -202,6 +210,11 @@ Examples:
   dlin graph -o dot | dot -Tsvg > lineage.svg
   dlin graph -o mermaid --direction tb   # top-to-bottom layout
 
+  # === Collapse (simplify by removing intermediate nodes) ===
+  dlin graph --collapse                              # keep only graph endpoints
+  dlin graph orders --collapse                       # endpoints + orders preserved
+  dlin graph orders --collapse=focal -u 3            # sources + exposures + orders only
+
   # === Column display (mermaid only) ===
   dlin graph -o mermaid --show-columns              # show columns in node labels
   dlin graph -o mermaid --collapse --show-columns    # rich detail on fewer nodes"
@@ -261,18 +274,24 @@ pub struct GraphArgs {
     #[arg(long)]
     pub no_transitive: bool,
 
-    /// Collapse intermediate nodes, keeping only endpoints (nodes with no
-    /// predecessors or no successors). Removed nodes are replaced by transitive
-    /// edges with collapsed_through metadata (shown as "(via N)" in DOT/Mermaid).
-    /// When combined with --group-by, endpoints are determined per group: a node
-    /// is kept if it connects to a node outside its group, or has no
-    /// predecessors/successors within its group.
-    /// Without --group-by, global graph endpoints are kept.
-    /// Tip: with --source manifest, tests may appear as downstream endpoints;
-    /// combine with --node-type to exclude them if needed.
+    /// Collapse intermediate nodes, replacing them with transitive edges
+    /// shown as "(via N)" in DOT/Mermaid output.
+    ///
+    /// Without a value (--collapse), defaults to "endpoints" mode: keeps
+    /// nodes with no predecessors or no successors, plus focus models.
+    ///
+    /// With --collapse=focal: keeps only source/exposure nodes and focus
+    /// models as endpoints. Endpoint selection ignores BFS window boundaries
+    /// (-u/-d), so window-edge nodes are not treated as pseudo-endpoints,
+    /// but traversal still respects the -u/-d limits.
+    ///
+    /// Focus models are preserved even if they would otherwise be intermediate,
+    /// as long as they are not removed earlier by filters like --select or
+    /// --node-type.
+    ///
     /// Ignored when --no-transitive is set.
-    #[arg(long)]
-    pub collapse: bool,
+    #[arg(long, value_name = "MODE", default_missing_value = "endpoints", num_args = 0..=1, require_equals = true)]
+    pub collapse: Option<CollapseMode>,
 
     /// Group nodes using subgraph/cluster blocks in supported formats (dot, mermaid).
     /// Supported values: node-type (group by source, model, test, etc.),
@@ -1182,4 +1201,47 @@ mod tests {
             Cli::try_parse_from(["dlin", "--error-format", "json", "impact", "orders"]).unwrap();
         assert_eq!(cli.error_format, ErrorFormat::Json);
     }
+
+    // -- Collapse CLI parsing tests -------------------------------------------
+
+    #[test]
+    fn test_collapse_none_by_default() {
+        let args = unwrap_graph(Cli::try_parse_from(["dlin", "graph"]).unwrap());
+        assert_eq!(args.collapse, None);
+    }
+
+    #[test]
+    fn test_collapse_bare_defaults_to_endpoints() {
+        let args = unwrap_graph(Cli::try_parse_from(["dlin", "graph", "--collapse"]).unwrap());
+        assert_eq!(args.collapse, Some(CollapseMode::Endpoints));
+    }
+
+    #[test]
+    fn test_collapse_explicit_endpoints() {
+        let args =
+            unwrap_graph(Cli::try_parse_from(["dlin", "graph", "--collapse=endpoints"]).unwrap());
+        assert_eq!(args.collapse, Some(CollapseMode::Endpoints));
+    }
+
+    #[test]
+    fn test_collapse_focal() {
+        let args =
+            unwrap_graph(Cli::try_parse_from(["dlin", "graph", "--collapse=focal"]).unwrap());
+        assert_eq!(args.collapse, Some(CollapseMode::Focal));
+    }
+
+    #[test]
+    fn test_collapse_invalid_mode_rejected() {
+        let result = Cli::try_parse_from(["dlin", "graph", "--collapse=invalid"]);
+        assert!(result.is_err());
+    }
+
+    #[test]
+    fn test_collapse_bare_does_not_consume_model() {
+        // --collapse without = must not swallow the next positional as MODE
+        let args =
+            unwrap_graph(Cli::try_parse_from(["dlin", "graph", "--collapse", "orders"]).unwrap());
+        assert_eq!(args.collapse, Some(CollapseMode::Endpoints));
+        assert_eq!(args.model, vec!["orders".to_string()]);
+    }
 }