Asoba Asoba Open Source

Built-in Tools & Safety Checkers

Nehanda CLI ships with 21 built-in tools, 4 declarative safety checkers, a branch coverage collector, and an extensible MCP client. Tool availability is strictly governed by the active phase of the 11-phase SDLC state machine.


SDLC Phase Availability Matrix

Phase Read, Glob, Grep Write, Edit, NotebookEdit Bash WebFetch, WebSearch Notes
idle Allowed Ask / Gated Refused if mutating Allowed Open research
explore Allowed Denied Denied Allowed Strictly read-only exploration
diagnose Allowed Denied Denied Allowed Evidence synthesis
create_issue Allowed .issues/ only Denied Allowed Creates task record
create_tests Allowed Test files only Allowed (Test runner) Allowed Authors Given/When/Then test
planning Denied Denied Denied Denied Zero tools; structured Plan Triad
implement Allowed Allowed Allowed Allowed Minimal production edits
verify Allowed Denied Allowed (Test runner) Allowed Original unchanged test run
safety Allowed Denied Allowed (Checkers) Allowed 3 Checkers + $\ge 70\%$ coverage
confirm_fix Allowed Denied Denied Allowed Human review
done Allowed Denied Allowed (Git commit) Allowed Authorized commit & push

File Operations

Read

Reads file contents with line numbers. Supports pagination via offset and limit.

Write

Creates or completely overwrites a file.

Edit

Targeted find-and-replace text modifications.


Discovery & Codebase Navigation

Glob

Fast directory tree walking matching glob patterns (**/*.mjs, src/**/*.ts). Skips node_modules, .git, .issues, and build caches.

Grep

Regular expression content search across files.


Shell Execution & OS Sandbox

Bash

Executes commands in a subprocess via /bin/bash -c.


Web Access

WebFetch

Fetches remote web content or API endpoints (capped at 1 MB, 30s timeout).

WebSearch

Web search via DuckDuckGo Lite. Returns top results with titles, URLs, and snippets.


User Interaction & Tasks

AskUserQuestion

Pauses execution to ask the human operator a clarification question. (Auto-responds (no response) in headless pipe mode).

Brief

Displays an informational markdown notice in the TUI without injecting into the assistant’s context history.

TodoWrite

Manages task checklists (id, title, status) and triggers TaskCreated or TaskCompleted event hooks.


Mandatory Safety Checkers & Branch Coverage

In the safety phase, the model cannot advance to confirm_fix until all three mandatory safety checkers pass with exit code 0 and measured branch coverage meets the threshold.

1. JsSafetyChecker

2. ShellSafetyChecker

3. PythonSafetyChecker

4. Branch Coverage Collector