[ADD] demo verification script and update project configuration

Author: Dmi3yy

DOCS.md

@@ -32,8 +32,7 @@ Implementation order is mandatory:
 - Gate A: web transport + manager route + manager ACL (`emcp`) + `initialize` + `tools/list` + `GET=405`
 - Gate B: API access layer (scope engine, basic rate limit, `sApi` provider)
 - Gate C: async (`sTask` worker, payload contract, failover, idempotency)
-- Gate D: optional Passport compatibility
-- Gate E: security hardening + DX commands
+- Gate D: security hardening + DX commands
 
 Minimal first release is Gate A only.
 
@@ -81,11 +80,8 @@ Mandatory:
 - Evolution CMS 3.5.2+
 - PHP 8.4+
 - Composer 2.2+
-
-Optional:
-- `seiger/sapi` for external API access
-- `seiger/stask` for async execution
-- `laravel/passport` for OAuth-compatible mode
+- `seiger/sapi` 1.x
+- `seiger/stask` 1.x
 
 ## 4) Install
 From Evo `core` directory:
@@ -375,12 +371,10 @@ Rules:
 ## 9) Auth Modes
 Supported modes:
 - `sapi_jwt` (default): uses `sApi` JWT middleware attributes
-- `passport` (optional): OAuth-compatible mode (`mcp:use`)
 - `none` (restricted/internal scenarios only)
 
 Behavior contract:
-- Passport mode is optional and must degrade safely if Passport is absent.
-- Missing optional auth dependencies must not break package boot.
+- Missing auth configuration must not break package boot.
 
 ## 10) Routes and Transports
 

DOCS.uk.md

@@ -32,8 +32,7 @@ Status marker:
 - Gate A: web transport + manager route + manager ACL (`emcp`) + `initialize` + `tools/list` + `GET=405`
 - Gate B: API access layer (scope engine, basic rate limit, `sApi` provider)
 - Gate C: async (`sTask` worker, payload contract, failover, idempotency)
-- Gate D: optional Passport compatibility
-- Gate E: security hardening + DX commands
+- Gate D: security hardening + DX commands
 
 Перший реліз — тільки Gate A.
 
@@ -81,11 +80,8 @@ php artisan make:mcp-tool HealthTool
 - Evolution CMS 3.5.2+
 - PHP 8.4+
 - Composer 2.2+
-
-Опційно:
-- `seiger/sapi` для зовнішнього API доступу
-- `seiger/stask` для async виконання
-- `laravel/passport` для OAuth-compatible режиму
+- `seiger/sapi` 1.x
+- `seiger/stask` 1.x
 
 ## 4) Встановлення
 З директорії `core` Evo:
@@ -375,12 +371,10 @@ Default allowlist моделей:
 ## 9) Режими аутентифікації
 Підтримувані режими:
 - `sapi_jwt` (default): використовує JWT атрибути `sApi`
-- `passport` (optional): OAuth-compatible режим (`mcp:use`)
 - `none` (лише для обмежених внутрішніх сценаріїв)
 
 Контракт:
-- Passport режим опційний і має безпечно деградувати, якщо Passport не встановлено
-- відсутність optional залежностей не повинна ламати boot пакета
+- відсутність auth-конфігурації не повинна ламати boot пакета
 
 ## 10) Routes і transports
 

Makefile

@@ -1,4 +1,4 @@
-.PHONY: check test demo demo-seed demo-clean
+.PHONY: check test demo demo-seed demo-clean demo-verify demo-all
 
 check:
 	composer run check
@@ -8,7 +8,14 @@ test:
 
 DEMO_DIR ?= demo
 DEMO_CORE_DIR := $(DEMO_DIR)/core
-DEMO_CUSTOM_DIR := $(DEMO_CORE_DIR)/custom
+DEMO_HOST ?= 127.0.0.1
+DEMO_PORT ?= 8787
+DEMO_BASE_URL ?= http://$(DEMO_HOST):$(DEMO_PORT)
+DEMO_SERVER_HANDLE ?= content
+DEMO_DISPATCH_CHECK ?= 1
+DEMO_JWT_SECRET ?= emcp-demo-secret
+SAPI_BASE_PATH ?= api
+SAPI_VERSION ?= v1
 
 EVO_BIN ?= evo
 EVO_BRANCH ?= 3.5.x
