@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,213 @@
1
+ /**
2
+ * agents-sync lint
3
+ *
4
+ * Parses the Never/Always/Boundaries sections of AGENTS.md and checks whether
5
+ * the codebase violates any mechanically-verifiable rules.
6
+ *
7
+ * Design principles:
8
+ * - Only report high-confidence violations (prefer false-negatives over false-positives)
9
+ * - Rules we cannot check are skipped gracefully, not errored
10
+ * - No AST parser required — grep-level checks only
11
+ */
12
+ import path from "node:path";
13
+ import fs from "node:fs/promises";
14
+ import fg from "fast-glob";
15
+ import { assertProjectDir, readFileSafe } from "../lib/file-utils.js";
16
+ // ─── Source file patterns ─────────────────────────────────────────────────────
17
+ const SOURCE_GLOBS = [
18
+ "**/*.{ts,tsx,js,jsx,mjs,cjs}",
19
+ "**/*.{py,rb,go,rs,java,kt,swift,php,cs}",
20
+ ];
21
+ const IGNORE_PATTERNS = [
22
+ "**/node_modules/**",
23
+ "**/.git/**",
24
+ "**/dist/**",
25
+ "**/build/**",
26
+ "**/__pycache__/**",
27
+ "**/.venv/**",
28
+ "**/target/**",
29
+ "**/.next/**",
30
+ "**/coverage/**",
31
+ "**/*.min.js",
32
+ "**/*.d.ts",
33
+ ];
34
+ const CHECKERS = [
35
+ // ── console.log ──────────────────────────────────────────────────────────────
36
+ {
37
+ matches: (r) => /console\.log/i.test(r),
38
+ check: async (_rule, _project, files) => grepFiles(files, /console\.log\s*\(/, ["**/*.test.*", "**/*.spec.*", "**/scripts/**"]),
39
+ },
40
+ // ── TypeScript `any` ─────────────────────────────────────────────────────────
41
+ {
42
+ matches: (r) => /\bany\b/.test(r) && /typescript|ts\b/i.test(r),
43
+ check: async (_rule, _project, files) => grepFiles(files.filter((f) => /\.(ts|tsx)$/.test(f.relPath)), /:\s*any\b/, ["**/*.test.*", "**/*.spec.*", "**/*.d.ts"]),
44
+ },
45
+ // ── `any` without qualifier (e.g. "never use `any`") ──────────────────────
46
+ {
47
+ matches: (r) => /\`any\`|"any"|use\s+any\b|type\s+any\b/i.test(r),
48
+ check: async (_rule, _project, files) => grepFiles(files.filter((f) => /\.(ts|tsx)$/.test(f.relPath)), /:\s*any\b/, ["**/*.test.*", "**/*.spec.*", "**/*.d.ts"]),
49
+ },
50
+ // ── Direct import of a named symbol ─────────────────────────────────────────
51
+ // Detects rules like "never import PrismaClient directly" or "never import X from Y"
52
+ {
53
+ matches: (r) => /import.+directly|never\s+import\s+\w|import\s+\w+\s+from/i.test(r),
54
+ check: async (rule, _project, files) => {
55
+ // Extract the symbol name (CamelCase word after "import")
56
+ const symbolMatch = /import\s+[`'"]?(\w+)[`'"]?\s+directly/i.exec(rule) ??
57
+ /never\s+import\s+[`'"]?(\w+)[`'"]?/i.exec(rule);
58
+ if (!symbolMatch)
59
+ return [];
60
+ const symbol = symbolMatch[1];
61
+ // Also try to extract the safe path (text inside parentheses or after "use")
62
+ const safePathMatch = /\(use\s+([^\)]+)\)|use\s+`([^`]+)`/i.exec(rule);
63
+ const safePath = safePathMatch?.[1] ?? safePathMatch?.[2];
64
+ return grepFiles(files, new RegExp(`import.*\\b${symbol}\\b.*from`), [], safePath ? [new RegExp(safePath.replace(/\//g, "\\/"))] : []);
65
+ },
66
+ },
67
+ // ── Default exports ──────────────────────────────────────────────────────────
68
+ {
69
+ matches: (r) => /default\s+export|export\s+default/i.test(r) && /never|no\s+default/i.test(r),
70
+ check: async (_rule, _project, files) => grepFiles(files.filter((f) => /\.(ts|tsx|js|jsx)$/.test(f.relPath)), /^export\s+default\b/m,
71
+ // Next.js pages and layouts are always allowed to use default exports
72
+ ["**/app/**", "**/pages/**"]),
73
+ },
74
+ // ── .env commit guard ────────────────────────────────────────────────────────
75
+ {
76
+ matches: (r) => /\.env/i.test(r) && /commit|git/i.test(r),
77
+ check: async (_rule, projectPath) => {
78
+ const gitignorePath = path.join(projectPath, ".gitignore");
79
+ const gitignore = await readFileSafe(gitignorePath);
80
+ if (!gitignore) {
81
+ return [{ file: ".gitignore", line: 0, text: ".gitignore not found — .env may not be protected" }];
82
+ }
83
+ const hasEnvEntry = /^\.env/m.test(gitignore);
84
+ if (!hasEnvEntry) {
85
+ return [{ file: ".gitignore", line: 0, text: '.env is not listed in .gitignore' }];
86
+ }
87
+ return [];
88
+ },
89
+ },
90
+ // ── process.env direct access (when convention says "use config module") ───
91
+ {
92
+ matches: (r) => /process\.env/i.test(r) && /never|directly/i.test(r),
93
+ check: async (_rule, _project, files) => grepFiles(files.filter((f) => /\.(ts|tsx|js|jsx)$/.test(f.relPath)), /process\.env\.\w+/, ["**/config/**", "**/*.config.*", "**/env.ts", "**/env.js"]),
94
+ },
95
+ ];
96
+ // ─── Grep helpers ─────────────────────────────────────────────────────────────
97
+ function grepFiles(files, pattern, skipGlobs = [], excludePatterns = []) {
98
+ const violations = [];
99
+ outer: for (const f of files) {
100
+ for (const skip of skipGlobs) {
101
+ // Strip glob wildcards and leading/trailing slashes, then do substring check
102
+ const seg = skip.replace(/\*\*/g, "").replace(/\*/g, "").replace(/^\/+|\/+$/g, "").replace(/\/+/g, "/");
103
+ if (seg && f.relPath.includes(seg))
104
+ continue outer;
105
+ }
106
+ for (let i = 0; i < f.lines.length; i++) {
107
+ const line = f.lines[i];
108
+ if (!pattern.test(line))
109
+ continue;
110
+ // If this line matches an exclusion pattern, skip it
111
+ if (excludePatterns.some((ex) => ex.test(line)))
112
+ continue;
113
+ violations.push({ file: f.relPath, line: i + 1, text: line.trim() });
114
+ if (violations.length >= 20)
115
+ return violations; // cap per-rule
116
+ }
117
+ }
118
+ return violations;
119
+ }
120
+ // ─── AGENTS.md parser ─────────────────────────────────────────────────────────
121
+ function extractNeverRules(agentsMdContent) {
122
+ const rules = [];
123
+ // Find the Never section (handles ### Never, ## Never, **Never**, etc.)
124
+ const neverMatch = /#{1,3}\s*Never\b([^#]*)/i.exec(agentsMdContent);
125
+ if (!neverMatch)
126
+ return rules;
127
+ const section = neverMatch[1];
128
+ for (const line of section.split("\n")) {
129
+ const item = line.replace(/^[-*•]\s*/, "").trim();
130
+ if (item.length > 4 && item.length < 300)
131
+ rules.push(item);
132
+ }
133
+ return rules;
134
+ }
135
+ // ─── Main ─────────────────────────────────────────────────────────────────────
136
+ export async function runLint(options) {
137
+ const { projectPath } = options;
138
+ await assertProjectDir(projectPath);
139
+ // Read AGENTS.md
140
+ const agentsMdPath = path.join(projectPath, "AGENTS.md");
141
+ const agentsMd = await readFileSafe(agentsMdPath);
142
+ if (!agentsMd) {
143
+ const report = "✗ AGENTS.md not found. Run agents-sync init first.";
144
+ return { checks: [], totalViolations: 0, report, passed: false };
145
+ }
146
+ const neverRules = extractNeverRules(agentsMd);
147
+ if (neverRules.length === 0) {
148
+ const report = "No 'Never' rules found in AGENTS.md — nothing to lint.";
149
+ return { checks: [], totalViolations: 0, report, passed: true };
150
+ }
151
+ // Load source files once (shared across all checks)
152
+ const relPaths = await fg(SOURCE_GLOBS, {
153
+ cwd: projectPath,
154
+ onlyFiles: true,
155
+ ignore: IGNORE_PATTERNS,
156
+ dot: false,
157
+ });
158
+ const sourceFiles = [];
159
+ for (const relPath of relPaths) {
160
+ const absPath = path.join(projectPath, relPath);
161
+ const content = await fs.readFile(absPath, "utf-8").catch(() => null);
162
+ if (!content || content.includes("\0"))
163
+ continue;
164
+ sourceFiles.push({ relPath, absPath, lines: content.split("\n") });
165
+ }
166
+ // Run checks
167
+ const checks = [];
168
+ for (const rule of neverRules) {
169
+ const checker = CHECKERS.find((c) => c.matches(rule));
170
+ if (!checker) {
171
+ checks.push({ rule, checkable: false, violations: [], skippedReason: "No automated check available" });
172
+ continue;
173
+ }
174
+ const violations = await checker.check(rule, projectPath, sourceFiles);
175
+ checks.push({ rule, checkable: true, violations });
176
+ }
177
+ const totalViolations = checks.reduce((n, c) => n + c.violations.length, 0);
178
+ const passed = totalViolations === 0;
179
+ const report = buildReport(checks, totalViolations);
180
+ return { checks, totalViolations, report, passed };
181
+ }
182
+ function buildReport(checks, totalViolations) {
183
+ const NO_COLOR = process.env.NO_COLOR === "1";
184
+ const c = (code, t) => (NO_COLOR ? t : `\x1b[${code}m${t}\x1b[0m`);
185
+ const lines = [];
186
+ lines.push(c("1", "agents-sync lint\n"));
187
+ for (const check of checks) {
188
+ if (!check.checkable) {
189
+ lines.push(`${c("2", "─")} ${c("2", check.rule)}`);
190
+ lines.push(` ${c("2", `↳ skipped: ${check.skippedReason}`)}`);
191
+ continue;
192
+ }
193
+ if (check.violations.length === 0) {
194
+ lines.push(`${c("32", "✓")} ${check.rule}`);
195
+ }
196
+ else {
197
+ lines.push(`${c("31;1", "✗")} ${check.rule} — ${c("31", String(check.violations.length))} violation${check.violations.length === 1 ? "" : "s"}`);
198
+ for (const v of check.violations) {
199
+ const loc = `${v.file}:${v.line}`.padEnd(45);
200
+ lines.push(` ${c("33", loc)} ${c("2", v.text.slice(0, 80))}`);
201
+ }
202
+ }
203
+ lines.push("");
204
+ }
205
+ if (totalViolations === 0) {
206
+ lines.push(c("32;1", "✓ No violations found."));
207
+ }
208
+ else {
209
+ lines.push(c("31;1", `${totalViolations} violation${totalViolations === 1 ? "" : "s"} found.`));
210
+ }
211
+ return lines.join("\n");
212
+ }
213
+ //# sourceMappingURL=lint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/tools/lint.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export interface ScanReportOptions {
2
+ projectPath: string;
3
+ }
4
+ export interface ScanReportResult {
5
+ report: string;
6
+ language: string;
7
+ framework: string | null;
8
+ dependencyCount: number;
9
+ mcpCount: number;
10
+ skillCount: number;
11
+ gotchaCount: number;
12
+ }
13
+ export declare function runScanReport(options: ScanReportOptions): Promise<ScanReportResult>;
14
+ //# sourceMappingURL=scan-report.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scan-report.d.ts","sourceRoot":"","sources":["../../src/tools/scan-report.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkIzF"}
@@ -0,0 +1,136 @@
1
+ /**
2
+ * agents-sync scan
3
+ *
4
+ * Read-only, no Claude API call. Runs the full scanner and prints what it
5
+ * found — language, framework, dependencies, structure, MCPs, local skills,
6
+ * gotchas. Lets developers verify the scanner works before committing to init.
7
+ */
8
+ import path from "node:path";
9
+ import { assertProjectDir } from "../lib/file-utils.js";
10
+ import { scan } from "../scanner/index.js";
11
+ import { scanProjectSkills } from "../scanner/skills.js";
12
+ export async function runScanReport(options) {
13
+ const { projectPath } = options;
14
+ await assertProjectDir(projectPath);
15
+ const [corpus, skillsSummary] = await Promise.all([
16
+ scan(projectPath),
17
+ scanProjectSkills(projectPath),
18
+ ]);
19
+ const NO_COLOR = process.env.NO_COLOR === "1";
20
+ const c = (code, t) => (NO_COLOR ? t : `\x1b[${code}m${t}\x1b[0m`);
21
+ const lines = [];
22
+ lines.push(c("1", `agents-sync scan — ${path.basename(projectPath)}\n`));
23
+ // Project identity
24
+ lines.push(c("1;34", "▸ Project"));
25
+ lines.push(` Language: ${corpus.manifest.language}`);
26
+ if (corpus.manifest.framework)
27
+ lines.push(` Framework: ${corpus.manifest.framework}`);
28
+ if (corpus.manifest.runtime)
29
+ lines.push(` Runtime: ${corpus.manifest.runtime}`);
30
+ if (corpus.manifest.projectName)
31
+ lines.push(` Name: ${corpus.manifest.projectName}`);
32
+ if (corpus.manifest.packageManager)
33
+ lines.push(` Pkg manager: ${corpus.manifest.packageManager}`);
34
+ lines.push("");
35
+ // Dependencies
36
+ const depCount = corpus.manifest.dependencies.length;
37
+ const devDepCount = corpus.manifest.devDependencies.length;
38
+ lines.push(c("1;34", "▸ Dependencies"));
39
+ lines.push(` ${depCount} production, ${devDepCount} dev`);
40
+ if (depCount > 0) {
41
+ lines.push(` Notable: ${corpus.manifest.dependencies.slice(0, 8).join(", ")}${depCount > 8 ? ` +${depCount - 8} more` : ""}`);
42
+ }
43
+ lines.push("");
44
+ // Structure
45
+ lines.push(c("1;34", "▸ Structure"));
46
+ lines.push(` Top-level dirs: ${corpus.structure.topLevelDirs.join(", ") || "(none)"}`);
47
+ lines.push(` Total files: ~${corpus.structure.totalFileCount}`);
48
+ if (corpus.structure.entryPoints.length > 0) {
49
+ lines.push(` Entry points: ${corpus.structure.entryPoints.join(", ")}`);
50
+ }
51
+ if (corpus.structure.testDirs.length > 0) {
52
+ lines.push(` Test dirs: ${corpus.structure.testDirs.join(", ")}`);
53
+ }
54
+ lines.push("");
55
+ // Scripts
56
+ const scripts = Object.entries(corpus.manifest.scripts);
57
+ if (scripts.length > 0) {
58
+ lines.push(c("1;34", "▸ Scripts"));
59
+ for (const [name, cmd] of scripts.slice(0, 6)) {
60
+ lines.push(` ${name.padEnd(12)} ${cmd}`);
61
+ }
62
+ lines.push("");
63
+ }
64
+ // MCPs
65
+ if (corpus.mcp.hasAny) {
66
+ lines.push(c("1;34", "▸ MCP Servers (.claude/settings.json)"));
67
+ for (const s of corpus.mcp.servers) {
68
+ lines.push(` ${c("32", "✓")} ${s.name} — ${s.description}`);
69
+ }
70
+ lines.push("");
71
+ }
72
+ // Local skills / commands
73
+ if (skillsSummary.hasAny) {
74
+ lines.push(c("1;34", "▸ Local Skills & Commands"));
75
+ for (const cmd of skillsSummary.commands) {
76
+ lines.push(` ${c("32", "✓")} /${cmd.name} — ${cmd.description}`);
77
+ }
78
+ for (const skill of skillsSummary.skills) {
79
+ lines.push(` ${c("32", "✓")} ${skill.name} — ${skill.description}`);
80
+ }
81
+ lines.push("");
82
+ }
83
+ // Gotchas
84
+ if (corpus.gotchas.length > 0) {
85
+ lines.push(c("1;34", "▸ Gotchas found in source"));
86
+ for (const g of corpus.gotchas.slice(0, 5)) {
87
+ lines.push(` ${c("33", g.type)} ${g.file}:${g.line} — ${g.comment.slice(0, 70)}`);
88
+ }
89
+ if (corpus.gotchas.length > 5) {
90
+ lines.push(` ... and ${corpus.gotchas.length - 5} more`);
91
+ }
92
+ lines.push("");
93
+ }
94
+ // codegraph
95
+ if (corpus.codegraph.available) {
96
+ lines.push(c("1;34", "▸ codegraph (.codegraph/)"));
97
+ lines.push(` ${corpus.codegraph.communities.length} communities, ${corpus.codegraph.hubNodes.length} hub nodes detected`);
98
+ lines.push("");
99
+ }
100
+ // Existing docs
101
+ const docs = [];
102
+ if (corpus.docs.existingAgentsMd)
103
+ docs.push("AGENTS.md");
104
+ if (corpus.docs.existingClaudeMd)
105
+ docs.push("CLAUDE.md");
106
+ if (corpus.docs.existingCursorRules)
107
+ docs.push(".cursorrules");
108
+ if (corpus.docs.readme)
109
+ docs.push("README.md");
110
+ if (docs.length > 0) {
111
+ lines.push(c("1;34", "▸ Existing docs"));
112
+ lines.push(` ${docs.join(", ")}`);
113
+ lines.push("");
114
+ }
115
+ lines.push(c("2", `Scanned in ${corpus.scanDurationMs}ms · ~${corpus.totalEstimatedTokens.toLocaleString()} tokens of context`));
116
+ lines.push("");
117
+ if (!corpus.docs.existingAgentsMd) {
118
+ lines.push(c("1", "→ Ready to init. Run:"));
119
+ lines.push(` ${c("32", "ANTHROPIC_API_KEY=<key> npx @googlarz/agents-sync init .")}`);
120
+ lines.push(` ${c("2", "Get a key: https://console.anthropic.com/")}`);
121
+ }
122
+ else {
123
+ lines.push(c("1", "→ AGENTS.md found. Check drift:"));
124
+ lines.push(` ${c("32", "npx @googlarz/agents-sync drift .")}`);
125
+ }
126
+ return {
127
+ report: lines.join("\n"),
128
+ language: corpus.manifest.language,
129
+ framework: corpus.manifest.framework,
130
+ dependencyCount: depCount,
131
+ mcpCount: corpus.mcp.servers.length,
132
+ skillCount: skillsSummary.commands.length + skillsSummary.skills.length,
133
+ gotchaCount: corpus.gotchas.length,
134
+ };
135
+ }
136
+ //# sourceMappingURL=scan-report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scan-report.js","sourceRoot":"","sources":["../../src/tools/scan-report.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ export interface StatusOptions {
2
+ projectPath: string;
3
+ }
4
+ export interface StatusResult {
5
+ hasSnapshot: boolean;
6
+ lastSyncedAt: string | null;
7
+ daysSinceSync: number | null;
8
+ filesManaged: {
9
+ tool: string;
10
+ path: string;
11
+ }[];
12
+ language: string | null;
13
+ framework: string | null;
14
+ driftScore: "unknown" | "stale" | "ok";
15
+ recommendation: string;
16
+ }
17
+ export declare function runStatus(options: StatusOptions): Promise<StatusResult>;
18
+ //# sourceMappingURL=status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA0C7E"}
@@ -0,0 +1,38 @@
1
+ import { assertProjectDir, fileExists } from "../lib/file-utils.js";
2
+ import { loadSnapshot } from "../snapshot/writer.js";
3
+ import path from "node:path";
4
+ export async function runStatus(options) {
5
+ await assertProjectDir(options.projectPath);
6
+ const snapshot = await loadSnapshot(options.projectPath);
7
+ if (!snapshot) {
8
+ const agentsMdExists = await fileExists(path.join(options.projectPath, "AGENTS.md"));
9
+ return {
10
+ hasSnapshot: false,
11
+ lastSyncedAt: null,
12
+ daysSinceSync: null,
13
+ filesManaged: [],
14
+ language: null,
15
+ framework: null,
16
+ driftScore: "unknown",
17
+ recommendation: agentsMdExists
18
+ ? "AGENTS.md found but no snapshot. Run /agents-sync init to create a managed sync."
19
+ : "Not initialized. Run /agents-sync init to get started.",
20
+ };
21
+ }
22
+ const daysSinceSync = Math.floor((Date.now() - new Date(snapshot.syncedAt).getTime()) / (1000 * 60 * 60 * 24));
23
+ const driftScore = daysSinceSync > 30 ? "stale" : "ok";
24
+ const recommendation = driftScore === "stale"
25
+ ? `Last synced ${daysSinceSync} days ago — run /agents-sync drift to check for changes.`
26
+ : `Synced ${daysSinceSync} day${daysSinceSync === 1 ? "" : "s"} ago. Run /agents-sync drift to check for changes.`;
27
+ return {
28
+ hasSnapshot: true,
29
+ lastSyncedAt: snapshot.syncedAt,
30
+ daysSinceSync,
31
+ filesManaged: snapshot.filesManaged.map((f) => ({ tool: f.tool, path: f.path })),
32
+ language: snapshot.meta.language,
33
+ framework: snapshot.meta.framework,
34
+ driftScore,
35
+ recommendation,
36
+ };
37
+ }
38
+ //# sourceMappingURL=status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAiB7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QACrF,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,IAAI;YACnB,YAAY,EAAE,EAAE;YAChB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,SAAS;YACrB,cAAc,EAAE,cAAc;gBAC5B,CAAC,CAAC,kFAAkF;gBACpF,CAAC,CAAC,wDAAwD;SAC7D,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAC9B,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAC7E,CAAC;IAEF,MAAM,UAAU,GAAG,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvD,MAAM,cAAc,GAClB,UAAU,KAAK,OAAO;QACpB,CAAC,CAAC,eAAe,aAAa,0DAA0D;QACxF,CAAC,CAAC,UAAU,aAAa,OAAO,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,oDAAoD,CAAC;IAEvH,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,QAAQ,CAAC,QAAQ;QAC/B,aAAa;QACb,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ;QAChC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;QAClC,UAAU;QACV,cAAc;KACf,CAAC;AACJ,CAAC"}
@@ -0,0 +1,22 @@
1
+ import { type ToolName } from "../derivers/index.js";
2
+ export interface SyncOptions {
3
+ projectPath: string;
4
+ tools?: ToolName[];
5
+ fast?: boolean;
6
+ dryRun?: boolean;
7
+ /** Path to a repomix output file to use as source corpus instead of filesystem sampling. */
8
+ repomixOutput?: string;
9
+ }
10
+ export interface SyncResult {
11
+ success: boolean;
12
+ filesUpdated: {
13
+ tool: string;
14
+ path: string;
15
+ }[];
16
+ customSectionsPreserved: number;
17
+ warnings: string[];
18
+ skippedExtraction: boolean;
19
+ dryRun: boolean;
20
+ }
21
+ export declare function runSync(options: SyncOptions): Promise<SyncResult>;
22
+ //# sourceMappingURL=sync.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/tools/sync.ts"],"names":[],"mappings":"AAQA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAMhE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,uBAAuB,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgIvE"}
@@ -0,0 +1,123 @@
1
+ import path from "node:path";
2
+ import { assertProjectDir, readFileSafe, writeFileAtomic } from "../lib/file-utils.js";
3
+ import { AgentsSyncError } from "../lib/errors.js";
4
+ import { scan } from "../scanner/index.js";
5
+ import { extractMetadata } from "../extractor/extractor.js";
6
+ import { generateAgentsMd } from "../generator/agents-md.js";
7
+ import { validateAgentsMd } from "../generator/validator.js";
8
+ import { deriveAll } from "../derivers/index.js";
9
+ import { buildSnapshot, loadSnapshot, saveSnapshot, sha256 } from "../snapshot/writer.js";
10
+ import { detectDrift } from "../snapshot/drift.js";
11
+ import { loadConfig, applyConfig } from "../config/loader.js";
12
+ export async function runSync(options) {
13
+ const { projectPath, tools, fast = false, dryRun = false, repomixOutput } = options;
14
+ await assertProjectDir(projectPath);
15
+ // 1. Load team config (agents-sync.config.json) — non-fatal if missing
16
+ const config = await loadConfig(projectPath);
17
+ // 2. Resolve effective tool list: CLI flag > config > default (all)
18
+ const effectiveTools = tools ?? config?.tools;
19
+ // 3. Scan always (optionally using repomix output as source corpus)
20
+ const corpus = await scan(projectPath, { repomixPath: repomixOutput });
21
+ // 2. Fast mode: check drift, skip extraction if only LOW signals
22
+ let skipExtraction = false;
23
+ if (fast) {
24
+ const snapshot = await loadSnapshot(projectPath);
25
+ if (snapshot) {
26
+ const drift = detectDrift(snapshot, corpus);
27
+ if (drift.maxSeverity === "LOW" || drift.maxSeverity === "NONE") {
28
+ skipExtraction = true;
29
+ }
30
+ }
31
+ }
32
+ let agentsMd;
33
+ if (skipExtraction) {
34
+ // Use existing AGENTS.md
35
+ const existing = await readFileSafe(path.join(projectPath, "AGENTS.md"));
36
+ if (!existing) {
37
+ throw new AgentsSyncError("NO_SNAPSHOT", "No existing AGENTS.md found. Cannot use --fast on first run.", "Run /agents-sync init first.");
38
+ }
39
+ agentsMd = existing;
40
+ }
41
+ else {
42
+ // Full re-extraction
43
+ const rawMetadata = await extractMetadata(corpus);
44
+ const metadata = applyConfig(rawMetadata, config);
45
+ agentsMd = await generateAgentsMd(metadata);
46
+ const validation = validateAgentsMd(agentsMd, corpus.structure.topLevelDirs);
47
+ if (!dryRun) {
48
+ await writeFileAtomic(path.join(projectPath, "AGENTS.md"), agentsMd);
49
+ }
50
+ // Derive all tool files
51
+ const derivations = await deriveAll({
52
+ projectPath,
53
+ agentsMdContent: agentsMd,
54
+ metadata,
55
+ tools: effectiveTools,
56
+ dryRun,
57
+ });
58
+ const warnings = [...validation.warnings];
59
+ for (const d of derivations) {
60
+ if (d.error)
61
+ warnings.push(`${d.tool}: ${d.error}`);
62
+ }
63
+ if (!dryRun) {
64
+ const manifestContent = corpus.manifest.dependencies.join("\n");
65
+ const managed = derivations
66
+ .filter((d) => d.written)
67
+ .map((d) => ({ tool: d.tool, path: d.path, sha256: sha256("") }));
68
+ const snapshot = buildSnapshot({
69
+ projectPath,
70
+ manifestContent,
71
+ structureHash: sha256(corpus.structure.topLevelDirs.join(",")),
72
+ filesManaged: [
73
+ { tool: "agents-md", path: path.join(projectPath, "AGENTS.md"), sha256: sha256(agentsMd) },
74
+ ...managed,
75
+ ],
76
+ language: metadata.project.language,
77
+ framework: metadata.project.framework ?? null,
78
+ topLevelDirs: corpus.structure.topLevelDirs,
79
+ dependencyCount: corpus.manifest.dependencies.length,
80
+ totalFiles: corpus.structure.totalFileCount,
81
+ });
82
+ await saveSnapshot(snapshot);
83
+ }
84
+ return {
85
+ success: true,
86
+ filesUpdated: derivations.filter((d) => !d.error).map((d) => ({ tool: d.tool, path: d.path })),
87
+ customSectionsPreserved: derivations.reduce((s, d) => s + (d.customBlocksPreserved ?? 0), 0),
88
+ warnings,
89
+ skippedExtraction: false,
90
+ dryRun,
91
+ };
92
+ }
93
+ // Fast path: just re-derive from existing AGENTS.md using stub metadata
94
+ const fastSnapshot = await loadSnapshot(projectPath);
95
+ if (!fastSnapshot) {
96
+ throw new AgentsSyncError("NO_SNAPSHOT", "No snapshot found. Run /agents-sync init first.");
97
+ }
98
+ const stubMetadata = {
99
+ project: {
100
+ name: path.basename(projectPath),
101
+ description: "",
102
+ language: fastSnapshot.meta.language,
103
+ framework: fastSnapshot.meta.framework ?? undefined,
104
+ },
105
+ stack: { other: [] },
106
+ architecture: { keyDirs: {}, entryPoints: [] },
107
+ conventions: [],
108
+ gotchas: [],
109
+ boundaries: { alwaysDo: [], askFirst: [], never: [] },
110
+ testing: {},
111
+ deployment: { notes: [] },
112
+ };
113
+ const derivations = await deriveAll({ projectPath, agentsMdContent: agentsMd, metadata: stubMetadata, tools: effectiveTools, dryRun });
114
+ return {
115
+ success: true,
116
+ filesUpdated: derivations.filter((d) => !d.error).map((d) => ({ tool: d.tool, path: d.path })),
117
+ customSectionsPreserved: derivations.reduce((s, d) => s + (d.customBlocksPreserved ?? 0), 0),
118
+ warnings: ["Fast mode: used cached metadata (no Claude API call)"],
119
+ skippedExtraction: true,
120
+ dryRun,
121
+ };
122
+ }
123
+ //# sourceMappingURL=sync.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/tools/sync.ts"],"names":[],"mappings":"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"}