agent-enderun 1.1.3 → 1.1.5

package/dist/init-adapters/grok/.grok/knowledge/component-patterns.md

@@ -0,0 +1,91 @@
+# Atomic Component Standards & Panda CSS Guidelines (v0.8.5)
+
+All user interface developments inside the Agent Enderun framework must follow the **Fluid Component Protocol**. We strictly build component hierarchies following **Mobile-First Responsive Design** and type-safe styling using **Panda CSS**.
+
+---
+
+## 🚫 1. Absolute UI Policies
+
+### A. Zero UI Library Policy
+*   **The Law:** The use of external component libraries (e.g. TailwindCSS, Radix UI, Shadcn/ui, Material UI, Chakra UI, Ant Design) is strictly forbidden. 
+*   **The Reason:** This ensures absolute design authenticity, maximum bundle optimization, zero dependency bloat, and fully controlled accessibility (WCAG 2.2 AA).
+*   **Exception:** Low-level headless primitives (like `@radix-ui/react-dialog` for focus trapping or `sonner` for toast dispatchers) may be allowed, subject to direct approval by `@manager`.
+
+### B. Shared Component First Policy
+*   **The Law:** Defining reusable atomic components (Buttons, Inputs, Cards, Badges, Modals) inside page-level files is strictly forbidden.
+*   **The Structure:** All atomic items must be created inside `apps/web/src/components/ui/` as focused, single-purpose, highly modular components.
+
+---
+
+## 🐼 2. Panda CSS Styling Standards
+
+We utilize **Panda CSS** as our build-time type-safe CSS-in-JS engine. Raw inline styles or unmapped class names are completely banned.
+
+### A. Styling Token Best Practices
+Always leverage designated design tokens (colors, spacings, shadows) from the Panda config (`panda.config.ts`):
+
+```tsx
+import { css } from "../../styled-system/css";
+
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: "primary" | "secondary";
+}
+
+export function Button({ variant = "primary", className, children, ...props }: ButtonProps) {
+  return (
+    <button
+      className={css(
+        {
+          display: "inline-flex",
+          alignItems: "center",
+          justifyContent: "center",
+          px: "4",
+          py: "2.5",
+          borderRadius: "md",
+          fontSize: "sm",
+          fontWeight: "medium",
+          transition: "all 0.2s ease-in-out",
+          cursor: "pointer",
+          _disabled: { opacity: 0.5, cursor: "not-allowed" },
+        },
+        variant === "primary"
+          ? {
+              bg: "brand.primary",
+              color: "white",
+              _hover: { bg: "brand.primary.hover" },
+            }
+          : {
+              bg: "transparent",
+              color: "slate.700",
+              border: "1px solid",
+              borderColor: "slate.200",
+              _hover: { bg: "slate.50" },
+            }
+      )}
+      {...props}
+    >
+      {children}
+    </button>
+  );
+}
+```
+
+### B. Mobile-First Fluid Responsiveness
+Use array-based or object-based responsive syntax inside the `css` block. Never hardcode pixel values:
+
+```typescript
+// Enforce fluid flex layout across screen sizes
+const containerStyle = css({
+  display: "flex",
+  flexDirection: { base: "column", md: "row" }, // Mobile-first (column -> row on desktop)
+  gap: { base: "4", lg: "8" },
+  p: { base: "4", md: "6", xl: "8" }
+});
+```
+
+---
+
+## ♿ 3. Accessibility & QA Gates (WCAG 2.2)
+
+1.  **Aria Standards:** All custom interactive elements (dropdowns, mobile navigation draw-ins, accordion blocks) must support full keyboard navigation (Tab, Enter, Space) and have valid `aria-*` tags.
+2.  **Vitest Verification:** A component must never be merged into master without an accompanying test file (`[component].test.tsx`) that verifies the component renders correctly and responds to user click actions.

package/dist/init-adapters/grok/.grok/knowledge/data-fetching-patterns.md

@@ -0,0 +1,13 @@
+# Architecture Patterns & Data Fetching
+
+## 1. UI Layout & Component Structure
+- **Shared UI:** All atomic components (Button, Input, etc.) must be created in `apps/web/src/components/ui/` using **Panda CSS**.
+- **Layouts:** Use wrapper layouts (`Shell`, `Workspace`) in `apps/web/src/components/layout/`. Every page must utilize these layouts to maintain consistency.
+- **Procedural Continuity:** Never re-create an existing component. Search the `components/ui/` directory first.
+
+## 2. Data Fetching & API (CRUD) Patterns
+- **Repository Pattern:** Backend logic must be separated into service/repository layers. No direct DB calls in controllers.
+- **Contract-First:** All API endpoints must use types imported from `apps/backend/src/types/`.
+- **API Layer:** Frontend must use typed fetcher functions located in `apps/web/src/api/`.
+- **Validation:** Use `zod` for request validation on the backend and response validation on the frontend.
+- **Audit Logging:** Every mutation (POST/PUT/PATCH/DELETE) MUST trigger an audit log service call with the current Trace ID.

