Cleetus Core developers

Core developers

Task readiness and receipts

A task can have all its prerequisites completed and still need an owner, capacity and approval to run. Core exposes dependency status as a read of one reviewed project board.

Read outstanding dependencies

With workspace and task inventory access on the local Core:

cleetus-host inspect task-readiness

The private v1 endpoint is GET /v1/inspection/task-readiness with Accept: application/vnd.cleetus.task-readiness+json;version=1. The snapshot identifies the Host instance, project generation, board revision and expiry. It includes pending tasks that have never been claimed. Each row has its task ID, display title and unmetDependencies, the count of direct dependencies whose status is still short of completed. The response returns up to 32 rows. Read total and more before treating it as the whole list.

Suppose Publish release notes depends on Review changelog. The first task shows one unmet dependency while the second is pending, claimed or awaiting review. A report submitted for Review changelog moves it into review. Accepting that report marks the prerequisite completed. A fresh snapshot then shows zero for Publish release notes, assuming it is still pending and never claimed. It can now be considered for a claim.

Review the original report

A claim binds one session and lease generation. A report must match that lease and the task's definition digest, and include a summary and evidence. Core rejects stale claims and cyclic dependency graphs. To accept the recorded report, choose a fresh completion operation ID and supply the report's original operation ID:

cleetus-host task complete --operation-id "$COMPLETION_ID" "$REPORT_ID"

The native terminal shows the project, task, reporting session, summary, evidence, report digest and board revision. Confirming commits the reviewed transition. If the response is lost, look up that same completion:

cleetus-host task completion-status "$COMPLETION_ID"

The lookup reads the original outcome. An uncertain completion blocks a second attempt for the same report under another ID. Neither reading a ready row nor accepting a report starts a dependent task or submits a provider turn. Placement and reservations · Task board guide