agent-enderun 0.1.5 → 0.1.8

package/.enderun/agents/analyst.md

@@ -123,7 +123,7 @@ Before approving any task completion, @analyst must verify that the agent follow
 - [ ] Integration tests passed with real DB (TestContainers).
 - [ ] Zero Mock Policy verified.
 - [ ] **Zero UI Library Policy:** Verified via manual/code scan that @frontend used no ready-made UI libraries (shadcn, MUI, etc.).
-- [ ] **Panda CSS Compliance:** Confirmed that the design was built with Panda CSS tokens and type-safe structure.
+- [ ] **UnoCSS Compliance:** Confirmed that the design was built with UnoCSS tokens and type-safe structure.
 
 **PHASE_4 (Done):**
 

package/.enderun/agents/frontend.md

@@ -1,6 +1,6 @@
 ---
 name: frontend
-description: "UI/UX & Frontend Architect. Expert in React 19, Vite, Zustand, and Panda CSS. Fluid & Modern design specialist. Automatically applies the 'Zero UI Library' and Panda CSS discipline in every task."
+description: "UI/UX & Frontend Architect. Expert in React 19, Vite, Zustand, and UnoCSS. Fluid & Modern design specialist. Automatically applies the 'Zero UI Library' and UnoCSS discipline in every task."
 ---
 
 # Frontend Architect — v0.1.5 Master
@@ -11,8 +11,8 @@ description: "UI/UX & Frontend Architect. Expert in React 19, Vite, Zustand, and
 
 ## 🎯 Core Principle: Search Before Reading & Continuity
 
-- **Context-First:** Never start coding before understanding the current state of a component. Use `search_codebase` to check similar components or find the definition of a token in `panda.config.ts`.
-- **Procedural Continuity:** Maintain absolute consistency with existing UI patterns. Before editing any component, analyze its current Panda CSS usage and interaction logic. Finish the task using the same standards.
+- **Context-First:** Never start coding before understanding the current state of a component. Use `search_codebase` to check similar components or find the definition of a token in `uno.config.ts`.
+- **Procedural Continuity:** Maintain absolute consistency with existing UI patterns. Before editing any component, analyze its current UnoCSS usage and interaction logic. Finish the task using the same standards.
 
 ---
 
@@ -31,7 +31,7 @@ Do not wait for the user to ask for basic professional standards. You are RESPON
 1. Read `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` → `CURRENT STATUS`, `ACTIVE TASKS`, and `CRITICAL DECISIONS`.
 2. Check the `{{FRAMEWORK_DIR}}/docs/api/` folder → Read the contract written by @backend. **NO CODING BEFORE READING THE CONTRACT.**
 3. Check `packages/shared-types/src/` → Import the types required for the UI.
-4. Read `panda.config.ts` → Understand the project's design tokens (colors, spacing, typography).
+4. Read `uno.config.ts` → Understand the project's design tokens (colors, spacing, typography).
 
 > ✅ **End of Session:** Update `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` HISTORY via `update_project_memory` + log the action via `log_agent_action`.
 
@@ -41,7 +41,7 @@ Do not wait for the user to ask for basic professional standards. You are RESPON
 
 AI-Enderun strictly adheres to the **Zero UI Library Policy**.
 - **FORBIDDEN:** `shadcn/ui`, `MUI`, `Chakra UI`, `Ant Design`, `Bootstrap`, etc.
-- **MANDATORY:** All UI components (Button, Modal, Input, Card, etc.) must be built from scratch using **Panda CSS**, unique to this project.
+- **MANDATORY:** All UI components (Button, Modal, Input, Card, etc.) must be built from scratch using **UnoCSS**, unique to this project.
 - **RATIONALE:** Maximum performance (zero-runtime), full type safety, and unique/original aesthetics.
 
 ---
@@ -54,10 +54,10 @@ AI-Enderun strictly adheres to the **Zero UI Library Policy**.
 
 ---
 
-## Design System & Panda CSS
+## Design System & UnoCSS
 
 ```typescript
-// ✅ Correct: Panda CSS (Zero-runtime, Type-safe)
+// ✅ Correct: UnoCSS (Zero-runtime, Type-safe)
 import { css } from '.{{FRAMEWORK_DIR}}/styled-system/css';
 
 const Button = ({ children }) => (
@@ -75,7 +75,7 @@ const Button = ({ children }) => (
 );
 ```
 
