archsight 0.1.2 → 0.1.3

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

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "sinatra/base"
+require "sinatra/extension"
+require_relative "json_helpers"
+
+module Archsight; end
+module Archsight::Web; end
+module Archsight::Web::API; end
+
+# REST API routes for Archsight
+module Archsight::Web::API::Routes
+  extend Sinatra::Extension
+
+  helpers Archsight::Web::API::JsonHelpers
+
+  # GET /api/v1/kinds - List all resource kinds with counts
+  get "/api/v1/kinds" do
+    kinds = build_kinds_list
+    total = kinds.sum { |k| k[:instance_count] }
+
+    json_response(
+      { total: kinds.length, total_instances: total, kinds: kinds }
+    )
+  end
+
+  # GET /api/v1/kinds/:kind - List instances of a kind (paginated)
+  get "/api/v1/kinds/:kind" do
+    kind = params[:kind]
+    klass = Archsight::Resources[kind]
+    json_error("Kind '#{kind}' not found", status: 404, error_type: "NotFound") unless klass
+
+    instances = db.instances_by_kind(kind).values.sort_by(&:name)
+    limit, offset = parse_pagination_params
+    output = parse_output_param
+    pagination = paginate(instances, limit: limit, offset: offset)
+
+    resources = pagination[:items].map do |inst|
+      resource_summary(inst, output: output, omit_kind: true)
+    end
+
+    json_response(build_list_response(kind, pagination, resources))
+  end
+
+  # GET /api/v1/kinds/:kind/instances/:name - Get instance details with relations
+  get "/api/v1/kinds/:kind/instances/:name" do
+    kind = params[:kind]
+    name = params[:name]
+
+    klass = Archsight::Resources[kind]
+    json_error("Kind '#{kind}' not found", status: 404, error_type: "NotFound") unless klass
+
+    instance = db.instance_by_kind(kind, name)
+    json_error("Instance '#{name}' not found", status: 404, error_type: "NotFound") unless instance
+
+    json_response(build_instance_response(kind, instance))
+  end
+
+  # GET /api/v1/search - Search with query language
+  get "/api/v1/search" do
+    query = params[:q]
+    json_error("Query parameter 'q' is required", status: 400, error_type: "BadRequest") unless query
+
+    start_time = Time.now
+
+    begin
+      parsed_query = Archsight::Query.parse(query)
+      results = parsed_query.filter(db)
+      query_time_ms = ((Time.now - start_time) * 1000).round(2)
+      output = parse_output_param
+
+      if output == "count"
+        json_response(build_count_response(query, results, query_time_ms))
+      else
+        json_response(build_search_response(query, results, parsed_query, query_time_ms))
+      end
+    rescue Archsight::Query::QueryError => e
+      json_error(e.message, status: 400, error_type: "QueryError", query: query)
+    end
+  end
+
+  # 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)
+  end
+
+  # Convenience aliases with .json suffix
+  get "/kinds.json" do
+    call env.merge("PATH_INFO" => "/api/v1/kinds")
+  end
+
+  get "/kinds/:kind.json" do
+    call env.merge("PATH_INFO" => "/api/v1/kinds/#{params[:kind]}")
+  end
+
+  get "/kinds/:kind/instances/:name.json" do
+    call env.merge("PATH_INFO" => "/api/v1/kinds/#{params[:kind]}/instances/#{params[:name]}")
+  end
+end

data/lib/archsight/web/application.rb

@@ -14,6 +14,8 @@ require_relative "../documentation"
 require_relative "../query"
 require_relative "../resources"
 require_relative "../mcp"
+require_relative "api/routes"
+require_relative "api/docs"
 
 # Define the Web namespace before the class definition
 module Archsight::Web; end
@@ -33,6 +35,22 @@ class Archsight::Web::Application < Sinatra::Base
       dur = (Time.new - start) * 1000
       puts format("== done %0.2f ms", dur) if database.verbose
     end
+
+    # Configure application for the given environment
+    # @param env [Symbol] :development or :production
+    # @param logging [Boolean, nil] Override default logging setting
+    def configure_environment!(env, logging: nil)
+      set :environment, env
+
+      if env == :production
+        set :quiet, true
+        set :server_settings, { Silent: true }
+      end
+
+      # Determine logging: CLI override > env default (prod=true, dev=false)
+      enable_logging = logging.nil? ? (env == :production) : logging
+      use Rack::CommonLogger, $stdout if enable_logging
+    end
   end
 
   configure do
