Module mcp

Module mcp 

Source
Expand description

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

Structsยง

AtlasFileSummaryParams ๐Ÿ”’
MCP parameter payload for deterministic file summaries.
AtlasFilesParams ๐Ÿ”’
MCP parameter payload for ranked file lookup with optional absolute folder routing.
AtlasHealthParams ๐Ÿ”’
MCP parameter payload for bounded health finding lookup.
AtlasHealthResolveParams ๐Ÿ”’
MCP parameter payload for resolving health findings.
AtlasIgnoreMutationParams ๐Ÿ”’
MCP parameter payload for ignore mutations.
AtlasInitParams ๐Ÿ”’
MCP parameter payload for initializing a project.
AtlasLintParams ๐Ÿ”’
MCP parameter payload for lint reports.
AtlasMapParams ๐Ÿ”’
MCP parameter payload for compatibility map exports.
AtlasMcpConfigParams ๐Ÿ”’
MCP parameter payload for generated MCP config documents.
AtlasOutlineParams ๐Ÿ”’
MCP parameter payload for outlining a file.
AtlasParityParams ๐Ÿ”’
MCP parameter payload for parity reports.
AtlasProjectParams ๐Ÿ”’
Optional active-project override accepted by MCP tools.
AtlasPurposeQueueParams ๐Ÿ”’
MCP parameter payload for bounded task-scoped purpose curation.
AtlasPurposeReviewItem ๐Ÿ”’
MCP payload for one batch purpose review item.
AtlasPurposeReviewParams ๐Ÿ”’
MCP parameter payload for batch purpose review.
AtlasPurposeSetParams ๐Ÿ”’
MCP parameter payload for setting purpose metadata.
AtlasQueryParams ๐Ÿ”’
MCP parameter payload for ranked node lookup.
AtlasResetIndexParams ๐Ÿ”’
MCP parameter payload for runtime index cleanup.
AtlasRootParams ๐Ÿ”’
MCP parameter payload for root diagnostics.
AtlasRootSetParams ๐Ÿ”’
MCP parameter payload for binding a root.
AtlasScanParams ๐Ÿ”’
MCP parameter payload for scanning and symbol refresh.
AtlasSearchParams ๐Ÿ”’
MCP parameter payload for text search.
AtlasSessionBriefParams ๐Ÿ”’
MCP parameter payload for compact agent startup briefs.
AtlasSetProjectPathParams ๐Ÿ”’
MCP parameter payload for selecting the active project.
AtlasSliceParams ๐Ÿ”’
MCP parameter payload for exact source slices.
AtlasStripLegacyParams ๐Ÿ”’
MCP parameter payload for legacy purpose cleanup.
AtlasSymbolRelationsParams ๐Ÿ”’
MCP parameters for legacy, detailed, or closed-analysis relation navigation.
AtlasSymbolsParams ๐Ÿ”’
MCP parameter payload for symbol and relation lookup.
AtlasTaskParams ๐Ÿ”’
MCP parameter payload for task-progress tools.
AtlasTokenParams ๐Ÿ”’
MCP parameter payload for token savings reports.
AtlasWatchOnceParams ๐Ÿ”’
MCP parameter payload for one-shot watcher refresh.
McpAbsolutePath ๐Ÿ”’
Canonical absolute path supplied to an MCP path-bearing tool.
McpBackgroundResourceEnvelope ๐Ÿ”’
Fixed worker partition shared by background indexing tasks in one MCP server.
McpBriefBlocker ๐Ÿ”’
One health blocker row for startup briefs.
McpBriefBlockers ๐Ÿ”’
Bounded health blocker section.
McpBriefCandidate ๐Ÿ”’
Bounded ranked candidate row for startup briefs.
McpBriefLimits ๐Ÿ”’
Effective startup brief row limits.
McpBriefPolicy ๐Ÿ”’
Brief policy fields.
McpBriefRecommendation ๐Ÿ”’
One typed startup recommendation.
McpCompactBriefBlockers ๐Ÿ”’
Compact blocker count; the recommendation carries the exact bounded health call.
McpCompactBriefCandidate ๐Ÿ”’
Bounded compact ranked candidate row for task startup.
McpCompactBriefLimits ๐Ÿ”’
Non-default limits and truncation state in the compact startup projection.
McpCompactBriefOverview ๐Ÿ”’
Compact project counts for task startup.
McpCompactBriefProject ๐Ÿ”’
Compact selected-project state for the startup path.
McpCompactBriefPurposeHandoff ๐Ÿ”’
Compact host-owned purpose-curator handoff for startup briefs.
McpCompactBriefRecommendation ๐Ÿ”’
One typed recommendation in the compact startup projection.
McpCompactCoverageDigest ๐Ÿ”’
Adapter-local compact coverage projection that leaves shared serialization unchanged.
McpCompactCoverageStateCounts ๐Ÿ”’
Adapter-local sparse coverage counts for the explicit compact summary.
McpCompactDetailedRelationNode ๐Ÿ”’
Adapter-local compact detailed-relation node without stable-key duplication.
McpCompactDetailedRelationReport ๐Ÿ”’
Opt-in compact projection of one detailed relation page.
McpCompactDetailedRelationRow ๐Ÿ”’
One compact detailed-relation row.
McpCompactFederatedDetailedRelationReport ๐Ÿ”’
Compact federated wrapper that preserves cross-root evidence and work.
McpCompactLogicalRelation ๐Ÿ”’
Compact relation facts required for trust and direct navigation.
McpCompactRelationContinuationArguments ๐Ÿ”’
Exact result-defining arguments required to resume a detailed relation page.
McpCompactRelationContinuationCall ๐Ÿ”’
Existing MCP relation call that resumes one exact compact page.
McpCompactRelationOccurrence ๐Ÿ”’
Compact source occurrence without another copy of the owning relation key.
McpCompactSessionBrief ๐Ÿ”’
Additive compact projection of the compatibility-preserving startup brief.
McpErrorPayload ๐Ÿ”’
Stable serialized schema for MCP error details.
McpErrorResponse ๐Ÿ”’
Agent-facing error payload for failed MCP calls.
McpFileSummary ๐Ÿ”’
Compact projection used when an agent follows a default startup recommendation.
McpFileSummaryPayload ๐Ÿ”’
Explicit compact file-summary payload with actionable facts and redundant state removed.
McpFileSymbolSummary ๐Ÿ”’
Compact symbol row that omits empty legacy fields.
McpIndexedRoot ๐Ÿ”’
Role-typed indexed project root discovered by nearest-project routing.
McpLintReport ๐Ÿ”’
MCP response for lint reports.
McpMapReport ๐Ÿ”’
MCP response for compatibility map export.
McpNextCall ๐Ÿ”’
Direct MCP recovery selector.
McpPrivacyPolicy ๐Ÿ”’
Privacy contract for capability/settings payloads.
McpProjectState ๐Ÿ”’
Active ProjectAtlas database and configuration selected for MCP calls.
McpProjectStatePayload ๐Ÿ”’
Stable serialized schema for the selected MCP project.
McpProjectStateResponse ๐Ÿ”’
Agent-facing payload for the selected MCP project.
McpPurposeSetPayload ๐Ÿ”’
Stable serialized schema for an MCP purpose update.
McpPurposeSetResponse ๐Ÿ”’
Agent-facing payload for an MCP purpose update.
McpRepoKey ๐Ÿ”’
Repository-relative path key derived from a typed root/path conversion.
McpRequestCancellationBridge ๐Ÿ”’
Bridge one RMCP request cancellation token into synchronous index work.
McpResolvedRepoPath ๐Ÿ”’
MCP path resolution result with selected-project audit state.
McpScanPolicy ๐Ÿ”’
Scan policy fields relevant before source reads.
McpSelectedProjectCapability ๐Ÿ”’
Selected project identity inside capability/settings payloads.
McpSelectedRoot ๐Ÿ”’
Role-typed selected root for MCP path routing.
McpSessionBrief ๐Ÿ”’
Agent startup brief payload.
McpSessionCapabilities ๐Ÿ”’
MCP-session capability/settings payload.
McpSourceTokenBaselineKey ๐Ÿ”’
One bounded broad-source token baseline keyed to a complete generation.
McpStartupPolicy ๐Ÿ”’
Startup policy fields for MCP sessions.
McpTaskCancelResponse ๐Ÿ”’
Task cancellation response.
McpTaskProgress ๐Ÿ”’
Optional task progress fields.
McpTaskRecord ๐Ÿ”’
One MCP task-progress record.
McpTaskRegistry ๐Ÿ”’
Bounded in-memory registry for MCP task-progress records.
McpTaskStartResponse ๐Ÿ”’
Immediate response for one accepted background indexing task.
McpTaskStatusResponse ๐Ÿ”’
Task status lookup response.
McpTelemetryPolicy ๐Ÿ”’
Telemetry write policy for this MCP process.
McpUsageIntent ๐Ÿ”’
Deferred telemetry payload recorded only after a verified result is accepted.
McpUsageProjectBinding ๐Ÿ”’
Exact root/database/project identity where this MCP process recorded telemetry.
McpUsageProjectRuntime ๐Ÿ”’
Current telemetry identity for one exact selected project binding.
McpUsageRuntime ๐Ÿ”’
Mutable bounded telemetry lifecycles shared by all MCP server clones.
ProjectAtlasMcpServer ๐Ÿ”’
Native ProjectAtlas MCP server backed by the same services as the CLI.

