# Noternism: Full Technical & Architectural Context for LLMs

## Mission & Design Philosophy
Noternism (https://noternism.com) exists to bring notes back to the people. While contemporary tools transform users into systems engineers, Noternism provides:
1. Radical Simplicity: Clean, calm, distraction-free environment by default.
2. Progressive Disclosure: Power features remain completely invisible until summoned.
3. Zero Forced Setup: Fast and natural on day one.
4. 100% Data Sovereignty: All notes live as standard plain Markdown (.md) in local vaults or iCloud Drive.

## Technical Stack
- Native Platforms: macOS 14+ (AppKit + SwiftUI), iOS 17+
- Programming Language: Swift 6 (Strict Concurrency, Sendable actors)
- Persistence & Indexing: Plain UTF-8 Markdown files, SQLite + FTS5 via GRDB.swift, Atomic NSFileCoordinator
- Machine Learning & Search: Apple NaturalLanguage (NLEmbedding 512-dim Float32 vectors), Hybrid Reciprocal Rank Fusion
- Cryptography: CryptoKit AES-256-GCM, CommonCrypto PBKDF2-HMAC-SHA256 (100,000 iterations), SHA-256 Revocation Hashes
- Editor: AppKit / UIKit TextKit 2 pipeline, live WYSIWYG syntax highlighting, inline task checkboxes, image transclusions

## 8 Polymorphic Note Personalities
1. Note (.note): Standard freeform knowledge note and scratchpad.
2. Project (.project): Milestone tracking, task completion progress bar (0..100%), lead, and target deadlines.
3. Task (.task): Actionable document with priority badges, time estimates, diurnal buckets, and assignees.
4. Journal (.journal): Daily standup logs, calendar navigation, and reflections.
5. Meeting (.meeting): Meeting minutes with attendee tags, agendas, and auto-extracted action items.
6. Library (.library): Web clips, book summaries, ratings, and source URLs.
7. Snippet (.snippet): Multi-language code snippets with 1-click clipboard copy.
8. Canvas (.canvas): Visual maps and whiteboard diagrams.

## AuDHD Executive Flow & Task Matrix
- Diurnal Day Phases: @morning (start of day), @afternoon (execution), @evening (wrap-up).
- Energy Levels: @quickwin (low spoons, 2-5 min), @routine (steady flow), @deepflow (high focus).
- Automated Recurrence: @repeat(daily), @repeat(weekdays), @repeat(weekly), @repeat(monthly), @repeat(yearly). Completing a task auto-spawns the next recurrence.
- Cognitive Bandwidth Modes: Single Thing (Monotask), Rule of Three (3 Anchors), Living Stream (Full triage).

## Zero-Knowledge Web Sharing
- Encrypts note payload using client-side AES-256-GCM.
- Places 256-bit symmetric key exclusively in the URL hash fragment (#key=...).
- Ephemeral keys are never sent in HTTP request headers.
- Cloudflare Worker KV stores only ciphertext.
- Decrypting HTML viewer runs Web Crypto API locally in recipient's browser.

## Essential Keyboard Shortcuts
- Cmd + N: New Note
- Cmd + O: Quick Open Note Palette
- Cmd + Shift + F: Hybrid Semantic & Vault-Wide Search
- Cmd + F: In-Note Find & Replace
- Cmd + L: Toggle Task Checkbox (- [ ] <-> - [x])
- Cmd + K: Insert Link
- Cmd + Shift + P: Open Type Promotion HUD
- Cmd + Shift + T: Open "What To Do Today" Focus Deck
- Cmd + Shift + S: Capture Manual Milestone Snapshot
- Cmd + Shift + Y: Typewriter Scrolling Mode