Skip to content

feat: add daemon-owned Familiar companion - #35

Merged
BunsDev merged 74 commits into
mainfrom
feat/familiar-companion
Jul 31, 2026
Merged

feat: add daemon-owned Familiar companion#35
BunsDev merged 74 commits into
mainfrom
feat/familiar-companion

Conversation

@BunsDev

@BunsDev BunsDev commented Jul 31, 2026

Copy link
Copy Markdown
Member

Summary

  • load and validate the paired daemon's authoritative Familiar roster rather than hard-coding archetypes
  • persist profile-scoped selection and pin exact identity snapshots across on-device and Companion sessions, resume, fork, browsing, and Spotlight
  • harden Companion pairing/traffic authority plus local session persistence, recovery, deletion, indexing, cancellation, and resource bounds
  • keep Familiar identity cosmetic: it never changes models, tools, permissions, or sandbox access

Validation

  • fresh holistic branch review: no Critical or Important findings
  • ./scripts/build-xcframework.sh
  • Rust: 275 passed, 1 ignored; check, clippy -D warnings, and fmt clean
  • Swift: 445 simulator tests passed; strict SwiftLint clean
  • generic iOS Simulator build passed
  • regenerated UniFFI bindings match the committed output

Closes #12

BunsDev and others added 30 commits July 29, 2026 20:52
@BunsDev
docs(familiar): design roster-driven companion
0689055 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
docs(familiar): add implementation plan
0dff2f2 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
feat(familiar): expose daemon roster
9e1c640 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
feat(familiar): pin on-device session identity
6e577b5 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
test(familiar): exercise fork rollback
ba311f7 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): serialize session identity lifecycle
4b48e8a 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): make session identity lifecycle atomic
6a15817 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): clean partial fork staging
dfa54e0 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): quarantine incomplete forks
ec99f19 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): harden session metadata durability
9ed4435 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): validate indexed session ids
980486b 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): roll back failed sidecar sync
33789a4 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
feat(familiar): persist profile selections
6a752ac 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): serialize async session creation
e00067c 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
feat(familiar): refresh daemon roster safely
dfab1ad 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): preserve cached roster failures
547f4ab 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
feat(familiar): bind companion session identity
8b257da 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
feat(familiar): add chat identity picker
1be2f92 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): keep active identity labels honest
6d0acd2 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): separate active and next identity
58aee46 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): synchronize Spotlight resume profile
899b25b 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): refresh picker context coherently
cf96fe3 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): recover cancelled chat context
4bf8240 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): close chat identity state gaps
9f657a9 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(companion): restore cancelled gate availability
3051017 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(companion): recover initial availability cancellation
89b502d 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): enforce single session writer
a581b6d 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): reject unsafe storage symlinks
f4ed00a 
Centralize checked session-storage paths, validate SQLite sidecars and persistence leaves, and preflight destructive recovery before index mutation.

Path validation remains std path-based and therefore cannot provide descriptor-relative TOCTOU guarantees.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): normalize storage root checks
574028e 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): serialize same-session resume
e621526 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
BunsDev and others added 27 commits July 30, 2026 17:55
@BunsDev
fix(sessions): migrate legacy empty session rows
dd19863 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): durably create storage roots
5f88714 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): preserve history on list errors
3cec988 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): preserve offline companion selection
df7d5dd 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): resync root parents after restart
5e7d005 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): require existing storage parents
5b6a235 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): provision app support storage
c7635db 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): share Codex account state
412c128 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(companion): rebind retries to daemon profile
3103429 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): detach routed reset cleanup
dd574eb 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): bound fork transcript staging
f428a1f 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): share account state across windows
93259f5 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): queue differing routed resets
9c9912d 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(companion): retain attempted retry context
fc463df 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): install turn cancellation before awaits
a63c5d1 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(app): constrain routing to one scene
9a6641d 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(engine): fence streamed operation state
01dc098 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(auth): retain failed sign-out cleanup
e1231af 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): bound roster and identity data
5d44a27 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(familiar): validate normalized field bounds
bad4864 
Apply Familiar byte limits after whitespace normalization so bounded retained values preserve the established trim contract.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(companion): preserve retry traffic authority
9fef674 
Pin no-Familiar retries to their verified daemon endpoint and coalesce overlapping checks for the same persisted pairing without returning stale authority.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(sessions): preflight persisted state mutations
0e6b22d 
Reject oversized model records before filesystem mutation, let direct deletion bypass corrupt target metadata, and preflight target artifacts before recovery can mutate unrelated state.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(app): retain the root window state
9e7f2ab 
Keep the app-owned observer graph stable across SwiftUI body reevaluations instead of constructing throwaway root state.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
perf(sessions): bound fork publication work
be02256 
Defer staged transcript durability to one sync, release parsed source entries before staging, and retain only generated UUIDs for index publication.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
fix(chat): protect live session ownership
be03b2d 
Reject deletion during chat operations or for the installed session, route the iPad browser through shared chat ownership, and keep offline Familiar opt-out available.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
docs(roadmap): mark Familiar roster complete
190481a 
Replace the obsolete fixed-archetype wording with the daemon-owned, profile-scoped, session-pinned behavior shipped for issue #12.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@BunsDev
chore(beads): record Familiar release hardening
9b8ecec 
Persist the completed review follow-ups, close the upstream SQLite atomicity task, and align issue #12 tracking with the daemon-owned roster.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 31, 2026 14:02
Copilot AI reviewed Jul 31, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review this pull request because it exceeds the maximum number of lines (20,000). Try reducing the number of changed lines and requesting a review from Copilot again.

@BunsDev
BunsDev merged commit f6c83dc into main Jul 31, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Daemon-owned Familiar companion

2 participants

@BunsDev