Crate projectatlas 

Purpose: Provide the ProjectAtlas 3 command-line adapter.

Modules

atlas_map 🔒

Purpose: Generate and lint ProjectAtlas structure maps from Rust.

derived_snapshot_archive 🔒

Bounded archive adapter for portable derived graph snapshots.

mcp 🔒

Purpose: Serve ProjectAtlas repository intelligence over MCP. Native MCP adapter for ProjectAtlas agent integrations.

runtime 🔒

Purpose: Coordinate shared ProjectAtlas CLI and MCP runtime workflows. Shared runtime orchestration for the ProjectAtlas CLI and MCP adapters.

structural 🔒

Deterministic structural summaries for files without declaration symbols.

token_tui 🔒

Purpose: Render token telemetry as package-backed terminal dashboards.

Structs

ClaudeMcpConfigDocument 🔒

Claude Code .mcp.json compatible configuration document.

ClaudeMcpServerConfig 🔒

Claude Code MCP server launch entry.

Cli 🔒

Top-level parsed CLI arguments.

CliErrorPayload 🔒

Stable CLI error details shared by TOON and JSON output.

CliErrorResponse 🔒

Structured CLI error payload for typed agent-recoverable failures.

CliNextCall 🔒

Existing CLI command that repairs a confirmed stale index.

ControlledInput 🔒

Controlled reader used by the installed TOON streaming encoder.

ControlledOutput 🔒

Bounded output buffer that observes the request control between chunks.

CoverageCliFilters 🔒

Borrowed CLI-only coverage filters before typed service parsing.

DatabaseFilesystemErrorPayload 🔒

Content-free database placement details with direct recovery guidance.

DetailedRelationAnchorArgs 🔒

Exact local anchor controls for detailed relation navigation.

DetailedRelationArgs 🔒

Additive options used only by the detailed relation view.

DetailedRelationFilterArgs 🔒

Direction and trust filters for detailed relation navigation.

DetailedRelationLimitArgs 🔒

Traversal and output ceilings for detailed relation navigation.

McpConfigDocument 🔒

.mcp.json compatible server configuration document.

McpServerConfig 🔒

MCP server launch entry.

NamedPayload 🔒

One dynamic top-level payload field without an intermediate JSON value.

OpenCodeConfigDocument 🔒

OpenCode opencode.json compatible configuration document.

OpenCodeMcpServerConfig 🔒

OpenCode local MCP server launch entry.

OptionalSymbolSelectorArgs 🔒

Optional exact symbol selector shared by the top-level slice command.

ParityCheck 🔒

One parity check row.

ParityPayload 🔒

Agent-facing parity payload wrapper.

ParityReport 🔒

Repository-intelligence parity report.

PurposeSetPayload 🔒

Stable serialized schema for a CLI purpose update.

PurposeSetReport 🔒

Agent-facing payload for a CLI purpose update.

RelationAnalysisArgs 🔒

Closed controls accepted only by symbols relations --view analysis.

RequiredSymbolSelectorArgs 🔒

Required exact symbol selector shared by the symbol slice command.

RootReport 🔒

Project-local root identity report.

RuntimeInfoReport 🔒

Stable runtime identity and capability report for installers.

SearchCapabilityErrorPayload 🔒

Typed optional search-capability failure shared by CLI and MCP adapters.

Enums

AgentErrorKind 🔒

Stable error kinds shared by CLI and MCP agent payloads.

CliError 🔒

Error type for CLI boundary failures.

Command 🔒

Supported ProjectAtlas CLI commands.

HarnessConfig 🔒

MCP host configuration format.

HealthCommand 🔒

Health metadata subcommands.

HealthSeverityArg 🔒

Health severity filter accepted by CLI commands.

IgnoreCommand 🔒

Manual ignore management subcommands.

IgnoreKind 🔒

Manual ProjectAtlas ignore entry kind for CLI input.

OutputFormat 🔒

CLI output serialization format.

ParityCheckStatus 🔒

Stable status values for repository-intelligence parity checks.

ParityCommand 🔒

Parity gate subcommands.

ParserPackCommand 🔒

Explicit optional parser-pack lifecycle commands.

PurposeCommand 🔒

Purpose metadata subcommands.

PurposeLintLevelArg 🔒

Purpose curation strictness accepted by projectatlas lint.

RelationAnalysisModeArg 🔒

Closed relation analysis selected on the existing symbol-relations route.

RelationConfidenceArg 🔒

Lowest confidence retained by detailed relation navigation.

RelationDirectionArg 🔒

Detailed relation traversal direction.

RelationResolutionArg 🔒

Resolution state retained by detailed relation navigation.

RelationViewArg 🔒

Symbol-relation response contract selected by the caller.

RequiredCliCommand 🔒

Required CLI command families whose variants must remain constructible.

RootCommand 🔒

Project root diagnostics and binding subcommands.

RootTransition 🔒

Explicit durable root transition selected by CLI or MCP callers.

SearchRetrievalModeArg 🔒

Retrieval family accepted by CLI and MCP search adapters.

SnapshotAction 🔒

Portable derived graph snapshot operation.

SymbolsCommand 🔒

Symbol graph subcommands.

TokenTheme 🔒

Token TUI color theme.

TokenTrendWindow 🔒

Token trend grouping window.

TokenView 🔒

Token report presentation mode.

Constants

CLI_INIT_COMMAND 🔒

Existing CLI command that initializes one selected project root.

CLI_PAYLOAD_SYMBOL_RELATIONS 🔒

