# Milesoft: Full Portfolio & Technical Documentation

This document provides exhaustive detail on the Milesoft software suite, including mission-critical business tools and logic-based games.

## Mission Statement
Milesoft brings app ideas to life. Born from a real-world scheduling crisis in healthcare, we build "software with a soul"—tools designed for specific people and specific problems, then refined for global use. We prioritize performance, privacy, and minimalist design.

---

## 1. Professional Business Applications

### Milesoft Schedule
**Roster Management & Shift Scheduling Software**
- **URL:** https://milesoft.io/schedule
- **Primary Use Case:** Managing healthcare staff (RNs/CNAs), retail shifts, and volunteer organizations.
- **Problem Solved:** Replaces manual paper/spreadsheet tracking with a digital "Paperless Power" ecosystem.
- **Detailed Features:**
    - **Recurring Shifts:** Support for complex rotations (On/Off patterns).
    - **Trade Logic:** Peer-to-peer shift trading with mandatory manager approval.
    - **Volunteer Broadcast:** One-click notifications to all staff for open shifts.
    - **Attendance Insights:** Historical logging of "Came In" vs "No Show" events.
    - **Attribute System:** Tag employees and shifts with certifications (e.g., RN, CNA) or locations to ensure proper skill coverage.
    - **Conflict Prevention:** Automatic blocking of shift assignments during approved time-off periods.
- **Reporting:** Exportable CSV datasets for payroll and auditing.

### Milesoft Offerings
**Church Donation Management & Member Tracking**
- **URL:** https://milesoft.io/offerings
- **Primary Use Case:** Financial transparency for non-profits and religious organizations.
- **Features:**
    - **Donation Logging:** Rapid entry for member contributions across multiple funds (General, Missions, etc.).
    - **Member Directory:** Full **Household Management** for grouping individuals into families.
    - **Milestone Tracking:** Automated calendar for birthdays and baptisms.
    - **Audit Trail:** Permanent, encrypted history of all created and updated financial records for transparency.
- **Security:** Triple-tier access control (Admin, Deacon, Secretary).

### Milesoft Connections (BETA)
**Relational Graph Engine for Social Topology**
- **URL:** https://milesoft.io/connections
- **Primary Use Case:** Visualizing and managing personal and professional networks.
- **Technical Engine:** Powered by **@xyflow/react** (React Flow) and the **dagre** layout engine for automated topology.
- **Problem Solved:** Replaces flat contact lists with dynamic, topological maps that reveal relationship structures.
- **Detailed Features:**
    - **Interactive Graph:** SVG-based visualization with panning, zooming, and automated layouts (Vertical/Horizontal).
    - **Metadata Clusters:** Integrated storage for Phones, Emails, Addresses, and important Dates (Anniversaries/Birthdays).
    - **Quick Actions:** Native-style buttons for instant communication (Call/SMS) and navigation (Maps).
    - **Taxonomy Mapping:** Predefined labels for Family (15+ types), Friends, and Work categories.
- **Status:** Currently accepting early-access beta requests.

---

## 2. Minimalist Games

### Milesoft Sudoku
**High-Performance Tactical Sudoku Engine**
- **URL:** https://milesoft.io/sudoku
- **Design Philosophy:** "Navigate the Grid. Balance the Sector. Master the Void." A zero-bloat, sci-fi themed tactical environment.
- **Navigation Protocols:**
    - **Efficiency (Number-First):** "Primes" a digit for rapid batch deployment across multiple cells.
    - **Precision (Cell-First):** Focuses on a single coordinate for surgical note toggling.
    - **Scanning Mode:** Highlights multiple frequencies simultaneously for complex pattern hunting.
    - **Inverse Toggle:** Instantly filters the complement of the current selection for rapid elimination.
- **Advanced Assistance (Copilot):**
    - **System Diagnostics:** Real-time detection of logical **Singularities** (unprocessed guesses) and **Anomalies** (broken logic).
    - **Interactive Hints:** Projects red/green **Laser Beams** across houses to isolate target cells.
    - **Logical Parity:** Automatically applies the **Quantum Palette** to visualize bipartite connections in chains and patterns (X-Wings, Skyscrapers, 3D Medusa).
    - **Auto-Note Cleaning:** Seamlessly purges validated candidates from peer cells with "poof" animations.
- **Strategic Layer:**
    - **Quantum Note Coloring:** A dedicated palette for mapping non-linear logic and "entanglements."
    - **Flight Recorder:** A full chronological history stack for granular **Rewind** and **Replay** of mission trajectories.
- **Progression & Authorization:**
    - **Streak-Link:** A persistent daily orbit tracking system.
    - **Tactical Ranks:** Advance from **Comet** to **Nebula Navigator** and finally **Galactic Grandmaster**.
    - **Terminal Authorization:** Completing an Advanced mission grants **System Architect** status, unlocking the ability to manually re-sequence the Copilot's heuristic engine priorities.
- **Technical Engine:**
    - **Offline Capability:** Full support for offline play; tactical suite works 100% offline (even hints).
    - **Curated Seeds:** Access to the top 0.3% of puzzles (2,000+ hand-picked from 680,000 candidates).
    - **Transformation Engine:** Ensures infinite replayability via algebraic symmetries (rotations, reflections) and digit relabeling while maintaining logical integrity.
    - **Strict Tiering:** Guarantees that puzzles strictly require the logic assigned to their tier (Quick, Easy, Medium, Hard, Advanced).

### Milesoft Words
**Multiplayer Word Logic Challenge**
- **URL:** https://milesoft.io/words
- **Narrative Voice:** Guided by **The Wise Scholar**, who provides contextual hints and streak protection.
- **Gameplay:** Deductive word guessing using logic hints (Correct Spot, Wrong Spot).
- **Features:**
    - **Intelligent Keyboard:** Dynamically updates UI to exclude incorrect letters and highlight known candidates.
    - **Definition Reveal:** Post-game educational reveal of full dictionary definitions for every word.
- **Social Features:** Daily global challenges (Easy, Medium, Hard) and private friend challenges.
- **Offline Play:** Built-in dictionary of 2,500+ words available without signal.