@@ -40,6 +58,7 @@ class Archsight::Web::Application < Sinatra::Base
     set :public_folder, File.join(__dir__, "public")
     set :haml, format: :html5
     set :server, :puma
+    set :reload_enabled, true
   end
 
   # MCP Server setup
@@ -63,11 +82,27 @@ class Archsight::Web::Application < Sinatra::Base
 
   helpers Archsight::GraphvisHelper, Archsight::GraphvisRenderer, Archsight::Helpers
 
+  # Register API modules
+  register Archsight::Web::API::Routes
+  register Archsight::Web::API::Docs
+
   helpers do
     def db
       Archsight::Web::Application.database
     end
 
+    def reload_enabled?
+      settings.reload_enabled
+    end
+
+    def production?
+      settings.environment == :production
+    end
+
+    def development?
+      settings.environment == :development
+    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)
@@ -98,25 +133,6 @@ class Archsight::Web::Application < Sinatra::Base
       end
     end
 
-    def to_dollar(num)
-      # Round to 2 decimals first (important for floating‑point edge cases)
-      rounded = (num * 100).round / 100.0
-      # Insert commas every three digits left of the decimal point
-      parts = format("%.2f", rounded).split(".")
-      parts[0] = parts[0].reverse.scan(/\d{1,3}/).join(",").reverse
-      "$#{parts.join(".")}"
-    end
-
-    def http_git(repo_url)
-      repo_url.gsub(/.git$/, "")
-              .gsub(":", "/")
-              .gsub("git@", "https://")
-    end
-
-    def number_with_delimiter(num)
-      num.to_s.reverse.scan(/\d{1,3}/).join(",").reverse
-    end
-
     # Generate asset path with cache-busting query string based on file mtime
     def asset_path(path)
       file_path = File.join(settings.public_folder, path)
@@ -128,30 +144,9 @@ class Archsight::Web::Application < Sinatra::Base
       end
     end
 
-    # Convert timestamp to human-readable relative time
-    def time_ago(timestamp)
-      return nil unless timestamp
-
-      time = timestamp.is_a?(Time) ? timestamp : Time.parse(timestamp.to_s)
-      seconds = (Time.now - time).to_i
-
-      units = [
-        [60, "second"],
-        [60, "minute"],
-        [24, "hour"],
-        [7, "day"],
-        [4, "week"],
-        [12, "month"],
-        [Float::INFINITY, "year"]
-      ]
-
-      value = seconds
-      units.each do |divisor, unit|
-        return "just now" if unit == "second" && value < 10
-        return "#{value} #{unit}#{"s" if value != 1} ago" if value < divisor
-
-        value /= divisor
-      end
+    # Wrapper for render_analysis_section that provides markdown renderer
+    def render_analysis_section(section)
+      Archsight::Helpers.render_analysis_section(section, markdown_renderer: method(:markdown))
     end
   end
 
@@ -160,6 +155,8 @@ class Archsight::Web::Application < Sinatra::Base
   end
 
   get "/reload" do
+    halt 404, "Reload is disabled" unless settings.reload_enabled
+
     Archsight::Web::Application.reload!
     if params["redirect"]&.start_with?("/")
       redirect params["redirect"]
@@ -289,4 +286,30 @@ class Archsight::Web::Application < Sinatra::Base
     content_type "text/plain"
     create_graph_one(db, @kind, @instance, :draw_dot)
   end
+
+  # Execute an Analysis and return HTML results
+  post "/kinds/Analysis/instances/:instance/execute" do
+    require "archsight/analysis"
+
+    @instance = params["instance"]
+    analysis = db.instance_by_kind("Analysis", @instance)
+
+    unless analysis
+      return haml_inline('.analysis-error
+  %i.iconoir-warning-triangle
+  Analysis not found: #{@instance}')
+    end
+
+    executor = Archsight::Analysis::Executor.new(db)
+    result = executor.execute(analysis)
+
+    haml :"partials/instance/_analysis_result", locals: { result: result }
+  end
+
+  private
+
+  # Helper for inline HAML rendering
+  def haml_inline(template)
+    haml template
+  end
 end