newsjack 0.1.5 → 0.1.9

package/COMMIT

@@ -1 +1 @@
-1e614b3f5a659c757933e8f4db1f6297df3917c8
+8c0ba44855450e68b4e8cc382b2e3ad3ecedc404

package/README.md

@@ -1,14 +1,14 @@
-# newsjack
+# Newsjack.sh
 
-> **The open-source skills that turn your agent into a PR operator.**
->
-> Install once. Your agent — Claude, Codex, Hermes, OpenClaw — becomes a PR team.
+**The open-source skills that turn your agent into a full PR team.**
+
+Install once. Your agent — Claude Code, Codex, Hermes, OpenClaw — becomes a PR team.
 
 ```bash
 curl -fsSL newsjack.sh | bash
 ```
 
-**New here?** Check out **[Getting started](docs/getting-started.md)**
+**Are you an agent?** Check out **[Getting started](docs/getting-started.md)**
 
 ---
 
@@ -16,17 +16,12 @@ curl -fsSL newsjack.sh | bash
 
 Three problems, separate lanes.
 
-### 🧭 Strategize — figure out what your story even is
-
-- 🗺️ **Get a PR strategy** — opinionated walkthrough if you're not PR-fluent yet: audience first, positioning second, news pegs third, drumbeat over big-bang
-
 ### 🛰️ Detect — surface what matters in your space
 
-- 📡 **Monitor your industry** — set up feeds, get fresh stories worth jumping on
+- 📡 **Monitor your industry** — find newsjacking opportunities: fresh stories you have the standing to jump on before the wave breaks ([see a sample run](docs/example-run.md))
 - 🗞️ **Track your coverage** — Google Alerts-style keyword tracking with LLM filtering for real features
 - 🔭 **Track competitors** — when they launch, raise, or stumble, you know
 - 🔍 **Verify the story is still fresh** — who broke it, who owns it, what oxygen's left
-- 📊 **Score newsworthiness** — cold read on whether it clears the bar before you act
 
 ### 🚀 Act — turn signal into output
 
@@ -38,6 +33,11 @@ Three problems, separate lanes.
 - 🗣️ **Keep drafts in your voice** — fingerprint your real writing, kill the AI tells
 - 📋 **Build a fit-checked media list** — targeted reporters, not scraped contact dumps
 
+### 🧭 Strategize — figure out what your story even is
+
+- 🗺️ **Get a PR strategy** — opinionated walkthrough if you're not PR-fluent yet: audience first, positioning second, news pegs third, drumbeat over big-bang
+- 📊 **Score newsworthiness** — cold read on whether it clears the bar before you act
+
 ---
 
 ## Who this is for
@@ -51,6 +51,25 @@ Three problems, separate lanes.
 
 ## Install
 
+Pick the path for the harness you're using.
+
+### Supported runtimes
+
+| Runtime             | Status       | Experience   | Install path |
+| ------------------- | ------------ | ------------ | ------------ |
+| Claude Code         | Recommended  | Full Mode    | curl, npm, or plugin |
+| Codex               | Recommended  | Full Mode    | curl or npm |
+| OpenClaw            | Recommended  | Full Mode    | curl or npm |
+| Hermes              | Recommended  | Full Mode    | curl or npm |
+| Claude.ai chat      | Limited only | Limited Mode | plugin/upload/manual skills |
+| ChatGPT chat        | Limited only | Limited Mode | manual skills |
+| Claude Cowork       | Limited only | Limited Mode | plugin/upload/manual skills |
+
+### Full Mode: Claude Code, Codex, OpenClaw, Hermes
+
+Use the curl installer when your full agent harness can reach GitHub Release
+assets:
+
 ```bash
 curl -fsSL newsjack.sh | bash
 ```
