samagotchi 0.152.0 → 0.154.0

data/lib/samagotchi/engine/verify.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+module Samagotchi
+  class Engine
+    # Verify and Revise anchors at a turn's end: the opening's stamp, a Revise
+    # turn's draft checked, a Verify turn's quote checked against its source
+    # session and its verdict recorded. No ivars of its own: it reads the turn,
+    # and the sessions it loads through Engine methods.
+    module VerifyPart
+      # The turn's anchors, stamped on its opening message (the prompt, or a
+      # wake turn's note) in the messages it keeps: display metadata, never
+      # in the prompt (LLM::ChatLoop#plain keeps them, no wire sends them).
+      # A Verify turn's claim however it ended; a Revise turn's draft only
+      # once it completed with an answer (#revision_target). Returns the
+      # stamped ReviseAnchor (the end event's revises), or nil.
+      def stamp_opening(messages, turn, outcome)
+        return unless messages.is_a?(Array)
+
+        revises = revision_target(messages, turn, outcome)
+        fields = { verify: turn.verify&.to_h, revises: revises&.to_h }.compact
+        return if fields.empty?
+
+        opening = messages.reverse.find do |message|
+          Steer.turn_prompt?(message) && (message[:turn_id] || message["turn_id"]).to_s == turn.id
+        end
+        return unless opening
+
+        opening.merge!(fields)
+        revises
+      end
+      private :stamp_opening
+
+      # The turn a Revise turn revised (D6: "this turn revised that one"):
+      # only a completed turn with an answer (AnswerTail) has revised
+      # anything. A draft no prompt in the messages carries is no target (a
+      # stale page, a rolled-back turn); one a stamped turn already revised
+      # is re-targeted to its stack's top, the newest version, which the
+      # person meant ("this draft").
+      def revision_target(messages, turn, outcome)
+        return unless turn.revises && outcome == "completed"
+
+        slice = AnswerTail.turn_slice(messages, turn.id)
+        return unless slice&.any? { |message| AnswerTail.answer?(message) }
+
+        target = turn.revises.turn_id
+        seen = [turn.id]
+        until seen.include?(target)
+          return reject_revise_anchor(turn.revises, :turn_missing) unless AnswerTail.turn_slice(messages, target)
+
+          seen << target
+          newer = messages.reverse.find do |message|
+            Steer.turn_prompt?(message) && ReviseAnchor.from(message[:revises] || message["revises"])&.turn_id == target
+          end
+          return ReviseAnchor.new(turn_id: target) unless newer
+
+          target = (newer[:turn_id] || newer["turn_id"]).to_s
+        end
+        reject_revise_anchor(turn.revises, :cycle)
+      end
+      private :revision_target
+
+      def reject_revise_anchor(anchor, reason)
+        Log.warn(:turn, "revise_anchor_rejected", turn_id: anchor.turn_id, reason:)
+        nil
+      end
+      private :reject_revise_anchor
+
+      def verified_anchor(session, anchor)
+        return unless anchor
+
+        source = verify_anchor_source_session(session, anchor)
+        return unless source
+
+        turn = AnswerTail.turn_slice(Array(source.messages), anchor.turn_id)
+        return reject_verify_anchor(anchor, :turn_missing) unless turn
+
+        reply = turn.reverse.find { |message| AnswerTail.answer?(message) }
+        return reject_verify_anchor(anchor, :reply_missing) unless reply
+
+        quote_text = verify_comparison_text(anchor.quote)
+        quoted = !quote_text.empty? && verify_quote_in?(quote_text, (reply[:content] || reply["content"]).to_s, source)
+        return reject_verify_anchor(anchor, :quote_missing) unless quoted
+
+        anchor
+      end
+      private :verified_anchor
+
+      # Whether +quote_text+ is in +answer+ as the model wrote it, or as the
+      # pages show it: a page quotes its own text, which reads the session's
+      # folder relative, the home folder as ~ and a secret shape as
+      # [redacted] (a participant's page gets it so, Redact;
+      # the owner's page rewrites its quote the same way, claim_link.js
+      # normalizeClaim, so claim links match both pages). +source+ is the
+      # session whose folder that is.
+      def verify_quote_in?(quote_text, answer, source)
+        return true if verify_comparison_text(answer).include?(quote_text)
+
+        viewer = Redact::Viewer.new(cwd: source.working_directory)
+        verify_comparison_text(Redact.text(answer, viewer)).include?(quote_text)
+      end
+      private :verify_quote_in?
+
+      def verify_anchor_source_session(session, anchor)
+        return session unless session.verify_fresh
+
+        fresh = session.verify_fresh
+        return reject_verify_anchor(anchor, :fresh_anchor_mismatch) unless fresh.anchor == anchor
+        return reject_verify_anchor(anchor, :fresh_parent_missing) unless session.parent_id
+
+        Session.load(session.parent_id, state_dir: session_state_dir)
+      rescue ArgumentError, SystemCallError, IOError => e
+        Log.warn(:turn, "verify_anchor_rejected", turn_id: anchor.turn_id, reason: :source_session_unavailable,
+                                                   error: e.class.name)
+        nil
+      end
+      private :verify_anchor_source_session
+
+      def verify_comparison_text(text)
+        OutputFormatter.strip_markup(text)
+                      .gsub(/!\[([^\]]*)\]\([^)]+\)/, '\1')
+                      .gsub(/\[([^\]]+)\]\([^)]+\)/, '\1')
+                      .gsub(/^[ \t]*(?:\#{1,6}[ \t]+|>[ \t]?|[-+*][ \t]+|\d+[.)][ \t]+)/, "")
+                      .gsub(/(\*\*|__|~~|`+)(.+?)\1/m, '\2')
+                      .gsub(/(?<!\w)\*(\S(?:.*?\S)?)\*(?!\w)/m, '\1')
+                      .gsub(/(?<!\w)_(\S(?:.*?\S)?)_(?!\w)/m, '\1')
+                      .tr("|", " ") # a table row's cells; the page copies them without the pipes
+                      .gsub(/\s+/, " ")
+                      .strip
+      end
+      private :verify_comparison_text
+
+      def reject_verify_anchor(anchor, reason)
+        Log.warn(:turn, "verify_anchor_rejected", turn_id: anchor.turn_id, reason:)
+        nil
+      end
+      private :reject_verify_anchor
+
+      def record_verdict(turn, outcome)
+        return unless outcome == "completed" && turn.verify
+
+        answer = AnswerTail.find(turn.session.messages, turn_id: turn.id)
+        parsed = Verdict.parse(answer && (answer[:content] || answer["content"]))
+        return unless parsed
+
+        record = { anchor: turn.verify.to_h, verdict: parsed.verdict, reason: parsed.reason,
+                   by: turn.origin.author, check_turn_id: turn.id, at: Time.now.iso8601(3) }
+        turn.session.verdicts = turn.session.verdicts + [record]
+        record
+      end
+      private :record_verdict
+    end
+  end
+end