@tryhermes/cli 0.1.2 → 0.1.4

package/dist/index.js

@@ -6872,21 +6872,36 @@ function formatConnectionTable(items) {
   if (items.length === 0) return "No connections found.";
   const rows = items.map((c) => ({
     id: c.id,
+    label: c.label ?? "\u2014",
     source: c.source_type,
+    default: c.is_default ? "yes" : "no",
     status: c.status,
     synced: c.last_synced_at ? c.last_synced_at.slice(0, 19).replace("T", " ") : "\u2014",
     created: c.created_at ? c.created_at.slice(0, 10) : "\u2014"
   }));
   const headers = {
     id: "ID",
+    label: "LABEL",
     source: "SOURCE",
+    default: "DEFAULT",
     status: "STATUS",
     synced: "LAST SYNCED",
     created: "CREATED"
   };
-  const cols = ["id", "source", "status", "synced", "created"];
+  const cols = [
+    "id",
+    "label",
+    "source",
+    "default",
+    "status",
+    "synced",
+    "created"
+  ];
   const widths = Object.fromEntries(
-    cols.map((c) => [c, Math.max(headers[c].length, ...rows.map((r) => r[c].length))])
+    cols.map((c) => [
+      c,
+      Math.max(headers[c].length, ...rows.map((r) => r[c].length))
+    ])
   );
   const fmt = (vals) => cols.map((c) => vals[c].padEnd(widths[c])).join("  ").trimEnd();
   return [fmt(headers), ...rows.map(fmt)].join("\n");
@@ -6894,17 +6909,25 @@ function formatConnectionTable(items) {
 function renderConnectionDetail(c) {
   const rows = [
     ["ID", c.id],
+    ["Label", c.label ?? "\u2014"],
     ["Source", c.source_type],
+    ["Default", c.is_default ? "yes" : "no"],
     ["Status", c.status],
     ["Last synced", c.last_synced_at ?? "\u2014"],
     ["Created", c.created_at ?? "\u2014"]
   ];
-  if (c.source_type === "postgres") rows.push(["Postgres URL", c.postgres_url ?? "\u2014"]);
+  if (c.source_type === "postgres")
+    rows.push(["Postgres URL", c.postgres_url ?? "\u2014"]);
   if (c.source_type === "mysql") rows.push(["MySQL URL", c.mysql_url ?? "\u2014"]);
   if (c.source_type === "firestore") {
     rows.push(["Firestore project", c.firestore_project_id ?? "\u2014"]);
     rows.push(["Firestore creds", c.firestore_credentials ?? "\u2014"]);
   }
+  if (c.source_type === "posthog") {
+    rows.push(["PostHog host", c.posthog_host ?? "\u2014"]);
+    rows.push(["PostHog project", c.posthog_project_id ?? "\u2014"]);
+    rows.push(["PostHog API key", c.posthog_api_key ?? "\u2014"]);
+  }
   const labelWidth = Math.max(...rows.map(([k]) => k.length));
   const lines = ["Identity"];
   for (const [k, v] of rows) {
@@ -6941,7 +6964,11 @@ function renderQueryResult(r) {
     indent(sampleJson)
   ].join("\n");
 }
-async function resolveConnectionId(explicit) {
+function explicitConnectionId(opts, positional) {
+  const flag = opts.source ?? opts.connection;
+  return flag ?? positional;
+}
+async function resolveConnectionId(explicit, opts = {}) {
   if (explicit) return explicit;
   const list = await apiFetch("/api/v1/connections");
   if (list.connections.length === 0) {
@@ -6951,16 +6978,29 @@ async function resolveConnectionId(explicit) {
       hint: `Run \`${cmd("connections add --postgres-url ...")}\` (or another source flag) first.`
     });
   }
-  return list.connections[0].id;
+  const chosen = list.connections[0];
+  if (!opts.json && list.connections.length > 1) {
+    const others = list.connections.length - 1;
+    const label = chosen.label ?? chosen.source_type;
+    process.stderr.write(
+      `Using default source ${label} (${chosen.id}). ${others} other source${others === 1 ? "" : "s"} connected \u2014 pass --source <id> to target a different one.
+`
+    );
+  }
+  return chosen.id;
 }
 function registerConnectionsCommand(program3) {
-  const conns = program3.command("connections").description("Manage the customer data source Hermes scans (Postgres, MySQL, CSV, Firestore)").action(function() {
+  const conns = program3.command("connections").description(
+    "Manage the customer data sources Hermes scans (Postgres, MySQL, CSV, Firestore, PostHog)"
+  ).action(function() {
     this.help();
   });
   conns.command("list").description("List connections in the linked org").action(async function() {
     const opts = this.optsWithGlobals();
     try {
-      const response = await apiFetch("/api/v1/connections");
+      const response = await apiFetch(
+        "/api/v1/connections"
+      );
       if (opts.json) {
         console.log(JSON.stringify(response, null, 2));
       } else {
@@ -6971,10 +7011,13 @@ function registerConnectionsCommand(program3) {
       emitApiError(err, Boolean(opts.json));
     }
   });
-  conns.command("show [id]").description("Show full connection row (defaults to the org's only connection)").action(async function(id) {
+  conns.command("show [id]").description("Show full connection row (defaults to the org default)").option("--source <id>", SOURCE_OPTION_DESC).option("--connection <id>", "alias for --source").action(async function(id) {
     const opts = this.optsWithGlobals();
     try {
-      const resolved = await resolveConnectionId(id);
+      const resolved = await resolveConnectionId(
+        explicitConnectionId(opts, id),
+        { json: Boolean(opts.json) }
+      );
       const conn = await apiFetch(
         `/api/v1/connections/${encodeURIComponent(resolved)}`
       );
@@ -6988,10 +7031,15 @@ function registerConnectionsCommand(program3) {
       emitApiError(err, Boolean(opts.json));
     }
   });
-  conns.command("schema [id]").description("Print source_type + dialect + example query + cached schema (the contract for writing a detection_query)").action(async function(id) {
+  conns.command("schema [id]").description(
+    "Print source_type + dialect + example query + cached schema (the contract for writing a detection_query)"
+  ).option("--source <id>", SOURCE_OPTION_DESC).option("--connection <id>", "alias for --source").action(async function(id) {
     const opts = this.optsWithGlobals();
     try {
-      const resolved = await resolveConnectionId(id);
+      const resolved = await resolveConnectionId(
+        explicitConnectionId(opts, id),
+        { json: Boolean(opts.json) }
+      );
       const result = await apiFetch(
         `/api/v1/connections/${encodeURIComponent(resolved)}/schema`
       );
@@ -7006,21 +7054,34 @@ function registerConnectionsCommand(program3) {
     }
   });
   conns.command("add").description(
-    "Tell Hermes about more data. For SQL/Firestore sources this sets/replaces the org's connection; for CSV it appends another table."
-  ).option("--postgres-url <url>", "\u2192 source_type=postgres (replaces existing)").option("--mysql-url <url>", "\u2192 source_type=mysql (replaces existing)").option(
+    "Tell Hermes about another data source. Existing sources and triggers are left intact."
+  ).option("--label <label>", "human-readable label for this source").option("--default", "make this the default source for new triggers").option("--postgres-url <url>", "\u2192 source_type=postgres").option("--mysql-url <url>", "\u2192 source_type=mysql").option("--posthog-host <url>", "\u2192 source_type=posthog").option("--posthog-project-id <id>", "PostHog project id").option("--posthog-api-key <key>", "PostHog personal API key").option(
     "--firestore-credentials <json-or-@file>",
-    "Service account JSON (raw, or @path/to/sa.json) \u2192 source_type=firestore (replaces existing)"
-  ).option("--firestore-project-id <id>", "explicit project_id (otherwise inferred from creds)").option("--csv-file <path>", "\u2192 source_type=csv (appends another table; first call creates the connection)").option("--table-name <name>", "explicit table name for the CSV upload (otherwise inferred from filename)").option("--confirm-switch", "required when changing source_type \u2014 acknowledges the existing connection will be replaced").action(async function() {
+    "Service account JSON (raw, or @path/to/sa.json) \u2192 source_type=firestore"
+  ).option(
+    "--firestore-project-id <id>",
+    "explicit project_id (otherwise inferred from creds)"
+  ).option("--csv-file <path>", "\u2192 source_type=csv").option(
+    "--connection <id>",
+    "when used with --csv-file, append the table to an existing CSV source"
+  ).option(
+    "--table-name <name>",
+    "explicit table name for the CSV upload (otherwise inferred from filename)"
+  ).option(
+    "--confirm-switch",
+    "deprecated; connections add no longer replaces existing sources"
+  ).action(async function() {
     const opts = this.optsWithGlobals();
     const credentialFlags = [
       opts.postgresUrl ? "--postgres-url" : null,
       opts.mysqlUrl ? "--mysql-url" : null,
+      opts.posthogHost || opts.posthogProjectId || opts.posthogApiKey ? "--posthog-host/--posthog-project-id/--posthog-api-key" : null,
       opts.firestoreCredentials ? "--firestore-credentials" : null,
       opts.csvFile ? "--csv-file" : null
     ].filter(Boolean);
     if (credentialFlags.length === 0) {
       console.error(
-        "Error: provide one of --postgres-url, --mysql-url, --firestore-credentials, --csv-file."
+        "Error: provide one of --postgres-url, --mysql-url, --posthog-host/--posthog-project-id/--posthog-api-key, --firestore-credentials, --csv-file."
       );
       process.exit(1);
     }
@@ -7030,10 +7091,23 @@ function registerConnectionsCommand(program3) {
       );
       process.exit(1);
     }
+    if (opts.connection && !opts.csvFile) {
+      console.error("Error: --connection is only valid with --csv-file.");
+      process.exit(1);
+    }
+    if (opts.connection && opts.default) {
+      console.error(
+        "Error: --default only applies when creating a new source, not when appending to an existing CSV source."
+      );
+      process.exit(1);
+    }
     try {
       const conn = opts.csvFile ? await uploadCsvConnection({
         filePath: String(opts.csvFile),
+        connectionId: opts.connection ? String(opts.connection) : void 0,
         tableName: opts.tableName ? String(opts.tableName) : void 0,
+        label: opts.label ? String(opts.label) : void 0,
+        setDefault: Boolean(opts.default),
         confirmSwitch: Boolean(opts.confirmSwitch)
       }) : await apiFetch("/api/v1/connections", {
         method: "POST",
@@ -7053,10 +7127,15 @@ function registerConnectionsCommand(program3) {
       emitApiError(err, Boolean(opts.json));
     }
   });
-  conns.command("query <q> [id]").description("Run a read-only query against the source \u2014 returns count + sample. Iterate here before `triggers create`.").action(async function(q, id) {
+  conns.command("query <q> [id]").description(
+    "Run a read-only query against the source \u2014 returns count + sample. Iterate here before `triggers create`."
+  ).option("--source <id>", SOURCE_OPTION_DESC).option("--connection <id>", "alias for --source").action(async function(q, id) {
     const opts = this.optsWithGlobals();
     try {
-      const resolved = await resolveConnectionId(id);
+      const resolved = await resolveConnectionId(
+        explicitConnectionId(opts, id),
+        { json: Boolean(opts.json) }
+      );
       const body = { query: parseQueryArg(q) };
       const result = await apiFetch(
         `/api/v1/connections/${encodeURIComponent(resolved)}/query`,
@@ -7072,10 +7151,15 @@ function registerConnectionsCommand(program3) {
       emitApiError(err, Boolean(opts.json));
     }
   });
-  conns.command("inspect-schema [id]").description("Re-run schema introspection against the live source (use after the source schema changes)").action(async function(id) {
+  conns.command("inspect-schema [id]").description(
+    "Re-run schema introspection against the live source (use after the source schema changes)"
+  ).option("--source <id>", SOURCE_OPTION_DESC).option("--connection <id>", "alias for --source").action(async function(id) {
     const opts = this.optsWithGlobals();
     try {
-      const resolved = await resolveConnectionId(id);
+      const resolved = await resolveConnectionId(
+        explicitConnectionId(opts, id),
+        { json: Boolean(opts.json) }
+      );
       const conn = await apiFetch(
         `/api/v1/connections/${encodeURIComponent(resolved)}/inspect-schema`,
         { method: "POST" }
@@ -7092,10 +7176,16 @@ function registerConnectionsCommand(program3) {
   });
   conns.command("remove [id]").description(
     "Without --csv-table: delete the whole connection. With --csv-table: drop one CSV table (csv connections only)."
-  ).requiredOption("--confirm", "required for destructive ops").option("--csv-table <name>", "drop a single CSV table instead of the whole connection").action(async function(id) {
+  ).requiredOption("--confirm", "required for destructive ops").option(
+    "--csv-table <name>",
+    "drop a single CSV table instead of the whole connection"
+  ).option("--source <id>", SOURCE_OPTION_DESC).option("--connection <id>", "alias for --source").action(async function(id) {
     const opts = this.optsWithGlobals();
     try {
-      const resolved = await resolveConnectionId(id);
+      const resolved = await resolveConnectionId(
+        explicitConnectionId(opts, id),
+        { json: Boolean(opts.json) }
+      );
       if (opts.csvTable) {
         const result2 = await apiFetch(
           `/api/v1/connections/${encodeURIComponent(resolved)}/csv-tables/${encodeURIComponent(String(opts.csvTable))}`,
@@ -7104,7 +7194,9 @@ function registerConnectionsCommand(program3) {
         if (opts.json) {
           console.log(JSON.stringify(result2, null, 2));
         } else {
-          console.log(`Removed CSV table "${result2.table_name}" from connection ${result2.connection_id}.`);
+          console.log(
+            `Removed CSV table "${result2.table_name}" from connection ${result2.connection_id}.`
+          );
         }
         process.exit(0);
       }
@@ -7115,7 +7207,9 @@ function registerConnectionsCommand(program3) {
       if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`Removed ${result.source_type} connection (${result.id}).`);
+        console.log(
+          `Removed ${result.source_type} connection (${result.id}).`
+        );
       }
       process.exit(0);
     } catch (err) {
@@ -7125,11 +7219,41 @@ function registerConnectionsCommand(program3) {
 }
 async function buildJsonCreateBody(opts) {
   const confirmSwitch = opts.confirmSwitch ? { confirm_switch: true } : {};
+  const metadata = {
+    ...opts.label ? { label: String(opts.label) } : {},
+    ...opts.default ? { set_default: true } : {}
+  };
   if (opts.postgresUrl) {
-    return { source_type: "postgres", postgres_url: String(opts.postgresUrl), ...confirmSwitch };
+    return {
+      source_type: "postgres",
+      postgres_url: String(opts.postgresUrl),
+      ...metadata,
+      ...confirmSwitch
+    };
   }
   if (opts.mysqlUrl) {
-    return { source_type: "mysql", mysql_url: String(opts.mysqlUrl), ...confirmSwitch };
+    return {
+      source_type: "mysql",
+      mysql_url: String(opts.mysqlUrl),
+      ...metadata,
+      ...confirmSwitch
+    };
+  }
+  if (opts.posthogHost || opts.posthogProjectId || opts.posthogApiKey) {
+    if (!opts.posthogHost || !opts.posthogProjectId || !opts.posthogApiKey) {
+      throw new CliApiError(400, {
+        code: "VALIDATION_FAILED",
+        message: "PostHog requires --posthog-host, --posthog-project-id, and --posthog-api-key."
+      });
+    }
+    return {
+      source_type: "posthog",
+      posthog_host: String(opts.posthogHost),
+      posthog_project_id: String(opts.posthogProjectId),
+      posthog_api_key: String(opts.posthogApiKey),
+      ...metadata,
+      ...confirmSwitch
+    };
   }
   const raw = String(opts.firestoreCredentials);
   const credentials = raw.startsWith("@") ? await (0, import_promises.readFile)(raw.slice(1), "utf8") : raw;
@@ -7137,6 +7261,7 @@ async function buildJsonCreateBody(opts) {
     source_type: "firestore",
     firestore_credentials: credentials,
     ...opts.firestoreProjectId ? { firestore_project_id: String(opts.firestoreProjectId) } : {},
+    ...metadata,
     ...confirmSwitch
   };
 }
@@ -7156,7 +7281,10 @@ async function uploadCsvConnection(opts) {
     new Blob([new Uint8Array(buffer)], { type: "text/csv" }),
     (0, import_node_path.basename)(opts.filePath)
   );
+  if (opts.connectionId) form.append("connection_id", opts.connectionId);
   if (opts.tableName) form.append("table_name", opts.tableName);
+  if (opts.label) form.append("label", opts.label);
+  if (opts.setDefault) form.append("set_default", "true");
   if (opts.confirmSwitch) form.append("confirm_switch", "true");
   return apiFetch("/api/v1/connections/csv", {
     method: "POST",
@@ -7176,7 +7304,7 @@ function parseQueryArg(arg) {
   }
   return arg;
 }
-var import_promises, import_node_path;
+var import_promises, import_node_path, SOURCE_OPTION_DESC;
 var init_connections = __esm({
   "src/commands/connections.ts"() {
     "use strict";
@@ -7186,6 +7314,7 @@ var init_connections = __esm({
     init_api_client();
     init_emit_error();
     init_invocation();
+    SOURCE_OPTION_DESC = "connection id to act on \u2014 overrides the positional [id]; defaults to the org default source";
   }
 });
 
@@ -8045,10 +8174,13 @@ function parseDetectionQuery(arg) {
   return arg;
 }
 async function patchTrigger(id, body) {
-  return apiFetch(`/api/v1/triggers/${encodeURIComponent(id)}`, {
-    method: "PATCH",
-    body
-  });
+  return apiFetch(
+    `/api/v1/triggers/${encodeURIComponent(id)}`,
+    {
+      method: "PATCH",
+      body
+    }
+  );
 }
 function indentBlock(text, indent2 = "    ") {
   return text.split("\n").map((line) => indent2 + line).join("\n");
@@ -8063,6 +8195,7 @@ function renderTriggerDetail(t) {
         ["Type", t.type],
         ["Status", t.status],
         ["Category", t.category ?? "\u2014"],
+        ["Source", t.source_connection_id ?? "\u2014"],
         ["Created", t.created_at ?? "\u2014"],
         ["Updated", t.updated_at ?? "\u2014"]
       ]
@@ -8129,7 +8262,15 @@ function formatTriggerTable(items) {
     auto: "AUTO",
     created: "CREATED"
   };
-  const cols = ["id", "status", "name", "type", "scan", "auto", "created"];
+  const cols = [
+    "id",
+    "status",
+    "name",
+    "type",
+    "scan",
+    "auto",
+    "created"
+  ];
   const widths = Object.fromEntries(
     cols.map((c) => [
       c,
@@ -8164,7 +8305,9 @@ Count:   ${p.count}`;
     cols.map((c) => [c, Math.max(c.length, ...rows.map((r) => r[c].length))])
   );
   const fmt = (vals) => cols.map((c) => vals[c].padEnd(widths[c])).join("  ").trimEnd();
-  const headerLine = fmt(Object.fromEntries(cols.map((c) => [c, c.toUpperCase()])));
+  const headerLine = fmt(
+    Object.fromEntries(cols.map((c) => [c, c.toUpperCase()]))
+  );
   const note = p.sample.length < p.count ? `
 
 (showing first ${p.sample.length} of ${p.count})` : "";
@@ -8181,7 +8324,9 @@ function registerTriggersCommand(program3) {
     const opts = this.optsWithGlobals();
     const status = opts.status;
     if (status && status !== "active" && status !== "paused") {
-      console.error(`Error: --status must be "active" or "paused" (got "${status}").`);
+      console.error(
+        `Error: --status must be "active" or "paused" (got "${status}").`
+      );
       process.exit(1);
     }
     const query = new URLSearchParams();
@@ -8222,7 +8367,31 @@ function registerTriggersCommand(program3) {
   ).requiredOption(
     "--detection-query <q>",
     "source-native query \u2014 SQL string, or Firestore JSON (test it first with `hermes connections query`)"
-  ).requiredOption("--email-prompt <text>", "the drafting brief for per-user email copy").option("--name <name>", "human-readable name (auto-generated from the query if omitted)").option("--type <type>", "category tag", "custom").option("--sender <id>", "sender_identity_id").option("--auto-send", "send on detection without human approval (default off)").option("--cooldown-hours <n>", "don't re-fire for the same user within this window", (v) => Number(v)).option("--recurring", "allow re-fire after recurrence-cooldown-days").option("--recurrence-cooldown-days <n>", "days before a user is eligible again", (v) => Number(v)).option("--scan-interval-minutes <n>", "how often the scheduler fires", (v) => Number(v)).option("--category <category>", "transactional | marketing").option("--no-track-opens", "disable open tracking").option("--no-track-clicks", "disable click tracking").action(async function() {
+  ).requiredOption(
+    "--email-prompt <text>",
+    "the drafting brief for per-user email copy"
+  ).option(
+    "--name <name>",
+    "human-readable name (auto-generated from the query if omitted)"
+  ).option("--type <type>", "category tag", "custom").option(
+    "--source <id>",
+    "connection id to use as this trigger's detection source"
+  ).option("--sender <id>", "sender_identity_id").option(
+    "--auto-send",
+    "send on detection without human approval (default off)"
+  ).option(
+    "--cooldown-hours <n>",
+    "don't re-fire for the same user within this window",
+    (v) => Number(v)
+  ).option("--recurring", "allow re-fire after recurrence-cooldown-days").option(
+    "--recurrence-cooldown-days <n>",
+    "days before a user is eligible again",
+    (v) => Number(v)
+  ).option(
+    "--scan-interval-minutes <n>",
+    "how often the scheduler fires",
+    (v) => Number(v)
+  ).option("--category <category>", "transactional | marketing").option("--no-track-opens", "disable open tracking").option("--no-track-clicks", "disable click tracking").action(async function() {
     const opts = this.optsWithGlobals();
     const body = {
       detection_query: parseDetectionQuery(String(opts.detectionQuery)),
@@ -8230,22 +8399,30 @@ function registerTriggersCommand(program3) {
     };
     if (opts.name !== void 0) body.name = opts.name;
     if (opts.type !== void 0) body.type = opts.type;
+    if (opts.source !== void 0) body.source_connection_id = opts.source;
     if (opts.sender !== void 0) body.sender_identity_id = opts.sender;
     if (opts.autoSend !== void 0) body.auto_send = Boolean(opts.autoSend);
-    if (opts.cooldownHours !== void 0) body.cooldown_hours = Number(opts.cooldownHours);
-    if (opts.recurring !== void 0) body.is_recurring = Boolean(opts.recurring);
+    if (opts.cooldownHours !== void 0)
+      body.cooldown_hours = Number(opts.cooldownHours);
+    if (opts.recurring !== void 0)
+      body.is_recurring = Boolean(opts.recurring);
     if (opts.recurrenceCooldownDays !== void 0)
       body.recurrence_cooldown_days = Number(opts.recurrenceCooldownDays);
     if (opts.scanIntervalMinutes !== void 0)
       body.scan_interval_minutes = Number(opts.scanIntervalMinutes);
     if (opts.category !== void 0) body.category = opts.category;
-    if (opts.trackOpens !== void 0) body.track_opens = Boolean(opts.trackOpens);
-    if (opts.trackClicks !== void 0) body.track_clicks = Boolean(opts.trackClicks);
+    if (opts.trackOpens !== void 0)
+      body.track_opens = Boolean(opts.trackOpens);
+    if (opts.trackClicks !== void 0)
+      body.track_clicks = Boolean(opts.trackClicks);
     try {
-      const result = await apiFetch("/api/v1/triggers", {
-        method: "POST",
-        body
-      });
+      const result = await apiFetch(
+        "/api/v1/triggers",
+        {
+          method: "POST",
+          body
+        }
+      );
       if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
@@ -8270,26 +8447,50 @@ function registerTriggersCommand(program3) {
       emitApiError(err, Boolean(opts.json));
     }
   });
-  triggers.command("update <id>").description("Update operational fields, plus the detection query / email prompt").option("--name <name>", "\u2192 name").option("--detection-query <q>", "\u2192 detection_query (re-validated against the live source)").option("--email-prompt <text>", "\u2192 email_prompt").option("--sender <id>", "\u2192 sender_identity_id").option("--auto-send", "\u2192 auto_send=true").option("--no-auto-send", "\u2192 auto_send=false").option("--cooldown-hours <n>", "\u2192 cooldown_hours", (v) => Number(v)).option("--recurring", "\u2192 is_recurring=true").option("--no-recurring", "\u2192 is_recurring=false").option("--recurrence-cooldown-days <n>", "\u2192 recurrence_cooldown_days", (v) => Number(v)).option("--scan-interval-minutes <n>", "\u2192 scan_interval_minutes", (v) => Number(v)).option("--category <category>", "\u2192 category (transactional | marketing)").option("--track-opens", "\u2192 track_opens=true").option("--no-track-opens", "\u2192 track_opens=false").option("--track-clicks", "\u2192 track_clicks=true").option("--no-track-clicks", "\u2192 track_clicks=false").action(async function(id) {
+  triggers.command("update <id>").description(
+    "Update operational fields, plus the detection query / email prompt"
+  ).option("--name <name>", "\u2192 name").option(
+    "--detection-query <q>",
+    "\u2192 detection_query (re-validated against the live source)"
+  ).option(
+    "--source <id>",
+    "\u2192 source_connection_id (re-validates the detection query)"
+  ).option("--email-prompt <text>", "\u2192 email_prompt").option("--sender <id>", "\u2192 sender_identity_id").option("--auto-send", "\u2192 auto_send=true").option("--no-auto-send", "\u2192 auto_send=false").option("--cooldown-hours <n>", "\u2192 cooldown_hours", (v) => Number(v)).option("--recurring", "\u2192 is_recurring=true").option("--no-recurring", "\u2192 is_recurring=false").option(
+    "--recurrence-cooldown-days <n>",
+    "\u2192 recurrence_cooldown_days",
+    (v) => Number(v)
+  ).option(
+    "--scan-interval-minutes <n>",
+    "\u2192 scan_interval_minutes",
+    (v) => Number(v)
+  ).option("--category <category>", "\u2192 category (transactional | marketing)").option("--track-opens", "\u2192 track_opens=true").option("--no-track-opens", "\u2192 track_opens=false").option("--track-clicks", "\u2192 track_clicks=true").option("--no-track-clicks", "\u2192 track_clicks=false").action(async function(id) {
     const opts = this.optsWithGlobals();
     const body = {};
     if (opts.name !== void 0) body.name = opts.name;
     if (opts.detectionQuery !== void 0)
       body.detection_query = parseDetectionQuery(String(opts.detectionQuery));
-    if (opts.emailPrompt !== void 0) body.email_prompt = String(opts.emailPrompt);
+    if (opts.source !== void 0) body.source_connection_id = opts.source;
+    if (opts.emailPrompt !== void 0)
+      body.email_prompt = String(opts.emailPrompt);
     if (opts.sender !== void 0) body.sender_identity_id = opts.sender;
     if (opts.autoSend !== void 0) body.auto_send = Boolean(opts.autoSend);
-    if (opts.cooldownHours !== void 0) body.cooldown_hours = Number(opts.cooldownHours);
-    if (opts.recurring !== void 0) body.is_recurring = Boolean(opts.recurring);
+    if (opts.cooldownHours !== void 0)
+      body.cooldown_hours = Number(opts.cooldownHours);
+    if (opts.recurring !== void 0)
+      body.is_recurring = Boolean(opts.recurring);
     if (opts.recurrenceCooldownDays !== void 0)
       body.recurrence_cooldown_days = Number(opts.recurrenceCooldownDays);
     if (opts.scanIntervalMinutes !== void 0)
       body.scan_interval_minutes = Number(opts.scanIntervalMinutes);
     if (opts.category !== void 0) body.category = opts.category;
-    if (opts.trackOpens !== void 0) body.track_opens = Boolean(opts.trackOpens);
-    if (opts.trackClicks !== void 0) body.track_clicks = Boolean(opts.trackClicks);
+    if (opts.trackOpens !== void 0)
+      body.track_opens = Boolean(opts.trackOpens);
+    if (opts.trackClicks !== void 0)
+      body.track_clicks = Boolean(opts.trackClicks);
     if (Object.keys(body).length === 0) {
-      console.error("Error: provide at least one field to update (e.g. --name, --cooldown-hours).");
+      console.error(
+        "Error: provide at least one field to update (e.g. --name, --cooldown-hours)."
+      );
       process.exit(1);
     }
     try {
@@ -8298,14 +8499,18 @@ function registerTriggersCommand(program3) {
         console.log(JSON.stringify(trigger, null, 2));
       } else {
         const changed = Object.keys(body).join(", ");
-        console.log(`Updated "${trigger.name}" (${trigger.id}). Fields: ${changed}.`);
+        console.log(
+          `Updated "${trigger.name}" (${trigger.id}). Fields: ${changed}.`
+        );
       }
       process.exit(0);
     } catch (err) {
       emitApiError(err, Boolean(opts.json));
     }
   });
-  triggers.command("preview <id>").description("Dry-run the detection query \u2014 returns count + sample, no drafts created").action(async function(id) {
+  triggers.command("preview <id>").description(
+    "Dry-run the detection query \u2014 returns count + sample, no drafts created"
+  ).action(async function(id) {
     const opts = this.optsWithGlobals();
     try {
       const result = await apiFetch(
@@ -8360,7 +8565,9 @@ function registerTriggersCommand(program3) {
       if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`Enqueued trigger ${result.trigger_id} (job ${result.job_id ?? "?"}).`);
+        console.log(
+          `Enqueued trigger ${result.trigger_id} (job ${result.job_id ?? "?"}).`
+        );
       }
       process.exit(0);
     } catch (err) {
@@ -8428,7 +8635,7 @@ var init_program = __esm({
     ).version("0.0.1").option("--org <slug>", "operate on this org (overrides ./.hermes/project.json)").option("--json", "emit structured JSON instead of human-readable output").option("--no-wait", "for async ops, return job_id immediately instead of polling").showHelpAfterError("(run with --help for usage)").action(() => program2.help());
     program2.addHelpText(
       "afterAll",
-      "\nDocs:   https://docs.tryhermes.dev\nSkill:  npx skills add tryhermes/skill   (teach your agent to drive this CLI)\nRun:    npx -y @tryhermes/cli@latest <command>   (always latest)"
+      "\nDocs:   https://docs.tryhermes.dev\nSkill:  npx skills add JaehoonSon/tryhermes-skill   (teach your agent to drive this CLI)\nRun:    npx -y @tryhermes/cli@latest <command>   (always latest)"
     );
     program2.hook("preAction", (_thisCommand, actionCommand) => {
       setGlobalOrgOverride(actionCommand.optsWithGlobals().org);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryhermes/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Hermes CLI — drive the agentic email platform (connections, triggers, drafts, sends) from the terminal.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -22,8 +22,8 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
-    "@workspace/api-types": "0.0.1",
     "@workspace/eslint-config": "0.0.0",
+    "@workspace/api-types": "0.0.1",
     "@workspace/typescript-config": "0.0.0"
   },
   "scripts": {