agent-enderun 0.7.5 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -8,9 +8,9 @@ This dashboard provides a high-level overview of the Army's performance, quality
8
8
 
9
9
  | Metric | Current Value | Status |
10
10
  | :--- | :--- | :--- |
11
- | **Global Success Rate** | 92% (last 50 traces) | 🟢 Healthy |
12
- | **Active Trace IDs** | 1 (ENR-ARMY-001) | 🟡 In Progress |
13
- | **Agent Velocity** | 4.2 tasks/day | 🟢 Good |
11
+ | **Global Success Rate** | 100% | 🟢 Healthy |
12
+ | **Active Trace IDs** | 0 | 🟢 None |
13
+ | **Agent Velocity** | | |
14
14
  | **Contract Integrity** | 100% | ✅ Valid |
15
15
  | **Army Size** | 12 agents | ✅ Complete |
16
16
 
@@ -18,8 +18,8 @@ This dashboard provides a high-level overview of the Army's performance, quality
18
18
 
19
19
  ## 🛡️ Quality & Security
20
20
 
21
- - **Security Audit Status**: 🟢 Clean (Last scan: 2026-05-25)
22
- - **Constitution Compliance**: 🔵 100% (Last audit: 2026-05-25)
21
+ - **Security Audit Status**: 🟢 Clean (Last scan: 2026-05-26)
22
+ - **Constitution Compliance**: 🔵 100% (Last audit: 2026-05-26)
23
23
  - **Documentation Debt**: 🟢 Low (v1.0 English standardization complete)
24
24
 
25
25
  ---
@@ -39,7 +39,6 @@ This dashboard provides a high-level overview of the Army's performance, quality
39
39
  | Version | Date | Description | Hash |
40
40
  | :--- | :--- | :--- | :--- |
41
41
  | v1.0.0-alpha | 2026-05-25 | Full 12-Agent Army + Memory Graph + Orchestration MCP | `sha256:army-v1` |
42
- | v0.2.0 | 2026-05-11 | Initial v0.2.0 Baseline | `sha256:current-baseline` |
43
42
 
44
43
  ---
45
44
 
@@ -6,134 +6,41 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
6
6
 
7
7
  | Active Phase | Profile | Last Update | Active Trace ID | Blockers |
8
8
  | :----------- | :------ | :---------- | :-------------- | :------- |
9
- | ARMY_COMPLETE | Full | 2026-05-25 | ENR-ARMY-001 | NONE |
9
+ | PHASE_0 | Full | 2026-05-26 | NONE | NONE |
10
10
 
11
11
  ## PROJECT DEFINITION
12
12
 
13
13
  | Field | Value |
14
14
  | :--- | :--- |
15
- | Project Name | kentim |
16
- | Platform | Web (SaaS) + Mobile (React Native CLI) |
17
- | Frontend | React 19 + Vite + Panda CSS |
18
- | Backend | Node.js 20+ + Fastify (Full RCSR Architecture) |
19
- | DB | PostgreSQL (Multi-Tenant RLS + PostGIS) |
15
+ | Project Name | [Your Project Name] |
16
+ | Platform | [e.g., Web (SaaS) / Mobile (React Native) / Desktop] |
17
+ | Frontend | [e.g., React 19 + Vite + Panda CSS / Next.js] |
18
+ | Backend | [e.g., Node.js 20+ + Fastify (Full RCSR Architecture)] |
19
+ | DB | [e.g., PostgreSQL / SQLite] |
20
20
 
21
21
  ## DOD STATUS
22
22
 
23
23
  | Phase | Status | Note |
24
24
  | :--- | :--- | :--- |
25
- | PHASE_0 | COMPLETED | Framework and structure initialized |
26
- | PHASE_1 | COMPLETED | Core Multi-Tenant API & State Machine implemented |
27
- | PHASE_2 | COMPLETED | Full UI, Public Map Pivot & Operational Maturity |
28
- | PHASE_3 | COMPLETED | Advanced Analytics & Management Depth (Sıfır Mock) |
29
- | PHASE_4 | COMPLETED | Constitutional Alignment & Final Audit |
25
+ | PHASE_0 | PENDING | Discovery & Setup |
26
+ | PHASE_1 | PENDING | Architecture & Contracts |
27
+ | PHASE_2 | PENDING | Core Development |
28
+ | PHASE_3 | PENDING | Integration & Testing |
29
+ | PHASE_4 | PENDING | Optimization & Deployment |
30
30
 
31
31
  ## CRITICAL DECISIONS
32
32
 
33
33
  | Date | Decision | Rationale | Agent |
34
34
  | :--- | :--- | :--- | :--- |
35
- | 2026-05-20 | Project Initialized | Framework setup via CLI | @manager |
36
- | 2026-05-21 | No Docker Support | Direct system execution for performance | @manager |
37
- | 2026-05-21 | Public Map Pivot | Open reports with coordinate fuzzing for transparency | @manager |
38
- | 2026-05-21 | Zero Mock Policy | All analytical and management UIs connected to real APIs | @manager |
39
- | 2026-05-21 | UI Standardization | Unified UI component library (Button, Card, Badge, Input, Map) across all 3 web apps | @manager |
35
+ | 2026-05-26 | Framework Cleanup | Pristine memory state established for npmjs publish. | @manager |
40
36
 
41
37
  ## DELIVERABLES
42
38
 
43
39
  | Module | Status | Agent | Date |
44
- | :--- | :--- | :--- | :--- | :--- |
45
- | Backend Core Logic | COMPLETED | @backend | 2026-05-21 |
46
- | Advanced Analytics API | COMPLETED | @manager | 2026-05-21 |
47
- | Visual Daily Plan | COMPLETED | @manager | 2026-05-21 |
48
- | Crisis Management | COMPLETED | @manager | 2026-05-21 |
49
- | Dispute Center | COMPLETED | @manager | 2026-05-21 |
50
- | Central Reports | COMPLETED | @manager | 2026-05-21 |
40
+ | :--- | :--- | :--- | :--- |
51
41
 
52
42
  ## HISTORY (Persistent Memory)
53
43
 
54
- ### 2026-05-25Agent Army v1.0 — Full Ordu İmplementasyonu
55
- - **Agent:** @manager (via @orchestrator)
56
- - **Trace ID:** ENR-ARMY-001
57
- - **Action:** Completed the full Agent Army v1.0 implementation. Expanded the army from 8 to 12 agents by adding `@orchestrator` (9.8 capability, DAG-based task engine), `@security` (9.3, OWASP auditor), `@qa` (9.1, quality gate enforcer), and `@devops` (9.0, deployment orchestration). Added 3 new MCP tool modules with 13 new tools: `orchestration.ts` (5 tools), `monitoring.ts` (4 tools), `pipeline.ts` (4 tools). Established the Agent Memory Graph infrastructure (graph.json, shared-facts.json, 12 agent context files). Created file-based async task queue (.enderun/queue/) with pending/processing/completed/failed/pipelines subdirectories. Unlocked the army schema enum constraint for extensible agent naming. Added formal agent lifecycle state machine (agent-lifecycle-schema.json). Updated STATUS.md, AGENTS_STRUCTURE.md, CHANGELOG.md with v1.0-alpha release notes.
58
-
59
- ### 2026-05-21 — Final Management & Analytics Depth
60
- - **Agent:** @manager
61
- - **Action:** Completed the last architectural layer of the project. Implemented Visual Daily Planning for Chiefs, Advanced Analytics (Charts/Heatmaps) for Admins, and a real-time Disaster Crisis Map. All systems are now 100% connected to backend APIs with zero mock data. The project is fully compliant with the Kentim Constitution.
62
-
63
-
64
- ### 2026-05-21 — Import Refactoring Completion
65
- - **Agent:** @manager
66
- - **Action:** Systematically scanned all `.ts` and `.tsx` files within `apps/web/municipal/src` for relative imports (`../`). Multiple `grep` commands with varying patterns were executed. No remaining deep relative imports were found. The refactoring task for this module is concluded.
67
-
68
- ### 2026-05-21 — Comprehensive Web Import Clean-up
69
- - **Agent:** @manager
70
- - **Action:** Addressed newly identified import issues across `apps/web/central`, `apps/web/citizen-web`, and `apps/web/municipal`. Verified no extraneous spaces in import paths. Fixed deep relative imports in `apps/web/central/src/pages/Reports.tsx` for `DashboardLayout`, `Card`, `Badge`, and `styled-system` components by converting them to alias imports. Performed comprehensive searches for deep relative imports (e.g., `../../../`, `../../`, `../`) targeting known alias-able directories (`layouts`, `components`, `pages`, `hooks`, `styled-system`) across all three web projects, confirming no further issues were found. All web projects are now confirmed clean of these specific import problems.
71
-
72
- ### 2026-05-23 — Resolved Vite Import-Analysis Shadowing & Relative Imports
73
- - **Agent:** @manager
74
- - **Action:** Fixed critical Vite import-analysis failure caused by alias shadowing in all three web projects (municipal, citizen-web, central). The generic `@` alias was shadowing `@/styled-system` and `@styled-system` imports, causing them to incorrectly map inside `./src`. Reordered the alias configurations so specific paths are evaluated first, and aligned all `tsconfig.json` path mappings to support both importing patterns. Additionally, resolved all remaining fragile relative imports (e.g. `../../../components/ui/...`) and incorrect cross-package imports (e.g. `../../../../municipal/...`) inside the `central` app's pages (`DisasterMode.tsx`, `Login.tsx`, `Municipalities/List.tsx`, `Users/List.tsx`, `Dashboard.tsx`, `AuditLogs/List.tsx`) by converting them to standard, robust `@/` alias imports.
75
-
76
- ### 2026-05-23 — Global Layout Refactoring & HTML5 Semantic Main Alignment
77
- - **Agent:** @manager
78
- - **Action:** Refactored the layout architecture for both `central` and `municipal` web projects. Established `DashboardLayout` as a global layout wrapper in the routing tree (`App.tsx`), eliminating re-mounting performance issues on route transitions. Implemented an elegant `DashboardLayoutContext` stateful nested bypass mechanism, allowing existing manual page-level layout wraps to be rendered transparently as pass-throughs without duplicate sidebars or headers. Aligned municipal layouts to standard HTML5 semantic elements by converting the content view container into a `<main>` tag, satisfying high-quality SEO practices and ensuring all rendered pages are opened cleanly inside `<main>`.
79
-
80
- ### 2026-05-23 — Implemented Duplicate Report Consolidation & Gap Audit
81
- - **Agent:** @manager
82
- - **Action:** Audited the entire project implementation against the project's constitutional files inside `docs/`. Discovered that the Duplicate Report Consolidation (`markAsDuplicate`) service logic was missing from the backend service even though the controller endpoint was declared. Surgically implemented `markAsDuplicate` in `work-orders.service.ts` to merge duplicate reports under a parent work order, transition them to `resolved`, and write audit traces. Also added automated cascade resolution so that when a parent work order is resolved, all associated duplicate child reports are automatically resolved. Identified outstanding gaps: missing 24-hour `x-idempotency-key` validation for POST/PATCH requests, and missing custom citizen rating/star feedback columns in the database.
83
-
84
- ### 2026-05-23 — Linked Rating and Star Feedback Endpoints
44
+ ### 2026-05-26Framework Cleanup
85
45
  - **Agent:** @manager
