repatch

SUMD - Structured Unified Markdown Descriptor for AI-aware project refactorization

Metadata
Architecture
Dependencies
Source Map
Call Graph
Test Contracts
Refactoring Analysis
Intent

Metadata

name: repatch
version: 0.2.14
python_requires: >=3.10
license: Apache-2.0
ai_model: openrouter/qwen/qwen3-coder-next
ecosystem: SUMD + DOQL + testql + taskfile
generated_from: pyproject.toml, testql(2), app.doql.less, goal.yaml, .env.example, src(12 mod), project/(5 analysis files)

Architecture

SUMD (description) → DOQL/source (code) → taskfile (automation) → testql (verification)

DOQL Application Declaration (`app.doql.less`)

// LESS format — define @variables here as needed

app {
  name: repatch;
  version: 0.2.14;
}

dependencies {
  runtime: litellm>=1.40.0;
  dev: "pytest>=7.0, goal>=2.1.0, costs>=0.1.20, pfix>=0.1.60";
}

deploy {
  target: pip;
}

environment[name="local"] {
  runtime: python;
  env_file: .env;
  python_version: >=3.10;
}

Source Modules

repatch.css
repatch.dom_patch
repatch.marked_context
repatch.options
repatch.organize_html
repatch.project_ir
repatch.scope
repatch.service
repatch.spatial
repatch.ui_patch
repatch.web_fetch
repatch.web_preprocess

Dependencies

Runtime

litellm>=1.40.0

Development

pytest>=7.0
goal>=2.1.0
costs>=0.1.20
pfix>=0.1.60

Source Map

Top 5 modules by symbol density — signatures for LLM orientation.

`repatch.marked_context` (`repatch/marked_context.py`)

def has_ui_marks(keep_els, delete_els)  # CC=8, fan=3
def effective_delete_ids(delete_els, keep_els)  # CC=9, fan=6
def _css_id_selector(token)  # CC=4, fan=3
def marked_css_selectors(element_ids)  # CC=6, fan=5
def _fragment_class_names(fragment)  # CC=5, fan=7
def _collect_keep_selectors(html, keep_ids)  # CC=11, fan=12 ⚠
def resolve_marked_selectors(html, element_ids)  # CC=16, fan=14 ⚠
def marked_scope_colors_css(selectors, variant)  # CC=12, fan=7 ⚠
def marked_scope_display_css(selectors, variant)  # CC=6, fan=3
def marked_scope_shapes_css(selectors, variant)  # CC=6, fan=3
def marked_scope_orientation_css(selectors, variant)  # CC=8, fan=6
def restrict_scope_css_to_marks(css, delete_ids)  # CC=14, fan=11 ⚠
def _id_candidates(element_id)  # CC=4, fan=7
def _normalize_label_text(text)  # CC=2, fan=5
def _parse_attrs(attr_text)  # CC=3, fan=4
def _logical_id(tag, attrs)  # CC=8, fan=6
def _extract_balanced_html(html, start)  # CC=10, fan=11 ⚠
def _collect_match_candidates(tag, attrs)  # CC=6, fan=6
def _collect_button_candidates(tag, attrs, match, raw_html)  # CC=3, fan=8
def _extract_and_format_fragment(text, start)  # CC=3, fan=6
def _find_marked_subtrees(html, marked_ids)  # CC=17, fan=13 ⚠
def _selector_tokens(subtrees)  # CC=9, fan=9
def _filter_css_for_tokens(css, tokens)  # CC=6, fan=6
def _collect_css_sources(html, ui_profile)  # CC=7, fan=8
def _scope_semantics(scope)  # CC=4, fan=2
def _cap_text(text, limit)  # CC=2, fan=4
def _client_fragment_html(client_fragments, element_id)  # CC=9, fan=5
def _assemble_marked_subtrees(html, marked_ids, client_fragments)  # CC=4, fan=3
def _get_relevant_css(html, subtrees, ui_profile)  # CC=2, fan=6
def _format_context_body(keep, delete, marked_ids, subtrees, css, scope, ui_profile)  # CC=14, fan=7 ⚠
def build_marked_element_context(html)  # CC=11, fan=7 ⚠
def resolve_marked_llm_context(html)  # CC=5, fan=2

`repatch.scope` (`repatch/scope.py`)

def goal_requests_column_layout(user_goal)  # CC=3, fan=3
def ui_type_for_kind(kind)  # CC=11, fan=3 ⚠
def allowed_scope_ids(project_kind)  # CC=2, fan=3
def default_scope_for_kind(project_kind)  # CC=3, fan=4
def normalize_focus_scope(scope, project_kind)  # CC=3, fan=5
def offline_fast_scopes_for_kind(project_kind)  # CC=5, fan=2
def scope_supports_offline_fast_path(scope, project_kind)  # CC=1, fan=2
def strip_scope_style(html)  # CC=2, fan=1
def _scope_css(scope, variant)  # CC=6, fan=0
def _calc_scope_css(scope, variant)  # CC=7, fan=0
def _uses_web_scope_css(inferred, html)  # CC=7, fan=1
def _web_display_scope_css(variant)  # CC=5, fan=1
def _web_shapes_scope_css(variant)  # CC=3, fan=2
def _web_orientation_scope_css(variant)  # CC=6, fan=2
def _web_scope_css(scope, variant)  # CC=6, fan=3
def _resolve_scope_kind(project_kind, html)  # CC=10, fan=2 ⚠
def should_block_full_html_iterate(project_kind, keep_els, delete_els)  # CC=3, fan=3
def _bind_annotations_to_html(html, keep_ids, delete_ids)  # CC=29, fan=19 ⚠
def _get_scope_css(inferred, html, scope, variant)  # CC=7, fan=5
def _inject_css_block(html, css)  # CC=5, fan=4
def inject_scope_style(html, scope, variant)  # CC=27, fan=20 ⚠
def scoped_html_fragment(html, focus_scope, project_kind)  # CC=6, fan=6

`repatch.web_preprocess` (`repatch/web_preprocess.py`)

