@gurulu/cli 0.4.6 → 1.0.0

package/scripts/patches/auto-instrument/sveltekit.cjs

@@ -1,161 +0,0 @@
-// scripts/patches/auto-instrument/sveltekit.cjs — Phase 20 W1 A3.
-//
-// SvelteKit routes live under `src/routes/**`. API routes use
-// `+server.ts` and export one function per HTTP verb (`GET`, `POST`, ...).
-// Form actions live in `+page.server.ts` and export a `load` function plus
-// `actions` object. This patcher targets the `+server.ts` + `+page.server.ts`
-// shape and inserts `gurulu.track(...)` before the last return of the
-// matching handler.
-
-const fs = require('fs');
-const path = require('path');
-
-const ast = require('./ast-helper.cjs');
-const singleton = require('./singleton-helper.cjs');
-
-const NAME = 'auto-instrument-sveltekit';
-const SUPPORTED = ['sveltekit'];
-
-function parseEventRoute(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(/\/+$/, '') || '/' };
-}
-
-function routeToCandidates(urlPath) {
-  const cleaned = urlPath.replace(/^\//, '').replace(/\/+$/, '');
-  const segments = cleaned.split('/').filter(Boolean);
-  const exts = ['ts', 'js'];
-  const out = [];
-  for (const ext of exts) {
-    out.push(path.posix.join('src', 'routes', ...segments, `+server.${ext}`));
-    out.push(path.posix.join('src', 'routes', ...segments, `+page.server.${ext}`));
-  }
-  return out;
-}
-
-function astInstrumentFile(source, method, events, opts = {}) {
-  const tree = ast.parseSource(source);
-  const fns = ast.findExportedFunction(tree, method);
-  if (fns.length === 0) return { ok: false, reason: `${method}-not-found` };
-  const target = fns[0];
-  if (ast.hasInstrumentedMarker(target.fn)) {
-    return {
-      ok: true,
-      after: source,
-      instrumented: [],
-      skipped: events.map((e) => ({ event: e.name, reason: 'already-instrumented' })),
-      changed: false,
-    };
-  }
-  const stmts = events.map((e) => ast.buildTrackStatement(e.name, e.autoProperties));
-  ast.injectTrackBeforeLastReturn(target.fn, target.body, stmts);
-  // Sprint D / D4 — alias-aware import.
-  const specifier = ast.resolveGuruluImportSpecifier(opts.repoRoot, opts.relPath);
-  ast.ensureGuruluImport(tree, specifier);
-  const after = ast.generateSource(tree, source);
-  return {
-    ok: true,
-    after,
-    instrumented: events.map((e) => e.name),
-    skipped: [],
-    changed: true,
-  };
-}
-
-function instrumentEvents(ctx, events) {
-  const helper = singleton.ensureSingletonHelper(ctx, 'sveltekit');
-  const changes = [...helper.changes];
-  const notes = [...helper.notes];
-  let eventsInstrumented = 0;
-  let eventsSkipped = 0;
-
-  if (helper.collision) {
-    return {
-      changes: [],
-      notes,
-      filesModified: 0,
-      eventsInstrumented: 0,
-      eventsSkipped: events ? events.length : 0,
-      collision: true,
-    };
-  }
-
-  const groups = new Map();
-  for (const e of events || []) {
-    const parsed = parseEventRoute(e && e.source && e.source.route);
-    if (!parsed) {
-      notes.push(`skip:${e && e.name}:no-source-route`);
-      eventsSkipped++;
-      continue;
-    }
-    const candidates = routeToCandidates(parsed.urlPath);
-    const found = candidates.find((rel) => fs.existsSync(path.join(ctx.repoRoot, rel)));
-    if (!found) {
-      notes.push(`skip:${e.name}:route-file-not-found`);
-      eventsSkipped++;
-      continue;
-    }
-    const key = `${found}::${parsed.method}`;
-    if (!groups.has(key)) groups.set(key, { relPath: found, method: parsed.method, events: [] });
-    groups.get(key).events.push(e);
-  }
-
-  for (const group of groups.values()) {
-    const abs = path.join(ctx.repoRoot, group.relPath);
-    const before = fs.readFileSync(abs, 'utf8');
-    // Sprint D / D4 — pass repoRoot + relPath to the import resolver.
-    const fileOpts = { repoRoot: (ctx && ctx.repoRoot) || null, relPath: group.relPath };
-    let res;
-    try {
-      res = astInstrumentFile(before, group.method, group.events, fileOpts);
-    } catch (err) {
-      const msg = (err && err.message) || String(err);
-      // eslint-disable-next-line no-console
-      console.warn(`[auto-instrument] patch.fallback ${group.relPath}: ${msg}`);
-      notes.push(`patch.fallback:${group.relPath}:${msg}`);
-      continue;
-    }
-    if (!res.ok) {
-      for (const e of group.events) {
-        notes.push(`skip:${e.name}:${res.reason}`);
-        eventsSkipped++;
-      }
-      continue;
-    }
-    for (const s of res.skipped || []) {
-      notes.push(`skip:${s.event}:${s.reason}`);
-      eventsSkipped++;
-    }
-    if (res.changed) {
-      changes.push({
-        relPath: group.relPath,
-        before,
-        after: res.after,
-        reason: `auto-instrument-sveltekit`,
-        type: 'auto-instrument',
-      });
-      eventsInstrumented += (res.instrumented || []).length;
-    }
-  }
-
-  const filesModified = changes.filter((c) => c.type === 'auto-instrument').length;
-  return { changes, notes, filesModified, eventsInstrumented, eventsSkipped, collision: false };
-}
-
-function ensureSingletonHelper(ctx) {
-  return singleton.ensureSingletonHelper(ctx, 'sveltekit');
-}
-
-module.exports = {
-  name: NAME,
-  supportedFrameworks: SUPPORTED,
-  ensureSingletonHelper,
-  instrumentEvents,
-  _internals: {
-    parseEventRoute,
-    routeToCandidates,
-    astInstrumentFile,
-  },
-};

package/scripts/patches/auto-instrument/vite-react.cjs

@@ -1,37 +0,0 @@
-// scripts/patches/auto-instrument/vite-react.cjs — Phase 18.7 B4.
-//
-// Vite+React is a pure-frontend framework, so there are no server-side
-// route handlers to instrument. This module is a graceful no-op so the
-// shared dispatcher in `scripts/gurulu-agentic-install.mjs` can still
-// resolve a module for the framework and receive a well-formed result.
-
-const NAME = 'auto-instrument-vite-react';
-const SUPPORTED = ['vite-react'];
-
-function ensureSingletonHelper() {
-  return {
-    changes: [],
-    notes: ['vite-react is client-only; no singleton helper needed'],
-    collision: false,
-  };
-}
-
-function instrumentEvents(_ctx, events) {
-  return {
-    changes: [],
-    notes: [
-      'vite-react is client-only; install client-side track calls via SDK automatically',
-    ],
-    filesModified: 0,
-    eventsInstrumented: 0,
-    eventsSkipped: events ? events.length : 0,
-    collision: false,
-  };
-}
-
-module.exports = {
-  name: NAME,
-  supportedFrameworks: SUPPORTED,
-  ensureSingletonHelper,
-  instrumentEvents,
-};

package/scripts/patches/auto-instrument/vue.cjs

@@ -1,196 +0,0 @@
-// scripts/patches/auto-instrument/vue.cjs — Phase 20 W1 A3.
-//
-// Nuxt 3 / H3 server handlers. Routes live at
-// `server/api/**.{ts,js}` (or `server/routes/**`) and are declared with:
-//
-//   export default defineEventHandler(async (event) => { ... });
-//
-// We parse the file, find the `export default defineEventHandler(...)` call,
-// and inject `gurulu.track(...)` into the inner arrow/function body before
-// the last return.
-
-const fs = require('fs');
-const path = require('path');
-
-const ast = require('./ast-helper.cjs');
-const singleton = require('./singleton-helper.cjs');
-
-const NAME = 'auto-instrument-vue';
-const SUPPORTED = ['vue', 'nuxt'];
-
-function parseEventRoute(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(/\/+$/, '') || '/' };
-}
-
-function routeToCandidates(urlPath, method) {
-  // Nuxt files can be:
-  //   server/api/users.ts            — any method
-  //   server/api/users.post.ts       — POST only
-  //   server/api/users/index.ts      — any method
-  //   server/api/users/[id].ts       — any method (dynamic)
-  const cleaned = urlPath.replace(/^\//, '').replace(/\/+$/, '').replace(/^api\//, '');
-  const segments = cleaned.split('/').filter(Boolean);
-  const exts = ['ts', 'js', 'mjs'];
-  const out = [];
-  const lowerMethod = method.toLowerCase();
-  for (const ext of exts) {
-    out.push(path.posix.join('server', 'api', ...segments) + `.${lowerMethod}.${ext}`);
-    out.push(path.posix.join('server', 'api', ...segments) + `.${ext}`);
-    out.push(path.posix.join('server', 'api', ...segments, `index.${ext}`));
-    out.push(path.posix.join('server', 'routes', ...segments) + `.${ext}`);
-  }
-  return out;
-}
-
-/**
- * Locate the inner handler function inside `export default defineEventHandler(fn)`.
- * Returns `{ fn, body }` or null.
- */
-function findEventHandler(tree) {
-  const t = ast.t;
-  let found = null;
-  ast.traverse(tree, {
-    ExportDefaultDeclaration(p) {
-      const decl = p.node.declaration;
-      if (!t.isCallExpression(decl)) return;
-      if (!t.isIdentifier(decl.callee) || decl.callee.name !== 'defineEventHandler') return;
-      const handler = decl.arguments[0];
-      if (!handler) return;
-      if (
-        (t.isArrowFunctionExpression(handler) || t.isFunctionExpression(handler)) &&
-        t.isBlockStatement(handler.body)
-      ) {
-        found = { fn: handler, body: handler.body };
-      }
-    },
-  });
-  return found;
-}
-
-function astInstrumentFile(source, events, opts = {}) {
-  const tree = ast.parseSource(source);
-  const target = findEventHandler(tree);
-  if (!target) return { ok: false, reason: 'event-handler-not-found' };
-  if (ast.hasInstrumentedMarker(target.fn)) {
-    return {
-      ok: true,
-      after: source,
-      instrumented: [],
-      skipped: events.map((e) => ({ event: e.name, reason: 'already-instrumented' })),
-      changed: false,
-    };
-  }
-  const stmts = events.map((e) => ast.buildTrackStatement(e.name, e.autoProperties));
-  ast.injectTrackBeforeLastReturn(target.fn, target.body, stmts);
-  // Sprint D / D4 — alias-aware import.
-  const specifier = ast.resolveGuruluImportSpecifier(opts.repoRoot, opts.relPath);
-  ast.ensureGuruluImport(tree, specifier);
-  const after = ast.generateSource(tree, source);
-  return {
-    ok: true,
-    after,
-    instrumented: events.map((e) => e.name),
-    skipped: [],
-    changed: true,
-  };
-}
-
-function instrumentEvents(ctx, events) {
-  const helper = singleton.ensureSingletonHelper(ctx, 'vue');
-  const changes = [...helper.changes];
-  const notes = [...helper.notes];
-  let eventsInstrumented = 0;
-  let eventsSkipped = 0;
-
-  if (helper.collision) {
-    return {
-      changes: [],
-      notes,
-      filesModified: 0,
-      eventsInstrumented: 0,
-      eventsSkipped: events ? events.length : 0,
-      collision: true,
-    };
-  }
-
-  const groups = new Map();
-  for (const e of events || []) {
-    const parsed = parseEventRoute(e && e.source && e.source.route);
-    if (!parsed) {
-      notes.push(`skip:${e && e.name}:no-source-route`);
-      eventsSkipped++;
-      continue;
-    }
-    const candidates = routeToCandidates(parsed.urlPath, parsed.method);
-    const found = candidates.find((rel) => fs.existsSync(path.join(ctx.repoRoot, rel)));
-    if (!found) {
-      notes.push(`skip:${e.name}:route-file-not-found`);
-      eventsSkipped++;
-      continue;
-    }
-    const key = `${found}::${parsed.method}`;
-    if (!groups.has(key)) groups.set(key, { relPath: found, events: [] });
-    groups.get(key).events.push(e);
-  }
-
-  for (const group of groups.values()) {
-    const abs = path.join(ctx.repoRoot, group.relPath);
-    const before = fs.readFileSync(abs, 'utf8');
-    // Sprint D / D4 — pass repoRoot + relPath to the import resolver.
-    const fileOpts = { repoRoot: (ctx && ctx.repoRoot) || null, relPath: group.relPath };
-    let res;
-    try {
-      res = astInstrumentFile(before, group.events, fileOpts);
-    } catch (err) {
-      const msg = (err && err.message) || String(err);
-      // eslint-disable-next-line no-console
-      console.warn(`[auto-instrument] patch.fallback ${group.relPath}: ${msg}`);
-      notes.push(`patch.fallback:${group.relPath}:${msg}`);
-      continue;
-    }
-    if (!res.ok) {
-      for (const e of group.events) {
-        notes.push(`skip:${e.name}:${res.reason}`);
-        eventsSkipped++;
-      }
-      continue;
-    }
-    for (const s of res.skipped || []) {
-      notes.push(`skip:${s.event}:${s.reason}`);
-      eventsSkipped++;
-    }
-    if (res.changed) {
-      changes.push({
-        relPath: group.relPath,
-        before,
-        after: res.after,
-        reason: `auto-instrument-vue`,
-        type: 'auto-instrument',
-      });
-      eventsInstrumented += (res.instrumented || []).length;
-    }
-  }
-
-  const filesModified = changes.filter((c) => c.type === 'auto-instrument').length;
-  return { changes, notes, filesModified, eventsInstrumented, eventsSkipped, collision: false };
-}
-
-function ensureSingletonHelper(ctx) {
-  return singleton.ensureSingletonHelper(ctx, 'vue');
-}
-
-module.exports = {
-  name: NAME,
-  supportedFrameworks: SUPPORTED,
-  ensureSingletonHelper,
-  instrumentEvents,
-  _internals: {
-    parseEventRoute,
-    routeToCandidates,
-    findEventHandler,
-    astInstrumentFile,
-  },
-};

package/scripts/patches/express.patch.cjs

@@ -1,99 +0,0 @@
-// express.patch.cjs — Phase 16 A1
-//
-// Detects an Express server (`app.js`, `server.js`, `src/index.js` with the
-// idiomatic `const app = express()` signature) and appends:
-//   - A proxy route that serves /gurulu-tracker from the Gurulu CDN
-//   - A `res.locals.guruluConfig` middleware exposing siteId / tenantId
-
-const fs = require('fs');
-const path = require('path');
-
-const NAME = 'express';
-const CANDIDATES = [
-  'app.js',
-  'server.js',
-  'src/index.js',
-  'src/app.js',
-  'src/server.js',
-  'index.js',
-];
-
-const MARKER = '/* gurulu:install */';
-
-function looksLikeExpress(source) {
-  return (
-    /require\s*\(\s*['"]express['"]\s*\)/.test(source) ||
-    /from\s+['"]express['"]/.test(source) ||
-    /express\s*\(\s*\)/.test(source)
-  );
-}
-
-function detect(repoRoot) {
-  for (const rel of CANDIDATES) {
-    const abs = path.join(repoRoot, rel);
-    if (!fs.existsSync(abs)) continue;
-    const source = fs.readFileSync(abs, 'utf8');
-    if (looksLikeExpress(source)) {
-      return { framework: NAME, files: [rel] };
-    }
-  }
-  return null;
-}
-
-function findAppIdentifier(source) {
-  const m = source.match(/(?:const|let|var)\s+(\w+)\s*=\s*express\s*\(\s*\)/);
-  return m ? m[1] : 'app';
-}
-
-function buildMiddleware(appVar, injection) {
-  const pkField = injection.publishableKey
-    ? `    publishableKey: ${JSON.stringify(injection.publishableKey)},\n`
-    : '';
-  return (
-    `\n${MARKER}\n` +
-    `${appVar}.use((req, res, next) => {\n` +
-    `  res.locals.guruluConfig = {\n` +
-    `    siteId: ${JSON.stringify(injection.siteId)},\n` +
-    `    tenantId: ${JSON.stringify(injection.tenantId)},\n` +
-    pkField +
-    `  };\n` +
-    `  next();\n` +
-    `});\n` +
-    `${appVar}.use('/gurulu-tracker', (req, res) => {\n` +
-    `  res.set('Content-Type', 'application/javascript');\n` +
-    `  res.send(\`// Gurulu tracker proxy — site=\${${JSON.stringify(injection.siteId)}} data-gurulu-publishable-key=\${${JSON.stringify(injection.publishableKey || '')}}\\n` +
-    `window.gurulu = window.gurulu || { queue: [] };\`);\n` +
-    `});\n`
-  );
-}
-
-function inject(source, injection) {
-  if (source.includes(MARKER)) return source;
-  const appVar = findAppIdentifier(source);
-  const mw = buildMiddleware(appVar, injection);
-  // Insert before `app.listen(` if present, otherwise append.
-  const listenRe = new RegExp(`${appVar}\\s*\\.\\s*listen\\s*\\(`);
-  const idx = source.search(listenRe);
-  if (idx !== -1) {
-    const lineStart = source.lastIndexOf('\n', idx) + 1;
-    return source.slice(0, lineStart) + mw + '\n' + source.slice(lineStart);
-  }
-  return source + mw;
-}
-
-function plan(ctx) {
-  const detection = detect(ctx.repoRoot);
-  if (!detection) return { changes: [], notes: ['no-express'] };
-  const changes = [];
-  for (const rel of detection.files) {
-    const abs = path.join(ctx.repoRoot, rel);
-    const before = fs.readFileSync(abs, 'utf8');
-    const after = inject(before, ctx.injection);
-    if (after !== before) {
-      changes.push({ relPath: rel, before, after, reason: 'inject-middleware' });
-    }
-  }
-  return { changes, notes: [] };
-}
-
-module.exports = { name: NAME, detect, plan, looksLikeExpress };

package/scripts/patches/fastify.patch.cjs

@@ -1,108 +0,0 @@
-// fastify.patch.cjs — Phase 18.7 A1
-//
-// Fastify is a server-side framework. If a static HTML shell is shipped
-// under `public/`, `static/`, `dist/`, or `build/`, we patch that.
-// Otherwise we emit a server-only note and rely on --auto-instrument
-// (Phase 18.7 Agent B) to wire server-side track calls.
-
-const fs = require('fs');
-const path = require('path');
-
-const NAME = 'fastify';
-const HTML_CANDIDATES = [
-  'public/index.html',
-  'static/index.html',
-  'dist/index.html',
-  'build/index.html',
-];
-const SERVER_CANDIDATES = [
-  'server.js',
-  'app.js',
-  'src/server.js',
-  'src/app.js',
-  'src/server.ts',
-  'src/app.ts',
-  'index.js',
-];
-
-const MARKER = 'data-gurulu-install="1"';
-
-function looksLikeFastify(repoRoot) {
-  const pkgPath = path.join(repoRoot, 'package.json');
-  if (fs.existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-      const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
-      if (deps['fastify']) return true;
-    } catch {
-      /* ignore */
-    }
-  }
-  for (const rel of SERVER_CANDIDATES) {
-    const abs = path.join(repoRoot, rel);
-    if (!fs.existsSync(abs)) continue;
-    const source = fs.readFileSync(abs, 'utf8');
-    if (/require\s*\(\s*['"]fastify['"]\s*\)/.test(source) || /from\s+['"]fastify['"]/.test(source)) {
-      return true;
-    }
-  }
-  return false;
-}
-
-function detect(repoRoot) {
-  if (!looksLikeFastify(repoRoot)) return null;
-  for (const rel of HTML_CANDIDATES) {
-    if (fs.existsSync(path.join(repoRoot, rel))) {
-      return { framework: NAME, files: [rel] };
-    }
-  }
-  return { framework: NAME, files: [], serverOnly: true };
-}
-
-function buildScriptTag(injection) {
-  const pkAttr = injection.publishableKey
-    ? ` data-gurulu-publishable-key="${injection.publishableKey}"`
-    : '';
-  return (
-    `    <script\n` +
-    `      src="${injection.scriptSrc}"\n` +
-    `      data-gurulu-site-id="${injection.siteId}"\n` +
-    `      data-gurulu-tenant-id="${injection.tenantId}"${pkAttr}\n` +
-    `      data-features="errors,replay,advanced"\n` +
-    `      ${MARKER}\n` +
-    `      async\n` +
-    `    ></script>\n`
-  );
-}
-
-function injectScriptTag(source, injection) {
-  if (source.includes(MARKER)) return source;
-  const tag = buildScriptTag(injection);
-  if (/<\/body>/.test(source)) {
-    return source.replace(/<\/body>/, `${tag}  </body>`);
-  }
-  return source + '\n' + tag;
-}
-
-function plan(ctx) {
-  const detection = detect(ctx.repoRoot);
-  if (!detection) return { changes: [], notes: ['no-fastify'] };
-  if (detection.serverOnly) {
-    return {
-      changes: [],
-      notes: ['server-only; use --auto-instrument for server-side tracking'],
-    };
-  }
-  const changes = [];
-  for (const rel of detection.files) {
-    const abs = path.join(ctx.repoRoot, rel);
-    const before = fs.readFileSync(abs, 'utf8');
-    const after = injectScriptTag(before, ctx.injection);
-    if (after !== before) {
-      changes.push({ relPath: rel, before, after, reason: 'inject-script-tag' });
-    }
-  }
-  return { changes, notes: [] };
-}
-
-module.exports = { name: NAME, detect, plan };