86
- - **Action:** Surgically linked and exposed the newly developed citizen feedback/star rating endpoints in both the Fastify controller (`work-orders.controller.ts`) and router (`work-orders.routes.ts`) for the municipal application. Citizens can now submit 1-5 star ratings, which triggers the automatic task-reopening loop with a limit of 2 reopens on 1-2 star reviews.
87
-
88
- ### 2026-05-23 — Seeder Optimizations & Temporary DB Scripts Cleanup
89
- - **Agent:** @manager
90
- - **Action:** Optimized Kysely seeders for both municipal and central backends by importing Node's native `crypto` module, resolving runtime reference errors on `crypto.randomUUID()`. Neutralized and cleaned up all temporary/obsolete database testing and migration scripts from the root directory and central backend (`migrate-work-plans.js`, `create-dbs.js`, `scratch_check_tables.js`, `scratch_install.js`, `scratch_test_db.js`, `apps/backend/central/check-users.ts`) to ensure the codebase remains clean, standardized, and strictly powered by Kysely migrations and seeders.
91
-
92
- ### 2026-05-23 — Phase 1 Gap Remediation: Core Backend Infrastructure
93
- - **Agent:** @manager (via @backend)
94
- - **Action:** Completed Phase 1 of the gap remediation plan. Implemented a global **Idempotency Middleware** using `x-idempotency-key` for all write operations, ensuring 24-hour duplicate prevention. Refactored the **SLA Worker** to calculate business hours based on tenant-specific configurations (working days/hours), with automatic 7/24 bypass for crisis/urgent tasks. Implemented a full **Cron-based Scheduler** using the `croner` library, supporting daily, weekly, monthly, and custom frequencies with execution logging and concurrency protection. Updated API documentation to reflect these changes.
95
-
96
- ### 2026-05-23 — Phase 2 Gap Remediation: Automated Systems & Logic
97
- - **Agent:** @manager (via @backend)
98
- - **Action:** Completed Phase 2 of the gap remediation plan. Implemented **Dynamic IoT Mapping & Parser** with a sandboxed Node `vm` execution environment for custom scripts, allowing municipalities to map arbitrary JSON payloads to Kentim standards. Created a **RetentionWorker** to automate media archiving (6-month compression, 1-year deletion) and long-term audit log archival (3-year rule). Integrated **Role Change Cleanup Triggers** into the User service, automatically re-pooling active tasks when managers or chiefs are deactivated or moved, ensuring 100% operational continuity.
99
-
100
- ### 2026-05-23 — Phase 3 Gap Remediation: Admin UI & UX Completion
101
- - **Agent:** @manager (via @generalist)
102
- - **Action:** Completed Phase 3 and the final stage of the gap remediation plan. Implemented the **Shift Handover (Vardiyayı Kapat)** UI for both Saha Personnel and Chiefs, enabling formal task handover with confirmation modals. Developed the **IoT GUI Mapper** interface, allowing admins to configure JSON mappings and parser scripts directly from the panel. Created a comprehensive **Audit Log Listing** page with advanced filters (Action, Actor, Date). Integrated all automated background tasks (SLA, Scheduler, Retention) into the application's main entry point, ensuring full system-wide automation. The project is now 100% compliant with the documented specifications.
103
-
104
- ### 2026-05-23 — Phase 3 Gap Remediation: Admin UI & UX Completion
105
- - **Agent:** @manager (via @generalist)
106
- - **Action:** Completed Phase 3 and the final stage of the gap remediation plan. Implemented the **Shift Handover (Vardiyayı Kapat)** UI for saha personnel and chiefs, enabling formal task devir with confirmation modals. Developed the **IoT GUI Mapper** interface, allowing admins to configure JSON mappings and parser scripts directly from the panel. Created a comprehensive **Audit Log Listing** page with advanced filters (Action, Actor, Date). Verified that all 7 identified gaps are now fully implemented, tested, and integrated into the municipal application. The project is now 100% compliant with the documented specifications.
107
-
108
- ### 2026-05-23 — Constitutional UI/UX Documentation Alignment
109
- - **Agent:** @manager
110
- - **Action:** Surgically updated the `yapı.md` UI/UX specification document within `/docs` to align with the core public map requirements, +1 voting, and GDPR cascades. Integrated all remaining 5 gaps (support count metrics in Analytics, public action event types in Audit Logs, the 6 configurable settings in Municipality Settings, the public visibility toggle in Central Global Categories, and page inventory count) directly into the main body of the document. Verified all 5 markdown files are now 100% compliant with the project's constitutional design.
111
-
112
- ### 2026-05-23 — Advanced Leaflet Settings & Full CRUD Lifecycle Alignment
113
- - **Agent:** @manager
114
- - **Action:** Addressed the comprehensive list of 20 architectural & CRUD documentation gaps in `yapı.md` identified during the final audit. Defined specific Leaflet Map configurations: tile provider (CartoDB Positron/Carto Light), zoom-tier data granularities (Zoom 8-10, 11-13, 14-16, 17+), automatic nearest-belediye GPS startup and border crossing viewport transition logic, Leaflet popup preview vs slide-over drawer modal overlays, and Cap 3 KVKK explicit consent text details. Fully specified deactivation and deletion lifecycles (hard delete prohibitions, active-work checks, or worker task re-pooling) for teams, personnel, cron schedule templates, IoT integration sources/devices, announcements, idea moderation, central municipalities, central users, and internal notes. Cleared out redundant EK appendices.
115
-
116
- ### 2026-05-23 — Final Constitutional Validation & 100% Verification Complete
117
- - **Agent:** @manager
118
- - **Action:** Performed a final comprehensive cross-file verification audit on all 5 markdown documents (`is_akislari.md`, `proje.md`, `moduller.md`, `mimari.md`, `yapı.md`) in `docs/`. Confirmed that all 47 originally identified gaps and subsequent technical expansions—including the 3 backend technical validations (idempotency, public API data masking/coordinates fuzzing, global category public override) and the pre-validation geofence/proximity branching in the Akış 1 Mermaid diagram—are 100% integrated directly into their main bodies. The constitutional specification suite is now completely unified, verified, and concluded.
119
-
120
- ### 2026-05-23 — Codebase Audit Against the KENTİM Constitution
121
- - **Agent:** @manager
122
- - **Action:** Conducted a comprehensive codebase compliance audit of all Fastify backend routes, services, Kysely repositories, and React components against the finalized KENTİM Constitution files in `docs/`. Identified 6 critical implementation gaps: missing `support_votes` deletion cascade on GDPR citizen removal, absence of the Redis caching layer (`public_map:{tenant_id}:{bbox_hash}`) and its event-driven invalidation logic, lack of a 15-minute backend lock on internal notes, missing application-level hard-delete blocks on work orders/reports, missing CartoDB tile map overlays, boundary-checks and slide-over drawers on the citizen map, and missing worker deactivation re-pooling hooks. Stored the comprehensive findings in the workspace artifact `anayasa_uyum_denetimi.md`.
123
-
124
- ### 2026-05-23 — Replaced Redis Cache with Native PostgreSQL Unlogged Table Cache
125
- - **Agent:** @manager
126
- - **Action:** In accordance with the strategic design decision to minimize external infrastructure dependencies, updated all 5 constitutional documents (`moduller.md`, `mimari.md`, `is_akislari.md`, `proje.md`, `yapı.md`) in `docs/` to replace the Redis caching layer with a native, ultra-fast **PostgreSQL Unlogged Önbellek Tablosu** (`public_map_cache`). This unlogged table simulates Redis performance by bypassing WAL logging while retaining transactional control, spatial query capabilities, and single-sorgu invalidation (`DELETE WHERE tenant_id = :tenant_id`) directly within the database.
127
-
128
- ### 2026-05-23 — Implemented Enriched Map & Slide-Over Drawer on Citizen Portal Home Page
129
- - **Agent:** @manager (via @frontend)
130
- - **Action:** Surgically integrated all Citizen Portal Map (/map) UI Enrichments directly into the main citizen portal Home page (Section E) as approved by the user. Implemented `EnrichedMap.tsx` and `MapDetailDrawer.tsx` utilizing high-fidelity custom SVG district vectors, interactive zoom level cluster dissolving, coordinate fuzzing privacy circles, a pulsing Heatmap layer, a Disaster Crisis Mode layer (with assembly zones and evacuation vectors), a Border Crossover Pan Alert simulation banner, and an SMS verified "+1 support" voting flow. Hooked up dynamic state toggles to dynamically update municipal stats directly on the sidebar. Updated plan, task, and walkthrough artifacts.
131
-
132
- ### 2026-05-23 — Citizen Portal Layout Alignment & Turkey Map Initialization
133
- - **Agent:** @manager
134
- - **Action:** Addressed user-reported layout issues in the Citizen Portal. Reconfigured the interactive map to initialize with a full-view of Turkey (Center: [38.9637, 35.2433], Zoom: 6) instead of defaulting to a specific municipality. Surgically moved the "Active Municipality" selector from the top header to a dedicated high-visibility glassmorphic card in the bottom-left corner, satisfying the operational requirement. Confirmed the KENTİM logo is prominently positioned in the top-left corner within the floating navigation overlay. Updated the operational logic to ensure selecting a municipality from the new bottom-left selector triggers a smooth fly-to transition to the target region.
135
-
136
- ## PROJECT DEFINITION
137
-
138
-
139
-
46
+ - **Action:** Framework memory reset successfully performed. Pristine memory state established. Ready to receive custom project instructions and start scaffolding.
@@ -66,20 +66,15 @@ When analyzing or preparing documentation, never read the content of a file just
66
66
  In every phase transition and upon request:
67
67
 
68
68
  1. Read `{{FRAMEWORK_DIR}}/docs/api/README.md` → Get the endpoint index.
69
- 2. **Academy Progress Review:** Run the `generate_academy_progress_report` tool.
70
- - Summarize the key achievements for the user.
71
- 3. **Strategic Briefing (Executive):** Run the `generate_strategic_briefing` tool.
72
- - Provide a high-level overview of the Academy's health and strategic direction to the User.
73
- 4. **Documentation Debt Scan:** Run the `analyze_documentation_debt` tool.
74
- - If debt is found (missing JSDoc, READMEs), log it as a `PENDING` task in `PROJECT_MEMORY.md`.
75
- 3. **Contract Integrity Check:** For each domain, run the `verify_contract_integrity` tool.
69
+ 2. **Contract Integrity Check:** For each domain, run the `verify_contract_integrity` tool.
76
70
  - If it reports missing types, mark the task as `FAILED` and notify @backend.
77
- 3. Check each `[domain].md` file:
78
- - **Is the contract complete?** (method, path, auth, request, response, error codes)
79
- - **Is the app's types reference correct?** Does it match `apps/backend/src/types/`? - **Is the date current?** Old contracts can mislead coders.
80
- 3. Verify the `contract.version.json` hash using the `verify_api_contract` tool.
71
+ 3. **Verify API Contract Hash:** Verify the `contract.version.json` hash using the `verify_api_contract` tool.
81
72
  - If there is a mismatch, the tool will report it.
82
- 4. If there is a problem → notify `@backend` + record it in `PROJECT_MEMORY.md` HISTORY.
73
+ 4. Check each `[domain].md` file:
74
+ - **Is the contract complete?** (method, path, auth, request, response, error codes)
75
+ - **Is the app's types reference correct?** Does it match `apps/backend/src/types/`?
76
+ - **Is the date current?** Old contracts can mislead coders.
77
+ 5. If there is a problem → notify `@backend` + record it in `PROJECT_MEMORY.md` HISTORY.
83
78
 
84
79
  ---
85
80
 
@@ -204,7 +199,7 @@ Use the `log_agent_action` tool to record your activities securely.
204
199
 
205
200
  ---
206
201
 
207
- **Agent Completion Report** (v0.5.8)
202
+ **Agent Completion Report** (v1.0)
208
203
 
