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.
- package/.enderun/BRAIN_DASHBOARD.md +5 -5
- package/{ENDERUN.md → .enderun/ENDERUN.md} +4 -2
- package/.enderun/PROJECT_MEMORY.md +32 -43
- package/.enderun/STATUS.md +25 -28
- package/.enderun/agents/agent_army_schema.json +29 -7
- package/.enderun/agents/backend.md +48 -39
- package/.enderun/agents/database.md +55 -0
- package/.enderun/agents/devops.md +30 -17
- package/.enderun/agents/explorer.md +5 -5
- package/.enderun/agents/frontend.md +97 -76
- package/.enderun/agents/git.md +4 -4
- package/.enderun/agents/manager.md +68 -59
- package/.enderun/agents/mobile.md +4 -4
- package/.enderun/agents/native.md +106 -0
- package/.enderun/agents/quality.md +122 -0
- package/.enderun/agents/schema/agent-lifecycle-schema.json +29 -8
- package/.enderun/cli-commands.json +7 -3
- package/.enderun/config.json +8 -2
- package/.enderun/knowledge/SHIM_TEMPLATE.md +25 -0
- package/.enderun/knowledge/context_boundary_rules.md +57 -0
- package/.enderun/knowledge/corporate-governance/high-risk-action-approval-flow.md +29 -0
- package/.enderun/knowledge/documentation_ownership.md +53 -0
- package/.enderun/knowledge/eslint-standards.md +63 -0
- package/.enderun/knowledge/frontend_professionalization_guidelines.md +7 -7
- package/.enderun/knowledge/hermes_live_test_guidelines.md +5 -5
- package/.enderun/knowledge/hermes_protocol.md +1 -1
- package/.enderun/knowledge/lessons-learned.md +14 -0
- package/.enderun/knowledge/manager_authority_audit_enforcement.md +10 -10
- package/.enderun/knowledge/project_scaffold_guidelines.md +4 -4
- package/.enderun/knowledge/reference_application_guidelines.md +6 -6
- package/.enderun/mcp_config.json +9 -0
- package/.enderun/memory-graph/agent-contexts/backend.json +1 -1
- package/.enderun/memory-graph/agent-contexts/devops.json +1 -1
- package/.enderun/memory-graph/agent-contexts/explorer.json +1 -1
- package/.enderun/memory-graph/agent-contexts/frontend.json +1 -1
- package/.enderun/memory-graph/agent-contexts/git.json +1 -1
- package/.enderun/memory-graph/agent-contexts/manager.json +1 -1
- package/.enderun/memory-graph/agent-contexts/mobile.json +1 -1
- package/.enderun/memory-graph/agent-contexts/native.json +1 -0
- package/.enderun/memory-graph/agent-contexts/quality.json +1 -0
- package/.enderun/memory-graph/graph.json +123 -15
- package/.enderun/memory-graph/shared-facts.json +26 -31
- package/.enderun/queue/README.md +13 -13
- package/README.md +171 -393
- package/agent.md +25 -0
- package/bin/cli.js +10 -10
- package/bin/init-check.js +69 -0
- package/bin/update-contract.js +57 -38
- package/bin/validate-agent-army.js +38 -13
- package/claude.md +14 -8
- package/docs/README.md +24 -16
- package/docs/architecture/README.md +9 -0
- package/docs/architecture/standards/data-fetching-patterns.md +13 -0
- package/docs/architecture/standards/design-system.md +31 -0
- package/docs/architecture/standards/logging.md +7 -0
- package/docs/architecture/standards/tech-stack.md +9 -0
- package/docs/getting-started.md +9 -259
- package/docs/user/README.md +35 -0
- package/docs/user/action-plan-2026.md +9 -0
- package/docs/user/getting-started.md +13 -0
- package/docs/user/roadmap.md +13 -0
- package/eslint.config.js +68 -0
- package/framework-mcp/dist/index.js +178 -24
- package/framework-mcp/package.json +6 -33
- package/framework-mcp/tsconfig.json +3 -6
- package/gemini.md +12 -6
- package/grok.md +25 -0
- package/package.json +13 -5
- package/panda.config.ts +86 -86
- package/src/cli/adapters.ts +208 -0
- package/src/cli/commands/app.ts +38 -0
- package/src/cli/commands/check.ts +87 -0
- package/src/cli/commands/compliance.ts +55 -0
- package/src/cli/commands/contract.ts +45 -0
- package/src/cli/commands/explorer.ts +45 -0
- package/src/cli/commands/git.ts +39 -0
- package/src/cli/commands/init.ts +272 -0
- package/src/cli/commands/knowledge.ts +44 -0
- package/src/cli/commands/lint.ts +25 -0
- package/src/cli/commands/log.ts +37 -0
- package/src/cli/commands/memory.ts +78 -0
- package/src/cli/commands/orchestrate.ts +111 -0
- package/src/cli/commands/script.ts +20 -0
- package/src/cli/commands/security.ts +38 -0
- package/src/cli/commands/status.ts +59 -0
- package/src/cli/commands/trace.ts +46 -0
- package/src/cli/index.ts +74 -2155
- package/src/cli/utils/app.ts +764 -0
- package/src/cli/utils/claude.ts +56 -0
- package/src/cli/utils/fs.ts +139 -0
- package/src/cli/utils/memory.ts +141 -0
- package/src/cli/utils/pkg.ts +215 -0
- package/src/cli/utils/string.ts +48 -0
- package/src/cli/utils/time.ts +27 -0
- package/tsconfig.json +9 -0
- package/.enderun/agents/analyst.md +0 -238
- package/.enderun/agents/orchestrator.md +0 -172
- package/.enderun/agents/qa.md +0 -124
- package/.enderun/agents/security.md +0 -202
- package/.enderun/knowledge/api_design_rules.md +0 -6
- package/.enderun/knowledge/branded_types_pattern.md +0 -8
- package/.enderun/knowledge/code_review_checklist.md +0 -7
- package/.enderun/knowledge/contract_versioning.md +0 -7
- package/.enderun/knowledge/database_migration.md +0 -6
- package/.enderun/knowledge/deployment_checklist.md +0 -7
- package/.enderun/knowledge/git_commit_strategy.md +0 -10
- package/.enderun/knowledge/monitoring_setup.md +0 -5
- package/.enderun/knowledge/performance_guidelines.md +0 -11
- package/.enderun/knowledge/repository_patterns.md +0 -9
- package/.enderun/knowledge/security_scanning.md +0 -6
- package/.enderun/knowledge/testing_standards.md +0 -7
- package/.enderun/knowledge/troubleshooting_guide.md +0 -5
- package/.enderun/logs/analyst.json +0 -1
- package/.enderun/logs/backend.json +0 -1
- package/.enderun/logs/devops.json +0 -1
- package/.enderun/logs/explorer.json +0 -1
- package/.enderun/logs/frontend.json +0 -1
- package/.enderun/logs/git.json +0 -1
- package/.enderun/logs/manager.json +0 -1
- package/.enderun/logs/mobile.json +0 -1
- package/.enderun/logs/native.json +0 -1
- package/.enderun/logs/orchestrator.json +0 -1
- package/.enderun/logs/qa.json +0 -1
- package/.enderun/logs/security.json +0 -1
- package/.enderun/memory-graph/agent-contexts/analyst.json +0 -1
- package/.enderun/memory-graph/agent-contexts/orchestrator.json +0 -1
- package/.enderun/memory-graph/agent-contexts/qa.json +0 -1
- package/.enderun/memory-graph/agent-contexts/security.json +0 -1
- package/.env.example +0 -10
- package/cursor.md +0 -19
- package/docs/action-plan-2026.md +0 -119
- package/docs/roadmap.md +0 -142
- package/framework-mcp/README.md +0 -55
- package/framework-mcp/dist/schemas.js +0 -84
- package/framework-mcp/dist/tools/codebase.js +0 -294
- package/framework-mcp/dist/tools/contract.js +0 -197
- package/framework-mcp/dist/tools/framework.js +0 -225
- package/framework-mcp/dist/tools/git.js +0 -51
- package/framework-mcp/dist/tools/governance.js +0 -696
- package/framework-mcp/dist/tools/index.js +0 -47
- package/framework-mcp/dist/tools/knowledge.js +0 -133
- package/framework-mcp/dist/tools/memory.js +0 -217
- package/framework-mcp/dist/tools/messages.js +0 -193
- package/framework-mcp/dist/tools/monitoring.js +0 -294
- package/framework-mcp/dist/tools/orchestration.js +0 -369
- package/framework-mcp/dist/tools/pipeline.js +0 -267
- package/framework-mcp/dist/tools/security.js +0 -137
- package/framework-mcp/dist/utils.js +0 -121
- package/framework-mcp/src/index.ts +0 -49
- package/framework-mcp/src/schemas.ts +0 -106
- package/framework-mcp/src/tools/codebase.ts +0 -284
- package/framework-mcp/src/tools/contract.ts +0 -221
- package/framework-mcp/src/tools/framework.ts +0 -223
- package/framework-mcp/src/tools/git.ts +0 -42
- package/framework-mcp/src/tools/governance.ts +0 -891
- package/framework-mcp/src/tools/index.ts +0 -50
- package/framework-mcp/src/tools/knowledge.ts +0 -141
- package/framework-mcp/src/tools/memory.ts +0 -207
- package/framework-mcp/src/tools/messages.ts +0 -213
- package/framework-mcp/src/tools/monitoring.ts +0 -351
- package/framework-mcp/src/tools/orchestration.ts +0 -440
- package/framework-mcp/src/tools/pipeline.ts +0 -353
- package/framework-mcp/src/tools/security.ts +0 -143
- 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
|
|
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
|
|
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
|
|
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 @
|
|
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 "
|
|
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
|
-
-
|
|
81
|
-
- @frontend
|
|
82
|
-
- Hermes “
|
|
83
|
-
-
|
|
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` →
|
|
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
|
|
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 **"
|
|
18
|
-
- The team needs a concrete starting point to validate governance rules (especially
|
|
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 "
|
|
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
|
|
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 **"
|
|
18
|
-
- The team needs to validate that new governance rules (especially
|
|
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. **
|
|
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 "
|
|
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 "
|
|
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
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{
|
|
1
|
+
{"agent": "backend", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{
|
|
1
|
+
{"agent": "devops", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{
|
|
1
|
+
{"agent": "explorer", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{
|
|
1
|
+
{"agent": "frontend", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{
|
|
1
|
+
{"agent": "git", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{
|
|
1
|
+
{"agent": "manager", "version": "0.9.0", "lastUpdated": "2026-05-29T15:41:37Z", "sessionHistory": [], "notes": "Initial clean state."}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{
|
|
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
|
-
{
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
{
|
|
16
|
-
|
|
17
|
-
|
|
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": [
|
|
22
|
-
|
|
23
|
-
|
|
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-
|
|
4
|
+
"updatedAt": "2026-05-29T15:00:00Z",
|
|
5
5
|
"updatedBy": "@manager",
|
|
6
6
|
"techStack": {
|
|
7
|
-
"backend": "Node.js
|
|
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
|
|
12
|
+
"typeSystem": "TypeScript 6 (strict mode, no any, branded types)",
|
|
14
13
|
"monorepo": "npm workspaces",
|
|
15
|
-
"cicd": "GitHub Actions
|
|
14
|
+
"cicd": "GitHub Actions"
|
|
16
15
|
},
|
|
17
16
|
"criticalDecisions": [
|
|
18
|
-
{
|
|
19
|
-
|
|
20
|
-
|
|
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
|
-
"
|
|
26
|
-
"
|
|
27
|
-
"
|
|
28
|
-
"No console.log in production code",
|
|
39
|
+
"Surgical Edit Standard — use replace_text via MCP",
|
|
40
|
+
"Autonomous Growth — agents authorized to use create_app",
|
|
41
|
+
"Hermes Messaging Protocol — mandatory for inter-agent traffic",
|
|
29
42
|
"Audit Log Mandatory — every agent action must be logged"
|
|
30
43
|
],
|
|
31
|
-
"
|
|
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
|
}
|
package/.enderun/queue/README.md
CHANGED
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
# .enderun/queue — Agent
|
|
1
|
+
# .enderun/queue — Agent Task Queue
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This directory contains the file-based asynchronous task queue for the Agent Enderun Army.
|
|
4
4
|
|
|
5
|
-
## Alt
|
|
5
|
+
## Alt Directoryler
|
|
6
6
|
|
|
7
|
-
|
|
|
7
|
+
| Directory | Content |
|
|
8
8
|
|---|---|
|
|
9
|
-
| `pending/` |
|
|
10
|
-
| `processing/` |
|
|
11
|
-
| `completed/` |
|
|
12
|
-
| `failed/` |
|
|
13
|
-
| `pipelines/` | `create_execution_pipeline` MCP tool
|
|
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
|
-
##
|
|
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
|
-
##
|
|
32
|
+
## Locking Protocol
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
Before writing to a file `.lock` check the
|
|
35
35
|
Varsa 500ms bekle, max 3 retry.
|
|
36
|
-
3
|
|
36
|
+
After 3 retries, it is considered a stale lock and reported to @manager.
|