Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,9 @@ Site: `https://feeds.dragon-code.pro`

Source: `docs/docs/`

Feed listing and generation guide: `docs/docs/generation.mdx`
Feed listing guide: `docs/docs/list-feeds.mdx`

Generation and schedule guide: `docs/docs/generation.mdx`

Config attributes reference: `docs/docs/api/config-attributes.mdx`

Expand Down
2 changes: 1 addition & 1 deletion docs/docs/create-feeds.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ keywords: ["feed", "FeedItem", "FeedInfo", "make:feed"]

import ThemedImage from '@theme/ThemedImage';

[← Previous](./installation.mdx) · [Back to README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Next →](./generation.mdx)
[← Previous](./installation.mdx) · [Back to README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Next →](./list-feeds.mdx)

# Create feeds

Expand Down
58 changes: 2 additions & 56 deletions docs/docs/generation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ description: "Information on generating feed files for later distribution"
type: guide
status: stable
since: "1.0"
keywords: ["generation", "schedule", "queue", "FeedTarget", "separate files", "feed:generate", "feed:list"]
keywords: ["generation", "schedule", "queue", "FeedTarget", "separate files", "feed:generate"]
---

[← Previous](./create-feeds.mdx) · [Back to README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Next →](./feed-targets.mdx)
[← Previous](./list-feeds.mdx) · [Back to README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Next →](./feed-targets.mdx)

# Generation & schedule

Expand All @@ -25,60 +25,6 @@ Please note that when you call the command without a parameter, the console will
However, instead of being executed, such feeds will be marked with the `SKIP` status.
:::

## List registered feeds {/* #list_feeds */}

Starting with version 2.1.0, list feed registrations without generating files or changing their state:

```bash
php artisan feed:list
```

The command has no custom arguments or options. It displays a table with all registrations, including inactive and soft-deleted feeds.

| Column | Meaning |
| --- | --- |
| `id` | Registration ID. |
| `slug` | Registration slug used by `feed:generate`. |
| `title` | Registration title. |
| `expression` | Stored cron expression. |
| `is_active` | Whether the registration is enabled. |
| `is_deleted` | Whether the registration is soft-deleted. |
| `last_activity` | Last recorded generation time in ISO 8601; `null` in JSON when unset. |

Non-deleted registrations appear first, followed by soft-deleted registrations. Within each group, active feeds appear first, then rows are sorted by title and ID. Boolean values appear as `true` or `false` in the console.

Use a non-deleted registration's slug to generate that feed:

```bash
php artisan feed:generate products
```

If no registrations exist, the console displays `No feeds available`.

### AI agent listing {/* #list_feeds_agent */}

Inside a recognized AI coding agent, `feed:list` automatically returns one compact JSON object on a single line. No extra option is required. Boolean fields remain JSON booleans:

```json
{
"tool": "feed:list",
"result": "success",
"feeds": [
{
"id": 1,
"slug": "products",
"title": "Products",
"expression": "0 * * * *",
"is_active": true,
"is_deleted": false,
"last_activity": null
}
]
}
```

The example is formatted for readability. An empty listing returns the same envelope with `"feeds": []`.

## Single feed {/* #single_feed */}

:::warning
Expand Down
64 changes: 64 additions & 0 deletions docs/docs/list-feeds.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
title: "List registered feeds"
description: "List registered feeds and inspect their state without generating files"
type: guide
status: stable
since: "2.1.0"
keywords: ["feed:list", "registered feeds", "registrations", "AI agents"]
---

[← Previous](./create-feeds.mdx) · [Back to README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Next →](./generation.mdx)

# List registered feeds {/* #list_feeds */}
Comment thread
andrey-helldar marked this conversation as resolved.

Starting with version 2.1.0, list feed registrations without generating files or changing their state:

```bash
php artisan feed:list
```

The command has no custom arguments or options. It displays a table with all registrations, including inactive and soft-deleted feeds.