def safe_read_under(base_dir, rel_path)  # CC=5, fan=5
def extract_inline_css(html)  # CC=4, fan=3
def extract_stylesheet_hrefs(html)  # CC=7, fan=4
def normalize_linked_paths(linked_css_paths, html)  # CC=9, fan=6
def _rule_is_visual(rule)  # CC=6, fan=4
def filter_visual_css(css)  # CC=3, fan=4
def extract_visual_css(html, linked_css_paths, source_dir)  # CC=8, fan=12
def build_html_outline(html)  # CC=3, fan=11
def _script_src_allowed_for_preview(src)  # CC=4, fan=4
def _should_remove_preview_script(tag)  # CC=2, fan=3
def sanitize_http_preview_html(html)  # CC=2, fan=4
def inject_http_preview_shim(html)  # CC=4, fan=2
def prepare_http_preview_html(html)  # CC=1, fan=2
def _cap_patch_text(text, max_bytes)  # CC=4, fan=6
def build_http_llm_context(artifacts)  # CC=29, fan=9 ⚠
def http_patch_llm_rules()  # CC=1, fan=1
class _OutlineParser:
    def __init__()  # CC=1
    def _keep_attr(name)  # CC=2
    def handle_starttag(tag, attrs)  # CC=8
    def handle_endtag(tag)  # CC=4
    def handle_data(data)  # CC=4

`repatch.dom_patch` (`repatch/dom_patch.py`)

def supports_function_patch(scope, project_kind)  # CC=4, fan=2
def build_function_patch_context(html_text)  # CC=2, fan=3
def _strip_existing_patch(text)  # CC=2, fan=2
def _goal_label(user_goal)  # CC=3, fan=2
def _variant_section(variant, user_goal, ir)  # CC=3, fan=5
def _patch_style()  # CC=1, fan=0
def _inject_into_head(text, style)  # CC=4, fan=4
def _inject_into_body(text, section)  # CC=2, fan=2
def _target_candidates(element_id)  # CC=4, fan=6
def _strip_tags(text)  # CC=2, fan=2
def _set_attr(open_tag, attr, value)  # CC=2, fan=4
def _attrs_from_open_tag(open_tag)  # CC=2, fan=5
def _matches_target(open_tag, inner, wanted)  # CC=4, fan=6
def _variant_target_label(variant, user_goal)  # CC=3, fan=1
def _variant_href(variant, original_href)  # CC=4, fan=4
def _patch_function_targets(html_text, delete_els, variant, user_goal)  # CC=6, fan=18
def _default_prepare_html(html)  # CC=3, fan=2
def _default_finalize_html(html)  # CC=1, fan=0
def build_function_option_patches(html_text)  # CC=12, fan=15 ⚠

`repatch.web_fetch` (`repatch/web_fetch.py`)

def _validate_http_url(url)  # CC=3, fan=2
def _charset_from_content_type(content_type)  # CC=3, fan=4
def _decode_http_bytes(body)  # CC=4, fan=2
def _same_origin(url, base_url)  # CC=2, fan=1
def _read_http_body(url)  # CC=7, fan=13
def _render_with_playwright(url)  # CC=7, fan=10
def _extension_from_url_or_type(url, content_type, fallback)  # CC=4, fan=7
def _save_asset()  # CC=3, fan=5
def _is_stylesheet_link(tag)  # CC=2, fan=4
def _replace_attr(tag, pattern, value)  # CC=2, fan=4
def _mirror_stylesheets(html)  # CC=1, fan=10
def _parse_srcset(value)  # CC=4, fan=5
def _format_srcset(items)  # CC=3, fan=3
def _mirror_images(html)  # CC=1, fan=13
def fetch_complete_web_page(url)  # CC=7, fan=10
class WebAsset:  # One mirrored page asset.
class WebFetchResult:  # Fetched page HTML plus mirrored assets and diagnostics.

Call Graph

129 nodes · 140 edges · 13 modules · CC̄=5.2

Hubs (by degree)

Function	CC	in	out	total
`_bind_annotations_to_html` (in repatch.scope)	29 ⚠	1	44	45
`build_http_llm_context` (in repatch.web_preprocess)	29 ⚠	0	41	41
`apply_ui_patch_options` (in repatch.ui_patch)	25 ⚠	0	31	31
`apply_spatial_deletes_to_html` (in repatch.spatial)	4	2	29	31
`organize_html` (in repatch.organize_html)	24 ⚠	2	29	31
`inject_scope_style` (in repatch.scope)	27 ⚠	0	29	29
`validate_css_safety` (in repatch.css)	14 ⚠	1	26	27
`resolve_marked_selectors` (in repatch.marked_context)	16 ⚠	3	23	26

# code2llm call graph | /home/tom/github/semcod/repatch
# generated in 0.09s
# nodes: 129 | edges: 140 | modules: 13
# CC̄=5.2

HUBS[20]:
  repatch.scope._bind_annotations_to_html
    CC=29  in:1  out:44  total:45
  repatch.web_preprocess.build_http_llm_context
    CC=29  in:0  out:41  total:41
  repatch.ui_patch.apply_ui_patch_options
    CC=25  in:0  out:31  total:31
  repatch.spatial.apply_spatial_deletes_to_html
    CC=4  in:2  out:29  total:31
  repatch.organize_html.organize_html
    CC=24  in:2  out:29  total:31
  repatch.scope.inject_scope_style
    CC=27  in:0  out:29  total:29
  repatch.css.validate_css_safety
    CC=14  in:1  out:26  total:27
  repatch.marked_context.resolve_marked_selectors
    CC=16  in:3  out:23  total:26
  repatch.marked_context._find_marked_subtrees
    CC=17  in:3  out:23  total:26
  repatch.web_fetch._mirror_images
    CC=1  in:1  out:24  total:25
  repatch.dom_patch._patch_function_targets
    CC=6  in:1  out:24  total:25
  repatch.marked_context._id_candidates
    CC=4  in:10  out:13  total:23
  repatch.project_ir.summarize_project_ir
    CC=12  in:1  out:21  total:22
  repatch.marked_context._collect_keep_selectors
    CC=11  in:1  out:19  total:20
  repatch.marked_context.restrict_scope_css_to_marks
    CC=14  in:2  out:17  total:19
  repatch.web_preprocess.extract_visual_css
    CC=8  in:0  out:19  total:19
  repatch.marked_context._extract_balanced_html
    CC=10  in:1  out:18  total:19
  repatch.web_fetch._read_http_body
    CC=7  in:2  out:16  total:18
  repatch.options.sync_option_previews_from_workspace
    CC=10  in:0  out:17  total:17
  sdks.js.repatch-sdk.RepatchSDK.apply
    CC=12  in:3  out:14  total:17

