agent-enderun 1.10.4 → 1.11.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 (210) hide show
  1. package/README.md +34 -45
  2. package/dist/framework-mcp/tests/tools/quality/check_lint.test.js +1 -1
  3. package/dist/framework-mcp/tests/tools/quality/check_lint.test.js.map +1 -1
  4. package/dist/src/cli/adapters/core.d.ts +1 -1
  5. package/dist/src/cli/adapters/core.js +0 -1
  6. package/dist/src/cli/adapters/core.js.map +1 -1
  7. package/dist/src/cli/adapters/index.d.ts +1 -0
  8. package/dist/src/cli/adapters/index.js +1 -0
  9. package/dist/src/cli/adapters/index.js.map +1 -1
  10. package/dist/src/cli/adapters/scaffold.d.ts +1 -1
  11. package/dist/src/cli/adapters/scaffold.js +13 -7
  12. package/dist/src/cli/adapters/scaffold.js.map +1 -1
  13. package/dist/src/cli/commands/init/scaffold-core.d.ts +5 -2
  14. package/dist/src/cli/commands/init/scaffold-core.js +28 -6
  15. package/dist/src/cli/commands/init/scaffold-core.js.map +1 -1
  16. package/dist/src/cli/commands/init.js +31 -4
  17. package/dist/src/cli/commands/init.js.map +1 -1
  18. package/dist/src/cli/commands/orchestrate.d.ts +9 -7
  19. package/dist/src/cli/commands/orchestrate.js +40 -4
  20. package/dist/src/cli/commands/orchestrate.js.map +1 -1
  21. package/dist/src/cli/commands/plan.d.ts +3 -1
  22. package/dist/src/cli/commands/plan.js +79 -22
  23. package/dist/src/cli/commands/plan.js.map +1 -1
  24. package/dist/src/cli/index.js +11 -15
  25. package/dist/src/cli/index.js.map +1 -1
  26. package/dist/src/cli/utils/compliance.js +0 -1
  27. package/dist/src/cli/utils/compliance.js.map +1 -1
  28. package/dist/src/cli/utils/config-schema.d.ts +7 -7
  29. package/dist/src/cli/utils/pkg.d.ts +19 -0
  30. package/dist/src/cli/utils/pkg.js +29 -5
  31. package/dist/src/cli/utils/pkg.js.map +1 -1
  32. package/dist/src/modules/adapters/definitions.js +1 -1
  33. package/dist/src/modules/adapters/definitions.js.map +1 -1
  34. package/dist/src/modules/adapters/shared.js +7 -4
  35. package/dist/src/modules/adapters/shared.js.map +1 -1
  36. package/dist/src/modules/agents/definitions.d.ts +1 -1
  37. package/dist/src/modules/agents/definitions.js +129 -69
  38. package/dist/src/modules/agents/definitions.js.map +1 -1
  39. package/dist/src/modules/agents/registry/analyst.js +5 -1
  40. package/dist/src/modules/agents/registry/analyst.js.map +1 -1
  41. package/dist/src/modules/agents/registry/backend.js +5 -4
  42. package/dist/src/modules/agents/registry/backend.js.map +1 -1
  43. package/dist/src/modules/agents/registry/database.js +2 -1
  44. package/dist/src/modules/agents/registry/database.js.map +1 -1
  45. package/dist/src/modules/agents/registry/devops.js +2 -0
  46. package/dist/src/modules/agents/registry/devops.js.map +1 -1
  47. package/dist/src/modules/agents/registry/explorer.js +1 -0
  48. package/dist/src/modules/agents/registry/explorer.js.map +1 -1
  49. package/dist/src/modules/agents/registry/git.js +3 -1
  50. package/dist/src/modules/agents/registry/git.js.map +1 -1
  51. package/dist/src/modules/agents/registry/manager.js +8 -2
  52. package/dist/src/modules/agents/registry/manager.js.map +1 -1
  53. package/dist/src/modules/agents/registry/native.js +5 -1
  54. package/dist/src/modules/agents/registry/native.js.map +1 -1
  55. package/dist/src/modules/agents/registry/security.js +1 -0
  56. package/dist/src/modules/agents/registry/security.js.map +1 -1
  57. package/dist/src/shared/constants.d.ts +1 -1
  58. package/dist/src/shared/constants.js +10 -9
  59. package/dist/src/shared/constants.js.map +1 -1
  60. package/dist/tests/approve.test.js +4 -9
  61. package/dist/tests/approve.test.js.map +1 -1
  62. package/dist/tests/integration/agent_flow.test.js +2 -2
  63. package/dist/tests/integration/agent_flow.test.js.map +1 -1
  64. package/dist/tests/orchestrate.test.js +2 -7
  65. package/dist/tests/orchestrate.test.js.map +1 -1
  66. package/framework-mcp/dist/constants.js +64 -0
  67. package/framework-mcp/dist/index.js +109 -0
  68. package/framework-mcp/dist/tools/control_plane/locking.js +64 -0
  69. package/framework-mcp/dist/tools/control_plane/registry.js +34 -0
  70. package/framework-mcp/dist/tools/dashboard/start_dashboard.js +29 -0
  71. package/framework-mcp/dist/tools/definitions.js +300 -0
  72. package/framework-mcp/dist/tools/file_system/batch_surgical_edit.js +59 -0
  73. package/framework-mcp/dist/tools/file_system/patch_file.js +25 -0
  74. package/framework-mcp/dist/tools/file_system/read_file.js +51 -0
  75. package/framework-mcp/dist/tools/file_system/replace_text.js +43 -0
  76. package/framework-mcp/dist/tools/file_system/write_file.js +38 -0
  77. package/framework-mcp/dist/tools/framework/audit_deps.js +41 -0
  78. package/framework-mcp/dist/tools/framework/get_status.js +5 -0
  79. package/framework-mcp/dist/tools/framework/orchestrate.js +5 -0
  80. package/framework-mcp/dist/tools/framework/run_tests.js +25 -0
  81. package/framework-mcp/dist/tools/framework/update_contract_hash.js +5 -0
  82. package/framework-mcp/dist/tools/framework/update_memory.js +8 -0
  83. package/framework-mcp/dist/tools/index.js +62 -0
  84. package/framework-mcp/dist/tools/memory/get_insights.js +34 -0
  85. package/framework-mcp/dist/tools/memory/read_memory.js +28 -0
  86. package/framework-mcp/dist/tools/messaging/log_action.js +22 -0
  87. package/framework-mcp/dist/tools/messaging/send_message.js +87 -0
  88. package/framework-mcp/dist/tools/observability/check_ports.js +26 -0
  89. package/framework-mcp/dist/tools/observability/get_health.js +19 -0
  90. package/framework-mcp/dist/tools/quality/check_lint.js +28 -0
  91. package/framework-mcp/dist/tools/search/get_gaps.js +48 -0
  92. package/framework-mcp/dist/tools/search/get_map.js +43 -0
  93. package/framework-mcp/dist/tools/search/grep_search.js +76 -0
  94. package/framework-mcp/dist/tools/search/list_dir.js +28 -0
  95. package/framework-mcp/dist/tools/shell/run_command.js +46 -0
  96. package/framework-mcp/dist/tools/types.js +1 -0
  97. package/framework-mcp/dist/utils/cli.js +20 -0
  98. package/framework-mcp/dist/utils/compliance.js +29 -0
  99. package/framework-mcp/dist/utils/fs.js +44 -0
  100. package/framework-mcp/dist/utils/metrics.js +56 -0
  101. package/framework-mcp/dist/utils/security.js +60 -0
  102. package/framework-mcp/package.json +19 -0
  103. package/framework-mcp/src/constants.ts +78 -0
  104. package/framework-mcp/src/declarations.d.ts +17 -0
  105. package/framework-mcp/src/index.ts +132 -0
  106. package/framework-mcp/src/tools/control_plane/locking.ts +71 -0
  107. package/framework-mcp/src/tools/control_plane/registry.ts +38 -0
  108. package/framework-mcp/src/tools/dashboard/start_dashboard.ts +33 -0
  109. package/framework-mcp/src/tools/definitions.ts +302 -0
  110. package/framework-mcp/src/tools/file_system/batch_surgical_edit.ts +79 -0
  111. package/framework-mcp/src/tools/file_system/patch_file.ts +33 -0
  112. package/framework-mcp/src/tools/file_system/read_file.ts +58 -0
  113. package/framework-mcp/src/tools/file_system/replace_text.ts +52 -0
  114. package/framework-mcp/src/tools/file_system/write_file.ts +45 -0
  115. package/framework-mcp/src/tools/framework/audit_deps.ts +49 -0
  116. package/framework-mcp/src/tools/framework/get_status.ts +7 -0
  117. package/framework-mcp/src/tools/framework/orchestrate.ts +7 -0
  118. package/framework-mcp/src/tools/framework/run_tests.ts +28 -0
  119. package/framework-mcp/src/tools/framework/update_contract_hash.ts +7 -0
  120. package/framework-mcp/src/tools/framework/update_memory.ts +10 -0
  121. package/framework-mcp/src/tools/index.ts +66 -0
  122. package/framework-mcp/src/tools/memory/get_insights.ts +41 -0
  123. package/framework-mcp/src/tools/memory/read_memory.ts +31 -0
  124. package/framework-mcp/src/tools/messaging/log_action.ts +28 -0
  125. package/framework-mcp/src/tools/messaging/send_message.ts +89 -0
  126. package/framework-mcp/src/tools/observability/check_ports.ts +30 -0
  127. package/framework-mcp/src/tools/observability/get_health.ts +24 -0
  128. package/framework-mcp/src/tools/quality/check_lint.ts +33 -0
  129. package/framework-mcp/src/tools/search/get_gaps.ts +54 -0
  130. package/framework-mcp/src/tools/search/get_map.ts +48 -0
  131. package/framework-mcp/src/tools/search/grep_search.ts +76 -0
  132. package/framework-mcp/src/tools/search/list_dir.ts +34 -0
  133. package/framework-mcp/src/tools/shell/run_command.ts +56 -0
  134. package/framework-mcp/src/tools/types.ts +89 -0
  135. package/framework-mcp/src/utils/cli.ts +20 -0
  136. package/framework-mcp/src/utils/compliance.ts +37 -0
  137. package/framework-mcp/src/utils/fs.ts +45 -0
  138. package/framework-mcp/src/utils/metrics.ts +73 -0
  139. package/framework-mcp/src/utils/security.ts +66 -0
  140. package/framework-mcp/tests/tools/file_system/file_system_tools.test.ts +212 -0
  141. package/framework-mcp/tests/tools/messaging/send_message.test.ts +136 -0
  142. package/framework-mcp/tests/tools/quality/check_lint.test.ts +46 -0
  143. package/framework-mcp/tests/tools/shell/run_command.test.ts +55 -0
  144. package/framework-mcp/tsconfig.json +14 -0
  145. package/package.json +5 -3
  146. package/src/cli/adapters/core.ts +2 -3
  147. package/src/cli/adapters/index.ts +1 -0
  148. package/src/cli/adapters/scaffold.ts +20 -7
  149. package/src/cli/commands/init/scaffold-core.ts +45 -6
  150. package/src/cli/commands/init.ts +31 -2
  151. package/src/cli/commands/orchestrate.ts +41 -4
  152. package/src/cli/commands/plan.ts +89 -23
  153. package/src/cli/index.ts +14 -19
  154. package/src/cli/utils/compliance.ts +8 -9
  155. package/src/cli/utils/pkg.ts +42 -13
  156. package/src/modules/adapters/definitions.ts +1 -1
  157. package/src/modules/adapters/shared.ts +7 -4
  158. package/src/modules/agents/definitions.ts +140 -73
  159. package/src/modules/agents/registry/analyst.ts +5 -1
  160. package/src/modules/agents/registry/backend.ts +5 -4
  161. package/src/modules/agents/registry/database.ts +2 -1
  162. package/src/modules/agents/registry/devops.ts +2 -0
  163. package/src/modules/agents/registry/explorer.ts +1 -0
  164. package/src/modules/agents/registry/git.ts +3 -1
  165. package/src/modules/agents/registry/manager.ts +8 -2
  166. package/src/modules/agents/registry/native.ts +5 -1
  167. package/src/modules/agents/registry/security.ts +1 -0
  168. package/src/shared/constants.ts +14 -13
  169. package/templates/prompts/bug-fix-recipe.md +20 -0
  170. package/templates/prompts/contract-design-recipe.md +21 -0
  171. package/templates/prompts/db-management-recipe.md +25 -0
  172. package/templates/prompts/deployment-recipe.md +23 -0
  173. package/templates/prompts/new-feature-recipe.md +19 -0
  174. package/templates/prompts/performance-optimization-recipe.md +23 -0
  175. package/templates/prompts/pull-request-template.md +21 -0
  176. package/templates/prompts/refactoring-recipe.md +21 -0
  177. package/templates/prompts/security-audit-recipe.md +20 -0
  178. package/templates/standards/architecture-standards.md +23 -0
  179. package/templates/standards/auth-standards.md +125 -0
  180. package/templates/standards/crud-governance.md +21 -0
  181. package/templates/standards/deployment-standards.md +21 -0
  182. package/templates/standards/frontend-standards.md +37 -0
  183. package/templates/standards/github-actions-standards.md +43 -0
  184. package/templates/standards/i18n-standards.md +17 -0
  185. package/templates/standards/kysely-standards.md +47 -0
  186. package/templates/standards/llm-governance.md +15 -0
  187. package/templates/standards/logging-and-secrets.md +34 -0
  188. package/templates/standards/mobile-standards.md +23 -0
  189. package/templates/standards/observability-standards.md +15 -0
  190. package/templates/standards/performance-standards.md +15 -0
  191. package/templates/standards/pino-standards.md +46 -0
  192. package/templates/standards/playwright-standards.md +54 -0
  193. package/templates/standards/quality-standards.md +31 -0
  194. package/templates/standards/react-query-standards.md +72 -0
  195. package/templates/standards/react-router-standards.md +62 -0
  196. package/templates/standards/security-audit-standards.md +16 -0
  197. package/templates/standards/security-standards.md +21 -0
  198. package/templates/standards/swagger-standards.md +50 -0
  199. package/templates/standards/tailwind-standards.md +20 -0
  200. package/templates/standards/testing-standards.md +31 -0
  201. package/templates/standards/typeorm-standards.md +49 -0
  202. package/templates/standards/vitest-standards.md +110 -0
  203. package/src/cli/commands/app.ts +0 -56
  204. package/src/cli/utils/app-backend.ts +0 -257
  205. package/src/cli/utils/app-docs.ts +0 -83
  206. package/src/cli/utils/app-frontend.ts +0 -263
  207. package/src/cli/utils/app-inferrer.ts +0 -63
  208. package/src/cli/utils/app-mobile.ts +0 -113
  209. package/src/cli/utils/app-types.ts +0 -248
  210. package/src/cli/utils/app.ts +0 -6
