Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as opaque submodule gitlinks on GitHub) into fully-tracked first-party content. AITM now merges its 7 vendored repos as first-party engines: - memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts - git: vendored C git (bundled binary) + gitnexus (in-process code intelligence) - agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess) Includes the full session's product build: Gitgram web/mobile/backend features, AITM website/CLI/MCP, the unified memory layer, engine build tooling (scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md), and extensive test suites. Build artifacts, node_modules, external/, and gemini-cli are gitignored. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
243 lines
7.0 KiB
TypeScript
243 lines
7.0 KiB
TypeScript
/**
|
|
* Unit test: Java Spring @RequestMapping / @GetMapping route extraction
|
|
* via the dedicated `route-extractors/spring.ts` module.
|
|
*
|
|
* Tests the extractSpringRoutes function directly (no worker pool needed)
|
|
* and validates per-class prefix resolution, multi-class handling, and
|
|
* all HTTP method annotations.
|
|
*/
|
|
import { describe, it, expect } from 'vitest';
|
|
import Parser from 'tree-sitter';
|
|
import Java from 'tree-sitter-java';
|
|
import { extractSpringRoutes } from '../../src/core/ingestion/route-extractors/spring.js';
|
|
|
|
function parse(code: string): Parser.Tree {
|
|
const parser = new Parser();
|
|
parser.setLanguage(Java);
|
|
return parser.parse(code);
|
|
}
|
|
|
|
describe('extractSpringRoutes', () => {
|
|
it('extracts method-level routes with class-level @RequestMapping prefix', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
@RequestMapping("/api/users")
|
|
public class UserController {
|
|
@GetMapping("/list")
|
|
public List<User> listUsers() { return null; }
|
|
|
|
@PostMapping("/create")
|
|
public User createUser() { return null; }
|
|
|
|
@DeleteMapping(path = "/delete")
|
|
public void deleteUser() {}
|
|
|
|
@PutMapping(value = "/update")
|
|
public void updateUser() {}
|
|
|
|
@PatchMapping("/patch")
|
|
public void patchUser() {}
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'UserController.java');
|
|
expect(routes).toHaveLength(5);
|
|
|
|
const byMethod = new Map(routes.map((r) => [r.httpMethod, r]));
|
|
|
|
expect(byMethod.get('GET')!.routePath).toBe('/list');
|
|
expect(byMethod.get('GET')!.prefix).toBe('/api/users');
|
|
|
|
expect(byMethod.get('POST')!.routePath).toBe('/create');
|
|
expect(byMethod.get('POST')!.prefix).toBe('/api/users');
|
|
|
|
expect(byMethod.get('DELETE')!.routePath).toBe('/delete');
|
|
expect(byMethod.get('DELETE')!.prefix).toBe('/api/users');
|
|
|
|
expect(byMethod.get('PUT')!.routePath).toBe('/update');
|
|
expect(byMethod.get('PUT')!.prefix).toBe('/api/users');
|
|
|
|
expect(byMethod.get('PATCH')!.routePath).toBe('/patch');
|
|
expect(byMethod.get('PATCH')!.prefix).toBe('/api/users');
|
|
});
|
|
|
|
it('emits bare routes when no class-level @RequestMapping exists', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
public class HealthController {
|
|
@GetMapping("/health")
|
|
public String health() { return "OK"; }
|
|
|
|
@GetMapping("/ready")
|
|
public String ready() { return "OK"; }
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'HealthController.java');
|
|
expect(routes).toHaveLength(2);
|
|
for (const route of routes) {
|
|
expect(route.prefix).toBeUndefined();
|
|
}
|
|
const paths = routes.map((r) => r.routePath).sort();
|
|
expect(paths).toEqual(['/health', '/ready']);
|
|
});
|
|
|
|
it('does NOT emit class-level @RequestMapping as a standalone Route', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
@RequestMapping("/api/users")
|
|
public class UserController {
|
|
@GetMapping("/list")
|
|
public List<User> listUsers() { return null; }
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'UserController.java');
|
|
// Only the method-level route, not the class-level prefix
|
|
expect(routes).toHaveLength(1);
|
|
expect(routes[0].decoratorName).toBe('GetMapping');
|
|
});
|
|
|
|
it('handles multiple classes in one file with independent prefixes', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
@RequestMapping("/api/admin")
|
|
class AdminController {
|
|
@GetMapping("/dashboard")
|
|
public String dashboard() { return "admin"; }
|
|
}
|
|
|
|
@RestController
|
|
@RequestMapping("/api/public")
|
|
class PublicController {
|
|
@GetMapping("/info")
|
|
public String info() { return "public"; }
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'MultiController.java');
|
|
expect(routes).toHaveLength(2);
|
|
|
|
const adminRoute = routes.find((r) => r.routePath === '/dashboard');
|
|
expect(adminRoute).toBeDefined();
|
|
expect(adminRoute!.prefix).toBe('/api/admin');
|
|
|
|
const publicRoute = routes.find((r) => r.routePath === '/info');
|
|
expect(publicRoute).toBeDefined();
|
|
expect(publicRoute!.prefix).toBe('/api/public');
|
|
});
|
|
|
|
it('supports @PatchMapping (previously missing)', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
@RequestMapping("/api")
|
|
public class PatchController {
|
|
@PatchMapping("/update")
|
|
public void patch() {}
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'PatchController.java');
|
|
expect(routes).toHaveLength(1);
|
|
expect(routes[0].httpMethod).toBe('PATCH');
|
|
expect(routes[0].routePath).toBe('/update');
|
|
expect(routes[0].prefix).toBe('/api');
|
|
});
|
|
|
|
it('handles named annotation arguments with path= and value=', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
@RequestMapping(value = "/api/v2")
|
|
public class V2Controller {
|
|
@GetMapping(path = "/items")
|
|
public String items() { return "[]"; }
|
|
|
|
@PostMapping(value = "/items")
|
|
public String createItem() { return "{}"; }
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'V2Controller.java');
|
|
expect(routes).toHaveLength(2);
|
|
for (const route of routes) {
|
|
expect(route.prefix).toBe('/api/v2');
|
|
expect(route.routePath).toBe('/items');
|
|
}
|
|
});
|
|
|
|
it('ignores non-route named args like produces/consumes', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
@RequestMapping("/api")
|
|
public class MediaController {
|
|
@GetMapping(value = "/json", produces = "application/json")
|
|
public String json() { return "{}"; }
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'MediaController.java');
|
|
// Should only extract the route path, not the produces value
|
|
expect(routes).toHaveLength(1);
|
|
expect(routes[0].routePath).toBe('/json');
|
|
expect(routes[0].prefix).toBe('/api');
|
|
});
|
|
|
|
it('does not bleed prefix across unrelated classes', () => {
|
|
const tree = parse(`
|
|
@RestController
|
|
@RequestMapping("/api/v1")
|
|
class V1Controller {
|
|
@GetMapping("/old")
|
|
public String old() { return "v1"; }
|
|
}
|
|
|
|
@RestController
|
|
class NoPrefix {
|
|
@GetMapping("/bare")
|
|
public String bare() { return "no prefix"; }
|
|
}
|
|
|
|
@RestController
|
|
@RequestMapping("/api/v3")
|
|
class V3Controller {
|
|
@GetMapping("/new")
|
|
public String newer() { return "v3"; }
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'Multi.java');
|
|
expect(routes).toHaveLength(3);
|
|
|
|
const v1 = routes.find((r) => r.routePath === '/old');
|
|
expect(v1!.prefix).toBe('/api/v1');
|
|
|
|
const bare = routes.find((r) => r.routePath === '/bare');
|
|
expect(bare!.prefix).toBeUndefined();
|
|
|
|
const v3 = routes.find((r) => r.routePath === '/new');
|
|
expect(v3!.prefix).toBe('/api/v3');
|
|
});
|
|
|
|
it('reports correct line numbers', () => {
|
|
const tree = parse(`@RestController
|
|
@RequestMapping("/api")
|
|
public class LineTest {
|
|
@GetMapping("/first")
|
|
public String first() { return "1"; }
|
|
|
|
@PostMapping("/second")
|
|
public String second() { return "2"; }
|
|
}
|
|
`);
|
|
|
|
const routes = extractSpringRoutes(tree, 'LineTest.java');
|
|
expect(routes).toHaveLength(2);
|
|
// @GetMapping is on line index 3 (0-based)
|
|
const first = routes.find((r) => r.routePath === '/first');
|
|
expect(first!.lineNumber).toBe(3);
|
|
// @PostMapping is on line index 6
|
|
const second = routes.find((r) => r.routePath === '/second');
|
|
expect(second!.lineNumber).toBe(6);
|
|
});
|
|
});
|