Skip to content

feat: add full Oh My Pi (OMP) support - #256

Open
Lynricsy wants to merge 16 commits into
cortexkit:masterfrom
Lynricsy:feat/omp-support
Open

feat: add full Oh My Pi (OMP) support#256
Lynricsy wants to merge 16 commits into
cortexkit:masterfrom
Lynricsy:feat/omp-support

Conversation

@Lynricsy

@Lynricsy Lynricsy commented Jul 28, 2026

Copy link
Copy Markdown

Summary

  • add OMP as a first-class CLI harness with native plugin-manager detection, setup, doctor, repair, and OpenCode session migration
  • reuse the Pi-compatible runtime while preserving OMP profile, XDG, child-process, extension allowlist, and shared-memory semantics
  • discover OMP JSON model selectors and default/named-profile sessions in the dashboard
  • publish an explicit OMP extension manifest and document installation, conflicts, migration, configuration, troubleshooting, and dashboard behavior

Compatibility decisions

  • OMP uses the existing Pi runtime and keeps the harness='pi' discriminator for session-scoped rows
  • project memories remain shared across OpenCode, Pi, and OMP
  • setup disables OMP native compaction and automatic memory transactionally to avoid competing context managers
  • model discovery consumes omp models --json selectors so scoped and nested IDs are preserved

Verification

  • CLI: 292 passed, 2 skipped, 0 failed; lint, typecheck, build passed
  • Pi/OMP extension: 711 passed, 0 failed; typecheck, build, npm pack dry-run passed
  • docs: Astro build completed all 22 pages
  • real OMP 17.1.7 smoke: linked the local package through omp plugin, launched OMP, and /ctx-status reported Magic Context v0.33.0 with historian idle
  • dashboard session module: 8 Rust tests passed through an isolated crate that includes the production source; touched Rust files pass rustfmt parsing/check

Environment note

The full Tauri Cargo suite could not link on this workstation because pkg-config/DBus development metadata is absent; the failure occurs in libdbus-sys before project code compiles.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.


Summary by cubic

Adds first-class OMP support across the CLI, Pi-compatible extension, and dashboard, with install, doctor, and OpenCode→OMP migration. Models and sessions appear in the dashboard using a shared runtime, config, and database; discovery is reliable via normalized doctor paths and trimmed env paths.

  • New Features

    • CLI: added omp harness with setup --harness omp and doctor --harness omp; supports --harness opencode|pi|omp.
    • OMP setup/doctor: auto-detects OMP, verifies minimum version, disables native compaction and automatic memory, writes config atomically, and supports --force repair.
    • Model discovery: consumes omp models --json and preserves scoped/nested selectors.
    • Provider mapping: added OMP canonicalization/resolution so OMP provider IDs round‑trip with the shared config.
    • Extension: @cortexkit/pi-magic-context declares an OMP manifest, runs on both Pi and OMP, marks Pi peers optional, and resolves relative allowlist entries from PI_CODING_AGENT_DIR.
    • Dashboard: discovers OMP models and sessions, handles OMP profiles, and deduplicates sessions across aliased roots.
    • Compatibility: reuses the Pi runtime and keeps harness='pi' for session rows.
    • Migration: doctor migrate --from opencode --to omp writes Pi/OMP JSONL to the active OMP sessions root.
    • CI: adds a real OMP Docker E2E smoke to validate plugin-manager install and doctor repair.
  • Bug Fixes

    • CLI doctor: normalized OMP paths, hardened diagnostics, and isolated host config boundaries.
    • Dashboard: trimmed OMP environment paths and gated/merged discovery to prevent duplicates and missing entries.

Written for commit d231001. Summary will update on new commits.

Review in cubic

Greptile Summary

Adds first-class Oh My Pi support across the CLI, Pi-compatible extension, dashboard, documentation, and CI.

  • Adds OMP detection, setup, doctor, repair, model discovery, and OpenCode session migration.
  • Extends dashboard discovery to OMP roots and profiles while deduplicating logical sessions across roots.
  • Adds an OMP extension manifest, host-specific path handling, documentation, and a real Docker smoke test.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains; the previously reported multi-root duplication and detail-selection mismatch are addressed by canonical root deduplication and consistent session-ID deduplication across list and detail paths.

Important Files Changed

Filename Overview
packages/dashboard/src-tauri/src/pi_sessions.rs Adds OMP default, profile, and XDG session roots and consistently deduplicates discovered sessions by session ID before list and detail lookup.
packages/cli/src/commands/setup-omp.ts Implements OMP setup and transactional host-setting repair for plugin installation, native compaction, and automatic memory.
packages/cli/src/commands/doctor-omp.ts Adds OMP installation, version, plugin, configuration, path, and shared-database diagnostics with guarded repairs.
packages/cli/src/adapters/omp.ts Adds the OMP harness adapter using the native plugin manager with enable-state verification and rollback behavior.
packages/cli/src/commands/migrate.ts Extends session migration to target the active OMP sessions root using the Pi-compatible JSONL format.
packages/pi-plugin/src/subagent-runner.ts Adapts the shared Pi runtime to OMP-specific process, profile, path, and extension-allowlist semantics.
.github/workflows/ci.yml Adds a Docker-based OMP installation and runtime smoke-test job.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    CLI[Magic Context CLI] --> Detect[Detect OMP and resolve profile/XDG paths]
    Detect --> Setup[Install and configure Pi-compatible extension]
    Setup --> OMP[Oh My Pi runtime]
    OMP --> SharedDB[(Shared Magic Context database)]
    OMP --> Sessions[OMP JSONL sessions]
    Sessions --> Dashboard[Dashboard session discovery]
    SharedDB --> Dashboard
    OpenCode[OpenCode sessions] --> Migration[Session migration]
    Migration --> Sessions
