| name | asstest |
| description | Deep self-test battery, 22 checks across 8 phases. Superset of doctor for full regression sweeps. |
| category | software-development |
Harness Deep Test (asstest)
22 checks in 8 phases. Superset of /doctor: byte-exact round-trips, patch atomicity,
grep semantics, uid-split ownership, git branch ops, HTTP edge cases, and parallel
write races. Use /doctor for a quick pass, this for a full sweep.
When to use
- Before or after harness core / tool changes
- Verifying a new device or environment combination end to end
- Triggered with /asstest in chat or via skill invocation
Procedure
Run the phases in order. Every check PASSes or is recorded as an explicit DEVIATION
(with reason). All fixtures live under asstest/ and are removed in CLEANUP.
PHASE 1: FILE BYTES (checks 1-4)
- Byte-exact round-trip: write_file "asstest/bytes.txt" containing "café 中文 ✅ 🚀🎯\n\ttabbed\n",
read_file it back; content identical modulo the documented single trailing newline.
Astral emoji (4-byte UTF-8) must survive; verify bytes with xxd or python3.
- write_file content intended WITHOUT a trailing newline; verify with
tail -c 3 | xxd
that the stored file ends in exactly one \n (write_file normalization, documented; do
NOT expect the file to stay newline-less).
- read_file a 200KB single-line file (no \n anywhere): must return promptly with the
explicit truncation marker once over 100000 chars, never hang.
- file_info on a 10MB single-line file returns promptly (line_count not from a full scan).
PHASE 2: PATCH SEMANTICS (checks 5-7)
5. PATCH ATOMICITY (regression): write m.txt = "REPLACED\nunique line here\nSECOND HUNK SHOULD FAIL\n".
apply_patch with hunk 1 valid (delete "unique line here") and hunk 2 garbage context that
matches nothing: the tool must FAIL, name hunk 2, and write NOTHING (read_file m.txt to
confirm unchanged). Old bug: hunk 1 was applied, exit success, hunk 2 silently dropped.
6. apply_patch dry_run=true on a valid patch: reports what would change, writes nothing
(file unchanged afterwards).
7. apply_patch on a file whose last line has no trailing newline succeeds on the first try;
a failing patch against such a file mentions the newline condition in the error.
PHASE 3: SEARCH SEMANTICS (checks 8-9)
8. grep is REGEX and CASE-SENSITIVE: "^[A-Z]+" matches only uppercase-led lines,
"alpha|beta" alternation works, "[" returns an Invalid regex error (no crash).
9. search_files matches FILE NAMES only (glob), never file content.
PHASE 4: SHELL + ENVIRONMENT (checks 10-13)
10. which bash git python3 node resolve into the toolchain; python3 --version prints 3.x.
11. env-truth probe: env_status must agree with the shell. It must NOT report python/npm
missing while python3 / node+npm exist (old bug probed the literal name "python").
12. Plain system commands must not die with exit 126 "bad interpreter:
/data/data/com.termux/...". Old bug: dead Termux shim scripts (bin/pm, bin/cmd, bin/am)
shadowed /system binaries because the toolchain bin dir is first on PATH. Probe
pm path com.android.shell (exit 0 or normal "not found" for debuggable check) and which pm cmd am.
13. Shell env audit: env | grep -E "GIT_CONFIG_GLOBAL|GIT_EXEC_PATH|SSL_CERT_FILE|HARNESS_SCRATCH"
lists GIT_CONFIG_GLOBAL; the file it points at exists and contains "[safe]" with
"directory = *" (cat it to confirm).
PHASE 5: OWNERSHIP + GIT (checks 14-16)
14. uid-split ownership: id in the shell prints uid=2000(shell) while the app runs as
u0_aXXX; a file the shell creates inside an app-owned dir is owned by uid 2000. Record
the observed split; DEVIATION only if a tool misreports it.
15. Plain shell git in a shell-created repo: git init -q, git switch -c feat,
git branch all succeed and "detected dubious ownership" does NOT appear (the harness
exports GIT_CONFIG_GLOBAL with [safe] directory=*). If it appears, the check FAILS
(regression); git -c safe.directory='*' ... remains the manual workaround.
16. git_commit auto-configures identity (no "Author identity unknown") and commits.
PHASE 6: NETWORK (checks 17-18)
17. http_request GET https://httpbin.org/status/418 surfaces HTTP 418 cleanly (no hang,
no crash); web_fetch https://httpbin.org/redirect/2 lands on the target page text.
18. web_search returns results; https://example.com fetches with TLS verified (no cert errors).
PHASE 7: PARALLELISM (checks 19-21)
19. Two task() subagents in ONE block, each writing asstest/sub-.txt: both complete,
both files exist, consistent workspace view.
20. Same-path last-writer-wins: two sequential write_file calls to the same path; the file
ends holding exactly the second content (no interleaving or corruption).
21. shell_background: start for i in 1 2 3; do echo tick$i; sleep 1; done; bg_list shows
it running, the log contains tick1/2/3 and no heartbeat noise; bg_kill removes it from
bg_list. Logs carry a per-boot token so a NEW session's proc never appends to an old
session's log; entries started before this app session are marked [prev app session].
PHASE 8: SANDBOX (check 22)
22. SANDBOX BOUNDARIES (must be BLOCKED; SKIP the whole phase when FULL ACCESS mode is on,
record as DEVIATION): write_file "../escape.txt", write_file "asstest/../../esc.txt",
read_file "/etc/hostname", shell echo INJECT > ../escape_me.txt. With Shizuku +
All-Files-Access some of these legitimately succeed: delete any leaked files
(rm -f ../escape_me.txt) and mark DEVIATION, not FAIL.
CLEANUP: delete asstest/ and every fixture created above (including ../escape*.txt leaks);
leave the workspace exactly as you found it.
OUTPUT: a PASS/FAIL table per check (1-22) grouped by phase. For any FAIL, quote the exact
error message and name the regression it maps to.
