agent-enderun 0.8.8 → 0.9.1

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.
Files changed (164) hide show
  1. package/.enderun/BRAIN_DASHBOARD.md +5 -5
  2. package/{ENDERUN.md → .enderun/ENDERUN.md} +4 -2
  3. package/.enderun/PROJECT_MEMORY.md +32 -43
  4. package/.enderun/STATUS.md +25 -28
  5. package/.enderun/agents/agent_army_schema.json +29 -7
  6. package/.enderun/agents/backend.md +48 -39
  7. package/.enderun/agents/database.md +55 -0
  8. package/.enderun/agents/devops.md +30 -17
  9. package/.enderun/agents/explorer.md +5 -5
  10. package/.enderun/agents/frontend.md +97 -76
  11. package/.enderun/agents/git.md +4 -4
  12. package/.enderun/agents/manager.md +68 -59
  13. package/.enderun/agents/mobile.md +4 -4
  14. package/.enderun/agents/native.md +106 -0
  15. package/.enderun/agents/quality.md +122 -0
  16. package/.enderun/agents/schema/agent-lifecycle-schema.json +29 -8
  17. package/.enderun/cli-commands.json +7 -3
  18. package/.enderun/config.json +8 -2
  19. package/.enderun/knowledge/SHIM_TEMPLATE.md +25 -0
  20. package/.enderun/knowledge/context_boundary_rules.md +57 -0
  21. package/.enderun/knowledge/corporate-governance/high-risk-action-approval-flow.md +29 -0
  22. package/.enderun/knowledge/documentation_ownership.md +53 -0
  23. package/.enderun/knowledge/eslint-standards.md +63 -0
  24. package/.enderun/knowledge/frontend_professionalization_guidelines.md +7 -7
  25. package/.enderun/knowledge/hermes_live_test_guidelines.md +5 -5
  26. package/.enderun/knowledge/hermes_protocol.md +1 -1
  27. package/.enderun/knowledge/lessons-learned.md +14 -0
  28. package/.enderun/knowledge/manager_authority_audit_enforcement.md +10 -10
  29. package/.enderun/knowledge/project_scaffold_guidelines.md +4 -4
  30. package/.enderun/knowledge/reference_application_guidelines.md +6 -6
  31. package/.enderun/mcp_config.json +9 -0
  32. package/.enderun/memory-graph/agent-contexts/backend.json +1 -1
  33. package/.enderun/memory-graph/agent-contexts/devops.json +1 -1
  34. package/.enderun/memory-graph/agent-contexts/explorer.json +1 -1
  35. package/.enderun/memory-graph/agent-contexts/frontend.json +1 -1
  36. package/.enderun/memory-graph/agent-contexts/git.json +1 -1
  37. package/.enderun/memory-graph/agent-contexts/manager.json +1 -1
  38. package/.enderun/memory-graph/agent-contexts/mobile.json +1 -1
  39. package/.enderun/memory-graph/agent-contexts/native.json +1 -0
  40. package/.enderun/memory-graph/agent-contexts/quality.json +1 -0
  41. package/.enderun/memory-graph/graph.json +123 -15
  42. package/.enderun/memory-graph/shared-facts.json +26 -31
  43. package/.enderun/queue/README.md +13 -13
  44. package/README.md +171 -393
  45. package/agent.md +25 -0
  46. package/bin/cli.js +10 -10
  47. package/bin/init-check.js +69 -0
  48. package/bin/update-contract.js +57 -38
  49. package/bin/validate-agent-army.js +38 -13
  50. package/claude.md +14 -8
  51. package/docs/README.md +24 -16
  52. package/docs/architecture/README.md +9 -0
  53. package/docs/architecture/standards/data-fetching-patterns.md +13 -0
  54. package/docs/architecture/standards/design-system.md +31 -0
  55. package/docs/architecture/standards/logging.md +7 -0
  56. package/docs/architecture/standards/tech-stack.md +9 -0
  57. package/docs/getting-started.md +9 -259
  58. package/docs/user/README.md +35 -0
  59. package/docs/user/action-plan-2026.md +9 -0
  60. package/docs/user/getting-started.md +13 -0
  61. package/docs/user/roadmap.md +13 -0
  62. package/eslint.config.js +68 -0
  63. package/framework-mcp/dist/index.js +178 -24
  64. package/framework-mcp/package.json +6 -33
  65. package/framework-mcp/tsconfig.json +3 -6
  66. package/gemini.md +12 -6
  67. package/grok.md +25 -0
  68. package/package.json +13 -5
  69. package/panda.config.ts +86 -86
  70. package/src/cli/adapters.ts +208 -0
  71. package/src/cli/commands/app.ts +38 -0
  72. package/src/cli/commands/check.ts +87 -0
  73. package/src/cli/commands/compliance.ts +55 -0
  74. package/src/cli/commands/contract.ts +45 -0
  75. package/src/cli/commands/explorer.ts +45 -0
  76. package/src/cli/commands/git.ts +39 -0
  77. package/src/cli/commands/init.ts +272 -0
  78. package/src/cli/commands/knowledge.ts +44 -0
  79. package/src/cli/commands/lint.ts +25 -0
  80. package/src/cli/commands/log.ts +37 -0
  81. package/src/cli/commands/memory.ts +78 -0
  82. package/src/cli/commands/orchestrate.ts +111 -0
  83. package/src/cli/commands/script.ts +20 -0
  84. package/src/cli/commands/security.ts +38 -0
  85. package/src/cli/commands/status.ts +59 -0
  86. package/src/cli/commands/trace.ts +46 -0
  87. package/src/cli/index.ts +74 -2155
  88. package/src/cli/utils/app.ts +764 -0
  89. package/src/cli/utils/claude.ts +56 -0
  90. package/src/cli/utils/fs.ts +139 -0
  91. package/src/cli/utils/memory.ts +141 -0
  92. package/src/cli/utils/pkg.ts +215 -0
  93. package/src/cli/utils/string.ts +48 -0
  94. package/src/cli/utils/time.ts +27 -0
  95. package/tsconfig.json +9 -0
  96. package/.enderun/agents/analyst.md +0 -238
  97. package/.enderun/agents/orchestrator.md +0 -172
  98. package/.enderun/agents/qa.md +0 -124
  99. package/.enderun/agents/security.md +0 -202
  100. package/.enderun/knowledge/api_design_rules.md +0 -6
  101. package/.enderun/knowledge/branded_types_pattern.md +0 -8
  102. package/.enderun/knowledge/code_review_checklist.md +0 -7
  103. package/.enderun/knowledge/contract_versioning.md +0 -7
  104. package/.enderun/knowledge/database_migration.md +0 -6
  105. package/.enderun/knowledge/deployment_checklist.md +0 -7
  106. package/.enderun/knowledge/git_commit_strategy.md +0 -10
  107. package/.enderun/knowledge/monitoring_setup.md +0 -5
  108. package/.enderun/knowledge/performance_guidelines.md +0 -11
  109. package/.enderun/knowledge/repository_patterns.md +0 -9
  110. package/.enderun/knowledge/security_scanning.md +0 -6
  111. package/.enderun/knowledge/testing_standards.md +0 -7
  112. package/.enderun/knowledge/troubleshooting_guide.md +0 -5
  113. package/.enderun/logs/analyst.json +0 -1
  114. package/.enderun/logs/backend.json +0 -1
  115. package/.enderun/logs/devops.json +0 -1
  116. package/.enderun/logs/explorer.json +0 -1
  117. package/.enderun/logs/frontend.json +0 -1
  118. package/.enderun/logs/git.json +0 -1
  119. package/.enderun/logs/manager.json +0 -1
  120. package/.enderun/logs/mobile.json +0 -1
  121. package/.enderun/logs/native.json +0 -1
  122. package/.enderun/logs/orchestrator.json +0 -1
  123. package/.enderun/logs/qa.json +0 -1
  124. package/.enderun/logs/security.json +0 -1
  125. package/.enderun/memory-graph/agent-contexts/analyst.json +0 -1
  126. package/.enderun/memory-graph/agent-contexts/orchestrator.json +0 -1
  127. package/.enderun/memory-graph/agent-contexts/qa.json +0 -1
  128. package/.enderun/memory-graph/agent-contexts/security.json +0 -1
  129. package/.env.example +0 -10
  130. package/cursor.md +0 -19
  131. package/docs/action-plan-2026.md +0 -119
  132. package/docs/roadmap.md +0 -142
  133. package/framework-mcp/README.md +0 -55
  134. package/framework-mcp/dist/schemas.js +0 -84
  135. package/framework-mcp/dist/tools/codebase.js +0 -294
  136. package/framework-mcp/dist/tools/contract.js +0 -197
  137. package/framework-mcp/dist/tools/framework.js +0 -225
  138. package/framework-mcp/dist/tools/git.js +0 -51
  139. package/framework-mcp/dist/tools/governance.js +0 -696
  140. package/framework-mcp/dist/tools/index.js +0 -47
  141. package/framework-mcp/dist/tools/knowledge.js +0 -133
  142. package/framework-mcp/dist/tools/memory.js +0 -217
  143. package/framework-mcp/dist/tools/messages.js +0 -193
  144. package/framework-mcp/dist/tools/monitoring.js +0 -294
  145. package/framework-mcp/dist/tools/orchestration.js +0 -369
  146. package/framework-mcp/dist/tools/pipeline.js +0 -267
  147. package/framework-mcp/dist/tools/security.js +0 -137
  148. package/framework-mcp/dist/utils.js +0 -121
  149. package/framework-mcp/src/index.ts +0 -49
  150. package/framework-mcp/src/schemas.ts +0 -106
  151. package/framework-mcp/src/tools/codebase.ts +0 -284
  152. package/framework-mcp/src/tools/contract.ts +0 -221
  153. package/framework-mcp/src/tools/framework.ts +0 -223
  154. package/framework-mcp/src/tools/git.ts +0 -42
  155. package/framework-mcp/src/tools/governance.ts +0 -891
  156. package/framework-mcp/src/tools/index.ts +0 -50
  157. package/framework-mcp/src/tools/knowledge.ts +0 -141
  158. package/framework-mcp/src/tools/memory.ts +0 -207
  159. package/framework-mcp/src/tools/messages.ts +0 -213
  160. package/framework-mcp/src/tools/monitoring.ts +0 -351
  161. package/framework-mcp/src/tools/orchestration.ts +0 -440
  162. package/framework-mcp/src/tools/pipeline.ts +0 -353
  163. package/framework-mcp/src/tools/security.ts +0 -143
  164. package/framework-mcp/src/utils.ts +0 -130
