This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
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>
2026-06-23 14:14:09 +03:00

262 lines
9.2 KiB
TypeScript

/**
* Integration Tests: Knowledge Base Routes
*
* Tests the /v1/knowledge-base endpoints:
* - GET /v1/knowledge-base/files - List KB files
* - GET /v1/knowledge-base/files/search - Search KB files
* - GET /v1/knowledge-base/artifacts - List artifacts
* - GET /v1/knowledge-base/artifacts/:id - Get artifact by ID
* - GET /v1/knowledge-base/search - Search across files
* - GET /v1/knowledge-base/stats - Storage statistics
* - GET /v1/knowledge-base/embeddings/status - Embedding coverage
* - GET /v1/knowledge-base/unified-search - Unified search
*/
import { describe, it, expect, beforeAll, beforeEach } from "vitest";
import request from "supertest";
import type { Express } from "express";
import {
seedTestData,
createTestApp,
TEST_API_KEY,
mockKnowledgeBaseFiles,
mockKnowledgeBaseArtifacts,
} from "../setup.js";
let app: Express;
beforeAll(async () => {
app = await createTestApp();
});
beforeEach(() => {
seedTestData();
});
describe("Knowledge Base Routes - /v1/knowledge-base", () => {
// ========================================================================
// GET /v1/knowledge-base/files - List files
// ========================================================================
describe("GET /v1/knowledge-base/files", () => {
it("should require authentication", async () => {
const res = await request(app).get("/v1/knowledge-base/files");
expect(res.status).toBe(401);
});
it("should return a list of KB files", async () => {
const res = await request(app)
.get("/v1/knowledge-base/files")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("files");
expect(Array.isArray(res.body.files)).toBe(true);
expect(res.body).toHaveProperty("total");
expect(res.body).toHaveProperty("limit");
expect(res.body).toHaveProperty("offset");
});
it("should support pagination parameters", async () => {
const res = await request(app)
.get("/v1/knowledge-base/files")
.query({ limit: 10, offset: 0 })
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body.limit).toBe(10);
expect(res.body.offset).toBe(0);
});
});
// ========================================================================
// GET /v1/knowledge-base/files/search - Search files
// ========================================================================
describe("GET /v1/knowledge-base/files/search", () => {
it("should require authentication", async () => {
const res = await request(app)
.get("/v1/knowledge-base/files/search")
.query({ q: "test" });
expect(res.status).toBe(401);
});
it("should return 400 when query is missing", async () => {
const res = await request(app)
.get("/v1/knowledge-base/files/search")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(400);
expect(res.body).toHaveProperty("error");
});
it("should search files with a valid query", async () => {
const res = await request(app)
.get("/v1/knowledge-base/files/search")
.query({ q: "index" })
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("query", "index");
expect(res.body).toHaveProperty("results");
expect(res.body).toHaveProperty("total");
});
});
// ========================================================================
// GET /v1/knowledge-base/artifacts - List artifacts
// ========================================================================
describe("GET /v1/knowledge-base/artifacts", () => {
it("should require authentication", async () => {
const res = await request(app).get("/v1/knowledge-base/artifacts");
expect(res.status).toBe(401);
});
it("should return a list of artifacts", async () => {
const res = await request(app)
.get("/v1/knowledge-base/artifacts")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("artifacts");
expect(Array.isArray(res.body.artifacts)).toBe(true);
expect(res.body).toHaveProperty("total");
expect(res.body).toHaveProperty("limit");
expect(res.body).toHaveProperty("offset");
});
});
// ========================================================================
// GET /v1/knowledge-base/artifacts/:id - Get artifact by ID
// ========================================================================
describe("GET /v1/knowledge-base/artifacts/:id", () => {
it("should require authentication", async () => {
const res = await request(app).get("/v1/knowledge-base/artifacts/art_001");
expect(res.status).toBe(401);
});
it("should return 404 for a non-existent artifact", async () => {
const res = await request(app)
.get("/v1/knowledge-base/artifacts/art_nonexistent")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(404);
});
});
// ========================================================================
// GET /v1/knowledge-base/search - Search KB
// ========================================================================
describe("GET /v1/knowledge-base/search", () => {
it("should require authentication", async () => {
const res = await request(app)
.get("/v1/knowledge-base/search")
.query({ query: "test" });
expect(res.status).toBe(401);
});
it("should return 400 when query is missing", async () => {
const res = await request(app)
.get("/v1/knowledge-base/search")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(400);
expect(res.body).toHaveProperty("error");
});
it("should return search results", async () => {
const res = await request(app)
.get("/v1/knowledge-base/search")
.query({ query: "function" })
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("query", "function");
expect(res.body).toHaveProperty("results");
expect(res.body).toHaveProperty("total");
});
});
// ========================================================================
// GET /v1/knowledge-base/stats - Storage statistics
// ========================================================================
describe("GET /v1/knowledge-base/stats", () => {
it("should require authentication", async () => {
const res = await request(app).get("/v1/knowledge-base/stats");
expect(res.status).toBe(401);
});
it("should return storage statistics", async () => {
const res = await request(app)
.get("/v1/knowledge-base/stats")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
// stats response shape depends on getKnowledgeStats service
});
});
// ========================================================================
// GET /v1/knowledge-base/embeddings/status - Embedding coverage
// ========================================================================
describe("GET /v1/knowledge-base/embeddings/status", () => {
it("should require authentication", async () => {
const res = await request(app).get("/v1/knowledge-base/embeddings/status");
expect(res.status).toBe(401);
});
it("should return embedding status", async () => {
const res = await request(app)
.get("/v1/knowledge-base/embeddings/status")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("files");
expect(res.body).toHaveProperty("artifacts");
expect(res.body).toHaveProperty("overall");
expect(res.body.overall).toHaveProperty("coverage");
expect(res.body.overall).toHaveProperty("meets_threshold");
});
});
// ========================================================================
// GET /v1/knowledge-base/unified-search - Unified search
// ========================================================================
describe("GET /v1/knowledge-base/unified-search", () => {
it("should require authentication", async () => {
const res = await request(app)
.get("/v1/knowledge-base/unified-search")
.query({ query: "test" });
expect(res.status).toBe(401);
});
it("should return 400 when query is missing", async () => {
const res = await request(app)
.get("/v1/knowledge-base/unified-search")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(400);
expect(res.body).toHaveProperty("error");
});
it("should return unified search results", async () => {
const res = await request(app)
.get("/v1/knowledge-base/unified-search")
.query({ query: "test" })
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("query", "test");
expect(res.body).toHaveProperty("files");
expect(res.body).toHaveProperty("artifacts");
expect(res.body).toHaveProperty("embeddings");
expect(res.body).toHaveProperty("total");
});
});
});