FreeDom

orphans

*Community 12

18 files

cohesion 0.00*

Definition

This community groups 18 file(s) rooted at tools with dominant language py (cohesion 0.00). Central symbols: PD_COLS, PD_INK_DELTA, PD_ROWS, _POSIX_C_SOURCE, _append_probe, _word_reader, ascii_lower, bands. Core file: tools/pngdiff.c (14 symbols). Documented purpose: Author: Gris Iscomeback Email: grisun0[at]proton[dot]me Creation Date: 06/18/2026 License: GPL v3 Description: MCP server to monitor AFL++ fuzzing sessions and.

Files

File	Language	Layer	Symbols	Doc
app.py	py	utility	3	yes
docker-entrypoint.sh	sh	utility	0	no
docker_run.sh	sh	utility	0	yes
install.sh	sh	utility	0	yes
run_freedom.sh	sh	utility	0	yes
tools/fbench.py	py	utility	11	yes
tools/ffgeom.py	py	utility	12	yes
tools/ffq.py	py	utility	1	yes
tools/ffshot.py	py	utility	1	yes
tools/fftime.py	py	utility	1	yes
tools/gen_psl.c	c	utility	8	no
tools/guitime.py	py	utility	3	yes
tools/mutate.py	py	utility	6	yes
tools/pngdiff.c	c	utility	14	no
tools/pngprof.py	py	utility	4	yes
tools/prune.py	py	utility	1	yes
tools/snapshot.py	py	utility	6	yes
tools/snapshot_age.py	py	utility	1	yes

Key Symbols

• read_fuzz_stats (function, app.py:30) def read_fuzz_stats() - Reads the current status of the active AFL++ fuzzing session.
• list_unique_crashes (function, app.py:39) def list_unique_crashes() - Lists all unique crash files generated by the fuzzer that broke the browser.
• run_freedom_headless (function, app.py:47) def run_freedom_headless(payload_path) - Executes the FreeDom browser in headless mode against a specific file input or mutated seed.
• load_baseline (function, tools/fbench.py:53) def load_baseline()
• load_current (function, tools/fbench.py:66) def load_current()
• luma (function, tools/fbench.py:79) def luma(img)
• bands (function, tools/fbench.py:83) def bands(fd, ff, band)
• sbs (function, tools/fbench.py:95) def sbs(name, start, nrows)
• publish_readme (function, tools/fbench.py:114) def publish_readme(name, score) - Rewrite the README picture of name and the score printed beside its label.
• run_timer (function, tools/fbench.py:140) def run_timer(tool, pages, runs) - Runs a timing tool over the pages; returns ({name: median ms}, exit code).
• load_timing_baseline (function, tools/fbench.py:158) def load_timing_baseline()
• publish_timing (function, tools/fbench.py:171) def publish_timing(rows) - Rewrites the README timing table (between the markers) for the README pages timed.
• timing (function, tools/fbench.py:193) def timing(names, runs, readme)
• main (function, tools/fbench.py:227) def main()
• load_rows (function, tools/ffgeom.py:116) def load_rows(path)
• lum (function, tools/ffgeom.py:169) def lum(p)
• _word_reader (function, tools/ffgeom.py:173) def _word_reader(path) - Loads a probe screenshot and returns a function reading 16-bit words from
• lum_at (function, tools/ffgeom.py:181) def lum_at(x, y)
• bit (function, tools/ffgeom.py:206) def bit(grid_row, cell, origin)
• word (function, tools/ffgeom.py:209) def word(grid_row, origin)
• decode (function, tools/ffgeom.py:239) def decode(path)
• _append_probe (function, tools/ffgeom.py:254) def _append_probe(src, script) - Inserts the probe script before </body> (else </html>, else at EOF: many
• probe (function, tools/ffgeom.py:265) def probe(page, selector, out_html)
• height_probe (function, tools/ffgeom.py:279) def height_probe(page, out_html)
• height (function, tools/ffgeom.py:292) def height(path) - Decodes the scrollHeight carried by the #__ffh sentinel: the probe encodes
• main (function, tools/ffgeom.py:301) def main(argv)
• main (function, tools/ffq.py:22) def main()
• main (function, tools/ffshot.py:24) def main()
• main (function, tools/fftime.py:38) def main()
• _POSIX_C_SOURCE (macro, tools/gen_psl.c:15) #define _POSIX_C_SOURCE

Internal vs External Edges

• Internal resolved imports (EXTRACTED): 0
• Cross-boundary resolved imports (EXTRACTED): 0

Connections

• No cross-community bridges recorded. This community is self-contained.

Risks

• [taint high] app.py -> app.py via subprocess (0 hops)
• [taint high] tools/fbench.py -> tools/fbench.py via subprocess (0 hops)
• [taint high] tools/ffgeom.py -> tools/ffgeom.py via subprocess (0 hops)
• [taint high] tools/guitime.py -> tools/guitime.py via subprocess (0 hops)
• [taint high] tools/mutate.py -> tools/mutate.py via subprocess (0 hops)
• [taint medium] tools/snapshot.py -> tools/snapshot.py via urllib.request (0 hops)

Open Questions

• Why do 3 file(s) lack file-level docs (e.g. docker-entrypoint.sh)? What purpose do they serve?
• Is the dangerous import subprocess in app.py still required, or can it be isolated?
• What would break if the most connected file in orphans changed?
• Should orphans be split, given cohesion 0.00?

Sources

• app.py
• docker-entrypoint.sh
• docker_run.sh
• install.sh
• run_freedom.sh
• tools/fbench.py
• tools/ffgeom.py
• tools/ffq.py
• tools/ffshot.py
• tools/fftime.py
• tools/gen_psl.c
• tools/guitime.py
• tools/mutate.py
• tools/pngdiff.c
• tools/pngprof.py
• tools/prune.py
• tools/snapshot.py
• tools/snapshot_age.py

This site is open source. Improve this page.