aimeat 1.2.0

package/dist/public/js/services/generator-prompts-test.js

@@ -0,0 +1,402 @@
+/**
+ * @file generator-prompts-test.js
+ * @deprecated DEPRECATED — kept as backup/reference. Prompts now served from database seeds.
+ * @description Test prompt generation for the service generator — produces executable
+ *   test code prompts for server-side (extension, memory, translation, msm) and
+ *   browser-side (cortex, app) component types.
+ * @structure
+ *   - buildTestPrompt: generates test code prompt based on component type and environment
+ * @usage
+ *   import { buildTestPrompt } from '/js/services/generator-prompts-test.js';
+ * @version-history
+ *   v1.0.0 — 2026-03-22 — Extracted from generator-prompts.js
+ *   v2.0.0 — 2026-03-24 — Full rewrite: remove duplication, fix contradictions, single source of truth per concept
+ */
+
+import { INSTRUCTION_DISCLAIMER, SANDBOX_CONSTRAINTS, EXTENSION_CONSUMPTION_RULES } from './generator-prompts-base.js';
+
+export function buildTestPrompt(componentType, componentCode, componentLabel, registeredAs, blueprint, interviewSpec, probeResults) {
+
+  /* ── Blueprint-derived metadata ─────────────────────────── */
+
+  const bpComp = blueprint?.components?.find(c => c.label === componentLabel);
+
+  // Cortex: list of methods to test
+  let cortexMethods = '';
+  if (bpComp && componentType === 'cortex') {
+    const methods = (bpComp.produces || []).filter(p => p.startsWith('api:')).map(p => p.replace('api:', ''));
+    if (methods.length > 0) {
+      cortexMethods = `\n## Cortex Methods to Test (from blueprint — test ALL)
+${methods.map(m => `- ${m}()`).join('\n')}\n`;
+    }
+  }
+
+  // App: list of APIs consumed
+  let appApis = '';
+  if (bpComp && componentType === 'app') {
+    const apis = (bpComp.consumes || []).filter(p => p.startsWith('api:')).map(p => p.replace('api:', ''));
+    if (apis.length > 0) {
+      appApis = `\n## App APIs (verify they work in the UI)
+${apis.map(a => `- ${a}`).join('\n')}\n`;
+    }
+  }
+
+  // Extension: memory keys it writes to (for cleanup instructions)
+  const memoryProduces = (bpComp?.produces || [])
+    .filter(p => p.startsWith('memory:'))
+    .map(p => p.replace('memory:', ''));
+
+  const bpComponents = blueprint?.components?.map(c => `- ${c.id} (${c.type}): ${c.label}`).join('\n') || '';
+
+  const useCases = interviewSpec?.useCases?.map((uc, i) => {
+    if (typeof uc === 'string') return `${i + 1}. ${uc}`;
+    if (uc?.description) return `${i + 1}. ${uc.description}`;
+    if (uc?.title) return `${i + 1}. ${uc.title}`;
+    return `${i + 1}. ${JSON.stringify(uc)}`;
+  }).join('\n') || 'No use cases specified';
+
+  /* ── Test scenarios from blueprint ──────────────────────── */
+
+  let testSection = '';
+  if (blueprint) {
+    const scenarios = (blueprint.testScenarios || [])
+      .filter(ts => bpComp && ts.component === bpComp.id)
+      .flatMap(ts => ts.scenarios || []);
+
+    if (componentType === 'extension' && scenarios.length > 0) {
+      // Cleanup hint — which memory keys to clear
+      if (memoryProduces.length > 0) {
+        testSection += `\n## State to Clean Up at Start
+The extension writes to: ${memoryProduces.map(k => '`' + k + '`').join(', ')}
+Before the first test scenario, clean stale data using the extension's OWN remove/delete actions via callExt.
+Read lists with readExtMemory, call remove for each item, then call init.\n`;
+      }
+
+      testSection += `\n## Test Scenarios (from blueprint)
+
+${scenarios.map((s, i) => {
+        const typeTag = s.type === 'external-api' ? ' [EXTERNAL API]' : ' [MEMORY]';
+        return `${i + 1}. ${s.action}${typeTag}
+   Input: ${JSON.stringify(s.input)}
+   Expected: ${s.expect}`;
+      }).join('\n\n')}
+
+Test EVERY scenario above.
+For [EXTERNAL API]: check response shape only, do NOT assert specific values. Graceful error = PASS.
+For [MEMORY]: assert return values match what the action code returns on success.\n`;
+    }
+
+    if (componentType === 'cortex' && scenarios.length > 0) {
+      testSection += `\n## Test Scenarios (from blueprint — test EXACTLY these)
+
+${scenarios.map((s, i) => `${i + 1}. Call ${s.action}(${JSON.stringify(s.input)})
+   Expected: ${s.expect}`).join('\n\n')}
+
+Test EVERY scenario above.\n`;
+    }
+
+    if (componentType === 'app' && scenarios.length > 0) {
+      testSection += `\n## Test Scenarios (from blueprint — verify in the UI)
+
+${scenarios.map((s, i) => `${i + 1}. ${s.action}: ${s.expect}`).join('\n')}
+\n`;
+    }
+  }
+
+  /* ── Golden samples from probe — real API responses as test reference ── */
+
+  let goldenSection = '';
+  if (probeResults && Array.isArray(probeResults) && probeResults.length > 0) {
+    const successful = probeResults.filter(p => p.status === 200 && p.response);
+    if (successful.length > 0) {
+      goldenSection = `\n## GOLDEN SAMPLES — Real API responses (use these as test reference)
+
+These are ACTUAL responses captured from the live extension. Your test assertions
+MUST match these data shapes. Do NOT invent field names — use exactly what you see here.
+
+${successful.map(p => `### ${p.action}(${JSON.stringify(p.input)})
+\`\`\`json
+${JSON.stringify(p.response, null, 2)}
+\`\`\`
+`).join('\n')}
+When writing assertions, reference the EXACT field names from the golden samples above.
+For example, if the response has \`item: { id: "abc", name: "Test" }\`, assert \`result.item.id\`, NOT \`result.item === "abc"\`.
+`;
+    }
+  }
+
+  /* ── Environment-specific docs ──────────────────────────── */
+
+  const browserEnvDoc = `## Test Environment: Browser (page.evaluate sandbox)
+
+CRITICAL SANDBOX RULES — violating ANY will crash the test:
+- NO import/require/export statements
+- Your code runs inside page.evaluate() in a real browser page
+- You have access to: window, document, fetch, DOM APIs
+- Set results on: window.__testResults = { passed: boolean, errors: string[], details: string }
+
+For CORTEX tests:
+- The cortex library is already loaded on the test page
+- Access it via: window.AIMEAT.{camelCaseName}
+- Authentication IS available — session.fetch() works
+
+## QUALITY REQUIREMENTS (MANDATORY)
+
+Every test MUST follow this pattern for EVERY API call:
+
+1. **Call** — invoke the method with real, meaningful parameters
+2. **Log** — log the FULL response: \`log('method returned: ' + JSON.stringify(result))\`
+3. **Assert not null** — \`if (result === null) fail('method: got null')\`
+4. **Assert shape** — check specific field names and types from the cortex code
+5. **Assert values** — for external APIs, verify arrays have length > 0, objects have expected fields
+6. **Verify side effects** — after writes, READ BACK and check the data is there
+
+NEVER do this:
+\`\`\`
+if (result === null) log('returned null (expected without auth)');  // WRONG — auth IS available
+\`\`\`
+
+ALWAYS do this:
+\`\`\`
+if (result === null) fail('method: returned null — should return data');
+if (!result.items) fail('method: missing items field');
+if (!Array.isArray(result.items)) fail('method: items should be array');
+log('method returned: ' + JSON.stringify(result));
+\`\`\`
+
+## CORTEX TEST EXAMPLE (follow this pattern exactly)
+
+\`\`\`javascript
+const lib = window.AIMEAT.myDomainLib;
+if (!lib) { fail('Library not loaded'); window.__testResults = results; return; }
+
+// 1. INIT — verify readiness
+const initResult = await lib.init();
+log('init returned: ' + JSON.stringify(initResult));
+if (!initResult) fail('init: returned null');
+else if (typeof initResult.ready !== 'boolean') fail('init: missing ready field');
+else pass('init: ready=' + initResult.ready);
+
+// 2. SEARCH — verify real API data comes back
+const searchResult = await lib.search('test query');
+log('search returned: ' + JSON.stringify(searchResult));
+if (!searchResult) fail('search: returned null');
+else if (!Array.isArray(searchResult.items)) fail('search: items should be array');
+else if (searchResult.items.length === 0) fail('search: got empty results for known query');
+else pass('search: got ' + searchResult.items.length + ' results');
+
+// 3. WRITE — add item, then READ BACK to verify
+const addResult = await lib.addItem('test-id', 'Test Name');
+log('addItem returned: ' + JSON.stringify(addResult));
+if (!addResult) fail('addItem: returned null');
+else if (!addResult.success) fail('addItem: success not true');
+
+// 3b. READ BACK — verify the item was actually saved
+const listAfterAdd = await lib.getItems();
+log('getItems after add: ' + JSON.stringify(listAfterAdd));
+if (!listAfterAdd || !listAfterAdd.items) fail('getItems: returned null after add');
+else {
+  const found = listAfterAdd.items.find(i => i.id === 'test-id');
+  if (!found) fail('addItem: item not found in list after add');
+  else pass('addItem: item persisted and readable');
+}
+
+// 4. DELETE — remove item, then READ BACK to verify
+const removeResult = await lib.removeItem('test-id');
+log('removeItem returned: ' + JSON.stringify(removeResult));
+if (!removeResult) fail('removeItem: returned null');
+
+// 4b. READ BACK — verify removal
+const listAfterRemove = await lib.getItems();
+log('getItems after remove: ' + JSON.stringify(listAfterRemove));
+if (listAfterRemove && listAfterRemove.items) {
+  const stillThere = listAfterRemove.items.find(i => i.id === 'test-id');
+  if (stillThere) fail('removeItem: item still in list after remove');
+  else pass('removeItem: item removed successfully');
+}
+
+// 5. ERROR HANDLING — test with invalid input
+const badResult = await lib.getItem(null);
+log('getItem(null) returned: ' + JSON.stringify(badResult));
+// Should return null or error, not crash
+pass('getItem(null): handled gracefully');
+
+window.__testResults = results;
+\`\`\`
+
+Apply this EXACT pattern to the component under test. Use the actual method names and field names from the component code.
+${cortexMethods}
+For APP tests:
+- The app is already loaded on the test page
+- Authentication IS available
+- Wait for data to render: await new Promise(r => setTimeout(r, 3000));
+- Check DOM elements, click buttons, verify results
+- Verify actual content renders (not translation keys like "search.title")
+- Verify API calls return real data visible in the UI
+${appApis}`;
+
+  const serverEnvDoc = `## Test Environment: Server-side sandbox (new Function)
+
+CRITICAL SANDBOX RULES — violating ANY will crash the test:
+- NO import/require/export statements
+- You are inside an async function body. Just write sequential code.
+- Available variables: testFetch, baseUrl, callExt, readExtMemory
+- No Node.js APIs, no fs, no path, no process
+
+Available helpers:
+
+  // LOW-LEVEL: raw HTTP call (use only for memory/translation tests, NOT for extensions)
+  const resp = await testFetch(url, { method, body, headers });
+  // resp = { status, ok, body }. Auth token injected automatically.
+
+  // HIGH-LEVEL: call extension action (PREFERRED for extension tests)
+  const result = await callExt('ext-name', 'actionId', { key: 'value' });
+  // Returns action's return value directly (envelope unwrapped)
+
+  // HIGH-LEVEL: read extension memory
+  const data = await readExtMemory('ext-name', 'memory.key');
+  // Returns value from ext:{name} namespace, or null
+
+Your code MUST end with: return { passed: boolean, errors: string[], details: string }
+
+## Test Idempotency
+Tests MUST work on every run — first run or re-run after previous failure.
+Before the first scenario, clean stale data using the extension's OWN actions:
+  1. Read lists with readExtMemory
+  2. Call remove/delete actions for each existing item
+  3. Call init
+
+## JavaScript Pitfalls
+- NEVER compare arrays/objects with === or !== (\`value !== []\` is ALWAYS true). Use \`Array.isArray(v) && v.length === 0\`.
+- Check null with \`=== null\`, not \`== null\`.
+
+## Example (server-side extension test)
+\`\`\`
+const errors = [];
+
+// CLEANUP: remove stale data via extension actions
+const existing = await readExtMemory('${registeredAs}', 'items.list');
+if (existing && Array.isArray(existing)) {
+  for (const item of existing) {
+    await callExt('${registeredAs}', 'removeItem', { id: item.id });
+  }
+}
+
+// [MEMORY] init
+const r0 = await callExt('${registeredAs}', 'init', {});
+if (!r0) errors.push('init: no response');
+else if (r0.error) errors.push('init: ' + r0.error);
+
+// [EXTERNAL API] — check shape only
+const r1 = await callExt('${registeredAs}', 'fetchData', { query: 'test' });
+if (r1 === null) errors.push('fetchData: no response at all');
+
+// [MEMORY] error handling
+const r2 = await callExt('${registeredAs}', 'addItem', {});
+if (r2 === null) errors.push('addItem(empty): no response');
+else if (!r2.error) errors.push('addItem(empty): no error for invalid input');
+
+return { passed: errors.length === 0, errors, details: 'Tested N actions' };
+\`\`\`
+
+For MEMORY component tests:
+- Write with PUT /v1/memory/{key}, read with GET, verify, cleanup
+
+For TRANSLATION tests:
+- Read the translation key, verify it has content`;
+
+  const testEnvDoc = (componentType === 'cortex' || componentType === 'app')
+    ? browserEnvDoc
+    : serverEnvDoc;
+
+  /* ── Assemble final prompt ──────────────────────────────── */
+
+  return `${INSTRUCTION_DISCLAIMER}You are generating TEST CODE for a component in an AIMEAT service.
+
+## Component Under Test
+- Type: ${componentType}
+- Label: ${componentLabel}
+- Registered as: ${registeredAs || 'unknown'}
+${goldenSection}${testSection}
+## Data Structures (from blueprint — test against THESE shapes)
+${blueprint?.dataModel?.structures ? Object.entries(blueprint.dataModel.structures).map(([name, schema]) =>
+    `### ${name}\n\`\`\`json\n${JSON.stringify(schema, null, 2)}\n\`\`\``
+  ).join('\n\n') : 'No structures defined'}
+
+## Action Contracts (from blueprint — test THESE methods with THESE shapes)
+${blueprint?.dataModel?.actions ? Object.entries(blueprint.dataModel.actions).map(([name, def]) =>
+    `- **${name}**: input=${JSON.stringify(def.input || {})}, output=${def.output?.$ref ? '$ref:' + def.output.$ref : JSON.stringify(def.output || 'any')}`
+  ).join('\n') : 'No actions defined'}
+
+## Project Context
+Blueprint components:
+${bpComponents}
+
+Use cases from interview:
+${useCases}
+
+${testEnvDoc}
+
+## Platform Rules
+${componentType === 'extension' ? SANDBOX_CONSTRAINTS + '\n\n' : ''}${EXTENSION_CONSUMPTION_RULES}
+
+## Output Rules
+1. Return ONLY executable JavaScript code — NO markdown fences, NO explanation text
+2. NO import/require/export — sandbox environment
+3. Self-contained async function body
+4. Server tests: return { passed, errors, details }
+5. Browser tests: set window.__testResults = { passed, errors, details }`;
+}
+
+/**
+ * Build a test-first prompt for extensions — generates test BEFORE the extension code.
+ * The test acts as a specification: the extension must pass this test.
+ * @param {object} blueprint - The full blueprint with structures and actions
+ * @param {object} interviewSpec - The interview spec with data sources
+ * @returns {string} Test prompt that produces test code from the contract only
+ */
+export function buildExtensionTestFirstPrompt(blueprint, interviewSpec) {
+  const structures = blueprint?.dataModel?.structures || {};
+  const actions = blueprint?.dataModel?.actions || {};
+  const extActions = Object.entries(actions).filter(([k]) => k.startsWith('ext:'));
+
+  const structuresText = Object.entries(structures).map(([name, schema]) =>
+    `### ${name}\n\`\`\`json\n${JSON.stringify(schema, null, 2)}\n\`\`\``
+  ).join('\n\n');
+
+  const scenariosText = extActions.map(([key, def]) => {
+    const actionId = key.replace('ext:', '');
+    const inputStr = JSON.stringify(def.input || {});
+    const outputRef = def.output?.$ref || 'object';
+    return `- **${actionId}**(${inputStr}) → must return shape matching ${outputRef}`;
+  }).join('\n');
+
+  const testCompany = interviewSpec?.dataSources?.[0]?.sampleEntry;
+  const testEntity = testCompany ? JSON.stringify(testCompany).substring(0, 300) : 'use realistic test data';
+
+  return `${INSTRUCTION_DISCLAIMER}
+Generate TEST CODE for an extension that does not exist yet.
+This test defines WHAT the extension must do — it is a specification.
+
+## Data Structures (the extension must produce data matching these)
+${structuresText}
+
+## Actions to Test
+${scenariosText}
+
+## Test Data Reference
+${testEntity}
+
+## Environment
+Server-side sandbox. Available: callExt(extName, actionId, body), readExtMemory(extName, key).
+callExt returns the action's result (envelope unwrapped). readExtMemory returns the memory value.
+
+## Rules
+- Test each action listed above
+- For actions that call external APIs: check response SHAPE matches the structure, graceful error = PASS
+- For actions that only use memory: assert specific return values
+- The extension name will be provided when the test runs — use a placeholder like 'EXT_NAME'
+- Return ONLY executable JavaScript. No markdown fences.
+- End with: return { passed: boolean, errors: string[], details: string }
+`;
+}

