Class ProjectFilesContextProvider

java.lang.Object

uno.anahata.asi.agi.event.BasicPropertyChangeSource

uno.anahata.asi.agi.context.BasicContextProvider

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

All Implemented Interfaces:

ContextProvider, PropertyChangeSource, Rebindable

public class ProjectFilesContextProvider
extends BasicContextProvider

Provides a real-time view of a project's file and folder structure. This provider injects a Markdown-formatted tree of the project into the AI's prompt augmentation (RAG) message.

Author:

anahata

Field Summary

Fields

Modifier and Type	Field	Description
private final String	projectPath	The absolute path to the project directory.
private final Projects	projectsToolkit	The parent Projects toolkit.

Fields inherited from class BasicContextProvider

children, parent

Fields inherited from class BasicPropertyChangeSource

propertyChangeSupport

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
private String	formatProjectFile(ProjectFile file, String indent)	Formats a project file into a Markdown list item.
private String	formatSourceFolder(SourceFolder folder, String indent, String basePath, String relPath)	Recursively formats a source folder and its contents into a Markdown tree.
private String	generateMarkdown(ProjectFiles files)	Generates a Markdown string representing the project file tree.
void	populateMessage(RagMessage ragMessage)	Injects the project's file tree into the RAG message.
void	setProviding(boolean enabled)	Toggles providing status and triggers a UI refresh.

Methods inherited from class BasicContextProvider

getAgi, getChildrenProviders, getParentProvider, setParentProvider

Methods inherited from class BasicPropertyChangeSource

addPropertyChangeListener, addPropertyChangeListener, rebind, removePropertyChangeListener, removePropertyChangeListener

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

Methods inherited from interface PropertyChangeSource

getPropertyChangeSupport

Field Details

projectsToolkit

private final Projects projectsToolkit

The parent Projects toolkit.

projectPath

private final String projectPath

The absolute path to the project directory.

Constructor Details

ProjectFilesContextProvider

public ProjectFilesContextProvider(Projects projectsToolkit,
 String projectPath)

Constructs a new files 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

Injects the project's file tree into the RAG message.

Implementation details: Fetches the current file structural data from the Projects toolkit and generates a Markdown tree. It distinguishes between root files and source-group folders for clarity.

Parameters:

ragMessage - The target RAG message.

Throws:

Exception - if project files cannot be retrieved.

setProviding

public void setProviding(boolean enabled)

Toggles providing status and triggers a UI refresh.

Implementation details: Notifies the IDE that the project icon should be redrawn to reflect the new context state.

Parameters:

enabled - New state.

generateMarkdown

private String generateMarkdown(ProjectFiles files)

Generates a Markdown string representing the project file tree.

Implementation details: This method splits the output into the Root Directory (flat list) and Source Folders (hierarchical tree). It resolves the relative path for each top-level source folder to provide context for the AI.

Parameters:

files - The project files data.

Returns:

A Markdown-formatted string.

formatSourceFolder

private String formatSourceFolder(SourceFolder folder,
 String indent,
 String basePath,
 String relPath)

Recursively formats a source folder and its contents into a Markdown tree.

Implementation details: Displays the folder name (or display name) followed by an optional relative path in parentheses for top-level groups.

Parameters:

folder - The source folder to format.

indent - The current indentation level.

basePath - The base path of the project.

relPath - Optional relative path for display next to the folder.

Returns:

A Markdown-formatted string for the folder.

formatProjectFile

private String formatProjectFile(ProjectFile file,
 String indent)

Formats a project file into a Markdown list item.

Implementation details: Includes the file name and any IDE-level annotations (e.g., Git status flags) extracted from the annotated name.

Parameters:

file - The project file to format.

indent - The current indentation string.

Returns:

A Markdown-formatted string for the file.