package/dist/init-adapters/grok/.grok/knowledge/design-system.md

@@ -0,0 +1,31 @@
+# Design System — Agent Enderun (Enterprise)
+
+## 1. Design Philosophy
+The Agent Enderun Design System focuses on **"Enterprise Clarity"**. Our interfaces are professional, minimalist tools designed to maximize data comprehension and operational speed. 
+
+- **Clarity:** Every pixel must serve a purpose. If it doesn't aid understanding or action, remove it.
+- **Consistency:** Uniform visual language across all applications.
+- **Responsiveness:** Fluid adaptation to any screen size, from mobile to ultra-wide monitors.
+
+## 2. Technical Requirements
+- **Styling:** Panda CSS is MANDATORY. Tailwind, CSS-in-JS, and raw CSS modules are FORBIDDEN.
+- **Zero UI Library:** No external components (MUI, AntD, Shadcn). All UI components must be built from scratch in `apps/web/src/components/ui/`.
+- **Tokenization:** All values (colors, spacing, typography) MUST use `panda.config.ts` tokens. NO hardcoded pixels.
+- **Responsiveness:** Mobile-First design is MANDATORY.
+
+## 3. Responsive Mandate (Mobile-First)
+- **Design Strategy:** Design for 320px width first.
+- **Breakpoints:**
+  - `sm`: 640px
+  - `md`: 768px
+  - `lg`: 1024px
+  - `xl`: 1280px
+  - `2xl`: 1536px
+- **Layouts:** Use Flexbox and Grid. Fixed widths are FORBIDDEN. Use `clamp()` for fluid typography and spacing where applicable.
+- **Reflow:** Content MUST gracefully wrap, stack, or collapse based on screen width without horizontal scrollbars.
+
+## 4. UI/UX Interaction Standards
+- **Interactions:** Hover, Active, and Disabled states are MANDATORY for all interactive elements.
+- **Feedback:** Async operations MUST show Loading states and Toast notifications on completion/error.
+- **Blocking Dialogues:** Native `alert()` and `confirm()` functions are **FORBIDDEN**. Use project-integrated `Modal` components for blocking user interactions and `Toaster` for non-blocking feedback.
+- **Focus:** All interactive elements must have a visible `focus` state for accessibility.

package/dist/init-adapters/grok/.grok/knowledge/enterprise-architecture.md

@@ -0,0 +1,69 @@
+# 🎖️ Agent Enderun — Enterprise Architecture & Standards
+
+This document establishes the architecture patterns, design guidelines, and code structures of the **Enderun Core Framework** for enterprise deployments.
+
+---
+
+## 🏛️ Project Directory Structure
+
+```text
+agent-enderun/
+├── bin/                       # Executable CLI entrypoints
+├── docs/                      # Technical documentation & design guides
+├── framework-mcp/             # Modular MCP server implementation (workspace)
+│   ├── src/                   # MCP server source files
+│   └── tests/                 # Unit tests for MCP server tools
+├── src/                       # CLI & Core framework logic
+│   ├── cli/                   # Command line interface commands & adapters
+│   │   ├── adapters/          # Target-specific IDE adapters (VS Code, Cursor, etc.)
+│   │   ├── commands/          # Subcommand handlers (init, status, check)
+│   │   └── utils/             # CLI-specific utilities
+│   ├── modules/               # Core framework modules
+│   │   ├── adapters/          # Target environment adapter profiles
+│   │   ├── agents/            # Orchestrator & Specialist Agent definitions
+│   │   └── skills/            # Capability templates for specialist actions
+│   └── shared/                # Core shared business components
+│       ├── config.ts          # Zod environment configuration
+│       ├── container.ts       # Dependency injection container
+│       ├── errors.ts          # Standard typed domain errors
+│       ├── fs.ts              # File system helper wrappers
+│       └── logger.ts          # Enterprise logging subsystem
+```
+
+---
+
+## ⚙️ Core Design Principles
+
+### 1. Unified Domain Errors
+All errors thrown by modules must inherit from `EnderunBaseError` in [src/shared/errors.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/errors.ts).
+This ensures:
+- Unique error codes (`CONFIGURATION_ERROR`, `VALIDATION_ERROR`, etc.)
+- Metadata enrichment via the `details` field
+- Structured JSON serialization in production environments
+
+### 2. Zod-Validated Environments
+Configuration options must never be read directly from raw environment variables (`process.env`). Instead, they are parsed and frozen inside [src/shared/config.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/config.ts) at initialization. If a required value is missing, the application crashes immediately with a clean explanation.
+
+### 3. Service Container (Dependency Injection)
+To write testable and decoupled code, singletons and factories are registered and resolved using the `ServiceContainer` defined in [src/shared/container.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/container.ts).
+```typescript
+import { container } from "./shared/container.js";
+
+// Register
+container.register("Logger", logger);
+
+// Resolve
+const logger = container.resolve<EnterpriseLogger>("Logger");
+```
+
+### 4. Structured Observability
+Use `EnterpriseLogger` in [src/shared/logger.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/logger.ts) for logging:
+- In **development**, logs are colorized and formatted for human readability.
+- In **production**, logs are structured as JSON for log aggregators (e.g. Datadog, ELK).
+
+---
+
+## 🛡️ Code & Type Guidelines
+- **Strict Typing:** Always keep `"strict": true` in `tsconfig.json`. Explicit return types are required on all exports.
+- **Asynchronous Flow:** Use async/await over raw promise chains. Handle failures with localized try/catch blocks and wrap in domain errors.
+- **Atomic Operations:** Always use transactional or surgical replacements when editing configuration/code files.

