732642856
43 lines
2.4 KiB
Markdown
43 lines
2.4 KiB
Markdown
# Local Codex Plugin Wrapper Implementation Plan
|
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
**Goal:** Add a minimal local Codex plugin wrapper around the existing Jyotish repo so Codex can install it as a plugin using the repo's current skills and MCP server.
|
|
**Architecture:** Keep the repo as source of truth. Add only a `.codex-plugin/plugin.json` manifest that points at existing `skills/` and the existing root `mcp_server.py`. Lock it with one static test and document local install/test steps.
|
|
**Tech Stack:** JSON manifest, existing Python MCP server, pytest static checks, Codex local plugin install flow.
|
|
## Global Constraints
|
|
- Reuse existing `SKILL.md`, `skills/`, and `mcp_server.py`; no duplicate runtime chain.
|
|
- Keep plugin scope local-only; no marketplace publishing work.
|
|
- Smallest diff wins: one manifest, one test, one short install doc update.
|
|
|
|
### Task 1: Add plugin manifest coverage
|
|
**Files:**
|
|
- Modify: `tests/test_runtime_import_boundaries.py` or create focused plugin manifest test if cleaner
|
|
- Test: `tests/test_codex_plugin_wrapper.py`
|
|
**Interfaces:**
|
|
- Consumes: `.codex-plugin/plugin.json`
|
|
- Produces: static validation that plugin manifest exists and points at current repo assets
|
|
- [ ] **Step 1: Write failing static test**
|
|
- [ ] **Step 2: Run test to confirm failure**
|
|
- [ ] **Step 3: Add minimal manifest or adjust expectations**
|
|
- [ ] **Step 4: Re-run targeted test**
|
|
|
|
### Task 2: Add minimal local plugin manifest
|
|
**Files:**
|
|
- Create: `.codex-plugin/plugin.json`
|
|
**Interfaces:**
|
|
- Consumes: existing `skills/`, root `mcp_server.py`
|
|
- Produces: installable local plugin metadata
|
|
- [ ] **Step 1: Use plugin spec sample to choose minimal accepted fields**
|
|
- [ ] **Step 2: Point `skills` at existing `./skills/`**
|
|
- [ ] **Step 3: Inline `mcpServers` config for `mcp_server.py`**
|
|
- [ ] **Step 4: Validate manifest with plugin validator**
|
|
|
|
### Task 3: Document local install/test flow
|
|
**Files:**
|
|
- Modify: `README.md`
|
|
**Interfaces:**
|
|
- Consumes: local plugin install command shape
|
|
- Produces: copy-paste local install, reinstall, and test commands
|
|
- [ ] **Step 1: Add minimal plugin install section**
|
|
- [ ] **Step 2: Include reinstall/new-thread note**
|
|
- [ ] **Step 3: Run targeted doc/static checks**
|