Skip to content

code-yeongyu/oh-my-openagent / .agents/skills/codex-qa

codex-qa

Verified

QA the omo Codex Light edition (lazycodex / packages/omo-codex) itself, in strict isolation so ONLY our plugin is exercised, never the user's real ~/.codex. The first-party method drives the real `codex app-server` against an isolated CODEX_HOME plus a LOCAL mock model (no real API call), and proves a plugin hook fired by asserting hook/started + hook/completed notifications. Also: isolated install verification, per-component hook probes, a tmux TUI smoke, and runtime log observation (RUST_LOG / logs SQLite / /debug-config). Ships tested helper scripts each with a --self-test. Use whenever someone changes anything under packages/omo-codex or wants to QA, smoke-test, verify, or debug the Codex plugin, its hooks/components, the installer/config.toml, the app-server flow, or the Codex TUI. Triggers: codex qa, qa codex, codex-qa, test codex plugin, verify codex hook, codex app-server, lazycodex qa, isolated CODEX_HOME, prove codex hook fired, codex tui test.

FileKindSize
SKILL.mdskill md7.6 KB
references/app-server.mdmarkdown3.0 KB
references/components-hooks.mdmarkdown2.7 KB
references/docker-qa.mdmarkdown2.6 KB
references/install-verify.mdmarkdown2.6 KB
references/isolation.mdmarkdown2.5 KB
references/logging-debug.mdmarkdown2.6 KB
scripts/app-server-drive.shexecutablescript3.1 KB
scripts/hook-unit-probe.shexecutablescript3.0 KB
scripts/install-verify.shexecutablescript2.5 KB
scripts/lib/app-server-client.mjsscript6.3 KB
scripts/lib/app-server-client.test.jsscript1.9 KB
scripts/lib/common.shexecutablescript7.1 KB
scripts/lib/mock-model.mjsscript2.1 KB
scripts/lsp-e2e.shexecutablescript150.9 KB
scripts/tui-smoke.shexecutablescript2.9 KB

scripts/lib/app-server-client.test.js

View on GitHub
import { describe, expect, it } from "bun:test"
import { parseExpectedHooks, summarizeRun } from "./app-server-client.mjs"

describe("app-server-client summary", () => {
  it("#given a completed expected event also has a failed hook run #when summarized #then the QA run fails", () => {
    const summary = summarizeRun({
      turnStatus: "completed",
      assistantText: "ok",
      threadId: "thread",
      turnId: "turn",
      expectHook: ["sessionStart", "userPromptSubmit"],
      hooks: [
        { method: "hook/completed", eventName: "sessionStart", status: "completed", source: "plugin" },
        { method: "hook/completed", eventName: "userPromptSubmit", status: "completed", source: "plugin" },
        { method: "hook/completed", eventName: "userPromptSubmit", status: "failed", source: "plugin" },
      ],
      stderr: "",
    })

    expect(summary.ok).toBe(false)
    expect(summary.missingHooks).toEqual([])
    expect(summary.failedHooks).toEqual([
      { method: "hook/completed", eventName: "userPromptSubmit", status: "failed", source: "plugin" },
    ])
  })

  it("#given all expected hooks complete #when summarized #then the QA run passes", () => {
    const summary = summarizeRun({
      turnStatus: "completed",
      assistantText: "ok",
      threadId: "thread",
      turnId: "turn",
      expectHook: ["sessionStart", "userPromptSubmit"],
      hooks: [
        { method: "hook/completed", eventName: "sessionStart", status: "completed", source: "plugin" },
        { method: "hook/completed", eventName: "userPromptSubmit", status: "completed", source: "plugin" },
      ],
      stderr: "",
    })

    expect(summary.ok).toBe(true)
    expect(summary.failedHooks).toEqual([])
  })

  it("#given a comma-separated expectation #when parsed #then whitespace and empties are ignored", () => {
    expect(parseExpectedHooks(" sessionStart, ,userPromptSubmit ")).toEqual(["sessionStart", "userPromptSubmit"])
  })
})
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall