openuispec 0.1.27 → 0.1.29

package/schema/openuispec.schema.json

@@ -111,6 +111,16 @@
             "type": "string"
           }
         },
+        "code_roots": {
+          "type": "object",
+          "description": "Additional project code roots used as generation context.",
+          "properties": {
+            "backend": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
         "output_format": {
           "type": "object",
           "description": "Per-target generation config",

package/schema/semantic-lint.ts

@@ -1,6 +1,7 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
 import YAML from "yaml";
+import { listFiles } from "../drift/index.js";
 
 type UnknownRecord = Record<string, unknown>;
 
@@ -19,6 +20,7 @@ export interface UsageLint {
 }
 
 interface SemanticContext {
+  manifest: unknown;
   localeFiles: Map<string, Set<string>>;
   formatterNames: Set<string>;
   mapperNames: Set<string>;
@@ -66,17 +68,6 @@ function loadData(filePath: string): unknown {
   return filePath.endsWith(".json") ? loadJson(filePath) : loadYaml(filePath);
 }
 
-function listFiles(dir: string, ext: string): string[] {
-  try {
-    return readdirSync(dir)
-      .filter((file) => file.endsWith(ext))
-      .sort()
-      .map((file) => join(dir, file));
-  } catch {
-    return [];
-  }
-}
-
 function isRecord(value: unknown): value is UnknownRecord {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -281,6 +272,7 @@ function buildContext(projectDir: string, includes: Includes): SemanticContext {
       : localeFiles.keys().next().value ?? null;
 
   return {
+    manifest,
     localeFiles,
     formatterNames,
     mapperNames,
@@ -552,6 +544,37 @@ function lintLocaleCoverage(context: SemanticContext): UsageLint[] {
   return errors;
 }
 
+function lintManifestGenerationContext(projectDir: string, manifest: unknown): UsageLint[] {
+  if (!isRecord(manifest)) return [];
+
+  const hasApiEndpoints =
+    isRecord(manifest.api) &&
+    isRecord(manifest.api.endpoints) &&
+    Object.keys(manifest.api.endpoints).length > 0;
+  if (!hasApiEndpoints) return [];
+
+  const generation = isRecord(manifest.generation) ? manifest.generation : {};
+  const codeRoots = isRecord(generation.code_roots) ? generation.code_roots : null;
+  const backendRoot = codeRoots && typeof codeRoots.backend === "string" ? codeRoots.backend.trim() : "";
+
+  if (!backendRoot) {
+    return [{
+      path: "openuispec.yaml",
+      message: 'api endpoints require generation.code_roots.backend to point at the backend folder',
+    }];
+  }
+
+  const resolvedBackendRoot = resolve(projectDir, backendRoot);
+  if (!existsSync(resolvedBackendRoot)) {
+    return [{
+      path: "openuispec.yaml",
+      message: `generation.code_roots.backend points to a missing folder: ${backendRoot}`,
+    }];
+  }
+
+  return [];
+}
+
 function printSemanticErrors(label: string, errors: UsageLint[]): number {
   if (errors.length === 0) return 0;
   const previewLimit = 10;
@@ -572,6 +595,7 @@ export function runSemanticLint(projectDir: string, includes: Includes): number
   const contractsDir = resolve(projectDir, includes.contracts);
 
   total += printSemanticErrors("locales", lintLocaleCoverage(context));
+  total += printSemanticErrors("openuispec.yaml", lintManifestGenerationContext(projectDir, context.manifest));
 
   const files = [
     join(projectDir, "openuispec.yaml"),

package/schema/validate.ts

@@ -5,7 +5,7 @@
  * Usage:
  *   openuispec validate                    # validate all spec files
  *   openuispec validate tokens screens     # validate specific groups
- *   npm run validate                       # from repo (uses examples/taskflow)
+ *   npm run validate                       # from repo (uses examples/taskflow/openuispec)
  */
 
 import { readFileSync, readdirSync, existsSync } from "node:fs";
@@ -572,9 +572,14 @@ function findProjectDir(cwd: string): string {
     }
   }
   // Fallback for running from repo root with examples/
-  const examplesDir = join(cwd, "examples", "taskflow");
-  if (existsSync(join(examplesDir, "openuispec.yaml"))) {
-    return examplesDir;
+  const exampleCandidates = [
+    join(cwd, "examples", "taskflow", "openuispec"),
+    join(cwd, "examples", "taskflow"),
+  ];
+  for (const dir of exampleCandidates) {
+    if (existsSync(join(dir, "openuispec.yaml"))) {
+      return dir;
+    }
   }
   console.error(
     "Error: No openuispec.yaml found.\n" +

package/status/index.ts

@@ -26,6 +26,7 @@ import { readFileSync } from "node:fs";
 interface TargetStatus {
   target: string;
   output_dir: string;
+  output_exists: boolean;
   snapshot: boolean;
   snapshot_at: string | null;
   baseline: {
@@ -74,12 +75,14 @@ function readState(statePath: string): StateFile {
 
 function buildTargetStatus(cwd: string, projectDir: string, projectName: string, target: string): TargetStatus {
   const outputDir = resolveOutputDir(projectDir, projectName, target);
+  const outputExists = existsSync(outputDir);
   const path = stateFilePath(projectDir, projectName, target);
 
   if (!existsSync(path)) {
     return {
       target,
       output_dir: outputDir,
+      output_exists: outputExists,
       snapshot: false,
       snapshot_at: null,
       baseline: {
@@ -93,7 +96,9 @@ function buildTargetStatus(cwd: string, projectDir: string, projectName: string,
       removed: 0,
       behind: false,
       explain_available: false,
-      note: "No snapshot found for this target.",
+      note: outputExists
+        ? "No snapshot found for this target."
+        : `Output directory not found. Run code generation for "${target}" first.`,
     };
   }
 
@@ -107,6 +112,7 @@ function buildTargetStatus(cwd: string, projectDir: string, projectName: string,
   return {
     target,
     output_dir: outputDir,
+    output_exists: outputExists,
     snapshot: true,
     snapshot_at: state.snapshot_at,
     baseline: {
@@ -147,11 +153,18 @@ function printReport(result: StatusResult): void {
   for (const target of result.targets) {
     const summary = target.snapshot
       ? `${target.changed} changed, ${target.added} added, ${target.removed} removed`
-      : "no snapshot";
-    const status = target.snapshot ? (target.behind ? "behind" : "up to date") : "needs baseline";
+      : target.output_exists
+        ? "no snapshot"
+        : "output missing";
+    const status = target.snapshot
+      ? (target.behind ? "behind" : "up to date")
+      : target.output_exists
+        ? "needs baseline"
+        : "needs generation";
 
     console.log(`${target.target}`);
     console.log(`  output: ${target.output_dir}`);
+    console.log(`  output exists: ${target.output_exists ? "yes" : "no"}`);
     console.log(`  snapshot: ${target.snapshot ? target.snapshot_at : "missing"}`);
     if (target.baseline.label) {
       console.log(`  baseline: ${target.baseline.label}`);