@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.
Files changed (186) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +507 -0
  3. package/dist/cli.d.ts +3 -0
  4. package/dist/cli.d.ts.map +1 -0
  5. package/dist/cli.js +267 -0
  6. package/dist/cli.js.map +1 -0
  7. package/dist/config/loader.d.ts +9 -0
  8. package/dist/config/loader.d.ts.map +1 -0
  9. package/dist/config/loader.js +55 -0
  10. package/dist/config/loader.js.map +1 -0
  11. package/dist/config/schema.d.ts +69 -0
  12. package/dist/config/schema.d.ts.map +1 -0
  13. package/dist/config/schema.js +33 -0
  14. package/dist/config/schema.js.map +1 -0
  15. package/dist/derivers/aider.d.ts +19 -0
  16. package/dist/derivers/aider.d.ts.map +1 -0
  17. package/dist/derivers/aider.js +117 -0
  18. package/dist/derivers/aider.js.map +1 -0
  19. package/dist/derivers/claude.d.ts +19 -0
  20. package/dist/derivers/claude.d.ts.map +1 -0
  21. package/dist/derivers/claude.js +93 -0
  22. package/dist/derivers/claude.js.map +1 -0
  23. package/dist/derivers/cline.d.ts +17 -0
  24. package/dist/derivers/cline.d.ts.map +1 -0
  25. package/dist/derivers/cline.js +92 -0
  26. package/dist/derivers/cline.js.map +1 -0
  27. package/dist/derivers/copilot.d.ts +16 -0
  28. package/dist/derivers/copilot.d.ts.map +1 -0
  29. package/dist/derivers/copilot.js +162 -0
  30. package/dist/derivers/copilot.js.map +1 -0
  31. package/dist/derivers/cursor.d.ts +16 -0
  32. package/dist/derivers/cursor.d.ts.map +1 -0
  33. package/dist/derivers/cursor.js +121 -0
  34. package/dist/derivers/cursor.js.map +1 -0
  35. package/dist/derivers/gemini.d.ts +19 -0
  36. package/dist/derivers/gemini.d.ts.map +1 -0
  37. package/dist/derivers/gemini.js +33 -0
  38. package/dist/derivers/gemini.js.map +1 -0
  39. package/dist/derivers/index.d.ts +33 -0
  40. package/dist/derivers/index.d.ts.map +1 -0
  41. package/dist/derivers/index.js +134 -0
  42. package/dist/derivers/index.js.map +1 -0
  43. package/dist/derivers/merger.d.ts +36 -0
  44. package/dist/derivers/merger.d.ts.map +1 -0
  45. package/dist/derivers/merger.js +83 -0
  46. package/dist/derivers/merger.js.map +1 -0
  47. package/dist/derivers/roo.d.ts +18 -0
  48. package/dist/derivers/roo.d.ts.map +1 -0
  49. package/dist/derivers/roo.js +92 -0
  50. package/dist/derivers/roo.js.map +1 -0
  51. package/dist/derivers/windsurf.d.ts +16 -0
  52. package/dist/derivers/windsurf.d.ts.map +1 -0
  53. package/dist/derivers/windsurf.js +91 -0
  54. package/dist/derivers/windsurf.js.map +1 -0
  55. package/dist/extractor/extractor.d.ts +4 -0
  56. package/dist/extractor/extractor.d.ts.map +1 -0
  57. package/dist/extractor/extractor.js +125 -0
  58. package/dist/extractor/extractor.js.map +1 -0
  59. package/dist/extractor/schema.d.ts +187 -0
  60. package/dist/extractor/schema.d.ts.map +1 -0
  61. package/dist/extractor/schema.js +44 -0
  62. package/dist/extractor/schema.js.map +1 -0
  63. package/dist/generator/agents-md.d.ts +6 -0
  64. package/dist/generator/agents-md.d.ts.map +1 -0
  65. package/dist/generator/agents-md.js +135 -0
  66. package/dist/generator/agents-md.js.map +1 -0
  67. package/dist/generator/validator.d.ts +7 -0
  68. package/dist/generator/validator.d.ts.map +1 -0
  69. package/dist/generator/validator.js +67 -0
  70. package/dist/generator/validator.js.map +1 -0
  71. package/dist/lib/claude-client.d.ts +11 -0
  72. package/dist/lib/claude-client.d.ts.map +1 -0
  73. package/dist/lib/claude-client.js +74 -0
  74. package/dist/lib/claude-client.js.map +1 -0
  75. package/dist/lib/errors.d.ts +10 -0
  76. package/dist/lib/errors.d.ts.map +1 -0
  77. package/dist/lib/errors.js +27 -0
  78. package/dist/lib/errors.js.map +1 -0
  79. package/dist/lib/file-utils.d.ts +7 -0
  80. package/dist/lib/file-utils.d.ts.map +1 -0
  81. package/dist/lib/file-utils.js +56 -0
  82. package/dist/lib/file-utils.js.map +1 -0
  83. package/dist/lib/token-estimate.d.ts +7 -0
  84. package/dist/lib/token-estimate.d.ts.map +1 -0
  85. package/dist/lib/token-estimate.js +15 -0
  86. package/dist/lib/token-estimate.js.map +1 -0
  87. package/dist/scanner/codegraph.d.ts +13 -0
  88. package/dist/scanner/codegraph.d.ts.map +1 -0
  89. package/dist/scanner/codegraph.js +65 -0
  90. package/dist/scanner/codegraph.js.map +1 -0
  91. package/dist/scanner/docs.d.ts +13 -0
  92. package/dist/scanner/docs.d.ts.map +1 -0
  93. package/dist/scanner/docs.js +63 -0
  94. package/dist/scanner/docs.js.map +1 -0
  95. package/dist/scanner/gotchas.d.ts +8 -0
  96. package/dist/scanner/gotchas.d.ts.map +1 -0
  97. package/dist/scanner/gotchas.js +107 -0
  98. package/dist/scanner/gotchas.js.map +1 -0
  99. package/dist/scanner/index.d.ts +26 -0
  100. package/dist/scanner/index.d.ts.map +1 -0
  101. package/dist/scanner/index.js +95 -0
  102. package/dist/scanner/index.js.map +1 -0
  103. package/dist/scanner/manifest.d.ts +13 -0
  104. package/dist/scanner/manifest.d.ts.map +1 -0
  105. package/dist/scanner/manifest.js +285 -0
  106. package/dist/scanner/manifest.js.map +1 -0
  107. package/dist/scanner/mcp.d.ts +12 -0
  108. package/dist/scanner/mcp.d.ts.map +1 -0
  109. package/dist/scanner/mcp.js +96 -0
  110. package/dist/scanner/mcp.js.map +1 -0
  111. package/dist/scanner/repomix.d.ts +11 -0
  112. package/dist/scanner/repomix.d.ts.map +1 -0
  113. package/dist/scanner/repomix.js +87 -0
  114. package/dist/scanner/repomix.js.map +1 -0
  115. package/dist/scanner/skills.d.ts +18 -0
  116. package/dist/scanner/skills.d.ts.map +1 -0
  117. package/dist/scanner/skills.js +100 -0
  118. package/dist/scanner/skills.js.map +1 -0
  119. package/dist/scanner/source.d.ts +13 -0
  120. package/dist/scanner/source.d.ts.map +1 -0
  121. package/dist/scanner/source.js +157 -0
  122. package/dist/scanner/source.js.map +1 -0
  123. package/dist/scanner/structure.d.ts +10 -0
  124. package/dist/scanner/structure.d.ts.map +1 -0
  125. package/dist/scanner/structure.js +168 -0
  126. package/dist/scanner/structure.js.map +1 -0
  127. package/dist/server.d.ts +2 -0
  128. package/dist/server.d.ts.map +1 -0
  129. package/dist/server.js +245 -0
  130. package/dist/server.js.map +1 -0
  131. package/dist/snapshot/drift.d.ts +28 -0
  132. package/dist/snapshot/drift.d.ts.map +1 -0
  133. package/dist/snapshot/drift.js +205 -0
  134. package/dist/snapshot/drift.js.map +1 -0
  135. package/dist/snapshot/schema.d.ts +94 -0
  136. package/dist/snapshot/schema.d.ts.map +1 -0
  137. package/dist/snapshot/schema.js +24 -0
  138. package/dist/snapshot/schema.js.map +1 -0
  139. package/dist/snapshot/writer.d.ts +17 -0
  140. package/dist/snapshot/writer.d.ts.map +1 -0
  141. package/dist/snapshot/writer.js +44 -0
  142. package/dist/snapshot/writer.js.map +1 -0
  143. package/dist/tools/drift.d.ts +15 -0
  144. package/dist/tools/drift.d.ts.map +1 -0
  145. package/dist/tools/drift.js +51 -0
  146. package/dist/tools/drift.js.map +1 -0
  147. package/dist/tools/export.d.ts +14 -0
  148. package/dist/tools/export.d.ts.map +1 -0
  149. package/dist/tools/export.js +53 -0
  150. package/dist/tools/export.js.map +1 -0
  151. package/dist/tools/init.d.ts +28 -0
  152. package/dist/tools/init.d.ts.map +1 -0
  153. package/dist/tools/init.js +103 -0
  154. package/dist/tools/init.js.map +1 -0
  155. package/dist/tools/lint.d.ts +24 -0
  156. package/dist/tools/lint.d.ts.map +1 -0
  157. package/dist/tools/lint.js +213 -0
  158. package/dist/tools/lint.js.map +1 -0
  159. package/dist/tools/scan-report.d.ts +14 -0
  160. package/dist/tools/scan-report.d.ts.map +1 -0
  161. package/dist/tools/scan-report.js +136 -0
  162. package/dist/tools/scan-report.js.map +1 -0
  163. package/dist/tools/status.d.ts +18 -0
  164. package/dist/tools/status.d.ts.map +1 -0
  165. package/dist/tools/status.js +38 -0
  166. package/dist/tools/status.js.map +1 -0
  167. package/dist/tools/sync.d.ts +22 -0
  168. package/dist/tools/sync.d.ts.map +1 -0
  169. package/dist/tools/sync.js +123 -0
  170. package/dist/tools/sync.js.map +1 -0
  171. package/dist/tools/validate.d.ts +22 -0
  172. package/dist/tools/validate.d.ts.map +1 -0
  173. package/dist/tools/validate.js +97 -0
  174. package/dist/tools/validate.js.map +1 -0
  175. package/docs/agents-md-spec.md +233 -0
  176. package/docs/examples/.clinerules +29 -0
  177. package/docs/examples/.cursorrules +19 -0
  178. package/docs/examples/.windsurfrules +14 -0
  179. package/docs/examples/AGENTS.md +97 -0
  180. package/docs/examples/CLAUDE.md +88 -0
  181. package/docs/examples/GEMINI.md +61 -0
  182. package/docs/examples/copilot-instructions.md +24 -0
  183. package/docs/github-action.yml +89 -0
  184. package/package.json +63 -0
  185. package/scripts/demo.sh +138 -0
  186. 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":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAejF,MAAM,eAAe,GAAG;IACtB,oBAAoB;IACpB,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,mBAAmB;IACnB,aAAa;IACb,cAAc;IACd,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,YAAY;IACZ,WAAW;IACX,sBAAsB;IACtB,cAAc;IACd,mBAAmB;IACnB,eAAe;IACf,gBAAgB;CACjB,CAAC;AAEF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,OAAO;IACP,KAAK;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAA2B;IAC/C,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,aAAa;IACtB,QAAQ,EAAE,cAAc;IACxB,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,UAAU;IACf,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,SAAS,UAAU,CAAC,QAAgB;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3E,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,iBAAiB,CACxB,QAAkB;IAElB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,QAAQ,EAAE,CAAC;QAC/D,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,QAAQ,EAAE,CAAC;QAC7C,IAAI,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,aAAa,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,aAAa,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC;IAClF,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,2BAA2B;IAC3B,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,SAAS,GAAG,KAAK;IAEjB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE;YAChC,GAAG,EAAE,WAAW;YAChB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,eAAe;YACvB,GAAG,EAAE,KAAK;SACX,CAAC,CAAC;QAEH,gDAAgD;QAChD,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,SAAS,GAAG,SAAS,CAAC;YAC1D,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,0EAA0E;QAC1E,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,QAAQ,CAAC,MAAM,IAAI,EAAE;gBAAE,MAAM;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;iBAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAkB,EAAE,CAAC;QACvC,IAAI,eAAe,GAAG,SAAS,CAAC;QAChC,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,eAAe,IAAI,CAAC;gBAAE,MAAM;YAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,CAAC,GAAG;gBAAE,SAAS;YAEnB,oBAAoB;YACpB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEnC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,SAAS,GAAG,IAAI;gBAAE,SAAS;YAC/B,IAAI,SAAS,GAAG,eAAe;gBAAE,SAAS;YAE1C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;YACtE,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YAEvC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACtD,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,eAAe,IAAI,MAAM,CAAC;QAC5B,CAAC;QAED,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,gBAAgB,GAAG,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEhE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,SAAS;YACtB,gBAAgB,EAAE,EAAE;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}
@@ -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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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}