Enumsยง

McpBriefRecommendationKind ๐Ÿ”’
Startup recommendation kinds.
McpCompactRelationResolution ๐Ÿ”’
Resolution facts retained by the compact relation projection.
McpConfigValidation ๐Ÿ”’
Select whether project-state discovery validates configuration content immediately.
McpIndexStatus ๐Ÿ”’
Selected index availability.
McpPathScope ๐Ÿ”’
Absolute path routing scope.
McpPolicyState ๐Ÿ”’
Two-state policy enum serialized for MCP contracts.
McpProjectStatus ๐Ÿ”’
Status values for MCP project selection responses.
McpTaskCancelResult ๐Ÿ”’
Task cancellation outcome.
McpTaskLookupStatus ๐Ÿ”’
Task lookup outcome.
McpTaskOperation ๐Ÿ”’
MCP task operation kind.
McpTaskState ๐Ÿ”’
MCP task lifecycle state.
McpUsageBaseline ๐Ÿ”’
Existing telemetry baseline variants retained across verified-read acceptance.
SymbolRelationStores ๐Ÿ”’
Store ownership selected by the existing relation tool request shape.

Constantsยง

AMBIGUOUS_NEAREST_PROJECT_PATH_ERROR ๐Ÿ”’
Error when lexical and canonical path routing disagree.
COMPACT_SESSION_BRIEF_DEFAULT_LIMIT ๐Ÿ”’
Default number of rows in an explicitly compact startup brief section.
CURRENT_DIR_ALIAS ๐Ÿ”’
Current-directory root alias.
FOLDER_NOT_INSIDE_INDEXED_PROJECT_ERROR ๐Ÿ”’
Error when an absolute MCP folder path has no valid indexed project ancestor.
MCP_BACKGROUND_TASK_SAFE_CEILING ๐Ÿ”’
Maximum background indexing tasks admitted by one MCP server session.
MCP_BRIEF_ARG_COMPACT ๐Ÿ”’
Compact-response argument key used by typed startup recommendations.
MCP_BRIEF_ARG_FILE ๐Ÿ”’
Session-brief argument key for exact repository-relative files.
MCP_BRIEF_ARG_LIMIT ๐Ÿ”’
Session-brief argument key for row limits.
MCP_BRIEF_ARG_PATTERN ๐Ÿ”’
Session-brief argument key for indexed search patterns.
MCP_BRIEF_ARG_PROJECT_PATH ๐Ÿ”’
Session-brief argument key for per-call project roots.
MCP_BRIEF_ARG_TASK ๐Ÿ”’
Session-brief argument key for host-owned purpose-curation tasks.
MCP_BRIEF_ARG_VIEW ๐Ÿ”’
Session-brief argument key for relation view selection.
MCP_BRIEF_REASON_FILESYSTEM_UNTIL_INDEX ๐Ÿ”’
Session-brief reason for filesystem fallback before an index exists.
MCP_BRIEF_REASON_HEALTH_BLOCKERS ๐Ÿ”’
Session-brief reason for health follow-up.
MCP_BRIEF_REASON_NO_FILE_CANDIDATE ๐Ÿ”’
Session-brief reason for normal filesystem orientation in an indexed empty project.
MCP_BRIEF_REASON_PURPOSE_QUEUE ๐Ÿ”’
Session-brief reason for following an actionable purpose-curator handoff.
MCP_BRIEF_REASON_RANKED_FILE_RELATIONS ๐Ÿ”’
Session-brief reason for following truncated graph evidence into detailed relations.
MCP_BRIEF_REASON_RANKED_FILE_SUMMARY ๐Ÿ”’
Session-brief reason for following the selected file into its summary.
MCP_BRIEF_REASON_SEARCH_FALLBACK ๐Ÿ”’
Session-brief reason for searching when ranking found no directly navigable file.
MCP_BRIEF_REASON_SELECTED_INDEX_MISSING ๐Ÿ”’
Session-brief reason for missing selected indexes.
MCP_BRIEF_TARGET_FILESYSTEM_TOOLS ๐Ÿ”’
Session-brief recommendation target for normal filesystem reads.
MCP_CANCELLATION_MONITOR_START_ERROR_PREFIX ๐Ÿ”’
Prefix for cancellation-monitor startup failures.
MCP_CANCELLATION_MONITOR_THREAD_NAME ๐Ÿ”’
Request-local MCP cancellation monitor thread name.
MCP_DEFAULT_CONFIG_SERVER_NAME ๐Ÿ”’
Default MCP config server key.
MCP_ENV_CI ๐Ÿ”’
CI environment variable used by MCP map export safeguards.
MCP_ENV_GITHUB_ACTIONS ๐Ÿ”’
GitHub Actions environment variable used by MCP map export safeguards.
MCP_ERROR_ANALYSIS_VIEW_REQUIRED ๐Ÿ”’
MCP validation error for analysis controls on another relation view.
MCP_ERROR_COMPACT_DETAILED_RELATION_VIEW ๐Ÿ”’
MCP validation error for compact projection on a non-detailed relation view.
MCP_ERROR_COVERAGE_FILTERS_REQUIRE_COVERAGE ๐Ÿ”’
Coverage-filter diagnostic for the default structural-health mode.
MCP_ERROR_COVERAGE_LIMIT_TOO_LARGE_PREFIX ๐Ÿ”’
Invalid coverage limit diagnostic prefix.
MCP_ERROR_COVERAGE_START_INDEX_TOO_LARGE_PREFIX ๐Ÿ”’
Invalid coverage start-index diagnostic prefix.
MCP_ERROR_DETAILED_RELATION_DISAMBIGUATOR ๐Ÿ”’
MCP validation error for symbol disambiguators without a symbol.
MCP_ERROR_DETAILED_RELATION_FILE ๐Ÿ”’
MCP validation error for a detailed request without a file anchor.
MCP_ERROR_DETAILED_RELATION_LIMIT ๐Ÿ”’
MCP validation error for a relation limit outside the service range.
MCP_ERROR_DETAILED_RELATION_QUERY ๐Ÿ”’
MCP validation error for legacy query fields in detailed requests.
MCP_ERROR_DETAILED_RELATION_SYMBOL ๐Ÿ”’
MCP validation error for an empty detailed symbol anchor.
MCP_ERROR_FEDERATED_RELATION_VIEW ๐Ÿ”’
MCP validation error for federation on the legacy relation view.
MCP_ERROR_FOR_PATH_FRAGMENT ๐Ÿ”’
Ambiguous route diagnostic fragment.
MCP_ERROR_GUIDANCE_FRAGMENT ๐Ÿ”’
Ambiguous route diagnostic fragment.
MCP_ERROR_IGNORE_KIND_REQUIRED ๐Ÿ”’
Required ignore kind diagnostic.
MCP_ERROR_IGNORE_KIND_REQUIRED_FOR_ADD ๐Ÿ”’
Required ignore kind diagnostic for mutation tools.
MCP_ERROR_INVALID_HARNESS_PREFIX ๐Ÿ”’
Invalid harness diagnostic prefix.
MCP_ERROR_INVALID_HARNESS_SUFFIX ๐Ÿ”’
Invalid harness diagnostic suffix.
MCP_ERROR_INVALID_IGNORE_KIND_PREFIX ๐Ÿ”’
Invalid ignore kind diagnostic prefix.
MCP_ERROR_INVALID_IGNORE_KIND_SUFFIX ๐Ÿ”’
Invalid ignore kind diagnostic suffix.
MCP_ERROR_INVALID_PURPOSE_LEVEL_PREFIX ๐Ÿ”’
Invalid purpose lint level diagnostic prefix.
MCP_ERROR_INVALID_PURPOSE_LEVEL_SUFFIX ๐Ÿ”’
Invalid purpose lint level diagnostic suffix.
MCP_ERROR_LEXICAL_ROOT_FRAGMENT ๐Ÿ”’
Ambiguous route diagnostic fragment.
MCP_ERROR_RESOLVED_ROOT_FRAGMENT ๐Ÿ”’
Ambiguous route diagnostic fragment.
MCP_ERROR_SERIALIZATION_FALLBACK_PREFIX ๐Ÿ”’
Prefix used only if structured MCP error serialization fails.
MCP_ERROR_SYMBOL_RELATION_VIEW ๐Ÿ”’
MCP validation error for an unsupported relation view.
MCP_ERROR_TRACE_TARGET_FILE_REQUIRED ๐Ÿ”’
MCP validation error for a trace target without its owning file.
MCP_ERROR_TRACE_TARGET_KIND_REQUIRED ๐Ÿ”’
MCP validation error for a symbol trace without a symbol-kind selector.
MCP_ERROR_TRACE_TARGET_REQUIRED ๐Ÿ”’
MCP validation error for symbol disambiguators without a trace symbol.
MCP_ERROR_TRACE_TARGET_SIGNATURE_REQUIRED ๐Ÿ”’
MCP validation error for a symbol trace without a signature selector.
MCP_ERROR_UNSUPPORTED_ANALYSIS_MODE ๐Ÿ”’
MCP validation error for an unsupported closed relation-analysis mode.
MCP_ERROR_UNSUPPORTED_ANALYSIS_VCS ๐Ÿ”’
MCP validation error for an unsupported VCS impact selector.
MCP_ERROR_VCS_BASE_REQUIRED ๐Ÿ”’
MCP validation error for a revision-range selection without its base.
MCP_ERROR_VCS_HEAD_REQUIRED ๐Ÿ”’
MCP validation error for a revision-range selection without its head.
MCP_ERROR_VCS_REVISION_FIELDS ๐Ÿ”’
MCP validation error for revision fields outside revision-range selection.
MCP_EVENT_ATLAS_FILES ๐Ÿ”’
MCP telemetry event for file calls.
MCP_EVENT_ATLAS_FILE_SUMMARY ๐Ÿ”’
MCP telemetry event for file-summary calls.
MCP_EVENT_ATLAS_FOLDERS ๐Ÿ”’
MCP telemetry event for folder calls.
MCP_EVENT_ATLAS_HEALTH ๐Ÿ”’
MCP telemetry event for health calls.
MCP_EVENT_ATLAS_NEXT ๐Ÿ”’
MCP telemetry event for next-step recommendation calls.
MCP_EVENT_ATLAS_OUTLINE ๐Ÿ”’
MCP telemetry event for outline calls.
MCP_EVENT_ATLAS_OVERVIEW ๐Ÿ”’
MCP telemetry event for overview calls.
MCP_EVENT_ATLAS_PURPOSE_QUEUE ๐Ÿ”’
MCP telemetry event for purpose-queue calls.
MCP_EVENT_ATLAS_SEARCH ๐Ÿ”’
MCP telemetry event for search calls.
MCP_EVENT_ATLAS_SLICE ๐Ÿ”’
MCP telemetry event for slice calls.
MCP_EVENT_ATLAS_SYMBOLS ๐Ÿ”’
MCP telemetry event for symbol calls.
MCP_EVENT_ATLAS_SYMBOL_RELATIONS ๐Ÿ”’
MCP telemetry event for symbol-relation calls.
MCP_FILE_SOURCE_STATUS_LIVE ๐Ÿ”’
Default source status omitted from compact file-summary payloads.
MCP_HARNESS_CLAUDE_CODE ๐Ÿ”’
MCP harness token for Claude Code config.
MCP_HARNESS_CLAUDE_CODE_ALIAS ๐Ÿ”’
MCP alternate harness token for Claude Code config.
MCP_HARNESS_CODEX ๐Ÿ”’
MCP harness token for Codex config.
MCP_HARNESS_MCP_JSON ๐Ÿ”’
MCP harness token for standard MCP JSON config.
MCP_HARNESS_MCP_JSON_ALIAS ๐Ÿ”’
MCP alternate harness token for standard MCP JSON config.
MCP_HARNESS_OPENCODE ๐Ÿ”’
MCP harness token for OpenCode config.
MCP_IGNORE_KIND_DIR_NAME ๐Ÿ”’
MCP ignore kind token for directory names.
MCP_IGNORE_KIND_DIR_NAME_ALIAS ๐Ÿ”’
MCP alternate ignore kind token for directory names.
MCP_IGNORE_KIND_PATH_PREFIX ๐Ÿ”’
MCP ignore kind token for path prefixes.
MCP_IGNORE_KIND_PATH_PREFIX_ALIAS ๐Ÿ”’
MCP alternate ignore kind token for path prefixes.
MCP_INDEX_TASK_ID_PREFIX ๐Ÿ”’
Prefix for generated background index task identifiers.
MCP_INDEX_TASK_LIMIT_PREFIX ๐Ÿ”’
Prefix for active background task limit diagnostics.
MCP_INDEX_TASK_LIMIT_SUFFIX ๐Ÿ”’
Suffix for active background task limit diagnostics.
MCP_INDEX_WORKER_NAME_PREFIX ๐Ÿ”’
Prefix for named background index worker threads.
MCP_INDEX_WORKER_PANIC_ERROR ๐Ÿ”’
Terminal diagnostic when a background worker panics.
MCP_INDEX_WORKER_SPAWN_ERROR_PREFIX ๐Ÿ”’
Prefix for background worker spawn failures.
MCP_MAP_SKIPPED_IN_CI_REASON ๐Ÿ”’
Compatibility map skip reason in CI.
MCP_NO_ROOT_PLACEHOLDER ๐Ÿ”’
Placeholder when no routed root is available for a diagnostic.
MCP_PAYLOAD_CHART ๐Ÿ”’
MCP payload key for optional chart strings.
MCP_PAYLOAD_CONFIG ๐Ÿ”’
MCP payload key for effective config reports.
MCP_PAYLOAD_GITIGNORE ๐Ÿ”’
MCP payload key for .gitignore initialization reports.
MCP_PAYLOAD_HEALTH_RESOLUTION ๐Ÿ”’
MCP payload key for health-resolution reports.
MCP_PAYLOAD_IGNORE ๐Ÿ”’
MCP payload key for ignore policy reports.
MCP_PAYLOAD_INIT ๐Ÿ”’
MCP payload key for project initialization reports.
MCP_PAYLOAD_LEGACY_PURPOSE_MIGRATION ๐Ÿ”’
MCP payload key for legacy-purpose migration reports.
MCP_PAYLOAD_LINT ๐Ÿ”’
MCP payload key for lint reports.
MCP_PAYLOAD_MAP ๐Ÿ”’
MCP payload key for compatibility map reports.
MCP_PAYLOAD_MCP_CONFIG ๐Ÿ”’
MCP payload key for generated MCP config reports.
MCP_PAYLOAD_NEXT ๐Ÿ”’
MCP payload key for next-step recommendation reports.
MCP_PAYLOAD_RESET_INDEX ๐Ÿ”’
MCP payload key for reset-index reports.
MCP_PAYLOAD_SCAN ๐Ÿ”’
MCP payload key for scan reports.
MCP_PAYLOAD_SELECTED_PROJECT ๐Ÿ”’
MCP payload key for selected-project audit metadata on routed reads.
MCP_PAYLOAD_SESSION_BRIEF ๐Ÿ”’
MCP payload key for agent startup briefs.
MCP_PAYLOAD_SESSION_CAPABILITIES ๐Ÿ”’
MCP session capability payload key.
MCP_PAYLOAD_SETTINGS ๐Ÿ”’
MCP payload key for settings reports.
MCP_PAYLOAD_SYMBOLS_BUILD ๐Ÿ”’
MCP payload key for symbol-build reports.
MCP_PAYLOAD_SYMBOL_RELATIONS ๐Ÿ”’
MCP payload key for detailed symbol-relation reports.
MCP_PAYLOAD_TASK_CANCEL ๐Ÿ”’
MCP payload key for task cancellation responses.
MCP_PAYLOAD_TASK_START ๐Ÿ”’
MCP payload key for accepted background tasks.
MCP_PAYLOAD_TASK_STATUS ๐Ÿ”’
MCP payload key for task status lookups.
MCP_PAYLOAD_TOKEN_SAVINGS ๐Ÿ”’
MCP payload key for token savings reports.
MCP_PAYLOAD_TOKEN_TRENDS ๐Ÿ”’
MCP payload key for token trend reports.
MCP_PAYLOAD_WATCH ๐Ÿ”’
MCP payload key for watcher reports.
MCP_PROJECT_STATE_LOCK_POISONED ๐Ÿ”’
MCP error lock-poison message.
MCP_PURPOSE_LEVEL_LOW ๐Ÿ”’
MCP purpose lint level token for low strictness.
MCP_PURPOSE_LEVEL_MEDIUM ๐Ÿ”’
MCP purpose lint level token for medium strictness.
MCP_PURPOSE_LEVEL_STRICT ๐Ÿ”’
MCP purpose lint level token for strict mode.
MCP_PURPOSE_TASK_QUEUE ๐Ÿ”’
Default purpose-curation task used by direct queue requests.
MCP_PURPOSE_TASK_SESSION_STARTUP ๐Ÿ”’
Default purpose-curation task used by session startup briefs.
MCP_RELATION_ANALYSIS_MODE_ARCHITECTURE ๐Ÿ”’
Default closed relation-analysis mode.
MCP_RELATION_ANALYSIS_MODE_IMPACT ๐Ÿ”’
VCS impact relation-analysis mode.
MCP_RELATION_ANALYSIS_MODE_TRACE ๐Ÿ”’
Static trace relation-analysis mode.
MCP_RELATION_ANALYSIS_VCS_INDEX ๐Ÿ”’
Staged-index VCS impact selection.
MCP_RELATION_ANALYSIS_VCS_REVISION_RANGE ๐Ÿ”’
Explicit revision-range VCS impact selection.
MCP_RELATION_ANALYSIS_VCS_WORKING_TREE ๐Ÿ”’
Default working-tree VCS impact selection.
MCP_SERVER_INSTRUCTIONS ๐Ÿ”’
Agent-facing MCP server instructions.
MCP_SERVER_NAME ๐Ÿ”’
ProjectAtlas MCP server display name.
MCP_SETTINGS_RESPONSE_LIMIT_PREFIX ๐Ÿ”’
Prefix for an oversized settings-response diagnostic.
MCP_SETTINGS_RESPONSE_LIMIT_SEPARATOR ๐Ÿ”’
Separator for the observed and permitted settings-response byte counts.
MCP_SETTINGS_RESPONSE_LIMIT_SUFFIX ๐Ÿ”’
Suffix for an oversized settings-response diagnostic.
MCP_SETTINGS_RESPONSE_MAX_BYTES ๐Ÿ”’
Hard ceiling for the default agent-facing settings diagnostic.
MCP_SOURCE_TOKEN_BASELINE_LIMIT ๐Ÿ”’
Maximum generation/filter token baselines retained by one MCP process.
MCP_SYMBOL_RELATION_CONFIDENCE_DEFAULT ๐Ÿ”’
Default minimum confidence for detailed MCP symbol-relation requests.
MCP_SYMBOL_RELATION_DIRECTION_DEFAULT ๐Ÿ”’
Default direction for detailed MCP symbol-relation requests.
MCP_SYMBOL_RELATION_RESOLUTION_DEFAULT ๐Ÿ”’
Default resolution filter for detailed MCP symbol-relation requests.
MCP_SYMBOL_RELATION_VIEW_ANALYSIS ๐Ÿ”’
Additive closed analysis view on the existing relation route.
MCP_SYMBOL_RELATION_VIEW_DETAILED ๐Ÿ”’
Additive detailed MCP symbol-relation view name.
MCP_SYMBOL_RELATION_VIEW_LEGACY ๐Ÿ”’
Compatible MCP symbol-relation view name.
MCP_TASK_CONTRACT_ID ๐Ÿ”’
Built-in task id that exposes the task-progress contract itself.
MCP_TASK_ERROR_MAX_CHARS ๐Ÿ”’
Maximum concise task failure text retained in the session registry.
MCP_TASK_PROGRESS_ACCEPTED ๐Ÿ”’
Progress message recorded after task admission.
MCP_TASK_PROGRESS_CANCELED ๐Ÿ”’
Progress message recorded after cooperative cancellation completes.
MCP_TASK_PROGRESS_CANCELLATION_REQUESTED ๐Ÿ”’
Progress message recorded after cancellation is requested.
MCP_TASK_PROGRESS_COMPLETE ๐Ÿ”’
Progress message recorded after successful task completion.
MCP_TASK_PROGRESS_CONTRACT_MESSAGE ๐Ÿ”’
Built-in task-progress contract message.
MCP_TASK_PROGRESS_FAILED ๐Ÿ”’
Progress message recorded after task failure.
MCP_TASK_PROGRESS_RUNNING ๐Ÿ”’
Progress message recorded while task work is active.
MCP_TASK_REGISTRY_CAPACITY ๐Ÿ”’
Bounded MCP task registry capacity.
MCP_TASK_REGISTRY_LOCK_POISONED ๐Ÿ”’
Task-registry synchronization failure diagnostic.
MCP_TELEMETRY_PROJECT_BINDING_LIMIT ๐Ÿ”’
Maximum distinct project bindings whose MCP telemetry can be sealed at shutdown.
MCP_TOOL_ATLAS_CONFIG ๐Ÿ”’
MCP tool name for effective config reports.
MCP_TOOL_ATLAS_FILES ๐Ÿ”’
MCP tool name for file ranking.
MCP_TOOL_ATLAS_FILE_SUMMARY ๐Ÿ”’
MCP tool name for file summaries.
MCP_TOOL_ATLAS_FOLDERS ๐Ÿ”’
MCP tool name for folder ranking.
MCP_TOOL_ATLAS_HEALTH ๐Ÿ”’
MCP tool name for health pages.
MCP_TOOL_ATLAS_HEALTH_RESOLVE ๐Ÿ”’
MCP tool name for health resolutions.
MCP_TOOL_ATLAS_IGNORE_ADD ๐Ÿ”’
MCP tool name for adding manual ignore entries.
MCP_TOOL_ATLAS_IGNORE_INIT_GITIGNORE ๐Ÿ”’
MCP tool name for project .gitignore initialization.
MCP_TOOL_ATLAS_IGNORE_LIST ๐Ÿ”’
MCP tool name for ignore policy reports.
MCP_TOOL_ATLAS_IGNORE_REMOVE ๐Ÿ”’
MCP tool name for removing manual ignore entries.
MCP_TOOL_ATLAS_INIT ๐Ÿ”’
MCP tool name for project initialization.
MCP_TOOL_ATLAS_LINT ๐Ÿ”’
MCP tool name for lint reports.
MCP_TOOL_ATLAS_MAP ๐Ÿ”’
MCP tool name for compatibility map exports.
MCP_TOOL_ATLAS_MCP_CONFIG ๐Ÿ”’
MCP tool name for generated MCP config documents.
MCP_TOOL_ATLAS_NEXT ๐Ÿ”’
MCP tool name for next-step recommendations.
MCP_TOOL_ATLAS_OUTLINE ๐Ÿ”’
MCP tool name for file outlines.
MCP_TOOL_ATLAS_OVERVIEW ๐Ÿ”’
MCP tool name for repository overviews.
MCP_TOOL_ATLAS_PARITY_REPORT ๐Ÿ”’
MCP tool name for parity reports.
MCP_TOOL_ATLAS_PURPOSE_QUEUE ๐Ÿ”’
MCP tool name for purpose queue lookup.
MCP_TOOL_ATLAS_PURPOSE_REVIEW ๐Ÿ”’
MCP tool name for purpose reviews.
MCP_TOOL_ATLAS_PURPOSE_SET ๐Ÿ”’
MCP tool name for purpose updates.
MCP_TOOL_ATLAS_RESET_INDEX ๐Ÿ”’
MCP tool name for runtime index reset.
MCP_TOOL_ATLAS_ROOT ๐Ÿ”’
MCP tool name for root diagnostics.
MCP_TOOL_ATLAS_ROOT_SET ๐Ÿ”’
MCP tool name for binding a project root.
MCP_TOOL_ATLAS_RUNTIME_INFO ๐Ÿ”’
MCP tool name for runtime identity reports.
MCP_TOOL_ATLAS_SCAN ๐Ÿ”’
MCP tool name for repository scans.
MCP_TOOL_ATLAS_SEARCH ๐Ÿ”’
MCP tool name for indexed search.
MCP_TOOL_ATLAS_SESSION_BRIEF ๐Ÿ”’
MCP tool name for compact agent startup briefs.
MCP_TOOL_ATLAS_SETTINGS ๐Ÿ”’
MCP tool name for settings reports.
MCP_TOOL_ATLAS_SET_PROJECT_PATH ๐Ÿ”’
MCP tool name for active project selection.
MCP_TOOL_ATLAS_SLICE ๐Ÿ”’
MCP tool name for source slices.
MCP_TOOL_ATLAS_STRIP_LEGACY_PURPOSE ๐Ÿ”’
MCP tool name for legacy purpose cleanup.
MCP_TOOL_ATLAS_SYMBOLS ๐Ÿ”’
MCP tool name for symbol lookup.
MCP_TOOL_ATLAS_SYMBOLS_BUILD ๐Ÿ”’
MCP tool name for symbol builds.
MCP_TOOL_ATLAS_SYMBOL_RELATIONS ๐Ÿ”’
MCP tool name for symbol relation lookup.
MCP_TOOL_ATLAS_TASK_CANCEL ๐Ÿ”’
MCP tool name for task-progress cancellation.
MCP_TOOL_ATLAS_TASK_STATUS ๐Ÿ”’
MCP tool name for task-progress status lookup.
MCP_TOOL_ATLAS_TOKEN_REPORT ๐Ÿ”’
MCP tool name for token reports.
MCP_TOOL_ATLAS_WATCH_ONCE ๐Ÿ”’
MCP tool name for one-shot watcher refreshes.
MCP_TOOL_ATLAS_WATCH_STATUS ๐Ÿ”’
MCP tool name for watcher status.
NODE_LABEL_FILES ๐Ÿ”’
Node payload label for rendered file rows.
NODE_LABEL_FOLDERS ๐Ÿ”’
Node payload label for rendered folder rows.
OUTSIDE_SELECTED_PROJECT_GUIDANCE ๐Ÿ”’
Recovery guidance when a path escapes the selected ProjectAtlas root.
PATH_NOT_INSIDE_INDEXED_PROJECT_ERROR ๐Ÿ”’
Error when an absolute MCP file path has no valid indexed project ancestor.
PROJECTATLAS_CONFIG_FILE_NAME ๐Ÿ”’
Project-local nested config filename.
PROJECTATLAS_DB_FILE_NAME ๐Ÿ”’
ProjectAtlas SQLite database filename.
PROJECTATLAS_DIR_NAME ๐Ÿ”’
ProjectAtlas local state directory name.
PROJECTATLAS_FLAT_CONFIG_FILE_NAME ๐Ÿ”’
Project-local flat config filename.
REQUIRED_MCP_TOOL_NAMES ๐Ÿ”’
MCP tools required for the agent-first repository-intelligence surface.
SELECTED_ROOT_ASSERTION_GUIDANCE ๐Ÿ”’
Recovery guidance when a path names a subfolder rather than another selected root.
SESSION_BRIEF_DEFAULT_LIMIT ๐Ÿ”’
Default number of rows in an agent startup brief section.
SESSION_BRIEF_MAX_LIMIT ๐Ÿ”’
Maximum number of rows in an agent startup brief section.
SEVERITY_EXPECTED_FINAL_SEPARATOR ๐Ÿ”’
Final separator for diagnostic lists of accepted severity names.
SEVERITY_EXPECTED_SEPARATOR ๐Ÿ”’
Separator for diagnostic lists of accepted severity names.
START_LINE_REQUIRED_ERROR ๐Ÿ”’
Error when a line slice omits its start line.
SYMBOL_DISAMBIGUATOR_WITHOUT_SYMBOL_ERROR ๐Ÿ”’
Error when a symbol disambiguator is supplied without a symbol name.
TOKEN_CHART_THEME_ERROR_PREFIX ๐Ÿ”’
Token chart theme validation error prefix.
TOKEN_CHART_THEME_ERROR_SUFFIX ๐Ÿ”’
Token chart theme validation error suffix.
TOKEN_OVERVIEW_RESULT_VARIANT_MISMATCH ๐Ÿ”’
Internal mismatch when an overview request returns the trends variant.
TOKEN_TRENDS_RESULT_VARIANT_MISMATCH ๐Ÿ”’
Internal mismatch when a trend request returns the overview variant.
TOKEN_TREND_BENCHMARK_ERROR ๐Ÿ”’
Validation error for benchmark evidence on token trend requests.
TOKEN_TREND_WINDOW_ERROR_SUFFIX ๐Ÿ”’
Token trend validation error suffix.
WATCH_STATUS_SCAN_RECOMMENDATION ๐Ÿ”’
Watch-status recommendation when no index exists.

