kinderp / kinderp/durex

Persist provider-neutral session mappings and context checkpoints

Open
#27 0 comments 0 reactions 0 assignees View on GitHub
area:agents kind:feature
Dominant language
Python
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Parent and milestone

- Parent issue: #23
- Milestone: not scheduled; implementation starts after #15.

## Problem

Long work currently depends too heavily on one provider session. Provider history can grow slow, expire, or become unavailable, and cannot be treated as Durex canonical state.

## Outcome

Persist a portable, bounded checkpoint containing goals, decisions, repository state, validation, artifacts, completed work, and remaining work, with opaque mappings to provider sessions.

## Scope

- Define durable Durex session and checkpoint records.
- Map zero or more opaque provider sessions to one Durex work session.
- Create checkpoints on bounded lifecycle triggers and before runtime handoff.
- Support fresh-session and cross-runtime continuation.

## Non-goals

- Copying hidden reasoning or entire provider histories.
- Treating generated summaries as authoritative without artifact references.
- Multi-host transfer, which remains coordinated with #21.

## Acceptance criteria

- [ ] A task can resume from a checkpoint without the original provider session.
- [ ] Checkpoints contain provenance, size bounds, schema version, and artifact references.
- [ ] Secrets and raw terminal output follow documented retention and redaction rules.
- [ ] Targeted and conformance tests pass.
- [ ] Architecture, adapter, and operator documentation is updated.

## Validation

- Test checkpoint creation, schema migration, truncation, stale provider mappings, and cross-runtime handoff fixtures.

## Dependencies

#26 and the durable interaction work in #13.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reading parent issue #23 and dependencies #26 and #13 to understand the existing durable interaction model and implementation boundary. Define the session and checkpoint design against the listed scope, then validate checkpoint creation, migration, truncation, stale mappings, and cross-runtime handoff. Done means the acceptance criteria pass, including bounded provenance, artifact references, retention rules, conformance tests, and updated documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
backend, distributed-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
32/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.