| Column | Meaning |
| --- | --- |
| `id` | Registration ID. |
| `slug` | Registration slug used by `feed:generate`. |
| `title` | Registration title. |
| `expression` | Stored cron expression. |
| `is_active` | Whether the registration is enabled. |
| `is_deleted` | Whether the registration is soft-deleted. |
| `last_activity` | Last recorded generation time in ISO 8601; `null` in JSON when unset. |

Non-deleted registrations appear first, followed by soft-deleted registrations. Within each group, active feeds appear first, then rows are sorted by title and ID. Boolean values appear as `true` or `false` in the console.

Use a non-deleted registration's slug to generate that feed:

```bash
php artisan feed:generate products
```

If no registrations exist, the console displays `No feeds available`.

## AI agent listing {/* #list_feeds_agent */}

Inside a recognized AI coding agent, `feed:list` automatically returns one compact JSON object on a single line. No extra option is required. Boolean fields remain JSON booleans:

```json
{
"tool": "feed:list",
"result": "success",
"feeds": [
{
"id": 1,
"slug": "products",
"title": "Products",
"expression": "0 * * * *",
"is_active": true,
"is_deleted": false,
"last_activity": null
}
]
}
```

The example is formatted for readability. An empty listing returns the same envelope with `"feeds": []`.
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ keywords: ["feed", "FeedItem", "FeedInfo", "make:feed"]

import ThemedImage from '@theme/ThemedImage';

[← Папярэдняя](./installation.mdx) · [Назад да README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Наступная →](./generation.mdx)
[← Папярэдняя](./installation.mdx) · [Назад да README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Наступная →](./list-feeds.mdx)

# Стварэнне стужак

Expand Down
58 changes: 2 additions & 56 deletions docs/i18n/be/docusaurus-plugin-content-docs/current/generation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ description: "Звесткі пра генерацыю файлаў стужак
type: guide
status: stable
since: "1.0"
keywords: ["generation", "schedule", "queue", "FeedTarget", "separate files", "feed:generate", "feed:list"]
keywords: ["generation", "schedule", "queue", "FeedTarget", "separate files", "feed:generate"]
---

[← Папярэдняя](./create-feeds.mdx) · [Назад да README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Наступная →](./feed-targets.mdx)
[← Папярэдняя](./list-feeds.mdx) · [Назад да README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Наступная →](./feed-targets.mdx)

# Генерацыя і расклад

Expand All @@ -25,60 +25,6 @@ php artisan feed:generate
Але такія стужкі не будуць выкананы і атрымаюць стан `SKIP`.
:::

## Спіс зарэгістраваных стужак {/* #list_feeds */}

Пачынаючы з версіі 2.1.0, можна праглядаць рэгістрацыі стужак без генерацыі файлаў або змянення іх стану:

```bash
php artisan feed:list
```

Каманда не мае ўласных аргументаў або параметраў. Яна паказвае табліцу ўсіх рэгістрацый, у тым ліку неактыўных і мякка выдаленых стужак.

| Слупок | Значэнне |
| --- | --- |
| `id` | Ідэнтыфікатар рэгістрацыі. |
| `slug` | Slug рэгістрацыі, які выкарыстоўвае `feed:generate`. |
| `title` | Назва рэгістрацыі. |
| `expression` | Захаваны выраз cron. |
| `is_active` | Ці ўключана рэгістрацыя. |
| `is_deleted` | Ці мякка выдалена рэгістрацыя. |
| `last_activity` | Апошні запісаны час генерацыі ў фармаце ISO 8601; `null` у JSON, калі не зададзены. |

Спачатку паказваюцца нявыдаленыя рэгістрацыі, затым — мякка выдаленыя. У кожнай групе актыўныя стужкі ідуць першымі, далей радкі сартуюцца па назве і ідэнтыфікатары. Лагічныя значэнні ў кансолі паказваюцца як `true` або `false`.

