Crate perl_workspace 

Workspace indexing and refactoring orchestration for Perl.

Maintains an in-memory index of all symbols, references, and module declarations across a Perl workspace. Provides incremental update, a document store for open files, and coordinates cross-file operations such as workspace-wide rename and symbol search.

Module guide

• api — curated, conflict-free re-exports for workspace bootstrap flows.
• discovery / folder / ignore — workspace root/file discovery helpers.
• monitoring, slo, state_machine — lifecycle policy + observability.
• workspace — indexing engine, caches, coordinator, and rename support.

Re-exports

pub use workspace::document_store;

pub use workspace::workspace_index;

pub use workspace::workspace_rename;

Modules

api

Unified public API surface. Unified public API surface for perl-workspace-index.

ast

Abstract Syntax Tree (AST) definitions for Perl parsing. AST facade for the core parser engine.

discovery

Git-aware workspace file discovery. Git-aware Perl workspace file discovery.

folder

Workspace folder URI/path parsing. Workspace folder URI/path parsing.

ignore

Workspace noise filtering rules. Canonical workspace noise filtering rules.

line_index

Line indexing and position mapping utilities.

monitoring

Monitoring, limits, and lifecycle instrumentation primitives. Monitoring, limits, and lifecycle instrumentation primitives.

position

Position tracking types and UTF-16 mapping utilities. Enhanced position tracking for incremental parsing

semantic

Canonical semantic substrate: fact population, indexes, and query facade. Semantic substrate module tree for workspace-level semantic analysis.

semantic_shadow_compare

Semantic shadow-compare receipt model for old-vs-new workspace query outputs.

slo

Service-level objective tracking for workspace index operations. Service Level Objectives (SLOs) for workspace index operations.

state_machine

Index lifecycle state machine. Enhanced index lifecycle state machine for production readiness.

workspace

Workspace indexing and refactoring orchestration. Workspace-level orchestration primitives for indexing and refactoring.

Structs

Node

Core AST node representing any Perl language construct within parsing workflows.

Parser

Parser state for a single Perl source input.

Enums

NodeKind

Comprehensive enumeration of all Perl language constructs supported by the parser.

Type Aliases

SourceLocation

Type alias for backward compatibility with SourceLocation.