@@ -48,7 +48,7 @@ Every message sent via `send_agent_message` must follow this conceptual structur
48
48
  1. **Dispatch:** Agent calls `send_agent_message`. Message is saved in `.enderun/messages/recipient.json`.
49
49
  2. **Notification:** The recipient agent checks their inbox during their turn via `read_agent_messages`.
50
50
  3. **Acknowledgment:** For `ACTION` or `DELEGATION`, the recipient should send an `INFO` message back once started or completed.
51
- 4. **Logging:** All critical communications must be summarized in the agent's specific log file (`.enderun/logs/{agent_name}.json`).
51
+ 4. **Logging:** All critical communications must be summarized in the agent's log file (`.enderun/logs/agent.json`).
52
52
 
53
53
  ---
54
54
 
@@ -0,0 +1,14 @@
1
+ # Lessons Learned - Agent Enderun
2
+
3
+ This repository stores the collective intelligence of the Agent Army. Every failure is analyzed, and a corresponding "Prevention Rule" is established here.
4
+
5
+ ## Structure of a Lesson
6
+ - **Trace ID:** The original task chain ID.
7
+ - **Agent:** The agent responsible for the failure.
8
+ - **Root Cause:** Deep analysis of why the failure occurred.
9
+ - **Solution:** How the failure was resolved.
10
+ - **Prevention Rule:** A mandatory rule added to the agent's Core Rules or `ENDERUN.md` to prevent recurrence.
11
+
12
+ ## Archive
13
+
14
+ *(No lessons learned yet. System is in pristine state.)*
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 Mayıs 2026
5
+ **Last Updated:** 23 May 2026
6
6
 
