codeboarding 0.9.3__tar.gz → 0.9.5__tar.gz

{codeboarding-0.9.3/codeboarding.egg-info → codeboarding-0.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeboarding
-Version: 0.9.3
+Version: 0.9.5
 Summary: Interactive Diagrams for Code
 Author: CodeBoarding Team
 License: MIT

codeboarding-0.9.5/README.md

@@ -0,0 +1,149 @@
+# CodeBoarding
+
+See what your AI is building before it breaks.
+
+CodeBoarding gives developers and coding agents a visual map of a codebase. It combines static analysis with LLM reasoning to generate architecture diagrams, component-level documentation, and navigable outputs you can use in your IDE, CI, and docs.
+
+[Website](https://codeboarding.org) · [Open VSX extension](https://open-vsx.org/extension/CodeBoarding/codeboarding) · [Explore examples](https://codeboarding.org/diagrams) · [VS Code extension](https://marketplace.visualstudio.com/items?itemName=Codeboarding.codeboarding) · [GitHub Action](https://github.com/marketplace/actions/codeboarding-diagram-first-documentation) ·[Discord](https://discord.gg/T5zHTJYFuy)
+
+[![CodeBoarding demo](docs/assets/codeboarding-demo.gif)](https://open-vsx.org/extension/CodeBoarding/codeboarding)
+
+Install the extension from Open VSX.
+
+[![JavaScript](https://img.shields.io/badge/JavaScript-222222?style=flat-square&logo=javascript&logoColor=F7DF1E)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Java](https://img.shields.io/badge/Java-E76F00?style=flat-square&logo=openjdk&logoColor=white)](https://www.java.com/)
+[![Python](https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
+[![Go](https://img.shields.io/badge/Go-00ADD8?style=flat-square&logo=go&logoColor=white)](https://go.dev/)
+[![PHP](https://img.shields.io/badge/PHP-777BB4?style=flat-square&logo=php&logoColor=white)](https://www.php.net/)
+
+## Few use cases:
+
+- Keep architecture visible while agents code.
+- Review AI-generated changes with system context before they turn into hidden debt.
+- Understand large repositories faster with layered diagrams and component breakdowns.
+- Share the same visual model across local workflows, IDEs, pull requests, and docs.
+
+## What CodeBoarding generates
+
+- High-level system architecture diagrams.
+- Deeper component diagrams for important subsystems.
+- Markdown documentation in `.codeboarding/`.
+- Mermaid output that is easy to embed in docs and PRs.
+- Incremental updates when only part of the codebase changes.
+
+## How it works
+
+```mermaid
+graph LR
+    Application_Orchestrator_Repository_Manager["Application Orchestrator & Repository Manager"]
+    LLM_Agent_Core["LLM Agent Core"]
+    Static_Code_Analyzer["Static Code Analyzer"]
+    Agent_Tooling_Interface["Agent Tooling Interface"]
+    Incremental_Analysis_Engine["Incremental Analysis Engine"]
+    Documentation_Diagram_Generator["Documentation & Diagram Generator"]
+    Application_Orchestrator_Repository_Manager -- "Orchestrator initiates analysis workflow, leveraging incremental updates based on detected code changes." --> Incremental_Analysis_Engine
+    Application_Orchestrator_Repository_Manager -- "Orchestrator passes project context and triggers the main analysis workflow for the LLM Agent." --> LLM_Agent_Core
+    Incremental_Analysis_Engine -- "Incremental engine requests static analysis for specific code segments (new or changed)." --> Static_Code_Analyzer
+    Static_Code_Analyzer -- "Static analyzer provides analysis results to the incremental engine for caching." --> Incremental_Analysis_Engine
+    LLM_Agent_Core -- "LLM Agent invokes specialized tools to interact with the codebase and analysis data." --> Agent_Tooling_Interface
+    Agent_Tooling_Interface -- "Agent tools query the static analysis engine for detailed code insights." --> Static_Code_Analyzer
+    Static_Code_Analyzer -- "Static analysis engine provides requested data to the agent tools." --> Agent_Tooling_Interface
+    LLM_Agent_Core -- "LLM Agent delivers structured analysis insights for documentation and diagram generation." --> Documentation_Diagram_Generator
+    click Application_Orchestrator_Repository_Manager href "https://github.com/CodeBoarding/CodeBoarding/blob/main/.codeboarding/Application_Orchestrator_Repository_Manager.md" "Details"
+    click LLM_Agent_Core href "https://github.com/CodeBoarding/CodeBoarding/blob/main/.codeboarding/LLM_Agent_Core.md" "Details"
+    click Static_Code_Analyzer href "https://github.com/CodeBoarding/CodeBoarding/blob/main/.codeboarding/Static_Code_Analyzer.md" "Details"
+    click Agent_Tooling_Interface href "https://github.com/CodeBoarding/CodeBoarding/blob/main/.codeboarding/Agent_Tooling_Interface.md" "Details"
+    click Incremental_Analysis_Engine href "https://github.com/CodeBoarding/CodeBoarding/blob/main/.codeboarding/Incremental_Analysis_Engine.md" "Details"
+    click Documentation_Diagram_Generator href "https://github.com/CodeBoarding/CodeBoarding/blob/main/.codeboarding/Documentation_Diagram_Generator.md" "Details"
+```
+
+For a deeper architecture walkthrough, see [`.codeboarding/overview.md`](.codeboarding/overview.md).
+
+## Quick start
+
+### Run from source
+
+```bash
+uv sync --frozen
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+python install.py
+python main.py --local /path/to/repo
+```
+
+### Use the packaged CLI
+
+```bash
+pip install codeboarding
+codeboarding-setup
+codeboarding --local /path/to/repo
+```
+
+Output is written to `/path/to/repo/.codeboarding/`.
+
+`python install.py` and `codeboarding-setup` download language server binaries to `~/.codeboarding/servers/`, shared across projects. `npm` is required for Python, TypeScript, JavaScript, and PHP language servers; if it is missing, setup can install it via `nodeenv`.
+
+## Configuration
+
+On first run, CodeBoarding creates `~/.codeboarding/config.toml`. Set one provider there or use environment variables.
+
+```toml
+[provider]
+# openai_api_key            = "sk-..."
+# anthropic_api_key         = "sk-ant-..."
+# google_api_key            = "AIza..."
+# vercel_api_key            = "vck_..."
+# aws_bearer_token_bedrock  = "..."
+# ollama_base_url           = "http://localhost:11434"
+# openrouter_api_key        = "sk-..."
+
+[llm]
+# agent_model   = "gemini-3-flash"
+# parsing_model = "gemini-3-flash"
+```
+
+Shell environment variables such as `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`, and `OLLAMA_BASE_URL` take precedence over the config file. For private repositories, set `GITHUB_TOKEN` in your environment.
+
+## Common commands
+
+```bash
+# Analyze a local repository
+python main.py --local ./my-project
+
+# Increase diagram depth
+python main.py --local ./my-project --depth-level 2
+
+# Re-analyze only changed parts when possible
+python main.py --local ./my-project --incremental
+
+# Update a single component by ID
+python main.py --local ./my-project --partial-component-id "a3f2b1c4d5e6f789"
+
+# Analyze a remote GitHub repository
+python main.py https://github.com/pytorch/pytorch
+```
+
+## Where to use it
+
+- [CLI](https://github.com/CodeBoarding/CodeBoarding) for local analysis, automation, and CI workflows.
+- [VS Code extension](https://marketplace.visualstudio.com/items?itemName=Codeboarding.codeboarding) for in-editor visual architecture.
+- [GitHub Action](https://github.com/marketplace/actions/codeboarding-diagram-first-documentation) to keep diagrams updated in CI.
+
+## Supported stack
+
+- Languages: Python, TypeScript, JavaScript, Java, Go, PHP.
+- LLM providers: OpenAI, Anthropic, Google, Vercel AI Gateway, AWS Bedrock, Ollama, OpenRouter, and more.
+
+## Examples
+
+- Visualized 800+ open-source repositories.
+- Browse generated examples in [GeneratedOnBoardings](https://github.com/CodeBoarding/GeneratedOnBoardings).
+- Try the hosted explorer at [codeboarding.org/diagrams](https://codeboarding.org/diagrams).
+
+## Contributing
+
+If you want to improve CodeBoarding, open an [issue](https://github.com/CodeBoarding/CodeBoarding/issues) or send a pull request. We welcome improvements to analysis quality, output generators, integrations, and developer experience.
+
+## Vision
+
+CodeBoarding is building an open standard for code understanding: a visual, accurate, high-level representation of a codebase that both humans and agents can use.

{codeboarding-0.9.3 → codeboarding-0.9.5}/agents/agent_responses.py

@@ -180,7 +180,7 @@ class AnalysisInsights(LLMBaseModel):
     def llm_str(self):
         if not self.components:
             return "No abstract components found."
-        title = "# 📦 Abstract Components Overview\n"
+        title = "# Abstract Components Overview\n"
         body = "\n".join(ac.llm_str() for ac in self.components)
         relations = "\n".join(cr.llm_str() for cr in self.components_relations)
         return title + body + relations
@@ -251,7 +251,7 @@ class CFGAnalysisInsights(LLMBaseModel):
     def llm_str(self):
         if not self.components:
             return "No abstract components found in the CFG."
-        title = "# 📦 Abstract Components Overview from CFG\n"
+        title = "# Abstract Components Overview from CFG\n"
         body = "\n".join(ac.llm_str() for ac in self.components)
         relations = "\n".join(cr.llm_str() for cr in self.components_relations)
         return title + body + relations
@@ -309,7 +309,7 @@ class MetaAnalysisInsights(LLMBaseModel):
     )
 
     def llm_str(self):
-        title = "# 🎯 Project Metadata Analysis\n"
+        title = "# Project Metadata Analysis\n"
         content = f"""
 **Project Type:** {self.project_type}
 **Domain:** {self.domain}
@@ -341,7 +341,7 @@ class ComponentFiles(LLMBaseModel):
     def llm_str(self):
         if not self.file_paths:
             return "No files classified."
-        title = "# 📄 Component File Classifications\n"
+        title = "# Component File Classifications\n"
         body = "\n".join(f"- `{fc.file_path}` -> Component: `{fc.component_name}`" for fc in self.file_paths)
         return title + body
 

{codeboarding-0.9.3 → codeboarding-0.9.5}/agents/cluster_methods_mixin.py

@@ -2,10 +2,13 @@ import logging
 import os
 from pathlib import Path
 
-from agents.agent_responses import Component, AnalysisInsights
+from agents.agent_responses import AnalysisInsights, Component
 from static_analyzer.analysis_result import StaticAnalysisResults
+from static_analyzer.cluster_helpers import (
+    get_all_cluster_ids,
+    get_files_for_cluster_ids,
+)
 from static_analyzer.graph import ClusterResult
-from static_analyzer.cluster_helpers import get_files_for_cluster_ids, get_all_cluster_ids
 
 logger = logging.getLogger(__name__)
 

{codeboarding-0.9.3 → codeboarding-0.9.5}/agents/dependency_discovery.py

@@ -31,7 +31,7 @@ class DependencyFileSpec:
 
 
 DEPENDENCY_REGISTRY: tuple[DependencyFileSpec, ...] = (
-    # ── Python ──
+    # -- Python --
     DependencyFileSpec("requirements.txt", Ecosystem.PYTHON, FileRole.MANIFEST),
     DependencyFileSpec("requirements-dev.txt", Ecosystem.PYTHON, FileRole.MANIFEST),
     DependencyFileSpec("requirements-test.txt", Ecosystem.PYTHON, FileRole.MANIFEST),
@@ -52,7 +52,7 @@ DEPENDENCY_REGISTRY: tuple[DependencyFileSpec, ...] = (
     DependencyFileSpec("pixi.toml", Ecosystem.PYTHON, FileRole.MANIFEST),
     DependencyFileSpec("requirements.in", Ecosystem.PYTHON, FileRole.MANIFEST),
     DependencyFileSpec("pixi.lock", Ecosystem.PYTHON, FileRole.LOCK),
-    # ── Node / TypeScript / JavaScript ──
+    # -- Node / TypeScript / JavaScript --
     DependencyFileSpec("package.json", Ecosystem.NODE, FileRole.MANIFEST),
     DependencyFileSpec("package-lock.json", Ecosystem.NODE, FileRole.LOCK),
     DependencyFileSpec("yarn.lock", Ecosystem.NODE, FileRole.LOCK),
@@ -65,12 +65,12 @@ DEPENDENCY_REGISTRY: tuple[DependencyFileSpec, ...] = (
     DependencyFileSpec("deno.jsonc", Ecosystem.NODE, FileRole.MANIFEST),
     DependencyFileSpec("deno.lock", Ecosystem.NODE, FileRole.LOCK),
     DependencyFileSpec("lerna.json", Ecosystem.NODE, FileRole.CONFIG),
-    # ── Go ──
+    # -- Go --
     DependencyFileSpec("go.mod", Ecosystem.GO, FileRole.MANIFEST),
     DependencyFileSpec("go.sum", Ecosystem.GO, FileRole.LOCK),
     DependencyFileSpec("go.work", Ecosystem.GO, FileRole.CONFIG),
     DependencyFileSpec("go.work.sum", Ecosystem.GO, FileRole.LOCK),
-    # ── Java / JVM ──
+    # -- Java / JVM --
     DependencyFileSpec("pom.xml", Ecosystem.JAVA, FileRole.MANIFEST),
     DependencyFileSpec("pom.properties", Ecosystem.JAVA, FileRole.CONFIG),
     DependencyFileSpec("build.gradle", Ecosystem.JAVA, FileRole.MANIFEST),
@@ -81,7 +81,7 @@ DEPENDENCY_REGISTRY: tuple[DependencyFileSpec, ...] = (
     DependencyFileSpec("build.sbt", Ecosystem.JAVA, FileRole.MANIFEST),
     DependencyFileSpec("gradle.lockfile", Ecosystem.JAVA, FileRole.LOCK),
     DependencyFileSpec("verification-metadata.xml", Ecosystem.JAVA, FileRole.LOCK),
-    # ── PHP ──
+    # -- PHP --
     DependencyFileSpec("composer.json", Ecosystem.PHP, FileRole.MANIFEST),
     DependencyFileSpec("composer.lock", Ecosystem.PHP, FileRole.LOCK),
     DependencyFileSpec("symfony.lock", Ecosystem.PHP, FileRole.LOCK),

{codeboarding-0.9.3 → codeboarding-0.9.5}/agents/planner_agent.py

@@ -6,14 +6,14 @@ should be expanded into sub-components. Unlike the previous LLM-based approach,
 this uses CFG clustering structure as the source of truth.
 
 Expansion Rules:
-1. If component has source_cluster_ids → expandable (CFG structure exists)
-2. If component has no clusters but has files → expandable ONE level (to explain files)
-3. If neither component nor its parent has clusters → leaf (stop expanding)
+1. If component has source_cluster_ids -> expandable (CFG structure exists)
+2. If component has no clusters but has files -> expandable ONE level (to explain files)
+3. If neither component nor its parent has clusters -> leaf (stop expanding)
 
 Example:
-- Component: "Agents" (clusters: [1,2,3]) → expand ✓
-  - Sub-component: "DetailsAgent" (clusters: [], files: [details_agent.py]) → expand ✓ (parent had clusters)
-    - Sub-sub-component: "run_method" (clusters: [], files: []) → DON'T expand ✗ (parent had no clusters)
+- Component: "Agents" (clusters: [1,2,3]) -> expand (yes)
+  - Sub-component: "DetailsAgent" (clusters: [], files: [details_agent.py]) -> expand (yes, parent had clusters)
+    - Sub-sub-component: "run_method" (clusters: [], files: []) -> DON'T expand (no, parent had no clusters)
 """
 
 import logging
@@ -35,10 +35,10 @@ def should_expand_component(
     Determine if a component should be expanded into sub-components.
 
     Expansion logic:
-    - If component has clusters → expand (there's CFG structure to decompose)
-    - If component has no clusters but has files → expand if parent had clusters
+    - If component has clusters -> expand (there's CFG structure to decompose)
+    - If component has no clusters but has files -> expand if parent had clusters
       (allows one more level to explain file internals)
-    - If neither component nor parent has clusters → stop (leaf node)
+    - If neither component nor parent has clusters -> stop (leaf node)
 
     Args:
         component: The component to evaluate

{codeboarding-0.9.3 → codeboarding-0.9.5}/agents/prompts/gpt_prompts.py

@@ -213,7 +213,7 @@ RELATIONSHIPS_VALIDATION = """Validate component relationships for accuracy and
 
 1. **Accuracy:**
    - [ ] Relationship type is correct (dependency, composition, inheritance, etc.)
-   - [ ] Direction is accurate (source → target)
+   - [ ] Direction is accurate (source -> target)
    - [ ] Both components exist in the analysis
 
 2. **Completeness:**

{codeboarding-0.9.3 → codeboarding-0.9.5}/agents/tools/read_file_structure.py

@@ -124,19 +124,19 @@ def get_tree_string(
         entries = sorted([p for p in startpath.iterdir() if not (ignore_manager and ignore_manager.should_ignore(p))])
     except (PermissionError, FileNotFoundError):
         # Handle permission errors or non-existent directories
-        return [indent + "└── [Error reading directory]"]
+        return [indent + "`--[Error reading directory]"]
 
     for i, entry_path in enumerate(entries):
         # Check if we've exceeded the maximum number of lines
         if len(tree_lines) >= max_lines:
-            tree_lines.append(indent + "└── [Output truncated due to size limits]")
+            tree_lines.append(indent + "`-- [Output truncated due to size limits]")
             return tree_lines
 
-        connector = "└── " if i == len(entries) - 1 else "├── "
+        connector = "`-- " if i == len(entries) - 1 else "|-- "
         tree_lines.append(indent + connector + entry_path.name)
 
         if entry_path.is_dir():
-            extension = "    " if i == len(entries) - 1 else "│   "
+            extension = "    " if i == len(entries) - 1 else "|   "
             subtree = get_tree_string(
                 entry_path,
                 indent + extension,
@@ -149,8 +149,8 @@ def get_tree_string(
 
             # Check again after adding subtree
             if len(tree_lines) >= max_lines:
-                if tree_lines[-1] != indent + "└── [Output truncated due to size limits]":
-                    tree_lines.append(indent + "└── [Output truncated due to size limits]")
+                if tree_lines[-1] != indent + "`-- [Output truncated due to size limits]":
+                    tree_lines.append(indent + "`-- [Output truncated due to size limits]")
                 return tree_lines
 
     return tree_lines

{codeboarding-0.9.3 → codeboarding-0.9.5}/agents/tools/read_source.py

@@ -95,7 +95,7 @@ class CodeReferenceReader(BaseRepoTool):
             logger.error(f"[Source Reference Tool] File {file_path} does not exist.")
             return f"Error: File {file_path} does not exist."
 
-        with open(file_path, "r") as f:
+        with open(file_path, "r", encoding="utf-8", errors="replace") as f:
             lines = f.readlines()
 
         if start_line < 0 or end_line > len(lines):

{codeboarding-0.9.3 → codeboarding-0.9.5/codeboarding.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeboarding
-Version: 0.9.3
+Version: 0.9.5
 Summary: Interactive Diagrams for Code
 Author: CodeBoarding Team
 License: MIT

{codeboarding-0.9.3 → codeboarding-0.9.5}/codeboarding.egg-info/SOURCES.txt

@@ -134,5 +134,8 @@ tests/test_incremental_analyzer.py
 tests/test_install.py
 tests/test_logging_config.py
 tests/test_main.py
+tests/test_tool_registry.py
+tests/test_user_config.py
 tests/test_vscode_constants.py
-tests/test_windows_compatibility.py
+tests/test_windows_compatibility.py
+tests/test_windows_encoding.py

{codeboarding-0.9.3 → codeboarding-0.9.5}/diagram_analysis/diagram_generator.py

@@ -114,7 +114,7 @@ class DiagramGenerator:
         )
         if health_report is not None:
             health_path = Path(self.output_dir) / "health" / "health_report.json"
-            with open(health_path, "w") as f:
+            with open(health_path, "w", encoding="utf-8") as f:
                 f.write(health_report.model_dump_json(indent=2, exclude_none=True))
             logger.info(f"Health report written to {health_path} (score: {health_report.overall_score:.3f})")
         else:
@@ -145,7 +145,7 @@ class DiagramGenerator:
         )
 
         coverage_path = Path(self.output_dir) / "file_coverage.json"
-        with open(coverage_path, "w") as f:
+        with open(coverage_path, "w", encoding="utf-8") as f:
             f.write(report.model_dump_json(indent=2, exclude_none=True))
         logger.info(f"File coverage report written to {coverage_path}")
 
@@ -232,7 +232,7 @@ class DiagramGenerator:
         self._monitoring_agents["AbstractionAgent"] = self.abstraction_agent
 
         version_file = Path(self.output_dir) / "codeboarding_version.json"
-        with open(version_file, "w") as f:
+        with open(version_file, "w", encoding="utf-8") as f:
             f.write(
                 Version(
                     commit_hash=get_git_commit_hash(self.repo_location),
@@ -253,7 +253,7 @@ class DiagramGenerator:
 
             # Save code_stats.json
             code_stats_file = monitoring_dir / "code_stats.json"
-            with open(code_stats_file, "w") as f:
+            with open(code_stats_file, "w", encoding="utf-8") as f:
                 json.dump(static_stats, f, indent=2)
             logger.debug(f"Written code_stats.json to {code_stats_file}")
 

{codeboarding-0.9.3 → codeboarding-0.9.5}/diagram_analysis/file_coverage.py

@@ -187,7 +187,7 @@ class FileCoverage:
             return None
 
         try:
-            with open(coverage_path, "r") as f:
+            with open(coverage_path, "r", encoding="utf-8") as f:
                 data = json.load(f)
                 # Validate basic structure
                 if "analyzed_files" in data and "not_analyzed_files" in data:
@@ -207,6 +207,6 @@ class FileCoverage:
             coverage: File coverage dictionary to save
         """
         coverage_path = output_dir / "file_coverage.json"
-        with open(coverage_path, "w") as f:
+        with open(coverage_path, "w", encoding="utf-8") as f:
             json.dump(coverage, f, indent=2)
         logger.info(f"File coverage saved to {coverage_path}")

{codeboarding-0.9.3 → codeboarding-0.9.5}/diagram_analysis/incremental/io_utils.py

@@ -79,7 +79,7 @@ class _AnalysisFileStore:
                 return None
 
             try:
-                with open(self._analysis_path, "r") as f:
+                with open(self._analysis_path, "r", encoding="utf-8") as f:
                     data = json.load(f)
 
                 root_analysis, sub_analyses = parse_unified_analysis(data)
@@ -200,7 +200,7 @@ class _AnalysisFileStore:
                 sub_expandable = self._compute_expandable_components(sub, parent_had_clusters=parent_had_clusters)
                 sub_analyses_tuples[cid] = (sub, sub_expandable)
 
-        with open(self._analysis_path, "w") as f:
+        with open(self._analysis_path, "w", encoding="utf-8") as f:
             f.write(
                 build_unified_analysis_json(
                     analysis=analysis,

{codeboarding-0.9.3 → codeboarding-0.9.5}/diagram_analysis/incremental/models.py

@@ -58,11 +58,11 @@ class ChangeImpact:
             f"Dirty components: {self.dirty_components}",
         ]
         if self.components_needing_reexpansion:
-            lines.append(f"🔄 Components needing re-expansion: {self.components_needing_reexpansion}")
+            lines.append(f"Components needing re-expansion: {self.components_needing_reexpansion}")
         if self.architecture_dirty:
-            lines.append("⚠️ Architecture refresh needed")
+            lines.append("WARNING: Architecture refresh needed")
         if self.unassigned_files:
-            lines.append(f"⚠️ Unassigned files: {self.unassigned_files}")
+            lines.append(f"WARNING: Unassigned files: {self.unassigned_files}")
         return "\n".join(lines)
 
 

{codeboarding-0.9.3 → codeboarding-0.9.5}/diagram_analysis/manifest.py

@@ -109,7 +109,7 @@ def save_manifest(manifest: AnalysisManifest, output_dir: Path) -> Path:
     """
     manifest_path = output_dir / MANIFEST_FILENAME
 
-    with open(manifest_path, "w") as f:
+    with open(manifest_path, "w", encoding="utf-8") as f:
         f.write(manifest.model_dump_json(indent=2))
 
     logger.info(f"Saved analysis manifest to {manifest_path}")
@@ -129,7 +129,7 @@ def load_manifest(output_dir: Path) -> AnalysisManifest | None:
         return None
 
     try:
-        with open(manifest_path, "r") as f:
+        with open(manifest_path, "r", encoding="utf-8") as f:
             data = json.load(f)
 
         manifest = AnalysisManifest.model_validate(data)

{codeboarding-0.9.3 → codeboarding-0.9.5}/github_action.py

@@ -22,7 +22,7 @@ def _load_all_analyses(analysis_path: Path) -> list[tuple[str, AnalysisInsights,
 
     Returns the root analysis as 'overview' plus one entry per expanded component.
     """
-    with open(analysis_path, "r") as f:
+    with open(analysis_path, "r", encoding="utf-8") as f:
         data = json.load(f)
 
     root_analysis, sub_analyses = parse_unified_analysis(data)