MODULES:
  repatch.css  [4 funcs]
    _selector_is_runtime_only  CC=2  out:2
    _strip_css_comments  CC=2  out:2
    split_css_rules  CC=9  out:6
    validate_css_safety  CC=14  out:26
  repatch.dom_patch  [14 funcs]
    _attrs_from_open_tag  CC=2  out:6
    _goal_label  CC=3  out:2
    _inject_into_body  CC=2  out:3
    _inject_into_head  CC=4  out:5
    _matches_target  CC=4  out:7
    _patch_function_targets  CC=6  out:24
    _strip_existing_patch  CC=2  out:3
    _strip_tags  CC=2  out:3
    _target_candidates  CC=4  out:9
    _variant_section  CC=3  out:11
  repatch.marked_context  [27 funcs]
    _assemble_marked_subtrees  CC=4  out:3
    _cap_text  CC=2  out:4
    _client_fragment_html  CC=9  out:10
    _collect_button_candidates  CC=3  out:8
    _collect_css_sources  CC=7  out:10
    _collect_keep_selectors  CC=11  out:19
    _collect_match_candidates  CC=6  out:11
    _css_id_selector  CC=4  out:3
    _extract_and_format_fragment  CC=3  out:6
    _extract_balanced_html  CC=10  out:18
  repatch.options  [4 funcs]
    enforce_deletes_on_option_previews  CC=9  out:14
    html_files_distinct  CC=3  out:7
    normalize_html_body  CC=2  out:3
    sync_option_previews_from_workspace  CC=10  out:17
  repatch.organize_html  [8 funcs]
    _add_markable_targets  CC=1  out:14
    _attr_map  CC=3  out:4
    _extract_inline_styles  CC=4  out:5
    _strip_lazy_placeholder_imgs  CC=1  out:3
    is_lazy_placeholder_img_tag  CC=11  out:14
    organize_html  CC=24  out:29
    organize_html_project  CC=1  out:1
    organize_html_project_dir  CC=8  out:6
  repatch.project_ir  [6 funcs]
    _classify_node  CC=12  out:10
    handle_data  CC=4  out:2
    handle_endtag  CC=8  out:11
    _clean_text  CC=2  out:3
    build_project_ir  CC=2  out:8
    summarize_project_ir  CC=12  out:21
  repatch.scope  [20 funcs]
    _bind_annotations_to_html  CC=29  out:44
    _calc_scope_css  CC=7  out:0
    _get_scope_css  CC=7  out:7
    _inject_css_block  CC=5  out:4
    _resolve_scope_kind  CC=10  out:3
    _scope_css  CC=6  out:0
    _web_display_scope_css  CC=5  out:3
    _web_orientation_scope_css  CC=6  out:2
    _web_scope_css  CC=6  out:3
    _web_shapes_scope_css  CC=3  out:2
  repatch.spatial  [3 funcs]
    _delete_match_keys  CC=4  out:11
    _element_delete_candidates  CC=6  out:8
    apply_spatial_deletes_to_html  CC=4  out:29
  repatch.ui_patch  [9 funcs]
    _compact_html  CC=3  out:4
    _css_for  CC=2  out:4
    _patch_scope_rules  CC=7  out:9
    _safe_css  CC=9  out:11
    _strip_json_fence  CC=3  out:5
    apply_ui_patch_options  CC=25  out:31
    build_ui_patch_prompt  CC=9  out:5
    parse_ui_patch_response  CC=6  out:11
    supports_llm_patch_scope  CC=3  out:1
  repatch.web_fetch  [12 funcs]
    _charset_from_content_type  CC=3  out:4
    _decode_http_bytes  CC=4  out:3
    _extension_from_url_or_type  CC=4  out:7
    _is_stylesheet_link  CC=2  out:4
    _mirror_images  CC=1  out:24
    _mirror_stylesheets  CC=1  out:13
    _read_http_body  CC=7  out:16
    _replace_attr  CC=2  out:4
    _same_origin  CC=2  out:2
    _save_asset  CC=3  out:5
  repatch.web_preprocess  [14 funcs]
    _cap_patch_text  CC=4  out:6
    _rule_is_visual  CC=6  out:8
    _script_src_allowed_for_preview  CC=4  out:5
    _should_remove_preview_script  CC=2  out:3
    build_http_llm_context  CC=29  out:41
    extract_inline_css  CC=4  out:4
    extract_stylesheet_hrefs  CC=7  out:4
    extract_visual_css  CC=8  out:19
    filter_visual_css  CC=3  out:4
    inject_http_preview_shim  CC=4  out:4
  sdks.js.repatch-sdk  [7 funcs]
    _connectSSE  CC=3  out:5
    _connectWS  CC=3  out:7
    apply  CC=12  out:14
    cb  CC=1  out:0
    connect  CC=2  out:3
    payload  CC=2  out:1
    setTimeout  CC=1  out:1
  sdks.python.repatch_sdk  [1 funcs]
    _trigger_listeners  CC=3  out:2

