@gurulu/cli 0.4.2 → 0.4.3

package/dist/index.js

@@ -41,6 +41,13 @@ const sourcemap_1 = require("./commands/sourcemap");
 const db_1 = require("./commands/db");
 // Sprint B Group VII B14 — live event stream
 const watch_1 = require("./commands/watch");
+// Sprint E SE-A / SE-B — analytics + observability CLI surface
+const attribution_1 = require("./commands/attribution");
+const releases_1 = require("./commands/releases");
+const skad_1 = require("./commands/skad");
+const errors_1 = require("./commands/errors");
+const replay_1 = require("./commands/replay");
+const conversion_paths_1 = require("./commands/conversion-paths");
 (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
     .scriptName('gurulu')
     .option('profile', { type: 'string', describe: 'Use a specific profile (default: personal)' })
@@ -458,18 +465,42 @@ const watch_1 = require("./commands/watch");
     json: args.json,
     profile: args.profile,
 }))
-    .command('identity <action> [sub]', 'View identity state (decay stats, transfers list, cdc-sources list)', (y) => y
-    .positional('action', { type: 'string', describe: 'decay | transfers | cdc-sources' })
+    .command('identity <action> [sub]', 'Identity state + writes (decay stats | transfers list | cdc-sources list | identify | alias | merge)', (y) => y
+    .positional('action', {
+    type: 'string',
+    describe: 'decay | transfers | cdc-sources | identify | alias | merge',
+})
     .positional('sub', { type: 'string', describe: 'Subaction (stats, list)' })
     .option('direction', { type: 'string', describe: 'outbound | inbound | all' })
     .option('status', { type: 'string', describe: 'Filter by transfer status' })
     .option('limit', { type: 'number', describe: 'Max rows' })
+    // identify / alias / merge
+    .option('site', { type: 'string', describe: 'Site ID (write actions)' })
+    .option('user-id', { type: 'string', describe: 'User ID (identify)' })
+    .option('email', { type: 'string', describe: 'Email (identify)' })
+    .option('phone', { type: 'string', describe: 'Phone (identify)' })
+    .option('traits', { type: 'string', describe: 'Traits as JSON object (identify)' })
+    .option('previous-user-id', { type: 'string', describe: 'Anonymous/old user id (alias)' })
+    .option('new-user-id', { type: 'string', describe: 'New canonical user id (alias)' })
+    .option('canonical-id', { type: 'string', describe: 'Winner canonical profile id (merge)' })
+    .option('duplicate-id', { type: 'string', describe: 'Loser canonical profile id (merge)' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' })
     .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, identity_1.identityCommand)({
     action: args.action,
     sub: args.sub,
     direction: args.direction,
     status: args.status,
     limit: args.limit,
+    site: args.site,
+    userId: args['user-id'],
+    email: args.email,
+    phone: args.phone,
+    traits: args.traits,
+    previousUserId: args['previous-user-id'],
+    newUserId: args['new-user-id'],
+    canonicalId: args['canonical-id'],
+    duplicateId: args['duplicate-id'],
+    yes: args.yes,
     json: args.json,
     profile: args.profile,
 }))
@@ -571,6 +602,135 @@ const watch_1 = require("./commands/watch");
     tail: args.tail,
     json: args.json,
     profile: args.profile,
+}))
+    // ── Sprint E SE-A/B — analytics + observability CLI surface ──────────
+    .command('attribution <action>', 'Attribution analytics (report, compare, channels)', (y) => y
+    .positional('action', { type: 'string', describe: 'report | compare | channels' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('from', { type: 'string', describe: 'ISO date (inclusive)' })
+    .option('to', { type: 'string', describe: 'ISO date (inclusive)' })
+    .option('range', { type: 'string', describe: '7d | 30d | 90d shorthand' })
+    .option('model', { type: 'string', describe: 'last-touch | first-touch | linear | time-decay | position-based | data-driven' })
+    .option('baseline-model', { type: 'string', describe: 'Baseline model id (compare)' })
+    .option('variant-model', { type: 'string', describe: 'Variant model id (compare)' })
+    .option('conversion-event', { type: 'string', describe: 'Conversion event (default $purchase)' })
+    .option('format', { type: 'string', describe: 'json | table' })
+    .option('json', { type: 'boolean', describe: 'JSON output (default)' }), (args) => (0, attribution_1.attributionCommand)({
+    action: args.action,
+    site: args.site,
+    from: args.from,
+    to: args.to,
+    range: args.range,
+    model: args.model,
+    baselineModel: args['baseline-model'],
+    variantModel: args['variant-model'],
+    conversionEvent: args['conversion-event'],
+    format: args.format,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('releases <action>', 'Release health (list)', (y) => y
+    .positional('action', { type: 'string', describe: 'list' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('range', { type: 'string', describe: '24h | 7d | 30d (default 7d)' })
+    .option('environment', { type: 'string', describe: 'Optional environment filter' })
+    .option('limit', { type: 'number', describe: 'Max rows (default 20)' })
+    .option('format', { type: 'string', describe: 'json | table' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, releases_1.releasesCommand)({
+    action: args.action,
+    site: args.site,
+    range: args.range,
+    environment: args.environment,
+    limit: args.limit,
+    format: args.format,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('skad <action>', 'Apple SKAdNetwork postbacks (postbacks)', (y) => y
+    .positional('action', { type: 'string', describe: 'postbacks' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('from', { type: 'string', describe: 'ISO ts or 7d/24h' })
+    .option('to', { type: 'string', describe: 'ISO ts (default now)' })
+    .option('goal', { type: 'string', describe: 'Filter by resolved goal' })
+    .option('limit', { type: 'number', describe: 'Max rows (1..500)' })
+    .option('format', { type: 'string', describe: 'json | table' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, skad_1.skadCommand)({
+    action: args.action,
+    site: args.site,
+    from: args.from,
+    to: args.to,
+    goal: args.goal,
+    limit: args.limit,
+    format: args.format,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('errors <action>', 'Error tracking (list, detail, resolve, mute)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | detail | resolve | mute | upload-sourcemap | upload-native-symbols' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('fingerprint', { type: 'string', describe: 'Error group fingerprint' })
+    .option('level', { type: 'string', describe: 'error | warning | info' })
+    .option('resolved', { type: 'string', describe: 'true | false' })
+    .option('environment', { type: 'string', describe: 'Environment filter' })
+    .option('release-id', { type: 'string', describe: 'Filter to a release' })
+    .option('limit', { type: 'number', describe: 'Max rows' })
+    .option('duration', { type: 'string', describe: 'Mute duration (e.g. 24h, 7d)' })
+    .option('format', { type: 'string', describe: 'json | table' })
+    .option('yes', { type: 'boolean', alias: 'y', describe: 'Skip confirmation' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, errors_1.errorsCommand)({
+    action: args.action,
+    site: args.site,
+    fingerprint: args.fingerprint,
+    level: args.level,
+    resolved: args.resolved,
+    environment: args.environment,
+    releaseId: args['release-id'],
+    limit: args.limit,
+    duration: args.duration,
+    format: args.format,
+    yes: args.yes,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('replay <action>', 'Session replay (list, get)', (y) => y
+    .positional('action', { type: 'string', describe: 'list | get' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('session-id', { type: 'string', describe: 'Session id (for get)' })
+    .option('range', { type: 'string', describe: '7d | 30d (default 7d)' })
+    .option('has-error', { type: 'boolean', describe: 'Filter to sessions with errors' })
+    .option('limit', { type: 'number', describe: 'Max rows' })
+    .option('format', { type: 'string', describe: 'json | table' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, replay_1.replayCommand)({
+    action: args.action,
+    site: args.site,
+    sessionId: args['session-id'],
+    range: args.range,
+    hasError: args['has-error'],
+    limit: args.limit,
+    format: args.format,
+    json: args.json,
+    profile: args.profile,
+}))
+    .command('conversion-paths <action>', 'Conversion path analytics (list)', (y) => y
+    .positional('action', { type: 'string', describe: 'list' })
+    .option('site', { type: 'string', describe: 'Site ID' })
+    .option('from', { type: 'string', describe: 'ISO date' })
+    .option('to', { type: 'string', describe: 'ISO date' })
+    .option('range', { type: 'string', describe: '7d | 30d | 90d' })
+    .option('conversion-event', { type: 'string', describe: 'Conversion event' })
+    .option('limit', { type: 'number', describe: 'Max rows' })
+    .option('format', { type: 'string', describe: 'json | table' })
+    .option('json', { type: 'boolean', describe: 'JSON output' }), (args) => (0, conversion_paths_1.conversionPathsCommand)({
+    action: args.action,
+    site: args.site,
+    from: args.from,
+    to: args.to,
+    range: args.range,
+    conversionEvent: args['conversion-event'],
+    limit: args.limit,
+    format: args.format,
+    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.4.2",
+  "version": "0.4.3",
   "description": "Gurulu.io CLI — setup analytics in seconds",
   "bin": {
     "gurulu": "bin/gurulu.js"

package/scripts/gurulu-agentic-install.lib.cjs

@@ -380,16 +380,44 @@ function generateServerMap(scan /*, opts*/) {
   };
 }
 
+/**
+ * Sprint E1.3b — singularize plural table/model names to canonical singular.
+ * The scan layer normalises mutations as `{ op: '<model>.<operation>' }` so we
+ * derive the operation from `m.op` when `m.operation` isn't present, and
+ * collapse common irregular plurals to their singular form so e.g. raw-SQL
+ * `INSERT INTO orders` and a Drizzle `pgTable('orders', ...)` both fold into
+ * the same `order` row in db-map.
+ */
+const SINGULARIZE_IRREGULARS = {
+  users: 'user',
+  orders: 'order',
+  items: 'item',
+};
+function singularizeModelName(raw) {
+  const lower = String(raw || '').toLowerCase();
+  if (!lower) return lower;
+  if (Object.prototype.hasOwnProperty.call(SINGULARIZE_IRREGULARS, lower)) {
+    return SINGULARIZE_IRREGULARS[lower];
+  }
+  return lower;
+}
+
 /** db-map.json — table → event emitter mapping from detected mutations. */
 function generateDbMap(scan, opts) {
   const byModel = new Map();
   for (const m of scan.mutations || []) {
-    const name = String(m.model || '').trim();
-    if (!name) continue;
-    const op = cdcOp(m.operation);
+    const rawName = String(m.model || '').trim();
+    if (!rawName) continue;
+    const name = singularizeModelName(rawName);
+    // Sprint E1.3b — `scan.mutations` from gurulu-scan.lib.cjs normalises the
+    // operation as `m.op = "<model>.<operation>"` and drops `m.operation`.
+    // Derive the operation verb from whichever field is populated.
+    const operation =
+      m.operation || (typeof m.op === 'string' ? m.op.split('.').pop() : null);
+    const op = cdcOp(operation);
     if (!op) continue;
     if (!byModel.has(name)) byModel.set(name, new Set());
-    const key = `${op}::${inferEventName(name, m.operation)}`;
+    const key = `${op}::${inferEventName(name, operation)}`;
     byModel.get(name).add(key);
   }
 

package/scripts/gurulu-agentic-install.mjs

@@ -278,10 +278,13 @@ async function runPatchMode(repoRoot, args) {
     process.exit(1);
   }
   const framework = args.framework || 'auto';
-  const { patcher, detection, error } = patches.resolvePatcher(repoRoot, framework);
+  const { patcher, detection, error, unsupportedFramework } = patches.resolvePatcher(repoRoot, framework);
   if (error) {
     process.stderr.write(`Error: ${error}\n`);
-    process.exit(1);
+    // Sprint E1.6 — exit 6 specifically for mobile / not-yet-supported
+    // frameworks so the wrapping CLI can surface docs links instead of a
+    // generic install failure.
+    process.exit(unsupportedFramework ? 6 : 1);
   }
   if (!patcher) {
     process.stderr.write('No supported framework detected in ' + repoRoot + '\n');
@@ -412,6 +415,11 @@ async function runPatchMode(repoRoot, args) {
         `Auto-instrument failed (${reason}); rollback threw: ${err.stack || err.message || err}\n`,
       );
     }
+    // Sprint E1.1 — exit code 5 signals "patches rolled back" so install.ts
+    // can skip the npm-install / .env-merge / ingest-ping steps and surface
+    // the rollback to the user. The wrapping CLI converts this into a
+    // partially-installed state with `summary.rolledBack=true`.
+    process.exit(5);
   }
   if (args.autoInstrument) {
     const intentPath = args['intent-result'];