7
7
  ## Purpose
8
8
 
@@ -12,14 +12,14 @@ Even though strong rules exist in individual agent files, without a systematic a
12
12
 
13
13
  ## Why This Is Necessary
14
14
 
15
- From the agent control audit (23 Mayıs 2026):
15
+ From the agent control audit (23 May 2026):
16
16
 
17
17
  - @backend, @frontend, @analyst, and @explorer have partial governance rules, but enforcement is inconsistent.
18
- - @git and @mobile have almost no @manager control defined.
18
+ - @git, @mobile, and @native have almost no @manager control defined.
19
19
  - Hermes usage and High-Risk Admin compliance are still largely declarative in many agents.
20
20
  - Memory Discipline and briefing requirements are frequently bypassed in practice.
21
21
 
22
- Without regular auditing and clear enforcement, the "Tek Giriş Noktası" and "Sıfır Tolerans" principles lose effectiveness.
22
+ Without regular auditing and clear enforcement, the "Single Point of Authority" and "Zero Tolerance" principles lose effectiveness.
23
23
 
24
24
  ## Core Principles
25
25
 
@@ -60,7 +60,7 @@ Without regular auditing and clear enforcement, the "Tek Giriş Noktası" and "S
60
60
  - [ ] @analyst: QA gate enforcement and escalation to @manager verified?
