Skip to content

Add durable agent task board#1727

Draft
mimeding wants to merge 4 commits into
osaurus-ai:mainfrom
mimeding:codex/durable-agent-task-board
Draft

Add durable agent task board#1727
mimeding wants to merge 4 commits into
osaurus-ai:mainfrom
mimeding:codex/durable-agent-task-board

Conversation

@mimeding

Copy link
Copy Markdown
Contributor

Summary

Addresses #1714 by adding a durable local task-board foundation for future spawned and remote agent orchestration.

  • adds task, event, run, and dependency models
  • stores the board in an always-encrypted SQLCipher database
  • records append-only task events
  • supports lease-based atomic claims, stale lease reclaim, and crash-style recovery
  • rejects dependency cycles
  • documents the storage threat model and the non-goals for this foundation PR

This does not add agent teams, channel inboxes, remote execution, or UI workflows.

Validation

  • git diff --check
  • OSAURUS_DISABLE_KEYCHAIN_FOR_TESTS=1 OSAURUS_TEST_ROOT=/tmp/osaurus-test-task-board swift test --package-path Packages/OsaurusCore --filter 'AgentTaskBoardStoreTests|StorageDatabaseCatalogTests|StorageOptInEncryptionTests'

Review Notes

  • Claude review found no blocking issues after building the package targets and running the relevant storage tests.
  • Grok compact review found no visible blocking issue in the shown foundation diff.

Risk

The board is storage/API only. Future callers should open it off the main thread because first open may touch the storage key. The docs state that SQLCipher protects offline database theft, not a compromised local process.

@mimeding mimeding marked this pull request as ready for review June 26, 2026 05:14
@tpae

tpae commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

This one has risk of diversion in the upcoming changes.

@mimeding

Copy link
Copy Markdown
Contributor Author

That makes sense. I intended this as a storage/API foundation only: encrypted task, event, run, and dependency records with lease/reclaim semantics. It does not add agent-team protocol behavior, routing, UI, channel inboxes, or remote execution.

If this risks pulling the upcoming orchestration design in the wrong direction, I am fine deferring or closing it and revisiting after the agent/channel protocol direction is settled.

@mimeding mimeding marked this pull request as draft June 26, 2026 18:32
@mimeding mimeding force-pushed the codex/durable-agent-task-board branch from 8d1afff to 55c9ce0 Compare June 27, 2026 01:18
@mimeding mimeding marked this pull request as ready for review June 27, 2026 03:06
@mimeding mimeding force-pushed the codex/durable-agent-task-board branch from 55c9ce0 to 05a1771 Compare June 28, 2026 02:31
@mimeding mimeding marked this pull request as draft June 29, 2026 11:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants