projecta-rrr 1.23.1 → 1.23.3

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to RRR will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.23.3] - 2026-04-20
+
+### Fixed
+- **Codex agent config self-healing** — installer now rewrites `~/.codex/agents/*.toml` from the repo source and prunes stale generated files so legacy Codex-only fields cannot survive across installs.
+
+## [1.23.2] - 2026-04-20
+
+### Fixed
+- **Codex agent TOML `developer_instructions`** — Codex 0.122.0 requires this field; generator now extracts the first 3000 chars of each agent's markdown body as the system prompt using TOML literal multi-line strings (no escaping needed).
+- **MCP 406 for Codex rmcp clients** — Codex's Rust rmcp client does not send `Accept: application/json, text/event-stream`; server now normalizes the header before the SDK validates it so the connection succeeds.
+
 ## [1.23.1] - 2026-04-20
 
 ### Fixed

package/bin/install.js

@@ -2219,7 +2219,9 @@ function install(isGlobal) {
         verbose: false
       });
       if (agentResult.errors.length === 0) {
-        console.log(`  ${green}✓${reset} Installed ${agentResult.written.length} Codex agent configs to ~/.codex/agents/`);
+        const removedCount = agentResult.removed.length;
+        const removedText = removedCount > 0 ? `, pruned ${removedCount} stale configs` : '';
+        console.log(`  ${green}✓${reset} Installed ${agentResult.written.length} Codex agent configs to ~/.codex/agents/${removedText}`);
       } else {
         console.log(`  ${yellow}⚠${reset} Installed ${agentResult.written.length} agent configs (${agentResult.errors.length} errors)`);
         agentResult.errors.slice(0, 3).forEach(e => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.23.1",
+  "version": "1.23.3",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js",

package/rrr/lib/codex-agent-gen.js

@@ -20,6 +20,8 @@ const TIER_MAP = {
   inherit: { tier: 'ADAPTIVE', model: 'gpt-4o', fallback_model: 'o1' },
 };
 
+const LEGACY_TOP_LEVEL_FIELDS = ['tier', 'fallback_model'];
+
 /**
  * Parse the YAML frontmatter from a markdown string.
  *
@@ -75,6 +77,21 @@ function extractField(lines, key) {
   return null;
 }
 
+/**
+ * Guard against old Codex-only metadata leaking into generated TOML.
+ *
+ * Current Codex CLI agent files accept only name, description, model, and
+ * developer_instructions. Legacy tier/fallback_model keys cause Codex to
+ * reject the entire agent definition, so we fail fast if they ever reappear.
+ */
+function assertNoLegacyTopLevelFields(toml, filename) {
+  for (const field of LEGACY_TOP_LEVEL_FIELDS) {
+    if (new RegExp(`^\\s*${field}\\s*=`, 'm').test(toml)) {
+      throw new Error(`Generated ${filename} contains unsupported field "${field}"`);
+    }
+  }
+}
+
 /**
  * Convert a single RRR agent markdown file (Claude Code format) into
  * a Codex-compatible TOML agent config string.
@@ -84,7 +101,7 @@ function extractField(lines, key) {
  * @returns {string} Generated TOML string for ~/.codex/agents/<basename>.toml
  */
 function generateCodexAgentToml(sourceMarkdown, filename) {
-  const { frontmatterLines } = parseFrontmatter(sourceMarkdown);
+  const { frontmatterLines, body } = parseFrontmatter(sourceMarkdown);
 
   // Extract fields from frontmatter
   const nameField = extractField(frontmatterLines, 'name');
@@ -97,7 +114,12 @@ function generateCodexAgentToml(sourceMarkdown, filename) {
   // Look up tier mapping; default to STANDARD (sonnet) if model not found
   const tierEntry = TIER_MAP[modelField] || TIER_MAP.sonnet;
 
-  // Build TOML lines — only fields Codex CLI accepts
+  // developer_instructions: body of the markdown file (the system prompt).
+  // Truncated to 3000 chars; uses TOML literal multi-line strings (''') which
+  // need zero escaping — safe as long as the body contains no ''' sequence.
+  const instructions = body.trim().slice(0, 3000);
+
+  // Build TOML — only fields Codex CLI accepts
   const lines = [
     '# Generated by projecta-rrr — do not edit manually',
     `# Source: agents/${filename}`,
@@ -105,9 +127,14 @@ function generateCodexAgentToml(sourceMarkdown, filename) {
     `name = "${agentName}"`,
     `description = "${descriptionField || agentName}"`,
     `model = "${tierEntry.model}"`,
+    `developer_instructions = '''`,
+    instructions,
+    `'''`,
   ];
 
-  return lines.join('\n') + '\n';
+  const toml = lines.join('\n') + '\n';
+  assertNoLegacyTopLevelFields(toml, filename);
+  return toml;
 }
 
 /**
@@ -122,7 +149,7 @@ function generateCodexAgentToml(sourceMarkdown, filename) {
  * @param {string}  options.targetDir - Absolute path to target directory (e.g. ~/.codex/agents/)
  * @param {boolean} [options.dryRun=false] - If true, compute paths but skip writing
  * @param {boolean} [options.verbose=false] - If true, log each file written
- * @returns {{ written: string[], skipped: string[], errors: Array<{file: string, error: string}> }}
+ * @returns {{ written: string[], skipped: string[], removed: string[], errors: Array<{file: string, error: string}> }}
  */
 function installCodexAgents(options) {
   const {
@@ -134,6 +161,7 @@ function installCodexAgents(options) {
 
   const written = [];
   const skipped = [];
+  const removed = [];
   const errors = [];
 
   // Ensure target directory exists (no-op if already exists)
@@ -181,7 +209,26 @@ function installCodexAgents(options) {
     }
   }
 
-  return { written, skipped, errors };
+  if (!dryRun) {
+    const managedFiles = new Set(written);
+    try {
+      const existingTargets = fs.readdirSync(targetDir);
+      for (const targetEntry of existingTargets) {
+        if (!targetEntry.endsWith('.toml')) {
+          continue;
+        }
+        if (managedFiles.has(targetEntry)) {
+          continue;
+        }
+        fs.unlinkSync(path.join(targetDir, targetEntry));
+        removed.push(targetEntry);
+      }
+    } catch (err) {
+      errors.push({ file: targetDir, error: `Cannot prune targetDir: ${err.message}` });
+    }
+  }
+
+  return { written, skipped, removed, errors };
 }
 
 module.exports = {