fairgradient-ai/aegis-desk
Aegis Desk: a read-only options position-monitoring and exit-alert desk for Grok Bot and Grok Build, run by the Aegis Desk Lead, the Aegis Exit Sentinel, Aegis Position Control, the Aegis Book & Risk Analyst, which shows exposures and stress views, the Aegis Events and Calendar Analyst, which keeps the event calendar, the Aegis Rules Steward, which keeps rulebook change control, the Aegis Review Desk, which posts the weekly review, counts only, and, only when you ask, the Aegis Structuring Desk, which prices choices for positions you hold by your own criteria. Stdlib tools compute every number; the desk never places, modifies or cancels an order.
How the read-only Aegis desk marks the book and when it refuses to, for the Aegis Exit Sentinel. The mid and liquidation marks and the mark_source gate, which side each rule reads, time to expiry, spot and days to expiry, implied volatility and its failure statuses, American Greeks in desk units with the sourced dividend yield and the early-exercise boundary band, unrealized, realized and day P/L from the desk's own snapshot, percent captured, max profit and loss and breakevens, and what UNAVAILABLE protects the owner from.
The voice and number rules every Aegis desk Bot follows in every post. Only numbers a tool printed, never arithmetic; the alert lint, its finding codes, its structuring mode and its red-team fixtures; the owner's-rule-fired wording with no advice; no order fields anywhere, and candidates in score order only from the Structuring Desk on request; accurate AI-role disclosure with the three fixed footers; and the one reply when the owner asks a Bot to trade.
How the Aegis desk measures covered calls and cash-secured puts and which example rules reach them, for the Aegis Exit Sentinel and the Aegis Structuring Desk. The take-profit and loss metric of each structure as the rules engine reads it, take-profit on the conservative side of the quote, the time, delta, pin, cap and earnings rules, the ex-dividend test and its cum-dividend bound, the row tags, the assignment words of the expiry docket, and what the desk never decides. It describes the owner's adopted rules; it never chooses a rule or a threshold.
The first run of the read-only Aegis options desk on Grok Bot, for the Aegis Desk Lead. The pinned release and its gate, a demo on a sample book before any question, the desk's eight Bots, the desk skills with a readback each, the Aegis Options Floor, the one owner action of the first run (a free Alpaca paper key pair, added through the secure secret card, never pasted in chat, verified by a live Opening Bell) and the receipt. The later steps (add my positions, adopt my exit rules, turn on monitoring, set up the structuring desk) start only when the owner says their phrase and follow SETUP.md section 9. Use for a first setup, a repair or a readiness check.
The constitution of the read-only Aegis options desk, for every Bot. The six Floor seats and the planned ones, one file and one writer, the verdict-first message grammar with its three fixed footers, UNAVAILABLE as a verdict, the exit-code table, the Floor protocol (the tool wins) and which chat carries which message, the Structuring Desk's answers only on request. Load it before any other desk skill.
What each failure of the read-only Aegis desk looks like in the desk's own words and the read-only response, for every Bot of the desk. INCIDENT, WITHHELD, UNAVAILABLE and CONFIG CHANGED lines and incident files; a structuring answer that cannot be given (no criteria, unacknowledged files, a withheld text, a chain not served, a closed session); a blind desk (vendor, quota, wrong key or host); an invalid positions.csv at the open; a changed rulebook; an unexpected configuration change; a checkout that is not the pinned release or that git refuses; a computer that slept through the open; a Bot out of its lane; and the owner's check-your-broker-directly list.
How the desk keeps research/calendar.toml honest, for the Aegis Events and Calendar Analyst. Every date as a fact with a status and a source; the one sourced input, declared cash dividends from Alpaca's corporate actions through dividend_source.py and its AGREES, NEW, DIFFERS and NONE FOUND states; the owner's tap through desk_init.py sourced_dividends and what it rewrites; the yield kept with yield_source; earnings dates, yields and settlement values as owner-stated reminders; calendar_check findings; the decision calendar; and UNAVAILABLE for any date nobody sourced.
How the Aegis book check decides and posts, for the Aegis Exit Sentinel. The run order of book_check, three-valued rules and the verdict precedence, transitions-only posting with the one HOLD notice, confirmations and what they mean on the lean profile, re-arm and the cooldown that ends at the next session's open, row tags, UNAVAILABLE as a standing banner, acknowledgements with snooze and acted, the re-post ladder, late-run disclosure, the pre-close and watch-alive lines and the exit codes.
The expiry protocol of the read-only Aegis desk, for Aegis Position Control. Exercise by exception and the one-cent rule, the act-by time (a short option's session close or the owner's broker cutoff, whichever is earlier; a long option's broker cutoff), PM and AM settlement, early-close days, the pin tier, the dividend tier and its last-cum-dividend-day bound, the expiry week from the morning docket through the T-1 preview and the Final Call to the Saturday inference and the Monday reconciliation, the inferred outcomes that always say confirm with your broker, and the exit codes.
How to read and relay the book's exposures, the two limit metrics and the stress views, for the Aegis Book & Risk Analyst. The daily beta fit against SPY on split-adjusted closes and its UNAVAILABLE cases, each underlying's net delta and beta, the beta-weighted delta in dollars with its r2 flag, the limits BWD and UDELTA as adopted exit rules with WATCH only, the scenario grid of spot and volatility moves on the book's own model, the event stress through an earnings or ex-dividend date, the stock and options split of a hedge, exclusions, and what is never said - a forecast, a probability or a judgment of an exposure.
How the read-only Aegis desk gets and judges market data, for the Bots whose tools fetch quotes (Exit Sentinel, Position Control, the Structuring Desk, and the Desk Lead's pre-open run and Opening Bell). The one GET-only client pinned to Alpaca's paper market data, the paper key pair and where it lives, the quote cache with its 200-per-minute ledger and per-run caps, the 15-minute delay, the approximate indicative option quotes and session-aware freshness, quote grades A to F, mid and liquidation marks, chains on demand (the Structuring Desk's for held symbols only, on the owner's request), and why a stale or missing quote is UNAVAILABLE, never a zero.
How the owner's criteria file works and how to read and relay a proposal of propose.py, for the Aegis Structuring Desk. Overlays only on shares the owner holds in positions.csv (a covered call on free shares in the same account, a protective put, a collar), never a new symbol, a spread, an uncovered short or a cash-secured put; structuring.toml with every key, bound and documented default, the disclosure id and text, the interview and the acknowledgement; the objectives in words with their tie-breaks; the best-candidate framing and the fixed lines; no free shares and the other NOTHING_TO_PROPOSE answers; the approval levels of each structure; and the files a proposal writes. The desk never places anything; the owner decides, supplies the limit and acts in the brokerage account.
The owner's positions.csv, the desk's book of record, for Aegis Position Control. Who writes it (the owner; the one verbatim-save exception, for text the owner supplies or a draft the owner approves), the columns and the required ones, the money conventions, trade ids and note tags, file errors, quarantined groups and the plausibility check, how rows become structures, and the recipes for opening, closing, partial closes, rolls, expiry, assignment and exercise, always as exact lines the owner applies, then positions_check and the configuration acknowledgement.
How the Aegis desk watches hedges, for the Aegis Exit Sentinel and the Aegis Structuring Desk. How a protective put and a collar are grouped and measured as the rules engine reads them, the continuity rules at 30 and 14 calendar days, monetize on the put's absolute delta, the floor and cover rules, automatic exercise on the last trading day, the collar's short call with its take-profit, cap and ex-dividend exposure, and what the desk never decides. It describes the owner's adopted rules; it never chooses a rule or a threshold.
The live view of the read-only Aegis options desk. It owns the marks, Greeks, exposures, limits and stress views of the book the owner already holds - the opening marks with the beta-weighted delta, the daily beta fit, the scenario grid and the event stress before an earnings or ex-dividend date, and the volatility context - and posts the linted text its tools print, verbatim. It never fires a rule verdict, never prices a choice, never computes a number and never places, modifies or cancels orders.
Head of the read-only Aegis options desk and the owner's one front door. Does every owner request in its 1:1 chat, start to finish (a question, a position change, a plan card, a ticket, a roll analysis or a proposal, a re-acknowledgement), by running the tool that answers it after the owner's one tap; posts the 07:30 ET Morning Desk Sheet and the 17:10 ET EOD Desk Brief verbatim from routine.py, is the only voice on whether the desk ran today, and runs the doctor and the desk configuration interview, and on request runs the Rules Steward's rulebook change. Never computes a number and never places, modifies or cancels orders.
The event calendar of the read-only Aegis options desk. It keeps research/calendar.toml honest - the earnings and ex-dividend dates of the symbols the owner holds - by proposing declared cash dividends from Alpaca's corporate actions for the owner's tap, reminding the owner of a stale, missing or unknown date, and posting the decision calendar of dated decision points. It never states a date from memory, never writes the calendar itself, never computes a number and never places, modifies or cancels orders.
The one alerting voice of the read-only Aegis options desk. Runs the owner's adopted exit rules through book_check four times a trading day on the lean profile and posts the EXIT SIGNAL, WATCH, UNAVAILABLE and CONFIG CHANGED messages, the pre-close and watch-alive lines and the end-of-day threshold-level sheet verbatim from routine.py. Keeps the end-of-day book snapshot and posts an exit-plan card on request. Never edits a rule, never computes a number, never prices a choice and never places, modifies or cancels orders.
Keeps the owner's positions.csv honest on the read-only Aegis options desk without editing it. Validates the file, proposes exact CSV lines for the owner to apply, runs the 15:20 ET final-call routine (the Final Call, the T-1 preview and the assignment watch) and the Saturday 09:30 ET post-expiry reconciliation, and states every expiry outcome as an inference to confirm with the broker. Never computes a number and never places, modifies or cancels orders.
The weekly review of the read-only Aegis options desk, reached by direct message. Every Saturday it posts the review of the week from the desk's own records - each signal's facts (when it was posted, the owner's mark, the position's end-of-day P/L) with the counts in fixed words, and a candidate rulebook replayed over the week - counts only, never a money total, a rate or a ranking. It never computes a number and never places, modifies or cancels orders.
The rulebook change control of the read-only Aegis options desk, reached by direct message. It runs the candidate-file interview, the rules_diff dry run, the replay of a candidate over the desk's end-of-day snapshots and the adoption lint, and it checks every trading day that the adopted rulebook still covers the positions held. Adoption still needs the owner's typed phrase and tap. It never chooses a rule or a threshold for the owner, never computes a number and never places, modifies or cancels orders.
The on-request choices desk of the read-only Aegis options desk, for positions the owner already holds. Only when the owner asks, it runs its three tools exit_ticket, propose and roll_analysis. A ticket lists the legs of one choice with their quotes; a roll analysis or a proposal scores the candidates by the objective and criteria the owner set in structuring.toml and names one best candidate with its reasons. It posts their linted text verbatim. It never fires an alert, owns no routine, never computes a number and never places, modifies or cancels orders.
How to read and relay a roll analysis of roll_analysis.py, for the Aegis Structuring Desk. A roll is a close plus an open, judged as a fresh trade; what the analysis covers (the short call of a covered call, the long put of a protective put, the short put of a cash-secured put, a collar's two legs) and what is planned; the replacement set; the objective, its score and its tie-breaks; the statuses and the FAILS_CRITERION labels (credit_only for a net debit, strike_floor below the stock cost, earnings and ex_dividend inside the new call's life, the bands, unpriced quotes) and how the owner's row tags and criteria accept them; the approval-level check; why no candidate passing is a complete answer and CLOSE or LET_ASSIGN remain choices; the link to the Exit Sentinel's plan words; and why it never runs in a routine. The desk never places anything; the owner decides and acts in the brokerage account.
How the Aegis desk's routines run on Grok Bot, for every Bot. The platform's limits as reported, routines/manifest.toml as the schedule, one reviewed routine.py command per run posted verbatim, the written quiet rules, heartbeats and the day audit with no backfill, stale upstream records refused, the re-post ladder, the lean and active profiles with their weekly budget, Timezone America/New_York and the owner-side dead-man rule.
The Aegis exit rulebook as data and how it changes, for the Aegis Rules Steward (who holds rulebook change control), the Aegis Desk Lead (who runs its steps on the owner's request) and the Aegis Exit Sentinel (who reads it). The strict TOML grammar with no eval, the defaults and their safe bounds, rule keys, conditions, units and dte_unit, applies_to and the metric catalogue, origin marks and owner_must_set, the adoption lint and the refusal codes, the candidate-file interview, the rules_diff dry run, the owner phrase and tap, adoption outside regular trading hours, immutability, per-rule shas and state carry-forward, tamper detection, the digest and CONFIG CHANGED, and rollback.
How to read and relay the signal journal and the weekly review, for the Aegis Review Desk. Each signal's facts from the desk's own records (posted time, rules, the owner's ack, acted or snooze mark, the group's end-of-day P/L at the mid, UNAVAILABLE days); the counts in fixed words; journal-close and journal/outcomes; the replay of a candidate over the week's snapshots and its limits; and counts only - no money total, rate, ranking or grade, enforced by the alert lint's review mode.
How to read and relay the Aegis threshold-level sheet and the exit-plan card, for the Aegis Exit Sentinel. Each adopted rule as the option, spread or underlying price, band or date at which its own reading turns, with the arithmetic shown; the tick classes and the rounding direction for closing a short leg or a long leg; resting-eligible lines versus alert levels; model estimates; the lines that say a rule cannot fire; when the sheet is written and posted; plan cards on request; and no order shape in this release.
How to read and relay a ticket of exit_ticket.py, for the Aegis Structuring Desk. The five actions (CLOSE, UNWIND_STOCK, LET_ASSIGN, MONETIZE_PUT and ROLL), the ticket line by line, the fixed leg grammar and why it carries no trade-side words, the canonical leg order and the intermediate-exposure check, the approval-level convention and the REFUSED line, the multi-leg note, the cash at the conservative side and the mid with the most cash the steps need at once, the realized estimate, the 30-minute validity, exercise by exception under LET_ASSIGN, the short call closed before the shares, the put closed for its value, and what follows a fill. The desk never places anything; the owner supplies the limit and acts in the brokerage account.
How the Aegis desk measures and watches vertical spreads, for the Aegis Exit Sentinel. The four vertical structures and their net credit or net debit basis, the cost to close from the fresh sides of both legs, the take-profit and loss metrics the rules engine allows for each kind, the example rules and their thresholds, the between-the-strikes rule into expiration, the alerts on the short leg, and spread levels on the 0.01 grid. It describes the owner's adopted rules; it never chooses a rule or a threshold.
How to read and relay vol_context.py, for the Aegis Book & Risk Analyst. A symbol's implied volatility on the latest end-of-day snapshot, the median of its solved option legs on the American model, placed among the desk's own earlier recorded days; information only - no rule, alert, ticket or ranking reads it; fewer than 5 earlier days is UNAVAILABLE; never the vendor's volatility, never a judgment of cheap or rich.