test(omo-codex): batch 41 (4 files)

This commit is contained in:
YeonGyu-Kim
2026-05-30 19:12:07 +09:00
parent 51a2524a37
commit e26925a377
4 changed files with 722 additions and 0 deletions
@@ -0,0 +1,329 @@
import assert from "node:assert/strict";
import { readdir, readFile, stat } from "node:fs/promises";
import { basename, dirname, join } from "node:path";
import test from "node:test";
import { fileURLToPath } from "node:url";
const root = dirname(dirname(fileURLToPath(import.meta.url)));
async function readJson(relativePath) {
return JSON.parse(await readFile(join(root, relativePath), "utf8"));
}
async function readComponentHookManifests() {
const components = await readdir(join(root, "components"), { withFileTypes: true });
const manifests = [];
for (const entry of components) {
if (!entry.isDirectory()) continue;
const source = join("components", entry.name, "hooks", "hooks.json");
manifests.push({ source, hooks: await readJson(source) });
}
return manifests.sort((left, right) => left.source.localeCompare(right.source));
}
function collectCommandHooks(hooks, source) {
const config = hooks.hooks;
if (typeof config !== "object" || config === null || Array.isArray(config)) {
throw new TypeError(`Invalid hooks manifest: ${source}`);
}
const commandHooks = [];
for (const [eventName, groups] of Object.entries(config)) {
if (!Array.isArray(groups)) {
throw new TypeError(`Invalid hook groups in ${source}:${eventName}`);
}
groups.forEach((group, groupIndex) => {
if (typeof group !== "object" || group === null || !Array.isArray(group.hooks)) {
throw new TypeError(`Invalid hook group in ${source}:${eventName}:${groupIndex}`);
}
group.hooks.forEach((handler, handlerIndex) => {
if (typeof handler !== "object" || handler === null || handler.type !== "command") return;
commandHooks.push({ source, eventName, groupIndex, handlerIndex, handler });
});
});
}
return commandHooks;
}
function hookLocation({ source, eventName, groupIndex, handlerIndex, handler }) {
return `${source}:${eventName}:${groupIndex}:${handlerIndex}:${handler.command}`;
}
function findSpawnAgentTypes(content) {
const agentTypes = new Set();
const regex = /spawn_agent\(agent_type="([^"]+)"/g;
for (const match of content.matchAll(regex)) {
agentTypes.add(match[1]);
}
return [...agentTypes].sort();
}
test("#given aggregate plugin manifest #when inspected #then it owns the omo namespace", async () => {
// given
const manifest = await readJson(".codex-plugin/plugin.json");
// when
const hookPath = manifest.hooks;
const skillsPath = manifest.skills;
const mcpPath = manifest.mcpServers;
// then
assert.equal(manifest.name, "omo");
assert.equal(hookPath, "./hooks/hooks.json");
assert.equal(skillsPath, "./skills/");
assert.equal(mcpPath, "./.mcp.json");
});
test("#given aggregate plugin metadata #when inspected #then ulw-loop is the public loop name", async () => {
// given
const manifestText = await readFile(join(root, ".codex-plugin", "plugin.json"), "utf8");
const manifest = JSON.parse(manifestText);
// when
const longDescription = String(manifest.interface?.longDescription ?? "");
// then
assert.match(longDescription, /ulw-loop/);
});
test("#given isolated components #when hooks are inspected #then commands stay inside component roots", async () => {
// given
const hooks = await readJson("hooks/hooks.json");
const text = JSON.stringify(hooks);
// when
const componentMarkers = [
"components/comment-checker/dist/cli.js",
"components/lsp/dist/cli.js",
"components/rules/dist/cli.js",
"components/start-work-continuation/dist/cli.js",
"components/telemetry/dist/cli.js",
"components/ulw-loop/dist/cli.js",
"components/ultrawork/dist/cli.js",
];
// then
for (const marker of componentMarkers) {
assert.match(text, new RegExp(marker.replaceAll("/", "\\/")));
}
assert.doesNotMatch(text, /codex-(comment-checker|lsp|rules|telemetry|ulw-loop|ultrawork)@/);
});
test("#given aggregate hook commands #when inspected #then every command exposes a Codex status message", async () => {
// given
const hooks = await readJson("hooks/hooks.json");
// when
const commandHooks = collectCommandHooks(hooks, "hooks/hooks.json");
const missingStatusMessages = commandHooks
.filter(({ handler }) => typeof handler.statusMessage !== "string" || handler.statusMessage.trim() === "")
.map(hookLocation);
// then
assert.deepEqual(missingStatusMessages, []);
});
test("#given component hook commands #when inspected #then standalone packages expose Codex status messages", async () => {
// given
const componentHooks = await readComponentHookManifests();
// when
const missingStatusMessages = componentHooks
.flatMap(({ source, hooks }) => collectCommandHooks(hooks, source))
.filter(({ handler }) => typeof handler.statusMessage !== "string" || handler.statusMessage.trim() === "")
.map(hookLocation);
// then
assert.deepEqual(missingStatusMessages, []);
});
test("#given hook status messages #when inspected #then labels describe OMO responsibilities instead of the hook runner", async () => {
// given
const aggregateHooks = await readJson("hooks/hooks.json");
const componentHooks = await readComponentHookManifests();
// when
const commandHooks = [
...collectCommandHooks(aggregateHooks, "hooks/hooks.json"),
...componentHooks.flatMap(({ source, hooks }) => collectCommandHooks(hooks, source)),
];
const genericStatusMessages = commandHooks
.filter(({ handler }) => typeof handler.statusMessage !== "string" || /\bhook\b/i.test(handler.statusMessage))
.map(hookLocation);
// then
assert.deepEqual(genericStatusMessages, []);
});
test("#given aggregate OMO plugin is enabled #when hooks are inspected #then ulw-loop guards budgeted create_goal calls", async () => {
// given
const hooks = await readJson("hooks/hooks.json");
const text = JSON.stringify(hooks);
// when
const preToolUseGroups = hooks.hooks.PreToolUse;
// then
assert.match(text, /components\/ulw-loop\/dist\/cli\.js/);
assert.match(text, /hook pre-tool-use/);
assert.deepEqual(preToolUseGroups.map((group) => group.matcher), ["^create_goal$"]);
});
test("#given aggregate MCP config #when inspected #then code MCPs reference package runtimes without package names", async () => {
// given
const packageJson = await readJson("package.json");
const mcp = await readJson(".mcp.json");
const lspSources = await readdir(join(root, "components", "lsp", "src"));
// when
const lspServer = mcp.mcpServers.lsp;
const astGrepServer = mcp.mcpServers.ast_grep;
const codeMcpNames = Object.keys(mcp.mcpServers)
.filter((name) => name === "lsp" || name === "ast_grep")
.sort();
const componentLocalMcpSources = lspSources.filter((name) => name.startsWith("lazy-mcp") || name === "lazy-lsp-mcp.ts");
// then
assert.deepEqual(codeMcpNames, ["ast_grep", "lsp"]);
assert.equal(packageJson.workspaces.includes("components/lsp/packages/lsp-tools-mcp"), false);
assert.equal(packageJson.workspaces.includes("components/ast-grep/packages/ast-grep-mcp"), false);
assert.deepEqual(packageJson.dependencies, { "@oh-my-opencode/shared-skills": "file:../../shared-skills" });
assert.match(packageJson.scripts.build, /ast-grep-mcp/);
assert.doesNotMatch(packageJson.scripts.build, /--workspaces/);
assert.equal(lspServer.command, "node");
assert.deepEqual(lspServer.args, ["../../lsp-tools-mcp/dist/cli.js", "mcp"]);
assert.equal(lspServer.cwd, ".");
assert.equal(astGrepServer.command, "node");
assert.deepEqual(astGrepServer.args, ["../../ast-grep-mcp/dist/cli.js", "mcp"]);
assert.equal(astGrepServer.cwd, ".");
assert.deepEqual(componentLocalMcpSources, []);
});
test("#given package-level MCP CLIs #when package metadata is inspected #then bin names use the omo prefix", async () => {
// given
const lspPackageJson = await readJson("../../lsp-tools-mcp/package.json");
const astGrepPackageJson = await readJson("../../ast-grep-mcp/package.json");
// when
const binNames = [...Object.keys(lspPackageJson.bin ?? {}), ...Object.keys(astGrepPackageJson.bin ?? {})].sort();
// then
assert.deepEqual(binNames, ["omo-ast-grep", "omo-lsp"]);
for (const name of binNames) {
assert.match(name, /^omo-/);
}
});
test("#given aggregate plugin build script #when inspected #then telemetry sync runs before workspace builds", async () => {
// given
const packageJson = await readJson("package.json");
const telemetrySyncScript = await readFile(join(root, "..", "scripts", "sync-telemetry-component.mjs"), "utf8");
// when
const buildScript = packageJson.scripts.build;
// then
assert.equal(
buildScript,
"bun run --cwd ../../lsp-tools-mcp build && bun run --cwd ../../ast-grep-mcp build && node scripts/sync-skills.mjs && node ../scripts/sync-telemetry-component.mjs && node scripts/build-components.mjs",
);
assert.match(telemetrySyncScript, /syncTelemetryComponent/);
});
test("#given omo-codex package build script #when inspected #then delegates to the aggregate plugin package", async () => {
// given
const packageJson = JSON.parse(await readFile(join(root, "..", "package.json"), "utf8"));
// when
const buildPluginScript = packageJson.scripts["build:plugin"];
// then
assert.equal(buildPluginScript, "bun run --cwd plugin build");
});
test("#given component directories #when scanned #then only intentional resource roots declare plugin manifests", async () => {
// given
const components = await readdir(join(root, "components"), { withFileTypes: true });
const expectedComponentManifests = new Map([["rules", { hooks: "./hooks/hooks.json" }]]);
// when
const componentNames = components.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
// then
assert.deepEqual(componentNames, [
"comment-checker",
"lsp",
"rules",
"start-work-continuation",
"telemetry",
"ultrawork",
"ulw-loop",
]);
for (const name of componentNames) {
const expectedManifest = expectedComponentManifests.get(name);
if (expectedManifest !== undefined) {
assert.deepEqual(await readJson(join("components", name, ".codex-plugin", "plugin.json")), expectedManifest);
continue;
}
await assert.rejects(
readFile(join(root, "components", name, ".codex-plugin", "plugin.json"), "utf8"),
/code: 'ENOENT'|ENOENT/,
);
}
});
test("#given bundled Codex agents #when components/ultrawork/agents directory is scanned #then planner support TOMLs are present and match expected schema keys", async () => {
const agentsDir = join(root, "components", "ultrawork", "agents");
const entries = (await readdir(agentsDir, { withFileTypes: true }))
.filter((entry) => entry.isFile() && entry.name.endsWith(".toml"))
.map((entry) => entry.name)
.sort();
assert.deepEqual(entries, [
"codex-ultrawork-reviewer.toml",
"explorer.toml",
"librarian.toml",
"metis.toml",
"momus.toml",
"plan.toml",
]);
for (const fileName of entries) {
const content = await readFile(join(agentsDir, fileName), "utf8");
assert.match(content, /^name\s*=\s*".+"$/m);
assert.match(content, /^description\s*=\s*".+"$/m);
assert.match(content, /^nickname_candidates\s*=\s*\[.+\]$/m);
assert.match(content, /^model\s*=\s*".+"$/m);
assert.match(content, /^model_reasoning_effort\s*=\s*".+"$/m);
assert.match(content, /^developer_instructions\s*=\s*"""/m);
}
});
test("#given synced skills with Codex compatibility guidance #when a bundled agent_type is referenced #then a matching TOML is bundled", async () => {
const skillsDir = join(root, "skills");
const skillEntries = await readdir(skillsDir, { withFileTypes: true });
const skillFiles = skillEntries
.filter((entry) => entry.isDirectory())
.map((entry) => join(skillsDir, entry.name, "SKILL.md"));
const referencedAgentTypes = new Set();
for (const skillPath of skillFiles) {
const content = await readFile(skillPath, "utf8");
for (const agentType of findSpawnAgentTypes(content)) {
if (agentType === "worker" || agentType === "codex-ultrawork-reviewer") {
continue;
}
referencedAgentTypes.add(agentType);
}
}
const expected = [...referencedAgentTypes].sort();
assert.deepEqual(expected, ["explorer", "librarian", "metis", "momus", "plan"]);
for (const agentType of expected) {
const tomlPath = join(root, "components", "ultrawork", "agents", `${agentType}.toml`);
const fileStat = await stat(tomlPath);
assert.equal(fileStat.isFile(), true);
assert.equal(basename(tomlPath), `${agentType}.toml`);
}
});
@@ -0,0 +1,66 @@
import assert from "node:assert/strict";
import { readFile } from "node:fs/promises";
import { dirname, join } from "node:path";
import test from "node:test";
import { fileURLToPath } from "node:url";
const root = dirname(dirname(fileURLToPath(import.meta.url)));
const EXPECTED_COMPONENT_BINS = new Map([
["comment-checker", "omo-comment-checker"],
["lsp", "omo-lsp"],
["rules", "omo-rules"],
["start-work-continuation", "omo-start-work-continuation"],
["telemetry", "omo-telemetry"],
["ultrawork", "omo-ultrawork"],
["ulw-loop", "omo"],
]);
const EXPECTED_USAGE_PREFIXES = new Map([
["comment-checker", "Usage: omo-comment-checker "],
["lsp", "Usage: omo-lsp "],
["rules", "Usage: omo-rules "],
["start-work-continuation", "Usage: omo-start-work-continuation "],
["telemetry", "Usage: omo-telemetry "],
["ultrawork", "Usage: omo-ultrawork "],
]);
async function readJson(relativePath) {
return JSON.parse(await readFile(join(root, relativePath), "utf8"));
}
test("#given aggregate component package metadata #when bin names are inspected #then local component CLIs use the OMO prefix", async () => {
// given
const components = [...EXPECTED_COMPONENT_BINS.entries()];
// when
const mismatches = [];
for (const [component, expectedName] of components) {
const packageJson = await readJson(join("components", component, "package.json"));
const bin = packageJson.bin ?? {};
const binNames = Object.keys(bin).sort();
if (bin[expectedName] !== "./dist/cli.js" || binNames.some((name) => name.startsWith("codex-"))) {
mismatches.push({ component, expectedName, bin });
}
}
// then
assert.deepEqual(mismatches, []);
});
test("#given component CLI sources #when usage text is inspected #then user-facing command names use OMO names", async () => {
// given
const components = [...EXPECTED_USAGE_PREFIXES.entries()];
// when
const mismatches = [];
for (const [component, expectedUsage] of components) {
const source = await readFile(join(root, "components", component, "src", "cli.ts"), "utf8");
if (!source.includes(expectedUsage) || /Usage: codex-/.test(source)) {
mismatches.push({ component, expectedUsage });
}
}
// then
assert.deepEqual(mismatches, []);
});
@@ -0,0 +1,149 @@
import assert from "node:assert/strict";
import { readdir, readFile } from "node:fs/promises";
import { dirname, join } from "node:path";
import test from "node:test";
import { fileURLToPath } from "node:url";
import {
formatLazyCodexHookStatusMessage,
normalizeLazyCodexHookStatusLabel,
parseLazyCodexHookStatusMessage,
} from "../scripts/hook-status-message.mjs";
const root = dirname(dirname(fileURLToPath(import.meta.url)));
const AGGREGATE_EXPECTED_LABELS = new Map([
["hooks/hooks.json:SessionStart:0:0", "Loading Project Rules"],
["hooks/hooks.json:SessionStart:1:0", "Recording Session Telemetry"],
["hooks/hooks.json:UserPromptSubmit:0:0", "Loading Project Rules"],
["hooks/hooks.json:UserPromptSubmit:1:0", "Checking Ultrawork Trigger"],
["hooks/hooks.json:UserPromptSubmit:2:0", "Checking Ulw-Loop Steering"],
["hooks/hooks.json:PreToolUse:0:0", "Enforcing Unlimited Goal Budget"],
["hooks/hooks.json:PostToolUse:0:0", "Checking Comments"],
["hooks/hooks.json:PostToolUse:0:1", "Checking LSP Diagnostics"],
["hooks/hooks.json:PostToolUse:1:0", "Matching Project Rules"],
["hooks/hooks.json:PostCompact:0:0", "Resetting Project Rule Cache"],
["hooks/hooks.json:Stop:0:0", "Checking Start-Work Continuation"],
["hooks/hooks.json:SubagentStop:0:0", "Checking Start-Work Continuation"],
]);
const COMPONENT_EXPECTED_LABELS = new Map([
["components/comment-checker/hooks/hooks.json:PostToolUse:0:0", "Checking Comments"],
["components/lsp/hooks/hooks.json:PostToolUse:0:0", "Checking LSP Diagnostics"],
["components/rules/hooks/hooks.json:SessionStart:0:0", "Loading Project Rules"],
["components/rules/hooks/hooks.json:UserPromptSubmit:0:0", "Loading Project Rules"],
["components/rules/hooks/hooks.json:PostToolUse:0:0", "Matching Project Rules"],
["components/rules/hooks/hooks.json:PostCompact:0:0", "Resetting Project Rule Cache"],
["components/telemetry/hooks/hooks.json:SessionStart:0:0", "Recording Session Telemetry"],
["components/ultrawork/hooks/hooks.json:UserPromptSubmit:0:0", "Checking Ultrawork Trigger"],
["components/ulw-loop/hooks/hooks.json:UserPromptSubmit:0:0", "Checking Ulw-Loop Steering"],
["components/ulw-loop/hooks/hooks.json:PreToolUse:0:0", "Enforcing Unlimited Ulw-Loop Budget"],
["components/start-work-continuation/hooks/hooks.json:Stop:0:0", "Checking Start-Work Continuation"],
["components/start-work-continuation/hooks/hooks.json:SubagentStop:0:0", "Checking Start-Work Continuation"],
]);
async function readJson(relativePath) {
return JSON.parse(await readFile(join(root, relativePath), "utf8"));
}
async function readComponentHookManifests() {
const components = await readdir(join(root, "components"), { withFileTypes: true });
const manifests = [];
for (const entry of components) {
if (!entry.isDirectory()) continue;
const source = join("components", entry.name, "hooks", "hooks.json");
const packageJson = await readJson(join("components", entry.name, "package.json"));
manifests.push({ source, version: packageJson.version, hooks: await readJson(source) });
}
return manifests.sort((left, right) => left.source.localeCompare(right.source));
}
function collectCommandHooks(hooks, source, version) {
const commandHooks = [];
for (const [eventName, groups] of Object.entries(hooks.hooks)) {
groups.forEach((group, groupIndex) => {
group.hooks.forEach((handler, handlerIndex) => {
if (handler.type !== "command") return;
commandHooks.push({
id: `${source}:${eventName}:${groupIndex}:${handlerIndex}`,
version,
statusMessage: handler.statusMessage,
});
});
});
}
return commandHooks;
}
test("#given hook status label #when formatting #then prefixes LazyCodex with version", () => {
// given
const version = "0.1.0";
const label = "Checking Comments";
// when
const message = formatLazyCodexHookStatusMessage(version, label);
// then
assert.equal(message, "LazyCodex(0.1.0): Checking Comments");
});
test("#given loose legacy status label #when normalizing #then removes OMO wording and title-cases label", () => {
// given
const version = "0.1.0";
const label = " checking OMO comments ";
// when
const normalized = normalizeLazyCodexHookStatusLabel(label);
const message = formatLazyCodexHookStatusMessage(version, label);
// then
assert.equal(normalized, "Checking Comments");
assert.equal(message, "LazyCodex(0.1.0): Checking Comments");
});
test("#given aggregate comment-checker hook #when status is inspected #then it uses LazyCodex comments label", async () => {
// given
const aggregateVersion = (await readJson(".codex-plugin/plugin.json")).version;
const aggregateHooks = await readJson("hooks/hooks.json");
// when
const hooks = collectCommandHooks(aggregateHooks, "hooks/hooks.json", aggregateVersion);
const commentCheckerHook = hooks.find((hook) => hook.id === "hooks/hooks.json:PostToolUse:0:0");
// then
assert.equal(commentCheckerHook?.statusMessage, formatLazyCodexHookStatusMessage("0.1.0", "Checking Comments"));
assert.doesNotMatch(JSON.stringify(aggregateHooks), /checking\s+OMO\s+comments/i);
});
test("#given aggregate and component hooks #when status messages are inspected #then all use the LazyCodex formatter", async () => {
// given
const aggregateVersion = (await readJson(".codex-plugin/plugin.json")).version;
const aggregateHooks = await readJson("hooks/hooks.json");
const componentManifests = await readComponentHookManifests();
// when
const commandHooks = [
...collectCommandHooks(aggregateHooks, "hooks/hooks.json", aggregateVersion),
...componentManifests.flatMap((manifest) => collectCommandHooks(manifest.hooks, manifest.source, manifest.version)),
];
const expectedLabels = new Map([...AGGREGATE_EXPECTED_LABELS, ...COMPONENT_EXPECTED_LABELS]);
const mismatches = commandHooks
.map((hook) => {
const label = expectedLabels.get(hook.id);
const expected = label === undefined ? undefined : formatLazyCodexHookStatusMessage(hook.version, label);
const parsed = parseLazyCodexHookStatusMessage(hook.statusMessage);
return { ...hook, expected, parsed };
})
.filter((hook) => hook.expected === undefined || hook.statusMessage !== hook.expected || hook.parsed === null)
.map((hook) => `${hook.id}: expected ${hook.expected ?? "<missing expectation>"} but got ${hook.statusMessage}`);
// then
assert.deepEqual(mismatches, []);
assert.deepEqual(
commandHooks.map((hook) => hook.id).sort(),
[...expectedLabels.keys()].sort(),
);
for (const hook of commandHooks) {
assert.doesNotMatch(hook.statusMessage, /\bOMO\b/i);
}
});
@@ -0,0 +1,178 @@
import assert from "node:assert/strict";
import { readdir, readFile } from "node:fs/promises";
import { dirname, join } from "node:path";
import test from "node:test";
import { fileURLToPath } from "node:url";
import { sharedSkillsRootPath } from "@oh-my-opencode/shared-skills";
const root = dirname(dirname(fileURLToPath(import.meta.url)));
const repoRoot = join(root, "..", "..", "..");
const expectedSkills = [
"comment-checker",
"debugging",
"frontend-ui-ux",
"init-deep",
"lsp",
"programming",
"refactor",
"remove-ai-slops",
"review-work",
"rules",
"start-work",
"ulw-loop",
"ulw-plan",
];
const componentSkillSources = [
["comment-checker", "components/comment-checker/skills/comment-checker"],
["lsp", "components/lsp/skills/lsp"],
["rules", "components/rules/skills/rules"],
["ulw-loop", "components/ulw-loop/skills/ulw-loop"],
];
const codexCompatibilityEndMarkers = [
"When translating `load_skills=[...]`, include the requested skill names in the spawned agent's `message`. If a code block below conflicts with this section, this section wins.\n\n",
"When translating `load_skills=[...]`, name the skills inside the spawned agent's `message`. If a code block below conflicts with this section, this section wins.\n\n",
];
function removeCodexCompatibilityGuidance(content) {
const start = content.indexOf("## Codex Harness Tool Compatibility\n\n");
if (start === -1) return content;
const endMarker = codexCompatibilityEndMarkers.find((marker) => content.indexOf(marker, start) !== -1);
assert.notEqual(endMarker, undefined, "Codex compatibility guidance block is missing its terminator");
const end = content.indexOf(endMarker, start);
assert.notEqual(end, -1, "Codex compatibility guidance block is missing its terminator");
return `${content.slice(0, start)}${content.slice(end + endMarker.length)}`;
}
test("#given synced aggregate Codex skills #when inspected #then component and shared skills are present", async () => {
// given
const skillsRoot = join(root, "skills");
// when
const skillNames = (await readdir(skillsRoot, { withFileTypes: true }))
.filter((entry) => entry.isDirectory())
.map((entry) => entry.name)
.sort();
// then
assert.deepEqual(skillNames, expectedSkills);
for (const skillName of expectedSkills) {
const content = await readFile(join(skillsRoot, skillName, "SKILL.md"), "utf8");
assert.match(content, /^---\n/);
}
});
test("#given aggregate Codex skills #when source wiring is inspected #then shared skills are imported from the shared-skills package", async () => {
// given
const pluginPackageJson = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
const sharedPackageJson = JSON.parse(await readFile(join(root, "..", "..", "shared-skills", "package.json"), "utf8"));
const rootPackageJson = JSON.parse(await readFile(join(repoRoot, "package.json"), "utf8"));
const syncScript = await readFile(join(root, "scripts", "sync-skills.mjs"), "utf8");
// when
const sharedSkillDependency = pluginPackageJson.dependencies?.["@oh-my-opencode/shared-skills"];
const rootPackageFiles = rootPackageJson.files ?? [];
// then
assert.equal(sharedPackageJson.exports?.["."], "./index.mjs");
assert.equal(sharedPackageJson.files?.includes("skills"), true);
assert.equal(rootPackageFiles.includes("packages/shared-skills/package.json"), true);
assert.equal(rootPackageFiles.includes("packages/shared-skills/index.mjs"), true);
assert.equal(rootPackageFiles.includes("packages/shared-skills/skills"), true);
assert.equal(sharedSkillDependency, "file:../../shared-skills");
assert.match(syncScript, /from "@oh-my-opencode\/shared-skills"/);
assert.doesNotMatch(syncScript, /shared-skills",\s*"skills"/);
});
test("#given shared skill package source #when aggregate Codex shared skills are inspected #then generated copies have no hand-authored drift", async () => {
// given
const sharedSkillsRoot = sharedSkillsRootPath();
const aggregateSkillsRoot = join(root, "skills");
const sharedSkillNames = (await readdir(sharedSkillsRoot, { withFileTypes: true }))
.filter((entry) => entry.isDirectory())
.map((entry) => entry.name)
.sort();
// when / then
for (const skillName of sharedSkillNames) {
const sharedContent = await readFile(join(sharedSkillsRoot, skillName, "SKILL.md"), "utf8");
const aggregateContent = await readFile(join(aggregateSkillsRoot, skillName, "SKILL.md"), "utf8");
assert.equal(
removeCodexCompatibilityGuidance(aggregateContent),
removeCodexCompatibilityGuidance(sharedContent),
`${skillName} drifted from shared-skills`,
);
}
});
test("#given component skill sources #when aggregate Codex component skills are inspected #then generated copies have no hand-authored drift", async () => {
// given
const aggregateSkillsRoot = join(root, "skills");
// when / then
for (const [skillName, sourcePath] of componentSkillSources) {
const sourceContent = await readFile(join(root, sourcePath, "SKILL.md"), "utf8");
const aggregateContent = await readFile(join(aggregateSkillsRoot, skillName, "SKILL.md"), "utf8");
assert.equal(
removeCodexCompatibilityGuidance(aggregateContent),
removeCodexCompatibilityGuidance(sourceContent),
`${skillName} drifted from its component skill source`,
);
}
});
test("#given synced ulw-loop skill #when Codex hint metadata is inspected #then ulw-loop surfaces the ulw-loop alias", async () => {
// given
const skillRoot = join(root, "skills", "ulw-loop");
// when
const skill = await readFile(join(skillRoot, "SKILL.md"), "utf8");
const interfaceMetadata = await readFile(join(skillRoot, "agents", "openai.yaml"), "utf8");
// then
assert.match(skill, /^---\nname: ulw-loop\n/m);
assert.match(skill, /Goal-like loop that uses ultrawork mode to decompose work into systematic, evidence-bound steps\./);
assert.match(interfaceMetadata, /display_name: "ulw loop"/);
assert.doesNotMatch(interfaceMetadata, /ulw-loop \/ ulw-loop/);
assert.match(interfaceMetadata, /short_description: "Goal-like ultrawork loop for systematic decomposition"/);
assert.match(interfaceMetadata, /default_prompt: "Use \$ulw-loop/);
});
test("#given synced ulw-loop skill #when Codex hint metadata is inspected #then ulw-loop remains discoverable as an alias", async () => {
// given
const skillRoot = join(root, "skills", "ulw-loop");
// when
const interfaceMetadata = await readFile(join(skillRoot, "agents", "openai.yaml"), "utf8");
// then
assert.match(interfaceMetadata, /search_terms:/);
assert.match(interfaceMetadata, /- "ulw-loop"/);
});
test("#given synced aggregate Codex skills #when they contain OpenCode orchestration examples #then Codex tool compatibility guidance is injected", async () => {
// given
const skillsRoot = join(root, "skills");
const opencodeOnlyToolPattern = /\b(?:call_omo_agent|background_output|team_[a-z_]+|task)\s*\(/;
// when
const skillNames = (await readdir(skillsRoot, { withFileTypes: true }))
.filter((entry) => entry.isDirectory())
.map((entry) => entry.name)
.sort();
// then
for (const skillName of skillNames) {
const content = await readFile(join(skillsRoot, skillName, "SKILL.md"), "utf8");
if (!opencodeOnlyToolPattern.test(content)) continue;
const compatibilityIndex = content.indexOf("## Codex Harness Tool Compatibility");
assert.notEqual(compatibilityIndex, -1, `${skillName} is missing Codex compatibility guidance`);
assert.ok(
compatibilityIndex < content.search(opencodeOnlyToolPattern),
`${skillName} must explain Codex tool translation before OpenCode-only examples`,
);
}
});