mirror of
https://github.com/bytedance/deer-flow.git
synced 2026-11-20 11:20:35 +00:00
* docs: turn README into an index and move reference detail to docs/guide The README had grown to 393 KB because every change appended its notes there. The text moves verbatim into 18 topic guides under docs/guide/; only headings are re-leveled and relative links re-pointed. The README keeps the introduction, a quick start and a guide index. Contributor test notes move to CONTRIBUTING.md. * docs: send user docs to topic guides and budget the root README The rule 'update README.md for user-facing changes' is what grew the README. Guidance now points to docs/guide/, and check_agent_guidance.py fails when the root README exceeds 16 KiB (AG003). * chore: remove unreferenced screenshots and finished plan notes pr-build/ holds two PR screenshots (3 MB) from #1986. plans/ holds the plan for the merged #4049. docs/SKILL_NAME_CONFLICT_FIX.md is a February change note. Nothing references them. * docs: route always-loaded AGENTS.md files to scoped guides * docs(agents): cut scoped guides to scope, verify, traps, decisions Each AGENTS.md keeps four kinds of content: the scope of the directory, the verification commands, traps a local test run does not show, and decisions the code cannot state. Values, field lists, function inventories, test names, issue numbers and history are deleted, because the code, the tests and git state them. Search and fetch providers share one community guide. Four guides with no remaining content are removed. The size check now allows 6 KiB per file (hard limit 8 KiB) and 24 KiB per chain (hard limit 32 KiB). * style: format frontend guide table and guidance test imports --------- Co-authored-by: Willem Jiang <willem.jiang@gmail.com>
1.9 KiB
1.9 KiB
Task continuity (deerflow/agents/task_continuity/)
Task notes and history search, which carry a task across context compaction. The contract, the trust boundaries and the excerpt boundary rules are in task continuity.
cd backend && python -m pytest tests -q -k "task_note or task_continuity"
Test note capacity through the real graph, and excerpts through the real search and read tools.
Note capacity
- Parallel note calls are coordinated by reservation. A lock on one snapshot cannot coordinate parallel Commands.
- Reservation and execution resolve arguments the same way. With handle resolution enabled, both read the call-local argument view. That view lives in the current tool runtime state, outside messages and checkpoints.
- A malformed sibling call must not break the receipts of valid siblings. Skip a structurally invalid call during reservation, without a source lookup. Source availability and policy denial are runtime outcomes, and the slots they leave unused are recalculated in the next batch.
History search
- The role filter belongs to
history_searchonly.history_readtakes no role parameter. - Filter archived payloads before the ranked iteration, and preserve ranking, source IDs, checkpoint reachability and user and thread isolation.
- Excerpt offsets are zero-based, half-open character offsets in the readable
source, so
source_text[start:end] == excerpt. Map case-folded matches back to original characters, not bytes. - Active text wins over an archive with the same ID. For duplicate archives, the first stored version supplies the text and the truncation flag, the same as a read by ID, so offsets refer to that text.
- When normalization prevents an exact location, return the opening of the source and mark the excerpt as not matched.