209
204
  - Mock used? [ ] No / [ ] Yes
210
205
  - shared-types changed? [ ] No / [ ] Yes
@@ -216,10 +211,3 @@ Use the `log_agent_action` tool to record your activities securely.
216
211
  - Blockers: [write if any, otherwise "NONE"]
217
212
 
218
213
  ---
219
- g written? [ ] No / [ ] Yes → via log_agent_action tool
220
- - Memory updated? [ ] No / [ ] Yes (update_project_memory tool recommended)
221
- - Phase transition criteria audited? [ ] No / [ ] Yes
222
- - Next step: [what needs to be done]
223
- - Blockers: [write if any, otherwise "NONE"]
224
-
225
- ---
@@ -162,7 +162,7 @@ Every "mutation" (CREATE, UPDATE, DELETE) MUST trigger an audit log entry.
162
162
  ## Domain Error System (Standard)
163
163
 
164
164
  All backend projects MUST use the standardized `DomainError` hierarchy. Do not define these classes locally.
165
- Reference the "Gold Standard" blueprints in `{{FRAMEWORK_DIR}}/blueprints/backend/errors/domain-error.ts`.
165
+ Reference the "Gold Standard" domain error guidelines in `{{FRAMEWORK_DIR}}/knowledge/domain-error-handling-standard.md`.
166
166
 
167
167
  **Mandatory Classes:**
168
168
  - `NotFoundError` (404)
@@ -174,7 +174,7 @@ Reference the "Gold Standard" blueprints in `{{FRAMEWORK_DIR}}/blueprints/backen
174
174
 
175
175
  **Usage Pattern:**
176
176
  ```typescript
177
- // Copy from blueprint to project's error directory if missing
177
+ // Standard domain error import
178
178
  import { NotFoundError } from "@/errors/domain-error";
179
179
 
180
180
  if (!item) throw new NotFoundError("Item");
@@ -314,7 +314,7 @@ When app types or API documentation changes:
314
314
 
315
315
  ---
316
316
 
317
- **Agent Completion Report** (v0.5.8)
317
+ **Agent Completion Report** (v1.0)
318
318
  - Mock used? [ ] No / [ ] Yes
319
319
  - App types changed? [ ] No / [ ] Yes → contract.version updated
320
320
  - **API contract written? [ ] No / [ ] Yes → {{FRAMEWORK_DIR}}/docs/api/[domain].md**
@@ -324,8 +324,4 @@ When app types or API documentation changes:
324
324
  - Next step: [what needs to be done]
325
325
  - Blockers: [write if any, otherwise "NONE"]
326
326
  ---
327
- ```
328
- what needs to be done]
329
- - Blockers: [write if any, otherwise "NONE"]
330
- ---
331
- ```
327
+
@@ -47,10 +47,10 @@ Every message MUST follow this pattern:
47
47
  2. Check `git status` to identify pending changes.
48
48
  > ✅ **End of Session:** Update `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` HISTORY (via `update_project_memory`) + log action via `log_agent_action`. Every turn MUST end with an automated log and memory update.
49
49
 
50
- ### Step 1: Repository Initialization & Status Audit
50
+ ### Step 1: Repository Status & Health Audit
51
51
  1. Run `git status` to identify pending changes.
52
- 2. **Health Check (Mandatory):** Run `validate_repository_health` tool.
53
- - If any check `FAILED`, use `send_agent_message` to notify the responsible agent (e.g., `@backend` for test failures, `@frontend` for build issues). **DO NOT COMMIT.**
52
+ 2. **Health Check (Mandatory):** Run standard health checks in the workspace (such as `npx agent-enderun check` or `npm run enderun:test`) to verify everything compiles and passes tests before staging files.
53
+ - If tests or compilation fails, notify the responsible agent. **DO NOT COMMIT.**
54
54
  3. **Constitution Compliance (Mandatory):** Run `analyze_constitution_compliance` tool on staged files.
55
55
  - If violations are found (e.g. Zero UI Policy), use `send_agent_message` to notify the responsible agent. **DO NOT COMMIT.**
56
56
  - If `PASSED`, proceed to Step 2.
@@ -63,7 +63,7 @@ Never start coding before understanding the current state of the components and
63
63
  - **Responsive & Safe Area:** SafeAreaView + Platform.OS check is mandatory on every screen.
64
64
  - **Accessibility:** Font scaling, contrast, and screen reader support must be considered in every component.
65
65
 
66
- ## 📱 Mobile Agent Completion Report (Zorunlu)
66
+ ## 📱 Mobile Agent Completion Report (v1.0 - Zorunlu)
67
67
 
68
68
  - [ ] Mock used? [ ] No / [ ] Yes
69
69
  - [ ] App types imported? [ ] No / [ ] Yes
@@ -79,13 +79,3 @@ Never start coding before understanding the current state of the components and
79
79
 
80
80
  ---
81
81
 
82
- **Agent Completion Report** (v0.5.8)
83
-
84
- - Mock used? [ ] No / [ ] Yes
85
- - shared-types imported? [ ] No / [ ] Yes
86
- - Log written? [ ] No / [ ] Yes → via log_agent_action tool
87
- - PROJECT_MEMORY HISTORY updated? [ ] No / [ ] Yes
88
- - Next step: [what needs to be done]
89
- - Blockers: [write if any, otherwise "NONE"]
90
-
91
- ---
@@ -60,7 +60,7 @@ Always research the existing codebase and native bridge implementations before a
60
60
  - **Auto Update:** Tauri updater or electron-updater should be considered for automatic updates.
61
61
  - **Window & Menu:** Native menu, tray icon, and window state management should be standardized.
62
62
 
63
- ## 🖥️ Native Agent Completion Report (Zorunlu)
63
+ ## 🖥️ Native Agent Completion Report (v1.0 - Zorunlu)
64
64
 
65
65
  - [ ] Mock used? [ ] No / [ ] Yes
66
66
  - [ ] App types imported? [ ] No / [ ] Yes
@@ -84,13 +84,3 @@ Always research the existing codebase and native bridge implementations before a
84
84
 
85
85
  ---
86
86
 
