An open source extension that connects AI agents to computational notebooks in JupyterLab.
This report summarizes scanner evidence for jupyterlab/jupyter-ai, a Python project with 4,411 GitHub stars. SynthScan examined 11,999 lines of code across 72 source files, recording 77 pattern matches distributed across 9 syntactic categories. The legacy adjusted pattern signal is 7.6 (Moderate pattern signal); it is not an authorship estimate.
Use the findings to ask whether maintainers can explain intent, verify dependencies, simplify unnecessary scaffolding, and focus review effort. Risk Payload v1 adds ownership, supply-chain, over-engineering, and review-effort vectors when available. These are prompts for human verification, not probabilities, security findings, or measured maintenance costs.
Use each vector to guide manual verification of the underlying findings.
Can maintainers explain intent, assumptions, and trade-offs? 51 finding(s).
Are imports declared and package/API names verified? 8 finding(s).
Are wrappers, guards, and repeated structures necessary? 55 finding(s).
Which changes need focused human review? 77 finding(s).
This chart tracks the legacy adjusted pattern score across scan runs. Changes can reflect source changes, scan coverage, or detector/scoring versions; they do not measure AI adoption or prove that a team refactored code. Compare runs only when their scoring versions are compatible. The dashed line tracks the raw pattern-hit count.
Groups findings by configured severity weight. Severity is not a confidence estimate, security rating, or proof that a package is missing. Verify imports against the project's manifests and inspect each finding in its local design context.
This horizontal bar chart shows where configured pattern scores accumulate across directories. Treat the bars as locations to inspect, not as evidence of authorship or code quality. Use the file-level findings to decide whether a directory needs a focused ownership, dependency, complexity, or review check.
The scanner identified 77 distinct pattern matches across 9 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a detector match to inspect in context. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.
Reading the findings table: The Severity column indicates the configured finding weight (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — legacy comment-context matches receive a ×1.5 score weight. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier under the legacy scoring model.
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | docs/source/_ext/subpackage_docs.py | 109 | def _inject_subpackage_toctrees(app: Sphinx, docname: str, source: list[str]) -> None: | CODE |
| LOW | …e/developers/entry_points_api/model_providers_group.md | 175 | async def generate_inline_completions(self, request: InlineCompletionRequest): | CODE |
| LOW | …e/developers/entry_points_api/model_providers_group.md | 184 | async def stream_inline_completions(self, request: InlineCompletionRequest): | CODE |
| LOW | …e/developers/entry_points_api/model_providers_group.md | 302 | async def generate_inline_completions(self, request: InlineCompletionRequest): | CODE |
| LOW | docs/tests/test_release_notes.py | 165 | def test_demote_headings_shifts_all_levels(): | CODE |
| LOW | docs/tests/test_release_notes.py | 179 | def test_strip_to_pr_groups_drops_heading_link_and_contributors(): | CODE |
| LOW | docs/tests/test_release_notes.py | 193 | def test_strip_to_pr_groups_keeps_subsection_headings(): | CODE |
| LOW | docs/tests/test_release_notes.py | 199 | def test_submodule_section_format(monkeypatch): | CODE |
| LOW | docs/tests/test_release_notes.py | 222 | def test_submodule_section_added_when_no_prev_floor(monkeypatch): | CODE |
| LOW | docs/tests/test_release_notes.py | 238 | def test_submodule_section_optional_note(monkeypatch): | CODE |
| LOW | docs/tests/test_release_notes.py | 258 | def test_submodule_section_no_optional_note_by_default(monkeypatch): | CODE |
| LOW | docs/tests/test_release_notes.py | 273 | def test_optional_only_names_excludes_core_deps(): | CODE |
| LOW⚡ | docs/tests/test_release_notes.py | 44 | def test_norm_unifies_separators_and_case(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 48 | def test_spec_floor_reads_lower_bound(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 54 | def test_spec_floor_none_without_lower_bound(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 59 | def test_load_floors_covers_deps_and_extras(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 68 | def test_load_ranges_normalizes_names(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 74 | def test_resolve_tag_picks_max_matching(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 80 | def test_resolve_tag_none_when_no_match(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 84 | def test_resolve_floor_tag_exact_and_spelling_tolerant(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 91 | def test_resolve_floor_tag_none_when_absent(): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 109 | def test_window_start_inline_returns_tag(monkeypatch): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 119 | def test_window_start_diverged_returns_merge_base(monkeypatch): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 129 | def test_window_start_missing_merge_base_falls_back(monkeypatch): | STRING |
| LOW⚡ | docs/tests/test_release_notes.py | 135 | def test_normalize_version_adds_v_prefix(): | STRING |
| LOW | docs/tests/test_release_notes.py | 292 | def test_submodule_section_omits_empty_pr_body(monkeypatch): | STRING |
| LOW | docs/tests/test_release_notes.py | 368 | def test_build_page_covers_extra_changelog_repos(monkeypatch, tmp_path): | STRING |
| LOW | docs/tests/test_release_notes.py | 421 | def test_extra_changelog_repos_disjoint_from_manifest(): | STRING |
| LOW | docs/tests/test_release_notes.py | 437 | def test_default_summary_omits_window_line_without_prev_tag(): | STRING |
| LOW | docs/tests/test_release_notes.py | 470 | def test_regenerate_auto_regions_preserves_summary_and_out_of_band_edits(): | STRING |
| LOW | docs/tests/test_release_notes.py | 495 | def test_regenerate_auto_regions_aborts_on_region_count_mismatch(): | STRING |
| LOW | docs/tests/test_release_notes.py | 503 | def test_update_index_toctree_inserts_sorted_descending(tmp_path): | STRING |
| LOW | docs/tests/test_release_notes.py | 518 | def test_update_index_toctree_is_idempotent(tmp_path): | STRING |
| LOW | docs/tests/test_release_notes.py | 529 | def test_update_index_toctree_preserves_options(tmp_path): | STRING |
| LOW | docs/tests/test_subpackage_docs.py | 89 | def test_neither_and_missing_index_skipped(make_site): | CODE |
| LOW | docs/tests/test_subpackage_docs.py | 111 | def test_full_subtree_with_nested_page_and_image(make_site): | CODE |
| LOW | docs/tests/test_subpackage_docs.py | 153 | def test_baseline_no_submodules(make_site): | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | docs/source/roadmap/new-persona-api.md | 103 | # ─── Lifecycle methods ──────────────────────────────── | COMMENT |
| MEDIUM | docs/source/roadmap/new-persona-api.md | 117 | # ─── Process message (delegates to self.engine) ─────── | COMMENT |
| MEDIUM | docs/source/roadmap/new-persona-api.md | 120 | # ─── Runtime update APIs ──────────────────────────────── | COMMENT |
| MEDIUM | docs/source/roadmap/new-persona-api.md | 132 | # ─── Lifecycle methods ──────────────────────────────── | COMMENT |
| MEDIUM | docs/source/roadmap/new-persona-api.md | 141 | # ─── Process message ──────────────────────────────── | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | README.md | 11 | Agents in Jupyter AI can read and write files, run terminal commands, and interact with notebooks through a built-in [Ju | CODE |
| MEDIUM | docs/source/roadmap/new-persona-api.md | 232 | ### Example 1: Defining agentic AI personas powered by local models | COMMENT |
| MEDIUM | docs/source/users/magic_commands/index.md | 206 | ### Configuring context window | COMMENT |
| MEDIUM | …elopers/entry_points_api/embeddings_providers_group.md | 21 | ## How-to: Define a custom embedding model provider | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | docs/source/_ext/autodoc_subpackages.py | 119 | except Exception: | CODE |
| HIGH | docs/source/_ext/autodoc_subpackages.py | 324 | except Exception: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | pyproject.toml | 81 | # release is committed and tagged, freeze the documentation submodules to the | COMMENT |
| LOW | scripts/update-doc-submodules.sh | 1 | #!/usr/bin/env bash | COMMENT |
| LOW | scripts/rtd-post-checkout.sh | 1 | #!/usr/bin/env bash | COMMENT |
| LOW | scripts/generate_release_notes.py | 81 | # a contributor added outside the auto regions — is preserved verbatim. This lets | COMMENT |
| LOW | scripts/freeze-doc-submodules.sh | 1 | #!/usr/bin/env bash | COMMENT |
| LOW | .github/workflows/prep-release-docs.yml | 1 | name: "Step 0: Prep release documentation" | COMMENT |
| LOW | .github/workflows/update-submodule-docs.yml | 1 | name: Update submodule documentation | COMMENT |
| LOW | ui-tests/jupyter_server_test_config.py | 41 | # playwright.config.js); persona-manager reads the MCP port to build its | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | docs/source/_ext/autodoc_subpackages.py | 119 | except Exception: | CODE |
| LOW | docs/source/_ext/autodoc_subpackages.py | 125 | except Exception: | CODE |
| LOW | docs/source/_ext/autodoc_subpackages.py | 143 | except Exception: | CODE |
| LOW | docs/source/_ext/autodoc_subpackages.py | 250 | except Exception as exc: # pragma: no cover - defensive | CODE |
| LOW | docs/source/_ext/autodoc_subpackages.py | 324 | except Exception: | CODE |
| LOW | scripts/_submodule_versions.py | 72 | except Exception: # pragma: no cover - defensive | CODE |
| LOW | scripts/_submodule_versions.py | 129 | except Exception: # pragma: no cover - defensive | CODE |
| LOW | scripts/_submodule_versions.py | 137 | except Exception: # pragma: no cover - defensive | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | docs/source/_ext/autodoc_subpackages.py | 35 | CODE | |
| LOW | docs/source/_ext/subpackage_docs.py | 38 | CODE | |
| LOW | docs/tests/conftest.py | 19 | CODE | |
| LOW | docs/tests/test_release_notes.py | 12 | CODE | |
| LOW | docs/tests/test_subpackage_docs.py | 18 | CODE | |
| LOW | scripts/_resolve_doc_submodules.py | 42 | CODE | |
| LOW | scripts/generate_release_notes.py | 48 | CODE | |
| LOW | scripts/_submodule_versions.py | 25 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | docs/source/_ext/autodoc_subpackages.py | 51 | logger = logging.getLogger(__name__) | CODE |
| LOW | docs/source/_ext/subpackage_docs.py | 47 | logger = logging.getLogger(__name__) | CODE |
| LOW | scripts/generate_release_notes.py | 553 | def update_index_toctree(index_path: str, stem: str) -> None: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | docs/tests/conftest.py | 107 | CODE | |
| LOW | docs/tests/conftest.py | 122 | CODE |