61
61
  - [ ] @explorer: Proactive risk reporting via Hermes verified?
62
62
  - [ ] @git: High-risk commits only with @manager approval?
63
- - [ ] @mobile: Any work done without @manager briefing?
63
+ - [ ] @mobile / @native: Any work done without @manager briefing?
64
64
 
65
65
  ## Enforcement Mechanisms
66
66
 
@@ -77,10 +77,10 @@ When a violation is detected, @manager must apply the following in order:
77
77
 
78
78
  This authority system directly supports the closure of multiple risks:
79
79
 
80
- - Referans Uygulama Yokluğu
81
- - @frontend Zayıflığı
82
- - Hermes “Kağıt Üzerinde
83
- - Gerçek Kullanım Eksikliği
80
+ - Lack of Reference Application
81
+ - @frontend Weakness
82
+ - Hermes “On Paper
83
+ - Lack of Real-world Usage
84
84
 
85
85
  Every time a reference application or major task is executed, @manager must run an Authority Audit and record findings.
86
86
 
@@ -92,7 +92,7 @@ Every time a reference application or major task is executed, @manager must run
92
92
 
93
93
  ## Related Documents
94
94
 
95
- - `.enderun/agents/manager.md` → Kurumsal Proje İçin @manager Zorunlu Davranış Kuralları + Hermes Communication Mandate
95
+ - `.enderun/agents/manager.md` → Mandatory @manager Behavioral Rules for Enterprise Projects + Hermes Communication Mandate
96
96
  - `.enderun/knowledge/hermes_live_test_guidelines.md`
97
97
  - `.enderun/knowledge/frontend_professionalization_guidelines.md`
98
98
  - `.enderun/knowledge/reference_application_guidelines.md`
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 Mayıs 2026
5
+ **Last Updated:** 23 May 2026
6
6
 
7
7
  ## Purpose
8
8
 
@@ -14,8 +14,8 @@ The goal is to move from "empty `apps/` folder" to a **minimal but meaningful pr
14
14
 
15
15
  @manager should initiate a project scaffold in the following cases:
16
16
 
17
- - The Risk Tracking Dashboard shows **"Referans Uygulama Yokluğu"** as a top-priority open risk.
18
- - The team needs a concrete starting point to validate governance rules (especially Kurumsal CRUD Yönetişimi and Hermes).
17
+ - The Risk Tracking Dashboard shows **"Lack of Reference Application"** as a top-priority open risk.
18
+ - The team needs a concrete starting point to validate governance rules (especially Corporate CRUD Governance and Hermes).
19
19
  - A new major capability needs to be proven before being used in client projects.
20
20
  - During the early stages of Phase 1 or Phase 2 when moving from theory to real implementation.
21
21
 
@@ -74,7 +74,7 @@ Any project scaffold created with Agent Enderun **must** include at least the fo
74
74
  - The scaffold must respect the **Framework vs User Project Boundary** (only work inside `apps/`).
75
75
  - The scaffold is **temporary and educational** — it is meant to prove concepts, not to become a full product.
76
76
  - All high-risk operations in the scaffold must follow the `managerApproval` + Hermes + audit pattern.
77
- - After successful completion, update the Risk Tracking Dashboard to reflect progress on "Referans Uygulama Yokluğu".
77
+ - After successful completion, update the Risk Tracking Dashboard to reflect progress on "Lack of Reference Application".
78
78
 
79
79
  ## Success Criteria
80
80
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Version:** 1.0
4
4
  **Owner:** @manager
5
- **Last Updated:** 23 Mayıs 2026
5
+ **Last Updated:** 23 May 2026
6
6
 
7
7
  ## Purpose
8
8
 