EDGES:
  repatch.project_ir._ProjectIRParser._classify_node → repatch.project_ir._clean_text
  repatch.project_ir._ProjectIRParser.handle_endtag → repatch.project_ir._clean_text
  repatch.project_ir._ProjectIRParser.handle_data → repatch.project_ir._clean_text
  repatch.scope.default_scope_for_kind → repatch.scope.allowed_scope_ids
  repatch.scope.normalize_focus_scope → repatch.scope.default_scope_for_kind
  repatch.scope.normalize_focus_scope → repatch.scope.allowed_scope_ids
  repatch.scope.scope_supports_offline_fast_path → repatch.scope.normalize_focus_scope
  repatch.scope.scope_supports_offline_fast_path → repatch.scope.offline_fast_scopes_for_kind
  repatch.scope._web_orientation_scope_css → repatch.scope.goal_requests_column_layout
  repatch.scope._web_scope_css → repatch.scope._web_shapes_scope_css
  repatch.scope._web_scope_css → repatch.scope._web_display_scope_css
  repatch.scope._web_scope_css → repatch.scope._web_orientation_scope_css
  repatch.scope.should_block_full_html_iterate → repatch.marked_context.has_ui_marks
  repatch.scope._get_scope_css → repatch.scope._calc_scope_css
  repatch.scope._get_scope_css → repatch.scope._scope_css
  repatch.scope._get_scope_css → repatch.scope._web_scope_css
  repatch.scope.inject_scope_style → repatch.scope._bind_annotations_to_html
  repatch.scope.inject_scope_style → repatch.scope._resolve_scope_kind
  repatch.scope.inject_scope_style → repatch.scope.normalize_focus_scope
  repatch.scope.inject_scope_style → repatch.marked_context.effective_delete_ids
  repatch.scope.inject_scope_style → repatch.scope._get_scope_css
  repatch.scope.inject_scope_style → repatch.scope.strip_scope_style
  repatch.scope.inject_scope_style → repatch.scope._inject_css_block
  repatch.scope.scoped_html_fragment → repatch.scope.normalize_focus_scope
  repatch.scope.scoped_html_fragment → repatch.scope.scope_supports_offline_fast_path
  repatch.dom_patch.build_function_patch_context → repatch.project_ir.build_project_ir
  repatch.dom_patch.build_function_patch_context → repatch.project_ir.summarize_project_ir
  repatch.dom_patch._variant_section → repatch.dom_patch._goal_label
  repatch.dom_patch._matches_target → repatch.dom_patch._attrs_from_open_tag
  repatch.dom_patch._matches_target → repatch.dom_patch._strip_tags
  repatch.dom_patch._matches_target → repatch.dom_patch._target_candidates
  repatch.dom_patch._variant_target_label → repatch.dom_patch._goal_label
  repatch.dom_patch._patch_function_targets → repatch.dom_patch._target_candidates
  repatch.dom_patch._patch_function_targets → repatch.dom_patch._variant_target_label
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._strip_existing_patch
  repatch.dom_patch.build_function_option_patches → repatch.project_ir.build_project_ir
  repatch.dom_patch.build_function_option_patches → repatch.marked_context.effective_delete_ids
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch.supports_function_patch
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._patch_function_targets
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._inject_into_head
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._inject_into_body
  repatch.marked_context.marked_css_selectors → repatch.marked_context._id_candidates
  repatch.marked_context.marked_css_selectors → repatch.marked_context._css_id_selector
  repatch.marked_context._collect_keep_selectors → repatch.marked_context._fragment_class_names
  repatch.marked_context._collect_keep_selectors → repatch.marked_context.marked_css_selectors
  repatch.marked_context._collect_keep_selectors → repatch.marked_context._find_marked_subtrees
  repatch.marked_context.resolve_marked_selectors → repatch.marked_context._find_marked_subtrees
  repatch.marked_context.resolve_marked_selectors → repatch.marked_context._collect_keep_selectors
  repatch.marked_context.resolve_marked_selectors → repatch.marked_context.marked_css_selectors
  repatch.marked_context.restrict_scope_css_to_marks → repatch.css.split_css_rules

Test Contracts

Scenarios as contract signatures — what the system guarantees.

Cli (1)

CLI Command Tests

Integration (1)

Auto-generated from Python Tests

Refactoring Analysis

Pre-refactoring snapshot — use this section to identify targets. Generated from project/ toon files.

Call Graph & Complexity (`project/calls.toon.yaml`)

# code2llm call graph | /home/tom/github/semcod/repatch
# generated in 0.09s
# nodes: 129 | edges: 140 | modules: 13
# CC̄=5.2

HUBS[20]:
  repatch.scope._bind_annotations_to_html
    CC=29  in:1  out:44  total:45
  repatch.web_preprocess.build_http_llm_context
    CC=29  in:0  out:41  total:41
  repatch.ui_patch.apply_ui_patch_options
    CC=25  in:0  out:31  total:31
  repatch.spatial.apply_spatial_deletes_to_html
    CC=4  in:2  out:29  total:31
  repatch.organize_html.organize_html
    CC=24  in:2  out:29  total:31
  repatch.scope.inject_scope_style
    CC=27  in:0  out:29  total:29
  repatch.css.validate_css_safety
    CC=14  in:1  out:26  total:27
  repatch.marked_context.resolve_marked_selectors
    CC=16  in:3  out:23  total:26
  repatch.marked_context._find_marked_subtrees
    CC=17  in:3  out:23  total:26
  repatch.web_fetch._mirror_images
    CC=1  in:1  out:24  total:25
  repatch.dom_patch._patch_function_targets
    CC=6  in:1  out:24  total:25
  repatch.marked_context._id_candidates
    CC=4  in:10  out:13  total:23
  repatch.project_ir.summarize_project_ir
    CC=12  in:1  out:21  total:22
  repatch.marked_context._collect_keep_selectors
    CC=11  in:1  out:19  total:20
  repatch.marked_context.restrict_scope_css_to_marks
    CC=14  in:2  out:17  total:19
  repatch.web_preprocess.extract_visual_css
    CC=8  in:0  out:19  total:19
  repatch.marked_context._extract_balanced_html
    CC=10  in:1  out:18  total:19
  repatch.web_fetch._read_http_body
    CC=7  in:2  out:16  total:18
  repatch.options.sync_option_previews_from_workspace
    CC=10  in:0  out:17  total:17
  sdks.js.repatch-sdk.RepatchSDK.apply
    CC=12  in:3  out:14  total:17

