vidpipe 1.3.8 → 1.3.9

package/README.md

@@ -96,6 +96,9 @@ vidpipe --watch-dir ~/Videos/Recordings
 # Generate a saved idea bank for future recordings
 vidpipe ideate --topics "GitHub Copilot, Azure, TypeScript" --count 4
 
+# Add a single idea with AI enrichment
+vidpipe ideate --add --topic "Building CI/CD with GitHub Actions"
+
 # Full example with options
 vidpipe \
   --watch-dir ~/Videos/Recordings \
@@ -162,6 +165,17 @@ vidpipe doctor            # Check all prerequisites
 | `--format <format>` | Output format: `table` (default) or `json` |
 | `--output <dir>` | Ideas directory (default: `./ideas`) |
 | `--brand <path>` | Brand config path (default: `./brand.json`) |
+| `--add` | Create a single idea (AI-enriched by default) |
+| `--topic <topic>` | Topic for the idea (required with `--add`) |
+| `--hook <hook>` | Opening hook (AI-generated if omitted) |
+| `--audience <audience>` | Target audience (default: `"developers"`) |
+| `--platforms <list>` | Comma-separated platforms: `youtube,tiktok,instagram,linkedin,x` |
+| `--key-takeaway <msg>` | Core message (AI-generated if omitted) |
+| `--talking-points <list>` | Comma-separated talking points |
+| `--tags <list>` | Comma-separated categorization tags |
+| `--publish-by <date>` | Publish-by date (default: 14 days from now) |
+| `--trend-context <text>` | Trend research context |
+| `--no-ai` | Skip AI research agent, use CLI values + defaults |
 
 ---
 
@@ -233,6 +247,21 @@ vidpipe ideate --list --format json
 vidpipe process video.mp4 --ideas 12,15
 ```
 
+### Manual Idea Creation
+
+Add a single idea with AI enrichment or direct CLI values:
+
+```bash
+# AI-researched — full IdeationAgent with MCP research tools
+vidpipe ideate --add --topic "Building CI/CD with GitHub Actions"
+
+# Direct — skip AI, use CLI flags + defaults
+vidpipe ideate --add --topic "Quick Demo" --no-ai --hook "Ship it live" --audience "developers"
+
+# JSON output for programmatic consumers (e.g., VidRecord Electron app)
+vidpipe ideate --add --topic "My Topic" --format json
+```
+
 ### How It Works
 
 The **IdeationAgent** uses MCP tools (Exa web search, YouTube, Perplexity) to research trending topics in your niche before generating ideas. Each idea includes:

package/dist/cli.js

@@ -11557,12 +11557,13 @@ function isStringArray(value) {
 function hasField(source, field) {
   return Object.prototype.hasOwnProperty.call(source, field);
 }
-function normalizeCount(count) {
+function normalizeCount(count, allowSingle) {
+  const min = allowSingle ? 1 : MIN_IDEA_COUNT;
   if (typeof count !== "number" || Number.isNaN(count)) {
-    return MIN_IDEA_COUNT;
+    return min;
   }
   const rounded = Math.round(count);
-  return Math.min(MAX_IDEA_COUNT, Math.max(MIN_IDEA_COUNT, rounded));
+  return Math.min(MAX_IDEA_COUNT, Math.max(min, rounded));
 }
 function normalizeSeedTopics(seedTopics) {
   return (seedTopics ?? []).map((topic) => topic.trim()).filter((topic) => topic.length > 0);
@@ -12207,7 +12208,7 @@ var IdeationAgent = class extends BaseAgent {
 };
 async function generateIdeas(options = {}) {
   const seedTopics = normalizeSeedTopics(options.seedTopics);
-  const count = normalizeCount(options.count);
+  const count = normalizeCount(options.count, options.singleTopic);
   const config2 = getConfig();
   const previousBrandPath = config2.BRAND_PATH;
   if (options.brandPath) {
@@ -13161,8 +13162,14 @@ function generateIdeas3(...args) {
 }
 
 // src/L7-app/commands/ideate.ts
+init_types();
+var VALID_PLATFORMS = new Set(Object.values(Platform));
 async function runIdeate(options = {}) {
   initConfig();
+  if (options.add) {
+    await handleAdd(options);
+    return;
+  }
   if (options.list) {
     const ideas2 = await listIdeas();
     const filtered = options.status ? ideas2.filter((idea) => idea.status === options.status) : ideas2;
@@ -13251,6 +13258,71 @@ ${filtered.length} idea(s) total`);
   console.log("Use `vidpipe ideate --list` to view all ideas.");
   console.log("Use `vidpipe process video.mp4 --ideas <issueNumber1>,<issueNumber2>` to link ideas to a recording.");
 }
