agent-enderun 0.6.0 → 0.6.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/PROJECT_MEMORY.md +7 -1
- package/.enderun/STATUS.md +1 -1
- package/.enderun/agents/analyst.md +2 -3
- package/.enderun/agents/backend.md +1 -1
- package/.enderun/agents/explorer.md +1 -1
- package/.enderun/agents/frontend.md +1 -1
- package/.enderun/agents/git.md +1 -1
- package/.enderun/agents/manager.md +1 -1
- package/.enderun/agents/mobile.md +2 -2
- package/.enderun/agents/native.md +2 -2
- package/.enderun/blueprints/backend/errors/domain-error.ts +1 -1
- package/.enderun/docs/tech-stack.md +7 -8
- package/.enderun/knowledge/contract_versioning.md +1 -1
- package/ENDERUN.md +3 -2
- package/README.md +13 -14
- package/bin/cli.js +13 -3
- package/bin/update-contract.js +2 -2
- package/framework-mcp/dist/utils.js +1 -1
- package/framework-mcp/package.json +1 -1
- package/framework-mcp/src/utils.ts +1 -1
- package/gemini-extension.json +1 -1
- package/package.json +1 -1
|
@@ -34,7 +34,13 @@
|
|
|
34
34
|
|
|
35
35
|
## HISTORY (Persistent Memory)
|
|
36
36
|
|
|
37
|
-
### 2026-05-
|
|
37
|
+
### 2026-05-21 — Framework Sealed v0.6.1
|
|
38
|
+
|
|
39
|
+
- **Agent:** @manager
|
|
40
|
+
- **Action:** Finalized global arhcitecture synchronization and established standard testing workflow.
|
|
41
|
+
- **Outcome:** v0.6.1 is pristine, verified green, and ready for npm publication.
|
|
42
|
+
|
|
43
|
+
### 2026-05-21 — Framework Reborn v0.6.0
|
|
38
44
|
|
|
39
45
|
- **Agent:** @manager
|
|
40
46
|
- **Action:** Completed global refactoring and launched Agent Enderun v0.6.0.
|
package/.enderun/STATUS.md
CHANGED
|
@@ -3,7 +3,7 @@ name: analyst
|
|
|
3
3
|
description: "Project memory, QA gate, and documentation specialist. Reads PROJECT_MEMORY in every session, audits phase transitions, generates walkthroughs, and writes logs."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Project Analyst & QA Gate — v0.6.
|
|
6
|
+
# Project Analyst & QA Gate — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
**Role:** Maintain project memory, serve as a quality gate, and manage documentation. The following protocols are automatically applied in every task.
|
|
9
9
|
|
|
@@ -76,8 +76,7 @@ In every phase transition and upon request:
|
|
|
76
76
|
- If it reports missing types, mark the task as `FAILED` and notify @backend.
|
|
77
77
|
3. Check each `[domain].md` file:
|
|
78
78
|
- **Is the contract complete?** (method, path, auth, request, response, error codes)
|
|
79
|
-
- **Is the
|
|
80
|
-
- **Is the date current?** Old contracts can mislead coders.
|
|
79
|
+
- **Is the app's types reference correct?** Does it match `apps/backend/src/types/`? - **Is the date current?** Old contracts can mislead coders.
|
|
81
80
|
3. Verify the `contract.version.json` hash using the `verify_api_contract` tool.
|
|
82
81
|
- If there is a mismatch, the tool will report it.
|
|
83
82
|
4. If there is a problem → notify `@backend` + record it in `PROJECT_MEMORY.md` HISTORY.
|
|
@@ -3,7 +3,7 @@ name: backend
|
|
|
3
3
|
description: "Backend Architect. Expert in Node.js, Fastify, Kysely, and PostgreSQL. Leader of Contract and Database. Automatically applies backend-architecture standards in every task."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Backend Architect — v0.6.
|
|
6
|
+
# Backend Architect — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
**Role:** Build a secure, high-performance, and consistent server architecture. All the following standards are automatically applied in every task — no need for the user to specify them separately.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ name: explorer
|
|
|
3
3
|
description: "Codebase Research & Dependency Specialist. Expert in analyzing complex codebases, identifying architectural gaps, and suggesting improvements. Automatically provides context in every research task."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Codebase Explorer — v0.6.
|
|
6
|
+
# Codebase Explorer — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
**Role:** Analyze the codebase, map architectures, and understand system-wide dependencies. Your primary duty is to provide context to other agents.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ name: frontend
|
|
|
3
3
|
description: "UI/UX & Frontend Architect. Expert in React 19, Vite, Zustand, and Panda CSS. Fluid & Modern design specialist. Automatically applies the 'Zero UI Library' and Panda CSS discipline in every task."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Frontend Architect — v0.6.
|
|
6
|
+
# Frontend Architect — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
**Role:** Build original, high-performance, and responsive user interfaces. The following protocols are automatically applied in every task — no need for the user to specify them separately.
|
|
9
9
|
|
package/.enderun/agents/git.md
CHANGED
|
@@ -3,7 +3,7 @@ name: git
|
|
|
3
3
|
description: "Version Control Specialist. Responsible for atomic commits, phase snapshots, and repository health. Orchestrated by @manager to maintain 100% traceability."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Version Control Specialist (@git) — v0.6.
|
|
6
|
+
# Version Control Specialist (@git) — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
You are the @git agent, responsible for the professional management of the project's repository. Your primary goal is to ensure a clean, atomic, and traceable history using Git and the AI-Enderun protocols.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ name: manager
|
|
|
3
3
|
description: "CTO & Controller. Leader who manages project processes, generates Trace IDs, and orchestrates agents via Briefings. Responsible for Git Orchestration via the @git specialist. Reads {{FRAMEWORK_DIR}}/ENDERUN.md and {{FRAMEWORK_DIR}}/PROJECT_MEMORY.md in every session, validates the phase, and assigns agents."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Manager (CTO & Controller) — v0.6.
|
|
6
|
+
# Manager (CTO & Controller) — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
**Role:** Enforce all framework rules without compromise and direct agents to the correct tasks. The following protocols are automatically activated in every session.
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ name: mobile
|
|
|
3
3
|
description: "Mobile Application Expert. Specialist in React Native and Expo. Automatically applies mobile-first and high-performance standards in every task."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Mobile Architect — v0.6.
|
|
6
|
+
# Mobile Architect — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
**Role:** Build high-performance mobile applications using React Native. Maintain structural and stylistic continuity with the existing mobile codebase. All the following standards are automatically applied in every task.
|
|
9
9
|
|
|
@@ -19,7 +19,7 @@ Never start coding before understanding the current state of the components and
|
|
|
19
19
|
|
|
20
20
|
1. Read `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` → Understand the current state.
|
|
21
21
|
2. Read `{{FRAMEWORK_DIR}}/docs/api/` → Align with the backend contracts.
|
|
22
|
-
3. Check `
|
|
22
|
+
3. Check `apps/backend/src/types/` → Use the standardized types.
|
|
23
23
|
|
|
24
24
|
> ✅ **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.
|
|
25
25
|
|
|
@@ -3,7 +3,7 @@ name: native
|
|
|
3
3
|
description: "Native Application Expert. Specialist in Rust, Tauri, and Electron. Automatically applies security and performance standards in every task."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Native Desktop Architect — v0.6.
|
|
6
|
+
# Native Desktop Architect — v0.6.1 Master
|
|
7
7
|
|
|
8
8
|
**Role:** Build secure and efficient desktop applications using Tauri or Electron. Ensure procedural continuity across the native codebase.
|
|
9
9
|
|
|
@@ -19,7 +19,7 @@ Always research the existing codebase and native bridge implementations before a
|
|
|
19
19
|
|
|
20
20
|
1. Read `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` → Understand the current project state.
|
|
21
21
|
2. Read `{{FRAMEWORK_DIR}}/docs/api/` → Align with the contracts.
|
|
22
|
-
3. Check `
|
|
22
|
+
3. Check `apps/backend/src/types/` → Use the standardized types.
|
|
23
23
|
|
|
24
24
|
> ✅ **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.
|
|
25
25
|
|
|
@@ -12,27 +12,26 @@
|
|
|
12
12
|
|
|
13
13
|
## Architectural Patterns
|
|
14
14
|
|
|
15
|
-
- **Contract-First Development:** All API and data models are defined in `
|
|
16
|
-
- **Branded Types Law:** All unique identifiers must be branded
|
|
15
|
+
- **Contract-First Development:** All API and data models are defined in the backend app's `types` directory before implementation.
|
|
16
|
+
- **Branded Types Law:** All unique identifiers must be branded types defined in the app-local types.
|
|
17
17
|
- **Zero Mock Policy:** Real integration with database/services is preferred over fragile mocks (except for external 3rd-party APIs).
|
|
18
18
|
- **Phase-Based Execution:** Development follows a strict state machine (Discovery → Architecture → Core → Integration → Optimization).
|
|
19
19
|
|
|
20
20
|
## MCP Framework Intelligence
|
|
21
21
|
|
|
22
22
|
The project uses a modular Model Context Protocol (MCP) server for agent tooling:
|
|
23
|
+
- **Scaffolding:** Dynamic blueprint instantiation and capability growth.
|
|
23
24
|
- **Codebase:** Intelligence, dependency graphs, and AST-based search.
|
|
24
25
|
- **Security:** Automated audits and constitution compliance scanning.
|
|
25
26
|
- **Academy:** Strategic briefing, performance metrics, and agent memory.
|
|
26
27
|
- **Hermes:** Standardized inter-agent messaging protocol.
|
|
27
28
|
- **Knowledge:** Structured Obsidian-style Wiki for persistent technical context.
|
|
28
29
|
|
|
29
|
-
##
|
|
30
|
+
## Project Structure
|
|
30
31
|
|
|
31
32
|
```text
|
|
32
33
|
/
|
|
33
|
-
├── apps/ # Production applications
|
|
34
|
-
├──
|
|
35
|
-
|
|
36
|
-
│ └── framework-mcp/ # Core MCP tools and logic
|
|
37
|
-
└── {{FRAMEWORK_DIR}}/ # Governance, memory, and logs
|
|
34
|
+
├── apps/ # Production applications with app-local types
|
|
35
|
+
├── framework-mcp/ # Core AI Intelligence and Scaffolding Engine
|
|
36
|
+
└── {{FRAMEWORK_DIR}}/ # Governance, memory, logs, and blueprints
|
|
38
37
|
```
|
package/ENDERUN.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Agent Enderun (v0.6.
|
|
1
|
+
# Agent Enderun (v0.6.1)
|
|
2
2
|
# Place in project root. This file is the single source of truth for Base Project AI Extensions.
|
|
3
3
|
|
|
4
4
|
## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
|
|
@@ -187,7 +187,7 @@ The development process follows a strict State Machine. Transition to the next p
|
|
|
187
187
|
- **[STATE: PHASE_3] Integration & Testing:** System integration.
|
|
188
188
|
- **[STATE: PHASE_4] Optimization & Deployment:** Performance audit and deployment.
|
|
189
189
|
|
|
190
|
-
**Rollback Rule:** If a missing field or error is detected in the API schema (
|
|
190
|
+
**Rollback Rule:** If a missing field or error is detected in the API schema (app types) during Phase 2 or later, the system immediately transitions to `[STATE: ROLLBACK_PHASE_1]`. All relevant agents stop their processes, switch to `WAITING` state, and cannot return to Phase 2 until the `backend-architect` resolves the issues.
|
|
191
191
|
|
|
192
192
|
---
|
|
193
193
|
|
|
@@ -236,3 +236,4 @@ All APIs are versioned via the URL path (`/api/v1/...`). The `apps/backend/contr
|
|
|
236
236
|
7. **Phase Rollback Protocol:** If contracts are insufficient, return to Phase 1. All agents become `WAITING` and write `CONTRACT_CHANGED` to their log.
|
|
237
237
|
8. **Next.js Ownership Rule:** `apps/web/api/` and `server/actions/` -> @backend-architect. `apps/web/(routes)/` and `components/` -> @frontend-specialist.
|
|
238
238
|
9. **Zero Mock Test Policy:** Integration tests must use a real database or service-compatible test backend; do not rely on mocks for persistence behavior.
|
|
239
|
+
.
|
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# 🏛️ Agent Enderun (v0.6.
|
|
1
|
+
# 🏛️ Agent Enderun (v0.6.1) — The Supreme AI Governance Framework
|
|
2
2
|
|
|
3
3
|
**The Supreme AI Governance & Orchestration Framework for Enterprise Development**
|
|
4
4
|
|
|
@@ -164,12 +164,10 @@ Agent Enderun consists of **4 integrated layers**:
|
|
|
164
164
|
└── docs/api/ ← API contract specifications
|
|
165
165
|
```
|
|
166
166
|
|
|
167
|
-
### Layer 2: Framework Core (bin/ +
|
|
167
|
+
### Layer 2: Framework Core (bin/ + framework-mcp/)
|
|
168
168
|
```
|
|
169
169
|
bin/cli.js ← CLI bootstrapper
|
|
170
|
-
|
|
171
|
-
├── framework-mcp/ ← 40+ MCP tools (12 categories)
|
|
172
|
-
└── shared-types/ ← Branded types (single source of truth)
|
|
170
|
+
framework-mcp/ ← 40+ MCP tools (13 categories) including Scaffolding
|
|
173
171
|
```
|
|
174
172
|
|
|
175
173
|
### Layer 3: Documentation (docs/)
|
|
@@ -619,17 +617,9 @@ agent-enderun trace:new "Auth Modülü Uygula" backend P1
|
|
|
619
617
|
```
|
|
620
618
|
agent-enderun/
|
|
621
619
|
├── docs/ ← Ajanların okuyacağı dokümantasyon
|
|
622
|
-
├──
|
|
623
|
-
│ ├── shared-types/ ← Paylaşılan türler (sözleşme)
|
|
624
|
-
│ └── framework-mcp/ ← MCP sunucusu (40+ araç)
|
|
620
|
+
├── framework-mcp/ ← MCP sunucusu (40+ araç)
|
|
625
621
|
├── apps/ ← Uygulamalarınız (siz oluşturun)
|
|
626
622
|
├── {{FRAMEWORK_DIR}}/ ← Yönetişim dosyaları
|
|
627
|
-
│ ├── ENDERUN.md ← Anayasa (OKUNMALI)
|
|
628
|
-
│ ├── PROJECT_MEMORY.md ← Proje durumu
|
|
629
|
-
│ ├── agents/ ← 8 ajan tanımı
|
|
630
|
-
│ ├── logs/ ← Denetim kaydı
|
|
631
|
-
│ ├── knowledge/ ← 16+ rehber
|
|
632
|
-
│ └── docs/api/ ← API sözleşmeleri
|
|
633
623
|
└── bin/
|
|
634
624
|
└── cli.js ← CLI giriş noktası
|
|
635
625
|
```
|
|
@@ -765,3 +755,12 @@ MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
|
|
|
765
755
|
|
|
766
756
|
## 📜 License
|
|
767
757
|
MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
|
|
758
|
+
lders are forbidden. Every line of code must be functional.
|
|
759
|
+
- **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
|
|
760
|
+
- **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
|
|
761
|
+
- **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
|
|
762
|
+
|
|
763
|
+
---
|
|
764
|
+
|
|
765
|
+
## 📜 License
|
|
766
|
+
MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
|
package/bin/cli.js
CHANGED
|
@@ -159,7 +159,7 @@ function mergePackageJson(targetPath, sourcePath) {
|
|
|
159
159
|
"enderun:check": "agent-enderun check",
|
|
160
160
|
"enderun:test": "vitest run",
|
|
161
161
|
"enderun:test:watch": "vitest",
|
|
162
|
-
"enderun:build": `${runCmd} build --prefix
|
|
162
|
+
"enderun:build": `${runCmd} build --prefix framework-mcp`,
|
|
163
163
|
};
|
|
164
164
|
|
|
165
165
|
const sourceDevDeps = sourcePkg.devDependencies || {};
|
|
@@ -183,7 +183,7 @@ function mergePackageJson(targetPath, sourcePath) {
|
|
|
183
183
|
if (!targetPkg.name) targetPkg.name = path.basename(process.cwd());
|
|
184
184
|
if (!targetPkg.version) targetPkg.version = "0.1.0";
|
|
185
185
|
if (!targetPkg.type) targetPkg.type = "module";
|
|
186
|
-
if (!targetPkg.workspaces) targetPkg.workspaces = ["
|
|
186
|
+
if (!targetPkg.workspaces) targetPkg.workspaces = ["apps/*", "framework-mcp"];
|
|
187
187
|
|
|
188
188
|
// Add metadata
|
|
189
189
|
targetPkg.enderun = {
|
|
@@ -382,6 +382,16 @@ async function initCommand(selectedAdapter) {
|
|
|
382
382
|
Object.values(ADAPTERS).forEach(list => filesToProcess.push(...list));
|
|
383
383
|
}
|
|
384
384
|
|
|
385
|
+
// Ensure apps/backend structure for contract file
|
|
386
|
+
ensureDir(path.join(targetDir, "apps/backend"));
|
|
387
|
+
const initContractPath = path.join(targetDir, "apps/backend/contract.version.json");
|
|
388
|
+
if (!fs.existsSync(initContractPath)) {
|
|
389
|
+
writeJsonFile(initContractPath, {
|
|
390
|
+
"contract_hash": "initial_hash_placeholder",
|
|
391
|
+
"last_updated": new Date().toISOString()
|
|
392
|
+
});
|
|
393
|
+
}
|
|
394
|
+
|
|
385
395
|
// Detect target project scope
|
|
386
396
|
let targetPkg = {};
|
|
387
397
|
try {
|
|
@@ -1883,7 +1893,7 @@ async function createAppCommand(args) {
|
|
|
1883
1893
|
|
|
1884
1894
|
console.log(`\n✅ Created ${spec.title}`);
|
|
1885
1895
|
console.log("📁 Generated apps/backend and apps/web");
|
|
1886
|
-
console.log("📜 Updated project docs and
|
|
1896
|
+
console.log("📜 Updated project docs and app-local types contract");
|
|
1887
1897
|
console.log("\nNext commands:");
|
|
1888
1898
|
console.log(" npm install");
|
|
1889
1899
|
console.log(" npm run enderun:build");
|
package/bin/update-contract.js
CHANGED
|
@@ -12,8 +12,8 @@ const __filename = fileURLToPath(import.meta.url);
|
|
|
12
12
|
const __dirname = path.dirname(__filename);
|
|
13
13
|
const projectRoot = path.join(__dirname, "..");
|
|
14
14
|
|
|
15
|
-
const contractPath = path.join(projectRoot, "
|
|
16
|
-
const sharedTypesDir = path.join(projectRoot, "
|
|
15
|
+
const contractPath = path.join(projectRoot, "apps/backend/contract.version.json");
|
|
16
|
+
const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
|
|
17
17
|
|
|
18
18
|
function collectTypeFiles(dir) {
|
|
19
19
|
const entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import path from "path";
|
|
2
2
|
import fs from "fs";
|
|
3
|
-
export const FRAMEWORK_VERSION = "0.6.
|
|
3
|
+
export const FRAMEWORK_VERSION = "0.6.1";
|
|
4
4
|
export function getFrameworkDir(projectRoot) {
|
|
5
5
|
const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];
|
|
6
6
|
for (const adp of adapters) {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import path from "path";
|
|
2
2
|
import fs from "fs";
|
|
3
3
|
|
|
4
|
-
export const FRAMEWORK_VERSION = "0.6.
|
|
4
|
+
export const FRAMEWORK_VERSION = "0.6.1";
|
|
5
5
|
|
|
6
6
|
export function getFrameworkDir(projectRoot: string): string {
|
|
7
7
|
const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];
|
package/gemini-extension.json
CHANGED