MODULES:
  repatch.css  [4 funcs]
    _selector_is_runtime_only  CC=2  out:2
    _strip_css_comments  CC=2  out:2
    split_css_rules  CC=9  out:6
    validate_css_safety  CC=14  out:26
  repatch.dom_patch  [14 funcs]
    _attrs_from_open_tag  CC=2  out:6
    _goal_label  CC=3  out:2
    _inject_into_body  CC=2  out:3
    _inject_into_head  CC=4  out:5
    _matches_target  CC=4  out:7
    _patch_function_targets  CC=6  out:24
    _strip_existing_patch  CC=2  out:3
    _strip_tags  CC=2  out:3
    _target_candidates  CC=4  out:9
    _variant_section  CC=3  out:11
  repatch.marked_context  [27 funcs]
    _assemble_marked_subtrees  CC=4  out:3
    _cap_text  CC=2  out:4
    _client_fragment_html  CC=9  out:10
    _collect_button_candidates  CC=3  out:8
    _collect_css_sources  CC=7  out:10
    _collect_keep_selectors  CC=11  out:19
    _collect_match_candidates  CC=6  out:11
    _css_id_selector  CC=4  out:3
    _extract_and_format_fragment  CC=3  out:6
    _extract_balanced_html  CC=10  out:18
  repatch.options  [4 funcs]
    enforce_deletes_on_option_previews  CC=9  out:14
    html_files_distinct  CC=3  out:7
    normalize_html_body  CC=2  out:3
    sync_option_previews_from_workspace  CC=10  out:17
  repatch.organize_html  [8 funcs]
    _add_markable_targets  CC=1  out:14
    _attr_map  CC=3  out:4
    _extract_inline_styles  CC=4  out:5
    _strip_lazy_placeholder_imgs  CC=1  out:3
    is_lazy_placeholder_img_tag  CC=11  out:14
    organize_html  CC=24  out:29
    organize_html_project  CC=1  out:1
    organize_html_project_dir  CC=8  out:6
  repatch.project_ir  [6 funcs]
    _classify_node  CC=12  out:10
    handle_data  CC=4  out:2
    handle_endtag  CC=8  out:11
    _clean_text  CC=2  out:3
    build_project_ir  CC=2  out:8
    summarize_project_ir  CC=12  out:21
  repatch.scope  [20 funcs]
    _bind_annotations_to_html  CC=29  out:44
    _calc_scope_css  CC=7  out:0
    _get_scope_css  CC=7  out:7
    _inject_css_block  CC=5  out:4
    _resolve_scope_kind  CC=10  out:3
    _scope_css  CC=6  out:0
    _web_display_scope_css  CC=5  out:3
    _web_orientation_scope_css  CC=6  out:2
    _web_scope_css  CC=6  out:3
    _web_shapes_scope_css  CC=3  out:2
  repatch.spatial  [3 funcs]
    _delete_match_keys  CC=4  out:11
    _element_delete_candidates  CC=6  out:8
    apply_spatial_deletes_to_html  CC=4  out:29
  repatch.ui_patch  [9 funcs]
    _compact_html  CC=3  out:4
    _css_for  CC=2  out:4
    _patch_scope_rules  CC=7  out:9
    _safe_css  CC=9  out:11
    _strip_json_fence  CC=3  out:5
    apply_ui_patch_options  CC=25  out:31
    build_ui_patch_prompt  CC=9  out:5
    parse_ui_patch_response  CC=6  out:11
    supports_llm_patch_scope  CC=3  out:1
  repatch.web_fetch  [12 funcs]
    _charset_from_content_type  CC=3  out:4
    _decode_http_bytes  CC=4  out:3
    _extension_from_url_or_type  CC=4  out:7
    _is_stylesheet_link  CC=2  out:4
    _mirror_images  CC=1  out:24
    _mirror_stylesheets  CC=1  out:13
    _read_http_body  CC=7  out:16
    _replace_attr  CC=2  out:4
    _same_origin  CC=2  out:2
    _save_asset  CC=3  out:5
  repatch.web_preprocess  [14 funcs]
    _cap_patch_text  CC=4  out:6
    _rule_is_visual  CC=6  out:8
    _script_src_allowed_for_preview  CC=4  out:5
    _should_remove_preview_script  CC=2  out:3
    build_http_llm_context  CC=29  out:41
    extract_inline_css  CC=4  out:4
    extract_stylesheet_hrefs  CC=7  out:4
    extract_visual_css  CC=8  out:19
    filter_visual_css  CC=3  out:4
    inject_http_preview_shim  CC=4  out:4
  sdks.js.repatch-sdk  [7 funcs]
    _connectSSE  CC=3  out:5
    _connectWS  CC=3  out:7
    apply  CC=12  out:14
    cb  CC=1  out:0
    connect  CC=2  out:3
    payload  CC=2  out:1
    setTimeout  CC=1  out:1
  sdks.python.repatch_sdk  [1 funcs]
    _trigger_listeners  CC=3  out:2