87
- **Agent Completion Report** (v0.5.8)
88
-
89
- - Mock used? [ ] No / [ ] Yes
90
- - shared-types imported? [ ] No / [ ] Yes
91
- - Log written? [ ] No / [ ] Yes → via log_agent_action tool
92
- - PROJECT_MEMORY HISTORY updated? [ ] No / [ ] Yes
93
- - Next step: [what needs to be done]
94
- - Blockers: [write if any, otherwise "NONE"]
95
-
96
- ---
@@ -0,0 +1,19 @@
1
+ # Agent Enderun — Claude Code CLI Adapter
2
+
3
+ This file is the entry point when using Agent Enderun with Claude Code CLI.
4
+
5
+ The framework installs into the `.claude/` folder for Claude users.
6
+
7
+ ### Primary Constitution
8
+ All governance rules, agent checklists, and project memory live here:
9
+
10
+ 👉 **[.claude/ENDERUN.md](.claude/ENDERUN.md)**
11
+
12
+ ### 🤖 Agent Directive (Claude Code CLI users)
13
+ You are operating under the Agent Enderun governance framework.
14
+
15
+ At the **start of every session**, before any work:
16
+ 1. Read `.claude/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
17
+ 2. Read the relevant agent definition under `.claude/agents/{agent}/agent.json` (especially `@manager`).
18
+
19
+ All paths and references inside `.claude/` use the Claude adapter structure. No migration to other CLIs is required.
@@ -0,0 +1,19 @@
1
+ # Agent Enderun — Cursor / Codex Adapter
2
+
3
+ This file is the entry point when using Agent Enderun with Cursor Composer / Codex CLI.
4
+
5
+ The framework installs into the `.cursor/` folder for Cursor users.
6
+
7
+ ### Primary Constitution
8
+ All governance rules, agent checklists, and project memory live here:
9
+
10
+ 👉 **[.cursor/ENDERUN.md](.cursor/ENDERUN.md)**
11
+
12
+ ### 🤖 Agent Directive (Cursor users)
13
+ You are operating under the Agent Enderun governance framework.
14
+
15
+ At the **start of every session**, before any work:
16
+ 1. Read `.cursor/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
17
+ 2. Read the relevant agent definition under `.cursor/agents/{agent}/agent.json` (especially `@manager`).
18
+
19
+ All paths and references inside `.cursor/` use the Cursor adapter structure. No migration to other CLIs is required.
@@ -1 +1 @@
1
- {"agent":"analyst","action":"MODIFY","requestId":"01J04YJ0W1W1W1W1W1W1W1W1W1","files":["apps/backend/municipal/src/lib/background.ts"],"status":"SUCCESS","summary":"Verified Gap Remediation and fixed missing SLA worker integration in background tasks."}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"agent": "@backend", "version": "1.0.0", "actions": [], "lastUpdated": "2026-05-25T17:00:00Z", "summary": "Log initialized at v0.7.5."}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"deployments":[],"rollbacks":[]}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"agent": "@explorer", "version": "1.0.0", "actions": [], "lastUpdated": "2026-05-25T17:00:00Z", "summary": "Log initialized at v0.7.5."}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"agent": "@frontend", "version": "1.0.0", "actions": [], "lastUpdated": "2026-05-25T17:00:00Z", "summary": "Log initialized at v0.7.5."}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"agent": "@git", "version": "1.0.0", "actions": [], "lastUpdated": "2026-05-25T17:00:00Z", "summary": "Log initialized at v0.7.5."}
1
+ {"runs":[]}
@@ -1,20 +1 @@
1
- {
2
- "timestamp": "2026-05-23T14:45:00+03:00",
3
- "agent": "@manager",
4
- "action": "Updated the 5 constitutional docs to replace Redis with PostgreSQL Unlogged Cache.",
5
- "details": {
6
- "modified_files": [
7
- "docs/moduller.md",
8
- "docs/mimari.md",
9
- "docs/is_akislari.md",
10
- "docs/proje.md",
11
- "docs/yapı.md",
12
- ".gemini/PROJECT_MEMORY.md",
13
- ".gemini/logs/manager.json"
14
- ],
15
- "updates": {
16
- "Redis replacement": "Replaced Redis cache references across all documents with PostgreSQL unlogged cache table standard.",
17
- "PROJECT_MEMORY.md": "Appended session history."
18
- }
19
- }
20
- }
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"agent": "@mobile", "version": "1.0.0", "actions": [], "lastUpdated": "2026-05-25T17:00:00Z", "summary": "Log initialized at v0.7.5."}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"agent": "@native", "version": "1.0.0", "actions": [], "lastUpdated": "2026-05-25T17:00:00Z", "summary": "Log initialized at v0.7.5."}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"assignments":[],"blockages":[],"broadcasts":[]}
1
+ {"runs":[]}
@@ -1 +1 @@
1
- {"scans":[]}
1
+ {"runs":[]}
package/README.md CHANGED
@@ -1,9 +1,9 @@
1
- # 🏛️ Agent Enderun (v0.7.5) — The Supreme AI Governance & Orchestration Framework
1
+ # 🏛️ Agent Enderun (v0.8.0) — The Supreme AI Governance & Orchestration Framework
2
2
 
3
3
  **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
4
4
 
5
5
  **Author:** Yusuf BEKAR
6
- **Version:** 0.7.5
6
+ **Version:** 0.8.0
7
7
  **License:** MIT
8
8
 
