README.md

# Stratta for ChatGPT and Codex

The package uploaded to the OpenAI Plugins portal. It connects the production remote MCP server:

```text
https://stratta.ch/mcp
```

## Files

- `.codex-plugin/plugin.json`: identity, listing, and the review and publication materials under `extensions.com.openai` (test cases, demo, release notes, countries, French listing text, onboarding skill).
- `.mcp.json`: the remote MCP server. It travels in the ZIP: a plugin with an MCP server keeps it in every package version.
- `skills/`: `get-started` (onboarding), `consult-stratta`, and the drafting procedures the server also serves through `list_skills`. Only `get-started` is written here; the others are generated by `npm run build:skills`.
- `assets/`: icon and logo referenced by the manifest.

## Build and check

```bash
npm run verify:openai-plugin      # package rules, review materials, annotations
npm run build:plugin-bundle       # dist-plugin/stratta-plugin.zip
```

Upload the ZIP to the existing plugin on platform.openai.com (Plugins, then "Upload plugin to make changes"). A new ZIP needs a new `version`. Changes to the hosted tools need no ZIP: OpenAI rescans the server every day, and **Rescan** forces it.

The runbook is `docs/openai-plugin-readiness.md`; the decisions are in ADR 39 and ADR 59.

## Developer mode

For a local test before a release, register `https://stratta.ch/mcp` in ChatGPT developer mode. Never commit an `.app.json` or an app ID: ZIPs that reference apps cannot be submitted.