Каб згенераваць стужку, выкарыстоўвайце slug нявыдаленай рэгістрацыі:

```bash
php artisan feed:generate products
```

Калі рэгістрацый няма, кансоль паказвае `No feeds available`.

### Спіс для ШІ-агента {/* #list_feeds_agent */}

Унутры распазнанага агента праграмавання са штучным інтэлектам `feed:list` аўтаматычна вяртае адзін кампактны аб'ект JSON у адзін радок. Дадатковы параметр не патрэбны. Лагічныя палі застаюцца лагічнымі значэннямі JSON:

```json
{
"tool": "feed:list",
"result": "success",
"feeds": [
{
"id": 1,
"slug": "products",
"title": "Products",
"expression": "0 * * * *",
"is_active": true,
"is_deleted": false,
"last_activity": null
}
]
}
```

Прыклад адфарматаваны для зручнасці чытання. Пусты спіс вяртаецца ў той жа абалонцы з `"feeds": []`.

## Адна стужка {/* #single_feed */}

:::warning
Expand Down
64 changes: 64 additions & 0 deletions docs/i18n/be/docusaurus-plugin-content-docs/current/list-feeds.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
title: "Спіс зарэгістраваных стужак"
description: "Прагляд зарэгістраваных стужак і іх стану без генерацыі файлаў"
type: guide
status: stable
since: "2.1.0"
keywords: ["feed:list", "registered feeds", "registrations", "AI agents"]
---

[← Папярэдняя](./create-feeds.mdx) · [Назад да README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Наступная →](./generation.mdx)

# Спіс зарэгістраваных стужак {/* #list_feeds */}

Пачынаючы з версіі 2.1.0, можна праглядаць рэгістрацыі стужак без генерацыі файлаў або змянення іх стану:

```bash
php artisan feed:list
```

Каманда не мае ўласных аргументаў або параметраў. Яна паказвае табліцу ўсіх рэгістрацый, у тым ліку неактыўных і мякка выдаленых стужак.

| Слупок | Значэнне |
| --- | --- |
| `id` | Ідэнтыфікатар рэгістрацыі. |
| `slug` | Slug рэгістрацыі, які выкарыстоўвае `feed:generate`. |
| `title` | Назва рэгістрацыі. |
| `expression` | Захаваны выраз cron. |
| `is_active` | Ці ўключана рэгістрацыя. |
| `is_deleted` | Ці мякка выдалена рэгістрацыя. |
| `last_activity` | Апошні запісаны час генерацыі ў фармаце ISO 8601; `null` у JSON, калі не зададзены. |

Спачатку паказваюцца нявыдаленыя рэгістрацыі, затым — мякка выдаленыя. У кожнай групе актыўныя стужкі ідуць першымі, далей радкі сартуюцца па назве і ідэнтыфікатары. Лагічныя значэнні ў кансолі паказваюцца як `true` або `false`.

Каб згенераваць стужку, выкарыстоўвайце slug нявыдаленай рэгістрацыі:

```bash
php artisan feed:generate products
```

Калі рэгістрацый няма, кансоль паказвае `No feeds available`.

## Спіс для ШІ-агента {/* #list_feeds_agent */}

Унутры распазнанага агента праграмавання са штучным інтэлектам `feed:list` аўтаматычна вяртае адзін кампактны аб'ект JSON у адзін радок. Дадатковы параметр не патрэбны. Лагічныя палі застаюцца лагічнымі значэннямі JSON:

```json
{
"tool": "feed:list",
"result": "success",
"feeds": [
{
"id": 1,
"slug": "products",
"title": "Products",
"expression": "0 * * * *",
"is_active": true,
"is_deleted": false,
"last_activity": null
}
]
}
```

Прыклад адфарматаваны для зручнасці чытання. Пусты спіс вяртаецца ў той жа абалонцы з `"feeds": []`.
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ keywords: ["feed", "FeedItem", "FeedInfo", "make:feed"]

