@letterstory/cli 0.29.0 → 0.29.1

package/README.md

@@ -142,9 +142,10 @@ letterstory phantom domain connect <phantom-id> myblog.com      # attach one you
 ```bash
 letterstory posts list [--limit <n>] [--collection <uuid>]
 letterstory posts show <article-id>
-letterstory posts new --title "…" --collection <uuid> --body "…"     # or --file <path|->
+letterstory posts new --title "…" --collection <uuid> --body "…" [--article-id <uuid>]   # or --file <path|->; --article-id updates that article instead of creating one
 letterstory posts publish <article-id>
 letterstory posts unpublish <article-id>
+letterstory posts delete --id <uuid> [--id <uuid> ...]                # permanent; content, history, and any published copy are all removed
 
 letterstory published list [--limit <n>] [--collection <uuid>] [--format html|md]
 letterstory published show --slug my-post-slug [--format html|md]    # or --id <uuid>

package/lib/cli.mjs

@@ -43,7 +43,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.29.0";
+export const VERSION = "0.29.1";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -205,9 +205,10 @@ Phantomstory (a collection Letterstory hosts as an independent publication):
 Content:
   posts list [--limit <n>] [--collection <uuid>]     List your articles
   posts show <article-id>                            Show one article
-  posts new --title <t> --collection <uuid> (--body <text> | --file <path|->)
+  posts new --title <t> --collection <uuid> (--body <text> | --file <path|->) [--article-id <uuid>]
   posts publish <article-id>                         Publish an article
   posts unpublish <article-id>                       Unpublish an article
+  posts delete --id <uuid> [--id <uuid> ...]         Permanently delete article(s)
   published list [--limit <n>] [--collection <uuid>] [--format html|md]
   published show (--id <uuid> | --slug <slug>) [--format html|md]
 

package/lib/commands/posts.mjs

@@ -20,6 +20,9 @@ export const ARGS = {
 	publish_article: {
 		article_id: { positional: 0, label: "article-id", required: true },
 	},
+	delete_article: {
+		article_ids: { flag: "id", type: "list", required: true, label: "id" },
+	},
 };
 
 export async function cmdPosts(ctx) {
@@ -37,9 +40,12 @@ export async function cmdPosts(ctx) {
 			return postsPublish(rest);
 		case "unpublish":
 			return postsUnpublish(rest);
+		case "delete":
+		case "rm":
+			return postsDelete(rest);
 		default:
 			throw new CliError(
-				`Unknown posts subcommand: ${sub ?? "(none)"}. Try: list, show, new, publish, unpublish`
+				`Unknown posts subcommand: ${sub ?? "(none)"}. Try: list, show, new, publish, unpublish, delete`
 			);
 	}
 }
@@ -66,8 +72,10 @@ async function postsNew(ctx) {
 	const collection = requireFlag(flags, "collection");
 	const body = readBodyInput(flags);
 	if (!body) throw new CliError("Provide --body or --file <path>.");
-	const result = await client.callTool("ingest_article", { title, body, collection_id: collection });
-	ok(ctx, `Created draft "${title}".`);
+	const articleId = flagStr(flags["article-id"]);
+	const args = compact({ title, body, collection_id: collection, article_id: articleId });
+	const result = await client.callTool("ingest_article", args);
+	ok(ctx, articleId ? `Updated "${title}".` : `Created draft "${title}".`);
 	printResult(io, flags, result);
 	return 0;
 }
@@ -89,6 +97,17 @@ async function postsUnpublish(ctx) {
 	return 0;
 }
 
+// Permanent: no confirmation prompt here — the CLI is a scripting surface, and the
+// tool result reports exactly which ids were deleted vs not found.
+async function postsDelete(ctx) {
+	const { client, flags, io, positionals } = ctx;
+	const args = argsFromFlags(ARGS.delete_article, flags, positionals);
+	const result = await client.callTool("delete_article", args);
+	ok(ctx, `Deleted ${result?.deleted_ids?.length ?? 0} article(s).`);
+	printResult(io, flags, result);
+	return 0;
+}
+
 // --- published (frozen public view) -----------------------------------------
 
 export async function cmdPublished(ctx) {

package/package.json

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