@xuda.io/ai_module 1.1.5638 → 1.1.5639

package/index.mjs

@@ -4738,6 +4738,154 @@ export const diagnose_vps_snapshot = async function (req) {
   }
 };
 
+// Map a studio program's menuType to a friendly, user-facing noun so the
+// release-notes prompt talks about "screens" and "workflows" rather than the
+// internal type ids. Unknown types fall back to a de-underscored label.
+const _human_menu_type = function (t) {
+  const map = {
+    component: 'screen',
+    workflow: 'workflow',
+    table: 'data table',
+    javascript: 'logic',
+    js: 'logic',
+    ai_agent: 'AI agent',
+    api: 'API',
+    style: 'style',
+    function: 'function',
+    query: 'query',
+    report: 'report',
+  };
+  return map[t] || (t ? String(t).replace(/_/g, ' ') : 'item');
+};
+
+// Generate user-facing release notes for a build the developer is about to
+// create. READ-ONLY: reads the project's PUBLISHED studio programs, diffs them
+// against the previous release's timestamp to see what changed since the last
+// build, and asks the model for a concise, plain-language changelog. Never
+// writes the release or mutates a program — the notes are returned for the
+// developer to review/edit before they hit Build. Credits are metered to the
+// caller via submit_chat_gpt_prompt -> record_ai_usage.
+// req: { app_id, version?, build_type?(major|minor|patch), instructions? }
+// -> { code:1, data:{ notes, changed_count, since_build, version } }
+//    { code:-6, insufficient_credits:true } when the account is out of credits.
+export const generate_release_notes = async function (req) {
+  const uid = req.uid || req.token_ret?.data?.uid;
+  const app_id_in = req.app_id;
+  const version = String(req.version || '').trim();
+  const build_type = String(req.build_type || '').trim(); // major | minor | patch
+  const steer = String(req.instructions || '')
+    .trim()
+    .slice(0, 400); // optional free-text hint from the developer
+
+  if (!uid) return { code: -1, data: 'not authorized' };
+  if (!app_id_in) return { code: -1, data: 'app_id required' };
+
+  // Credit gate — usage is metered, but block up-front if the account is
+  // already out (validate_credits_limit RETURNS the error, never throws).
+  const credit_err = await validate_credits_limit(uid, null, _conf.release_notes?.model || _conf.default_ai_model, 'release notes');
+  if (credit_err) return { code: -6, data: credit_err.message || 'insufficient credits', insufficient_credits: true };
+
+  // Resolve to the project (master) app — build/release data lives there.
+  let app_obj;
+  let app_ref;
+  try {
+    app_ref = await _common.get_project_app_id(app_id_in, true);
+    const app_ret = await db_module.get_app_obj(app_ref);
+    if (app_ret.code < 0 || !app_ret.data) return { code: -1, data: 'app not found' };
+    app_obj = app_ret.data;
+  } catch (e) {
+    return { code: -1, data: 'app not found' };
+  }
+
+  const app_name = app_obj.app_name || 'the app';
+  const prev_version = app_obj.app_publish_info?.version || '';
+  const last_build = app_obj.app_publish_info?.app_lastBuild || 0;
+
+  // Cutoff = the previous release's timestamp. Any program whose `ts`
+  // (last-saved time) is newer than this changed since that build.
+  let since_ts = 0;
+  try {
+    const rel = await db_module.find_app_couch_query(app_ref, {
+      selector: { docType: 'release', stat: { $lt: 4 } },
+      sort: [{ build_id: 'desc' }],
+      limit: 1,
+    });
+    since_ts = rel.docs?.[0]?.date || 0;
+  } catch (e) {
+    since_ts = 0;
+  }
+
+  // Published programs, projected to a tiny summary (bounds prompt tokens).
+  let progs = [];
+  try {
+    const res = await db_module.find_app_couch_query(app_ref, {
+      selector: { docType: 'studio', stat: 3 },
+      fields: ['ts', 'properties.menuType', 'properties.menuName', 'properties.menuTitle'],
+      limit: 99999,
+    });
+    progs = res.docs || [];
+  } catch (e) {
+    progs = [];
+  }
+
+  const first_build = !since_ts || last_build === 0;
+  const changed = progs.filter((p) => p && (first_build || (p.ts && p.ts > since_ts))).sort((a, b) => (b.ts || 0) - (a.ts || 0));
+
+  // Compact, deduped change list for the prompt (name + type; capped at 80).
+  const seen = new Set();
+  const items = [];
+  for (const p of changed) {
+    const name = p.properties?.menuTitle || p.properties?.menuName || 'Untitled';
+    const type = _human_menu_type(p.properties?.menuType);
+    const key = `${type}:${name}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    items.push({ name, type });
+    if (items.length >= 80) break;
+  }
+
+  const by_type = {};
+  for (const it of items) by_type[it.type] = (by_type[it.type] || 0) + 1;
+  const type_summary = Object.entries(by_type)
+    .map(([t, n]) => `${n} ${t}${n > 1 ? 's' : ''}`)
+    .join(', ');
+
+  const parts = [
+    `You are writing end-user release notes for a no-code app called "${app_name}" built on the Xuda platform.`,
+    `The developer is publishing a new build to every deployment of this app. Write short, friendly, user-facing release notes that tell the people who USE the app what is new — in plain language, not technical jargon.`,
+    '',
+    'RULES:',
+    '- Output ONLY 2 to 5 concise bullet points, each a single short line. No title, no preamble, no sign-off — bullets only.',
+    '- Describe outcomes and improvements ("New School Info screen", "Faster class enrollment"), never internal file names or program types.',
+    '- Group related changes into one bullet instead of listing every item.',
+    '- Neutral, professional tone. Never invent features that the change list does not imply.',
+    '- Write in the SAME language as the program names below (e.g. Hebrew names -> Hebrew notes).',
+    steer ? `- The developer added this guidance — follow it: ${steer}` : '',
+    '',
+    `Version: ${prev_version ? prev_version + ' -> ' : ''}${version || '(new)'}${build_type ? `  (${build_type} release)` : ''}`,
+    first_build ? 'This is the FIRST published build. Write a brief "initial release" style note highlighting the main areas of the app.' : `Programs changed since the last build (${type_summary || 'general updates'}):`,
+    items.length ? items.map((it) => `- ${it.name} (${it.type})`).join('\n') : '(No specific program changes were detected — write a brief note about minor improvements and stability fixes.)',
+  ].filter(Boolean);
+
+  // account_profile_info is REQUIRED for usage to be metered: record_ai_usage
+  // throws (and skips broadcast_credits, so the nav meter never moves) without
+  // it. Fetch it like classify_external_app_scan / the chat flows do.
+  const account_profile_info = await get_active_account_profile_info(uid);
+
+  const ret = await submit_chat_gpt_prompt({
+    uid,
+    prompt: parts.join('\n'),
+    model: _conf.release_notes?.model || _conf.default_ai_model,
+    metadata: { func: 'generate_release_notes', app_id: app_ref, version },
+    account_profile_info,
+  });
+  if (ret.code < 0) return { code: -1, data: ret.data };
+
+  const notes = String(ret.data || '').trim();
+  if (!notes) return { code: -1, data: 'no notes generated' };
+  return { code: 1, data: { notes, changed_count: changed.length, since_build: last_build, version } };
+};
+
 function getFirstNWords(text, n = 10) {
   // Split on whitespace, keep punctuation attached to words
   const words = text.match(/\S+/g) || [];

package/index_ms.mjs

@@ -133,6 +133,10 @@ export const diagnose_vps_snapshot = async function (...args) {
   return await broker.send_to_queue("diagnose_vps_snapshot", ...args);
 };
 
+export const generate_release_notes = async function (...args) {
+  return await broker.send_to_queue("generate_release_notes", ...args);
+};
+
 export const create_openai_conversation = async function (...args) {
   return await broker.send_to_queue("create_openai_conversation", ...args);
 };

package/index_msa.mjs

@@ -133,6 +133,10 @@ export const diagnose_vps_snapshot =  function (...args) {
    broker.send_to_queue_async("diagnose_vps_snapshot", ...args);
 };
 
+export const generate_release_notes =  function (...args) {
+   broker.send_to_queue_async("generate_release_notes", ...args);
+};
+
 export const create_openai_conversation =  function (...args) {
    broker.send_to_queue_async("create_openai_conversation", ...args);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xuda.io/ai_module",
-  "version": "1.1.5638",
+  "version": "1.1.5639",
   "description": "Xuda AI Module",
   "main": "index.mjs",
   "type": "module",