Package org.machanism.machai.gw.reviewer
package org.machanism.machai.gw.reviewer
Provides file reviewer implementations for various source formats including Java, Python, TypeScript, HTML, Markdown, and plain text.
Reviewers in this package are responsible for analyzing project files of supported types and extracting custom documentation guidance.
This guidance, typically annotated with the @guidance tag in comments, is used to automate documentation workflows and improve code quality.
Common reviewer logic includes reading files, parsing for annotated documentation fragments, and formatting outputs for further processing.
Supported reviewers:
JavaReviewer: Reviews Java source and package-info files.PythonReviewer: Reviews Python files.TypeScriptReviewer: Reviews TypeScript files.HtmlReviewer: Reviews HTML and XML files.MarkdownReviewer: Reviews Markdown files.TextReviewer: Reviews plain text files for guidance propagation.
Reviewer interface for standardized access and automation.
When adding or updating code in this package, ensure every public or protected class, interface, method, and field has a clear, comprehensive Javadoc. See @guidance for detailed documentation standards.
Usage Example:
Reviewer reviewer = new JavaReviewer();
String guidance = reviewer.perform(new File("/project/root"), new File("src/Example.java"));
if (guidance != null) {
// use extracted guidance for documentation
}
-
ClassDescriptionReviewer implementation for HTML files (.html, .htm).Reviewer implementation for Java source files (.java).Reviewer implementation for Markdown files (.md).Reviewer implementation for Python source files (.py).Interface for file reviewers that analyze project files to extract or process guidance for documentation generation.Reviewer implementation for generic text files (.txt).Reviewer implementation for TypeScript source files (.ts).