* fix(review): anchor files on their saver in the scan and Needs review (#390) The scan and Apply now resolve with the file's name, as the workspace inspector does since #383, so the one saver whose filename_prefix names the file anchors its branch. A file whose branch that anchor resolves is never queued (from the inspection profile it offers no choice; a default-ambiguous file asks saver_anchored) and its pending, undecided items leave on the next scan. REVIEW_RULE_VERSION is folded into inspection item versions so old items are re-evaluated. No match, several matches or an unfinished walk anchor nothing. Apply refuses a choice the anchor contradicts. * fix(review): refuse a default choice the saver anchor contradicts (#390) Apply re-resolves a default item with the file's name: when its saver anchors the branch, no candidate is offered and the choice is refused. The scan's anchor check skips bytes carrying a decision and remembers unanchored file states per process, so a rescan does not inspect an unchanged file again. * fix(review): queue an anchored file with its saver's pair as the choice (#390) Maintainer ruling: a file never falls through both the link and the queue. When only the saver anchor resolves a file the default profile and the parser floor leave unlinked, the scan queues it with the anchor's pair as its one candidate (evidence anchor: saver), never linking it. Files already linked or resolved by the default path are unchanged. Apply accepts the anchored pair when the bytes now resolve to it, and an anchored item is a choice the untraced settle keeps. * fix(review): upgrade old default items of anchored files, tag anchored results (#390) A pending default item recorded before the saver anchor no longer shortcuts the rescan when only the anchor resolves the file: the anchored item supersedes it. Apply accepts a resolved re-resolution only when it is tagged as the saver anchor's, the anchored pair must carry a positive text to choose, and limited anchored evidence still counts as a choice. TESTING.md describes the ruling.
334 lines
13 KiB
Python
334 lines
13 KiB
Python
"""The scan and Needs review anchor a file on the saver that wrote it (#390).
|
|
|
|
The workspace inspector (since #383) passes the file's name to the resolver,
|
|
which anchors the file on the one saver whose ``filename_prefix`` names it
|
|
(``_GraphResolver.saver_stages``). The scan and Needs review use the same
|
|
rule. Maintainer ruling: a file never falls through both the link and the
|
|
queue, so when only that anchor resolves a file the default profile and the
|
|
parser floor do not link, it is queued with the anchor's pair as its one
|
|
choice (never linked automatically). No match, several matches or an
|
|
unfinished walk anchor nothing, so such a file is queued as before. Apply
|
|
re-resolves with the file's name, so a choice the anchor contradicts is
|
|
refused as stale evidence.
|
|
"""
|
|
|
|
import json
|
|
from unittest.mock import patch
|
|
|
|
try:
|
|
from tests.test_review import unlinkable_graph, write_png
|
|
from tests.test_review_inspection import (
|
|
PROMPTS,
|
|
_counted,
|
|
InspectionTestCase,
|
|
qwen_edit_graph,
|
|
)
|
|
except ImportError: # discovered with tests/ as the top-level directory
|
|
from test_review import unlinkable_graph, write_png
|
|
from test_review_inspection import (
|
|
PROMPTS,
|
|
_counted,
|
|
InspectionTestCase,
|
|
qwen_edit_graph,
|
|
)
|
|
|
|
from utils import review_capture
|
|
|
|
|
|
def branch_graph(*prompts, prefixes=None):
|
|
"""A Qwen-edit batch whose every SaveImage has its own literal prefix."""
|
|
graph = qwen_edit_graph(*prompts)
|
|
savers = [n for n in graph.values() if n["class_type"] == "SaveImage"]
|
|
names = prefixes or [f"branch_{index}" for index in range(len(savers))]
|
|
for saver, prefix in zip(savers, names):
|
|
saver["inputs"]["filename_prefix"] = prefix
|
|
return graph
|
|
|
|
|
|
def saved_unlinkable_graph(*positives):
|
|
"""``unlinkable_graph`` whose branches save under their own prefix.
|
|
|
|
The default profile finds it ambiguous with a choice and the scan's
|
|
browser-parser floor links nothing, so it is queued from the default
|
|
profile unless the saver that wrote the file anchors its branch.
|
|
"""
|
|
graph = unlinkable_graph(*positives)
|
|
samplers = [
|
|
node_id
|
|
for node_id, node in graph.items()
|
|
if node["class_type"] == "KSampler" and node_id != "3"
|
|
]
|
|
for index, sampler in enumerate(samplers):
|
|
graph[f"{sampler}1"] = {
|
|
"class_type": "VAEDecode",
|
|
"inputs": {"samples": [sampler, 0], "vae": ["1", 2]},
|
|
}
|
|
graph[f"{sampler}2"] = {
|
|
"class_type": "SaveImage",
|
|
"inputs": {
|
|
"images": [f"{sampler}1", 0],
|
|
"filename_prefix": f"side_{index}",
|
|
},
|
|
}
|
|
return graph
|
|
|
|
|
|
def _without_name(real):
|
|
"""``resolve_inspection`` as it was before #390: the file name ignored."""
|
|
|
|
def unnamed(metadata, file_name=None):
|
|
return real(metadata)
|
|
|
|
return unnamed
|
|
|
|
|
|
def _only_candidate(test, item):
|
|
"""The positive text of an anchored item's one candidate."""
|
|
evidence = json.loads(item["evidence"])
|
|
test.assertEqual(evidence.get("anchor"), "saver")
|
|
test.assertEqual(evidence.get("profile"), "inspection")
|
|
(candidate,) = evidence["candidates"]
|
|
return candidate["positive"]["text"]
|
|
|
|
|
|
class TestInspectionItemsAnchor(InspectionTestCase):
|
|
async def test_file_its_saver_names_is_queued_with_the_anchor_choice(self):
|
|
self._roots()
|
|
path = self._write("branch_1_00001_.png", graph=branch_graph(*PROMPTS))
|
|
|
|
job = await self._scan()
|
|
|
|
(item,) = self._items()
|
|
self.assertEqual(_only_candidate(self, item), "add a red hat")
|
|
self.assertEqual(item["candidate_count"], 1)
|
|
self.assertEqual(
|
|
item["resolver_version"],
|
|
review_capture.inspection_review_version(
|
|
{"prompt": branch_graph(*PROMPTS)}
|
|
),
|
|
)
|
|
(row,) = job["outcomes"]["review"]
|
|
self.assertEqual(row["path"], "branch_1_00001_.png")
|
|
# Queued, never linked: ingestion stays on the default profile.
|
|
self.assertIsNone(self._linked_text(path))
|
|
|
|
async def test_anchored_item_stays_on_rescan(self):
|
|
self._roots()
|
|
self._write("branch_1_00001_.png", graph=branch_graph(*PROMPTS))
|
|
await self._scan()
|
|
(item,) = self._items()
|
|
|
|
job = await self._scan("all")
|
|
|
|
self.assertEqual([i["id"] for i in self._items()], [item["id"]])
|
|
self.assertEqual(job["scope"]["review_untraced"], 0)
|
|
|
|
async def test_file_no_saver_names_stays_queued(self):
|
|
self._roots()
|
|
self._write("elsewhere_00001_.png", graph=branch_graph(*PROMPTS))
|
|
|
|
await self._scan()
|
|
|
|
(item,) = self._items()
|
|
self.assertEqual(item["candidate_count"], len(PROMPTS))
|
|
self.assertNotIn("anchor", json.loads(item["evidence"]))
|
|
|
|
async def test_file_several_savers_name_stays_queued(self):
|
|
self._roots()
|
|
graph = branch_graph(*PROMPTS, prefixes=["same", "same", "other"])
|
|
self._write("same_00001_.png", graph=graph)
|
|
|
|
await self._scan()
|
|
|
|
(item,) = self._items()
|
|
self.assertEqual(item["candidate_count"], len(PROMPTS))
|
|
|
|
async def test_old_rule_item_is_replaced_by_the_anchor_choice(self):
|
|
self._roots()
|
|
self._write("branch_1_00001_.png", graph=branch_graph(*PROMPTS))
|
|
real = review_capture.resolve_inspection
|
|
with (
|
|
patch.object(review_capture, "REVIEW_RULE_VERSION", 0),
|
|
patch.object(
|
|
review_capture, "resolve_inspection", side_effect=_without_name(real)
|
|
),
|
|
):
|
|
await self._scan()
|
|
(old,) = self._items() # queued under the old rule with every branch
|
|
self.assertEqual(old["candidate_count"], len(PROMPTS))
|
|
|
|
await self._scan("all")
|
|
|
|
(item,) = self._items()
|
|
self.assertNotEqual(item["id"], old["id"])
|
|
self.assertEqual(_only_candidate(self, item), "add a red hat")
|
|
|
|
async def test_apply_links_the_anchor_choice(self):
|
|
self._require_routes()
|
|
self._roots()
|
|
path = self._write("branch_1_00001_.png", graph=branch_graph(*PROMPTS))
|
|
await self._scan()
|
|
|
|
_item, (status, data) = await self._apply("add a red hat")
|
|
|
|
self.assertEqual(status, 200, data)
|
|
self.assertEqual(self._linked_text(path), "add a red hat")
|
|
|
|
async def test_apply_refuses_an_old_choice_the_anchor_contradicts(self):
|
|
self._require_routes()
|
|
self._roots()
|
|
path = self._write("branch_1_00001_.png", graph=branch_graph(*PROMPTS))
|
|
real = review_capture.resolve_inspection
|
|
with (
|
|
patch.object(review_capture, "REVIEW_RULE_VERSION", 0),
|
|
patch.object(
|
|
review_capture, "resolve_inspection", side_effect=_without_name(real)
|
|
),
|
|
):
|
|
await self._scan()
|
|
item, detail, observed = await self._open()
|
|
# branch_1 is the saver of "add a red hat"; choose another branch.
|
|
wrong = self._candidate(detail, "make it night")
|
|
|
|
status, data = await self._decide(
|
|
item["id"], self._body(detail, observed, wrong["hash"])
|
|
)
|
|
|
|
self.assertEqual(status, 409, data)
|
|
self.assertEqual(data["code"], "review-conflict", data)
|
|
self.assertIsNone(self._linked_text(path))
|
|
|
|
|
|
class TestDefaultItemsAnchor(InspectionTestCase):
|
|
async def test_anchor_resolves_and_nothing_links_so_it_is_queued(self):
|
|
"""Maintainer ruling: never unlinked and unqueued. The anchor resolves
|
|
the file, the default profile and the parser floor link nothing, so
|
|
it is queued with the anchor's pair as its choice."""
|
|
self._roots()
|
|
path = self.output_dir / "side_0_00001_.png"
|
|
graph = saved_unlinkable_graph("cat", "dog")
|
|
write_png(path, prompt=graph)
|
|
self.assertEqual(
|
|
review_capture.resolve_prompt_pair({"prompt": graph})["state"], "ambiguous"
|
|
)
|
|
|
|
job = await self._scan()
|
|
|
|
(item,) = self._items()
|
|
self.assertEqual(_only_candidate(self, item), "cat")
|
|
(row,) = job["outcomes"]["review"]
|
|
self.assertIn("more than one prompt could match", row["detail"])
|
|
self.assertIsNone(self._linked_text(path))
|
|
|
|
async def test_default_ambiguous_file_no_saver_names_stays_queued(self):
|
|
self._roots()
|
|
write_png(
|
|
self.output_dir / "unsaved_00001_.png",
|
|
prompt=saved_unlinkable_graph("cat", "dog"),
|
|
)
|
|
|
|
await self._scan()
|
|
|
|
(item,) = self._items()
|
|
evidence = json.loads(item["evidence"])
|
|
self.assertNotIn("profile", evidence)
|
|
self.assertNotIn("anchor", evidence)
|
|
self.assertEqual(item["resolver_version"], review_capture.RESOLVER_VERSION)
|
|
|
|
async def test_file_the_parser_floor_links_is_not_queued(self):
|
|
"""Already linked by the default path: unchanged by the anchor."""
|
|
self._roots()
|
|
graph = saved_unlinkable_graph("cat", "dog")
|
|
del graph["3"] # the parser floor now reads a real sampler
|
|
path = self.output_dir / "side_0_00001_.png"
|
|
write_png(path, prompt=graph)
|
|
|
|
await self._scan()
|
|
|
|
self.assertEqual(self._items(), [])
|
|
self.assertIsNotNone(self._linked_text(path))
|
|
|
|
async def test_apply_refuses_an_old_default_choice_the_anchor_contradicts(self):
|
|
self._require_routes()
|
|
self._roots()
|
|
path = self.output_dir / "side_0_00001_.png"
|
|
write_png(path, prompt=saved_unlinkable_graph("cat", "dog"))
|
|
with patch.object(review_capture, "_captured_inspection", return_value=None):
|
|
await self._scan() # queued from the default profile, as before #390
|
|
item, detail, observed = await self._open()
|
|
# side_0 is the saver of "cat"; choose the other branch.
|
|
wrong = self._candidate(detail, "dog")
|
|
|
|
status, data = await self._decide(
|
|
item["id"], self._body(detail, observed, wrong["hash"])
|
|
)
|
|
|
|
self.assertEqual(status, 409, data)
|
|
self.assertEqual(data["code"], "review-conflict", data)
|
|
self.assertIsNone(self._linked_text(path))
|
|
|
|
async def test_old_default_item_is_replaced_by_the_anchor_choice(self):
|
|
self._roots()
|
|
write_png(
|
|
self.output_dir / "side_0_00001_.png",
|
|
prompt=saved_unlinkable_graph("cat", "dog"),
|
|
)
|
|
with patch.object(review_capture, "_captured_inspection", return_value=None):
|
|
await self._scan() # queued from the default profile, as before #390
|
|
(old,) = self._items()
|
|
self.assertEqual(old["resolver_version"], review_capture.RESOLVER_VERSION)
|
|
|
|
await self._scan("all")
|
|
|
|
(item,) = self._items()
|
|
self.assertNotEqual(item["id"], old["id"])
|
|
self.assertEqual(_only_candidate(self, item), "cat")
|
|
|
|
with _counted(review_capture, "resolve_inspection") as calls:
|
|
await self._scan("all") # now queued under its version: no re-read
|
|
self.assertEqual(calls, [])
|
|
self.assertEqual([i["id"] for i in self._items()], [item["id"]])
|
|
|
|
async def test_decided_anchored_item_is_kept(self):
|
|
self._require_routes()
|
|
self._roots()
|
|
write_png(
|
|
self.output_dir / "side_0_00001_.png",
|
|
prompt=saved_unlinkable_graph("cat", "dog"),
|
|
)
|
|
await self._scan()
|
|
item, detail, observed = await self._open()
|
|
status, data = await self._decide(
|
|
item["id"], self._body(detail, observed, "unresolved")
|
|
)
|
|
self.assertEqual(status, 200, data)
|
|
before = (self._items(), self._decisions())
|
|
|
|
await self._scan("all")
|
|
|
|
self.assertEqual((self._items(), self._decisions()), before)
|
|
|
|
async def test_apply_accepts_an_old_default_choice_the_anchor_names(self):
|
|
self._require_routes()
|
|
self._roots()
|
|
path = self.output_dir / "side_0_00001_.png"
|
|
write_png(path, prompt=saved_unlinkable_graph("cat", "dog"))
|
|
with patch.object(review_capture, "_captured_inspection", return_value=None):
|
|
await self._scan()
|
|
|
|
_item, (status, data) = await self._apply("cat")
|
|
|
|
self.assertEqual(status, 200, data)
|
|
self.assertEqual(self._linked_text(path), "cat")
|
|
|
|
|
|
class TestSaverAnchored(InspectionTestCase):
|
|
def test_only_the_anchor_counts(self):
|
|
anchored = {"prompt": saved_unlinkable_graph("cat", "dog")}
|
|
self.assertTrue(review_capture.saver_anchored(anchored, "side_1_00001_.png"))
|
|
self.assertFalse(review_capture.saver_anchored(anchored, "nope_00001_.png"))
|
|
self.assertFalse(review_capture.saver_anchored(anchored, None))
|
|
# One sampler resolves without any name: the anchor decides nothing.
|
|
single = {"prompt": branch_graph("make it night")}
|
|
self.assertFalse(review_capture.saver_anchored(single, "branch_0_00001_.png"))
|