feat(generator): enhance buildBrowserEntrypointResult with validation flow

- Add page context validation step with deps.validatePageContext
- Change validation failure status from 'error' to 'blocked'
- Add row normalization partial detection
- Use buildArtifact for all return paths consistently
- Add COLUMNS and REPORT_NAME constants for buildArtifact
- Export determineArtifactStatus, COLUMNS, REPORT_NAME in module.exports

🤖 Generated with [Qoder][https://qoder.com]

src/generated_scene/generator.rs

@@ -291,6 +291,10 @@ const STATIC_PARAMS = {static_params_json};
 
 const COLUMN_DEFS = {column_defs_json};
 
+const COLUMNS = {columns_json};
+
+const REPORT_NAME = '{scene_id}';
+
 function normalizePayload(payload) {{
   if (typeof payload === 'string') {{
     try {{ return JSON.parse(payload); }} catch (_) {{ return {{}}; }}
@@ -404,44 +408,59 @@ const defaultDeps = {{
 }};
 
 async function buildBrowserEntrypointResult(args, deps = defaultDeps) {{
+  // 1. Parameter validation
   const validation = validateArgs(args);
   if (!validation.valid) {{
-    return {{
+    return buildArtifact({{
-      type: 'report-artifact',
+      status: 'blocked',
-      report_name: '{scene_id}',
+      blockedReason: 'validation_failed',
-      status: 'error',
+      reasons: validation.errors,
-      error: 'Validation failed: ' + validation.errors.join(', '),
-      column_defs: COLUMN_DEFS,
-      columns: {columns_json},
       rows: [],
-      counts: {{ detail_rows: 0 }},
+      args
-      partial_reasons: [],
+    }});
-      reasons: validation.errors
-    }};
   }}
-  
+
+  // 2. Page context validation
+  const pageValidation = typeof deps.validatePageContext === 'function'
+    ? deps.validatePageContext(args)
+    : {{ ok: true }};
+  if (!pageValidation?.ok) {{
+    return buildArtifact({{
+      status: 'blocked',
+      blockedReason: pageValidation?.reason || 'page_context_mismatch',
+      reasons: [pageValidation?.reason || 'page_context_mismatch'],
+      rows: [],
+      args
+    }});
+  }}
+
+  // 3. Data fetching
+  const reasons = [];
+  let rawData = null;
   try {{
-    const rawData = await (deps.queryData ? deps.queryData(args) : Promise.resolve([]));
+    rawData = await (deps.queryData ? deps.queryData(args) : Promise.resolve([]));
-    const rows = normalizeRows(rawData);
-    return buildArtifact({{ args, rows }});
   }} catch (error) {{
-    return {{
+    return buildArtifact({{
-      type: 'report-artifact',
-      report_name: '{scene_id}',
       status: 'error',
-      error: error.message,
+      fatalError: error.message,
-      column_defs: COLUMN_DEFS,
+      reasons: ['api_query_failed:' + error.message],
-      columns: {columns_json},
       rows: [],
-      counts: {{ detail_rows: 0 }},
+      args
-      partial_reasons: [],
+    }});
-      reasons: [error.message]
-    }};
   }}
+
+  // 4. Row normalization
+  const rows = normalizeRows(rawData);
+  if (rows.length === 0 && Array.isArray(rawData) && rawData.length > 0) {{
+    reasons.push('row_normalization_partial');
+  }}
+
+  // 5. Build artifact
+  return buildArtifact({{ reasons, rows, args }});
 }}
 
 if (typeof module !== 'undefined') {{
-  module.exports = {{ buildBrowserEntrypointResult, normalizePayload, validateArgs, buildRequest, normalizeRows, buildArtifact, API_ENDPOINTS, STATIC_PARAMS, COLUMN_DEFS }};
+  module.exports = {{ buildBrowserEntrypointResult, normalizePayload, validateArgs, buildRequest, normalizeRows, buildArtifact, determineArtifactStatus, API_ENDPOINTS, STATIC_PARAMS, COLUMN_DEFS, COLUMNS, REPORT_NAME }};
 }}
 
 if (typeof args !== 'undefined') {{