cclohmar/OpenWriterControle
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
OpenWriterControle/plugins/claude-code/scripts/context/openagents-repo/lookup/compatibility-layer-adapters.md
Darren Hinde a8fc9c7715
feat(plugin): enhance context management and skill invocation (#239) 
* fix(shellcheck): declare and assign separately in router.sh (SC2155)

* feat(plugin): enhance context management and skill invocation

- Update .context-manifest.json to include profile and detailed source information.
- Revise context-scout.md to clarify context root discovery and navigation.
- Modify commands to replace deprecated skills with updated ones (brainstorming → approach, systematic-debugging → debugger).
- Streamline install-context.md for clarity and remove interactive profile selection.
- Improve oac-status.md to provide a more comprehensive status report.
- Add OAC system paths to session-start.sh for better context management.
- Remove obsolete skills and improve documentation for existing commands.
2026-02-23 12:12:29 +00:00

4.5 KiB
Raw Blame History

Lookup: Compatibility Layer Adapters

Purpose: Quick reference for implemented adapter details

Last Updated: 2026-02-05

Adapter Summary

Adapter Lines Tests Coverage Status
ClaudeAdapter 600 80 96% ✅ Complete
CursorAdapter 554 78 99% ✅ Complete
WindsurfAdapter 514 78 99% ✅ Complete

Total: 1,858 lines of TypeScript, 236 tests

ClaudeAdapter

Format: .claude/config.json (primary), .claude/agents/*.md (subagents)

Capabilities:

  • ✅ Multiple agents
  • ✅ Skills system
  • ✅ Hooks (5 types: PreToolUse, PostToolUse, PermissionRequest, AgentStart, AgentEnd)
  • ⚠️ Binary permissions (granular → degraded)
  • ❌ Temperature not supported

Key Mappings:

  • Model: claude-sonnet-4 ↔ claude-sonnet-4-20250514
  • Permissions: Granular OAC → permissionMode (default/acceptEdits/dontAsk/bypassPermissions)
  • Contexts → Skills system

Tests: 80 tests covering toOAC(), fromOAC(), roundtrip, error handling

CursorAdapter

Format: .cursorrules (single file in project root)

Capabilities:

  • ❌ Single agent only (multi-agent → merged)
  • ❌ No Skills system (contexts → inlined)
  • ❌ No Hooks
  • ⚠️ Binary permissions only
  • ✅ Temperature support (limited)

Key Features:

  • mergeAgents() method for multi-agent → single-file conversion
  • Optional YAML frontmatter
  • Context inlining with references

Key Mappings:

  • Model: claude-sonnet-4 → claude-3-sonnet (fallback to v3)
  • Multiple agents → Merged with section headers

Tests: 78 tests covering toOAC(), fromOAC(), merging, error handling

WindsurfAdapter

Format: .windsurf/config.json, .windsurf/agents/*.json

Capabilities:

  • ✅ Multiple agents (.windsurf/agents/)
  • ⚠️ Partial Skills (→ context references)
  • ❌ No Hooks
  • ⚠️ Binary permissions only
  • ✅ Temperature via creativity setting

Key Mappings:

  • Model: claude-sonnet-4 ↔ claude-4-sonnet
  • Temperature ↔ Creativity: ≤0.4 → low, ≤0.8 → medium, >0.8 → high
  • Priority: critical/high → high, medium/low → low
  • Skills → Context file references in .windsurf/context/

Tests: 78 tests covering toOAC(), fromOAC(), creativity mapping, error handling

Mappers (Phase 3 ✅)

All mappers are pure functions used by adapters and TranslationEngine:

Mapper Lines Tests Coverage Purpose
ToolMapper 308 34 100% Tool name mapping (bash↔terminal, etc.)
PermissionMapper 354 37 98% Granular↔binary permissions
ModelMapper 413 37 99% Model ID mapping with fallbacks
ContextMapper 384 51 97% Context path mapping between platforms

Core Services (Phase 3 ✅)

Service Lines Tests Coverage Purpose
CapabilityMatrix 559 43 99% Feature compatibility analysis
TranslationEngine 453 47 99% Orchestrates all mappers

Common Patterns

Bidirectional Conversion

All 3 adapters support:

  • toOAC(): Tool format → OpenAgent
  • fromOAC(): OpenAgent → Tool format

Graceful Degradation

All adapters warn when features are lost:

  • Granular permissions → Binary on/off
  • Unsupported features → Warning messages
  • Feature loss → Clear user notifications

Type Safety

  • All extend BaseAdapter
  • Full TypeScript strict mode
  • Zod schema validation
  • 0 compilation errors

Feature Parity Matrix

Feature OAC Claude Cursor Windsurf
Multiple Agents ✅ ✅ ❌ ✅
Granular Permissions ✅ ❌ ❌ ❌
Ask Permissions ✅ ❌ ❌ ❌
Hooks ✅ ✅ ❌ ❌
Skills ✅ ✅ ❌ ⚠️
External Context ✅ ✅ ❌ ✅
Context Priority ✅ ❌ ❌ ❌
Temperature ✅ ❌ ⚠️ ✅
Model Selection ✅ ✅ ✅ ✅
Task Delegation ✅ ✅ ❌ ⚠️

Legend: ✅ Full support, ⚠️ Partial support, ❌ Not supported

Reference

Implementation: packages/compatibility-layer/src/adapters/ Issue: https://github.com/darrenhinde/OpenAgentsControl/issues/141

Related:

  • lookup/compatibility-layer-progress.md
  • lookup/compatibility-layer-structure.md
  • guides/compatibility-layer-workflow.md