Skip to content

fix(atlas): make graph init required and independent of the atlas binary#113

Merged
Aayam Bansal (aayambansal) merged 1 commit into
mainfrom
fix/atlas-init-prompt
Jul 6, 2026
Merged

fix(atlas): make graph init required and independent of the atlas binary#113
Aayam Bansal (aayambansal) merged 1 commit into
mainfrom
fix/atlas-init-prompt

Conversation

@aayambansal

Copy link
Copy Markdown
Member

The dominant root cause of "Atlas doesn't create the graph."

Problem

The research prompt told the agent, at the start of a task:

  1. Run atlas doctor; if it fails, skip Atlas silently.
  2. Run openscience project init (the actual find-or-create).

A model reads "if doctor fails, skip Atlas" as skip step 2 as well. But openscience project init is the graph-create and it runs entirely off the managed session — it does not touch the atlas binary at all. The binary is only present when the launcher's npm i -g @synsci/atlas ran; install channels that skip the wizard have no atlas, so atlas doctor fails → the agent skips the whole block → no graph is ever created, even though a direct openscience project init would have succeeded. The step was also purely advisory (no BLOCKING/REQUIRED language), so it got skipped on short tasks too.

Fix

Reorder and decouple:

  • Step 1 — openscience project init, REQUIRED, run even if atlas is unavailable. Only skip Atlas when init itself prints project_id: null with an error kind, and then relay the matching fix (unauthenticated/plan/unreachable).
  • Step 2 — atlas doctor + nodes:list, optional/best-effort for loading prior graph state. A failed doctor no longer undoes step 1's creation.

Prompt-only change; no code paths altered. Full backend suite (922 tests) green; no test snapshots research.txt.

The dominant reason a research session never created an Atlas graph. The
prompt told the agent to run 'atlas doctor' FIRST and, if it failed, to
'skip Atlas silently' — which a model reads as skipping step 2
('openscience project init') too. But project init is the actual
find-or-create and it runs entirely off the managed session, independent
of the atlas binary. Install channels that skip the launcher's
'npm i -g @synsci/atlas' have no atlas binary, so 'atlas doctor' fails
and the whole Atlas setup (including the working init) was suppressed.

Reorder and decouple: step 1 is 'openscience project init' — REQUIRED,
run it even if atlas is unavailable, and only skip Atlas when init itself
returns project_id:null with an error kind (relaying the actionable fix).
'atlas doctor' + nodes:list becomes an optional step 2 for loading prior
graph state, which no longer gates graph creation.
@vercel

vercel Bot commented Jul 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
openscience Ready Ready Preview, Comment Jul 6, 2026 3:57pm

Request Review

@aayambansal Aayam Bansal (aayambansal) merged commit c503ab6 into main Jul 6, 2026
12 checks passed
@aayambansal Aayam Bansal (aayambansal) deleted the fix/atlas-init-prompt branch July 6, 2026 15:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant