Deterministic repair planning
Every repair plan is computed from explicit rules. No probabilistic guessing, no ML inference. The same drift always produces the same repair.
Aeostara for macOS
macOS implementation
Deterministic self-healing for macOS.
Aeostara detects configuration drift, plans safe remediation, verifies outcomes, and recovers automatically — built entirely in Swift 5.9+ with SwiftPM and Foundation.
The problem
Drift happens quietly. Repair should not be reckless.
Systems drift over time. Configuration files diverge from their intended state through manual edits, partial updates, failed deployments, and undocumented hotfixes. The gap between what a system should be and what it actually is grows silently, one changed value at a time.
Manual repair introduces its own risk. Engineers working under pressure make assumptions, skip validation steps, and apply fixes without verifying outcomes. Each ad-hoc correction becomes another source of potential drift — compounding the very problem it was meant to solve.
Fast fixes break trust and traceability. When teams discover drift during incidents — when the cost of repair is highest — the urgency to restore service overrides the discipline to repair safely. Without deterministic repair planning, verified outcomes, and complete audit trails, every fix is a gamble.
How it works
The recovery loop
- 01
Detect
Continuously monitor configuration files against declared desired state. Surface deviations before they become incidents.
- 02
Plan
Generate deterministic repair plans based on policy invariants. No heuristics, no guesswork — every repair is explicit.
- 03
Verify
Validate repair outcomes against acceptance criteria before finalizing. Failed verification triggers automatic rollback.
- 04
Recover
Execute safe repairs with timestamped backups, complete audit trails, and verified rollback capability.
Capabilities
Why Aeostara
Policy-gated actions
Repairs execute only when policy invariants are satisfied. Constraints are evaluated before mutation, not after.
Backup before mutation
Every configuration file is backed up with a timestamp before any modification. Recovery from a bad repair is always one step away.
Verification after execution
Repairs are verified against acceptance criteria immediately after execution. Failed verification triggers automatic rollback.
Rollback on failure
If verification fails, the system automatically restores the previous configuration from the timestamped backup. No manual intervention required.
Audit trail throughout
Every detection, plan, repair, verification, and rollback is logged to an append-only JSON Lines audit trail. Complete operational history.
Architecture
Platform stack
Three layers working together.
Aeostara platform
CLI tools, adapters, and configuration management interface.
ASH Pattern System
Deterministic healing engine with policy evaluation.
Forsetti Framework
Native modular runtime with contract enforcement.
macOS implementation
Built for this platform
Swift Foundation
Built on modern Swift 5.9+ with SwiftPM for dependency management. Native compiled binary using Foundation, with no external runtime dependencies.
Zero external dependencies
The only dependency is Apple’s Foundation framework. Everything else is implemented from first principles using the Swift standard library and SwiftPM module system.
XCTest coverage
Comprehensive test coverage using Apple’s XCTest framework. Every module — from policy evaluation to file operations — is tested against explicit acceptance criteria.
CLI interface
AeostaraMacCLI provides direct operator control over the entire self-healing lifecycle from the command line via five core commands.
Applications
Use cases
Golden configuration enforcement
Maintain known-good configuration state across environments. Detect deviations and restore automatically.
Controlled remediation
Apply targeted repairs to specific configuration properties without affecting unrelated settings.
Release and compliance workflows
Verify configuration state before and after deployments. Ensure compliance with organizational policies.
Operator tooling foundation
Provide CLI tools for teams who need direct control over validation, diffing, and repair operations.
Aeostara
Build safer recovery into your software stack.
Aeostara brings deterministic, policy-gated, verifiable self-healing to macOS — built entirely in Swift.