agentic-qe 3.14.0 → 3.14.2

package/dist/early-exit/types.js

@@ -28,6 +28,7 @@ export var QualityFlags;
  * Default configuration for balanced early exit
  */
 export const DEFAULT_EXIT_CONFIG = {
+    mode: 'shadow',
     exitLayer: 1, // Exit after integration tests
     minLambdaForExit: 80,
     minLambdaStability: 0.85,
@@ -42,6 +43,7 @@ export const DEFAULT_EXIT_CONFIG = {
  * Aggressive configuration for fast feedback
  */
 export const AGGRESSIVE_EXIT_CONFIG = {
+    mode: 'shadow',
     exitLayer: 0, // Exit after unit tests
     minLambdaForExit: 60,
     minLambdaStability: 0.75,
@@ -56,6 +58,7 @@ export const AGGRESSIVE_EXIT_CONFIG = {
  * Conservative configuration for high-risk changes
  */
 export const CONSERVATIVE_EXIT_CONFIG = {
+    mode: 'shadow',
     exitLayer: 2, // Exit after E2E tests
     minLambdaForExit: 95,
     minLambdaStability: 0.92,

package/dist/index.d.ts

@@ -13,8 +13,8 @@ export type { TeammateIdleHookConfig, TaskQueue, PendingTask, TeammateIdleStats,
 export { DevilsAdvocate, ClaimVerifier } from './agents';
 export * from './domains';
 export { MCPProtocolServer, createMCPProtocolServer, MCPServer, createMCPServer, ToolRegistry, createToolRegistry, } from './mcp';
-export { createQEReasoningBank, QEReasoningBank, RealQEReasoningBank, createRealQEReasoningBank, detectQEDomain, detectQEDomains, mapQEDomainToAQE, QE_DOMAIN_LIST, QE_DOMAINS, } from './learning';
-export type { QEPattern, QEPatternType, QEPatternTemplate, QEPatternContext, QEDomain, CreateQEPatternOptions, LearningOutcome, PatternSearchOptions, PatternSearchResult, QERoutingRequest, QERoutingResult, } from './learning';
+export { createQEReasoningBank, QEReasoningBank, RealQEReasoningBank, createRealQEReasoningBank, detectQEDomain, detectQEDomains, mapQEDomainToAQE, QE_DOMAIN_LIST, QE_DOMAINS, createStructuralRetrievalCorpus, verifyStructuralRetrievalCorpus, evaluateStructuralRetrieval, diagnoseRetrieval, createRetrievalReceipt, STRUCTURAL_RETRIEVAL_TRANSFORMATIONS, PatternMutationError, } from './learning';
+export type { QEPattern, QEPatternType, QEPatternTemplate, QEPatternContext, QEDomain, CreateQEPatternOptions, LearningOutcome, PatternSearchOptions, PatternSearchResult, QERoutingRequest, QERoutingResult, StructuralTransformation, CorpusSplit, StructuralPattern, StructuralRetrievalQuery, StructuralRetrievalCorpus, RankedCandidate, RetrievalDiagnostic, QueryRetrievalResult, MetricEstimate, RetrievalMetricSet, StructuralRetrievalReport, RetrievalReceipt, CreateRetrievalReceiptInput, PatternMutationDisposition, } from './learning';
 export { createTestOutcomeTracker, createCoverageLearner, createQualityScoreCalculator, createPatternPromotionManager, createQualityFeedbackLoop, createInitializedFeedbackLoop, QualityFeedbackLoop, TestOutcomeTracker, CoverageLearner, QualityScoreCalculator, PatternPromotionManager, DEFAULT_FEEDBACK_CONFIG, DEFAULT_QUALITY_WEIGHTS, DEFAULT_PROMOTION_CRITERIA, } from './feedback';
 export type { TestOutcome, CoverageSession, CoverageStrategy, CoverageTechnique, FeedbackConfig, PatternTier, CoverageGap as FeedbackCoverageGap, QualityDimensions, QualityWeights, PromotionCriteria, PatternPromotionEvent, PatternDemotionEvent, } from './feedback';
 export * from './routing';
@@ -26,7 +26,9 @@ export { EmbeddingGenerator, EmbeddingCache, HNSWEmbeddingIndex, HNSWIndexFactor
 export type { EmbeddingDimension, EmbeddingNamespace, QuantizationType, IEmbedding, IEmbeddingModelConfig, IEmbeddingOptions, IBatchEmbeddingResult, ISimilarityResult, ISearchOptions, EmbeddingModelType, IHNSWConfig, ICacheConfig, IEmbeddingStats, TestCaseMetadata, ITestCaseEmbedding, ISimilarTestResult, ITestEmbeddingOptions, ICoverageData, ICoverageGap, ICoverageEmbedding, ICoverageEmbeddingOptions, DefectSeverity, DefectType, IDefectMetadata, IDefectEmbedding, ISimilarDefectResult, IDefectPrediction, IDefectEmbeddingOptions, } from './integrations/embeddings';
 export type { TopologyType, AgentNode, CommunicationEdge, SwarmTopology, AgentHealthMetrics as StrangeLoopAgentHealthMetrics, ConnectivityMetrics, SwarmVulnerability, SwarmHealthObservation, TrendDirection, TrendAnalysis, BottleneckInfo, BottleneckAnalysis, PredictedVulnerability, SwarmModelDelta, SelfHealingActionType, ActionPriority, SelfHealingAction, ActionResult, ExecutedAction, SelfDiagnosis, StrangeLoopConfig, StrangeLoopStats, StrangeLoopEventType, StrangeLoopEvent, StrangeLoopEventListener, AgentProvider, ActionExecutor, } from './strange-loop';
 export { SwarmSkillValidator, createSwarmSkillValidator, DEFAULT_SWARM_VALIDATION_CONFIG, P0_SKILLS, DEFAULT_VALIDATION_MODELS, TriggerOptimizer, createTriggerOptimizer, parseSkillFrontmatter, VersionComparator, createVersionComparator, } from './validation';
+export { computeVerificationArtifactDigest, computeVerificationReachManifestHash, createVerificationReachManifest, evaluateVerificationReach, } from './validation/verification-reach';
 export type { SwarmValidationConfig, SwarmTopology as ValidationSwarmTopology, SwarmValidationResult, SwarmValidationSummary, SkillValidatorFn, SkillMetadata, TriggerAnalysisConfig, TriggerAnalysisResult, TriggerSuggestion, TriggerOptimizationReport, VersionComparisonConfig, SkillVersion, VersionComparisonResult, VersionResult, ComparisonStats, TestCaseComparison, } from './validation';
+export type { FailureModeRequirement, FailureModeReachResult, FailureModeSeverity, UncoveredDisposition, VerificationChannel, VerificationCost, VerificationCoverageVerdict, VerificationEvidenceClass, VerificationExecutionStatus, VerificationReach, VerificationReachEvaluationOptions, VerificationReachLevel, VerificationReachManifest, VerificationReachManifestInput, VerificationReachResult, VerificationTarget, } from './validation/verification-reach';
 export declare const VERSION: string;
 export declare const ARCHITECTURE = "DDD with 13 Bounded Contexts";
 export declare const MAX_CONCURRENT_AGENTS = 15;

package/dist/index.js

@@ -27,7 +27,7 @@ export * from './domains/index.js';
 export { MCPProtocolServer, createMCPProtocolServer, MCPServer, createMCPServer, ToolRegistry, createToolRegistry, } from './mcp/index.js';
 // Learning Module - QE ReasoningBank for pattern learning (ADR-021)
 // Exclude types that conflict with routing (ComplexityLevel, ProgrammingLanguage, TestFramework)
-export { createQEReasoningBank, QEReasoningBank, RealQEReasoningBank, createRealQEReasoningBank, detectQEDomain, detectQEDomains, mapQEDomainToAQE, QE_DOMAIN_LIST, QE_DOMAINS, } from './learning/index.js';
+export { createQEReasoningBank, QEReasoningBank, RealQEReasoningBank, createRealQEReasoningBank, detectQEDomain, detectQEDomains, mapQEDomainToAQE, QE_DOMAIN_LIST, QE_DOMAINS, createStructuralRetrievalCorpus, verifyStructuralRetrievalCorpus, evaluateStructuralRetrieval, diagnoseRetrieval, createRetrievalReceipt, STRUCTURAL_RETRIEVAL_TRANSFORMATIONS, PatternMutationError, } from './learning/index.js';
 // Feedback Module - Quality Feedback Loop (ADR-023)
 // Exclude types that conflict with shared/types (CoverageMetrics, QualityScore)
 export { createTestOutcomeTracker, createCoverageLearner, createQualityScoreCalculator, createPatternPromotionManager, createQualityFeedbackLoop, createInitializedFeedbackLoop, QualityFeedbackLoop, TestOutcomeTracker, CoverageLearner, QualityScoreCalculator, PatternPromotionManager, DEFAULT_FEEDBACK_CONFIG, DEFAULT_QUALITY_WEIGHTS, DEFAULT_PROMOTION_CRITERIA, } from './feedback/index.js';
@@ -77,6 +77,7 @@ P0_SKILLS, DEFAULT_VALIDATION_MODELS,
 TriggerOptimizer, createTriggerOptimizer, parseSkillFrontmatter, 
 // Version Comparator
 VersionComparator, createVersionComparator, } from './validation/index.js';
+export { computeVerificationArtifactDigest, computeVerificationReachManifestHash, createVerificationReachManifest, evaluateVerificationReach, } from './validation/verification-reach.js';
 // Version info - read from package.json
 export const VERSION = pkg.version;
 export const ARCHITECTURE = 'DDD with 13 Bounded Contexts';

package/dist/init/browser-engine-installer.d.ts

@@ -66,6 +66,12 @@ export interface BrowserEngineInstallResult {
      */
     platformHint?: PlatformHint;
 }
+export type BrowserEngineDetectionStatus = 'ready' | 'cli-missing' | 'payload-missing';
+export interface BrowserEngineDetectionResult {
+    status: BrowserEngineDetectionStatus;
+    version?: string;
+    message?: string;
+}
 export interface PlatformHint {
     /**
      * Short machine-readable tag for the condition being reported. Consumers
@@ -111,6 +117,11 @@ export declare function diagnosePlatform(probe?: PlatformProbe): PlatformHint |
  * stdout when both are non-empty. Devil's-advocate review finding H1.
  */
 export declare function detectVibium(spawner?: Spawner, timeoutMs?: number): string | null;
+/**
+ * Detect Vibium readiness without changing the host. A usable browser engine
+ * requires both the CLI and Vibium's same-revision Chrome/chromedriver payload.
+ */
+export declare function detectBrowserEngine(spawner?: Spawner, timeoutMs?: number): BrowserEngineDetectionResult;
 /**
  * Install Vibium via `npm install -g`. Returns a structured result the
  * assets phase can log/summarize — never throws for expected failures.

package/dist/init/browser-engine-installer.js

@@ -113,6 +113,26 @@ export function detectVibium(spawner = defaultSpawner, timeoutMs = 5_000) {
     const match = raw.match(/v?(\d+\.\d+\.\d+(?:[-+][\w.]+)?)/);
     return match ? match[1] : raw.split(/\s+/)[0] || 'unknown';
 }
+/**
+ * Detect Vibium readiness without changing the host. A usable browser engine
+ * requires both the CLI and Vibium's same-revision Chrome/chromedriver payload.
+ */
+export function detectBrowserEngine(spawner = defaultSpawner, timeoutMs = 5_000) {
+    const version = detectVibium(spawner, timeoutMs);
+    if (!version)
+        return { status: 'cli-missing' };
+    const payload = tryRun(spawner, 'vibium', ['is-installed'], timeoutMs);
+    if (payload.status === 0)
+        return { status: 'ready', version };
+    return {
+        status: 'payload-missing',
+        version,
+        message: payload.stderr?.trim() ||
+            payload.stdout?.trim() ||
+            toErrorMessage(payload.error) ||
+            'Vibium Chrome/chromedriver payload is missing or incomplete',
+    };
+}
 /**
  * Install Vibium via `npm install -g`. Returns a structured result the
  * assets phase can log/summarize — never throws for expected failures.
@@ -125,11 +145,11 @@ export function installBrowserEngine(options = {}) {
     const spawner = options.spawner || defaultSpawner;
     const platformProbe = options.platformProbe || defaultPlatformProbe;
     const platformHint = diagnosePlatform(platformProbe);
-    const alreadyInstalled = detectVibium(spawner);
-    if (alreadyInstalled) {
+    const existing = detectBrowserEngine(spawner);
+    if (existing.status === 'ready') {
         return {
             status: 'already-installed',
-            version: alreadyInstalled,
+            version: existing.version,
             packageSpec,
             platformHint,
         };
@@ -156,7 +176,17 @@ export function installBrowserEngine(options = {}) {
                 'unknown npm install failure',
         };
     }
-    const version = detectVibium(spawner) || 'unknown';
-    return { status: 'installed', version, packageSpec, platformHint };
+    const verified = detectBrowserEngine(spawner);
+    if (verified.status !== 'ready') {
+        const reason = verified.message ? `: ${verified.message}` : '';
+        return {
+            status: 'install-failed',
+            packageSpec,
+            platformHint,
+            message: `npm completed, but Vibium readiness verification failed (${verified.status})${reason}. ` +
+                `Run \`npm install -g ${packageSpec}\`, then verify with \`vibium is-installed\`.`,
+        };
+    }
+    return { status: 'installed', version: verified.version, packageSpec, platformHint };
 }
 //# sourceMappingURL=browser-engine-installer.js.map

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

@@ -12,12 +12,16 @@ export interface CodexInstallerOptions {
     installMcp?: boolean;
     /** Install optional Ruflo guidance, adapter, runtime, and lifecycle groups. */
     includeRuflo?: boolean;
+    /** Eager AGENTS.md guidance policy. Defaults to full. */
+    guidancePolicy?: CodexGuidancePolicy;
     /**
      * 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)
      */
     memoryBackend?: 'memory' | 'sqlite' | 'agentdb' | 'hybrid';
 }
+export type CodexGuidancePolicy = 'full' | 'compact' | 'none';
+export declare const CODEX_COMPACT_GUIDANCE_MAX_BYTES = 512;
 export interface CodexInstallResult {
     success: boolean;
     mcpConfigured: boolean;
@@ -29,6 +33,8 @@ export interface CodexInstallResult {
     agentsMdPath: string;
     hooksPath: string;
     skillsPath: string;
+    guidancePolicy: CodexGuidancePolicy;
+    ownedGuidanceBytes: number;
     /** Per-component outcomes. Legacy booleans above remain supported. */
     components: {
         mcp: CodexComponentOutcome;
@@ -70,7 +76,11 @@ export declare class CodexInstaller {
      * Merge AQE section into existing AGENTS.md.
      * Replaces a previously marked AQE section or appends a new marked section.
      */
-    private mergeExistingAgentsMd;
+    private mergeExistingAgentsMdContent;
+    private removeOwnedAgentsSections;
+    private measureOwnedAgentsSection;
+    private assertOwnedAgentsSectionsWellFormed;
+    private ownedAgentsPattern;
     private markAgentsSection;
 }
 export declare function createCodexInstaller(options: CodexInstallerOptions): CodexInstaller;

package/dist/init/codex-installer.js

@@ -11,6 +11,10 @@ import { fileURLToPath } from 'url';
 import { toErrorMessage } from '../shared/error-utils.js';
 import { selectCodexSkills } from './codex-skill-manifest.js';
 import { createPlatformConfigGenerator, } from './platform-config-generator.js';
+export const CODEX_COMPACT_GUIDANCE_MAX_BYTES = 512;
+const COMPACT_CODEX_GUIDANCE = `# Agentic QE
+
+Preserve project data, especially .agentic-qe/memory.db. Read affected code and tests before editing, validate inputs at system boundaries, and run focused checks before broader gates. Discover AQE tools and skills from their live schemas.`;
 // ============================================================================
 // Codex Installer Class
 // ============================================================================
@@ -39,6 +43,8 @@ export class CodexInstaller {
             agentsMdPath: '',
             hooksPath: join(this.projectRoot, '.codex', 'hooks.json'),
             skillsPath: join(this.projectRoot, '.agents', 'skills'),
+            guidancePolicy: this.options.guidancePolicy ?? 'full',
+            ownedGuidanceBytes: 0,
             components: {
                 mcp: { status: 'skipped' },
                 rules: { status: 'skipped' },
@@ -76,24 +82,52 @@ export class CodexInstaller {
             this.recordComponentFailure(result, 'mcp', error);
         }
         try {
-            // Generate AGENTS.md behavioral rules
+            const policy = this.options.guidancePolicy ?? 'full';
             const rules = this.generator.generateBehavioralRules('codex');
             const agentsMdPath = join(this.projectRoot, rules.path);
             result.agentsMdPath = agentsMdPath;
             const rulesExist = existsSync(agentsMdPath);
-            if (!rulesExist || this.overwrite) {
-                if (rulesExist && this.overwrite) {
-                    const merged = this.mergeExistingAgentsMd(agentsMdPath, rules.content);
-                    writeFileSync(agentsMdPath, merged);
+            if (policy === 'none') {
+                if (!rulesExist) {
+                    result.components.rules.status = 'skipped';
                 }
                 else {
-                    writeFileSync(agentsMdPath, this.markAgentsSection(rules.content));
+                    const existing = readFileSync(agentsMdPath, 'utf-8');
+                    const updated = this.removeOwnedAgentsSections(existing);
+                    if (updated !== existing) {
+                        writeFileSync(agentsMdPath, updated);
+                        result.components.rules.status = 'updated';
+                    }
+                    else {
+                        result.components.rules.status = 'preserved';
+                    }
                 }
+            }
+            else if (!rulesExist) {
+                const content = policy === 'compact' ? COMPACT_CODEX_GUIDANCE : rules.content;
+                const marked = this.markAgentsSection(content);
+                writeFileSync(agentsMdPath, marked);
                 result.agentsMdInstalled = true;
-                result.components.rules.status = rulesExist ? 'updated' : 'installed';
+                result.ownedGuidanceBytes = Buffer.byteLength(marked);
+                result.components.rules.status = 'installed';
+            }
+            else if (this.overwrite || policy === 'compact') {
+                const content = policy === 'compact' ? COMPACT_CODEX_GUIDANCE : rules.content;
+                const existing = readFileSync(agentsMdPath, 'utf-8');
+                const merged = this.mergeExistingAgentsMdContent(existing, content);
+                if (merged !== existing) {
+                    writeFileSync(agentsMdPath, merged);
+                    result.agentsMdInstalled = true;
+                    result.components.rules.status = 'updated';
+                }
+                else {
+                    result.components.rules.status = 'preserved';
+                }
+                result.ownedGuidanceBytes = this.measureOwnedAgentsSection(merged);
             }
             else {
                 result.components.rules.status = 'preserved';
+                result.ownedGuidanceBytes = this.measureOwnedAgentsSection(readFileSync(agentsMdPath, 'utf-8'));
             }
         }
         catch (error) {
@@ -163,12 +197,21 @@ export class CodexInstaller {
             }
         }
         const generatedSource = JSON.parse(readFileSync(sourceConfig, 'utf-8'));
-        const isRufloGroup = (value) => JSON.stringify(value).includes('ruflo-codex-hook.cjs');
+        const withoutRufloHooks = (groups) => groups.flatMap((group) => {
+            if (!group || typeof group !== 'object')
+                return [group];
+            const candidate = group;
+            if (!Array.isArray(candidate.hooks)) {
+                return JSON.stringify(group).includes('ruflo-codex-hook.cjs') ? [] : [group];
+            }
+            const hooks = candidate.hooks.filter((hook) => !JSON.stringify(hook).includes('ruflo-codex-hook.cjs'));
+            return hooks.length > 0 ? [{ ...candidate, hooks }] : [];
+        });
         const generated = {
             ...generatedSource,
             hooks: Object.fromEntries(Object.entries(generatedSource.hooks || {}).map(([event, groups]) => [
                 event,
-                this.options.includeRuflo ? groups : groups.filter((group) => !isRufloGroup(group)),
+                this.options.includeRuflo ? groups : withoutRufloHooks(groups),
             ])),
         };
         const targetConfig = join(targetCodexDir, 'hooks.json');
@@ -290,23 +333,46 @@ export class CodexInstaller {
      * Merge AQE section into existing AGENTS.md.
      * Replaces a previously marked AQE section or appends a new marked section.
      */
-    mergeExistingAgentsMd(agentsMdPath, newContent) {
-        const existing = readFileSync(agentsMdPath, 'utf-8');
-        const marked = this.markAgentsSection(newContent);
-        const start = CodexInstaller.AGENTS_START;
-        const end = CodexInstaller.AGENTS_END;
-        const startIndex = existing.indexOf(start);
-        if (startIndex >= 0) {
-            const endIndex = existing.indexOf(end, startIndex);
-            if (endIndex >= 0) {
-                return existing.slice(0, startIndex) + marked
-                    + existing.slice(endIndex + end.length);
-            }
+    mergeExistingAgentsMdContent(existing, newContent) {
+        this.assertOwnedAgentsSectionsWellFormed(existing);
+        const eol = existing.includes('\r\n') ? '\r\n' : '\n';
+        const marked = this.markAgentsSection(newContent, eol);
+        let replaced = false;
+        const merged = existing.replace(this.ownedAgentsPattern(), () => {
+            if (replaced)
+                return '';
+            replaced = true;
+            return marked;
+        });
+        if (replaced)
+            return merged;
+        if (existing.length === 0)
+            return marked;
+        return existing.trimEnd() + `${eol}${eol}---${eol}${eol}` + marked;
+    }
+    removeOwnedAgentsSections(existing) {
+        this.assertOwnedAgentsSectionsWellFormed(existing);
+        return existing.replace(this.ownedAgentsPattern(), '');
+    }
+    measureOwnedAgentsSection(content) {
+        this.assertOwnedAgentsSectionsWellFormed(content);
+        const match = content.match(this.ownedAgentsPattern());
+        return match ? Buffer.byteLength(match[0]) : 0;
+    }
+    assertOwnedAgentsSectionsWellFormed(content) {
+        const starts = content.match(/<!-- BEGIN AGENTIC-QE CODEX -->/g)?.length ?? 0;
+        const ends = content.match(/<!-- END AGENTIC-QE CODEX -->/g)?.length ?? 0;
+        const complete = content.match(this.ownedAgentsPattern())?.length ?? 0;
+        if (starts !== ends || complete !== starts) {
+            throw new Error('Malformed Agentic QE Codex sentinel in AGENTS.md; file was preserved');
         }
-        return existing.trimEnd() + '\n\n---\n\n' + marked;
     }
-    markAgentsSection(content) {
-        return `${CodexInstaller.AGENTS_START}\n${content.trim()}\n${CodexInstaller.AGENTS_END}\n`;
+    ownedAgentsPattern() {
+        return /<!-- BEGIN AGENTIC-QE CODEX -->[\s\S]*?<!-- END AGENTIC-QE CODEX -->(?:\r?\n)?/g;
+    }
+    markAgentsSection(content, eol = '\n') {
+        const normalized = content.trim().replace(/\r?\n/g, eol);
+        return `${CodexInstaller.AGENTS_START}${eol}${normalized}${eol}${CodexInstaller.AGENTS_END}${eol}`;
     }
 }
 // ============================================================================

package/dist/init/init-wizard-hooks.js

@@ -53,7 +53,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" guard --file "$TOOL_INPUT_file_path" --json',
-                        timeout: 3000,
+                        timeout: 3,
                         continueOnError: true,
                     },
                 ],
@@ -64,7 +64,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-edit --file "$TOOL_INPUT_file_path" --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],
@@ -75,7 +75,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-command --command "$TOOL_INPUT_command" --json',
-                        timeout: 3000,
+                        timeout: 3,
                         continueOnError: true,
                     },
                 ],
@@ -86,7 +86,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-task --description "$TOOL_INPUT_prompt" --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],
@@ -99,7 +99,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-edit --file "$TOOL_INPUT_file_path" --success --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],
@@ -110,7 +110,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-command --command "$TOOL_INPUT_command" --success true --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],
@@ -121,7 +121,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-task --task-id "$TOOL_RESULT_agent_id" --agent "$TOOL_INPUT_subagent_type" --success true --description "$TOOL_INPUT_prompt" --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],
@@ -136,7 +136,7 @@ export async function configureHooks(projectRoot, config) {
                         // var, so we let the CLI read stdin directly.
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" route --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],
@@ -148,7 +148,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" session-start --session-id "$SESSION_ID" --json',
-                        timeout: 10000,
+                        timeout: 10,
                         continueOnError: true,
                     },
                 ],
@@ -160,7 +160,7 @@ export async function configureHooks(projectRoot, config) {
                     {
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" session-end --save-state --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],
@@ -173,7 +173,7 @@ export async function configureHooks(projectRoot, config) {
                         // sentinels accumulate at quality_score=-1 indefinitely.
                         type: 'command',
                         command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-route --success true --json',
-                        timeout: 5000,
+                        timeout: 5,
                         continueOnError: true,
                     },
                 ],

package/dist/init/orchestrator.js

@@ -43,6 +43,7 @@ export class ModularInitOrchestrator {
                 withRooCode: options.withRooCode || allPlatforms,
                 withCodex: options.withCodex || allPlatforms,
                 withRuflo: options.withRuflo,
+                codexGuidance: options.codexGuidance,
                 withWindsurf: options.withWindsurf || allPlatforms,
                 withContinueDev: options.withContinueDev || allPlatforms,
                 withAllPlatforms: options.withAllPlatforms,
@@ -156,6 +157,7 @@ export class ModularInitOrchestrator {
                 mcpConfigured: mcpResult?.data?.configured ?? false,
                 claudeMdGenerated: claudeMdResult?.data?.generated ?? false,
                 workersStarted: workersResult?.data?.workersConfigured ?? 0,
+                codexGuidance: assetsResult?.data?.codexGuidance,
             },
             totalDurationMs: Date.now() - startTime,
             timestamp: new Date(),

package/dist/init/phases/07-hooks.d.ts

@@ -55,7 +55,7 @@ export declare class HooksPhase extends BasePhase<HooksResult> {
     /**
      * Install the resilient hook shim (aqe-hook.cjs) into .claude/hooks/.
      * The generated settings.json hooks run `node .../aqe-hook.cjs <cmd>` — the
-     * shim resolves a project-local AQE bundle (or falls back to npx), strips
+     * shim resolves a project-local AQE bundle (or an installed aqe binary), strips
      * init noise from stdout, swallows stderr, and always exits 0.
      */
     private installHookShim;
@@ -72,8 +72,8 @@ export declare class HooksPhase extends BasePhase<HooksResult> {
     /**
      * Generate hooks configuration
      *
-     * Uses `npx agentic-qe` for portability - works without global installation.
-     * All hooks use --json output for structured data and fail silently with continueOnError.
+     * Timeout values use Claude Code's native seconds unit. The shim itself uses
+     * a smaller millisecond budget so it can record failures before the host stops it.
      */
     private generateHooksConfig;
 }