package/dist/init-adapters/grok/.grok/knowledge/error-handling.md

@@ -0,0 +1,74 @@
+# Professional Domain Error Handling Pattern (v0.8.5)
+
+All backend components developed under the Agent Enderun framework must comply with the **Domain Error Handling Protocol**. Direct usage of generic Javascript `Error` objects or HTTP status codes inside domain services is strictly forbidden.
+
+---
+
+## 🏛️ 1. DomainError Base Hierarchy
+
+We implement a strongly-typed, business-aware exception hierarchy. Every error thrown by the domain logic must inherit from the `DomainError` class.
+
+```typescript
+export abstract class DomainError extends Error {
+  public abstract readonly statusCode: number;
+  public abstract readonly errorCode: string;
+  public readonly timestamp: string;
+
+  constructor(message: string, public readonly metadata: Record<string, unknown> = {}) {
+    super(message);
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = this.constructor.name;
+    this.timestamp = new Date().toISOString();
+  }
+}
+```
+
+### Core Exception Catalog
+
+*   **`NotFoundError` (HTTP 404):** Thrown when a resource (e.g., `User`, `Project`) identified by a **Branded Type ID** does not exist.
+*   **`ValidationError` (HTTP 400):** Thrown when data validation (usually Zod schemas) fails before processing business logic.
+*   **`ConflictError` (HTTP 409):** Thrown when database unique constraints or concurrent updates conflict.
+*   **`UnauthorizedError` (HTTP 401 / 403):** Thrown when RLS (Row Level Security) or RBAC policies are violated.
+
+---
+
+## ⚡ 2. Fastify Global Exception Handler
+
+Fastify must be configured with a single central error handler to map `DomainError` to client responses safely, preventing internal stack traces from leaking to the outside world.
+
+```typescript
+import { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
+
+export function registerGlobalErrorHandler(server: FastifyInstance) {
+  server.setErrorHandler((error: Error, request: FastifyRequest, reply: FastifyReply) => {
+    if (error instanceof DomainError) {
+      server.log.warn({ err: error }, `Domain error: ${error.message}`);
+      return reply.status(error.statusCode).send({
+        success: false,
+        error: error.errorCode,
+        message: error.message,
+        timestamp: error.timestamp,
+        metadata: error.metadata
+      });
+    }
+
+    // Capture unhandled internal technical crashes
+    server.log.error({ err: error }, `Unhandled server crash: ${error.message}`);
+    return reply.status(500).send({
+      success: false,
+      error: "INTERNAL_SERVER_ERROR",
+      message: "An unexpected error occurred inside the system."
+    });
+  });
+}
+```
+
+---
+
+## 🔒 3. Branded Types & Query Constraints
+
+1.  **Branded Type Enforcement:** You must never accept raw string IDs inside repository query parameters. Always enforce compile-time type safety:
+    ```typescript
+    export type UserId = string & { readonly __brand: unique symbol };
+    ```
+2.  **Kysely Query Failures:** All Kysely queries running inside database transactions must be wrapped inside a `try/catch` block that translates SQL constraints into precise `ConflictError` or `UnauthorizedError` entities instead of throwing raw database query failures.