@@ -14,8 +14,8 @@ The goal of a reference application is to **prove** that Agent Enderun’s gover
14
14
 
15
15
  @manager should initiate a reference application in the following situations:
16
16
 
17
- - The Risk Tracking Dashboard shows **"Referans Uygulama Yokluğu"** as a top-priority open risk.
18
- - The team needs to validate that new governance rules (especially Kurumsal CRUD Yönetişimi and Hermes) work end-to-end.
17
+ - The Risk Tracking Dashboard shows **"Lack of Reference Application"** as a top-priority open risk.
18
+ - The team needs to validate that new governance rules (especially Corporate CRUD Governance and Hermes) work end-to-end.
19
19
  - A new major capability (e.g., advanced Hermes flows, complex admin patterns) needs to be demonstrated before being trusted in client projects.
20
20
  - During Phase 1 or early Phase 2 when moving from theory to practice.
21
21
 
@@ -38,7 +38,7 @@ Any reference application **must** demonstrate the following:
38
38
  - At least one real inter-agent message flow (e.g., @backend → @analyst or @manager → @backend)
39
39
  - Proper use of `send_agent_message` + `update_agent_message_status`
40
40
 
41
- 5. **Kurumsal Yönetişim Compliance**
41
+ 5. **Corporate Governance Compliance**
42
42
  - All high-risk actions must go through @manager briefing and approval
43
43
  - Full audit logging with Trace ID, previousState/newState, and actor
44
44
 
@@ -73,7 +73,7 @@ This scope is small enough to build quickly but rich enough to prove the most cr
73
73
 
74
74
  - Never create a reference application without an explicit @manager briefing.
75
75
  - The reference app is **temporary and educational** — it is not a product.
76
- - After the reference application successfully closes the "Referans Uygulama Yokluğu" risk, it may be archived or replaced with a cleaner example.
76
+ - After the reference application successfully closes the "Lack of Reference Application" risk, it may be archived or replaced with a cleaner example.
77
77
  - All work must be logged in HISTORY and the Risk Tracking Dashboard must be updated.
78
78
 
79
79
  ## Updating Risk Status
@@ -81,7 +81,7 @@ This scope is small enough to build quickly but rich enough to prove the most cr
81
81
  When a reference application is completed and accepted:
82
82
 
83
83
  1. Update the Risk Tracking Dashboard in both `docs/roadmap.md` and `PROJECT_MEMORY.md`
84
- 2. Mark "Referans Uygulama Yokluğu" as **Closed**
84
+ 2. Mark "Lack of Reference Application" as **Closed**
85
85
  3. Record the achievement in the HISTORY section of PROJECT_MEMORY.md
86
86
  4. Optionally create a short "Reference Application Walkthrough" under `docs/`
87
87
 
