briefed 0.1.0
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.
- package/LICENSE +21 -0
- package/README.md +118 -0
- package/dist/bench/metrics.d.ts +31 -0
- package/dist/bench/metrics.js +122 -0
- package/dist/bench/metrics.js.map +1 -0
- package/dist/bench/runner.d.ts +27 -0
- package/dist/bench/runner.js +184 -0
- package/dist/bench/runner.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +42 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/bench.d.ts +11 -0
- package/dist/commands/bench.js +23 -0
- package/dist/commands/bench.js.map +1 -0
- package/dist/commands/doctor.d.ts +5 -0
- package/dist/commands/doctor.js +246 -0
- package/dist/commands/doctor.js.map +1 -0
- package/dist/commands/init.d.ts +8 -0
- package/dist/commands/init.js +319 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/stats.d.ts +5 -0
- package/dist/commands/stats.js +87 -0
- package/dist/commands/stats.js.map +1 -0
- package/dist/deliver/ci.d.ts +4 -0
- package/dist/deliver/ci.js +62 -0
- package/dist/deliver/ci.js.map +1 -0
- package/dist/deliver/claudemd.d.ts +9 -0
- package/dist/deliver/claudemd.js +51 -0
- package/dist/deliver/claudemd.js.map +1 -0
- package/dist/deliver/cross-tool.d.ts +10 -0
- package/dist/deliver/cross-tool.js +49 -0
- package/dist/deliver/cross-tool.js.map +1 -0
- package/dist/deliver/git-hook.d.ts +10 -0
- package/dist/deliver/git-hook.js +104 -0
- package/dist/deliver/git-hook.js.map +1 -0
- package/dist/deliver/hooks.d.ts +9 -0
- package/dist/deliver/hooks.js +315 -0
- package/dist/deliver/hooks.js.map +1 -0
- package/dist/extract/complexity.d.ts +16 -0
- package/dist/extract/complexity.js +46 -0
- package/dist/extract/complexity.js.map +1 -0
- package/dist/extract/conventions.d.ts +18 -0
- package/dist/extract/conventions.js +143 -0
- package/dist/extract/conventions.js.map +1 -0
- package/dist/extract/depgraph.d.ts +12 -0
- package/dist/extract/depgraph.js +70 -0
- package/dist/extract/depgraph.js.map +1 -0
- package/dist/extract/env.d.ts +17 -0
- package/dist/extract/env.js +142 -0
- package/dist/extract/env.js.map +1 -0
- package/dist/extract/error-patterns.d.ts +15 -0
- package/dist/extract/error-patterns.js +107 -0
- package/dist/extract/error-patterns.js.map +1 -0
- package/dist/extract/frontend.d.ts +30 -0
- package/dist/extract/frontend.js +244 -0
- package/dist/extract/frontend.js.map +1 -0
- package/dist/extract/gotchas.d.ts +12 -0
- package/dist/extract/gotchas.js +145 -0
- package/dist/extract/gotchas.js.map +1 -0
- package/dist/extract/history.d.ts +29 -0
- package/dist/extract/history.js +91 -0
- package/dist/extract/history.js.map +1 -0
- package/dist/extract/infra.d.ts +27 -0
- package/dist/extract/infra.js +226 -0
- package/dist/extract/infra.js.map +1 -0
- package/dist/extract/monorepo.d.ts +16 -0
- package/dist/extract/monorepo.js +135 -0
- package/dist/extract/monorepo.js.map +1 -0
- package/dist/extract/routes.d.ts +16 -0
- package/dist/extract/routes.js +156 -0
- package/dist/extract/routes.js.map +1 -0
- package/dist/extract/scanner.d.ts +18 -0
- package/dist/extract/scanner.js +109 -0
- package/dist/extract/scanner.js.map +1 -0
- package/dist/extract/schema.d.ts +28 -0
- package/dist/extract/schema.js +192 -0
- package/dist/extract/schema.js.map +1 -0
- package/dist/extract/scripts.d.ts +18 -0
- package/dist/extract/scripts.js +104 -0
- package/dist/extract/scripts.js.map +1 -0
- package/dist/extract/security.d.ts +20 -0
- package/dist/extract/security.js +95 -0
- package/dist/extract/security.js.map +1 -0
- package/dist/extract/signatures.d.ts +33 -0
- package/dist/extract/signatures.js +608 -0
- package/dist/extract/signatures.js.map +1 -0
- package/dist/extract/staleness.d.ts +16 -0
- package/dist/extract/staleness.js +108 -0
- package/dist/extract/staleness.js.map +1 -0
- package/dist/extract/tests.d.ts +16 -0
- package/dist/extract/tests.js +175 -0
- package/dist/extract/tests.js.map +1 -0
- package/dist/extract/usage-examples.d.ts +17 -0
- package/dist/extract/usage-examples.js +115 -0
- package/dist/extract/usage-examples.js.map +1 -0
- package/dist/generate/index-file.d.ts +29 -0
- package/dist/generate/index-file.js +168 -0
- package/dist/generate/index-file.js.map +1 -0
- package/dist/generate/rules.d.ts +6 -0
- package/dist/generate/rules.js +94 -0
- package/dist/generate/rules.js.map +1 -0
- package/dist/generate/skeleton.d.ts +14 -0
- package/dist/generate/skeleton.js +145 -0
- package/dist/generate/skeleton.js.map +1 -0
- package/dist/learn/tracker.d.ts +54 -0
- package/dist/learn/tracker.js +129 -0
- package/dist/learn/tracker.js.map +1 -0
- package/dist/utils/detect.d.ts +16 -0
- package/dist/utils/detect.js +188 -0
- package/dist/utils/detect.js.map +1 -0
- package/dist/utils/pagerank.d.ts +19 -0
- package/dist/utils/pagerank.js +52 -0
- package/dist/utils/pagerank.js.map +1 -0
- package/dist/utils/tokens.d.ts +11 -0
- package/dist/utils/tokens.js +27 -0
- package/dist/utils/tokens.js.map +1 -0
- package/package.json +43 -0
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from "fs";
|
|
2
|
+
import { join, relative, resolve } from "path";
|
|
3
|
+
import { glob } from "glob";
|
|
4
|
+
/**
|
|
5
|
+
* Detect if we're in a monorepo and identify packages.
|
|
6
|
+
* Supports: npm workspaces, pnpm workspaces, yarn workspaces, turborepo, nx, lerna.
|
|
7
|
+
*/
|
|
8
|
+
export function detectMonorepo(cwd) {
|
|
9
|
+
const info = {
|
|
10
|
+
isMonorepo: false,
|
|
11
|
+
root: cwd,
|
|
12
|
+
packages: [],
|
|
13
|
+
currentPackage: null,
|
|
14
|
+
};
|
|
15
|
+
// Walk up to find monorepo root
|
|
16
|
+
let searchDir = resolve(cwd);
|
|
17
|
+
const visited = new Set();
|
|
18
|
+
while (searchDir && !visited.has(searchDir)) {
|
|
19
|
+
visited.add(searchDir);
|
|
20
|
+
const pkgPath = join(searchDir, "package.json");
|
|
21
|
+
if (existsSync(pkgPath)) {
|
|
22
|
+
try {
|
|
23
|
+
const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
|
|
24
|
+
// npm/yarn workspaces
|
|
25
|
+
if (pkg.workspaces) {
|
|
26
|
+
info.isMonorepo = true;
|
|
27
|
+
info.root = searchDir;
|
|
28
|
+
const patterns = Array.isArray(pkg.workspaces)
|
|
29
|
+
? pkg.workspaces
|
|
30
|
+
: pkg.workspaces.packages || [];
|
|
31
|
+
info.packages = resolveWorkspacePackages(searchDir, patterns);
|
|
32
|
+
break;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
catch { /* skip */ }
|
|
36
|
+
}
|
|
37
|
+
// pnpm workspaces
|
|
38
|
+
const pnpmPath = join(searchDir, "pnpm-workspace.yaml");
|
|
39
|
+
if (existsSync(pnpmPath)) {
|
|
40
|
+
info.isMonorepo = true;
|
|
41
|
+
info.root = searchDir;
|
|
42
|
+
const content = readFileSync(pnpmPath, "utf-8");
|
|
43
|
+
const match = content.match(/packages:\s*\n([\s\S]*?)(?:\n\S|$)/);
|
|
44
|
+
if (match) {
|
|
45
|
+
const patterns = match[1]
|
|
46
|
+
.split("\n")
|
|
47
|
+
.map((l) => l.trim().replace(/^-\s*['"]?/, "").replace(/['"]?\s*$/, ""))
|
|
48
|
+
.filter(Boolean);
|
|
49
|
+
info.packages = resolveWorkspacePackages(searchDir, patterns);
|
|
50
|
+
}
|
|
51
|
+
break;
|
|
52
|
+
}
|
|
53
|
+
// Turborepo
|
|
54
|
+
if (existsSync(join(searchDir, "turbo.json"))) {
|
|
55
|
+
info.isMonorepo = true;
|
|
56
|
+
info.root = searchDir;
|
|
57
|
+
// turbo uses package.json workspaces, already handled above
|
|
58
|
+
break;
|
|
59
|
+
}
|
|
60
|
+
// Go modules workspace
|
|
61
|
+
if (existsSync(join(searchDir, "go.work"))) {
|
|
62
|
+
info.isMonorepo = true;
|
|
63
|
+
info.root = searchDir;
|
|
64
|
+
const content = readFileSync(join(searchDir, "go.work"), "utf-8");
|
|
65
|
+
const useMatch = content.match(/use\s*\(([\s\S]*?)\)/);
|
|
66
|
+
if (useMatch) {
|
|
67
|
+
const dirs = useMatch[1].split("\n").map((l) => l.trim()).filter(Boolean);
|
|
68
|
+
info.packages = dirs.map((d) => ({
|
|
69
|
+
name: d.split("/").pop(),
|
|
70
|
+
path: d,
|
|
71
|
+
absolutePath: join(searchDir, d),
|
|
72
|
+
}));
|
|
73
|
+
}
|
|
74
|
+
break;
|
|
75
|
+
}
|
|
76
|
+
// Cargo workspace
|
|
77
|
+
if (existsSync(join(searchDir, "Cargo.toml"))) {
|
|
78
|
+
try {
|
|
79
|
+
const content = readFileSync(join(searchDir, "Cargo.toml"), "utf-8");
|
|
80
|
+
if (content.includes("[workspace]")) {
|
|
81
|
+
info.isMonorepo = true;
|
|
82
|
+
info.root = searchDir;
|
|
83
|
+
const membersMatch = content.match(/members\s*=\s*\[([\s\S]*?)\]/);
|
|
84
|
+
if (membersMatch) {
|
|
85
|
+
const patterns = membersMatch[1]
|
|
86
|
+
.split(",")
|
|
87
|
+
.map((s) => s.trim().replace(/['"]/g, ""))
|
|
88
|
+
.filter(Boolean);
|
|
89
|
+
info.packages = resolveWorkspacePackages(searchDir, patterns);
|
|
90
|
+
}
|
|
91
|
+
break;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
catch { /* skip */ }
|
|
95
|
+
}
|
|
96
|
+
// Move up one directory
|
|
97
|
+
const parent = join(searchDir, "..");
|
|
98
|
+
if (resolve(parent) === resolve(searchDir))
|
|
99
|
+
break;
|
|
100
|
+
searchDir = resolve(parent);
|
|
101
|
+
}
|
|
102
|
+
// Determine current package
|
|
103
|
+
if (info.isMonorepo && info.packages.length > 0) {
|
|
104
|
+
const cwdRel = relative(info.root, cwd).replace(/\\/g, "/");
|
|
105
|
+
info.currentPackage = info.packages.find((p) => cwdRel.startsWith(p.path) || cwdRel === p.path) || null;
|
|
106
|
+
}
|
|
107
|
+
return info;
|
|
108
|
+
}
|
|
109
|
+
function resolveWorkspacePackages(root, patterns) {
|
|
110
|
+
const packages = [];
|
|
111
|
+
for (const pattern of patterns) {
|
|
112
|
+
try {
|
|
113
|
+
const dirs = glob.sync(pattern, { cwd: root });
|
|
114
|
+
for (const dir of dirs) {
|
|
115
|
+
const pkgJsonPath = join(root, dir, "package.json");
|
|
116
|
+
let name = dir.split("/").pop();
|
|
117
|
+
if (existsSync(pkgJsonPath)) {
|
|
118
|
+
try {
|
|
119
|
+
const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
|
|
120
|
+
name = pkg.name || name;
|
|
121
|
+
}
|
|
122
|
+
catch { /* use dir name */ }
|
|
123
|
+
}
|
|
124
|
+
packages.push({
|
|
125
|
+
name,
|
|
126
|
+
path: dir.replace(/\\/g, "/"),
|
|
127
|
+
absolutePath: join(root, dir),
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
catch { /* skip */ }
|
|
132
|
+
}
|
|
133
|
+
return packages;
|
|
134
|
+
}
|
|
135
|
+
//# sourceMappingURL=monorepo.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"monorepo.js","sourceRoot":"","sources":["../../src/extract/monorepo.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export interface Route {
|
|
2
|
+
method: string;
|
|
3
|
+
path: string;
|
|
4
|
+
handler: string;
|
|
5
|
+
file: string;
|
|
6
|
+
middleware: string[];
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* Extract API routes from the codebase.
|
|
10
|
+
* Supports: Express, Fastify, Next.js App Router, Next.js Pages API, FastAPI, Django, Hono.
|
|
11
|
+
*/
|
|
12
|
+
export declare function extractRoutes(root: string): Route[];
|
|
13
|
+
/**
|
|
14
|
+
* Format routes for skeleton inclusion.
|
|
15
|
+
*/
|
|
16
|
+
export declare function formatRoutes(routes: Route[]): string;
|
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
import { readFileSync } from "fs";
|
|
2
|
+
import { glob } from "glob";
|
|
3
|
+
import { join } from "path";
|
|
4
|
+
/**
|
|
5
|
+
* Extract API routes from the codebase.
|
|
6
|
+
* Supports: Express, Fastify, Next.js App Router, Next.js Pages API, FastAPI, Django, Hono.
|
|
7
|
+
*/
|
|
8
|
+
export function extractRoutes(root) {
|
|
9
|
+
const routes = [];
|
|
10
|
+
// Next.js App Router (src/app/**/route.ts)
|
|
11
|
+
const nextAppRoutes = glob.sync("**/route.{ts,tsx,js,jsx}", {
|
|
12
|
+
cwd: root,
|
|
13
|
+
ignore: ["node_modules/**", "dist/**", ".next/**"],
|
|
14
|
+
});
|
|
15
|
+
for (const f of nextAppRoutes) {
|
|
16
|
+
const content = readFileSync(join(root, f), "utf-8");
|
|
17
|
+
const path = "/" + f.replace(/\/route\.\w+$/, "").replace(/^(?:src\/)?app\//, "").replace(/\(.*?\)\//g, "");
|
|
18
|
+
for (const method of ["GET", "POST", "PUT", "PATCH", "DELETE"]) {
|
|
19
|
+
if (content.includes(`export async function ${method}`) || content.includes(`export function ${method}`)) {
|
|
20
|
+
routes.push({ method, path, handler: method, file: f, middleware: [] });
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
// Next.js Pages API (pages/api/**/*.ts)
|
|
25
|
+
const nextPagesRoutes = glob.sync("pages/api/**/*.{ts,tsx,js,jsx}", {
|
|
26
|
+
cwd: root,
|
|
27
|
+
ignore: ["node_modules/**"],
|
|
28
|
+
});
|
|
29
|
+
for (const f of nextPagesRoutes) {
|
|
30
|
+
const path = "/api/" + f.replace(/^pages\/api\//, "").replace(/\.\w+$/, "").replace(/\/index$/, "");
|
|
31
|
+
routes.push({ method: "ALL", path, handler: "default", file: f, middleware: [] });
|
|
32
|
+
}
|
|
33
|
+
// Express / Fastify routes
|
|
34
|
+
const jsFiles = glob.sync("**/*.{ts,js}", {
|
|
35
|
+
cwd: root,
|
|
36
|
+
ignore: ["node_modules/**", "dist/**", "test/**", "*.test.*", "*.spec.*"],
|
|
37
|
+
});
|
|
38
|
+
for (const f of jsFiles) {
|
|
39
|
+
let content;
|
|
40
|
+
try {
|
|
41
|
+
content = readFileSync(join(root, f), "utf-8");
|
|
42
|
+
}
|
|
43
|
+
catch {
|
|
44
|
+
continue;
|
|
45
|
+
}
|
|
46
|
+
// Express: app.get('/path', handler) or router.post('/path', ...middleware, handler)
|
|
47
|
+
const expressRegex = /(?:app|router|server)\.(get|post|put|patch|delete|all)\s*\(\s*['"]([^'"]+)['"]/gi;
|
|
48
|
+
for (const match of content.matchAll(expressRegex)) {
|
|
49
|
+
routes.push({
|
|
50
|
+
method: match[1].toUpperCase(),
|
|
51
|
+
path: match[2],
|
|
52
|
+
handler: f,
|
|
53
|
+
file: f,
|
|
54
|
+
middleware: extractMiddleware(content, match.index || 0),
|
|
55
|
+
});
|
|
56
|
+
}
|
|
57
|
+
// Fastify: fastify.get('/path', handler) or fastify.route({ method, url })
|
|
58
|
+
const fastifyRegex = /(?:fastify|app|server)\.(get|post|put|patch|delete)\s*\(\s*['"]([^'"]+)['"]/gi;
|
|
59
|
+
for (const match of content.matchAll(fastifyRegex)) {
|
|
60
|
+
if (routes.some((r) => r.method === match[1].toUpperCase() && r.path === match[2]))
|
|
61
|
+
continue;
|
|
62
|
+
routes.push({
|
|
63
|
+
method: match[1].toUpperCase(),
|
|
64
|
+
path: match[2],
|
|
65
|
+
handler: f,
|
|
66
|
+
file: f,
|
|
67
|
+
middleware: [],
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
// Hono: app.get('/path', handler)
|
|
71
|
+
const honoRegex = /\.(?:get|post|put|patch|delete)\s*\(\s*['"]([^'"]+)['"]/gi;
|
|
72
|
+
if (content.includes("from 'hono'") || content.includes("from \"hono\"")) {
|
|
73
|
+
for (const match of content.matchAll(honoRegex)) {
|
|
74
|
+
const methodMatch = match[0].match(/\.(get|post|put|patch|delete)/i);
|
|
75
|
+
if (methodMatch) {
|
|
76
|
+
routes.push({
|
|
77
|
+
method: methodMatch[1].toUpperCase(),
|
|
78
|
+
path: match[1],
|
|
79
|
+
handler: f,
|
|
80
|
+
file: f,
|
|
81
|
+
middleware: [],
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
// FastAPI (Python)
|
|
88
|
+
const pyFiles = glob.sync("**/*.py", {
|
|
89
|
+
cwd: root,
|
|
90
|
+
ignore: ["venv/**", ".venv/**", "__pycache__/**"],
|
|
91
|
+
});
|
|
92
|
+
for (const f of pyFiles) {
|
|
93
|
+
let content;
|
|
94
|
+
try {
|
|
95
|
+
content = readFileSync(join(root, f), "utf-8");
|
|
96
|
+
}
|
|
97
|
+
catch {
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
// FastAPI: @app.get("/path") or @router.post("/path")
|
|
101
|
+
const fastapiRegex = /@(?:app|router)\.(get|post|put|patch|delete)\s*\(\s*['"]([^'"]+)['"]/gi;
|
|
102
|
+
for (const match of content.matchAll(fastapiRegex)) {
|
|
103
|
+
routes.push({
|
|
104
|
+
method: match[1].toUpperCase(),
|
|
105
|
+
path: match[2],
|
|
106
|
+
handler: f,
|
|
107
|
+
file: f,
|
|
108
|
+
middleware: [],
|
|
109
|
+
});
|
|
110
|
+
}
|
|
111
|
+
// Django: path('url', view)
|
|
112
|
+
const djangoRegex = /path\s*\(\s*['"]([^'"]*)['"]\s*,\s*(\w+)/g;
|
|
113
|
+
for (const match of content.matchAll(djangoRegex)) {
|
|
114
|
+
routes.push({
|
|
115
|
+
method: "ALL",
|
|
116
|
+
path: "/" + match[1],
|
|
117
|
+
handler: match[2],
|
|
118
|
+
file: f,
|
|
119
|
+
middleware: [],
|
|
120
|
+
});
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
return routes;
|
|
124
|
+
}
|
|
125
|
+
function extractMiddleware(content, matchIndex) {
|
|
126
|
+
// Look for middleware names in the route definition
|
|
127
|
+
const after = content.slice(matchIndex, matchIndex + 300);
|
|
128
|
+
const mwMatch = after.match(/,\s*(\w+(?:Middleware|Auth|validate|check)\w*)/gi);
|
|
129
|
+
return mwMatch?.map((m) => m.replace(/^,\s*/, "")) || [];
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Format routes for skeleton inclusion.
|
|
133
|
+
*/
|
|
134
|
+
export function formatRoutes(routes) {
|
|
135
|
+
if (routes.length === 0)
|
|
136
|
+
return "";
|
|
137
|
+
const lines = ["API endpoints:"];
|
|
138
|
+
// Group by path prefix
|
|
139
|
+
const grouped = new Map();
|
|
140
|
+
for (const r of routes) {
|
|
141
|
+
const prefix = r.path.split("/").slice(0, 3).join("/");
|
|
142
|
+
if (!grouped.has(prefix))
|
|
143
|
+
grouped.set(prefix, []);
|
|
144
|
+
grouped.get(prefix).push(r);
|
|
145
|
+
}
|
|
146
|
+
for (const [prefix, group] of grouped) {
|
|
147
|
+
const methods = group.map((r) => r.method).join(", ");
|
|
148
|
+
const mw = group.flatMap((r) => r.middleware).filter(Boolean);
|
|
149
|
+
let line = ` ${methods} ${prefix}`;
|
|
150
|
+
if (mw.length > 0)
|
|
151
|
+
line += ` [${[...new Set(mw)].join(", ")}]`;
|
|
152
|
+
lines.push(line);
|
|
153
|
+
}
|
|
154
|
+
return lines.join("\n");
|
|
155
|
+
}
|
|
156
|
+
//# sourceMappingURL=routes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/extract/routes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export interface DiscoveredFile {
|
|
2
|
+
path: string;
|
|
3
|
+
absolutePath: string;
|
|
4
|
+
extension: string;
|
|
5
|
+
sizeBytes: number;
|
|
6
|
+
}
|
|
7
|
+
export interface ScanResult {
|
|
8
|
+
root: string;
|
|
9
|
+
files: DiscoveredFile[];
|
|
10
|
+
totalFiles: number;
|
|
11
|
+
totalBytes: number;
|
|
12
|
+
filesByExtension: Map<string, number>;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Discover all parseable source files in a project.
|
|
16
|
+
* Respects .gitignore patterns and skips known non-source directories.
|
|
17
|
+
*/
|
|
18
|
+
export declare function scanFiles(root: string): ScanResult;
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { readdirSync, statSync, readFileSync, existsSync } from "fs";
|
|
2
|
+
import { join, relative, extname } from "path";
|
|
3
|
+
import { PARSEABLE_EXTENSIONS, SKIP_DIRS } from "../utils/detect.js";
|
|
4
|
+
/**
|
|
5
|
+
* Discover all parseable source files in a project.
|
|
6
|
+
* Respects .gitignore patterns and skips known non-source directories.
|
|
7
|
+
*/
|
|
8
|
+
export function scanFiles(root) {
|
|
9
|
+
const files = [];
|
|
10
|
+
const filesByExtension = new Map();
|
|
11
|
+
// Load .gitignore + .briefedignore patterns
|
|
12
|
+
const ignorePatterns = [
|
|
13
|
+
...loadIgnoreFile(join(root, ".gitignore")),
|
|
14
|
+
...loadIgnoreFile(join(root, ".briefedignore")),
|
|
15
|
+
];
|
|
16
|
+
function walk(dir) {
|
|
17
|
+
let entries;
|
|
18
|
+
try {
|
|
19
|
+
entries = readdirSync(dir, { withFileTypes: true });
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
return; // Permission denied or other error
|
|
23
|
+
}
|
|
24
|
+
for (const entry of entries) {
|
|
25
|
+
const fullPath = join(dir, entry.name);
|
|
26
|
+
const relPath = relative(root, fullPath).replace(/\\/g, "/");
|
|
27
|
+
if (entry.isDirectory()) {
|
|
28
|
+
if (SKIP_DIRS.has(entry.name))
|
|
29
|
+
continue;
|
|
30
|
+
if (entry.name.startsWith(".") && entry.name !== ".")
|
|
31
|
+
continue;
|
|
32
|
+
if (isIgnored(relPath, ignorePatterns))
|
|
33
|
+
continue;
|
|
34
|
+
walk(fullPath);
|
|
35
|
+
}
|
|
36
|
+
else if (entry.isFile()) {
|
|
37
|
+
const ext = extname(entry.name);
|
|
38
|
+
if (!PARSEABLE_EXTENSIONS.has(ext))
|
|
39
|
+
continue;
|
|
40
|
+
if (isIgnored(relPath, ignorePatterns))
|
|
41
|
+
continue;
|
|
42
|
+
let size;
|
|
43
|
+
try {
|
|
44
|
+
size = statSync(fullPath).size;
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
continue;
|
|
48
|
+
}
|
|
49
|
+
// Skip very large files (>500KB — likely generated)
|
|
50
|
+
if (size > 500_000)
|
|
51
|
+
continue;
|
|
52
|
+
files.push({
|
|
53
|
+
path: relPath,
|
|
54
|
+
absolutePath: fullPath,
|
|
55
|
+
extension: ext,
|
|
56
|
+
sizeBytes: size,
|
|
57
|
+
});
|
|
58
|
+
filesByExtension.set(ext, (filesByExtension.get(ext) || 0) + 1);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
walk(root);
|
|
63
|
+
return {
|
|
64
|
+
root,
|
|
65
|
+
files,
|
|
66
|
+
totalFiles: files.length,
|
|
67
|
+
totalBytes: files.reduce((sum, f) => sum + f.sizeBytes, 0),
|
|
68
|
+
filesByExtension,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
function loadIgnoreFile(filePath) {
|
|
72
|
+
if (!existsSync(filePath))
|
|
73
|
+
return [];
|
|
74
|
+
const content = readFileSync(filePath, "utf-8");
|
|
75
|
+
return content
|
|
76
|
+
.split("\n")
|
|
77
|
+
.map((line) => line.trim())
|
|
78
|
+
.filter((line) => line && !line.startsWith("#"));
|
|
79
|
+
}
|
|
80
|
+
function isIgnored(relPath, patterns) {
|
|
81
|
+
for (const pattern of patterns) {
|
|
82
|
+
// Simple pattern matching — covers most .gitignore patterns
|
|
83
|
+
if (pattern.endsWith("/")) {
|
|
84
|
+
// Directory pattern
|
|
85
|
+
const dir = pattern.slice(0, -1);
|
|
86
|
+
if (relPath.startsWith(dir + "/") || relPath === dir)
|
|
87
|
+
return true;
|
|
88
|
+
}
|
|
89
|
+
else if (pattern.startsWith("*")) {
|
|
90
|
+
// Wildcard suffix
|
|
91
|
+
const suffix = pattern.slice(1);
|
|
92
|
+
if (relPath.endsWith(suffix))
|
|
93
|
+
return true;
|
|
94
|
+
}
|
|
95
|
+
else if (pattern.includes("*")) {
|
|
96
|
+
// Basic glob — convert to regex
|
|
97
|
+
const regex = new RegExp("^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*") + "$");
|
|
98
|
+
if (regex.test(relPath))
|
|
99
|
+
return true;
|
|
100
|
+
}
|
|
101
|
+
else {
|
|
102
|
+
// Exact match or prefix
|
|
103
|
+
if (relPath === pattern || relPath.startsWith(pattern + "/"))
|
|
104
|
+
return true;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
return false;
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=scanner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/extract/scanner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
export interface SchemaModel {
|
|
2
|
+
name: string;
|
|
3
|
+
fields: SchemaField[];
|
|
4
|
+
relations: SchemaRelation[];
|
|
5
|
+
source: string;
|
|
6
|
+
}
|
|
7
|
+
export interface SchemaField {
|
|
8
|
+
name: string;
|
|
9
|
+
type: string;
|
|
10
|
+
optional: boolean;
|
|
11
|
+
unique: boolean;
|
|
12
|
+
default: string | null;
|
|
13
|
+
isPk: boolean;
|
|
14
|
+
}
|
|
15
|
+
export interface SchemaRelation {
|
|
16
|
+
field: string;
|
|
17
|
+
target: string;
|
|
18
|
+
type: string;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Extract database schema from ORM definition files.
|
|
22
|
+
* Supports: Prisma, Drizzle, Django models, SQLAlchemy, TypeORM entities.
|
|
23
|
+
*/
|
|
24
|
+
export declare function extractSchemas(root: string): SchemaModel[];
|
|
25
|
+
/**
|
|
26
|
+
* Format schemas for skeleton inclusion.
|
|
27
|
+
*/
|
|
28
|
+
export declare function formatSchemas(models: SchemaModel[]): string;
|