package/dist/init-adapters/grok/.grok/knowledge/eslint-standards.md

@@ -0,0 +1,10 @@
+# 🎖️ Agent Enderun — ESLint Standards
+
+This document outlines the strict ESLint coding standards for Agent Enderun projects.
+
+## 📏 Core Rules
+- **Indentation:** 4 spaces (strict).
+- **Quotes:** Double quotes (`"`) for strings.
+- **Semicolons:** Always terminate statements with a semicolon (`;`).
+- **No Explicit Any:** Avoid using `any`. Use strongly typed interfaces, generics, or `unknown` with type assertions.
+- **Unused Variables:** Warning on unused variables unless prefixed with an underscore (`_`).

package/dist/init-adapters/grok/.grok/knowledge/logging.md

@@ -0,0 +1,7 @@
+# Logging & Audit Standard
+
+- **No Console.log:** Production code MUST NOT use `console.log`, `console.warn`, or `console.error`. These are FORBIDDEN in the codebase.
+- **Structured Logging:** All logging MUST go through the centralized `Logger` service (`apps/backend/src/services/logger.ts`). Logs must be produced in JSON format.
+- **Traceability:** Every log entry MUST include the active `traceId` context to ensure cross-agent and cross-service traceability.
+- **Audit Logging:** Every state-mutating operation (POST, PUT, PATCH, DELETE) MUST trigger an `AuditService.log()` call, linking the action to the responsible agent, Trace ID, and entity ID.
+- **Log Persistence:** Logs must be persisted in an structured manner suitable for downstream ingestion by log management systems.

package/dist/init-adapters/grok/.grok/knowledge/tech-stack.md

@@ -0,0 +1,9 @@
+# Tech Stack — Agent Enderun (Enterprise)
+
+- **Execution Profile:** Full (Enterprise)
+- **Frontend:** React (Vite), Panda CSS (Zero UI Library)
+- **Backend:** Fastify API, Kysely (Query Builder)
+- **Database:** PostgreSQL
+- **Testing:** Vitest (Integration + Unit)
+- **Auth:** Contract-first (Type definitions)
+- **Versioning:** API-path versioning (/api/v1/...)

package/dist/init-adapters/grok/.grok/memory/DECISIONS.md

@@ -0,0 +1,10 @@
+# 🏛️ Architectural Decisions Log (ADR)
+
+This file contains the fixed architectural choices and constraints for this project.
+
+## Decided Constraints
+- **Framework Integration:** Agent Enderun is the primary governance and orchestration layer.
+- **Language & Runtime:** TypeScript on Node.js.
+- **Package Manager:** npm.
+- **Monorepo Structure:** Monorepo using npm workspaces.
+- **Styling:** Panda CSS.

package/dist/init-adapters/grok/.grok/memory/PROJECT_MEMORY.md

@@ -1,7 +1,7 @@
 ## CURRENT STATUS
 
 - Phase: PHASE_0 (Genesis)
-- Trace ID: 01KTBKQYFRGM5HB6W68KW1F014
+- Trace ID: 01KTCDPF68ZBFJTMTVVYX14ZFF
 
 ## HISTORY
 ### 2026-06-05 — Initialization

package/dist/init-adapters/grok/.grok/observability/audit_log.md

@@ -0,0 +1,5 @@
+# 🕵️ Agent Enderun — Audit Log
+
+This log tracks all asynchronous agent communication and state transitions handled by the Hermes Message Broker.
+
+## Hermes Event Log

package/dist/init-adapters/grok/.grok/observability/telemetry.md

@@ -0,0 +1,6 @@
+# 📊 Agent Enderun — Telemetry & Memory Observability
+
+## 🧠 Context & Token Observability
+- **Memory File:** `.grok/memory/PROJECT_MEMORY.md` (SSOT)
+- **Pruning Trigger:** Active history entries are pruned and archived under `.grok/memory-graph/archive/` once the log exceeds 10 records.
+- **Audit Logs:** Agent interactions are saved locally inside `observability/audit_log.md` to keep API usage transparent and track performance bottlenecks.

package/dist/init-adapters/grok/.grok/registry/agent_registry.md

