openbriefing 0.5.0 → 1.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 This package is the reference parser and checker for the [Open Briefing Standard (OBS)](https://openbriefingstandard.org). OBS is how a publisher says how their content should be summarized and presented when software consumes it.
 
-**Version 0.3.** It contains the parser and `openbriefing check`, and reads spec version 1 (release candidate). One tag, `obs:summary`, is enough: `obs:modified` is optional, and the parser reports where a modified time came from. `check` reads a page, a feed or a whole sitemap from the web.
+**Version 1.** It contains the parser, `openbriefing check` and the publisher's tag tools, and reads spec version 1. One tag, `obs:summary`, is enough: `obs:modified` is optional, and the parser reports where a modified time came from. `check` reads a page, a feed or a whole sitemap from the web.
 
 ## Check a page, a feed or a site
 
@@ -66,13 +66,13 @@ To have the tags written when a post is published, run the hook where Ghost can
 
 ```bash
 export GHOST_WEBHOOK_SECRET=…                   # any long random text
-export ANTHROPIC_API_KEY=…
+export ANTHROPIC_API_KEY=…                      # your own Anthropic key; one call per post, billed to you
 export OBS_HOOK_URL=https://your-hook.example   # registers the two webhooks on start
 npx openbriefing ghost hook                     # POST /ghost, GET /healthz, on PORT or 8080
 npx openbriefing ghost draft --dry-run          # the same for posts already published
 ```
 
-The hook drafts with Claude (`OBS_MODEL` picks the model), keeps only highlights it finds in the post, and stamps its block `<!-- obs:auto … -->`. Edit the tags in the post's Code injection and they are yours: the hook never writes to that post again. It leaves members-only posts and posts under 200 words alone. These tags are published before you read them; use `pull` and `push` if you would rather approve each one.
+The hook drafts with Claude on your own key (`OBS_MODEL` picks the model) and will not start without one. It keeps only highlights it finds in the post, and stamps its block `<!-- obs:auto … -->`. Edit the tags in the post's Code injection and they are yours: the hook never writes to that post again. It leaves members-only posts and posts under 200 words alone. These tags are published before you read them; use `pull` and `push` if you would rather approve each one.
 
 ## Use the parser
 

package/dist/cli.js

@@ -417,6 +417,11 @@ async function ghost(args) {
     const { Ghost, pull, push } = await import("./ghost.js");
     const client = new Ghost({ url, key });
     if (action === "draft" || action === "hook") {
+        // The publisher brings the key: every draft is one call to Claude, billed to their own account.
+        if (!process.env.ANTHROPIC_API_KEY && !(action === "draft" && args.dryRun)) {
+            console.error("Set ANTHROPIC_API_KEY to your own Anthropic API key (console.anthropic.com). Each post is one call to Claude, billed to that key.");
+            return 2;
+        }
         const { claudeDrafter, draftAll, hookServer, registerWebhooks } = await import("./hook.js");
         const model = process.env.OBS_MODEL;
         const drafter = claudeDrafter(model ? { model } : {});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbriefing",
-  "version": "0.5.0",
+  "version": "1.0.0",
   "description": "Open Briefing Standard (OBS): the reference parser, the checker and the publisher's tag tools for publishers' own summaries.",
   "keywords": [
     "open-briefing-standard",