@@ -1,257 +0,0 @@
1
- import path from "path";
2
- import type { AppSpec } from "./app-inferrer.js";
3
- import { createBaseTypeFiles } from "./app-types.js";
4
- import { ensureDir, writeJsonFile, writeTextFile } from "./fs.js";
5
- import { getConfiguredPaths } from "./memory.js";
6
- import { getDependencyVersions } from "./pkg.js";
7
-
8
- const targetDir = process.cwd();
9
-
10
- export function createBackendFiles(spec: AppSpec): void {
11
- const pathsMap = getConfiguredPaths();
12
- const backendDir = pathsMap.backend;
13
- const { fastify, "@fastify/cors": fastifyCors, zod, "@types/node": typesNode, tsx, typescript, "vitest-backend": vitest } = getDependencyVersions();
14
-
15
- createBaseTypeFiles(path.join(targetDir, backendDir, "src"));
16
- writeJsonFile(path.join(targetDir, backendDir, "contract.version.json"), {
17
- "contract_hash": "initial_hash_placeholder",
18
- "last_updated": new Date().toISOString()
19
- });
20
- writeJsonFile(path.join(targetDir, backendDir, "package.json"), {
21
- name: "@agent-enderun/backend",
22
- version: "0.1.0",
23
- private: true,
24
- type: "module",
25
- scripts: {
26
- dev: "tsx src/server.ts",
27
- build: "tsc -p tsconfig.json",
28
- start: "node dist/server.js",
29
- test: "vitest run",
30
- },
31
- dependencies: {
32
- "@fastify/cors": fastifyCors,
33
- fastify: fastify,
34
- zod: zod,
35
- },
36
- devDependencies: {
37
- "@types/node": typesNode,
38
- tsx: tsx,
39
- typescript: typescript,
40
- vitest: vitest,
41
- },
42
- });
43
-
44
- writeJsonFile(path.join(targetDir, backendDir, "tsconfig.json"), {
45
- extends: "../../tsconfig.json",
46
- compilerOptions: {
47
- outDir: "dist",
48
- rootDir: "src",
49
- module: "NodeNext",
50
- moduleResolution: "NodeNext",
51
- target: "ES2022",
52
- strict: true,
53
- skipLibCheck: true,
54
- },
55
- include: ["src/**/*.ts"],
56
- });
57
-
58
- const srcDir = path.join(targetDir, backendDir, "src");
59
- ensureDir(path.join(srcDir, "database"));
60
- ensureDir(path.join(srcDir, "repositories"));
61
- ensureDir(path.join(srcDir, "services"));
62
-
63
- writeTextFile(path.join(srcDir, "database/memoryDb.ts"), [
64
- "import type { Customer, ReportMetric, Role, User } from \"../types/index.js\";",
65
- "",
66
- "const now = new Date().toISOString();",
67
- "",
68
- "export const rolesDb: Role[] = [",
69
- " { id: \"role_admin\" as Role[\"id\"], name: \"Admin\", permissions: [\"users:manage\", \"reports:view\", \"customers:manage\"] },",
70
- " { id: \"role_manager\" as Role[\"id\"], name: \"Manager\", permissions: [\"reports:view\", \"customers:manage\"] },",
71
- " { id: \"role_viewer\" as Role[\"id\"], name: \"Viewer\", permissions: [\"reports:view\"] },",
72
- "];",
73
- "",
74
- "export const usersDb: User[] = [",
75
- " { id: \"user_1\" as User[\"id\"], email: \"admin@example.com\", fullName: \"Admin User\", role: \"ADMIN\", createdAt: now, updatedAt: now },",
76
- " { id: \"user_2\" as User[\"id\"], email: \"manager@example.com\", fullName: \"Sales Manager\", role: \"DEVELOPER\", createdAt: now, updatedAt: now },",
77
- "];",
78
- "",
79
- "export const customersDb: Customer[] = [",
80
- " { id: \"customer_1\" as Customer[\"id\"], name: \"Northwind\", ownerId: usersDb[1].id, status: \"ACTIVE\", annualValue: 125000, createdAt: now, updatedAt: now },",
81
- " { id: \"customer_2\" as Customer[\"id\"], name: \"Acme Corp\", ownerId: usersDb[1].id, status: \"LEAD\", annualValue: 82000, createdAt: now, updatedAt: now },",
82
- " { id: \"customer_3\" as Customer[\"id\"], name: \"Globex\", ownerId: usersDb[0].id, status: \"AT_RISK\", annualValue: 54000, createdAt: now, updatedAt: now },",
83
- "];",
84
- "",
85
- "export const reportsDb: ReportMetric[] = [",
86
- " { id: \"report_pipeline\" as ReportMetric[\"id\"], label: \"Pipeline\", value: 261000, trend: \"UP\" },",
87
- " { id: \"report_active_customers\" as ReportMetric[\"id\"], label: \"Active Customers\", value: 1, trend: \"FLAT\" },",
88
- " { id: \"report_risk\" as ReportMetric[\"id\"], label: \"At Risk\", value: 1, trend: \"DOWN\" },",
89
- "];",
90
- ].join("\n"));
91
-
92
- writeTextFile(path.join(srcDir, "repositories/user.repository.ts"), [
93
- "import { usersDb } from \"../database/memoryDb.js\";",
94
- "import type { User } from \"../types/index.js\";",
95
- "",
96
- "export class UserRepository {",
97
- " async findAll(): Promise<User[]> {",
98
- " return usersDb.filter(u => !u.deletedAt);",
99
- " }",
100
- "",
101
- " async findByEmail(email: string): Promise<User | null> {",
102
- " return usersDb.find(u => u.email === email && !u.deletedAt) || null;",
103
- " }",
104
- "}",
105
- ].join("\n"));
106
-
107
- writeTextFile(path.join(srcDir, "repositories/customer.repository.ts"), [
108
- "import { customersDb } from \"../database/memoryDb.js\";",
109
- "import type { Customer } from \"../types/index.js\";",
110
- "",
111
- "export class CustomerRepository {",
112
- " async findAll(): Promise<Customer[]> {",
113
- " return customersDb.filter(c => !c.deletedAt);",
114
- " }",
115
- "}",
116
- ].join("\n"));
117
-
118
- writeTextFile(path.join(srcDir, "repositories/role.repository.ts"), [
119
- "import { rolesDb } from \"../database/memoryDb.js\";",
120
- "import type { Role } from \"../types/index.js\";",
121
- "",
122
- "export class RoleRepository {",
123
- " async findAll(): Promise<Role[]> {",
124
- " return rolesDb;",
125
- " }",
126
- "}",
127
- ].join("\n"));
128
-
129
- writeTextFile(path.join(srcDir, "repositories/report.repository.ts"), [
130
- "import { reportsDb } from \"../database/memoryDb.js\";",
131
- "import type { ReportMetric } from \"../types/index.js\";",
132
- "",
133
- "export class ReportRepository {",
134
- " async findAll(): Promise<ReportMetric[]> {",
135
- " return reportsDb;",
136
- " }",
137
- "}",
138
- ].join("\n"));
139
-
140
- writeTextFile(path.join(srcDir, "services/dashboard.service.ts"), [
141
- "import { UserRepository } from \"../repositories/user.repository.js\";",
142
- "import { CustomerRepository } from \"../repositories/customer.repository.js\";",
143
- "import { RoleRepository } from \"../repositories/role.repository.js\";",
144
- "import { ReportRepository } from \"../repositories/report.repository.js\";",
145
- "import type { DashboardSummary } from \"../types/index.js\";",
146
- "",
147
- "export class DashboardService {",
148
- " private userRepo = new UserRepository();",
149
- " private customerRepo = new CustomerRepository();",
150
- " private roleRepo = new RoleRepository();",
151
- " private reportRepo = new ReportRepository();",
152
- "",
153
- " async getSummary(): Promise<DashboardSummary> {",
154
- " const [users, customers, roles, reports] = await Promise.all([",
155
- " this.userRepo.findAll(),",
156
- " this.customerRepo.findAll(),",
157
- " this.roleRepo.findAll(),",
158
- " this.reportRepo.findAll(),",
159
- " ]);",
160
- "",
161
- " return { users, customers, roles, reports };",
162
- " }",
163
- "}",
164
- ].join("\n"));
165
-
166
- writeTextFile(path.join(targetDir, backendDir, "src/server.ts"), [
167
- "import Fastify from \"fastify\";",
168
- "import cors from \"@fastify/cors\";",
169
- "import { z } from \"zod\";",
170
- "import { UserRepository } from \"./repositories/user.repository.js\";",
171
- "import { CustomerRepository } from \"./repositories/customer.repository.js\";",
172
- "import { RoleRepository } from \"./repositories/role.repository.js\";",
173
- "import { ReportRepository } from \"./repositories/report.repository.js\";",
174
- "import { DashboardService } from \"./services/dashboard.service.js\";",
175
- "",
176
- "const app = Fastify({ logger: true });",
177
- "await app.register(cors, { origin: true });",
178
- "",
179
- "const userRepo = new UserRepository();",
180
- "const customerRepo = new CustomerRepository();",
181
- "const roleRepo = new RoleRepository();",
182
- "const reportRepo = new ReportRepository();",
183
- "const dashboardService = new DashboardService();",
184
- "",
185
- "app.get(\"/health\", async () => ({ ok: true, service: \"agent-enderun-backend\" }));",
186
- "app.get(\"/api/v1/dashboard\", async () => {",
187
- " const summary = await dashboardService.getSummary();",
188
- " return { data: summary };",
189
- "});",
190
- "app.get(\"/api/v1/users\", async () => {",
191
- " const users = await userRepo.findAll();",
192
- " return { data: users };",
193
- "});",
194
- "app.get(\"/api/v1/roles\", async () => {",
195
- " const roles = await roleRepo.findAll();",
196
- " return { data: roles };",
197
- "});",
198
- "app.get(\"/api/v1/customers\", async () => {",
199
- " const customers = await customerRepo.findAll();",
200
- " return { data: customers };",
201
- "});",
202
- "app.get(\"/api/v1/reports\", async (request, reply) => {",
203
- " interface QueryParams {",
204
- " page?: number;",
205
- " limit?: number;",
206
- " }",
207
- " const { page = 1, limit = 10 } = request.query as QueryParams;",
208
- " const reports = await reportRepo.findAll();",
209
- " const startIndex = (Number(page) - 1) * Number(limit);",
210
- " const endIndex = startIndex + Number(limit);",
211
- " const paginatedReports = reports.slice(startIndex, endIndex);",
212
- " reply.send({",
213
- " data: paginatedReports,",
214
- " meta: {",
215
- " total: reports.length,",
216
- " page: Number(page),",
217
- " limit: Number(limit),",
218
- " },",
219
- " });",
220
- "});",
221
- "",
222
- "app.post(\"/api/v1/auth/login\", async (request, reply) => {",
223
- " const body = z.object({ email: z.string().email(), password: z.string().min(1) }).safeParse(request.body);",
224
- " if (!body.success) return reply.code(400).send({ error: { code: \"VALIDATION_ERROR\", message: \"Invalid login payload\" } });",
225
- "",
226
- " const user = await userRepo.findByEmail(body.data.email);",
227
- " if (!user) {",
228
- " const allUsers = await userRepo.findAll();",
229
- " return { data: { user: allUsers[0], token: \"demo-token\", expiresAt: new Date(Date.now() + 3600000).toISOString() } };",
230
- " }",
231
- " return { data: { user, token: \"demo-token\", expiresAt: new Date(Date.now() + 3600000).toISOString() } };",
232
- "});",
233
- "",
234
- "const port = Number(process.env.PORT || 4000);",
235
- "await app.listen({ port, host: \"0.0.0.0\" });",
236
- ].join("\n"));
237
-
238
- writeTextFile(path.join(targetDir, backendDir, ".env.example"), [
239
- "# Agent Enderun - Backend Environment Variables",
240
- "PORT=4000",
241
- "NODE_ENV=development",
242
- "DATABASE_URL=sqlite://./dev.db",
243
- "JWT_SECRET=your_secret_key_here",
244
- ].join("\n"));
245
-
246
- writeTextFile(path.join(targetDir, backendDir, "README.md"), [
247
- `# ${spec.title} Backend`,
248
- "",
249
- "Fastify API generated by Agent Enderun.",
250
- "",
251
- "## Commands",
252
- "",
253
- "- `npm run dev` strings",
254
- "- `npm run build` strings",
255
- "- `npm run test` strings",
256
- ].join("\n"));
257
- }
@@ -1,83 +0,0 @@
1
- import fs from "fs";
2
- import path from "path";
3
- import { ensureDir, writeTextFile } from "./fs.js";
4
- import { getConfiguredPaths, getMemoryPath, updateProjectMemory } from "./memory.js";
5
- import type { AppSpec } from "./app-inferrer.js";
6
-
7
- const targetDir = process.cwd();
8
-
9
- export function updateProjectDocs(spec: AppSpec): void {
10
- const pathsMap = getConfiguredPaths();
11
- const docsDir = path.join(targetDir, pathsMap.docs);
12
- const apiDir = path.join(docsDir, "api");
13
- ensureDir(apiDir);
14
-
15
- const architecture = [];
16
- if (spec.platform === "full-stack" || spec.platform === "backend") {
17
- architecture.push(`- \`${pathsMap.backend}\`: Fastify API`);
18
- architecture.push(`- \`${pathsMap.backend}/src/types\`: Contract-first backend TypeScript types`);
19
- }
20
- if (spec.platform === "full-stack" || spec.platform === "web") {
21
- architecture.push(`- \`${pathsMap.frontend}\`: React dashboard`);
22
- }
23
- if (spec.platform === "mobile") {
24
- architecture.push(`- \`${pathsMap.mobile || "apps/mobile"}\`: Expo / React Native App`);
25
- }
26
-
27
- writeTextFile(path.join(docsDir, "project-docs.md"), [
28
- `# ${spec.title} Requirements`,
29
- "",
30
- "## Request",
31
- "",
32
- spec.rawDescription,
33
- "",
34
- "## Generated Scope",
35
- "",
36
- `- Platform: ${spec.platform}`,
37
- `- Domain: ${spec.domain}`,
38
- `- Auth: ${spec.modules.auth ? "yes" : "no"}`,
39
- `- Users: ${spec.modules.users ? "yes" : "no"}`,
40
- `- Roles: ${spec.modules.roles ? "yes" : "no"}`,
41
- `- Reports: ${spec.modules.reports ? "yes" : "no"}`,
42
- "",
43
- "## Architecture",
44
- "",
45
- ...architecture,
46
- ].join("\n"));
47
-
48
- writeTextFile(path.join(apiDir, "README.md"), [
49
- "# API Registry",
50
- "",
51
- "- `POST /api/v1/auth/login`",
52
- "- `GET /api/v1/dashboard`",
53
- "- `GET /api/v1/users`",
54
- "- `GET /api/v1/roles`",
55
- "- `GET /api/v1/customers`",
56
- "- `GET /api/v1/reports`",
57
- ].join("\n"));
58
- }
59
-
60
- export function updateMemoryForGeneratedApp(spec: AppSpec, traceId: string): void {
61
- const memoryPath = getMemoryPath();
62
- if (!fs.existsSync(memoryPath)) return;
63
-
64
- const pathsMap = getConfiguredPaths();
65
- const today = new Date().toISOString().split("T")[0];
66
-
67
- const impactedFiles = [];
68
- if (spec.platform === "full-stack" || spec.platform === "backend") impactedFiles.push(pathsMap.backend);
69
- if (spec.platform === "full-stack" || spec.platform === "web") impactedFiles.push(pathsMap.frontend);
70
- if (spec.platform === "mobile") impactedFiles.push(pathsMap.mobile || "apps/mobile");
71
- impactedFiles.push("project docs");
72
-
73
- const history = [
74
- `### ${today} — Generated ${spec.title}`,
75
- "",
76
- "- **Agent:** @manager",
77
- `- **Trace ID:** ${traceId}`,
78
- `- **Action:** Created ${spec.platform} starter from natural language request.`,
79
- `- **Files:** ${impactedFiles.join(", ")}`,
80
- ].join("\n");
81
-
82
- updateProjectMemory("HISTORY", history);
83
- }
@@ -1,263 +0,0 @@
1
- import path from "path";
2
- import type { AppSpec } from "./app-inferrer.js";
3
- import { createBaseTypeFiles } from "./app-types.js";
4
- import { writeJsonFile, writeTextFile } from "./fs.js";
5
- import { getConfiguredPaths } from "./memory.js";
6
- import { getDependencyVersions } from "./pkg.js";
7
-
8
- const targetDir = process.cwd();
9
-
10
- export function createWebFiles(spec: AppSpec): void {
11
- const pathsMap = getConfiguredPaths();
12
- const frontendDir = pathsMap.frontend;
13
- const { "@vitejs/plugin-react": vitePluginReact, vite, react, "react-dom": reactDom, "lucide-react": lucideReact, "@types/react": typesReact, "@types/react-dom": typesReactDom, typescript, "vitest-frontend": vitest } = getDependencyVersions();
14
-
15
- createBaseTypeFiles(path.join(targetDir, frontendDir, "src"));
16
- writeJsonFile(path.join(targetDir, frontendDir, "package.json"), {
17
- name: "@agent-enderun/web",
18
- version: "0.1.0",
19
- private: true,
20
- type: "module",
21
- scripts: {
22
- dev: "vite --host 0.0.0.0",
23
- build: "tsc -p tsconfig.json && vite build",
24
- preview: "vite preview",
25
- test: "vitest run",
26
- },
27
- dependencies: {
28
- "@vitejs/plugin-react": vitePluginReact,
29
- vite: vite,
30
- react: react,
31
- "react-dom": reactDom,
32
- "lucide-react": lucideReact,
33
- },
34
- devDependencies: {
35
- "@types/react": typesReact,
36
- "@types/react-dom": typesReactDom,
37
- typescript: typescript,
38
- vitest: vitest,
39
- },
40
- });
41
-
42
- writeJsonFile(path.join(targetDir, frontendDir, "tsconfig.json"), {
43
- extends: "../../tsconfig.json",
44
- compilerOptions: {
45
- jsx: "react-jsx",
46
- module: "NodeNext",
47
- moduleResolution: "NodeNext",
48
- target: "ES2022",
49
- strict: true,
50
- skipLibCheck: true,
51
- },
52
- include: ["src/**/*.ts", "src/**/*.tsx"],
53
- });
54
-
55
- writeTextFile(path.join(targetDir, frontendDir, "index.html"), [
56
- "<div id=\"root\"></div>",
57
- "<script type=\"module\" src=\"/src/main.tsx\"></script>",
58
- ].join("\n"));
59
-
60
- writeTextFile(path.join(targetDir, frontendDir, "src/main.tsx"), [
61
- "import React from \"react\";",
62
- "import { createRoot } from \"react-dom/client\";",
63
- "import { App } from \"./App.js\";",
64
- "import \"./styles.css\";",
65
- "",
66
- "createRoot(document.getElementById(\"root\") as HTMLElement).render(",
67
- " <React.StrictMode>",
68
- " <App />",
69
- " </React.StrictMode>,",
70
- ");",
71
- ].join("\n"));
72
-
73
- writeTextFile(path.join(targetDir, frontendDir, "src/App.tsx"), [
74
- "import { BarChart3, ShieldCheck, UsersRound } from \"lucide-react\";",
75
- "",
76
- "const metrics = [",
77
- " { label: \"Pipeline\", value: \"$261K\", tone: \"green\" },",
78
- " { label: \"Active customers\", value: \"18\", tone: \"blue\" },",
79
- " { label: \"At risk\", value: \"3\", tone: \"red\" },",
80
- "];",
81
- "",
82
- "const customers = [",
83
- " { name: \"Northwind\", status: \"Active\", owner: \"Sales Manager\", value: \"$125K\" },",
84
- " { name: \"Acme Corp\", status: \"Lead\", owner: \"Sales Manager\", value: \"$82K\" },",
85
- " { name: \"Globex\", status: \"At risk\", owner: \"Admin User\", value: \"$54K\" },",
86
- "];",
87
- "",
88
- "export function App() {",
89
- " return (",
90
- " <main className=\"shell\">",
91
- " <aside className=\"sidebar\" aria-label=\"Primary navigation\">",
92
- " <div className=\"brand\">AE</div>",
93
- " <nav>",
94
- " <a className=\"active\" href=\"#dashboard\"><BarChart3 size={18} /> Dashboard</a>",
95
- " <a href=\"#users\"><UsersRound size={18} /> Users</a>",
96
- " <a href=\"#roles\"><ShieldCheck size={18} /> Roles</a>",
97
- " </nav>",
98
- " </aside>",
99
- "",
100
- " <section className=\"workspace\">",
101
- " <header className=\"topbar\">",
102
- " <div>",
103
- " <p>{spec.domain}</p>",
104
- " <h1>{spec.title}</h1>",
105
- " </div>",
106
- " <button type=\"button\">New customer</button>",
107
- " </header>",
108
- "",
109
- " <section className=\"metrics\" aria-label=\"Report metrics\">",
110
- " {metrics.map((metric) => (",
111
- " <article className={`metric ${metric.tone}`} key={metric.label}>",
112
- " <span>{metric.label}</span>",
113
- " <strong>{metric.value}</strong>",
114
- " </article>",
115
- " ))}",
116
- " </section>",
117
- "",
118
- " <section className=\"panel\">",
119
- " <div>",
120
- " <h2>Customers</h2>",
121
- " <p>Ownership, value and status at a glance.</p>",
122
- " </div>",
123
- " <div className=\"table\">",
124
- " {customers.map((customer) => (",
125
- " <div className=\"row\" key={customer.name}>",
126
- " <strong>{customer.name}</strong>",
127
- " <span>{customer.status}</span>",
128
- " <span>{customer.owner}</span>",
129
- " <b>{customer.value}</b>",
130
- " </div>",
131
- " ))}",
132
- " </div>",
133
- " </section>",
134
- " </section>",
135
- " </main>",
136
- " );",
137
- "}",
138
- ].join("\n"));
139
-
140
- writeTextFile(path.join(targetDir, frontendDir, "src/styles.css"), [
141
- ":root {",
142
- " color: #172026;",
143
- " background: #f4f7f6;",
144
- " font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;",
145
- "}",
146
- "",
147
- "* { box-sizing: border-box; }",
148
- "body { margin: 0; }",
149
- "button { font: inherit; }",
150
- "",
151
- ".shell {",
152
- " min-height: 100vh;",
153
- " display: grid;",
154
- " grid-template-columns: 240px 1fr;",
155
- "}",
156
- "",
157
- ".sidebar {",
158
- " background: #102022;",
159
- " color: #eef6f2;",
160
- " padding: 24px;",
161
- "}",
162
- "",
163
- ".brand {",
164
- " width: 40px;",
165
- " height: 40px;",
166
- " display: grid;",
167
- " place-items: center;",
168
- " background: #d8f36a;",
169
- " color: #102022;",
170
- " font-weight: 800;",
171
- " border-radius: 8px;",
172
- " margin-bottom: 32px;",
173
- "}",
174
- "",
175
- "nav { display: grid; gap: 8px; }",
176
- "nav a {",
177
- " color: inherit;",
178
- " text-decoration: none;",
179
- " display: flex;",
180
- " gap: 10px;",
181
- " align-items: center;",
182
- " padding: 10px 12px;",
183
- " border-radius: 8px;",
184
- "}",
185
- "nav a.active, nav a:hover { background: rgba(255,255,255,0.12); }",
186
- "",
187
- ".workspace { padding: 32px; }",
188
- ".topbar {",
189
- " display: flex;",
190
- " justify-content: space-between;",
191
- " align-items: center;",
192
- " gap: 24px;",
193
- " margin-bottom: 24px;",
194
- "}",
195
- ".topbar p { margin: 0 0 4px; color: #58666a; font-size: 14px; }",
196
- ".topbar h1 { margin: 0; font-size: 32px; letter-spacing: 0; }",
197
- ".topbar button {",
198
- " border: 0;",
199
- " border-radius: 8px;",
200
- " background: #176b5d;",
201
- " color: white;",
202
- " padding: 10px 14px;",
203
- "}",
204
- "",
205
- ".metrics {",
206
- " display: grid;",
207
- " grid-template-columns: repeat(3, minmax(0, 1fr));",
208
- " gap: 16px;",
209
- " margin-bottom: 24px;",
210
- "}",
211
- ".metric, .panel {",
212
- " background: white;",
213
- " border: 1px solid #d9e3e0;",
214
- " border-radius: 8px;",
215
- "}",
216
- ".metric { padding: 18px; }",
217
- ".metric span { display: block; color: #58666a; margin-bottom: 8px; }",
218
- ".metric strong { font-size: 28px; }",
219
- ".metric.green { border-top: 4px solid #49a078; }",
220
- ".metric.blue { border-top: 4px solid #3f7cac; }",
221
- ".metric.red { border-top: 4px solid #d95d39; }",
222
- "",
223
- ".panel { padding: 20px; }",
224
- ".panel h2 { margin: 0 0 4px; font-size: 20px; }",
225
- ".panel p { margin: 0 0 18px; color: #58666a; }",
226
- ".table { display: grid; gap: 8px; }",
227
- ".row {",
228
- " display: grid;",
229
- " grid-template-columns: 1.4fr 0.8fr 1fr 0.6fr;",
230
- " gap: 16px;",
231
- " align-items: center;",
232
- " padding: 12px;",
233
- " border-radius: 8px;",
234
- " background: #f7faf9;",
235
- "}",
236
- "",
237
- "@media (max-width: 760px) {",
238
- " .shell { grid-template-columns: 1fr; }",
239
- " .sidebar { position: static; }",
240
- " .metrics { grid-template-columns: 1fr; }",
241
- " .topbar { align-items: flex-start; flex-direction: column; }",
242
- " .row { grid-template-columns: 1fr; }",
243
- "}",
244
- ].join("\n"));
245
-
246
- writeTextFile(path.join(targetDir, frontendDir, ".env.example"), [
247
- "# Agent Enderun - Web Environment Variables",
248
- "VITE_API_URL=http://localhost:4000/api/v1",
249
- "VITE_APP_TITLE=" + spec.title,
250
- ].join("\n"));
251
-
252
- writeTextFile(path.join(targetDir, frontendDir, "README.md"), [
253
- `# ${spec.title} Web`,
254
- "",
255
- "React dashboard generated by Agent Enderun.",
256
- "",
257
- "## Commands",
258
- "",
259
- "- `npm run dev` strings",
260
- "- `npm run build` strings",
261
- "- `npm run test` strings",
262
- ].join("\n"));
263
- }
@@ -1,63 +0,0 @@
1
- import { slugifyName, titleCase } from "./string.js";
2
-
3
- export interface AppSpec {
4
- rawDescription: string;
5
- appName: string;
6
- title: string;
7
- domain: string;
8
- platform: "web" | "mobile" | "backend" | "full-stack";
9
- modules: {
10
- auth: boolean;
11
- users: boolean;
12
- roles: boolean;
13
- reports: boolean;
14
- };
15
- }
16
-
17
- export function inferAppSpec(description: string): AppSpec {
18
- const normalized = String(description || "").toLowerCase();
19
- const isCrm = /\bcrm\b|customer|musteri|müşteri/.test(normalized);
20
- const hasAuth = /auth|login|giris|giriş|signin|sign in|user|kullanici|kullanıcı|role|rol/.test(normalized);
21
- const hasRoles = /role|rol|permission|yetki|admin/.test(normalized);
22
- const hasReports = /report|rapor|analytics|dashboard|chart|metric/.test(normalized);
23
- const isMobile = /mobile|ios|android|react native|expo/.test(normalized);
24
- const isBackend = /backend|api|server|fastify|express/.test(normalized);
25
- const isWeb = /web|frontend|react|vite/.test(normalized);
26
- const appName = isCrm ? "crm-dashboard" : slugifyName(description).split("-").slice(0, 4).join("-");
27
-
28
- let platform: AppSpec["platform"] = "full-stack";
29
- if (isMobile) platform = "mobile";
30
- else if (isBackend && !isWeb) platform = "backend";
31
- else if (isWeb && !isBackend) platform = "web";
32
-
33
- return {
34
- rawDescription: description,
35
- appName,
36
- title: isCrm ? "CRM Dashboard" : titleCase(appName),
37
- domain: isCrm ? "CRM" : "Business",
38
- platform,
39
- modules: {
40
- auth: hasAuth || isCrm,
41
- users: hasAuth || hasRoles || isCrm,
42
- roles: hasRoles || isCrm,
43
- reports: hasReports || isCrm,
44
- },
45
- };
46
- }
47
-
48
- export async function collectCreateAppDescription(args: string[]): Promise<string> {
49
- const initial = args.join(" ").trim();
50
- if (initial) return initial;
51
-
52
- const readline = await import("readline/promises");
53
- const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
54
- try {
55
- const idea = await rl.question("What do you want to build? ");
56
- const platform = await rl.question("Platform? (full-stack/web/backend/mobile) ");
57
- const auth = await rl.question("Auth and roles? (yes/no) ");
58
- const reports = await rl.question("Reports/dashboard? (yes/no) ");
59
- return [idea, platform, auth.includes("y") ? "with auth and roles" : "", reports.includes("y") ? "with reports dashboard" : ""].filter(Boolean).join(" ");
60
- } finally {
61
- rl.close();
62
- }
63
- }