Skip to content

docs(readme): document Scheduled Research usage#288

Merged
warren618 merged 1 commit into
mainfrom
docs/scheduled-research-readme
Jun 22, 2026
Merged

docs(readme): document Scheduled Research usage#288
warren618 merged 1 commit into
mainfrom
docs/scheduled-research-readme

Conversation

@warren618

Copy link
Copy Markdown
Collaborator

Summary

The scheduled-research feature (#254, shipped in #278) had no user-facing docs, so users couldn't tell how to drive it — see #254 where the original requester asked "how to use this?".

This adds a concise Scheduled research subsection to the API Server section in all 5 READMEs (en/zh/ja/ko/ar), plus the three /scheduled-runs rows in the endpoint table.

What's documented

  • VIBE_TRADING_ENABLE_SCHEDULER=1 to start the background executor (off by default) — verified at agent/api_server.py:634 (@app.on_event("startup")).
  • schedule format: bare integer = interval in milliseconds, or a 5-field cron — verified in agent/src/scheduled_research/models.py:validate_schedule.
  • create / list / cancel via POST / GET / DELETE /scheduled-runs curl examples — verified against the endpoint handlers in agent/api_server.py.
  • Bearer auth note for API_AUTH_KEY deployments; jobs persist under ~/.vibe-trading/.

Test Plan

  • Code-fence balance checked in all 5 files (even fence counts)
  • Same 26-line addition mirrored across en/zh/ja/ko/ar (table rows + subsection)
  • No code changes — docs only

The scheduled-research feature (#254/#278) shipped without user-facing
docs, so users couldn't tell how to drive it. Add a "Scheduled research"
subsection to the API Server section plus the three /scheduled-runs
endpoint rows in the endpoint table, in en/zh/ja/ko/ar: the
VIBE_TRADING_ENABLE_SCHEDULER flag, the interval-ms / 5-field-cron
schedule format, and create/list/cancel curl examples.
@warren618 warren618 merged commit 9d488ec into main Jun 22, 2026
1 check passed
@warren618 warren618 deleted the docs/scheduled-research-readme branch June 22, 2026 14:22
warren618 added a commit that referenced this pull request Jun 22, 2026
Live-authorize OAuth fix (#281, closes #259), Alpha Zoo headline
double-count fix (#287, closes #286), and scheduled-research usage
docs (#288). Rolls the 0.1.10 (06-19) entry into the Earlier-news
fold to keep three entries visible.
warren618 added a commit that referenced this pull request Jun 23, 2026
…Bridge / Research Delivery) (#297)

Mark Research Autopilot (Phase 1-3, #260/#267), the local Data Bridge loader (#252), and the scheduled-research scheduler/executor (#272/#278/#288) as shipped in the Roadmap status column across all 5 READMEs. Feature descriptions left intact so SQL connectors and multi-channel outbound delivery still read as pending. Closes #294.
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