api-contract

API Contract: $ARGUMENTS

Skill bundle root

Every bundled helper below runs through the skill bundle root, never a bare scripts/… path (the working directory is the user's project, where scripts/ is absent or belongs to someone else):

SKILL_DIR="${MB_SKILLS_ROOT:-${SKILL_DIR:-$HOME/.claude/skills/memory-bank}}"
[ -f "$SKILL_DIR/scripts/_lib.sh" ] || { echo "mb: skill bundle not found at $SKILL_DIR — set MB_SKILLS_ROOT" >&2; exit 2; }

0. Validate arguments

If $ARGUMENTS is empty, stop and ask the user which action to perform (generate, check, test).

1. Stack detection

eval "$(bash "$SKILL_DIR"/scripts/mb-metrics.sh)"

If stack=unknown, ask the user for the framework / language in use.

2. Detect the API type

# OpenAPI / Swagger
find . -name "*.yaml" -o -name "*.yml" 2>/dev/null | xargs grep -l "openapi\|swagger" 2>/dev/null
find . -name "openapi*" -o -name "swagger*" 2>/dev/null

# gRPC / Protobuf
find . -name "*.proto" 2>/dev/null

# GraphQL
find . -name "*.graphql" -o -name "*.gql" 2>/dev/null

# Handler detection across frameworks:
# Go  (gin / echo / chi / net/http)
grep -rn "func.*Handler\|func.*http\.\|r\.GET\|r\.POST\|e\.GET\|e\.POST\|http\.HandleFunc" --include="*.go" . | head -30

# Node.js — Express / Fastify / Nest
grep -rn "app\.\(get\|post\|put\|delete\|patch\)\|router\.\(get\|post\)\|@Get\|@Post" --include="*.ts" --include="*.js" . | head -30

# Python — FastAPI / Flask / Django
grep -rn "@app\.\(get\|post\|put\|delete\)\|@router\.\(get\|post\)\|@app\.route\|path(" --include="*.py" . | head -30

# Java / Kotlin — Spring
grep -rn "@GetMapping\|@PostMapping\|@PutMapping\|@DeleteMapping\|@RequestMapping" --include="*.java" --include="*.kt" . | head -30

# .NET
grep -rn "\[HttpGet\]\|\[HttpPost\]\|\[HttpPut\]\|\[HttpDelete\]\|MapGet\|MapPost" --include="*.cs" . | head -30

# Rust — Axum / Actix / Rocket
grep -rn "\.route(\|#\[get\|#\[post\|#\[put\|#\[delete" --include="*.rs" . | head -30

# Ruby — Rails
grep -rn "resources \|get \|post \|put \|delete " --include="routes.rb" . | head -30