@itznexus/itznexus-cli 1.142.0 → 1.144.0

package/dist/commands/api/outreach-settings.js

@@ -0,0 +1,193 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { api } from "../../lib/api.js";
+import { handleError, printList } from "../../lib/format.js";
+import { compact, csv, done, nullable, printJson, readJsonObject, } from "../../lib/command-helpers.js";
+const THRESHOLD_KEYS = "dailyMessage1Cap, dailySendCeiling, bounceRateCeiling (fraction), spamRateCeiling (fraction), draftStaleDays, finderScoreFloor, reEnrollmentMonths, lateReplyDays";
+function printSettings(data) {
+    const lines = [
+        ["mailbox", data.mailbox],
+        ["signature", data.signature],
+        ["catchAllPolicy", data.catchAllPolicy],
+        ["forbiddenTerms", data.forbiddenTerms.join(", ") || null],
+    ];
+    for (const [key, value] of lines) {
+        console.log(`  ${key.padEnd(30)} ${value ?? chalk.dim("-")}`);
+    }
+    for (const [key, value] of Object.entries(data.thresholds)) {
+        const changed = data.defaults[key] !== value;
+        const suffix = changed ? chalk.dim(` (default ${data.defaults[key]})`) : "";
+        console.log(`  ${key.padEnd(30)} ${value}${suffix}`);
+    }
+}
+function parseThresholds(pairs) {
+    const thresholds = {};
+    for (const pair of pairs) {
+        const [key, value] = pair.split("=");
+        if (!key || value === undefined) {
+            throw new Error(`Expected key=value, got "${pair}"`);
+        }
+        const n = Number(value.trim());
+        if (value.trim() === "" || !Number.isFinite(n)) {
+            throw new Error(`${key} must be a number`);
+        }
+        thresholds[key.trim()] = n;
+    }
+    return thresholds;
+}
+const settingsGet = new Command("get")
+    .description("Show the Outreach settings: mailbox, signature, forbidden terms, catch-all policy, thresholds (with defaults)")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const data = await api.get("/outreach/settings");
+        if (opts.json)
+            printJson(data);
+        else
+            printSettings(data);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const settingsSet = new Command("set")
+    .description("Change one or more Outreach settings; unset ones keep their value")
+    .option("--mailbox <email>", 'Sending mailbox ("null" to clear)')
+    .option("--signature <text>", 'Signature appended to drafts ("null" to clear)')
+    .option("--forbidden-terms <list>", 'Comma-separated terms no draft may contain, replaces the list ("none" to clear)')
+    .option("--catch-all-policy <policy>", "pattern-confirmed | never")
+    .option("--threshold <key=value...>", `Threshold to set, repeatable (e.g. --threshold dailyMessage1Cap=8); keys: ${THRESHOLD_KEYS}`)
+    .option("--file <path>", "JSON object with any of the fields above (camelCase, thresholds as an object); flags win")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const fromFile = opts.file ? readJsonObject(opts.file) : {};
+        const body = {
+            ...fromFile,
+            ...compact({
+                mailbox: nullable(opts.mailbox),
+                signature: nullable(opts.signature),
+                forbiddenTerms: opts.forbiddenTerms === undefined
+                    ? undefined
+                    : opts.forbiddenTerms === "none"
+                        ? []
+                        : csv(opts.forbiddenTerms),
+                catchAllPolicy: opts.catchAllPolicy,
+                thresholds: opts.threshold
+                    ? {
+                        ...fromFile.thresholds,
+                        ...parseThresholds(opts.threshold),
+                    }
+                    : undefined,
+            }),
+        };
+        if (!Object.keys(body).length) {
+            throw new Error("Nothing to set: pass at least one option");
+        }
+        const data = await api.post("/outreach/settings", body);
+        if (opts.json)
+            printJson(data);
+        else
+            printSettings(data);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const settingsCommand = new Command("settings")
+    .description("Outreach settings: mailbox, signature, forbidden terms, catch-all policy, thresholds")
+    .addCommand(settingsGet)
+    .addCommand(settingsSet);
+const sourceList = new Command("list")
+    .description("List data sources with their last successful pull")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const data = await api.get("/outreach/data-sources");
+        printList(data, [
+            { key: "source", label: "Source", width: 14 },
+            { key: "lastSuccessAt", label: "Last success", width: 26 },
+            { key: "lastAttemptAt", label: "Last attempt", width: 26 },
+            { key: "lastError", label: "Last error", width: 40 },
+        ], opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const sourceStamp = new Command("stamp")
+    .description("Record the outcome of a pull from a data source")
+    .argument("<source>", "Data source: gmail | hunter | sirene | bodacc | pappers | lbr | linkedin | wttj | funding-feeds | postmaster")
+    .requiredOption("--outcome <outcome>", "success | failure")
+    .option("--error <text>", "What failed (required with --outcome failure)")
+    .option("--at <iso>", "When the pull ran (ISO datetime, defaults to now)")
+    .option("--json", "Output as JSON")
+    .action(async (source, opts) => {
+    try {
+        const data = await api.post(`/outreach/data-sources/${source}/stamp`, compact({ outcome: opts.outcome, error: opts.error, at: opts.at }));
+        done(data, opts, `Stamped ${source}: ${opts.outcome}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const sourceCommand = new Command("source")
+    .description("Data-source status, stamped by the skill that ran each pull")
+    .addCommand(sourceList)
+    .addCommand(sourceStamp);
+const accessList = new Command("list")
+    .description("List the users holding Outreach access")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const data = await api.get("/outreach/access");
+        printList(data, [
+            { key: "email", label: "Email", width: 32 },
+            { key: "name", label: "Name", width: 20 },
+            { key: "type", label: "Type", width: 8 },
+            { key: "userId", label: "User id", width: 36 },
+        ], opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const accessGrant = new Command("grant")
+    .description("Grant Outreach access to an internal user (human callers only)")
+    .argument("<user>", "User id or email")
+    .option("--json", "Output as JSON")
+    .action(async (user, opts) => {
+    try {
+        const data = await api.post("/outreach/access", {
+            user,
+        });
+        done(data, opts, `Outreach access granted to ${data.email}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const accessRevoke = new Command("revoke")
+    .description("Revoke a user's Outreach access (human callers only; the last human grant stays)")
+    .argument("<userId>", "User id")
+    .option("--json", "Output as JSON")
+    .action(async (userId, opts) => {
+    try {
+        const data = await api.delete(`/outreach/access/${userId}`);
+        done(data, opts, `Outreach access revoked for ${userId}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const accessCommand = new Command("access")
+    .description("Who can read and write Outreach data (per-user grants)")
+    .addCommand(accessList)
+    .addCommand(accessGrant)
+    .addCommand(accessRevoke);
+export const outreachSettingsCommands = [
+    settingsCommand,
+    sourceCommand,
+    accessCommand,
+];
+//# sourceMappingURL=outreach-settings.js.map

package/dist/commands/api/outreach-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outreach-settings.js","sourceRoot":"","sources":["../../../src/commands/api/outreach-settings.ts"],"names":[],"mappings":"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"}

package/dist/commands/api/outreach-shared.d.ts

@@ -0,0 +1,24 @@
+import { Command } from "commander";
+import { type JsonOpt } from "../../lib/command-helpers.js";
+export declare const LANGUAGES = "en | fr";
+export declare const SIGNALS = "hiring | fundraise | registration | cohort | agency | warm | event | partner";
+export declare const CHANNELS = "email | linkedin";
+type Column = {
+    key: string;
+    label: string;
+    width?: number;
+};
+export type PageOpts = JsonOpt & {
+    page?: string;
+    pageSize?: string;
+};
+export type DroppedDraft = {
+    enrollmentId: string;
+    n: number;
+    gmailDraftId: string | null;
+};
+export declare function withPageOptions(cmd: Command): Command;
+export declare function printPage<T>(path: string, columns: Column[], opts: JsonOpt, shape: (row: T) => Record<string, unknown>): Promise<void>;
+export declare function fullName(first: string, last: string | null): string;
+export declare function printDroppedDrafts(drafts: DroppedDraft[]): void;
+export {};

package/dist/commands/api/outreach-shared.js

@@ -0,0 +1,34 @@
+import chalk from "chalk";
+import { api } from "../../lib/api.js";
+import { printList } from "../../lib/format.js";
+import { printJson } from "../../lib/command-helpers.js";
+export const LANGUAGES = "en | fr";
+export const SIGNALS = "hiring | fundraise | registration | cohort | agency | warm | event | partner";
+export const CHANNELS = "email | linkedin";
+export function withPageOptions(cmd) {
+    return cmd
+        .option("--page <n>", "Page number (default 1)")
+        .option("--page-size <n>", "Page size (default 100, max 1000)")
+        .option("--json", "Output as JSON ({ data, meta })");
+}
+export async function printPage(path, columns, opts, shape) {
+    const { data, meta } = await api.getWithMeta(path);
+    if (opts.json) {
+        printJson({ data, meta });
+        return;
+    }
+    printList(data.map(shape), columns, opts);
+    if (meta) {
+        console.log(chalk.dim(`page ${meta.page}/${meta.totalPages}, ${meta.total} total`));
+    }
+}
+export function fullName(first, last) {
+    return last ? `${first} ${last}` : first;
+}
+// The API never calls Gmail: the caller deletes these drafts there.
+export function printDroppedDrafts(drafts) {
+    for (const d of drafts) {
+        console.log(chalk.yellow(`  dropped draft: enrollment ${d.enrollmentId} step ${d.n}, Gmail draft ${d.gmailDraftId ?? "-"}`));
+    }
+}
+//# sourceMappingURL=outreach-shared.js.map

package/dist/commands/api/outreach-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outreach-shared.js","sourceRoot":"","sources":["../../../src/commands/api/outreach-shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAgB,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AACnC,MAAM,CAAC,MAAM,OAAO,GAClB,8EAA8E,CAAC;AACjF,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAmB3C,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG;SACP,MAAM,CAAC,YAAY,EAAE,yBAAyB,CAAC;SAC/C,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;SAC9D,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,OAAiB,EACjB,IAAa,EACb,KAA0C;IAE1C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,CAAgB,IAAI,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,KAAK,QAAQ,CAAC,CACvE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,IAAmB;IACzD,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,+BAA+B,CAAC,CAAC,YAAY,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,YAAY,IAAI,GAAG,EAAE,CAClG,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/api/outreach-signals.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const outreachSignalCommand: Command;

package/dist/commands/api/outreach-signals.js

@@ -0,0 +1,80 @@
+import { Command } from "commander";
+import { api } from "../../lib/api.js";
+import { handleError } from "../../lib/format.js";
+import { compact, done, qs, readJsonRows, } from "../../lib/command-helpers.js";
+import { printPage, SIGNALS, withPageOptions, } from "./outreach-shared.js";
+// The API's per-request cap on a signal import; larger files are chunked here.
+const SIGNALS_PER_REQUEST = 500;
+const listCmd = withPageOptions(new Command("list")
+    .description("List signal hits, newest first")
+    .option("--status <status>", "new | kept | dropped | duplicate")
+    .option("--source <source>", "Source that produced the hit (kebab-case)")
+    .option("--signal <signal>", SIGNALS)
+    .option("--company-id <id>", "Hits linked to one company")).action(async (opts) => {
+    try {
+        await printPage(`/outreach/signals${qs({
+            status: opts.status,
+            source: opts.source,
+            signal: opts.signal,
+            companyId: opts.companyId,
+            page: opts.page,
+            pageSize: opts.pageSize,
+        })}`, [
+            { key: "firstSeenAt", label: "First seen", width: 24 },
+            { key: "source", label: "Source", width: 14 },
+            { key: "signal", label: "Signal", width: 12 },
+            { key: "marketCode", label: "Mkt", width: 3 },
+            { key: "state", label: "Status", width: 20 },
+            { key: "companyName", label: "Company", width: 24 },
+            { key: "title", label: "Title", width: 40 },
+            { key: "id", label: "Id", width: 36 },
+        ], opts, (s) => ({
+            ...s,
+            state: s.dropReason ? `${s.status} (${s.dropReason})` : s.status,
+        }));
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const importCmd = new Command("import")
+    .description("Upsert signal hits from a JSON file, keyed by (source, externalId); a hit seen again refreshes its fields, never its status")
+    .requiredOption("--file <path>", "JSON array (or {signals}) of {source, externalId, signal, marketCode?, url, title?, companyName?, companyDomain?, payload?, seenAt?}")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const signals = readJsonRows(opts.file, "signals");
+        const total = { created: 0, updated: 0 };
+        for (let i = 0; i < signals.length; i += SIGNALS_PER_REQUEST) {
+            const res = await api.post("/outreach/signals", { signals: signals.slice(i, i + SIGNALS_PER_REQUEST) });
+            total.created += res.created;
+            total.updated += res.updated;
+        }
+        done(total, opts, `Signals imported: ${total.created} created, ${total.updated} updated`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const decideCmd = new Command("decide")
+    .description("Decide a signal hit: kept (with the company it produced), dropped (with a reason), or duplicate")
+    .argument("<id>", "Signal id")
+    .argument("<status>", "kept | dropped | duplicate")
+    .option("--reason <text>", "Why (required for dropped)")
+    .option("--company-id <id>", "Company the hit produced (required for kept)")
+    .option("--json", "Output as JSON")
+    .action(async (id, status, opts) => {
+    try {
+        const data = await api.post(`/outreach/signals/${id}/decision`, compact({ status, reason: opts.reason, companyId: opts.companyId }));
+        done(data, opts, `Signal ${data.id}: ${data.status}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+export const outreachSignalCommand = new Command("signal")
+    .description("Signal hits (hiring, fundraise, registration...) pulled from the data sources, triaged into companies")
+    .addCommand(listCmd)
+    .addCommand(importCmd)
+    .addCommand(decideCmd);
+//# sourceMappingURL=outreach-signals.js.map

package/dist/commands/api/outreach-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outreach-signals.js","sourceRoot":"","sources":["../../../src/commands/api/outreach-signals.ts"],"names":[],"mappings":"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"}

package/dist/commands/api/outreach.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const outreachCommand: Command;

package/dist/commands/api/outreach.js

@@ -0,0 +1,21 @@
+import { Command } from "commander";
+import { outreachSettingsCommands } from "./outreach-settings.js";
+import { outreachCatalogCommands } from "./outreach-catalog.js";
+import { outreachSignalCommand } from "./outreach-signals.js";
+import { outreachCompanyCommand } from "./outreach-companies.js";
+import { outreachProspectCommand } from "./outreach-prospects.js";
+import { outreachEnrollmentCommand } from "./outreach-enrollments.js";
+// `itznexus outreach ...`: the Outreach section (every /outreach route needs
+// an Outreach access grant, reads included).
+export const outreachCommand = new Command("outreach").description("Outreach section: settings, markets, sequences, signals, companies, prospects, enrollments");
+for (const cmd of [
+    ...outreachSettingsCommands,
+    ...outreachCatalogCommands,
+    outreachSignalCommand,
+    outreachCompanyCommand,
+    outreachProspectCommand,
+    outreachEnrollmentCommand,
+]) {
+    outreachCommand.addCommand(cmd);
+}
+//# sourceMappingURL=outreach.js.map

package/dist/commands/api/outreach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outreach.js","sourceRoot":"","sources":["../../../src/commands/api/outreach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,6EAA6E;AAC7E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAChE,4FAA4F,CAC7F,CAAC;AAEF,KAAK,MAAM,GAAG,IAAI;IAChB,GAAG,wBAAwB;IAC3B,GAAG,uBAAuB;IAC1B,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,yBAAyB;CAC1B,EAAE,CAAC;IACF,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/commands/api/projects.js

@@ -8,6 +8,7 @@ import { printList, printDetail, handleError } from "../../lib/format.js";
 import { cleanupStaleInstructionFiles, fetchProjectByRef, fetchRenderedInstructions, findInstructionConflicts, syncInstructionFiles, } from "../../lib/project-context.js";
 import { cleanupStaleEnvFiles, fetchRenderedEnvFiles, findEnvConflicts, syncEnvFiles, } from "../../lib/project-env-files.js";
 import { instructionsCommand } from "./project-instructions.js";
+import { stackCommand } from "../agents/project-stack.js";
 import { projectEnvCommand } from "./project-env.js";
 import { projectCapabilityCommand } from "./project-capabilities.js";
 import { projectArtifactCommand } from "./project-artifacts.js";
@@ -1095,6 +1096,7 @@ export const projectCommand = new Command("project")
     .addCommand(descriptionCommand)
     .addCommand(technicalDescriptionCommand)
     .addCommand(instructionsCommand)
+    .addCommand(stackCommand)
     .addCommand(organizationCommand)
     .addCommand(personCommand)
     .addCommand(leadCommand)