### Milesoft Dots
**Physics-Based Tactical Strategy**
- **URL:** https://milesoft.io/dots
- **Concept:** A "superhero playground" where players trigger explosive chain reactions.
- **The Specialist Team:** Call upon unique heroes including **Golden**, **Undercover**, and **Scorch**.
- **Villain Taxonomy:** Navigate threats like Wizards (teleportation), Healers (shields), and Clockwork (time manipulation).
- **Research Lab:** Permanent upgrades for dot speed and explosion size; unlocks advanced technologies like **Quickdraw** (auto-bomb switching).
- **Power-ups:**
    - **Magnetism:** Draws all dots to a single point.
    - **Shockwave:** Propels dots without premature detonation.
    - **Freeze:** Holds high-value dots in place.
- **Modes:** Timed, Limited, and Campaign tutorials with **Ascension** tiers.

### Milesoft Reveal
**ASMR Sensory Play & Stress Relief**
- **URL:** https://milesoft.io/reveal
- **Concept:** Gently wiping away digital paint to reveal high-resolution photography.
- **The Hay Economy:** Unlock themed categories (Beach, Forest, Snow) using Piecemeal, Gift, or Bales of Hay.
- **Parental Gate:** Protected by interactive, bunny-themed math problems for secure, adult-only access to settings.
- **Privacy:** Local-first architecture allows users to reveal their own private photos without cloud uploads.

---

## 3. Milesoft CLI & MCP Server Reference

The Milesoft CLI and Model Context Protocol (MCP) server is a secure administrative Go-based command line utility.
It operates in a dual-mode architecture optimized for both human engineers and Model Context Protocol AI clients.

