swallowkit 1.0.0-beta.9 → 1.0.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 (272) hide show
  1. package/README.ja.md +87 -181
  2. package/README.md +87 -238
  3. package/dist/__tests__/fixtures.d.ts +12 -0
  4. package/dist/__tests__/fixtures.d.ts.map +1 -1
  5. package/dist/__tests__/fixtures.js +101 -0
  6. package/dist/__tests__/fixtures.js.map +1 -1
  7. package/dist/cli/commands/add-auth.d.ts +15 -0
  8. package/dist/cli/commands/add-auth.d.ts.map +1 -0
  9. package/dist/cli/commands/add-auth.js +790 -0
  10. package/dist/cli/commands/add-auth.js.map +1 -0
  11. package/dist/cli/commands/add-connector.d.ts +20 -0
  12. package/dist/cli/commands/add-connector.d.ts.map +1 -0
  13. package/dist/cli/commands/add-connector.js +164 -0
  14. package/dist/cli/commands/add-connector.js.map +1 -0
  15. package/dist/cli/commands/cosmos-worktree-isolation.d.ts +25 -0
  16. package/dist/cli/commands/cosmos-worktree-isolation.d.ts.map +1 -0
  17. package/dist/cli/commands/cosmos-worktree-isolation.js +124 -0
  18. package/dist/cli/commands/cosmos-worktree-isolation.js.map +1 -0
  19. package/dist/cli/commands/create-model.d.ts +1 -4
  20. package/dist/cli/commands/create-model.d.ts.map +1 -1
  21. package/dist/cli/commands/create-model.js +20 -82
  22. package/dist/cli/commands/create-model.js.map +1 -1
  23. package/dist/cli/commands/dev-seeds.d.ts +27 -0
  24. package/dist/cli/commands/dev-seeds.d.ts.map +1 -1
  25. package/dist/cli/commands/dev-seeds.js +188 -6
  26. package/dist/cli/commands/dev-seeds.js.map +1 -1
  27. package/dist/cli/commands/dev.d.ts +30 -0
  28. package/dist/cli/commands/dev.d.ts.map +1 -1
  29. package/dist/cli/commands/dev.js +495 -129
  30. package/dist/cli/commands/dev.js.map +1 -1
  31. package/dist/cli/commands/init.d.ts +69 -1
  32. package/dist/cli/commands/init.d.ts.map +1 -1
  33. package/dist/cli/commands/init.js +788 -766
  34. package/dist/cli/commands/init.js.map +1 -1
  35. package/dist/cli/commands/scaffold.d.ts +24 -3
  36. package/dist/cli/commands/scaffold.d.ts.map +1 -1
  37. package/dist/cli/commands/scaffold.js +408 -189
  38. package/dist/cli/commands/scaffold.js.map +1 -1
  39. package/dist/cli/index.d.ts +5 -1
  40. package/dist/cli/index.d.ts.map +1 -1
  41. package/dist/cli/index.js +335 -58
  42. package/dist/cli/index.js.map +1 -1
  43. package/dist/core/config.d.ts +13 -3
  44. package/dist/core/config.d.ts.map +1 -1
  45. package/dist/core/config.js +151 -8
  46. package/dist/core/config.js.map +1 -1
  47. package/dist/core/mock/connector-mock-server.d.ts +101 -0
  48. package/dist/core/mock/connector-mock-server.d.ts.map +1 -0
  49. package/dist/core/mock/connector-mock-server.js +480 -0
  50. package/dist/core/mock/connector-mock-server.js.map +1 -0
  51. package/dist/core/mock/zod-mock-generator.d.ts +14 -0
  52. package/dist/core/mock/zod-mock-generator.d.ts.map +1 -0
  53. package/dist/core/mock/zod-mock-generator.js +163 -0
  54. package/dist/core/mock/zod-mock-generator.js.map +1 -0
  55. package/dist/core/operations/auth-operations.d.ts +61 -0
  56. package/dist/core/operations/auth-operations.d.ts.map +1 -0
  57. package/dist/core/operations/auth-operations.js +272 -0
  58. package/dist/core/operations/auth-operations.js.map +1 -0
  59. package/dist/core/operations/create-model.d.ts +15 -0
  60. package/dist/core/operations/create-model.d.ts.map +1 -0
  61. package/dist/core/operations/create-model.js +185 -0
  62. package/dist/core/operations/create-model.js.map +1 -0
  63. package/dist/core/operations/file-session.d.ts +56 -0
  64. package/dist/core/operations/file-session.d.ts.map +1 -0
  65. package/dist/core/operations/file-session.js +203 -0
  66. package/dist/core/operations/file-session.js.map +1 -0
  67. package/dist/core/operations/provision-operations.d.ts +52 -0
  68. package/dist/core/operations/provision-operations.d.ts.map +1 -0
  69. package/dist/core/operations/provision-operations.js +211 -0
  70. package/dist/core/operations/provision-operations.js.map +1 -0
  71. package/dist/core/operations/runtime.d.ts +37 -0
  72. package/dist/core/operations/runtime.d.ts.map +1 -0
  73. package/dist/core/operations/runtime.js +248 -0
  74. package/dist/core/operations/runtime.js.map +1 -0
  75. package/dist/core/operations/scaffold-apply.d.ts +21 -0
  76. package/dist/core/operations/scaffold-apply.d.ts.map +1 -0
  77. package/dist/core/operations/scaffold-apply.js +57 -0
  78. package/dist/core/operations/scaffold-apply.js.map +1 -0
  79. package/dist/core/operations/scaffold-machine.d.ts +16 -0
  80. package/dist/core/operations/scaffold-machine.d.ts.map +1 -0
  81. package/dist/core/operations/scaffold-machine.js +51 -0
  82. package/dist/core/operations/scaffold-machine.js.map +1 -0
  83. package/dist/core/operations/scaffold-plan.d.ts +43 -0
  84. package/dist/core/operations/scaffold-plan.d.ts.map +1 -0
  85. package/dist/core/operations/scaffold-plan.js +187 -0
  86. package/dist/core/operations/scaffold-plan.js.map +1 -0
  87. package/dist/core/project/agent-instructions.d.ts +29 -0
  88. package/dist/core/project/agent-instructions.d.ts.map +1 -0
  89. package/dist/core/project/agent-instructions.js +160 -0
  90. package/dist/core/project/agent-instructions.js.map +1 -0
  91. package/dist/core/project/artifacts.d.ts +58 -0
  92. package/dist/core/project/artifacts.d.ts.map +1 -0
  93. package/dist/core/project/artifacts.js +179 -0
  94. package/dist/core/project/artifacts.js.map +1 -0
  95. package/dist/core/project/boundaries.d.ts +50 -0
  96. package/dist/core/project/boundaries.d.ts.map +1 -0
  97. package/dist/core/project/boundaries.js +117 -0
  98. package/dist/core/project/boundaries.js.map +1 -0
  99. package/dist/core/project/capabilities.d.ts +58 -0
  100. package/dist/core/project/capabilities.d.ts.map +1 -0
  101. package/dist/core/project/capabilities.js +135 -0
  102. package/dist/core/project/capabilities.js.map +1 -0
  103. package/dist/core/project/drift.d.ts +29 -0
  104. package/dist/core/project/drift.d.ts.map +1 -0
  105. package/dist/core/project/drift.js +190 -0
  106. package/dist/core/project/drift.js.map +1 -0
  107. package/dist/core/project/infra.d.ts +49 -0
  108. package/dist/core/project/infra.d.ts.map +1 -0
  109. package/dist/core/project/infra.js +167 -0
  110. package/dist/core/project/infra.js.map +1 -0
  111. package/dist/core/project/manifest.d.ts +92 -0
  112. package/dist/core/project/manifest.d.ts.map +1 -0
  113. package/dist/core/project/manifest.js +321 -0
  114. package/dist/core/project/manifest.js.map +1 -0
  115. package/dist/core/project/state.d.ts +15 -0
  116. package/dist/core/project/state.d.ts.map +1 -0
  117. package/dist/core/project/state.js +106 -0
  118. package/dist/core/project/state.js.map +1 -0
  119. package/dist/core/project/validation.d.ts +20 -0
  120. package/dist/core/project/validation.d.ts.map +1 -0
  121. package/dist/core/project/validation.js +274 -0
  122. package/dist/core/project/validation.js.map +1 -0
  123. package/dist/core/project/workflows.d.ts +43 -0
  124. package/dist/core/project/workflows.d.ts.map +1 -0
  125. package/dist/core/project/workflows.js +299 -0
  126. package/dist/core/project/workflows.js.map +1 -0
  127. package/dist/core/scaffold/auth-generator.d.ts +63 -0
  128. package/dist/core/scaffold/auth-generator.d.ts.map +1 -0
  129. package/dist/core/scaffold/auth-generator.js +1774 -0
  130. package/dist/core/scaffold/auth-generator.js.map +1 -0
  131. package/dist/core/scaffold/connector-functions-generator.d.ts +41 -0
  132. package/dist/core/scaffold/connector-functions-generator.d.ts.map +1 -0
  133. package/dist/core/scaffold/connector-functions-generator.js +1029 -0
  134. package/dist/core/scaffold/connector-functions-generator.js.map +1 -0
  135. package/dist/core/scaffold/functions-generator.d.ts +4 -3
  136. package/dist/core/scaffold/functions-generator.d.ts.map +1 -1
  137. package/dist/core/scaffold/functions-generator.js +405 -134
  138. package/dist/core/scaffold/functions-generator.js.map +1 -1
  139. package/dist/core/scaffold/model-parser.d.ts +20 -0
  140. package/dist/core/scaffold/model-parser.d.ts.map +1 -1
  141. package/dist/core/scaffold/model-parser.js +229 -78
  142. package/dist/core/scaffold/model-parser.js.map +1 -1
  143. package/dist/core/scaffold/native-schema-generator.d.ts +19 -0
  144. package/dist/core/scaffold/native-schema-generator.d.ts.map +1 -0
  145. package/dist/core/scaffold/native-schema-generator.js +753 -0
  146. package/dist/core/scaffold/native-schema-generator.js.map +1 -0
  147. package/dist/core/scaffold/nextjs-generator.d.ts +8 -0
  148. package/dist/core/scaffold/nextjs-generator.d.ts.map +1 -1
  149. package/dist/core/scaffold/nextjs-generator.js +152 -8
  150. package/dist/core/scaffold/nextjs-generator.js.map +1 -1
  151. package/dist/core/scaffold/ui-generator.d.ts +17 -4
  152. package/dist/core/scaffold/ui-generator.d.ts.map +1 -1
  153. package/dist/core/scaffold/ui-generator.js +174 -34
  154. package/dist/core/scaffold/ui-generator.js.map +1 -1
  155. package/dist/core/verify/index.d.ts +69 -0
  156. package/dist/core/verify/index.d.ts.map +1 -0
  157. package/dist/core/verify/index.js +412 -0
  158. package/dist/core/verify/index.js.map +1 -0
  159. package/dist/machine/contracts.d.ts +24 -0
  160. package/dist/machine/contracts.d.ts.map +1 -0
  161. package/dist/machine/contracts.js +3 -0
  162. package/dist/machine/contracts.js.map +1 -0
  163. package/dist/machine/errors.d.ts +14 -0
  164. package/dist/machine/errors.d.ts.map +1 -0
  165. package/dist/machine/errors.js +42 -0
  166. package/dist/machine/errors.js.map +1 -0
  167. package/dist/machine/index.d.ts +3 -0
  168. package/dist/machine/index.d.ts.map +1 -0
  169. package/dist/machine/index.js +566 -0
  170. package/dist/machine/index.js.map +1 -0
  171. package/dist/mcp/index.d.ts +25 -0
  172. package/dist/mcp/index.d.ts.map +1 -0
  173. package/dist/mcp/index.js +425 -0
  174. package/dist/mcp/index.js.map +1 -0
  175. package/dist/types/index.d.ts +105 -0
  176. package/dist/types/index.d.ts.map +1 -1
  177. package/dist/utils/package-manager.d.ts +7 -11
  178. package/dist/utils/package-manager.d.ts.map +1 -1
  179. package/dist/utils/package-manager.js +42 -17
  180. package/dist/utils/package-manager.js.map +1 -1
  181. package/dist/utils/python-uv.d.ts +21 -0
  182. package/dist/utils/python-uv.d.ts.map +1 -0
  183. package/dist/utils/python-uv.js +111 -0
  184. package/dist/utils/python-uv.js.map +1 -0
  185. package/dist/version.d.ts +2 -0
  186. package/dist/version.d.ts.map +1 -0
  187. package/dist/version.js +49 -0
  188. package/dist/version.js.map +1 -0
  189. package/package.json +15 -17
  190. package/src/__tests__/__snapshots__/functions-generator.test.ts.snap +716 -22
  191. package/src/__tests__/__snapshots__/nextjs-generator.test.ts.snap +19 -7
  192. package/src/__tests__/__snapshots__/ui-generator.test.ts.snap +20 -12
  193. package/src/__tests__/agent-instructions.test.ts +237 -0
  194. package/src/__tests__/agent-loop-phase34.test.ts +619 -0
  195. package/src/__tests__/auth.test.ts +770 -0
  196. package/src/__tests__/bff-swa-auth.test.ts +275 -0
  197. package/src/__tests__/config.test.ts +176 -3
  198. package/src/__tests__/connector-functions-generator.test.ts +288 -0
  199. package/src/__tests__/connector-mock-server.test.ts +459 -0
  200. package/src/__tests__/connector-model-bff.test.ts +162 -0
  201. package/src/__tests__/cosmos-worktree-isolation.test.ts +149 -0
  202. package/src/__tests__/dev-seeds.test.ts +124 -0
  203. package/src/__tests__/dev.test.ts +254 -0
  204. package/src/__tests__/file-session.test.ts +98 -0
  205. package/src/__tests__/fixtures.ts +101 -0
  206. package/src/__tests__/functions-generator.test.ts +137 -1
  207. package/src/__tests__/init.test.ts +366 -2
  208. package/src/__tests__/jest-globals.d.ts +8 -0
  209. package/src/__tests__/machine.test.ts +371 -0
  210. package/src/__tests__/mcp.test.ts +253 -0
  211. package/src/__tests__/model-parser.test.ts +142 -0
  212. package/src/__tests__/multi-auth.test.ts +160 -0
  213. package/src/__tests__/nextjs-generator.test.ts +8 -0
  214. package/src/__tests__/package-manager.test.ts +59 -4
  215. package/src/__tests__/plan-apply.test.ts +499 -0
  216. package/src/__tests__/python-uv.test.ts +48 -0
  217. package/src/__tests__/scaffold.test.ts +287 -24
  218. package/src/__tests__/tsconfig.json +15 -0
  219. package/src/__tests__/ui-generator.test.ts +104 -0
  220. package/src/__tests__/zod-mock-generator.test.ts +132 -0
  221. package/src/cli/commands/add-auth.ts +853 -0
  222. package/src/cli/commands/add-connector.ts +159 -0
  223. package/src/cli/commands/cosmos-worktree-isolation.ts +130 -0
  224. package/src/cli/commands/create-model.ts +21 -100
  225. package/src/cli/commands/dev-seeds.ts +278 -7
  226. package/src/cli/commands/dev.ts +607 -160
  227. package/src/cli/commands/init.ts +851 -786
  228. package/src/cli/commands/scaffold.ts +531 -236
  229. package/src/cli/index.ts +338 -60
  230. package/src/core/config.ts +145 -9
  231. package/src/core/mock/connector-mock-server.ts +555 -0
  232. package/src/core/mock/zod-mock-generator.ts +205 -0
  233. package/src/core/operations/auth-operations.ts +360 -0
  234. package/src/core/operations/create-model.ts +191 -0
  235. package/src/core/operations/file-session.ts +222 -0
  236. package/src/core/operations/provision-operations.ts +297 -0
  237. package/src/core/operations/runtime.ts +258 -0
  238. package/src/core/operations/scaffold-apply.ts +106 -0
  239. package/src/core/operations/scaffold-machine.ts +77 -0
  240. package/src/core/operations/scaffold-plan.ts +215 -0
  241. package/src/core/project/agent-instructions.ts +167 -0
  242. package/src/core/project/agent-templates/AGENTS.md +504 -0
  243. package/src/core/project/agent-templates/CLAUDE.md +31 -0
  244. package/src/core/project/agent-templates/azure-functions.instructions.md +22 -0
  245. package/src/core/project/agent-templates/bff-routes.instructions.md +18 -0
  246. package/src/core/project/agent-templates/copilot-instructions.md +27 -0
  247. package/src/core/project/agent-templates/shared-models.instructions.md +72 -0
  248. package/src/core/project/artifacts.ts +205 -0
  249. package/src/core/project/boundaries.ts +170 -0
  250. package/src/core/project/capabilities.ts +193 -0
  251. package/src/core/project/drift.ts +203 -0
  252. package/src/core/project/infra.ts +196 -0
  253. package/src/core/project/manifest.ts +402 -0
  254. package/src/core/project/state.ts +77 -0
  255. package/src/core/project/validation.ts +295 -0
  256. package/src/core/project/workflows.ts +295 -0
  257. package/src/core/scaffold/auth-generator.ts +1824 -0
  258. package/src/core/scaffold/connector-functions-generator.ts +1133 -0
  259. package/src/core/scaffold/functions-generator.ts +432 -134
  260. package/src/core/scaffold/model-parser.ts +244 -90
  261. package/src/core/scaffold/native-schema-generator.ts +904 -0
  262. package/src/core/scaffold/nextjs-generator.ts +174 -9
  263. package/src/core/scaffold/ui-generator.ts +191 -36
  264. package/src/core/verify/index.ts +468 -0
  265. package/src/machine/contracts.ts +33 -0
  266. package/src/machine/errors.ts +45 -0
  267. package/src/machine/index.ts +690 -0
  268. package/src/mcp/index.ts +423 -0
  269. package/src/types/index.ts +137 -0
  270. package/src/utils/package-manager.ts +41 -19
  271. package/src/utils/python-uv.ts +96 -0
  272. package/src/version.ts +13 -0
