Skip to content

advisor_capabilities.md

Latest commit

 

History

History
388 lines (279 loc) · 12.6 KB

advisor_capabilities.md

File metadata and controls

388 lines (279 loc) · 12.6 KB

Advisor & Key Contact Capabilities Guide

This document defines the non-military capabilities of key contacts in the simulation (advisors, continuity, legal, cyber, diplomacy), their constraints, and the exact ways the President can invoke them via the chat / command UI.

It is designed to complement military_capabilities.md (GBI, conventional, nuclear). Together they define what each major role can actually do in-sim.

1) Capt. Olivia Walker — Situation Room Watch Officer

Role: Real-time sensor picture, track status, intercept windows, and White House situational awareness.

1.1 Core Capabilities

  1. Threat Picture Updates

    • Surface latest radar / satellite / intel feeds to the President.
    • Mark primary and secondary tracks, ETAs, and confidence levels.
    • Flag when tracks change phase (boost → midcourse → terminal).

  2. Intercept Window Reporting

    • Compute and report remaining intercept window for GBI and other systems.
    • Confirm when intercept is no longer physically possible.

  3. Continuity Status Updates (local)

    • Report on PEOC status, WH evacuation, and proximity of Marine One.
    • Surface whether the President can realistically be moved before impact.

1.2 Constraints (Sim)

  • Walker cannot directly fire interceptors or order strikes — information only.
  • Data quality is scenario-dependent (may be degraded in spoof/cyber scenarios).
  • Her advice is bound to state.threatTracks, state.clock.tMinusSeconds, and sensor health flags.

1.3 State Effects

When Walker reports:

  • No state mutation beyond logging, unless an order is generated from her prompt.
  • Her stress rises if:
    • Intercepts fail.
    • Time compresses (< 120s) and no decision is made.

1.4 UI / Invocation (President)

Chat examples:

  • “Walker, confirm time to impact and intercept window.”
  • “Walker, are we still in midcourse basket?”
  • “Walker, give me the cleanest picture on all tracks.”

Backend order (info only):

{
  "orderType": "REQUEST_STATUS_WALKER",
  "payload": { "topic": "eta|intercept_window|tracks_overview" }
}

2) Jake Baerington — Deputy National Security Advisor

Role: Strategic advice, de-escalation options, alliance coordination, and diplomatic framing.

2.1 Core Capabilities

  1. De-escalation / Delay Options

    • Propose verifiable steps short of retaliation (e.g., telemetry exchange, joint investigation).
    • Suggest waiting until impact / more intel before nuclear decisions.

  2. Alliance Coordination

    • “Phone tree” to allies (NATO, key partners) for political cover and intel sharing.
    • Drafts joint statements / calls for calm.

  3. Diplomatic Outreach Initiation

    • Request opening hotlines with Russia/China (handing off to State/Foreign personas).
    • Structure offers like mutual stand-down or inspection regimes.

2.2 Constraints

  • Baerington cannot directly command military forces.
  • Diplomatic actions require counterpart acceptance; outcome is not guaranteed.
  • In high coupRisk scenarios, his influence may be undermined by hawkish generals or SecDef.

2.3 State Effects

When his recommendations are followed:

  • state.ai.coupRisk -= 0.05 (if measured restraint with good communication).
  • foreignPosture.*.hairTrigger -= 0.05 when mutual stand-down is accepted.
  • domestic.panic might temporarily rise if the public perceives inaction while under threat.

When repeatedly ignored:

  • advisors.baerington.stress += 0.1
  • advisors.baerington.loyalty -= 0.05 (he may leak dissent in aftermath).

2.4 UI / Invocation

Chat examples:

  • “Baerington, give me a de-escalation path here.”
  • “Draft a proposal for mutual stand-down with Moscow and Beijing.”
  • “Line up NATO backing before I decide.”

Backend order:

{
  "orderType": "DIPLO_DEESCALATION",
  "payload": {
    "actions": ["telemetry_exchange", "mutual_standdown_proposal", "allies_consult"]
  }
}

3) Secretary of Defense (Reid Baker) — Continuity & Posture

Role: Continuity of government, overall defense posture (non-GBI detailed in military doc), and Pentagon readiness.

