← Back

Production systems

Polaris

Local-first native macOS life system — a production surface, not a sketch. Questline DAG engine, SwiftData persistence, Plaid-backed finance, and hubs for mental health, household, and a stardust economy. Where plans become daily execution.

Production systemsSwiftUI / macOSSwiftDataDAG enginePlaid
  • Questline DAG resolver: cycle detection, topological order, execution frontier, multi-parent unlock, stardust/XP on complete
  • Plaid Link companion (Express) — token exchange, transaction sync with cursors, Keychain rehydration, production OAuth
  • SwiftData bridges for tracks and questline blueprints; domain stores for mental health, household, personal care, finance, economy
  • Shipped shell: Dashboard, Mental Health, Personal Care, Household, Questlines, Shop, Map, Finance

What it is

Polaris is a local-first macOS app for running day-to-day life as a coherent system: long-term questlines, skill categories, journal and mood, household ops, a deadline map, bank-linked finance, and a lightweight stardust economy tied to wishlist unlocks.

Native by design — SwiftUI, on-device persistence, no subscription leash. Built under ASTRONOMA. Evolved from the earlier Lifemaxxing outline into a real product codebase.

Production systems

The questline layer is no longer a hardcoded tree. DAGResolver is a pure Swift engine: build state from nodes and edges, detect cycles, compute topological order, expose the execution frontier, and resolve completions so children unlock only when every parent is COMPLETED. State machine: LOCKED → ACTIVE → IN_PROGRESS → COMPLETED, with FAILED and retry. Completing a node can award XP and stardust. QuestlineStore still speaks the tree model (Objective → Quest → Step); the DAG is the generalisation for multi-parent dependencies.

Persistence is moving catalogs and questline blueprints onto SwiftData via dedicated bridges (tracks, questlines). Domain stores own mental health, household, personal care, finance, and the economy — CRUD for user-editable data instead of frozen presets.

Finance is a real integration, not a mock. A local Express companion creates Plaid Link tokens, exchanges public tokens, syncs transactions with cursors, and rehydrates Keychain access tokens after a companion restart. Production OAuth uses a registered https redirect. Tokens never live in the public API surface.

What is already real

Navigation shell and hubs for Mental Health (mood, energy, journal, wins, skill tasks), Personal Care, Household (chores, shopping, pantry/recipes), three main questlines with objectives → quests → subquests, Shop meters, a Map that flattens deadlines across domains, and a Finance surface wired to the Plaid companion.

Current questlines track dual career paths (BCI software engineering, scientific research) plus the life-systems foundation those paths sit on.

In the stack

Plans name the trajectory. The Academics vault holds coursework and literature. Shared Brain graphs the research. Polaris is the surface that turns all of that into dated quests you actually finish — with an engine that can prove the graph is acyclic.

Questline DAG

Cycle-checked topological unlock. Completing Q2.2 opens both children; Q2.5 waits for every parent.

Q2.1SchemaQ2.2ResolverQ2.3RouterQ2.4PersistQ2.5Unlock

LOCKED → ACTIVE → IN_PROGRESS → COMPLETED · FAILED ↗ retry