@@ -0,0 +1,371 @@
1
+ import * as fs from "fs";
2
+ import * as os from "os";
3
+ import * as path from "path";
4
+ import { EventEmitter } from "events";
5
+ import * as childProcess from "child_process";
6
+ import { runMachineCli } from "../machine";
7
+
8
+ jest.mock("child_process", () => {
9
+ const actual = jest.requireActual<typeof import("child_process")>("child_process");
10
+ return {
11
+ ...actual,
12
+ spawn: jest.fn(),
13
+ spawnSync: jest.fn(),
14
+ };
15
+ });
16
+
17
+ const repoRoot = process.cwd();
18
+
19
+ function writeFile(filePath: string, content: string): void {
20
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
21
+ fs.writeFileSync(filePath, content, "utf-8");
22
+ }
23
+
24
+ function createModelSource(name: string): string {
25
+ return `import { z } from 'zod/v4';
26
+
27
+ export const ${name} = z.object({
28
+ id: z.string(),
29
+ name: z.string().min(1),
30
+ createdAt: z.string().optional(),
31
+ updatedAt: z.string().optional(),
32
+ });
33
+
34
+ export type ${name} = z.infer<typeof ${name}>;
35
+
36
+ export const displayName = '${name}';
37
+ `;
38
+ }
39
+
40
+ function createProjectFixture(rootDir: string, options: { includeGeneratedArtifacts?: boolean; forbiddenBffDependency?: boolean } = {}): void {
41
+ writeFile(path.join(rootDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
42
+ writeFile(
43
+ path.join(rootDir, "swallowkit.config.js"),
44
+ `module.exports = {
45
+ database: {
46
+ connectionString: 'AccountEndpoint=https://example.local;',
47
+ },
48
+ backend: {
49
+ language: 'typescript',
50
+ },
51
+ api: {
52
+ endpoint: '/api/_swallowkit',
53
+ },
54
+ };
55
+ `
56
+ );
57
+ writeFile(path.join(rootDir, "shared", "package.json"), JSON.stringify({ name: "@sample-app/shared" }, null, 2));
58
+ writeFile(path.join(rootDir, "shared", "index.ts"), "export {};\n");
59
+ writeFile(path.join(rootDir, "shared", "models", "todo.ts"), createModelSource("Todo"));
60
+ fs.mkdirSync(path.join(rootDir, "node_modules"), { recursive: true });
61
+ fs.symlinkSync(
62
+ path.join(repoRoot, "node_modules", "zod"),
63
+ path.join(rootDir, "node_modules", "zod"),
64
+ "junction"
65
+ );
66
+
67
+ if (options.includeGeneratedArtifacts) {
68
+ writeFile(path.join(rootDir, "lib", "api", "call-function.ts"), "export function callFunction() {}\n");
69
+ writeFile(path.join(rootDir, "functions", "src", "todo.ts"), "export {};\n");
70
+ writeFile(path.join(rootDir, "app", "api", "todo", "route.ts"), "export async function GET() { return Response.json([]); }\n");
71
+ writeFile(path.join(rootDir, "app", "api", "todo", "[id]", "route.ts"), "export async function GET() { return Response.json({}); }\n");
72
+ }
73
+
74
+ if (options.forbiddenBffDependency) {
75
+ writeFile(
76
+ path.join(rootDir, "app", "api", "forbidden", "route.ts"),
77
+ "import { CosmosClient } from '@azure/cosmos';\nexport async function GET() { return Response.json({ ok: Boolean(CosmosClient) }); }\n"
78
+ );
79
+ }
80
+ }
81
+
82
+ function createCSharpScaffoldFixture(rootDir: string): void {
83
+ writeFile(path.join(rootDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
84
+ writeFile(
85
+ path.join(rootDir, "swallowkit.config.js"),
86
+ `module.exports = {
87
+ backend: {
88
+ language: 'csharp',
89
+ },
90
+ api: {
91
+ endpoint: '/api/_swallowkit',
92
+ },
93
+ };
94
+ `
95
+ );
96
+ writeFile(path.join(rootDir, "shared", "package.json"), JSON.stringify({ name: "@sample-app/shared" }, null, 2));
97
+ writeFile(path.join(rootDir, "shared", "index.ts"), "export {};\n");
98
+ writeFile(path.join(rootDir, "shared", "models", "estimate.ts"), createModelSource("Estimate"));
99
+ writeFile(path.join(rootDir, "shared", "models", "member.ts"), createModelSource("Member"));
100
+ writeFile(path.join(rootDir, "shared", "models", "team.ts"), createModelSource("Team"));
101
+ fs.mkdirSync(path.join(rootDir, "node_modules"), { recursive: true });
102
+ fs.symlinkSync(
103
+ path.join(repoRoot, "node_modules", "zod"),
104
+ path.join(rootDir, "node_modules", "zod"),
105
+ "junction"
106
+ );
107
+
108
+ writeFile(
109
+ path.join(rootDir, "functions", "Crud", "EstimateFunctions.cs"),
110
+ "namespace SwallowKit.Functions;\npublic sealed class EstimateFunctions { public void Approve() {} public void Submit() {} public void Remand() {} }\n"
111
+ );
112
+ writeFile(path.join(rootDir, "functions", "generated", "csharp-models", "README.md"), "keep generated readme\n");
113
+ writeFile(path.join(rootDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.csproj"), "<Project />\n");
114
+ writeFile(path.join(rootDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.sln"), "solution\n");
115
+ writeFile(
116
+ path.join(rootDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Member.cs"),
117
+ "// existing member\n"
118
+ );
119
+ writeFile(
120
+ path.join(rootDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Team.cs"),
121
+ "// existing team\n"
122
+ );
123
+ }
124
+
125
+ function mockSuccessfulSpawn() {
126
+ const spawnMock = childProcess.spawn as unknown as any;
127
+ spawnMock.mockImplementation(() => {
128
+ const child = new EventEmitter() as childProcess.ChildProcess;
129
+ process.nextTick(() => child.emit("close", 0));
130
+ return child;
131
+ });
132
+ return spawnMock;
133
+ }
134
+
135
+ function createFreshInitProjectFixture(rootDir: string, backendLanguage: "csharp" | "python" = "csharp"): void {
136
+ writeFile(path.join(rootDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
137
+ writeFile(
138
+ path.join(rootDir, "swallowkit.config.js"),
139
+ `module.exports = {
140
+ backend: {
141
+ language: '${backendLanguage}',
142
+ },
143
+ functions: {
144
+ baseUrl: process.env.BACKEND_FUNCTIONS_BASE_URL || process.env.FUNCTIONS_BASE_URL || 'http://localhost:7071',
145
+ },
146
+ deployment: {
147
+ resourceGroup: process.env.AZURE_RESOURCE_GROUP || '',
148
+ swaName: process.env.AZURE_SWA_NAME || '',
149
+ },
150
+ };
151
+ `
152
+ );
153
+ writeFile(path.join(rootDir, "shared", "package.json"), JSON.stringify({ name: "@sample-app/shared" }, null, 2));
154
+ writeFile(path.join(rootDir, "shared", "index.ts"), "export {};\n");
155
+ fs.mkdirSync(path.join(rootDir, "shared", "models"), { recursive: true });
156
+ writeFile(path.join(rootDir, "app", "api", "greet", "route.ts"), "export async function GET() { return Response.json({}); }\n");
157
+ writeFile(path.join(rootDir, "lib", "api", "backend.ts"), "export const api = {};\n");
158
+ fs.mkdirSync(path.join(rootDir, "functions"), { recursive: true });
159
+ }
160
+
161
+ async function runMachine(argv: string[]): Promise<{ response: any; exitCode: number }> {
162
+ const writes: string[] = [];
163
+ const originalWrite = process.stdout.write.bind(process.stdout);
164
+ const originalExitCode = process.exitCode;
165
+
166
+ (process.stdout.write as unknown as (chunk: string | Uint8Array) => boolean) = ((chunk: string | Uint8Array) => {
167
+ writes.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf-8"));
168
+ return true;
169
+ }) as typeof process.stdout.write;
170
+
171
+ process.exitCode = 0;
172
+
173
+ try {
174
+ await runMachineCli(argv);
175
+ return {
176
+ response: JSON.parse(writes.join("")),
177
+ exitCode: process.exitCode || 0,
178
+ };
179
+ } finally {
180
+ process.stdout.write = originalWrite;
181
+ process.exitCode = originalExitCode;
182
+ }
183
+ }
184
+
185
+ describe("machine CLI", () => {
186
+ const originalCwd = process.cwd();
187
+ let tempDir: string;
188
+
189
+ beforeEach(() => {
190
+ tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "swallowkit-machine-"));
191
+ process.chdir(tempDir);
192
+ });
193
+
194
+ afterEach(() => {
195
+ process.chdir(originalCwd);
196
+ fs.rmSync(tempDir, { recursive: true, force: true });
197
+ });
198
+
199
+ it("inspects SwallowKit project metadata as JSON", async () => {
200
+ createProjectFixture(tempDir, { includeGeneratedArtifacts: true });
201
+
202
+ const { response, exitCode } = await runMachine(["node", "swallowkit", "machine", "inspect", "project"]);
203
+
204
+ expect(exitCode).toBe(0);
205
+ expect(response.ok).toBe(true);
206
+ expect(response.command).toBe("inspect-project");
207
+ expect(response.data.manifest.entities[0].name).toBe("Todo");
208
+ expect(response.data.manifest.routes).toEqual(
209
+ expect.arrayContaining([
210
+ expect.objectContaining({
211
+ name: "Todo-bff-list",
212
+ publicPath: "/api/todo",
213
+ exists: true,
214
+ }),
215
+ ])
216
+ );
217
+ });
218
+
219
+ it("returns the framework capability contract via inspect capabilities", async () => {
220
+ const { response, exitCode } = await runMachine(["node", "swallowkit", "machine", "inspect", "capabilities"]);
221
+
222
+ expect(exitCode).toBe(0);
223
+ expect(response.ok).toBe(true);
224
+ expect(response.command).toBe("inspect-capabilities");
225
+ const declarationNames = response.data.modelDeclarations.map((declaration: { name: string }) => declaration.name);
226
+ expect(declarationNames).toEqual(expect.arrayContaining(["schema", "displayName", "partitionKey", "authPolicy", "connectorConfig"]));
227
+ const partitionKey = response.data.modelDeclarations.find((declaration: { name: string }) => declaration.name === "partitionKey");
228
+ expect(partitionKey.format).toContain("export const partitionKey = '/");
229
+ expect(response.data.authentication.rules.join(" ")).toContain("NEVER hand-write auth.schemes");
230
+ expect(response.data.generatedCrud.notGuaranteed.join(" ")).toContain("Owner scoping");
231
+ expect(response.data.seeding.applySeeds).toContain("dev --seed-env");
232
+ });
233
+
234
+ it("validates forbidden BFF dependencies", async () => {
235
+ createProjectFixture(tempDir, {
236
+ includeGeneratedArtifacts: true,
237
+ forbiddenBffDependency: true,
238
+ });
239
+
240
+ const { response, exitCode } = await runMachine(["node", "swallowkit", "machine", "validate", "project"]);
241
+
242
+ expect(exitCode).toBe(0);
243
+ expect(response.ok).toBe(true);
244
+ expect(response.command).toBe("validate-project");
245
+ expect(response.data.violations).toEqual(
246
+ expect.arrayContaining([
247
+ expect.objectContaining({
248
+ code: "forbidden-bff-dependency",
249
+ severity: "error",
250
+ }),
251
+ ])
252
+ );
253
+ });
254
+
255
+ it("does not report false positives for a fresh C# init project", async () => {
256
+ createFreshInitProjectFixture(tempDir, "csharp");
257
+
258
+ const { response, exitCode } = await runMachine(["node", "swallowkit", "machine", "validate", "project"]);
259
+
260
+ expect(exitCode).toBe(0);
261
+ expect(response.ok).toBe(true);
262
+ expect(response.command).toBe("validate-project");
263
+ expect(response.data.manifest.backendLanguage).toBe("csharp");
264
+ expect(response.data.manifest.configValidation.valid).toBe(true);
265
+ expect(response.data.violations).toEqual([]);
266
+ });
267
+
268
+ it("generates model templates through the machine interface", async () => {
269
+ writeFile(path.join(tempDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
270
+ writeFile(
271
+ path.join(tempDir, "swallowkit.config.js"),
272
+ `module.exports = {
273
+ backend: { language: 'typescript' },
274
+ api: { endpoint: '/api/_swallowkit' },
275
+ };
276
+ `
277
+ );
278
+ fs.mkdirSync(path.join(tempDir, "node_modules"), { recursive: true });
279
+ fs.symlinkSync(
280
+ path.join(repoRoot, "node_modules", "zod"),
281
+ path.join(tempDir, "node_modules", "zod"),
282
+ "junction"
283
+ );
284
+ writeFile(path.join(tempDir, "shared", "index.ts"), "export {};\n");
285
+
286
+ const { response, exitCode } = await runMachine([
287
+ "node",
288
+ "swallowkit",
289
+ "machine",
290
+ "generate",
291
+ "model",
292
+ "Task",
293
+ "--overwrite",
294
+ "never",
295
+ ]);
296
+
297
+ expect(exitCode).toBe(0);
298
+ expect(response.ok).toBe(true);
299
+ expect(response.command).toBe("generate-model");
300
+ expect(response.data.createdFiles).toContain("shared/models/task.ts");
301
+ expect(fs.existsSync(path.join(tempDir, ".swallowkit", "project.json"))).toBe(true);
302
+ });
303
+
304
+ it("generates scaffold artifacts through the machine interface", async () => {
305
+ createProjectFixture(tempDir);
306
+
307
+ const { response, exitCode } = await runMachine([
308
+ "node",
309
+ "swallowkit",
310
+ "machine",
311
+ "generate",
312
+ "scaffold",
313
+ "todo",
314
+ "--api-only",
315
+ ]);
316
+
317
+ expect(exitCode).toBe(0);
318
+ expect(response.ok).toBe(true);
319
+ expect(response.command).toBe("generate-scaffold");
320
+ expect(response.data.createdFiles).toEqual(
321
+ expect.arrayContaining([
322
+ "app/api/todo/route.ts",
323
+ "app/api/todo/[id]/route.ts",
324
+ "functions/src/todo.ts",
325
+ "lib/api/call-function.ts",
326
+ ])
327
+ );
328
+ expect(fs.existsSync(path.join(tempDir, ".swallowkit", "project.json"))).toBe(true);
329
+ });
330
+
331
+ it("preserves C# custom Functions and shared generated assets when api-only scaffolding one model", async () => {
332
+ createCSharpScaffoldFixture(tempDir);
333
+ const spawnSyncMock = childProcess.spawnSync as unknown as any;
334
+ spawnSyncMock.mockReturnValue({ status: 0 });
335
+ const spawnMock = mockSuccessfulSpawn();
336
+
337
+ try {
338
+ const { response, exitCode } = await runMachine([
339
+ "node",
340
+ "swallowkit",
341
+ "machine",
342
+ "generate",
343
+ "scaffold",
344
+ "estimate",
345
+ "--api-only",
346
+ ]);
347
+
348
+ expect(exitCode).toBe(0);
349
+ expect(response.ok).toBe(true);
350
+ expect(response.command).toBe("generate-scaffold");
351
+ expect(response.data.createdFiles).toEqual(
352
+ expect.arrayContaining([
353
+ "functions/Crud/EstimateCrudFunctions.cs",
354
+ "app/api/estimate/route.ts",
355
+ "app/api/estimate/[id]/route.ts",
356
+ ])
357
+ );
358
+ expect(response.data.deletedFiles).toEqual([]);
359
+ expect(fs.readFileSync(path.join(tempDir, "functions", "Crud", "EstimateFunctions.cs"), "utf-8")).toContain("Approve");
360
+ expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "README.md"))).toBe(true);
361
+ expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.csproj"))).toBe(true);
362
+ expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.sln"))).toBe(true);
363
+ expect(fs.readFileSync(path.join(tempDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Member.cs"), "utf-8")).toBe("// existing member\n");
364
+ expect(fs.readFileSync(path.join(tempDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Team.cs"), "utf-8")).toBe("// existing team\n");
365
+ expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Estimate.cs"))).toBe(true);
366
+ } finally {
367
+ spawnMock.mockReset();
368
+ spawnSyncMock.mockReset();
369
+ }
370
+ });
371
+ });
@@ -0,0 +1,253 @@
1
+ import { spawn } from "child_process";
2
+ import * as fs from "fs";
3
+ import * as path from "path";
4
+ import { buildSwallowKitToolDefinitions } from "../mcp";
5
+
6
+ type MachineCliRunner = NonNullable<Parameters<typeof buildSwallowKitToolDefinitions>[0]>;
7
+ const builtMcpEntrypoint = path.resolve(__dirname, "..", "..", "dist", "mcp", "index.js");
8
+ const itWhenBuiltEntrypointExists = fs.existsSync(builtMcpEntrypoint) ? it : it.skip;
9
+
10
+ describe("SwallowKit MCP tool definitions", () => {
11
+ it("delegates inspect_project to the machine CLI", async () => {
12
+ const runner = jest.fn(async () => ({
13
+ stdout: JSON.stringify({
14
+ ok: true,
15
+ command: "inspect-project",
16
+ data: { manifestSource: "file" },
17
+ }),
18
+ stderr: "",
19
+ exitCode: 0,
20
+ }));
21
+
22
+ const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find((candidate) => candidate.name === "swallowkit_inspect_project");
23
+ expect(tool).toBeDefined();
24
+
25
+ const result = await tool!.handler({});
26
+ expect(runner).toHaveBeenCalledWith(["inspect", "project"]);
27
+ expect(JSON.parse(result.content[0].text)).toEqual({
28
+ manifestSource: "file",
29
+ metadata: { swallowkitVersion: expect.stringMatching(/^\d+\.\d+\.\d+/) },
30
+ });
31
+ });
32
+
33
+ it("includes the MCP version in validate_project metadata", async () => {
34
+ const runner = jest.fn(async () => ({
35
+ stdout: JSON.stringify({ ok: true, command: "validate-project", data: { valid: true } }),
36
+ stderr: "",
37
+ exitCode: 0,
38
+ }));
39
+ const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find(
40
+ (candidate) => candidate.name === "swallowkit_validate_project"
41
+ );
42
+
43
+ const result = await tool!.handler({});
44
+ expect(JSON.parse(result.content[0].text)).toEqual({
45
+ valid: true,
46
+ metadata: { swallowkitVersion: expect.stringMatching(/^\d+\.\d+\.\d+/) },
47
+ });
48
+ });
49
+
50
+ it("delegates scaffold_model with explicit args", async () => {
51
+ const runner = jest.fn(async () => ({
52
+ stdout: JSON.stringify({
53
+ ok: true,
54
+ command: "generate-scaffold",
55
+ data: { createdFiles: ["functions/src/todo.ts"] },
56
+ }),
57
+ stderr: "",
58
+ exitCode: 0,
59
+ }));
60
+
61
+ const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find((candidate) => candidate.name === "swallowkit_scaffold_model");
62
+ expect(tool).toBeDefined();
63
+
64
+ const result = await tool!.handler({
65
+ model: "todo",
66
+ functionsDir: "functions",
67
+ apiDir: "app/api",
68
+ apiOnly: true,
69
+ });
70
+
71
+ expect(runner).toHaveBeenCalledWith([
72
+ "generate",
73
+ "scaffold",
74
+ "todo",
75
+ "--functions-dir",
76
+ "functions",
77
+ "--api-dir",
78
+ "app/api",
79
+ "--api-only",
80
+ ]);
81
+ expect(JSON.parse(result.content[0].text)).toEqual({ createdFiles: ["functions/src/todo.ts"] });
82
+ });
83
+
84
+ it("exposes the agent-loop tools (plan/apply/artifacts/drift/verify/explain)", () => {
85
+ const names = buildSwallowKitToolDefinitions(jest.fn() as unknown as MachineCliRunner).map((tool) => tool.name);
86
+ expect(names).toEqual(
87
+ expect.arrayContaining([
88
+ "swallowkit_plan_scaffold",
89
+ "swallowkit_apply_scaffold",
90
+ "swallowkit_inspect_artifacts",
91
+ "swallowkit_inspect_drift",
92
+ "swallowkit_verify_project",
93
+ "swallowkit_explain_failure",
94
+ ])
95
+ );
96
+ });
97
+
98
+ it("delegates plan_scaffold and passes through status and nextActions", async () => {
99
+ const runner = jest.fn(async () => ({
100
+ stdout: JSON.stringify({
101
+ ok: true,
102
+ command: "plan-scaffold",
103
+ status: "requires-human",
104
+ nextActions: [{ command: "swallowkit machine apply scaffold --plan abc --approve", description: "Apply." }],
105
+ data: { planId: "abc", requiresApproval: true, operations: [] },
106
+ }),
107
+ stderr: "",
108
+ exitCode: 0,
109
+ }));
110
+
111
+ const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find(
112
+ (candidate) => candidate.name === "swallowkit_plan_scaffold"
113
+ );
114
+ const result = await tool!.handler({ model: "todo", apiOnly: true });
115
+
116
+ expect(runner).toHaveBeenCalledWith(["plan", "scaffold", "todo", "--api-only"]);
117
+ const parsed = JSON.parse(result.content[0].text);
118
+ expect(parsed.status).toBe("requires-human");
119
+ expect(parsed.planId).toBe("abc");
120
+ expect(parsed.nextActions).toHaveLength(1);
121
+ });
122
+
123
+ it("delegates apply_scaffold with plan and approve flags", async () => {
124
+ const runner = jest.fn(async () => ({
125
+ stdout: JSON.stringify({
126
+ ok: true,
127
+ command: "apply-scaffold",
128
+ status: "complete",
129
+ data: { createdFiles: [] },
130
+ }),
131
+ stderr: "",
132
+ exitCode: 0,
133
+ }));
134
+
135
+ const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find(
136
+ (candidate) => candidate.name === "swallowkit_apply_scaffold"
137
+ );
138
+ await tool!.handler({ planId: "abc", approve: true });
139
+
140
+ expect(runner).toHaveBeenCalledWith(["apply", "scaffold", "--plan", "abc", "--approve"]);
141
+ });
142
+
143
+ it("surfaces machine error code, status, and details to the agent", async () => {
144
+ const runner = jest.fn(async () => ({
145
+ stdout: JSON.stringify({
146
+ ok: false,
147
+ command: "apply-scaffold",
148
+ status: "blocked",
149
+ error: {
150
+ code: "stale-plan",
151
+ message: "Plan is stale.",
152
+ details: { changedFiles: ["shared/models/todo.ts"] },
153
+ },
154
+ }),
155
+ stderr: "",
156
+ exitCode: 1,
157
+ }));
158
+
159
+ const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find(
160
+ (candidate) => candidate.name === "swallowkit_apply_scaffold"
161
+ );
162
+
163
+ await expect(tool!.handler({ planId: "abc" })).rejects.toThrow(
164
+ /\[stale-plan\] Plan is stale\. \(status: blocked\)[\s\S]*changedFiles/
165
+ );
166
+ });
167
+
168
+ it("delegates verify_project with selected checks", async () => {
169
+ const runner = jest.fn(async () => ({
170
+ stdout: JSON.stringify({
171
+ ok: true,
172
+ command: "verify-project",
173
+ status: "complete",
174
+ data: { summary: { done: true } },
175
+ }),
176
+ stderr: "",
177
+ exitCode: 0,
178
+ }));
179
+
180
+ const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find(
181
+ (candidate) => candidate.name === "swallowkit_verify_project"
182
+ );
183
+ await tool!.handler({ checks: ["structure", "drift"] });
184
+
185
+ expect(runner).toHaveBeenCalledWith(["verify", "project", "--checks", "structure,drift"]);
186
+ });
187
+
188
+ itWhenBuiltEntrypointExists("keeps the built MCP entrypoint alive long enough to complete the handshake", async () => {
189
+ await new Promise<void>((resolve, reject) => {
190
+ const child = spawn(process.execPath, [builtMcpEntrypoint], {
191
+ cwd: path.resolve(__dirname, "..", ".."),
192
+ stdio: ["pipe", "pipe", "pipe"],
193
+ });
194
+ let settled = false;
195
+ let expectedShutdown = false;
196
+ let stderr = "";
197
+
198
+ const finishResolve = () => {
199
+ if (!settled) {
200
+ settled = true;
201
+ resolve();
202
+ }
203
+ };
204
+
205
+ const finishReject = (error: Error) => {
206
+ if (!settled) {
207
+ settled = true;
208
+ reject(error);
209
+ }
210
+ };
211
+
212
+ let timer: NodeJS.Timeout | undefined;
213
+
214
+ child.stderr.on("data", (chunk) => {
215
+ stderr += chunk.toString();
216
+ // Start the aliveness window once the entrypoint has actually booted.
217
+ if (!timer && /\[swallowkit-mcp\] version: /.test(stderr)) {
218
+ timer = setTimeout(() => {
219
+ expectedShutdown = true;
220
+ child.kill();
221
+ }, 1000);
222
+ }
223
+ });
224
+
225
+ child.on("error", (error) => {
226
+ clearTimeout(timer);
227
+ finishReject(error);
228
+ });
229
+
230
+ child.on("close", (code, signal) => {
231
+ clearTimeout(timer);
232
+
233
+ if (expectedShutdown) {
234
+ expect(stderr).toMatch(/\[swallowkit-mcp\] version: \d+\.\d+\.\d+/);
235
+ finishResolve();
236
+ return;
237
+ }
238
+
239
+ finishReject(
240
+ new Error(
241
+ `Built MCP entrypoint exited early with code ${code ?? "null"} and signal ${signal ?? "null"}${stderr ? `: ${stderr}` : ""}`
242
+ )
243
+ );
244
+ });
245
+ });
246
+ }, 20000);
247
+
248
+ itWhenBuiltEntrypointExists("preserves a runtime dynamic execa import in the built MCP entrypoint", () => {
249
+ const source = fs.readFileSync(builtMcpEntrypoint, "utf8");
250
+ expect(source).toContain('new Function("specifier", "return import(specifier);")');
251
+ expect(source).not.toContain('require("execa")');
252
+ });
253
+ });