import ThemedImage from '@theme/ThemedImage';

[← Zurück](./installation.mdx) · [Zurück zur README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Weiter →](./generation.mdx)
[← Zurück](./installation.mdx) · [Zurück zur README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Weiter →](./list-feeds.mdx)

# Feeds erstellen

Expand Down
58 changes: 2 additions & 56 deletions docs/i18n/de/docusaurus-plugin-content-docs/current/generation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ description: "Informationen zum Erzeugen von Feed-Dateien für die spätere Vert
type: guide
status: stable
since: "1.0"
keywords: ["generation", "schedule", "queue", "FeedTarget", "separate files", "feed:generate", "feed:list"]
keywords: ["generation", "schedule", "queue", "FeedTarget", "separate files", "feed:generate"]
---

[← Zurück](./create-feeds.mdx) · [Zurück zur README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Weiter →](./feed-targets.mdx)
[← Zurück](./list-feeds.mdx) · [Zurück zur README](https://github.com/TheDragonCode/laravel-feeds#readme) · [Weiter →](./feed-targets.mdx)

# Generierung und Zeitplanung

Expand All @@ -25,60 +25,6 @@ Beachten Sie, dass die Konsole beim Aufruf des Befehls ohne Parameter Links zu a
Solche Feeds werden jedoch nicht ausgeführt, sondern mit dem Status `SKIP` gekennzeichnet.
:::

## Registrierte Feeds auflisten {/* #list_feeds */}

Ab Version 2.1.0 können Sie Feed-Registrierungen auflisten, ohne Dateien zu erzeugen oder ihren Zustand zu ändern:

```bash
php artisan feed:list
```

Der Befehl hat keine eigenen Argumente oder Optionen. Er zeigt eine Tabelle aller Registrierungen an, einschließlich inaktiver und vorläufig gelöschter Feeds.

| Spalte | Bedeutung |
| --- | --- |
| `id` | ID der Registrierung. |
| `slug` | Registrierungs-Slug, der von `feed:generate` verwendet wird. |
| `title` | Titel der Registrierung. |
| `expression` | Gespeicherter Cron-Ausdruck. |
| `is_active` | Ob die Registrierung aktiviert ist. |
| `is_deleted` | Ob die Registrierung vorläufig gelöscht ist. |
| `last_activity` | Zuletzt gespeicherter Generierungszeitpunkt im Format ISO 8601; `null` in JSON, wenn nicht gesetzt. |

Zuerst erscheinen nicht gelöschte Registrierungen, danach vorläufig gelöschte. Innerhalb jeder Gruppe stehen aktive Feeds zuerst; anschließend werden die Zeilen nach Titel und ID sortiert. Boolesche Werte werden in der Konsole als `true` oder `false` angezeigt.

Verwenden Sie den Slug einer nicht gelöschten Registrierung, um diesen Feed zu erzeugen:

```bash
php artisan feed:generate products
```

Wenn keine Registrierungen vorhanden sind, zeigt die Konsole `No feeds available` an.

### Auflistung für KI-Agenten {/* #list_feeds_agent */}

Innerhalb eines erkannten KI-Coding-Agenten gibt `feed:list` automatisch ein kompaktes JSON-Objekt in einer einzigen Zeile zurück. Es ist keine zusätzliche Option erforderlich. Boolesche Felder bleiben boolesche JSON-Werte:

```json
{
"tool": "feed:list",
"result": "success",
"feeds": [
{
"id": 1,
"slug": "products",
"title": "Products",
"expression": "0 * * * *",
"is_active": true,
"is_deleted": false,
"last_activity": null
}
]
}
```

Das Beispiel ist zur besseren Lesbarkeit formatiert. Eine leere Auflistung liefert dieselbe Hülle mit `"feeds": []`.

## Einzelner Feed {/* #single_feed */}

:::warning
Expand Down
Loading
Loading