innernote 0.4.0 → 0.5.0

package/README.md

@@ -86,12 +86,16 @@ from it fails the suite, so what you read here is what the binary has.
 | `login [code]` | connect this machine |
 | `logout` | forget the token stored here |
 | `whoami` | show which account is connected, and what this key can do |
-| `context` | what you post about: your pillars and your series |
+| `context` | what you post about: your pillars, your series and your products |
 | `capture <text>` | save an idea to your inbox |
 | `write [topic]` | draft a post in your voice |
 | `shape <shape...>` | push a post shorter, punchier, warmer |
 | `ask [--post <id>] <anything>` | talk to the post in your own words; with `--post`, a saved post in one command. `--passage`, `--hook`, `--ending`, `--preset` and `--shape` edit one part of it, as the editor's selection, toolbar and format picker do |
 | `edit <id>` | put new text, a title, a first comment, a series or a ready state on a saved post |
+| `repurpose <link or text>` | write your own post from a link, a capture (`--capture <id>`) or pasted text |
+| `captures` | your Capture page: list, read one, `add` a link or a thought, `delete` |
+| `radar` | recent posts from the creators you watch |
+| `history <id>` | every earlier version of a post; `--restore <n>` puts one back |
 | `attach <id> <file...>` | put an image, images, a PDF or a video on a saved post |
 | `save` | keep the draft you are holding |
 | `show [id]` | a post with everything the app knows about it, or the one you are holding |

package/dist/index.js