@@ -0,0 +1,18 @@
+# 🎖️ Agent Enderun — Army Registry
+
+List of active agents, their roles, capacities, and matching directory patterns.
+
+| Agent Name | Role | Scope / Globs | Action Compliance |
+|---|---|---|---|
+| `@manager` | Orchestrator & Controller | `*` | Rules Verification |
+| `@quality` | Quality & Test Enforcer | `*` | AST Security Scans |
+| `@database` | Database Optimizer | `apps/backend/src/database/**/*` | Schema & Migrations |
+| `@backend` | Core Domain Developer | `apps/backend/**/*` | Branded Types & APIs |
+| `@frontend` | UI/UX Developer | `apps/web/**/*` | Panda CSS, Fluid UI |
+| `@mobile` | Mobile App Specialist | `apps/mobile/**/*` | Expo/React Native |
+| `@native` | Desktop / Native Integrator | `apps/native/**/*` | Electron/Tauri |
+| `@devops` | Deployment & CI/CD | CI/CD YAML & Deployment files | Native Rollbacks |
+| `@explorer` | Codebase Discovery | All source directories | Onboarding & Audit |
+| `@git` | Version Control System | `.git/` & Commit traces | Trace ID commits |
+| `@security` | Security Officer | All source directories | RLS & Secrets Scan |
+| `@analyst` | Contract Validator | Contract and API schema definitions | SHA-256 validation |

package/dist/init-adapters/grok/.grok/router/routing_rules.md

@@ -0,0 +1,8 @@
+# 📡 Agent Enderun — Natural Language & Event Router
+
+This configuration governs how user inputs and event messages are routed across the 12 expert agents.
+
+## 🧭 Routing Engine Protocols
+- **User Input Routing:** By default, all un-targeted natural language prompts are routed to the `@manager` agent for analysis and decomposition into a Directed Acyclic Graph (DAG) task list.
+- **Targeted Input Routing:** Prompts beginning with `@<agent_name>` (e.g., `@backend`) bypass the general manager routing and are directly appended to the target agent's Hermes mailbox.
+- **Hermes Event Loops:** Agents publish status changes and handoffs which the message broker routes dynamically according to active dependencies.

package/dist/init-adapters/grok/.grok/rules/analyst.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @analyst (Business Analyst)
+
+You are the **Business Analyst** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @analyst)
+Audit of truth and contracts within the Army.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/architect.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @architect (Lead Architect)
+
+You are the **Lead Architect** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @architect)
+Design the project's foundation. Design must be flawless and adhere to the Nizam.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/backend.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @backend (Backend Specialist)
+
+You are the **Backend Specialist** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @backend)
+Focus on server logic and databases. Any deviation from the Ferman is a breach of discipline.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/database.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @database (Database Specialist)
+
+You are the **Database Specialist** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @database)
+Manage data as the empire's treasury. Secure and optimized.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/devops.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @devops (Infrastructure Specialist)
+
+You are the **Infrastructure Specialist** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @devops)
+Maintain reliable supply lines and systems like fortresses.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/explorer.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @explorer (Intel Explorer)
+
+You are the **Intel Explorer** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @explorer)
+Gather tactical intelligence and map dependencies for the Manager.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/frontend.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @frontend (Frontend Specialist)
+
+You are the **Frontend Specialist** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @frontend)
+Build elegant and disciplined UIs with master craftsmanship.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/git.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @git (Logistics Master)
+
+You are the **Logistics Master** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @git)
+Manage the scrolls of history. Every commit must be atomic and traceable.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/manager.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @manager (Manager (Orchestrator))
+
+You are the **Manager (Orchestrator)** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @manager)
+You represent the Enderun Discipline (Osmanlı Nizami). Your word is the law for the specialists. Delegate tasks with precision.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/mobile.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @mobile (Mobile Specialist)
+
+You are the **Mobile Specialist** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @mobile)
+Extend reach to the mobile realm with discipline.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/native.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @native (Native Division)
+
+You are the **Native Division** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @native)
+Handle deep layers of the OS with paramount security.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/quality.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @quality (Quality Specialist)
+
+You are the **Quality Specialist** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @quality)
+You are the inspector of the Nizam. Ensure every unit's work is perfect.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.

package/dist/init-adapters/grok/.grok/rules/security.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @security (Security Specialist)
+
+You are the **Security Specialist** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.grok/ENDERUN.md`](`.grok/ENDERUN.md`)
+2. **Global Rules:** [`.grok/knowledge/ARCHITECTURE.md`](`.grok/knowledge/ARCHITECTURE.md`), [`.grok/knowledge/SECURITY.md`](`.grok/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.grok/memory/PROJECT_MEMORY.md`](`.grok/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @security)
+Guardian of the Nizam. block any action that endangers the project.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.