@planu/cli 0.71.0 → 0.73.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 (283) hide show
  1. package/README.md +1 -1
  2. package/dist/config/license-plans.json +9 -2
  3. package/dist/config/tool-groups.json +5 -1
  4. package/dist/engine/actuals/git-analyzer.js +1 -1
  5. package/dist/engine/actuals/git-analyzer.js.map +1 -1
  6. package/dist/engine/agent-prompt-generator.d.ts +12 -0
  7. package/dist/engine/agent-prompt-generator.d.ts.map +1 -0
  8. package/dist/engine/agent-prompt-generator.js +171 -0
  9. package/dist/engine/agent-prompt-generator.js.map +1 -0
  10. package/dist/engine/ai-tool-detector/index.d.ts +6 -0
  11. package/dist/engine/ai-tool-detector/index.d.ts.map +1 -0
  12. package/dist/engine/ai-tool-detector/index.js +95 -0
  13. package/dist/engine/ai-tool-detector/index.js.map +1 -0
  14. package/dist/engine/ci-generator/planu-steps.d.ts.map +1 -1
  15. package/dist/engine/ci-generator/planu-steps.js +10 -11
  16. package/dist/engine/ci-generator/planu-steps.js.map +1 -1
  17. package/dist/engine/convention-scanner/codebase-scanner.d.ts +7 -0
  18. package/dist/engine/convention-scanner/codebase-scanner.d.ts.map +1 -0
  19. package/dist/engine/convention-scanner/codebase-scanner.js +258 -0
  20. package/dist/engine/convention-scanner/codebase-scanner.js.map +1 -0
  21. package/dist/engine/convention-scanner/convention-parser.d.ts +7 -0
  22. package/dist/engine/convention-scanner/convention-parser.d.ts.map +1 -0
  23. package/dist/engine/convention-scanner/convention-parser.js +195 -0
  24. package/dist/engine/convention-scanner/convention-parser.js.map +1 -0
  25. package/dist/engine/convention-scanner/index.d.ts +3 -0
  26. package/dist/engine/convention-scanner/index.d.ts.map +1 -0
  27. package/dist/engine/convention-scanner/index.js +5 -0
  28. package/dist/engine/convention-scanner/index.js.map +1 -0
  29. package/dist/engine/convention-sync.d.ts +9 -0
  30. package/dist/engine/convention-sync.d.ts.map +1 -0
  31. package/dist/engine/convention-sync.js +156 -0
  32. package/dist/engine/convention-sync.js.map +1 -0
  33. package/dist/engine/doc-generator/portal/portal-regenerator.d.ts +2 -1
  34. package/dist/engine/doc-generator/portal/portal-regenerator.d.ts.map +1 -1
  35. package/dist/engine/doc-generator/portal/portal-regenerator.js +23 -15
  36. package/dist/engine/doc-generator/portal/portal-regenerator.js.map +1 -1
  37. package/dist/engine/feedback/triage.d.ts +16 -0
  38. package/dist/engine/feedback/triage.d.ts.map +1 -0
  39. package/dist/engine/feedback/triage.js +165 -0
  40. package/dist/engine/feedback/triage.js.map +1 -0
  41. package/dist/engine/hooks-reconciler.d.ts +7 -0
  42. package/dist/engine/hooks-reconciler.d.ts.map +1 -0
  43. package/dist/engine/hooks-reconciler.js +214 -0
  44. package/dist/engine/hooks-reconciler.js.map +1 -0
  45. package/dist/engine/platform-registry.d.ts +17 -0
  46. package/dist/engine/platform-registry.d.ts.map +1 -0
  47. package/dist/engine/platform-registry.js +78 -0
  48. package/dist/engine/platform-registry.js.map +1 -0
  49. package/dist/engine/project-health-checker.d.ts +4 -2
  50. package/dist/engine/project-health-checker.d.ts.map +1 -1
  51. package/dist/engine/project-health-checker.js +78 -5
  52. package/dist/engine/project-health-checker.js.map +1 -1
  53. package/dist/engine/rules-generator/index.d.ts +14 -0
  54. package/dist/engine/rules-generator/index.d.ts.map +1 -0
  55. package/dist/engine/rules-generator/index.js +313 -0
  56. package/dist/engine/rules-generator/index.js.map +1 -0
  57. package/dist/engine/rules-reconciler.d.ts +13 -0
  58. package/dist/engine/rules-reconciler.d.ts.map +1 -0
  59. package/dist/engine/rules-reconciler.js +193 -0
  60. package/dist/engine/rules-reconciler.js.map +1 -0
  61. package/dist/engine/skill-generator/detect.d.ts +1 -0
  62. package/dist/engine/skill-generator/detect.d.ts.map +1 -1
  63. package/dist/engine/skill-generator/detect.js +13 -5
  64. package/dist/engine/skill-generator/detect.js.map +1 -1
  65. package/dist/engine/skills/skills-fetcher.d.ts +4 -0
  66. package/dist/engine/skills/skills-fetcher.d.ts.map +1 -0
  67. package/dist/engine/skills/skills-fetcher.js +102 -0
  68. package/dist/engine/skills/skills-fetcher.js.map +1 -0
  69. package/dist/engine/skills-reconciler.d.ts +15 -0
  70. package/dist/engine/skills-reconciler.d.ts.map +1 -0
  71. package/dist/engine/skills-reconciler.js +98 -0
  72. package/dist/engine/skills-reconciler.js.map +1 -0
  73. package/dist/engine/spec-template-cleaner.d.ts +12 -0
  74. package/dist/engine/spec-template-cleaner.d.ts.map +1 -0
  75. package/dist/engine/spec-template-cleaner.js +119 -0
  76. package/dist/engine/spec-template-cleaner.js.map +1 -0
  77. package/dist/engine/validator/analyzer.d.ts +4 -2
  78. package/dist/engine/validator/analyzer.d.ts.map +1 -1
  79. package/dist/engine/validator/analyzer.js +14 -3
  80. package/dist/engine/validator/analyzer.js.map +1 -1
  81. package/dist/engine/validator/criterion-enricher.d.ts +42 -0
  82. package/dist/engine/validator/criterion-enricher.d.ts.map +1 -0
  83. package/dist/engine/validator/criterion-enricher.js +186 -0
  84. package/dist/engine/validator/criterion-enricher.js.map +1 -0
  85. package/dist/engine/validator/deep-code-checker.d.ts +41 -0
  86. package/dist/engine/validator/deep-code-checker.d.ts.map +1 -0
  87. package/dist/engine/validator/deep-code-checker.js +363 -0
  88. package/dist/engine/validator/deep-code-checker.js.map +1 -0
  89. package/dist/engine/validator/extractors.d.ts +8 -1
  90. package/dist/engine/validator/extractors.d.ts.map +1 -1
  91. package/dist/engine/validator/extractors.js +33 -0
  92. package/dist/engine/validator/extractors.js.map +1 -1
  93. package/dist/engine/validator/index.d.ts +7 -0
  94. package/dist/engine/validator/index.d.ts.map +1 -0
  95. package/dist/engine/validator/index.js +8 -0
  96. package/dist/engine/validator/index.js.map +1 -0
  97. package/dist/engine/validator.d.ts.map +1 -1
  98. package/dist/engine/validator.js +13 -2
  99. package/dist/engine/validator.js.map +1 -1
  100. package/dist/engine/workers/schema.d.ts +58 -0
  101. package/dist/engine/workers/schema.d.ts.map +1 -0
  102. package/dist/engine/workers/schema.js +41 -0
  103. package/dist/engine/workers/schema.js.map +1 -0
  104. package/dist/engine/workers/worker-engine.js +1 -1
  105. package/dist/engine/workers/worker-engine.js.map +1 -1
  106. package/dist/index.js +10 -0
  107. package/dist/index.js.map +1 -1
  108. package/dist/storage/convention-baseline.d.ts +20 -0
  109. package/dist/storage/convention-baseline.d.ts.map +1 -0
  110. package/dist/storage/convention-baseline.js +57 -0
  111. package/dist/storage/convention-baseline.js.map +1 -0
  112. package/dist/storage/feedback-remote.d.ts +8 -0
  113. package/dist/storage/feedback-remote.d.ts.map +1 -0
  114. package/dist/storage/feedback-remote.js +27 -0
  115. package/dist/storage/feedback-remote.js.map +1 -0
  116. package/dist/storage/feedback-store.d.ts +27 -0
  117. package/dist/storage/feedback-store.d.ts.map +1 -0
  118. package/dist/storage/feedback-store.js +272 -0
  119. package/dist/storage/feedback-store.js.map +1 -0
  120. package/dist/storage/index.d.ts +1 -0
  121. package/dist/storage/index.d.ts.map +1 -1
  122. package/dist/storage/index.js +1 -0
  123. package/dist/storage/index.js.map +1 -1
  124. package/dist/tools/convention-sync.d.ts +8 -0
  125. package/dist/tools/convention-sync.d.ts.map +1 -0
  126. package/dist/tools/convention-sync.js +77 -0
  127. package/dist/tools/convention-sync.js.map +1 -0
  128. package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.d.ts +9 -0
  129. package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.d.ts.map +1 -0
  130. package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.js +68 -0
  131. package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.js.map +1 -0
  132. package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.d.ts +14 -0
  133. package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.d.ts.map +1 -0
  134. package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.js +60 -0
  135. package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.js.map +1 -0
  136. package/dist/tools/create-spec-hu/ac-adapters/index.d.ts +4 -0
  137. package/dist/tools/create-spec-hu/ac-adapters/index.d.ts.map +1 -1
  138. package/dist/tools/create-spec-hu/ac-adapters/index.js +9 -1
  139. package/dist/tools/create-spec-hu/ac-adapters/index.js.map +1 -1
  140. package/dist/tools/create-spec-hu/hu-body-generators.d.ts.map +1 -1
  141. package/dist/tools/create-spec-hu/hu-body-generators.js +15 -2
  142. package/dist/tools/create-spec-hu/hu-body-generators.js.map +1 -1
  143. package/dist/tools/create-spec.d.ts.map +1 -1
  144. package/dist/tools/create-spec.js +3 -2
  145. package/dist/tools/create-spec.js.map +1 -1
  146. package/dist/tools/delete-decision.d.ts.map +1 -1
  147. package/dist/tools/delete-decision.js +2 -0
  148. package/dist/tools/delete-decision.js.map +1 -1
  149. package/dist/tools/delete-project.d.ts.map +1 -1
  150. package/dist/tools/delete-project.js +11 -14
  151. package/dist/tools/delete-project.js.map +1 -1
  152. package/dist/tools/delete-spec.d.ts.map +1 -1
  153. package/dist/tools/delete-spec.js +11 -9
  154. package/dist/tools/delete-spec.js.map +1 -1
  155. package/dist/tools/estimate.d.ts.map +1 -1
  156. package/dist/tools/estimate.js +6 -5
  157. package/dist/tools/estimate.js.map +1 -1
  158. package/dist/tools/export-session.d.ts.map +1 -1
  159. package/dist/tools/export-session.js +7 -9
  160. package/dist/tools/export-session.js.map +1 -1
  161. package/dist/tools/feedback-handler.d.ts +5 -0
  162. package/dist/tools/feedback-handler.d.ts.map +1 -0
  163. package/dist/tools/feedback-handler.js +106 -0
  164. package/dist/tools/feedback-handler.js.map +1 -0
  165. package/dist/tools/generate-teammate-prompt.d.ts +8 -0
  166. package/dist/tools/generate-teammate-prompt.d.ts.map +1 -1
  167. package/dist/tools/generate-teammate-prompt.js +33 -0
  168. package/dist/tools/generate-teammate-prompt.js.map +1 -1
  169. package/dist/tools/init-project/handler.d.ts.map +1 -1
  170. package/dist/tools/init-project/handler.js +73 -15
  171. package/dist/tools/init-project/handler.js.map +1 -1
  172. package/dist/tools/init-project/helpers.d.ts.map +1 -1
  173. package/dist/tools/init-project/helpers.js +1 -2
  174. package/dist/tools/init-project/helpers.js.map +1 -1
  175. package/dist/tools/init-project/result-builder.d.ts.map +1 -1
  176. package/dist/tools/init-project/result-builder.js +13 -1
  177. package/dist/tools/init-project/result-builder.js.map +1 -1
  178. package/dist/tools/init-project/skill-auto-installer.d.ts +10 -0
  179. package/dist/tools/init-project/skill-auto-installer.d.ts.map +1 -0
  180. package/dist/tools/init-project/skill-auto-installer.js +28 -0
  181. package/dist/tools/init-project/skill-auto-installer.js.map +1 -0
  182. package/dist/tools/log-decision.d.ts.map +1 -1
  183. package/dist/tools/log-decision.js +15 -4
  184. package/dist/tools/log-decision.js.map +1 -1
  185. package/dist/tools/manage-trash.d.ts.map +1 -1
  186. package/dist/tools/manage-trash.js +13 -27
  187. package/dist/tools/manage-trash.js.map +1 -1
  188. package/dist/tools/reconcile-hooks.d.ts +7 -0
  189. package/dist/tools/reconcile-hooks.d.ts.map +1 -0
  190. package/dist/tools/reconcile-hooks.js +78 -0
  191. package/dist/tools/reconcile-hooks.js.map +1 -0
  192. package/dist/tools/reconcile-rules.d.ts +7 -0
  193. package/dist/tools/reconcile-rules.d.ts.map +1 -0
  194. package/dist/tools/reconcile-rules.js +86 -0
  195. package/dist/tools/reconcile-rules.js.map +1 -0
  196. package/dist/tools/reconcile-skills.d.ts +8 -0
  197. package/dist/tools/reconcile-skills.d.ts.map +1 -0
  198. package/dist/tools/reconcile-skills.js +70 -0
  199. package/dist/tools/reconcile-skills.js.map +1 -0
  200. package/dist/tools/register-feedback-tools.d.ts +3 -0
  201. package/dist/tools/register-feedback-tools.d.ts.map +1 -0
  202. package/dist/tools/register-feedback-tools.js +65 -0
  203. package/dist/tools/register-feedback-tools.js.map +1 -0
  204. package/dist/tools/register-spec-tools/core-spec-tools.d.ts.map +1 -1
  205. package/dist/tools/register-spec-tools/core-spec-tools.js +14 -4
  206. package/dist/tools/register-spec-tools/core-spec-tools.js.map +1 -1
  207. package/dist/tools/register-team-tools.d.ts.map +1 -1
  208. package/dist/tools/register-team-tools.js +35 -8
  209. package/dist/tools/register-team-tools.js.map +1 -1
  210. package/dist/tools/safe-handler.d.ts.map +1 -1
  211. package/dist/tools/safe-handler.js +20 -2
  212. package/dist/tools/safe-handler.js.map +1 -1
  213. package/dist/tools/schemas/index.d.ts +1 -0
  214. package/dist/tools/schemas/index.d.ts.map +1 -1
  215. package/dist/tools/schemas/index.js +1 -0
  216. package/dist/tools/schemas/index.js.map +1 -1
  217. package/dist/tools/schemas/reconcile-skills-schemas.d.ts +7 -0
  218. package/dist/tools/schemas/reconcile-skills-schemas.d.ts.map +1 -0
  219. package/dist/tools/schemas/reconcile-skills-schemas.js +18 -0
  220. package/dist/tools/schemas/reconcile-skills-schemas.js.map +1 -0
  221. package/dist/tools/schemas/workers-schema.d.ts +1 -56
  222. package/dist/tools/schemas/workers-schema.d.ts.map +1 -1
  223. package/dist/tools/schemas/workers-schema.js +6 -42
  224. package/dist/tools/schemas/workers-schema.js.map +1 -1
  225. package/dist/tools/skill-registry/search.d.ts +2 -1
  226. package/dist/tools/skill-registry/search.d.ts.map +1 -1
  227. package/dist/tools/skill-registry/search.js +81 -8
  228. package/dist/tools/skill-registry/search.js.map +1 -1
  229. package/dist/tools/suggest-tooling/skills-fetcher.d.ts +1 -3
  230. package/dist/tools/suggest-tooling/skills-fetcher.d.ts.map +1 -1
  231. package/dist/tools/suggest-tooling/skills-fetcher.js +3 -101
  232. package/dist/tools/suggest-tooling/skills-fetcher.js.map +1 -1
  233. package/dist/tools/token-recording.d.ts +16 -0
  234. package/dist/tools/token-recording.d.ts.map +1 -0
  235. package/dist/tools/token-recording.js +47 -0
  236. package/dist/tools/token-recording.js.map +1 -0
  237. package/dist/tools/update-status-convention-gate.d.ts +12 -0
  238. package/dist/tools/update-status-convention-gate.d.ts.map +1 -0
  239. package/dist/tools/update-status-convention-gate.js +159 -0
  240. package/dist/tools/update-status-convention-gate.js.map +1 -0
  241. package/dist/tools/update-status-reconcile.d.ts +7 -0
  242. package/dist/tools/update-status-reconcile.d.ts.map +1 -0
  243. package/dist/tools/update-status-reconcile.js +47 -0
  244. package/dist/tools/update-status-reconcile.js.map +1 -0
  245. package/dist/tools/update-status.d.ts.map +1 -1
  246. package/dist/tools/update-status.js +113 -67
  247. package/dist/tools/update-status.js.map +1 -1
  248. package/dist/tools/validate.d.ts.map +1 -1
  249. package/dist/tools/validate.js +92 -2
  250. package/dist/tools/validate.js.map +1 -1
  251. package/dist/types/ai-tool-rules.d.ts +42 -0
  252. package/dist/types/ai-tool-rules.d.ts.map +1 -0
  253. package/dist/types/ai-tool-rules.js +3 -0
  254. package/dist/types/ai-tool-rules.js.map +1 -0
  255. package/dist/types/analysis.d.ts +16 -0
  256. package/dist/types/analysis.d.ts.map +1 -1
  257. package/dist/types/conventions.d.ts +155 -0
  258. package/dist/types/conventions.d.ts.map +1 -0
  259. package/dist/types/conventions.js +3 -0
  260. package/dist/types/conventions.js.map +1 -0
  261. package/dist/types/feedback.d.ts +76 -0
  262. package/dist/types/feedback.d.ts.map +1 -0
  263. package/dist/types/feedback.js +3 -0
  264. package/dist/types/feedback.js.map +1 -0
  265. package/dist/types/index.d.ts +4 -0
  266. package/dist/types/index.d.ts.map +1 -1
  267. package/dist/types/index.js +1 -0
  268. package/dist/types/index.js.map +1 -1
  269. package/dist/types/mcp.d.ts +2 -0
  270. package/dist/types/mcp.d.ts.map +1 -1
  271. package/dist/types/project/inputs.d.ts +2 -0
  272. package/dist/types/project/inputs.d.ts.map +1 -1
  273. package/dist/types/project/planu-config.d.ts +7 -1
  274. package/dist/types/project/planu-config.d.ts.map +1 -1
  275. package/dist/types/skill-registry.d.ts +12 -0
  276. package/dist/types/skill-registry.d.ts.map +1 -1
  277. package/dist/types/verifiable-criteria.d.ts +50 -0
  278. package/dist/types/verifiable-criteria.d.ts.map +1 -0
  279. package/dist/types/verifiable-criteria.js +3 -0
  280. package/dist/types/verifiable-criteria.js.map +1 -0
  281. package/package.json +1 -1
  282. package/src/config/license-plans.json +9 -2
  283. package/src/config/tool-groups.json +5 -1
