@docyrus/docyrus 0.0.16 → 0.0.17

package/resources/pi-agent/skills/docyrus-cli-app/references/list-query-examples.md

@@ -0,0 +1,248 @@
+# List Query Examples
+
+Practical examples for `docyrus ds list` with columns, filters, sorting, and pagination.
+
+---
+
+## Table of Contents
+
+1. [Basic Listing](#basic-listing)
+2. [Column Selection](#column-selection)
+3. [Filtering](#filtering)
+4. [Sorting](#sorting)
+5. [Pagination](#pagination)
+6. [Combined Examples](#combined-examples)
+
+---
+
+## Basic Listing
+
+List all records with default columns:
+
+```bash
+docyrus ds list crm contacts
+```
+
+List with JSON output:
+
+```bash
+docyrus ds list crm contacts --format json
+```
+
+---
+
+## Column Selection
+
+Select specific fields:
+
+```bash
+docyrus ds list crm contacts --columns "name, email, phone"
+```
+
+Select with relation expansion (get related account's name):
+
+```bash
+docyrus ds list crm contacts --columns "name, email, related_account(account_name)"
+```
+
+Spread related fields into root object:
+
+```bash
+docyrus ds list crm contacts --columns "name, ...related_account(account_name, account_phone)"
+```
+
+Alias columns:
+
+```bash
+docyrus ds list crm contacts --columns "n:name, e:email, p:phone"
+```
+
+---
+
+## Filtering
+
+### Single field equals
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"status","operator":"=","value":"active"}]}'
+```
+
+### Multiple conditions (AND)
+
+```bash
+docyrus ds list crm contacts --filters '{"combinator":"and","rules":[{"field":"status","operator":"=","value":"active"},{"field":"priority","operator":">=","value":3}]}'
+```
+
+### OR conditions
+
+```bash
+docyrus ds list crm contacts --filters '{"combinator":"or","rules":[{"field":"city","operator":"=","value":"Istanbul"},{"field":"city","operator":"=","value":"Ankara"}]}'
+```
+
+### IN operator (match any value in list)
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"status","operator":"in","value":[1,2,3]}]}'
+```
+
+### Not equal
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"status","operator":"!=","value":"archived"}]}'
+```
+
+### Text search with LIKE
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"name","operator":"like","value":"John"}]}'
+```
+
+### Empty / not empty
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"email","operator":"not empty"}]}'
+```
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"phone","operator":"empty"}]}'
+```
+
+### Date shortcuts
+
+Records created this month:
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"created_on","operator":"this_month"}]}'
+```
+
+Records created today:
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"created_on","operator":"today"}]}'
+```
+
+Records from last 30 days:
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"created_on","operator":"last_30_days"}]}'
+```
+
+### Date range with between
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"created_on","operator":"between","value":["2025-01-01","2025-06-30"]}]}'
+```
+
+### Filter on related field
+
+Filter by related account's status:
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"rel_related_account/account_status","operator":"=","value":1}]}'
+```
+
+### Current user filter
+
+Records owned by current user:
+
+```bash
+docyrus ds list crm contacts --filters '{"rules":[{"field":"record_owner","operator":"active_user"}]}'
+```
+
+### Nested AND + OR
+
+Active contacts created this month OR contacts with high priority:
+
+```bash
+docyrus ds list crm contacts --filters '{"combinator":"or","rules":[{"combinator":"and","rules":[{"field":"status","operator":"=","value":"active"},{"field":"created_on","operator":"this_month"}]},{"field":"priority","operator":">=","value":5}]}'
+```
+
+---
+
+## Sorting
+
+Sort by name ascending (default):
+
+```bash
+docyrus ds list crm contacts --orderBy "name"
+```
+
+Sort by created date descending:
+
+```bash
+docyrus ds list crm contacts --orderBy "created_on DESC"
+```
+
+---
+
+## Pagination
+
+First 10 records:
+
+```bash
+docyrus ds list crm contacts --limit 10
+```
+
+Next 10 records (page 2):
+
+```bash
+docyrus ds list crm contacts --limit 10 --offset 10
+```
+
+Get total count alongside results:
+
+```bash
+docyrus ds list crm contacts --limit 10 --fullCount true
+```
+
+---
+
+## Combined Examples
+
+### Active contacts with email, sorted by name, paginated
+
+```bash
+docyrus ds list crm contacts \
+  --columns "name, email, phone, created_on" \
+  --filters '{"rules":[{"field":"status","operator":"=","value":"active"},{"field":"email","operator":"not empty"}]}' \
+  --orderBy "name" \
+  --limit 25 \
+  --fullCount true
+```
+
+### Recent high-priority deals with account info
+
+```bash
+docyrus ds list crm deals \
+  --columns "name, amount, stage, ...related_account(account_name)" \
+  --filters '{"combinator":"and","rules":[{"field":"priority","operator":">=","value":4},{"field":"created_on","operator":"last_30_days"}]}' \
+  --orderBy "amount DESC" \
+  --limit 20
+```
+
+### Search for records by keyword
+
+```bash
+docyrus ds list crm contacts \
+  --columns "name, email, phone" \
+  --filters '{"rules":[{"field":"name","operator":"like","value":"Smith"}]}' \
+  --format json
+```
+
+### Export all records as JSON lines
+
+```bash
+docyrus ds list crm contacts \
+  --columns "id, name, email, phone, status, created_on" \
+  --format jsonl
+```
+
+### Records owned by current user, created this quarter
+
+```bash
+docyrus ds list crm tasks \
+  --columns "name, status, priority, due_date" \
+  --filters '{"combinator":"and","rules":[{"field":"record_owner","operator":"active_user"},{"field":"created_on","operator":"this_quarter"}]}' \
+  --orderBy "due_date" \
+  --limit 50
+```

package/resources/pi-agent/skills/docyrus-curl/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: docyrus-curl
+description: Send arbitrary requests to Docyrus API. Run `docyrus curl --help` for usage details.
+command: docyrus curl
+---
+
+# docyrus curl
+
+Send arbitrary requests to Docyrus API
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `path` | `string` | yes | API path (no absolute URL) |
+
+## Environment Variables
+
+| Name | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `DOCYRUS_API_CLIENT_ID` | `string` | no |  | Default Docyrus OAuth2 client id |
+
+## Options
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--request` | `string` |  | HTTP method |
+| `--header` | `array` |  | Request header (repeatable) |
+| `--data` | `string` |  | Request payload |
+| `--get` | `boolean` |  | Send data as query string |
+| `--include` | `boolean` |  | Include status and response headers |
+| `--noAuth` | `boolean` |  | Skip Authorization header |