Loading

Reviews (6): Last reviewed commit: "docs(pi): 📝 clarify host-scoped extensi..." | Re-trigger Greptile

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed

Tip: cubic can generate docs of your entire codebase and keep them up to date. Try it here.

Re-trigger cubic

Comment thread packages/pi-plugin/README.md
Comment thread packages/cli/src/commands/setup-pi.ts
Comment thread packages/cli/src/commands/doctor-omp.ts Outdated
Comment thread packages/dashboard/src-tauri/src/commands.rs Outdated
Comment thread packages/cli/src/lib/omp-helpers.ts Outdated
Comment thread packages/docs/src/content/docs/index.mdx
Comment thread packages/cli/src/commands/setup-pi.ts Outdated
Comment thread packages/cli/src/commands/doctor-omp.ts
Comment thread packages/cli/src/lib/omp-helpers.ts
Comment thread packages/dashboard/src-tauri/src/pi_sessions.rs
@Lynricsy

Copy link
Copy Markdown
Author

Addressed the multi-root session review in f979800. Dashboard discovery now canonicalizes paths, deduplicates by session ID, sorts duplicates by modified time descending with a stable path tie-break, and therefore keeps the newest continued copy rather than root-order priority. Added regression coverage for a newer duplicate in the second root; the production module now passes 9 isolated Rust tests.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 42 files

Tip: cubic can generate docs of your entire codebase and keep them up to date. Try it here.

Re-trigger cubic

Comment thread packages/dashboard/src-tauri/src/pi_sessions.rs
Comment thread packages/dashboard/src-tauri/src/pi_sessions.rs Outdated
@alfonso-magic-context

Copy link
Copy Markdown
Collaborator

This is on our merge path — could you rebase onto current master? The v0.33.1 release wave landed conflicting changes in the areas this touches. Once it's green we'll do the full review pass.

Lynricsy and others added 10 commits August 5, 2026 21:55
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Copilot AI lite review requested due to automatic review settings August 5, 2026 14:10
@Lynricsy

Lynricsy commented Aug 5, 2026

Copy link
Copy Markdown
Author

Rebased feat/omp-support onto current origin/master (12678424) and force-pushed with --force-with-lease. The only rebase conflict was the CLI package metadata; it now keeps v0.33.1 while retaining the OpenCode/Pi/OMP description.

I also resolved the valid review findings while re-verifying the v0.33.1 contracts: Pi setup now rolls back a newly-added package entry on later failure; OMP doctor can repair shared config without an OMP binary; OMP subprocess errors preserve timeout details and use a 10 MiB buffer; dashboard Pi login-shell discovery precedes OMP fallback; OMP profile names are validated; multi-root dedup uses explicit root priority and canonicalizes roots rather than every session; the homepage support matrix now includes OMP.

Post-rebase verification:

  • CLI: 299 passed, 2 skipped, 0 failed; lint + typecheck passed
  • Pi/OMP extension: 715 passed, 0 failed; typecheck passed
  • root typecheck + all publish builds passed
  • docs: all 22 pages built
  • dashboard production session module: 10 isolated Rust tests passed; touched Rust files pass rustfmt check

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds first-class Oh My Pi (OMP) support across Magic Context’s CLI, Pi-compatible extension/runtime, dashboard session/model discovery, and documentation—while keeping Pi-compatible session semantics (harness='pi') and shared project memory/database behavior.

Changes:

  • CLI: introduce an omp harness with setup/doctor flows, OMP model discovery, OMP path resolution, and OpenCode → Pi/OMP migration targeting.
  • Dashboard: expand Pi-compatible session-root discovery to include OMP profile/XDG layouts and add OMP model selector parsing.
  • Extension + docs: update Pi extension to support OMP env semantics (agent dir allowlist resolution) and document installation, conflicts, migration, and dashboard behavior.

Reviewed changes