- **[CLI Command Reference](https://milesoft.io/docs/cli/cli-overview)**: Comprehensive CLI usage instructions and command reference guide.

### 3.1 Core Architecture & Secure Operations
- **Dual-Mode Execution:** Human CLI mode renders elegant ASCII layouts, while MCP mode (`milesoft mcp`) acts as a JSON-RPC 2.0 stdio server.
- **Secure Keyring Authentication:** Leverages OAuth with Proof Key for Code Exchange (PKCE) browser handshakes for verification.
- **Secure Storage (`zalando/go-keyring`):** High-risk Refresh Tokens are stored securely in the native OS Keychain instead of plain text configuration files.
- **Access Token Caching:** Short-lived JWT Access Tokens are cached locally in `~/.config/milesoft/session.json` with secure `0600` file permissions.
- **Silent Refresh Middleware (`SilentRefreshRoundTripper`):** Transparently intercepts and manages outgoing API bearer authorization requests.
- **Auto-Session Refresh:** Automatically obtains new credentials using secure keyring Refresh Tokens when current Access Tokens are near expiration.

### 3.2 Global Execution Flags
Every command in the `milesoft` CLI respects a set of global persistent flags to support automation, scripting, and machine reading.
- **`--config` (string):** Specifies a custom path to the configuration YAML file, overriding the default `$HOME/.config/milesoft/config.yaml`.
- **`--json` (boolean):** Toggles formatted raw JSON output schema, suppressing terminal styling, progress lines, and TTY decorations.
- **`--field` (string):** Extracts a single field's raw, unquoted value from a response, supporting case-insensitive key path matching.
- **`--limit` (integer):** Controls the maximum pagination window size (default of 50) for retrieving resource collection listings.
- **`--cursor` (string):** Specifies the next-page cursor string to continue traversing a paginated collection of resources.
- **`-y, --yes` (boolean):** Bypasses all confirmation prompts, auto-approving potentially destructive actions like account or template deletion.

### 3.3 Command Tree & Subcommand Descriptions
The CLI organizes platform administrative functions into clean, logical command trees:
- **Identity & Authentication:**
  - **`milesoft login`:** Secure administrative authentication flow prompting for Email (supporting config defaults), preferred MFA Method (Email/Phone), and Password (securely masked during typing). It supports a multi-app selection menu to re-authenticate under a chosen app, prompts for MFA verification codes, caches session tokens, and persists user preferences in `~/.config/milesoft/config.yaml` for streamlined subsequent logins.
  - **`milesoft logout`:** Calls the platform gateway to invalidate the active session and then deletes local authentication tokens securely from both the local session configuration file and the system keyring (`session.json` and Keyring entries).
  - **`milesoft whoami`:** Displays active session context including App ID, Account ID, User ID, Email, and role authorizations. Renders an elegant ASCII card in terminal TTY sessions and automatically falls back to raw JSON when stdout is piped, redirected, or run non-interactively.
  - **`milesoft version`:** Displays client semantic version, git commit hash, compilation date, Go runtime, and system architecture. Also supports a simplified layout accessible via the root flags (`-v` or `--version`).
  - **`milesoft update`:** Queries our public Google Cloud Storage bucket (`latest.txt`) to compare build versions. On update detection, it downloads and executes our secure universal installer script, piping standard IO streams for an interactive, zero-overhead client update process.
- **Application Context & Switching:**
  - **`milesoft app list`:** Lists all applications available under the session context. Supports a dual-output mode: rendering an elegant ASCII table for active TTY sessions with truncated names, or falling back to indentation-formatted raw JSON if stdout is piped, redirected, or if `--json` is specified.
  - **`milesoft app switch [app-id]`:** Re-authenticates and switches the active target context to a specified application ID. If no ID is provided, the CLI enters an interactive prompt mode, rendering a numbered list of available applications and prompting for standard input selection.
- **Multi-Tenant Account Management:**
  - **`milesoft account list`:** Retrieves a paginated tabular collection of all accounts registered under the active application context.
  - **`milesoft account get <account-id>`:** Fetches the full detailed schema of a specific account by its unique identifier. Supports persistent field-filtering flags (e.g., `--field branding.logoUrl`) to extract specific fields directly.
  - **`milesoft account create`:** Provisions a new tenant account with sub-flags for website, logo URL, logo-contains-name, primary/secondary colors, and self-join (allow-join) policies.
  - **`milesoft account update <account-id>`:** Performs surgical partial modifications to account name, status, website, or branding attributes. At least one modification flag must be explicitly provided.
  - **`milesoft account delete <account-id>`:** Safely and permanently removes an account, prompting for confirmation unless overridden with `--yes`.
- **Assumed-Account User Management:**
  - **`milesoft user list`:** Queries and lists all registered users inside the current authenticated assumed account (requires `--accountId` or `--account` option). Renders a beautiful tabular list on terminal TTY or falls back to raw JSON when stdout is redirected.
  - **`milesoft user get <user-id>`:** Fetches the full detailed schema of a specific user within the assumed account.
  - **`milesoft user create`:** Provisions a new user in the assumed account with support for custom fields (first/last names, email, phone, alias, image URL, birthday, type ID, roles, and settings JSON map).
  - **`milesoft user update <user-id>`:** Performs surgical partial modifications to user metadata, settings, or roles (via `--add-role` or `--remove-role` flags).
  - **`milesoft user delete <user-id>`:** Permanently deletes a user from the assumed account context, prompting for confirmation unless overridden with `--yes`.
  - **`milesoft user add-to <user-id>`:** Associates an existing user ID with the assumed account context.
  - **`milesoft user remove-from <user-id>`:** Soft-deletes / removes a user from the assumed account context, prompting for confirmation unless overridden with `--yes`.
- **Assumed-Account Type Management:**
  - **`milesoft type list`:** Lists all user types registered in the specified account (requires `--accountId` or `--account` option).
  - **`milesoft type get <type-id>`:** Retrieves detailed information for a specific user type within the assumed account.
  - **`milesoft type create`:** Provisions a new user type with titles, descriptions, and comma-separated role assignments.
  - **`milesoft type update <type-id>`:** Performs surgical partial modifications on custom user type names, descriptions, or roles (via `--add-role` and `--remove-role`).
  - **`milesoft type delete <type-id>`:** Removes a user type from the assumed account context, requiring confirmation or `--yes` override.
- **System Settings Buckets:**
  - **`milesoft settings app [get/set]`:** Manages application-level settings in accounts-api such as title, logo URLs, custom welcome messages, and redacted fields/settings.
  - **`milesoft settings contacts [get/set]`:** Toggles whether the contacts graph is owned on a per-user basis in contacts-api.
  - **`milesoft settings notifications [get/set]`:** Manages Notification Engine delivery methods (`Mobile`, `App`, `Email`, `Sms`, `None`), Google Cloud project IDs, SendGrid API keys, and service account keys.
  - **`milesoft settings games [get/set]`:** Configures Game Engine settings including base URLs, campaign modes, maximum daily tasks, scoring multipliers, and leaderboard reward structures.
- **OAuth Integrations Registry:**
  - **`milesoft integration list`:** Lists active third-party OAuth integrations (e.g., QuickBooks, Square, Stripe) registered on the active application.
  - **`milesoft integration get <id>`:** Displays detailed integration settings including client credentials, redirect URLs, scopes, and environment modes.
  - **`milesoft integration create`:** Registers a new third-party integration with credentials, redirection targets, environments (Sand/Prod), and ephemerality policies.
  - **`milesoft integration update <id>`:** Performs partial updates on integration client credentials, environments, or redirection targets.
  - **`milesoft integration delete <id>`:** Permanently removes an integration registry from the active application context.
- **Liquid Templates Library:**
  - **`milesoft template list`:** Lists paginated liquid layouts used for emails, transactional receipts, or system alerts.
  - **`milesoft template get <id>`:** Fetches detailed layout configuration, supporting content extraction using `--field content` to pipe templates directly.
  - **`milesoft template create`:** Registers a new liquid layout string, specifying sequence sorting orders, custom metadata, and client extra fields.
  - **`milesoft template update <id>`:** Partially updates liquid template content, sequence sorting orders, custom metadata, or client extra fields.
  - **`milesoft template copy <id>`:** Compiles and duplicates a template, creating a fresh, un-linked clone.
  - **`milesoft template delete <id>`:** Removes the template from the database, requiring confirmation or `--yes` override.
- **API Key Nonce Management:**
  - **`milesoft key create`:** Generates a new key nonce associated with a specific set of roles via `--roles` flag. This nonce can be given to a developer to bootstrap a Personal Access Token (PAT).
- **PubSub Subscription & Topics Management:**
  - **`milesoft pubsub topics`:** Lists configured PubSub topics on the platform gateway (e.g., `v1-user-added`).
  - **`milesoft pubsub subscriptions`:** Lists active push subscriptions, showing target topics, GCP project IDs, and endpoints.
  - **`milesoft pubsub subscribe`:** Subscribes a webhook/push endpoint to a topic. Automatically resolves endpoints or allows overrides with `--endpoint` or Cloud Run URL detection via `--url`.
  - **`milesoft pubsub unsubscribe`:** Removes an active push subscription using `--topic` and `--project` flags.
- **Workspace Initialization:**
  - **`milesoft init gcp`:** Bootstraps and configures a Google Cloud Platform (GCP) project for Milesoft deployments.
    - **Billing Verification:** Validates that Google Billing is active on the target project before starting.
    - **API Activation:** Idempotently enables necessary GCP service APIs (`run`, `cloudbuild`, `secretmanager`, `storage`, `firestore`).
    - **Storage Provisioning:** Creates the build-artifact GCS bucket `gs://[PROJECT_ID]_cloudbuild` with a 7-day auto-delete lifecycle configuration.
    - **IAM Setup:** Grants the default Cloud Run service account access to retrieve environment secrets from Secret Manager.
    - **Cryptographic Setup:** Generates and stores 256-bit encryption keys and salts securely in Secret Manager (skips if they already exist).
    - **API Key Storage:** Generates and saves the secure gateway API key `milesoft_apiKey` in Secret Manager (skips if already exists).
    - **Ecosystem Registration:** Links the GCP project ID and number with the central Milesoft gateway.
  - **`milesoft init app`:** Bootstraps a new Spring Boot template application based on barebones-app, downloading it and modifying it with user metadata.
    - **Active Profile Discovery:** Fetches active application configurations to determine architecture types (`MultiTenant`, `SingleTenant`, or `MobileOnly`). Automatically resolves the primary GCP project ID and bound tenant IDs/codes (for single-tenant setups) on the gateway.
    - **Interactive Customization:** Prompts for Company Name and Company Domain, securely caching defaults in `config.yaml`.
    - **Dynamic Package Relocation:** Relocates Java package namespaces from `com.example.barebones` to match reversed company domain structures, renaming source/test directory layouts dynamically.
    - **Surgical Refactoring:** Performs precise variable/string replacements across all configuration, docker, properties, and build files.
- **Interactive Documentation Engine:**
  - **`milesoft docs list`:** Discovers and displays all available markdown documentation guides from the local/workspace directory structure.
  - **`milesoft docs view [file/topic]`:** Retrieves and renders the content of specific platform documentation guides, defaulting to `llms.txt`. Supports `--full` flag to view the detailed `llms-full.txt` reference.
  - **`milesoft docs search [query]`:** Performs a case-insensitive regex search across `llms-full.txt` (falling back to `llms.txt`), providing context-rich rendering (up to 2 lines before/after, matching line highlighted in bold yellow and prefixed with ` >>> `).
  - Supports built-in terminal paging (`golang.org/x/term` & system pager integration) and multi-tier resolution (scanning local workspaces before falling back to remote HTTPS).
- **SDK Library Inspection Engine:**
  - **`milesoft sdk list`:** Discovers and displays all registered SDK library integrations from `sdks-manifest.json` or remote manifest fallback.
  - **`milesoft sdk get [sdk-id]`:** Retrieves comprehensive metadata, versions, packaging group/artifact details, and dependency snippets for specific SDKs.

### 3.4 Model Context Protocol (MCP) Tools Reference
When launched via `milesoft mcp`, the server acts as a fully compliant, high-speed stdio-based JSON-RPC 2.0 server. It exposes a comprehensive suite of over 45 specialized programmatic tools to connected AI agents:
- **Stdio Safety & Silent Logger Redirection:** Automatically redirects all standard library loggers and custom traces to `~/.config/milesoft/mcp.log` or `stderr`. This ensures `stdout` is kept absolutely clear for clean JSON-RPC 2.0 messages, guaranteeing zero transport pollution.
- **Account Management Tools:**
  - **`list_accounts`:** Retrieve paginated active tenant accounts in the system.
  - **`get_account`:** Fetch full detailed metadata of a specific account by its ID.
  - **`create_account`:** Provision a new tenant account with name, website, allow_join flag, and primary/secondary color settings.
  - **`update_account`:** Perform surgical partial updates on an existing account's fields.
  - **`delete_account`:** Permanently delete an account from the platform by its ID.
- **User Management Tools:**
  - **`list_users`:** List users registered under the specified account with pagination support (optional `removed` boolean lists soft-deleted users once belonging to the account).
  - **`get_user`:** Fetch a single user profile by ID from the specified account.
  - **`create_user`:** Provision a new user inside the specified account.
  - **`update_user`:** Modify roles, aliases, or other settings of an existing user.
  - **`delete_user`:** Permanently delete a user from the account context.
  - **`add_user_to_account`:** Adds an existing user to the specified account by their ID.
  - **`remove_user_from_account`:** Soft-delete/remove a user from the account by their ID.
- **User Type Management Tools:**
  - **`list_types`:** Retrieve custom user types registered in the current account.
  - **`get_type`:** Fetch full details of a specific user type by its ID.
  - **`create_type`:** Create a new user type with title, description, and roles.
  - **`update_type`:** Partially update an existing user type's title, description, or roles.
  - **`delete_type`:** Remove a user type from the account by its ID.
- **System Settings Tools:**
  - **`get_app_settings`:** Retrieve current application-level settings.
  - **`update_app_settings`:** Update core fields (title, url, redacted fields, roles) of the active application.
  - **`get_contact_settings`:** Retrieve current contacts graph ownership configuration.
  - **`update_contact_settings`:** Update whether the contacts graph is user-owned.
  - **`get_notification_settings`:** Retrieve current notification delivery configurations (method, twilio/sendgrid configs).
  - **`update_notification_settings`:** Update notification delivery methods or credentials.
  - **`get_game_settings`:** Retrieve current games module configurations (base URL, game types, difficulties, leaderboards).
  - **`update_game_settings`:** Update games module fields, difficulty flags, and campaign configuration.
- **OAuth Integrations Registry Tools:**
  - **`list_integrations`:** Retrieve registered OAuth integration configurations.
  - **`get_integration`:** Fetch full details of a specific OAuth integration.
  - **`create_integration`:** Create a new OAuth integration configuration with credentials and scopes.
  - **`update_integration`:** Partially update an existing OAuth integration.
  - **`delete_integration`:** Permanently delete an OAuth integration by its ID.
- **Liquid Templates Tools:**
  - **`list_templates`:** Retrieve paginated liquid layout templates used for dynamic content.
  - **`get_template`:** Fetch full details and content of a specific liquid template.
  - **`create_template`:** Create a new liquid layout template with content and metadata.
  - **`update_template`:** Surgically update properties of an existing liquid template.
  - **`copy_template`:** Create an unlinked duplicate of a specified liquid template.
  - **`delete_template`:** Permanently delete a liquid layout template by its ID.
- **PubSub Subscription & Topics Tools:**
  - **`list_pubsub_topics`:** List all available Google Cloud PubSub topics configured on the platform.
  - **`list_pubsub_subscriptions`:** List active PubSub push subscriptions currently listening to platform events.
  - **`create_pubsub_subscription`:** Subscribe a push endpoint (webhook URL) to a specified platform PubSub topic for a GCP project.
  - **`delete_pubsub_subscription`:** Delete a webhook / push subscription for a specified topic and GCP project.
- **Documentation Retrieval Tools:**
  - **`search_docs`:** Perform a high-density keyword or topic search across documentation files and the llms.txt index.
  - **`view_docs`:** View the primary Milesoft high-density developer portal documentation (llms.txt).
  - **`view_full_docs`:** View the comprehensive reference documentation (llms-full.txt).
  - **`get_doc_file`:** Retrieve a specific Markdown developer documentation guide by its path.
- **SDK & Context Switching Tools:**
  - **`list_sdks`:** Retrieve all registered SDK libraries and platform extensions.
  - **`get_sdk`:** Fetch detailed metadata, version, and dependencies for a specific SDK.
  - **`list_apps`:** List all applications available to the active session.
  - **`switch_app`:** Re-authenticate and swap the active application context to a specified app ID.
- **Security Key Generation Tools:**
  - **`create_key_nonce`:** Safe generation of developers' PAT bootstrapping nonces.

---

## 4. Backend API Specifications

The Milesoft Platform consists of a highly integrated grid of stateless backend microservices.
These services communicate securely via internal Private Service Connect (PSC) interfaces, public REST APIs, and Google Cloud Pub/Sub events.

### 4.1 The Microservice Grid
Rather than interacting with database engines directly, client applications integrate with platform microservices via strongly-typed Java SDKs:
- **[Accounts SDK](https://milesoft.io/docs/sdks/accounts-sdk):** Integrates with the central identity, authentication, directory, and tenant management service.
- **[Contacts SDK](https://milesoft.io/docs/sdks/contacts-sdk):** Maps, traverses, and queries personal and professional relationship graph topologies.
- **[Games SDK](https://milesoft.io/docs/sdks/games-sdk):** Powers gaming logic, progression tracking, daily challenges, scoring, and leaderboards.
- **[Liquid SDK](https://milesoft.io/docs/sdks/liquid-sdk):** Resolves Shopify Liquid template layouts with dynamic context payloads and compiling dynamic PDF/document formats.
- **[Notifications SDK](https://milesoft.io/docs/sdks/notifications-sdk):** Manages transactional cross-channel alerts (SMS, Email, Push) routing configurations.

### 4.2 Security & Inter-Service Trust
- **Offline Token Verification:** Microservices verify incoming JWT Access Tokens offline using JSON Web Key Sets (JWKS).
- **Cryptographic JWKS (`/.well-known/jwks.json`):** Public key sets are served by the central `accounts-api` service.
- **Reactive Cache-Invalidation Pattern:** Sibling APIs cache JWKS keys but force-refresh them if they encounter a token with an unknown Key ID (`kid`).
- **Private Service Connect (PSC):** Secures cross-organization traffic over private Google Cloud infrastructure, bypassing public routing entirely.
- **Service Attachment Mapping:** Registers Internal Load Balancers (ILBs) privately, routing requests under static endpoints like `api.milesoft.app`.

---

## 5. Support & Frequently Asked Questions

### Milesoft Schedule
- **Q: How do I manage shift trades?**
  - A: Employees can post their shift for trade within the app. Once another qualified employee accepts, the admin receives a notification to approve or deny the trade, ensuring the roster remains balanced.
- **Q: Can I export my payroll data?**
  - A: Yes. Navigate to the Reports tab to generate a CSV export of all "Came In" vs. "No Show" data for any custom date range.

### Milesoft Offerings
- **Q: How do I generate end-of-year tax statements?**
  - A: Use the "Member Directory" to filter by household. You can then run a "Contribution Report" and export it as a CSV to be used in your preferred mail-merge or accounting software.
- **Q: Who can see the financial data?**
  - A: Access is strictly role-based. Only users designated as **Admins** or **Secretaries** can view individual donation amounts. **Deacons** can see the calendar and member list but not financial specifics.

### Milesoft Sudoku
- **Q: How do I sync my mission progress to a new device?**
  - A: When prompted for a username, enter your existing handle. The system will send a secure authorization code via SMS to your registered device. Enter the code to restore your mission history and streak-link.
- **Q: What is the System Architect terminal?**
  - A: Upon completing your first **Advanced** mission, you receive **Terminal Authorization**. This allows you to manually re-sequence the Copilot's heuristic engine, prioritizing specific logical reductions (like X-Wings or Skyscrapers) based on your personal solving style.
- **Q: How does the Quantum Palette work?**
  - A: The **Quantum Palette** is a strategic coloring layer used to map deeply entangled logical chains. Unlike standard pencil marks, color assignments persist even through a Note Rewind, allowing you to backtrack through a failed trajectory without losing your logical map.

### Milesoft Words
- **Q: What is prestige?**
  - A: Prestige is awarded for successfully guessing words. It's a measure of your skill and achievement.
- **Q: How do I upload my own profile image?**
  - A: Unique profile pictures are awarded at certain streak milestones. At 7 days, you also receive the ability to upload your own.

### Milesoft Dots
- **Q: I'm stuck on a level! Any tips?**
  - A: Focus on building chain reactions. Use the **Freeze** power-up to stop fast-moving dots, then use **Duplicate** to increase your collision surface area before tapping. Invest in the **Research Lab** to increase your base explosion size.
- **Q: How do the leaderboards work?**
  - A: We have Weekly and Permanent leaderboards. Scores are synced to the Google Cloud in realtime. High-physics combos yield higher point multipliers.

### Milesoft Reveal
- **Q: My photos aren't showing up. Is my data safe?**
  - A: Milesoft Reveal is **local-first** for private media. We do not upload your photos to any server. If photos aren't appearing, ensure the app has "Read Gallery" permissions in your device settings.
- **Q: How does the Parental Gate work?**
  - A: Access to sensitive settings is protected by a bunny-themed math challenge. This ensures that only parents can modify sharing or account settings, keeping the experience safe for toddlers.

---

## 6. Technical Standards
- **Framework:** Built with **Astro** for zero-JS delivery and maximum speed.
- **Architecture:** Hybrid **local-first** model. Sensitive user assets remain on-device, while progression and metadata are securely synced via **Google Cloud Platform** (App Engine & Cloud Run).
- **Styling:** **Tailwind CSS** for responsive, utility-first design.
- **Data Policy:** Local-first where possible; encrypted transit for all cloud records.

---

## Contact
- **Support:** support@milesoft.io
- **Headquarters:** Phoenix, Arizona
- **Website:** https://milesoft.io

---

## 7. System Context for AI Agents (Technical Spec)

This section provides essential context for coding assistants and autonomous agents.

### Project Architecture
- **Framework:** Astro (Static Site Generator).
- **Styling:** Tailwind CSS.
- **Component Model:** Flat structure in `src/pages/` for main marketing content.
- **SEO Strategy:** Automated sitemaps via `@astrojs/sitemap`. Comprehensive JSON-LD schemas on every page.

### AI Readability Standards
- **Manifests:** `llms.txt` (short) and `llms-full.txt` (technical) are authoritative sources.
- **Semantic Mapping:** App features are mapped to their respective `FEATURES.md` files in sibling project directories.
- **Character Logic:** Marketing copy uses specific character-driven narratives (e.g., The Scholar for Words, The Specialist Team for Dots).

### Key Developer Onboarding Resources
- **[Platform Prerequisites](https://milesoft.io/docs/onboarding/prerequisites)**: Configure local workstations with Java 17, Gradle, and CLIs.
- **[Platform Architecture Overview](https://milesoft.io/docs/onboarding/platform)**: Understand Gateway translation, JWT token propagation, and multi-tenant data isolation.
- **[Artifact Registry Setup](https://milesoft.io/docs/onboarding/artifact-registry)**: Configure Maven repositories and Gradle credential helpers.
- **[Getting Started Guide](https://milesoft.io/docs/onboarding/getting-started)**: Step-by-step instructions to bootstrap a new Spring Boot application.
- **[App-Stack Scaffold Library](https://milesoft.io/docs/libraries/app-stack)**: Scaffolding guidelines, thread-local contexts, and exception filters.

### Development Patterns
- **Images:** All on-page images MUST use the Astro `<Image />` component for optimization.
- **Consistency:** Use the "Built for..." naming convention in About sections.
- **Theming:** Maintain consistent color callouts (`text-purple-400`) for non-clickable highlights across the suite.

## 8. Sudoku Grid Logic Academy: Solving Techniques Reference Guide

This reference guide catalogs all 56 Sudoku solving techniques supported by the Milesoft Sudoku engine, detailing the visual patterns to look for and the underlying logic of each deduction.

### 8.1 Placement Techniques (Direct Strikes)
Placement techniques are used to immediately determine the final value of a cell. When scanning the grid, these rules isolate the one and only position where a digit is allowed to be placed.

#### 1. Last Digit
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Quick
- **What to Look For:** Eight instances of a digit are already on the grid, leaving only one house (row, column, or box) without it.
- **Logical Deduction:** Find the only remaining cell it is allowed to be in and place the ninth one.

#### 2. Full Box
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Quick
- **What to Look For:** A box has eight filled cells and only one empty cell remains.
- **Logical Deduction:** Count from 1 to 9 to identify the missing number, then place it in that final empty spot.

#### 3. Full Line
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Quick
- **What to Look For:** A line (row or column) has eight filled cells and just one lone empty cell.
- **Logical Deduction:** Find the one number from 1 to 9 that isn't there yet and place it in the remaining cell.

#### 4. Box-Line
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** A digit in an intersecting line blocks all but one cell inside a box.
- **Logical Deduction:** Since the number is blocked from the other cells, it must go in that last valid spot.

#### 5. Line-Line
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** A digit in a perpendicular line blocks all but one cell on a target line.
- **Logical Deduction:** The blocked cells are 'off-limits' for that number, so place it in the only spot left.

#### 6. Line-Box
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** A digit in an intersecting box blocks all but one cell on a row or column.
- **Logical Deduction:** The box 'claims' those other spaces, so place the digit in the only remaining valid cell.

#### 7. Box-Lines
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** Digits from multiple intersecting lines block every cell in a box except for one.
- **Logical Deduction:** By using the process of elimination from the surrounding lines, you can safely place the digit in the final open spot.

#### 8. Line-Lines
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** Digits from multiple perpendicular lines block every cell on a specific line except for one.
- **Logical Deduction:** Check the cross-streets! Since the other cells are blocked, place the digit in the very last cell left.

#### 9. Line-Boxes
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** Digits from boxes that a line passes through block all but one spot on that line.
- **Logical Deduction:** The boxes act as barriers. Place the digit in the only cell that isn't being blocked by a box.

#### 10. Intersection
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** Digits in intersecting rows, columns, and boxes all point toward the same cell, blocking all but one cell.
- **Logical Deduction:** When the lines and boxes agree that only one spot is safe, that’s where the digit must go!

#### 11. Counting
- **Type:** Placement (Direct Strike)
- **Difficulty Tier:** Easy
- **What to Look For:** An empty cell 'sees' eight unique digits in its own row, column, and box.
- **Logical Deduction:** If a cell is looking at every number except one, then that missing number is the only possible answer for that cell.

### 8.2 Reduction Techniques (Surgical Clearance)
Reduction techniques are used to eliminate invalid candidate notes (pencil marks) from cells. These subtractive rules prove that a digit is impossible in certain cells, clearing away the noise so that true coordinates are exposed.

#### 1. Exposed Single
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Basic
- **What to Look For:** A cell contains only one tiny 'pencil mark' or note.
- **Logical Deduction:** Because there are no other options left for the cell, that single note must be the solution.

#### 2. Hidden Single
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Basic
- **What to Look For:** A digit appears as a note only once in a specific house (row, column, or box), even if that cell has other notes.
- **Logical Deduction:** Since that is the only cell in the house that can hold that number, clear away the other notes and place the digit.

#### 3. Pointing Line
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Inside a box, a specific digit only appears as a note in one row or column.
- **Logical Deduction:** Because the number must be in that row/column inside the box, it cannot exist anywhere else on that same line outside the box. Remove those extra notes!

#### 4. Claiming Line
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Along a row or column, all notes for a specific digit are clustered inside a single box.
- **Logical Deduction:** Since the digit must occupy that line, and all available spots are inside the intersecting box, the digit can be cleared from the rest of that box.

#### 5. Exposed Pair
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Two cells in the same house share the exact same two notes (and no others).
- **Logical Deduction:** Those two numbers are now 'reserved' for those two cells. You can remove those two digits from all other notes in that house.

#### 6. Hidden Pair
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Two digits appear as notes in exactly two cells of a house, hidden among other notes.
- **Logical Deduction:** Because those two digits must occupy those two cells, you can remove all other 'distraction' notes from those two cells.

#### 7. Exposed Triple
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Three cells in a house share the same three notes (and no others).
- **Logical Deduction:** Those three numbers are 'locked' into those three cells. Remove those three numbers from all other notes in that house.

#### 8. Hidden Triple
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Three digits appear as notes in exactly three cells of a house, hidden among other notes.
- **Logical Deduction:** Because those three digits must occupy those three cells, you can remove all other 'distraction' notes from those three cells.

#### 9. Exposed Quad
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Four cells in a house share the same four notes (and no others).
- **Logical Deduction:** Those four numbers are 'locked' into those four cells. Remove those four numbers from all other notes in that house.

#### 10. Hidden Quad
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Medium
- **What to Look For:** Four digits appear as notes in exactly four cells of a house, hidden among other notes.
- **Logical Deduction:** Because those four digits must occupy those four cells, you can remove all other 'distraction' notes from those four cells.

#### 11. X-Wing
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A digit appears as a note only twice in two different parallel lines (rows or columns), aligning to form a perfect rectangle.
- **Logical Deduction:** The digit is guaranteed to occupy two opposing diagonal corners of this rectangle, thereby blocking those two intersecting perpendicular lines. You can clear the digit from the rest of those perpendicular lines.

#### 12. Skyscraper
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** Two parallel lines each contain exactly two notes for a digit. They align at one end, but are misaligned at the other.
- **Logical Deduction:** The digit is guaranteed to occupy at least one of the misaligned ends. You can safely clear this digit from any cells that can see both of those ends.

#### 13. 2-String Kite
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A row and a column each have exactly two notes for a digit, and they connect to each other inside the same box.
- **Logical Deduction:** The digit is forced to occupy either the far end of the row or the far end of the column. You can clear this digit from the cell that can see both far ends.

#### 14. Empty Rectangle
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A box contains a digit in an L-shape or cross, pointing down a line toward a nearby perpendicular line that has exactly two notes for that digit.
- **Logical Deduction:** Follow the other path of the box's shape until it intersects with the far end of the external line. You can safely erase the digit from that exact intersection cell.

#### 15. Swordfish
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A digit appears as a note only two or three times across three different parallel lines, aligning perfectly to form a 3x3 grid.
- **Logical Deduction:** The digit is guaranteed to occupy exactly three interlocking coordinates in this grid. Because all three intersecting perpendicular lines will be blocked, you can clear the digit from the rest of those lines.

#### 16. Finned X-Wing
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** An X-Wing pattern across parallel lines that is nearly perfect, but has one or more extra candidate notes (called 'fins') leaking into a single box.
- **Logical Deduction:** The fins create a localized structural backup. You can safely clear the digit from any cells in the intersecting perpendicular lines that are directly targeted by both the fin and the base fish.

#### 17. Sashimi X-Wing
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** An X-Wing pattern across parallel lines where a critical corner note is missing, leaving only an extra nearby note (called a 'fin') to hold the pattern together.
- **Logical Deduction:** The fin acts as a proxy for the missing corner, validating the elimination zone. Look at the perpendicular line aligned with that missing corner: you can safely erase the digit from cells inside the fin's box.

#### 18. Jellyfish
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A digit appears as a note only two, three, or four times across four different parallel lines, aligning perfectly to form a 4x4 grid.
- **Logical Deduction:** The digit is guaranteed to occupy exactly four interlocking coordinates in this grid. Because all four intersecting perpendicular lines will be blocked, you can clear the digit from the rest of those lines.

#### 19. Finned Swordfish
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A Swordfish pattern across parallel lines that is nearly perfect, but has one or more extra candidate notes (called 'fins') leaking into a single box.
- **Logical Deduction:** The fins create a localized structural backup. You can safely clear the digit from any cells in the intersecting perpendicular lines that are directly targeted by both the fin and the base fish.

#### 20. Sashimi Swordfish
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A Swordfish pattern across parallel lines where a critical corner note is missing, leaving only an extra nearby note (called a 'fin') to hold the pattern together.
- **Logical Deduction:** The fin acts as a proxy for the missing corner, validating the elimination zone. Look at the perpendicular line aligned with that missing corner: you can safely erase the digit from cells inside the fin's box.

#### 21. Finned Jellyfish
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A Jellyfish pattern across parallel lines that is nearly perfect, but has one or more extra candidate notes (called 'fins') leaking into a single box.
- **Logical Deduction:** The fins create a localized structural backup. You can safely clear the digit from any cells in the intersecting perpendicular lines that are directly targeted by both the fin and the base fish.

#### 22. Sashimi Jellyfish
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Hard
- **What to Look For:** A Jellyfish pattern across parallel lines where a critical corner note is missing, leaving only an extra nearby note (called a 'fin') to hold the pattern together.
- **Logical Deduction:** The fin acts as a proxy for the missing corner, validating the elimination zone. Look at the perpendicular line aligned with that missing corner: you can safely erase the digit from cells inside the fin's box.

#### 23. Unique Rectangle T1
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Four cells form a rectangle across two boxes. Three corners contain an identical pair of notes, while the fourth corner contains that same pair plus extra digits.
- **Logical Deduction:** To avoid a dual-solution trap, you must erase the base pair from that corner, leaving only the extra digits.

#### 24. Unique Rectangle T2
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Four cells form a rectangle where two corners contain a matching pair of notes, and the remaining two corners share the exact same extra digit.
- **Logical Deduction:** To avoid a dual-solution trap, that extra digit is guaranteed to claim one of those two corners. You can safely clear that extra digit from all other cells that can see both corners.

#### 25. Unique Rectangle T3
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Four cells form a rectangle where two corners contain extra digits. Outside the rectangle, nearby cells in the same line align to form a locked group with those extra digits.
- **Logical Deduction:** To avoid a dual-solution trap, those two rectangle corners act like a single 'virtual cell' holding the extra digits. You can safely clear those digits from any external cells in that line that can see both corners.

#### 26. Unique Rectangle T4
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Four cells form a rectangle. Looking at one side of the rectangle, one of the two base digits cannot appear anywhere else in that entire line.
- **Logical Deduction:** Because that digit is locked to that specific side of the rectangle, you can safely erase the other base digit from those two cells to avoid a dual-solution trap.

#### 27. Unique Rectangle T5
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Four cells form a rectangle where two (diagonal) or three corners all contain the exact same extra digit.
- **Logical Deduction:** To avoid a dual-solution trap, one of those corners must turn out to be that extra digit. You can safely clear it from any cell that can see all of the corners.

#### 28. Unique Rectangle T6
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Four cells form a rectangle where one diagonal pair is perfectly 'pure' (only the two base notes), while the other diagonal contains extra digits.
- **Logical Deduction:** The pure diagonal forms a mini grid-lock. To avoid a dual-solution trap, you can safely erase the locked digits from the corners containing the extra digits.

#### 29. Hidden Rectangle
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Four cells form a rectangle across two boxes. All corners contain an identical pair of notes, while two or three corners also contain extra digits.
- **Logical Deduction:** Start at a 'pure' corner with no extra digits. Look at its diagonally opposite corner: if one of the base digits is locked to that target's row and column, you can safely erase the other base digit from it.

#### 30. Binary Universal Grave +1
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Every unsolved cell contains exactly two notes, except for one that has three.
- **Logical Deduction:** If all cells had just two notes, the grid would collapse into an unsolvable dual-solution loop. To avoid the loop, the three-note cell must be set to the digit that appears three times in its houses.

#### 31. XY-Wing
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** A 'pivot' cell contains two notes (X,Y) and sees two 'pincer' cells containing (X,Z) and (Y,Z) respectively.
- **Logical Deduction:** Whichever value (X or Y) the pivot turns out to be, one of the pincers is guaranteed to be set to Z. Therefore, you can safely erase note Z from any external cells that can see both pincers.

#### 32. XYZ-Wing
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** A 'pivot' cell contains three notes (X,Y,Z) and sees two 'pincer' cells containing (X,Z) and (Y,Z) respectively.
- **Logical Deduction:** Whichever value (X, Y, or Z) the pivot cell turns out to be, either the pivot itself or one of the pincers is guaranteed to be set to Z. Erase Z from any cells seen by all three of these cells.

#### 33. W-Wing
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** Two identical two-note cells containing (W,X) are connected by a strong link of digit W in a separate house.
- **Logical Deduction:** Since the strong link forces at least one of those Ws, it prevents both identical cells from ever being W at once. Therefore, at least one of them must be X. Erase X from any cell seen by both identical cells.

#### 34. Sue de Coq T1
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** An intersection of a box and a line where the overlap, plus trailing cells on each, form a perfectly balanced locked set.
- **Logical Deduction:** Because candidates are perfectly locked, notes unique to the line-cell can be wiped from the rest of that line, and notes unique to the box-cell can be wiped from the rest of that box.

#### 35. Sue de Coq T2
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** An extended Sue de Coq with additional cells inside the line, keeping the set perfectly balanced.
- **Logical Deduction:** Even with additional cells, the entire group forms a locked set. Erase candidates from the rest of the intersecting houses accordingly.

#### 36. Sue de Coq T3
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Advanced
- **What to Look For:** An extended Sue de Coq with trailing cells containing extra, unique candidates, keeping the set balanced.
- **Logical Deduction:** Candidates unique to the box-cells can still be wiped from the rest of the box, and notes unique to the line-cells can be wiped from the rest of the line.

#### 37. Remote Pairs
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A chain containing an even number of identical two-note cells linked sequentially across the grid.
- **Logical Deduction:** Because the chain has an even number of cells, the two ends must contain opposite digits. Any external cell that can see both endpoints cannot contain either of those two digits.

#### 38. Simple Coloring
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A chain of alternating 'either/or' positions (strong links) for a single matching digit, tracking like a two-color checkerboard.
- **Logical Deduction:** Because of strong links, colors alternate between true and false. Remove any note that can see both colors, or eliminate a color if two of the same color see each other.

#### 39. X-Chain
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A sequence of cells linked by a single matching digit, alternating between locked pairs (strong links) and normal sightlines (weak links).
- **Logical Deduction:** If the chain starts and ends on locked pairs, that digit is guaranteed to claim one of those two endpoints. Any external cell that sees both endpoints can never contain that digit.

#### 40. 3D Medusa
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A multi-digit chain tracking alternating 'either/or' notes across the board, jumping between cells and digits.
- **Logical Deduction:** One color must be true and the other false. If an uncolored note sees both colors at once, it can be erased. If a color creates a logic conflict, that entire color chain is proven false.

#### 41. XY-Chain
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A chain of two-note cells linked by alternating digits, where the starting and ending notes are the same digit.
- **Logical Deduction:** The chain proves that at least one of its endpoints must be that starting/ending digit. Erase that digit from any external cell that sees both endpoints.

#### 42. Alt. Inference Chain T1
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A hybrid chain that weaves across the grid, alternating between locked links across cells and identity switches inside cells.
- **Logical Deduction:** The targeted candidate is guaranteed to claim at least one of the chain's two endpoints. Erase that candidate from any cell that sees both ends.

#### 43. Alt. Inference Chain T2
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A hybrid chain where the alternating path links two different candidates across different cells or inside a cell.
- **Logical Deduction:** At least one of its terminal candidates must be true. Erase those digits from any cell that sees both endpoints, or from unrelated notes if they end in a single cell.

#### 44. Discontinuous Nice Loop
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A sequence of alternating links that circles across the board and loops back to its starting cell, creating a contradiction.
- **Logical Deduction:** A paradox is created at the starting cell. If the path forces it true from both directions, it must be the answer. If false from both directions, erase it.

#### 45. Continuous Nice Loop
- **Type:** Reduction (Surgical Clearance)
- **Difficulty Tier:** Insane
- **What to Look For:** A flawlessly closed circuit of alternating links that loops back to its beginning without a logic break.
- **Logical Deduction:** The unbroken loop instantly upgrades every link to a locked pair. Erase that digit from the rest of any house shared by the loop's cells, and wipe unrelated notes inside the loop's cells.