Skip to content

v0.1.0

Choose a tag to compare

View all tags
@VKambulov VKambulov released this 15 Jun 13:26
· 75 commits to main since this release
v0.1.0
fdb7349

Research Mode v0.1.0

English

First public release of research-mode, an OpenClaw skill for durable background research through OpenClaw cron.

research-mode is designed for research tasks that should not live inside one long chat turn. It stores task state on disk, runs bounded worker iterations, keeps intermediate artifacts inspectable, and separates result preparation from final delivery through an explicit review step.

Highlights

  • Durable background research driven by OpenClaw cron.
  • Local task state with state.json, run logs, artifacts, and task playbooks.
  • Lease-aware begin / finish lifecycle for bounded worker turns.
  • Control commands for pause, resume, stop, reopen, request-changes, and approve.
  • Review-gated finalization: awaiting_review is separate from actual delivery.
  • Structured finalization contract through result.finalization.
  • Lightweight inspection for Markdown and XLSX candidate deliverables.
  • Operator surfaces: summary, status, task-playbook.md, and runs.tsv.
  • operator_next_action explains the next expected step for review, rework, intervention, or continuation.
  • Bilingual README, architecture reference, troubleshooting guide, release procedure, security notes, and agent maintenance notes.
  • GitHub Actions CI runs the full release gate and Bandit security smoke scan.

Installation

Clone the repository into the skills directory of an OpenClaw installation:

git clone https://github.com/VKambulov/research-mode.git "$OPENCLAW_SKILLS_DIR/research-mode"
openclaw skills check

Release Verification

The release was checked with:

clean clone check passed
docs smoke passed
ruff passed
release smoke passed
pyright 0 errors
selftest 243/243
pytest 243 passed
bandit findings: none
GitHub Actions CI passed

Known Limitations

  • The skill depends on OpenClaw cron and is not a standalone Python daemon, hosted service, or general-purpose research library.
  • Task-local Python packages are supported, but there is no lockfile or package allowlist policy yet.
  • Artifact inspection is lightweight and structural; it is not a full domain-specific quality audit.

License

Apache License, Version 2.0.

Русский

Первый публичный релиз research-mode — OpenClaw skill для длительных фоновых исследований через OpenClaw cron.

research-mode предназначен для исследовательских задач, которые не должны жить внутри одного длинного сообщения в чате. Он хранит состояние задачи на диске, запускает ограниченные рабочие итерации, сохраняет проверяемые артефакты и отделяет подготовку результата от фактической выдачи через явный этап ревью.

Главное

  • Длительные фоновые исследования через OpenClaw cron.
  • Локальное состояние задачи: state.json, журналы запусков, артефакты и task-playbook.md.
  • Жизненный цикл begin / finish с рабочей блокировкой.
  • Команды управления: pause, resume, stop, reopen, request-changes, approve.
  • Проверка результата перед выдачей: awaiting_review отделён от фактической доставки.
  • Структурированный контракт финальной проверки через result.finalization.
  • Лёгкая проверка кандидатных артефактов Markdown и XLSX.
  • Поверхности оператора: summary, status, task-playbook.md, runs.tsv.
  • operator_next_action показывает следующий шаг: ревью, доработка, вмешательство оператора или продолжение исследования.
  • README, архитектура, troubleshooting, процедура релиза, security notes и agent maintenance notes доступны на русском и английском.
  • GitHub Actions CI запускает полный release gate и Bandit security smoke scan.

Установка

Клонировать репозиторий в директорию skills конкретной OpenClaw-инсталляции:

git clone https://github.com/VKambulov/research-mode.git "$OPENCLAW_SKILLS_DIR/research-mode"
openclaw skills check

Проверки релиза

Перед публикацией были выполнены:

clean clone check passed
docs smoke passed
ruff passed
release smoke passed
pyright 0 errors
selftest 243/243
pytest 243 passed
bandit findings: none
GitHub Actions CI passed

Известные ограничения

  • Skill завязан на OpenClaw cron и не является самостоятельным Python-демоном, размещённым сервисом или универсальной библиотекой для исследований.
  • Пакеты Python, локальные для задачи, поддерживаются, но lockfile или allowlist policy пока нет.
  • Проверка артефактов структурная и лёгкая; это не полноценный доменный аудит качества.

Лицензия

Apache License, Version 2.0.

Full Changelog: https://github.com/VKambulov/research-mode/commits/v0.1.0

Assets 2
Loading