oxe-cc 1.7.0 → 1.8.0

package/bin/lib/oxe-project-health.cjs

@@ -809,19 +809,40 @@ function copilotLegacyHome() {
   return path.join(os.homedir(), '.copilot');
 }
 
-function copilotLegacyPaths() {
-  const root = copilotLegacyHome();
-  return {
-    root,
-    promptsDir: path.join(root, 'prompts'),
-    instructions: path.join(root, 'copilot-instructions.md'),
-  };
-}
-
-/**
- * @param {string} filePath
- */
-function readJsonFileSafe(filePath) {
+function copilotLegacyPaths() {
+  const root = copilotLegacyHome();
+  return {
+    root,
+    promptsDir: path.join(root, 'prompts'),
+    instructions: path.join(root, 'copilot-instructions.md'),
+  };
+}
+
+function expandHomePath(value) {
+  if (typeof value !== 'string') return value;
+  if (value === '~') return os.homedir();
+  if (value.startsWith('~/') || value.startsWith('~\\')) return path.join(os.homedir(), value.slice(2));
+  return value;
+}
+
+function codexHome() {
+  if (process.env.CODEX_HOME) return path.resolve(expandHomePath(process.env.CODEX_HOME));
+  return path.join(os.homedir(), '.codex');
+}
+
+function codexIntegrationPaths() {
+  const root = codexHome();
+  return {
+    root,
+    promptsDir: path.join(root, 'prompts'),
+    skillsRoot: path.join(os.homedir(), '.agents', 'skills'),
+  };
+}
+
+/**
+ * @param {string} filePath
+ */
+function readJsonFileSafe(filePath) {
   if (!fs.existsSync(filePath)) return { ok: false, data: null, error: null };
   try {
     return { ok: true, data: JSON.parse(fs.readFileSync(filePath, 'utf8')), error: null };
@@ -1270,19 +1291,45 @@ function summarizeEnterpriseRuntime(target, activeRun, activeSession, config) {
  * @param {string} dir
  * @returns {string[]}
  */
-function listOxePromptFiles(dir) {
-  if (!fs.existsSync(dir)) return [];
-  return fs
-    .readdirSync(dir, { withFileTypes: true })
-    .filter((entry) => entry.isFile() && /^oxe-.*\.prompt\.md$/i.test(entry.name))
+function listOxePromptFiles(dir) {
+  if (!fs.existsSync(dir)) return [];
+  return fs
+    .readdirSync(dir, { withFileTypes: true })
+    .filter((entry) => entry.isFile() && /^oxe-.*\.prompt\.md$/i.test(entry.name))
     .map((entry) => path.join(dir, entry.name))
-    .sort();
-}
-
-/**
- * @param {string} filePath
- * @returns {boolean}
- */
+    .sort();
+}
+
+/**
+ * @param {string} dir
+ * @returns {string[]}
+ */
+function listOxeCodexPromptFiles(dir) {
+  if (!fs.existsSync(dir)) return [];
+  return fs
+    .readdirSync(dir, { withFileTypes: true })
+    .filter((entry) => entry.isFile() && (entry.name === 'oxe.md' || /^oxe-.*\.md$/i.test(entry.name)))
+    .map((entry) => path.join(dir, entry.name))
+    .sort();
+}
+
+/**
+ * @param {string} root
+ * @returns {string[]}
+ */
+function listOxeSkillDirs(root) {
+  if (!fs.existsSync(root)) return [];
+  return fs
+    .readdirSync(root, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && /^oxe($|-)/i.test(entry.name) && fs.existsSync(path.join(root, entry.name, 'SKILL.md')))
+    .map((entry) => path.join(root, entry.name))
+    .sort();
+}
+
+/**
+ * @param {string} filePath
+ * @returns {boolean}
+ */
 function hasOxeInstructionBlock(filePath) {
   if (!fs.existsSync(filePath)) return false;
   const text = fs.readFileSync(filePath, 'utf8');
@@ -1430,13 +1477,67 @@ function copilotIntegrationReport(target) {
     },
     manifest,
     warnings,
-  };
-}
-
-/**
- * Valida o arquivo plan-agents.json (se existir) e retorna avisos.
- * @param {string} target
- * @returns {string[]}
+  };
+}
+
+/**
+ * @param {string} target
+ */
+function codexIntegrationReport(target) {
+  const paths = codexIntegrationPaths();
+  const promptFiles = listOxeCodexPromptFiles(paths.promptsDir);
+  const skillDirs = listOxeSkillDirs(paths.skillsRoot);
+  const promptNames = promptFiles.map((filePath) => path.basename(filePath));
+  const skillNames = skillDirs.map((dirPath) => path.basename(dirPath));
+  const promptPathWarnings = [];
+  for (const filePath of promptFiles) {
+    for (const warning of promptWorkflowPathWarnings(filePath, target)) promptPathWarnings.push(warning);
+  }
+
+  /** @type {string[]} */
+  const warnings = [];
+  const detected = promptFiles.length > 0 || skillDirs.length > 0;
+  const commandsReady = promptNames.includes('oxe.md');
+  const skillsReady = skillNames.includes('oxe');
+  if (detected && promptFiles.length === 0) {
+    warnings.push('Codex tem skills OXE instaladas, mas ~/.codex/prompts não contém prompts OXE; a barra / não listará /oxe.');
+  }
+  if (promptFiles.length > 0 && !commandsReady) {
+    warnings.push('Codex prompts OXE existem, mas o entrypoint principal oxe.md está ausente.');
+  }
+  if (skillDirs.length > 0 && !skillsReady) {
+    warnings.push('Codex skills OXE existem, mas o skill raiz oxe está ausente.');
+  }
+  if (promptFiles.length > 0 && skillDirs.length === 0) {
+    warnings.push('Codex prompts OXE existem, mas ~/.agents/skills não contém skills OXE; recursos especializados podem não aparecer.');
+  }
+  for (const warning of promptPathWarnings) warnings.push(warning);
+
+  let status = 'not_installed';
+  if (commandsReady && skillsReady && promptPathWarnings.length === 0) {
+    status = warnings.length ? 'warning' : 'healthy';
+  } else if (detected) {
+    status = commandsReady ? 'warning' : 'broken';
+  }
+
+  return {
+    status,
+    detected,
+    commandsReady,
+    skillsReady,
+    root: paths.root,
+    promptsDir: paths.promptsDir,
+    skillsRoot: paths.skillsRoot,
+    promptFiles,
+    skillDirs,
+    warnings,
+  };
+}
+
+/**
+ * Valida o arquivo plan-agents.json (se existir) e retorna avisos.
+ * @param {string} target
+ * @returns {string[]}
  */
 function planAgentsWarnings(target) {
   const p = oxePaths(target);
@@ -2221,10 +2322,12 @@ function buildHealthReport(target) {
     ...planAgentsWarnings(target),
   ];
   const planWarn = suppressExecutionWorkspaceGates ? [] : executionPlanWarn;
-  const sessionWarn = sessionWarnings(target, activeSession);
+  const sessionWarn = sessionWarnings(target, activeSession);
   const installWarn = installationCompletenessWarnings(target);
   const copilot = copilotIntegrationReport(target);
   const copilotWarn = copilot.warnings;
+  const codex = codexIntegrationReport(target);
+  const codexWarn = codex.warnings;
   const reviewWarn = suppressExecutionWorkspaceGates ? [] : planReviewWarnings(stateText, p);
   const planSelfEvaluation = {
     ...parsedPlanSelfEvaluation,
@@ -2418,10 +2521,11 @@ function buildHealthReport(target) {
     planWarningCount +
     capabilityWarn.length +
     investigationWarn.length +
-    sessionWarn.length +
-    installWarn.length +
-    copilotWarn.length +
-    contextWarn.length +
+    sessionWarn.length +
+    installWarn.length +
+    copilotWarn.length +
+    codexWarn.length +
+    contextWarn.length +
     semanticsWarn.length +
     (azureReport ? azureReport.warnings.length : 0) +
     (sumWarn ? 1 : 0);
@@ -2450,9 +2554,11 @@ function buildHealthReport(target) {
     installWarn,
     copilotWarn,
     contextWarn,
-    semanticsWarn,
-    copilot,
-    summaryGapWarn: sumWarn,
+    semanticsWarn,
+    copilot,
+    codexWarn,
+    codex,
+    summaryGapWarn: sumWarn,
     specWarn,
     planWarn,
     planSelfEvaluation,
@@ -2532,9 +2638,11 @@ module.exports = {
   parsePlanReviewStatus,
   isStaleScan,
   isStaleLessons,
-  copilotWorkspacePaths,
-  copilotLegacyPaths,
+  copilotWorkspacePaths,
+  copilotLegacyPaths,
   copilotIntegrationReport,
+  codexIntegrationPaths,
+  codexIntegrationReport,
   normalizePlanConfidenceThreshold,
   isExecutablePlanConfidence,
   hasExecutablePlanSelfEvaluation,