nahuaque/snulbug

snulbug mcp share demo local (README 'Demos'): fake MCP upstreams behind a facade; lists tools through facade, allows files.read_file, blocks files.shell_exec, learns policy, amends candidate, candidate allows git.status

cd <host-path> && ls -la && cat README* | head -200
cd <host-path> && sed -n 200,420p README.md; which uv python3; python3 --version
cd <host-path> && export NODE_USE_ENV_PROXY=1; (curl -LsSf https://astral.sh/uv/install.sh | sh) 2>&1 | tail -5; export PATH=$HOME/.local/bin:$PATH; uv --version && uv sync --all-extras --dev 2>&1 | tail -5; ls .venv/bin | grep snulbug
cd <host-path> && .venv/bin/snulbug --help | head -40; .venv/bin/snulbug mcp --help | head -40; grep -n "snulbug mcp" docs/quickstart.md | head -30
cd <host-path> && ls -d .snulbug-lab 2>/dev/null; timeout 300 .venv/bin/snulbug mcp share demo local 2>&1 | tail -30; echo EXIT=$?; ls .snulbug-lab 2>/dev/null
cd <host-path> && mkdir -p .coldpass && cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["<host-path>","env":{}}
EOF
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","operation":"snulbug mcp share demo local (README 'Demos'): fake MCP upstreams behind a facade; lists tools through facade, allows files.read_file, blocks files.shell_exec, learns policy, amends candidate, candidate allows git.status","operation_scope":"Local demo only; no external servers, credentials, or browser needed. Ran end-to-end with exit 0.","steps":["curl -LsSf https://astral.sh/uv/install.sh | sh (README Install: uv)","uv sync --all-extras --dev (README Install: source mode)","uv run snulbug --help equivalent: .venv/bin/snulbug --help","snulbug mcp share demo local (README Demos)"],"deviations":["README 'Install' says 'uv tool install snulbug[discovery]'; used source mode 'uv sync --all-extras --dev' from the checkout instead, as the pinned repo is the source.","uv was not preinstalled; installed via official astral installer into ~/.local/bin, prepended to PATH.","Did not run pytest or lint suites per task instructions."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
<env-var>=<host-path> python3 -I <host-path> --validate; echo EXIT=$?; ls -la .snulbug-lab 2>/dev/null | head -3
cd <host-path> && rm -rf .snulbug-lab && ls -d .snulbug-lab 2>/dev/null; <env-var>=<host-path> python3 -I <host-path> --validate; echo EXIT=$?; pgrep -fa snulbug || echo "no leftover processes"