@cicore/cli 1.0.0

package/dist/commands/addon/create.js

@@ -0,0 +1,1186 @@
+/**
+ * vu addon create <name>
+ *
+ * ciCore HelloWorld şablonundan doğrulanmış pattern'lerle
+ * sıfırdan çalışır addon iskeleti oluşturur.
+ *
+ * Kullanım:
+ *   vu addon create HesapMakinasi
+ */
+import { log, spinner } from '../../lib/logger.js';
+import { paths } from '../../lib/config.js';
+import { findShellRoot } from '../../lib/ops/addon-dev.js';
+import { genEslintConfig, genPrettierConfig, genEditorConfig, genTsConfig, genGitlabCi, genAmbientTypes, } from '../../lib/ops/addon-quality.js';
+import fs from 'fs-extra';
+import path from 'path';
+// ─── İsim türetme yardımcıları ────────────────────────────────────────────────
+/** HesapMakinasi → hesap-makinasi */
+function toKebab(name) {
+    return name
+        .replace(/([A-Z])/g, '-$1')
+        .toLowerCase()
+        .replace(/^-/, '');
+}
+/** HesapMakinasi → hesapMakinasi */
+function toCamel(name) {
+    return name.charAt(0).toLowerCase() + name.slice(1);
+}
+/**
+ * HesapMakinasi → hm  (her PascalCase kelimenin ilk harfi, max 4 karakter)
+ * HelloWorld → hw | ProductManager → pm | AdminMenuManager → amm
+ */
+function toPrefix(name) {
+    const words = name.match(/[A-Z][a-z0-9]*/g) ?? [name];
+    return words
+        .map(w => w[0].toLowerCase())
+        .join('')
+        .slice(0, 4);
+}
+/** HesapMakinasi → Hesap Makinasi */
+function toDisplay(name) {
+    const words = name.match(/[A-Z][a-z0-9]*/g) ?? [name];
+    return words.join(' ');
+}
+// ─── Ana fonksiyon ────────────────────────────────────────────────────────────
+export async function createAddon(name) {
+    log.title(`ciCore Addon Oluşturucu: ${name}`);
+    // 1. İsim doğrulama (PascalCase zorunlu)
+    if (!/^[A-Z][a-zA-Z0-9]+$/.test(name)) {
+        log.error('Addon adı PascalCase olmalı. Örnek: HesapMakinasi, NotePad, TaskFlow');
+        process.exit(1);
+    }
+    // Pick the right addons dir for the layout we're in.
+    //   - dev-shell (personnel laptop): cores/dev/addons/<Name>
+    //   - monorepo (Mustafa): addons/<Name> (paths.dev.addons default)
+    // Auto-detect dev-shell by walking up from cwd; fall back to the
+    // monorepo-style path when we're not inside dev-shell.
+    const shellRoot = findShellRoot(process.cwd());
+    const addonsRoot = shellRoot ? path.join(shellRoot, 'cores', 'dev', 'addons') : paths.dev.addons;
+    const addonPath = path.join(addonsRoot, name);
+    // 2. Mevcut addon kontrolü
+    if (await fs.pathExists(addonPath)) {
+        log.error(`"${name}" addon'u zaten mevcut: ${addonPath}`);
+        process.exit(1);
+    }
+    // 3. Değerleri türet
+    const slug = toKebab(name); // hesap-makinasi
+    const camel = toCamel(name); // hesapMakinasi
+    const prefix = toPrefix(name); // hm
+    const display = toDisplay(name); // Hesap Makinasi
+    log.blank();
+    log.kv('Klasör adı', name);
+    log.kv('URL slug', slug);
+    log.kv('i18n namespace', camel);
+    log.kv('Tablo prefix', prefix);
+    log.kv('Görünen isim', display);
+    log.blank();
+    // 4. Dosyaları oluştur
+    const s = spinner('Addon iskelet dosyaları oluşturuluyor...').start();
+    try {
+        // Klasörler
+        await fs.ensureDir(path.join(addonPath, 'Backend', 'Controllers'));
+        await fs.ensureDir(path.join(addonPath, 'Backend', 'Services'));
+        await fs.ensureDir(path.join(addonPath, 'Backend', 'Routes'));
+        await fs.ensureDir(path.join(addonPath, 'Backend', 'Migrations'));
+        await fs.ensureDir(path.join(addonPath, 'pages', 'admin'));
+        await fs.ensureDir(path.join(addonPath, 'pages', 'web'));
+        await fs.ensureDir(path.join(addonPath, 'components'));
+        await fs.ensureDir(path.join(addonPath, 'composables'));
+        await fs.ensureDir(path.join(addonPath, 'locales'));
+        await fs.ensureDir(path.join(addonPath, 'ui'));
+        await fs.ensureDir(path.join(addonPath, 'Assets', 'img'));
+        // Dosyalar
+        await write(addonPath, 'addon.json', genAddonJson(name, slug, camel, prefix, display));
+        await write(addonPath, 'package.json', genPackageJson(name));
+        await write(addonPath, '.signature', '');
+        await write(addonPath, 'empty-devtools.js', genEmptyDevtools());
+        await write(addonPath, 'vite.config.js', genViteConfig(name));
+        await write(addonPath, 'Backend/Routes/routes.php', genRoutes(name, slug));
+        await write(addonPath, `Backend/Controllers/${name}Controller.php`, genController(name, slug));
+        await write(addonPath, `Backend/Services/${name}Service.php`, genService(name, prefix));
+        await write(addonPath, `Backend/Migrations/001_Create${prefix.toUpperCase()}Table.php`, genMigration(name, prefix));
+        await write(addonPath, 'pages/admin/index.vue', genAdminPage(name, slug, camel));
+        await write(addonPath, 'pages/web/index.vue', genWebPage(name, slug, camel));
+        await write(addonPath, 'ui/entry.ts', genEntryTs(name));
+        await write(addonPath, 'ui/style.css', genStyleCss(name));
+        await write(addonPath, 'locales/en.json', genLocaleEn(camel, display));
+        await write(addonPath, 'locales/tr.json', genLocaleTr(camel, display));
+        // Faz 5 quality template — every new addon ships with lint + format
+        // + typecheck config out of the box. Tooling lives in dev-shell's
+        // top-level node_modules; the configs here just point the addon's
+        // file types at the shared toolchain.
+        await write(addonPath, '.eslintrc.json', genEslintConfig());
+        await write(addonPath, '.prettierrc.json', genPrettierConfig());
+        await write(addonPath, '.editorconfig', genEditorConfig());
+        await write(addonPath, 'tsconfig.json', genTsConfig());
+        await write(addonPath, '.gitlab-ci.yml', genGitlabCi(name));
+        // Ambient type declarations so vue-tsc doesn't choke on the
+        // platform-provided globals (`$fetch` from Nuxt, `@cicore/shared`
+        // imports resolved at runtime via the import map).
+        await write(addonPath, 'env.d.ts', genAmbientTypes());
+        await write(addonPath, '.gitignore', genGitignore());
+        s.succeed('Tüm dosyalar oluşturuldu');
+    }
+    catch (err) {
+        s.fail('Dosya oluşturma hatası');
+        log.error(err.message);
+        await fs.remove(addonPath).catch(() => { });
+        process.exit(1);
+    }
+    // 5. Özet
+    log.blank();
+    log.success(`"${name}" addon'u başarıyla oluşturuldu!`);
+    log.blank();
+    log.info('Oluşturulan dosyalar:');
+    log.item(`addons/${name}/addon.json`);
+    log.item(`addons/${name}/Backend/Routes/routes.php`);
+    log.item(`addons/${name}/Backend/Controllers/${name}Controller.php`);
+    log.item(`addons/${name}/Backend/Services/${name}Service.php`);
+    log.item(`addons/${name}/Backend/Migrations/001_Create${prefix.toUpperCase()}Table.php`);
+    log.item(`addons/${name}/pages/admin/index.vue`);
+    log.item(`addons/${name}/pages/web/index.vue`);
+    log.item(`addons/${name}/ui/entry.ts`);
+    log.item(`addons/${name}/locales/en.json  +  tr.json`);
+    log.blank();
+    log.info('Sonraki adımlar:');
+    log.item(`1. addons/${name}/addon.json → icon ve menü sırasını düzenle`);
+    log.item(`2. Backend/Services/${name}Service.php → iş mantığını yaz`);
+    log.item(`3. pages/admin/index.vue → UI'ı geliştir`);
+    log.item(`4. ci addon dev ${name} → vite HMR session (Faz 2A)`);
+    log.item(`5. http://localhost:3080/admin/${slug} adresini aç`);
+    log.blank();
+    log.info('Quality stack (kendi devDeps — npm ci, sonra):');
+    log.item(`Lint:      npm run lint`);
+    log.item(`Typecheck: npm run typecheck`);
+    log.item(`Build:     npm run build`);
+    log.item(`(\`ci addon deploy --core <X>\` runs lint + typecheck before upload)`);
+    log.blank();
+    log.info('Git başlatmak için (S4-T23):');
+    log.item(`cd ${addonPath} && git init && git add . && git commit -m "init: ${name} addon scaffold"`);
+}
+// ─── Yardımcı: dosya yaz ──────────────────────────────────────────────────────
+async function write(base, rel, content) {
+    const fullPath = path.join(base, rel);
+    await fs.ensureDir(path.dirname(fullPath));
+    if (typeof content === 'object') {
+        await fs.writeJson(fullPath, content, { spaces: 2 });
+    }
+    else {
+        await fs.writeFile(fullPath, content, 'utf8');
+    }
+}
+// ─── Şablon üreticiler ────────────────────────────────────────────────────────
+function genAddonJson(name, slug, camel, prefix, display) {
+    // `name` MUST be a string matching the addon directory — `ci addon deploy`
+    // and the install-addon.sh receiver both validate the directory ↔ name
+    // pair against /^[A-Za-z0-9_-]+$/. The i18n display name lives in
+    // `display_name` and the menu title, so multilingual surfaces still
+    // render in Turkish/English without breaking the deploy pipeline.
+    return {
+        name,
+        display_name: { en: display, tr: display },
+        version: '1.0.0',
+        // Plain-string description matches the install-addon.sh receiver's
+        // schema (it grep's a single-line summary for the audit log).
+        // Multilingual descriptions live in `display_name` and any per-page
+        // i18n the addon ships in locales/*.json.
+        description: `${display} addon for ciCore`,
+        author: 'ciCore Team',
+        enabled: true,
+        admin: {
+            enabled: true,
+            locales: true,
+            route_prefix: `/admin/${slug}`,
+            menu: {
+                title: display,
+                title_i18n: { en: display, tr: display },
+                icon: 'i-lucide-puzzle',
+                order: 50,
+                to: `/admin/${slug}`,
+            },
+        },
+        web: {
+            enabled: true,
+            locales: true,
+            route_prefix: `/dashboard/${slug}`,
+            menu: {
+                title: display,
+                title_i18n: { en: display, tr: display },
+                icon: 'i-lucide-puzzle',
+                order: 50,
+                to: `/dashboard/${slug}`,
+            },
+        },
+        backend: {
+            enabled: true,
+            route_prefix: `/api/${slug}`,
+            namespace: `VuCore\\Addons\\${name}`,
+            routes_file: 'Backend/Routes/routes.php',
+            migrations_dir: 'Backend/Migrations',
+            table_prefix: prefix,
+        },
+        i18n: { namespace: camel },
+        is_system: false,
+        licensing: { model: 'free' },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genPackageJson(name) {
+    return JSON.stringify({
+        name: `@cicore-addon/${name.toLowerCase()}`,
+        version: '1.0.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            build: 'vite build',
+            lint: 'eslint . --max-warnings 0',
+            typecheck: 'vue-tsc --noEmit',
+        },
+        devDependencies: {
+            vite: '^7.1.9',
+            '@vitejs/plugin-vue': '^6.0.1',
+            vue: '^3.5.22',
+            'vue-tsc': '^2.1.10',
+            typescript: '^5.7.2',
+            '@typescript-eslint/eslint-plugin': '^7.18.0',
+            '@typescript-eslint/parser': '^7.18.0',
+            eslint: '^8.57.1',
+            'eslint-plugin-vue': '^9.31.0',
+            'vue-eslint-parser': '^9.4.3',
+        },
+    }, null, 2) + '\n';
+}
+function genGitignore() {
+    return `node_modules/
+dist/
+*.local
+.DS_Store
+*.log
+`;
+}
+function genEmptyDevtools() {
+    return `// Stub for @vue/devtools-api — not needed in production ESM bundles
+export const setupDevtoolsPlugin = () => {};
+export default { setupDevtoolsPlugin: () => {} };
+`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genRoutes(name, slug) {
+    // PHP değişkenlerini ($app, $group vs.) template literal interpolasyon olarak
+    // algılamaması için satırları birleştirerek string oluşturuyoruz.
+    const lines = [
+        '<?php',
+        `/**`,
+        ` * ${name} Routes`,
+        ` *`,
+        ` * KRİTİK: addon.json backend.route_prefix otomatik uygulanmaz!`,
+        ` * AddonLoader: $routeHandler($app)  — prefix eklenmez, tam path yaz.`,
+        ` */`,
+        ``,
+        `use Slim\\App;`,
+        `use Slim\\Routing\\RouteCollectorProxy;`,
+        `use VuCore\\Addons\\${name}\\Controllers\\${name}Controller;`,
+        `use VuCore\\Core\\Middleware\\DualAuthMiddleware;`,
+        ``,
+        `return function (App $app) {`,
+        `    $controller = new ${name}Controller();`,
+        `    $auth = new DualAuthMiddleware('${name}');`,
+        ``,
+        `    // Admin API — JWT veya API Key ile korumalı`,
+        `    $app->group('/api/${slug}', function (RouteCollectorProxy $group) use ($controller) {`,
+        `        $group->get('/ping',         [$controller, 'ping']);`,
+        `        $group->get('/items',        [$controller, 'index']);`,
+        `        $group->get('/items/{id}',   [$controller, 'show']);`,
+        `        $group->post('/items',       [$controller, 'store']);`,
+        `        $group->patch('/items/{id}', [$controller, 'update']);`,
+        `        $group->delete('/items/{id}',[$controller, 'destroy']);`,
+        `    })->add($auth);`,
+        ``,
+        `    // Public Web API — auth gerektirmez`,
+        `    $app->group('/api/${slug}/web', function (RouteCollectorProxy $group) use ($controller) {`,
+        `        $group->get('/message', [$controller, 'publicMessage'])`,
+        `            ->setArgument('__public', 'true');`,
+        `    });`,
+        `};`,
+        ``,
+    ];
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genController(name, slug) {
+    const lines = [
+        `<?php`,
+        `declare(strict_types=1);`,
+        ``,
+        `namespace VuCore\\Addons\\${name}\\Controllers;`,
+        ``,
+        `use Psr\\Http\\Message\\ResponseInterface as Response;`,
+        `use Psr\\Http\\Message\\ServerRequestInterface as Request;`,
+        `use VuCore\\Core\\Controllers\\BaseController;`,
+        `use VuCore\\Addons\\${name}\\Services\\${name}Service;`,
+        ``,
+        `class ${name}Controller extends BaseController`,
+        `{`,
+        `    private ?${name}Service $service;`,
+        ``,
+        `    public function __construct()`,
+        `    {`,
+        `        try {`,
+        `            $this->service = new ${name}Service();`,
+        `        } catch (\\Exception $e) {`,
+        `            error_log("[${name}] Controller init failed: " . $e->getMessage());`,
+        `            $this->service = null;`,
+        `        }`,
+        `    }`,
+        ``,
+        `    private function unavailable(Response $response): Response`,
+        `    {`,
+        `        return $this->json($response, ['success' => false, 'message' => 'Service unavailable'], 503);`,
+        `    }`,
+        ``,
+        `    /** GET /${slug}/ping */`,
+        `    public function ping(Request $request, Response $response): Response`,
+        `    {`,
+        `        return $this->json($response, [`,
+        `            'success'   => true,`,
+        `            'message'   => 'pong',`,
+        `            'addon'     => '${name}',`,
+        `            'timestamp' => date('c'),`,
+        `        ]);`,
+        `    }`,
+        ``,
+        `    /** GET /${slug}/items */`,
+        `    public function index(Request $request, Response $response): Response`,
+        `    {`,
+        `        if (!$this->service) return $this->unavailable($response);`,
+        `        try {`,
+        `            $result = $this->service->getAll($request->getQueryParams());`,
+        `            return $this->json($response, ['success' => true, 'data' => $result]);`,
+        `        } catch (\\Exception $e) {`,
+        `            return $this->json($response, ['success' => false, 'message' => $e->getMessage()], 500);`,
+        `        }`,
+        `    }`,
+        ``,
+        `    /** GET /${slug}/items/{id} */`,
+        `    public function show(Request $request, Response $response, array $args): Response`,
+        `    {`,
+        `        if (!$this->service) return $this->unavailable($response);`,
+        `        $item = $this->service->getById($args['id']);`,
+        `        if (!$item) return $this->json($response, ['success' => false, 'message' => 'Not found'], 404);`,
+        `        return $this->json($response, ['success' => true, 'data' => $item]);`,
+        `    }`,
+        ``,
+        `    /** POST /${slug}/items */`,
+        `    public function store(Request $request, Response $response): Response`,
+        `    {`,
+        `        if (!$this->service) return $this->unavailable($response);`,
+        `        try {`,
+        `            $item = $this->service->create($request->getParsedBody() ?? []);`,
+        `            return $this->json($response, ['success' => true, 'data' => $item], 201);`,
+        `        } catch (\\Exception $e) {`,
+        `            return $this->json($response, ['success' => false, 'message' => $e->getMessage()], 400);`,
+        `        }`,
+        `    }`,
+        ``,
+        `    /** PATCH /${slug}/items/{id} */`,
+        `    public function update(Request $request, Response $response, array $args): Response`,
+        `    {`,
+        `        if (!$this->service) return $this->unavailable($response);`,
+        `        try {`,
+        `            $item = $this->service->update($args['id'], $request->getParsedBody() ?? []);`,
+        `            if (!$item) return $this->json($response, ['success' => false, 'message' => 'Not found'], 404);`,
+        `            return $this->json($response, ['success' => true, 'data' => $item]);`,
+        `        } catch (\\Exception $e) {`,
+        `            return $this->json($response, ['success' => false, 'message' => $e->getMessage()], 400);`,
+        `        }`,
+        `    }`,
+        ``,
+        `    /** DELETE /${slug}/items/{id} */`,
+        `    public function destroy(Request $request, Response $response, array $args): Response`,
+        `    {`,
+        `        if (!$this->service) return $this->unavailable($response);`,
+        `        $this->service->delete($args['id']);`,
+        `        return $this->json($response, ['success' => true]);`,
+        `    }`,
+        ``,
+        `    /** GET /${slug}/web/message — public */`,
+        `    public function publicMessage(Request $request, Response $response): Response`,
+        `    {`,
+        `        return $this->json($response, ['success' => true, 'message' => 'Hello from ${name}!']);`,
+        `    }`,
+        `}`,
+        ``,
+    ];
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genService(name, prefix) {
+    const tbl = `${prefix}_items`;
+    const lines = [
+        `<?php`,
+        `declare(strict_types=1);`,
+        ``,
+        `namespace VuCore\\Addons\\${name}\\Services;`,
+        ``,
+        `use VuCore\\Core\\Services\\DatabaseService;`,
+        `use PDO;`,
+        ``,
+        `class ${name}Service`,
+        `{`,
+        `    private PDO $db;`,
+        `    private string $table = '${tbl}';`,
+        ``,
+        `    public function __construct()`,
+        `    {`,
+        `        $this->db = DatabaseService::getConnection();`,
+        `    }`,
+        ``,
+        `    public function getAll(array $params = []): array`,
+        `    {`,
+        `        $page    = (int)($params['page'] ?? 1);`,
+        `        $perPage = (int)($params['per_page'] ?? 20);`,
+        `        $offset  = ($page - 1) * $perPage;`,
+        ``,
+        `        $stmt = $this->db->prepare(`,
+        `            "SELECT * FROM {$this->table} ORDER BY created_at DESC LIMIT :limit OFFSET :offset"`,
+        `        );`,
+        `        $stmt->bindValue(':limit',  $perPage, PDO::PARAM_INT);`,
+        `        $stmt->bindValue(':offset', $offset,  PDO::PARAM_INT);`,
+        `        $stmt->execute();`,
+        `        $items = $stmt->fetchAll(PDO::FETCH_ASSOC);`,
+        ``,
+        `        $total = (int)$this->db->query("SELECT COUNT(*) FROM {$this->table}")->fetchColumn();`,
+        ``,
+        `        return [`,
+        `            'items'      => $items,`,
+        `            'pagination' => [`,
+        `                'total'        => $total,`,
+        `                'per_page'     => $perPage,`,
+        `                'current_page' => $page,`,
+        `                'last_page'    => (int)ceil($total / $perPage),`,
+        `            ],`,
+        `        ];`,
+        `    }`,
+        ``,
+        `    public function getById(string $id): ?array`,
+        `    {`,
+        `        $stmt = $this->db->prepare("SELECT * FROM {$this->table} WHERE id = :id");`,
+        `        $stmt->execute(['id' => $id]);`,
+        `        return $stmt->fetch(PDO::FETCH_ASSOC) ?: null;`,
+        `    }`,
+        ``,
+        `    public function create(array $data): array`,
+        `    {`,
+        `        if (empty($data['name'])) throw new \\InvalidArgumentException('name is required');`,
+        ``,
+        `        $stmt = $this->db->prepare("`,
+        `            INSERT INTO {$this->table} (id, name, description, is_active, created_at, updated_at)`,
+        `            VALUES (gen_random_uuid(), :name, :description, true, NOW(), NOW())`,
+        `            RETURNING *`,
+        `        ");`,
+        `        $stmt->execute(['name' => $data['name'], 'description' => $data['description'] ?? null]);`,
+        `        return $stmt->fetch(PDO::FETCH_ASSOC);`,
+        `    }`,
+        ``,
+        `    public function update(string $id, array $data): ?array`,
+        `    {`,
+        `        $existing = $this->getById($id);`,
+        `        if (!$existing) return null;`,
+        ``,
+        `        $stmt = $this->db->prepare("`,
+        `            UPDATE {$this->table}`,
+        `            SET name = :name, description = :description, updated_at = NOW()`,
+        `            WHERE id = :id RETURNING *`,
+        `        ");`,
+        `        $stmt->execute([`,
+        `            'id'          => $id,`,
+        `            'name'        => $data['name']        ?? $existing['name'],`,
+        `            'description' => $data['description'] ?? $existing['description'],`,
+        `        ]);`,
+        `        return $stmt->fetch(PDO::FETCH_ASSOC);`,
+        `    }`,
+        ``,
+        `    public function delete(string $id): void`,
+        `    {`,
+        `        $this->db->prepare("DELETE FROM {$this->table} WHERE id = :id")->execute(['id' => $id]);`,
+        `    }`,
+        `}`,
+        ``,
+    ];
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genMigration(name, prefix) {
+    const UP = prefix.toUpperCase();
+    const cls = `Migration_001_Create${UP}Table`;
+    const tbl = `${prefix}_items`;
+    const lines = [
+        `<?php`,
+        `declare(strict_types=1);`,
+        ``,
+        `namespace VuCore\\Addons\\${name}\\Migrations;`,
+        ``,
+        `use VuCore\\Core\\Services\\Migration;`,
+        `use PDO;`,
+        ``,
+        `class ${cls} implements Migration`,
+        `{`,
+        `    private string $prefix = '${prefix}';`,
+        ``,
+        `    public function name(): string { return '001_Create${UP}Table'; }`,
+        ``,
+        `    public function up(PDO $db): void`,
+        `    {`,
+        `        $exists = $db->query("`,
+        `            SELECT EXISTS (`,
+        `                SELECT FROM information_schema.tables WHERE table_name = '${tbl}'`,
+        `            )`,
+        `        ")->fetchColumn();`,
+        `        if ($exists) return;`,
+        ``,
+        `        $db->exec("`,
+        `            CREATE TABLE ${tbl} (`,
+        `                id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),`,
+        `                name        VARCHAR(255) NOT NULL,`,
+        `                description TEXT,`,
+        `                is_active   BOOLEAN DEFAULT TRUE,`,
+        `                metadata    JSONB DEFAULT '{}',`,
+        `                created_at  TIMESTAMPTZ DEFAULT NOW(),`,
+        `                updated_at  TIMESTAMPTZ DEFAULT NOW()`,
+        `            )`,
+        `        ");`,
+        `        $db->exec("CREATE INDEX idx_${prefix}_items_name      ON ${tbl}(name)");`,
+        `        $db->exec("CREATE INDEX idx_${prefix}_items_is_active ON ${tbl}(is_active)");`,
+        `    }`,
+        ``,
+        `    public function down(PDO $db): void`,
+        `    {`,
+        `        $db->exec("DROP TABLE IF EXISTS ${tbl} CASCADE");`,
+        `    }`,
+        `}`,
+        ``,
+    ];
+    return lines.join('\n');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genAdminPage(name, slug, camel) {
+    return `<template>
+  <div class="space-y-6">
+
+    <div class="flex items-center justify-between">
+      <div>
+        <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
+          {{ t('${camel}.title') }}
+        </h1>
+        <p class="text-sm text-gray-500 dark:text-gray-400 mt-1">
+          {{ t('${camel}.description') }}
+        </p>
+      </div>
+      <UButton icon="i-lucide-plus" @click="openCreate">
+        {{ t('${camel}.actions.create') }}
+      </UButton>
+    </div>
+
+    <UCard>
+      <div v-if="loading" class="flex justify-center py-12">
+        <Icon name="i-lucide-loader-2" class="size-8 animate-spin text-primary" />
+      </div>
+
+      <div v-else-if="items.length === 0" class="text-center py-12">
+        <Icon name="i-lucide-inbox" class="size-12 text-gray-300 dark:text-gray-700 mx-auto mb-3" />
+        <p class="text-gray-500">{{ t('${camel}.empty') }}</p>
+        <UButton class="mt-4" @click="openCreate">
+          {{ t('${camel}.actions.create') }}
+        </UButton>
+      </div>
+
+      <div v-else class="divide-y divide-gray-100 dark:divide-gray-800">
+        <div
+          v-for="item in items"
+          :key="item.id"
+          class="flex items-center justify-between py-3"
+        >
+          <div>
+            <p class="font-medium text-gray-900 dark:text-white">{{ item.name }}</p>
+            <p class="text-xs text-gray-400 mt-0.5">{{ formatDate(item.created_at) }}</p>
+          </div>
+          <div class="flex gap-1">
+            <UButton size="xs" variant="ghost" color="neutral" icon="i-lucide-pencil"
+              @click="openEdit(item)" />
+            <UButton size="xs" variant="ghost" color="error" icon="i-lucide-trash-2"
+              @click="removeItem(item.id)" />
+          </div>
+        </div>
+      </div>
+    </UCard>
+
+    <!-- Oluştur / Düzenle Modal -->
+    <ClientOnly>
+      <UModal v-model:open="showModal">
+        <template #header>
+          <h3 class="text-lg font-semibold">
+            {{ editing ? t('${camel}.actions.edit') : t('${camel}.actions.create') }}
+          </h3>
+        </template>
+        <template #body>
+          <div class="space-y-4">
+            <UFormField :label="t('${camel}.form.name')" required>
+              <UInput v-model="form.name" autofocus />
+            </UFormField>
+            <UFormField :label="t('${camel}.form.description')">
+              <UTextarea v-model="form.description" :rows="3" />
+            </UFormField>
+          </div>
+        </template>
+        <template #footer>
+          <div class="flex justify-end gap-2">
+            <UButton variant="ghost" color="neutral" @click="showModal = false">
+              {{ t('${camel}.actions.cancel') }}
+            </UButton>
+            <UButton :loading="saving" @click="saveItem">
+              {{ t('${camel}.actions.save') }}
+            </UButton>
+          </div>
+        </template>
+      </UModal>
+    </ClientOnly>
+
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { useRuntimeConfig, useToast, useI18n } from '@cicore/shared'
+import enLocale from '../../locales/en.json'
+import trLocale from '../../locales/tr.json'
+
+// KRİTİK: useApi() değil — $fetch + config.public.apiBase kullan
+const config = useRuntimeConfig()
+const toast  = useToast()
+const { locale } = useI18n()
+
+// Addon i18n — locale dosyalarını doğrudan import et
+const t = (key: string): string => {
+  const map: Record<string, any> = { en: enLocale, tr: trLocale }
+  let val: any = map[locale.value] ?? map['en']
+  for (const k of key.split('.')) val = val?.[k]
+  return typeof val === 'string' ? val : key
+}
+
+const items     = ref<any[]>([])
+const loading   = ref(false)
+const saving    = ref(false)
+const showModal = ref(false)
+const editing   = ref<any>(null)
+const form      = ref({ name: '', description: '' })
+
+async function loadItems() {
+  loading.value = true
+  try {
+    const res = await $fetch<any>(\`\${config.public.apiBase}/${slug}/items\`)
+    if (res.success) items.value = res.data?.items ?? res.data ?? []
+  } catch (e: any) {
+    toast.add({ title: t('${camel}.messages.error'), color: 'error' })
+  } finally {
+    loading.value = false
+  }
+}
+
+function openCreate() {
+  editing.value = null
+  form.value = { name: '', description: '' }
+  showModal.value = true
+}
+
+function openEdit(item: any) {
+  editing.value = item
+  form.value = { name: item.name, description: item.description ?? '' }
+  showModal.value = true
+}
+
+async function saveItem() {
+  if (!form.value.name.trim()) return
+  saving.value = true
+  try {
+    if (editing.value) {
+      await $fetch(\`\${config.public.apiBase}/${slug}/items/\${editing.value.id}\`, {
+        method: 'PATCH', body: form.value,
+      })
+      toast.add({ title: t('${camel}.messages.updated'), color: 'success' })
+    } else {
+      await $fetch(\`\${config.public.apiBase}/${slug}/items\`, {
+        method: 'POST', body: form.value,
+      })
+      toast.add({ title: t('${camel}.messages.created'), color: 'success' })
+    }
+    showModal.value = false
+    await loadItems()
+  } catch (e: any) {
+    toast.add({ title: t('${camel}.messages.error'), color: 'error' })
+  } finally {
+    saving.value = false
+  }
+}
+
+async function removeItem(id: string) {
+  try {
+    await $fetch(\`\${config.public.apiBase}/${slug}/items/\${id}\`, { method: 'DELETE' })
+    toast.add({ title: t('${camel}.messages.deleted'), color: 'success' })
+    await loadItems()
+  } catch {
+    toast.add({ title: t('${camel}.messages.error'), color: 'error' })
+  }
+}
+
+function formatDate(d: string): string {
+  return new Date(d).toLocaleDateString(locale.value === 'tr' ? 'tr-TR' : 'en-US', {
+    year: 'numeric', month: 'short', day: 'numeric',
+  })
+}
+
+onMounted(() => loadItems())
+</script>
+`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genWebPage(name, slug, camel) {
+    return `<template>
+  <div class="space-y-6">
+    <div>
+      <h1 class="text-2xl font-bold text-gray-900 dark:text-white">
+        {{ t('${camel}.title') }}
+      </h1>
+      <p class="text-sm text-gray-500 dark:text-gray-400 mt-1">
+        {{ t('${camel}.description') }}
+      </p>
+    </div>
+
+    <UCard>
+      <div class="text-center py-8">
+        <Icon name="i-lucide-puzzle" class="size-14 text-primary mx-auto mb-4" />
+        <h2 class="text-lg font-semibold mb-2">{{ t('${camel}.web.greeting') }}</h2>
+        <p class="text-gray-500 mb-6">{{ t('${camel}.web.subtitle') }}</p>
+
+        <UButton :loading="loading" icon="i-lucide-send" @click="fetchPublic">
+          {{ t('${camel}.web.fetch_button') }}
+        </UButton>
+
+        <div v-if="message"
+          class="mt-4 p-3 rounded-lg bg-green-50 dark:bg-green-900/20
+                 text-green-700 dark:text-green-400 text-sm font-medium">
+          {{ message }}
+        </div>
+      </div>
+    </UCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+import { useRuntimeConfig, useI18n } from '@cicore/shared'
+import enLocale from '../../locales/en.json'
+import trLocale from '../../locales/tr.json'
+
+const config = useRuntimeConfig()
+const { locale } = useI18n()
+
+const t = (key: string): string => {
+  const map: Record<string, any> = { en: enLocale, tr: trLocale }
+  let val: any = map[locale.value] ?? map['en']
+  for (const k of key.split('.')) val = val?.[k]
+  return typeof val === 'string' ? val : key
+}
+
+const loading = ref(false)
+const message = ref('')
+
+async function fetchPublic() {
+  loading.value = true
+  try {
+    const res = await $fetch<any>(\`\${config.public.apiBase}/${slug}/web/message\`)
+    if (res.success) message.value = res.message
+  } catch {
+    message.value = 'API bağlantı hatası'
+  } finally {
+    loading.value = false
+  }
+}
+</script>
+`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genEntryTs(name) {
+    return `// ${name} Addon — ESM Entry Point
+import './style.css'
+
+const route_admin_index = () => import('../pages/admin/index.vue')
+const route_web_index   = () => import('../pages/web/index.vue')
+
+const locale_en = () => import('../locales/en.json')
+const locale_tr = () => import('../locales/tr.json')
+
+const entry = {
+  routes: {
+    'admin/index': route_admin_index,
+    'web/index':   route_web_index,
+  },
+  locales: {
+    en: locale_en,
+    tr: locale_tr,
+  },
+}
+
+export { entry }
+export default entry
+`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genStyleCss(name) {
+    return `/* ${name} Addon Styles */
+/* Addon'a özel global CSS buraya yazılır */
+/* Tailwind sınıfları Vue dosyalarında direkt kullanılır */
+`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genViteConfig(name) {
+    return `import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { resolve } from 'path'
+
+export default defineConfig({
+  base: './',
+  define: {
+    process: JSON.stringify({ env: { NODE_ENV: 'production' } }),
+    'process.env': JSON.stringify({ NODE_ENV: 'production' }),
+    'process.env.NODE_ENV': JSON.stringify('production'),
+    global: 'globalThis',
+  },
+  plugins: [vue({ script: { defineModel: true } })],
+  resolve: {
+    alias: {
+      '@': resolve(__dirname),
+      vue: '@cicore/shared',
+      '#imports': '@cicore/shared',
+      '@vue/devtools-api': resolve(__dirname, 'empty-devtools.js'),
+    },
+  },
+  build: {
+    lib: {
+      entry: resolve(__dirname, 'ui/entry.ts'),
+      formats: ['es'],
+      fileName: () => 'entry.js',
+    },
+    outDir: 'dist',
+    emptyOutDir: true,
+    minify: 'esbuild',
+    sourcemap: false,
+    modulePreload: false,
+    rollupOptions: {
+      preserveEntrySignatures: 'strict',
+      external(id, _parentId, isResolved) {
+        if (id.includes('entry.ts') || id.includes('entry.js')) return false
+        if (id.includes('?vue&type=')) return false
+        if (id.startsWith('./') || id.startsWith('../')) return false
+        if (isResolved && (id.includes('/addons/') || id.includes('\\\\addons\\\\'))) return false
+        if (id.includes('/addons/') || id.includes('\\\\addons\\\\')) return false
+        if (id === 'vue' || id.startsWith('vue/')) return true
+        if (id === '@vue/devtools-api' || id.startsWith('@vue/devtools-api/')) return false
+        if (id.startsWith('@vue/')) return true
+        if (id === '@cicore/shared' || id.startsWith('@cicore/')) return true
+        if (id === 'pinia' || id.startsWith('pinia/')) return true
+        if (!id.startsWith('.') && !id.startsWith('/') && !id.includes(':')) return true
+        return false
+      },
+      output: {
+        format: 'es',
+        entryFileNames: 'entry.js',
+        chunkFileNames: 'chunks/[name]-[hash].js',
+        paths: { vue: '@cicore/shared' },
+        assetFileNames: (a) =>
+          /\\.(png|jpe?g|gif|svg|webp|ico)$/i.test(a.name ?? '')
+            ? 'assets/img/[name]-[hash][extname]'
+            : 'assets/[name]-[hash][extname]',
+        exports: 'named',
+        manualChunks(id) {
+          if (id.includes('/pages/')) {
+            const m = id.match(/pages\\/(.+?)\\.vue/)
+            if (m) return m[1].replace(/\\//g, '-')
+          }
+          if (id.includes('/locales/')) {
+            const m = id.match(/locales\\/(.+?)\\.json/)
+            if (m) return m[1]
+          }
+        },
+      },
+    },
+  },
+})
+`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+function genLocaleEn(camel, display) {
+    return JSON.stringify({
+        [camel]: {
+            title: display,
+            description: `${display} addon for ciCore`,
+            empty: 'No items yet',
+            form: {
+                name: 'Name',
+                description: 'Description',
+            },
+            actions: {
+                create: 'Create New',
+                edit: 'Edit',
+                delete: 'Delete',
+                save: 'Save',
+                cancel: 'Cancel',
+            },
+            web: {
+                greeting: `Hello from ${display}!`,
+                subtitle: 'Public web interface',
+                fetch_button: 'Fetch Message',
+            },
+            messages: {
+                created: 'Created successfully',
+                updated: 'Updated successfully',
+                deleted: 'Deleted successfully',
+                error: 'An error occurred',
+            },
+        },
+    }, null, 2) + '\n';
+}
+function genLocaleTr(camel, display) {
+    return JSON.stringify({
+        [camel]: {
+            title: display,
+            description: `ciCore için${display} addon'u`,
+            empty: 'Henüz öğe yok',
+            form: {
+                name: 'İsim',
+                description: 'Açıklama',
+            },
+            actions: {
+                create: 'Yeni Oluştur',
+                edit: 'Düzenle',
+                delete: 'Sil',
+                save: 'Kaydet',
+                cancel: 'İptal',
+            },
+            web: {
+                greeting: `${display}'dan merhaba!`,
+                subtitle: 'Genel web arayüzü',
+                fetch_button: 'Mesajı Getir',
+            },
+            messages: {
+                created: 'Başarıyla oluşturuldu',
+                updated: 'Başarıyla güncellendi',
+                deleted: 'Başarıyla silindi',
+                error: 'Bir hata oluştu',
+            },
+        },
+    }, null, 2) + '\n';
+}
+// ─── Faz 5 quality stack generators ─────────────────────────────────
+// Moved to lib/ops/addon-quality.ts (Faz 5B) so the scaffold-quality
+// command can reuse them. Local definitions below remain for now to
+// avoid breaking the diff — they're now dead code and will be removed
+// in a follow-up cleanup.
+function _unused_genEslintConfig() {
+    return {
+        root: true,
+        env: { browser: true, es2022: true, node: true },
+        parser: 'vue-eslint-parser',
+        parserOptions: {
+            parser: '@typescript-eslint/parser',
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+            extraFileExtensions: ['.vue'],
+        },
+        plugins: ['vue', '@typescript-eslint'],
+        extends: [
+            'eslint:recommended',
+            'plugin:vue/vue3-recommended',
+            'plugin:@typescript-eslint/recommended',
+        ],
+        rules: {
+            // Single-word component names are common in addon page files
+            // (index.vue, list.vue). Vue's default rule would force PascalCase
+            // multi-word; ergonomically wrong for our routing layout.
+            'vue/multi-word-component-names': 'off',
+            'vue/html-self-closing': ['error', { html: { void: 'always', normal: 'always', component: 'always' } }],
+            // any-warnings rather than errors so addon authors can ship a TODO
+            // explicitly; the warning surfaces in the deploy quality gate.
+            '@typescript-eslint/no-explicit-any': 'warn',
+            'no-unused-vars': 'off',
+            '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+            'prefer-const': 'error',
+            'no-var': 'error',
+        },
+        ignorePatterns: ['dist/', 'node_modules/', '.vite-cache/', '*.d.ts'],
+    };
+}
+function _unused_genPrettierConfig() {
+    return {
+        semi: false,
+        singleQuote: true,
+        tabWidth: 2,
+        printWidth: 100,
+        trailingComma: 'es5',
+        vueIndentScriptAndStyle: false,
+        endOfLine: 'lf',
+    };
+}
+function _unused_genEditorConfig() {
+    return `root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+`;
+}
+function _unused_genTsConfig() {
+    return {
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'ESNext',
+            moduleResolution: 'Bundler',
+            strict: true,
+            noUncheckedIndexedAccess: true,
+            noImplicitOverride: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            isolatedModules: true,
+            resolveJsonModule: true,
+            noEmit: true,
+            jsx: 'preserve',
+            lib: ['ES2022', 'DOM', 'DOM.Iterable'],
+            // vue types resolved from dev-shell/node_modules/vue (parent
+            // lookup) so the addon doesn't need its own node_modules.
+            types: ['vue'],
+            paths: {
+                '@/*': ['./*'],
+            },
+        },
+        include: ['**/*.ts', '**/*.vue', 'ui/entry.ts'],
+        exclude: ['node_modules', 'dist', '.vite-cache'],
+    };
+}
+/**
+ * Ambient type declarations for the addon source. The runtime resolves
+ * `@cicore/shared` via the host's import map and `$fetch` is Nuxt's
+ * global, but vue-tsc has no way to find either without these shims.
+ * Declared as `any` for now — Faz 6 (SDK docs) ships richer type
+ * surfaces alongside the API reference and replaces these stubs.
+ */
+function _unused_genAmbientTypes() {
+    return `// Ambient types for ciCore addon runtime. Replaced by the real
+// @cicore/shared types when the SDK package ships (Faz 6 FUTURE).
+
+declare module '@cicore/shared' {
+  // Runtime exports come from the host's import map — every Vue Composition
+  // API name, the useApi/useAuth/useI18n composables, and the Nuxt UI
+  // components are re-exported here. Typed as any to keep new addons
+  // unblocked; Faz 6 (SDK docs) replaces this stub with typed surfaces.
+  //
+  // NOTE: TypeScript doesn't have a "catch-all named exports" syntax, so
+  // every name an addon imports must appear here. If vue-tsc rejects an
+  // import you need, add it to this list (and to docs/addon-sdk in Faz 6).
+  export const ref: any
+  export const reactive: any
+  export const computed: any
+  export const watch: any
+  export const watchEffect: any
+  export const onMounted: any
+  export const onUnmounted: any
+  export const onBeforeMount: any
+  export const onBeforeUnmount: any
+  export const nextTick: any
+  export const defineComponent: any
+  export const defineProps: any
+  export const defineEmits: any
+  export const useI18n: any
+  export const useAuth: any
+  export const useApi: any
+  export const useAddons: any
+  export const useTenant: any
+  export const usePermissions: any
+  export const useIcon: any
+  export const useNuxtUI: any
+  export const useRuntimeConfig: any
+  export const useToast: any
+  export const useRouter: any
+  export const useRoute: any
+  export const useGsap: any
+  export const Icon: any
+  export const UButton: any
+  export const UCard: any
+  export const UInput: any
+  export const UInputMenu: any
+  export const UModal: any
+  export const USelectMenu: any
+  export const USwitch: any
+  export const UAlert: any
+  export const UBadge: any
+  export const UTooltip: any
+  export const UFieldGroup: any
+  export const UForm: any
+  export const UFormField: any
+  export const UTextarea: any
+  export const UCheckbox: any
+  export const UTable: any
+  export const UPagination: any
+  export const UAvatar: any
+  export const UDropdownMenu: any
+  const _default: any
+  export default _default
+}
+
+// Nuxt global available to addon pages without explicit import.
+declare const $fetch: <T = unknown>(url: string, opts?: Record<string, unknown>) => Promise<T>
+
+// Vue SFC module shim so .vue imports resolve to a component type.
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+  const component: DefineComponent<Record<string, unknown>, Record<string, unknown>, unknown>
+  export default component
+}
+`;
+}
+function _unused_genGitlabCi(addonName) {
+    return `# Auto-generated by \`ci addon create ${addonName}\`. Faz 5 quality template.
+# Runs lint + typecheck on every MR + on default branch. Tooling resolves
+# from the addon-dev-shell repo's node_modules (cached across pipelines).
+
+stages:
+  - check
+
+quality:
+  stage: check
+  image: node:22-alpine
+  cache:
+    key: addon-dev-shell-tools
+    paths: [dev-shell-node_modules/]
+  before_script:
+    # The addon ships with no local node_modules — clone the shared
+    # toolchain from cicore-addons/addon-dev-shell at the same commit
+    # personnel uses locally. Pin to a tag if you need reproducibility.
+    - apk add --no-cache git
+    - git clone --depth 1 http://10.20.20.28/cicore-addons/addon-dev-shell tmp-shell
+    - mv tmp-shell/package.json tmp-shell/package-lock.json ./
+    - npm ci --no-audit --no-fund --prefer-offline
+  script:
+    - ./node_modules/.bin/eslint . --max-warnings 0
+    - ./node_modules/.bin/vue-tsc --noEmit
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+`;
+}
+//# sourceMappingURL=create.js.map