{"id":44225820,"url":"https://github.com/xsscx/research","last_synced_at":"2026-04-29T03:09:38.759Z","repository":{"id":336482267,"uuid":"1149849255","full_name":"xsscx/research","owner":"xsscx","description":"Security Research Tools for ICC Color Profiles","archived":false,"fork":false,"pushed_at":"2026-04-27T01:51:03.000Z","size":87215,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-27T03:35:19.723Z","etag":null,"topics":["analysis","color","debugging","icc","icc-color-profile","measurement","profile","research","security"],"latest_commit_sha":null,"homepage":"https://srd.cx","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xsscx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-04T15:40:17.000Z","updated_at":"2026-04-27T01:51:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xsscx/research","commit_stats":null,"previous_names":["xsscx/research"],"tags_count":136,"template":true,"template_full_name":null,"purl":"pkg:github/xsscx/research","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsscx%2Fresearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsscx%2Fresearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsscx%2Fresearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsscx%2Fresearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xsscx","download_url":"https://codeload.github.com/xsscx/research/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xsscx%2Fresearch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32408521,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T02:37:21.628Z","status":"ssl_error","status_checked_at":"2026-04-29T02:36:50.947Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analysis","color","debugging","icc","icc-color-profile","measurement","profile","research","security"],"created_at":"2026-02-10T05:11:36.363Z","updated_at":"2026-04-29T03:09:38.754Z","avatar_url":"https://github.com/xsscx.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ICC Security Research Monorepo\n\nThis repository collects tooling and research around ICC color profiles,\nincluding analysis, parity validation, fuzzing, unsafe conversion tools, and an\nMCP/Web surface for local or containerized workflows.\n\n## Main Components\n\n| Path | Purpose |\n|------|---------|\n| `iccanalyzer-lite/` | V1 analyzer, regression tests, and the `icctest/` V2 rewrite |\n| `cfl/` | ClusterFuzzLite harnesses and the active patch set for fuzz builds |\n| `colorbleed_tools/` | Unsafe ICC to XML conversion tools for mutation testing |\n| `mcp-server/` | Python MCP server and Web UI |\n| `test-profiles/` | Shared ICC fixtures and small seed inputs |\n| `extended-test-profiles/` | Larger or more specialized crash and regression fixtures |\n\n## Quick Start\n\n```bash\n# iccanalyzer-lite\ncd iccanalyzer-lite \u0026\u0026 ./build.sh\npython3 tests/run_tests.py -v\n\n# icctest\ncd iccanalyzer-lite/icctest \u0026\u0026 ./build.sh\nctest --test-dir build --output-on-failure\n\n# CFL fuzzers\ncd cfl \u0026\u0026 ./build.sh\n\n# colorbleed_tools\ncd colorbleed_tools \u0026\u0026 make setup \u0026\u0026 make test\n\n# mcp-server\ncd mcp-server \u0026\u0026 ./build.sh test\n```\n\n## Windows And WSL\n\n- Prefer WSL for the Bash-first build and fuzzing flows (`build.sh`, `make`,\n  AFL/CFL helpers).\n- The repo now pins text files to `LF` with [`.gitattributes`](.gitattributes)\n  and [`.editorconfig`](.editorconfig) so one checkout can be used from both\n  Windows and WSL without constant line-ending churn.\n- For editor and MCP integration on either platform, use\n  `python mcp-server/launch.py mcp`. For the local Web UI, use\n  `python mcp-server/launch.py web --host 127.0.0.1 --port 8000`.\n- On Windows, `launch.py` auto-delegates into\n  `~/work/codex/current/research` in WSL first, then falls back to\n  `~/work/codex/research` or `~/po/research`. Override the target with\n  `ICC_MCP_WSL_ROOT=/some/wsl/path` or disable delegation with\n  `ICC_MCP_NO_WSL=1`.\n- Windows-native build notes for upstream `iccDEV` live in\n  `docs/iccDEV/shell-helpers/windows.md`.\n\n## Local macOS arm64\n\n- For Apple Silicon host setup, use\n  `docs/LOCAL_MACOS_ARM64_ONBOARDING.md`.\n- Treat macOS as a host for the Linux devcontainer or container workflow.\n  The top-level research repo and the native analysis tools remain Linux-first.\n- For editor and MCP integration, use `python mcp-server/launch.py mcp` or\n  `python mcp-server/launch.py web --host 127.0.0.1 --port 8000`.\n\n## Documentation\n\n- Start with `docs/INDEX.md` for task-based navigation.\n- Use `docs/README.md` for the directory map.\n- Use `docs/Testing/README.md` for test scripts, fixtures, and saved reports.\n- Use `docs/iccDEV/Tools/README.md` for the upstream tool catalog.\n- Use `docs/analysis/ICCANALYZER_PARITY_AND_MCP_RELEASE_STATUS_2026-03-29.md`\n  for the saved parity and release checkpoint.\n\n## MCP and Web UI\n\nFor stdio configuration, Docker usage, upload flow, and API details, see\n`mcp-server/README.md`.\n\n## Notes\n\n- Vendor mirrors and archived experiment trees should be treated as read-only\n  unless a task explicitly targets them.\n- Prefer dated reports for volatile counts or saved outcomes; this README stays\n  intentionally high level.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxsscx%2Fresearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxsscx%2Fresearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxsscx%2Fresearch/lists"}