archsight 0.3.0 → 0.3.2

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

@@ -18,7 +18,7 @@ module Archsight::Web::API::Docs
   # GET /api/v1/docs/resources/:filename — auto-generated resource docs
   get "/api/v1/docs/resources/:filename" do
     filename = params["filename"].gsub(/[^a-zA-Z0-9_-]/, "")
-    kind_name = filename.split("_").map(&:capitalize).join
+    kind_name = Archsight::Resources.canonical(filename.split("_").map(&:capitalize).join) # an old help link shows the renamed kind
 
     begin
       content = Archsight::Documentation.generate(kind_name)

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

@@ -74,7 +74,7 @@ module Archsight::Web::API::JsonHelpers
 
   def build_list_response(kind, pagination, instances)
     {
-      kind: kind,
+      kind: Archsight::Resources.canonical(kind),
       total: pagination[:total],
       limit: pagination[:limit],
       offset: pagination[:offset],
@@ -88,9 +88,10 @@ module Archsight::Web::API::JsonHelpers
 
   def build_instance_response(kind, instance)
     {
-      kind: kind,
+      kind: Archsight::Resources.canonical(kind),
       name: instance.name,
-      metadata: { annotations: render_annotations(instance.annotations, base: Archsight::Assets.base_dir_for(instance, resources_dir: Archsight.resources_dir)) },
+      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) || {},
       spec: serialize_spec(instance.spec),
       relations: extract_relations(instance),
       references: extract_references(instance),
@@ -106,10 +107,14 @@ module Archsight::Web::API::JsonHelpers
     Archsight::Helpers::DiagramBlocks.render_diagram(source, resolver: Archsight::Helpers::ResourceResolver.new(db))
   end
 
+  # The values of markdown annotations are rendered to HTML: architecture/description and every annotation the
+  # kind defines with `format: :markdown`.
   # @param base [String, nil] directory of the file the resource comes from, for the images of its markdown
-  def render_annotations(annotations, base: nil)
+  # @param kind [String, nil] the kind of the resource, to find which of its annotations are markdown
+  def render_annotations(annotations, base: nil, kind: nil)
+    klass = kind && Archsight::Resources[kind]
     annotations.each_with_object({}) do |(key, value), result|
-      result[key] = if MARKDOWN_ANNOTATION_KEYS.include?(key) && value.is_a?(String)
+      result[key] = if value.is_a?(String) && (MARKDOWN_ANNOTATION_KEYS.include?(key) || klass&.annotation_format(key) == :markdown)
                       markdown(value, base: base)
                     else
                       value
@@ -130,13 +135,11 @@ module Archsight::Web::API::JsonHelpers
   end
 
   def build_count_response(query, results, query_time_ms)
-    by_kind = results.group_by { |r| r.class.to_s.split("::").last }
-                     .transform_values(&:length)
     {
       query: query,
       total: results.length,
       query_time_ms: query_time_ms,
-      by_kind: by_kind
+      by_kind: Archsight::MCP.count_by_kind(results)
     }
   end
 
@@ -144,10 +147,13 @@ module Archsight::Web::API::JsonHelpers
     limit, offset = parse_pagination_params
     output = parse_output_param
     sorted = results.sort_by(&:name)
-    pagination = paginate(sorted, limit: limit, offset: offset)
+    # `kind` narrows the hits to one kind; by_kind always counts all hits so the facets stay complete
+    kind = params[:kind].to_s
+    visible = kind.empty? ? sorted : sorted.select { |r| Archsight::MCP.kind_of(r) == kind }
+    pagination = paginate(visible, limit: limit, offset: offset)
 
     instances = pagination[:items].map do |r|
-      resource_summary(r, output: output, omit_kind: false)
+      resource_summary(r, output: output, omit_kind: false).merge(highlights: Archsight::MCP.highlights(r))
     end
 
     {
@@ -157,6 +163,7 @@ module Archsight::Web::API::JsonHelpers
       offset: pagination[:offset],
       count: instances.length,
       query_time_ms: query_time_ms,
+      by_kind: Archsight::MCP.count_by_kind(results),
       instances: instances
     }
   end
@@ -165,11 +172,10 @@ module Archsight::Web::API::JsonHelpers
     relations = {}
 
     instance.class.relations.each do |verb, spec_key, kind|
-      rels = instance.relations(verb, spec_key).map(&:name)
-      next if rels.empty?
-
-      relations[verb] ||= {}
-      relations[verb][kind] = rels
+      found = instance.relations(verb, spec_key)
+      # derived relations hold resources of any kind: grouped by the kind each one is
+      groups = Archsight::Resources::DERIVED_VERBS.include?(verb) ? found.group_by(&:klass) : { kind => found }
+      groups.each { |target_kind, rels| (relations[verb] ||= {})[target_kind] = rels.map(&:name) unless rels.empty? }
     end
 
     relations

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

@@ -650,7 +650,12 @@ paths:
         See the API description for full query language documentation.
 
         Response includes: kind, name, metadata, spec (no relations/references).
-        Additional fields: query, query_time_ms, by_kind (count mode).
+        Additional fields: query, query_time_ms, by_kind.
+
+        Every hit carries `highlights`: the values of the kind's summary attributes (annotations marked
+        `summary: true` in the kind definition, at most 3 per kind, computed ones included) that are set.
+        `by_kind` counts all hits of the query per kind, also when `kind` narrows the list, so a client can show
+        facets and let the user pick one.
       operationId: search
       tags:
         - Search
@@ -674,6 +679,13 @@ paths:
             orphan:
               value: '<- none'
               summary: Find orphan resources