@@ -0,0 +1,258 @@
1
+ // engine/convention-scanner/codebase-scanner.ts — SPEC-192
2
+ // Scans actual codebase files against parsed conventions
3
+ import { execSync } from 'node:child_process';
4
+ import { readdirSync, readFileSync, statSync } from 'node:fs';
5
+ import { join, relative } from 'node:path';
6
+ const MAX_VIOLATIONS_PER_CATEGORY = 50;
7
+ // ── helpers ───────────────────────────────────────────────────────────────────
8
+ function execSafe(cmd, cwd) {
9
+ try {
10
+ return execSync(cmd, { cwd, stdio: ['pipe', 'pipe', 'pipe'] }).toString();
11
+ }
12
+ catch {
13
+ return '';
14
+ }
15
+ }
16
+ function lineCount(filePath) {
17
+ try {
18
+ const content = readFileSync(filePath, 'utf-8');
19
+ return content.split('\n').length;
20
+ }
21
+ catch {
22
+ return 0;
23
+ }
24
+ }
25
+ function parseGrepLine(line) {
26
+ const match = /^([^:]+):(\d+):(.*)$/.exec(line);
27
+ if (!match) {
28
+ return null;
29
+ }
30
+ const file = match[1];
31
+ const lineNum = match[2];
32
+ const code = match[3];
33
+ if (!file || !lineNum || code === undefined) {
34
+ return null;
35
+ }
36
+ return { file: file.trim(), lineNum: parseInt(lineNum, 10), code: code.trim() };
37
+ }
38
+ function walkSourceFiles(dir, projectPath, extensions, results = []) {
39
+ let entries;
40
+ try {
41
+ entries = readdirSync(dir);
42
+ }
43
+ catch {
44
+ return results;
45
+ }
46
+ for (const entry of entries) {
47
+ if (entry.startsWith('.') || entry === 'node_modules' || entry === 'dist') {
48
+ continue;
49
+ }
50
+ const full = join(dir, entry);
51
+ let isDir;
52
+ try {
53
+ isDir = statSync(full).isDirectory();
54
+ }
55
+ catch {
56
+ continue;
57
+ }
58
+ if (isDir) {
59
+ walkSourceFiles(full, projectPath, extensions, results);
60
+ }
61
+ else if (extensions.some((ext) => full.endsWith(ext))) {
62
+ results.push(relative(projectPath, full));
63
+ }
64
+ }
65
+ return results;
66
+ }
67
+ // ── scanners per category ─────────────────────────────────────────────────────
68
+ function scanNaming(projectPath, rules) {
69
+ const relevantRules = rules.filter((r) => r.category === 'naming');
70
+ if (relevantRules.length === 0) {
71
+ return [];
72
+ }
73
+ const violations = [];
74
+ const rule = relevantRules[0];
75
+ if (!rule) {
76
+ return [];
77
+ }
78
+ const grepOut = execSafe(`grep -rn --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx" -P "[À-ÿ]" src/ 2>/dev/null | head -${MAX_VIOLATIONS_PER_CATEGORY}`, projectPath);
79
+ if (!grepOut.trim()) {
80
+ return violations;
81
+ }
82
+ for (const raw of grepOut.trim().split('\n').filter(Boolean)) {
83
+ const parsed = parseGrepLine(raw);
84
+ if (!parsed) {
85
+ continue;
86
+ }
87
+ const { file, lineNum, code } = parsed;
88
+ if (code.startsWith('//') || code.startsWith('*')) {
89
+ continue;
90
+ }
91
+ violations.push({
92
+ ruleId: rule.id,
93
+ category: 'naming',
94
+ severity: rule.severity,
95
+ file,
96
+ line: lineNum,
97
+ message: `Non-ASCII character in identifier: ${code.slice(0, 80)}`,
98
+ suggestion: 'Use English-only variable/function names',
99
+ });
100
+ }
101
+ return violations.slice(0, MAX_VIOLATIONS_PER_CATEGORY);
102
+ }
103
+ function scanI18n(projectPath, rules) {
104
+ const relevantRules = rules.filter((r) => r.category === 'i18n');
105
+ if (relevantRules.length === 0) {
106
+ return [];
107
+ }
108
+ const rule = relevantRules[0];
109
+ if (!rule) {
110
+ return [];
111
+ }
112
+ const violations = [];
113
+ const grepOut = execSafe(`grep -rn --include="*.tsx" --include="*.jsx" -E '>[^<{]{8,}</' src/ 2>/dev/null | grep -v '//' | head -${MAX_VIOLATIONS_PER_CATEGORY}`, projectPath);
114
+ if (!grepOut.trim()) {
115
+ return violations;
116
+ }
117
+ for (const raw of grepOut.trim().split('\n').filter(Boolean)) {
118
+ const parsed = parseGrepLine(raw);
119
+ if (!parsed) {
120
+ continue;
121
+ }
122
+ const { file, lineNum, code } = parsed;
123
+ violations.push({
124
+ ruleId: rule.id,
125
+ category: 'i18n',
126
+ severity: rule.severity,
127
+ file,
128
+ line: lineNum,
129
+ message: `Possible hardcoded string in JSX: ${code.slice(0, 80)}`,
130
+ suggestion: 'Wrap user-facing strings with i18n translation function',
131
+ });
132
+ }
133
+ return violations.slice(0, MAX_VIOLATIONS_PER_CATEGORY);
134
+ }
135
+ function extractLineLimit(rules) {
136
+ let fileLimit = 400;
137
+ let fnLimit = 80;
138
+ for (const rule of rules) {
139
+ const desc = rule.description.toLowerCase();
140
+ const fileMatch = /(\d+)\s*lines?\s*(?:per\s*file|file\s*limit|max)/.exec(desc);
141
+ if (fileMatch?.[1]) {
142
+ fileLimit = parseInt(fileMatch[1], 10);
143
+ }
144
+ const fnMatch = /(\d+)\s*lines?\s*(?:per\s*function|function)/.exec(desc);
145
+ if (fnMatch?.[1]) {
146
+ fnLimit = parseInt(fnMatch[1], 10);
147
+ }
148
+ }
149
+ return { fileLimit, fnLimit };
150
+ }
151
+ function scanFileLimits(projectPath, rules) {
152
+ const relevantRules = rules.filter((r) => r.category === 'file-limits');
153
+ if (relevantRules.length === 0) {
154
+ return [];
155
+ }
156
+ const rule = relevantRules[0];
157
+ if (!rule) {
158
+ return [];
159
+ }
160
+ const { fileLimit } = extractLineLimit(relevantRules);
161
+ const srcDir = join(projectPath, 'src');
162
+ const files = walkSourceFiles(srcDir, projectPath, ['.ts', '.tsx']);
163
+ const violations = [];
164
+ for (const relFile of files) {
165
+ const fullPath = join(projectPath, relFile);
166
+ const count = lineCount(fullPath);
167
+ if (count > fileLimit) {
168
+ violations.push({
169
+ ruleId: rule.id,
170
+ category: 'file-limits',
171
+ severity: count > fileLimit * 1.5 ? 'critical' : 'warning',
172
+ file: relFile,
173
+ message: `File has ${count} lines (limit: ${fileLimit})`,
174
+ suggestion: 'Split into smaller modules — consider subdirectory pattern',
175
+ });
176
+ }
177
+ if (violations.length >= MAX_VIOLATIONS_PER_CATEGORY) {
178
+ break;
179
+ }
180
+ }
181
+ return violations;
182
+ }
183
+ function parseViolationsFromGrep(grepOut, rule, category, severity, makeMessage, suggestion) {
184
+ const violations = [];
185
+ if (!grepOut.trim()) {
186
+ return violations;
187
+ }
188
+ for (const raw of grepOut.trim().split('\n').filter(Boolean)) {
189
+ const parsed = parseGrepLine(raw);
190
+ if (!parsed) {
191
+ continue;
192
+ }
193
+ const { file, lineNum, code } = parsed;
194
+ violations.push({
195
+ ruleId: rule.id,
196
+ category,
197
+ severity,
198
+ file,
199
+ line: lineNum,
200
+ message: makeMessage(code),
201
+ suggestion,
202
+ });
203
+ }
204
+ return violations;
205
+ }
206
+ function scanArchitecture(projectPath, rules) {
207
+ const relevantRules = rules.filter((r) => r.category === 'architecture');
208
+ if (relevantRules.length === 0) {
209
+ return [];
210
+ }
211
+ const rule = relevantRules[0];
212
+ if (!rule) {
213
+ return [];
214
+ }
215
+ const violations = [];
216
+ const deepImportOut = execSafe(`grep -rn --include="*.ts" "from.*storage/.*/" src/tools/ 2>/dev/null | head -${MAX_VIOLATIONS_PER_CATEGORY}`, projectPath);
217
+ violations.push(...parseViolationsFromGrep(deepImportOut, rule, 'architecture', 'warning', (code) => `Deep import into storage internals: ${code.slice(0, 80)}`, 'Import from barrel export (storage/index.js) instead'));
218
+ const reverseDepOut = execSafe(`grep -rn --include="*.ts" "from.*tools/" src/engine/ 2>/dev/null | head -${MAX_VIOLATIONS_PER_CATEGORY}`, projectPath);
219
+ violations.push(...parseViolationsFromGrep(reverseDepOut, rule, 'architecture', 'critical', (code) => `Engine imports from tools layer (violation): ${code.slice(0, 80)}`, 'Engine must not import from tools — invert the dependency'));
220
+ return violations.slice(0, MAX_VIOLATIONS_PER_CATEGORY);
221
+ }
222
+ function scanCodeQuality(projectPath, rules) {
223
+ const relevantRules = rules.filter((r) => r.category === 'code-quality');
224
+ if (relevantRules.length === 0) {
225
+ return [];
226
+ }
227
+ const rule = relevantRules[0];
228
+ if (!rule) {
229
+ return [];
230
+ }
231
+ const anyTypeOut = execSafe(`grep -rn --include="*.ts" --include="*.tsx" -P ":\\s*any\\b|as\\s+any\\b" src/ 2>/dev/null | grep -v ".d.ts" | head -${MAX_VIOLATIONS_PER_CATEGORY}`, projectPath);
232
+ return parseViolationsFromGrep(anyTypeOut, rule, 'code-quality', 'warning', (code) => `Usage of \`any\` type detected: ${code.slice(0, 80)}`, 'Replace with explicit type or use `unknown` with type guard').slice(0, MAX_VIOLATIONS_PER_CATEGORY);
233
+ }
234
+ // ── public API ────────────────────────────────────────────────────────────────
235
+ /**
236
+ * Scans the codebase against a set of parsed convention rules.
237
+ * Never throws — returns partial results on error.
238
+ */
239
+ export function scanConventions(projectPath, rules) {
240
+ const violations = [];
241
+ const scanners = [
242
+ scanNaming,
243
+ scanI18n,
244
+ scanFileLimits,
245
+ scanArchitecture,
246
+ scanCodeQuality,
247
+ ];
248
+ for (const scanner of scanners) {
249
+ try {
250
+ violations.push(...scanner(projectPath, rules));
251
+ }
252
+ catch {
253
+ // Scanner failed — continue with others
254
+ }
255
+ }
256
+ return violations;
257
+ }
258
+ //# sourceMappingURL=codebase-scanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codebase-scanner.js","sourceRoot":"","sources":["../../../src/engine/convention-scanner/codebase-scanner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { ConventionRule } from '../../types/conventions.js';
2
+ /**
3
+ * Parses CLAUDE.md and .claude/rules/*.md files to produce a structured
4
+ * list of ConventionRule objects. Never throws — returns empty array on error.
5
+ */
6
+ export declare function parseConventions(projectPath: string): ConventionRule[];
7
+ //# sourceMappingURL=convention-parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"convention-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/convention-scanner/convention-parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AA8LjE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CAwBtE"}
@@ -0,0 +1,195 @@
1
+ // engine/convention-scanner/convention-parser.ts — SPEC-192
2
+ // Parses CLAUDE.md and .claude/rules/*.md to extract ConventionRule[]
3
+ import { readFileSync, readdirSync } from 'node:fs';
4
+ import { join, basename } from 'node:path';
5
+ // ── keyword maps ──────────────────────────────────────────────────────────────
6
+ const NAMING_KEYWORDS = [
7
+ 'english',
8
+ 'camelcase',
9
+ 'pascalcase',
10
+ 'kebab-case',
11
+ 'snake_case',
12
+ 'screaming_snake',
13
+ 'naming convention',
14
+ 'variable names',
15
+ 'identifiers',
16
+ ];
17
+ const I18N_KEYWORDS = [
18
+ 'i18n',
19
+ 'hardcoded string',
20
+ 'no hardcoded',
21
+ 'internationalization',
22
+ 'localization',
23
+ 'translation',
24
+ 'locale',
25
+ ];
26
+ const FILE_LIMIT_KEYWORDS = [
27
+ 'max lines',
28
+ 'file size',
29
+ 'max-lines',
30
+ 'line limit',
31
+ 'lines per file',
32
+ 'lines per function',
33
+ 'max-lines-per-function',
34
+ ];
35
+ const ARCHITECTURE_KEYWORDS = [
36
+ 'import',
37
+ 'no-restricted-imports',
38
+ 'dependency rule',
39
+ 'circular',
40
+ 'dependency',
41
+ 'layer',
42
+ 'cross-layer',
43
+ 'barrel export',
44
+ ];
45
+ const TESTING_KEYWORDS = [
46
+ 'test',
47
+ 'coverage',
48
+ 'tdd',
49
+ 'test-driven',
50
+ 'vitest',
51
+ 'jest',
52
+ 'spec file',
53
+ 'test file',
54
+ 'coverage threshold',
55
+ ];
56
+ const CODE_QUALITY_KEYWORDS = [
57
+ 'complexity',
58
+ 'solid',
59
+ 'srp',
60
+ 'ocp',
61
+ 'eslint',
62
+ 'lint',
63
+ 'prettier',
64
+ 'typescript strict',
65
+ 'strict mode',
66
+ 'any type',
67
+ 'type assertion',
68
+ ];
69
+ // ── helpers ───────────────────────────────────────────────────────────────────
70
+ function readFileSafe(path) {
71
+ try {
72
+ return readFileSync(path, 'utf-8');
73
+ }
74
+ catch {
75
+ return '';
76
+ }
77
+ }
78
+ function listRulesFiles(projectPath) {
79
+ const rulesDir = join(projectPath, '.claude', 'rules');
80
+ try {
81
+ return readdirSync(rulesDir)
82
+ .filter((f) => f.endsWith('.md'))
83
+ .map((f) => join(rulesDir, f));
84
+ }
85
+ catch {
86
+ return [];
87
+ }
88
+ }
89
+ function matchesKeywords(line, keywords) {
90
+ const lower = line.toLowerCase();
91
+ return keywords.some((kw) => lower.includes(kw));
92
+ }
93
+ function categorize(line) {
94
+ if (matchesKeywords(line, NAMING_KEYWORDS)) {
95
+ return 'naming';
96
+ }
97
+ if (matchesKeywords(line, I18N_KEYWORDS)) {
98
+ return 'i18n';
99
+ }
100
+ if (matchesKeywords(line, FILE_LIMIT_KEYWORDS)) {
101
+ return 'file-limits';
102
+ }
103
+ if (matchesKeywords(line, ARCHITECTURE_KEYWORDS)) {
104
+ return 'architecture';
105
+ }
106
+ if (matchesKeywords(line, TESTING_KEYWORDS)) {
107
+ return 'testing';
108
+ }
109
+ if (matchesKeywords(line, CODE_QUALITY_KEYWORDS)) {
110
+ return 'code-quality';
111
+ }
112
+ return null;
113
+ }
114
+ function inferSeverity(line) {
115
+ const lower = line.toLowerCase();
116
+ if (lower.includes('mandatory') || lower.includes('never') || lower.includes('always')) {
117
+ return 'critical';
118
+ }
119
+ if (lower.includes('should') || lower.includes('prefer') || lower.includes('avoid')) {
120
+ return 'warning';
121
+ }
122
+ return 'info';
123
+ }
124
+ function extractDescription(line) {
125
+ // Strip markdown markers and trim
126
+ return line
127
+ .replace(/^#+\s*/, '')
128
+ .replace(/^\*+\s*/, '')
129
+ .replace(/^-+\s*/, '')
130
+ .replace(/`/g, '')
131
+ .replace(/\*\*/g, '')
132
+ .trim()
133
+ .slice(0, 120);
134
+ }
135
+ function parseContent(content, sourceFile, source, idPrefix) {
136
+ const rules = [];
137
+ const seen = new Set();
138
+ let counter = 0;
139
+ const lines = content.split('\n');
140
+ for (const raw of lines) {
141
+ const line = raw.trim();
142
+ if (!line || line.length < 10) {
143
+ continue;
144
+ }
145
+ const category = categorize(line);
146
+ if (!category) {
147
+ continue;
148
+ }
149
+ const description = extractDescription(line);
150
+ // Deduplicate by normalized description
151
+ const key = `${category}:${description.toLowerCase().slice(0, 60)}`;
152
+ if (seen.has(key)) {
153
+ continue;
154
+ }
155
+ seen.add(key);
156
+ counter++;
157
+ rules.push({
158
+ id: `${idPrefix}-${category}-${counter}`,
159
+ category,
160
+ description,
161
+ severity: inferSeverity(line),
162
+ source,
163
+ sourceFile,
164
+ });
165
+ }
166
+ return rules;
167
+ }
168
+ // ── public API ────────────────────────────────────────────────────────────────
169
+ /**
170
+ * Parses CLAUDE.md and .claude/rules/*.md files to produce a structured
171
+ * list of ConventionRule objects. Never throws — returns empty array on error.
172
+ */
173
+ export function parseConventions(projectPath) {
174
+ const rules = [];
175
+ // Parse CLAUDE.md
176
+ const claudeMdPath = join(projectPath, 'CLAUDE.md');
177
+ const claudeContent = readFileSafe(claudeMdPath);
178
+ if (claudeContent) {
179
+ const claudeRules = parseContent(claudeContent, 'CLAUDE.md', 'claude-md', 'claude-md');
180
+ rules.push(...claudeRules);
181
+ }
182
+ // Parse .claude/rules/*.md
183
+ const rulesFiles = listRulesFiles(projectPath);
184
+ for (const filePath of rulesFiles) {
185
+ const content = readFileSafe(filePath);
186
+ if (!content) {
187
+ continue;
188
+ }
189
+ const name = basename(filePath, '.md');
190
+ const fileRules = parseContent(content, filePath, 'rules-file', `rules-${name}`);
191
+ rules.push(...fileRules);
192
+ }
193
+ return rules;
194
+ }
195
+ //# sourceMappingURL=convention-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"convention-parser.js","sourceRoot":"","sources":["../../../src/engine/convention-scanner/convention-parser.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG3C,iFAAiF;AAEjF,MAAM,eAAe,GAAG;IACtB,SAAS;IACT,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,aAAa;CACd,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,MAAM;IACN,kBAAkB;IAClB,cAAc;IACd,sBAAsB;IACtB,cAAc;IACd,aAAa;IACb,QAAQ;CACT,CAAC;AAEF,MAAM,mBAAmB,GAAG;IAC1B,WAAW;IACX,WAAW;IACX,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,oBAAoB;IACpB,wBAAwB;CACzB,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC5B,QAAQ;IACR,uBAAuB;IACvB,iBAAiB;IACjB,UAAU;IACV,YAAY;IACZ,OAAO;IACP,aAAa;IACb,eAAe;CAChB,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,MAAM;IACN,UAAU;IACV,KAAK;IACL,aAAa;IACb,QAAQ;IACR,MAAM;IACN,WAAW;IACX,WAAW;IACX,oBAAoB;CACrB,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC5B,YAAY;IACZ,OAAO;IACP,KAAK;IACL,KAAK;IACL,QAAQ;IACR,MAAM;IACN,UAAU;IACV,mBAAmB;IACnB,aAAa;IACb,UAAU;IACV,gBAAgB;CACjB,CAAC;AAEF,iFAAiF;AAEjF,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,QAAQ,CAAC;aACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,QAAkB;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,CAAC;QAC/C,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC;QACjD,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC;QACjD,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,kCAAkC;IAClC,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CACnB,OAAe,EACf,UAAkB,EAClB,MAAgC,EAChC,QAAgB;IAEhB,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC7C,wCAAwC;QACxC,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACpE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEd,OAAO,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,GAAG,QAAQ,IAAI,QAAQ,IAAI,OAAO,EAAE;YACxC,QAAQ;YACR,WAAW;YACX,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC;YAC7B,MAAM;YACN,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,kBAAkB;IAClB,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,YAAY,CAAC,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;IAC7B,CAAC;IAED,2BAA2B;IAC3B,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC/C,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { parseConventions } from './convention-parser.js';
2
+ export { scanConventions } from './codebase-scanner.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/convention-scanner/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,5 @@
1
+ // engine/convention-scanner/index.ts — SPEC-192
2
+ // Barrel export for the convention scanner engine
3
+ export { parseConventions } from './convention-parser.js';
4
+ export { scanConventions } from './codebase-scanner.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/convention-scanner/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,kDAAkD;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,9 @@
1
+ import type { ConventionSyncReport, ProjectKnowledge } from '../types/index.js';
2
+ /**
3
+ * Calculate overall convention sync health by running all four reconcilers
4
+ * in parallel and combining their scores with equal 25% weights.
5
+ *
6
+ * Never throws — returns zero scores on unexpected errors.
7
+ */
8
+ export declare function calculateConventionSync(projectPath: string, knowledge: ProjectKnowledge | null): Promise<ConventionSyncReport>;
9
+ //# sourceMappingURL=convention-sync.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"convention-sync.d.ts","sourceRoot":"","sources":["../../src/engine/convention-sync.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAa,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAwH3F;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAgD/B"}