Jordan-Hall / Jordan-Hall/browser

[P1][AGENT-01] Task graph and scoped orchestration

Open
#54 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

Programme: #1
Epic: #20

## Objective
Implement the core harness as a durable supervisor-owned task graph, not an open-ended LLM loop.

## Scope
- Task lifecycle: Draft → Scoped → Planned → Running → AwaitingApproval → Verifying → Completed plus Suspended/Cancelled/Failed/Blocked/NeedsReconciliation.
- DAG/state-machine representation with dependencies, inputs, outputs and explicit success predicates.
- Specialist subjobs with scoped context bundles, allowed capabilities, deadlines and budgets.
- Execution leases/fencing tokens, checkpoints and resumability.
- Concurrency control: parallel safe reads; serialize conflicts over mutable accounts/carts/repos/budgets/desktops.
- Plan revision proposals that cannot expand authority.
- Cancellation cascading and orphan-job cleanup.

## Harness rules
- The supervisor owns durable state; provider thread/session IDs are secondary references.
- Subagents cannot recursively spawn unbounded trees or inherit ambient authority.
- Completion requires verification, not a model saying “done”.

## Acceptance criteria
- [ ] Subagents cannot expand their grant/tool/resource scope.
- [ ] Conflicting access to one mutable external resource is serialized/fenced.
- [ ] Cancellation revokes leases before later worker output can dispatch new effects.
- [ ] Task resumes from persisted state after worker/app restart.
- [ ] Budget/deadline exhaustion produces explicit bounded failure/degraded state.
- [ ] Success predicates and verification outcomes are durable and inspectable.

## Dependencies
- CORE-02
- CORE-03
- SEC-02

**First phase:** P1
**Maturity target:** P3
**Owner:** harness-pc-providers

## Task issues
- [ ] #439 `AGENT-01.T01` — Define graph nodes, effects and state transitions
- [ ] #440 `AGENT-01.T02` — Implement durable task submission and planning
- [ ] #441 `AGENT-01.T03` — Build the ready-node scheduler
- [ ] #442 `AGENT-01.T04` — Implement scoped specialist delegation
- [ ] #443 `AGENT-01.T05` — Implement conflicting-resource locks and fencing
- [ ] #444 `AGENT-01.T06` — Implement bounded tool execution and context management
- [ ] #445 `AGENT-01.T07` — Add independent verification nodes
- [ ] #446 `AGENT-01.T08` — Implement checkpoints, stop and recovery
- [ ] #447 `AGENT-01.T09` — Expose progress, budgets and revisions
- [ ] #448 `AGENT-01.T10` — Run graph race, budget and recovery tests

Contributor guide

No contributing guide indexed for this repository

Research direction

The issue names no files, tests, or entry points; begin by reading dependencies CORE-02, CORE-03, and SEC-02, then use task issues #439–#448 as the implementation map. Done means meeting the listed acceptance criteria for scoped authority, fencing, cancellation, recovery, bounded failure, and durable verification.

Written by the indexing model from the issue text.

Assessment

Domain
backend, distributed-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.