@@ -61,19 +80,10 @@ Or review the script before running it:
 curl -fsSL https://newsjack.sh
 ```
 
-The installer detects your agent runtime and installs the skills automatically. Supported:
-
-| Runtime                 | Auto-detected                     |
-| ----------------------- | --------------------------------- |
-| Claude Code             | ✅                                 |
-| Codex                   | ✅                                 |
-| OpenClaw                | ✅                                 |
-| Hermes                  | ✅                                 |
-| ChatGPT / Claude.ai web | manual (load `skills/*/SKILL.md`) |
-
-### npm install
+The installer detects your agent runtime and installs the CLI-backed skills
+automatically.
 
-Use npm when shell installers or GitHub Release assets are blocked. This is the required path for Claude Cowork:
+If shell installers or GitHub Release assets are blocked, use npm instead:
 
 ```bash
 npm i -g newsjack
@@ -82,24 +92,39 @@ newsjack install
 
 After install, agents and skills should call the CLI as `newsjack`.
 
-### Claude Code plugin
+### Limited Mode: Claude.ai, ChatGPT, Claude Cowork
 
-If you're on Claude Code, you can install Newsjack as a plugin instead of running the script:
+Do not try to install the Newsjack CLI inside browser chat or restricted Cowork
+surfaces. Use the marketplace/upload/manual skill path instead.
 
-```text
-/plugin marketplace add elvisun/newsjack
-/plugin install newsjack@newsjack
-```
+Limited Mode keeps Newsjack's instruction layer for PR strategy, newsworthiness
+checks, pitch and angle generation, pitch critique, journalist-fit reasoning,
+fact-checking from pasted or searchable evidence, and best-effort manual news
+scans. It does not include saved monitors, scheduled runs, seen-state,
+deterministic freshness gates, full source ingestion, local artifacts, or
+cost-optimized multi-agent passes — set up a Full Mode harness for those.
 
-This registers the repo as a marketplace and installs the `newsjack` plugin — all 16 skills are auto-discovered. The skills run instruction-only out of the box; steps that use the optional `newsjack` CLI ask before installing it.
+For Claude.ai plugin-style setup:
 
-Once Newsjack is approved for the community marketplace, you'll also be able to install it from there:
+1. Open **Customize**.
+2. Go to **Personal plugins**.
+3. Click **Create plugin**.
+4. Choose **Add marketplace**.
+5. Choose **Add from a repository**.
+6. In the repository URL field, enter:
 
 ```text
-/plugin marketplace add anthropics/claude-plugins-community
-/plugin install newsjack@claude-community
+elvisun/newsjack
 ```
 
+Then install the Newsjack plugin from that marketplace:
+
+- Marketplace: `elvisun/newsjack`
+- Plugin: `newsjack@newsjack`
+
+A community marketplace plugin (`newsjack@claude-community`) is pending review
+and will be added soon.
+
 ---
 
 ## What gets installed
@@ -110,16 +135,12 @@ Once Newsjack is approved for the community marketplace, you'll also be able to
 └── newsjack/             # managed bundle
 
 skills installed to your detected runtime(s):
-  coverage-tracker-setup  create a keyword coverage tracker
-  coverage-tracker        find real keyword features and suppress repeat alerts
   newsjack-monitor-setup  create a company monitoring profile
   newsjack-detector       find newsworthy moments before the wave breaks
-  story-origin-check      verify a story is fresh, not already saturated
   newsworthiness-check    score whether your news clears the bar
-  news-search             dated, attributed news search (Medialyst or web fallback)
-  meanest-editor          roast your pitch against the editor rubric
   angle-generator         turn one update into ten pitchable hooks
-  media-list-manager      build small, fit-checked media lists
+  find-journalists      build small, fit-checked media lists
+  …and more
 ```
 
 The npm package bundles the same CLI and skills, with the `newsjack` command installed on `PATH`.

package/VERSION

@@ -1 +1 @@
-v0.1.5
+v0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newsjack",
-  "version": "0.1.5",
+  "version": "0.1.9",
   "description": "Open-source agent skills and CLI for PR operators.",
   "license": "MIT",
   "homepage": "https://newsjack.sh",
@@ -29,9 +29,9 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "newsjack-linux-arm64": "0.1.5",
-    "newsjack-linux-x64": "0.1.5",
-    "newsjack-darwin-arm64": "0.1.5",
-    "newsjack-darwin-x64": "0.1.5"
+    "newsjack-linux-arm64": "0.1.9",
+    "newsjack-linux-x64": "0.1.9",
+    "newsjack-darwin-arm64": "0.1.9",
+    "newsjack-darwin-x64": "0.1.9"
   }
 }