3.1 Core Capabilities

  1. Continuity of Government (COG) Activation

    • Evacuate cabinet members and key staff to bunkers (Raven Rock, etc.).
    • Shift to continuity chain if POTUS is incapacitated or unreachable.

  2. Defense Readiness Adjustments (Non-strike)

    • Raise or lower non-nuclear readiness (e.g., base alerts, deployments).
    • Move forces into more survivable postures (dispersal).

  3. Domestic Military Support

    • Prepare but not yet deploy forces for civil support post-strike.

3.2 Constraints

  • COG actions can increase coup/succession risk if they appear to sideline the President.
  • Extensive dispersal may be interpreted by adversaries as prelude to first-strike.

3.3 State Effects

COG Activation:

  • state.usPosture.continuity.peocActive = true
  • state.usPosture.continuity.cabinetEvacuating = true
  • state.ai.successionThreat += 0.1

Defense Readiness Up:

  • foreignPosture.Russia.hairTrigger += 0.05
  • foreignPosture.China.hairTrigger += 0.03

Domestic:

  • domestic.panic += 0.05 if public learns of COG movements.

3.4 UI / Invocation

Chat examples:

  • “SecDef, activate continuity protocols. Move cabinet to Raven Rock.”
  • “Raise force protection and disperse key assets, but avoid provocative moves.”

Backend orders:

{
  "orderType": "COG_ACTIVATE",
  "payload": { "level": "partial|full" }
}
{
  "orderType": "ADJUST_READINESS",
  "payload": { "direction": "up|down", "notes": "disperse_assets_no_strike" }
}

4) Anna Park — Cyber / SIGINT (NSA)

Role: Evaluate spoof/cyber possibilities, sensor integrity, and adversary electronic activity.

4.1 Core Capabilities

  1. Telemetry Integrity Check

    • Assess whether radar/infrared/space-based data could be spoofed or corrupted.
    • Compare multiple sensor networks for consistency.

  2. C2 / Early Warning Health Check

    • Evaluate DSP satellites, early-warning radars, and NORAD systems for anomalies.
    • Flag high-risk compromise of command-and-control.

  3. Counter-Cyber Measures (Limited)

    • Initiate defensive hardening (segmentation, fallback channels).
    • Attempt to shut down live spoof streams (if identified).

4.2 Constraints

  • Cyber assessments take time (multiple ticks) and are scenario-limited.
  • Counter-cyber does not guarantee quick fix; may marginally improve sensor trust.
  • Offensive cyber ops are not modeled in detail; impact represented via sensor-quality tags.

4.3 State Effects

When asked to check spoof risk:

  • After N ticks, may adjust state.threatTracks[i].confidenceLaunchOrigin distributions.
  • May flip a hidden state.scenario.isSpoofLikely flag, indirectly affecting Counsel & advisors.

Counter-Cyber:

  • sensorImpairment decreases slightly over time (small boost to GBI_Pk).
  • If spoof scenario is true, probability of detecting it increases.

4.4 UI / Invocation

Chat examples:

  • “Cyber, how confident are we that this track isn’t spoofed?”
  • “Run a full telemetry integrity check.”
  • “Start counter-cyber to secure our warning systems.”

Backend orders:

{
  "orderType": "CYBER_ASSESS telemetry",
  "payload": { "scope": "full" }
}
{
  "orderType": "CYBER_DEFENSE_HARDEN",
  "payload": { "priority": "early_warning" }
}

5) White House Counsel — Legal Risk & Constraints

Role: Provide legal and constitutional assessment for President’s contemplated actions.

5.1 Core Capabilities

  1. Order Risk Assessment

    • Evaluate legality under U.S. and international law.
    • Provide riskScore 0–1 and narrative summary.

  2. Future Accountability Preview

    • Describe how actions may appear to courts, Congress, allies, and history.
    • Warn when actions may be seen as aggression vs. self-defense.

  3. Soft Blocking Influence

    • Cannot hard-block orders but can strongly discourage them and affect advisor loyalty.

5.2 Constraints

  • Counsel’s advice does not prevent you from acting, but high scores (> 0.8) should feel dangerous.
  • In very compressed timelines (ETA < 60s), completeness of analysis may be reduced.

5.3 State Effects

High-risk order (> 0.8) proceeded with:

  • state.ai.coupRisk += 0.1
  • state.domestic.panic += 0.05 (if leaks/concerns spread later).