package/dist/public/js/services/generator-prompts.js

@@ -0,0 +1,31 @@
+/**
+ * @file generator-prompts.js
+ * @description Re-export hub for generator prompt modules. Preserves backward
+ *   compatibility — all existing import sites continue to work unchanged.
+ *   The actual implementations live in:
+ *   - generator-prompts-base.js (constants, templates, helpers)
+ *   - generator-prompts-build.js (blueprint, interview, component prompts)
+ *   - generator-prompts-test.js (test prompts)
+ *   - generator-prompts-fix.js (fix, impact, edit prompts)
+ * @usage
+ *   import { buildBlueprintPrompt, buildComponentPrompt } from '/js/services/generator-prompts.js';
+ * @version-history
+ *   v1.0.0 — 2026-03-10 — Initial prompt templates
+ *   ...
+ *   v10.2.0 — 2026-03-21 — Replace full code injection with compact API summaries
+ *   v11.0.0 — 2026-03-22 — Split into sub-modules, converted to re-export hub
+ *   v11.1.0 — 2026-03-26 — V5: re-export verifyContract, smokeTest, validateSpecQuality, reconcileProbe
+ */
+export { AIMEAT_CONTEXT, INSTRUCTION_DISCLAIMER, COMPONENT_TEMPLATES } from './generator-prompts-base.js';
+export { buildBlueprintPrompt, buildInterviewPrompt, buildComponentPrompt } from './generator-prompts-build.js';
+export { buildTestPrompt, buildExtensionTestFirstPrompt } from './generator-prompts-test.js';
+export { buildBlueprintFixPrompt, buildFixPrompt, buildReflectionPrompt, buildExplainPrompt, buildFreshGenerationPrompt, buildImpactPrompt, buildEditPrompt } from './generator-prompts-fix.js';
+// New V5 modules
+export { buildDataCortexPrompt } from './generator-prompts-cortex-data.js';
+export { buildFeatureCortexPrompt } from './generator-prompts-cortex-feature.js';
+export { buildAppDomainCortexPrompt } from './generator-prompts-cortex-app.js';
+export { createBundle, formatBundleForPrompt, formatBundlesForPrompt } from './generator-context-bundle.js';
+// V5 utility modules — browser-only (use browser-path imports like /lib/yaml.mjs, /js/api.js)
+// NOT re-exported here because this hub is imported server-side by src/routes/generator.ts.
+// Import directly in browser code: ./generator-contract.js, ./generator-smoke.js,
+// ./generator-validate.js, ./generator-probe-reconcile.js

