{"id":50155739,"url":"https://github.com/alias8818/enoch-agentic-research-system","last_synced_at":"2026-06-02T16:00:38.523Z","repository":{"id":354632469,"uuid":"1224037373","full_name":"alias8818/enoch-agentic-research-system","owner":"alias8818","description":"Agentic research control plane: queue state, worker preflight, wake-gated execution, evidence sync, dashboard, alerts, and AI-generated paper packaging.","archived":false,"fork":false,"pushed_at":"2026-05-31T03:18:22.000Z","size":14347,"stargazers_count":15,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-31T03:19:13.712Z","etag":null,"topics":["agentic-ai","agentic-research","control-plane","enoch","langgraph","local-ai","research-automation","wake-gate"],"latest_commit_sha":null,"homepage":"https://alias8818.github.io/enoch-agentic-research-system/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alias8818.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-28T22:41:39.000Z","updated_at":"2026-05-31T03:18:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alias8818/enoch-agentic-research-system","commit_stats":null,"previous_names":["alias8818/enoch-agentic-research-system"],"tags_count":111,"template":false,"template_full_name":null,"purl":"pkg:github/alias8818/enoch-agentic-research-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alias8818%2Fenoch-agentic-research-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alias8818%2Fenoch-agentic-research-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alias8818%2Fenoch-agentic-research-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alias8818%2Fenoch-agentic-research-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alias8818","download_url":"https://codeload.github.com/alias8818/enoch-agentic-research-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alias8818%2Fenoch-agentic-research-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33829346,"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-02T02:00:07.132Z","response_time":109,"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":["agentic-ai","agentic-research","control-plane","enoch","langgraph","local-ai","research-automation","wake-gate"],"created_at":"2026-05-24T11:04:11.144Z","updated_at":"2026-06-02T16:00:38.274Z","avatar_url":"https://github.com/alias8818.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Enoch Agentic Research System\n\n![Enoch — Agentic Research Control Plane](site/assets/social-card.svg)\n\nEnoch Control Plane is an agentic research control plane: it queues ideas, gates dispatch, supervises local AI runs, preserves evidence, and packages AI-generated research artifacts with provenance instead of pretending autonomous work is just a script.\n\n## The problem\n\nLong-running autonomous AI work fails in ways ordinary scripts do not:\n\n- child processes continue after an agent session appears idle;\n- GPU workers can still be active when queue state says no work is running;\n- queues become stale or disagree across sources;\n- evidence scatters across machines and run folders;\n- generated reports overstate results when claim boundaries aren't preserved.\n\nEnoch Control Plane treats those as control-plane problems, not model problems. It uses process tracking, CPU/GPU quiet-window telemetry, idempotent APIs, stale-state reconciliation, a professional operator dashboard, evidence bundles, and claim ledgers to make autonomous work observable and auditable.\n\n\u003e Agentic AI systems need control planes. A model can propose and execute work, but a separate system should decide what is queued, what is safe to dispatch, whether work is actually done, and what evidence supports the final artifact.\n\n## How it works\n\n```text\nResearch Facility source scan\n  -\u003e generated research candidates\n  -\u003e dedupe / score / admission ledger\n  -\u003e local Postgres/control-plane ideas workbench\n  -\u003e queue candidate\n  -\u003e enoch-core control plane\n  -\u003e worker preflight and dispatch safety checks\n  -\u003e GB10 worker gate\n  -\u003e agent run with process + telemetry supervision\n  -\u003e evidence sync\n  -\u003e AI-generated research artifact\n  -\u003e corpus packaging/provenance lint\n```\n\nThe repository contains the execution/control-plane layer and supporting docs. Historical notes describe earlier migration experiments, but this is not a workflow-export repository and does not ship workflow-tool configurations.\n\nFor the canonical current host, storage, worker, decision-artifact, automation,\nand compatibility boundaries, see\n[`docs/current-runtime-snapshot.md`](docs/current-runtime-snapshot.md).\n\n## Main components\n\n- **Control plane API** — queue state, project state, publication automation/finalization state, pause/maintenance controls, and dispatch decisions; built with FastAPI and LangGraph-era graph boundaries.\n- **Worker gate** — proves a run is actually done, not just agent-session-closed: process-tree tracking and CPU/GPU quiet-window telemetry sustained over a configurable window. Older code/config names may still say `wake_gate`; treat that as compatibility naming.\n- **Worker preflight** — authenticated health checks against the worker before dispatching new work, so dispatch fails early rather than silently.\n- **Single-lane safety** — prevents overlapping GPU-heavy work on constrained local hardware; the control plane holds the lock, not the dispatch script.\n- **Evidence sync** — copies run notes, metrics, result summaries, evidence bundles, and claim ledgers from worker projects into the control plane before artifact generation begins.\n- **Artifact writer** — generates publication-style Markdown reports from evidence context while preserving uncertainty and provenance; does not free-float against raw model output.\n- **Packaging/provenance checks** — scan generated reports for placeholder citations, missing provenance, and missing evidence artifacts before they enter the corpus; they do not validate scientific correctness or peer review.\n\n## Generated research artifacts\n\nThe reports produced by Enoch runs are AI-generated research artifacts, not human-authored or peer-reviewed papers. They are built from run notes, evidence bundles, claim ledgers, and reproducibility traces.\n\n\u003e The maintainer releases the corpus for inspection and critique but does not claim personal authorship of the generated papers, arguments, or prose.\n\nSee [`docs/release/authorship-and-provenance.md`](docs/release/authorship-and-provenance.md) for the full framing and recommended citation language.\n\n[Enoch Docs](https://solo-09d10f60.mintlify.app/) contains source-grounded operator and reviewer documentation for the system, corpus, deployment path, and release boundaries.\n\nThe docs source lives in [`alias8818/enoch-docs`](https://github.com/alias8818/enoch-docs). Bounded useful or scale-blocked no-paper leads live separately in [`alias8818/enoch-promising-signals`](https://github.com/alias8818/enoch-promising-signals); those records are not validated papers and are not part of the paper corpus.\n\n## Runtime and upstream tooling\n\nEnoch Control Plane is the project-specific control plane and release package. It runs agent work through Codex-native automation using the Codex CLI as the worker execution substrate. Generated research artifacts are produced by Enoch runs and the artifact writer.\n\n## Idea intake\n\nIdeas are sourced through the Research Facility, a separate auditable lane for source scanning, candidate generation, dedupe/history comparison, novelty/feasibility/accessibility scoring, and admission decisions. A generated candidate is not queued work until an admission row explains why it was promoted.\n\nThe current production runtime stores the intake and queue ledgers in local Postgres behind the Enoch control plane on `enoch-core`. Legacy Notion IDs/URLs, when present, are historical provenance only and are not runtime authority. Older `supabase_*` config names remain compatibility names for the Postgres adapter and historical migration scripts; do not describe Supabase Cloud as the active production database.\n\nSee [`docs/idea-intake-workflow.md`](docs/idea-intake-workflow.md) and [`docs/research-facility.md`](docs/research-facility.md).\n\n## Getting started\n\nFor a local developer smoke test, start with [`docs/quickstart.md`](docs/quickstart.md).\n\nFor a full deployment (control VM, worker machine, systemd service, dashboard/API smoke tests, optional Pushover alerts, dispatch checks, and paper-writer settings), see [`docs/deployment-guide.md`](docs/deployment-guide.md).\n\nFor individual config fields, start from `config.example.json` and see [`docs/configuration-reference.md`](docs/configuration-reference.md). Required values:\n\n- control API bearer token\n- completion callback URL/token\n- project root and dispatch script path\n- worker URL/token\n- optional notification and paper-writer provider settings\n\nNever commit live config files or credentials.\n\n## Development\n\n```bash\nuv run pytest -q\npython scripts/validate_versioning.py\npython3 scripts/validate_runtime_snapshot_links.py\npython3 scripts/validate_runtime_deploy.py --source . --runtime /opt/enoch-control-plane --expected-commit HEAD --summary-only\n```\n\n## Versioning and release notes\n\nThe runtime follows semantic versioning. Keep `VERSION`, `pyproject.toml`, and [`CHANGELOG.md`](CHANGELOG.md) in sync for every release. See [`docs/release/release-plan.md`](docs/release/release-plan.md).\n\n## Documentation\n\n- [Enoch Docs](https://solo-09d10f60.mintlify.app/) — hosted source-grounded docs for operators, contributors, and reviewers ([source](https://github.com/alias8818/enoch-docs))\n\n**Using Enoch:**\n- [`docs/current-runtime-snapshot.md`](docs/current-runtime-snapshot.md) — canonical current runtime facts and compatibility boundaries\n- [`docs/quickstart.md`](docs/quickstart.md) — local clone-to-dashboard smoke test\n- [`docs/deployment-guide.md`](docs/deployment-guide.md) — full deployment guide\n- [`docs/configuration-reference.md`](docs/configuration-reference.md) — config field reference\n- [`docs/operator-runbook.md`](docs/operator-runbook.md) — long-haul readiness, pause/resume, callbacks, and paper-gate checks\n\n**Operator dashboard (V2):**\n- [`docs/dashboard-v2-deploy.md`](docs/dashboard-v2-deploy.md) — build, rsync to `enoch-core.exe.xyz`, restart, and post-deploy smoke\n- [`docs/dashboard-v2-todo-2026-05-21.md`](docs/dashboard-v2-todo-2026-05-21.md) — P0–P7 checklist and parking lot\n- [`docs/dashboard-redesign-plan.md`](docs/dashboard-redesign-plan.md) — IA contract and operator-question-first rules\n- [`docs/system-workflow.md`](docs/system-workflow.md) — architecture and control-plane boundaries\n- [`docs/state-model.md`](docs/state-model.md) — operator lane vocabulary and raw-state/detail-stage boundaries\n- [`docs/state-transition-map.md`](docs/state-transition-map.md) — Idea -\u003e Queue -\u003e Run -\u003e Decision -\u003e Paper -\u003e Publication -\u003e Corpus lifecycle map\n- [`docs/state-simplification-todo.md`](docs/state-simplification-todo.md) — next-phase state/ledger simplification backlog\n- [`docs/idea-intake-workflow.md`](docs/idea-intake-workflow.md) — Research Facility scouting, control-plane ideas, and queue handoff\n- [`docs/research-facility.md`](docs/research-facility.md) — source/candidate/admission/lineage ledgers and admission guardrails\n- [`docs/promising-signals-export.md`](docs/promising-signals-export.md) — public companion export lane for bounded useful/promising no-paper signals.\n\n**Release context:**\n- [`CHANGELOG.md`](CHANGELOG.md) — runtime version history and compatibility notes\n- [`docs/release/authorship-and-provenance.md`](docs/release/authorship-and-provenance.md) — how generated reports should be framed\n- [`docs/featured-paper-selection.md`](docs/featured-paper-selection.md) — rationale for the launch highlight set\n- [`docs/outreach/launch-announcement.md`](docs/outreach/launch-announcement.md) — draft launch copy and repo descriptions\n- [`docs/launch-checklist.md`](docs/launch-checklist.md) — public launch checklist\n- [`docs/launch-todo.md`](docs/launch-todo.md) — remaining public-release gates\n- [`docs/historical/`](docs/historical/) — historical migration notes retained for engineering context only\n- [`site/`](site/) — static launch site\n\n## Security\n\nBefore publishing or deploying changes, run secret scans and tests. See [`SECURITY.md`](SECURITY.md).\n\n## License\n\nApache License 2.0. See [`LICENSE`](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falias8818%2Fenoch-agentic-research-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falias8818%2Fenoch-agentic-research-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falias8818%2Fenoch-agentic-research-system/lists"}