Copilot reviewed 42 out of 43 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
README.md Updates top-level product messaging and setup/doctor guidance to include OMP.
packages/plugin/scripts/build-config-docs.ts Updates generated config-doc preface to reflect shared config across OpenCode/Pi/OMP.
packages/pi-plugin/src/subagent-runner.ts Resolves relative allowlisted extensions from PI_CODING_AGENT_DIR for Pi/OMP parity.
packages/pi-plugin/src/subagent-runner.test.ts Adds test coverage for host agent-dir based allowlist resolution.
packages/pi-plugin/README.md Updates extension docs for shared config paths and adds OMP installation/troubleshooting guidance.
packages/pi-plugin/package.json Publishes explicit OMP extension manifest metadata and keywords/description updates.
packages/docs/src/content/docs/reference/dashboard.md Documents dashboard behavior for Pi-compatible sessions including OMP.
packages/docs/src/content/docs/reference/configuration.md Updates configuration reference header to include OMP.
packages/docs/src/content/docs/index.mdx Updates docs landing page to include OMP and “three harnesses” messaging.
packages/docs/src/content/docs/help/troubleshooting.md Adds OMP-specific restart guidance (/reload-plugins) and wording updates.
packages/docs/src/content/docs/help/faq.md Updates FAQ for shared DB across OpenCode/Pi/OMP and migration to Pi/OMP.
packages/docs/src/content/docs/help/compatibility.md Adds OMP compaction/memory conflict documentation and resolution steps.
packages/docs/src/content/docs/getting-started/migrating-between-harnesses.md Extends migration guide to cover OpenCode → Pi/OMP.
packages/docs/src/content/docs/getting-started/introduction.md Updates intro narrative to include OMP as a supported harness.
packages/docs/src/content/docs/getting-started/installation.md Adds OMP as a first-class install target and documents OMP-specific setup actions.
packages/docs/src/content/docs/concepts/mural.md Clarifies mural support across OpenCode and Pi-compatible hosts (Pi/OMP).
packages/docs/src/content/docs/concepts/memory.md Updates memory-sharing explanation to include OMP.
packages/dashboard/src-tauri/src/pi_sessions.rs Adds OMP profile/XDG root discovery and deduplication across multiple Pi-compatible roots.
packages/dashboard/src-tauri/src/commands.rs Adds omp models --json parsing and OMP model discovery fallback for dashboard.
packages/cli/src/lib/v22-backfill-commands.ts Updates schema-fence restart warning to include OMP.
packages/cli/src/lib/paths.ts Adds OMP path resolution helpers (profiles, overrides, XDG data layout).
packages/cli/src/lib/paths-omp.test.ts Adds tests for OMP path resolution behavior.
packages/cli/src/lib/omp-helpers.ts Adds OMP binary detection, command helpers, settings access, and model/plugin parsing.
packages/cli/src/lib/omp-helpers.test.ts Adds tests for OMP model parsing and command timeout/buffer behavior.
packages/cli/src/lib/harness-select.ts Extends harness selection/validation to include --harness omp.
packages/cli/src/index.ts Updates CLI help text to reflect OMP support and Pi/OMP migration.
packages/cli/src/commands/setup.ts Dispatches setup to OMP setup flow and updates next-steps messaging.
packages/cli/src/commands/setup-pi.ts Refactors setup into a Pi-compatible host abstraction and adds rollback support.
packages/cli/src/commands/setup-pi.test.ts Adds rollback tests for Pi settings package registration.
packages/cli/src/commands/setup-omp.ts Implements OMP setup via Pi-compatible setup host + transactional OMP conflict disabling.
packages/cli/src/commands/setup-omp.test.ts Adds tests for OMP transactional rollback behavior.
packages/cli/src/commands/migrate.ts Extends migration target to --to omp and routes output to OMP sessions root.
packages/cli/src/commands/migrate.test.ts Adds CLI parsing test coverage for --to omp.
packages/cli/src/commands/doctor.ts Dispatches doctor to OMP doctor flow.
packages/cli/src/commands/doctor-omp.ts Adds OMP-specific doctor/repair/issue-report logic.
packages/cli/src/commands/doctor-omp.test.ts Adds tests for healthy OMP doctor flow and config creation when OMP is missing.
packages/cli/src/adapters/types.ts Extends adapter types to include `HarnessKind = ...
packages/cli/src/adapters/omp.ts Adds an OMP adapter covering detection, plugin enablement, cache/log paths, and install hint.
packages/cli/src/adapters/omp.test.ts Adds adapter tests for detecting an enabled plugin via omp plugin list --json.
packages/cli/src/adapters/index.ts Registers OMP adapter in the global adapter list and exports it.
packages/cli/package.json Updates CLI package metadata/keywords to include OMP.
CONFIGURATION.md Updates shared-config + doctor documentation to include OMP behavior.
.gitignore Ignores agent log directories (AgentLogs/, .agent-logs/).
Suppressed comments (2)

packages/dashboard/src-tauri/src/pi_sessions.rs:154

  • PI_CONFIG_DIR isn’t trimmed before converting to PathBuf. If the env var contains leading/trailing whitespace it will resolve to a different directory than the CLI uses (which trims), causing session-root discovery to diverge across components.
    let config_dir = std::env::var_os("PI_CONFIG_DIR")
        .filter(|v| !v.is_empty())
        .map(PathBuf::from)
        .unwrap_or_else(|| PathBuf::from(".omp"));

packages/dashboard/src-tauri/src/pi_sessions.rs:169

  • XDG_DATA_HOME is also consumed without trimming. Trimming avoids treating whitespace-only values as valid and keeps behavior aligned with the CLI path resolver (which trims).
    if let Some(xdg_data) = std::env::var_os("XDG_DATA_HOME").filter(|v| !v.is_empty()) {
        let app_root = PathBuf::from(xdg_data).join("omp");
        append_omp_profile_roots(&mut roots, &app_root.join("profiles"), true);

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +217 to +228
const reportedAgentDir = options.deps.runOmpCommand(omp.path, ["config", "path"], 10_000);
if (!reportedAgentDir.ok)
add(results, "warn", "Could not verify OMP active agent directory");
else if (reportedAgentDir.stdout === getOmpAgentDir()) {
add(results, "pass", `OMP agent directory resolved to ${getOmpAgentDir()}`);
} else {
add(
results,
"fail",
`OMP reports agent directory ${reportedAgentDir.stdout}, but Magic Context resolved ${getOmpAgentDir()}`,
);
}

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 9730e23. Doctor now resolves both the reported and expected agent directories before comparison, and the healthy-install regression test returns an equivalent path with a trailing /./ segment.

Comment on lines +147 to +149
if let Some(agent_dir) = std::env::var_os("PI_CODING_AGENT_DIR").filter(|v| !v.is_empty()) {
roots.push(PathBuf::from(agent_dir).join("sessions"));
}

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in c683ddb. PI_CODING_AGENT_DIR, PI_CONFIG_DIR, and XDG_DATA_HOME now share one trimming helper; blank values are ignored. Added direct regression coverage, and the production session module passes 11 isolated Rust tests.

Lynricsy and others added 2 commits August 5, 2026 22:19
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 3 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/cli/src/commands/doctor-omp.ts">

<violation number="1" location="packages/cli/src/commands/doctor-omp.ts:221">
P2: A successful `omp config path` with empty output can make this check pass incorrectly because `resolve("")` becomes the current working directory; preserve an empty result as invalid before normalizing it so the doctor cannot report a healthy agent-directory configuration without a path.</violation>
</file>

Tip: Review your code locally with the cubic CLI to iterate faster.

Re-trigger cubic

Comment thread packages/dashboard/src-tauri/src/pi_sessions.rs Outdated
if (!reportedAgentDir.ok) {
add(results, "warn", "Could not verify OMP active agent directory");
} else {
const reportedPath = resolve(reportedAgentDir.stdout);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: A successful omp config path with empty output can make this check pass incorrectly because resolve("") becomes the current working directory; preserve an empty result as invalid before normalizing it so the doctor cannot report a healthy agent-directory configuration without a path.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/cli/src/commands/doctor-omp.ts, line 221:

<comment>A successful `omp config path` with empty output can make this check pass incorrectly because `resolve("")` becomes the current working directory; preserve an empty result as invalid before normalizing it so the doctor cannot report a healthy agent-directory configuration without a path.</comment>

<file context>
@@ -215,16 +215,20 @@ async function runHealthChecks(options: {
-                "fail",
-                `OMP reports agent directory ${reportedAgentDir.stdout}, but Magic Context resolved ${getOmpAgentDir()}`,
-            );
+            const reportedPath = resolve(reportedAgentDir.stdout);
+            const expectedPath = resolve(getOmpAgentDir());
+            if (reportedPath === expectedPath) {
</file context>
Suggested change
const reportedPath = resolve(reportedAgentDir.stdout);
const reportedPath = reportedAgentDir.stdout ? resolve(reportedAgentDir.stdout) : "";

@alfonso-magic-context

Copy link
Copy Markdown
Collaborator

Thanks for the rebase — we did the full review. The direction is right and several pieces are exactly how we'd want them (probing the distinct omp executable instead of treating Pi as OMP, the OMP-only adapter/setup/doctor shape). Not merge-ready yet though: the review found five required changes, and the two that matter most are plain-Pi regressions hiding in shared code:

  1. Pi child-extension resolution changes for plain Pi installs. getHostAgentSettingsDir() (subagent-runner.ts) re-roots relative allowlist entries whenever PI_CODING_AGENT_DIR is set — but that's a supported plain-Pi setting, so Pi users without OMP get different extension resolution after this PR. The OMP-specific resolution needs to sit behind a positively-identified OMP host (or be injected from the OMP adapter), with a negative regression test proving the pre-PR argv when OMP is absent.

  2. The dashboard Pi scanner becomes an unconditional all-OMP-profile scanner. pi_sessions.rs scans every ~/.omp/profiles root on every Pi scan without detecting OMP, so stale .omp data surfaces as Pi sessions and plain-Pi results change. OMP needs its own separately-named scanner, invoked only after explicit OMP detection, with OMP-absent tests.

The remaining three: complete the OMP path/config contract (PI_PACKAGE_DIR, PI_CONFIG_FILES overlays, and omp config set write-scope — a project-tier OMP file must not cause global settings changes), give OMP an explicit provider-translation contract at the harness-provider-map chokepoint (bidirectional, round-trip tested — right now OMP selectors ride Pi's openai-codex rewrite unproven), and at least one real-OMP CI smoke job (all current tests use fake binaries/fixtures; a harness leg we can't test in CI becomes a liability on every future Pi-parity change).

Happy to re-review as soon as these land — the containment shape you already have (own adapter, own commands) makes them all tractable.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found across 43 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/cli/src/commands/doctor-omp.ts">

<violation number="1" location="packages/cli/src/commands/doctor-omp.ts:92">
P3: The new OMP doctor reimplements the same semver triple-parse/compare that `comparePiVersion` in `commands/setup-pi.ts` already provides for the same Pi-compatible flow. The two functions parse `X.Y.Z` with the identical regex and compare component-by-component, so a future change to how Pi/OMP versions are treated must be made in two places and can drift. Consider extracting a shared semver helper (e.g. in `lib`) and having both the Pi setup and the OMP doctor use it, matching the existing repo convention of shared CLI helpers.</violation>

<violation number="2" location="packages/cli/src/commands/doctor-omp.ts:221">
P2: The OMP path check compares `omp config path` with the agent directory instead of the OMP config path, which can make every healthy installation fail its doctor check. Compare against `getOmpConfigPath()` (and label the result as a config path) or invoke the command that actually reports the agent directory.</violation>
</file>

Tip: cubic can generate docs of your entire codebase and keep them up to date. Try it here.

Re-trigger cubic

Comment thread packages/cli/src/commands/doctor-omp.ts
Comment thread packages/cli/src/commands/setup-pi.ts Outdated
Comment thread packages/cli/src/lib/omp-helpers.ts Outdated
Comment thread packages/cli/src/commands/doctor-omp.ts Outdated
if (!reportedAgentDir.ok) {
add(results, "warn", "Could not verify OMP active agent directory");
} else {
const reportedPath = resolve(reportedAgentDir.stdout);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: The OMP path check compares omp config path with the agent directory instead of the OMP config path, which can make every healthy installation fail its doctor check. Compare against getOmpConfigPath() (and label the result as a config path) or invoke the command that actually reports the agent directory.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/cli/src/commands/doctor-omp.ts, line 221:

<comment>The OMP path check compares `omp config path` with the agent directory instead of the OMP config path, which can make every healthy installation fail its doctor check. Compare against `getOmpConfigPath()` (and label the result as a config path) or invoke the command that actually reports the agent directory.</comment>

<file context>
@@ -0,0 +1,425 @@
+        if (!reportedAgentDir.ok) {
+            add(results, "warn", "Could not verify OMP active agent directory");
+        } else {
+            const reportedPath = resolve(reportedAgentDir.stdout);
+            const expectedPath = resolve(getOmpAgentDir());
+            if (reportedPath === expectedPath) {
</file context>

Comment thread packages/dashboard/src-tauri/src/pi_sessions.rs Outdated
Comment thread packages/dashboard/src-tauri/src/pi_sessions.rs Outdated
Comment thread packages/cli/src/commands/setup-omp.test.ts
Comment thread packages/cli/src/commands/setup-pi.ts Outdated
return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;
}

function isOlderThan(value: string | null, minimum: string): boolean {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: The new OMP doctor reimplements the same semver triple-parse/compare that comparePiVersion in commands/setup-pi.ts already provides for the same Pi-compatible flow. The two functions parse X.Y.Z with the identical regex and compare component-by-component, so a future change to how Pi/OMP versions are treated must be made in two places and can drift. Consider extracting a shared semver helper (e.g. in lib) and having both the Pi setup and the OMP doctor use it, matching the existing repo convention of shared CLI helpers.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/cli/src/commands/doctor-omp.ts, line 92:

<comment>The new OMP doctor reimplements the same semver triple-parse/compare that `comparePiVersion` in `commands/setup-pi.ts` already provides for the same Pi-compatible flow. The two functions parse `X.Y.Z` with the identical regex and compare component-by-component, so a future change to how Pi/OMP versions are treated must be made in two places and can drift. Consider extracting a shared semver helper (e.g. in `lib`) and having both the Pi setup and the OMP doctor use it, matching the existing repo convention of shared CLI helpers.</comment>

<file context>
@@ -0,0 +1,425 @@
+    return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;
+}
+
+function isOlderThan(value: string | null, minimum: string): boolean {
+    const left = parseSemver(value);
+    const right = parseSemver(minimum);
</file context>

@ualtinok

ualtinok commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Hey @Lynricsy, please address cubic findings also. Thanks!

Lynricsy and others added 3 commits August 6, 2026 19:40
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
Co-authored-by: Wine Fox <fox@ling.plus>
@Lynricsy

Lynricsy commented Aug 6, 2026

Copy link
Copy Markdown
Author

@waltino Thanks for the detailed containment review. I addressed all five merge blockers and pushed three atomic commits:

  • c83e6d70 fix(omp): 🐛 isolate host config boundaries

    • plain Pi keeps the pre-OMP ~/.pi/agent relative-extension behavior even when PI_CODING_AGENT_DIR is set
    • OMP agent paths are consumed only after positive host identification (@oh-my-pi/pi-coding-agent package/binary); default OMP correctly falls back to ~/.omp/agent
    • PI_PACKAGE_DIR, PI_CONFIG_FILES, and project .omp/config.yml are now explicit contracts; setup/doctor refuse global omp config set writes while a higher-precedence project/overlay layer is active
    • OMP now has explicit bidirectional provider transforms (ompModelRefToCanonical / resolveModelRefForOmp) at setup and runtime boundaries, with scoped/nested selector round-trip tests
    • also closes the valid Cubic findings around failed-write rollback, absent packages restoration, invalid config arrays, refused legacy migration, Windows npm/Bun detection, and OMP doctor repair safety
  • a00685dc fix(dashboard): 🐛 gate and merge OMP discovery

    • OMP profile/XDG roots are added only after explicit OMP detection
    • detector covers GUI PATH gaps (/usr/local, Homebrew, mise/asdf/volta, Windows npm/Bun)
    • plain Pi roots remain unchanged; default OMP roots remain visible with named profiles
    • XDG scanning now matches OMP's Unix/default-agent guard
    • Pi and OMP model catalogs are merged/deduplicated instead of OMP-only selectors disappearing when Pi is installed
    • non-UTF-8 environment paths retain native bytes
  • cad987e8 test(omp): 🧪 add real runtime smoke

    • CI installs current @oh-my-pi/pi-coding-agent@latest in Docker, uses the native plugin manager, runs OMP doctor repair, and executes a real one-turn mock-provider session
    • smoke explicitly asserts process exit 0, terminal agent_end, plugin log, shared DB, and harness='pi' persistence

Verification completed:

  • real OMP 17.2.9 Docker smoke: 12 pass / 0 fail
  • repository tests: plugin 3313, Pi/OMP extension 717, CLI 309 passed + 2 skipped, all 0 failed
  • dashboard Rust: 260 passed / 0 failed
  • TypeScript typecheck and all plugin/Pi/CLI builds passed
  • CLI lint and changed provider-map Biome checks passed
  • docs: all 22 pages built
  • npm pack dry-run passed
  • git diff --check passed

Two unrelated current-master gates remain visible but were not changed/suppressed here: Dashboard ConfigEditor schema parity has four pre-existing unclassified fields (36 pass / 2 fail), and root/Pi lint reports pre-existing unused-symbol diagnostics outside these touched paths. Rust 1.77 source checking is additionally blocked before project compilation by the current lockfile's serde_spanned 1.1.1 edition-2024 manifest; the new code itself avoids post-1.77 APIs and passes the current full Cargo suite.

The branch is pushed at cad987e8 and ready for re-review.

Co-authored-by: Wine Fox <fox@ling.plus>
@Lynricsy

Lynricsy commented Aug 6, 2026

Copy link
Copy Markdown
Author

Follow-up documentation consistency fix pushed as d231001b docs(pi): 📝 clarify host-scoped extension paths. packages/pi-plugin/README.md now matches the tested implementation: plain Pi resolves relative pi.subagent_extensions from ~/.pi/agent; only a positively identified OMP host consumes PI_CODING_AGENT_DIR, with the OMP config/profile agent directory as its fallback.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

9 issues found across 20 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/cli/src/lib/omp-helpers.ts">

<violation number="1" location="packages/cli/src/lib/omp-helpers.ts:37">
P1: On Windows, package-only OMP discovery produces a detected binary that every `omp` command fails to execute. The returned `.js` path bypasses the existing Windows shim handling; resolving the generated `.cmd` shim or invoking the package through its Bun runtime would keep this detection usable.</violation>
</file>

<file name="packages/cli/src/commands/setup-pi.ts">

<violation number="1" location="packages/cli/src/commands/setup-pi.ts:104">
P2: A parseable Pi settings file with a non-array `packages` value is not restored when setup rolls back: `packagesFieldExisted` records only presence, so rollback preserves the field after setup has replaced its value with `[]`. Capturing/restoring the original value, or rejecting non-array `packages` before registration, would keep transactional setup from discarding user configuration.</violation>
</file>

<file name="packages/plugin/src/shared/harness-provider-map.ts">

<violation number="1" location="packages/plugin/src/shared/harness-provider-map.ts:79">
P2: OMP model references such as `constructor/model` or `toString/model` are rewritten into invalid provider strings rather than passed through unchanged. Use an own-property check when reading the mapping so arbitrary OMP providers remain identities.</violation>
</file>

<file name="packages/dashboard/src-tauri/src/pi_sessions.rs">

<violation number="1" location="packages/dashboard/src-tauri/src/pi_sessions.rs:179">
P2: Plain Pi can show unrelated OMP/profile sessions whenever `OMP_PROFILE` is present without an OMP executable or package. Host detection should require the same positive package/binary evidence used by the Pi runtime instead of treating the profile variable alone as proof of OMP.</violation>

<violation number="2" location="packages/dashboard/src-tauri/src/pi_sessions.rs:193">
P2: A non-executable file named `omp` can falsely classify OMP as installed and make plain Pi users see unrelated OMP roots. The PATH and fallback checks should use an executable-file test, including POSIX execute permission, rather than `is_file()` alone.</violation>

<violation number="3" location="packages/dashboard/src-tauri/src/pi_sessions.rs:235">
P1: Sessions for an active OMP profile disappear from the dashboard when OMP sets `PI_CODING_AGENT_DIR` to the profile agent directory, because this comparison rejects the profile-specific path and skips all XDG roots. The guard should compare against the effective profile agent directory or allow an active valid profile to use its initialized XDG root.</violation>
</file>

<file name="tests/docker/Dockerfile.omp">

<violation number="1" location="tests/docker/Dockerfile.omp:69">
P3: The new OMP E2E image isn't wired into the local runner: `tests/docker/run-e2e.sh` only accepts `opencode|pi|all`, so `run-e2e.sh omp` fails with "Unknown target" and `all` never runs it. Add an `omp` arm to `run_target` so developers can reproduce the CI e2e-omp job locally, matching the existing pi/opencode targets.</violation>
</file>

<file name="tests/docker/test-omp-e2e.sh">

<violation number="1" location="tests/docker/test-omp-e2e.sh:31">
P3: The section titled "Real OMP installation..." claims to verify a minimum version, but the only OMP version check is `test -n "$OMP_VERSION"` (non-empty). Since doctor-omp/setup-omp enforce a 17.1.7 floor, assert it here too (compare against 17.1.7) so an unexpectedly old floating OMP doesn't silently pass.</violation>

<violation number="2" location="tests/docker/test-omp-e2e.sh:103">
P3: The `agent_end` check is a literal whitespace-sensitive grep on JSON output. If OMP emits `"type": "agent_end"` (space) or a different terminal event name, the test spuriously FAILs despite a successful turn; make it whitespace-tolerant (`grep -qE '"type"\s*:\s*"agent_end"'`) or rely on the exit-code/output checks already present.</violation>
</file>

Tip: Review your code locally with the cubic CLI to iterate faster.

Re-trigger cubic

};
if (manifest.name !== "@oh-my-pi/pi-coding-agent") return null;
const cli = join(packageDir, "dist", "cli.js");
return existsSync(cli) ? cli : null;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: On Windows, package-only OMP discovery produces a detected binary that every omp command fails to execute. The returned .js path bypasses the existing Windows shim handling; resolving the generated .cmd shim or invoking the package through its Bun runtime would keep this detection usable.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/cli/src/lib/omp-helpers.ts, line 37:

<comment>On Windows, package-only OMP discovery produces a detected binary that every `omp` command fails to execute. The returned `.js` path bypasses the existing Windows shim handling; resolving the generated `.cmd` shim or invoking the package through its Bun runtime would keep this detection usable.</comment>

<file context>
@@ -24,15 +25,46 @@ export interface OmpPluginInfo {
+        };
+        if (manifest.name !== "@oh-my-pi/pi-coding-agent") return null;
+        const cli = join(packageDir, "dist", "cli.js");
+        return existsSync(cli) ? cli : null;
+    } catch {
+        return null;
</file context>

let can_use_xdg = (cfg!(target_os = "linux") || cfg!(target_os = "macos"))
&& configured_agent
.as_ref()
.map_or(true, |agent| agent == &default_agent);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: Sessions for an active OMP profile disappear from the dashboard when OMP sets PI_CODING_AGENT_DIR to the profile agent directory, because this comparison rejects the profile-specific path and skips all XDG roots. The guard should compare against the effective profile agent directory or allow an active valid profile to use its initialized XDG root.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/dashboard/src-tauri/src/pi_sessions.rs, line 235:

<comment>Sessions for an active OMP profile disappear from the dashboard when OMP sets `PI_CODING_AGENT_DIR` to the profile agent directory, because this comparison rejects the profile-specific path and skips all XDG roots. The guard should compare against the effective profile agent directory or allow an active valid profile to use its initialized XDG root.</comment>

<file context>
@@ -137,45 +141,109 @@ fn append_omp_profile_roots(roots: &mut Vec<PathBuf>, profiles_dir: &Path, xdg:
+        let can_use_xdg = (cfg!(target_os = "linux") || cfg!(target_os = "macos"))
+            && configured_agent
+                .as_ref()
+                .map_or(true, |agent| agent == &default_agent);
+        if can_use_xdg {
+            if let Some(xdg_data) = trimmed_env_path(std::env::var_os("XDG_DATA_HOME")) {
</file context>
Suggested change
.map_or(true, |agent| agent == &default_agent);
.map_or(true, |agent| active_omp_profile().is_some() || agent == &default_agent);

`Run \`pi update --self\` (or \`npm install -g @earendil-works/pi-coding-agent@latest\`) before continuing.`,
ensurePluginEntry: async (settingsPath) => {
const settings = readJsoncConfigForUpdate(settingsPath);
const packagesFieldExisted = Object.hasOwn(settings, "packages");

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: A parseable Pi settings file with a non-array packages value is not restored when setup rolls back: packagesFieldExisted records only presence, so rollback preserves the field after setup has replaced its value with []. Capturing/restoring the original value, or rejecting non-array packages before registration, would keep transactional setup from discarding user configuration.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/cli/src/commands/setup-pi.ts, line 104:

<comment>A parseable Pi settings file with a non-array `packages` value is not restored when setup rolls back: `packagesFieldExisted` records only presence, so rollback preserves the field after setup has replaced its value with `[]`. Capturing/restoring the original value, or rejecting non-array `packages` before registration, would keep transactional setup from discarding user configuration.</comment>

<file context>
@@ -97,6 +100,8 @@ const DEFAULT_HOST: PiCompatibleSetupHost = {
         `Run \`pi update --self\` (or \`npm install -g @earendil-works/pi-coding-agent@latest\`) before continuing.`,
     ensurePluginEntry: async (settingsPath) => {
+        const settings = readJsoncConfigForUpdate(settingsPath);
+        const packagesFieldExisted = Object.hasOwn(settings, "packages");
         const added = writePiSettingsPackage(settingsPath);
         return {
</file context>


/** OMP-native selector -> canonical shared-config model reference. */
export function ompModelRefToCanonical(ref: string): string {
return remapProviderPrefix(ref, OMP_TO_CANONICAL_PROVIDER);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: OMP model references such as constructor/model or toString/model are rewritten into invalid provider strings rather than passed through unchanged. Use an own-property check when reading the mapping so arbitrary OMP providers remain identities.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/plugin/src/shared/harness-provider-map.ts, line 79:

<comment>OMP model references such as `constructor/model` or `toString/model` are rewritten into invalid provider strings rather than passed through unchanged. Use an own-property check when reading the mapping so arbitrary OMP providers remain identities.</comment>

<file context>
@@ -64,3 +73,13 @@ export function piModelRefToCanonical(ref: string): string {
+
+/** OMP-native selector -> canonical shared-config model reference. */
+export function ompModelRefToCanonical(ref: string): string {
+    return remapProviderPrefix(ref, OMP_TO_CANONICAL_PROVIDER);
+}
+
</file context>

&["omp"]
};
if std::env::split_paths(&std::env::var_os("PATH").unwrap_or_default())
.any(|dir| binary_names.iter().any(|name| dir.join(name).is_file()))

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: A non-executable file named omp can falsely classify OMP as installed and make plain Pi users see unrelated OMP roots. The PATH and fallback checks should use an executable-file test, including POSIX execute permission, rather than is_file() alone.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/dashboard/src-tauri/src/pi_sessions.rs, line 193:

<comment>A non-executable file named `omp` can falsely classify OMP as installed and make plain Pi users see unrelated OMP roots. The PATH and fallback checks should use an executable-file test, including POSIX execute permission, rather than `is_file()` alone.</comment>

<file context>
@@ -137,45 +141,109 @@ fn append_omp_profile_roots(roots: &mut Vec<PathBuf>, profiles_dir: &Path, xdg:
+        &["omp"]
     };
+    if std::env::split_paths(&std::env::var_os("PATH").unwrap_or_default())
+        .any(|dir| binary_names.iter().any(|name| dir.join(name).is_file()))
+    {
+        return true;
</file context>

}

fn omp_installation_detected(home: &Path) -> bool {
if std::env::var_os("OMP_PROFILE").is_some() {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Plain Pi can show unrelated OMP/profile sessions whenever OMP_PROFILE is present without an OMP executable or package. Host detection should require the same positive package/binary evidence used by the Pi runtime instead of treating the profile variable alone as proof of OMP.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/dashboard/src-tauri/src/pi_sessions.rs, line 179:

<comment>Plain Pi can show unrelated OMP/profile sessions whenever `OMP_PROFILE` is present without an OMP executable or package. Host detection should require the same positive package/binary evidence used by the Pi runtime instead of treating the profile variable alone as proof of OMP.</comment>

<file context>
@@ -137,45 +141,109 @@ fn append_omp_profile_roots(roots: &mut Vec<PathBuf>, profiles_dir: &Path, xdg:
-    let Some(home) = dirs::home_dir() else {
-        return Vec::new();
+fn omp_installation_detected(home: &Path) -> bool {
+    if std::env::var_os("OMP_PROFILE").is_some() {
+        return true;
+    }
</file context>

RUN chmod +x /test/test-omp-e2e.sh

WORKDIR /test/project
ENTRYPOINT ["/test/test-omp-e2e.sh"]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: The new OMP E2E image isn't wired into the local runner: tests/docker/run-e2e.sh only accepts opencode|pi|all, so run-e2e.sh omp fails with "Unknown target" and all never runs it. Add an omp arm to run_target so developers can reproduce the CI e2e-omp job locally, matching the existing pi/opencode targets.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At tests/docker/Dockerfile.omp, line 69:

<comment>The new OMP E2E image isn't wired into the local runner: `tests/docker/run-e2e.sh` only accepts `opencode|pi|all`, so `run-e2e.sh omp` fails with "Unknown target" and `all` never runs it. Add an `omp` arm to `run_target` so developers can reproduce the CI e2e-omp job locally, matching the existing pi/opencode targets.</comment>

<file context>
@@ -0,0 +1,69 @@
+RUN chmod +x /test/test-omp-e2e.sh
+
+WORKDIR /test/project
+ENTRYPOINT ["/test/test-omp-e2e.sh"]
</file context>

PLUGIN_LIST=$(omp plugin list --json 2>&1)
echo "OMP version: ${OMP_VERSION:-unknown}"
echo "$PLUGIN_LIST"
check "omp --version returns a value" "test -n \"$OMP_VERSION\""

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: The section titled "Real OMP installation..." claims to verify a minimum version, but the only OMP version check is test -n "$OMP_VERSION" (non-empty). Since doctor-omp/setup-omp enforce a 17.1.7 floor, assert it here too (compare against 17.1.7) so an unexpectedly old floating OMP doesn't silently pass.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At tests/docker/test-omp-e2e.sh, line 31:

<comment>The section titled "Real OMP installation..." claims to verify a minimum version, but the only OMP version check is `test -n "$OMP_VERSION"` (non-empty). Since doctor-omp/setup-omp enforce a 17.1.7 floor, assert it here too (compare against 17.1.7) so an unexpectedly old floating OMP doesn't silently pass.</comment>

<file context>
@@ -0,0 +1,119 @@
+PLUGIN_LIST=$(omp plugin list --json 2>&1)
+echo "OMP version: ${OMP_VERSION:-unknown}"
+echo "$PLUGIN_LIST"
+check "omp --version returns a value" "test -n \"$OMP_VERSION\""
+check "OMP lists the linked Magic Context package" \
+    "echo \"\$PLUGIN_LIST\" | grep -q '@cortexkit/pi-magic-context'"
</file context>

tail -20 /tmp/omp.log

check "OMP turn exits successfully" "test \"$OMP_EXIT\" -eq 0"
check "OMP emits a terminal agent_end protocol event" \

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: The agent_end check is a literal whitespace-sensitive grep on JSON output. If OMP emits "type": "agent_end" (space) or a different terminal event name, the test spuriously FAILs despite a successful turn; make it whitespace-tolerant (grep -qE '"type"\s*:\s*"agent_end"') or rely on the exit-code/output checks already present.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At tests/docker/test-omp-e2e.sh, line 103:

<comment>The `agent_end` check is a literal whitespace-sensitive grep on JSON output. If OMP emits `"type": "agent_end"` (space) or a different terminal event name, the test spuriously FAILs despite a successful turn; make it whitespace-tolerant (`grep -qE '"type"\s*:\s*"agent_end"'`) or rely on the exit-code/output checks already present.</comment>

<file context>
@@ -0,0 +1,119 @@
+tail -20 /tmp/omp.log
+
+check "OMP turn exits successfully" "test \"$OMP_EXIT\" -eq 0"
+check "OMP emits a terminal agent_end protocol event" \
+    "grep -q '\"type\":\"agent_end\"' /tmp/omp.log"
+
</file context>

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.

4 participants