package/dist/public/js/services/generator-smoke.js

@@ -0,0 +1,65 @@
+/**
+ * @file generator-smoke.js
+ * @description Smoke tests for generator components — quick load/parse checks
+ *   that catch 80% of failures in seconds before running full test suites.
+ * @usage
+ *   import { smokeTest } from '/js/services/generator-smoke.js';
+ *   const result = await smokeTest('extension', 'prh-tiedonhaku', session);
+ * @version-history
+ *   v1.0.0 — 2026-03-26 — Initial smoke test module
+ */
+
+import { apiPost, apiGet } from '/js/api.js';
+
+/**
+ * Run a quick smoke test on a registered component.
+ * @param {string} type - Component type: 'extension', 'cortex', 'app'
+ * @param {string} registeredAs - The registered name of the component
+ * @param {object} session - Auth session for API calls
+ * @returns {{ passed: boolean, error: string|null }}
+ */
+export async function smokeTest(type, registeredAs, session) {
+  try {
+    if (type === 'extension') {
+      // Can it activate without crashing?
+      const resp = await apiPost(`/v1/extensions/${encodeURIComponent(registeredAs)}/activate`);
+      if (!resp || resp.error) {
+        return { passed: false, error: `Activation failed: ${resp?.error?.message || 'unknown error'}` };
+      }
+      return { passed: true, error: null };
+    }
+
+    if (type === 'cortex') {
+      // Can the JS file load without errors?
+      const libUrl = `/v1/cortex/${encodeURIComponent(registeredAs)}/libs/${encodeURIComponent(registeredAs)}.js`;
+      const resp = await fetch(libUrl);
+      if (!resp.ok) {
+        return { passed: false, error: `Cortex lib not accessible: HTTP ${resp.status}` };
+      }
+      const code = await resp.text();
+      // Basic syntax check — try to parse as a function
+      try {
+        new Function(code);
+      } catch (e) {
+        return { passed: false, error: `Cortex JS syntax error: ${e.message}` };
+      }
+      return { passed: true, error: null };
+    }
+
+    if (type === 'app') {
+      // Can the HTML load without errors?
+      const owner = session?.owner || '';
+      const appUrl = `/v1/apps/${encodeURIComponent(owner)}/${encodeURIComponent(registeredAs)}`;
+      const resp = await fetch(appUrl);
+      if (!resp.ok) {
+        return { passed: false, error: `App not accessible: HTTP ${resp.status}` };
+      }
+      return { passed: true, error: null };
+    }
+
+    // Other types (CSM, memory, translation) don't need smoke tests
+    return { passed: true, error: null };
+  } catch (e) {
+    return { passed: false, error: `Smoke test error: ${e.message}` };
+  }
+}