EDGES:
  repatch.project_ir._ProjectIRParser._classify_node → repatch.project_ir._clean_text
  repatch.project_ir._ProjectIRParser.handle_endtag → repatch.project_ir._clean_text
  repatch.project_ir._ProjectIRParser.handle_data → repatch.project_ir._clean_text
  repatch.scope.default_scope_for_kind → repatch.scope.allowed_scope_ids
  repatch.scope.normalize_focus_scope → repatch.scope.default_scope_for_kind
  repatch.scope.normalize_focus_scope → repatch.scope.allowed_scope_ids
  repatch.scope.scope_supports_offline_fast_path → repatch.scope.normalize_focus_scope
  repatch.scope.scope_supports_offline_fast_path → repatch.scope.offline_fast_scopes_for_kind
  repatch.scope._web_orientation_scope_css → repatch.scope.goal_requests_column_layout
  repatch.scope._web_scope_css → repatch.scope._web_shapes_scope_css
  repatch.scope._web_scope_css → repatch.scope._web_display_scope_css
  repatch.scope._web_scope_css → repatch.scope._web_orientation_scope_css
  repatch.scope.should_block_full_html_iterate → repatch.marked_context.has_ui_marks
  repatch.scope._get_scope_css → repatch.scope._calc_scope_css
  repatch.scope._get_scope_css → repatch.scope._scope_css
  repatch.scope._get_scope_css → repatch.scope._web_scope_css
  repatch.scope.inject_scope_style → repatch.scope._bind_annotations_to_html
  repatch.scope.inject_scope_style → repatch.scope._resolve_scope_kind
  repatch.scope.inject_scope_style → repatch.scope.normalize_focus_scope
  repatch.scope.inject_scope_style → repatch.marked_context.effective_delete_ids
  repatch.scope.inject_scope_style → repatch.scope._get_scope_css
  repatch.scope.inject_scope_style → repatch.scope.strip_scope_style
  repatch.scope.inject_scope_style → repatch.scope._inject_css_block
  repatch.scope.scoped_html_fragment → repatch.scope.normalize_focus_scope
  repatch.scope.scoped_html_fragment → repatch.scope.scope_supports_offline_fast_path
  repatch.dom_patch.build_function_patch_context → repatch.project_ir.build_project_ir
  repatch.dom_patch.build_function_patch_context → repatch.project_ir.summarize_project_ir
  repatch.dom_patch._variant_section → repatch.dom_patch._goal_label
  repatch.dom_patch._matches_target → repatch.dom_patch._attrs_from_open_tag
  repatch.dom_patch._matches_target → repatch.dom_patch._strip_tags
  repatch.dom_patch._matches_target → repatch.dom_patch._target_candidates
  repatch.dom_patch._variant_target_label → repatch.dom_patch._goal_label
  repatch.dom_patch._patch_function_targets → repatch.dom_patch._target_candidates
  repatch.dom_patch._patch_function_targets → repatch.dom_patch._variant_target_label
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._strip_existing_patch
  repatch.dom_patch.build_function_option_patches → repatch.project_ir.build_project_ir
  repatch.dom_patch.build_function_option_patches → repatch.marked_context.effective_delete_ids
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch.supports_function_patch
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._patch_function_targets
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._inject_into_head
  repatch.dom_patch.build_function_option_patches → repatch.dom_patch._inject_into_body
  repatch.marked_context.marked_css_selectors → repatch.marked_context._id_candidates
  repatch.marked_context.marked_css_selectors → repatch.marked_context._css_id_selector
  repatch.marked_context._collect_keep_selectors → repatch.marked_context._fragment_class_names
  repatch.marked_context._collect_keep_selectors → repatch.marked_context.marked_css_selectors
  repatch.marked_context._collect_keep_selectors → repatch.marked_context._find_marked_subtrees
  repatch.marked_context.resolve_marked_selectors → repatch.marked_context._find_marked_subtrees
  repatch.marked_context.resolve_marked_selectors → repatch.marked_context._collect_keep_selectors
  repatch.marked_context.resolve_marked_selectors → repatch.marked_context.marked_css_selectors
  repatch.marked_context.restrict_scope_css_to_marks → repatch.css.split_css_rules

Code Analysis (`project/analysis.toon.yaml`)

# code2llm | 23f 8259L | python:14,yaml:4,json:1,txt:1,shell:1,javascript:1,toml:1 | 2026-06-01
# generated in 0.01s
# CC̅=5.2 | critical:7/184 | dups:0 | cycles:0

HEALTH[7]:
  🟡 CC    _bind_annotations_to_html CC=29 (limit:15)
  🟡 CC    inject_scope_style CC=27 (limit:15)
  🟡 CC    resolve_marked_selectors CC=16 (limit:15)
  🟡 CC    _find_marked_subtrees CC=17 (limit:15)
  🟡 CC    apply_ui_patch_options CC=25 (limit:15)
  🟡 CC    organize_html CC=24 (limit:15)
  🟡 CC    build_http_llm_context CC=29 (limit:15)

REFACTOR[1]:
  1. split 7 high-CC methods  (CC>15)

