deepagents-printshop 0.1.0__py3-none-any.whl

deepagents_printshop-0.1.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+agents/content_editor/__init__.py,sha256=ruMzTy6J3tEQ2ylke1RUNlb4HD7bC2oeRjqQ0DoEAFg,52
+agents/content_editor/agent.py,sha256=o2d-eee8q9qpeOVkaCMxhd6sv8Vu1yG-VVEu4ZjUxA4,9669
+agents/content_editor/content_reviewer.py,sha256=4Z57bONlPP53zS8ob6mFzQ0HUi6nPFy5E5Y83YlM1Rk,11585
+agents/content_editor/versioned_agent.py,sha256=F6AMM1y4W2_i9az_aY2VyBREpdx5wfZ9UxIYoG6D_3k,17415
+agents/latex_specialist/__init__.py,sha256=XtnLmA4V157Y-bKFAl0XpCowvEzZ0RDXVEfpY_qiYZs,54
+agents/latex_specialist/agent.py,sha256=wAtpGkDjLTaFK8l7kZg3VugjlqGJWNevVTNv6XNgHGU,19271
+agents/latex_specialist/latex_analyzer.py,sha256=a7MZYzblcdDj5igQAWFp9G7pmAwAb4phsh1RA0aveLI,19860
+agents/latex_specialist/latex_optimizer.py,sha256=birJDUngwxP4M0EoLpTQ2aqOVNfuWANxAppINynoE0Q,52405
+agents/qa_orchestrator/__init__.py,sha256=gQtYVxxyQ5QjMFhKSVfAkBiYn1rgK172bf75Ty1-VJA,53
+agents/qa_orchestrator/agent.py,sha256=AE4Fr15lef5pNaPugtXJx2ryAKpRRr7wRMwt6VnEuv0,23753
+agents/qa_orchestrator/langgraph_workflow.py,sha256=0r-fiNCXV90hvrviDOPBUGX9eyJMU5rNJSQvw_OZakg,31186
+agents/qa_orchestrator/pipeline_types.py,sha256=aPBSDQVJrOTGy5-JMeWWzYnW70td_UWuEe2D55w3NyA,2448
+agents/qa_orchestrator/quality_gates.py,sha256=sUpI9ZHtizoNfHVukopqdkTokUBpCSod5vxpsGfXRew,20191
+agents/qa_orchestrator/workflow_coordinator.py,sha256=mcUwkhmEC-6I-myyERJWoAhaHpXbsxXtPQMSqI2yZWg,6067
+agents/research_agent/__init__.py,sha256=BZ_tHXe9oLT6mKcOMpAL3_0SWUQETwuaz0PEADwWhkE,52
+agents/research_agent/agent.py,sha256=LjzM6qKMXRw6f_GH07rWk4Yh2sIpbEIKaMIZt1eTqWE,8259
+agents/research_agent/llm_report_generator.py,sha256=GKaiDj2Q8f8v2-yp9wY-AQbQNs_6W6B9wJUbmI8f600,40938
+agents/research_agent/report_generator.py,sha256=COAaEP-2Jh8viPogC-rWRmRNDTcIFvi_wDZtFn0TL8c,21828
+agents/visual_qa/__init__.py,sha256=27OkVYIjeQ7U9U-2p4EKbBiF-XJ5QfavF1FizXIefXk,62
+agents/visual_qa/agent.py,sha256=VJsi9lsIrLKFaqbz19Zy1eBtooYqc_JpeDgi7HIM1P4,17343
+tools/__init__.py,sha256=wO6yiGkr4FhjajzqqyALijIYlSMC928sraJz9vc7h4g,77
+tools/change_tracker.py,sha256=tJLFByt-CiGv6iTAA7Y5J1kk1_w0itXFxncmwb_NHa8,16137
+tools/content_type_loader.py,sha256=Q4AAucdvSYSq9Gq5nQpkyl6gzEgywIzSQT_1H3S_YrE,5653
+tools/graph_generator.py,sha256=rHAwxym3sAF-hSticYVL0_OLJiWlOituRPd0zSurEnI,10581
+tools/latex_generator.py,sha256=p3EwIRS8BotP8P9o2TR7S2ic_AakNln78GXZ95RToOk,12153
+tools/llm_latex_generator.py,sha256=RMIrXTiIBRhB5pDnW8-gWldOiU_g7jjTeDp7g-1I3gs,26947
+tools/magazine_layout.py,sha256=yg0-njXcPrc5_VWCujd_3dzh5CSzvdTtBPhW17Y_3_o,15987
+tools/pattern_injector.py,sha256=SqQ8qczMuP94KlxcQyirsLUURP5yG8deeFg6hAfw7nU,9080
+tools/pattern_learner.py,sha256=5BIyZNOBgy8QzyHEzvodVO1AILJlo78hzDmo1bFo4cI,18659
+tools/pdf_compiler.py,sha256=Bwd9xgMY1eGx_4dQJzAyhn74hd9K5rWwy-WgbYAqp_4,15627
+tools/version_manager.py,sha256=DGU_5zvfNIis6ou4qQVsXsjneYWuqthmLjvvjYUKvBM,11662
+tools/visual_qa.py,sha256=Ice7cyKX9tGUMETyqR_4v6EM5sgEUIOFbQ7ixaQfSkA,31952
+deepagents_printshop-0.1.0.dist-info/METADATA,sha256=pzY4P-p5ONxSRclxXH1XkcDFHgi2XoMFCt5iweMJ4qY,29157
+deepagents_printshop-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+deepagents_printshop-0.1.0.dist-info/entry_points.txt,sha256=tjvBcpdgDdScxX04QEH8gDZqMVHMWAFxNqJK7rHHy3Y,64
+deepagents_printshop-0.1.0.dist-info/licenses/LICENSE,sha256=ZdDLHuPyBGNgj2MEuQmnjhbmgBC84BZK2309Tjj2Po0,3308
+deepagents_printshop-0.1.0.dist-info/RECORD,,

