archimate 1.1.0

data/TODOs.org

@@ -0,0 +1,286 @@
+* ArchiMate Tools TODO
+
+** SVG Rendering
+
+*** DONE skip bendpoints inside source or target
+    CLOSED: [2017-02-01 Wed 12:41]
+*** DONE badges for device, node, service (cosmetic)
+    CLOSED: [2017-02-01 Wed 12:41]
+*** DONE trim space around diagram names (cosmetic)
+    CLOSED: [2017-02-01 Wed 12:42]
+*** DONE badge position updates (cosmetic, legibility)
+    CLOSED: [2017-02-01 Wed 12:42]
+*** DONE badge updates (cosmetic)
+    CLOSED: [2017-02-01 Wed 12:42]
+*** DONE verify junctions
+    CLOSED: [2017-02-01 Wed 12:42]
+*** DONE alternate figures (curved vs box & badge) selected by type="1" on Child (legibility)
+    CLOSED: [2017-02-01 Wed 12:42]
+*** DONE text bounds in entities (cosmetic, legibility)
+    CLOSED: [2017-02-01 Wed 12:42]
+*** DONE badge spacer settings (cosmetic, legibility) - artifact needs work.
+    CLOSED: [2017-02-01 Wed 12:42]
+*** TODO text on lines (cosmetic, legibility)
+*** TODO bendpoint curves (cosmetic)
+*** TODO line crossing hops (cosmetic)
+*** DONE refactor
+    CLOSED: [2017-02-01 Wed 12:42]
+
+** Performance
+
+*** TODO Look into using Celluloid and/or jruby to improve performance
+          Thinking about concurrency for performance improvements
+
+          read base
+          read local
+          read remote
+
+          base + local -> diff l
+          base + remote -> diff b
+
+          diff l + diff b -> conflict detection
+
+          cd -> each conflict type
+
+          conflicts -> conflict resolution
+
+          cr (user response)
+
+          serialize result (single)
+
+
+** Diff/Merge
+
+*** Conflicts can happen on the same diff 2x. How to handle this?
+*** DONE In `Change.to_s` - deref args that point to other elements (like archimate_element)
+    CLOSED: [2017-02-01 Wed 12:48]
+*** In Diagram children diffs - make to_s reference the parent diagram
+*** DONE Array diffs on non-id'd diffable elements should detect changes rather than delete/insert
+    CLOSED: [2017-02-01 Wed 12:48]
+*** Archi file could have ids that conflict (i.e. 2 relationships with same id - this is bad!!! Was it a bad merge or something worse)
+*** Implement check for de-duplicated merges
+*** DONE Add a summary diff - elements added/changed/deleted, diagrams
+    CLOSED: [2017-02-01 Wed 12:48]
+
+** Lint
+
+*** DONE Basic Lint features (matching Archi)
+    CLOSED: [2017-02-01 Wed 12:49]
+*** TODO Scorecard lint
+
+** File Formats & Exports
+
+*** TODO Convert support for
+**** TODO Rdf
+**** TODO Gremlin
+**** DONE Neo4j CSV
+     CLOSED: [2017-02-01 Wed 13:04]
+**** DONE Cypher
+     CLOSED: [2017-02-01 Wed 13:04]
+**** DONE N-Quad
+     CLOSED: [2017-02-01 Wed 13:04]
+**** DONE GraphML
+     CLOSED: [2017-02-01 Wed 13:04]
+
+** DSL
+
+*** TODO CLI DSL
+*** TODO DSL for relationships
+    # type                        from               to
+    "AssociationRelationship",    "associated_with", "associated_with"
+    "AccessRelationship",         "accesses",        "accessed_by"
+    "UsedByRelationship",         "used_by",         "uses"
+    "RealisationRelationship",    "realizes",        "realized_by"
+    "AssignmentRelationship",     ""
+    "AggregationRelationship"
+    "CompositionRelationship"
+    "FlowRelationship"
+    "TriggeringRelationship"
+    "GroupingRelationship"
+    "SpecialisationRelationship"
+    "InfluenceRelationship"
+
+    # attributes that are references to other nodes in the model
+
+    For any of these inserted or changed...
+
+    * Property.key (only after PropertyDefs is introduced)
+      - Property referenced deleted key
+    * Child.target_connections -> Array of Connection ids
+      - Connection.id deleted
+    * Child.archimate_element -> Element.id
+      - Element.id deleted
+    * Folder.items -> Array of IdentifiedNode
+      - *.id deleted
+    * Relationship.source -> Element.id
+      - Element.id deleted
+    * Relationship.target -> Element.id
+      - Element.id deleted
+    * Connection.source -> Child.id
+      - Child.id deleted
+    * Connection.target -> Child.id
+      - Child.id deleted
+    * Connection.relationship -> Relationship.id
+      - Relationship.id deleted
+
+
+** Additional Features
+
+*** TODO Add Split file feature (extract say a diagram or set of elements)
+*** TODO Merge unrelated files (this is the intent of Merger)
+*** TODO Add a super strict mode to note when reader finds unexpected content
+*** DONE Stats (elements, relationships, diagrams)
+    CLOSED: [2017-02-01 Wed 12:45]
+*** TODO Tool to query for dependencies
+*** TODO Tool to assign/validate/enforce metadata
+
+** Code Quality/Refactoring
+
+*** TODO Consider breaking this into a number of gems (for example: base lib, diff/merge, other cmdline tools)
+*** TODO Consider making classes for each element and relationship type?
+*** DONE Figure out how to make rmagick optional and/or remove rmagick dependency
+    CLOSED: [2017-02-01 Wed 12:45]
+*** TODO Data model items that reference something else by id should have the actual object available - not just the id
+*** DONE Convert all CLIs to use AIO - merge with OutputIO and MaybeIO (maybe)
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE figure out a better parent mechanism - it's really not fully cooked
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE remove parent_id from dry::struct objects - then can use class schema instead of comparison attributes
+    CLOSED: [2017-02-01 Wed 12:45]
+*** TODO Not handling sketch diagram model in archi
+*** DONE Use one color method - currently using HighLine and Colorize
+    CLOSED: [2017-02-01 Wed 12:45]
+*** TODO Refactor merge to pull conflict detection out
+*** DONE Clean up the way that the describe is done on data model
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE Permit model items to link back to their parent
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE Should be a master hash index of id to object in Model
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE Improve description of diffs for conflict display
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE Eliminate use of Document in favor of Model
+    CLOSED: [2017-02-01 Wed 12:45]
+    - [X] cli/archi.rb
+    - [X] cli/cleanup.rb
+    - [X] cli/convert.rb
+    - [X] cli/svger.rb
+*** TODO Experiment with Ox, Oga, Sax-Machine for better performance on convert
+*** TODO Map conversion between archi and archimate diagram formats
+*** DONE Write a common clone for dry-struct classes
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE Make a format agnostic file reader (which delegates to appropriate file type readers)
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE Decide between ox and nokogiri and eliminate the alternate
+    CLOSED: [2017-02-01 Wed 12:45]
+*** DONE See what can be done about performance
+    CLOSED: [2017-02-01 Wed 12:46]
+     - Reading file 11-12 secs
+     - deleted relationships referenced in diagrams is slow
+*** DONE Refactor to better OO design where necessary (see all about names below)
+    CLOSED: [2017-02-01 Wed 12:46]
+*** DONE Refactor merge to pull apply diffs out
+    CLOSED: [2017-02-01 Wed 12:46]
+*** TODO Refactor Bendpoint to use a point (rather than Archi start/end points).
+*** TODO Refactor DataModel classes to use enumeration classes for appropriate values
+*** TODO Add a test to produce SVG output for the "everything.archimate" file
+*** TODO Add a test to produce a badges diagram
+
+
+* Refactor of data model for diff/merge purposes
+
+** Validation
+*** Identifiable objects exist one place in model
+*** 
+** Join:
+   - Organizable Id (An Organizable is an Identifiable that can be contained in a Folder
+   - Folder
+   - Position in Folder - index isn't good here ... should that position really be a linked list?
+* Introduce the idea of archimate modules
+  - Allow creation of a focused model by including archimate modules - which are self-contained packages of elements and relationships
+  - Allow inheritance of a module to permit showing changes to an existing model.
+** How to implement?
+   - Break things down automatically?
+   - By Layer?
+   - How to Deal with relationships across module boundaries?
+* Need to have model merge capability
+* TODO Refactor to use a Decorator approach using SimpleDelegator
+* TODO Remove Dry-Types dependency
+* TODO Scan git history and inject metadata for concepts created by git author
+* Changes for v3 have borked the model
+** TODO Push through fixes focusing on the issues from factories to see if that works
+** TODO Refactor model to eliminate a lot of cruft by removing things like in_model= and populating model with objects instead of ID refs
+** TODO Refactor model to improve the diffing of arrays and by writing explicit diff decorators rather than domain model magic
+   Both of the last two options risk breaking diffing/merging by making and becoming a long slog
+
+* TODO In mergetool - show diagrams that reference elements and relationships in diff conflicts
+
+* Notes
+
+Generic type - not used directly
+ReferenceType <xs:attribute name="ref" type="xs:IDREF
+
+ElementRefGroup <xs:attribute name="elementRef" type="xs:IDREF
+RelationshipRefGroup <xs:attribute name="relationshipRef" type="xs:IDREF
+ConceptRefGroup <xs:attribute name="ConceptRef" type="xs:IDREF
+PropertyDefinitionRefGroup <xs:attribute name="propertyDefinitionRef" type="xs:IDREF
+StereotypeRefGroup <xs:attribute name="stereotypeRef" type="xs:IDREF
+PropertyDefinitionRefAttributeGroup <xs:attribute name="propertyDefinitionRef" type="xs:IDREF
+
+RelationshipType <xs:attribute name="source" type="xs:IDREF
+RelationshipType <xs:attribute name="target" type="xs:IDREF
+
+OrganizationType        <xs:attribute name="identifierRef" type="xs:IDREF
+
+
+RelationshipType.source -> ConceptType?
+RelationshipType.target -> ConceptType?
+ViewType.viewpointRef -> Viewpoint
+
+Label.conceptRef -> ConceptType
+Element (Diagram).elementRef -> ElementType
+ConnectionType.source -> ConceptType
+ConnectionType.target -> ConceptType
+Relationship (Diagram).relationshipRef -> RelationshipType
+
+
+ModelType
+PropertyDefinitionType
+ConceptType > [RelationshipType > Access, Influence], ElementType > RealElementType, RelationshipConnectorType, CompositeType
+ViewType > Diagram
+
+
+ViewConceptType > [ViewNodeType > Label, Container], [ConnectionType  > Line, SourcedConnectionType > Relationship > NestingRelationship]
+Child is a ViewNodeType
+
+
+
+ViewpointType
+
+* More Notes
+
+background_class -> used by entity_shape
+badge -> entity_badge -> to_svg
+entity_shape
+
+
+text_bounds (I think this is only set in entity_shape)
+DiagramModelReference assigns the entity from the child.model_element
+badge_bounds in Gap, MotivationEntity, RectEntity, RoundedRectEntity
+text_align in Note
+
+some shapes are dependent on child.child_type
+
+badge should be controlled by the entity_shape method
+  check that badge_bounds is set by shape (I think it is)
+
+text_bounds is controlled by entity_shape
+
+background_class : string (default: layer_background_class)
+badge : string option
+entity_shape : (child -> element_name_type -> bounds -> Svg.elt wrap)
+effective_entity : (child -> element_name_type)
+
+get effective entity
+
+that's used to match the rest:

data/archimate.gemspec

@@ -0,0 +1,51 @@
+# coding: utf-8
+# frozen_string_literal: true
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'archimate/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "archimate"
+  spec.version       = Archimate::VERSION
+  spec.authors       = ["Mark Morga"]
+  spec.email         = ["markmorga@gmail.com", "mmorga@rackspace.com"]
+
+  spec.summary       = "Archi Tools"
+  spec.description   = "A collection of tools for working with ArchiMate files from Archi"
+  spec.homepage      = "http://markmorga.com/archi-tools-rb"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  spec.metadata["yard.run"] = "yri" # use "yard" to build full HTML docs.
+  spec.required_ruby_version = '>= 2.3.0'
+
+  spec.add_runtime_dependency "dry-struct", "~> 0.3.0"
+  spec.add_runtime_dependency "nokogiri", "~> 1.6"
+  spec.add_runtime_dependency "thor", "~> 0.19"
+  spec.add_runtime_dependency "highline", "~> 1.7"
+  spec.add_runtime_dependency "ruby-progressbar", "~>1.8.1"
+  spec.add_runtime_dependency "parallel", "~> 1.11"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest-matchers"
+  spec.add_development_dependency "minitest-color"
+  spec.add_development_dependency "minitest-profile"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-byebug"
+  spec.add_development_dependency "guard"
+  spec.add_development_dependency "guard-minitest"
+  spec.add_development_dependency "guard-bundler"
+  spec.add_development_dependency "ruby-prof"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "simplecov-json"
+  spec.add_development_dependency "kramdown"
+  spec.add_development_dependency "yard"
+  spec.add_development_dependency "guard-ctags-bundler"
+  spec.add_development_dependency "faker"
+  spec.add_development_dependency "rsense"
+  spec.add_development_dependency "awesome_print"
+end

data/bin/archimate

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+#
+# This file was generated by Bundler.
+#
+# The application 'archimate' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("archimate", "archimate")

data/bin/console

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "nokogiri"
+require "archimate"
+require "faker"
+require "awesome_print"
+require_relative "../test/examples/factories"
+include Archimate::Examples::Factories
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/archidiff

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby -w
+# frozen_string_literal: true
+
+require "rubygems"
+require "archimate"
+
+Archimate::Cli::Diff.diff(ARGV[0], ARGV[1], Archimate::AIO.new)

data/exe/archidiff-summary

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby -w
+# frozen_string_literal: true
+
+require "rubygems"
+require "archimate"
+
+Archimate::Cli::DiffSummary.diff(ARGV[0], ARGV[1])

data/exe/archimate

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "rubygems"
+require "archimate"
+
+Archimate::Cli::Archi.start(ARGV)

data/exe/archimerge

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby -w
+# frozen_string_literal: true
+
+require "rubygems"
+require "archimate"
+
+Archimate::Cli::Merge.merge(ARGV[0], ARGV[1], ARGV[2], ARGV[3])

data/exe/fmtxml

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "archimate"
+
+Archimate::Cli::XmlTextconv.new(ARGV[0])

data/lib/archimate/cli/archi.rb

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+module Archimate
+  module Cli
+    require "thor"
+
+    def self.output_io(output_io, force)
+      if output_io.is_a?(String)
+        if !force && File.exist?(output_io)
+          # TODO: This needs to be handled with more grace
+          return nil unless @hl.agree("File #{output_io} exists. Overwrite?")
+        end
+        output_io = File.open(output_io, "w")
+      end
+      output_io
+    end
+
+    class Archi < Thor
+      desc "stats ARCHIFILE", "Show some statistics about the model"
+      option :noninteractive,
+             aliases: :n,
+             type: :boolean,
+             default: false,
+             desc: "Don't provide interactive feedback"
+      def stats(archifile)
+        Config.instance.interactive = !options.fetch("noninteractive", false)
+        Archimate::Cli::Stats.new(
+          Archimate.read(archifile),
+          $stdout
+        ).statistics
+      end
+
+      desc "map ARCHIFILE", "Produce a map of diagram links to a diagram"
+      option :output,
+             aliases: :o,
+             desc: "Write output to FILE instead of stdout."
+      option :noninteractive,
+             aliases: :n,
+             type: :boolean,
+             default: false,
+             desc: "Don't provide interactive feedback"
+      def map(archifile)
+        Config.instance.interactive = !options.fetch("noninteractive", false)
+        Archimate::Cli::Mapper.new(
+          Archimate.read(archifile),
+          Cli.output_io(options.fetch("output", $stdout), false)
+        ).map
+      end
+
+      desc "merge ARCHIFILE1 ARCHIFILE2", "EXPERIMENTAL: Merge two archimate files"
+      option :output,
+             aliases: :o,
+             desc: "Write output to FILE instead of stdout."
+      def merge(archifile1, archifile2)
+        Archimate::Cli::Merger.new.merge_files(archifile1, archifile2)
+      end
+
+      desc "svg -o OUTPUTDIR ARCHIFILE", "IN DEVELOPMENT: Produce semantically meaningful SVG files from an Archi file"
+      option :output,
+             aliases: :o,
+             required: true,
+             desc: "Write output to OUTPUTDIR"
+      option :noninteractive,
+             aliases: :n,
+             type: :boolean,
+             default: false,
+             desc: "Don't provide interactive feedback"
+      def svg(archifile)
+        Config.instance.interactive = !options.fetch("noninteractive", false)
+        Archimate::Cli::Svger.export_svgs(
+          archifile,
+          options.fetch("output", Dir.pwd)
+        )
+      end
+
+      desc "clean ARCHIFILE", "Clean up unreferenced elements and relations"
+      option :output,
+             aliases: :o,
+             desc: "Write output to FILE instead of replacing ARCHIFILE"
+      option :saveremoved,
+             aliases: :r,
+             desc: "Write removed elements into FILE"
+      option :noninteractive,
+             aliases: :n,
+             type: :boolean,
+             default: false,
+             desc: "Don't provide interactive feedback"
+      def clean(archifile)
+        Config.instance.interactive = !options.fetch("noninteractive", false)
+        outfile = options.key?(:output) ? options[:output] : archifile
+        Archimate::MaybeIO.new(options.fetch(:saveremoved, nil)) do |removed_element_io|
+          Archimate::Cli::Cleanup.new(Archimate.read(archifile), outfile, removed_element_io)
+        end
+      end
+
+      desc "dupes ARCHIFILE", "List (potential) duplicate elements in Archi file"
+      def dupes(archifile)
+        Archimate::Cli::Duper.new(
+          archimate.read(archifile),
+          STDOUT
+        ).list
+      end
+
+      desc "dedupe ARCHIFILE", "de-duplicate elements in Archi file"
+      option :mergeall,
+             aliases: :m,
+             type: :boolean,
+             default: false,
+             desc: "Merges all duplicates without asking"
+      option :output,
+             aliases: :o,
+             desc: "Write output to FILE instead of replacing ARCHIFILE"
+      option :force,
+             aliases: :f,
+             type: :boolean,
+             default: false,
+             desc: "Force overwriting of existing output file"
+      option :noninteractive,
+             aliases: :n,
+             type: :boolean,
+             default: false,
+             desc: "Don't provide interactive feedback"
+      def dedupe(archifile)
+        Config.instance.interactive = !options.fetch("noninteractive", false)
+        Archimate::Cli::Duper.new(
+          Archimate.read(archifile),
+          Cli.output_io(
+            options.fetch("output", archifile),
+            options[:force]
+          ),
+          options[:mergeall]
+        ).merge
+      end
+
+      desc "convert ARCHIFILE", "Convert the incoming file to the desired type"
+      option :to,
+             aliases: :t,
+             default: Archimate::Cli::Convert::SUPPORTED_FORMATS.first,
+             desc: "File type to convert to. Options are: " \
+                   "'meff2.1' for Open Group Model Exchange File Format for ArchiMate 2.1 " \
+                   "'archi' for Archi http://archimatetool.com/ file format " \
+                   "'nquads' for RDF 1.1 N-Quads format https://www.w3.org/TR/n-quads/" \
+                   "'graphml' for GraphML" \
+                   "'csv' for CSV files (one file per element/relationship type",
+             enum: Archimate::Cli::Convert::SUPPORTED_FORMATS
+      option :output,
+             aliases: :o,
+             desc: "Write output to FILE instead of stdout."
+      option :outputdir,
+             aliases: :d,
+             desc: "Write output to DIRECTORY."
+      option :force,
+             aliases: :f,
+             type: :boolean,
+             desc: "Force overwriting of existing output file"
+      option :noninteractive,
+             aliases: :n,
+             type: :boolean,
+             default: false,
+             desc: "Don't provide interactive feedback"
+      def convert(archifile)
+        output_dir = options.fetch("outputdir", Dir.pwd)
+        output_io = Cli.output_io(
+          options.fetch("output", $stdout),
+          options.fetch("force", false)
+        )
+        Config.instance.interactive = !options.fetch("noninteractive", false)
+        Archimate::Cli::Convert.new(
+          Archimate.read(archifile)
+        ).convert(options[:to], output_io, output_dir)
+      end
+
+      desc "lint ARCHIFILE", "Examine the ArchiMate file for potential problems"
+      option :output,
+             aliases: :o,
+             desc: "Write output to FILE instead of STDOUT"
+      def lint(archifile)
+        output_io = Cli.output_io(
+          options.fetch("output", $stdout),
+          options.fetch("force", false)
+        )
+        Archimate::Cli::Lint.new(
+          Archimate.read(archifile),
+          output_io
+        ).lint
+      end
+    end
+  end
+end

data/lib/archimate/cli/cleanup.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+#
+# The point of this script is to identify elements that aren't a part of any
+# relationship and not referenced on any diagrams.
+
+module Archimate
+  module Cli
+    class Cleanup
+      attr_reader :model
+
+      def self.cleanup(input, output, options)
+        cleaner = new(Archimate.read(input), output, options)
+        cleaner.clean
+      end
+
+      def initialize(model, output, options)
+        @model = model
+        @output = output
+        @options = options
+        @trash = Nokogiri::XML::Document.new("<deleted></deleted>")
+        @model_set = nil
+        @progressbar = ProgressIndicator.new(total: model.unreferenced_nodes.size, title: "Elements")
+      end
+
+      def remove_unreferenced_nodes
+        model.unreferenced_nodes.each do |id|
+          ns = model.lookup(id)
+          puts "Found duplicate ids: #{ns}" if ns.size > 1
+          unreferenced_node = ns[0]
+          trash.root.add_child unreferenced_node.dup
+          prev_sib = unreferenced_node.previous_sibling
+          if prev_sib.instance_of?(Nokogiri::XML::Text) && prev_sib.content.strip.empty?
+            ns << prev_sib
+          end
+          ns.remove
+          @progressbar.increment
+        end
+      end
+
+      def write_trash
+        options[:saveremoved].write(trash)
+      end
+
+      def clean
+        return unless model
+
+        remove_unreferenced_nodes
+        puts "Found #{unref_set.size} model items unreferenced by diagram or relationships"
+        Archimate::ArchiFileWriter.write(model, output)
+        write_trash
+      end
+    end
+  end
+end