fix(isc): strip trailing quote leaked from multi-line YAML notes

YAML quoted list items spanning multiple lines have opening " on
first line and closing " on last line. The closing " was leaking
into the extracted note value.

Result: 270/289 deep equivalent

Author: ronaldtse

lib/interscript/isc/codemod.rb

@@ -423,6 +423,8 @@ def emit_note_with_continuation(note_indent)
         # Strip outer quotes if the YAML list item was quoted: - "text"
         text = text[1..-2] if text.start_with?('"') && text.end_with?('"')
         text = text[1..-2] if text.start_with?("'") && text.end_with?("'")
+        # Also strip leading quote when text spans multiple lines (closing on later line)
+        text = text[1..] if text.start_with?('"') && !text.end_with?('"')
         text = text[1..] if text.start_with?("'") && !text.end_with?("'")
         # Unescape YAML escape sequences, then re-escape for ISC
         text = text.gsub('\\"', '"').gsub("\\\\", "\\")

lib/interscript/isc/document_builder.rb

@@ -81,15 +81,16 @@ def parse_array_field(val)
         return [] if val.nil? || val.to_s.strip.empty?
         text = val.to_s
         return [text.strip] unless text.include?("\n-")
-        # Multi-line YAML list: merge continuation lines (joined with space)
+        # Multi-line YAML list: merge continuation lines preserving paragraph breaks
         items = []
-        current = nil
         text.lines.each do |l|
           stripped = l.strip
           if stripped.start_with?("- ")
             items << stripped[2..]
+          elsif stripped.empty? && items.any?
+            items[-1] = (items[-1] || "") + "\n\n"
           elsif !stripped.empty? && items.any?
-            items[-1] += " " + stripped
+            items[-1] = (items[-1] || "") + "\n" + stripped
           end
         end
         items.empty? ? [text.strip] : items
@@ -145,11 +146,16 @@ def extract_metadata(arr)
             h[:notes] ||= []
             Array(field[:notes]).each do |n|
               note_val = n.is_a?(Hash) ? n[:note] : n
-              h[:notes] << normalize_heredoc(unquote(note_val).to_s)
+              note_text = normalize_heredoc(unquote(note_val).to_s)
+              note_text = note_text.sub(/"\z/, "")
+              h[:notes] << note_text
             end
           when field.key?(:note)
             h[:notes] ||= []
-            h[:notes] << normalize_heredoc(unquote(field[:note]).to_s)
+            note_text = normalize_heredoc(unquote(field[:note]).to_s)
+            # Strip trailing " leaked from multi-line YAML quoted items
+            note_text = note_text.sub(/"\z/, "")
+            h[:notes] << note_text
           when field.key?(:provenance)
             h[:provenance] ||= []
             h[:provenance] << unquote(field[:provenance])