Function checkCodexReadiness

core/codex/native-integrations.js:816–865

(options = {})

  writeText(dashboardPath, renderAppServerDashboard(summary, { source: options.source }));
  return {
    projectRoot,
    summaryPath,
    dashboardPath,
    summary,
  };
}

function checkCodexReadiness(options = {}) {
  const projectRoot = path.resolve(options.projectRoot || process.cwd());
  const checks = [];
  const add = (id, pass, detail, improvement) => checks.push({ id, pass: Boolean(pass), detail, improvement });

  const manifestPath = path.join(projectRoot, '.codex-plugin', 'plugin.json');
  const manifest = readJsonIfExists(manifestPath, { allowLineComment: true });
  add('plugin-manifest', Boolean(manifest), manifestPath, 'Codex can discover Citadel as a plugin instead of ad hoc prompts.');
  if (manifest) {
    const skillsPath = manifest.skills ? path.resolve(projectRoot, manifest.skills) : null;
    const hooksPath = manifest.hooks ? path.resolve(projectRoot, manifest.hooks) : null;
    const mcpPath = manifest.mcpServers ? path.resolve(projectRoot, manifest.mcpServers) : null;
    add('plugin-description', !/claude/i.test(manifest.description || '') && /codex/i.test(`${manifest.description || ''} ${manifest.interface?.shortDescription || ''}`), manifest.description, 'Prevents Codex users from seeing stale Claude-specific packaging.');
    add('plugin-skills-path', skillsPath && fs.existsSync(skillsPath), skillsPath || 'missing', 'Skills are loaded from a real plugin path.');
    add('plugin-hooks-path', hooksPath && fs.existsSync(hooksPath), hooksPath || 'missing', 'Lifecycle safety hooks are bundled with the plugin.');
    add('plugin-mcp-path', mcpPath && fs.existsSync(mcpPath), mcpPath || 'missing', 'Codex can load Citadel state through MCP.');
  }

  const configPath = path.join(projectRoot, '.codex', 'config.toml');
  const config = readTextIfExists(configPath);
  add('codex-config', Boolean(config), configPath, 'Project installs have Codex feature flags and MCP wiring.');
  add('feature-hooks', /\bhooks\s*=\s*true\b/.test(config) && !/\bcodex_hooks\s*=\s*true\b/.test(config), 'canonical hooks feature', 'Uses the current hooks feature key and rejects deprecated output.');
  add('mcp-citadel-state', /\[mcp_servers\.citadel-state\]/.test(config), 'citadel-state MCP config', 'Codex can query planning and verification state directly.');

  const agentsDir = path.join(projectRoot, '.codex', 'agents');
  const agentCount = fs.existsSync(agentsDir)
    ? fs.readdirSync(agentsDir).filter((name) => name.endsWith('.toml')).length
    : 0;
  add('codex-agents', agentCount > 0, `${agentCount} agent manifest(s)`, 'Citadel agents can map to native Codex subagents.');

  const agentsMd = path.join(projectRoot, 'AGENTS.md');
  const agentsText = readTextIfExists(agentsMd);
  add('agents-guidance', Boolean(agentsText), agentsMd, 'Codex gets project and review guidance before work starts.');
  add('review-guidelines', /review guidelines/i.test(agentsText), 'Review guidelines section', 'Codex GitHub review can follow repository-specific review rules.');

  const artifacts = verifyAppArtifacts({ projectRoot, requireExistingPaths: false });
  add('artifact-manifest-readable', artifacts.pass, `${artifacts.count} artifact record(s)`, 'Codex app evidence can be discovered after QA and live-preview runs.');

  const report = {
    projectRoot,
    checkedAt: nowIso(options),
    checks,
    pass: checks.every((check) => check.pass),
  };

  if (options.write) {