from __future__ import annotations import shutil import unittest from pathlib import Path from uuid import uuid4 from backend.dto.common import ApiError, ErrorCode from backend.routes.history_routes import adopt_node_image, list_workflow_history, save_workflow_history from backend.services.history_service import HistoryService from backend.services.image_service import ImageService from backend.services.profile_service import ProfileService from backend.services.workflow_service import WorkflowService from core.audit_service import AuditService from core.identity import RequestContext from database.db_helper import Database, DatabaseSettings, SqliteSettings from database.repositories.image_repository import ImageRepository from database.repositories.profile_repository import ProfileRepository from database.repositories.workflow_repository import WorkflowRepository class HistoryServiceTests(unittest.TestCase): def setUp(self): self.tmp_path = Path(".tmp") / f"test_history_service_{uuid4().hex}" self.tmp_path.mkdir(parents=True, exist_ok=False) self.database = Database( DatabaseSettings(sqlite=SqliteSettings(path=str(self.tmp_path / "imagestudio.db"))) ) self.database.initialize() self.audit_service = AuditService(self.database) self.profile_repository = ProfileRepository(self.database) self.workflow_repository = WorkflowRepository(self.database) self.image_repository = ImageRepository(self.database) self.profile_service = ProfileService(self.profile_repository, self.audit_service) self.workflow_service = WorkflowService( self.workflow_repository, self.profile_repository, self.audit_service, ) self.image_service = ImageService( self.image_repository, self.workflow_repository, self.audit_service, ) self.history_service = HistoryService( workflow_repository=self.workflow_repository, workflow_service=self.workflow_service, image_service=self.image_service, audit_service=self.audit_service, ) self.ctx = RequestContext.from_astrbot( username="admin", user_id="user_001", permissions={"can_write"}, ) self.profile = self.profile_service.create_profile({"name": "Nova"}, self.ctx) self.workflow = self.workflow_service.create_workflow( self.profile.profile_id, {"workflow_type": "character_gradual", "display_name": "Character"}, self.ctx, ) self.node = self.workflow.nodes[1] self.image = self.image_service.create_image( { "node_id": self.node.node_id, "image_uri": "storage://images/headshot.png", "thumbnail_uri": "storage://thumbnails/headshot.png", "positive_prompt": "headshot, silver hair", }, self.ctx, ) def tearDown(self): shutil.rmtree(self.tmp_path, ignore_errors=True) def test_adopt_node_image_writes_history_and_selects_image(self): history = self.history_service.adopt_node_image( self.node.node_id, {"image_id": self.image.image_id, "title": "Accepted headshot"}, self.ctx, ) self.assertTrue(history.history_id.startswith("hist_")) self.assertEqual(history.action, "adopt_image") self.assertEqual(history.image_id, self.image.image_id) self.assertEqual(history.prompt, "headshot, silver hair") self.assertEqual(history.title, "Accepted headshot") selected = self.image_service.get_image(self.image.image_id) node = self.workflow_service.get_node(self.node.node_id) self.assertTrue(selected.is_selected) self.assertEqual(node.status, "selected") self.assertEqual(node.selected_image_id, self.image.image_id) listed = self.history_service.list_workflow_history(self.workflow.workflow.workflow_id) self.assertEqual([entry.history_id for entry in listed], [history.history_id]) def test_adopt_node_image_can_finalize_completed_node(self): self.workflow_service.update_node(self.node.node_id, {"status": "completed"}, self.ctx) history = self.history_service.adopt_node_image( self.node.node_id, {"image_id": self.image.image_id, "title": "Finalized headshot"}, self.ctx, ) node = self.workflow_service.get_node(self.node.node_id) selected = self.image_service.get_image(self.image.image_id) self.assertEqual(history.action, "adopt_image") self.assertEqual(node.status, "selected") self.assertEqual(node.selected_image_id, self.image.image_id) self.assertTrue(selected.is_selected) def test_adopt_node_image_persists_stage_handoff_bucket(self): next_node = self.workflow.nodes[2] history = self.history_service.adopt_node_image( self.node.node_id, { "image_id": self.image.image_id, "metadata": { "source": "standalone_web_stage_review_confirm", "ui_review_node_id": "portrait-review", "source_ui_node_id": "portrait-03", "next_ui_node_id": "hires-fix", "next_backend_node_id": next_node.node_id, "handoff_bucket": "hires-fix", "handoff_role": "hires_fix_input", }, }, self.ctx, ) workflow = self.workflow_service.get_workflow(self.workflow.workflow.workflow_id).workflow stage_input = workflow.metadata["stage_inputs"][next_node.node_id] self.assertEqual(workflow.current_node_id, next_node.node_id) self.assertEqual(workflow.metadata["stage_input_schema_version"], "2026-07-09.stage-input-bucket.v1") self.assertEqual(stage_input["image_id"], self.image.image_id) self.assertEqual(stage_input["image_uri"], "storage://images/headshot.png") self.assertEqual(stage_input["from_node_id"], self.node.node_id) self.assertEqual(stage_input["history_id"], history.history_id) self.assertEqual(stage_input["role"], "hires_fix_input") self.assertTrue(stage_input["locked_source_node"]) def test_adopt_node_image_rejects_switching_selected_node_without_branch(self): self.history_service.adopt_node_image(self.node.node_id, {"image_id": self.image.image_id}, self.ctx) other = self.image_service.create_image( { "node_id": self.node.node_id, "image_uri": "storage://images/other-headshot.png", "positive_prompt": "alternate headshot", }, self.ctx, ) with self.assertRaises(ApiError) as raised: self.history_service.adopt_node_image(self.node.node_id, {"image_id": other.image_id}, self.ctx) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) self.assertEqual(raised.exception.details["suggested_action"], "create_branch") def test_history_routes_wrap_responses_and_require_permissions(self): response = adopt_node_image( self.ctx, self.node.node_id, {"image_id": self.image.image_id}, self.history_service, ) self.assertTrue(response["ok"]) workflow_id = self.workflow.workflow.workflow_id listed = list_workflow_history(self.ctx, workflow_id, {}, self.history_service) self.assertTrue(listed["ok"]) self.assertEqual(len(listed["data"]), 1) snapshot = save_workflow_history( self.ctx, workflow_id, {"title": "Manual snapshot", "include_nodes": True}, self.history_service, ) self.assertTrue(snapshot["ok"]) self.assertEqual(snapshot["data"]["action"], "save_version") self.assertEqual(snapshot["data"]["title"], "Manual snapshot") read_only = RequestContext.from_astrbot(username="viewer", user_id="viewer_001") denied = adopt_node_image( read_only, self.node.node_id, {"image_id": self.image.image_id}, self.history_service, ) self.assertFalse(denied["ok"]) self.assertEqual(denied["error_code"], "FORBIDDEN") def test_save_snapshot_rejects_missing_image_before_foreign_key_insert(self): with self.assertRaises(ApiError) as raised: self.history_service.save_workflow_snapshot( self.workflow.workflow.workflow_id, {"image_id": "img_missing"}, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.RESOURCE_NOT_FOUND) self.assertEqual(raised.exception.details["image_id"], "img_missing") self.assertEqual( self.history_service.list_workflow_history(self.workflow.workflow.workflow_id), [], ) def test_save_snapshot_rejects_image_from_another_workflow(self): other_workflow = self.workflow_service.create_workflow( self.profile.profile_id, {"workflow_type": "single_image", "display_name": "Other"}, self.ctx, ) other_image = self.image_service.create_image( { "node_id": other_workflow.nodes[0].node_id, "image_uri": "storage://images/other-workflow.png", }, self.ctx, ) with self.assertRaises(ApiError) as raised: self.history_service.save_workflow_snapshot( self.workflow.workflow.workflow_id, {"image_id": other_image.image_id}, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) self.assertEqual(raised.exception.details["image_id"], other_image.image_id) self.assertEqual(raised.exception.details["image_workflow_id"], other_workflow.workflow.workflow_id) def test_save_snapshot_rejects_image_from_another_node(self): other_node = self.workflow.nodes[2] with self.assertRaises(ApiError) as raised: self.history_service.save_workflow_snapshot( self.workflow.workflow.workflow_id, {"node_id": other_node.node_id, "image_id": self.image.image_id}, self.ctx, ) self.assertEqual(raised.exception.error_code, ErrorCode.VALIDATION_FAILED) self.assertEqual(raised.exception.details["node_id"], other_node.node_id) self.assertEqual(raised.exception.details["image_id"], self.image.image_id) def test_save_snapshot_accepts_image_from_matching_workflow_and_node(self): history = self.history_service.save_workflow_snapshot( self.workflow.workflow.workflow_id, {"node_id": self.node.node_id, "image_id": self.image.image_id}, self.ctx, ) self.assertEqual(history.node_id, self.node.node_id) self.assertEqual(history.image_id, self.image.image_id) if __name__ == "__main__": unittest.main()