Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.
JavaScript agent-collaborationagent-harnessagent-orchestrationagent-teamagent-workflowai-assistantai-automationai-employeeai-productivityai-teamai-workflowautonomous-agentsclaude-code-guiclaude-coworkdesktop-agentlocal-firstmulti-agentmulti-agent-systemself-evolving-agentstask-automation
"""Checkpoint protocol for pytest; keeps module/session fixtures within a shard."""
import json
import logging
import os
import signal
from pathlib import Path
import pytest
def pytest_addoption(parser):
parser.addoption('--orkas-checkpoint-shard', default='1/1')
class Checkpoint:
def __init__(self, config):
self.config = config
self.path = Path(os.environ['ORKAS_TEST_BATCH_REPORT'])
self.events = self.path.with_suffix('.events.jsonl')
self.events.write_text('', encoding='utf-8')
self.inventory = []
self.results = {}
self.errors = 0
self.current = 'collection'
self.phase = 'collection'
self.signal_handlers = {}
for name in ('SIGTERM', 'SIGHUP'):
value = getattr(signal, name, None)
if value is not None:
self.signal_handlers[value] = signal.getsignal(value)
signal.signal(value, self.interrupt)
owner = self
class Handler(logging.Handler):
def emit(self, record):
level = 'error' if record.levelno >= 40 else 'warn' if record.levelno >= 30 else 'info'
owner.event('stdout', f'[00:00:00.000] [{level}] [(python)] {record.getMessage()}\n')
self.handler = Handler()
logging.getLogger().addHandler(self.handler)
@staticmethod
def interrupt(signum, frame):
# Let pytest unwind fixtures and stop its children before the parent exits.
raise KeyboardInterrupt
def event(self, stream, text):
with self.events.open('a', encoding='utf-8') as output:
output.write(json.dumps({'case': self.current, 'phase': self.phase, 'stream': stream, 'text': text}) + '\n')
@pytest.hookimpl(trylast=True)
def pytest_collection_modifyitems(self, session, config, items):
part, total = map(int, config.getoption('--orkas-checkpoint-shard').split('/'))
files = sorted({str(item.path) for item in items})
selected_files = set(files[part - 1::total])
kept = [item for item in items if str(item.path) in selected_files]
removed = [item for item in items if str(item.path) not in selected_files]
if removed:
config.hook.pytest_deselected(items=removed)
items[:] = kept
self.inventory = [item.nodeid for item in items]
self.batch_units = len(files)
def pytest_collectreport(self, report):
if report.failed:
self.errors += 1
for name, text in report.sections:
self.event('stderr' if name == 'Captured stderr' else 'stdout', text)
def pytest_runtest_logstart(self, nodeid, location):
self.current = nodeid
def pytest_runtest_setup(self, item):
self.phase = 'setup'
def pytest_runtest_call(self, item):
self.phase = 'call'
def pytest_runtest_teardown(self, item):
self.phase = 'teardown'
def pytest_runtest_logreport(self, report):
result = self.results.setdefault(report.nodeid, {'phases': {}, 'durationMs': 0})
result['phases'][report.when] = report.outcome
result['durationMs'] += round(report.duration * 1000)
for name, text in report.sections:
# pytest includes previous phases in later reports. Read each once.
if name == f'Captured stdout {report.when}':
self.event('stdout', text)
elif name == f'Captured stderr {report.when}':
self.event('stderr', text)
def pytest_warning_recorded(self, warning_message, when, nodeid, location):
previous = self.current
self.current = nodeid or 'collection'
self.event('stdout', f'[00:00:00.000] [warn] [(python-warning)] {warning_message.message}\n')
self.current = previous
@pytest.hookimpl(trylast=True)
def pytest_sessionfinish(self, session, exitstatus):
files = []
for nodeid, result in self.results.items():
phases = result['phases']
skipped = 'skipped' in phases.values()
passed = phases.get('setup') == 'passed' and phases.get('call') == 'passed' and phases.get('teardown') == 'passed'
failed = 'failed' in phases.values() or phases.get('teardown') != 'passed'
state = 'failed' if failed else 'passed' if passed else 'skipped' if skipped else 'failed'
files.append({'file': nodeid, 'state': state, 'passed': int(state == 'passed'),
'failed': int(state == 'failed'), 'skipped': int(state == 'skipped'),
'durationMs': result['durationMs']})
self.path.write_text(json.dumps({'schema': 1, 'reason': 'passed' if exitstatus == 0 else 'failed',
'unhandledErrors': self.errors, 'inventory': self.inventory,
'files': files, 'batchUnits': getattr(self, 'batch_units', 0)}), encoding='utf-8')
def pytest_unconfigure(self, config):
logging.getLogger().removeHandler(self.handler)
for value, handler in self.signal_handlers.items():
signal.signal(value, handler)
def pytest_configure(config):
config.pluginmanager.register(Checkpoint(config), 'orkas-checkpoint-protocol')