apexrest 1.2.0 → 1.3.0

package/dist/runtime/{chunk-2Z3BZF66.mjs → chunk-WPS3CSQJ.mjs}

@@ -40,7 +40,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // packages/core/src/fs.ts
-import { mkdir, open, readFile, readdir, realpath, rename, lstat, rm } from "node:fs/promises";
+import { mkdir, open, readFile, readdir, realpath, rename, lstat, rm, link } from "node:fs/promises";
 import { createReadStream } from "node:fs";
 import path from "node:path";
 import { hostname } from "node:os";
@@ -48,17 +48,54 @@ import { createHash, randomUUID as randomUUID2 } from "node:crypto";
 
 // packages/core/src/result.ts
 import { randomUUID } from "node:crypto";
+var DIAGNOSTIC_LIMIT = 50;
 var Fault = class extends Error {
-  constructor(code, message, exitCode = 1, status = "failed") {
+  constructor(code, message, exitCode = 1, status = "failed", details) {
     super(message);
     this.code = code;
     this.exitCode = exitCode;
     this.status = status;
+    this.details = details;
   }
   code;
   exitCode;
   status;
+  details;
 };
+var faultNextActions = {
+  VALIDATION_FAILED: "Fix the listed diagnostics in the named .apx files, then rerun apexrest_apex_validate until it reports no errors.",
+  VALIDATION_UNCONFIRMED: "The compiler returned no success marker. Read the diagnostics, fix the source and rerun apexrest_apex_validate.",
+  SOURCE_DRIFT: "Sources changed after review. Rerun apexrest_ship with mode:plan, review it, then apply.",
+  TARGET_DRIFT: "The target changed after review. Rerun apexrest_ship with mode:plan and review the new plan.",
+  PLAN_EXPIRED: "Rerun apexrest_ship with mode:plan; plans expire 30 minutes after creation.",
+  DEPLOY_APPROVAL_REQUIRED: "Run apexrest_ship with mode:apply and userRequest set to the user's literal instruction; it records a plan-bound deploy grant for this attempt.",
+  PRODUCTION_CI_REQUIRED: "Production targets need a signed external approval in a protected CI runner; apexrest_ship cannot apply them. Report this to the user.",
+  RECOVERY_REVIEW_REQUIRED: "The plan carries destructive, privileged or security risks. Review them with the user and provide a recovery path before applying.",
+  PROJECT_TRUST_REQUIRED: "Ask the user to add the project's canonical path to trustedProjects in APEXREST_HOME/policy.json (CLI: apexrest status --detail project shows the path), then retry.",
+  PROJECT_NOT_CONFIGURED: "Pass the absolute directory containing apexrest.json, or create one with apexrest_project action:init.",
+  CONNECTION_REQUIRED: "Configure the named connection reference with apexrest_project action:connection_add (never send passwords in chat).",
+  ENVIRONMENT_REQUIRED: "Pass env with a configured environment name; apexrest_project action:inspect lists them.",
+  UNKNOWN_ENVIRONMENT: "Use an environment listed by apexrest_project action:inspect.",
+  OUTCOME_UNKNOWN: "Do not retry. Read apexrest_job status for the same jobId and reconcile the target before any new deployment.",
+  SYNC_BLOCKED: "Reconcile the interrupted import before syncing or deploying again; do not clear ownership.",
+  SYNC_DIRTY: "Local sources differ from the checkpoint. Review or commit them before refreshing the working copy.",
+  UNSUPPORTED_CAPABILITY: "The installed SQLcl lacks this apex command. Run apexrest_status detail:doctor and install the pinned toolchain.",
+  JOB_OUTCOME_UNKNOWN: "Read apexrest_job status with this jobId; do not repeat the operation."
+};
+function normalizeDiagnostic(entry, code) {
+  const d = {
+    severity: entry.severity ?? "error",
+    code: entry.code ?? code,
+    message: redact(String(entry.message))
+  };
+  if (typeof entry.file === "string") d.file = redact(entry.file);
+  if (Number.isInteger(entry.line)) d.line = entry.line;
+  if (Number.isInteger(entry.column)) d.column = entry.column;
+  if (typeof entry.type === "string") d.type = entry.type;
+  if (typeof entry.hint === "string") d.hint = redact(entry.hint);
+  if (Array.isArray(entry.validValues)) d.validValues = entry.validValues.map(String);
+  return d;
+}
 var safeArtifactPages = /* @__PURE__ */ new WeakSet();
 function artifactPage(content, format, id, offset, limit, metadata = {}) {
   const safe = format === "json" ? JSON.stringify(sanitized(JSON.parse(content))) : redact(content);
@@ -125,6 +162,12 @@ function success(operation, data, summary = "Operation completed.") {
 }
 function failure(operation, error) {
   const e = error instanceof Fault ? error : new Fault("INTERNAL_ERROR", error instanceof Error ? error.message : "Unknown failure");
+  const structured = Array.isArray(e.details?.diagnostics) ? e.details.diagnostics : [];
+  const diagnostics = structured.length ? structured.slice(0, DIAGNOSTIC_LIMIT).map((entry) => normalizeDiagnostic(entry, e.code)) : [{ severity: "error", code: e.code, message: redact(e.message) }];
+  const nextActions = [
+    ...Array.isArray(e.details?.nextActions) ? e.details.nextActions.map(redact) : [],
+    ...faultNextActions[e.code] ? [faultNextActions[e.code]] : []
+  ];
   return {
     schemaVersion: 1,
     ok: false,
@@ -132,9 +175,10 @@ function failure(operation, error) {
     status: e.status,
     runId: randomUUID(),
     summary: redact(e.message),
-    diagnostics: [{ severity: "error", code: e.code, message: redact(e.message) }],
+    diagnostics,
     artifacts: [],
-    nextActions: [],
+    nextActions,
+    ...structured.length > DIAGNOSTIC_LIMIT ? { data: { diagnosticsOmitted: structured.length - DIAGNOSTIC_LIMIT } } : {},
     exitCode: e.exitCode
   };
 }
@@ -169,6 +213,21 @@ async function atomicWrite(file, value) {
     await rm(temporary, { force: true });
     throw error;
   }
+  await syncDirectory(path.dirname(file));
+}
+async function syncDirectory(directory) {
+  let handle;
+  try {
+    handle = await open(directory, "r");
+    await handle.sync();
+  } catch (error) {
+    const code = error.code;
+    if (process.platform === "win32" || ["EPERM", "EISDIR", "EINVAL", "ENOTSUP", "EBADF"].includes(code ?? ""))
+      return;
+    throw error;
+  } finally {
+    await handle?.close();
+  }
 }
 var writeJson = (file, value) => atomicWrite(file, JSON.stringify(value, null, 2) + "\n");
 async function readJson(file) {
@@ -184,15 +243,25 @@ async function exists(file) {
   }
 }
 async function contained(root, candidate) {
+  return containedPath(root, candidate, false);
+}
+async function containedChild(root, candidate) {
+  return containedPath(root, candidate, true);
+}
+async function containedPath(root, candidate, child) {
   const base = await realpath(root), target = path.resolve(base, candidate);
   const rel = path.relative(base, target);
   if (rel === ".." || rel.startsWith(".." + path.sep) || path.isAbsolute(rel))
     throw new Fault("PATH_ESCAPE", "Path escapes the permitted root.", 2);
+  if (child && rel === "")
+    throw new Fault("PATH_ESCAPE", "Path must be inside, not equal to, the permitted root.", 2);
   let probe = target;
   while (!await exists(probe)) probe = path.dirname(probe);
   const physical = await realpath(probe), physicalRel = path.relative(base, physical);
   if (physicalRel === ".." || physicalRel.startsWith(".." + path.sep) || path.isAbsolute(physicalRel))
     throw new Fault("SYMLINK_ESCAPE", "Symlink escapes the permitted root.", 2);
+  if (child && probe === target && physicalRel === "")
+    throw new Fault("PATH_ESCAPE", "Path must be inside, not equal to, the permitted root.", 2);
   return target;
 }
 async function inventory(root) {
@@ -211,6 +280,36 @@ async function inventory(root) {
   await walk(root);
   return Object.fromEntries(Object.entries(out).sort());
 }
+var LOCK_CORRUPT_AFTER_MS = 3e4;
+async function createLock(file, owner) {
+  const temporary = file + "." + randomUUID2() + ".owner";
+  const handle = await open(temporary, "wx", 384);
+  try {
+    try {
+      await handle.writeFile(owner);
+      await handle.sync();
+    } finally {
+      await handle.close();
+    }
+    try {
+      await link(temporary, file);
+      return;
+    } catch (error) {
+      const code = error.code;
+      if (code === "EEXIST") throw error;
+      if (!["EPERM", "ENOTSUP", "ENOSYS", "EXDEV", "EOPNOTSUPP"].includes(code ?? "")) throw error;
+    }
+    const fallback = await open(file, "wx", 384);
+    try {
+      await fallback.writeFile(owner);
+      await fallback.sync();
+    } finally {
+      await fallback.close();
+    }
+  } finally {
+    await rm(temporary, { force: true });
+  }
+}
 async function withLock(file, action) {
   await mkdir(path.dirname(file), { recursive: true, mode: 448 });
   const recovery = file + ".recovery";
@@ -227,6 +326,20 @@ async function withLock(file, action) {
       owner = await readJson(file);
     } catch {
     }
+    if (!owner || typeof owner !== "object" || !Number.isInteger(owner.pid)) {
+      let age = 0;
+      try {
+        age = Date.now() - (await lstat(file)).mtimeMs;
+      } catch {
+      }
+      if (age > LOCK_CORRUPT_AFTER_MS)
+        throw new Fault(
+          "LOCK_CORRUPT",
+          `Lock file ${file} has no readable owner (an interrupted earlier process left it). Confirm no apexrest operation is running on any host, then delete that file and retry.`,
+          5,
+          "conflict"
+        );
+    }
     if (owner && owner.hostname === hostname() && Number.isInteger(owner.pid) && owner.pid > 0) {
       let dead = false;
       try {
@@ -249,9 +362,11 @@ async function withLock(file, action) {
       }
     }
   }
-  let handle;
   try {
-    handle = await open(file, "wx", 384);
+    await createLock(
+      file,
+      JSON.stringify({ pid: process.pid, hostname: hostname(), createdAt: (/* @__PURE__ */ new Date()).toISOString() })
+    );
   } catch (e) {
     if (e.code === "EEXIST")
       throw new Fault(
@@ -263,13 +378,8 @@ async function withLock(file, action) {
     throw e;
   }
   try {
-    await handle.writeFile(
-      JSON.stringify({ pid: process.pid, hostname: hostname(), createdAt: (/* @__PURE__ */ new Date()).toISOString() })
-    );
-    await handle.sync();
     return await action();
   } finally {
-    await handle.close();
     await rm(file, { force: true });
   }
 }
@@ -289,10 +399,13 @@ export {
   hashFile,
   canonical,
   atomicWrite,
+  syncDirectory,
   writeJson,
   readJson,
   exists,
   contained,
+  containedChild,
   inventory,
+  LOCK_CORRUPT_AFTER_MS,
   withLock
 };

package/dist/runtime/mcp.mjs

@@ -1,14 +1,9 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-import {
-  startMcp
-} from "./chunk-2ZUNLCLK.mjs";
-import "./chunk-TXVQLYTH.mjs";
-import "./chunk-AQZLLQ3D.mjs";
-import "./chunk-BD2AVCFU.mjs";
-import "./chunk-4MYHJ2IU.mjs";
-import "./chunk-S24BD6PY.mjs";
-import "./chunk-3MDDJFXN.mjs";
-import "./chunk-2Z3BZF66.mjs";
 
 // packages/mcp/src/main.ts
+if (Number(process.versions.node.split(".")[0]) < 24) {
+  process.stderr.write("APEXREST requires Node.js 24 or newer.\n");
+  process.exit(3);
+}
+var { startMcp } = await import("./chunk-QKYF6N6U.mjs");
 await startMcp();

package/package.json

@@ -1,24 +1,24 @@
 {
   "name": "apexrest",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "files": [
     "dist/runtime/",
     "dist/resources/",
     "dist/codex-compat/",
     "README.md",
-    "README.uk.md",
     "LICENSE",
     "NOTICE"
   ],
   "publishConfig": {
     "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "tag": "latest"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/apexrest-dev/apexrest-codex.git"
+    "url": "git+https://github.com/apexrest-dev/apexrest.git"
   },
-  "description": "Native Codex plugin for Oracle APEX development, deployment and testing",
+  "description": "Plugin for Codex and Claude Code for Oracle APEX development, deployment and testing",
   "license": "Apache-2.0",
   "type": "module",
   "engines": {
@@ -48,16 +48,23 @@
     "test:installers": "node scripts/test.mjs installers",
     "test:integration": "node scripts/integration.mjs",
     "site:build": "node scripts/build-site.mjs",
-    "release:dry-run": "node scripts/package-release.mjs",
+    "release:dry-run": "node scripts/package-release.mjs --dry-run",
+    "release:package": "node scripts/package-release.mjs",
     "check-release-readiness": "node scripts/check-release-readiness.mjs",
     "plugin:sync": "npm run build && node scripts/sync-repository-plugin.mjs",
     "plugin:check": "node scripts/sync-repository-plugin.mjs --check",
     "test:repository-plugin": "node scripts/repository-plugin-smoke.mjs",
-    "docs:check": "node scripts/check-docs.mjs"
+    "docs:check": "node scripts/check-docs.mjs",
+    "composer:catalog": "node scripts/build-composer-catalog.mjs",
+    "composer:check": "node scripts/build-composer-catalog.mjs --check",
+    "composer:verify": "node scripts/verify-composer.mjs",
+    "composer:author": "node scripts/composer-author.mjs",
+    "composer:benchmark": "node scripts/benchmark-composer.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
     "tar": "7.5.22",
+    "yaml": "2.9.1",
     "yauzl": "3.4.0",
     "zod": "4.6.2"
   },

package/README.uk.md

@@ -1,206 +0,0 @@
-# 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)
-
-> **Випуск `1.2.0`.** Працюйте безпосередньо в поточній сесії Codex з 18 MCP-інструментами та 13 спеціалізованими skills. Codex керує розмовою й виконанням; APEXREST виконує операції Oracle/APEX. Програмне очікування завдань, пакетні метадані, стисла перевірка проєкту й цільова довідка скорочують рутинні виклики. Зміни й межі доказів — у [примітках до випуску](docs/release-notes.uk.md). Незалежні інструменти; це не офіційний продукт Oracle чи OpenAI.
-
-Опишіть зміну в чаті Codex або використовуйте `$apexrest-work`. Реалізація починається в тому самому контексті без виклику запуску плагіна. Дивіться [сценарій чату](docs/chat-workflow.uk.md) та [інтеграцію Codex](docs/codex-integration.uk.md). Для перевірки APEX оберіть **Codex in-app browser / External system browser** у Settings.
-
-**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` для налаштувань проєкту й з’єднань, фактичних завдань Oracle/APEX і діагностики в Codex. Консольне подання — `apexrest panel tui`. Дивіться [панель розробки](docs/panel.uk.md).
-
-[Каталог компонентів](docs/component-catalog.uk.md) дає офлайн-пошук серед 109 сімейств, параметри з контекстом і 138 перевірених компілятором рецептів APEXlang; один непідтриманий рецепт має явний статус unresolved. [Список компонентів і приклади](https://apex.oracle.com/ut) доступні онлайн. Використовуйте наявні довідкові інструменти або CLI з `--corpus components`; докази компіляції, SQL, імпорту й браузерної перевірки розділено.
-
-Випуск 1.2.0 додає окремий офлайн-[каталог патернів](docs/pattern-catalog.uk.md): 58 готових UX-патернів і 84 рецепти, з яких 69 перевірено компілятором, а 15 мають явні прогалини. Огляд охоплює 150 сторінок джерел і 818 рішень щодо варіантів. Шукайте через `--corpus patterns`; використовуйте новий skill `$apexrest-pattern-catalog`, щоб додати перевірені патерни з іншого застосунку APEX. Готовність за компілятором не означає перевірку SQL, імпорту чи браузера.
-
-## 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.
-
-[Посібник Cloud](docs/codex-cloud.uk.md) описує CLI + ORDS у налаштованому контейнері. Він не підтверджує нативне виявлення плагіна/MCP чи підтримку панелі у Cloud. Локальні й підключені докази зберігають свої версії та межі.
-
-## Встановлення з npm
-
-Використовуйте Node 24 LTS (підтримуваний діапазон: Node 24–26). Встановіть [apexrest](https://www.npmjs.com/package/apexrest) з npm. Версія цього пакета — `1.2.0`; наведені нижче команди використовують `latest`. Стан розповсюдження й перевірок — у [примітках до випуску](docs/release-notes.uk.md).
-
-Встановіть CLI глобально та перевірте версію:
-
-```sh
-npm install -g apexrest
-apexrest --version
-apexrest
-```
-
-Остання команда відкриває термінальне меню. Виберіть **Install tools** для відсутніх залежностей, потім **Install plugin**, щоб зареєструвати APEXREST у Codex. npm встановлює CLI й комплектні ресурси; реєстрація плагіна є окремою дією меню.
-
-Для локального встановлення в проєкті:
-
-```sh
-npm install apexrest
-npx apexrest --version
-npx apexrest
-```
-
-Щоб зафіксувати цю версію, використовуйте `npm install -g apexrest@1.2.0`. npm містить готове середовище виконання, тому копія Git-репозиторію чи локальне збирання не потрібні. Наведене нижче встановлення з репозиторію також доступне.
-
-## Встановлення через термінал
-
-Маючи 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, щоб перенести наявний застосунок із налаштованого тестового середовища в новий проєкт. Додай дашборд продажів із реальними показниками бази даних. Збережи наявні сторінки, спільні компоненти й автентифікацію, потім імпортуй і перевір зміну.
-
-**Внести наступну зміну**
-
-> Онови фільтри дашборда так, щоб вони оновлювали відповідні нативні регіони. Використай наявний проєкт і з’єднання, звір показники, імпортуй у той самий тестовий застосунок і перевір взаємодії у вбудованому браузері.
-
-Замініть приклади 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/plugins/apexrest-apex/resources/panel/index.html

@@ -1,61 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-  <title>APEXREST · Development panel</title>
-  <link rel="stylesheet" href="/panel.css">
-  <script src="/panel.js" defer></script>
-</head>
-<body>
-  <aside class="sidebar">
-    <div class="brand"><span class="brand-mark" aria-hidden="true">⌘</span><div>APEXREST<small>CODEX WORKSPACE</small></div></div>
-    <div class="project-label">PROJECT</div><strong id="project-name">Connecting…</strong><div id="project-path" class="subtle path"></div>
-    <nav aria-label="Development views">
-      <button data-view="overview" aria-current="page"><span>◈</span> Overview</button>
-      <button data-view="operations"><span>↗</span> APEX operations</button>
-      <button data-view="settings"><span>☷</span> Settings</button>
-    </nav>
-    <div class="sidebar-bottom"><span id="connection" class="badge">Connecting</span><p id="updated" class="subtle">Waiting for workspace data</p><button id="refresh" class="quiet">Refresh now</button></div>
-  </aside>
-  <main>
-    <header><div><p class="eyebrow">DEVELOPMENT CONTROL</p><h1 id="view-title">Workspace overview</h1><p id="view-subtitle" class="subtle">Project settings and APEX operations for your current Codex session.</p></div></header>
-    <div id="notice" role="status" class="notice" hidden></div>
-    <div id="connection-error" role="alert" class="notice error" hidden></div>
-    <section id="metrics" class="metrics" aria-label="Workspace summary"></section>
-    <section data-page="overview"><div id="overview-live"></div></section>
-    <section data-page="operations" hidden>
-      <div class="card"><div class="section-heading"><div><h2>Run a check</h2><p class="subtle">Use the selected project's existing toolchain and authorization.</p></div></div><div class="actions"><button id="validate">Compile APEX source</button><label>Environment<select id="environment"><option value="">Choose environment</option></select></label><label>Test suite<select id="suite"><option value="unit">Unit</option><option value="sql">SQL</option><option value="api">API</option><option value="e2e">Playwright E2E</option><option value="all">All configured</option></select></label><button id="run-tests">Run checks</button><button id="plan">Prepare deployment plan</button><button id="open-browser">Open verification browser</button></div><p class="subtle">Application imports keep their existing plan, backup and approval gates. This panel does not grant deployment permission.</p></div>
-      <div id="operations-live"></div>
-    </section>
-    <section data-page="settings" hidden>
-      <div class="two-columns">
-        <form id="sqlcl-form" class="card"><p class="eyebrow">ORACLE CONNECTION</p><h2>Database connectivity</h2><p class="subtle">Saved at plugin level for new APEXREST operations across projects.</p><label>Database network transport<select id="sqlcl-transport"><option value="direct">Direct Oracle listener</option><option value="ords">ORDS HTTP(S)</option></select></label><p id="sqlcl-transport-note" class="subtle"></p><label>SQLcl execution<select id="sqlcl-mode"><option value="cli">SQLcl CLI</option><option value="mcp">Official SQLcl MCP</option></select></label><label>MCP restriction level<select id="sqlcl-level"><option value="4">Level 4 · restricted (default)</option><option value="1">Level 1 · allow SQLcl scripts</option></select></label><button type="submit">Save SQLcl settings</button></form>
-        <form id="preferences-form" class="card"><p class="eyebrow">BROWSER VERIFICATION</p><h2>Verification browser</h2><label>Browser for APEX verification<select id="default-browser-mode"><option value="codex">Codex in-app browser</option><option value="external">External system browser</option></select></label><p class="subtle">The external browser uses your normal browser session for interactive login, including SSO. Automated Playwright suites use separate authentication. The dashboard stays in Codex.</p><button type="submit">Save browser preference</button></form>
-      </div>
-      <form id="connection-form" class="card" autocomplete="off">
-        <p class="eyebrow">PLUGIN CONNECTION SETTINGS</p><h2>Connection references</h2>
-        <p class="subtle">Choose a project's read or deploy connection reference. Its connection settings are shared across projects using that reference.</p>
-        <label>Connection reference<input id="connection-ref" list="connection-refs" maxlength="100" required placeholder="Your read or deploy connection reference"></label><datalist id="connection-refs"></datalist>
-        <p id="connection-mode-note" class="subtle"></p>
-        <fieldset id="connection-direct-group" class="connection-group">
-          <legend>Direct Oracle listener</legend>
-          <p class="subtle">Choose a connection from your local SQLcl connection store. SQLcl manages its database credentials.</p>
-          <div class="connection-picker"><label>Saved SQLcl connection<select id="connection-direct"><option value="">Choose a saved connection</option></select></label><button id="saved-connections-refresh" type="button" class="quiet">Load saved connections</button></div>
-          <p id="saved-connections-status" class="subtle" role="status" aria-live="polite" data-state="idle">Saved connections load when you open Direct connection settings.</p>
-          <details><summary>Manage saved connections</summary><p class="subtle">Save a direct database connection in SQLcl, then refresh this list. Selecting a name here maps it to the connection reference above.</p><pre>connmgr list -flat</pre></details>
-        </fieldset>
-        <fieldset id="connection-ords-group" class="connection-group" hidden disabled>
-          <legend>ORDS HTTP(S)</legend>
-          <p class="subtle">Use your existing Oracle database username and password through ORDS. No separate ORDS account is needed. The schema must be REST-enabled and permit REST-enabled SQL.</p>
-          <label>ORDS schema URL<input id="connection-ords-url" type="url" maxlength="2048" placeholder="https://example.com/ords/schema-alias/"></label><p class="subtle">Use the schema URL provided by your administrator. Its schema alias can differ from your database username.</p>
-          <div class="two-columns"><label>Database username<input id="connection-ords-user" maxlength="128" autocomplete="off" placeholder="Your Oracle database username"></label><label>Database password<input id="connection-ords-password" type="password" autocomplete="new-password"></label></div><p id="connection-password-note" class="subtle">Leave the password blank to keep it for the same URL and database username. A changed URL or username requires a password.</p>
-          <p class="subtle connection-storage-note">SQLcl cannot save ORDS connections. APEXREST stores these settings and the database password locally at plugin level.</p>
-          <details><summary>Configure ORDS from the CLI</summary><p class="subtle">Provide your database password through a local file:</p><pre>apexrest connection add --name REF --ords-url https://example.com/ords/schema-alias/ --ords-username DATABASE_USER --password-file PATH</pre><p class="subtle">Interactive SQLcl example:</p><pre>connect -orest DATABASE_USER@https://example.com/ords/schema-alias/</pre></details>
-        </fieldset>
-        <button id="connection-save" type="submit">Save direct connection</button>
-      </form><div id="settings-live"></div>
-    </section>
-    <footer>APEXREST for Codex <span id="version"></span><span>Local workspace · Refreshes while open</span></footer>
-  </main>
-</body>
-</html>