Skip to content

v0.4.0 — Unified Zero-Friction Entrypoint (one command, one tool)

Choose a tag to compare

@xenups xenups released this 16 Oct 06:22

Highlights & Core Changes

1. Unified MCP Tool (asha) with Deterministic Auto-Routing

  • New #1 recommended entrypoint: the asha tool (registered first; all seven specialized tools stay fully available for backward compatibility).
  • Arguments (all optional, root defaults to "."): cmd, target, branches, base_ref, run_checks.
  • Strict, never-guessing precedence: cmd > branches > target > zero-config.
    • cmd -> asha_dispatch_task with execution_mode="in_place_atomic" and automatic @diff / @diff:<base_ref> scope (seals evidence on pass, clean git reset --hard rollback on failure).
    • branches -> asha_verify_stack(root, branches, base_ref) ordered stack lineage + sealed evidence re-verification.
    • target -> "file.py:Symbol" selectors (single string, list, or comma-separated) routed to single/batch asha_get_surgical_context; anything not in file:symbol form fails closed as TARGET_FORMAT_INVALID.
    • Zero-config -> deterministic asha_status summary; when the tree is clean, automatically runs asha_verify_tip (auto @diff scope, optional run_checks) and seals pre-push tip evidence; a dirty tree reports ready_to_push: false (TIP_DIRTY) with the exact changed scope — never a failure of status reading.

2. Ergonomic One-Command CLI

  • asha / asha PATH: unified zero-config check on the current/target repository.
  • asha --verify [PATH] [--base REF]: in-place tip verification with run_checks=True; seals evidence.
  • asha --stack B1 [B2 ...] [--base REF]: ordered stack verification (STACK_* report codes; unhealthy -> exit 1).
  • asha --context FILE:SYMBOL [FILE:SYMBOL ...]: batch surgical AST context in one shot.
  • asha --exec CMD... [--base REF]: atomic in-place governed command with automatic @diff scope and rollback on failure.
  • asha-mcp PATH: a bare existing directory routes directly to the unified asha tool (deterministic filesystem fact, never a guess).
  • Exit contract: 0 tool ok / 1 tool refused or routed run failed / 2 usage error. Existing CLI contracts (schema-v1 governance evaluation, status, inspect, run --spec, unknown flags exit 2) are unchanged.

3. Quality & Baseline

  • Version bump: 0.3.0 -> 0.4.0 (pyproject.toml, SERVER_INFO, test assertion).
  • New Phase 11 regression suite (tests/test_mcp_phase11.py): zero-config sealing, dirty readiness, target routing + TARGET_FORMAT_INVALID, stack routing, in-place dispatch pass + rollback, precedence, CLI flags, asha-mcp bare-path routing, and backward-compatibility guards for the untouched flows.
  • 0 lint and 0 type issues (ruff, mypy); zero regressions across the existing baseline (919+ tests).
  • Docs: README Quickstart now opens with the 1-command / 1-tool workflow; tool reference gains the asha row; docs/LINUX_SERVER_DEPLOY.md gains the unified-entrypoint runbook.

4. Operations

  • Linux remote server deployment guide (docs/LINUX_SERVER_DEPLOY.md) and node health smoke verification script (scripts/verify_linux_node.py).
  • Active GitHub branch protection enforcing the fail-closed governance gate.