sproutkit-code 1.5.1 → 1.6.0

package/dist/skill/SKILL.md

@@ -17,7 +17,7 @@ do not need any API key yourself — just run the commands.
 
 ## Commands
 
-All commands accept `--json` for structured output. **Always pass `--json`** so
+All commands accept `--json` for structured output. **Pass `--json`** so
 you can parse results reliably, then summarise them for the user in prose.
 
 - **Find leads** — `sproutkit find "<area>" --categories "<type>,<type>" --json`
@@ -27,7 +27,12 @@ you can parse results reliably, then summarise them for the user in prose.
   - Example: `sproutkit find "Shoreditch, London" --categories "barber shop,cafe" --json`
   - Optional: `--max 25`, `--radius 3000`.
 
-- **List leads** — `sproutkit list --json` (optional `--status site_built`, `--city London`, `--limit 25`)
+- **List leads** — `sproutkit list` (optional `--status site_built`, `--city London`, `--limit 100`)
+  - Run it WITHOUT `--json` and show the output VERBATIM. It already prints an aligned
+    table with the live site/booking links, a delivered marker and a stage tally.
+    Do not re-render, reformat, summarise or truncate it — that throws the formatting away.
+  - Use `sproutkit list --json` only when you need a field to feed another command; in that
+    case read it and don't print it.
   - Returns id, name, status, type, city, phone, site_url. Use this to get lead
     **ids** before building or to report the pipeline.
 
@@ -88,6 +93,36 @@ you can parse results reliably, then summarise them for the user in prose.
   - The banner exists to stop clients using a free demo as their real site, so
     do NOT run this just because a site looks finished.
 
+- **Set up the agency's identity** — `sproutkit brand --show`
+  - Their name, logo, address, VAT and bank details. This is what appears on
+    invoices and letters, in the site footer credit, on the demo banner and in
+    the `/admin` title — so clients see the AGENCY, not Sproutkit.
+  - Set fields with `sproutkit brand --name "X" --email y@z.com --vat-rate 20`.
+  - Invoices refuse to render until at least a name is set.
+
+- **Invoice a client** — `sproutkit invoice <leadId> --items "Website build:1200,Booking:450" --json`
+  - Renders a PDF on the agency's letterhead and returns its path. Quantities:
+    `--items "Monthly hosting:12x25"`. `--due <days>` sets payment terms.
+  - `sproutkit invoice list [--unpaid]` and `sproutkit invoice paid INV-2026-001`.
+  - Money is parsed strictly — "600" and "600.50" are fine, "6.789" is refused.
+
+- **Write a letter or proposal** — `sproutkit letter <leadId> --subject "..." --body "..."`
+  - Same letterhead as invoices. `--body-file <path>` for longer text.
+
+- **Log how a business responded** — `sproutkit reply <leadId> --interested --json`
+  - Also `--not-interested`, `--no-answer`, `--wrong-number`, `--callback`, `--note "..."`.
+  - SMS/WhatsApp replies are invisible to Sproutkit, so this is how a reply gets
+    into the pipeline. 'interested' moves them to Replied; 'not-interested' to Dead.
+
+- **See who needs chasing** — `sproutkit followups [--days 3] --json`
+  - Leads contacted a while ago that never replied, plus funnel stats
+    (contacted, replied, reply rate, interested, won).
+
+- **Prove the site is working** — `sproutkit report <leadId> --json`
+  - Calls, booking clicks and views for the last 30 days vs the previous 30.
+    This is the retainer/renewal evidence. Sites built before analytics shipped
+    need a `regenerate` first.
+
 - **Run the full pipeline for many clients** — `sproutkit pipeline x3 --json` (optional `--book`, `--limit 10`, `--ids 3,5`)
   - Builds → (optionally adds booking) → prepares outreach for several clients
     CONCURRENTLY (capped at 4), refilling as each finishes. Use for "run the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sproutkit-code",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "Sproutkit in your terminal — find leads, build sites, run outreach, all via chat.",
   "bin": {
     "sproutkit": "./dist/index.js"
@@ -29,7 +29,8 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.30.1",
     "axios": "^1.7.1",
-    "node-sqlite3-wasm": "^0.8.20"
+    "node-sqlite3-wasm": "^0.8.20",
+    "pdfkit": "^0.20.1"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",