openuispec 0.1.38 → 0.1.40

package/README.md

@@ -265,6 +265,13 @@ OpenUISpec includes an MCP (Model Context Protocol) server that exposes CLI comm
 }
 ```
 
+**Codex** (`.codex/config.toml`):
+```toml
+[mcp_servers.openuispec]
+command = "openuispec"
+args = ["mcp"]
+```
+
 Or run directly: `openuispec mcp`
 
 Set `OPENUISPEC_PROJECT_DIR` to override the working directory.

package/cli/init.ts

@@ -489,13 +489,42 @@ const EXPECTED_MCP_CONFIG = {
  *
  * All use the same { mcpServers: { openuispec: { command, args } } } shape.
  */
-const MCP_CONFIG_PATHS = [
+const JSON_MCP_PATHS = [
   ".mcp.json",
   join(".vscode", "mcp.json"),
 ];
 
+/** Codex uses TOML: .codex/config.toml */
+const CODEX_CONFIG_PATH = join(".codex", "config.toml");
+const CODEX_MCP_BLOCK = `\n[mcp_servers.openuispec]\ncommand = "openuispec"\nargs = ["mcp"]\n`;
+
+function configureCodexMcp(cwd: string, quiet: boolean): void {
+  const codexDir = join(cwd, ".codex");
+  if (!existsSync(codexDir)) return;
+
+  const configPath = join(codexDir, "config.toml");
+  try {
+    let content = "";
+    try {
+      content = readFileSync(configPath, "utf-8");
+    } catch {
+      // file doesn't exist — will create
+    }
+
+    if (content.includes("[mcp_servers.openuispec]")) {
+      if (!quiet) console.log(`  skip ${CODEX_CONFIG_PATH} (openuispec MCP already configured)`);
+      return;
+    }
+
+    writeFileSync(configPath, content + CODEX_MCP_BLOCK);
+    if (!quiet) console.log(`  ${content ? "update" : "create"} ${CODEX_CONFIG_PATH} (MCP server configured)`);
+  } catch {
+    if (!quiet) console.log(`  skip ${CODEX_CONFIG_PATH} (could not configure MCP server)`);
+  }
+}
+
 function configureMcp(cwd: string, showRestart: boolean, quiet: boolean = false): void {
-  for (const relPath of MCP_CONFIG_PATHS) {
+  for (const relPath of JSON_MCP_PATHS) {
     const configPath = join(cwd, relPath);
 
     // .vscode/mcp.json: only write if .vscode/ already exists
@@ -529,6 +558,9 @@ function configureMcp(cwd: string, showRestart: boolean, quiet: boolean = false)
     }
   }
 
+  // Codex: .codex/config.toml (TOML format)
+  configureCodexMcp(cwd, quiet);
+
   if (showRestart) console.log(`\n  Restart your AI coding agent to activate the MCP server.`);
 
   // Clean up stale .claude.json MCP config from older versions

package/mcp-server/index.ts

@@ -68,7 +68,10 @@ Spec files (YAML) are the single source of truth for all UI across platforms.
 
 MANDATORY WORKFLOW for any UI-related request (screens, navigation, layout, tokens, flows, localization):
 1. BEFORE writing or modifying any UI code, call openuispec_prepare with the target platform.
-   This returns the spec context, platform config, and generation constraints you must follow.
+   This returns the spec context, platform config, generation constraints, AND the full contents
+   of every spec file (tokens, screens, flows, contracts, locales, platform overrides).
+   Use the spec_contents field as the authoritative source — do NOT paraphrase from memory.
+   Cross-reference exact token values, contract must_handle lists, and locale keys from the inline content.
 2. If the request requires spec changes, update the spec files FIRST, then call openuispec_check to validate.
 3. Only then generate or update the platform UI code based on the prepare output.
 
@@ -82,7 +85,7 @@ or explicitly platform-specific polish that doesn't affect shared UI semantics.`
 server.registerTool(
   "openuispec_prepare",
   {
-    description: "Build AI-ready work bundle for a target platform. REQUIRED before any UI code generation. Returns spec context, platform config, semantic changes, and generation constraints.",
+    description: "Build AI-ready work bundle for a target platform. REQUIRED before any UI code generation. Returns spec context, platform config, semantic changes, generation constraints, AND the full contents of every spec file inline. Use spec_contents as the authoritative source for tokens, screens, contracts, and locales — do not paraphrase from memory.",
     inputSchema: { target: targetSchema },
   },
   async ({ target }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openuispec",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "license": "MIT",
   "type": "module",
   "description": "A semantic UI specification format for AI-native, platform-native app development",

package/prepare/index.ts

@@ -116,6 +116,12 @@ interface PrepareBootstrapBundle {
   reference_examples: string[];
 }
 
+interface SpecFileContent {
+  path: string;
+  category: string;
+  content: string;
+}
+
 export interface PrepareResult {
   mode: "bootstrap" | "update";
   project: string;
@@ -138,6 +144,7 @@ export interface PrepareResult {
   explanation_note?: string;
   items: PrepareItem[];
   bootstrap?: PrepareBootstrapBundle;
+  spec_contents: SpecFileContent[];
   next_steps: string[];
 }
 
@@ -842,6 +849,17 @@ function generationWarnings(target: string, platformConfig: PreparePlatformConfi
   return warnings;
 }
 
+function readAllSpecContents(projectDir: string): SpecFileContent[] {
+  return discoverSpecFiles(projectDir).map((filePath) => {
+    const relPath = relative(projectDir, filePath);
+    return {
+      path: relPath,
+      category: categorizeSpecFile(relPath),
+      content: readFileSync(filePath, "utf-8"),
+    };
+  });
+}
+
 function bootstrapSpecFiles(projectDir: string, target: string): BootstrapSpecFile[] {
   return discoverSpecFiles(projectDir)
     .map((filePath) => {
@@ -1106,6 +1124,7 @@ function buildBootstrapPrepareResult(cwd: string, target: string): PrepareResult
     changes_available: false,
     explanation_note: "No snapshot exists yet. This is a first-time generation bundle.",
     items: [],
+    spec_contents: readAllSpecContents(projectDir),
     bootstrap: {
       output_exists: existsSync(outputDir),
       generation_ready: missingDecisions.length === 0 && backendContextReady && !pendingUserConfirmation,
@@ -1176,6 +1195,7 @@ function buildUpdatePrepareResult(cwd: string, target: string): PrepareResult {
     changes_available: result.explanation?.available ?? false,
     explanation_note: result.explanation?.note,
     items,
+    spec_contents: readAllSpecContents(projectDir),
     next_steps: nextSteps,
   };
 }