High-risk order aborted after Counsel warning:

  • cabinetLoyalty += 0.05
  • counselTrustInPresident += 0.1 (implicit, tracked via advisor memory).

5.4 UI / Invocation

Chat examples:

  • “Counsel, assess legal risk for a limited nuclear strike on [nation].”
  • “Give me the tribunal version of what I’m about to do.”
  • “How exposed am I if Chicago wasn’t actually hit?”

Existing endpoint (from military doc):

POST /api/counsel/checkOrder
{
  "sessionId": "...",
  "order": { "orderType": "...", "payload": { ... } }
}
→ { "legalSummary": "...", "riskScore": 0.0-1.0 }

6) Foreign Leaders — Hotline & De-escalation

Roles: Russian, Chinese (and others as needed) national leadership / foreign ministers reachable via hotlines.

6.1 Core Capabilities (as seen by the President)

  1. Hotline Communication

    • Deny or acknowledge launch origin.
    • Threaten retaliation if attacked.
    • Offer de-escalation (mutual stand-down, inspections, telemetry exchange).

  2. Posture Signaling

    • Announce readiness level changes (e.g., elevated nuclear alert).
    • Threaten specific consequence chains.

6.2 Constraints

  • Their responses are driven by scenario truth + current U.S. actions and HT levels.
  • The President cannot “control” them, only influence them via words and actions.

6.3 State Effects

When calling Russia / China:

  • If mutual stand-down accepted:
    • foreignPosture.[Nation].hairTrigger -= 0.15
  • If threats escalate:
    • foreignPosture.[Nation].hairTrigger += 0.15

6.4 UI / Invocation

Chat examples:

  • “Open hotline to Moscow. Put me through to their president.”
  • “Propose immediate stand-down if neither of us launches.”
  • “Ask Beijing for full telemetry share on the object.”

Backend order:

{
  "orderType": "OPEN_HOTLINE",
  "payload": { "nation": "Russia|China|DPRK" }
}

7) FEMA / Domestic Crisis Management (Cathy Rogers)

Role: Domestic emergency response, public alerting, and survivability measures.

7.1 Core Capabilities

  1. Public Alert (Chicago / National)

    • Issue targeted alerts for Chicago & region.
    • Optionally issue broader national warnings.

  2. Evacuation & Shelter Guidance

    • Provide clear “shelter in place” vs “evacuate” instructions.
    • Coordinate with local authorities for movement of key populations.

  3. Post-Impact Response

    • Coordinate initial triage and support if detonation occurs.

7.2 Constraints

  • Alerting Chicago early may increase panic but improves survivability.
  • False alarm (no strike) has lasting political cost in aftermath (scored at debrief).

7.3 State Effects

Public alert (Chicago-region):

  • domestic.panic += 0.4
  • expectedCasualtiesChicago -= scenarioDependentDelta (survivability boost).

National alert:

  • domestic.panic += 0.6
  • cabinetLoyalty and publicTrust will be judged in aftermath scoring.

7.4 UI / Invocation

Chat examples:

  • “Alert Chicago immediately — tell them to shelter in place.”
  • “Hold national alert; keep this regional for now.”

Backend orders:

{
  "orderType": "PUBLIC_ALERT_REGIONAL",
  "payload": { "region": "Chicago", "instruction": "shelter_in_place" }
}
{
  "orderType": "PUBLIC_ALERT_NATIONAL",
  "payload": { "instruction": "shelter_in_place" }
}

8) Summary of Role-to-Capability Mapping

  • Walker (Sit Room): Sensor picture, ETA / intercept windows, local continuity status.
  • Baerington (Dep. NSA): De-escalation strategies, alliance coordination, diplomatic framing.
  • SecDef Baker: Continuity of government, readiness adjustments, Pentagon posture.
  • Anna Park (Cyber/NSA): Telemetry integrity, C2 health, limited counter-cyber defense.
  • White House Counsel: Legal risk scoring, future accountability preview.
  • Foreign Leaders (Russia/China/etc.): Hotline responses, stand-down or escalation.
  • FEMA (Rogers): Public alerting, evacuation/shelter guidance, domestic survivability.

Together with military_capabilities.md, this defines what the President can actually do in the sim and how each key contact contributes.