@williambeto/ai-workflow 2.6.7 → 2.7.1

package/CHANGELOG.md

@@ -1,8 +1,87 @@
 ## [unreleased]
 
+### 🚀 Features
+
+- *(adapters)* Harden Codex adapter with robust system boundaries
+
+### 💼 Other
+
+- Merge pull request #125 from williambeto/chore/cleanup
+
+chore: clean up obsolete tests, audits, releases, and duplicates
+- Merge pull request #126 from williambeto/refactor/consumer-examples
+
+refactor: modernize consumer examples
+- Merge pull request #127 from williambeto/feat/codex-hardening
+
+feat(adapters): harden Codex adapter
+
+### 🚜 Refactor
+
+- Replace outdated examples with modern v2.7 consumer examples
+
+### 📚 Documentation
+
+- Translate antigravity system prompt to english
+
+### ⚙️ Miscellaneous Tasks
+
+- Clean up obsolete tests, audits, releases, and duplicates
+- Merge dependabot PR
+## [2.7.0] - 2026-07-06
+
+### 🚀 Features
+
+- *(adapters)* Add copilot-instructions.md for maximum Codex compatibility
+
+### 🐛 Bug Fixes
+
+- *(codex)* Ensure root instructions and proper runtime detection
+
+### 💼 Other
+
+- Merge pull request #123 from williambeto/feat/codex-compatibility
+
+feat: native codex runtime support
+
+### 📚 Documentation
+
+- Update CHANGELOG for v2.6.6 and v2.6.7
+- Save publish qa checklist
+- *(qa)* Enforce markdown pattern on github releases
+- Promote Codex to Supported and update assets list
+
+### ⚙️ Miscellaneous Tasks
+
+- *(release)* V2.7.0
+## [2.6.7] - 2026-07-04
+
+### 🐛 Bug Fixes
+
+- *(fidelity)* Skip HTML semantic check for non-page components (fixes #122)
+
+### ⚙️ Miscellaneous Tasks
+
+- *(release)* 2.6.7
+## [2.6.6] - 2026-07-04
+
+### 🚜 Refactor
+
+- *(cli)* Reduce cyclomatic complexity in core commands
+
+### ⚙️ Miscellaneous Tasks
+
+- Cleanup obsolete verification file and sync package-lock
+- *(release)* 2.6.6
+## [2.6.5] - 2026-07-04
+
 ### 🧪 Testing
 
 - Align E2E assertions with updated requestedActor routing mechanics
+
+### ⚙️ Miscellaneous Tasks
+
+- *(release)* V2.6.5
 ## [2.6.4] - 2026-07-04
 
 ### 🐛 Bug Fixes

package/bin/ai-workflow.js

@@ -193,13 +193,14 @@ function isValidProfile(profile) {
 function getTemplateFiles(profile = "standard") {
   return PROFILE_FILES[profile] ?? PROFILE_FILES.standard;
 }
-function buildAiWorkflowConfig({ profile }) {
+function buildAiWorkflowConfig({ profile, runtimes = ["opencode"] }) {
   const version = getPackageVersion();
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const primaryRuntime = runtimes.join("+");
   return {
     package: "@williambeto/ai-workflow",
     version,
-    runtime: "opencode",
+    runtime: primaryRuntime,
     profile,
     installMode: "project-local",
     generatedAt: now,
@@ -573,7 +574,8 @@ function normalize(p) {
 }
 var LINKABLE_ROOTS = /* @__PURE__ */ new Set([
   "opencode",
-  ".agents"
+  ".agents",
+  "examples"
 ]);
 var LINKABLE_FILES = /* @__PURE__ */ new Set([]);
 function buildSymlinkEntries({ templateFiles, installRoot = ".ai-workflow" }) {
@@ -756,6 +758,11 @@ var CodexAdapter = class {
     const fileName = path7.basename(filePath, ".md");
     const hardenedContent = `${content}
 
+##  System Directives for Codex
+- **No Conversational Filler**: Output only the requested artifact or analysis. Do not apologize or add filler text.
+- **Explicit Paths**: Always specify the exact, absolute or relative file path before making edits.
+- **Read-Only First**: Do not invent or assume file contents. Always read the workspace first.
+
 ##  Completion Contract (Mandatory)
 Every task completion MUST provide the following payload:
 1. **Status**: ${COMPLETION_STATUS_TEXT}
@@ -779,7 +786,7 @@ Every task completion MUST provide the following payload:
    * - Skills -> .agents/skills/
    * - Commands -> .codex/prompts/
    */
-  async deploy(installRoot = ".ai-workflow") {
+  async deploy(installRoot = ".ai-workflow", force) {
     const sourceAgentsDir = path7.join(this.cwd, installRoot, "opencode/agents");
     const sourceSkillsDir = path7.join(this.cwd, installRoot, "opencode/skills");
     const sourceCommandsDir = path7.join(this.cwd, installRoot, "opencode/commands");
@@ -791,7 +798,7 @@ Every task completion MUST provide the following payload:
       const transformed = await this.transformAgent(path7.join(sourceAgentsDir, file));
       await fs5.writeFile(path7.join(codexAgentsDir, `${transformed.name}.md`), transformed.content);
     }
-    const codexSkillsDir = path7.join(this.cwd, ".agents/skills");
+    const codexSkillsDir = path7.join(this.cwd, ".codex/skills");
     await fs5.mkdir(codexSkillsDir, { recursive: true });
     const skillFolders = await fs5.readdir(sourceSkillsDir).catch(() => []);
     for (const folder of skillFolders) {
@@ -812,7 +819,7 @@ Every task completion MUST provide the following payload:
       const content = await fs5.readFile(path7.join(sourceCommandsDir, file), "utf8");
       await fs5.writeFile(path7.join(codexPromptsDir, targetFileName), content);
     }
-    const codexPoliciesDir = path7.join(this.cwd, ".agents", "docs", "policies");
+    const codexPoliciesDir = path7.join(this.cwd, ".codex", "docs", "policies");
     await fs5.mkdir(codexPoliciesDir, { recursive: true });
     const sourcePoliciesDir = path7.join(this.cwd, installRoot, "opencode", "docs", "policies");
     const policyFiles = await fs5.readdir(sourcePoliciesDir).catch(() => []);
@@ -821,6 +828,80 @@ Every task completion MUST provide the following payload:
       const policyContent = await fs5.readFile(path7.join(sourcePoliciesDir, file), "utf8");
       await fs5.writeFile(path7.join(codexPoliciesDir, file), policyContent);
     }
+    await this.deployRootCopilotInstructions();
+    await this.deployRootCodexMd(force);
+    await this.deployRootAgentsMd(force);
+  }
+  async deployRootCopilotInstructions() {
+    const githubDir = path7.join(this.cwd, ".github");
+    await fs5.mkdir(githubDir, { recursive: true });
+    const targetPath = path7.join(githubDir, "copilot-instructions.md");
+    const instructions = `# AI Workflow Kit Governance
+
+This repository uses the **AI Workflow Kit** (OpenCode-first) workflow.
+
+##  Mandate: Atlas Authority Protocol
+All architectural changes must align with the specifications issued by the **Specification Authority**.
+
+##  Rules & Personas
+- Always follow the **Branch Gate** policy (never work on \`main\`).
+- Always follow the **SDD Workflow** (Spec -> Plan -> PR -> Evidence).
+- When acting as an agent, consult the instructions in \`.github/agents/\`.
+- When utilizing skills, consult the files in \`.codex/skills/\`.
+
+##  System Boundaries
+- **No Conversational Filler**: Do not apologize or add filler text.
+- **Strict Evidence**: You must provide the Completion Contract payload when finishing a task.
+- **Immutable Core**: Do not modify files inside \`.ai-workflow/\`, \`.agents/\`, \`.claude/\`, or \`.codex/\` unless explicitly requested.
+
+##  Completion Contract
+Every task completion MUST follow the payload format defined in the individual agent files.
+`;
+    await fs5.writeFile(targetPath, instructions);
+  }
+  async deployRootCodexMd(force) {
+    const targetPath = path7.join(this.cwd, "CODEX.md");
+    if (!force && await this.exists(targetPath)) return;
+    const templatePath = path7.join(this.cwd, ".ai-workflow", "templates", "CODEX.md.template");
+    if (await this.exists(templatePath)) {
+      const content = await fs5.readFile(templatePath, "utf8");
+      await fs5.writeFile(targetPath, content);
+      return;
+    }
+    const instructions = `# AI Workflow Kit Governance
+
+This repository uses the **AI Workflow Kit** (OpenCode-first) workflow.
+
+##  Mandate: Atlas Authority Protocol
+All architectural changes must align with the specifications issued by the **Specification Authority**.
+
+##  Rules & Personas
+- Always follow the **Branch Gate** policy (never work on \`main\`).
+- Always follow the **SDD Workflow** (Spec -> Plan -> PR -> Evidence).
+- When acting as an agent, consult the instructions in \`.github/agents/\`.
+- When utilizing skills, consult the files in \`.codex/skills/\`.
+
+##  System Boundaries
+- **No Conversational Filler**: Do not apologize or add filler text.
+- **Strict Evidence**: You must provide the Completion Contract payload when finishing a task.
+- **Immutable Core**: Do not modify files inside \`.ai-workflow/\`, \`.agents/\`, \`.claude/\`, or \`.codex/\` unless explicitly requested.
+
+##  Completion Contract
+Every task completion MUST follow the payload format defined in the individual agent files.
+`;
+    await fs5.writeFile(targetPath, instructions);
+  }
+  async deployRootAgentsMd(force) {
+    const targetPath = path7.join(this.cwd, "AGENTS.md");
+    if (!force && await this.exists(targetPath)) return;
+    const templatePath = path7.join(this.cwd, ".ai-workflow", "AGENTS.md");
+    if (await this.exists(templatePath)) {
+      let content = await fs5.readFile(templatePath, "utf8");
+      content = content.replace(/\.agents\/skills/g, ".codex/skills");
+      content = content.replace(/opencode\/commands/g, ".codex/prompts");
+      content = content.replace(/opencode\/docs\/policies/g, ".codex/docs/policies");
+      await fs5.writeFile(targetPath, content);
+    }
   }
   async exists(p) {
     try {
@@ -1256,7 +1337,7 @@ function resolveProfile(profile) {
   }
   return selectedProfile;
 }
-async function writeInstallFiles(cwd, actions, selectedProfile, force, noOverwrite, backupRoot = ".ai-workflow-backups") {
+async function writeInstallFiles(cwd, actions, selectedProfile, platforms, force, noOverwrite, backupRoot = ".ai-workflow-backups") {
   const skipped = [];
   const backups = [];
   for (const action of actions) {
@@ -1272,7 +1353,7 @@ async function writeInstallFiles(cwd, actions, selectedProfile, force, noOverwri
       });
       backups.push(backupPath);
     }
-    const content = action.relativePath === ".ai-workflow/config.json" ? `${JSON.stringify(buildAiWorkflowConfig({ profile: selectedProfile }), null, 2)}
+    const content = action.relativePath === ".ai-workflow/config.json" ? `${JSON.stringify(buildAiWorkflowConfig({ profile: selectedProfile, runtimes: platforms.length > 0 ? platforms : ["opencode"] }), null, 2)}
 ` : action.content;
     await writeFileSafe(action.absolutePath, content || "");
   }
@@ -1319,7 +1400,7 @@ async function writeSymlinks(cwd, linkEntries, force, backupRoot = ".ai-workflow
   }
   return { linkBackups, linkCreated };
 }
-async function executePlatformMigrations(cwd, installRoot, platforms, claude, codex, antigravity) {
+async function executePlatformMigrations(cwd, installRoot, platforms, claude, codex, antigravity, force) {
   if (platforms.length === 0) return;
   console.log("ai-workflow: migrating to native platforms...");
   const agentsDir = path9.join(cwd, installRoot, "opencode/agents");
@@ -1332,7 +1413,7 @@ async function executePlatformMigrations(cwd, installRoot, platforms, claude, co
   }
   if (codex) {
     const adapter = new CodexAdapter({ cwd });
-    await adapter.deploy(installRoot);
+    await adapter.deploy(installRoot, force);
     console.log("- codex: deployed AI Workflow Kit agents to .agents/, .codex/, and .github/ (native discovery enabled)");
   }
   if (antigravity) {
@@ -1433,7 +1514,7 @@ async function runInit({
     }
     return;
   }
-  const { skipped, backups } = await writeInstallFiles(cwd, actions, selectedProfile, force, noOverwrite, backupRoot);
+  const { skipped, backups } = await writeInstallFiles(cwd, actions, selectedProfile, platforms, force, noOverwrite, backupRoot);
   const { linkBackups, linkCreated } = await writeSymlinks(cwd, linkEntries, force, backupRoot);
   await setupInternalSymlinks(cwd, installRoot);
   const opencodeResult = await mergeOpencodeConfig(cwd, { force, backupRoot });
@@ -1457,7 +1538,7 @@ async function runInit({
   }
   const gitignoreResult = await upsertGitignoreBlock(cwd, generatedIgnoreEntries);
   const scriptInjected = await injectScripts(cwd);
-  await executePlatformMigrations(cwd, installRoot, platforms, claude, codex, antigravity);
+  await executePlatformMigrations(cwd, installRoot, platforms, claude, codex, antigravity, force);
   printInstallationSummary({
     selectedProfile,
     opencodeResult,
@@ -1542,8 +1623,10 @@ async function checkAiWorkflowConfig(cwd, state) {
     }
     if (config.runtime) {
       console.log(`PASS runtime: ${config.runtime}`);
+      state.runtimes = config.runtime.split("+");
     } else {
       console.log(`NOTE runtime field not present in ${basename}`);
+      state.runtimes = ["opencode"];
     }
     if (Array.isArray(config.managedBlocks)) {
       state.managedBlocks = config.managedBlocks;
@@ -1640,17 +1723,50 @@ async function checkPackageJson(cwd, state) {
     }
   }
 }
+async function checkCodexRuntime(cwd, state) {
+  const checks = [
+    { name: "root AGENTS.md exists", path: "AGENTS.md" },
+    { name: ".codex/skills exists", path: ".codex/skills" },
+    { name: ".codex prompts detected", path: ".codex/prompts" },
+    { name: ".codex policies detected", path: ".codex/docs/policies" }
+  ];
+  for (const check of checks) {
+    const ok = await exists(path10.join(cwd, check.path));
+    if (ok) {
+      console.log(`PASS ${check.name}`);
+    } else {
+      state.hasFailure = true;
+      console.log(`FAIL ${check.name}`);
+    }
+  }
+  const codexMdOk = await exists(path10.join(cwd, "CODEX.md"));
+  if (codexMdOk) {
+    console.log(`PASS root CODEX.md exists`);
+  }
+  if (state.runtimes.includes("codex")) {
+    console.log("PASS config runtime includes codex");
+  } else {
+    state.hasFailure = true;
+    console.log("FAIL config runtime includes codex");
+  }
+}
 async function runDoctor({ cwd }) {
   const state = {
     hasFailure: false,
     hasWarning: false,
-    managedBlocks: []
+    managedBlocks: [],
+    runtimes: ["opencode"]
   };
   console.log("Doctor report:");
-  await checkOpenCodeRuntime(cwd, state);
   await checkRequiredFiles(cwd, state);
   await checkAiWorkflowConfig(cwd, state);
-  await checkOpencodeJson(cwd, state);
+  if (state.runtimes.includes("opencode")) {
+    await checkOpenCodeRuntime(cwd, state);
+    await checkOpencodeJson(cwd, state);
+  }
+  if (state.runtimes.includes("codex")) {
+    await checkCodexRuntime(cwd, state);
+  }
   await checkPackageJson(cwd, state);
   const finalStatus = state.hasFailure ? "FAIL" : state.hasWarning ? "PASS_WITH_NOTES" : "PASS";
   console.log(`Final status: ${finalStatus}`);