dopetask 0.5.7

Deterministic Task Packet execution kernel with proof bundles, worktree isolation, and series-based PR workflows.

dopeTask

dopeTask is a deterministic task-packet execution kernel for high-trust engineering workflows.

It validates a Task Packet, executes one allowed path or refuses with evidence, and writes canonical artifacts that operators can inspect later. The default workflow uses JSON Task Packets and the tp series commands so each packet runs in its own worktree, creates one bounded commit, and accumulates into a single PR for the series.

Guarantees

• Artifact-first: if it did not write an artifact, it did not happen.
• Refusal-first: invalid or unsafe inputs fail closed with evidence.
• Deterministic outputs: identical packet, declared inputs, and dopeTask version yield stable artifacts.
• Single-path execution: no hidden retries, no silent fallback runners, no background mutation.

Default workflow

1. Author JSON Task Packets that conform to the task packet schema.
2. Execute each ready packet with dopetask tp series exec <packet.json> --agent gemini.
3. Inspect progress with dopetask tp series status <series-id>.
4. Finalize the completed series into one PR with dopetask tp series finalize <series-id> --title "...".

Each JSON TP runs in its own git worktree, stages only allowlisted changes, creates one commit, and records authoritative runtime state in:

• out/tp_series/<series-id>/SERIES_STATE.json
• out/tp_series/<series-id>/packets/<tp-id>/
• proof/<TP_ID>_PROOF_BUNDLE.json

Installation

Install from PyPI

pip install dopetask

Install with uv

uv tool install dopetask

Verify

dopetask --version
dopetask doctor

Supervisor prompt setup

Generate the current supervisor prompt instead of copying an old static markdown file:

dopetask ops init --platform chatgpt --model gpt-5.4

This writes a pasteable prompt to ops/EXPORTED_OPERATOR_PROMPT.md.

For workspace-aware agents, apply the generated prompt into the repo instructions:

dopetask ops apply

For the full prompt-generation workflow, recommended current models, and current CLI versions as of March 29, 2026, see the Supervisor prompt guide.

Consumer repository install

To wire dopeTask into another repository with repo-local pinning and launch shims:

curl -fsSL https://raw.githubusercontent.com/DDD-Enterprises/dopeTask/main/scripts/install.sh | bash

Docs map

Current user and operator docs

• Overview
• Setup
• Task Packet format
• Workflow guide
• Integration guide
• Upgrade guide
• Consumer install
• Supervisor prompts

Beginner onboarding

• Welcome
• How dopeTask works
• Concepts
• Installation
• Web LLM setup
• Beginner workflow

Legacy and maintainer docs

• Worktrees and commit sequencing
• TP git workflow
• Release guide

Proof-contract docs

• Proof bundle contract
• Proof archive policy
• Bundle review guide
• Proof bundle schema

Legacy/manual paths

Legacy markdown packet and tp git flows remain available for manual maintainer work, but they are not the default path for new supervisor-driven execution.

Project links

• Repository
• Releases
• Issues
• Security policy
• Contributing