agent-enderun 0.5.9 → 0.6.0

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun (v0.5.9) — The Supreme AI Governance Framework
+# 🏛️ Agent Enderun (v0.6.0) — The Supreme AI Governance Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
@@ -317,28 +317,18 @@ agent-enderun/
 ├── bin/
 │   └── cli.js                         ← CLI entry point
 ├── docs/                              ← Your project docs (agents read these)
-│   ├── tech-stack.md
-│   └── project-docs.md
-├── packages/
-│   ├── shared-types/                  ← Branded types (contract)
-│   │   ├── src/index.ts
-│   │   └── contract.version.json      ← SHA-256 integrity hash
-│   └── framework-mcp/                 ← MCP server (40+ tools)
-│       └── src/tools/
-│           ├── academy.ts
-│           ├── codebase.ts
-│           ├── security.ts
-│           ├── contract.ts
-│           ├── git.ts
-│           ├── knowledge.ts
-│           ├── database.ts
-│           ├── memory.ts
-│           ├── messages.ts
-│           ├── repository.ts
-│           └── framework.ts
+├── framework-mcp/                     ← MCP server (40+ tools)
+│   └── src/tools/
+│       ├── scaffold.ts                ← Blueprint construction
+│       ├── academy.ts
+│       ├── codebase.ts
+│       └── [10 more...]
 ├── apps/                              ← Your applications (start here)
-│   ├── backend/                       ← (you create this)
-│   └── web/                           ← (you create this)
+│   ├── backend/
+│   │   ├── src/types/                 ← App-local contract types
+│   │   └── contract.version.json      ← SHA-256 integrity hash
+│   └── web/
+│       └── src/types/                 ← Frontend mirrors of backend types
 └── {{FRAMEWORK_DIR}}/                          ← Framework governance
     ├── ENDERUN.md                     ← Constitution (MANDATORY READ)
     ├── PROJECT_MEMORY.md              ← State machine
@@ -748,3 +738,30 @@ All governance and engineering assets are consolidated under the framework direc
 
 ## 📜 License
 MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