@@ -714,13 +714,15 @@ async function week(args) {
 }
 async function context(args) {
   const { json } = parseFlags(args);
-  const [pillars, series, notebook] = await Promise.all([
+  const [pillars, series, notebook, products] = await Promise.all([
     request("/api/pillars"),
     request("/api/campaigns"),
-    request("/api/notebook/brief").catch(() => ({ brief: null }))
+    request("/api/notebook/brief").catch(() => ({ brief: null })),
+    request("/api/products").catch(() => ({ products: [] }))
   ]);
+  const productRows = products.products.map((p) => ({ name: p.name, oneLiner: p.oneLiner, postCount: p.postCount }));
   if (json) {
-    out(JSON.stringify({ pillars: pillars.pillars, series: series.campaigns, brief: notebook.brief }, null, 2));
+    out(JSON.stringify({ pillars: pillars.pillars, series: series.campaigns, products: productRows, brief: notebook.brief }, null, 2));
     return 0;
   }
   out();
@@ -755,6 +757,15 @@ async function context(args) {
   } else {
     out(`  ${dim2("No series running.")}`);
   }
+  if (productRows.length) {
+    out();
+    out(`  ${bold2("Products")}${dim2("   work one into a post with")} ${caramel('ask --post <id> --product "<name>"')}`);
+    for (const p of productRows) {
+      out(`    ${caramel(p.name)}${p.postCount ? dim2(`   ${p.postCount} ${p.postCount === 1 ? "post" : "posts"}`) : ""}`);
+      if (p.oneLiner)
+        out(`      ${dim2(oneLine(p.oneLiner, 64))}`);
+    }
+  }
   out();
   return 0;
 }
@@ -1182,7 +1193,7 @@ async function open(args) {
   return 0;
 }
 async function ask(args) {
-  const { json, rest, value, has } = parseFlags(args, ["post", "passage", "preset", "shape"]);
+  const { json, rest, value, has } = parseFlags(args, ["post", "passage", "preset", "shape", "product"]);
   const message = rest.join(" ").trim();
   const held = getDraft();
   const postRef = value("post");
@@ -1191,7 +1202,9 @@ async function ask(args) {
       passage: value("passage"),
       preset: value("preset"),
       shape: value("shape"),
-      region: has("hook") ? "hook" : has("ending") ? "ending" : undefined
+      region: has("hook") ? "hook" : has("ending") ? "ending" : undefined,
+      product: value("product"),
+      productMode: has("rewrite") ? "rewrite" : "weave"
     };
     return askAboutPost(postRef, message, target, json);
   }
@@ -1342,6 +1355,9 @@ function askBody(content, message, t) {
   if (preset && ![...PRESETS.selection, ...PRESETS.whole, ...PRESETS.region].includes(preset)) {
     return `There is no preset called "${preset}". Presets: ${[...PRESETS.selection, ...PRESETS.whole, ...PRESETS.region].join(", ")}`;
   }
+  if (t.productId) {
+    return { text: content, productId: t.productId, productMode: t.productMode ?? "weave" };
+  }
   if (t.shape) {
     if (!SHAPE_NAMES.includes(t.shape))
       return `There is no shape called "${t.shape}". Shapes: ${SHAPE_NAMES.join(", ")}`;
@@ -1389,6 +1405,16 @@ async function askAboutPost(refArg, message, target, json) {
     fail("That post is already live on LinkedIn, so it cannot be changed here.");
     return 1;
   }
+  if (target.product) {
+    const { products } = await request("/api/products");
+    const want = target.product.trim().toLowerCase();
+    const hit = products.find((p) => p.name.trim().toLowerCase() === want) ?? products.find((p) => p.name.toLowerCase().includes(want));
+    if (!hit) {
+      fail(products.length ? `There is no product called "${target.product}". Products: ${products.map((p) => p.name).join(", ")}` : "There are no products yet. Add one in Settings, under Products.");
+      return 1;
+    }
+    target = { ...target, productId: hit._id };
+  }
   const body = askBody(post.content, message, target);
   if (typeof body === "string") {
     fail(body);
@@ -1754,14 +1780,16 @@ var COMMANDS = {
   },
   ask: {
     summary: "talk to the post in your own words, or edit one passage of it",
-    usage: "innernote ask [--post <id>] [--passage <text> | --hook | --ending] [--preset <name> | --shape <name>] [what you want]",
+    usage: "innernote ask [--post <id>] [--passage <text> | --hook | --ending] [--preset <name> | --shape <name> | --product <name>] [what you want]",
     detail: "The Writer, here. The app's composer is a conversation with the post in front of you, and this is the same assistant: it can change the post, answer a question about it, or say it would rather not. In a session it works on the post in hand. With --post it works on a saved post in one command, and the change is kept in the post's history. --passage is the editor's selection: the exact words to change, and only those change. --hook and --ending are the opening and closing block. --preset is a toolbar edit by name, --shape the format picker.",
     options: [
       ["--post <id>", "a saved post, by id, instead of the one in hand"],
       ["--passage <text>", "change only these exact words of the post"],
       ["--hook, --ending", "change only the opening, or the closing"],
       ["--preset <name>", "on a passage: sharpen shorter punchier simpler example deslop concrete warmer list. On the post: tighten_all as_list as_story fix_spacing rewrite_hook rewrite_ending ending_question"],
-      ["--shape <name>", "story opinion listicle contrarian experience howto lessons casestudy framework question announcement prediction beliefbreak"]
+      ["--shape <name>", "story opinion listicle contrarian experience howto lessons casestudy framework question announcement prediction beliefbreak"],
+      ["--product <name>", "work one of your products into the post, where it honestly belongs (`context` lists them)"],
+      ["--rewrite", "with --product: rewrite the post around it instead"]
     ],
     examples: [
       "ask cut the second half and land it harder",
@@ -1770,7 +1798,8 @@ var COMMANDS = {
       'innernote ask --post p17abc... --passage "we got lucky" "say what the luck actually was"',
       'innernote ask --post p17abc... --passage "we got lucky" --preset concrete',
       "innernote ask --post p17abc... --preset ending_question",
-      "innernote ask --post p17abc... --shape story"
+      "innernote ask --post p17abc... --shape story",
+      'innernote ask --post p17abc... --product "innernote"'
     ]
   },
   edit: {
@@ -1792,6 +1821,60 @@ var COMMANDS = {
       'innernote edit p17abc... --series "Build in Public" --status ready'
     ]
   },
+  captures: {
+    summary: "your Capture page: what you keep to write from later",
+    usage: "innernote captures [<id>] | captures add <link or text> [--note <why>] | captures delete <id>",
+    detail: "The same list as Capture in the app. With no argument it lists what you kept, newest first, with ids. With an id it prints that capture in full. `add` keeps a link (a LinkedIn post, an article, a page) or a thought in your own words: a link is read once, through innernote's cache, and kept with its text. `repurpose --capture <id>` writes a post from one.",
+    options: [
+      ["--note <why>", "with add: why you kept it, in a line"],
+      ["--limit <n>", "how many to list (default 30)"]
+    ],
+    examples: [
+      "innernote captures",
+      'innernote captures add https://www.linkedin.com/posts/... --note "the pricing argument"',
+      "innernote captures j57abc..."
+    ]
+  },
+  repurpose: {
+    summary: "write your own post from a link, a capture or some text",
+    usage: "innernote repurpose <link or text> | repurpose --capture <id>  [--borrow <what>] [--instruction <text>] [--shape <name>] [--save]",
+    detail: "Turn into a post, from here. The source is read, and the post is written in your voice from what you choose to borrow, then checked so it reads as yours and not theirs. --borrow idea takes their point and uses your proof, structure takes only how it is built, spark only reacts to it, and faithful relays what it reports in your words, with credit. A profile link yields its recent posts: the first is used, --pick chooses another.",
+    options: [
+      ["--capture <id>", "a capture from `captures`, instead of a link"],
+      ["--borrow <what>", "idea, structure, spark or faithful"],
+      ["--instruction <text>", "anything else it should do, in your words"],
+      ["--shape <name>", "story, listicle, howto, lessons and the rest, as in `ask --shape`"],
+      ["--pick <n>", "which of a profile's posts to write from"],
+      ["--save", "keep it as a draft"],
+      ["--series <name>", "with --save: file it into a series"],
+      ["--title <text>", "with --save: its title (default: one is written for you)"]
+    ],
+    examples: [
+      "innernote repurpose https://www.linkedin.com/posts/... --borrow structure",
+      "innernote repurpose --capture j57abc... --borrow idea --save",
+      "pbpaste | innernote repurpose --borrow spark"
+    ]
+  },
+  radar: {
+    summary: "recent posts from the creators you watch",
+    usage: "innernote radar [--limit <n>] [--full]",
+    detail: "The same feed as Radar in the app, newest first, with each post's link. Who you watch is set on the Radar page. `repurpose <link>` writes your own post from one.",
+    options: [
+      ["--limit <n>", "how many posts (default 15)"],
+      ["--full", "print each post in full, not one line"]
+    ],
+    examples: ["innernote radar", "innernote radar --full --limit 5", "innernote radar --json"]
+  },
+  history: {
+    summary: "every earlier version of a post, and putting one back",
+    usage: "innernote history <id> [--show <n>] [--restore <n>]",
+    detail: "Every change to a post's words is kept as a version first: yours, the assistant's, an edit from here. This lists them, newest first. --restore puts one back, and the text it replaces is kept as the newest version, so a restore is itself one step from undone.",
+    options: [
+      ["--show <n>", "print version n in full"],
+      ["--restore <n>", "put version n back"]
+    ],
+    examples: ["innernote history p17abc...", "innernote history p17abc... --show 3", "innernote history p17abc... --restore 3"]
+  },
   attach: {
     summary: "put an image, images, a PDF or a video on a saved post",
     usage: "innernote attach <id> <file...> [--title <text>] | innernote attach <id> --remove",
@@ -1871,9 +1954,9 @@ var COMMANDS = {
     examples: ["innernote skill", "innernote skill --install"]
   },
   context: {
-    summary: "what you post about: your topics and your series",
+    summary: "what you post about: your topics, your series and your products",
     usage: "innernote context",
-    detail: "Your standing context: your topics with their weights, and every running series with what it is about and what it is for. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
+    detail: "Your standing context: your topics with their weights, every running series with what it is about and what it is for, and your products. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
     examples: ["innernote context", "innernote context --json"]
   },
   queue: {
@@ -1994,7 +2077,7 @@ function suggest(state) {
 // package.json
 var package_default = {
   name: "innernote",
-  version: "0.4.0",
+  version: "0.5.0",
   description: "Write LinkedIn posts in your voice, from the terminal.",
   keywords: [
     "linkedin",
@@ -2285,17 +2368,323 @@ async function restorePost(args) {
   ok(`Restored. It is back in your posts.  ${dim2(ref.id)}`);
   return 0;
 }
+async function history(args) {
+  const { json, rest, value } = parseFlags(args, ["show", "restore"]);
+  const ref = rest[0] ? resolveRef(rest[0]) : null;
+  if (!ref) {
+    fail("Whose history?");
+    note(dim2(`${CMD} history <post-id>`));
+    return 1;
+  }
+  const post = await fetchPost(ref.id);
+  if (!post) {
+    fail("That post could not be found.");
+    note(dim2(`\`${CMD} drafts\` lists them with their ids`));
+    return 1;
+  }
+  const { versions } = await request(`/api/posts/${encodeURIComponent(post._id)}/versions`);
+  const pick = (n) => versions.find((v) => String(v.versionNumber) === n || v.id === n);
+  const restore = value("restore");
+  if (restore) {
+    const v = pick(restore);
+    if (!v) {
+      fail(`There is no version ${restore}. \`${CMD} history ${post._id}\` lists them.`);
+      return 1;
+    }
+    if (post.status === "published") {
+      fail("That post is live on LinkedIn, so its text cannot go back to an older version here.");
+      return 1;
+    }
+    const res = await request(`/api/posts/${encodeURIComponent(post._id)}/versions`, {
+      method: "POST",
+      body: { versionId: v.id }
+    });
+    if (json) {
+      out(JSON.stringify({ id: post._id, restored: v.versionNumber, content: res.content }, null, 2));
+      return 0;
+    }
+    out(res.content);
+    note();
+    ok(`Back to version ${v.versionNumber}. What it replaced is kept as the newest version.  ${dim2(post._id)}`);
+    return 0;
+  }
+  const show2 = value("show");
+  if (show2) {
+    const v = pick(show2);
+    if (!v) {
+      fail(`There is no version ${show2}.`);
+      return 1;
+    }
+    if (json) {
+      out(JSON.stringify(v, null, 2));
+      return 0;
+    }
+    out(v.content);
+    return 0;
+  }
+  if (json) {
+    out(JSON.stringify(versions, null, 2));
+    return 0;
+  }
+  if (!versions.length) {
+    out(dim2("No earlier versions. Every change from now on is kept."));
+    return 0;
+  }
+  out();
+  for (const v of versions) {
+    const why = v.instruction ? oneLine(v.instruction, 50) : v.source;
+    out(`  ${`v${v.versionNumber}`.padEnd(5)}${dim2(`${ago(v.createdAt).padEnd(5)} ${why}`)}`);
+    out(`       ${oneLine(v.content, 66)}`);
+  }
+  out();
+  note(dim2(`\`${CMD} history ${post._id} --show <n>\` reads one, \`--restore <n>\` puts it back`));
+  return 0;
+}
+
+// src/commands/write.ts
+async function saveNew2(content, series, seriesSummary, title) {
+  return request("/api/posts", {
+    method: "POST",
+    body: {
+      content,
+      source: "cli",
+      ...title ? { title } : {},
+      ...series ? { series, seriesSummary: seriesSummary ?? undefined } : {}
+    }
+  });
+}
+
+// src/commands/sources.ts
+function looksLikeUrl(input) {
+  const t = input.trim();
+  return !/\s/.test(t) && (/^https?:\/\//i.test(t) || /^[\w-]+\.[\w.-]+\/\S/.test(t));
+}
+function capturedAt(c) {
+  return c.createdAt ?? c._creationTime;
+}
+async function captures(args) {
+  const { json, rest, value } = parseFlags(args, ["note", "limit"]);
+  const [sub, ...more] = rest;
+  if (sub === "add") {
+    const piped = more.length ? null : await readStdin();
+    const input = (more.join(" ") || piped || "").trim();
+    if (!input) {
+      fail("Add what? A link, or a thought in your own words.");
+      note(dim2(`${CMD} captures add https://www.linkedin.com/posts/...`));
+      return 1;
+    }
+    const noteText = value("note");
+    const body = looksLikeUrl(input) ? { kind: "link", input, ...noteText ? { note: noteText } : {} } : { kind: "thought", content: input, ...noteText ? { note: noteText } : {} };
+    const call = () => request("/api/captures", { method: "POST", body, timeoutMs: 120000 });
+    const { capture: capture2 } = json ? await call() : await whileThinking([{ at: 0, text: "reading it..." }, { at: 8, text: "still reading..." }], call);
+    if (json) {
+      out(JSON.stringify(capture2, null, 2));
+      return 0;
+    }
+    ok(`Kept on your Capture page.  ${dim2(capture2._id)}`);
+    note(dim2(capture2.title ? oneLine(capture2.title, 72) : oneLine(capture2.content, 72)));
+    note(dim2(`\`${CMD} repurpose --capture ${capture2._id}\` writes a post from it`));
+    return 0;
+  }
+  if (sub === "delete") {
+    const id = more[0];
+    if (!id) {
+      fail("Delete which capture?");
+      note(dim2(`${CMD} captures delete <capture-id>`));
+      return 1;
+    }
+    await request(`/api/captures/${encodeURIComponent(id)}`, { method: "DELETE" });
+    if (json) {
+      out(JSON.stringify({ id, deleted: true }, null, 2));
+      return 0;
+    }
+    ok(`Deleted.  ${dim2(id)}`);
+    return 0;
+  }
+  if (sub) {
+    const { capture: capture2 } = await request(`/api/captures/${encodeURIComponent(sub)}`);
+    if (json) {
+      out(JSON.stringify(capture2, null, 2));
+      return 0;
+    }
+    out(capture2.content);
+    note();
+    const facts = [
+      ["title", capture2.title],
+      ["kind", [capture2.kind, capture2.format].filter(Boolean).join(", ")],
+      ["by", [capture2.author, capture2.publication].filter(Boolean).join(", ") || undefined],
+      ["link", capture2.sourceUrl],
+      ["your note", capture2.note],
+      ["topics", capture2.topics?.length ? capture2.topics.join(", ") : undefined],
+      ["saved", capturedAt(capture2) ? `${ago(capturedAt(capture2))} ago` : undefined],
+      ["id", capture2._id]
+    ];
+    for (const [k, v] of facts)
+      if (v)
+        note(`${dim2(k.padEnd(10))}  ${v}`);
+    return 0;
+  }
+  const { captures: rows } = await request("/api/captures");
+  const limit = Number(value("limit") ?? 30) || 30;
+  if (json) {
+    out(JSON.stringify(rows.slice(0, limit), null, 2));
+    return 0;
+  }
+  if (!rows.length) {
+    out(dim2("Nothing kept yet."));
+    note(dim2(`${CMD} captures add <link>`));
+    return 0;
+  }
+  out();
+  for (const c of rows.slice(0, limit)) {
+    const when = capturedAt(c) ? ago(capturedAt(c)) : "";
+    const what = c.title || c.content;
+    out(`  ${caramel(oneLine(what, 66))}`);
+    out(`  ${dim2([c.format ?? c.kind, c.author, when, c._id].filter(Boolean).join("   "))}`);
+    out();
+  }
+  if (rows.length > limit)
+    note(dim2(`${rows.length - limit} more. --limit ${rows.length} to see them all`));
+  note(dim2(`\`${CMD} captures <id>\` reads one in full`));
+  return 0;
+}
+var BORROW = ["idea", "structure", "spark", "faithful"];
+async function repurpose(args) {
+  const { json, rest, value, has } = parseFlags(args, ["capture", "borrow", "instruction", "shape", "pick", "series", "title"]);
+  const borrow = value("borrow");
+  if (borrow && !BORROW.includes(borrow)) {
+    fail(`There is no --borrow "${borrow}". One of: ${BORROW.join(", ")}`);
+    return 1;
+  }
+  let sourceText = "";
+  let captureId;
+  let from = "";
+  const capture2 = value("capture");
+  if (capture2) {
+    const { capture: c } = await request(`/api/captures/${encodeURIComponent(capture2)}`);
+    sourceText = c.content;
+    captureId = c._id;
+    from = c.title ?? oneLine(c.content, 60);
+  } else {
+    const piped = rest.length ? null : await readStdin();
+    const input = (rest.join(" ") || piped || "").trim();
+    if (!input) {
+      fail("Repurpose what? A link, some text, or --capture <id>.");
+      note(dim2(`${CMD} repurpose https://www.linkedin.com/posts/...`));
+      note(dim2(`${CMD} repurpose --capture <capture-id> --borrow structure`));
+      return 1;
+    }
+    const read = () => request("/api/reframe/extract", { method: "POST", body: { input }, timeoutMs: 120000 });
+    const src = json ? await read() : await whileThinking([{ at: 0, text: "reading it..." }, { at: 8, text: "still reading..." }], read);
+    if (src.rejected) {
+      fail(src.message ?? "That could not be read. Paste the text instead.");
+      return 1;
+    }
+    sourceText = src.text ?? "";
+    if (src.candidates && src.candidates.length > 1) {
+      const pick = Number(value("pick") ?? 1);
+      const chosen = src.candidates[pick - 1];
+      if (!chosen) {
+        fail(`There are ${src.candidates.length} posts there. --pick 1 to ${src.candidates.length}.`);
+        return 1;
+      }
+      sourceText = chosen.text;
+      if (!json) {
+        note(dim2(`${src.candidates.length} posts found there, writing from number ${pick}:`));
+        src.candidates.forEach((c, i) => note(dim2(`  ${i + 1}. ${oneLine(c.title ?? c.text, 70)}`)));
+      }
+    }
+    from = src.title ?? src.author ?? oneLine(sourceText, 60);
+  }
+  const shape2 = value("shape");
+  const call = () => request("/api/reframe/rewrite", {
+    method: "POST",
+    body: {
+      sourceText,
+      origin: "found",
+      ...captureId ? { captureId } : {},
+      ...borrow ? { borrowMode: borrow } : {},
+      ...value("instruction") ? { instruction: value("instruction") } : {},
+      ...shape2 ? { postFormat: shape2 } : {}
+    },
+    timeoutMs: 200000
+  });
+  const result = json ? await call() : await whileThinking([
+    { at: 0, text: "reading what it argues..." },
+    { at: 6, text: "writing it in your voice..." },
+    { at: 30, text: "checking it is yours, not theirs..." }
+  ], call);
+  const post = result.variations[0];
+  if (!post?.content) {
+    fail("Nothing came back. Try again, or try another --borrow.");
+    return 1;
+  }
+  const series = value("series");
+  const title = value("title");
+  setDraft({ content: post.content, series });
+  const saved = has("save") ? await saveNew2(post.content, series, undefined, title) : null;
+  if (saved)
+    updateDraft({ id: saved.id });
+  if (saved && !title) {
+    await request(`/api/posts/${encodeURIComponent(saved.id)}/title`, { method: "POST", timeoutMs: 30000 }).catch(() => {});
+  }
+  if (json) {
+    out(JSON.stringify({ ...post, ...saved ? { id: saved.id } : {} }, null, 2));
+    return 0;
+  }
+  out();
+  await reveal(post.content, (chunk) => process.stdout.write(chunk));
+  out();
+  note(dim2(`${bar(post.qualityScore)} ${post.qualityScore}   from: ${oneLine(from, 60)}`));
+  if (saved)
+    ok(series ? `Saved into "${series}". ${dim2(saved.id)}` : `Saved as a draft. ${dim2(saved.id)}`);
+  else
+    note(dim2("Not saved yet. `save` to keep it, or run again with --save."));
+  return 0;
+}
+async function radar(args) {
+  const { json, value, has } = parseFlags(args, ["limit"]);
+  const feed = await request("/api/trend/feed");
+  const limit = Number(value("limit") ?? 15) || 15;
+  const cards = feed.cards.filter((c) => !c.pending);
+  if (json) {
+    out(JSON.stringify({ creators: feed.creators, cards: cards.slice(0, limit) }, null, 2));
+    return 0;
+  }
+  if (!feed.creators.length) {
+    out(dim2("You are not watching anyone yet. Add creators on the Radar page, under Who you watch."));
+    return 0;
+  }
+  out();
+  for (const c of cards.slice(0, limit)) {
+    const m = c.metrics;
+    const stats = m ? [m.likes ? `${m.likes} likes` : "", m.comments ? `${m.comments} comments` : ""].filter(Boolean).join(", ") : "";
+    out(`  ${bold2(c.authorName)}${dim2(`   ${[c.postedAt ? ago(c.postedAt) : "", stats].filter(Boolean).join("   ")}`)}`);
+    if (c.locked)
+      out(`  ${dim2("held back on the trial")}`);
+    else if (has("full") && c.text)
+      out(c.text.split(`
+`).map((l) => `  ${l}`).join(`
+`));
+    else if (c.text)
+      out(`  ${oneLine(c.text, 72)}`);
+    out(`  ${dim2(c.postUrl)}`);
+    out();
+  }
+  note(dim2(`\`${CMD} repurpose <link>\` writes your own post from one`));
+  return 0;
+}
 
 // src/session.ts
 import { createInterface } from "node:readline";
 
 // src/ghost.ts
-function ghostFor(line2, cursor, history, names) {
+function ghostFor(line2, cursor, history2, names) {
   if (!line2 || cursor !== line2.length)
     return null;
   if (line2.startsWith(" "))
     return null;
-  const fromHistory = history.find((h) => h.startsWith(line2) && h.length > line2.length);
+  const fromHistory = history2.find((h) => h.startsWith(line2) && h.length > line2.length);
   if (fromHistory)
     return fromHistory.slice(line2.length);
   if (!line2.includes(" ")) {
@@ -2378,14 +2767,16 @@ var COMMANDS2 = {
   },
   ask: {
     summary: "talk to the post in your own words, or edit one passage of it",
-    usage: "innernote ask [--post <id>] [--passage <text> | --hook | --ending] [--preset <name> | --shape <name>] [what you want]",
+    usage: "innernote ask [--post <id>] [--passage <text> | --hook | --ending] [--preset <name> | --shape <name> | --product <name>] [what you want]",
     detail: "The Writer, here. The app's composer is a conversation with the post in front of you, and this is the same assistant: it can change the post, answer a question about it, or say it would rather not. In a session it works on the post in hand. With --post it works on a saved post in one command, and the change is kept in the post's history. --passage is the editor's selection: the exact words to change, and only those change. --hook and --ending are the opening and closing block. --preset is a toolbar edit by name, --shape the format picker.",
     options: [
       ["--post <id>", "a saved post, by id, instead of the one in hand"],
       ["--passage <text>", "change only these exact words of the post"],
       ["--hook, --ending", "change only the opening, or the closing"],
       ["--preset <name>", "on a passage: sharpen shorter punchier simpler example deslop concrete warmer list. On the post: tighten_all as_list as_story fix_spacing rewrite_hook rewrite_ending ending_question"],
-      ["--shape <name>", "story opinion listicle contrarian experience howto lessons casestudy framework question announcement prediction beliefbreak"]
+      ["--shape <name>", "story opinion listicle contrarian experience howto lessons casestudy framework question announcement prediction beliefbreak"],
+      ["--product <name>", "work one of your products into the post, where it honestly belongs (`context` lists them)"],
+      ["--rewrite", "with --product: rewrite the post around it instead"]
     ],
     examples: [
       "ask cut the second half and land it harder",
@@ -2394,7 +2785,8 @@ var COMMANDS2 = {
       'innernote ask --post p17abc... --passage "we got lucky" "say what the luck actually was"',
       'innernote ask --post p17abc... --passage "we got lucky" --preset concrete',
       "innernote ask --post p17abc... --preset ending_question",
-      "innernote ask --post p17abc... --shape story"
+      "innernote ask --post p17abc... --shape story",
+      'innernote ask --post p17abc... --product "innernote"'
     ]
   },
   edit: {
@@ -2416,6 +2808,60 @@ var COMMANDS2 = {
       'innernote edit p17abc... --series "Build in Public" --status ready'
     ]
   },
+  captures: {
+    summary: "your Capture page: what you keep to write from later",
+    usage: "innernote captures [<id>] | captures add <link or text> [--note <why>] | captures delete <id>",
+    detail: "The same list as Capture in the app. With no argument it lists what you kept, newest first, with ids. With an id it prints that capture in full. `add` keeps a link (a LinkedIn post, an article, a page) or a thought in your own words: a link is read once, through innernote's cache, and kept with its text. `repurpose --capture <id>` writes a post from one.",
+    options: [
+      ["--note <why>", "with add: why you kept it, in a line"],
+      ["--limit <n>", "how many to list (default 30)"]
+    ],
+    examples: [
+      "innernote captures",
+      'innernote captures add https://www.linkedin.com/posts/... --note "the pricing argument"',
+      "innernote captures j57abc..."
+    ]
+  },
+  repurpose: {
+    summary: "write your own post from a link, a capture or some text",
+    usage: "innernote repurpose <link or text> | repurpose --capture <id>  [--borrow <what>] [--instruction <text>] [--shape <name>] [--save]",
+    detail: "Turn into a post, from here. The source is read, and the post is written in your voice from what you choose to borrow, then checked so it reads as yours and not theirs. --borrow idea takes their point and uses your proof, structure takes only how it is built, spark only reacts to it, and faithful relays what it reports in your words, with credit. A profile link yields its recent posts: the first is used, --pick chooses another.",
+    options: [
+      ["--capture <id>", "a capture from `captures`, instead of a link"],
+      ["--borrow <what>", "idea, structure, spark or faithful"],
+      ["--instruction <text>", "anything else it should do, in your words"],
+      ["--shape <name>", "story, listicle, howto, lessons and the rest, as in `ask --shape`"],
+      ["--pick <n>", "which of a profile's posts to write from"],
+      ["--save", "keep it as a draft"],
+      ["--series <name>", "with --save: file it into a series"],
+      ["--title <text>", "with --save: its title (default: one is written for you)"]
+    ],
+    examples: [
+      "innernote repurpose https://www.linkedin.com/posts/... --borrow structure",
+      "innernote repurpose --capture j57abc... --borrow idea --save",
+      "pbpaste | innernote repurpose --borrow spark"
+    ]
+  },
+  radar: {
+    summary: "recent posts from the creators you watch",
+    usage: "innernote radar [--limit <n>] [--full]",
+    detail: "The same feed as Radar in the app, newest first, with each post's link. Who you watch is set on the Radar page. `repurpose <link>` writes your own post from one.",
+    options: [
+      ["--limit <n>", "how many posts (default 15)"],
+      ["--full", "print each post in full, not one line"]
+    ],
+    examples: ["innernote radar", "innernote radar --full --limit 5", "innernote radar --json"]
+  },
+  history: {
+    summary: "every earlier version of a post, and putting one back",
+    usage: "innernote history <id> [--show <n>] [--restore <n>]",
+    detail: "Every change to a post's words is kept as a version first: yours, the assistant's, an edit from here. This lists them, newest first. --restore puts one back, and the text it replaces is kept as the newest version, so a restore is itself one step from undone.",
+    options: [
+      ["--show <n>", "print version n in full"],
+      ["--restore <n>", "put version n back"]
+    ],
+    examples: ["innernote history p17abc...", "innernote history p17abc... --show 3", "innernote history p17abc... --restore 3"]
+  },
   attach: {
     summary: "put an image, images, a PDF or a video on a saved post",
     usage: "innernote attach <id> <file...> [--title <text>] | innernote attach <id> --remove",
@@ -2495,9 +2941,9 @@ var COMMANDS2 = {
     examples: ["innernote skill", "innernote skill --install"]
   },
   context: {
-    summary: "what you post about: your topics and your series",
+    summary: "what you post about: your topics, your series and your products",
     usage: "innernote context",
-    detail: "Your standing context: your topics with their weights, and every running series with what it is about and what it is for. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
+    detail: "Your standing context: your topics with their weights, every running series with what it is about and what it is for, and your products. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
     examples: ["innernote context", "innernote context --json"]
   },
   queue: {
@@ -2790,8 +3236,9 @@ var VERSION2 = package_default.version;
 function commandList() {
   const groups = [
     ["Getting connected", ["login", "logout", "whoami", "skill"]],
-    ["Writing", ["write", "shape", "ask", "edit", "attach", "save", "capture"]],
-    ["Looking", ["show", "ideas", "drafts", "open", "week", "context"]],
+    ["Writing", ["write", "repurpose", "shape", "ask", "edit", "attach", "save", "capture"]],
+    ["Sources", ["captures", "radar"]],
+    ["Looking", ["show", "history", "ideas", "drafts", "open", "week", "context"]],
     ["Shipping", ["queue", "unqueue"]],
     ["Tidying", ["delete", "restore"]]
   ];
@@ -2831,6 +3278,10 @@ var COMMANDS3 = {
   attach,
   delete: deletePost,
   restore: restorePost,
+  history,
+  captures,
+  repurpose,
+  radar,
   save,
   show,
   drop,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "innernote",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Write LinkedIn posts in your voice, from the terminal.",
   "keywords": [
     "linkedin",