4.5 KiB
Mastermind
Mastermind is a personal, local-first macOS assistant that turns activity on the user's Mac into inspectable context for grounded assistance.
Product
Mastermind: The personal assistant product and the only target product name. Avoid: Cheating Daddy, Mastermind Native, AI helper
Local Profile: The local identity whose sources, knowledge, history, and policies belong to the current macOS user. A future cloud account may authenticate services but does not own the Local Profile. Avoid: User account, cloud profile
Companion Island: Mastermind's normally hidden interaction surface at the top center of the primary display. Hover reveals a capsule and clicking expands it into the assistant interface. Avoid: Overlay, HUD, Dynamic Island, floating window
Context acquisition
Source: A configured origin from which Mastermind may observe context, such as a workspace, calendar, screen, audio stream, or terminal integration. Avoid: Connector, data source
Collector: The independently operating part of Mastermind that observes one kind of Source and emits Observations. Avoid: Capture mode, watcher, sensor
Observation: Immutable, time-stamped evidence emitted by a Collector about a Source. An Observation is evidence, not a claim that Mastermind treats as true. Avoid: Event, Fact, memory
Gap: An explicit interval in which an enabled Collector could not produce usable Observations. Avoid: Missing memory, silent failure
Knowledge
Context Graph: The Local Profile's structured, time-aware representation of entities, relationships, Observations, Assertions, and Facts. Avoid: Memory, activity database, transcript archive
Assertion: A time-scoped claim inferred from one or more Observations, with confidence and Provenance. Assertions may conflict and expire. Avoid: Fact, summary
Fact: An Assertion explicitly confirmed or corrected by the user. Facts remain until the user removes or supersedes them. Avoid: High-confidence inference, model output
Provenance: The trace from an Assertion, Fact, summary, or answer back to the Source and Observations that support it. Avoid: Citation text, model reasoning
Person: A human relevant to the Local Profile's work. Avoid: Speaker, participant record
Project: An ongoing effort directed toward an outcome. A Project may span multiple Workspaces, Tasks, Events, Meetings, and Artifacts. Avoid: Repository, folder, session
Task: An actionable unit of work represented by an external source. Mastermind understands Tasks but is not their system of record. Avoid: Action Proposal, reminder
Event: A time-bounded occurrence meaningful to the user's work, such as a deadline or milestone. Avoid: Observation, log entry
Meeting: A human interaction inferred from calendar, application, and audio Observations. Audio channel roles do not establish a participant's identity. Avoid: Assistant Session, Conversation
Artifact: A persistent work product or reference relevant to a Project, such as a document or source file. Avoid: Observation, screen frame
Workspace: An explicitly connected directory or repository that provides Artifacts and project context. Avoid: Project, home directory
Assistance and trust
Assistant Session: A bounded text interaction in the Companion Island using one selected Provider. Assistant Sessions are distinct from Meetings. Avoid: Conversation, capture session, chat memory
Provider: An inference service used to generate assistance. A Local Provider runs on the same Mac; a Cloud Provider receives data outside the Mac. Avoid: Model, agent, sidecar
Provider Context Permission: The user's explicit permission for a Cloud Provider to receive locally selected context. Permission is denied by default and can be revoked for future requests. Avoid: Source Policy, blanket consent
Context Receipt: The inspectable record attached to an answer that identifies its supporting context, Provider, and any external data transfer. Avoid: Citation, Activity Log
Activity Log: The local audit trail of Collector lifecycle, permission failures, gaps, and Provider requests without captured content. Avoid: Assistant History, transcript
Assistant History: The persistent local record of Assistant Sessions. It is separate from the Context Graph and Activity Log. Avoid: Memory, Context Graph
Action Proposal: A plan or draft suggested by Mastermind for the user to carry out. It does not authorize Mastermind to act on the Mac. Avoid: Tool call, agent action, Task