+function parseCommaSeparated(value) {
+  if (!value) return [];
+  return value.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function parsePlatforms(value) {
+  if (!value) return ["youtube" /* YouTube */];
+  const names = parseCommaSeparated(value);
+  const platforms = [];
+  for (const name of names) {
+    const lower = name.toLowerCase();
+    if (!VALID_PLATFORMS.has(lower)) {
+      throw new Error(`Invalid platform "${name}". Valid platforms: ${[...VALID_PLATFORMS].join(", ")}`);
+    }
+    platforms.push(lower);
+  }
+  return platforms.length > 0 ? platforms : ["youtube" /* YouTube */];
+}
+function defaultPublishBy() {
+  const date = /* @__PURE__ */ new Date();
+  date.setDate(date.getDate() + 14);
+  return date.toISOString().split("T")[0];
+}
+function buildDirectInput(options) {
+  const topic = options.topic;
+  const hook = options.hook ?? topic;
+  const audience = options.audience ?? "developers";
+  const platforms = parsePlatforms(options.platforms);
+  const keyTakeaway = options.keyTakeaway ?? hook;
+  const talkingPoints = parseCommaSeparated(options.talkingPoints);
+  const tags = parseCommaSeparated(options.tags);
+  const publishBy = options.publishBy ?? defaultPublishBy();
+  const trendContext = options.trendContext;
+  return { topic, hook, audience, keyTakeaway, talkingPoints, platforms, tags, publishBy, trendContext };
+}
+async function handleAdd(options) {
+  if (!options.topic) {
+    throw new Error("--topic is required when using --add");
+  }
+  const useAI = options.ai !== false;
+  if (useAI) {
+    const ideas = await generateIdeas3({
+      seedTopics: [options.topic],
+      count: 1,
+      singleTopic: true,
+      brandPath: options.brand
+    });
+    const idea = ideas[0];
+    if (!idea) {
+      throw new Error("IdeationAgent did not create an idea");
+    }
+    if (options.format === "json") {
+      console.log(JSON.stringify(idea, null, 2));
+    } else {
+      console.log(`Created idea #${idea.issueNumber}: "${idea.topic}"`);
+    }
+  } else {
+    const input = buildDirectInput(options);
+    const idea = await createIdea(input);
+    if (options.format === "json") {
+      console.log(JSON.stringify(idea, null, 2));
+    } else {
+      console.log(`Created idea #${idea.issueNumber}: "${idea.topic}"`);
+    }
+  }
+}
 
 // src/L1-infra/http/http.ts
 import { default as default8 } from "express";
@@ -13885,7 +13957,7 @@ program.command("chat").description("Interactive chat session with the schedule
 program.command("doctor").description("Check all prerequisites and dependencies").action(async () => {
   await runDoctor();
 });
-program.command("ideate").description("Generate AI-powered content ideas using trend research").option("--topics <topics>", "Comma-separated seed topics").option("--count <n>", "Number of ideas to generate (default: 5)", "5").option("--output <dir>", "Ideas directory (default: ./ideas)").option("--brand <path>", "Brand config path (default: ./brand.json)").option("--list", "List existing ideas instead of generating").option("--status <status>", "Filter by status when listing (draft|ready|recorded|published)").option("--format <format>", "Output format: table (default) or json").action(async (opts) => {
+program.command("ideate").description("Generate AI-powered content ideas using trend research").option("--topics <topics>", "Comma-separated seed topics").option("--count <n>", "Number of ideas to generate (default: 5)", "5").option("--output <dir>", "Ideas directory (default: ./ideas)").option("--brand <path>", "Brand config path (default: ./brand.json)").option("--list", "List existing ideas instead of generating").option("--status <status>", "Filter by status when listing (draft|ready|recorded|published)").option("--format <format>", "Output format: table (default) or json").option("--add", "Add a single idea (AI-researched by default, or --no-ai for direct)").option("--topic <topic>", "Idea topic/title (required with --add)").option("--hook <hook>", "Attention-grabbing hook (default: topic, --no-ai only)").option("--audience <audience>", "Target audience (default: developers, --no-ai only)").option("--platforms <platforms>", "Comma-separated platforms: tiktok,youtube,instagram,linkedin,x (--no-ai only)").option("--key-takeaway <takeaway>", "Core message the viewer should remember (--no-ai only)").option("--talking-points <points>", "Comma-separated talking points (--no-ai only)").option("--tags <tags>", "Comma-separated categorization tags (--no-ai only)").option("--publish-by <date>", "Publish deadline (ISO 8601 date, default: 14 days from now, --no-ai only)").option("--trend-context <context>", "Why this topic is timely (--no-ai only)").option("--no-ai", "Skip AI research agent \u2014 create directly from CLI flags + defaults").action(async (opts) => {
   initConfig();
   await runIdeate(opts);
   process.exit(0);