archsight 0.3.3 → 0.4.1

data/lib/archsight/resources.rb

@@ -14,6 +14,12 @@ module Archsight
       "BusinessConstraint" => "MotivationConstraint"
     }.freeze
 
+    # Annotations that were renamed: the old key is rewritten to the new one when a document is loaded (see
+    # Database#accept_old_names) and reported as deprecated by `archsight lint`.
+    ANNOTATION_ALIASES = {
+      "page/confluence" => "link/confluence"
+    }.freeze
+
     # Relation keys (the plural kind names under `spec.<verb>`) that were renamed together with their kind
     RELATION_KEY_ALIASES = {
       "businessRequirements" => "motivationRequirements",
@@ -28,6 +34,12 @@ module Archsight
     DERIVED_VERBS = %i[mentions depicts].freeze
     DERIVED_KEY = :resources
 
+    # The layers a kind belongs to (Base.layer), top to bottom: why (motivation), what we want to become (strategy),
+    # how the change happens (implementation and migration), then the architecture it changes (business, application,
+    # technology). `other` holds the tool's own kinds (pages, views, imports, ...) and stays last. Everything that
+    # lists or orders layers uses this; the frontend repeats it in frontend/src/composables/useLayers.js.
+    LAYERS = %w[motivation strategy implementation business application technology other].freeze
+
     # The derived relations of every class, next to the ones it declares: [verb, key, kind]
     DERIVED_RELATIONS = DERIVED_VERBS.map { |verb| [verb, DERIVED_KEY, "Resource"] }.freeze
 

data/lib/archsight/version.rb

@@ -4,5 +4,5 @@
 # Do not edit manually.
 
 module Archsight
-  VERSION = "0.3.3"
+  VERSION = "0.4.1"
 end

data/lib/archsight/web/api/analysis_helpers.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Archsight; end
+module Archsight::Web; end
+module Archsight::Web::API; end
+
+# JSON of `POST /api/v1/kinds/Analysis/instances/:name/execute`: the result and its sections
+module Archsight::Web::API::AnalysisHelpers
+  def build_analysis_result(result)
+    data = {
+      name: result.name,
+      success: result.success?,
+      has_findings: result.has_findings?,
+      duration: result.duration,
+      sections: result.sections.map { |s| serialize_analysis_section(s) }
+    }
+
+    if result.failed?
+      data[:error] = result.error
+      data[:error_backtrace] = result.error_backtrace if result.error_backtrace&.any?
+    end
+
+    data
+  end
+
+  def serialize_analysis_section(section)
+    case section[:type]
+    when :heading
+      { type: "heading", level: section[:level], text: section[:text] }
+    when :text
+      { type: "text", content: markdown(section[:content]) }
+    # the *_html fields: the values as inline markdown with [[Kind/Name]] links, next to the raw values
+    when :message
+      { type: "message", level: section[:level].to_s, message: section[:message],
+        message_html: analysis_html(section[:message]) }
+    when :table
+      { type: "table", headers: section[:headers], rows: section[:rows],
+        rows_html: section[:rows].map { |row| row.map { |cell| analysis_html(cell) } } }
+    when :list
+      { type: "list", items: section[:items], items_html: section[:items].map { |item| analysis_html(item) } }
+    when :code
+      { type: "code", lang: section[:lang], content: section[:content] }
+    else
+      { type: section[:type].to_s }
+    end
+  end
+
+  # A value of a table cell, list item or message as html: HTML in it stays text (escaped first) except a line
+  # break (`<br>` or a newline, the usual way to break a line in a table cell), markdown and [[Kind/Name]] links are
+  # rendered; a value without markup is only escaped, so large tables stay cheap
+  def analysis_html(value)
+    escaped = Rack::Utils.escape_html(value.to_s).gsub(%r{&lt;br\s*/?&gt;}i, "<br>").gsub(/\r?\n/, "<br>")
+    escaped.match?(/[*_`\[{]|https?:/) ? inline_markdown(escaped) : escaped
+  end
+end

data/lib/archsight/web/api/docs.rb

@@ -11,8 +11,9 @@ module Archsight::Web::API; end
 module Archsight::Web::API::Docs
   extend Sinatra::Extension
 
+  # A page of its own, not the single page app: ReDoc must not get the app's CSS (Pico restyles every <code>)
   get "/docs/api" do
-    serve_vue
+    send_file File.join(settings.public_folder, "vendor", "redoc", "api.html"), type: :html
   end
 
   # GET /api/v1/docs/resources/:filename — auto-generated resource docs

data/lib/archsight/web/api/json_helpers.rb

@@ -66,7 +66,8 @@ module Archsight::Web::API::JsonHelpers
         description: klass.description,
         layer: klass.layer,
         icon: klass.icon,
-        instance_count: count
+        instance_count: count,
+        self_relations: Archsight::GraphvisRenderer.self_relations(klass).any?
       }
     end
     kinds.sort_by { |k| k[:kind] }
@@ -92,6 +93,7 @@ module Archsight::Web::API::JsonHelpers
       name: instance.name,
       metadata: { annotations: render_annotations(instance.annotations, base: Archsight::Assets.base_dir_for(instance, resources_dir: Archsight.resources_dir), kind: kind) },
       annotation_formats: Archsight::Resources[kind]&.annotation_formats(instance.annotations.keys) || {},
+      annotation_links: Archsight::Helpers::ResourceResolver.new(db).annotation_links(kind, instance.annotations),
       spec: serialize_spec(instance.spec),
       relations: extract_relations(instance),
       references: extract_references(instance),
@@ -193,42 +195,6 @@ module Archsight::Web::API::JsonHelpers
     end
   end
 
-  def build_analysis_result(result)
-    data = {
-      name: result.name,
-      success: result.success?,
-      has_findings: result.has_findings?,
-      duration: result.duration,
-      sections: result.sections.map { |s| serialize_analysis_section(s) }
-    }
-
-    if result.failed?
-      data[:error] = result.error
-      data[:error_backtrace] = result.error_backtrace if result.error_backtrace&.any?
-    end
-
-    data
-  end
-
-  def serialize_analysis_section(section)
-    case section[:type]
-    when :heading
-      { type: "heading", level: section[:level], text: section[:text] }
-    when :text
-      { type: "text", content: markdown(section[:content]) }
-    when :message
-      { type: "message", level: section[:level].to_s, message: section[:message] }
-    when :table
-      { type: "table", headers: section[:headers], rows: section[:rows] }
-    when :list
-      { type: "list", items: section[:items] }
-    when :code
-      { type: "code", lang: section[:lang], content: section[:content] }
-    else
-      { type: section[:type].to_s }
-    end
-  end
-
   def extract_references(instance)
     references = {}
 

data/lib/archsight/web/api/openapi/spec.yaml

@@ -254,7 +254,7 @@ paths:
         Returns one page with its metadata and its body rendered to HTML.
 
         **Metadata** comes from the frontmatter: `title` (falls back to the name), `status`, `author` and
-        `owner` (`Name <email>`, split into `name` and `email`), `tags` and the `confluence` URL.
+        `owner` (`Name <email>`, split into `name` and `email`), `tags` and the `links` (name and URL, e.g. `confluence`).
 
         **`html`** is the markdown body rendered once per request:
         - GitHub-flavoured markdown (tables, fenced code, task lists).
@@ -309,7 +309,7 @@ paths:
                 owner:
                   name: Jane Doe
                   email: jane.doe@example.com
-                confluence: null
+                links: {}
                 tags:
                   - howto
                   - wiki
@@ -623,12 +623,10 @@ paths:
                 type: object
                 properties:
                   html:
-                    type: string
-                    nullable: true
+                    type: [string, "null"]
                     description: '`<figure class="asd-diagram">` with the SVG'
                   error:
-                    type: string
-                    nullable: true
+                    type: [string, "null"]
         '400':
           description: Body is not JSON with a `source` string
           content:
@@ -708,9 +706,11 @@ paths:
       summary: Requirements of a selection of resources
       description: |
         The requirements that the resources selected by `of` realize (`implemented`), partially realize
-        (`partial`) or plan (`planned`), merged over all of them: one entry per requirement with the best status and
-        the resources it comes from (`by`). Sorted by priority (must, should, may, none), then name. `story` is
-        rendered HTML.
+        (`partial`) or plan (`planned`), merged over all of them: one entry per requirement, with the best status
+        any of the resources gives it and the resources it comes from (`by`, each with its own status). Sorted by
+        priority (must, should, may, requirements without a priority last), then name. `story` is rendered HTML.
+        `priority` and `status` filter the merged entries, so `status=partial` lists requirements whose best
+        status is partial.
       operationId: getRequirements
       tags:
         - Search
@@ -725,14 +725,14 @@ paths:
         - name: priority
           in: query
           required: false
-          description: Comma separated list, only requirements with one of these priorities
+          description: Comma separated list, only requirements with one of these priorities (must, should, may)
           schema:
             type: string
           example: must,should
         - name: status
           in: query
           required: false
-          description: Comma separated list, only requirements with one of these statuses
+          description: Comma separated list, only requirements with one of these statuses (implemented, partial, planned)
           schema:
             type: string
           example: implemented,partial
@@ -743,33 +743,42 @@ paths:
             application/json:
               schema:
                 type: object
+                required: [query, total, query_time_ms, requirements]
                 properties:
                   query:
                     type: string
+                    description: The `of` query as given
                   total:
                     type: integer
+                    description: Number of requirements returned
                   query_time_ms:
                     type: number
                   requirements:
                     type: array
                     items:
                       type: object
+                      required: [name, status, priority, story, by]
                       properties:
                         name:
                           type: string
+                          description: Name of the MotivationRequirement
                         status:
                           type: string
                           enum: [implemented, partial, planned]
+                          description: The best status among the resources in `by`
                         priority:
-                          type: string
-                          nullable: true
+                          type: [string, "null"]
+                          enum: [must, should, may, null]
+                          description: Priority of the requirement, null if it has none
                         story:
-                          type: string
-                          nullable: true
+                          type: [string, "null"]
+                          description: The requirement's story as rendered HTML, null if it has none
                         by:
                           type: array
+                          description: The selected resources that realize, partially realize or plan the requirement, best status first
                           items:
                             type: object
+                            required: [kind, name, status]
                             properties:
                               kind:
                                 type: string
@@ -778,12 +787,118 @@ paths:
                               status:
                                 type: string
                                 enum: [implemented, partial, planned]
+                                description: The status this resource gives the requirement
+              example:
+                query: 'ApplicationService: name =~ "Backup"'
+                total: 1
+                query_time_ms: 1.4
+                requirements:
+                  - name: "Requirement:Restore"
+                    status: partial
+                    priority: must
+                    story: "<p>As an operator I can restore a backup.</p>"
+                    by:
+                      - kind: ApplicationService
+                        name: Backup
+                        status: partial
         '400':
-          description: Invalid query, or an unknown priority or status
+          description: |
+            `of` is missing or `priority` or `status` holds an unknown value (`BadRequest`), or `of` is not a valid
+            query (`QueryError`, which also returns the query)
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/QueryError'
+                oneOf:
+                  - $ref: '#/components/schemas/Error'
+                  - $ref: '#/components/schemas/QueryError'
+
+  /api/v1/openapi.yaml:
+    get:
+      summary: This OpenAPI document
+      description: |
+        The OpenAPI 3.1 description of this API. The fixed endpoints are written by hand; the schema of every kind
+        (its annotations with type, enum and description, its `spec` and its relations), the list of kinds and the
+        instance detail are generated from the model, so they always describe the kinds this server has.
+      operationId: getOpenApi
+      tags:
+        - Operations
+      responses:
+        '200':
+          description: The OpenAPI document
+          content:
+            text/yaml:
+              schema:
+                type: string
+
+  /maintenance/restart:
+    post:
+      summary: Restart the server
+      description: |
+        Stops the server so that its supervisor (for example a Kubernetes Deployment) starts it again with fresh
+        data. Only available when the server was started with `--enable-restart` (or
+        `ARCHSIGHT_RESTART_ENABLED=true`); otherwise it answers 404. When a restart token is configured it must be
+        sent in the `X-Restart-Token` header.
+      operationId: restart
+      tags:
+        - Operations
+      parameters:
+        - name: X-Restart-Token
+          in: header
+          required: false
+          description: The configured restart token (required when the server has one)
+          schema:
+            type: string
+      responses:
+        '200':
+          description: The server shuts down
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok, message]
+                properties:
+                  ok:
+                    type: boolean
+                  message:
+                    type: string
+              example:
+                ok: true
+                message: Server shutting down
+        '401':
+          description: The restart token is missing or wrong
+          content:
+            text/html:
+              schema:
+                type: string
+        '404':
+          description: The restart endpoint is not enabled
+          content:
+            text/html:
+              schema:
+                type: string
+
+  /kinds/{kind}/dot:
+    get:
+      summary: Get the graph of a kind as DOT
+      description: The GraphViz DOT graph of the resources of a kind and the relations between them.
+      operationId: getKindDot
+      tags:
+        - Graph
+      parameters:
+        - $ref: '#/components/parameters/kind'
+      responses:
+        '200':
+          description: GraphViz DOT source
+          content:
+            text/plain:
+              schema:
+                type: string
+        '404':
+          description: Unknown kind
+          content:
+            text/plain:
+              schema:
+                type: string
 
   /dot:
     get:
@@ -1343,13 +1458,11 @@ components:
               items:
                 type: string
         format:
-          type: string
-          nullable: true
+          type: [string, "null"]
           description: Rendering hint of the annotation (tag_word, tag_list, markdown, link, ...)
           example: tag_word
         type:
-          type: string
-          nullable: true
+          type: [string, "null"]
           description: Short name of the value type when the annotation declares one (Integer, Float, Time, Person, ...)
           example: Integer
 
@@ -1489,7 +1602,7 @@ components:
           description: Whether the analysis executed successfully
         has_findings:
           type: boolean
-          description: Whether the analysis produced findings
+          description: Whether the script produced any output (tables, lists, text, ...). Output is not a problem; errors and warnings the script reports are message sections
         duration:
           type: number
           format: float
@@ -1684,26 +1797,22 @@ components:
       type: object
       properties:
         yaml:
-          type: string
-          nullable: true
+          type: [string, "null"]
           description: Generated source text, YAML or (for pages) markdown with frontmatter (null if validation failed)
         format:
           type: string
           enum: [yaml, markdown]
           description: Format of `yaml`. Pages (kind Page) are stored as markdown files and replaced as a whole file
         errors:
-          type: array
-          nullable: true
+          type: [array, "null"]
           items:
             type: string
           description: Validation errors (null if valid)
         path_ref:
-          type: string
-          nullable: true
+          type: [string, "null"]
           description: "File path reference (edit mode only, e.g., path/file.yaml:5; just the file for markdown pages)"
         content_hash:
-          type: string
-          nullable: true
+          type: [string, "null"]
           description: Content hash (edit mode only, for optimistic locking)
 
     SaveRequest:
@@ -1869,7 +1978,7 @@ components:
 
     PageResponse:
       type: object
-      required: [name, title, status, author, owner, created, updated, properties, confluence, tags, toc, breadcrumb, html, backlinks]
+      required: [name, title, status, author, owner, created, updated, properties, links, tags, toc, breadcrumb, html, backlinks]
       properties:
         name:
           type: string
@@ -1909,10 +2018,12 @@ components:
               html:
                 type: string
                 description: The value rendered as inline markdown (links, emphasis, `{macros}`, `[[wiki links]]`), without a paragraph around it
-        confluence:
-          type: [string, 'null']
-          format: uri
-          description: URL of the corresponding Confluence page
+        links:
+          type: object
+          description: Links of the page to other systems, by name (`confluence`, `jira`, ...)
+          additionalProperties:
+            type: string
+            format: uri
         tags:
           type: array
           items:

data/lib/archsight/web/api/page_helpers.rb

@@ -41,7 +41,7 @@ module Archsight::Web::API::PageHelpers
       created: annotations["page/created"],
       updated: annotations["page/updated"],
       properties: page.properties.map { |key, value| { key: key, value: value, html: inline_markdown(value, page) } },
-      confluence: annotations["page/confluence"],
+      links: annotations.select { |key, _| key.start_with?("link/") }.transform_keys { |key| key.delete_prefix("link/") },
       tags: Archsight::Resources::Page.annotation_matching("page/tags")&.value_for(page) || [],
       toc: annotations["page/toc"] == "yes" ? Archsight::PageTree.toc(body) : [],
       breadcrumb: tree.breadcrumb(page),
@@ -50,13 +50,6 @@ module Archsight::Web::API::PageHelpers
     }
   end
 
-  # A short text (a page property) rendered as inline markdown: links, emphasis, `{macros}`, [[wiki links]], without the
-  # paragraph around it
-  def inline_markdown(text, page)
-    html = markdown(text.to_s, base: Archsight::Assets.base_dir_for(page, resources_dir: Archsight.resources_dir), page: page)
-    html.strip.sub(%r{\A<p>(.*)</p>\z}m, '\1')
-  end
-
   # The header already shows the title, so a leading "# Title" that repeats it is dropped
   # (Confluence exports and hand-written pages usually start with one).
   def strip_duplicate_title(body, page)

data/lib/archsight/web/api/routes.rb

@@ -5,7 +5,9 @@ require "sinatra/extension"
 require_relative "json_helpers"
 require_relative "page_helpers"
 require_relative "requirements_helpers"
+require_relative "analysis_helpers"
 require_relative "../../assets"
+require_relative "../../openapi"
 
 module Archsight; end
 module Archsight::Web; end
@@ -18,6 +20,7 @@ module Archsight::Web::API::Routes
   helpers Archsight::Web::API::JsonHelpers
   helpers Archsight::Web::API::PageHelpers
   helpers Archsight::Web::API::RequirementsHelpers
+  helpers Archsight::Web::API::AnalysisHelpers
 
   # Rendering is CPU work, previews are typed, not pasted
   MAX_DIAGRAM_SOURCE = 100_000
@@ -67,10 +70,13 @@ module Archsight::Web::API::Routes
     klass = Archsight::Resources[kind]
     json_error("Kind '#{kind}' not found", status: 404, error_type: "NotFound") unless klass
 
-    instance = db.instance_by_kind(kind, name)
+    # an alias finds the one resource that has it; the response carries the real name
+    instance = db.instance_by_kind(kind, name) || db.instance_by_alias(kind, name)
     json_error("Instance '#{name}' not found", status: 404, error_type: "NotFound") unless instance
 
-    json_response(build_instance_response(kind, instance))
+    # graph_layers: the layers its dependency graph follows when the page opens
+    json_response(build_instance_response(kind, instance)
+      .merge(graph_layers: Archsight::GraphvisRenderer.default_graph_layers(instance.class.layer)))
   end
 
   # GET /api/v1/pages - Page tree built from PageMenu resources, page tags and filters and the home page
@@ -215,8 +221,7 @@ module Archsight::Web::API::Routes
   # GET /api/v1/openapi.yaml - OpenAPI specification
   get "/api/v1/openapi.yaml" do
     content_type "text/yaml"
-    spec_path = File.join(__dir__, "openapi", "spec.yaml")
-    File.read(spec_path)
+    Archsight::OpenAPI.document.to_yaml
   end
 
   # Convenience aliases with .json suffix

data/lib/archsight/web/application.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "sinatra/base"
-require "kramdown"
+require_relative "../markdown"
 require "erb"
 require "fast_mcp"
 
@@ -25,17 +25,25 @@ class Archsight::Web::Application < Sinatra::Base
     attr_accessor :db
 
     def database
-      @database ||= Archsight::Database.new(Archsight.resources_dir).tap(&:reload!)
+      @database ||= Archsight::Database.new(Archsight.resources_dir).tap(&:reload!).tap { |db| load_import_handlers(db) }
     end
 
     def reload!
       start = Time.new
       puts "== Reloading ..." if database.verbose
       database.reload!
+      load_import_handlers(database)
       dur = (Time.new - start) * 1000
       puts format("== done %0.2f ms", dur) if database.verbose
     end
 
+    # The import handlers, built-in and of the resources repository (import/handlerPath), so the editor knows the
+    # same handler names as `archsight lint`. A file that does not load is reported, the server keeps running.
+    def load_import_handlers(db)
+      require "archsight/import"
+      Archsight::Import::HandlerLoader.load(db).each { |problem| warn "Import handler: #{problem}" }
+    end
+
     # Configure application for the given environment
     # @param env [Symbol] :development or :production
     # @param logging [Boolean, nil] Override default logging setting
@@ -135,13 +143,22 @@ class Archsight::Web::Application < Sinatra::Base
       settings.environment == :development
     end
 
+    # A short text (a page property, an analysis table cell) rendered as inline markdown: links, emphasis,
+    # `{macros}`, [[wiki links]], without the paragraph around it
+    # @param page [Archsight::Resources::Page, nil] the page the text belongs to, for its relative images and macros
+    def inline_markdown(text, page = nil)
+      base = page && Archsight::Assets.base_dir_for(page, resources_dir: Archsight.resources_dir)
+      html = markdown(text.to_s, base: base, page: page)
+      html.strip.sub(%r{\A<p>(.*)</p>\z}m, '\1')
+    end
+
     # Render markdown to HTML with optional URL resolution for repository content
     # @param data [String] Markdown content
     # @param git_url [String, nil] Git URL for resolving relative paths (e.g., for README images)
     # @param base [String, nil] directory of the file the markdown comes from, relative to the resources
     #   directory ("" for the root): its relative images become assets (see Archsight::Assets)
     def markdown(data, git_url: nil, base: nil, page: nil)
-      html = Kramdown::Document.new(data, input: "GFM").to_html
+      html = Archsight::Markdown.document(data).to_html
       html = Archsight::Helpers::AssetImages.rewrite(html, base_dir: base, resources_dir: Archsight.resources_dir) if base
       # ```asd blocks become placeholders until the text passes below are done (see DiagramBlocks)
       html, diagrams = Archsight::Helpers::DiagramBlocks.extract(html, resolver: Archsight::Helpers::ResourceResolver.new(db))
@@ -282,14 +299,33 @@ class Archsight::Web::Application < Sinatra::Base
     serve_vue
   end
 
+  # The resources of a kind and the relations between them (see GraphvisRenderer#create_graph_kind)
+  get "/kinds/:kind/dot" do
+    halt 404, "kind #{params["kind"]} unknown" unless Archsight::Resources[params["kind"]]
+
+    content_type "text/plain"
+    create_graph_kind(db, params["kind"])
+  end
+
+  # An alias in the URL redirects to the resource's real name (`:` stays readable, the rest is escaped)
   get "/kinds/:kind/instances/:instance" do
+    kind = params["kind"]
+    name = params["instance"]
+    if Archsight::Resources[kind] && !db.instance_by_kind(kind, name) && (instance = db.instance_by_alias(kind, name))
+      redirect "/kinds/#{kind}/instances/#{ERB::Util.url_encode(instance.name).gsub("%3A", ":")}"
+    end
+
     serve_vue
   end
 
+  # `depth`: steps from the instance (a positive number; missing or `all`: every step), `layers`: the layers it
+  # follows, comma separated (missing or none known: every layer)
   get "/kinds/:kind/instances/:instance/dot" do
     @kind = params["kind"]
     @instance = params["instance"]
+    depth = params["depth"].to_s.match?(/\A[1-9]\d*\z/) ? params["depth"].to_i : nil
+    layers = params["layers"].to_s.split(",").map(&:strip) & Archsight::Resources::LAYERS
     content_type "text/plain"
-    create_graph_one(db, @kind, @instance)
+    create_graph_one(db, @kind, @instance, max_depth: depth, layers: layers.empty? ? nil : layers)
   end
 end

data/lib/archsight/web/editor/routes.rb

@@ -57,7 +57,8 @@ module Archsight
           data = build_form_metadata(kind, klass)
           data[:mode] = "edit"
           data[:name] = instance.name
-          data[:annotations] = instance.annotations.dup
+          # defaults are not in the file, a save leaves them out
+          data[:annotations] = instance.annotations.reject { |key, _| instance.defaulted?(key) }
           data[:relations] = extract_instance_relations(instance)
           data[:path_ref] = source_ref(instance)
           data[:content_hash] = source_content_hash(instance)

data/lib/archsight/web/public/vendor/redoc/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-present, Rebilly, Inc. 
+
+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/lib/archsight/web/public/vendor/redoc/VERSION

@@ -0,0 +1 @@
+2.5.4