List configured repositories, their paths, and architecture metadata.

Get branch, dirty state, and ahead/behind for every configured repo.

Search code across repos. mode=locations (default) omits line text; mode=context includes context.

List available named tasks for a repository, including metadata and warnings.

Run a configured task in a repository.

Build/test tasks are routed by NPU availability: with NPUs reachable they run on the host (allowed by policy); without NPUs they are re-routed into the sim Docker image for the repo (see _SIM_RUN), or refused with guidance when the repo has no sim image (e.g. PTOAS).

Run an ad-hoc shell command in a repository. Prefer run_task for known tasks or git_log/git_diff/read_file for read-only operations.

When no NPU is reachable, build/test commands (cmake, make, ninja, pip install, pytest, …) are refused — those must run inside the sim Docker images, never on the local repo. Read-only commands are unaffected.

Show the exact command and metadata configured for a named task.

Return the last N commits for a repository as structured data (sha, author, date, message).

Return the git diff for a repository (stat + optional patch). Prefer stat_only=True for orientation.

Read an arbitrary source file from a repository without shelling out.

Return all valid task_type values with one-line descriptions for use with bootstrap_session and route_task.

Return read-first docs, rules, entrypoints, and verify tasks for a compiler workflow.

List available task routes, MCP resources, notes topics, and bootstrap prompts.

Read a workspace document with tier labeling. Optional section extracts a markdown heading.

Explain a stack abstraction: IR/passes/codegen/ISA/runtime or Ascend hardware (AIC, HCCL, etc.).

Search the abstraction index by keyword. Results are ranked by relevance (exact name > name-contains > tag > layer/kind).

Explain a pass in the Default pipeline: order, phase, neighbors, verify tasks.

Structured PR/plan status from status_prs.md (open PRs, blockers, plan cross-index).

Collective-comm feature parity status (merged/planned/gap) from the parity matrix in pypto-3.0-notes/distributed/current_status.md. Read-only -- never writes to the source doc.

Suggest minimal verify tasks for a set of changed file paths.

Returns static_checks (e.g. ["clang-tidy"]) when a changed path is a C/C++ file in a C++ repo — run those before the pytest tasks (see tools/clang_tidy_workflow).

Summarize a pypto-profiling campaign directory (results.json, anomalies).

Full cross-layer trace: stack location + contract triangle + cross-layer verify tasks + active-PR links.

This is the enriched trace. Use trace_in_stack for a lightweight stack-location-only lookup.

Find code entrypoints for a repo and optional area (e.g. pypto, codegen_orch).

Lightweight stack location: matched abstraction card or path-prefix pipeline stage only.

No contract artifacts or PR links. Use trace_contract for the enriched cross-layer trace.

Check knowledge config health: missing paths, stale enriched docs, Ascend corpus, index build time.

Read-only Ascend/CANN environment check: devices, HCCL preload, Docker hints.

Generate markdown handoff for developer NPU verification in a container.

Single-call session bootstrap: route metadata, read_plan, health, program hints.

Generate a bash script for the safe rebase->pre-commit->sim-Docker-tests->squash->push gate workflow.