ft-scout 1.0.8 ā†’ 1.1.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 (243) hide show
  1. package/.firebase/hosting.d2Vi.cache +9 -0
  2. package/.firebaserc +14 -0
  3. package/AUTONOMOUS_FEATURES.md +192 -0
  4. package/README.md +482 -32
  5. package/bin/ft.js +2 -0
  6. package/bin/src/commands/agent.d.ts.map +1 -0
  7. package/bin/src/commands/agent.js +1230 -0
  8. package/bin/src/commands/agent.js.map +1 -0
  9. package/bin/src/commands/audit.d.ts.map +1 -0
  10. package/bin/src/commands/audit.js +104 -0
  11. package/bin/src/commands/audit.js.map +1 -0
  12. package/bin/src/commands/authCommand.d.ts.map +1 -0
  13. package/bin/src/commands/authCommand.js +38 -0
  14. package/bin/src/commands/authCommand.js.map +1 -0
  15. package/bin/src/commands/benchmark.d.ts.map +1 -0
  16. package/bin/src/commands/benchmark.js +135 -0
  17. package/bin/src/commands/benchmark.js.map +1 -0
  18. package/bin/src/commands/brief.d.ts.map +1 -1
  19. package/bin/src/commands/brief.js +28 -19
  20. package/bin/src/commands/brief.js.map +1 -1
  21. package/bin/src/commands/configCommand.d.ts.map +1 -0
  22. package/bin/src/commands/configCommand.js +53 -0
  23. package/bin/src/commands/configCommand.js.map +1 -0
  24. package/bin/src/commands/dashboard.d.ts.map +1 -0
  25. package/bin/src/commands/dashboard.js +41 -0
  26. package/bin/src/commands/dashboard.js.map +1 -0
  27. package/bin/src/commands/history.d.ts.map +1 -0
  28. package/bin/src/commands/history.js +20 -0
  29. package/bin/src/commands/history.js.map +1 -0
  30. package/bin/src/commands/init.d.ts.map +1 -1
  31. package/bin/src/commands/init.js +411 -78
  32. package/bin/src/commands/init.js.map +1 -1
  33. package/bin/src/commands/login.d.ts.map +1 -0
  34. package/bin/src/commands/login.js +190 -0
  35. package/bin/src/commands/login.js.map +1 -0
  36. package/bin/src/commands/logout.d.ts.map +1 -0
  37. package/bin/src/commands/logout.js +15 -0
  38. package/bin/src/commands/logout.js.map +1 -0
  39. package/bin/src/commands/mcp.d.ts.map +1 -0
  40. package/bin/src/commands/mcp.js +393 -0
  41. package/bin/src/commands/mcp.js.map +1 -0
  42. package/bin/src/commands/owners.js +6 -6
  43. package/bin/src/commands/owners.js.map +1 -1
  44. package/bin/src/commands/plan.d.ts.map +1 -0
  45. package/bin/src/commands/plan.js +152 -0
  46. package/bin/src/commands/plan.js.map +1 -0
  47. package/bin/src/commands/quota.d.ts.map +1 -0
  48. package/bin/src/commands/quota.js +32 -0
  49. package/bin/src/commands/quota.js.map +1 -0
  50. package/bin/src/commands/recommend.d.ts.map +1 -0
  51. package/bin/src/commands/recommend.js +46 -0
  52. package/bin/src/commands/recommend.js.map +1 -0
  53. package/bin/src/commands/risky.d.ts.map +1 -1
  54. package/bin/src/commands/risky.js +235 -39
  55. package/bin/src/commands/risky.js.map +1 -1
  56. package/bin/src/commands/setup.d.ts.map +1 -1
  57. package/bin/src/commands/setup.js +411 -16
  58. package/bin/src/commands/setup.js.map +1 -1
  59. package/bin/src/commands/signup.d.ts.map +1 -0
  60. package/bin/src/commands/signup.js +118 -0
  61. package/bin/src/commands/signup.js.map +1 -0
  62. package/bin/src/commands/undo.d.ts.map +1 -0
  63. package/bin/src/commands/undo.js +59 -0
  64. package/bin/src/commands/undo.js.map +1 -0
  65. package/bin/src/commands/web.d.ts.map +1 -0
  66. package/bin/src/commands/web.js +90 -0
  67. package/bin/src/commands/web.js.map +1 -0
  68. package/bin/src/discovery/config.d.ts.map +1 -0
  69. package/bin/src/discovery/config.js +41 -0
  70. package/bin/src/discovery/config.js.map +1 -0
  71. package/bin/src/discovery/display.d.ts.map +1 -0
  72. package/bin/src/discovery/display.js +57 -0
  73. package/bin/src/discovery/display.js.map +1 -0
  74. package/bin/src/discovery/messages.d.ts.map +1 -0
  75. package/bin/src/discovery/messages.js +7 -0
  76. package/bin/src/discovery/messages.js.map +1 -0
  77. package/bin/src/discovery/signals.d.ts.map +1 -0
  78. package/bin/src/discovery/signals.js +33 -0
  79. package/bin/src/discovery/signals.js.map +1 -0
  80. package/bin/src/engine/actionVerifier.d.ts.map +1 -0
  81. package/bin/src/engine/actionVerifier.js +283 -0
  82. package/bin/src/engine/actionVerifier.js.map +1 -0
  83. package/bin/src/engine/agentEngine.d.ts.map +1 -0
  84. package/bin/src/engine/agentEngine.js +2188 -0
  85. package/bin/src/engine/agentEngine.js.map +1 -0
  86. package/bin/src/engine/agentState.d.ts.map +1 -0
  87. package/bin/src/engine/agentState.js +381 -0
  88. package/bin/src/engine/agentState.js.map +1 -0
  89. package/bin/src/engine/browser/browserController.d.ts.map +1 -0
  90. package/bin/src/engine/browser/browserController.js +737 -0
  91. package/bin/src/engine/browser/browserController.js.map +1 -0
  92. package/bin/src/engine/browser/index.d.ts.map +1 -0
  93. package/bin/src/engine/browser/index.js +2 -0
  94. package/bin/src/engine/browser/index.js.map +1 -0
  95. package/bin/src/engine/computer/computerController.d.ts.map +1 -0
  96. package/bin/src/engine/computer/computerController.js +773 -0
  97. package/bin/src/engine/computer/computerController.js.map +1 -0
  98. package/bin/src/engine/computer/computerDiagnostic.d.ts.map +1 -0
  99. package/bin/src/engine/computer/computerDiagnostic.js +71 -0
  100. package/bin/src/engine/computer/computerDiagnostic.js.map +1 -0
  101. package/bin/src/engine/computer/index.d.ts.map +1 -0
  102. package/bin/src/engine/computer/index.js +4 -0
  103. package/bin/src/engine/computer/index.js.map +1 -0
  104. package/bin/src/engine/computer/mockComputer.d.ts.map +1 -0
  105. package/bin/src/engine/computer/mockComputer.js +260 -0
  106. package/bin/src/engine/computer/mockComputer.js.map +1 -0
  107. package/bin/src/engine/computer/scoutDriver.cs +1161 -0
  108. package/bin/src/engine/computer/scout_driver.exe +0 -0
  109. package/bin/src/engine/git.d.ts.map +1 -1
  110. package/bin/src/engine/git.js +71 -0
  111. package/bin/src/engine/git.js.map +1 -1
  112. package/bin/src/engine/llm.d.ts.map +1 -1
  113. package/bin/src/engine/llm.js +1272 -23
  114. package/bin/src/engine/llm.js.map +1 -1
  115. package/bin/src/engine/planner.d.ts.map +1 -0
  116. package/bin/src/engine/planner.js +321 -0
  117. package/bin/src/engine/planner.js.map +1 -0
  118. package/bin/src/engine/runtime/agentRuntime.d.ts.map +1 -0
  119. package/bin/src/engine/runtime/agentRuntime.js +1258 -0
  120. package/bin/src/engine/runtime/agentRuntime.js.map +1 -0
  121. package/bin/src/engine/runtime/index.d.ts.map +1 -0
  122. package/bin/src/engine/runtime/index.js +2 -0
  123. package/bin/src/engine/runtime/index.js.map +1 -0
  124. package/bin/src/engine/safety.d.ts.map +1 -0
  125. package/bin/src/engine/safety.js +316 -0
  126. package/bin/src/engine/safety.js.map +1 -0
  127. package/bin/src/engine/scoutAudioRecorder.cs +215 -0
  128. package/bin/src/engine/scout_audio_recorder.exe +0 -0
  129. package/bin/src/engine/toolRegistry.d.ts.map +1 -0
  130. package/bin/src/engine/toolRegistry.js +521 -0
  131. package/bin/src/engine/toolRegistry.js.map +1 -0
  132. package/bin/src/engine/verifier.d.ts.map +1 -0
  133. package/bin/src/engine/verifier.js +414 -0
  134. package/bin/src/engine/verifier.js.map +1 -0
  135. package/bin/src/engine/voiceEngine.d.ts.map +1 -0
  136. package/bin/src/engine/voiceEngine.js +474 -0
  137. package/bin/src/engine/voiceEngine.js.map +1 -0
  138. package/bin/src/engine/web.d.ts.map +1 -0
  139. package/bin/src/engine/web.js +161 -0
  140. package/bin/src/engine/web.js.map +1 -0
  141. package/bin/src/engine/workspace/agentWorkspace.d.ts.map +1 -0
  142. package/bin/src/engine/workspace/agentWorkspace.js +505 -0
  143. package/bin/src/engine/workspace/agentWorkspace.js.map +1 -0
  144. package/bin/src/engine/workspace/index.d.ts.map +1 -0
  145. package/bin/src/engine/workspace/index.js +2 -0
  146. package/bin/src/engine/workspace/index.js.map +1 -0
  147. package/bin/src/index.js +365 -23
  148. package/bin/src/index.js.map +1 -1
  149. package/bin/src/mcp/client.d.ts.map +1 -0
  150. package/bin/src/mcp/client.js +127 -0
  151. package/bin/src/mcp/client.js.map +1 -0
  152. package/bin/src/mcp/discovery.d.ts.map +1 -0
  153. package/bin/src/mcp/discovery.js +91 -0
  154. package/bin/src/mcp/discovery.js.map +1 -0
  155. package/bin/src/mcp/health.d.ts.map +1 -0
  156. package/bin/src/mcp/health.js +44 -0
  157. package/bin/src/mcp/health.js.map +1 -0
  158. package/bin/src/mcp/index.d.ts.map +1 -0
  159. package/bin/src/mcp/index.js +15 -0
  160. package/bin/src/mcp/index.js.map +1 -0
  161. package/bin/src/mcp/manager.d.ts.map +1 -0
  162. package/bin/src/mcp/manager.js +648 -0
  163. package/bin/src/mcp/manager.js.map +1 -0
  164. package/bin/src/mcp/permissions.d.ts.map +1 -0
  165. package/bin/src/mcp/permissions.js +50 -0
  166. package/bin/src/mcp/permissions.js.map +1 -0
  167. package/bin/src/mcp/persistence.d.ts.map +1 -0
  168. package/bin/src/mcp/persistence.js +171 -0
  169. package/bin/src/mcp/persistence.js.map +1 -0
  170. package/bin/src/mcp/recovery.d.ts.map +1 -0
  171. package/bin/src/mcp/recovery.js +75 -0
  172. package/bin/src/mcp/recovery.js.map +1 -0
  173. package/bin/src/mcp/telemetry.d.ts.map +1 -0
  174. package/bin/src/mcp/telemetry.js +82 -0
  175. package/bin/src/mcp/telemetry.js.map +1 -0
  176. package/bin/src/mcp/toolRouter.d.ts.map +1 -0
  177. package/bin/src/mcp/toolRouter.js +127 -0
  178. package/bin/src/mcp/toolRouter.js.map +1 -0
  179. package/bin/src/mcp/transport.d.ts.map +1 -0
  180. package/bin/src/mcp/transport.js +328 -0
  181. package/bin/src/mcp/transport.js.map +1 -0
  182. package/bin/src/mcp/types.d.ts.map +1 -0
  183. package/bin/src/mcp/types.js +6 -0
  184. package/bin/src/mcp/types.js.map +1 -0
  185. package/bin/src/server/server.d.ts.map +1 -0
  186. package/bin/src/server/server.js +989 -0
  187. package/bin/src/server/server.js.map +1 -0
  188. package/bin/src/utils/admin.d.ts.map +1 -0
  189. package/bin/src/utils/admin.js +231 -0
  190. package/bin/src/utils/admin.js.map +1 -0
  191. package/bin/src/utils/auditLogger.d.ts.map +1 -0
  192. package/bin/src/utils/auditLogger.js +70 -0
  193. package/bin/src/utils/auditLogger.js.map +1 -0
  194. package/bin/src/utils/auth.d.ts.map +1 -0
  195. package/bin/src/utils/auth.js +679 -0
  196. package/bin/src/utils/auth.js.map +1 -0
  197. package/bin/src/utils/branding.d.ts.map +1 -0
  198. package/bin/src/utils/branding.js +14 -0
  199. package/bin/src/utils/branding.js.map +1 -0
  200. package/bin/src/utils/config.d.ts.map +1 -1
  201. package/bin/src/utils/config.js +124 -3
  202. package/bin/src/utils/config.js.map +1 -1
  203. package/bin/src/utils/email.d.ts.map +1 -0
  204. package/bin/src/utils/email.js +267 -0
  205. package/bin/src/utils/email.js.map +1 -0
  206. package/bin/src/utils/firebaseAuth.d.ts.map +1 -0
  207. package/bin/src/utils/firebaseAuth.js +174 -0
  208. package/bin/src/utils/firebaseAuth.js.map +1 -0
  209. package/bin/src/utils/holoseneAuth.d.ts.map +1 -0
  210. package/bin/src/utils/holoseneAuth.js +307 -0
  211. package/bin/src/utils/holoseneAuth.js.map +1 -0
  212. package/bin/src/utils/language.d.ts.map +1 -0
  213. package/bin/src/utils/language.js +181 -0
  214. package/bin/src/utils/language.js.map +1 -0
  215. package/bin/src/utils/markdown.d.ts.map +1 -0
  216. package/bin/src/utils/markdown.js +215 -0
  217. package/bin/src/utils/markdown.js.map +1 -0
  218. package/bin/src/utils/payment.d.ts.map +1 -0
  219. package/bin/src/utils/payment.js +290 -0
  220. package/bin/src/utils/payment.js.map +1 -0
  221. package/bin/src/utils/pricing.d.ts.map +1 -0
  222. package/bin/src/utils/pricing.js +165 -0
  223. package/bin/src/utils/pricing.js.map +1 -0
  224. package/bin/src/utils/razorpay.d.ts.map +1 -0
  225. package/bin/src/utils/razorpay.js +144 -0
  226. package/bin/src/utils/razorpay.js.map +1 -0
  227. package/bin/src/utils/session.d.ts.map +1 -0
  228. package/bin/src/utils/session.js +82 -0
  229. package/bin/src/utils/session.js.map +1 -0
  230. package/bin/src/utils/updateCheck.d.ts.map +1 -0
  231. package/bin/src/utils/updateCheck.js +108 -0
  232. package/bin/src/utils/updateCheck.js.map +1 -0
  233. package/downloads/invoice-2026-03.pdf +1 -0
  234. package/firebase.json +74 -0
  235. package/package.json +49 -46
  236. package/web/ScoutFavicon.png +0 -0
  237. package/web/app.js +3944 -0
  238. package/web/styles.css +3081 -0
  239. package/.ft/context.json +0 -18
  240. package/email-template.html +0 -223
  241. package/email-template.txt +0 -45
  242. package/scripts/send-brevo-campaign.cjs +0 -167
  243. package/scripts/send-email.js +0 -77
