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.
@@ -34,7 +34,13 @@
34
34
 
35
35
  ## HISTORY (Persistent Memory)
36
36
 
37
- ### 2026-05-20 — Framework Reborn v0.6.0
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.
@@ -15,7 +15,7 @@
15
15
 
16
16
  ## 📈 Intelligence Metrics
17
17
 
18
- - **Current Version:** v0.6.0
18
+ - **Current Version:** v0.6.1
19
19
  - **System Health:** 🟢 GREEN
20
20
  - **Total Traces:** 0
21
21
  - **Active Tasks:** 0
@@ -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.0 Master
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 shared-types reference correct?** Does it match `packages/shared-types/src/`?
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.0 Master
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.0 Master
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.0 Master
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
 
@@ -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.0 Master
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.0 Master
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.0 Master
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 `packages/shared-types/` → Use the standardized types.
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.0 Master
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 `packages/shared-types/` → Use the standardized types.
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
 
@@ -1,4 +1,4 @@
1
- import { ApiError } from "@agent-enderun/shared-types";
1
+ import { ApiError } from "../types/index.js";
2
2
 
3
3
  /**
4
4
  * Base Domain Error
@@ -12,27 +12,26 @@
12
12
 
13
13
  ## Architectural Patterns
14
14
 
15
- - **Contract-First Development:** All API and data models are defined in `packages/shared-types` before implementation.
16
- - **Branded Types Law:** All unique identifiers must be branded to prevent type-collision and runtime errors.
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
- ## Monorepo Structure
30
+ ## Project Structure
30
31
 
31
32
  ```text
32
33
  /
33
- ├── apps/ # Production applications (web, backend, etc.)
34
- ├── packages/ # Shared libraries
35
- │ ├── shared-types/ # Single source of truth for types
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
  ```
@@ -1,4 +1,4 @@
1
- # Contract Versioning (v0.6.0)
1
+ # Contract Versioning (v0.6.1)
2
2
 
3
3
  ## Workflow
4
4
  1. **Change**: Modify types in `apps/backend/src/types`.
package/ENDERUN.md CHANGED
@@ -1,4 +1,4 @@
1
- # Agent Enderun (v0.6.0)
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 (`shared-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.
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.0) — The Supreme AI Governance Framework
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/ + packages/)
167
+ ### Layer 2: Framework Core (bin/ + framework-mcp/)
168
168
  ```
169
169
  bin/cli.js ← CLI bootstrapper
170
- packages/
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
- ├── packages/
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 packages/shared-types && ${runCmd} build --prefix framework-mcp`,
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 = ["packages/*"];
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 shared-types contract");
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");
@@ -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, "packages/shared-types/contract.version.json");
16
- const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
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.0";
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,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-enderun-mcp",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "Enterprise-grade MCP Server for AI Agent Framework",
5
5
  "author": "Yusuf BEKAR",
6
6
  "license": "MIT",
@@ -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.0";
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"];
@@ -6,7 +6,7 @@
6
6
  "agent-enderun": {
7
7
  "command": "node",
8
8
  "args": [
9
- "packages/framework-mcp/dist/index.js"
9
+ "framework-mcp/dist/index.js"
10
10
  ]
11
11
  }
12
12
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-enderun",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
5
5
  "author": "Yusuf BEKAR",
6
6
  "license": "MIT",