@@ -0,0 +1,9 @@
1
+ {
2
+ "mcpServers": {
3
+ "agent-enderun": {
4
+ "command": "node",
5
+ "args": ["framework-mcp/dist/index.js"],
6
+ "env": {}
7
+ }
8
+ }
9
+ }
@@ -1 +1 @@
1
- { "agent": "@backend", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
1
+ {"agent": "backend", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -1 +1 @@
1
- { "agent": "@devops", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
1
+ {"agent": "devops", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -1 +1 @@
1
- { "agent": "@explorer", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
1
+ {"agent": "explorer", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -1 +1 @@
1
- { "agent": "@frontend", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
1
+ {"agent": "frontend", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -1 +1 @@
1
- { "agent": "@git", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
1
+ {"agent": "git", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -1 +1 @@
1
- { "agent": "@manager", "version": "1.0.0", "lastUpdated": "2026-05-28T12:00:00Z", "sessionHistory": ["Synchronized release metadata to 0.8.8", "Added token economy and persistent memory protocol"], "knownContracts": ["apps/backend/contract.version.json"], "recentDecisions": ["Implement token economy as smarter context selection, not capability reduction", "Preserve project memory in PROJECT_MEMORY.md and agent-contexts"], "watchedFiles": ["ENDERUN.md", ".enderun/PROJECT_MEMORY.md", ".enderun/memory-graph/shared-facts.json", ".enderun/agents/manager.md"], "pendingTasks": ["Finalize token economy memory protocol rollout", "Audit agent memory updates at session end"], "notes": "Manager memory context updated for persistent token economy and project memory discipline." }
1
+ {"agent": "manager", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -1 +1 @@
1
- { "agent": "@mobile", "version": "1.0.0", "lastUpdated": "2026-05-25T17:00:00Z", "sessionHistory": [], "knownContracts": [], "recentDecisions": [], "watchedFiles": [], "pendingTasks": [], "notes": "Context initialized." }
1
+ {"agent": "mobile", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -0,0 +1 @@
1
+ {"agent": "native", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
@@ -0,0 +1 @@
1
+ {"agent": "quality", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Merged from analyst, qa, and security agents."}
@@ -4,22 +4,130 @@
4
4
  "generatedAt": "2026-05-25T17:00:00Z",
5
5
  "updatedAt": "2026-05-25T17:00:00Z",
6
6
  "nodes": [
7
- { "id": "@manager", "state": "IDLE", "lastAction": "Framework initialized", "activeTrace": null, "healthScore": 9.5, "totalActionsThisSession": 0 },
8
- { "id": "@orchestrator", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.8, "totalActionsThisSession": 0 },
9
- { "id": "@backend", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.2, "totalActionsThisSession": 0 },
10
- { "id": "@frontend", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.0, "totalActionsThisSession": 0 },
11
- { "id": "@security", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.3, "totalActionsThisSession": 0 },
12
- { "id": "@qa", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.1, "totalActionsThisSession": 0 },
13
- { "id": "@devops", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.0, "totalActionsThisSession": 0 },
14
- { "id": "@analyst", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.6, "totalActionsThisSession": 0 },
15
- { "id": "@explorer", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.4, "totalActionsThisSession": 0 },
16
- { "id": "@git", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 9.1, "totalActionsThisSession": 0 },
17
- { "id": "@mobile", "state": "IDLE", "lastAction": null, "activeTrace": null, "healthScore": 8.8, "totalActionsThisSession": 0 }
7
+ {
8
+ "id": "@manager",
9
+ "state": "IDLE",
10
+ "lastAction": "Framework initialized",
11
+ "activeTrace": null,
12
+ "healthScore": 9.5,
13
+ "totalActionsThisSession": 0
14
+ },
15
+ {
16
+ "id": "@orchestrator",
17
+ "state": "IDLE",
18
+ "lastAction": null,
19
+ "activeTrace": null,
20
+ "healthScore": 9.8,
21
+ "totalActionsThisSession": 0
22
+ },
23
+ {
24
+ "id": "@backend",
25
+ "state": "IDLE",
26
+ "lastAction": null,
27
+ "activeTrace": null,
28
+ "healthScore": 9.2,
29
+ "totalActionsThisSession": 0
30
+ },
31
+ {
32
+ "id": "@frontend",
33
+ "state": "IDLE",
34
+ "lastAction": null,
35
+ "activeTrace": null,
36
+ "healthScore": 9,
37
+ "totalActionsThisSession": 0
38
+ },
39
+ {
40
+ "id": "@security",
41
+ "state": "IDLE",
42
+ "lastAction": null,
43
+ "activeTrace": null,
44
+ "healthScore": 9.3,
45
+ "totalActionsThisSession": 0
46
+ },
47
+ {
48
+ "id": "@qa",
49
+ "state": "IDLE",
50
+ "lastAction": null,
51
+ "activeTrace": null,
52
+ "healthScore": 9.1,
53
+ "totalActionsThisSession": 0
54
+ },
55
+ {
56
+ "id": "@devops",
57
+ "state": "IDLE",
58
+ "lastAction": null,
59
+ "activeTrace": null,
60
+ "healthScore": 9,
61
+ "totalActionsThisSession": 0
62
+ },
63
+ {
64
+ "id": "@analyst",
65
+ "state": "IDLE",
66
+ "lastAction": null,
67
+ "activeTrace": null,
68
+ "healthScore": 9.6,
69
+ "totalActionsThisSession": 0
70
+ },
71
+ {
72
+ "id": "@explorer",
73
+ "state": "IDLE",
74
+ "lastAction": null,
75
+ "activeTrace": null,
76
+ "healthScore": 9.4,
77
+ "totalActionsThisSession": 0
78
+ },
79
+ {
80
+ "id": "@git",
81
+ "state": "IDLE",
82
+ "lastAction": null,
83
+ "activeTrace": null,
84
+ "healthScore": 9.1,
85
+ "totalActionsThisSession": 0
86
+ },
87
+ {
88
+ "id": "@mobile",
89
+ "state": "IDLE",
90
+ "lastAction": null,
91
+ "activeTrace": null,
92
+ "healthScore": 8.8,
93
+ "totalActionsThisSession": 0
94
+ },
95
+ {
96
+ "id": "@native",
97
+ "state": "IDLE",
98
+ "lastAction": null,
99
+ "activeTrace": null,
100
+ "healthScore": 8.9,
101
+ "totalActionsThisSession": 0
102
+ }
18
103
  ],
19
104
  "edges": [],
20
105
  "schema": {
21
- "nodeFields": ["id", "state", "lastAction", "activeTrace", "healthScore", "totalActionsThisSession"],
22
- "edgeFields": ["id", "from", "to", "type", "traceId", "timestamp", "metadata"],
23
- "edgeTypes": ["DELEGATED", "ESCALATED", "BLOCKED_BY", "UNBLOCKED_BY", "BROADCAST", "COLLABORATED", "REVIEWED"]
106
+ "nodeFields": [
107
+ "id",
108
+ "state",
109
+ "lastAction",
110
+ "activeTrace",
111
+ "healthScore",
112
+ "totalActionsThisSession"
113
+ ],
114
+ "edgeFields": [
115
+ "id",
116
+ "from",
117
+ "to",
118
+ "type",
119
+ "traceId",
120
+ "timestamp",
121
+ "metadata"
122
+ ],
123
+ "edgeTypes": [
124
+ "DELEGATED",
125
+ "ESCALATED",
126
+ "BLOCKED_BY",
127
+ "UNBLOCKED_BY",
128
+ "BROADCAST",
129
+ "COLLABORATED",
130
+ "REVIEWED"
131
+ ]
24
132
  }
25
- }
133
+ }
@@ -1,51 +1,46 @@
1
1
  {
2
2
  "version": "1.0.0",
3
3
  "description": "Shared facts available to ALL agents in the Enderun Army. This is the single source of truth for project-wide knowledge that every agent must know.",
4
- "updatedAt": "2026-05-25T17:00:00Z",
4
+ "updatedAt": "2026-05-29T15:00:00Z",
5
5
  "updatedBy": "@manager",
6
6
  "techStack": {
7
- "backend": "Node.js 20+ + Fastify (RCSR Architecture)",
7
+ "backend": "Node.js 22+ + Fastify (RCSR Architecture)",
8
8
  "frontend": "React 19 + Vite + Panda CSS",
9
- "mobile": "React Native CLI",
10
9
  "database": "PostgreSQL (Multi-Tenant RLS + PostGIS)",
11
10
  "orm": "Kysely",
12
11
  "testing": "Vitest",
13
- "typeSystem": "TypeScript 5 (strict mode, no any, branded types)",
12
+ "typeSystem": "TypeScript 6 (strict mode, no any, branded types)",
14
13
  "monorepo": "npm workspaces",
15
- "cicd": "GitHub Actions (to be configured by @devops)"
14
+ "cicd": "GitHub Actions"
16
15
  },
17
16
  "criticalDecisions": [
18
- { "date": "2026-05-21", "decision": "No Docker Support", "rationale": "Direct system execution for performance", "decidedBy": "@manager" },
19
- { "date": "2026-05-21", "decision": "Zero Mock Policy", "rationale": "All analytical and management UIs connected to real APIs", "decidedBy": "@manager" },
20
- { "date": "2026-05-23", "decision": "PostgreSQL Unlogged Table Cache instead of Redis", "rationale": "Minimize external infrastructure dependencies", "decidedBy": "@manager" }
17
+ {
18
+ "date": "2026-05-29",
19
+ "decision": "Grand Governance Audit Completed",
20
+ "rationale": "Restored CLI, updated paths to .enderun/, and enforced autonomous MCP tools.",
21
+ "decidedBy": "@manager"
22
+ },
23
+ {
24
+ "date": "2026-05-29",
25
+ "decision": "Cursor IDE Deprecation",
26
+ "rationale": "Claude Code selected as primary operational surgery tool.",
27
+ "decidedBy": "@manager"
28
+ },
29
+ {
30
+ "date": "2026-05-21",
31
+ "decision": "Zero Mock Policy",
32
+ "rationale": "All analytical UIs connected to real APIs",
33
+ "decidedBy": "@manager"
34
+ }
21
35
  ],
22
36
  "activePolicies": [
23
37
  "Zero Mock Policy — no fake data anywhere in the codebase",
24
38
  "Branded Types Law — all IDs must use branded types",
25
- "Shared Component Firstno UI elements defined in page files",
26
- "Contract-First@backend defines types before @frontend starts",
27
- "No any TypeTypeScript strict mode enforced across all packages",
28
- "No console.log in production code",
39
+ "Surgical Edit Standarduse replace_text via MCP",
40
+ "Autonomous Growth agents authorized to use create_app",
41
+ "Hermes Messaging Protocolmandatory for inter-agent traffic",
29
42
  "Audit Log Mandatory — every agent action must be logged"
30
43
  ],
31
- "activeContracts": {
32
- "contractVersionFile": "apps/backend/contract.version.json",
33
- "currentVersion": "latest — check file",
34
- "sharedTypesLocation": "apps/backend/src/types/"
35
- },
36
- "agentCapabilityRoster": [
37
- { "agent": "@manager", "capability": 9.5, "primaryDomain": "governance" },
38
- { "agent": "@orchestrator", "capability": 9.8, "primaryDomain": "orchestration" },
39
- { "agent": "@analyst", "capability": 9.6, "primaryDomain": "analysis" },
40
- { "agent": "@explorer", "capability": 9.4, "primaryDomain": "exploration" },
41
- { "agent": "@security", "capability": 9.3, "primaryDomain": "security" },
42
- { "agent": "@backend", "capability": 9.2, "primaryDomain": "backend" },
43
- { "agent": "@git", "capability": 9.1, "primaryDomain": "git" },
44
- { "agent": "@qa", "capability": 9.1, "primaryDomain": "qa" },
45
- { "agent": "@frontend", "capability": 9.0, "primaryDomain": "frontend" },
46
- { "agent": "@devops", "capability": 9.0, "primaryDomain": "devops" },
47
- { "agent": "@mobile", "capability": 8.8, "primaryDomain": "mobile" }
48
- ],
49
- "frameworkVersion": "0.8.8",
44
+ "frameworkVersion": "0.9.0",
50
45
  "constitutionFile": "ENDERUN.md"
51
46
  }
@@ -1,18 +1,18 @@
1
- # .enderun/queue — Agent Görev Kuyruğu
1
+ # .enderun/queue — Agent Task Queue
2
2
 
3
- Bu dizin, Agent Enderun Army'nin file-based asenkron görev kuyruğunu içerir.
3
+ This directory contains the file-based asynchronous task queue for the Agent Enderun Army.
4
4
 
5
- ## Alt Dizinler
5
+ ## Alt Directoryler
6
6
 
7
- | Dizin | İçerik |
7
+ | Directory | Content |
8
8
  |---|---|
9
- | `pending/` | Atanmış ama henüz başlatılmamış görevler (`{traceId}.json`) |
10
- | `processing/` | Aktif olarak yürütülen görevler |
11
- | `completed/` | Başarıyla tamamlanan görevler (arşiv) |
12
- | `failed/` | Başarısız görevler (retry logic ile yönetilir) |
13
- | `pipelines/` | `create_execution_pipeline` MCP tool tarafından oluşturulan pipeline JSON dosyaları |
9
+ | `pending/` | Assigned but not yet started tasks (`{traceId}.json`) |
10
+ | `processing/` | Tasks currently being executed |
11
+ | `completed/` | Successfully completed tasks (archive) |
12
+ | `failed/` | Failed tasks (managed by retry logic) |
13
+ | `pipelines/` | `create_execution_pipeline` MCP tool pipeline JSON files generated by |
14
14
 
15
- ## Görev Dosyası Formatı
15
+ ## Task File Format
16
16
 
17
17
  ```json
18
18
  {
@@ -29,8 +29,8 @@ Bu dizin, Agent Enderun Army'nin file-based asenkron görev kuyruğunu içerir.
29
29
  }
30
30
  ```
31
31
 
32
- ## Kilitleme Protokolü
32
+ ## Locking Protocol
33
33
 
34
- Bir dosyaya yazmadan önce `.lock` dosyasını kontrol et.
34
+ Before writing to a file `.lock` check the
35
35
  Varsa 500ms bekle, max 3 retry.
36
- 3 retry sonrası stale lock sayılır ve @manager'a bildirilir.
36
+ After 3 retries, it is considered a stale lock and reported to @manager.