Update: Added the owner's caffeine catchphrase to the shared site footer and Vercel Web Analytics
for deployed builds; local documentation previews remain tracking-free by default.
Design: The wiki now has a Summon-branded field-guide cover, task-based entry cards, real command examples,
five navigation groups and coordinated light/dark reading surfaces. Native search/mobile controls remain intact;
keyboard skip/focus, narrow screens and reduced-motion behavior were exercised. Design evidence.
Update: Root, Summon, macctl, feature, install, security, contributor and tooling references audited against
source through 18c7688. Corrected version/agent counts, update channels, recovery boundaries, inventory health,
theme accents and current build/CI behavior; November implementation remains explicitly unreleased.
New: Strict wiki builds check local files, rendered links, heading anchors and assets.
The read-only documentation workflow validates the site; Vercel publication targets the owner-selected
sumonos.rohi-lab.org domain. Application releases are unchanged.
Update: Runtime audit records native About/Activity captures, the real 13-report crash-burst alert/dismissal/search proof, fixture-home isolation and outstanding profiler, heap, displayed-frame and accessibility gates. Native input uses owned PID-targeted keys rather than global System Events keystrokes.
Update: Features, macctl catalog and Summon changelog distinguish live app tint, native system accent and Automatic folder color. Recorded observed AppKit apply/undo refresh on macOS 27.2; custom folder colors remain independent.
Update: Features, Summon changelog and project memory distinguish repair defects from theme/readability and optional-art recommendations. Recorded the complete nine-theme audit, corrected bundle detection, scoped summon fix --apps, 38 passing regressions and live-inventory light/dark content renders.
Update: Features and Summon changelog describe the shared six-category My Apps inventory, visible built-in/custom themes and matching affected-item totals in the panel and Settings.
Update: Sustained hosted verification completed all 500 panel/search cycles and passed every non-profiling check. Runtime audit and project memory retain the three recorder stop/save failures and blocked timing coverage; no application-hang or performance claim is inferred.
Update: Runtime audit/tooling now record the full requested workload under each profiler and require per-cycle interval coverage. The audit distinguishes a successful local SwiftUI control from still-unverified hosted Summon profiling.
Update: Hosted revision 9bb3063 verifies 100 actual panel query values, About/Activity keyboard close and terminal delivery. Runtime audit and project memory record the remaining empty SwiftUI-data/save failure and recorder symbol-processing stack; the gate rejects empty SwiftUI recordings rather than accepting a saved directory.
Update: Runtime audit distinguishes historical sent-keystroke cycles from actual search-value verification; records the hosted capture failure, retained sanitized stderr, owned recorder-group cleanup and local native helper permission boundary.
Update: runtime audit records hosted GUI100, cross-OS native UI/Swift passes, genuine panel timing samples and the remaining SwiftUI recorder-finalization failure. Local 98 behavioral Python/378 Core/21 CLI tests passed; recorder-only diagnostics preserve the failure without weakening release gates.
Update: Runtime audit and project memory record the first complete hosted wave, remaining native About failures, registration-ready watcher reconciliation and local 378 Core/20 CLI/8 automation passes. MacAppArchitecture records the asynchronous Dispatch registration contract; hosted GUI acceptance remains pending.
Update: runtime audit and Summon project memory: signed stable/edge packages from clean implementation revision 8f267fb, matching compiled identity, owned-artifact cleanup and channel-specific visual limits; draft PR #124. MacAppBuild now records checking both Git author and committer before public pushes.
Update: runtime audit, features, tools, Summon project context and changelog: unreleased runtime hardening, staged build identity/native About, owned Core100 and signed installer fault evidence, same-host benchmark deltas and explicit hosted GUI/heap/VoiceOver prerequisites. The original source audit below remains a historical record.
New: Summon runtime audit and implementation roadmap: measured Core baselines, completion-event and UUID-log-retention defects, About/build identity, phased menu/lifecycle improvements, and automation contracts. Application behavior is unchanged; GUI crash/leak attribution remains unconfirmed.
Update: SummonOS 0.2.0 (VERSION, summon, macctl, Summon.app): the app updates itself; Update folder with every outdated tool; crashes as notifications.
Update: Summon CHANGELOG: the 2026-10-25 work from #72 to #96 was missing; it now lists it and names the v0.1.0 and v0.1.1 releases.
Update: Features, tools, workflow, Scaffold: a widget template (WidgetKit countdown + its app), the one template with a small Xcode project (owner's decision); surface 7.
Update: Features: templates follow the UX surfaces: close-only Settings, desktop app inspector/search/undo at 800 × 550, menu bar right-click menu and Show in menu bar, first-run welcome window.
Update: Features, tools, workflow, Scaffold: three new templates for the UX surfaces: launcher (hotkey command bar), hud (floating always-on-top panel), notch (panel out of the camera housing).
New: macOS UX surfaces: the surface table (7 surfaces × 14 dimensions), one research page per surface checked against the HIG and API docs, and findings with ten corrections and the rules every surface shares.
Update: Features, tools, workflow, Scaffold: one template set, incubator/summon/templates/{menubar,menubar-panel,app,cli,screensaver}; examples/ is gone and tools/mp new --kind <kind> copies these templates. Every template has a CLT-compatible scripts/test.sh; UI kinds share a kit (menu rows, Summon theme, Liquid Glass controls, Open at Login, app icon, --screenshot). CI makes a project of every kind with summon project new and runs its scripts/check.sh.
Update: Features: minimal panel (Needs attention, Now, Recent, three actions; the rest by search or Settings › Setup), Liquid Glass, 320 pt; no agent clock in the menu bar by default.
Update: Features, Install for agents: summon update [--channel stable|edge] [--check] [--yes]; the release workflow publishes a rolling edge prerelease after every green main, and install.sh --channel edge installs it (never by default).
Update: Features and Tools: more CI checks: CodeQL for Swift, a privacy scan with public patterns, Dependabot for pinned actions, and a post-release smoke test that installs the release on a clean runner.
Update: Features: the panel shows Needs attention (crashes, setup problems) and lets you choose an agent; one Settings window without header blocks or explanatory text; undo asks with "Restore N Changes" (Cancel default); orange menu bar icon for problems.
Update: Features: Visual QA screenshots every Settings page, Activity and the crash alert; summon://settings/<section> opens a Settings page. Phase 5 (UX/UI overhaul) plan approved.
Update: Features: summon agents install / summon agents update [--check] install coding agents with bun (npm agents) or the vendor script and update each the way it was installed (brew, cask, bun, npm, vendor updater).
Update: SummonOS 0.1.1 (VERSION, summon, macctl, Summon.app): undo any agent session, hotkey with screen context, one-click Accessibility, summon connect hooks, whole-Mac themes with one undo, macOS 27 wallpaper fix, live Mac events.
Update: Features: summon default repos now defaults to ask (no repo until summon project repo and its dialog; a saved always is kept); projects live in ~/Summon/Apps/<name>. The mac-app skill is rewritten as exact steps; AGENTS.md, Workflow and MacAppBuild Scaffold use the ~/Summon/Apps/<name> path.
Update: README rewritten around "the agentic layer for the Mac": what you get (context, MCP + connect, hotkey, undo, themes), install flags and what ad-hoc preview builds mean, a 60-second tour, demo placeholders, status and credits (Omarchy).
Update: Features: live Mac events (network, VPN, low disk, battery, thermal, displays) logged by Summon.app as mac.*, summon events --follow, MCP tool mac_events.
Update: Features: summon checkpoint undo also removes the files a theme created (recorded as the created ref), so undoing a theme leaves no generated files behind.
Update: MacAppArchitecture gotchas: macOS 27 desktopImageURL lags behind a wallpaper write; ad-hoc builds and stale Accessibility entries.
Update: Features: summon theme set also sets the macOS accent (new macctl setting appearance.accent-color, 39 settings), VS Code/Cursor and Neovim, and takes one checkpoint so the whole look undoes at once.
Update: Features: summon connect records Claude Code and Codex sessions in Activity (start and end hooks), so the plugin is optional and no longer declares the MCP server; doctor asks for summon connect claude; Fix with AI skips crashes already handed to an agent.
Update: Features: Settings › General › Permissions asks for Accessibility in one click; summon skills link links only into agents that are installed.
Update: Features: the agent hotkey and Ask Agent start the agent with what is on screen (app, window, selected text, browser page, Finder selection), each field can be turned off.
Update: Features: sessions through summon mcp take a checkpoint before the first change and are logged under the agent's name; the panel offers "Undo <Agent> Session (N changes)…" only when there is something to undo.
New: Agent MCP configs: where the eight agents summon connect reaches keep their MCP servers, instructions and start hooks.
Update: Features: summon connect adds a session-start hook (summon context --hook <agent>) to Claude Code, Codex, Cursor and the Antigravity CLI, so sessions start with the Mac snapshot.
Update: Features: summon connect / disconnect register the MCP server and a This Mac note with every installed agent; Hermes and OpenClaw join the agent registry.
Update: Features, Tools, Install for agents: release.yml builds a universal, ad-hoc signed SummonOS release (zip, SHA256SUMS, attestation, prerelease on a v* tag); install.sh installs the newest release by default, verifies its checksum, falls back to source, and offers summon connect.
Update: Features: summon mcp, an MCP server with 10 tools (Mac context, macctl settings with undo, checkpoints, crashes) for every agent; the Claude Code plugin declares it.
Update: Features: one SummonOS version (VERSION, 0.1.0): summon version/--version, macctl --version, shown by summon doctor. CI runs once per PR, adds macos-15 and an informational Xcode 27 leg, and skips Swift jobs on docs-only changes.
Update: Features: summon context gives agents one snapshot of this Mac, with fields the user can hide in Settings › Agents; Settings lists all 7 tabs; Visual QA opens the panel (there is no launcher window).
Update: Features: every agent prompt carries a Summon session brief; crash alerts are one style (Summon alert or banner) and never take the keyboard; task results come from Summon.app with Show Log and Ask Agent.
Update: Features: Summon's menu bar icon shows a running agent's elapsed time and tells VoiceOver; keyboard and URL panel opens are announced. New examples/menubar-panel-starter (tools/mp new <name> --panel).
Update: Menu bar and window mechanics: section 0, which requirement made SummonOS switch and what is still unverified.
Update: Features: macctl declares a recovery contract per setting, previews undo (undo --dry-run), gates settings by minimumOS, adds discover start|diff, and grows to 38 settings (macOS 26 menu icons, macOS 27 menu bar keyboard navigation).
Creation: Skill: summon-migrate: guides migrating external apps and legacy plugins into ~/Summon/Apps, adds summon project import and summon project register CLI commands, and migrated mac-network, mac-calendar, and mac-breathe.
Update: Features: added automated real-time health checks and "Fix with AI" triggers for all app projects, themes, and art assets (AppIcon.icns, UI screenshots, wallpapers, art jobs).
Update: Features: added dedicated "My Apps" section in Settings with category drill-down navigation matching the menu bar panel.
Update: Features: added interactive panel back button with keyboard Escape pop and Delete key navigation.
Update: Features: Settings and Activity windows now open as dedicated, foreground NSWindows centered on the active display.
Update: Security and recovery model: user bin directories (~/.bun/bin, ~/.local/bin) take strict precedence over Homebrew paths; child process output buffer expanded to 16MB; checkpoint error records sanitized to 2,000 chars.
Update: Features: added Appearance Theme Preview with 16:9 wallpaper thumbnail and Undo button; added one-click Homebrew installer for Ghostty and kitty terminals in Settings.
Update: Features: added ⌘↵ quick-launch for default agent in ~/Summon and "My Apps" section in the menu bar panel for Summon-built projects.
Update: Features CI section lists the new Visual QA (macOS) workflow: launcher and menu bar panel screenshots in light and dark on macOS 26 and 15, as run artifacts.
Update: features: the Summon Menu now lives in the menu bar panel (⌃⌥Space, summon panel); the separate launcher window is gone (PR #61).
Creation: ADR: macctl prior state, journal and recovery: per-key prior state, write-once header plus JSONL journal, macctl recover, the recovery_pending gate and test-only failpoints.
Update: Security and recovery model covers the journal, its HMAC key, safe session ids and undo --force; Features describes crash recovery and partial_restore.
Update: SummonOS made public under the owner’s approval; live GitHub CI verified after correcting non-relocatable Swift build caching.
Creation: Design skills and public preview: controlled skill tests, rendered samples, privacy review, and publication verification.
Update: six design skills retested and repaired; CI now checks routing/references and typechecks Swift examples targeting macOS 15. Provider icon provenance is pinned in Summon’s third-party notices.
Creation: Security and recovery model: execution authority, exact checkpoint coverage, private diagnostics, tasks, and release boundaries.
Update: feature, install, contribution and tooling docs follow the implemented hardening, ownership-aware uninstall, exact-source releases, and optional signing pipeline.
Creation: SummonOS production readiness: source audit, README URL review, verified test baseline, release blockers, and proposed implementation gates.
Update: docs/ became an Open Knowledge Format bundle: frontmatter on every concept, generated index.md per folder, this log. The plans table moved from plans/README.md to plans/index.md.