Class ProjectAlertsContextProvider

java.lang.Object

uno.anahata.asi.agi.event.BasicPropertyChangeSource

uno.anahata.asi.agi.context.BasicContextProvider

uno.anahata.asi.nb.tools.project.context.AbstractProjectContextProvider

uno.anahata.asi.nb.tools.project.alerts.ProjectAlertsContextProvider

All Implemented Interfaces:

ContextProvider, PropertyChangeSource, Rebindable

public class ProjectAlertsContextProvider
extends AbstractProjectContextProvider

Provides real-time diagnostics for a project, including Java compiler errors and high-level project problems.

Author:

anahata-ai

Field Summary

Fields inherited from class AbstractProjectContextProvider

project, projectPath, projectsToolkit

Modifier and Type	Field	Description
protected org.netbeans.api.project.Project	project	The cached NetBeans project instance.
protected final String	projectPath	The absolute canonical path to the project root.
protected final Projects	projectsToolkit	The parent Projects toolkit instance.

Fields inherited from class BasicContextProvider

children, parent

Modifier and Type	Field	Description
protected final List<ContextProvider>	children	The list of immediate child providers.
protected ContextProvider	parent	The parent provider in the hierarchy.

Fields inherited from class BasicPropertyChangeSource

propertyChangeSupport

Modifier and Type	Field	Description
protected PropertyChangeSupport	propertyChangeSupport	Support for firing property change events.

Constructor Summary

Constructors

Constructor	Description
ProjectAlertsContextProvider(Projects projectsToolkit, String projectPath)	Constructs a new alerts provider for a specific project.

Method Summary

Modifier and Type	Method	Description
void	populateMessage(RagMessage ragMessage)	Populates the given RagMessage with dynamic, just-in-time context parts.

Methods inherited from class AbstractProjectContextProvider

getProject, setProviding

Modifier and Type	Method	Description
org.netbeans.api.project.Project	getProject()	Resolves the NetBeans Project instance, restoring it from the path if needed.
void	setProviding(boolean enabled)	Toggles the providing status and triggers a recursive IDE visual refresh.

Methods inherited from class BasicContextProvider

getAgi, getChildrenProviders, getParentProvider, setParentProvider

Modifier and Type	Method	Description
Agi	getAgi()	Gets the parent AGI session this context provider is registered under.
List<ContextProvider>	getChildrenProviders()	Gets the list of immediate child context providers.
ContextProvider	getParentProvider()	Gets the parent context provider in the hierarchy, if any.
void	setParentProvider(ContextProvider parent)	Sets the parent context provider for this instance.

Methods inherited from class BasicPropertyChangeSource

addPropertyChangeListener, addPropertyChangeListener, rebind, removePropertyChangeListener, removePropertyChangeListener

Modifier and Type	Method	Description
void	addPropertyChangeListener(PropertyChangeListener listener)	Adds a property change listener.
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener)	Adds a property change listener for a specific property.
void	rebind()	Re-initializes the transient PropertyChangeSupport after deserialization.
void	removePropertyChangeListener(PropertyChangeListener listener)	Removes a property change listener.
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener)	Removes a property change listener for a specific property.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ContextProvider

getContextPosition, getDescription, getFlattenedHierarchy, getFullyQualifiedId, getHeader, getIconId, getId, getInstructionsTokenCount, getName, getRagTokenCount, getSystemInstructions, isEffectivelyProviding, isProviding

Modifier and Type	Method	Description
default ContextPosition	getContextPosition()	Gets the designated position of this provider's content in the AI prompt.
String	getDescription()	Gets a detailed description of what this context provider does.
default List<ContextProvider>	getFlattenedHierarchy(boolean providingOnly)	Gets a flattened list of this provider and all its descendants in the hierarchy.
default String	getFullyQualifiedId()	Gets the fully qualified ID of this provider, reflecting its position in the hierarchy.
default String	getHeader()	Generates a machine-readable header string for this context provider, used to identify the source of injected context in the final prompt.
default String	getIconId()	Gets an optional icon identifier for this provider.
String	getId()	Gets the unique identifier for this context provider.
default int	getInstructionsTokenCount()	Calculates the token count for the system instructions provided by this instance using the active model.
String	getName()	Gets the human-readable name of this context provider.
default int	getRagTokenCount()	Calculates the token count for the RAG content provided by this instance using the active model.
default List<String>	getSystemInstructions()	Gets a list of system instruction strings provided by this context provider.
default boolean	isEffectivelyProviding()	Checks if this provider is effectively providing context, meaning it is enabled AND all its ancestors in the hierarchy are also enabled.
boolean	isProviding()	Checks if this context provider is currently active and providing context.

Methods inherited from interface PropertyChangeSource

getPropertyChangeSupport

Modifier and Type	Method	Description
PropertyChangeSupport	getPropertyChangeSupport()	Gets the PropertyChangeSupport instance for this object.

Constructor Details

ProjectAlertsContextProvider

public ProjectAlertsContextProvider(Projects projectsToolkit,
 String projectPath)

Constructs a new alerts provider for a specific project.

Parameters:

projectsToolkit - The parent Projects toolkit.

projectPath - The absolute path to the project.

Method Details

populateMessage

public void populateMessage(RagMessage ragMessage)
                     throws Exception

Populates the given RagMessage with dynamic, just-in-time context parts. These parts are appended to the end of the user's prompt (RAG).

Fetches current alerts from the Projects toolkit and appends them to the RAG message. Alerts are grouped by type (Project vs. Compiler).

Parameters:

ragMessage - The message to be augmented with context.

Throws:

Exception - if an error occurs during context generation.