Skip to content

Fix Pi compatibility gaps (module installer, config, drift detector) #81

Description

@striderZA

Three critical gaps break the Pi harness experience:

  1. Module installer not Pi-aware: .opencode/modules/install.mjs only copies to .opencode/ paths. Pi reads from .agents/ directly via ocgs-core extension. Pi users get nothing from module installation.

  2. pi.json phantom reference: README.md and AGENTS.md reference pi.json as Pi's config file. This file doesn't exist. Actual Pi config is .pi/settings.json.

  3. ocgs-drift-detector REQUIRED_SECTIONS bug: Checks agents for ["name", "description"] by searching for **name**, ## name markdown patterns. But agent files have these as YAML frontmatter fields (name: creative-director), NOT markdown headings. Produces false positives on every agent file.

Tasks

  • Add --pi flag to install.mjs that targets .agents/ instead of .opencode/, or make .agents/ the default target
  • Either create pi.json with appropriate content or remove all references to it in README.md and AGENTS.md
  • Fix ocgs-drift-detector REQUIRED_SECTIONS to parse YAML frontmatter instead of searching for markdown headings
  • Fix installed.json location mismatch (canonical at .agents/modules/ but script writes to .opencode/modules/)

Affected Files

  • .opencode/modules/install.mjs
  • README.md
  • AGENTS.md
  • .pi/extensions/ocgs-drift-detector/index.ts

Identified during comprehensive framework review on 2026-07-21

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingframework-reviewIdentified during comprehensive framework reviewpi-compatPi harness compatibilitypriority-criticalMust fix immediately

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions