{"id":50733738,"url":"https://github.com/synapt-dev/runner","last_synced_at":"2026-06-10T11:31:05.832Z","repository":{"id":363068836,"uuid":"1261547771","full_name":"synapt-dev/runner","owner":"synapt-dev","description":"Shared OSS research-runner kernel for synapt — terminal RunRecord, hashing, gates, spans, Modal binding, artifacts, wave, prereg.","archived":false,"fork":false,"pushed_at":"2026-06-07T10:17:56.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T10:21:36.703Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/synapt-dev.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":null,"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":null,"dco":null,"cla":null}},"created_at":"2026-06-06T20:53:24.000Z","updated_at":"2026-06-07T10:17:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/synapt-dev/runner","commit_stats":null,"previous_names":["synapt-dev/runner"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/synapt-dev/runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/synapt-dev%2Frunner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/synapt-dev%2Frunner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/synapt-dev%2Frunner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/synapt-dev%2Frunner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/synapt-dev","download_url":"https://codeload.github.com/synapt-dev/runner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/synapt-dev%2Frunner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34151271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-06-10T11:31:05.749Z","updated_at":"2026-06-10T11:31:05.814Z","avatar_url":"https://github.com/synapt-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# synapt.runner\n\nShared OSS research-runner kernel for Synapt, distributed as `synapt-runner`\nwith import path `synapt.runner`.\n\nThis repository is the Phase 2 extraction of the runner prototype from\n`synapt-dev/config`. It is publish-readiness staged, but no PyPI release is\nauthorized until Layne ratifies the first release.\n\n## Scope\n\nThe kernel contains generic research-runner infrastructure that can be reused by\n`vorn-mat` first, `research/vorn-active-eviction` second, and later\n`active-compression` if the surface proves stable:\n\n- terminal run records with success, runtime-failure, and capacity-missing\n  invariants\n- canonical JSON, SHA-256, and deterministic seed helpers\n- pre-execution gates that fail closed before model generation\n- stable-unit span delete and mask rendering\n- Modal runtime metadata, GPU cost rates, and dashboard-cost reconciliation\n- distinct cost surfaces for per-row model generation cost and Modal wall-clock\n  app billing\n- JSONL/local artifact sinks and markdown summary hooks\n- wave fanout with per-cell failure capture\n- preregistration method/version gates\n\nThe kernel intentionally does not include SEMU primitives, vorn scoring,\nfixture loaders, selector policies, benchmark scoring, product claims, or model\nexecution code. Those remain project-specific.\n\n## Cost Surfaces\n\nRunner artifacts keep two cost surfaces separate:\n\n- `GenerationCostSurface` is row-scoped model generation cost. It may carry\n  model id, token counts, source, and modeled row cost.\n- `ModalWallClockCostSurface` is app/runtime scoped Modal billing. It may carry\n  runtime seconds, app/call ids, GPU, and dashboard reconciliation.\n\nDo not collapse Modal wall-clock cost into a per-row generation field. Consumers\nthat need per-row estimates should allocate or model that explicitly and record\nthe allocation source.\n\n## Package Shape\n\nThe package shape is:\n\n- distribution: `synapt-runner`\n- import path: `synapt.runner`\n- license: MIT\n- namespace: PEP 420 implicit `synapt` namespace\n\nThere is no `synapt/__init__.py` by design. This allows the future package to\ncoexist with the existing `synapt` namespace without forcing a shared release\nunit.\n\nCoexistence verification is part of the release gate: install `synapt` and\n`synapt-runner` into the same environment, then import `synapt.recall` and\n`synapt.runner` without mutating `synapt.__path__`.\n\n## Run Tests\n\n```bash\npython -m pytest\n```\n\n## Release Gate\n\nDo not publish to PyPI from this repository until Layne explicitly ratifies the\nfirst `synapt-runner` release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsynapt-dev%2Frunner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsynapt-dev%2Frunner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsynapt-dev%2Frunner/lists"}