openuispec 0.1.39 → 0.1.40

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.39",
+  "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,
   };
 }