agentic-qe 3.13.2 → 3.13.4

package/dist/cli/chunks/{workflow-FE5QGP2U.js → workflow-BFGS2GAU.js}

@@ -1,5 +1,5 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.13.2");process.exit(0)}
-import"./chunk-UIQVVS7K.js";import{b as $}from"./chunk-KAHMXURL.js";import{d as R}from"./chunk-LZNJ7HXB.js";import{b as k,c as C,d as b}from"./chunk-HANJESCY.js";import{c as W}from"./chunk-FMYNKZ2S.js";import"./chunk-E6JJ4ZRQ.js";import"./chunk-IIZ3HBPV.js";import"./chunk-AJ7A52GF.js";import{Command as O}from"commander";import o from"chalk";function P(d,a){let m=d.indexOf("=");return m>0&&(a[d.substring(0,m)]=d.substring(m+1)),a}function x(d,a,m){let y=new O("workflow").description("Manage QE workflows and pipelines (ADR-041)");return y.command("run <file>").description("Execute a QE pipeline from YAML file").option("-w, --watch","Watch execution progress").option("-v, --verbose","Show detailed output").option("--params <json>","Additional parameters as JSON","{}").action(async(t,l)=>{if(!await m())return;let e=await import("fs"),c=(await import("path")).resolve(t);try{console.log(o.blue(`
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.13.4");process.exit(0)}
+import"./chunk-TFFEB7XD.js";import{b as $}from"./chunk-Y7VWCP35.js";import{d as R}from"./chunk-75CFWCQV.js";import{b as k,c as C,d as b}from"./chunk-7EL5QEMJ.js";import{c as W}from"./chunk-HN2DD2DQ.js";import"./chunk-RCRKCMN5.js";import"./chunk-KDICUKYX.js";import"./chunk-GGZB2ZBB.js";import{Command as O}from"commander";import o from"chalk";function P(d,a){let m=d.indexOf("=");return m>0&&(a[d.substring(0,m)]=d.substring(m+1)),a}function x(d,a,m){let y=new O("workflow").description("Manage QE workflows and pipelines (ADR-041)");return y.command("run <file>").description("Execute a QE pipeline from YAML file").option("-w, --watch","Watch execution progress").option("-v, --verbose","Show detailed output").option("--params <json>","Additional parameters as JSON","{}").action(async(t,l)=>{if(!await m())return;let e=await import("fs"),c=(await import("path")).resolve(t);try{console.log(o.blue(`
  Running workflow from: ${t}
 `));let s=k(c);if(!s.success||!s.workflow){console.log(o.red("Failed to parse pipeline:"));for(let w of s.errors)console.log(o.red(`   ${w}`));await a(1)}let r={...W(l.params,"params")};if(s.pipeline){for(let w of s.pipeline.stages)if(w.params)for(let[S,h]of Object.entries(w.params))r[S]=h}if(!d.workflowOrchestrator.getWorkflow(s.workflow.id)){let w=d.workflowOrchestrator.registerWorkflow(s.workflow);w.success||(console.log(o.red(`Failed to register workflow: ${w.error.message}`)),await a(1))}let n=await d.workflowOrchestrator.executeWorkflow(s.workflow.id,r);if(!n.success){console.log(o.red(`Failed to start workflow: ${n.error.message}`)),await a(1);return}let p=n.value;if(console.log(o.cyan(`  Execution ID: ${p}`)),console.log(o.gray(`  Workflow: ${s.workflow.name}`)),console.log(o.gray(`  Stages: ${s.workflow.steps.length}`)),console.log(""),l.watch){console.log(o.blue(`Workflow Progress:
 `));let w,S=Date.now();for(;;){let g=d.workflowOrchestrator.getWorkflowStatus(p);if(!g)break;if(!w||w.progress!==g.progress||w.status!==g.status||JSON.stringify(w.currentSteps)!==JSON.stringify(g.currentSteps)){process.stdout.write("\r\x1B[K");let v="\u2588".repeat(Math.floor(g.progress/5))+"\u2591".repeat(20-Math.floor(g.progress/5)),D=g.status==="completed"?o.green:g.status==="failed"?o.red:g.status==="running"?o.yellow:o.gray;console.log(`  [${v}] ${g.progress}% - ${D(g.status)}`),g.currentSteps.length>0&&l.verbose&&console.log(o.gray(`    Running: ${g.currentSteps.join(", ")}`)),w=g}if(g.status==="completed"||g.status==="failed"||g.status==="cancelled")break;await new Promise(v=>setTimeout(v,500))}let h=d.workflowOrchestrator.getWorkflowStatus(p);if(h){console.log("");let g=h.duration||Date.now()-S;h.status==="completed"?(console.log(o.green("Workflow completed successfully")),console.log(o.gray(`   Duration: ${$(g)}`)),console.log(o.gray(`   Completed: ${h.completedSteps.length} stages`)),h.skippedSteps.length>0&&console.log(o.yellow(`   Skipped: ${h.skippedSteps.length} stages`))):h.status==="failed"?(console.log(o.red("Workflow failed")),console.log(o.red(`   Error: ${h.error}`)),console.log(o.gray(`   Failed stages: ${h.failedSteps.join(", ")}`))):console.log(o.yellow(`Workflow ${h.status}`))}}else console.log(o.green("Workflow execution started")),console.log(o.gray(`   Use 'aqe workflow status ${p}' to check progress`));console.log(""),await a(0)}catch(s){console.error(o.red(`
@@ -35,10 +35,10 @@ Workflow cancelled: ${t}
 `)):console.log(o.red(`
 Failed to cancel workflow: ${l.error.message}
 `)),await a(l.success?0:1)}catch(l){console.error(o.red(`
-Failed to cancel workflow:`),l),await a(1)}}),y.command("browser-list").description("List available browser workflow templates").action(async()=>{try{let{BrowserWorkflowTool:t}=await import("./browser-workflow-WRYHQQDU.js"),e=await new t().invoke({});if(e.success&&e.data){console.log(o.blue(`
+Failed to cancel workflow:`),l),await a(1)}}),y.command("browser-list").description("List available browser workflow templates").action(async()=>{try{let{BrowserWorkflowTool:t}=await import("./browser-workflow-4JM3IWCS.js"),e=await new t().invoke({});if(e.success&&e.data){console.log(o.blue(`
  Browser Workflow Templates:
 `));for(let u of e.data.availableTemplates)console.log(`  ${o.cyan(u)}`);console.log("")}else console.log(o.red(`Failed: ${e.error||"Unknown error"}`));await a(0)}catch(t){console.error(o.red(`
-Failed:`),t),await a(1)}}),y.command("browser-load [template]").description("Load and validate a browser workflow template or inline YAML").option("--yaml <yaml>","Inline YAML workflow definition").option("-v, --var <key=value>","Variable override (repeatable)",P,{}).option("-F, --format <format>","Output format (text|json)","text").option("-o, --output <path>","Write output to file").action(async(t,l)=>{try{let{BrowserWorkflowTool:e}=await import("./browser-workflow-WRYHQQDU.js"),{writeOutput:u,toJSON:c}=await import("./ci-output-TAJFQWDP.js"),s=new e,f={variables:l.var||{}};if(l.yaml)f.workflowYaml=l.yaml;else if(t)if(t.endsWith(".yaml")||t.endsWith(".yml")){let i=await import("fs"),p=(await import("path")).resolve(t);i.existsSync(p)||(console.log(o.red(`
+Failed:`),t),await a(1)}}),y.command("browser-load [template]").description("Load and validate a browser workflow template or inline YAML").option("--yaml <yaml>","Inline YAML workflow definition").option("-v, --var <key=value>","Variable override (repeatable)",P,{}).option("-F, --format <format>","Output format (text|json)","text").option("-o, --output <path>","Write output to file").action(async(t,l)=>{try{let{BrowserWorkflowTool:e}=await import("./browser-workflow-4JM3IWCS.js"),{writeOutput:u,toJSON:c}=await import("./ci-output-HQBBQQES.js"),s=new e,f={variables:l.var||{}};if(l.yaml)f.workflowYaml=l.yaml;else if(t)if(t.endsWith(".yaml")||t.endsWith(".yml")){let i=await import("fs"),p=(await import("path")).resolve(t);i.existsSync(p)||(console.log(o.red(`
 File not found: ${p}
 `)),await a(1)),f.workflowYaml=i.readFileSync(p,"utf-8")}else f.templateName=t;else console.log(o.red(`
 Provide a template name or --yaml. Use "workflow browser-list" to see templates.

package/dist/cli/chunks/workflow-orchestrator-PVTYPYY4.js

@@ -0,0 +1,2 @@
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.13.4");process.exit(0)}
+import{a,b,c,d}from"./chunk-EPSF2ERW.js";import"./chunk-56QR72EB.js";import"./chunk-ZAT65V6I.js";import"./chunk-XTHRSBMJ.js";import"./chunk-TO7FTPRV.js";import"./chunk-QGH54HTH.js";import"./chunk-E7FCVH32.js";import"./chunk-27REOPQK.js";import"./chunk-HN2DD2DQ.js";import"./chunk-RCRKCMN5.js";import"./chunk-KDICUKYX.js";import"./chunk-C75V5PTW.js";import"./chunk-QXF6EQFP.js";import"./chunk-OR2RC7ZH.js";import"./chunk-PI55PHUL.js";import"./chunk-GOHWEQEP.js";import"./chunk-SJ26ZR75.js";import"./chunk-DQ247474.js";import"./chunk-HGBVGEUE.js";import"./chunk-YZGA4ELM.js";import"./chunk-ERKYIV25.js";import"./chunk-GGZB2ZBB.js";export{b as DEFAULT_WORKFLOW_CONFIG,a as WorkflowEvents,c as WorkflowOrchestrator,d as createWorkflowOrchestrator};

package/dist/cli/chunks/{wrappers-AHL5K2LO.js → wrappers-VEVVSVMS.js}

@@ -1,2 +1,2 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.13.2");process.exit(0)}
-import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v as L,w as M,x as N}from"./chunk-LJWIBYTR.js";import{a as v,b as w,c as x,d as y,e as z,f as A,g as B,h as C,i as D,j as E,k as F,l as G,m as H,n as I,o as J,p as K}from"./chunk-IV77BQ2R.js";import"./chunk-U2FCUBBW.js";import"./chunk-HQCJYUKC.js";import"./chunk-YWJ2GPD4.js";import"./chunk-6UGYFYS4.js";import"./chunk-BSQ32ZS5.js";import"./chunk-REBNPQI7.js";import"./chunk-FMYNKZ2S.js";import"./chunk-IIZ3HBPV.js";import"./chunk-6DMB6WK5.js";import"./chunk-5EFNZEOB.js";import"./chunk-J722Z7VO.js";import"./chunk-TLG56A27.js";import"./chunk-DIPOFCBX.js";import"./chunk-ZY5FB3JV.js";import"./chunk-VOYUCJLK.js";import"./chunk-DQXSDWRP.js";import"./chunk-GZ775E5O.js";import"./chunk-AJ7A52GF.js";export{z as GNNLayerFactory,i as QEFlashAttention,x as QEGNNEmbeddingIndex,y as QEGNNIndexFactory,a as QESONA,e as QE_FLASH_ATTENTION_CONFIG,g as QE_PERFORMANCE_TARGETS,f as QE_SONA_CONFIG,A as TensorCompressionFactory,u as batchComputeAttention,K as batchDifferentiableSearch,M as checkRuvectorPackagesAvailable,c as createDomainQESONA,j as createQEFlashAttention,b as createQESONA,D as getDifferentiableSearch,F as getGetCompressionLevel,E as getHierarchicalForward,G as getInit,h as getOptimalBlockConfig,k as getQEFlashAttentionConfig,n as getRuvectorDotProductAttention,m as getRuvectorFlashAttention,p as getRuvectorHyperbolicAttention,B as getRuvectorLayer,q as getRuvectorLinearAttention,r as getRuvectorMoEAttention,o as getRuvectorMultiHeadAttention,L as getRuvectorPackageVersions,C as getTensorCompress,l as getWorkloadTypes,N as initAllRuvectorPackages,w as initGNN,d as isAttentionAvailable,v as isGNNAvailable,s as toFloat32Array,H as toFloat32ArrayGNN,J as toIEmbedding,t as toNumberArrayAttn,I as toNumberArrayGNN};
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.13.4");process.exit(0)}
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v as L,w as M,x as N}from"./chunk-VZO4V4R4.js";import{a as v,b as w,c as x,d as y,e as z,f as A,g as B,h as C,i as D,j as E,k as F,l as G,m as H,n as I,o as J,p as K}from"./chunk-5DESO7E4.js";import"./chunk-ZAT65V6I.js";import"./chunk-XTHRSBMJ.js";import"./chunk-TO7FTPRV.js";import"./chunk-QGH54HTH.js";import"./chunk-E7FCVH32.js";import"./chunk-27REOPQK.js";import"./chunk-HN2DD2DQ.js";import"./chunk-KDICUKYX.js";import"./chunk-QXF6EQFP.js";import"./chunk-OR2RC7ZH.js";import"./chunk-PI55PHUL.js";import"./chunk-GOHWEQEP.js";import"./chunk-SJ26ZR75.js";import"./chunk-DQ247474.js";import"./chunk-HGBVGEUE.js";import"./chunk-YZGA4ELM.js";import"./chunk-ERKYIV25.js";import"./chunk-GGZB2ZBB.js";export{z as GNNLayerFactory,i as QEFlashAttention,x as QEGNNEmbeddingIndex,y as QEGNNIndexFactory,a as QESONA,e as QE_FLASH_ATTENTION_CONFIG,g as QE_PERFORMANCE_TARGETS,f as QE_SONA_CONFIG,A as TensorCompressionFactory,u as batchComputeAttention,K as batchDifferentiableSearch,M as checkRuvectorPackagesAvailable,c as createDomainQESONA,j as createQEFlashAttention,b as createQESONA,D as getDifferentiableSearch,F as getGetCompressionLevel,E as getHierarchicalForward,G as getInit,h as getOptimalBlockConfig,k as getQEFlashAttentionConfig,n as getRuvectorDotProductAttention,m as getRuvectorFlashAttention,p as getRuvectorHyperbolicAttention,B as getRuvectorLayer,q as getRuvectorLinearAttention,r as getRuvectorMoEAttention,o as getRuvectorMultiHeadAttention,L as getRuvectorPackageVersions,C as getTensorCompress,l as getWorkloadTypes,N as initAllRuvectorPackages,w as initGNN,d as isAttentionAvailable,v as isGNNAvailable,s as toFloat32Array,H as toFloat32ArrayGNN,J as toIEmbedding,t as toNumberArrayAttn,I as toNumberArrayGNN};

package/dist/cli/commands/platform.d.ts

@@ -8,6 +8,23 @@
  *   verify - Verify a platform's configuration
  */
 import { Command } from 'commander';
+import { type PlatformId } from '../../init/platform-config-generator.js';
+export interface PlatformVerificationCheck {
+    label: string;
+    passed: boolean;
+    detail: string;
+}
+export interface PlatformVerificationResult {
+    platform: PlatformId;
+    passed: boolean;
+    checks: PlatformVerificationCheck[];
+}
+export interface PlatformVerificationOptions {
+    expectMcp?: boolean;
+    expectRuflo?: boolean;
+}
+/** Inspect the complete installed surface for a platform without changing it. */
+export declare function verifyPlatformConfiguration(projectRoot: string, platformId: PlatformId, options?: PlatformVerificationOptions): PlatformVerificationResult;
 export declare function createPlatformCommand(): Command;
 export default createPlatformCommand;
 //# sourceMappingURL=platform.d.ts.map

package/dist/cli/commands/platform.js

@@ -12,6 +12,7 @@ import chalk from 'chalk';
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { PLATFORM_REGISTRY, } from '../../init/platform-config-generator.js';
+import { selectCodexSkills } from '../../init/codex-skill-manifest.js';
 import { toErrorMessage } from '../../shared/error-utils.js';
 // ============================================================================
 // Helpers
@@ -55,7 +56,7 @@ function parseConfigFile(filePath, format) {
         return { valid: false, error: toErrorMessage(error) };
     }
 }
-function checkAqeEntry(filePath, platform) {
+function checkAqeEntry(filePath, _platform) {
     try {
         const content = readFileSync(filePath, 'utf-8');
         return content.includes('agentic-qe');
@@ -64,6 +65,72 @@ function checkAqeEntry(filePath, platform) {
         return false;
     }
 }
+/** Inspect the complete installed surface for a platform without changing it. */
+export function verifyPlatformConfiguration(projectRoot, platformId, options = {}) {
+    const platform = PLATFORM_REGISTRY[platformId];
+    const checks = [];
+    const add = (label, passed, detail) => {
+        checks.push({ label, passed, detail });
+    };
+    const expectMcp = options.expectMcp !== false;
+    const configPath = path.join(projectRoot, platform.configPath);
+    const configExists = existsSync(configPath);
+    if (expectMcp) {
+        add('Config file', configExists, configExists ? platform.configPath : `missing: ${platform.configPath}`);
+    }
+    else {
+        add('MCP configuration', true, configExists ? `${platform.configPath} preserved` : 'intentionally disabled');
+    }
+    if (configExists && expectMcp) {
+        const parsed = parseConfigFile(configPath, platform.configFormat);
+        add('Config syntax', parsed.valid, parsed.valid
+            ? `valid ${platform.configFormat.toUpperCase()}`
+            : parsed.error || 'invalid configuration');
+        add('AQE MCP entry', checkAqeEntry(configPath, platform), 'agentic-qe server entry');
+    }
+    const rulesPath = path.join(projectRoot, platform.rulesPath);
+    const rulesExists = existsSync(rulesPath);
+    add('Behavioral rules', rulesExists, rulesExists ? platform.rulesPath : `missing: ${platform.rulesPath}`);
+    if (platformId === 'codex' && rulesExists) {
+        const rules = readFileSync(rulesPath, 'utf-8');
+        add('AQE instructions', rules.includes('Quality Engineering Standards (Agentic QE)'), 'AGENTS.md contains generated AQE guidance');
+    }
+    if (platformId === 'codex') {
+        const hooksPath = path.join(projectRoot, '.codex', 'hooks.json');
+        let hookCommands = [];
+        let hooksValid = false;
+        if (existsSync(hooksPath)) {
+            try {
+                const parsed = JSON.parse(readFileSync(hooksPath, 'utf-8'));
+                hooksValid = Boolean(parsed.hooks && typeof parsed.hooks === 'object');
+                hookCommands = JSON.stringify(parsed).match(/\.codex\/hooks\/[a-z0-9-]+\.cjs/gi) || [];
+            }
+            catch {
+                hooksValid = false;
+            }
+        }
+        add('Lifecycle hooks', hooksValid, hooksValid ? '.codex/hooks.json is valid' : 'missing or invalid .codex/hooks.json');
+        const referencedAdapters = [...new Set(hookCommands.map((command) => command.split('/').pop()))];
+        const adaptersPresent = referencedAdapters.length > 0
+            && referencedAdapters.every((file) => existsSync(path.join(projectRoot, '.codex', 'hooks', file)));
+        add('Hook adapters', adaptersPresent, referencedAdapters.length > 0 ? `${referencedAdapters.length} referenced adapter(s)` : 'no Codex hook adapters referenced');
+        const runtimes = [
+            'aqe-runtime.cjs',
+            ...(referencedAdapters.includes('ruflo-codex-hook.cjs') ? ['ruflo-runtime.cjs'] : []),
+        ];
+        const missingRuntimes = runtimes.filter((file) => !existsSync(path.join(projectRoot, '.codex', 'hooks', file)));
+        add('Hook runtimes', missingRuntimes.length === 0, missingRuntimes.length === 0 ? `${runtimes.length} runtime(s) present` : `missing: ${missingRuntimes.join(', ')}`);
+        const skillsPath = path.join(projectRoot, '.agents', 'skills');
+        const requiredSkills = selectCodexSkills({ includeRuflo: options.expectRuflo === true });
+        const missingSkills = requiredSkills
+            .filter((skill) => !existsSync(path.join(skillsPath, skill.name, 'SKILL.md')))
+            .map((skill) => skill.name);
+        add('QE skills', missingSkills.length === 0, missingSkills.length === 0
+            ? `${requiredSkills.length} required AQE skill(s) present`
+            : `missing: ${missingSkills.join(', ')}`);
+    }
+    return { platform: platformId, passed: checks.every((check) => check.passed), checks };
+}
 // ============================================================================
 // Platform Command
 // ============================================================================
@@ -107,6 +174,7 @@ export function createPlatformCommand() {
         .command('setup <name>')
         .description('Set up a specific platform configuration')
         .option('--overwrite', 'Overwrite existing configuration files')
+        .option('--with-ruflo', 'Add optional Ruflo guidance and lifecycle hooks (Codex only)')
         .action(async (name, options) => {
         const projectRoot = process.cwd();
         if (!isValidPlatformId(name)) {
@@ -154,6 +222,7 @@ export function createPlatformCommand() {
             const installer = factory({
                 projectRoot,
                 overwrite: options.overwrite,
+                ...(name === 'codex' ? { includeRuflo: options.withRuflo } : {}),
             });
             const result = await installer.install();
             if (result.success) {
@@ -161,9 +230,17 @@ export function createPlatformCommand() {
                 if (result.mcpConfigured) {
                     console.log(chalk.gray(`    MCP config: ${platform.configPath}`));
                 }
-                if (result.rulesInstalled) {
+                if (result.rulesInstalled || result.agentsMdInstalled) {
                     console.log(chalk.gray(`    Rules: ${platform.rulesPath}`));
                 }
+                if (name === 'codex') {
+                    if (result.hooksConfigured)
+                        console.log(chalk.gray('    Hooks: .codex/hooks.json'));
+                    console.log(chalk.gray(`    QE skills: ${result.skillsInstalled ?? 0} installed`));
+                    console.log(options.withRuflo
+                        ? chalk.green('    Ruflo integration: enabled')
+                        : chalk.gray('    Ruflo integration: not installed (opt in with --with-ruflo)'));
+                }
             }
             else {
                 console.log(chalk.red(`  ${platform.name} setup failed`));
@@ -183,7 +260,9 @@ export function createPlatformCommand() {
     platformCmd
         .command('verify <name>')
         .description('Verify a platform configuration is correct')
-        .action(async (name) => {
+        .option('--no-mcp', 'Verify a deliberately MCP-free platform installation')
+        .option('--with-ruflo', 'Require optional Ruflo guidance and lifecycle hooks (Codex only)')
+        .action(async (name, options) => {
         const projectRoot = process.cwd();
         if (!isValidPlatformId(name)) {
             console.log('');
@@ -197,51 +276,22 @@ export function createPlatformCommand() {
         console.log(chalk.bold.blue(`  Verifying ${platform.name}`));
         console.log(chalk.gray('  ─────────────────────────────────'));
         console.log('');
-        let allPassed = true;
-        // Check 1: Config file exists
-        const configPath = path.join(projectRoot, platform.configPath);
-        if (existsSync(configPath)) {
-            console.log(chalk.green(`  [pass] Config file exists: ${platform.configPath}`));
-        }
-        else {
-            console.log(chalk.red(`  [fail] Config file missing: ${platform.configPath}`));
-            allPassed = false;
-        }
-        // Check 2: Config file is valid
-        if (existsSync(configPath)) {
-            const parseResult = parseConfigFile(configPath, platform.configFormat);
-            if (parseResult.valid) {
-                console.log(chalk.green(`  [pass] Config file is valid ${platform.configFormat.toUpperCase()}`));
-            }
-            else {
-                console.log(chalk.red(`  [fail] Config file is invalid: ${parseResult.error}`));
-                allPassed = false;
-            }
-            // Check 3: Config contains agentic-qe entry
-            if (checkAqeEntry(configPath, platform)) {
-                console.log(chalk.green('  [pass] Config contains agentic-qe entry'));
-            }
-            else {
-                console.log(chalk.red('  [fail] Config does not contain agentic-qe entry'));
-                allPassed = false;
-            }
-        }
-        // Check 4: Rules file exists
-        const rulesPath = path.join(projectRoot, platform.rulesPath);
-        if (existsSync(rulesPath)) {
-            console.log(chalk.green(`  [pass] Rules file exists: ${platform.rulesPath}`));
-        }
-        else {
-            console.log(chalk.red(`  [fail] Rules file missing: ${platform.rulesPath}`));
-            allPassed = false;
+        const verification = verifyPlatformConfiguration(projectRoot, name, {
+            expectMcp: options.mcp !== false,
+            expectRuflo: options.withRuflo,
+        });
+        for (const check of verification.checks) {
+            const message = `  [${check.passed ? 'pass' : 'fail'}] ${check.label}: ${check.detail}`;
+            console.log(check.passed ? chalk.green(message) : chalk.red(message));
         }
         console.log('');
-        if (allPassed) {
+        if (verification.passed) {
             console.log(chalk.green(`  ${platform.name} configuration is valid`));
         }
         else {
             console.log(chalk.yellow(`  ${platform.name} configuration has issues`));
             console.log(chalk.gray(`  Run "aqe platform setup ${name}" to fix`));
+            process.exitCode = 1;
         }
         console.log('');
     });

package/dist/cli/handlers/init-handler.d.ts

@@ -93,6 +93,7 @@ interface InitOptions {
     withKilocode?: boolean;
     withRoocode?: boolean;
     withCodex?: boolean;
+    withRuflo?: boolean;
     withWindsurf?: boolean;
     withContinuedev?: boolean;
     withAllPlatforms?: boolean;

package/dist/cli/handlers/init-handler.js

@@ -48,6 +48,7 @@ export class InitHandler {
             .option('--with-kilocode', 'Include Kilo Code MCP config and custom QE mode')
             .option('--with-roocode', 'Include Roo Code MCP config and custom QE mode')
             .option('--with-codex', 'Include OpenAI Codex CLI MCP, AGENTS.md, hooks, and QE skills')
+            .option('--with-ruflo', 'Add optional Ruflo guidance and lifecycle hooks to the Codex setup')
             .option('--with-windsurf', 'Include Windsurf MCP config and rules')
             .option('--with-continuedev', 'Include Continue.dev MCP config and rules')
             .option('--no-mcp', 'Skip MCP server config (MCP is enabled by default)')
@@ -177,6 +178,7 @@ export class InitHandler {
             withKiloCode: options.withKilocode,
             withRooCode: options.withRoocode,
             withCodex: options.withCodex,
+            withRuflo: options.withRuflo,
             withWindsurf: options.withWindsurf,
             withContinueDev: options.withContinuedev,
             noMcp: options.noMcp && !options.withMcp,
@@ -440,7 +442,9 @@ Options:
   --minimal                  Minimal configuration (skip optional features)
   --skip-patterns            Skip loading pre-trained patterns
   --with-n8n                 Install n8n workflow testing agents and skills
-  --with-opencode            Include OpenCode agent/skill provisioning
+  --with-opencode            Include OpenCode agent/skill provisioning
+  --with-codex               Include OpenAI Codex hooks, instructions, skills, and MCP
+  --with-ruflo               Opt into Ruflo guidance and lifecycle hooks for Codex
   --auto-migrate             Automatically migrate from v2 if detected
   --with-claude-flow         Force Claude Flow integration setup
   --skip-claude-flow         Skip Claude Flow integration
@@ -461,8 +465,10 @@ Governance:
   Use --no-governance to skip, or set GOVERNANCE_*=false env vars for
   fine-grained control over individual gates (ContinueGate, MemoryWriteGate, etc.)
 
-Examples:
-  aqe init --auto            # Auto-configure based on project (keeps existing skills)
+Examples:
+  aqe init --auto            # Auto-configure based on project (keeps existing skills)
+  aqe init --auto --with-codex --with-ruflo
+                             # Codex plus optional Ruflo coordination
   aqe init --auto --upgrade  # Auto-configure AND update all skills/agents
   aqe init --upgrade         # Upgrade existing installation
   aqe init --wizard          # Run interactive wizard

package/dist/init/codex-installer.d.ts

@@ -8,6 +8,10 @@
 export interface CodexInstallerOptions {
     projectRoot: string;
     overwrite?: boolean;
+    /** Whether to install the AQE MCP server entry. Defaults to true. */
+    installMcp?: boolean;
+    /** Install optional Ruflo guidance, adapter, runtime, and lifecycle groups. */
+    includeRuflo?: boolean;
     /**
      * Memory backend for this install. 'memory' => database-free: the MCP config
      * is written to run in-memory (AQE_MEMORY_BACKEND=memory, no AQE_MEMORY_PATH). (#533)
@@ -25,14 +29,28 @@ export interface CodexInstallResult {
     agentsMdPath: string;
     hooksPath: string;
     skillsPath: string;
+    /** Per-component outcomes. Legacy booleans above remain supported. */
+    components: {
+        mcp: CodexComponentOutcome;
+        rules: CodexComponentOutcome;
+        hooks: CodexComponentOutcome;
+        skills: CodexComponentOutcome;
+    };
+}
+export interface CodexComponentOutcome {
+    status: 'installed' | 'updated' | 'preserved' | 'skipped' | 'unavailable' | 'failed';
+    error?: string;
 }
 export declare class CodexInstaller {
     private projectRoot;
     private overwrite;
     private options;
     private generator;
+    private static readonly AGENTS_START;
+    private static readonly AGENTS_END;
     constructor(options: CodexInstallerOptions);
     install(): Promise<CodexInstallResult>;
+    private recordComponentFailure;
     /**
      * Install Codex-native lifecycle adapters and merge AQE/ruflo hook groups
      * without removing user-defined hooks.
@@ -44,15 +62,16 @@ export declare class CodexInstaller {
     private resolvePackageRoot;
     /**
      * Merge AQE MCP server config into existing TOML.
-     * Simple approach: if [mcp_servers.agentic-qe] already exists, skip.
-     * Otherwise, append the AQE block at the end.
+     * Replace only AQE-owned TOML tables, preserving every user-owned table and
+     * setting. AQE owns the exact `mcp_servers.agentic-qe` table prefix.
      */
     private mergeExistingTomlConfig;
     /**
      * Merge AQE section into existing AGENTS.md.
-     * Appends the AQE section if not already present.
+     * Replaces a previously marked AQE section or appends a new marked section.
      */
     private mergeExistingAgentsMd;
+    private markAgentsSection;
 }
 export declare function createCodexInstaller(options: CodexInstallerOptions): CodexInstaller;
 //# sourceMappingURL=codex-installer.d.ts.map