The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
JavaScript aiai-agentsclaudeclaude-codeclicodexdeveloper-toolslazylazycodexoh-my-openagentomoopenaiorchestrationtypescript
import { expect, test } from "@playwright/test"
import { DOC_GROUPS, DOC_SECTIONS } from "../lib/docs-sections"
/**
* Docs `/docs` contract (TDD target state).
*
* The page must be fully server-rendered: every section id present, every
* heading prose in the DOM with JavaScript disabled, and an in-page nav
* whose entries jump to the matching anchors.
*/
const ULW_LOOP = DOC_SECTIONS.find((section) => section.id === "ulw-loop")
test.describe("docs page — structure", () => {
test("responds 200", async ({ request }) => {
const res = await request.get("/docs")
expect(res.status()).toBe(200)
})
test("has exactly one h1", async ({ page }) => {
await page.goto("/docs")
await expect(page.locator("h1")).toHaveCount(1)
})
test("renders every section as a visible element carrying its id + title", async ({ page }) => {
await page.goto("/docs")
for (const section of DOC_SECTIONS) {
const node = page.locator(`#${section.id}`)
await expect(node).toHaveCount(1)
await expect(node).toBeVisible()
await expect(node).toContainText(section.title)
}
})
test("nav lists every section title as links or buttons", async ({ page }) => {
await page.goto("/docs")
const nav = page.getByRole("navigation")
for (const section of DOC_SECTIONS) {
const entry = nav
.getByRole("link", { name: section.title })
.or(nav.getByRole("button", { name: section.title }))
await expect(entry.first()).toBeVisible()
}
})
test("documents lazycodex-ai as the npm install alias", async ({ page }) => {
await page.goto("/docs")
await expect(page.getByText("npx lazycodex-ai install", { exact: false }).first()).toBeVisible()
await expect(
page
.getByText("npx lazycodex-ai install --no-tui --codex-autonomous", { exact: false })
.first(),
).toBeVisible()
await expect(
page
.getByText("npx --yes --package oh-my-openagent omo install --platform=codex", {
exact: false,
})
.first(),
).toBeVisible()
})
test("documents skills and built-in workflow usage", async ({ page }) => {
await page.goto("/docs")
const body = page.locator("body")
await expect(body).toContainText("Skills are specialist playbooks")
await expect(body).toContainText("$init-deep")
await expect(body).toContainText("Feature coverage")
await expect(body).toContainText("review-work")
await expect(body).toContainText("remove-ai-slops")
await expect(body).toContainText("frontend")
await expect(body).toContainText("They auto-activate")
await expect(body).toContainText("Maximum-saturation research")
await expect(body).toContainText("LSP")
await expect(body).toContainText("AST-grep")
await expect(body).toContainText("comment-checker")
})
test("orders Skills immediately after Commands and before Concepts", () => {
const sectionIds = DOC_SECTIONS.map((section) => section.id)
expect(DOC_GROUPS.indexOf("Commands")).toBeLessThan(DOC_GROUPS.indexOf("Skills"))
expect(DOC_GROUPS.indexOf("Skills")).toBeLessThan(DOC_GROUPS.indexOf("Concepts"))
expect(sectionIds.indexOf("ulw-loop")).toBeLessThan(sectionIds.indexOf("skills"))
expect(sectionIds.indexOf("skills")).toBeLessThan(sectionIds.indexOf("ultrawork"))
})
})
test.describe("docs page — navigation", () => {
test("clicking the $ulw-loop nav entry jumps to that section", async ({ page }) => {
if (!ULW_LOOP) throw new Error("DOC_SECTIONS must include the ulw-loop section")
await page.goto("/docs")
const nav = page.getByRole("navigation")
const trigger = nav
.getByRole("link", { name: ULW_LOOP.title })
.or(nav.getByRole("button", { name: ULW_LOOP.title }))
.first()
await trigger.click()
await expect(page).toHaveURL(new RegExp(`#${ULW_LOOP.id}$`))
await expect(page.locator(`#${ULW_LOOP.id}`)).toBeInViewport()
})
})
test.describe("docs page — no-JS SSR", () => {
test("server-renders every section heading without JavaScript", async ({ browser }) => {
const context = await browser.newContext({ javaScriptEnabled: false })
const page = await context.newPage()
try {
await page.goto("/docs")
for (const section of DOC_SECTIONS) {
const node = page.locator(`#${section.id}`)
await expect(node).toHaveCount(1)
await expect(node).toBeVisible()
await expect(node).toContainText(section.title)
const prose = (await node.textContent()) ?? ""
expect(
prose.length,
`#${section.id} must server-render prose beyond its title`,
).toBeGreaterThan(section.title.length)
}
} finally {
await context.close()
}
})
})