Skip to content

feat: add harness-aware project setup for five coding agents - #118

Merged
striderZA merged 6 commits into
masterfrom
fix/harness-aware-setup
Nov 4, 2026
Merged

striderZA merged 6 commits into
masterfrom
fix/harness-aware-setup

Conversation

@striderZA

Copy link
Copy Markdown
Owner

Summary

  • add --harness opencode|pi|omp|claude|codex to the module installer, with per-harness content targets, install state, and MCP files
  • generate omp agents into .omp/agents/, add the required name: frontmatter for Claude Code, and convert agents to TOML for Codex
  • teach /init-template to select a harness, validate its config, repair Windows OpenCode symlinks, and offer opt-in pruning
  • document the five targets and anchor the framework/ ignore rule so docs/framework/ stages normally

Verification

  • npm run test:modules — 16/16
  • npm run test:framework — 100%
  • node tests/workflow/run-all.mjs — 4/4 suites, 11/11 invariants
  • node tests/modules/validate-modules.mjs — 22/22
  • npm test — 54/54 hook tests, 13 suites
  • omp 18.16.0 RPC A/B: with generated .omp/agents/, the task tool lists game-designer; without it, it does not

Notes

  • omp generated agents inherit the session tool set; add tools per file for a narrower boundary
  • Codex has no project-level slash commands or path-scoped rule equivalent
  • Pi and Codex load project MCP config only in trusted projects

Scope the AGENTS.md agent check to the Studio Hierarchy roster and recognize omp's built-in /agents hub as a non-OCGS command.

Refs: docs/omp-compatibility.md
Author MCP fragments per harness and merge them into opencode.json,
.pi/mcp.json, .omp/mcp.json, .mcp.json, or .codex/config.toml. Removal
deletes only the entry the installer added.

Refs: docs/framework/setup-requirements.md
Add --harness opencode|pi|omp|claude|codex with per-harness content
targets, install state, and agent transforms: omp Markdown, Claude name
frontmatter, and Codex TOML. Keep --pi as an alias.

Refs: docs/framework/directory-structure.md
Add a harness question and --harness argument, harness-aware module
installation, config validation, Windows symlink repair, and opt-in
pruning of unused harness directories.

Refs: docs/framework/setup-requirements.md
The unanchored framework/ pattern also ignored docs/framework/, which is
tracked. Anchor it so documentation changes stage normally.

Refs: docs/framework/quick-start.md
Document the five harness targets, module install flags, generated omp
and Codex agents, MCP files, and the updated directory layout.

Refs: docs/framework/quick-start.md
@striderZA
striderZA merged commit e41209e into master Nov 4, 2026
5 checks passed
@striderZA striderZA mentioned this pull request Nov 13, 2026
5 of 7 tasks
striderZA added a commit that referenced this pull request Nov 13, 2026
## Summary

Release prep for v0.14.1: the changelog entry, the
`package.json`/lockfile version bump, and the `UPGRADING.md`
version-index row for the release cycle since v0.14.0.

## Changes

- **CHANGELOG.md** — `v0.14.1` entry covering harness-aware setup for
five agents (#118), the harness tool map and Pi delegation retirement
(#119), the Unity CLI integration (#116), the documentation sweep
(#117), and the question-tool narration fix (#122).
- **package.json / package-lock.json** — version `0.14.0` → `0.14.1`.
- **UPGRADING.md** — `v0.14.1` row in the version index.

## Related Issues

Refs #120 (fixed in #122). No issue is closed by this PR.

## Type of Change

- [ ] Bug fix
- [ ] New feature
- [x] Documentation
- [x] CI/Build

## Testing

Full suite on the release tree (Windows, Node 24):

- `npm test` — 177 plugin tests (19 suites) + 54 hook tests (13 suites)
- `npm run test:extensions` — 68 tests, 68 pass (exit 0; one run printed
an `EPERM` temp-cleanup after-hook, no test failed)
- `npm run test:omp` — 3 tests, 3 pass
- `npm run test:parity` — 4 tests, 4 pass
- `npm run test:modules` — 16 tests, 16 pass
- `node tests/workflow/run-all.mjs` — 4/4 suites
- `node tests/agents/validate.mjs --no-report` — 209/209, 100%
- Docs counts re-verified against the tree: 78 skills, 78 commands, 52
agents, 9 Pi extensions

## Checklist

- [x] Conventional Commits style used in branch commits
- [x] README updated if public interface changed (not needed; no
interface change)
- [x] No secrets or credentials committed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant