@gurulu/cli 0.3.4 → 0.4.1

package/dist/index.js

@@ -30,12 +30,17 @@ const identity_1 = require("./commands/identity");
 const playground_1 = require("./commands/playground");
 // Phase 20 W3 C4 — audit log tail/export
 const audit_1 = require("./commands/audit");
+// Goals & Funnels CRUD
+const goals_1 = require("./commands/goals");
+const funnels_1 = require("./commands/funnels");
 // Gurulu Chat — NL → SQL analytics
 const chat_1 = require("./commands/chat");
 // Error tracking — source map upload
 const sourcemap_1 = require("./commands/sourcemap");
 // Phase 21 — database connect
 const db_1 = require("./commands/db");
+// Sprint B Group VII B14 — live event stream
+const watch_1 = require("./commands/watch");
 (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
     .scriptName('gurulu')
     .option('profile', { type: 'string', describe: 'Use a specific profile (default: personal)' })
@@ -153,13 +158,19 @@ const db_1 = require("./commands/db");
     yes: args.yes,
     profile: args.profile,
 }))
-    .command('events <action>', 'View events ingested by Gurulu (list, tail)', (y) => y
-    .positional('action', { type: 'string', describe: 'list | tail' })
+    .command('events <action>', 'Manage events (list, tail, schema, define, verify, templates)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | tail | schema | define | verify | templates' })
     .option('site', { type: 'string', describe: 'Site ID' })
-    .option('event-name', { type: 'string', describe: 'Filter by event name' })
+    .option('event-name', { type: 'string', describe: 'Event name (for schema/define/list)' })
     .option('filter', { type: 'string', describe: 'Filter expression (event_name:...)' })
     .option('since', { type: 'string', describe: 'ISO timestamp or 1h/24h/7d' })
     .option('limit', { type: 'number', describe: 'Max rows (1..500)' })
+    .option('display-name', { type: 'string', describe: 'Human-readable display name (define)' })
+    .option('description', { type: 'string', describe: 'Event description (define)' })
+    .option('category', { type: 'string', describe: 'Category: acquisition|activation|retention|revenue|referral|compliance|support|engagement (define)' })
+    .option('properties', { type: 'string', describe: 'Property schema as JSON array (define)' })
+    .option('event', { type: 'string', describe: 'Check a specific event only (verify)' })
+    .option('vertical', { type: 'string', describe: 'Business vertical for templates (ecommerce, saas, fintech, igaming, etc.)' })
     .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => {
     (0, events_1.eventsCommand)({
         action: args.action,
@@ -170,6 +181,12 @@ const db_1 = require("./commands/db");
         limit: args.limit,
         json: args.json,
         profile: args.profile,
+        displayName: args['display-name'],
+        description: args.description,
+        category: args.category,
+        properties: args.properties,
+        event: args.event,
+        vertical: args.vertical,
     });
 })
     .command('status', 'Check SDK health and connection', (y) => y
@@ -208,7 +225,7 @@ const db_1 = require("./commands/db");
     .option('skip-env', { type: 'boolean', describe: 'Skip .env file merge' })
     .option('yes', { type: 'boolean', alias: 'y', describe: 'Non-interactive (assume yes)' })
     .option('ingest-url', { type: 'string', describe: 'Override ingest base URL' })
-    .option('verify', { type: 'boolean', default: true, describe: 'Live smoke test after install' })
+    .option('verify', { type: 'boolean', default: false, describe: 'Live smoke test after install (requires playwright-core)' })
     .option('skip-intent', { type: 'boolean', describe: 'Skip install-time intent discovery' })
     .option('intent-dry-run', { type: 'boolean', describe: 'Show intent proposal without pre-seeding' })
     .option('vertical', { type: 'string', describe: 'Vertical hint for intent analyzer' })
@@ -269,12 +286,28 @@ const db_1 = require("./commands/db");
     });
 })
     // ── Phase 19.5 W2 — read-surface subcommands ─────────────────────────
-    .command('audiences <action> [target]', 'View audiences (list, show)', (y) => y
-    .positional('action', { type: 'string', describe: 'list | show' })
+    .command('audiences <action> [target]', 'Manage audiences (list, show, create, update, delete)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show | create | update | delete' })
     .positional('target', { type: 'string', describe: 'Audience name or id' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('id', { type: 'string', describe: 'Audience ID (for update/delete)' })
+    .option('name', { type: 'string', describe: 'Audience name' })
+    .option('description', { type: 'string', describe: 'Audience description' })
+    .option('rules', { type: 'string', describe: 'Audience rules (JSON array)' })
+    .option('from-file', { type: 'string', describe: 'Load payload from JSON file' })
+    .option('dry-run', { type: 'boolean', describe: 'Show what would be done' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' })
     .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, audiences_1.audiencesCommand)({
     action: args.action,
     target: args.target,
+    site: args.site,
+    id: args.id,
+    name: args.name,
+    description: args.description,
+    rules: args.rules,
+    fromFile: args['from-file'],
+    dryRun: args['dry-run'],
+    yes: args.yes,
     json: args.json,
     profile: args.profile,
 }))
@@ -287,20 +320,44 @@ const db_1 = require("./commands/db");
     json: args.json,
     profile: args.profile,
 }))
-    .command('alerts <action> [sub] [target]', 'View anomaly alerts (list, show <id>, channels list)', (y) => y
-    .positional('action', { type: 'string', describe: 'list | show | channels' })
+    .command('alerts <action> [sub] [target]', 'Manage alerts (list, show, create, update, delete, channels)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show | create | update | delete | channels' })
     .positional('sub', { type: 'string', describe: 'Subaction (e.g. list for channels)' })
     .positional('target', { type: 'string', describe: 'Alert id (for show)' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('id', { type: 'string', describe: 'Alert ID (for update/delete)' })
+    .option('name', { type: 'string', describe: 'Alert rule name' })
+    .option('type', { type: 'string', describe: 'Alert type (threshold, anomaly)' })
+    .option('metric', { type: 'string', describe: 'Alert metric' })
+    .option('threshold-type', { type: 'string', describe: 'Threshold type (count_per_minute, value, etc.)' })
+    .option('threshold-value', { type: 'number', describe: 'Threshold value' })
+    .option('channel', { type: 'string', describe: 'Channel ID for alert delivery' })
     .option('severity', { type: 'string', describe: 'low | medium | high | critical' })
     .option('acknowledged', { type: 'string', describe: 'true | false' })
+    .option('note', { type: 'string', describe: 'Note for update' })
     .option('limit', { type: 'number', describe: 'Max rows (1..200)' })
+    .option('from-file', { type: 'string', describe: 'Load payload from JSON file' })
+    .option('dry-run', { type: 'boolean', describe: 'Show what would be done' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' })
     .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, alerts_1.alertsCommand)({
     action: args.action,
     sub: args.sub,
     target: args.target,
+    site: args.site,
+    id: args.id,
+    name: args.name,
+    type: args.type,
+    metric: args.metric,
+    thresholdType: args['threshold-type'],
+    thresholdValue: args['threshold-value'],
+    channel: args.channel,
     severity: args.severity,
     acknowledged: args.acknowledged,
+    note: args.note,
     limit: args.limit,
+    fromFile: args['from-file'],
+    dryRun: args['dry-run'],
+    yes: args.yes,
     json: args.json,
     profile: args.profile,
 }))
@@ -322,14 +379,82 @@ const db_1 = require("./commands/db");
     json: args.json,
     profile: args.profile,
 }))
-    .command('experiments <action> [target]', 'View experiments (list, show <key>, results <key>)', (y) => y
-    .positional('action', { type: 'string', describe: 'list | show | results' })
+    .command('experiments <action> [target]', 'Manage experiments (list, show, results, create, update, delete, start, stop)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show | results | create | update | delete | start | stop' })
     .positional('target', { type: 'string', describe: 'Experiment key or id' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('id', { type: 'string', describe: 'Experiment ID (for update/delete)' })
+    .option('key', { type: 'string', describe: 'Experiment key (for create)' })
+    .option('name', { type: 'string', describe: 'Experiment name' })
+    .option('description', { type: 'string', describe: 'Experiment description' })
+    .option('variants', { type: 'string', describe: 'Variants as JSON array' })
+    .option('goal', { type: 'string', describe: 'Goal ID to track conversions' })
     .option('conversion-event', { type: 'string', describe: 'Conversion event name' })
+    .option('from-file', { type: 'string', describe: 'Load payload from JSON file' })
+    .option('dry-run', { type: 'boolean', describe: 'Show what would be done' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' })
     .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, experiments_1.experimentsCommand)({
     action: args.action,
     target: args.target,
+    site: args.site,
+    id: args.id,
+    key: args.key,
+    name: args.name,
+    description: args.description,
+    variants: args.variants,
+    goal: args.goal,
     conversionEvent: args['conversion-event'],
+    fromFile: args['from-file'],
+    dryRun: args['dry-run'],
+    yes: args.yes,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('goals <action> [target]', 'Manage conversion goals (list, show, create, update, delete)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show | create | update | delete' })
+    .positional('target', { type: 'string', describe: 'Goal id' })
+    .option('site', { type: 'string', describe: 'Site ID (for list/create)' })
+    .option('name', { type: 'string', describe: 'Goal name' })
+    .option('description', { type: 'string', describe: 'Goal description' })
+    .option('event', { type: 'string', describe: 'Event name for the goal' })
+    .option('properties-filter', { type: 'string', describe: 'Properties filter (JSON)' })
+    .option('from-file', { type: 'string', describe: 'Load payload from JSON file' })
+    .option('dry-run', { type: 'boolean', describe: 'Show what would be done' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, goals_1.goalsCommand)({
+    action: args.action,
+    target: args.target,
+    site: args.site,
+    name: args.name,
+    description: args.description,
+    event: args.event,
+    propertiesFilter: args['properties-filter'],
+    fromFile: args['from-file'],
+    dryRun: args['dry-run'],
+    yes: args.yes,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('funnels <action> [target]', 'Manage conversion funnels (list, show, create, update, delete)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | show | create | update | delete' })
+    .positional('target', { type: 'string', describe: 'Funnel id' })
+    .option('site', { type: 'string', describe: 'Site ID (for list/create)' })
+    .option('name', { type: 'string', describe: 'Funnel name' })
+    .option('description', { type: 'string', describe: 'Funnel description' })
+    .option('steps', { type: 'string', describe: 'Comma-separated event names for funnel steps' })
+    .option('from-file', { type: 'string', describe: 'Load payload from JSON file' })
+    .option('dry-run', { type: 'boolean', describe: 'Show what would be done' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, funnels_1.funnelsCommand)({
+    action: args.action,
+    target: args.target,
+    site: args.site,
+    name: args.name,
+    description: args.description,
+    steps: args.steps,
+    fromFile: args['from-file'],
+    dryRun: args['dry-run'],
+    yes: args.yes,
     json: args.json,
     profile: args.profile,
 }))
@@ -386,17 +511,25 @@ const db_1 = require("./commands/db");
     profile: args.profile,
 }))
     // ── Error tracking — source map upload ────────────────────────────────
-    .command('sourcemap <action>', 'Upload source maps for error deobfuscation (upload)', (y) => y
+    .command('sourcemap <action>', 'Upload source maps for error deobfuscation (upload). Supports web/server JS .map and native dSYM/ProGuard.', (y) => y
     .positional('action', { type: 'string', describe: 'upload' })
-    .option('release', { type: 'string', describe: 'Release version (e.g. v1.0.0)' })
-    .option('dir', { type: 'string', describe: 'Directory containing .map files' })
+    .option('release', { type: 'string', describe: 'Release version (e.g. v1.0.0). Web/server only — alias of --version.' })
+    .option('version', { type: 'string', describe: 'App version (e.g. 1.4.2). Required for native uploads.' })
+    .option('dir', { type: 'string', describe: 'Directory containing .map files (web/server)' })
+    .option('file', { type: 'string', describe: 'Path to dSYM zip (iOS) or mapping.txt (Android)' })
+    .option('bundle-id', { type: 'string', describe: 'iOS bundleId or Android applicationId (native only)' })
     .option('site', { type: 'string', describe: 'Site ID' })
+    .option('platform', { type: 'string', choices: ['web', 'server', 'ios', 'android'], default: 'web', describe: 'Platform: web, server, ios, or android' })
     .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, sourcemap_1.sourcemapCommand)({
     action: args.action,
     release: args.release,
+    version: args.version,
     dir: args.dir,
+    file: args.file,
+    bundleId: args['bundle-id'],
     site: args.site,
     json: args.json,
+    platform: args.platform,
     profile: args.profile,
 }))
     // ── Phase 21 — database connect ────────────────────────────────────────
@@ -426,6 +559,18 @@ const db_1 = require("./commands/db");
     noInteractive: args['no-interactive'],
     json: args.json,
     profile: args.profile,
+}))
+    // ── Sprint B Group VII B14 — live event tail ─────────────────────────
+    .command('watch', 'Stream events live for the active tenant (SSE)', (y) => y
+    .option('site', { type: 'string', describe: 'Filter by site ID' })
+    .option('types', { type: 'string', describe: 'Comma-separated event names (e.g. $purchase,page_view)' })
+    .option('tail', { type: 'number', describe: 'Show last N events from the past 24h before streaming' })
+    .option('json', { type: 'boolean', describe: 'Emit one JSON line per event' }), (args) => (0, watch_1.watchCommand)({
+    site: args.site,
+    types: args.types,
+    tail: args.tail,
+    json: args.json,
+    profile: args.profile,
 }))
     .demandCommand(1, 'Run gurulu --help for available commands')
     .strict()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurulu/cli",
-  "version": "0.3.4",
+  "version": "0.4.1",
   "description": "Gurulu.io CLI — setup analytics in seconds",
   "bin": {
     "gurulu": "bin/gurulu.js"

package/scripts/gurulu-agentic-install.mjs

@@ -16,6 +16,7 @@ import { createRequire } from 'node:module';
 import { readFileSync, statSync, existsSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { posix as posixPath } from 'node:path';
 
 const require = createRequire(import.meta.url);
 const lib = require('./gurulu-agentic-install.lib.cjs');
@@ -92,6 +93,8 @@ function printHelp(out = process.stdout) {
       '  --framework <f>    auto|nextjs-app|nextjs-pages|vite-react|express',
       '  --auto-instrument  (Phase 18.7) Also write gurulu.track() calls into route handlers',
       '  --intent-result <path>  JSON file with InstallIntent output (feeds --auto-instrument)',
+      '  --token <key>      CLI auth token for LLM property extraction API',
+      '  --api-url <url>    Base URL for the Gurulu API (default: https://gurulu.io)',
       '  --quiet            Suppress non-error output',
       '  -h, --help         Show this help',
       '',
@@ -109,6 +112,156 @@ async function readScanInput(scanFile) {
   return JSON.parse(readFileSync(scanFile, 'utf8'));
 }
 
+/**
+ * Return a placeholder JS expression for a property that lacks an example
+ * value. The placeholder includes a TODO comment so developers know to fill
+ * in the real expression from their route handler context.
+ */
+function getPropertyPlaceholder(type, name) {
+  switch (type) {
+    case 'string':  return `'' /* TODO: ${name} */`;
+    case 'number':  return `0 /* TODO: ${name} */`;
+    case 'boolean': return `false /* TODO: ${name} */`;
+    default:        return `undefined /* TODO: ${name} */`;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Route resolution: map "POST /api/checkout" → actual file path on disk.
+// Reuses the candidate patterns from the auto-instrument modules.
+// ---------------------------------------------------------------------------
+
+function parseRouteString(routeStr) {
+  if (!routeStr || typeof routeStr !== 'string') return null;
+  const m = routeStr.trim().match(/^([A-Z]+)\s+(\/.*)$/);
+  if (!m) return null;
+  return { method: m[1].toUpperCase(), urlPath: m[2].replace(/\/+$/, '').split('?')[0] };
+}
+
+function resolveRouteFile(routeStr, framework, repoRoot) {
+  const parsed = parseRouteString(routeStr);
+  if (!parsed) return null;
+  const { urlPath } = parsed;
+  const segments = urlPath.split('/').filter(Boolean);
+
+  // Build candidate file paths based on framework.
+  const candidates = [];
+
+  // Next.js App Router patterns.
+  if (!framework || /next/i.test(framework)) {
+    const exts = ['ts', 'tsx', 'js', 'jsx'];
+    for (const ext of exts) {
+      candidates.push(posixPath.join('src', 'app', ...segments, `route.${ext}`));
+      candidates.push(posixPath.join('app', ...segments, `route.${ext}`));
+    }
+  }
+
+  // Next.js Pages API patterns.
+  if (!framework || /next.*pages/i.test(framework)) {
+    const exts = ['ts', 'tsx', 'js', 'jsx'];
+    for (const ext of exts) {
+      candidates.push(posixPath.join('src', 'pages', ...segments, `index.${ext}`));
+      candidates.push(posixPath.join('pages', ...segments, `index.${ext}`));
+      candidates.push(posixPath.join('src', 'pages', ...segments.slice(0, -1), `${segments[segments.length - 1]}.${ext}`));
+      candidates.push(posixPath.join('pages', ...segments.slice(0, -1), `${segments[segments.length - 1]}.${ext}`));
+    }
+  }
+
+  // Express / Fastify / generic patterns.
+  if (!framework || /express|fastify|nest|generic/i.test(framework)) {
+    const roots = ['src/routes', 'routes', 'src/api', 'api', 'src/controllers', 'controllers', 'src', 'app'];
+    const exts = ['ts', 'js', 'mjs', 'cjs'];
+    for (const root of roots) {
+      for (const ext of exts) {
+        // e.g. src/routes/checkout.ts
+        candidates.push(posixPath.join(root, ...segments.slice(1), `index.${ext}`));
+        if (segments.length > 1) {
+          candidates.push(posixPath.join(root, ...segments.slice(1, -1), `${segments[segments.length - 1]}.${ext}`));
+        }
+      }
+    }
+  }
+
+  // SvelteKit patterns.
+  if (!framework || /svelte/i.test(framework)) {
+    const exts = ['ts', 'js'];
+    for (const ext of exts) {
+      candidates.push(posixPath.join('src', 'routes', ...segments, `+server.${ext}`));
+    }
+  }
+
+  // Remix patterns.
+  if (!framework || /remix/i.test(framework)) {
+    const exts = ['ts', 'tsx', 'js', 'jsx'];
+    for (const ext of exts) {
+      candidates.push(posixPath.join('app', 'routes', segments.join('.') + `.${ext}`));
+    }
+  }
+
+  // Find first existing candidate.
+  for (const rel of candidates) {
+    const abs = path.join(repoRoot, rel);
+    if (existsSync(abs)) return abs;
+  }
+
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// LLM property extraction via the server API endpoint.
+// ---------------------------------------------------------------------------
+
+async function tryLlmExtraction(events, { repoRoot, framework, ingestUrl, token, siteId, log }) {
+  let llmHits = 0;
+  for (const event of events) {
+    // Skip if already has extracted properties.
+    if (event.extractedProperties && event.extractedProperties.length > 0) continue;
+
+    const routeStr = event.source && event.source.route;
+    if (!routeStr) continue;
+
+    const routeFile = resolveRouteFile(routeStr, framework, repoRoot);
+    if (!routeFile) continue;
+
+    let handlerSource;
+    try {
+      handlerSource = readFileSync(routeFile, 'utf-8');
+    } catch {
+      continue;
+    }
+
+    // Cap at 4KB to keep LLM calls reasonable.
+    const clipped = handlerSource.slice(0, 4096);
+
+    try {
+      const res = await fetch(`${ingestUrl}/api/cli/install/extract-properties`, {
+        method: 'POST',
+        headers: {
+          Authorization: `Bearer ${token}`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          siteId,
+          eventName: event.name,
+          handlerSource: clipped,
+          framework,
+        }),
+      });
+      if (res.ok) {
+        const data = await res.json();
+        if (data.properties && data.properties.length > 0 && data.confidence >= 0.7) {
+          event.extractedProperties = data.properties;
+          llmHits++;
+          log(`  LLM extracted ${data.properties.length} property(ies) for ${event.name} (confidence: ${data.confidence.toFixed(2)})`);
+        }
+      }
+    } catch {
+      // LLM extraction failed — fall through to placeholder.
+    }
+  }
+  return llmHits;
+}
+
 async function runPatchMode(repoRoot, args) {
   const log = args.quiet ? () => {} : (m) => process.stdout.write(m + '\n');
   if (args.rollback) {
@@ -160,6 +313,41 @@ async function runPatchMode(repoRoot, args) {
         const intent = JSON.parse(readFileSync(args['intent-result'], 'utf8'));
         const acceptedEvents = (intent && intent.accepted && intent.accepted.events) || [];
         const frameworkName = (patcher && patcher.name) || framework;
+
+        // Phase 20 — Try LLM-based property extraction first.
+        const ingestUrl = args['ingest-url'] || args['api-url'] || 'https://gurulu.io';
+        const token = args['token'] || args['api-key'] || '';
+        const siteId = args['site-id'] || '';
+        if (token) {
+          try {
+            const hits = await tryLlmExtraction(acceptedEvents, {
+              repoRoot,
+              framework: frameworkName,
+              ingestUrl,
+              token,
+              siteId,
+              log,
+            });
+            if (hits > 0) log(`LLM property extraction: ${hits} event(s) enriched`);
+          } catch (err) {
+            log(`LLM property extraction failed (using placeholders): ${err.message || err}`);
+          }
+        }
+
+        // Placeholder fallback for events that LLM didn't cover.
+        for (const event of acceptedEvents) {
+          if (event.extractedProperties && event.extractedProperties.length > 0) continue;
+          if (!event.propertySchema || !event.propertySchema.length) continue;
+          event.extractedProperties = event.propertySchema
+            .filter((p) => p.required)
+            .map((p) => ({
+              name: p.name,
+              type: p.type || 'unknown',
+              source: p.example !== undefined && p.example !== null
+                ? JSON.stringify(p.example)
+                : getPropertyPlaceholder(p.type, p.name),
+            }));
+        }
         const aiResult = patches.autoInstrumentDispatch(
           frameworkName,
           { repoRoot },
@@ -212,7 +400,44 @@ async function runPatchMode(repoRoot, args) {
       log('Auto-instrument: no accepted events to instrument');
       return;
     }
+
     const frameworkName = (patcher && patcher.name) || framework;
+
+    // Phase 20 — Try LLM-based property extraction first.
+    const ingestUrl = args['ingest-url'] || args['api-url'] || 'https://gurulu.io';
+    const token = args['token'] || args['api-key'] || '';
+    const siteId = args['site-id'] || '';
+    if (token) {
+      try {
+        const hits = await tryLlmExtraction(acceptedEvents, {
+          repoRoot,
+          framework: frameworkName,
+          ingestUrl,
+          token,
+          siteId,
+          log,
+        });
+        if (hits > 0) log(`LLM property extraction: ${hits} event(s) enriched`);
+      } catch (err) {
+        log(`LLM property extraction failed (using placeholders): ${err.message || err}`);
+      }
+    }
+
+    // Placeholder fallback: enrich events with extractedProperties from
+    // propertySchema for any events the LLM didn't cover.
+    for (const event of acceptedEvents) {
+      if (event.extractedProperties && event.extractedProperties.length > 0) continue;
+      if (!event.propertySchema || !event.propertySchema.length) continue;
+      event.extractedProperties = event.propertySchema
+        .filter((p) => p.required)
+        .map((p) => ({
+          name: p.name,
+          type: p.type || 'unknown',
+          source: p.example !== undefined && p.example !== null
+            ? JSON.stringify(p.example)
+            : getPropertyPlaceholder(p.type, p.name),
+        }));
+    }
     const aiResult = patches.autoInstrumentDispatch(
       frameworkName,
       { repoRoot },