@series-a/cli 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to this package are documented here. This project follows
 [Semantic Versioning](https://semver.org/) and uses
 [Changesets](https://github.com/changesets/changesets) to manage releases.
 
+## 1.5.0 — Calendar control, references, analytics report, safer campaign holds
+
+Version follows 1.4.1, the latest release on npm (it was published without a changelog entry).
+
+- Calendar: `calendar schedule <id> --at <iso>` moves or reschedules a post, `calendar unschedule <id>` cancels it and keeps the content as a draft, and `calendar delete <id>` removes it. All three cancel on Taplio first when Taplio owns the post. `content unschedule <id>` does the same from the content side.
+- Links: `references list|show|library|verify` shows the published links stored for each post and checks they still resolve.
+- Reports: `advisoros analytics report [--days n] [--format md|json] [--out file]` writes a full branded performance report (summary, outreach funnel, campaigns, content, revenue impact).
+- Campaigns (server-side, no CLI change needed): LinkedIn holds now last only until the time Madnion gives; with no time given the campaign retries within 5 minutes and asks Madnion again. "If accepted" always checks LinkedIn at send time, so someone who just accepted is no longer sent down the "No" path. Slow-setup campaigns always send at least one action per run. Wrong-name checks no longer block normal greetings such as "Hi, thanks for connecting".
+- Agents run Monday to Friday (UTC); manual runs still work on weekends.
+- Blog generation is white-label: no platform name or platform links in workspace content.
+
 ## 1.4.0 — Company news, brand imagery fix, API reliability
 
 Version jumps from 0.28.0 to 1.4.0 because npm already has releases up to 1.3.2.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-a/cli",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "AdvisorPro command-line interface — drive leads, campaigns, sequences and agents from your terminal.",
   "type": "module",
   "bin": {

package/src/commands/references.mjs

@@ -0,0 +1,76 @@
+import { call } from "../api.mjs";
+import { emit, fail, ctxFrom, withCommonOpts } from "../ui.mjs";
+
+const ok = (v) => (v === null || v === undefined ? "" : v ? "" : " (dead)");
+
+function printList(d) {
+  for (const r of d.references || []) {
+    const date = r.published_at ? String(r.published_at).slice(0, 10) : "----------";
+    process.stdout.write(`${date}  ${r.id}  ${r.title || "(untitled)"}\n`);
+    if (r.blog_url) process.stdout.write(`            blog:     ${r.blog_url}${ok(r.blog_ok)}\n`);
+    if (r.linkedin_url) process.stdout.write(`            linkedin: ${r.linkedin_url}${ok(r.linkedin_ok)}\n`);
+    if (r.missing_link) process.stdout.write(`            MISSING LINK — published but no address saved\n`);
+  }
+  for (const v of d.videos || []) process.stdout.write(`video       ${v.id}  ${v.title}\n            ${v.video_url}\n`);
+  process.stdout.write(`\n${d.total ?? 0} published post(s), ${d.missing_link_count ?? 0} without a saved link in this page.\n`);
+}
+
+export function registerReferences(program) {
+  const r = program
+    .command("references")
+    .alias("refs")
+    .description("Published links (blog, LinkedIn, video) that actually went out — the same list AI writers and replies use");
+
+  withCommonOpts(r.command("list"))
+    .description("List published links")
+    .option("--channel <c>", "blog | linkedin | video | all", "all")
+    .option("--since <date>", "only posts published on/after this date (YYYY-MM-DD)")
+    .option("--search <text>", "filter by title")
+    .option("--missing", "only published posts with no saved link")
+    .option("--limit <n>", "max rows (default 100, max 500)")
+    .action(async function (o) {
+      try {
+        const res = await call("references", "list", {
+          channel: o.channel, since: o.since, search: o.search, missing: !!o.missing,
+          limit: o.limit ? Number(o.limit) : undefined,
+        }, ctxFrom(this));
+        emit(this, res, printList);
+      } catch (e) { fail(e); }
+    });
+
+  withCommonOpts(r.command("show <id>"))
+    .alias("get")
+    .description("Show one published post's links and publishing records")
+    .action(async function (id) {
+      try {
+        const res = await call("references", "show", { id }, ctxFrom(this));
+        emit(this, res, (d) => {
+          printList({ references: [d.reference], total: 1, missing_link_count: d.reference?.missing_link ? 1 : 0 });
+          for (const x of d.distributions || []) process.stdout.write(`  ${x.platform} ${x.status} ${x.platform_url || "-"}\n`);
+        });
+      } catch (e) { fail(e); }
+    });
+
+  withCommonOpts(r.command("library"))
+    .description("Show exactly what the AI writers see, ranked for a topic")
+    .option("--topic <text>", "topic to rank by")
+    .option("--limit <n>", "how many (default 15)")
+    .action(async function (o) {
+      try {
+        const res = await call("references", "library", { topic: o.topic, limit: o.limit ? Number(o.limit) : undefined }, ctxFrom(this));
+        emit(this, res, (d) => {
+          for (const i of d.library || []) process.stdout.write(`${i.kind.padEnd(8)} ${i.title}\n         ${i.canonical_url || i.linkedin_url || i.video_url || ""}\n`);
+        });
+      } catch (e) { fail(e); }
+    });
+
+  withCommonOpts(r.command("verify"))
+    .description("Re-check that published links still work")
+    .option("--dry-run", "check without saving results")
+    .action(async function (o) {
+      try {
+        const res = await call("references", "verify", { dry_run: !!o.dryRun }, ctxFrom(this));
+        emit(this, res, (d) => process.stdout.write(JSON.stringify(d.verify, null, 2) + "\n"));
+      } catch (e) { fail(e); }
+    });
+}

package/src/index.mjs

@@ -1,6 +1,7 @@
 import { registerStrategies } from "./commands/strategies.mjs";
 import { registerVoice } from "./commands/voice.mjs";
 import { registerBrand } from "./commands/brand.mjs";
+import { registerReferences } from "./commands/references.mjs";
 import { registerResearch } from "./commands/research.mjs";
 import { Command } from "commander";
 import { readFileSync } from "node:fs";
@@ -45,6 +46,7 @@ registerPipelines(program);
 registerStrategies(program);
 registerVoice(program);
 registerBrand(program);
+registerReferences(program);
 registerAuthority(program);
 registerEmail(program);
 registerBriefs(program);