Skip to content

Commit 6007673

Browse files
committed
fix: remove JuliusBrussee/blueprint entry to fix CI (plugin missing .codex-plugin/plugin.json)
1 parent da1d2ea commit 6007673

135 files changed

Lines changed: 8816 additions & 640 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.agents/plugins/marketplace.json

Lines changed: 36 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -28,18 +28,6 @@
2828
},
2929
"category": "Development & Workflow"
3030
},
31-
{
32-
"name": "ck",
33-
"source": {
34-
"source": "local",
35-
"path": "./plugins/JuliusBrussee/blueprint"
36-
},
37-
"policy": {
38-
"installation": "AVAILABLE",
39-
"authentication": "ON_INSTALL"
40-
},
41-
"category": "Development & Workflow"
42-
},
4331
{
4432
"name": "brooks-lint",
4533
"source": {
@@ -172,6 +160,30 @@
172160
},
173161
"category": "Development & Workflow"
174162
},
163+
{
164+
"name": "tailtest",
165+
"source": {
166+
"source": "local",
167+
"path": "./plugins/avansaber/tailtest-codex"
168+
},
169+
"policy": {
170+
"installation": "AVAILABLE",
171+
"authentication": "ON_INSTALL"
172+
},
173+
"category": "Development & Workflow"
174+
},
175+
{
176+
"name": "tool-advisor",
177+
"source": {
178+
"source": "local",
179+
"path": "./plugins/dragon1086/claude-skills"
180+
},
181+
"policy": {
182+
"installation": "AVAILABLE",
183+
"authentication": "ON_INSTALL"
184+
},
185+
"category": "Development & Workflow"
186+
},
175187
{
176188
"name": "vibe-portrait",
177189
"source": {
@@ -352,6 +364,18 @@
352364
},
353365
"category": "Tools & Integrations"
354366
},
367+
{
368+
"name": "mobazha",
369+
"source": {
370+
"source": "local",
371+
"path": "./plugins/mobazha/mobazha-skills"
372+
},
373+
"policy": {
374+
"installation": "AVAILABLE",
375+
"authentication": "ON_INSTALL"
376+
},
377+
"category": "Tools & Integrations"
378+
},
355379
{
356380
"name": "morning-ai",
357381
"source": {

README.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,6 @@ Third-party plugins built by the community. [PRs welcome](#contributing)!
7878
<!-- pinned -->
7979
- [Registry Broker](https://github.com/hashgraph-online/registry-broker-codex-plugin) - Delegate tasks to specialist AI agents via the HOL Registry, plan, find, summon, and recover sessions.
8080
- [AgentOps](https://github.com/boshu2/agentops) - DevOps layer for coding agents with flow, feedback, and memory that compounds between sessions.
81-
- [Blueprint](https://github.com/JuliusBrussee/blueprint) - Specification-driven development pipeline that turns natural language into domain blueprints with testable acceptance criteria, generates parallel build plans, and implements them with automated validation and cross-model adversarial review.
8281
- [Brooks Lint](https://github.com/hyhmrright/brooks-lint) - AI code reviews grounded in six classic engineering books — decay risk diagnostics with book citations, severity labels, and four analysis modes (PR review, architecture audit, tech debt, test quality).
8382
- [Claude Code for Codex](https://github.com/sendbird/cc-plugin-codex) - Reverse of OpenAI's official Claude-hosted plugin: use Claude Code from Codex for reviews, rescue tasks, tracked background jobs, and hook-powered review gates.
8483
- [Claude Code Harness](https://github.com/dadwadw233/claude-code-harness) - Harness blueprint skill for turning vague agent ideas into concrete designs for request assembly, control loops, memory, permissions, recovery, and extension planes.

plugins.json

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
"$schema": "https://json-schema.org/draft/2020-12/schema",
33
"name": "awesome-codex-plugins",
44
"version": "1.0.0",
5-
"last_updated": "2026-04-22",
6-
"total": 44,
5+
"last_updated": "2026-04-23",
6+
"total": 46,
77
"categories": [
88
"Development & Workflow",
99
"Tools & Integrations"
@@ -29,16 +29,6 @@
2929
"source": "awesome-codex-plugins",
3030
"install_url": "https://raw.githubusercontent.com/boshu2/agentops/main/.codex-plugin/plugin.json"
3131
},
32-
{
33-
"name": "Blueprint",
34-
"url": "https://github.com/JuliusBrussee/blueprint",
35-
"owner": "JuliusBrussee",
36-
"repo": "blueprint",
37-
"description": "Specification-driven development pipeline that turns natural language into domain blueprints with testable acceptance criteria, generates parallel build plans, and implements them with automated validation and cross-model adversarial review.",
38-
"category": "Development & Workflow",
39-
"source": "awesome-codex-plugins",
40-
"install_url": "https://raw.githubusercontent.com/JuliusBrussee/blueprint/main/.codex-plugin/plugin.json"
41-
},
4232
{
4333
"name": "Brooks Lint",
4434
"url": "https://github.com/hyhmrright/brooks-lint",
@@ -159,6 +149,16 @@
159149
"source": "awesome-codex-plugins",
160150
"install_url": "https://raw.githubusercontent.com/avansaber/tailtest-codex/main/.codex-plugin/plugin.json"
161151
},
152+
{
153+
"name": "Tool Advisor",
154+
"url": "https://github.com/dragon1086/claude-skills",
155+
"owner": "dragon1086",
156+
"repo": "claude-skills",
157+
"description": "Read-only meta-skill that scans your MCP servers, skills, plugins, and CLI tools, then suggests up to three ranked approaches (Methodical / Fast / Deep) with a copy-paste Quick Action table.",
158+
"category": "Development & Workflow",
159+
"source": "awesome-codex-plugins",
160+
"install_url": "https://raw.githubusercontent.com/dragon1086/claude-skills/main/.codex-plugin/plugin.json"
161+
},
162162
{
163163
"name": "VibePortrait",
164164
"url": "https://github.com/dadwadw233/VibePortrait",
@@ -309,6 +309,16 @@
309309
"source": "awesome-codex-plugins",
310310
"install_url": "https://raw.githubusercontent.com/BlockchainHB/launchfast_codex_plugin/main/.codex-plugin/plugin.json"
311311
},
312+
{
313+
"name": "Mobazha",
314+
"url": "https://github.com/mobazha/mobazha-skills",
315+
"owner": "mobazha",
316+
"repo": "mobazha-skills",
317+
"description": "Decentralized e-commerce skills — deploy self-hosted stores, import products from Shopify/Amazon, configure custom domains and Telegram bots, set up Tor privacy, and manage your store via MCP.",
318+
"category": "Tools & Integrations",
319+
"source": "awesome-codex-plugins",
320+
"install_url": "https://raw.githubusercontent.com/mobazha/mobazha-skills/main/.codex-plugin/plugin.json"
321+
},
312322
{
313323
"name": "MorningAI",
314324
"url": "https://github.com/octo-patch/MorningAI",

plugins/Kanevry/session-orchestrator/README.md

Lines changed: 83 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Session Orchestrator
22

33
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
4-
[![Version](https://img.shields.io/badge/version-2.0.0-green.svg)](CHANGELOG.md)
4+
[![Version](https://img.shields.io/badge/version-3.0.0--dev-orange.svg)](CHANGELOG.md)
55
[![Claude Code Plugin](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet.svg)](https://docs.anthropic.com/en/docs/claude-code)
66
[![Codex](https://img.shields.io/badge/Codex-Compatible-green.svg)](https://developers.openai.com/codex/)
77
[![Cursor IDE](https://img.shields.io/badge/Cursor_IDE-Compatible-blue.svg)](https://cursor.com)
@@ -12,6 +12,8 @@ Session orchestration plugin for Claude Code, Codex, and Cursor IDE. Covers proj
1212
1313
## Install
1414

15+
> **Prerequisite:** Node.js 20 or later. Check with `node --version`. v3.x runs as ES modules and requires a real Node runtime (no Bash shim). [Install Node.js](https://nodejs.org/).
16+
1517
### Claude Code
1618

1719
Run these two slash commands **inside** Claude Code (they are not shell commands; there is no `claude plugin` CLI):
@@ -21,7 +23,14 @@ Run these two slash commands **inside** Claude Code (they are not shell commands
2123
/plugin install session-orchestrator@kanevry
2224
```
2325

24-
The first command registers this repository as a marketplace (named `kanevry`), the second installs the plugin from it. Reload Claude Code so the slash commands (`/session`, `/go`, `/close`, …) become available.
26+
Then install Node dependencies **once** (hooks import `zx`):
27+
28+
```bash
29+
cd "$(claude plugin dir session-orchestrator 2>/dev/null || echo ~/.claude/plugins/session-orchestrator)"
30+
npm install
31+
```
32+
33+
Restart Claude Code so the slash commands (`/session`, `/go`, `/close`, …) become available.
2534

2635
Prefer installing from a local clone? Use an absolute path instead of the `owner/repo` shorthand:
2736

@@ -34,17 +43,21 @@ Prefer installing from a local clone? Use an absolute path instead of the `owner
3443

3544
```bash
3645
git clone https://github.com/Kanevry/session-orchestrator.git ~/Projects/session-orchestrator
37-
bash ~/Projects/session-orchestrator/scripts/codex-install.sh
46+
cd ~/Projects/session-orchestrator
47+
npm install
48+
bash scripts/codex-install.sh
3849
```
3950

4051
### Cursor IDE
4152

4253
```bash
4354
# 1. Clone the session-orchestrator repo
4455
git clone https://github.com/Kanevry/session-orchestrator.git ~/Projects/session-orchestrator
56+
cd ~/Projects/session-orchestrator
57+
npm install
4558

4659
# 2. Install Cursor rules into your project
47-
bash ~/Projects/session-orchestrator/scripts/cursor-install.sh /path/to/your/project
60+
bash scripts/cursor-install.sh /path/to/your/project
4861

4962
# Session Config goes in CLAUDE.md (Cursor reads it natively)
5063
```
@@ -80,13 +93,16 @@ See [Usage](#usage) for all 7 commands and [User Guide](docs/USER-GUIDE.md) for
8093

8194
## Prerequisites
8295

96+
- **Node.js 20 or later** — plugin runs as ES modules; no Bash runtime needed.
8397
- **Claude Code**, **Codex**, or **Cursor IDE**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | [Codex](https://developers.openai.com/codex/) | [Cursor IDE](https://cursor.com)
84-
- **jq** (recommended): required for scope and command enforcement hooks
98+
- **jq** (optional): convenience for editing the `.orchestrator/policy/*.json` files. Not invoked by hooks at runtime in v3.
99+
- **git** — any recent version.
85100

86101
### Platform Support
87102

88103
| Feature | Claude Code | Codex | Cursor IDE |
89104
|---------|------------|-----------|------------|
105+
| OS | macOS, Linux, **Windows (native)** | macOS, Linux, **Windows (native)** | macOS, Linux, **Windows (native)** |
90106
| All 7 commands | Native slash commands | Native plugin commands | Rules-based (.mdc) |
91107
| Parallel agents | Agent tool | Multi-agent roles | Sequential only |
92108
| Session persistence | .claude/STATE.md | .codex/STATE.md | .cursor/STATE.md |
@@ -96,7 +112,45 @@ See [Usage](#usage) for all 7 commands and [User Guide](docs/USER-GUIDE.md) for
96112
| Quality gates | Full | Full | Full |
97113
| Design alignment | Pencil integration | Pencil integration | Pencil integration |
98114

99-
All platforms share the same skills, commands, hooks, and scripts. Platform-specific adaptations are handled automatically via `scripts/lib/platform.sh`. See setup guides: [Codex](docs/codex-setup.md) | [Cursor IDE](docs/cursor-setup.md).
115+
Windows support is **native** as of v3.0.0 — no WSL, no Git-Bash, no msys. All file paths use `path.join`, all tmp paths use `os.tmpdir()`, and CI verifies on `windows-latest` alongside `ubuntu-latest` and `macos-latest`.
116+
117+
All platforms share the same skills, commands, hooks, and scripts. Platform-specific adaptations are handled automatically via `scripts/lib/platform.mjs`. See setup guides: [Codex](docs/codex-setup.md) | [Cursor IDE](docs/cursor-setup.md).
118+
119+
## Troubleshooting
120+
121+
### Hooks silently no-op after install
122+
123+
Most common cause on any OS: `npm install` was not run in the plugin directory, so `zx` is missing. Run it and restart your editor. Verify with `ls node_modules/zx` in the plugin root.
124+
125+
### Windows: `Cannot use import statement outside a module` or `node` not found
126+
127+
`node` must be on the editor's `PATH`. If you installed Node via nvm-windows or fnm, relaunch the editor from a shell where `node --version` prints `v20.x` or later. In Claude Code you can sanity-check with `!node --version`.
128+
129+
### Windows: CRLF breaks shell scripts / hooks after upgrade
130+
131+
v3 ships `.gitattributes` with explicit LF rules for `.sh`, `.mjs`, `.md`, `.json`, and `.yaml`. Clones from before v3 may still have CRLF endings in tracked files. Normalize once:
132+
133+
```bash
134+
git config core.autocrlf false
135+
git rm --cached -r .
136+
git reset --hard
137+
```
138+
139+
Back up any uncommitted work first.
140+
141+
### macOS / Linux: `Permission denied` on a hook
142+
143+
v3 hooks are `.mjs` files invoked via `node <path>` — the executable bit is not required. If your editor reports `Permission denied`, it is still pointing at a stale `.sh` path. Re-run the platform install script (`scripts/codex-install.sh`, `scripts/cursor-install.sh`) or re-add the plugin in Claude Code.
144+
145+
### `SyntaxError` in hooks
146+
147+
Confirm Node version (`node --version` must be `v20.x+`) and that `package.json` has `"type": "module"`. Both are required for ESM imports.
148+
149+
### `npm install` fails with `ERESOLVE`
150+
151+
Use Node 20 or 22 LTS. If the error persists: `npm install --legacy-peer-deps`. Open an issue if it still fails.
152+
153+
For a longer walkthrough including rollback, see [docs/migration-v3.md](docs/migration-v3.md).
100154

101155
## Why Session Orchestrator
102156

@@ -310,11 +364,33 @@ Superpowers handles the **task layer** (TDD, debugging, brainstorming per featur
310364
- **Output Styles**: 3 styles (session-report, wave-summary, finding-report) for consistent reporting
311365
- `.codex-plugin/`: Codex plugin manifest (`plugin.json`) + compatibility config + 3 agent role definitions
312366
- `scripts/codex-install.sh`: installs into the active Codex desktop plugin catalog or falls back to a local marketplace
313-
- `scripts/`: 5 deterministic scripts (parse-config, run-quality-gate, validate-wave-scope, validate-plugin, token-audit) + shared lib + 328 tests
367+
- `scripts/`: deterministic scripts (parse-config, run-quality-gate, validate-wave-scope, validate-plugin, token-audit) + shared lib (`scripts/lib/*.mjs`) + vitest suite (533+ tests)
368+
369+
## Development
370+
371+
Clone, install, and verify in three commands:
372+
373+
```bash
374+
git clone https://github.com/Kanevry/session-orchestrator.git && cd session-orchestrator
375+
npm install
376+
npm test # vitest — primary test flow
377+
```
378+
379+
Additional scripts:
380+
381+
- `npm run test:watch` — vitest in watch mode
382+
- `npm run lint` / `npm run lint:fix` — ESLint v9 + Prettier
383+
- `npm run typecheck``node --check` on every `.mjs` file (syntactic-only; no TypeScript yet)
384+
385+
The legacy `bats` shell suite (`scripts/test/run-all.sh`) is retained for historical reference but is **deprecated** and will be removed in a future release. Do not add new tests there — use `tests/**/*.test.mjs` under vitest.
386+
387+
For contributor-facing architecture, hook authoring, and the `zx`-vs-stdlib heuristic, see [docs/plugin-architecture-v3.md](docs/plugin-architecture-v3.md).
314388

315389
## Documentation
316390

317391
- [User Guide](docs/USER-GUIDE.md): installation, config reference, workflow walkthrough, FAQ
392+
- [Migration to v3](docs/migration-v3.md): upgrade path from v2.x to v3.0.0, known issues, rollback
393+
- [Plugin Architecture (v3)](docs/plugin-architecture-v3.md): contributor guide — layering, hook anatomy, lib catalog, testing
318394
- [CONTRIBUTING.md](CONTRIBUTING.md): plugin architecture, skill anatomy, development setup
319395
- [CHANGELOG.md](CHANGELOG.md): version history
320396
- [Example Configs](docs/examples/): Session Config examples for Next.js, Express, Swift

0 commit comments

Comments
 (0)