agent-enderun 0.0.1

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "agent-enderun",
+  "version": "0.0.1",
+  "type": "module",
+  "bin": {
+    "agent-enderun": "./bin/cli.js"
+  },
+  "scripts": {
+    "enderun:build": "npm run build --prefix packages/shared-types && npm run build --prefix packages/framework-mcp"
+  }
+}

package/packages/framework-mcp/README.md

@@ -0,0 +1,95 @@
+# AI-Enderun MCP Server v0.1.5
+
+English | [Türkçe](#türkçe)
+
+The `ai-enderun-mcp` package implements the Model Context Protocol server for AI-Enderun. It enables AI clients to inspect the repository, enforce conventions, manage project memory, and verify shared contract integrity.
+
+## English
+
+### Purpose
+
+This package is the intelligence bridge between AI clients and the local repository. It gives agents structured access to repository state, rules, and verification tools.
+
+### What it provides
+
+- **Framework Status & Memory:** Evaluates active phase, trace IDs, and project history.
+- **Search & Analysis:** AST-powered code search, dependency analysis, and pattern discovery.
+- **Contract Verification:** Confirms shared types and API contracts match the stored hash.
+- **Security Auditing:** Detects unsafe patterns such as raw SQL, console logs, and `any` usage.
+- **Structured Logging:** Centralized JSON logs for agent actions and traceability.
+
+### Tools exposed to agents
+
+- `get_framework_status`
+- `search_codebase`
+- `analyze_dependencies`
+- `get_memory_insights`
+- `update_project_memory`
+- `get_project_gaps`
+- `security_audit_scan`
+- `verify_api_contract`
+- `update_contract_hash`
+- `log_agent_action`
+
+### Development
+
+```bash
+cd packages/framework-mcp
+npm install
+npm run build
+npm run dev
+```
+
+### Integration role
+
+This package interprets and verifies:
+
+- `.gemini/` or chosen adapter directories for agent SOPs and configuration.
+- `docs/` for project requirements and API contract definitions.
+- `packages/shared-types/` for contract-first type validation.
+
+## Türkçe
+
+`ai-enderun-mcp`, AI-Enderun için Model Context Protocol (MCP) sunucusunu sağlar. AI istemcilerinin depoyu incelemesi, kuralları denetlemesi, proje hafızasını yönetmesi ve paylaşılan kontrat bütünlüğünü doğrulaması için yapılandırılmış bir arayüz sunar.
+
+### Ne sağlar?
+
+- **Framework Durumu & Hafıza:** Aktif faz, trace ID'leri ve proje geçmişi değerlendirmesi.
+- **Arama & Analiz:** AST destekli kod arama, bağımlılık analizi ve desen keşfi.
+- **Kontrat Doğrulama:** Paylaşılan tipler ve API sözleşmelerinin kayıtlı hash ile uyumunu kontrol eder.
+- **Güvenlik Denetimi:** Raw SQL, console.log ve `any` kullanımı gibi güvensiz modelleri tespit eder.
+- **Yapısal Loglama:** Ajan eylemleri için merkezi JSON tabanlı takip.
+
+### Araçlar
+
+- `get_framework_status`
+- `search_codebase`
+- `analyze_dependencies`
+- `get_memory_insights`
+- `update_project_memory`
+- `get_project_gaps`
+- `security_audit_scan`
+- `verify_api_contract`
+- `update_contract_hash`
+- `log_agent_action`
+
+### Geliştirme
+
+```bash
+cd packages/framework-mcp
+npm install
+npm run build
+npm run dev
+```
+
+### Entegrasyon rolü
+
+Bu paket şunları yorumlar ve doğrular:
+
+- Ajan SOP’ları ve yapılandırma için `.gemini/` veya seçilen adaptör dizinleri.
+- Proje gereksinimleri ve API sözleşmeleri için `docs/`.
+- Kontrat-öncelikli tip doğrulaması için `packages/shared-types/`.
+
+## License
+
+MIT

package/packages/shared-types/README.md

@@ -0,0 +1,84 @@
+# AI-Enderun Shared Types v0.1.5
+
+English | [Türkçe](#türkçe)
+
+The `@ai-enderun/shared-types` package is the core contract layer of AI-Enderun. It defines the shared data model, API request/response shapes, and branded identifiers that backend and frontend agents must agree on before implementation.
+
+## English
+
+### Purpose
+
+This package prevents contract drift and enforces a contract-first workflow across the entire repository. It is the single source of truth for typed API boundaries, domain IDs, and common response shapes.
+
+### Why it matters
+
+- Ensures frontend and backend agree on the same data structures.
+- Avoids duplicate type definitions across implementations.
+- Supports traceable API contract validation with `contract.version.json`.
+- Makes AI-assisted development safer and more predictable.
+
+### Principles
+
+- **Contract-First:** Define shared types before implementation.
+- **Branded Identifiers:** Use domain-specific IDs such as `UserID` and `SessionID`.
+- **Explicit Response Shapes:** Keep success and error payloads consistent.
+- **ULID Support:** Native support for sortable 26-character identifiers.
+- **Hash Verification:** Recalculate and verify the contract hash whenever shared types change.
+
+### Development
+
+```bash
+cd packages/shared-types
+npm install
+npm run build
+npm run typecheck
+```
+
+### Usage
+
+```typescript
+import { ApiResponse, SessionID, UserID } from "@ai-enderun/shared-types";
+```
+
+### Contract Workflow
+
+1. Modify or add types in `packages/shared-types/src/index.ts`.
+2. Build the package and confirm consuming code compiles.
+3. Update `packages/shared-types/contract.version.json` whenever the shared surface changes.
+4. Document related endpoint contracts in `{{FRAMEWORK_DIR}}/docs/api/`.
+
+## Türkçe
+
+`@ai-enderun/shared-types`, AI-Enderun’un paylaşılan kontrat katmanıdır. Backend ve frontend ajanlarının ortaklaşa uzlaşması gereken veri modellerini, API istek/yanıt biçimlerini ve branded kimlikleri tanımlar.
+
+### Amaç
+
+Bu paket, kontrat kaymasını önler ve depo genelinde kontrat-öncelikli bir iş akışı sağlar. Ortak türler, domain ID’leri ve yanıt yapıları için tek kaynak olarak çalışır.
+
+### Neden önemli?
+
+- Frontend ve backend’in aynı veri yapıları üzerinde anlaşmasını sağlar.
+- Tekrarlanan tip tanımlarını engeller.
+- `contract.version.json` ile API sözleşmesi doğrulanmasını destekler.
+- AI destekli geliştirmeyi daha güvenli ve öngörülebilir hale getirir.
+
+### İlkeler
+
+- **Önce Kontrat:** Ortak tipler uygulanmadan önce tanımlanır.
+- **Branded Kimlikler:** `UserID`, `SessionID` gibi domain-özel kimlikler kullanılır.
+- **Açık Yanıt Şekilleri:** Başarı ve hata yükleri tutarlı tutulur.
+- **ULID Desteği:** 26 karakterlik sıralanabilir kimlikler.
+- **Hash Doğrulama:** Paylaşılan tipler değiştiğinde kontrat hash’i güncellenir.
+
+### Geliştirme
+
+```bash
+cd packages/shared-types
+npm install
+npm run build
+npm run typecheck
+```
+
+## License
+
+MIT

package/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - 'apps/*'
+  - 'packages/*'