buildlog 0.1.0__py3-none-any.whl

buildlog/render/claude_md.py

@@ -0,0 +1,106 @@
+"""Render skills to CLAUDE.md."""
+
+from __future__ import annotations
+
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from buildlog.skills import _to_imperative
+
+if TYPE_CHECKING:
+    from buildlog.skills import Skill
+
+
+class ClaudeMdRenderer:
+    """Appends promoted skills to CLAUDE.md."""
+
+    def __init__(self, path: Path | None = None, tracking_path: Path | None = None):
+        """Initialize renderer.
+
+        Args:
+            path: Path to CLAUDE.md file. Defaults to CLAUDE.md in current directory.
+            tracking_path: Path to promoted.json tracking file.
+                Defaults to .buildlog/promoted.json relative to path.
+        """
+        self.path = path or Path("CLAUDE.md")
+        if tracking_path is None:
+            self.tracking_path = self.path.parent / ".buildlog" / "promoted.json"
+        else:
+            self.tracking_path = tracking_path
+
+    def render(self, skills: list[Skill]) -> str:
+        """Append skills to CLAUDE.md.
+
+        Args:
+            skills: List of skills to append.
+
+        Returns:
+            Confirmation message.
+        """
+        if not skills:
+            return "No skills to promote"
+
+        # Group by category
+        by_category: dict[str, list[Skill]] = {}
+        for skill in skills:
+            by_category.setdefault(skill.category, []).append(skill)
+
+        # Build section
+        lines = [
+            "",
+            f"## Learned Rules (auto-generated {datetime.now().strftime('%Y-%m-%d')})",
+            "",
+        ]
+
+        category_titles = {
+            "architectural": "Architectural",
+            "workflow": "Workflow",
+            "tool_usage": "Tool Usage",
+            "domain_knowledge": "Domain Knowledge",
+        }
+
+        for category, cat_skills in by_category.items():
+            title = category_titles.get(category, category.replace("_", " ").title())
+            lines.append(f"### {title}")
+            lines.append("")
+            for skill in cat_skills:
+                rule = _to_imperative(skill.rule, skill.confidence)
+                lines.append(f"- {rule}")
+            lines.append("")
+
+        content = "\n".join(lines)
+
+        # Append to file
+        if self.path.exists():
+            existing = self.path.read_text()
+            self.path.write_text(existing + content)
+        else:
+            self.path.write_text(content)
+
+        # Track promoted skill IDs
+        self._track_promoted(skills)
+
+        return f"Appended {len(skills)} rules to {self.path}"
+
+    def _track_promoted(self, skills: list[Skill]) -> None:
+        """Track which skills have been promoted."""
+        self.tracking_path.parent.mkdir(parents=True, exist_ok=True)
+
+        # Load existing tracking data (handle corrupt JSON)
+        tracking = {"skill_ids": [], "promoted_at": {}}
+        if self.tracking_path.exists():
+            try:
+                tracking = json.loads(self.tracking_path.read_text())
+            except json.JSONDecodeError:
+                pass  # Start fresh if corrupted
+
+        # Add new skill IDs
+        now = datetime.now().isoformat()
+        for skill in skills:
+            if skill.id not in tracking["skill_ids"]:
+                tracking["skill_ids"].append(skill.id)
+                tracking["promoted_at"][skill.id] = now
+
+        self.tracking_path.write_text(json.dumps(tracking, indent=2))

buildlog/render/settings_json.py

@@ -0,0 +1,96 @@
+"""Render skills to .claude/settings.json."""
+
+from __future__ import annotations
+
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from buildlog.skills import _to_imperative
+
+if TYPE_CHECKING:
+    from buildlog.skills import Skill
+
+
+class SettingsJsonRenderer:
+    """Merges promoted skills into .claude/settings.json."""
+
+    def __init__(self, path: Path | None = None, tracking_path: Path | None = None):
+        """Initialize renderer.
+
+        Args:
+            path: Path to settings.json file. Defaults to .claude/settings.json.
+            tracking_path: Path to promoted.json tracking file.
+                Defaults to .buildlog/promoted.json.
+        """
+        self.path = path or Path(".claude/settings.json")
+        self.tracking_path = tracking_path or Path(".buildlog/promoted.json")
+
+    def render(self, skills: list[Skill]) -> str:
+        """Merge skills into settings.json rules array.
+
+        Args:
+            skills: List of skills to add.
+
+        Returns:
+            Confirmation message.
+        """
+        if not skills:
+            return "No skills to promote"
+
+        # Load existing settings
+        if self.path.exists():
+            settings = json.loads(self.path.read_text())
+        else:
+            self.path.parent.mkdir(parents=True, exist_ok=True)
+            settings = {}
+
+        # Get or create rules array
+        rules: list[str] = settings.setdefault("rules", [])
+
+        # Add new rules (converted to imperative form)
+        added = 0
+        for skill in skills:
+            rule = _to_imperative(skill.rule, skill.confidence)
+            if rule not in rules:
+                rules.append(rule)
+                added += 1
+
+        # Update buildlog metadata (accumulate, don't replace)
+        buildlog_meta = settings.get("_buildlog", {"promoted_skill_ids": []})
+        existing_ids = set(buildlog_meta.get("promoted_skill_ids", []))
+        new_ids = existing_ids | {s.id for s in skills}
+        settings["_buildlog"] = {
+            "last_updated": datetime.now().isoformat(),
+            "promoted_skill_ids": sorted(new_ids),
+        }
+
+        # Write back
+        self.path.write_text(json.dumps(settings, indent=2))
+
+        # Track promoted skill IDs
+        self._track_promoted(skills)
+
+        return f"Added {added} rules to {self.path} ({len(skills) - added} duplicates skipped)"
+
+    def _track_promoted(self, skills: list[Skill]) -> None:
+        """Track which skills have been promoted."""
+        self.tracking_path.parent.mkdir(parents=True, exist_ok=True)
+
+        # Load existing tracking data (handle corrupt JSON)
+        tracking = {"skill_ids": [], "promoted_at": {}}
+        if self.tracking_path.exists():
+            try:
+                tracking = json.loads(self.tracking_path.read_text())
+            except json.JSONDecodeError:
+                pass  # Start fresh if corrupted
+
+        # Add new skill IDs
+        now = datetime.now().isoformat()
+        for skill in skills:
+            if skill.id not in tracking["skill_ids"]:
+                tracking["skill_ids"].append(skill.id)
+                tracking["promoted_at"][skill.id] = now
+
+        self.tracking_path.write_text(json.dumps(tracking, indent=2))