@ainyc/canonry 2.10.1 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -93,6 +93,7 @@ Canonry's CLI and API are the agent interface. The optional `canonry-mcp` adapte
93
93
  - **Built-in AI agent (Aero).** Reads state, analyzes regressions, fires write tools (`run_sweep`, `dismiss_insight`, `update_schedule`, etc.), wakes up unprompted after runs. Backed by [`pi-agent-core`](https://github.com/badlogic/pi-mono) — 15+ LLM providers, streaming first.
94
94
  - **Agent-first.** Every CLI command supports `--format json`; every UI view has a matching API endpoint. An optional `canonry-mcp` stdio adapter exposes 48 tools to MCP clients like Claude Desktop and Codex.
95
95
  - **Multi-provider.** Query Gemini, OpenAI, Claude, Perplexity, and local LLMs from a single platform.
96
+ - **Content opportunity engine.** Per-query recommendations typed by action (`create` / `expand` / `refresh` / `add-schema`) with auditable score breakdowns, drivers, and demand-source labels. Combines GSC ranking signals with competitor citation evidence so zero-traffic gaps still surface. Available via `canonry content targets / gaps / sources`, the matching API endpoints, and Aero's tool surface.
96
97
  - **Config-as-code.** Kubernetes-style YAML files. Version control your monitoring, let agents apply changes declaratively.
97
98
  - **Self-hosted.** Runs locally with SQLite. No cloud account required.
98
99
  - **Full API parity.** REST API and CLI cover 100% of functionality. `--format json` on every command.
@@ -111,6 +112,7 @@ canonry run my-project --wait --format json # sweep all providers
111
112
  canonry evidence my-project --format json # inspect citation evidence
112
113
  canonry insights my-project --format json # DB-backed insight analysis
113
114
  canonry health my-project --format json # visibility health snapshot
115
+ canonry content targets my-project --format json # ranked content opportunities
114
116
  ```
115
117
 
116
118
  Schedule cron-based sweeps with `canonry schedule` and subscribe an agent webhook via `canonry agent attach` to act on results as they land.
@@ -159,6 +161,7 @@ Canonry is **agent-first** — every dashboard view has a matching API endpoint
159
161
  | **Schedules** | Cron-based recurring sweeps | `GET/PUT /projects/{name}/schedule` |
160
162
  | **History / Snapshots** | Timeline + run diffs + per-keyword citation state | `GET /projects/{name}/timeline`, `/snapshots/diff`, `/history` |
161
163
  | **Intelligence** | DB-backed insights + health snapshots + dismissal | `GET /projects/{name}/insights`, `/health`, `POST /insights/{id}/dismiss` |
164
+ | **Content** | Action-typed content opportunities, gaps, and grounding-source map | `GET /projects/{name}/content/targets`, `/gaps`, `/sources` |
162
165
  | **Notifications** | Webhook subscriptions per project (agent or user-defined) | `GET/POST/DELETE /projects/{name}/notifications`, `POST /.../test` |
163
166
  | **Analytics** | Aggregated dashboard analytics | `GET /projects/{name}/analytics` |
164
167
  | **Google (GSC + OAuth)** | Search Console integration, OAuth flow, property selection, URL inspection | `/google/*`, `/projects/{name}/google/*` |