Repository navigation
Agent API
Depends on: readmenator/_app.py, readmenator/_config.py, readmenator/_mcp_server.py
Imported by: readmenator.py
-
build_parser(function)readmenator/__main__.py:18def build_parser() -
main(function)readmenator/__main__.py:150def main()
Imported by: readmenator/_pipeline.py, tests/test_agent_injector.py, tests/test_agent_output.py
-
ensure_readmenator_installed(function)readmenator/_agent_injector.py:107def ensure_readmenator_installed()-- Check if readmenator is installed via pip; install it if missing. -
AgentInjector.__init__(method)readmenator/_agent_injector.py:140def __init__(self, kb_filename, agent_output_dir, agent_files, agent_globs, wiki_output_dir) -
AgentInjector.inject(method)readmenator/_agent_injector.py:154def inject(self, project_root)-- Inject KB reference into all discovered agent files. -
AgentInjector.remove(method)readmenator/_agent_injector.py:172def remove(self, project_root)-- Remove KB injection from all discovered agent files. -
AgentInjector.find_agent_files(method)readmenator/_agent_injector.py:185def find_agent_files(self, project_root)-- Public accessor: return all detected agent files.
Depends on: readmenator/_cache.py, readmenator/_config.py, readmenator/_gitmeta.py, readmenator/_models.py, readmenator/_purpose.py, readmenator/_resolver.py, readmenator/_security.py
Imported by: readmenator/_pipeline.py, tests/test_agent_friendliness.py, tests/test_agent_output.py
-
AgentOutputGenerator.__init__(method)readmenator/_agent_output.py:77def __init__(self, config)-- Store configuration for output paths and size budgets. -
AgentOutputGenerator.generate(method)readmenator/_agent_output.py:81def generate(self, nodes, edges, resolved_edges, analysis, analysis_v2, findings, layers, project_root)-- Write all agent output files and return the output directory path. -
keep(function)readmenator/_agent_output.py:525def keep(file_id)-- Return whether a file belongs in the gotcha lists.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/_documentation.py, readmenator/_explorer.py, readmenator/_exporter.py, readmenator/_pipeline.py, tests/test_interactive_graph.py
-
AnalyticsBuilder.__init__(method)readmenator/_analytics.py:28def __init__(self, config)-- Initialise with application configuration. -
AnalyticsBuilder.build(method)readmenator/_analytics.py:36def build(self, nodes, edges, resolved_edges, analysis, findings, layers, v2, hotspots)-- Build the full analytics payload.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/_graphrag.py, readmenator/_pipeline.py, readmenator/_wiki.py, tests/test_agent_friendliness.py, tests/test_analyzer.py
-
dominant_directory(function)readmenator/_analyzer.py:22def dominant_directory(file_ids)-- Return the most informative directory label for a set of files. -
GraphAnalyzer.__init__(method)readmenator/_analyzer.py:54def __init__(self, config)-- Initialise with application configuration. -
GraphAnalyzer.analyze(method)readmenator/_analyzer.py:62def analyze(self, nodes, edges, resolved_edges)-- Run the full analysis pipeline and return structured results. -
GraphAnalyzer.partition(method)readmenator/_analyzer.py:268def partition(self, ids, adjacency)-- Partition an arbitrary undirected id graph with deterministic Louvain.
Depends on: readmenator/_config.py, readmenator/_docstrings.py, readmenator/_models.py, readmenator/_pytypes.py, readmenator/_symindex.py
Imported by: readmenator/_apidocs_page.py, readmenator/_apidocs_render.py, readmenator/_app.py, readmenator/_flowcharts.py, readmenator/_pipeline.py, tests/test_apidocs.py
-
ApiParam.to_dict(method)readmenator/_apidocs.py:91def to_dict(self)-- Serialise to a plain dict for JSON output. -
ApiEntity.is_documented(method)readmenator/_apidocs.py:156def is_documented(self)-- Return True when any documentation text was found. -
ApiEntity.to_dict(method)readmenator/_apidocs.py:160def to_dict(self)-- Serialise to a plain dict for JSON output. -
DocWarning.to_dict(method)readmenator/_apidocs.py:197def to_dict(self)-- Serialise to a plain dict for JSON output. -
ApiReference.children(method)readmenator/_apidocs.py:221def children(self, uid, kinds)-- Return direct members of uid, optionally filtered by kind, in source order. -
ApiReference.to_dict(method)readmenator/_apidocs.py:232def to_dict(self, schema_version)-- Serialise the whole reference forapi.json. -
_PythonExtractor.__init__(method)readmenator/_apidocs.py:257def __init__(self, file_id, language, include_private)-- Initialise for one file. -
_PythonExtractor.extract(method)readmenator/_apidocs.py:272def extract(self, content)-- Parse content; return False when it is not valid Python. -
parse_signature_params(function)readmenator/_apidocs.py:685def parse_signature_params(signature, name, language)-- Split a non-Python signature into parameters and a return type. -
is_vendored_path(function)readmenator/_apidocs.py:759def is_vendored_path(file_id, config)-- Return True for minified bundles and files under vendored third-party trees. -
ApiReferenceBuilder.__init__(method)readmenator/_apidocs.py:775def __init__(self, config)-- Initialise with application configuration. -
ApiReferenceBuilder.build(method)readmenator/_apidocs.py:796def build(self, nodes, edges, resolved_edges, content_map)-- Build the full API reference. -
innermost(function)readmenator/_apidocs.py:1154def innermost(file_id, line, name)-- Return the narrowest callable in file_id spanning line. -
target_entity(function)readmenator/_apidocs.py:1166def target_entity(file_id, line, name)-- Return the entity defined at line in file_id (or by name). -
counts(function)readmenator/_apidocs.py:1320def counts(items)-- Return documented/total/percent for items.
Depends on: readmenator/_apidocs.py, readmenator/_config.py
Imported by: readmenator/_apidocs_render.py, tests/test_apidocs.py
-
render_api_site(function)readmenator/_apidocs_page.py:55def render_api_site(reference, project_name, config, architecture_markdown)-- Render the standalone HTML API browser.
Depends on: readmenator/_apidocs.py, readmenator/_apidocs_page.py, readmenator/_config.py, readmenator/_docstrings.py
Imported by: readmenator/_pipeline.py, tests/test_apidocs.py
-
module_display_name(function)readmenator/_apidocs_render.py:62def module_display_name(entity)-- Return the Sphinx-style display name of a module entity. -
page_slug(function)readmenator/_apidocs_render.py:73def page_slug(module_uid)-- Return the deterministic page file stem for a module uid. -
anchor_slug(function)readmenator/_apidocs_render.py:79def anchor_slug(qualname)-- Return the HTML anchor id for an entity qualname. -
ApiLinker.__init__(method)readmenator/_apidocs_render.py:101def __init__(self, reference)-- Index every entity by uid, qualname, and simple name. -
ApiLinker.module_of(method)readmenator/_apidocs_render.py:118def module_of(self, entity)-- Return the module entity that contains entity. -
ApiLinker.resolve(method)readmenator/_apidocs_render.py:122def resolve(self, name, context_file)-- Resolve a written reference to an entity, preferring context_file. -
ApiLinker.href(method)readmenator/_apidocs_render.py:159def href(self, entity, from_module)-- Return the relative link to entity from a module page (or index when ""). -
ApiLinker.link(method)readmenator/_apidocs_render.py:168def link(self, entity, from_module, label)-- Return a Markdown link to entity. -
ApiLinker.link_uid(method)readmenator/_apidocs_render.py:173def link_uid(self, uid, from_module)-- Return a Markdown link to the entity with uid (plain code when unknown). -
ApiLinker.autolink(method)readmenator/_apidocs_render.py:180def autolink(self, text, from_module)-- Turn backtick names, Sphinx roles, and{@link}tags into links. -
ApiMarkdownRenderer.__init__(method)readmenator/_apidocs_render.py:219def __init__(self, config)-- Initialise with application configuration. -
ApiMarkdownRenderer.render(method)readmenator/_apidocs_render.py:227def render(self, reference, project_name)-- Render every page. -
walk(function)readmenator/_apidocs_render.py:345def walk(entity, depth)-- Emit entity and its subclasses as a nested list. -
ApiDocsWriter.__init__(method)readmenator/_apidocs_render.py:733def __init__(self, config)-- Initialise with application configuration. -
ApiDocsWriter.write(method)readmenator/_apidocs_render.py:742def write(self, reference, project_root, project_name, architecture_markdown)-- Write every page and prune stale module pages.
Depends on: readmenator/_apidocs.py, readmenator/_bundlegraph.py, readmenator/_cache.py, readmenator/_config.py, readmenator/_cursorrules_generator.py, readmenator/_dead_code.py, readmenator/_diagrams.py, readmenator/_explorer.py, readmenator/_flowcharts.py, readmenator/_gh_wiki.py, readmenator/_gitmeta.py, readmenator/_graphrag.py, readmenator/_layers.py, readmenator/_linter.py, readmenator/_models.py, readmenator/_pipeline.py, readmenator/_query.py, readmenator/_rank.py, readmenator/_refactorizer.py, readmenator/_resolver.py, readmenator/_video.py, readmenator/_watcher.py, readmenator/_yaralite.py
Imported by: readmenator/__init__.py, readmenator/__main__.py, readmenator/_mcp_server.py, tests/test_agent_friendliness.py, tests/test_apidocs.py, tests/test_bundlegraph.py, tests/test_components.py, tests/test_diagrams.py, tests/test_gh_wiki.py, tests/test_integration.py, tests/test_interactive_graph.py, tests/test_mcp_server.py, tests/test_sourceview.py, tests/test_video.py
-
readmenatorApplication.__init__(method)readmenator/_app.py:53def __init__(self, config) -
readmenatorApplication.run(method)readmenator/_app.py:99def run(self, target_dir, resolve_imports, run_analysis, run_security, run_v2_analysis) -
readmenatorApplication.check_freshness(method)readmenator/_app.py:250def check_freshness(self, target_dir)-- Compare the MANIFEST source fingerprint against the current sources. -
readmenatorApplication.publish_github_wiki(method)readmenator/_app.py:313def publish_github_wiki(self, target_dir, dry_run)-- Mirror the generated wiki, agent docs, and knowledge base to the GitHub wiki. -
readmenatorApplication.generate_uml_code(method)readmenator/_app.py:369def generate_uml_code(self, target_dir, language, output_path) -
readmenatorApplication.update(method)readmenator/_app.py:436def update(self, target_dir, run_security) -
readmenatorApplication.query(method)readmenator/_app.py:567def query(self, target_dir, question) -
readmenatorApplication.explain(method)readmenator/_app.py:572def explain(self, target_dir, symbol_name) -
readmenatorApplication.find_path(method)readmenator/_app.py:584def find_path(self, target_dir, symbol_a, symbol_b) -
readmenatorApplication.summary(method)readmenator/_app.py:597def summary(self, target_dir) -
readmenatorApplication.rank_query(method)readmenator/_app.py:602def rank_query(self, target_dir, query, top_n)-- Run a ranked query against the knowledge graph. -
readmenatorApplication.rebuild(method)readmenator/_app.py:632def rebuild(self, target_dir, run_security) -
readmenatorApplication.analyze(method)readmenator/_app.py:635def analyze(self, target_dir) -
readmenatorApplication.export_json(method)readmenator/_app.py:639def export_json(self, target_dir, output_path) -
readmenatorApplication.export_html(method)readmenator/_app.py:656def export_html(self, target_dir, output_path) -
readmenatorApplication.export_svg(method)readmenator/_app.py:667def export_svg(self, target_dir, output_path) -
readmenatorApplication.export(method)readmenator/_app.py:678def export(self, target_dir) -
readmenatorApplication.export_forcegraph(method)readmenator/_app.py:928def export_forcegraph(self, target_dir, output_path)-- Export the force-graph explorer HTML document. -
readmenatorApplication.export_bundlegraph(method)readmenator/_app.py:947def export_bundlegraph(self, target_dir, output_path)-- Export the edge bundle explorer HTML document (circle and sphere views). -
readmenatorApplication.export_components(method)readmenator/_app.py:973def export_components(self, target_dir, output_dir)-- Export component diagrams (analysis.json + graph LR markdown + index.html). -
readmenatorApplication.build_api_reference(method)readmenator/_app.py:1047def build_api_reference(self, target_dir)-- Scan target_dir and build its API reference without writing it. -
readmenatorApplication.export_apidocs(method)readmenator/_app.py:1059def export_apidocs(self, target_dir)-- Generate the API reference tree (Markdown, api.json, index.html). -
readmenatorApplication.explorer_state(method)readmenator/_app.py:1076def explorer_state(self, target_dir)-- Build explorer state for the local HTTP server. -
readmenatorApplication.serve_explorer(method)readmenator/_app.py:1092def serve_explorer(self, target_dir, open_browser)-- Serve the local explorer UI until interrupted. -
readmenatorApplication.analytics(method)readmenator/_app.py:1105def analytics(self, target_dir)-- Compute the corpus analytics payload. -
readmenatorApplication.scan_texts(method)readmenator/_app.py:1122def scan_texts(self, target_dir)-- Build scan-text blobs for every file in the project. -
readmenatorApplication.near(method)readmenator/_app.py:1134def near(self, target_dir, query, top_k)-- Find semantically similar files for a query file or text. -
readmenatorApplication.audit_provenance(method)readmenator/_app.py:1148def audit_provenance(self, target_dir)-- Audit security findings by evidence provenance. -
readmenatorApplication.validate_yaralite(method)readmenator/_app.py:1171def validate_yaralite(self, target_dir)-- Validate the project YARA-lite rules file. -
readmenatorApplication.export_graphml(method)readmenator/_app.py:1185def export_graphml(self, target_dir, output_path) -
readmenatorApplication.export_cypher(method)readmenator/_app.py:1196def export_cypher(self, target_dir, output_path) -
readmenatorApplication.export_obsidian(method)readmenator/_app.py:1212def export_obsidian(self, target_dir, output_dir) -
readmenatorApplication.export_wiki(method)readmenator/_app.py:1227def export_wiki(self, target_dir, output_dir)-- Generate the navigable agent wiki for the target project. -
readmenatorApplication.lint_wiki(method)readmenator/_app.py:1250def lint_wiki(self, target_dir)-- Check wiki health and log reported issues. -
readmenatorApplication.export_diagrams(method)readmenator/_app.py:1268def export_diagrams(self, target_dir, output_dir, full)-- Export all five interactive system maps plus a gallery index. -
readmenatorApplication.export_diagram(method)readmenator/_app.py:1335def export_diagram(self, target_dir, kind, output_path, full)-- Export a single interactive system map as standalone HTML. -
readmenatorApplication.export_pages(method)readmenator/_app.py:1374def export_pages(self, target_dir, output_dir, full)-- Publish all system maps plus a gallery index as a static site. -
readmenatorApplication.export_video(method)readmenator/_app.py:1419def export_video(self, target_dir, output_path)-- Render the cinematic overview video for the target project. -
readmenatorApplication.memory(method)readmenator/_app.py:1646def memory(self, target_dir)-- Return MEMORY.md, generating it first when missing. -
readmenatorApplication.remember(method)readmenator/_app.py:1669def remember(self, target_dir, note, kind)-- Append a note to the preserved MEMORY.md session log. -
readmenatorApplication.install_skills(method)readmenator/_app.py:1683def install_skills(self, target_dir, target)-- Install the packaged agent skills into the project. -
readmenatorApplication.build_graphrag(method)readmenator/_app.py:1695def build_graphrag(self, target_dir)-- Scan, analyse, and write the GraphRAG index for a project. -
readmenatorApplication.graphrag_search(method)readmenator/_app.py:1718def graphrag_search(self, target_dir, query, mode, budget_tokens)-- Answer a question with GraphRAG retrieval over the persisted index. -
readmenatorApplication.watch(method)readmenator/_app.py:1739def watch(self, target_dir) -
on_change(function)readmenator/_app.py:1743def on_change() -
readmenatorApplication.audit(method)readmenator/_app.py:1749def audit(self, target_dir) -
readmenatorApplication.audit_deep(method)readmenator/_app.py:1756def audit_deep(self, target_dir) -
readmenatorApplication.export_sarif(method)readmenator/_app.py:1776def export_sarif(self, target_dir, output_path) -
readmenatorApplication.export_rules(method)readmenator/_app.py:1786def export_rules(self, target_dir, output_dir) -
readmenatorApplication.detect_layers(method)readmenator/_app.py:1796def detect_layers(self, target_dir) -
readmenatorApplication.lint(method)readmenator/_app.py:1806def lint(self, target_dir) -
readmenatorApplication.strip_dead_code(method)readmenator/_app.py:1819def strip_dead_code(self, target_dir) -
readmenatorApplication.generate_cursorrules(method)readmenator/_app.py:1829def generate_cursorrules(self, target_dir) -
readmenatorApplication.refactor_monolith(method)readmenator/_app.py:1844def refactor_monolith(self, target_dir)
Depends on: readmenator/_bundlegraph_page.py, readmenator/_config.py, readmenator/_forcegraph.py, readmenator/_graphlayout.py
Imported by: readmenator/_app.py, readmenator/_pipeline.py, tests/test_bundlegraph.py, tests/test_layout_quality.py, tests/test_sourceview.py
-
BundleGraphRenderer.__init__(method)readmenator/_bundlegraph.py:51def __init__(self, config)-- Initialise with application configuration. -
BundleGraphRenderer.build_payload(method)readmenator/_bundlegraph.py:60def build_payload(self, force_payload)-- Derive the bundle payload from a force-graph payload. -
BundleGraphRenderer.page_settings(method)readmenator/_bundlegraph.py:181def page_settings(self, force_payload, explorer_href, live_api)-- Collect the page settings serialized into the HTML. -
BundleGraphRenderer.render(method)readmenator/_bundlegraph.py:225def render(self, force_payload, title, home_href, explorer_href, live_api)-- Render the standalone edge bundle explorer HTML document. -
BundleGraphRenderer.write(method)readmenator/_bundlegraph.py:263def write(self, output_path, force_payload, title, home_href, explorer_href)-- Write the edge bundle explorer HTML document. -
BundleGraphRenderer.thumbnail_svg(method)readmenator/_bundlegraph.py:289def thumbnail_svg(self, force_payload)-- Render a small circular bundle preview as inline SVG.
Depends on: readmenator/_config.py
Imported by: readmenator/_agent_output.py, readmenator/_app.py, readmenator/_components.py, tests/test_agent_friendliness.py, tests/test_cache.py
-
FileCache.__init__(method)readmenator/_cache.py:31def __init__(self, config, project_root) -
FileCache.load(method)readmenator/_cache.py:38def load(self) -
FileCache.save(method)readmenator/_cache.py:49def save(self, hashes) -
FileCache.compute_hash(method)readmenator/_cache.py:55def compute_hash(self, file_path) -
FileCache.compute_hashes(method)readmenator/_cache.py:64def compute_hashes(self, file_paths) -
FileCache.find_changed(method)readmenator/_cache.py:72def find_changed(self, file_paths) -
FileCache.prune_deleted(method)readmenator/_cache.py:84def prune_deleted(self, current_file_ids) -
FileCache.save_analysis(method)readmenator/_cache.py:95def save_analysis(self, key, data)-- Save an analysis result to the semantic cache. -
FileCache.load_analysis(method)readmenator/_cache.py:118def load_analysis(self, key)-- Load a previously cached analysis result. -
FileCache.clear_analysis(method)readmenator/_cache.py:135def clear_analysis(self, key)-- Clear analysis cache, optionally for a specific key only. -
FileCache.has_changed_since_last_analysis(method)readmenator/_cache.py:166def has_changed_since_last_analysis(self, file_paths)-- Check if any file has changed since the last analysis cache. -
source_fingerprint(function)readmenator/_cache.py:179def source_fingerprint(project_root, file_ids)-- Return one SHA256 over the sorted paths and contents of scanned sources.
Imported by: readmenator/__init__.py, readmenator/_explain.py, readmenator/_graphrag.py, readmenator/_models.py, readmenator/_pipeline.py, readmenator/_projections.py, readmenator/_query.py, readmenator/_rank.py, tests/test_ranking.py
-
Morphism.weight(method)readmenator/_category.py:73def weight(self)-- Effective weight for ranking = semantic weight * confidence. -
Category.__init__(method)readmenator/_category.py:86def __init__(self) -
Category.add_object(method)readmenator/_category.py:92def add_object(self, obj_id) -
Category.add_morphism(method)readmenator/_category.py:95def add_morphism(self, m) -
Category.objects(method)readmenator/_category.py:103def objects(self) -
Category.morphisms(method)readmenator/_category.py:107def morphisms(self) -
Category.outgoing(method)readmenator/_category.py:110def outgoing(self, obj_id) -
Category.incoming(method)readmenator/_category.py:113def incoming(self, obj_id) -
Category.compose(method)readmenator/_category.py:116def compose(self, a, b)-- Compose two morphisms if target of a matches source of b. -
Category.paths(method)readmenator/_category.py:133def paths(self, source, target, max_depth)-- Find all composition paths from source to target up to max_depth. -
dfs(function)readmenator/_category.py:139def dfs(current, goal, path, depth) -
TypedGraph.__init__(method)readmenator/_category.py:188def __init__(self, category) -
TypedGraph.nodes(method)readmenator/_category.py:203def nodes(self) -
TypedGraph.size(method)readmenator/_category.py:207def size(self) -
TypedGraph.node_index(method)readmenator/_category.py:210def node_index(self, node_id) -
TypedGraph.transition_weight(method)readmenator/_category.py:213def transition_weight(self, source, target)-- Sum of weights of all morphisms from source to target. -
TypedGraph.stochastic_row(method)readmenator/_category.py:221def stochastic_row(self, source)-- Return dict of target -> probability for the row of source. -
build_category_from_edges(function)readmenator/_category.py:236def build_category_from_edges(edges, resolved_edges, node_ids)-- Build a Category from lists of Edge objects.
Depends on: readmenator/_cache.py, readmenator/_config.py, readmenator/_layers.py, readmenator/_models.py, readmenator/_ollama.py, readmenator/_purpose.py, readmenator/_rank.py, readmenator/_symindex.py
Imported by: readmenator/__init__.py, readmenator/_pipeline.py, tests/test_components.py
-
sanitize(function)readmenator/_components.py:45def sanitize(name)-- Replace non-alphanumerics with underscores for Mermaid node ids. -
ComponentDiagramBuilder.__init__(method)readmenator/_components.py:60def __init__(self, config)-- Initialise with application configuration. -
ComponentDiagramBuilder.build(method)readmenator/_components.py:70def build(self, nodes, edges, resolved_edges, analysis, project_root, content_map)-- Build the full analysis document. -
ComponentDiagramBuilder.mermaid_lr(method)readmenator/_components.py:165def mermaid_lr(self, components, relations, docs_ref)-- Render thegraph LRoverview diagram. -
ComponentDiagramBuilder.overview_markdown(method)readmenator/_components.py:199def overview_markdown(self, analysis, docs_ref, rel_prefix)-- Render the overview page (diagram plus component details). -
ComponentDiagramBuilder.component_markdown(method)readmenator/_components.py:247def component_markdown(self, component)-- Render one expandable component's detail page. -
ComponentDiagramBuilder.write(method)readmenator/_components.py:275def write(self, analysis, output_dir, project_root)-- Write analysis.json, the overview, component pages, and index.html. -
ComponentDiagramBuilder.render_page(method)readmenator/_components.py:611def render_page(self, analysis, title, home_href, rel_prefix, link_files)-- Render the standalone interactive diagram page. -
ComponentDiagramBuilder.thumbnail_svg(method)readmenator/_components.py:738def thumbnail_svg(self, components, relations)-- Render a small dagre-style preview as inline SVG.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/__init__.py, readmenator/_pipeline.py, tests/test_concepts.py
-
verb_for_relation(function)readmenator/_concepts.py:33def verb_for_relation(relation)-- Return the verb label for a structural edge relation. -
ConceptExtractor.__init__(method)readmenator/_concepts.py:41def __init__(self, config)-- Store configuration for concept extraction budgets. -
ConceptExtractor.extract(method)readmenator/_concepts.py:47def extract(self, nodes, edges, resolved_edges)-- Build concepts and verb relations from structural topology.
Depends on: readmenator/_models.py
Imported by: readmenator/_documentation.py, readmenator/_pipeline.py, tests/test_cpg.py
-
CodePropertyGraph.__init__(method)readmenator/_cpg.py:26def __init__(self, privacy_mode, cpg_context) -
CodePropertyGraph.generate(method)readmenator/_cpg.py:30def generate(self, nodes, edges, resolved_edges, analysis, findings)-- Generate the CPG JSON-LD string embeddable in markdown.
Depends on: readmenator/_config.py, readmenator/_layers.py, readmenator/_models.py
Imported by: readmenator/_app.py, tests/test_cursorrules.py
-
CursorRulesGenerator.__init__(method)readmenator/_cursorrules_generator.py:25def __init__(self, config) -
CursorRulesGenerator.generate(method)readmenator/_cursorrules_generator.py:28def generate(self, nodes, edges, analysis, layers, violations, project_root)-- Generate the .cursorrules content string.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/_pipeline.py, tests/test_dataflow.py
-
DataflowAnalyzer.__init__(method)readmenator/_dataflow.py:125def __init__(self, config)-- Store configuration for enable flag and issue caps. -
DataflowAnalyzer.analyze(method)readmenator/_dataflow.py:129def analyze(self, nodes, content_map)-- Check every function body span and return capped issues.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/_app.py, tests/test_dead_code.py
-
DeadCodeStripper.__init__(method)readmenator/_dead_code.py:25def __init__(self, config) -
DeadCodeStripper.identify(method)readmenator/_dead_code.py:28def identify(self, nodes, edges, resolved_edges)-- Identify dead code symbols with zero in-degree.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/__init__.py, readmenator/_app.py, readmenator/_pipeline.py, tests/test_agent_friendliness.py, tests/test_components.py, tests/test_diagrams.py, tests/test_interactive_graph.py
-
SystemMapValidator.__init__(method)readmenator/_diagrams.py:233def __init__(self, config)-- Initialise the validator with application configuration. -
SystemMapValidator.validate(method)readmenator/_diagrams.py:262def validate(self, system_map)-- Validate a system map and return a deterministic receipt. -
SystemMapBuilder.__init__(method)readmenator/_diagrams.py:483def __init__(self, config)-- Initialise the builder with application configuration. -
SystemMapBuilder.supported_kinds(method)readmenator/_diagrams.py:492def supported_kinds(self)-- Return the supported diagram kind identifiers. -
SystemMapBuilder.build(method)readmenator/_diagrams.py:513def build(self, nodes, edges, resolved_edges, layers, findings, analysis, kind, full)-- Build one deterministic system map of the requested kind. -
SystemMapBuilder.build_all(method)readmenator/_diagrams.py:572def build_all(self, nodes, edges, resolved_edges, layers, findings, analysis, full)-- Build all five diagram kinds deterministically. -
SystemMapBuilder.compare(method)readmenator/_diagrams.py:603def compare(self, base, head)-- Compare two maps of the same kind as before, delta, and after. -
InteractiveMapRenderer.__init__(method)readmenator/_diagrams.py:1523def __init__(self, config)-- Initialise the renderer with application configuration. -
InteractiveMapRenderer.render(method)readmenator/_diagrams.py:1552def render(self, system_map)-- Render a system map as a self-contained HTML document. -
InteractiveMapRenderer.write(method)readmenator/_diagrams.py:1643def write(self, system_map, output_path)-- Render a system map and write it to a relative output path. -
VisNetworkRenderer.__init__(method)readmenator/_diagrams.py:2234def __init__(self, config)-- Initialise the renderer with application configuration. -
VisNetworkRenderer.render(method)readmenator/_diagrams.py:2242def render(self, system_map)-- Render a system map as a vis.js network HTML document. -
VisNetworkRenderer.write(method)readmenator/_diagrams.py:2364def write(self, system_map, output_path)-- Render a vis.js map and write it to a relative output path. -
DocsSitePublisher.__init__(method)readmenator/_diagrams.py:3224def __init__(self, config)-- Initialise the publisher with application configuration. -
DocsSitePublisher.description_for(method)readmenator/_diagrams.py:3234def description_for(self, kind)-- Return the gallery description for a diagram kind. -
DocsSitePublisher.publish(method)readmenator/_diagrams.py:3248def publish(self, maps, project_name, output_dir, stats, renderer, project_root, video_rel, doc_entries, extra_cards)-- Publish maps and a gallery index into a documentation directory. -
DocsSitePublisher.collect_doc_sources(method)readmenator/_diagrams.py:3342def collect_doc_sources(self, project_root)-- Collect generated markdown sources for the static site. -
DocsSitePublisher.publish_assets(method)readmenator/_diagrams.py:3368def publish_assets(self, project_root, output_dir)-- Copy overview video and markdown docs into the static site. -
DocsSitePublisher.render_llms_txt(method)readmenator/_diagrams.py:3537def render_llms_txt(self, project_name, maps, stats, href_prefix, doc_entries)-- Render an llms.txt entry point so agents can navigate the site as text. -
order(function)readmenator/_diagrams.py:3588def order(entry)-- Sort entry points first, then alphabetically. -
DocsSitePublisher.render_index(method)readmenator/_diagrams.py:3616def render_index(self, project_name, maps, stats, href_prefix, video_rel, doc_entries, poster_rel, extra_cards)-- Render the gallery index page for published maps. -
doc_order(function)readmenator/_diagrams.py:3851def doc_order(base)-- Entry points first, then alphabetical.
Imported by: readmenator/_apidocs.py, readmenator/_apidocs_render.py, tests/test_apidocs.py
-
DocField.to_dict(method)readmenator/_docstrings.py:150def to_dict(self)-- Serialise to a plain dict for JSON output. -
DocComment.is_empty(method)readmenator/_docstrings.py:195def is_empty(self)-- Return True when no documentation text was recovered. -
DocComment.param(method)readmenator/_docstrings.py:203def param(self, name)-- Return the documented parameter called name (stars ignored). -
DocComment.to_dict(method)readmenator/_docstrings.py:211def to_dict(self)-- Serialise to a plain dict for JSON output. -
clean_text(function)readmenator/_docstrings.py:230def clean_text(text)-- Dedent text likeinspect.cleandocand strip blank edges. -
detect_style(function)readmenator/_docstrings.py:254def detect_style(text)-- Classify the docstring convention used by text. -
split_summary(function)readmenator/_docstrings.py:293def split_summary(text)-- Split free text into a one-sentence summary and the remainder. -
flush(function)readmenator/_docstrings.py:413def flush()-- Finalise the item under construction. -
grab(function)readmenator/_docstrings.py:782def grab(tag)-- Return the inner text of the first tag element. -
parse_docstring(function)readmenator/_docstrings.py:809def parse_docstring(text)-- Parse text in any supported convention into a DocComment. -
recover_comment(function)readmenator/_docstrings.py:910def recover_comment(content_lines, line, language, lookback)-- Recover the raw documentation comment directly above a declaration.
Depends on: readmenator/_analytics.py, readmenator/_config.py, readmenator/_cpg.py, readmenator/_flowcharts.py, readmenator/_forcegraph.py, readmenator/_mermaid.py, readmenator/_models.py, readmenator/_rank.py, readmenator/_uml.py
Imported by: readmenator/_pipeline.py, tests/test_documentation.py, tests/test_flowcharts.py
-
DocumentationGenerator.__init__(method)readmenator/_documentation.py:48def __init__(self, config) -
DocumentationGenerator.generate(method)readmenator/_documentation.py:96def generate(self, nodes, edges, resolved_edges, analysis, layers, findings, analysis_v2, ranked, content_map)-- Render KNOWLEDGE_BASE.md.
Depends on: readmenator/_config.py
Imported by: readmenator/_pipeline.py, tests/test_interactive_graph.py
-
Embedder.__init__(method)readmenator/_embed.py:42def __init__(self, config)-- Initialise with application configuration. -
Embedder.dependencies_available(method)readmenator/_embed.py:50def dependencies_available(self)-- Return True when sentence-transformers is importable. -
Embedder.encode(method)readmenator/_embed.py:58def encode(self, texts)-- Encode texts into L2-normalized vectors when available. -
Embedder.near_jaccard(method)readmenator/_embed.py:75def near_jaccard(self, query, corpus, top_k)-- Find nearest neighbors with offline Jaccard similarity. -
Embedder.cluster_jaccard(method)readmenator/_embed.py:99def cluster_jaccard(self, corpus, threshold)-- Group files into similarity clusters with union-find. -
find(function)readmenator/_embed.py:115def find(item)-- Find the union-find root for an item. -
union(function)readmenator/_embed.py:122def union(left, right)-- Merge two union-find sets. -
Embedder.project_jaccard(method)readmenator/_embed.py:138def project_jaccard(self, corpus)-- Project files to 2D with a deterministic radial layout.
Depends on: readmenator/_config.py
Imported by: readmenator/_pipeline.py, tests/test_interactive_graph.py
-
ExclusionEntry.matches(method)readmenator/_exclusions.py:27def matches(self, file_path, rule_id)-- Return True when this entry suppresses the finding. -
ExclusionList.__init__(method)readmenator/_exclusions.py:47def __init__(self, config)-- Initialise with application configuration. -
ExclusionList.entries(method)readmenator/_exclusions.py:58def entries(self)-- Return the loaded exclusion entries. -
ExclusionList.load(method)readmenator/_exclusions.py:62def load(self, project_root)-- Load exclusions from the project blocklist file. -
ExclusionList.is_excluded(method)readmenator/_exclusions.py:86def is_excluded(self, file_path, rule_id)-- Return True when a finding is suppressed by the blocklist. -
ExclusionList.filter_findings(method)readmenator/_exclusions.py:98def filter_findings(self, findings)-- Remove excluded findings from a finding list. -
parse_exclusions(function)readmenator/_exclusions.py:114def parse_exclusions(text)-- Parse the minimal exclusions YAML into entries.
Depends on: readmenator/_category.py, readmenator/_rank.py
Imported by: tests/test_ranking.py
-
explain_rank(function)readmenator/_explain.py:16def explain_rank(node_id, ranked, category)-- Return a detailed breakdown of why node_id has its rank. -
rank_summary(function)readmenator/_explain.py:140def rank_summary(ranked, top_n)-- Return a short summary of the top-N ranked results.
Depends on: readmenator/_analytics.py, readmenator/_config.py, readmenator/_forcegraph.py, readmenator/_models.py, readmenator/_sourceview.py
Imported by: readmenator/_app.py, tests/test_interactive_graph.py
-
ExplorerState.__init__(method)readmenator/_explorer.py:26def __init__(self, config, nodes, edges, resolved_edges, analysis, findings, layers, content_map)-- Initialise explorer state and precompute payloads. -
ExplorerState.samples(method)readmenator/_explorer.py:64def samples(self)-- Return a compact per-file sample listing. -
ExplorerState.source(method)readmenator/_explorer.py:80def source(self, file_id)-- Return the bounded source text for one file. -
_Handler.log_message(method)readmenator/_explorer.py:108def log_message(self, fmt)-- Silence the default access log. -
_Handler.do_GET(method)readmenator/_explorer.py:112def do_GET(self)-- Dispatch GET routes for HTML and JSON APIs. -
find_free_port(function)readmenator/_explorer.py:169def find_free_port(preferred)-- Find a free TCP port, preferring the configured value. -
serve(function)readmenator/_explorer.py:188def serve(state, host, port, open_browser)-- Serve the explorer state until interrupted. -
build_state(function)readmenator/_explorer.py:221def build_state(config, nodes, edges, resolved_edges, analysis, findings, layers, content_map)-- Build explorer state without starting the server. -
write_static(function)readmenator/_explorer.py:249def write_static(state, output_dir, filename)-- Write the explorer HTML to a static file.
Depends on: readmenator/_analytics.py, readmenator/_config.py, readmenator/_forcegraph.py, readmenator/_models.py
Imported by: readmenator/_pipeline.py, tests/test_exporter.py, tests/test_interactive_graph.py
-
GraphExporter.__init__(method)readmenator/_exporter.py:36def __init__(self, config)-- Initialise with application configuration. -
GraphExporter.to_json(method)readmenator/_exporter.py:44def to_json(self, nodes, edges, resolved_edges, analysis, findings, concept_graph)-- Export the graph as a node-link JSON string. -
GraphExporter.to_html(method)readmenator/_exporter.py:183def to_html(self, nodes, edges, resolved_edges, analysis, findings)-- Generate a standalone interactive HTML graph page. -
GraphExporter.to_svg(method)readmenator/_exporter.py:482def to_svg(self, nodes, edges, resolved_edges, analysis)-- Generate a static SVG representation of the graph. -
GraphExporter.to_graphml(method)readmenator/_exporter.py:696def to_graphml(self, nodes, edges, resolved_edges, analysis)-- Export the graph as GraphML (Gephi/yEd compatible). -
GraphExporter.to_cypher(method)readmenator/_exporter.py:773def to_cypher(self, nodes, edges, resolved_edges, analysis, findings, concept_graph)-- Export the graph as native Cypher CREATE statements. -
GraphExporter.to_obsidian(method)readmenator/_exporter.py:895def to_obsidian(self, nodes, edges, output_dir, analysis, concept_graph)-- Export the graph as an Obsidian vault with wikilinks. -
GraphExporter.to_forcegraph(method)readmenator/_exporter.py:1020def to_forcegraph(self, nodes, edges, resolved_edges, analysis, layers, findings, analytics)-- Generate the force-graph explorer HTML document.
Depends on: readmenator/_apidocs.py, readmenator/_config.py, readmenator/_models.py, readmenator/_pytypes.py, readmenator/_symindex.py
Imported by: readmenator/_app.py, readmenator/_documentation.py, tests/test_flowcharts.py
-
mermaid_id(function)readmenator/_flowcharts.py:66def mermaid_id(text, prefix)-- Return a Mermaid-safe identifier for text. -
mermaid_text(function)readmenator/_flowcharts.py:71def mermaid_text(text, limit)-- Escape text for a quoted Mermaid label, optionally truncating it. -
tarjan_scc(function)readmenator/_flowcharts.py:79def tarjan_scc(vertices, adjacency)-- Return strongly connected components (iterative Tarjan, deterministic order). -
transitive_reduction(function)readmenator/_flowcharts.py:133def transitive_reduction(adjacency)-- Return the transitive reduction of a DAG. -
reachable(function)readmenator/_flowcharts.py:148def reachable(vertex)-- Return every vertex reachable from vertex (memoised, iterative). -
eades_lin_smyth(function)readmenator/_flowcharts.py:184def eades_lin_smyth(vertices, weight)-- Order vertices so that heavy dependencies point forward (weighted ELS heuristic). -
live(function)readmenator/_flowcharts.py:210def live(table)-- Sum the weights of edges to vertices still remaining. -
ArchitectureDiagramBuilder.__init__(method)readmenator/_flowcharts.py:261def __init__(self, config)-- Initialise with application configuration. -
ArchitectureDiagramBuilder.components(method)readmenator/_flowcharts.py:269def components(self, nodes, analysis, layers)-- Group files into components with dominant layers. -
ArchitectureDiagramBuilder.render(method)readmenator/_flowcharts.py:334def render(self, nodes, resolved_edges, analysis, layers)-- Render the tiered architecture overview. -
EntryPoint.key(method)readmenator/_flowcharts.py:486def key(self)-- Return the call-graph key of this entry point. -
ExecutionFlowBuilder.__init__(method)readmenator/_flowcharts.py:515def __init__(self, config)-- Initialise with application configuration. -
ExecutionFlowBuilder.call_graph(method)readmenator/_flowcharts.py:533def call_graph(self, nodes, edges, resolved_edges, content_map)-- Build the ordered call graph keyed byfile::name. -
caller_key(function)readmenator/_flowcharts.py:565def caller_key(site_file, site_line, caller)-- Return the definition key of the scope making a call. -
ExecutionFlowBuilder.entry_points(method)readmenator/_flowcharts.py:614def entry_points(self, nodes, graph, defs, content_map)-- Score candidate entry points and return the strongest ones. -
bump(function)readmenator/_flowcharts.py:637def bump(file_id, name, line, points, reason)-- Add points and evidence to a candidate. -
ExecutionFlowBuilder.walk(method)readmenator/_flowcharts.py:692def walk(self, graph, start)-- Depth-first walk in call-site order, bounded by depth and steps. -
visit(function)readmenator/_flowcharts.py:707def visit(caller, depth, path)-- Emit the calls of caller recursively. -
ExecutionFlowBuilder.call_tree_mermaid(method)readmenator/_flowcharts.py:733def call_tree_mermaid(self, entry, steps)-- Render an execution call tree asflowchart LR. -
node(function)readmenator/_flowcharts.py:744def node(key, css)-- Declare key once and return its Mermaid id. -
ExecutionFlowBuilder.sequence_mermaid(method)readmenator/_flowcharts.py:773def sequence_mermaid(self, entry, steps)-- Render the cross-file part of a walk assequenceDiagram. -
ExecutionFlowBuilder.control_flow_mermaid(method)readmenator/_flowcharts.py:805def control_flow_mermaid(self, content, entry, project_names)-- Render a Python entry function (or__main__block) as a flowchart. -
_ControlFlowRenderer.__init__(method)readmenator/_flowcharts.py:851def __init__(self, config, project_names)-- Initialise with budgets and the set of project callable names. -
_ControlFlowRenderer.render(method)readmenator/_flowcharts.py:895def render(self, body, title)-- Render body and return the Mermaid source. -
flush(function)readmenator/_flowcharts.py:923def flush()-- Emit collapsed straight-line statements as one step. -
render_architecture_section(function)readmenator/_flowcharts.py:1090def render_architecture_section(config, nodes, resolved_edges, analysis, layers)-- Return Markdown lines for the Architecture Overview section. -
render_flows_section(function)readmenator/_flowcharts.py:1121def render_flows_section(config, nodes, edges, resolved_edges, content_map)-- Return Markdown lines for the Execution Flows section.
Depends on: readmenator/_config.py, readmenator/_forcegraph_page.py, readmenator/_graphlayout.py, readmenator/_models.py, readmenator/_purpose.py, readmenator/_rank.py, readmenator/_resolver.py, readmenator/_sourceview.py
Imported by: readmenator/_bundlegraph.py, readmenator/_documentation.py, readmenator/_explorer.py, readmenator/_exporter.py, readmenator/_pipeline.py, tests/test_bundlegraph.py, tests/test_interactive_graph.py, tests/test_layout_quality.py, tests/test_sourceview.py
-
family_color_from_name(function)readmenator/_forcegraph.py:38def family_color_from_name(name, sat_base, sat_span, light_base, light_span)-- Derive a stable, visually-distinct HSL color from a label. -
node_value(function)readmenator/_forcegraph.py:66def node_value(symbols, degree)-- Scale a node value with log2 dampening. -
ForceGraphRenderer.__init__(method)readmenator/_forcegraph.py:82def __init__(self, config)-- Initialise with application configuration. -
ForceGraphRenderer.node_palette(method)readmenator/_forcegraph.py:90def node_palette(self)-- Return the node-type color palette from configuration. -
ForceGraphRenderer.edge_palette(method)readmenator/_forcegraph.py:94def edge_palette(self)-- Return the edge-relation color palette from configuration. -
ForceGraphRenderer.vendor_source(method)readmenator/_forcegraph.py:98def vendor_source(self)-- Return the path of the vendored 2D engine shipped in the package. -
ForceGraphRenderer.vendor_href(method)readmenator/_forcegraph.py:106def vendor_href(self)-- Return the relative vendor script href used beside the page. -
ForceGraphRenderer.build_payload(method)readmenator/_forcegraph.py:111def build_payload(self, nodes, edges, resolved_edges, analysis, layers, findings, content_map)-- Build a heterogeneous graph payload for the explorer. -
file_of(function)readmenator/_forcegraph.py:147def file_of(edge_id)-- Map a symbol-scoped edge endpoint to its file identifier. -
add_node(function)readmenator/_forcegraph.py:201def add_node(node_id, label, node_type)-- Insert a node unless already present. -
ForceGraphRenderer.render(method)readmenator/_forcegraph.py:355def render(self, payload, analytics, title, home_href, live_api)-- Render the standalone force-graph explorer HTML document. -
ForceGraphRenderer.group_colors(method)readmenator/_forcegraph.py:403def group_colors(self, payload)-- Return stable colors for the layer and language groupings in a payload. -
ForceGraphRenderer.page_settings(method)readmenator/_forcegraph.py:426def page_settings(self, payload, live_api)-- Collect the explorer page settings serialized into the HTML. -
ForceGraphRenderer.family_color(method)readmenator/_forcegraph.py:502def family_color(self, name)-- Return the configured stable hash color for a group name. -
ForceGraphRenderer.thumbnail_svg(method)readmenator/_forcegraph.py:530def thumbnail_svg(self, payload)-- Render a small ForceAtlas2 preview of the file graph as inline SVG. -
ForceGraphRenderer.write(method)readmenator/_forcegraph.py:570def write(self, output_path, payload, analytics, title, home_href)-- Write the explorer HTML plus the vendored engine beside it. -
ForceGraphRenderer.copy_vendor(method)readmenator/_forcegraph.py:597def copy_vendor(self, dest_dir)-- Copy the vendored 2D engine next to an exported page.
Depends on: readmenator/_config.py, readmenator/_gitmeta.py
Imported by: readmenator/_app.py, readmenator/_pipeline.py, tests/test_gh_wiki.py
-
GitHubWikiPublisher.__init__(method)readmenator/_gh_wiki.py:62def __init__(self, config, runner)-- Store configuration and the subprocess runner (injectable for tests). -
GitHubWikiPublisher.page_name(method)readmenator/_gh_wiki.py:72def page_name(self, rel_path)-- Map a generated markdown path to its flat GitHub wiki page name. -
GitHubWikiPublisher.collect_sources(method)readmenator/_gh_wiki.py:96def collect_sources(self, project_root)-- List project-relative markdown sources to publish, sorted. -
GitHubWikiPublisher.rewrite(method)readmenator/_gh_wiki.py:129def rewrite(self, text, rel_path, names, project_root, blob_base)-- Rewrite relative doc links to wiki pages and paths to source permalinks. -
link(function)readmenator/_gh_wiki.py:151def link(match)-- Replace one relative markdown link when its target is published. -
permalink(function)readmenator/_gh_wiki.py:164def permalink(match)-- Link a backticked project file (optionally with a line) to source. -
GitHubWikiPublisher.render(method)readmenator/_gh_wiki.py:179def render(self, project_root, remote)-- Render every wiki page, including sidebar and footer. -
GitHubWikiPublisher.wiki_remote(method)readmenator/_gh_wiki.py:249def wiki_remote(self, project_root)-- Resolve the wiki remote from config,gh, or the git origin. -
GitHubWikiPublisher.publish(method)readmenator/_gh_wiki.py:313def publish(self, project_root, dry_run)-- Render pages and push them to the GitHub wiki (or a local folder).
Imported by: readmenator/_agent_output.py, readmenator/_app.py, readmenator/_gh_wiki.py, readmenator/_memory.py, tests/test_agent_friendliness.py
-
read_git_head(function)readmenator/_gitmeta.py:84def read_git_head(project_root)-- Return the current commit and branch of a project, when available.
Imported by: readmenator/_bundlegraph.py, readmenator/_forcegraph.py, readmenator/_video.py, tests/test_graphlayout.py, tests/test_layout_quality.py
-
forceatlas2_frames(function)readmenator/_graphlayout.py:73def forceatlas2_frames(ids, edges, settings)-- Run ForceAtlas2 and return evenly spaced layout snapshots. -
fit_frames(function)readmenator/_graphlayout.py:221def fit_frames(frames, box, margin, trim)-- Map raw snapshots into a pixel box using the final layout's bounds. -
interpolate_frames(function)readmenator/_graphlayout.py:266def interpolate_frames(frames, t)-- Linear interpolation between snapshots for a progress t in [0, 1]. -
hierarchical_edge_bundling(function)readmenator/_graphlayout.py:374def hierarchical_edge_bundling(groups, edges, center, radius, beta, samples, group_gap, inner_ratio)-- Lay leaves on a circle by group and bundle edges through the hierarchy. -
fibonacci_sphere(function)readmenator/_graphlayout.py:429def fibonacci_sphere(count)-- Return count nearly uniform unit vectors on a golden-angle spiral. -
spherical_edge_bundling(function)readmenator/_graphlayout.py:516def spherical_edge_bundling(groups, edges, radius, beta, samples, inner_ratio, refine_sweeps, affinity_edges)-- Lay leaves on a sphere in community caps and bundle edges through the hierarchy. -
normalize_cloud(function)readmenator/_graphlayout.py:586def normalize_cloud(points, quantile, max_radius)-- Center a 3D point cloud, scale a radius quantile to 1, and pull outliers in. -
bundle_angular_cost(function)readmenator/_graphlayout.py:654def bundle_angular_cost(groups, edges, group_gap)-- Total angular length of all edges for a circular group layout. -
optimize_bundle_order(function)readmenator/_graphlayout.py:702def optimize_bundle_order(groups, edges, sweeps, passes, group_gap)-- Reorder groups and members to shorten bundled edges (fewer crossings). -
refine_sphere_leaves(function)readmenator/_graphlayout.py:804def refine_sphere_leaves(layout, groups, edges, sweeps)-- Reassign leaves inside each cap so members face their neighbours. -
chord_total(function)readmenator/_graphlayout.py:829def chord_total(leaves)-- Sum of straight-line edge lengths.
Depends on: readmenator/_analyzer.py, readmenator/_category.py, readmenator/_config.py, readmenator/_models.py, readmenator/_purpose.py, readmenator/_rank.py, readmenator/_resolver.py
Imported by: readmenator/_app.py, readmenator/_pipeline.py, tests/test_graphrag.py, tests/test_memory.py
-
GraphRagIndex.to_dict(method)readmenator/_graphrag.py:186def to_dict(self)-- Serialise the index into JSON-compatible primitives. -
GraphRagIndex.from_dict(method)readmenator/_graphrag.py:197def from_dict(cls, data)-- Rebuild an index from :meth:to_dictoutput. -
tokenize(function)readmenator/_graphrag.py:240def tokenize(text, min_len, stopwords)-- Split text into lowercase retrieval tokens. -
Bm25Index.__init__(method)readmenator/_graphrag.py:270def __init__(self, documents, k1, b)-- Index token documents. -
Bm25Index.scores(method)readmenator/_graphrag.py:298def scores(self, query)-- Return the BM25 score of every document for the query tokens. -
GraphRagBuilder.__init__(method)readmenator/_graphrag.py:348def __init__(self, config)-- Initialise with application configuration. -
GraphRagBuilder.build(method)readmenator/_graphrag.py:358def build(self, nodes, edges, resolved_edges, analysis, layers, findings, analysis_v2, concept_graph, content_map...-- Build entities, relationships, text units, and community reports. -
add_relation(function)readmenator/_graphrag.py:406def add_relation(source, target, relation, description, confidence)-- Insert a relationship once, keyed by endpoints and relation. -
resolve_symbol(function)readmenator/_graphrag.py:452def resolve_symbol(file_id, name)-- Resolve a symbol name inside a file, else a globally unique name. -
GraphRagSearcher.__init__(method)readmenator/_graphrag.py:945def __init__(self, config, index)-- Prepare lexical indexes and the entity random-walk graph. -
GraphRagSearcher.choose_mode(method)readmenator/_graphrag.py:987def choose_mode(self, query)-- Pick local or global retrieval for a query. -
GraphRagSearcher.search(method)readmenator/_graphrag.py:1004def search(self, query, mode, budget_tokens)-- Run local, global, or automatically chosen retrieval. -
GraphRagSearcher.local_search(method)readmenator/_graphrag.py:1025def local_search(self, query, budget_tokens)-- Entity-centric retrieval: BM25 seeds expanded by Personalized PageRank. -
GraphRagSearcher.global_search(method)readmenator/_graphrag.py:1106def global_search(self, query, budget_tokens)-- Map-reduce over community reports for broad, corpus-level questions. -
GraphRagStore.__init__(method)readmenator/_graphrag.py:1215def __init__(self, config)-- Initialise with application configuration. -
GraphRagStore.directory(method)readmenator/_graphrag.py:1223def directory(self, project_root)-- Return the output directory for a project root. -
GraphRagStore.write(method)readmenator/_graphrag.py:1227def write(self, index, project_root)-- Write index.json, JSONL tables, and REPORTS.md. -
GraphRagStore.load(method)readmenator/_graphrag.py:1257def load(self, project_root)-- Load a previously written index, or None when missing or invalid. -
GraphRagStore.render_reports(method)readmenator/_graphrag.py:1279def render_reports(index)-- Render the community report hierarchy as greppable Markdown.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/_pipeline.py, tests/test_hotspots.py
-
HotspotAnalyzer.__init__(method)readmenator/_hotspots.py:31def __init__(self, config) -
HotspotAnalyzer.analyze_hotspots(method)readmenator/_hotspots.py:34def analyze_hotspots(self, nodes, edges, resolved_edges)-- Rank files by combined complexity and centrality scores. -
HotspotAnalyzer.detect_cycles(method)readmenator/_hotspots.py:90def detect_cycles(self, nodes, resolved_edges)-- Detect cycles in the resolved import graph using DFS. -
HotspotAnalyzer.analyze_change_impact(method)readmenator/_hotspots.py:155def analyze_change_impact(self, nodes, resolved_edges)-- Compute change impact for every file in the project.
Depends on: readmenator/_config.py, readmenator/_models.py
Imported by: readmenator/_pipeline.py, tests/test_layer_rules.py
-
LayerRuleEngine.__init__(method)readmenator/_layer_rules.py:36def __init__(self, config) -
LayerRuleEngine.detect_violations(method)readmenator/_layer_rules.py:39def detect_violations(self, nodes, edges, resolved_edges, layers)-- Detect architectural layer violations. -
LayerRuleEngine.violation_summary(method)readmenator/_layer_rules.py:111def violation_summary(violations)-- Summarise violations by severity.
Depends on: readmenator/_models.py
Imported by: readmenator/_app.py, readmenator/_components.py, readmenator/_cursorrules_generator.py, readmenator/_linter.py, readmenator/_mcp_server.py, readmenator/_pipeline.py, tests/test_agent_friendliness.py
-
LayerDetector.detect(method)readmenator/_layers.py:83def detect(self, nodes, edges)-- Assign each file node to an architectural layer. -
LayerDetector.layer_summary(method)readmenator/_layers.py:189def layer_summary(layers)-- Count files per layer.
Depends on: readmenator/_config.py, readmenator/_layers.py, readmenator/_models.py, readmenator/_symindex.py
Imported by: readmenator/_app.py, tests/test_linter.py
-
ArchitectureLinter.__init__(method)readmenator/_linter.py:34def __init__(self, config) -
ArchitectureLinter.lint(method)readmenator/_linter.py:37def lint(self, nodes, edges, resolved_edges, layers, content_map)-- Run all linter rules and return violations.
Depends on: readmenator/_app.py, readmenator/_config.py, readmenator/_layers.py, readmenator/_query.py
Imported by: readmenator/__init__.py, readmenator/__main__.py, tests/test_mcp_server.py
-
MCPError.__init__(method)readmenator/_mcp_server.py:59def __init__(self, code, message, data) -
MCPRequest.__init__(method)readmenator/_mcp_server.py:72def __init__(self, msg) -
MCPRequest.is_notification(method)readmenator/_mcp_server.py:79def is_notification(self) -
MCPRequest.response(method)readmenator/_mcp_server.py:82def response(self, result) -
MCPRequest.error(method)readmenator/_mcp_server.py:85def error(self, code, message, data) -
MCPTool.__init__(method)readmenator/_mcp_server.py:93def __init__(self, name, description, handler, input_schema) -
MCPTool.definition(method)readmenator/_mcp_server.py:108def definition(self) -
MCPTool.call(method)readmenator/_mcp_server.py:115def call(self, arguments) -
MCPResource.__init__(method)readmenator/_mcp_server.py:120def __init__(self, uri, name, description, mime_type, handler) -
MCPResource.definition(method)readmenator/_mcp_server.py:134def definition(self) -
MCPResource.read(method)readmenator/_mcp_server.py:142def read(self) -
MCPServer.__init__(method)readmenator/_mcp_server.py:147def __init__(self, app, target_dir) -
MCPServer.register_tool(method)readmenator/_mcp_server.py:155def register_tool(self, tool) -
MCPServer.register_resource(method)readmenator/_mcp_server.py:158def register_resource(self, resource) -
MCPServer.dispatch(method)readmenator/_mcp_server.py:241def dispatch(self, req) -
MCPServer.run(method)readmenator/_mcp_server.py:261def run(self) -
main(function)readmenator/_mcp_server.py:1074def main()-- CLI entry point forreadmenator serve <path>.
Depends on: readmenator/_config.py, readmenator/_gitmeta.py, readmenator/_models.py, readmenator/_purpose.py
Imported by: readmenator/_pipeline.py, tests/test_memory.py
-
sanitize_note(function)readmenator/_memory.py:84def sanitize_note(text, max_chars)-- Collapse a note to one safe line that cannot break the preserved block. -
ProjectMemory.__init__(method)readmenator/_memory.py:105def __init__(self, config)-- Initialise with application configuration. -
ProjectMemory.path(method)readmenator/_memory.py:113def path(self, project_root)-- Return the MEMORY.md location for a project root. -
ProjectMemory.read(method)readmenator/_memory.py:117def read(self, project_root)-- Return the current memory file text ("" when missing). -
ProjectMemory.notes(method)readmenator/_memory.py:124def notes(self, project_root)-- Parse the preserved session log into notes. -
ProjectMemory.remember(method)readmenator/_memory.py:149def remember(self, project_root, note, kind, today)-- Append one note to the preserved session log. -
ProjectMemory.write(method)readmenator/_memory.py:218def write(self, project_root, generated)-- Write generated sections while preserving the existing session log. -
ProjectMemory.build(method)readmenator/_memory.py:231def build(self, project_root, nodes, analysis, analysis_v2, findings, concept_graph, content_map)-- Render the generated memory document (with an empty notes block). -
ProjectMemory.extract_rules(method)readmenator/_memory.py:291def extract_rules(self, project_root)-- Extract categorised rule lines from the project's instruction files. -
ProjectMemory.detect_commands(method)readmenator/_memory.py:419def detect_commands(self, root, nodes)-- Detect workflow commands from project manifests.
Next: API_p2.md
Generated offline by readmenator from commit 3ee91a383bd9. Edits here are overwritten by readmenator . --rebuild.
Start
Wiki
- community_0_readmenator_parsers
- community_1_readmenator_video
- community_2_readmenator_agent_output
- community_3_readmenator_graphrag
- community_4_readmenator_pipeline
- community_5_readmenator_diagrams
- community_6_readmenator_flowcharts
- community_7_orphans
- concepts
- queries
- REPORT
Agent Docs
- API
- API_p2
- ARCHITECTURE
- ARCHITECTURE_p2
- CONCEPTS
- GOTCHAS
- INDEX
- KB_misc
- KB_parsers
- KB_readmenator
- KB_readmenator_p2
- KB_readmenator_p3
- KB_readmenator_p4
- KB_readmenator_p5
- KB_root
- KB_tests
- KB_tests_p2
- KB_tests_p3
- KB_tests_p4
- MEMORY
- SECURITY
- SYMBOLS
- SYMBOLS_p2
- SYMBOLS_p3
- SYMBOLS_p4
- SYMBOLS_p5
- SYMBOLS_p6
- SYMBOLS_p7
Recipes