+        - name: kind
+          in: query
+          required: false
+          description: Only return hits of this kind (`total` and paging follow; `by_kind` still counts all hits)
+          schema:
+            type: string
+          example: TechnologyArtifact
         - $ref: '#/components/parameters/limit'
         - $ref: '#/components/parameters/offset'
         - $ref: '#/components/parameters/output'
@@ -691,6 +703,88 @@ paths:
               schema:
                 $ref: '#/components/schemas/QueryError'
 
+  /api/v1/requirements:
+    get:
+      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.
+      operationId: getRequirements
+      tags:
+        - Search
+      parameters:
+        - name: of
+          in: query
+          required: true
+          description: Query selecting the resources whose requirements are listed
+          schema:
+            type: string
+          example: 'ApplicationService: name =~ "Backup"'
+        - name: priority
+          in: query
+          required: false
+          description: Comma separated list, only requirements with one of these priorities
+          schema:
+            type: string
+          example: must,should
+        - name: status
+          in: query
+          required: false
+          description: Comma separated list, only requirements with one of these statuses
+          schema:
+            type: string
+          example: implemented,partial
+      responses:
+        '200':
+          description: The requirements
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  query:
+                    type: string
+                  total:
+                    type: integer
+                  query_time_ms:
+                    type: number
+                  requirements:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        status:
+                          type: string
+                          enum: [implemented, partial, planned]
+                        priority:
+                          type: string
+                          nullable: true
+                        story:
+                          type: string
+                          nullable: true
+                        by:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              kind:
+                                type: string
+                              name:
+                                type: string
+                              status:
+                                type: string
+                                enum: [implemented, partial, planned]
+        '400':
+          description: Invalid query, or an unknown priority or status
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/QueryError'
+
   /dot:
     get:
       summary: Get full architecture graph as DOT
@@ -1225,6 +1319,40 @@ components:
           items:
             $ref: '#/components/schemas/Kind'
 
+    Highlight:
+      type: object
+      required:
+        - key
+        - title
+        - value
+      properties:
+        key:
+          type: string
+          description: Annotation key, exactly as the query language takes it
+          example: activity/status
+        title:
+          type: string
+          description: Display title of the annotation
+          example: Activity Status
+        value:
+          description: The value; an array for list annotations, a number for Integer/Float typed ones
+          oneOf:
+            - type: string
+            - type: number
+            - type: array
+              items:
+                type: string
+        format:
+          type: string
+          nullable: true
+          description: Rendering hint of the annotation (tag_word, tag_list, markdown, link, ...)
+          example: tag_word
+        type:
+          type: string
+          nullable: true
+          description: Short name of the value type when the annotation declares one (Integer, Float, Time, Person, ...)
+          example: Integer
+
     Instance:
       type: object
       required:
@@ -1247,6 +1375,11 @@ components:
           type: object
           additionalProperties: true
           description: Instance specification
+        highlights:
+          type: array
+          description: Values of the kind's summary attributes that are set (search results only)
+          items:
+            $ref: '#/components/schemas/Highlight'
         relations:
           type: object
           additionalProperties:
@@ -1307,7 +1440,7 @@ components:
           type: object
           additionalProperties:
             type: integer
-          description: Result counts by kind (count mode only)
+          description: Result counts by kind (search and count mode; all hits of the query, not only the current page)
         instances:
           type: array
           items:

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

@@ -67,13 +67,14 @@ module Archsight::Web::API::PageHelpers
     rest.to_s.lstrip
   end
 
-  # Other pages linking to this page with [[name]], [[title]] (optionally with |label)
+  # The other pages that link to this page with [[name]] or [[title]] (optionally with |label): the pages that mention it
+  # (see Archsight::References), so a link in code does not count and a page is not listed twice.
   def page_backlinks(page)