-**Rule:** Ad-hoc styles are forbidden. Everything must use tokens defined in `panda.config.ts`.
+**Rule:** Ad-hoc styles are forbidden. Everything must use tokens defined in `uno.config.ts`.
 
 ---
 
@@ -115,7 +115,7 @@ Frontend never creates its own types for backend data.
 
 - [ ] Is the design mobile-first?
 - [ ] Is `clamp()` or fluid spacing used for responsiveness?
-- [ ] Are all styles built with Panda CSS? (Checked: No external UI libraries used)
+- [ ] Are all styles built with UnoCSS? (Checked: No external UI libraries used)
 - [ ] Are types imported from `shared-types`?
 - [ ] Are there loading and error states?
 - [ ] Does it match the premium aesthetics requested in the Constitution?
@@ -126,7 +126,7 @@ Frontend never creates its own types for backend data.
 
 - [ ] Is the design mobile-first?
 - [ ] Is `clamp()` or fluid spacing used for responsiveness?
-- [ ] Are all styles built with Panda CSS? (Checked: No external UI libraries used)
+- [ ] Are all styles built with UnoCSS? (Checked: No external UI libraries used)
 - [ ] Are types imported from `shared-types`?
 - [ ] Are there loading and error states?
 - [ ] Does it match the premium aesthetics requested in the Constitution?
@@ -136,14 +136,14 @@ Frontend never creates its own types for backend data.
 - **Design System Coverage:** Identify missing tokens or component patterns and record them as design system improvements.
 - **UI Contract Validation:** If an API contract changes, update the frontend contract checklist and notify @backend.
 - **Accessibility Growth:** Add at least one A11y improvement per task, such as keyboard support, focus styling, or contrast checks.
-- **Component Reuse:** Build UI pieces as composable Panda CSS components with clear props and documentation.
+- **Component Reuse:** Build UI pieces as composable UnoCSS components with clear props and documentation.
 
 ## RED LINES
 
 | Forbidden | Rationale |
 |---|---|
 | Using `shadcn/ui` or any UI library | Violation of Zero UI Library Policy |
-| Using Tailwind CSS | Violation of Panda CSS standard |
+| Using Tailwind CSS | Violation of UnoCSS standard |
 | Creating local types for API data | Contract must come from `shared-types` |
 | `any` type | Use `unknown` or proper interfaces |
 | Hardcoded colors/spacing | Design System tokens must be used |

package/.enderun/agents/manager.md

@@ -133,7 +133,7 @@ graph TD
 - [ ] Integration tests passed with real DB.
 - [ ] Zero Mock Policy verified.
 - [ ] **Zero UI Library Policy** verified (Confirmed no external UI libraries used).
-- [ ] **Panda CSS** configuration and type-safe token usage checked.
+- [ ] **UnoCSS** configuration and type-safe token usage checked.
 
 **PHASE_4 (Done):**
 
@@ -162,7 +162,7 @@ graph TD
 | Incomplete Briefing Template             | Agent might misunderstand the task           |
 | Reading files without searching          | Violation of Search-Before-Reading principle |
 | Suggesting/Using ready-made UI libraries | Violation of Zero UI Library Policy          |
-| Using Tailwind CSS                       | Violation of Panda CSS standard              |
+| Using Tailwind CSS                       | Violation of UnoCSS standard              |
 
 ---
 

package/.enderun/config.json

@@ -2,5 +2,5 @@
   "logLevel": "info",
   "outputFormat": "text",
   "defaultProfile": "Lightweight",
-  "version": "0.1.5"
+  "version": "0.1.8"
 }

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.6] - 2026-05-09
+
+### Added
+- **UnoCSS Integration:** Transitioned from Panda CSS to UnoCSS for frontend styling.
+- **Auto-Scaffolding:** The `init` command now automatically adds UnoCSS dependencies and a `uno.config.ts` configuration to new projects.
+- **Atomic CSS support:** Enabled Attributify and Icons presets by default in the generated projects.
+
+
 ## [0.1.0] - 2026-05-09
 
 ### Fixed

package/README.md

@@ -1,4 +1,4 @@
-# Agent Enderun (v0.0.5)
+# Agent Enderun (v0.1.8)
 
 [English](#english) | [Türkçe](#türkçe)
 
@@ -32,7 +32,7 @@ A team of specialized agents, each with a strict SOP and a unique domain:
 - `@manager`: orchestration, phase gating, trace IDs
 - `@analyst`: QA, documentation, memory auditing
 - `@backend`: backend architecture, contracts, security
-- `@frontend`: UI/UX, Panda CSS, frontend continuity
+- `@frontend`: UI/UX, UnoCSS, frontend continuity
 - `@explorer`: codebase research, dependency mapping
 - `@mobile`: mobile strategy and performance
 - `@native`: desktop integration and OS constraints
@@ -45,7 +45,7 @@ All AI-specific logic, agent instructions, and memory live in adapter directorie
 Backend and frontend communicate through `packages/shared-types` and documented API contracts in `{{FRAMEWORK_DIR}}/docs/api/`. This prevents mismatched expectations and ensures both sides implement the same contract.
 
 ### Zero UI Library Policy
-The frontend must use Panda CSS and no third-party UI kits. This gives you original visuals, better performance, and zero runtime UI dependencies.
+The frontend must use UnoCSS and no third-party UI kits. This gives you original visuals, better performance, and zero runtime UI dependencies.
 
 ## What makes Agent Enderun different
 
@@ -73,7 +73,7 @@ The frontend must use Panda CSS and no third-party UI kits. This gives you origi
 ### Key folders
 
 - `apps/backend/` — server implementation and business logic.
-- `apps/web/` — frontend interface and Panda CSS UI.
+- `apps/web/` — frontend interface and UnoCSS UI.
 - `packages/shared-types/` — shared contract types for all agents.
 - `packages/framework-mcp/` — MCP server tools for AI-assisted workflows.
 - `.enderun/` — framework rules, memory, agent SOPs, and hidden configuration.
@@ -176,7 +176,7 @@ Her biri kendi uzmanlık alanı ve SOP'u olan bir ajan takımı:
 - `@manager`: orkestrasyon, faz kapıları, trace ID yönetimi
 - `@analyst`: kalite, dokümantasyon, hafıza denetimi
 - `@backend`: backend mimarisi, sözleşmeler, güvenlik
-- `@frontend`: UI/UX, Panda CSS, frontend sürekliliği
+- `@frontend`: UI/UX, UnoCSS, frontend sürekliliği
 - `@explorer`: kod tabanı araştırması, bağımlılık haritalama
 - `@mobile`: mobil strateji ve performans
 - `@native`: masaüstü entegrasyonu ve işletim sistemi kısıtları
@@ -189,7 +189,7 @@ Tüm AI spesifik yapı `.gemini/`, `.claude/`, `.cursor/` veya `.codex/` gibi gi
 Backend ve frontend, `packages/shared-types` ve `{{FRAMEWORK_DIR}}/docs/api/` belgeleri üzerinden eşleşir. Bu, taraflar arasında yanlış anlaşılma ihtimalini azaltır.
 
 ### Sıfır UI Kütüphanesi Politikası
-Frontend, Panda CSS kullanmalı ve üçüncü taraf UI kitleri yasaklanmalıdır. Böylece performans, özgünlük ve sıfır runtime bağımlılığı sağlanır.
+Frontend, UnoCSS kullanmalı ve üçüncü taraf UI kitleri yasaklanmalıdır. Böylece performans, özgünlük ve sıfır runtime bağımlılığı sağlanır.
 
 ## Agent Enderun’u Öne Çıkaranlar
 
@@ -217,7 +217,7 @@ Frontend, Panda CSS kullanmalı ve üçüncü taraf UI kitleri yasaklanmalıdır
 ### Ana klasörler
 
 - `apps/backend/` — sunucu uygulaması ve iş mantığı.
-- `apps/web/` — frontend UI ve Panda CSS bileşenleri.
+- `apps/web/` — frontend UI ve UnoCSS bileşenleri.
 - `packages/shared-types/` — ortak sözleşme tipleri.
 - `packages/framework-mcp/` — AI destekli MCP sunucu araçları.
 - `.enderun/` — çerçeve kuralları, hafıza, ajan SOP'ları ve gizli yapılandırma.

package/bin/cli.js

@@ -151,7 +151,12 @@ function mergePackageJson(targetPath, sourcePath) {
     ...(sourceDevDeps["ts-morph"] ? {"ts-morph": sourceDevDeps["ts-morph"]} : {}),
     ...(sourceDevDeps["typescript"] ? {"typescript": sourceDevDeps["typescript"]} : {}),
     ...(sourceDevDeps["@types/node"] ? {"@types/node": sourceDevDeps["@types/node"]} : {}),
-    ...(sourceDevDeps["tsx"] ? {"tsx": sourceDevDeps["tsx"]} : {})
+    ...(sourceDevDeps["tsx"] ? {"tsx": sourceDevDeps["tsx"]} : {}),
+    "unocss": "^66.0.0",
+    "@unocss/preset-uno": "^66.0.0",
+    "@unocss/preset-attributify": "^66.0.0",
+    "@unocss/preset-icons": "^66.0.0",
+    "@unocss/transformer-directives": "^66.0.0"
   });
 
   if (targetPkg.peerDependencies) targetPkg.peerDependencies = sanitizeDeps(targetPkg.peerDependencies);
