Create a metadata file with documentation generation information.

Create fallback models chain from configuration.

Ensure directory exists, create if necessary. Args: path: Directory path mode: Directory permissions (default: 0o700 - u

Args: lines: All lines of the file start: 1-based line number of the start of the viewport stop: 1-based

Extract code files from file tree structure. Filters files based on supported extensions and excludes test/config files. Ar

Mark job as failed.

Run flake8 on a given file and return the output as a string

Format the cluster prompt with potential core components and module tree.

Create configuration from parsed arguments.

Generate documentation for all modules using dynamic programming approach.

Generate documentation for a parent module based on its children's documentation.

Get absolute path for a given relative path.

Count the tokens used to decide whether a module needs clustering.

Generate prompt additions based on agent instructions.

Run the dependency analysis, write results to workspace files, and return a compact summary with file paths.

Edit an existing documentation file (str_replace, insert, or undo).

Write the source code for given component IDs to workspace files. Returns a compact JSON with file paths — no source code inline.

Create a new documentation file in the output directory.

Initialize global variables from environment or command line args if not already set.

Check if path is inside a git repository. Searches parent directories if .git is not directly at repo_path, supporting monorepo subd

Check if a model is considered top-tier for clustering. Args: model: Model name Returns: True if top-tier,

Load the module tree structure from module_tree.json.

Main function to run the web application.

Mask API key for display, showing only first and last few characters. Args: api_key: API key to mask visible_chars: Numb

Truncate content and append a notice if content exceeds the specified length.

Register a use statement with optional alias.

Run the per-module agent loop. Returns the updated module_tree dict.

Set whether we're running in CLI context (vs web app).

Mark job as started.

Convert to dictionary, excluding None values.

Update progress for a module. Args: module_name: Name of the module cached: Whether the module was l

Validate all configuration fields. Subscription-mode providers (claude-code, codex) authenticate via the underlying CLI's OA

Add relationships for use statements.

Return the caw tool group needed for a module-agent session.

Parse and analyze the PHP file.

Analyze C file using tree-sitter based analyzer. Args: file_path: Relative path to the C file content: File

Analyze a single code file based on its language. Routes to appropriate language-specific analyzer. Args: repo_

Analyze C++ file using tree-sitter based analyzer. Args: file_path: Relative path to the C++ file content: F

Analyze C# file using tree-sitter based analyzer. Args: file_path: Relative path to the C# file content: Fil

Analyze Java file using tree-sitter based analyzer. Args: file_path: Relative path to the Java file content:

Analyze JavaScript file using tree-sitter based AST analyzer Args: file_path: Relative path to the JavaScript file

Analyze Kotlin file using tree-sitter based analyzer. Args: file_path: Relative path to the Kotlin file cont

Analyze PHP file using tree-sitter based analyzer. Args: file_path: Relative path to the PHP file content: F

Analyze Python file using Python AST analyzer. Args: file_path: Relative path to the Python file content: Fi

Analyze TypeScript file using tree-sitter based AST analyzer Args: file_path: Relative path to the TypeScript file

Build HTML content for repo info section. Args: metadata: Metadata dictionary Returns:

Build exact/simple-name lookup indexes, both globally and per language. Resolution prefers the caller's own language partition: a name

Call LLM via Azure OpenAI. Uses the AzureOpenAI client from the openai package with azure_endpoint, api_version, and deployment name.

Call LLM via litellm for Bedrock/Anthropic providers. litellm handles the provider-specific API translation automatically.

Check if system keyring is available.

Map a call target to (callee, is_resolved). Bare names check same-file definitions, then imports. Attribute calls are resolved receiv

Dotted module paths for every Python file in the repository.

Configure backend logger for CLI use with colored output.

Create Node object from entity data.

Deduplicate call relationships based on caller-callee pairs. Removes duplicate relationships while preserving the first occurrence.

Detect files changed since the last documentation generation. Reads the commit_id from metadata.json and compares with current HEAD usin

Detect changes since last documentation generation. Returns a changes dict with affected modules, or None if no previous generation exists (f

Detect changes via git. Returns None if not in a git repo or if no previous commit is recorded (so the caller can fall through to mtime). Che

Fallback: detect changed files by comparing mtime with generation timestamp.

Dotted-boundary containment: does `target` align with some segment run of `project_module`? Tolerates src-layouts where the import root differs

Project packages/namespaces, partitioned by language. Java and C# share the namespace-origin rule: a dotted callee qualified to a package

Resolve this.m()/super.m() against the enclosing class and its bases.

Resolve recv.m() where recv is a simple identifier.

Extract arrow function

Extract arrow function or function expression from const/let/var declarations.

Extract base class name from AST node.

Extract base class names from a class declaration.

Emit at most one relationship per call expression. Plain identifier calls resolve against same-file components; member calls are reso

Extract class/abstract class/interface declaration.

Extract dependencies from constructor parameters.

Collect a ``///`` XML doc-comment block immediately preceding the declaration (skipping any attribute lists between comment and decl).

Extract export function or export default function