Add HyperMemory AI OpenAI plugin marketplace

.agents/plugins/marketplace.json

@@ -0,0 +1,32 @@
+{
+  "name": "hypermemory-ai",
+  "interface": {
+    "displayName": "HyperMemory AI"
+  },
+  "plugins": [
+    {
+      "name": "hypermemory",
+      "source": {
+        "source": "local",
+        "path": "./plugins/hypermemory"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Memory & Knowledge"
+    },
+    {
+      "name": "hypercolab",
+      "source": {
+        "source": "local",
+        "path": "./plugins/hypercolab"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}

.github/workflows/validate.yml

@@ -0,0 +1,27 @@
+name: Validate marketplace
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - name: Install validation dependencies
+        run: python -m pip install -e "packages/hypercolab-cli[dev]"
+      - name: Lint
+        run: ruff check plugins packages tests scripts
+      - name: Test
+        run: pytest -q
+      - name: Build review archives
+        run: python scripts/build_plugin_archives.py

.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+dist/
+.venv/
+.DS_Store

AGENTS.md

@@ -0,0 +1,32 @@
+# Repository guidance
+
+This repository publishes two OpenAI plugins through one marketplace. Keep the
+plugins independently installable and do not introduce dependencies between
+their manifests.
+
+## Invariants
+
+- Marketplace name: `hypermemory-ai`
+- Plugin IDs and folders: `hypermemory`, `hypercolab`
+- OpenAI surfaces only; do not add formats or instructions for unrelated agent
+  ecosystems.
+- Keep `.codex-plugin/plugin.json` as the required manifest entry point.
+- Keep MCP credentials out of source. Use OAuth or local credential storage.
+- Preserve explicit hook trust and safe degraded behavior.
+- Keep HyperMemory recall on the main agent and persistence/token reporting on
+  one awaited memory-writer sub-agent.
+- Keep HyperColab join/sync/claims on the main agent. Delegated coordination
+  writers may record progress but must not bypass ownership conflicts.
+
+## Validation
+
+Run before committing:
+
+```bash
+ruff check plugins packages tests scripts
+pytest -q
+python scripts/build_plugin_archives.py
+```
+
+When Codex's authoring skills are installed, validate both plugin roots and both
+skills with their bundled validators.

CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing
+
+Thank you for improving the HyperMemory AI OpenAI plugins.
+
+## Development setup
+
+```bash
+git clone https://github.com/hypermemory-ai/hm-plugins-openai.git
+cd hm-plugins-openai
+python -m pip install -e "packages/hypercolab-cli[dev]"
+```
+
+Create a focused branch, change only the plugin or shared catalog behavior in
+scope, and include tests for lifecycle or manifest changes.
+
+## Quality checks
+
+```bash
+ruff check plugins packages tests scripts
+pytest -q
+python scripts/build_plugin_archives.py
+```
+
+Also run the Codex plugin and skill validators listed in the root README when
+available.
+
+## Release checklist
+
+1. Increment the changed plugin's semantic version.
+2. Confirm marketplace name, plugin ID, folder name, and manifest name match.
+3. Validate every referenced asset, skill, hook, and MCP path.
+4. Review hook commands for safe failure behavior and explicit trust.
+5. Confirm no credentials, tokens, test accounts, or private endpoints entered
+   the package.
+6. Build fresh review ZIPs and test installation in a new Codex task.
+7. Document user-visible changes.