@googlarz/agents-sync 1.4.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 +507 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +267 -0
- package/dist/cli.js.map +1 -0
- package/dist/config/loader.d.ts +9 -0
- package/dist/config/loader.d.ts.map +1 -0
- package/dist/config/loader.js +55 -0
- package/dist/config/loader.js.map +1 -0
- package/dist/config/schema.d.ts +69 -0
- package/dist/config/schema.d.ts.map +1 -0
- package/dist/config/schema.js +33 -0
- package/dist/config/schema.js.map +1 -0
- package/dist/derivers/aider.d.ts +19 -0
- package/dist/derivers/aider.d.ts.map +1 -0
- package/dist/derivers/aider.js +117 -0
- package/dist/derivers/aider.js.map +1 -0
- package/dist/derivers/claude.d.ts +19 -0
- package/dist/derivers/claude.d.ts.map +1 -0
- package/dist/derivers/claude.js +93 -0
- package/dist/derivers/claude.js.map +1 -0
- package/dist/derivers/cline.d.ts +17 -0
- package/dist/derivers/cline.d.ts.map +1 -0
- package/dist/derivers/cline.js +92 -0
- package/dist/derivers/cline.js.map +1 -0
- package/dist/derivers/copilot.d.ts +16 -0
- package/dist/derivers/copilot.d.ts.map +1 -0
- package/dist/derivers/copilot.js +162 -0
- package/dist/derivers/copilot.js.map +1 -0
- package/dist/derivers/cursor.d.ts +16 -0
- package/dist/derivers/cursor.d.ts.map +1 -0
- package/dist/derivers/cursor.js +121 -0
- package/dist/derivers/cursor.js.map +1 -0
- package/dist/derivers/gemini.d.ts +19 -0
- package/dist/derivers/gemini.d.ts.map +1 -0
- package/dist/derivers/gemini.js +33 -0
- package/dist/derivers/gemini.js.map +1 -0
- package/dist/derivers/index.d.ts +33 -0
- package/dist/derivers/index.d.ts.map +1 -0
- package/dist/derivers/index.js +134 -0
- package/dist/derivers/index.js.map +1 -0
- package/dist/derivers/merger.d.ts +36 -0
- package/dist/derivers/merger.d.ts.map +1 -0
- package/dist/derivers/merger.js +83 -0
- package/dist/derivers/merger.js.map +1 -0
- package/dist/derivers/roo.d.ts +18 -0
- package/dist/derivers/roo.d.ts.map +1 -0
- package/dist/derivers/roo.js +92 -0
- package/dist/derivers/roo.js.map +1 -0
- package/dist/derivers/windsurf.d.ts +16 -0
- package/dist/derivers/windsurf.d.ts.map +1 -0
- package/dist/derivers/windsurf.js +91 -0
- package/dist/derivers/windsurf.js.map +1 -0
- package/dist/extractor/extractor.d.ts +4 -0
- package/dist/extractor/extractor.d.ts.map +1 -0
- package/dist/extractor/extractor.js +125 -0
- package/dist/extractor/extractor.js.map +1 -0
- package/dist/extractor/schema.d.ts +187 -0
- package/dist/extractor/schema.d.ts.map +1 -0
- package/dist/extractor/schema.js +44 -0
- package/dist/extractor/schema.js.map +1 -0
- package/dist/generator/agents-md.d.ts +6 -0
- package/dist/generator/agents-md.d.ts.map +1 -0
- package/dist/generator/agents-md.js +135 -0
- package/dist/generator/agents-md.js.map +1 -0
- package/dist/generator/validator.d.ts +7 -0
- package/dist/generator/validator.d.ts.map +1 -0
- package/dist/generator/validator.js +67 -0
- package/dist/generator/validator.js.map +1 -0
- package/dist/lib/claude-client.d.ts +11 -0
- package/dist/lib/claude-client.d.ts.map +1 -0
- package/dist/lib/claude-client.js +74 -0
- package/dist/lib/claude-client.js.map +1 -0
- package/dist/lib/errors.d.ts +10 -0
- package/dist/lib/errors.d.ts.map +1 -0
- package/dist/lib/errors.js +27 -0
- package/dist/lib/errors.js.map +1 -0
- package/dist/lib/file-utils.d.ts +7 -0
- package/dist/lib/file-utils.d.ts.map +1 -0
- package/dist/lib/file-utils.js +56 -0
- package/dist/lib/file-utils.js.map +1 -0
- package/dist/lib/token-estimate.d.ts +7 -0
- package/dist/lib/token-estimate.d.ts.map +1 -0
- package/dist/lib/token-estimate.js +15 -0
- package/dist/lib/token-estimate.js.map +1 -0
- package/dist/scanner/codegraph.d.ts +13 -0
- package/dist/scanner/codegraph.d.ts.map +1 -0
- package/dist/scanner/codegraph.js +65 -0
- package/dist/scanner/codegraph.js.map +1 -0
- package/dist/scanner/docs.d.ts +13 -0
- package/dist/scanner/docs.d.ts.map +1 -0
- package/dist/scanner/docs.js +63 -0
- package/dist/scanner/docs.js.map +1 -0
- package/dist/scanner/gotchas.d.ts +8 -0
- package/dist/scanner/gotchas.d.ts.map +1 -0
- package/dist/scanner/gotchas.js +107 -0
- package/dist/scanner/gotchas.js.map +1 -0
- package/dist/scanner/index.d.ts +26 -0
- package/dist/scanner/index.d.ts.map +1 -0
- package/dist/scanner/index.js +95 -0
- package/dist/scanner/index.js.map +1 -0
- package/dist/scanner/manifest.d.ts +13 -0
- package/dist/scanner/manifest.d.ts.map +1 -0
- package/dist/scanner/manifest.js +285 -0
- package/dist/scanner/manifest.js.map +1 -0
- package/dist/scanner/mcp.d.ts +12 -0
- package/dist/scanner/mcp.d.ts.map +1 -0
- package/dist/scanner/mcp.js +96 -0
- package/dist/scanner/mcp.js.map +1 -0
- package/dist/scanner/repomix.d.ts +11 -0
- package/dist/scanner/repomix.d.ts.map +1 -0
- package/dist/scanner/repomix.js +87 -0
- package/dist/scanner/repomix.js.map +1 -0
- package/dist/scanner/skills.d.ts +18 -0
- package/dist/scanner/skills.d.ts.map +1 -0
- package/dist/scanner/skills.js +100 -0
- package/dist/scanner/skills.js.map +1 -0
- package/dist/scanner/source.d.ts +13 -0
- package/dist/scanner/source.d.ts.map +1 -0
- package/dist/scanner/source.js +157 -0
- package/dist/scanner/source.js.map +1 -0
- package/dist/scanner/structure.d.ts +10 -0
- package/dist/scanner/structure.d.ts.map +1 -0
- package/dist/scanner/structure.js +168 -0
- package/dist/scanner/structure.js.map +1 -0
- package/dist/server.d.ts +2 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +245 -0
- package/dist/server.js.map +1 -0
- package/dist/snapshot/drift.d.ts +28 -0
- package/dist/snapshot/drift.d.ts.map +1 -0
- package/dist/snapshot/drift.js +205 -0
- package/dist/snapshot/drift.js.map +1 -0
- package/dist/snapshot/schema.d.ts +94 -0
- package/dist/snapshot/schema.d.ts.map +1 -0
- package/dist/snapshot/schema.js +24 -0
- package/dist/snapshot/schema.js.map +1 -0
- package/dist/snapshot/writer.d.ts +17 -0
- package/dist/snapshot/writer.d.ts.map +1 -0
- package/dist/snapshot/writer.js +44 -0
- package/dist/snapshot/writer.js.map +1 -0
- package/dist/tools/drift.d.ts +15 -0
- package/dist/tools/drift.d.ts.map +1 -0
- package/dist/tools/drift.js +51 -0
- package/dist/tools/drift.js.map +1 -0
- package/dist/tools/export.d.ts +14 -0
- package/dist/tools/export.d.ts.map +1 -0
- package/dist/tools/export.js +53 -0
- package/dist/tools/export.js.map +1 -0
- package/dist/tools/init.d.ts +28 -0
- package/dist/tools/init.d.ts.map +1 -0
- package/dist/tools/init.js +103 -0
- package/dist/tools/init.js.map +1 -0
- package/dist/tools/lint.d.ts +24 -0
- package/dist/tools/lint.d.ts.map +1 -0
- package/dist/tools/lint.js +213 -0
- package/dist/tools/lint.js.map +1 -0
- package/dist/tools/scan-report.d.ts +14 -0
- package/dist/tools/scan-report.d.ts.map +1 -0
- package/dist/tools/scan-report.js +136 -0
- package/dist/tools/scan-report.js.map +1 -0
- package/dist/tools/status.d.ts +18 -0
- package/dist/tools/status.d.ts.map +1 -0
- package/dist/tools/status.js +38 -0
- package/dist/tools/status.js.map +1 -0
- package/dist/tools/sync.d.ts +22 -0
- package/dist/tools/sync.d.ts.map +1 -0
- package/dist/tools/sync.js +123 -0
- package/dist/tools/sync.js.map +1 -0
- package/dist/tools/validate.d.ts +22 -0
- package/dist/tools/validate.d.ts.map +1 -0
- package/dist/tools/validate.js +97 -0
- package/dist/tools/validate.js.map +1 -0
- package/docs/agents-md-spec.md +233 -0
- package/docs/examples/.clinerules +29 -0
- package/docs/examples/.cursorrules +19 -0
- package/docs/examples/.windsurfrules +14 -0
- package/docs/examples/AGENTS.md +97 -0
- package/docs/examples/CLAUDE.md +88 -0
- package/docs/examples/GEMINI.md +61 -0
- package/docs/examples/copilot-instructions.md +24 -0
- package/docs/github-action.yml +89 -0
- package/package.json +63 -0
- package/scripts/demo.sh +138 -0
- package/skill/SKILL.md +158 -0
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export interface LocalCommand {
|
|
2
|
+
name: string;
|
|
3
|
+
description: string;
|
|
4
|
+
filePath: string;
|
|
5
|
+
}
|
|
6
|
+
export interface LocalSkill {
|
|
7
|
+
name: string;
|
|
8
|
+
description: string;
|
|
9
|
+
dirPath: string;
|
|
10
|
+
}
|
|
11
|
+
export interface ProjectSkillsSummary {
|
|
12
|
+
commands: LocalCommand[];
|
|
13
|
+
skills: LocalSkill[];
|
|
14
|
+
hasAny: boolean;
|
|
15
|
+
}
|
|
16
|
+
export declare function scanProjectSkills(projectPath: string): Promise<ProjectSkillsSummary>;
|
|
17
|
+
export declare function formatSkillsSection(summary: ProjectSkillsSummary): string;
|
|
18
|
+
//# sourceMappingURL=skills.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/scanner/skills.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAqCD,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAwC1F;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAsBzE"}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Project-local skill/command scanner.
|
|
3
|
+
*
|
|
4
|
+
* Reads .claude/commands/ for custom slash commands, and .claude/skills/ for
|
|
5
|
+
* locally-installed skills. Returns a summary that can be injected into
|
|
6
|
+
* CLAUDE.md so the AI knows what's available in the project.
|
|
7
|
+
*/
|
|
8
|
+
import path from "node:path";
|
|
9
|
+
import fs from "node:fs/promises";
|
|
10
|
+
async function listMdFiles(dir) {
|
|
11
|
+
try {
|
|
12
|
+
const entries = await fs.readdir(dir, { withFileTypes: true });
|
|
13
|
+
return entries
|
|
14
|
+
.filter((e) => e.isFile() && e.name.endsWith(".md"))
|
|
15
|
+
.map((e) => path.join(dir, e.name));
|
|
16
|
+
}
|
|
17
|
+
catch {
|
|
18
|
+
return [];
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
function extractDescription(content, fallback) {
|
|
22
|
+
// Try to find a one-line description: first non-empty line after the title,
|
|
23
|
+
// or the first non-heading paragraph, or just the first line.
|
|
24
|
+
const lines = content.split("\n").map((l) => l.trim()).filter(Boolean);
|
|
25
|
+
for (const line of lines) {
|
|
26
|
+
if (line.startsWith("#"))
|
|
27
|
+
continue;
|
|
28
|
+
if (line.startsWith("---"))
|
|
29
|
+
continue;
|
|
30
|
+
return line.slice(0, 120);
|
|
31
|
+
}
|
|
32
|
+
return fallback;
|
|
33
|
+
}
|
|
34
|
+
async function readFirstLines(filePath, maxBytes = 500) {
|
|
35
|
+
try {
|
|
36
|
+
const buf = Buffer.alloc(maxBytes);
|
|
37
|
+
const handle = await fs.open(filePath, "r");
|
|
38
|
+
const { bytesRead } = await handle.read(buf, 0, maxBytes, 0);
|
|
39
|
+
await handle.close();
|
|
40
|
+
return buf.subarray(0, bytesRead).toString("utf-8");
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
return "";
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
export async function scanProjectSkills(projectPath) {
|
|
47
|
+
const commandsDir = path.join(projectPath, ".claude", "commands");
|
|
48
|
+
const skillsDir = path.join(projectPath, ".claude", "skills");
|
|
49
|
+
const [commandFiles, skillDirs] = await Promise.all([
|
|
50
|
+
listMdFiles(commandsDir),
|
|
51
|
+
(async () => {
|
|
52
|
+
try {
|
|
53
|
+
const entries = await fs.readdir(skillsDir, { withFileTypes: true });
|
|
54
|
+
return entries.filter((e) => e.isDirectory()).map((e) => path.join(skillsDir, e.name));
|
|
55
|
+
}
|
|
56
|
+
catch {
|
|
57
|
+
return [];
|
|
58
|
+
}
|
|
59
|
+
})(),
|
|
60
|
+
]);
|
|
61
|
+
const commands = await Promise.all(commandFiles.map(async (filePath) => {
|
|
62
|
+
const name = path.basename(filePath, ".md");
|
|
63
|
+
const content = await readFirstLines(filePath);
|
|
64
|
+
const description = extractDescription(content, `/${name} command`);
|
|
65
|
+
return { name, description, filePath };
|
|
66
|
+
}));
|
|
67
|
+
const skills = await Promise.all(skillDirs.map(async (dirPath) => {
|
|
68
|
+
const name = path.basename(dirPath);
|
|
69
|
+
const skillMdPath = path.join(dirPath, "SKILL.md");
|
|
70
|
+
const content = await readFirstLines(skillMdPath);
|
|
71
|
+
const description = extractDescription(content, `${name} skill`);
|
|
72
|
+
return { name, description, dirPath };
|
|
73
|
+
}));
|
|
74
|
+
return {
|
|
75
|
+
commands,
|
|
76
|
+
skills,
|
|
77
|
+
hasAny: commands.length > 0 || skills.length > 0,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
export function formatSkillsSection(summary) {
|
|
81
|
+
if (!summary.hasAny)
|
|
82
|
+
return "";
|
|
83
|
+
const lines = ["## Project Commands & Skills", ""];
|
|
84
|
+
if (summary.commands.length > 0) {
|
|
85
|
+
lines.push("### Custom slash commands (`.claude/commands/`)");
|
|
86
|
+
for (const cmd of summary.commands) {
|
|
87
|
+
lines.push(`- \`/${cmd.name}\` — ${cmd.description}`);
|
|
88
|
+
}
|
|
89
|
+
lines.push("");
|
|
90
|
+
}
|
|
91
|
+
if (summary.skills.length > 0) {
|
|
92
|
+
lines.push("### Local skills (`.claude/skills/`)");
|
|
93
|
+
for (const skill of summary.skills) {
|
|
94
|
+
lines.push(`- \`${skill.name}\` — ${skill.description}`);
|
|
95
|
+
}
|
|
96
|
+
lines.push("");
|
|
97
|
+
}
|
|
98
|
+
return lines.join("\n");
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=skills.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/scanner/skills.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export interface SampledFile {
|
|
2
|
+
path: string;
|
|
3
|
+
content: string;
|
|
4
|
+
tokens: number;
|
|
5
|
+
}
|
|
6
|
+
export interface SourceData {
|
|
7
|
+
files: SampledFile[];
|
|
8
|
+
totalTokens: number;
|
|
9
|
+
importStyle: "esm" | "cjs" | "relative-only" | "unknown";
|
|
10
|
+
detectedPatterns: string[];
|
|
11
|
+
}
|
|
12
|
+
export declare function sampleSource(projectPath: string, maxTokens?: number): Promise<SourceData>;
|
|
13
|
+
//# sourceMappingURL=source.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/scanner/source.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,GAAG,KAAK,GAAG,eAAe,GAAG,SAAS,CAAC;IACzD,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAsFD,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,SAAQ,GAChB,OAAO,CAAC,UAAU,CAAC,CAwErB"}
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import fg from "fast-glob";
|
|
3
|
+
import { readFileSafe } from "../lib/file-utils.js";
|
|
4
|
+
import { estimateTokens, truncateToTokenBudget } from "../lib/token-estimate.js";
|
|
5
|
+
const IGNORE_PATTERNS = [
|
|
6
|
+
"**/node_modules/**",
|
|
7
|
+
"**/.git/**",
|
|
8
|
+
"**/dist/**",
|
|
9
|
+
"**/build/**",
|
|
10
|
+
"**/__pycache__/**",
|
|
11
|
+
"**/.venv/**",
|
|
12
|
+
"**/target/**",
|
|
13
|
+
"**/.next/**",
|
|
14
|
+
"**/coverage/**",
|
|
15
|
+
"**/.cache/**",
|
|
16
|
+
"**/*.min.js",
|
|
17
|
+
"**/*.gen.*",
|
|
18
|
+
"**/*.d.ts",
|
|
19
|
+
"**/package-lock.json",
|
|
20
|
+
"**/yarn.lock",
|
|
21
|
+
"**/pnpm-lock.yaml",
|
|
22
|
+
"**/Cargo.lock",
|
|
23
|
+
"**/poetry.lock",
|
|
24
|
+
];
|
|
25
|
+
const PRIORITY_NAMES = new Set([
|
|
26
|
+
"index",
|
|
27
|
+
"app",
|
|
28
|
+
"main",
|
|
29
|
+
"server",
|
|
30
|
+
"schema",
|
|
31
|
+
"types",
|
|
32
|
+
"routes",
|
|
33
|
+
]);
|
|
34
|
+
const PATTERN_KEYWORDS = {
|
|
35
|
+
prisma: "prisma ORM",
|
|
36
|
+
drizzle: "drizzle ORM",
|
|
37
|
+
mongoose: "mongoose ODM",
|
|
38
|
+
zod: "zod validation",
|
|
39
|
+
yup: "yup validation",
|
|
40
|
+
jwt: "JWT auth",
|
|
41
|
+
supabase: "supabase",
|
|
42
|
+
redis: "redis",
|
|
43
|
+
graphql: "GraphQL",
|
|
44
|
+
trpc: "tRPC",
|
|
45
|
+
tailwind: "tailwind CSS",
|
|
46
|
+
shadcn: "shadcn/ui",
|
|
47
|
+
};
|
|
48
|
+
function isPriority(filePath) {
|
|
49
|
+
const base = path.basename(filePath, path.extname(filePath)).toLowerCase();
|
|
50
|
+
return PRIORITY_NAMES.has(base);
|
|
51
|
+
}
|
|
52
|
+
function detectImportStyle(contents) {
|
|
53
|
+
let esmCount = 0;
|
|
54
|
+
let cjsCount = 0;
|
|
55
|
+
let relativeCount = 0;
|
|
56
|
+
for (const content of contents) {
|
|
57
|
+
if (/import\s+.+\s+from\s+['"][^.@]/.test(content))
|
|
58
|
+
esmCount++;
|
|
59
|
+
if (/require\s*\(/.test(content))
|
|
60
|
+
cjsCount++;
|
|
61
|
+
if (/import\s+.+\s+from\s+['"][./]/.test(content))
|
|
62
|
+
relativeCount++;
|
|
63
|
+
}
|
|
64
|
+
if (esmCount > 0 && cjsCount === 0)
|
|
65
|
+
return "esm";
|
|
66
|
+
if (cjsCount > 0 && esmCount === 0)
|
|
67
|
+
return "cjs";
|
|
68
|
+
if (relativeCount > 0 && esmCount === 0 && cjsCount === 0)
|
|
69
|
+
return "relative-only";
|
|
70
|
+
if (esmCount > 0 || cjsCount > 0)
|
|
71
|
+
return esmCount >= cjsCount ? "esm" : "cjs";
|
|
72
|
+
return "unknown";
|
|
73
|
+
}
|
|
74
|
+
function detectPatterns(allContent) {
|
|
75
|
+
const lower = allContent.toLowerCase();
|
|
76
|
+
const found = [];
|
|
77
|
+
for (const [keyword, label] of Object.entries(PATTERN_KEYWORDS)) {
|
|
78
|
+
if (lower.includes(keyword))
|
|
79
|
+
found.push(label);
|
|
80
|
+
}
|
|
81
|
+
// Detect async/await usage
|
|
82
|
+
if (/\basync\b/.test(allContent) && /\bawait\b/.test(allContent)) {
|
|
83
|
+
found.unshift("uses async/await");
|
|
84
|
+
}
|
|
85
|
+
return found;
|
|
86
|
+
}
|
|
87
|
+
export async function sampleSource(projectPath, maxTokens = 10000) {
|
|
88
|
+
try {
|
|
89
|
+
const allFiles = await fg("**/*", {
|
|
90
|
+
cwd: projectPath,
|
|
91
|
+
onlyFiles: true,
|
|
92
|
+
ignore: IGNORE_PATTERNS,
|
|
93
|
+
dot: false,
|
|
94
|
+
});
|
|
95
|
+
// Sort: priority files first, then alphabetical
|
|
96
|
+
const sorted = [...allFiles].sort((a, b) => {
|
|
97
|
+
const aPriority = isPriority(a) ? 0 : 1;
|
|
98
|
+
const bPriority = isPriority(b) ? 0 : 1;
|
|
99
|
+
if (aPriority !== bPriority)
|
|
100
|
+
return aPriority - bPriority;
|
|
101
|
+
return a.localeCompare(b);
|
|
102
|
+
});
|
|
103
|
+
// Pick 1 file per unique directory (after priority files), up to 20 total
|
|
104
|
+
const selected = [];
|
|
105
|
+
const seenDirs = new Set();
|
|
106
|
+
for (const file of sorted) {
|
|
107
|
+
if (selected.length >= 20)
|
|
108
|
+
break;
|
|
109
|
+
const dir = path.dirname(file);
|
|
110
|
+
if (isPriority(file)) {
|
|
111
|
+
selected.push(file);
|
|
112
|
+
}
|
|
113
|
+
else if (!seenDirs.has(dir)) {
|
|
114
|
+
seenDirs.add(dir);
|
|
115
|
+
selected.push(file);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
const sampledFiles = [];
|
|
119
|
+
let remainingBudget = maxTokens;
|
|
120
|
+
const allContents = [];
|
|
121
|
+
for (const relPath of selected) {
|
|
122
|
+
if (remainingBudget <= 0)
|
|
123
|
+
break;
|
|
124
|
+
const absPath = path.join(projectPath, relPath);
|
|
125
|
+
const raw = await readFileSafe(absPath);
|
|
126
|
+
if (!raw)
|
|
127
|
+
continue;
|
|
128
|
+
// Skip binary files
|
|
129
|
+
const probe = raw.slice(0, 512);
|
|
130
|
+
if (probe.includes("\0"))
|
|
131
|
+
continue;
|
|
132
|
+
const rawTokens = estimateTokens(raw);
|
|
133
|
+
if (rawTokens > 3000)
|
|
134
|
+
continue;
|
|
135
|
+
if (rawTokens > remainingBudget)
|
|
136
|
+
continue;
|
|
137
|
+
const { text: content } = truncateToTokenBudget(raw, remainingBudget);
|
|
138
|
+
const tokens = estimateTokens(content);
|
|
139
|
+
sampledFiles.push({ path: relPath, content, tokens });
|
|
140
|
+
allContents.push(content);
|
|
141
|
+
remainingBudget -= tokens;
|
|
142
|
+
}
|
|
143
|
+
const totalTokens = sampledFiles.reduce((sum, f) => sum + f.tokens, 0);
|
|
144
|
+
const importStyle = detectImportStyle(allContents);
|
|
145
|
+
const detectedPatterns = detectPatterns(allContents.join("\n"));
|
|
146
|
+
return { files: sampledFiles, totalTokens, importStyle, detectedPatterns };
|
|
147
|
+
}
|
|
148
|
+
catch {
|
|
149
|
+
return {
|
|
150
|
+
files: [],
|
|
151
|
+
totalTokens: 0,
|
|
152
|
+
importStyle: "unknown",
|
|
153
|
+
detectedPatterns: [],
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
//# sourceMappingURL=source.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/scanner/source.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export interface StructureData {
|
|
2
|
+
topLevelDirs: string[];
|
|
3
|
+
entryPoints: string[];
|
|
4
|
+
testDirs: string[];
|
|
5
|
+
totalFileCount: number;
|
|
6
|
+
namingConvention: "kebab-case" | "camelCase" | "snake_case" | "PascalCase" | "mixed";
|
|
7
|
+
tree: string;
|
|
8
|
+
}
|
|
9
|
+
export declare function scanStructure(projectPath: string): Promise<StructureData>;
|
|
10
|
+
//# sourceMappingURL=structure.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/scanner/structure.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC;IACrF,IAAI,EAAE,MAAM,CAAC;CACd;AAoGD,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAoF/E"}
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import fg from "fast-glob";
|
|
3
|
+
const IGNORE_PATTERNS = [
|
|
4
|
+
"**/node_modules/**",
|
|
5
|
+
"**/.git/**",
|
|
6
|
+
"**/dist/**",
|
|
7
|
+
"**/build/**",
|
|
8
|
+
"**/__pycache__/**",
|
|
9
|
+
"**/.venv/**",
|
|
10
|
+
"**/target/**",
|
|
11
|
+
"**/.next/**",
|
|
12
|
+
"**/coverage/**",
|
|
13
|
+
"**/.cache/**",
|
|
14
|
+
];
|
|
15
|
+
const ENTRY_POINT_PATTERNS = [
|
|
16
|
+
/^src\/index\./,
|
|
17
|
+
/^index\./,
|
|
18
|
+
/^main\./,
|
|
19
|
+
/^app\./,
|
|
20
|
+
/^server\./,
|
|
21
|
+
/^cmd\/main\./,
|
|
22
|
+
/^manage\.py$/,
|
|
23
|
+
/^wsgi\.py$/,
|
|
24
|
+
];
|
|
25
|
+
function detectNamingConvention(names) {
|
|
26
|
+
const counts = { kebab: 0, camel: 0, snake: 0, pascal: 0 };
|
|
27
|
+
for (const name of names) {
|
|
28
|
+
if (/^[A-Z][a-zA-Z0-9]*$/.test(name))
|
|
29
|
+
counts.pascal++;
|
|
30
|
+
else if (/^[a-z][a-zA-Z0-9]*[A-Z]/.test(name))
|
|
31
|
+
counts.camel++;
|
|
32
|
+
else if (name.includes("-"))
|
|
33
|
+
counts.kebab++;
|
|
34
|
+
else if (name.includes("_"))
|
|
35
|
+
counts.snake++;
|
|
36
|
+
}
|
|
37
|
+
const total = names.length;
|
|
38
|
+
if (total === 0)
|
|
39
|
+
return "mixed";
|
|
40
|
+
const threshold = 0.5;
|
|
41
|
+
if (counts.kebab / total >= threshold)
|
|
42
|
+
return "kebab-case";
|
|
43
|
+
if (counts.camel / total >= threshold)
|
|
44
|
+
return "camelCase";
|
|
45
|
+
if (counts.snake / total >= threshold)
|
|
46
|
+
return "snake_case";
|
|
47
|
+
if (counts.pascal / total >= threshold)
|
|
48
|
+
return "PascalCase";
|
|
49
|
+
return "mixed";
|
|
50
|
+
}
|
|
51
|
+
function buildTree(files, maxLines = 60) {
|
|
52
|
+
// Build a nested structure from paths
|
|
53
|
+
const tree = {};
|
|
54
|
+
for (const file of files) {
|
|
55
|
+
const parts = file.split("/");
|
|
56
|
+
let node = tree;
|
|
57
|
+
for (const part of parts) {
|
|
58
|
+
if (!(part in node)) {
|
|
59
|
+
node[part] = {};
|
|
60
|
+
}
|
|
61
|
+
node = node[part];
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
const lines = ["."];
|
|
65
|
+
function renderNode(node, prefix, depth) {
|
|
66
|
+
if (depth > 3)
|
|
67
|
+
return;
|
|
68
|
+
if (lines.length >= maxLines)
|
|
69
|
+
return;
|
|
70
|
+
const entries = Object.entries(node);
|
|
71
|
+
entries.sort(([a], [b]) => a.localeCompare(b));
|
|
72
|
+
for (let i = 0; i < entries.length; i++) {
|
|
73
|
+
if (lines.length >= maxLines)
|
|
74
|
+
return;
|
|
75
|
+
const [key, child] = entries[i];
|
|
76
|
+
const isLast = i === entries.length - 1;
|
|
77
|
+
const connector = isLast ? "└── " : "├── ";
|
|
78
|
+
const childPrefix = isLast ? " " : "│ ";
|
|
79
|
+
lines.push(`${prefix}${connector}${key}`);
|
|
80
|
+
const childNode = child;
|
|
81
|
+
if (Object.keys(childNode).length > 0) {
|
|
82
|
+
renderNode(childNode, prefix + childPrefix, depth + 1);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
renderNode(tree, "", 1);
|
|
87
|
+
if (lines.length >= maxLines) {
|
|
88
|
+
lines.push("... (truncated)");
|
|
89
|
+
}
|
|
90
|
+
return lines.join("\n");
|
|
91
|
+
}
|
|
92
|
+
export async function scanStructure(projectPath) {
|
|
93
|
+
try {
|
|
94
|
+
// List files up to depth 3
|
|
95
|
+
const files = await fg("**/*", {
|
|
96
|
+
cwd: projectPath,
|
|
97
|
+
onlyFiles: true,
|
|
98
|
+
deep: 3,
|
|
99
|
+
ignore: IGNORE_PATTERNS,
|
|
100
|
+
dot: false,
|
|
101
|
+
});
|
|
102
|
+
// Total file count (no depth limit, capped at 9999)
|
|
103
|
+
let totalFileCount;
|
|
104
|
+
try {
|
|
105
|
+
const allFiles = await fg("**/*", {
|
|
106
|
+
cwd: projectPath,
|
|
107
|
+
onlyFiles: true,
|
|
108
|
+
ignore: IGNORE_PATTERNS,
|
|
109
|
+
dot: false,
|
|
110
|
+
});
|
|
111
|
+
totalFileCount = Math.min(allFiles.length, 9999);
|
|
112
|
+
}
|
|
113
|
+
catch {
|
|
114
|
+
totalFileCount = Math.min(files.length, 9999);
|
|
115
|
+
}
|
|
116
|
+
// Top-level dirs
|
|
117
|
+
const topLevelDirSet = new Set();
|
|
118
|
+
for (const file of files) {
|
|
119
|
+
const firstSegment = file.split("/")[0];
|
|
120
|
+
if (firstSegment && firstSegment !== file) {
|
|
121
|
+
topLevelDirSet.add(firstSegment);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
const topLevelDirs = Array.from(topLevelDirSet).sort();
|
|
125
|
+
// Entry points
|
|
126
|
+
const entryPoints = files.filter((f) => ENTRY_POINT_PATTERNS.some((pattern) => pattern.test(f)));
|
|
127
|
+
// Test dirs
|
|
128
|
+
const testDirSet = new Set();
|
|
129
|
+
for (const file of files) {
|
|
130
|
+
const parts = file.split("/");
|
|
131
|
+
for (let i = 0; i < parts.length - 1; i++) {
|
|
132
|
+
const dir = parts[i];
|
|
133
|
+
if (dir.toLowerCase().includes("test") ||
|
|
134
|
+
dir.toLowerCase().includes("spec") ||
|
|
135
|
+
dir === "__tests__") {
|
|
136
|
+
testDirSet.add(parts.slice(0, i + 1).join("/"));
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
const testDirs = Array.from(testDirSet).sort();
|
|
141
|
+
// Naming convention: sample first 20 filenames without extension
|
|
142
|
+
const sampleNames = files
|
|
143
|
+
.slice(0, 20)
|
|
144
|
+
.map((f) => path.basename(f, path.extname(f)));
|
|
145
|
+
const namingConvention = detectNamingConvention(sampleNames);
|
|
146
|
+
// Tree
|
|
147
|
+
const tree = buildTree(files);
|
|
148
|
+
return {
|
|
149
|
+
topLevelDirs,
|
|
150
|
+
entryPoints,
|
|
151
|
+
testDirs,
|
|
152
|
+
totalFileCount,
|
|
153
|
+
namingConvention,
|
|
154
|
+
tree,
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
return {
|
|
159
|
+
topLevelDirs: [],
|
|
160
|
+
entryPoints: [],
|
|
161
|
+
testDirs: [],
|
|
162
|
+
totalFileCount: 0,
|
|
163
|
+
namingConvention: "mixed",
|
|
164
|
+
tree: ".",
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
//# sourceMappingURL=structure.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../src/scanner/structure.ts"],"names":[],"mappings":"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"}
|
package/dist/server.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}
|