uml-viewer 0.1.0

data/lib/uml/viewer/web/index.html

@@ -0,0 +1,65 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>uml-viewer</title>
+<style>
+  :root { --bg: #f7f7f4; --fg: #1d2021; --box: #ffffff; --line: #6b7075; --red: #c0392b; --muted: #8a8f94; --hl: #fff3c4; --grade-l: 86%; }
+  @media (prefers-color-scheme: dark) { :root { --bg: #1b1d1f; --fg: #e6e6e3; --box: #26292c; --line: #9aa0a6; --red: #ff6b5b; --muted: #7b8186; --hl: #4a4020; --grade-l: 30%; } }
+  [hidden] { display: none !important; }
+  html, body { margin: 0; height: 100%; background: var(--bg); color: var(--fg); font: 13px/1.3 ui-monospace, Menlo, monospace; }
+  #bar { position: fixed; top: 0; left: 0; right: 0; display: flex; gap: 16px; align-items: center; padding: 8px 12px; background: var(--bg); border-bottom: 1px solid var(--line); z-index: 2; }
+  #crumbs { display: flex; gap: 4px; }
+  button.crumb { font: inherit; font-weight: bold; background: none; color: var(--fg); border: 0; padding: 0; cursor: pointer; }
+  button.crumb:disabled { cursor: default; }
+  button.crumb + button.crumb::before { content: "› "; color: var(--muted); font-weight: normal; }
+  #banner { color: var(--red); }
+  #banner:empty { display: none; }
+  svg { position: absolute; top: 36px; left: 0; }
+  g.box rect, g.box ellipse { fill: var(--box); stroke: var(--line); }
+  g.box.foreign ellipse { stroke-dasharray: 4 3; }
+  g.box.folder text.title { font-style: italic; }
+  g.box.component rect { stroke-width: 2; }
+  text { fill: var(--fg); }
+  text.level, text.more { fill: var(--muted); }
+  path.arrow { fill: none; stroke: var(--line); stroke-width: 1.2; marker-end: url(#head); }
+  path.arrow.violating { stroke: var(--red); marker-end: url(#head-red); }
+  path.arrow.both { marker-start: url(#head); }
+  path.arrow.both.violating { marker-start: url(#head-red); }
+  svg.triangles path.arrow { stroke: transparent; }
+  text.note { fill: var(--muted); }
+  #menu { position: fixed; display: none; flex-direction: column; background: var(--box); border: 1px solid var(--line); z-index: 3; }
+  #menu.open { display: flex; }
+  #menu button { font: inherit; background: none; color: var(--fg); border: 0; padding: 6px 14px; text-align: left; cursor: pointer; }
+  #toast { position: fixed; bottom: 12px; left: 12px; color: var(--red); }
+  #regen, #propose, #proposal, #declutter { font: inherit; background: none; color: var(--fg); border: 1px solid var(--line); border-radius: 3px; padding: 2px 8px; cursor: pointer; }
+  aside { position: fixed; top: 36px; bottom: 0; overflow: auto; background: var(--box); border-left: 1px solid var(--line); padding: 8px 12px; z-index: 2; }
+  aside h2 { font-size: 14px; margin: 4px 0 8px; }
+  #card { right: 0; width: 360px; }
+  #source { right: 385px; width: min(720px, 50vw); }
+  #card .error { color: var(--red); }
+  #card .note, #card .file { color: var(--muted); }
+  #card ul { padding: 0; }
+  li.op { list-style: none; cursor: pointer; white-space: pre; }
+  li.op:hover { text-decoration: underline; }
+  #source pre { margin: 0; }
+  .line { white-space: pre; }
+  .line.current { background: var(--hl); }
+  #popup { position: fixed; background: var(--box); border: 1px solid var(--line); padding: 6px 8px; z-index: 3; pointer-events: none; }
+  #popup .violating { color: var(--red); }
+  path.hit { fill: none; stroke: transparent; stroke-width: 10; }
+  circle.dot { stroke: var(--line); stroke-width: 0.5; }
+</style>
+</head>
+<body>
+<div id="bar"><span id="crumbs"></span><select id="proposal" aria-label="diagram"></select><button id="propose">New proposal</button><button id="regen">Regen</button><button id="declutter">declutter: none</button><span id="status"></span><span id="banner"></span></div>
+<svg id="diagram"></svg>
+<div id="menu"><button data-op="explain">Explain</button><button data-op="omit">Omit</button></div>
+<div id="toast"></div>
+<aside id="card" hidden></aside>
+<aside id="source" hidden></aside>
+<div id="popup" hidden></div>
+<script src="/elk.js"></script>
+<script src="/app.js"></script>
+</body>
+</html>

data/lib/uml/viewer/workspace.rb

@@ -0,0 +1,75 @@
+require "digest"
+require "fileutils"
+require "json"
+require "socket"
+
+module Uml
+  module Viewer
+    class Workspace
+      class MissingProject < StandardError; end
+
+      attr_reader :root, :dir
+
+      def self.home
+        File.expand_path(ENV.fetch("UML_VIEWER_HOME") { File.join(Dir.home, ".uml-viewer") })
+      end
+
+      def self.pid_alive?(pid)
+        pid = Integer(pid)
+        return false unless pid.positive?
+
+        Process.kill(0, pid)
+        true
+      rescue Errno::ESRCH, ArgumentError, TypeError
+        false
+      rescue Errno::EPERM
+        true
+      end
+
+      def self.port_open?(port)
+        Socket.tcp("127.0.0.1", Integer(port), connect_timeout: 0.5).close
+        true
+      rescue SystemCallError, SocketError, ArgumentError, TypeError
+        false
+      end
+
+      def initialize(project_path)
+        raise MissingProject, "no such project folder: #{project_path}" unless File.directory?(project_path)
+
+        @root = File.realpath(project_path)
+        digest = Digest::SHA256.hexdigest(@root)[0, 8]
+        @dir = File.join(self.class.home, "projects", "#{File.basename(@root)}-#{digest}")
+        FileUtils.mkdir_p(@dir, mode: 0o700)
+        File.chmod(0o700, @dir)
+      end
+
+      def path(name)
+        File.join(@dir, name)
+      end
+
+      def write_atomic(name, string)
+        target = path(name)
+        temp = "#{target}.#{Process.pid}.#{Thread.current.object_id}.tmp"
+        File.open(temp, File::WRONLY | File::CREAT | File::TRUNC, 0o600) { |file| file.write(string) }
+        File.rename(temp, target)
+      end
+
+      def read_json(name, default)
+        JSON.parse(File.read(path(name)))
+      rescue Errno::ENOENT
+        default
+      end
+
+      def server_info
+        read_json("server.json", nil)
+      rescue JSON::ParserError
+        nil
+      end
+
+      def server_alive?
+        info = server_info
+        info.is_a?(Hash) && self.class.pid_alive?(info["pid"]) && self.class.port_open?(info["port"])
+      end
+    end
+  end
+end

data/lib/uml/viewer.rb

@@ -0,0 +1,23 @@
+require_relative "viewer/version"
+require_relative "viewer/workspace"
+require_relative "viewer/resolver"
+require_relative "viewer/complexity"
+require_relative "viewer/operations"
+require_relative "viewer/inflector"
+require_relative "viewer/scanner"
+require_relative "viewer/policy_file"
+require_relative "viewer/policy_init"
+require_relative "viewer/policy"
+require_relative "viewer/views"
+require_relative "viewer/proposals"
+require_relative "viewer/coverage"
+require_relative "viewer/overlay"
+require_relative "viewer/graph"
+require_relative "viewer/mailbox"
+require_relative "viewer/watcher"
+require_relative "viewer/commands"
+require_relative "viewer/rescanner"
+require_relative "viewer/server"
+require_relative "viewer/skill_installer"
+require_relative "viewer/smoke"
+require_relative "viewer/cli"

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: uml-viewer
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Robert Hopman
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prism
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+description: uml-viewer scans a Ruby or Rails project with Prism and shows it as a
+  UML diagram in the browser. Red arrows show dependencies that break the Dependency
+  Rule between Rails layers. Box colors show CRAP from a SimpleCov run. A right-click
+  sends a command to a Claude Code session, which explains the code, changes the policy
+  or writes a proposal. Nothing is written into the viewed project.
+executables:
+- uml-viewer
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- exe/uml-viewer
+- lib/uml/viewer.rb
+- lib/uml/viewer/cli.rb
+- lib/uml/viewer/commands.rb
+- lib/uml/viewer/complexity.rb
+- lib/uml/viewer/coverage.rb
+- lib/uml/viewer/graph.rb
+- lib/uml/viewer/inflector.rb
+- lib/uml/viewer/mailbox.rb
+- lib/uml/viewer/operations.rb
+- lib/uml/viewer/overlay.rb
+- lib/uml/viewer/policy.rb
+- lib/uml/viewer/policy_file.rb
+- lib/uml/viewer/policy_init.rb
+- lib/uml/viewer/proposals.rb
+- lib/uml/viewer/rescanner.rb
+- lib/uml/viewer/resolver.rb
+- lib/uml/viewer/scanner.rb
+- lib/uml/viewer/server.rb
+- lib/uml/viewer/skill/SKILL.md.erb
+- lib/uml/viewer/skill_installer.rb
+- lib/uml/viewer/smoke.rb
+- lib/uml/viewer/version.rb
+- lib/uml/viewer/views.rb
+- lib/uml/viewer/watcher.rb
+- lib/uml/viewer/web/LICENSE-EPL-2.0
+- lib/uml/viewer/web/app.js
+- lib/uml/viewer/web/elk.bundled.js
+- lib/uml/viewer/web/index.html
+- lib/uml/viewer/workspace.rb
+homepage: https://github.com/roberthopman/uml-viewer
+licenses:
+- MIT
+- EPL-2.0
+metadata:
+  source_code_uri: https://github.com/roberthopman/uml-viewer
+  changelog_uri: https://github.com/roberthopman/uml-viewer/blob/main/CHANGELOG.md
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: A live UML diagram of a Ruby or Rails project in the browser, with a Claude
+  Code agent loop.
+test_files: []