@@ -20,7 +27,7 @@ EVO_ADMIN_PASSWORD ?= 123456
 EVO_ADMIN_DIRECTORY ?= manager
 EVO_LANGUAGE ?= uk
 EMCP_CONSTRAINT ?= *@dev
-EMCP_PATH_REPO ?= ../../../
+EMCP_PATH_REPO ?= $(CURDIR)
 
 demo:
 	@set -eu; \
@@ -43,17 +50,23 @@ demo:
 		--admin-directory="$(EVO_ADMIN_DIRECTORY)" \
 		--language="$(EVO_LANGUAGE)" \
 		--composer-clear-cache; \
-	cd "$(DEMO_CUSTOM_DIR)"; \
+	cd "$(DEMO_CORE_DIR)"; \
+	composer config repositories.stask '{"type":"vcs","url":"https://github.com/Seiger/sTask"}'; \
+	composer config repositories.sapi '{"type":"vcs","url":"https://github.com/Seiger/sApi"}'; \
 	composer config repositories.emcp '{"type":"path","url":"$(EMCP_PATH_REPO)","options":{"symlink":true}}'; \
-	cd ..; \
 	php artisan package:installrequire evolution-cms/emcp "$(EMCP_CONSTRAINT)"; \
 	php artisan vendor:publish --provider="EvolutionCMS\\eMCP\\eMCPServiceProvider" --tag=emcp-config --force; \
 	php artisan vendor:publish --provider="EvolutionCMS\\eMCP\\eMCPServiceProvider" --tag=emcp-mcp-config --force; \
 	php artisan vendor:publish --provider="EvolutionCMS\\eMCP\\eMCPServiceProvider" --tag=emcp-stubs --force; \
 	php artisan migrate --force; \
-	php artisan db:seed --force; \
+	if php -r "require 'vendor/autoload.php'; exit(class_exists('DatabaseSeeder') ? 0 : 1);" >/dev/null 2>&1; then \
+		php artisan db:seed --force; \
+	else \
+		echo "Skipping db:seed: DatabaseSeeder is not defined in this EVO install."; \
+	fi; \
 	php artisan cache:clear-full; \
-	echo "Demo environment is ready in '$(DEMO_DIR)'."
+	echo "Demo environment is ready in '$(DEMO_DIR)'."; \
+	echo "Run 'make demo-verify' to start php -S and run all tests automatically."
 
 demo-seed:
 	@set -eu; \
@@ -62,9 +75,35 @@ demo-seed:
 		exit 1; \
 	}; \
 	cd "$(DEMO_CORE_DIR)"; \
-	php artisan db:seed --force; \
+	if php -r "require 'vendor/autoload.php'; exit(class_exists('DatabaseSeeder') ? 0 : 1);" >/dev/null 2>&1; then \
+		php artisan db:seed --force; \
+	else \
+		echo "Skipping db:seed: DatabaseSeeder is not defined in this EVO install."; \
+	fi; \
 	php artisan cache:clear-full
 
 demo-clean:
 	@set -eu; \
 	rm -rf "$(DEMO_DIR)"
+
+demo-verify:
+	@set -eu; \
+	test -f "$(DEMO_CORE_DIR)/artisan" || { \
+		echo "Error: demo is not installed. Run 'make demo' first."; \
+		exit 1; \
+	}; \
+	DEMO_DIR="$(DEMO_DIR)" \
+	DEMO_CORE_DIR="$(DEMO_CORE_DIR)" \
+	DEMO_HOST="$(DEMO_HOST)" \
+	DEMO_PORT="$(DEMO_PORT)" \
+	DEMO_BASE_URL="$(DEMO_BASE_URL)" \
+	DEMO_ADMIN_USERNAME="$(EVO_ADMIN_USERNAME)" \
+	DEMO_ADMIN_PASSWORD="$(EVO_ADMIN_PASSWORD)" \
+	EMCP_SERVER_HANDLE="$(DEMO_SERVER_HANDLE)" \
+	EMCP_DISPATCH_CHECK="$(DEMO_DISPATCH_CHECK)" \
+	SAPI_JWT_SECRET="$(DEMO_JWT_SECRET)" \
+	SAPI_BASE_PATH="$(SAPI_BASE_PATH)" \
+	SAPI_VERSION="$(SAPI_VERSION)" \
+	sh scripts/demo_verify.sh
+
+demo-all: demo demo-verify

