@letterstory/cli 0.103.0 → 0.104.0

package/README.md

@@ -441,6 +441,7 @@ letterstory admin crm capture thread.png --context "this is for tryordinal.com"
                                                        # a screenshot → a lead: what it read, which account
 letterstory admin crm capture thread.png --context "this is for tryordinal.com"  # …and for real
 letterstory admin crm capture --text-file notes.txt    # pasted text or notes work the same way
+letterstory admin crm capture thread.png --retry       # sent before, some entries didn't save: write only what's missing
 
 # One-click onboarding of a won client (key needs crm:write + fleet:onboard + org:create)
 letterstory admin crm onboard <account-id> --domain acme.com \

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.103.0";
+export const VERSION = "0.104.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -773,7 +773,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        Needs spend:read (reads) / spend:write (writes).
   admin crm import <file.csv> [--source <name>] [--tag "…"] [--dry-run]
           | capture [shot.png …] [--text "…" | --text-file f] [--context "this is for acme.com"]
-                    [--account <id>] [--dry-run]   screenshots / a thread / a note → a lead
+                    [--account <id>] [--dry-run] [--retry]   screenshots / a thread / a note → a lead
           | signals [--status new] [--intent qualified] [--source rb2b] [--account <id>]
           | record --title "…" [--source bookface] [--kind other] [--intent qualified]
                    [--name …] [--email …] [--company …] [--domain …] [--linkedin …] [--detail …]
@@ -1172,9 +1172,12 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo branches --repo owner/name                      Branches a change can start from (default first)
   repo suggestions                                     Fixes found and not acted on yet, and how to start each
   repo settings [--action build|build_pr|slack] [--branch <name>|none] [--slack-agent <name|U…>|none]
+                [--slack-channel <C…>|none]
                                                        The org's defaults for every fix: build (preview first),
-                                                       build_pr, or slack (post it for your own agent, tagging
-                                                       --slack-agent), and the branch changes go to
+                                                       build_pr, or slack (post it to --slack-channel for your
+                                                       own agent, tagging --slack-agent), and the branch changes go to
+  repo slack-targets                                   Slack channels and people Send to Slack can use, with ids
+  repo slack-test                                      Post a test into the Send to Slack channel
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]...
              [--action build|build_pr|slack] [--wait]

package/lib/commands/admin.mjs