+unctional.
+-   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
+-   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
+-   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+
+---
+
+## 📜 License
+MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
+/                     # CLI Entry Point
+├── packages/                # Shared Types & MCP Engine
+└── apps/                    # Production Modules (Backend, Web, Mobile)
+```
+
+---
+
+## 🛡️ Engineering Standards
+
+-   **Zero Mock Policy:** Placeholders are forbidden. Every line of code must be functional.
+-   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
+-   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
+-   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+
+---
+
+## 📜 License
+MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**

package/bin/cli.js

@@ -159,7 +159,7 @@ function mergePackageJson(targetPath, sourcePath) {
     "enderun:check": "agent-enderun check",
     "enderun:test": "vitest run",
     "enderun:test:watch": "vitest",
-    "enderun:build": `${runCmd} build --prefix packages/shared-types && ${runCmd} build --prefix packages/framework-mcp`,
+    "enderun:build": `${runCmd} build --prefix packages/shared-types && ${runCmd} build --prefix framework-mcp`,
   };
 
   const sourceDevDeps = sourcePkg.devDependencies || {};
@@ -337,8 +337,7 @@ async function initCommand(selectedAdapter) {
     "package.json",
     "tsconfig.json",
     "panda.config.ts",
-    "packages/framework-mcp",
-    "packages/shared-types",
+    "framework-mcp",
   ];
 
   const DIRS_TO_CREATE = [
@@ -353,8 +352,7 @@ async function initCommand(selectedAdapter) {
     "apps/web",
     "apps/backend",
     "docs",
-    "packages/shared-types",
-    "packages/framework-mcp",
+    "framework-mcp",
   ];
 
   console.log(`🚀 Installing Agent Enderun (Adapter: ${selectedAdapter || "all"})...`);
@@ -407,7 +405,7 @@ async function initCommand(selectedAdapter) {
     let dest = path.join(targetDir, item);
     
     // FORCED CLEANUP: Delete existing framework engine directory to ensure clean update
-    if (["packages/framework-mcp"].includes(item)) {
+    if (["framework-mcp"].includes(item)) {
       if (fs.existsSync(dest)) {
         try {
           fs.rmSync(dest, { recursive: true, force: true });
@@ -432,7 +430,7 @@ async function initCommand(selectedAdapter) {
     if (fs.existsSync(src)) {
       if (fs.lstatSync(src).isDirectory()) {
         const skipFiles = (item === ".enderun") ? ["logs", "PROJECT_MEMORY.md", "PROJECT_MEMORY.lock"] : [];
-        const nonDestructive = ["packages/shared-types", "docs", ".enderun"].includes(item);
+        const nonDestructive = ["docs", ".enderun"].includes(item);
         copyDir(src, dest, new Set(skipFiles), nonDestructive, targetBase, targetScope);
       } else {
         if (item === "package.json") continue; // We merge it later
@@ -507,7 +505,7 @@ async function initCommand(selectedAdapter) {
       ext.mcpServers = {
         "agent-enderun": {
           command: "node",
-          args: ["packages/framework-mcp/dist/index.js"]
+          args: ["framework-mcp/dist/index.js"]
         }
       };
       fs.writeFileSync(geminiExtPath, JSON.stringify(ext, null, 2) + "\n");
@@ -519,7 +517,7 @@ async function initCommand(selectedAdapter) {
   }
 
   if (selectedAdapter === "claude") {
-    const mcpPath = path.join(targetDir, "packages/framework-mcp/src/index.ts");
+    const mcpPath = path.join(targetDir, "framework-mcp/src/index.ts");
     console.log("\n📝 Claude Code Setup:");
     console.log("To enable Agent Enderun tools in Claude Code, run this command:");
     console.log(`\x1b[36mclaude config add framework-mcp npx tsx ${mcpPath}\x1b[0m`);
@@ -612,8 +610,8 @@ function checkCommand() {
     { name: "Framework Config (config.json)", path: path.join(frameworkDir, "config.json") },
     { name: "Agent Status (STATUS.md)", path: path.join(frameworkDir, "STATUS.md") },
     { name: "MCP Config (mcp.json)", path: "mcp.json" },
-    { name: "Shared Types", path: "packages/shared-types/package.json" },
-    { name: "MCP Server", path: "packages/framework-mcp/package.json" },
+    { name: "Backend Contract", path: "apps/backend/contract.version.json" },
+    { name: "MCP Server", path: "framework-mcp/package.json" },
     { name: "Tech Stack", path: path.join(frameworkDir, "docs/tech-stack.md") },
     { name: "Panda CSS Config", path: "panda.config.ts" },
     { name: "Requirements", path: path.join(frameworkDir, "docs/project-docs.md") },
@@ -633,7 +631,7 @@ function checkCommand() {
   }
 
   // Dependency Check
-  const mcpNodeModules = path.join(process.cwd(), "packages/framework-mcp/node_modules");
+  const mcpNodeModules = path.join(process.cwd(), "framework-mcp/node_modules");
   const rootNodeModules = path.join(process.cwd(), "node_modules");
   if (!fs.existsSync(mcpNodeModules) && !fs.existsSync(rootNodeModules)) {
     console.log("❌ Dependencies MISSING! (Run 'npm install')");
@@ -643,7 +641,7 @@ function checkCommand() {
   }
 
   // MCP Build Check
-  const mcpPath = path.join(process.cwd(), "packages/framework-mcp/dist/index.js");
+  const mcpPath = path.join(process.cwd(), "framework-mcp/dist/index.js");
   if (!fs.existsSync(mcpPath)) {
     console.log("❌ MCP Build MISSING! (Run 'npm run enderun:build')");
     issues++;
@@ -857,11 +855,11 @@ function traceNewCommand(description, agent = "manager", priority = "P2") {
  * Verify the shared-types contract hash.
  */
 function verifyContractCommand() {
-  const sharedDir = path.join(targetDir, "packages/shared-types/src");
-  const contractPath = path.join(targetDir, "packages/shared-types/contract.version.json");
+  const sharedDir = path.join(targetDir, "apps/backend/src/types");
+  const contractPath = path.join(targetDir, "apps/backend/contract.version.json");
 
   if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) {
-    console.error("❌ Error: Shared types or contract.version.json not found.");
+    console.error("❌ Error: Backend types or contract.version.json not found.");
     return;
   }
 
@@ -953,7 +951,7 @@ function gitCommitCommand(traceId) {
     const files = cp.execSync("git diff --staged --name-only", { encoding: "utf8" }).split("\n").filter(Boolean);
     let type = "feat", scope = "code";
     if (files.some(f => f.includes(".md"))) type = "docs";
-    else if (files.some(f => f.includes("shared-types"))) type = "arch";
+    else if (files.some(f => f.includes("apps/backend/src/types"))) type = "arch";
     else if (files.some(f => f.includes("bin/cli.js"))) type = "fix";
     
     const summary = files.length === 1 ? `update ${path.basename(files[0])}` : `update ${files.length} files`;
@@ -1227,8 +1225,8 @@ function buildSharedTypesContent(existingContent) {
 }
 
 function updateContractHashFile() {
-  const sharedDir = path.join(targetDir, "packages/shared-types/src");
-  const contractPath = path.join(targetDir, "packages/shared-types/contract.version.json");
+  const sharedDir = path.join(targetDir, "apps/backend/src/types");
+  const contractPath = path.join(targetDir, "apps/backend/contract.version.json");
   if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) return;
 
   const walk = (dir) => fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
@@ -1250,7 +1248,186 @@ function updateContractHashFile() {
   fs.writeFileSync(contractPath, JSON.stringify(contract, null, 2));
 }
 
+function createBaseTypeFiles(baseDir) {
+  const typesDir = path.join(baseDir, "types");
+  ensureDir(typesDir);
+
+  writeTextFile(path.join(typesDir, "api.ts"), `import { TraceID } from "./brands.js";
+
+/**
+ * API Response Wrappers
+ */
+export interface ApiResponse<T> {
+  data: T;
+  meta?: {
+    requestId: TraceID;
+    timestamp: string;
+  };
+}
+
+export interface ApiError {
+  error: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+}
+`);
+
+  writeTextFile(path.join(typesDir, "brands.ts"), `/**
+ * Branded Type Utility
+ */
+export type Brand<K, T> = K & { __brand: T };
+
+/**
+ * Entity IDs (Branded)
+ */
+export type TraceID = Brand<string, "TraceID">;
+export type AgentID = Brand<string, "AgentID">;
+export type ProjectID = Brand<string, "ProjectID">;
+export type UserID = Brand<string, "UserID">;
+`);
+
+  writeTextFile(path.join(typesDir, "constants.ts"), `import { TraceID } from "./brands.js";
+
+/**
+ * Project Phases
+ */
+export const PROJECT_PHASES = ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"] as const;
+export type ProjectPhase = (typeof PROJECT_PHASES)[number];
+
+/**
+ * Execution Profiles
+ */
+export const EXECUTION_PROFILES = ["Lightweight", "Full"] as const;
+export type ExecutionProfile = (typeof EXECUTION_PROFILES)[number];
+
+/**
+ * Task Priorities
+ */
+export const TASK_PRIORITIES = ["P0", "P1", "P2", "P3"] as const;
+export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+
+/**
+ * Task Statuses
+ */
+export const TASK_STATUSES = ["PENDING", "IN_PROGRESS", "BLOCKED", "COMPLETED", "FAILED"] as const;
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+
+/**
+ * Action Types & Status
+ */
+export const ACTION_TYPES = ["CREATE", "MODIFY", "DELETE", "RESEARCH", "ORCHESTRATE"] as const;
+export type ActionType = (typeof ACTION_TYPES)[number];
+
+export const ACTION_STATUSES = ["SUCCESS", "FAILURE", "WAITING"] as const;
+export type ActionStatus = (typeof ACTION_STATUSES)[number];
+`);
+
+  writeTextFile(path.join(typesDir, "index.ts"), `/**
+ * Agent Enderun — App-Local Types (Modular)
+ */
+
+export * from "./brands.js";
+export * from "./constants.js";
+export * from "./models.js";
+export * from "./api.js";
+export * from "./logs.js";
+`);
+
+  writeTextFile(path.join(typesDir, "logs.ts"), `import { TraceID, AgentID } from "./brands.js";
+import { ActionType, ActionStatus } from "./constants.js";
+
+/**
+ * Audit & Agent Logging Types
+ */
+export interface AgentActionLog {
+  timestamp: string;
+  agent: AgentID;
+  action: ActionType;
+  requestId: TraceID | "—";
+  status: ActionStatus;
+  summary: string;
+  files?: string[];
+  details?: Record<string, unknown>;
+}
+`);
+
+  writeTextFile(path.join(typesDir, "models.ts"), `import { UserID, TraceID, AgentID } from "./brands.js";
+import { ProjectPhase, ExecutionProfile, TaskPriority, TaskStatus } from "./constants.js";
+
+/**
+ * Base Entity Fields
+ */
+export interface BaseEntity {
+  id: string; // Usually ULID
+  createdAt: string;
+  updatedAt: string;
+  deletedAt?: string | null;
+}
+
+/**
+ * Audit Log Model
+ */
+export interface AuditLog extends BaseEntity {
+  entityName: string;
+  entityId: string;
+  action: "CREATE" | "UPDATE" | "DELETE" | "RESTORE";
+  userId: UserID;
+  previousState?: Record<string, unknown> | null;
+  newState?: Record<string, unknown> | null;
+  traceId: TraceID;
+}
+
+/**
+ * User Model
+ */
+export interface User extends BaseEntity {
+  id: UserID;
+  email: string;
+  fullName: string;
+  role: "ADMIN" | "DEVELOPER" | "VIEWER";
+}
+
+export interface UserProfile extends User {
+  avatarUrl?: string;
+  bio?: string;
+  preferences: Record<string, unknown>;
+}
+
+/**
+ * Project Status
+ */
+export interface ProjectStatus {
+  phase: ProjectPhase;
+  profile: ExecutionProfile;
+  lastUpdate: string;
+  activeTraceId: TraceID | null;
+  blockers: string[];
+}
+
+/**
+ * Task Model
+ */
+export interface Task {
+  id: TraceID;
+  description: string;
+  agent: AgentID;
+  priority: TaskPriority;
+  status: TaskStatus;
+  createdAt: string;
+  updatedAt: string;
+}
+`);
+  console.log(`✅ Base types created in ${path.relative(targetDir, typesDir)}`);
+}
+
 function createBackendFiles(spec) {
+  createBaseTypeFiles(path.join(targetDir, "apps/backend/src"));
+  writeJsonFile(path.join(targetDir, "apps/backend/contract.version.json"), {
+    "contract_hash": "initial_hash_placeholder",
+    "last_updated": new Date().toISOString()
+  });
   writeJsonFile(path.join(targetDir, "apps/backend/package.json"), {
     name: "@agent-enderun/backend",
     version: "0.1.0",
@@ -1290,7 +1467,7 @@ function createBackendFiles(spec) {
   });
 
   writeTextFile(path.join(targetDir, "apps/backend/src/data.ts"), [
-    'import type { Customer, DashboardSummary, ReportMetric, Role, User } from "../../../packages/shared-types/src/index.js";',
+    'import type { Customer, DashboardSummary, ReportMetric, Role, User } from "./types/index.js";',
     "",
     'const now = new Date().toISOString();',
     "",
@@ -1364,6 +1541,7 @@ function createBackendFiles(spec) {
 }
 
 function createWebFiles(spec) {
+  createBaseTypeFiles(path.join(targetDir, "apps/web/src"));
   writeJsonFile(path.join(targetDir, "apps/web/package.json"), {
     name: "@agent-enderun/web",
     version: "0.1.0",
@@ -1632,7 +1810,7 @@ function updateProjectDocs(spec) {
     "",
     "- `apps/backend`: Fastify API",
     "- `apps/web`: React dashboard",
-    "- `packages/shared-types`: Contract-first shared TypeScript types",
+    "- `apps/backend/src/types`: Contract-first backend TypeScript types",
   ].join("\n"));
 
   writeTextFile(path.join(apiDir, "README.md"), [
@@ -1658,7 +1836,7 @@ function updateMemoryForGeneratedApp(spec, traceId) {
     "- **Agent:** @manager",
     `- **Trace ID:** ${traceId}`,
     "- **Action:** Created full-stack starter from natural language request.",
-    "- **Files:** apps/backend, apps/web, shared-types, project docs",
+    "- **Files:** apps/backend, apps/web, project docs",
   ].join("\n");
 
   updateProjectMemoryCommand("HISTORY", history);
@@ -1693,10 +1871,10 @@ async function createAppCommand(args) {
   createWebFiles(spec);
   updateProjectDocs(spec);
 
-  const sharedTypesPath = path.join(targetDir, "packages/shared-types/src/index.ts");
-  if (fs.existsSync(sharedTypesPath)) {
-    const existing = fs.readFileSync(sharedTypesPath, "utf8");
-    fs.writeFileSync(sharedTypesPath, buildSharedTypesContent(existing));
+  const backendTypesPath = path.join(targetDir, "apps/backend/src/types/index.ts");
+  if (fs.existsSync(backendTypesPath)) {
+    const existing = fs.readFileSync(backendTypesPath, "utf8");
+    fs.writeFileSync(backendTypesPath, buildSharedTypesContent(existing));
     updateContractHashFile();
   }
 
@@ -1746,7 +1924,7 @@ async function main() {
       verifyContractCommand();
       break;
     case "mcp": {
-      const mcpServerPath = path.join(sourceDir, "packages/framework-mcp/dist/index.js");
+      const mcpServerPath = path.join(sourceDir, "framework-mcp/dist/index.js");
       if (fs.existsSync(mcpServerPath)) {
         const { spawn } = await import("child_process");
         // Use node to execute the built MCP server

package/{packages/framework-mcp → framework-mcp}/dist/schemas.js

@@ -98,3 +98,15 @@ export const SYNC_CONTRACT_HASH_ARGS_SCHEMA = z.object({
 export const VERIFY_FRAMEWORK_HEALTH_ARGS_SCHEMA = z.object({
     detailed: z.boolean().default(false),
 });
+export const INSTANTIATE_BLUEPRINT_ARGS_SCHEMA = z.object({
+    blueprintPath: z.string().min(1),
+    targetPath: z.string().min(1),
+});
+export const LIST_BLUEPRINTS_ARGS_SCHEMA = z.object({
+    category: z.enum(["backend", "frontend"]).optional(),
+});
+export const SAVE_AS_BLUEPRINT_ARGS_SCHEMA = z.object({
+    blueprintPath: z.string().min(1),
+    content: z.string().min(1),
+    description: z.string().optional(),
+});

package/{packages/framework-mcp → framework-mcp}/dist/tools/contract.js

@@ -44,8 +44,8 @@ export const contractTools = [
 export const contractHandlers = {
     verify_api_contract: async (args, projectRoot) => {
         try {
-            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
-            const contractJsonPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
+            const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
+            const contractJsonPath = path.join(projectRoot, "apps/backend/contract.version.json");
             if (!fs.existsSync(sharedTypesDir) || !fs.existsSync(contractJsonPath))
                 return { content: [{ type: "text", text: "Missing shared-types directory or contract.version.json" }] };
             const currentHash = calculateContractHash(sharedTypesDir, projectRoot);
@@ -58,8 +58,8 @@ export const contractHandlers = {
     },
     update_contract_hash: async (args, projectRoot) => {
         try {
-            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
-            const contractJsonPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
+            const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
+            const contractJsonPath = path.join(projectRoot, "apps/backend/contract.version.json");
             if (!fs.existsSync(sharedTypesDir))
                 return { content: [{ type: "text", text: "Missing shared-types directory" }] };
             const files = collectFilesRecursively(sharedTypesDir, new Set(["ts"])).sort();
@@ -83,7 +83,7 @@ export const contractHandlers = {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const apiDocPath = path.join(projectRoot, frameworkDir, "docs/api", `${parsed.data.domain}.md`);
-            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
+            const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
             if (!fs.existsSync(apiDocPath))
                 return { content: [{ type: "text", text: `API documentation not found for domain: ${parsed.data.domain}` }] };
             if (!fs.existsSync(sharedTypesDir))

package/{packages/framework-mcp → framework-mcp}/dist/tools/framework.js

@@ -103,8 +103,9 @@ export const frameworkHandlers = {
         const missing = [];
         const frameworkDir = getFrameworkDir(projectRoot);
         const checkPaths = [
-            { path: "apps", type: "folder", optional: true },
-            { path: "packages/shared-types/src", type: "folder" },
+            { path: "apps/backend/src/types", type: "folder" },
+            { path: "apps/web/src/types", type: "folder" },
+            { path: "framework-mcp/src", type: "folder" },
             { path: path.join(frameworkDir, "docs/api"), type: "folder", optional: true },
             { path: ".env", type: "file", optional: true },
             { path: ".env.example", type: "file" },

package/{packages/framework-mcp → framework-mcp}/dist/tools/git.js

@@ -27,7 +27,7 @@ export const gitHandlers = {
             let type = "feat", scope = "code";
             if (files.some(f => f.includes(".md")))
                 type = "docs";
-            else if (files.some(f => f.includes("shared-types")))
+            else if (files.some(f => f.includes("apps/backend/src/types")))
                 type = "arch";
             else if (files.some(f => f.includes("framework-mcp")))
                 type = "chore";
@@ -39,9 +39,7 @@ export const gitHandlers = {
                 scope = "web";
             else if (files.some(f => f.includes("apps/backend")))
                 scope = "backend";
-            else if (files.some(f => f.includes("packages/shared-types")))
-                scope = "contract";
-            else if (files.some(f => f.includes("packages/framework-mcp")))
+            else if (files.some(f => f.includes("framework-mcp")))
                 scope = "mcp";
             const summary = files.length === 1 ? `update ${path.basename(files[0])}` : `update ${files.length} files`;
             return { content: [{ type: "text", text: `### SUGGESTED SEMANTIC COMMIT MESSAGE\n\n\`[${parsed.data.traceId}] ${type}(${scope}): ${summary}\`\n\n**Files Analyzed:**\n${files.map(f => `- ${f}`).join("\n")}` }] };

package/{packages/framework-mcp → framework-mcp}/dist/tools/index.js

@@ -9,6 +9,7 @@ import { gitTools, gitHandlers } from "./git.js";
 import { databaseTools, databaseHandlers } from "./database.js";
 import { knowledgeTools, knowledgeHandlers } from "./knowledge.js";
 import { repositoryTools, repositoryHandlers } from "./repository.js";
+import { scaffoldTools, scaffoldHandlers } from "./scaffold.js";
 export const allTools = [
     ...codebaseTools,
     ...frameworkTools,
@@ -21,6 +22,7 @@ export const allTools = [
     ...databaseTools,
     ...knowledgeTools,
     ...repositoryTools,
+    ...scaffoldTools,
 ];
 export const allHandlers = {
     ...codebaseHandlers,
@@ -34,6 +36,7 @@ export const allHandlers = {
     ...databaseHandlers,
     ...knowledgeHandlers,
     ...repositoryHandlers,
+    ...scaffoldHandlers,
 };
 // Add compatibility aliases
 allHandlers.codebase_search = allHandlers.search_codebase;

package/{packages/framework-mcp → framework-mcp}/dist/tools/repository.js

@@ -91,7 +91,7 @@ export const repositoryHandlers = {
                     });
                 });
             }
-            const majorDirs = ["apps/backend", "apps/web", "packages/shared-types", "packages/framework-mcp"], missingREADME = majorDirs.filter(dir => fs.existsSync(path.join(projectRoot, dir)) && !fs.existsSync(path.join(projectRoot, dir, "README.md")));
+            const majorDirs = ["apps/backend", "apps/web", "framework-mcp"], missingREADME = majorDirs.filter(dir => fs.existsSync(path.join(projectRoot, dir)) && !fs.existsSync(path.join(projectRoot, dir, "README.md")));
             return { content: [{ type: "text", text: `### DOCUMENTATION DEBT REPORT\n\n**Missing JSDoc:**\n${missingJSDoc.slice(0, 10).join("\n")}\n\n**Missing README.md:**\n${missingREADME.join("\n")}` }] };
         }
         catch (error) {