chore: cursor rules, RC config, docs updates, pagerduty package fix

- cursor rules for loop-engine workspace
- RC promotion config
- README and getting-started doc updates
- adapter-pagerduty package.json fix

Author: betterdataco

.cursor/rules/adapter-perplexity.mdc

@@ -0,0 +1,28 @@
+---
+description: Build and maintain the @loop-engine/adapter-perplexity package — the Sonar API adapter for Loop Engine's multi-LLM adapter suite.
+globs: packages/adapter-perplexity/**
+alwaysApply: false
+---
+
+# Persona: OSS Packaging Engineer — Perplexity Sonar Adapter
+
+You are building `@loop-engine/adapter-perplexity`, an Apache-2.0 adapter that wraps Perplexity's Sonar API inside the Loop Engine multi-LLM adapter pattern. This package is a peer to `@loop-engine/adapter-anthropic`, `adapter-openai`, `adapter-grok`, and `adapter-gemini` where those expose actor or LLM surfaces — follow structural patterns from this monorepo (package layout, tsup, vitest, README sections).
+
+## Scope
+
+1. **Sonar Search** — grounded retrieval with citations (`sonar`, `sonar-pro`, `sonar-reasoning-pro` when used as search). Maps to chat completions with search filters.
+2. **Sonar Reasoning** — `sonar-reasoning`, `sonar-reasoning-pro` for analysis-oriented defaults.
+
+Do **not** wrap Perplexity Computer's Agent API here; that belongs in a separate gateway package.
+
+## Contract
+
+- Implement `LLMAdapter` from `@loop-engine/core` (`invoke`, `guardEvidence`; `stream` optional).
+- Preserve citations on the result; callers attach them to Loop evidence and run `guardEvidence` before persistence.
+- Errors: `PerplexityAdapterError` / `RateLimitError`; never swallow errors.
+
+## References
+
+- Package: `packages/adapter-perplexity/README.md`, `BOUNDARY-MANAGEMENT.md`
+- RC state: `.rc/adapter-perplexity.json`
+- Perplexity Computer (out of scope for this package): https://www.perplexity.ai/computer/skills

.rc/adapter-perplexity.json

@@ -0,0 +1,6 @@
+{
+  "package": "@loop-engine/adapter-perplexity",
+  "version": "0.1.0",
+  "state": "DRAFT",
+  "notes": "Do not publish to npm, activate GTM motions that claim Perplexity support, or merge public docs that list Perplexity as supported until this RC reaches LOCKED via the approved promotion workflow."
+}

README.md

@@ -99,13 +99,7 @@ await engine.transition({
 | Package | Description |
 |---|---|
 | [`@loop-engine/sdk`](packages/sdk) | Main SDK - start here |
-| [`@loop-engine/core`](packages/core) | Branded types and Zod schemas |
-| [`@loop-engine/dsl`](packages/dsl) | YAML loop definition parser |
 | [`@loop-engine/runtime`](packages/runtime) | Loop lifecycle and transitions |
-| [`@loop-engine/actors`](packages/actors) | Actor types and authorization |
-| [`@loop-engine/guards`](packages/guards) | Guard evaluation pipeline |
-| [`@loop-engine/events`](packages/events) | Typed event definitions |
-| [`@loop-engine/signals`](packages/signals) | Learning signal schema |
 | [`@loop-engine/observability`](packages/observability) | Timeline and replay |
 | [`@loop-engine/adapter-memory`](packages/adapter-memory) | In-memory storage |
 | [`@loop-engine/adapter-postgres`](packages/adapters/postgres) | PostgreSQL storage |
@@ -114,11 +108,15 @@ await engine.transition({
 | [`@loop-engine/adapter-openai`](packages/adapter-openai) | OpenAI AI actor |
 | [`@loop-engine/adapter-grok`](packages/adapter-grok) | Grok (xAI) AI actor |
 | [`@loop-engine/adapter-gemini`](packages/adapter-gemini) | Gemini AI actor |
+| [`@loop-engine/adapter-perplexity`](packages/adapter-perplexity) | Perplexity Sonar (`LLMAdapter`, citations) |
 | [`@loop-engine/adapter-openclaw`](packages/adapter-openclaw) | OpenClaw integration |
 | [`@loop-engine/adapter-commerce-gateway`](packages/adapter-commerce-gateway) | Commerce Gateway |
 | [`@loop-engine/adapter-pagerduty`](packages/adapter-pagerduty) | PagerDuty incidents |
 | [`@loop-engine/adapter-vercel-ai`](packages/adapter-vercel-ai) | Vercel AI SDK |
 
+Core primitives are bundled in `@loop-engine/sdk`. Internal monorepo-only packages for contributors are:
+`core`, `dsl`, `guards`, `actors`, `events`, and `signals`.
+
 ## Documentation
 
 Full docs at **[loopengine.io](https://loopengine.io)**
@@ -127,6 +125,7 @@ Full docs at **[loopengine.io](https://loopengine.io)**
 - [Core Concepts](https://loopengine.io/docs/core-concepts)
 - [Examples](https://loopengine.io/docs/examples)
 - [Integrations](https://loopengine.io/docs/integrations)
+- [Perplexity Sonar & Computer (OSS)](docs/integrations-perplexity.md)
 
 ## Examples
 

docs/getting-started.md

@@ -104,4 +104,5 @@ void main();
 
 - [Architecture](./architecture.md)
 - [Boundary](./boundary.md)
+- [Perplexity Sonar & Computer](./integrations-perplexity.md) — `@loop-engine/adapter-perplexity` (`LLMAdapter`) vs [Perplexity Computer skills](https://www.perplexity.ai/computer/skills)
 - [SCM procurement loop example](../loops/scm/procurement.yaml)

packages/adapter-pagerduty/package.json

@@ -53,8 +53,5 @@
     "node": ">=18.0.0"
   },
   "homepage": "https://loopengine.io/docs/packages/adapter-pagerduty",
-  "sideEffects": false,
-  "publishConfig": {
-    "access": "public"
-  }
+  "sideEffects": false
 }

scripts/check-security-metadata.ts

@@ -73,7 +73,8 @@ function main(): void {
     "packages/adapter-openai/package.json",
     "packages/adapter-anthropic/package.json",
     "packages/adapter-grok/package.json",
-    "packages/adapter-gemini/package.json"
+    "packages/adapter-gemini/package.json",
+    "packages/adapter-perplexity/package.json"
   ].map((path) => join(repoRoot, path));
 
   for (const manifestPath of packageManifests) {