release: prepare 0.2.4

Author: Dmatut7

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## Unreleased
+## 0.2.4 — 2026-06-05
 
 - Added the `parallel-fix` Codex skill and example workflow for proposing independent fixes concurrently, then integrating and verifying serially.
 - Hardened replay/cache correctness: implicit cwd is now part of cache identity, nested phases inside parallel no longer alias, and failed topology branches keep completed child dependencies for downstream invalidation.

cli/doctor.ts

@@ -100,6 +100,33 @@ function checkBusinessAuditSkill(): Check {
   };
 }
 
+function checkParallelFixSkill(): Check {
+  const skillDir = path.join(codexHome(), "skills", "parallel-fix");
+  const skillPath = path.join(skillDir, "SKILL.md");
+  const required = [
+    skillPath,
+    path.join(skillDir, "references", "fix-method.md"),
+    path.join(skillDir, "references", "fix-template.workflow.ts"),
+    path.join(skillDir, "agents", "openai.yaml"),
+  ];
+  if (existsSync(skillPath)) {
+    const missing = required.filter((file) => !existsSync(file));
+    if (!missing.length) return { name: "parallel fix skill", status: "ok", detail: skillPath };
+    return {
+      name: "parallel fix skill",
+      status: "warn",
+      detail: `stale or incomplete: ${skillDir}`,
+      next: "Run `codex-flow install-codex`, then restart Codex.",
+    };
+  }
+  return {
+    name: "parallel fix skill",
+    status: "warn",
+    detail: `missing: ${skillPath}`,
+    next: "Run `codex-flow install-codex`, then restart Codex.",
+  };
+}
+
 async function checkFakeBackend(): Promise<Check> {
   let dir: string;
   try {
@@ -146,6 +173,7 @@ export async function doctor(argv: string[]): Promise<void> {
     checkNode(),
     checkSkill(),
     checkBusinessAuditSkill(),
+    checkParallelFixSkill(),
     checkCodexCli(),
     await checkFakeBackend(),
   ];

cli/install-codex.ts

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 const SKILLS = [
   { src: "../codex-skill", name: "dynamic-workflow" },
   { src: "../codex-skill-business-audit", name: "business-defect-audit" },
+  { src: "../codex-skill-parallel-fix", name: "parallel-fix" },
 ];
 
 function codexHome(): string {

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-flow",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Dynamic workflow orchestration for Codex — split complex tasks into parallel, resumable, journaled Codex sub-agents.",
   "type": "module",
   "license": "MIT",
@@ -55,6 +55,7 @@
     "adapters",
     "codex-skill",
     "codex-skill-business-audit",
+    "codex-skill-parallel-fix",
     "README.md",
     "examples",
     "docs",

package.json

@@ -86,6 +86,9 @@ describe("codex-flow cli", () => {
     assert.match(text, /name: dynamic-workflow/);
     assert.ok(existsSync(path.join(dir, "dynamic-workflow", "references", "engine-api.md")), "reference should be copied");
     assert.ok(existsSync(path.join(dir, "dynamic-workflow", "references", "setup.md")), "setup reference should be copied");
+    assert.ok(existsSync(path.join(dir, "business-defect-audit", "SKILL.md")), "business audit skill should be copied");
+    assert.ok(existsSync(path.join(dir, "parallel-fix", "SKILL.md")), "parallel fix skill should be copied");
+    assert.ok(existsSync(path.join(dir, "parallel-fix", "references", "fix-method.md")), "parallel fix reference should be copied");
     await rm(dir, { recursive: true, force: true });
   });
 
@@ -205,6 +208,35 @@ describe("codex-flow cli", () => {
     await rm(dir, { recursive: true, force: true });
   });
 
+  it("doctor warns when the bundled parallel fix skill is missing", async () => {
+    const dir = await mkdtemp(path.join(tmpdir(), "codex-flow-doctor-"));
+    const dynamicRefs = path.join(dir, "skills", "dynamic-workflow", "references");
+    const auditRefs = path.join(dir, "skills", "business-defect-audit", "references");
+    const auditAgents = path.join(dir, "skills", "business-defect-audit", "agents");
+    await mkdir(dynamicRefs, { recursive: true });
+    await mkdir(auditRefs, { recursive: true });
+    await mkdir(auditAgents, { recursive: true });
+    await writeFile(path.join(dir, "skills", "dynamic-workflow", "SKILL.md"), "---\nname: dynamic-workflow\n---\n", "utf8");
+    await writeFile(path.join(dynamicRefs, "engine-api.md"), "api\n", "utf8");
+    await writeFile(path.join(dynamicRefs, "setup.md"), "setup\n", "utf8");
+    await writeFile(path.join(dir, "skills", "business-defect-audit", "SKILL.md"), "---\nname: business-defect-audit\n---\n", "utf8");
+    await writeFile(path.join(auditRefs, "audit-method.md"), "method\n", "utf8");
+    await writeFile(path.join(auditRefs, "audit-template.workflow.ts"), "workflow\n", "utf8");
+    await writeFile(path.join(auditAgents, "openai.yaml"), "agent\n", "utf8");
+
+    const res = spawnSync("node", [binPath, "doctor", "--json"], {
+      encoding: "utf8",
+      env: { ...process.env, CODEX_HOME: dir },
+    });
+    assert.equal(res.status, 0, res.stderr);
+    const body = JSON.parse(res.stdout);
+    const parallelSkill = body.checks.find((check: any) => check.name === "parallel fix skill");
+    assert.equal(parallelSkill.status, "warn");
+    assert.match(parallelSkill.detail, /parallel-fix/);
+    assert.match(parallelSkill.next, /codex-flow install-codex/);
+    await rm(dir, { recursive: true, force: true });
+  });
+
   it("doctor and smoke report unavailable temp dirs without crashing", async () => {
     const dir = await mkdtemp(path.join(tmpdir(), "codex-flow-temp-"));
     const badTmp = path.join(dir, "tmp");