PIPELINES[58]:
  [1] Src [__init__]: __init__
      PURITY: 100% pure
  [2] Src [handle_starttag]: handle_starttag
      PURITY: 100% pure
  [3] Src [_classify_node]: _classify_node → _clean_text
      PURITY: 100% pure
  [4] Src [handle_endtag]: handle_endtag → _clean_text
      PURITY: 100% pure
  [5] Src [handle_data]: handle_data → _clean_text
      PURITY: 100% pure
  [6] Src [ui_type_for_kind]: ui_type_for_kind
      PURITY: 100% pure
  [7] Src [should_block_full_html_iterate]: should_block_full_html_iterate → has_ui_marks
      PURITY: 100% pure
  [8] Src [inject_scope_style]: inject_scope_style → _bind_annotations_to_html → _parse_attrs → _normalize_label_text
      PURITY: 100% pure
  [9] Src [build_function_patch_context]: build_function_patch_context → build_project_ir
      PURITY: 100% pure
  [10] Src [_default_prepare_html]: _default_prepare_html
      PURITY: 100% pure
  [11] Src [build_function_option_patches]: build_function_option_patches → _strip_existing_patch
      PURITY: 100% pure
  [12] Src [resolve_marked_llm_context]: resolve_marked_llm_context → build_marked_element_context → _assemble_marked_subtrees → _find_marked_subtrees → ...(2 more)
      PURITY: 100% pure
  [13] Src [supports_llm_patch_scope]: supports_llm_patch_scope → normalize_focus_scope → default_scope_for_kind → allowed_scope_ids
      PURITY: 100% pure
  [14] Src [build_ui_patch_prompt]: build_ui_patch_prompt → normalize_focus_scope → default_scope_for_kind → allowed_scope_ids
      PURITY: 100% pure
  [15] Src [parse_ui_patch_response]: parse_ui_patch_response → _strip_json_fence
      PURITY: 100% pure
  [16] Src [apply_ui_patch_options]: apply_ui_patch_options → strip_scope_style
      PURITY: 100% pure
  [17] Src [html_files_distinct]: html_files_distinct → normalize_html_body
      PURITY: 100% pure
  [18] Src [sync_option_previews_from_workspace]: sync_option_previews_from_workspace → apply_spatial_deletes_to_html → _delete_match_keys
      PURITY: 100% pure
  [19] Src [enforce_deletes_on_option_previews]: enforce_deletes_on_option_previews → apply_spatial_deletes_to_html → _delete_match_keys
      PURITY: 100% pure
  [20] Src [generate_patch_suggestions]: generate_patch_suggestions
      PURITY: 100% pure
  [21] Src [_normalize_scopes]: _normalize_scopes
      PURITY: 100% pure
  [22] Src [_build_user_prompt]: _build_user_prompt
      PURITY: 100% pure
  [23] Src [_parse_choice]: _parse_choice
      PURITY: 100% pure
  [24] Src [_choice_content]: _choice_content
      PURITY: 100% pure
  [25] Src [_default_completion]: _default_completion
      PURITY: 100% pure
  [26] Src [connect]: connect → _connectSSE → apply → cb
      PURITY: 100% pure
  [27] Src [payload]: payload → apply → cb
      PURITY: 100% pure
  [28] Src [onPatch]: onPatch
      PURITY: 100% pure
  [29] Src [dslClean]: dslClean
      PURITY: 100% pure
  [30] Src [addMatch]: addMatch
      PURITY: 100% pure
  [31] Src [replaceMatch]: replaceMatch
      PURITY: 100% pure
  [32] Src [styleMatch]: styleMatch
      PURITY: 100% pure
  [33] Src [removeMatch]: removeMatch → cb
      PURITY: 100% pure
  [34] Src [html]: html
      PURITY: 100% pure
  [35] Src [target]: target
      PURITY: 100% pure
  [36] Src [css]: css
      PURITY: 100% pure
  [37] Src [styleEl]: styleEl
      PURITY: 100% pure
  [38] Src [sendPatchRequest]: sendPatchRequest
      PURITY: 100% pure
  [39] Src [on_patch]: on_patch
      PURITY: 100% pure
  [40] Src [start]: start
      PURITY: 100% pure
  [41] Src [_run_event_loop]: _run_event_loop
      PURITY: 100% pure
  [42] Src [_connect_and_listen]: _connect_and_listen
      PURITY: 100% pure
  [43] Src [_trigger_listeners]: _trigger_listeners → cb
      PURITY: 100% pure
  [44] Src [send_patch]: send_patch
      PURITY: 100% pure
  [45] Src [organize_html_project_dir]: organize_html_project_dir → organize_html → _extract_inline_styles
      PURITY: 100% pure
  [46] Src [organize_html_project]: organize_html_project → organize_html → _extract_inline_styles
      PURITY: 100% pure
  [47] Src [organize_result_manifest]: organize_result_manifest
      PURITY: 100% pure
  [48] Src [extract_visual_css]: extract_visual_css → extract_inline_css
      PURITY: 100% pure
  [49] Src [__init__]: __init__
      PURITY: 100% pure
  [50] Src [_keep_attr]: _keep_attr
      PURITY: 100% pure

LAYERS:
  repatch/                        CC̄=5.6    ←in:0  →out:0
  │ !! marked_context             696L  0C   32m  CC=17     ←3
  │ !! scope                      647L  0C   22m  CC=29     ←2
  │ !! web_preprocess             459L  1C   21m  CC=29     ←1
  │ web_fetch                  370L  2C   15m  CC=7      ←0
  │ dom_patch                  315L  0C   19m  CC=12     ←0
  │ !! organize_html              287L  1C   12m  CC=24     ←0
  │ !! ui_patch                   267L  0C   10m  CC=25     ←0
  │ options                    140L  0C    5m  CC=10     ←0
  │ __init__                   139L  0C    0m  CC=0.0    ←0
  │ project_ir                 132L  1C    8m  CC=12     ←1
  │ spatial                    108L  0C    4m  CC=6      ←1
  │ service                    105L  2C    7m  CC=6      ←0
  │ css                         70L  0C    4m  CC=14     ←3
  │
  sdks/                           CC̄=2.7    ←in:0  →out:0
  │ repatch-sdk.js             186L  1C   18m  CC=12     ←1
  │ repatch_sdk                 73L  1C    7m  CC=7      ←0
  │
  ./                              CC̄=0.0    ←in:0  →out:0
  │ !! deps.json                 3394L  0C    0m  CC=0.0    ←0
  │ !! goal.yaml                  511L  0C    0m  CC=0.0    ←0
  │ wup.yaml                   134L  0C    0m  CC=0.0    ←0
  │ tree.txt                    90L  0C    0m  CC=0.0    ←0
  │ pyproject.toml              56L  0C    0m  CC=0.0    ←0
  │ project.sh                  50L  0C    0m  CC=0.0    ←0
  │
  testql-scenarios/               CC̄=0.0    ←in:0  →out:0
  │ generated-cli-tests.testql.toon.yaml    20L  0C    0m  CC=0.0    ←0
  │ generated-from-pytests.testql.toon.yaml    10L  0C    0m  CC=0.0    ←0
  │

COUPLING:
                   sdks.js  sdks.python
      sdks.js           ──           ←1
  sdks.python            1           ──
  CYCLES: none

EXTERNAL:
  validation: run `vallm batch .` → validation.toon
  duplication: run `redup scan .` → duplication.toon

Duplication (`project/duplication.toon.yaml`)

# redup/duplication | 1 groups | 13f 3735L | 2026-06-01

SUMMARY:
  files_scanned: 13
  total_lines:   3735
  dup_groups:    1
  dup_fragments: 2
  saved_lines:   12
  scan_ms:       4131

HOTSPOTS[1] (files with most duplication):
  repatch/marked_context.py  dup=24L  groups=1  frags=2  (0.6%)

DUPLICATES[1] (ranked by impact):
  [1576f29b2f19a9f4]   STRU  marked_scope_display_css  L=12 N=2 saved=12 sim=1.00
      repatch/marked_context.py:216-227  (marked_scope_display_css)
      repatch/marked_context.py:230-241  (marked_scope_shapes_css)

REFACTOR[1] (ranked by priority):
  [1] ○ extract_function   → repatch/utils/marked_scope_display_css.py
      WHY: 2 occurrences of 12-line block across 1 files — saves 12 lines
      FILES: repatch/marked_context.py

QUICK_WINS[1] (low risk, high savings — do first):
  [1] extract_function   saved=12L  → repatch/utils/marked_scope_display_css.py
      FILES: marked_context.py

EFFORT_ESTIMATE (total ≈ 0.4h):
  easy   marked_scope_display_css            saved=12L  ~24min