Functionsยง

bounded_task_error ๐Ÿ”’
Retain one concise task failure without letting diagnostics grow unbounded.
compact_file_symbols ๐Ÿ”’
Project nonempty symbol rows into their compact MCP representation.
coverage_query_from_params ๐Ÿ”’
Convert explicit MCP coverage parameters into one typed bounded DB query.
expected_health_severity_names ๐Ÿ”’
Render accepted health severity names for diagnostics.
has_coverage_filters ๐Ÿ”’
Return whether MCP parameters contain coverage-only filters.
health_query_from_params ๐Ÿ”’
Convert MCP health parameters into a DB health query.
is_compact_brief_default_limit ๐Ÿ”’
Return whether a startup row limit is the compact projection default.
is_false ๐Ÿ”’
Return whether a serialized optional fact is false and can be omitted.
is_true ๐Ÿ”’
Return whether a serialized invariant is true and can be omitted.
is_zero_u32 ๐Ÿ”’
Return whether a compact unsigned count is zero.
is_zero_u64 ๐Ÿ”’
Return whether a compact unsigned total is zero.
mcp_tool_route_present ๐Ÿ”’
Return whether the generated RMCP router has a concrete tool route.
mcp_unix_time_ms ๐Ÿ”’
Return current Unix time in milliseconds for MCP task status records.
missing_ancestor_error ๐Ÿ”’
Build the adapter error for an absolute selector without an inspectable ancestor.
nonempty_slice ๐Ÿ”’
Borrow non-empty rows into one optional compact section.
nonempty_str ๐Ÿ”’
Borrow non-empty text into one optional compact field.
parse_health_severity ๐Ÿ”’
Parse an MCP health severity filter.
purpose_queue_scope ๐Ÿ”’
Return the DB scope for MCP purpose queue parameters.
relation_analysis_controls_present ๐Ÿ”’
Return whether any closed analysis-only control was supplied.
relation_analysis_trace_target ๐Ÿ”’
Decode and validate the optional exact trace target.
relation_analysis_vcs ๐Ÿ”’
Decode and validate the optional VCS impact selector.
required_mcp_surface_present ๐Ÿ”’
Return whether the generated RMCP router contains required tool families.
run_mcp_server ๐Ÿ”’
Run the official RMCP stdio server.
task_error_is_canceled ๐Ÿ”’
Recognize cooperative cancellation through each typed adapter error layer.
trimmed_filter ๐Ÿ”’
Return a trimmed non-empty string parameter.