CLI top-level field for detailed and analysis relation responses.

CLI_REFRESH_COMMAND 🔒

Existing CLI command that performs one bounded refresh pass.

CONTROLLED_ENCODING_CHUNK_BYTES 🔒

Maximum bytes copied between cooperative output-control checks.

DATABASE_FILESYSTEM_RECOVERY 🔒

Recovery guidance for a database whose local WAL-safe placement was rejected.

DEFAULT_CALLER_LABEL 🔒

Default caller-visible compatibility label for token telemetry.

DEFAULT_DB_PATH 🔒

Default relative path for the SQLite index.

DEFAULT_FILE_SUMMARY_LIMIT 🔒

Default maximum rows returned per structured file-summary section.

PROJECTATLAS_MAJOR_VERSION 🔒

ProjectAtlas major architecture version.

REPOSITORY_INTELLIGENCE_PROFILE 🔒

Default parity profile for repository-intelligence checks.

REQUIRED_CLI_COMMANDS 🔒

CLI command families required for the agent-first repository-intelligence surface.

WATCH_MODE_NOTIFY 🔒

Event-backed watcher mode.

WATCH_MODE_ONCE 🔒

One-shot watcher refresh mode.

WATCH_MODE_POLLING 🔒

Portable fallback watcher mode.

Functions

bind_project_root 🔒

Bind, move, or detach a project root without machine-global root state.

build_harness_mcp_config_report 🔒

Build a harness-specific MCP configuration document for this binary.

build_mcp_config_report 🔒

Build a standards-compliant MCP configuration document for this binary.

build_parity_report 🔒

Build the current repository-intelligence parity report.

build_root_report 🔒

Build a project-local root identity report.

build_root_report_with_transition 🔒

Build a root report with optional completed transition details.

build_runtime_info 🔒

Build stable runtime identity and capability information.

build_token_calibration 🔒

Build an optional local tokenizer calibration over indexed UTF-8 files.

cli_command_name 🔒

Return the stable CLI name for a parsed command variant.

controlled_named_output 🔒

Serialize one named analysis envelope while retaining deadline and cancellation.

coverage_query_from_cli 🔒

Build one typed bounded coverage query from explicit CLI filters.

database_filesystem_error_payload 🔒

Extract a stable content-free SQLite placement failure from a CLI error.

finalize_coverage_output 🔒

Stabilize format-specific encoded byte metadata before output and telemetry.

health_query_from_cli 🔒

Build a bounded DB health query from CLI filter arguments.

load_cli_atlas_config 🔒

Load map and lint config with an explicit CLI database override when present.

load_purpose_review_requests 🔒

Load batch purpose review requests from a JSON file.

load_token_atlas_preview 🔒

Load the tiny optional atlas preview through existing indexed relation-family reads.

load_token_atlas_relations 🔒

Load the bounded resolved-relation input owned by the optional atlas preview.

main 🔒

Parse arguments, execute the command, and convert failures to process exit.

mcp_launch_path 🔒

Render a native path for MCP launch config without Windows extended prefixes.

native_launch_path 🔒

Return non-Windows paths unchanged.

open_index_for_current_read 🔒

Open the selected current index through one root-bound read snapshot.

open_index_for_mutation 🔒

Open a selected project database for purpose or health mutation.

open_index_for_read 🔒

Open and verify the durable index before a normal CLI read.

parse_cli 🔒

Parse CLI arguments while retaining whether --db was explicitly selected.

print_output 🔒

Emit either TOON or JSON to stdout.

print_tracked_directory_output_estimate 🔒

Record estimated-token telemetry for the exact emitted CLI payload.

print_tracked_output_estimate 🔒

Record candidate-set telemetry for the exact emitted CLI payload.

print_tracked_output_text 🔒

Record baseline-text telemetry for the exact emitted CLI payload.

print_tracked_slice_output 🔒

Emit a bounded exact slice and record telemetry for the accepted bytes.

purpose_queue_scope 🔒

Return the DB scope for purpose queue CLI switches.

push_check 🔒

Append one parity check.

render_cli_error 🔒

Render typed source-state failures in the selected agent/script format.

render_code_slice 🔒

Render a code slice as compact TOON.

render_file_summary 🔒

Render a deterministic file summary as compact TOON.

render_mcp_config_report 🔒

Render MCP configuration as TOON for agents.

render_parity_report 🔒

Render repository-intelligence parity as compact TOON.

render_root_report 🔒

Render root diagnostics as compact TOON.

render_runtime_info 🔒

Render runtime information as compact TOON.

render_search_report 🔒

Render a search report as compact TOON.

render_settings_report 🔒

Render settings as compact TOON.

render_watch_status 🔒

Render watcher status as compact TOON.

required_cli_surface_present 🔒

Return whether the compiled CLI surface contains required command families.

run 🔒

Execute the selected CLI command.

run_parser_pack_command 🔒

Execute one explicit optional parser-pack lifecycle command from the selected project root.

serialized_output 🔒

Serialize output exactly as the CLI will emit it.

trimmed_cli_filter 🔒

Return a trimmed non-empty CLI string filter.

truthy_env 🔒

Return whether an environment variable is set to a truthy value.

validate_required_runtime_version 🔒

Validate a caller-provided runtime version guard.

write_init_mcp_config_files 🔒

Write all generated host MCP configs expected after first-run init.

write_mcp_config_file 🔒

Write one generated MCP config document as pretty JSON.

write_stderr 🔒

Write text to stderr without using print macros.

write_stdout 🔒

Write text to stdout without using print macros.