deepagents_printshop-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

deepagents_printshop-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+printshop = agents.qa_orchestrator.agent:main

deepagents_printshop-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,86 @@
+# DeepAgents PrintShop License
+
+## Software License (Apache 2.0)
+
+Copyright 2025-2026 DeepAgents PrintShop Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+---
+
+## Attribution Requirement for Generated Works
+
+Any documents, publications, or media generated using DeepAgents PrintShop
+must include the following attribution in a reasonably visible location
+(such as in the document's footer, credits page, colophon, or acknowledgments):
+
+    "Generated with DeepAgents PrintShop (https://github.com/kormco/deepagents-printshop)"
+
+or the shorter form:
+
+    "Powered by DeepAgents PrintShop"
+
+This attribution requirement applies to:
+- PDF documents generated by the system
+- LaTeX source files distributed to others
+- Published works derived from PrintShop output
+- Any derivative media products
+
+This requirement does NOT apply to:
+- Internal drafts and working documents not distributed publicly
+- Documents where you substantially rewrite the generated content
+- Uses where attribution is technically impractical
+
+---
+
+## Sample Content License (CC BY-SA 4.0)
+
+The sample content in `artifacts/sample_content/` is licensed under the
+Creative Commons Attribution-ShareAlike 4.0 International License.
+
+You are free to:
+- **Share** — copy and redistribute the material in any medium or format
+- **Adapt** — remix, transform, and build upon the material for any purpose
+
+Under the following terms:
+- **Attribution** — You must give appropriate credit, provide a link to the
+  license, and indicate if changes were made.
+- **ShareAlike** — If you remix, transform, or build upon the material, you
+  must distribute your contributions under the same license.
+
+Full license text: https://creativecommons.org/licenses/by-sa/4.0/legalcode
+
+---
+
+## Third-Party Content
+
+Images in `artifacts/sample_content/images/` are sourced from Pixabay and are
+used under the Pixabay License (https://pixabay.com/service/license-summary/).
+These images are free for commercial use with no attribution required, but
+attribution is appreciated.
+
+---
+
+## Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+This software uses third-party AI services (Claude API). Users are responsible
+for compliance with those services' terms of use. Content processed through
+these services is subject to their respective privacy policies.

tools/__init__.py

@@ -0,0 +1 @@
+"""Custom tools for the DeepAgents PrintShop document generation system."""

tools/change_tracker.py

@@ -0,0 +1,419 @@
+"""
+Change Tracker - Milestone 2
+
+Tracks changes between content versions and generates detailed comparison reports.
+"""
+
+import difflib
+import json
+import os
+from pathlib import Path
+from datetime import datetime
+from typing import Dict, List, Tuple, Optional
+import re
+
+
+class ChangeTracker:
+    """
+    Tracks and analyzes changes between content versions.
+
+    Features:
+    - Generate text diffs between versions
+    - Summarize changes with AI analysis
+    - Track quality improvements over time
+    - Create detailed change reports
+    """
+
+    def __init__(self, base_dir: str = "artifacts"):
+        """
+        Initialize the change tracker.
+
+        Args:
+            base_dir: Base directory for artifacts
+        """
+        self.base_dir = Path(base_dir)
+        self.history_dir = self.base_dir / "version_history"
+        self.changes_dir = self.history_dir / "changes"
+        self.diffs_dir = self.history_dir / "diffs"
+
+        # Ensure directories exist
+        self.changes_dir.mkdir(parents=True, exist_ok=True)
+        self.diffs_dir.mkdir(parents=True, exist_ok=True)
+
+    def generate_diff(self,
+                     old_content: str,
+                     new_content: str,
+                     filename: str = "content") -> Dict:
+        """
+        Generate a detailed diff between two text contents.
+
+        Args:
+            old_content: Original content
+            new_content: Modified content
+            filename: Name of the file being compared
+
+        Returns:
+            Dictionary containing diff information
+        """
+        # Split content into lines
+        old_lines = old_content.splitlines(keepends=True)
+        new_lines = new_content.splitlines(keepends=True)
+
+        # Generate unified diff
+        unified_diff = list(difflib.unified_diff(
+            old_lines,
+            new_lines,
+            fromfile=f"{filename} (old)",
+            tofile=f"{filename} (new)",
+            lineterm=""
+        ))
+
+        # Generate HTML diff
+        html_diff = difflib.HtmlDiff()
+        html_table = html_diff.make_table(
+            old_lines,
+            new_lines,
+            fromdesc=f"{filename} (old)",
+            todesc=f"{filename} (new)"
+        )
+
+        # Calculate statistics
+        differ = difflib.SequenceMatcher(None, old_content, new_content)
+        similarity_ratio = differ.ratio()
+
+        # Count changes
+        additions = sum(1 for line in unified_diff if line.startswith('+') and not line.startswith('+++'))
+        deletions = sum(1 for line in unified_diff if line.startswith('-') and not line.startswith('---'))
+        modifications = min(additions, deletions)
+        net_additions = additions - modifications
+        net_deletions = deletions - modifications
+
+        return {
+            "filename": filename,
+            "unified_diff": unified_diff,
+            "html_diff": html_table,
+            "similarity_ratio": similarity_ratio,
+            "statistics": {
+                "additions": net_additions,
+                "deletions": net_deletions,
+                "modifications": modifications,
+                "total_changes": additions + deletions,
+                "similarity_percentage": round(similarity_ratio * 100, 2)
+            },
+            "old_line_count": len(old_lines),
+            "new_line_count": len(new_lines),
+            "line_change": len(new_lines) - len(old_lines)
+        }
+
+    def compare_versions(self,
+                        old_content_dict: Dict[str, str],
+                        new_content_dict: Dict[str, str],
+                        old_version: str,
+                        new_version: str) -> Dict:
+        """
+        Compare two complete versions and generate comprehensive change analysis.
+
+        Args:
+            old_content_dict: Content of the old version
+            new_content_dict: Content of the new version
+            old_version: Name of the old version
+            new_version: Name of the new version
+
+        Returns:
+            Complete comparison report
+        """
+        comparison = {
+            "old_version": old_version,
+            "new_version": new_version,
+            "comparison_timestamp": datetime.now().isoformat(),
+            "file_changes": {},
+            "summary": {
+                "files_added": [],
+                "files_removed": [],
+                "files_modified": [],
+                "total_additions": 0,
+                "total_deletions": 0,
+                "total_modifications": 0,
+                "average_similarity": 0
+            }
+        }
+
+        # Find all files in both versions
+        old_files = set(old_content_dict.keys())
+        new_files = set(new_content_dict.keys())
+
+        # Categorize changes
+        added_files = new_files - old_files
+        removed_files = old_files - new_files
+        common_files = old_files & new_files
+
+        comparison["summary"]["files_added"] = list(added_files)
+        comparison["summary"]["files_removed"] = list(removed_files)
+
+        # Analyze common files
+        similarities = []
+        for filename in common_files:
+            old_content = old_content_dict[filename]
+            new_content = new_content_dict[filename]
+
+            diff_result = self.generate_diff(old_content, new_content, filename)
+            comparison["file_changes"][filename] = diff_result
+
+            # Check if file was actually modified
+            if diff_result["statistics"]["total_changes"] > 0:
+                comparison["summary"]["files_modified"].append(filename)
+
+            # Accumulate statistics
+            stats = diff_result["statistics"]
+            comparison["summary"]["total_additions"] += stats["additions"]
+            comparison["summary"]["total_deletions"] += stats["deletions"]
+            comparison["summary"]["total_modifications"] += stats["modifications"]
+            similarities.append(diff_result["similarity_ratio"])
+
+        # Handle added files
+        for filename in added_files:
+            new_content = new_content_dict[filename]
+            line_count = len(new_content.splitlines())
+            comparison["file_changes"][filename] = {
+                "filename": filename,
+                "status": "added",
+                "new_line_count": line_count,
+                "statistics": {
+                    "additions": line_count,
+                    "deletions": 0,
+                    "modifications": 0,
+                    "total_changes": line_count
+                }
+            }
+            comparison["summary"]["total_additions"] += line_count
+
+        # Handle removed files
+        for filename in removed_files:
+            old_content = old_content_dict[filename]
+            line_count = len(old_content.splitlines())
+            comparison["file_changes"][filename] = {
+                "filename": filename,
+                "status": "removed",
+                "old_line_count": line_count,
+                "statistics": {
+                    "additions": 0,
+                    "deletions": line_count,
+                    "modifications": 0,
+                    "total_changes": line_count
+                }
+            }
+            comparison["summary"]["total_deletions"] += line_count
+
+        # Calculate average similarity
+        if similarities:
+            comparison["summary"]["average_similarity"] = round(sum(similarities) / len(similarities) * 100, 2)
+
+        return comparison
+
+    def save_comparison(self,
+                       comparison: Dict,
+                       save_diffs: bool = True) -> Tuple[str, str]:
+        """
+        Save a comparison report to disk.
+
+        Args:
+            comparison: Comparison result from compare_versions
+            save_diffs: Whether to save individual diff files
+
+        Returns:
+            Tuple of (comparison_file_path, summary_file_path)
+        """
+        old_version = comparison["old_version"]
+        new_version = comparison["new_version"]
+
+        # Save main comparison file
+        comparison_filename = f"{old_version}_to_{new_version}.json"
+        comparison_path = self.changes_dir / comparison_filename
+
+        with open(comparison_path, 'w', encoding='utf-8') as f:
+            json.dump(comparison, f, indent=2, ensure_ascii=False)
+
+        # Save individual diff files if requested
+        if save_diffs:
+            for filename, change_info in comparison["file_changes"].items():
+                if "unified_diff" in change_info:
+                    diff_filename = f"{filename}_{old_version}_{new_version}.diff"
+                    diff_path = self.diffs_dir / diff_filename
+
+                    with open(diff_path, 'w', encoding='utf-8') as f:
+                        f.writelines(change_info["unified_diff"])
+
+        # Create human-readable summary
+        summary_filename = f"{old_version}_to_{new_version}_summary.md"
+        summary_path = self.changes_dir / summary_filename
+        self._create_summary_markdown(comparison, summary_path)
+
+        return str(comparison_path), str(summary_path)
+
+    def _create_summary_markdown(self, comparison: Dict, output_path: Path):
+        """Create a human-readable markdown summary of changes."""
+        old_version = comparison["old_version"]
+        new_version = comparison["new_version"]
+        summary = comparison["summary"]
+
+        content = f"""# Change Summary: {old_version} → {new_version}
+
+**Generated:** {comparison["comparison_timestamp"]}
+
+## Overview
+
+| Metric | Count |
+|--------|-------|
+| Files Added | {len(summary["files_added"])} |
+| Files Removed | {len(summary["files_removed"])} |
+| Files Modified | {len(summary["files_modified"])} |
+| Total Additions | +{summary["total_additions"]} lines |
+| Total Deletions | -{summary["total_deletions"]} lines |
+| Net Change | {summary["total_additions"] - summary["total_deletions"]:+d} lines |
+| Average Similarity | {summary["average_similarity"]}% |
+
+"""
+
+        # Files added
+        if summary["files_added"]:
+            content += "## Files Added\n\n"
+            for filename in summary["files_added"]:
+                file_info = comparison["file_changes"][filename]
+                content += f"- **{filename}** (+{file_info['statistics']['additions']} lines)\n"
+            content += "\n"
+
+        # Files removed
+        if summary["files_removed"]:
+            content += "## Files Removed\n\n"
+            for filename in summary["files_removed"]:
+                file_info = comparison["file_changes"][filename]
+                content += f"- **{filename}** (-{file_info['statistics']['deletions']} lines)\n"
+            content += "\n"
+
+        # Files modified
+        if summary["files_modified"]:
+            content += "## Files Modified\n\n"
+            for filename in summary["files_modified"]:
+                file_info = comparison["file_changes"][filename]
+                stats = file_info["statistics"]
+                similarity = stats["similarity_percentage"]
+
+                content += f"### {filename}\n"
+                content += f"- **Similarity:** {similarity}%\n"
+                content += f"- **Changes:** +{stats['additions']} -{stats['deletions']} lines\n"
+                content += f"- **Modifications:** {stats['modifications']} lines\n"
+
+                # Add sample changes if available
+                if "unified_diff" in file_info and file_info["unified_diff"]:
+                    content += f"- **Sample changes:**\n"
+                    content += "  ```diff\n"
+                    # Show first few diff lines
+                    diff_lines = file_info["unified_diff"][:10]
+                    for line in diff_lines:
+                        if line.startswith(('+', '-', '@')):
+                            content += f"  {line.rstrip()}\n"
+                    if len(file_info["unified_diff"]) > 10:
+                        content += "  ...\n"
+                    content += "  ```\n"
+                content += "\n"
+
+        with open(output_path, 'w', encoding='utf-8') as f:
+            f.write(content)
+
+    def analyze_quality_progression(self, version_qualities: List[Tuple[str, int]]) -> Dict:
+        """
+        Analyze quality progression across multiple versions.
+
+        Args:
+            version_qualities: List of (version_name, quality_score) tuples
+
+        Returns:
+            Quality progression analysis
+        """
+        if len(version_qualities) < 2:
+            return {"error": "Need at least 2 versions for progression analysis"}
+
+        analysis = {
+            "versions_analyzed": len(version_qualities),
+            "quality_progression": [],
+            "overall_improvement": 0,
+            "best_version": None,
+            "worst_version": None,
+            "improvement_trend": "unknown"
+        }
+
+        # Calculate progression
+        for i in range(1, len(version_qualities)):
+            prev_version, prev_score = version_qualities[i-1]
+            curr_version, curr_score = version_qualities[i]
+
+            improvement = curr_score - prev_score
+            analysis["quality_progression"].append({
+                "from": prev_version,
+                "to": curr_version,
+                "improvement": improvement,
+                "from_score": prev_score,
+                "to_score": curr_score
+            })
+
+        # Overall metrics
+        first_score = version_qualities[0][1]
+        last_score = version_qualities[-1][1]
+        analysis["overall_improvement"] = last_score - first_score
+
+        # Best and worst versions
+        best_score = max(version_qualities, key=lambda x: x[1])
+        worst_score = min(version_qualities, key=lambda x: x[1])
+        analysis["best_version"] = {"name": best_score[0], "score": best_score[1]}
+        analysis["worst_version"] = {"name": worst_score[0], "score": worst_score[1]}
+
+        # Determine trend
+        improvements = [step["improvement"] for step in analysis["quality_progression"]]
+        positive_steps = sum(1 for imp in improvements if imp > 0)
+        negative_steps = sum(1 for imp in improvements if imp < 0)
+
+        if positive_steps > negative_steps:
+            analysis["improvement_trend"] = "improving"
+        elif negative_steps > positive_steps:
+            analysis["improvement_trend"] = "declining"
+        else:
+            analysis["improvement_trend"] = "stable"
+
+        return analysis
+
+    def create_change_report(self,
+                           old_version: str,
+                           new_version: str,
+                           old_content: Dict[str, str],
+                           new_content: Dict[str, str],
+                           old_quality: Optional[int] = None,
+                           new_quality: Optional[int] = None) -> str:
+        """
+        Create a comprehensive change report.
+
+        Args:
+            old_version: Name of the old version
+            new_version: Name of the new version
+            old_content: Content of the old version
+            new_content: Content of the new version
+            old_quality: Quality score of old version
+            new_quality: Quality score of new version
+
+        Returns:
+            Path to the generated report
+        """
+        # Generate comparison
+        comparison = self.compare_versions(old_content, new_content, old_version, new_version)
+
+        # Add quality information if provided
+        if old_quality is not None and new_quality is not None:
+            comparison["quality_analysis"] = {
+                "old_quality_score": old_quality,
+                "new_quality_score": new_quality,
+                "quality_improvement": new_quality - old_quality
+            }
+
+        # Save comparison
+        comparison_path, summary_path = self.save_comparison(comparison)
+
+        return summary_path