# DESA — Guidance

> **Version:** 1.0.0
> **Maintained by:** [Platphorm News](https://platphormnews.com)
> **Last Updated:** 2025-03-07

## Purpose

This document provides guidance for developers, integrators, and AI agents interacting with the **DESA (Dynamic Encoded Script Analysis)** platform and the broader [PlatphormNews network](https://platphormnews.com).

## Getting Started

1. **Analyze a Script** — Submit PowerShell scripts to `/api/v1/analyze` for deobfuscation, threat detection, and IOC extraction.
2. **Browse Detection Rules** — View and manage the 20+ built-in detection rules at `/rules`.
3. **Extract IOCs** — Review extracted Indicators of Compromise at `/iocs`.
4. **Integrate via MCP** — Use the Model Context Protocol at `/api/mcp` for AI-agent integration.

## For AI Agents

DESA exposes machine-readable endpoints designed for agent consumption:

| Endpoint | Description |
|----------|-------------|
| `/llms.txt` | LLM context summary |
| `/llms-full.txt` | Comprehensive LLM context with rules |
| `/llms-index.json` | JSON index of LLM resources |
| `/api/mcp` | JSON-RPC 2.0 MCP endpoint |
| `/api/discovery` | Network discovery metadata |
| `/api/faq` | Structured FAQ with JSON-LD |
| `/api/docs` | OpenAPI 3.1.0 specification |
| `/api/docs/guidance` | This document (plain text) |

## For Developers

- **API Reference:** See [API.md](./API.md) or `/api/docs` for the OpenAPI spec.
- **Architecture:** See [ARCHITECTURE.md](./ARCHITECTURE.md) for system design.
- **Contributing:** See [CONTRIBUTORS.md](./CONTRIBUTORS.md) for contribution guidelines.
- **MCP Integration:** See [MCP.md](./MCP.md) for Model Context Protocol details.

## Standards & Conventions

DESA follows the conventions established by the PlatphormNews network:

- **SEO/AEO/GEO:** JSON-LD structured data (schema.org), OpenGraph, Twitter Cards
- **I18N:** 8 supported locales (en, es, fr, de, ja, zh, ko, pt)
- **Discovery:** `/api/discovery` for service mesh metadata
- **MCP:** JSON-RPC 2.0 with tool registration at the MCP Hub
- **Feeds:** RSS 2.0 at `/rss.xml`, sitemap at `/sitemap.xml`

## PlatphormNews Network

DESA is part of the PlatphormNews network of security and developer tools:

| Service | URL | Purpose |
|---------|-----|---------|
| **Platphorm News** | [platphormnews.com](https://platphormnews.com) | Network hub |
| **DESA** | [desa.platphormnews.com](https://desa.platphormnews.com) | Script analysis |
| **MSI** | [msi.platphormnews.com](https://msi.platphormnews.com) | Malware Sample Intelligence |
| **JSON** | [json.platphormnews.com](https://json.platphormnews.com) | JSON tree viewer |
| **XML** | [xml.platphormnews.com](https://xml.platphormnews.com) | XML validation |
| **SVG** | [svg.platphormnews.com](https://svg.platphormnews.com) | SVG report generation |
| **MCP Hub** | [mcp.platphormnews.com](https://mcp.platphormnews.com) | MCP tool registry |

## Support

- **GitHub Issues:** [desa-powershell-script-analysis](https://github.com/mbarbine/desa-powershell-script-analysis/issues)
- **Documentation:** [desa.platphormnews.com/docs](https://desa.platphormnews.com/docs)
- **PlatphormNews:** [platphormnews.com](https://platphormnews.com)