@googlarz/agents-sync 1.0.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 (189) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +366 -0
  3. package/dist/cli.d.ts +3 -0
  4. package/dist/cli.d.ts.map +1 -0
  5. package/dist/cli.js +237 -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 +41 -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 +124 -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 +117 -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 +3 -0
  64. package/dist/generator/agents-md.d.ts.map +1 -0
  65. package/dist/generator/agents-md.js +127 -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 +21 -0
  100. package/dist/scanner/index.d.ts.map +1 -0
  101. package/dist/scanner/index.js +87 -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 +212 -0
  130. package/dist/server.js.map +1 -0
  131. package/dist/snapshot/drift.d.ts +22 -0
  132. package/dist/snapshot/drift.d.ts.map +1 -0
  133. package/dist/snapshot/drift.js +105 -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 +31 -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/install-hook.d.ts +15 -0
  156. package/dist/tools/install-hook.d.ts.map +1 -0
  157. package/dist/tools/install-hook.js +169 -0
  158. package/dist/tools/install-hook.js.map +1 -0
  159. package/dist/tools/lint.d.ts +24 -0
  160. package/dist/tools/lint.d.ts.map +1 -0
  161. package/dist/tools/lint.js +213 -0
  162. package/dist/tools/lint.js.map +1 -0
  163. package/dist/tools/scan-report.d.ts +14 -0
  164. package/dist/tools/scan-report.d.ts.map +1 -0
  165. package/dist/tools/scan-report.js +136 -0
  166. package/dist/tools/scan-report.js.map +1 -0
  167. package/dist/tools/status.d.ts +18 -0
  168. package/dist/tools/status.d.ts.map +1 -0
  169. package/dist/tools/status.js +38 -0
  170. package/dist/tools/status.js.map +1 -0
  171. package/dist/tools/sync.d.ts +22 -0
  172. package/dist/tools/sync.d.ts.map +1 -0
  173. package/dist/tools/sync.js +123 -0
  174. package/dist/tools/sync.js.map +1 -0
  175. package/dist/tools/validate.d.ts +22 -0
  176. package/dist/tools/validate.d.ts.map +1 -0
  177. package/dist/tools/validate.js +97 -0
  178. package/dist/tools/validate.js.map +1 -0
  179. package/docs/examples/.clinerules +29 -0
  180. package/docs/examples/.cursorrules +19 -0
  181. package/docs/examples/.windsurfrules +14 -0
  182. package/docs/examples/AGENTS.md +97 -0
  183. package/docs/examples/CLAUDE.md +88 -0
  184. package/docs/examples/GEMINI.md +61 -0
  185. package/docs/examples/copilot-instructions.md +24 -0
  186. package/docs/github-action.yml +89 -0
  187. package/package.json +63 -0
  188. package/scripts/demo.sh +138 -0
  189. package/skill/SKILL.md +158 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codegraph.js","sourceRoot":"","sources":["../../src/scanner/codegraph.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ export interface DocData {
2
+ readme: string | null;
3
+ contributing: string | null;
4
+ architecture: string | null;
5
+ existingAgentsMd: string | null;
6
+ existingClaudeMd: string | null;
7
+ existingCursorRules: string | null;
8
+ hasExistingClaudeMd: boolean;
9
+ hasExistingAgentsMd: boolean;
10
+ totalTokens: number;
11
+ }
12
+ export declare function scanDocs(projectPath: string): Promise<DocData>;
13
+ //# sourceMappingURL=docs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/scanner/docs.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAyCD,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkCpE"}
@@ -0,0 +1,63 @@
1
+ import path from "node:path";
2
+ import { readFileSafe } from "../lib/file-utils.js";
3
+ import { estimateTokens, truncateToTokenBudget } from "../lib/token-estimate.js";
4
+ const DOC_SPECS = [
5
+ { field: "existingAgentsMd", candidates: ["AGENTS.md"], budget: 3000 },
6
+ { field: "existingClaudeMd", candidates: ["CLAUDE.md"], budget: 2000 },
7
+ { field: "readme", candidates: ["README.md", "readme.md", "README.rst"], budget: 2500 },
8
+ { field: "contributing", candidates: ["CONTRIBUTING.md", "contributing.md"], budget: 1000 },
9
+ {
10
+ field: "architecture",
11
+ candidates: [
12
+ "ARCHITECTURE.md",
13
+ "architecture.md",
14
+ "docs/ARCHITECTURE.md",
15
+ "docs/architecture.md",
16
+ ],
17
+ budget: 1500,
18
+ },
19
+ { field: "existingCursorRules", candidates: [".cursorrules"], budget: 500 },
20
+ ];
21
+ async function readFirstMatch(projectPath, candidates, budget) {
22
+ for (const candidate of candidates) {
23
+ const raw = await readFileSafe(path.join(projectPath, candidate));
24
+ if (raw !== null) {
25
+ const { text } = truncateToTokenBudget(raw, budget);
26
+ return text;
27
+ }
28
+ }
29
+ return null;
30
+ }
31
+ export async function scanDocs(projectPath) {
32
+ const result = {
33
+ readme: null,
34
+ contributing: null,
35
+ architecture: null,
36
+ existingAgentsMd: null,
37
+ existingClaudeMd: null,
38
+ existingCursorRules: null,
39
+ hasExistingClaudeMd: false,
40
+ hasExistingAgentsMd: false,
41
+ totalTokens: 0,
42
+ };
43
+ for (const spec of DOC_SPECS) {
44
+ try {
45
+ const content = await readFirstMatch(projectPath, spec.candidates, spec.budget);
46
+ result[spec.field] = content;
47
+ }
48
+ catch {
49
+ // leave null
50
+ }
51
+ }
52
+ result.hasExistingClaudeMd = result.existingClaudeMd !== null;
53
+ result.hasExistingAgentsMd = result.existingAgentsMd !== null;
54
+ result.totalTokens =
55
+ estimateTokens(result.readme ?? "") +
56
+ estimateTokens(result.contributing ?? "") +
57
+ estimateTokens(result.architecture ?? "") +
58
+ estimateTokens(result.existingAgentsMd ?? "") +
59
+ estimateTokens(result.existingClaudeMd ?? "") +
60
+ estimateTokens(result.existingCursorRules ?? "");
61
+ return result;
62
+ }
63
+ //# sourceMappingURL=docs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/scanner/docs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ export interface Gotcha {
2
+ file: string;
3
+ line: number;
4
+ type: "HACK" | "FIXME" | "WARNING" | "IMPORTANT" | "TODO" | "NOTE";
5
+ comment: string;
6
+ }
7
+ export declare function scanGotchas(projectPath: string, maxResults?: number): Promise<Gotcha[]>;
8
+ //# sourceMappingURL=gotchas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gotchas.d.ts","sourceRoot":"","sources":["../../src/scanner/gotchas.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;IACnE,OAAO,EAAE,MAAM,CAAC;CACjB;AAmDD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,UAAU,SAAK,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CA6DnB"}
@@ -0,0 +1,107 @@
1
+ import path from "node:path";
2
+ import fg from "fast-glob";
3
+ import { readFileSafe } from "../lib/file-utils.js";
4
+ const IGNORE_PATTERNS = [
5
+ "**/node_modules/**",
6
+ "**/.git/**",
7
+ "**/dist/**",
8
+ "**/build/**",
9
+ "**/__pycache__/**",
10
+ "**/.venv/**",
11
+ "**/target/**",
12
+ "**/.next/**",
13
+ "**/coverage/**",
14
+ "**/.cache/**",
15
+ "**/*.min.js",
16
+ "**/*.gen.*",
17
+ "**/*.d.ts",
18
+ "**/package-lock.json",
19
+ "**/yarn.lock",
20
+ "**/pnpm-lock.yaml",
21
+ "**/Cargo.lock",
22
+ "**/poetry.lock",
23
+ ];
24
+ const TYPE_RANK = {
25
+ HACK: 0,
26
+ FIXME: 1,
27
+ WARNING: 2,
28
+ IMPORTANT: 3,
29
+ TODO: 4,
30
+ NOTE: 5,
31
+ };
32
+ // Regex to match keyword and capture everything after it on the line
33
+ const GOTCHA_REGEX = /\b(HACK|FIXME|WARNING|IMPORTANT|TODO|NOTE)\b[:\s]*(.*)/i;
34
+ function extractComment(rawMatch) {
35
+ // Remove leading comment markers: //, #, *, /*, etc.
36
+ return rawMatch
37
+ .replace(/^[/*#\s]+/, "")
38
+ .replace(/\*\/$/, "")
39
+ .trim();
40
+ }
41
+ function isBinary(content) {
42
+ const probe = content.slice(0, 512);
43
+ return probe.includes("\0");
44
+ }
45
+ export async function scanGotchas(projectPath, maxResults = 20) {
46
+ try {
47
+ const files = await fg("**/*", {
48
+ cwd: projectPath,
49
+ onlyFiles: true,
50
+ ignore: IGNORE_PATTERNS,
51
+ dot: false,
52
+ });
53
+ const found = [];
54
+ const seenComments = new Map(); // text → count
55
+ for (const relPath of files) {
56
+ const absPath = path.join(projectPath, relPath);
57
+ const raw = await readFileSafe(absPath);
58
+ if (!raw)
59
+ continue;
60
+ if (isBinary(raw))
61
+ continue;
62
+ const lines = raw.split("\n");
63
+ for (let i = 0; i < lines.length; i++) {
64
+ const line = lines[i];
65
+ const match = GOTCHA_REGEX.exec(line);
66
+ if (!match)
67
+ continue;
68
+ const type = match[1].toUpperCase();
69
+ const rawComment = match[2] ?? "";
70
+ const comment = extractComment(rawComment);
71
+ if (!comment)
72
+ continue;
73
+ const count = (seenComments.get(comment) ?? 0) + 1;
74
+ seenComments.set(comment, count);
75
+ // Deduplicate: if same text seen 3+ times, skip subsequent occurrences
76
+ if (count >= 3 && count > 1) {
77
+ if (count > 3)
78
+ continue;
79
+ // Keep the first occurrence (count=1 already added), skip count 2+
80
+ continue;
81
+ }
82
+ if (count === 2)
83
+ continue;
84
+ found.push({
85
+ file: relPath,
86
+ line: i + 1,
87
+ type,
88
+ comment,
89
+ });
90
+ }
91
+ }
92
+ // Sort by rank (HACK first, NOTE last), then by file/line for stable order
93
+ found.sort((a, b) => {
94
+ const rankDiff = TYPE_RANK[a.type] - TYPE_RANK[b.type];
95
+ if (rankDiff !== 0)
96
+ return rankDiff;
97
+ if (a.file !== b.file)
98
+ return a.file.localeCompare(b.file);
99
+ return a.line - b.line;
100
+ });
101
+ return found.slice(0, maxResults);
102
+ }
103
+ catch {
104
+ return [];
105
+ }
106
+ }
107
+ //# sourceMappingURL=gotchas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gotchas.js","sourceRoot":"","sources":["../../src/scanner/gotchas.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { type ManifestData } from "./manifest.js";
2
+ import { type StructureData } from "./structure.js";
3
+ import { type SourceData } from "./source.js";
4
+ import { type DocData } from "./docs.js";
5
+ import { type Gotcha } from "./gotchas.js";
6
+ export type { ManifestData, StructureData, SourceData, DocData, Gotcha };
7
+ export interface RawCorpus {
8
+ manifest: ManifestData;
9
+ structure: StructureData;
10
+ source: SourceData;
11
+ docs: DocData;
12
+ gotchas: Gotcha[];
13
+ totalEstimatedTokens: number;
14
+ scanDurationMs: number;
15
+ }
16
+ export interface ScanOptions {
17
+ /** Path to a repomix output file. When provided, replaces filesystem source sampling. */
18
+ repomixPath?: string;
19
+ }
20
+ export declare function scan(projectPath: string, options?: ScanOptions): Promise<RawCorpus>;
21
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAGxD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAEzE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAuDD,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2C7F"}
@@ -0,0 +1,87 @@
1
+ import { scanManifest } from "./manifest.js";
2
+ import { scanStructure } from "./structure.js";
3
+ import { sampleSource } from "./source.js";
4
+ import { scanDocs } from "./docs.js";
5
+ import { scanGotchas } from "./gotchas.js";
6
+ import { parseRepomixOutput } from "./repomix.js";
7
+ const DEFAULT_MANIFEST = {
8
+ language: "unknown",
9
+ framework: null,
10
+ runtime: null,
11
+ packageManager: null,
12
+ dependencies: [],
13
+ devDependencies: [],
14
+ scripts: {},
15
+ projectName: null,
16
+ projectVersion: null,
17
+ };
18
+ const DEFAULT_STRUCTURE = {
19
+ topLevelDirs: [],
20
+ entryPoints: [],
21
+ testDirs: [],
22
+ totalFileCount: 0,
23
+ namingConvention: "mixed",
24
+ tree: ".",
25
+ };
26
+ const DEFAULT_SOURCE = {
27
+ files: [],
28
+ totalTokens: 0,
29
+ importStyle: "unknown",
30
+ detectedPatterns: [],
31
+ };
32
+ const DEFAULT_DOCS = {
33
+ readme: null,
34
+ contributing: null,
35
+ architecture: null,
36
+ existingAgentsMd: null,
37
+ existingClaudeMd: null,
38
+ existingCursorRules: null,
39
+ hasExistingClaudeMd: false,
40
+ hasExistingAgentsMd: false,
41
+ totalTokens: 0,
42
+ };
43
+ const DEBUG = process.env.AGENTS_SYNC_DEBUG === "1";
44
+ async function safeRun(name, fn, fallback) {
45
+ try {
46
+ return await fn();
47
+ }
48
+ catch (e) {
49
+ process.stderr.write(`[agents-sync] Warning: scanner "${name}" failed: ${e.message}\n`);
50
+ return fallback;
51
+ }
52
+ }
53
+ export async function scan(projectPath, options = {}) {
54
+ const start = Date.now();
55
+ // Phase 1: manifest + structure in parallel
56
+ const [manifest, structure] = await Promise.all([
57
+ safeRun("manifest", () => scanManifest(projectPath), DEFAULT_MANIFEST),
58
+ safeRun("structure", () => scanStructure(projectPath), DEFAULT_STRUCTURE),
59
+ ]);
60
+ // Phase 2: source (or repomix) + docs + gotchas in parallel
61
+ const sourceRunner = options.repomixPath
62
+ ? () => parseRepomixOutput(options.repomixPath)
63
+ : () => sampleSource(projectPath);
64
+ const [source, docs, gotchas] = await Promise.all([
65
+ safeRun("source", sourceRunner, DEFAULT_SOURCE),
66
+ safeRun("docs", () => scanDocs(projectPath), DEFAULT_DOCS),
67
+ safeRun("gotchas", () => scanGotchas(projectPath), []),
68
+ ]);
69
+ const scanDurationMs = Date.now() - start;
70
+ const totalEstimatedTokens = source.totalTokens +
71
+ docs.totalTokens +
72
+ // rough estimate for structured data
73
+ Math.ceil(JSON.stringify({ manifest, structure, gotchas }).length / 4);
74
+ if (DEBUG) {
75
+ process.stderr.write(`[agents-sync] Scan complete in ${scanDurationMs}ms, ~${totalEstimatedTokens} tokens\n`);
76
+ }
77
+ return {
78
+ manifest,
79
+ structure,
80
+ source,
81
+ docs,
82
+ gotchas,
83
+ totalEstimatedTokens,
84
+ scanDurationMs,
85
+ };
86
+ }
87
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ export interface ManifestData {
2
+ language: string;
3
+ framework: string | null;
4
+ runtime: string | null;
5
+ packageManager: string | null;
6
+ dependencies: string[];
7
+ devDependencies: string[];
8
+ scripts: Record<string, string>;
9
+ projectName: string | null;
10
+ projectVersion: string | null;
11
+ }
12
+ export declare function scanManifest(projectPath: string): Promise<ManifestData>;
13
+ //# sourceMappingURL=manifest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/scanner/manifest.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAmQD,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAa7E"}
@@ -0,0 +1,285 @@
1
+ import path from "node:path";
2
+ import { readFileSafe } from "../lib/file-utils.js";
3
+ const EMPTY = {
4
+ language: "unknown",
5
+ framework: null,
6
+ runtime: null,
7
+ packageManager: null,
8
+ dependencies: [],
9
+ devDependencies: [],
10
+ scripts: {},
11
+ projectName: null,
12
+ projectVersion: null,
13
+ };
14
+ function detectFrameworkFromDeps(deps) {
15
+ if ("next" in deps)
16
+ return "nextjs";
17
+ if ("express" in deps)
18
+ return "express";
19
+ if ("fastify" in deps)
20
+ return "fastify";
21
+ if ("koa" in deps)
22
+ return "koa";
23
+ if ("hono" in deps)
24
+ return "hono";
25
+ if ("@nestjs/core" in deps)
26
+ return "nestjs";
27
+ if ("nuxt" in deps)
28
+ return "nuxt";
29
+ if ("@sveltejs/kit" in deps)
30
+ return "sveltekit";
31
+ if ("remix" in deps || "@remix-run/node" in deps)
32
+ return "remix";
33
+ if ("astro" in deps)
34
+ return "astro";
35
+ return null;
36
+ }
37
+ function detectPackageManager(raw) {
38
+ if (raw) {
39
+ try {
40
+ const pkg = JSON.parse(raw);
41
+ if (pkg.packageManager) {
42
+ const pm = String(pkg.packageManager);
43
+ if (pm.startsWith("pnpm"))
44
+ return "pnpm";
45
+ if (pm.startsWith("yarn"))
46
+ return "yarn";
47
+ if (pm.startsWith("npm"))
48
+ return "npm";
49
+ if (pm.startsWith("bun"))
50
+ return "bun";
51
+ }
52
+ }
53
+ catch {
54
+ // ignore
55
+ }
56
+ }
57
+ return null;
58
+ }
59
+ function depsToStrings(deps, limit) {
60
+ return Object.entries(deps)
61
+ .slice(0, limit)
62
+ .map(([name, version]) => `${name}@${version}`);
63
+ }
64
+ async function fromPackageJson(projectPath) {
65
+ const raw = await readFileSafe(path.join(projectPath, "package.json"));
66
+ if (!raw)
67
+ return null;
68
+ try {
69
+ const pkg = JSON.parse(raw);
70
+ const deps = (pkg.dependencies ?? {});
71
+ const devDeps = (pkg.devDependencies ?? {});
72
+ const scripts = (pkg.scripts ?? {});
73
+ const isTypeScript = "typescript" in devDeps || "typescript" in deps;
74
+ const language = isTypeScript ? "typescript" : "javascript";
75
+ const allDeps = { ...deps };
76
+ const framework = detectFrameworkFromDeps(allDeps);
77
+ // Detect Node version from engines field
78
+ let runtime = null;
79
+ const engines = pkg.engines;
80
+ if (engines?.node) {
81
+ runtime = `node ${engines.node}`;
82
+ }
83
+ // Package manager: packageManager field or detect from devDeps
84
+ let packageManager = detectPackageManager(raw);
85
+ if (!packageManager) {
86
+ // Check common indicators in devDeps
87
+ if ("pnpm" in devDeps)
88
+ packageManager = "pnpm";
89
+ else if ("yarn" in devDeps)
90
+ packageManager = "yarn";
91
+ else
92
+ packageManager = "npm";
93
+ }
94
+ return {
95
+ language,
96
+ framework,
97
+ runtime,
98
+ packageManager,
99
+ dependencies: depsToStrings(deps, 25),
100
+ devDependencies: depsToStrings(devDeps, 15),
101
+ scripts,
102
+ projectName: typeof pkg.name === "string" ? pkg.name : null,
103
+ projectVersion: typeof pkg.version === "string" ? pkg.version : null,
104
+ };
105
+ }
106
+ catch {
107
+ return { ...EMPTY, language: "javascript" };
108
+ }
109
+ }
110
+ function parsePyprojectLine(lines, key) {
111
+ for (const line of lines) {
112
+ const trimmed = line.trim();
113
+ if (trimmed.startsWith(`${key} =`) || trimmed.startsWith(`${key}=`)) {
114
+ const idx = trimmed.indexOf("=");
115
+ return trimmed.slice(idx + 1).trim().replace(/^["']|["']$/g, "");
116
+ }
117
+ }
118
+ return null;
119
+ }
120
+ function parsePyprojectDeps(lines) {
121
+ const deps = [];
122
+ let inDeps = false;
123
+ for (const line of lines) {
124
+ const trimmed = line.trim();
125
+ if (trimmed === "dependencies = [" || trimmed === "dependencies=[") {
126
+ inDeps = true;
127
+ continue;
128
+ }
129
+ if (inDeps) {
130
+ if (trimmed === "]")
131
+ break;
132
+ const dep = trimmed.replace(/^["']|["',]*$/g, "").trim();
133
+ if (dep)
134
+ deps.push(dep);
135
+ }
136
+ }
137
+ return deps;
138
+ }
139
+ async function fromPyproject(projectPath) {
140
+ const raw = await readFileSafe(path.join(projectPath, "pyproject.toml"));
141
+ if (!raw)
142
+ return null;
143
+ try {
144
+ const lines = raw.split("\n");
145
+ const name = parsePyprojectLine(lines, "name");
146
+ const version = parsePyprojectLine(lines, "version");
147
+ const requiresPython = parsePyprojectLine(lines, "requires-python");
148
+ const runtime = requiresPython ? `python ${requiresPython.replace(/[^0-9.]/g, "").slice(0, 6)}` : null;
149
+ const deps = parsePyprojectDeps(lines);
150
+ const depsLower = deps.map((d) => d.toLowerCase());
151
+ let framework = null;
152
+ if (depsLower.some((d) => d.startsWith("fastapi")))
153
+ framework = "fastapi";
154
+ else if (depsLower.some((d) => d.startsWith("django")))
155
+ framework = "django";
156
+ else if (depsLower.some((d) => d.startsWith("flask")))
157
+ framework = "flask";
158
+ return {
159
+ language: "python",
160
+ framework,
161
+ runtime,
162
+ packageManager: "pip",
163
+ dependencies: deps.slice(0, 25),
164
+ devDependencies: [],
165
+ scripts: {},
166
+ projectName: name,
167
+ projectVersion: version,
168
+ };
169
+ }
170
+ catch {
171
+ return { ...EMPTY, language: "python" };
172
+ }
173
+ }
174
+ async function fromCargoToml(projectPath) {
175
+ const raw = await readFileSafe(path.join(projectPath, "Cargo.toml"));
176
+ if (!raw)
177
+ return null;
178
+ try {
179
+ const lines = raw.split("\n");
180
+ const name = parsePyprojectLine(lines, "name");
181
+ const version = parsePyprojectLine(lines, "version");
182
+ const deps = [];
183
+ let inDeps = false;
184
+ for (const line of lines) {
185
+ const trimmed = line.trim();
186
+ if (trimmed === "[dependencies]") {
187
+ inDeps = true;
188
+ continue;
189
+ }
190
+ if (inDeps) {
191
+ if (trimmed.startsWith("["))
192
+ break;
193
+ const eqIdx = trimmed.indexOf("=");
194
+ if (eqIdx > 0) {
195
+ const depName = trimmed.slice(0, eqIdx).trim();
196
+ const depVal = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
197
+ if (depName)
198
+ deps.push(`${depName}@${depVal}`);
199
+ }
200
+ }
201
+ }
202
+ const rawContent = raw.toLowerCase();
203
+ let framework = null;
204
+ if (rawContent.includes("axum"))
205
+ framework = "axum";
206
+ else if (rawContent.includes("actix-web"))
207
+ framework = "actix";
208
+ return {
209
+ language: "rust",
210
+ framework,
211
+ runtime: null,
212
+ packageManager: "cargo",
213
+ dependencies: deps.slice(0, 25),
214
+ devDependencies: [],
215
+ scripts: {},
216
+ projectName: name,
217
+ projectVersion: version,
218
+ };
219
+ }
220
+ catch {
221
+ return { ...EMPTY, language: "rust" };
222
+ }
223
+ }
224
+ async function fromGoMod(projectPath) {
225
+ const raw = await readFileSafe(path.join(projectPath, "go.mod"));
226
+ if (!raw)
227
+ return null;
228
+ try {
229
+ const lines = raw.split("\n");
230
+ let moduleName = null;
231
+ let goVersion = null;
232
+ const deps = [];
233
+ for (const line of lines) {
234
+ const trimmed = line.trim();
235
+ if (trimmed.startsWith("module ")) {
236
+ moduleName = trimmed.slice(7).trim();
237
+ }
238
+ else if (trimmed.startsWith("go ")) {
239
+ goVersion = `go ${trimmed.slice(3).trim()}`;
240
+ }
241
+ else if (trimmed && !trimmed.startsWith("//") && trimmed.includes(" ")) {
242
+ // require block entries
243
+ const parts = trimmed.split(/\s+/);
244
+ if (parts.length >= 2 && !parts[0].startsWith("(") && !parts[0].startsWith(")")) {
245
+ deps.push(`${parts[0]}@${parts[1]}`);
246
+ }
247
+ }
248
+ }
249
+ const rawContent = raw.toLowerCase();
250
+ let framework = null;
251
+ if (rawContent.includes("github.com/gin-gonic/gin"))
252
+ framework = "gin";
253
+ else if (rawContent.includes("github.com/labstack/echo"))
254
+ framework = "echo";
255
+ return {
256
+ language: "go",
257
+ framework,
258
+ runtime: goVersion,
259
+ packageManager: null,
260
+ dependencies: deps.slice(0, 25),
261
+ devDependencies: [],
262
+ scripts: {},
263
+ projectName: moduleName,
264
+ projectVersion: null,
265
+ };
266
+ }
267
+ catch {
268
+ return { ...EMPTY, language: "go" };
269
+ }
270
+ }
271
+ export async function scanManifest(projectPath) {
272
+ try {
273
+ const result = (await fromPackageJson(projectPath)) ??
274
+ (await fromPyproject(projectPath)) ??
275
+ (await fromCargoToml(projectPath)) ??
276
+ (await fromGoMod(projectPath));
277
+ if (result)
278
+ return result;
279
+ return { ...EMPTY };
280
+ }
281
+ catch {
282
+ return { ...EMPTY };
283
+ }
284
+ }
285
+ //# sourceMappingURL=manifest.js.map