add support for two new worai commands

Author: ziodave

docs/worai/commands/list-entities-outside-dataset.md

@@ -0,0 +1,29 @@
+---
+title: list-entities-outside-dataset
+---
+
+List entities that do not belong to the account dataset.
+
+This command fetches the `dataset_uri` via `get_me`, queries GraphQL for all entity IRIs, and prints those that do not start with the dataset URI.
+
+## Usage
+- `worai list-entities-outside-dataset [options]`
+
+## Options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `--dataset-uri` | string |  | Override dataset URI (otherwise fetched via `get_me`). |
+| `--endpoint` | string | `https://api.wordlift.io/graphql` | WordLift GraphQL endpoint. |
+| `--base-url` | string | `https://api.wordlift.io` | WordLift API base URL. |
+| `--limit` | int | `0` | Limit number of entities to list. |
+| `--query-template` | string |  | GraphQL query template with `{dataset_uri}` placeholder (optional). |
+
+## Examples
+- `worai list-entities-outside-dataset`
+- `worai list-entities-outside-dataset --limit 100`
+- `worai list-entities-outside-dataset --dataset-uri https://example.com/dataset`
+
+## Notes
+- Requires `WORDLIFT_KEY` (or `wordlift.api_key` in config).
+- If your GraphQL schema differs, pass a custom `--query-template`. The default query is `entities { iri }`.

docs/worai/commands/validate.md

@@ -0,0 +1,18 @@
+# validate
+
+Validate RDF (Turtle or JSON-LD) against SHACL shapes. Required properties surface as errors; recommended properties surface as warnings.
+
+## Usage
+- `worai validate <file.ttl|file.jsonld|url> [--shape <shape>] [--report-file <path>] [--format pretty|raw] [--color|--no-color]`
+
+## Examples
+- `worai validate ./data.jsonld`
+- `worai validate ./data.jsonld --shape review-snippet`
+- `worai validate ./data.jsonld --shape ./custom-shape.ttl --report-file ./report.txt`
+- `worai validate https://api.wordlift.io/data/example.jsonld --shape review-snippet`
+- `worai validate ./data.jsonld --format raw`
+- `worai validate ./data.jsonld --format pretty --no-color`
+
+## Built-in shapes
+- `review-snippet` (Google review snippet constraints; shapes prefixed `google_`)
+- `schema-review` (Schema.org Review/AggregateRating grammar; shapes prefixed `schema_`)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "docs",
-  "version": "3.9.0",
+  "version": "3.9.1",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",

sidebars.js

@@ -159,6 +159,8 @@ const sidebars = {
                 "worai/commands/find-url-by-type",
                 "worai/commands/link-groups",
                 "worai/commands/patch",
+                "worai/commands/list-entities-outside-dataset",
+                "worai/commands/validate",
                 "worai/commands/upload-entities-from-turtle",
               ],
             },