open-local-audit 0.37.0 → 0.38.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 (8) hide show
  1. package/CHANGELOG.md +273 -267
  2. package/README.md +402 -399
  3. package/dist/cli.js +6 -4
  4. package/dist/cli.js.map +1 -1
  5. package/dist/shortlist.d.ts +1 -0
  6. package/dist/shortlist.js +1 -0
  7. package/dist/shortlist.js.map +1 -1
  8. package/package.json +62 -62
package/CHANGELOG.md CHANGED
@@ -1,267 +1,273 @@
1
- # Changelog
2
-
3
- All notable changes to Open Local Audit will be documented here.
4
-
5
- ## Unreleased
6
-
7
- ## v0.37.0 - 2026-06-17
8
-
9
- - Added `shortlist --missing-website` for local website-backlog shortlist filtering.
10
- - Applied missing-website filtering after review suppression and before sorting and top-N selection.
11
- - Kept missing-website filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
12
-
13
- ## v0.36.0 - 2026-06-16
14
-
15
- - Added `shortlist --missing-contact` for local contact-backlog shortlist filtering.
16
- - Applied missing-contact filtering after review suppression and before sorting and top-N selection.
17
- - Kept missing-contact filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
18
-
19
- ## v0.35.0 - 2026-06-15
20
-
21
- - Added `shortlist --missing-report` for local report-backlog shortlist filtering.
22
- - Applied missing-report filtering after review suppression and before sorting and top-N selection.
23
- - Kept missing-report filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
24
-
25
- ## v0.34.0 - 2026-06-14
26
-
27
- - Added `shortlist --preferred-contact-channel <channel>` for local outreach-channel shortlist filtering.
28
- - Applied preferred-contact-channel filtering after review suppression and before sorting and top-N selection.
29
- - Kept preferred-contact-channel filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
30
-
31
- ## v0.33.0 - 2026-06-13
32
-
33
- - Added `shortlist --require-report` for local report-ready shortlist filtering.
34
- - Applied report-required filtering after review suppression and before sorting and top-N selection.
35
- - Kept report-required filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
36
-
37
- ## v0.32.0 - 2026-06-12
38
-
39
- - Added `shortlist --require-contact` for local contact-ready shortlist filtering.
40
- - Applied contact-required filtering after review suppression and before sorting and top-N selection.
41
- - Kept contact-required filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
42
-
43
- ## v0.31.0 - 2026-06-11
44
-
45
- - Added `shortlist --require-website` for local website-present shortlist filtering.
46
- - Applied website-required filtering after review suppression and before sorting and top-N selection.
47
- - Kept website-required filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
48
-
49
- ## v0.30.0 - 2026-06-09
50
-
51
- - Added `shortlist --exclude-review-status <status>` for local active-review-status exclusion.
52
- - Applied review-status exclusion after review suppression and before sorting and top-N selection.
53
- - Kept exclusion filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
54
-
55
- ## v0.29.0 - 2026-06-08
56
-
57
- - Added `shortlist --summary-json <path>` for separate local automation summary output.
58
- - Added `renderShortlistSummaryJson` for package consumers.
59
- - Kept summary output local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
60
-
61
- ## v0.28.0 - 2026-06-07
62
-
63
- - Added `shortlist --sort <sort>` for local shortlist ranking control.
64
- - Supported `opportunity-desc`, `score-desc`, `company-asc`, and `last-reviewed-asc` sort modes.
65
- - Kept sorting local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
66
-
67
- ## v0.27.0 - 2026-06-06
68
-
69
- - Added `shortlist --review-status <status>` for active review-state filtering.
70
- - Applied review-status filtering after review-state suppression and before ranking and top-N selection.
71
- - Kept review-status filtering local-only with no review CSV mutation, source CSV mutation, API calls, outreach sending, or CRM sync.
72
-
73
- ## v0.26.0 - 2026-06-05
74
-
75
- - Added `shortlist` focus filters for segment, profile, priority, and contact confidence.
76
- - Combined supplied focus filters with case-insensitive `AND` matching.
77
- - Applied focus filters after review suppression and before ranking and top-N selection.
78
- - Kept focus filtering local-only with no source CSV mutation, API calls, outreach sending, or CRM sync.
79
-
80
- ## v0.25.0 - 2026-06-04
81
-
82
- - Added `shortlist --min-opportunity-score <score>` for local shortlist filtering.
83
- - Filtered low-opportunity shortlist leads after review-state suppression and before top-N ranking.
84
- - Reported filtered row counts in CLI output, Markdown summaries, and JSON results.
85
- - Kept shortlist filtering local-only with no API calls, outreach sending, review CSV mutation, or CRM sync.
86
-
87
- ## v0.24.0 - 2026-06-03
88
-
89
- - Added `shortlist --format csv` for spreadsheet-ready local shortlist output.
90
- - Included rank, scoring, contact handoff, review context, lead key, and report path columns in CSV shortlist reports.
91
- - Reused existing CSV cell hardening so formula-like shortlist values are neutralized before spreadsheet review.
92
- - Kept CSV shortlist generation local-only with no API calls, outreach sending, review CSV mutation, or CRM sync.
93
-
94
- ## v0.23.0 - 2026-06-01
95
-
96
- - Added `shortlist --review-csv <path>` for local review-state aware shortlist runs.
97
- - Suppressed already handled shortlist leads marked `rejected`, `contacted`, `not-fit`, `not_a_fit`, `do-not-contact`, or `suppressed`.
98
- - Carried active review status, review reason, and last-reviewed date into Markdown and JSON shortlist reports.
99
- - Kept shortlist review handling local-only with no review CSV mutation, API calls, outreach sending, or CRM sync.
100
-
101
- ## v0.22.0 - 2026-05-31
102
-
103
- - Added `shortlist --input <path> --out <path>` for local lead shortlist reports.
104
- - Added Markdown and JSON shortlist output for discovery and CRM CSV exports.
105
- - Ranked leads by opportunity score, priority, contact confidence, audit score, and company name.
106
- - Kept shortlist generation local-only with no API calls, outreach sending, or CRM sync.
107
-
108
- ## v0.21.0 - 2026-05-28
109
-
110
- - Added `package-report --input <path> --out <path>` for local customer-shareable report packs.
111
- - Added report-pack `README.md`, `next-actions.md`, and `manifest.json` generation from existing single-site JSON reports.
112
- - Copied available JSON, Markdown, HTML, and PDF report artifacts into the local package.
113
- - Kept report packaging local-only with no uploads, outreach sending, or CRM sync.
114
-
115
- ## v0.20.0 - 2026-05-27
116
-
117
- - Added `validate-export --input <path> --preset crm` for local CRM CSV import checks.
118
- - Added Markdown and JSON validation reports with row counts, errors, warnings, and issue details.
119
- - Flagged missing CRM columns, missing company or website fields, duplicate lead keys, low contact confidence, and manual-review handoffs.
120
- - Kept validation local-only with no CRM API sync, remote import, or outreach sending.
121
-
122
- ## v0.19.0 - 2026-05-26
123
-
124
- - Added `--export-preset standard|crm` for batch and discovery CSV exports.
125
- - Added CRM-ready local import columns for company identity, website, scoring, contact handoff, source, lead key, and report path.
126
- - Preserved existing standard CSV export behavior as the default.
127
- - Kept CRM export local-only with no CRM API sync or outreach sending.
128
-
129
- ## v0.18.0 - 2026-05-23
130
-
131
- - Added batch index contact rollups for public contact coverage and confidence.
132
- - Added batch outreach rollups for preferred manual contact channels.
133
- - Added per-entry batch index contact and outreach metadata for successful audits.
134
- - Added batch CSV export columns for contact confidence, preferred contact channel, and contactability reason.
135
-
136
- ## v0.17.0 - 2026-05-22
137
-
138
- - Added advisory fuzzy duplicate candidate groups to discovery duplicate JSON output.
139
- - Added duplicate review reasons for likely business-label and website-domain similarity.
140
- - Preserved exact duplicate reporting while keeping fuzzy matching manual-review only.
141
- - Confirmed fuzzy duplicate review does not auto-suppress leads, send outreach, or sync to a CRM.
142
-
143
- ## v0.16.0 - 2026-05-20
144
-
145
- - Added discovery outreach handoff fields: `preferredContactChannel`, `outreachAction`, and `contactabilityReason`.
146
- - Added deterministic channel selection for email, WhatsApp, phone, contact-page, and manual-review discovery leads.
147
- - Preserved CSV formula hardening for the new outreach handoff fields.
148
-
149
- ## v0.15.0 - 2026-05-19
150
-
151
- - Added public contact extraction for audited pages, including email, phone, WhatsApp, contact-page, and social-profile signals.
152
- - Added Contact Readiness sections to Markdown, HTML, and PDF reports.
153
- - Added contact enrichment columns to discovery CSV exports while preserving CSV formula hardening.
154
-
155
- ## v0.14.0 - 2026-05-16
156
-
157
- - Added `--brand-config` for JSON-driven report branding across Markdown, HTML, and PDF outputs.
158
- - Added Executive Summary sections with business impact, top issues, and a recommended first fix.
159
- - Added lead export enrichment columns: `pitchAngle`, `recommendedOffer`, `estimatedNeed`, and `outreachPriorityReason`.
160
-
161
- ## v0.13.0 - 2026-05-15
162
-
163
- - Added opt-in Lighthouse category scoring with `--lighthouse`.
164
- - Added branded PDF report output with `--format pdf`.
165
- - Added `opportunityReasons` to discovery CSV exports so operators can explain lead scores.
166
- - Added Lighthouse sections to JSON, Markdown, HTML, and PDF reports.
167
-
168
- ## v0.12.0 - 2026-05-14
169
-
170
- - Added discovery suppression lists with `--suppression-list` to skip previously reviewed leads.
171
- - Added `leadKey`, `reviewStatus`, `reviewReason`, and `lastReviewedAt` columns to discovery CSV exports for local review workflows.
172
- - Added `--min-opportunity-score` for filtering discovery exports to higher-value opportunities.
173
- - Added `--review-csv` for merging local operator review decisions across discovery reruns.
174
- - Added `--duplicates-json` for reporting duplicate lead groups.
175
- - Added lawyer, clinic, gym, hotel, and auto-service industry profiles.
176
- - Polished HTML reports with a branded shell, summary cards, and stronger visual hierarchy.
177
- - Added Windows user-environment fallback for `GOOGLE_MAPS_API_KEY`.
178
-
179
- ## v0.11.0 - 2026-05-13
180
-
181
- - Added discovery controls: `--limit`, `--max-audits`, and `--summary-json`.
182
- - Added terminal discovery summary output for website, audit, priority, and average-score counts.
183
- - Added `opportunityScore` to discovery prospect CSV exports.
184
- - Added CSV formula-injection hardening for exported CSV cells.
185
- - Added a Google Maps Platform billing warning when `--provider google-places` is used.
186
-
187
- ## v0.10.0 - 2026-05-12
188
-
189
- - Added an opt-in `google-places` provider for `discover`.
190
- - Added `GOOGLE_MAPS_API_KEY` support for official Google Places Text Search requests.
191
- - Resolved official place website URLs through `websiteUri` where available.
192
- - Kept Google Places storage conservative: no Google Maps scraping, no reviews/photos/ratings collection, and no long-term raw Places data store.
193
- - Fed resolved Google Places websites into the existing audit pipeline and prospect CSV export.
194
-
195
- ## v0.9.0 - 2026-05-12
196
-
197
- - Added `discover --input places.csv --provider manual-csv` for operator-prepared lead discovery.
198
- - Added `leads.csv` prospect exports with website presence, audit status, priority, next action, report path, and error columns.
199
- - Reused the existing batch audit pipeline for website-present discovery rows.
200
- - Added `--dry-run` discovery mode for local prospect triage without website audits.
201
- - Documented the discovery boundary: no Google Maps scraping, no `google-places` provider calls, and no outreach sending in this release.
202
-
203
- ## v0.8.0 - 2026-05-12
204
-
205
- - Added `--concurrency` for controlled parallel batch audits.
206
- - Added batch index insights with average score, profile breakdown, segment breakdown, and frequent findings.
207
- - Added profile-specific findings for dental, beauty, restaurant, and contractor audits.
208
- - Expanded profile tests to cover missing and satisfied vertical conversion/trust signals.
209
-
210
- ## v0.7.0 - 2026-05-11
211
-
212
- - Added industry profiles with `--profile generic|dental|beauty|restaurant|contractor`.
213
- - Added optional `profile` CSV input column for batch audits.
214
- - Added profile metadata to JSON, Markdown, HTML, and batch index outputs.
215
- - Added `--export-csv` for batch prospect exports with score, top finding, report path, and error columns.
216
-
217
- ## v0.6.0 - 2026-05-10
218
-
219
- - Added `--screenshot` for rendered homepage screenshot capture.
220
- - Added visual evidence metadata to JSON reports.
221
- - Added Visual Evidence sections to Markdown and HTML reports.
222
- - Added batch screenshot artifact paths for per-site report folders.
223
-
224
- ## v0.5.0 - 2026-05-09
225
-
226
- - Added opt-in Playwright-rendered audits with `--render`.
227
- - Added batch triage controls with `--segment`, `--min-score`, `--top`, and `--sort`.
228
- - Added trust and conversion checks for current date signals, review cues, service detail depth, brand icons, and placeholder social profile links.
229
-
230
- ## v0.4.0 - 2026-05-09
231
-
232
- - Added resilient batch runs that keep auditing after individual URL failures.
233
- - Added aggregate batch index reports in JSON, Markdown, and HTML.
234
- - Added CSV batch input with `url`, `label`, and `segment` columns.
235
- - Added `@graph` JSON-LD support for structured-data checks.
236
- - Added LocalBusiness contact-field, Organization schema, visible address, opening-hours, service-location copy, primary CTA, and placeholder-copy checks.
237
-
238
- ## v0.3.0 - 2026-05-09
239
-
240
- - Added standalone HTML report rendering.
241
- - Added `--format html`.
242
- - Expanded `--format all` to write JSON, Markdown, and HTML reports.
243
- - Added `--input <path>` for batch audits from text files.
244
- - Added safe per-site output folders for batch reports.
245
-
246
- ## v0.2.0 - 2026-05-08
247
-
248
- - Added optional same-origin internal link scanning with `--check-links` and `--max-pages`.
249
- - Added a high-severity finding for broken internal links.
250
- - Added `--fail-on none|high|medium|low` for CI-friendly exit codes.
251
- - Added compact terminal summaries when reports are written to files.
252
- - Added integration tests for link scanning and CLI behavior helpers.
253
-
254
- ## v0.1.1 - 2026-05-08
255
-
256
- - Added `robots.txt`, `sitemap.xml`, Open Graph, and invalid JSON-LD checks.
257
- - Added `--format all --out-dir <path>` for writing JSON and Markdown reports together.
258
- - Added fixture-based rule tests and report output tests.
259
- - Added `npm run release-check` for local and CI release verification.
260
-
261
- ## v0.1.0 - 2026-05-08
262
-
263
- - Project documentation and release planning created.
264
- - Initial TypeScript CLI scaffold added.
265
- - JSON and Markdown report generation added.
266
- - Initial audit rule set and Vitest coverage added.
267
- - Example report artifacts added.
1
+ # Changelog
2
+
3
+ All notable changes to Open Local Audit will be documented here.
4
+
5
+ ## Unreleased
6
+
7
+ ## v0.38.0 - 2026-06-19
8
+
9
+ - Added `shortlist --unreviewed` for local first-review shortlist queues.
10
+ - Applied unreviewed filtering after review suppression and before sorting and top-N selection.
11
+ - Kept unreviewed filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
12
+
13
+ ## v0.37.0 - 2026-06-17
14
+
15
+ - Added `shortlist --missing-website` for local website-backlog shortlist filtering.
16
+ - Applied missing-website filtering after review suppression and before sorting and top-N selection.
17
+ - Kept missing-website filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
18
+
19
+ ## v0.36.0 - 2026-06-16
20
+
21
+ - Added `shortlist --missing-contact` for local contact-backlog shortlist filtering.
22
+ - Applied missing-contact filtering after review suppression and before sorting and top-N selection.
23
+ - Kept missing-contact filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
24
+
25
+ ## v0.35.0 - 2026-06-15
26
+
27
+ - Added `shortlist --missing-report` for local report-backlog shortlist filtering.
28
+ - Applied missing-report filtering after review suppression and before sorting and top-N selection.
29
+ - Kept missing-report filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
30
+
31
+ ## v0.34.0 - 2026-06-14
32
+
33
+ - Added `shortlist --preferred-contact-channel <channel>` for local outreach-channel shortlist filtering.
34
+ - Applied preferred-contact-channel filtering after review suppression and before sorting and top-N selection.
35
+ - Kept preferred-contact-channel filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
36
+
37
+ ## v0.33.0 - 2026-06-13
38
+
39
+ - Added `shortlist --require-report` for local report-ready shortlist filtering.
40
+ - Applied report-required filtering after review suppression and before sorting and top-N selection.
41
+ - Kept report-required filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
42
+
43
+ ## v0.32.0 - 2026-06-12
44
+
45
+ - Added `shortlist --require-contact` for local contact-ready shortlist filtering.
46
+ - Applied contact-required filtering after review suppression and before sorting and top-N selection.
47
+ - Kept contact-required filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
48
+
49
+ ## v0.31.0 - 2026-06-11
50
+
51
+ - Added `shortlist --require-website` for local website-present shortlist filtering.
52
+ - Applied website-required filtering after review suppression and before sorting and top-N selection.
53
+ - Kept website-required filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
54
+
55
+ ## v0.30.0 - 2026-06-09
56
+
57
+ - Added `shortlist --exclude-review-status <status>` for local active-review-status exclusion.
58
+ - Applied review-status exclusion after review suppression and before sorting and top-N selection.
59
+ - Kept exclusion filtering local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
60
+
61
+ ## v0.29.0 - 2026-06-08
62
+
63
+ - Added `shortlist --summary-json <path>` for separate local automation summary output.
64
+ - Added `renderShortlistSummaryJson` for package consumers.
65
+ - Kept summary output local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
66
+
67
+ ## v0.28.0 - 2026-06-07
68
+
69
+ - Added `shortlist --sort <sort>` for local shortlist ranking control.
70
+ - Supported `opportunity-desc`, `score-desc`, `company-asc`, and `last-reviewed-asc` sort modes.
71
+ - Kept sorting local-only with no source CSV mutation, review CSV mutation, API calls, outreach sending, or CRM sync.
72
+
73
+ ## v0.27.0 - 2026-06-06
74
+
75
+ - Added `shortlist --review-status <status>` for active review-state filtering.
76
+ - Applied review-status filtering after review-state suppression and before ranking and top-N selection.
77
+ - Kept review-status filtering local-only with no review CSV mutation, source CSV mutation, API calls, outreach sending, or CRM sync.
78
+
79
+ ## v0.26.0 - 2026-06-05
80
+
81
+ - Added `shortlist` focus filters for segment, profile, priority, and contact confidence.
82
+ - Combined supplied focus filters with case-insensitive `AND` matching.
83
+ - Applied focus filters after review suppression and before ranking and top-N selection.
84
+ - Kept focus filtering local-only with no source CSV mutation, API calls, outreach sending, or CRM sync.
85
+
86
+ ## v0.25.0 - 2026-06-04
87
+
88
+ - Added `shortlist --min-opportunity-score <score>` for local shortlist filtering.
89
+ - Filtered low-opportunity shortlist leads after review-state suppression and before top-N ranking.
90
+ - Reported filtered row counts in CLI output, Markdown summaries, and JSON results.
91
+ - Kept shortlist filtering local-only with no API calls, outreach sending, review CSV mutation, or CRM sync.
92
+
93
+ ## v0.24.0 - 2026-06-03
94
+
95
+ - Added `shortlist --format csv` for spreadsheet-ready local shortlist output.
96
+ - Included rank, scoring, contact handoff, review context, lead key, and report path columns in CSV shortlist reports.
97
+ - Reused existing CSV cell hardening so formula-like shortlist values are neutralized before spreadsheet review.
98
+ - Kept CSV shortlist generation local-only with no API calls, outreach sending, review CSV mutation, or CRM sync.
99
+
100
+ ## v0.23.0 - 2026-06-01
101
+
102
+ - Added `shortlist --review-csv <path>` for local review-state aware shortlist runs.
103
+ - Suppressed already handled shortlist leads marked `rejected`, `contacted`, `not-fit`, `not_a_fit`, `do-not-contact`, or `suppressed`.
104
+ - Carried active review status, review reason, and last-reviewed date into Markdown and JSON shortlist reports.
105
+ - Kept shortlist review handling local-only with no review CSV mutation, API calls, outreach sending, or CRM sync.
106
+
107
+ ## v0.22.0 - 2026-05-31
108
+
109
+ - Added `shortlist --input <path> --out <path>` for local lead shortlist reports.
110
+ - Added Markdown and JSON shortlist output for discovery and CRM CSV exports.
111
+ - Ranked leads by opportunity score, priority, contact confidence, audit score, and company name.
112
+ - Kept shortlist generation local-only with no API calls, outreach sending, or CRM sync.
113
+
114
+ ## v0.21.0 - 2026-05-28
115
+
116
+ - Added `package-report --input <path> --out <path>` for local customer-shareable report packs.
117
+ - Added report-pack `README.md`, `next-actions.md`, and `manifest.json` generation from existing single-site JSON reports.
118
+ - Copied available JSON, Markdown, HTML, and PDF report artifacts into the local package.
119
+ - Kept report packaging local-only with no uploads, outreach sending, or CRM sync.
120
+
121
+ ## v0.20.0 - 2026-05-27
122
+
123
+ - Added `validate-export --input <path> --preset crm` for local CRM CSV import checks.
124
+ - Added Markdown and JSON validation reports with row counts, errors, warnings, and issue details.
125
+ - Flagged missing CRM columns, missing company or website fields, duplicate lead keys, low contact confidence, and manual-review handoffs.
126
+ - Kept validation local-only with no CRM API sync, remote import, or outreach sending.
127
+
128
+ ## v0.19.0 - 2026-05-26
129
+
130
+ - Added `--export-preset standard|crm` for batch and discovery CSV exports.
131
+ - Added CRM-ready local import columns for company identity, website, scoring, contact handoff, source, lead key, and report path.
132
+ - Preserved existing standard CSV export behavior as the default.
133
+ - Kept CRM export local-only with no CRM API sync or outreach sending.
134
+
135
+ ## v0.18.0 - 2026-05-23
136
+
137
+ - Added batch index contact rollups for public contact coverage and confidence.
138
+ - Added batch outreach rollups for preferred manual contact channels.
139
+ - Added per-entry batch index contact and outreach metadata for successful audits.
140
+ - Added batch CSV export columns for contact confidence, preferred contact channel, and contactability reason.
141
+
142
+ ## v0.17.0 - 2026-05-22
143
+
144
+ - Added advisory fuzzy duplicate candidate groups to discovery duplicate JSON output.
145
+ - Added duplicate review reasons for likely business-label and website-domain similarity.
146
+ - Preserved exact duplicate reporting while keeping fuzzy matching manual-review only.
147
+ - Confirmed fuzzy duplicate review does not auto-suppress leads, send outreach, or sync to a CRM.
148
+
149
+ ## v0.16.0 - 2026-05-20
150
+
151
+ - Added discovery outreach handoff fields: `preferredContactChannel`, `outreachAction`, and `contactabilityReason`.
152
+ - Added deterministic channel selection for email, WhatsApp, phone, contact-page, and manual-review discovery leads.
153
+ - Preserved CSV formula hardening for the new outreach handoff fields.
154
+
155
+ ## v0.15.0 - 2026-05-19
156
+
157
+ - Added public contact extraction for audited pages, including email, phone, WhatsApp, contact-page, and social-profile signals.
158
+ - Added Contact Readiness sections to Markdown, HTML, and PDF reports.
159
+ - Added contact enrichment columns to discovery CSV exports while preserving CSV formula hardening.
160
+
161
+ ## v0.14.0 - 2026-05-16
162
+
163
+ - Added `--brand-config` for JSON-driven report branding across Markdown, HTML, and PDF outputs.
164
+ - Added Executive Summary sections with business impact, top issues, and a recommended first fix.
165
+ - Added lead export enrichment columns: `pitchAngle`, `recommendedOffer`, `estimatedNeed`, and `outreachPriorityReason`.
166
+
167
+ ## v0.13.0 - 2026-05-15
168
+
169
+ - Added opt-in Lighthouse category scoring with `--lighthouse`.
170
+ - Added branded PDF report output with `--format pdf`.
171
+ - Added `opportunityReasons` to discovery CSV exports so operators can explain lead scores.
172
+ - Added Lighthouse sections to JSON, Markdown, HTML, and PDF reports.
173
+
174
+ ## v0.12.0 - 2026-05-14
175
+
176
+ - Added discovery suppression lists with `--suppression-list` to skip previously reviewed leads.
177
+ - Added `leadKey`, `reviewStatus`, `reviewReason`, and `lastReviewedAt` columns to discovery CSV exports for local review workflows.
178
+ - Added `--min-opportunity-score` for filtering discovery exports to higher-value opportunities.
179
+ - Added `--review-csv` for merging local operator review decisions across discovery reruns.
180
+ - Added `--duplicates-json` for reporting duplicate lead groups.
181
+ - Added lawyer, clinic, gym, hotel, and auto-service industry profiles.
182
+ - Polished HTML reports with a branded shell, summary cards, and stronger visual hierarchy.
183
+ - Added Windows user-environment fallback for `GOOGLE_MAPS_API_KEY`.
184
+
185
+ ## v0.11.0 - 2026-05-13
186
+
187
+ - Added discovery controls: `--limit`, `--max-audits`, and `--summary-json`.
188
+ - Added terminal discovery summary output for website, audit, priority, and average-score counts.
189
+ - Added `opportunityScore` to discovery prospect CSV exports.
190
+ - Added CSV formula-injection hardening for exported CSV cells.
191
+ - Added a Google Maps Platform billing warning when `--provider google-places` is used.
192
+
193
+ ## v0.10.0 - 2026-05-12
194
+
195
+ - Added an opt-in `google-places` provider for `discover`.
196
+ - Added `GOOGLE_MAPS_API_KEY` support for official Google Places Text Search requests.
197
+ - Resolved official place website URLs through `websiteUri` where available.
198
+ - Kept Google Places storage conservative: no Google Maps scraping, no reviews/photos/ratings collection, and no long-term raw Places data store.
199
+ - Fed resolved Google Places websites into the existing audit pipeline and prospect CSV export.
200
+
201
+ ## v0.9.0 - 2026-05-12
202
+
203
+ - Added `discover --input places.csv --provider manual-csv` for operator-prepared lead discovery.
204
+ - Added `leads.csv` prospect exports with website presence, audit status, priority, next action, report path, and error columns.
205
+ - Reused the existing batch audit pipeline for website-present discovery rows.
206
+ - Added `--dry-run` discovery mode for local prospect triage without website audits.
207
+ - Documented the discovery boundary: no Google Maps scraping, no `google-places` provider calls, and no outreach sending in this release.
208
+
209
+ ## v0.8.0 - 2026-05-12
210
+
211
+ - Added `--concurrency` for controlled parallel batch audits.
212
+ - Added batch index insights with average score, profile breakdown, segment breakdown, and frequent findings.
213
+ - Added profile-specific findings for dental, beauty, restaurant, and contractor audits.
214
+ - Expanded profile tests to cover missing and satisfied vertical conversion/trust signals.
215
+
216
+ ## v0.7.0 - 2026-05-11
217
+
218
+ - Added industry profiles with `--profile generic|dental|beauty|restaurant|contractor`.
219
+ - Added optional `profile` CSV input column for batch audits.
220
+ - Added profile metadata to JSON, Markdown, HTML, and batch index outputs.
221
+ - Added `--export-csv` for batch prospect exports with score, top finding, report path, and error columns.
222
+
223
+ ## v0.6.0 - 2026-05-10
224
+
225
+ - Added `--screenshot` for rendered homepage screenshot capture.
226
+ - Added visual evidence metadata to JSON reports.
227
+ - Added Visual Evidence sections to Markdown and HTML reports.
228
+ - Added batch screenshot artifact paths for per-site report folders.
229
+
230
+ ## v0.5.0 - 2026-05-09
231
+
232
+ - Added opt-in Playwright-rendered audits with `--render`.
233
+ - Added batch triage controls with `--segment`, `--min-score`, `--top`, and `--sort`.
234
+ - Added trust and conversion checks for current date signals, review cues, service detail depth, brand icons, and placeholder social profile links.
235
+
236
+ ## v0.4.0 - 2026-05-09
237
+
238
+ - Added resilient batch runs that keep auditing after individual URL failures.
239
+ - Added aggregate batch index reports in JSON, Markdown, and HTML.
240
+ - Added CSV batch input with `url`, `label`, and `segment` columns.
241
+ - Added `@graph` JSON-LD support for structured-data checks.
242
+ - Added LocalBusiness contact-field, Organization schema, visible address, opening-hours, service-location copy, primary CTA, and placeholder-copy checks.
243
+
244
+ ## v0.3.0 - 2026-05-09
245
+
246
+ - Added standalone HTML report rendering.
247
+ - Added `--format html`.
248
+ - Expanded `--format all` to write JSON, Markdown, and HTML reports.
249
+ - Added `--input <path>` for batch audits from text files.
250
+ - Added safe per-site output folders for batch reports.
251
+
252
+ ## v0.2.0 - 2026-05-08
253
+
254
+ - Added optional same-origin internal link scanning with `--check-links` and `--max-pages`.
255
+ - Added a high-severity finding for broken internal links.
256
+ - Added `--fail-on none|high|medium|low` for CI-friendly exit codes.
257
+ - Added compact terminal summaries when reports are written to files.
258
+ - Added integration tests for link scanning and CLI behavior helpers.
259
+
260
+ ## v0.1.1 - 2026-05-08
261
+
262
+ - Added `robots.txt`, `sitemap.xml`, Open Graph, and invalid JSON-LD checks.
263
+ - Added `--format all --out-dir <path>` for writing JSON and Markdown reports together.
264
+ - Added fixture-based rule tests and report output tests.
265
+ - Added `npm run release-check` for local and CI release verification.
266
+
267
+ ## v0.1.0 - 2026-05-08
268
+
269
+ - Project documentation and release planning created.
270
+ - Initial TypeScript CLI scaffold added.
271
+ - JSON and Markdown report generation added.
272
+ - Initial audit rule set and Vitest coverage added.
273
+ - Example report artifacts added.