@@ -2777,7 +2777,7 @@ const CRM_CAPTURE_TYPES = {
 async function cmdAdminCrmCapture(ctx, paths) {
 	const { flags, io } = ctx;
 	const usage =
-		'Usage: admin crm capture [image.png …] [--text "…" | --text-file notes.txt] [--context "this is for acme.com"] [--account <id>] [--dry-run]';
+		'Usage: admin crm capture [image.png …] [--text "…" | --text-file notes.txt] [--context "this is for acme.com"] [--account <id>] [--dry-run] [--retry]';
 	const images = paths.map((path) => {
 		const media_type = CRM_CAPTURE_TYPES[path.split(".").pop()?.toLowerCase() ?? ""];
 		if (!media_type) throw new CliError(`${path}: only png, jpg, gif and webp screenshots can be read`);
@@ -2807,6 +2807,8 @@ async function cmdAdminCrmCapture(ctx, paths) {
 			account_id: flagStr(flags.account),
 			source: flagStr(flags.source) ?? "agent",
 			dry_run: flagBool(flags["dry-run"]) || undefined,
+			// Sent before but some entries didn't save: read it again, writing only what isn't in.
+			retry: flagBool(flags.retry) || undefined,
 		})
 	);
 	if (flagBool(flags.json)) return printResult(io, flags, r);
@@ -2835,7 +2837,9 @@ export function captureSummary(r) {
 	if (r.batch) {
 		const width = Math.max(...r.batch.map((b) => (BATCH_STATUS[b.status] ?? b.status).length), 0);
 		return [
-			`${r.dryRun ? "would save" : "saved"} ${r.accountName ?? `${r.batch.length} entries`}`,
+			r.duplicate
+				? `sent before: ${r.accountName ?? `${r.batch.length} already in`}`
+				: `${r.dryRun ? "would save" : "saved"} ${r.accountName ?? `${r.batch.length} entries`}`,
 			...r.batch.map((b) => {
 				const status = (BATCH_STATUS[b.status] ?? b.status).padEnd(width);
 				const where = b.accountName ?? b.companyName ?? "?";
@@ -2847,12 +2851,13 @@ export function captureSummary(r) {
 			}),
 		];
 	}
-	const verb = r.dryRun
-		? r.accountId
-			? "would add to"
-			: "would create"
-		: r.duplicate
-			? "already captured →"
+	// A preview says "sent before" too (the app checks before it reads), so that comes first.
+	const verb = r.duplicate
+		? "already captured →"
+		: r.dryRun
+			? r.accountId
+				? "would add to"
+				: "would create"
 			: r.accountCreated
 				? "created"
 				: "added to";
@@ -2876,7 +2881,7 @@ export function captureSummary(r) {
  *   outreach add "Jane Doe" [--company …] [--owner …] [--channel x] [--relationship …]
  *                [--ask …] [--linkedin …] [--email …] [--lookup]
  *   outreach lookup "Jane Doe from Acme" [shot.png …]  prefilled from the web; writes nothing
- *   outreach relookup [--missing linkedin]           the web lookup again for whoever lacks it
+ *   outreach relookup [--missing linkedin|company|location|any]   the web lookup again for whoever lacks it
  *   outreach drafts [--kind ask|thanks] [--owner …]  drafts or thank-yous for everyone without one
  *   outreach engagement --outcome upvoted [shot.png] who upvoted, matched by exact name
  *   outreach customers [--dry-run]                   every customer's primary contact onto the list
@@ -2949,6 +2954,7 @@ async function cmdAdminCrmOutreach(ctx, args) {
 			for (const p of r.created) io.log(`added ${line(p)}`);
 			for (const d of r.duplicates)
 				io.log(`already on the list: ${d.existingName} (matched on ${d.matchedOn})  ${d.existingId}`);
+			for (const x of r.skipped ?? []) io.log(`not added: ${x.name} (${x.reason})`);
 			return;
 		}
 		case "lookup": {
@@ -2999,7 +3005,7 @@ async function cmdAdminCrmOutreach(ctx, args) {
 			return json ? printResult(io, flags, r) : io.log(line(r));
 		}
 		case "relookup": {
-			// admin crm outreach relookup [--missing linkedin|company|any] — the web lookup again,
+			// admin crm outreach relookup [--missing linkedin|company|location|any] — the web lookup again,
 			// filling only blanks, calling until none remain (a dozen people per call).
 			const missing = flagStr(flags.missing) ?? "linkedin";
 			let total = 0;
@@ -3081,9 +3087,12 @@ async function cmdAdminCrmOutreach(ctx, args) {
 			);
 			if (json) return printResult(io, flags, r);
 			return io.log(
-				r.dryRun
+				(r.dryRun
 					? `would add up to ${r.candidates.length}: ${r.candidates.join(", ")}`
-					: `added ${r.created.length}; already on the list: ${r.duplicates.length}`
+					: `added ${r.created.length}; already on the list: ${r.duplicates.length}`) +
+					(r.skipped?.length
+						? `\nnot added (on the no-contact list): ${r.skipped.map((x) => x.name).join(", ")}`
+						: "")
 			);
 		}
 		case "catch-up": {

package/lib/commands/repo.mjs

@@ -7,6 +7,7 @@
 //   repo install-letterprove → letterprove_open_install_pr
 //   repo suggestions → list_suggested_fixes
 //   repo settings → get_repo_change_settings, or set_repo_change_settings with --action / --branch
+//   repo slack-targets → list_slack_fix_targets   repo slack-test → send_slack_test_message
 
 import { readFileSync } from "node:fs";
 import { basename } from "node:path";
@@ -81,12 +82,18 @@ const ARGS = {
 	},
 	get_repo_change_settings: {},
 	list_suggested_fixes: {},
+	list_slack_fix_targets: {},
+	send_slack_test_message: {},
 	set_repo_change_settings: {
 		default_action: { flag: "action", enum: ["build", "build_pr", "slack"] },
 		// --branch <name>, or --branch none for each repo's own default.
 		default_branch: { value: (flags) => (flags.branch === "none" ? null : flagStr(flags.branch)) },
 		// --slack-agent Devin (or a U… member id), or --slack-agent none to tag nobody.
 		slack_agent: { value: (flags) => (flags["slack-agent"] === "none" ? null : flagStr(flags["slack-agent"])) },
+		// --slack-channel C0123ABCD (from repo slack-targets), or none for the first linked channel.
+		slack_channel: {
+			value: (flags) => (flags["slack-channel"] === "none" ? null : flagStr(flags["slack-channel"])),
+		},
 	},
 	get_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	cancel_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
@@ -151,9 +158,13 @@ export async function cmdRepo(ctx) {
 			return repoSettings(rest);
 		case "suggestions":
 			return repoSuggestions(rest);
+		case "slack-targets":
+			return repoSlackTargets(rest);
+		case "slack-test":
+			return repoSlackTest(rest);
 		default:
 			throw new CliError(
-				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, sites, set-site, reset-site, status, list, publish, cancel, repos, branches, settings, suggestions`
+				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, sites, set-site, reset-site, status, list, publish, cancel, repos, branches, settings, suggestions, slack-targets, slack-test`
 			);
 	}
 }
@@ -407,8 +418,12 @@ async function repoBranches(ctx) {
  */
 async function repoSettings(ctx) {
 	const { client, flags, io } = ctx;
-	refuseUnknownFlags(ctx, {}, ["action", "branch", "slack-agent"]);
-	const setting = flags.action !== undefined || flags.branch !== undefined || flags["slack-agent"] !== undefined;
+	refuseUnknownFlags(ctx, {}, ["action", "branch", "slack-agent", "slack-channel"]);
+	const setting =
+		flags.action !== undefined ||
+		flags.branch !== undefined ||
+		flags["slack-agent"] !== undefined ||
+		flags["slack-channel"] !== undefined;
 	const result = setting
 		? await client.callTool("set_repo_change_settings", argsFromFlags(ARGS.set_repo_change_settings, flags))
 		: await client.callTool("get_repo_change_settings", {});
@@ -441,4 +456,30 @@ async function repoSuggestions(ctx) {
 	return 0;
 }
 
+/** `repo slack-targets`: the channels and people Send to Slack can use, with their ids. */
+async function repoSlackTargets(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, []);
+	const result = await client.callTool("list_slack_fix_targets", {});
+	printResult(io, flags, result, (r) =>
+		[
+			"Channels (repo settings --slack-channel <id>):",
+			...r.channels.map((c) => `  ${c.id}  #${c.name}`),
+			"People (repo settings --slack-agent <id>):",
+			...r.people.map((p) => `  ${p.id}  ${p.name}${p.is_bot ? " (bot)" : ""}`),
+		].join("\n")
+	);
+	return 0;
+}
+
+/** `repo slack-test`: post a test into the Send to Slack channel. */
+async function repoSlackTest(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, []);
+	const result = await client.callTool("send_slack_test_message", {});
+	ok(ctx, result.message);
+	printResult(io, flags, result);
+	return 0;
+}
+
 export { ARGS };

package/lib/commands/site.mjs

@@ -128,6 +128,7 @@ const ARGS = {
 		},
 		base_branch: { flag: "base-branch" },
 		preview: { flag: "preview", type: "bool" },
+		action: { flag: "action", enum: ["build", "build_pr", "slack"] },
 	},
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.103.0",
+	"version": "0.104.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",