-    targets = [page.name, page.title].map { |t| Regexp.escape(t.to_s) }.uniq.join("|")
-    pattern = /\[\[\s*(?:#{targets})\s*(?:\||\]\])/i
-    db.instances_by_kind("Page").values
-      .select { |other| other != page && other.annotations["page/content"].to_s.match?(pattern) }
-      .sort_by(&:name)
-      .map { |other| { name: other.name, title: other.title } }
+    page.references
+        .select { |ref| ref[:verb] == :mentions && ref[:instance].klass == "Page" && !ref[:instance].equal?(page) }
+        .map { |ref| ref[:instance] }
+        .uniq
+        .sort_by(&:name)
+        .map { |other| { name: other.name, title: other.title } }
   end
 end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Archsight; end
+module Archsight::Web; end
+module Archsight::Web::API; end
+
+# Parameters and JSON of `GET /api/v1/requirements` (see Archsight::Requirements)
+module Archsight::Web::API::RequirementsHelpers
+  # @param name [Symbol] a comma separated list parameter, every value of which must be one of `allowed`
+  def csv_param(name, allowed)
+    values = params[name].to_s.split(",").map(&:strip).reject(&:empty?)
+    invalid = values - allowed
+    json_error("Parameter '#{name}' must be #{allowed.join(", ")}, not '#{invalid.first}'", status: 400, error_type: "BadRequest") unless invalid.empty?
+
+    values
+  end
+
+  def build_requirements_response(query, requirements, query_time_ms)
+    {
+      query: query,
+      total: requirements.length,
+      query_time_ms: query_time_ms,
+      requirements: requirements.map { |r| r.merge(story: r[:story] && markdown(r[:story])) }
+    }
+  end
+end

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

@@ -4,6 +4,7 @@ require "sinatra/base"
 require "sinatra/extension"
 require_relative "json_helpers"
 require_relative "page_helpers"
+require_relative "requirements_helpers"
 require_relative "../../assets"
 
 module Archsight; end
@@ -16,6 +17,7 @@ module Archsight::Web::API::Routes
 
   helpers Archsight::Web::API::JsonHelpers
   helpers Archsight::Web::API::PageHelpers
+  helpers Archsight::Web::API::RequirementsHelpers
 
   # Rendering is CPU work, previews are typed, not pasted
   MAX_DIAGRAM_SOURCE = 100_000
@@ -110,6 +112,23 @@ module Archsight::Web::API::Routes
     end
   end
 
+  # GET /api/v1/requirements - The requirements of the resources a query selects (see Archsight::Requirements)
+  get "/api/v1/requirements" do
+    query = params[:of]
+    json_error("Query parameter 'of' is required", status: 400, error_type: "BadRequest") unless query
+
+    priority = csv_param(:priority, Archsight::Requirements::PRIORITIES)
+    status = csv_param(:status, Archsight::Requirements::STATUSES.values)
+    start_time = Time.now
+
+    begin
+      requirements = Archsight::Requirements.collect(db, of: query, priority: priority, status: status)
+      json_response(build_requirements_response(query, requirements, ((Time.now - start_time) * 1000).round(2)))
+    rescue Archsight::Query::QueryError => e
+      json_error(e.message, status: 400, error_type: "QueryError", query: query)
+    end
+  end
+
   # GET /api/v1/assets/*path - Images and draw.io diagrams that markdown embeds. The path is relative to the
   # resources directory; only files of the allowed types inside it are ever served, never anything outside of
   # it and never resource definitions (see Archsight::Assets). Outside, missing and not-served-type all

data/lib/archsight/web/application.rb

@@ -87,9 +87,14 @@ class Archsight::Web::Application < Sinatra::Base
     mcp_server.register_tool(Archsight::MCP::ResourceDocTool)
     mcp_server.register_tool(Archsight::MCP::ExecuteAnalysisTool)
 
+    # The server is meant to be deployed (behind an ingress under its own hostname), and the web UI and API do not
+    # restrict who may reach them either. FastMcp's default would only accept the Origin / Host `localhost`
+    # (DNS-rebinding protection) and answer every other hostname with 403, so the check is switched off: an empty
+    # list of allowed origins disables it.
     use FastMcp::Transports::RackTransport, mcp_server,
         path_prefix: "/mcp",
-        localhost_only: false
+        localhost_only: false,
+        allowed_origins: []
   end
 
   helpers Archsight::GraphvisRenderer, Archsight::Helpers
@@ -140,6 +145,9 @@ class Archsight::Web::Application < Sinatra::Base
       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))
+      # so are ```view and ```requirements blocks (see ViewBlocks, RequirementsBlocks)
+      html, views = Archsight::Helpers::ViewBlocks.extract(html)
+      html, requirements = Archsight::Helpers::RequirementsBlocks.extract(html)
 
       # Resolve relative URLs if we have a git URL (for repository READMEs)
       if git_url && (base_url = github_raw_base_url(git_url))
@@ -157,7 +165,9 @@ class Archsight::Web::Application < Sinatra::Base
       # Convert [[Target]] / [[Target|label]] wiki-style links to page and resource links
       html = Archsight::Helpers::Embeds.new(db).render(html)
       html = Archsight::Helpers::WikiLinks.new(db).render(Archsight::Helpers::Macros.render(html, context: Archsight::Helpers::Macros::Context.new(db, page)))
-      Archsight::Helpers::DiagramBlocks.restore(html, diagrams)
+      html = Archsight::Helpers::DiagramBlocks.restore(html, diagrams)
+      html = Archsight::Helpers::ViewBlocks.restore(html, views)
+      Archsight::Helpers::RequirementsBlocks.restore(html, requirements)
     end
 
     # Generate asset path with cache-busting query string based on file mtime

data/lib/archsight/web/public/vue/ApiDocsPage-DZ0fa5-h.css

@@ -0,0 +1 @@
+.back-link[data-v-4823b89b]{z-index:100;font-size:var(--fs-sm);background:#fff;border:1px solid #ddd;border-radius:4px;padding:6px 14px;text-decoration:none;position:fixed;top:12px;right:12px;box-shadow:0 1px 4px #0000001a}

data/lib/archsight/web/public/vue/ApiDocsPage-DoOxKjG0.js

@@ -0,0 +1 @@
+import{$ as e,B as t,H as n,M as r,T as i,X as a,Y as o,j as s,k as c,t as l,x as u}from"./index-D0Q5GZRs.js";var d={class:`api-docs-page`},f={key:0,class:`pico-color-red-500`},p=l({__name:`ApiDocsPage`,setup(l){let p=u(),m=o(null),h=o(null);function g(e){return new Promise((t,n)=>{if(window.Redoc)return t();let r=document.createElement(`script`);r.src=e,r.onload=t,r.onerror=()=>n(Error(`Failed to load ReDoc`)),document.head.appendChild(r)})}return t(async()=>{try{await g(`https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js`),window.Redoc.init(`/api/v1/openapi.yaml`,{},m.value)}catch(e){h.value=e.message}}),(t,o)=>(n(),r(`div`,d,[c(`a`,{href:`#`,class:`back-link`,onClick:o[0]||=i(e=>a(p).back(),[`prevent`])},`← Back`),h.value?(n(),r(`div`,f,e(h.value),1)):s(``,!0),c(`div`,{ref_key:`container`,ref:m},null,512)]))}},[[`__scopeId`,`data-v-4823b89b`]]);export{p as default};

data/lib/archsight/web/public/vue/{DocPage-uaT8CdFm.js → DocPage-CfsC3CeQ.js}

@@ -1 +1 @@
-import{G as e,J as t,O as n,V as r,j as i,k as a,s as o}from"./index-CyVWObLU.js";import{t as s}from"./WikiPage-DbmWkM7W.js";var c={key:1},l={__name:`DocPage`,props:{filename:String},setup(l){let u=l,d=t(null);function f(e,t){let n=new DOMParser().parseFromString(e,`text/html`).body,r=n.querySelector(`:scope > article`)||n,i=r.querySelector(`h1`),a=i?.textContent.trim()||t.split(`/`).pop().replace(/[-_]/g,` `);i?.remove();let o=[...r.querySelectorAll(`h2[id], h3[id], h4[id]`)].map(e=>({level:Number(e.tagName[1]),id:e.id,text:e.textContent.trim()})),s=[{title:`Documentation`}];return t.startsWith(`resources/`)&&s.push({title:`Resource types`}),{title:a,html:r.innerHTML,toc:o.length>=2?o:[],breadcrumb:s}}async function p(){let e=await o(u.filename);d.value=e?f(e,u.filename):{title:`Not found`,html:`<p>Documentation not found.</p>`,toc:[],breadcrumb:[{title:`Documentation`}]},document.title=`${d.value.title} - Archsight`}return e(()=>u.filename,p,{immediate:!0}),(e,t)=>d.value?(r(),a(s,{key:0,title:d.value.title,html:d.value.html,breadcrumb:d.value.breadcrumb,toc:d.value.toc},null,8,[`title`,`html`,`breadcrumb`,`toc`])):(r(),i(`article`,c,[...t[0]||=[n(`p`,null,`Loading...`,-1)]]))}};export{l as default};
+import{A as e,H as t,K as n,M as r,Y as i,k as a,s as o}from"./index-D0Q5GZRs.js";import{t as s}from"./WikiPage-DrvCHwJ7.js";var c={key:1},l={__name:`DocPage`,props:{filename:String},setup(l){let u=l,d=i(null);function f(e,t){let n=new DOMParser().parseFromString(e,`text/html`).body,r=n.querySelector(`:scope > article`)||n,i=r.querySelector(`h1`),a=i?.textContent.trim()||t.split(`/`).pop().replace(/[-_]/g,` `);i?.remove();let o=[...r.querySelectorAll(`h2[id], h3[id], h4[id]`)].map(e=>({level:Number(e.tagName[1]),id:e.id,text:e.textContent.trim()})),s=[{title:`Documentation`}];return t.startsWith(`resources/`)&&s.push({title:`Resource types`}),{title:a,html:r.innerHTML,toc:o.length>=2?o:[],breadcrumb:s}}async function p(){let e=await o(u.filename);d.value=e?f(e,u.filename):{title:`Not found`,html:`<p>Documentation not found.</p>`,toc:[],breadcrumb:[{title:`Documentation`}]},document.title=`${d.value.title} - Archsight`}return n(()=>u.filename,p,{immediate:!0}),(n,i)=>d.value?(t(),e(s,{key:0,title:d.value.title,html:d.value.html,breadcrumb:d.value.breadcrumb,toc:d.value.toc},null,8,[`title`,`html`,`breadcrumb`,`toc`])):(t(),r(`article`,c,[...i[0]||=[a(`p`,null,`Loading...`,-1)]]))}};export{l as default};

data/lib/archsight/web/public/vue/EditorPage-CbG4mc9T.css

@@ -0,0 +1 @@
+.diagram-preview[data-v-11568657]{flex-direction:column;gap:.5rem;min-height:0;display:flex}.preview-head[data-v-11568657]{color:var(--pico-muted-color);font-size:var(--fs-sm);text-transform:uppercase;letter-spacing:.04em;justify-content:space-between;align-items:center;display:flex}.preview-tools[data-v-11568657]{align-items:center;gap:.75rem;display:inline-flex}.preview-state[data-v-11568657]{text-transform:none;letter-spacing:0}.preview-layout[data-v-11568657]{gap:.15rem;display:inline-flex}.preview-layout button[data-v-11568657]{width:1.4rem;height:1.4rem;font-size:var(--fs-xs);color:var(--pico-muted-color);border-radius:var(--pico-border-radius);cursor:pointer;background:0 0;border:1px solid #0000;justify-content:center;align-items:center;margin:0;padding:0;display:inline-flex}.preview-layout button[data-v-11568657]:hover,.preview-layout button[data-v-11568657]:focus-visible{color:var(--pico-primary);border-color:var(--pico-muted-border-color)}.preview-layout button.active[data-v-11568657]{color:var(--pico-primary);border-color:var(--pico-primary)}.preview-error[data-v-11568657]{border-left:4px solid var(--pico-del-color);background:var(--pico-mark-background-color);font-size:var(--fs-sm);overflow-wrap:anywhere;padding:.35rem .6rem}.preview-body[data-v-11568657]{min-height:0;overflow:auto}.preview-body.stale[data-v-11568657]{opacity:.45}.preview-body[data-v-11568657] .asd-diagram{margin:0}.preview-empty[data-v-11568657]{color:var(--pico-muted-color);font-size:var(--fs-xs);margin:0}.field-group[data-v-fe1221de]{margin-bottom:0}.field-group label[data-v-fe1221de]{margin-bottom:.25rem}.field-group label .required[data-v-fe1221de]{color:var(--pico-del-color);margin-left:.15rem}.field-group input[data-v-fe1221de],.field-group select[data-v-fe1221de],.field-group textarea[data-v-fe1221de]{margin-bottom:0}.field-description[data-v-fe1221de]{font-size:var(--fs-xs);color:var(--pico-muted-color);margin-top:.25rem}.field-error[data-v-fe1221de]{color:var(--pico-del-color);font-size:var(--fs-xs);margin-top:.25rem}.field-full-width[data-v-fe1221de]{grid-column:1/-1}.markdown-field textarea[data-v-fe1221de]{font-family:var(--font-mono);font-size:var(--fs-sm);resize:vertical;tab-size:2;min-height:24rem;line-height:1.5}.markdown-field.page-body textarea[data-v-fe1221de]{min-height:65vh}.code-field textarea[data-v-fe1221de]{font-family:var(--font-mono);font-size:var(--fs-sm);resize:vertical;tab-size:2;white-space:pre;overflow-wrap:normal;min-height:600px;line-height:1.5;overflow-x:auto}.field-diagram-preview[data-v-fe1221de]{margin-top:.75rem}.code-field.with-preview.layout-right[data-v-fe1221de]{grid-template-columns:minmax(0,1fr) minmax(0,1fr);align-items:start;gap:1.5rem;display:grid}.code-field.with-preview.layout-right .field-diagram-preview[data-v-fe1221de]{max-height:calc(100vh - 2rem);margin-top:0;position:sticky;top:1rem}.code-field.with-preview.layout-full .code-source[data-v-fe1221de]{display:none}.code-field.with-preview.layout-full .field-diagram-preview[data-v-fe1221de]{margin-top:0}.future-hint[data-v-fe1221de]{color:var(--pico-muted-color);font-size:var(--fs-xs);align-items:center;gap:.35rem;margin-top:.5rem;display:flex}.label-row[data-v-fe1221de]{justify-content:space-between;align-items:center;margin-bottom:.25rem;display:flex}.label-row label[data-v-fe1221de]{margin-bottom:0}.btn-edit-markdown[data-v-fe1221de]{font-size:var(--fs-xs);color:var(--pico-muted-color);border:1px solid var(--pico-muted-border-color);border-radius:var(--pico-border-radius);cursor:pointer;background:0 0;align-items:center;gap:.35rem;padding:.25rem .5rem;transition:all .15s;display:inline-flex}.btn-edit-markdown[data-v-fe1221de]:hover{color:var(--pico-primary);border-color:var(--pico-primary);background-color:#0000}.btn-edit-markdown i[data-v-fe1221de]{font-size:var(--fs-sm)}@media (prefers-color-scheme:dark){.btn-edit-markdown[data-v-fe1221de]{color:#8b949e;border-color:#ffffff26}.btn-edit-markdown[data-v-fe1221de]:hover{color:#58a6ff;border-color:#58a6ff}}.relations-editor[data-v-a987a6fe]{flex-direction:column;gap:.75rem;display:flex}#relations-list[data-v-a987a6fe]{background-color:var(--pico-background-color);border:1px solid var(--pico-muted-border-color);border-radius:4px;flex-direction:column;display:flex}#relations-list[data-v-a987a6fe]:empty{display:none}.relation-item[data-v-a987a6fe]{font-size:var(--fs-sm);border-bottom:1px solid var(--pico-muted-border-color);justify-content:space-between;align-items:center;gap:.5rem;padding:.35rem .5rem;display:flex}.relation-item[data-v-a987a6fe]:last-child{border-bottom:none}.relation-text[data-v-a987a6fe]{white-space:nowrap;text-overflow:ellipsis;flex:1;overflow:hidden}.relation-text strong[data-v-a987a6fe]{font-weight:600}.relation-text em[data-v-a987a6fe]{color:var(--pico-muted-color);font-style:normal}.btn-remove[data-v-a987a6fe]{width:1.5rem;height:1.5rem;color:var(--pico-muted-color);cursor:pointer;background:0 0;border:none;border-radius:3px;flex-shrink:0;justify-content:center;align-items:center;margin:0;padding:0;display:inline-flex}.btn-remove[data-v-a987a6fe]:hover{background-color:var(--pico-del-color);color:#fff}.btn-remove i[data-v-a987a6fe]{font-size:var(--fs-xs)}.add-relation-row[data-v-a987a6fe]{align-items:center;gap:.5rem;display:flex}.add-relation-row select[data-v-a987a6fe]{flex:1;margin:0}.add-relation-row select[data-v-a987a6fe]:first-child{flex:1.2}.btn-add[data-v-a987a6fe]{white-space:nowrap;flex-shrink:0;margin:0}.no-relations[data-v-a987a6fe]{color:var(--pico-muted-color);margin:0;font-style:italic}@media (width<=768px){.add-relation-row[data-v-a987a6fe]{flex-direction:column}.add-relation-row select[data-v-a987a6fe],.add-relation-row button[data-v-a987a6fe]{width:100%}}.yaml-output-container[data-v-b5ea938f]{width:100%}.yaml-success[data-v-b5ea938f]{color:var(--pico-ins-color);align-items:center;gap:.5rem;margin:0 0 1rem;font-weight:500;display:flex}#yaml-content[data-v-b5ea938f]{margin:0 calc(var(--pico-block-spacing-horizontal) * -1);padding:var(--pico-block-spacing-horizontal);background-color:var(--pico-code-background-color);border-radius:0;overflow-x:auto}#yaml-content code[data-v-b5ea938f]{font-size:var(--fs-sm);white-space:pre;padding:0;line-height:1.5}footer[data-v-b5ea938f]{justify-content:space-between;align-items:center;gap:1rem;display:flex}.yaml-file-info[data-v-b5ea938f],.yaml-instructions[data-v-b5ea938f]{font-size:var(--fs-sm);color:var(--pico-muted-color);flex:1;gap:.5rem;min-width:0;margin:0;line-height:1.5;display:flex}.yaml-file-info[data-v-b5ea938f]{align-items:center}.yaml-instructions[data-v-b5ea938f]{align-items:flex-start}.yaml-file-info>span[data-v-b5ea938f],.yaml-instructions>span[data-v-b5ea938f]{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.yaml-file-info>i[data-v-b5ea938f],.yaml-instructions>i[data-v-b5ea938f]{flex-shrink:0}.yaml-actions[data-v-b5ea938f]{flex-shrink:0;gap:.5rem;display:flex}.yaml-actions button[data-v-b5ea938f],.yaml-actions [role=button][data-v-b5ea938f]{width:auto;margin:0}.conflict-error[data-v-b5ea938f]{background-color:var(--pico-mark-background-color);color:var(--pico-del-color);border-radius:var(--pico-border-radius);align-items:center;gap:.5rem;margin-bottom:1rem;padding:1rem;display:flex}.conflict-error i[data-v-b5ea938f]{flex-shrink:0}@media (width<=768px){footer[data-v-b5ea938f]{flex-direction:column;align-items:stretch}.yaml-actions[data-v-b5ea938f]{flex-direction:column}.yaml-actions button[data-v-b5ea938f],.yaml-actions [role=button][data-v-b5ea938f]{width:100%}}#markdown-editor-overlay[data-v-e8d0cc10]{z-index:1000;position:fixed;inset:0}.markdown-editor-backdrop[data-v-e8d0cc10]{background-color:#00000080;position:absolute;inset:0}.markdown-editor-panel[data-v-e8d0cc10]{background-color:var(--pico-card-background-color,#fff);border-radius:12px;flex-direction:column;display:flex;position:absolute;inset:2rem;overflow:hidden;box-shadow:0 8px 32px #0000004d,0 2px 8px #0003}.lexical-toolbar[data-v-e8d0cc10]{background-color:var(--pico-card-background-color,#fff);z-index:1;flex-wrap:wrap;align-items:center;gap:.25rem;padding:.5rem 1rem;display:flex;box-shadow:0 2px 4px #0000001a}.toolbar-btn[data-v-e8d0cc10]{border-radius:var(--pico-border-radius);min-width:2rem;height:2rem;color:var(--pico-color);font-size:var(--fs-xs);cursor:pointer;background:0 0;border:1px solid #0000;justify-content:center;align-items:center;margin:0;padding:0 .5rem;font-weight:600;transition:all .15s;display:inline-flex}.toolbar-btn[data-v-e8d0cc10]:hover{background-color:var(--pico-muted-border-color);border-color:var(--pico-muted-border-color)}.toolbar-btn[data-v-e8d0cc10]:active{background-color:var(--pico-primary);border-color:var(--pico-primary);color:var(--pico-primary-inverse)}.toolbar-btn i[data-v-e8d0cc10]{font-size:var(--fs-md)}.toolbar-divider[data-v-e8d0cc10]{background-color:var(--pico-muted-border-color);width:1px;height:1.5rem;margin:0 .5rem}.toolbar-spacer[data-v-e8d0cc10]{flex:1}.toolbar-action[data-v-e8d0cc10]{font-size:var(--fs-xs);margin:0;padding:.4rem .75rem}.toolbar-select[data-v-e8d0cc10]{width:auto;min-width:11rem;max-width:15rem;height:2rem;font-size:var(--fs-xs);border:1px solid var(--pico-muted-border-color,#e4e4e7);border-radius:var(--pico-border-radius,.375rem);color:var(--pico-color,inherit);cursor:pointer;background-color:#0000;flex-shrink:0;margin:0;padding:0 .75rem}.toolbar-select[data-v-e8d0cc10]:hover{border-color:var(--pico-primary,#1e88e5)}.toolbar-select[data-v-e8d0cc10]:focus{border-color:var(--pico-primary,#1e88e5);outline:none}.editor-split[data-v-e8d0cc10]{flex-direction:column;flex:1;min-height:0;display:flex}.editor-diagram-preview[data-v-e8d0cc10]{border-top:1px solid var(--pico-muted-border-color,#e4e4e7);flex:0 45%;padding:.5rem 1.5rem 1rem;overflow:hidden}.editor-split.layout-right[data-v-e8d0cc10]{flex-direction:row}.editor-split.layout-right .lexical-editor-container[data-v-e8d0cc10]{flex:50%;min-width:0}.editor-split.layout-right .editor-diagram-preview[data-v-e8d0cc10]{border-top:none;border-left:1px solid var(--pico-muted-border-color,#e4e4e7);flex:50%;min-width:0;padding:1rem 1.5rem;overflow-y:auto}.editor-split.layout-full .lexical-editor-container[data-v-e8d0cc10]{display:none}.editor-split.layout-full .editor-diagram-preview[data-v-e8d0cc10]{border-top:none;flex:auto;overflow-y:auto}.editor-split.layout-hidden .editor-diagram-preview[data-v-e8d0cc10]{flex:none;padding-bottom:.5rem}.lexical-editor-container[data-v-e8d0cc10]{flex-direction:column;flex:1;min-height:0;display:flex;position:relative}#lexical-editor-root[data-v-e8d0cc10]{min-height:0;font-family:var(--pico-font-family);font-size:var(--fs-sm);flex:1;padding:1rem 1.5rem;line-height:1.55;position:relative;overflow-y:auto}#lexical-editor-root[data-v-e8d0cc10]:focus{outline:none}#lexical-editor-root[data-v-e8d0cc10] p{margin:0 0 .75rem}#lexical-editor-root[data-v-e8d0cc10] p:last-child{margin-bottom:0}#lexical-editor-root[data-v-e8d0cc10] h1,#lexical-editor-root[data-v-e8d0cc10] h2,#lexical-editor-root[data-v-e8d0cc10] h3,#lexical-editor-root[data-v-e8d0cc10] h4{margin:1rem 0 .5rem;font-weight:600}#lexical-editor-root[data-v-e8d0cc10] h1{font-size:var(--fs-xl)}#lexical-editor-root[data-v-e8d0cc10] h2{font-size:var(--fs-lg)}#lexical-editor-root[data-v-e8d0cc10] h3{font-size:var(--fs-md)}#lexical-editor-root[data-v-e8d0cc10] h4{font-size:1em}#lexical-editor-root[data-v-e8d0cc10] h1:first-child,#lexical-editor-root[data-v-e8d0cc10] h2:first-child,#lexical-editor-root[data-v-e8d0cc10] h3:first-child{margin-top:0}#lexical-editor-root[data-v-e8d0cc10] ul,#lexical-editor-root[data-v-e8d0cc10] ol{margin:.5rem 0;padding-left:1.5rem}#lexical-editor-root[data-v-e8d0cc10] li{margin:.25rem 0}#lexical-editor-root[data-v-e8d0cc10] blockquote{border-left:3px solid var(--pico-muted-border-color,#e4e4e7);color:var(--pico-muted-color,#71717a);margin:.75rem 0;padding:.5rem 1rem;font-style:italic}#lexical-editor-root[data-v-e8d0cc10] code{background-color:var(--pico-code-background-color,#f4f4f5);border:1px solid var(--pico-muted-border-color,#e4e4e7);font-family:var(--pico-font-family-monospace,monospace);font-size:var(--fs-sm);border-radius:3px;padding:.15rem .35rem}#lexical-editor-root[data-v-e8d0cc10] pre{background-color:var(--pico-code-background-color);border-radius:var(--pico-border-radius);margin:.75rem 0;padding:1rem;position:relative;overflow-x:auto}#lexical-editor-root[data-v-e8d0cc10] pre code{background:0 0;padding:0}#lexical-editor-root[data-v-e8d0cc10] .lexical-code{background-color:var(--pico-code-background-color,#f4f4f5);border-top:1px solid var(--pico-muted-border-color,#e4e4e7);border-bottom:1px solid var(--pico-muted-border-color,#e4e4e7);min-width:calc(100% + 3rem);font-family:var(--pico-font-family-monospace,monospace);font-size:var(--fs-sm);white-space:pre;tab-size:2;box-sizing:border-box;border-radius:0;margin:.75rem -1.5rem;padding:1rem 1.5rem;line-height:1.5;display:block;position:relative;overflow-x:auto}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenComment{color:#6a737d}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenPunctuation{color:#24292e}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenProperty{color:#005cc5}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenSelector{color:#032f62}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenOperator{color:#005cc5}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenAttr{color:#d73a49}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenVariable{color:#e36209}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenFunction{color:#6f42c1}#lexical-editor-root[data-v-e8d0cc10] a{color:var(--pico-primary);text-decoration:underline}#lexical-editor-root[data-v-e8d0cc10] .lexical-link{color:var(--pico-primary,#1e88e5);cursor:pointer;text-decoration:underline}#lexical-editor-root[data-v-e8d0cc10] .lexical-link:hover{text-decoration:none}#lexical-editor-root[data-v-e8d0cc10] strong,#lexical-editor-root[data-v-e8d0cc10] .lexical-bold{font-weight:700}#lexical-editor-root[data-v-e8d0cc10] em,#lexical-editor-root[data-v-e8d0cc10] .lexical-italic{font-style:italic}#lexical-editor-root[data-v-e8d0cc10] u,#lexical-editor-root[data-v-e8d0cc10] .lexical-underline{text-decoration:underline}#lexical-editor-root[data-v-e8d0cc10] s,#lexical-editor-root[data-v-e8d0cc10] .lexical-strikethrough{text-decoration:line-through}@media (prefers-color-scheme:dark){.markdown-editor-panel[data-v-e8d0cc10]{background-color:var(--pico-card-background-color,#1e1e1e);box-shadow:0 8px 32px #00000080,0 2px 8px #0000004d}.markdown-editor-backdrop[data-v-e8d0cc10]{background-color:#000000b3}.lexical-toolbar[data-v-e8d0cc10]{background-color:var(--pico-card-background-color,#1e1e1e);box-shadow:0 2px 4px #0000004d}.toolbar-btn[data-v-e8d0cc10]{color:var(--pico-color,#c9d1d9)}.toolbar-btn[data-v-e8d0cc10]:hover{background-color:#ffffff1a;border-color:#ffffff1a}.toolbar-btn[data-v-e8d0cc10]:active{background-color:var(--pico-primary);border-color:var(--pico-primary)}.toolbar-divider[data-v-e8d0cc10]{background-color:#ffffff26}.toolbar-select[data-v-e8d0cc10]{color:var(--pico-color,#c9d1d9);background-color:#0000;border-color:#fff3}.toolbar-select[data-v-e8d0cc10]:hover,.toolbar-select[data-v-e8d0cc10]:focus{border-color:var(--pico-primary,#58a6ff)}#lexical-editor-root[data-v-e8d0cc10]{color:var(--pico-color,#c9d1d9);background-color:var(--pico-card-background-color,#1e1e1e)}#lexical-editor-root[data-v-e8d0cc10] blockquote{color:#8b949e;border-left-color:#fff3}#lexical-editor-root[data-v-e8d0cc10] code{color:#c9d1d9;background-color:#6e768166;border-color:#ffffff1a}#lexical-editor-root[data-v-e8d0cc10] .lexical-code{color:#c9d1d9;background-color:#0d1117;border-color:#ffffff1a}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenComment{color:#8b949e}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenPunctuation{color:#c9d1d9}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenProperty{color:#79c0ff}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenSelector{color:#a5d6ff}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenOperator{color:#79c0ff}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenAttr{color:#ff7b72}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenVariable{color:#ffa657}#lexical-editor-root[data-v-e8d0cc10] .lexical-code .tokenFunction{color:#d2a8ff}#lexical-editor-root[data-v-e8d0cc10] .lexical-link,#lexical-editor-root[data-v-e8d0cc10] a{color:#58a6ff}}.editor-form[data-v-822cad5e]{max-width:100%}.annotations-grid[data-v-822cad5e]{grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:1rem;display:grid}.annotations-grid .field-full-width[data-v-822cad5e]{grid-column:1/-1}.form-actions[data-v-822cad5e]{gap:.75rem;margin-top:1rem;display:flex}.form-actions button[data-v-822cad5e]{width:auto;margin:0;padding:.5rem 1.25rem}.btn-back[data-v-822cad5e]{align-items:center;gap:.25rem;text-decoration:none;display:inline-flex}.relations-editor .relation-item[data-v-822cad5e]{align-items:center;gap:.5rem;padding:.25rem 0;display:flex}.relations-editor .relation-text[data-v-822cad5e]{flex:1}.relations-editor .btn-remove[data-v-822cad5e]{cursor:pointer;color:var(--pico-del-color,#c62828);background:0 0;border:none;width:auto;margin:0;padding:.25rem}.relations-editor .add-relation-row[data-v-822cad5e]{align-items:flex-start;gap:.5rem;margin-top:.5rem;display:flex}.relations-editor .add-relation-row select[data-v-822cad5e]{flex:1;margin-bottom:0}.relations-editor .btn-add[data-v-822cad5e]{white-space:nowrap;margin-bottom:0}.no-relations[data-v-822cad5e]{color:var(--pico-muted-color);font-style:italic}.field-group[data-v-822cad5e]{margin-bottom:.5rem}.field-group .label-row[data-v-822cad5e]{align-items:center;gap:.5rem;margin-bottom:.25rem;display:flex}.field-group .required[data-v-822cad5e]{color:var(--pico-del-color,#c62828)}.field-group .field-description[data-v-822cad5e]{color:var(--pico-muted-color);margin-top:.125rem;display:block}.field-group .field-error[data-v-822cad5e]{color:var(--pico-del-color,#c62828);font-size:var(--fs-sm);margin-top:.125rem}.field-group .btn-edit-markdown[data-v-822cad5e]{border:1px solid var(--pico-primary);color:var(--pico-primary);cursor:pointer;font-size:var(--fs-sm);background:0 0;border-radius:4px;width:auto;margin:0;padding:.125rem .5rem}.field-group .future-hint[data-v-822cad5e]{color:var(--pico-muted-color);margin-top:.125rem;display:block}.field-group textarea[data-v-822cad5e]{min-height:8rem;font-family:inherit}.field-group .code-field textarea[data-v-822cad5e]{font-family:var(--font-mono)}.yaml-output-container .yaml-success[data-v-822cad5e]{color:var(--pico-ins-color,#2e7d32)}.yaml-output-container pre[data-v-822cad5e]{max-height:60vh;overflow:auto}.yaml-output-container .yaml-actions[data-v-822cad5e]{gap:.5rem;margin-top:.5rem;display:flex}.yaml-output-container .yaml-file-info[data-v-822cad5e],.yaml-output-container .yaml-instructions[data-v-822cad5e]{color:var(--pico-muted-color)}.yaml-output-container .copied[data-v-822cad5e],.yaml-output-container .saved[data-v-822cad5e]{opacity:.8}.conflict-error[data-v-822cad5e]{background:var(--pico-del-color,#c62828);color:#fff;border-radius:4px;align-items:center;gap:.5rem;margin-bottom:1rem;padding:.75rem 1rem;display:flex}.editor-container[data-v-822cad5e]{width:100%}.editor-header[data-v-822cad5e]{border-bottom:1px solid var(--pico-muted-border-color);justify-content:space-between;align-items:center;margin-bottom:1.5rem;padding-bottom:1rem;display:flex}.editor-header h2[data-v-822cad5e]{align-items:center;gap:.75rem;margin:0;display:flex}.header-actions[data-v-822cad5e]{align-items:center;gap:.5rem;display:flex}.btn-header[data-v-822cad5e]{font-size:var(--fs-sm);color:var(--pico-muted-color);border-radius:var(--pico-border-radius);cursor:pointer;background:0 0;border:1px solid #0000;align-items:center;gap:.35rem;padding:.4rem .75rem;text-decoration:none;transition:all .15s;display:inline-flex}.btn-header[data-v-822cad5e]:hover{color:var(--pico-primary);border-color:var(--pico-primary)}.yaml-output>header[data-v-822cad5e]{justify-content:space-between;align-items:center;display:flex}.yaml-output>header h3[data-v-822cad5e]{align-items:center;gap:.5rem;margin:0;display:flex}@media (width<=768px){.editor-header[data-v-822cad5e]{flex-direction:column;align-items:flex-start;gap:1rem}.annotations-grid[data-v-822cad5e]{grid-template-columns:1fr}}