apexrest 0.4.0-beta.1

package/README.uk.md

@@ -0,0 +1,201 @@
+# APEXREST для Codex
+
+[English](README.md) | Українська
+
+![Символ APEXREST: олівець і лінійка](docs/assets/apexrest-logo.svg)
+
+[![Локальні перевірки якості](https://github.com/apexrest-dev/apexrest-codex/actions/workflows/ci.yml/badge.svg)](https://github.com/apexrest-dev/apexrest-codex/actions/workflows/ci.yml)
+
+**Створюйте й змінюйте застосунки Oracle APEX за допомогою Codex: від вихідного коду до перевіреного імпорту.**
+
+Ще не знайомі з Oracle APEX? Це платформа для створення бізнес-вебзастосунків на основі Oracle Database: форм, дашбордів, звітів і внутрішніх інструментів. APEXREST поєднує цей процес із Codex, агентом OpenAI для роботи з кодом: запит на кшталт «додай звіт про статус замовлень» перетворюється на зміни коду застосунку, перевірки й контрольоване розгортання.
+
+APEXREST поєднує нативні навички Codex та інструменти MCP з Oracle SQLcl. Генеруйте APEXlang, переносьте наявний застосунок у проєкт, редагуйте сторінки й спільні компоненти, плануйте зміни, імпортуйте їх у дозволену ціль і перевіряйте результат у вбудованому браузері Codex.
+
+[Початок роботи](docs/getting-started.uk.md) · [Документація](docs/index.uk.md) · [Безпека розгортання](docs/deployment-safety.uk.md) · [Стан перевірки](docs/implementation-status.uk.md) · [Участь у розробці](CONTRIBUTING.uk.md)
+
+![APEXREST поєднує запит у Codex із кодом APEXlang, перевіреним планом розгортання, Oracle APEX та перевірками виконання.](docs/assets/overview.uk.svg)
+
+> **Бета: `0.4.0-beta.1`.** Single використовує поточну сесію Codex; команда потребує явного увімкнення у Settings. Програмне очікування завдань, пакети метаданих, стислі відомості про проєкт і точковий пошук довідки зменшують повторні обміни між моделлю та інструментами; див. [примітки до випуску](docs/release-notes.uk.md). Наявні докази компіляції шаблонів Oracle, циклу незміненого застосунку через ORDS і нативного встановлення Codex зберігають зафіксовані межі та версії. Готовність стабільного випуску досі заблокована рештою інтеграційних, відновлювальних і платформних перевірок. APEXREST — незалежний інструмент, а не офіційний продукт Oracle чи OpenAI.
+
+Опишіть реалізацію в чаті Codex: `$apexrest-work` у single використовує наявну сесію безпосередньо, без іншого агента чи автовідкриття панелі. Моделлю й дозволами керує поточний хост. Явно увімкнені команди зберігають окремі сесії, Auto-маршрутизацію моделей і вбудовану панель; результати повертаються в ту саму розмову. Дивіться [сценарій із чату та моделі Auto](docs/chat-workflow.uk.md). Команда зберігає окремих розробників, обов’язкове рев’ю коду менеджером, незалежний QA та фінальне рев’ю менеджером. Дивіться [API команди та умови схвалення](docs/team.uk.md) й [аудит коду Codex](docs/codex-integration.uk.md).
+
+За замовчуванням працює один агент; команда потребує явного увімкнення у Settings. Дивіться [налаштування виконання](docs/work-modes.uk.md).
+
+У Settings можна обрати **Single agent / Agent team** та **Codex in-app browser / External system browser** для перевірок APEX. Single працює в поточному чаті; панель доступна за запитом. [Налаштування й межі перевірки](docs/work-modes.uk.md).
+
+**Settings → Database network transport** задає **Direct Oracle listener** або **ORDS HTTP(S)** для нових операцій у всіх проєктах. Прямий режим пропонує вибір збережених з’єднань SQLcl. ORDS використовує наявні ім’я користувача й пароль бази даних та ORDS URL схеми, коли listener, зазвичай на порту 1521, недоступний. Налаштування й пароль зберігаються у приватних локальних файлах плагіна; вводьте пароль у локальній панелі або через CLI `--password-file`. ORDS використовує SQLcl CLI та підтримує імпорт/експорт APEXlang. Перемикання назад зберігає обидва налаштування з’єднання. Посібник [SQL через ORDS](docs/ords.uk.md) описує налаштування й межі перевірки.
+
+Відкрийте `$apexrest-panel`, щоб бачити налаштування проєкту, роботу агентів-покемонів, обов’язкові рев’ю, QA та операції APEX у Codex. Консольний режим — `apexrest panel tui`. Дивіться [панель розробки](docs/panel.uk.md).
+
+Читайте [повний агентний процес зі скріншотами](docs/agent-workflow.uk.md): налаштування завдання, ролі покемонів, обов’язкові рев’ю, QA, цикли виправлень і дозволена доставка APEX.
+
+![Фактична панель Codex із Mewtwo, Pikachu, Charmander і Squirtle після локального завдання з обов’язковими рев’ю.](docs/assets/panel-agent-team.jpg)
+
+_Справжній знімок вбудованого браузера Codex. Ізольований приклад із кодом перевіряє виконання команди; він не показує імпорт Oracle._
+
+## ORDS SQL: шлях до Codex Cloud
+
+APEXREST підтримує SQL через **Oracle REST Data Services (ORDS)**. ORDS дає інструментам доступ до бази через HTTPS без прямого з’єднання з Oracle listener. Це дозволяє налаштувати роботу комплектних інструментів командного рядка APEXREST у контейнері Codex Cloud. База даних залишається там, де вона розміщена.
+
+Приклад у SQLcl — інструменті командного рядка Oracle:
+
+```sql
+connect -orest app_user@https://example.com/ords/app_user/
+```
+
+Параметр `-orest` обирає REST-з’єднання. Замініть приклади облікового запису й URL схеми на свою дозволену ціль; REST-Enabled SQL має бути ввімкнено. Обліковому запису все одно потрібні дані для входу до бази та права на запитану роботу. Дивіться [SQL через ORDS](docs/ords.uk.md).
+
+| | Локальний режим | Налаштування Codex Cloud |
+| --- | --- | --- |
+| Де виконуються задачі | На вашому комп’ютері; він має залишатися ввімкненим, поки працюють агенти. | У хмарному контейнері; домашній комп’ютер може бути вимкнений. |
+| Інструменти й залежності | Встановлюються й підтримуються на вашому комп’ютері. | Готуються скриптами налаштування й обслуговування для повторного використання. |
+| Доступ до бази | Пряме з’єднання Oracle або ORDS HTTP(S). | Описане налаштування використовує дозволену точку доступу ORDS через HTTPS. |
+
+### Делегуйте роботу з телефона
+
+Після налаштування [нативної інтеграції Codex зі Slack](https://learn.chatgpt.com/docs/third-party/slack) можна надсилати запити з `@Codex` і стежити за їхніми задачами у Cloud. Завдяки [мобільним повідомленням Slack](https://slack.com/help/articles/201457107-Send-and-read-messages) це можна робити з телефона. Хмарне виконання звільняє ноутбук для іншої роботи й не залежить від увімкненого домашнього комп’ютера.
+
+**[Режим Remote](https://learn.chatgpt.com/docs/remote) мобільного застосунку ChatGPT** підключається до комп’ютера, який має залишатися активним і в мережі. Його вимоги до виконання відрізняються від задачі у Cloud.
+
+### Сценарій команди агентів, який ще потрібно налаштувати й перевірити
+
+Після налаштування хмарного середовища, доступу до бази й відповідних тестів передбачено такий процес:
+
+1. Агент-розробник готує зміни застосунку APEX.
+2. Рецензент перевіряє код.
+3. Незалежний QA-агент запускає налаштовані тести.
+4. Ви переглядаєте результат перед дозволеним розгортанням.
+
+[Посібник налаштування Cloud](docs/codex-cloud.uk.md) описує **CLI + ORDS**. Повний процес роботи команди агентів у Codex Cloud ще потребує наскрізної перевірки; посібник не підтверджує виявлення нативного плагіна/MCP або підтримку панелі у Cloud. Наявні докази локальної команди й Oracle зберігають свої задокументовані межі.
+
+![Концепція APEXREST: браузер або Slack на телефоні делегує роботу Codex Cloud, CLI якого звертається до Oracle через ORDS HTTPS; порівняно локальне та хмарне виконання, а процес команди агентів ще потребує налаштування й перевірки.](docs/assets/ords-codex-cloud.png)
+
+_Ілюстративний огляд англійською; налаштування й межі перевірки пояснено українською вище._
+
+## Встановлення через термінал
+
+Маючи Git і Node 24 LTS, відкрийте готовий TUI з репозиторію. Для **Install plugin** також потрібен Codex CLI з підтримкою плагінів.
+
+```sh
+git clone https://github.com/apexrest-dev/apexrest-codex.git
+cd apexrest-codex
+node plugins/apexrest-apex/runtime/apexrest.mjs
+```
+
+1. Виберіть **Install tools** для встановлення Node.js, Java, SQLcl і браузерних інструментів. Прочитайте умови Oracle й увімкніть **Accept Oracle license terms**, якщо погоджуєтеся. **Skip browser installation** пропускає браузерні інструменти.
+2. Виберіть **Install plugin**, щоб зареєструвати APEXREST у Codex із наявним середовищем виконання.
+3. Перезапустіть Codex і почніть нову задачу. Додайте керований каталог `bin` до PATH за [інструкцією засобу запуску](docs/getting-started.uk.md#використання-cli), щоб відкривати меню командою `apexrest` з будь-якої папки.
+
+На екрані **Review** натисніть Enter, щоб виконати вибрану дію. Перемикачів **Preview only** і **Approve changes** немає. Готовий пакет не потребує `npm ci` або збирання TypeScript. Повна [інструкція встановлення](docs/getting-started.uk.md#встановлення-через-термінал) також описує перевірку з’єднань і видалення.
+
+## Встановлення в Codex
+
+Для прямої реєстрації плагіна через Codex CLI використовуйте Node 24 LTS у `PATH` і виконайте:
+
+```sh
+codex plugin marketplace add apexrest-dev/apexrest-codex
+codex plugin add apexrest-apex@apexrest
+```
+
+Репозиторій містить зібране середовище виконання; для цього встановлення не потрібні `npm ci` або локальне збирання. Після реєстрації почніть нову задачу Codex. [Посібник зі встановлення](docs/getting-started.uk.md#встановлення-плагіна) описує перевірку, налаштування Oracle, кероване встановлення та видалення. Встановлення не створює базу даних і не розгортає застосунок.
+
+Після встановлення почніть нову задачу Codex і надайте запит:
+
+> Скористайся APEXREST, щоб перевірити моє налаштування. Повідом, які перевірки компілятора, з’єднання та цільового середовища ще потребують уваги.
+
+Потрібен хост Codex із підтримкою нативних плагінів. Для роботи з Oracle також потрібні перевірені версії Node, Java та SQLcl, наявна підтримувана ціль APEX і збережене пряме з’єднання SQLcl або локальні облікові дані ORDS у плагіні. [Посібник](docs/getting-started.uk.md) пояснює кожен крок; ніколи не вставляйте паролі в запит.
+
+Надішліть `Use $apexrest-menu` у полі повідомлення Codex, щоб показати **All functions** у розмові: налаштування, проєкти, APEX, базу даних, розгортання, тестування, діагностику та рев’ю. Це навичка, яка показує меню в розмові; плагін не додає постійну кнопку APEXREST у бічну панель або верхнє меню. Навігацію через вибір навичок і сторінку плагінів описано в [пошуку меню](docs/getting-started.uk.md#усі-функції-в-меню-плагіна-codex).
+
+Щоб встановити Java, SQLcl та інші клієнтські інструменти, виберіть **Install dependencies** у меню плагіна або викличте `$apexrest-install-dependencies`. Доступні всі залежності, інструменти Oracle без браузера або попередній перегляд. Параметри та згоду з ліцензією описано в [команді залежностей](docs/getting-started.uk.md#встановлення-залежностей-із-меню-плагіна).
+
+## Термінальний інтерфейс
+
+**Install plugin** створює керований засіб запуску; пряма реєстрація через `codex plugin add` сама по собі не додає `apexrest` до PATH. Збережені з’єднання беруться безпосередньо зі сховища SQLcl; для їх перегляду й перевірки псевдоніми APEXREST не потрібні.
+
+Запустіть `apexrest` в інтерактивному терміналі: логотип APEXREST і сім прямих дій — встановлення/видалення інструментів, встановлення/видалення плагіна, список/перевірка збережених з’єднань SQLcl. Вибирайте стрілками або вводьте текст для пошуку. У списку з’єднань Enter перевіряє вибрану назву, Ctrl+R оновлює список. Інші дії залишаються явними CLI-командами. Явні команди та `--json` зберігають поведінку для скриптів; запуск через канал друкує довідку.
+
+Вибір **SQLcl mode: CLI / MCP** зберігає спосіб виконання Oracle-команд: SQLcl CLI або офіційний SQLcl MCP (`sql -mcp`). Це окрема дія TUI; вона не змінює реєстрацію плагіна. Див. [режими SQLcl](docs/tui.uk.md#режим-sqlcl-cli-або-mcp).
+
+Головний екран також містить таблицю APEXlang: 99 типів у 9 групах із комплектного довідника Oracle, зокрема 23 елементи сторінки. Tab перемикає дії й каталог; вводьте назву або групу для пошуку, стрілками прокручуйте список. Каталог працює локально без з’єднання з базою.
+
+[Посібник термінала](docs/tui.uk.md) описує клавіші та засоби запуску. У копії репозиторію `node plugins/apexrest-apex/runtime/apexrest.mjs` відкриває той самий інтерфейс. Сама реєстрація нативного плагіна Codex не додає `apexrest` до `PATH` оболонки.
+
+## Що можна створювати
+
+| Сценарій                  | Що робить APEXREST                                                                                                        |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| Створення застосунку      | Генерує справжній Oracle APEXlang із порожнього застосунку або шаблону CRM клієнтів.                                      |
+| Зміна наявного застосунку | Експортує в новий каталог, зберігає Oracle ID та метадані `.apex`, дає змогу редагувати код під контролем версій.         |
+| Створення дашборда        | Використовує реальні вихідні запити, нативні компоненти APEX, передані на сервер елементи фільтрів і перевірки виконання. |
+| Розгортання зміни         | Прив’язує незмінний план до коду, інструментарію та цілі; резервує наявний застосунок; імпортує за належним дозволом.     |
+| Тестування й діагностика  | Запускає налаштовані модульні, SQL, API або браузерні набори; надає обмежену діагностику та результати фонових завдань.   |
+
+Явний запит створити, оновити чи імпортувати визначений застосунок розробки/тестування включає необхідний імпорт у цих межах. Codex фіксує вже наданий дозвіл і завершує процес. Для production потрібне окреме зовнішнє підписане схвалення на захищеному runner.
+
+## Почніть із конкретного запиту
+
+**Створити застосунок**
+
+> Скористайся APEXREST, щоб створити CRM клієнтів у налаштованому середовищі розробки. Додай пошук клієнтів, форму редагування з валідацією та дашборд. Заверши планування, дозволений імпорт і відповідні перевірки виконання.
+
+**Змінити наявний застосунок**
+
+> Скористайся APEXREST, щоб перенести застосунок 100 із налаштованого тестового середовища в новий проєкт. Додай дашборд продажів із реальними показниками бази даних. Збережи наявні сторінки, спільні компоненти й автентифікацію, потім імпортуй і перевір зміну.
+
+**Внести наступну зміну**
+
+> Онови фільтри дашборда так, щоб вони оновлювали відповідні нативні регіони. Використай наявний проєкт і з’єднання, звір показники, імпортуй у той самий тестовий застосунок і перевір взаємодії у вбудованому браузері.
+
+Замініть приклади ID та назв середовищ на справжню ціль. Codex запитує відсутні несекретні ідентифікаційні дані; він не вгадує базу даних і не розширює запит на сторонні записи в схему.
+
+## Короткий шлях від редагування до імпорту
+
+![Процес розгортання: одноразовий огляд, узгоджені зміни, валідація під час планування, перевірка прив’язаного плану, резервування та імпорт, потім перевірка. Перед записом зберігаються перевірки ідентичності, розбіжностей і дозволу.](docs/assets/deployment-flow.uk.svg)
+
+Процес повторно використовує результати огляду проєкту, групує пов’язані зміни та уникає зайвого запуску компілятора безпосередньо перед плануванням. Незалежні попередні перевірки лише для читання виконуються паралельно. Кожен запис усе ще потребує свіжої перевірки цілі, перевірок розбіжностей коду й цілі, координації та перевіреної резервної копії наявного застосунку.
+
+Достатньо чистої підтримуваної інсталяції APEX. Службові таблиці APEXREST **не потрібні**: типово використовуються стійка локальна історія міграцій і координація. Для незалежних машин потрібне зовнішнє послідовне виконання або явно вибраний режим координації через базу даних. [Межі розгортання](docs/deployment-safety.uk.md).
+
+## Що перевірено
+
+| Область               | Наявні докази                                                                                                                                      | Що залишається                                                                                          |
+| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| Нативний плагін Codex | Ізольоване встановлення, виявлення, виклики інструментів і життєвий цикл на Codex 0.154.0 / macOS arm64                                            | Інші поєднання хоста й платформи; оновлення доказів для стабільного випуску                             |
+| Oracle APEXlang       | Реальна компіляція blank/CRM через локальний SQLcl без з’єднання з базою даних                                                                     | Імпорти зміненого коду, ширше покриття компонентів і фікстури непідтримуваних компонентів               |
+| Підключення ORDS      | [Дозволений експорт/імпорт/експорт незміненого застосунку](docs/evidence/ords-connected.json), створення SQL-копії та 21 побайтово ідентичний файл | Імпорти змін, SQL-відновлення, відновлення після перерваної відповіді та браузерні перевірки застосунку |
+| Локальне виконання    | Модульні, контрактні CLI/MCP, інсталяційні й пакувальні перевірки з явно позначеними фікстурами                                                    | Відновлення з підключенням, ін’єкція збоїв, інтеграція SQL/CRUD і браузерні перевірки застосунку        |
+
+Модульні тести, змодельовані збої, реальні операції Oracle й перевірки нативного хоста записуються окремо. Див. [матрицю приймання](docs/acceptance.json), [стан реалізації](docs/implementation-status.uk.md) і [решту умов випуску](docs/next-actions.uk.md). Відсутній чи пропущений інтеграційний набір не є успішним результатом.
+
+## Локальна розробка
+
+Використовуйте Node 24 LTS і зафіксований npm lockfile:
+
+```sh
+npm ci --ignore-scripts
+npm run build
+npm run lint
+npm run typecheck
+npm run test:unit
+npm run test:contracts
+npm run test:installers
+npm run site:build
+npm run test:packaging
+```
+
+Після змін коду чи ресурсів виконайте `npm run plugin:sync`, щоб оновити нативний пакет у репозиторії. `npm run plugin:check` порівнює його зі свіжою збіркою. `npm run test:repository-plugin` перевіряє нативне встановлення в ізольованому профілі Codex. Перевірки нативного хоста й Oracle потребують описаних передумов. `npm run release:dry-run` створює локальні артефакти та звіт готовності; `npm run check-release-readiness` завершується помилкою, доки бракує обов’язкових доказів. Жодна з цих команд не публікує випуск. Див. [участь у розробці](CONTRIBUTING.uk.md) і [тестування](docs/testing.uk.md).
+
+## Документація та підтримка
+
+- [Початок роботи](docs/getting-started.uk.md): встановлення, підключення, створення чи перенесення, планування й перевірка.
+- [Codex Cloud](docs/codex-cloud.uk.md): налаштування контейнера, CLI через ORDS, секрети, proxy та maintenance.
+- [Конфігурація](docs/configuration.uk.md): явні цілі, посилання на з’єднання та приватна політика.
+- [SQL через ORDS](docs/ords.uk.md): HTTP(S)-транспорт, облікові дані бази та імпорт/експорт APEXlang.
+- [Архітектура](docs/architecture.uk.md): єдине ядро для CLI, MCP і навичок.
+- [Усунення несправностей](docs/troubleshooting.uk.md): діагностика налаштування, компілятора, автентифікації та відновлення.
+- [Безпека](SECURITY.uk.md): межі роботи з обліковими даними, довіра до коду та приватні звіти.
+- [Налаштування публікації](docs/publishing.uk.md): захищений процес випуску й відкриті передумови.
+
+Повідомляйте про відтворювані помилки через [GitHub issues](https://github.com/apexrest-dev/apexrest-codex/issues), додавши очищену діагностику. Для чутливих повідомлень дотримуйтеся [SECURITY.uk.md](SECURITY.uk.md). Ліцензія — [Apache-2.0](LICENSE).

package/dist/codex-compat/.agents/plugins/marketplace.json

@@ -0,0 +1,23 @@
+{
+  "name": "apexrest",
+  "interface": {
+    "displayName": "APEXREST"
+  },
+  "plugins": [
+    {
+      "name": "apexrest-apex",
+      "source": {
+        "source": "local",
+        "path": "./plugins/apexrest-apex"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_USE",
+        "products": [
+          "codex"
+        ]
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/dist/codex-compat/plugins/apexrest-apex/.codex-plugin/plugin.json

@@ -0,0 +1,32 @@
+{
+  "name": "apexrest-apex",
+  "version": "0.4.0-beta.1",
+  "description": "Develop, deploy and test Oracle APEX applications with Codex.",
+  "author": {
+    "name": "APEXREST",
+    "url": "https://apex.rest"
+  },
+  "license": "Apache-2.0",
+  "interface": {
+    "displayName": "APEXREST for Codex",
+    "shortDescription": "Oracle APEX development workflows",
+    "longDescription": "Independent APEXREST tooling for controlled Oracle APEX development, deployment and testing.",
+    "developerName": "APEXREST",
+    "websiteURL": "https://apex.rest",
+    "composerIcon": "./assets/apexrest-icon.svg",
+    "logo": "./assets/apexrest-logo.svg",
+    "logoDark": "./assets/apexrest-logo.svg",
+    "category": "Productivity",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Use $apexrest-work. Use saved settings; in single mode complete my APEX task directly in this Codex chat.",
+      "Use $apexrest-panel to open project settings, agent activity, reviews and APEX operations inside Codex.",
+      "Use $apexrest-menu to show all functions, setup and connection diagnostics."
+    ]
+  },
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json"
+}

package/dist/codex-compat/plugins/apexrest-apex/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "apexrest": {
+      "command": "node",
+      "args": [
+        "runtime/mcp.mjs"
+      ],
+      "cwd": "."
+    }
+  }
+}

package/dist/codex-compat/plugins/apexrest-apex/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/codex-compat/plugins/apexrest-apex/NOTICE

@@ -0,0 +1,18 @@
+APEXREST for Codex
+Copyright 2026 APEXREST contributors.
+Independent software. Not an official Oracle or OpenAI product.
+
+Oracle APEXlang reference fragments and adapted form/report/dashboard examples:
+Copyright Oracle and/or its affiliates. Licensed under UPL-1.0.
+Pinned source and hashes: toolchains/sources.lock.json.
+Full license: resources/references/ORACLE-LICENSE.txt.
+Oracle-generated blank-app files retain their original headers and MMD metadata.
+Node.js, Java, SQLcl and Chromium are downloaded separately from their vendors.
+No Oracle or Java executable is redistributed in APEXREST packages.
+Bundled dependency license texts and a CycloneDX SBOM accompany each local release.
+
+Pokémon agent avatars: five sprites from PokeAPI/sprites, with pinned source URLs
+and hashes in resources/panel/assets/sources.json. All image contents are
+Copyright The Pokémon Company, as stated by the upstream LICENCE.txt included
+with the assets. These images are not covered by this project's Apache license.
+APEXREST is independent and is not endorsed by The Pokémon Company.

package/dist/codex-compat/plugins/apexrest-apex/assets/apexrest-icon.svg

@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8'?>
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" x="0px" y="0px" viewBox="100 66 98 98" xml:space="preserve" width="98" height="98" role="img" aria-labelledby="logo-title">
+  <title id="logo-title">APEXREST pencil and ruler symbol</title>
+  <style type="text/css">
+	.st0{fill:#31BEF9;}
+	.st1{fill:#FFD541;}
+	.st2{fill:#FF4141;}
+	.st3{fill:#1E1E1E;}
+</style>
+  <g id="Слой_2">
+    <polygon class="st0" points="133,149 177,106 160,89 116,132  " />
+  </g>
+  <g id="Слой_3">
+    <polygon class="st1" points="128,114 147,95 128,76 126,75 123,76 108,91 107,93 110,97 127,114  " />
+    <polygon class="st1" points="151,137 170,118 189,137 190,140 189,142 186,146 173,157 170,157  " />
+  </g>
+  <g id="Слой_4">
+    <path class="st2" d="M166,83l16,16l4-3l2-5v-4c0,0-1-2-1-3s-3-4-3-4l-5-3h-3h-3l-3,2l-2,2L166,83L166,83z" />
+  </g>
+  <g id="Слой_1">
+    <g>
+      <path class="st3" d="M126.7,115.5l1.7-1.7l-2.2-2.2l4.3-4.3c0.5-0.5,0.4-1.3-0.1-1.7c-0.5-0.4-1.2-0.4-1.7,0l-4.3,4.3l-4.1-4.1    l4.3-4.3c0.5-0.5,0.4-1.3-0.1-1.7c-0.5-0.4-1.2-0.4-1.7,0l-4.3,4.3l-4.1-4.1l9.4-9.5c0.5-0.5,0.4-1.3-0.1-1.7    c-0.5-0.4-1.2-0.4-1.7,0l-9.5,9.5l-3.6-3.6c-0.8-0.8-0.8-2,0-2.8L123.9,77c0.8-0.8,2-0.8,2.8,0L146,96.2l1.7-1.7l-19.2-19.2    c-1.7-1.7-4.6-1.7-6.3,0L107.5,90c-1.7,1.7-1.7,4.6,0,6.3L126.7,115.5z" />
+      <path class="st3" d="M182.7,100.8l3-3c5-5.1,4.9-13.3-0.2-18.3c-5-5-13.1-5-18.2,0l-51.9,51.9c-0.1,0.1-0.2,0.2-0.2,0.4v0.1    l-7.2,23.8c-0.2,0.6,0.2,1.3,0.8,1.5c0.2,0.1,0.5,0.1,0.7,0l23.8-7.2h0.1c0.1-0.1,0.2-0.1,0.4-0.2L182.7,100.8L182.7,100.8z     M159.3,91l6.6,6.6l-41.3,41.3l-6.6-6.6L159.3,91z M110.9,154.2l1-3.5c1.1,0.5,2,1.3,2.5,2.4L110.9,154.2z M116.9,152.4    c-0.8-1.8-2.4-3.2-4.2-4l4.2-13.9l13.7,13.7L116.9,152.4z M132.9,147.1l-6.6-6.6l41.3-41.3l6.6,6.6L132.9,147.1z M175.9,104.1    l-7.4-7.4l-7.4-7.4l4.2-4.2l14.9,14.9L175.9,104.1z M167,83.3l2.1-2.1c4.3-4,10.9-3.7,14.9,0.6c3.7,4,3.7,10.3,0,14.3l-2.1,2.1    L167,83.3z" />
+      <path class="st3" d="M189.9,136.7l-19.2-19.2l-1.7,1.7l19.2,19.2c0.8,0.8,0.8,2,0,2.8l-14.7,14.7c-0.8,0.8-2.1,0.8-2.8,0l-3.6-3.6    l9.5-9.5c0.5-0.4,0.6-1.2,0.2-1.7c-0.4-0.5-1.2-0.6-1.7-0.2c-0.1,0.1-0.1,0.1-0.2,0.2l-9.5,9.5l-4.1-4.1l4.3-4.3    c0.5-0.5,0.5-1.2,0.1-1.7c-0.5-0.5-1.2-0.5-1.7-0.1c0,0,0,0-0.1,0.1l-4.3,4.3l-4.1-4.1l4.3-4.3c0.5-0.5,0.4-1.3-0.1-1.7    c-0.5-0.4-1.2-0.4-1.7,0l-4.3,4.3l-2.2-2.2l-1.8,1.7l19.2,19.2c1.7,1.7,4.6,1.7,6.3,0l14.7-14.7    C191.6,141.3,191.6,138.4,189.9,136.7C189.9,136.7,189.9,136.7,189.9,136.7z" />
+    </g>
+  </g>
+</svg>

package/dist/codex-compat/plugins/apexrest-apex/assets/apexrest-logo.svg

@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8'?>
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" x="0px" y="0px" viewBox="100 66 98 98" xml:space="preserve" width="98" height="98" role="img" aria-labelledby="logo-title">
+  <title id="logo-title">APEXREST pencil and ruler symbol</title>
+  <style type="text/css">
+	.st0{fill:#31BEF9;}
+	.st1{fill:#FFD541;}
+	.st2{fill:#FF4141;}
+	.st3{fill:#1E1E1E;}
+</style>
+  <g id="Слой_2">
+    <polygon class="st0" points="133,149 177,106 160,89 116,132  " />
+  </g>
+  <g id="Слой_3">
+    <polygon class="st1" points="128,114 147,95 128,76 126,75 123,76 108,91 107,93 110,97 127,114  " />
+    <polygon class="st1" points="151,137 170,118 189,137 190,140 189,142 186,146 173,157 170,157  " />
+  </g>
+  <g id="Слой_4">
+    <path class="st2" d="M166,83l16,16l4-3l2-5v-4c0,0-1-2-1-3s-3-4-3-4l-5-3h-3h-3l-3,2l-2,2L166,83L166,83z" />
+  </g>
+  <g id="Слой_1">
+    <g>
+      <path class="st3" d="M126.7,115.5l1.7-1.7l-2.2-2.2l4.3-4.3c0.5-0.5,0.4-1.3-0.1-1.7c-0.5-0.4-1.2-0.4-1.7,0l-4.3,4.3l-4.1-4.1    l4.3-4.3c0.5-0.5,0.4-1.3-0.1-1.7c-0.5-0.4-1.2-0.4-1.7,0l-4.3,4.3l-4.1-4.1l9.4-9.5c0.5-0.5,0.4-1.3-0.1-1.7    c-0.5-0.4-1.2-0.4-1.7,0l-9.5,9.5l-3.6-3.6c-0.8-0.8-0.8-2,0-2.8L123.9,77c0.8-0.8,2-0.8,2.8,0L146,96.2l1.7-1.7l-19.2-19.2    c-1.7-1.7-4.6-1.7-6.3,0L107.5,90c-1.7,1.7-1.7,4.6,0,6.3L126.7,115.5z" />
+      <path class="st3" d="M182.7,100.8l3-3c5-5.1,4.9-13.3-0.2-18.3c-5-5-13.1-5-18.2,0l-51.9,51.9c-0.1,0.1-0.2,0.2-0.2,0.4v0.1    l-7.2,23.8c-0.2,0.6,0.2,1.3,0.8,1.5c0.2,0.1,0.5,0.1,0.7,0l23.8-7.2h0.1c0.1-0.1,0.2-0.1,0.4-0.2L182.7,100.8L182.7,100.8z     M159.3,91l6.6,6.6l-41.3,41.3l-6.6-6.6L159.3,91z M110.9,154.2l1-3.5c1.1,0.5,2,1.3,2.5,2.4L110.9,154.2z M116.9,152.4    c-0.8-1.8-2.4-3.2-4.2-4l4.2-13.9l13.7,13.7L116.9,152.4z M132.9,147.1l-6.6-6.6l41.3-41.3l6.6,6.6L132.9,147.1z M175.9,104.1    l-7.4-7.4l-7.4-7.4l4.2-4.2l14.9,14.9L175.9,104.1z M167,83.3l2.1-2.1c4.3-4,10.9-3.7,14.9,0.6c3.7,4,3.7,10.3,0,14.3l-2.1,2.1    L167,83.3z" />
+      <path class="st3" d="M189.9,136.7l-19.2-19.2l-1.7,1.7l19.2,19.2c0.8,0.8,0.8,2,0,2.8l-14.7,14.7c-0.8,0.8-2.1,0.8-2.8,0l-3.6-3.6    l9.5-9.5c0.5-0.4,0.6-1.2,0.2-1.7c-0.4-0.5-1.2-0.6-1.7-0.2c-0.1,0.1-0.1,0.1-0.2,0.2l-9.5,9.5l-4.1-4.1l4.3-4.3    c0.5-0.5,0.5-1.2,0.1-1.7c-0.5-0.5-1.2-0.5-1.7-0.1c0,0,0,0-0.1,0.1l-4.3,4.3l-4.1-4.1l4.3-4.3c0.5-0.5,0.4-1.3-0.1-1.7    c-0.5-0.4-1.2-0.4-1.7,0l-4.3,4.3l-2.2-2.2l-1.8,1.7l19.2,19.2c1.7,1.7,4.6,1.7,6.3,0l14.7-14.7    C191.6,141.3,191.6,138.4,189.9,136.7C189.9,136.7,189.9,136.7,189.9,136.7z" />
+    </g>
+  </g>
+</svg>