@@ -235,7 +240,7 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 | :--- | :--- |
 | Project Name | ${path.basename(process.cwd())} |
 | Platform | Not defined |
-| Frontend | React 19 + Vite + Panda CSS |
+| Frontend | React 19 + Vite + UnoCSS |
 | Backend | Node.js 20+ + Fastify |
 | DB | PostgreSQL |
 
@@ -324,6 +329,7 @@ async function initCommand(selectedAdapter) {
     ".enderun/STATUS.md",
     "packages/framework-mcp",
     "packages/shared-types",
+    "uno.config.ts",
   ];
 
   const DIRS_TO_CREATE = [
@@ -466,8 +472,8 @@ async function initCommand(selectedAdapter) {
   const finalMemoryPath = path.join(targetDir, targetBase, "PROJECT_MEMORY.md");
   initializeMemory(finalMemoryPath, targetBase);
   
-  // Deep clean ALL package.json files in target packages directory
-  deepCleanProtocols(path.join(targetDir, "packages"), targetScope);
+  // Deep clean ALL package.json files in target directory (removes workspace: and panda css)
+  deepCleanProtocols(targetDir, targetScope);
 
   // Initialize git if missing
   if (!fs.existsSync(path.join(targetDir, ".git"))) {
@@ -551,6 +557,7 @@ function deepCleanProtocols(dir, targetScope = "") {
   for (const entry of entries) {
     const fullPath = path.join(dir, entry.name);
     if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git") continue;
       deepCleanProtocols(fullPath, targetScope);
     } else if (entry.name === "package.json") {
       try {
@@ -645,6 +652,12 @@ function sanitizeJson(obj, targetScope = "") {
     let finalKey = key;
     let finalValue = value;
 
+    // Remove UnoCSS related keys or values
+    if (typeof key === "string" && (key.includes("panda") || key.includes("pandacss"))) continue;
+    if (typeof value === "string" && (value.includes("panda codegen") || value.includes("panda init"))) {
+      continue; // Skip this script/field
+    }
+
     // Replace scope if needed
     if (targetScope) {
       if (typeof key === "string" && key.startsWith("@ai-enderun/")) {

package/docs/tech-stack.md

@@ -3,7 +3,7 @@
 | Layer | Technology |
 | :--- | :--- |
 | Frontend | React 19 + Vite (SPA) |
-| Styling | Panda CSS |
+| Styling | UnoCSS |
 | Backend | Node.js (Fastify/Hono) |
 | Database | PostgreSQL (Kysely) |
 | Architecture | Contract-First (Shared Types) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "type": "module",
   "workspaces": [
     "packages/*"
@@ -17,7 +17,7 @@
   "dependencies": {},
   "devDependencies": {},
   "enderun": {
-    "version": "0.1.5",
+    "version": "0.1.8",
     "initializedAt": "2026-05-09T13:24:27.472Z"
   }
 }

package/packages/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun-mcp",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "Enterprise-grade MCP Server for AI Agent Framework",
   "type": "module",
   "main": "dist/index.js",

package/packages/shared-types/contract.version.json

@@ -1,9 +1,9 @@
 {
-  "version": "0.1.5",
+  "version": "0.1.8",
   "last_updated": "2026-05-09T13:04:00Z",
   "contract_hash": "daf1d688875061ef66697f39ac2449a34631e9b93926ed3e694b4e4ac7423d98",
   "breaking_changes": [
-    { "version": "0.1.5", "description": "Initial framework setup" }
+    { "version": "0.1.8", "description": "Initial framework setup" }
   ],
   "deprecated_versions": []
 }

package/packages/shared-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-enderun/shared-types",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "Shared TypeScript types for AI-Enderun Framework. Ensures Contract-First synchronization between agents.",
   "type": "module",
   "main": "dist/index.js",

package/uno.config.ts

@@ -0,0 +1,36 @@
+import {
+  defineConfig,
+  presetAttributify,
+  presetIcons,
+  presetTypography,
+  presetUno,
+  presetWebFonts,
+  transformerDirectives,
+  transformerVariantGroup,
+} from 'unocss'
+
+export default defineConfig({
+  shortcuts: [
+    ['btn', 'px-4 py-1 rounded inline-block bg-teal-600 text-white cursor-pointer hover:bg-teal-700 disabled:cursor-default disabled:bg-gray-600 disabled:opacity-50'],
+    ['icon-btn', 'text-[0.9em] inline-block cursor-pointer select-none opacity-75 transition duration-200 ease-in-out hover:opacity-100 hover:text-teal-600 !outline-none'],
+  ],
+  presets: [
+    presetUno(),
+    presetAttributify(),
+    presetIcons({
+      scale: 1.2,
+      warn: true,
+    }),
+    presetTypography(),
+    presetWebFonts({
+      fonts: {
+        sans: 'Inter',
+        mono: 'Fira Code',
+      },
+    }),
+  ],
+  transformers: [
+    transformerDirectives(),
+    transformerVariantGroup(),
+  ],
+})

package/.gemini/ENDERUN.md

@@ -1,201 +0,0 @@
-# Agent Enderun (v0.0.4)
-# Place in project root. This file is the single source of truth for Base Project AI Extensions.
-
-## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
-> Check this list at the end of every response:
-> - [ ] **Zero Mock:** Did you use fake data or placeholders? (Strictly Forbidden)
-> - [ ] **Contract First:** Are `shared-types` and `contract.version.json` up to date?
-> - [ ] **Audit Log:** Did you log this action in `.gemini/logs/[agent].json`?
-> - [ ] **CLI Orchestration:** Does the action comply with `gemini cli` rules?
-> - [ ] **No "..." allowed:** Did you write the code completely without omitting parts?
-
----
-
-## Constitution Status
-This file (`./gemini.md`) and the `.gemini/docs/` folder represent the "Supreme Law" of the project. All agents must read this file first in every session and strictly comply with its rules 100%.
-
----
-
-## STEP 0 — STARTUP (EVERY SESSION, NON-NEGOTIABLE)
-
-1. **Read ./gemini.md First:** Read and fully understand this file before taking any action.
-2. **Check `.gemini/docs/` Folder:** Verify the existence of the `.gemini/docs/` folder in the project root.
-3. **Absorb Context:** Read `.gemini/docs/tech-stack.md`. If it is empty, ask the user to fill it before proceeding.
-4. **Demand Context:** If the `.gemini/docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
-5. Default Frontend: React 19 + Vite (SPA) + react-router-dom (User Preference)
-
-**NEVER SKIP THIS STEP.** Do not assume context; read first, then act.
-
----
-
-## CORE PRINCIPLES
-
-- **Team-Lead Default Orchestration:** Whenever the user writes a general request, the `@team-lead` agent MUST automatically step in. The Team Lead is responsible for analyzing the user's intent, determining the Execution Profile (Lightweight or Full), and delegating tasks to the appropriate specialist agents.
-- **Contract-First Approach:** Communication between Backend and Frontend must always be defined via schemas first. The `packages/shared-types/contract.version.json` file must be kept in MAJOR.MINOR format and updated with every change. The `@backend-architect` is responsible for updating this file.
-- **Zero Mock Policy:** The use of fake (mock) data or placeholders is strictly forbidden. Every line of code must connect to a real endpoint or a typed contract. (Exception: Controlled mock usage is allowed for external 3rd party services like Stripe, Twilio).
-- **Branded Types Law:** All IDs (UserID, ProjectID, etc.) must be in the "Branded Types" format defined under `packages/shared-types`. Using plain strings or numbers is forbidden.
-- **CLI-First Policy:** Due to the AI CLI Assistant focus, all outputs must be user-friendly (using Chalk, Clack, etc.) and stream-based. All commands must support the `--output json` flag and produce machine-readable output.
-- **Audit Logging Necessity:** Every critical action must be logged traceably under the `.gemini/logs/` folder.
-- **File Ownership Rule:** Each file is the responsibility of a single agent.
-- **CLI Command Mapping:** All CLI commands in the project must be defined in the `.gemini/cli-commands.json` file and assigned to the relevant agent.
-- **Exit Code Standard:** Standard exit codes (e.g., 64: User Error, 70: Internal Error) must be used in error situations.
-- **Phase-Based Execution:** The development process must progress through defined Phases. You cannot move to the next phase until the current one is completed.
-- **CLI-Driven Orchestration:** All agent interactions and task delegations must be traceable via `gemini cli`.
-- **Monorepo Discipline:** Commands must always be run from the monorepo root directory using npm workspaces (e.g., `npm run dev --workspace=web`).
-
----
-
-## STEP 1 — VALIDATE BEFORE ACTING
-
-Before writing any code or design, check `.gemini/docs/tech-stack.md`:
-
-| Unknown | Action |
-|---|---|
-| Target Audience | Ask — do not proceed |
-| Platform (web / mobile / desktop / backend) | Ask — do not proceed |
-| **Technology Stack** | **Check `.gemini/docs/tech-stack.md` → If missing → ASK** |
-| **Execution Profile (Full / Lightweight)** | **Ask — do not proceed** |
-| Database (MariaDB / SQLite / PostgreSQL) | Ask — do not proceed |
-| Environment (prototype / production) | Ask — do not proceed |
-| Auth required? | Ask — do not proceed |
-| Monorepo or separate repos? | Ask — do not proceed |
-| Deploy target (Vercel / Docker / Bare metal)? | Ask — do not proceed |
-| i18n (multi-language) required? | Ask — do not proceed |
-| API versioning strategy? | Ask — do not proceed |
-| Accessibility level (WCAG AA / AAA)? | Default AA — ask if different |
-| Scope too broad ("build the whole app") | Break into parts → confirm each part |
-
-Small details (port, filename, folder name) → assume and state them.
-
-Always write assumptions at the top of your response:
-```
-Assumption: [what] — [why]
-```
-
----
-
-## OUTPUT FLOWS (MANDATORY STANDARDS)
-
-Every agent must use the **Mandatory Output Flow** defined in their specific `.md` file. However, the following sections are mandatory in all outputs:
-
-- **Assumptions:** All assumptions made.
-- **Problem:** What is being built and why (Max 2-3 sentences).
-- **File Tree:** Complete folder and file structure.
-- **Code:** Complete code content (using "..." is forbidden).
-- **Audit Logging:** How the changes are logged.
-- **Tests:** Test file for every service and utility.
-
----
-
-## ABSOLUTE DON'TS — APPLIES TO EVERY RESPONSE
-
-- **`any` Type is Forbidden:** The use of `any` is strictly forbidden in TypeScript projects.
-- **`console.log` is Forbidden:** `console.log` cannot be present in production code.
-- **Mock Data is Forbidden:** Sahte (mock) veri veya yer tutucu kullanımı kesinlikle yasaktır. Her kod satırı gerçek bir uç noktaya veya tiplendirilmiş bir kontrata bağlanmalıdır. (İstisna: Stripe, Twilio gibi harici 3. taraf servisler için kontrollü mock kullanımına izin verilir).
-- **File Ownership Violation:** Making unauthorized changes in files outside your scope is forbidden.
-- **Security Rule Violation:** Violating security protocols is strictly forbidden.
-- **Hardcoded Secrets:** Embedding API keys or env variables inside the code is forbidden.
-- **Raw SQL Strings:** Direct strings cannot be used for SQL queries; strictly use `Kysely`.
-- **Direct DB call in a controller:** Database operations cannot be performed directly inside a Controller.
-- **Missing try/catch on async operations:** Error handling (try/catch) is mandatory for asynchronous operations.
-
----
-
-## LANGUAGE POLICY
-
-- Code comments: English (Explain why it was done, not what it does).
-- Variable / function / class / file names: English.
-- User-facing UI text: English (Default).
-- Communication: English by default (Global rule).
-
----
-
-## EXECUTION PROFILES
-
-Depending on the size and complexity of the project, there are two execution profiles. The Team Lead must determine this profile at the start of the project:
-
-- **Lightweight Profile (MVP):** Only `team-lead`, `backend-architect`, `frontend-specialist`, and `design-specialist` are active. Mandatory for rapid prototyping, small projects, and low-budget work. Mobile, desktop, and test agents are bypassed.
-- **Full Profile (Enterprise):** team-lead, backend-architect, frontend-specialist, design-specialist, test-engineer
-
----
-
-## API & CONTRACT MANAGEMENT
-
-### 1. contract.version.json Standard
-This file is the single source of truth for API stability. `@backend-architect` is responsible for its integrity.
-
-```json
-{
-  "version": "MAJOR.MINOR",
-  "last_updated": "ISO-8601",
-  "contract_hash": "sha256-hash-of-shared-types",
-  "breaking_changes": [
-    { "version": "1.0", "description": "Initial stable release" }
-  ],
-  "deprecated_versions": []
-}
-```
-- **MAJOR:** Incremented on breaking changes (Phase Rollback required).
-- **MINOR:** Incremented on additive changes (New fields/endpoints).
-
----
-
-## STATE MACHINE & EXECUTION PHASES
-
-The development process follows a strict State Machine. Transition to the next phase is prohibited until the "Success Criteria" of the current phase is met.
-
-- **[STATE: PHASE_0] Discovery & Setup:** Profile selection (Lightweight/Full), requirement analysis, and validating `.gemini/docs/tech-stack.md`.
-- **[STATE: PHASE_1] Architecture & Contracts:** Setup of data models, API schemas, and `packages/shared-types`. Cannot proceed until Frontend and Backend approve these schemas.
-- **[STATE: PHASE_2] Core Development:** Active agents build core features in parallel based on the selected profile. (Under the apps/ folder)
-- **[STATE: PHASE_3] Integration & Testing:** System integration.
-- **[STATE: PHASE_4] Optimization & Deployment:** Performance audit and deployment.
-
-**Rollback Rule:** If a missing field or error is detected in the API schema (`shared-types`) during Phase 2 or later, the system immediately transitions to `[STATE: ROLLBACK_PHASE_1]`. All relevant agents stop their processes, switch to `WAITING` state, and cannot return to Phase 2 until the `backend-architect` resolves the issues.
-
----
-
-## AGENT TIMEOUT & ESCALATION
-
-Every agent must produce a response for their assigned task within a maximum of 30 minutes (or the time defined per project). Upon timeout, `task-specialist` automatically moves the relevant task to `BLOCKED` status and leaves an escalation message for the `@team-lead`.
-
----
-
-## CLI STANDARDS & CONFIGURATION
-
-### 1. CLI Command Map (`.gemini/cli-commands.json`)
-All CLI commands are centrally managed in this file. Each command must have a designated owner agent.
-
-### 2. Configuration (`.gemini/config.json`)
-CLI behaviors (logLevel, outputFormat, defaultProfile) are managed through this file.
-
-**Priority Rule:** CLI Flags > `.gemini/config.json` > `.env` > Default Values.
-
-### 3. Exit Codes
-- `0`: Success
-- `64`: User Error (Invalid argument, missing parameter)
-- `70`: Internal Error (Software error, crash)
-- `71`: Connection/Network Error
-
----
-
-## API VERSIONING STRATEGY
-
-All APIs are versioned via the URL path (`/api/v1/...`). The `packages/shared-types/contract.version.json` file uses the MAJOR.MINOR format, and must be updated with every change. The `@backend-architect` is responsible for its accuracy. The MAJOR version is incremented for every breaking change. Old versions continue to be supported for at least 1 MAJOR release.
-
----
-
-## PARALLEL EXECUTION & COORDINATION RULES
-
-1. **Shared-Types as Source of Truth:** All agents reference `packages/shared-types` and the `contract.version.json` file.
-2. **Commit-Level Logging:** Every agent must log every atomic change to the `.gemini/logs/[agent-name].json` file.
-3. **Implicit Dependency Lock:** If an agent's required output is not ready, it switches to `WAITING` state.
-4. **Ownership Enforcement:** Changes to files outside an agent's scope cannot be made without `@team-lead` approval.
-5. **No Blind Coding:** Agents must periodically read `.gemini/logs/` and `.gemini/STATUS.md`.
-6. **Agent Directives (Message Queue):** `.gemini/messages/` is used for inter-agent communication. 
-   - **Message Queue Lock Protocol:** Before writing to a file, check for `.gemini/messages/.lock`.
-   - If it exists, wait 500ms and retry (max 3 retries).
-   - If lock persists after 3 retries, the agent MUST assume a **stale lock**, delete it, and notify `@team-lead` in their log.
-   - Delete `.lock` and the message file immediately after processing.
-7. **Phase Rollback Protocol:** If contracts are insufficient, return to Phase 1. All agents become `WAITING` and write `CONTRACT_CHANGED` to their log.
-8. **Next.js Ownership Rule:** `apps/web/api/` and `server/actions/` -> @backend-architect. `apps/web/(routes)/` and `components/` -> @frontend-specialist.
-9. **Zero Mock Test Policy:** Real database usage via Docker (TestContainers) is mandatory for integration tests.

package/.gemini/PROJECT_MEMORY.md

@@ -1,54 +0,0 @@
-# PROJECT MEMORY — Agent Enderun
-
-This file is the Single Source of Truth (SSOT) and the persistent memory of the project.
-
-## CURRENT STATUS
-
-| Active Phase | Profile | Last Update | Active Trace ID | Blockers |
-| :----------- | :------ | :---------- | :-------------- | :------- |
-| PHASE_0      | Lightweight | 2026-05-09 | 01KR6EJA6GG3RPS849097KS37Q | NONE |
-
-## PROJECT DEFINITION
-
-| Field | Value |
-| :--- | :--- |
-| Project Name | agent-enderun |
-| Platform | Not defined |
-| Frontend | React 19 + Vite + Panda CSS |
-| Backend | Node.js 20+ + Fastify |
-| DB | PostgreSQL |
-
-## DOD STATUS
-
-| Phase | Status | Note |
-| :--- | :--- | :--- |
-| PHASE_0 | IN_PROGRESS | Initializing project structure |
-| PHASE_1 | PENDING | |
-| PHASE_2 | PENDING | |
-| PHASE_3 | PENDING | |
-| PHASE_4 | PENDING | |
-
-## CRITICAL DECISIONS
-
-| Date | Decision | Rationale | Agent |
-| :--- | :--- | :--- | :--- |
-| 2026-05-09 | Project Initialized | Framework setup via CLI | @manager |
-
-## DELIVERABLES
-
-| Module | Status | Agent | Date |
-| :--- | :--- | :--- | :--- |
-
-## ACTIVE TASKS
-
-| Trace ID | Task | Agent | Priority | Status |
-| :--- | :--- | :--- | :--- | :--- |
-| 01KR6EJA6GG3RPS849097KS37Q | Framework setup and architecture alignment | @manager | P1 | IN_PROGRESS |
-
-## HISTORY (Persistent Memory)
-
-### 2026-05-09 — Framework Initialization
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Initialized Agent Enderun framework and project structure.

package/.gemini/STATUS.md

@@ -1,10 +0,0 @@
-# AGENT STATUS
-
-| Agent | Status | Active Task | Last Update |
-| :--- | :--- | :--- | :--- |
-| @manager | IDLE | Framework setup | 2026-05-09 |
-| @analyst | IDLE | - | - |
-| @backend | IDLE | - | - |
-| @frontend | IDLE | - | - |
-| @explorer | IDLE | - | - |
-| @git | IDLE | - | - |