9
9
  [English](#english) | [Türkçe](#türkçe)
@@ -47,25 +47,42 @@ Every task or logical unit of work is assigned a unique **Trace ID** (a 26-chara
47
47
 
48
48
  ---
49
49
 
50
- ## 🤖 The Agent Army
50
+ ## 🤖 The Agent Army & Core Folders
51
51
 
52
52
  Each agent in the Enderun Army is governed by a strongly-typed `agent.json` definition that defines their precise rules, permitted directories, and capability ratings.
53
53
 
54
54
  ### Workspace Agent Path:
55
55
  👉 `[project-root]/.gemini/agents/{agent_name}/agent.json`
56
56
 
57
- ### Agent Army Overview:
57
+ ### Agent Army Overview (v1.0 - 12 Specialists):
58
+
59
+ | Tier | Agent | Capability | Role & Domain | Primary Specialization |
60
+ | :--- | :--- | :--- | :--- | :--- |
61
+ | **Core** | **@orchestrator** | **9.8/10** | Task Pipeline Engine | Parallel execution, stateful queue controls, DAG execution. |
62
+ | **Core** | **@manager** | **9.5/10** | Orchestration & Governance | Intent analysis, high-risk dynamic approval signing, escalation. |
63
+ | **Analysis** | **@analyst** | **9.6/10** | Verification & QA Gate | Vitest/Cypress verification, API contract drift checking, Zero-UI enforcer. |
64
+ | **Analysis** | **@explorer** | **9.4/10** | Research & Discovery | Pattern mapping, dependency graph discovery, onboarding analysis. |
65
+ | **Engineering** | **@backend** | **9.2/10** | Domain Logic & Databases | Fastify, Kysely queries, branded types, DomainError hierarchy. |
66
+ | **Engineering** | **@frontend** | **9.0/10** | Fluid Responsive UI | React 19, Panda CSS styling tokens, Zero-UI, WCAG 2.2 accessibility. |
67
+ | **Engineering** | **@native** | **8.9/10** | Native Capabilities | Tauri/Electron shell guards, Rust bridges, secure IPC contracts. |
68
+ | **Engineering** | **@mobile** | **8.8/10** | Cross-Platform Mobile | React Native/Expo fluid viewports, offline cache sync, safe areas. |
69
+ | **Operations** | **@security** | **9.3/10** | Security & Compliance | OWASP threat detection, AST scans for secrets, CSP rules auditor. |
70
+ | **Operations** | **@qa** | **9.1/10** | Quality Gate Enforcer | Unit/integration testing gates, coverage metrics check. |
71
+ | **Operations** | **@git** | **9.1/10** | Version Control | Semantic commits formatting, atomic commit segregation, phase snapshots. |
72
+ | **Operations** | **@devops** | **9.0/10** | Infrastructure | Deployment pipelines, container setups, environment variable validation. |
58
73
 
59
- | Agent | Capability | Role & Domain | Specialization |
60
- | :--- | :--- | :--- | :--- |
61
- | **@manager** | **9.5/10** | Orchestration & Governance | Team-Lead, intent analysis, risk audit, escalation |
62
- | **@backend** | **9.2/10** | Domain Logic & Databases | NestJS/Express, database migrations, Branded Types |
63
- | **@frontend** | **9.0/10** | Fluid Responsive UI | Panda CSS, Zero-UI-Library policy, accessibility |
64
- | **@analyst** | **9.6/10** | Verification & QA | Vitest/Cypress, lint verification, schema checks |
65
- | **@explorer** | **9.4/10** | Research & Discovery | API scanning, entry-point hunt, pattern mapping |
66
- | **@git** | **9.1/10** | DevOps & Version Control | Commit strategies, changelog audits, branch governance |
67
- | **@mobile** | **8.8/10** | Cross-Platform Mobile | React Native/Expo, responsive fluid mobile design |
68
- | **@native** | **8.9/10** | Native Capabilities | Swift/Kotlin, native integrations, deep links |
74
+ ---
75
+
76
+ ### 📂 Core Directories Analysis & Operational Purposes
77
+
78
+ The Agent Enderun framework organizes agent actions and runtime intelligence through highly structured directories remapped to `.gemini/` (or `.claude/` / `.cursor/`) inside user workspaces:
79
+
80
+ * **`skills/` (Dynamic Executables):** Serves as a folder for model-specific executable scripts and custom tools. Developers can inject project-specific helpers here, allowing agents to load and execute them dynamically on-demand during active briefs.
81
+ * **`benchmarks/` (LLM Evaluation):** Dedicated folder for metrics, token consumption, and response accuracy logs comparing different LLM engines (e.g. Gemini 1.5 Pro vs Claude 3.5 Sonnet vs Codex). Helps evaluate the coding intelligence of the active army.
82
+ * **`knowledge/` (Intelligence Database):** central knowledge hub of the framework containing 43 robust guidelines enforcing strict laws on Panda CSS coding, Fastify RCSR, Kysely schema creation, dynamic signature validations, and domain error hierarchies.
83
+ * **`logs/` (Auditable Trails):** Active audit log repository. Every action performed by any agent is traceably logged in JSON format (`logs/{agent_name}.json`) with a specific timestamp and a unique 26-character Trace ID (ULID), satisfying enterprise compliance audits.
84
+ * **`monitoring/` (Operational Telemetry):** Telemetry directory integrated with monitoring tools (`get_army_health_dashboard`, `calculate_agent_performance_score`) to analyze agent bottleneck states and QA rejection cycles.
85
+ * **`queue/` (Asynchronous Task Engine):** File-based stateful task queue split into `pending/`, `processing/`, `completed/`, `failed/`, and `pipelines/` subdirectories. Feeds Orchestration MCP tools to schedule complex multi-agent assignments in parallel with complete rollback recovery.
69
86
 
70
87
  ---
71
88
 
@@ -183,21 +200,66 @@ Enderun Ordusu'ndaki her ajan, kendilerine ait kuralları, izin verilen dizinler
183
200
  ### Çalışma Alanı Ajan Yolu:
184
201
  👉 `[proje-kök-dizini]/.gemini/agents/{agent_name}/agent.json`
185
202
 
186
- ### Ajan Ordusuna Genel Bakış:
203
+ ### Ajan Ordusuna Genel Bakış (v1.0 - 12 Uzman Ajan):
204
+
205
+ | Katman | Ajan | Yetenek | Rol & Alan | Ana Uzmanlık Alanı |
206
+ | :--- | :--- | :--- | :--- | :--- |
207
+ | **Core** | **@orchestrator** | **9.8/10** | Görev Kuyruğu Motoru | Paralel yürütme, stateful kuyruk kontrolleri, DAG yönetimi. |
208
+ | **Core** | **@manager** | **9.5/10** | Orkestrasyon & Yönetişim | Talep analizi, yüksek riskli dinamik imza kontrolü, onay mekanizması. |
209
+ | **Analiz** | **@analyst** | **9.6/10** | Kalite & Sözleşme Kapısı | Vitest/Cypress test denetimi, API kontrat sapma kontrolü, Sıfır-UI denetçisi. |
210
+ | **Analiz** | **@explorer** | **9.4/10** | Araştırma & Keşif | Kod yapısı desen eşleme, bağımlılık grafiği çıkarma, onboarding analizi. |
211
+ | **Geliştirme** | **@backend** | **9.2/10** | Domain Mantığı & DB | Fastify, Kysely veri tabanı sorguları, branded tipler, DomainError hiyerarşisi. |
212
+ | **Geliştirme** | **@frontend** | **9.0/10** | Akıcı Duyarlı Arayüz | React 19, Panda CSS stil token'ları, Sıfır-UI, WCAG 2.2 AA erişilebilirlik. |
213
+ | **Geliştirme** | **@native** | **8.9/10** | Native Yetenekler | Tauri/Electron kabuk koruması, Rust köprüleri, güvenli IPC kontratları. |
214
+ | **Geliştirme** | **@mobile** | **8.8/10** | Çoklu Platform Mobil | React Native/Expo akıcı görünümler, offline önbellek senkronizasyonu. |
215
+ | **Operasyon** | **@security** | **9.3/10** | Güvenlik & Uyum | OWASP tehdit tespiti, AST tabanlı statik sır taraması, CSP denetimi. |
216
+ | **Operasyon** | **@qa** | **9.1/10** | Kalite Güvence Kapısı | Birim/entegrasyon test kontrolü, kapsama metrikleri denetçisi. |
217
+ | **Operasyon** | **@git** | **9.1/10** | Versiyon Kontrolü | Semantik commit formatlama, atomik commit ayırma, faz snapshot'ları. |
218
+ | **Operasyon** | **@devops** | **9.0/10** | Altyapı & Deployment | Deployment boru hatları, konteyner kurulumları, ortam değişkenleri denetimi. |
219
+
220
+ ---
221
+
222
+ ## 🏛️ Agent Enderun: Detaylı Kod Tabanı Denetim Raporu (v0.8.0)
223
+
224
+ Çerçevenin (framework) çekirdek kod yapısı, operasyonel işleyişi, alt-üst ajan hiyerarşisi ve temizlenmiş mükerrer alanları en ince ayrıntısına kadar denetlenmiş ve belgelenmiştir:
187
225
 
188
- | Ajan | Yetenek | Rol & Alan | Uzmanlık |
189
- | :--- | :--- | :--- | :--- |
190
- | **@manager** | **9.5/10** | Orkestrasyon & Yönetişim | Takım Lideri, niyet analizi, risk denetimi, onay |
191
- | **@backend** | **9.2/10** | Domain Mantığı & Veri Tabanı | NestJS/Express, DB migrasyonları, Branded Types |
192
- | **@frontend** | **9.0/10** | Akıcı Duyarlı Arayüz | Panda CSS, Zero-UI-Library ilkesi, erişilebilirlik |
193
- | **@analyst** | **9.6/10** | Doğrulama & Kalite (QA) | Vitest/Cypress, linter doğrulamaları, şema kontrolü |
194
- | **@explorer** | **9.4/10** | Araştırma & Keşif | API tarama, başlangıç noktası avı, desen eşleme |
195
- | **@git** | **9.1/10** | DevOps & Sürüm Kontrolü | Commit stratejileri, değişiklik günlüğü, dal yönetimi |
196
- | **@mobile** | **8.8/10** | Çoklu Platform Mobil | React Native/Expo, akıcı duyarlı mobil arayüzler |
197
- | **@native** | **8.9/10** | Native Yetenekler | Swift/Kotlin, native entegrasyonlar, derin linkler |
226
+ ### 📂 1. Kapsamlı Klasör ve Dosya Yapısı Analizi
227
+
228
+ * **🧠 Çekirdek Komuta Klasörü (`.enderun/`):**
229
+ * Ajanların şablon kaynak dosyalarının yer aldığı ve hedef projede `.gemini/` (veya `.claude/` / `.cursor/`) olarak yeniden adlandırılan ana zeka merkezidir.
230
+ * **`agents/` (Ajan Tanımları & SOP'lar)**: 12 uzman ajanın davranış kurallarını barındırır. Her ajanın altında bir `agent.json` ve prompt/SOP dosyaları (`prompt.md`) bulunur. Durum makinesi şeması `schema/agent-lifecycle-schema.json` ile yönetilir.
231
+ * **`knowledge/` (Bilgi Bankası)**: Projenin anayasasını, sıfır UI kütüphanesi politikasını ve veri tabanı/kod standartlarını içeren 26 adet Markdown kılavuzunu barındırır. `corporate-governance/` alt klasöründe onay mekanizmaları, branded types hukuku ve audit loglama standartları gibi kurumsal düzeydeki 17 katı yönetişim kılavuzu yer alır.
232
+ * **`memory-graph/` (Bellek Grafiği)**: Ajanların etkileşim ağını (`graph.json`), ortak paylaştıkları doğruları (`shared-facts.json`) ve her bir ajanın yerel bağlam belleklerini (`agent-contexts/`) saklar.
233
+ * **`queue/` (Dosya Tabanlı Görev Kuyruğu)**: Asenkron ve paralel görevlerin yönetildiği dizindir. `pending/`, `processing/`, `completed/` ve `failed/` alt dizinleri sayesinde Trace ID üzerinden asenkron görev takibi yapılır.
234
+ * **`logs/` (Aksiyon Günlükleri)**: Ajanların gerçekleştirdiği tüm mutasyonları Trace ID (ULID) ile damgalayarak JSON formatında saklar (Örn: `backend.json`, `analyst.json`).
235
+
236
+ * **🔌 Model Context Protocol (MCP) Katmanı (`framework-mcp/`):**
237
+ * Ajanların IDE (Gemini, Claude, Cursor) ile konuşmasını ve yerel sistemdeki dosyaları güvenle manipüle etmesini sağlayan ana entegrasyon paketidir.
238
+ * **`src/tools/`**: 13 adet çekirdek MCP araç modülünü (kod tabanı aramaları, bellek kilit protokolleri, kontrat doğrulamaları, statik AST analizli güvenlik taramaları vb.) barındırır.
239
+ * **`src/schemas.ts`**: MCP araçlarına gönderilen parametrelerin tip güvenliğini Zod şemalarıyla denetler (Gereksiz/pasif şemalar temizlenmiştir).
240
+ * **`src/index.ts`**: MCP sunucusunun stdio üzerinden IDE ile bağlantısını kuran ana giriş kapısıdır.
241
+
242
+ * **🚀 Çalıştırılabilir Dizin & CLI (`bin/` ve `src/cli/`):**
243
+ * **`bin/cli.js`**: `npx tsx src/cli/index.ts` komutunu sarmalayan çalıştırılabilir binary giriş noktasıdır.
244
+ * **`src/cli/index.ts`**: Projeyi platformlara göre (`gemini`, `claude`, `cursor`) scaffold eden ve sağlık kontrollerini (`check`, `status`) koordine eden çekirdek CLI motorudur.
245
+ * **`bin/hermes-sandbox.js`**: Ajanlar arası Yüksek Riskli İşlem ve dynamic onay (`managerApproval`) mesajlaşma akışını yerel olarak simüle eden test sandbox'ıdır.
246
+
247
+ ### 🧹 2. Gerçekleştirilen v1.0 Kritik Temizlik ve Düzenlemeler
248
+
249
+ * **Ajan Promptlarındaki Çöp Veriler Temizlendi:** `analyst`, `backend`, `mobile` ve `native` promptlarının sonundaki bozuk mükerrer satırlar ve generic raporlama blokları tamamen kaldırılmıştır.
250
+ * **Ölü MCP Kodları / Araçları Ayıklandı:** `schemas.ts` içindeki 8 adet pasif/unimplemented araç şeması ayıklanmış ve promptlardaki ölü araç referansları temizlenmiştir.
251
+ * **Olmayan Klasör Referansları Onarıldı:** Olmayan `.enderun/blueprints/` klasör referansları, `.enderun/knowledge/` altındaki aktif rehberlerle başarılı şekilde değiştirilmiştir.
252
+ * **Çoklu Platform ve Kök Senkronizasyonu Sağlandı:** `gemini.md`, `claude.md` ve `cursor.md` dosyaları şablon ve kök dizinde senkronize edilerek CLI dağıtımına hazır hale getirilmiştir.
253
+
254
+ ### 👑 3. Ajan Ordusu Hiyerarşisi ve Çalışma Akışı
255
+
256
+ * **Üst Ajan (Lead):** `@manager` her zaman varsayılan liderdir. Projedeki tüm alt görevler onun brifingi ile başlar.
257
+ * **Alt Ajanlar (Specialists):** `@backend`, `@frontend`, `@security` vb. uzman ajanlar kendilerine atanan asenkron görevleri yapar.
258
+ * **Kalite Kapısı:** `@analyst` ve `@security` yapılan geliştirmelerin anayasaya uygunluğunu denetlemeden hiçbir kod parçası staging/commit aşamasına geçemez.
198
259
 
199
260
  ---
200
261
 
262
+
201
263
  ## ⚡ Hızlı Başlangıç ve İş Akışı
202
264
 
203
265
  ### 1. Kurulum
package/claude.md ADDED
@@ -0,0 +1,19 @@
1
+ # Agent Enderun — Claude Code CLI Adapter
2
+
3
+ This file is the entry point when using Agent Enderun with Claude Code CLI.
4
+
5
+ The framework installs into the `.claude/` folder for Claude users.
6
+
7
+ ### Primary Constitution
8
+ All governance rules, agent checklists, and project memory live here:
9
+
10
+ 👉 **[.claude/ENDERUN.md](.claude/ENDERUN.md)**
11
+
12
+ ### 🤖 Agent Directive (Claude Code CLI users)
13
+ You are operating under the Agent Enderun governance framework.
14
+
15
+ At the **start of every session**, before any work:
16
+ 1. Read `.claude/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
17
+ 2. Read the relevant agent definition under `.claude/agents/{agent}/agent.json` (especially `@manager`).
18
+
19
+ All paths and references inside `.claude/` use the Claude adapter structure. No migration to other CLIs is required.
package/cursor.md ADDED
@@ -0,0 +1,19 @@
1
+ # Agent Enderun — Cursor / Codex Adapter
2
+
3
+ This file is the entry point when using Agent Enderun with Cursor Composer / Codex CLI.
4
+
5
+ The framework installs into the `.cursor/` folder for Cursor users.
6
+
7
+ ### Primary Constitution
8
+ All governance rules, agent checklists, and project memory live here:
9
+
10
+ 👉 **[.cursor/ENDERUN.md](.cursor/ENDERUN.md)**
11
+
12
+ ### 🤖 Agent Directive (Cursor users)
13
+ You are operating under the Agent Enderun governance framework.
14
+
15
+ At the **start of every session**, before any work:
16
+ 1. Read `.cursor/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
17
+ 2. Read the relevant agent definition under `.cursor/agents/{agent}/agent.json` (especially `@manager`).
18
+
19
+ All paths and references inside `.cursor/` use the Cursor adapter structure. No migration to other CLIs is required.
@@ -23,7 +23,6 @@ The `ai-enderun-mcp` package is the core intelligence engine of the Agent Enderu
23
23
  - `analyze_dependencies`: Deep import tracking and dependency mapping.
24
24
  - `analyze_codebase_intelligence`: Detects complexity spikes and dead code.
25
25
  - `generate_dependency_graph`: Creates Mermaid architecture maps.
26
- - `analyze_database_schema`: Generates Mermaid ER diagrams from migration code.
27
26
 
28
27
  #### 📜 Contract Management
29
28
  - `verify_api_contract`: Checks shared-types integrity via hashing.
@@ -32,15 +31,10 @@ The `ai-enderun-mcp` package is the core intelligence engine of the Agent Enderu
32
31
 
33
32
  #### 🎓 Academy & Orchestration
34
33
  - `log_agent_action`: Records traceable agent activities.
35
- - `get_academy_performance`: Aggregates success rates across the team.
36
34
  - `send_agent_message`: Facilitates inter-agent collaboration.
37
35
  - `read_agent_messages`: Inbox management for specialized agents.
38
- - `generate_strategic_briefing`: High-level executive performance summary.
39
- - `generate_academy_progress_report`: Narrative overview of project milestones.
40
36
 
41
37
  #### 📦 Repository & Git
42
- - `validate_repository_health`: Pre-commit health checks (lint/test/build).
43
- - `analyze_documentation_debt`: Scans for missing JSDoc and READMEs.
44
38
  - `generate_semantic_commit_message`: Automated commit messages based on diffs.
45
39
 
46
40
  ---
@@ -51,10 +45,10 @@ The `ai-enderun-mcp` package is the core intelligence engine of the Agent Enderu
51
45
 
52
46
  - **Güvenlik:** `security_audit_scan`, `analyze_constitution_compliance`.
53
47
  - **Hafıza:** `get_framework_status`, `update_project_memory`, `bootstrap_legacy_memory`.
54
- - **Zeka:** `search_codebase`, `analyze_dependencies`, `generate_dependency_graph`, `analyze_database_schema`.
48
+ - **Zeka:** `search_codebase`, `analyze_dependencies`, `generate_dependency_graph`.
55
49
  - **Kontrat:** `verify_api_contract`, `update_contract_hash`, `verify_contract_integrity`.
56
- - **Orkestrasyon:** `send_agent_message`, `log_agent_action`, `generate_strategic_briefing`.
57
- - **Repo:** `validate_repository_health`, `analyze_documentation_debt`, `generate_semantic_commit_message`.
50
+ - **Orkestrasyon:** `send_agent_message`, `log_agent_action`.
51
+ - **Repo:** `generate_semantic_commit_message`.
58
52
 
59
53
  ## License
60
54
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-enderun-mcp",
3
- "version": "0.7.5",
3
+ "version": "0.8.0",
4
4
  "description": "Enterprise-grade MCP Server for AI Agent Framework",
5
5
  "author": "Yusuf BEKAR",
6
6
  "license": "MIT",
@@ -56,14 +56,6 @@ export const UPDATE_KNOWLEDGE_BASE_ARGS_SCHEMA = z.object({
56
56
  tags: z.array(z.string().min(1)).default([]),
57
57
  });
58
58
 
59
- export const ANALYZE_DATABASE_SCHEMA_ARGS_SCHEMA = z.object({
60
- path: z.string().default("apps/backend"),
61
- });
62
-
63
- export const GENERATE_STRATEGIC_BRIEFING_ARGS_SCHEMA = z.object({
64
- focusArea: z.string().optional(),
65
- });
66
-
67
59
  export const ANALYZE_CONSTITUTION_COMPLIANCE_ARGS_SCHEMA = z.object({
68
60
  path: z.string().min(1),
69
61
  });
@@ -73,18 +65,6 @@ export const GENERATE_DEPENDENCY_GRAPH_ARGS_SCHEMA = z.object({
73
65
  format: z.enum(["mermaid", "json"]).default("mermaid"),
74
66
  });
75
67
 
76
- export const GENERATE_ACADEMY_PROGRESS_REPORT_ARGS_SCHEMA = z.object({
77
- days: z.number().default(7),
78
- });
79
-
80
- export const ANALYZE_DOCUMENTATION_DEBT_ARGS_SCHEMA = z.object({
81
- path: z.string().default("."),
82
- });
83
-
84
- export const VALIDATE_REPOSITORY_HEALTH_ARGS_SCHEMA = z.object({
85
- scope: z.enum(["full", "lint", "test", "build"]).default("full"),
86
- });
87
-
88
68
  export const READ_AGENT_MESSAGES_ARGS_SCHEMA = z.object({
89
69
  agent: z.string().min(1),
90
70
  traceId: z.string().min(1).optional(),
@@ -102,20 +82,11 @@ export const ANALYZE_CODEBASE_INTELLIGENCE_ARGS_SCHEMA = z.object({
102
82
  path: z.string().default("."),
103
83
  });
104
84
 
105
- export const GET_ACADEMY_PERFORMANCE_ARGS_SCHEMA = z.object({
106
- periodDays: z.number().default(30),
107
- });
108
-
109
85
  export const ANALYZE_PROCEDURAL_CONTINUITY_ARGS_SCHEMA = z.object({
110
86
  targetPath: z.string().min(1),
111
87
  referencePath: z.string().min(1),
112
88
  });
113
89
 
114
- export const GET_AGENT_AUDIT_REPORT_ARGS_SCHEMA = z.object({
115
- agent: z.string().min(1),
116
- days: z.number().default(7),
117
- });
118
-
119
90
  export const GET_AGENT_INBOX_STATS_ARGS_SCHEMA = z.object({
120
91
  agent: z.string().min(1),
121
92
  });
@@ -132,17 +103,4 @@ export const VERIFY_FRAMEWORK_HEALTH_ARGS_SCHEMA = z.object({
132
103
  detailed: z.boolean().default(false),
133
104
  });
134
105
 
135
- export const INSTANTIATE_BLUEPRINT_ARGS_SCHEMA = z.object({
136
- blueprintPath: z.string().min(1),
137
- targetPath: z.string().min(1),
138
- });
139
-
140
- export const LIST_BLUEPRINTS_ARGS_SCHEMA = z.object({
141
- category: z.enum(["backend", "frontend"]).optional(),
142
- });
143
106
 
144
- export const SAVE_AS_BLUEPRINT_ARGS_SCHEMA = z.object({
145
- blueprintPath: z.string().min(1),
146
- content: z.string().min(1),
147
- description: z.string().optional(),
148
- });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-enderun",
3
- "version": "0.7.5",
3
+ "version": "0.8.0",
4
4
  "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
5
5
  "author": "Yusuf BEKAR",
6
6
  "license": "MIT",
@@ -44,6 +44,8 @@
44
44
  "tsconfig.json",
45
45
  "panda.config.ts",
46
46
  "gemini.md",
47
+ "claude.md",
48
+ "cursor.md",
47
49
  "docs"
48
50
  ],
49
51
  "scripts": {
@@ -1,34 +0,0 @@
1
- ---
2
- title: Kentim Project Constitution
3
- tags: [architecture, workflows, modules, ui, saas]
4
- related: [mimari_standartlar, is_akislari, moduller, sayfa_yapisi]
5
- last_updated: 2026-05-21T18:00:00Z
6
- ---
7
-
8
- # KENTİM Proje Anayasası Özeti
9
-
10
- KENTİM projesi, Türkiye genelindeki belediyelerin vatandaş etkileşimini ve saha operasyonlarını dijitalleştiren bir **Multi-Tenant SaaS** platformudur.
11
-
12
- ## Temel Direkler
13
-
14
- 1. **Mimari (mimari.md):**
15
- - Merkezi bir Gateway (Reverse Proxy) üzerinden trafik yönetilir.
16
- - Her belediye (tenant) kendi izole veritabanı şemasına sahiptir (PostgreSQL RLS).
17
- - Coğrafi işlemler için PostGIS (ST_Contains, ST_Distance) kullanılır.
18
-
19
- 2. **İş Akışları (is_akislari.md):**
20
- - 11 duruma sahip gelişmiş bir İş Emri Durum Makinesi (State Machine) işletilir.
21
- - Circuit Breaker (3 fotoğraf reddi -> Müdür) ve Ping-Pong Koruması (3 re-dispatch -> Admin) gibi otomasyonlar mevcuttur.
22
-
23
- 3. **Yazılım Standartları (yapı.md):**
24
- - **Backend:** Route -> Controller -> Service -> Repository (RCSR) deseni zorunludur.
25
- - **Frontend:** React 19 + Panda CSS (Zero UI Library Politikası).
26
- - **Güvenlik:** JWT tabanlı Auth, HMAC Loopback ve PII Masking (KVKK).
27
-
28
- 4. **Mobil Operasyon (moduller.md):**
29
- - React Native CLI tabanlı, Offline-First (MMKV) saha uygulaması.
30
-
31
- ## Kritik Limitler
32
- - Re-open hakkı: Maksimum 2 kez.
33
- - Geofence mesafesi: 50 metre.
34
- - Grace Period: Lisans bitimi sonrası 7 gün salt-okunur/tamamlama erişimi.