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.
- package/.enderun/BRAIN_DASHBOARD.md +5 -6
- package/.enderun/PROJECT_MEMORY.md +15 -108
- package/.enderun/agents/analyst/prompt.md +8 -20
- package/.enderun/agents/backend/prompt.md +4 -8
- package/.enderun/agents/git/prompt.md +3 -3
- package/.enderun/agents/mobile/prompt.md +1 -11
- package/.enderun/agents/native/prompt.md +1 -11
- package/.enderun/claude.md +19 -0
- package/.enderun/cursor.md +19 -0
- package/.enderun/logs/analyst.json +1 -1
- package/.enderun/logs/backend.json +1 -1
- package/.enderun/logs/devops.json +1 -1
- package/.enderun/logs/explorer.json +1 -1
- package/.enderun/logs/frontend.json +1 -1
- package/.enderun/logs/git.json +1 -1
- package/.enderun/logs/manager.json +1 -20
- package/.enderun/logs/mobile.json +1 -1
- package/.enderun/logs/native.json +1 -1
- package/.enderun/logs/orchestrator.json +1 -1
- package/.enderun/logs/security.json +1 -1
- package/README.md +87 -25
- package/claude.md +19 -0
- package/cursor.md +19 -0
- package/framework-mcp/README.md +3 -9
- package/framework-mcp/package.json +1 -1
- package/framework-mcp/src/schemas.ts +0 -42
- package/package.json +3 -1
- package/.enderun/knowledge/kentim_constitution.md +0 -34
|
@@ -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** |
|
|
12
|
-
| **Active Trace IDs** |
|
|
13
|
-
| **Agent Velocity** |
|
|
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-
|
|
22
|
-
- **Constitution Compliance**: 🔵 100% (Last audit: 2026-05-
|
|
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
|
-
|
|
|
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 |
|
|
16
|
-
| Platform | Web (SaaS)
|
|
17
|
-
| Frontend | React 19 + Vite + Panda CSS |
|
|
18
|
-
| Backend | Node.js 20+ + Fastify (Full RCSR Architecture) |
|
|
19
|
-
| DB | PostgreSQL
|
|
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 |
|
|
26
|
-
| PHASE_1 |
|
|
27
|
-
| PHASE_2 |
|
|
28
|
-
| PHASE_3 |
|
|
29
|
-
| PHASE_4 |
|
|
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-
|
|
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-
|
|
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-26 — Framework Cleanup
|
|
85
45
|
- **Agent:** @manager
|
|
86
|
-
- **Action:**
|
|
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. **
|
|
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.
|
|
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.
|
|
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** (
|
|
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"
|
|
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
|
-
//
|
|
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** (
|
|
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
|
|
50
|
+
### Step 1: Repository Status & Health Audit
|
|
51
51
|
1. Run `git status` to identify pending changes.
|
|
52
|
-
2. **Health Check (Mandatory):** Run `
|
|
53
|
-
- If
|
|
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
|
-
{"
|
|
1
|
+
{"runs":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
1
|
+
{"runs":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
1
|
+
{"runs":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
1
|
+
{"runs":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
1
|
+
{"runs":[]}
|
package/.enderun/logs/git.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
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
|
-
{"
|
|
1
|
+
{"runs":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
1
|
+
{"runs":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
1
|
+
{"runs":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"
|
|
1
|
+
{"runs":[]}
|
package/README.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
# 🏛️ Agent Enderun (v0.
|
|
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.
|
|
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
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
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
|
|
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
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
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.
|
package/framework-mcp/README.md
CHANGED
|
@@ -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
|
|
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
|
|
57
|
-
- **Repo:** `
|
|
50
|
+
- **Orkestrasyon:** `send_agent_message`, `log_agent_action`.
|
|
51
|
+
- **Repo:** `generate_semantic_commit_message`.
|
|
58
52
|
|
|
59
53
|
## License
|
|
60
54
|
|
|
@@ -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.
|
|
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.
|