package/.ft/context.json DELETED
@@ -1,18 +0,0 @@
1
- {
2
- "projectName": "FrontTerrainApp",
3
- "repoUrl": "https://github.com/dark2quasar/Front-Terrain/FrontTerrainApp.git",
4
- "targetDir": "C:\\Users\\rishi\\AppData\\Local\\Temp\\ft-scout-repos\\FrontTerrainApp-1785465176613",
5
- "stack": "The FrontTerrainApp project is a social media application built with Flutter and React, utilizing Firebase for hosting and backend services. Its core stack includes TypeScript, React, and Flutter, with a mix of JavaScript and Python scripts for specific tasks.",
6
- "entryPoint": "lib/main.dart",
7
- "painPoints": [
8
- "Complex folder structure with multiple build configurations",
9
- "Usage of both Flutter and React, potentially leading to inconsistencies in code style and architecture"
10
- ],
11
- "readOrder": [
12
- "lib/main.dart",
13
- "package.json",
14
- "pubspec.yaml",
15
- "firebase.json"
16
- ],
17
- "createdAt": "2026-07-31T02:33:02.673Z"
18
- }
package/email-template.html DELETED
@@ -1,223 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="utf-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Introducing FrontTerrain (ft-scout)</title>
7
- <style>
8
- body {
9
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
10
- background-color: #0f172a;
11
- margin: 0;
12
- padding: 40px 12px;
13
- color: #e2e8f0;
14
- }
15
- .container {
16
- max-width: 620px;
17
- margin: 0 auto;
18
- background: #1e293b;
19
- border-radius: 16px;
20
- overflow: hidden;
21
- box-shadow: 0 10px 30px rgba(0, 0, 0, 0.4);
22
- border: 1px solid #334155;
23
- }
24
- .header {
25
- background: linear-gradient(135deg, #0284c7 0%, #0d9488 100%);
26
- padding: 40px 30px;
27
- text-align: center;
28
- color: #ffffff;
29
- }
30
- .badge {
31
- display: inline-block;
32
- background: rgba(255, 255, 255, 0.2);
33
- color: #ffffff;
34
- font-size: 11px;
35
- font-weight: 700;
36
- padding: 4px 14px;
37
- border-radius: 20px;
38
- text-transform: uppercase;
39
- letter-spacing: 1px;
40
- margin-bottom: 12px;
41
- }
42
- .header h1 {
43
- margin: 0;
44
- font-size: 28px;
45
- font-weight: 800;
46
- letter-spacing: -0.5px;
47
- }
48
- .header p {
49
- margin-top: 10px;
50
- color: #e0f2fe;
51
- font-size: 16px;
52
- font-weight: 400;
53
- }
54
- .content {
55
- padding: 36px 30px;
56
- }
57
- .intro {
58
- font-size: 16px;
59
- line-height: 1.7;
60
- color: #cbd5e1;
61
- margin-bottom: 28px;
62
- }
63
- .section-title {
64
- font-size: 18px;
65
- font-weight: 700;
66
- color: #f8fafc;
67
- margin-bottom: 16px;
68
- display: flex;
69
- align-items: center;
70
- }
71
- .feature-card {
72
- background: #0f172a;
73
- border: 1px solid #334155;
74
- border-radius: 12px;
75
- padding: 20px;
76
- margin-bottom: 16px;
77
- transition: transform 0.2s;
78
- }
79
- .feature-header {
80
- display: flex;
81
- align-items: center;
82
- margin-bottom: 8px;
83
- }
84
- .command-tag {
85
- background: #0284c7;
86
- color: #ffffff;
87
- font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
88
- font-weight: 700;
89
- font-size: 13px;
90
- padding: 4px 10px;
91
- border-radius: 6px;
92
- margin-right: 10px;
93
- }
94
- .feature-name {
95
- font-weight: 700;
96
- font-size: 16px;
97
- color: #f8fafc;
98
- }
99
- .feature-desc {
100
- font-size: 14px;
101
- color: #94a3b8;
102
- margin: 0;
103
- line-height: 1.6;
104
- }
105
- .code-box {
106
- background: #090d16;
107
- color: #38bdf8;
108
- padding: 20px;
109
- border-radius: 10px;
110
- font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
111
- font-size: 14px;
112
- line-height: 1.8;
113
- margin: 28px 0;
114
- border: 1px solid #1e293b;
115
- }
116
- .code-box span.comment {
117
- color: #64748b;
118
- }
119
- .code-box span.cmd {
120
- color: #4ade80;
121
- }
122
- .cta-container {
123
- text-align: center;
124
- margin: 36px 0 20px 0;
125
- }
126
- .btn {
127
- background: linear-gradient(135deg, #0284c7 0%, #0d9488 100%);
128
- color: #ffffff !important;
129
- padding: 16px 36px;
130
- border-radius: 10px;
131
- text-decoration: none;
132
- font-weight: 700;
133
- display: inline-block;
134
- font-size: 16px;
135
- box-shadow: 0 4px 14px rgba(2, 132, 199, 0.4);
136
- }
137
- .footer {
138
- background: #0f172a;
139
- text-align: center;
140
- padding: 24px;
141
- font-size: 13px;
142
- color: #64748b;
143
- border-top: 1px solid #334155;
144
- }
145
- .footer a {
146
- color: #38bdf8;
147
- text-decoration: none;
148
- }
149
- </style>
150
- </head>
151
- <body>
152
- <div class="container">
153
- <div class="header">
154
- <span class="badge">V1.0.8 RELEASE</span>
155
- <h1>FrontTerrain (<code>ft-scout</code>)</h1>
156
- <p>The AI Onboarding Co-Pilot for New Codebases</p>
157
- </div>
158
-
159
- <div class="content">
160
- <p class="intro">
161
- Hey FrontTerrain Developer šŸ‘‹,<br><br>
162
- Jumping into a massive or legacy codebase can be intimidating. You waste hours deciphering complex file structures, guessing who owns which module, or accidentally editing fragile hotspots.<br><br>
163
- Thatā€™s why we built <strong><code>ft-scout</code> (FrontTerrain CLI)</strong> ā€” your AI co-pilot designed to give you instant codebase clarity directly inside your terminal!
164
- </p>
165
-
166
- <div class="section-title">āš” What You Can Do with <code>ft-scout</code>:</div>
167
-
168
- <div class="feature-card">
169
- <div class="feature-header">
170
- <span class="command-tag">ft brief</span>
171
- <span class="feature-name">AI Onboarding Summary</span>
172
- </div>
173
- <p class="feature-desc">Get an instant, human-readable summary of repository architecture, tech stack, and key modules so you can start contributing immediately.</p>
174
- </div>
175
-
176
- <div class="feature-card">
177
- <div class="feature-header">
178
- <span class="command-tag">ft risky</span>
179
- <span class="feature-name">Code Fragility Risk Map</span>
180
- </div>
181
- <p class="feature-desc">Analyzes commit churn, hotfixes, and historical regressions to alert you about high-risk hotspots and line ranges before you touch them.</p>
182
- </div>
183
-
184
- <div class="feature-card">
185
- <div class="feature-header">
186
- <span class="command-tag">ft owners &lt;path&gt;</span>
187
- <span class="feature-name">Domain Knowledge Holders</span>
188
- </div>
189
- <p class="feature-desc">Identifies true code experts based on real commit frequency and authorshipā€”so you know exactly who to loop into code reviews.</p>
190
- </div>
191
-
192
- <div class="feature-card">
193
- <div class="feature-header">
194
- <span class="command-tag">ft setup</span>
195
- <span class="feature-name">Local Dev Diagnostic</span>
196
- </div>
197
- <p class="feature-desc">Automatically scans missing <code>.env</code> keys, node runtime mismatches, and configuration issues before they break your local build.</p>
198
- </div>
199
-
200
- <div class="section-title" style="margin-top: 32px;">šŸš€ Quick Start Guide</div>
201
-
202
- <div class="code-box">
203
- <span class="comment"># 1. Install ft-scout globally via npm</span><br>
204
- <span class="cmd">npm install -g ft-scout</span><br><br>
205
- <span class="comment"># 2. Run inside any Git codebase</span><br>
206
- <span class="cmd">ft init</span><br><br>
207
- <span class="comment"># 3. Get your onboarding brief & risk map</span><br>
208
- <span class="cmd">ft brief</span><br>
209
- <span class="cmd">ft risky</span>
210
- </div>
211
-
212
- <div class="cta-container">
213
- <a href="https://github.com/Front-Terrain/FT-Check#readme" class="btn" target="_blank">Explore Documentation & GitHub</a>
214
- </div>
215
- </div>
216
-
217
- <div class="footer">
218
- <p>Built with ā¤ļø by Front Terrain</p>
219
- <p><a href="https://github.com/Front-Terrain/FT-Check">GitHub Repository</a> | <a href="https://github.com/Front-Terrain/FT-Check/issues">Report Issues</a></p>
220
- </div>
221
- </div>
222
- </body>
223
- </html>
package/email-template.txt DELETED
@@ -1,45 +0,0 @@
1
- Subject: šŸš€ Introducing FrontTerrain (ft-scout): Your AI Onboarding Co-Pilot for Codebases
2
- Preheader: Instant codebase summaries, fragility risk maps, and knowledge owner detection in your terminal.
3
-
4
- Hey FrontTerrain Developer šŸ‘‹,
5
-
6
- Jumping into a massive or legacy codebase can be intimidating. You waste hours deciphering complex file structures, guessing who owns which module, or accidentally editing fragile hotspots.
7
-
8
- Thatā€™s why we built ft-scout (FrontTerrain CLI v1.0.7) ā€” your AI co-pilot designed to give you instant codebase clarity directly inside your terminal!
9
-
10
- ---
11
-
12
- āš” WHAT YOU CAN DO WITH FT-SCOUT:
13
-
14
- 1. ft brief ā€” AI Onboarding Summary
15
- Get an instant, human-readable summary of repository architecture, tech stack, and key modules so you can start contributing immediately.
16
-
17
- 2. ft risky ā€” Code Fragility Risk Map
18
- Analyzes commit churn, hotfixes, and historical regressions to alert you about high-risk hotspots and line ranges before you touch them.
19
-
20
- 3. ft owners <path> ā€” Domain Knowledge Holders
21
- Identifies true code experts based on real commit frequency and authorshipā€”so you know exactly who to loop into code reviews.
22
-
23
- 4. ft setup ā€” Local Dev Diagnostic
24
- Automatically scans missing .env keys, node runtime mismatches, and configuration issues before they break your local build.
25
-
26
- ---
27
-
28
- šŸš€ QUICK START GUIDE:
29
-
30
- 1. Install ft-scout globally via npm:
31
- $ npm install -g ft-scout
32
-
33
- 2. Run inside any Git codebase:
34
- $ ft init
35
-
36
- 3. Get your onboarding brief & risk map:
37
- $ ft brief
38
- $ ft risky
39
-
40
- ---
41
-
42
- šŸ”— GitHub & Documentation: https://github.com/Front-Terrain/FT-Check#readme
43
-
44
- Happy Coding! šŸš€
45
- Front Terrain Team
package/scripts/send-brevo-campaign.cjs DELETED
@@ -1,167 +0,0 @@
1
- const fs = require('fs');
2
- const path = require('path');
3
-
4
- // Try requiring nodemailer from FrontTerrain if not in current node_modules
5
- let nodemailer;
6
- try {
7
- nodemailer = require('nodemailer');
8
- } catch {
9
- try {
10
- nodemailer = require('C:/Users/rishi/FrontTerrain/node_modules/nodemailer');
11
- } catch {
12
- nodemailer = require('C:/Users/rishi/FrontTerrain/functions/node_modules/nodemailer');
13
- }
14
- }
15
-
16
- // Try requiring firebase-admin from FrontTerrain
17
- let admin;
18
- try {
19
- admin = require('firebase-admin');
20
- } catch {
21
- try {
22
- admin = require('C:/Users/rishi/FrontTerrain/node_modules/firebase-admin');
23
- } catch {
24
- admin = require('C:/Users/rishi/FrontTerrain/functions/node_modules/firebase-admin');
25
- }
26
- }
27
-
28
- const serviceAccountPath = 'C:/Users/rishi/FrontTerrain/ServiceAccountKey.json';
29
-
30
- const BREVO_USER = 'b23077001@smtp-brevo.com';
31
- const BREVO_PASS = 'xsmtpsib-63ad84e2307ca830b499c8921f1a242cab01b6f938119cf453e81ab854f643a3-RLpSOgjpmtGZN1NT';
32
- const FROM_EMAIL = '"FrontTerrain" <noreply@frontterrain.com>';
33
- const SUBJECT = 'šŸš€ Introducing FrontTerrain (ft-scout): Your AI Onboarding Co-Pilot for Codebases';
34
-
35
- const htmlPath = path.join(__dirname, '../email-template.html');
36
- const textPath = path.join(__dirname, '../email-template.txt');
37
-
38
- const htmlContent = fs.readFileSync(htmlPath, 'utf8');
39
- const textContent = fs.readFileSync(textPath, 'utf8');
40
-
41
- const transporter = nodemailer.createTransport({
42
- host: 'smtp-relay.brevo.com',
43
- port: 587,
44
- secure: false,
45
- auth: {
46
- user: BREVO_USER,
47
- pass: BREVO_PASS,
48
- },
49
- });
50
-
51
- async function getAllUserEmails() {
52
- const emails = new Set();
53
-
54
- if (fs.existsSync(serviceAccountPath)) {
55
- try {
56
- const serviceAccount = require(serviceAccountPath);
57
- if (!admin.apps.length) {
58
- admin.initializeApp({
59
- credential: admin.credential.cert(serviceAccount),
60
- });
61
- }
62
-
63
- // Fetch from Firestore users collection
64
- const db = admin.firestore();
65
- const snapshot = await db.collection('users').get();
66
- snapshot.forEach((doc) => {
67
- const data = doc.data();
68
- if (data.email) emails.add(data.email.trim().toLowerCase());
69
- });
70
-
71
- // Fetch from Firebase Auth users list
72
- let nextPageToken;
73
- do {
74
- const listUsersResult = await admin.auth().listUsers(1000, nextPageToken);
75
- listUsersResult.users.forEach((userRecord) => {
76
- if (userRecord.email) emails.add(userRecord.email.trim().toLowerCase());
77
- });
78
- nextPageToken = listUsersResult.pageToken;
79
- } while (nextPageToken);
80
- } catch (err) {
81
- console.warn('āš ļø Could not fetch users from Firebase:', err.message);
82
- }
83
- }
84
-
85
- // Also check if local users.json exists
86
- const usersJsonPath = path.join(__dirname, '../users.json');
87
- if (fs.existsSync(usersJsonPath)) {
88
- try {
89
- const localUsers = JSON.parse(fs.readFileSync(usersJsonPath, 'utf8'));
90
- localUsers.forEach((e) => emails.add(e.trim().toLowerCase()));
91
- } catch (e) {}
92
- }
93
-
94
- return Array.from(emails);
95
- }
96
-
97
- async function main() {
98
- const args = process.argv.slice(2);
99
- const isSendMode = args.includes('--send');
100
- const testEmailArg = args.find((a) => a.startsWith('--test='));
101
- const testEmail = testEmailArg ? testEmailArg.split('=')[1] : null;
102
-
103
- console.log('\n=================================================');
104
- console.log('šŸš€ FrontTerrain ft-scout Brevo Email Dispatcher');
105
- console.log('=================================================\n');
106
-
107
- if (testEmail) {
108
- console.log(`āœ‰ļø Sending test email to: ${testEmail}...`);
109
- const info = await transporter.sendMail({
110
- from: FROM_EMAIL,
111
- to: testEmail,
112
- subject: `${SUBJECT}`,
113
- html: htmlContent,
114
- text: textContent,
115
- });
116
- console.log(`āœ… Test email sent successfully! MessageID: ${info.messageId || info.response}`);
117
- return;
118
- }
119
-
120
- console.log('šŸ” Fetching all FT users...');
121
- const recipients = await getAllUserEmails();
122
- console.log(`šŸ“Š Found ${recipients.length} total FT user email address(es):\n`);
123
- recipients.forEach((email, i) => console.log(` ${i + 1}. ${email}`));
124
-
125
- if (recipients.length === 0) {
126
- console.log('\nāš ļø No user emails found. Please verify Firebase connection or users.json file.');
127
- return;
128
- }
129
-
130
- if (!isSendMode) {
131
- console.log('\n-------------------------------------------------');
132
- console.log('šŸ“Œ DRY-RUN MODE (No emails sent).');
133
- console.log('To send a test email first, run:');
134
- console.log(' node scripts/send-brevo-campaign.cjs --test=your_email@domain.com\n');
135
- console.log('To send to ALL users above, run:');
136
- console.log(' node scripts/send-brevo-campaign.cjs --send');
137
- console.log('-------------------------------------------------\n');
138
- return;
139
- }
140
-
141
- console.log('\nšŸš€ Starting bulk email dispatch via Brevo SMTP...');
142
- let successCount = 0;
143
- let failCount = 0;
144
-
145
- for (const email of recipients) {
146
- try {
147
- const info = await transporter.sendMail({
148
- from: FROM_EMAIL,
149
- to: email,
150
- subject: SUBJECT,
151
- html: htmlContent,
152
- text: textContent,
153
- });
154
- successCount++;
155
- console.log(`āœ… [${successCount}/${recipients.length}] Sent to ${email} (MessageID: ${info.messageId || info.response})`);
156
- } catch (err) {
157
- failCount++;
158
- console.error(`āŒ Failed to send to ${email}:`, err.message);
159
- }
160
- }
161
-
162
- console.log('\n=================================================');
163
- console.log(`šŸŽ‰ Campaign Complete: ${successCount} Sent, ${failCount} Failed.`);
164
- console.log('=================================================\n');
165
- }
166
-
167
- main().catch(console.error);
package/scripts/send-email.js DELETED
@@ -1,77 +0,0 @@
1
- import fs from 'fs';
2
- import path from 'path';
3
- import { fileURLToPath } from 'url';
4
-
5
- /**
6
- * FrontTerrain (ft-scout) Email Dispatch Script
7
- *
8
- * Usage:
9
- * 1. Set environment variables:
10
- * export RESEND_API_KEY="re_123456789"
11
- * (or SENDGRID_API_KEY="SG.xxx")
12
- * 2. Create `users.json` containing an array of emails:
13
- * ["user1@example.com", "user2@example.com"]
14
- * 3. Run: node scripts/send-email.js
15
- */
16
-
17
- const __filename = fileURLToPath(import.meta.url);
18
- const __dirname = path.dirname(__filename);
19
-
20
- const htmlTemplatePath = path.join(__dirname, '../email-template.html');
21
- const textTemplatePath = path.join(__dirname, '../email-template.txt');
22
-
23
- const htmlContent = fs.readFileSync(htmlTemplatePath, 'utf8');
24
- const textContent = fs.readFileSync(textTemplatePath, 'utf8');
25
-
26
- async function sendEmailResend(apiKey, recipients) {
27
- console.log(`Sending email to ${recipients.length} recipients via Resend API...`);
28
-
29
- for (const email of recipients) {
30
- try {
31
- const response = await fetch('https://api.resend.com/emails', {
32
- method: 'POST',
33
- headers: {
34
- 'Authorization': `Bearer ${apiKey}`,
35
- 'Content-Type': 'application/json'
36
- },
37
- body: JSON.stringify({
38
- from: 'FrontTerrain <updates@frontterrain.com>',
39
- to: [email],
40
- subject: 'šŸš€ Introducing FrontTerrain (ft-scout): Your AI Onboarding Co-Pilot',
41
- html: htmlContent,
42
- text: textContent
43
- })
44
- });
45
- const data = await response.json();
46
- if (response.ok) {
47
- console.log(`āœ… Sent to ${email} (ID: ${data.id})`);
48
- } else {
49
- console.error(`āŒ Failed to send to ${email}:`, data);
50
- }
51
- } catch (err) {
52
- console.error(`āŒ Error sending to ${email}:`, err.message);
53
- }
54
- }
55
- }
56
-
57
- async function main() {
58
- const usersFilePath = path.join(__dirname, '../users.json');
59
- if (!fs.existsSync(usersFilePath)) {
60
- console.log('ā„¹ļø No users.json file found. Creating example users.json...');
61
- fs.writeFileSync(usersFilePath, JSON.stringify(["user1@example.com", "user2@example.com"], null, 2));
62
- console.log('šŸ“ Please edit `users.json` with your real user emails list.');
63
- return;
64
- }
65
-
66
- const recipients = JSON.parse(fs.readFileSync(usersFilePath, 'utf8'));
67
- const resendApiKey = process.env.RESEND_API_KEY;
68
-
69
- if (resendApiKey) {
70
- await sendEmailResend(resendApiKey, recipients);
71
- } else {
72
- console.log('\nāš ļø No API Key detected.');
73
- console.log('Set `RESEND_API_KEY` or copy the content from `email-template.html` / `email-template.txt` into Mailchimp/SendGrid/Brevo.');
74
- }
75
- }
76
-
77
- main().catch(console.error);