@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.
- package/LICENSE +21 -0
- package/README.md +366 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +237 -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 +41 -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 +124 -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 +117 -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 +3 -0
- package/dist/generator/agents-md.d.ts.map +1 -0
- package/dist/generator/agents-md.js +127 -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 +21 -0
- package/dist/scanner/index.d.ts.map +1 -0
- package/dist/scanner/index.js +87 -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 +212 -0
- package/dist/server.js.map +1 -0
- package/dist/snapshot/drift.d.ts +22 -0
- package/dist/snapshot/drift.d.ts.map +1 -0
- package/dist/snapshot/drift.js +105 -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 +31 -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/install-hook.d.ts +15 -0
- package/dist/tools/install-hook.d.ts.map +1 -0
- package/dist/tools/install-hook.js +169 -0
- package/dist/tools/install-hook.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/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 @@
|
|
|
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
|