package/resources/pi-agent/skills/docyrus-discover/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: docyrus-discover
+description: Discovery commands. Download tenant OpenAPI spec for the active tenant, Return full endpoint object for a path and HTTP method, Return full entity object by name, List API namespaces from active tenant OpenAPI spec, List endpoints with method and description for matching path prefix, Search endpoint paths and entity names (endpoint results include method and description). Run `docyrus discover --help` for usage details.
+command: docyrus discover
+---
+
+# docyrus discover api
+
+Download tenant OpenAPI spec for the active tenant
+
+---
+
+# docyrus discover endpoint
+
+Return full endpoint object for a path and HTTP method
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `selector` | `string` | yes | Endpoint selector, e.g. /v1/users/me or [PUT]/v1/users/me/photo |
+
+---
+
+# docyrus discover entity
+
+Return full entity object by name
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `name` | `string` | yes | Entity name, e.g. UserEntity |
+
+---
+
+# docyrus discover namespaces
+
+List API namespaces from active tenant OpenAPI spec
+
+---
+
+# docyrus discover path
+
+List endpoints with method and description for matching path prefix
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `prefix` | `string` | yes | Path prefix, e.g. /v1/users |
+
+---
+
+# docyrus discover search
+
+Search endpoint paths and entity names (endpoint results include method and description)
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `query` | `string` | yes | One or more comma-separated search strings |

package/resources/pi-agent/skills/docyrus-ds/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: docyrus-ds
+description: Data source commands. Create a data source item, Delete a data source item, Get data source metadata, List data source items, Update a data source item. Run `docyrus ds --help` for usage details.
+command: docyrus ds
+---
+
+# docyrus ds create
+
+Create a data source item
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `appSlug` | `string` | yes |  |
+| `dataSourceSlug` | `string` | yes |  |
+
+## Options
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--data` | `string` |  | JSON payload for record fields |
+| `--fromFile` | `string` |  | Path to JSON or CSV payload file |
+
+---
+
+# docyrus ds delete
+
+Delete a data source item
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `appSlug` | `string` | yes |  |
+| `dataSourceSlug` | `string` | yes |  |
+| `recordId` | `string` | yes |  |
+
+---
+
+# docyrus ds get
+
+Get data source metadata
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `appSlug` | `string` | yes |  |
+| `dataSourceSlug` | `string` | yes |  |
+
+---
+
+# docyrus ds list
+
+List data source items
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `appSlug` | `string` | yes |  |
+| `dataSourceSlug` | `string` | yes |  |
+
+## Options
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--columns` | `string` |  |  |
+| `--filters` | `string` |  |  |
+| `--limit` | `number` |  |  |
+| `--offset` | `number` |  |  |
+| `--orderBy` | `string` |  |  |
+| `--fullCount` | `boolean` |  |  |
+
+---
+
+# docyrus ds update
+
+Update a data source item
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `appSlug` | `string` | yes |  |
+| `dataSourceSlug` | `string` | yes |  |
+| `recordId` | `string` | no |  |
+
+## Options
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--data` | `string` |  | JSON payload for record fields |
+| `--fromFile` | `string` |  | Path to JSON or CSV payload file |

package/resources/pi-agent/skills/docyrus-env/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: docyrus-env
+description: Environment commands. List available environments, Switch active environment by id or name. Run `docyrus env --help` for usage details.
+command: docyrus env
+---
+
+# docyrus env list
+
+List available environments
+
+---
+
+# docyrus env use
+
+Switch active environment by id or name
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `selector` | `string` | yes | Environment id or name |