Versioned engineering context

Resume engineering work from evidence, not summaries.

Threadline binds code, tests, decisions, and prior claims to one versioned handoff. The next person or agent can see what is proven, what is uncertain, and what should happen next.

Inspect the handoff See how evidence flows

Works beside your agent

Codex, Claude Code, Cursor, VS Code, Antigravity, or a terminal.

Bound to a commit

No floating summary detached from repository state.

Fails closed on drift

Dirty files, moved commits, and unsupported completion remain visible.

Live product

Inspect the work before you continue it.

The demo uses a synthetic retry task with deliberately conflicting evidence. Select a claim, open its source, and see why Threadline blocks an unsafe handoff.

IN PROGRESS

Add bounded retries to run_job without changing its idempotency key between attempts.

captured statefeature/retry-jobs@ 32a7b542

Repository32a7b542

Verification8 context items

Handoffsnapshot

NEXT / SAFE

Recommended continuation

Wire RetryPolicy into run_job while reusing the original idempotency key, then add an integration test and run the complete suite.

Evidence-ranked context

Open any row to inspect the source behind it.

8 shown

Trace inspector

Exact source context

READ ONLY

CONTRADICTED

Evidence disagrees

Sourcesrc/job_runner.py

@dataclass(frozen=True)
class RetryPolicy:
    max_attempts: int = 3
    base_delay_seconds: float = 0.25

    def delays(self) -> tuple[float, ...]:
        return tuple(
            self.base_delay_seconds * 2**attempt
            for attempt in range(self.max_attempts - 1)
        )

def run_job(operation, idempotency_key):
    """Run once; retry integration is intentionally absent."""
    return operation(idempotency_key)

CONTENT HASHfdd02a00d30b6aca27897cd64dd32e47f6b478c3eb689dc09bc6ddd79b7b3b0b

Cited sources

Executed proof

A second agent continued the task from the handoff.

Bundled report snapshot

01Agent A stops

Threadline compiles the task, constraints, evidence, and safe next action.

02Agent B reads

The official MCP client opens the cited exact-commit handoff.

03Work changes

The second agent implements the retry path and runs the complete suite.

04Old context is refused

The moved commit invalidates the prior handoff before a current one is compiled.

12 executed cases12 passed

5 isolated temporary repositories

73.9% smaller default MCP handoff, with 6 source locators retained

EXEC-001

Continue the task through a second MCP agent

commit changed; full suite passed with 2 tests; old handoff refused; new handoff status ok

PASS

EXEC-002

Reject unsupported all-tests-passed assertion

UNKNOWN

PASS

EXEC-003

Resolve every returned citation in scope

6 evidence objects

PASS

EXEC-004

Abstain on a dirty worktree

abstained

PASS

EXEC-005

Abstain after the branch head moves

abstained

PASS

EXEC-006

Verify a committed full passing check

VERIFIED

PASS

EXEC-007

Contradict completion after a failed full check

CONTRADICTED

PASS

EXEC-008

Recover the typed test-to-class relationship

2 typed edges and 7 citations

PASS

EXEC-009

Deny another task identifier

tool error

PASS

EXEC-010

Redact a known credential before evidence storage

credential absent; retry configuration retained

PASS

EXEC-011

Keep instruction-shaped repository text outside the trust boundary

override_instructions, scope_expansion, self_approval

PASS

EXEC-012

Preserve continuation decisions in the compact MCP handoff

2695 compact bytes versus 10330 full bytes; 73.9% reduction

PASS

Claim boundary

Twelve deterministic synthetic regression cases; not an external accuracy, adoption, or production claim.

Use Threadline

Keep your coding agent. Replace the unsupported handoff.

Threadline runs locally beside an existing Git repository. It needs no model API key and uses repository-private SQLite by default.

CodexClaude CodeCursorVS CodeAntigravityTerminal

01
Install Threadline oncepipx install git+https://github.com/Deep99739/Threadline.git
02
Onboard a repository and clientthreadline onboard . --objective "Fix parser drift" --next-action "Add the integration check" --client codex

The evidence contract

Five states. Five distinct levels of trust.

Threadline does not collapse every claim into “done.” Each state tells the next worker what the evidence supports and where verification is still required.

01VERIFIED

Proved at this commit

02OBSERVED

Directly witnessed

03ASSERTED

Source says so

04UNKNOWN

Not enough evidence

05CONTRADICTED

Evidence disagrees

System shape

Every layer exists to keep a handoff honest.

INGEST

Code + human context

Git state, tests, decisions, constraints, and attributed observations.

VERIFY

Deterministic checks

Call sites, symbol existence, test scope, and content freshness.

COMPILE

Versioned context pack

Risk-ranked claims with citations, unknowns, and contradictions intact.

SERVE

Read-only handoff

A product UI and scoped MCP tools bound to the exact task and commit.