kaskd-lens 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7699bcfbc18ea24e9db3f80adf099bc040674f5dcf2de4fdb3e5402f391beb0c
+  data.tar.gz: 477d4077c3a789d13c2298c6ec154de1460699f786d4b07c2ce588c206f4828d
+SHA512:
+  metadata.gz: b1f5438b8e83a46ee3de71fe7bf7cb110637b47ea5a1782f26a84a5de8a8cc60af4777e2d94114781df561214bfdf2281b1fb56a05cb2992c98e270b03a3243d
+  data.tar.gz: 54d4a3ff6ce7cf163ecc9b9c2a9eaaa7f69309c3a3069ad0702b0a2b598d73c62b675a7437a932774e0a33954d5c9e418142232e5c54c1213e703be6b3b993ed

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nildiert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,66 @@
+# kaskd-lens
+
+Interactive HTML viewer for [kaskd](https://github.com/nildiert/kaskd) service dependency graphs.
+
+Generates a self-contained HTML page that visualizes the service dependency graph produced by the `kaskd` gem. Features include:
+
+- **vis.js interactive graph** with hierarchical layout
+- **Blast radius** badge showing affected service count
+- **Depth slider** to control BFS traversal depth (1-6)
+- **Sidebar** with search and pack filtering
+- **Detail overlay** with Affected/Dependencies/Info tabs
+- **Path tracing** showing how services are connected
+- **Dark/light themes** with localStorage persistence
+- **Copy diagram** to clipboard as PNG
+- **Export JSON** dependency report
+- **Navigation history** (back/forward)
+- **No external dependencies** — vis-network.js is vendored and inlined
+
+## Installation
+
+```ruby
+gem 'kaskd-lens'
+```
+
+## Usage
+
+### Generate a standalone HTML file
+
+```ruby
+require 'kaskd-lens'
+
+# Analyze current directory and write report
+path = Kaskd::Lens.generate_html
+# => "kaskd-report.html"
+
+# Specify project root and output path
+path = Kaskd::Lens.generate_html(root: "/path/to/project", output: "/tmp/graph.html")
+```
+
+### Generate and open in browser
+
+```ruby
+Kaskd::Lens.open_viewer
+Kaskd::Lens.open_viewer(root: "/path/to/project")
+```
+
+### Start a local HTTP server
+
+```ruby
+Kaskd::Lens.serve
+Kaskd::Lens.serve(root: "/path/to/project", port: 8080)
+```
+
+### Programmatic usage
+
+```ruby
+require 'kaskd-lens'
+
+result = Kaskd.analyze(root: "/path/to/project")
+html   = Kaskd::Lens::HtmlReport.new(result).render
+File.write("my-report.html", html)
+```
+
+## License
+
+MIT