README.md

@@ -34,11 +34,8 @@ Operations runbook: `OPERATIONS.md`.
 - Evolution CMS 3.5.2+
 - PHP 8.4+
 - Composer 2.2+
-
-Optional:
-- `seiger/sapi` for external MCP API access
-- `seiger/stask` for async MCP dispatch
-- `laravel/passport` for OAuth-compatible mode
+- `seiger/sapi` 1.x (installed as dependency)
+- `seiger/stask` 1.x (installed as dependency)
 
 ## Install
 From your Evo `core` directory:
@@ -184,7 +181,6 @@ Notes:
 ## Access Model
 - Manager/internal access: Evo permission `emcp`
 - API access (via sApi): JWT scopes (`mcp:read`, `mcp:call`, `mcp:admin`)
-- Optional Passport mode: `mcp:use` compatibility when Passport is installed
 - Domain reads (`evo.content.*`, `evo.model.*`) are read-only by default
 
 ## Ecosystem Interop
@@ -234,6 +230,14 @@ composer run ci:check
 
 These checks validate `composer.json` and run PHP syntax lint across package sources.
 
+One-click demo + full MCP verification:
+
+```bash
+make demo-all
+```
+
+This target installs demo Evo, starts `php -S`, issues sApi JWT, runs `php artisan emcp:test`, then runs `composer run test` with HTTP runtime integration enabled.
+
 Optional runtime integration check (against deployed environment):
 
 ```bash

README.uk.md

@@ -34,11 +34,8 @@ Versioning і BC policy: `PRD.md` (розділ `API Stability Policy`).
 - Evolution CMS 3.5.2+
 - PHP 8.4+
 - Composer 2.2+
-
-Опційно:
-- `seiger/sapi` для зовнішнього MCP API
-- `seiger/stask` для async dispatch
-- `laravel/passport` для OAuth-compatible режиму
+- `seiger/sapi` 1.x (встановлюється як залежність)
+- `seiger/stask` 1.x (встановлюється як залежність)
 
 ## Встановлення
 З директорії `core` вашого Evo:
@@ -183,7 +180,6 @@ return [
 ## Модель доступу
 - Внутрішній доступ (manager): permission `emcp`
 - API доступ (через sApi): JWT scopes (`mcp:read`, `mcp:call`, `mcp:admin`)
-- Optional Passport mode: сумісність з `mcp:use`, якщо Passport встановлено
 - Domain read tools (`evo.content.*`, `evo.model.*`) за замовчуванням read-only
 
 ## Взаємодія В Екосистемі
@@ -233,6 +229,14 @@ composer run ci:check
 
 Ці перевірки валідовують `composer.json` і виконують PHP syntax lint по всіх файлах пакета.
 
+One-click демо + повна MCP перевірка:
+
+```bash
+make demo-all
+```
+
+Ця ціль встановлює demo Evo, запускає `php -S`, видає sApi JWT, виконує `php artisan emcp:test`, а потім `composer run test` з увімкненою HTTP runtime integration перевіркою.
+
 Опційна runtime integration перевірка (проти розгорнутого середовища):
 
 ```bash

composer.json

@@ -13,12 +13,9 @@
   "require": {
     "php": "^8.4",
     "evolution-cms/evolution": "^3.5.2",
-    "laravel/mcp": "^0.5"
-  },
-  "suggest": {
-    "seiger/sapi": "Required for external API mode and scope middleware integration",
-    "seiger/stask": "Required for async dispatch worker integration",
-    "laravel/passport": "Optional OAuth-compatible mode"
+    "laravel/mcp": "^0.5",
+    "seiger/sapi": "^1.0",
+    "seiger/stask": "^1.0"
   },
   "autoload": {
     "psr-4": {