METRICS-TARGET:
  dup_groups:  1 → 0
  saved_lines: 12 lines recoverable

Evolution / Churn (`project/evolution.toon.yaml`)

# code2llm/evolution | 184 func | 14f | 2026-06-01
# generated in 0.00s

NEXT[10] (ranked by impact):
  [1] !! SPLIT           repatch/scope.py
      WHY: 647L, 0 classes, max CC=29
      EFFORT: ~4h  IMPACT: 18763

  [2] !! SPLIT           repatch/marked_context.py
      WHY: 696L, 0 classes, max CC=17
      EFFORT: ~4h  IMPACT: 11832

  [3] !! SPLIT-FUNC      _bind_annotations_to_html  CC=29  fan=21
      WHY: CC=29 exceeds 15
      EFFORT: ~1h  IMPACT: 609

  [4] !! SPLIT-FUNC      inject_scope_style  CC=27  fan=20
      WHY: CC=27 exceeds 15
      EFFORT: ~1h  IMPACT: 540

  [5] !  SPLIT-FUNC      organize_html  CC=24  fan=22
      WHY: CC=24 exceeds 15
      EFFORT: ~1h  IMPACT: 528

  [6] !! SPLIT-FUNC      apply_ui_patch_options  CC=25  fan=21
      WHY: CC=25 exceeds 15
      EFFORT: ~1h  IMPACT: 525

  [7] !! SPLIT-FUNC      build_http_llm_context  CC=29  fan=11
      WHY: CC=29 exceeds 15
      EFFORT: ~1h  IMPACT: 319

  [8] !  SPLIT-FUNC      resolve_marked_selectors  CC=16  fan=15
      WHY: CC=16 exceeds 15
      EFFORT: ~1h  IMPACT: 240

  [9] !  SPLIT-FUNC      _find_marked_subtrees  CC=17  fan=13
      WHY: CC=17 exceeds 15
      EFFORT: ~1h  IMPACT: 221

  [10] !! SPLIT           deps.json
      WHY: 3394L, 0 classes, max CC=0
      EFFORT: ~4h  IMPACT: 0


RISKS[3]:
  ⚠ Splitting deps.json may break 0 import paths
  ⚠ Splitting repatch/marked_context.py may break 32 import paths
  ⚠ Splitting repatch/scope.py may break 22 import paths

METRICS-TARGET:
  CC̄:          5.2 → ≤3.6
  max-CC:      29 → ≤14
  god-modules: 4 → 0
  high-CC(≥15): 7 → ≤3
  hub-types:   0 → ≤0

PATTERNS (language parser shared logic):
  _extract_declarations() in base.py — unified extraction for:
    - TypeScript: interfaces, types, classes, functions, arrow funcs
    - PHP: namespaces, traits, classes, functions, includes
    - Ruby: modules, classes, methods, requires
    - C++: classes, structs, functions, #includes
    - C#: classes, interfaces, methods, usings
    - Java: classes, interfaces, methods, imports
    - Go: packages, functions, structs
    - Rust: modules, functions, traits, use statements

  Shared regex patterns per language:
    - import: language-specific import/require/using patterns
    - class: class/struct/trait declarations with inheritance
    - function: function/method signatures with visibility
    - brace_tracking: for C-family languages ({ })
    - end_keyword_tracking: for Ruby (module/class/def...end)

  Benefits:
    - Consistent extraction logic across all languages
    - Reduced code duplication (~70% reduction in parser LOC)
    - Easier maintenance: fix once, apply everywhere
    - Standardized FunctionInfo/ClassInfo models

HISTORY:
  prev CC̄=5.2 → now CC̄=5.2

Intent

Scope-based HTML/CSS/DOM patch utilities and LLM patch helpers

Navigation Menu

Uh oh!

repatch

Contents

Metadata

Architecture

DOQL Application Declaration (`app.doql.less`)

Source Modules

Dependencies

Runtime

Development

Source Map

`repatch.marked_context` (`repatch/marked_context.py`)

`repatch.scope` (`repatch/scope.py`)

`repatch.web_preprocess` (`repatch/web_preprocess.py`)

`repatch.dom_patch` (`repatch/dom_patch.py`)

`repatch.web_fetch` (`repatch/web_fetch.py`)

Call Graph

Hubs (by degree)

Test Contracts

Cli (1)

Integration (1)

Refactoring Analysis

Call Graph & Complexity (`project/calls.toon.yaml`)

Code Analysis (`project/analysis.toon.yaml`)

Duplication (`project/duplication.toon.yaml`)

Evolution / Churn (`project/evolution.toon.yaml`)

Intent

Uh oh!

FilesExpand file tree

SUMR.md

Latest commit

History

SUMR.md

File metadata and controls

repatch

Contents

Metadata

Architecture

DOQL Application Declaration (app.doql.less)

Source Modules

Dependencies

Runtime

Development

Source Map

repatch.marked_context (repatch/marked_context.py)

repatch.scope (repatch/scope.py)

repatch.web_preprocess (repatch/web_preprocess.py)

repatch.dom_patch (repatch/dom_patch.py)

repatch.web_fetch (repatch/web_fetch.py)

Call Graph

Hubs (by degree)

Test Contracts

Cli (1)

Integration (1)

Refactoring Analysis

Call Graph & Complexity (project/calls.toon.yaml)

Code Analysis (project/analysis.toon.yaml)

Duplication (project/duplication.toon.yaml)

Evolution / Churn (project/evolution.toon.yaml)

Intent

DOQL Application Declaration (`app.doql.less`)

`repatch.marked_context` (`repatch/marked_context.py`)

`repatch.scope` (`repatch/scope.py`)

`repatch.web_preprocess` (`repatch/web_preprocess.py`)

`repatch.dom_patch` (`repatch/dom_patch.py`)

`repatch.web_fetch` (`repatch/web_fetch.py`)

Call Graph & Complexity (`project/calls.toon.yaml`)

Code Analysis (`project/analysis.toon.yaml`)

Duplication (`project/duplication.toon.yaml`)

Evolution / Churn (`project/evolution.toon.yaml`)