Skip to content

Refactor docs landing-page guardrails section into visual security overview#35282

Merged
pelikhan merged 1 commit into
mainfrom
copilot/update-astro-docs-index-mdx
May 27, 2026
Merged

Refactor docs landing-page guardrails section into visual security overview#35282
pelikhan merged 1 commit into
mainfrom
copilot/update-astro-docs-index-mdx

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 27, 2026

This updates the docs landing page (docs/src/content/docs/index.mdx) by replacing the flat security/sandbox prose with a scannable visual section. The Guardrails content is now presented as a short blurb, a flow diagram, and security-layer cards.

  • Guardrails section redesign

    • Replaced the long subsection-by-subsection text block with a concise summary of the layered security model.
    • Kept the section anchored under Guardrails Built-In for continuity.
  • Security flow visualization

    • Added a Mermaid flowchart to show the end-to-end control path from input through gated write application.
    • Captures layer ordering: read-only token → no secrets in runtime → sandbox/firewall → safe outputs gate → threat detection → scoped write job.
  • Layered controls as cards

    • Added a CardGrid with one card per control layer:
      • Read-only token
      • No secrets in agent runtime
      • Sandbox + network firewall
      • Safe outputs gate
      • Threat detection
    • Preserved direct links to deeper docs (architecture, safe-outputs, threat-detection).
## Guardrails Built-In

AI agents can be manipulated by prompt injection, malicious repository content, or compromised tools...
```mermaid
flowchart LR
    INPUT["Repository + Prompt Input"] --> TOKENS["Read-only Token"]
    TOKENS --> SECRETS["No Secrets in Agent"]
    SECRETS --> SANDBOX["Sandbox + Network Firewall"]
    SANDBOX --> SAFE["Safe Outputs Gate"]
    SAFE --> DETECT["Threat Detection Scan"]
    DETECT --> APPLY["Scoped Write Job"]
... ... ... ... ... ```

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title Update docs landing page security section with visual layout Refactor docs landing-page guardrails section into visual security overview May 27, 2026
Copilot AI requested a review from pelikhan May 27, 2026 18:47
@pelikhan pelikhan marked this pull request as ready for review May 27, 2026 18:47
Copilot AI review requested due to automatic review settings May 27, 2026 18:47
@pelikhan pelikhan merged commit 8ffcf8d into main May 27, 2026
@pelikhan pelikhan deleted the copilot/update-astro-docs-index-mdx branch May 27, 2026 18:47
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants