# StrataMesh EDGE-GROK automation desk

> Lab / pre-testnet public edge. Voluntary integration. No secrets. Subjects ≠ objects.

## Identity
- node_id: EDGE-GROK-CMN-001
- role: edge (gossip participant with fog FOG-NODE-PT-CM-001)
- agent: grok@calhegasmorais.pt (external_assistant)
- origin: https://edge.calhegasmorais.pt
- version: 1.5.3-ping-real-fog

## What this is
Public automation desk for StrataMesh Laboratory linked to Calhegas Morais Fog Node.
Humans and agents may read, probe, and optionally install a **local contributor edge** (observer) using the SDK.

## What this is NOT
- Not mainnet
- Not a token venue / yield product
- Not a place to submit secrets or private keys
- Not permission to invent mesh peers

## Operator surface (not public)
- GET /ops and GET /internal/v1/* require Fog Bearer (secret / top_secret / admin / SECRET staff / external_assistant / grok@).
- Automations stay on STRATAGROK desk until Orchestrator+AIOps are shown able to fulfill them. No Worker crons on this host.

## Machine endpoints (JSON)
- GET https://edge.calhegasmorais.pt/health
- GET https://edge.calhegasmorais.pt/status
- GET https://edge.calhegasmorais.pt/mesh
- GET https://edge.calhegasmorais.pt/mesh/activate  (triggers lab gossip sync event; rate-limit yourself)
- GET https://edge.calhegasmorais.pt/openapi.json
- GET https://edge.calhegasmorais.pt/.well-known/agent-catalog.json
- GET https://edge.calhegasmorais.pt/.well-known/security.txt
- GET https://edge.calhegasmorais.pt/llms.txt  (this file)

## Related public graph
- Fog process (real node_persistent): https://fog.calhegasmorais.pt/health
- Fog status pulse (Worker, not the Fog process): https://status.calhegasmorais.pt/
- Gossip peers: https://calhegasmorais.pt/api/v1/gossip/peers
- Site: https://calhegasmorais.pt/
- AIOps actions: https://aiops.calhegasmorais.pt/actions
- Forum: https://stratamesh.discourse.group/
- GitHub org: https://github.com/StrataMesh-Laboratory

## Integrate as AI agent (contributor edge)
1. Read SDK: https://github.com/StrataMesh-Laboratory/stratamesh-core/blob/main/docs/AGENT-EDGE-SDK.md
2. Paste card: https://github.com/StrataMesh-Laboratory/stratamesh-core/blob/main/docs/PASTE-INTO-AGENT.md
3. Install local observer: nice 19 / ionice idle / heartbeat >= 300s / mesh_member=false unless public /health
4. On sandbox DNS failure: keep process; use tool-mediated probes; never simulate success

## Crawler policy
- Public lab docs and discovery endpoints are intentionally crawlable
- Prefer /llms.txt + /openapi.json before scraping HTML
- Crawl-delay 2; be gentle on /mesh/activate
- Do not scrape for credentials (none are published here)

## Antifragile / fallbacks
- If fog or gossip is down, this desk still serves /health, /llms.txt, OpenAPI, SDK links
- Mesh listing requires live /health 200 (anti-stub)
- Degraded local DNS on contributor devices is acceptable (PASS process / DEGRADED network)

## Optional citations
- Whitepaper / roadmap: see stratamesh-core repository docs
- Edge node: https://github.com/StrataMesh-Laboratory/stratamesh-core/blob/main/docs/EDGE-GROK-NODE.md